codex/codex-sdk-v2/examples/packaged_agents/custom_function_tool_demo.py

from __future__ import annotations

import asyncio
import os

from codex_sdk_v2 import Agent, ApproveDecision, FunctionTool, LocalBackendOptions, Manifest


class LookupRefundStatus(FunctionTool):
    name = "lookup_refund_status"
    description = "Return a canned refund status for a demo taxpayer id."
    input_schema = {
        "type": "object",
        "properties": {
            "taxpayer_id": {"type": "string"},
        },
        "required": ["taxpayer_id"],
        "additionalProperties": False,
    }

    async def approve(self, call) -> ApproveDecision:
        return ApproveDecision()

    async def run(self, arguments: dict[str, object]) -> str:
        taxpayer_id = str(arguments["taxpayer_id"])
        return (
            f"Refund status for {taxpayer_id}: accepted, refund approved, "
            "expected deposit in 5 business days."
        )


async def main() -> None:
    agent = Agent(
        manifest=Manifest(root="/workspace"),
        tools=(LookupRefundStatus(),),
    )
    task = await agent.start(backend_options=LocalBackendOptions())
    try:
        text = await task.collect_text(
            "Use the available refund lookup tool for taxpayer id demo-123 and summarize the result."
        )
        print(text)
    finally:
        await task.close()


if __name__ == "__main__":
    if not os.environ.get("OPENAI_API_KEY"):
        raise RuntimeError("OPENAI_API_KEY must be set")
    asyncio.run(main())