@axiom-lattice/core 2.1.50 → 2.1.52

package/dist/index.d.mts

@@ -14,16 +14,16 @@ export { AgentConfig, AgentType, GraphBuildOptions, MemoryType } from '@axiom-la
 import * as langchain from 'langchain';
 import { ReactAgent, AgentMiddleware } from 'langchain';
 import z, { z as z$1 } from 'zod';
+import { BaseStore, BaseCheckpointSaver } from '@langchain/langgraph-checkpoint';
 import * as _langchain_core_tools from '@langchain/core/tools';
 import { StructuredTool } from '@langchain/core/tools';
 import * as _langchain_langgraph from '@langchain/langgraph';
 import { CompiledStateGraph, CommandParams } from '@langchain/langgraph';
-import { BaseCheckpointSaver, BaseStore } from '@langchain/langgraph-checkpoint';
 import { ReplaySubject } from 'rxjs';
 import { Embeddings } from '@langchain/core/embeddings';
 import { VectorStore } from '@langchain/core/vectorstores';
 import { Connection, MultiServerMCPClient } from '@langchain/mcp-adapters';
-import { Sandbox } from 'microsandbox';
+import { FsEntry, Sandbox } from 'microsandbox';
 import { SandboxClient } from '@agent-infra/sandbox';
 import { Sandbox as Sandbox$1 } from 'e2b';
 import { Sandbox as Sandbox$2 } from '@daytonaio/sdk';
