agim-cli 1.2.45 → 1.2.48

package/dist/core/llm/introspection.d.ts

@@ -0,0 +1,73 @@
+import { type LlmRole } from './registry.js';
+import { type LlmUsage } from './provider-base.js';
+export interface IntrospectionInput {
+    /** Role name to look up in the registry. */
+    role: LlmRole;
+    /** The user prompt. Required. */
+    prompt: string;
+    /** Optional system prompt prepended as a system message. */
+    system?: string;
+    /** Hard deadline. Default 30s — short enough that a stuck provider
+     *  trips fallback fast, long enough that legitimate JSON extraction
+     *  on a free-tier model completes. */
+    timeoutMs?: number;
+    /** Caller may pass through an AbortSignal (e.g. distill's queue is
+     *  draining); we merge it with timeoutMs. */
+    signal?: AbortSignal;
+    /** Per-call temperature override (cheap callers usually want 0.2; the
+     *  provider default is already low so this is rarely needed). */
+    temperature?: number;
+    /** Per-call model override; falls back to the provider's default. */
+    model?: string;
+}
+export interface IntrospectionResult {
+    /** Plain text body. Empty string means "model returned nothing useful";
+     *  the caller decides whether that's a failure. */
+    text: string;
+    /** Aggregate usage from the provider. */
+    usage: LlmUsage;
+    /** Backend name that handled the request; useful for audit rows. */
+    backendName: string;
+    /** Provider type label (e.g. "deepseek" / "openai-compat") for the
+     *  cost dashboard. */
+    providerType: string;
+    /** Elapsed wall-clock time. */
+    durationMs: number;
+}
+/**
+ * Try to satisfy the introspection request via the configured backend
+ * for `role`. Returns null when:
+ *   - no provider is wired for this role, OR
+ *   - the provider call failed (errors are logged + classified, never
+ *     re-thrown — the caller's fallback path takes over).
+ *
+ * The "return null on failure" contract is exactly what distill /
+ * consolidate / intent want: they then fall back to spawning their
+ * CLI agent and the user notices nothing.
+ */
+export declare function tryIntrospect(input: IntrospectionInput): Promise<IntrospectionResult | null>;
+/**
+ * Stage 5 — try a CHAIN of roles in order until one returns a non-null
+ * result. The chain is operator-configurable per call (typically
+ * ['cheap', 'native-chat', 'evaluator'] for low-stakes introspection
+ * that should escalate to a smarter / different vendor on failure).
+ *
+ * Returns the first successful IntrospectionResult, augmented with
+ * `triedRoles` so the caller can audit which roles got skipped. When
+ * every role in the chain returns null, returns null — the caller's
+ * existing CLI-fallback path takes over (same contract as
+ * tryIntrospect).
+ */
+export interface IntrospectionChainInput extends Omit<IntrospectionInput, 'role'> {
+    /** Roles to try in order. Empty array returns null immediately. */
+    roles: LlmRole[];
+    /** Per-role wall-clock cap (default 30s). */
+    perRoleTimeoutMs?: number;
+}
+export interface IntrospectionChainResult extends IntrospectionResult {
+    /** Roles attempted in order, including the one that succeeded
+     *  (always last). Lets the caller log "we fell back twice". */
+    triedRoles: LlmRole[];
+}
+export declare function tryIntrospectChain(input: IntrospectionChainInput): Promise<IntrospectionChainResult | null>;
+//# sourceMappingURL=introspection.d.ts.map

