paperclipai/paperclip · error · Error

Instance execution policy requires the Kubernetes sandbox pr

Error message

Instance execution policy requires the Kubernetes sandbox provider (executionMode=kubernetes) but no managed Kubernetes environment is configured for this company. Configure one (PAPERCLIP_K8S_* env on the cloud instance) before running agents; refusing to fall back to local execution.

What it means

Error "Instance execution policy requires the Kubernetes sandbox provider (executionMode=kubernetes) but no managed Kubernetes environment is configured for this company. Configure one (PAPERCLIP_K8S_* env on the cloud instance) before running agents; refusing to fall back to local execution." thrown in paperclipai/paperclip.

Source

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

          run.scheduledRetryAttempt ??
            INTERACTION_CONTINUATION_INFRA_MAX_ATTEMPTS,
          INTERACTION_CONTINUATION_INFRA_MAX_ATTEMPTS,
        ),
        maxAttempts: INTERACTION_CONTINUATION_INFRA_MAX_ATTEMPTS,
      }).catch((error) => {
        logger.warn(
          { err: error, runId: run.id, issueId },
          "failed to escalate non-retryable plan-approval resume failure",
        );
      });
      return null;
    }

    return scheduleBoundedRetryForRun(run, agent, {
      retryReason: INTERACTION_CONTINUATION_INFRA_RETRY_REASON,
      wakeReason: INTERACTION_CONTINUATION_INFRA_WAKE_REASON,
      maxAttempts: INTERACTION_CONTINUATION_INFRA_MAX_ATTEMPTS,
    });
  }

  async function promoteDueScheduledRetries(now = new Date()) {
    const cutoff = await getWorktreeExecutionCutoff();
    const result = await runDispatch.promoteDueScheduledRetries({ now, cutoff });
    applyRunDispatchPostCommitEffects(result.postCommitEffects);
    return { promoted: result.promoted, runIds: result.runIds };
  }

  async function getIssueRetryRun(
    companyId: string,
    issueId: string,
    statuses: Array<"scheduled_retry" | "queued" | "running" | "cancelled">,
  ) {
    if (statuses.length === 0) return null;
    return db
      .select({
        run: heartbeatRuns,

View on GitHub (pinned to 01ad858492)

Solutions

1. Configure a managed Kubernetes environment for the company (PAPERCLIP_K8S_* env on the cloud instance) before running agents.

When it happens

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