clisbot 0.1.45-beta.1 → 0.1.45-beta.3

package/dist/main.js

@@ -59315,6 +59315,7 @@ var DEFAULT_AGENT_TOOL_TEMPLATES = {
     startupDelayMs: 3000,
     startupRetryCount: 2,
     startupRetryDelayMs: 1000,
+    startupReadyPattern: "(?:^|\\s)›\\s",
     promptSubmitDelayMs: 150,
     sessionId: {
       create: {
@@ -60711,6 +60712,7 @@ function getRuntimeMonitorRestartPlan(restartBackoff, restartNumber) {
 
 // src/config/schema.ts
 var defaultSessionIdPattern = "\\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 codexStartupReadyPattern = "(?:^|\\s)›\\s";
 var runnerSessionIdCreateSchema = exports_external.object({
   mode: exports_external.enum(["runner", "explicit"]).default("runner"),
   args: exports_external.array(exports_external.string()).default([])
@@ -61285,6 +61287,7 @@ var agentsDefaultsSchema = exports_external.object({
         "-C",
         "{workspace}"
       ],
+      startupReadyPattern: codexStartupReadyPattern,
       sessionId: {
         create: {
           mode: "runner",
@@ -61734,6 +61737,7 @@ var clisbotConfigSchema = exports_external.object({
             "-C",
             "{workspace}"
           ],
+          startupReadyPattern: codexStartupReadyPattern,
           sessionId: {
             create: {
               mode: "runner",
@@ -61860,6 +61864,7 @@ var clisbotConfigSchema = exports_external.object({
             "-C",
             "{workspace}"
           ],
+          startupReadyPattern: codexStartupReadyPattern,
           sessionId: {
             create: {
               mode: "runner",
@@ -62010,6 +62015,127 @@ function assertNoLegacyPrivilegeCommands(value, path = "root") {
 
 // src/config/config-upgrade.ts
 import { basename, dirname as dirname4, join as join5 } from "node:path";
+
+// src/config/persisted-config.ts
+var defaultOwnedRunnerFields = {
+  codex: ["startupReadyPattern"],
+  gemini: [
+    "startupDelayMs",
+    "startupRetryCount",
+    "startupRetryDelayMs",
+    "startupReadyPattern",
+    "startupBlockers",
+    "promptSubmitDelayMs"
+  ]
+};
+function isRecord5(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function cloneConfig(config) {
+  return structuredClone(config);
+}
+function areJsonEqual(left, right) {
+  return JSON.stringify(left) === JSON.stringify(right);
+}
+function nestedRecord(root, path) {
+  let current = root;
+  for (const segment of path) {
+    if (!isRecord5(current)) {
+      return;
+    }
+    current = current[segment];
+  }
+  return isRecord5(current) ? current : undefined;
+}
+function deleteIfEmpty(owner, key) {
+  const value = owner[key];
+  if (isRecord5(value) && Object.keys(value).length === 0) {
+    delete owner[key];
+  }
+}
+function defaultRunner(toolId) {
+  return buildRunnerFromToolTemplate(toolId, DEFAULT_AGENT_TOOL_TEMPLATES[toolId], undefined);
+}
+function pruneDefaultOwnedFields(params) {
+  const defaults = defaultRunner(params.toolId);
+  for (const field of defaultOwnedRunnerFields[params.toolId] ?? []) {
+    if (params.force || Object.hasOwn(params.target, field) && areJsonEqual(params.target[field], defaults[field])) {
+      delete params.target[field];
+    }
+  }
+}
+function pruneAgentRunnerOverride(runner, cli) {
+  const toolId = inferAgentCliToolId(typeof runner.command === "string" ? runner.command : cli) ?? cli;
+  if (!toolId) {
+    return;
+  }
+  const defaults = defaultRunner(toolId);
+  for (const field of [
+    "command",
+    "args",
+    "trustWorkspace",
+    "startupDelayMs",
+    "startupRetryCount",
+    "startupRetryDelayMs",
+    "startupReadyPattern",
+    "startupBlockers",
+    "promptSubmitDelayMs",
+    "sessionId"
+  ]) {
+    if (Object.hasOwn(runner, field) && areJsonEqual(runner[field], defaults[field])) {
+      delete runner[field];
+    }
+  }
+}
+function pruneRunnerDefaults(config, forceRunnerStartupDefaults) {
+  const runner = nestedRecord(config, ["agents", "defaults", "runner"]);
+  if (!runner) {
+    return;
+  }
+  for (const toolId of ["codex", "gemini"]) {
+    const target = runner[toolId];
+    if (isRecord5(target)) {
+      pruneDefaultOwnedFields({
+        target,
+        toolId,
+        force: forceRunnerStartupDefaults
+      });
+    }
+  }
+}
+function pruneAgentOverrides(config) {
+  const agents = nestedRecord(config, ["agents"]);
+  if (!Array.isArray(agents?.list)) {
+    return;
+  }
+  for (const agent of agents.list) {
+    if (!isRecord5(agent) || !isRecord5(agent.runner)) {
+      continue;
+    }
+    const cli = typeof agent.cli === "string" ? inferAgentCliToolId(agent.cli) ?? undefined : undefined;
+    pruneAgentRunnerOverride(agent.runner, cli);
+    deleteIfEmpty(agent, "runner");
+  }
+}
+function pruneRuntimeMonitorBackoff(config) {
+  const runtimeMonitor = nestedRecord(config, ["app", "control", "runtimeMonitor"]);
+  if (!runtimeMonitor) {
+    return;
+  }
+  const restartBackoff = runtimeMonitor?.restartBackoff;
+  if (isRecord5(restartBackoff) && areJsonEqual(normalizeRuntimeMonitorRestartBackoff(restartBackoff), getDefaultRuntimeMonitorRestartBackoff())) {
+    delete runtimeMonitor.restartBackoff;
+  }
+}
+function pruneConfigForPersistence(config, options = {}) {
+  const nextConfig = cloneConfig(config);
+  pruneRuntimeMonitorBackoff(nextConfig);
+  pruneRunnerDefaults(nextConfig, options.forceRunnerStartupDefaults === true);
+  pruneAgentOverrides(nextConfig);
+  return nextConfig;
+}
+
+// src/config/config-upgrade.ts
 function readSchemaVersion(value) {
   if (typeof value !== "object" || value === null || Array.isArray(value)) {
     return;
@@ -62062,8 +62188,11 @@ async function upgradeEditableConfigFileIfNeeded(configPath) {
     exactAdmissionMode: "explicit"
   }));
   logUpgradeStage(`applying ${CURRENT_SCHEMA_VERSION} config to ${collapseHomePath(expandedConfigPath)}`);
+  const persistedConfig = pruneConfigForPersistence(normalizedConfig, {
+    forceRunnerStartupDefaults: true
+  });
   await writeTextFile(expandedConfigPath, `${JSON.stringify({
-    ...normalizedConfig,
+    ...persistedConfig,
     meta: {
       ...normalizedConfig.meta,
       lastTouchedAt: new Date().toISOString()
@@ -62090,7 +62219,6 @@ function renderDefaultConfigTemplate(options = {}) {
   const sessionStorePath = collapseHomePath(getDefaultSessionStorePath());
   const workspaceTemplate = collapseHomePath(getDefaultWorkspaceTemplate());
   const defaultTimezone = Intl.DateTimeFormat().resolvedOptions().timeZone || "UTC";
-  const defaultRuntimeMonitorRestartBackoff2 = getDefaultRuntimeMonitorRestartBackoff();
   return JSON.stringify({
     meta: {
       schemaVersion: CURRENT_SCHEMA_VERSION,
@@ -62135,7 +62263,6 @@ function renderDefaultConfigTemplate(options = {}) {
           maxActiveLoops: 10
         },
         runtimeMonitor: {
-          restartBackoff: defaultRuntimeMonitorRestartBackoff2,
           ownerAlerts: {
             enabled: true,
             minIntervalMinutes: 30
@@ -62407,21 +62534,6 @@ function renderDefaultConfigTemplate(options = {}) {
           gemini: {
             command: "gemini",
             args: ["--approval-mode=yolo", "--sandbox=false"],
-            startupDelayMs: 15000,
-            startupRetryCount: 2,
-            startupRetryDelayMs: 1000,
-            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",
@@ -62482,7 +62594,7 @@ async function writeEditableConfig(configPath, config) {
     exactAdmissionMode: "explicit"
   }));
   const nextConfig = {
-    ...normalizedConfig,
+    ...pruneConfigForPersistence(normalizedConfig),
     meta: {
       ...normalizedConfig.meta,
       lastTouchedAt: new Date().toISOString()
@@ -63381,7 +63493,7 @@ function resolveWorkspacePath(config, agentId, customWorkspace) {
     agentId
   }));
 }
-function areJsonEqual(left, right) {
+function areJsonEqual2(left, right) {
   return JSON.stringify(left) === JSON.stringify(right);
 }
 function ensureAgentMissing(config, agentId) {
@@ -63451,8 +63563,8 @@ async function addAgentToEditableConfig(params) {
   const resolvedStartupOptions = params.startupOptions && params.startupOptions.length > 0 ? params.startupOptions : toolTemplate.startupOptions;
   const runner = buildRunnerFromToolTemplate(cliTool, toolTemplate, resolvedStartupOptions);
   const workspacePath = resolveWorkspacePath(config, params.agentId, params.workspace);
-  const defaultRunner = config.agents.defaults.runner[cliTool];
-  const runnerOverride = areJsonEqual(runner, defaultRunner) ? undefined : runner;
+  const defaultRunner2 = config.agents.defaults.runner[cliTool];
+  const runnerOverride = areJsonEqual2(runner, defaultRunner2) ? undefined : runner;
   if (params.bootstrap) {
     await applyBootstrapTemplate(workspacePath, params.bootstrap, cliTool);
   }
@@ -65912,6 +66024,19 @@ import { join as join10 } from "node:path";
 function createLoopId() {
   return randomUUID2().split("-")[0] ?? randomUUID2();
 }
+function buildStoredLoopSender(params) {
+  const providerId = params.providerId.trim();
+  if (!providerId) {
+    return;
+  }
+  const normalizedProviderId = params.platform === "slack" ? providerId.toUpperCase() : providerId;
+  return {
+    senderId: `${params.platform}:${normalizedProviderId}`,
+    providerId: normalizedProviderId,
+    displayName: params.displayName,
+    handle: params.handle
+  };
+}
 function createStoredLoopBase(params) {
   const now = Date.now();
   return {
@@ -65941,10 +66066,13 @@ function deriveLegacyLoopSender(params) {
   if (!providerId) {
     return;
   }
-  return {
-    providerId,
-    senderId: params.surfaceBinding?.platform ? `${params.surfaceBinding.platform}:${params.surfaceBinding.platform === "slack" ? providerId.toUpperCase() : providerId}` : undefined
-  };
+  if (!params.surfaceBinding?.platform) {
+    return { providerId };
+  }
+  return buildStoredLoopSender({
+    platform: params.surfaceBinding.platform,
+    providerId
+  });
 }
 function createStoredIntervalLoop(params) {
   return {
@@ -67743,7 +67871,7 @@ function collapseBlankLines(lines) {
   return collapsed;
 }
 var DURATION_STATUS_PATTERN = String.raw`(?:\d+(?:h|m|s))(?:\s+\d+(?:h|m|s)){0,2}`;
-var CODEX_WORKING_STATUS_PATTERN = new RegExp(String.raw`^(?:[•◦·]\s*)?Working(?:\s*\()?${DURATION_STATUS_PATTERN}\b.*(?:esc to interrupt|interrupt)\)?$`, "i");
+var CODEX_WORKING_STATUS_PATTERN = new RegExp(String.raw`^(?=.*\b${DURATION_STATUS_PATTERN}\b)(?=.*(?:esc\s+to\s+(?:interrupt|cancel)|interrupt|cancel|ctrl\+c))(?:[•◦·✻✽*]\s*)?Working(?:\.{3}|…)?\s*.*\)?$`, "i");
 var CODEX_INTERRUPT_FOOTER_PATTERN = new RegExp(String.raw`^(?:[•◦·]\s*)?${DURATION_STATUS_PATTERN}\s*[•◦·]?\s*esc to interrupt\)?$`, "i");
 var GEMINI_THINKING_STATUS_PATTERN = new RegExp(String.raw`^Thinking\.\.\. \(esc to cancel,\s*${DURATION_STATUS_PATTERN}\)$`, "i");
 var CLAUDE_WORKED_STATUS_PATTERN = new RegExp(String.raw`^(?:[✻✽*]\s*)?(?:Worked|Cooked) for ${DURATION_STATUS_PATTERN}$`, "i");
@@ -68134,6 +68262,41 @@ function deriveRunningInteractionText(previousSnapshot, currentSnapshot) {
 function deriveRunningInteractionSnapshot(currentSnapshot) {
   return cleanRunningInteractionSnapshot(currentSnapshot);
 }
+function getPromptMarker(lines) {
+  if (looksLikeCodexSnapshot(lines)) {
+    return /^\s*›\s/;
+  }
+  if (looksLikeClaudeSnapshot(lines)) {
+    return /^\s*❯/;
+  }
+  if (looksLikeGeminiSnapshot(lines)) {
+    return /^\s*>\s/;
+  }
+  return null;
+}
+function sliceFromLastPromptBlock(raw) {
+  const lines = splitNormalizedLines(raw);
+  const marker = getPromptMarker(lines);
+  if (!marker) {
+    return "";
+  }
+  for (let index = lines.length - 1;index >= 0; index -= 1) {
+    if (!marker.test((lines[index] ?? "").trimStart())) {
+      continue;
+    }
+    return lines.slice(index).join(`
+`);
+  }
+  return "";
+}
+function deriveLatestPromptInteractionSnapshot(currentSnapshot) {
+  const promptTail = sliceFromLastPromptBlock(currentSnapshot);
+  return promptTail ? cleanInteractionSnapshot(promptTail) : "";
+}
+function deriveLatestPromptRunningInteractionSnapshot(currentSnapshot) {
+  const promptTail = sliceFromLastPromptBlock(currentSnapshot);
+  return promptTail ? cleanRunningInteractionSnapshot(promptTail) : "";
+}
 function deriveInteractionText(initialSnapshot, currentSnapshot) {
   const previous = cleanInteractionSnapshot(initialSnapshot);
   const current = cleanInteractionSnapshot(currentSnapshot);
@@ -68407,16 +68570,20 @@ function renderErrorInteractionBody(body, footer) {
 ${footer}`;
 }
 function renderSlackRunningInteraction(body, note) {
-  const statusNote = note ? `_${note}_` : "_Working..._";
-  return body ? `${body}
+  if (note) {
+    return body ? `${body}
 
-${statusNote}` : statusNote;
+_${note}_` : `_${note}_`;
+  }
+  return body || "_Working..._";
 }
 function renderTelegramRunningInteraction(body, note) {
-  const statusNote = note || "Working...";
-  return body ? `${body}
+  if (note) {
+    return body ? `${body}
 
-${statusNote}` : statusNote;
+${note}` : note;
+  }
+  return body || "Working...";
 }
 function renderSlackInteraction(params) {
   const body = renderInteractionBody(params);
@@ -69433,7 +69600,10 @@ class RunnerService {
       });
       try {
         await clearRunnerExitRecord(this.loadedConfig.stateDir, resolved.sessionName);
-        await this.syncSessionIdentity(resolved);
+        await this.sessionState.touchSessionEntry(resolved, {
+          sessionId: existing?.sessionId,
+          runnerCommand: resolved.runner.command
+        });
       } catch (error) {
         throw await this.mapSessionError(error, resolved.sessionName, "during startup");
       }
@@ -69786,9 +69956,10 @@ async function monitorTmuxRun(params) {
     }
     const hasActiveTimer = hasActiveTimerStatus(snapshot);
     const currentRunningSnapshot = deriveRunningInteractionSnapshot(snapshot);
-    const baselineRunningSnapshot = deriveInteractionText(baselineSnapshot, snapshot) || currentRunningSnapshot;
-    const runningDelta = priorSnapshot ? deriveRunningInteractionText(priorSnapshot, snapshot) : currentRunningSnapshot;
-    const shouldReplaceRunningSnapshot = paneChanged && !runningDelta && Boolean(baselineRunningSnapshot) && baselineRunningSnapshot !== previousRunningTruth;
+    const promptRunningSnapshot = deriveLatestPromptRunningInteractionSnapshot(snapshot);
+    const baselineRunningSnapshot = promptRunningSnapshot || deriveInteractionText(baselineSnapshot, snapshot) || currentRunningSnapshot;
+    const runningDelta = promptRunningSnapshot ? "" : priorSnapshot ? deriveRunningInteractionText(priorSnapshot, snapshot) : currentRunningSnapshot;
+    const shouldReplaceRunningSnapshot = (paneChanged || Boolean(promptRunningSnapshot)) && !runningDelta && Boolean(baselineRunningSnapshot) && baselineRunningSnapshot !== previousRunningTruth;
     const nextRunningTruth = runningDelta ? previousRunningTruth ? appendInteractionText(previousRunningTruth, runningDelta) : runningDelta : shouldReplaceRunningSnapshot ? baselineRunningSnapshot : previousRunningTruth;
     const runningSnapshot = runningDelta ? nextRunningTruth : shouldReplaceRunningSnapshot ? deriveBoundedRunningRewritePreview({
       previousSnapshot: previousRunningTruth,
@@ -69822,8 +69993,9 @@ async function monitorTmuxRun(params) {
       });
     }
     if (!hasActiveTimer && (sawActivity || sawPaneChange || sawPromptSubmission) && now - lastPaneChangeAt >= params.idleTimeoutMs) {
+      const completedSnapshot = deriveLatestPromptInteractionSnapshot(previousSnapshot) || deriveInteractionText(baselineSnapshot, previousSnapshot);
       await params.onCompleted({
-        snapshot: deriveInteractionText(baselineSnapshot, previousSnapshot),
+        snapshot: completedSnapshot,
         fullSnapshot: previousSnapshot,
         initialSnapshot: baselineSnapshot
       });
@@ -71812,16 +71984,12 @@ function buildLoopSurfaceBinding(identity) {
   };
 }
 function buildLoopSender(identity) {
-  const providerId = identity.senderId?.trim();
-  if (!providerId) {
-    return;
-  }
-  return {
-    senderId: identity.platform === "slack" ? `slack:${providerId.toUpperCase()}` : `telegram:${providerId}`,
-    providerId,
+  return buildStoredLoopSender({
+    platform: identity.platform,
+    providerId: identity.senderId ?? "",
     displayName: identity.senderName,
     handle: identity.senderHandle
-  };
+  });
 }
 async function executePromptDelivery(params) {
   let responseChunks = [];
@@ -79977,16 +80145,17 @@ function renderLoopsHelp() {
     "Usage:",
     `  ${renderCliCommand("loops")}`,
     `  ${renderCliCommand("loops --help")}`,
+    `  ${renderCliCommand("loops create --help")}`,
     `  ${renderCliCommand("loops list")}`,
     `  ${renderCliCommand("loops status")}`,
     `  ${renderCliCommand("loops status --channel slack --target group:C1234567890 --thread-id 1712345678.123456")}`,
-    `  ${renderCliCommand("loops create --channel slack --target group:C1234567890 --thread-id 1712345678.123456 every day at 07:00 check CI")}`,
-    `  ${renderCliCommand("loops create --channel slack --target group:C1234567890 --thread-id 1712345678.123456 every day at 07:00 check CI --confirm")}`,
-    `  ${renderCliCommand("loops create --channel telegram --target -1001234567890 --timezone America/Los_Angeles every day at 07:00 check tickets")}`,
-    `  ${renderCliCommand("loops create --channel slack --target group:C1234567890 --new-thread every day at 07:00 check CI")}`,
-    `  ${renderCliCommand("loops --channel slack --target group:C1234567890 --thread-id 1712345678.123456 5m check CI")}`,
-    `  ${renderCliCommand("loops create --channel telegram --target -1001234567890 --topic-id 42 every weekday at 07:00 standup")}`,
-    `  ${renderCliCommand("loops --channel slack --target group:C1234567890 --thread-id 1712345678.123456 3 review backlog")}`,
+    `  ${renderCliCommand("loops create --channel slack --target group:C1234567890 --thread-id 1712345678.123456 --sender slack:U1234567890 every day at 07:00 check CI")}`,
+    `  ${renderCliCommand("loops create --channel slack --target group:C1234567890 --thread-id 1712345678.123456 --sender slack:U1234567890 every day at 07:00 check CI --confirm")}`,
+    `  ${renderCliCommand("loops create --channel telegram --target -1001234567890 --sender telegram:1276408333 --timezone America/Los_Angeles every day at 07:00 check tickets")}`,
+    `  ${renderCliCommand("loops create --channel slack --target group:C1234567890 --new-thread --sender slack:U1234567890 every day at 07:00 check CI")}`,
+    `  ${renderCliCommand("loops --channel slack --target group:C1234567890 --thread-id 1712345678.123456 --sender slack:U1234567890 5m check CI")}`,
+    `  ${renderCliCommand("loops create --channel telegram --target -1001234567890 --topic-id 42 --sender telegram:1276408333 every weekday at 07:00 standup")}`,
+    `  ${renderCliCommand("loops --channel slack --target group:C1234567890 --thread-id 1712345678.123456 --sender slack:U1234567890 3 review backlog")}`,
     `  ${renderCliCommand("loops cancel <id>")}`,
     `  ${renderCliCommand("loops cancel --all")}`,
     `  ${renderCliCommand("loops cancel --channel slack --target group:C1234567890 --thread-id 1712345678.123456 --all")}`,
@@ -80000,6 +80169,8 @@ function renderLoopsHelp() {
     "  - use `--topic-id` for a Telegram topic id",
     "  - omitting the sub-surface flag targets the parent Slack channel/group/DM or the parent Telegram chat",
     "  - `--new-thread` is Slack-only and creates a fresh thread anchor before the loop starts",
+    "  - `--sender <principal>` is required when creating loops, using `slack:<user-id>` or `telegram:<user-id>`",
+    "  - optional creator display fields: `--sender-name <name>` and `--sender-handle <handle>`",
     "  - `--timezone <iana>` is a one-off wall-clock loop override and is frozen on the created loop record",
     "  - in Telegram forum groups, omitting `--topic-id` targets the parent chat surface; sends then follow Telegram's normal no-`message_thread_id` behavior, which is the General topic when that forum has one",
     "",
@@ -80012,13 +80183,14 @@ function renderLoopsHelp() {
     "",
     "Examples:",
     `  ${renderCliCommand("loops status --channel slack --target group:C1234567890 --thread-id 1712345678.123456")}`,
-    `  ${renderCliCommand("loops --channel telegram --target -1001234567890 --topic-id 42 5m")}`,
-    `  ${renderCliCommand("loops --channel slack --target dm:U1234567890 --new-thread every day at 09:00 check inbox")}`,
+    `  ${renderCliCommand("loops --channel telegram --target -1001234567890 --topic-id 42 --sender telegram:1276408333 5m")}`,
+    `  ${renderCliCommand("loops --channel slack --target dm:U1234567890 --new-thread --sender slack:U1234567890 every day at 09:00 check inbox")}`,
     `  ${renderCliCommand("loops cancel --channel slack --target group:C1234567890 --thread-id 1712345678.123456 abc123")}`,
     "Behavior:",
     "  - `list` always renders the global persisted loop inventory",
     "  - bare `status` is global; scoped `status --channel ... --target ...` matches `/loop status` for one routed session",
     "  - `create` and bare scoped syntax reuse the same loop parser as channel `/loop`",
+    "  - CLI loop creation fails without `--sender` so scheduled prompts can preserve creator identity",
     "  - the first wall-clock loop returns `confirmation_required` and does not persist until rerun with `--confirm`",
     "  - recurring interval loops and confirmed wall-clock loops are persisted immediately and picked up by the runtime when it is running",
     "  - if runtime is stopped, recurring loops activate on the next `clisbot start`",
@@ -80030,6 +80202,39 @@ function renderLoopsHelp() {
   ].join(`
 `);
 }
+function renderLoopsCreateHelp() {
+  return [
+    renderCliCommand("loops create"),
+    "",
+    "Usage:",
+    `  ${renderCliCommand("loops create --channel <slack|telegram> --target <surface> --sender <principal> <expression>")}`,
+    `  ${renderCliCommand("loops --channel <slack|telegram> --target <surface> --sender <principal> <expression>")}`,
+    "",
+    "Required:",
+    "  - `--channel <slack|telegram>` and `--target <surface>` select the routed session",
+    "  - `--sender <principal>` records the human creator, for example `slack:U1234567890` or `telegram:1276408333`",
+    "",
+    "Optional:",
+    "  - `--sender-name <name>` stores a readable creator name for scheduled prompt context",
+    "  - `--sender-handle <handle>` stores a creator handle without `@`",
+    "  - `--thread-id <ts>` targets an existing Slack thread",
+    "  - `--topic-id <id>` targets a Telegram topic",
+    "  - `--new-thread` creates a Slack thread anchor before persisting the loop",
+    "  - `--timezone <iana>` freezes a one-off wall-clock timezone on the loop record",
+    "  - `--confirm` persists the first wall-clock loop after reviewing the confirmation output",
+    "",
+    "Examples:",
+    `  ${renderCliCommand("loops create --channel slack --target group:C1234567890 --thread-id 1712345678.123456 --sender slack:U1234567890 every day at 07:00 check CI")}`,
+    `  ${renderCliCommand("loops create --channel telegram --target -1001234567890 --topic-id 42 --sender telegram:1276408333 5m check CI")}`,
+    `  ${renderCliCommand("loops create --channel slack --target dm:U1234567890 --new-thread --sender slack:U1234567890 every day at 09:00 check inbox")}`,
+    "",
+    "Behavior:",
+    "  - create without `--sender` fails by design",
+    "  - the `--sender` platform must match `--channel`",
+    "  - recurring CLI-created loops persist creator metadata into the session store"
+  ].join(`
+`);
+}
 function renderLoopInventory(params) {
   const lines = [
     renderCliCommand(`loops ${params.commandLabel}`),
@@ -80237,6 +80442,9 @@ async function getScopedLoopCounts(params) {
 // src/control/loops-cli.ts
 var LOOP_BUSY_RETRY_MS = 250;
 var LOOP_CONFIRM_FLAG = "--confirm";
+var LOOP_SENDER_FLAG = "--sender";
+var LOOP_SENDER_NAME_FLAG = "--sender-name";
+var LOOP_SENDER_HANDLE_FLAG = "--sender-handle";
 function getEditableConfigPath8() {
   return process.env.CLISBOT_CONFIG_PATH;
 }
@@ -80422,8 +80630,29 @@ async function executeCountLoop(params) {
 function stripConfirmFlag(args) {
   return args.filter((arg) => arg !== LOOP_CONFIRM_FLAG);
 }
+function stripLoopCreatorArgs(args) {
+  const remaining = [];
+  const creatorFlags = new Set([
+    LOOP_SENDER_FLAG,
+    LOOP_SENDER_NAME_FLAG,
+    LOOP_SENDER_HANDLE_FLAG
+  ]);
+  for (let index = 0;index < args.length; index += 1) {
+    const current = args[index];
+    if (current === "--") {
+      remaining.push(...args.slice(index));
+      break;
+    }
+    if (creatorFlags.has(current)) {
+      index += 1;
+      continue;
+    }
+    remaining.push(current);
+  }
+  return remaining;
+}
 function parseCreateExpression(rawArgs, explicitCreateSubcommand) {
-  const expressionArgs = stripLoopContextArgs(stripConfirmFlag(explicitCreateSubcommand ? rawArgs.slice(1) : rawArgs));
+  const expressionArgs = stripLoopContextArgs(stripLoopCreatorArgs(stripConfirmFlag(explicitCreateSubcommand ? rawArgs.slice(1) : rawArgs)));
   const expression = expressionArgs.join(" ").trim();
   if (!expression) {
     throw new Error("Loop creation requires an interval, count, or schedule expression.");
@@ -80444,6 +80673,43 @@ function parseLoopTimezone(args) {
   }
   return parseTimezone(timezone, "--timezone");
 }
+function parseLoopCreator(args, addressing) {
+  const sender = parseOptionValue3(args, LOOP_SENDER_FLAG)?.trim();
+  if (!sender) {
+    throw new Error(`Loop creation requires ${LOOP_SENDER_FLAG} <principal>, for example ${LOOP_SENDER_FLAG} telegram:1276408333 or ${LOOP_SENDER_FLAG} slack:U1234567890.`);
+  }
+  const [platform, ...providerParts] = sender.split(":");
+  const providerId = providerParts.join(":").trim();
+  if (platform !== "slack" && platform !== "telegram" || !providerId) {
+    throw new Error(`${LOOP_SENDER_FLAG} must be a principal like telegram:<id> or slack:<user-id>.`);
+  }
+  if (addressing.channel && platform !== addressing.channel) {
+    throw new Error(`${LOOP_SENDER_FLAG} platform must match --channel ${addressing.channel}.`);
+  }
+  const creator = buildStoredLoopSender({
+    platform,
+    providerId,
+    displayName: parseOptionValue3(args, LOOP_SENDER_NAME_FLAG),
+    handle: parseOptionValue3(args, LOOP_SENDER_HANDLE_FLAG)
+  });
+  if (!creator) {
+    throw new Error(`${LOOP_SENDER_FLAG} must include a non-empty provider id.`);
+  }
+  return creator;
+}
+function quoteLoopCliValue(value) {
+  if (/^[A-Za-z0-9_@.:/-]+$/.test(value)) {
+    return value;
+  }
+  return `'${value.replace(/'/g, "'\\''")}'`;
+}
+function renderLoopCreatorArgs(creator) {
+  return [
+    `${LOOP_SENDER_FLAG} ${quoteLoopCliValue(creator.senderId ?? creator.providerId ?? "")}`,
+    creator.displayName ? `${LOOP_SENDER_NAME_FLAG} ${quoteLoopCliValue(creator.displayName)}` : undefined,
+    creator.handle ? `${LOOP_SENDER_HANDLE_FLAG} ${quoteLoopCliValue(creator.handle)}` : undefined
+  ].filter(Boolean).join(" ");
+}
 async function enforceLoopCreateLimits(state, parsed, maxRunsPerLoop, maxActiveLoops) {
   const globalLoops = await state.sessionState.listIntervalLoops();
   if (parsed.mode !== "times" && globalLoops.length >= maxActiveLoops) {
@@ -80469,6 +80735,7 @@ async function resolveLoopCreateRequest(state, rawArgs, explicitCreateSubcommand
   const expression = parseCreateExpression(rawArgs, explicitCreateSubcommand);
   const parsed = parseCreateCommand(expression);
   let addressing = parseAddressing(rawArgs);
+  const creator = parseLoopCreator(rawArgs, addressing);
   if (addressing.channel === "telegram" && addressing.threadId) {
     throw new Error("Telegram loop commands use `--topic-id`, not `--thread-id`.");
   }
@@ -80486,6 +80753,7 @@ async function resolveLoopCreateRequest(state, rawArgs, explicitCreateSubcommand
     return {
       addressing,
       context: provisionalContext,
+      creator,
       parsed,
       resolvedPrompt,
       resolvedTarget: provisionalResolvedTarget,
@@ -80516,6 +80784,7 @@ async function resolveLoopCreateRequest(state, rawArgs, explicitCreateSubcommand
     addressing,
     context,
     deliveryContext,
+    creator,
     parsed,
     resolvedPrompt,
     resolvedTarget,
@@ -80556,6 +80825,8 @@ function buildRecurringLoopPromptMetadata(request) {
     promptSummary: summarizeLoopPrompt(request.resolvedPrompt.text, request.resolvedPrompt.maintenancePrompt),
     promptSource: request.resolvedPrompt.maintenancePrompt ? "LOOP.md" : "custom",
     maintenancePrompt: request.resolvedPrompt.maintenancePrompt,
+    createdBy: request.creator.providerId,
+    sender: request.creator,
     surfaceBinding: buildLoopSurfaceBinding2(request)
   };
 }
@@ -80629,7 +80900,8 @@ function renderCalendarConfirmation(params) {
     nowMs: Date.now()
   });
   const timezoneClause = params.request.loopTimezone ? ` --timezone ${params.request.loopTimezone}` : "";
-  const retryCommand = `${renderScopedCommand("loops create", params.request.addressing)}${timezoneClause} ${params.request.expression} ${LOOP_CONFIRM_FLAG}`;
+  const senderClause = ` ${renderLoopCreatorArgs(params.request.creator)}`;
+  const retryCommand = `${renderScopedCommand("loops create", params.request.addressing)}${senderClause}${timezoneClause} ${params.request.expression} ${LOOP_CONFIRM_FLAG}`;
   return [
     "confirmation_required: first wall-clock loop",
     `proposed schedule: ${formatCalendarLoopSchedule(parsed)}`,
@@ -80742,6 +81014,10 @@ async function runLoopsCli(args) {
     console.log(renderLoopsHelp());
     return;
   }
+  if (subcommand === "create" && (hasFlag4(args, "--help") || hasFlag4(args, "-h"))) {
+    console.log(renderLoopsCreateHelp());
+    return;
+  }
   const state = await loadLoopControlState();
   const addressing = parseAddressing(args);
   if (subcommand === "list") {

package/package.json

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