package/dist/core/llm/introspection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"introspection.d.ts","sourceRoot":"","sources":["../../../src/core/llm/introspection.ts"],"names":[],"mappings":"AAUA,OAAO,EAAe,KAAK,OAAO,EAAE,MAAM,eAAe,CAAA;AACzD,OAAO,EAAqC,KAAK,QAAQ,EAAE,MAAM,oBAAoB,CAAA;AAIrF,MAAM,WAAW,kBAAkB;IACjC,4CAA4C;IAC5C,IAAI,EAAE,OAAO,CAAA;IACb,iCAAiC;IACjC,MAAM,EAAE,MAAM,CAAA;IACd,4DAA4D;IAC5D,MAAM,CAAC,EAAE,MAAM,CAAA;IACf;;0CAEsC;IACtC,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB;iDAC6C;IAC7C,MAAM,CAAC,EAAE,WAAW,CAAA;IACpB;qEACiE;IACjE,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,qEAAqE;IACrE,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAED,MAAM,WAAW,mBAAmB;IAClC;uDACmD;IACnD,IAAI,EAAE,MAAM,CAAA;IACZ,yCAAyC;IACzC,KAAK,EAAE,QAAQ,CAAA;IACf,oEAAoE;IACpE,WAAW,EAAE,MAAM,CAAA;IACnB;0BACsB;IACtB,YAAY,EAAE,MAAM,CAAA;IACpB,+BAA+B;IAC/B,UAAU,EAAE,MAAM,CAAA;CACnB;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,aAAa,CAAC,KAAK,EAAE,kBAAkB,GAAG,OAAO,CAAC,mBAAmB,GAAG,IAAI,CAAC,CAmClG;AAED;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,uBACf,SAAQ,IAAI,CAAC,kBAAkB,EAAE,MAAM,CAAC;IACxC,mEAAmE;IACnE,KAAK,EAAE,OAAO,EAAE,CAAA;IAChB,6CAA6C;IAC7C,gBAAgB,CAAC,EAAE,MAAM,CAAA;CAC1B;AAED,MAAM,WAAW,wBAAyB,SAAQ,mBAAmB;IACnE;mEAC+D;IAC/D,UAAU,EAAE,OAAO,EAAE,CAAA;CACtB;AAED,wBAAsB,kBAAkB,CACtC,KAAK,EAAE,uBAAuB,GAC7B,OAAO,CAAC,wBAAwB,GAAG,IAAI,CAAC,CA2B1C"}

package/dist/core/llm/introspection.js

@@ -0,0 +1,90 @@
+// Introspection helper — bridges the registry to the existing CLI-style
+// "give me a string back" pattern that distill / consolidate / intent
+// already use.
+//
+// Callers don't want to know about LlmMessage[] / ChatResult. They have
+// a flat prompt string and a per-call deadline; they want a Promise<{
+// text, costUsd }> back. This file does that mapping in one place so
+// every introspection caller stays a 1-line change.
+import { logger as rootLogger } from '../logger.js';
+import { getProvider } from './registry.js';
+import { LlmProviderError } from './provider-base.js';
+const log = rootLogger.child({ component: 'llm-introspection' });
+/**
+ * Try to satisfy the introspection request via the configured backend
+ * for `role`. Returns null when:
+ *   - no provider is wired for this role, OR
+ *   - the provider call failed (errors are logged + classified, never
+ *     re-thrown — the caller's fallback path takes over).
+ *
+ * The "return null on failure" contract is exactly what distill /
+ * consolidate / intent want: they then fall back to spawning their
+ * CLI agent and the user notices nothing.
+ */
+export async function tryIntrospect(input) {
+    const provider = getProvider(input.role);
+    if (!provider)
+        return null;
+    const messages = [{ role: 'user', content: input.prompt }];
+    const startedAt = Date.now();
+    try {
+        const result = await provider.chat(messages, {
+            system: input.system,
+            timeoutMs: input.timeoutMs ?? 30_000,
+            signal: input.signal,
+            temperature: input.temperature,
+            model: input.model,
+        });
+        return {
+            text: result.text,
+            usage: result.usage,
+            backendName: provider.name,
+            providerType: provider.providerType,
+            durationMs: Date.now() - startedAt,
+        };
+    }
+    catch (err) {
+        const transient = err instanceof LlmProviderError ? err.transient : false;
+        const httpStatus = err instanceof LlmProviderError ? err.httpStatus : undefined;
+        log.warn({
+            event: 'llm.introspect.failed',
+            role: input.role,
+            backend: provider.name,
+            providerType: provider.providerType,
+            transient,
+            httpStatus,
+            err: err instanceof Error ? err.message : String(err),
+        });
+        return null;
+    }
+}
+export async function tryIntrospectChain(input) {
+    if (!input.roles || input.roles.length === 0)
+        return null;
+    const tried = [];
+    for (const role of input.roles) {
+        tried.push(role);
+        const r = await tryIntrospect({
+            role,
+            prompt: input.prompt,
+            system: input.system,
+            timeoutMs: input.perRoleTimeoutMs ?? input.timeoutMs ?? 30_000,
+            signal: input.signal,
+            temperature: input.temperature,
+            model: input.model,
+        });
+        if (r) {
+            log.info({
+                event: 'llm.introspect.chain.success',
+                role, attempts: tried.length, totalRoles: input.roles.length,
+            });
+            return { ...r, triedRoles: tried.slice() };
+        }
+    }
+    log.info({
+        event: 'llm.introspect.chain.exhausted',
+        attempts: tried.length, roles: tried.join(','),
+    });
+    return null;
+}
+//# sourceMappingURL=introspection.js.map

