paperclipai/paperclip · error

ACPX runtime does not expose session config controls…

Error message

ACPX runtime does not expose session config controls; upgrade ACPX or remove configured model, effort, and fast mode overrides.

What it means

Capability mismatch in the ACPX engine: session config options (model, effort, fast mode) were requested, but the connected ACPX runtime does not implement setConfigOption, so the overrides cannot be applied and the run refuses to continue with silently ignored settings; the mismatch is logged to stderr before throwing.

Solutions

  1. Upgrade ACPX to a version that exposes session config controls.
  2. Remove configured model, effort, and fast mode overrides from the agent config.
Defensive patterns

Strategy: fallback

When it happens

Trigger: Thrown at packages/adapter-utils/src/acpx-engine/execute.ts:2248 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of paperclipai/paperclip@3f1d897a7c (2026-08-18). Data as JSON: /api/errors/0a3b0c20250b2c6e. Report an issue: GitHub.

Appendix: source

Thrown at packages/adapter-utils/src/acpx-engine/execute.ts:2330

        }).workspaceHints;
        if (shapedHints.length > 0) {
          env.PAPERCLIP_WORKSPACES_JSON = JSON.stringify(shapedHints);
        }
      },
      onReuseLog: () =>
        input.ctx.onLog(
          "stdout",
          "[paperclip] Reusing the staged in-sandbox runtime for this resumed session (no workspace re-ship / managed-home re-seed).\n",
        ),
      startPaperclipBridge: (runtimeRootDir) =>
        startAdapterExecutionTargetPaperclipBridge({
          runId,
          target: { ...remoteTarget, streamRunLogs: false },
          runtimeRootDir,
          adapterKey: input.engine.adapterType,
          timeoutSec,
          hostApiToken: env.PAPERCLIP_API_KEY,
          enableSandboxDuplexBridge: adapterExecutionTargetEnablesSandboxDuplexBridge(remoteTarget),
          duplexObservabilityRecorder: adapterExecutionTargetDuplexObservabilityRecorder(remoteTarget),
          onLog: input.ctx.onLog,
          getRuntimeParentContext: input.getRuntimeParentContext,
          runtimeSpan: input.runtimeSpan,
        }),
      startProcessSessionBridge: ({ runtimeRootDir, launchEnv }) =>
        startAdapterExecutionTargetProcessSessionBridge({
          runId,
          target: remoteTarget,
          runtimeRootDir,
          adapterKey: input.engine.adapterType,
          command: "sh",
          args: ["-lc", `exec ${agentCommandShell}`],
          cwd: sessionCwd,
          env: launchEnv,
          timeoutSec,
          onLog: input.ctx.onLog,
          getRuntimeParentContext: input.getRuntimeParentContext,

View on GitHub (pinned to 3f1d897a7c)