paperclipai/paperclip · error

AWS AgentCore runner transport requires a qualified AgentCor

Error message

AWS AgentCore runner transport requires a qualified AgentCore profile

What it means

Guard in the runnerd AWS AgentCore transport: when the provider is aws_agentcore, this.options.agentCoreProfile must contain a qualified AgentCore profile; if missing, the transport throws because it cannot resolve the harness/endpoint/memory ARNs needed to invoke AgentCore. Indicates runnerd lacks the remote-agent profile while an assignment selected aws_agentcore.

Source

Thrown at packages/paperclip-runner/src/live/runnerd-codex-transport.ts:4308

        ? resolveQualifiedAcpxProfile(acpxAgent!, requestedModel)
        : null;
    const managedProfile = this.options.managedProfile;
    const agentCoreProfile = this.options.agentCoreProfile;
    if (provider === "claude_managed") {
      if (!managedProfile) {
        throw new Error(
          "Claude Managed runner transport requires a qualified managed profile",
        );
      }
      if (requestedModel !== managedProfile.model) {
        throw new Error(
          "Claude Managed requested model does not match its qualified profile",
        );
      }
    }
    if (provider === "aws_agentcore") {
      if (!agentCoreProfile) {
        throw new Error(
          "AWS AgentCore runner transport requires a qualified AgentCore profile",
        );
      }
      if (requestedModel !== agentCoreProfile.model) {
        throw new Error(
          "AWS AgentCore requested model does not match its qualified profile",
        );
      }
    }
    const completionContract = record(params.completionContract);
    const runAttachTemplate = {
      authorizedTools: this.#authorizedTools,
      ...(completionContract.revision &&
      Array.isArray(completionContract.criterionIds)
        ? { completionContract }
        : {}),
      provider:
        provider === "acpx"

View on GitHub (pinned to 01ad858492)

Solutions

1. Start/reconfigure runnerd with a qualified agentCoreProfile in its options.
2. Gate aws_agentcore assignments on AgentCore profile availability.
3. Switch the assignment to a locally-backed provider until the AgentCore profile is provisioned.

When it happens

Trigger: Thrown at packages/paperclip-runner/src/live/runnerd-codex-transport.ts:1736 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/0bbc8a42dc7b85b9. Report an issue: GitHub.