Add consult agent tool

[chubes4]

Summary

• Add an opt-in consult_agent model-facing tool for asking another registered agent a focused question.
• Route execution through canonical agents/chat instead of creating a parallel chat runtime.
• Support optional allowed_agents metadata for domain integrations to enforce approved peer lists.
• Keep recursion/depth authority out of tool/client context; chain depth remains with the existing A2A caller-context substrate.

Testing

• php tests/consult-agent-tool-smoke.php
• php -l inc/Api/Chat/Tools/ConsultAgent.php
• php -l inc/Engine/AI/Tools/ToolServiceProvider.php
• php -l tests/consult-agent-tool-smoke.php

Notes

• This replaces the initial agent_chat tool name on this unmerged branch with the clearer consult_agent contract.
• Local homeboy lint --changed-since origin/main is blocked on this host by missing Homeboy extension wordpress.

AI assistance

• AI assistance: Yes
• Tool(s): OpenCode (GPT-5.5)
• Used for: Drafted the tool implementation, contract rename, smoke coverage, and verification commands; Chris reviewed the architecture direction.

[homeboy-ci]

Homeboy Results — data-machine

Lint

✅ lint — passed

ℹ️ Full options: homeboy docs commands/lint
Deep dive: homeboy lint data-machine --changed-since 34a172a

Test

✅ test — passed

ℹ️ Auto-fix lint issues: homeboy refactor data-machine --from lint --write
ℹ️ Collect coverage: homeboy test data-machine --coverage
ℹ️ Pass args to test runner: homeboy test -- [args]
ℹ️ Full options: homeboy docs commands/test
Deep dive: homeboy test data-machine --changed-since 34a172a

Audit

✅ audit — passed

• test_coverage — 2 finding(s)
• Total: 2 finding(s)

Deep dive: homeboy audit data-machine --changed-since 34a172a

Tooling versions

• Homeboy CLI: homeboy 0.182.0+86f3c5ec
• Extension: wordpress from https://github.com/Extra-Chill/homeboy-extensions
• Extension revision: dd47f26a
• Action: unknown@unknown