agim-cli 1.2.45 → 1.2.48

package/dist/core/llm/builtin-dispatcher.js

@@ -0,0 +1,196 @@
+// builtin-dispatcher — safe-by-default tools the native agent can call
+// without spinning up an MCP server (Stage 2 sub-PR #4).
+//
+// Scope of "safe":
+//   - read-only or trivially-reversible
+//   - no network, no filesystem mutation, no shell
+//   - bounded execution time so a model loop can't burn budget here
+//
+// Concrete tools shipped in this initial cut:
+//   * native_echo(text)               → return the text verbatim. Useful
+//                                       for the model to confirm it heard
+//                                       a piece of input, and for tests.
+//   * native_now()                    → ISO timestamp + Asia/Shanghai
+//                                       offset. Honors IMHUB_TZ_OFFSET_HOURS.
+//   * native_sleep_ms(ms, ≤ 5000)     → pause for the requested ms; lets
+//                                       the model deliberately yield in
+//                                       tests / rate-limit shimming. Hard
+//                                       capped to 5s.
+//   * native_random_uuid()            → fresh v4 UUID. Trivial but the
+//                                       agent occasionally needs a stable
+//                                       id without inventing one.
+//
+// These are intentionally tiny + boring. The whole point is for the
+// native loop to have *something* to call when no MCP server is wired,
+// so demos / tests / the smoke-test path all work end-to-end. Anything
+// non-trivial (read_file / web_search / exec) belongs in an MCP server
+// where ops can audit + sandbox properly.
+import { randomUUID } from 'node:crypto';
+import { logger as rootLogger } from '../logger.js';
+const log = rootLogger.child({ component: 'builtin-dispatcher' });
+const MAX_SLEEP_MS = 5_000;
+/** Definitions advertised to the LLM. Returned by `getBuiltinTools()`
+ *  so callers can concat with MCP tools and pass the union to runAgentLoop. */
+export function getBuiltinTools() {
+    return [
+        {
+            name: 'native_echo',
+            description: 'Return the text argument verbatim. Useful when the model needs to confirm what it received, or to log a checkpoint.',
+            parameters: {
+                type: 'object',
+                properties: {
+                    text: { type: 'string', description: 'Text to echo back.' },
+                },
+                required: ['text'],
+                additionalProperties: false,
+            },
+        },
+        {
+            name: 'native_now',
+            description: 'Return the current local time as ISO 8601 plus the agim-configured timezone offset (default Asia/Shanghai, override via IMHUB_TZ_OFFSET_HOURS).',
+            parameters: {
+                type: 'object',
+                properties: {},
+                additionalProperties: false,
+            },
+        },
+        {
+            name: 'native_sleep_ms',
+            description: 'Pause for the requested number of milliseconds (max 5000). Useful for deliberate yielding; never use to "wait for data" — call the right tool instead.',
+            parameters: {
+                type: 'object',
+                properties: {
+                    ms: { type: 'number', description: 'Milliseconds to sleep. Clamped to [0, 5000].' },
+                },
+                required: ['ms'],
+                additionalProperties: false,
+            },
+        },
+        {
+            name: 'native_random_uuid',
+            description: 'Generate a fresh random v4 UUID.',
+            parameters: {
+                type: 'object',
+                properties: {},
+                additionalProperties: false,
+            },
+        },
+    ];
+}
+/** True iff `name` is one of the builtin tool names. Cheap O(1) check
+ *  the dispatcher uses to decide whether to handle vs pass through. */
+export function isBuiltinToolName(name) {
+    switch (name) {
+        case 'native_echo':
+        case 'native_now':
+        case 'native_sleep_ms':
+        case 'native_random_uuid':
+            return true;
+        default:
+            return false;
+    }
+}
+/**
+ * Build the built-in dispatcher. Returns a ToolDispatcher compatible
+ * with combineDispatchers — i.e. an unknown tool name yields a
+ * `{source:'unknown'}` result so the next dispatcher in the chain gets
+ * a turn. Combine like this:
+ *
+ *     const dispatch = combineDispatchers(
+ *       buildBuiltinDispatcher(),
+ *       buildMcpDispatcher(),
+ *     )
+ */
+export function buildBuiltinDispatcher() {
+    return async (call, signal) => {
+        switch (call.name) {
+            case 'native_echo':
+                return runEcho(call.arguments);
+            case 'native_now':
+                return runNow();
+            case 'native_sleep_ms':
+                return runSleep(call.arguments, signal);
+            case 'native_random_uuid':
+                return runRandomUuid();
+            default:
+                return {
+                    text: `unknown tool "${call.name}" (not in builtin set)`,
+                    isError: true,
+                    source: 'unknown',
+                };
+        }
+    };
+}
+// ─── tool impls ──────────────────────────────────────────────────────
+function runEcho(args) {
+    const text = typeof args.text === 'string' ? args.text : '';
+    return { text, isError: false, source: 'builtin' };
+}
+function runNow() {
+    const offsetHours = resolveTzOffsetHours();
+    const now = new Date();
+    // Build the offset string ourselves so we don't pull in a TZ DB.
+    const sign = offsetHours >= 0 ? '+' : '-';
+    const absHours = Math.abs(offsetHours);
+    const hh = Math.floor(absHours).toString().padStart(2, '0');
+    const mm = Math.round((absHours - Math.floor(absHours)) * 60).toString().padStart(2, '0');
+    const offsetStr = `UTC${sign}${hh}:${mm}`;
+    // Apply the offset to the UTC clock to get the wall-clock string in
+    // the operator's chosen zone. This is intentionally NOT a JS Date
+    // mutation (which would imply a real timezone); it's just a display.
+    const shifted = new Date(now.getTime() + offsetHours * 3600_000);
+    const local = shifted.toISOString().replace(/Z$/, '');
+    return {
+        text: JSON.stringify({
+            utc: now.toISOString(),
+            local,
+            offset: offsetStr,
+        }),
+        isError: false,
+        source: 'builtin',
+    };
+}
+async function runSleep(args, signal) {
+    const raw = typeof args.ms === 'number' ? args.ms : Number(args.ms);
+    if (!Number.isFinite(raw)) {
+        return { text: 'ms must be a number', isError: true, source: 'builtin' };
+    }
+    const ms = Math.max(0, Math.min(MAX_SLEEP_MS, Math.floor(raw)));
+    try {
+        await new Promise((resolve, reject) => {
+            if (signal.aborted) {
+                reject(signal.reason ?? new Error('aborted'));
+                return;
+            }
+            const t = setTimeout(() => {
+                signal.removeEventListener('abort', onAbort);
+                resolve();
+            }, ms);
+            const onAbort = () => {
+                clearTimeout(t);
+                reject(signal.reason ?? new Error('aborted'));
+            };
+            signal.addEventListener('abort', onAbort, { once: true });
+        });
+        return { text: `slept ${ms}ms`, isError: false, source: 'builtin' };
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        log.debug({ event: 'builtin.sleep.aborted', err: msg });
+        return { text: `sleep aborted after partial wait: ${msg}`, isError: true, source: 'builtin' };
+    }
+}
+function runRandomUuid() {
+    return { text: randomUUID(), isError: false, source: 'builtin' };
+}
+// ─── helpers ─────────────────────────────────────────────────────────
+function resolveTzOffsetHours() {
+    const raw = process.env.IMHUB_TZ_OFFSET_HOURS;
+    if (raw) {
+        const n = Number(raw);
+        if (Number.isFinite(n) && n >= -14 && n <= 14)
+            return n;
+    }
+    return 8; // Asia/Shanghai default — matches the rest of agim
+}
+//# sourceMappingURL=builtin-dispatcher.js.map

