@mastra/platform-workspace 0.0.0-client-tool-results-20260912062135

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,70 @@
+# @mastra/platform-workspace
+
+Mastra Platform workspace provider. It gives agents environment-scoped sandbox execution and bucket-backed filesystem access through the Mastra Platform workspace proxy.
+
+## Installation
+
+```bash
+npm install @mastra/platform-workspace
+```
+
+## Configuration
+
+All options can be passed to the constructor or read from environment variables:
+
+| Option            | Env var                                                        | Required                        |
+| ----------------- | -------------------------------------------------------------- | ------------------------------- |
+| `accessToken`     | `MASTRA_PLATFORM_ACCESS_TOKEN` or `MASTRA_PLATFORM_SECRET_KEY` | Yes                             |
+| `projectId`       | `MASTRA_PROJECT_ID`                                            | Yes                             |
+| `environmentId`   | `MASTRA_ENVIRONMENT_ID`                                        | Yes (sandbox)                   |
+| `actingUserId`    | —                                                              | No (sandbox)                    |
+| `sandboxProvider` | `SANDBOX_PROVIDER`                                             | No (sandbox, defaults to `e2b`) |
+| `bucketName`      | `MASTRA_PLATFORM_BUCKET_NAME`                                  | Yes (filesystem)                |
+
+The proxy URL defaults to `https://workspaces.mastra.ai`. Set `MASTRA_PLATFORM_REGION` to `us` or `eu` (case-insensitive) to route to the regional replica at `https://workspaces.us.mastra.ai` or `https://workspaces.eu.mastra.ai`. An explicit `MASTRA_WORKSPACE_PROXY_URL` (useful for staging) overrides both.
+
+Requests to the proxy are authenticated with `Authorization: Bearer <accessToken>`. For sandbox requests authenticated with a project access token, set `actingUserId` to the stable opaque user subject from your authentication system. It is sent as `x-acting-user-id` for token partitioning and attribution; it is not an authorization claim.
+
+## Usage
+
+```typescript
+import { Agent } from '@mastra/core/agent';
+import { Workspace } from '@mastra/core/workspace';
+import { PlatformFilesystem, PlatformSandbox } from '@mastra/platform-workspace';
+
+const workspace = new Workspace({
+  filesystem: new PlatformFilesystem({}),
+  sandbox: new PlatformSandbox({
+    idleTimeoutMinutes: 30,
+    networkIsolation: 'ISOLATED',
+  }),
+});
+
+const agent = new Agent({
+  name: 'code-analyzer',
+  model: 'anthropic/claude-sonnet-4-5',
+  workspace,
+});
+```
+
+## Documentation
+
+Both providers authenticate through the workspace proxy with `MASTRA_PROJECT_ID` and a credential. Set `MASTRA_PLATFORM_SECRET_KEY` to your organization API key for local development. The deployed `MASTRA_PLATFORM_ACCESS_TOKEN` takes precedence when present; an explicit `accessToken` constructor option takes precedence over both. Blank environment credentials are ignored. `PlatformSandbox` also requires `MASTRA_ENVIRONMENT_ID`; `PlatformFilesystem` requires `MASTRA_PLATFORM_BUCKET_NAME`. Constructor values override environment variables, and `MASTRA_WORKSPACE_PROXY_URL` can point requests at a non-production proxy.
+
+`PlatformFilesystem` implements the Mastra filesystem interface against a Platform bucket. It supports reading, writing, listing, moving, and deleting files, preserves reserved characters in object names, and can be mounted with `readOnly: true` to reject mutations.
+
+`PlatformSandbox` starts or reconnects to an environment-scoped provider sandbox and implements command execution, lifecycle, and networking operations. The provider defaults to E2B and can be changed to Railway through `sandboxProvider` or `SANDBOX_PROVIDER`. Pass an existing `sandboxId` to reattach to a live sandbox, and `actingUserId` to partition and attribute project-token requests to a stable application user.
+
+The exported `Template()` builder creates reusable sandbox images from commands, packages, environment values, repository checkouts, CPU, memory, and working-directory settings. Platform derives a content identity from the serialized template so matching definitions can reuse previous builds. Ephemeral environment values are excluded from that identity and are not persisted into the runtime image.
+
+Proxy failures throw `PlatformApiError`, which includes the HTTP status, parsed machine-readable error code, proxy message, and raw response body. Use these fields to distinguish missing resources, authentication failures, and provider errors.
+
+- [Mastra Platform workspaces](https://mastra.ai/docs/mastra-platform/workspaces)
+
+## Changelog
+
+See the [package changelog](https://github.com/mastra-ai/mastra/blob/main/workspaces/platform-workspace/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/address-registry.d.ts

@@ -0,0 +1,47 @@
+/**
+ * In-process `sandboxId → instanceUrl` registry populated by
+ * {@link PlatformSandbox.start} from the `instanceUrl` field workspace-proxy
+ * includes on create + get responses, and consumed by
+ * {@link PlatformSandbox.executeCommand} on the private-network fast path.
+ *
+ * The registry lives in the same Node process as the `PlatformSandbox`
+ * consumer — for shipyard, that is the Mastra runtime deployed from
+ * `mastracode/web`. There is no receiver route and no cross-service dance;
+ * the address is just a field copied from a response the runtime already
+ * receives.
+ *
+ * State intentionally does not persist:
+ *
+ *  - The IPv6 rotates on every sandbox recreate.
+ *  - The URL has no meaning after the sandbox is destroyed.
+ *  - The live sandbox binding, session context, and lease all die with the
+ *    runtime process; the address dying with them is correct.
+ *  - The proxy's `environment_sandboxes.instance_url` column is the durable
+ *    source of truth — a runtime restart re-populates the registry on the
+ *    next `start()` / reattach from the proxy's response.
+ */
+import type { SandboxAddressRegistry } from './sandbox.js';
+/**
+ * Concrete in-process {@link SandboxAddressRegistry}. Backed by a `Map`; no
+ * eviction policy, no TTL — entries live until an observed transport failure
+ * calls `delete`, until the sandbox is explicitly destroyed, or until the
+ * process exits.
+ */
+export declare class InProcessSandboxAddressRegistry implements SandboxAddressRegistry {
+    #private;
+    get(sandboxId: string): string | undefined;
+    /**
+     * Populate or overwrite the address for a sandbox. Called by
+     * {@link PlatformSandbox.start} on every fresh provision and every reattach;
+     * overwriting is intentional so a re-provision with a fresh IPv6 heals the
+     * map without a branch.
+     */
+    set(sandboxId: string, instanceUrl: string): void;
+    delete(sandboxId: string): void;
+    /**
+     * Test-only introspection. Not part of {@link SandboxAddressRegistry} —
+     * production callers must not read the registry as a whole.
+     */
+    get size(): number;
+}
+//# sourceMappingURL=address-registry.d.ts.map

package/dist/address-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"address-registry.d.ts","sourceRoot":"","sources":["../src/address-registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,cAAc,CAAC;AAE3D;;;;;GAKG;AACH,qBAAa,+BAAgC,YAAW,sBAAsB;;IAG5E,GAAG,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAEzC;IAED;;;;;OAKG;IACH,GAAG,CAAC,SAAS,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,IAAI,CAEhD;IAED,MAAM,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAE9B;IAED;;;OAGG;IACH,IAAI,IAAI,IAAI,MAAM,CAEjB;CACF"}

package/dist/client.d.ts

@@ -0,0 +1,72 @@
+export interface PlatformClientOptions {
+    accessToken?: string;
+    projectId?: string;
+    actingUserId?: string;
+    sandboxProvider?: SandboxProvider;
+    /**
+     * Advisory correlation id for the factory session driving this client.
+     * Sent as `x-mastra-session-id` on every proxy request so proxy-side logs
+     * can be joined back to the calling session without a multi-store hand-join
+     * (`threadId → sessionId → sandboxId → providerResourceId`). Never used for
+     * authorization — the Bearer token remains the only credential.
+     */
+    sessionId?: string;
+    /**
+     * Advisory correlation id for the factory thread, sent as
+     * `x-mastra-thread-id` when present. See {@link PlatformClientOptions.sessionId}.
+     */
+    threadId?: string;
+    fetch?: typeof fetch;
+}
+export interface PlatformRequestOptions extends RequestInit {
+    query?: Record<string, string | number | boolean | undefined>;
+}
+export type SandboxProvider = 'railway' | 'e2b';
+export declare function requireOption(value: string | undefined, name: string): string;
+export declare function resolvePlatformOptions(options: PlatformClientOptions): {
+    accessToken: string;
+    projectId: string;
+    actingUserId: string | undefined;
+    proxyUrl: string;
+    sandboxProvider: SandboxProvider;
+    sessionId: string | undefined;
+    threadId: string | undefined;
+    fetch: typeof fetch;
+};
+/**
+ * Structured error shape returned by the workspace proxy. All routes emit
+ * `{ error: { message, type } }` on failure — see servers/workspace-proxy in
+ * the Platform repo. Kept as a wire-level type so callers can switch on
+ * `error.code` without re-parsing `error.body`.
+ */
+export interface PlatformProxyError {
+    message: string;
+    /** Machine-readable error kind, e.g. `not_found`, `invalid_request`, `authentication_error`. */
+    type: string;
+}
+export declare class PlatformApiError extends Error {
+    readonly status: number;
+    readonly body: string;
+    /** Machine-readable proxy error kind (e.g. `not_found`), when the response body matches `{ error: { message, type } }`. */
+    readonly code: string | undefined;
+    /** Human-readable proxy error message, when the response body matches `{ error: { message, type } }`. */
+    readonly proxyMessage: string | undefined;
+    constructor(status: number, body: string);
+}
+export declare class PlatformClient {
+    readonly accessToken: string;
+    readonly projectId: string;
+    readonly actingUserId: string | undefined;
+    readonly proxyUrl: string;
+    readonly sandboxProvider: SandboxProvider;
+    /** Advisory session correlation id — see {@link PlatformClientOptions.sessionId}. */
+    readonly sessionId: string | undefined;
+    /** Advisory thread correlation id — see {@link PlatformClientOptions.threadId}. */
+    readonly threadId: string | undefined;
+    readonly fetch: typeof fetch;
+    constructor(options: PlatformClientOptions);
+    request(path: string, options?: PlatformRequestOptions): Promise<Response>;
+    requestProvider(path: string, options?: PlatformRequestOptions): Promise<Response>;
+    private requestAtPath;
+}
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,qBAAqB;IACpC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,eAAe,CAAC,EAAE,eAAe,CAAC;IAClC;;;;;;OAMG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,OAAO,KAAK,CAAC;CACtB;AAED,MAAM,WAAW,sBAAuB,SAAQ,WAAW;IACzD,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,SAAS,CAAC,CAAC;CAC/D;AAED,MAAM,MAAM,eAAe,GAAG,SAAS,GAAG,KAAK,CAAC;AA6BhD,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAG7E;AAUD,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,qBAAqB;IAKjE,WAAW;IAKX,SAAS;IACT,YAAY;IACZ,QAAQ;IACR,eAAe;IACf,SAAS;IACT,QAAQ;IACR,KAAK;EAER;AAED;;;;;GAKG;AACH,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,gGAAgG;IAChG,IAAI,EAAE,MAAM,CAAC;CACd;AAkBD,qBAAa,gBAAiB,SAAQ,KAAK;IACzC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,2HAA2H;IAC3H,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,CAAC;IAClC,yGAAyG;IACzG,QAAQ,CAAC,YAAY,EAAE,MAAM,GAAG,SAAS,CAAC;IAE1C,YAAY,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EASvC;CACF;AAED,qBAAa,cAAc;IACzB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,YAAY,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1C,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,eAAe,EAAE,eAAe,CAAC;IAC1C,qFAAqF;IACrF,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,CAAC;IACvC,mFAAmF;IACnF,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAC;IACtC,QAAQ,CAAC,KAAK,EAAE,OAAO,KAAK,CAAC;IAE7B,YAAY,OAAO,EAAE,qBAAqB,EAUzC;IAEK,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE,sBAA2B,GAAG,OAAO,CAAC,QAAQ,CAAC,CAEnF;IAEK,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE,sBAA2B,GAAG,OAAO,CAAC,QAAQ,CAAC,CAE3F;YAEa,aAAa;CA2B5B"}

package/dist/direct-exec.d.ts

@@ -0,0 +1,98 @@
+/**
+ * Direct exec client — opens Railway's tcp-proxy exec WebSocket directly using
+ * a short-lived JWT minted by the workspace proxy's exec-lease endpoint. This
+ * removes the platform data plane from the exec stdout/stderr path entirely
+ * (see `docs/factory/direct-sandbox-connection.md` in the Platform repo),
+ * cutting payload-scaled Cloud Run egress and RTT for commands like
+ * `pnpm install` that stream tens of MB of output.
+ *
+ * The frame protocol below mirrors `connectExecWs()` in `railway@3.5.5`
+ * (`workspaces/railway/node_modules/railway/dist/index.js`). The `railway`
+ * SDK's version is pinned on both sides (platform + here); a version bump
+ * signals the protocol may have drifted and this module must be revisited.
+ */
+/**
+ * Minimal WebSocket surface this module depends on. Matches both the browser
+ * `WebSocket` global and Node 22+'s built-in `WebSocket`. Extracted so tests
+ * can inject a fake without pulling in `ws` or jsdom.
+ */
+export interface DirectExecWebSocket {
+    binaryType: 'blob' | 'arraybuffer';
+    onopen: ((event: unknown) => void) | null;
+    onmessage: ((event: {
+        data: unknown;
+    }) => void) | null;
+    onclose: ((event: {
+        code: number;
+        reason: string;
+    }) => void) | null;
+    onerror: ((event: unknown) => void) | null;
+    send(data: string): void;
+    close(code?: number, reason?: string): void;
+}
+/**
+ * Factory that opens a WebSocket to `endpoint` with the given subprotocols.
+ * Defaults to the global `WebSocket` when omitted, which works on Node 22+
+ * (the package's minimum) and in the browser. Tests inject a fake here.
+ */
+export type DirectExecWebSocketFactory = (endpoint: string, subprotocols: string[]) => DirectExecWebSocket;
+/** Lease payload returned by `POST /v1/:provider/projects/:projectId/sandbox/:sandboxId/exec-lease`. */
+export interface ExecLease {
+    jwt: string;
+    wsEndpoint: string;
+    subprotocol: string;
+    /** ISO-8601 UTC. Null when the provider issues a JWT without an `exp` claim. */
+    expiresAt: string | null;
+}
+/** Inputs to a direct exec invocation. Mirrors the shape of the `/exec` route body. */
+export interface DirectExecOptions {
+    command: string;
+    cwd?: string;
+    env?: Record<string, string>;
+    /**
+     * Wall-clock cap for the exec. When elapsed, we close the socket and
+     * return `{timedOut: true, exitCode: 124}` matching the semantics of the
+     * proxy's `/exec` route.
+     */
+    timeoutMs?: number;
+    onStdout?: (chunk: string) => void;
+    onStderr?: (chunk: string) => void;
+    /** Injected for tests. Defaults to `globalThis.WebSocket`. */
+    webSocketFactory?: DirectExecWebSocketFactory;
+}
+/**
+ * Result of a direct exec. Shape matches the workspace-proxy `/exec` response
+ * so the caller (`PlatformSandbox.executeCommand`) can hand it back with no
+ * translation.
+ *
+ * `exitCode` is `null` when the socket closed without an `exit` frame AND the
+ * exec did not time out (rare — usually a mid-stream network drop). Callers
+ * currently coerce `null` to `1` upstream; kept nullable here to preserve the
+ * distinction for future observability.
+ */
+export interface DirectExecResult {
+    exitCode: number | null;
+    stdout: string;
+    stderr: string;
+    truncated: boolean;
+    timedOut: boolean;
+    /**
+     * WebSocket close metadata. Populated on any close (normal or transport
+     * failure). `opened` distinguishes handshake failures (never opened) from
+     * mid-stream drops. Callers use this for diagnostic logging; not part of
+     * the CommandResult contract.
+     */
+    closeCode?: number;
+    closeReason?: string;
+    opened?: boolean;
+}
+/**
+ * Open the provider exec WebSocket using `lease`, run `command`, and resolve
+ * with the accumulated stdout/stderr + exit code. See the module docstring
+ * for the wire protocol reference.
+ *
+ * The client sends `stdin_close` immediately after `init_exec`, matching the
+ * SDK's own one-shot exec behavior — we never stream stdin from the caller.
+ */
+export declare function execViaLease(lease: ExecLease, options: DirectExecOptions): Promise<DirectExecResult>;
+//# sourceMappingURL=direct-exec.d.ts.map

package/dist/direct-exec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"direct-exec.d.ts","sourceRoot":"","sources":["../src/direct-exec.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAeH;;;;GAIG;AACH,MAAM,WAAW,mBAAmB;IAClC,UAAU,EAAE,MAAM,GAAG,aAAa,CAAC;IACnC,MAAM,EAAE,CAAC,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC,GAAG,IAAI,CAAC;IAC1C,SAAS,EAAE,CAAC,CAAC,KAAK,EAAE;QAAE,IAAI,EAAE,OAAO,CAAA;KAAE,KAAK,IAAI,CAAC,GAAG,IAAI,CAAC;IACvD,OAAO,EAAE,CAAC,CAAC,KAAK,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,CAAC,GAAG,IAAI,CAAC;IACpE,OAAO,EAAE,CAAC,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC,GAAG,IAAI,CAAC;IAC3C,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7C;AAED;;;;GAIG;AACH,MAAM,MAAM,0BAA0B,GAAG,CAAC,QAAQ,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,KAAK,mBAAmB,CAAC;AAE3G,wGAAwG;AACxG,MAAM,WAAW,SAAS;IACxB,GAAG,EAAE,MAAM,CAAC;IACZ,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,gFAAgF;IAChF,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B;AAED,uFAAuF;AACvF,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B;;;;OAIG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACnC,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACnC,8DAA8D;IAC9D,gBAAgB,CAAC,EAAE,0BAA0B,CAAC;CAC/C;AAED;;;;;;;;;GASG;AACH,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,OAAO,CAAC;IACnB,QAAQ,EAAE,OAAO,CAAC;IAClB;;;;;OAKG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAcD;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAyJpG"}

package/dist/e2b-exec.d.ts

@@ -0,0 +1,7 @@
+import type { DirectExecOptions, DirectExecResult, ExecLease } from './direct-exec.js';
+export interface E2BExecLease extends ExecLease {
+    sandboxId: string;
+}
+export type E2BExecRunner = (lease: E2BExecLease, options: DirectExecOptions) => Promise<DirectExecResult>;
+export declare const execViaE2BLease: E2BExecRunner;
+//# sourceMappingURL=e2b-exec.d.ts.map

package/dist/e2b-exec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"e2b-exec.d.ts","sourceRoot":"","sources":["../src/e2b-exec.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAIvF,MAAM,WAAW,YAAa,SAAQ,SAAS;IAC7C,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,MAAM,aAAa,GAAG,CAAC,KAAK,EAAE,YAAY,EAAE,OAAO,EAAE,iBAAiB,KAAK,OAAO,CAAC,gBAAgB,CAAC,CAAC;AAE3G,eAAO,MAAM,eAAe,EAAE,aAwD7B,CAAC"}

package/dist/filesystem.d.ts

@@ -0,0 +1,62 @@
+import { Buffer } from 'node:buffer';
+import type { RequestContext } from '@mastra/core/request-context';
+import type { CopyOptions, FileContent, FileEntry, FileStat, FilesystemIcon, FilesystemInfo, InstructionsOption, ListOptions, MastraFilesystemOptions, ProviderStatus, ReadOptions, RemoveOptions, WriteOptions } from '@mastra/core/workspace';
+import { MastraFilesystem } from '@mastra/core/workspace';
+import type { PlatformClientOptions } from './client.js';
+export interface PlatformFilesystemOptions extends PlatformClientOptions, MastraFilesystemOptions {
+    id?: string;
+    bucketName?: string;
+    readOnly?: boolean;
+    displayName?: string;
+    icon?: FilesystemIcon;
+    description?: string;
+    instructions?: InstructionsOption;
+}
+export declare class PlatformFilesystem extends MastraFilesystem {
+    readonly id: string;
+    readonly name = "PlatformFilesystem";
+    readonly provider = "platform";
+    readonly readOnly?: boolean;
+    readonly displayName?: string;
+    readonly icon: FilesystemIcon;
+    readonly description?: string;
+    status: ProviderStatus;
+    private readonly _client;
+    private readonly _bucketName;
+    private readonly _instructionsOverride?;
+    constructor(options?: PlatformFilesystemOptions);
+    private generateId;
+    readFile(path: string, options?: ReadOptions): Promise<string | Buffer>;
+    writeFile(path: string, content: FileContent, options?: WriteOptions): Promise<void>;
+    /**
+     * Append bytes to a file.
+     *
+     * **Not atomic.** Object storage behind the workspace proxy has no native
+     * append or compare-and-swap primitive, so this implementation is a
+     * read-modify-write: it reads the current contents, concatenates the new
+     * bytes, and PUTs the whole object back. Concurrent `appendFile` calls to
+     * the same path can overwrite each other's writes ("last write wins").
+     * Use `writeFile` with distinct keys for concurrent writers.
+     */
+    appendFile(path: string, content: FileContent): Promise<void>;
+    deleteFile(path: string, options?: RemoveOptions): Promise<void>;
+    copyFile(src: string, dest: string, options?: CopyOptions): Promise<void>;
+    moveFile(src: string, dest: string, options?: CopyOptions): Promise<void>;
+    mkdir(path: string, _options?: {
+        recursive?: boolean;
+    }): Promise<void>;
+    rmdir(path: string, options?: RemoveOptions): Promise<void>;
+    readdir(path: string, options?: ListOptions): Promise<FileEntry[]>;
+    exists(path: string): Promise<boolean>;
+    stat(path: string): Promise<FileStat>;
+    realpath(path: string): Promise<string>;
+    getInstructions(opts?: {
+        requestContext?: RequestContext;
+    }): string;
+    getInfo(): FilesystemInfo<{
+        bucketName: string;
+        displayName?: string;
+        description?: string;
+    }>;
+}
+//# sourceMappingURL=filesystem.d.ts.map

package/dist/filesystem.d.ts.map

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