@supertools-ai/core 0.1.0

package/dist/mcp/client.d.ts

@@ -0,0 +1,48 @@
+/**
+ * MCP Client
+ *
+ * Connects to MCP servers and fetches tool schemas.
+ * Uses the official MCP SDK for E2B Gateway connections.
+ */
+import type { MCPServerConfig, MCPServerE2BConfig, MCPConnection, MCPTool } from './types';
+/**
+ * E2B MCP Gateway client
+ *
+ * Connects to E2B's built-in MCP Gateway to access external MCP servers
+ * like Browserbase, Exa, etc.
+ *
+ * Uses the official MCP SDK for proper protocol handling.
+ */
+export declare class E2BMCPClient implements MCPConnection {
+    readonly config: MCPServerE2BConfig;
+    readonly tools: MCPTool[];
+    private readonly mcpUrl;
+    private readonly mcpToken;
+    private client;
+    private transport;
+    constructor(config: MCPServerE2BConfig, mcpUrl: string, mcpToken: string);
+    /**
+     * Connect to MCP gateway and fetch available tools
+     */
+    fetchTools(): Promise<void>;
+    /**
+     * Call an MCP tool via the gateway
+     *
+     * Automatically unwraps MCP responses from { content: [...] } format
+     * to the actual data (parsed JSON or raw text).
+     */
+    callTool(name: string, args: Record<string, unknown>): Promise<unknown>;
+    disconnect(): Promise<void>;
+}
+/**
+ * Create MCP connections for the given server configs
+ *
+ * Note: The sandbox must be created with MCP configuration to have
+ * getMcpUrl() and getMcpToken() methods available.
+ */
+export declare function connectMCPServers(configs: readonly MCPServerConfig[], sandbox: unknown): Promise<MCPConnection[]>;
+/**
+ * Disconnect all MCP connections
+ */
+export declare function disconnectMCPServers(connections: readonly MCPConnection[]): Promise<void>;
+//# sourceMappingURL=client.d.ts.map

package/dist/mcp/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/mcp/client.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,KAAK,EACV,eAAe,EACf,kBAAkB,EAClB,aAAa,EACb,OAAO,EACR,MAAM,SAAS,CAAC;AA0DjB;;;;;;;GAOG;AACH,qBAAa,YAAa,YAAW,aAAa;IAChD,QAAQ,CAAC,MAAM,EAAE,kBAAkB,CAAC;IACpC,QAAQ,CAAC,KAAK,EAAE,OAAO,EAAE,CAAM;IAE/B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,MAAM,CAAuB;IACrC,OAAO,CAAC,SAAS,CAA8C;gBAG7D,MAAM,EAAE,kBAAkB,EAC1B,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM;IAOlB;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAsCjC;;;;;OAKG;IACG,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC;IASvE,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;CAOlC;AAED;;;;;GAKG;AACH,wBAAsB,iBAAiB,CACrC,OAAO,EAAE,SAAS,eAAe,EAAE,EACnC,OAAO,EAAE,OAAO,GACf,OAAO,CAAC,aAAa,EAAE,CAAC,CAmC1B;AAED;;GAEG;AACH,wBAAsB,oBAAoB,CACxC,WAAW,EAAE,SAAS,aAAa,EAAE,GACpC,OAAO,CAAC,IAAI,CAAC,CAEf"}

package/dist/mcp/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * MCP (Model Context Protocol) Support
+ *
+ * Enables programmatic calling of MCP tools via E2B sandbox.
+ */
+export * from './types';
+export * from './schema';
+export * from './client';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/mcp/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,SAAS,CAAC;AACxB,cAAc,UAAU,CAAC;AACzB,cAAc,UAAU,CAAC"}

package/dist/mcp/schema.d.ts

@@ -0,0 +1,20 @@
+/**
+ * MCP Schema Converter
+ *
+ * Converts MCP tool definitions (JSON Schema) to Supertools NormalizedTool format.
+ */
+import type { NormalizedTool } from '../tool';
+import type { MCPTool, MCPConnection } from './types';
+/**
+ * Convert an MCP tool to NormalizedTool format
+ */
+export declare function mcpToolToNormalized(tool: MCPTool, connection: MCPConnection): NormalizedTool;
+/**
+ * Convert all tools from an MCP connection to NormalizedTool array
+ */
+export declare function mcpToolsToNormalized(connection: MCPConnection): NormalizedTool[];
+/**
+ * Generate TypeScript type hint for an MCP tool (for LLM prompt)
+ */
+export declare function generateMCPTypeHint(tool: MCPTool): string;
+//# sourceMappingURL=schema.d.ts.map

