@axiom-lattice/core 2.1.79 → 2.1.81

package/dist/index.d.mts

@@ -8,7 +8,7 @@ import { BaseLanguageModelInput, LanguageModelLike, BaseLanguageModel } from '@l
 import { CallbackManagerForLLMRun } from '@langchain/core/callbacks/manager';
 import { ChatResult } from '@langchain/core/outputs';
 import * as _axiom_lattice_protocols from '@axiom-lattice/protocols';
-import { LLMConfig, SemanticMetricsServerConfig, MetricMeta, MetricQueryResult, DataSource, SemanticMetricsQueryRequest, SemanticMetricsQueryResponse, TableQueryRequest, TableQueryResponse, ExecuteSqlQueryRequest, ExecuteSqlQueryResponse, MetricsServerType, MetricsServerConfig, ToolConfig, ToolExecutor, AgentConfig, MiddlewareType, GraphBuildOptions, MessageChunk, MessageChunkType, QueueLatticeProtocol, QueueConfig, QueueClient, QueueResult, ScheduleLatticeProtocol, ScheduleConfig, ScheduleClient, ScheduleStorage, TaskHandler, ScheduleOnceOptions, ScheduleCronOptions, ScheduledTaskDefinition, ScheduledTaskStatus, ScheduleExecutionType, ThreadStore, AssistantStore, SkillStore, WorkspaceStore, ProjectStore, DatabaseConfigStore, MetricsServerConfigStore, McpServerConfigStore, UserStore, TenantStore, UserTenantLinkStore, WorkflowTrackingStore, EvalStore, ChannelInstallationStore, BindingRegistry, A2AApiKeyStore, Thread, CreateThreadRequest, Assistant, CreateAssistantRequest, Skill, CreateSkillRequest, SkillStoreContext, DatabaseConfigEntry, CreateDatabaseConfigRequest, UpdateDatabaseConfigRequest, User, CreateUserRequest, UpdateUserRequest, Tenant, CreateTenantRequest, UpdateTenantRequest, UserTenantLink, CreateUserTenantLinkRequest, UpdateUserTenantLinkRequest, ChannelInstallation, ChannelInstallationType, CreateChannelInstallationRequest, UpdateChannelInstallationRequest, Binding, CreateBindingInput, A2AApiKeyRecord, CreateA2AApiKeyInput, A2AApiKeyEntry, LoggerLatticeProtocol, LoggerConfig, LoggerClient, LoggerContext, SkillConfig, SkillClient } from '@axiom-lattice/protocols';
+import { LLMConfig, SemanticMetricsServerConfig, MetricMeta, MetricQueryResult, DataSource, SemanticMetricsQueryRequest, SemanticMetricsQueryResponse, TableQueryRequest, TableQueryResponse, ExecuteSqlQueryRequest, ExecuteSqlQueryResponse, MetricsServerType, MetricsServerConfig, ToolConfig, ToolExecutor, AgentConfig, MiddlewareType, GraphBuildOptions, MessageChunk, MessageChunkType, QueueLatticeProtocol, QueueConfig, QueueClient, QueueResult, ScheduleLatticeProtocol, ScheduleConfig, ScheduleClient, ScheduleStorage, TaskHandler, ScheduleOnceOptions, ScheduleCronOptions, ScheduledTaskDefinition, ScheduledTaskStatus, ScheduleExecutionType, ThreadStore, AssistantStore, SkillStore, WorkspaceStore, ProjectStore, DatabaseConfigStore, MetricsServerConfigStore, McpServerConfigStore, UserStore, TenantStore, UserTenantLinkStore, WorkflowTrackingStore, EvalStore, ChannelInstallationStore, BindingRegistry, MenuRegistry, A2AApiKeyStore, TaskStore, Thread, CreateThreadRequest, Assistant, CreateAssistantRequest, Skill, CreateSkillRequest, SkillStoreContext, DatabaseConfigEntry, CreateDatabaseConfigRequest, UpdateDatabaseConfigRequest, User, CreateUserRequest, UpdateUserRequest, Tenant, CreateTenantRequest, UpdateTenantRequest, UserTenantLink, CreateUserTenantLinkRequest, UpdateUserTenantLinkRequest, ChannelInstallation, ChannelInstallationType, CreateChannelInstallationRequest, UpdateChannelInstallationRequest, Binding, CreateBindingInput, A2AApiKeyRecord, CreateA2AApiKeyInput, A2AApiKeyEntry, CreateTaskRequest, TaskItem, TaskListFilter, UpdateTaskRequest, MenuItem, CreateMenuItemInput, UpdateMenuItemInput, LoggerLatticeProtocol, LoggerConfig, LoggerClient, LoggerContext, SkillConfig, SkillClient, ChannelAdapter, InternalStateField, InternalInput, InternalNode, InternalAgentNode, InternalMapNode, InternalDSL } from '@axiom-lattice/protocols';
 export { _axiom_lattice_protocols as Protocols };
 export { AgentConfig, AgentType, GraphBuildOptions, MemoryType } from '@axiom-lattice/protocols';
 import * as langchain from 'langchain';