package/dist/core/llm/builtin-dispatcher.js.map

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

package/dist/core/llm/imhub-dispatcher.d.ts

@@ -0,0 +1,27 @@
+import { logger as rootLogger } from '../logger.js';
+import type { ToolDispatcher } from './tool-dispatcher.js';
+import type { ToolDef } from './provider-base.js';
+/** Per-turn caller identity. Matches the subset of `RunContext` the
+ *  agim RPC handlers consume + the optional `agent` for A2A self-call
+ *  detection. */
+export interface ImhubDispatcherCtx {
+    platform: string;
+    channelId: string;
+    threadId: string;
+    userId: string;
+    /** Calling agent name. A2A uses this to reject self-calls. */
+    callerAgent: string;
+    /** Optional pino-compatible logger for the RouteContext A2A needs. */
+    logger?: typeof rootLogger;
+    /** Optional A2A depth — defaults to 0 for native-originated calls. */
+    callerDepth?: number;
+}
+/**
+ * Tool roster the LLM sees. JSON Schemas are kept terse — they match
+ * the RPC handlers' real expectations without copying claude-code's
+ * MCP server's full prose docstrings, which can grow to multi-KB.
+ */
+export declare function getImhubTools(): ToolDef[];
+/** Build a dispatcher closure over the per-turn IM context. */
+export declare function buildImhubDispatcher(ctx: ImhubDispatcherCtx): ToolDispatcher;
+//# sourceMappingURL=imhub-dispatcher.d.ts.map

