@ash-cloud/ash-ai 0.1.19 → 0.1.20

package/dist/index.d.ts

@@ -915,12 +915,16 @@ interface AgentConfig$1 {
     maxTurns?: number;
     permissionMode?: 'default' | 'acceptEdits' | 'bypassPermissions' | 'plan';
     hooks?: AgentHooks;
-    mcpServers?: Record<string, {
-        command: string;
-        args?: string[];
-    }>;
+    mcpServers?: Record<string, Record<string, unknown>>;
+    /**
+     * Load project/user settings from the .claude directory.
+     * See Claude Agent SDK settingSources for details.
+     */
+    settingSources?: Array<'project' | 'user'>;
     /** Skills to enable for this agent (materialized at session start) */
     skills?: SkillConfig[];
+    /** Additional SDK-specific options (passed through to the SDK client) */
+    config?: Record<string, unknown>;
     /**
      * Sandbox provider configuration for agent execution.
      * Determines where and how the agent runs (local, Vercel, E2B, etc.)
@@ -1057,6 +1061,13 @@ interface SendMessageOptions {
         mimeType: string;
     }>;
     metadata?: Record<string, unknown>;
+    /**
+     * Structured output configuration (JSON Schema).
+     */
+    outputFormat?: {
+        type: 'json_schema';
+        schema: Record<string, unknown>;
+    };
     /**
      * Per-request context to prepend to the user's message.
      * This is useful for providing dynamic context on each request, such as:
@@ -2103,32 +2114,370 @@ declare class SessionManager {
     /**
      * Delete a session and all associated messages
      */
-    deleteSession(sessionId: SessionId): Promise<void>;
+    deleteSession(sessionId: SessionId): Promise<void>;
+    /**
+     * List sessions with optional filtering
+     */
+    listSessions(options?: ListSessionsOptions): Promise<PaginatedResult<Session>>;
+    /**
+     * Create a forked session from an existing one
+     */
+    forkSession(sessionId: SessionId, _options?: ResumeSessionOptions): Promise<Session>;
+    /**
+     * Save messages to a session
+     */
+    saveMessages(sessionId: SessionId, messages: Array<Omit<Message, 'id' | 'sessionId' | 'createdAt'>>): Promise<Message[]>;
+    /**
+     * Get messages for a session
+     */
+    getSessionMessages(sessionId: SessionId, options?: PaginationOptions): Promise<PaginatedResult<Message>>;
+    /**
+     * Delete a specific message
+     */
+    deleteMessage(messageId: string): Promise<void>;
+    /**
+     * Get session history chain (for forked sessions)
+     */
+    getSessionHistory(sessionId: SessionId): Promise<Session[]>;
+}
+
+/**
+ * MCP (Model Context Protocol) Server Integration
+ *
+ * This module provides utilities for configuring and managing MCP servers
+ * that extend agent capabilities with external tools and resources.
+ *
+ * Popular MCP servers:
+ * - Playwright: Browser automation (@playwright/mcp)
+ * - GitHub: Repository operations (github-mcp-server)
+ * - Filesystem: File system access (filesystem-mcp-server)
+ * - Postgres: Database queries (postgres-mcp-server)
+ *
+ * @see https://github.com/modelcontextprotocol/servers
+ */
+
+/**
+ * Transport type for MCP servers
+ */
+type McpTransportType = 'stdio' | 'http' | 'sse';
+/**
+ * Authentication configuration for MCP servers
+ */
+type McpAuth = {
+    type: 'bearer';
+    token: string;
+} | {
+    type: 'basic';
+    username: string;
+    password: string;
+} | {
+    type: 'api-key';
+    key: string;
+    header?: string;
+};
+/**
+ * Convert McpAuth to HTTP headers
+ */
+declare function mcpAuthToHeaders(auth: McpAuth): Record<string, string>;
+/**
+ * Base MCP server configuration (common fields)
+ */
+interface McpServerConfigBase {
+    /** Transport type - defaults to 'stdio' if command is provided */
+    type?: McpTransportType;
+}
+/**
+ * Configuration for stdio-based MCP servers (local processes)
+ */
+interface McpStdioServerConfig extends McpServerConfigBase {
+    type?: 'stdio';
+    /** Command to run the server */
+    command: string;
+    /** Arguments to pass to the command */
+    args?: string[];
+    /** Environment variables for the server process */
+    env?: Record<string, string>;
+    /** Working directory for the server */
+    cwd?: string;
+}
+/**
+ * Configuration for HTTP/SSE-based MCP servers (remote)
+ */
+interface McpHttpServerConfig extends McpServerConfigBase {
+    type: 'http' | 'sse';
+    /** URL of the MCP server endpoint */
+    url: string;
+    /**
+     * Authentication for the MCP server (preferred over raw headers)
+     *
+     * @example Bearer token
+     * ```typescript
+     * auth: { type: 'bearer', token: userAccessToken }
+     * ```
+     *
+     * @example API key
+     * ```typescript
+     * auth: { type: 'api-key', key: 'sk-...', header: 'X-API-Key' }
+     * ```
+     */
+    auth?: McpAuth;
+    /** Additional HTTP headers (auth headers are added automatically from auth field) */
+    headers?: Record<string, string>;
+}
+/**
+ * MCP server configuration - supports both stdio and HTTP/SSE transports
+ *
+ * @example Stdio server (local process)
+ * ```typescript
+ * const stdioConfig: McpServerConfig = {
+ *   command: 'npx',
+ *   args: ['@modelcontextprotocol/server-github'],
+ *   env: { GITHUB_TOKEN: process.env.GITHUB_TOKEN }
+ * };
+ * ```
+ *
+ * @example HTTP server (remote)
+ * ```typescript
+ * const httpConfig: McpServerConfig = {
+ *   type: 'http',
+ *   url: 'https://api.example.com/mcp',
+ *   headers: { Authorization: `Bearer ${token}` }
+ * };
+ * ```
+ */
+type McpServerConfig = McpStdioServerConfig | McpHttpServerConfig;
+/**
+ * In-process MCP server configuration (created via createSdkMcpServer).
+ * This is passed directly to the Claude Agent SDK.
+ */
+type SdkMcpServerConfig = Record<string, unknown>;
+/**
+ * Any MCP server config supported by the SDK (stdio/http/sse or in-process).
+ */
+type AnyMcpServerConfig = McpServerConfig | SdkMcpServerConfig;
+/**
+ * Type guard to check if config is for HTTP/SSE transport
+ */
+declare function isHttpMcpConfig(config: McpServerConfig): config is McpHttpServerConfig;
+/**
+ * Type guard to check if config is for stdio transport
+ */
+declare function isStdioMcpConfig(config: McpServerConfig): config is McpStdioServerConfig;
+/**
+ * Create an HTTP MCP server configuration with Bearer token authentication
+ *
+ * @param url - The MCP server endpoint URL
+ * @param token - Bearer token for authentication
+ * @param additionalHeaders - Optional additional headers
+ * @returns HTTP MCP server configuration
+ *
+ * @example
+ * ```typescript
+ * const config = httpMcpWithAuth(
+ *   'https://myapp.com/api/mcp',
+ *   userAccessToken
+ * );
+ * ```
+ */
+declare function httpMcpWithAuth(url: string, token: string, additionalHeaders?: Record<string, string>): McpHttpServerConfig;
+/**
+ * Create an SSE MCP server configuration with Bearer token authentication
+ *
+ * @param url - The MCP server SSE endpoint URL
+ * @param token - Bearer token for authentication
+ * @param additionalHeaders - Optional additional headers
+ * @returns SSE MCP server configuration
+ */
+declare function sseMcpWithAuth(url: string, token: string, additionalHeaders?: Record<string, string>): McpHttpServerConfig;
+/**
+ * Pre-configured MCP server definitions
+ */
+declare const McpServers: {
+    /**
+     * Playwright MCP server for browser automation
+     * @see https://github.com/microsoft/playwright-mcp
+     */
+    playwright: (options?: {
+        headless?: boolean;
+    }) => McpServerConfig;
+    /**
+     * GitHub MCP server for repository operations
+     * Requires GITHUB_TOKEN environment variable
+     */
+    github: (options?: {
+        owner?: string;
+        repo?: string;
+    }) => McpServerConfig;
+    /**
+     * Filesystem MCP server for file operations
+     * @param allowedPaths Paths the server can access
+     */
+    filesystem: (allowedPaths: string[]) => McpServerConfig;
+    /**
+     * PostgreSQL MCP server for database queries
+     * @param connectionString PostgreSQL connection URL
+     */
+    postgres: (connectionString: string) => McpServerConfig;
+    /**
+     * SQLite MCP server for database queries
+     * @param dbPath Path to the SQLite database file
+     */
+    sqlite: (dbPath: string) => McpServerConfig;
+    /**
+     * Brave Search MCP server for web search
+     * Requires BRAVE_API_KEY environment variable
+     */
+    braveSearch: () => McpServerConfig;
+    /**
+     * Google Drive MCP server for file access
+     * Requires Google OAuth credentials
+     */
+    googleDrive: () => McpServerConfig;
+    /**
+     * Slack MCP server for messaging
+     * Requires SLACK_BOT_TOKEN environment variable
+     */
+    slack: () => McpServerConfig;
+    /**
+     * Puppeteer MCP server for browser automation (alternative to Playwright)
+     */
+    puppeteer: () => McpServerConfig;
+    /**
+     * Memory MCP server for persistent key-value storage
+     */
+    memory: () => McpServerConfig;
+    /**
+     * Custom MCP server from a local path
+     * @param path Path to the server script
+     * @param runtime Runtime to use (node, python, etc.)
+     */
+    custom: (path: string, runtime?: "node" | "python" | "deno", args?: string[]) => McpServerConfig;
+};
+/**
+ * Builder for configuring multiple MCP servers
+ */
+declare class McpConfigBuilder {
+    private servers;
+    /**
+     * Add a pre-configured MCP server
+     */
+    add(name: string, config: McpServerConfig): this;
+    /**
+     * Add Playwright for browser automation
+     */
+    withPlaywright(options?: {
+        headless?: boolean;
+    }): this;
+    /**
+     * Add GitHub for repository operations
+     */
+    withGitHub(options?: {
+        owner?: string;
+        repo?: string;
+    }): this;
+    /**
+     * Add Filesystem for file access
+     */
+    withFilesystem(allowedPaths: string[]): this;
+    /**
+     * Add PostgreSQL for database queries
+     */
+    withPostgres(connectionString: string): this;
+    /**
+     * Add SQLite for database queries
+     */
+    withSqlite(dbPath: string): this;
+    /**
+     * Add Brave Search for web search
+     */
+    withBraveSearch(): this;
+    /**
+     * Add Memory for key-value storage
+     */
+    withMemory(): this;
+    /**
+     * Add a custom stdio MCP server
+     */
+    withCustom(name: string, path: string, runtime?: 'node' | 'python' | 'deno', args?: string[]): this;
+    /**
+     * Add an HTTP MCP server with typed authentication
+     *
+     * @param name - Server name (used as mcp__name__ prefix for tools)
+     * @param url - The MCP server endpoint URL
+     * @param options - Authentication and additional headers
+     *
+     * @example Bearer token auth
+     * ```typescript
+     * builder.withHttp('myapp', '/api/mcp', {
+     *   auth: { type: 'bearer', token: userAccessToken }
+     * })
+     * ```
+     *
+     * @example API key auth
+     * ```typescript
+     * builder.withHttp('myapp', '/api/mcp', {
+     *   auth: { type: 'api-key', key: 'sk-...', header: 'X-API-Key' }
+     * })
+     * ```
+     */
+    withHttp(name: string, url: string, options?: {
+        auth?: McpAuth;
+        headers?: Record<string, string>;
+    }): this;
+    /**
+     * Add an SSE MCP server with typed authentication
+     *
+     * @param name - Server name (used as mcp__name__ prefix for tools)
+     * @param url - The MCP server SSE endpoint URL
+     * @param options - Authentication and additional headers
+     */
+    withSse(name: string, url: string, options?: {
+        auth?: McpAuth;
+        headers?: Record<string, string>;
+    }): this;
     /**
-     * List sessions with optional filtering
+     * Build the MCP servers configuration
      */
-    listSessions(options?: ListSessionsOptions): Promise<PaginatedResult<Session>>;
+    build(): Record<string, McpServerConfig>;
     /**
-     * Create a forked session from an existing one
+     * Convert to ClaudeAgentOptions format
+     * Properly handles both stdio and HTTP/SSE server configs
+     * Converts typed auth to headers automatically
      */
-    forkSession(sessionId: SessionId, _options?: ResumeSessionOptions): Promise<Session>;
+    toAgentOptions(): Pick<ClaudeAgentOptions, 'mcpServers'>;
+}
+/**
+ * Create a new MCP config builder
+ */
+declare function configureMcp(): McpConfigBuilder;
+/**
+ * Common MCP server presets for different use cases
+ */
+declare const McpPresets: {
     /**
-     * Save messages to a session
+     * Web research preset: browser automation + web search
      */
-    saveMessages(sessionId: SessionId, messages: Array<Omit<Message, 'id' | 'sessionId' | 'createdAt'>>): Promise<Message[]>;
+    webResearch: () => McpConfigBuilder;
     /**
-     * Get messages for a session
+     * Database preset: PostgreSQL + memory
      */
-    getSessionMessages(sessionId: SessionId, options?: PaginationOptions): Promise<PaginatedResult<Message>>;
+    database: (connectionString: string) => McpConfigBuilder;
     /**
-     * Delete a specific message
+     * GitHub development preset: GitHub + filesystem
      */
-    deleteMessage(messageId: string): Promise<void>;
+    githubDev: (options: {
+        allowedPaths: string[];
+        owner?: string;
+        repo?: string;
+    }) => McpConfigBuilder;
     /**
-     * Get session history chain (for forked sessions)
+     * Full-featured preset with multiple servers
      */
-    getSessionHistory(sessionId: SessionId): Promise<Session[]>;
-}
+    fullFeatured: (options: {
+        allowedPaths: string[];
+        dbConnectionString?: string;
+    }) => McpConfigBuilder;
+};
 
 /**
  * Claude Agent SDK Integration Module
@@ -2168,8 +2517,19 @@ interface ClaudeAgentOptions {
     disallowedTools?: string[];
     /** Permission mode for tool execution */
     permissionMode?: 'default' | 'acceptEdits' | 'bypassPermissions' | 'plan';