package/dist/mcp/schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../src/mcp/schema.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAuB,cAAc,EAAE,MAAM,SAAS,CAAC;AACnE,OAAO,KAAK,EAAE,OAAO,EAAE,aAAa,EAAsB,MAAM,SAAS,CAAC;AA2D1E;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,OAAO,EACb,UAAU,EAAE,aAAa,GACxB,cAAc,CAahB;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,UAAU,EAAE,aAAa,GAAG,cAAc,EAAE,CAEhF;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,OAAO,GAAG,MAAM,CA4BzD"}

package/dist/mcp/types.d.ts

@@ -0,0 +1,96 @@
+/**
+ * MCP (Model Context Protocol) type definitions
+ *
+ * These types match the MCP specification for tools.
+ * @see https://modelcontextprotocol.io/specification/2025-06-18
+ */
+/**
+ * JSON Schema property definition
+ */
+export interface JsonSchemaProperty {
+    readonly type?: string | readonly string[];
+    readonly description?: string;
+    readonly enum?: readonly unknown[];
+    readonly items?: JsonSchemaProperty;
+    readonly properties?: Readonly<Record<string, JsonSchemaProperty>>;
+    readonly required?: readonly string[];
+    readonly default?: unknown;
+    readonly minLength?: number;
+    readonly maxLength?: number;
+    readonly minimum?: number;
+    readonly maximum?: number;
+}
+/**
+ * JSON Schema for tool input parameters
+ */
+export interface JsonSchema {
+    readonly type: 'object';
+    readonly properties?: Readonly<Record<string, JsonSchemaProperty>>;
+    readonly required?: readonly string[];
+}
+/**
+ * MCP Tool definition as returned by tools/list
+ */
+export interface MCPTool {
+    readonly name: string;
+    readonly description: string;
+    readonly inputSchema: JsonSchema;
+}
+/**
+ * MCP tools/list response
+ */
+export interface MCPToolsListResponse {
+    readonly tools: readonly MCPTool[];
+}
+/**
+ * MCP tool call request
+ */
+export interface MCPToolCallRequest {
+    readonly name: string;
+    readonly arguments?: Readonly<Record<string, unknown>>;
+}
+/**
+ * MCP tool call response
+ */
+export interface MCPToolCallResponse {
+    readonly content: readonly MCPToolContent[];
+    readonly isError?: boolean;
+}
+export interface MCPToolContent {
+    readonly type: 'text' | 'image' | 'resource';
+    readonly text?: string;
+    readonly data?: string;
+    readonly mimeType?: string;
+}
+/**
+ * MCP Server configuration
+ */
+export type MCPServerConfig = MCPServerStdioConfig | MCPServerSSEConfig | MCPServerE2BConfig;
+export interface MCPServerStdioConfig {
+    readonly transport: 'stdio';
+    readonly command: string;
+    readonly args?: readonly string[];
+    readonly env?: Readonly<Record<string, string>>;
+}
+export interface MCPServerSSEConfig {
+    readonly transport: 'sse';
+    readonly url: string;
+    readonly headers?: Readonly<Record<string, string>>;
+}
+export interface MCPServerE2BConfig {
+    readonly transport: 'e2b';
+    /** MCP server name from E2B's gateway (e.g., 'browserbase', 'exa') */
+    readonly name: string;
+    /** API key for the MCP server (if required) */
+    readonly apiKey?: string;
+}
+/**
+ * Connected MCP server with tools
+ */
+export interface MCPConnection {
+    readonly config: MCPServerConfig;
+    readonly tools: readonly MCPTool[];
+    callTool(name: string, args: Record<string, unknown>): Promise<unknown>;
+    disconnect(): Promise<void>;
+}
+//# sourceMappingURL=types.d.ts.map

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

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

package/dist/prompts.d.ts

@@ -0,0 +1,7 @@
+/**
+ * System prompt template for code generation.
+ * Uses XML structure for clear parsing by LLMs.
+ */
+export declare function buildSystemPrompt(toolDefinitions: string, additionalInstructions?: string): string;
+export declare function extractCode(response: string): string;
+//# sourceMappingURL=prompts.d.ts.map

