{"_id":"@aeoess/composio-governance","name":"@aeoess/composio-governance","dist-tags":{"latest":"0.1.0"},"versions":{"0.1.0":{"name":"@aeoess/composio-governance","version":"0.1.0","description":"APS governance layer for Composio tool execution — delegation-scoped authorization for 250+ integrations","type":"module","main":"dist/index.js","types":"dist/index.d.ts","exports":{".":{"import":"./dist/index.js","types":"./dist/index.d.ts"}},"scripts":{"build":"tsc","test":"npx tsx --test tests/adapter.test.ts"},"license":"Apache-2.0","peerDependencies":{"agent-passport-system":">=1.34.0"},"devDependencies":{"agent-passport-system":"file:../../","tsx":"^4.7.0","typescript":"^5.3.3"},"keywords":["composio","agent","governance","tools","authorization","ai-agent","mcp"],"repository":{"type":"git","url":"git+https://github.com/aeoess/agent-passport-system.git","directory":"packages/composio-governance"},"gitHead":"d79af2ec285a9d63a78466b59b6ca248c2572224","_id":"@aeoess/composio-governance@0.1.0","bugs":{"url":"https://github.com/aeoess/agent-passport-system/issues"},"homepage":"https://github.com/aeoess/agent-passport-system#readme","_nodeVersion":"24.11.1","_npmVersion":"11.6.2","dist":{"integrity":"sha512-12Ks7+rf/2Oq72TJYhHLaCVV61tSNy9jpJ6ChpYgRgcwvXvJZzPENtZDlQZ9Pcq87mQ/60MASLbLcyEsX4N26g==","shasum":"e19b960c08755829edf6d7d0fd1919d2d3e8df9d","tarball":"https://registry.npmjs.org/@aeoess/composio-governance/-/composio-governance-0.1.0.tgz","fileCount":19,"unpackedSize":37717,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEYCIQD6Bvud2wJIXC5a6Gau++q7EzxLFyirOuPFZ1Ay4GbzpQIhAKBBG0XcEnmzkjJ5CupgxfZsrTs3ynRBt71T7pCoYqVu"}]},"_npmUser":{"name":"aeoess","email":"tima@aeoess.com"},"directories":{},"maintainers":[{"name":"aeoess","email":"tima@aeoess.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/composio-governance_0.1.0_1775500782124_0.3480124168127927"},"_hasShrinkwrap":false}},"time":{"created":"2026-04-06T18:39:42.050Z","0.1.0":"2026-04-06T18:39:42.269Z","modified":"2026-04-06T18:39:42.456Z"},"maintainers":[{"name":"aeoess","email":"tima@aeoess.com"}],"description":"APS governance layer for Composio tool execution — delegation-scoped authorization for 250+ integrations","homepage":"https://github.com/aeoess/agent-passport-system#readme","keywords":["composio","agent","governance","tools","authorization","ai-agent","mcp"],"repository":{"type":"git","url":"git+https://github.com/aeoess/agent-passport-system.git","directory":"packages/composio-governance"},"bugs":{"url":"https://github.com/aeoess/agent-passport-system/issues"},"license":"Apache-2.0","readme":"# @aeoess/composio-governance\n\n**Delegation-scoped authorization for 250+ tool integrations.**\n\nComposio handles authentication and connectivity. APS handles who authorized which tool, within what scope, and produces the audit trail. Neither replaces the other.\n\nWorks with **Composio**, **MCP**, **LangChain**, or any tool with `{ name, description, execute() }`.\n\n## Install\n\n```bash\nnpm install @aeoess/composio-governance agent-passport-system\n```\n\n## Quick Start\n\n```typescript\nimport { governComposioAction } from '@aeoess/composio-governance'\nimport { createPassport, createDelegation, generateKeyPair } from 'agent-passport-system'\n\nconst governed = governComposioAction({\n  passport: agentPassport,\n  delegation: createDelegation({\n    delegatedTo: agentKeys.publicKey,\n    delegatedBy: principalKeys.publicKey,\n    scope: ['salesforce:read', 'salesforce:update', 'slack:post'],\n    privateKey: principalKeys.privateKey,\n  }),\n  privateKey: agentKeys.privateKey,\n  action: composioTool,  // any { name, description, execute() }\n})\n\nconst result = await governed.execute({ accountId: 'acc_001' })\n// result.receipt links this tool call to the delegation chain\n```\n\n## Batch Governance\n\n```typescript\nimport { governComposioToolkit } from '@aeoess/composio-governance'\n\nconst governed = governComposioToolkit({\n  passport, delegation, privateKey,\n  tools: composio.getTools(),  // or any tool array\n})\n```\n\n## Destructive Action Protection\n\nTools with names containing `delete`, `destroy`, `drop`, `remove`, `purge`, `wipe`, or `truncate` require explicit `delete`, `destroy`, or `admin` scope in the delegation.\n\n## Recovery Policy\n\n```typescript\nimport { createDefaultRecoveryPolicy } from 'agent-passport-system'\n\nconst governed = governComposioAction({\n  passport, delegation, privateKey,\n  action: composioTool,\n  recoveryPolicy: createDefaultRecoveryPolicy(),\n  onDenied: (event) => console.log(event.reason),\n})\n```\n\n## Architecture\n\n| Concern | Who Handles It |\n|---------|---------------|\n| Agent identity | APS (Ed25519 passport) |\n| Tool authorization | APS (delegation scope) |\n| Destructive action gating | APS (verb analysis) |\n| Audit trail | APS (signed receipts) |\n| Tool connectivity | Composio (250+ integrations) |\n| OAuth management | Composio (managed auth) |\n\nSee also: [@aeoess/stripe-governance](../stripe-governance/) for payment governance.\n\n## License\n\nApache-2.0. Part of [Agent Passport System](https://github.com/aeoess/agent-passport-system).\n","readmeFilename":"README.md","_rev":"1-951b70298fb36f1f442eb67e383a1c88"}