@moikapy/lich 0.7.1 → 0.9.0

package/dist/{chunk-PZNYVGD4.js → chunk-P2YEHNM4.js}

@@ -1,6 +1,6 @@
 import {
   catalog_by_name
-} from "./chunk-WNFBIX4E.js";
+} from "./chunk-KOEZQUIX.js";
 
 // src/index.ts
 import { readFileSync } from "fs";
@@ -55,4 +55,4 @@ export {
   catalog_client_entry,
   LICH_VERSION
 };
-//# sourceMappingURL=chunk-PZNYVGD4.js.map
+//# sourceMappingURL=chunk-P2YEHNM4.js.map

package/dist/chunk-P2YEHNM4.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/mcp/mcp_catalog_entry.ts"],"sourcesContent":["/**\n * Public surface of the lich agent harness. Pure re-exports, plus the package version.\n */\nimport { readFileSync } from \"node:fs\";\nimport { fileURLToPath } from \"node:url\";\n\nfunction read_package_version(): string {\n  const pkg_path = fileURLToPath(new URL(\"../package.json\", import.meta.url));\n  const pkg = JSON.parse(readFileSync(pkg_path, \"utf8\")) as { version?: unknown };\n  if (typeof pkg.version !== \"string\" || pkg.version.length === 0) {\n    throw new Error(\"package.json is missing version\");\n  }\n  return pkg.version;\n}\n\nexport const LICH_VERSION = read_package_version();\n\nexport { Agent, create_agent, run_agent, create_agent_with_plugins } from \"./agent/agent.js\";\nexport type { AgentRunOptions, AgentRunResult } from \"./agent/agent.js\";\nexport type { AgentConfig } from \"./agent/config.js\";\nexport { parse_agent_config } from \"./agent/config.js\";\nexport { catalog_client_entry } from \"./mcp/mcp_catalog_entry.js\";\nexport { AgentEmitter } from \"./agent/events.js\";\nexport type { AgentEvent, AgentEventHandler, AgentEvents } from \"./agent/events.js\";\nexport { run_conversation } from \"./agent/loop.js\";\nexport type { LoopDeps, LoopOutcome, LoopParams, ToolRunner } from \"./agent/loop.js\";\nexport { open_session, read_session_messages } from \"./session/store.js\";\nexport type {\n  AssistantMessage,\n  ChatOptions,\n  ChatResult,\n  Message,\n  ProviderConfig,\n  ToolCall,\n  ToolDefinition,\n  Usage,\n} from \"./providers/types.js\";\nexport { ProviderError } from \"./providers/types.js\";\nexport type { JsonSchemaObject } from \"./util/json_schema.js\";\nexport { ToolExecutor } from \"./tools/executor.js\";\nexport { ToolRegistry } from \"./tools/registry.js\";\nexport type { Tool, ToolContext, ToolResult } from \"./tools/types.js\";\nexport { register_builtin_tools } from \"./tools/builtin/index.js\";\nexport { HookedToolRunner } from \"./plugins/hooks.js\";\nexport { load_plugins, plugin_errors_summary } from \"./plugins/loader.js\";\nexport type { LoadedPlugin, PluginLoadError } from \"./plugins/loader.js\";\nexport type {\n  AfterToolCallInfo,\n  BeforeToolCallInfo,\n  BeforeToolCallResult,\n  HookContext,\n  Plugin,\n  PluginHooks,\n  RunEndInfo,\n} from \"./plugins/types.js\";","/**\n * Install shape: turn a catalog manifest into a disabled mcp_servers entry.\n * Does not spawn, download, or copy secrets.\n */\nimport { catalog_by_name } from \"./mcp_catalog.js\";\n\nconst PLACEHOLDER = /\\$\\{([a-z_]+)\\}/g;\n\nfunction expand(value: string, substitutes: Record<string, string>): string | undefined {\n  const tokens = value.match(PLACEHOLDER) ?? [];\n  let next = value;\n  for (const token of tokens) {\n    const key = token.slice(2, -1);\n    const found = substitutes[key];\n    if (found === undefined || found.length === 0) {\n      return undefined;\n    }\n    next = next.replace(token, found);\n  }\n  return next;\n}\n\n/** Write the client entry. The user sets enabled. Godot has nothing to write. */\nexport function catalog_client_entry(\n  name: string,\n  substitutes: Record<string, string> = {},\n): Record<string, unknown> | string {\n  const manifest = catalog_by_name(name);\n  if (manifest === undefined) {\n    return `unknown mcp catalog entry '${name}'`;\n  }\n  if (manifest.transport !== \"stdio\" || manifest.command === undefined) {\n    return manifest.note ?? `${name} has no official mcp server to enable`;\n  }\n  const args: string[] = [];\n  for (const arg of manifest.args ?? []) {\n    const expanded = expand(arg, substitutes);\n    if (expanded === undefined) {\n      return `mcp catalog '${name}' needs a substitute for ${arg}`;\n    }\n    args.push(expanded);\n  }\n  return { enabled: false, command: manifest.command, args };\n}\n"],"mappings":";;;;;AAGA,SAAS,oBAAoB;AAC7B,SAAS,qBAAqB;;;ACE9B,IAAM,cAAc;AAEpB,SAAS,OAAO,OAAe,aAAyD;AACtF,QAAM,SAAS,MAAM,MAAM,WAAW,KAAK,CAAC;AAC5C,MAAI,OAAO;AACX,aAAW,SAAS,QAAQ;AAC1B,UAAM,MAAM,MAAM,MAAM,GAAG,EAAE;AAC7B,UAAM,QAAQ,YAAY,GAAG;AAC7B,QAAI,UAAU,UAAa,MAAM,WAAW,GAAG;AAC7C,aAAO;AAAA,IACT;AACA,WAAO,KAAK,QAAQ,OAAO,KAAK;AAAA,EAClC;AACA,SAAO;AACT;AAGO,SAAS,qBACd,MACA,cAAsC,CAAC,GACL;AAClC,QAAM,WAAW,gBAAgB,IAAI;AACrC,MAAI,aAAa,QAAW;AAC1B,WAAO,8BAA8B,IAAI;AAAA,EAC3C;AACA,MAAI,SAAS,cAAc,WAAW,SAAS,YAAY,QAAW;AACpE,WAAO,SAAS,QAAQ,GAAG,IAAI;AAAA,EACjC;AACA,QAAM,OAAiB,CAAC;AACxB,aAAW,OAAO,SAAS,QAAQ,CAAC,GAAG;AACrC,UAAM,WAAW,OAAO,KAAK,WAAW;AACxC,QAAI,aAAa,QAAW;AAC1B,aAAO,gBAAgB,IAAI,4BAA4B,GAAG;AAAA,IAC5D;AACA,SAAK,KAAK,QAAQ;AAAA,EACpB;AACA,SAAO,EAAE,SAAS,OAAO,SAAS,SAAS,SAAS,KAAK;AAC3D;;;ADrCA,SAAS,uBAA+B;AACtC,QAAM,WAAW,cAAc,IAAI,IAAI,mBAAmB,YAAY,GAAG,CAAC;AAC1E,QAAM,MAAM,KAAK,MAAM,aAAa,UAAU,MAAM,CAAC;AACrD,MAAI,OAAO,IAAI,YAAY,YAAY,IAAI,QAAQ,WAAW,GAAG;AAC/D,UAAM,IAAI,MAAM,iCAAiC;AAAA,EACnD;AACA,SAAO,IAAI;AACb;AAEO,IAAM,eAAe,qBAAqB;","names":[]}

