{"_id":"@aeo-kit/agent","name":"@aeo-kit/agent","dist-tags":{"latest":"0.1.2"},"versions":{"0.1.2":{"name":"@aeo-kit/agent","version":"0.1.2","type":"module","description":"AEO consumer — reads .aeo artifacts and emits agent-ready tool definitions (OpenAI, MCP).","license":"Apache-2.0","repository":{"type":"git","url":"git+https://github.com/NaguiPinetta/aeo-kit.git","directory":"packages/agent"},"homepage":"https://github.com/NaguiPinetta/aeo-kit","bugs":{"url":"https://github.com/NaguiPinetta/aeo-kit/issues"},"publishConfig":{"access":"public"},"exports":{".":{"types":"./dist/index.d.ts","default":"./dist/index.js"}},"bin":{"aeo-agent":"dist/cli.js"},"scripts":{"clean":"rm -rf dist","prebuild":"npm run clean","build":"tsc && chmod +x dist/cli.js"},"dependencies":{"commander":"^13"},"devDependencies":{"@types/node":"^25.3.0","typescript":"^5"},"_id":"@aeo-kit/agent@0.1.2","gitHead":"e31c9ad9a716d608cfa33f590f284a1954716005","_nodeVersion":"20.19.6","_npmVersion":"10.8.2","dist":{"integrity":"sha512-hIHdNROejxM/r8REU4gqclQmTso8SirqNiT2SYVdxftQ/e6OIwdGD62/FbIBQ5PHh8angoy+Ypt+hZ9Vu1hhBg==","shasum":"5563a4088f8991520f914f969568ad2e9a972b00","tarball":"https://registry.npmjs.org/@aeo-kit/agent/-/agent-0.1.2.tgz","fileCount":14,"unpackedSize":17037,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIQD0ByGoniHjG8r2d46EuWsxF301wO0a1fb7ScPRBj4dRAIgUA/QgW4BZlAW3CqehL9ZdWd9chgqFvaimEbwywNwvgM="}]},"_npmUser":{"name":"naguipinetta","email":"naguipinetta@gmail.com"},"directories":{},"maintainers":[{"name":"naguipinetta","email":"naguipinetta@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/agent_0.1.2_1771586214411_0.6992458367201351"},"_hasShrinkwrap":false}},"time":{"created":"2026-02-20T11:16:54.296Z","0.1.2":"2026-02-20T11:16:54.551Z","modified":"2026-02-20T11:16:54.801Z"},"maintainers":[{"name":"naguipinetta","email":"naguipinetta@gmail.com"}],"description":"AEO consumer — reads .aeo artifacts and emits agent-ready tool definitions (OpenAI, MCP).","homepage":"https://github.com/NaguiPinetta/aeo-kit","repository":{"type":"git","url":"git+https://github.com/NaguiPinetta/aeo-kit.git","directory":"packages/agent"},"bugs":{"url":"https://github.com/NaguiPinetta/aeo-kit/issues"},"license":"Apache-2.0","readme":"# @aeo-kit/agent\n\nAEO consumer — reads `.aeo` artifacts and emits agent-ready tool definitions for OpenAI function calling and MCP.\n\n## Install\n\n```bash\nnpm install @aeo-kit/agent\n```\n\n## CLI usage\n\n```bash\n# Generate OpenAI function-calling tool definitions\nnpx aeo-agent openai --aeo ./.aeo --out ./tools.openai.json\n\n# Generate MCP tool definitions\nnpx aeo-agent mcp --aeo ./.aeo --out ./tools.mcp.json\n\n# Validate .aeo artifacts (consumer-side safety checks)\nnpx aeo-agent validate --aeo ./.aeo\n```\n\nOutput goes to stdout when `--out` is omitted or set to `-`.\n\n## Programmatic usage\n\n```typescript\nimport { loadAEO, toOpenAITools, toMCPTools, validateAEOConsumerInput } from \"@aeo-kit/agent\";\n\nconst aeo = await loadAEO(\"./.aeo\");\n\n// OpenAI function calling\nconst openaiTools = toOpenAITools(aeo);\n\n// MCP\nconst mcpTools = toMCPTools(aeo);\n\n// Consumer validation\nconst result = validateAEOConsumerInput(aeo);\nif (!result.valid) {\n  console.error(result.findings);\n}\n```\n\n## Output format (OpenAI)\n\nEach AEO tool becomes an OpenAI function-calling tool with AEO metadata in `x-aeo`:\n\n```json\n{\n  \"type\": \"function\",\n  \"function\": {\n    \"name\": \"list-pets\",\n    \"description\": \"List all pets\",\n    \"parameters\": { \"type\": \"object\", \"properties\": { \"limit\": { \"type\": \"integer\" } } }\n  },\n  \"x-aeo\": {\n    \"method\": \"GET\",\n    \"path\": \"/pets\",\n    \"intent\": { \"intent\": \"read\", \"source\": \"derived\" },\n    \"trust\": { \"required\": false, \"source\": \"explicit\" }\n  }\n}\n```\n\n## License\n\nApache-2.0\n","readmeFilename":"README.md","_rev":"1-acfd75996322e6ceaa8d9ca4ee50abb7"}