{"record":{"id":"f22e540115d908e5","repo":"paperclipai/paperclip","slug":"paperclip-runner-aws-agentcore-retention-required","errorCode":"paperclip_runner_aws_agentcore_retention_required","errorMessage":"Paperclip Runner AWS AgentCore requires acknowledgement of 90-day Memory retention.","messagePattern":"Paperclip Runner AWS AgentCore requires acknowledgement of 90-day Memory retention\\.","errorType":"error_code","errorClass":"PaperclipRunnerProviderProfileError","httpStatus":null,"severity":"error","filePath":"server/src/services/native-runtime/provider-profile.ts","lineNumber":382,"sourceCode":"      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\",\n      backend: \"aws_agentcore_harness_api\",\n      agentCoreProfileId,\n      model,\n      maxEstimatedSessionCostUsd: positiveNumberOrNull(\n        config.maxEstimatedSessionCostUsd,\n        \"paperclip_runner_aws_agentcore_spend_cap_invalid\",","sourceCodeStart":364,"sourceCodeEnd":400,"githubUrl":"https://github.com/paperclipai/paperclip/blob/01ad8584922b5d85292b1723cae71fa0d9b07a19/server/src/services/native-runtime/provider-profile.ts#L364-L400","documentation":"Guard in resolvePaperclipRunnerProviderProfile for aws_agentcore: adapterConfig.agentCoreRetentionAcknowledged must be explicitly true, else 'paperclip_runner_aws_agentcore_retention_required' is thrown. AgentCore Memory retains data for 90 days, and the operator must acknowledge that fixed retention period before AgentCore runs are permitted.","triggerScenarios":"Thrown at server/src/services/native-runtime/provider-profile.ts:376 when the library encounters an invalid state.","commonSituations":"See trigger scenarios.","solutions":["Set agentCoreRetentionAcknowledged to true in adapterConfig after the operator accepts 90-day Memory retention.","Route the acknowledgement through the provider onboarding/UI flow.","Use a provider without fixed-term memory retention if the terms are unacceptable."],"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"}