{"record":{"id":"1c6c7382ee23bf7e","repo":"paperclipai/paperclip","slug":"paperclip-runner-acpx-agent-unavailable","errorCode":"paperclip_runner_acpx_agent_unavailable","errorMessage":"Paperclip Runner ACPX requires the qualified Claude or Codex agent profile; Pi is not available.","messagePattern":"Paperclip Runner ACPX requires the qualified Claude or Codex agent profile; Pi is not available\\.","errorType":"error_code","errorClass":"PaperclipRunnerProviderProfileError","httpStatus":null,"severity":"error","filePath":"server/src/services/native-runtime/provider-profile.ts","lineNumber":408,"sourceCode":"        `The AWS AgentCore profile requires exact model ${AGENTCORE_QUALIFIED_MODEL}.`,\n      );\n    }\n    return {\n      provider: \"aws_agentcore\",\n      backend: \"aws_agentcore_harness_api\",\n      agentCoreProfileId,\n      model,\n      maxEstimatedSessionCostUsd: positiveNumberOrNull(\n        config.maxEstimatedSessionCostUsd,\n        \"paperclip_runner_aws_agentcore_spend_cap_invalid\",\n        \"Paperclip Runner AWS AgentCore requires a positive estimated session spend ceiling when overridden.\",\n      ),\n    };\n  }\n\n  const acpxAgent = config.acpxAgent ?? \"claude\";\n  if (acpxAgent !== \"claude\" && acpxAgent !== \"codex\") {\n    throw new PaperclipRunnerProviderProfileError(\n      \"paperclip_runner_acpx_agent_unavailable\",\n      \"Paperclip Runner ACPX requires the qualified Claude or Codex agent profile; Pi is not available.\",\n    );\n  }\n  const qualifiedModel = QUALIFIED_ACPX_RUNNER_MODELS[acpxAgent];\n  if (acpxAgent === \"codex\" && model !== qualifiedModel) {\n    throw new PaperclipRunnerProviderProfileError(\n      \"paperclip_runner_acpx_model_unqualified\",\n      `Paperclip Runner ACPX ${acpxAgent} requires exact model ${qualifiedModel}.`,\n    );\n  }\n  return {\n    provider: \"acpx\",\n    backend: \"acpx_runtime\",\n    model: model || qualifiedModel,\n    acpxAgent,\n  };\n}","sourceCodeStart":390,"sourceCodeEnd":426,"githubUrl":"https://github.com/paperclipai/paperclip/blob/01ad8584922b5d85292b1723cae71fa0d9b07a19/server/src/services/native-runtime/provider-profile.ts#L390-L426","documentation":"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.","triggerScenarios":"Thrown at server/src/services/native-runtime/provider-profile.ts:402 when the library encounters an invalid state.","commonSituations":"See trigger scenarios.","solutions":["Set acpxAgent to 'claude' or 'codex'.","Remove the acpxAgent override to select a default qualified agent.","Choose a different provider if a non-ACPX agent is required."],"exampleFix":null,"handlingStrategy":"validation","validationCode":null,"typeGuard":null,"tryCatchPattern":null,"preventionTips":[],"tags":[],"backgroundTag":null,"analyzedSha":"01ad8584922b5d85292b1723cae71fa0d9b07a19","analyzedAt":"2026-09-10T03:14:50.855Z","contentChangedAt":"2026-09-10T03:14:50.855Z","schemaVersion":2},"datasetVersion":"2026-09-14T05:17:10.506Z"}