{"_id":"@actagent/lobster","_rev":"4-8a148c3038ac9f61c5d1e715b15b3082","name":"@actagent/lobster","dist-tags":{"latest":"2026.6.5"},"versions":{"2026.6.2":{"name":"@actagent/lobster","version":"2026.6.2","_id":"@actagent/lobster@2026.6.2","maintainers":[{"name":"nidaye0525","email":"nidaye0525@gmail.com"}],"homepage":"https://github.com/actagent/actagent#readme","bugs":{"url":"https://github.com/actagent/actagent/issues"},"dist":{"shasum":"77732bff3812003d6ab114889a4f321b166bc07a","tarball":"https://registry.npmjs.org/@actagent/lobster/-/lobster-2026.6.2.tgz","fileCount":17,"integrity":"sha512-P7rHSOD3nKkmuHrrbgVZlJiHNYlRDgOS6fo6k8Ir4bfwTzfWLDiuG6cuDPcN2J+w/LcDbzM3nr3yc4E4w3U30g==","signatures":[{"sig":"MEUCIAInWpnjTL8Z4qxG796NSiHMT58lH60xX36Pk0D0d359AiEAtpzFGuncirvAgdr4CUmsCX1KUfscIz6qPCtg1y5ylFo=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":88639},"type":"module","gitHead":"77bc85eae49cb350c8baa74e34ec3e5c3efeacb4","_npmUser":{"name":"nidaye0525","email":"nidaye0525@gmail.com"},"actagent":{"build":{"actagentVersion":"2026.6.2"},"compat":{"pluginApi":">=2026.6.2"},"install":{"npmSpec":"@actagent/lobster","defaultChoice":"npm","minHostVersion":">=2026.4.25"},"release":{"publishToNpm":true,"publishToACTAgentHub":true},"extensions":["./index.ts"]},"repository":{"url":"git+https://github.com/actagent/actagent.git","type":"git"},"_npmVersion":"10.9.4","description":"Lobster workflow tool plugin for typed pipelines and resumable approvals.","directories":{},"_nodeVersion":"22.22.2","dependencies":{"typebox":"1.1.39","@actagentdbot/lobster":"2026.5.22"},"_hasShrinkwrap":true,"devDependencies":{"@actagent/plugin-sdk":"workspace:*"},"_npmOperationalInternal":{"tmp":"tmp/lobster_2026.6.2_1780690372881_0.5908477509041241","host":"s3://npm-registry-packages-npm-production"}},"2026.6.3":{"name":"@actagent/lobster","version":"2026.6.3","_id":"@actagent/lobster@2026.6.3","maintainers":[{"name":"nidaye0525","email":"nidaye0525@gmail.com"}],"homepage":"https://github.com/actagent/actagent#readme","bugs":{"url":"https://github.com/actagent/actagent/issues"},"dist":{"shasum":"466d147c2ad2c2962e4bfedbe08483a6bd056d16","tarball":"https://registry.npmjs.org/@actagent/lobster/-/lobster-2026.6.3.tgz","fileCount":17,"integrity":"sha512-GK2xRDkaKzJLJTmfrhWx2C4e5rvqOcx8eDbh1Ow99a6MPMiQILXXtxFd1hnTT/9s/BusJsfBDwlVgdbgLaSumA==","signatures":[{"sig":"MEUCIDsRCAfkypEcV5HBGH7qHgUrxT8xDwiR0A0X3gfjn2CeAiEA2ulOVRntReeT38Y296CX650UfIuXMjX7pc57296cbhk=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":88639},"type":"module","gitHead":"fb880b12fab8027ca8617032ad806f913da48b9d","_npmUser":{"name":"nidaye0525","email":"nidaye0525@gmail.com"},"actagent":{"build":{"actagentVersion":"2026.6.2"},"compat":{"pluginApi":">=2026.6.2"},"install":{"npmSpec":"@actagent/lobster","defaultChoice":"npm","minHostVersion":">=2026.4.25"},"release":{"publishToNpm":true,"publishToACTAgentHub":true},"extensions":["./index.ts"]},"repository":{"url":"git+https://github.com/actagent/actagent.git","type":"git"},"_npmVersion":"10.9.4","description":"Lobster workflow tool plugin for typed pipelines and resumable approvals.","directories":{},"_nodeVersion":"22.22.2","dependencies":{"typebox":"1.1.39","@actagentdbot/lobster":"2026.5.22"},"_hasShrinkwrap":true,"devDependencies":{"@actagent/plugin-sdk":"workspace:*"},"_npmOperationalInternal":{"tmp":"tmp/lobster_2026.6.3_1780855844062_0.11295579309557224","host":"s3://npm-registry-packages-npm-production"}},"2026.6.4":{"name":"@actagent/lobster","version":"2026.6.4","_id":"@actagent/lobster@2026.6.4","maintainers":[{"name":"nidaye0525","email":"nidaye0525@gmail.com"}],"homepage":"https://github.com/actagent/actagent#readme","bugs":{"url":"https://github.com/actagent/actagent/issues"},"dist":{"shasum":"95a30b887e7a79e899c3a1a6e400d04a97c397a7","tarball":"https://registry.npmjs.org/@actagent/lobster/-/lobster-2026.6.4.tgz","fileCount":17,"integrity":"sha512-Tg0u5IAiC1ttZbfc5AtuAQMU1OeZ+B7dMBmH+LN7/J50hvbgWppbDLcxPAQITwhdKrYJN3PQo9vb3pINQP4YXw==","signatures":[{"sig":"MEUCIGAONghKLX7Cps7HXKrBIxD8NyK1UPzokhNo1t7i8dknAiEAylqXoWEfsXnkTTngbPhA+GTjE7jHbB0CsyYkx7QJJu8=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":88639},"type":"module","gitHead":"4ff5dd5cd323035f94eb4e3fb35483eb03da74ca","_npmUser":{"name":"nidaye0525","email":"nidaye0525@gmail.com"},"actagent":{"build":{"actagentVersion":"2026.6.2"},"compat":{"pluginApi":">=2026.6.2"},"install":{"npmSpec":"@actagent/lobster","defaultChoice":"npm","minHostVersion":">=2026.4.25"},"release":{"publishToNpm":true,"publishToACTAgentHub":true},"extensions":["./index.ts"]},"repository":{"url":"git+https://github.com/actagent/actagent.git","type":"git"},"_npmVersion":"10.9.4","description":"Lobster workflow tool plugin for typed pipelines and resumable approvals.","directories":{},"_nodeVersion":"22.22.2","dependencies":{"typebox":"1.1.39","@actagentdbot/lobster":"2026.5.22"},"_hasShrinkwrap":true,"devDependencies":{"@actagent/plugin-sdk":"workspace:*"},"_npmOperationalInternal":{"tmp":"tmp/lobster_2026.6.4_1780859928759_0.5015582991824861","host":"s3://npm-registry-packages-npm-production"}},"2026.6.5":{"name":"@actagent/lobster","version":"2026.6.5","description":"Lobster workflow tool plugin for typed pipelines and resumable approvals.","repository":{"type":"git","url":"git+https://github.com/actagent/actagent.git"},"type":"module","dependencies":{"@actagentdbot/lobster":"2026.5.22","typebox":"1.1.39"},"devDependencies":{"@actagent/plugin-sdk":"workspace:*"},"actagent":{"extensions":["./index.ts"],"install":{"npmSpec":"@actagent/lobster","defaultChoice":"npm","minHostVersion":">=2026.4.25"},"compat":{"pluginApi":">=2026.6.2"},"build":{"actagentVersion":"2026.6.2"},"release":{"publishToACTAgentHub":true,"publishToNpm":true}},"_id":"@actagent/lobster@2026.6.5","gitHead":"ededc059e0bb8427ebbe8c766f3fbc49d190d1ac","bugs":{"url":"https://github.com/actagent/actagent/issues"},"homepage":"https://github.com/actagent/actagent#readme","_nodeVersion":"22.22.2","_npmVersion":"10.9.4","dist":{"integrity":"sha512-7rlx7LVQODDQvZniUi+vPPczxNNTlNpqQEmYOh2cz5EiDRhg24fbqOcirCTtKBgovjFj1NlNhKfBNi857+ajdg==","shasum":"8894002471c4935856001a48f410e8373b5c26b7","tarball":"https://registry.npmjs.org/@actagent/lobster/-/lobster-2026.6.5.tgz","fileCount":17,"unpackedSize":88639,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIQCfjz98v4Y7ejlVcHvUjmVxfZBGpWIOPRrRPU/cpkM/mAIgQ4E6i5JWM41OIzk+I0r+mlRlEdEOz07pyHqRXga0f9M="}]},"_npmUser":{"name":"nidaye0525","email":"nidaye0525@gmail.com"},"directories":{},"maintainers":[{"name":"nidaye0525","email":"nidaye0525@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/lobster_2026.6.5_1780866168520_0.9064725285143673"},"_hasShrinkwrap":true}},"time":{"created":"2026-06-05T20:12:52.759Z","modified":"2026-06-07T21:02:48.802Z","2026.6.2":"2026-06-05T20:12:53.018Z","2026.6.3":"2026-06-07T18:10:44.204Z","2026.6.4":"2026-06-07T19:18:48.898Z","2026.6.5":"2026-06-07T21:02:48.683Z"},"bugs":{"url":"https://github.com/actagent/actagent/issues"},"homepage":"https://github.com/actagent/actagent#readme","repository":{"type":"git","url":"git+https://github.com/actagent/actagent.git"},"description":"Lobster workflow tool plugin for typed pipelines and resumable approvals.","maintainers":[{"name":"nidaye0525","email":"nidaye0525@gmail.com"}],"readme":"# Lobster (plugin)\n\nAdds the `lobster` agent tool as an **optional** plugin tool.\n\n## Install\n\n```bash\nactagent plugins install @actagent/lobster\n```\n\nRestart the Gateway after installing or updating the plugin.\n\n## What this is\n\n- Lobster is a standalone workflow shell (typed JSON-first pipelines + approvals/resume).\n- This plugin integrates Lobster with ACTAgent _without core changes_.\n\n## Enable\n\nBecause this tool can trigger side effects (via workflows), it is registered with `optional: true`.\n\nEnable it in an agent allowlist:\n\n```json\n{\n  \"agents\": {\n    \"list\": [\n      {\n        \"id\": \"main\",\n        \"tools\": {\n          \"allow\": [\n            \"lobster\" // plugin id (enables all tools from this plugin)\n          ]\n        }\n      }\n    ]\n  }\n}\n```\n\n## Using `actagent.invoke` (Lobster → ACTAgent tools)\n\nSome Lobster pipelines may include a `actagent.invoke` step to call back into ACTAgent tools/plugins (for example: `gog` for Google Workspace, `gh` for GitHub, `message.send`, etc.).\n\nFor this to work, the ACTAgent Gateway must expose the tool bridge endpoint and the target tool must be allowed by policy:\n\n- ACTAgent provides an HTTP endpoint: `POST /tools/invoke`.\n- The request is gated by **gateway auth** (e.g. `Authorization: Bearer …` when token auth is enabled).\n- The invoked tool is gated by **tool policy** (global + per-agent + provider + group policy). If the tool is not allowed, ACTAgent returns `404 Tool not available`.\n\n### Allowlisting recommended\n\nTo avoid letting workflows call arbitrary tools, set a tight allowlist on the agent that will be used by `actagent.invoke`.\n\nExample (allow only a small set of tools):\n\n```jsonc\n{\n  \"agents\": {\n    \"list\": [\n      {\n        \"id\": \"main\",\n        \"tools\": {\n          \"allow\": [\"lobster\", \"web_fetch\", \"web_search\", \"gog\", \"gh\"],\n          \"deny\": [\"gateway\"],\n        },\n      },\n    ],\n  },\n}\n```\n\nNotes:\n\n- If `tools.allow` is omitted or empty, it behaves like \"allow everything (except denied)\". For a real allowlist, set a **non-empty** `allow`.\n- Tool names depend on which plugins you have installed/enabled.\n\n## Security\n\n- Runs Lobster in process via the published `@actagentdbot/lobster/core` runtime.\n- Does not manage OAuth/tokens.\n- Uses timeouts, stdout caps, and strict JSON envelope parsing.\n\n## Docs\n\n- https://docs.actagent.ai/tools/lobster\n\n## Package\n\n- Plugin id: `lobster`\n- Tool: `lobster`\n- Package: `@actagent/lobster`\n- Minimum ACTAgent host: `2026.4.25`\n","readmeFilename":"README.md"}