@code-yeongyu/senpi 2026.8.18 → 2026.8.19

package/dist/core/extensions/builtin/loop/command.js

@@ -0,0 +1,281 @@
+/**
+ * `/loop` command handler: native argument parsing and the user-facing surfaces.
+ *
+ * Parsing is pure native code (`parse.ts`) - the command never expands into a
+ * model-facing parsing prompt. Starting a loop always goes through the extension's
+ * controller, which persists and arms the schedule BEFORE dispatching the first tick,
+ * so a failed first turn can never silently lose the job.
+ *
+ * Headless rejection: print/json modes have no interactive session, so the command
+ * refuses with a one-line message and arms nothing.
+ */
+import { parseLoopArgs } from "./parse.js";
+export const LOOP_ARGUMENT_HINT = "[interval] [prompt] | stop [id|all] | status | pause | resume";
+export const LOOP_COMMAND_DESCRIPTION = "Repeat a prompt on a fixed interval or a self-paced schedule (e.g. /loop 5m check the deploy)";
+const LOOP_SUBCOMMANDS = ["stop", "status", "pause", "resume"];
+const LOOP_HEADLESS_REJECTION = "/loop needs an interactive session; it is not available in print mode, so nothing was armed.";
+/** Headless modes: single-shot output streams with no interactive transcript. */
+function isHeadlessMode(mode) {
+    return mode === "print" || mode === "json";
+}
+/**
+ * Argument completions for the subcommand keywords, modeled on the todo extension's
+ * verb completions: prefix-filtered, `null` when nothing matches.
+ */
+export function completeLoopArguments(argumentPrefix) {
+    const prefix = argumentPrefix.trim().toLowerCase();
+    const matches = LOOP_SUBCOMMANDS.filter((subcommand) => subcommand.startsWith(prefix));
+    if (matches.length === 0)
+        return null;
+    return matches.map((subcommand) => ({ value: subcommand, label: subcommand }));
+}
+function formatExpiry(expiresAt) {
+    return expiresAt === undefined ? "after 7 days" : new Date(expiresAt).toISOString();
+}
+/** Fixed-loop confirmation: id, cron, effective cadence, rounding notice, expiry, stop command. */
+export function formatFixedLoopConfirmation(outcome, requestedRaw) {
+    const cadence = outcome.effectiveCadence ?? "on schedule";
+    const parenthetical = outcome.roundingNotice === undefined ? `every ${cadence}` : `every ${cadence}; requested ${requestedRaw}`;
+    const lines = [`Loop ${outcome.loopId} scheduled as \`${outcome.cronExpression ?? ""}\` (${parenthetical}).`];
+    if (outcome.roundingNotice !== undefined)
+        lines.push(outcome.roundingNotice);
+    lines.push(`It expires automatically at ${formatExpiry(outcome.expiresAt)} (7 days).`);
+    lines.push(`Stop it with \`/loop stop ${outcome.loopId}\`.`);
+    lines.push("Running the first tick now.");
+    return lines.join("\n");
+}
+/** Dynamic-loop confirmation, including the supersession line when one replaced another. */
+export function formatDynamicLoopConfirmation(outcome) {
+    const lines = [
+        `Loop ${outcome.loopId} started in dynamic mode: the model paces each iteration with \`schedule_wakeup\`.`,
+    ];
+    if (outcome.supersededLoopId !== undefined)
+        lines.push(`Superseded dynamic loop ${outcome.supersededLoopId}.`);
+    lines.push(`It expires automatically at ${formatExpiry(outcome.expiresAt)} (7 days).`);
+    lines.push(`Stop it with \`/loop stop ${outcome.loopId}\` or a \`schedule_wakeup\` call with \`{ stop: true }\`.`);
+    lines.push("Running the first iteration now.");
+    return lines.join("\n");
+}
+/** Bare-invocation confirmation; the mode comes from the entry the controller created. */
+export function formatBareLoopConfirmation(outcome, entry) {
+    const mode = entry?.kind === "fixed" ? `fixed, every ${entry.effectiveInterval.human}` : "dynamic pacing";
+    const lines = [`Loop ${outcome.loopId} started (${mode}).`];
+    lines.push(`It expires automatically at ${formatExpiry(outcome.expiresAt)} (7 days).`);
+    lines.push(`Stop it with \`/loop stop ${outcome.loopId}\`.`);
+    lines.push("Running the first tick now.");
+    return lines.join("\n");
+}
+function describeLoopEntry(entry) {
+    const mode = entry.kind === "fixed"
+        ? `fixed, \`${entry.cronExpression}\` (every ${entry.effectiveInterval.human})`
+        : "dynamic";
+    const paused = entry.phase === "suspended" ? " · paused" : "";
+    return `- ${entry.id} (${mode}) · expires ${formatExpiry(entry.expiresAt)}${paused}`;
+}
+/**
+ * The `/loop status` listing: the live status line (countdown + stop affordance) plus
+ * one row per active loop.
+ */
+export function formatLoopStatusListing(statusLine, state) {
+    const active = Object.values(state.entries).filter((entry) => entry.phase !== "ended");
+    if (active.length === 0)
+        return "No active loops.";
+    const lines = statusLine === undefined ? [] : [statusLine];
+    lines.push("Active loops:");
+    for (const entry of active)
+        lines.push(describeLoopEntry(entry));
+    return lines.join("\n");
+}
+function activeLoopIds(state) {
+    return Object.values(state.entries)
+        .filter((entry) => entry.phase !== "ended")
+        .map((entry) => entry.id);
+}
+/**
+ * Resolves a stop/pause/resume target. An implicit target names the single active loop;
+ * with several armed loops the command must not guess, so it asks for disambiguation.
+ */
+function resolveCommandTarget(target, state) {
+    if (target.type === "all")
+        return { action: "apply", value: "all" };
+    if (target.type === "id")
+        return { action: "apply", value: target.id };
+    const ids = activeLoopIds(state);
+    if (ids.length === 0)
+        return { action: "none" };
+    if (ids.length === 1)
+        return { action: "apply", value: ids[0] };
+    return { action: "ambiguous", ids };
+}
+function notifyAmbiguous(ctx, verb, ids) {
+    const lines = ["Multiple loops are active:", ...ids.map((id) => `- ${id}`)];
+    lines.push(`Use \`/loop ${verb} <id>\` or \`/loop ${verb} all\`.`);
+    ctx.ui.notify(lines.join("\n"), "warning");
+}
+function notifyUnknownId(ctx, id, state) {
+    const ids = activeLoopIds(state);
+    const lines = [`No active loop with id "${id}".`];
+    if (ids.length > 0)
+        lines.push(`Active loops: ${ids.join(", ")}.`);
+    ctx.ui.notify(lines.join("\n"), "warning");
+}
+async function runStop(ctx, deps, target) {
+    const resolution = resolveCommandTarget(target, deps.controller.getState());
+    if (resolution.action === "none") {
+        ctx.ui.notify("No active loops.", "warning");
+        return;
+    }
+    if (resolution.action === "ambiguous") {
+        notifyAmbiguous(ctx, "stop", resolution.ids);
+        return;
+    }
+    const affected = await deps.controller.stop(resolution.value, "user-stop");
+    if (resolution.value === "all") {
+        if (affected.length === 0) {
+            ctx.ui.notify("No active loops.", "warning");
+            return;
+        }
+        const noun = affected.length === 1 ? "loop" : "loops";
+        ctx.ui.notify(`Stopped ${affected.length} ${noun}: ${affected.join(", ")}.`, "info");
+        return;
+    }
+    if (affected.length === 0) {
+        notifyUnknownId(ctx, resolution.value, deps.controller.getState());
+        return;
+    }
+    ctx.ui.notify(`Stopped loop ${resolution.value}.`, "info");
+}
+async function runPause(ctx, deps, target) {
+    const resolution = resolveCommandTarget(target, deps.controller.getState());
+    if (resolution.action === "none") {
+        ctx.ui.notify("No active loops.", "warning");
+        return;
+    }
+    if (resolution.action === "ambiguous") {
+        notifyAmbiguous(ctx, "pause", resolution.ids);
+        return;
+    }
+    const affected = await deps.controller.pause(resolution.value);
+    if (resolution.value === "all") {
+        if (affected.length === 0) {
+            ctx.ui.notify("No pausable loops.", "warning");
+            return;
+        }
+        const noun = affected.length === 1 ? "loop" : "loops";
+        ctx.ui.notify(`Paused ${affected.length} ${noun}: ${affected.join(", ")}.`, "info");
+        return;
+    }
+    if (affected.length === 0) {
+        ctx.ui.notify(`Loop ${resolution.value} is not pausable (already paused or ended).`, "warning");
+        return;
+    }
+    ctx.ui.notify(`Paused loop ${resolution.value}.`, "info");
+}
+async function runResume(ctx, deps, target) {
+    const resolution = resolveCommandTarget(target, deps.controller.getState());
+    if (resolution.action === "none") {
+        ctx.ui.notify("No active loops.", "warning");
+        return;
+    }
+    if (resolution.action === "ambiguous") {
+        notifyAmbiguous(ctx, "resume", resolution.ids);
+        return;
+    }
+    const affected = await deps.controller.resume(resolution.value);
+    if (resolution.value === "all") {
+        if (affected.length === 0) {
+            ctx.ui.notify("No paused loops to resume.", "warning");
+            return;
+        }
+        const noun = affected.length === 1 ? "loop" : "loops";
+        ctx.ui.notify(`Resumed ${affected.length} ${noun}: ${affected.join(", ")}.`, "info");
+        return;
+    }
+    if (affected.length === 0) {
+        ctx.ui.notify(`Loop ${resolution.value} is not paused.`, "warning");
+        return;
+    }
+    ctx.ui.notify(`Resumed loop ${resolution.value}.`, "info");
+}
+async function reportCreateOutcome(ctx, deps, outcome, format) {
+    const entry = deps.controller.getState().entries[outcome.loopId];
+    ctx.ui.notify(format(entry), "info");
+}
+/** The `/loop` command entry point. */
+export async function runLoopCommand(rawArgs, ctx, deps) {
+    if (isHeadlessMode(ctx.mode)) {
+        ctx.ui.notify(LOOP_HEADLESS_REJECTION, "warning");
+        // Headless hosts install a no-op UI context, so `notify` alone leaves the refusal
+        // invisible (empty output, exit 0). Write to stderr as well so the message is actually
+        // seen; real stdout stays reserved for `-p` result data.
+        process.stderr.write(`${LOOP_HEADLESS_REJECTION}\n`);
+        return;
+    }
+    const parsed = parseLoopArgs(rawArgs);
+    try {
+        switch (parsed.kind) {
+            case "invalid": {
+                ctx.ui.notify(parsed.usage, "warning");
+                return;
+            }
+            case "fixed": {
+                const outcome = await deps.controller.startFixed({
+                    originalArgs: parsed.originalArgs,
+                    prompt: parsed.prompt,
+                    requestedInterval: parsed.interval,
+                });
+                if (!outcome.ok) {
+                    ctx.ui.notify(outcome.message, "error");
+                    return;
+                }
+                await reportCreateOutcome(ctx, deps, outcome, () => formatFixedLoopConfirmation(outcome, parsed.interval.raw));
+                return;
+            }
+            case "dynamic": {
+                const outcome = await deps.controller.startDynamic({
+                    originalArgs: parsed.originalArgs,
+                    prompt: parsed.prompt,
+                });
+                if (!outcome.ok) {
+                    ctx.ui.notify(outcome.message, "error");
+                    return;
+                }
+                await reportCreateOutcome(ctx, deps, outcome, () => formatDynamicLoopConfirmation(outcome));
+                return;
+            }
+            case "bare": {
+                const outcome = await deps.controller.startBare({
+                    originalArgs: parsed.originalArgs,
+                    ...(parsed.interval === undefined ? {} : { interval: parsed.interval }),
+                });
+                if (!outcome.ok) {
+                    ctx.ui.notify(outcome.message, "error");
+                    return;
+                }
+                await reportCreateOutcome(ctx, deps, outcome, (entry) => formatBareLoopConfirmation(outcome, entry));
+                return;
+            }
+            case "stop": {
+                await runStop(ctx, deps, parsed.target);
+                return;
+            }
+            case "pause": {
+                await runPause(ctx, deps, parsed.target);
+                return;
+            }
+            case "resume": {
+                await runResume(ctx, deps, parsed.target);
+                return;
+            }
+            case "status": {
+                ctx.ui.notify(formatLoopStatusListing(deps.controller.statusLine(), deps.controller.getState()), "info");
+                return;
+            }
+        }
+    }
+    catch (error) {
+        // A failed command must surface, not vanish: notify and stop.
+        ctx.ui.notify(`/loop command failed: ${error instanceof Error ? error.message : String(error)}`, "error");
+    }
+}
+//# sourceMappingURL=command.js.map

