@parall/claude-agent 1.25.0 → 1.26.1

package/dist/config.d.ts

@@ -21,5 +21,7 @@ export declare function resolveClaudeAgentConfig(env?: NodeJS.ProcessEnv): Claud
 export declare function resolveWsUrl(apiUrl: string, explicitWsUrl?: string, swimlaneName?: string): string;
 export declare function buildClaudeRuntimeKey(agentUserId: string): string;
 export declare function sessionStateFilePathForRuntime(stateDir: string, runtimeKey: string): string;
+export declare function contextFilePathForSession(stateDir: string, sessionKey: string): string;
+/** @deprecated Use contextFilePathForSession. */
 export declare function stepIdFilePathForSession(stateDir: string, sessionKey: string): string;
 //# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAGA,MAAM,MAAM,iBAAiB,GAAG;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,cAAc,EAAE,MAAM,CAAC;IACvB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,OAAO,CAAC;CACtB,CAAC;AAsBF,wBAAgB,wBAAwB,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,iBAAiB,CA4BhG;AAED,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,aAAa,CAAC,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,MAAM,CAMlG;AAED,wBAAgB,qBAAqB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAEjE;AAED,wBAAgB,8BAA8B,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAG3F;AAED,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAGrF"}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAGA,MAAM,MAAM,iBAAiB,GAAG;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,cAAc,EAAE,MAAM,CAAC;IACvB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,OAAO,CAAC;CACtB,CAAC;AAsBF,wBAAgB,wBAAwB,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,iBAAiB,CA4BhG;AAED,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,aAAa,CAAC,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,MAAM,CAMlG;AAED,wBAAgB,qBAAqB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAEjE;AAED,wBAAgB,8BAA8B,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAG3F;AAED,wBAAgB,yBAAyB,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAGtF;AAED,iDAAiD;AACjD,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAGrF"}

package/dist/config.js

@@ -61,6 +61,11 @@ export function sessionStateFilePathForRuntime(stateDir, runtimeKey) {
     const fileName = Buffer.from(runtimeKey).toString("base64url");
     return path.join(stateDir, "sessions", `${fileName}.json`);
 }
