clisbot 0.1.50 → 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.50 Release Notes](docs/releases/v0.1.50.md) or the
-  [v0.1.50 Release Guide](docs/updates/releases/v0.1.50-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 `v0.1.50`: the AI-native control experience is much better. You can increasingly ask the bot in normal chat to update itself and explain what changed, help with onboarding, add or configure bots and agents, or create recurring schedules and loops for you instead of relying only on slash commands.
+- 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 `v0.1.50`: 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` update directly to `0.1.50` automatically on first run. clisbot writes a backup first under `~/.clisbot/backups/`, then rewrites the config to the current 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,10 @@ 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.
 - `v0.1.50`: a much more AI-native operator experience, where you can
   increasingly talk to the bot to manage itself; plus safer personal and team
   bots in real Slack and Telegram groups, automatic direct updates from older
@@ -245,7 +249,7 @@ What happens next:
   streaming/session isolation.
 - `v0.1.43`: more durable runtime recovery, clearer routed follow-up controls, more truthful tmux prompt submission checks, better queued-start notifications, and safer Slack thread attachment behavior.
 
-What `v0.1.50` most likely means for you:
+What the current stable line most likely means for you:
 
 - The headline is AI-native control: ask the bot in chat to queue work,
   schedule recurring briefs, help update itself, explain release changes, or
@@ -268,6 +272,8 @@ 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)
 - [v0.1.39 Release Notes](docs/releases/v0.1.39.md)
@@ -302,7 +308,11 @@ 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.
-- After you are on `v0.1.50`, future upgrades should feel much more AI-native:
+- `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
   version, and it can follow the update guide, perform the upgrade flow, then
   brief you on what changed.

package/config/clisbot.json.template

@@ -410,7 +410,7 @@
             "--approval-mode=yolo",
             "--sandbox=false"
           ],
-          "startupDelayMs": 15000,
+          "startupDelayMs": 60000,
           "startupRetryCount": 2,
           "startupRetryDelayMs": 1000,
           "startupReadyPattern": "Type your message or @path/to/file",

package/dist/main.js

@@ -59472,7 +59472,7 @@ function convertLocalDateTimeToUtcMs(params) {
 var SUPPORTED_AGENT_CLI_TOOLS = ["codex", "claude", "gemini"];
 var SUPPORTED_BOOTSTRAP_MODES = ["personal-assistant", "team-assistant"];
 var SESSION_ID_PATTERN = "\\b[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}\\b";
-var INTERACTIVE_CLI_STARTUP_DELAY_MS = 15000;
+var INTERACTIVE_CLI_STARTUP_DELAY_MS = 60000;
 var DEFAULT_AGENT_TOOL_TEMPLATES = {
   codex: {
     command: "codex",
@@ -60972,7 +60972,7 @@ var runnerDefaultsSchema = exports_external.object({
     socketPath: "~/.clisbot/state/clisbot.sock"
   }),
   trustWorkspace: exports_external.boolean().default(true),
-  startupDelayMs: exports_external.number().int().positive().default(3000),
+  startupDelayMs: exports_external.number().int().positive().default(60000),
   startupRetryCount: exports_external.number().int().min(0).default(2),
   startupRetryDelayMs: exports_external.number().int().min(0).default(1000),
   promptSubmitDelayMs: exports_external.number().int().min(0).default(150),
@@ -61452,7 +61452,7 @@ var agentsDefaultsSchema = exports_external.object({
         socketPath: "~/.clisbot/state/clisbot.sock"
       },
       trustWorkspace: true,
-      startupDelayMs: 3000,
+      startupDelayMs: 60000,
       startupRetryCount: 2,
       startupRetryDelayMs: 1000,
       promptSubmitDelayMs: 150,
@@ -61913,7 +61913,7 @@ var clisbotConfigSchema = exports_external.object({
             socketPath: "~/.clisbot/state/clisbot.sock"
           },
           trustWorkspace: true,
-          startupDelayMs: 3000,
+          startupDelayMs: 60000,
           startupRetryCount: 2,
           startupRetryDelayMs: 1000,
           promptSubmitDelayMs: 150,
@@ -62042,7 +62042,7 @@ var clisbotConfigSchema = exports_external.object({
             socketPath: "~/.clisbot/state/clisbot.sock"
           },
           trustWorkspace: true,
-          startupDelayMs: 3000,
+          startupDelayMs: 60000,
           startupRetryCount: 2,
           startupRetryDelayMs: 1000,
           promptSubmitDelayMs: 150,
@@ -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: [
@@ -62235,7 +62236,7 @@ var defaultOwnedRunnerFields = {
   ]
 };
 var defaultOwnedRunnerDefaultFields = {
-  startupDelayMs: 3000
+  startupDelayMs: 60000
 };
 function isRecord5(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
@@ -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.50",
+  "version": "0.1.52",
   "private": false,
   "description": "Chat surfaces for durable AI coding agents running in tmux",
   "license": "MIT",