paperclipai/paperclip · error · ConfigurationIncompleteFailure

secret_binding_missing

secret_binding_missing

Error message

configuration incomplete: ${detail}

What it means

Generic configuration-incomplete wrap-up in heartbeat run preparation: missing scoped env bindings were detected outside the required-binding path; the accumulated detail string names the missing bindings/consumers. The run is blocked from launching until the configuration gaps are fixed.

Source

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

} {
  const drain = computeTaskDrain(opts);
  applyTaskDrain(drain);
  return drain;
}

export function stopTaskDrain(): { wasActive: boolean } {
  const wasActive = readTaskDrain(new Date()) !== null;
  taskDrainState = null;
  return { wasActive };
}

/**
 * Report the task-drain state for this process only. `activeRuns` and
 * `pendingWakes` count in-process work. A process restart clears both
 * counters, even when the database still holds `running` rows for runs
 * this process did not finish.
 */
export function getTaskDrainStatus(): {
  draining: boolean;
  startedAt: Date | null;
  expiresAt: Date | null;
  activeRuns: number;
  pendingWakes: number;
  quiescent: boolean;
} {
  const state = readTaskDrain(new Date());
  const activeRuns = activeRunExecutionPromises.size;
  const pendingWakes = activeWakeupPromises.size;
  return {
    draining: state !== null,
    startedAt: state?.startedAt ?? null,
    expiresAt: state?.expiresAt ?? null,
    activeRuns,
    pendingWakes,
    quiescent: activeRuns === 0 && pendingWakes === 0,
  };

View on GitHub (pinned to 01ad858492)

Solutions

1. Complete the configuration per the detail in the message, then retry the run.

When it happens

Trigger: Thrown at server/src/services/heartbeat.ts:1061 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/acb4f18c0363b730. Report an issue: GitHub.