@mastra/cloudflare-sandbox 0.0.0-aggregate-trace-20261015182851

package/LICENSE.md

@@ -0,0 +1,32 @@
+Portions of this software are licensed as follows:
+
+- All content that resides under any directory named `ee/` within this
+  repository, including but not limited to:
+  - `@mastra/core/auth/ee`
+  - `@mastra/core/agent-builder/ee`
+  - `@mastra/editor/ee`
+
+  is licensed under the license defined in [`ee/LICENSE`](https://github.com/mastra-ai/mastra/blob/main/ee/LICENSE).
+
+- All third-party components incorporated into the Mastra Software are
+  licensed under the original license provided by the owner of the
+  applicable component.
+
+- Content outside of the above-mentioned directories or restrictions is
+  available under the "Apache License 2.0" as defined below.
+
+# Apache License 2.0
+
+Copyright (c) 2025 Kepler Software, Inc.
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+    http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.

package/README.md

@@ -0,0 +1,36 @@
+# @mastra/cloudflare-sandbox
+
+Cloudflare Sandbox provider for Mastra workspaces. It talks to a deployed [Cloudflare Sandbox Bridge Worker](https://developers.cloudflare.com/sandbox/bridge/) over the documented [`/v1/sandbox` HTTP API](https://developers.cloudflare.com/sandbox/bridge/http-api/).
+
+## Installation
+
+```bash
+npm install @mastra/cloudflare-sandbox
+```
+
+## Usage
+
+```typescript
+import { Workspace } from '@mastra/core/workspace';
+import { CloudflareSandbox } from '@mastra/cloudflare-sandbox';
+
+const sandbox = new CloudflareSandbox({
+  baseUrl: process.env.CLOUDFLARE_SANDBOX_BRIDGE_URL!,
+  apiToken: process.env.CLOUDFLARE_SANDBOX_API_KEY,
+});
+
+const workspace = new Workspace({ sandbox });
+```
+
+## Documentation
+
+- [Cloudflare Sandbox integration guide](https://mastra.ai/integrations/sandboxes/cloudflare-sandbox)
+- [Workspace documentation](https://mastra.ai/docs/mastra-platform/workspaces)
+
+## Changelog
+
+See the [package changelog](https://github.com/mastra-ai/mastra/blob/main/workspaces/cloudflare-sandbox/CHANGELOG.md) for version history and release notes.
+
+## Support
+
+We have an [open community Discord](https://discord.gg/mastra-ai). Come and say hello and let us know if you have any questions or need any help getting things running.

package/dist/bridge-client.d.ts

@@ -0,0 +1,112 @@
+export interface CloudflareSandboxBridgeClientOptions {
+    baseUrl: string;
+    apiToken?: string;
+    fetch?: typeof globalThis.fetch;
+}
+/** Terminal and streaming events emitted by `POST /v1/sandbox/:id/exec`. */
+export type CloudflareCommandEvent = {
+    type: 'stdout';
+    data: Uint8Array;
+} | {
+    type: 'stderr';
+    data: Uint8Array;
+} | {
+    type: 'exit';
+    exitCode: number;
+} | {
+    type: 'error';
+    message: string;
+    code?: string;
+};
+export interface CloudflareExecRequest {
+    /** Command and arguments. The bridge applies ANSI-C quoting to each element. */
+    argv: string[];
+    timeoutMs?: number;
+    cwd?: string;
+}
+export interface CloudflarePersistWorkspaceOptions {
+    /** Relative paths (under /workspace) to exclude from the archive. */
+    excludes?: string[];
+}
+export interface CloudflareMountBucketCredentials {
+    accessKeyId: string;
+    secretAccessKey: string;
+}
+export interface CloudflareMountBucketOptions {
+    /** S3-compatible endpoint, e.g. `https://<account>.r2.cloudflarestorage.com`. */
+    endpoint?: string;
+    /** Mount the bucket read-only. */
+    readOnly?: boolean;
+    /** Only expose objects under this bucket prefix at the mount point. */
+    prefix?: string;
+    /** Storage provider hint, e.g. `r2`. */
+    provider?: string;
+    /** Explicit credentials; omitted when the Worker resolves them from secrets. */
+    credentials?: CloudflareMountBucketCredentials;
+}
+export interface CloudflareMountBucketRequest {
+    /** Bucket name, e.g. `my-r2-bucket`. */
+    bucket: string;
+    /** Local filesystem path to mount at, e.g. `/mnt/data`. */
+    mountPath: string;
+    options?: CloudflareMountBucketOptions;
+}
+export interface CloudflareCreateSessionRequest {
+    /** Working directory the session starts in. */
+    cwd?: string;
+    /** Environment variables seeded into the session. */
+    env?: Record<string, string>;
+    /** Caller-chosen session id; must match `^[a-zA-Z0-9._-]{1,128}$`. Generated when omitted. */
+    sessionId?: string;
+}
+export interface CloudflareSession {
+    id: string;
+}
+export declare class CloudflareSandboxBridgeError extends Error {
+    readonly status: number;
+    readonly body: string;
+    constructor(status: number, body: string);
+}
+/**
+ * Client for the Cloudflare Sandbox Bridge Worker.
+ *
+ * @see https://developers.cloudflare.com/sandbox/bridge/http-api/
+ */
+export declare class CloudflareSandboxBridgeClient {
+    readonly baseUrl: string;
+    private readonly apiToken?;
+    private readonly fetchImpl;
+    constructor(options: CloudflareSandboxBridgeClientOptions);
+    /** `POST /v1/sandbox` */
+    createSandbox(): Promise<string>;
+    /** `GET /v1/sandbox/:id/running` */
+    isRunning(id: string): Promise<boolean>;
+    /** `DELETE /v1/sandbox/:id` */
+    deleteSandbox(id: string): Promise<void>;
+    /** `PUT /v1/sandbox/:id/file/*` — one file per request, raw bytes as the body. */
+    writeFile(id: string, absolutePath: string, content: Uint8Array | string): Promise<void>;
+    /** `GET /v1/sandbox/:id/file/*` — reads one file, returning its raw bytes. */
+    readFile(id: string, absolutePath: string): Promise<Uint8Array>;
+    /** `GET /v1/sandbox/:id/persist` — archives `/workspace`, returning raw tar bytes. */
+    persistWorkspace(id: string, options?: CloudflarePersistWorkspaceOptions): Promise<Uint8Array>;
+    /** `POST /v1/sandbox/:id/hydrate` — restores `/workspace` from a raw tar payload. */
+    hydrateWorkspace(id: string, tar: Uint8Array): Promise<void>;
+    /** `POST /v1/sandbox/:id/mount` — mounts an S3-compatible bucket as a local directory. */
+    mountBucket(id: string, request: CloudflareMountBucketRequest): Promise<void>;
+    /** `POST /v1/sandbox/:id/unmount` — unmounts a previously mounted bucket. */
+    unmountBucket(id: string, mountPath: string): Promise<void>;
+    /** `POST /v1/sandbox/:id/session` — creates an execution session, returning its id. */
+    createSession(id: string, request?: CloudflareCreateSessionRequest): Promise<CloudflareSession>;
+    /** `DELETE /v1/sandbox/:id/session/:sessionId` — tears down an execution session. */
+    deleteSession(id: string, sessionId: string): Promise<void>;
+    /** `POST /v1/sandbox/:id/exec` — streams SSE events until `exit` or `error`. */
+    exec(id: string, request: CloudflareExecRequest, options: {
+        signal?: AbortSignal;
+        onEvent: (event: CloudflareCommandEvent) => void;
+    }): Promise<void>;
+    private emitBlock;
+    private headers;
+    private request;
+    private requestBytes;
+}
+//# sourceMappingURL=bridge-client.d.ts.map

package/dist/bridge-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bridge-client.d.ts","sourceRoot":"","sources":["../src/bridge-client.ts"],"names":[],"mappings":"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"}