@ash-cloud/ash-ai 0.1.16 → 0.1.17

package/dist/index.d.ts

@@ -1,4 +1,5 @@
 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';
@@ -9,7 +10,7 @@ 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.js';
+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-dr_7pxIB.js';
 import { Writable } from 'stream';
 import 'drizzle-orm';
 import 'drizzle-orm/pg-core';
@@ -1426,6 +1427,36 @@ interface ListSessionEventsOptions extends PaginationOptions {
     /** 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 +1743,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 +2549,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 +2632,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 +2687,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 +2864,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
  *
@@ -4811,6 +4918,22 @@ interface WebhookConfig {
      */
     metadata?: Record<string, unknown>;
 }
+/**
+ * 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,7 +4947,7 @@ 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;
 }
@@ -5092,7 +5215,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;
     /**
@@ -6356,6 +6481,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
  */
@@ -9923,7 +10108,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 +10164,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 +10260,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 +10304,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 +10654,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, 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 WebFetchAction, type WebSearchAction, 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, writeFileToSandbox };