paperclipai/paperclip · error · PaperclipRunnerProviderProfileError

paperclip_runner_claude_managed_model_unqualified

paperclip_runner_claude_managed_model_unqualified

Error message

The Claude Managed profile requires exact model ${CLAUDE_MANAGED_QUALIFIED_MODEL}.

What it means

Guard in resolvePaperclipRunnerProviderProfile for claude_managed: the resolved model must equal CLAUDE_MANAGED_QUALIFIED_MODEL exactly, else the error naming the exact required model is thrown. The managed-agents profile is qualified against one specific model version, so any other model string would run unqualified.

Source

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

    };
  }

  if (candidate === "claude_managed") {
    const managedProfileId = optionalString(config.managedProfileId);
    if (!managedProfileId) {
      throw new PaperclipRunnerProviderProfileError(
        "paperclip_runner_claude_managed_profile_required",
        "Paperclip Runner Claude Managed requires a company managed-agent profile.",
      );
    }
    if (config.managedAgentsRetentionAcknowledged !== true) {
      throw new PaperclipRunnerProviderProfileError(
        "paperclip_runner_claude_managed_retention_required",
        "Paperclip Runner Claude Managed requires acknowledgement of stateful beta retention.",
      );
    }
    if (model !== null && model !== CLAUDE_MANAGED_QUALIFIED_MODEL) {
      throw new PaperclipRunnerProviderProfileError(
        "paperclip_runner_claude_managed_model_unqualified",
        `The Claude Managed profile requires exact model ${CLAUDE_MANAGED_QUALIFIED_MODEL}.`,
      );
    }
    return {
      provider: "claude_managed",
      backend: "claude_managed_agents_api",
      managedProfileId,
      model,
      maxSessionListCostUsd: positiveNumberOrNull(
        config.maxSessionListCostUsd,
        "paperclip_runner_claude_managed_spend_cap_invalid",
        "Paperclip Runner Claude Managed requires a positive session spend ceiling when overridden.",
      ),
    };
  }

  if (candidate === "aws_agentcore") {

View on GitHub (pinned to 01ad858492)

Solutions

1. Set adapterConfig.model to the exact qualified model named in the error message.
2. Remove the model override so the profile's default qualified model applies.
3. Re-qualify the managed profile if a different model version is required.

When it happens

Trigger: Thrown at server/src/services/native-runtime/provider-profile.ts:349 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/235de10e1b8bb2bc. Report an issue: GitHub.