@@ -26,7 +26,7 @@ import { Connection, MultiServerMCPClient } from '@langchain/mcp-adapters';
 import { SandboxClient } from '@agent-infra/sandbox';
 import { Sandbox } from 'e2b';
 import { Sandbox as Sandbox$1 } from '@daytonaio/sdk';
-import { Runnable } from '@langchain/core/runnables';
+import { Runnable, RunnableConfig } from '@langchain/core/runnables';
 import { InteropZodObject } from '@langchain/core/utils/types';
 
 /**
@@ -1711,6 +1711,7 @@ interface AgentBuildParams {
     }>;
     prompt: string;
     stateSchema?: z$1.ZodObject<any, any, any, any, any>;
+    responseFormat?: any;
     tenantId?: string;
 }
 
@@ -2607,6 +2608,8 @@ interface AddMessageParams {
     threadId: string;
     tenantId: string;
     assistantId: string;
+    workspaceId?: string;
+    projectId?: string;
     content: PendingMessageContent;
     type?: "human" | "system";
     priority?: number;
@@ -2618,6 +2621,8 @@ interface ThreadInfo {
     tenantId: string;
     assistantId: string;
     threadId: string;
+    workspaceId?: string;
+    projectId?: string;
 }
 /**
  * Interface for message queue storage
@@ -2689,7 +2694,9 @@ type StoreTypeMap = {
     eval: EvalStore;
     channelInstallation: ChannelInstallationStore;
     channelBinding: BindingRegistry;
+    menu: MenuRegistry;
     a2aApiKey: A2AApiKeyStore;
+    task: TaskStore;
 };
 /**
  * Store type keys
@@ -2892,6 +2899,10 @@ declare class InMemoryAssistantStore implements AssistantStore {
      * Check if assistant exists
      */
     hasAssistant(tenantId: string, id: string): Promise<boolean>;
+    /**
+     * Get assistant by owner user ID
+     */
+    getByOwner(tenantId: string, userId: string): Promise<Assistant | null>;
     /**
      * Clear all assistants for a tenant (useful for testing)
      */
@@ -3276,6 +3287,7 @@ declare class InMemoryChannelInstallationStore implements ChannelInstallationSto
      * @returns Array of matching {@link ChannelInstallation} objects
      */
     getInstallationsByTenant(tenantId: string, channel?: ChannelInstallationType): Promise<ChannelInstallation[]>;
