@zooid/runtime-local 0.7.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Zooid contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/index.d.ts

@@ -0,0 +1,12 @@
+import { ChildProcess } from 'node:child_process';
+import { AcpRuntime, AcpSpawnSpec } from '@zooid/core';
+
+/**
+ * LocalAcpRuntime spawns the ACP shim process directly on the host. No
+ * container, no isolation. `image` and `mounts` on the spec are ignored.
+ */
+declare class LocalAcpRuntime implements AcpRuntime {
+    spawn(spec: AcpSpawnSpec): ChildProcess;
+}
+
+export { LocalAcpRuntime };

package/dist/index.js

@@ -0,0 +1,15 @@
+// src/local-acp.ts
+import { spawn } from "child_process";
+var LocalAcpRuntime = class {
+  spawn(spec) {
+    return spawn(spec.command, spec.args, {
+      stdio: ["pipe", "pipe", "pipe"],
+      env: { ...process.env, ...spec.env ?? {} },
+      cwd: spec.cwd
+    });
+  }
+};
+export {
+  LocalAcpRuntime
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/local-acp.ts"],"sourcesContent":["import { spawn, type ChildProcess } from 'node:child_process'\nimport type { AcpRuntime, AcpSpawnSpec } from '@zooid/core'\n\n/**\n * LocalAcpRuntime spawns the ACP shim process directly on the host. No\n * container, no isolation. `image` and `mounts` on the spec are ignored.\n */\nexport class LocalAcpRuntime implements AcpRuntime {\n  spawn(spec: AcpSpawnSpec): ChildProcess {\n    return spawn(spec.command, spec.args, {\n      stdio: ['pipe', 'pipe', 'pipe'],\n      env: { ...process.env, ...(spec.env ?? {}) },\n      cwd: spec.cwd,\n    })\n  }\n}\n"],"mappings":";AAAA,SAAS,aAAgC;AAOlC,IAAM,kBAAN,MAA4C;AAAA,EACjD,MAAM,MAAkC;AACtC,WAAO,MAAM,KAAK,SAAS,KAAK,MAAM;AAAA,MACpC,OAAO,CAAC,QAAQ,QAAQ,MAAM;AAAA,MAC9B,KAAK,EAAE,GAAG,QAAQ,KAAK,GAAI,KAAK,OAAO,CAAC,EAAG;AAAA,MAC3C,KAAK,KAAK;AAAA,IACZ,CAAC;AAAA,EACH;AACF;","names":[]}

package/package.json

@@ -0,0 +1,43 @@
+{
+  "name": "@zooid/runtime-local",
+  "version": "0.7.0",
+  "description": "Local (host machine) runtime for zooid. Spawns the agent CLI directly via node:child_process.",
+  "type": "module",
+  "license": "MIT",
+  "main": "./src/index.ts",
+  "types": "./src/index.ts",
+  "exports": {
+    ".": {
+      "types": "./src/index.ts",
+      "import": "./src/index.ts"
+    }
+  },
+  "files": [
+    "dist",
+    "src",
+    "README.md"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "node": ">=22"
+  },
+  "dependencies": {
+    "@zooid/core": "^0.7.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "tsup": "^8.5.1",
+    "tsx": "^4.21.0",
+    "typescript": "^5.5.0",
+    "vitest": "^3.2.0",
+    "@zooid/acp-client": "^0.7.0"
+  },
+  "scripts": {
+    "build": "tsup",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "typecheck": "tsc --noEmit"
+  }
+}

package/src/index.ts

@@ -0,0 +1 @@
+export { LocalAcpRuntime } from './local-acp.js'

package/src/local-acp.test.ts

@@ -0,0 +1,83 @@
+import { describe, it, expect, vi, beforeEach, afterEach } from 'vitest'
+import { EventEmitter } from 'node:events'
+import { Readable, Writable } from 'node:stream'
+
+const spawnMock = vi.fn()
+
+vi.mock('node:child_process', () => ({
+  spawn: spawnMock,
+}))
+
+const { LocalAcpRuntime } = await import('./local-acp.js')
+
+class FakeChild extends EventEmitter {
+  stdout = new Readable({ read() {} })
+  stdin = new Writable({ write(_c, _e, cb) { cb() } })
+  stderr = new Readable({ read() {} })
+  pid = 1
+  kill = vi.fn(() => true)
+}
+
+describe('LocalAcpRuntime', () => {
+  beforeEach(() => {
+    spawnMock.mockReset()
+    spawnMock.mockReturnValue(new FakeChild())
+  })
+  afterEach(() => {
+    vi.restoreAllMocks()
+  })
+
+  it('spawns command + args verbatim with piped stdio', () => {
+    const rt = new LocalAcpRuntime()
+    rt.spawn({ command: 'opencode', args: ['acp'] })
+    expect(spawnMock).toHaveBeenCalledTimes(1)
+    const [cmd, args, options] = spawnMock.mock.calls[0]
+    expect(cmd).toBe('opencode')
+    expect(args).toEqual(['acp'])
+    expect(options.stdio).toEqual(['pipe', 'pipe', 'pipe'])
+  })
+
+  it('forwards cwd', () => {
+    const rt = new LocalAcpRuntime()
+    rt.spawn({ command: 'x', args: [], cwd: '/workspace' })
+    expect(spawnMock.mock.calls[0][2].cwd).toBe('/workspace')
+  })
+
+  it('merges process.env first, spec.env wins', () => {
+    process.env.FROM_PARENT = 'yes'
+    process.env.OVERRIDE_ME = 'parent'
+    const rt = new LocalAcpRuntime()
+    rt.spawn({
+      command: 'x',
+      args: [],
+      env: { OVERRIDE_ME: 'spec', EXTRA: '1' },
+    })
+    const env = spawnMock.mock.calls[0][2].env
+    expect(env.FROM_PARENT).toBe('yes')
+    expect(env.OVERRIDE_ME).toBe('spec')
+    expect(env.EXTRA).toBe('1')
+    delete process.env.FROM_PARENT
+    delete process.env.OVERRIDE_ME
+  })
+
+  it('ignores image and mounts on the spec (host runtime has no container)', () => {
+    const rt = new LocalAcpRuntime()
+    rt.spawn({
+      command: 'x',
+      args: [],
+      image: 'should-be-ignored',
+      mounts: [{ path: '/h', target: '/c', mode: 'ro' }],
+    })
+    const [cmd, args] = spawnMock.mock.calls[0]
+    expect(cmd).toBe('x')
+    expect(args).toEqual([])
+  })
+
+  it('returns the ChildProcess from spawn', () => {
+    const child = new FakeChild()
+    spawnMock.mockReturnValue(child)
+    const rt = new LocalAcpRuntime()
+    const result = rt.spawn({ command: 'x', args: [] })
+    expect(result).toBe(child)
+  })
+})

package/src/local-acp.ts

@@ -0,0 +1,16 @@
+import { spawn, type ChildProcess } from 'node:child_process'
+import type { AcpRuntime, AcpSpawnSpec } from '@zooid/core'
+
+/**
+ * LocalAcpRuntime spawns the ACP shim process directly on the host. No
+ * container, no isolation. `image` and `mounts` on the spec are ignored.
+ */
+export class LocalAcpRuntime implements AcpRuntime {
+  spawn(spec: AcpSpawnSpec): ChildProcess {
+    return spawn(spec.command, spec.args, {
+      stdio: ['pipe', 'pipe', 'pipe'],
+      env: { ...process.env, ...(spec.env ?? {}) },
+      cwd: spec.cwd,
+    })
+  }
+}