@cleocode/cleo-os 2026.4.99 → 2026.4.101

package/dist/harnesses/index.d.ts

@@ -0,0 +1,62 @@
+/**
+ * cleo-os Harness Registry.
+ *
+ * Centralises construction and lookup of {@link HarnessAdapter} implementations
+ * available in cleo-os. Adding a new harness means:
+ *
+ * 1. Implement {@link HarnessAdapter} in a subdirectory under `harnesses/`.
+ * 2. Add an entry to {@link HARNESS_REGISTRY} below.
+ * 3. Export the adapter class from the subdirectory's `index.ts`.
+ *
+ * @packageDocumentation
+ */
+import type { HarnessAdapter } from './pi-coding-agent/types.js';
+/**
+ * Metadata entry for a registered harness adapter.
+ *
+ * @public
+ */
+export interface HarnessRegistryEntry {
+    /** Short stable identifier matching {@link HarnessAdapter.id}. */
+    id: string;
+    /** Human-readable display name. */
+    name: string;
+    /** Factory function that creates a fresh adapter instance. */
+    create: () => HarnessAdapter;
+}
+/**
+ * Look up a harness adapter by ID.
+ *
+ * @param id - Harness adapter ID (e.g. `"pi-coding-agent"`).
+ * @returns The registry entry, or `undefined` when not found.
+ *
+ * @example
+ * ```typescript
+ * const entry = getHarnessEntry('pi-coding-agent');
+ * const adapter = entry?.create();
+ * ```
+ *
+ * @public
+ */
+export declare function getHarnessEntry(id: string): HarnessRegistryEntry | undefined;
+/**
+ * Create a fresh instance of the harness adapter with the given ID.
+ *
+ * @param id - Harness adapter ID.
+ * @returns A new {@link HarnessAdapter} instance, or `null` when the ID is
+ *   not registered.
+ *
+ * @public
+ */
+export declare function createHarness(id: string): HarnessAdapter | null;
+/**
+ * Return all registered harness adapter entries.
+ *
+ * @returns Array of all registry entries, in insertion order.
+ *
+ * @public
+ */
+export declare function listHarnesses(): HarnessRegistryEntry[];
+export { PiCodingAgentAdapter } from './pi-coding-agent/adapter.js';
+export type { HarnessAdapter } from './pi-coding-agent/types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/harnesses/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/harnesses/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAGH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAMjE;;;;GAIG;AACH,MAAM,WAAW,oBAAoB;IACnC,kEAAkE;IAClE,EAAE,EAAE,MAAM,CAAC;IACX,mCAAmC;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,8DAA8D;IAC9D,MAAM,EAAE,MAAM,cAAc,CAAC;CAC9B;AAsBD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,eAAe,CAAC,EAAE,EAAE,MAAM,GAAG,oBAAoB,GAAG,SAAS,CAE5E;AAED;;;;;;;;GAQG;AACH,wBAAgB,aAAa,CAAC,EAAE,EAAE,MAAM,GAAG,cAAc,GAAG,IAAI,CAE/D;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,IAAI,oBAAoB,EAAE,CAEtD;AAED,OAAO,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAC;AAEpE,YAAY,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC"}

package/dist/harnesses/index.js

