paperclipai/paperclip · error · ConfigurationIncompleteFailure

configuration incomplete: ${requiredScopedEnvBinding.remedia

Error message

configuration incomplete: ${requiredScopedEnvBinding.remediation}

What it means

Configuration-incomplete sentinel in heartbeat run preparation: a requiredScopedEnvBinding was configured, but none of its required env keys is bound with agent-consumer scope before launch. The run is paused/fails with the binding spec's own remediation text describing how to configure the required scoped secrets.

Source

Thrown at server/src/services/heartbeat.ts:1040

    isSpawnLikeFailureMessage(resultJson.errorMessage) ||
    isSpawnLikeFailureMessage(resultJson.message) ||
    isSandboxProviderWorkerUnavailableFailureMessage(run.error) ||
    isSandboxProviderWorkerUnavailableFailureMessage(resultJson.errorMessage) ||
    isSandboxProviderWorkerUnavailableFailureMessage(resultJson.message)
  );
}

function mergeAdapterRecoveryMetadata(input: {
  resultJson: Record<string, unknown> | null | undefined;
  errorFamily?: string | null;
  retryNotBefore?: string | null;
}) {
  const errorFamily = readNonEmptyString(input.errorFamily);
  const retryNotBefore = readNonEmptyString(input.retryNotBefore);
  if (!input.resultJson && !errorFamily && !retryNotBefore)
    return input.resultJson ?? null;

  return {
    ...(input.resultJson ?? {}),
    ...(errorFamily ? { errorFamily } : {}),
    ...(retryNotBefore
      ? {
          retryNotBefore,
          transientRetryNotBefore: retryNotBefore,
          ...(errorFamily === "provider_quota"
            ? { providerQuotaRetryNotBefore: retryNotBefore }
            : {}),
        }
      : {}),
  };
}
const RUNNING_ISSUE_WAKE_REASONS_REQUIRING_FOLLOWUP = new Set([
  "approval_approved",
  ISSUE_BLOCKERS_RESOLVED_WAKE_REASON,
  "issue_recovery_action_restored",
]);

View on GitHub (pinned to 01ad858492)

Solutions

1. Apply the remediation described in the message to complete the required scoped env binding configuration.

When it happens

Trigger: Thrown at server/src/services/heartbeat.ts:946 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of paperclipai/paperclip@01ad858492 (2026-08-18). Data as JSON: /api/errors/66dbf1ff286e7f13. Report an issue: GitHub.