package/dist/chunk-PL6MKRKE.js

@@ -0,0 +1,75 @@
+// src/session/resolve.ts
+import { readdir, stat } from "fs/promises";
+import path from "path";
+var CANDIDATE_CAP = 5;
+function is_enoent(error) {
+  return typeof error === "object" && error !== null && error.code === "ENOENT";
+}
+async function list_session_files(dir) {
+  let names;
+  try {
+    names = await readdir(dir);
+  } catch (error) {
+    if (is_enoent(error) === true) {
+      return [];
+    }
+    throw error;
+  }
+  const entries = [];
+  for (const name of names) {
+    if (name.endsWith(".jsonl") === false) {
+      continue;
+    }
+    try {
+      const info = await stat(path.join(dir, name));
+      if (info.isFile() === false) {
+        continue;
+      }
+      entries.push({ name, id: name.slice(0, -".jsonl".length), mtime_ms: info.mtimeMs });
+    } catch {
+      continue;
+    }
+  }
+  return entries.sort((a, b) => b.mtime_ms - a.mtime_ms);
+}
+function candidate_ids(entries) {
+  if (entries.length === 0) {
+    return "(none)";
+  }
+  return entries.slice(0, CANDIDATE_CAP).map((entry) => entry.id).join(", ");
+}
+function missing_error(dir, value, entries) {
+  return new Error(`session not found: "${value}" in ${dir} (candidates: ${candidate_ids(entries)})`);
+}
+function ambiguous_error(dir, value, matches) {
+  const sorted = [...matches].sort((a, b) => b.mtime_ms - a.mtime_ms);
+  return new Error(`ambiguous session prefix: "${value}" in ${dir} matches: ${candidate_ids(sorted)}`);
+}
+async function resolve_session_path(dir, value) {
+  const entries = await list_session_files(dir);
+  if (value === "latest") {
+    const newest = entries[0];
+    if (newest === void 0) {
+      throw missing_error(dir, value, entries);
+    }
+    return path.join(dir, newest.name);
+  }
+  const exact_name = `${value}.jsonl`;
+  const exact = entries.find((entry) => entry.name === exact_name);
+  if (exact !== void 0) {
+    return path.join(dir, exact.name);
+  }
+  const prefix_matches = entries.filter((entry) => entry.id.startsWith(value));
+  if (prefix_matches.length === 1) {
+    return path.join(dir, prefix_matches[0].name);
+  }
+  if (prefix_matches.length > 1) {
+    throw ambiguous_error(dir, value, prefix_matches);
+  }
+  throw missing_error(dir, value, entries);
+}
+
+export {
+  resolve_session_path
+};
+//# sourceMappingURL=chunk-PL6MKRKE.js.map