package/dist/core/llm/imhub-dispatcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"imhub-dispatcher.d.ts","sourceRoot":"","sources":["../../../src/core/llm/imhub-dispatcher.ts"],"names":[],"mappings":"AAoCA,OAAO,EAAE,MAAM,IAAI,UAAU,EAAE,MAAM,cAAc,CAAA;AACnD,OAAO,KAAK,EAAE,cAAc,EAAoB,MAAM,sBAAsB,CAAA;AAC5E,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAA;AAUjD;;iBAEiB;AACjB,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,MAAM,CAAA;IAChB,SAAS,EAAE,MAAM,CAAA;IACjB,QAAQ,EAAE,MAAM,CAAA;IAChB,MAAM,EAAE,MAAM,CAAA;IACd,8DAA8D;IAC9D,WAAW,EAAE,MAAM,CAAA;IACnB,sEAAsE;IACtE,MAAM,CAAC,EAAE,OAAO,UAAU,CAAA;IAC1B,sEAAsE;IACtE,WAAW,CAAC,EAAE,MAAM,CAAA;CACrB;AA4BD;;;;GAIG;AACH,wBAAgB,aAAa,IAAI,OAAO,EAAE,CAoIzC;AAED,+DAA+D;AAC/D,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,kBAAkB,GAAG,cAAc,CAmG5E"}

package/dist/core/llm/imhub-dispatcher.js

