{"record":{"id":"369ccf43a6435a2e","repo":"paperclipai/paperclip","slug":"paperclip-runner-aws-agentcore-profile-required","errorCode":"paperclip_runner_aws_agentcore_profile_required","errorMessage":"Paperclip Runner AWS AgentCore requires a company remote-agent profile.","messagePattern":"Paperclip Runner AWS AgentCore requires a company remote-agent profile\\.","errorType":"error_code","errorClass":"PaperclipRunnerProviderProfileError","httpStatus":null,"severity":"error","filePath":"server/src/services/native-runtime/provider-profile.ts","lineNumber":376,"sourceCode":"      );\n    }\n    return {\n      provider: \"claude_managed\",\n      backend: \"claude_managed_agents_api\",\n      managedProfileId,\n      model,\n      maxSessionListCostUsd: positiveNumberOrNull(\n        config.maxSessionListCostUsd,\n        \"paperclip_runner_claude_managed_spend_cap_invalid\",\n        \"Paperclip Runner Claude Managed requires a positive session spend ceiling when overridden.\",\n      ),\n    };\n  }\n\n  if (candidate === \"aws_agentcore\") {\n    const agentCoreProfileId = optionalString(config.agentCoreProfileId);\n    if (!agentCoreProfileId) {\n      throw new PaperclipRunnerProviderProfileError(\n        \"paperclip_runner_aws_agentcore_profile_required\",\n        \"Paperclip Runner AWS AgentCore requires a company remote-agent profile.\",\n      );\n    }\n    if (config.agentCoreRetentionAcknowledged !== true) {\n      throw new PaperclipRunnerProviderProfileError(\n        \"paperclip_runner_aws_agentcore_retention_required\",\n        \"Paperclip Runner AWS AgentCore requires acknowledgement of 90-day Memory retention.\",\n      );\n    }\n    if (model !== null && model !== AGENTCORE_QUALIFIED_MODEL) {\n      throw new PaperclipRunnerProviderProfileError(\n        \"paperclip_runner_aws_agentcore_model_unqualified\",\n        `The AWS AgentCore profile requires exact model ${AGENTCORE_QUALIFIED_MODEL}.`,\n      );\n    }\n    return {\n      provider: \"aws_agentcore\",","sourceCodeStart":358,"sourceCodeEnd":394,"githubUrl":"https://github.com/paperclipai/paperclip/blob/01ad8584922b5d85292b1723cae71fa0d9b07a19/server/src/services/native-runtime/provider-profile.ts#L358-L394","documentation":"Guard in resolvePaperclipRunnerProviderProfile for aws_agentcore: config.agentCoreProfileId must be a non-empty string identifying the company's remote-agent profile, else 'paperclip_runner_aws_agentcore_profile_required' is thrown. Without it the run cannot resolve the AgentCore harness/endpoint/memory ARNs used to invoke the remote agent.","triggerScenarios":"Thrown at server/src/services/native-runtime/provider-profile.ts:370 when the library encounters an invalid state.","commonSituations":"See trigger scenarios.","solutions":["Set agentCoreProfileId in adapterConfig to the company's remote-agent profile id or profileKey.","Provision and qualify an AWS AgentCore profile for the company first.","Select a non-AgentCore provider if no remote 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"}