@finalai/agent-provider 0.1.0

package/dist/modules/sandbox/wire.d.mts

@@ -0,0 +1,671 @@
+import * as z from 'zod';
+import { type JsonValue } from "../json.mjs";
+import { NetworkPolicy, PortProtocol, SandboxCapability, SandboxEntryType } from "./types.mjs";
+export declare const HANDLE_RPC_VERSION = 1;
+export declare const HANDLE_RPC_SUBPROTOCOL = "final.handle-rpc.v1";
+export declare const HANDLE_RPC_BEARER_PROTOCOL_PREFIX = "bearer.";
+export declare const MAX_CHUNK_BYTES: number;
+export declare const INITIAL_STREAM_WINDOW_BYTES: number;
+export declare const MAX_INLINE_WRITE_BYTES: number;
+export declare const BINARY_FRAME_MAGIC = 241;
+export declare const BINARY_FRAME_HEADER_BYTES = 6;
+export declare enum BinaryFrameKind {
+    Chunk = 1
+}
+export declare enum HandleRpcCloseCode {
+    Normal = 1000,
+    ProtocolError = 4400,
+    Unauthorized = 4401
+}
+export declare enum HandleRpcErrorCode {
+    ParseError = -32700,
+    InvalidRequest = -32600,
+    MethodNotFound = -32601,
+    InvalidParams = -32602,
+    Internal = -32603,
+    Unauthorized = -32001,
+    NotInitialized = -32002,
+    Forbidden = -32010,
+    NotFound = -32011,
+    Unsupported = -32012,
+    ConnectionClosed = -32013,
+    Timeout = -32014,
+    Cancelled = -32800
+}
+export declare enum HandleRpcMethod {
+    Initialize = "initialize",
+    Describe = "sandbox/describe",
+    ReadFile = "sandbox/readFile",
+    ReadTextFile = "sandbox/readTextFile",
+    WriteFile = "sandbox/writeFile",
+    Spawn = "sandbox/spawn",
+    Run = "sandbox/run",
+    Stat = "sandbox/stat",
+    ReadDir = "sandbox/readDir",
+    RemovePath = "sandbox/removePath",
+    GetPortEndpoint = "sandbox/getPortEndpoint",
+    Stop = "sandbox/stop",
+    Destroy = "sandbox/destroy",
+    SetNetworkPolicy = "sandbox/setNetworkPolicy",
+    OnSandboxStop = "handle/onSandboxStop",
+    OnSandboxDelete = "handle/onSandboxDelete",
+    OnRuntimeShutdown = "handle/onRuntimeShutdown",
+    ComputerUse = "sandbox/computerUse",
+    Screen = "sandbox/screen",
+    LocalMcp = "sandbox/localMcp",
+    McpOpen = "mcp/open",
+    McpSend = "mcp/send",
+    McpReceive = "mcp/receive",
+    McpClose = "mcp/close",
+    ProcessWait = "process/wait",
+    ProcessKill = "process/kill",
+    AuthRefresh = "auth/refresh"
+}
+export declare enum HandleRpcNotification {
+    CancelRequest = "$/cancel_request",
+    StreamChunk = "stream/chunk",
+    StreamEnd = "stream/end",
+    StreamError = "stream/error",
+    StreamCredit = "stream/credit",
+    StreamCancel = "stream/cancel"
+}
+export interface HandleRpcErrorIface extends Error {
+    readonly code: HandleRpcErrorCode;
+    readonly retryable: boolean;
+    readonly errno: string | null;
+    readonly data: JsonValue | null;
+}
+export declare const handleRpcError: (args: {
+    code: HandleRpcErrorCode;
+    message: string;
+    retryable?: boolean;
+    errno?: string | null;
+    data?: JsonValue | null;
+}) => HandleRpcErrorIface;
+export declare const isHandleRpcError: (cause: unknown) => cause is HandleRpcErrorIface;
+export declare const errnoOf: (cause: unknown) => string | null;
+declare const jsonRpcIdSchema: z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>;
+export type JsonRpcId = z.infer<typeof jsonRpcIdSchema>;
+export declare const jsonRpcRequestSchema: z.ZodObject<{
+    jsonrpc: z.ZodLiteral<"2.0">;
+    id: z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>;
+    method: z.ZodString;
+    params: z.ZodOptional<z.ZodType<JsonValue, unknown, z.core.$ZodTypeInternals<JsonValue, unknown>>>;
+}, z.core.$strip>;
+export declare const jsonRpcNotificationSchema: z.ZodObject<{
+    jsonrpc: z.ZodLiteral<"2.0">;
+    method: z.ZodString;
+    params: z.ZodOptional<z.ZodType<JsonValue, unknown, z.core.$ZodTypeInternals<JsonValue, unknown>>>;
+}, z.core.$strip>;
+export declare const jsonRpcErrorObjectSchema: z.ZodObject<{
+    code: z.ZodNumber;
+    message: z.ZodString;
+    data: z.ZodOptional<z.ZodType<JsonValue, unknown, z.core.$ZodTypeInternals<JsonValue, unknown>>>;
+}, z.core.$strip>;
+export declare const jsonRpcSuccessSchema: z.ZodObject<{
+    jsonrpc: z.ZodLiteral<"2.0">;
+    id: z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>;
+    result: z.ZodType<JsonValue, unknown, z.core.$ZodTypeInternals<JsonValue, unknown>>;
+}, z.core.$strip>;
+export declare const jsonRpcErrorResponseSchema: z.ZodObject<{
+    jsonrpc: z.ZodLiteral<"2.0">;
+    id: z.ZodNullable<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+    error: z.ZodObject<{
+        code: z.ZodNumber;
+        message: z.ZodString;
+        data: z.ZodOptional<z.ZodType<JsonValue, unknown, z.core.$ZodTypeInternals<JsonValue, unknown>>>;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+export type JsonRpcRequestIface = z.infer<typeof jsonRpcRequestSchema>;
+export type JsonRpcNotificationIface = z.infer<typeof jsonRpcNotificationSchema>;
+export type JsonRpcErrorObjectIface = z.infer<typeof jsonRpcErrorObjectSchema>;
+export declare const handleRpcErrorDataSchema: z.ZodObject<{
+    errno: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    retryable: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>;
+export declare const sandboxCapabilitiesSchema: z.ZodPipe<z.ZodArray<z.ZodString>, z.ZodTransform<SandboxCapability[], string[]>>;
+export declare const statSchema: z.ZodObject<{
+    path: z.ZodString;
+    type: z.ZodPipe<z.ZodString, z.ZodTransform<SandboxEntryType, string>>;
+    size: z.ZodNumber;
+    modifiedAt: z.ZodNullable<z.ZodString>;
+    mode: z.ZodNullable<z.ZodNumber>;
+}, z.core.$strip>;
+export declare const dirEntrySchema: z.ZodObject<{
+    name: z.ZodString;
+    path: z.ZodString;
+    type: z.ZodPipe<z.ZodString, z.ZodTransform<SandboxEntryType, string>>;
+    size: z.ZodNullable<z.ZodNumber>;
+}, z.core.$strip>;
+export declare const mcpEndpointSchema: z.ZodObject<{
+    name: z.ZodString;
+    url: z.ZodString;
+    headers: z.ZodRecord<z.ZodString, z.ZodString>;
+}, z.core.$strip>;
+export declare const mcpChannelEndpointSchema: z.ZodObject<{
+    name: z.ZodString;
+    endpointKey: z.ZodString;
+}, z.core.$strip>;
+export declare const sandboxMcpEndpointSchema: z.ZodUnion<readonly [z.ZodObject<{
+    name: z.ZodString;
+    url: z.ZodString;
+    headers: z.ZodRecord<z.ZodString, z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+    name: z.ZodString;
+    endpointKey: z.ZodString;
+}, z.core.$strip>]>;
+export declare const screenOptionsSchema: z.ZodObject<{
+    viewOnly: z.ZodDefault<z.ZodBoolean>;
+}, z.core.$strict>;
+export declare const screenSessionSchema: z.ZodObject<{
+    url: z.ZodString;
+    token: z.ZodString;
+    expiresAt: z.ZodString;
+}, z.core.$strip>;
+export declare const describeResultSchema: z.ZodObject<{
+    handleRpcVersion: z.ZodLiteral<1>;
+    id: z.ZodString;
+    defaultWorkingDirectory: z.ZodString;
+    ports: z.ZodArray<z.ZodNumber>;
+    capabilities: z.ZodPipe<z.ZodArray<z.ZodString>, z.ZodTransform<SandboxCapability[], string[]>>;
+    description: z.ZodString;
+    confinedFiles: z.ZodOptional<z.ZodBoolean>;
+    providerHooks: z.ZodOptional<z.ZodBoolean>;
+    mcpChannels: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>;
+export declare const initializeParamsSchema: z.ZodObject<{
+    handleRpcVersion: z.ZodLiteral<1>;
+    token: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    client: z.ZodOptional<z.ZodObject<{
+        name: z.ZodString;
+        version: z.ZodString;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export declare const initializeResultSchema: z.ZodObject<{
+    handleRpcVersion: z.ZodLiteral<1>;
+    id: z.ZodString;
+    defaultWorkingDirectory: z.ZodString;
+    ports: z.ZodArray<z.ZodNumber>;
+    capabilities: z.ZodPipe<z.ZodArray<z.ZodString>, z.ZodTransform<SandboxCapability[], string[]>>;
+    description: z.ZodString;
+    confinedFiles: z.ZodOptional<z.ZodBoolean>;
+    providerHooks: z.ZodOptional<z.ZodBoolean>;
+    mcpChannels: z.ZodOptional<z.ZodBoolean>;
+    expiresAt: z.ZodNullable<z.ZodString>;
+}, z.core.$strip>;
+export declare const readFileParamsSchema: z.ZodObject<{
+    root: z.ZodOptional<z.ZodString>;
+    path: z.ZodString;
+    streamId: z.ZodNumber;
+    offset: z.ZodOptional<z.ZodNumber>;
+    length: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+export declare const readFileResultSchema: z.ZodObject<{
+    found: z.ZodBoolean;
+}, z.core.$strip>;
+export declare const readTextFileParamsSchema: z.ZodObject<{
+    path: z.ZodString;
+    encoding: z.ZodOptional<z.ZodString>;
+    startLine: z.ZodOptional<z.ZodNumber>;
+    endLine: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+export declare const readTextFileResultSchema: z.ZodObject<{
+    text: z.ZodNullable<z.ZodString>;
+}, z.core.$strip>;
+export declare const writeFileParamsSchema: z.ZodObject<{
+    path: z.ZodString;
+    streamId: z.ZodOptional<z.ZodNumber>;
+    contentBase64: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare const spawnParamsSchema: z.ZodObject<{
+    processId: z.ZodString;
+    stdinStreamId: z.ZodNullable<z.ZodNumber>;
+    stdoutStreamId: z.ZodNumber;
+    stderrStreamId: z.ZodNumber;
+    command: z.ZodString;
+    args: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    cwd: z.ZodOptional<z.ZodString>;
+    env: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    shell: z.ZodOptional<z.ZodBoolean>;
+    timeoutMs: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+export declare const spawnResultSchema: z.ZodObject<{
+    pid: z.ZodNullable<z.ZodString>;
+}, z.core.$strip>;
+export declare const runParamsSchema: z.ZodObject<{
+    stdin: z.ZodOptional<z.ZodString>;
+    command: z.ZodString;
+    args: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    cwd: z.ZodOptional<z.ZodString>;
+    env: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    shell: z.ZodOptional<z.ZodBoolean>;
+    timeoutMs: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+export declare const runResultSchema: z.ZodObject<{
+    exitCode: z.ZodNumber;
+    stdout: z.ZodString;
+    stderr: z.ZodString;
+}, z.core.$strip>;
+export declare const pathParamsSchema: z.ZodObject<{
+    path: z.ZodString;
+    root: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare const statResultSchema: z.ZodObject<{
+    stat: z.ZodNullable<z.ZodObject<{
+        path: z.ZodString;
+        type: z.ZodPipe<z.ZodString, z.ZodTransform<SandboxEntryType, string>>;
+        size: z.ZodNumber;
+        modifiedAt: z.ZodNullable<z.ZodString>;
+        mode: z.ZodNullable<z.ZodNumber>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export declare const readDirResultSchema: z.ZodObject<{
+    entries: z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        path: z.ZodString;
+        type: z.ZodPipe<z.ZodString, z.ZodTransform<SandboxEntryType, string>>;
+        size: z.ZodNullable<z.ZodNumber>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export declare const removePathParamsSchema: z.ZodObject<{
+    path: z.ZodString;
+    recursive: z.ZodOptional<z.ZodBoolean>;
+    force: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>;
+export declare const getPortEndpointParamsSchema: z.ZodObject<{
+    port: z.ZodNumber;
+    protocol: z.ZodOptional<z.ZodEnum<typeof PortProtocol>>;
+}, z.core.$strip>;
+export declare const getPortEndpointResultSchema: z.ZodObject<{
+    url: z.ZodString;
+    headers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+}, z.core.$strip>;
+export declare const setNetworkPolicyParamsSchema: z.ZodObject<{
+    mode: z.ZodEnum<typeof NetworkPolicy>;
+    allow: z.ZodOptional<z.ZodArray<z.ZodString>>;
+}, z.core.$strip>;
+export declare const sandboxDeleteHookParamsSchema: z.ZodObject<{
+    reason: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare const localMcpResultSchema: z.ZodObject<{
+    endpoints: z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
+        name: z.ZodString;
+        url: z.ZodString;
+        headers: z.ZodRecord<z.ZodString, z.ZodString>;
+    }, z.core.$strip>, z.ZodObject<{
+        name: z.ZodString;
+        endpointKey: z.ZodString;
+    }, z.core.$strip>]>>;
+}, z.core.$strip>;
+export declare const mcpOpenParamsSchema: z.ZodObject<{
+    endpointKey: z.ZodString;
+}, z.core.$strip>;
+export declare const mcpChannelParamsSchema: z.ZodObject<{
+    channelId: z.ZodString;
+}, z.core.$strip>;
+export declare const mcpSendParamsSchema: z.ZodObject<{
+    channelId: z.ZodString;
+    message: z.ZodType<JsonValue, unknown, z.core.$ZodTypeInternals<JsonValue, unknown>>;
+}, z.core.$strip>;
+export declare const mcpOpenResultSchema: z.ZodObject<{
+    channelId: z.ZodString;
+}, z.core.$strip>;
+export declare const mcpReceiveResultSchema: z.ZodObject<{
+    messages: z.ZodArray<z.ZodType<JsonValue, unknown, z.core.$ZodTypeInternals<JsonValue, unknown>>>;
+}, z.core.$strip>;
+export declare const processIdParamsSchema: z.ZodObject<{
+    processId: z.ZodString;
+}, z.core.$strip>;
+export declare const processWaitResultSchema: z.ZodObject<{
+    exitCode: z.ZodNumber;
+}, z.core.$strip>;
+export declare const processKillParamsSchema: z.ZodObject<{
+    processId: z.ZodString;
+    signal: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare const authRefreshParamsSchema: z.ZodObject<{
+    token: z.ZodString;
+}, z.core.$strip>;
+export declare const authRefreshResultSchema: z.ZodObject<{
+    expiresAt: z.ZodNullable<z.ZodString>;
+}, z.core.$strip>;
+export declare const cancelRequestParamsSchema: z.ZodObject<{
+    requestId: z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>;
+}, z.core.$strip>;
+export declare const streamChunkParamsSchema: z.ZodObject<{
+    streamId: z.ZodNumber;
+    data: z.ZodString;
+}, z.core.$strip>;
+export declare const streamEndParamsSchema: z.ZodObject<{
+    streamId: z.ZodNumber;
+}, z.core.$strip>;
+export declare const streamErrorParamsSchema: z.ZodObject<{
+    streamId: z.ZodNumber;
+    message: z.ZodString;
+    code: z.ZodOptional<z.ZodNumber>;
+    errno: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, z.core.$strip>;
+export declare const streamCreditParamsSchema: z.ZodObject<{
+    streamId: z.ZodNumber;
+    bytes: z.ZodNumber;
+}, z.core.$strip>;
+export declare const streamCancelParamsSchema: z.ZodObject<{
+    streamId: z.ZodNumber;
+    reason: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type DescribeResultIface = z.infer<typeof describeResultSchema>;
+export type InitializeResultIface = z.infer<typeof initializeResultSchema>;
+export declare const handleRpcMethodSchemas: {
+    readonly initialize: {
+        readonly params: z.ZodObject<{
+            handleRpcVersion: z.ZodLiteral<1>;
+            token: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            client: z.ZodOptional<z.ZodObject<{
+                name: z.ZodString;
+                version: z.ZodString;
+            }, z.core.$strip>>;
+        }, z.core.$strip>;
+        readonly result: z.ZodObject<{
+            handleRpcVersion: z.ZodLiteral<1>;
+            id: z.ZodString;
+            defaultWorkingDirectory: z.ZodString;
+            ports: z.ZodArray<z.ZodNumber>;
+            capabilities: z.ZodPipe<z.ZodArray<z.ZodString>, z.ZodTransform<SandboxCapability[], string[]>>;
+            description: z.ZodString;
+            confinedFiles: z.ZodOptional<z.ZodBoolean>;
+            providerHooks: z.ZodOptional<z.ZodBoolean>;
+            mcpChannels: z.ZodOptional<z.ZodBoolean>;
+            expiresAt: z.ZodNullable<z.ZodString>;
+        }, z.core.$strip>;
+    };
+    readonly "sandbox/describe": {
+        readonly params: z.ZodObject<{}, z.core.$loose>;
+        readonly result: z.ZodObject<{
+            handleRpcVersion: z.ZodLiteral<1>;
+            id: z.ZodString;
+            defaultWorkingDirectory: z.ZodString;
+            ports: z.ZodArray<z.ZodNumber>;
+            capabilities: z.ZodPipe<z.ZodArray<z.ZodString>, z.ZodTransform<SandboxCapability[], string[]>>;
+            description: z.ZodString;
+            confinedFiles: z.ZodOptional<z.ZodBoolean>;
+            providerHooks: z.ZodOptional<z.ZodBoolean>;
+            mcpChannels: z.ZodOptional<z.ZodBoolean>;
+        }, z.core.$strip>;
+    };
+    readonly "sandbox/readFile": {
+        readonly params: z.ZodObject<{
+            root: z.ZodOptional<z.ZodString>;
+            path: z.ZodString;
+            streamId: z.ZodNumber;
+            offset: z.ZodOptional<z.ZodNumber>;
+            length: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strip>;
+        readonly result: z.ZodObject<{
+            found: z.ZodBoolean;
+        }, z.core.$strip>;
+    };
+    readonly "sandbox/readTextFile": {
+        readonly params: z.ZodObject<{
+            path: z.ZodString;
+            encoding: z.ZodOptional<z.ZodString>;
+            startLine: z.ZodOptional<z.ZodNumber>;
+            endLine: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strip>;
+        readonly result: z.ZodObject<{
+            text: z.ZodNullable<z.ZodString>;
+        }, z.core.$strip>;
+    };
+    readonly "sandbox/writeFile": {
+        readonly params: z.ZodObject<{
+            path: z.ZodString;
+            streamId: z.ZodOptional<z.ZodNumber>;
+            contentBase64: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>;
+        readonly result: z.ZodObject<{}, z.core.$loose>;
+    };
+    readonly "sandbox/spawn": {
+        readonly params: z.ZodObject<{
+            processId: z.ZodString;
+            stdinStreamId: z.ZodNullable<z.ZodNumber>;
+            stdoutStreamId: z.ZodNumber;
+            stderrStreamId: z.ZodNumber;
+            command: z.ZodString;
+            args: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            cwd: z.ZodOptional<z.ZodString>;
+            env: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+            shell: z.ZodOptional<z.ZodBoolean>;
+            timeoutMs: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strip>;
+        readonly result: z.ZodObject<{
+            pid: z.ZodNullable<z.ZodString>;
+        }, z.core.$strip>;
+    };
+    readonly "sandbox/run": {
+        readonly params: z.ZodObject<{
+            stdin: z.ZodOptional<z.ZodString>;
+            command: z.ZodString;
+            args: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            cwd: z.ZodOptional<z.ZodString>;
+            env: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+            shell: z.ZodOptional<z.ZodBoolean>;
+            timeoutMs: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strip>;
+        readonly result: z.ZodObject<{
+            exitCode: z.ZodNumber;
+            stdout: z.ZodString;
+            stderr: z.ZodString;
+        }, z.core.$strip>;
+    };
+    readonly "sandbox/stat": {
+        readonly params: z.ZodObject<{
+            path: z.ZodString;
+            root: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>;
+        readonly result: z.ZodObject<{
+            stat: z.ZodNullable<z.ZodObject<{
+                path: z.ZodString;
+                type: z.ZodPipe<z.ZodString, z.ZodTransform<SandboxEntryType, string>>;
+                size: z.ZodNumber;
+                modifiedAt: z.ZodNullable<z.ZodString>;
+                mode: z.ZodNullable<z.ZodNumber>;
+            }, z.core.$strip>>;
+        }, z.core.$strip>;
+    };
+    readonly "sandbox/readDir": {
+        readonly params: z.ZodObject<{
+            path: z.ZodString;
+            root: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>;
+        readonly result: z.ZodObject<{
+            entries: z.ZodArray<z.ZodObject<{
+                name: z.ZodString;
+                path: z.ZodString;
+                type: z.ZodPipe<z.ZodString, z.ZodTransform<SandboxEntryType, string>>;
+                size: z.ZodNullable<z.ZodNumber>;
+            }, z.core.$strip>>;
+        }, z.core.$strip>;
+    };
+    readonly "sandbox/removePath": {
+        readonly params: z.ZodObject<{
+            path: z.ZodString;
+            recursive: z.ZodOptional<z.ZodBoolean>;
+            force: z.ZodOptional<z.ZodBoolean>;
+        }, z.core.$strip>;
+        readonly result: z.ZodObject<{}, z.core.$loose>;
+    };
+    readonly "sandbox/getPortEndpoint": {
+        readonly params: z.ZodObject<{
+            port: z.ZodNumber;
+            protocol: z.ZodOptional<z.ZodEnum<typeof PortProtocol>>;
+        }, z.core.$strip>;
+        readonly result: z.ZodObject<{
+            url: z.ZodString;
+            headers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+        }, z.core.$strip>;
+    };
+    readonly "sandbox/stop": {
+        readonly params: z.ZodObject<{}, z.core.$loose>;
+        readonly result: z.ZodObject<{}, z.core.$loose>;
+    };
+    readonly "sandbox/destroy": {
+        readonly params: z.ZodObject<{}, z.core.$loose>;
+        readonly result: z.ZodObject<{}, z.core.$loose>;
+    };
+    readonly "handle/onSandboxStop": {
+        readonly params: z.ZodObject<{}, z.core.$loose>;
+        readonly result: z.ZodObject<{}, z.core.$loose>;
+    };
+    readonly "handle/onSandboxDelete": {
+        readonly params: z.ZodObject<{
+            reason: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>;
+        readonly result: z.ZodObject<{}, z.core.$loose>;
+    };
+    readonly "handle/onRuntimeShutdown": {
+        readonly params: z.ZodObject<{}, z.core.$loose>;
+        readonly result: z.ZodObject<{}, z.core.$loose>;
+    };
+    readonly "sandbox/setNetworkPolicy": {
+        readonly params: z.ZodObject<{
+            mode: z.ZodEnum<typeof NetworkPolicy>;
+            allow: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        }, z.core.$strip>;
+        readonly result: z.ZodObject<{}, z.core.$loose>;
+    };
+    readonly "sandbox/computerUse": {
+        readonly params: z.ZodObject<{}, z.core.$loose>;
+        readonly result: z.ZodUnion<readonly [z.ZodObject<{
+            name: z.ZodString;
+            url: z.ZodString;
+            headers: z.ZodRecord<z.ZodString, z.ZodString>;
+        }, z.core.$strip>, z.ZodObject<{
+            name: z.ZodString;
+            endpointKey: z.ZodString;
+        }, z.core.$strip>]>;
+    };
+    readonly "sandbox/screen": {
+        readonly params: z.ZodObject<{
+            viewOnly: z.ZodDefault<z.ZodBoolean>;
+        }, z.core.$strict>;
+        readonly result: z.ZodObject<{
+            url: z.ZodString;
+            token: z.ZodString;
+            expiresAt: z.ZodString;
+        }, z.core.$strip>;
+    };
+    readonly "sandbox/localMcp": {
+        readonly params: z.ZodObject<{}, z.core.$loose>;
+        readonly result: z.ZodObject<{
+            endpoints: z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
+                name: z.ZodString;
+                url: z.ZodString;
+                headers: z.ZodRecord<z.ZodString, z.ZodString>;
+            }, z.core.$strip>, z.ZodObject<{
+                name: z.ZodString;
+                endpointKey: z.ZodString;
+            }, z.core.$strip>]>>;
+        }, z.core.$strip>;
+    };
+    readonly "mcp/open": {
+        readonly params: z.ZodObject<{
+            endpointKey: z.ZodString;
+        }, z.core.$strip>;
+        readonly result: z.ZodObject<{
+            channelId: z.ZodString;
+        }, z.core.$strip>;
+    };
+    readonly "mcp/send": {
+        readonly params: z.ZodObject<{
+            channelId: z.ZodString;
+            message: z.ZodType<JsonValue, unknown, z.core.$ZodTypeInternals<JsonValue, unknown>>;
+        }, z.core.$strip>;
+        readonly result: z.ZodObject<{}, z.core.$loose>;
+    };
+    readonly "mcp/receive": {
+        readonly params: z.ZodObject<{
+            channelId: z.ZodString;
+        }, z.core.$strip>;
+        readonly result: z.ZodObject<{
+            messages: z.ZodArray<z.ZodType<JsonValue, unknown, z.core.$ZodTypeInternals<JsonValue, unknown>>>;
+        }, z.core.$strip>;
+    };
+    readonly "mcp/close": {
+        readonly params: z.ZodObject<{
+            channelId: z.ZodString;
+        }, z.core.$strip>;
+        readonly result: z.ZodObject<{}, z.core.$loose>;
+    };
+    readonly "process/wait": {
+        readonly params: z.ZodObject<{
+            processId: z.ZodString;
+        }, z.core.$strip>;
+        readonly result: z.ZodObject<{
+            exitCode: z.ZodNumber;
+        }, z.core.$strip>;
+    };
+    readonly "process/kill": {
+        readonly params: z.ZodObject<{
+            processId: z.ZodString;
+            signal: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>;
+        readonly result: z.ZodObject<{}, z.core.$loose>;
+    };
+    readonly "auth/refresh": {
+        readonly params: z.ZodObject<{
+            token: z.ZodString;
+        }, z.core.$strip>;
+        readonly result: z.ZodObject<{
+            expiresAt: z.ZodNullable<z.ZodString>;
+        }, z.core.$strip>;
+    };
+};
+export declare const handleRpcNotificationSchemas: {
+    readonly "$/cancel_request": z.ZodObject<{
+        requestId: z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>;
+    }, z.core.$strip>;
+    readonly "stream/chunk": z.ZodObject<{
+        streamId: z.ZodNumber;
+        data: z.ZodString;
+    }, z.core.$strip>;
+    readonly "stream/end": z.ZodObject<{
+        streamId: z.ZodNumber;
+    }, z.core.$strip>;
+    readonly "stream/error": z.ZodObject<{
+        streamId: z.ZodNumber;
+        message: z.ZodString;
+        code: z.ZodOptional<z.ZodNumber>;
+        errno: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    }, z.core.$strip>;
+    readonly "stream/credit": z.ZodObject<{
+        streamId: z.ZodNumber;
+        bytes: z.ZodNumber;
+    }, z.core.$strip>;
+    readonly "stream/cancel": z.ZodObject<{
+        streamId: z.ZodNumber;
+        reason: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+};
+export type HandleRpcParams<M extends HandleRpcMethod> = z.input<(typeof handleRpcMethodSchemas)[M]['params']>;
+export type HandleRpcResult<M extends HandleRpcMethod> = z.output<(typeof handleRpcMethodSchemas)[M]['result']>;
+export type HandleRpcNotificationParams<N extends HandleRpcNotification> = z.input<(typeof handleRpcNotificationSchemas)[N]>;
+export type HandleRpcResultParsers = {
+    [M in HandleRpcMethod]: (raw: JsonValue) => HandleRpcResult<M>;
+};
+export declare const handleRpcResultParsers: HandleRpcResultParsers;
+export declare const parseHandleRpcResult: <M extends HandleRpcMethod>(method: M, raw: JsonValue) => HandleRpcResult<M>;
+export declare const parseHandleRpcMethod: (method: string) => HandleRpcMethod | null;
+export declare const HANDLE_RPC_FILE_WRITE_METHODS: readonly HandleRpcMethod[];
+export declare const HANDLE_RPC_EXECUTE_METHODS: readonly HandleRpcMethod[];
+export declare const HANDLE_RPC_WRITE_METHODS: readonly HandleRpcMethod[];
+export declare const HANDLE_RPC_LIFECYCLE_METHODS: readonly HandleRpcMethod[];
+export declare const HANDLE_RPC_IDEMPOTENT_METHODS: readonly HandleRpcMethod[];
+export declare const encodeChunkFrame: (streamId: number, payload: Uint8Array) => Uint8Array;
+export declare const decodeBinaryFrame: (frame: Uint8Array) => {
+    kind: BinaryFrameKind;
+    streamId: number;
+    payload: Uint8Array;
+} | null;
+export declare const encodeJsonRpc: (message: JsonValue) => string;
+export declare const handleRpcTokenFromRequest: (request: Request) => string | null;
+export declare const handleRpcClientProtocols: (token: string) => string[];
+export * from "./frame-channel.mjs";