@parall/claude-agent 1.57.2 → 1.58.1

package/dist/dispatch.d.ts

@@ -1,11 +1,17 @@
 import type { CleanupForkOpts, DispatchAdapter, DispatchInputLifecycle, DispatchOpts, ForkOpts, RuntimeEvent } from '@parall/agent-core';
 import type { ClaudeAgentConfig } from './config.js';
 import type { ClaudeSessionManager } from './session-manager.js';
+import { buildSpawnEnv } from './spawn-env.js';
+export { buildSpawnEnv };
 type ClaudeCodeAdapterOptions = Pick<ClaudeAgentConfig, 'additionalDirs' | 'allowApiKey' | 'allowedTools' | 'appendSystemPrompt' | 'claudeBin' | 'claudeHome' | 'disallowedTools' | 'model' | 'permissionMode' | 'workspaceDir'> & {
     sessionManager: ClaudeSessionManager;
     apiUrl: string;
     apiKey: string;
     orgId: string;
+    /** Catalog context size for the selected model. */
+    contextWindow?: number;
+    /** Catalog max output tokens for the selected model (input-budget subtrahend). */
+    maxTokens?: number;
     contextFilePathForSession?: (sessionKey: string) => string;
     /** @deprecated Use contextFilePathForSession. */
     stepIdFilePathForSession?: (sessionKey: string) => string;
@@ -27,12 +33,6 @@ type ClaudeCodeAdapterOptions = Pick<ClaudeAgentConfig, 'additionalDirs' | 'allo
      */
     capabilityBinDir?: string;
 };
