{"_id":"@agent-sh/harness-bash","_rev":"4-78271f748cc725ea0c013c991fd8e745","name":"@agent-sh/harness-bash","dist-tags":{"latest":"0.7.1"},"versions":{"0.2.0":{"name":"@agent-sh/harness-bash","version":"0.2.0","keywords":["ai","agent","llm","tool-use","bash","shell","exec","sandbox","bedrock","openai"],"author":{"name":"Avi Fenesh"},"license":"MIT","_id":"@agent-sh/harness-bash@0.2.0","maintainers":[{"name":"avifenesh","email":"aviarchi1994@gmail.com"}],"homepage":"https://github.com/avifenesh/tools/tree/main/packages/bash#readme","bugs":{"url":"https://github.com/avifenesh/tools/issues"},"dist":{"shasum":"853966957addaaf871ffe31936354d71a9188e3f","tarball":"https://registry.npmjs.org/@agent-sh/harness-bash/-/harness-bash-0.2.0.tgz","fileCount":9,"integrity":"sha512-w2LLy7da5Ux8N1hxQAyMM/aeuevPAdsvbZZS02OfXYpZGnxCaDErHtjkDv/O1wAcZEqYWtzvFtQlwJcUk0GmsQ==","signatures":[{"sig":"MEUCIFq6ay/C7HUKdHFTeyhDAr5M+Aw6WEgET96BqTDtPuiKAiEAvuRzSkJ0CXXnnu1T4iFSdS/pX7E8HwzC0tUNkVBnDBk=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":256179},"main":"./dist/index.cjs","type":"module","_from":"file:agent-sh-harness-bash-0.2.0.tgz","types":"./dist/index.d.ts","module":"./dist/index.js","engines":{"node":">=20"},"exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js","require":"./dist/index.cjs"}},"scripts":{"test":"vitest run","build":"tsup","clean":"rm -rf dist .turbo","typecheck":"tsc --noEmit","test:watch":"vitest"},"_npmUser":{"name":"avifenesh","email":"aviarchi1994@gmail.com"},"_resolved":"/tmp/31784cd8620dce1b9d369cc4a3416be5/agent-sh-harness-bash-0.2.0.tgz","_integrity":"sha512-w2LLy7da5Ux8N1hxQAyMM/aeuevPAdsvbZZS02OfXYpZGnxCaDErHtjkDv/O1wAcZEqYWtzvFtQlwJcUk0GmsQ==","repository":{"url":"git+https://github.com/avifenesh/tools.git","type":"git","directory":"packages/bash"},"_npmVersion":"10.8.2","description":"Bash tool for AI agent harnesses — autonomous shell execution with pluggable executor, permission hook, cwd-carry, inactivity timeout, and background job support","directories":{},"_nodeVersion":"20.20.2","dependencies":{"valibot":"^0.42.1","@agent-sh/harness-core":"0.2.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"tsup":"^8.3.5","vitest":"^2.1.4","typescript":"^5.6.3","@types/node":"^22.9.0"},"_npmOperationalInternal":{"tmp":"tmp/harness-bash_0.2.0_1776853081058_0.8161099727403143","host":"s3://npm-registry-packages-npm-production"}},"0.4.0":{"name":"@agent-sh/harness-bash","version":"0.4.0","keywords":["ai","agent","llm","tool-use","bash","shell","exec","sandbox","bedrock","openai"],"author":{"name":"Avi Fenesh"},"license":"MIT","_id":"@agent-sh/harness-bash@0.4.0","maintainers":[{"name":"avifenesh","email":"aviarchi1994@gmail.com"}],"homepage":"https://github.com/avifenesh/tools/tree/main/packages/bash#readme","bugs":{"url":"https://github.com/avifenesh/tools/issues"},"dist":{"shasum":"c18d6a89e3dc46ad8c247f33fdb33c2a13b6d85e","tarball":"https://registry.npmjs.org/@agent-sh/harness-bash/-/harness-bash-0.4.0.tgz","fileCount":9,"integrity":"sha512-HaONjaQGlafmgHj5dqDUynVUgFUtkAv1BD2k7CwD1CSSsG0D6shyyCsuBJpSxAhPQSRhU2wPq8bCDsxO/a9EFA==","signatures":[{"sig":"MEUCICWq0gjkYBdxvn+LD2fYFVhdvJo41m0fSCkQqQiJfTqkAiEAgzpceYxXkY4gExu7AgYzx51N2Rt9eJ429gSugEcTNQg=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":257244},"main":"./dist/index.cjs","type":"module","_from":"file:agent-sh-harness-bash-0.4.0.tgz","types":"./dist/index.d.ts","module":"./dist/index.js","engines":{"node":">=20"},"exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js","require":"./dist/index.cjs"}},"scripts":{"test":"vitest run","build":"tsup","clean":"rm -rf dist .turbo","typecheck":"tsc --noEmit","test:watch":"vitest"},"_npmUser":{"name":"avifenesh","email":"aviarchi1994@gmail.com"},"_resolved":"/tmp/e01a1ae7425007ae45a511b6d21cd379/agent-sh-harness-bash-0.4.0.tgz","_integrity":"sha512-HaONjaQGlafmgHj5dqDUynVUgFUtkAv1BD2k7CwD1CSSsG0D6shyyCsuBJpSxAhPQSRhU2wPq8bCDsxO/a9EFA==","repository":{"url":"git+https://github.com/avifenesh/tools.git","type":"git","directory":"packages/bash"},"_npmVersion":"10.8.2","description":"Bash tool for AI agent harnesses — autonomous shell execution with pluggable executor, permission hook, cwd-carry, inactivity timeout, and background job support","directories":{},"_nodeVersion":"20.20.2","dependencies":{"valibot":"^1.2.0","@agent-sh/harness-core":"0.2.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"tsup":"^8.3.5","vitest":"^2.1.4","typescript":"^5.6.3","@types/node":"^22.9.0"},"_npmOperationalInternal":{"tmp":"tmp/harness-bash_0.4.0_1780428524662_0.28857344716619937","host":"s3://npm-registry-packages-npm-production"}},"0.5.0":{"name":"@agent-sh/harness-bash","version":"0.5.0","keywords":["ai","agent","llm","tool-use","bash","shell","exec","sandbox","bedrock","openai"],"author":{"name":"Avi Fenesh"},"license":"MIT","_id":"@agent-sh/harness-bash@0.5.0","maintainers":[{"name":"avifenesh","email":"aviarchi1994@gmail.com"}],"homepage":"https://github.com/avifenesh/tools/tree/main/packages/bash#readme","bugs":{"url":"https://github.com/avifenesh/tools/issues"},"dist":{"shasum":"fc413a1ec73bbab547074e788b391a846dad11e3","tarball":"https://registry.npmjs.org/@agent-sh/harness-bash/-/harness-bash-0.5.0.tgz","fileCount":9,"integrity":"sha512-Wv4H9fFwzQPObDkN62kcC/cmlf4YGBC06U7zt2CQgP1KJtlz7rNFNsj67DivRW3pFLW+ZIFAMa7BBOmxh+covQ==","signatures":[{"sig":"MEUCIQClmcMGWOP2e9L07A3Hmw3AEwIN2SvUloQUdxbrRq+YLQIgL3BTrKypbMZ6lfPdZc6u+RVwSDjMze3vZSt5fTvkxz4=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":281927},"main":"./dist/index.cjs","type":"module","_from":"file:agent-sh-harness-bash-0.5.0.tgz","types":"./dist/index.d.ts","module":"./dist/index.js","engines":{"node":">=20"},"exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js","require":"./dist/index.cjs"}},"scripts":{"test":"vitest run","build":"tsup","clean":"rm -rf dist .turbo","typecheck":"tsc --noEmit","test:watch":"vitest"},"_npmUser":{"name":"avifenesh","email":"aviarchi1994@gmail.com"},"_resolved":"/tmp/5885ba18abc1bc3262ee4f2926728e6a/agent-sh-harness-bash-0.5.0.tgz","_integrity":"sha512-Wv4H9fFwzQPObDkN62kcC/cmlf4YGBC06U7zt2CQgP1KJtlz7rNFNsj67DivRW3pFLW+ZIFAMa7BBOmxh+covQ==","repository":{"url":"git+https://github.com/avifenesh/tools.git","type":"git","directory":"packages/bash"},"_npmVersion":"10.8.2","description":"Bash tool for AI agent harnesses — autonomous shell execution with pluggable executor, permission hook, cwd-carry, inactivity timeout, and background job support","directories":{},"_nodeVersion":"20.20.2","dependencies":{"valibot":"^1.2.0","@agent-sh/harness-core":"0.2.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"tsup":"^8.3.5","vitest":"^2.1.4","typescript":"^5.6.3","@types/node":"^22.9.0"},"_npmOperationalInternal":{"tmp":"tmp/harness-bash_0.5.0_1780760596287_0.413320458599006","host":"s3://npm-registry-packages-npm-production"}},"0.7.1":{"name":"@agent-sh/harness-bash","version":"0.7.1","description":"Bash tool for AI agent harnesses — autonomous shell execution with pluggable executor, permission hook, cwd-carry, inactivity timeout, and background job support","keywords":["ai","agent","llm","tool-use","bash","shell","exec","sandbox","bedrock","openai"],"license":"MIT","author":{"name":"Avi Fenesh"},"homepage":"https://github.com/avifenesh/tools/tree/main/packages/bash#readme","bugs":{"url":"https://github.com/avifenesh/tools/issues"},"repository":{"type":"git","url":"git+https://github.com/avifenesh/tools.git","directory":"packages/bash"},"type":"module","main":"./dist/index.cjs","module":"./dist/index.js","types":"./dist/index.d.ts","exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js","require":"./dist/index.cjs"}},"publishConfig":{"access":"public"},"engines":{"node":">=20"},"dependencies":{"valibot":"^1.2.0","@agent-sh/harness-core":"0.2.0"},"devDependencies":{"@types/node":"^22.9.0","tsup":"^8.3.5","typescript":"^5.6.3","vitest":"^3.2.6"},"scripts":{"build":"tsup","test":"vitest run","test:watch":"vitest","typecheck":"tsc --noEmit","clean":"rm -rf dist .turbo"},"_id":"@agent-sh/harness-bash@0.7.1","_integrity":"sha512-MpRu1V0QuKNrKXDpQ8Hxdmi7s1kNNtxV66vlGE71VX5f5uMsP/wQP9S2DTj+UxvvivTDSZl4DsOx4OeBltedew==","_resolved":"/tmp/31dc67996d9aa1ed6b769e6163e5864f/agent-sh-harness-bash-0.7.1.tgz","_from":"file:agent-sh-harness-bash-0.7.1.tgz","_nodeVersion":"20.20.2","_npmVersion":"10.8.2","dist":{"integrity":"sha512-MpRu1V0QuKNrKXDpQ8Hxdmi7s1kNNtxV66vlGE71VX5f5uMsP/wQP9S2DTj+UxvvivTDSZl4DsOx4OeBltedew==","shasum":"fd0b5b3760a2bb9f5d1305a0e0e8f81669bf20b4","tarball":"https://registry.npmjs.org/@agent-sh/harness-bash/-/harness-bash-0.7.1.tgz","fileCount":9,"unpackedSize":290425,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCICVSMyCPg/I6JhaXaghkGifdvG1/DVHl8HHQpV6qfRUlAiEAgsY60SZcuq2/8jdrGpGrsPBk7l5s6VLdOyh7E8q0j6A="}]},"_npmUser":{"name":"avifenesh","email":"aviarchi1994@gmail.com"},"directories":{},"maintainers":[{"name":"avifenesh","email":"aviarchi1994@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/harness-bash_0.7.1_1781647633588_0.3167442182615583"},"_hasShrinkwrap":false}},"time":{"created":"2026-04-22T10:18:00.944Z","modified":"2026-06-16T22:07:13.892Z","0.2.0":"2026-04-22T10:18:01.199Z","0.4.0":"2026-06-02T19:28:44.795Z","0.5.0":"2026-06-06T15:43:16.413Z","0.7.1":"2026-06-16T22:07:13.740Z"},"bugs":{"url":"https://github.com/avifenesh/tools/issues"},"author":{"name":"Avi Fenesh"},"license":"MIT","homepage":"https://github.com/avifenesh/tools/tree/main/packages/bash#readme","keywords":["ai","agent","llm","tool-use","bash","shell","exec","sandbox","bedrock","openai"],"repository":{"type":"git","url":"git+https://github.com/avifenesh/tools.git","directory":"packages/bash"},"description":"Bash tool for AI agent harnesses — autonomous shell execution with pluggable executor, permission hook, cwd-carry, inactivity timeout, and background job support","maintainers":[{"name":"avifenesh","email":"aviarchi1994@gmail.com"}],"readme":"# @agent-sh/harness-bash\n\nShell with tokio-style cwd-carry, inactivity + wall-clock timeouts, head+tail spill-to-file on overflow, and background jobs.\n\nPart of the [`@agent-sh/harness-*`](https://github.com/avifenesh/tools) monorepo — see the top-level README for architectural context and the full tool surface.\n\n## Install\n\n```sh\nnpm install @agent-sh/harness-bash\n```\n\nRequires Node ≥ 20.\n\n## Usage\n\n```ts\nimport { bash, bash_output, bash_kill, createLocalBashExecutor } from \"@agent-sh/harness-bash\";\n\nconst session = {\n  cwd: process.cwd(),\n  permissions: { roots: [process.cwd()], sensitivePatterns: [], unsafeAllowBashWithoutHook: true },\n  executor: createLocalBashExecutor(),\n  logicalCwd: { value: process.cwd() },\n};\n\nconst r = await bash({ command: \"ls -la\" }, session);\n```\n\n## Contract\n\nThe full contract — input shape, output discriminated-union, error codes, permission model, and acceptance tests — lives in [`agent-knowledge/design/bash.md`](https://github.com/avifenesh/tools/blob/main/agent-knowledge/design/bash.md). Changes to this package must stay in sync with that spec.\n\n## License\n\nMIT © Avi Fenesh\n","readmeFilename":"README.md"}