@@ -0,0 +1,308 @@
+// imhub-dispatcher — wires agim's internal RPC handlers (skills /
+// memo / push / ask-user / a2a) into the native LLM agent loop so a
+// `native` adapter call can invoke `mcp__imhub__read_skill` etc. with
+// the exact same wire shape claude-code's MCP sidecar exposes to
+// `claude-code` / `codex` / `opencode`.
+//
+// Why this file exists
+// --------------------
+// `mcp-client.ts` in this directory only handles operator-configured
+// external MCP servers (stdio / sse / streamable-http). The "imhub"
+// tools (read_skill, save_memo, ask_user, push_message, call_agent…)
+// live inside the agim process and historically were only reachable
+// via the claude-code MCP sidecar process. Before this file, a native
+// agent could only call the four `native_*` built-ins (echo, now,
+// sleep, random_uuid) — it couldn't read its own skills, save a
+// memo, or hand off to claude-code via call_agent.
+//
+// What this file does
+// -------------------
+// 1. `getImhubTools()` returns the `ToolDef[]` to advertise to the
+//    LLM, all named `mcp__imhub__<op>` so the LLM and downstream
+//    audit observers see the same tool naming as the claude-code MCP
+//    surface.
+// 2. `buildImhubDispatcher(ctx)` returns a `ToolDispatcher` that
+//    receives a per-IM-turn `RunContext`-equivalent (closure) and
+//    routes each call into the corresponding RPC handler.
+//
+// Tool naming uses double-underscore (`mcp__imhub__read_skill`) to
+// stay byte-identical to the claude-code MCP-server-emitted names —
+// log greps, audit dashboards, and policy gates configured against
+// the claude-code surface keep matching when native is in use.
+//
+// Anything the dispatcher doesn't recognise returns
+// `source: 'unknown'` so `combineDispatchers(builtin, imhub, mcp)`
+// can fall through to the next layer (external MCP servers).
+import { logger as rootLogger } from '../logger.js';
+import { handleSkillsOp } from '../skills-rpc.js';
+import { handleMemoOp } from '../memo-rpc.js';
+import { handlePushOp } from '../push-rpc.js';
+import { handleAskOp } from '../ask-user-rpc.js';
+import { callAgentByName } from '../a2a.js';
+const log = rootLogger.child({ component: 'imhub-dispatcher' });
+function safeJson(v) {
+    try {
+        return JSON.stringify(v, null, 2);
+    }
+    catch {
+        return String(v);
+    }
+}
+function ok(text) {
+    return { text, isError: false, source: 'imhub' };
+}
+function err(text) {
+    return { text, isError: true, source: 'imhub' };
+}
+function unknown(name) {
+    // matches builtin-dispatcher's marker so combineDispatchers falls
+    // through to the next dispatcher in the stack.
+    return {
+        text: `imhub-dispatcher: no handler for "${name}"`,
+        isError: true,
+        source: 'unknown',
+    };
+}
+/**
+ * Tool roster the LLM sees. JSON Schemas are kept terse — they match
+ * the RPC handlers' real expectations without copying claude-code's
+ * MCP server's full prose docstrings, which can grow to multi-KB.
+ */
+export function getImhubTools() {
+    return [
+        {
+            name: 'mcp__imhub__read_skill',
+            description: 'Read the full body of one agim skill (a markdown reference card maintained by the operator). The skill summary is already injected into the system prompt; call this when you need the full text (examples, exact slash command syntax, gotchas).',
+            parameters: {
+                type: 'object',
+                properties: {
+                    name: { type: 'string', description: 'Skill name as shown in the system prompt list, e.g. "agim-self".' },
+                },
+                required: ['name'],
+            },
+        },
+        {
+            name: 'mcp__imhub__list_skills',
+            description: 'Enumerate every skill currently available to this agim install (name + one-line description). Cheap; use it instead of guessing what skill names exist.',
+            parameters: { type: 'object', properties: {} },
+        },
+        {
+            name: 'mcp__imhub__save_memo',
+            description: 'Record any kind of memo for the user (5W1H). Extract `what` (required), plus `who`, `when_at` / `when_text`, `where_lat`/`where_lng`/`where_label` or `address`, `how`, `why`, `memo` (full original phrasing) from the user message. Defaults to permanent storage; pass `expires_in_hours` for transient notes. All times Asia/Shanghai (UTC+8) format "YYYY-MM-DD HH:MM:SS".',
+            parameters: {
+                type: 'object',
+                properties: {
+                    what: { type: 'string', description: 'Core thing being recorded (REQUIRED, ≤200 chars).' },
+                    who: { type: 'string' },
+                    when_at: { type: 'string', description: 'UTC+8 datetime "YYYY-MM-DD HH:MM:SS".' },
+                    when_text: { type: 'string', description: 'Raw user phrase if when_at not parseable.' },
+                    where_lat: { type: 'number' },
+                    where_lng: { type: 'number' },
+                    where_label: { type: 'string' },
+                    address: { type: 'string', description: 'Free-text address; server geocodes when lat/lng absent.' },
+                    how: { type: 'string' },
+                    why: { type: 'string' },
+                    memo: { type: 'string', description: 'Full original phrasing of the user request.' },
+                    expires_in_hours: { type: 'number', description: 'Auto-expire after N hours. Omit for permanent.' },
+                },
+                required: ['what'],
+            },
+        },
+        {
+            name: 'mcp__imhub__search_memos',
+            description: 'Recall memos for queries about saved knowledge ("我的车在哪", "我爸爸的生日"). Combines free-text query with optional structured filters; all filters AND-combine.',
+            parameters: {
+                type: 'object',
+                properties: {
+                    query: { type: 'string', description: 'Free-text — fuzzy LIKE match across what/who/where_label/how/why/when_text/memo.' },
+                    what: { type: 'string' },
+                    who: { type: 'string' },
+                    has_location: { type: 'boolean' },
+                    when_after: { type: 'string', description: 'UTC+8 "YYYY-MM-DD HH:MM:SS"; memos with when_at OR created_at ≥ this.' },
+                    when_before: { type: 'string' },
+                    limit: { type: 'integer', minimum: 1, maximum: 50, default: 10 },
+                    include_expired: { type: 'boolean', default: false },
+                },
+            },
+        },
+        {
+            name: 'mcp__imhub__update_memo',
+            description: 'Patch an existing memo by id. Pass only the fields you want to change.',
+            parameters: {
+                type: 'object',
+                properties: {
+                    id: { type: 'integer' },
+                    what: { type: 'string' },
+                    who: { type: 'string' },
+                    when_at: { type: 'string' },
+                    when_text: { type: 'string' },
+                    where_lat: { type: 'number' },
+                    where_lng: { type: 'number' },
+                    where_label: { type: 'string' },
+                    memo: { type: 'string' },
+                    expires_in_hours: { type: 'number' },
+                },
+                required: ['id'],
+            },
+        },
+        {
+            name: 'mcp__imhub__delete_memo',
+            description: 'Drop one memo by id.',
+            parameters: {
+                type: 'object',
+                properties: { id: { type: 'integer' } },
+                required: ['id'],
+            },
+        },
+        {
+            name: 'mcp__imhub__push_message',
+            description: 'Push a follow-up message back into the caller IM thread without waiting for the next user turn. Use for proactive notifications during long-running tasks. Default pushes into the caller thread; cross-thread requires operator opt-in (IMHUB_PUSH_CROSS_THREAD=on).',
+            parameters: {
+                type: 'object',
+                properties: {
+                    text: { type: 'string', description: 'Body to push. Required.' },
+                    toThread: { type: 'string', description: 'Optional override "<platform>:<channelId>:<threadId>". Cross-thread requires operator opt-in.' },
+                },
+                required: ['text'],
+            },
+        },
+        {
+            name: 'mcp__imhub__ask_user',
+            description: 'Present the user with an N-way multiple-choice question and reliably get a typed answer back (1-indexed). Use when you need disambiguation rather than free-form chat. Default timeout 90s.',
+            parameters: {
+                type: 'object',
+                properties: {
+                    question: { type: 'string', description: 'Single-line question, ≤400 chars.' },
+                    choices: { type: 'array', items: { type: 'string' }, description: '2-9 short choice labels.' },
+                    timeoutSec: { type: 'integer', minimum: 5, maximum: 600, default: 90 },
+                    allowTextReply: { type: 'boolean', default: true, description: 'When true, text "1"/"a"/label substring also matches.' },
+                },
+                required: ['question', 'choices'],
+            },
+        },
+        {
+            name: 'mcp__imhub__call_agent',
+            description: 'Hand off a prompt to another registered agent (claude-code, codex, opencode, antigravity, native, or any remote ACP). Subject to A2A guardrails: depth limit, self-call ban, workspace ACL, per-user budget. Returns the callee\'s final text.',
+            parameters: {
+                type: 'object',
+                properties: {
+                    agent: { type: 'string', description: 'Target agent name. Must not be the caller.' },
+                    prompt: { type: 'string', description: 'Prompt to send.' },
+                },
+                required: ['agent', 'prompt'],
+            },
+        },
+    ];
+}
+/** Build a dispatcher closure over the per-turn IM context. */
+export function buildImhubDispatcher(ctx) {
+    const runCtxBase = {
+        threadId: ctx.threadId,
+        platform: ctx.platform,
+        userId: ctx.userId,
+        channelId: ctx.channelId,
+    };
+    return async (call, signal) => {
+        if (!call.name.startsWith('mcp__imhub__'))
+            return unknown(call.name);
+        const op = call.name.slice('mcp__imhub__'.length);
+        const args = (call.arguments && typeof call.arguments === 'object' ? call.arguments : {});
+        try {
+            switch (op) {
+                case 'read_skill': {
+                    const r = await handleSkillsOp({ op: 'read', name: args.name });
+                    if (!r.ok)
+                        return err(`read_skill failed: ${r.error}`);
+                    if (r.result.op !== 'read')
+                        return err('unexpected response shape');
+                    if (!r.result.available)
+                        return err(`skill "${r.result.name}" unavailable: ${r.result.unavailableReason || 'unknown'}`);
+                    return ok(r.result.body);
+                }
+                case 'list_skills': {
+                    const r = await handleSkillsOp({ op: 'list' });
+                    if (!r.ok)
+                        return err(`list_skills failed: ${r.error}`);
+                    return ok(safeJson(r.result));
+                }
+                case 'save_memo': {
+                    const r = await handleMemoOp('save', args, runCtxBase);
+                    if (!r.ok)
+                        return err(`save_memo failed: ${r.error}`);
+                    return ok(safeJson(r.result));
+                }
+                case 'search_memos': {
+                    const r = await handleMemoOp('search', args, runCtxBase);
+                    if (!r.ok)
+                        return err(`search_memos failed: ${r.error}`);
+                    return ok(safeJson(r.result));
+                }
+                case 'update_memo': {
+                    const r = await handleMemoOp('update', args, runCtxBase);
+                    if (!r.ok)
+                        return err(`update_memo failed: ${r.error}`);
+                    return ok(safeJson(r.result));
+                }
+                case 'delete_memo': {
+                    const r = await handleMemoOp('delete', args, runCtxBase);
+                    if (!r.ok)
+                        return err(`delete_memo failed: ${r.error}`);
+                    return ok(safeJson(r.result));
+                }
+                case 'push_message': {
+                    const r = await handlePushOp(args, runCtxBase);
+                    if (!r.ok)
+                        return err(`push_message failed: ${r.error}`);
+                    return ok(safeJson(r.result));
+                }
+                case 'ask_user': {
+                    const r = await handleAskOp(args, runCtxBase);
+                    if (!r.ok)
+                        return err(`ask_user failed (${r.reason || 'error'}): ${r.error}`);
+                    return ok(safeJson(r.result));
+                }
+                case 'call_agent': {
+                    const agentName = typeof args.agent === 'string' ? args.agent : '';
+                    const prompt = typeof args.prompt === 'string' ? args.prompt : '';
+                    if (!agentName || !prompt)
+                        return err('call_agent requires both `agent` (string) and `prompt` (string).');
+                    // Construct a minimal RouteContext from the run context so A2A
+                    // can audit / route. Lifted to a partial cast because most of
+                    // RouteContext's optional fields (intent, agentSessionId, …)
+                    // are only used by full-router dispatch — not A2A.
+                    const routeCtx = {
+                        channelId: ctx.channelId,
+                        threadId: ctx.threadId,
+                        platform: ctx.platform,
+                        userId: ctx.userId,
+                        defaultAgent: ctx.callerAgent,
+                        traceId: `native-a2a-${Date.now()}`,
+                        logger: (ctx.logger ?? rootLogger).child({ component: 'a2a-from-native', threadId: ctx.threadId }),
+                    };
+                    const result = await callAgentByName(agentName, prompt, routeCtx, {
+                        callerDepth: ctx.callerDepth ?? 0,
+                        callerAgent: ctx.callerAgent,
+                    });
+                    if (!result.ok)
+                        return err(`call_agent failed: ${result.error}`);
+                    // CallAgentResult exposes the callee's final text as `result`.
+                    // Outputs, jobId, durationMs etc. are returned as a JSON
+                    // sidecar so the model can reference produced artifacts if
+                    // it asks for them — keeps the main payload terse.
+                    return ok(typeof result.result === 'string' ? result.result : safeJson(result));
+                }
+                default:
+                    return unknown(call.name);
+            }
+        }
+        catch (e) {
+            const msg = e instanceof Error ? e.message : String(e);
+            log.warn({ event: 'imhub.dispatcher.error', name: call.name, err: msg });
+            return err(`imhub.${op} crashed: ${msg}`);
+        }
+        finally {
+            void signal; // signal is provided for future cancellation; current handlers don't honour it.
+        }
+    };
+}
+//# sourceMappingURL=imhub-dispatcher.js.map