package/dist/chunk-PL6MKRKE.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/session/resolve.ts"],"sourcesContent":["/**\n * Resolve a `--resume` value to an existing session transcript path.\n * Pure filesystem lookup: latest by mtime, exact id, or unique prefix.\n */\nimport { readdir, stat } from \"node:fs/promises\";\nimport path from \"node:path\";\n\nexport interface SessionFileInfo {\n  readonly name: string;\n  readonly id: string;\n  readonly mtime_ms: number;\n}\n\nconst CANDIDATE_CAP = 5;\n\nfunction is_enoent(error: unknown): boolean {\n  return typeof error === \"object\" && error !== null && (error as { code?: unknown }).code === \"ENOENT\";\n}\n\nasync function list_session_files(dir: string): Promise<SessionFileInfo[]> {\n  let names: string[];\n  try {\n    names = await readdir(dir);\n  } catch (error) {\n    if (is_enoent(error) === true) {\n      return [];\n    }\n    throw error;\n  }\n  const entries: SessionFileInfo[] = [];\n  for (const name of names) {\n    if (name.endsWith(\".jsonl\") === false) {\n      continue;\n    }\n    try {\n      const info = await stat(path.join(dir, name));\n      if (info.isFile() === false) {\n        continue;\n      }\n      entries.push({ name, id: name.slice(0, -\".jsonl\".length), mtime_ms: info.mtimeMs });\n    } catch {\n      continue;\n    }\n  }\n  return entries.sort((a, b) => b.mtime_ms - a.mtime_ms);\n}\n\nfunction candidate_ids(entries: readonly SessionFileInfo[]): string {\n  if (entries.length === 0) {\n    return \"(none)\";\n  }\n  return entries\n    .slice(0, CANDIDATE_CAP)\n    .map((entry) => entry.id)\n    .join(\", \");\n}\n\nfunction missing_error(dir: string, value: string, entries: readonly SessionFileInfo[]): Error {\n  return new Error(`session not found: \"${value}\" in ${dir} (candidates: ${candidate_ids(entries)})`);\n}\n\nfunction ambiguous_error(dir: string, value: string, matches: readonly SessionFileInfo[]): Error {\n  const sorted = [...matches].sort((a, b) => b.mtime_ms - a.mtime_ms);\n  return new Error(`ambiguous session prefix: \"${value}\" in ${dir} matches: ${candidate_ids(sorted)}`);\n}\n\n/** Map `(dir, value)` to an absolute transcript path, or throw with candidates. */\nexport async function resolve_session_path(dir: string, value: string): Promise<string> {\n  const entries = await list_session_files(dir);\n  if (value === \"latest\") {\n    const newest = entries[0];\n    if (newest === undefined) {\n      throw missing_error(dir, value, entries);\n    }\n    return path.join(dir, newest.name);\n  }\n  const exact_name = `${value}.jsonl`;\n  const exact = entries.find((entry) => entry.name === exact_name);\n  if (exact !== undefined) {\n    return path.join(dir, exact.name);\n  }\n  const prefix_matches = entries.filter((entry) => entry.id.startsWith(value));\n  if (prefix_matches.length === 1) {\n    return path.join(dir, prefix_matches[0]!.name);\n  }\n  if (prefix_matches.length > 1) {\n    throw ambiguous_error(dir, value, prefix_matches);\n  }\n  throw missing_error(dir, value, entries);\n}\n"],"mappings":";AAIA,SAAS,SAAS,YAAY;AAC9B,OAAO,UAAU;AAQjB,IAAM,gBAAgB;AAEtB,SAAS,UAAU,OAAyB;AAC1C,SAAO,OAAO,UAAU,YAAY,UAAU,QAAS,MAA6B,SAAS;AAC/F;AAEA,eAAe,mBAAmB,KAAyC;AACzE,MAAI;AACJ,MAAI;AACF,YAAQ,MAAM,QAAQ,GAAG;AAAA,EAC3B,SAAS,OAAO;AACd,QAAI,UAAU,KAAK,MAAM,MAAM;AAC7B,aAAO,CAAC;AAAA,IACV;AACA,UAAM;AAAA,EACR;AACA,QAAM,UAA6B,CAAC;AACpC,aAAW,QAAQ,OAAO;AACxB,QAAI,KAAK,SAAS,QAAQ,MAAM,OAAO;AACrC;AAAA,IACF;AACA,QAAI;AACF,YAAM,OAAO,MAAM,KAAK,KAAK,KAAK,KAAK,IAAI,CAAC;AAC5C,UAAI,KAAK,OAAO,MAAM,OAAO;AAC3B;AAAA,MACF;AACA,cAAQ,KAAK,EAAE,MAAM,IAAI,KAAK,MAAM,GAAG,CAAC,SAAS,MAAM,GAAG,UAAU,KAAK,QAAQ,CAAC;AAAA,IACpF,QAAQ;AACN;AAAA,IACF;AAAA,EACF;AACA,SAAO,QAAQ,KAAK,CAAC,GAAG,MAAM,EAAE,WAAW,EAAE,QAAQ;AACvD;AAEA,SAAS,cAAc,SAA6C;AAClE,MAAI,QAAQ,WAAW,GAAG;AACxB,WAAO;AAAA,EACT;AACA,SAAO,QACJ,MAAM,GAAG,aAAa,EACtB,IAAI,CAAC,UAAU,MAAM,EAAE,EACvB,KAAK,IAAI;AACd;AAEA,SAAS,cAAc,KAAa,OAAe,SAA4C;AAC7F,SAAO,IAAI,MAAM,uBAAuB,KAAK,QAAQ,GAAG,iBAAiB,cAAc,OAAO,CAAC,GAAG;AACpG;AAEA,SAAS,gBAAgB,KAAa,OAAe,SAA4C;AAC/F,QAAM,SAAS,CAAC,GAAG,OAAO,EAAE,KAAK,CAAC,GAAG,MAAM,EAAE,WAAW,EAAE,QAAQ;AAClE,SAAO,IAAI,MAAM,8BAA8B,KAAK,QAAQ,GAAG,aAAa,cAAc,MAAM,CAAC,EAAE;AACrG;AAGA,eAAsB,qBAAqB,KAAa,OAAgC;AACtF,QAAM,UAAU,MAAM,mBAAmB,GAAG;AAC5C,MAAI,UAAU,UAAU;AACtB,UAAM,SAAS,QAAQ,CAAC;AACxB,QAAI,WAAW,QAAW;AACxB,YAAM,cAAc,KAAK,OAAO,OAAO;AAAA,IACzC;AACA,WAAO,KAAK,KAAK,KAAK,OAAO,IAAI;AAAA,EACnC;AACA,QAAM,aAAa,GAAG,KAAK;AAC3B,QAAM,QAAQ,QAAQ,KAAK,CAAC,UAAU,MAAM,SAAS,UAAU;AAC/D,MAAI,UAAU,QAAW;AACvB,WAAO,KAAK,KAAK,KAAK,MAAM,IAAI;AAAA,EAClC;AACA,QAAM,iBAAiB,QAAQ,OAAO,CAAC,UAAU,MAAM,GAAG,WAAW,KAAK,CAAC;AAC3E,MAAI,eAAe,WAAW,GAAG;AAC/B,WAAO,KAAK,KAAK,KAAK,eAAe,CAAC,EAAG,IAAI;AAAA,EAC/C;AACA,MAAI,eAAe,SAAS,GAAG;AAC7B,UAAM,gBAAgB,KAAK,OAAO,cAAc;AAAA,EAClD;AACA,QAAM,cAAc,KAAK,OAAO,OAAO;AACzC;","names":[]}

