@moikapy/lich 0.5.1 → 0.7.0

package/dist/index.d.ts

@@ -23,107 +23,6 @@ interface JsonSchemaObject {
     additionalProperties?: boolean;
 }
 
-interface ToolResult {
-    ok: boolean;
-    output: string;
-    error?: string;
-}
-interface ToolContext {
-    work_dir: string;
-    env: Record<string, string>;
-    signal?: AbortSignal;
-}
-interface Tool {
-    name: string;
-    description: string;
-    parameters: JsonSchemaObject;
-    /** Per-tool executor timeout override in ms; unset tools get the 30s default. */
-    timeout_ms?: number;
-    execute(args: Record<string, unknown>, context: ToolContext): Promise<ToolResult>;
-}
-interface Toolset {
-    name: string;
-    tools: Tool[];
-}
-
-/**
- * Plugin surface: user-authored tools and lifecycle hooks loaded at startup.
- *
- * A plugin is a plain object exported from a TS/JS module. Hooks observe and
- * (in the case of before_tool_call) veto tool executions; tools merge into the
- * agent registry after builtin filtering.
- */
-
-/** Runtime info handed to every hook call. */
-interface HookContext {
-    work_dir: string;
-    /**
-     * This plugin's own per-run state sub-map. Every hook invocation receives
-     * a ctx exposing only the invoking plugin's bag; the bag is swapped fresh
-     * at each run start. Absent only on hand-built contexts outside the runner.
-     */
-    state?: Map<string, unknown>;
-}
-/** Argument passed to before_tool_call hooks. */
-interface BeforeToolCallInfo {
-    tool_name: string;
-    args: Record<string, unknown>;
-}
-/** Return value that vetoes a tool call; other hooks still run. */
-interface BeforeToolCallResult {
-    block?: boolean;
-    reason?: string;
-}
-/** Argument passed to after_tool_call hooks. */
-interface AfterToolCallInfo extends BeforeToolCallInfo {
-    result_summary: string;
-    /** Structured executor outcome; gate on this, never parse result_summary. */
-    ok: boolean;
-    error?: string;
-}
-interface RunEndInfo {
-    stopped_reason: string;
-    turns_used: number;
-}
-/** Optional lifecycle hooks a plugin may implement. All hooks are awaited. */
-interface PluginHooks {
-    before_tool_call?(info: BeforeToolCallInfo, ctx: HookContext): Promise<BeforeToolCallResult | void> | BeforeToolCallResult | void;
-    after_tool_call?(info: AfterToolCallInfo, ctx: HookContext): Promise<void> | void;
-    on_run_start?(info: {
-        input_chars: number;
-    }, ctx: HookContext): Promise<void> | void;
-    on_run_end?(info: RunEndInfo, ctx: HookContext): Promise<void> | void;
-}
-/** A user plugin: required unique name, optional tools and hooks. */
-interface Plugin {
-    name: string;
-    version?: string;
-    tools?: Tool[];
-    hooks?: PluginHooks;
-}
-
-/** A successfully loaded plugin plus the entry path it came from. */
-interface LoadedPlugin {
-    plugin: Plugin;
-    entry: string;
-}
-/** One failed entry: the specifier and why it failed. */
-interface PluginLoadError {
-    entry: string;
-    error_message: string;
-}
-/**
- * Load plugins from explicit entry paths (relative to `base_dir` or absolute).
- * Broken imports, missing exports, and duplicate names become error entries;
- * nothing is thrown for a bad plugin.
- */
-declare function load_plugins(entries: readonly string[], base_dir: string): Promise<{
-    plugins: LoadedPlugin[];
-    errors: PluginLoadError[];
-}>;
-/** Joined one-liner per load error, for a single warn log. */
-declare function plugin_errors_summary(errors: readonly PluginLoadError[]): string;
-
 type FinishReason = "stop" | "tool_calls" | "length" | "error" | "unknown";
 type ProviderErrorKind = "rate_limit" | "network" | "auth" | "overflow" | "bad_request" | "unknown";
 interface ToolCall {
@@ -212,7 +111,7 @@ declare class ProviderError extends Error {
  */
 
 declare const agent_config_schema: z.ZodEffects<z.ZodObject<{
-    /** Display name used by the TUI banner. */
+    /** Wizard label. The TUI banner uses the active theme welcome string. */
     agent_name: z.ZodDefault<z.ZodString>;
     system_prompt: z.ZodOptional<z.ZodString>;
     max_turns: z.ZodDefault<z.ZodNumber>;
@@ -269,9 +168,53 @@ declare const agent_config_schema: z.ZodEffects<z.ZodObject<{
         token_envs?: Record<string, string> | undefined;
     }>>;
     log_level: z.ZodDefault<z.ZodEnum<["debug", "info", "warn", "error"]>>;
+    theme: z.ZodDefault<z.ZodString>;
+    /** Named MCP servers. Each entry is stdio or loopback http. Default off. */
+    mcp_servers: z.ZodOptional<z.ZodEffects<z.ZodRecord<z.ZodString, z.ZodUnion<[z.ZodObject<{
+        enabled: z.ZodDefault<z.ZodBoolean>;
+        command: z.ZodString;
+        args: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+        env: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    }, "strict", z.ZodTypeAny, {
+        enabled: boolean;
+        command: string;
+        args: string[];
+        env?: Record<string, string> | undefined;
+    }, {
+        command: string;
+        enabled?: boolean | undefined;
+        args?: string[] | undefined;
+        env?: Record<string, string> | undefined;
+    }>, z.ZodObject<{
+        enabled: z.ZodDefault<z.ZodBoolean>;
+        url: z.ZodString;
+    }, "strict", z.ZodTypeAny, {
+        url: string;
+        enabled: boolean;
+    }, {
+        url: string;
+        enabled?: boolean | undefined;
+    }>]>>, Record<string, {
+        enabled: boolean;
+        command: string;
+        args: string[];
+        env?: Record<string, string> | undefined;
+    } | {
+        url: string;
+        enabled: boolean;
+    }>, Record<string, {
+        command: string;
+        enabled?: boolean | undefined;
+        args?: string[] | undefined;
+        env?: Record<string, string> | undefined;
+    } | {
+        url: string;
+        enabled?: boolean | undefined;
+    }>>>;
 }, "strip", z.ZodTypeAny, {
     max_turns: number;
     log_level: "debug" | "info" | "warn" | "error";
+    theme: string;
     providers: z.objectOutputType<{
         kind: z.ZodEnum<["openai_compat", "anthropic", "ollama"]>;
         name: z.ZodString;
@@ -298,6 +241,15 @@ declare const agent_config_schema: z.ZodEffects<z.ZodObject<{
     } | undefined;
     temperature?: number | undefined;
     max_tokens?: number | undefined;
+    mcp_servers?: Record<string, {
+        enabled: boolean;
+        command: string;
+        args: string[];
+        env?: Record<string, string> | undefined;
+    } | {
+        url: string;
+        enabled: boolean;
+    }> | undefined;
 }, {
     providers: z.objectInputType<{
         kind: z.ZodEnum<["openai_compat", "anthropic", "ollama"]>;
@@ -315,6 +267,7 @@ declare const agent_config_schema: z.ZodEffects<z.ZodObject<{
     system_prompt?: string | undefined;
     session_dir?: string | undefined;
     log_level?: "debug" | "info" | "warn" | "error" | undefined;
+    theme?: string | undefined;
     gateway?: {
         platforms?: ("webhook" | "telegram" | "discord" | "twitch")[] | undefined;
         token_envs?: Record<string, string> | undefined;
@@ -327,12 +280,22 @@ declare const agent_config_schema: z.ZodEffects<z.ZodObject<{
     compress_threshold?: number | undefined;
     terminal_timeout_ms?: number | undefined;
     plugins?: string[] | undefined;
+    mcp_servers?: Record<string, {
+        command: string;
+        enabled?: boolean | undefined;
+        args?: string[] | undefined;
+        env?: Record<string, string> | undefined;
+    } | {
+        url: string;
+        enabled?: boolean | undefined;
+    }> | undefined;
 }>, {
     work_dir: string;
     providers: ProviderConfig[];
     session_dir: string;
     max_turns: number;
     log_level: "debug" | "info" | "warn" | "error";
+    theme: string;
     agent_name: string;
     tools_enabled: string[] | "all";
     context_budget_tokens: number;
@@ -346,6 +309,15 @@ declare const agent_config_schema: z.ZodEffects<z.ZodObject<{
     } | undefined;
     temperature?: number | undefined;
     max_tokens?: number | undefined;
+    mcp_servers?: Record<string, {
+        enabled: boolean;
+        command: string;
+        args: string[];
+        env?: Record<string, string> | undefined;
+    } | {
+        url: string;
+        enabled: boolean;
+    }> | undefined;
 }, {
     providers: z.objectInputType<{
         kind: z.ZodEnum<["openai_compat", "anthropic", "ollama"]>;
@@ -363,6 +335,7 @@ declare const agent_config_schema: z.ZodEffects<z.ZodObject<{
     system_prompt?: string | undefined;
     session_dir?: string | undefined;
     log_level?: "debug" | "info" | "warn" | "error" | undefined;
+    theme?: string | undefined;
     gateway?: {
         platforms?: ("webhook" | "telegram" | "discord" | "twitch")[] | undefined;
         token_envs?: Record<string, string> | undefined;
@@ -375,10 +348,154 @@ declare const agent_config_schema: z.ZodEffects<z.ZodObject<{
     compress_threshold?: number | undefined;
     terminal_timeout_ms?: number | undefined;
     plugins?: string[] | undefined;
+    mcp_servers?: Record<string, {
+        command: string;
+        enabled?: boolean | undefined;
+        args?: string[] | undefined;
+        env?: Record<string, string> | undefined;
+    } | {
+        url: string;
+        enabled?: boolean | undefined;
+    }> | undefined;
 }>;
 type AgentConfig = z.infer<typeof agent_config_schema>;
 declare function parse_agent_config(raw: unknown): AgentConfig;
 
+interface ToolResult {
+    ok: boolean;
+    output: string;
+    error?: string;
+}
+interface ToolContext {
+    work_dir: string;
+    env: Record<string, string>;
+    signal?: AbortSignal;
+}
+interface Tool {
+    name: string;
+    description: string;
+    parameters: JsonSchemaObject;
+    /** Per-tool executor timeout override in ms; unset tools get the 30s default. */
+    timeout_ms?: number;
+    execute(args: Record<string, unknown>, context: ToolContext): Promise<ToolResult>;
+}
+interface Toolset {
+    name: string;
+    tools: Tool[];
+}
+
+/**
+ * Name-keyed registry of tools and toolsets. Registration rejects duplicate
+ * tool names so conflicting builtins fail loudly at startup.
+ */
+declare class ToolRegistry {
+    private readonly tools;
+    register(tool: Tool): void;
+    register_toolset(toolset: Toolset): void;
+    get(name: string): Tool | undefined;
+    has(name: string): boolean;
+    list(): Tool[];
+    /** Map registered tools onto the provider-facing wire shape. */
+    definitions(): ToolDefinition[];
+}
+
+interface LineChild {
+    write_line(line: string): void;
+    read_line(): Promise<string | undefined>;
+    stop(): void;
+    failed(): string | undefined;
+}
+type LineSpawner = (command: string, args: readonly string[], env?: Record<string, string>) => LineChild;
+
+/**
+ * Discover tools/list for each enabled server and register mcp_<server>_<tool>.
+ * tools_enabled filters them. An empty allowlist never connects.
+ */
+
+interface McpRuntime {
+    spawn?: LineSpawner;
+    fetch_fn?: typeof fetch;
+    env_path?: string;
+}
+
+/**
+ * Plugin surface: user-authored tools and lifecycle hooks loaded at startup.
+ *
+ * A plugin is a plain object exported from a TS/JS module. Hooks observe and
+ * (in the case of before_tool_call) veto tool executions; tools merge into the
+ * agent registry after builtin filtering.
+ */
+
+/** Runtime info handed to every hook call. */
+interface HookContext {
+    work_dir: string;
+    /**
+     * This plugin's own per-run state sub-map. Every hook invocation receives
+     * a ctx exposing only the invoking plugin's bag; the bag is swapped fresh
+     * at each run start. Absent only on hand-built contexts outside the runner.
+     */
+    state?: Map<string, unknown>;
+}
+/** Argument passed to before_tool_call hooks. */
+interface BeforeToolCallInfo {
+    tool_name: string;
+    args: Record<string, unknown>;
+}
+/** Return value that vetoes a tool call; other hooks still run. */
+interface BeforeToolCallResult {
+    block?: boolean;
+    reason?: string;
+}
+/** Argument passed to after_tool_call hooks. */
+interface AfterToolCallInfo extends BeforeToolCallInfo {
+    result_summary: string;
+    /** Structured executor outcome; gate on this, never parse result_summary. */
+    ok: boolean;
+    error?: string;
+}
+interface RunEndInfo {
+    stopped_reason: string;
+    turns_used: number;
+}
+/** Optional lifecycle hooks a plugin may implement. All hooks are awaited. */
+interface PluginHooks {
+    before_tool_call?(info: BeforeToolCallInfo, ctx: HookContext): Promise<BeforeToolCallResult | void> | BeforeToolCallResult | void;
+    after_tool_call?(info: AfterToolCallInfo, ctx: HookContext): Promise<void> | void;
+    on_run_start?(info: {
+        input_chars: number;
+    }, ctx: HookContext): Promise<void> | void;
+    on_run_end?(info: RunEndInfo, ctx: HookContext): Promise<void> | void;
+}
+/** A user plugin: required unique name, optional tools and hooks. */
+interface Plugin {
+    name: string;
+    version?: string;
+    tools?: Tool[];
+    hooks?: PluginHooks;
+}
+
+/** A successfully loaded plugin plus the entry path it came from. */
+interface LoadedPlugin {
+    plugin: Plugin;
+    entry: string;
+}
+/** One failed entry: the specifier and why it failed. */
+interface PluginLoadError {
+    entry: string;
+    error_message: string;
+}
+/**
+ * Load plugins from explicit entry paths (relative to `base_dir` or absolute).
+ * Broken imports, missing exports, and duplicate names become error entries;
+ * nothing is thrown for a bad plugin.
+ */
+declare function load_plugins(entries: readonly string[], base_dir: string): Promise<{
+    plugins: LoadedPlugin[];
+    errors: PluginLoadError[];
+}>;
+/** Joined one-liner per load error, for a single warn log. */
+declare function plugin_errors_summary(errors: readonly PluginLoadError[]): string;
+
 /**
  * Typed event emitter for the agent loop.
  *
@@ -487,8 +604,14 @@ declare class Agent {
     private readonly registry;
     private readonly executor;
     private readonly hook_runner;
-    constructor(config: AgentConfig, plugins?: readonly LoadedPlugin[]);
+    private readonly mcp_runtime;
+    private mcp_attached;
+    constructor(config: AgentConfig, plugins?: readonly LoadedPlugin[], runtime?: {
+        mcp?: McpRuntime;
+    });
     run(options: AgentRunOptions): Promise<AgentRunResult>;
+    /** tools/list once, before the model sees definitions. Empty allowlists never connect. */
+    private attach_mcp_once;
     /** Per-run deps: the built-once ToolContext threads through every tool execution. */
     private loop_deps;
     /** Best-effort on_run_start fan-out; hook errors are logged, never fatal. */
@@ -506,20 +629,8 @@ declare function run_agent(raw_config: unknown, input: string, options?: {
     label?: string;
 }): Promise<AgentRunResult>;
 
-/**
- * Name-keyed registry of tools and toolsets. Registration rejects duplicate
- * tool names so conflicting builtins fail loudly at startup.
- */
-declare class ToolRegistry {
-    private readonly tools;
-    register(tool: Tool): void;
-    register_toolset(toolset: Toolset): void;
-    get(name: string): Tool | undefined;
-    has(name: string): boolean;
-    list(): Tool[];
-    /** Map registered tools onto the provider-facing wire shape. */
-    definitions(): ToolDefinition[];
-}
+/** Write the client entry. The user sets enabled. Godot has nothing to write. */
+declare function catalog_client_entry(name: string, substitutes?: Record<string, string>): Record<string, unknown> | string;
 
 interface ExecutorDefaults {
     work_dir?: string;
@@ -583,4 +694,4 @@ declare class HookedToolRunner {
 
 declare const LICH_VERSION: string;
 
-export { type AfterToolCallInfo, Agent, type AgentConfig, AgentEmitter, type AgentEvent, type AgentEventHandler, type AgentEvents, type AgentRunOptions, type AgentRunResult, type BeforeToolCallInfo, type BeforeToolCallResult, type ChatOptions, type ChatResult, type HookContext, HookedToolRunner, LICH_VERSION, type LoadedPlugin, type LoopOutcome, type LoopParams, type Message, type Plugin, type PluginHooks, type PluginLoadError, type ProviderConfig, ProviderError, type RunEndInfo, type Tool, type ToolCall, type ToolContext, type ToolDefinition, ToolExecutor, ToolRegistry, type ToolResult, type Usage, create_agent, create_agent_with_plugins, load_plugins, parse_agent_config, plugin_errors_summary, register_builtin_tools, run_agent };
+export { type AfterToolCallInfo, Agent, type AgentConfig, AgentEmitter, type AgentEvent, type AgentEventHandler, type AgentEvents, type AgentRunOptions, type AgentRunResult, type BeforeToolCallInfo, type BeforeToolCallResult, type ChatOptions, type ChatResult, type HookContext, HookedToolRunner, LICH_VERSION, type LoadedPlugin, type LoopOutcome, type LoopParams, type Message, type Plugin, type PluginHooks, type PluginLoadError, type ProviderConfig, ProviderError, type RunEndInfo, type Tool, type ToolCall, type ToolContext, type ToolDefinition, ToolExecutor, ToolRegistry, type ToolResult, type Usage, catalog_client_entry, create_agent, create_agent_with_plugins, load_plugins, parse_agent_config, plugin_errors_summary, register_builtin_tools, run_agent };

package/dist/index.js

@@ -1,6 +1,7 @@
 import {
-  LICH_VERSION
-} from "./chunk-6M6OAQGN.js";
+  LICH_VERSION,
+  catalog_client_entry
+} from "./chunk-SAEB3QL3.js";
 import {
   Agent,
   AgentEmitter,
@@ -15,7 +16,7 @@ import {
   plugin_errors_summary,
   register_builtin_tools,
   run_agent
-} from "./chunk-CV2YH3FH.js";
+} from "./chunk-QVJCIZIF.js";
 export {
   Agent,
   AgentEmitter,
@@ -24,6 +25,7 @@ export {
   ProviderError,
   ToolExecutor,
   ToolRegistry,
+  catalog_client_entry,
   create_agent,
   create_agent_with_plugins,
   load_plugins,