-export declare function buildSpawnEnv(parentEnv: NodeJS.ProcessEnv, claudeHome: string, context: DispatchOpts['context'], opts: {
-    allowApiKey: boolean;
-    effortLevel?: string;
-    wikiMountRoot?: string;
-    capabilityBinDir?: string;
-}): NodeJS.ProcessEnv;
 export declare class ClaudeCodeAdapter implements DispatchAdapter {
     private readonly opts;
     readonly inputLifecycleMode: "explicit";
@@ -42,12 +42,16 @@ export declare class ClaudeCodeAdapter implements DispatchAdapter {
     private shuttingDown;
     private _model;
     private _effortLevel;
+    private _contextWindow;
+    private _maxTokens;
     constructor(opts: ClaudeCodeAdapterOptions);
     get currentModel(): string | undefined;
     get currentEffort(): string | undefined;
     updateConfig(config: {
         model?: string | null;
         effort?: string | null;
+        contextWindow?: number | null;
+        maxTokens?: number | null;
     }): void;
     requestProcessRestart(): void;
     enqueueDuringDispatch(sessionKey: string, body: string, inputLifecycle?: DispatchInputLifecycle): boolean;
@@ -85,5 +89,4 @@ export declare class ClaudeCodeAdapter implements DispatchAdapter {
     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":"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"}
+{"version":3,"file":"dispatch.d.ts","sourceRoot":"","sources":["../src/dispatch.ts"],"names":[],"mappings":"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"}

package/dist/dispatch.js

@@ -1,11 +1,13 @@
+import { execSync, spawn } from 'node:child_process';
+import { randomUUID } from 'node:crypto';
 import * as fs from 'node:fs';
 import * as path from 'node:path';
-import { randomUUID } from 'node:crypto';
-import { execSync, spawn } from 'node:child_process';
 import { appendPreparedLocalAttachmentRefs, pinLocalAttachmentPaths, } from '@parall/agent-core/internal/attachment-input';
 import { ClaudeInputRegistry } from './input-lifecycle.js';
 import { parseClaudeStreamJson, } from './output-parser.js';
+import { buildSpawnEnv } from './spawn-env.js';
 import { classifyClaudeTurn } from './turn-outcome.js';
+export { buildSpawnEnv };
 const IS_WIN32 = process.platform === 'win32';
 const CAPABILITY_PROBE_TIMEOUT_MS = 15_000;
 class MissingClaudeLifecycleCapabilityError extends Error {
@@ -24,58 +26,6 @@ function killWin32Tree(pid) {
         return false;
     }
 }
-export function buildSpawnEnv(parentEnv, claudeHome, context, opts) {
-    const env = { ...parentEnv };
-    if (!opts.allowApiKey) {
-        delete env.ANTHROPIC_API_KEY;
-        delete env.ANTHROPIC_AUTH_TOKEN;
-    }
-    const result = {
-        ...env,
-        HOME: claudeHome,
-        PRLL_API_URL: context.apiUrl,
-        PRLL_API_KEY: context.apiKey,
-        PRLL_ORG_ID: context.orgId,
-        PRLL_SESSION_ID: context.sessionId ?? '',
-        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 ?? '',
-        // Per-lane dispatch context directory (stable for the bridge's lifetime,
-        // so pinning it at spawn is safe even for long-lived subprocesses). The
-        // CLI keys into it by send target to derive dispatch effect keys.
-        PRLL_CONTEXT_DIR: context.contextDirPath ?? '',
-    };
-    // Pin the wiki workspace to the agent workspace (same convention as the
-    // OpenClaw runtime). Without this, `parall wiki` resolves mounts relative
-    // to the subprocess cwd — a `cd` into any subdirectory would silently
-    // split the agent across two wiki workspaces. Operator-set env wins.
-    if (!result.PRLL_WIKI_MOUNT_ROOT?.trim() && opts.wikiMountRoot) {
-        result.PRLL_WIKI_MOUNT_ROOT = opts.wikiMountRoot;
-    }
-    if (opts.effortLevel) {
-        result.CLAUDE_CODE_EFFORT_LEVEL = opts.effortLevel;
-    }
-    // Channel-capability shims resolve ahead of any globally-installed CLI of
-    // the same name (the shim owns auth; the real binary is found further down
-    // the PATH by the shim itself). On Windows env keys are case-insensitive and
-    // the host key is usually `Path`; after the plain-object spread a literal
-    // `PATH` write would SPLIT the key (undefined which wins in the child), so
-    // reuse the parent's casing. On POSIX keys are case-SENSITIVE — `PATH` is
-    // the real one and a stray `Path` is unrelated, so match exactly there or we
-    // could prepend to the wrong variable and silently bypass the shim.
-    if (opts.capabilityBinDir) {
-        const pathKey = process.platform === 'win32'
-            ? (Object.keys(result).find((k) => k.toUpperCase() === 'PATH') ?? 'PATH')
-            : 'PATH';
-        const existing = result[pathKey];
-        result[pathKey] = existing
-            ? `${opts.capabilityBinDir}${path.delimiter}${existing}`
-            : opts.capabilityBinDir;
-    }
-    return result;
-}
 export class ClaudeCodeAdapter {
     opts;
     inputLifecycleMode = 'explicit';
@@ -85,9 +35,13 @@ export class ClaudeCodeAdapter {
     shuttingDown = false;
     _model;
     _effortLevel;
+    _contextWindow;
+    _maxTokens;
     constructor(opts) {
         this.opts = opts;
         this._model = opts.model;
+        this._contextWindow = opts.contextWindow;
+        this._maxTokens = opts.maxTokens;
     }
     get currentModel() {
         return this._model;
@@ -98,11 +52,17 @@ export class ClaudeCodeAdapter {
     updateConfig(config) {
         const modelChanged = config.model !== undefined && config.model !== this._model;
         const effortChanged = config.effort !== undefined && config.effort !== this._effortLevel;
+        const contextWindowChanged = config.contextWindow !== undefined && config.contextWindow !== this._contextWindow;
+        const maxTokensChanged = config.maxTokens !== undefined && config.maxTokens !== this._maxTokens;
         if (modelChanged)
             this._model = config.model ?? undefined;
         if (effortChanged)
             this._effortLevel = config.effort ?? undefined;
-        if (modelChanged || effortChanged) {
+        if (contextWindowChanged)
+            this._contextWindow = config.contextWindow ?? undefined;
+        if (maxTokensChanged)
+            this._maxTokens = config.maxTokens ?? undefined;
+        if (modelChanged || effortChanged || contextWindowChanged || maxTokensChanged) {
             this.requestProcessRestart();
         }
     }
@@ -557,11 +517,13 @@ export class ClaudeCodeAdapter {
         const args = this.buildArgs(sessionKey, resume);
         const env = buildSpawnEnv(process.env, this.opts.claudeHome, this.buildPlaceholderContext(sessionKey), {
             allowApiKey: this.opts.allowApiKey,
+            contextWindow: this._contextWindow,
+            maxTokens: this._maxTokens,
             effortLevel: this._effortLevel,
             wikiMountRoot: this.opts.workspaceDir,
             capabilityBinDir: this.opts.capabilityBinDir,
         });
-        log?.info(`spawn long-lived ${this.opts.claudeBin} (session ${sessionKey}, model=${this._model || 'default'}, effort=${this._effortLevel || 'default'}, mode=${this.opts.permissionMode})`);
+        log?.info(`spawn long-lived ${this.opts.claudeBin} (session ${sessionKey}, model=${this._model || 'default'}, context=${this._contextWindow || 'cli-default'}, maxOut=${this._maxTokens || 'cli-default'}, effort=${this._effortLevel || 'default'}, mode=${this.opts.permissionMode})`);
         const proc = spawn(IS_WIN32 ? quoteWin32Arg(this.opts.claudeBin) : this.opts.claudeBin, IS_WIN32 ? args.map(quoteWin32Arg) : args, {
             cwd: this.opts.workspaceDir,
             env,

package/dist/index.js

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
 import * as os from 'node:os';
-import { ParallAgentGateway, capabilityBinDir, configureHttpKeepAlive, createPlatformConfigManager, createLogger, createOtelLogger, childLogger, deriveModelIsPin, materializeChannelCapabilities, resolveRuntimeModel, parseShutdownDeadlineMs, parseForkDeadlineMs, parseDispatchDeadlineMs, parseProviderConfig, clearAllProviderCreds, llmSource, identityFromMe, initAgentTelemetry, } from '@parall/agent-core';
+import { capabilityBinDir, childLogger, clearAllProviderCreds, configureHttpKeepAlive, createLogger, createOtelLogger, createPlatformConfigManager, deriveModelIsPin, identityFromMe, initAgentTelemetry, llmSource, materializeChannelCapabilities, ParallAgentGateway, parseDispatchDeadlineMs, parseForkDeadlineMs, parseProviderConfig, parseShutdownDeadlineMs, resolveRuntimeContextWindow, resolveRuntimeMaxTokens, resolveRuntimeModel, } from '@parall/agent-core';
 import { ApiError, ParallClient, ParallWs } from '@parall/sdk';
 import { buildClaudeRuntimeKey, contextFilePathForSession, dispatchContextDirPath, resolveClaudeAgentConfig, resolveWsUrl, sessionStateFilePathForRuntime, stepIdFilePathForSession, } from './config.js';
 import { ClaudeCodeAdapter } from './dispatch.js';
@@ -22,10 +22,10 @@ async function getAgentMeWithLegacyFallback(client, orgId) {
 }
 function resolveProviderEnv() {
     const pc = parseProviderConfig(process.env);
+    const source = llmSource(pc);
     if (!pc)
-        return;
+        return source;
     clearAllProviderCreds(process.env);
-    const source = llmSource(pc);
     if (source === 'parall') {
         process.env.ANTHROPIC_AUTH_TOKEN = process.env.PRLL_API_KEY;
         process.env.ANTHROPIC_BASE_URL = `${process.env.PRLL_API_URL}/api/llm`;
@@ -39,6 +39,7 @@ function resolveProviderEnv() {
         if (pc.anthropic_base_url)
             process.env.ANTHROPIC_BASE_URL = pc.anthropic_base_url;
     }
+    return source;
 }
 async function main() {
     // Before any fetch: long-lived HTTP connections for every bridge→api call.
@@ -46,7 +47,7 @@ async function main() {
     const telemetry = await initAgentTelemetry('parall-claude-agent', 'claude-code');
     activeLog = createOtelLogger('agent', 'claude-agent');
     try {
-        resolveProviderEnv();
+        const activeLLMSource = resolveProviderEnv();
         const config = resolveClaudeAgentConfig(process.env);
         if (config.allowApiKey && (process.env.ANTHROPIC_API_KEY || process.env.ANTHROPIC_AUTH_TOKEN)) {
             // Surface the billing path: default is OAuth (Claude.ai subscription); this
@@ -111,17 +112,25 @@ async function main() {
         // server only when pinned, so we no longer gate it on a local flag.
         const platformModelOverride = deriveModelIsPin(platformDefaults, me.agent_profile);
         const resolvedModel = resolveRuntimeModel(platformModelOverride, platformDefaults.model, config.model);
+        const resolvedContextWindow = resolveRuntimeContextWindow(resolvedModel, platformDefaults, activeLLMSource);
+        const resolvedMaxTokens = resolveRuntimeMaxTokens(resolvedModel, platformDefaults, activeLLMSource);
         const resolvedEffort = platformDefaults.thinkingEffort ??
             (process.env.CLAUDE_CODE_EFFORT_LEVEL?.trim() || undefined);
         if (platformDefaults.model)
             agentLog.info(`platform config: model=${platformDefaults.model} → resolved=${resolvedModel ?? 'cli-default'} (${platformModelOverride ? 'pin/override' : 'floor'})`);
         if (platformDefaults.thinkingEffort)
             agentLog.info(`platform config: thinking_effort=${platformDefaults.thinkingEffort}`);
+        if (resolvedContextWindow)
+            agentLog.info(`platform config: context_window=${resolvedContextWindow}`);
+        if (resolvedMaxTokens)
+            agentLog.info(`platform config: max_tokens=${resolvedMaxTokens}`);
         const adapter = new ClaudeCodeAdapter({
             claudeBin: config.claudeBin,
             claudeHome: config.claudeHome,
             workspaceDir: config.workspaceDir,
             model: resolvedModel,
+            contextWindow: resolvedContextWindow,
+            maxTokens: resolvedMaxTokens,
             permissionMode: config.permissionMode,
             allowedTools: config.allowedTools,
             disallowedTools: config.disallowedTools,
@@ -170,8 +179,11 @@ async function main() {
             }
             const isPin = deriveModelIsPin(updated, lastKnownAgentProfile);
             const localEffort = process.env.CLAUDE_CODE_EFFORT_LEVEL?.trim() || null;
+            const model = resolveRuntimeModel(isPin, updated.model, config.model) ?? null;
             adapter.updateConfig({
-                model: resolveRuntimeModel(isPin, updated.model, config.model) ?? null,
+                model,
+                contextWindow: resolveRuntimeContextWindow(model, updated, activeLLMSource) ?? null,
+                maxTokens: resolveRuntimeMaxTokens(model, updated, activeLLMSource) ?? null,
                 effort: updated.thinkingEffort ?? localEffort,
             });
             // Channel capabilities heat-update with the config: re-materialize the

package/dist/spawn-env.d.ts

@@ -0,0 +1,10 @@
+import type { DispatchOpts } from '@parall/agent-core';
+export declare function buildSpawnEnv(parentEnv: NodeJS.ProcessEnv, claudeHome: string, context: DispatchOpts['context'], opts: {
+    allowApiKey: boolean;
+    contextWindow?: number;
+    maxTokens?: number;
+    effortLevel?: string;
+    wikiMountRoot?: string;
+    capabilityBinDir?: string;
+}): NodeJS.ProcessEnv;
+//# sourceMappingURL=spawn-env.d.ts.map

package/dist/spawn-env.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spawn-env.d.ts","sourceRoot":"","sources":["../src/spawn-env.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAEvD,wBAAgB,aAAa,CAC3B,SAAS,EAAE,MAAM,CAAC,UAAU,EAC5B,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,YAAY,CAAC,SAAS,CAAC,EAChC,IAAI,EAAE;IACJ,WAAW,EAAE,OAAO,CAAC;IACrB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B,GACA,MAAM,CAAC,UAAU,CAiFnB"}

package/dist/spawn-env.js

@@ -0,0 +1,78 @@
+import * as path from 'node:path';
+export function buildSpawnEnv(parentEnv, claudeHome, context, opts) {
+    const env = { ...parentEnv };
+    if (!opts.allowApiKey) {
+        delete env.ANTHROPIC_API_KEY;
+        delete env.ANTHROPIC_AUTH_TOKEN;
+    }
+    const result = {
+        ...env,
+        HOME: claudeHome,
+        PRLL_API_URL: context.apiUrl,
+        PRLL_API_KEY: context.apiKey,
+        PRLL_ORG_ID: context.orgId,
+        PRLL_SESSION_ID: context.sessionId ?? '',
+        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 ?? '',
+        // Per-lane dispatch context directory (stable for the bridge's lifetime,
+        // so pinning it at spawn is safe even for long-lived subprocesses). The
+        // CLI keys into it by send target to derive dispatch effect keys.
+        PRLL_CONTEXT_DIR: context.contextDirPath ?? '',
+    };
+    // Pin the wiki workspace to the agent workspace (same convention as the
+    // OpenClaw runtime). Without this, `parall wiki` resolves mounts relative
+    // to the subprocess cwd — a `cd` into any subdirectory would silently
+    // split the agent across two wiki workspaces. Operator-set env wins.
+    if (!result.PRLL_WIKI_MOUNT_ROOT?.trim() && opts.wikiMountRoot) {
+        result.PRLL_WIKI_MOUNT_ROOT = opts.wikiMountRoot;
+    }
+    if (opts.effortLevel) {
+        result.CLAUDE_CODE_EFFORT_LEVEL = opts.effortLevel;
+    }
+    if (typeof opts.contextWindow === 'number' &&
+        Number.isSafeInteger(opts.contextWindow) &&
+        opts.contextWindow > 0) {
+        // Claude Code otherwise assumes 200k for an unrecognized model ID.
+        //
+        // Declared as the model's INPUT budget (context_window - max_tokens; both
+        // raw catalog facts), not the full window. The upstream validates
+        // input + max_tokens <= context_window, while the CLI requests up to its
+        // own output default (32k) yet reserves at most 20k below this declared
+        // boundary before auto-compacting (2.1.251) — so a session declared the
+        // full window can grow into a band the provider already rejects but the
+        // CLI still considers legal: it retries forever, auto-compact never
+        // fires, and once past the boundary the compaction call itself is
+        // over-limit (the ParallSRE 08-31 lockup). Subtracting the catalog
+        // max_tokens keeps the compaction trigger strictly inside what the
+        // provider accepts.
+        let inputBudget = opts.contextWindow;
+        if (typeof opts.maxTokens === 'number' &&
+            Number.isSafeInteger(opts.maxTokens) &&
+            opts.maxTokens > 0 &&
+            opts.maxTokens < opts.contextWindow) {
+            inputBudget = opts.contextWindow - opts.maxTokens;
+        }
+        result.CLAUDE_CODE_MAX_CONTEXT_TOKENS = String(inputBudget);
+    }
+    // Channel-capability shims resolve ahead of any globally-installed CLI of
+    // the same name (the shim owns auth; the real binary is found further down
+    // the PATH by the shim itself). On Windows env keys are case-insensitive and
+    // the host key is usually `Path`; after the plain-object spread a literal
+    // `PATH` write would SPLIT the key (undefined which wins in the child), so
+    // reuse the parent's casing. On POSIX keys are case-SENSITIVE — `PATH` is
+    // the real one and a stray `Path` is unrelated, so match exactly there or we
+    // could prepend to the wrong variable and silently bypass the shim.
+    if (opts.capabilityBinDir) {
+        const pathKey = process.platform === 'win32'
+            ? (Object.keys(result).find((k) => k.toUpperCase() === 'PATH') ?? 'PATH')
+            : 'PATH';
+        const existing = result[pathKey];
+        result[pathKey] = existing
+            ? `${opts.capabilityBinDir}${path.delimiter}${existing}`
+            : opts.capabilityBinDir;
+    }
+    return result;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@parall/claude-agent",
-  "version": "1.57.2",
+  "version": "1.58.1",
   "description": "Claude Code bridge runtime for self-hosted Parall agents",
   "license": "MIT",
   "repository": {
@@ -25,9 +25,9 @@
     "src"
   ],
   "dependencies": {
-    "@parall/agent-core": "1.57.2",
-    "@parall/sdk": "1.57.2",
-    "@parall/cli": "1.57.2"
+    "@parall/cli": "1.58.1",
+    "@parall/agent-core": "1.58.1",
+    "@parall/sdk": "1.58.1"
   },
   "devDependencies": {
     "@types/node": "^22.0.0",

package/src/dispatch.ts

@@ -1,11 +1,7 @@
+import { execSync, spawn } from 'node:child_process';
+import { randomUUID } from 'node:crypto';
 import * as fs from 'node:fs';
 import * as path from 'node:path';
-import { randomUUID } from 'node:crypto';
-import { execSync, spawn } from 'node:child_process';
-import {
-  appendPreparedLocalAttachmentRefs,
-  pinLocalAttachmentPaths,
-} from '@parall/agent-core/internal/attachment-input';
 import type {
   CleanupForkOpts,
   DispatchAdapter,
@@ -15,16 +11,23 @@ import type {
   GatewayLogger,
   RuntimeEvent,
 } from '@parall/agent-core';
+import {
+  appendPreparedLocalAttachmentRefs,
+  pinLocalAttachmentPaths,
+} from '@parall/agent-core/internal/attachment-input';
 import type { ClaudeAgentConfig } from './config.js';
-import { ClaudeInputRegistry, type ClaudeInputDelivery } from './input-lifecycle.js';
+import { type ClaudeInputDelivery, ClaudeInputRegistry } from './input-lifecycle.js';
 import {
-  parseClaudeStreamJson,
   type ClaudeParsedEvent,
   type ClaudeResultMeta,
+  parseClaudeStreamJson,
 } from './output-parser.js';
 import type { ClaudeProcessHandle, ClaudeSessionManager } from './session-manager.js';
+import { buildSpawnEnv } from './spawn-env.js';
 import { classifyClaudeTurn } from './turn-outcome.js';
 
+export { buildSpawnEnv };
+
 type ClaudeCodeAdapterOptions = Pick<
   ClaudeAgentConfig,
   | 'additionalDirs'
@@ -42,6 +45,10 @@ type ClaudeCodeAdapterOptions = Pick<
   apiUrl: string;
   apiKey: string;
   orgId: string;
+  /** Catalog context size for the selected model. */
+  contextWindow?: number;
+  /** Catalog max output tokens for the selected model (input-budget subtrahend). */
+  maxTokens?: number;
   contextFilePathForSession?: (sessionKey: string) => string;
   /** @deprecated Use contextFilePathForSession. */
   stepIdFilePathForSession?: (sessionKey: string) => string;
@@ -83,70 +90,6 @@ function killWin32Tree(pid: number): boolean {
   }
 }
 
-export function buildSpawnEnv(
-  parentEnv: NodeJS.ProcessEnv,
-  claudeHome: string,
-  context: DispatchOpts['context'],
-  opts: {
-    allowApiKey: boolean;
-    effortLevel?: string;
-    wikiMountRoot?: string;
-    capabilityBinDir?: string;
-  },
-): NodeJS.ProcessEnv {
-  const env: NodeJS.ProcessEnv = { ...parentEnv };
-  if (!opts.allowApiKey) {
-    delete env.ANTHROPIC_API_KEY;
-    delete env.ANTHROPIC_AUTH_TOKEN;
-  }
-  const result: NodeJS.ProcessEnv = {
-    ...env,
-    HOME: claudeHome,
-    PRLL_API_URL: context.apiUrl,
-    PRLL_API_KEY: context.apiKey,
-    PRLL_ORG_ID: context.orgId,
-    PRLL_SESSION_ID: context.sessionId ?? '',
-    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 ?? '',
-    // Per-lane dispatch context directory (stable for the bridge's lifetime,
-    // so pinning it at spawn is safe even for long-lived subprocesses). The
-    // CLI keys into it by send target to derive dispatch effect keys.
-    PRLL_CONTEXT_DIR: context.contextDirPath ?? '',
-  };
-  // Pin the wiki workspace to the agent workspace (same convention as the
-  // OpenClaw runtime). Without this, `parall wiki` resolves mounts relative
-  // to the subprocess cwd — a `cd` into any subdirectory would silently
-  // split the agent across two wiki workspaces. Operator-set env wins.
-  if (!result.PRLL_WIKI_MOUNT_ROOT?.trim() && opts.wikiMountRoot) {
-    result.PRLL_WIKI_MOUNT_ROOT = opts.wikiMountRoot;
-  }
-  if (opts.effortLevel) {
-    result.CLAUDE_CODE_EFFORT_LEVEL = opts.effortLevel;
-  }
-  // Channel-capability shims resolve ahead of any globally-installed CLI of
-  // the same name (the shim owns auth; the real binary is found further down
-  // the PATH by the shim itself). On Windows env keys are case-insensitive and
-  // the host key is usually `Path`; after the plain-object spread a literal
-  // `PATH` write would SPLIT the key (undefined which wins in the child), so
-  // reuse the parent's casing. On POSIX keys are case-SENSITIVE — `PATH` is
-  // the real one and a stray `Path` is unrelated, so match exactly there or we
-  // could prepend to the wrong variable and silently bypass the shim.
-  if (opts.capabilityBinDir) {
-    const pathKey =
-      process.platform === 'win32'
-        ? (Object.keys(result).find((k) => k.toUpperCase() === 'PATH') ?? 'PATH')
-        : 'PATH';
-    const existing = result[pathKey];
-    result[pathKey] = existing
-      ? `${opts.capabilityBinDir}${path.delimiter}${existing}`
-      : opts.capabilityBinDir;
-  }
-  return result;
-}
-
 /**
  * Per-sessionKey long-lived process state. The process stays alive across
  * dispatches; each dispatch writes one NDJSON user message to stdin and
@@ -171,9 +114,13 @@ export class ClaudeCodeAdapter implements DispatchAdapter {
   private shuttingDown = false;
   private _model: string | undefined;
   private _effortLevel: string | undefined;
+  private _contextWindow: number | undefined;
+  private _maxTokens: number | undefined;
 
   constructor(private readonly opts: ClaudeCodeAdapterOptions) {
     this._model = opts.model;
+    this._contextWindow = opts.contextWindow;
+    this._maxTokens = opts.maxTokens;
   }
 
   get currentModel(): string | undefined {
@@ -182,13 +129,22 @@ export class ClaudeCodeAdapter implements DispatchAdapter {
   get currentEffort(): string | undefined {
     return this._effortLevel;
   }
-
-  updateConfig(config: { model?: string | null; effort?: string | null }): void {
+  updateConfig(config: {
+    model?: string | null;
+    effort?: string | null;
+    contextWindow?: number | null;
+    maxTokens?: number | null;
+  }): void {
     const modelChanged = config.model !== undefined && config.model !== this._model;
     const effortChanged = config.effort !== undefined && config.effort !== this._effortLevel;
+    const contextWindowChanged =
+      config.contextWindow !== undefined && config.contextWindow !== this._contextWindow;
+    const maxTokensChanged = config.maxTokens !== undefined && config.maxTokens !== this._maxTokens;
     if (modelChanged) this._model = config.model ?? undefined;
     if (effortChanged) this._effortLevel = config.effort ?? undefined;
-    if (modelChanged || effortChanged) {
+    if (contextWindowChanged) this._contextWindow = config.contextWindow ?? undefined;
+    if (maxTokensChanged) this._maxTokens = config.maxTokens ?? undefined;
+    if (modelChanged || effortChanged || contextWindowChanged || maxTokensChanged) {
       this.requestProcessRestart();
     }
   }
@@ -714,6 +670,8 @@ export class ClaudeCodeAdapter implements DispatchAdapter {
       this.buildPlaceholderContext(sessionKey),
       {
         allowApiKey: this.opts.allowApiKey,
+        contextWindow: this._contextWindow,
+        maxTokens: this._maxTokens,
         effortLevel: this._effortLevel,
         wikiMountRoot: this.opts.workspaceDir,
         capabilityBinDir: this.opts.capabilityBinDir,
@@ -721,7 +679,7 @@ export class ClaudeCodeAdapter implements DispatchAdapter {
     );
 
     log?.info(
-      `spawn long-lived ${this.opts.claudeBin} (session ${sessionKey}, model=${this._model || 'default'}, effort=${this._effortLevel || 'default'}, mode=${this.opts.permissionMode})`,
+      `spawn long-lived ${this.opts.claudeBin} (session ${sessionKey}, model=${this._model || 'default'}, context=${this._contextWindow || 'cli-default'}, maxOut=${this._maxTokens || 'cli-default'}, effort=${this._effortLevel || 'default'}, mode=${this.opts.permissionMode})`,
     );
 
     const proc = spawn(

package/src/index.ts

@@ -2,24 +2,26 @@
 
 import * as os from 'node:os';
 import {
-  ParallAgentGateway,
   capabilityBinDir,
+  childLogger,
+  clearAllProviderCreds,
   configureHttpKeepAlive,
-  createPlatformConfigManager,
   createLogger,
   createOtelLogger,
-  childLogger,
+  createPlatformConfigManager,
   deriveModelIsPin,
+  identityFromMe,
+  initAgentTelemetry,
+  llmSource,
   materializeChannelCapabilities,
-  resolveRuntimeModel,
-  parseShutdownDeadlineMs,
-  parseForkDeadlineMs,
+  ParallAgentGateway,
   parseDispatchDeadlineMs,
+  parseForkDeadlineMs,
   parseProviderConfig,
-  clearAllProviderCreds,
-  llmSource,
-  identityFromMe,
-  initAgentTelemetry,
+  parseShutdownDeadlineMs,
+  resolveRuntimeContextWindow,
+  resolveRuntimeMaxTokens,
+  resolveRuntimeModel,
 } from '@parall/agent-core';
 import { ApiError, ParallClient, ParallWs } from '@parall/sdk';
 import {
@@ -52,11 +54,11 @@ async function getAgentMeWithLegacyFallback(client: ParallClient, orgId: string)
 
 type AgentMe = Awaited<ReturnType<typeof getAgentMeWithLegacyFallback>>;
 
-function resolveProviderEnv(): void {
+function resolveProviderEnv(): string {
   const pc = parseProviderConfig(process.env);
-  if (!pc) return;
-  clearAllProviderCreds(process.env);
   const source = llmSource(pc);
+  if (!pc) return source;
+  clearAllProviderCreds(process.env);
   if (source === 'parall') {
     process.env.ANTHROPIC_AUTH_TOKEN = process.env.PRLL_API_KEY;
     process.env.ANTHROPIC_BASE_URL = `${process.env.PRLL_API_URL}/api/llm`;
@@ -68,6 +70,7 @@ function resolveProviderEnv(): void {
     }
     if (pc.anthropic_base_url) process.env.ANTHROPIC_BASE_URL = pc.anthropic_base_url;
   }
+  return source;
 }
 
 async function main() {
@@ -76,7 +79,7 @@ async function main() {
   const telemetry = await initAgentTelemetry('parall-claude-agent', 'claude-code');
   activeLog = createOtelLogger('agent', 'claude-agent');
   try {
-    resolveProviderEnv();
+    const activeLLMSource = resolveProviderEnv();
     const config = resolveClaudeAgentConfig(process.env);
 
     if (config.allowApiKey && (process.env.ANTHROPIC_API_KEY || process.env.ANTHROPIC_AUTH_TOKEN)) {
@@ -152,6 +155,16 @@ async function main() {
       platformDefaults.model,
       config.model,
     );
+    const resolvedContextWindow = resolveRuntimeContextWindow(
+      resolvedModel,
+      platformDefaults,
+      activeLLMSource,
+    );
+    const resolvedMaxTokens = resolveRuntimeMaxTokens(
+      resolvedModel,
+      platformDefaults,
+      activeLLMSource,
+    );
     const resolvedEffort =
       platformDefaults.thinkingEffort ??
       (process.env.CLAUDE_CODE_EFFORT_LEVEL?.trim() || undefined);
@@ -161,12 +174,17 @@ async function main() {
       );
     if (platformDefaults.thinkingEffort)
       agentLog.info(`platform config: thinking_effort=${platformDefaults.thinkingEffort}`);
+    if (resolvedContextWindow)
+      agentLog.info(`platform config: context_window=${resolvedContextWindow}`);
+    if (resolvedMaxTokens) agentLog.info(`platform config: max_tokens=${resolvedMaxTokens}`);
 
     const adapter = new ClaudeCodeAdapter({
       claudeBin: config.claudeBin,
       claudeHome: config.claudeHome,
       workspaceDir: config.workspaceDir,
       model: resolvedModel,
+      contextWindow: resolvedContextWindow,
+      maxTokens: resolvedMaxTokens,
       permissionMode: config.permissionMode,
       allowedTools: config.allowedTools,
       disallowedTools: config.disallowedTools,
@@ -219,8 +237,11 @@ async function main() {
       }
       const isPin = deriveModelIsPin(updated, lastKnownAgentProfile);
       const localEffort = process.env.CLAUDE_CODE_EFFORT_LEVEL?.trim() || null;
+      const model = resolveRuntimeModel(isPin, updated.model, config.model) ?? null;
       adapter.updateConfig({
-        model: resolveRuntimeModel(isPin, updated.model, config.model) ?? null,
+        model,
+        contextWindow: resolveRuntimeContextWindow(model, updated, activeLLMSource) ?? null,
+        maxTokens: resolveRuntimeMaxTokens(model, updated, activeLLMSource) ?? null,
         effort: updated.thinkingEffort ?? localEffort,
       });
       // Channel capabilities heat-update with the config: re-materialize the

package/src/spawn-env.ts

@@ -0,0 +1,97 @@
+import * as path from 'node:path';
+import type { DispatchOpts } from '@parall/agent-core';
+
+export function buildSpawnEnv(
+  parentEnv: NodeJS.ProcessEnv,
+  claudeHome: string,
+  context: DispatchOpts['context'],
+  opts: {
+    allowApiKey: boolean;
+    contextWindow?: number;
+    maxTokens?: number;
+    effortLevel?: string;
+    wikiMountRoot?: string;
+    capabilityBinDir?: string;
+  },
+): NodeJS.ProcessEnv {
+  const env: NodeJS.ProcessEnv = { ...parentEnv };
+  if (!opts.allowApiKey) {
+    delete env.ANTHROPIC_API_KEY;
+    delete env.ANTHROPIC_AUTH_TOKEN;
+  }
+  const result: NodeJS.ProcessEnv = {
+    ...env,
+    HOME: claudeHome,
+    PRLL_API_URL: context.apiUrl,
+    PRLL_API_KEY: context.apiKey,
+    PRLL_ORG_ID: context.orgId,
+    PRLL_SESSION_ID: context.sessionId ?? '',
+    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 ?? '',
+    // Per-lane dispatch context directory (stable for the bridge's lifetime,
+    // so pinning it at spawn is safe even for long-lived subprocesses). The
+    // CLI keys into it by send target to derive dispatch effect keys.
+    PRLL_CONTEXT_DIR: context.contextDirPath ?? '',
+  };
+  // Pin the wiki workspace to the agent workspace (same convention as the
+  // OpenClaw runtime). Without this, `parall wiki` resolves mounts relative
+  // to the subprocess cwd — a `cd` into any subdirectory would silently
+  // split the agent across two wiki workspaces. Operator-set env wins.
+  if (!result.PRLL_WIKI_MOUNT_ROOT?.trim() && opts.wikiMountRoot) {
+    result.PRLL_WIKI_MOUNT_ROOT = opts.wikiMountRoot;
+  }
+  if (opts.effortLevel) {
+    result.CLAUDE_CODE_EFFORT_LEVEL = opts.effortLevel;
+  }
+  if (
+    typeof opts.contextWindow === 'number' &&
+    Number.isSafeInteger(opts.contextWindow) &&
+    opts.contextWindow > 0
+  ) {
+    // Claude Code otherwise assumes 200k for an unrecognized model ID.
+    //
+    // Declared as the model's INPUT budget (context_window - max_tokens; both
+    // raw catalog facts), not the full window. The upstream validates
+    // input + max_tokens <= context_window, while the CLI requests up to its
+    // own output default (32k) yet reserves at most 20k below this declared
+    // boundary before auto-compacting (2.1.251) — so a session declared the
+    // full window can grow into a band the provider already rejects but the
+    // CLI still considers legal: it retries forever, auto-compact never
+    // fires, and once past the boundary the compaction call itself is
+    // over-limit (the ParallSRE 08-31 lockup). Subtracting the catalog
+    // max_tokens keeps the compaction trigger strictly inside what the
+    // provider accepts.
+    let inputBudget = opts.contextWindow;
+    if (
+      typeof opts.maxTokens === 'number' &&
+      Number.isSafeInteger(opts.maxTokens) &&
+      opts.maxTokens > 0 &&
+      opts.maxTokens < opts.contextWindow
+    ) {
+      inputBudget = opts.contextWindow - opts.maxTokens;
+    }
+    result.CLAUDE_CODE_MAX_CONTEXT_TOKENS = String(inputBudget);
+  }
+  // Channel-capability shims resolve ahead of any globally-installed CLI of
+  // the same name (the shim owns auth; the real binary is found further down
+  // the PATH by the shim itself). On Windows env keys are case-insensitive and
+  // the host key is usually `Path`; after the plain-object spread a literal
+  // `PATH` write would SPLIT the key (undefined which wins in the child), so
+  // reuse the parent's casing. On POSIX keys are case-SENSITIVE — `PATH` is
+  // the real one and a stray `Path` is unrelated, so match exactly there or we
+  // could prepend to the wrong variable and silently bypass the shim.
+  if (opts.capabilityBinDir) {
+    const pathKey =
+      process.platform === 'win32'
+        ? (Object.keys(result).find((k) => k.toUpperCase() === 'PATH') ?? 'PATH')
+        : 'PATH';
+    const existing = result[pathKey];
+    result[pathKey] = existing
+      ? `${opts.capabilityBinDir}${path.delimiter}${existing}`
+      : opts.capabilityBinDir;
+  }
+  return result;
+}