@axiom-lattice/core 2.1.94 → 2.1.96

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, MenuRegistry, A2AApiKeyStore, TaskStore, SharedResourceStore, 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, ResourceResolver, ResourceAddress, ShareVisibility, CreateShareRequest, ChannelAdapter, InternalStateField, InternalInput, InternalNode, InternalAgentNode, InternalMapNode, InternalDSL } 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, CollectionStore, WorkspaceStore, ProjectStore, DatabaseConfigStore, MetricsServerConfigStore, McpServerConfigStore, UserStore, TenantStore, UserTenantLinkStore, WorkflowTrackingStore, EvalStore, ChannelInstallationStore, BindingRegistry, MenuRegistry, A2AApiKeyStore, TaskStore, SharedResourceStore, ConnectionStore, VectorStoreProvider, 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, Collection, CreateCollectionRequest, UpdateCollectionRequest, MenuItem, CreateMenuItemInput, UpdateMenuItemInput, LoggerLatticeProtocol, LoggerConfig, LoggerClient, LoggerContext, SkillConfig, SkillClient, McpTool, ResourceResolver, ResourceAddress, ShareVisibility, CreateShareRequest, ChannelAdapter, PluginMeta, Plugin, PluginMetaOutput, InternalStateField, InternalInput, InternalNode, InternalAgentNode, InternalMapNode, InternalDSL, ConnectionEntry } from '@axiom-lattice/protocols';
 export { _axiom_lattice_protocols as Protocols };
 export { AgentConfig, AgentType, GraphBuildOptions, MemoryType } from '@axiom-lattice/protocols';
 import * as langchain from 'langchain';