@@ -1265,6 +1265,213 @@ declare const createExecuteSqlQueryTool: ({ serverKeys, serverDescriptions, getT
     datasourceId?: string | undefined;
 }, string, "execute_sql_query">;
 
+/**
+ * Protocol definition for pluggable memory backends.
+ *
+ * This module defines the BackendProtocol that all backend implementations
+ * must follow. Backends can store files in different locations (state, filesystem,
+ * database, etc.) and provide a uniform interface for file operations.
+ */
+
+type MaybePromise<T> = T | Promise<T>;
+/**
+ * Structured file listing info.
+ *
+ * Minimal contract used across backends. Only "path" is required.
+ * Other fields are best-effort and may be absent depending on backend.
+ */
+interface FileInfo {
+    /** File path */
+    path: string;
+    /** Whether this is a directory */
+    is_dir?: boolean;
+    /** File size in bytes (approximate) */
+    size?: number;
+    /** ISO 8601 timestamp of last modification */
+    modified_at?: string;
+}
+/**
+ * Structured grep match entry.
+ */
+interface GrepMatch {
+    /** File path where match was found */
+    path: string;
+    /** Line number (1-indexed) */
+    line: number;
+    /** The matching line text */
+    text: string;
+}
+/**
+ * File data structure used by backends.
+ *
+ * All file data is represented as objects with this structure:
+ */
+interface FileData {
+    /** Lines of text content */
+    content: string[];
+    /** ISO format timestamp of creation */
+    created_at: string;
+    /** ISO format timestamp of last modification */
+    modified_at: string;
+}
+/**
+ * Result from backend write operations.
+ *
+ * Checkpoint backends populate filesUpdate with {file_path: file_data} for LangGraph state.
+ * External backends set filesUpdate to null (already persisted to disk/S3/database/etc).
+ */
+interface WriteResult {
+    /** Error message on failure, undefined on success */
+    error?: string;
+    /** File path of written file, undefined on failure */
+    path?: string;
+    /**
+     * State update dict for checkpoint backends, null for external storage.
+     * Checkpoint backends populate this with {file_path: file_data} for LangGraph state.
+     * External backends set null (already persisted to disk/S3/database/etc).
+     */
+    filesUpdate?: Record<string, FileData> | null;
+    /** Metadata for the write operation, attached to the ToolMessage */
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Result from backend edit operations.
+ *
+ * Checkpoint backends populate filesUpdate with {file_path: file_data} for LangGraph state.
+ * External backends set filesUpdate to null (already persisted to disk/S3/database/etc).
+ */
+interface EditResult {
+    /** Error message on failure, undefined on success */
+    error?: string;
+    /** File path of edited file, undefined on failure */
+    path?: string;
+    /**
+     * State update dict for checkpoint backends, null for external storage.
+     * Checkpoint backends populate this with {file_path: file_data} for LangGraph state.
+     * External backends set null (already persisted to disk/S3/database/etc).
+     */
+    filesUpdate?: Record<string, FileData> | null;
+    /** Number of replacements made, undefined on failure */
+    occurrences?: number;
+    /** Metadata for the edit operation, attached to the ToolMessage */
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Protocol for pluggable memory backends (single, unified).
+ *
+ * Backends can store files in different locations (state, filesystem, database, etc.)
+ * and provide a uniform interface for file operations.
+ *
+ * All file data is represented as objects with the FileData structure.
+ *
+ * Methods can return either direct values or Promises, allowing both
+ * synchronous and asynchronous implementations.
+ */
+interface BackendProtocol {
+    /**
+     * Structured listing with file metadata.
+     *
+     * Lists files and directories in the specified directory (non-recursive).
+     * Directories have a trailing / in their path and is_dir=true.
+     *
+     * @param path - Absolute path to directory
+     * @returns List of FileInfo objects for files and directories directly in the directory
+     */
+    lsInfo(path: string): MaybePromise<FileInfo[]>;
+    /**
+     * Read file content with line numbers or an error string.
+     *
+     * @param filePath - Absolute file path
+     * @param offset - Line offset to start reading from (0-indexed), default 0
+     * @param limit - Maximum number of lines to read, default 2000
+     * @returns Formatted file content with line numbers, or error message
+     */
+    read(filePath: string, offset?: number, limit?: number): MaybePromise<string>;
+    /**
+     * Read file content as raw FileData.
+     *
+     * @param filePath - Absolute file path
+     * @returns Raw file content as FileData
+     */
+    readRaw(filePath: string): MaybePromise<FileData>;
+    /**
+     * Structured search results or error string for invalid input.
+     *
+     * Searches file contents for a regex pattern.
+     *
+     * @param pattern - Regex pattern to search for
+     * @param path - Base path to search from (default: null)
+     * @param glob - Optional glob pattern to filter files (e.g., "*.py")
+     * @returns List of GrepMatch objects or error string for invalid regex
+     */
+    grepRaw(pattern: string, path?: string | null, glob?: string | null): MaybePromise<GrepMatch[] | string>;
+    /**
+     * Structured glob matching returning FileInfo objects.
+     *
+     * @param pattern - Glob pattern (e.g., `*.py`, `**\/*.ts`)
+     * @param path - Base path to search from (default: "/")
+     * @returns List of FileInfo objects matching the pattern
+     */
+    globInfo(pattern: string, path?: string): MaybePromise<FileInfo[]>;
+    /**
+     * Create a new file.
+     *
+     * @param filePath - Absolute file path
+     * @param content - File content as string
+     * @returns WriteResult with error populated on failure
+     */
+    write(filePath: string, content: string): MaybePromise<WriteResult>;
+    /**
+     * Edit a file by replacing string occurrences.
+     *
+     * @param filePath - Absolute file path
+     * @param oldString - String to find and replace
+     * @param newString - Replacement string
+     * @param replaceAll - If true, replace all occurrences (default: false)
+     * @returns EditResult with error, path, filesUpdate, and occurrences
+     */
+    edit(filePath: string, oldString: string, newString: string, replaceAll?: boolean): MaybePromise<EditResult>;
+}
+/**
+ * State and store container for backend initialization.
+ *
+ * This provides a clean interface for what backends need to access:
+ * - state: Current agent state (with files, messages, etc.)
+ * - store: Optional persistent store for cross-conversation data
+ *
+ * Different contexts build this differently:
+ * - Tools: Extract state via getCurrentTaskInput(config)
+ * - Middleware: Use request.state directly
+ */
+interface StateAndStore {
+    /** Current agent state with files, messages, etc. */
+    state: unknown;
+    /** Optional BaseStore for persistent cross-conversation storage */
+    store?: BaseStore;
+    /** Optional assistant ID for per-assistant isolation in store */
+    assistantId?: string;
+    assistant_id?: string;
+    threadId?: string;
+    tenantId?: string;
+    workspaceId?: string;
+    projectId?: string;
+}
+/**
+ * Factory function type for creating backend instances.
+ *
+ * Backends receive StateAndStore which contains the current state
+ * and optional store, extracted from the execution context.
+ *
+ * @example
+ * ```typescript
+ * // Using in middleware
+ * const middleware = createFilesystemMiddleware({
+ *   backend: (stateAndStore) => new StateBackend(stateAndStore)
+ * });
+ * ```
+ */
+type BackendFactory = (stateAndStore: StateAndStore) => Promise<BackendProtocol>;
+
 interface SandboxFileInfo {
     path: string;
     is_dir: boolean;
@@ -1356,6 +1563,7 @@ interface SandboxManagerProtocol {
     stopSandbox(name: string): Promise<void>;
     deleteSandbox(name: string): Promise<void>;
     listSandboxes(): Promise<SandboxInstance[]>;
+    getVolumeBackend(config: RunSandboxConfig): Promise<BackendProtocol | null>;
 }
 
 type ToolDefinition = ToolConfig;
@@ -3514,12 +3722,21 @@ declare class McpLatticeManager extends BaseLatticeManager<McpLatticeInterface>
 }
 declare const mcpManager: McpLatticeManager;
 
+interface VolumeFsClient {
+    read(path: string): Promise<string>;
+    write(path: string, content: string): Promise<void>;
+    list(path: string): Promise<FsEntry[]>;
+    readRaw(path: string): Promise<Buffer>;
+    writeRaw(path: string, data: Buffer): Promise<void>;
+}
+
 interface SandboxProvider {
     createSandbox(name: string, config?: RunSandboxConfig): Promise<SandboxInstance>;
     getSandbox(name: string): Promise<SandboxInstance>;
     stopSandbox(name: string): Promise<void>;
     deleteSandbox(name: string): Promise<void>;
     listSandboxes(): Promise<SandboxInstance[]>;
+    createVolumeFsClient?(volumeName: string): VolumeFsClient;
 }
 
 interface MicrosandboxProviderConfig {
@@ -3534,7 +3751,7 @@ declare class MicrosandboxProvider implements SandboxProvider {
     private instances;
     private creating;
     constructor(config?: MicrosandboxProviderConfig);
-    createSandbox(name: string): Promise<SandboxInstance>;
+    createSandbox(name: string, config?: RunSandboxConfig): Promise<SandboxInstance>;
     getSandbox(name: string): Promise<SandboxInstance>;
     stopSandbox(name: string): Promise<void>;
     deleteSandbox(name: string): Promise<void>;
@@ -3580,6 +3797,15 @@ type ExecCommandResponse = {
     stderr: string;
     exitCode: number;
 };
+type VolumeFsListResponse = {
+    entries: Array<{
+        path: string;
+        kind: string;
+        size: number;
+        mode: number;
+        modified: string | null;
+    }>;
+};
 interface EnsureMicrosandboxInput {
     image?: string;
     cpus?: number;
@@ -3595,9 +3821,11 @@ interface MicrosandboxShellExecInput {
 }
 interface MicrosandboxServiceClientConfig {
     baseURL: string;
+    apiKey?: string;
 }
 declare class MicrosandboxServiceClient {
     private readonly baseURL;
+    private readonly apiKey?;
     constructor(config: MicrosandboxServiceClientConfig);
     ensureSandbox(name: string, input: EnsureMicrosandboxInput): Promise<SandboxLifecycleResponse>;
     startSandbox(name: string): Promise<SandboxLifecycleResponse>;
@@ -3618,11 +3846,17 @@ declare class MicrosandboxServiceClient {
     uploadFile(sandboxName: string, path: string, content: Buffer): Promise<WriteFileResponse>;
     downloadFile(sandboxName: string, path: string): Promise<DownloadFileResponse>;
     execCommand(input: MicrosandboxShellExecInput): Promise<ExecCommandResponse>;
+    volumeFsRead(volumeName: string, path: string): Promise<string>;
+    volumeFsWrite(volumeName: string, path: string, content: string): Promise<void>;
+    volumeFsList(volumeName: string, path: string): Promise<VolumeFsListResponse["entries"]>;
+    volumeFsDownload(volumeName: string, path: string): Promise<Buffer>;
+    volumeFsUpload(volumeName: string, path: string, data: Buffer): Promise<void>;
     private request;
 }
 
+type MicrosandboxRemoteProviderClient = Pick<MicrosandboxServiceClient, "ensureSandbox" | "startSandbox" | "stopSandbox" | "killSandbox" | "deleteSandbox" | "getStatus" | "readFile" | "writeFile" | "listPath" | "findFiles" | "searchInFile" | "replaceInFile" | "uploadFile" | "downloadFile" | "execCommand" | "volumeFsRead" | "volumeFsWrite" | "volumeFsList" | "volumeFsDownload" | "volumeFsUpload">;
 interface MicrosandboxRemoteProviderConfig extends MicrosandboxServiceClientConfig {
-    client?: Pick<MicrosandboxServiceClient, "ensureSandbox"> & Partial<MicrosandboxServiceClient>;
+    client?: MicrosandboxRemoteProviderClient;
     image?: string;
     cpus?: number;
     memoryMib?: number;
@@ -3638,6 +3872,7 @@ declare class MicrosandboxRemoteProvider implements SandboxProvider {
     getSandbox(name: string): Promise<SandboxInstance>;
     stopSandbox(name: string): Promise<void>;
     deleteSandbox(name: string): Promise<void>;
+    createVolumeFsClient(volumeName: string): VolumeFsClient;
     listSandboxes(): Promise<SandboxInstance[]>;
     private buildEnsureInput;
     private buildDefaultVolumes;
@@ -3828,15 +4063,6 @@ declare class DaytonaInstance implements SandboxInstance {
     private native;
     readonly name: string;
     constructor(name: string, native: Sandbox$2);
-    /**
-     * All sandbox file operations live under the user's home directory (~).
-     * The AI uses virtual paths like "~/agent/file.txt". Daytona SDK expects
-     * relative paths for file operations (they are resolved against ~ automatically),
-     * so we strip the leading "~/" or "/" here.
-     *
-     * Handles edge cases like "~/~/agent/file.txt" by repeatedly stripping prefixes.
-     */
-    private toSandboxHomePath;
     start(): Promise<void>;
     stop(): Promise<void>;
     kill(): Promise<void>;
@@ -3868,6 +4094,7 @@ declare class SandboxLatticeManager extends BaseLatticeManager<SandboxProvider>
         vmIsolation: SandboxIsolationLevel;
     };
     getSandboxFromConfig(config: RunSandboxConfig): Promise<SandboxInstance>;
+    getVolumeBackend(config: RunSandboxConfig): Promise<BackendProtocol | null>;
     createSandbox(name: string, config?: RunSandboxConfig): Promise<SandboxInstance>;
     getSandbox(name: string): Promise<SandboxInstance>;
     stopSandbox(name: string): Promise<void>;
@@ -3879,24 +4106,16 @@ declare const sandboxLatticeManager: SandboxLatticeManager;
 declare const getSandBoxManager: (key?: string) => SandboxManagerProtocol;
 
 /**
- * Sandbox name normalization utility
- *
- * Normalizes sandbox names to comply with RFC 1123 subdomain naming requirements:
- * - Only lowercase alphanumeric characters, '-' or '.'
- * - Must start and end with an alphanumeric character
- * - No underscores or other special characters
- */
-/**
- * Normalize a sandbox name to be RFC 1123 compliant
+ * Generate a sandbox name from meaningful identifiers.
  *
- * @param name - The sandbox name to normalize
- * @returns Normalized sandbox name that complies with RFC 1123 subdomain rules
+ * All sandbox names are hashed (like buildNamedVolumeName) producing a
+ * fixed 17-char "n<hash>" format. This avoids Unix domain socket path
+ * length limits (SUN_LEN = 104 on macOS, 108 on Linux) regardless of
+ * how long the input identifiers are.
  *
- * @example
- * normalizeSandboxName("sandbox_agent") // returns "sandbox-agent"
- * normalizeSandboxName("My-Sandbox") // returns "my-sandbox"
- * normalizeSandboxName("test.sandbox") // returns "test.sandbox"
- * normalizeSandboxName("_invalid_") // returns "invalid"
+ * Original identity metadata (tenant, assistant, project, etc.) should
+ * be passed via sandbox env so operational tooling can still map names
+ * back to their source.
  */
 declare function normalizeSandboxName(name: string): string;
 /**
@@ -3906,6 +4125,14 @@ declare function normalizeSandboxName(name: string): string;
  * @returns true if the name is valid, false otherwise
  */
 declare function isValidSandboxName(name: string): boolean;
+/**
+ * Build env vars mapping a hashed sandbox name back to its source metadata.
+ * Injected into every sandbox so operational tooling can correlate
+ * opaque "n<hash>" names to the original tenant/assistant/project/workspace.
+ */
+declare function buildSandboxMetadataEnv(config?: RunSandboxConfig): Record<string, string>;
+
+declare function buildNamedVolumeName(prefix: "s" | "a" | "p", ...parts: Array<string | undefined>): string;
 
 /**
  * Agent Team - Store Protocols
@@ -4475,213 +4702,6 @@ declare class TeamAgentGraphBuilder implements AgentGraphBuilder {
  */
 declare function createAgentTeam(config: TeamConfig): ReactAgent<any, any, any, any>;
 
-/**
- * Protocol definition for pluggable memory backends.
- *
- * This module defines the BackendProtocol that all backend implementations
- * must follow. Backends can store files in different locations (state, filesystem,
- * database, etc.) and provide a uniform interface for file operations.
- */
-
-type MaybePromise<T> = T | Promise<T>;
-/**
- * Structured file listing info.
- *
- * Minimal contract used across backends. Only "path" is required.
- * Other fields are best-effort and may be absent depending on backend.
- */
-interface FileInfo {
-    /** File path */
-    path: string;
-    /** Whether this is a directory */
-    is_dir?: boolean;
-    /** File size in bytes (approximate) */
-    size?: number;
-    /** ISO 8601 timestamp of last modification */
-    modified_at?: string;
-}
-/**
- * Structured grep match entry.
- */
-interface GrepMatch {
-    /** File path where match was found */
-    path: string;
-    /** Line number (1-indexed) */
-    line: number;
-    /** The matching line text */
-    text: string;
-}
-/**
- * File data structure used by backends.
- *
- * All file data is represented as objects with this structure:
- */
-interface FileData {
-    /** Lines of text content */
-    content: string[];
-    /** ISO format timestamp of creation */
-    created_at: string;
-    /** ISO format timestamp of last modification */
-    modified_at: string;
-}
-/**
- * Result from backend write operations.
- *
- * Checkpoint backends populate filesUpdate with {file_path: file_data} for LangGraph state.
- * External backends set filesUpdate to null (already persisted to disk/S3/database/etc).
- */
-interface WriteResult {
-    /** Error message on failure, undefined on success */
-    error?: string;
-    /** File path of written file, undefined on failure */
-    path?: string;
-    /**
-     * State update dict for checkpoint backends, null for external storage.
-     * Checkpoint backends populate this with {file_path: file_data} for LangGraph state.
-     * External backends set null (already persisted to disk/S3/database/etc).
-     */
-    filesUpdate?: Record<string, FileData> | null;
-    /** Metadata for the write operation, attached to the ToolMessage */
-    metadata?: Record<string, unknown>;
-}
-/**
- * Result from backend edit operations.
- *
- * Checkpoint backends populate filesUpdate with {file_path: file_data} for LangGraph state.
- * External backends set filesUpdate to null (already persisted to disk/S3/database/etc).
- */
-interface EditResult {
-    /** Error message on failure, undefined on success */
-    error?: string;
-    /** File path of edited file, undefined on failure */
-    path?: string;
-    /**
-     * State update dict for checkpoint backends, null for external storage.
-     * Checkpoint backends populate this with {file_path: file_data} for LangGraph state.
-     * External backends set null (already persisted to disk/S3/database/etc).
-     */
-    filesUpdate?: Record<string, FileData> | null;
-    /** Number of replacements made, undefined on failure */
-    occurrences?: number;
-    /** Metadata for the edit operation, attached to the ToolMessage */
-    metadata?: Record<string, unknown>;
-}
-/**
- * Protocol for pluggable memory backends (single, unified).
- *
- * Backends can store files in different locations (state, filesystem, database, etc.)
- * and provide a uniform interface for file operations.
- *
- * All file data is represented as objects with the FileData structure.
- *
- * Methods can return either direct values or Promises, allowing both
- * synchronous and asynchronous implementations.
- */
-interface BackendProtocol {
-    /**
-     * Structured listing with file metadata.
-     *
-     * Lists files and directories in the specified directory (non-recursive).
-     * Directories have a trailing / in their path and is_dir=true.
-     *
-     * @param path - Absolute path to directory
-     * @returns List of FileInfo objects for files and directories directly in the directory
-     */
-    lsInfo(path: string): MaybePromise<FileInfo[]>;
-    /**
-     * Read file content with line numbers or an error string.
-     *
-     * @param filePath - Absolute file path
-     * @param offset - Line offset to start reading from (0-indexed), default 0
-     * @param limit - Maximum number of lines to read, default 2000
-     * @returns Formatted file content with line numbers, or error message
-     */
-    read(filePath: string, offset?: number, limit?: number): MaybePromise<string>;
-    /**
-     * Read file content as raw FileData.
-     *
-     * @param filePath - Absolute file path
-     * @returns Raw file content as FileData
-     */
-    readRaw(filePath: string): MaybePromise<FileData>;
-    /**
-     * Structured search results or error string for invalid input.
-     *
-     * Searches file contents for a regex pattern.
-     *
-     * @param pattern - Regex pattern to search for
-     * @param path - Base path to search from (default: null)
-     * @param glob - Optional glob pattern to filter files (e.g., "*.py")
-     * @returns List of GrepMatch objects or error string for invalid regex
-     */
-    grepRaw(pattern: string, path?: string | null, glob?: string | null): MaybePromise<GrepMatch[] | string>;
-    /**
-     * Structured glob matching returning FileInfo objects.
-     *
-     * @param pattern - Glob pattern (e.g., `*.py`, `**\/*.ts`)
-     * @param path - Base path to search from (default: "/")
-     * @returns List of FileInfo objects matching the pattern
-     */
-    globInfo(pattern: string, path?: string): MaybePromise<FileInfo[]>;
-    /**
-     * Create a new file.
-     *
-     * @param filePath - Absolute file path
-     * @param content - File content as string
-     * @returns WriteResult with error populated on failure
-     */
-    write(filePath: string, content: string): MaybePromise<WriteResult>;
-    /**
-     * Edit a file by replacing string occurrences.
-     *
-     * @param filePath - Absolute file path
-     * @param oldString - String to find and replace
-     * @param newString - Replacement string
-     * @param replaceAll - If true, replace all occurrences (default: false)
-     * @returns EditResult with error, path, filesUpdate, and occurrences
-     */
-    edit(filePath: string, oldString: string, newString: string, replaceAll?: boolean): MaybePromise<EditResult>;
-}
-/**
- * State and store container for backend initialization.
- *
- * This provides a clean interface for what backends need to access:
- * - state: Current agent state (with files, messages, etc.)
- * - store: Optional persistent store for cross-conversation data
- *
- * Different contexts build this differently:
- * - Tools: Extract state via getCurrentTaskInput(config)
- * - Middleware: Use request.state directly
- */
-interface StateAndStore {
-    /** Current agent state with files, messages, etc. */
-    state: unknown;
-    /** Optional BaseStore for persistent cross-conversation storage */
-    store?: BaseStore;
-    /** Optional assistant ID for per-assistant isolation in store */
-    assistantId?: string;
-    assistant_id?: string;
-    threadId?: string;
-    tenantId?: string;
-    workspaceId?: string;
-    projectId?: string;
-}
-/**
- * Factory function type for creating backend instances.
- *
- * Backends receive StateAndStore which contains the current state
- * and optional store, extracted from the execution context.
- *
- * @example
- * ```typescript
- * // Using in middleware
- * const middleware = createFilesystemMiddleware({
- *   backend: (stateAndStore) => new StateBackend(stateAndStore)
- * });
- * ```
- */
-type BackendFactory = (stateAndStore: StateAndStore) => Promise<BackendProtocol>;
-
 /**
  * StateBackend: Store files in LangGraph agent state (ephemeral).
  */
@@ -5062,6 +5082,18 @@ declare class SandboxFilesystem implements BackendProtocol {
     globInfo(pattern: string, searchPath?: string): Promise<FileInfo[]>;
 }
 
+declare class VolumeFilesystem implements BackendProtocol {
+    private readonly client;
+    constructor(client: VolumeFsClient);
+    lsInfo(path: string): Promise<FileInfo[]>;
+    read(filePath: string, offset?: number, limit?: number): Promise<string>;
+    readRaw(filePath: string): Promise<FileData>;
+    grepRaw(_pattern: string, _path?: string | null, _glob?: string | null): string | GrepMatch[];
+    globInfo(_pattern: string, _path?: string): FileInfo[];
+    write(filePath: string, content: string): Promise<WriteResult>;
+    edit(_filePath: string, _oldString: string, _newString: string, _replaceAll?: boolean): EditResult;
+}
+
 /**
  * Shared utility functions for memory backend implementations.
  *
@@ -5661,4 +5693,4 @@ interface SchedulerMiddlewareOptions {
 }
 declare function createSchedulerMiddleware(options?: SchedulerMiddlewareOptions): AgentMiddleware;
 
-export { AGENT_TASK_EVENT, type AddMessageParams, Agent, type AgentClient, type AgentExecutor, AgentInstanceManager, type AgentLattice, AgentLatticeManager, type AgentLifecycleEventName, AgentManager, type AgentStreamExecutor, type AgentThreadInterface, type BackendFactory, type BackendProtocol, type BufferStats, type Chunk, ChunkBuffer, ChunkBufferLatticeManager, type ColumnInfo, CompositeBackend, ConsoleLoggerClient, type CreateSandboxProviderConfig, type CronFields, CustomMetricsClient, type DatabaseConfig, type DatabaseType, DaytonaInstance, DaytonaProvider, type DaytonaProviderConfig, DefaultScheduleClient, E2BInstance, E2BProvider, type E2BProviderConfig, EMPTY_CONTENT_WARNING, type EditResult, type EmbeddingsLatticeInterface, EmbeddingsLatticeManager, type EnsureMicrosandboxInput, type FileData, type FileInfo, FileSystemSkillStore, type FileSystemSkillStoreOptions, FilesystemBackend, type GrepMatch, type IMessageQueueStore, type IMetricsServerClient, type ISqlDatabase, InMemoryAssistantStore, InMemoryChunkBuffer, InMemoryDatabaseConfigStore, InMemoryMailboxStore, InMemoryTaskListStore, InMemoryTenantStore, InMemoryThreadMessageQueueStore, InMemoryThreadStore, InMemoryUserStore, InMemoryUserTenantLinkStore, LINE_NUMBER_WIDTH, type LangGraphStateChecker, type LoggerLattice, LoggerLatticeManager, MAX_LINE_LENGTH, type MailboxMessage, type MailboxStore, type McpLatticeInterface, McpLatticeManager, type McpServerInfo, MemoryBackend, MemoryLatticeManager, MemoryQueueClient, MemoryScheduleStorage, type MessageCompletedEvent, type MessageFailedEvent, type MessageStartedEvent, MessageType, MetricsServerManager, MicrosandboxInstance, MicrosandboxProvider, type MicrosandboxProviderConfig, MicrosandboxRemoteInstance, MicrosandboxRemoteProvider, type MicrosandboxRemoteProviderConfig, MicrosandboxServiceClient, type MicrosandboxServiceClientConfig, type MicrosandboxShellExecInput, type ModelConfig, type ModelLatticeInterface, ModelLatticeManager, type PendingMessage, PinoLoggerClient, PostgresDatabase, PrometheusClient, type QueryResult, type QueueLattice, QueueLatticeManager, QueueMode, type QueuePendingEvent, RemoteSandboxInstance, RemoteSandboxProvider, type RemoteSandboxProviderConfig, type RunSandboxConfig, type RuntimeModelConfig, type SandboxFileInfo, type SandboxFileService, SandboxFilesystem, type SandboxInstance, type SandboxIsolationLevel, SandboxLatticeManager, type SandboxManagerProtocol, type SandboxProvider, type SandboxShellService, SandboxSkillStore, type SandboxSkillStoreOptions, type SandboxVolumeDefinition, type ScheduleLattice, ScheduleLatticeManager, type SchedulerMiddlewareOptions, SemanticMetricsClient, type SkillLattice, SkillLatticeManager, type SkillMeta, type SkillResource, SqlDatabaseManager, type StateAndStore, StateBackend, StoreBackend, type StoreLattice, StoreLatticeManager, type StoreType, type StoreTypeMap, TOOL_RESULT_TOKEN_LIMIT, TRUNCATION_GUIDANCE, type TableInfo, type TableSchema, type TaskEvent, type TaskListStore, type TaskSpec, TaskStatus, type TaskUpdatable, TeamAgentGraphBuilder, type TeamConfig, type TeamMiddlewareOptions, type TeamTask, type TeammateSpec, type TeammateToolsOptions, type ThreadBuffer, type ThreadBufferConfig, type ThreadBusyEvent, type ThreadIdleEvent, type ThreadInfo, type ThreadQueueConfig, type ThreadState, ThreadStatus, type ThreadStatusChangedEvent, type ToolDefinition, type ToolLattice, ToolLatticeManager, type UnknownToolHandlerConfig, type VectorStoreLatticeInterface, VectorStoreLatticeManager, type WriteResult, agentInstanceManager, agentLatticeManager, buildGrepResultsDict, buildSkillFile, checkEmptyContent, clearEncryptionKeyCache, computeSandboxName, createAgentTeam, createExecuteSqlQueryTool, createFileData, createInfoSqlTool, createListMetricsDataSourcesTool, createListMetricsServersTool, createListTablesSqlTool, createModelSelectorMiddleware, createQueryCheckerSqlTool, createQueryMetricDefinitionTool, createQueryMetricsListTool, createQuerySemanticMetricDataTool, createQuerySqlTool, createQueryTableDefinitionTool, createQueryTablesListTool, createSandboxProvider, createSchedulerMiddleware, createTeamMiddleware, createTeammateTools, createUnknownToolHandlerMiddleware, createWidgetMiddleware, decrypt, defaultMicrosandboxConfig, describeCronExpression, embeddingsLatticeManager, encrypt, eventBus, eventBus as eventBusDefault, fileDataToString, formatContentWithLineNumbers, formatGrepMatches, formatGrepResults, formatReadResponse, getAgentClient, getAgentConfig, getAllAgentConfigs, getAllToolDefinitions, getCheckpointSaver, getChunkBuffer, getEmbeddingsClient, getEmbeddingsLattice, getEncryptionKey, getLoggerLattice, getModelLattice, getNextCronTime, getQueueLattice, getSandBoxManager, getScheduleLattice, getStoreLattice, getToolClient, getToolDefinition, getToolLattice, getVectorStoreClient, getVectorStoreLattice, globSearchFiles, grepMatchesFromFiles, grepSearchFiles, hasChunkBuffer, isUsingDefaultKey, isValidCronExpression, isValidSandboxName, isValidSkillName, loggerLatticeManager, mcpManager, metricsServerManager, modelLatticeManager, normalizeSandboxName, parseCronExpression, parseSkillFrontmatter, performStringReplacement, queueLatticeManager, registerAgentLattice, registerAgentLatticeWithTenant, registerAgentLattices, registerCheckpointSaver, registerChunkBuffer, registerEmbeddingsLattice, registerExistingTool, registerLoggerLattice, registerModelLattice, registerQueueLattice, registerScheduleLattice, registerStoreLattice, registerTeammateAgent, registerToolLattice, registerVectorStoreLattice, sandboxLatticeManager, sanitizeToolCallId, scheduleLatticeManager, skillLatticeManager, sqlDatabaseManager, storeLatticeManager, toolLatticeManager, truncateIfTooLong, unregisterTeammateAgent, updateFileData, validateAgentInput, validateEncryptionKey, validatePath, validateSkillName, validateToolInput, vectorStoreLatticeManager };
+export { AGENT_TASK_EVENT, type AddMessageParams, Agent, type AgentClient, type AgentExecutor, AgentInstanceManager, type AgentLattice, AgentLatticeManager, type AgentLifecycleEventName, AgentManager, type AgentStreamExecutor, type AgentThreadInterface, type BackendFactory, type BackendProtocol, type BufferStats, type Chunk, ChunkBuffer, ChunkBufferLatticeManager, type ColumnInfo, CompositeBackend, ConsoleLoggerClient, type CreateSandboxProviderConfig, type CronFields, CustomMetricsClient, type DatabaseConfig, type DatabaseType, DaytonaInstance, DaytonaProvider, type DaytonaProviderConfig, DefaultScheduleClient, E2BInstance, E2BProvider, type E2BProviderConfig, EMPTY_CONTENT_WARNING, type EditResult, type EmbeddingsLatticeInterface, EmbeddingsLatticeManager, type EnsureMicrosandboxInput, type FileData, type FileInfo, FileSystemSkillStore, type FileSystemSkillStoreOptions, FilesystemBackend, type GrepMatch, type IMessageQueueStore, type IMetricsServerClient, type ISqlDatabase, InMemoryAssistantStore, InMemoryChunkBuffer, InMemoryDatabaseConfigStore, InMemoryMailboxStore, InMemoryTaskListStore, InMemoryTenantStore, InMemoryThreadMessageQueueStore, InMemoryThreadStore, InMemoryUserStore, InMemoryUserTenantLinkStore, LINE_NUMBER_WIDTH, type LangGraphStateChecker, type LoggerLattice, LoggerLatticeManager, MAX_LINE_LENGTH, type MailboxMessage, type MailboxStore, type McpLatticeInterface, McpLatticeManager, type McpServerInfo, MemoryBackend, MemoryLatticeManager, MemoryQueueClient, MemoryScheduleStorage, type MessageCompletedEvent, type MessageFailedEvent, type MessageStartedEvent, MessageType, MetricsServerManager, MicrosandboxInstance, MicrosandboxProvider, type MicrosandboxProviderConfig, MicrosandboxRemoteInstance, MicrosandboxRemoteProvider, type MicrosandboxRemoteProviderClient, type MicrosandboxRemoteProviderConfig, MicrosandboxServiceClient, type MicrosandboxServiceClientConfig, type MicrosandboxShellExecInput, type ModelConfig, type ModelLatticeInterface, ModelLatticeManager, type PendingMessage, PinoLoggerClient, PostgresDatabase, PrometheusClient, type QueryResult, type QueueLattice, QueueLatticeManager, QueueMode, type QueuePendingEvent, RemoteSandboxInstance, RemoteSandboxProvider, type RemoteSandboxProviderConfig, type RunSandboxConfig, type RuntimeModelConfig, type SandboxFileInfo, type SandboxFileService, SandboxFilesystem, type SandboxInstance, type SandboxIsolationLevel, SandboxLatticeManager, type SandboxManagerProtocol, type SandboxProvider, type SandboxShellService, SandboxSkillStore, type SandboxSkillStoreOptions, type SandboxVolumeDefinition, type ScheduleLattice, ScheduleLatticeManager, type SchedulerMiddlewareOptions, SemanticMetricsClient, type SkillLattice, SkillLatticeManager, type SkillMeta, type SkillResource, SqlDatabaseManager, type StateAndStore, StateBackend, StoreBackend, type StoreLattice, StoreLatticeManager, type StoreType, type StoreTypeMap, TOOL_RESULT_TOKEN_LIMIT, TRUNCATION_GUIDANCE, type TableInfo, type TableSchema, type TaskEvent, type TaskListStore, type TaskSpec, TaskStatus, type TaskUpdatable, TeamAgentGraphBuilder, type TeamConfig, type TeamMiddlewareOptions, type TeamTask, type TeammateSpec, type TeammateToolsOptions, type ThreadBuffer, type ThreadBufferConfig, type ThreadBusyEvent, type ThreadIdleEvent, type ThreadInfo, type ThreadQueueConfig, type ThreadState, ThreadStatus, type ThreadStatusChangedEvent, type ToolDefinition, type ToolLattice, ToolLatticeManager, type UnknownToolHandlerConfig, type VectorStoreLatticeInterface, VectorStoreLatticeManager, VolumeFilesystem, type VolumeFsClient, type WriteResult, agentInstanceManager, agentLatticeManager, buildGrepResultsDict, buildNamedVolumeName, buildSandboxMetadataEnv, buildSkillFile, checkEmptyContent, clearEncryptionKeyCache, computeSandboxName, createAgentTeam, createExecuteSqlQueryTool, createFileData, createInfoSqlTool, createListMetricsDataSourcesTool, createListMetricsServersTool, createListTablesSqlTool, createModelSelectorMiddleware, createQueryCheckerSqlTool, createQueryMetricDefinitionTool, createQueryMetricsListTool, createQuerySemanticMetricDataTool, createQuerySqlTool, createQueryTableDefinitionTool, createQueryTablesListTool, createSandboxProvider, createSchedulerMiddleware, createTeamMiddleware, createTeammateTools, createUnknownToolHandlerMiddleware, createWidgetMiddleware, decrypt, defaultMicrosandboxConfig, describeCronExpression, embeddingsLatticeManager, encrypt, eventBus, eventBus as eventBusDefault, fileDataToString, formatContentWithLineNumbers, formatGrepMatches, formatGrepResults, formatReadResponse, getAgentClient, getAgentConfig, getAllAgentConfigs, getAllToolDefinitions, getCheckpointSaver, getChunkBuffer, getEmbeddingsClient, getEmbeddingsLattice, getEncryptionKey, getLoggerLattice, getModelLattice, getNextCronTime, getQueueLattice, getSandBoxManager, getScheduleLattice, getStoreLattice, getToolClient, getToolDefinition, getToolLattice, getVectorStoreClient, getVectorStoreLattice, globSearchFiles, grepMatchesFromFiles, grepSearchFiles, hasChunkBuffer, isUsingDefaultKey, isValidCronExpression, isValidSandboxName, isValidSkillName, loggerLatticeManager, mcpManager, metricsServerManager, modelLatticeManager, normalizeSandboxName, parseCronExpression, parseSkillFrontmatter, performStringReplacement, queueLatticeManager, registerAgentLattice, registerAgentLatticeWithTenant, registerAgentLattices, registerCheckpointSaver, registerChunkBuffer, registerEmbeddingsLattice, registerExistingTool, registerLoggerLattice, registerModelLattice, registerQueueLattice, registerScheduleLattice, registerStoreLattice, registerTeammateAgent, registerToolLattice, registerVectorStoreLattice, sandboxLatticeManager, sanitizeToolCallId, scheduleLatticeManager, skillLatticeManager, sqlDatabaseManager, storeLatticeManager, toolLatticeManager, truncateIfTooLong, unregisterTeammateAgent, updateFileData, validateAgentInput, validateEncryptionKey, validatePath, validateSkillName, validateToolInput, vectorStoreLatticeManager };