@@ -0,0 +1,72 @@
+/**
+ * cleo-os Harness Registry.
+ *
+ * Centralises construction and lookup of {@link HarnessAdapter} implementations
+ * available in cleo-os. Adding a new harness means:
+ *
+ * 1. Implement {@link HarnessAdapter} in a subdirectory under `harnesses/`.
+ * 2. Add an entry to {@link HARNESS_REGISTRY} below.
+ * 3. Export the adapter class from the subdirectory's `index.ts`.
+ *
+ * @packageDocumentation
+ */
+import { PiCodingAgentAdapter } from './pi-coding-agent/adapter.js';
+/**
+ * All harness adapters registered with cleo-os.
+ *
+ * Keyed by the adapter's {@link HarnessAdapter.id}.
+ */
+const HARNESS_REGISTRY = new Map([
+    [
+        'pi-coding-agent',
+        {
+            id: 'pi-coding-agent',
+            name: 'Pi Coding Agent',
+            create: () => new PiCodingAgentAdapter(),
+        },
+    ],
+]);
+// ---------------------------------------------------------------------------
+// Public API
+// ---------------------------------------------------------------------------
+/**
+ * Look up a harness adapter by ID.
+ *
+ * @param id - Harness adapter ID (e.g. `"pi-coding-agent"`).
+ * @returns The registry entry, or `undefined` when not found.
+ *
+ * @example
+ * ```typescript
+ * const entry = getHarnessEntry('pi-coding-agent');
+ * const adapter = entry?.create();
+ * ```
+ *
+ * @public
+ */
+export function getHarnessEntry(id) {
+    return HARNESS_REGISTRY.get(id);
+}
+/**
+ * Create a fresh instance of the harness adapter with the given ID.
+ *
+ * @param id - Harness adapter ID.
+ * @returns A new {@link HarnessAdapter} instance, or `null` when the ID is
+ *   not registered.
+ *
+ * @public
+ */
+export function createHarness(id) {
+    return HARNESS_REGISTRY.get(id)?.create() ?? null;
+}
+/**
+ * Return all registered harness adapter entries.
+ *
+ * @returns Array of all registry entries, in insertion order.
+ *
+ * @public
+ */
+export function listHarnesses() {
+    return Array.from(HARNESS_REGISTRY.values());
+}
+export { PiCodingAgentAdapter } from './pi-coding-agent/adapter.js';
+//# sourceMappingURL=index.js.map

package/dist/harnesses/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/harnesses/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAC;AAqBpE;;;;GAIG;AACH,MAAM,gBAAgB,GAA8C,IAAI,GAAG,CAAC;IAC1E;QACE,iBAAiB;QACjB;YACE,EAAE,EAAE,iBAAiB;YACrB,IAAI,EAAE,iBAAiB;YACvB,MAAM,EAAE,GAAG,EAAE,CAAC,IAAI,oBAAoB,EAAE;SACzC;KACF;CACF,CAAC,CAAC;AAEH,8EAA8E;AAC9E,aAAa;AACb,8EAA8E;AAE9E;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,eAAe,CAAC,EAAU;IACxC,OAAO,gBAAgB,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;AAClC,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,aAAa,CAAC,EAAU;IACtC,OAAO,gBAAgB,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,MAAM,EAAE,IAAI,IAAI,CAAC;AACpD,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,aAAa;IAC3B,OAAO,KAAK,CAAC,IAAI,CAAC,gBAAgB,CAAC,MAAM,EAAE,CAAC,CAAC;AAC/C,CAAC;AAED,OAAO,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAC"}

package/dist/harnesses/pi-coding-agent/adapter.d.ts