package/dist/core/llm/introspection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"introspection.js","sourceRoot":"","sources":["../../../src/core/llm/introspection.ts"],"names":[],"mappings":"AAAA,wEAAwE;AACxE,sEAAsE;AACtE,eAAe;AACf,EAAE;AACF,wEAAwE;AACxE,sEAAsE;AACtE,qEAAqE;AACrE,oDAAoD;AAEpD,OAAO,EAAE,MAAM,IAAI,UAAU,EAAE,MAAM,cAAc,CAAA;AACnD,OAAO,EAAE,WAAW,EAAgB,MAAM,eAAe,CAAA;AACzD,OAAO,EAAE,gBAAgB,EAAkC,MAAM,oBAAoB,CAAA;AAErF,MAAM,GAAG,GAAG,UAAU,CAAC,KAAK,CAAC,EAAE,SAAS,EAAE,mBAAmB,EAAE,CAAC,CAAA;AAsChE;;;;;;;;;;GAUG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,KAAyB;IAC3D,MAAM,QAAQ,GAAG,WAAW,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;IACxC,IAAI,CAAC,QAAQ;QAAE,OAAO,IAAI,CAAA;IAE1B,MAAM,QAAQ,GAAiB,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,CAAC,MAAM,EAAE,CAAC,CAAA;IACxE,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAA;IAC5B,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,IAAI,CAAC,QAAQ,EAAE;YAC3C,MAAM,EAAE,KAAK,CAAC,MAAM;YACpB,SAAS,EAAE,KAAK,CAAC,SAAS,IAAI,MAAM;YACpC,MAAM,EAAE,KAAK,CAAC,MAAM;YACpB,WAAW,EAAE,KAAK,CAAC,WAAW;YAC9B,KAAK,EAAE,KAAK,CAAC,KAAK;SACnB,CAAC,CAAA;QACF,OAAO;YACL,IAAI,EAAE,MAAM,CAAC,IAAI;YACjB,KAAK,EAAE,MAAM,CAAC,KAAK;YACnB,WAAW,EAAE,QAAQ,CAAC,IAAI;YAC1B,YAAY,EAAE,QAAQ,CAAC,YAAY;YACnC,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS;SACnC,CAAA;IACH,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,SAAS,GAAG,GAAG,YAAY,gBAAgB,CAAC,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,KAAK,CAAA;QACzE,MAAM,UAAU,GAAG,GAAG,YAAY,gBAAgB,CAAC,CAAC,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,SAAS,CAAA;QAC/E,GAAG,CAAC,IAAI,CAAC;YACP,KAAK,EAAE,uBAAuB;YAC9B,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,OAAO,EAAE,QAAQ,CAAC,IAAI;YACtB,YAAY,EAAE,QAAQ,CAAC,YAAY;YACnC,SAAS;YACT,UAAU;YACV,GAAG,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC;SACtD,CAAC,CAAA;QACF,OAAO,IAAI,CAAA;IACb,CAAC;AACH,CAAC;AA4BD,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,KAA8B;IAE9B,IAAI,CAAC,KAAK,CAAC,KAAK,IAAI,KAAK,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAA;IACzD,MAAM,KAAK,GAAc,EAAE,CAAA;IAC3B,KAAK,MAAM,IAAI,IAAI,KAAK,CAAC,KAAK,EAAE,CAAC;QAC/B,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QAChB,MAAM,CAAC,GAAG,MAAM,aAAa,CAAC;YAC5B,IAAI;YACJ,MAAM,EAAE,KAAK,CAAC,MAAM;YACpB,MAAM,EAAE,KAAK,CAAC,MAAM;YACpB,SAAS,EAAE,KAAK,CAAC,gBAAgB,IAAI,KAAK,CAAC,SAAS,IAAI,MAAM;YAC9D,MAAM,EAAE,KAAK,CAAC,MAAM;YACpB,WAAW,EAAE,KAAK,CAAC,WAAW;YAC9B,KAAK,EAAE,KAAK,CAAC,KAAK;SACnB,CAAC,CAAA;QACF,IAAI,CAAC,EAAE,CAAC;YACN,GAAG,CAAC,IAAI,CAAC;gBACP,KAAK,EAAE,8BAA8B;gBACrC,IAAI,EAAE,QAAQ,EAAE,KAAK,CAAC,MAAM,EAAE,UAAU,EAAE,KAAK,CAAC,KAAK,CAAC,MAAM;aAC7D,CAAC,CAAA;YACF,OAAO,EAAE,GAAG,CAAC,EAAE,UAAU,EAAE,KAAK,CAAC,KAAK,EAAE,EAAE,CAAA;QAC5C,CAAC;IACH,CAAC;IACD,GAAG,CAAC,IAAI,CAAC;QACP,KAAK,EAAE,gCAAgC;QACvC,QAAQ,EAAE,KAAK,CAAC,MAAM,EAAE,KAAK,EAAE,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC;KAC/C,CAAC,CAAA;IACF,OAAO,IAAI,CAAA;AACb,CAAC"}

