Codex plugin wrapper for summon-first Registry Broker delegation on top of the canonical HOL Registry skill and CLI.
Server has 9 tools with complete Zod schemas and descriptions. Naming follows verb_noun pattern (delegate, findAgents, summon, etc.). Descriptions are present (50-150 chars) but lack actionable context for LLM selection. Parameters are well-typed with enums and constraints, but descriptions are minimal (10-30 chars). Output schemas are not documented, tool results return generic TextContent without structured field definitions. Error handling and recovery guidance are absent. No tool annotations visible in source despite feature flag claiming toolAnnotations=true.
Cancel a broker chat session and return its terminal state.
Check whether a broker agent route can support chat before opening a session.
Turn a free-form task into ranked broker delegation opportunities.
End a broker chat session and return its terminal state.
Find and rank likely broker agents or MCP servers for a task or query.
Retry a broker chat message by persisted message/idempotency key.
Output schemas undocumented. Tool results return generic TextContent[] with no structured field definitions. LLMs cannot plan downstream calls or extract specific data (e.g., sessionId, agentUrl, candidates). Violates pattern:tool and pattern:response-shaper.
Parameter descriptions are minimal (10-30 chars). Examples: 'The delegation task (minimum 1 character)' lacks context on when to use delegate vs summon. 'Filter by registries' does not explain what registries are or how they affect results. Violates pattern:tool-description baseline (72 chars avg).
No error handling or recovery guidance. Tool descriptions do not explain failure modes, retryability, or next steps. E.g., summonAgent with dryRun=true returns a dispatch plan, but the description does not explain what the LLM should do with it or how to proceed to actual execution.
Inferred effective spec: <=2025-11-25.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | D | 58 | <=2025-11-25 | v2 |
Retrieve the message history of a broker chat session.
Resume a broker chat session and return its current state.
Summon a broker agent or MCP server to handle a bounded task with optional dry-run preview.
Tool annotations claimed (toolAnnotations=true) but not visible in source. No readOnlyHint, destructiveHint, or idempotentHint attributes on tool definitions. Risk/File metadata in tool list suggests manual annotation, not schema-driven.
Workspace context parameter is optional object with no schema validation. Accepts arbitrary fields (openFiles, modifiedFiles, errors, commands, languages). LLMs cannot infer what to populate or how it affects results. Violates pattern:constrained-input.