paperclipai/paperclip · error

AWS AgentCore requested model does not match its qualified p

Error message

AWS AgentCore requested model does not match its qualified profile

What it means

Guard in the runnerd AWS AgentCore transport: the requested model must exactly match agentCoreProfile's qualified model; a mismatch throws because the AgentCore harness is versioned for one specific model. Usually caused by adapter config drift or a profile re-qualification after the run was created.

Source

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

      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"
          ? {
              kind: "acpx",
              provider: "acpx",
              driver: "acpx_runtime",
              providerVersion: acpxProfile!.acpxVersion,

View on GitHub (pinned to 01ad858492)

Solutions

  1. Align the requested model with the AgentCore profile's qualified model.
  2. Re-qualify the AgentCore profile for the newly requested model before retrying.
  3. Remove stale model overrides from adapterConfig.
Defensive patterns

Strategy: validation

When it happens

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