{"record":{"id":"ea8f97ec6d8a6da4","repo":"paperclipai/paperclip","slug":"paperclip-runner-claude-managed-profile-required","errorCode":"paperclip_runner_claude_managed_profile_required","errorMessage":"Paperclip Runner Claude Managed requires a company managed-agent profile.","messagePattern":"Paperclip Runner Claude Managed requires a company managed-agent profile\\.","errorType":"error_code","errorClass":"PaperclipRunnerProviderProfileError","httpStatus":null,"severity":"error","filePath":"server/src/services/native-runtime/provider-profile.ts","lineNumber":343,"sourceCode":"\n  if (candidate === \"opencode\") {\n    if (!model || !model.includes(\"/\") || model.endsWith(\"/\")) {\n      throw new PaperclipRunnerProviderProfileError(\n        \"paperclip_runner_opencode_model_invalid\",\n        \"Paperclip Runner OpenCode requires model in provider/model form.\",\n      );\n    }\n    return {\n      provider: \"opencode\",\n      backend: \"opencode_server\",\n      model,\n    };\n  }\n\n  if (candidate === \"claude_managed\") {\n    const managedProfileId = optionalString(config.managedProfileId);\n    if (!managedProfileId) {\n      throw new PaperclipRunnerProviderProfileError(\n        \"paperclip_runner_claude_managed_profile_required\",\n        \"Paperclip Runner Claude Managed requires a company managed-agent profile.\",\n      );\n    }\n    if (config.managedAgentsRetentionAcknowledged !== true) {\n      throw new PaperclipRunnerProviderProfileError(\n        \"paperclip_runner_claude_managed_retention_required\",\n        \"Paperclip Runner Claude Managed requires acknowledgement of stateful beta retention.\",\n      );\n    }\n    if (model !== null && model !== CLAUDE_MANAGED_QUALIFIED_MODEL) {\n      throw new PaperclipRunnerProviderProfileError(\n        \"paperclip_runner_claude_managed_model_unqualified\",\n        `The Claude Managed profile requires exact model ${CLAUDE_MANAGED_QUALIFIED_MODEL}.`,\n      );\n    }\n    return {\n      provider: \"claude_managed\",","sourceCodeStart":325,"sourceCodeEnd":361,"githubUrl":"https://github.com/paperclipai/paperclip/blob/01ad8584922b5d85292b1723cae71fa0d9b07a19/server/src/services/native-runtime/provider-profile.ts#L325-L361","documentation":"Guard in resolvePaperclipRunnerProviderProfile for claude_managed: config.managedProfileId must be a non-empty string identifying the company's managed-agent profile, else 'paperclip_runner_claude_managed_profile_required' is thrown. Without a profile id the run cannot resolve the qualified managed-agent (agent id, environment, beta, secret) needed to call the managed-agents API.","triggerScenarios":"Thrown at server/src/services/native-runtime/provider-profile.ts:337 when the library encounters an invalid state.","commonSituations":"See trigger scenarios.","solutions":["Set managedProfileId in adapterConfig to the company's managed-agent profile id or profileKey.","Create/qualify a managed-agent profile for the company first, then reference it.","Choose a different provider if no Claude Managed profile exists."],"exampleFix":null,"handlingStrategy":"validation","validationCode":null,"typeGuard":null,"tryCatchPattern":null,"preventionTips":[],"tags":[],"backgroundTag":null,"analyzedSha":"01ad8584922b5d85292b1723cae71fa0d9b07a19","analyzedAt":"2026-09-02T18:44:00.616Z","contentChangedAt":"2026-09-02T18:44:00.616Z","schemaVersion":2},"datasetVersion":"2026-09-14T05:17:10.506Z"}