package/dist/chunk-TYRKVBWQ.js

@@ -0,0 +1,104 @@
+// src/session/store.ts
+import { randomBytes } from "crypto";
+import { access, appendFile, mkdir, readFile } from "fs/promises";
+import path from "path";
+
+// src/util/json.ts
+function safe_json_parse(raw) {
+  try {
+    return JSON.parse(raw);
+  } catch {
+    return void 0;
+  }
+}
+function safe_stringify(value, space) {
+  try {
+    return JSON.stringify(value, null, space) ?? String(value);
+  } catch {
+    return String(value);
+  }
+}
+function truncate_text(text, max_chars) {
+  if (text.length <= max_chars) {
+    return text;
+  }
+  const omitted = text.length - max_chars;
+  return `${text.slice(0, max_chars)}
+[... truncated, ${omitted} chars omitted ...]`;
+}
+
+// src/session/store.ts
+var counter_state = { value: 0 };
+var MESSAGE_ROLES = /* @__PURE__ */ new Set(["system", "user", "assistant", "tool"]);
+var CREATE_ATTEMPTS = 8;
+function slugify_label(label) {
+  const slug = label.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "").slice(0, 40);
+  return slug.length > 0 ? `-${slug}` : "";
+}
+function next_session_id(label_part) {
+  counter_state.value += 1;
+  const rand = randomBytes(3).toString("hex");
+  return `${Date.now().toString(36)}-${process.pid.toString(36)}-${rand}-${counter_state.value}${label_part}`;
+}
+async function create_unique_session_path(dir, label_part) {
+  for (let attempt = 0; attempt < CREATE_ATTEMPTS; attempt += 1) {
+    const id = next_session_id(label_part);
+    const file_path = path.join(dir, `${id}.jsonl`);
+    try {
+      await access(file_path);
+      continue;
+    } catch {
+      return { id, path: file_path };
+    }
+  }
+  throw new Error(`could not create unique session file in ${dir}`);
+}
+async function open_session(dir, label) {
+  await mkdir(dir, { recursive: true });
+  const label_part = label === void 0 ? "" : slugify_label(label);
+  const created = await create_unique_session_path(dir, label_part);
+  return {
+    id: created.id,
+    path: created.path,
+    append: async (record) => {
+      await appendFile(created.path, `${safe_stringify(record)}
+`, "utf8");
+    }
+  };
+}
+function is_message(value) {
+  if (typeof value !== "object" || value === null) {
+    return false;
+  }
+  const role = value.role;
+  return typeof role === "string" && MESSAGE_ROLES.has(role);
+}
+async function read_session_messages(file_path) {
+  let raw;
+  try {
+    raw = await readFile(file_path, "utf8");
+  } catch {
+    return [];
+  }
+  const messages = [];
+  for (const line of raw.split("\n")) {
+    const record = safe_json_parse(line);
+    if (record?.message !== void 0 && is_message(record.message)) {
+      messages.push(record.message);
+    }
+  }
+  const last = messages.at(-1);
+  if (last?.role === "user") {
+    messages.pop();
+  }
+  return messages;
+}
+
+export {
+  safe_json_parse,
+  safe_stringify,
+  truncate_text,
+  open_session,
+  read_session_messages
+};
+//# sourceMappingURL=chunk-TYRKVBWQ.js.map

