paperclipai/paperclip · error

Cloudflare sandbox bridge streaming command failed.

Error message

Cloudflare sandbox bridge streaming command failed.

What it means

Error "Cloudflare sandbox bridge streaming command failed." thrown in paperclipai/paperclip.

Solutions

1. Inspect the streamed error output from the bridge, fix the remote command, and retry.

When it happens

Trigger: Thrown at packages/plugins/sandbox-providers/cloudflare/src/bridge-client.ts:261 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/a67d4ddb19d80c80. Report an issue: GitHub.

Appendix: source

Thrown at packages/plugins/sandbox-providers/cloudflare/src/bridge-client.ts:261

        const payload = JSON.parse(event.data) as { data?: unknown };
        const chunk = typeof payload.data === "string" ? payload.data : "";
        if (chunk) {
          await options.onOutput?.(event.event, chunk);
        }
        continue;
      }

      if (event.event === "complete") {
        result = JSON.parse(event.data) as CloudflareBridgeExecuteResponse;
        continue;
      }

      if (event.event === "error") {
        const payload = JSON.parse(event.data) as { error?: unknown };
        const message = typeof payload.error === "string" && payload.error.trim().length > 0
          ? payload.error
          : "Cloudflare sandbox bridge streaming command failed.";
        throw new Error(message);
      }
    }

    if (done) break;
  }

  if (result) return result;
  throw new Error("Cloudflare sandbox bridge streaming response ended without a completion event.");
}

export function createCloudflareBridgeClient(options: BridgeClientOptions) {
  const { config } = options;
  const apiPrefix = "/api/paperclip-sandbox/v1";

  return {
    health(extraHeaders?: BridgeClientHeaders): Promise<CloudflareBridgeHealthResponse> {
      return requestJson<CloudflareBridgeHealthResponse>(config, `${apiPrefix}/health`, { method: "GET" }, extraHeaders);
    },

View on GitHub (pinned to 120ae5428f)