paperclipai/paperclip · error · ConfigurationIncompleteFailure

configuration incomplete

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.

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@3f1d897a7c (2026-08-18). Data as JSON: /api/errors/66dbf1ff286e7f13. Report an issue: GitHub.

Appendix: source

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

    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 3f1d897a7c)