+export function contextFilePathForSession(stateDir, sessionKey) {
+    const fileName = Buffer.from(sessionKey).toString("base64url");
+    return path.join(stateDir, "dispatch-context", `${fileName}.json`);
+}
+/** @deprecated Use contextFilePathForSession. */
 export function stepIdFilePathForSession(stateDir, sessionKey) {
     const fileName = Buffer.from(sessionKey).toString("base64url");
     return path.join(stateDir, "step-ids", `${fileName}.txt`);

package/dist/dispatch.d.ts

@@ -3,17 +3,42 @@ import type { ClaudeAgentConfig } from "./config.js";
 import { ClaudeSessionManager } from "./session-manager.js";
 type ClaudeCodeAdapterOptions = Pick<ClaudeAgentConfig, "additionalDirs" | "allowApiKey" | "allowedTools" | "appendSystemPrompt" | "claudeBin" | "claudeHome" | "disallowedTools" | "model" | "permissionMode" | "workspaceDir"> & {
     sessionManager: ClaudeSessionManager;
+    apiUrl: string;
+    apiKey: string;
+    orgId: string;
+    contextFilePathForSession?: (sessionKey: string) => string;
+    /** @deprecated Use contextFilePathForSession. */
+    stepIdFilePathForSession?: (sessionKey: string) => string;
 };
 export declare function buildSpawnEnv(parentEnv: NodeJS.ProcessEnv, claudeHome: string, context: DispatchOpts["context"], opts: {
     allowApiKey: boolean;
+    effortLevel?: string;
 }): NodeJS.ProcessEnv;
 export declare class ClaudeCodeAdapter implements DispatchAdapter {
     private readonly opts;
+    private readonly processes;
+    private shuttingDown;
+    private _model;
+    private _effortLevel;
     constructor(opts: ClaudeCodeAdapterOptions);
+    get currentModel(): string | undefined;
+    get currentEffort(): string | undefined;
+    updateConfig(config: {
+        model?: string | null;
+        effort?: string | null;
+    }): void;
     dispatch({ event, bodyForAgent, sessionKey, context }: DispatchOpts): AsyncIterable<RuntimeEvent>;
+    getBranchPoint(_sessionKey: string): string | undefined;
     forkSession({ sessionKey }: ForkOpts): import("@parall/agent-core").ForkSessionHandle | null;
     cleanupFork({ fork }: CleanupForkOpts): void;
+    shutdown(): Promise<void>;
+    private runTurn;
+    private ensureProcess;
+    private spawnProcess;
+    private killProcess;
+    private writeUserMessage;
     private buildArgs;
+    private buildPlaceholderContext;
 }
 export {};
 //# sourceMappingURL=dispatch.d.ts.map

package/dist/dispatch.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"dispatch.d.ts","sourceRoot":"","sources":["../src/dispatch.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EACV,eAAe,EACf,eAAe,EACf,YAAY,EACZ,QAAQ,EACR,YAAY,EACb,MAAM,oBAAoB,CAAC;AAC5B,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAErD,OAAO,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAE5D,KAAK,wBAAwB,GAAG,IAAI,CAClC,iBAAiB,EACf,gBAAgB,GAChB,aAAa,GACb,cAAc,GACd,oBAAoB,GACpB,WAAW,GACX,YAAY,GACZ,iBAAiB,GACjB,OAAO,GACP,gBAAgB,GAChB,cAAc,CACjB,GAAG;IACF,cAAc,EAAE,oBAAoB,CAAC;CACtC,CAAC;AAEF,wBAAgB,aAAa,CAC3B,SAAS,EAAE,MAAM,CAAC,UAAU,EAC5B,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,YAAY,CAAC,SAAS,CAAC,EAChC,IAAI,EAAE;IAAE,WAAW,EAAE,OAAO,CAAA;CAAE,GAC7B,MAAM,CAAC,UAAU,CAuBnB;AAED,qBAAa,iBAAkB,YAAW,eAAe;IAC3C,OAAO,CAAC,QAAQ,CAAC,IAAI;gBAAJ,IAAI,EAAE,wBAAwB;IAEpD,QAAQ,CAAC,EAAE,KAAK,EAAE,YAAY,EAAE,UAAU,EAAE,OAAO,EAAE,EAAE,YAAY,GAAG,aAAa,CAAC,YAAY,CAAC;IAkGxG,WAAW,CAAC,EAAE,UAAU,EAAE,EAAE,QAAQ;IAIpC,WAAW,CAAC,EAAE,IAAI,EAAE,EAAE,eAAe;IAIrC,OAAO,CAAC,SAAS;CAkClB"}
+{"version":3,"file":"dispatch.d.ts","sourceRoot":"","sources":["../src/dispatch.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EACV,eAAe,EACf,eAAe,EACf,YAAY,EACZ,QAAQ,EAER,YAAY,EACb,MAAM,oBAAoB,CAAC;AAC5B,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAErD,OAAO,EACL,oBAAoB,EAErB,MAAM,sBAAsB,CAAC;AAE9B,KAAK,wBAAwB,GAAG,IAAI,CAClC,iBAAiB,EACf,gBAAgB,GAChB,aAAa,GACb,cAAc,GACd,oBAAoB,GACpB,WAAW,GACX,YAAY,GACZ,iBAAiB,GACjB,OAAO,GACP,gBAAgB,GAChB,cAAc,CACjB,GAAG;IACF,cAAc,EAAE,oBAAoB,CAAC;IACrC,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,yBAAyB,CAAC,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,MAAM,CAAC;IAC3D,iDAAiD;IACjD,wBAAwB,CAAC,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,MAAM,CAAC;CAC3D,CAAC;AAEF,wBAAgB,aAAa,CAC3B,SAAS,EAAE,MAAM,CAAC,UAAU,EAC5B,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,YAAY,CAAC,SAAS,CAAC,EAChC,IAAI,EAAE;IAAE,WAAW,EAAE,OAAO,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAA;CAAE,GACnD,MAAM,CAAC,UAAU,CAuBnB;AAgBD,qBAAa,iBAAkB,YAAW,eAAe;IAM3C,OAAO,CAAC,QAAQ,CAAC,IAAI;IALjC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAmC;IAC7D,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,MAAM,CAAqB;IACnC,OAAO,CAAC,YAAY,CAAqB;gBAEZ,IAAI,EAAE,wBAAwB;IAI3D,IAAI,YAAY,IAAI,MAAM,GAAG,SAAS,CAAwB;IAC9D,IAAI,aAAa,IAAI,MAAM,GAAG,SAAS,CAA8B;IAErE,YAAY,CAAC,MAAM,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,GAAG,IAAI;IAYtE,QAAQ,CAAC,EAAE,KAAK,EAAE,YAAY,EAAE,UAAU,EAAE,OAAO,EAAE,EAAE,YAAY,GAAG,aAAa,CAAC,YAAY,CAAC;IAuBxG,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAMvD,WAAW,CAAC,EAAE,UAAU,EAAE,EAAE,QAAQ;IAIpC,WAAW,CAAC,EAAE,IAAI,EAAE,EAAE,eAAe;IAQ/B,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;YAShB,OAAO;IAsEtB,OAAO,CAAC,aAAa;IAyBrB,OAAO,CAAC,YAAY;IA0CpB,OAAO,CAAC,WAAW;IAgBnB,OAAO,CAAC,gBAAgB;IAWxB,OAAO,CAAC,SAAS;IAyCjB,OAAO,CAAC,uBAAuB;CAkBhC"}

package/dist/dispatch.js

@@ -1,19 +1,15 @@
+import * as path from "node:path";
 import { randomUUID } from "node:crypto";
 import { spawn } from "node:child_process";
 import { appendPreparedLocalAttachmentRefs, pinLocalAttachmentPaths, } from "@parall/agent-core/internal/attachment-input";
 import { parseClaudeStreamJson } from "./output-parser.js";
 export function buildSpawnEnv(parentEnv, claudeHome, context, opts) {
     const env = { ...parentEnv };
-    // Default: behave like the hosted Claude container — OAuth via
-    // ~/.claude/.credentials.json only. Inheriting the operator's
-    // ANTHROPIC_API_KEY would silently divert billing to Anthropic API
-    // pay-per-use instead of the connected Claude.ai subscription.
-    // Opt back in with PRLL_CLAUDE_ALLOW_API_KEY=1.
     if (!opts.allowApiKey) {
         delete env.ANTHROPIC_API_KEY;
         delete env.ANTHROPIC_AUTH_TOKEN;
     }
-    return {
+    const result = {
         ...env,
         HOME: claudeHome,
         PRLL_API_URL: context.apiUrl,
@@ -23,13 +19,38 @@ export function buildSpawnEnv(parentEnv, claudeHome, context, opts) {
         PRLL_CHAT_ID: context.chatId ?? "",
         PRLL_TRIGGER_MESSAGE_ID: context.triggerMessageId ?? "",
         PRLL_NO_REPLY: context.noReply ? "1" : "",
+        PRLL_CONTEXT_FILE: context.contextFilePath ?? "",
         PRLL_STEP_ID_FILE: context.stepIdFilePath ?? "",
     };
+    if (opts.effortLevel) {
+        result.CLAUDE_CODE_EFFORT_LEVEL = opts.effortLevel;
+    }
+    return result;
 }
 export class ClaudeCodeAdapter {
     opts;
+    processes = new Map();
+    shuttingDown = false;
+    _model;
+    _effortLevel;
     constructor(opts) {
         this.opts = opts;
+        this._model = opts.model;
+    }
+    get currentModel() { return this._model; }
+    get currentEffort() { return this._effortLevel; }
+    updateConfig(config) {
+        const modelChanged = config.model !== undefined && config.model !== this._model;
+        const effortChanged = config.effort !== undefined && config.effort !== this._effortLevel;
+        if (modelChanged)
+            this._model = config.model ?? undefined;
+        if (effortChanged)
+            this._effortLevel = config.effort ?? undefined;
+        if (modelChanged || effortChanged) {
+            for (const [, state] of this.processes) {
+                state.needsRestart = true;
+            }
+        }
     }
     async *dispatch({ event, bodyForAgent, sessionKey, context }) {
         let promptBody = bodyForAgent;
@@ -46,95 +67,185 @@ export class ClaudeCodeAdapter {
             context.log?.warn?.(`claude-agent[${context.accountId}]: failed to prepare local attachments: ${String(err)}`);
         }
         try {
-            const args = this.buildArgs(sessionKey, promptBody);
-            const env = buildSpawnEnv(process.env, this.opts.claudeHome, context, {
-                allowApiKey: this.opts.allowApiKey,
-            });
-            context.log?.info(`claude-agent[${context.accountId}]: spawn ${this.opts.claudeBin} ${args.slice(0, -1).join(" ")}`);
-            const proc = spawn(this.opts.claudeBin, args, {
-                cwd: this.opts.workspaceDir,
-                env,
-                stdio: ["ignore", "pipe", "pipe"],
-            });
-            if (!proc.stdout || !proc.stderr) {
-                throw new Error("Claude subprocess did not provide stdio pipes");
-            }
-            const stderr = [];
-            proc.stderr.on("data", (chunk) => {
-                stderr.push(chunk.toString());
-            });
-            const exitPromise = new Promise((resolve, reject) => {
-                proc.once("error", reject);
-                proc.once("close", (code, signal) => resolve({ code, signal }));
-            });
-            const groupKey = randomUUID();
-            let sawError = false;
-            let completed = false;
-            try {
-                for await (const streamEvent of parseClaudeStreamJson(proc.stdout)) {
-                    if (streamEvent.type === "session_id") {
-                        this.opts.sessionManager.recordSessionId(sessionKey, streamEvent.sessionId);
-                        continue;
-                    }
-                    if (streamEvent.type === "error") {
-                        sawError = true;
-                        yield streamEvent;
-                        continue;
-                    }
-                    if (streamEvent.type === "text") {
-                        // Runtime output contract (symmetric with OpenClaw channel): Claude's
-                        // plain text is never projected as a chat message. To reply, the agent
-                        // must explicitly run `parall messages send` / `dm` via Bash. Text
-                        // events are still recorded as suppressed session steps for audit.
-                        yield {
-                            ...streamEvent,
-                            project: false,
-                            groupKey,
-                        };
-                        continue;
-                    }
-                    yield {
-                        ...streamEvent,
-                        groupKey,
-                    };
-                }
-                completed = true;
-            }
-            finally {
-                if (!completed && proc.exitCode === null && proc.signalCode === null) {
-                    proc.kill("SIGTERM");
-                }
-                const { code, signal } = await exitPromise;
-                if ((code ?? 0) !== 0 && !sawError) {
-                    const detail = stderr.join("").trim();
-                    yield {
-                        type: "error",
-                        message: detail || `Claude exited with code ${code ?? "unknown"}${signal ? ` (${signal})` : ""}`,
-                    };
-                }
-            }
+            yield* this.runTurn(sessionKey, promptBody, context.log);
         }
         finally {
             releasePreparedAttachments();
         }
     }
+    getBranchPoint(_sessionKey) {
+        // Claude Code does not expose a branch-point API; fork scope prefix
+        // provides the behavioral fallback for this runtime.
+        return undefined;
+    }
     forkSession({ sessionKey }) {
         return this.opts.sessionManager.createForkSession(sessionKey);
     }
     cleanupFork({ fork }) {
+        const state = this.processes.get(fork.sessionKey);
+        if (state) {
+            this.killProcess(fork.sessionKey, state);
+        }
         this.opts.sessionManager.cleanupFork(fork.sessionKey);
     }
-    buildArgs(sessionKey, prompt) {
+    async shutdown() {
+        this.shuttingDown = true;
+        for (const [sessionKey, state] of this.processes) {
+            this.killProcess(sessionKey, state);
+        }
+        this.processes.clear();
+        await this.opts.sessionManager.shutdownAll();
+    }
+    async *runTurn(sessionKey, promptBody, log) {
+        let state;
+        try {
+            state = this.ensureProcess(sessionKey, log);
+        }
+        catch (err) {
+            yield { type: "error", message: `Claude spawn failed: ${String(err)}` };
+            return;
+        }
+        const groupKey = randomUUID();
+        let sawError = false;
+        try {
+            this.writeUserMessage(state.handle, promptBody);
+        }
+        catch (err) {
+            yield { type: "error", message: `Claude stdin write failed: ${String(err)}` };
+            this.killProcess(sessionKey, state);
+            return;
+        }
+        while (true) {
+            const next = await state.parser.next();
+            if (next.done) {
+                state.done = true;
+                this.processes.delete(sessionKey);
+                if (!sawError) {
+                    const detail = state.handle.stderrChunks.join("").trim();
+                    const exit = await state.handle.exitPromise.catch(() => ({ code: null, signal: null }));
+                    yield {
+                        type: "error",
+                        message: detail
+                            || `Claude exited with code ${exit.code ?? "unknown"}${exit.signal ? ` (${exit.signal})` : ""}`,
+                    };
+                }
+                return;
+            }
+            const parsed = next.value;
+            if (parsed.type === "session_id") {
+                this.opts.sessionManager.recordSessionId(sessionKey, parsed.sessionId);
+                continue;
+            }
+            if (parsed.type === "turn_end") {
+                if (state.needsRestart) {
+                    this.killProcess(sessionKey, state);
+                }
+                return;
+            }
+            if (parsed.type === "error") {
+                sawError = true;
+                yield parsed;
+                continue;
+            }
+            if (parsed.type === "text") {
+                yield { ...parsed, project: false, groupKey };
+                continue;
+            }
+            yield { ...parsed, groupKey };
+        }
+    }
+    ensureProcess(sessionKey, log) {
+        if (this.shuttingDown) {
+            throw new Error("claude-agent: adapter shutting down, refusing new process");
+        }
+        const existing = this.processes.get(sessionKey);
+        if (existing && !existing.done) {
+            const { proc } = existing.handle;
+            if (existing.needsRestart) {
+                this.killProcess(sessionKey, existing);
+            }
+            else if (proc.exitCode === null && proc.signalCode === null && !proc.stdin.destroyed) {
+                return existing;
+            }
+            else {
+                this.processes.delete(sessionKey);
+            }
+        }
+        const handle = this.spawnProcess(sessionKey, log);
+        const parser = parseClaudeStreamJson(handle.proc.stdout);
+        const state = { handle, parser, done: false, needsRestart: false };
+        this.processes.set(sessionKey, state);
+        this.opts.sessionManager.registerProcess(sessionKey, handle);
+        return state;
+    }
+    spawnProcess(sessionKey, log) {
+        const args = this.buildArgs(sessionKey);
+        const env = buildSpawnEnv(process.env, this.opts.claudeHome, this.buildPlaceholderContext(sessionKey), { allowApiKey: this.opts.allowApiKey, effortLevel: this._effortLevel });
+        log?.info(`claude-agent: spawn long-lived ${this.opts.claudeBin} (session ${sessionKey}, model=${this._model || "default"}, effort=${this._effortLevel || "default"}, mode=${this.opts.permissionMode})`);
+        const proc = spawn(this.opts.claudeBin, args, {
+            cwd: this.opts.workspaceDir,
+            env,
+            stdio: ["pipe", "pipe", "pipe"],
+        });
+        if (!proc.stdout || !proc.stderr || !proc.stdin) {
+            throw new Error("Claude subprocess did not provide stdio pipes");
+        }
+        const stderrChunks = [];
+        proc.stderr.on("data", (chunk) => {
+            stderrChunks.push(chunk.toString());
+        });
+        proc.stdin.on("error", () => {
+            // Absorb async EPIPE / ERR_STREAM_WRITE_AFTER_END when the child
+            // exits between our write check and the kernel delivering the data.
+            // The next parser.next() will see the stream end and surface an error
+            // RuntimeEvent through the normal turn-end path.
+        });
+        const exitPromise = new Promise((resolve) => {
+            proc.once("close", (code, signal) => resolve({ code, signal }));
+            proc.once("error", () => resolve({ code: null, signal: null }));
+        });
+        return { proc, exitPromise, stderrChunks };
+    }
+    killProcess(sessionKey, state) {
+        state.done = true;
+        const current = this.processes.get(sessionKey);
+        if (current === state) {
+            this.processes.delete(sessionKey);
+        }
+        try {
+            state.handle.proc.stdin.end();
+        }
+        catch { /* best-effort */ }
+        if (state.handle.proc.exitCode === null && state.handle.proc.signalCode === null) {
+            try {
+                state.handle.proc.kill("SIGTERM");
+            }
+            catch { /* best-effort */ }
+        }
+    }
+    writeUserMessage(handle, text) {
+        const payload = JSON.stringify({
+            type: "user",
+            message: {
+                role: "user",
+                content: [{ type: "text", text }],
+            },
+        });
+        handle.proc.stdin.write(`${payload}\n`);
+    }
+    buildArgs(sessionKey) {
         const args = [
-            "--print",
+            "-p",
             "--verbose",
+            "--input-format",
+            "stream-json",
             "--output-format",
             "stream-json",
             "--permission-mode",
             this.opts.permissionMode,
         ];
-        if (this.opts.model) {
-            args.push("--model", this.opts.model);
+        if (this._model) {
+            args.push("--model", this._model);
         }
         if (this.opts.allowedTools.length > 0) {
             args.push("--allowedTools", this.opts.allowedTools.join(","));
@@ -142,6 +253,7 @@ export class ClaudeCodeAdapter {
         if (this.opts.disallowedTools.length > 0) {
             args.push("--disallowedTools", this.opts.disallowedTools.join(","));
         }
+        args.push("--append-system-prompt-file", path.join(this.opts.workspaceDir, ".parall", "system-prompt.md"));
         if (this.opts.appendSystemPrompt) {
             args.push("--append-system-prompt", this.opts.appendSystemPrompt);
         }
@@ -149,7 +261,24 @@ export class ClaudeCodeAdapter {
             args.push("--add-dir", ...this.opts.additionalDirs);
         }
         args.push(...this.opts.sessionManager.getResumeArgs(sessionKey));
-        args.push(prompt);
         return args;
     }
+    buildPlaceholderContext(sessionKey) {
+        return {
+            accountId: "",
+            apiUrl: this.opts.apiUrl,
+            apiKey: this.opts.apiKey,
+            orgId: this.opts.orgId,
+            agentUserId: "",
+            runtimeType: "",
+            runtimeKey: "",
+            sessionId: "",
+            chatId: "",
+            triggerMessageId: "",
+            noReply: false,
+            contextFilePath: this.opts.contextFilePathForSession?.(sessionKey) ?? "",
+            stepIdFilePath: this.opts.stepIdFilePathForSession?.(sessionKey) ?? "",
+            client: undefined,
+        };
+    }
 }

package/dist/index.js

@@ -1,8 +1,8 @@
 #!/usr/bin/env node
 import * as os from "node:os";
-import { ParallAgentGateway, parseShutdownDeadlineMs } from "@parall/agent-core";
+import { ParallAgentGateway, createPlatformConfigManager, isPlatformManagedProfile, parseShutdownDeadlineMs } from "@parall/agent-core";
 import { ApiError, ParallClient, ParallWs } from "@parall/sdk";
-import { buildClaudeRuntimeKey, resolveClaudeAgentConfig, resolveWsUrl, sessionStateFilePathForRuntime, stepIdFilePathForSession, } from "./config.js";
+import { buildClaudeRuntimeKey, contextFilePathForSession, resolveClaudeAgentConfig, resolveWsUrl, sessionStateFilePathForRuntime, stepIdFilePathForSession, } from "./config.js";
 import { ClaudeCodeAdapter } from "./dispatch.js";
 import { ClaudeSessionManager } from "./session-manager.js";
 import { ensureClaudeWorkspace } from "./workspace.js";
@@ -55,11 +55,22 @@ async function main() {
         getTicket: () => client.getWsTicket(),
         wsUrl: resolvedWsUrl,
     });
+    const configMgr = createPlatformConfigManager({ client, stateDir: config.stateDir, runtimeType: "claude-code", log });
+    const platformDefaults = await configMgr.fetch();
+    let platformManaged = isPlatformManagedProfile(me.agent_profile);
+    const resolvedModel = platformManaged ? (platformDefaults.model ?? config.model) : config.model;
+    const resolvedEffort = platformManaged
+        ? (platformDefaults.thinkingEffort ?? (process.env.CLAUDE_CODE_EFFORT_LEVEL?.trim() || undefined))
+        : (process.env.CLAUDE_CODE_EFFORT_LEVEL?.trim() || undefined);
+    if (platformDefaults.model)
+        log.info(`platform config: model=${platformDefaults.model} (${platformManaged ? "applied" : "ignored, model_management=self"})`);
+    if (platformDefaults.thinkingEffort)
+        log.info(`platform config: thinking_effort=${platformDefaults.thinkingEffort} (${platformManaged ? "applied" : "ignored, model_management=self"})`);
     const adapter = new ClaudeCodeAdapter({
         claudeBin: config.claudeBin,
         claudeHome: config.claudeHome,
         workspaceDir: config.workspaceDir,
-        model: config.model,
+        model: resolvedModel,
         permissionMode: config.permissionMode,
         allowedTools: config.allowedTools,
         disallowedTools: config.disallowedTools,
@@ -67,7 +78,18 @@ async function main() {
         appendSystemPrompt: config.appendSystemPrompt,
         allowApiKey: config.allowApiKey,
         sessionManager,
+        // Static Parall credentials. The long-lived subprocess must authenticate
+        // against Parall's API across many dispatches, so these cannot come from
+        // a per-dispatch DispatchContext.
+        apiUrl: config.apiUrl,
+        apiKey: config.apiKey,
+        orgId: config.orgId,
+        contextFilePathForSession: (sessionKey) => contextFilePathForSession(config.stateDir, sessionKey),
+        stepIdFilePathForSession: (sessionKey) => stepIdFilePathForSession(config.stateDir, sessionKey),
     });
+    if (resolvedEffort) {
+        adapter.updateConfig({ effort: resolvedEffort });
+    }
     const gateway = new ParallAgentGateway({
         accountId: agentUserId,
         client,
@@ -90,7 +112,33 @@ async function main() {
         dispatchAdapter: adapter,
         log,
         shutdownDeadlineMs: parseShutdownDeadlineMs(process.env.PRLL_SHUTDOWN_DEADLINE_MS),
+        contextFilePathForSession: (sessionKey) => contextFilePathForSession(config.stateDir, sessionKey),
         stepIdFilePathForSession: (sessionKey) => stepIdFilePathForSession(config.stateDir, sessionKey),
+        onConfigUpdate: async () => {
+            const refreshed = await getAgentMeWithLegacyFallback(client, config.orgId);
+            platformManaged = isPlatformManagedProfile(refreshed.agent_profile);
+            const updated = await configMgr.fetch();
+            const localEffort = process.env.CLAUDE_CODE_EFFORT_LEVEL?.trim() || null;
+            adapter.updateConfig({
+                model: platformManaged ? (updated.model ?? config.model) : (config.model ?? null),
+                effort: platformManaged ? (updated.thinkingEffort ?? localEffort) : localEffort,
+            });
+        },
+        onSessionReady: async () => {
+            const refreshed = await getAgentMeWithLegacyFallback(client, config.orgId);
+            platformManaged = isPlatformManagedProfile(refreshed.agent_profile);
+            const updated = await configMgr.fetch();
+            const localEffort = process.env.CLAUDE_CODE_EFFORT_LEVEL?.trim() || null;
+            adapter.updateConfig({
+                model: platformManaged ? (updated.model ?? config.model) : (config.model ?? null),
+                effort: platformManaged ? (updated.thinkingEffort ?? localEffort) : localEffort,
+            });
+        },
+        // Long-lived `claude` subprocesses outlive a single dispatch, so the
+        // gateway's shuttingDown flag alone does not tear them down. Piggyback on
+        // onBeforeDisconnect to close stdin and SIGTERM any survivors after
+        // in-flight drains finish.
+        onBeforeDisconnect: () => adapter.shutdown(),
     });
     const abortController = new AbortController();
     const abort = () => abortController.abort();

package/dist/output-parser.d.ts

@@ -3,6 +3,10 @@ import type { RuntimeEvent } from "@parall/agent-core";
 export type ClaudeParsedEvent = RuntimeEvent | {
     type: "session_id";
     sessionId: string;
+} | {
+    type: "turn_end";
+    sessionId?: string;
+    isError: boolean;
 };
 export declare function parseClaudeStreamJson(readable: Readable): AsyncGenerator<ClaudeParsedEvent>;
 //# sourceMappingURL=output-parser.d.ts.map

package/dist/output-parser.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"output-parser.d.ts","sourceRoot":"","sources":["../src/output-parser.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAEvD,MAAM,MAAM,iBAAiB,GACzB,YAAY,GACZ;IAAE,IAAI,EAAE,YAAY,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,CAAC;AA4E9C,wBAAuB,qBAAqB,CAAC,QAAQ,EAAE,QAAQ,GAAG,cAAc,CAAC,iBAAiB,CAAC,CAgHlG"}
+{"version":3,"file":"output-parser.d.ts","sourceRoot":"","sources":["../src/output-parser.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAEvD,MAAM,MAAM,iBAAiB,GACzB,YAAY,GACZ;IAAE,IAAI,EAAE,YAAY,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GAWzC;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,OAAO,CAAA;CAAE,CAAC;AA4E/D,wBAAuB,qBAAqB,CAAC,QAAQ,EAAE,QAAQ,GAAG,cAAc,CAAC,iBAAiB,CAAC,CA8HlG"}

package/dist/output-parser.js

@@ -173,11 +173,25 @@ export async function* parseClaudeStreamJson(readable) {
             }
             continue;
         }
-        if (eventRecord.type === "result" && eventRecord.is_error === true) {
-            const message = asTrimmedString(eventRecord.result)
-                || asTrimmedString(eventRecord.error)
-                || "Claude dispatch failed";
-            yield { type: "error", message };
+        if (eventRecord.type === "result") {
+            const isError = eventRecord.is_error === true;
+            if (isError) {
+                const message = asTrimmedString(eventRecord.result)
+                    || asTrimmedString(eventRecord.error)
+                    || "Claude dispatch failed";
+                yield { type: "error", message };
+            }
+            // Turn boundary: the subprocess lives across many turns, so any
+            // tool_use entries that never matched a tool_result this turn
+            // (tool crashed mid-call, Claude aborted, etc.) must not leak into
+            // the next turn's accounting. Drop them here rather than letting
+            // the map grow unbounded or mislabel durations on id collisions.
+            toolUses.clear();
+            yield {
+                type: "turn_end",
+                sessionId: asTrimmedString(eventRecord.session_id),
+                isError,
+            };
         }
     }
 }

package/dist/session-manager.d.ts

@@ -1,18 +1,41 @@
+import type { ChildProcessWithoutNullStreams } from "node:child_process";
 import type { ForkSessionHandle } from "@parall/agent-core";
 type ClaudeSessionManagerLogger = {
     warn(message: string): void;
 };
+export type ClaudeProcessHandle = {
+    proc: ChildProcessWithoutNullStreams;
+    exitPromise: Promise<{
+        code: number | null;
+        signal: NodeJS.Signals | null;
+    }>;
+    stderrChunks: string[];
+};
 export declare class ClaudeSessionManager {
     private readonly mainSessionKey;
     private readonly stateFilePath;
     private readonly logger?;
     private readonly sessionIds;
     private readonly pendingForkParents;
+    private readonly processes;
     constructor(mainSessionKey: string, stateFilePath: string, logger?: ClaudeSessionManagerLogger | undefined);
     getResumeArgs(sessionKey: string): string[];
     recordSessionId(sessionKey: string, sessionId: string): void;
     createForkSession(parentSessionKey: string): ForkSessionHandle | null;
     cleanupFork(sessionKey: string): void;
+    getProcess(sessionKey: string): ClaudeProcessHandle | undefined;
+    registerProcess(sessionKey: string, handle: ClaudeProcessHandle): void;
+    clearProcess(sessionKey: string, handle?: ClaudeProcessHandle): void;
+    /** Grace period (ms) between SIGTERM and SIGKILL during shutdown. */
+    private static readonly SHUTDOWN_GRACE_MS;
+    shutdownAll(): Promise<void>;
+    private shutdownOne;
+    /**
+     * Wait up to `ms` for `promise`. Resolves `false` if the promise settled
+     * in time, `true` if the timeout fired first. Never rejects.
+     */
+    private raceWithTimeout;
+    private closeHandle;
     private restore;
     private persist;
 }

package/dist/session-manager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"session-manager.d.ts","sourceRoot":"","sources":["../src/session-manager.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAO5D,KAAK,0BAA0B,GAAG;IAChC,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7B,CAAC;AAEF,qBAAa,oBAAoB;IAK7B,OAAO,CAAC,QAAQ,CAAC,cAAc;IAC/B,OAAO,CAAC,QAAQ,CAAC,aAAa;IAC9B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC;IAN1B,OAAO,CAAC,QAAQ,CAAC,UAAU,CAA6B;IACxD,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAA6B;gBAG7C,cAAc,EAAE,MAAM,EACtB,aAAa,EAAE,MAAM,EACrB,MAAM,CAAC,EAAE,0BAA0B,YAAA;IAKtD,aAAa,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,EAAE;IAU3C,eAAe,CAAC,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM;IAQrD,iBAAiB,CAAC,gBAAgB,EAAE,MAAM,GAAG,iBAAiB,GAAG,IAAI;IAYrE,WAAW,CAAC,UAAU,EAAE,MAAM;IAK9B,OAAO,CAAC,OAAO;IAYf,OAAO,CAAC,OAAO;CAahB"}
+{"version":3,"file":"session-manager.d.ts","sourceRoot":"","sources":["../src/session-manager.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,8BAA8B,EAAE,MAAM,oBAAoB,CAAC;AACzE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAO5D,KAAK,0BAA0B,GAAG;IAChC,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7B,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG;IAChC,IAAI,EAAE,8BAA8B,CAAC;IACrC,WAAW,EAAE,OAAO,CAAC;QAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC,OAAO,GAAG,IAAI,CAAA;KAAE,CAAC,CAAC;IAC7E,YAAY,EAAE,MAAM,EAAE,CAAC;CACxB,CAAC;AAEF,qBAAa,oBAAoB;IAM7B,OAAO,CAAC,QAAQ,CAAC,cAAc;IAC/B,OAAO,CAAC,QAAQ,CAAC,aAAa;IAC9B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC;IAP1B,OAAO,CAAC,QAAQ,CAAC,UAAU,CAA6B;IACxD,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAA6B;IAChE,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA0C;gBAGjD,cAAc,EAAE,MAAM,EACtB,aAAa,EAAE,MAAM,EACrB,MAAM,CAAC,EAAE,0BAA0B,YAAA;IAKtD,aAAa,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,EAAE;IAU3C,eAAe,CAAC,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM;IAQrD,iBAAiB,CAAC,gBAAgB,EAAE,MAAM,GAAG,iBAAiB,GAAG,IAAI;IAYrE,WAAW,CAAC,UAAU,EAAE,MAAM;IAU9B,UAAU,CAAC,UAAU,EAAE,MAAM,GAAG,mBAAmB,GAAG,SAAS;IAI/D,eAAe,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,mBAAmB;IAsB/D,YAAY,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,mBAAmB;IAO7D,qEAAqE;IACrE,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,iBAAiB,CAAS;IAE5C,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC;YAQpB,WAAW;IAuCzB;;;OAGG;IACH,OAAO,CAAC,eAAe;IAuBvB,OAAO,CAAC,WAAW;IAqBnB,OAAO,CAAC,OAAO;IAYf,OAAO,CAAC,OAAO;CAahB"}