@@ -16,12 +16,13 @@ import { ReactAgent, AgentMiddleware, StructuredTool as StructuredTool$1, Interr
 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 { StructuredTool, DynamicStructuredTool } from '@langchain/core/tools';
 import * as _langchain_langgraph from '@langchain/langgraph';
 import { CompiledStateGraph, CommandParams, AnnotationRoot } from '@langchain/langgraph';
 import { ReplaySubject } from 'rxjs';
 import { Embeddings } from '@langchain/core/embeddings';
 import { VectorStore } from '@langchain/core/vectorstores';
+import { DocumentInterface } from '@langchain/core/documents';
 import { Connection, MultiServerMCPClient } from '@langchain/mcp-adapters';
 import { SandboxClient } from '@agent-infra/sandbox';
 import { Sandbox } from 'e2b';
@@ -905,68 +906,57 @@ declare class CustomMetricsClient implements IMetricsServerClient {
  */
 declare class MetricsServerManager {
     private static instance;
-    private clients;
     private configs;
     private defaultServerKeys;
-    private _loadingPromise;
     private constructor();
     /**
      * Get the singleton instance
      */
     static getInstance(): MetricsServerManager;
     /**
-     * Ensure configurations are loaded from the store lattice.
-     * Uses a promise-lock to prevent concurrent loads.
+     * Get or create tenant configs map
      */
-    private _ensureLoaded;
+    private getTenantConfigs;
     /**
-     * Get or create tenant clients map
+     * Create a metrics client from config.
+     * Clients are stateless HTTP wrappers — cheap to create on every call.
      */
-    private getTenantClients;
+    private _createClient;
     /**
-     * Get or create tenant configs map
+     * Resolve a server config for a tenant. Queries the store for freshness.
+     * When store has no data, falls back to in-memory cache.
      */
-    private getTenantConfigs;
+    private _resolveConfig;
     /**
-     * Register a metrics server for a tenant
-     * @param tenantId - Tenant identifier
-     * @param key - Unique identifier for the server
-     * @param config - Metrics server configuration
+     * Register a metrics server for a tenant. Stores config in memory
+     * for fallback / programmatic registration use.
      */
     registerServer(tenantId: string, key: string, config: MetricsServerConfig): void;
     /**
      * Set the default metrics server for a tenant
-     * @param tenantId - Tenant identifier
-     * @param key - Server key to set as default
      */
     setDefaultServer(tenantId: string, key: string): void;
     /**
-     * Get a metrics server client by key for a specific tenant
-     * @param tenantId - Tenant identifier
-     * @param key - Server key (optional, uses default if not provided)
+     * Get a metrics server client for a tenant.
+     * Always queries the store for the latest config, creates a fresh client.
+     * Falls back to in-memory cache when store is unavailable.
      */
     getClient(tenantId: string, key?: string): Promise<IMetricsServerClient>;
     /**
-     * Get metrics server configuration by key for a specific tenant
-     * @param tenantId - Tenant identifier
-     * @param key - Server key (optional, uses default if not provided)
+     * Get metrics server configuration for a tenant.
+     * Always queries the store for freshness.
+     * Falls back to in-memory cache when store is unavailable.
      */
     getConfig(tenantId: string, key?: string): Promise<MetricsServerConfig>;
     /**
-     * Ensure server configs are loaded from the store.
-     * Public wrapper around the internal lazy-loading mechanism.
-     * Safe to call multiple times — loading happens at most once.
-     */
-    ensureLoaded(): Promise<void>;
-    /**
-     * Check if a metrics server is registered for a tenant
-     * @param tenantId - Tenant identifier
-     * @param key - Server key
+     * Check if a metrics server exists in the in-memory cache.
+     * For store-backed existence checks, use getClient() or getConfig().
      */
     hasServer(tenantId: string, key: string): boolean;
     /**
-     * Get all registered metrics server keys with their types for a tenant
-     * @param tenantId - Tenant identifier
+     * Get all registered metrics server keys for a tenant.
+     * Queries the store directly. Falls back to in-memory cache
+     * when the store has no data for this tenant.
      */
     getServerKeys(tenantId: string): Promise<{
         key: string;
@@ -975,13 +965,10 @@ declare class MetricsServerManager {
     }[]>;
     /**
      * Remove a metrics server for a tenant
-     * @param tenantId - Tenant identifier
-     * @param key - Server key
      */
     removeServer(tenantId: string, key: string): void;
     /**
      * Clear all metrics servers for a tenant
-     * @param tenantId - Tenant identifier (optional, clears all if not provided)
      */
     clear(tenantId?: string): void;
     /**
@@ -1719,6 +1706,8 @@ interface MiddlewareConfig {
     name: string;
     description: string;
     enabled: boolean;
+    /** 可选：限制该中间件暴露的工具列表。不配置则默认暴露所有工具 */
+    allowedTools?: string[];
     config: Record<string, any>;
 }
 interface AgentBuildParams {
@@ -2707,6 +2696,7 @@ type StoreTypeMap = {
     thread: ThreadStore;
     assistant: AssistantStore;
     skill: SkillStore;
+    collection: CollectionStore;
     workspace: WorkspaceStore;
     project: ProjectStore;
     database: DatabaseConfigStore;
@@ -2724,6 +2714,7 @@ type StoreTypeMap = {
     a2aApiKey: A2AApiKeyStore;
     task: TaskStore;
     sharedResource: SharedResourceStore;
+    connection: ConnectionStore;
 };
 /**
  * Store type keys
@@ -2826,6 +2817,7 @@ type Store = Partial<{
 }> & {
     schedule?: object;
     checkpoint?: object;
+    vectorStoreProvider?: VectorStoreProvider;
 };
 /**
  * Replace stores in the "default" lattice with the given implementations.
@@ -3540,6 +3532,44 @@ declare class InMemoryTaskStore implements TaskStore {
     clear(tenantId?: string): void;
 }
 
+/**
+ * InMemoryCollectionStore
+ *
+ * In-memory implementation of CollectionStore
+ * Provides CRUD operations for collection metadata stored in memory
+ */
+
+/**
+ * In-memory implementation of CollectionStore with tenant isolation
+ */
+declare class InMemoryCollectionStore implements CollectionStore {
+    private collections;
+    /**
+     * Get all collections for a tenant
+     */
+    getAllCollections(tenantId: string): Promise<Collection[]>;
+    /**
+     * Get collection by name
+     */
+    getCollectionByName(tenantId: string, name: string): Promise<Collection | null>;
+    /**
+     * Create a new collection
+     */
+    createCollection(tenantId: string, data: CreateCollectionRequest): Promise<Collection>;
+    /**
+     * Update an existing collection
+     */
+    updateCollection(tenantId: string, name: string, updates: UpdateCollectionRequest): Promise<Collection | null>;
+    /**
+     * Delete a collection by name
+     */
+    deleteCollection(tenantId: string, name: string): Promise<boolean>;
+    /**
+     * Clear all collections for a tenant (useful for testing)
+     */
+    clear(tenantId?: string): void;
+}
+
 declare class InMemoryMenuStore implements MenuRegistry {
     private items;
     list(params: {
@@ -3562,6 +3592,11 @@ declare class InMemoryMenuStore implements MenuRegistry {
 interface EmbeddingsLatticeInterface {
     key: string;
     client: Embeddings;
+    label: string;
+}
+interface EmbeddingsInfo {
+    key: string;
+    label: string;
 }
 /**
  * EmbeddingsLatticeManager - Singleton embeddings Lattice manager
@@ -3581,8 +3616,13 @@ declare class EmbeddingsLatticeManager extends BaseLatticeManager<EmbeddingsLatt
      * Register embeddings Lattice
      * @param key Lattice key name
      * @param embeddings Embeddings instance
+     * @param label Optional display label (auto-derived if not provided)
      */
-    registerLattice(key: string, embeddings: Embeddings): void;
+    registerLattice(key: string, embeddings: Embeddings, label?: string): void;
+    /**
+     * Get all registered embeddings as { key, label } info list
+     */
+    getAllEmbeddingsInfo(): EmbeddingsInfo[];
     /**
      * Get EmbeddingsLattice
      * @param key Lattice key name
@@ -3621,7 +3661,7 @@ declare class EmbeddingsLatticeManager extends BaseLatticeManager<EmbeddingsLatt
     getEmbeddingsClient(key: string): Embeddings;
 }
 declare const embeddingsLatticeManager: EmbeddingsLatticeManager;
-declare const registerEmbeddingsLattice: (key: string, embeddings: Embeddings) => void;
+declare const registerEmbeddingsLattice: (key: string, embeddings: Embeddings, label?: string) => void;
 declare const getEmbeddingsLattice: (key: string) => EmbeddingsLatticeInterface;
 declare const getEmbeddingsClient: (key: string) => Embeddings<number[]>;
 
@@ -3695,6 +3735,64 @@ declare const registerVectorStoreLattice: (key: string, vectorStore: VectorStore
 declare const getVectorStoreLattice: (key: string) => VectorStoreLatticeInterface;
 declare const getVectorStoreClient: (key: string) => VectorStore;
 
+/**
+ * VectorStoreProviderManager
+ *
+ * Singleton registry for VectorStoreProvider instances.
+ * Each provider key maps to a backend (memory, pgvector, chroma, etc.).
+ * Follows the same pattern as EmbeddingsLatticeManager.
+ */
+
+/**
+ * VectorStoreProvider Lattice Interface
+ */
+interface VectorStoreProviderLattice {
+    key: string;
+    provider: VectorStoreProvider;
+}
+/**
+ * VectorStoreProviderManager - Singleton provider Lattice manager
+ * Responsible for registering and managing VectorStoreProvider backends
+ */
+declare class VectorStoreProviderManager extends BaseLatticeManager<VectorStoreProviderLattice> {
+    private static _instance;
+    /**
+     * Get VectorStoreProviderManager singleton instance
+     */
+    static getInstance(): VectorStoreProviderManager;
+    /**
+     * Get Lattice type prefix
+     */
+    protected getLatticeType(): string;
+    /**
+     * Register a VectorStore provider
+     * @param key Provider key name
+     * @param provider VectorStoreProvider implementation
+     */
+    registerProvider(key: string, provider: VectorStoreProvider): void;
+    /**
+     * Get a VectorStore provider by key
+     * @param key Provider key name
+     * @returns VectorStoreProvider instance
+     */
+    getProvider(key: string): VectorStoreProvider;
+    /**
+     * Get all registered providers
+     */
+    getAllProviders(): VectorStoreProviderLattice[];
+    /**
+     * Check if provider exists
+     */
+    hasProvider(key: string): boolean;
+    /**
+     * Remove a provider
+     */
+    removeProvider(key: string): boolean;
+}
+declare const vectorStoreProviderManager: VectorStoreProviderManager;
+declare const registerVectorStoreProvider: (key: string, provider: VectorStoreProvider) => void;
+declare const getVectorStoreProvider: (key: string) => VectorStoreProvider;
+
 /**
  * LoggerLatticeManager
  *
@@ -4080,11 +4178,106 @@ declare function getBuiltInSkillNames(): string[];
  */
 declare function isBuiltInSkill(name: string): boolean;
 
+/**
+ * CollectionLatticeManager
+ *
+ * Pure store facade for collection metadata management.
+ * All reads go directly to the configured CollectionStore — no in-memory cache.
+ * VectorStore lifecycle (create/destroy) is handled by the gateway service layer.
+ */
+
+/**
+ * CollectionLatticeManager - Singleton manager for collection metadata.
+ * Every operation reads/writes the configured CollectionStore from StoreLatticeManager.
+ * No in-memory cache — data always comes from the store.
+ */
+declare class CollectionLatticeManager {
+    private static _instance;
+    static getInstance(): CollectionLatticeManager;
+    private getStore;
+    registerCollection(tenantId: string, data: CreateCollectionRequest): Promise<Collection>;
+    getCollection(tenantId: string, name: string): Promise<Collection | null>;
+    getAllCollections(tenantId: string): Promise<Collection[]>;
+    removeCollection(tenantId: string, name: string): Promise<boolean>;
+    updateCollection(tenantId: string, name: string, updates: UpdateCollectionRequest): Promise<Collection | null>;
+}
+declare const collectionLatticeManager: CollectionLatticeManager;
+
+/**
+ * CollectionVectorStoreHelper
+ *
+ * Provides helpers for managing tenant-isolated VectorStore instances per collection.
+ * Delegates creation to the registered VectorStoreProvider.
+ *
+ * Key format: "{tenantId}:{collectionName}"
+ * Table format: "tenant_{tenantId}_{collectionName}"
+ */
+
+declare function buildTableName(tenantId: string, name: string): string;
+/**
+ * Get or create a tenant-isolated VectorStore for a collection.
+ */
+declare function getOrCreateCollectionVectorStore(name: string, embeddingKey: string, tenantId: string, providerKey?: string): Promise<any>;
+/**
+ * Get entry count for a collection.
+ * Tries vector store's native method first, falls back to provider.
+ */
+declare function getCollectionEntryCount(name: string, embeddingKey: string, tenantId: string): Promise<number>;
+/**
+ * List all entries in a collection.
+ * Tries vector store's native method first, falls back to provider.
+ */
+declare function listCollectionEntries(name: string, embeddingKey: string, tenantId: string): Promise<DocumentInterface[]>;
+/**
+ * Remove a tenant-isolated vector store registration and drop the underlying table.
+ */
+declare function removeCollectionVectorStore(name: string, tenantId: string): Promise<void>;
+
+/**
+ * SimpleMemoryVectorStore
+ *
+ * Minimal in-memory VectorStore implementation that satisfies the LangChain
+ * VectorStore interface. Used as the default backend when no external vector
+ * store (PGVector, Chroma, etc.) is registered.
+ */
+
+declare class SimpleMemoryVectorStore extends VectorStore {
+    _vectorstoreType(): string;
+    private vectors;
+    constructor(embeddings: Embeddings);
+    /**
+     * Add pre-computed vectors with their documents.
+     */
+    addVectors(vectors: number[][], documents: DocumentInterface[], _options?: Record<string, unknown>): Promise<string[]>;
+    /**
+     * Add documents (will be embedded automatically by the VectorStore base class).
+     */
+    addDocuments(documents: DocumentInterface[], _options?: Record<string, unknown>): Promise<string[]>;
+    /**
+     * Delete documents by filter.
+     */
+    delete(params?: Record<string, unknown>): Promise<void>;
+    /**
+     * Similarity search with vector and scores.
+     */
+    similaritySearchVectorWithScore(query: number[], k: number, filter?: this["FilterType"]): Promise<[DocumentInterface, number][]>;
+    /**
+     * Get all stored documents (non-standard, used for listing entries).
+     */
+    getAllDocuments(): DocumentInterface[];
+    /**
+     * Get document count.
+     */
+    getDocumentCount(): number;
+}
+
 /**
  * McpLatticeManager
  *
- * MCP Lattice Manager - Manages MCP client connections using MultiServerMCPClient
- * Follows the singleton pattern for global access
+ * MCP Lattice Manager - Manages MCP client connections.
+ * Each MCP server gets its own independent MultiServerMCPClient instance,
+ * so adding/removing servers never affects other servers' connections or tools.
+ * Follows the singleton pattern for global access.
  */
 
 interface McpServerInfo {
@@ -4097,24 +4290,71 @@ interface McpLatticeInterface {
 }
 declare class McpLatticeManager extends BaseLatticeManager<McpLatticeInterface> {
     private static _instance;
-    private client;
+    /** One MultiServerMCPClient per server, keyed by server name */
+    private clients;
+    /** Server connection configs, keyed by server name */
     private servers;
+    /** Track registered tool keys per server for cleanup */
+    private registeredToolKeys;
     static getInstance(): McpLatticeManager;
     protected getLatticeType(): string;
     registerServers(servers: McpServerInfo[]): void;
     addServer(name: string, connection: Connection): void;
-    removeServer(name: string): boolean;
+    /**
+     * Remove a server. Closes its client and unregisters its tools.
+     */
+    removeServer(name: string): Promise<boolean>;
+    /**
+     * Connect all registered servers that are not yet connected.
+     * Each server gets its own MultiServerMCPClient instance.
+     * Existing connections are not affected.
+     */
     connect(): Promise<void>;
+    /**
+     * Reconnect a single server: close old client, create new one, re-register tools.
+     */
+    reconnectServer(name: string): Promise<void>;
     disconnect(): Promise<void>;
     isConnected(): boolean;
-    getAllTools(): Promise<any[]>;
+    isServerConnected(name: string): boolean;
+    /**
+     * Get tools from a specific server using raw MCP protocol.
+     * Returns native JSON schema tools — suitable for API responses.
+     */
+    getServerTools(serverName: string): Promise<McpTool[]>;
+    /**
+     * Get all tools from all servers as McpTool[] (API format).
+     */
+    getAllTools(): Promise<McpTool[]>;
+    /**
+     * Get raw LangChain DynamicStructuredTool objects for ToolLattice registration.
+     * Optionally filtered by server name.
+     */
+    getRawTools(serverName?: string): Promise<DynamicStructuredTool[]>;
     getServerNames(): string[];
     hasServer(name: string): boolean;
     /**
-     * 将 MCP 工具注册到 Tool Lattice
-     * @param prefix 工具键名前缀，用于区分不同服务器的工具
+     * Build the tool lattice key for an MCP tool.
+     */
+    static buildToolKey(serverName: string, toolName: string): string;
+    /**
+     * Unregister all tools for a specific server from ToolLattice.
      */
-    registerToolsToToolLattice(prefix?: string): Promise<void>;
+    unregisterServerTools(serverName: string): void;
+    /**
+     * Register MCP tools from a specific server to Tool Lattice.
+     * Tools are registered with key pattern: mcp:{serverName}:{toolName}
+     * Only registers tools whose names are in selectedTools (if provided).
+     */
+    registerToolsToToolLattice(serverName: string, selectedTools?: string[]): Promise<void>;
+    /**
+     * Test a single MCP server connection using a standalone client.
+     * Does not affect the global mcpManager state.
+     */
+    static testConnection(serverName: string, connection: Connection): Promise<{
+        tools: McpTool[];
+        latency: number;
+    }>;
 }
 declare const mcpManager: McpLatticeManager;
 
@@ -6632,6 +6872,8 @@ type CustomMiddlewareFactory = (config: Record<string, any>) => Promise<AgentMid
  * modifying core source code. Once registered, middleware can be enabled per-agent via
  * the database config using `type: "custom"` in the agent's `graphDefinition.middleware` array.
  *
+ * Internally bridges to PluginRegistry for unified discovery.
+ *
  * @example Register and use
  * ```ts
  * // 1. App startup — register a factory
@@ -6651,6 +6893,9 @@ type CustomMiddlewareFactory = (config: Record<string, any>) => Promise<AgentMid
  * // }
  * ```
  *
+ * @deprecated New plugins should use PluginRegistry.register(plugin) instead.
+ * This class is maintained for backward compatibility.
+ *
  * @remarks
  * - Register factories **before** building agents (typically at app startup).
  * - Duplicate keys overwrite previous registrations.
@@ -6661,21 +6906,17 @@ declare class CustomMiddlewareRegistry {
     /**
      * Register a custom middleware factory under the given key.
      *
-     * The key is referenced by `config.key` in the database middleware configuration.
-     * When an agent is built, the framework looks up this key and calls the factory
-     * with the remaining config fields.
+     * Supports three calling conventions:
+     * - register(key, factory) — legacy, wraps factory as anonymous Plugin
+     * - register(key, factory, meta) — legacy with optional meta
+     *
+     * For new code, prefer PluginRegistry.register(plugin).
      *
      * @param key - Unique identifier, referenced in database config as `config.key`
      * @param factory - Function that receives config (minus `key`) and returns an AgentMiddleware
-     *
-     * @example
-     * ```ts
-     * CustomMiddlewareRegistry.register("my-logger", (config) =>
-     *   createMiddleware({ name: "Logger", beforeAgent: async () => { ... } }),
-     * );
-     * ```
+     * @param deprecatedMeta - Optional metadata for API discovery
      */
-    static register(key: string, factory: CustomMiddlewareFactory): void;
+    static register(key: string, factory: CustomMiddlewareFactory, deprecatedMeta?: Partial<PluginMeta>): void;
     /**
      * Remove a previously registered factory.
      *
@@ -6692,18 +6933,48 @@ declare class CustomMiddlewareRegistry {
     static get(key: string): CustomMiddlewareFactory | undefined;
     /**
      * Check whether a factory is registered under the given key.
-     *
-     * @param key - The factory key to check
      */
     static has(key: string): boolean;
     /**
      * Get all currently registered factory keys.
-     *
-     * @returns Array of registered key strings
      */
     static list(): string[];
 }
 
+/**
+ * Plugin registry.
+ *
+ * Manages plugin registration, lookup, and meta serialization.
+ * Discovery layer only — runtime dispatch stays in commonMiddleware.ts.
+ */
+declare class PluginRegistry {
+    private static plugins;
+    /** Register a plugin (overwrites if type conflicts) */
+    static register(plugin: Plugin): void;
+    /** Unregister */
+    static unregister(key: string): boolean;
+    /** Get plugin instance */
+    static get(key: string): Plugin | undefined;
+    /** Check if registered */
+    static has(key: string): boolean;
+    /** List all registered plugin keys */
+    static list(): string[];
+    /** Serialize all registered plugins to API-ready meta list */
+    static listMeta(): PluginMetaOutput[];
+}
+
+/**
+ * Serialize a Plugin instance into the API-ready PluginMeta shape.
+ *
+ * Auto-detection:
+ * - tools: meta.tools first, fallback to tryExtractTools
+ * - hasTest: connection.test method exists
+ * - hasDiscover: connection.discover method exists
+ */
+declare function serializePluginMeta(plugin: Plugin): PluginMetaOutput;
+
+declare const BUILTIN_PLUGINS: Plugin[];
+
 /**
  * Create middleware that provides widget rendering capabilities.
  *
@@ -6964,4 +7235,15 @@ declare class PersonalAssistantConfig {
     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 CacheEntry, 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, LocalSandboxInstance, LocalSandboxProvider, type LocalSandboxProviderConfig, 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 SharePayload, 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, TokenCache, 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, createResourceAddress, createSandboxProvider, createSchedulerMiddleware, createSharePayload, createTaskMiddleware, createTeamMiddleware, createTeammateTools, createUnknownToolHandlerMiddleware, createWidgetMiddleware, decrypt, describeCronExpression, embeddingsLatticeManager, encrypt, ensureBuiltinAgentsForTenant, eventBus, eventBus as eventBusDefault, extractFetcherError, extractOutput, fileDataToString, formatContentWithLineNumbers, formatGrepMatches, formatGrepResults, formatReadResponse, generateToken, 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 };
+declare class ConnectionRegistry {
+    private static store;
+    static setStore(store: ConnectionStore): void;
+    static list(type: string, tenantId: string): Promise<ConnectionEntry[]>;
+    static get(type: string, key: string, tenantId: string): Promise<ConnectionEntry | null>;
+    static create(entry: Omit<ConnectionEntry, "id" | "createdAt" | "updatedAt">): Promise<ConnectionEntry>;
+    static update(tenantId: string, type: string, key: string, updates: Partial<ConnectionEntry>): Promise<ConnectionEntry | null>;
+    static delete(tenantId: string, type: string, key: string): Promise<boolean>;
+    private static ensureStore;
+}
+
+export { AGENT_TASK_EVENT, type AddMessageParams, Agent, type AgentClient, type AgentExecutor, AgentInstanceManager, type AgentLattice, AgentLatticeManager, type AgentLifecycleEventName, AgentManager, type AgentStreamExecutor, type AgentThreadInterface, BUILTIN_PLUGINS, BUILTIN_SKILLS, type BackendFactory, type BackendProtocol, type BufferStats, type CacheEntry, type Chunk, ChunkBuffer, ChunkBufferLatticeManager, CollectionLatticeManager, type ColumnInfo, CompositeBackend, type ConnectAllChannelsOptions, ConnectionRegistry, 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 EmbeddingsInfo, 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, InMemoryCollectionStore, InMemoryDatabaseConfigStore, InMemoryMailboxStore, InMemoryMenuStore, InMemoryTaskListStore, InMemoryTaskStore, InMemoryTenantStore, InMemoryThreadMessageQueueStore, InMemoryThreadStore, InMemoryUserStore, InMemoryUserTenantLinkStore, LINE_NUMBER_WIDTH, type LangGraphStateChecker, LocalSandboxInstance, LocalSandboxProvider, type LocalSandboxProviderConfig, 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, PluginRegistry, 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 SharePayload, SimpleMemoryVectorStore, 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, TokenCache, type ToolDefinition, type ToolLattice, ToolLatticeManager, type TopologyEdge, type UnknownToolHandlerConfig, type VectorStoreLatticeInterface, VectorStoreLatticeManager, type VectorStoreProviderLattice, VectorStoreProviderManager, VolumeFilesystem, type VolumeFsClient, type WorkflowValidationError, type WriteResult, agentInstanceManager, agentLatticeManager, buildGrepResultsDict, buildInput, buildNamedVolumeName, buildSandboxMetadataEnv, buildSkillFile, buildStateAnnotation, buildTableName, checkEmptyContent, clearEncryptionKeyCache, collectionLatticeManager, compileInternal, compileWorkflow, computeSandboxName, configureStores, connectAllChannels, createAgentNode, createAgentTeam, createExecuteSqlQueryTool, createFileData, createInfoSqlTool, createListMetricsDataSourcesTool, createListMetricsServersTool, createListTablesSqlTool, createMapNode, createModelSelectorMiddleware, createNodeHandler, createProcessingAgent, createQueryCheckerSqlTool, createQueryMetricDefinitionTool, createQueryMetricsListTool, createQuerySemanticMetricDataTool, createQuerySqlTool, createQueryTableDefinitionTool, createQueryTablesListTool, createResourceAddress, createSandboxProvider, createSchedulerMiddleware, createSharePayload, createTaskMiddleware, createTeamMiddleware, createTeammateTools, createUnknownToolHandlerMiddleware, createWidgetMiddleware, decrypt, describeCronExpression, embeddingsLatticeManager, encrypt, ensureBuiltinAgentsForTenant, eventBus, eventBus as eventBusDefault, extractFetcherError, extractOutput, fileDataToString, formatContentWithLineNumbers, formatGrepMatches, formatGrepResults, formatReadResponse, generateToken, getAgentClient, getAgentConfig, getAllAgentConfigs, getAllBuiltInSkillMetas, getAllToolDefinitions, getBindingRegistry, getBuiltInSkillContent, getBuiltInSkillMeta, getBuiltInSkillNames, getCheckpointSaver, getChunkBuffer, getCollectionEntryCount, getEmbeddingsClient, getEmbeddingsLattice, getEncryptionKey, getLoggerLattice, getMenuRegistry, getModelLattice, getNextCronTime, getOrCreateCollectionVectorStore, getQueueLattice, getSandBoxManager, getScheduleLattice, getStoreLattice, getToolClient, getToolDefinition, getToolLattice, getVectorStoreClient, getVectorStoreLattice, getVectorStoreProvider, globSearchFiles, grepMatchesFromFiles, grepSearchFiles, hasChunkBuffer, invokeWithRetry, isBuiltInSkill, isUsingDefaultKey, isValidCronExpression, isValidSandboxName, isValidSkillName, listCollectionEntries, 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, registerVectorStoreProvider, removeCollectionVectorStore, renderTemplate, resolvePath, sandboxLatticeManager, sanitizeToolCallId, scheduleLatticeManager, serializePluginMeta, setBindingRegistry, setMenuRegistry, skillLatticeManager, sqlDatabaseManager, storeLatticeManager, toJsonSchema, toSafeStateExpr, toolLatticeManager, truncateIfTooLong, unregisterTeammateAgent, updateFileData, validateAgentInput, validateDSL, validateEncryptionKey, validatePath, validateSkillName, validateToolInput, vectorStoreLatticeManager, vectorStoreProviderManager };