paperclipai/paperclip · error · PaperclipRunnerProviderProfileError

paperclip_runner_acpx_agent_unavailable

paperclip_runner_acpx_agent_unavailable

Error message

Paperclip Runner ACPX requires the qualified Claude or Codex agent profile; Pi is not available.

What it means

Guard in resolvePaperclipRunnerProviderProfile for the ACPX branch: config.acpxAgent must be 'claude' or 'codex'; anything else (notably 'pi' or unsupported agents) throws 'paperclip_runner_acpx_agent_unavailable'. Only the qualified Claude and Codex ACPX profiles exist — Pi and other agents are not available through Paperclip Runner.

Source

Thrown at server/src/services/native-runtime/provider-profile.ts:408

        `The AWS AgentCore profile requires exact model ${AGENTCORE_QUALIFIED_MODEL}.`,
      );
    }
    return {
      provider: "aws_agentcore",
      backend: "aws_agentcore_harness_api",
      agentCoreProfileId,
      model,
      maxEstimatedSessionCostUsd: positiveNumberOrNull(
        config.maxEstimatedSessionCostUsd,
        "paperclip_runner_aws_agentcore_spend_cap_invalid",
        "Paperclip Runner AWS AgentCore requires a positive estimated session spend ceiling when overridden.",
      ),
    };
  }

  const acpxAgent = config.acpxAgent ?? "claude";
  if (acpxAgent !== "claude" && acpxAgent !== "codex") {
    throw new PaperclipRunnerProviderProfileError(
      "paperclip_runner_acpx_agent_unavailable",
      "Paperclip Runner ACPX requires the qualified Claude or Codex agent profile; Pi is not available.",
    );
  }
  const qualifiedModel = QUALIFIED_ACPX_RUNNER_MODELS[acpxAgent];
  if (acpxAgent === "codex" && model !== qualifiedModel) {
    throw new PaperclipRunnerProviderProfileError(
      "paperclip_runner_acpx_model_unqualified",
      `Paperclip Runner ACPX ${acpxAgent} requires exact model ${qualifiedModel}.`,
    );
  }
  return {
    provider: "acpx",
    backend: "acpx_runtime",
    model: model || qualifiedModel,
    acpxAgent,
  };
}

View on GitHub (pinned to 01ad858492)

Solutions

1. Set acpxAgent to 'claude' or 'codex'.
2. Remove the acpxAgent override to select a default qualified agent.
3. Choose a different provider if a non-ACPX agent is required.

When it happens

Trigger: Thrown at server/src/services/native-runtime/provider-profile.ts:402 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of paperclipai/paperclip@01ad858492 (2026-09-10). Data as JSON: /api/errors/1c6c7382ee23bf7e. Report an issue: GitHub.