clisbot 0.1.51 → 0.1.52

package/README.md

@@ -69,8 +69,8 @@ It is not just a tmux bridge with chat glued on top. `clisbot` treats Slack and
 ### I Just Want To Know What Changed Recently
 
 - start with [Recent Release Highlights](#recent-release-highlights)
-- then read [v0.1.51 Release Notes](docs/releases/v0.1.51.md) or the
-  [v0.1.51 Release Guide](docs/updates/releases/v0.1.51-release-guide.md)
+- then read [v0.1.52 Release Notes](docs/releases/v0.1.52.md) or the
+  [v0.1.52 Release Guide](docs/updates/releases/v0.1.52-release-guide.md)
 
 ## Why I Built This
 
@@ -89,7 +89,7 @@ The challenge is not whether AI is useful. It is how to make it work at enterpri
 - Team-first by design, with `AGENTS`, `USER`, and `MEMORY` context bootstrapping shaped for shared team reality instead of only personal solo-assistant flows.
 - Shared-surface permission control is a first-class feature: a bot can be in a team group but still answer only the specific people you allow there, while sensitive control actions stay behind explicit auth roles and permissions.
 - Useful for coding, operations, teamwork, and general assistant work, with fast chat controls such as `!<command>`, `/bash <command>`, `/queue`, `/loop`, `/streaming`, and `/mention`.
-- New in the `v0.1.50` to `v0.1.51` stable line: the AI-native control experience is much better, and `v0.1.51` also stretches the default runner startup window to 60 seconds so slower Codex, Claude, and Gemini launches do not time out so early.
+- New in the `v0.1.50` to `v0.1.52` stable line: the AI-native control experience is much better, the default runner startup window is now 60 seconds, and stale old startup-delay pins no longer silently keep upgraded installs on shorter timeouts.
 
 ## Who This Fits Best
 
@@ -185,12 +185,12 @@ Next steps:
 - `clisbot` also has a smart autopairing path to reduce first-run friction. If
   you send the bot a DM within the first 30 minutes, you can usually claim the
   owner role immediately and start using it without a separate pairing round.
-- New from the current `v0.1.50` to `v0.1.51` stable line: the AI-native operator experience is much stronger. You
+- New from the current `v0.1.50` to `v0.1.52` stable line: the AI-native operator experience is much stronger. You
   can increasingly ask the bot through chat to explain how to use it, update
   itself and summarize what's new, help onboard you, create or add a new bot or
   agent, or set up loops and schedules for recurring work instead of relying
   only on slash commands.
-- Existing configs from any version before `0.1.50` still update directly on first run when you install `v0.1.51`. clisbot writes a backup first under `~/.clisbot/backups/`, then rewrites the config to the current `0.1.50` schema shape.
+- Existing configs from any version before `0.1.50` still update directly on first run when you install `v0.1.52`. clisbot writes a backup first under `~/.clisbot/backups/`, then rewrites the config to the current `0.1.50` schema shape.
 - Shared Slack channels, Slack groups, Telegram groups, and Telegram topics are a separate gate: normal users need an explicit route such as `group:<id>` or `topic:<chatId>:<topicId>` before the bot will talk there. Legacy Slack `channel:<id>` input still works for compatibility.
 - After a shared surface is admitted, per-surface sender control comes from the bot's default shared rule `groups["*"]` plus any route-local `allowUsers` or `blockUsers`.
 - With that permission model, a bot can be added to a team group but still be
@@ -237,6 +237,7 @@ What happens next:
 
 ## Recent Release Highlights
 
+- `v0.1.52`: clarifies shared-route setup so `routes add ...` clearly means “use the agent currently assigned to that bot by default,” and prunes stale short `startupDelayMs` overrides so upgraded installs can actually inherit the newer 60-second startup default.
 - `v0.1.51`: raises the default runner startup window to 60 seconds across the
   standard CLI families and the shared runner fallback, so slower fresh launches
   are less likely to fail before the first prompt can be submitted.
@@ -271,6 +272,7 @@ Read the full notes here:
 
 - [CHANGELOG.md](CHANGELOG.md)
 - [Release Notes Index](docs/releases/README.md)
+- [v0.1.52 Release Notes](docs/releases/v0.1.52.md)
 - [v0.1.51 Release Notes](docs/releases/v0.1.51.md)
 - [v0.1.50 Release Notes](docs/releases/v0.1.50.md)
 - [v0.1.43 Release Notes](docs/releases/v0.1.43.md)
@@ -306,9 +308,9 @@ Update note for existing installs:
 - Older installs before `v0.1.50` now update directly on first run with a
   backup written first, so most people can update and restart without a manual
   migration pass.
-- `v0.1.51` keeps that direct-upgrade path and does not introduce a new config
-  schema bump; the main runtime change is a longer default runner startup
-  window.
+- `v0.1.52` keeps that direct-upgrade path and does not introduce a new config
+  schema bump; it also cleans up stale short startup-delay overrides that would
+  otherwise keep some upgraded installs on older timeout behavior.
 - After you are on the `v0.1.50` schema line, future upgrades should feel much
   more AI-native:
   in many cases you can simply ask the bot to update `clisbot` to the latest

package/dist/main.js

@@ -62223,6 +62223,7 @@ function assertNoLegacyPrivilegeCommands(value, path = "root") {
 import { basename, dirname as dirname4, join as join5 } from "node:path";
 
 // src/config/persisted-config.ts
+var MIN_PERSISTED_AGENT_STARTUP_DELAY_MS = 30000;
 var defaultOwnedRunnerFields = {
   codex: ["startupDelayMs", "startupReadyPattern"],
   gemini: [
@@ -62265,9 +62266,22 @@ function deleteIfEmpty(owner, key) {
 function defaultRunner(toolId) {
   return buildRunnerFromToolTemplate(toolId, DEFAULT_AGENT_TOOL_TEMPLATES[toolId], undefined);
 }
+function isStaleStartupDelay(value) {
+  return typeof value === "number" && Number.isInteger(value) && value > 0 && value < MIN_PERSISTED_AGENT_STARTUP_DELAY_MS;
+}
+function deleteStaleStartupDelay(owner) {
+  if (!owner || !isStaleStartupDelay(owner.startupDelayMs)) {
+    return false;
+  }
+  delete owner.startupDelayMs;
+  return true;
+}
 function pruneDefaultOwnedFields(params) {
   const defaults = defaultRunner(params.toolId);
   for (const field of defaultOwnedRunnerFields[params.toolId] ?? []) {
+    if (field === "startupDelayMs" && deleteStaleStartupDelay(params.target)) {
+      continue;
+    }
     if (params.force || Object.hasOwn(params.target, field) && areJsonEqual(params.target[field], defaults[field])) {
       delete params.target[field];
     }
@@ -62279,6 +62293,7 @@ function pruneAgentRunnerOverride(runner, cli) {
     return;
   }
   const defaults = defaultRunner(toolId);
+  deleteStaleStartupDelay(runner);
   for (const field of [
     "command",
     "args",
@@ -62296,6 +62311,14 @@ function pruneAgentRunnerOverride(runner, cli) {
     }
   }
 }
+function pruneAgentRunnerDefaultOverride(runner) {
+  const defaults = runner.defaults;
+  if (!isRecord5(defaults)) {
+    return;
+  }
+  deleteStaleStartupDelay(defaults);
+  deleteIfEmpty(runner, "defaults");
+}
 function pruneRunnerDefaults(config, forceRunnerStartupDefaults) {
   const runner = nestedRecord(config, ["agents", "defaults", "runner"]);
   if (!runner) {
@@ -62304,6 +62327,9 @@ function pruneRunnerDefaults(config, forceRunnerStartupDefaults) {
   const runnerDefaults = runner.defaults;
   if (isRecord5(runnerDefaults)) {
     for (const [field, defaultValue] of Object.entries(defaultOwnedRunnerDefaultFields)) {
+      if (field === "startupDelayMs" && deleteStaleStartupDelay(runnerDefaults)) {
+        continue;
+      }
       if (forceRunnerStartupDefaults || Object.hasOwn(runnerDefaults, field) && areJsonEqual(runnerDefaults[field], defaultValue)) {
         delete runnerDefaults[field];
       }
@@ -62329,6 +62355,7 @@ function pruneAgentOverrides(config) {
     if (!isRecord5(agent) || !isRecord5(agent.runner)) {
       continue;
     }
+    pruneAgentRunnerDefaultOverride(agent.runner);
     const cli = typeof agent.cli === "string" ? inferAgentCliToolId(agent.cli) ?? undefined : undefined;
     pruneAgentRunnerOverride(agent.runner, cli);
     deleteIfEmpty(agent, "runner");
@@ -62386,15 +62413,34 @@ function pruneCurrentSchemaStartupDefaults(config) {
   const defaults = isRecord6(agents?.defaults) ? agents.defaults : undefined;
   const runner = isRecord6(defaults?.runner) ? defaults.runner : undefined;
   const runnerDefaults = isRecord6(runner?.defaults) ? runner.defaults : undefined;
-  const codexRunner = isRecord6(runner?.codex) ? runner.codex : undefined;
+  const familyRunners = ["codex", "claude", "gemini"].map((family) => isRecord6(runner?.[family]) ? runner[family] : undefined);
+  const agentList = Array.isArray(agents?.list) ? agents.list : [];
   let pruned = false;
-  if (runnerDefaults?.startupDelayMs === 3000) {
-    delete runnerDefaults.startupDelayMs;
+  if (deleteStaleStartupDelay(runnerDefaults)) {
     pruned = true;
   }
-  if (codexRunner?.startupDelayMs === 3000) {
-    delete codexRunner.startupDelayMs;
-    pruned = true;
+  for (const familyRunner of familyRunners) {
+    if (deleteStaleStartupDelay(familyRunner)) {
+      pruned = true;
+    }
+  }
+  for (const agent of agentList) {
+    if (!isRecord6(agent) || !isRecord6(agent.runner)) {
+      continue;
+    }
+    if (deleteStaleStartupDelay(agent.runner)) {
+      pruned = true;
+    }
+    const runnerDefaultsOverride = isRecord6(agent.runner.defaults) ? agent.runner.defaults : undefined;
+    if (deleteStaleStartupDelay(runnerDefaultsOverride)) {
+      if (runnerDefaultsOverride && Object.keys(runnerDefaultsOverride).length === 0) {
+        delete agent.runner.defaults;
+      }
+      if (Object.keys(agent.runner).length === 0) {
+        delete agent.runner;
+      }
+      pruned = true;
+    }
   }
   if (pruned) {
     nextConfig.meta = {
@@ -75477,8 +75523,11 @@ function renderSlackRouteChoiceMessage(params) {
   return [
     "clisbot: this Slack channel is not configured yet.",
     "",
-    "Ask the bot owner to do these:",
+    "Ask the bot owner to do this first:",
     `- ${renderCliCommand(`routes add --channel slack group:${params.channelId} --bot default`, { inline: true })}`,
+    "  This channel will use the agent currently assigned to this bot by default.",
+    "",
+    "Only if this channel should use a different agent than the one currently assigned to this bot by default:",
     `- ${renderCliCommand(`routes set-agent --channel slack group:${params.channelId} --bot default --agent <id>`, { inline: true })}`,
     "",
     `After that, ${botReference} and send \`\\start\`, \`\\status\`, or \`\\mention\` here.`
@@ -78538,16 +78587,17 @@ function renderTelegramRouteChoiceMessage(params) {
   const lines = [
     topicId != null ? "clisbot: this Telegram topic is not configured yet." : "clisbot: this Telegram group is not configured yet.",
     "",
-    "Ask the bot owner to choose one of these:",
+    "Ask the bot owner to do this first:",
     "",
-    "Add the whole group to the allowlist:",
+    "Add the whole group route:",
     renderCliCommand(`routes add --channel telegram group:${chatId} --bot default`, { inline: true }),
+    "That group will use the agent currently assigned to that bot by default.",
     "",
-    "Bind the whole group to a specific agent:",
+    "Only if that group should use a different agent than the one currently assigned to that bot by default:",
     renderCliCommand(`routes set-agent --channel telegram group:${chatId} --bot default --agent <id>`, { inline: true })
   ];
   if (topicId != null) {
-    lines.push("", "Or bind only this topic to a specific agent:", renderCliCommand(`routes add --channel telegram topic:${chatId}:${topicId} --bot default`, { inline: true }), renderCliCommand(`routes set-agent --channel telegram topic:${chatId}:${topicId} --bot default --agent <id>`, { inline: true }));
+    lines.push("", "Or add only this topic route:", renderCliCommand(`routes add --channel telegram topic:${chatId}:${topicId} --bot default`, { inline: true }), "That topic will use the agent currently assigned to that bot by default.", "", "Only if this topic should use a different agent than the one currently assigned to that bot by default:", renderCliCommand(`routes set-agent --channel telegram topic:${chatId}:${topicId} --bot default --agent <id>`, { inline: true }));
   }
   if (params.includeConfigPath) {
     lines.push("", topicId != null ? `Config path: \`bots.telegram.default.groups."${chatId}".topics."${topicId}"\`` : `Config path: \`bots.telegram.default.groups."${chatId}"\``);
@@ -84868,8 +84918,8 @@ function appendChannelNextStepLines(lines, summary, prefix = "") {
     lines.push(`${prefix}- DM the Slack bot first to confirm it responds normally`);
   }
   lines.push(`${prefix}- after DM works, add the bot to the target Slack channel or Telegram group/topic`);
-  lines.push(`${prefix}- add the route with ${renderCliCommand("routes add --channel slack group:<channelId> --bot default", { inline: true })} or ${renderCliCommand("routes add --channel telegram group:<chatId> --bot default", { inline: true })}`);
-  lines.push(`${prefix}- bind the agent with ${renderCliCommand("routes set-agent --channel slack group:<channelId> --bot default --agent <id>", { inline: true })} or ${renderCliCommand("routes set-agent --channel telegram group:<chatId> --bot default --agent <id>", { inline: true })}`);
+  lines.push(`${prefix}- add the route with ${renderCliCommand("routes add --channel slack group:<channelId> --bot default", { inline: true })} or ${renderCliCommand("routes add --channel telegram group:<chatId> --bot default", { inline: true })}; that route uses the agent currently assigned to that bot by default`);
+  lines.push(`${prefix}- only if you want a different agent there than the one currently assigned to that bot by default, bind it with ${renderCliCommand("routes set-agent --channel slack group:<channelId> --bot default --agent <id>", { inline: true })} or ${renderCliCommand("routes set-agent --channel telegram group:<chatId> --bot default --agent <id>", { inline: true })}`);
   if (telegramEnabled) {
     lines.push(`${prefix}- Telegram: send \`/start\` in the target DM, group, or topic to get onboarding or pairing guidance`);
   }
@@ -85013,9 +85063,9 @@ function appendChannelSetupNote(lines, summary, channel, prefix) {
     lines.push(`${prefix}    dms: ${channel.directMessagesEnabled ? `enabled (${channel.directMessagesPolicy})` : "disabled"}`);
     lines.push(`${prefix}    sharedDefault: ${channel.sharedDefaultPolicy ?? "n/a"}`);
     lines.push(`${prefix}    add group: ${renderCliCommand("routes add --channel telegram group:<chatId> --bot default", { inline: true })}`);
-    lines.push(`${prefix}    bind group: ${renderCliCommand("routes set-agent --channel telegram group:<chatId> --bot default --agent <id>", { inline: true })}`);
+    lines.push(`${prefix}    route uses the agent currently assigned to that bot by default`);
     lines.push(`${prefix}    add topic: ${renderCliCommand("routes add --channel telegram topic:<chatId>:<topicId> --bot default", { inline: true })}`);
-    lines.push(`${prefix}    bind topic: ${renderCliCommand("routes set-agent --channel telegram topic:<chatId>:<topicId> --bot default --agent <id>", { inline: true })}`);
+    lines.push(`${prefix}    optional agent override if that surface should use a different agent than the one currently assigned to that bot by default: ${renderCliCommand("routes set-agent --channel telegram group:<chatId> --bot default --agent <id>", { inline: true })} or ${renderCliCommand("routes set-agent --channel telegram topic:<chatId>:<topicId> --bot default --agent <id>", { inline: true })}`);
     lines.push(`${prefix}    adjust later: ${renderPrivilegedChatHint(summary, "run in-chat commands here")}`);
     return;
   }
@@ -85023,7 +85073,8 @@ function appendChannelSetupNote(lines, summary, channel, prefix) {
   lines.push(`${prefix}    dms: ${channel.directMessagesEnabled ? `enabled (${channel.directMessagesPolicy})` : "disabled"}`);
   lines.push(`${prefix}    sharedDefault: ${channel.sharedDefaultPolicy ?? "n/a"}`);
   lines.push(`${prefix}    add group: ${renderCliCommand("routes add --channel slack group:<channelId> --bot default", { inline: true })}`);
-  lines.push(`${prefix}    bind group: ${renderCliCommand("routes set-agent --channel slack group:<channelId> --bot default --agent <id>", { inline: true })}`);
+  lines.push(`${prefix}    route uses the agent currently assigned to that bot by default`);
+  lines.push(`${prefix}    optional agent override if that route should use a different agent than the one currently assigned to that bot by default: ${renderCliCommand("routes set-agent --channel slack group:<channelId> --bot default --agent <id>", { inline: true })}`);
   lines.push(`${prefix}    adjust later: ${renderPrivilegedChatHint(summary, "run in-chat commands here")}`);
 }
 function appendBootstrapGuidance(lines, summary) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "clisbot",
-  "version": "0.1.51",
+  "version": "0.1.52",
   "private": false,
   "description": "Chat surfaces for durable AI coding agents running in tmux",
   "license": "MIT",