+    getAllInstallations(channel?: ChannelInstallationType): Promise<ChannelInstallation[]>;
     /**
      * Creates a new channel installation for a tenant.
      *
@@ -3459,6 +3471,63 @@ declare class InMemoryThreadMessageQueueStore implements IMessageQueueStore {
     resetProcessingToPending(threadId: string): Promise<number>;
 }
 
+/**
+ * InMemoryTaskStore
+ *
+ * In-memory implementation of TaskStore
+ * Provides CRUD operations for task data stored in memory
+ */
+
+/**
+ * In-memory implementation of TaskStore
+ */
+declare class InMemoryTaskStore implements TaskStore {
+    private tasks;
+    /**
+     * Create a new task
+     */
+    create(params: CreateTaskRequest & {
+        tenantId: string;
+        ownerType: string;
+        ownerId: string;
+    }): Promise<TaskItem>;
+    /**
+     * Get task by ID
+     */
+    getById(tenantId: string, id: string): Promise<TaskItem | null>;
+    /**
+     * List tasks matching filter criteria
+     */
+    list(filter: TaskListFilter): Promise<TaskItem[]>;
+    /**
+     * Update an existing task
+     */
+    update(tenantId: string, id: string, updates: UpdateTaskRequest): Promise<TaskItem | null>;
+    /**
+     * Delete a task by ID
+     */
+    delete(tenantId: string, id: string): Promise<boolean>;
+    /**
+     * Clear all tasks for a tenant (useful for testing)
+     */
+    clear(tenantId?: string): void;
+}
+
+declare class InMemoryMenuStore implements MenuRegistry {
+    private items;
+    list(params: {
+        tenantId: string;
+        menuTarget?: string;
+    }): Promise<MenuItem[]>;
+    getById(id: string): Promise<MenuItem | null>;
+    create(input: CreateMenuItemInput & {
+        tenantId: string;
+    }): Promise<MenuItem>;
+    update(id: string, patch: UpdateMenuItemInput): Promise<MenuItem>;
+    delete(id: string): Promise<void>;
+    clear(): void;
+}
+
 /**
  * Embeddings Lattice Interface
  * Defines the structure of an embeddings lattice entry
@@ -4419,6 +4488,23 @@ declare function buildSandboxMetadataEnv(config?: RunSandboxConfig): Record<stri
 
 declare function buildNamedVolumeName(prefix: "s" | "a" | "p", ...parts: Array<string | undefined>): string;
 
+/**
+ * Channel connection lifecycle.
+ *
+ * When a gateway starts, it should call {@link connectAllChannels} to
+ * establish persistent connections for every enabled channel installation
+ * across ALL tenants.
+ *
+ * Adapters implement the optional {@link ChannelAdapter.connect} method
+ * which handles connection setup, event ingestion, and message dispatch
+ * internally.
+ */
+
+interface ConnectAllChannelsOptions {
+    deps?: unknown;
+}
+declare function connectAllChannels(getAdapter: (channel: string) => ChannelAdapter | undefined, options?: ConnectAllChannelsOptions): Promise<void>;
+
 /**
  * Sets the global {@link BindingRegistry} instance used by the channel message router.
  *
@@ -4457,6 +4543,9 @@ declare function setBindingRegistry(r: BindingRegistry): void;
  */
 declare function getBindingRegistry(): BindingRegistry;
 
+declare function setMenuRegistry(r: MenuRegistry): void;
+declare function getMenuRegistry(): MenuRegistry;
+
 /**
  * Agent Team - Store Protocols
  *
@@ -5910,8 +5999,8 @@ declare class Agent {
     assistant_id: string;
     thread_id: string;
     tenant_id: string;
-    workspace_id: string | undefined;
-    project_id: string | undefined;
+    workspace_id: string;
+    project_id: string;
     custom_run_config: any;
     queueMode: ThreadQueueConfig;
     private isWaitingForQueueEnd;
@@ -5957,9 +6046,39 @@ declare class Agent {
     invoke(queueMessage: QueueMessage, signal?: AbortSignal): Promise<{
         messages: any;
     }>;
+    /**
+     * Like {@link invoke} but returns the full LangGraph state (all annotations)
+     * instead of only messages. Messages are serialized to dicts; other state
+     * fields are returned as-is.
+     *
+     * @remarks
+     * Only call this when you need the full state. Existing callers (gateway,
+     * workflows) should keep using {@link invoke} which returns only messages
+     * to avoid exposing internal annotation data.
+     */
+    invokeWithState(queueMessage: QueueMessage, signal?: AbortSignal): Promise<{
+        messages: {
+            role: string;
+            content: string;
+            name: string | undefined;
+            tool_call_id: string | undefined;
+            additional_kwargs?: Record<string, any>;
+            response_metadata?: Record<string, any>;
+            id?: string;
+        }[];
+    }>;
     private agentExecutor;
     getPendingMessages(): Promise<PendingMessage[]>;
     private agentStreamExecutor;