package/dist/core/llm/mcp-client.d.ts

@@ -0,0 +1,80 @@
+import type { ToolDef } from './provider-base.js';
+/**
+ * Tool naming policy: `mcp_{server}_{tool}`. Avoids name collisions when
+ * two servers advertise the same tool name (common: every server has
+ * `read_file`). The original tool name is preserved on `originalName`
+ * so error messages stay legible and `enabledTools` filtering can match
+ * either form.
+ */
+export declare function _namespacedNameForTest(serverName: string, toolName: string): string;
+/** Stage-2 config shape for one MCP server. Mirrors the zod schema in
+ *  config-schema.ts but kept here as a plain TS interface so this file
+ *  doesn't import the whole schema module just for the type. */
+export interface McpServerConfig {
+    name: string;
+    command?: string;
+    args?: string[];
+    env?: Record<string, string>;
+    cwd?: string;
+    url?: string;
+    headers?: Record<string, string>;
+    toolTimeoutMs?: number;
+    enabledTools?: string[];
+    enabled?: boolean;
+}
+/** Result of a single tool call. Stage-2 agent loop treats this as
+ *  free-form text appended to the conversation as a tool message. */
+export interface ToolCallResult {
+    text: string;
+    isError: boolean;
+}
+/**
+ * Wraps one MCP server connection. The caller (`mcp-registry.ts`)
+ * holds a Map<server-name, McpClient> and is responsible for lifecycle
+ * (connectAll at boot, closeAll on shutdown).
+ */
+export declare class McpClient {
+    readonly name: string;
+    private readonly cfg;
+    private readonly toolTimeoutMs;
+    private client;
+    private cachedTools;
+    constructor(cfg: McpServerConfig);
+    /** True once connect() has completed without error. */
+    isConnected(): boolean;
+    /**
+     * Pick the right transport for the config and run the MCP handshake.
+     * Errors propagate; registry surfaces them as `unhealthy` rows.
+     */
+    connect(): Promise<void>;
+    /**
+     * Discover the server's tool roster and project into agim ToolDef[].
+     * Applies `enabledTools` filter and the namespaced-name policy.
+     */
+    listAvailableTools(): Promise<ToolDef[]>;
+    /**
+     * Invoke a tool by either the namespaced or original name. Returns
+     * the concatenated text content + an isError flag (the MCP spec
+     * lets a tool succeed at the transport level while reporting a
+     * domain-level error; the agent loop should usually pass either
+     * back to the model so it can react).
+     */
+    callTool(callName: string, args: Record<string, unknown>, opts?: {
+        signal?: AbortSignal;
+    }): Promise<ToolCallResult>;
+    /** Best-effort close. Idempotent. */
+    close(): Promise<void>;
+    private _resolveOriginalName;
+}
+/** Make sure the input schema is at least an object — MCP servers
+ *  sometimes return undefined or a non-object for parameterless tools. */
+export declare function _ensureObjectSchemaForTest(raw: unknown): Record<string, unknown>;
+/**
+ * MCP tool results are `content: [{type, text, ...}, ...]`. Concatenate
+ * every `text` block into one string for the agent loop. Non-text
+ * blocks (image, resource) are stringified as `[image]` etc. so the
+ * model at least sees they were there; first-class image support
+ * lands when we wire vision providers.
+ */
+export declare function _aggregateTextContentForTest(content: unknown): string;
+//# sourceMappingURL=mcp-client.d.ts.map