package/dist/prompts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompts.d.ts","sourceRoot":"","sources":["../src/prompts.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,wBAAgB,iBAAiB,CAAC,eAAe,EAAE,MAAM,EAAE,sBAAsB,CAAC,EAAE,MAAM,GAAG,MAAM,CAkDlG;AAED,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAqBpD"}

package/dist/providers/anthropic.d.ts

@@ -0,0 +1,63 @@
+/**
+ * Anthropic Provider
+ *
+ * Wraps the Anthropic SDK with programmatic tool execution.
+ * Every request generates code that runs in a secure E2B sandbox.
+ */
+import { type AnyTool } from '../tool';
+import type { SupertoolsConfig } from '../supertools';
+interface AnthropicClient {
+    messages: {
+        create(params: MessageCreateParams): Promise<Message>;
+    };
+}
+interface SystemContentBlock {
+    type: 'text';
+    text: string;
+    cache_control?: {
+        type: 'ephemeral';
+    };
+}
+interface MessageCreateParams {
+    model: string;
+    messages: MessageParam[];
+    max_tokens: number;
+    system?: string | SystemContentBlock[];
+    [key: string]: unknown;
+}
+interface MessageParam {
+    role: 'user' | 'assistant';
+    content: string | ContentBlock[];
+}
+interface ContentBlock {
+    type: string;
+    text?: string;
+    [key: string]: unknown;
+}
+interface Message {
+    id: string;
+    type: 'message';
+    role: 'assistant';
+    content: ContentBlock[];
+    model: string;
+    stop_reason: string | null;
+    stop_sequence: string | null;
+    usage: {
+        input_tokens: number;
+        output_tokens: number;
+    };
+}
+/**
+ * Check if a client is an Anthropic SDK instance
+ */
+export declare function isAnthropicClient(client: unknown): client is AnthropicClient;
+/**
+ * Wrap an Anthropic client with programmatic tool execution.
+ *
+ * Every request is converted to code that executes in a sandbox.
+ * This is optimized for tool-heavy workflows with complex logic,
+ * loops, and multiple interdependent tool calls.
+ */
+export declare function wrapAnthropicClient<T extends AnthropicClient>(client: T, tools: readonly AnyTool[], config: SupertoolsConfig): T;
+export {};
+//# sourceMappingURL=anthropic.d.ts.map

package/dist/providers/anthropic.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"anthropic.d.ts","sourceRoot":"","sources":["../../src/providers/anthropic.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAkB,KAAK,OAAO,EAAE,MAAM,SAAS,CAAC;AAGvD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAItD,UAAU,eAAe;IACvB,QAAQ,EAAE;QACR,MAAM,CAAC,MAAM,EAAE,mBAAmB,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;KACvD,CAAC;CACH;AAED,UAAU,kBAAkB;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,aAAa,CAAC,EAAE;QAAE,IAAI,EAAE,WAAW,CAAA;KAAE,CAAC;CACvC;AAED,UAAU,mBAAmB;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,YAAY,EAAE,CAAC;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,GAAG,kBAAkB,EAAE,CAAC;IACvC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,UAAU,YAAY;IACpB,IAAI,EAAE,MAAM,GAAG,WAAW,CAAC;IAC3B,OAAO,EAAE,MAAM,GAAG,YAAY,EAAE,CAAC;CAClC;AAED,UAAU,YAAY;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,UAAU,OAAO;IACf,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,SAAS,CAAC;IAChB,IAAI,EAAE,WAAW,CAAC;IAClB,OAAO,EAAE,YAAY,EAAE,CAAC;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,KAAK,EAAE;QACL,YAAY,EAAE,MAAM,CAAC;QACrB,aAAa,EAAE,MAAM,CAAC;KACvB,CAAC;CACH;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,IAAI,eAAe,CAO5E;AAmCD;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,CAAC,SAAS,eAAe,EAC3D,MAAM,EAAE,CAAC,EACT,KAAK,EAAE,SAAS,OAAO,EAAE,EACzB,MAAM,EAAE,gBAAgB,GACvB,CAAC,CA2FH"}