+    private consumeAgentStream;
+    /**
+     * Resume LangGraph execution from the last checkpoint.
+     *
+     * Streams with `null` input — this tells LangGraph to continue from
+     * wherever it left off using the checkpointed state for this thread.
+     * All output chunks are buffered via {@link addChunk}.
+     */
+    private resumeGraphFromCheckpoint;
     private waitingForQueueEnd;
     private getQueueStore;
     private getDefaultQueueConfig;
@@ -6065,9 +6184,14 @@ declare class Agent {
     /**
      * Resume processing after a server restart.
      *
-     * Resets any stuck "processing" messages back to "pending" and restarts the
-     * queue processor. Skips threads that are in `INTERRUPTED` state (the
-     * interruption was intentional).
+     * If the graph was mid-execution (BUSY) it resumes from the LangGraph
+     * checkpoint without re-injecting the message — the message has already
+     * been consumed and is in the graph state.  Processing messages are removed
+     * rather than replayed.
+     *
+     * Skips threads that are in `INTERRUPTED` state (the interruption was
+     * intentional).  IDLE threads simply clean up and restart the queue
+     * processor for any remaining pending messages.
      *
      * Called during gateway startup to recover threads that were mid-execution
      * when the server went down.
@@ -6425,4 +6549,178 @@ interface UnknownToolHandlerConfig {
  */
 declare function createUnknownToolHandlerMiddleware(config?: UnknownToolHandlerConfig): AgentMiddleware;
 
-export { AGENT_TASK_EVENT, type AddMessageParams, Agent, type AgentClient, type AgentExecutor, AgentInstanceManager, type AgentLattice, AgentLatticeManager, type AgentLifecycleEventName, AgentManager, type AgentStreamExecutor, type AgentThreadInterface, BUILTIN_SKILLS, type BackendFactory, type BackendProtocol, type BufferStats, type Chunk, ChunkBuffer, ChunkBufferLatticeManager, type ColumnInfo, CompositeBackend, ConsoleLoggerClient, type CreateProcessingAgentParams, type CreateSandboxProviderConfig, type CronFields, CustomMetricsClient, type CustomMiddlewareFactory, CustomMiddlewareRegistry, 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 FsEntry, type GrepMatch, type IMessageQueueStore, type IMetricsServerClient, type ISqlDatabase, InMemoryA2AApiKeyStore, InMemoryAssistantStore, InMemoryBindingStore, InMemoryChannelInstallationStore, 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, MicrosandboxRemoteInstance, MicrosandboxRemoteProvider, type MicrosandboxRemoteProviderClient, type MicrosandboxRemoteProviderConfig, MicrosandboxServiceClient, type MicrosandboxServiceClientConfig, type MicrosandboxShellExecInput, type ModelConfig, type ModelLatticeInterface, ModelLatticeManager, MysqlDatabase, 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 TopologyEdge, type UnknownToolHandlerConfig, type VectorStoreLatticeInterface, VectorStoreLatticeManager, VolumeFilesystem, type VolumeFsClient, type WriteResult, agentInstanceManager, agentLatticeManager, buildGrepResultsDict, buildNamedVolumeName, buildSandboxMetadataEnv, buildSkillFile, checkEmptyContent, clearEncryptionKeyCache, computeSandboxName, configureStores, createAgentTeam, createExecuteSqlQueryTool, createFileData, createInfoSqlTool, createListMetricsDataSourcesTool, createListMetricsServersTool, createListTablesSqlTool, createModelSelectorMiddleware, createProcessingAgent, createQueryCheckerSqlTool, createQueryMetricDefinitionTool, createQueryMetricsListTool, createQuerySemanticMetricDataTool, createQuerySqlTool, createQueryTableDefinitionTool, createQueryTablesListTool, createSandboxProvider, createSchedulerMiddleware, createTeamMiddleware, createTeammateTools, createUnknownToolHandlerMiddleware, createWidgetMiddleware, decrypt, describeCronExpression, embeddingsLatticeManager, encrypt, ensureBuiltinAgentsForTenant, eventBus, eventBus as eventBusDefault, extractFetcherError, fileDataToString, formatContentWithLineNumbers, formatGrepMatches, formatGrepResults, formatReadResponse, getAgentClient, getAgentConfig, getAllAgentConfigs, getAllBuiltInSkillMetas, getAllToolDefinitions, getBindingRegistry, getBuiltInSkillContent, getBuiltInSkillMeta, getBuiltInSkillNames, getCheckpointSaver, getChunkBuffer, getEmbeddingsClient, getEmbeddingsLattice, getEncryptionKey, getLoggerLattice, getModelLattice, getNextCronTime, getQueueLattice, getSandBoxManager, getScheduleLattice, getStoreLattice, getToolClient, getToolDefinition, getToolLattice, getVectorStoreClient, getVectorStoreLattice, globSearchFiles, grepMatchesFromFiles, grepSearchFiles, hasChunkBuffer, isBuiltInSkill, 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, setBindingRegistry, skillLatticeManager, sqlDatabaseManager, storeLatticeManager, toolLatticeManager, truncateIfTooLong, unregisterTeammateAgent, updateFileData, validateAgentInput, validateEncryptionKey, validatePath, validateSkillName, validateToolInput, vectorStoreLatticeManager };
+declare function createTaskMiddleware(): AgentMiddleware;
+
+type ResolveAgentFn = (ref?: string, responseFormat?: Record<string, unknown>, stepType?: string) => Promise<AgentClient>;
+/**
+ * Build a LangGraph Annotation.Root from DSL state.fields.
+ * Always adds an implicit `phase` field for progress tracking.
+ */
+declare function buildStateAnnotation(fields?: Record<string, InternalStateField>): AnnotationRoot<any>;
+/**
+ * Resolve a dot/bracket path against a state object.
+ * Strips leading "state." prefix automatically.
+ *
+ * @example
+ * resolvePath({ a: { b: [{ c: 1 }] } }, "state.a.b[0].c") // → 1
+ */
+declare function resolvePath(obj: Record<string, unknown>, path: string): unknown;
+/**
+ * Render a template string replacing `${state.path}`, `${item.path}`, and
+ * custom item-key shortcuts like `${<key>.path}` (when `<key>` matches a
+ * top-level property of the item context).
+ *
+ * @param template Template string with ${...} placeholders
+ * @param state Current workflow state
+ * @param item Optional item context (for map nodes). Keys in this object
+ *   become valid template prefixes (e.g. itemKey="row" → ${row.name}).
+ */
+declare function renderTemplate(template: string, state: Record<string, unknown>, item?: Record<string, unknown>): string;
+/**
+ * Build input for LangGraph agent invocation from DSL input specification.
+ * Returns a partial state with messages, suitable for graph.invoke().
+ *
+ * When outputSchema is provided, it is converted into a readable JSON example
+ * and appended to the prompt so the LLM knows exactly what shape to output.
+ */
+declare function buildInput(input: InternalInput | undefined, state: Record<string, unknown>, item?: Record<string, unknown>, outputSchema?: Record<string, unknown>): {
+    messages: BaseMessage[];
+};
+/**
+ * Extract structured output from a sub-agent invocation result.
+ *
+ * Priority order:
+ * 1. result.structuredResponse — langchain's tool strategy stores parsed output here
+ * 2. result.messages — scan backwards for last AIMessage content (native JSON schema /
+ *    legacy text-based structured output)
+ * 3. result itself (minus messages)
+ */
+declare function extractOutput(result: Record<string, unknown>): unknown;
+/**
+ * Process items in parallel with a concurrency limit (simple semaphore).
+ */
+declare function parallelLimit<T, R>(items: T[], limit: number, fn: (item: T, index: number) => Promise<R>): Promise<R[]>;
+/**
+ * Invoke a function with retry logic and optional timeout.
+ */
+declare function invokeWithRetry<T>(fn: () => Promise<T>, maxRetries: number, retryOn?: string[], timeoutMs?: number): Promise<T>;
+/**
+ * Create a handler for an `agent` node.
+ *
+ * Resolves the agent by ref, builds input, invokes with retry,
+ * extracts output, and returns a state update.
+ */
+declare function createAgentNode(node: InternalAgentNode, resolveAgent: ResolveAgentFn, trackingStore?: WorkflowTrackingStore): (state: Record<string, unknown>, config?: RunnableConfig) => Promise<Partial<Record<string, unknown>>>;
+/**
+ * Create a handler for a `map` node.
+ *
+ * Reads the source array from state, batches items, processes each
+ * item through the inner agent in parallel (with concurrency control),
+ * and optionally calls a reduce agent to aggregate results.
+ */
+declare function createMapNode(node: InternalMapNode, resolveAgent: ResolveAgentFn, trackingStore?: WorkflowTrackingStore): (state: Record<string, unknown>, config?: RunnableConfig) => Promise<Partial<Record<string, unknown>>>;
+/**
+ * Dispatch to the correct handler factory based on node type.
+ */
+declare function createNodeHandler(node: InternalNode, resolveAgent: ResolveAgentFn, trackingStore?: WorkflowTrackingStore): (state: Record<string, unknown>, config?: RunnableConfig) => Promise<Partial<Record<string, unknown>>>;
+
+/**
+ * Workflow DSL → LangGraph StateGraph compiler
+ *
+ * Takes a YAML workflow string, parses it via parseYaml(),
+ * and compiles the resulting InternalDSL into a runnable LangGraph StateGraph.
+ */
+
+/**
+ * Compile a YAML workflow string into a LangGraph StateGraph.
+ */
+declare function compileWorkflow(yamlStr: string, resolveAgent: ResolveAgentFn, checkpointer: BaseCheckpointSaver, trackingStore?: WorkflowTrackingStore): CompiledStateGraph<any, any, any, any, any>;
+/**
+ * Compile an InternalDSL directly into a LangGraph StateGraph.
+ * Used internally by compileWorkflow and for lower-level access.
+ */
+declare function compileInternal(ir: InternalDSL, resolveAgent: ResolveAgentFn, checkpointer: BaseCheckpointSaver, trackingStore?: WorkflowTrackingStore): CompiledStateGraph<any, any, any, any, any>;
+interface WorkflowValidationError {
+    type: "error" | "warning";
+    message: string;
+}
+/** Validate an expanded InternalDSL for structural correctness. */
+declare function validateDSL(dsl: InternalDSL): WorkflowValidationError[];
+
+/**
+ * Convert condition expression's leading identifier to bracket notation
+ * so hyphenated step ids don't break JS parsing.
+ * "classify-doc.intent" → "state[\"classify-doc\"].intent"
+ */
+declare function toSafeStateExpr(expr: string): string;
+declare function parseYaml(yamlStr: string): InternalDSL;
+
+/**
+ * Convert shorthand schema notation to standard JSON Schema.
+ *
+ * Shorthand forms:
+ *   field: string     → { type: "string" }
+ *   field: number     → { type: "number" }
+ *   field: boolean    → { type: "boolean" }
+ *   field: string[]   → { type: "array", items: { type: "string" } }
+ *   field: number[]   → { type: "array", items: { type: "number" } }
+ *   field: boolean[]  → { type: "array", items: { type: "boolean" } }
+ *   field: [{a: string, b: number}]  → { type: "array", items: { type: "object", ... } }
+ *   field: {a: string} → { type: "object", properties: {a: {type: "string"}}, required: ["a"] }
+ *
+ * @param fields Shorthand schema definition
+ * @returns Standard JSON Schema or undefined if fields is empty/null
+ */
+declare function toJsonSchema(fields: Record<string, unknown> | undefined): Record<string, unknown> | undefined;
+
+/**
+ * Global singleton for personal assistant default configuration.
+ *
+ * Holds the base AgentConfig used when users create a personal assistant.
+ * Projects can extend it via `extend()` to add/remove middleware and tools.
+ *
+ * @example
+ * ```ts
+ * import { PersonalAssistantConfig } from "@axiom-lattice/core";
+ *
+ * PersonalAssistantConfig.extend((config) => {
+ *   config.middleware.push({ id: "sql", type: "sql", ... });
+ *   config.tools.push("my_custom_tool");
+ *   config.middleware = config.middleware.filter(m => m.type !== "browser");
+ * });
+ * ```
+ */
+declare class PersonalAssistantConfig {
+    private static _config;
+    /**
+     * Get a deep clone of the current default config.
+     * Caller must set `key` before registering as an agent.
+     */
+    static get(): AgentConfig;
+    /**
+     * Mutate the default config in-place.
+     * Call once at app startup to customize middleware and tools.
+     *
+     * @param fn - Receives the live config object for direct mutation
+     */
+    static extend(fn: (config: Omit<AgentConfig, "key">) => void): void;
+    /**
+     * Reset config to built-in defaults (useful in tests).
+     */
+    static reset(): void;
+    /**
+     * Inject name and personality into a config by directly building
+     * the claw middleware's bootstrap file contents.
+     *
+     * IDENTITY.md gets the actual name and personality description.
+     * USER.md gets the user's name pre-filled.
+     * SOUL.md is kept as-is (shared across all personal assistants).
+     *
+     * @param config - The agent config (must be a mutable copy from get())
+     * @param name - Assistant display name (also used as the user's name in USER.md)
+     * @param personality - Personality description for IDENTITY.md
+     */
+    static render(config: AgentConfig, name: string, personality: string): void;
+}
+
+export { AGENT_TASK_EVENT, type AddMessageParams, Agent, type AgentClient, type AgentExecutor, AgentInstanceManager, type AgentLattice, AgentLatticeManager, type AgentLifecycleEventName, AgentManager, type AgentStreamExecutor, type AgentThreadInterface, BUILTIN_SKILLS, type BackendFactory, type BackendProtocol, type BufferStats, type Chunk, ChunkBuffer, ChunkBufferLatticeManager, type ColumnInfo, CompositeBackend, type ConnectAllChannelsOptions, ConsoleLoggerClient, type CreateProcessingAgentParams, type CreateSandboxProviderConfig, type CronFields, CustomMetricsClient, type CustomMiddlewareFactory, CustomMiddlewareRegistry, 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 FsEntry, type GrepMatch, type IMessageQueueStore, type IMetricsServerClient, type ISqlDatabase, InMemoryA2AApiKeyStore, InMemoryAssistantStore, InMemoryBindingStore, InMemoryChannelInstallationStore, InMemoryChunkBuffer, InMemoryDatabaseConfigStore, InMemoryMailboxStore, InMemoryMenuStore, InMemoryTaskListStore, InMemoryTaskStore, 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, MicrosandboxRemoteInstance, MicrosandboxRemoteProvider, type MicrosandboxRemoteProviderClient, type MicrosandboxRemoteProviderConfig, MicrosandboxServiceClient, type MicrosandboxServiceClientConfig, type MicrosandboxShellExecInput, type ModelConfig, type ModelLatticeInterface, ModelLatticeManager, MysqlDatabase, type PendingMessage, PersonalAssistantConfig, PinoLoggerClient, PostgresDatabase, PrometheusClient, type QueryResult, type QueueLattice, QueueLatticeManager, QueueMode, type QueuePendingEvent, RemoteSandboxInstance, RemoteSandboxProvider, type RemoteSandboxProviderConfig, type ResolveAgentFn, 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 TopologyEdge, type UnknownToolHandlerConfig, type VectorStoreLatticeInterface, VectorStoreLatticeManager, VolumeFilesystem, type VolumeFsClient, type WorkflowValidationError, type WriteResult, agentInstanceManager, agentLatticeManager, buildGrepResultsDict, buildInput, buildNamedVolumeName, buildSandboxMetadataEnv, buildSkillFile, buildStateAnnotation, checkEmptyContent, clearEncryptionKeyCache, compileInternal, compileWorkflow, computeSandboxName, configureStores, connectAllChannels, createAgentNode, createAgentTeam, createExecuteSqlQueryTool, createFileData, createInfoSqlTool, createListMetricsDataSourcesTool, createListMetricsServersTool, createListTablesSqlTool, createMapNode, createModelSelectorMiddleware, createNodeHandler, createProcessingAgent, createQueryCheckerSqlTool, createQueryMetricDefinitionTool, createQueryMetricsListTool, createQuerySemanticMetricDataTool, createQuerySqlTool, createQueryTableDefinitionTool, createQueryTablesListTool, createSandboxProvider, createSchedulerMiddleware, createTaskMiddleware, createTeamMiddleware, createTeammateTools, createUnknownToolHandlerMiddleware, createWidgetMiddleware, decrypt, describeCronExpression, embeddingsLatticeManager, encrypt, ensureBuiltinAgentsForTenant, eventBus, eventBus as eventBusDefault, extractFetcherError, extractOutput, fileDataToString, formatContentWithLineNumbers, formatGrepMatches, formatGrepResults, formatReadResponse, getAgentClient, getAgentConfig, getAllAgentConfigs, getAllBuiltInSkillMetas, getAllToolDefinitions, getBindingRegistry, getBuiltInSkillContent, getBuiltInSkillMeta, getBuiltInSkillNames, getCheckpointSaver, getChunkBuffer, getEmbeddingsClient, getEmbeddingsLattice, getEncryptionKey, getLoggerLattice, getMenuRegistry, getModelLattice, getNextCronTime, getQueueLattice, getSandBoxManager, getScheduleLattice, getStoreLattice, getToolClient, getToolDefinition, getToolLattice, getVectorStoreClient, getVectorStoreLattice, globSearchFiles, grepMatchesFromFiles, grepSearchFiles, hasChunkBuffer, invokeWithRetry, isBuiltInSkill, isUsingDefaultKey, isValidCronExpression, isValidSandboxName, isValidSkillName, loggerLatticeManager, mcpManager, metricsServerManager, modelLatticeManager, normalizeSandboxName, parallelLimit, parseCronExpression, parseSkillFrontmatter, parseYaml, performStringReplacement, queueLatticeManager, registerAgentLattice, registerAgentLatticeWithTenant, registerAgentLattices, registerCheckpointSaver, registerChunkBuffer, registerEmbeddingsLattice, registerExistingTool, registerLoggerLattice, registerModelLattice, registerQueueLattice, registerScheduleLattice, registerStoreLattice, registerTeammateAgent, registerToolLattice, registerVectorStoreLattice, renderTemplate, resolvePath, sandboxLatticeManager, sanitizeToolCallId, scheduleLatticeManager, setBindingRegistry, setMenuRegistry, skillLatticeManager, sqlDatabaseManager, storeLatticeManager, toJsonSchema, toSafeStateExpr, toolLatticeManager, truncateIfTooLong, unregisterTeammateAgent, updateFileData, validateAgentInput, validateDSL, validateEncryptionKey, validatePath, validateSkillName, validateToolInput, vectorStoreLatticeManager };