Agent Function Calling Specification and Harness Generator

Role: Principal Agentic Systems Documentation Engineer specializing in structured function-calling interfaces and schema governance.

Context

• Target Agent Runtime: {{target_agent_runtime}}
• Input Tool Declarations: {{raw_tool_declarations}}
• Validation Framework: {{validation_framework}}
• Persistence Mechanism: {{state_persistence_engine}}
• Context Limit Constraints: {{max_token_budget_per_call}}

Task

Construct an executable Python validation and documentation sync script that ingests unstructured tool definitions, compiles them into strictly typed JSON-Schema parameter contracts for agentic tool calling, and generates a runnable sandbox test harness with deterministic mock outputs.

Method

1. Parse raw capability strings and signatures from {{raw_tool_declarations}} into normalized Abstract Syntax Tree metadata objects.
2. Map input argument constraints, mandatory fields, and default fallback states against {{validation_framework}} conventions.
3. Generate OpenAPI 3.1 and JSON-Schema compliant function definition manifests configured strictly for {{target_agent_runtime}}.
4. Inject runtime state verification handlers to coordinate intermediate call states using {{state_persistence_engine}}.
5. Calculate payload size boundaries to enforce that generated schemas remain safely within {{max_token_budget_per_call}}.
6. Construct synthetic input generators that validate edge cases, null arguments, and malformed type coercions.
7. Generate an end-to-end Python executable script containing the schemas, mock dispatch handler, docstrings, and an isolated unit testing suite.

Constraints

• Script MUST be executable standalone code in Python 3.10+ without undefined external dependencies.
• MUST implement strict runtime type checking for every declared function parameter.
• Tool descriptions MUST NOT exceed 120 words per tool to minimize context window bloat.
• Include structured error handling for JSON serialization failures and runtime timeouts.

Output format

Provide a Python script organized into:

1. Module header and dependency imports (lines 1-20)
2. JSON-Schema Function Calling Manifest Constants
3. Tool Execution Dispatcher and Mock Implementation Class
4. Validation Test Harness (test suite with minimum 4 assertions per tool)
5. CLI execution block demonstrating sample agent invocations

Self-review

• Verify that all JSON Schema types strictly conform to {{target_agent_runtime}} specifications.
• Confirm all {{raw_tool_declarations}} have explicit parameter descriptions and boundary definitions.
• Check that the script executes cleanly without missing variables or stubbed methods.