@moikapy/lich 0.7.1 → 0.9.0

package/dist/index.d.ts

@@ -42,6 +42,12 @@ interface AssistantMessage {
     role: "assistant";
     content: string;
     tool_calls?: ToolCall[];
+    /**
+     * Opaque provider content blocks preserved for round-trip (e.g. Anthropic
+     * thinking / redacted_thinking). When present, Anthropic replays these
+     * instead of reconstructing text + tool_use from content/tool_calls.
+     */
+    provider_content?: readonly Record<string, unknown>[];
 }
 interface ToolMessage {
     role: "tool";
@@ -83,10 +89,14 @@ interface ProviderConfig {
     api_key?: string;
     api_key_env?: string;
     timeout_ms?: number;
+    /** Anthropic-only: forward ChatOptions.temperature (default: omit). */
+    send_temperature?: boolean;
     /** Ollama-only: request thinking mode (adds think:true to /api/chat). */
     think?: boolean;
     /** Ollama-only: how long the model stays loaded (e.g. "10m"). */
     keep_alive?: string;
+    /** Ollama-only: context window size sent as options.num_ctx. */
+    num_ctx?: number;
     /** Injectable fetch, mainly for tests. Defaults to global fetch. */
     fetch_fn?: typeof fetch;
 }
@@ -115,7 +125,7 @@ declare const agent_config_schema: z.ZodEffects<z.ZodObject<{
     agent_name: z.ZodDefault<z.ZodString>;
     system_prompt: z.ZodOptional<z.ZodString>;
     max_turns: z.ZodDefault<z.ZodNumber>;
-    providers: z.ZodArray<z.ZodObject<{
+    providers: z.ZodEffects<z.ZodArray<z.ZodObject<{
         kind: z.ZodEnum<["openai_compat", "anthropic", "ollama"]>;
         name: z.ZodString;
         model: z.ZodString;
@@ -145,7 +155,27 @@ declare const agent_config_schema: z.ZodEffects<z.ZodObject<{
         timeout_ms: z.ZodOptional<z.ZodNumber>;
         /** Injectable fetch, mainly for tests; passes through untouched. */
         fetch_fn: z.ZodOptional<z.ZodType<typeof fetch, z.ZodTypeDef, typeof fetch>>;
-    }, z.ZodTypeAny, "passthrough">>, "many">;
+    }, z.ZodTypeAny, "passthrough">>, "many">, z.objectOutputType<{
+        kind: z.ZodEnum<["openai_compat", "anthropic", "ollama"]>;
+        name: z.ZodString;
+        model: z.ZodString;
+        base_url: z.ZodOptional<z.ZodString>;
+        api_key: z.ZodOptional<z.ZodString>;
+        api_key_env: z.ZodOptional<z.ZodString>;
+        timeout_ms: z.ZodOptional<z.ZodNumber>;
+        /** Injectable fetch, mainly for tests; passes through untouched. */
+        fetch_fn: z.ZodOptional<z.ZodType<typeof fetch, z.ZodTypeDef, typeof fetch>>;
+    }, z.ZodTypeAny, "passthrough">[], z.objectInputType<{
+        kind: z.ZodEnum<["openai_compat", "anthropic", "ollama"]>;
+        name: z.ZodString;
+        model: z.ZodString;
+        base_url: z.ZodOptional<z.ZodString>;
+        api_key: z.ZodOptional<z.ZodString>;
+        api_key_env: z.ZodOptional<z.ZodString>;
+        timeout_ms: z.ZodOptional<z.ZodNumber>;
+        /** Injectable fetch, mainly for tests; passes through untouched. */
+        fetch_fn: z.ZodOptional<z.ZodType<typeof fetch, z.ZodTypeDef, typeof fetch>>;
+    }, z.ZodTypeAny, "passthrough">[]>;
     work_dir: z.ZodOptional<z.ZodString>;
     tools_enabled: z.ZodDefault<z.ZodUnion<[z.ZodLiteral<"all">, z.ZodArray<z.ZodString, "many">]>>;
     temperature: z.ZodOptional<z.ZodNumber>;
@@ -168,13 +198,13 @@ declare const agent_config_schema: z.ZodEffects<z.ZodObject<{
         tools_enabled: z.ZodDefault<z.ZodUnion<[z.ZodLiteral<"all">, z.ZodArray<z.ZodString, "many">]>>;
     }, "strip", z.ZodTypeAny, {
         tools_enabled: string[] | "all";
-        platforms: ("webhook" | "telegram" | "discord" | "twitch")[];
+        platforms: ("telegram" | "discord" | "twitch" | "webhook")[];
         token_envs: Record<string, string>;
         allowed_users: Record<string, string[]>;
         allowed_chats: Record<string, string[]>;
     }, {
         tools_enabled?: string[] | "all" | undefined;
-        platforms?: ("webhook" | "telegram" | "discord" | "twitch")[] | undefined;
+        platforms?: ("telegram" | "discord" | "twitch" | "webhook")[] | undefined;
         token_envs?: Record<string, string> | undefined;
         allowed_users?: Record<string, string[]> | undefined;
         allowed_chats?: Record<string, string[]> | undefined;
@@ -224,9 +254,9 @@ declare const agent_config_schema: z.ZodEffects<z.ZodObject<{
         enabled?: boolean | undefined;
     }>>>;
 }, "strip", z.ZodTypeAny, {
+    plugins: string[];
+    agent_name: string;
     max_turns: number;
-    log_level: "debug" | "info" | "warn" | "error";
-    theme: string;
     providers: z.objectOutputType<{
         kind: z.ZodEnum<["openai_compat", "anthropic", "ollama"]>;
         name: z.ZodString;
@@ -238,24 +268,24 @@ declare const agent_config_schema: z.ZodEffects<z.ZodObject<{
         /** Injectable fetch, mainly for tests; passes through untouched. */
         fetch_fn: z.ZodOptional<z.ZodType<typeof fetch, z.ZodTypeDef, typeof fetch>>;
     }, z.ZodTypeAny, "passthrough">[];
-    agent_name: string;
     tools_enabled: string[] | "all";
     context_budget_tokens: number;
     compress_threshold: number;
     terminal_timeout_ms: number;
-    plugins: string[];
-    work_dir?: string | undefined;
+    log_level: "debug" | "info" | "warn" | "error";
+    theme: string;
     system_prompt?: string | undefined;
+    work_dir?: string | undefined;
+    temperature?: number | undefined;
+    max_tokens?: number | undefined;
     session_dir?: string | undefined;
     gateway?: {
         tools_enabled: string[] | "all";
-        platforms: ("webhook" | "telegram" | "discord" | "twitch")[];
+        platforms: ("telegram" | "discord" | "twitch" | "webhook")[];
         token_envs: Record<string, string>;
         allowed_users: Record<string, string[]>;
         allowed_chats: Record<string, string[]>;
     } | undefined;
-    temperature?: number | undefined;
-    max_tokens?: number | undefined;
     mcp_servers?: Record<string, {
         enabled: boolean;
         command: string;
@@ -277,27 +307,27 @@ declare const agent_config_schema: z.ZodEffects<z.ZodObject<{
         /** Injectable fetch, mainly for tests; passes through untouched. */
         fetch_fn: z.ZodOptional<z.ZodType<typeof fetch, z.ZodTypeDef, typeof fetch>>;
     }, z.ZodTypeAny, "passthrough">[];
-    work_dir?: string | undefined;
-    max_turns?: number | undefined;
+    plugins?: string[] | undefined;
+    agent_name?: string | undefined;
     system_prompt?: string | undefined;
+    max_turns?: number | undefined;
+    work_dir?: string | undefined;
+    tools_enabled?: string[] | "all" | undefined;
+    temperature?: number | undefined;
+    max_tokens?: number | undefined;
+    context_budget_tokens?: number | undefined;
+    compress_threshold?: number | undefined;
     session_dir?: string | undefined;
-    log_level?: "debug" | "info" | "warn" | "error" | undefined;
-    theme?: string | undefined;
+    terminal_timeout_ms?: number | undefined;
     gateway?: {
         tools_enabled?: string[] | "all" | undefined;
-        platforms?: ("webhook" | "telegram" | "discord" | "twitch")[] | undefined;
+        platforms?: ("telegram" | "discord" | "twitch" | "webhook")[] | undefined;
         token_envs?: Record<string, string> | undefined;
         allowed_users?: Record<string, string[]> | undefined;
         allowed_chats?: Record<string, string[]> | undefined;
     } | undefined;
-    agent_name?: string | undefined;
-    tools_enabled?: string[] | "all" | undefined;
-    temperature?: number | undefined;
-    max_tokens?: number | undefined;
-    context_budget_tokens?: number | undefined;
-    compress_threshold?: number | undefined;
-    terminal_timeout_ms?: number | undefined;
-    plugins?: string[] | undefined;
+    log_level?: "debug" | "info" | "warn" | "error" | undefined;
+    theme?: string | undefined;
     mcp_servers?: Record<string, {
         command: string;
         enabled?: boolean | undefined;
@@ -311,25 +341,25 @@ declare const agent_config_schema: z.ZodEffects<z.ZodObject<{
     work_dir: string;
     providers: ProviderConfig[];
     session_dir: string;
-    max_turns: number;
-    log_level: "debug" | "info" | "warn" | "error";
-    theme: string;
+    plugins: string[];
     agent_name: string;
+    max_turns: number;
     tools_enabled: string[] | "all";
     context_budget_tokens: number;
     compress_threshold: number;
     terminal_timeout_ms: number;
-    plugins: string[];
+    log_level: "debug" | "info" | "warn" | "error";
+    theme: string;
     system_prompt?: string | undefined;
+    temperature?: number | undefined;
+    max_tokens?: number | undefined;
     gateway?: {
         tools_enabled: string[] | "all";
-        platforms: ("webhook" | "telegram" | "discord" | "twitch")[];
+        platforms: ("telegram" | "discord" | "twitch" | "webhook")[];
         token_envs: Record<string, string>;
         allowed_users: Record<string, string[]>;
         allowed_chats: Record<string, string[]>;
     } | undefined;
-    temperature?: number | undefined;
-    max_tokens?: number | undefined;
     mcp_servers?: Record<string, {
         enabled: boolean;
         command: string;
@@ -351,27 +381,27 @@ declare const agent_config_schema: z.ZodEffects<z.ZodObject<{
         /** Injectable fetch, mainly for tests; passes through untouched. */
         fetch_fn: z.ZodOptional<z.ZodType<typeof fetch, z.ZodTypeDef, typeof fetch>>;
     }, z.ZodTypeAny, "passthrough">[];
-    work_dir?: string | undefined;
-    max_turns?: number | undefined;
+    plugins?: string[] | undefined;
+    agent_name?: string | undefined;
     system_prompt?: string | undefined;
+    max_turns?: number | undefined;
+    work_dir?: string | undefined;
+    tools_enabled?: string[] | "all" | undefined;
+    temperature?: number | undefined;
+    max_tokens?: number | undefined;
+    context_budget_tokens?: number | undefined;
+    compress_threshold?: number | undefined;
     session_dir?: string | undefined;
-    log_level?: "debug" | "info" | "warn" | "error" | undefined;
-    theme?: string | undefined;
+    terminal_timeout_ms?: number | undefined;
     gateway?: {
         tools_enabled?: string[] | "all" | undefined;
-        platforms?: ("webhook" | "telegram" | "discord" | "twitch")[] | undefined;
+        platforms?: ("telegram" | "discord" | "twitch" | "webhook")[] | undefined;
         token_envs?: Record<string, string> | undefined;
         allowed_users?: Record<string, string[]> | undefined;
         allowed_chats?: Record<string, string[]> | undefined;
     } | undefined;
-    agent_name?: string | undefined;
-    tools_enabled?: string[] | "all" | undefined;
-    temperature?: number | undefined;
-    max_tokens?: number | undefined;
-    context_budget_tokens?: number | undefined;
-    compress_threshold?: number | undefined;
-    terminal_timeout_ms?: number | undefined;
-    plugins?: string[] | undefined;
+    log_level?: "debug" | "info" | "warn" | "error" | undefined;
+    theme?: string | undefined;
     mcp_servers?: Record<string, {
         command: string;
         enabled?: boolean | undefined;
@@ -455,8 +485,9 @@ 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.
+     * a ctx exposing only the invoking plugin's bag; the bag is scoped per
+     * Agent.run via AsyncLocalStorage (and swapped fresh at each run start).
+     * Absent only on hand-built contexts outside the runner.
      */
     state?: Map<string, unknown>;
 }
@@ -520,6 +551,20 @@ declare function load_plugins(entries: readonly string[], base_dir: string): Pro
 /** Joined one-liner per load error, for a single warn log. */
 declare function plugin_errors_summary(errors: readonly PluginLoadError[]): string;
 
+interface SessionRecord {
+    ts: string;
+    kind: "message" | "meta";
+    message?: Message;
+    meta?: Record<string, unknown>;
+}
+interface SessionHandle {
+    id: string;
+    path: string;
+    append(record: SessionRecord): Promise<void>;
+}
+declare function open_session(dir: string, label?: string): Promise<SessionHandle>;
+declare function read_session_messages(file_path: string): Promise<Message[]>;
+
 /**
  * Typed event emitter for the agent loop.
  *
@@ -547,12 +592,15 @@ interface AgentEvents {
         turn: number;
         call: ToolCall;
         result: ToolResult;
+        cancelled?: boolean;
     };
     compress_start: {
         estimated_tokens: number;
     };
+    /** Summarizer usage is optional so the recorder never treats it as an assistant turn. */
     compress_end: {
         summary_chars: number;
+        usage?: Usage;
     };
     turn_end: {
         turn: number;
@@ -581,6 +629,10 @@ declare class AgentEmitter {
     clear(): void;
 }
 
+interface ChatFn {
+    (messages: readonly Message[], tools: readonly ToolDefinition[], options?: ChatOptions): Promise<ChatResult>;
+}
+
 /**
  * The Think-Act-Observe agent loop.
  *
@@ -590,6 +642,17 @@ declare class AgentEmitter {
  * loop never imports provider routers or the tool executor directly.
  */
 
+interface ToolRunner {
+    execute(name: string, args: Record<string, unknown>, context?: ToolContext): Promise<ToolResult>;
+}
+interface LoopDeps {
+    chat: ChatFn;
+    tools: ToolRunner;
+    definitions: () => ToolDefinition[];
+    emitter?: AgentEmitter;
+    /** Per-run ToolContext threaded to every tool execution (A6). */
+    tool_context?: ToolContext;
+}
 interface LoopParams {
     system_prompt?: string;
     max_turns: number;
@@ -606,6 +669,7 @@ interface LoopOutcome {
     turns_used: number;
     stopped_reason: "final" | "budget" | "aborted";
 }
+declare function run_conversation(deps: LoopDeps, messages: readonly Message[], params: LoopParams): Promise<LoopOutcome>;
 
 interface AgentRunOptions {
     input: string;
@@ -613,6 +677,8 @@ interface AgentRunOptions {
     history?: readonly Message[];
     signal?: AbortSignal;
     label?: string;
+    /** Shared transcript handle (TUI: one file per launch). When set, Agent reuses it. */
+    session?: SessionHandle;
 }
 interface AgentRunResult {
     outcome: LoopOutcome;
@@ -635,6 +701,7 @@ declare class Agent {
         mcp?: McpRuntime;
     });
     run(options: AgentRunOptions): Promise<AgentRunResult>;
+    private run_body;
     /** Close MCP sessions so stdio children do not keep the event loop alive. */
     close(): void;
     /** tools/list once, before the model sees definitions. Empty allowlists never connect. */
@@ -646,8 +713,8 @@ declare class Agent {
     private call_plugin_run_start;
     /** Best-effort on_run_end fan-out; hook errors are logged, never fatal. */
     private call_plugin_run_end;
-    /** Best-effort JSONL transcript: never fails the run, returns undefined path on error. */
-    private persist_session;
+    /** Best-effort recorder: open failures warn and skip persistence for this run. */
+    private open_recorder;
 }
 declare function create_agent(raw_config: unknown): Agent;
 /** create_agent plus plugin loading: broken entries are warned and skipped. */
@@ -682,18 +749,6 @@ declare class ToolExecutor {
 /** Register every builtin tool onto a fresh registry (idempotent per registry). */
 declare function register_builtin_tools(registry: ToolRegistry, context?: ToolContext): void;
 
-/**
- * HookedToolRunner: wraps the ToolExecutor with plugin hooks.
- *
- * before_tool_call hooks run in registration order and may veto a call (first
- * blocker wins; the wrapped executor is never called). Hook errors are warned
- * and skipped, never fatal. after_tool_call hooks observe the result summary
- * plus the executor's structured ok/error fields. Every hook invocation
- * receives a ctx exposing only its own plugin's state sub-map: the bag is a
- * module-internal WeakMap keyed on the plugin object, swapped fresh at each
- * call_run_start and shared by the lifecycle and per-tool ctx build sites.
- */
-
 /** Structural ToolRunner shape accepted from the wrapped executor. */
 interface WrappedToolRunner {
     execute(name: string, args: Record<string, unknown>, context?: ToolContext): Promise<ToolResult>;
@@ -707,6 +762,11 @@ declare class HookedToolRunner {
     private readonly wrapped;
     private readonly hooked_plugins;
     constructor(wrapped: WrappedToolRunner, plugins: readonly Plugin[]);
+    /**
+     * Isolate plugin state for one Agent.run so concurrent runs on the same
+     * Agent cannot reset each other's bags (M-6).
+     */
+    run_scope<T>(fn: () => Promise<T>): Promise<T>;
     /** Run before hooks in order; the first {block: true} verdict wins. */
     private run_before_hooks;
     /** Fire-and-forget in spirit but awaited here so runs settle cleanly. */
@@ -722,4 +782,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, catalog_client_entry, 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 AssistantMessage, type BeforeToolCallInfo, type BeforeToolCallResult, type ChatOptions, type ChatResult, type HookContext, HookedToolRunner, type JsonSchemaObject, LICH_VERSION, type LoadedPlugin, type LoopDeps, 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 ToolRunner, type Usage, catalog_client_entry, create_agent, create_agent_with_plugins, load_plugins, open_session, parse_agent_config, plugin_errors_summary, read_session_messages, register_builtin_tools, run_agent, run_conversation };

package/dist/index.js

@@ -1,7 +1,7 @@
 import {
   LICH_VERSION,
   catalog_client_entry
-} from "./chunk-PZNYVGD4.js";
+} from "./chunk-P2YEHNM4.js";
 import {
   Agent,
   AgentEmitter,
@@ -15,8 +15,13 @@ import {
   parse_agent_config,
   plugin_errors_summary,
   register_builtin_tools,
-  run_agent
-} from "./chunk-WNFBIX4E.js";
+  run_agent,
+  run_conversation
+} from "./chunk-KOEZQUIX.js";
+import {
+  open_session,
+  read_session_messages
+} from "./chunk-TYRKVBWQ.js";
 export {
   Agent,
   AgentEmitter,
@@ -29,9 +34,12 @@ export {
   create_agent,
   create_agent_with_plugins,
   load_plugins,
+  open_session,
   parse_agent_config,
   plugin_errors_summary,
+  read_session_messages,
   register_builtin_tools,
-  run_agent
+  run_agent,
+  run_conversation
 };
 //# sourceMappingURL=index.js.map

package/dist/resolve-H22TOVB5.js

@@ -0,0 +1,7 @@
+import {
+  resolve_session_path
+} from "./chunk-PL6MKRKE.js";
+export {
+  resolve_session_path
+};
+//# sourceMappingURL=resolve-H22TOVB5.js.map

package/dist/resolve-H22TOVB5.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/store-YYLEB7JG.js

@@ -0,0 +1,9 @@
+import {
+  open_session,
+  read_session_messages
+} from "./chunk-TYRKVBWQ.js";
+export {
+  open_session,
+  read_session_messages
+};
+//# sourceMappingURL=store-YYLEB7JG.js.map

package/dist/store-YYLEB7JG.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}