paperclipai/paperclip · error

Kubernetes file sync could not resolve the Sandbox pod name.

Error message

Kubernetes file sync could not resolve the Sandbox pod name.

What it means

Error "Kubernetes file sync could not resolve the Sandbox pod name." thrown in paperclipai/paperclip.

Source

Thrown at packages/plugins/sandbox-providers/kubernetes/src/plugin.ts:189

  const clients = makeKubeClients(kc);
  const timeoutMs = config.podActivityDeadlineSec * 1000;

  // Ensure the Sandbox pod is Ready (wait only the first time for this lease),
  // then resolve the pod name — mirrors the onEnvironmentExecute resolution.
  if (!readySandboxesByLease.has(lease.providerLeaseId)) {
    await sandboxCrOrchestrator.waitForCompletion(clients, namespace, lease.providerLeaseId, {
      timeoutMs,
      pollMs: 2000,
    });
    readySandboxesByLease.add(lease.providerLeaseId);
  }

  const podName =
    typeof lease.metadata?.podName === "string" && lease.metadata.podName
      ? lease.metadata.podName
      : await sandboxCrOrchestrator.findPod(clients, namespace, lease.providerLeaseId);
  if (!podName) {
    throw new Error("Kubernetes file sync could not resolve the Sandbox pod name.");
  }

  // Bind the streaming exec: raw tar bytes move over stdin/stdout straight to and
  // from a host file, so neither side buffers the whole payload. The file-sync
  // module bounds the untrusted pod's stdout with its own streamed-bytes disk
  // guard and passes the stderr cap through `io`.
  const exec: PodStreamExec = (command, io) =>
    execInPodStreaming(kc, namespace, podName, "agent", command, {
      ...io,
      timeoutMs: io.timeoutMs ?? timeoutMs,
    });
  return { exec, timeoutMs };
}

const plugin = definePlugin({
  async setup(ctx) {
    ctx.logger.info("Kubernetes sandbox provider plugin ready");
  },

View on GitHub (pinned to 120ae5428f)

Solutions

1. Verify the Sandbox CR created its pod; check CR status and controller logs.

When it happens

Trigger: Thrown at packages/plugins/sandbox-providers/kubernetes/src/plugin.ts:189 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of paperclipai/paperclip@120ae5428f (2026-08-18). Data as JSON: /api/errors/c6bbe58b31a0a300. Report an issue: GitHub.