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.

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)

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.