package/dist/core/llm/imhub-dispatcher.js.map

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

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

@@ -0,0 +1,11 @@
+export { LlmProvider, LlmProviderError, type ChatOptions, type ChatResult, type ChatStreamChunk, type FinishReason, type LlmMessage, type LlmMessageRole, type LlmUsage, type ProviderConfigBase, type NormalizedOptions, type ToolCallRequest, type ToolChoice, type ToolDef, } from './provider-base.js';
+export { OpenAICompatProvider, type OpenAICompatProviderConfig, } from './openai-compat-provider.js';
+export { AnthropicProvider, type AnthropicProviderConfig, } from './anthropic-provider.js';
+export { loadFromConfig, getProvider, getProviderByName, listProviders, describeRegistry, _resetRegistry, type LlmRole, } from './registry.js';
+export { LLM_SECRETS_PATH, envKeyForBackend, loadSecretsFile, resolveSecret, saveSecret, removeSecret, listConfiguredBackends, describeSecretSource, } from './secrets.js';
+export { tryIntrospect, type IntrospectionInput, type IntrospectionResult, } from './introspection.js';
+export { McpClient, type McpServerConfig, type ToolCallResult, } from './mcp-client.js';
+export { loadFromConfig as loadMcpFromConfig, connectAll as connectAllMcp, getAllTools as getAllMcpTools, getOwningServer as getMcpOwningServer, callToolByName as callMcpToolByName, describeRegistry as describeMcpRegistry, closeAll as closeAllMcp, _resetRegistry as _resetMcpRegistry, } from './mcp-registry.js';
+export { runAgentLoop, alwaysAllowGate, type AgentLoopInput, type AgentLoopResult, type ApprovalGate, type LoopFinishReason, type ToolCallReport, } from './agent-loop.js';
+export { buildMcpDispatcher, combineDispatchers, type DispatcherResult, type ToolDispatcher, } from './tool-dispatcher.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/llm/index.ts"],"names":[],"mappings":"AAMA,OAAO,EACL,WAAW,EACX,gBAAgB,EAChB,KAAK,WAAW,EAChB,KAAK,UAAU,EACf,KAAK,eAAe,EACpB,KAAK,YAAY,EACjB,KAAK,UAAU,EACf,KAAK,cAAc,EACnB,KAAK,QAAQ,EACb,KAAK,kBAAkB,EACvB,KAAK,iBAAiB,EACtB,KAAK,eAAe,EACpB,KAAK,UAAU,EACf,KAAK,OAAO,GACb,MAAM,oBAAoB,CAAA;AAE3B,OAAO,EACL,oBAAoB,EACpB,KAAK,0BAA0B,GAChC,MAAM,6BAA6B,CAAA;AAEpC,OAAO,EACL,iBAAiB,EACjB,KAAK,uBAAuB,GAC7B,MAAM,yBAAyB,CAAA;AAEhC,OAAO,EACL,cAAc,EACd,WAAW,EACX,iBAAiB,EACjB,aAAa,EACb,gBAAgB,EAChB,cAAc,EACd,KAAK,OAAO,GACb,MAAM,eAAe,CAAA;AAEtB,OAAO,EACL,gBAAgB,EAChB,gBAAgB,EAChB,eAAe,EACf,aAAa,EACb,UAAU,EACV,YAAY,EACZ,sBAAsB,EACtB,oBAAoB,GACrB,MAAM,cAAc,CAAA;AAErB,OAAO,EACL,aAAa,EACb,KAAK,kBAAkB,EACvB,KAAK,mBAAmB,GACzB,MAAM,oBAAoB,CAAA;AAE3B,OAAO,EACL,SAAS,EACT,KAAK,eAAe,EACpB,KAAK,cAAc,GACpB,MAAM,iBAAiB,CAAA;AAExB,OAAO,EACL,cAAc,IAAI,iBAAiB,EACnC,UAAU,IAAI,aAAa,EAC3B,WAAW,IAAI,cAAc,EAC7B,eAAe,IAAI,kBAAkB,EACrC,cAAc,IAAI,iBAAiB,EACnC,gBAAgB,IAAI,mBAAmB,EACvC,QAAQ,IAAI,WAAW,EACvB,cAAc,IAAI,iBAAiB,GACpC,MAAM,mBAAmB,CAAA;AAE1B,OAAO,EACL,YAAY,EACZ,eAAe,EACf,KAAK,cAAc,EACnB,KAAK,eAAe,EACpB,KAAK,YAAY,EACjB,KAAK,gBAAgB,EACrB,KAAK,cAAc,GACpB,MAAM,iBAAiB,CAAA;AAExB,OAAO,EACL,kBAAkB,EAClB,kBAAkB,EAClB,KAAK,gBAAgB,EACrB,KAAK,cAAc,GACpB,MAAM,sBAAsB,CAAA"}

