paperclipai/paperclip · error

inherited_workspace_reuse_unavailable

inherited_workspace_reuse_unavailable

Error message

Issue ${issueLabel} requested inherited execution workspace reuse for ${workspaceLabel}, but the workspace could not be restored. ${remediation}

What it means

During run start, the engine tried to reuse an inherited execution workspace but restore returned no result and no earlier failure was captured, so it formats a sentinel inherited_workspace_reuse_unavailable failure and throws. The workspace identified by existingExecutionWorkspaceId could not be restored for reuse.

Source

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

  for (const [key, value] of [
    ["summary", input.summary],
    ["result", input.result],
    ["message", input.message],
    ["error", input.error],
  ] as const) {
    const normalized = readNonEmptyString(value);
    if (normalized) summary[key] = normalized;
  }

  for (const [key, value] of [
    ["total_cost_usd", input.totalCostUsd],
    ["cost_usd", input.costUsd],
    ["costUsd", input.costUsdCamel],
  ] as const) {
    const normalized = readNonEmptyString(value);
    if (!normalized) continue;
    const parsed = Number(normalized);
    if (Number.isFinite(parsed)) summary[key] = parsed;
  }

  return Object.keys(summary).length > 0 ? summary : null;
}

function didAutomaticRecoveryFail(
  latestRun: Pick<
    typeof heartbeatRuns.$inferSelect,
    "status" | "contextSnapshot"
  > | null,
  expectedRetryReason:
    | "assignment_recovery"
    | "issue_continuation_needed"
    | typeof EXECUTION_REVIEW_PARTICIPANT_RECOVERY_RETRY_REASON,
) {
  if (!latestRun) return false;

  const latestContext = parseObject(latestRun.contextSnapshot);

View on GitHub (pinned to 01ad858492)

Solutions

1. Follow the remediation in the message, or let the run create a fresh execution workspace instead of reusing the inherited one.

When it happens

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