+    /** Enable SDK file checkpointing (Claude Code) */
+    enableFileCheckpointing?: boolean;
+    /** Extra CLI args for Claude Code */
+    extraArgs?: Record<string, string | null>;
     /** Maximum number of turns in the conversation */
     maxTurns?: number;
+    /**
+     * Structured output configuration (JSON Schema)
+     */
+    outputFormat?: {
+        type: 'json_schema';
+        schema: Record<string, unknown>;
+    };
     /** Claude session ID for resuming a previous session (V1) */
     resume?: string;
     /** Whether to fork the session when resuming (V1) */
@@ -2177,7 +2537,9 @@ interface ClaudeAgentOptions {
     /**
      * MCP servers to connect
      *
-     * Supports both stdio (local process) and HTTP/SSE (remote) transports:
+     * Supports stdio (local process), HTTP/SSE (remote), and in-process SDK servers.
+     * In-process servers (from createSdkMcpServer) require streaming prompt input;
+     * this client will auto-wrap string prompts when such servers are present.
      *
      * @example Stdio server
      * ```typescript
@@ -2208,30 +2570,7 @@ interface ClaudeAgentOptions {
      * }
      * ```
      */
-    mcpServers?: Record<string, {
-        command?: string;
-        args?: string[];
-        env?: Record<string, string>;
-        type?: 'stdio' | 'http' | 'sse';
-        url?: string;
-        headers?: Record<string, string>;
-        /**
-         * Typed authentication (alternative to raw headers).
-         * Will be converted to appropriate Authorization header.
-         */
-        auth?: {
-            type: 'bearer';
-            token: string;
-        } | {
-            type: 'basic';
-            username: string;
-            password: string;
-        } | {
-            type: 'api-key';
-            key: string;
-            header?: string;
-        };
-    }>;
+    mcpServers?: Record<string, AnyMcpServerConfig>;
     /** Custom agents/subagents */
     agents?: Record<string, {
         description: string;
@@ -2252,6 +2591,14 @@ interface ClaudeAgentOptions {
         SessionEnd?: Function[];
         Stop?: Function[];
     };
+    /**
+     * Plugins to load for this session.
+     * Each plugin must be a local path to its root directory (containing .claude-plugin/plugin.json).
+     */
+    plugins?: Array<{
+        type: 'local';
+        path: string;
+    }>;
     /** Load project settings from .claude directory */
     settingSources?: Array<'project' | 'user'>;
     /**
@@ -2295,6 +2642,17 @@ interface ClaudeMessage {
         content: ClaudeContentBlock[];
     };
     result?: string;
+    structured_output?: unknown;
+    usage?: {
+        total_cost_usd?: number;
+        input_tokens?: number;
+        output_tokens?: number;
+    };
+    modelUsage?: Record<string, {
+        input_tokens?: number;
+        output_tokens?: number;
+        total_cost_usd?: number;
+    }>;
     cost?: number;
     tokens?: {
         input: number;
@@ -2321,6 +2679,12 @@ type ClaudeContentBlock = {
 interface ClaudeStreamEvent {
     type: 'session_init' | 'text_delta' | 'thinking_delta' | 'text' | 'tool_use' | 'tool_result' | 'complete' | 'error';
     sessionId?: string;
+    /** Slash commands advertised by the SDK on init */
+    slashCommands?: Array<{
+        name: string;
+        description?: string;
+        prompt?: string;
+    }>;
     /** Incremental text or thinking delta (for streaming) */
     delta?: string;
     /** Complete text block (for compatibility) */
@@ -2338,6 +2702,7 @@ interface ClaudeStreamEvent {
     /** Whether the tool result is an error */
     isError?: boolean;
     result?: string;
+    structured_output?: unknown;
     totalCost?: number;
     totalTokens?: number;
     error?: string;
@@ -2379,7 +2744,7 @@ declare class ClaudeSdkClient {
      * @param options - Agent configuration options
      * @yields ClaudeStreamEvent for each response chunk
      */
-    query(prompt: string, options?: ClaudeAgentOptions): AsyncGenerator<ClaudeStreamEvent, void, unknown>;
+    query(prompt: string | AsyncIterable<unknown>, options?: ClaudeAgentOptions): AsyncGenerator<ClaudeStreamEvent, void, unknown>;
     /**
      * Execute using the real Claude Agent SDK V1 query function
      */
@@ -2532,7 +2897,7 @@ declare function getDefaultModel(backend: AgentBackend): string;
  * This allows the cloud layer to provide a custom execution strategy,
  * such as running queries inside a Vercel Sandbox instead of locally.
  */
-type CustomExecutor = (prompt: string, options: ClaudeAgentOptions) => AsyncGenerator<ClaudeStreamEvent, void, unknown>;
+type CustomExecutor = (prompt: string | AsyncIterable<unknown>, options: ClaudeAgentOptions) => AsyncGenerator<ClaudeStreamEvent, void, unknown>;
 /**
  * Configuration for creating an AgentHarness
  */
@@ -3892,377 +4257,48 @@ type HarnessConfig = z.infer<typeof HarnessConfigSchema>;
  */
 declare function loadConfig(configPath?: string, options?: {
     env?: string;
-}): Promise<HarnessConfig>;
-/**
- * Define configuration with type checking
- */
-declare function defineConfig(config: Partial<HarnessConfig>): HarnessConfig;
-/**
- * Define an agent with type checking
- */
-declare function defineAgent(config: AgentConfig): AgentConfig;
-/**
- * Create a config builder for fluent configuration
- */
-declare class ConfigBuilder {
-    private config;
-    name(name: string): this;
-    storage(storage: StorageConfig): this;
-    memoryStorage(): this;
-    sqliteStorage(dbPath?: string): this;
-    postgresStorage(connectionString: string, poolSize?: number): this;
-    libsqlStorage(url: string, authToken?: string): this;
-    defaultAgent(config: Partial<AgentConfig>): this;
-    agent(name: string, config: Omit<AgentConfig, 'name'>): this;
-    server(config: Partial<ServerConfig>): this;
-    attachments(config: Partial<AttachmentConfig>): this;
-    environment(env: string, overrides: {
-        storage?: StorageConfig;
-        server?: Partial<ServerConfig>;
-    }): this;
-    build(): HarnessConfig;
-}
-/**
- * Create a new config builder
- */
-declare function createConfig(): ConfigBuilder;
-/**
- * Get environment variable with optional default
- */
-declare function env(key: string, defaultValue?: string): string;
-/**
- * Get optional environment variable
- */
-declare function envOptional(key: string): string | undefined;
-
-/**
- * MCP (Model Context Protocol) Server Integration
- *
- * This module provides utilities for configuring and managing MCP servers
- * that extend agent capabilities with external tools and resources.
- *
- * Popular MCP servers:
- * - Playwright: Browser automation (@playwright/mcp)
- * - GitHub: Repository operations (github-mcp-server)
- * - Filesystem: File system access (filesystem-mcp-server)
- * - Postgres: Database queries (postgres-mcp-server)
- *
- * @see https://github.com/modelcontextprotocol/servers
- */
-
-/**
- * Transport type for MCP servers
- */
-type McpTransportType = 'stdio' | 'http' | 'sse';
-/**
- * Authentication configuration for MCP servers
- */
-type McpAuth = {
-    type: 'bearer';
-    token: string;
-} | {
-    type: 'basic';
-    username: string;
-    password: string;
-} | {
-    type: 'api-key';
-    key: string;
-    header?: string;
-};
-/**
- * Convert McpAuth to HTTP headers
- */
-declare function mcpAuthToHeaders(auth: McpAuth): Record<string, string>;
-/**
- * Base MCP server configuration (common fields)
- */
-interface McpServerConfigBase {
-    /** Transport type - defaults to 'stdio' if command is provided */
-    type?: McpTransportType;
-}
-/**
- * Configuration for stdio-based MCP servers (local processes)
- */
-interface McpStdioServerConfig extends McpServerConfigBase {
-    type?: 'stdio';
-    /** Command to run the server */
-    command: string;
-    /** Arguments to pass to the command */
-    args?: string[];
-    /** Environment variables for the server process */
-    env?: Record<string, string>;
-    /** Working directory for the server */
-    cwd?: string;
-}
-/**
- * Configuration for HTTP/SSE-based MCP servers (remote)
- */
-interface McpHttpServerConfig extends McpServerConfigBase {
-    type: 'http' | 'sse';
-    /** URL of the MCP server endpoint */
-    url: string;
-    /**
-     * Authentication for the MCP server (preferred over raw headers)
-     *
-     * @example Bearer token
-     * ```typescript
-     * auth: { type: 'bearer', token: userAccessToken }
-     * ```
-     *
-     * @example API key
-     * ```typescript
-     * auth: { type: 'api-key', key: 'sk-...', header: 'X-API-Key' }
-     * ```
-     */
-    auth?: McpAuth;
-    /** Additional HTTP headers (auth headers are added automatically from auth field) */
-    headers?: Record<string, string>;
-}
-/**
- * MCP server configuration - supports both stdio and HTTP/SSE transports
- *
- * @example Stdio server (local process)
- * ```typescript
- * const stdioConfig: McpServerConfig = {
- *   command: 'npx',
- *   args: ['@modelcontextprotocol/server-github'],
- *   env: { GITHUB_TOKEN: process.env.GITHUB_TOKEN }
- * };
- * ```
- *
- * @example HTTP server (remote)
- * ```typescript
- * const httpConfig: McpServerConfig = {
- *   type: 'http',
- *   url: 'https://api.example.com/mcp',
- *   headers: { Authorization: `Bearer ${token}` }
- * };
- * ```
- */
-type McpServerConfig = McpStdioServerConfig | McpHttpServerConfig;
-/**
- * Type guard to check if config is for HTTP/SSE transport
- */
-declare function isHttpMcpConfig(config: McpServerConfig): config is McpHttpServerConfig;
-/**
- * Type guard to check if config is for stdio transport
- */
-declare function isStdioMcpConfig(config: McpServerConfig): config is McpStdioServerConfig;
-/**
- * Create an HTTP MCP server configuration with Bearer token authentication
- *
- * @param url - The MCP server endpoint URL
- * @param token - Bearer token for authentication
- * @param additionalHeaders - Optional additional headers
- * @returns HTTP MCP server configuration
- *
- * @example
- * ```typescript
- * const config = httpMcpWithAuth(
- *   'https://myapp.com/api/mcp',
- *   userAccessToken
- * );
- * ```
- */
-declare function httpMcpWithAuth(url: string, token: string, additionalHeaders?: Record<string, string>): McpHttpServerConfig;
-/**
- * Create an SSE MCP server configuration with Bearer token authentication
- *
- * @param url - The MCP server SSE endpoint URL
- * @param token - Bearer token for authentication
- * @param additionalHeaders - Optional additional headers
- * @returns SSE MCP server configuration
+}): Promise<HarnessConfig>;
+/**
+ * Define configuration with type checking
  */
-declare function sseMcpWithAuth(url: string, token: string, additionalHeaders?: Record<string, string>): McpHttpServerConfig;
+declare function defineConfig(config: Partial<HarnessConfig>): HarnessConfig;
 /**
- * Pre-configured MCP server definitions
+ * Define an agent with type checking
  */
-declare const McpServers: {
-    /**
-     * Playwright MCP server for browser automation
-     * @see https://github.com/microsoft/playwright-mcp
-     */
-    playwright: (options?: {
-        headless?: boolean;
-    }) => McpServerConfig;
-    /**
-     * GitHub MCP server for repository operations
-     * Requires GITHUB_TOKEN environment variable
-     */
-    github: (options?: {
-        owner?: string;
-        repo?: string;
-    }) => McpServerConfig;
-    /**
-     * Filesystem MCP server for file operations
-     * @param allowedPaths Paths the server can access
-     */
-    filesystem: (allowedPaths: string[]) => McpServerConfig;
-    /**
-     * PostgreSQL MCP server for database queries
-     * @param connectionString PostgreSQL connection URL
-     */
-    postgres: (connectionString: string) => McpServerConfig;
-    /**
-     * SQLite MCP server for database queries
-     * @param dbPath Path to the SQLite database file
-     */
-    sqlite: (dbPath: string) => McpServerConfig;
-    /**
-     * Brave Search MCP server for web search
-     * Requires BRAVE_API_KEY environment variable
-     */
-    braveSearch: () => McpServerConfig;
-    /**
-     * Google Drive MCP server for file access
-     * Requires Google OAuth credentials
-     */
-    googleDrive: () => McpServerConfig;
-    /**
-     * Slack MCP server for messaging
-     * Requires SLACK_BOT_TOKEN environment variable
-     */
-    slack: () => McpServerConfig;
-    /**
-     * Puppeteer MCP server for browser automation (alternative to Playwright)
-     */
-    puppeteer: () => McpServerConfig;
-    /**
-     * Memory MCP server for persistent key-value storage
-     */
-    memory: () => McpServerConfig;
-    /**
-     * Custom MCP server from a local path
-     * @param path Path to the server script
-     * @param runtime Runtime to use (node, python, etc.)
-     */
-    custom: (path: string, runtime?: "node" | "python" | "deno", args?: string[]) => McpServerConfig;
-};
+declare function defineAgent(config: AgentConfig): AgentConfig;
 /**
- * Builder for configuring multiple MCP servers
+ * Create a config builder for fluent configuration
  */
-declare class McpConfigBuilder {
-    private servers;
-    /**
-     * Add a pre-configured MCP server
-     */
-    add(name: string, config: McpServerConfig): this;
-    /**
-     * Add Playwright for browser automation
-     */
-    withPlaywright(options?: {
-        headless?: boolean;
-    }): this;
-    /**
-     * Add GitHub for repository operations
-     */
-    withGitHub(options?: {
-        owner?: string;
-        repo?: string;
-    }): this;
-    /**
-     * Add Filesystem for file access
-     */
-    withFilesystem(allowedPaths: string[]): this;
-    /**
-     * Add PostgreSQL for database queries
-     */
-    withPostgres(connectionString: string): this;
-    /**
-     * Add SQLite for database queries
-     */
-    withSqlite(dbPath: string): this;
-    /**
-     * Add Brave Search for web search
-     */
-    withBraveSearch(): this;
-    /**
-     * Add Memory for key-value storage
-     */
-    withMemory(): this;
-    /**
-     * Add a custom stdio MCP server
-     */
-    withCustom(name: string, path: string, runtime?: 'node' | 'python' | 'deno', args?: string[]): this;
-    /**
-     * Add an HTTP MCP server with typed authentication
-     *
-     * @param name - Server name (used as mcp__name__ prefix for tools)
-     * @param url - The MCP server endpoint URL
-     * @param options - Authentication and additional headers
-     *
-     * @example Bearer token auth
-     * ```typescript
-     * builder.withHttp('myapp', '/api/mcp', {
-     *   auth: { type: 'bearer', token: userAccessToken }
-     * })
-     * ```
-     *
-     * @example API key auth
-     * ```typescript
-     * builder.withHttp('myapp', '/api/mcp', {
-     *   auth: { type: 'api-key', key: 'sk-...', header: 'X-API-Key' }
-     * })
-     * ```
-     */
-    withHttp(name: string, url: string, options?: {
-        auth?: McpAuth;
-        headers?: Record<string, string>;
-    }): this;
-    /**
-     * Add an SSE MCP server with typed authentication
-     *
-     * @param name - Server name (used as mcp__name__ prefix for tools)
-     * @param url - The MCP server SSE endpoint URL
-     * @param options - Authentication and additional headers
-     */
-    withSse(name: string, url: string, options?: {
-        auth?: McpAuth;
-        headers?: Record<string, string>;
+declare class ConfigBuilder {
+    private config;
+    name(name: string): this;
+    storage(storage: StorageConfig): this;
+    memoryStorage(): this;
+    sqliteStorage(dbPath?: string): this;
+    postgresStorage(connectionString: string, poolSize?: number): this;
+    libsqlStorage(url: string, authToken?: string): this;
+    defaultAgent(config: Partial<AgentConfig>): this;
+    agent(name: string, config: Omit<AgentConfig, 'name'>): this;
+    server(config: Partial<ServerConfig>): this;
+    attachments(config: Partial<AttachmentConfig>): this;
+    environment(env: string, overrides: {
+        storage?: StorageConfig;
+        server?: Partial<ServerConfig>;
     }): this;
-    /**
-     * Build the MCP servers configuration
-     */
-    build(): Record<string, McpServerConfig>;
-    /**
-     * Convert to ClaudeAgentOptions format
-     * Properly handles both stdio and HTTP/SSE server configs
-     * Converts typed auth to headers automatically
-     */
-    toAgentOptions(): Pick<ClaudeAgentOptions, 'mcpServers'>;
+    build(): HarnessConfig;
 }
 /**
- * Create a new MCP config builder
+ * Create a new config builder
  */
-declare function configureMcp(): McpConfigBuilder;
+declare function createConfig(): ConfigBuilder;
 /**
- * Common MCP server presets for different use cases
+ * Get environment variable with optional default
  */
-declare const McpPresets: {
-    /**
-     * Web research preset: browser automation + web search
-     */
-    webResearch: () => McpConfigBuilder;
-    /**
-     * Database preset: PostgreSQL + memory
-     */
-    database: (connectionString: string) => McpConfigBuilder;
-    /**
-     * GitHub development preset: GitHub + filesystem
-     */
-    githubDev: (options: {
-        allowedPaths: string[];
-        owner?: string;
-        repo?: string;
-    }) => McpConfigBuilder;
-    /**
-     * Full-featured preset with multiple servers
-     */
-    fullFeatured: (options: {
-        allowedPaths: string[];
-        dbConnectionString?: string;
-    }) => McpConfigBuilder;
-};
+declare function env(key: string, defaultValue?: string): string;
+/**
+ * Get optional environment variable
+ */
+declare function envOptional(key: string): string | undefined;
 
 /**
  * Sandbox Provider Types
@@ -5531,6 +5567,10 @@ interface SandboxWithState {
     warmupTag?: string;
     /** Whether agent-specific setup was completed during pool warmup */
     agentSetupComplete?: boolean;
+    /** Whether install.sh was run during pool warmup */
+    warmupInstallRan?: boolean;
+    /** Whether startup script was run successfully during pool warmup */
+    warmupStartupRan?: boolean;
 }
 /**
  * Get an existing sandbox for a session, or create a new one.
@@ -5822,6 +5862,21 @@ interface PooledSandbox {
     warmupTag?: string;
     /** Whether agent-specific setup has been completed during warmup */
     agentSetupComplete?: boolean;
+    /** Whether install.sh was run during warmup */
+    warmupInstallRan?: boolean;
+    /** Whether startup script was run successfully during warmup */
+    warmupStartupRan?: boolean;
+}
+/**
+ * Result returned by a warmup spec setup function.
+ * Tells the pool which steps actually succeeded so the consumer
+ * can decide what to skip vs re-run.
+ */
+interface WarmupSetupResult {
+    /** Whether install.sh was found and ran successfully */
+    installRan?: boolean;
+    /** Whether the startup script ran successfully */
+    startupRan?: boolean;
 }
 /**
  * Specification for warming agent-specific sandboxes.
@@ -5832,12 +5887,18 @@ interface WarmupSpec {
     tag: string;
     /** Priority for replenishment — higher = more likely to be warmed. Use Date.now() for MRU. */
     priority: number;
+    /**
+     * Opaque hash of the config that produced this spec.
+     * Used to skip re-registration when the agent config hasn't changed.
+     */
+    configHash?: string;
     /**
      * Setup function called on a sandbox after SDK installation.
      * Should pull agent files, run install.sh, run startup script, etc.
      * If this throws, the sandbox stays generic (graceful degradation).
+     * Return a WarmupSetupResult to indicate which steps succeeded.
      */
-    setup: (sandbox: VercelSandboxInstance) => Promise<void>;
+    setup: (sandbox: VercelSandboxInstance) => Promise<WarmupSetupResult | void>;
 }
 /**
  * Pool status for observability
@@ -5894,6 +5955,12 @@ declare class SandboxPool {
     private startPromise;
     /** Registered warmup specs by tag (e.g. agentId -> spec) */
     private warmupSpecs;
+    /** Tags currently being warmed (prevents duplicate warming of same spec) */
+    private warmingTags;
+    /** Max warmup specs to keep (LRU eviction above this) */
+    private static readonly MAX_SPECS;
+    /** Timeout for spec setup in ms (prevents hanging S3 pulls / install.sh) */
+    private static readonly SPEC_SETUP_TIMEOUT_MS;
     /** Consecutive warmup failure count (reset on success) */
     private consecutiveFailures;
     /** Timestamp of last warmup attempt — used for backoff */
@@ -5938,7 +6005,8 @@ declare class SandboxPool {
     onMetrics(callback: SandboxPoolMetricsCallback): void;
     /**
      * Register a warmup spec so the pool can pre-warm agent-specific sandboxes.
-     * If a spec with the same tag already exists, it is replaced.
+     * If a spec with the same tag and configHash already exists, only updates priority (skip #7).
+     * Evicts lowest-priority specs when exceeding MAX_SPECS (fix #2).
      * Triggers replenishment to warm a sandbox for this spec.
      */
     registerWarmupSpec(spec: WarmupSpec): void;
@@ -5993,10 +6061,17 @@ declare class SandboxPool {
     private replenishPool;
     /**
      * Decide which specs to apply to new sandboxes during replenishment.
-     * Strategy: cover uncovered specs first (highest priority), then fill remaining as generic.
+     * Strategy:
+     * - Always reserve at least 1 slot for generic (fix #3)
+     * - Cover uncovered specs first (highest priority), skipping in-flight tags (fix #4)
+     * - Fill remaining as generic
      * Returns an array of length `needed`, where each element is a spec or undefined (generic).
      */
     private selectSpecsForReplenishment;
+    /**
+     * Evict lowest-priority specs when over MAX_SPECS capacity (fix #2).
+     */
+    private evictLowestPrioritySpecs;
     /**
      * Destroy a sandbox and clean up
      */
@@ -7867,10 +7942,10 @@ declare const StoredAgentSchema: z.ZodObject<{
         command: string;
         args?: string[] | undefined;
     }> | undefined;
+    config?: Record<string, unknown> | undefined;
     envVars?: Record<string, string> | undefined;
     startupScript?: string | undefined;
     configFileUrl?: string | undefined;
-    config?: Record<string, unknown> | undefined;
 }, {
     status: "active" | "paused" | "deleted";
     name: string;
@@ -7890,10 +7965,10 @@ declare const StoredAgentSchema: z.ZodObject<{
         command: string;
         args?: string[] | undefined;
     }> | undefined;
+    config?: Record<string, unknown> | undefined;
     envVars?: Record<string, string> | undefined;
     startupScript?: string | undefined;
     configFileUrl?: string | undefined;
-    config?: Record<string, unknown> | undefined;
 }>;
 declare const SimpleAgentSchema: z.ZodObject<{
     name: z.ZodString;
@@ -7951,10 +8026,10 @@ declare const PaginatedAgentsSchema: z.ZodObject<{
             command: string;
             args?: string[] | undefined;
         }> | undefined;
+        config?: Record<string, unknown> | undefined;
         envVars?: Record<string, string> | undefined;
         startupScript?: string | undefined;
         configFileUrl?: string | undefined;
-        config?: Record<string, unknown> | undefined;
     }, {
         status: "active" | "paused" | "deleted";
         name: string;
@@ -7974,10 +8049,10 @@ declare const PaginatedAgentsSchema: z.ZodObject<{
             command: string;
             args?: string[] | undefined;
         }> | undefined;
+        config?: Record<string, unknown> | undefined;
         envVars?: Record<string, string> | undefined;
         startupScript?: string | undefined;
         configFileUrl?: string | undefined;
-        config?: Record<string, unknown> | undefined;
     }>, "many">;
     total: z.ZodNumber;
     hasMore: z.ZodBoolean;
@@ -8001,10 +8076,10 @@ declare const PaginatedAgentsSchema: z.ZodObject<{
             command: string;
             args?: string[] | undefined;
         }> | undefined;
+        config?: Record<string, unknown> | undefined;
         envVars?: Record<string, string> | undefined;
         startupScript?: string | undefined;
         configFileUrl?: string | undefined;
-        config?: Record<string, unknown> | undefined;
     }[];
     total: number;
     hasMore: boolean;
@@ -8028,10 +8103,10 @@ declare const PaginatedAgentsSchema: z.ZodObject<{
             command: string;
             args?: string[] | undefined;
         }> | undefined;
+        config?: Record<string, unknown> | undefined;
         envVars?: Record<string, string> | undefined;
         startupScript?: string | undefined;
         configFileUrl?: string | undefined;
-        config?: Record<string, unknown> | undefined;
     }[];
     total: number;
     hasMore: boolean;
@@ -8074,9 +8149,9 @@ declare const CreateAgentRequestSchema: z.ZodObject<{
         command: string;
         args?: string[] | undefined;
     }> | undefined;
+    config?: Record<string, unknown> | undefined;
     envVars?: Record<string, string> | undefined;
     startupScript?: string | undefined;
-    config?: Record<string, unknown> | undefined;
     slug?: string | undefined;
 }, {
     name: string;
@@ -8092,9 +8167,9 @@ declare const CreateAgentRequestSchema: z.ZodObject<{
         command: string;
         args?: string[] | undefined;
     }> | undefined;
+    config?: Record<string, unknown> | undefined;
     envVars?: Record<string, string> | undefined;
     startupScript?: string | undefined;
-    config?: Record<string, unknown> | undefined;
     slug?: string | undefined;
 }>;
 declare const UpdateAgentRequestSchema: z.ZodObject<{
@@ -8136,9 +8211,9 @@ declare const UpdateAgentRequestSchema: z.ZodObject<{
         command: string;
         args?: string[] | undefined;
     }> | undefined;
+    config?: Record<string, unknown> | undefined;
     envVars?: Record<string, string> | undefined;
     startupScript?: string | undefined;
-    config?: Record<string, unknown> | undefined;
 }, {
     status?: "active" | "paused" | undefined;
     description?: string | undefined;
@@ -8154,9 +8229,9 @@ declare const UpdateAgentRequestSchema: z.ZodObject<{
         command: string;
         args?: string[] | undefined;
     }> | undefined;
+    config?: Record<string, unknown> | undefined;
     envVars?: Record<string, string> | undefined;
     startupScript?: string | undefined;
-    config?: Record<string, unknown> | undefined;
 }>;
 declare const RunAgentRequestSchema: z.ZodObject<{
     prompt: z.ZodString;
@@ -8462,6 +8537,39 @@ declare const SessionStartEventSchema: z.ZodObject<{
     sessionId: string;
     claudeSessionId: string;
 }>;
+declare const SessionInitEventSchema: z.ZodObject<{
+    type: z.ZodLiteral<"session_init">;
+    sessionId: z.ZodString;
+    slashCommands: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        description: z.ZodOptional<z.ZodString>;
+        prompt: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        name: string;
+        description?: string | undefined;
+        prompt?: string | undefined;
+    }, {
+        name: string;
+        description?: string | undefined;
+        prompt?: string | undefined;
+    }>, "many">>;
+}, "strip", z.ZodTypeAny, {
+    type: "session_init";
+    sessionId: string;
+    slashCommands?: {
+        name: string;
+        description?: string | undefined;
+        prompt?: string | undefined;
+    }[] | undefined;
+}, {
+    type: "session_init";
+    sessionId: string;
+    slashCommands?: {
+        name: string;
+        description?: string | undefined;
+        prompt?: string | undefined;
+    }[] | undefined;
+}>;
 declare const TextDeltaEventSchema: z.ZodObject<{
     type: z.ZodLiteral<"text_delta">;
     delta: z.ZodString;
@@ -8834,6 +8942,7 @@ declare const schemas_ResumeSessionRequestSchema: typeof ResumeSessionRequestSch
 declare const schemas_RunAgentRequestSchema: typeof RunAgentRequestSchema;
 declare const schemas_SendMessageRequestSchema: typeof SendMessageRequestSchema;
 declare const schemas_SessionEndEventSchema: typeof SessionEndEventSchema;
+declare const schemas_SessionInitEventSchema: typeof SessionInitEventSchema;
 declare const schemas_SessionSchema: typeof SessionSchema;
 declare const schemas_SessionStartEventSchema: typeof SessionStartEventSchema;
 declare const schemas_SessionStatusSchema: typeof SessionStatusSchema;
@@ -8853,7 +8962,7 @@ declare const schemas_ToolUseEventSchema: typeof ToolUseEventSchema;
 declare const schemas_TurnCompleteEventSchema: typeof TurnCompleteEventSchema;
 declare const schemas_UpdateAgentRequestSchema: typeof UpdateAgentRequestSchema;
 declare namespace schemas {
-  export { schemas_AgentStatusSchema as AgentStatusSchema, schemas_BrowseSkillsRequestSchema as BrowseSkillsRequestSchema, schemas_BrowseSkillsResponseSchema as BrowseSkillsResponseSchema, schemas_CreateAgentRequestSchema as CreateAgentRequestSchema, schemas_CreateSessionRequestSchema as CreateSessionRequestSchema, schemas_ErrorResponseSchema as ErrorResponseSchema, schemas_FileContentSchema as FileContentSchema, schemas_FileEntrySchema as FileEntrySchema, schemas_GitHubSkillSourceSchema as GitHubSkillSourceSchema, schemas_HealthResponseSchema as HealthResponseSchema, schemas_ImageContentSchema as ImageContentSchema, schemas_ListAgentsQuerySchema as ListAgentsQuerySchema, schemas_ListSessionsQuerySchema as ListSessionsQuerySchema, schemas_LocalSkillSourceSchema as LocalSkillSourceSchema, schemas_McpServerConfigSchema as McpServerConfigSchema, schemas_MessageContentSchema as MessageContentSchema, schemas_MessageEventSchema as MessageEventSchema, schemas_MessageSchema as MessageSchema, schemas_OrderQuerySchema as OrderQuerySchema, schemas_PaginatedAgentsSchema as PaginatedAgentsSchema, schemas_PaginatedMessagesSchema as PaginatedMessagesSchema, schemas_PaginatedSessionsSchema as PaginatedSessionsSchema, schemas_PaginationQuerySchema as PaginationQuerySchema, schemas_PermissionModeSchema as PermissionModeSchema, schemas_ReadSkillFileRequestSchema as ReadSkillFileRequestSchema, schemas_ReadSkillFileResponseSchema as ReadSkillFileResponseSchema, schemas_ResumeSessionRequestSchema as ResumeSessionRequestSchema, schemas_RunAgentRequestSchema as RunAgentRequestSchema, schemas_SendMessageRequestSchema as SendMessageRequestSchema, schemas_SessionEndEventSchema as SessionEndEventSchema, schemas_SessionSchema as SessionSchema, schemas_SessionStartEventSchema as SessionStartEventSchema, schemas_SessionStatusSchema as SessionStatusSchema, schemas_SimpleAgentSchema as SimpleAgentSchema, schemas_SkillFileContentSchema as SkillFileContentSchema, schemas_SkillSourceSchema as SkillSourceSchema, schemas_StoredAgentSchema as StoredAgentSchema, schemas_StreamErrorEventSchema as StreamErrorEventSchema, schemas_SuccessResponseSchema as SuccessResponseSchema, schemas_TextContentSchema as TextContentSchema, schemas_TextDeltaEventSchema as TextDeltaEventSchema, schemas_ThinkingDeltaEventSchema as ThinkingDeltaEventSchema, schemas_ToolResultContentSchema as ToolResultContentSchema, schemas_ToolResultEventSchema as ToolResultEventSchema, schemas_ToolUseContentSchema as ToolUseContentSchema, schemas_ToolUseEventSchema as ToolUseEventSchema, schemas_TurnCompleteEventSchema as TurnCompleteEventSchema, schemas_UpdateAgentRequestSchema as UpdateAgentRequestSchema };
+  export { schemas_AgentStatusSchema as AgentStatusSchema, schemas_BrowseSkillsRequestSchema as BrowseSkillsRequestSchema, schemas_BrowseSkillsResponseSchema as BrowseSkillsResponseSchema, schemas_CreateAgentRequestSchema as CreateAgentRequestSchema, schemas_CreateSessionRequestSchema as CreateSessionRequestSchema, schemas_ErrorResponseSchema as ErrorResponseSchema, schemas_FileContentSchema as FileContentSchema, schemas_FileEntrySchema as FileEntrySchema, schemas_GitHubSkillSourceSchema as GitHubSkillSourceSchema, schemas_HealthResponseSchema as HealthResponseSchema, schemas_ImageContentSchema as ImageContentSchema, schemas_ListAgentsQuerySchema as ListAgentsQuerySchema, schemas_ListSessionsQuerySchema as ListSessionsQuerySchema, schemas_LocalSkillSourceSchema as LocalSkillSourceSchema, schemas_McpServerConfigSchema as McpServerConfigSchema, schemas_MessageContentSchema as MessageContentSchema, schemas_MessageEventSchema as MessageEventSchema, schemas_MessageSchema as MessageSchema, schemas_OrderQuerySchema as OrderQuerySchema, schemas_PaginatedAgentsSchema as PaginatedAgentsSchema, schemas_PaginatedMessagesSchema as PaginatedMessagesSchema, schemas_PaginatedSessionsSchema as PaginatedSessionsSchema, schemas_PaginationQuerySchema as PaginationQuerySchema, schemas_PermissionModeSchema as PermissionModeSchema, schemas_ReadSkillFileRequestSchema as ReadSkillFileRequestSchema, schemas_ReadSkillFileResponseSchema as ReadSkillFileResponseSchema, schemas_ResumeSessionRequestSchema as ResumeSessionRequestSchema, schemas_RunAgentRequestSchema as RunAgentRequestSchema, schemas_SendMessageRequestSchema as SendMessageRequestSchema, schemas_SessionEndEventSchema as SessionEndEventSchema, schemas_SessionInitEventSchema as SessionInitEventSchema, schemas_SessionSchema as SessionSchema, schemas_SessionStartEventSchema as SessionStartEventSchema, schemas_SessionStatusSchema as SessionStatusSchema, schemas_SimpleAgentSchema as SimpleAgentSchema, schemas_SkillFileContentSchema as SkillFileContentSchema, schemas_SkillSourceSchema as SkillSourceSchema, schemas_StoredAgentSchema as StoredAgentSchema, schemas_StreamErrorEventSchema as StreamErrorEventSchema, schemas_SuccessResponseSchema as SuccessResponseSchema, schemas_TextContentSchema as TextContentSchema, schemas_TextDeltaEventSchema as TextDeltaEventSchema, schemas_ThinkingDeltaEventSchema as ThinkingDeltaEventSchema, schemas_ToolResultContentSchema as ToolResultContentSchema, schemas_ToolResultEventSchema as ToolResultEventSchema, schemas_ToolUseContentSchema as ToolUseContentSchema, schemas_ToolUseEventSchema as ToolUseEventSchema, schemas_TurnCompleteEventSchema as TurnCompleteEventSchema, schemas_UpdateAgentRequestSchema as UpdateAgentRequestSchema };
 }
 
 /**
@@ -10864,4 +10973,4 @@ declare class AshCloud {
  */
 declare function createAshCloud(options?: Partial<AshCloudOptions>): AshCloud;
 
-export { AVAILABLE_MODELS, type ActionType, type ActiveSession, type AgentBackend, type AgentConfig$1 as AgentConfig, AgentConfigSchema, AgentError, AgentHarness, type AgentHarnessConfig, type AgentHooks, type AgentId, AgentStatus, type AgentStorage, type AgentsRouterOptions$1 as AgentsRouterOptions, AshCloud, AshCloudApiError, AshCloudClient, type AshCloudConfig, type AshCloudError, type AshCloudOptions, type AssistantMessageEntry, type Attachment, type AttachmentConfig, AttachmentConfigSchema, type AttachmentId, AttachmentStorage, type AttachmentStorageConfig, type BackendConfig, type BulkStorage, type BundleStore, type ClaudeAgentOptions, type ClaudeContentBlock, type ClaudeMessage, ClaudeSdkClient, type ClaudeStreamEvent, type ClaudeV2Session, CloudSandbox, type CloudSandboxConfig, CloudStorage, type CloudStorageConfig, type CommandRunAction, type CommandRunResult, ConfigBuilder, ConfigError, type CreateAgentOptions, type CreateQueueItemOptions, type CreateSessionEventOptions, type CreateSessionOptions, CredentialManager, type CredentialManagerConfig, type CredentialStorage, type CustomExecutor, DEFAULT_MODELS, DEFAULT_SANDBOX_PROVIDER_CONFIG, type DiscoveredSkill, type DockerConfig, type EncryptedCredential, type EntryListener, type ErrorEntry, type ErrorEvent, EventCategory, type EventMiddleware, EventSource, type EventStorage, type FileChangeCallback, type FileChangeEvent, type FileChangeType, type FileContent$1 as FileContent, type FileEditAction, type FileEntry, type FileMetadata, type FileProvider, type FileProviderOptions, type FilePullResult, type FilePushResult, type FileReadAction, type FileStore, type FileSyncEvent, type FileSyncEventData, type FileSyncOperation, type FileSyncSource, type FileWatchOptions, FileWatcherManager, type FileWatcherOptions, type FileWatcherStatus, type FileWriteAction, GCSBundleStore, type GCSBundleStoreConfig, GeminiCliClient, type GeminiCliOptions, type GenericToolAction, type GetOrCreateSandboxOptions, GitHubFileProvider, type GitHubSkillConfig, type GitHubSkillResult, type GitHubSkillSource, type GitRepo, type GlobAction, type AgentConfig as HarnessAgentConfig, type HarnessConfig, HarnessConfigSchema, HarnessError, HarnessErrorCode, type HarnessErrorOptions, HarnessEventEmitter, type HarnessEventHandler, type HarnessEventPayloads, type HarnessEventType, type HarnessServer, type HarnessServerConfig, type HarnessServerHooks, type ImageContent, InSandboxWatcher, InSandboxWatcherManager, type InSandboxWatcherOptions, type ListAgentsOptions, type ListMessagesOptions, type ListQueueItemsOptions, type ListSessionEventsOptions, type ListSessionsOptions, type LoadStateResult, LocalBundleStore, LocalFileProvider, LocalSandbox, type LocalSandboxConfig, type LocalSkillSource, type LogContext, type LogEntry, type LogLevel, type Logger, type LoggerConfig, type ManagedWorkspace, type McpAuth, McpConfigBuilder, type McpGenerationResult, type McpHttpServerConfig, McpPresets, type McpServerConfig, type McpServerInfo, type McpServerStatus, McpServers, type McpStatusEvent, type McpStdioServerConfig, type McpTool, type McpToolAction, type McpTransportType, MemoryBundleStore, MemoryCredentialStorage, MemoryQueueStorage, MemoryRateLimitStore, MemoryStorage, MemoryStreamEventStorage, type Message, type MessageContent, type MessageEvent, type MessageId, MessageRole, type NormalizedEntry, type NormalizedEntryType, type NormalizedToolCall, NotFoundError, type OpenAPIServer, type OpenAPIServerConfig, type PaginatedResult, type PaginationOptions, type PooledSandbox, PostgresQueueStorage, type PostgresQueueStorageConfig, PostgresStorage, type PostgresStorageConfig, ProviderSandbox, type ProviderSandboxConfig, type ProxyConfig, type PullOptions, type PushOptions, type QueueItem, QueueItemStatus, QueueProcessor, type QueueProcessorCallbacks, type QueueProcessorConfig, type QueueRouterOptions, type QueueStats, type QueueStorage, type RateLimitConfig, type RateLimitResult, type RateLimitStore, type ReadStreamEventsOptions, type RequestLoggerOptions, type ResumeSessionOptions, type RuntimeConfig, RuntimeConfigBuilder, RuntimePresets, S3BundleStore, type S3BundleStoreConfig, S3FileStore, type S3FileStoreConfig, SENSITIVE_PATHS, type SandboxCommandResult, type SandboxConfig, type SandboxConnection, type SandboxFileOperations, SandboxFileSync, type SandboxFileSyncOptions, SandboxFileWatcher, SandboxGitRepo, type SandboxHeartbeatStatus, type SandboxLogCallback, type SandboxLogCategory$1 as SandboxLogCategory, type SandboxLogEntry$1 as SandboxLogEntry, type SandboxLogEvent, type SandboxLogLevel$1 as SandboxLogLevel, SandboxLogger, SandboxPool, type SandboxPoolConfig, type SandboxPoolMetricsCallback, type SandboxPoolStatus, type SandboxProviderConfig, type SandboxProviderType, type SandboxReadResult, type SandboxWithState, type SandboxWriteResult, type SaveStateResult, type SearchAction, type SendMessageOptions, type SendMessageRequest, type SendMessageResult, type ServerConfig, ServerConfigSchema, type Session, type SessionEndEvent, SessionError, type SessionEvent, type SessionId, SessionManager, type SessionQueueStatus, type SessionStartEvent, SessionStatus, type SessionStoppedEvent, type SessionStorage, type SessionsRouterOptions$1 as SessionsRouterOptions, SkillCatalog, type SkillConfig, SkillManager, type SkillManagerOptions, type SkillSource, type SkillsConfig, type StartServerOptions, type StopSessionResult, type StorageConfig$1 as StorageConfig, StorageConfigSchema, StorageError, type StoredAgent, type StoredStreamEvent, type StreamEvent, type StreamEventRelayOptions, type StreamEventStorage, StreamEventType, StreamEventWriter, type StreamEventWriterOptions, SupabaseBundleStore, type SupabaseBundleStoreConfig, SupabaseStorage, type SupabaseStorageConfig, type SyncResult, type TextContent, type TextDeltaEvent, type ThinkingDeltaEvent, type ThinkingEntry, type TodoItem, type TodoStatus, type TodoWriteAction, type ToolCallEntry, ToolCallProcessor, ToolError, type ToolResult, type ToolResultContent, type ToolResultEvent, type ToolStatus, type ToolUseContent, type ToolUseEvent, type TransactionalStorage, type TurnCompleteEvent, type UpdateAgentOptions, type UserMessageEntry, ValidationError, type WarmSandboxOptions, type WarmSandboxResult, type WarmupSpec, type WebFetchAction, type WebSearchAction, type WebhookBatchPayload, type WebhookConfig, type WebhookDeliveryEventData, type WebhookFileSyncEvent, type WebhookPayload, Workspace, type CommandResult as WorkspaceCommandResult, type WorkspaceConfig, type WorkspaceHook, type WorkspaceLoadResult, WorkspaceManager, type WorkspaceSaveResult, type WorkspaceSessionConfig, attachmentSchema, attachmentToDataUrl, checkSecurityConfig, claudeClient, cleanupAllSandboxes, configureMcp, configureRuntime, convertClaudeMessage, createAgentsRouter$1 as createAgentsRouter, createAshCloud, createBackendExecutor, createCloudSandbox, createConfig, createCredentialManager, createOpenAPIServer as createDocumentedServer, createE2BSandbox, createEventHandler, createEventMiddlewareChain, createFileWatcher, createFileWatcherManager, createGCSBundleStore, createGeminiExecutor, createGitHubFileProvider, createGitRepo, createHarnessServer, createInSandboxWatcher, createInSandboxWatcherManager, createLocalBundleStore, createLocalFileProvider, createLocalSandbox, createLogger, createMemoryBundleStore, createMinioBundleStore, createMinioFileStore, createModalSandbox, createAgentsRouter as createOpenAPIAgentsRouter, createOpenAPIServer, createSessionsRouter as createOpenAPISessionsRouter, createSkillsRouter as createOpenAPISkillsRouter, createProviderSandbox, createQueueProcessor, createQueueRouter, createR2BundleStore, createR2FileStore, createS3BundleStore, createS3FileStore, createSandboxFileOperations, createSandboxFileSync, createSandboxLogger, createSandboxOptions, createSessionWorkspace, createSessionsRouter$1 as createSessionsRouter, createSkillCatalog, createSkillManager, createSupabaseBundleStore, createSupabaseBundleStoreFromEnv, createToolCall, createToolCallProcessor, createVercelSandbox, createVercelSandboxExecutor, createWorkspace, createWorkspaceHooks, createWorkspaceManager, dataUrlToBuffer, defineAgent, defineConfig, ensureSandboxPoolInitialized, env, envOptional, executeCommandInSandbox, extractTextContent, extractTextFromMessage, fileEntrySchema, formatToolName, generateDockerCommand, generateMcpServerPackage, generateMcpServers, generateProxyEnv, generateToolSummary, getActionIcon, getActionLabel, getAllHeartbeatStatuses, getApiKeyEnvVar, getCachedSandbox, getDefaultModel, getFileWatcherManager, getHeartbeatStatus, getInSandboxWatcherManager, getOrCreateSandbox, getSandboxCacheStats, getSandboxPool, getWorkspaceManager, gitHubSkillSourceSchema, globalEventEmitter, hasErrorCode, hashStartupScript, httpMcpWithAuth, initializeSandboxPool, introspectMcpServer, invalidateSandbox, isCommandRunAction, isDocumentMimeType, isErrorEntry, isFileEditAction, isFileReadAction, isFileWriteAction, isGenericToolAction, isGlobAction, isHarnessError, isHttpMcpConfig, isImageMimeType, isMcpToolAction, isSandboxExpiredError, isSandboxRunning, isSearchAction, isSensitivePath, isStdioMcpConfig, isTodoWriteAction, isToolCallEntry, isValidModel, isWebFetchAction, isWebSearchAction, listFilesInSandbox, loadConfig, loadGitHubSkill, loadGitHubSkills, loadWorkspaceState, localSkillSourceSchema, log, mapClaudeOptionsToGemini, mapToolToActionType, markConfigInstalled, markInstallScriptRan, markSdkInstalled, markStartupScriptRan, mcpAuthToHeaders, messageContentSchema, messageSchema, needsStartupScriptRerun, normalizeGitHubConfigs, normalizeMcpServers, normalizeMessages, normalizeToolResult, onHeartbeat, schemas as openApiSchemas, parseCommandResult, parseGitHubUrl, parseMcpToolName, processStreamEvents, rateLimit, rateLimiters, readFileFromSandbox, rekeySessionId, releaseSandbox, requestLogger, saveWorkspaceState, sessionSchema, shouldUseSandbox, shutdownSandboxPool, skillConfigSchema, skillSourceSchema, sseMcpWithAuth, startServer, streamEventRelay, updateToolCallWithResult, warmSandboxForSession, writeFileToSandbox };
+export { AVAILABLE_MODELS, type ActionType, type ActiveSession, type AgentBackend, type AgentConfig$1 as AgentConfig, AgentConfigSchema, AgentError, AgentHarness, type AgentHarnessConfig, type AgentHooks, type AgentId, AgentStatus, type AgentStorage, type AgentsRouterOptions$1 as AgentsRouterOptions, type AnyMcpServerConfig, AshCloud, AshCloudApiError, AshCloudClient, type AshCloudConfig, type AshCloudError, type AshCloudOptions, type AssistantMessageEntry, type Attachment, type AttachmentConfig, AttachmentConfigSchema, type AttachmentId, AttachmentStorage, type AttachmentStorageConfig, type BackendConfig, type BulkStorage, type BundleStore, type ClaudeAgentOptions, type ClaudeContentBlock, type ClaudeMessage, ClaudeSdkClient, type ClaudeStreamEvent, type ClaudeV2Session, CloudSandbox, type CloudSandboxConfig, CloudStorage, type CloudStorageConfig, type CommandRunAction, type CommandRunResult, ConfigBuilder, ConfigError, type CreateAgentOptions, type CreateQueueItemOptions, type CreateSessionEventOptions, type CreateSessionOptions, CredentialManager, type CredentialManagerConfig, type CredentialStorage, type CustomExecutor, DEFAULT_MODELS, DEFAULT_SANDBOX_PROVIDER_CONFIG, type DiscoveredSkill, type DockerConfig, type EncryptedCredential, type EntryListener, type ErrorEntry, type ErrorEvent, EventCategory, type EventMiddleware, EventSource, type EventStorage, type FileChangeCallback, type FileChangeEvent, type FileChangeType, type FileContent$1 as FileContent, type FileEditAction, type FileEntry, type FileMetadata, type FileProvider, type FileProviderOptions, type FilePullResult, type FilePushResult, type FileReadAction, type FileStore, type FileSyncEvent, type FileSyncEventData, type FileSyncOperation, type FileSyncSource, type FileWatchOptions, FileWatcherManager, type FileWatcherOptions, type FileWatcherStatus, type FileWriteAction, GCSBundleStore, type GCSBundleStoreConfig, GeminiCliClient, type GeminiCliOptions, type GenericToolAction, type GetOrCreateSandboxOptions, GitHubFileProvider, type GitHubSkillConfig, type GitHubSkillResult, type GitHubSkillSource, type GitRepo, type GlobAction, type AgentConfig as HarnessAgentConfig, type HarnessConfig, HarnessConfigSchema, HarnessError, HarnessErrorCode, type HarnessErrorOptions, HarnessEventEmitter, type HarnessEventHandler, type HarnessEventPayloads, type HarnessEventType, type HarnessServer, type HarnessServerConfig, type HarnessServerHooks, type ImageContent, InSandboxWatcher, InSandboxWatcherManager, type InSandboxWatcherOptions, type ListAgentsOptions, type ListMessagesOptions, type ListQueueItemsOptions, type ListSessionEventsOptions, type ListSessionsOptions, type LoadStateResult, LocalBundleStore, LocalFileProvider, LocalSandbox, type LocalSandboxConfig, type LocalSkillSource, type LogContext, type LogEntry, type LogLevel, type Logger, type LoggerConfig, type ManagedWorkspace, type McpAuth, McpConfigBuilder, type McpGenerationResult, type McpHttpServerConfig, McpPresets, type McpServerConfig, type McpServerInfo, type McpServerStatus, McpServers, type McpStatusEvent, type McpStdioServerConfig, type McpTool, type McpToolAction, type McpTransportType, MemoryBundleStore, MemoryCredentialStorage, MemoryQueueStorage, MemoryRateLimitStore, MemoryStorage, MemoryStreamEventStorage, type Message, type MessageContent, type MessageEvent, type MessageId, MessageRole, type NormalizedEntry, type NormalizedEntryType, type NormalizedToolCall, NotFoundError, type OpenAPIServer, type OpenAPIServerConfig, type PaginatedResult, type PaginationOptions, type PooledSandbox, PostgresQueueStorage, type PostgresQueueStorageConfig, PostgresStorage, type PostgresStorageConfig, ProviderSandbox, type ProviderSandboxConfig, type ProxyConfig, type PullOptions, type PushOptions, type QueueItem, QueueItemStatus, QueueProcessor, type QueueProcessorCallbacks, type QueueProcessorConfig, type QueueRouterOptions, type QueueStats, type QueueStorage, type RateLimitConfig, type RateLimitResult, type RateLimitStore, type ReadStreamEventsOptions, type RequestLoggerOptions, type ResumeSessionOptions, type RuntimeConfig, RuntimeConfigBuilder, RuntimePresets, S3BundleStore, type S3BundleStoreConfig, S3FileStore, type S3FileStoreConfig, SENSITIVE_PATHS, type SandboxCommandResult, type SandboxConfig, type SandboxConnection, type SandboxFileOperations, SandboxFileSync, type SandboxFileSyncOptions, SandboxFileWatcher, SandboxGitRepo, type SandboxHeartbeatStatus, type SandboxLogCallback, type SandboxLogCategory$1 as SandboxLogCategory, type SandboxLogEntry$1 as SandboxLogEntry, type SandboxLogEvent, type SandboxLogLevel$1 as SandboxLogLevel, SandboxLogger, SandboxPool, type SandboxPoolConfig, type SandboxPoolMetricsCallback, type SandboxPoolStatus, type SandboxProviderConfig, type SandboxProviderType, type SandboxReadResult, type SandboxWithState, type SandboxWriteResult, type SaveStateResult, type SdkMcpServerConfig, type SearchAction, type SendMessageOptions, type SendMessageRequest, type SendMessageResult, type ServerConfig, ServerConfigSchema, type Session, type SessionEndEvent, SessionError, type SessionEvent, type SessionId, SessionManager, type SessionQueueStatus, type SessionStartEvent, SessionStatus, type SessionStoppedEvent, type SessionStorage, type SessionsRouterOptions$1 as SessionsRouterOptions, SkillCatalog, type SkillConfig, SkillManager, type SkillManagerOptions, type SkillSource, type SkillsConfig, type StartServerOptions, type StopSessionResult, type StorageConfig$1 as StorageConfig, StorageConfigSchema, StorageError, type StoredAgent, type StoredStreamEvent, type StreamEvent, type StreamEventRelayOptions, type StreamEventStorage, StreamEventType, StreamEventWriter, type StreamEventWriterOptions, SupabaseBundleStore, type SupabaseBundleStoreConfig, SupabaseStorage, type SupabaseStorageConfig, type SyncResult, type TextContent, type TextDeltaEvent, type ThinkingDeltaEvent, type ThinkingEntry, type TodoItem, type TodoStatus, type TodoWriteAction, type ToolCallEntry, ToolCallProcessor, ToolError, type ToolResult, type ToolResultContent, type ToolResultEvent, type ToolStatus, type ToolUseContent, type ToolUseEvent, type TransactionalStorage, type TurnCompleteEvent, type UpdateAgentOptions, type UserMessageEntry, ValidationError, type WarmSandboxOptions, type WarmSandboxResult, type WarmupSetupResult, type WarmupSpec, type WebFetchAction, type WebSearchAction, type WebhookBatchPayload, type WebhookConfig, type WebhookDeliveryEventData, type WebhookFileSyncEvent, type WebhookPayload, Workspace, type CommandResult as WorkspaceCommandResult, type WorkspaceConfig, type WorkspaceHook, type WorkspaceLoadResult, WorkspaceManager, type WorkspaceSaveResult, type WorkspaceSessionConfig, attachmentSchema, attachmentToDataUrl, checkSecurityConfig, claudeClient, cleanupAllSandboxes, configureMcp, configureRuntime, convertClaudeMessage, createAgentsRouter$1 as createAgentsRouter, createAshCloud, createBackendExecutor, createCloudSandbox, createConfig, createCredentialManager, createOpenAPIServer as createDocumentedServer, createE2BSandbox, createEventHandler, createEventMiddlewareChain, createFileWatcher, createFileWatcherManager, createGCSBundleStore, createGeminiExecutor, createGitHubFileProvider, createGitRepo, createHarnessServer, createInSandboxWatcher, createInSandboxWatcherManager, createLocalBundleStore, createLocalFileProvider, createLocalSandbox, createLogger, createMemoryBundleStore, createMinioBundleStore, createMinioFileStore, createModalSandbox, createAgentsRouter as createOpenAPIAgentsRouter, createOpenAPIServer, createSessionsRouter as createOpenAPISessionsRouter, createSkillsRouter as createOpenAPISkillsRouter, createProviderSandbox, createQueueProcessor, createQueueRouter, createR2BundleStore, createR2FileStore, createS3BundleStore, createS3FileStore, createSandboxFileOperations, createSandboxFileSync, createSandboxLogger, createSandboxOptions, createSessionWorkspace, createSessionsRouter$1 as createSessionsRouter, createSkillCatalog, createSkillManager, createSupabaseBundleStore, createSupabaseBundleStoreFromEnv, createToolCall, createToolCallProcessor, createVercelSandbox, createVercelSandboxExecutor, createWorkspace, createWorkspaceHooks, createWorkspaceManager, dataUrlToBuffer, defineAgent, defineConfig, ensureSandboxPoolInitialized, env, envOptional, executeCommandInSandbox, extractTextContent, extractTextFromMessage, fileEntrySchema, formatToolName, generateDockerCommand, generateMcpServerPackage, generateMcpServers, generateProxyEnv, generateToolSummary, getActionIcon, getActionLabel, getAllHeartbeatStatuses, getApiKeyEnvVar, getCachedSandbox, getDefaultModel, getFileWatcherManager, getHeartbeatStatus, getInSandboxWatcherManager, getOrCreateSandbox, getSandboxCacheStats, getSandboxPool, getWorkspaceManager, gitHubSkillSourceSchema, globalEventEmitter, hasErrorCode, hashStartupScript, httpMcpWithAuth, initializeSandboxPool, introspectMcpServer, invalidateSandbox, isCommandRunAction, isDocumentMimeType, isErrorEntry, isFileEditAction, isFileReadAction, isFileWriteAction, isGenericToolAction, isGlobAction, isHarnessError, isHttpMcpConfig, isImageMimeType, isMcpToolAction, isSandboxExpiredError, isSandboxRunning, isSearchAction, isSensitivePath, isStdioMcpConfig, isTodoWriteAction, isToolCallEntry, isValidModel, isWebFetchAction, isWebSearchAction, listFilesInSandbox, loadConfig, loadGitHubSkill, loadGitHubSkills, loadWorkspaceState, localSkillSourceSchema, log, mapClaudeOptionsToGemini, mapToolToActionType, markConfigInstalled, markInstallScriptRan, markSdkInstalled, markStartupScriptRan, mcpAuthToHeaders, messageContentSchema, messageSchema, needsStartupScriptRerun, normalizeGitHubConfigs, normalizeMcpServers, normalizeMessages, normalizeToolResult, onHeartbeat, schemas as openApiSchemas, parseCommandResult, parseGitHubUrl, parseMcpToolName, processStreamEvents, rateLimit, rateLimiters, readFileFromSandbox, rekeySessionId, releaseSandbox, requestLogger, saveWorkspaceState, sessionSchema, shouldUseSandbox, shutdownSandboxPool, skillConfigSchema, skillSourceSchema, sseMcpWithAuth, startServer, streamEventRelay, updateToolCallWithResult, warmSandboxForSession, writeFileToSandbox };