{"_id":"@ag-ents/ag-ents-plugin","_rev":"5-9c1dc7f18bc5f48294b14e8820e4386e","name":"@ag-ents/ag-ents-plugin","dist-tags":{"latest":"0.1.4"},"versions":{"0.1.0":{"name":"@ag-ents/ag-ents-plugin","version":"0.1.0","keywords":["ag-ents","agent","channel","openclaw","websocket"],"_id":"@ag-ents/ag-ents-plugin@0.1.0","maintainers":[{"name":"ag.tomi","email":"olutomilayodolapo@gmail.com"}],"dist":{"shasum":"a87c96aca8b487ddee935de59a74ddc03af72eff","tarball":"https://registry.npmjs.org/@ag-ents/ag-ents-plugin/-/ag-ents-plugin-0.1.0.tgz","fileCount":95,"integrity":"sha512-jh+5LTAtyTgsNPt4XD92vhaL95lI4baVe5HIKkKTpVRjVECEM+3OdKmzWEy5RLQIDrWwlhcoX8DNkrUOYTlQDA==","signatures":[{"sig":"MEUCIQD4FQDhoZ5lD/umYOh/fgwNHPPMufffbi7bn5bwbCtHzwIgBkYs4zIcqtEskOiA+RGcc8a7dFtpiTIZ37Glpk869nk=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":330097},"main":"./dist/index.js","type":"module","types":"./dist/index.d.ts","exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js"}},"gitHead":"6937ab36ea4ede9e477915dcfb73f5b5d1eb39a9","scripts":{"test":"vitest run --root ../.. packages/openclaw-channel-ag-ents/test","build":"tsc -p tsconfig.json","typecheck":"tsc --noEmit -p tsconfig.json"},"_npmUser":{"name":"ag.tomi","email":"olutomilayodolapo@gmail.com"},"openclaw":{"channel":{"id":"ag-ents","blurb":"Connect one existing OpenClaw agent to ag-ents with a per-agent token.","label":"ag-ents","order":50,"aliases":["agents"],"selectionLabel":"ag-ents"},"install":{"npmSpec":"@ag-ents/ag-ents-plugin","localPath":".","defaultChoice":"npm"},"channels":["ag-ents"],"extensions":["./index.ts"],"setupEntry":"./setup-entry.ts","installDependencies":true},"_npmVersion":"11.4.2","description":"ag-ents channel plugin for OpenClaw","directories":{},"_nodeVersion":"24.4.1","dependencies":{"ws":"^8.20.0","@ag-ents/contracts":"^0.1.0"},"_hasShrinkwrap":false,"devDependencies":{"@types/ws":"^8.18.1","@types/node":"^25.5.0","@hono/node-server":"^1.19.11"},"peerDependencies":{"openclaw":">=2026.3.14"},"_npmOperationalInternal":{"tmp":"tmp/ag-ents-plugin_0.1.0_1775081858015_0.8035123750040976","host":"s3://npm-registry-packages-npm-production"}},"0.1.1":{"name":"@ag-ents/ag-ents-plugin","version":"0.1.1","keywords":["ag-ents","agent","channel","openclaw","websocket"],"_id":"@ag-ents/ag-ents-plugin@0.1.1","maintainers":[{"name":"ag.tomi","email":"olutomilayodolapo@gmail.com"}],"dist":{"shasum":"49ef97fc81426242a14e4d499a3cd6ed42f546f1","tarball":"https://registry.npmjs.org/@ag-ents/ag-ents-plugin/-/ag-ents-plugin-0.1.1.tgz","fileCount":95,"integrity":"sha512-6FAD8G/6dkFKwePtjxkro53OKjf7dUmYnQYdBDYVqPF0MQpjPvvBq9zBQSZ+P9HA4HwZxROzwNqcqIlkHDq4/w==","signatures":[{"sig":"MEQCIBJRHN3nRibJFexXCG6rY5zGcMPoSolYNZCAmhRlTKzQAiAov+plaR2OTrrWrBcZ1OqthW3oeo0XEdjJdbaCnfqf8w==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":330391},"main":"./dist/index.js","type":"module","types":"./dist/index.d.ts","exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js"}},"gitHead":"6937ab36ea4ede9e477915dcfb73f5b5d1eb39a9","scripts":{"test":"vitest run --root ../.. packages/openclaw-channel-ag-ents/test","build":"tsc -p tsconfig.json","typecheck":"tsc --noEmit -p tsconfig.json"},"_npmUser":{"name":"ag.tomi","email":"olutomilayodolapo@gmail.com"},"openclaw":{"channel":{"id":"ag-ents","blurb":"Connect one existing OpenClaw agent to ag-ents with a per-agent token.","label":"ag-ents","order":50,"aliases":["agents"],"selectionLabel":"ag-ents"},"install":{"npmSpec":"@ag-ents/ag-ents-plugin","localPath":".","defaultChoice":"npm"},"channels":["ag-ents"],"extensions":["./dist/index.js"],"setupEntry":"./dist/setup-entry.js","installDependencies":true},"_npmVersion":"11.4.2","description":"ag-ents channel plugin for OpenClaw","directories":{},"_nodeVersion":"24.4.1","dependencies":{"ws":"^8.20.0","@ag-ents/contracts":"^0.1.1"},"_hasShrinkwrap":false,"devDependencies":{"@types/ws":"^8.18.1","@types/node":"^25.5.0","@hono/node-server":"^1.19.11"},"peerDependencies":{"openclaw":">=2026.3.14"},"_npmOperationalInternal":{"tmp":"tmp/ag-ents-plugin_0.1.1_1775085579503_0.8502413194963907","host":"s3://npm-registry-packages-npm-production"}},"0.1.2":{"name":"@ag-ents/ag-ents-plugin","version":"0.1.2","keywords":["ag-ents","agent","channel","openclaw","websocket"],"_id":"@ag-ents/ag-ents-plugin@0.1.2","maintainers":[{"name":"ag.tomi","email":"olutomilayodolapo@gmail.com"}],"dist":{"shasum":"fa418fe02c4c94b48673b3fc8140d116ef89718b","tarball":"https://registry.npmjs.org/@ag-ents/ag-ents-plugin/-/ag-ents-plugin-0.1.2.tgz","fileCount":100,"integrity":"sha512-jzZtUuHxi/eFBOW/P8+0iylyS7txhEZbdzHram4RUdKYYOtCvTw4P2TVGsC1us71F4a9TaaeVFjbK89LCRLTcw==","signatures":[{"sig":"MEUCIQC01Jq1bn6aiclqr+HKO+8rIUUxmynl2dbG6uPt0EcO4wIgPnHZ619q6i486yxW1n9kunv4GSBftJfXVGOzAHnpp0M=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":356003},"main":"./dist/index.js","type":"module","types":"./dist/index.d.ts","exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js"}},"gitHead":"a1c70cefc53d761d0f8d2f82e593451e5b62203c","scripts":{"test":"vitest run --root ../.. packages/openclaw-channel-ag-ents/test","build":"tsc -p tsconfig.json","typecheck":"tsc --noEmit -p tsconfig.json"},"_npmUser":{"name":"ag.tomi","email":"olutomilayodolapo@gmail.com"},"openclaw":{"channel":{"id":"ag-ents","blurb":"Connect one existing OpenClaw agent to ag-ents with a per-agent token.","label":"ag-ents","order":50,"aliases":["agents"],"selectionLabel":"ag-ents"},"install":{"npmSpec":"@ag-ents/ag-ents-plugin","localPath":".","defaultChoice":"npm"},"channels":["ag-ents"],"extensions":["./dist/index.js"],"setupEntry":"./dist/setup-entry.js","installDependencies":true},"_npmVersion":"11.4.2","description":"ag-ents channel plugin for OpenClaw","directories":{},"_nodeVersion":"24.4.1","dependencies":{"ws":"^8.20.0","@ag-ents/contracts":"^0.1.2"},"_hasShrinkwrap":false,"devDependencies":{"@types/ws":"^8.18.1","@types/node":"^25.5.0","@hono/node-server":"^1.19.11"},"peerDependencies":{"openclaw":">=2026.3.14"},"_npmOperationalInternal":{"tmp":"tmp/ag-ents-plugin_0.1.2_1775604168696_0.8467608936002968","host":"s3://npm-registry-packages-npm-production"}},"0.1.3":{"name":"@ag-ents/ag-ents-plugin","version":"0.1.3","keywords":["ag-ents","agent","channel","openclaw","websocket"],"_id":"@ag-ents/ag-ents-plugin@0.1.3","maintainers":[{"name":"ag.tomi","email":"olutomilayodolapo@gmail.com"}],"dist":{"shasum":"b269abfffdd76846fad425cb24328b9b32c37b78","tarball":"https://registry.npmjs.org/@ag-ents/ag-ents-plugin/-/ag-ents-plugin-0.1.3.tgz","fileCount":100,"integrity":"sha512-c3PVLxMIt1qvs3H3/Ql8snuu7a2suWeod8wkWj4UQifQVvTZXTVB4JIP1nnzxgXkABL8Fsl5X+VAMWQx21tTZg==","signatures":[{"sig":"MEUCIQCvyLDzwxK/sHiM4zCZfz7LUOjomNqyCLP2c+eGPMZF0AIgT9XHUUCxwVAqy8yaubeTK9Axrzqi6hTqZUJGbyd47tI=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":356001},"main":"./dist/index.js","type":"module","types":"./dist/index.d.ts","exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js"}},"gitHead":"a1c70cefc53d761d0f8d2f82e593451e5b62203c","scripts":{"test":"vitest run --root ../.. packages/openclaw-channel-ag-ents/test","build":"tsc -p tsconfig.json","typecheck":"tsc --noEmit -p tsconfig.json"},"_npmUser":{"name":"ag.tomi","email":"olutomilayodolapo@gmail.com"},"openclaw":{"channel":{"id":"ag-ents","blurb":"Connect one existing OpenClaw agent to ag-ents with a per-agent token.","label":"ag-ents","order":50,"aliases":["agents"],"selectionLabel":"ag-ents"},"install":{"npmSpec":"@ag-ents/ag-ents-plugin","localPath":".","defaultChoice":"npm"},"channels":["ag-ents"],"extensions":["./dist/index.js"],"setupEntry":"./dist/setup-entry.js","installDependencies":true},"_npmVersion":"11.4.2","description":"ag-ents channel plugin for OpenClaw","directories":{},"_nodeVersion":"24.4.1","dependencies":{"ws":"^8.20.0","@ag-ents/contracts":"^0.1.3"},"_hasShrinkwrap":false,"devDependencies":{"@types/ws":"^8.18.1","@types/node":"^25.5.0","@hono/node-server":"^1.19.11"},"peerDependencies":{"openclaw":">=2026.3.14"},"_npmOperationalInternal":{"tmp":"tmp/ag-ents-plugin_0.1.3_1775612021436_0.29279013544260457","host":"s3://npm-registry-packages-npm-production"}},"0.1.4":{"name":"@ag-ents/ag-ents-plugin","version":"0.1.4","private":false,"description":"ag-ents channel plugin for OpenClaw","homepage":"https://github.com/Under-the-Mango-Tree/AG-ENTs/tree/main/packages/openclaw-channel-ag-ents","repository":{"type":"git","url":"git+https://github.com/Under-the-Mango-Tree/AG-ENTs.git","directory":"packages/openclaw-channel-ag-ents"},"bugs":{"url":"https://github.com/Under-the-Mango-Tree/AG-ENTs/issues"},"keywords":["ag-ents","agent","channel","openclaw","websocket"],"type":"module","main":"./dist/index.js","types":"./dist/index.d.ts","exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js"}},"scripts":{"build":"tsc -p tsconfig.json","typecheck":"tsc --noEmit -p tsconfig.json","test":"vitest run --root ../.. packages/openclaw-channel-ag-ents/test"},"dependencies":{"@ag-ents/contracts":"^0.1.3","ws":"^8.20.0"},"devDependencies":{"@hono/node-server":"^1.19.11","@types/node":"^25.5.0","@types/ws":"^8.18.1"},"peerDependencies":{"openclaw":">=2026.3.14"},"openclaw":{"extensions":["./dist/index.js"],"setupEntry":"./dist/setup-entry.js","channels":["ag-ents"],"installDependencies":true,"channel":{"id":"ag-ents","label":"ag-ents","selectionLabel":"ag-ents","blurb":"Connect existing OpenClaw agents to ag-ents with per-agent tokens.","order":50,"aliases":["agents"]},"install":{"npmSpec":"@ag-ents/ag-ents-plugin","localPath":".","defaultChoice":"npm"}},"gitHead":"f2abb1d71125211b44fda74956553fc6a2a7bf49","_id":"@ag-ents/ag-ents-plugin@0.1.4","_nodeVersion":"22.22.2","_npmVersion":"11.6.2","dist":{"integrity":"sha512-Y8sxYmqmdMGQL4O05/N2LJc/4WUgIAOneEF70FD9CmUXWALmCHjAisQZpnoLGnbpAyyplGR8c3eEIOaGavhRjg==","shasum":"a7e24734921dbd7237a6962b1515a4a8f7f6e554","tarball":"https://registry.npmjs.org/@ag-ents/ag-ents-plugin/-/ag-ents-plugin-0.1.4.tgz","fileCount":100,"unpackedSize":360406,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEYCIQDGzs09Tov8YZyqf+BtGWUqgVid0FtJVHv0EL9guc2O4AIhAIfv9hp2ilN+WEpQXjXkdF3K0qRsZYlJ3wDcJtWvNaak"}]},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:b2ae6145-5ea2-4888-9b48-6730f83b7f08"}},"directories":{},"maintainers":[{"name":"ag.tomi","email":"olutomilayodolapo@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/ag-ents-plugin_0.1.4_1775853293353_0.3060037665785227"},"_hasShrinkwrap":false}},"time":{"created":"2026-04-01T22:17:37.947Z","modified":"2026-04-10T20:34:53.611Z","0.1.0":"2026-04-01T22:17:38.174Z","0.1.1":"2026-04-01T23:19:39.685Z","0.1.2":"2026-04-07T23:22:48.834Z","0.1.3":"2026-04-08T01:33:41.610Z","0.1.4":"2026-04-10T20:34:53.498Z"},"keywords":["ag-ents","agent","channel","openclaw","websocket"],"description":"ag-ents channel plugin for OpenClaw","maintainers":[{"name":"ag.tomi","email":"olutomilayodolapo@gmail.com"}],"readme":"# ag-ents OpenClaw Channel\n\n`@ag-ents/ag-ents-plugin` is the OpenClaw channel plugin for the ag-ents MVP Path B validation lane.\n\nCurrent package status:\n\n- onboarding validates the real `/ws/agent` handshake before writing config\n- config stays locked under `channels[\"ag-ents\"]`\n- one persistent agent WebSocket is maintained per enabled ag-ents account\n- guided deployments may run multiple enabled ag-ents accounts in one OpenClaw runtime as long as each account is still routed to its own personal agent workspace\n- `text`, `status_update`, and `approval_card` route over the authenticated gateway connection\n- `send_status_update` and `send_approval_card` are registered as the only plugin-owned custom tools in MVP\n- reconnect backoff, heartbeat ping/pong, pending approval resume, and minimal `config_changed` drift surfacing are implemented\n\n## Install and Link\n\nBuild the package first:\n\n```bash\npnpm --filter @ag-ents/ag-ents-plugin build\n```\n\nThen install it into a local OpenClaw runtime from this workspace path or from npm:\n\n- local path: `packages/openclaw-channel-ag-ents`\n- npm package: `@ag-ents/ag-ents-plugin`\n- linked-install catalog: `packages/openclaw-channel-ag-ents/openclaw.channel-catalog.json`\n\nIf you are doing the first linked OpenClaw smoke for EPIC-04, use the dedicated runbook:\n\n- `/Users/sogo/Documents/Projects/ag-ents/docs/implementation/epics/EPIC-04-existing-openclaw-agent-path/TICKET-04-existing-agent-acceptance-and-recovery/manual-linked-openclaw-smoke-runbook.md`\n\nThat runbook covers:\n\n- first-time disposable `oc setup` and `oc onboard`\n- local plugin link-install\n- `openclaw channels add --channel ag-ents`\n- text, approval, reconnect, and config-drift verification\n\n## Onboarding\n\nInteractive path:\n\n```bash\nexport OPENCLAW_PLUGIN_CATALOG_PATHS=\"/Users/sogo/Documents/Projects/ag-ents/packages/openclaw-channel-ag-ents/openclaw.channel-catalog.json\"\nopenclaw channels add\n```\n\nThen choose `ag-ents` in the channel picker.\n\nDirect non-interactive path:\n\n```bash\nexport OPENCLAW_PLUGIN_CATALOG_PATHS=\"/Users/sogo/Documents/Projects/ag-ents/packages/openclaw-channel-ag-ents/openclaw.channel-catalog.json\"\nopenclaw channels add --channel ag-ents --url http://127.0.0.1:8787 --token agtok_...\n```\n\nFor linked installs against OpenClaw `2026.3.24`, that exported catalog path is required.\n`openclaw plugins install -l ...` records the package under `plugins.load.paths`, which is enough\nfor runtime loading and `plugins inspect`, but this OpenClaw build resolves `channels add` through\nits channel catalog and does not catalog `plugins.load.paths`. Also note that `--channel ag-ents`\nuses the direct-input path, so you must provide `--token` explicitly if you use it.\n\nThe ag-ents setup flow also merges `send_status_update` and `send_approval_card` into\n`tools.alsoAllow`. That is required when the OpenClaw profile keeps `tools.profile: \"coding\"`,\nbecause the coding profile otherwise filters plugin tools out of the live agent tool inventory.\n\nIf you still see `Unknown channel: ag-ents`, verify that:\n\n- `OPENCLAW_PLUGIN_CATALOG_PATHS` points at the checked-in catalog file above\n- `openclaw plugins inspect ag-ents` shows the linked package as loaded\n\nFor the published npm package used by the native VPS lane, also verify the\ninstalled version is `0.1.1` or newer. The earlier `0.1.0` publish still\nadvertised TypeScript OpenClaw entrypoints and can leave the runtime with a\nrecorded plugin install but no registered `ag-ents` channel.\n\nThe wizard asks for:\n\n- ag-ents base URL\n- one per-agent token (`agent.agentToken`, usually `agtok_...`, not `session.accessToken`)\n\nIt still configures one account at a time. Guided Path A may manage several accounts in one\nruntime, but MVP delivery remains one personal agent thread per account.\n\nIt validates those credentials by opening a short-lived connection to `/ws/agent`, waiting for the\ngateway `authenticated` frame, and then closing immediately.\n\n## Manual Config Fallback\n\nManual JSON editing is supported as a fallback only:\n\n```json\n{\n  \"tools\": {\n    \"alsoAllow\": [\"send_status_update\", \"send_approval_card\"]\n  },\n  \"channels\": {\n    \"ag-ents\": {\n      \"accounts\": {\n        \"default\": {\n          \"enabled\": true,\n          \"baseUrl\": \"https://api.ag-ents.chat\",\n          \"token\": \"agtok_...\"\n        }\n      },\n      \"defaultAccount\": \"default\",\n      \"dmPolicy\": \"allowlist\",\n      \"groupPolicy\": \"disabled\"\n    }\n  }\n}\n```\n\nNotes:\n\n- if an older linked profile already exists without `tools.alsoAllow`, rerun\n  `openclaw channels add --channel ag-ents --url ... --token agtok_...` after pulling the latest\n  repo state so the setup flow rewrites the missing tool allowlist\n- `groupPolicy` stays locked to `\"disabled\"` for MVP.\n- `dmPolicy` is kept for OpenClaw compatibility, but MVP delivery still targets one linked\n  `personal_agent_thread` per configured account.\n- `token` is redacted in inspect and status surfaces.\n- Unsupported gateway `config_push` and `command` frames are logged and ignored in MVP.\n\n## Local Verification\n\n```bash\npnpm --filter @ag-ents/ag-ents-plugin typecheck\npnpm --filter @ag-ents/ag-ents-plugin test\npnpm --filter @ag-ents/ag-ents-plugin build\n```\n","readmeFilename":"README.md","homepage":"https://github.com/Under-the-Mango-Tree/AG-ENTs/tree/main/packages/openclaw-channel-ag-ents","repository":{"type":"git","url":"git+https://github.com/Under-the-Mango-Tree/AG-ENTs.git","directory":"packages/openclaw-channel-ag-ents"},"bugs":{"url":"https://github.com/Under-the-Mango-Tree/AG-ENTs/issues"}}