clisbot 0.1.11 → 0.1.13

package/dist/main.js

@@ -54670,7 +54670,7 @@ function renderCliHelp() {
     "  Fresh bootstrap only enables channels named by flags; ambient env vars alone do not auto-enable extra channels.",
     "",
     "Usage:",
-    "  clisbot start [--cli <codex|claude>] [--bot-type <personal|team>] [--persist]",
+    "  clisbot start [--cli <codex|claude|gemini>] [--bot-type <personal|team>] [--persist]",
     "               [--slack-account <id> --slack-app-token <ENV_NAME|${ENV_NAME}|literal> --slack-bot-token <ENV_NAME|${ENV_NAME}|literal>]...",
     "               [--telegram-account <id> --telegram-bot-token <ENV_NAME|${ENV_NAME}|literal>]...",
     "  clisbot restart",
@@ -54684,7 +54684,7 @@ function renderCliHelp() {
     "  clisbot message <subcommand>",
     "  clisbot agents <subcommand>",
     "  clisbot pairing <subcommand>",
-    "  clisbot init [--cli <codex|claude>] [--bot-type <personal|team>] [--persist]",
+    "  clisbot init [--cli <codex|claude|gemini>] [--bot-type <personal|team>] [--persist]",
     "              [--slack-account <id> --slack-app-token <ENV_NAME|${ENV_NAME}|literal> --slack-bot-token <ENV_NAME|${ENV_NAME}|literal>]...",
     "              [--telegram-account <id> --telegram-bot-token <ENV_NAME|${ENV_NAME}|literal>]...",
     "  clis <same-command>",
@@ -55104,7 +55104,7 @@ async function runPairingCli(args, writer = console) {
 }
 
 // src/config/agent-tool-presets.ts
-var SUPPORTED_AGENT_CLI_TOOLS = ["codex", "claude"];
+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 DEFAULT_AGENT_TOOL_TEMPLATES = {
@@ -55169,6 +55169,41 @@ var DEFAULT_AGENT_TOOL_TEMPLATES = {
         ]
       }
     }
+  },
+  gemini: {
+    command: "gemini",
+    startupOptions: ["--approval-mode=yolo", "--sandbox=false"],
+    trustWorkspace: true,
+    startupDelayMs: 15000,
+    startupReadyPattern: "Type your message or @path/to/file",
+    startupBlockers: [
+      {
+        pattern: "Please visit the following URL to authorize the application|Enter the authorization code:",
+        message: "Gemini CLI is waiting for manual OAuth authorization. Authenticate Gemini once in a direct interactive terminal, or configure headless auth such as GEMINI_API_KEY or Vertex AI before routing Gemini through clisbot."
+      },
+      {
+        pattern: "How would you like to authenticate for this project\\?|Failed to sign in\\.|Manual authorization is required but the current session is non-interactive",
+        message: "Gemini CLI is blocked in its authentication setup flow or sign-in recovery. Complete Gemini authentication directly first, or switch clisbot to a headless auth path such as GEMINI_API_KEY or Vertex AI before routing prompts."
+      }
+    ],
+    promptSubmitDelayMs: 200,
+    sessionId: {
+      create: {
+        mode: "runner",
+        args: []
+      },
+      capture: {
+        mode: "status-command",
+        statusCommand: "/stats session",
+        pattern: SESSION_ID_PATTERN,
+        timeoutMs: 8000,
+        pollIntervalMs: 250
+      },
+      resume: {
+        mode: "command",
+        args: ["--resume", "{sessionId}", "--approval-mode=yolo", "--sandbox=false"]
+      }
+    }
   }
 };
 function buildRunnerFromToolTemplate(toolId, template, startupOptions) {
@@ -55179,6 +55214,8 @@ function buildRunnerFromToolTemplate(toolId, template, startupOptions) {
       args: [...options, "-C", "{workspace}"],
       trustWorkspace: template.trustWorkspace,
       startupDelayMs: template.startupDelayMs,
+      startupReadyPattern: template.startupReadyPattern,
+      startupBlockers: template.startupBlockers?.map((entry) => ({ ...entry })),
       promptSubmitDelayMs: template.promptSubmitDelayMs,
       sessionId: {
         ...template.sessionId,
@@ -55201,6 +55238,8 @@ function buildRunnerFromToolTemplate(toolId, template, startupOptions) {
     args: [...options],
     trustWorkspace: template.trustWorkspace,
     startupDelayMs: template.startupDelayMs,
+    startupReadyPattern: template.startupReadyPattern,
+    startupBlockers: template.startupBlockers?.map((entry) => ({ ...entry })),
     promptSubmitDelayMs: template.promptSubmitDelayMs,
     sessionId: {
       ...template.sessionId,
@@ -55229,6 +55268,9 @@ function inferAgentCliToolId(command) {
   if (trimmed === "claude") {
     return "claude";
   }
+  if (trimmed === "gemini") {
+    return "gemini";
+  }
   return null;
 }
 
@@ -59759,6 +59801,10 @@ var runnerSessionIdObjectSchema = exports_external.object({
   resume: runnerSessionIdResumeSchema.default(defaultRunnerSessionIdConfig.resume)
 });
 var runnerSessionIdSchema = runnerSessionIdObjectSchema.default(defaultRunnerSessionIdConfig);
+var runnerStartupBlockerSchema = exports_external.object({
+  pattern: exports_external.string().min(1),
+  message: exports_external.string().min(1)
+});
 var runnerSchema = exports_external.object({
   command: exports_external.string().min(1),
   args: exports_external.array(exports_external.string()).default([
@@ -59769,6 +59815,8 @@ var runnerSchema = exports_external.object({
   ]),
   trustWorkspace: exports_external.boolean().default(true),
   startupDelayMs: exports_external.number().int().positive().default(3000),
+  startupReadyPattern: exports_external.string().min(1).optional(),
+  startupBlockers: exports_external.array(runnerStartupBlockerSchema).optional(),
   promptSubmitDelayMs: exports_external.number().int().min(0).default(150),
   sessionId: runnerSessionIdSchema.default(defaultRunnerSessionIdConfig)
 });
@@ -59803,6 +59851,8 @@ var runnerOverrideSchema = exports_external.object({
   args: exports_external.array(exports_external.string()).optional(),
   trustWorkspace: exports_external.boolean().optional(),
   startupDelayMs: exports_external.number().int().positive().optional(),
+  startupReadyPattern: exports_external.string().min(1).optional(),
+  startupBlockers: exports_external.array(runnerStartupBlockerSchema).optional(),
   promptSubmitDelayMs: exports_external.number().int().min(0).optional(),
   sessionId: runnerSessionIdObjectSchema.partial().extend({
     create: runnerSessionIdCreateSchema.partial().optional(),
@@ -60347,6 +60397,7 @@ function renderDefaultConfigTemplate(options = {}) {
           ],
           trustWorkspace: true,
           startupDelayMs: 3000,
+          startupReadyPattern: undefined,
           promptSubmitDelayMs: 150,
           sessionId: {
             create: {
@@ -60575,7 +60626,8 @@ var CUSTOMIZED_TEMPLATE_DIR = join4(TEMPLATE_ROOT, "customized");
 var CUSTOMIZED_DEFAULT_TEMPLATE_DIR = join4(CUSTOMIZED_TEMPLATE_DIR, "default");
 var TOOL_BOOTSTRAP_FILE = {
   codex: "AGENTS.md",
-  claude: "CLAUDE.md"
+  claude: "CLAUDE.md",
+  gemini: "GEMINI.md"
 };
 function shouldIncludeTemplateFile(toolId, relativePath) {
   const normalized = relativePath.replaceAll("\\", "/");
@@ -60585,6 +60637,9 @@ function shouldIncludeTemplateFile(toolId, relativePath) {
   if (normalized.endsWith("CLAUDE.md")) {
     return toolId === "claude";
   }
+  if (normalized.endsWith("GEMINI.md")) {
+    return toolId === "gemini";
+  }
   return true;
 }
 function collectTemplateFiles(rootDir, toolId, prefix = "") {
@@ -60882,11 +60937,11 @@ async function addAgentToEditableConfig(params) {
 async function addAgent(args) {
   const agentId = args[0]?.trim();
   if (!agentId) {
-    throw new Error("Usage: agents add <id> --cli <codex|claude> [--workspace <path>] [--startup-option <arg>]... [--bootstrap <personal-assistant|team-assistant>] [--bind <channel[:accountId]>]...");
+    throw new Error("Usage: agents add <id> --cli <codex|claude|gemini> [--workspace <path>] [--startup-option <arg>]... [--bootstrap <personal-assistant|team-assistant>] [--bind <channel[:accountId]>]...");
   }
   const cliTool = parseSingleOption(args, "--cli");
   if (!cliTool || !(cliTool in DEFAULT_AGENT_TOOL_TEMPLATES)) {
-    throw new Error("agents add requires --cli codex or --cli claude");
+    throw new Error("agents add requires --cli codex, --cli claude, or --cli gemini");
   }
   const workspace = parseSingleOption(args, "--workspace");
   const startupOptions = parseRepeatedOption(args, "--startup-option");
@@ -61088,7 +61143,7 @@ async function runAgentsCli(args) {
 
 // src/control/accounts-cli.ts
 import { setTimeout as sleep2 } from "node:timers/promises";
-import { existsSync as existsSync7, readFileSync as readFileSync3 } from "node:fs";
+import { existsSync as existsSync7, readFileSync as readFileSync4 } from "node:fs";
 
 // src/config/channel-account-management.ts
 function getFirstAccountId(accounts) {
@@ -61437,8 +61492,8 @@ class RuntimeHealthStore {
 }
 
 // src/control/runtime-process.ts
-import { spawn as spawn2 } from "node:child_process";
-import { closeSync, existsSync as existsSync6, openSync, rmSync as rmSync2, statSync as statSync3 } from "node:fs";
+import { execFileSync, spawn as spawn2 } from "node:child_process";
+import { closeSync, existsSync as existsSync6, openSync, readFileSync as readFileSync3, rmSync as rmSync2, statSync as statSync3 } from "node:fs";
 import { dirname as dirname9 } from "node:path";
 import { kill } from "node:process";
 
@@ -61807,6 +61862,12 @@ class StartDetachedRuntimeError extends Error {
     this.name = "StartDetachedRuntimeError";
   }
 }
+var DEFAULT_PROCESS_LIVENESS_DEPENDENCIES = {
+  platform: process.platform,
+  signalCheck: signalCheckProcess,
+  readLinuxProcStat: readLinuxProcStatLiveness,
+  readPsStat: readPsStatLiveness
+};
 function readRuntimePid(pidPath) {
   const expandedPidPath = resolvePidPath(pidPath);
   if (!existsSync6(expandedPidPath)) {
@@ -61819,12 +61880,28 @@ function readRuntimePid(pidPath) {
   });
 }
 function isProcessRunning(pid) {
-  try {
-    kill(pid, 0);
-    return true;
-  } catch {
-    return false;
+  return getProcessLiveness(pid) === "running";
+}
+function getProcessLiveness(pid, dependencies = {}) {
+  const resolvedDependencies = {
+    ...DEFAULT_PROCESS_LIVENESS_DEPENDENCIES,
+    ...dependencies
+  };
+  if (!resolvedDependencies.signalCheck(pid)) {
+    return "missing";
   }
+  if (resolvedDependencies.platform === "win32") {
+    return "running";
+  }
+  const linuxState = resolvedDependencies.readLinuxProcStat(pid);
+  if (linuxState !== "unknown") {
+    return linuxState;
+  }
+  const psState = resolvedDependencies.readPsStat(pid);
+  if (psState !== "unknown") {
+    return psState;
+  }
+  return "running";
 }
 async function ensureConfigFile(configPath, options = {}) {
   await ensureClisbotWrapper();
@@ -61907,18 +61984,27 @@ async function startDetachedRuntime(params) {
     logPath
   };
 }
-async function stopDetachedRuntime(params) {
+async function stopDetachedRuntime(params, dependencies = {}) {
   const pidPath = resolvePidPath(params.pidPath);
   const runtimeCredentialsPath = resolveRuntimeCredentialsPath(params.runtimeCredentialsPath);
   const existingPid = await readRuntimePid(pidPath);
   let stopped = false;
-  if (existingPid && isProcessRunning(existingPid)) {
-    kill(existingPid, "SIGTERM");
-    const exited = await waitForProcessExit(existingPid, STOP_WAIT_TIMEOUT_MS);
+  const processLiveness = dependencies.processLiveness ?? getProcessLiveness;
+  const sendSignal = dependencies.sendSignal ?? kill;
+  const sleepFn = dependencies.sleep ?? sleep;
+  const existingLiveness = existingPid ? processLiveness(existingPid) : "missing";
+  if (existingPid && existingLiveness === "running") {
+    sendSignal(existingPid, "SIGTERM");
+    const exited = await waitForProcessExit(existingPid, STOP_WAIT_TIMEOUT_MS, {
+      processLiveness,
+      sleep: sleepFn
+    });
     if (!exited) {
       throw new Error(`clisbot did not stop within ${STOP_WAIT_TIMEOUT_MS}ms`);
     }
     stopped = true;
+  } else if (existingPid && existingLiveness === "zombie") {
+    stopped = true;
   }
   rmSync2(pidPath, { force: true });
   removeRuntimeCredentials(runtimeCredentialsPath);
@@ -61960,9 +62046,10 @@ async function getRuntimeStatus(params = {}) {
   const pidPath = resolvePidPath(params.pidPath);
   const logPath = resolveLogPath(params.logPath);
   const pid = await readRuntimePid(pidPath);
+  const liveness = pid ? getProcessLiveness(pid) : "missing";
   return {
-    running: Boolean(pid && isProcessRunning(pid)),
-    pid: pid && isProcessRunning(pid) ? pid : undefined,
+    running: liveness === "running",
+    pid: liveness === "running" && pid ? pid : undefined,
     configPath,
     pidPath,
     logPath,
@@ -62032,15 +62119,17 @@ async function waitForStart(params) {
     childPid: params.childPid
   };
 }
-async function waitForProcessExit(pid, timeoutMs) {
+async function waitForProcessExit(pid, timeoutMs, dependencies = {}) {
+  const processLiveness = dependencies.processLiveness ?? getProcessLiveness;
+  const sleepFn = dependencies.sleep ?? sleep;
   const deadline = Date.now() + timeoutMs;
   while (Date.now() < deadline) {
-    if (!isProcessRunning(pid)) {
+    if (processLiveness(pid) !== "running") {
       return true;
     }
-    await sleep(PROCESS_POLL_INTERVAL_MS);
+    await sleepFn(PROCESS_POLL_INTERVAL_MS);
   }
-  return !isProcessRunning(pid);
+  return processLiveness(pid) !== "running";
 }
 async function cleanupFailedStartChild(result) {
   if (result.reason === "child-exited-before-pid") {
@@ -62087,6 +62176,66 @@ async function resolveTmuxSocketPath(configPath) {
   }
   return getDefaultTmuxSocketPath();
 }
+function signalCheckProcess(pid) {
+  try {
+    kill(pid, 0);
+    return true;
+  } catch {
+    return false;
+  }
+}
+function readLinuxProcStatLiveness(pid) {
+  if (process.platform !== "linux") {
+    return "unknown";
+  }
+  try {
+    const raw = readFileSync3(`/proc/${pid}/stat`, "utf8");
+    const state = extractLinuxProcState(raw);
+    if (!state) {
+      return "unknown";
+    }
+    return state.includes("Z") ? "zombie" : "running";
+  } catch (error) {
+    const code = error.code;
+    if (code === "ENOENT") {
+      return "missing";
+    }
+    return "unknown";
+  }
+}
+function readPsStatLiveness(pid) {
+  try {
+    const raw = execFileSync("ps", ["-o", "stat=", "-p", String(pid)], {
+      encoding: "utf8",
+      stdio: ["ignore", "pipe", "ignore"]
+    }).trim();
+    if (!raw) {
+      return "missing";
+    }
+    return raw.includes("Z") ? "zombie" : "running";
+  } catch (error) {
+    const commandError = error;
+    if (commandError.code === "ENOENT") {
+      return "unknown";
+    }
+    if (commandError.status === 1) {
+      return "missing";
+    }
+    return "unknown";
+  }
+}
+function extractLinuxProcState(raw) {
+  const closingParenIndex = raw.lastIndexOf(")");
+  if (closingParenIndex < 0) {
+    return null;
+  }
+  const remainder = raw.slice(closingParenIndex + 1).trim();
+  if (!remainder) {
+    return null;
+  }
+  const [state] = remainder.split(/\s+/, 1);
+  return state?.trim() || null;
+}
 
 // src/control/accounts-cli.ts
 function getEditableConfigPath2() {
@@ -62111,7 +62260,7 @@ function readRuntimeCredentialDocument() {
   if (!existsSync7(path2)) {
     return {};
   }
-  const text = readFileSync3(path2, "utf8").trim();
+  const text = readFileSync4(path2, "utf8").trim();
   return text ? JSON.parse(text) : {};
 }
 async function waitForReloadResult(configPath, deps, timeoutMs = 12000) {
@@ -63380,6 +63529,9 @@ async function runChannelsCli(args) {
 }
 
 // src/control/channel-bootstrap-flags.ts
+function isLiteralToken(token) {
+  return token?.kind === "mem";
+}
 function parseBotType(rawValue) {
   const value = rawValue.trim().toLowerCase();
   if (value === "personal" || value === "personal-assistant") {
@@ -63434,7 +63586,6 @@ function validateTelegramAccount(account) {
 function parseBootstrapFlags(args) {
   const slackAccounts = [];
   const telegramAccounts = [];
-  const literalWarnings = [];
   let currentSlackAccountId;
   let currentTelegramAccountId;
   let cliTool;
@@ -63486,9 +63637,6 @@ function parseBootstrapFlags(args) {
       const token = parseTokenInput(parseOptionValue4(args, arg, index));
       const account = getOrCreateSlackAccount(slackAccounts, currentSlackAccountId ?? "default");
       account.appToken = token;
-      if (token.kind === "mem") {
-        literalWarnings.push(`Slack account ${account.accountId} uses a literal CLI token; shell history or process inspection may expose it.`);
-      }
       sawCredentialFlags = true;
       sawSlackFlags = true;
       index += 1;
@@ -63498,9 +63646,6 @@ function parseBootstrapFlags(args) {
       const token = parseTokenInput(parseOptionValue4(args, arg, index));
       const account = getOrCreateSlackAccount(slackAccounts, currentSlackAccountId ?? "default");
       account.botToken = token;
-      if (token.kind === "mem") {
-        literalWarnings.push(`Slack account ${account.accountId} uses a literal CLI token; shell history or process inspection may expose it.`);
-      }
       sawCredentialFlags = true;
       sawSlackFlags = true;
       index += 1;
@@ -63510,9 +63655,6 @@ function parseBootstrapFlags(args) {
       const token = parseTokenInput(parseOptionValue4(args, arg, index));
       const account = getOrCreateTelegramAccount(telegramAccounts, currentTelegramAccountId ?? "default");
       account.botToken = token;
-      if (token.kind === "mem") {
-        literalWarnings.push(`Telegram account ${account.accountId} uses a literal CLI token; shell history or process inspection may expose it.`);
-      }
       sawCredentialFlags = true;
       sawTelegramFlags = true;
       index += 1;
@@ -63535,9 +63677,12 @@ function parseBootstrapFlags(args) {
     sawCredentialFlags,
     sawSlackFlags,
     sawTelegramFlags,
-    literalWarnings
+    literalWarnings: []
   };
 }
+function hasLiteralBootstrapCredentials(flags) {
+  return flags.slackAccounts.some((account) => isLiteralToken(account.appToken) || isLiteralToken(account.botToken)) || flags.telegramAccounts.some((account) => isLiteralToken(account.botToken));
+}
 
 // src/agents/session-state.ts
 class AgentSessionState {
@@ -64393,6 +64538,12 @@ function looksLikeClaudeSnapshot(lines) {
     return trimmed.includes("Claude Code v") || trimmed.includes("Welcome back!") || trimmed.includes("Tips for getting started") || trimmed.startsWith("❯") || trimmed.startsWith("⏺");
   });
 }
+function looksLikeGeminiSnapshot(lines) {
+  return lines.some((line) => {
+    const trimmed = line.trim();
+    return trimmed.includes("Gemini CLI v") || trimmed.includes("Signed in with Google") || trimmed.includes("YOLO Ctrl+Y") || trimmed.includes("Type your message or @path/to/file") || trimmed.includes("workspace (/directory)");
+  });
+}
 function isProgressLine(line) {
   const trimmed = line.trim();
   const normalized = trimmed.replace(/^(?::eight_spoked_asterisk:|[✽✶])\s+/, "");
@@ -64491,6 +64642,9 @@ function dropClaudePromptBlocks(lines) {
   }
   return filtered;
 }
+function dropGeminiPromptBlocks(lines) {
+  return dropPromptBlocks(lines, /^\s*>\s/);
+}
 function isInterruptStatusLine(line) {
   const trimmed = line.trim();
   if (!trimmed) {
@@ -64512,6 +64666,13 @@ function shouldDropClaudeChromeLine(line) {
   }
   return trimmed.includes("Claude Code v") || trimmed.includes("Welcome back!") || trimmed.includes("Tips for getting started") || trimmed.includes("Ask Claude to create a new app or clone a repository") || trimmed.includes("Recent activity") || trimmed.includes("No recent activity") || trimmed.includes("API Usage Billing") || trimmed.includes("shift+tab to cycle") || trimmed.includes("ctrl+o to expand") || trimmed.includes("ctrl+b ctrl+b") || trimmed.includes("run in background") || /^~\/\.clisbot\/(?:workspace\/)?[a-z0-9._/-]+$/i.test(trimmed) || trimmed.includes("| claude |") || /^(?:[✻*]\s*)?(?:Worked|Cooked) for \d+s$/i.test(trimmed) || trimmed.startsWith("⏵⏵") || trimmed.startsWith("❯") || isProgressLine(trimmed) || /^[A-Za-z0-9._-]+\.[A-Za-z0-9._-]+$/.test(trimmed) || /^[╭╰│]/.test(trimmed) || /^─+$/.test(trimmed) || /^[▐▛▜▌▝▘ ]+$/.test(trimmed) || /^[▐▛▜▌▝▘ ]+.+$/.test(trimmed);
 }
+function shouldDropGeminiChromeLine(line) {
+  const trimmed = line.trim();
+  if (!trimmed) {
+    return false;
+  }
+  return trimmed.includes("Gemini CLI v") || trimmed.includes("Signed in with Google") || trimmed.includes("Plan:") || /^[▝▜▄▗▟▀ ]+$/.test(trimmed) || trimmed.includes("We're making changes to Gemini CLI") || trimmed.includes("What's Changing:") || trimmed.includes("How it affects you:") || trimmed.includes("Read more: https://goo.gle/geminicli-updates") || trimmed.includes("Skipping project agents due to untrusted folder.") || trimmed.includes("Do you trust the files in this folder?") || trimmed.includes("Trusting a folder allows Gemini CLI to load its local configurations") || trimmed === "1. Trust folder (default)" || trimmed === "2. Trust parent folder (workspaces)" || trimmed === "3. Don't trust" || trimmed.includes("Tips for getting started") || /^Create GEMINI\.md files to customize your interactions$/i.test(trimmed) || /^\/help for more information$/i.test(trimmed) || /^Ask coding questions, edit code or run commands$/i.test(trimmed) || /^Be specific for the best results$/i.test(trimmed) || trimmed.includes("? for shortcuts") || trimmed.includes("YOLO Ctrl+Y") || trimmed.includes("Type your message or @path/to/file") || trimmed.includes("workspace (/directory)") || /^~\/.+\s+\S+\s+no sandbox\s+\S+/i.test(trimmed) || /^Thinking\.\.\. \(esc to cancel,\s*\d+s\)$/i.test(trimmed) || /^[╭╰│]/.test(trimmed) || /^[-▀▄]{10,}$/.test(trimmed) || /^─+$/.test(trimmed);
+}
 function normalizeBoundaryLine(line) {
   return line.trim().replace(/^(?::eight_spoked_asterisk:|[-*•◦·✽✶])\s+/, "");
 }
@@ -64548,7 +64709,8 @@ function cleanInteractionSnapshot(raw) {
   const lines = splitNormalizedLines(raw);
   const isCodex = looksLikeCodexSnapshot(lines);
   const isClaude = looksLikeClaudeSnapshot(lines);
-  const promptStripped = isCodex ? dropCodexPromptBlocks(lines) : isClaude ? dropClaudePromptBlocks(lines) : lines;
+  const isGemini = looksLikeGeminiSnapshot(lines);
+  const promptStripped = isCodex ? dropCodexPromptBlocks(lines) : isClaude ? dropClaudePromptBlocks(lines) : isGemini ? dropGeminiPromptBlocks(lines) : lines;
   const filtered = promptStripped.filter((line) => {
     if (shouldDropDeliveryReportLine(line)) {
       return false;
@@ -64559,9 +64721,12 @@ function cleanInteractionSnapshot(raw) {
     if (isClaude && shouldDropClaudeChromeLine(line)) {
       return false;
     }
+    if (isGemini && shouldDropGeminiChromeLine(line)) {
+      return false;
+    }
     return true;
   });
-  const normalized = isCodex ? unwrapCodexMessageBlocks(filtered) : isClaude ? unwrapClaudeMessageBlocks(filtered) : filtered;
+  const normalized = isCodex ? unwrapCodexMessageBlocks(filtered) : isClaude ? unwrapClaudeMessageBlocks(filtered) : isGemini ? filtered.map((line) => line.replace(/^\s*>\s*/, "")) : filtered;
   const unwrapped = unwrapSoftWrappedLines(normalized);
   return collapseAdjacentDuplicateLines(collapseBlankLines(trimBlankLines(unwrapped)).join(`
 `));
@@ -64747,6 +64912,7 @@ function extractFinalAnswer(raw) {
   const rawLines = splitNormalizedLines(raw);
   const isCodex = looksLikeCodexSnapshot(rawLines);
   const isClaude = looksLikeClaudeSnapshot(rawLines);
+  const isGemini = looksLikeGeminiSnapshot(rawLines);
   const cleaned = cleanInteractionSnapshot(raw);
   if (!cleaned) {
     return "";
@@ -64773,14 +64939,14 @@ function extractFinalAnswer(raw) {
   if (answerBlocks.length > 1 && answerBlocks.every(isShortAtomicAnswerBlock)) {
     const lastAnswer = answerBlocks.at(-1)?.trim() ?? "";
     if (lastAnswer) {
-      return isCodex || isClaude ? stripSingleLineAssistantEnvelope(lastAnswer) : lastAnswer;
+      return isCodex || isClaude || isGemini ? stripSingleLineAssistantEnvelope(lastAnswer) : lastAnswer;
     }
   }
   const answer = answerBlocks.join(`
 
 `).trim();
   const extracted = answer || cleaned;
-  if (isCodex || isClaude) {
+  if (isCodex || isClaude || isGemini) {
     return stripSingleLineAssistantEnvelope(extracted);
   }
   return extracted;
@@ -64899,14 +65065,23 @@ function logLatencyDebug(stage, context = {}, details = {}) {
 // src/runners/tmux/session-handshake.ts
 var TRUST_PROMPT_POLL_INTERVAL_MS = 250;
 var TRUST_PROMPT_MAX_WAIT_MS = 1e4;
-var TRUST_PROMPT_SETTLE_DELAY_MS = 1500;
 var SESSION_BOOTSTRAP_POLL_INTERVAL_MS = 100;
+var PASTE_SETTLE_POLL_INTERVAL_MS = 40;
+var PASTE_SETTLE_QUIET_WINDOW_MS = 60;
+var PASTE_SETTLE_MULTILINE_MAX_WAIT_MS = 800;
+var PASTE_SETTLE_SINGLE_LINE_MAX_WAIT_MS = 80;
 var SUBMIT_CONFIRM_POLL_INTERVAL_MS = 40;
 var SUBMIT_CONFIRM_MAX_WAIT_MS = 160;
 async function submitTmuxSessionInput(params) {
+  const prePasteState = await params.tmux.getPaneState(params.sessionName);
   await params.tmux.sendLiteral(params.sessionName, params.text);
-  await sleep(params.promptSubmitDelayMs);
-  const preSubmitState = await params.tmux.getPaneState(params.sessionName);
+  const preSubmitState = await waitForPanePasteSettlement({
+    tmux: params.tmux,
+    sessionName: params.sessionName,
+    baseline: prePasteState,
+    text: params.text,
+    minDelayMs: params.promptSubmitDelayMs
+  });
   await params.tmux.sendKey(params.sessionName, "Enter");
   if (await waitForPaneSubmitConfirmation({
     tmux: params.tmux,
@@ -64932,7 +65107,6 @@ async function submitTmuxSessionInput(params) {
   throw new Error("tmux submit was not confirmed after Enter. The pane state did not change, so clisbot did not treat the prompt as truthfully submitted.");
 }
 async function captureTmuxSessionIdentity(params) {
-  let deadline = Date.now() + params.timeoutMs;
   await submitTmuxSessionInput({
     tmux: params.tmux,
     sessionName: params.sessionName,
@@ -64940,11 +65114,16 @@ async function captureTmuxSessionIdentity(params) {
     promptSubmitDelayMs: params.promptSubmitDelayMs,
     timingContext: undefined
   });
+  let deadline = Date.now() + params.timeoutMs;
   while (Date.now() < deadline) {
     await sleep(params.pollIntervalMs);
     const snapshot = normalizePaneText(await params.tmux.capturePane(params.sessionName, params.captureLines));
     if (hasTrustPrompt(snapshot)) {
-      await dismissTrustPrompt(params.tmux, params.sessionName);
+      await dismissTrustPrompt({
+        tmux: params.tmux,
+        sessionName: params.sessionName,
+        captureLines: params.captureLines
+      });
       deadline = Date.now() + params.timeoutMs;
       await submitTmuxSessionInput({
         tmux: params.tmux,
@@ -64973,11 +65152,21 @@ async function dismissTmuxTrustPromptIfPresent(params) {
     if (!hasTrustPrompt(snapshot)) {
       return;
     }
-    await dismissTrustPrompt(params.tmux, params.sessionName);
+    await dismissTrustPrompt({
+      tmux: params.tmux,
+      sessionName: params.sessionName,
+      captureLines: params.captureLines
+    });
   }
 }
 async function waitForTmuxSessionBootstrap(params) {
   const deadline = Date.now() + Math.max(params.startupDelayMs, SESSION_BOOTSTRAP_POLL_INTERVAL_MS);
+  const readyRegex = params.readyPattern ? new RegExp(params.readyPattern, "i") : null;
+  const blockerPatterns = (params.blockers ?? []).map((entry) => ({
+    regex: new RegExp(entry.pattern, "i"),
+    message: entry.message
+  }));
+  let lastSnapshot = "";
   while (Date.now() <= deadline) {
     let snapshot = "";
     try {
@@ -64985,23 +65174,60 @@ async function waitForTmuxSessionBootstrap(params) {
     } catch (error) {
       const message = error instanceof Error ? error.message : String(error);
       if (message.includes("can't find session:") || message.includes("no server running on ")) {
-        return "";
+        return {
+          status: "timeout",
+          snapshot: lastSnapshot
+        };
       }
       throw error;
     }
     if (snapshot) {
-      return snapshot;
+      lastSnapshot = snapshot;
+      if (params.trustWorkspace && hasTrustPrompt(snapshot)) {
+        await dismissTrustPrompt({
+          tmux: params.tmux,
+          sessionName: params.sessionName,
+          captureLines: params.captureLines
+        });
+        await sleep(SESSION_BOOTSTRAP_POLL_INTERVAL_MS);
+        continue;
+      }
+      for (const blocker of blockerPatterns) {
+        if (blocker.regex.test(snapshot)) {
+          return {
+            status: "blocked",
+            snapshot,
+            message: blocker.message
+          };
+        }
+      }
+      if (readyRegex && !readyRegex.test(snapshot)) {
+        await sleep(SESSION_BOOTSTRAP_POLL_INTERVAL_MS);
+        continue;
+      }
+      return {
+        status: "ready",
+        snapshot
+      };
     }
     await sleep(SESSION_BOOTSTRAP_POLL_INTERVAL_MS);
   }
-  return "";
-}
-function hasTrustPrompt(snapshot) {
-  return snapshot.includes("Do you trust the contents of this directory?") || snapshot.includes("Press enter to continue");
+  return {
+    status: "timeout",
+    snapshot: lastSnapshot
+  };
 }
-async function dismissTrustPrompt(tmux, sessionName) {
-  await tmux.sendKey(sessionName, "Enter");
-  await sleep(TRUST_PROMPT_SETTLE_DELAY_MS);
+async function dismissTrustPrompt(params) {
+  await params.tmux.sendKey(params.sessionName, "Enter");
+  const deadline = Date.now() + TRUST_PROMPT_MAX_WAIT_MS;
+  while (Date.now() <= deadline) {
+    await sleep(TRUST_PROMPT_POLL_INTERVAL_MS);
+    const snapshot = normalizePaneText(await params.tmux.capturePane(params.sessionName, params.captureLines));
+    if (!snapshot || hasTrustPrompt(snapshot)) {
+      continue;
+    }
+    return;
+  }
 }
 async function waitForPaneSubmitConfirmation(params) {
   const deadline = Date.now() + SUBMIT_CONFIRM_MAX_WAIT_MS;
@@ -65017,9 +65243,50 @@ async function waitForPaneSubmitConfirmation(params) {
     await sleep(Math.min(SUBMIT_CONFIRM_POLL_INTERVAL_MS, remainingMs));
   }
 }
+async function waitForPanePasteSettlement(params) {
+  await sleep(params.minDelayMs);
+  let currentState = await params.tmux.getPaneState(params.sessionName);
+  let sawChange = hasPaneStateChanged(params.baseline, currentState);
+  let lastChangeAt = Date.now();
+  const deadline = Date.now() + (shouldWaitForVisiblePaste(params.text) ? PASTE_SETTLE_MULTILINE_MAX_WAIT_MS : PASTE_SETTLE_SINGLE_LINE_MAX_WAIT_MS);
+  while (true) {
+    if (sawChange && Date.now() - lastChangeAt >= PASTE_SETTLE_QUIET_WINDOW_MS) {
+      return currentState;
+    }
+    const remainingMs = deadline - Date.now();
+    if (remainingMs <= 0) {
+      return currentState;
+    }
+    await sleep(Math.min(PASTE_SETTLE_POLL_INTERVAL_MS, remainingMs));
+    const nextState = await params.tmux.getPaneState(params.sessionName);
+    if (!arePaneStatesEqual(currentState, nextState)) {
+      currentState = nextState;
+      if (hasPaneStateChanged(params.baseline, currentState)) {
+        sawChange = true;
+      }
+      lastChangeAt = Date.now();
+    }
+  }
+}
 function hasPaneStateChanged(left, right) {
   return left.cursorX !== right.cursorX || left.cursorY !== right.cursorY || left.historySize !== right.historySize;
 }
+function arePaneStatesEqual(left, right) {
+  return left.cursorX === right.cursorX && left.cursorY === right.cursorY && left.historySize === right.historySize;
+}
+function looksLikeClaudeTrustPrompt(snapshot) {
+  return snapshot.includes("Quick safety check:") && snapshot.includes("Yes, I trust this folder") || snapshot.includes("Enter to confirm · Esc to cancel");
+}
+function looksLikeGeminiTrustPrompt(snapshot) {
+  return snapshot.includes("Skipping project agents due to untrusted folder.") && snapshot.includes("Do you trust the files in this folder?") || snapshot.includes("Trusting a folder allows Gemini CLI to load its local configurations") && snapshot.includes("Trust folder (default)");
+}
+function hasTrustPrompt(snapshot) {
+  return snapshot.includes("Do you trust the contents of this directory?") || snapshot.includes("Press enter to continue") || looksLikeClaudeTrustPrompt(snapshot) || looksLikeGeminiTrustPrompt(snapshot);
+}
+function shouldWaitForVisiblePaste(text) {
+  return text.includes(`
+`);
+}
 
 // src/runners/tmux/shell-command.ts
 var BASH_WINDOW_NAME = "bash";
@@ -65147,6 +65414,11 @@ function buildRunnerLaunchCommand(command, args) {
   ];
   return `${exports.join("; ")}; exec ${buildCommandString(command, args)}`;
 }
+function summarizeSnapshot(snapshot) {
+  const compact = snapshot.split(`
+`).map((line) => line.trim()).filter(Boolean).join(" ").slice(0, 220);
+  return compact ? ` Last visible pane: ${compact}` : "";
+}
 function isTmuxDuplicateSessionError(error) {
   const message = error instanceof Error ? error.message : String(error);
   return TMUX_DUPLICATE_SESSION_PATTERN.test(message);
@@ -65239,6 +65511,10 @@ class RunnerSessionService {
       allowFreshRetry: options.nextAllowFreshRetry
     });
   }
+  async abortUnreadySession(resolved, reason, snapshot) {
+    await this.tmux.killSession(resolved.sessionName);
+    throw new Error(`${reason}${summarizeSnapshot(snapshot)}`);
+  }
   async runSessionCleanup() {
     if (this.cleanupInFlight) {
       return;
@@ -65328,11 +65604,14 @@ class RunnerSessionService {
       resumingExistingSession,
       hasStoredSessionId: Boolean(existing?.sessionId)
     });
-    await waitForTmuxSessionBootstrap({
+    const bootstrapResult = await waitForTmuxSessionBootstrap({
       tmux: this.tmux,
       sessionName: resolved.sessionName,
       captureLines: resolved.stream.captureLines,
-      startupDelayMs: resolved.runner.startupDelayMs
+      startupDelayMs: resolved.runner.startupDelayMs,
+      trustWorkspace: resolved.runner.trustWorkspace,
+      readyPattern: resolved.runner.startupReadyPattern,
+      blockers: resolved.runner.startupBlockers
     });
     const sessionStillExists = await this.tmux.hasSession(resolved.sessionName);
     if (!sessionStillExists) {
@@ -65347,6 +65626,12 @@ class RunnerSessionService {
       }
       throw new Error(`Runner session "${resolved.sessionName}" disappeared during startup.`);
     }
+    if (bootstrapResult.status === "blocked") {
+      await this.abortUnreadySession(resolved, bootstrapResult.message, bootstrapResult.snapshot);
+    }
+    if (bootstrapResult.status === "timeout" && resolved.runner.startupReadyPattern) {
+      await this.abortUnreadySession(resolved, `Runner session "${resolved.sessionName}" did not reach the configured ready state within ${resolved.runner.startupDelayMs}ms.`, bootstrapResult.snapshot);
+    }
     try {
       await this.finalizeSessionStartup(target, resolved, {
         startupSessionId,
@@ -65710,6 +65995,7 @@ class ActiveRunManager {
   runnerSessions;
   resolveTarget;
   activeRuns = new Map;
+  stopping = false;
   constructor(tmux, sessionState, runnerSessions, resolveTarget) {
     this.tmux = tmux;
     this.sessionState = sessionState;
@@ -65759,6 +66045,9 @@ class ActiveRunManager {
     }
   }
   async executePrompt(target, prompt, observer, options = {}) {
+    if (this.stopping) {
+      throw new Error("Runtime is stopping and cannot accept a new prompt.");
+    }
     const existingActiveRun = this.activeRuns.get(target.sessionKey);
     if (existingActiveRun) {
       throw new ActiveRunInProgressError(existingActiveRun.latestUpdate);
@@ -65804,6 +66093,9 @@ class ActiveRunManager {
       const startedAt = Date.now();
       const run = this.activeRuns.get(provisionalResolved.sessionKey);
       if (!run) {
+        if (this.stopping) {
+          throw new Error("Runtime stopped before the active run finished startup.");
+        }
         throw new Error(`Active run disappeared during startup for ${provisionalResolved.sessionKey}.`);
       }
       run.resolved = resolved;
@@ -65880,6 +66172,16 @@ class ActiveRunManager {
   hasActiveRun(target) {
     return this.activeRuns.has(target.sessionKey);
   }
+  async stop() {
+    this.stopping = true;
+    const activeRuns = [...this.activeRuns.values()];
+    for (const run of activeRuns) {
+      await this.sessionState.setSessionRuntime(run.resolved, {
+        state: "idle"
+      });
+    }
+    this.activeRuns.clear();
+  }
   buildDetachedNote(resolved) {
     return `This session has been running for over ${resolved.stream.maxRuntimeLabel}. clisbot will keep monitoring it and will post the final result here when it completes. Use \`/attach\` to resume live updates, \`/watch every 30s\` for interval updates, or \`/stop\` to interrupt it.`;
   }
@@ -66060,6 +66362,7 @@ class AgentService {
   sessionState;
   runnerSessions;
   activeRuns;
+  stopping = false;
   cleanupTimer;
   loopTimers = new Set;
   intervalLoops = new Map;
@@ -66095,6 +66398,7 @@ class AgentService {
     }, cleanup.intervalMinutes * 60000);
   }
   async stop() {
+    this.stopping = true;
     if (this.cleanupTimer) {
       clearInterval(this.cleanupTimer);
       this.cleanupTimer = undefined;
@@ -66109,6 +66413,7 @@ class AgentService {
       clearTimeout(timer);
     }
     this.loopTimers.clear();
+    await this.activeRuns.stop();
   }
   async cleanupStaleSessions() {
     await this.runnerSessions.runSessionCleanup();
@@ -66420,6 +66725,9 @@ class AgentService {
       }
     });
     result.catch((error) => {
+      if (this.shouldSuppressLoopShutdownError(error)) {
+        return;
+      }
       console.error("loop execution failed", error);
     });
     if (attemptedRuns >= managed.loop.maxRuns) {
@@ -66445,6 +66753,9 @@ class AgentService {
       }
       current.timer = undefined;
       this.runIntervalLoopIteration(loopId).catch((error) => {
+        if (this.shouldSuppressLoopShutdownError(error)) {
+          return;
+        }
         console.error("loop execution failed", error);
       });
     }, delayMs);
@@ -66459,6 +66770,13 @@ class AgentService {
     managed.loop = nextLoopState;
     return true;
   }
+  shouldSuppressLoopShutdownError(error) {
+    if (!this.stopping) {
+      return false;
+    }
+    const message = error instanceof Error ? error.message : String(error);
+    return /Runtime stopped before the active run finished startup|Runtime is stopping and cannot accept a new prompt/i.test(message);
+  }
   computeNextManagedLoopRunAtMs(loop, nowMs) {
     if (loop.kind === "calendar") {
       return computeNextCalendarLoopRunAtMs({
@@ -67155,12 +67473,14 @@ function buildChannelObserverId(identity) {
 }
 function buildSteeringMessage(text) {
   return [
+    "<system>",
+    "A new user message arrived while you were still working.",
+    "Adjust your current work if needed and continue.",
+    "</system>",
     "",
-    "[clisbot steering message]",
-    "A new user message arrived while you were already processing the current run.",
-    "Adjust the current work if needed and continue.",
-    "",
-    text
+    "<user>",
+    text,
+    "</user>"
   ].join(`
 `);
 }
@@ -68009,14 +68329,14 @@ function renderAgentPromptInstruction(params) {
     `[${renderPromptTimestamp()}] ${renderIdentitySummary(params.identity)}`,
     "",
     "You are operating inside clisbot.",
-    messageToolMode ? "channel auto-delivery is disabled for this conversation; send user-facing progress updates and the final response yourself with the reply command" : "channel auto-delivery remains enabled for this conversation; do not send user-facing progress updates or the final response with clisbot message send"
+    messageToolMode ? "To send a user-visible progress update or final reply, use the following CLI command:" : "channel auto-delivery remains enabled for this conversation; do not send user-facing progress updates or the final response with clisbot message send"
   ];
   if (messageToolMode) {
     const replyCommand = buildReplyCommand({
       command: getClisbotPromptCommand(),
       identity: params.identity
     });
-    lines.push("Use the exact command below when you need to send progress updates, media attachments, or the final response back to the user.", "reply command:", replyCommand, `progress updates: at most ${params.config.maxProgressMessages}`, params.config.requireFinalResponse ? "final response: send exactly 1 final user-facing response" : "final response: optional", "keep progress updates short and meaningful", "do not send progress updates for trivial internal steps");
+    lines.push(replyCommand, "When replying to the user:", "- put the user-facing message inside the --message body of that command", "- use that command to send progress updates and the final reply back to the conversation", `- send at most ${params.config.maxProgressMessages} progress updates`, params.config.requireFinalResponse ? "- send exactly 1 final user-facing response" : "- final response is optional", "- keep progress updates short and meaningful", "- do not send progress updates for trivial internal steps");
   }
   return lines.join(`
 `);
@@ -69238,6 +69558,7 @@ class SlackSocketService {
       timestamp: messageTs
     };
     let responseChunks = [];
+    const cliTool = getAgentEntry(this.loadedConfig, params.route.agentId)?.cliTool;
     const agentPromptText = buildAgentPromptText({
       text,
       identity: {
@@ -69248,6 +69569,7 @@ class SlackSocketService {
         threadTs
       },
       config: this.loadedConfig.raw.channels.slack.agentPrompt,
+      cliTool,
       responseMode: params.route.responseMode
     });
     const timingContext = {
@@ -69295,6 +69617,7 @@ class SlackSocketService {
             threadTs
           },
           config: this.loadedConfig.raw.channels.slack.agentPrompt,
+          cliTool,
           responseMode: params.route.responseMode
         }),
         route: params.route,
@@ -70644,10 +70967,12 @@ class TelegramPollingService {
         chatName: message.chat.title?.trim() || undefined,
         topicId: routeInfo.topicId != null ? String(routeInfo.topicId) : undefined
       };
+      const cliTool = getAgentEntry(this.loadedConfig, routeInfo.route.agentId)?.cliTool;
       const agentPromptText = buildAgentPromptText({
         text,
         identity,
         config: this.loadedConfig.raw.channels.telegram.agentPrompt,
+        cliTool,
         responseMode: routeInfo.route.responseMode
       });
       const timingContext = {
@@ -70680,6 +71005,7 @@ class TelegramPollingService {
               text: nextText,
               identity,
               config: this.loadedConfig.raw.channels.telegram.agentPrompt,
+              cliTool,
               responseMode: routeInfo.route.responseMode
             }),
             route: routeInfo.route,
@@ -71711,7 +72037,7 @@ async function getRuntimeOperatorSummary(params) {
   const agentSummaries = loadedConfig.raw.agents.list.map((entry) => {
     const resolved = new AgentService(loadedConfig).getResolvedAgentConfig(entry.id);
     const tool = deriveAgentTool(loadedConfig, entry.id);
-    const bootstrapState = getBootstrapWorkspaceState(resolved.workspacePath, entry.bootstrap?.mode, tool.cliTool === "codex" || tool.cliTool === "claude" ? tool.cliTool : undefined);
+    const bootstrapState = getBootstrapWorkspaceState(resolved.workspacePath, entry.bootstrap?.mode, tool.cliTool === "codex" || tool.cliTool === "claude" || tool.cliTool === "gemini" ? tool.cliTool : undefined);
     return {
       id: entry.id,
       cliTool: tool.cliTool,
@@ -72048,6 +72374,9 @@ function printCommandOutcomeBanner(outcome) {
   console.log("+---------+");
   console.log("");
 }
+function printCommandOutcomeFooter(outcome) {
+  printCommandOutcomeBanner(outcome);
+}
 function getPrimaryWorkspacePath(summary) {
   const preferredAgentId = summary.channelSummaries.find((channel) => channel.enabled)?.defaultAgentId ?? "default";
   return summary.agentSummaries.find((agent) => agent.id === preferredAgentId)?.workspacePath ?? summary.agentSummaries[0]?.workspacePath;
@@ -72068,13 +72397,18 @@ function printMissingBootstrapOptions(commandName) {
   console.log(`  clisbot ${commandName} --cli codex --bot-type team`);
   console.log(`  clisbot ${commandName} --cli claude --bot-type personal`);
   console.log(`  clisbot ${commandName} --cli claude --bot-type team`);
+  console.log(`  clisbot ${commandName} --cli gemini --bot-type personal`);
+  console.log(`  clisbot ${commandName} --cli gemini --bot-type team`);
   console.log("Manual setup is still available with `clisbot agents add ...`.");
   for (const line of renderOperatorHelpLines()) {
     console.log(line);
   }
+  if (commandName === "start") {
+    printCommandOutcomeFooter("failure");
+  }
 }
 function hasLiteralMemCredentials(flags) {
-  return flags.literalWarnings.length > 0;
+  return hasLiteralBootstrapCredentials(flags);
 }
 async function prepareBootstrapState(rawArgs, commandName, options = {
   runtimeRunning: false
@@ -72090,6 +72424,9 @@ async function prepareBootstrapState(rawArgs, commandName, options = {
     for (const line of renderMissingTokenWarningLines()) {
       console.log(line);
     }
+    if (commandName === "start") {
+      printCommandOutcomeFooter("failure");
+    }
     return null;
   }
   if (commandName === "init" && hasLiteralMemCredentials(bootstrapFlags) && !bootstrapFlags.persist) {
@@ -72151,6 +72488,7 @@ async function ensureDefaultAgentBootstrap(state, options, commandName) {
       for (const line of renderOperatorHelpLines()) {
         console.log(line);
       }
+      printCommandOutcomeFooter("failure");
       return false;
     }
   }
@@ -72224,11 +72562,14 @@ async function serveForeground() {
 async function start(args = []) {
   const runtimeStatus = await getRuntimeStatus();
   const bootstrapFlags = parseBootstrapFlags(args);
-  if (runtimeStatus.running && hasLiteralMemCredentials(bootstrapFlags) && !bootstrapFlags.persist) {
-    throw new Error("Raw channel token input on `clisbot start` requires the runtime to be stopped first, unless you also pass --persist.");
+  const restartForLiteralBootstrap = runtimeStatus.running && hasLiteralMemCredentials(bootstrapFlags);
+  if (restartForLiteralBootstrap) {
+    await stopDetachedRuntime({
+      configPath: runtimeStatus.configPath
+    });
   }
   const state = await prepareBootstrapState(args, "start", {
-    runtimeRunning: runtimeStatus.running,
+    runtimeRunning: restartForLiteralBootstrap ? false : runtimeStatus.running,
     bootstrapFlags
   });
   if (!state) {
@@ -72244,13 +72585,14 @@ async function start(args = []) {
   for (const line of renderConfiguredChannelTokenStatusLines(state.config, runtimeMemEnv)) {
     console.log(line);
   }
-  if (!runtimeStatus.running) {
+  if (restartForLiteralBootstrap || !runtimeStatus.running) {
     const tokenIssueLines = renderConfiguredChannelTokenIssueLines(state.config, runtimeMemEnv);
     for (const line of tokenIssueLines) {
       console.log(line);
     }
     if (tokenIssueLines.length > 0) {
       printCommandOutcomeBanner("failure");
+      printCommandOutcomeFooter("failure");
       return;
     }
   }
@@ -72266,7 +72608,7 @@ async function start(args = []) {
   const result = await startDetachedRuntime({
     scriptPath: fileURLToPath4(import.meta.url),
     configPath: state.configResult.configPath,
-    extraEnv: runtimeStatus.running ? undefined : runtimeMemEnv,
+    extraEnv: restartForLiteralBootstrap || !runtimeStatus.running ? runtimeMemEnv : undefined,
     runtimeCredentialsPath: getDefaultRuntimeCredentialsPath()
   });
   if (result.alreadyRunning) {
@@ -72284,6 +72626,7 @@ async function start(args = []) {
       console.log(`config: ${result.configPath}`);
       console.log(`log: ${result.logPath}`);
       console.log(renderStartSummary(summary));
+      printCommandOutcomeFooter("success");
     } catch (error) {
       printCommandOutcomeBanner("success");
       console.log(`clisbot is already running with pid: ${result.pid}`);
@@ -72294,6 +72637,7 @@ async function start(args = []) {
       for (const line of renderRuntimeErrorLines("failed to render already-running summary", error)) {
         console.error(line);
       }
+      printCommandOutcomeFooter("success");
     }
     return;
   }
@@ -72314,6 +72658,7 @@ async function start(args = []) {
     console.log(`config: ${result.configPath}`);
     console.log(`log: ${result.logPath}`);
     console.log(renderStartSummary(summary));
+    printCommandOutcomeFooter("success");
   } catch (error) {
     printCommandOutcomeBanner("success");
     console.log(`clisbot started with pid: ${result.pid}`);
@@ -72322,6 +72667,7 @@ async function start(args = []) {
     for (const line of renderRuntimeErrorLines("failed to render start summary", error)) {
       console.error(line);
     }
+    printCommandOutcomeFooter("success");
   }
 }
 async function printCliError(error) {
@@ -72363,15 +72709,18 @@ async function stop(hard = false) {
   if (!result.stopped && !hard) {
     printCommandOutcomeBanner("failure");
     console.log("clisbot is not running");
+    printCommandOutcomeFooter("failure");
     return;
   }
   if (hard) {
     printCommandOutcomeBanner("success");
     console.log(result.stopped ? "clisbot stopped and tmux sessions cleaned up" : "clisbot was not running, but tmux sessions were cleaned up");
+    printCommandOutcomeFooter("success");
     return;
   }
   printCommandOutcomeBanner("success");
   console.log("clisbot stopped");
+  printCommandOutcomeFooter("success");
 }
 async function restart() {
   await stopDetachedRuntime({