@ash-cloud/ash-ai 0.1.16 → 0.1.18

package/dist/index.d.cts

@@ -1,16 +1,17 @@
 import { z } from 'zod';
+import { EventEmitter } from 'events';
 import * as fs from 'fs/promises';
 import * as hono_types from 'hono/types';
 import * as hono from 'hono';
 import { Hono, Context, MiddlewareHandler } from 'hono';
+import { Writable } from 'stream';
 import { OpenAPIHono } from '@hono/zod-openapi';
 import { OpenAPIObject } from 'openapi3-ts/oas31';
 import * as _hono_node_server from '@hono/node-server';
 export { serve } from '@hono/node-server';
 import * as drizzle_orm_postgres_js from 'drizzle-orm/postgres-js';
 import postgres from 'postgres';
-export { A as AttachmentRow, M as MessageRow, b as NewAttachmentRow, a as NewMessageRow, c as NewQueueItemRow, e as NewSessionEventRow, N as NewSessionRow, Q as QueueItemRow, d as SessionEventRow, S as SessionRow, s as schema } from './schema-DSLyNeoS.cjs';
-import { Writable } from 'stream';
+export { A as AttachmentRow, M as MessageRow, b as NewAttachmentRow, a as NewMessageRow, c as NewQueueItemRow, e as NewSessionEventRow, N as NewSessionRow, g as NewStreamEventRow, Q as QueueItemRow, d as SessionEventRow, S as SessionRow, f as StreamEventRow, s as schema } from './schema-CAoHu2Rx.cjs';
 import 'drizzle-orm';
 import 'drizzle-orm/pg-core';
 
