sbox-sdk 0.0.2

package/dist/internal/types.d.ts

@@ -0,0 +1,381 @@
+/**
+ * The full public type surface: the `Sandbox` the user holds, its namespaced
+ * sub-APIs, the `SandboxClient`, and the provider/adapter contract the core
+ * calls into. Everything is web-standard (no Node `Buffer`) so the core stays
+ * portable across Node / Bun / Deno / Workers.
+ */
+import type { Capabilities, CapabilityFlags, CapabilityMap, Gated } from "./capabilities.js";
+import type { SandboxError } from "./errors.js";
+import type { SandboxPlugin } from "./plugin.js";
+export type MaybePromise<T> = T | Promise<T>;
+export type FileBody = string | Uint8Array | ReadableStream<Uint8Array>;
+export type SandboxState = "creating" | "running" | "paused" | "stopped" | "destroyed" | "error" | "unknown";
+export interface SandboxInfo {
+    readonly id: string;
+    readonly name?: string;
+    readonly state: SandboxState;
+    readonly provider: string;
+    readonly metadata: Readonly<Record<string, string>>;
+    readonly createdAt?: Date;
+    readonly raw: unknown;
+}
+export interface ResourceSpec {
+    vcpus?: number;
+    memoryMB?: number;
+    diskMB?: number;
+    gpu?: string;
+}
+export interface VolumeMount {
+    id: string;
+    mountPath: string;
+    readOnly?: boolean;
+}
+export interface SecretRef {
+    name: string;
+    envVar?: string;
+}
+export interface SandboxSpec {
+    /** Build-time base: image / snapshot / blueprint id, provider-specific. */
+    template?: string;
+    name?: string;
+    metadata?: Record<string, string>;
+    env?: Record<string, string>;
+    resources?: ResourceSpec;
+    ttlMs?: number;
+    onIdle?: "pause" | "stop" | "destroy";
+    ports?: number[];
+    region?: string;
+    volumes?: VolumeMount[];
+    secrets?: SecretRef[];
+    /** Safe-retry key so create() never spawns duplicate VMs across fallback. */
+    idempotencyKey?: string;
+    signal?: AbortSignal;
+}
+export interface ExecOptions {
+    cwd?: string;
+    env?: Record<string, string>;
+    timeoutMs?: number;
+    user?: string;
+    stdin?: FileBody;
+    signal?: AbortSignal;
+    onStdout?: (chunk: string) => void;
+    onStderr?: (chunk: string) => void;
+}
+export interface ExecResult {
+    readonly stdout: string;
+    readonly stderr: string;
+    readonly exitCode: number;
+    /** true when the exit code was parsed from a `$?` echo rather than native. */
+    readonly exitCodeSynthesized?: boolean;
+}
+export type OutputEvent = {
+    type: "stdout";
+    data: string;
+} | {
+    type: "stderr";
+    data: string;
+} | {
+    type: "exit";
+    exitCode: number;
+    signal?: string;
+};
+/**
+ * Returned by `commands.run()`: BOTH a `Promise<ExecResult>` (await => buffered)
+ * AND an `AsyncIterable<OutputEvent>` (for-await => streamed live).
+ */
+export interface ExecHandle extends Promise<ExecResult>, AsyncIterable<OutputEvent> {
+    readonly pid: Promise<string>;
+    readonly stdout: ReadableStream<Uint8Array>;
+    readonly stderr: ReadableStream<Uint8Array>;
+    kill(signal?: string): Promise<void>;
+    writeStdin(data: string | Uint8Array): Promise<void>;
+}
+export interface Process {
+    readonly id: string;
+    readonly stdout: AsyncIterable<string>;
+    readonly stderr: AsyncIterable<string>;
+    wait(): Promise<ExecResult>;
+    kill(signal?: string): Promise<void>;
+    writeStdin(data: string | Uint8Array): Promise<void>;
+}
+export interface ProcessInfo {
+    id: string;
+    cmd: string;
+}
+export type FileType = "file" | "dir" | "symlink";
+export interface FileInfo {
+    path: string;
+    type: FileType;
+    size: number;
+    mtime?: Date;
+}
+export interface DirEntry {
+    name: string;
+    path: string;
+    type: FileType;
+}
+export interface StoredFile {
+    path: string;
+    text(): Promise<string>;
+    bytes(): Promise<Uint8Array>;
+    stream(): ReadableStream<Uint8Array>;
+}
+export interface FsEvent {
+    type: "create" | "modify" | "delete";
+    path: string;
+}
+export interface Watcher {
+    close(): Promise<void>;
+}
+export interface Preview {
+    url: string;
+    port: number;
+    token?: string;
+}
+export interface EgressPolicy {
+    mode: "allow-all" | "block-all" | "allow-list";
+    domains?: string[];
+    cidrs?: string[];
+}
+export interface SshCredentials {
+    host: string;
+    port: number;
+    user: string;
+    privateKey: string;
+}
+export interface KernelContext {
+    readonly id: string;
+    language: string;
+}
+export interface RichResult {
+    mime: Record<string, string>;
+    text?: string;
+}
+export interface CodeExecution {
+    results: RichResult[];
+    logs: {
+        stdout: string[];
+        stderr: string[];
+    };
+    error?: {
+        name: string;
+        value: string;
+        traceback?: string;
+    };
+}
+export interface SnapshotRef {
+    id: string;
+    name?: string;
+    provider: string;
+    createdAt?: Date;
+    raw: unknown;
+}
+export interface CommandsAPI {
+    run(cmd: string | string[], opts?: ExecOptions): ExecHandle;
+    spawn(cmd: string | string[], opts?: ExecOptions): Promise<Process>;
+    connect(processId: string): Promise<Process>;
+    kill(processId: string, signal?: string): Promise<void>;
+    list(): Promise<ProcessInfo[]>;
+}
+export interface FilesAPI {
+    read(path: string): Promise<StoredFile>;
+    write(path: string, data: FileBody): Promise<void>;
+    list(path: string): Promise<DirEntry[]>;
+    mkdir(path: string, opts?: {
+        recursive?: boolean;
+    }): Promise<void>;
+    remove(path: string, opts?: {
+        recursive?: boolean;
+    }): Promise<void>;
+    rename(from: string, to: string): Promise<void>;
+    stat(path: string): Promise<FileInfo>;
+    exists(path: string): Promise<boolean>;
+    upload(path: string, body: FileBody): Promise<void>;
+    download(path: string): Promise<StoredFile>;
+    watch(path: string, cb: (e: FsEvent) => void, opts?: {
+        recursive?: boolean;
+    }): Promise<Watcher>;
+}
+export interface CodeAPI {
+    runCode(code: string, opts?: {
+        context?: KernelContext;
+        language?: string;
+        onStdout?: (chunk: string) => void;
+        onStderr?: (chunk: string) => void;
+    }): Promise<CodeExecution>;
+    createContext(opts?: {
+        language?: string;
+        cwd?: string;
+    }): Promise<KernelContext>;
+}
+export interface PortsAPI {
+    expose(port: number, opts?: {
+        private?: boolean;
+    }): Promise<Preview>;
+    unexpose(port: number): Promise<void>;
+    list(): Promise<Preview[]>;
+    fetch(port: number, path?: string, init?: RequestInit): Promise<Response>;
+}
+export interface SnapshotsAPI {
+    create(opts?: {
+        name?: string;
+    }): Promise<SnapshotRef>;
+    restore(ref: SnapshotRef | string): Promise<void>;
+    fork(count?: number): Promise<Sandbox[]>;
+    list(): Promise<SnapshotRef[]>;
+    delete(ref: SnapshotRef | string): Promise<void>;
+}
+export interface NetworkAPI {
+    setEgressPolicy(policy: EgressPolicy): Promise<void>;
+    createSsh(): Promise<SshCredentials>;
+}
+export interface Sandbox<Caps extends CapabilityMap = CapabilityMap, Raw = unknown> {
+    readonly id: string;
+    readonly name?: string;
+    readonly provider: string;
+    readonly capabilities: Capabilities;
+    readonly commands: CommandsAPI;
+    readonly files: FilesAPI;
+    readonly ports: Gated<Caps["exposePort"], PortsAPI>;
+    readonly code: Gated<Caps["codeInterpreter"], CodeAPI>;
+    readonly snapshots: Gated<Caps["snapshot"], SnapshotsAPI>;
+    readonly network: Gated<Caps["egressControl"], NetworkAPI>;
+    getInfo(): Promise<SandboxInfo>;
+    setTimeout(ttlMs: number): Promise<void>;
+    stop(): Promise<void>;
+    pause(): Promise<void>;
+    resume(): Promise<void>;
+    destroy(): Promise<void>;
+    /** Runtime check + type-guard, for dynamically-chosen providers. */
+    can<K extends keyof CapabilityMap>(cap: K): this is Sandbox<Caps & Record<K, "native" | "emulated">, Raw>;
+    /** Escape hatch: the native provider client, typed via the adapter Raw. */
+    raw(): Raw;
+}
+export interface ListFilter {
+    metadata?: Record<string, string>;
+    state?: SandboxState;
+    limit?: number;
+}
+/**
+ * Per-`create` overrides handed to plugins (e.g. the AI-provider policy). Opaque
+ * to the core router; each plugin reads the keys it understands via
+ * `PluginSetupContext.createOptions`.
+ */
+export type SandboxCreateOptions = Readonly<Record<string, unknown>>;
+export interface SandboxClient<Caps extends CapabilityMap = CapabilityMap, Raw = unknown, Ext extends object = object> {
+    create(spec?: SandboxSpec, options?: SandboxCreateOptions): Promise<Sandbox<Caps, Raw> & Ext>;
+    connect(id: string): Promise<Sandbox<Caps, Raw> & Ext>;
+    list(filter?: ListFilter): AsyncIterable<SandboxInfo>;
+    readonly provider: string;
+    readonly capabilities: Capabilities;
+    dispose(): Promise<void>;
+}
+export interface RetryPolicy {
+    retries?: number;
+    delayMs?: (attempt: number, err: unknown) => number;
+    shouldRetry?: (err: unknown, attempt: number) => boolean;
+}
+export interface Hooks {
+    beforeCreate?(spec: SandboxSpec): void | Promise<void>;
+    afterCreate?(info: {
+        id: string;
+        provider: string;
+    }): void | Promise<void>;
+    onError?(err: unknown, attempt: number): void | Promise<void>;
+}
+export interface ClientOptions<Caps extends CapabilityMap = CapabilityMap, Raw = unknown> {
+    provider?: SandboxProvider<Caps, Raw>;
+    fallback?: SandboxProvider[];
+    retry?: RetryPolicy;
+    hooks?: Hooks;
+    fetch?: typeof fetch;
+    /** Opt-in lossy emulations (e.g. fork via snapshot+restore). */
+    emulate?: (keyof CapabilityMap)[];
+    defaultMetadata?: Record<string, string>;
+    /** Plugins applied to every sandbox this client builds (incl. forks). */
+    plugins?: readonly SandboxPlugin[];
+}
+/** Per-call context threaded into every adapter method. */
+export interface CallContext {
+    attempt: number;
+    signal?: AbortSignal;
+    /** CRITICAL for create(): retries must not duplicate VMs. */
+    idempotencyKey?: string;
+    /** Injectable transport — the primary unit-test seam. */
+    fetch: typeof fetch;
+    metadata?: Record<string, string>;
+}
+/** Raw event stream returned by adapter exec; the core wraps it into ExecHandle. */
+export interface DriverExec extends AsyncIterable<OutputEvent> {
+    readonly pid: Promise<string>;
+    kill(signal?: string): Promise<void>;
+    writeStdin?(data: Uint8Array): Promise<void>;
+}
+export interface DriverProcess extends DriverExec {
+    readonly id: string;
+}
+/** A live adapter-side handle to ONE sandbox. Required methods = common denominator. */
+export interface DriverHandle<Raw = unknown> {
+    readonly id: string;
+    readonly name?: string;
+    readonly raw: Raw;
+    getInfo(ctx: CallContext): MaybePromise<SandboxInfo>;
+    destroy(ctx: CallContext): MaybePromise<void>;
+    /** MUST NOT throw on non-zero exit; emit `{type:'exit',exitCode}` instead. */
+    exec(cmd: string, opts: ExecOptions, ctx: CallContext): DriverExec;
+    readFile(path: string, ctx: CallContext): MaybePromise<Uint8Array>;
+    writeFile(path: string, data: Uint8Array, ctx: CallContext): MaybePromise<void>;
+    setTimeout?(ttlMs: number, ctx: CallContext): MaybePromise<void>;
+    stop?(ctx: CallContext): MaybePromise<void>;
+    pause?(ctx: CallContext): MaybePromise<void>;
+    resume?(ctx: CallContext): MaybePromise<void>;
+    spawn?(cmd: string, opts: ExecOptions, ctx: CallContext): MaybePromise<DriverProcess>;
+    connectProcess?(processId: string, ctx: CallContext): MaybePromise<DriverProcess>;
+    killProcess?(processId: string, signal: string | undefined, ctx: CallContext): MaybePromise<void>;
+    listProcesses?(ctx: CallContext): MaybePromise<ProcessInfo[]>;
+    listDir?(path: string, ctx: CallContext): MaybePromise<DirEntry[]>;
+    mkdir?(path: string, recursive: boolean, ctx: CallContext): MaybePromise<void>;
+    remove?(path: string, recursive: boolean, ctx: CallContext): MaybePromise<void>;
+    rename?(from: string, to: string, ctx: CallContext): MaybePromise<void>;
+    stat?(path: string, ctx: CallContext): MaybePromise<FileInfo>;
+    upload?(path: string, data: FileBody, ctx: CallContext): MaybePromise<void>;
+    download?(path: string, ctx: CallContext): MaybePromise<ReadableStream<Uint8Array>>;
+    watch?(path: string, cb: (e: FsEvent) => void, recursive: boolean, ctx: CallContext): MaybePromise<() => Promise<void>>;
+    exposePort?(port: number, opts: {
+        private?: boolean;
+    }, ctx: CallContext): MaybePromise<Preview>;
+    unexposePort?(port: number, ctx: CallContext): MaybePromise<void>;
+    listPorts?(ctx: CallContext): MaybePromise<Preview[]>;
+    proxyFetch?(port: number, path: string | undefined, init: RequestInit | undefined, ctx: CallContext): MaybePromise<Response>;
+    setEgressPolicy?(policy: EgressPolicy, ctx: CallContext): MaybePromise<void>;
+    createSsh?(ctx: CallContext): MaybePromise<SshCredentials>;
+    runCode?(code: string, opts: {
+        context?: KernelContext;
+        language?: string;
+        onStdout?: (chunk: string) => void;
+        onStderr?: (chunk: string) => void;
+    }, ctx: CallContext): MaybePromise<CodeExecution>;
+    createContext?(opts: {
+        language?: string;
+        cwd?: string;
+    }, ctx: CallContext): MaybePromise<KernelContext>;
+    snapshot?(opts: {
+        name?: string;
+    }, ctx: CallContext): MaybePromise<SnapshotRef>;
+    restoreSnapshot?(ref: string, ctx: CallContext): MaybePromise<void>;
+    fork?(count: number, ctx: CallContext): MaybePromise<DriverHandle<Raw>[]>;
+    listSnapshots?(ctx: CallContext): MaybePromise<SnapshotRef[]>;
+    deleteSnapshot?(ref: string, ctx: CallContext): MaybePromise<void>;
+}
+/** THE contract object each provider factory returns. */
+export interface SandboxProvider<Caps extends CapabilityMap = CapabilityMap, Raw = unknown> {
+    readonly name: string;
+    readonly capabilities: Caps;
+    readonly flags: CapabilityFlags;
+    readonly mapError?: (err: unknown) => SandboxError | undefined;
+    create(spec: SandboxSpec, ctx: CallContext): MaybePromise<DriverHandle<Raw>>;
+    connect(id: string, ctx: CallContext): MaybePromise<DriverHandle<Raw>>;
+    list?(filter: ListFilter | undefined, ctx: CallContext): AsyncIterable<SandboxInfo>;
+    dispose?(): MaybePromise<void>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/internal/types.d.ts.map

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

package/dist/internal/types.js

@@ -0,0 +1 @@
+export {};

package/dist/langchain/index.d.ts

@@ -0,0 +1,25 @@
+import type { StructuredToolInterface } from "@langchain/core/tools";
+import type { FrameworkAdapter, ToolSetOptions, ToolSpec } from "../agent-tools/types.js";
+import type { Sandbox } from "../internal/types.js";
+export type LangChainToolOptions = ToolSetOptions;
+/** Array of LangChain structured tools. */
+export type LangChainToolSet = StructuredToolInterface[];
+/**
+ * Build LangChain tools from a live sandbox (capability-gated) or a pre-built
+ * `ToolSpec[]`. Pass the result to a LangChain agent or LangGraph `ToolNode`.
+ */
+export declare function toLangChainTools(source: Sandbox | ToolSpec[], opts?: LangChainToolOptions): LangChainToolSet;
+/**
+ * The LangChain framework adapter for the `ai()` plugin:
+ *
+ * ```ts
+ * import { ai } from "sbox-sdk/ai";
+ * import { langchain } from "sbox-sdk/langchain";
+ *
+ * const client = createSandboxClient({ provider: e2b(), plugins: [ai({ framework: langchain() })] });
+ * const sandbox = await client.create();
+ * const agent = createReactAgent({ llm, tools: sandbox.tools });
+ * ```
+ */
+export declare function langchain(): FrameworkAdapter<LangChainToolSet>;
+//# sourceMappingURL=index.d.ts.map

package/dist/langchain/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/langchain/index.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AAIrE,OAAO,KAAK,EACV,gBAAgB,EAEhB,cAAc,EACd,QAAQ,EACT,MAAM,yBAAyB,CAAC;AACjC,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAEpD,MAAM,MAAM,oBAAoB,GAAG,cAAc,CAAC;AAElD,2CAA2C;AAC3C,MAAM,MAAM,gBAAgB,GAAG,uBAAuB,EAAE,CAAC;AAazD;;;GAGG;AACH,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,OAAO,GAAG,QAAQ,EAAE,EAC5B,IAAI,GAAE,oBAAyB,GAC9B,gBAAgB,CAkBlB;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,SAAS,IAAI,gBAAgB,CAAC,gBAAgB,CAAC,CAK9D"}

package/dist/langchain/index.js

@@ -0,0 +1,61 @@
+/**
+ * `sbox-sdk/langchain` — LangChain (TS) adapter. Projects the provider-neutral
+ * sandbox tool registry into `@langchain/core` `tool()` objects, returned as an
+ * array for any LangChain agent / LangGraph `ToolNode`.
+ *
+ * Approval: enforced inside the tool function via the shared `enforcePolicy`
+ * (`"deny"` short-circuits; `"ask"` awaits `policy.onApprovalRequest`). For
+ * graph-native human-in-the-loop, wrap the call in a LangGraph `interrupt()` —
+ * a documented follow-up (kept out of v1 so the only peer is `@langchain/core`).
+ *
+ * Peer dependency: `@langchain/core` (optional).
+ */
+import { tool } from "@langchain/core/tools";
+import { enforcePolicy } from "../agent-tools/policy.js";
+import { createSandboxTools } from "../agent-tools/registry.js";
+function resolve(source, opts) {
+    return Array.isArray(source)
+        ? { specs: source }
+        : { sandbox: source, specs: createSandboxTools(source, opts) };
+}
+/**
+ * Build LangChain tools from a live sandbox (capability-gated) or a pre-built
+ * `ToolSpec[]`. Pass the result to a LangChain agent or LangGraph `ToolNode`.
+ */
+export function toLangChainTools(source, opts = {}) {
+    const { specs, sandbox } = resolve(source, opts);
+    const { policy } = opts;
+    return specs.map((spec) => {
+        const run = async (input) => {
+            const ctx = { sandbox };
+            const denied = await enforcePolicy(spec, input, ctx, policy);
+            if (denied !== null) {
+                return denied;
+            }
+            return (await spec.execute(input, ctx)).text;
+        };
+        return tool(run, {
+            description: spec.description,
+            name: spec.name,
+            schema: spec.inputSchema,
+        });
+    });
+}
+/**
+ * The LangChain framework adapter for the `ai()` plugin:
+ *
+ * ```ts
+ * import { ai } from "sbox-sdk/ai";
+ * import { langchain } from "sbox-sdk/langchain";
+ *
+ * const client = createSandboxClient({ provider: e2b(), plugins: [ai({ framework: langchain() })] });
+ * const sandbox = await client.create();
+ * const agent = createReactAgent({ llm, tools: sandbox.tools });
+ * ```
+ */
+export function langchain() {
+    return {
+        build: (sandbox, opts) => toLangChainTools(sandbox, opts),
+        name: "langchain",
+    };
+}

package/dist/mastra/index.d.ts

@@ -0,0 +1,43 @@
+/**
+ * `sbox-sdk/mastra` — Mastra adapter. Projects the provider-neutral sandbox tool
+ * registry into Mastra's `createTool()` shape, keyed by tool id so the result
+ * drops into `new Agent({ tools })` or `new Mastra({ tools })`.
+ *
+ * Mastra is built on the AI SDK and also accepts AI SDK tools directly, so the
+ * `vercelAI()` plugin's output works in a Mastra agent too; this native adapter
+ * additionally gives Mastra-native registration (and a path to `outputSchema` /
+ * `suspend()`-based HITL in a follow-up).
+ *
+ * Approval is enforced inside `execute` via the shared `enforcePolicy` (same as
+ * every other adapter): `"deny"` short-circuits, `"ask"` awaits
+ * `policy.onApprovalRequest` when configured. Native Mastra `suspend()` HITL is
+ * a planned enhancement.
+ *
+ * Peer dependency: `@mastra/core` (optional).
+ */
+import { createTool } from "@mastra/core/tools";
+import type { FrameworkAdapter, ToolSetOptions, ToolSpec } from "../agent-tools/types.js";
+import type { Sandbox } from "../internal/types.js";
+export type MastraToolOptions = ToolSetOptions;
+/** Every spec erases its input schema to `unknown`, so the concrete `Tool`
+ *  instances share `Tool<unknown, …>` and assign cleanly into this record. */
+export type MastraToolSet = Record<string, ReturnType<typeof createTool>>;
+/**
+ * Build Mastra tools from a live sandbox (capability-gated) or a pre-built
+ * `ToolSpec[]`. Register the result on an Agent or the Mastra instance.
+ */
+export declare function toMastraTools(source: Sandbox | ToolSpec[], opts?: MastraToolOptions): MastraToolSet;
+/**
+ * The Mastra framework adapter for the `ai()` plugin:
+ *
+ * ```ts
+ * import { ai } from "sbox-sdk/ai";
+ * import { mastra } from "sbox-sdk/mastra";
+ *
+ * const client = createSandboxClient({ provider: e2b(), plugins: [ai({ framework: mastra() })] });
+ * const sandbox = await client.create();
+ * const agent = new Agent({ name: "coder", model, tools: sandbox.tools });
+ * ```
+ */
+export declare function mastra(): FrameworkAdapter<MastraToolSet>;
+//# sourceMappingURL=index.d.ts.map

package/dist/mastra/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/mastra/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AACH,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAKhD,OAAO,KAAK,EACV,gBAAgB,EAEhB,cAAc,EACd,QAAQ,EACT,MAAM,yBAAyB,CAAC;AACjC,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAEpD,MAAM,MAAM,iBAAiB,GAAG,cAAc,CAAC;AAE/C;8EAC8E;AAC9E,MAAM,MAAM,aAAa,GAAG,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,OAAO,UAAU,CAAC,CAAC,CAAC;AAa1E;;;GAGG;AACH,wBAAgB,aAAa,CAC3B,MAAM,EAAE,OAAO,GAAG,QAAQ,EAAE,EAC5B,IAAI,GAAE,iBAAsB,GAC3B,aAAa,CAqBf;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,MAAM,IAAI,gBAAgB,CAAC,aAAa,CAAC,CAKxD"}

package/dist/mastra/index.js

@@ -0,0 +1,69 @@
+/**
+ * `sbox-sdk/mastra` — Mastra adapter. Projects the provider-neutral sandbox tool
+ * registry into Mastra's `createTool()` shape, keyed by tool id so the result
+ * drops into `new Agent({ tools })` or `new Mastra({ tools })`.
+ *
+ * Mastra is built on the AI SDK and also accepts AI SDK tools directly, so the
+ * `vercelAI()` plugin's output works in a Mastra agent too; this native adapter
+ * additionally gives Mastra-native registration (and a path to `outputSchema` /
+ * `suspend()`-based HITL in a follow-up).
+ *
+ * Approval is enforced inside `execute` via the shared `enforcePolicy` (same as
+ * every other adapter): `"deny"` short-circuits, `"ask"` awaits
+ * `policy.onApprovalRequest` when configured. Native Mastra `suspend()` HITL is
+ * a planned enhancement.
+ *
+ * Peer dependency: `@mastra/core` (optional).
+ */
+import { createTool } from "@mastra/core/tools";
+import { enforcePolicy } from "../agent-tools/policy.js";
+import { createSandboxTools } from "../agent-tools/registry.js";
+function resolve(source, opts) {
+    return Array.isArray(source)
+        ? { specs: source }
+        : { sandbox: source, specs: createSandboxTools(source, opts) };
+}
+/**
+ * Build Mastra tools from a live sandbox (capability-gated) or a pre-built
+ * `ToolSpec[]`. Register the result on an Agent or the Mastra instance.
+ */
+export function toMastraTools(source, opts = {}) {
+    const { specs, sandbox } = resolve(source, opts);
+    const { policy } = opts;
+    const tools = {};
+    for (const spec of specs) {
+        tools[spec.name] = createTool({
+            description: spec.description,
+            execute: async (inputData) => {
+                const ctx = { sandbox };
+                const denied = await enforcePolicy(spec, inputData, ctx, policy);
+                if (denied !== null) {
+                    return denied;
+                }
+                const result = await spec.execute(inputData, ctx);
+                return result.text;
+            },
+            id: spec.name,
+            inputSchema: spec.inputSchema,
+        });
+    }
+    return tools;
+}
+/**
+ * The Mastra framework adapter for the `ai()` plugin:
+ *
+ * ```ts
+ * import { ai } from "sbox-sdk/ai";
+ * import { mastra } from "sbox-sdk/mastra";
+ *
+ * const client = createSandboxClient({ provider: e2b(), plugins: [ai({ framework: mastra() })] });
+ * const sandbox = await client.create();
+ * const agent = new Agent({ name: "coder", model, tools: sandbox.tools });
+ * ```
+ */
+export function mastra() {
+    return {
+        build: (sandbox, opts) => toMastraTools(sandbox, opts),
+        name: "mastra",
+    };
+}