package/dist/core/extensions/builtin/loop/command.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"command.js","sourceRoot":"","sources":["../../../../../src/core/extensions/builtin/loop/command.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAIH,OAAO,EAAmB,aAAa,EAAE,MAAM,YAAY,CAAC;AAG5D,MAAM,CAAC,MAAM,kBAAkB,GAAG,+DAA+D,CAAC;AAClG,MAAM,CAAC,MAAM,wBAAwB,GACpC,+FAA+F,CAAC;AAEjG,MAAM,gBAAgB,GAAG,CAAC,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,QAAQ,CAAU,CAAC;AAExE,MAAM,uBAAuB,GAC5B,8FAA8F,CAAC;AAMhG,iFAAiF;AACjF,SAAS,cAAc,CAAC,IAAqC;IAC5D,OAAO,IAAI,KAAK,OAAO,IAAI,IAAI,KAAK,MAAM,CAAC;AAC5C,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,qBAAqB,CAAC,cAAsB;IAC3D,MAAM,MAAM,GAAG,cAAc,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IACnD,MAAM,OAAO,GAAG,gBAAgB,CAAC,MAAM,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC,UAAU,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC;IACvF,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IACtC,OAAO,OAAO,CAAC,GAAG,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE,UAAU,EAAE,CAAC,CAAC,CAAC;AAChF,CAAC;AAED,SAAS,YAAY,CAAC,SAA6B;IAClD,OAAO,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,SAAS,CAAC,CAAC,WAAW,EAAE,CAAC;AACrF,CAAC;AAED,mGAAmG;AACnG,MAAM,UAAU,2BAA2B,CAAC,OAAqB,EAAE,YAAoB;IACtF,MAAM,OAAO,GAAG,OAAO,CAAC,gBAAgB,IAAI,aAAa,CAAC;IAC1D,MAAM,aAAa,GAClB,OAAO,CAAC,cAAc,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,OAAO,EAAE,CAAC,CAAC,CAAC,SAAS,OAAO,eAAe,YAAY,EAAE,CAAC;IAC3G,MAAM,KAAK,GAAG,CAAC,QAAQ,OAAO,CAAC,MAAM,mBAAmB,OAAO,CAAC,cAAc,IAAI,EAAE,OAAO,aAAa,IAAI,CAAC,CAAC;IAC9G,IAAI,OAAO,CAAC,cAAc,KAAK,SAAS;QAAE,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC;IAC7E,KAAK,CAAC,IAAI,CAAC,+BAA+B,YAAY,CAAC,OAAO,CAAC,SAAS,CAAC,YAAY,CAAC,CAAC;IACvF,KAAK,CAAC,IAAI,CAAC,6BAA6B,OAAO,CAAC,MAAM,KAAK,CAAC,CAAC;IAC7D,KAAK,CAAC,IAAI,CAAC,6BAA6B,CAAC,CAAC;IAC1C,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACzB,CAAC;AAED,4FAA4F;AAC5F,MAAM,UAAU,6BAA6B,CAAC,OAAqB;IAClE,MAAM,KAAK,GAAG;QACb,QAAQ,OAAO,CAAC,MAAM,oFAAoF;KAC1G,CAAC;IACF,IAAI,OAAO,CAAC,gBAAgB,KAAK,SAAS;QAAE,KAAK,CAAC,IAAI,CAAC,2BAA2B,OAAO,CAAC,gBAAgB,GAAG,CAAC,CAAC;IAC/G,KAAK,CAAC,IAAI,CAAC,+BAA+B,YAAY,CAAC,OAAO,CAAC,SAAS,CAAC,YAAY,CAAC,CAAC;IACvF,KAAK,CAAC,IAAI,CAAC,6BAA6B,OAAO,CAAC,MAAM,2DAA2D,CAAC,CAAC;IACnH,KAAK,CAAC,IAAI,CAAC,kCAAkC,CAAC,CAAC;IAC/C,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACzB,CAAC;AAED,0FAA0F;AAC1F,MAAM,UAAU,0BAA0B,CAAC,OAAqB,EAAE,KAA4B;IAC7F,MAAM,IAAI,GAAG,KAAK,EAAE,IAAI,KAAK,OAAO,CAAC,CAAC,CAAC,gBAAgB,KAAK,CAAC,iBAAiB,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,gBAAgB,CAAC;IAC1G,MAAM,KAAK,GAAG,CAAC,QAAQ,OAAO,CAAC,MAAM,aAAa,IAAI,IAAI,CAAC,CAAC;IAC5D,KAAK,CAAC,IAAI,CAAC,+BAA+B,YAAY,CAAC,OAAO,CAAC,SAAS,CAAC,YAAY,CAAC,CAAC;IACvF,KAAK,CAAC,IAAI,CAAC,6BAA6B,OAAO,CAAC,MAAM,KAAK,CAAC,CAAC;IAC7D,KAAK,CAAC,IAAI,CAAC,6BAA6B,CAAC,CAAC;IAC1C,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACzB,CAAC;AAED,SAAS,iBAAiB,CAAC,KAAgB;IAC1C,MAAM,IAAI,GACT,KAAK,CAAC,IAAI,KAAK,OAAO;QACrB,CAAC,CAAC,YAAY,KAAK,CAAC,cAAc,aAAa,KAAK,CAAC,iBAAiB,CAAC,KAAK,GAAG;QAC/E,CAAC,CAAC,SAAS,CAAC;IACd,MAAM,MAAM,GAAG,KAAK,CAAC,KAAK,KAAK,WAAW,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,CAAC;IAC9D,OAAO,KAAK,KAAK,CAAC,EAAE,KAAK,IAAI,eAAe,YAAY,CAAC,KAAK,CAAC,SAAS,CAAC,GAAG,MAAM,EAAE,CAAC;AACtF,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,uBAAuB,CAAC,UAA8B,EAAE,KAAgB;IACvF,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,KAAK,KAAK,OAAO,CAAC,CAAC;IACvF,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,kBAAkB,CAAC;IACnD,MAAM,KAAK,GAAG,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC;IAC3D,KAAK,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;IAC5B,KAAK,MAAM,KAAK,IAAI,MAAM;QAAE,KAAK,CAAC,IAAI,CAAC,iBAAiB,CAAC,KAAK,CAAC,CAAC,CAAC;IACjE,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACzB,CAAC;AAED,SAAS,aAAa,CAAC,KAAgB;IACtC,OAAO,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC;SACjC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,KAAK,KAAK,OAAO,CAAC;SAC1C,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;AAC5B,CAAC;AAOD;;;GAGG;AACH,SAAS,oBAAoB,CAAC,MAAkB,EAAE,KAAgB;IACjE,IAAI,MAAM,CAAC,IAAI,KAAK,KAAK;QAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC;IACpE,IAAI,MAAM,CAAC,IAAI,KAAK,IAAI;QAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,CAAC,EAAE,EAAE,CAAC;IACvE,MAAM,GAAG,GAAG,aAAa,CAAC,KAAK,CAAC,CAAC;IACjC,IAAI,GAAG,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC;IAChD,IAAI,GAAG,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;IAChE,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,GAAG,EAAE,CAAC;AACrC,CAAC;AAED,SAAS,eAAe,CACvB,GAA4B,EAC5B,IAAiC,EACjC,GAAsB;IAEtB,MAAM,KAAK,GAAG,CAAC,4BAA4B,EAAE,GAAG,GAAG,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,CAAC;IAC5E,KAAK,CAAC,IAAI,CAAC,eAAe,IAAI,sBAAsB,IAAI,SAAS,CAAC,CAAC;IACnE,GAAG,CAAC,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,SAAS,CAAC,CAAC;AAC5C,CAAC;AAED,SAAS,eAAe,CAAC,GAA4B,EAAE,EAAU,EAAE,KAAgB;IAClF,MAAM,GAAG,GAAG,aAAa,CAAC,KAAK,CAAC,CAAC;IACjC,MAAM,KAAK,GAAG,CAAC,2BAA2B,EAAE,IAAI,CAAC,CAAC;IAClD,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC;QAAE,KAAK,CAAC,IAAI,CAAC,iBAAiB,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACnE,GAAG,CAAC,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,SAAS,CAAC,CAAC;AAC5C,CAAC;AAED,KAAK,UAAU,OAAO,CAAC,GAA4B,EAAE,IAAqB,EAAE,MAAkB;IAC7F,MAAM,UAAU,GAAG,oBAAoB,CAAC,MAAM,EAAE,IAAI,CAAC,UAAU,CAAC,QAAQ,EAAE,CAAC,CAAC;IAC5E,IAAI,UAAU,CAAC,MAAM,KAAK,MAAM,EAAE,CAAC;QAClC,GAAG,CAAC,EAAE,CAAC,MAAM,CAAC,kBAAkB,EAAE,SAAS,CAAC,CAAC;QAC7C,OAAO;IACR,CAAC;IACD,IAAI,UAAU,CAAC,MAAM,KAAK,WAAW,EAAE,CAAC;QACvC,eAAe,CAAC,GAAG,EAAE,MAAM,EAAE,UAAU,CAAC,GAAG,CAAC,CAAC;QAC7C,OAAO;IACR,CAAC;IACD,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,UAAU,CAAC,KAAK,EAAE,WAAW,CAAC,CAAC;IAC3E,IAAI,UAAU,CAAC,KAAK,KAAK,KAAK,EAAE,CAAC;QAChC,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC3B,GAAG,CAAC,EAAE,CAAC,MAAM,CAAC,kBAAkB,EAAE,SAAS,CAAC,CAAC;YAC7C,OAAO;QACR,CAAC;QACD,MAAM,IAAI,GAAG,QAAQ,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC;QACtD,GAAG,CAAC,EAAE,CAAC,MAAM,CAAC,WAAW,QAAQ,CAAC,MAAM,IAAI,IAAI,KAAK,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;QACrF,OAAO;IACR,CAAC;IACD,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC3B,eAAe,CAAC,GAAG,EAAE,UAAU,CAAC,KAAK,EAAE,IAAI,CAAC,UAAU,CAAC,QAAQ,EAAE,CAAC,CAAC;QACnE,OAAO;IACR,CAAC;IACD,GAAG,CAAC,EAAE,CAAC,MAAM,CAAC,gBAAgB,UAAU,CAAC,KAAK,GAAG,EAAE,MAAM,CAAC,CAAC;AAC5D,CAAC;AAED,KAAK,UAAU,QAAQ,CAAC,GAA4B,EAAE,IAAqB,EAAE,MAAkB;IAC9F,MAAM,UAAU,GAAG,oBAAoB,CAAC,MAAM,EAAE,IAAI,CAAC,UAAU,CAAC,QAAQ,EAAE,CAAC,CAAC;IAC5E,IAAI,UAAU,CAAC,MAAM,KAAK,MAAM,EAAE,CAAC;QAClC,GAAG,CAAC,EAAE,CAAC,MAAM,CAAC,kBAAkB,EAAE,SAAS,CAAC,CAAC;QAC7C,OAAO;IACR,CAAC;IACD,IAAI,UAAU,CAAC,MAAM,KAAK,WAAW,EAAE,CAAC;QACvC,eAAe,CAAC,GAAG,EAAE,OAAO,EAAE,UAAU,CAAC,GAAG,CAAC,CAAC;QAC9C,OAAO;IACR,CAAC;IACD,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;IAC/D,IAAI,UAAU,CAAC,KAAK,KAAK,KAAK,EAAE,CAAC;QAChC,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC3B,GAAG,CAAC,EAAE,CAAC,MAAM,CAAC,oBAAoB,EAAE,SAAS,CAAC,CAAC;YAC/C,OAAO;QACR,CAAC;QACD,MAAM,IAAI,GAAG,QAAQ,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC;QACtD,GAAG,CAAC,EAAE,CAAC,MAAM,CAAC,UAAU,QAAQ,CAAC,MAAM,IAAI,IAAI,KAAK,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;QACpF,OAAO;IACR,CAAC;IACD,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC3B,GAAG,CAAC,EAAE,CAAC,MAAM,CAAC,QAAQ,UAAU,CAAC,KAAK,6CAA6C,EAAE,SAAS,CAAC,CAAC;QAChG,OAAO;IACR,CAAC;IACD,GAAG,CAAC,EAAE,CAAC,MAAM,CAAC,eAAe,UAAU,CAAC,KAAK,GAAG,EAAE,MAAM,CAAC,CAAC;AAC3D,CAAC;AAED,KAAK,UAAU,SAAS,CAAC,GAA4B,EAAE,IAAqB,EAAE,MAAkB;IAC/F,MAAM,UAAU,GAAG,oBAAoB,CAAC,MAAM,EAAE,IAAI,CAAC,UAAU,CAAC,QAAQ,EAAE,CAAC,CAAC;IAC5E,IAAI,UAAU,CAAC,MAAM,KAAK,MAAM,EAAE,CAAC;QAClC,GAAG,CAAC,EAAE,CAAC,MAAM,CAAC,kBAAkB,EAAE,SAAS,CAAC,CAAC;QAC7C,OAAO;IACR,CAAC;IACD,IAAI,UAAU,CAAC,MAAM,KAAK,WAAW,EAAE,CAAC;QACvC,eAAe,CAAC,GAAG,EAAE,QAAQ,EAAE,UAAU,CAAC,GAAG,CAAC,CAAC;QAC/C,OAAO;IACR,CAAC;IACD,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;IAChE,IAAI,UAAU,CAAC,KAAK,KAAK,KAAK,EAAE,CAAC;QAChC,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC3B,GAAG,CAAC,EAAE,CAAC,MAAM,CAAC,4BAA4B,EAAE,SAAS,CAAC,CAAC;YACvD,OAAO;QACR,CAAC;QACD,MAAM,IAAI,GAAG,QAAQ,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC;QACtD,GAAG,CAAC,EAAE,CAAC,MAAM,CAAC,WAAW,QAAQ,CAAC,MAAM,IAAI,IAAI,KAAK,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;QACrF,OAAO;IACR,CAAC;IACD,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC3B,GAAG,CAAC,EAAE,CAAC,MAAM,CAAC,QAAQ,UAAU,CAAC,KAAK,iBAAiB,EAAE,SAAS,CAAC,CAAC;QACpE,OAAO;IACR,CAAC;IACD,GAAG,CAAC,EAAE,CAAC,MAAM,CAAC,gBAAgB,UAAU,CAAC,KAAK,GAAG,EAAE,MAAM,CAAC,CAAC;AAC5D,CAAC;AAED,KAAK,UAAU,mBAAmB,CACjC,GAA4B,EAC5B,IAAqB,EACrB,OAAqB,EACrB,MAAgD;IAEhD,MAAM,KAAK,GAAG,IAAI,CAAC,UAAU,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IACjE,GAAG,CAAC,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC,CAAC;AACtC,CAAC;AAED,uCAAuC;AACvC,MAAM,CAAC,KAAK,UAAU,cAAc,CACnC,OAAe,EACf,GAA4B,EAC5B,IAAqB;IAErB,IAAI,cAAc,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;QAC9B,GAAG,CAAC,EAAE,CAAC,MAAM,CAAC,uBAAuB,EAAE,SAAS,CAAC,CAAC;QAClD,kFAAkF;QAClF,uFAAuF;QACvF,yDAAyD;QACzD,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,uBAAuB,IAAI,CAAC,CAAC;QACrD,OAAO;IACR,CAAC;IAED,MAAM,MAAM,GAAG,aAAa,CAAC,OAAO,CAAC,CAAC;IACtC,IAAI,CAAC;QACJ,QAAQ,MAAM,CAAC,IAAI,EAAE,CAAC;YACrB,KAAK,SAAS,CAAC,CAAC,CAAC;gBAChB,GAAG,CAAC,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC;gBACvC,OAAO;YACR,CAAC;YACD,KAAK,OAAO,CAAC,CAAC,CAAC;gBACd,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC;oBAChD,YAAY,EAAE,MAAM,CAAC,YAAY;oBACjC,MAAM,EAAE,MAAM,CAAC,MAAM;oBACrB,iBAAiB,EAAE,MAAM,CAAC,QAAQ;iBAClC,CAAC,CAAC;gBACH,IAAI,CAAC,OAAO,CAAC,EAAE,EAAE,CAAC;oBACjB,GAAG,CAAC,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;oBACxC,OAAO;gBACR,CAAC;gBACD,MAAM,mBAAmB,CAAC,GAAG,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,EAAE,CAClD,2BAA2B,CAAC,OAAO,EAAE,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,CACzD,CAAC;gBACF,OAAO;YACR,CAAC;YACD,KAAK,SAAS,CAAC,CAAC,CAAC;gBAChB,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,YAAY,CAAC;oBAClD,YAAY,EAAE,MAAM,CAAC,YAAY;oBACjC,MAAM,EAAE,MAAM,CAAC,MAAM;iBACrB,CAAC,CAAC;gBACH,IAAI,CAAC,OAAO,CAAC,EAAE,EAAE,CAAC;oBACjB,GAAG,CAAC,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;oBACxC,OAAO;gBACR,CAAC;gBACD,MAAM,mBAAmB,CAAC,GAAG,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,EAAE,CAAC,6BAA6B,CAAC,OAAO,CAAC,CAAC,CAAC;gBAC5F,OAAO;YACR,CAAC;YACD,KAAK,MAAM,CAAC,CAAC,CAAC;gBACb,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC;oBAC/C,YAAY,EAAE,MAAM,CAAC,YAAY;oBACjC,GAAG,CAAC,MAAM,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,CAAC,QAAQ,EAAE,CAAC;iBACvE,CAAC,CAAC;gBACH,IAAI,CAAC,OAAO,CAAC,EAAE,EAAE,CAAC;oBACjB,GAAG,CAAC,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;oBACxC,OAAO;gBACR,CAAC;gBACD,MAAM,mBAAmB,CAAC,GAAG,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,0BAA0B,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC;gBACrG,OAAO;YACR,CAAC;YACD,KAAK,MAAM,CAAC,CAAC,CAAC;gBACb,MAAM,OAAO,CAAC,GAAG,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC;gBACxC,OAAO;YACR,CAAC;YACD,KAAK,OAAO,CAAC,CAAC,CAAC;gBACd,MAAM,QAAQ,CAAC,GAAG,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC;gBACzC,OAAO;YACR,CAAC;YACD,KAAK,QAAQ,CAAC,CAAC,CAAC;gBACf,MAAM,SAAS,CAAC,GAAG,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC;gBAC1C,OAAO;YACR,CAAC;YACD,KAAK,QAAQ,CAAC,CAAC,CAAC;gBACf,GAAG,CAAC,EAAE,CAAC,MAAM,CAAC,uBAAuB,CAAC,IAAI,CAAC,UAAU,CAAC,UAAU,EAAE,EAAE,IAAI,CAAC,UAAU,CAAC,QAAQ,EAAE,CAAC,EAAE,MAAM,CAAC,CAAC;gBACzG,OAAO;YACR,CAAC;QACF,CAAC;IACF,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QAChB,8DAA8D;QAC9D,GAAG,CAAC,EAAE,CAAC,MAAM,CAAC,yBAAyB,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,EAAE,OAAO,CAAC,CAAC;IAC3G,CAAC;AACF,CAAC","sourcesContent":["/**\n * `/loop` command handler: native argument parsing and the user-facing surfaces.\n *\n * Parsing is pure native code (`parse.ts`) - the command never expands into a\n * model-facing parsing prompt. Starting a loop always goes through the extension's\n * controller, which persists and arms the schedule BEFORE dispatching the first tick,\n * so a failed first turn can never silently lose the job.\n *\n * Headless rejection: print/json modes have no interactive session, so the command\n * refuses with a one-line message and arms nothing.\n */\n\nimport type { ExtensionCommandContext } from \"../../types.ts\";\nimport type { LoopController, LoopCreateOk } from \"./index.ts\";\nimport { type LoopTarget, parseLoopArgs } from \"./parse.ts\";\nimport type { CronEntry, LoopId, LoopState } from \"./types.ts\";\n\nexport const LOOP_ARGUMENT_HINT = \"[interval] [prompt] | stop [id|all] | status | pause | resume\";\nexport const LOOP_COMMAND_DESCRIPTION =\n\t\"Repeat a prompt on a fixed interval or a self-paced schedule (e.g. /loop 5m check the deploy)\";\n\nconst LOOP_SUBCOMMANDS = [\"stop\", \"status\", \"pause\", \"resume\"] as const;\n\nconst LOOP_HEADLESS_REJECTION =\n\t\"/loop needs an interactive session; it is not available in print mode, so nothing was armed.\";\n\nexport interface LoopCommandDeps {\n\treadonly controller: LoopController;\n}\n\n/** Headless modes: single-shot output streams with no interactive transcript. */\nfunction isHeadlessMode(mode: ExtensionCommandContext[\"mode\"]): boolean {\n\treturn mode === \"print\" || mode === \"json\";\n}\n\n/**\n * Argument completions for the subcommand keywords, modeled on the todo extension's\n * verb completions: prefix-filtered, `null` when nothing matches.\n */\nexport function completeLoopArguments(argumentPrefix: string): Array<{ value: string; label: string }> | null {\n\tconst prefix = argumentPrefix.trim().toLowerCase();\n\tconst matches = LOOP_SUBCOMMANDS.filter((subcommand) => subcommand.startsWith(prefix));\n\tif (matches.length === 0) return null;\n\treturn matches.map((subcommand) => ({ value: subcommand, label: subcommand }));\n}\n\nfunction formatExpiry(expiresAt: number | undefined): string {\n\treturn expiresAt === undefined ? \"after 7 days\" : new Date(expiresAt).toISOString();\n}\n\n/** Fixed-loop confirmation: id, cron, effective cadence, rounding notice, expiry, stop command. */\nexport function formatFixedLoopConfirmation(outcome: LoopCreateOk, requestedRaw: string): string {\n\tconst cadence = outcome.effectiveCadence ?? \"on schedule\";\n\tconst parenthetical =\n\t\toutcome.roundingNotice === undefined ? `every ${cadence}` : `every ${cadence}; requested ${requestedRaw}`;\n\tconst lines = [`Loop ${outcome.loopId} scheduled as \\`${outcome.cronExpression ?? \"\"}\\` (${parenthetical}).`];\n\tif (outcome.roundingNotice !== undefined) lines.push(outcome.roundingNotice);\n\tlines.push(`It expires automatically at ${formatExpiry(outcome.expiresAt)} (7 days).`);\n\tlines.push(`Stop it with \\`/loop stop ${outcome.loopId}\\`.`);\n\tlines.push(\"Running the first tick now.\");\n\treturn lines.join(\"\\n\");\n}\n\n/** Dynamic-loop confirmation, including the supersession line when one replaced another. */\nexport function formatDynamicLoopConfirmation(outcome: LoopCreateOk): string {\n\tconst lines = [\n\t\t`Loop ${outcome.loopId} started in dynamic mode: the model paces each iteration with \\`schedule_wakeup\\`.`,\n\t];\n\tif (outcome.supersededLoopId !== undefined) lines.push(`Superseded dynamic loop ${outcome.supersededLoopId}.`);\n\tlines.push(`It expires automatically at ${formatExpiry(outcome.expiresAt)} (7 days).`);\n\tlines.push(`Stop it with \\`/loop stop ${outcome.loopId}\\` or a \\`schedule_wakeup\\` call with \\`{ stop: true }\\`.`);\n\tlines.push(\"Running the first iteration now.\");\n\treturn lines.join(\"\\n\");\n}\n\n/** Bare-invocation confirmation; the mode comes from the entry the controller created. */\nexport function formatBareLoopConfirmation(outcome: LoopCreateOk, entry: CronEntry | undefined): string {\n\tconst mode = entry?.kind === \"fixed\" ? `fixed, every ${entry.effectiveInterval.human}` : \"dynamic pacing\";\n\tconst lines = [`Loop ${outcome.loopId} started (${mode}).`];\n\tlines.push(`It expires automatically at ${formatExpiry(outcome.expiresAt)} (7 days).`);\n\tlines.push(`Stop it with \\`/loop stop ${outcome.loopId}\\`.`);\n\tlines.push(\"Running the first tick now.\");\n\treturn lines.join(\"\\n\");\n}\n\nfunction describeLoopEntry(entry: CronEntry): string {\n\tconst mode =\n\t\tentry.kind === \"fixed\"\n\t\t\t? `fixed, \\`${entry.cronExpression}\\` (every ${entry.effectiveInterval.human})`\n\t\t\t: \"dynamic\";\n\tconst paused = entry.phase === \"suspended\" ? \" · paused\" : \"\";\n\treturn `- ${entry.id} (${mode}) · expires ${formatExpiry(entry.expiresAt)}${paused}`;\n}\n\n/**\n * The `/loop status` listing: the live status line (countdown + stop affordance) plus\n * one row per active loop.\n */\nexport function formatLoopStatusListing(statusLine: string | undefined, state: LoopState): string {\n\tconst active = Object.values(state.entries).filter((entry) => entry.phase !== \"ended\");\n\tif (active.length === 0) return \"No active loops.\";\n\tconst lines = statusLine === undefined ? [] : [statusLine];\n\tlines.push(\"Active loops:\");\n\tfor (const entry of active) lines.push(describeLoopEntry(entry));\n\treturn lines.join(\"\\n\");\n}\n\nfunction activeLoopIds(state: LoopState): readonly LoopId[] {\n\treturn Object.values(state.entries)\n\t\t.filter((entry) => entry.phase !== \"ended\")\n\t\t.map((entry) => entry.id);\n}\n\ntype TargetResolution =\n\t| { readonly action: \"apply\"; readonly value: LoopId | \"all\" }\n\t| { readonly action: \"none\" }\n\t| { readonly action: \"ambiguous\"; readonly ids: readonly LoopId[] };\n\n/**\n * Resolves a stop/pause/resume target. An implicit target names the single active loop;\n * with several armed loops the command must not guess, so it asks for disambiguation.\n */\nfunction resolveCommandTarget(target: LoopTarget, state: LoopState): TargetResolution {\n\tif (target.type === \"all\") return { action: \"apply\", value: \"all\" };\n\tif (target.type === \"id\") return { action: \"apply\", value: target.id };\n\tconst ids = activeLoopIds(state);\n\tif (ids.length === 0) return { action: \"none\" };\n\tif (ids.length === 1) return { action: \"apply\", value: ids[0] };\n\treturn { action: \"ambiguous\", ids };\n}\n\nfunction notifyAmbiguous(\n\tctx: ExtensionCommandContext,\n\tverb: \"stop\" | \"pause\" | \"resume\",\n\tids: readonly LoopId[],\n): void {\n\tconst lines = [\"Multiple loops are active:\", ...ids.map((id) => `- ${id}`)];\n\tlines.push(`Use \\`/loop ${verb} <id>\\` or \\`/loop ${verb} all\\`.`);\n\tctx.ui.notify(lines.join(\"\\n\"), \"warning\");\n}\n\nfunction notifyUnknownId(ctx: ExtensionCommandContext, id: string, state: LoopState): void {\n\tconst ids = activeLoopIds(state);\n\tconst lines = [`No active loop with id \"${id}\".`];\n\tif (ids.length > 0) lines.push(`Active loops: ${ids.join(\", \")}.`);\n\tctx.ui.notify(lines.join(\"\\n\"), \"warning\");\n}\n\nasync function runStop(ctx: ExtensionCommandContext, deps: LoopCommandDeps, target: LoopTarget): Promise<void> {\n\tconst resolution = resolveCommandTarget(target, deps.controller.getState());\n\tif (resolution.action === \"none\") {\n\t\tctx.ui.notify(\"No active loops.\", \"warning\");\n\t\treturn;\n\t}\n\tif (resolution.action === \"ambiguous\") {\n\t\tnotifyAmbiguous(ctx, \"stop\", resolution.ids);\n\t\treturn;\n\t}\n\tconst affected = await deps.controller.stop(resolution.value, \"user-stop\");\n\tif (resolution.value === \"all\") {\n\t\tif (affected.length === 0) {\n\t\t\tctx.ui.notify(\"No active loops.\", \"warning\");\n\t\t\treturn;\n\t\t}\n\t\tconst noun = affected.length === 1 ? \"loop\" : \"loops\";\n\t\tctx.ui.notify(`Stopped ${affected.length} ${noun}: ${affected.join(\", \")}.`, \"info\");\n\t\treturn;\n\t}\n\tif (affected.length === 0) {\n\t\tnotifyUnknownId(ctx, resolution.value, deps.controller.getState());\n\t\treturn;\n\t}\n\tctx.ui.notify(`Stopped loop ${resolution.value}.`, \"info\");\n}\n\nasync function runPause(ctx: ExtensionCommandContext, deps: LoopCommandDeps, target: LoopTarget): Promise<void> {\n\tconst resolution = resolveCommandTarget(target, deps.controller.getState());\n\tif (resolution.action === \"none\") {\n\t\tctx.ui.notify(\"No active loops.\", \"warning\");\n\t\treturn;\n\t}\n\tif (resolution.action === \"ambiguous\") {\n\t\tnotifyAmbiguous(ctx, \"pause\", resolution.ids);\n\t\treturn;\n\t}\n\tconst affected = await deps.controller.pause(resolution.value);\n\tif (resolution.value === \"all\") {\n\t\tif (affected.length === 0) {\n\t\t\tctx.ui.notify(\"No pausable loops.\", \"warning\");\n\t\t\treturn;\n\t\t}\n\t\tconst noun = affected.length === 1 ? \"loop\" : \"loops\";\n\t\tctx.ui.notify(`Paused ${affected.length} ${noun}: ${affected.join(\", \")}.`, \"info\");\n\t\treturn;\n\t}\n\tif (affected.length === 0) {\n\t\tctx.ui.notify(`Loop ${resolution.value} is not pausable (already paused or ended).`, \"warning\");\n\t\treturn;\n\t}\n\tctx.ui.notify(`Paused loop ${resolution.value}.`, \"info\");\n}\n\nasync function runResume(ctx: ExtensionCommandContext, deps: LoopCommandDeps, target: LoopTarget): Promise<void> {\n\tconst resolution = resolveCommandTarget(target, deps.controller.getState());\n\tif (resolution.action === \"none\") {\n\t\tctx.ui.notify(\"No active loops.\", \"warning\");\n\t\treturn;\n\t}\n\tif (resolution.action === \"ambiguous\") {\n\t\tnotifyAmbiguous(ctx, \"resume\", resolution.ids);\n\t\treturn;\n\t}\n\tconst affected = await deps.controller.resume(resolution.value);\n\tif (resolution.value === \"all\") {\n\t\tif (affected.length === 0) {\n\t\t\tctx.ui.notify(\"No paused loops to resume.\", \"warning\");\n\t\t\treturn;\n\t\t}\n\t\tconst noun = affected.length === 1 ? \"loop\" : \"loops\";\n\t\tctx.ui.notify(`Resumed ${affected.length} ${noun}: ${affected.join(\", \")}.`, \"info\");\n\t\treturn;\n\t}\n\tif (affected.length === 0) {\n\t\tctx.ui.notify(`Loop ${resolution.value} is not paused.`, \"warning\");\n\t\treturn;\n\t}\n\tctx.ui.notify(`Resumed loop ${resolution.value}.`, \"info\");\n}\n\nasync function reportCreateOutcome(\n\tctx: ExtensionCommandContext,\n\tdeps: LoopCommandDeps,\n\toutcome: LoopCreateOk,\n\tformat: (entry: CronEntry | undefined) => string,\n): Promise<void> {\n\tconst entry = deps.controller.getState().entries[outcome.loopId];\n\tctx.ui.notify(format(entry), \"info\");\n}\n\n/** The `/loop` command entry point. */\nexport async function runLoopCommand(\n\trawArgs: string,\n\tctx: ExtensionCommandContext,\n\tdeps: LoopCommandDeps,\n): Promise<void> {\n\tif (isHeadlessMode(ctx.mode)) {\n\t\tctx.ui.notify(LOOP_HEADLESS_REJECTION, \"warning\");\n\t\t// Headless hosts install a no-op UI context, so `notify` alone leaves the refusal\n\t\t// invisible (empty output, exit 0). Write to stderr as well so the message is actually\n\t\t// seen; real stdout stays reserved for `-p` result data.\n\t\tprocess.stderr.write(`${LOOP_HEADLESS_REJECTION}\\n`);\n\t\treturn;\n\t}\n\n\tconst parsed = parseLoopArgs(rawArgs);\n\ttry {\n\t\tswitch (parsed.kind) {\n\t\t\tcase \"invalid\": {\n\t\t\t\tctx.ui.notify(parsed.usage, \"warning\");\n\t\t\t\treturn;\n\t\t\t}\n\t\t\tcase \"fixed\": {\n\t\t\t\tconst outcome = await deps.controller.startFixed({\n\t\t\t\t\toriginalArgs: parsed.originalArgs,\n\t\t\t\t\tprompt: parsed.prompt,\n\t\t\t\t\trequestedInterval: parsed.interval,\n\t\t\t\t});\n\t\t\t\tif (!outcome.ok) {\n\t\t\t\t\tctx.ui.notify(outcome.message, \"error\");\n\t\t\t\t\treturn;\n\t\t\t\t}\n\t\t\t\tawait reportCreateOutcome(ctx, deps, outcome, () =>\n\t\t\t\t\tformatFixedLoopConfirmation(outcome, parsed.interval.raw),\n\t\t\t\t);\n\t\t\t\treturn;\n\t\t\t}\n\t\t\tcase \"dynamic\": {\n\t\t\t\tconst outcome = await deps.controller.startDynamic({\n\t\t\t\t\toriginalArgs: parsed.originalArgs,\n\t\t\t\t\tprompt: parsed.prompt,\n\t\t\t\t});\n\t\t\t\tif (!outcome.ok) {\n\t\t\t\t\tctx.ui.notify(outcome.message, \"error\");\n\t\t\t\t\treturn;\n\t\t\t\t}\n\t\t\t\tawait reportCreateOutcome(ctx, deps, outcome, () => formatDynamicLoopConfirmation(outcome));\n\t\t\t\treturn;\n\t\t\t}\n\t\t\tcase \"bare\": {\n\t\t\t\tconst outcome = await deps.controller.startBare({\n\t\t\t\t\toriginalArgs: parsed.originalArgs,\n\t\t\t\t\t...(parsed.interval === undefined ? {} : { interval: parsed.interval }),\n\t\t\t\t});\n\t\t\t\tif (!outcome.ok) {\n\t\t\t\t\tctx.ui.notify(outcome.message, \"error\");\n\t\t\t\t\treturn;\n\t\t\t\t}\n\t\t\t\tawait reportCreateOutcome(ctx, deps, outcome, (entry) => formatBareLoopConfirmation(outcome, entry));\n\t\t\t\treturn;\n\t\t\t}\n\t\t\tcase \"stop\": {\n\t\t\t\tawait runStop(ctx, deps, parsed.target);\n\t\t\t\treturn;\n\t\t\t}\n\t\t\tcase \"pause\": {\n\t\t\t\tawait runPause(ctx, deps, parsed.target);\n\t\t\t\treturn;\n\t\t\t}\n\t\t\tcase \"resume\": {\n\t\t\t\tawait runResume(ctx, deps, parsed.target);\n\t\t\t\treturn;\n\t\t\t}\n\t\t\tcase \"status\": {\n\t\t\t\tctx.ui.notify(formatLoopStatusListing(deps.controller.statusLine(), deps.controller.getState()), \"info\");\n\t\t\t\treturn;\n\t\t\t}\n\t\t}\n\t} catch (error) {\n\t\t// A failed command must surface, not vanish: notify and stop.\n\t\tctx.ui.notify(`/loop command failed: ${error instanceof Error ? error.message : String(error)}`, \"error\");\n\t}\n}\n"]}