@@ -0,0 +1,132 @@
+/**
+ * Pi Coding Agent Harness Adapter — cleo-os implementation.
+ *
+ * Implements the {@link HarnessAdapter} interface for the Pi coding agent CLI
+ * (`@mariozechner/pi-coding-agent`). Provides process spawn, status, kill,
+ * and output streaming for Pi processes launched by cleo-os.
+ *
+ * @remarks
+ * This adapter is the cleo-os counterpart to the CAAMP
+ * `PiSpawnProvider` in `packages/adapters/src/providers/pi/spawn.ts`.
+ * Where the CAAMP spawn provider is a detached fire-and-forget launcher,
+ * this adapter owns the full process lifecycle — attached stdin/stdout/stderr,
+ * bounded output buffering, and structured exit promises — so it can be
+ * used in orchestrated sandbox runs.
+ *
+ * Two launch modes are supported:
+ * - **Host-native** (default): Pi is invoked directly from PATH (or via
+ *   `CLEO_PI_BINARY`). This is the standard mode for local development.
+ * - **Docker sandbox** (opt-in): Pi is launched inside the
+ *   `cleo-sandbox/pi:local` Docker container when `CLEO_PI_SANDBOXED=1` is
+ *   set or `sandboxed: true` is passed to {@link PiCodingAgentAdapter.spawn}.
+ *   Falls back to host-native with a warning when Docker is unavailable.
+ *
+ * Instance IDs have the format `pi-<taskId>-<shortRandom>` to make
+ * correlation with task records straightforward.
+ *
+ * @see packages/adapters/src/providers/pi/spawn.ts — CAAMP spawn provider
+ * @see packages/cleo-os/src/harnesses/pi-coding-agent/pi-wrapper.ts — process management
+ * @see packages/cleo-os/src/harnesses/pi-coding-agent/docker-mode.ts — sandbox mode
+ * @task T922
+ * @epic T911
+ * @packageDocumentation
+ */
+import type { HarnessAdapter, HarnessOutputLine, HarnessProcessStatus, HarnessSpawnOptions, HarnessSpawnResult } from './types.js';
+/**
+ * Harness adapter for the Pi coding agent CLI in the cleo-os sandbox.
+ *
+ * Manages a pool of Pi processes, each identified by a stable instance ID.
+ * Supports host-native and Docker sandbox launch modes.
+ *
+ * @example
+ * ```typescript
+ * const adapter = new PiCodingAgentAdapter();
+ * const { instanceId, exitPromise } = await adapter.spawn('T123', 'Write a hello-world script');
+ * const status = await exitPromise;
+ * console.log('exit code:', status.exitCode);
+ * ```
+ *
+ * @public
+ */
+export declare class PiCodingAgentAdapter implements HarnessAdapter {
+    /** Short adapter identifier. */
+    readonly id = "pi-coding-agent";
+    /** Active process tracking entries keyed by instance ID. */
+    private readonly processes;
+    /** Low-level Pi process launcher. */
+    private readonly wrapper;
+    /** Docker sandbox mode adapter. */
+    private readonly docker;
+    /**
+     * Generate a stable instance ID for a spawned process.
+     *
+     * @param taskId - CLEO task ID.
+     * @returns Instance ID string in the format `pi-<taskId>-<shortRandom>`.
+     */
+    private makeInstanceId;
+    /**
+     * Spawn a Pi coding agent process with the given task prompt.
+     *
+     * When `opts.sandboxed` is `true` (or `CLEO_PI_SANDBOXED=1` is set), the
+     * adapter first verifies Docker readiness and delegates to
+     * {@link DockerModeAdapter.spawnInDocker}. On Docker failure it falls back
+     * to host-native mode with a warning to stderr.
+     *
+     * The returned {@link HarnessSpawnResult.exitPromise} resolves once the
+     * process exits or is killed. It NEVER rejects — failures are encoded in
+     * the resolved {@link HarnessProcessStatus}.
+     *
+     * @param taskId - Stable CLEO task identifier associated with this run.
+     * @param prompt - Prompt text to pass to the Pi agent.
+     * @param opts - Optional spawn configuration.
+     * @returns Spawn result containing the instance ID, PID, and exit promise.
+     *
+     * @public
+     */
+    spawn(taskId: string, prompt: string, opts?: HarnessSpawnOptions): Promise<HarnessSpawnResult>;
+    /**
+     * Query the current status of a spawned process.
+     *
+     * @param instanceId - Instance ID returned from {@link spawn}.
+     * @returns Current status snapshot, or `null` when the ID is not tracked.
+     *
+     * @public
+     */
+    status(instanceId: string): HarnessProcessStatus | null;
+    /**
+     * Terminate a running Pi process via SIGTERM-then-SIGKILL.
+     *
+     * Idempotent — subsequent calls after the first are no-ops.
+     *
+     * @param instanceId - Instance ID returned from {@link spawn}.
+     *
+     * @public
+     */
+    kill(instanceId: string): Promise<void>;
+    /**
+     * Return recently captured output lines for a process.
+     *
+     * Returns a snapshot of the bounded ring buffer maintained by the wrapper.
+     * The buffer is limited to `CLEO_HARNESS_OUTPUT_BUFFER` lines (default 500).
+     *
+     * @param instanceId - Instance ID returned from {@link spawn}.
+     * @returns Array of recent output lines, oldest first; empty when not found.
+     *
+     * @public
+     */
+    output(instanceId: string): HarnessOutputLine[];
+    /**
+     * Spawn Pi inside a Docker sandbox container.
+     *
+     * Checks Docker readiness first. On failure, falls back to host-native
+     * mode with a stderr warning. Prompt delivery and output buffering follow
+     * the same pattern as the host-native path in {@link PiWrapper.start}.
+     *
+     * @param entry - Process tracking entry (mutated in place).
+     * @param prompt - Prompt text to deliver to Pi.
+     * @param cwd - Host working directory (bind-mounted into container).
+     * @param env - Extra environment variable overrides.
+     */
+    private spawnInSandbox;
+}
+//# sourceMappingURL=adapter.d.ts.map