package/dist/core/llm/mcp-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-client.d.ts","sourceRoot":"","sources":["../../../src/core/llm/mcp-client.ts"],"names":[],"mappings":"AAmCA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAA;AAMjD;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAEnF;AAQD;;gEAEgE;AAChE,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAA;IACf,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAC5B,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAChC,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAA;IACvB,OAAO,CAAC,EAAE,OAAO,CAAA;CAClB;AAED;qEACqE;AACrE,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,OAAO,CAAA;CACjB;AAED;;;;GAIG;AACH,qBAAa,SAAS;IACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAiB;IACrC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAQ;IACtC,OAAO,CAAC,MAAM,CAAsB;IAKpC,OAAO,CAAC,WAAW,CAAoE;gBAE3E,GAAG,EAAE,eAAe;IAMhC,uDAAuD;IACvD,WAAW,IAAI,OAAO;IAItB;;;OAGG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAiB9B;;;OAGG;IACG,kBAAkB,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;IAgC9C;;;;;;OAMG;IACG,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,IAAI,GAAE;QAAE,MAAM,CAAC,EAAE,WAAW,CAAA;KAAO,GAAG,OAAO,CAAC,cAAc,CAAC;IAqC7H,qCAAqC;IAC/B,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAO5B,OAAO,CAAC,oBAAoB;CAW7B;AAmCD;0EAC0E;AAC1E,wBAAgB,0BAA0B,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAEhF;AASD;;;;;;GAMG;AACH,wBAAgB,4BAA4B,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,CAErE"}

package/dist/core/llm/mcp-client.js

