{"_id":"@agents-js/acp-host","_rev":"10-15e5e6f18cec5d5fd1907f1e3dfa570a","name":"@agents-js/acp-host","dist-tags":{"rc1":"0.3.1-rc1","latest":"0.5.1"},"versions":{"0.2.0":{"name":"@agents-js/acp-host","version":"0.2.0","keywords":["acp","agent-client-protocol","host","session","permissions"],"author":{"name":"Jens Bodal"},"license":"MIT","_id":"@agents-js/acp-host@0.2.0","maintainers":[{"name":"jensbodal_dev","email":"jensbodal@gmail.com"}],"homepage":"https://agents-js.bodal.dev/","bugs":{"url":"https://github.com/jensbodal/agents-js/issues"},"dist":{"shasum":"c223e8ef34643fa5e5fbdae584d8f95503cc93cf","tarball":"https://registry.npmjs.org/@agents-js/acp-host/-/acp-host-0.2.0.tgz","fileCount":78,"integrity":"sha512-NEVugVGLUNizgQEEgYY5KT0NexV3wSy8hobc/NeVWqpVekrQ4vuMjlAd6YT41qiVu8jTY4zFJxT1ZCv4MGB10g==","signatures":[{"sig":"MEQCIAfRGkNmwo5LXBDXOd9PsQ0ELdkD729tDX3VfsVHyCsWAiAVJTV3oQyd83yhz1Y5LE3WiKUqo07AiuIeSQ0qAgMozA==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":526420},"main":"dist/index.mjs","type":"module","_from":"file:/var/folders/ws/wl7n084x6hncz0nppv2p_2p00000gn/T/agents-js-publish-acp-host-hhy60o/agents-js-acp-host-0.2.0.tgz","types":"dist/index.d.mts","engines":{"bun":">=1.3.11","node":">=20.19.0"},"exports":{".":{"bun":"./src/index.ts","types":"./dist/index.d.mts","import":"./dist/index.mjs","browser":"./dist/browser.mjs","default":"./dist/index.mjs"},"./editor":{"bun":"./src/editor/index.ts","types":"./dist/editor/index.d.mts","import":"./dist/editor/index.mjs","browser":"./dist/editor/browser.mjs","default":"./dist/editor/index.mjs"},"./testing":{"bun":"./src/testing.ts","types":"./dist/testing.d.mts","import":"./dist/testing.mjs","default":"./dist/testing.mjs"},"./session-restore":{"bun":"./src/session-restore.ts","types":"./dist/session-restore.d.mts","import":"./dist/session-restore.mjs","default":"./dist/session-restore.mjs"},"./workflow-surface":{"bun":"./src/workflow-surface.ts","types":"./dist/workflow-surface.d.mts","import":"./dist/workflow-surface.mjs","default":"./dist/workflow-surface.mjs"}},"scripts":{"test":"bun test tests","build":"bunx tsdown src/index.ts src/browser.ts src/testing.ts src/editor/index.ts src/editor/browser.ts src/session-restore.ts src/workflow-surface.ts --format esm --dts --out-dir dist --clean","prepack":"bun run build"},"_npmUser":{"name":"jensbodal_dev","email":"jensbodal@gmail.com"},"_resolved":"/var/folders/ws/wl7n084x6hncz0nppv2p_2p00000gn/T/agents-js-publish-acp-host-hhy60o/agents-js-acp-host-0.2.0.tgz","_integrity":"sha512-NEVugVGLUNizgQEEgYY5KT0NexV3wSy8hobc/NeVWqpVekrQ4vuMjlAd6YT41qiVu8jTY4zFJxT1ZCv4MGB10g==","repository":{"url":"git+https://github.com/jensbodal/agents-js.git","type":"git","directory":"packages/acp-host"},"_npmVersion":"11.13.0","description":"Stateful ACP host embedding surface. Manages agent sessions, terminal processes, permissions, and file I/O for host applications.","directories":{},"sideEffects":false,"_nodeVersion":"24.15.0","dependencies":{"@agents-js/acp":"0.2.0","@agents-js/policy":"0.2.0","@agentclientprotocol/sdk":"0.21.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/acp-host_0.2.0_1778309186352_0.38941443035299006","host":"s3://npm-registry-packages-npm-production"}},"0.2.1":{"name":"@agents-js/acp-host","version":"0.2.1","keywords":["acp","agent-client-protocol","host","session","permissions"],"author":{"name":"Jens Bodal"},"license":"MIT","_id":"@agents-js/acp-host@0.2.1","maintainers":[{"name":"jensbodal_dev","email":"jensbodal@gmail.com"}],"homepage":"https://agents-js.bodal.dev/","bugs":{"url":"https://github.com/jensbodal/agents-js/issues"},"dist":{"shasum":"9baa096f50aaace5dab4c17b25d1255b582c6104","tarball":"https://registry.npmjs.org/@agents-js/acp-host/-/acp-host-0.2.1.tgz","fileCount":78,"integrity":"sha512-WZBsZebHUhwE9nz/ZhVrBIVa30H/ooVMbTldYNS3ckoLkkESm1XiT88vevtBzmbyaK9ifQKEeNq0vFIcbZPWBw==","signatures":[{"sig":"MEUCIFKqz7JMHhwECxQiFK8iLhwEv/VpLZGfuYM8oC8EpMk9AiEA0vAzOdk5fDtH4BM1PlDDZF5z4ybSN+EORLhIfrk+zcc=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":526420},"main":"dist/index.mjs","type":"module","_from":"file:/var/folders/ws/wl7n084x6hncz0nppv2p_2p00000gn/T/agents-js-publish-acp-host-5p7SXy/agents-js-acp-host-0.2.1.tgz","types":"dist/index.d.mts","engines":{"bun":">=1.3.11","node":">=20.19.0"},"exports":{".":{"bun":"./src/index.ts","types":"./dist/index.d.mts","import":"./dist/index.mjs","browser":"./dist/browser.mjs","default":"./dist/index.mjs"},"./editor":{"bun":"./src/editor/index.ts","types":"./dist/editor/index.d.mts","import":"./dist/editor/index.mjs","browser":"./dist/editor/browser.mjs","default":"./dist/editor/index.mjs"},"./testing":{"bun":"./src/testing.ts","types":"./dist/testing.d.mts","import":"./dist/testing.mjs","default":"./dist/testing.mjs"},"./session-restore":{"bun":"./src/session-restore.ts","types":"./dist/session-restore.d.mts","import":"./dist/session-restore.mjs","default":"./dist/session-restore.mjs"},"./workflow-surface":{"bun":"./src/workflow-surface.ts","types":"./dist/workflow-surface.d.mts","import":"./dist/workflow-surface.mjs","default":"./dist/workflow-surface.mjs"}},"scripts":{"test":"bun test tests","build":"bunx tsdown src/index.ts src/browser.ts src/testing.ts src/editor/index.ts src/editor/browser.ts src/session-restore.ts src/workflow-surface.ts --format esm --dts --out-dir dist --clean","prepack":"bun run build"},"_npmUser":{"name":"jensbodal_dev","email":"jensbodal@gmail.com"},"_resolved":"/var/folders/ws/wl7n084x6hncz0nppv2p_2p00000gn/T/agents-js-publish-acp-host-5p7SXy/agents-js-acp-host-0.2.1.tgz","_integrity":"sha512-WZBsZebHUhwE9nz/ZhVrBIVa30H/ooVMbTldYNS3ckoLkkESm1XiT88vevtBzmbyaK9ifQKEeNq0vFIcbZPWBw==","repository":{"url":"git+https://github.com/jensbodal/agents-js.git","type":"git","directory":"packages/acp-host"},"_npmVersion":"11.13.0","description":"Stateful ACP host embedding surface. Manages agent sessions, terminal processes, permissions, and file I/O for host applications.","directories":{},"sideEffects":false,"_nodeVersion":"24.15.0","dependencies":{"@agents-js/acp":"0.2.1","@agents-js/policy":"0.2.1","@agentclientprotocol/sdk":"0.21.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/acp-host_0.2.1_1778339134145_0.6910287743038352","host":"s3://npm-registry-packages-npm-production"}},"0.2.2":{"name":"@agents-js/acp-host","version":"0.2.2","keywords":["acp","agent-client-protocol","host","session","permissions"],"author":{"name":"Jens Bodal"},"license":"MIT","_id":"@agents-js/acp-host@0.2.2","maintainers":[{"name":"jensbodal_dev","email":"jensbodal@gmail.com"}],"homepage":"https://agents-js.bodal.dev/","bugs":{"url":"https://github.com/jensbodal/agents-js/issues"},"dist":{"shasum":"b01f5f67d4e69ef5207a2597994457e94e848e49","tarball":"https://registry.npmjs.org/@agents-js/acp-host/-/acp-host-0.2.2.tgz","fileCount":78,"integrity":"sha512-3lbfWDSaOWRqteX6qebP22ycQc7hrB3FKiNXA4VYcdHGSceDWXp3/BBndGbMkJO9Kg7uab53GjJBbysX2uakyg==","signatures":[{"sig":"MEUCIC+aVIt91CBT/MgV73TEsuC25KbiujX7gasTOy59uyk7AiEA0R9h/858MjiS6R0kMDpXlu72xZBUnhYXC3lHEUKa4t0=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":526420},"main":"dist/index.mjs","type":"module","_from":"file:/var/folders/ws/wl7n084x6hncz0nppv2p_2p00000gn/T/agents-js-publish-acp-host-d9s9MT/agents-js-acp-host-0.2.2.tgz","types":"dist/index.d.mts","engines":{"bun":">=1.3.11","node":">=20.19.0"},"exports":{".":{"bun":"./src/index.ts","types":"./dist/index.d.mts","import":"./dist/index.mjs","browser":"./dist/browser.mjs","default":"./dist/index.mjs"},"./editor":{"bun":"./src/editor/index.ts","types":"./dist/editor/index.d.mts","import":"./dist/editor/index.mjs","browser":"./dist/editor/browser.mjs","default":"./dist/editor/index.mjs"},"./testing":{"bun":"./src/testing.ts","types":"./dist/testing.d.mts","import":"./dist/testing.mjs","default":"./dist/testing.mjs"},"./session-restore":{"bun":"./src/session-restore.ts","types":"./dist/session-restore.d.mts","import":"./dist/session-restore.mjs","default":"./dist/session-restore.mjs"},"./workflow-surface":{"bun":"./src/workflow-surface.ts","types":"./dist/workflow-surface.d.mts","import":"./dist/workflow-surface.mjs","default":"./dist/workflow-surface.mjs"}},"scripts":{"test":"bun test tests","build":"bunx tsdown src/index.ts src/browser.ts src/testing.ts src/editor/index.ts src/editor/browser.ts src/session-restore.ts src/workflow-surface.ts --format esm --dts --out-dir dist --clean","prepack":"bun run build"},"_npmUser":{"name":"jensbodal_dev","email":"jensbodal@gmail.com"},"_resolved":"/var/folders/ws/wl7n084x6hncz0nppv2p_2p00000gn/T/agents-js-publish-acp-host-d9s9MT/agents-js-acp-host-0.2.2.tgz","_integrity":"sha512-3lbfWDSaOWRqteX6qebP22ycQc7hrB3FKiNXA4VYcdHGSceDWXp3/BBndGbMkJO9Kg7uab53GjJBbysX2uakyg==","repository":{"url":"git+https://github.com/jensbodal/agents-js.git","type":"git","directory":"packages/acp-host"},"_npmVersion":"11.13.0","description":"Stateful ACP host embedding surface. Manages agent sessions, terminal processes, permissions, and file I/O for host applications.","directories":{},"sideEffects":false,"_nodeVersion":"24.15.0","dependencies":{"@agents-js/acp":"0.2.2","@agents-js/policy":"0.2.2","@agentclientprotocol/sdk":"0.21.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/acp-host_0.2.2_1778343641767_0.3214973767358724","host":"s3://npm-registry-packages-npm-production"}},"0.3.0":{"name":"@agents-js/acp-host","version":"0.3.0","keywords":["acp","agent-client-protocol","host","session","permissions"],"author":{"name":"Jens Bodal"},"license":"MIT","_id":"@agents-js/acp-host@0.3.0","maintainers":[{"name":"jensbodal_dev","email":"jensbodal@gmail.com"}],"homepage":"https://agents-js.bodal.dev/","bugs":{"url":"https://github.com/jensbodal/agents-js/issues"},"dist":{"shasum":"702774a0a47efe2c7ad10a6fa9956e62035cf4f2","tarball":"https://registry.npmjs.org/@agents-js/acp-host/-/acp-host-0.3.0.tgz","fileCount":79,"integrity":"sha512-OMLz4E7Vhg3Q/kmogKUJuwQcSvdxc5WGnfW8KJt/2GunmjprZFMu7FbUSUEqOfUIurFUCBL4+vRUOwxrd3XZiw==","signatures":[{"sig":"MEQCIBowAORiCl0pkFKS56QlSgHBeomuyYIfHMQeif6m7ASlAiBVNX5crkZY6oJKRMaFMGzBamjLIZU4elUOjR4qv7HPKw==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":542075},"main":"dist/index.mjs","type":"module","_from":"file:/var/folders/ws/wl7n084x6hncz0nppv2p_2p00000gn/T/agents-js-publish-acp-host-6yONVn/agents-js-acp-host-0.3.0.tgz","types":"dist/index.d.mts","engines":{"bun":">=1.3.11","node":">=20.19.0"},"exports":{".":{"bun":"./src/index.ts","types":"./dist/index.d.mts","import":"./dist/index.mjs","browser":"./dist/browser.mjs","default":"./dist/index.mjs"},"./editor":{"bun":"./src/editor/index.ts","types":"./dist/editor/index.d.mts","import":"./dist/editor/index.mjs","browser":"./dist/editor/browser.mjs","default":"./dist/editor/index.mjs"},"./testing":{"bun":"./src/testing.ts","types":"./dist/testing.d.mts","import":"./dist/testing.mjs","default":"./dist/testing.mjs"},"./session-restore":{"bun":"./src/session-restore.ts","types":"./dist/session-restore.d.mts","import":"./dist/session-restore.mjs","default":"./dist/session-restore.mjs"},"./workflow-surface":{"bun":"./src/workflow-surface.ts","types":"./dist/workflow-surface.d.mts","import":"./dist/workflow-surface.mjs","default":"./dist/workflow-surface.mjs"}},"scripts":{"test":"bun test tests","build":"bunx tsdown src/index.ts src/browser.ts src/testing.ts src/editor/index.ts src/editor/browser.ts src/session-restore.ts src/workflow-surface.ts --format esm --dts --out-dir dist --clean","prepack":"bun run build"},"_npmUser":{"name":"jensbodal_dev","email":"jensbodal@gmail.com"},"_resolved":"/var/folders/ws/wl7n084x6hncz0nppv2p_2p00000gn/T/agents-js-publish-acp-host-6yONVn/agents-js-acp-host-0.3.0.tgz","_integrity":"sha512-OMLz4E7Vhg3Q/kmogKUJuwQcSvdxc5WGnfW8KJt/2GunmjprZFMu7FbUSUEqOfUIurFUCBL4+vRUOwxrd3XZiw==","repository":{"url":"git+https://github.com/jensbodal/agents-js.git","type":"git","directory":"packages/acp-host"},"_npmVersion":"11.13.0","description":"Stateful ACP host embedding surface. Manages agent sessions, terminal processes, permissions, and file I/O for host applications.","directories":{},"sideEffects":false,"_nodeVersion":"24.15.0","dependencies":{"@agents-js/acp":"0.3.0","@agents-js/policy":"0.3.0","@agentclientprotocol/sdk":"0.21.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/acp-host_0.3.0_1778351291417_0.35785603456977744","host":"s3://npm-registry-packages-npm-production"}},"0.3.1-rc1":{"name":"@agents-js/acp-host","version":"0.3.1-rc1","keywords":["acp","agent-client-protocol","host","session","permissions"],"author":{"name":"Jens Bodal"},"license":"MIT","_id":"@agents-js/acp-host@0.3.1-rc1","maintainers":[{"name":"jensbodal_dev","email":"jensbodal@gmail.com"}],"homepage":"https://agents-js.bodal.dev/","bugs":{"url":"https://github.com/jensbodal/agents-js/issues"},"dist":{"shasum":"20ae1d08787beae8442ff28770ef58eb97e63016","tarball":"https://registry.npmjs.org/@agents-js/acp-host/-/acp-host-0.3.1-rc1.tgz","fileCount":79,"integrity":"sha512-PIWv+l4ER08+TilQ/P5EDzCQCWyd+Wd3tyx3IDqmQMImOJ5IxQSHz55i+sfjKKi3lCmuhaYWwvyrpNdmWWo3pg==","signatures":[{"sig":"MEQCIFxwhfHgjTlf9ech9dSwnXKu8g2f5AlVSQWn24OahUCwAiAvYdcyY79npQVUrKsnous83zU6pX7CLVq5JEmkwPbe1g==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@agents-js%2facp-host@0.3.1-rc1","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":542087},"main":"dist/index.mjs","type":"module","_from":"file:/tmp/agents-js-publish-acp-host-QxvZNO/agents-js-acp-host-0.3.1-rc1.tgz","types":"dist/index.d.mts","engines":{"bun":">=1.3.11","node":">=20.19.0"},"exports":{".":{"bun":"./src/index.ts","types":"./dist/index.d.mts","import":"./dist/index.mjs","browser":"./dist/browser.mjs","default":"./dist/index.mjs"},"./editor":{"bun":"./src/editor/index.ts","types":"./dist/editor/index.d.mts","import":"./dist/editor/index.mjs","browser":"./dist/editor/browser.mjs","default":"./dist/editor/index.mjs"},"./testing":{"bun":"./src/testing.ts","types":"./dist/testing.d.mts","import":"./dist/testing.mjs","default":"./dist/testing.mjs"},"./session-restore":{"bun":"./src/session-restore.ts","types":"./dist/session-restore.d.mts","import":"./dist/session-restore.mjs","default":"./dist/session-restore.mjs"},"./workflow-surface":{"bun":"./src/workflow-surface.ts","types":"./dist/workflow-surface.d.mts","import":"./dist/workflow-surface.mjs","default":"./dist/workflow-surface.mjs"}},"scripts":{"test":"bun test tests","build":"bunx tsdown src/index.ts src/browser.ts src/testing.ts src/editor/index.ts src/editor/browser.ts src/session-restore.ts src/workflow-surface.ts --format esm --dts --out-dir dist --clean","prepack":"bun run build"},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:f64c8efa-9fe3-4e21-870b-09dbb8bc6a9f"}},"_resolved":"/tmp/agents-js-publish-acp-host-QxvZNO/agents-js-acp-host-0.3.1-rc1.tgz","_integrity":"sha512-PIWv+l4ER08+TilQ/P5EDzCQCWyd+Wd3tyx3IDqmQMImOJ5IxQSHz55i+sfjKKi3lCmuhaYWwvyrpNdmWWo3pg==","repository":{"url":"git+https://github.com/jensbodal/agents-js.git","type":"git","directory":"packages/acp-host"},"_npmVersion":"11.12.1","description":"Stateful ACP host embedding surface. Manages agent sessions, terminal processes, permissions, and file I/O for host applications.","directories":{},"sideEffects":false,"_nodeVersion":"24.15.0","dependencies":{"@agents-js/acp":"0.3.1-rc1","@agents-js/policy":"0.3.1-rc1","@agentclientprotocol/sdk":"0.21.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"readmeFilename":"README.md","_npmOperationalInternal":{"tmp":"tmp/acp-host_0.3.1-rc1_1778355289948_0.6438712315115662","host":"s3://npm-registry-packages-npm-production"}},"0.3.1":{"name":"@agents-js/acp-host","version":"0.3.1","keywords":["acp","agent-client-protocol","host","session","permissions"],"author":{"name":"Jens Bodal"},"license":"MIT","_id":"@agents-js/acp-host@0.3.1","maintainers":[{"name":"jensbodal_dev","email":"jensbodal@gmail.com"}],"homepage":"https://agents-js.bodal.dev/","bugs":{"url":"https://github.com/jensbodal/agents-js/issues"},"dist":{"shasum":"67240dd970a230a81a768337469c95d582ce5ced","tarball":"https://registry.npmjs.org/@agents-js/acp-host/-/acp-host-0.3.1.tgz","fileCount":79,"integrity":"sha512-DTES3rLVZzumaKJlup1w0hO1xfEvkrmv6DKzDZz01Uc0cmzoi8AqQZwlSIk79uIowWOTr3ER3l/2YZqa2zKi1A==","signatures":[{"sig":"MEQCIAkj1VNrDHSS3yRoLdOG2xRcJcGtA6HzVmbypyXAmKr3AiAmIUH5V1FVTPD5IVbxB5Z/pUXieX6MjKXoCWwCtEzkZw==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@agents-js%2facp-host@0.3.1","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":542075},"main":"dist/index.mjs","type":"module","_from":"file:/tmp/agents-js-publish-acp-host-Qqugxz/agents-js-acp-host-0.3.1.tgz","types":"dist/index.d.mts","engines":{"bun":">=1.3.11","node":">=20.19.0"},"exports":{".":{"bun":"./src/index.ts","types":"./dist/index.d.mts","import":"./dist/index.mjs","browser":"./dist/browser.mjs","default":"./dist/index.mjs"},"./editor":{"bun":"./src/editor/index.ts","types":"./dist/editor/index.d.mts","import":"./dist/editor/index.mjs","browser":"./dist/editor/browser.mjs","default":"./dist/editor/index.mjs"},"./testing":{"bun":"./src/testing.ts","types":"./dist/testing.d.mts","import":"./dist/testing.mjs","default":"./dist/testing.mjs"},"./session-restore":{"bun":"./src/session-restore.ts","types":"./dist/session-restore.d.mts","import":"./dist/session-restore.mjs","default":"./dist/session-restore.mjs"},"./workflow-surface":{"bun":"./src/workflow-surface.ts","types":"./dist/workflow-surface.d.mts","import":"./dist/workflow-surface.mjs","default":"./dist/workflow-surface.mjs"}},"scripts":{"test":"bun test tests","build":"bunx tsdown src/index.ts src/browser.ts src/testing.ts src/editor/index.ts src/editor/browser.ts src/session-restore.ts src/workflow-surface.ts --format esm --dts --out-dir dist --clean","prepack":"bun run build"},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:f64c8efa-9fe3-4e21-870b-09dbb8bc6a9f"}},"_resolved":"/tmp/agents-js-publish-acp-host-Qqugxz/agents-js-acp-host-0.3.1.tgz","_integrity":"sha512-DTES3rLVZzumaKJlup1w0hO1xfEvkrmv6DKzDZz01Uc0cmzoi8AqQZwlSIk79uIowWOTr3ER3l/2YZqa2zKi1A==","repository":{"url":"git+https://github.com/jensbodal/agents-js.git","type":"git","directory":"packages/acp-host"},"_npmVersion":"11.12.1","description":"Stateful ACP host embedding surface. Manages agent sessions, terminal processes, permissions, and file I/O for host applications.","directories":{},"sideEffects":false,"_nodeVersion":"24.15.0","dependencies":{"@agents-js/acp":"0.3.1","@agents-js/policy":"0.3.1","@agentclientprotocol/sdk":"0.21.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/acp-host_0.3.1_1778357012579_0.8767064045770374","host":"s3://npm-registry-packages-npm-production"}},"0.3.2":{"name":"@agents-js/acp-host","version":"0.3.2","keywords":["acp","agent-client-protocol","host","session","permissions"],"author":{"name":"Jens Bodal"},"license":"MIT","_id":"@agents-js/acp-host@0.3.2","maintainers":[{"name":"jensbodal_dev","email":"jensbodal@gmail.com"}],"homepage":"https://agents-js.bodal.dev/","bugs":{"url":"https://github.com/jensbodal/agents-js/issues"},"dist":{"shasum":"45e838fe400349fbf4ef1cb196cf642c631eaf4b","tarball":"https://registry.npmjs.org/@agents-js/acp-host/-/acp-host-0.3.2.tgz","fileCount":79,"integrity":"sha512-Zk3LYtAvEUP3etTCLAMcWJisNRmleVchJH0lxhm4ETdJ3cuCa04J0X8sF2/cU1jqFQRURyOwfmvXKFIR7pS5sg==","signatures":[{"sig":"MEQCIFkdFDg+7fpnDxHHLeo/CqQhmG1V4hb6uHFug+7QgMTBAiAoJ5c4T4FzsgMfJDvlzv4BxO1RN0qPgJRoVuQovRVG6g==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@agents-js%2facp-host@0.3.2","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":542075},"main":"dist/index.mjs","type":"module","_from":"file:/tmp/agents-js-publish-acp-host-HY5xvw/agents-js-acp-host-0.3.2.tgz","types":"dist/index.d.mts","engines":{"bun":">=1.3.11","node":">=20.19.0"},"exports":{".":{"bun":"./src/index.ts","types":"./dist/index.d.mts","import":"./dist/index.mjs","browser":"./dist/browser.mjs","default":"./dist/index.mjs"},"./editor":{"bun":"./src/editor/index.ts","types":"./dist/editor/index.d.mts","import":"./dist/editor/index.mjs","browser":"./dist/editor/browser.mjs","default":"./dist/editor/index.mjs"},"./testing":{"bun":"./src/testing.ts","types":"./dist/testing.d.mts","import":"./dist/testing.mjs","default":"./dist/testing.mjs"},"./session-restore":{"bun":"./src/session-restore.ts","types":"./dist/session-restore.d.mts","import":"./dist/session-restore.mjs","default":"./dist/session-restore.mjs"},"./workflow-surface":{"bun":"./src/workflow-surface.ts","types":"./dist/workflow-surface.d.mts","import":"./dist/workflow-surface.mjs","default":"./dist/workflow-surface.mjs"}},"scripts":{"test":"bun test tests","build":"bunx tsdown src/index.ts src/browser.ts src/testing.ts src/editor/index.ts src/editor/browser.ts src/session-restore.ts src/workflow-surface.ts --format esm --dts --out-dir dist --clean","prepack":"bun run build"},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:f64c8efa-9fe3-4e21-870b-09dbb8bc6a9f"}},"_resolved":"/tmp/agents-js-publish-acp-host-HY5xvw/agents-js-acp-host-0.3.2.tgz","_integrity":"sha512-Zk3LYtAvEUP3etTCLAMcWJisNRmleVchJH0lxhm4ETdJ3cuCa04J0X8sF2/cU1jqFQRURyOwfmvXKFIR7pS5sg==","repository":{"url":"git+https://github.com/jensbodal/agents-js.git","type":"git","directory":"packages/acp-host"},"_npmVersion":"11.12.1","description":"Stateful ACP host embedding surface. Manages agent sessions, terminal processes, permissions, and file I/O for host applications.","directories":{},"sideEffects":false,"_nodeVersion":"24.15.0","dependencies":{"@agents-js/acp":"0.3.2","@agents-js/policy":"0.3.2","@agentclientprotocol/sdk":"0.21.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/acp-host_0.3.2_1778372123935_0.49057395789439306","host":"s3://npm-registry-packages-npm-production"}},"0.4.0":{"name":"@agents-js/acp-host","version":"0.4.0","keywords":["acp","agent-client-protocol","host","session","permissions"],"author":{"name":"Jens Bodal"},"license":"MIT","_id":"@agents-js/acp-host@0.4.0","maintainers":[{"name":"jensbodal_dev","email":"jensbodal@gmail.com"}],"homepage":"https://agents-js.bodal.dev/","bugs":{"url":"https://github.com/jensbodal/agents-js/issues"},"dist":{"shasum":"e814aefd9c449240e318853a3c5271e1d889b0ce","tarball":"https://registry.npmjs.org/@agents-js/acp-host/-/acp-host-0.4.0.tgz","fileCount":79,"integrity":"sha512-AvNU5i0oT8p3cTa3tcwJaAbUBSBSW5ydnP2d069t9MWGwGPjEbz/dEjh5dDp9l67w14EKHjvmZc2B6Ru4HsHrg==","signatures":[{"sig":"MEUCIBJGav8bTf8Qg1S9wYl+z8kPee2M0q/mloGHHqESRTJiAiEA6lsrUXq8eiNMSsJdhya/yY2GP3Gy2oSLDrnQv7/itsQ=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@agents-js%2facp-host@0.4.0","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":570735},"main":"dist/index.mjs","type":"module","_from":"file:/tmp/agents-js-publish-acp-host-vTW93i/agents-js-acp-host-0.4.0.tgz","types":"dist/index.d.mts","engines":{"bun":">=1.3.11","node":">=20.19.0"},"exports":{".":{"bun":"./src/index.ts","types":"./dist/index.d.mts","import":"./dist/index.mjs","browser":"./dist/browser.mjs","default":"./dist/index.mjs"},"./editor":{"bun":"./src/editor/index.ts","types":"./dist/editor/index.d.mts","import":"./dist/editor/index.mjs","browser":"./dist/editor/browser.mjs","default":"./dist/editor/index.mjs"},"./testing":{"bun":"./src/testing.ts","types":"./dist/testing.d.mts","import":"./dist/testing.mjs","default":"./dist/testing.mjs"},"./session-restore":{"bun":"./src/session-restore.ts","types":"./dist/session-restore.d.mts","import":"./dist/session-restore.mjs","default":"./dist/session-restore.mjs"},"./workflow-surface":{"bun":"./src/workflow-surface.ts","types":"./dist/workflow-surface.d.mts","import":"./dist/workflow-surface.mjs","default":"./dist/workflow-surface.mjs"}},"scripts":{"test":"bun test tests","build":"bunx tsdown src/index.ts src/browser.ts src/testing.ts src/editor/index.ts src/editor/browser.ts src/session-restore.ts src/workflow-surface.ts --format esm --dts --out-dir dist --clean","prepack":"bun run build"},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:f64c8efa-9fe3-4e21-870b-09dbb8bc6a9f"}},"_resolved":"/tmp/agents-js-publish-acp-host-vTW93i/agents-js-acp-host-0.4.0.tgz","_integrity":"sha512-AvNU5i0oT8p3cTa3tcwJaAbUBSBSW5ydnP2d069t9MWGwGPjEbz/dEjh5dDp9l67w14EKHjvmZc2B6Ru4HsHrg==","repository":{"url":"git+https://github.com/jensbodal/agents-js.git","type":"git","directory":"packages/acp-host"},"_npmVersion":"11.12.1","description":"Stateful ACP host embedding surface. Manages agent sessions, terminal processes, permissions, and file I/O for host applications.","directories":{},"sideEffects":false,"_nodeVersion":"24.15.0","dependencies":{"@agents-js/acp":"0.4.0","@agents-js/policy":"0.4.0","@agentclientprotocol/sdk":"0.21.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/acp-host_0.4.0_1778531321532_0.6887407992688588","host":"s3://npm-registry-packages-npm-production"}},"0.5.0":{"name":"@agents-js/acp-host","version":"0.5.0","keywords":["acp","agent-client-protocol","host","session","permissions"],"author":{"name":"Jens Bodal"},"license":"MIT","_id":"@agents-js/acp-host@0.5.0","maintainers":[{"name":"jensbodal_dev","email":"jensbodal@gmail.com"}],"homepage":"https://agents-js.bodal.dev/","bugs":{"url":"https://github.com/jensbodal/agents-js/issues"},"dist":{"shasum":"a6c8a3421213d7ee1c8d38be76975c0636ef113a","tarball":"https://registry.npmjs.org/@agents-js/acp-host/-/acp-host-0.5.0.tgz","fileCount":79,"integrity":"sha512-Zuj5szd4VTtKEdhK4dxRDDRTdVcpqemSdAF0q06VMVrRPcjM5iik1QXhTlrSCMPv19AgFMv/T4zPB2cpnIJ/mw==","signatures":[{"sig":"MEQCIFXXSSAMDcpWsalQuslRKKd6oUbktFp/dwp4O865B75oAiByXLkkVD7V3BoANAowEvJfavV7GDu/b1o7QsacrStwwg==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@agents-js%2facp-host@0.5.0","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":587224},"main":"dist/index.mjs","type":"module","_from":"file:/tmp/agents-js-publish-acp-host-5AxYEF/agents-js-acp-host-0.5.0.tgz","types":"dist/index.d.mts","engines":{"bun":">=1.3.11","node":">=20.19.0"},"exports":{".":{"bun":"./src/index.ts","types":"./dist/index.d.mts","import":"./dist/index.mjs","browser":"./dist/browser.mjs","default":"./dist/index.mjs"},"./editor":{"bun":"./src/editor/index.ts","types":"./dist/editor/index.d.mts","import":"./dist/editor/index.mjs","browser":"./dist/editor/browser.mjs","default":"./dist/editor/index.mjs"},"./testing":{"bun":"./src/testing.ts","types":"./dist/testing.d.mts","import":"./dist/testing.mjs","default":"./dist/testing.mjs"},"./session-restore":{"bun":"./src/session-restore.ts","types":"./dist/session-restore.d.mts","import":"./dist/session-restore.mjs","default":"./dist/session-restore.mjs"},"./workflow-surface":{"bun":"./src/workflow-surface.ts","types":"./dist/workflow-surface.d.mts","import":"./dist/workflow-surface.mjs","default":"./dist/workflow-surface.mjs"}},"scripts":{"test":"bun test tests","build":"bunx tsdown src/index.ts src/browser.ts src/testing.ts src/editor/index.ts src/editor/browser.ts src/session-restore.ts src/workflow-surface.ts --format esm --dts --out-dir dist --clean","prepack":"bun run build"},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:f64c8efa-9fe3-4e21-870b-09dbb8bc6a9f"}},"_resolved":"/tmp/agents-js-publish-acp-host-5AxYEF/agents-js-acp-host-0.5.0.tgz","_integrity":"sha512-Zuj5szd4VTtKEdhK4dxRDDRTdVcpqemSdAF0q06VMVrRPcjM5iik1QXhTlrSCMPv19AgFMv/T4zPB2cpnIJ/mw==","repository":{"url":"git+https://github.com/jensbodal/agents-js.git","type":"git","directory":"packages/acp-host"},"_npmVersion":"11.12.1","description":"Stateful ACP host embedding surface. Manages agent sessions, terminal processes, permissions, and file I/O for host applications.","directories":{},"sideEffects":false,"_nodeVersion":"24.15.0","dependencies":{"@agents-js/acp":"0.5.0","@agents-js/policy":"0.5.0","@agentclientprotocol/sdk":"0.21.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/acp-host_0.5.0_1779063606195_0.8651809855835901","host":"s3://npm-registry-packages-npm-production"}},"0.5.1":{"name":"@agents-js/acp-host","version":"0.5.1","type":"module","sideEffects":false,"description":"Stateful ACP host embedding surface. Manages agent sessions, terminal processes, permissions, and file I/O for host applications.","author":{"name":"Jens Bodal"},"license":"MIT","repository":{"type":"git","url":"git+https://github.com/jensbodal/agents-js.git","directory":"packages/acp-host"},"homepage":"https://agents-js.bodal.dev/","bugs":{"url":"https://github.com/jensbodal/agents-js/issues"},"keywords":["acp","agent-client-protocol","host","session","permissions"],"engines":{"node":">=20.19.0","bun":">=1.3.11"},"main":"dist/index.mjs","types":"dist/index.d.mts","exports":{".":{"types":"./dist/index.d.mts","browser":"./dist/browser.mjs","bun":"./src/index.ts","import":"./dist/index.mjs","default":"./dist/index.mjs"},"./testing":{"types":"./dist/testing.d.mts","bun":"./src/testing.ts","import":"./dist/testing.mjs","default":"./dist/testing.mjs"},"./editor":{"types":"./dist/editor/index.d.mts","browser":"./dist/editor/browser.mjs","bun":"./src/editor/index.ts","import":"./dist/editor/index.mjs","default":"./dist/editor/index.mjs"},"./session-restore":{"types":"./dist/session-restore.d.mts","bun":"./src/session-restore.ts","import":"./dist/session-restore.mjs","default":"./dist/session-restore.mjs"},"./workflow-surface":{"types":"./dist/workflow-surface.d.mts","bun":"./src/workflow-surface.ts","import":"./dist/workflow-surface.mjs","default":"./dist/workflow-surface.mjs"}},"scripts":{"build":"bunx tsdown src/index.ts src/browser.ts src/testing.ts src/editor/index.ts src/editor/browser.ts src/session-restore.ts src/workflow-surface.ts --format esm --dts --out-dir dist --clean","prepack":"bun run build","test":"bun test tests"},"dependencies":{"@agentclientprotocol/sdk":"0.21.0","@agents-js/acp":"0.5.1","@agents-js/policy":"0.5.1"},"publishConfig":{"access":"public"},"_id":"@agents-js/acp-host@0.5.1","_integrity":"sha512-lmltVLy6xPJTgjZSYdsPdvWjJqcHdj/9zKl+9nKdrCsshB00MjdMybynMQeMsoJoqTu9AsLKTBI0Q9zljKLiRA==","_resolved":"/tmp/agents-js-publish-acp-host-GdnIRL/agents-js-acp-host-0.5.1.tgz","_from":"file:/tmp/agents-js-publish-acp-host-GdnIRL/agents-js-acp-host-0.5.1.tgz","_nodeVersion":"24.15.0","_npmVersion":"11.12.1","dist":{"integrity":"sha512-lmltVLy6xPJTgjZSYdsPdvWjJqcHdj/9zKl+9nKdrCsshB00MjdMybynMQeMsoJoqTu9AsLKTBI0Q9zljKLiRA==","shasum":"ab17e24a79717d00f5aaf9e982ac0cb2be21a0fb","tarball":"https://registry.npmjs.org/@agents-js/acp-host/-/acp-host-0.5.1.tgz","fileCount":79,"unpackedSize":587224,"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@agents-js%2facp-host@0.5.1","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEQCIFtlAuxNKN+Z4GuZE33EKDKlqGewawF4YkP2E6xqBjCtAiATby8yjNOu8CMfZ+9mjNUjXk+guNjJT3meotvMVHb+zg=="}]},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:f64c8efa-9fe3-4e21-870b-09dbb8bc6a9f"}},"directories":{},"maintainers":[{"name":"jensbodal_dev","email":"jensbodal@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/acp-host_0.5.1_1779076411891_0.6805467744860034"},"_hasShrinkwrap":false}},"time":{"created":"2026-05-09T06:46:26.170Z","modified":"2026-05-18T03:53:32.315Z","0.2.0":"2026-05-09T06:46:26.492Z","0.2.1":"2026-05-09T15:05:34.336Z","0.2.2":"2026-05-09T16:20:41.919Z","0.3.0":"2026-05-09T18:28:11.567Z","0.3.1-rc1":"2026-05-09T19:34:50.124Z","0.3.1":"2026-05-09T20:03:32.727Z","0.3.2":"2026-05-10T00:15:24.103Z","0.4.0":"2026-05-11T20:28:41.745Z","0.5.0":"2026-05-18T00:20:06.388Z","0.5.1":"2026-05-18T03:53:32.017Z"},"bugs":{"url":"https://github.com/jensbodal/agents-js/issues"},"author":{"name":"Jens Bodal"},"license":"MIT","homepage":"https://agents-js.bodal.dev/","keywords":["acp","agent-client-protocol","host","session","permissions"],"repository":{"type":"git","url":"git+https://github.com/jensbodal/agents-js.git","directory":"packages/acp-host"},"description":"Stateful ACP host embedding surface. Manages agent sessions, terminal processes, permissions, and file I/O for host applications.","maintainers":[{"name":"jensbodal_dev","email":"jensbodal@gmail.com"}],"readme":"# @agents-js/acp-host\n\n> Stateful ACP host embedding surface. Manages agent sessions, terminal processes, permissions, and file I/O for host applications.\n\n## Installation\n\n```sh\nbun add @agents-js/acp-host\n```\n\n## API\n\n<!-- Auto-generated from JSDoc -->\n\n### Classes\n\n- **`ACPSessionController`** — High-level session orchestrator for ACP agent communication. This is the top-level **Provider** for host applications. It composes an {ACPClientController} with host-level concerns: permission eval...\n- **`AcpStreamingTranslator`** — Stateful per-session translator. Instantiate one per ACP session. The translator does no I/O and holds no transport handles — it's a pure data transformer with private accumulator state. Tests shou...\n- **`CapabilityCache`** — Parses and caches agent capabilities from InitializeResponse. Provides boolean helpers for capability-gating UI and behavior. \"Advertised\" flags reflect what the CLIENT advertises to the agent. The...\n- **`EvalTransport`** — `LogTransport` that captures per-prompt evaluation records (prompt content, response, stop reason, errors) for offline regression suites.\n- **`Logger`** — Structured console logger with category prefixes. Provides debug visibility for session lifecycle, permissions, and errors. All log calls are also pushed to the global logStore for the debug panel.\n- **`PermissionEngine`**\n- **`PermissionStore`** — Persistence layer for permission rules. Session-scoped rules are held in memory. Persistent rules are saved via a host-provided callback.\n- **`SpanLogTransport`** — `LogTransport` that buckets entries into spans keyed by `entry.spanId`, tracking active and completed spans for the debug panel and trace export.\n- **`TerminalManager`**\n\n### Functions\n\n- **`applyAgentDefaults`**\n- **`atomicWrite`** — Atomic CAS write: stages content to a temp file, verifies the target is unchanged since the last read, then renames the staging file into place. If `snapshot` is null (file was never read, or is a ...\n- **`buildCompletedTurnSnapshot`**\n- **`buildControllerAdapters`** — Build the `ACPHostAdapters` config object for `ACPClientController`. Wires each adapter closure to the session controller's internal handlers without exposing the full controller instance.\n- **`buildForbiddenEnvKeys`** — Compute the set of env-var keys that callers must not override via agent `extraEnv`. The result is the union of {SYSTEM_FORBIDDEN_ENV_KEYS}, the policy's `agentSecretEnvKeys`, and the policy's `for...\n- **`buildInlineContext`** — Builds inline text with file content embedded in a fenced code block.\n- **`buildMcpServersList`** — Build the list of MCP servers to pass when creating or loading a session.\n- **`buildMinimalEnv`**\n- **`callHook`** — Safely invoke a session hook function. If the hook throws, the error is logged and `undefined` is returned.\n- **`cancelPendingElicitation`** — Cancel a pending elicitation request by resolving it with \"cancel\" action. Emits an `elicitation_resolved` event if there was a pending request.\n- **`cancelPendingPermission`** — Cancel a pending permission request by resolving it as \"cancelled\". Emits a `permission_resolved` event if there was a pending request.\n- **`cancelPendingWriteGate`** — Cancel a pending write-gate request by resolving it as \"reject\". Emits a `write_gate_resolved` event if there was a pending gate.\n- **`captureReadSnapshot`** — Capture a snapshot of a file for later CAS comparison. - Absolute path to the file (already resolved). A snapshot containing the content hash and mtime.\n- **`cleanupStagingDir`** — Remove a session's staging directory. - Absolute path to the staging directory to remove.\n- **`clearCancelSafetyTimer`** — Clear the cancel safety timer, if active. Returns `null` so the caller can assign back: `this.timer = clearCancelSafetyTimer(this.timer)`.\n- **`clonePlanEntries`**\n- **`clonePromptContent`**\n- **`cloneTurnItems`**\n- **`collectToolCallStats`**\n- **`configureLogging`**\n- **`createCrashableAgent`** — Creates a mock agent whose transport can be aborted mid-session. Useful for host crash/recovery tests that need a hard stream failure.\n- **`createEchoAgent`**\n- **`createFallbackModes`**\n- **`createHangingAgent`**\n- **`createHostACPProcess`**\n- **`createInitialState`**\n- **`createMockAgent`**\n- **`createNodeFileAdapters`** — Creates {HostFileAdapters} that use Node.js `fs` APIs for file I/O. Relative paths resolve against the session cwd. Reads and writes are then enforced against the normalized read/write/scratch root...\n- **`createOpencodeDefaultAgentRecoveredConfig`**\n- **`createTerminalHandlers`** — Create a scoped set of terminal handlers backed by a dedicated TerminalManager. Each ACPSessionController should call this once and own the returned handlers.\n- **`createTurnState`**\n- **`deriveActivitySurface`**\n- **`deriveComposerSurface`**\n- **`deriveInterruptSurface`**\n- **`derivePlanSurface`**\n- **`deriveTerminalEntries`**\n- **`deriveTranscriptSurface`**\n- **`deriveWorkflowSurfaceState`**\n- **`describeElicitationTarget`**\n- **`describeQueuedFollowUpBoundary`**\n- **`describeRunningTools`**\n- **`describeWorkflowError`**\n- **`detectFrontmatterOnlyWrite`**\n- **`emitEvent`** — Emit an event to all registered listeners. Individual listener errors are caught and logged so one bad listener does not break others.\n- **`emptyToolCallStats`**\n- **`ensureStagingDir`** — Create the staging directory for a session under the configured scratch root. Idempotent -- safe to call multiple times. - Absolute path to the scratch root (for example `<workspace>/.tmp`). - Sess...\n- **`evaluatePermission`** — Full permission evaluation pipeline: 1. beforePermission hook (fail-closed) 2. YOLO mode auto-approve 3. Read-only auto-approve 4. Remembered rules 5. Fall through to user prompt\n- **`filterFiles`** — Filters open files by a query string (fuzzy match against name and basename).\n- **`formatToolCallStatus`**\n- **`getHostManagedPermissionReason`**\n- **`getMentionAtCursor`** — Finds the mention token being typed at the cursor position in a textarea. Returns the query text after `@` (empty string if the user just typed `@`), or `null` if the cursor is not currently inside...\n- **`getPromptQueueCount`**\n- **`getToolCallById`**\n- **`getToolCalls`**\n- **`getTrailingToolBlockStats`**\n- **`getValidMessageId`**\n- **`handleSessionUpdate`** — Process a session notification and update state accordingly. Returns nothing -- all mutations happen on the `state` parameter.\n- **`isOpencodeDefaultAgentMissing`**\n- **`isSessionRestoreFailureMessage`**\n- **`isWithinAnyWorkspaceRoot`**\n- **`logPermissionDecision`** — Log a structured permission decision.\n- **`mapToolCallContent`**\n- **`mapToolCallStatus`**\n- **`normalizeAgentName`**\n- **`normalizeSessionModes`**\n- **`parseMentions`** — Extracts mention tokens from text. Only matches tokens like `.md` at word boundaries (after whitespace, start of line, or after newline).\n- **`requestWriteGateApproval`** — Determine whether a write should be auto-approved or requires a UI modal. Returns a resolved `Promise<boolean>` for auto-approved writes, or creates a pending write gate on `state` and emits the re...\n- **`resetLogging`**\n- **`resolveHostEnvPolicy`**\n- **`resolveMentions`** — Resolves mention tokens to open file paths.\n- **`resolveWorkflowCopy`** — Resolve a full copy map from optional partial overrides. Missing keys fall back to the default English copy.\n- **`resolveWorkspaceContext`**\n- **`resolveWorkspaceFilePath`**\n- **`sandboxHomePath`** — Compute the deterministic sandbox HOME directory for a given workspace identity root. The hash ensures each logical workspace gets its own isolated HOME without collisions.\n- **`snapshotToolCalls`**\n- **`splitMarkdownFrontmatter`**\n- **`summarizeToolGroup`**\n- **`toWorkspaceDisplayPath`**\n- **`trySetAgentMode`**\n- **`waitForReady`** — Returns a promise that resolves when the session status becomes \"ready\", or rejects after the given timeout.\n\n### Interfaces\n\n- **`ACPSessionState`**\n- **`AcpStreamingSink`** — Sink contract: consumers implement these methods to receive translated streaming events. Methods are invoked synchronously; the sink owns any downstream async dispatch (e.g. publishing on an event ...\n- **`ActivitySurfaceState`**\n- **`AgentConfig`**\n- **`ApplyDefaultsResult`**\n- **`AvailableCommandsUpdateCall`** — Argument shape for `AcpStreamingSink.onAvailableCommandsUpdate`. Carries the FULL set of commands available from the harness via the SDK's typed `AvailableCommand` shape (preserves description, inp...\n- **`BuildMinimalEnvInput`**\n- **`CodeDescriptor`** — A code block with language annotation\n- **`CompletedToolCallSnapshot`**\n- **`CompletedTurnSnapshot`**\n- **`ComponentDescriptor`** — An escape hatch for host-specific components\n- **`ComposerSurfaceState`**\n- **`ControllerAdapterContext`**\n- **`CreateTerminalHandlersOptions`**\n- **`DependencyRegistry`** — Registry for querying host-provided integrations and capabilities at runtime. This is an **Adapter** interface that host platforms can implement to advertise available services (MCP servers, extern...\n- **`DiffDescriptor`** — A file diff\n- **`DirectoryPolicy`** — Directory policy: what the agent is ALLOWED to read, write, and stage to, plus the auto-approved write zones that bypass the write-gate modal. This is intentionally separate from {WorkspaceContextC...\n- **`EvalRecord`**\n- **`FileSnapshot`** — Snapshot of a file's content hash and modification time, captured after a read for later CAS comparison.\n- **`FormDescriptor`** — A form rendered inline (not as a modal) — for read-only display of elicitation results\n- **`HostACPProcessOptions`** — Host-specific process spawn options, extending the low-level `ACPProcessOptions` from `-js/acp` with fields that only `createHostACPProcess` (in this package) interprets. `workspaceFlag` lived on `...\n- **`HostElicitationAdapter`** — Optional elicitation adapter that the host platform can provide to handle agent elicitation requests (e.g., form-based user input). If omitted, the session controller manages elicitation state inte...\n- **`HostEnvPolicyInput`** — Caller-supplied environment-variable policy. `acp-host` cannot know which env vars are credentials for a given harness; embedders with that knowledge populate this shape so the spawn-env builder fo...\n- **`HostFileAdapters`** — File I/O adapters that the host platform must implement. The writeTextFile adapter receives a `requestApproval` callback for write-gate approval flows.\n- **`HostSessionStorageAdapter`** — Optional session storage adapter for persisting session state across backend restarts. Required for seamless transcript reloading if the host process crashes or restarts.\n- **`IntegrationStatus`**\n- **`InterruptActionState`**\n- **`InterruptSurfaceState`**\n- **`JsonRpcError`**\n- **`JsonRpcRequest`** — MCP protocol types for the local workspace MCP server. Covers JSON-RPC 2.0 request/response shapes and MCP tool definitions needed for the HTTP transport. These are intentionally minimal -- only wh...\n- **`JsonRpcResponse`**\n- **`LogEntry`**\n- **`LoggerConfig`**\n- **`LogTransport`** — Sink for structured log entries. Implementors handle each `LogEntry` synchronously (any async work must be self-managed) and decide where it goes — console, span buffer, eval transport, or a host-s...\n- **`ManagedTerminal`**\n- **`McpInitializeResult`**\n- **`McpPropertySchema`**\n- **`McpToolCallParams`**\n- **`McpToolCallResult`**\n- **`McpToolContent`**\n- **`McpToolDefinition`**\n- **`McpToolInputSchema`**\n- **`McpToolsListResult`**\n- **`ModeChangeCall`** — Argument shape for `AcpStreamingSink.onModeChange`. ACP `current_mode_update` notifications only carry `currentModeId` (the available-modes list lives in initial session metadata, not on transition...\n- **`ModeSyncResult`**\n- **`NodeFileAdapterOptions`**\n- **`NormalizedAgentName`**\n- **`PendingElicitation`**\n- **`PendingPermission`**\n- **`PendingWriteGate`**\n- **`PermissionDecision`**\n- **`PermissionEvaluationContext`**\n- **`PlanEntryInfo`**\n- **`PlanSurfaceState`**\n- **`PlanUpdateCall`** — Argument shape for `AcpStreamingSink.onPlanUpdate`. ACP `plan` notifications always carry the FULL set of entries — consumers replace plan state wholesale on receipt. Entries reuse the SDK's typed ...\n- **`ProcessExitInfo`** — Exit info surfaced from `ACPSessionController.onProcessExit` listeners. The `crash` boolean reflects INTENT, not exit code: - `crash: false` ← gateway called `destroy()` first (operator-initiated t...\n- **`RenderHint`** — Metadata hint that can be attached to ACP session_update _meta fields to suggest structured rendering for tool call outputs.\n- **`ResolvedHostEnvPolicy`** — Resolved view of {HostEnvPolicyInput} with defaults applied.\n- **`ResolvedWorkspaceContext`**\n- **`SessionHooks`**\n- **`SessionInfoUpdateCall`** — Argument shape for `AcpStreamingSink.onSessionInfoUpdate`. Mirrors ACP `SessionInfoUpdate` (title + updatedAt). Both fields are `string | null | undefined` per the SDK: `null` is an explicit clear ...\n- **`SessionUpdateContentHandlerHooks`**\n- **`Span`**\n- **`StartConfig`** — Configuration for starting an ACP session controller. Replaces the old positional parameters with a structured config object.\n- **`TerminalDescriptor`** — Terminal output\n- **`TerminalHandlers`**\n- **`TerminalManagerOptions`**\n- **`TerminalWorkspaceContext`**\n- **`TextDeltaCall`** — Argument shape for `AcpStreamingSink.onTextDelta` and `onThoughtDelta`. Both `delta` (incremental text added by this chunk) and `cumulativeText` (running total per `messageId`) are surfaced so sink...\n- **`TextDescriptor`** — A text block rendered as markdown\n- **`ToolBlockSurfaceState`**\n- **`ToolCallContentHandler`**\n- **`ToolCallContentHandlerContext`**\n- **`ToolCallContentInfo`** — Flattened ACP `ToolCallContent` representation. The SDK's `ToolCallContent` is a discriminated union of three nested shapes (`content`, `diff`, `terminal`); this type pulls the relevant fields up s...\n- **`ToolCallInfo`**\n- **`ToolCallStartCall`** — Argument shape for `AcpStreamingSink.onToolCallStart`.\n- **`ToolCallSummary`**\n- **`ToolCallUpdateCall`** — Argument shape for `AcpStreamingSink.onToolCallUpdate`. Mirrors the ACP `ToolCallUpdate` shape with three-state semantics for `content` / `locations`: `undefined` = no change, `null` = explicit cle...\n- **`TranscriptSurfaceState`**\n- **`TurnState`**\n- **`UsageUpdateCall`** — Argument shape for `AcpStreamingSink.onUsageUpdate`.\n- **`WorkflowActivityEntryState`**\n- **`WorkflowCopyMap`** — Type-safe interface for all workflow surface UI copy strings. Consumers may supply a partial override to customize any subset of strings.\n- **`WorkflowErrorSummary`**\n- **`WorkflowPendingPermissionLike`**\n- **`WorkflowPendingWriteGateLike`**\n- **`WorkflowPlanEntryState`**\n- **`WorkflowSessionStateLike`**\n- **`WorkflowStatusOverride`**\n- **`WorkflowSurfaceContext`**\n- **`WorkflowSurfaceState`**\n- **`WorkflowToolCallLike`**\n- **`WorkflowToolCallStats`**\n- **`WorkflowToolGroupSummary`**\n- **`WorkflowTurnStateLike`**\n- **`WorkspaceContext`**\n- **`WorkspaceContextConfig`**\n- **`WorkspaceContextProvider`**\n\n### Types\n\n- **`ACPSessionEvent`**\n- **`ACPSessionStatus`**\n- **`AgentScenario`**\n- **`ElicitationScenario`**\n- **`FrontmatterWriteTarget`** — Browser-safe entry point for -js/acp-host/editor. The mention-parser helpers and the frontmatter-only-write detector are pure framework-agnostic TypeScript functions with no Node-specific runtime d...\n- **`Listener`**\n- **`LogCategory`**\n- **`LogLevel`**\n- **`ModeFallbackReason`**\n- **`OpenFileEntry`**\n- **`PermissionLifetime`**\n- **`PermissionMode`** — Permission mode controlling the host's auto-approve/prompt strategy.\n- **`PromptScenario`**\n- **`ReadonlySpan`**\n- **`RenderDescriptor`** — Discriminated union of all render descriptor types\n- **`SessionInfo`**\n- **`TurnItem`** — Ordered item in a turn -- preserves interleaving of text and tool calls\n- **`WorkflowActivityKind`**\n- **`WorkflowActivityPhase`**\n- **`WorkflowActivityStatus`**\n- **`WorkflowComposerMode`**\n- **`WorkflowInterruptBlocker`**\n- **`WorkflowSurfaceSeverity`**\n- **`WriteGateResolution`** — Resolution returned by the write-gate modal UI.\n\n### Constants\n\n- **`DEFAULT_AGENT_CONFIG`**\n- **`DEFAULT_INHERITED_ENV_KEYS`** — Default non-secret keys inherited from the host environment into the spawned agent process. Hosts can override the inherited set via {HostEnvPolicyInput.inheritedEnvKeys}; secret credentials (provi...\n- **`DEFAULT_TERMINAL_ENV_KEYS`** — Default subset of {DEFAULT_INHERITED_ENV_KEYS} forwarded to terminal processes. SHELL is excluded because terminals spawn with `shell: false` (direct argv invocation), so the SHELL variable would b...\n- **`defaultWorkflowCopy`** — Default English copy map used when no overrides are provided.\n- **`DEV_AGENT_CONFIG`**\n- **`JSON_RPC_INTERNAL_ERROR`**\n- **`JSON_RPC_INVALID_PARAMS`**\n- **`JSON_RPC_INVALID_REQUEST`**\n- **`JSON_RPC_METHOD_NOT_FOUND`**\n- **`JSON_RPC_PARSE_ERROR`**\n- **`logStore`** — Singleton log store instance.\n- **`SESSION_RESTORE_FAILURE_MESSAGE`**\n- **`SYSTEM_FORBIDDEN_ENV_KEYS`** — System/loader keys that agent config (`extraEnv`) must never override. These guards apply regardless of the harness or caller-supplied policy because they protect the spawned process's loader contr...\n\n### Exports\n\n- **`type BuildMinimalEnvInput`**\n- **`type NormalizedAgentName`**\n\n\n## Dependencies\n\n- `@agentclientprotocol/sdk`\n- `@agents-js/acp`\n- `@agents-js/policy`\n\n## License\n\nMIT\n\n<!-- AUTO-GENERATED by scripts/generate-package-readmes.ts — do not edit -->\n","readmeFilename":"README.md"}