paperclipai/paperclip · error · PaperclipRunnerProviderProfileError

paperclip_runner_aws_agentcore_profile_required

paperclip_runner_aws_agentcore_profile_required

Error message

Paperclip Runner AWS AgentCore requires a company remote-agent profile.

What it means

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.

Source

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

      );
    }
    return {
      provider: "claude_managed",
      backend: "claude_managed_agents_api",
      managedProfileId,
      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",

View on GitHub (pinned to 01ad858492)

Solutions

1. Set agentCoreProfileId in adapterConfig to the company's remote-agent profile id or profileKey.
2. Provision and qualify an AWS AgentCore profile for the company first.
3. Select a non-AgentCore provider if no remote profile exists.

When it happens

Trigger: Thrown at server/src/services/native-runtime/provider-profile.ts:370 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/369ccf43a6435a2e. Report an issue: GitHub.