@moikapy/lich 0.4.0 → 0.5.1

package/CHANGELOG.md

@@ -1,5 +1,34 @@
 # Changelog
 
+## 0.5.1
+
+- fix the CLI so bun's global bin enters main (symlink argv no longer skips the entry).
+- read LICH_VERSION from package.json so lich --version is not stuck at 0.3.0.
+
+## 0.5.0
+
+- add a `game_bridge` example plugin that queues batched enemy actions
+  and durable dungeon memory under `.lich/game/` for a Godot combat tick.
+  a `before_tool_call` hook holds meteor until round 3. node loads the
+  `.mjs` entry from `config.plugins`.
+- load `config.plugins` on every CLI entry point and on `run_agent`
+  (`create_agent_with_plugins`). one-shot, chat, tui, and the gateway
+  bus no longer ignore plugin entries. broken plugins still warn and
+  continue. `create_agent` stays plugin-free.
+- bare `lich` opens the TUI. On a TTY, when no config is in the search
+  chain and `LICH_MODEL` is unset, a readline wizard collects agent name,
+  provider, gateway env-var names (never secrets), and plugins, then
+  writes `.lich/config.json` once. Non-TTY stdin skips the wizard and
+  prints guidance. `lich init` writes the starter file through the same
+  writer and never overwrites an existing `.lich/config.json`.
+- add `lich update`: compare the installed version with `npm view
+  @moikapy/lich version` and, when newer, run
+  `npm install -g @moikapy/lich@latest`. git clones are told to
+  `git pull`; npx cannot persist an update.
+- document embedding that plugin beside a Godot game: one webhook call
+  per combat round, and the `.lich/game/` drain tick. see
+  docs/user-guide/godot.md.
+
 ## 0.4.0
 
 - add a self-improvement loop: `run_tests`, a gatekeeper plugin, and

package/dist/chunk-6M6OAQGN.js

@@ -0,0 +1,17 @@
+// src/index.ts
+import { readFileSync } from "fs";
+import { fileURLToPath } from "url";
+function read_package_version() {
+  const pkg_path = fileURLToPath(new URL("../package.json", import.meta.url));
+  const pkg = JSON.parse(readFileSync(pkg_path, "utf8"));
+  if (typeof pkg.version !== "string" || pkg.version.length === 0) {
+    throw new Error("package.json is missing version");
+  }
+  return pkg.version;
+}
+var LICH_VERSION = read_package_version();
+
+export {
+  LICH_VERSION
+};
+//# sourceMappingURL=chunk-6M6OAQGN.js.map

package/dist/chunk-6M6OAQGN.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.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 { AgentEmitter } from \"./agent/events.js\";\nexport type { AgentEvent, AgentEventHandler, AgentEvents } from \"./agent/events.js\";\nexport type { LoopOutcome, LoopParams } from \"./agent/loop.js\";\nexport type {\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 { 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\";"],"mappings":";AAGA,SAAS,oBAAoB;AAC7B,SAAS,qBAAqB;AAE9B,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-MLFJW4JU.js → chunk-CV2YH3FH.js}

@@ -1881,6 +1881,43 @@ var ProviderError = class extends Error {
 
 // src/agent/config.ts
 import { z } from "zod";
+
+// src/gateway/token_env.ts
+var DEFAULT_GATEWAY_TOKEN_ENVS = {
+  webhook: "LICH_GATEWAY_TOKEN",
+  telegram: "LICH_TELEGRAM_BOT_TOKEN",
+  discord: "LICH_DISCORD_BOT_TOKEN",
+  twitch: "LICH_TWITCH_OAUTH_TOKEN"
+};
+var ENV_VAR_NAME = /^[A-Za-z_][A-Za-z0-9_]*$/;
+function is_env_var_name(value) {
+  return ENV_VAR_NAME.test(value) === true;
+}
+function platform_token_env(config, platform) {
+  const named = config.gateway?.token_envs[platform];
+  if (named !== void 0 && named.length > 0) {
+    return is_env_var_name(named) === true ? named : "";
+  }
+  return DEFAULT_GATEWAY_TOKEN_ENVS[platform] ?? "";
+}
+function read_platform_token(config, platform) {
+  const key = platform_token_env(config, platform);
+  if (is_env_var_name(key) === false) {
+    return void 0;
+  }
+  const value = process.env[key];
+  if (typeof value !== "string" || value.length === 0) {
+    return void 0;
+  }
+  return value;
+}
+
+// src/agent/config.ts
+var gateway_schema = z.object({
+  platforms: z.array(z.enum(["webhook", "telegram", "discord", "twitch"])).default([]),
+  /** Env-var names that hold tokens. Never store the secrets themselves. */
+  token_envs: z.record(z.string(), z.string().regex(ENV_VAR_NAME, "invalid env var name")).default({})
+}).optional();
 var provider_schema = z.object({
   kind: z.enum(["openai_compat", "anthropic", "ollama"]),
   name: z.string().min(1),
@@ -1893,6 +1930,8 @@ var provider_schema = z.object({
   fetch_fn: z.custom(() => true).optional()
 }).passthrough();
 var agent_config_schema = z.object({
+  /** Display name used by the TUI banner. */
+  agent_name: z.string().min(1).default("lich"),
   system_prompt: z.string().optional(),
   max_turns: z.number().int().min(1).default(25),
   providers: z.array(provider_schema).min(1),
@@ -1906,6 +1945,7 @@ var agent_config_schema = z.object({
   terminal_timeout_ms: z.number().int().positive().default(6e4),
   /** Plugin entry module specifiers, relative to work_dir or absolute. */
   plugins: z.array(z.string()).default([]),
+  gateway: gateway_schema,
   log_level: z.enum(["debug", "info", "warn", "error"]).default("info")
 }).transform((config) => {
   const work_dir = config.work_dir ?? process.cwd();
@@ -1922,6 +1962,11 @@ function freeze_config(config) {
   for (const provider of config.providers) {
     Object.freeze(provider);
   }
+  if (config.gateway !== void 0) {
+    Object.freeze(config.gateway.platforms);
+    Object.freeze(config.gateway.token_envs);
+    Object.freeze(config.gateway);
+  }
   return config;
 }
 function parse_agent_config(raw) {
@@ -3734,7 +3779,7 @@ async function create_agent_with_plugins(raw_config) {
   return new Agent(config, plugins);
 }
 async function run_agent(raw_config, input, options) {
-  const agent = create_agent(raw_config);
+  const agent = await create_agent_with_plugins(raw_config);
   return agent.run({ input, signal: options?.signal, label: options?.label });
 }
 
@@ -3750,6 +3795,10 @@ export {
   plugin_errors_summary,
   sleep,
   ProviderError,
+  DEFAULT_GATEWAY_TOKEN_ENVS,
+  is_env_var_name,
+  platform_token_env,
+  read_platform_token,
   parse_agent_config,
   AgentEmitter,
   Agent,
@@ -3757,4 +3806,4 @@ export {
   create_agent_with_plugins,
   run_agent
 };
-//# sourceMappingURL=chunk-MLFJW4JU.js.map
+//# sourceMappingURL=chunk-CV2YH3FH.js.map