package/dist/harnesses/pi-coding-agent/adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../../../src/harnesses/pi-coding-agent/adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AAKH,OAAO,KAAK,EACV,cAAc,EACd,iBAAiB,EACjB,oBAAoB,EACpB,mBAAmB,EACnB,kBAAkB,EACnB,MAAM,YAAY,CAAC;AAMpB;;;;;;;;;;;;;;;GAeG;AACH,qBAAa,oBAAqB,YAAW,cAAc;IACzD,gCAAgC;IAChC,QAAQ,CAAC,EAAE,qBAAqB;IAEhC,4DAA4D;IAC5D,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAqC;IAE/D,qCAAqC;IACrC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAmB;IAE3C,mCAAmC;IACnC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA2B;IAElD;;;;;OAKG;IACH,OAAO,CAAC,cAAc;IAKtB;;;;;;;;;;;;;;;;;;OAkBG;IACG,KAAK,CACT,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,EACd,IAAI,CAAC,EAAE,mBAAmB,GACzB,OAAO,CAAC,kBAAkB,CAAC;IAmC9B;;;;;;;OAOG;IACH,MAAM,CAAC,UAAU,EAAE,MAAM,GAAG,oBAAoB,GAAG,IAAI;IAMvD;;;;;;;;OAQG;IACG,IAAI,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAM7C;;;;;;;;;;OAUG;IACH,MAAM,CAAC,UAAU,EAAE,MAAM,GAAG,iBAAiB,EAAE;IAU/C;;;;;;;;;;;OAWG;YACW,cAAc;CAuF7B"}

package/dist/harnesses/pi-coding-agent/adapter.js