package/dist/core/llm/index.js

@@ -0,0 +1,16 @@
+// Barrel re-export — the public surface of the native LLM client (D+ Stage 1).
+//
+// Internal modules should import from `./llm/index.js` to keep deep-path
+// imports out of caller code. Stage 2 will add tool-loop / MCP exports
+// here without breaking Stage-1 callers.
+export { LlmProvider, LlmProviderError, } from './provider-base.js';
+export { OpenAICompatProvider, } from './openai-compat-provider.js';
+export { AnthropicProvider, } from './anthropic-provider.js';
+export { loadFromConfig, getProvider, getProviderByName, listProviders, describeRegistry, _resetRegistry, } from './registry.js';
+export { LLM_SECRETS_PATH, envKeyForBackend, loadSecretsFile, resolveSecret, saveSecret, removeSecret, listConfiguredBackends, describeSecretSource, } from './secrets.js';
+export { tryIntrospect, } from './introspection.js';
+export { McpClient, } from './mcp-client.js';
+export { loadFromConfig as loadMcpFromConfig, connectAll as connectAllMcp, getAllTools as getAllMcpTools, getOwningServer as getMcpOwningServer, callToolByName as callMcpToolByName, describeRegistry as describeMcpRegistry, closeAll as closeAllMcp, _resetRegistry as _resetMcpRegistry, } from './mcp-registry.js';
+export { runAgentLoop, alwaysAllowGate, } from './agent-loop.js';
+export { buildMcpDispatcher, combineDispatchers, } from './tool-dispatcher.js';
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/core/llm/index.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,EAAE;AACF,yEAAyE;AACzE,uEAAuE;AACvE,yCAAyC;AAEzC,OAAO,EACL,WAAW,EACX,gBAAgB,GAajB,MAAM,oBAAoB,CAAA;AAE3B,OAAO,EACL,oBAAoB,GAErB,MAAM,6BAA6B,CAAA;AAEpC,OAAO,EACL,iBAAiB,GAElB,MAAM,yBAAyB,CAAA;AAEhC,OAAO,EACL,cAAc,EACd,WAAW,EACX,iBAAiB,EACjB,aAAa,EACb,gBAAgB,EAChB,cAAc,GAEf,MAAM,eAAe,CAAA;AAEtB,OAAO,EACL,gBAAgB,EAChB,gBAAgB,EAChB,eAAe,EACf,aAAa,EACb,UAAU,EACV,YAAY,EACZ,sBAAsB,EACtB,oBAAoB,GACrB,MAAM,cAAc,CAAA;AAErB,OAAO,EACL,aAAa,GAGd,MAAM,oBAAoB,CAAA;AAE3B,OAAO,EACL,SAAS,GAGV,MAAM,iBAAiB,CAAA;AAExB,OAAO,EACL,cAAc,IAAI,iBAAiB,EACnC,UAAU,IAAI,aAAa,EAC3B,WAAW,IAAI,cAAc,EAC7B,eAAe,IAAI,kBAAkB,EACrC,cAAc,IAAI,iBAAiB,EACnC,gBAAgB,IAAI,mBAAmB,EACvC,QAAQ,IAAI,WAAW,EACvB,cAAc,IAAI,iBAAiB,GACpC,MAAM,mBAAmB,CAAA;AAE1B,OAAO,EACL,YAAY,EACZ,eAAe,GAMhB,MAAM,iBAAiB,CAAA;AAExB,OAAO,EACL,kBAAkB,EAClB,kBAAkB,GAGnB,MAAM,sBAAsB,CAAA"}