@sideboard-ai/core 0.1.322 → 0.1.323

package/dist/index.cjs

@@ -8298,10 +8298,7 @@ var init_run_log = __esm({
   }
 });
 
-// src/store/schedules.ts
-function schedulesPath() {
-  return (0, import_node_path18.join)(appDataDir(), "schedules.json");
-}
+// src/store/schedule-when.ts
 function parseDurationMs(every) {
   const m = every.trim().match(DURATION_RE);
   if (!m) return null;
@@ -8310,18 +8307,72 @@ function parseDurationMs(every) {
   const unit = m[2].toLowerCase();
   return n * UNIT_MS[unit];
 }
-function defaultScheduleName(prompt) {
-  const line = prompt.trim().split(/\r?\n/, 1)[0]?.trim() ?? "";
-  if (!line) return "Untitled automation";
-  return line.length > 60 ? `${line.slice(0, 57).trimEnd()}\u2026` : line;
-}
-function resolveScheduleThreadId(raw, env = process.env) {
-  const value = raw?.trim() || "";
-  if (!value) return null;
-  if (value.toLowerCase() === "self") {
-    return env.SIDEBOARD_ORCHESTRATOR_THREAD_ID?.trim() || env.SIDEBOARD_THREAD_ID?.trim() || null;
+function dayIndex(token) {
+  const text7 = token.trim().toLowerCase();
+  if (/^[0-6]$/.test(text7)) return Number(text7);
+  return DAY_ALIASES[text7];
+}
+function normalizeWeekdays(days) {
+  const set = /* @__PURE__ */ new Set();
+  for (const day of days) {
+    if (!Number.isInteger(day) || day < 0 || day > 6) {
+      throw new Error("Days must be 0 (Sunday) through 6 (Saturday)");
+    }
+    set.add(day);
+  }
+  if (set.size === 0) throw new Error("Pick at least one day");
+  return [...set].sort((a, b) => a - b);
+}
+function parseWeeklyDays(raw) {
+  const text7 = raw.trim().toLowerCase();
+  if (!text7) throw new Error("Pick at least one day");
+  if (text7 === "daily" || text7 === "all" || text7 === "every day" || text7 === "everyday") {
+    return [0, 1, 2, 3, 4, 5, 6];
+  }
+  if (text7 === "weekdays" || text7 === "weekday") return [1, 2, 3, 4, 5];
+  if (text7 === "weekends" || text7 === "weekend") return [0, 6];
+  const days = [];
+  for (const part of text7.split(/[\s,]+/).filter(Boolean)) {
+    const range = part.split("-");
+    if (range.length === 2 && range[0] && range[1]) {
+      const start = dayIndex(range[0]);
+      const end = dayIndex(range[1]);
+      if (start === void 0 || end === void 0) {
+        throw new Error(`Unknown day: ${part} (use mon,tue, weekdays, weekends, or daily)`);
+      }
+      if (start <= end) {
+        for (let d = start; d <= end; d++) days.push(d);
+      } else {
+        for (let d = start; d <= 6; d++) days.push(d);
+        for (let d = 0; d <= end; d++) days.push(d);
+      }
+      continue;
+    }
+    const n = dayIndex(part);
+    if (n === void 0) {
+      throw new Error(`Unknown day: ${part} (use mon,tue, weekdays, weekends, or daily)`);
+    }
+    days.push(n);
   }
-  return value;
+  return normalizeWeekdays(days);
+}
+function normalizeWeeklyTime(raw) {
+  const m = raw.trim().match(TIME_RE);
+  if (!m) throw new Error(`Invalid time: ${raw} (use HH:mm, 24-hour)`);
+  return `${m[1]}:${m[2]}`;
+}
+function formatWeeklyDays(days) {
+  const key = normalizeWeekdays(days).join(",");
+  if (key === "0,1,2,3,4,5,6") return "daily";
+  if (key === "1,2,3,4,5") return "weekdays";
+  if (key === "0,6") return "weekends";
+  return normalizeWeekdays(days).map((day) => WEEKDAY_LABELS[day]).join(", ");
+}
+function weeklyCronExpr(when) {
+  const time = normalizeWeeklyTime(when.time);
+  const [hh, mm] = time.split(":");
+  const days = normalizeWeekdays(when.days);
+  return `${Number(mm)} ${Number(hh)} * * ${days.join(",")}`;
 }
 function computeNextRunAt(when, from = /* @__PURE__ */ new Date()) {
   if (when.kind === "once") {
@@ -8338,6 +8389,12 @@ function computeNextRunAt(when, from = /* @__PURE__ */ new Date()) {
     }
     return new Date(from.getTime() + ms);
   }
+  if (when.kind === "weekly") {
+    return computeNextRunAt(
+      { kind: "cron", expr: weeklyCronExpr(when), tz: when.tz },
+      from
+    );
+  }
   try {
     const job = new import_croner.Cron(when.expr, {
       timezone: when.tz?.trim() || void 0,
@@ -8356,12 +8413,14 @@ function computeNextRunAt(when, from = /* @__PURE__ */ new Date()) {
 function formatScheduleWhen(when) {
   if (when.kind === "once") return `once at ${when.at}`;
   if (when.kind === "every") return `every ${when.every}`;
+  if (when.kind === "weekly") {
+    const label = `${formatWeeklyDays(when.days)} at ${normalizeWeeklyTime(when.time)}`;
+    const tz2 = when.tz?.trim();
+    return tz2 ? `${label} (${tz2})` : label;
+  }
   const tz = when.tz?.trim();
   return tz ? `cron ${when.expr} (${tz})` : `cron ${when.expr}`;
 }
-function nowIso2(d = /* @__PURE__ */ new Date()) {
-  return d.toISOString();
-}
 function normalizeWhen(raw) {
   if (!raw || typeof raw !== "object") {
     throw new Error("Schedule is missing `when`");
@@ -8381,7 +8440,71 @@ function normalizeWhen(raw) {
       tz: typeof rec.tz === "string" && rec.tz.trim() ? rec.tz.trim() : void 0
     };
   }
-  throw new Error("Schedule `when` must be once, every, or cron");
+  if (kind === "weekly" && Array.isArray(rec.days) && typeof rec.time === "string") {
+    return {
+      kind: "weekly",
+      days: normalizeWeekdays(rec.days.map((day) => Number(day))),
+      time: normalizeWeeklyTime(rec.time),
+      tz: typeof rec.tz === "string" && rec.tz.trim() ? rec.tz.trim() : void 0
+    };
+  }
+  throw new Error("Schedule `when` must be once, every, weekly, or cron");
+}
+var import_croner, WEEKDAY_LABELS, DURATION_RE, UNIT_MS, DAY_ALIASES, TIME_RE;
+var init_schedule_when = __esm({
+  "src/store/schedule-when.ts"() {
+    "use strict";
+    import_croner = require("croner");
+    WEEKDAY_LABELS = ["Sun", "Mon", "Tue", "Wed", "Thu", "Fri", "Sat"];
+    DURATION_RE = /^(\d+)(s|m|h|d)$/i;
+    UNIT_MS = {
+      s: 1e3,
+      m: 6e4,
+      h: 36e5,
+      d: 864e5
+    };
+    DAY_ALIASES = {
+      sun: 0,
+      sunday: 0,
+      mon: 1,
+      monday: 1,
+      tue: 2,
+      tues: 2,
+      tuesday: 2,
+      wed: 3,
+      wednesday: 3,
+      thu: 4,
+      thur: 4,
+      thurs: 4,
+      thursday: 4,
+      fri: 5,
+      friday: 5,
+      sat: 6,
+      saturday: 6
+    };
+    TIME_RE = /^([01]\d|2[0-3]):([0-5]\d)(?::[0-5]\d)?$/;
+  }
+});
+
+// src/store/schedules.ts
+function schedulesPath() {
+  return (0, import_node_path18.join)(appDataDir(), "schedules.json");
+}
+function defaultScheduleName(prompt) {
+  const line = prompt.trim().split(/\r?\n/, 1)[0]?.trim() ?? "";
+  if (!line) return "Untitled automation";
+  return line.length > 60 ? `${line.slice(0, 57).trimEnd()}\u2026` : line;
+}
+function resolveScheduleThreadId(raw, env = process.env) {
+  const value = raw?.trim() || "";
+  if (!value) return null;
+  if (value.toLowerCase() === "self") {
+    return env.SIDEBOARD_ORCHESTRATOR_THREAD_ID?.trim() || env.SIDEBOARD_THREAD_ID?.trim() || null;
+  }
+  return value;
+}
+function nowIso2(d = /* @__PURE__ */ new Date()) {
+  return d.toISOString();
 }
 function normalizeOptionalBool(raw) {
   if (raw === true || raw === false) return raw;
@@ -8431,6 +8554,7 @@ function normalizeTask(raw) {
     planMode: normalizeOptionalBool(raw.planMode),
     autonomy: normalizeAutonomy2(raw.autonomy),
     attachments: normalizeAttachments(raw.attachments),
+    archiveChat: raw.archiveChat !== false,
     nextRunAt: raw.nextRunAt,
     lastRunAt: raw.lastRunAt ?? null,
     lastThreadId: raw.lastThreadId ?? null,
@@ -8482,6 +8606,7 @@ function buildTask(input, now) {
     planMode: normalizeOptionalBool(input.planMode),
     autonomy: normalizeAutonomy2(input.autonomy),
     attachments: normalizeAttachments(input.attachments),
+    archiveChat: input.archiveChat !== false,
     nextRunAt,
     lastRunAt: null,
     lastThreadId: null,
@@ -8546,6 +8671,7 @@ function updateSchedule(id, patch) {
     planMode: patch.planMode !== void 0 ? normalizeOptionalBool(patch.planMode) : prev.planMode,
     autonomy: patch.autonomy !== void 0 ? normalizeAutonomy2(patch.autonomy) : prev.autonomy,
     attachments: patch.attachments !== void 0 ? normalizeAttachments(patch.attachments) : prev.attachments,
+    archiveChat: patch.archiveChat !== void 0 ? patch.archiveChat !== false : prev.archiveChat,
     nextRunAt: whenChanged ? computeNextRunAt(when).toISOString() : prev.nextRunAt,
     lastError: whenChanged ? null : prev.lastError,
     updatedAt: nowIso2()
@@ -8582,26 +8708,20 @@ function recordScheduleRun(id, result) {
   writeAll(rows);
   return next;
 }
-var import_node_crypto8, import_node_fs15, import_node_path18, import_croner, DURATION_RE, UNIT_MS, ATTACHMENT_KINDS;
+var import_node_crypto8, import_node_fs15, import_node_path18, ATTACHMENT_KINDS;
 var init_schedules = __esm({
   "src/store/schedules.ts"() {
     "use strict";
     import_node_crypto8 = require("crypto");
     import_node_fs15 = require("fs");
     import_node_path18 = require("path");
-    import_croner = require("croner");
+    init_schedule_when();
     init_orchestrator_capable();
     init_thinking_effort();
     init_paths();
     init_private_file();
     init_app_settings();
-    DURATION_RE = /^(\d+)(s|m|h|d)$/i;
-    UNIT_MS = {
-      s: 1e3,
-      m: 6e4,
-      h: 36e5,
-      d: 864e5
-    };
+    init_schedule_when();
     ATTACHMENT_KINDS = /* @__PURE__ */ new Set([
       "transcript",
       "file",
@@ -13010,7 +13130,7 @@ var init_coordinator_prompt = __esm({
       "- get_viewer_context / update_viewer_context \u2014 read or replace Settings \u2192 Agents (account) and Settings \u2192 Projects (per-repo) context. You can update a project: pass scope=project and repoPath from list_projects (this cwd is not a project). update_viewer_context requires confirmed=true after ask_user. Never write context unprompted.",
       "- list_env / set_env / delete_env \u2014 Settings \u2192 Environment. scope=project requires repoPath from list_projects and stores the key under that project prefix (the project name, uppercased, plus _). APPLE_ID for sideboard is SIDEBOARD_APPLE_ID. scope=account is shared by every project and is not prefixed. list_env returns names only.",
       "- set_caffeinate \u2014 keep this Mac awake across turns (macOS caffeinate). Turn on for phone remote / away-from-keyboard work, overnight schedules, or when the user will be away. Turn OFF when they say they are done, wrapping up, going to sleep, or no longer need the machine awake. Closing this chat also releases it.",
-      "- list_schedules / create_schedule / update_schedule / delete_schedule / run_schedule \u2014 automations that send a prompt to a chat (chatId or self) or start a new Global chat (omit chatId). One-shot `at`, interval `every` (15m/1h/6h/1d), or 5-field `cron`. Recurring jobs without chatId open a new chat each run and archive it when that run finishes (History keeps the latest run for that automation). Worktree agents have the same tools (`chatId=self` continues that coding chat). Jobs fire only while Sideboard.app is running; sleep skips until wake. Creating or enabling a future job turns on Settings \u2192 Advanced \u2192 Caffeinate while automations are enabled (or call set_caffeinate). The desktop lists them in the sidebar after Board.",
+      "- list_schedules / create_schedule / update_schedule / delete_schedule / run_schedule \u2014 automations that send a prompt to a chat (chatId or self) or start a new Global chat (omit chatId). One-shot `at`, interval `every` (15m/1h/6h/1d), clock time `time` + `days` (07:30 and weekdays, or mon,wed), or 5-field `cron`. Recurring jobs without chatId open a new chat each run and archive it when that run finishes unless archiveChat is false (leave the chat open to keep talking). History keeps the last 5 archived runs for that automation. Worktree agents have the same tools (`chatId=self` continues that coding chat). Jobs fire only while Sideboard.app is running; sleep skips until wake. Creating or enabling a future job turns on Settings \u2192 Advanced \u2192 Caffeinate while automations are enabled (or call set_caffeinate). The desktop lists them in the sidebar after Board.",
       "Projects:",
       "- add_project / remove_project \u2014 register or unregister a git repo",
       "Workspaces and chats:",
@@ -23844,12 +23964,12 @@ function ephemeralRunReadyToArchive(thread) {
 }
 function markEphemeralAutomation(threadId, opts) {
   const id = opts.ephemeralAutomationId?.trim();
+  const title = opts.ephemeralTitle?.trim();
   const current = readThread(threadId);
   if (!current) throw new Error(`Thread not found: ${threadId}`);
-  if (!id) return current;
-  const title = opts.ephemeralTitle?.trim();
+  if (!id && !title) return current;
   return updateThread(threadId, {
-    ephemeralAutomationId: id,
+    ...id ? { ephemeralAutomationId: id } : {},
     ...title ? { title, userSetTitle: true } : {}
   });
 }
@@ -23884,11 +24004,19 @@ function clearEphemeralAutomation(threadId) {
 function forgetOlderEphemeralRuns(automationId, keepId) {
   const id = automationId.trim();
   if (!id || !keepId) return [];
+  const archived = listThreads({ includeArchived: true }).filter(
+    (thread) => thread.status === "archived" && thread.ephemeralAutomationId === id
+  );
+  const ranked = [...archived].sort((a, b) => {
+    if (a.id === keepId) return -1;
+    if (b.id === keepId) return 1;
+    return archivedUpdatedMs(b) - archivedUpdatedMs(a);
+  });
+  const keep = new Set(ranked.slice(0, EPHEMERAL_AUTOMATION_KEEP).map((thread) => thread.id));
+  keep.add(keepId);
   const removed = [];
-  for (const thread of listThreads({ includeArchived: true })) {
-    if (thread.id === keepId) continue;
-    if (thread.status !== "archived") continue;
-    if (thread.ephemeralAutomationId !== id) continue;
+  for (const thread of archived) {
+    if (keep.has(thread.id)) continue;
     try {
       deleteThreadRecord(thread.id);
       removed.push(thread.id);
@@ -23897,10 +24025,13 @@ function forgetOlderEphemeralRuns(automationId, keepId) {
   }
   return removed;
 }
+var EPHEMERAL_AUTOMATION_KEEP;
 var init_ephemeral_automation = __esm({
   "src/orchestrator/ephemeral-automation.ts"() {
     "use strict";
+    init_history_retention();
     init_thread_store();
+    EPHEMERAL_AUTOMATION_KEEP = 5;
   }
 });
 
@@ -29529,7 +29660,7 @@ function formatWorktreeDirective(thread, opts) {
   lines.push(formatDevAccessHint(opts?.activeRuns));
   lines.push("");
   lines.push(
-    "Automations (sidebar, after Board): `create_schedule` / `list_schedules` (`at` / `every` / `cron`). `chatId=self` continues this chat; omit chatId for a new Global chat. Fires only while Sideboard.app is running. A future job turns on Settings \u2192 Advanced \u2192 Caffeinate while automations are enabled."
+    "Automations (sidebar, after Board): `create_schedule` / `list_schedules` (`at` / `every` / `cron` / `time`+`days`). `archiveChat=false` keeps the new chat. `chatId=self` continues this chat; omit chatId for a new Global chat. Fires only while Sideboard.app is running. A future job turns on Settings \u2192 Advanced \u2192 Caffeinate while automations are enabled."
   );
   lines.push(
     "`set_workspace_tags` labels this checkout (omit ref; replace, add, or remove). Not another checkout."
@@ -29549,7 +29680,7 @@ function connectedOrchestratorTurnReminder(thread, find) {
   return formatConnectedOrchestratorReminder(connectedOrchestrator(thread, find));
 }
 function formatWorktreeReminder() {
-  return "Sideboard workspace: stay in this cwd for all file and git work. Push and open PRs against origin, never upstream. Do not edit the main repo checkout. If a goal is given (Greptile 5/5, CI green), watch-fix-push until it lands \u2014 do not watch after every push. Automations: create_schedule (at / every / cron; chatId=self for this chat). set_workspace_tags updates labels on this workspace (omit ref).";
+  return "Sideboard workspace: stay in this cwd for all file and git work. Push and open PRs against origin, never upstream. Do not edit the main repo checkout. If a goal is given (Greptile 5/5, CI green), watch-fix-push until it lands \u2014 do not watch after every push. Automations: create_schedule (at / every / cron, or time + days such as weekdays at 07:30; archiveChat=false leaves the new chat open; chatId=self for this chat). set_workspace_tags updates labels on this workspace (omit ref).";
 }
 function formatClaudeSubagentReminder() {
   return 'Claude subagents: if Task/Agent workers will edit files, write a short plan in this chat and continue in the same turn. Do not ask the user whether to isolate, and do not set worktree.bgIsolation to none. One writer may edit this workspace. Every other writer is an Agent with isolation "worktree" and a disjoint file list (read-only explore agents may overlap). While those agents run, leave their files alone. Merge each returned branch into this workspace, then remove the temporary worktree. You stay in this cwd. If Claude says another write-capable agent is in this directory, or that writes to the shared checkout are blocked, re-spawn that agent with isolation "worktree" or make the edit yourself. That note is another worker in this chat, or a worker Claude still has marked running. Do not mention it to the user.';
@@ -33690,6 +33821,7 @@ async function fireSchedule(id) {
       });
     }
     const pinReplacement = Boolean(schedule.threadId) && schedule.when.kind !== "once";
+    const archiveFresh = schedule.archiveChat !== false && !pinReplacement;
     const created = await deps.startOrchestration({
       goal: prompt,
       agent: pickAgent(schedule),
@@ -33699,7 +33831,8 @@ async function fireSchedule(id) {
       ...schedule.planMode != null ? { planMode: schedule.planMode } : {},
       ...schedule.autonomy ? { autonomy: schedule.autonomy } : {},
       attachments: schedule.attachments,
-      ...pinReplacement ? {} : { ephemeralAutomationId: schedule.id, ephemeralTitle: schedule.name }
+      ...archiveFresh ? { ephemeralAutomationId: schedule.id } : {},
+      ephemeralTitle: schedule.name
     });
     if (pinReplacement) {
       updateSchedule(schedule.id, { threadId: created.id });
@@ -33930,6 +34063,7 @@ __export(index_exports, {
   THINKING_EFFORTS: () => THINKING_EFFORTS,
   THINKING_PART_MAX_CHARS: () => THINKING_PART_MAX_CHARS,
   USAGE_ON_LIMIT_VALUES: () => USAGE_ON_LIMIT_VALUES,
+  WEEKDAY_LABELS: () => WEEKDAY_LABELS,
   WORKTREE_ABLETIME_MCP_TOOLS: () => WORKTREE_ABLETIME_MCP_TOOLS,
   WORKTREE_GITHUB_MCP_TOOLS: () => WORKTREE_GITHUB_MCP_TOOLS,
   WORKTREE_LINEAR_MCP_TOOLS: () => WORKTREE_LINEAR_MCP_TOOLS,
@@ -34257,6 +34391,7 @@ __export(index_exports, {
   formatUiReminder: () => formatUiReminder,
   formatViewerContextDirective: () => formatViewerContextDirective,
   formatViewerContextReminder: () => formatViewerContextReminder,
+  formatWeeklyDays: () => formatWeeklyDays,
   formatWorkspaceInventory: () => formatWorkspaceInventory,
   formatWorkspaceProfileSuffix: () => formatWorkspaceProfileSuffix,
   formatWorktreeDirective: () => formatWorktreeDirective,
@@ -34553,6 +34688,8 @@ __export(index_exports, {
   normalizeThinkingEffort: () => normalizeThinkingEffort,
   normalizeThread: () => normalizeThread,
   normalizeTurnInput: () => normalizeTurnInput,
+  normalizeWeekdays: () => normalizeWeekdays,
+  normalizeWeeklyTime: () => normalizeWeeklyTime,
   normalizeWorkspaceTags: () => normalizeWorkspaceTags,
   normalizeWorktreePath: () => normalizeWorktreePath,
   notifyOrchestrator: () => notifyOrchestrator,
@@ -34592,6 +34729,7 @@ __export(index_exports, {
   parseSessionQuotaResetAt: () => parseSessionQuotaResetAt,
   parseSlackRelayClientMessage: () => parseSlackRelayClientMessage,
   parseSlackRelayServerMessage: () => parseSlackRelayServerMessage,
+  parseWeeklyDays: () => parseWeeklyDays,
   partsToAssistantText: () => partsToAssistantText,
   pastedTextStats: () => pastedTextStats,
   patchReadAloudSettings: () => patchReadAloudSettings,
@@ -34869,6 +35007,7 @@ __export(index_exports, {
   visibleToolRowDetail: () => visibleToolRowDetail,
   waitForPidExit: () => waitForPidExit,
   warmGithubAgentAuth: () => warmGithubAgentAuth,
+  weeklyCronExpr: () => weeklyCronExpr,
   whichOnPath: () => whichOnPath,
   withAddedAccount: () => withAddedAccount,
   withEventParentId: () => withEventParentId,
@@ -44901,18 +45040,79 @@ function fail4(err) {
   );
 }
 function parseWhen(args) {
-  const count = [args.at, args.every, args.cron].filter((v) => v?.trim()).length;
-  if (count !== 1) {
-    throw new Error("Pass exactly one of at (ISO datetime), every (15m/1h/6h/1d), or cron");
+  const at = args.at?.trim();
+  const every = args.every?.trim();
+  const cron = args.cron?.trim();
+  const time = args.time?.trim();
+  const days = args.days?.trim();
+  if (days && !time && !at && !every && !cron) {
+    throw new Error("days needs time (HH:mm), for example time=07:30 days=weekdays");
+  }
+  const picked = [at, every, cron, time].filter(Boolean);
+  if (picked.length !== 1) {
+    throw new Error(
+      "Pass exactly one of at (ISO datetime), every (15m/1h/6h/1d), time (HH:mm), or cron"
+    );
+  }
+  if (at) return { kind: "once", at };
+  if (every) return { kind: "every", every };
+  if (time) {
+    return {
+      kind: "weekly",
+      time,
+      days: parseWeeklyDays(days || "daily"),
+      tz: args.tz?.trim() || void 0
+    };
   }
-  if (args.at?.trim()) return { kind: "once", at: args.at.trim() };
-  if (args.every?.trim()) return { kind: "every", every: args.every.trim() };
   return {
     kind: "cron",
-    expr: args.cron.trim(),
+    expr: cron,
     tz: args.tz?.trim() || void 0
   };
 }
+function whenFromUpdate(id, args) {
+  const at = args.at?.trim();
+  const every = args.every?.trim();
+  const cron = args.cron?.trim();
+  const time = args.time?.trim();
+  const days = args.days?.trim();
+  const tzSet = args.tz !== void 0;
+  if (!at && !every && !cron && !time && !days && !tzSet) return void 0;
+  if ((time || days) && !at && !every && !cron) {
+    const current = getSchedule(id);
+    const weekly = current?.when.kind === "weekly" ? current.when : null;
+    if (!weekly && !(time && days)) {
+      const kind = current?.when.kind ?? "missing";
+      throw new Error(
+        `time and days change a days-at-a-time automation. This job is ${kind}. Pass time and days together to switch it, or at / every / cron to replace the cadence.`
+      );
+    }
+    const clock = time || weekly?.time;
+    if (!clock) {
+      throw new Error("time (HH:mm) is required, for example time=07:30 days=weekdays");
+    }
+    const prevTz = current?.when.kind === "weekly" || current?.when.kind === "cron" ? current.when.tz : void 0;
+    return {
+      kind: "weekly",
+      time: clock,
+      days: days ? parseWeeklyDays(days) : weekly?.days ?? parseWeeklyDays("daily"),
+      tz: tzSet ? args.tz?.trim() || void 0 : prevTz
+    };
+  }
+  if (!at && !every && !cron && !time && !days && tzSet) {
+    const current = getSchedule(id);
+    if (current?.when.kind === "weekly" || current?.when.kind === "cron") {
+      return { ...current.when, tz: args.tz?.trim() || void 0 };
+    }
+    return void 0;
+  }
+  return parseWhen(args);
+}
+function createdHint(schedule) {
+  const awake = scheduleNeedsCaffeinate(schedule) ? " Caffeinate while automations are enabled is now on so the Mac can stay awake until this job is due." : "";
+  const fresh = schedule.threadId ? "" : schedule.archiveChat === false ? " This job leaves the new chat open so you can keep talking." : " A new Global chat is archived when the run finishes (History keeps the last 5 runs). Pass archiveChat=false to leave it open.";
+  return `Fires while Sideboard.app is running.${fresh}${awake}`;
+}
 function registerScheduleTools(server) {
   server.tool(
     "list_schedules",
@@ -44928,14 +45128,19 @@ function registerScheduleTools(server) {
   );
   server.tool(
     "create_schedule",
-    "Create a local automation that, when due, sends a prompt to an existing chat (chatId) or starts a new Global orchestration chat (omit chatId). Pass chatId=self to continue this chat. If that chat is missing or archived when the job fires, Sideboard starts a new Global chat (recurring jobs then continue that chat). Exactly one of at (ISO datetime), every (15m/1h/6h/1d), or cron (5-field). Recurring jobs without chatId open a new Global chat each run and archive it when that run finishes. History keeps the latest run for that automation. Creating or enabling a future job turns on Settings \u2192 Advanced \u2192 Caffeinate while automations are enabled so the Mac stays awake until due. Sideboard.app must be running for the job to fire.",
+    "Create a local automation that, when due, sends a prompt to an existing chat (chatId) or starts a new Global orchestration chat (omit chatId). Pass chatId=self to continue this chat. If that chat is missing or archived when the job fires, Sideboard starts a new Global chat (recurring jobs then continue that chat). Exactly one of at (ISO datetime), every (15m/1h/6h/1d), time (HH:mm, with days such as weekdays or mon,wed), or cron (5-field). Recurring jobs without chatId open a new Global chat each run and archive it when that run finishes unless archiveChat is false (leave the chat open to keep talking, for example a morning start-my-day run). History keeps the last 5 archived runs for that automation. Creating or enabling a future job turns on Settings \u2192 Advanced \u2192 Caffeinate while automations are enabled so the Mac stays awake until due. Sideboard.app must be running for the job to fire.",
     {
       prompt: import_zod10.z.string().describe("User message / goal queued when the automation fires"),
       name: import_zod10.z.string().optional(),
       at: import_zod10.z.string().optional().describe("ISO datetime for a one-shot"),
       every: import_zod10.z.string().optional().describe("Interval such as 15m, 1h, 6h, 1d"),
+      time: import_zod10.z.string().optional().describe("HH:mm (24-hour) clock time. Omit days for every day."),
+      days: import_zod10.z.string().optional().describe("daily, weekdays, weekends, or days such as mon,wed,fri or mon-fri. Use with time."),
       cron: import_zod10.z.string().optional().describe("5-field cron expression"),
-      tz: import_zod10.z.string().optional().describe("IANA timezone for cron (default: system)"),
+      tz: import_zod10.z.string().optional().describe("IANA timezone for cron or time (default: system)"),
+      archiveChat: import_zod10.z.boolean().optional().describe(
+        "Archive a new Global chat when the run finishes. Default true. Pass false to leave the chat open."
+      ),
       chatId: import_zod10.z.string().optional().describe(
         'Existing chat id (orchestration or workspace), or "self" for this chat. Omit to create a new Global chat on fire.'
       ),
@@ -44962,11 +45167,12 @@ function registerScheduleTools(server) {
           threadId,
           agent: args.agent,
           model: args.model,
+          archiveChat: args.archiveChat,
           createdBy: "mcp"
         });
         return text6({
           schedule,
-          hint: scheduleNeedsCaffeinate(schedule) ? "Fires while Sideboard.app is running. Recurring jobs without chatId create a new orchestration chat each run and archive it when that run finishes (History keeps the latest). Caffeinate while automations are enabled is now on so the Mac can stay awake until this job is due." : "Fires while Sideboard.app is running. Recurring jobs without chatId create a new orchestration chat each run and archive it when that run finishes (History keeps the latest)."
+          hint: createdHint(schedule)
         });
       } catch (err) {
         return fail4(err);
@@ -44975,15 +45181,18 @@ function registerScheduleTools(server) {
   );
   server.tool(
     "update_schedule",
-    "Update a local automation (prompt, cadence, target chat, enabled). Pass id from list_schedules.",
+    "Update a local automation (prompt, cadence, target chat, archiveChat, enabled). Pass id from list_schedules.",
     {
       id: import_zod10.z.string(),
       prompt: import_zod10.z.string().optional(),
       name: import_zod10.z.string().optional(),
       at: import_zod10.z.string().optional(),
       every: import_zod10.z.string().optional(),
+      time: import_zod10.z.string().optional().describe("HH:mm clock time. Use with days, or alone to change the time of a weekly job."),
+      days: import_zod10.z.string().optional().describe("daily, weekdays, weekends, or mon,wed,fri. Use with time, or alone on an existing weekly job."),
       cron: import_zod10.z.string().optional(),
       tz: import_zod10.z.string().optional(),
+      archiveChat: import_zod10.z.boolean().optional().describe("Archive a new Global chat when the run finishes. False leaves it open."),
       chatId: import_zod10.z.string().optional().describe(
         'Existing chat (orchestration or workspace), "self", or empty string to create a new Global chat each run'
       ),
@@ -44994,13 +45203,7 @@ function registerScheduleTools(server) {
     },
     async (args) => {
       try {
-        const cadenceSet = [args.at, args.every, args.cron].some((v) => v?.trim());
-        const when = cadenceSet ? parseWhen({
-          at: args.at,
-          every: args.every,
-          cron: args.cron,
-          tz: args.tz
-        }) : void 0;
+        const when = whenFromUpdate(args.id, args);
         let threadId;
         const rawChatId = args.chatId ?? args.threadId;
         if (rawChatId !== void 0) {
@@ -45020,7 +45223,8 @@ function registerScheduleTools(server) {
           threadId,
           agent: args.agent,
           enabled: args.enabled,
-          model: args.model
+          model: args.model,
+          archiveChat: args.archiveChat
         });
         return text6({ schedule });
       } catch (err) {
@@ -49393,6 +49597,7 @@ async function pollSlackOutboundWatches(opts) {
   THINKING_EFFORTS,
   THINKING_PART_MAX_CHARS,
   USAGE_ON_LIMIT_VALUES,
+  WEEKDAY_LABELS,
   WORKTREE_ABLETIME_MCP_TOOLS,
   WORKTREE_GITHUB_MCP_TOOLS,
   WORKTREE_LINEAR_MCP_TOOLS,
@@ -49720,6 +49925,7 @@ async function pollSlackOutboundWatches(opts) {
   formatUiReminder,
   formatViewerContextDirective,
   formatViewerContextReminder,
+  formatWeeklyDays,
   formatWorkspaceInventory,
   formatWorkspaceProfileSuffix,
   formatWorktreeDirective,
@@ -50016,6 +50222,8 @@ async function pollSlackOutboundWatches(opts) {
   normalizeThinkingEffort,
   normalizeThread,
   normalizeTurnInput,
+  normalizeWeekdays,
+  normalizeWeeklyTime,
   normalizeWorkspaceTags,
   normalizeWorktreePath,
   notifyOrchestrator,
@@ -50055,6 +50263,7 @@ async function pollSlackOutboundWatches(opts) {
   parseSessionQuotaResetAt,
   parseSlackRelayClientMessage,
   parseSlackRelayServerMessage,
+  parseWeeklyDays,
   partsToAssistantText,
   pastedTextStats,
   patchReadAloudSettings,
@@ -50332,6 +50541,7 @@ async function pollSlackOutboundWatches(opts) {
   visibleToolRowDetail,
   waitForPidExit,
   warmGithubAgentAuth,
+  weeklyCronExpr,
   whichOnPath,
   withAddedAccount,
   withEventParentId,