paperclipai/paperclip · error

Claude Managed runner transport requires a qualified managed

Error message

Claude Managed runner transport requires a qualified managed profile

What it means

Guard in the runnerd Claude Managed transport setup: when the provider is claude_managed, this.options.managedProfile must hold a qualified managed profile; if it is absent the transport throws because it cannot authenticate or bind sessions to Claude's managed-agents API. Typically means runnerd was started without the managed profile configured while an assignment selected claude_managed.

Source

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

    const unboundBaseInstructions = String(
      params.baseInstructions ?? "You are a Paperclip agent.",
    );
    const baseInstructions =
      sourceRuntimeContext && runtimeContext
        ? unboundBaseInstructions.replaceAll(
            sourceRuntimeContext.instructions.bundle.rootPath,
            runtimeContext.instructions.bundle.rootPath,
          )
        : unboundBaseInstructions;
    const acpxProfile =
      provider === "acpx"
        ? 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",

View on GitHub (pinned to 01ad858492)

Solutions

1. Start/reconfigure runnerd so its options include a qualified managedProfile.
2. Fix assignment resolution so claude_managed is only selected when a qualified profile exists.
3. Use a provider that needs no managed profile (codex, opencode, acpx) for this runner instance.

When it happens

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