package/dist/core/extensions/builtin/loop/cron-planner.d.ts

@@ -0,0 +1,23 @@
+import type { EffectiveInterval, RequestedInterval } from "./types.ts";
+export type { EffectiveInterval, RequestedInterval };
+/**
+ * Converts a user-requested interval into an effective cadence the scheduler
+ * can express with the restricted display cron forms. Seconds are coarsened to
+ * minutes; large minute/hour values roll up to hours/days with half-up
+ * rounding. Whenever the effective value differs from the request, the result
+ * carries a notice naming both the requested and effective cadence.
+ */
+export declare function normalizeInterval(requested: RequestedInterval): EffectiveInterval & {
+    intervalMs: number;
+};
+/**
+ * Returns a restricted 5-field cron expression for DISPLAY ONLY. The scheduler
+ * uses intervalMs + absolute nextFireAt; this string is shown to the user.
+ */
+export declare function describeCron(effective: Pick<EffectiveInterval, "value" | "unit">): string;
+/**
+ * Computes the absolute timestamp of the next scheduled fire. Pure: takes
+ * nowMs as a parameter and never reads the clock internally.
+ */
+export declare function computeNextFireAt(nowMs: number, intervalMs: number): number;
+//# sourceMappingURL=cron-planner.d.ts.map

