@mcp-abap-adt/llm-agent-server-libs 18.1.0

package/dist/smart-agent/smart-server.d.ts

@@ -0,0 +1,525 @@
+/**
+ * SmartServer — embeddable OpenAI-compatible HTTP server backed by SmartAgent.
+ */
+import type { EmbedderFactory, IClientAdapter, IEmbedder, IKnowledgeRagHandle, ILlm, ILlmApiAdapter, ILogger, IMcpClient, IModelResolver, IRagRegistry, IRequestLogger, ISkillManager } from '@mcp-abap-adt/llm-agent';
+import { type IRag } from '@mcp-abap-adt/llm-agent';
+import type { IPluginLoader, SessionAgentParts, SessionGraph, SmartAgent } from '@mcp-abap-adt/llm-agent-libs';
+import { SessionRegistry } from '@mcp-abap-adt/llm-agent-libs';
+import type { PipelineConfig } from './pipeline.js';
+import { resolveSessionIdentity } from './session-identity-resolver.js';
+export interface SmartServerLlmConfig {
+    /** Provider id for the flat schema. Required when no pipeline.llm.main is set. */
+    provider?: 'deepseek' | 'openai' | 'anthropic' | 'sap-ai-sdk' | 'ollama';
+    apiKey: string;
+    /** Custom base URL (OpenAI-compatible endpoints: Ollama, Azure, vLLM). */
+    url?: string;
+    model?: string;
+    temperature?: number;
+    maxTokens?: number;
+    classifierTemperature?: number;
+}
+export interface SmartServerRagConfig {
+    type?: 'in-memory' | 'qdrant' | 'hana-vector' | 'pg-vector';
+    /**
+     * Embedder name — resolved from the embedder factory registry.
+     * Built-in: 'ollama', 'openai', 'sap-ai-core'. Consumers can register custom factories.
+     * When omitted, defaults to 'ollama' for stores that require one.
+     */
+    embedder?: string;
+    url?: string;
+    model?: string;
+    collectionName?: string;
+    dedupThreshold?: number;
+    vectorWeight?: number;
+    keywordWeight?: number;
+    connectionString?: string;
+    host?: string;
+    port?: number;
+    user?: string;
+    password?: string;
+    database?: string;
+    schema?: string;
+    dimension?: number;
+    autoCreateSchema?: boolean;
+    poolMax?: number;
+    connectTimeout?: number;
+    /** SAP AI Core resource group (used when embedder is 'sap-ai-core' / 'sap-aicore'). */
+    resourceGroup?: string;
+    /**
+     * SAP AI Core scenario for the embedding model deployment.
+     * `'orchestration'` (default) uses the SAP SDK; `'foundation-models'` calls the REST inference API.
+     */
+    scenario?: 'orchestration' | 'foundation-models';
+}
+export interface SmartServerMcpConfig {
+    type: 'http' | 'stdio';
+    url?: string;
+    command?: string;
+    args?: string[];
+    headers?: Record<string, string>;
+}
+export interface SmartServerAgentConfig {
+    externalToolsValidationMode?: 'permissive' | 'strict';
+    maxIterations?: number;
+    maxToolCalls?: number;
+    toolUnavailableTtlMs?: number;
+    ragQueryK?: number;
+    contextBudgetTokens?: number;
+    semanticHistoryEnabled?: boolean;
+    historyRecencyWindow?: number;
+    historyTurnSummaryPrompt?: string;
+    showReasoning?: boolean;
+    historyAutoSummarizeLimit?: number;
+    queryExpansionEnabled?: boolean;
+    toolResultCacheTtlMs?: number;
+    sessionTokenBudget?: number;
+    /** Whether classification stage runs. Default: true. */
+    classificationEnabled?: boolean;
+    /** LLM call strategy for tool-loop. 'streaming' (default) | 'non-streaming' | 'fallback'. */
+    llmCallStrategy?: 'streaming' | 'non-streaming' | 'fallback';
+    /** Tool-selection strategy over RAG results. Default: top-k. */
+    toolSelection?: {
+        strategy: string;
+        minScore?: number;
+    };
+}
+export interface SmartServerPromptsConfig {
+    system?: string;
+    classifier?: string;
+    reasoning?: string;
+    ragTranslate?: string;
+    historySummary?: string;
+}
+export interface SmartServerSkillsConfig {
+    /** Manager type: 'claude' | 'codex' | 'filesystem'. Default: 'claude'. */
+    type?: 'claude' | 'codex' | 'filesystem';
+    /** Custom directories (filesystem type only). */
+    dirs?: string[];
+    /** Project root for relative skill dirs (claude/codex types). Defaults to cwd. */
+    projectRoot?: string;
+}
+export type SmartServerMode = 'hard' | 'pass' | 'smart';
+export interface SmartServerCircuitBreakerConfig {
+    /** Number of consecutive failures before opening. Default: 5 */
+    failureThreshold?: number;
+    /** Time (ms) to wait before probing again. Default: 30 000 */
+    recoveryWindowMs?: number;
+}
+export interface SmartServerConfig {
+    port?: number;
+    host?: string;
+    llm?: SmartServerLlmConfig | Record<string, SmartServerLlmConfig>;
+    rag?: SmartServerRagConfig;
+    mcp?: SmartServerMcpConfig | SmartServerMcpConfig[];
+    agent?: SmartServerAgentConfig;
+    prompts?: SmartServerPromptsConfig;
+    mode?: SmartServerMode;
+    pipeline?: PipelineConfig;
+    log?: (event: Record<string, unknown>) => void;
+    logDir?: string;
+    circuitBreaker?: SmartServerCircuitBreakerConfig;
+    version?: string;
+    /** Path to YAML config file for hot-reload. */
+    configFile?: string;
+    /** Additional plugin directory (merged with defaults). Used by the default FileSystemPluginLoader. */
+    pluginDir?: string;
+    /** Custom plugin loader. When set, replaces the default FileSystemPluginLoader. */
+    pluginLoader?: IPluginLoader;
+    /** Pre-built embedder injected via DI. Takes precedence over config-driven selection. */
+    embedder?: IEmbedder;
+    /** Named embedder factories for YAML-driven selection (merged with built-ins). */
+    embedderFactories?: Record<string, EmbedderFactory>;
+    /**
+     * Skill discovery configuration from YAML.
+     *
+     * `type`: Manager variant — `'claude'` | `'codex'` | `'filesystem'`.
+     * `dirs`: Custom directories (filesystem type only).
+     * `projectRoot`: Project root for relative skill dirs (claude/codex types).
+     *
+     * When omitted and no `skillManager` is injected, skills are disabled.
+     */
+    skills?: SmartServerSkillsConfig;
+    /** Pre-built skill manager injected via DI. Takes precedence over `skills` config. */
+    skillManager?: ISkillManager;
+    /** Pre-built MCP clients injected via DI. Takes precedence over `mcp` config. */
+    mcpClients?: IMcpClient[];
+    /** Client adapters for auto-detecting prompt-based clients (e.g. Cline). */
+    clientAdapters?: IClientAdapter[];
+    /** Whether to include usage stats in SSE stream. Default: true. */
+    reportUsage?: boolean;
+    /** API protocol adapters injected via DI. Merged with built-in adapters (openai, anthropic). */
+    apiAdapters?: ILlmApiAdapter[];
+    /** Disable built-in adapter auto-registration. Default: false. */
+    disableBuiltInAdapters?: boolean;
+    /** Skip startup model validation (useful for testing). Default: false. */
+    skipModelValidation?: boolean;
+    /** Model resolver for PUT /v1/config model changes. When not set, model updates are rejected with 400. */
+    modelResolver?: IModelResolver;
+    /**
+     * Nested sub-agents loaded from a top-level `subagents:` YAML block.
+     * Each entry is built into a `SmartAgentSubAgent` and registered via
+     * `SmartAgentBuilder.withSubAgents(...)`.
+     */
+    subAgentConfigs?: SmartServerSubAgentConfig[];
+    /**
+     * Raw coordinator YAML block. Translated to concrete strategy instances by
+     * `SmartServer.start()` once the parent LLMs are built.
+     */
+    coordinatorYaml?: import('./config.js').YamlCoordinator;
+    /**
+     * Per-session lifecycle tuning. Defaults: idleTtlMs=7_200_000 (2h),
+     * maxSessions=1000, cookieName='sid'.
+     */
+    session?: {
+        idleTtlMs?: number;
+        maxSessions?: number;
+        cookieName?: string;
+    };
+}
+/**
+ * A nested sub-agent declared via the top-level `subagents:` YAML block.
+ * The `config` field is the resolved `SmartServerConfig` for the sub-agent
+ * (without `subagents:` of its own — nested orchestration is not supported).
+ */
+export interface SmartServerSubAgentConfig {
+    name: string;
+    /**
+     * Human-readable capability description. Surfaced to the Coordinator's
+     * planner LLM so it can pick the right subagent per step. Optional, but
+     * highly recommended — without it the planner sees `(no description)` and
+     * routes by name alone.
+     */
+    description?: string;
+    config: Omit<SmartServerConfig, 'log'>;
+}
+export interface SmartServerHandle {
+    port: number;
+    close(): Promise<void>;
+    requestLogger: IRequestLogger;
+}
+import type { ISessionMetaStore, SessionMetaRow } from './session-meta-store.js';
+export { generateConfigTemplate, loadYamlConfig, type ResolveConfigArgs, resolveCoordinatorActivation, resolveCoordinatorDispatch, resolveCoordinatorPlanning, resolveEnvVars, resolveSmartServerConfig, resolveToolSelectionStrategy, YAML_TEMPLATE, type YamlConfig, } from './config.js';
+/**
+ * GLOBAL per-worker heavy clients — built once, injected by reference per
+ * session. In addition to LLM/embedder clients, the worker's OWN declared
+ * `toolsRag`/`historyRag`/`mcpClients` (if any) are cached here too — the
+ * per-session re-wire MUST prefer the worker's own resources over the
+ * parent's injected ones, so we build them once and reuse by reference.
+ */
+export interface WorkerLlmSet {
+    mainLlm: ILlm;
+    classifierLlm: ILlm;
+    helperLlm?: ILlm;
+    embedder?: IEmbedder;
+    /** Worker's OWN tools RAG, built from `subCfg.rag` if declared. */
+    toolsRag?: IRag;
+    /** Worker's OWN history RAG (mirrors flat-rag block, separate instance). */
+    historyRag?: IRag;
+    /**
+     * Worker's OWN MCP clients (from `subCfg.mcpClients` DI or built once from
+     * `subCfg.mcp`). Undefined means the worker did not declare any — caller
+     * may fall back to the parent's injected clients.
+     */
+    mcpClients?: IMcpClient[];
+    /**
+     * Shutdown function returned by the builder's `SmartAgentHandle.close()`
+     * for this worker (Fix #21). Disconnects MCP clients (and any other
+     * builder-owned resources) registered to this worker. Captured by
+     * `backfillWorkerCacheFromHandle` so `_drainWorkerCache()` can call it on
+     * config-reload (PUT /v1/config + hot-reload) and on server shutdown —
+     * without this, the per-worker handle is discarded by `buildSubAgent` and
+     * lazy rebuilds (Fix #18) accumulate MCP connections with no close path.
+     */
+    close?: () => Promise<void>;
+}
+/**
+ * Drain every cached worker's `close` (if any), then clear the cache map.
+ * Used by config-reload (PUT /v1/config + hot-reload — Fix #14/18/21) and by
+ * server `close()` to release per-worker MCP connections that were attached
+ * to the discarded `SmartAgentHandle`s.
+ *
+ * IMPORTANT — in-flight caveat: this aborts any request that is mid-call on
+ * a worker's MCP client. That is acceptable for an admin action (config
+ * reload, server shutdown) where the alternative is leaking connections.
+ * Server `close()` calls this AFTER `lifecycle.disposeAll()` so per-session
+ * graphs that reference worker clients are torn down first.
+ *
+ * Uses `Promise.allSettled` so one failing close cannot block the others.
+ */
+export declare function drainWorkerCache(cache: Map<string, WorkerLlmSet>): Promise<void>;
+/**
+ * Build-once-per-worker resolver. The first time a worker name is seen, it
+ * constructs the worker's main/classifier/(optional helper) LLM + embedder and
+ * caches the set; every later call (e.g. each per-session worker re-wire)
+ * returns the SAME set by reference — never reconstructing LLM clients
+ * (locked invariant: LLM/embedder clients are global, built once).
+ *
+ * Accepts optional `makeToolsRag`/`makeHistoryRag`/`makeMcpClients` factories;
+ * when provided, the resolver builds them ONCE on the first miss and caches
+ * them on the returned set. Subsequent calls return the cached resources by
+ * reference — never re-vectorizing or re-connecting MCP.
+ */
+export declare function resolveWorkerLlmSet(input: {
+    name: string;
+    cache: Map<string, WorkerLlmSet>;
+    makeMain: () => Promise<ILlm>;
+    makeClassifier: () => Promise<ILlm>;
+    makeHelper?: () => Promise<ILlm>;
+    makeEmbedder?: () => Promise<IEmbedder>;
+    makeToolsRag?: () => Promise<IRag>;
+    makeHistoryRag?: () => Promise<IRag>;
+    makeMcpClients?: () => Promise<IMcpClient[]>;
+}): Promise<WorkerLlmSet>;
+/**
+ * Backfill the per-worker cache entry from the BUILT handle (review HIGH #7).
+ *
+ * The primary `buildSubAgent` populates `cached.mcpClients`/`toolsRag`/
+ * `historyRag` only when the worker config provided DI factories. Workers
+ * configured with `subCfg.mcp: ...` (regular config that triggers the
+ * builder's own auto-connect) or with `subCfg.rag: ...` whose RAG is owned
+ * by the builder leave those slots empty — so per-session re-wires would
+ * fall back to the PARENT's MCP/RAG, losing the worker's own connection.
+ *
+ * After the builder finishes, this helper captures what the handle actually
+ * holds and stores it BY REFERENCE on the cache entry. Subsequent per-session
+ * re-wires read the same slots and find the worker's own resources.
+ *
+ * Pure helper, mutates `entry` in place. No-op when the corresponding slot
+ * is already populated (DI path wins) or when the handle has no resource for
+ * that slot (worker simply didn't declare one).
+ */
+export declare function backfillWorkerCacheFromHandle(entry: WorkerLlmSet, handle: {
+    mcpClients?: IMcpClient[];
+    ragRegistry: {
+        get(name: string): IRag | undefined;
+    };
+    close?: () => Promise<void>;
+}): Promise<void>;
+/**
+ * Share the parent RAG registry with subagents (per-session worker re-wire).
+ * Session/user/global collections written at the top level become visible to
+ * workers; the per-call scope filter (`rag-query.ts`) isolates by
+ * `ctx.sessionId` / `ctx.options.userId`. A worker's own declared store is
+ * registered INTO this same registry under its namespace. When the parent
+ * registry is undefined (no top-level registry yet — e.g. unit test seam),
+ * return undefined so the builder allocates its own SimpleRagRegistry.
+ */
+export declare function resolveSubAgentRagRegistry(input: {
+    parentRagRegistry: IRagRegistry | undefined;
+}): IRagRegistry | undefined;
+/**
+ * Options for `buildSessionLifecycle`. Composes the SessionGraphFactory + the
+ * SessionRegistry; exposes a thin facade so `_handle` stays unit-testable.
+ */
+export interface SessionLifecycleOptions {
+    idleTtlMs: number;
+    maxSessions: number;
+    cookieName: string;
+    mcpClients: IMcpClient[];
+    toolsRag: IRag | undefined;
+    ragRegistry: IRagRegistry;
+    buildAgent: (parts: SessionAgentParts) => Promise<SmartAgent | undefined>;
+    /** Optional logger forwarded to SessionGraphFactory for cleanup-failure surfacing. */
+    logger?: ILogger;
+}
+/**
+ * Composes the cookie identity resolver + SessionGraphFactory + SessionRegistry
+ * into one lifecycle object the server's `_handle` consumes. The default MCP
+ * factory returns the shared GLOBAL clients by reference (one upstream
+ * connection); a creds-aware build swaps it out (out of scope here).
+ */
+export declare function buildSessionLifecycle(opts: SessionLifecycleOptions): {
+    resolve: (cookieHeader: string | undefined, isHttps: boolean) => ReturnType<typeof resolveSessionIdentity>;
+    acquire: (sessionId: string) => Promise<ReturnType<SessionRegistry['acquire']> extends Promise<infer G> ? G : never>;
+    release: (sessionId: string, graph?: SessionGraph) => void;
+    evictIdle: () => Promise<void>;
+    disposeAll: () => Promise<void>;
+    invalidateAll: () => Promise<void>;
+    registry: SessionRegistry;
+};
+export type SessionLifecycle = ReturnType<typeof buildSessionLifecycle>;
+/** Response shape for GET /v1/sessions */
+export interface SessionListBody {
+    sessions: SessionMetaRow[];
+}
+/** Response shape for POST /v1/sessions/:id/resume */
+export interface SessionResumeBody {
+    ok: boolean;
+    session?: SessionMetaRow;
+    error?: string;
+}
+/**
+ * Seed session-scope guidance entries into a BRAND-NEW session's knowledge-RAG
+ * (deployment-supplied tool-usage guidance the planner/executor read in "Known
+ * facts"). Idempotent: rehydrates via init() and writes ONLY when the session is
+ * empty (`fingerprint() === 'n=0'`), so resumes never duplicate. Entries are
+ * config DATA — the runtime stays MCP-agnostic (no tool knowledge in agent code).
+ */
+export declare function seedSessionKnowledge(kr: IKnowledgeRagHandle & {
+    init?(): Promise<void>;
+    fingerprint?(): string;
+}, seeds: ReadonlyArray<{
+    content: string;
+    artifactType: string;
+}>, nowIso: string): Promise<void>;
+/**
+ * Record that a request for `sessionId` STARTED — create the meta row on first
+ * sight, else touch it and mark in-progress. Called from the live request path
+ * (`_withSession`) so GET /v1/sessions, resume and delete actually see sessions
+ * produced by normal chat/stream traffic (review Finding 3). `userIdentity` is
+ * the sessionId itself in the default no-auth build — matching how the
+ * /v1/sessions endpoints resolve identity (`resolved.identity.sessionId`).
+ */
+export declare function recordSessionStart(store: ISessionMetaStore, sessionId: string, nowIso: string): Promise<void>;
+/**
+ * Record that a request for `sessionId` FINISHED — touch + mark idle (so it can
+ * be resumed). No-op if the row was deleted mid-flight.
+ */
+export declare function recordSessionEnd(store: ISessionMetaStore, sessionId: string, nowIso: string): Promise<void>;
+/**
+ * List all sessions for a given user identity.
+ * Extracted for unit-testability (mirrors the /v1/usage handler pattern).
+ */
+export declare function handleListSessions(store: ISessionMetaStore, identity: string): Promise<SessionListBody>;
+/**
+ * Resume (claim) a session by ID for a user identity.
+ * Sets the session status to 'idle' so it can be re-entered.
+ */
+export declare function handleResumeSession(store: ISessionMetaStore, identity: string, id: string): Promise<SessionResumeBody>;
+/**
+ * Delete a session by ID for a user identity, and evict its RAG state.
+ */
+export declare function handleDeleteSession(store: ISessionMetaStore, identity: string, id: string, evictFn: (sessionId: string) => Promise<void>): Promise<{
+    ok: boolean;
+    error?: string;
+}>;
+/**
+ * Build a `callMcp(name, args, signal?)` bridge over a list of `IMcpClient`s.
+ *
+ * Dispatch strategy (mirrors the 17.0 tool-loop):
+ * - Iterate the clients; the first client whose `listTools()` contains `name` wins.
+ * - On success: return the textual content (stringify structured payloads).
+ * - On error: return the error message as a string so the LLM executor can
+ *   feed the failure back to the model as a tool result (no throw).
+ * - If no client owns the tool: return an informative "Tool not found" string.
+ *
+ * Exported for testability — tests can call this with a fake IMcpClient list.
+ */
+/**
+ * Connect MCP clients from a YAML `mcp:` config block (single or array).
+ *
+ * Mirrors the builder's connection logic (builder.ts ~lines 897-920) so the
+ * Stepper path gets the same clients that the builder would have connected
+ * internally. Exported for testability.
+ *
+ * @param mcpCfg - single `SmartServerMcpConfig` or array thereof (from
+ *   `pipeline.mcp` or `this.cfg.mcp`). Accepts the union so callers can pass
+ *   either directly without pre-normalising.
+ */
+export declare function connectMcpClientsFromConfig(mcpCfg: SmartServerMcpConfig | SmartServerMcpConfig[] | undefined | null): Promise<IMcpClient[]>;
+export declare function buildMcpBridge(clients: IMcpClient[]): (name: string, args: unknown, signal?: AbortSignal) => Promise<string>;
+/**
+ * Returns `true` ONLY when the raw coordinator config has an explicit `mode`
+ * string — the opt-in gate for the 18.0 Stepper runtime.
+ *
+ * IMPORTANT: Do NOT call `parseStepperCoordinatorConfig` to decide — that
+ * function defaults `mode` to `'planned-react'`, which would silently route
+ * every 17.0 legacy config onto the Stepper path. Gate on the RAW field
+ * presence only; parse is done INSIDE the Stepper branch after this check.
+ */
+export declare function usesStepper(coordCfg: Record<string, unknown> | undefined): boolean;
+export declare class SmartServer {
+    private readonly cfg;
+    private readonly noop;
+    /**
+     * GLOBAL per-worker LLM/embedder cache. Populated lazily by `buildSubAgent`
+     * the first time each worker name is seen; subsequent per-session re-wires
+     * pull from this cache by reference (never reconstructing LLM clients).
+     */
+    private readonly _workerLlmCache;
+    /** Lifecycle handle wired in `start()`; consumed by `_handle`. */
+    private _lifecycle?;
+    /** Hoisted globals used by `buildSessionAgent` to re-wire fresh per-session workers. */
+    private _mainLlm?;
+    private _classifierLlm?;
+    private _helperLlm?;
+    private _fileLogger?;
+    private _mergedEmbedderFactories?;
+    /**
+     * Captured DAG coordinator template — `deps` are stateless or LLM-bound and
+     * are reused across sessions; only `workers` + `stateOracle` are re-wired per
+     * session (review HIGH #1).
+     */
+    private _dagCoordinatorTemplate?;
+    /**
+     * 18.0 Stepper coordinator handler — stateless, session context comes through
+     * `ctx.sessionId` at execute time. Built once in `start()` when
+     * `coordinator.mode` is present in the raw config; reused across sessions.
+     */
+    private _stepperCoordinatorHandler?;
+    /**
+     * MCP clients connected for the Stepper path from the YAML `mcp:` config
+     * block. These are connected ONCE in `start()` (lazily resolved by
+     * `connectMcpClientsFromConfig`) and reused across every Stepper request.
+     *
+     * Populated only when `this.cfg.mcp` / `pipeline.mcp` is set AND no
+     * DI/plugin clients exist (DI precedence: `this.cfg.mcpClients` > plugin >
+     * yaml). Disposed via the server's `closeFns` on shutdown.
+     */
+    private _stepperMcpClients?;
+    /**
+     * The ONE shared knowledge backend for the Stepper path (set during build).
+     * Held so DELETE /v1/sessions/:id can evict a session's entries from it —
+     * critical for the long-lived in-memory backend, which would otherwise retain
+     * knowledge after a delete and rehydrate it on a same-id re-entry.
+     */
+    private _stepperKnowledgeBackend?;
+    /**
+     * Session meta-store for /v1/sessions endpoints (Task 17).
+     * Defaults to InMemorySessionMetaStore; a durable store can be injected via
+     * `cfg.sessionMetaStore` in a future extension.
+     */
+    private readonly _sessionMetaStore;
+    constructor(config: SmartServerConfig);
+    start(): Promise<SmartServerHandle>;
+    /**
+     * Build a `SmartAgent` instance from a nested sub-agent config.
+     *
+     * Mirrors the parent's composition flow but intentionally narrower:
+     *   - reuses the parent's merged embedder factories so plugin-provided
+     *     embedders stay available without a second `pluginLoader.load()`;
+     *   - shares the parent's file logger to keep one log stream;
+     *   - skips features that don't make sense for a nested agent (HTTP
+     *     surface, plugin reranker/queryExpander/outputValidator, MCP
+     *     client DI, custom client adapters, structured pipeline rag.*
+     *     stores). Only the flat `rag:` block is honoured.
+     *
+     * Sub-agents do not recurse — `subagents:` inside a sub-YAML is
+     * rejected at config-parse time, so `subCfg.subAgentConfigs` is
+     * always undefined here.
+     */
+    private buildSubAgent;
+    /**
+     * Builds a per-session SmartAgent from injected globals (review HIGH #1 +
+     * MEDIUM #3). Re-wires the SubAgent registry + DAG coordinator deps FRESH per
+     * session, sharing this session's logger + the global ragRegistry/toolsRag/
+     * mcpClients + the CACHED per-worker LLM/embedder (this._workerLlmCache). It
+     * NEVER reuses the primary build()'s global `registry`/DAG-deps and NEVER
+     * constructs new LLM clients.
+     */
+    private buildSessionAgent;
+    /**
+     * Resolve identity (mint cookie when needed), acquire the per-session graph,
+     * run `fn` pinned, and release in `finally`. Order in `finally`:
+     *   1. drop the per-traceId logger delta (server-owned free, review HIGH #2)
+     *   2. release the refcount pin
+     */
+    private _withSession;
+    private _handle;
+    private _handleAdapterRequest;
+    private _handleChat;
+    /** Whitelisted agent config fields allowed via PUT /v1/config. */
+    private static readonly AGENT_CONFIG_FIELDS;
+    private _handleConfigUpdate;
+}
+//# sourceMappingURL=smart-server.d.ts.map

package/dist/smart-agent/smart-server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"smart-server.d.ts","sourceRoot":"","sources":["../../src/smart-agent/smart-server.ts"],"names":[],"mappings":"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"}