@@ -0,0 +1,270 @@
+// mcp-client — thin wrapper over @modelcontextprotocol/sdk for the
+// native agent loop (Stage 2 sub-PR #2).
+//
+// What this file does:
+//   - One McpClient per configured server (stdio / sse / streamable-http)
+//   - connect(): instantiate the right transport + Client + handshake
+//   - listAvailableTools(): discover tools and expose them as agim's
+//     ToolDef[] with namespaced names (`mcp_{server}_{tool}`)
+//   - callTool(name, args): run a tool by namespaced or original name,
+//     return its text result. Wraps the SDK's untyped result in a
+//     simpler "text or error" string for the agent loop.
+//   - close(): graceful shutdown (used in cli.ts at process exit so we
+//     don't leave orphan stdio subprocesses)
+//
+// What this file deliberately does NOT do (yet):
+//   - Resource subscription (server -> client notifications). The
+//     agent loop in sub-PR #3 doesn't consume these.
+//   - MCP prompts as tools. Useful in nanobot's design but premature
+//     until we have a use case here.
+//   - Auto-reconnect on transport drop. The SDK does some of this
+//     internally; we let the caller (the agent loop) treat connect
+//     failures as "tool unavailable for this iteration" via the
+//     registry's `unhealthy` flag, then re-probe on subsequent ticks.
+//   - Schema normalisation for OpenAI's strict `tools[]` schema. The
+//     provider already passes input_schema verbatim; if a server emits
+//     an OpenAI-rejected variant (e.g. nullable union via `type: [s,n]`)
+//     the openai-compat provider will surface the API error. We can
+//     add normalisation later when we hit a real-world server that
+//     trips it.
+import { Client } from '@modelcontextprotocol/sdk/client/index.js';
+import { StdioClientTransport } from '@modelcontextprotocol/sdk/client/stdio.js';
+import { SSEClientTransport } from '@modelcontextprotocol/sdk/client/sse.js';
+import { StreamableHTTPClientTransport } from '@modelcontextprotocol/sdk/client/streamableHttp.js';
+import { logger as rootLogger } from '../logger.js';
+const log = rootLogger.child({ component: 'mcp-client' });
+const DEFAULT_TOOL_TIMEOUT_MS = 30_000;
+/**
+ * Tool naming policy: `mcp_{server}_{tool}`. Avoids name collisions when
+ * two servers advertise the same tool name (common: every server has
+ * `read_file`). The original tool name is preserved on `originalName`
+ * so error messages stay legible and `enabledTools` filtering can match
+ * either form.
+ */
+export function _namespacedNameForTest(serverName, toolName) {
+    return namespacedName(serverName, toolName);
+}
+function namespacedName(serverName, toolName) {
+    const safeServer = serverName.replace(/[^A-Za-z0-9]+/g, '_');
+    const safeTool = toolName.replace(/[^A-Za-z0-9_]+/g, '_');
+    return `mcp_${safeServer}_${safeTool}`;
+}
+/**
+ * Wraps one MCP server connection. The caller (`mcp-registry.ts`)
+ * holds a Map<server-name, McpClient> and is responsible for lifecycle
+ * (connectAll at boot, closeAll on shutdown).
+ */
+export class McpClient {
+    name;
+    cfg;
+    toolTimeoutMs;
+    client = null;
+    // Cache the listTools() result so the agent loop doesn't pay the
+    // round-trip cost on every iteration. Servers that hot-reload tools
+    // mid-session would need an explicit refresh hook; punt until a real
+    // case appears.
+    cachedTools = null;
+    constructor(cfg) {
+        this.name = cfg.name;
+        this.cfg = cfg;
+        this.toolTimeoutMs = cfg.toolTimeoutMs ?? DEFAULT_TOOL_TIMEOUT_MS;
+    }
+    /** True once connect() has completed without error. */
+    isConnected() {
+        return this.client !== null;
+    }
+    /**
+     * Pick the right transport for the config and run the MCP handshake.
+     * Errors propagate; registry surfaces them as `unhealthy` rows.
+     */
+    async connect() {
+        if (this.client)
+            return; // idempotent
+        const transport = buildTransport(this.cfg);
+        const client = new Client({ name: 'agim-mcp-client', version: '1' }, 
+        // capabilities — we don't advertise sampling / roots / elicitation
+        // yet; tools-only consumer.
+        { capabilities: {} });
+        await client.connect(transport);
+        this.client = client;
+        log.info({
+            event: 'mcp.connected', server: this.name,
+            transport: classifyTransport(this.cfg),
+        });
+    }
+    /**
+     * Discover the server's tool roster and project into agim ToolDef[].
+     * Applies `enabledTools` filter and the namespaced-name policy.
+     */
+    async listAvailableTools() {
+        if (!this.client)
+            throw new Error(`mcp-client[${this.name}]: not connected`);
+        if (this.cachedTools)
+            return this.cachedTools.full;
+        const resp = await this.client.listTools({});
+        // resp.tools shape per MCP spec: [{name, description?, inputSchema}]
+        const filter = this.cfg.enabledTools && this.cfg.enabledTools.length > 0
+            && !(this.cfg.enabledTools.length === 1 && this.cfg.enabledTools[0] === '*')
+            ? new Set(this.cfg.enabledTools)
+            : null;
+        const out = [];
+        const byCallName = new Map(); // namespaced -> original
+        for (const t of resp.tools) {
+            if (!t?.name)
+                continue;
+            const namespaced = namespacedName(this.name, t.name);
+            if (filter && !filter.has(t.name) && !filter.has(namespaced))
+                continue;
+            byCallName.set(namespaced, t.name);
+            out.push({
+                name: namespaced,
+                description: typeof t.description === 'string' ? t.description : '',
+                parameters: ensureObjectSchema(t.inputSchema),
+            });
+        }
+        this.cachedTools = { full: out, byCallName };
+        log.info({
+            event: 'mcp.tools.listed', server: this.name,
+            count: out.length, filtered: filter !== null,
+        });
+        return out;
+    }
+    /**
+     * Invoke a tool by either the namespaced or original name. Returns
+     * the concatenated text content + an isError flag (the MCP spec
+     * lets a tool succeed at the transport level while reporting a
+     * domain-level error; the agent loop should usually pass either
+     * back to the model so it can react).
+     */
+    async callTool(callName, args, opts = {}) {
+        if (!this.client)
+            throw new Error(`mcp-client[${this.name}]: not connected`);
+        const originalName = this._resolveOriginalName(callName);
+        if (originalName === null) {
+            return { text: `unknown tool: ${callName}`, isError: true };
+        }
+        const t0 = Date.now();
+        try {
+            const resp = await this.client.callTool({ name: originalName, arguments: args }, undefined, {
+                timeout: this.toolTimeoutMs,
+                signal: opts.signal,
+            });
+            const text = aggregateTextContent(resp?.content);
+            const isError = Boolean(resp?.isError);
+            log.info({
+                event: 'mcp.tool.called',
+                server: this.name, tool: originalName,
+                elapsedMs: Date.now() - t0,
+                bytes: text.length, isError,
+            });
+            return { text, isError };
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            log.warn({
+                event: 'mcp.tool.failed',
+                server: this.name, tool: originalName,
+                elapsedMs: Date.now() - t0,
+                err: msg,
+            });
+            return { text: `mcp tool call failed: ${msg}`, isError: true };
+        }
+    }
+    /** Best-effort close. Idempotent. */
+    async close() {
+        if (!this.client)
+            return;
+        try {
+            await this.client.close();
+        }
+        catch { /* ignore */ }
+        this.client = null;
+        this.cachedTools = null;
+    }
+    _resolveOriginalName(callName) {
+        if (!this.cachedTools)
+            return null;
+        // First try namespaced (preferred); fall back to original (handy
+        // for human-driven /heartbeat run-now style debugging).
+        const mapped = this.cachedTools.byCallName.get(callName);
+        if (mapped)
+            return mapped;
+        for (const orig of this.cachedTools.byCallName.values()) {
+            if (orig === callName)
+                return orig;
+        }
+        return null;
+    }
+}
+// ─── Transport factory ────────────────────────────────────────────────
+function buildTransport(cfg) {
+    if (cfg.command) {
+        return new StdioClientTransport({
+            command: cfg.command,
+            args: cfg.args ?? [],
+            env: cfg.env,
+            cwd: cfg.cwd,
+        });
+    }
+    if (cfg.url) {
+        const u = new URL(cfg.url);
+        if (cfg.url.endsWith('/sse')) {
+            return new SSEClientTransport(u, cfg.headers ? {
+                requestInit: { headers: cfg.headers },
+            } : undefined);
+        }
+        return new StreamableHTTPClientTransport(u, cfg.headers ? {
+            requestInit: { headers: cfg.headers },
+        } : undefined);
+    }
+    throw new Error(`mcp-client[${cfg.name}]: must set either command (stdio) or url (http/sse)`);
+}
+function classifyTransport(cfg) {
+    if (cfg.command)
+        return 'stdio';
+    if (cfg.url?.endsWith('/sse'))
+        return 'sse';
+    return 'streamableHttp';
+}
+// ─── Helpers ──────────────────────────────────────────────────────────
+/** Make sure the input schema is at least an object — MCP servers
+ *  sometimes return undefined or a non-object for parameterless tools. */
+export function _ensureObjectSchemaForTest(raw) {
+    return ensureObjectSchema(raw);
+}
+function ensureObjectSchema(raw) {
+    if (raw && typeof raw === 'object' && !Array.isArray(raw)) {
+        return raw;
+    }
+    return { type: 'object', properties: {} };
+}
+/**
+ * MCP tool results are `content: [{type, text, ...}, ...]`. Concatenate
+ * every `text` block into one string for the agent loop. Non-text
+ * blocks (image, resource) are stringified as `[image]` etc. so the
+ * model at least sees they were there; first-class image support
+ * lands when we wire vision providers.
+ */
+export function _aggregateTextContentForTest(content) {
+    return aggregateTextContent(content);
+}
+function aggregateTextContent(content) {
+    if (!Array.isArray(content))
+        return '';
+    const out = [];
+    for (const block of content) {
+        if (!block || typeof block !== 'object')
+            continue;
+        if (block.type === 'text' && typeof block.text === 'string') {
+            out.push(block.text);
+        }
+        else if (block.type === 'image') {
+            out.push('[image]');
+        }
+        else if (block.type === 'resource' || block.type === 'resource_link') {
+            out.push('[resource]');
+        }
+    }
+    return out.join('');
+}
+//# sourceMappingURL=mcp-client.js.map

