paperclipai/paperclip · error · PaperclipRunnerProviderProfileError

paperclip_runner_aws_agentcore_model_unqualified

paperclip_runner_aws_agentcore_model_unqualified

Error message

The AWS AgentCore profile requires exact model ${AGENTCORE_QUALIFIED_MODEL}.

What it means

Guard in resolvePaperclipRunnerProviderProfile for aws_agentcore: the model must equal AGENTCORE_QUALIFIED_MODEL exactly, else the error naming the required model is thrown. The AgentCore harness is built and qualified for a single model version, so any other model string is rejected as unqualified.

Source

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

    };
  }

  if (candidate === "aws_agentcore") {
    const agentCoreProfileId = optionalString(config.agentCoreProfileId);
    if (!agentCoreProfileId) {
      throw new PaperclipRunnerProviderProfileError(
        "paperclip_runner_aws_agentcore_profile_required",
        "Paperclip Runner AWS AgentCore requires a company remote-agent profile.",
      );
    }
    if (config.agentCoreRetentionAcknowledged !== true) {
      throw new PaperclipRunnerProviderProfileError(
        "paperclip_runner_aws_agentcore_retention_required",
        "Paperclip Runner AWS AgentCore requires acknowledgement of 90-day Memory retention.",
      );
    }
    if (model !== null && model !== AGENTCORE_QUALIFIED_MODEL) {
      throw new PaperclipRunnerProviderProfileError(
        "paperclip_runner_aws_agentcore_model_unqualified",
        `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";

View on GitHub (pinned to 01ad858492)

Solutions

1. Set adapterConfig.model to the exact qualified model named in the error message.
2. Drop the model override so the profile's default applies.
3. Re-qualify the AgentCore harness for a different model before using it.

When it happens

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

Common situations: See trigger scenarios.

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