@moikapy/lich 0.4.0 → 0.5.0

package/CHANGELOG.md

@@ -1,5 +1,29 @@
 # Changelog
 
+## 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-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