paperclipai/paperclip · error · PaperclipRunnerProviderProfileError

paperclip_runner_aws_agentcore_retention_required

paperclip_runner_aws_agentcore_retention_required

Error message

Paperclip Runner AWS AgentCore requires acknowledgement of 90-day Memory retention.

What it means

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.

Solutions

1. Set agentCoreRetentionAcknowledged to true in adapterConfig after the operator accepts 90-day Memory retention.
2. Route the acknowledgement through the provider onboarding/UI flow.
3. Use a provider without fixed-term memory retention if the terms are unacceptable.

When it happens

Trigger: Thrown at server/src/services/native-runtime/provider-profile.ts:376 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of paperclipai/paperclip@01ad858492 (2026-09-02). Data as JSON: /api/errors/f22e540115d908e5. Report an issue: GitHub.

Appendix: source

Thrown at server/src/services/native-runtime/provider-profile.ts:382

      model,
      maxSessionListCostUsd: positiveNumberOrNull(
        config.maxSessionListCostUsd,
        "paperclip_runner_claude_managed_spend_cap_invalid",
        "Paperclip Runner Claude Managed requires a positive session spend ceiling when overridden.",
      ),
    };
  }

  if (candidate === "aws_agentcore") {
    const agentCoreProfileId = optionalString(config.agentCoreProfileId);
    if (!agentCoreProfileId) {
      throw new PaperclipRunnerProviderProfileError(
        "paperclip_runner_aws_agentcore_profile_required",
        "Paperclip Runner AWS AgentCore requires a company remote-agent profile.",
      );
    }
    if (config.agentCoreRetentionAcknowledged !== true) {
      throw new PaperclipRunnerProviderProfileError(
        "paperclip_runner_aws_agentcore_retention_required",
        "Paperclip Runner AWS AgentCore requires acknowledgement of 90-day Memory retention.",
      );
    }
    if (model !== null && model !== AGENTCORE_QUALIFIED_MODEL) {
      throw new PaperclipRunnerProviderProfileError(
        "paperclip_runner_aws_agentcore_model_unqualified",
        `The AWS AgentCore profile requires exact model ${AGENTCORE_QUALIFIED_MODEL}.`,
      );
    }
    return {
      provider: "aws_agentcore",
      backend: "aws_agentcore_harness_api",
      agentCoreProfileId,
      model,
      maxEstimatedSessionCostUsd: positiveNumberOrNull(
        config.maxEstimatedSessionCostUsd,
        "paperclip_runner_aws_agentcore_spend_cap_invalid",

View on GitHub (pinned to 01ad858492)