{"record":{"id":"101b79bc2f115789","repo":"paperclipai/paperclip","slug":"paperclip-runner-aws-agentcore-model-unqualified","errorCode":"paperclip_runner_aws_agentcore_model_unqualified","errorMessage":"The AWS AgentCore profile requires exact model ${AGENTCORE_QUALIFIED_MODEL}.","messagePattern":"The AWS AgentCore profile requires exact model (.+?)\\.","errorType":"error_code","errorClass":"PaperclipRunnerProviderProfileError","httpStatus":null,"severity":"error","filePath":"server/src/services/native-runtime/provider-profile.ts","lineNumber":388,"sourceCode":"    };\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\",\n      backend: \"aws_agentcore_harness_api\",\n      agentCoreProfileId,\n      model,\n      maxEstimatedSessionCostUsd: positiveNumberOrNull(\n        config.maxEstimatedSessionCostUsd,\n        \"paperclip_runner_aws_agentcore_spend_cap_invalid\",\n        \"Paperclip Runner AWS AgentCore requires a positive estimated session spend ceiling when overridden.\",\n      ),\n    };\n  }\n\n  const acpxAgent = config.acpxAgent ?? \"claude\";","sourceCodeStart":370,"sourceCodeEnd":406,"githubUrl":"https://github.com/paperclipai/paperclip/blob/01ad8584922b5d85292b1723cae71fa0d9b07a19/server/src/services/native-runtime/provider-profile.ts#L370-L406","documentation":"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.","triggerScenarios":"Thrown at server/src/services/native-runtime/provider-profile.ts:382 when the library encounters an invalid state.","commonSituations":"See trigger scenarios.","solutions":["Set adapterConfig.model to the exact qualified model named in the error message.","Drop the model override so the profile's default applies.","Re-qualify the AgentCore harness for a different model before using it."],"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"}