package/dist/chunk-TYRKVBWQ.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/session/store.ts","../src/util/json.ts"],"sourcesContent":["/**\n * JSONL transcript persistence for agent sessions. Each session is one\n * append-only .jsonl file; records carry either a message or arbitrary meta.\n */\nimport { randomBytes } from \"node:crypto\";\nimport { access, appendFile, mkdir, readFile } from \"node:fs/promises\";\nimport path from \"node:path\";\nimport type { Message } from \"../providers/types.js\";\nimport { safe_json_parse, safe_stringify } from \"../util/json.js\";\n\nexport interface SessionRecord {\n  ts: string;\n  kind: \"message\" | \"meta\";\n  message?: Message;\n  meta?: Record<string, unknown>;\n}\n\nexport interface SessionHandle {\n  id: string;\n  path: string;\n  append(record: SessionRecord): Promise<void>;\n}\n\n/** Mutable via holder object: conventions require const bindings. */\nconst counter_state = { value: 0 };\n\nconst MESSAGE_ROLES: ReadonlySet<string> = new Set([\"system\", \"user\", \"assistant\", \"tool\"]);\nconst CREATE_ATTEMPTS = 8;\n\nfunction slugify_label(label: string): string {\n  const slug = label\n    .toLowerCase()\n    .replace(/[^a-z0-9]+/g, \"-\")\n    .replace(/^-+|-+$/g, \"\")\n    .slice(0, 40);\n  return slug.length > 0 ? `-${slug}` : \"\";\n}\n\nfunction next_session_id(label_part: string): string {\n  counter_state.value += 1;\n  const rand = randomBytes(3).toString(\"hex\");\n  return `${Date.now().toString(36)}-${process.pid.toString(36)}-${rand}-${counter_state.value}${label_part}`;\n}\n\nasync function create_unique_session_path(dir: string, label_part: string): Promise<{ id: string; path: string }> {\n  for (let attempt = 0; attempt < CREATE_ATTEMPTS; attempt += 1) {\n    const id = next_session_id(label_part);\n    const file_path = path.join(dir, `${id}.jsonl`);\n    try {\n      await access(file_path);\n      // Already taken; try another id.\n      continue;\n    } catch {\n      // Path is free — create lazily on first append so empty TUI launches leave no file.\n      return { id, path: file_path };\n    }\n  }\n  throw new Error(`could not create unique session file in ${dir}`);\n}\n\nexport async function open_session(dir: string, label?: string): Promise<SessionHandle> {\n  await mkdir(dir, { recursive: true });\n  const label_part = label === undefined ? \"\" : slugify_label(label);\n  const created = await create_unique_session_path(dir, label_part);\n  return {\n    id: created.id,\n    path: created.path,\n    append: async (record: SessionRecord): Promise<void> => {\n      await appendFile(created.path, `${safe_stringify(record)}\\n`, \"utf8\");\n    },\n  };\n}\n\nfunction is_message(value: unknown): value is Message {\n  if (typeof value !== \"object\" || value === null) {\n    return false;\n  }\n  const role = (value as { role?: unknown }).role;\n  return typeof role === \"string\" && MESSAGE_ROLES.has(role);\n}\n\nexport async function read_session_messages(file_path: string): Promise<Message[]> {\n  let raw: string;\n  try {\n    raw = await readFile(file_path, \"utf8\");\n  } catch {\n    return [];\n  }\n  const messages: Message[] = [];\n  for (const line of raw.split(\"\\n\")) {\n    const record = safe_json_parse<SessionRecord>(line);\n    if (record?.message !== undefined && is_message(record.message)) {\n      messages.push(record.message);\n    }\n  }\n  // Provider throw / abort-before-turn can leave a dangling user seed with no\n  // assistant reply. Drop it so resume does not start with two consecutive users.\n  const last = messages.at(-1);\n  if (last?.role === \"user\") {\n    messages.pop();\n  }\n  return messages;\n}\n","export function safe_json_parse<T>(raw: string): T | undefined {\n  try {\n    return JSON.parse(raw) as T;\n  } catch {\n    return undefined;\n  }\n}\n\nexport function safe_stringify(value: unknown, space?: number): string {\n  try {\n    return JSON.stringify(value, null, space) ?? String(value);\n  } catch {\n    return String(value);\n  }\n}\n\nexport function truncate_text(text: string, max_chars: number): string {\n  if (text.length <= max_chars) {\n    return text;\n  }\n  const omitted = text.length - max_chars;\n  return `${text.slice(0, max_chars)}\\n[... truncated, ${omitted} chars omitted ...]`;\n}"],"mappings":"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","names":[]}

package/dist/cli.d.ts

@@ -1,4 +1,22 @@
 #!/usr/bin/env node