package/dist/relay/client.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Relay Client - uses WebSocket to communicate with Relay Server to handle tool calls.
+ */
+import type { NormalizedTool } from '../tool';
+import type { ExecutionEvent } from '../types';
+export interface RelayClientConfig {
+    url: string;
+    token: string;
+    tools: Map<string, NormalizedTool>;
+    debug?: boolean;
+    timeout?: number;
+    reconnect?: boolean;
+    maxRetries?: number;
+    onEvent?: (event: ExecutionEvent) => void;
+}
+export declare class RelayClient {
+    private ws;
+    private retryCount;
+    private closing;
+    private readonly config;
+    private readonly log;
+    private readonly emit;
+    private readonly startTime;
+    private executionState;
+    /** Reset state before each execution to allow client reuse */
+    private resetExecutionState;
+    private ts;
+    constructor(config: RelayClientConfig);
+    get connected(): boolean;
+    connect(): Promise<void>;
+    disconnect(): Promise<void>;
+    private createConnection;
+    private reconnect;
+    private onMessage;
+    private handleToolCall;
+    private send;
+    /** Send code to relay for direct execution */
+    execute(code: string, remoteTools: string[], localTools?: Record<string, string>): void;
+    /** Wait for result or error from execution (event-driven, no polling) */
+    waitForResult(timeoutMs: number): Promise<{
+        success: boolean;
+        error?: string;
+    }>;
+}
+export declare function createRelayClient(config: RelayClientConfig): RelayClient;
+//# sourceMappingURL=client.d.ts.map

package/dist/relay/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/relay/client.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAC9C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAG/C,MAAM,WAAW,iBAAiB;IAChC,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;IACnC,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,cAAc,KAAK,IAAI,CAAC;CAC3C;AAWD,qBAAa,WAAW;IACtB,OAAO,CAAC,EAAE,CAA0B;IACpC,OAAO,CAAC,UAAU,CAAK;IACvB,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAoF;IAC3G,OAAO,CAAC,QAAQ,CAAC,GAAG,CAA+B;IACnD,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAkC;IACvD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAc;IAExC,OAAO,CAAC,cAAc,CAIpB;IAEF,8DAA8D;IAC9D,OAAO,CAAC,mBAAmB;IAQ3B,OAAO,CAAC,EAAE;gBAIE,MAAM,EAAE,iBAAiB;IAerC,IAAI,SAAS,IAAI,OAAO,CAEvB;IAEK,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAMxB,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IA4BjC,OAAO,CAAC,gBAAgB;YAwCV,SAAS;IA2BvB,OAAO,CAAC,SAAS;YAgEH,cAAc;IA4B5B,OAAO,CAAC,IAAI;IAaZ,8CAA8C;IAC9C,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,EAAE,UAAU,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAM,GAAG,IAAI;IAW3F,yEAAyE;IACzE,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CAsBhF;AAED,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,iBAAiB,GAAG,WAAW,CAExE"}

package/dist/relay/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Relay Module
+ * WebSocket communication between host and E2B sandbox.
+ */
+export type { RelayConfig } from './types';
+export { DEFAULT_RELAY_CONFIG } from './types';
+export { parseMessage, parseToolCall, parseToolResult, validateOutgoing, safeParse, ProtocolError, } from './utils/protocol';
+export type { ToolCallMessage, ToolResultMessage, ErrorMessage, PingMessage, PongMessage, ResultMessage, Message, } from './utils/protocol';
+export { RelayClient, createRelayClient } from './client';
+export type { RelayClientConfig } from './client';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/relay/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,YAAY,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAC3C,OAAO,EAAE,oBAAoB,EAAE,MAAM,SAAS,CAAC;AAG/C,OAAO,EACL,YAAY,EACZ,aAAa,EACb,eAAe,EACf,gBAAgB,EAChB,SAAS,EACT,aAAa,GACd,MAAM,kBAAkB,CAAC;AAC1B,YAAY,EACV,eAAe,EACf,iBAAiB,EACjB,YAAY,EACZ,WAAW,EACX,WAAW,EACX,aAAa,EACb,OAAO,GACR,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAC1D,YAAY,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC"}

package/dist/relay/protocol.d.ts

