{"_id":"@douglas-agent/sandbank-agent","name":"@douglas-agent/sandbank-agent","dist-tags":{"latest":"0.2.0"},"versions":{"0.2.0":{"name":"@douglas-agent/sandbank-agent","version":"0.2.0","description":"Lightweight client for AI agents running inside Sandbank sandboxes","license":"MIT","type":"module","homepage":"https://sandbank.dev","repository":{"type":"git","url":"git+https://github.com/Xeonice/sandbank-douglas-agent.git","directory":"packages/agent"},"keywords":["sandbox","ai-agent","client","cli"],"exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js"}},"bin":{"sandbank-agent":"dist/cli.js"},"scripts":{"build":"tsc","typecheck":"tsc --noEmit","clean":"rm -rf dist"},"peerDependencies":{"@douglas-agent/sandbank-core":"^0.3.6"},"devDependencies":{"@douglas-agent/sandbank-core":"^0.3.6","@douglas-agent/sandbank-relay":"^0.2.1","@types/node":"^22.15.0","typescript":"^5.7.3","ws":"^8.18.0","@types/ws":"^8.18.0"},"gitHead":"0589f4137bb7d4e3bafb0f4dd1ef45e50253cd45","_id":"@douglas-agent/sandbank-agent@0.2.0","bugs":{"url":"https://github.com/Xeonice/sandbank-douglas-agent/issues"},"_nodeVersion":"24.15.0","_npmVersion":"11.14.1","dist":{"integrity":"sha512-nAp/4eYMeVrNEeTR/ZxcyblGiaB1b45hcJXOF0UI/rLGscjlNVVs9uAQe2osGZaJYutDCiJ/eiX3gujw474JjA==","shasum":"5ef84718279c774db2c5fcb1f3a8fa85f3329566","tarball":"https://registry.npmjs.org/@douglas-agent/sandbank-agent/-/sandbank-agent-0.2.0.tgz","fileCount":26,"unpackedSize":26597,"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@douglas-agent%2fsandbank-agent@0.2.0","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIQDi49cIBczdePVOAkh4K9/eZDSMQLdE3GtGJmISG+4iqgIgZ2tHxL8OI+1K9UTMy8ZLs700NmdNi0JQbAqXsEEKUsw="}]},"_npmUser":{"name":"douglasdong","email":"ad546971975@gmail.com"},"directories":{},"maintainers":[{"name":"douglasdong","email":"ad546971975@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/sandbank-agent_0.2.0_1779268693995_0.48891464114881833"},"_hasShrinkwrap":false}},"time":{"created":"2026-05-20T09:18:13.878Z","0.2.0":"2026-05-20T09:18:14.147Z","modified":"2026-05-20T09:18:14.538Z"},"maintainers":[{"name":"douglasdong","email":"ad546971975@gmail.com"}],"description":"Lightweight client for AI agents running inside Sandbank sandboxes","homepage":"https://sandbank.dev","keywords":["sandbox","ai-agent","client","cli"],"repository":{"type":"git","url":"git+https://github.com/Xeonice/sandbank-douglas-agent.git","directory":"packages/agent"},"bugs":{"url":"https://github.com/Xeonice/sandbank-douglas-agent/issues"},"license":"MIT","readme":"# @douglas-agent/sandbank-agent\n\n> Lightweight client for AI agents running inside [Sandbank](../../README.md) sandboxes.\n\nConnects to the relay server via WebSocket, enabling messaging, shared context, and task completion signaling.\n\n## Install\n\n```bash\npnpm add @douglas-agent/sandbank-agent\n```\n\n## Usage\n\nRuns inside a sandbox. Connection parameters are read from `SANDBANK_*` environment variables injected by `createSession()`:\n\n```typescript\nimport { connect } from '@douglas-agent/sandbank-agent'\n\nconst session = await connect()\n\n// Listen for messages\nsession.on('message', async (msg) => {\n  if (msg.type === 'task') {\n    const result = await doWork(msg.payload)\n    await session.send(msg.from, 'done', result)\n  }\n})\n\n// Shared context\nconst spec = await session.context.get('spec')\nawait session.context.set('output', { files: ['index.ts'] })\n\n// Signal completion\nawait session.complete({ status: 'success', summary: 'Built 5 endpoints' })\nsession.close()\n```\n\n## CLI\n\nAlso available as a CLI tool for shell scripts inside sandboxes:\n\n```bash\nsandbank-agent send <to> <type> [payload]\nsandbank-agent recv [--wait 5000]\nsandbank-agent context get <key>\nsandbank-agent context set <key> <value>\nsandbank-agent complete <status> <summary>\n```\n\n## Environment Variables\n\n| Variable | Description |\n|----------|-------------|\n| `SANDBANK_WS_URL` | Relay WebSocket URL |\n| `SANDBANK_SESSION_ID` | Session identifier |\n| `SANDBANK_SANDBOX_NAME` | This agent's sandbox name |\n| `SANDBANK_AUTH_TOKEN` | Authentication token |\n\n## License\n\nMIT\n","readmeFilename":"README.md","_rev":"1-ee684dcfc90938d5c57692e37d94420e"}