package/dist/core/llm/mcp-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-client.js","sourceRoot":"","sources":["../../../src/core/llm/mcp-client.ts"],"names":[],"mappings":"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"}

package/dist/core/llm/mcp-registry.d.ts

@@ -0,0 +1,57 @@
+import { type ToolCallResult } from './mcp-client.js';
+import type { ToolDef } from './provider-base.js';
+/**
+ * Build McpClient instances from config. Idempotent — repeated calls
+ * fully replace the previous state (any open connections are closed
+ * first via closeAll).
+ */
+export declare function loadFromConfig(cfg: {
+    mcpServers?: unknown;
+}): Promise<void>;
+/**
+ * Connect every registered client. Failures are recorded in
+ * `state.unhealthy` so a broken server doesn't poison the startup
+ * sequence. Returns a summary so callers (cli.ts boot log) can print
+ * something useful.
+ */
+export declare function connectAll(): Promise<{
+    ok: string[];
+    failed: Record<string, string>;
+    toolCount: number;
+}>;
+/** All tools across every connected client. Safe to call before
+ *  connectAll (returns []). The order is insertion order of the
+ *  mcpServers config — useful for the web UI listing. */
+export declare function getAllTools(): ToolDef[];
+/** Look up which server owns a given namespaced tool name. */
+export declare function getOwningServer(callName: string): string | null;
+/**
+ * Dispatch a tool call to the right client. Returns a "tool unknown"
+ * error result rather than throwing; the agent loop converts that into
+ * a `{role:'tool', isError:true}` message so the model can recover.
+ */
+export declare function callToolByName(callName: string, args: Record<string, unknown>, opts?: {
+    signal?: AbortSignal;
+}): Promise<ToolCallResult>;
+/**
+ * Snapshot for cli.ts boot log + future web UI. Reports server count,
+ * total advertised tools, and which servers are unhealthy.
+ */
+export declare function describeRegistry(): {
+    servers: Array<{
+        name: string;
+        connected: boolean;
+        toolCount: number;
+        error?: string;
+    }>;
+    totalTools: number;
+};
+/**
+ * Close every client connection. Idempotent — safe to call from
+ * graceful shutdown paths even when nothing is connected.
+ */
+export declare function closeAll(): Promise<void>;
+/** Test-only: clear without close. Use only in test setups where the
+ *  real clients were never instantiated. */
+export declare function _resetRegistry(): void;
+//# sourceMappingURL=mcp-registry.d.ts.map