@@ -0,0 +1,84 @@
+import { z } from 'zod';
+import { OPTError } from '../errors';
+export type ProtocolErrorCode = 'INVALID_JSON' | 'INVALID_MESSAGE' | 'UNEXPECTED_TYPE';
+export declare class ProtocolError extends OPTError {
+    readonly protocolCode: ProtocolErrorCode;
+    readonly zodError?: z.ZodError;
+    constructor(message: string, code: ProtocolErrorCode, zodError?: z.ZodError);
+    toJSON(): {
+        protocolCode: ProtocolErrorCode;
+        issues: z.core.$ZodIssue[] | undefined;
+        name: string;
+        code: import("../errors").ErrorCode;
+        message: string;
+        cause: string | undefined;
+    };
+}
+export declare const toolCallSchema: z.ZodObject<{
+    type: z.ZodLiteral<"tool_call">;
+    id: z.ZodString;
+    tool: z.ZodString;
+    arguments: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+}, z.core.$strict>;
+export declare const toolResultSchema: z.ZodObject<{
+    type: z.ZodLiteral<"tool_result">;
+    id: z.ZodString;
+    success: z.ZodBoolean;
+    result: z.ZodOptional<z.ZodUnknown>;
+    error: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+export declare const errorSchema: z.ZodObject<{
+    type: z.ZodLiteral<"error">;
+    id: z.ZodString;
+    error: z.ZodString;
+    code: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+export declare const pingSchema: z.ZodObject<{
+    type: z.ZodLiteral<"ping">;
+    id: z.ZodString;
+}, z.core.$strict>;
+export declare const pongSchema: z.ZodObject<{
+    type: z.ZodLiteral<"pong">;
+    id: z.ZodString;
+}, z.core.$strict>;
+export declare const messageSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    type: z.ZodLiteral<"tool_call">;
+    id: z.ZodString;
+    tool: z.ZodString;
+    arguments: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+}, z.core.$strict>, z.ZodObject<{
+    type: z.ZodLiteral<"tool_result">;
+    id: z.ZodString;
+    success: z.ZodBoolean;
+    result: z.ZodOptional<z.ZodUnknown>;
+    error: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>, z.ZodObject<{
+    type: z.ZodLiteral<"error">;
+    id: z.ZodString;
+    error: z.ZodString;
+    code: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>, z.ZodObject<{
+    type: z.ZodLiteral<"ping">;
+    id: z.ZodString;
+}, z.core.$strict>, z.ZodObject<{
+    type: z.ZodLiteral<"pong">;
+    id: z.ZodString;
+}, z.core.$strict>], "type">;
+export type ToolCallMessage = z.infer<typeof toolCallSchema>;
+export type ToolResultMessage = z.infer<typeof toolResultSchema>;
+export type ErrorMessage = z.infer<typeof errorSchema>;
+export type PingMessage = z.infer<typeof pingSchema>;
+export type PongMessage = z.infer<typeof pongSchema>;
+export type Message = z.infer<typeof messageSchema>;
+export declare function parseMessage(input: unknown): Message;
+export declare function parseToolCall(input: unknown): ToolCallMessage;
+export declare function parseToolResult(input: unknown): ToolResultMessage;
+export declare function validateOutgoing(message: unknown): void;
+export declare function safeParse(input: unknown): {
+    ok: true;
+    data: Message;
+} | {
+    ok: false;
+    error: ProtocolError;
+};
+//# sourceMappingURL=protocol.d.ts.map

package/dist/relay/protocol.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"protocol.d.ts","sourceRoot":"","sources":["../../src/relay/protocol.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAErC,MAAM,MAAM,iBAAiB,GAAG,cAAc,GAAG,iBAAiB,GAAG,iBAAiB,CAAC;AAEvF,qBAAa,aAAc,SAAQ,QAAQ;IACzC,QAAQ,CAAC,YAAY,EAAE,iBAAiB,CAAC;IACzC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC;gBAEnB,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,iBAAiB,EAAE,QAAQ,CAAC,EAAE,CAAC,CAAC,QAAQ;IAOlE,MAAM;;;;;;;;CAOhB;AAKD,eAAO,MAAM,cAAc;;;;;kBAKhB,CAAC;AAEZ,eAAO,MAAM,gBAAgB;;;;;;kBAMlB,CAAC;AAEZ,eAAO,MAAM,WAAW;;;;;kBAKb,CAAC;AAEZ,eAAO,MAAM,UAAU;;;kBAAgE,CAAC;AACxF,eAAO,MAAM,UAAU;;;kBAAgE,CAAC;AAExF,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;4BAMxB,CAAC;AAEH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AAC7D,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AACjE,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,CAAC;AACvD,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,UAAU,CAAC,CAAC;AACrD,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,UAAU,CAAC,CAAC;AACrD,MAAM,MAAM,OAAO,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC,CAAC;AAEpD,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAYpD;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,eAAe,CAM7D;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,iBAAiB,CAMjE;AAED,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAEvD;AAED,wBAAgB,SAAS,CAAC,KAAK,EAAE,OAAO,GAAG;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,OAAO,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,aAAa,CAAA;CAAE,CAS3G"}

package/dist/relay/security.d.ts

@@ -0,0 +1,4 @@
+export declare function generateToken(): string;
+export declare function verifyToken(provided: string, expected: string): void;
+export declare function isTokenValid(provided: string, expected: string): boolean;
+//# sourceMappingURL=security.d.ts.map

package/dist/relay/security.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"security.d.ts","sourceRoot":"","sources":["../../src/relay/security.ts"],"names":[],"mappings":"AAMA,wBAAgB,aAAa,IAAI,MAAM,CAEtC;AAED,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,CAOpE;AAED,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAOxE"}

package/dist/relay/server.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Generates client-side code injected into user's sandbox script.
+ * Provides tool functions and sendResult() for structured output.
+ * Uses Unix socket for fast IPC with HTTP fallback.
+ * Pure JavaScript (no TS) for fastest execution.
+ */
+export declare function generateToolFunctions(tools: readonly {
+    name: string;
+}[]): string;
+export declare function generateClientCode(config: {
+    port: number;
+}, tools: readonly {
+    name: string;
+}[]): string;
+//# sourceMappingURL=server.d.ts.map

package/dist/relay/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/relay/server.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,SAAS;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,EAAE,GAAG,MAAM,CAIhF;AAED,wBAAgB,kBAAkB,CAAC,MAAM,EAAE;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,EAAE,KAAK,EAAE,SAAS;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,EAAE,GAAG,MAAM,CAiFvG"}

package/dist/relay/types.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Relay configuration and constants
+ */
+export interface RelayConfig {
+    readonly port: number;
+    readonly token: string;
+    readonly timeout: number;
+    readonly debug: boolean;
+}
+/**
+ * Default relay config.
+ * Note: token is empty by default - callers should generate a secure random token
+ * using crypto.randomUUID() or similar before connecting.
+ */
+export declare const DEFAULT_RELAY_CONFIG: RelayConfig;
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/relay/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;CACzB;AAED;;;;GAIG;AACH,eAAO,MAAM,oBAAoB,EAAE,WAKzB,CAAC"}

package/dist/relay/utils/protocol.d.ts

@@ -0,0 +1,92 @@
+import { z } from 'zod';
+import { OPTError } from '../../utils/errors';
+export type ProtocolErrorCode = 'INVALID_JSON' | 'INVALID_MESSAGE' | 'UNEXPECTED_TYPE';
+export declare class ProtocolError extends OPTError {
+    readonly protocolCode: ProtocolErrorCode;
+    readonly zodError?: z.ZodError;
+    constructor(message: string, code: ProtocolErrorCode, zodError?: z.ZodError);
+    toJSON(): {
+        protocolCode: ProtocolErrorCode;
+        issues: z.core.$ZodIssue[] | undefined;
+        name: string;
+        code: import("../../utils/errors").ErrorCode;
+        message: string;
+        cause: string | undefined;
+    };
+}
+export declare const toolCallSchema: z.ZodObject<{
+    type: z.ZodLiteral<"tool_call">;
+    id: z.ZodString;
+    tool: z.ZodString;
+    arguments: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+}, z.core.$strict>;
+export declare const toolResultSchema: z.ZodObject<{
+    type: z.ZodLiteral<"tool_result">;
+    id: z.ZodString;
+    success: z.ZodBoolean;
+    result: z.ZodOptional<z.ZodUnknown>;
+    error: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+export declare const errorSchema: z.ZodObject<{
+    type: z.ZodLiteral<"error">;
+    id: z.ZodOptional<z.ZodString>;
+    error: z.ZodString;
+    code: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+export declare const pingSchema: z.ZodObject<{
+    type: z.ZodLiteral<"ping">;
+    id: z.ZodString;
+}, z.core.$strict>;
+export declare const pongSchema: z.ZodObject<{
+    type: z.ZodLiteral<"pong">;
+    id: z.ZodString;
+}, z.core.$strict>;
+export declare const resultSchema: z.ZodObject<{
+    type: z.ZodLiteral<"result">;
+    data: z.ZodUnknown;
+}, z.core.$strict>;
+export declare const messageSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    type: z.ZodLiteral<"tool_call">;
+    id: z.ZodString;
+    tool: z.ZodString;
+    arguments: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+}, z.core.$strict>, z.ZodObject<{
+    type: z.ZodLiteral<"tool_result">;
+    id: z.ZodString;
+    success: z.ZodBoolean;
+    result: z.ZodOptional<z.ZodUnknown>;
+    error: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>, z.ZodObject<{
+    type: z.ZodLiteral<"error">;
+    id: z.ZodOptional<z.ZodString>;
+    error: z.ZodString;
+    code: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>, z.ZodObject<{
+    type: z.ZodLiteral<"ping">;
+    id: z.ZodString;
+}, z.core.$strict>, z.ZodObject<{
+    type: z.ZodLiteral<"pong">;
+    id: z.ZodString;
+}, z.core.$strict>, z.ZodObject<{
+    type: z.ZodLiteral<"result">;
+    data: z.ZodUnknown;
+}, z.core.$strict>], "type">;
+export type ToolCallMessage = z.infer<typeof toolCallSchema>;
+export type ToolResultMessage = z.infer<typeof toolResultSchema>;
+export type ErrorMessage = z.infer<typeof errorSchema>;
+export type PingMessage = z.infer<typeof pingSchema>;
+export type PongMessage = z.infer<typeof pongSchema>;
+export type ResultMessage = z.infer<typeof resultSchema>;
+export type Message = z.infer<typeof messageSchema>;
+export declare function parseMessage(input: unknown): Message;
+export declare function parseToolCall(input: unknown): ToolCallMessage;
+export declare function parseToolResult(input: unknown): ToolResultMessage;
+export declare function validateOutgoing(message: unknown): void;
+export declare function safeParse(input: unknown): {
+    ok: true;
+    data: Message;
+} | {
+    ok: false;
+    error: ProtocolError;
+};
+//# sourceMappingURL=protocol.d.ts.map

package/dist/relay/utils/protocol.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"protocol.d.ts","sourceRoot":"","sources":["../../../src/relay/utils/protocol.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAE9C,MAAM,MAAM,iBAAiB,GAAG,cAAc,GAAG,iBAAiB,GAAG,iBAAiB,CAAC;AAEvF,qBAAa,aAAc,SAAQ,QAAQ;IACzC,QAAQ,CAAC,YAAY,EAAE,iBAAiB,CAAC;IACzC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC;gBAEnB,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,iBAAiB,EAAE,QAAQ,CAAC,EAAE,CAAC,CAAC,QAAQ;IAOlE,MAAM;;;;;;;;CAOhB;AAKD,eAAO,MAAM,cAAc;;;;;kBAKhB,CAAC;AAEZ,eAAO,MAAM,gBAAgB;;;;;;kBAMlB,CAAC;AAEZ,eAAO,MAAM,WAAW;;;;;kBAKb,CAAC;AAEZ,eAAO,MAAM,UAAU;;;kBAAgE,CAAC;AACxF,eAAO,MAAM,UAAU;;;kBAAgE,CAAC;AAExF,eAAO,MAAM,YAAY;;;kBAGd,CAAC;AAEZ,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;4BAOxB,CAAC;AAEH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AAC7D,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AACjE,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,CAAC;AACvD,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,UAAU,CAAC,CAAC;AACrD,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,UAAU,CAAC,CAAC;AACrD,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAC;AACzD,MAAM,MAAM,OAAO,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC,CAAC;AAEpD,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAYpD;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,eAAe,CAM7D;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,iBAAiB,CAMjE;AAED,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAEvD;AAED,wBAAgB,SAAS,CAAC,KAAK,EAAE,OAAO,GAAG;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,OAAO,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,aAAa,CAAA;CAAE,CAS3G"}

package/dist/relay/utils/token.d.ts

@@ -0,0 +1,4 @@
+export declare function generateToken(): string;
+export declare function verifyToken(provided: string, expected: string): void;
+export declare function isTokenValid(provided: string, expected: string): boolean;
+//# sourceMappingURL=token.d.ts.map

package/dist/relay/utils/token.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"token.d.ts","sourceRoot":"","sources":["../../../src/relay/utils/token.ts"],"names":[],"mappings":"AAMA,wBAAgB,aAAa,IAAI,MAAM,CAEtC;AAED,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,CAOpE;AAED,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAOxE"}