Shared memory platform for AI coding agents with MCP server capabilities, backend services, and CLI tools
Single tool 'stream_tool_loop' has a reasonable description (145 chars) but critical schema deficiencies. Input schema lists parameter names and types but lacks proper JSON Schema structure with 'type', 'description', and 'required' fields visible in the definition. Parameters like 'tier' reference a custom 'ModelTier' type without definition. No output schema documented. The tool description explains what it does but omits when to use it, prerequisites, or what structure the yielded events follow. Parameter descriptions are minimal (e.g., 'Model tier for LLM selection' is vague about valid values). No error handling guidance. Tool name 'stream_tool_loop' is generic and does not follow verb_noun convention clearly.
Run an Anthropic tool-use loop, yielding structured events (dicts): `text` / `tool` / `tool_result` / `end`. The caller is responsible for SSE-encoding. Pass `history` (a full [{role, content}] conversation) for a multi-turn chat, or `prompt` for a single user turn.
Input schema lacks proper JSON Schema structure. Parameters listed with type names (ModelTier, string, list, tuple, integer, UUID) but no formal 'type', 'description', 'required', or 'properties' fields visible. Custom types like 'ModelTier' are undefined.
No output schema documented. Tool yields 'structured events (dicts)' with keys 'text', 'tool', 'tool_result', 'end' but no formal schema, field types, or examples provided. LLM cannot plan downstream processing.
Parameter descriptions are minimal and lack constraints. 'tier' description is 'Model tier for LLM selection', no enum of valid tiers. 'tool_set' is 'Tuple of tool names', no guidance on format or how to discover available tools. 'max_turns' has no range (e.g., 1 - 100).
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | F | 38 | 2026-07-28+ | v2 |
Tool name 'stream_tool_loop' is generic and does not follow verb_noun convention. 'stream' is vague, does it stream results, stream events, or stream a loop? Better names: 'run_agentic_loop', 'execute_tool_loop', or 'invoke_agent_with_tools'.
No error handling guidance. Tool description does not explain what happens on invalid tier, missing tools, or LLM failures. No recovery hints for the agent.