package/dist/core/extensions/builtin/loop/cron-planner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cron-planner.d.ts","sourceRoot":"","sources":["../../../../../src/core/extensions/builtin/loop/cron-planner.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAyB,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAI9F,YAAY,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,CAAC;AAUrD;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,iBAAiB,GAAG,iBAAiB,GAAG;IAAE,UAAU,EAAE,MAAM,CAAA;CAAE,CAwD1G;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,SAAS,EAAE,IAAI,CAAC,iBAAiB,EAAE,OAAO,GAAG,MAAM,CAAC,GAAG,MAAM,CASzF;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAE3E"}

package/dist/core/extensions/builtin/loop/cron-planner.js

@@ -0,0 +1,88 @@
+const MS_PER_MINUTE = 60_000;
+const MS_PER_HOUR = 60 * MS_PER_MINUTE;
+const MS_PER_DAY = 24 * MS_PER_HOUR;
+function pluralize(count, singular, plural) {
+    return count === 1 ? `${count} ${singular}` : `${count} ${plural}`;
+}
+/**
+ * Converts a user-requested interval into an effective cadence the scheduler
+ * can express with the restricted display cron forms. Seconds are coarsened to
+ * minutes; large minute/hour values roll up to hours/days with half-up
+ * rounding. Whenever the effective value differs from the request, the result
+ * carries a notice naming both the requested and effective cadence.
+ */
+export function normalizeInterval(requested) {
+    let value;
+    let unit;
+    let rounded;
+    switch (requested.unit) {
+        case "s": {
+            value = Math.max(1, Math.ceil(requested.value / 60));
+            unit = "m";
+            rounded = true;
+            break;
+        }
+        case "m": {
+            if (requested.value >= 60) {
+                value = Math.round(requested.value / 60);
+                unit = "h";
+                rounded = true;
+            }
+            else {
+                value = requested.value;
+                unit = "m";
+                rounded = false;
+            }
+            break;
+        }
+        case "h": {
+            if (requested.value >= 24) {
+                value = Math.round(requested.value / 24);
+                unit = "d";
+                rounded = true;
+            }
+            else {
+                value = requested.value;
+                unit = "h";
+                rounded = false;
+            }
+            break;
+        }
+        case "d": {
+            value = requested.value;
+            unit = "d";
+            rounded = false;
+            break;
+        }
+    }
+    const human = unit === "m"
+        ? pluralize(value, "minute", "minutes")
+        : unit === "h"
+            ? pluralize(value, "hour", "hours")
+            : pluralize(value, "day", "days");
+    const intervalMs = unit === "m" ? value * MS_PER_MINUTE : unit === "h" ? value * MS_PER_HOUR : value * MS_PER_DAY;
+    const roundingNotice = rounded ? `Requested ${requested.raw} rounds to ${human}.` : undefined;
+    return { value, unit, human, rounded, roundingNotice, intervalMs };
+}
+/**
+ * Returns a restricted 5-field cron expression for DISPLAY ONLY. The scheduler
+ * uses intervalMs + absolute nextFireAt; this string is shown to the user.
+ */
+export function describeCron(effective) {
+    switch (effective.unit) {
+        case "m":
+            return `*/${effective.value} * * * *`;
+        case "h":
+            return `0 */${effective.value} * * *`;
+        case "d":
+            return `0 0 */${effective.value} * *`;
+    }
+}
+/**
+ * Computes the absolute timestamp of the next scheduled fire. Pure: takes
+ * nowMs as a parameter and never reads the clock internally.
+ */
+export function computeNextFireAt(nowMs, intervalMs) {
+    return nowMs + intervalMs;
+}
+//# sourceMappingURL=cron-planner.js.map