package/dist/core/llm/mcp-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-registry.d.ts","sourceRoot":"","sources":["../../../src/core/llm/mcp-registry.ts"],"names":[],"mappings":"AAsBA,OAAO,EAAmC,KAAK,cAAc,EAAE,MAAM,iBAAiB,CAAA;AACtF,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAA;AAoBjD;;;;GAIG;AACH,wBAAsB,cAAc,CAAC,GAAG,EAAE;IAAE,UAAU,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAkBjF;AAED;;;;;GAKG;AACH,wBAAsB,UAAU,IAAI,OAAO,CAAC;IAAE,EAAE,EAAE,MAAM,EAAE,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,CAAC,CA2B/G;AAED;;yDAEyD;AACzD,wBAAgB,WAAW,IAAI,OAAO,EAAE,CAEvC;AAED,8DAA8D;AAC9D,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAG/D;AAED;;;;GAIG;AACH,wBAAsB,cAAc,CAClC,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,IAAI,GAAE;IAAE,MAAM,CAAC,EAAE,WAAW,CAAA;CAAO,GAClC,OAAO,CAAC,cAAc,CAAC,CAazB;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,IAAI;IAClC,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,OAAO,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;IACvF,UAAU,EAAE,MAAM,CAAA;CACnB,CAaA;AAED;;;GAGG;AACH,wBAAsB,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC,CAI9C;AAED;4CAC4C;AAC5C,wBAAgB,cAAc,IAAI,IAAI,CAErC"}