@@ -543,6 +544,7 @@ interface PaginatedResult<T> {
 interface ListSessionsOptions extends PaginationOptions {
     agentName?: string;
     status?: SessionStatus;
+    resourceId?: string;
 }
 interface ListMessagesOptions extends PaginationOptions {
     sessionId?: SessionId;
@@ -1315,6 +1317,15 @@ declare const EventCategory: {
     readonly WEBHOOK: "webhook";
 };
 type EventCategory = (typeof EventCategory)[keyof typeof EventCategory];
+/**
+ * Event source for distinguishing event origins in the timeline
+ */
+declare const EventSource: {
+    readonly AGENT: "agent";
+    readonly SYSTEM: "system";
+    readonly DERIVED: "derived";
+};
+type EventSource = (typeof EventSource)[keyof typeof EventSource];
 /**
  * File sync operation types
  */
@@ -1390,6 +1401,7 @@ interface SessionEvent {
     sessionId: SessionId;
     eventType: string;
     category: EventCategory;
+    eventSource: EventSource;
     startedAt: Date;
     endedAt?: Date;
     durationMs?: number;
@@ -1407,6 +1419,7 @@ interface SessionEvent {
 interface CreateSessionEventOptions {
     eventType: string;
     category: EventCategory;
+    eventSource?: EventSource;
     startedAt: Date;
     endedAt?: Date;
     durationMs?: number;
@@ -1423,9 +1436,41 @@ interface CreateSessionEventOptions {
 interface ListSessionEventsOptions extends PaginationOptions {
     category?: EventCategory;
     eventType?: string;
+    /** Filter by event source (agent, system, derived) */
+    eventSource?: EventSource;
     /** Filter events involving this file path (matches file events and Read/Write/Edit tool calls) */
     filePath?: string;
 }
+/**
+ * A stream event persisted to storage for SSE relay.
+ * Events are written during agent execution and read by the relay
+ * to deliver SSE to clients, enabling reliable reconnection.
+ */
+interface StoredStreamEvent {
+    /** Unique identifier */
+    id: string;
+    /** Session this event belongs to */
+    sessionId: SessionId;
+    /** Monotonically increasing sequence number per session, used as cursor for reconnection */
+    sequence: number;
+    /** The StreamEvent.type (e.g., 'text_delta', 'tool_use', 'session_end') */
+    eventType: string;
+    /** Full serialized StreamEvent payload */
+    payload: StreamEvent;
+    /** Number of events batched (1 for non-batched, N for aggregated text deltas) */
+    batchCount: number;
+    /** When this event was stored */
+    createdAt: Date;
+}
+/**
+ * Options for reading stream events from storage
+ */
+interface ReadStreamEventsOptions {
+    /** Cursor: return events with sequence > afterSequence */
+    afterSequence?: number;
+    /** Maximum number of events to return */
+    limit?: number;
+}
 
 /**
  * Base Error Types for Agent SDK Harness
@@ -1712,6 +1757,43 @@ interface EventStorage {
      */
     getNextEventSequence(sessionId: SessionId): Promise<number>;
 }
+/**
+ * Storage interface for stream events used by the SSE relay system.
+ * Events are written during agent execution and read by the relay
+ * to deliver SSE to clients, enabling reliable reconnection.
+ */
+interface StreamEventStorage {
+    initialize(): Promise<void>;
+    close(): Promise<void>;
+    /**
+     * Append one or more events to a session's stream.
+     * Events are assigned monotonically increasing sequence numbers.
+     */
+    appendEvents(sessionId: SessionId, events: Array<{
+        eventType: string;
+        payload: StreamEvent;
+        batchCount?: number;
+    }>): Promise<StoredStreamEvent[]>;
+    /**
+     * Read events from a session's stream, optionally starting after a given sequence.
+     * Results are ordered by sequence number ascending.
+     */
+    readEvents(sessionId: SessionId, options?: ReadStreamEventsOptions): Promise<StoredStreamEvent[]>;
+    /**
+     * Get the latest sequence number for a session (0 if no events).
+     */
+    getLatestSequence(sessionId: SessionId): Promise<number>;
+    /**
+     * Delete all stream events for a session (cleanup on session deletion).
+     */
+    deleteSessionEvents(sessionId: SessionId): Promise<void>;
+    /**
+     * Clean up old stream events across all sessions.
+     * @param maxAgeMs - Delete events older than this many milliseconds
+     * @returns Number of events deleted
+     */
+    cleanupOldEvents(maxAgeMs: number): Promise<number>;
+}
 
 /**
  * Credential Management
@@ -2481,6 +2563,13 @@ interface AgentHarnessConfig extends AgentConfig$1 {
      * Only used if customExecutor is not provided.
      */
     backend?: AgentBackend;
+    /**
+     * Optional stream event storage for SSE relay.
+     * When configured, events from send() are written to storage AND yielded to the consumer.
+     * This enables the relay pattern: agent writes to storage, relay reads from storage,
+     * allowing reliable client reconnection via GET /sessions/:id/stream?after=N.
+     */
+    streamEventStorage?: StreamEventStorage;
 }
 /**
  * Result of stopping a session execution
@@ -2557,6 +2646,8 @@ declare class AgentHarness {
     private sessionSkillDirs;
     /** Tracks active executions by session ID for stop/interrupt capability */
     private activeExecutions;
+    /** EventEmitters for same-process SSE relay fast-path, keyed by session ID */
+    private sessionEmitters;
     constructor(config: AgentHarnessConfig);
     /**
      * Initialize the agent harness and storage
@@ -2610,6 +2701,16 @@ declare class AgentHarness {
      * Get the session manager for advanced operations
      */
     getSessionManager(): SessionManager;
+    /**
+     * Get the stream event storage (if configured)
+     */
+    getStreamEventStorage(): StreamEventStorage | undefined;
+    /**
+     * Get the EventEmitter for a session's stream events.
+     * Used by the relay endpoint for same-process fast-path.
+     * Returns undefined if no active execution or no streamEventStorage configured.
+     */
+    getSessionEmitter(sessionId: SessionId): EventEmitter | undefined;
     private ensureInitialized;
     private createActiveSession;
     /**
@@ -2777,6 +2878,26 @@ declare class MemoryQueueStorage implements QueueStorage {
     clear(): void;
 }
 
+/**
+ * In-memory implementation of StreamEventStorage for development and testing.
+ * Data is lost when the process exits.
+ */
+declare class MemoryStreamEventStorage implements StreamEventStorage {
+    private events;
+    private nextSequence;
+    initialize(): Promise<void>;
+    close(): Promise<void>;
+    appendEvents(sessionId: SessionId, events: Array<{
+        eventType: string;
+        payload: StreamEvent;
+        batchCount?: number;
+    }>): Promise<StoredStreamEvent[]>;
+    readEvents(sessionId: SessionId, options?: ReadStreamEventsOptions): Promise<StoredStreamEvent[]>;
+    getLatestSequence(sessionId: SessionId): Promise<number>;
+    deleteSessionEvents(sessionId: SessionId): Promise<void>;
+    cleanupOldEvents(maxAgeMs: number): Promise<number>;
+}
+
 /**
  * Queue Processor
  *
@@ -4810,6 +4931,36 @@ interface WebhookConfig {
      * Useful for including project IDs, tenant IDs, or other context.
      */
     metadata?: Record<string, unknown>;
+    /**
+     * Glob patterns for file paths to exclude from webhooks.
+     * Merged with built-in default ignores (e.g. agent-runner.js).
+     * Supports single-segment wildcards and double-star recursive matching.
+     */
+    ignorePaths?: string[];
+    /**
+     * Batch window in milliseconds.
+     * When set, webhook events are collected during this window and sent
+     * as a single `file_sync_batch` payload. Within a batch, duplicate
+     * file paths are deduplicated (latest event wins).
+     * Default: undefined (no batching, each event sent immediately)
+     */
+    batchWindowMs?: number;
+}
+/**
+ * File sync event shape sent in webhook payloads.
+ * Mirrors FileSyncEvent but replaces raw Buffer content with a pre-signed S3 download URL.
+ */
+interface WebhookFileSyncEvent {
+    operation: FileSyncEvent['operation'];
+    source: FileSyncEvent['source'];
+    canonicalPath: string;
+    basePath: string;
+    sandboxPath: string;
+    fileSize?: number;
+    success: boolean;
+    error?: string;
+    /** Pre-signed S3 download URL (replaces raw previousContent/newContent) */
+    downloadUrl?: string;
 }
 /**
  * Payload sent to webhook endpoints
@@ -4824,10 +4975,28 @@ interface WebhookPayload {
     /** Custom metadata from webhook config */
     metadata?: Record<string, unknown>;
     /** File sync event data (for file_sync events) */
-    fileSyncEvent?: FileSyncEvent;
+    fileSyncEvent?: WebhookFileSyncEvent;
     /** File change event data (for file_change events from watchers) */
     fileChangeEvent?: FileChangeEvent;
 }
+/**
+ * Batch payload sent when batchWindowMs is configured.
+ * Collects multiple events into a single HTTP request.
+ */
+interface WebhookBatchPayload {
+    /** Event type — always 'file_sync_batch' for batch payloads */
+    event: 'file_sync_batch';
+    /** Timestamp when the batch was flushed */
+    timestamp: string;
+    /** Session ID */
+    sessionId: string;
+    /** Custom metadata from webhook config */
+    metadata?: Record<string, unknown>;
+    /** File sync events in this batch */
+    fileSyncEvents: WebhookFileSyncEvent[];
+    /** File change events in this batch */
+    fileChangeEvents: FileChangeEvent[];
+}
 /**
  * Result of writing a file to a sandbox
  */
@@ -5056,6 +5225,8 @@ declare class SandboxFileSync {
     private localWatchers;
     private fileChangeSubscribers;
     private sequenceNumbers;
+    private batchTimer;
+    private batchQueue;
     constructor(options: SandboxFileSyncOptions);
     /**
      * Set the file event callback
@@ -5076,6 +5247,20 @@ declare class SandboxFileSync {
      * Remove webhook configuration
      */
     removeWebhook(): void;
+    /**
+     * Check if a file path should be excluded from webhook notifications.
+     * Tests against DEFAULT_WEBHOOK_IGNORE patterns and any user-configured ignorePaths.
+     */
+    private shouldIgnorePath;
+    /**
+     * Route a webhook payload through batching (if configured) or send immediately.
+     * When batchWindowMs is set, payloads are queued and deduplicated by file path.
+     */
+    private enqueueOrSendWebhook;
+    /**
+     * Flush all queued webhook payloads as a single batch request.
+     */
+    private flushWebhookBatch;
     /**
      * Extract hostname from URL for display (security - don't expose full URL)
      */
@@ -5092,7 +5277,9 @@ declare class SandboxFileSync {
      */
     private sendWebhook;
     /**
-     * Send a file sync event webhook
+     * Send a file sync event webhook.
+     * Strips raw Buffer content (previousContent/newContent) and replaces with a
+     * pre-signed S3 download URL when the file exists in storage.
      */
     private sendFileSyncWebhook;
     /**
@@ -5480,6 +5667,53 @@ declare function shouldUseSandbox(): boolean;
  * @returns A CustomExecutor function for use with AgentHarness
  */
 declare function createVercelSandboxExecutor(apiKey: string): CustomExecutor;
+/**
+ * Options for pre-warming a sandbox before the user sends a message.
+ */
+interface WarmSandboxOptions {
+    /** Session ID to warm a sandbox for */
+    sessionId: string;
+    /** Sandbox runtime (default: 'node22') */
+    runtime?: 'node22' | 'python3.13';
+    /** Sandbox timeout in seconds (default: 600) */
+    timeout?: number;
+    /** Number of vCPUs (default: 4) */
+    vcpus?: number;
+    /** Startup script to run after SDK installation */
+    startupScript?: string;
+    /** URL to a .claude config zip to install */
+    configFileUrl?: string;
+    /** Environment variables to set in the sandbox */
+    envVars?: Record<string, string>;
+}
+/**
+ * Result of warming a sandbox.
+ */
+interface WarmSandboxResult {
+    /** The Vercel sandbox ID */
+    sandboxId: string;
+    /** Whether the sandbox is ready for use */
+    ready: boolean;
+}
+/**
+ * Pre-warm a sandbox for a session before the user sends their first message.
+ *
+ * This acquires a sandbox (from the pool if available, or creates one on-demand),
+ * installs the SDK if needed, runs an optional startup script, and downloads an
+ * optional config file. The result is cached so that when `getOrCreateSandbox()`
+ * is called during the actual message, the pre-warmed sandbox is returned instantly.
+ *
+ * @example
+ * ```typescript
+ * // When user opens the chat UI, warm a sandbox immediately
+ * const result = await warmSandboxForSession({ sessionId: session.id });
+ * console.log('Sandbox ready:', result.sandboxId);
+ *
+ * // Later, when user sends a message, sandbox is already warm
+ * for await (const event of session.send('hello')) { ... }
+ * ```
+ */
+declare function warmSandboxForSession(options: WarmSandboxOptions): Promise<WarmSandboxResult>;
 
 /**
  * Pre-Warmed Sandbox Pool
@@ -5591,6 +5825,10 @@ interface SandboxPoolStatus {
     running: boolean;
     /** Last maintenance cycle timestamp */
     lastMaintenanceAt: number | null;
+    /** Consecutive warmup failures (0 = healthy) */
+    consecutiveFailures: number;
+    /** Whether warmup is suspended due to too many failures */
+    warmupSuspended: boolean;
     /** Configuration */
     config: {
         minPoolSize: number;
@@ -5618,6 +5856,14 @@ declare class SandboxPool {
     private lastMaintenanceAt;
     private metricsCallback?;
     private startPromise;
+    /** Consecutive warmup failure count (reset on success) */
+    private consecutiveFailures;
+    /** Timestamp of last warmup attempt — used for backoff */
+    private lastWarmupAttemptAt;
+    /** Max consecutive failures before stopping attempts entirely until manual restart */
+    private static readonly MAX_CONSECUTIVE_FAILURES;
+    /** Base backoff delay in ms (doubles each failure: 30s, 60s, 120s, 240s…) */
+    private static readonly BACKOFF_BASE_MS;
     constructor(config?: SandboxPoolConfig);
     /**
      * Start the pool and begin warming sandboxes
@@ -5679,7 +5925,9 @@ declare class SandboxPool {
      */
     private triggerReplenishment;
     /**
-     * Replenish pool if below min size
+     * Replenish pool if below min size.
+     * Applies exponential backoff when warmups keep failing to avoid
+     * a tight failure loop that wastes resources and floods metrics.
      */
     private replenishPool;
     /**
@@ -6356,6 +6604,66 @@ declare function createSandboxLogger(options?: {
     consoleEnabled?: boolean;
 }): SandboxLogger;
 
+interface StreamEventWriterOptions {
+    storage: StreamEventStorage;
+    sessionId: SessionId;
+    /** Optional EventEmitter for same-process fast-path (EC2 optimization) */
+    emitter?: EventEmitter;
+    /** Flush interval for text_delta batching in ms (default: 100) */
+    flushIntervalMs?: number;
+    /** Max chars before flushing text_delta batch (default: 500) */
+    maxBatchChars?: number;
+}
+declare class StreamEventWriter {
+    private storage;
+    private sessionId;
+    private emitter?;
+    private flushIntervalMs;
+    private maxBatchChars;
+    private pendingDelta;
+    private pendingDeltaCount;
+    private flushTimer;
+    private closed;
+    constructor(options: StreamEventWriterOptions);
+    /**
+     * Write a stream event. Text deltas are batched; all other events are written immediately.
+     */
+    write(event: StreamEvent): Promise<void>;
+    /**
+     * Flush any pending text_delta events to storage as a single batched event.
+     */
+    flush(): Promise<void>;
+    /**
+     * Close the writer, flushing any remaining events.
+     */
+    close(): Promise<void>;
+    private writeToStorage;
+}
+
+interface StreamEventRelayOptions {
+    storage: StreamEventStorage;
+    sessionId: SessionId;
+    /** Start replaying after this sequence number (default: 0, meaning from beginning) */
+    afterSequence?: number;
+    /** Optional EventEmitter for same-process fast-path */
+    emitter?: EventEmitter;
+    /** Polling interval when no emitter is available (default: 100ms) */
+    pollIntervalMs?: number;
+    /** Heartbeat interval in ms (default: 15000) */
+    heartbeatIntervalMs?: number;
+    /** AbortSignal for cancellation */
+    signal?: AbortSignal;
+}
+/**
+ * Subscribe to a session's stream events.
+ * Returns an AsyncGenerator that yields StreamEvents in order.
+ *
+ * Phase 1 (catch-up): Reads all events from storage after `afterSequence`.
+ * Phase 2 (real-time): Listens to EventEmitter if available, else polls storage.
+ * Terminates on terminal events or abort signal.
+ */
+declare function streamEventRelay(options: StreamEventRelayOptions): AsyncGenerator<StreamEvent, void, unknown>;
+
 /**
  * Lifecycle hooks for session events
  */
@@ -6416,6 +6724,16 @@ interface HarnessServerConfig {
      * Lifecycle hooks for session events (e.g., workspace management)
      */
     hooks?: HarnessServerHooks$1;
+    /**
+     * Sandbox pool configuration.
+     * If provided, the pool is initialized during server startup and shut down on close.
+     */
+    sandbox?: {
+        /** Pool configuration */
+        pool?: SandboxPoolConfig;
+        /** Auto-initialize pool on server startup (default: true if pool config provided) */
+        autoInitPool?: boolean;
+    };
     /**
      * Queue processor configuration
      */
@@ -6482,11 +6800,11 @@ declare function createHarnessServer(config: HarnessServerConfig): {
      */
     getStoredAgents(): Promise<StoredAgent[]>;
     /**
-     * Initialize storage, agents, and start queue processor
+     * Initialize storage, agents, start queue processor, and optionally init sandbox pool
      */
     initialize(): Promise<void>;
     /**
-     * Close storage, agents, and stop queue processor
+     * Close storage, agents, stop queue processor, and shutdown sandbox pool
      */
     close(): Promise<void>;
 };
@@ -6547,6 +6865,16 @@ interface OpenAPIServerConfig {
      * Lifecycle hooks for session events (e.g., workspace management)
      */
     hooks?: HarnessServerHooks;
+    /**
+     * Sandbox pool configuration.
+     * If provided, the pool is initialized during server startup and shut down on close.
+     */
+    sandbox?: {
+        /** Pool configuration */
+        pool?: SandboxPoolConfig;
+        /** Auto-initialize pool on server startup (default: true if pool config provided) */
+        autoInitPool?: boolean;
+    };
     /**
      * API documentation configuration
      */
@@ -6612,11 +6940,11 @@ declare function createOpenAPIServer(config: OpenAPIServerConfig): {
      */
     getStoredAgents(): Promise<StoredAgent[]>;
     /**
-     * Initialize storage and agents
+     * Initialize storage, agents, and optionally init sandbox pool
      */
     initialize(): Promise<void>;
     /**
-     * Close storage and agents
+     * Close storage, agents, and shutdown sandbox pool
      */
     close(): Promise<void>;
     /**
@@ -9923,7 +10251,7 @@ interface PostgresStorageConfig {
 /**
  * PostgreSQL storage implementation using Drizzle ORM
  */
-declare class PostgresStorage implements SessionStorage, TransactionalStorage, AgentStorage {
+declare class PostgresStorage implements SessionStorage, TransactionalStorage, AgentStorage, StreamEventStorage {
     private client;
     private db;
     private initialized;
@@ -9979,6 +10307,16 @@ declare class PostgresStorage implements SessionStorage, TransactionalStorage, A
     deleteAgent(agentId: AgentId): Promise<boolean>;
     listAgents(options?: ListAgentsOptions): Promise<PaginatedResult<StoredAgent>>;
     getActiveAgents(): Promise<StoredAgent[]>;
+    appendEvents(sessionId: SessionId, events: Array<{
+        eventType: string;
+        payload: StreamEvent;
+        batchCount?: number;
+    }>): Promise<StoredStreamEvent[]>;
+    readEvents(sessionId: SessionId, options?: ReadStreamEventsOptions): Promise<StoredStreamEvent[]>;
+    getLatestSequence(sessionId: SessionId): Promise<number>;
+    deleteSessionEvents(sessionId: SessionId): Promise<void>;
+    cleanupOldEvents(maxAgeMs: number): Promise<number>;
+    private rowToStoredStreamEvent;
     /**
      * Get the underlying Drizzle database instance
      * Useful for extensions that need direct database access
@@ -10065,7 +10403,7 @@ interface SupabaseStorageConfig {
  * Supabase storage implementation using Supabase JS client.
  * Uses PostgREST API which avoids direct database connection issues.
  */
-declare class SupabaseStorage implements SessionStorage, TransactionalStorage, AgentStorage, EventStorage {
+declare class SupabaseStorage implements SessionStorage, TransactionalStorage, AgentStorage, EventStorage, StreamEventStorage {
     private client;
     private initialized;
     private tenantId;
@@ -10109,6 +10447,16 @@ declare class SupabaseStorage implements SessionStorage, TransactionalStorage, A
     getSessionEvents(sessionId: SessionId, options?: ListSessionEventsOptions): Promise<PaginatedResult<SessionEvent>>;
     deleteSessionEvents(sessionId: SessionId): Promise<void>;
     getNextEventSequence(sessionId: SessionId): Promise<number>;
+    appendEvents(sessionId: SessionId, events: Array<{
+        eventType: string;
+        payload: StreamEvent;
+        batchCount?: number;
+    }>): Promise<StoredStreamEvent[]>;
+    readEvents(sessionId: SessionId, options?: ReadStreamEventsOptions): Promise<StoredStreamEvent[]>;
+    getLatestSequence(sessionId: SessionId): Promise<number>;
+    deleteStreamEvents(sessionId: SessionId): Promise<void>;
+    cleanupOldEvents(maxAgeMs: number): Promise<number>;
+    private rowToStoredStreamEvent;
 }
 
 /**
@@ -10449,4 +10797,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, 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, 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 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 StreamEvent, StreamEventType, 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 WebFetchAction, type WebSearchAction, type WebhookConfig, type WebhookDeliveryEventData, 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, 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, updateToolCallWithResult, 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, 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 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, 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 };