package/dist/core/extensions/builtin/loop/cron-planner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cron-planner.js","sourceRoot":"","sources":["../../../../../src/core/extensions/builtin/loop/cron-planner.ts"],"names":[],"mappings":"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","sourcesContent":["import type { EffectiveInterval, EffectiveIntervalUnit, RequestedInterval } from \"./types.ts\";\n\n// `types.ts` is the single type home for the whole extension; these are re-exported so\n// existing consumers of the planner keep importing the canonical declarations.\nexport type { EffectiveInterval, RequestedInterval };\n\nconst MS_PER_MINUTE = 60_000;\nconst MS_PER_HOUR = 60 * MS_PER_MINUTE;\nconst MS_PER_DAY = 24 * MS_PER_HOUR;\n\nfunction pluralize(count: number, singular: string, plural: string): string {\n\treturn count === 1 ? `${count} ${singular}` : `${count} ${plural}`;\n}\n\n/**\n * Converts a user-requested interval into an effective cadence the scheduler\n * can express with the restricted display cron forms. Seconds are coarsened to\n * minutes; large minute/hour values roll up to hours/days with half-up\n * rounding. Whenever the effective value differs from the request, the result\n * carries a notice naming both the requested and effective cadence.\n */\nexport function normalizeInterval(requested: RequestedInterval): EffectiveInterval & { intervalMs: number } {\n\tlet value: number;\n\tlet unit: EffectiveIntervalUnit;\n\tlet rounded: boolean;\n\n\tswitch (requested.unit) {\n\t\tcase \"s\": {\n\t\t\tvalue = Math.max(1, Math.ceil(requested.value / 60));\n\t\t\tunit = \"m\";\n\t\t\trounded = true;\n\t\t\tbreak;\n\t\t}\n\t\tcase \"m\": {\n\t\t\tif (requested.value >= 60) {\n\t\t\t\tvalue = Math.round(requested.value / 60);\n\t\t\t\tunit = \"h\";\n\t\t\t\trounded = true;\n\t\t\t} else {\n\t\t\t\tvalue = requested.value;\n\t\t\t\tunit = \"m\";\n\t\t\t\trounded = false;\n\t\t\t}\n\t\t\tbreak;\n\t\t}\n\t\tcase \"h\": {\n\t\t\tif (requested.value >= 24) {\n\t\t\t\tvalue = Math.round(requested.value / 24);\n\t\t\t\tunit = \"d\";\n\t\t\t\trounded = true;\n\t\t\t} else {\n\t\t\t\tvalue = requested.value;\n\t\t\t\tunit = \"h\";\n\t\t\t\trounded = false;\n\t\t\t}\n\t\t\tbreak;\n\t\t}\n\t\tcase \"d\": {\n\t\t\tvalue = requested.value;\n\t\t\tunit = \"d\";\n\t\t\trounded = false;\n\t\t\tbreak;\n\t\t}\n\t}\n\n\tconst human =\n\t\tunit === \"m\"\n\t\t\t? pluralize(value, \"minute\", \"minutes\")\n\t\t\t: unit === \"h\"\n\t\t\t\t? pluralize(value, \"hour\", \"hours\")\n\t\t\t\t: pluralize(value, \"day\", \"days\");\n\n\tconst intervalMs = unit === \"m\" ? value * MS_PER_MINUTE : unit === \"h\" ? value * MS_PER_HOUR : value * MS_PER_DAY;\n\n\tconst roundingNotice = rounded ? `Requested ${requested.raw} rounds to ${human}.` : undefined;\n\n\treturn { value, unit, human, rounded, roundingNotice, intervalMs };\n}\n\n/**\n * Returns a restricted 5-field cron expression for DISPLAY ONLY. The scheduler\n * uses intervalMs + absolute nextFireAt; this string is shown to the user.\n */\nexport function describeCron(effective: Pick<EffectiveInterval, \"value\" | \"unit\">): string {\n\tswitch (effective.unit) {\n\t\tcase \"m\":\n\t\t\treturn `*/${effective.value} * * * *`;\n\t\tcase \"h\":\n\t\t\treturn `0 */${effective.value} * * *`;\n\t\tcase \"d\":\n\t\t\treturn `0 0 */${effective.value} * *`;\n\t}\n}\n\n/**\n * Computes the absolute timestamp of the next scheduled fire. Pure: takes\n * nowMs as a parameter and never reads the clock internally.\n */\nexport function computeNextFireAt(nowMs: number, intervalMs: number): number {\n\treturn nowMs + intervalMs;\n}\n"]}