@@ -0,0 +1,265 @@
+/**
+ * Pi Coding Agent Harness Adapter — cleo-os implementation.
+ *
+ * Implements the {@link HarnessAdapter} interface for the Pi coding agent CLI
+ * (`@mariozechner/pi-coding-agent`). Provides process spawn, status, kill,
+ * and output streaming for Pi processes launched by cleo-os.
+ *
+ * @remarks
+ * This adapter is the cleo-os counterpart to the CAAMP
+ * `PiSpawnProvider` in `packages/adapters/src/providers/pi/spawn.ts`.
+ * Where the CAAMP spawn provider is a detached fire-and-forget launcher,
+ * this adapter owns the full process lifecycle — attached stdin/stdout/stderr,
+ * bounded output buffering, and structured exit promises — so it can be
+ * used in orchestrated sandbox runs.
+ *
+ * Two launch modes are supported:
+ * - **Host-native** (default): Pi is invoked directly from PATH (or via
+ *   `CLEO_PI_BINARY`). This is the standard mode for local development.
+ * - **Docker sandbox** (opt-in): Pi is launched inside the
+ *   `cleo-sandbox/pi:local` Docker container when `CLEO_PI_SANDBOXED=1` is
+ *   set or `sandboxed: true` is passed to {@link PiCodingAgentAdapter.spawn}.
+ *   Falls back to host-native with a warning when Docker is unavailable.
+ *
+ * Instance IDs have the format `pi-<taskId>-<shortRandom>` to make
+ * correlation with task records straightforward.
+ *
+ * @see packages/adapters/src/providers/pi/spawn.ts — CAAMP spawn provider
+ * @see packages/cleo-os/src/harnesses/pi-coding-agent/pi-wrapper.ts — process management
+ * @see packages/cleo-os/src/harnesses/pi-coding-agent/docker-mode.ts — sandbox mode
+ * @task T922
+ * @epic T911
+ * @packageDocumentation
+ */
+import { writeFile } from 'node:fs/promises';
+import { DockerModeAdapter, isSandboxedGlobally } from './docker-mode.js';
+import { buildStatus, createProcessEntry, PiWrapper } from './pi-wrapper.js';
+// ---------------------------------------------------------------------------
+// PiCodingAgentAdapter
+// ---------------------------------------------------------------------------
+/**
+ * Harness adapter for the Pi coding agent CLI in the cleo-os sandbox.
+ *
+ * Manages a pool of Pi processes, each identified by a stable instance ID.
+ * Supports host-native and Docker sandbox launch modes.
+ *
+ * @example
+ * ```typescript
+ * const adapter = new PiCodingAgentAdapter();
+ * const { instanceId, exitPromise } = await adapter.spawn('T123', 'Write a hello-world script');
+ * const status = await exitPromise;
+ * console.log('exit code:', status.exitCode);
+ * ```
+ *
+ * @public
+ */
+export class PiCodingAgentAdapter {
+    /** Short adapter identifier. */
+    id = 'pi-coding-agent';
+    /** Active process tracking entries keyed by instance ID. */
+    processes = new Map();
+    /** Low-level Pi process launcher. */
+    wrapper = new PiWrapper();
+    /** Docker sandbox mode adapter. */
+    docker = new DockerModeAdapter();
+    /**
+     * Generate a stable instance ID for a spawned process.
+     *
+     * @param taskId - CLEO task ID.
+     * @returns Instance ID string in the format `pi-<taskId>-<shortRandom>`.
+     */
+    makeInstanceId(taskId) {
+        const rnd = Math.random().toString(36).slice(2, 9);
+        return `pi-${taskId}-${rnd}`;
+    }
+    /**
+     * Spawn a Pi coding agent process with the given task prompt.
+     *
+     * When `opts.sandboxed` is `true` (or `CLEO_PI_SANDBOXED=1` is set), the
+     * adapter first verifies Docker readiness and delegates to
+     * {@link DockerModeAdapter.spawnInDocker}. On Docker failure it falls back
+     * to host-native mode with a warning to stderr.
+     *
+     * The returned {@link HarnessSpawnResult.exitPromise} resolves once the
+     * process exits or is killed. It NEVER rejects — failures are encoded in
+     * the resolved {@link HarnessProcessStatus}.
+     *
+     * @param taskId - Stable CLEO task identifier associated with this run.
+     * @param prompt - Prompt text to pass to the Pi agent.
+     * @param opts - Optional spawn configuration.
+     * @returns Spawn result containing the instance ID, PID, and exit promise.
+     *
+     * @public
+     */
+    async spawn(taskId, prompt, opts) {
+        const instanceId = this.makeInstanceId(taskId);
+        const cwd = opts?.cwd ?? process.cwd();
+        const env = opts?.env ?? {};
+        const useSandbox = opts?.sandboxed === true || isSandboxedGlobally();
+        // Build exit promise — resolved by the process entry when the child exits.
+        let resolveExit;
+        const exitPromise = new Promise((resolve) => {
+            resolveExit = resolve;
+        });
+        const entry = createProcessEntry(instanceId, taskId, resolveExit);
+        this.processes.set(instanceId, entry);
+        // Wire abort signal to kill.
+        if (opts?.signal !== undefined) {
+            opts.signal.addEventListener('abort', () => {
+                void this.kill(instanceId);
+            });
+        }
+        if (useSandbox) {
+            await this.spawnInSandbox(entry, prompt, cwd, env);
+        }
+        else {
+            await this.wrapper.start(entry, prompt, cwd, env);
+        }
+        return {
+            instanceId,
+            pid: entry.pid,
+            exitPromise,
+        };
+    }
+    /**
+     * Query the current status of a spawned process.
+     *
+     * @param instanceId - Instance ID returned from {@link spawn}.
+     * @returns Current status snapshot, or `null` when the ID is not tracked.
+     *
+     * @public
+     */
+    status(instanceId) {
+        const entry = this.processes.get(instanceId);
+        if (entry === undefined)
+            return null;
+        return buildStatus(entry);
+    }
+    /**
+     * Terminate a running Pi process via SIGTERM-then-SIGKILL.
+     *
+     * Idempotent — subsequent calls after the first are no-ops.
+     *
+     * @param instanceId - Instance ID returned from {@link spawn}.
+     *
+     * @public
+     */
+    async kill(instanceId) {
+        const entry = this.processes.get(instanceId);
+        if (entry === undefined)
+            return;
+        this.wrapper.terminate(entry);
+    }
+    /**
+     * Return recently captured output lines for a process.
+     *
+     * Returns a snapshot of the bounded ring buffer maintained by the wrapper.
+     * The buffer is limited to `CLEO_HARNESS_OUTPUT_BUFFER` lines (default 500).
+     *
+     * @param instanceId - Instance ID returned from {@link spawn}.
+     * @returns Array of recent output lines, oldest first; empty when not found.
+     *
+     * @public
+     */
+    output(instanceId) {
+        const entry = this.processes.get(instanceId);
+        if (entry === undefined)
+            return [];
+        return [...entry.outputBuffer];
+    }
+    // ---------------------------------------------------------------------------
+    // Internal — Docker sandbox path
+    // ---------------------------------------------------------------------------
+    /**
+     * Spawn Pi inside a Docker sandbox container.
+     *
+     * Checks Docker readiness first. On failure, falls back to host-native
+     * mode with a stderr warning. Prompt delivery and output buffering follow
+     * the same pattern as the host-native path in {@link PiWrapper.start}.
+     *
+     * @param entry - Process tracking entry (mutated in place).
+     * @param prompt - Prompt text to deliver to Pi.
+     * @param cwd - Host working directory (bind-mounted into container).
+     * @param env - Extra environment variable overrides.
+     */
+    async spawnInSandbox(entry, prompt, cwd, env) {
+        const readiness = await this.docker.checkReadiness();
+        if (!readiness.ready) {
+            process.stderr.write(`[cleo-os/pi-coding-agent] Docker sandbox not ready: ${readiness.reason ?? 'unknown reason'}. Falling back to host-native mode.\n`);
+            await this.wrapper.start(entry, prompt, cwd, env);
+            return;
+        }
+        // Write prompt to a host-side temp file (bind-mounted read-only into container).
+        const promptFilePath = `/tmp/cleo-pi-${entry.instanceId}.txt`;
+        entry.tmpFile = promptFilePath;
+        try {
+            await writeFile(promptFilePath, prompt, 'utf-8');
+        }
+        catch (err) {
+            entry.state = 'failed';
+            entry.error = err instanceof Error ? err.message : String(err);
+            entry.endedAt = new Date().toISOString();
+            entry.resolveExit(buildStatus(entry));
+            return;
+        }
+        // Delegate to DockerModeAdapter which builds `docker run` args and spawns.
+        const child = this.docker.spawnInDocker({
+            prompt,
+            cwd,
+            env,
+            promptFilePath,
+        });
+        entry.child = child;
+        entry.pid = child.pid ?? null;
+        entry.state = 'running';
+        const bufferSize = 500; // use default; getOutputBufferSize() is in pi-wrapper.ts
+        child.stdout?.setEncoding('utf-8');
+        child.stdout?.on('data', (chunk) => {
+            for (const rawLine of chunk.split('\n')) {
+                const line = rawLine.trimEnd();
+                if (line.length === 0)
+                    continue;
+                entry.outputBuffer.push({ source: 'stdout', line, timestamp: new Date().toISOString() });
+                if (entry.outputBuffer.length > bufferSize)
+                    entry.outputBuffer.shift();
+            }
+        });
+        child.stderr?.setEncoding('utf-8');
+        child.stderr?.on('data', (chunk) => {
+            for (const rawLine of chunk.split('\n')) {
+                const line = rawLine.trimEnd();
+                if (line.length === 0)
+                    continue;
+                entry.outputBuffer.push({ source: 'stderr', line, timestamp: new Date().toISOString() });
+                if (entry.outputBuffer.length > bufferSize)
+                    entry.outputBuffer.shift();
+            }
+        });
+        child.on('close', async (code, signal) => {
+            if (entry.killTimer !== null) {
+                clearTimeout(entry.killTimer);
+                entry.killTimer = null;
+            }
+            entry.child = null;
+            entry.endedAt = new Date().toISOString();
+            if (entry.state === 'running') {
+                entry.state = signal !== null ? 'killed' : 'exited';
+                entry.exitCode = code;
+                entry.terminatingSignal = signal;
+            }
+            // Clean up the host-side prompt temp file.
+            if (entry.tmpFile !== null) {
+                try {
+                    const { unlink } = await import('node:fs/promises');
+                    await unlink(entry.tmpFile);
+                }
+                catch {
+                    // Best-effort.
+                }
+                entry.tmpFile = null;
+            }
+            entry.resolveExit(buildStatus(entry));
+        });
+    }
+}
+//# sourceMappingURL=adapter.js.map

package/dist/harnesses/pi-coding-agent/adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.js","sourceRoot":"","sources":["../../../src/harnesses/pi-coding-agent/adapter.ts"],"names":[],"mappings":"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"}