@ash-cloud/ash-ai 0.1.8 → 0.1.10

package/dist/index.d.cts

@@ -9,7 +9,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, N as NewSessionRow, Q as QueueItemRow, S as SessionRow, s as schema } from './schema-B_CVsJm5.cjs';
+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-B7RbjHWi.cjs';
 import { Writable } from 'stream';
 import 'drizzle-orm';
 import 'drizzle-orm/pg-core';
@@ -1110,6 +1110,7 @@ declare const StreamEventType: {
     readonly SESSION_END: "session_end";
     readonly SESSION_STOPPED: "session_stopped";
     readonly SANDBOX_LOG: "sandbox_log";
+    readonly MCP_STATUS: "mcp_status";
     readonly ERROR: "error";
 };
 type StreamEventType = (typeof StreamEventType)[keyof typeof StreamEventType];
@@ -1175,7 +1176,7 @@ interface ErrorEvent {
 /** Log levels for sandbox logs */
 type SandboxLogLevel$1 = 'info' | 'warn' | 'error' | 'debug';
 /** Categories for sandbox logs */
-type SandboxLogCategory$1 = 'setup' | 'skills' | 'execution' | 'process' | 'startup' | 'backup' | 'restore';
+type SandboxLogCategory$1 = 'setup' | 'skills' | 'execution' | 'process' | 'startup' | 'backup' | 'restore' | 'mcp';
 /** A single sandbox log entry */
 interface SandboxLogEntry$1 {
     timestamp: string;
@@ -1188,7 +1189,17 @@ interface SandboxLogEvent {
     type: 'sandbox_log';
     entry: SandboxLogEntry$1;
 }
-type StreamEvent = SessionStartEvent | TextDeltaEvent | ThinkingDeltaEvent | MessageEvent | ToolUseEvent | ToolResultEvent | TurnCompleteEvent | SessionEndEvent | SessionStoppedEvent | SandboxLogEvent | ErrorEvent;
+/** MCP server connection status */
+interface McpServerStatus {
+    name: string;
+    status: 'connected' | 'failed' | string;
+}
+/** Emitted when MCP servers have been initialized */
+interface McpStatusEvent {
+    type: 'mcp_status';
+    servers: McpServerStatus[];
+}
+type StreamEvent = SessionStartEvent | TextDeltaEvent | ThinkingDeltaEvent | MessageEvent | ToolUseEvent | ToolResultEvent | TurnCompleteEvent | SessionEndEvent | SessionStoppedEvent | SandboxLogEvent | McpStatusEvent | ErrorEvent;
 /**
  * Status of a queued message
  */
@@ -1290,6 +1301,90 @@ interface SessionQueueStatus {
     currentItem?: QueueItem;
     nextItems: QueueItem[];
 }
+/**
+ * Event categories for the timeline view
+ */
+declare const EventCategory: {
+    readonly LIFECYCLE: "lifecycle";
+    readonly CONTENT: "content";
+    readonly TOOL: "tool";
+    readonly SYSTEM: "system";
+    readonly ERROR: "error";
+    readonly FILE: "file";
+    readonly INPUT: "input";
+};
+type EventCategory = (typeof EventCategory)[keyof typeof EventCategory];
+/**
+ * File sync operation types
+ */
+type FileSyncOperation = 'push' | 'pull' | 'sync_to_sandbox' | 'sync_from_sandbox' | 'delete';
+/**
+ * Direction of file sync
+ */
+type FileSyncDirection = 'to_s3' | 'from_s3' | 'to_sandbox' | 'from_sandbox';
+/**
+ * Source of the file sync operation
+ */
+type FileSyncSource = 'external' | 'internal';
+/**
+ * Event data for file sync operations
+ */
+interface FileSyncEventData {
+    operation: FileSyncOperation;
+    direction: FileSyncDirection;
+    source: FileSyncSource;
+    filePath: string;
+    fileSize?: number;
+    success: boolean;
+    error?: string;
+    diff?: string;
+    isTextFile?: boolean;
+    previousSize?: number;
+}
+/**
+ * A single event in the session timeline
+ */
+interface SessionEvent {
+    id: string;
+    sessionId: SessionId;
+    eventType: string;
+    category: EventCategory;
+    startedAt: Date;
+    endedAt?: Date;
+    durationMs?: number;
+    eventData?: Record<string, unknown>;
+    toolUseId?: string;
+    toolName?: string;
+    isAggregated?: boolean;
+    aggregatedCount?: number;
+    sequenceNumber: number;
+    createdAt: Date;
+}
+/**
+ * Options for creating a session event
+ */
+interface CreateSessionEventOptions {
+    eventType: string;
+    category: EventCategory;
+    startedAt: Date;
+    endedAt?: Date;
+    durationMs?: number;
+    eventData?: Record<string, unknown>;
+    toolUseId?: string;
+    toolName?: string;
+    isAggregated?: boolean;
+    aggregatedCount?: number;
+    sequenceNumber: number;
+}
+/**
+ * Options for listing session events
+ */
+interface ListSessionEventsOptions extends PaginationOptions {
+    category?: EventCategory;
+    eventType?: string;
+    /** Filter events involving this file path (matches file events and Read/Write/Edit tool calls) */
+    filePath?: string;
+}
 
 /**
  * Base Error Types for Agent SDK Harness
@@ -1551,6 +1646,31 @@ interface QueueStorage {
      */
     cleanupOldItems(maxAgeMs: number): Promise<number>;
 }
+/**
+ * Storage interface for session events (timeline data).
+ * Events are collected during agent execution and stored for visualization.
+ */
+interface EventStorage {
+    initialize(): Promise<void>;
+    close(): Promise<void>;
+    /**
+     * Save multiple events for a session (batch insert)
+     */
+    saveEvents(sessionId: SessionId, events: CreateSessionEventOptions[]): Promise<SessionEvent[]>;
+    /**
+     * Get events for a session with optional filtering
+     */
+    getSessionEvents(sessionId: SessionId, options?: ListSessionEventsOptions): Promise<PaginatedResult<SessionEvent>>;
+    /**
+     * Delete all events for a session
+     */
+    deleteSessionEvents(sessionId: SessionId): Promise<void>;
+    /**
+     * Get the next sequence number for a session
+     * This is used when creating events outside the normal agent execution flow
+     */
+    getNextEventSequence(sessionId: SessionId): Promise<number>;
+}
 
 /**
  * Credential Management
@@ -4365,6 +4485,355 @@ declare function createMinioFileStore(config: {
     prefix?: string;
 }): S3FileStore;
 
+/**
+ * Sandbox File Watcher
+ *
+ * Watches sandbox directories for file changes and emits events.
+ * Supports debouncing to handle rapid file changes and auto-sync to S3.
+ *
+ * Usage:
+ * - startWatching(): Begin watching a sandbox directory
+ * - stopWatching(): Stop watching and cleanup
+ * - onFileChange(): Subscribe to file change events
+ */
+/**
+ * Types of file change events
+ */
+type FileChangeType = 'add' | 'change' | 'unlink' | 'addDir' | 'unlinkDir';
+/**
+ * Event emitted when a file changes in the watched directory
+ */
+interface FileChangeEvent {
+    /** Type of change */
+    type: FileChangeType;
+    /** Relative path from the watched directory */
+    relativePath: string;
+    /** Absolute path to the file */
+    absolutePath: string;
+    /** Session ID this watch is associated with */
+    sessionId: string;
+    /** File size (only for add/change events) */
+    fileSize?: number;
+    /** Timestamp of the change */
+    timestamp: Date;
+}
+/**
+ * Callback for file change events
+ */
+type FileChangeCallback = (event: FileChangeEvent) => void | Promise<void>;
+/**
+ * Options for configuring the file watcher
+ */
+interface FileWatcherOptions {
+    /** Session ID to associate with watched files */
+    sessionId: string;
+    /** Directory to watch */
+    watchPath: string;
+    /**
+     * Debounce delay in milliseconds.
+     * Changes to the same file within this window are coalesced.
+     * Default: 300ms
+     */
+    debounceMs?: number;
+    /**
+     * Glob patterns to watch (relative to watchPath).
+     * Default: ['**\/*'] (all files)
+     */
+    patterns?: string[];
+    /**
+     * Glob patterns to ignore.
+     * Default: ['node_modules/**', '.git/**', '*.log']
+     */
+    ignored?: string[];
+    /**
+     * Whether to emit events for the initial scan.
+     * Default: false
+     */
+    emitInitialEvents?: boolean;
+    /**
+     * Whether to follow symlinks.
+     * Default: false
+     */
+    followSymlinks?: boolean;
+    /**
+     * Use polling instead of native file system events.
+     * Useful for network filesystems or containers.
+     * Default: false
+     */
+    usePolling?: boolean;
+    /**
+     * Polling interval in milliseconds (only used if usePolling is true).
+     * Default: 100ms
+     */
+    pollInterval?: number;
+    /**
+     * Callback for file change events.
+     * Called after debouncing is applied.
+     */
+    onFileChange?: FileChangeCallback;
+    /**
+     * Callback for errors during watching.
+     */
+    onError?: (error: Error) => void;
+    /**
+     * Callback when watcher is ready (initial scan complete).
+     */
+    onReady?: () => void;
+}
+/**
+ * Status of a file watcher
+ */
+interface FileWatcherStatus {
+    sessionId: string;
+    watchPath: string;
+    isWatching: boolean;
+    watchedFileCount: number;
+    pendingEventCount: number;
+    startedAt?: Date;
+}
+/**
+ * Sandbox File Watcher
+ *
+ * Watches a sandbox directory for file changes and emits debounced events.
+ * Designed to be used with SandboxFileSync for auto-syncing to S3.
+ */
+declare class SandboxFileWatcher {
+    private readonly sessionId;
+    private readonly watchPath;
+    private readonly debounceMs;
+    private readonly patterns;
+    private readonly ignored;
+    private readonly emitInitialEvents;
+    private readonly followSymlinks;
+    private readonly usePolling;
+    private readonly pollInterval;
+    private watcher;
+    private pendingEvents;
+    private subscribers;
+    private isWatching;
+    private startedAt?;
+    private watchedFileCount;
+    private onError?;
+    private onReady?;
+    constructor(options: FileWatcherOptions);
+    /**
+     * Start watching the directory for changes
+     */
+    start(): Promise<void>;
+    /**
+     * Stop watching and cleanup resources
+     */
+    stop(): Promise<void>;
+    /**
+     * Subscribe to file change events
+     * @returns Unsubscribe function
+     */
+    subscribe(callback: FileChangeCallback): () => void;
+    /**
+     * Remove a subscriber
+     */
+    unsubscribe(callback: FileChangeCallback): void;
+    /**
+     * Get the current status of the watcher
+     */
+    getStatus(): FileWatcherStatus;
+    /**
+     * Check if the watcher is currently active
+     */
+    isActive(): boolean;
+    /**
+     * Handle a file system event with debouncing
+     */
+    private handleFileEvent;
+    /**
+     * Emit a file change event to all subscribers
+     */
+    private emitEvent;
+}
+/**
+ * Create a new file watcher instance
+ */
+declare function createFileWatcher(options: FileWatcherOptions): SandboxFileWatcher;
+/**
+ * Manager for multiple file watchers (one per session)
+ */
+declare class FileWatcherManager {
+    private watchers;
+    /**
+     * Start watching a session's sandbox directory
+     */
+    startWatching(options: FileWatcherOptions): Promise<SandboxFileWatcher>;
+    /**
+     * Stop watching a session's sandbox directory
+     */
+    stopWatching(sessionId: string): Promise<void>;
+    /**
+     * Get a watcher for a session
+     */
+    getWatcher(sessionId: string): SandboxFileWatcher | undefined;
+    /**
+     * Check if a session is being watched
+     */
+    isWatching(sessionId: string): boolean;
+    /**
+     * Get status of all watchers
+     */
+    getAllStatuses(): FileWatcherStatus[];
+    /**
+     * Stop all watchers and cleanup
+     */
+    stopAll(): Promise<void>;
+}
+/**
+ * Get or create the global file watcher manager
+ */
+declare function getFileWatcherManager(): FileWatcherManager;
+/**
+ * Create a new file watcher manager (for isolated usage)
+ */
+declare function createFileWatcherManager(): FileWatcherManager;
+
+/**
+ * Options for the remote sandbox file watcher
+ */
+interface RemoteFileWatcherOptions {
+    /** Session ID to watch */
+    sessionId: string;
+    /** Sandbox file operations interface */
+    sandboxOps: SandboxFileOperations;
+    /** Base path in sandbox to watch */
+    basePath: string;
+    /**
+     * Polling interval in milliseconds.
+     * How often to check for file changes.
+     * Default: 2000ms (2 seconds)
+     */
+    pollIntervalMs?: number;
+    /**
+     * Patterns to ignore (simple glob-like matching)
+     * Default: ['node_modules/**', '.git/**']
+     */
+    ignored?: string[];
+    /**
+     * Callback for file change events
+     */
+    onFileChange?: FileChangeCallback;
+    /**
+     * Callback for errors
+     */
+    onError?: (error: Error) => void;
+}
+/**
+ * Remote Sandbox File Watcher
+ *
+ * Uses polling to detect file changes in remote sandboxes (Vercel, E2B, etc.)
+ * where native file system events aren't available.
+ *
+ * The watcher periodically lists files in the sandbox and compares with
+ * the previous state to detect additions, changes, and deletions.
+ */
+declare class RemoteSandboxFileWatcher {
+    private readonly sessionId;
+    private readonly sandboxOps;
+    private readonly basePath;
+    private readonly pollIntervalMs;
+    private readonly ignored;
+    private pollTimer;
+    private previousFiles;
+    private subscribers;
+    private isWatching;
+    private startedAt?;
+    private lastPollAt?;
+    private pollCount;
+    private onError?;
+    constructor(options: RemoteFileWatcherOptions);
+    /**
+     * Start polling for file changes
+     */
+    start(): Promise<void>;
+    /**
+     * Stop polling and cleanup
+     */
+    stop(): Promise<void>;
+    /**
+     * Subscribe to file change events
+     */
+    subscribe(callback: FileChangeCallback): () => void;
+    /**
+     * Remove a subscriber
+     */
+    unsubscribe(callback: FileChangeCallback): void;
+    /**
+     * Check if watcher is active
+     */
+    isActive(): boolean;
+    /**
+     * Get watcher status
+     */
+    getStatus(): FileWatcherStatus & {
+        lastPollAt?: Date;
+        pollCount: number;
+    };
+    /**
+     * Force an immediate scan (useful for testing or manual refresh)
+     */
+    forceScan(): Promise<void>;
+    /**
+     * Scan the sandbox for file changes
+     */
+    private scan;
+    /**
+     * Check if a path should be ignored
+     */
+    private shouldIgnore;
+    /**
+     * Simple glob matching (supports ** and *)
+     */
+    private matchesGlob;
+    /**
+     * Emit a file change event to all subscribers
+     */
+    private emitEvent;
+}
+/**
+ * Create a remote sandbox file watcher
+ */
+declare function createRemoteFileWatcher(options: RemoteFileWatcherOptions): RemoteSandboxFileWatcher;
+/**
+ * Manager for remote file watchers (one per session)
+ */
+declare class RemoteFileWatcherManager {
+    private watchers;
+    /**
+     * Start watching a session's sandbox
+     */
+    startWatching(options: RemoteFileWatcherOptions): Promise<RemoteSandboxFileWatcher>;
+    /**
+     * Stop watching a session
+     */
+    stopWatching(sessionId: string): Promise<void>;
+    /**
+     * Get a watcher for a session
+     */
+    getWatcher(sessionId: string): RemoteSandboxFileWatcher | undefined;
+    /**
+     * Check if a session is being watched
+     */
+    isWatching(sessionId: string): boolean;
+    /**
+     * Stop all watchers
+     */
+    stopAll(): Promise<void>;
+}
+/**
+ * Get or create the global remote file watcher manager
+ */
+declare function getRemoteFileWatcherManager(): RemoteFileWatcherManager;
+/**
+ * Create a new remote file watcher manager
+ */
+declare function createRemoteFileWatcherManager(): RemoteFileWatcherManager;
+
 /**
  * Sandbox File Sync
  *
@@ -4376,8 +4845,72 @@ declare function createMinioFileStore(config: {
  * - pullFile(): Sandbox → S3
  * - syncToSandbox(): Restore all S3 files when sandbox starts
  * - syncFromSandbox(): Backup sandbox files to S3 before it dies
+ * - startWatching(): Watch sandbox for changes and auto-sync to S3
+ * - stopWatching(): Stop watching
  */
 
+/**
+ * Webhook configuration for file sync notifications
+ */
+interface WebhookConfig {
+    /**
+     * The URL to send webhook notifications to.
+     * Must be HTTPS in production.
+     */
+    url: string;
+    /**
+     * Secret key for signing webhook payloads (HMAC-SHA256).
+     * The signature is sent in the `X-Ash-Signature` header.
+     */
+    secret?: string;
+    /**
+     * Custom headers to include with webhook requests.
+     */
+    headers?: Record<string, string>;
+    /**
+     * Timeout for webhook requests in milliseconds.
+     * Default: 10000 (10 seconds)
+     */
+    timeoutMs?: number;
+    /**
+     * Number of retry attempts for failed webhooks.
+     * Default: 3
+     */
+    retries?: number;
+    /**
+     * Whether to send webhooks asynchronously (fire and forget).
+     * If true, webhook failures won't block file operations.
+     * Default: true
+     */
+    async?: boolean;
+    /**
+     * Filter which events trigger webhooks.
+     * Default: all events
+     */
+    events?: Array<'push' | 'pull' | 'sync_to_sandbox' | 'sync_from_sandbox' | 'delete' | 'file_change'>;
+    /**
+     * Custom metadata to include with every webhook payload.
+     * Useful for including project IDs, tenant IDs, or other context.
+     */
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Payload sent to webhook endpoints
+ */
+interface WebhookPayload {
+    /** Event type */
+    event: 'file_sync' | 'file_change';
+    /** Timestamp of the event */
+    timestamp: string;
+    /** Session ID */
+    sessionId: string;
+    /** Custom metadata from webhook config */
+    metadata?: Record<string, unknown>;
+    /** File sync event data (for file_sync events) */
+    fileSyncEvent?: FileSyncEvent;
+    /** File change event data (for file_change events from watchers) */
+    fileChangeEvent?: FileChangeEvent;
+}
 /**
  * Result of writing a file to a sandbox
  */
@@ -4432,6 +4965,49 @@ interface SyncResult {
         error: string;
     }>;
 }
+/**
+ * Event emitted during file sync operations
+ */
+interface FileSyncEvent {
+    operation: 'push' | 'pull' | 'sync_to_sandbox' | 'sync_from_sandbox' | 'delete';
+    direction: 'to_s3' | 'from_s3' | 'to_sandbox' | 'from_sandbox';
+    filePath: string;
+    fileSize?: number;
+    success: boolean;
+    error?: string;
+    previousContent?: Buffer;
+    newContent?: Buffer;
+}
+/**
+ * Options for file watching
+ */
+interface FileWatchOptions {
+    /**
+     * Polling interval for remote sandboxes in milliseconds.
+     * Default: 2000ms
+     */
+    pollIntervalMs?: number;
+    /**
+     * Debounce delay for local file changes in milliseconds.
+     * Default: 300ms
+     */
+    debounceMs?: number;
+    /**
+     * Patterns to ignore when watching.
+     * Default: node_modules and .git directories
+     */
+    ignored?: string[];
+    /**
+     * Whether to use local file watching (chokidar) instead of polling.
+     * Only works when the sandbox is on the local filesystem.
+     * Default: false (use polling for remote sandbox compatibility)
+     */
+    useLocalWatcher?: boolean;
+    /**
+     * Local path to watch (required if useLocalWatcher is true)
+     */
+    localPath?: string;
+}
 /**
  * Options for creating a SandboxFileSync instance
  */
@@ -4440,6 +5016,20 @@ interface SandboxFileSyncOptions {
     fileStore: FileStore;
     /** Base path in sandbox for synced files (default: .claude/files) */
     sandboxBasePath?: string;
+    /** Callback for file sync events (for event tracking) */
+    onFileEvent?: (event: FileSyncEvent) => void;
+    /** Default options for file watching */
+    watchOptions?: FileWatchOptions;
+    /**
+     * Optional event storage for persisting file events to the session timeline.
+     * When provided, all file sync events will be automatically saved.
+     */
+    eventStorage?: EventStorage;
+    /**
+     * Webhook configuration for sending file event notifications to external services.
+     * Use this to notify your application when files change in sandboxes.
+     */
+    webhook?: WebhookConfig;
 }
 /**
  * Interface for sandbox file operations
@@ -4471,12 +5061,66 @@ interface SandboxFileOperations {
  * Sandbox File Sync service
  *
  * Handles bidirectional file synchronization between S3 and sandboxes.
+ * Supports automatic file watching with auto-sync to S3.
  */
 declare class SandboxFileSync {
     private readonly fileStore;
     private readonly sandboxBasePath;
+    private readonly defaultWatchOptions;
     private sandboxOps;
+    private onFileEvent?;
+    private eventStorage?;
+    private webhookConfig?;
+    private remoteWatchers;
+    private localWatchers;
+    private fileChangeSubscribers;
+    private sequenceNumbers;
     constructor(options: SandboxFileSyncOptions);
+    /**
+     * Set the file event callback
+     * This can be used to set or update the callback after construction
+     */
+    setFileEventCallback(callback: (event: FileSyncEvent) => void): void;
+    /**
+     * Set the event storage for persisting file events to the timeline
+     * This can be used to set or update the storage after construction
+     */
+    setEventStorage(storage: EventStorage): void;
+    /**
+     * Set webhook configuration for external notifications
+     * This can be used to set or update the webhook after construction
+     */
+    setWebhook(config: WebhookConfig): void;
+    /**
+     * Remove webhook configuration
+     */
+    removeWebhook(): void;
+    /**
+     * Send a webhook notification
+     * @param payload - The webhook payload to send
+     */
+    private sendWebhook;
+    /**
+     * Send a file sync event webhook
+     */
+    private sendFileSyncWebhook;
+    /**
+     * Send a file change event webhook (from watcher)
+     */
+    private sendFileChangeWebhook;
+    /**
+     * Get the next sequence number for a session
+     */
+    private getNextSequenceNumber;
+    /**
+     * Compute a unified diff between two text contents
+     */
+    private computeDiff;
+    /**
+     * Emit a file event if a callback is registered
+     * Also persists to EventStorage if configured
+     */
+    private emitFileEvent;
     /**
      * Set the sandbox operations implementation
      * This is called by the cloud layer after creating the sync service
@@ -4494,8 +5138,9 @@ declare class SandboxFileSync {
      * @param path - File path (stored in S3 and used as relative path in sandbox)
      * @param content - File content
      * @param options - Push options (e.g., targetPath to override sandbox location)
+     * @param previousContent - Optional previous content for diff computation
      */
-    pushFile(sessionId: string, path: string, content: Buffer, options?: PushOptions): Promise<FilePushResult>;
+    pushFile(sessionId: string, path: string, content: Buffer, options?: PushOptions, previousContent?: Buffer): Promise<FilePushResult>;
     /**
      * Push multiple files
      * @param sessionId - Session ID
@@ -4549,6 +5194,59 @@ declare class SandboxFileSync {
      * Get a signed URL for direct file upload
      */
     getUploadUrl(sessionId: string, path: string, expiresIn?: number): Promise<string>;
+    /**
+     * Start watching a sandbox for file changes and auto-sync to S3.
+     *
+     * For remote sandboxes (Vercel, E2B, etc.), uses polling.
+     * For local sandboxes, can optionally use native file watching via chokidar.
+     *
+     * @param sessionId - Session to watch
+     * @param options - Watch options (overrides constructor defaults)
+     */
+    startWatching(sessionId: string, options?: FileWatchOptions): Promise<void>;
+    /**
+     * Stop watching a session's sandbox
+     */
+    stopWatching(sessionId: string): Promise<void>;
+    /**
+     * Check if a session is being watched
+     */
+    isWatching(sessionId: string): boolean;
+    /**
+     * Subscribe to file change events across all watched sessions.
+     * This allows external applications to react to file changes.
+     *
+     * @param callback - Function to call when a file changes
+     * @returns Unsubscribe function
+     *
+     * @example
+     * ```typescript
+     * const unsubscribe = fileSync.onFileChange((event) => {
+     *   console.log(`File ${event.relativePath} was ${event.type}d`);
+     *   // Update your application state here
+     * });
+     *
+     * // Later, when done
+     * unsubscribe();
+     * ```
+     */
+    onFileChange(callback: FileChangeCallback): () => void;
+    /**
+     * Remove a file change subscriber
+     */
+    offFileChange(callback: FileChangeCallback): void;
+    /**
+     * Stop all watchers and cleanup
+     */
+    stopAllWatching(): Promise<void>;
+    /**
+     * Get watching status for all sessions
+     */
+    getWatchingStatus(): Array<{
+        sessionId: string;
+        type: 'remote' | 'local';
+        isActive: boolean;
+    }>;
 }
 /**
  * Create a SandboxFileSync instance
@@ -4981,6 +5679,128 @@ declare function initializeSandboxPool(config?: SandboxPoolConfig): Promise<Sand
  */
 declare function shutdownSandboxPool(): Promise<void>;
 
+/**
+ * In-Sandbox File Watcher
+ *
+ * Runs a file watcher INSIDE the sandbox to detect file changes in real-time.
+ * The watcher script runs as a background process in the sandbox and reports
+ * changes via stdout which we capture and emit as events.
+ *
+ * This is more accurate than polling from outside because:
+ * 1. Detects modifications, not just add/delete
+ * 2. Real-time events (no polling delay)
+ * 3. Catches all changes, even rapid ones
+ */
+
+/**
+ * Options for the in-sandbox file watcher
+ */
+interface InSandboxWatcherOptions {
+    /** Session ID */
+    sessionId: string;
+    /** Path inside the sandbox to watch */
+    watchPath: string;
+    /** Poll interval for reading watcher output (ms). Default: 1000 */
+    outputPollIntervalMs?: number;
+    /** Callback for file change events */
+    onFileChange?: FileChangeCallback;
+    /** Callback for errors */
+    onError?: (error: Error) => void;
+    /** Callback when watcher is ready */
+    onReady?: () => void;
+}
+/**
+ * In-Sandbox File Watcher
+ *
+ * Runs a file watcher process inside the Vercel sandbox.
+ * Uses the existing sandbox command execution infrastructure.
+ */
+declare class InSandboxWatcher {
+    private readonly sessionId;
+    private readonly watchPath;
+    private readonly outputPollIntervalMs;
+    private sandboxState;
+    private outputPollTimer;
+    private subscribers;
+    private isRunning;
+    private startedAt?;
+    private lastHeartbeat?;
+    private lastOutputPosition;
+    private readonly onError?;
+    private readonly onReady?;
+    constructor(options: InSandboxWatcherOptions);
+    /**
+     * Start the watcher process inside the sandbox
+     */
+    start(): Promise<void>;
+    /**
+     * Poll the output file for new events
+     */
+    private pollOutput;
+    /**
+     * Process output from the watcher script
+     */
+    private processOutput;
+    /**
+     * Stop the watcher process
+     */
+    stop(): Promise<void>;
+    /**
+     * Subscribe to file change events
+     */
+    subscribe(callback: FileChangeCallback): () => void;
+    /**
+     * Check if watcher is running
+     */
+    isActive(): boolean;
+    /**
+     * Get watcher status
+     */
+    getStatus(): {
+        sessionId: string;
+        watchPath: string;
+        isRunning: boolean;
+        startedAt?: Date;
+        lastHeartbeat?: Date;
+    };
+    /**
+     * Emit event to all subscribers
+     */
+    private emitEvent;
+}
+/**
+ * Create an in-sandbox file watcher
+ */
+declare function createInSandboxWatcher(options: InSandboxWatcherOptions): InSandboxWatcher;
+/**
+ * Manager for in-sandbox watchers (one per session)
+ */
+declare class InSandboxWatcherManager {
+    private watchers;
+    /**
+     * Start watching a sandbox
+     */
+    startWatching(options: InSandboxWatcherOptions): Promise<InSandboxWatcher>;
+    /**
+     * Stop watching a session
+     */
+    stopWatching(sessionId: string): Promise<void>;
+    /**
+     * Get watcher for a session
+     */
+    getWatcher(sessionId: string): InSandboxWatcher | undefined;
+    /**
+     * Check if watching
+     */
+    isWatching(sessionId: string): boolean;
+    /**
+     * Stop all watchers
+     */
+    stopAll(): Promise<void>;
+}
+declare function getInSandboxWatcherManager(): InSandboxWatcherManager;
+declare function createInSandboxWatcherManager(): InSandboxWatcherManager;
+
 /**
  * Agent Runtime & Sandboxing Configuration
  *
@@ -9208,7 +10028,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 {
+declare class SupabaseStorage implements SessionStorage, TransactionalStorage, AgentStorage, EventStorage {
     private client;
     private initialized;
     private tenantId;
@@ -9247,6 +10067,11 @@ declare class SupabaseStorage implements SessionStorage, TransactionalStorage, A
     private rowToMessage;
     private rowToAttachment;
     private rowToAgent;
+    private rowToSessionEvent;
+    saveEvents(sessionId: SessionId, events: CreateSessionEventOptions[]): Promise<SessionEvent[]>;
+    getSessionEvents(sessionId: SessionId, options?: ListSessionEventsOptions): Promise<PaginatedResult<SessionEvent>>;
+    deleteSessionEvents(sessionId: SessionId): Promise<void>;
+    getNextEventSequence(sessionId: SessionId): Promise<number>;
 }
 
 /**
@@ -9587,4 +10412,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 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, type EventMiddleware, type FileContent$1 as FileContent, type FileEditAction, type FileEntry, type FileMetadata, type FileProvider, type FileProviderOptions, type FilePullResult, type FilePushResult, type FileReadAction, type FileStore, 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, type ListAgentsOptions, type ListMessagesOptions, type ListQueueItemsOptions, 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, McpServers, 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 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 SandboxConfig, type SandboxConnection, type SandboxFileOperations, SandboxFileSync, type SandboxFileSyncOptions, 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 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, 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, createGCSBundleStore, createGeminiExecutor, createGitHubFileProvider, createGitRepo, createHarnessServer, 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, extractTextContent, extractTextFromMessage, fileEntrySchema, formatToolName, generateDockerCommand, generateMcpServerPackage, generateMcpServers, generateProxyEnv, generateToolSummary, getActionIcon, getActionLabel, getAllHeartbeatStatuses, getApiKeyEnvVar, getDefaultModel, getHeartbeatStatus, 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 FileSyncDirection, 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 QueueItem, QueueItemStatus, QueueProcessor, type QueueProcessorCallbacks, type QueueProcessorConfig, type QueueRouterOptions, type QueueStats, type QueueStorage, type RateLimitConfig, type RateLimitResult, type RateLimitStore, RemoteFileWatcherManager, type RemoteFileWatcherOptions, RemoteSandboxFileWatcher, type RequestLoggerOptions, type ResumeSessionOptions, type RuntimeConfig, RuntimeConfigBuilder, RuntimePresets, S3BundleStore, type S3BundleStoreConfig, S3FileStore, type S3FileStoreConfig, SENSITIVE_PATHS, 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 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, createRemoteFileWatcher, createRemoteFileWatcherManager, 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, extractTextContent, extractTextFromMessage, fileEntrySchema, formatToolName, generateDockerCommand, generateMcpServerPackage, generateMcpServers, generateProxyEnv, generateToolSummary, getActionIcon, getActionLabel, getAllHeartbeatStatuses, getApiKeyEnvVar, getDefaultModel, getFileWatcherManager, getHeartbeatStatus, getInSandboxWatcherManager, getOrCreateSandbox, getRemoteFileWatcherManager, 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 };