package/dist/core/extensions/builtin/loop/index.d.ts

@@ -0,0 +1,134 @@
+/**
+ * `/loop` extension factory and lifecycle wiring.
+ *
+ * This module owns the only impure parts of the feature: real timers, the session store,
+ * the extension event wiring, and message dispatch. Every decision it makes is delegated
+ * to the pure modules beside it (`scheduler.ts`, `tick-prompt.ts`, `cron-planner.ts`,
+ * `loopfile.ts`, `status.ts`), so the runtime here is a thin, testable adapter.
+ *
+ * Load-bearing rules implemented here:
+ * - A tick NEVER steers. Idle dispatch goes through `sendUserMessage(..., {
+ *   expandPromptTemplates: true })` so a slash payload reaches the real command path;
+ *   a busy session receives the tick as a follow-up instead.
+ * - Shutdown SUSPENDS: timers are cancelled, the ticker disposed, and the snapshot is
+ *   persisted without a terminal reason (every senpi shutdown reason is resumable).
+ * - Keepalive is applied only to an attributed dynamic iteration, never after an ordinary
+ *   user turn, and never after a user abort (an abort PAUSES the loop instead).
+ * - A store failure is not swallowed: the affected loops end with `error` and the user is
+ *   told, because a schedule that cannot be persisted must not keep running.
+ */
+import type { EntryRenderer, ExtensionContext, ExtensionFactory } from "../../types.ts";
+import { type LoopFileResult } from "./loopfile.ts";
+import { type LoopClock, type LoopIdFactory, type LoopTimerPort } from "./scheduler.ts";
+import { type LoopMode, type TickDelivery } from "./tick-prompt.ts";
+import type { DeliveryId, EpochMs, LoopEndReason, LoopId, LoopSentinel, LoopState, LoopStoreRef, RequestedInterval } from "./types.ts";
+/** Custom entry type carrying one dispatched tick, used for attribution and folding. */
+export declare const LOOP_TICK_ENTRY_TYPE = "loop-tick";
+export interface LoopTickEntryData {
+    readonly loopId: LoopId;
+    readonly deliveryId: DeliveryId;
+    readonly scheduledForAt: EpochMs;
+    readonly mode: LoopMode;
+    readonly delivery: TickDelivery;
+    readonly sentinel?: LoopSentinel;
+    /** Consecutive quiet dynamic iterations at the moment this tick was dispatched. */
+    readonly noopStreak: number;
+    /** True when this tick continues a quiet streak and should render folded. */
+    readonly folded: boolean;
+}
+export interface LoopCreateOk {
+    readonly ok: true;
+    readonly loopId: LoopId;
+    /** Present when a new dynamic loop replaced a previous one. */
+    readonly supersededLoopId?: LoopId;
+    /** Human-readable rounding notice when the requested cadence was normalized. */
+    readonly roundingNotice?: string;
+    readonly cronExpression?: string;
+    readonly effectiveCadence?: string;
+    readonly expiresAt?: EpochMs;
+}
+export interface LoopCreateRejected {
+    readonly ok: false;
+    readonly message: string;
+}
+export type LoopCreateOutcome = LoopCreateOk | LoopCreateRejected;
+export interface LoopStoreFailure {
+    readonly endReason: LoopEndReason;
+    readonly message: string;
+    readonly loopIds: readonly LoopId[];
+}
+export interface StartFixedRequest {
+    readonly originalArgs: string;
+    readonly prompt: string;
+    readonly requestedInterval: RequestedInterval;
+}
+export interface StartDynamicRequest {
+    readonly originalArgs: string;
+    readonly prompt: string;
+}
+export interface StartBareRequest {
+    readonly originalArgs: string;
+    readonly interval?: RequestedInterval;
+}
+export interface ControllerScheduleWakeupRequest {
+    readonly loopId: LoopId;
+    readonly requestedDelaySeconds: number;
+    readonly delaySeconds: number;
+    readonly reason: string;
+    readonly prompt: string;
+    readonly noop: boolean;
+}
+/**
+ * Runtime surface of a live loop extension. The `/loop` command module drives the
+ * extension exclusively through this interface, so command parsing never reaches into
+ * scheduler or store internals.
+ */
+export interface LoopController {
+    startFixed(request: StartFixedRequest): Promise<LoopCreateOutcome>;
+    startDynamic(request: StartDynamicRequest): Promise<LoopCreateOutcome>;
+    startBare(request: StartBareRequest): Promise<LoopCreateOutcome>;
+    /** Runs the due decision for a loop at the current clock reading and dispatches it. */
+    fireDue(loopId: LoopId): Promise<void>;
+    scheduleWakeup(request: ControllerScheduleWakeupRequest): Promise<void>;
+    stop(target: LoopId | "all", detail: string): Promise<readonly LoopId[]>;
+    pause(target: LoopId | "all"): Promise<readonly LoopId[]>;
+    resume(target: LoopId | "all"): Promise<readonly LoopId[]>;
+    getState(): LoopState;
+    statusLine(): string | undefined;
+    /** Set when a store read/write failed and the affected loops were ended with `error`. */
+    lastStoreFailure(): LoopStoreFailure | undefined;
+    /** True when this loop was retired because its state could not be read or written. */
+    isEndedWithError(loopId: LoopId): boolean;
+}
+export interface LoopExtensionDeps {
+    readonly clock?: LoopClock;
+    /** Factory so each session gets its own timer port; defaults to real timeouts. */
+    readonly timers?: () => LoopTimerPort;
+    readonly ids?: LoopIdFactory;
+    readonly storeRef?: (ctx: ExtensionContext) => LoopStoreRef;
+    readonly resolveLoopFile?: (options: {
+        cwd: string;
+        homeDir: string;
+    }) => Promise<LoopFileResult>;
+    readonly readState?: (ref: LoopStoreRef) => Promise<LoopState | null>;
+    readonly writeState?: (ref: LoopStoreRef, state: LoopState) => Promise<void>;
+    /**
+     * Published at factory time so a command module (or a test) can drive this instance.
+     * The controller is bound to the extension's own session state, so it stays valid across
+     * session starts within one extension generation.
+     */
+    readonly onControllerReady?: (controller: LoopController) => void;
+}
+export declare const renderLoopTickEntry: EntryRenderer<LoopTickEntryData>;
+/**
+ * Real timer port: exactly one live timeout per key, replaced on re-arm.
+ *
+ * Follows the generation-counter discipline of `cache-keepalive/index.ts`: cancelling or
+ * re-arming a key bumps its generation, so a callback whose generation is stale returns
+ * without firing even if it was already scheduled on the event loop.
+ */
+export declare function createNodeTimerPort(): LoopTimerPort;
+export declare function createLoopExtension(deps?: LoopExtensionDeps): ExtensionFactory;
+declare const _default: ExtensionFactory;
+export default _default;
+//# sourceMappingURL=index.d.ts.map

package/dist/core/extensions/builtin/loop/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/core/extensions/builtin/loop/index.ts"],"names":[],"mappings":"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"}