{"_id":"@apie-sh/sdk","_rev":"6-0983a4deaf5a5ed68df9684c4dc583c4","name":"@apie-sh/sdk","dist-tags":{"latest":"0.4.0"},"versions":{"0.1.1":{"name":"@apie-sh/sdk","version":"0.1.1","license":"MIT","_id":"@apie-sh/sdk@0.1.1","maintainers":[{"name":"ambeskaradvait","email":"ambeskaradvait@gmail.com"}],"homepage":"https://github.com/apie-sh/javascript-sdk#readme","bugs":{"url":"https://github.com/apie-sh/javascript-sdk/issues"},"dist":{"shasum":"c3acbeba751d30d0b8caddd1a8ec6e1ad5b165e3","tarball":"https://registry.npmjs.org/@apie-sh/sdk/-/sdk-0.1.1.tgz","fileCount":8,"integrity":"sha512-bjbLuEb6tIrRTLtEZMSjisGYmBrE+k7Jw53ObN3IUPNelvupuaxgcqn6dVCO2ULoWMRDQH6ZoLXdCgRie/zoRQ==","signatures":[{"sig":"MEQCICe9eKK1Ob5ELQHH8wNOX+QfQQaxCgrFcRQObHNs9SjAAiATcp45EBV7nI88etxXqukB2PqJI3oh7gbBHHlIhQRj4Q==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":123043},"main":"./dist/index.cjs","type":"module","types":"./dist/index.d.ts","module":"./dist/index.js","engines":{"node":">=20"},"exports":{".":{"import":{"types":"./dist/index.d.ts","default":"./dist/index.js"},"require":{"types":"./dist/index.d.cts","default":"./dist/index.cjs"}}},"gitHead":"563c2a9b028a153676924a52bd764576dc94db6c","scripts":{"dev":"tsup --watch","lint":"eslint .","test":"vitest run","build":"tsup","build:all":"yarn build && yarn workspace @apie/cli build","typecheck":"tsc --noEmit","test:watch":"vitest","prepublishOnly":"yarn build"},"_npmUser":{"name":"ambeskaradvait","email":"ambeskaradvait@gmail.com"},"repository":{"url":"git+https://github.com/apie-sh/javascript-sdk.git","type":"git"},"workspaces":["packages/*"],"_npmVersion":"11.16.0","description":"Official JavaScript/TypeScript SDK for the Apie API","directories":{},"_nodeVersion":"24.13.1","_hasShrinkwrap":false,"packageManager":"yarn@4.17.0","devDependencies":{"tsup":"8.5.1","eslint":"10.5.0","vitest":"4.1.9","globals":"17.6.0","@eslint/js":"10.0.1","typescript":"6.0.3","@types/node":"26.0.0","typescript-eslint":"8.62.0"},"_npmOperationalInternal":{"tmp":"tmp/sdk_0.1.1_1782166500936_0.11812189226754755","host":"s3://npm-registry-packages-npm-production"}},"0.1.2":{"name":"@apie-sh/sdk","version":"0.1.2","license":"MIT","_id":"@apie-sh/sdk@0.1.2","maintainers":[{"name":"ambeskaradvait","email":"ambeskaradvait@gmail.com"}],"homepage":"https://github.com/apie-sh/javascript-sdk#readme","bugs":{"url":"https://github.com/apie-sh/javascript-sdk/issues"},"dist":{"shasum":"40df3ce19d843f5d77938a1f69ce3e64cb9ecc23","tarball":"https://registry.npmjs.org/@apie-sh/sdk/-/sdk-0.1.2.tgz","fileCount":8,"integrity":"sha512-1nAeL75wNS7l59bklSEGCulaG+ps6QnPTN4jaQ4ilR1m0UvefXMHmbxgzladfBPZQa0OjpZOo/3uj9FfSRoRbg==","signatures":[{"sig":"MEYCIQDTDHiU+e+8br1zsVYOTQSPeWz8q2/XrWRpq6/xMGFetAIhAP2k7hkqSWlSgX9+sPS6CBNBFjzuNa4PIuHynLVndHZn","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":149257},"main":"./dist/index.cjs","type":"module","types":"./dist/index.d.ts","module":"./dist/index.js","engines":{"node":">=20"},"exports":{".":{"import":{"types":"./dist/index.d.ts","default":"./dist/index.js"},"require":{"types":"./dist/index.d.cts","default":"./dist/index.cjs"}}},"gitHead":"6e8b1c84df346a3548a05b9b76be965911c9fb7b","scripts":{"dev":"tsup --watch","lint":"eslint .","test":"vitest run","build":"tsup","build:all":"yarn build && yarn workspace @apie/cli build","typecheck":"tsc --noEmit","test:watch":"vitest","prepublishOnly":"yarn build"},"_npmUser":{"name":"ambeskaradvait","email":"ambeskaradvait@gmail.com"},"repository":{"url":"git+https://github.com/apie-sh/javascript-sdk.git","type":"git"},"workspaces":["packages/*"],"_npmVersion":"11.16.0","description":"Official JavaScript/TypeScript SDK for the Apie API","directories":{},"_nodeVersion":"24.13.1","_hasShrinkwrap":false,"packageManager":"yarn@4.17.0","devDependencies":{"tsup":"8.5.1","eslint":"10.5.0","vitest":"4.1.9","globals":"17.6.0","@eslint/js":"10.0.1","typescript":"6.0.3","@types/node":"26.0.0","typescript-eslint":"8.62.0"},"_npmOperationalInternal":{"tmp":"tmp/sdk_0.1.2_1782180444214_0.7346906950022762","host":"s3://npm-registry-packages-npm-production"}},"0.2.0":{"name":"@apie-sh/sdk","version":"0.2.0","license":"MIT","_id":"@apie-sh/sdk@0.2.0","maintainers":[{"name":"ambeskaradvait","email":"ambeskaradvait@gmail.com"}],"homepage":"https://github.com/apie-sh/javascript-sdk#readme","bugs":{"url":"https://github.com/apie-sh/javascript-sdk/issues"},"dist":{"shasum":"38e73ceb326eaa2327e7cd6853d04be671c33053","tarball":"https://registry.npmjs.org/@apie-sh/sdk/-/sdk-0.2.0.tgz","fileCount":8,"integrity":"sha512-o2+48KZBEO5WmR3x6j8o0s21f84PHUjEI0L2X9f46+h/egvgiNCYZadrexIsC4mXwh5/SD+KnJrh7m8dk9iyyw==","signatures":[{"sig":"MEQCIH4PJq12PPt9QTj8NspCNKc7/hWMkRpGc2WqUVzesnLoAiB1dHH+I44OpscI1F2MfO4+8F9hY9uhP5psJ1PyAUjOlg==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":392556},"main":"./dist/index.cjs","type":"module","types":"./dist/index.d.ts","module":"./dist/index.js","engines":{"node":">=20"},"exports":{".":{"import":{"types":"./dist/index.d.ts","default":"./dist/index.js"},"require":{"types":"./dist/index.d.cts","default":"./dist/index.cjs"}}},"gitHead":"02c0c4249b875bf4d736346cde3efe3c1af17dd7","scripts":{"dev":"tsup --watch","lint":"eslint .","test":"vitest run","build":"tsup","build:all":"yarn build && yarn workspace @apie/cli build","typecheck":"tsc --noEmit","test:watch":"vitest","prepublishOnly":"yarn build"},"_npmUser":{"name":"ambeskaradvait","email":"ambeskaradvait@gmail.com"},"repository":{"url":"git+https://github.com/apie-sh/javascript-sdk.git","type":"git"},"workspaces":["packages/*"],"_npmVersion":"11.16.0","description":"Official JavaScript/TypeScript SDK for the Apie API","directories":{},"_nodeVersion":"24.13.1","_hasShrinkwrap":false,"packageManager":"yarn@4.17.0","devDependencies":{"tsup":"8.5.1","eslint":"10.5.0","vitest":"4.1.9","globals":"17.6.0","@eslint/js":"10.0.1","typescript":"6.0.3","@types/node":"26.0.0","typescript-eslint":"8.62.0"},"_npmOperationalInternal":{"tmp":"tmp/sdk_0.2.0_1782504052782_0.6943476132305821","host":"s3://npm-registry-packages-npm-production"}},"0.2.1":{"name":"@apie-sh/sdk","version":"0.2.1","license":"MIT","_id":"@apie-sh/sdk@0.2.1","maintainers":[{"name":"ambeskaradvait","email":"ambeskaradvait@gmail.com"}],"homepage":"https://github.com/apie-sh/javascript-sdk#readme","bugs":{"url":"https://github.com/apie-sh/javascript-sdk/issues"},"dist":{"shasum":"48582bc8b86be59b992f2d8621e4702c49a89619","tarball":"https://registry.npmjs.org/@apie-sh/sdk/-/sdk-0.2.1.tgz","fileCount":8,"integrity":"sha512-QZ7+68ec5aw6fyso7Najcg2ZyXU5mevqs2AOCxYcws0ZLuextIuHPpvyg4l9aL2M26WXnmOt0qH3bs/82XPl3A==","signatures":[{"sig":"MEQCIDTdft+SfQ1I7ALBqWVQHdFQHDu4VOdtrtOZkJcuS70RAiATZQ5l/Uv/gPhmTQJ/BIVqgmvT1cN8jkxRnYgs3yAAEg==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":710882},"main":"./dist/index.cjs","type":"module","types":"./dist/index.d.ts","module":"./dist/index.js","engines":{"node":">=20"},"exports":{".":{"import":{"types":"./dist/index.d.ts","default":"./dist/index.js"},"require":{"types":"./dist/index.d.cts","default":"./dist/index.cjs"}},"./http":{"import":{"types":"./dist/index.d.ts","default":"./dist/index.js"}},"./events":{"import":{"types":"./dist/index.d.ts","default":"./dist/index.js"}}},"gitHead":"8b09873b051de8f848b31fb08ce68e69bd4005b9","scripts":{"dev":"tsup --watch","lint":"eslint .","test":"vitest run","build":"tsup","build:all":"yarn build && yarn workspace @apie-sh/mcp-core build && yarn workspace @apie-sh/mcp-proxy build && yarn workspace @apie/cli build","typecheck":"tsc --noEmit","test:watch":"vitest","test:coverage":"vitest run --coverage","prepublishOnly":"yarn build"},"_npmUser":{"name":"ambeskaradvait","email":"ambeskaradvait@gmail.com"},"repository":{"url":"git+https://github.com/apie-sh/javascript-sdk.git","type":"git"},"workspaces":["packages/*"],"_npmVersion":"11.16.0","description":"Official JavaScript/TypeScript SDK for the Apie API","directories":{},"_nodeVersion":"24.13.1","_hasShrinkwrap":false,"packageManager":"yarn@4.17.0","devDependencies":{"tsup":"8.5.1","eslint":"10.5.0","vitest":"4.1.9","globals":"17.6.0","@eslint/js":"10.0.1","typescript":"6.0.3","@types/node":"26.0.0","typescript-eslint":"8.62.0","@vitest/coverage-v8":"4.1.9"},"_npmOperationalInternal":{"tmp":"tmp/sdk_0.2.1_1782617470999_0.5824504132348949","host":"s3://npm-registry-packages-npm-production"}},"0.3.0":{"name":"@apie-sh/sdk","version":"0.3.0","license":"MIT","_id":"@apie-sh/sdk@0.3.0","maintainers":[{"name":"ambeskaradvait","email":"ambeskaradvait@gmail.com"}],"homepage":"https://github.com/apie-sh/javascript-sdk#readme","bugs":{"url":"https://github.com/apie-sh/javascript-sdk/issues"},"dist":{"shasum":"7a3ee3c62a54b3922faa507ac70ee24a12490919","tarball":"https://registry.npmjs.org/@apie-sh/sdk/-/sdk-0.3.0.tgz","fileCount":8,"integrity":"sha512-Tq7vw8qhcTiRBR9Aa+5SORjvFYWcMj2hlhxxbz9VVUsgvxMGgdqHNRDMBEbJrnUKGQbV0SE/N52jNW81aXt7+w==","signatures":[{"sig":"MEUCIESkFIihWIbGn47C2xj922O7g1LKn8E7gWHjG5l4x6ZLAiEAmBXcS5GeVIxp3CcoSFJOsF5OvIJFNJwoZuEWLW00Mwc=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":711527},"main":"./dist/index.cjs","type":"module","types":"./dist/index.d.ts","module":"./dist/index.js","engines":{"node":">=20"},"exports":{".":{"import":{"types":"./dist/index.d.ts","default":"./dist/index.js"},"require":{"types":"./dist/index.d.cts","default":"./dist/index.cjs"}},"./http":{"import":{"types":"./dist/index.d.ts","default":"./dist/index.js"}},"./events":{"import":{"types":"./dist/index.d.ts","default":"./dist/index.js"}}},"gitHead":"4cd1270ef4a8452885929108b39eea5636f02a61","scripts":{"dev":"tsup --watch","lint":"eslint .","test":"vitest run","build":"tsup","build:all":"yarn build && yarn workspace @apie-sh/mcp-core build && yarn workspace @apie-sh/mcp-proxy build && yarn workspace @apie/cli build","typecheck":"tsc --noEmit","test:watch":"vitest","test:coverage":"vitest run --coverage","prepublishOnly":"yarn build"},"_npmUser":{"name":"ambeskaradvait","email":"ambeskaradvait@gmail.com"},"repository":{"url":"git+https://github.com/apie-sh/javascript-sdk.git","type":"git"},"workspaces":["packages/*"],"_npmVersion":"11.16.0","description":"Official JavaScript/TypeScript SDK for the Apie API","directories":{},"_nodeVersion":"24.13.1","_hasShrinkwrap":false,"packageManager":"yarn@4.17.0","devDependencies":{"tsup":"8.5.1","eslint":"10.5.0","vitest":"4.1.9","globals":"17.6.0","@eslint/js":"10.0.1","typescript":"6.0.3","@types/node":"26.0.0","typescript-eslint":"8.62.0","@vitest/coverage-v8":"4.1.9"},"_npmOperationalInternal":{"tmp":"tmp/sdk_0.3.0_1782617703477_0.350749018339632","host":"s3://npm-registry-packages-npm-production"}},"0.4.0":{"name":"@apie-sh/sdk","version":"0.4.0","description":"Official JavaScript/TypeScript SDK for the Apie API","packageManager":"yarn@4.17.0","workspaces":["packages/*"],"type":"module","license":"MIT","repository":{"type":"git","url":"git+https://github.com/apie-sh/javascript-sdk.git"},"main":"./dist/index.cjs","module":"./dist/index.js","types":"./dist/index.d.ts","exports":{".":{"import":{"types":"./dist/index.d.ts","default":"./dist/index.js"},"require":{"types":"./dist/index.d.cts","default":"./dist/index.cjs"}},"./events":{"import":{"types":"./dist/index.d.ts","default":"./dist/index.js"}},"./http":{"import":{"types":"./dist/index.d.ts","default":"./dist/index.js"}}},"engines":{"node":">=20"},"scripts":{"build":"tsup","build:all":"yarn build && yarn workspace @apie-sh/mcp-core build && yarn workspace @apie-sh/mcp-proxy build && yarn workspace @apie/cli build","dev":"tsup --watch","test":"vitest run","test:coverage":"vitest run --coverage","test:watch":"vitest","typecheck":"tsc --noEmit","lint":"eslint .","prepublishOnly":"yarn build"},"devDependencies":{"@eslint/js":"10.0.1","@types/node":"26.0.0","@vitest/coverage-v8":"4.1.9","eslint":"10.5.0","globals":"17.6.0","tsup":"8.5.1","typescript":"6.0.3","typescript-eslint":"8.62.0","vitest":"4.1.9"},"gitHead":"82cf0582f8211858e1e5599e41f9b133ad782df5","_id":"@apie-sh/sdk@0.4.0","bugs":{"url":"https://github.com/apie-sh/javascript-sdk/issues"},"homepage":"https://github.com/apie-sh/javascript-sdk#readme","_nodeVersion":"24.13.1","_npmVersion":"11.16.0","dist":{"integrity":"sha512-YJUJFuNO6xgb0nwF5z6GHoRq+BljJ4kxhIKtEk5WNKcjOjz1De6w8S2anExlCYiHJ/Q6F9RFi1sYJSwOQiBW4Q==","shasum":"c10e1d7cf9243a3fdecf56e57ebcbb55a96267d0","tarball":"https://registry.npmjs.org/@apie-sh/sdk/-/sdk-0.4.0.tgz","fileCount":8,"unpackedSize":743189,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIQCvqp9LK4a0I9URqugIOx+71uY+qRXmDNDF0dYC8z4ULAIgPurU7wYqj1vSCLpO1NVf96g6L6N5wnICe2yIuSTzL68="}]},"_npmUser":{"name":"ambeskaradvait","email":"ambeskaradvait@gmail.com"},"directories":{},"maintainers":[{"name":"ambeskaradvait","email":"ambeskaradvait@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/sdk_0.4.0_1782933831623_0.03518925669455042"},"_hasShrinkwrap":false}},"time":{"created":"2026-06-22T22:15:00.741Z","modified":"2026-07-01T19:23:51.933Z","0.1.1":"2026-06-22T22:15:01.110Z","0.1.2":"2026-06-23T02:07:24.352Z","0.2.0":"2026-06-26T20:00:52.904Z","0.2.1":"2026-06-28T03:31:11.234Z","0.3.0":"2026-06-28T03:35:03.615Z","0.4.0":"2026-07-01T19:23:51.782Z"},"bugs":{"url":"https://github.com/apie-sh/javascript-sdk/issues"},"license":"MIT","homepage":"https://github.com/apie-sh/javascript-sdk#readme","repository":{"type":"git","url":"git+https://github.com/apie-sh/javascript-sdk.git"},"description":"Official JavaScript/TypeScript SDK for the Apie API","maintainers":[{"name":"ambeskaradvait","email":"ambeskaradvait@gmail.com"}],"readme":"# @apie-sh/sdk\n\n[![CI](https://github.com/apie-sh/javascript-sdk/actions/workflows/ci.yml/badge.svg)](https://github.com/apie-sh/javascript-sdk/actions/workflows/ci.yml)\n[![Line coverage](https://img.shields.io/badge/line%20coverage-63.06%25-yellow)](https://github.com/apie-sh/javascript-sdk/actions/workflows/ci.yml)\n\nOfficial JavaScript/TypeScript SDK for [Apie](https://apie.sh) — runtime visibility and guardrails for AI agents.\n\n**[Full documentation →](https://apie.mintlify.site/)**\n\n> **Pre-release.** This package is not yet stable — do not use in production.\n\n---\n\n## Install\n\n```bash\nnpm install @apie-sh/sdk\n```\n\nFor CLI commands, add the dev dependency:\n\n```bash\nnpm install -D @apie/cli\n```\n\n## Environment\n\n```env\nAPIE_API_KEY=apie_sk_test_...\nAPIE_BASE_URL=https://api.apie.sh\n```\n\n## Quick start\n\nScaffold config and verify connectivity in one pass:\n\n```bash\nnpx apie init\nnpx apie send-test-event          # pipeline smoke test — prints session replay URL\nnpx apie send-test-event --mode single\nnpx apie send-test-event --mode proof\nnpx apie doctor                   # config, queue, and ingestion diagnostics\nnpx apie doctor --send-test\n```\n\n### 1. Initialize\n\nSentry-style — one client per process:\n\n```ts\nimport apie from \"./apie.config\";\n\nawait apie.ready();\n```\n\n### 2. Choose your integration path\n\nStart simple; add metadata later when you tune guardrails for production.\n\n| Path | When to use | Effort |\n| --- | --- | --- |\n| [MCP proxy](#mcp-proxy) | MCP hosts (Cursor, Claude Desktop) | Config only |\n| Framework plugin | LangChain, OpenAI Agents | ~5 lines |\n| `apie.wrap()` | HTTP handlers, workers, CLI jobs | 1 wrapper |\n| `withRun` + instrumented client | Custom agents with MCP tools | ~10 lines |\n\n### 3. Instrument\n\n**Tier 1 — Framework plugin.** Tools auto-instrument inside a run:\n\n```ts\nimport { ApieCallbackHandler } from \"@apie-sh/sdk/integrations\";\n\nconst handler = new ApieCallbackHandler(apie, { defaultEnvironment: \"production\" });\n\nawait apie.withRun({ inputSummary: \"Process request\" }, async () => {\n  // Pass handler to your LangChain agent callbacks — no per-tool wrappers\n});\n```\n\n**Tier 2 — Request boundary.** `wrap` auto-creates run context for plugins and MCP clients:\n\n```ts\nexport const handleRequest = apie.wrap(\n  async (req: Request) => agent.run(await req.json()),\n  { inputSummary: (req) => req.url },\n);\n```\n\n**Tier 3 — Explicit metadata.** Optional — tune guardrails and boundary maps:\n\n```ts\nawait apie.withRun({ inputSummary: \"Process request\" }, async () => {\n  await apie.withTool(\n    { tool: { name: \"search\" } },\n    async () => search(\"query\"),\n  );\n});\n```\n\nAction and resource types are inferred from tool names when omitted. Add explicit `action`, `resource`, and `environment` when enabling Enforce mode in production.\n\n## Requirements\n\n- Node.js 20+\n- Native `fetch` (browsers, edge runtimes, Deno)\n\n## MCP proxy\n\nObserve and control MCP tool calls without rewriting every call site:\n\n```bash\n# apie.mcp.json — see examples/apie.mcp.json\nnpx apie mcp proxy --config apie.mcp.json\n\n# SSE transport for remote agents\nnpx apie mcp proxy --transport sse --port 3100 --config apie.mcp.json\n\n# Validate MCP proxy setup\nnpx apie doctor --mcp\n```\n\nPoint your MCP host config at `apie mcp proxy` instead of the upstream server command.\n\nA native Python MCP proxy is also available via `pip install apie-sdk[mcp-proxy]` and `apie mcp proxy`.\n\n## Integration helpers\n\n### Framework wrappers\n\n| Helper | Use with |\n| --- | --- |\n| `ApieCallbackHandler` | LangChain / LangGraph |\n| `createApieRunHooks` | OpenAI Agents |\n| `withOpenAIToolCall`, `withAnthropicToolCall`, `withToolCallGuard` | LLM tool calls |\n| `withOpenAIAgentStep`, `withOpenAIAgentToolCall` | OpenAI Agents SDK |\n| `withLangGraphNode`, `withLangChainToolStep` | LangChain / LangGraph |\n| `withCrewAiTask`, `withCrewAiToolStep` | CrewAI |\n| `withAutogenStep`, `withAutogenToolStep` | AutoGen |\n| `withLlamaIndexStep`, `withLlamaIndexToolStep` | LlamaIndex |\n| `withMcpToolCall`, `createInstrumentedMcpClient` | MCP |\n| `withVercelAiGeneration` | Vercel AI SDK |\n| `withWorkflowStep`, `withCanonicalToolAction` | Custom workflows |\n| `createHttpGuard` | HTTP handlers |\n\n### Platform connectors\n\nProvider-neutral canonical mapping for common integrations:\n\n- `withGitHubAction`, `withGitLabAction`\n- `withIssueTrackerAction` (Linear / Jira)\n- `withIncidentResponseAction` (PagerDuty / Opsgenie)\n- `withObservabilityCorrelation` (Datadog / Sentry)\n\nSee `examples/` for runnable patterns.\n\n### Starter examples\n\n| Example | What it demonstrates |\n| --- | --- |\n| `examples/incident-remediation-agent.ts` | Baseline monitor-mode instrumentation |\n| `examples/production-release-gate-loop.ts` | Production-bound workflow with MCP and risky action coverage |\n| `examples/guardrail-packs-smoke.ts` | Simulate starter guardrail packs in monitor mode |\n| `examples/langchain-instrumented-agent.ts` | LangChain callback handler |\n| `examples/openai-agents-instrumented.ts` | OpenAI Agents run hooks |\n| `examples/mcp-proxy-enforcement-loop.ts` | Proxy Enforce mode with approval wait |\n\n## CLI\n\n| Command | Description |\n| --- | --- |\n| `apie init` | Scaffold `apie.config.ts` |\n| `apie doctor [--send-test] [--mcp]` | Validate config, queue, and ingestion health |\n| `apie mcp proxy` | MCP proxy (stdio or SSE) with Monitor/Enforce modes |\n| `apie send-test-event` | Verify connectivity (pipeline, single, or proof mode) |\n| `apie capabilities declare` | Declare capabilities from config |\n| `apie guardrails enable <key>` | Enable a guardrail template |\n| `apie report create` | Generate a boundary report |\n\n## Documentation\n\n| Topic | Link |\n| --- | --- |\n| Connect your first agent | [apie.mintlify.site/getting-started/connect-your-first-agent](https://apie.mintlify.site/getting-started/connect-your-first-agent) |\n| Configuration reference | [apie.mintlify.site/reference/configuration](https://apie.mintlify.site/reference/configuration) |\n| How Apie works | [apie.mintlify.site/concepts/how-apie-works](https://apie.mintlify.site/concepts/how-apie-works) |\n| Trace runs and sessions | [apie.mintlify.site/observe/trace-runs-and-sessions](https://apie.mintlify.site/observe/trace-runs-and-sessions) |\n| Guardrails | [apie.mintlify.site/guardrails/enforce-guardrails](https://apie.mintlify.site/guardrails/enforce-guardrails) |\n| Choose how to instrument | [apie.mintlify.site/getting-started/choose-how-to-instrument](https://apie.mintlify.site/getting-started/choose-how-to-instrument) |\n| Multi-agent pipelines | [apie.mintlify.site/observe/multi-agent-pipelines](https://apie.mintlify.site/observe/multi-agent-pipelines) |\n| Integrations | [apie.mintlify.site/integrations/index](https://apie.mintlify.site/integrations/index) |\n| Recipes | [apie.mintlify.site/recipes/incident-remediation](https://apie.mintlify.site/recipes/incident-remediation) |\n| CLI | [apie.mintlify.site/reference/cli](https://apie.mintlify.site/reference/cli) |\n\n## Quality\n\nCI runs typecheck, lint, Vitest coverage, and build on Node.js 22 and 24.\n\nCurrent coverage from `yarn test:coverage`:\n\n| Metric | Coverage |\n| --- | --- |\n| Statements | 62.85% |\n| Branches | 51.76% |\n| Functions | 62.62% |\n| Lines | 63.06% |\n\n## License\n\nMIT\n","readmeFilename":"README.md"}