+/** MCP-only flags. Values are not logged. */
+interface McpCliFlags {
+    command?: string;
+    args: string[];
+    url?: string;
+    project_path?: string;
+}
+
+interface CliOptions {
+    config_path?: string;
+    resume?: string;
+    help?: boolean;
+    version?: boolean;
+    overrides: Record<string, string>;
+    positionals: string[];
+    mcp_flags: McpCliFlags;
+}
+declare function parse_args(argv: string[]): CliOptions;
 declare function run_one_shot(config: unknown, input: string): Promise<number>;
 declare function run_chat(config: unknown): Promise<number>;
 interface CliEntryInput {
@@ -11,4 +29,4 @@ interface CliEntryInput {
 declare function is_cli_entry(input: CliEntryInput): boolean;
 declare function run_cli(argv: string[]): Promise<number>;
 
-export { type CliEntryInput, is_cli_entry, run_chat, run_cli, run_one_shot };
+export { type CliEntryInput, is_cli_entry, parse_args, run_chat, run_cli, run_one_shot };

package/dist/cli.js

@@ -2,19 +2,21 @@
 import {
   load_theme,
   notice_flavor
-} from "./chunk-CVX7LZWC.js";
+} from "./chunk-4N3S6ACI.js";
 import {
   LICH_VERSION,
   catalog_client_entry
-} from "./chunk-PZNYVGD4.js";
+} from "./chunk-P2YEHNM4.js";
 import {
   DEFAULT_GATEWAY_TOKEN_ENVS,
   create_agent_with_plugins,
   is_env_var_name,
   parse_agent_config,
-  refuse_mcp_entry,
+  refuse_mcp_entry
+} from "./chunk-KOEZQUIX.js";
+import {
   safe_json_parse
-} from "./chunk-WNFBIX4E.js";
+} from "./chunk-TYRKVBWQ.js";
 
 // src/cli.ts
 import { existsSync as existsSync4, readFileSync as readFileSync2, realpathSync } from "fs";
@@ -29,6 +31,20 @@ import path from "path";
 var LICH_DIRNAME = ".lich";
 var CONFIG_RELPATH = `${LICH_DIRNAME}/config.json`;
 var DEFAULT_USER_CONFIG = ".config/lich/config.json";
+var KIND_DEFAULTS = {
+  openai_compat: { base_url: "https://api.openai.com/v1", api_key_env: "OPENAI_API_KEY" },
+  anthropic: { base_url: "https://api.anthropic.com", api_key_env: "ANTHROPIC_API_KEY" },
+  ollama: { base_url: "http://localhost:11434" }
+};
+function provider_kind_defaults(kind) {
+  return KIND_DEFAULTS[kind];
+}
+function parse_template_kind(raw) {
+  if (raw === "openai_compat" || raw === "anthropic" || raw === "ollama") {
+    return raw;
+  }
+  return "ollama";
+}
 function config_search_paths(work_dir) {
   const root = work_dir ?? process.cwd();
   const first = path.resolve(root, CONFIG_RELPATH);
@@ -57,14 +73,16 @@ function load_config(explicit) {
   return parsed;
 }
 function config_template() {
-  const kind = process.env.LICH_PROVIDER_KIND ?? "ollama";
+  const kind = parse_template_kind(process.env.LICH_PROVIDER_KIND ?? "ollama");
+  const defaults = provider_kind_defaults(kind);
   const provider = {
     kind,
     name: "main",
-    model: process.env.LICH_MODEL ?? "<model-name>"
+    model: process.env.LICH_MODEL ?? "<model-name>",
+    base_url: defaults.base_url
   };
-  if (kind === "ollama") {
-    provider["base_url"] = "http://localhost:11434";
+  if (defaults.api_key_env !== void 0) {
+    provider["api_key_env"] = defaults.api_key_env;
   }
   return JSON.stringify({ providers: [provider], max_turns: 25, theme: "lich" }, null, 2);
 }
@@ -334,6 +352,7 @@ var VIEW_ARGS = ["view", PACKAGE_NAME, "version"];
 var INSTALL_ARGS = ["install", "-g", `${PACKAGE_NAME}@latest`];
 var NPM_MISSING = "lich: npm is not on PATH. Install Node.js, or run `npm install -g @moikapy/lich@latest` once npm is available.\n";
 var EXIT_FIRST_HINT = "Exit any running `lich tui` or `lich gateway` first \u2014 npm cannot replace the package while those processes are running.\n";
+var LOCAL_INSTALL_HINT = "lich: this copy is not an npm global install. Update via your package manager, or install with `npm install -g @moikapy/lich`.\n";
 function parse_semver(version) {
   const match = /^v?(\d+)\.(\d+)\.(\d+)(?:-([0-9A-Za-z.-]+))?$/.exec(version.trim());
   if (match === null || match[1] === void 0 || match[2] === void 0 || match[3] === void 0) {
@@ -365,6 +384,13 @@ function version_relation(installed, registry) {
   }
   return "current";
 }
+function is_npm_global_node_modules(node_modules_dir) {
+  const parent = path2.basename(path2.dirname(node_modules_dir));
+  if (parent === "lib") {
+    return true;
+  }
+  return process.platform === "win32" && parent === "npm";
+}
 function detect_install_kind(module_path, env, has_git) {
   if (env.npm_command === "exec" || module_path.includes(`${path2.sep}_npx${path2.sep}`)) {
     return "npx";
@@ -373,7 +399,10 @@ function detect_install_kind(module_path, env, has_git) {
   const root = path2.parse(dir).root;
   while (dir !== root) {
     if (path2.basename(dir) === "node_modules") {
-      return "npm";
+      if (is_npm_global_node_modules(dir) === true) {
+        return "npm";
+      }
+      return "local";
     }
     if (has_git(dir) === true) {
       return "git";
@@ -393,6 +422,9 @@ function blocked_install_message(kind) {
   if (kind === "npx") {
     return "lich: npx runs a temporary copy and cannot persist an update. Install with `npm install -g @moikapy/lich`.\n";
   }
+  if (kind === "local") {
+    return LOCAL_INSTALL_HINT;
+  }
   return null;
 }
 function registry_version(viewed, request) {
@@ -791,17 +823,6 @@ var FLAG_KEYS = {
   "--log-level": "log_level",
   "--theme": "theme"
 };
-var DEFAULT_BASE_URLS = {
-  openai_compat: "https://api.openai.com/v1",
-  anthropic: "https://api.anthropic.com",
-  ollama: "http://localhost:11434"
-};
-var DEFAULT_ENV_API_KEYS = {
-  openai_compat: "OPENAI_API_KEY",
-  anthropic: "ANTHROPIC_API_KEY",
-  ollama: void 0
-  // ollama needs no api key
-};
 function usage_text() {
   return [
     "lich \u2014 the undead agent harness",
@@ -831,6 +852,7 @@ function usage_text() {
     "  --api-key-env <NAME>   env var holding the api key (default LICH_API_KEY_ENV; unused by ollama)",
     "  --system-prompt <s>    system prompt override",
     "  --session-dir <path>   session transcript directory",
+    "  --resume <id|latest>   TUI only: load an existing session transcript",
     "  --log-level <level>    debug | info | warn | error",
     "  --theme <name>         display theme (default lich; files in ~/.lich/themes)",
     "  --command <bin>        mcp add: local stdio binary",
@@ -842,6 +864,21 @@ function usage_text() {
 function error_message(error) {
   return error instanceof Error ? error.message : String(error);
 }
+function reject_resume_outside_tui(resume, mode) {
+  if (resume === void 0) {
+    return;
+  }
+  throw new Error(`--resume is only supported in TUI mode (not ${mode})`);
+}
+function non_tui_resume_mode(first) {
+  if (first === void 0 || first === "tui") {
+    return void 0;
+  }
+  if (first === "init" || first === "config" || first === "mcp" || first === "update" || first === "chat" || first === "gateway") {
+    return first;
+  }
+  return "one-shot";
+}
 function error_for_mode(mode, base_message) {
   if (mode === "tui") {
     return "lich tui: no model configured \u2014 set LICH_MODEL (e.g. glm-5.3-flash:cloud), pass --model, or create .lich/config.json (`lich config` prints a template)";
@@ -879,6 +916,15 @@ function parse_args(argv) {
       index += 1;
       continue;
     }
+    if (arg === "--resume") {
+      const value2 = argv[index + 1];
+      if (value2 === void 0) {
+        throw new Error("--resume requires a value");
+      }
+      options.resume = value2;
+      index += 1;
+      continue;
+    }
     if (mcp === true) {
       const consumed = take_mcp_flag(argv, index, options.mcp_flags);
       if (consumed !== void 0) {
@@ -903,22 +949,25 @@ function parse_args(argv) {
   }
   return options;
 }
-function env_provider(overrides) {
-  const kind_value = overrides["provider_kind"] ?? process.env.LICH_PROVIDER_KIND ?? "openai_compat";
+function parse_provider_kind(kind_value) {
   if (kind_value !== "openai_compat" && kind_value !== "anthropic" && kind_value !== "ollama") {
     throw new Error(`unknown provider kind "${kind_value}" (expected openai_compat, anthropic, or ollama)`);
   }
-  const kind = kind_value;
+  return kind_value;
+}
+function env_provider(overrides) {
+  const kind = parse_provider_kind(overrides["provider_kind"] ?? process.env.LICH_PROVIDER_KIND ?? "openai_compat");
   const model = overrides["provider_model"] ?? process.env.LICH_MODEL;
   if (model === void 0 || model.length === 0) {
     throw new Error("no model configured: set LICH_MODEL, pass --model, or create .lich/config.json (`lich config` prints a template)");
   }
+  const defaults = provider_kind_defaults(kind);
   return {
     kind,
     name: "default",
     model,
-    base_url: overrides["provider_base_url"] ?? process.env.LICH_BASE_URL ?? DEFAULT_BASE_URLS[kind],
-    api_key_env: overrides["provider_api_key_env"] ?? process.env.LICH_API_KEY_ENV ?? DEFAULT_ENV_API_KEYS[kind]
+    base_url: overrides["provider_base_url"] ?? process.env.LICH_BASE_URL ?? defaults.base_url,
+    api_key_env: overrides["provider_api_key_env"] ?? process.env.LICH_API_KEY_ENV ?? defaults.api_key_env
   };
 }
 function load_config_file(config_path) {
@@ -933,6 +982,19 @@ function load_config_file(config_path) {
     throw new Error(`cannot use config file ${config_path}: ${error_message(error)}`);
   }
 }
+function apply_kind_defaults(provider, kind, overrides) {
+  const defaults = provider_kind_defaults(kind);
+  if (overrides["provider_base_url"] === void 0) {
+    provider["base_url"] = defaults.base_url;
+  }
+  if (overrides["provider_api_key_env"] === void 0) {
+    if (defaults.api_key_env === void 0) {
+      delete provider["api_key_env"];
+    } else {
+      provider["api_key_env"] = defaults.api_key_env;
+    }
+  }
+}
 function apply_provider_override(config, overrides) {
   const keys = ["provider_kind", "provider_model", "provider_base_url", "provider_api_key_env"];
   const any_present = keys.some((key) => overrides[key] !== void 0);
@@ -949,12 +1011,19 @@ function apply_provider_override(config, overrides) {
     throw new Error("config providers[0] must be an object");
   }
   const provider = first;
+  const previous_kind = provider["kind"];
   for (const key of keys) {
     const value = overrides[key];
     if (value !== void 0) {
       provider[key.replace("provider_", "")] = value;
     }
   }
+  if (overrides["provider_kind"] !== void 0) {
+    const new_kind = parse_provider_kind(overrides["provider_kind"]);
+    if (previous_kind !== new_kind) {
+      apply_kind_defaults(provider, new_kind, overrides);
+    }
+  }
 }
 function apply_overrides(config, overrides) {
   for (const key of ["work_dir", "system_prompt", "session_dir", "log_level", "theme"]) {
@@ -1038,10 +1107,10 @@ async function run_one_shot(config, input) {
   }
   return 0;
 }
-async function run_chat_turn(agent, input) {
+async function run_chat_turn(agent, input, history) {
   const stop_progress = attach_progress(agent.events);
   try {
-    const result = await agent.run({ input });
+    const result = await agent.run({ input, history });
     const final = result.outcome.final;
     if (final !== void 0 && final.content.length > 0) {
       process.stdout.write(`${final.content}
@@ -1049,23 +1118,15 @@ async function run_chat_turn(agent, input) {
     }
     process.stdout.write(`[turns ${result.outcome.turns_used} | tokens ${result.usage_total.total_tokens}]
 `);
+    return result.messages;
   } catch (error) {
     process.stderr.write(`[lich] ${error_message(error)}
 `);
+    return [...history];
   } finally {
     stop_progress();
   }
 }
-function ask_line2(rl) {
-  return new Promise((resolve) => {
-    const on_close = () => resolve("");
-    rl.question("> ", (answer) => {
-      rl.removeListener("close", on_close);
-      resolve(answer);
-    });
-    rl.once("close", on_close);
-  });
-}
 function budget_stderr_line(turns, notice) {
   const flavor = notice_flavor(notice);
   const suffix = flavor.length === 0 ? "" : ` \u2014 ${flavor}`;
@@ -1076,11 +1137,13 @@ async function run_chat(config) {
   const agent = await create_agent_with_plugins(config);
   const theme = load_theme(agent.config.theme);
   const rl = createInterface({ input: process.stdin, output: process.stdout });
+  let history = [];
   try {
-    for (; ; ) {
-      const line = await ask_line2(rl);
+    process.stdout.write("> ");
+    for await (const line of rl) {
       if (line.trim() === "") {
-        return 0;
+        process.stdout.write("> ");
+        continue;
       }
       const command = line.trim();
       if (command === "/exit" || command === "/quit") {
@@ -1088,8 +1151,10 @@ async function run_chat(config) {
 `);
         return 0;
       }
-      await run_chat_turn(agent, command);
+      history = await run_chat_turn(agent, command, history);
+      process.stdout.write("> ");
     }
+    return 0;
   } finally {
     rl.close();
     agent.close();
@@ -1155,7 +1220,7 @@ async function run_bare(options) {
   if (stopped !== void 0) {
     return stopped;
   }
-  return run_tui_entry(build_config_for(options, "tui"));
+  return run_tui_entry(build_config_for(options, "tui"), options.resume);
 }
 function model_still_placeholder(config) {
   const providers = config["providers"];
@@ -1179,9 +1244,17 @@ function run_init(options) {
   }
   return 0;
 }
-async function run_tui_entry(config) {
-  const { run_tui } = await import("./tui-MEJGEILU.js");
-  return run_tui(config);
+async function run_tui_entry(config, resume) {
+  const { run_tui } = await import("./tui-XXIU4W7K.js");
+  if (resume === void 0) {
+    return run_tui(config);
+  }
+  const { resolve_session_path } = await import("./resolve-H22TOVB5.js");
+  const { read_session_messages } = await import("./store-YYLEB7JG.js");
+  const transcript = await resolve_session_path(config.session_dir, resume);
+  const initial_history = await read_session_messages(transcript);
+  const resumed_id = path4.basename(transcript, ".jsonl");
+  return run_tui(config, { initial_history, resumed_id });
 }
 function gateway_platforms(config, cli_platforms) {
   if (cli_platforms.length > 0) {
@@ -1191,7 +1264,7 @@ function gateway_platforms(config, cli_platforms) {
   return configured.length === 0 ? ["webhook"] : configured;
 }
 async function run_gateway_entry(config, platforms) {
-  const { run_gateway } = await import("./gateway-44QTIJTJ.js");
+  const { run_gateway } = await import("./gateway-OSB7254F.js");
   return run_gateway(config, gateway_platforms(config, platforms));
 }
 function is_cli_entry(input) {
@@ -1237,6 +1310,10 @@ async function run_cli(argv) {
     return 0;
   }
   const [first] = options.positionals;
+  const blocked_resume_mode = non_tui_resume_mode(first);
+  if (blocked_resume_mode !== void 0) {
+    reject_resume_outside_tui(options.resume, blocked_resume_mode);
+  }
   if (first === void 0) {
     return run_bare(options);
   }
@@ -1264,7 +1341,7 @@ async function run_cli(argv) {
     return run_chat(build_config_for(options, first));
   }
   if (first === "tui") {
-    return run_tui_entry(build_config_for(options, first));
+    return run_tui_entry(build_config_for(options, first), options.resume);
   }
   if (first === "gateway") {
     return run_gateway_entry(build_config_for(options, first), options.positionals.slice(1));
@@ -1283,6 +1360,7 @@ if (is_main_module() === true) {
 }
 export {
   is_cli_entry,
+  parse_args,
   run_chat,
   run_cli,
   run_one_shot