@code-yeongyu/senpi 2026.8.18 → 2026.8.20-2

package/dist/core/extensions/builtin/goal/wait-ticker.js.map

@@ -1 +1 @@
-{"version":3,"file":"wait-ticker.js","sourceRoot":"","sources":["../../../../../src/core/extensions/builtin/goal/wait-ticker.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,mBAAmB,EAA8C,MAAM,oBAAoB,CAAC;AAErG,6EAA6E;AAC7E,MAAM,CAAC,MAAM,0BAA0B,GAAG,IAAI,CAAC;AAC/C,MAAM,CAAC,MAAM,oBAAoB,GAAG,WAAW,CAAC;AAWhD;;;;GAIG;AACH,MAAM,OAAO,cAAc;IAW1B,YAAY,OAA8B;QALlC,YAAO,GAAG,CAAC,CAAC;QACZ,YAAO,GAAG,CAAC,CAAC;QACZ,kBAAa,GAA4B,EAAE,CAAC;QAInD,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;QAC7B,IAAI,CAAC,GAAG,GAAG,OAAO,CAAC,GAAG,IAAI,IAAI,CAAC,GAAG,CAAC;IACpC,CAAC;IAED,IAAI,OAAO;QACV,OAAO,IAAI,CAAC,UAAU,KAAK,SAAS,CAAC;IACtC,CAAC;IAED,0EAA0E;IAC1E,IAAI,CAAC,GAAqB,EAAE,KAAyB;QACpD,IAAI,CAAC,GAAG,GAAG,GAAG,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC;QACvB,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,CAAC,WAAW,CAAC,CAAC;QAC3D,IAAI,CAAC,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC;QAC7B,IAAI,CAAC,aAAa,GAAG,EAAE,GAAG,KAAK,CAAC,aAAa,EAAE,CAAC;QAChD,IAAI,CAAC,kBAAkB,GAAG,SAAS,CAAC;QACpC,IAAI,CAAC,IAAI,EAAE,CAAC;QACZ,IAAI,IAAI,CAAC,UAAU,KAAK,SAAS;YAAE,OAAO;QAC1C,MAAM,MAAM,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,0BAA0B,CAAC,CAAC;QAC1E,MAAM,CAAC,KAAK,EAAE,CAAC;QACf,IAAI,CAAC,UAAU,GAAG,MAAM,CAAC;IAC1B,CAAC;IAED,uEAAuE;IACvE,gBAAgB,CAAC,aAAsC;QACtD,IAAI,IAAI,CAAC,GAAG,KAAK,SAAS,IAAI,IAAI,CAAC,IAAI,KAAK,SAAS;YAAE,OAAO;QAC9D,IAAI,CAAC,aAAa,GAAG,EAAE,GAAG,aAAa,EAAE,CAAC;QAC1C,IAAI,CAAC,IAAI,EAAE,CAAC;IACb,CAAC;IAED,6EAA6E;IAC7E,IAAI;QACH,IAAI,IAAI,CAAC,UAAU,KAAK,SAAS,EAAE,CAAC;YACnC,aAAa,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;YAC/B,IAAI,CAAC,UAAU,GAAG,SAAS,CAAC;QAC7B,CAAC;QACD,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC;QACrB,IAAI,CAAC,GAAG,GAAG,SAAS,CAAC;QACrB,IAAI,CAAC,IAAI,GAAG,SAAS,CAAC;QACtB,IAAI,CAAC,kBAAkB,GAAG,SAAS,CAAC;QACpC,IAAI,GAAG,KAAK,SAAS;YAAE,IAAI,CAAC,MAAM,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;IACpD,CAAC;IAEO,IAAI;QACX,IAAI,IAAI,CAAC,GAAG,KAAK,SAAS,IAAI,IAAI,CAAC,IAAI,KAAK,SAAS;YAAE,OAAO;QAC9D,MAAM,MAAM,GAAG,mBAAmB,CAAC;YAClC,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,WAAW,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;YACnD,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,aAAa,EAAE,IAAI,CAAC,aAAa;SACjC,CAAC,CAAC;QACH,IAAI,MAAM,KAAK,IAAI,CAAC,kBAAkB;YAAE,OAAO;QAC/C,IAAI,CAAC,kBAAkB,GAAG,MAAM,CAAC;QACjC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;IAC/B,CAAC;CACD","sourcesContent":["import type { ExtensionContext } from \"../../types.ts\";\nimport type { ResumptionChannelCounts } from \"./monitor-continuation-types.ts\";\nimport { formatGoalWaitLabel, type GoalWaitKind, type GoalWaitLabelInput } from \"./wait-progress.ts\";\n\n/** Footer countdown refresh cadence while a Goal continuation is delayed. */\nexport const GOAL_WAIT_TICK_INTERVAL_MS = 1000;\nexport const GOAL_WAIT_STATUS_KEY = \"goal-wait\";\n\n/** Receives the freshly formatted footer status text (undefined clears the status). */\nexport type GoalWaitRender = (ctx: ExtensionContext, status: string | undefined) => void;\n\nexport interface GoalWaitTickerOptions {\n\treadonly render: GoalWaitRender;\n\t/** Injectable clock for tests; defaults to Date.now. */\n\treadonly now?: () => number;\n}\n\n/**\n * Drives a once-per-second footer countdown while a Goal continuation timer is\n * armed. Mirrors the existing GoalElapsedTicker and MonitorStatusTicker: the\n * interval is unref'd and unchanged visible labels are not rendered again.\n */\nexport class GoalWaitTicker {\n\tprivate readonly render: GoalWaitRender;\n\tprivate readonly now: () => number;\n\tprivate intervalId: NodeJS.Timeout | undefined;\n\tprivate ctx: ExtensionContext | undefined;\n\tprivate kind: GoalWaitKind | undefined;\n\tprivate dueAtMs = 0;\n\tprivate totalMs = 0;\n\tprivate channelCounts: ResumptionChannelCounts = {};\n\tprivate lastRenderedStatus: string | undefined;\n\n\tconstructor(options: GoalWaitTickerOptions) {\n\t\tthis.render = options.render;\n\t\tthis.now = options.now ?? Date.now;\n\t}\n\n\tget running(): boolean {\n\t\treturn this.intervalId !== undefined;\n\t}\n\n\t/** Render the current wait immediately and keep it live until stopped. */\n\tsync(ctx: ExtensionContext, input: GoalWaitLabelInput): void {\n\t\tthis.ctx = ctx;\n\t\tthis.kind = input.kind;\n\t\tthis.dueAtMs = this.now() + Math.max(0, input.remainingMs);\n\t\tthis.totalMs = input.totalMs;\n\t\tthis.channelCounts = { ...input.channelCounts };\n\t\tthis.lastRenderedStatus = undefined;\n\t\tthis.tick();\n\t\tif (this.intervalId !== undefined) return;\n\t\tconst handle = setInterval(() => this.tick(), GOAL_WAIT_TICK_INTERVAL_MS);\n\t\thandle.unref();\n\t\tthis.intervalId = handle;\n\t}\n\n\t/** Refresh channel wording without changing the countdown deadline. */\n\tsetChannelCounts(channelCounts: ResumptionChannelCounts): void {\n\t\tif (this.ctx === undefined || this.kind !== \"monitor\") return;\n\t\tthis.channelCounts = { ...channelCounts };\n\t\tthis.tick();\n\t}\n\n\t/** Stop ticking, clear the footer segment, and drop the retained context. */\n\tstop(): void {\n\t\tif (this.intervalId !== undefined) {\n\t\t\tclearInterval(this.intervalId);\n\t\t\tthis.intervalId = undefined;\n\t\t}\n\t\tconst ctx = this.ctx;\n\t\tthis.ctx = undefined;\n\t\tthis.kind = undefined;\n\t\tthis.lastRenderedStatus = undefined;\n\t\tif (ctx !== undefined) this.render(ctx, undefined);\n\t}\n\n\tprivate tick(): void {\n\t\tif (this.ctx === undefined || this.kind === undefined) return;\n\t\tconst status = formatGoalWaitLabel({\n\t\t\tkind: this.kind,\n\t\t\tremainingMs: Math.max(0, this.dueAtMs - this.now()),\n\t\t\ttotalMs: this.totalMs,\n\t\t\tchannelCounts: this.channelCounts,\n\t\t});\n\t\tif (status === this.lastRenderedStatus) return;\n\t\tthis.lastRenderedStatus = status;\n\t\tthis.render(this.ctx, status);\n\t}\n}\n"]}
+{"version":3,"file":"wait-ticker.js","sourceRoot":"","sources":["../../../../../src/core/extensions/builtin/goal/wait-ticker.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,4BAA4B,EAAE,MAAM,oBAAoB,CAAC;AAClE,OAAO,EAAE,mBAAmB,EAA8C,MAAM,oBAAoB,CAAC;AAErG,6EAA6E;AAC7E,MAAM,CAAC,MAAM,0BAA0B,GAAG,IAAI,CAAC;AAC/C,MAAM,CAAC,MAAM,oBAAoB,GAAG,WAAW,CAAC;AAWhD;;;;GAIG;AACH,MAAM,OAAO,cAAc;IAW1B,YAAY,OAA8B;QALlC,YAAO,GAAG,CAAC,CAAC;QACZ,YAAO,GAAG,CAAC,CAAC;QACZ,kBAAa,GAA4B,EAAE,CAAC;QAInD,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;QAC7B,IAAI,CAAC,GAAG,GAAG,OAAO,CAAC,GAAG,IAAI,IAAI,CAAC,GAAG,CAAC;IACpC,CAAC;IAED,IAAI,OAAO;QACV,OAAO,IAAI,CAAC,UAAU,KAAK,SAAS,CAAC;IACtC,CAAC;IAED,0EAA0E;IAC1E,IAAI,CAAC,GAAqB,EAAE,KAAyB;QACpD,IAAI,CAAC,GAAG,GAAG,GAAG,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC;QACvB,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,CAAC,WAAW,CAAC,CAAC;QAC3D,IAAI,CAAC,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC;QAC7B,IAAI,CAAC,aAAa,GAAG,EAAE,GAAG,KAAK,CAAC,aAAa,EAAE,CAAC;QAChD,IAAI,CAAC,kBAAkB,GAAG,SAAS,CAAC;QACpC,IAAI,CAAC,IAAI,EAAE,CAAC;QACZ,IAAI,IAAI,CAAC,UAAU,KAAK,SAAS;YAAE,OAAO;QAC1C,MAAM,MAAM,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,0BAA0B,CAAC,CAAC;QAC1E,MAAM,CAAC,KAAK,EAAE,CAAC;QACf,IAAI,CAAC,UAAU,GAAG,MAAM,CAAC;IAC1B,CAAC;IAED,uEAAuE;IACvE,gBAAgB,CAAC,aAAsC;QACtD,IAAI,IAAI,CAAC,GAAG,KAAK,SAAS,IAAI,IAAI,CAAC,IAAI,KAAK,SAAS;YAAE,OAAO;QAC9D,IAAI,CAAC,aAAa,GAAG,EAAE,GAAG,aAAa,EAAE,CAAC;QAC1C,IAAI,CAAC,IAAI,EAAE,CAAC;IACb,CAAC;IAED,6EAA6E;IAC7E,IAAI;QACH,IAAI,IAAI,CAAC,UAAU,KAAK,SAAS,EAAE,CAAC;YACnC,aAAa,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;YAC/B,IAAI,CAAC,UAAU,GAAG,SAAS,CAAC;QAC7B,CAAC;QACD,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC;QACrB,IAAI,CAAC,GAAG,GAAG,SAAS,CAAC;QACrB,IAAI,CAAC,IAAI,GAAG,SAAS,CAAC;QACtB,IAAI,CAAC,kBAAkB,GAAG,SAAS,CAAC;QACpC,IAAI,GAAG,KAAK,SAAS,EAAE,CAAC;YACvB,IAAI,CAAC;gBACJ,IAAI,CAAC,MAAM,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;YAC7B,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBAChB,yEAAyE;gBACzE,IAAI,CAAC,4BAA4B,CAAC,KAAK,CAAC;oBAAE,MAAM,KAAK,CAAC;YACvD,CAAC;QACF,CAAC;IACF,CAAC;IAED;;;;;;OAMG;IACK,MAAM;QACb,IAAI,IAAI,CAAC,UAAU,KAAK,SAAS,EAAE,CAAC;YACnC,aAAa,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;YAC/B,IAAI,CAAC,UAAU,GAAG,SAAS,CAAC;QAC7B,CAAC;QACD,IAAI,CAAC,GAAG,GAAG,SAAS,CAAC;QACrB,IAAI,CAAC,IAAI,GAAG,SAAS,CAAC;QACtB,IAAI,CAAC,kBAAkB,GAAG,SAAS,CAAC;IACrC,CAAC;IAEO,IAAI;QACX,IAAI,IAAI,CAAC,GAAG,KAAK,SAAS,IAAI,IAAI,CAAC,IAAI,KAAK,SAAS;YAAE,OAAO;QAC9D,MAAM,MAAM,GAAG,mBAAmB,CAAC;YAClC,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,WAAW,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;YACnD,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,aAAa,EAAE,IAAI,CAAC,aAAa;SACjC,CAAC,CAAC;QACH,IAAI,MAAM,KAAK,IAAI,CAAC,kBAAkB;YAAE,OAAO;QAC/C,IAAI,CAAC,kBAAkB,GAAG,MAAM,CAAC;QACjC,IAAI,CAAC;YACJ,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;QAC/B,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YAChB,IAAI,4BAA4B,CAAC,KAAK,CAAC,EAAE,CAAC;gBACzC,IAAI,CAAC,MAAM,EAAE,CAAC;gBACd,OAAO;YACR,CAAC;YACD,MAAM,KAAK,CAAC;QACb,CAAC;IACF,CAAC;CACD","sourcesContent":["import type { ExtensionContext } from \"../../types.ts\";\nimport type { ResumptionChannelCounts } from \"./monitor-continuation-types.ts\";\nimport { isStaleExtensionContextError } from \"./stale-context.ts\";\nimport { formatGoalWaitLabel, type GoalWaitKind, type GoalWaitLabelInput } from \"./wait-progress.ts\";\n\n/** Footer countdown refresh cadence while a Goal continuation is delayed. */\nexport const GOAL_WAIT_TICK_INTERVAL_MS = 1000;\nexport const GOAL_WAIT_STATUS_KEY = \"goal-wait\";\n\n/** Receives the freshly formatted footer status text (undefined clears the status). */\nexport type GoalWaitRender = (ctx: ExtensionContext, status: string | undefined) => void;\n\nexport interface GoalWaitTickerOptions {\n\treadonly render: GoalWaitRender;\n\t/** Injectable clock for tests; defaults to Date.now. */\n\treadonly now?: () => number;\n}\n\n/**\n * Drives a once-per-second footer countdown while a Goal continuation timer is\n * armed. Mirrors the existing GoalElapsedTicker and MonitorStatusTicker: the\n * interval is unref'd and unchanged visible labels are not rendered again.\n */\nexport class GoalWaitTicker {\n\tprivate readonly render: GoalWaitRender;\n\tprivate readonly now: () => number;\n\tprivate intervalId: NodeJS.Timeout | undefined;\n\tprivate ctx: ExtensionContext | undefined;\n\tprivate kind: GoalWaitKind | undefined;\n\tprivate dueAtMs = 0;\n\tprivate totalMs = 0;\n\tprivate channelCounts: ResumptionChannelCounts = {};\n\tprivate lastRenderedStatus: string | undefined;\n\n\tconstructor(options: GoalWaitTickerOptions) {\n\t\tthis.render = options.render;\n\t\tthis.now = options.now ?? Date.now;\n\t}\n\n\tget running(): boolean {\n\t\treturn this.intervalId !== undefined;\n\t}\n\n\t/** Render the current wait immediately and keep it live until stopped. */\n\tsync(ctx: ExtensionContext, input: GoalWaitLabelInput): void {\n\t\tthis.ctx = ctx;\n\t\tthis.kind = input.kind;\n\t\tthis.dueAtMs = this.now() + Math.max(0, input.remainingMs);\n\t\tthis.totalMs = input.totalMs;\n\t\tthis.channelCounts = { ...input.channelCounts };\n\t\tthis.lastRenderedStatus = undefined;\n\t\tthis.tick();\n\t\tif (this.intervalId !== undefined) return;\n\t\tconst handle = setInterval(() => this.tick(), GOAL_WAIT_TICK_INTERVAL_MS);\n\t\thandle.unref();\n\t\tthis.intervalId = handle;\n\t}\n\n\t/** Refresh channel wording without changing the countdown deadline. */\n\tsetChannelCounts(channelCounts: ResumptionChannelCounts): void {\n\t\tif (this.ctx === undefined || this.kind !== \"monitor\") return;\n\t\tthis.channelCounts = { ...channelCounts };\n\t\tthis.tick();\n\t}\n\n\t/** Stop ticking, clear the footer segment, and drop the retained context. */\n\tstop(): void {\n\t\tif (this.intervalId !== undefined) {\n\t\t\tclearInterval(this.intervalId);\n\t\t\tthis.intervalId = undefined;\n\t\t}\n\t\tconst ctx = this.ctx;\n\t\tthis.ctx = undefined;\n\t\tthis.kind = undefined;\n\t\tthis.lastRenderedStatus = undefined;\n\t\tif (ctx !== undefined) {\n\t\t\ttry {\n\t\t\t\tthis.render(ctx, undefined);\n\t\t\t} catch (error) {\n\t\t\t\t// A stale ctx cannot clear its own footer status; dropping it is enough.\n\t\t\t\tif (!isStaleExtensionContextError(error)) throw error;\n\t\t\t}\n\t\t}\n\t}\n\n\t/**\n\t * Drop the interval and retained ctx without a final render. Used when a tick\n\t * discovers the ctx was retired by a session replacement or reload: every\n\t * render against it throws from now on, and a ticker that keeps ticking dead\n\t * renders freezes the footer forever without crashing. The next sync() with a\n\t * live ctx re-arms everything.\n\t */\n\tprivate retire(): void {\n\t\tif (this.intervalId !== undefined) {\n\t\t\tclearInterval(this.intervalId);\n\t\t\tthis.intervalId = undefined;\n\t\t}\n\t\tthis.ctx = undefined;\n\t\tthis.kind = undefined;\n\t\tthis.lastRenderedStatus = undefined;\n\t}\n\n\tprivate tick(): void {\n\t\tif (this.ctx === undefined || this.kind === undefined) return;\n\t\tconst status = formatGoalWaitLabel({\n\t\t\tkind: this.kind,\n\t\t\tremainingMs: Math.max(0, this.dueAtMs - this.now()),\n\t\t\ttotalMs: this.totalMs,\n\t\t\tchannelCounts: this.channelCounts,\n\t\t});\n\t\tif (status === this.lastRenderedStatus) return;\n\t\tthis.lastRenderedStatus = status;\n\t\ttry {\n\t\t\tthis.render(this.ctx, status);\n\t\t} catch (error) {\n\t\t\tif (isStaleExtensionContextError(error)) {\n\t\t\t\tthis.retire();\n\t\t\t\treturn;\n\t\t\t}\n\t\t\tthrow error;\n\t\t}\n\t}\n}\n"]}

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/core/extensions/builtin/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAUpD,OAAO,aAAa,MAAM,WAAW,CAAC;AACtC,OAAO,cAAc,MAAM,YAAY,CAAC;AAiBxC,OAAO,wBAAwB,MAAM,wBAAwB,CAAC;AAU9D,OAAO,YAAY,MAAM,UAAU,CAAC;AAMpC,MAAM,WAAW,uBAAuB;IACvC,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,gBAAgB,CAAC;CAC1B;AAED,eAAO,MAAM,yBAAyB,wDAAyD,CAAC;AAEhG,eAAO,MAAM,+BAA+B;;;;;CAKoC,CAAC;AAEjF,eAAO,MAAM,iBAAiB,EAAE,uBAAuB,EAiDtD,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/core/extensions/builtin/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAUpD,OAAO,aAAa,MAAM,WAAW,CAAC;AACtC,OAAO,cAAc,MAAM,YAAY,CAAC;AAkBxC,OAAO,wBAAwB,MAAM,wBAAwB,CAAC;AAU9D,OAAO,YAAY,MAAM,UAAU,CAAC;AAMpC,MAAM,WAAW,uBAAuB;IACvC,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,gBAAgB,CAAC;CAC1B;AAED,eAAO,MAAM,yBAAyB,wDAAyD,CAAC;AAEhG,eAAO,MAAM,+BAA+B;;;;;CAKoC,CAAC;AAEjF,eAAO,MAAM,iBAAiB,EAAE,uBAAuB,EAkDtD,CAAC"}

package/dist/core/extensions/builtin/index.js

@@ -17,6 +17,7 @@ import hooksExtension from "./hooks/index.js";
 import imageGenExtension from "./imagegen/index.js";
 import importReproExtension from "./import-repro.js";
 import lookAtExtension from "./look-at/index.js";
+import loopExtension from "./loop/index.js";
 import loopGuardExtension from "./loop-guard/index.js";
 import mcpExtension from "./mcp/index.js";
 import modelFallbackExtension from "./model-fallback/index.js";
@@ -84,6 +85,7 @@ export const builtinExtensions = [
     { id: "nested-agents-md", factory: nestedAgentsMdExtension },
     { id: "rules", factory: piRulesExtension },
     { id: "goal", factory: goalExtension },
+    { id: "loop", factory: loopExtension },
     { id: "cache-keepalive", factory: cacheKeepAliveExtension },
     { id: "ttsr", factory: ttsrExtension },
     { id: "btw", factory: btwExtension },

package/dist/core/extensions/builtin/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/core/extensions/builtin/index.ts"],"names":[],"mappings":"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","sourcesContent":["import type { ExtensionFactory } from \"../types.ts\";\nimport anthropicBashExtension from \"./anthropic-bash/index.ts\";\nimport anthropicWebSearchExtension from \"./anthropic-web-search/index.ts\";\nimport bashTimeoutExtension from \"./bash-timeout/index.ts\";\nimport btwExtension from \"./btw/index.ts\";\nimport cacheKeepAliveExtension from \"./cache-keepalive/index.ts\";\nimport claudeSdkOauthExtension from \"./claude-sdk-oauth/index.ts\";\nimport compactionExtension from \"./compaction/index.ts\";\nimport configReloadExtension from \"./config-reload/index.ts\";\nimport cursorCliOauthExtension from \"./cursor-cli-oauth/index.ts\";\nimport diffExtension from \"./diff.ts\";\nimport filesExtension from \"./files.ts\";\nimport goalExtension from \"./goal/index.ts\";\nimport gptApplyPatchExtension from \"./gpt-apply-patch/index.ts\";\nimport helpExtension from \"./help/index.ts\";\nimport historySearchExtension from \"./history-search/index.ts\";\nimport hooksExtension from \"./hooks/index.ts\";\nimport imageGenExtension from \"./imagegen/index.ts\";\nimport importReproExtension from \"./import-repro.ts\";\nimport lookAtExtension from \"./look-at/index.ts\";\nimport loopGuardExtension from \"./loop-guard/index.ts\";\nimport mcpExtension from \"./mcp/index.ts\";\nimport modelFallbackExtension from \"./model-fallback/index.ts\";\nimport nestedAgentsMdExtension from \"./nested-agents-md/index.ts\";\nimport openaiImageGenExtension from \"./openai-image-gen/index.ts\";\nimport openaiWebSearchExtension from \"./openai-web-search/index.ts\";\nimport permissionSystemExtension from \"./permission-system/index.ts\";\nimport promptPresetExtension from \"./prompt-preset/index.ts\";\nimport promptUrlWidgetExtension from \"./prompt-url-widget.ts\";\nimport reasoningExtension from \"./reasoning/index.ts\";\nimport recommendedModelsExtension from \"./recommended-models/index.ts\";\nimport redrawsExtension from \"./redraws.ts\";\nimport piRulesExtension from \"./rules/index.ts\";\nimport serviceTierExtension from \"./service-tier.ts\";\nimport terminalExtension from \"./terminal/index.ts\";\nimport todowriteExtension from \"./todotools/index.ts\";\nimport toolPairGuardExtension from \"./tool-pair-guard/index.ts\";\nimport toolSearchExtension from \"./tool-search/index.ts\";\nimport tpsExtension from \"./tps.ts\";\nimport ttsrExtension from \"./ttsr/index.ts\";\nimport videoInExtension from \"./video-in/index.ts\";\nimport webfetchExtension from \"./webfetch/index.ts\";\nimport websearchExtension from \"./websearch/index.ts\";\n\nexport interface BuiltinExtensionFactory {\n\tid: string;\n\tfactory: ExtensionFactory;\n}\n\nexport const globalDefaultExtensionIds = [\"diff\", \"files\", \"prompt-url-widget\", \"tps\"] as const;\n\nexport const globalDefaultExtensionFactories = {\n\tdiff: diffExtension,\n\tfiles: filesExtension,\n\t\"prompt-url-widget\": promptUrlWidgetExtension,\n\ttps: tpsExtension,\n} satisfies Record<(typeof globalDefaultExtensionIds)[number], ExtensionFactory>;\n\nexport const builtinExtensions: BuiltinExtensionFactory[] = [\n\t// Loop guard owns the first veto opportunity so repeated calls never re-run hooks or permission prompts.\n\t{ id: \"loop-guard\", factory: loopGuardExtension },\n\t{ id: \"hooks\", factory: hooksExtension },\n\t{ id: \"permission-system\", factory: permissionSystemExtension },\n\t{ id: \"gpt-apply-patch\", factory: gptApplyPatchExtension },\n\t{ id: \"imagegen\", factory: imageGenExtension },\n\t// Follows imagegen so the native injector's bypass wiring observes the registered client tool.\n\t{ id: \"openai-image-gen\", factory: openaiImageGenExtension },\n\t{ id: \"prompt-preset\", factory: promptPresetExtension },\n\t{ id: \"todowrite\", factory: todowriteExtension },\n\t{ id: \"redraws\", factory: redrawsExtension },\n\t{ id: \"anthropic-web-search\", factory: anthropicWebSearchExtension },\n\t{ id: \"anthropic-bash\", factory: anthropicBashExtension },\n\t{ id: \"openai-web-search\", factory: openaiWebSearchExtension },\n\t{ id: \"service-tier\", factory: serviceTierExtension },\n\t// Sits beside service-tier: both are capability-aware model-control commands that only read\n\t// the active model and notify; neither mutates payloads, so relative order is not load-bearing.\n\t{ id: \"reasoning\", factory: reasoningExtension },\n\t{ id: \"model-fallback\", factory: modelFallbackExtension },\n\t{ id: \"recommended-models\", factory: recommendedModelsExtension },\n\t{ id: \"bash-timeout\", factory: bashTimeoutExtension },\n\t// Terminal follows bash-timeout so its injected default reaches the PTY bash, and follows\n\t// anthropic-bash so mutual-exclusion (companion step-aside) is evaluated after it registers.\n\t{ id: \"terminal\", factory: terminalExtension },\n\t{ id: \"tool-pair-guard\", factory: toolPairGuardExtension },\n\t{ id: \"compaction\", factory: compactionExtension },\n\t{ id: \"history-search\", factory: historySearchExtension },\n\t{ id: \"help\", factory: helpExtension },\n\t{ id: \"import-repro\", factory: importReproExtension },\n\t{ id: \"websearch\", factory: websearchExtension },\n\t{ id: \"webfetch\", factory: webfetchExtension },\n\t{ id: \"video-in\", factory: videoInExtension },\n\t{ id: \"look-at\", factory: lookAtExtension },\n\t{ id: \"nested-agents-md\", factory: nestedAgentsMdExtension },\n\t{ id: \"rules\", factory: piRulesExtension },\n\t{ id: \"goal\", factory: goalExtension },\n\t{ id: \"cache-keepalive\", factory: cacheKeepAliveExtension },\n\t{ id: \"ttsr\", factory: ttsrExtension },\n\t{ id: \"btw\", factory: btwExtension },\n\t{ id: \"claude-sdk-oauth\", factory: claudeSdkOauthExtension },\n\t// Registers unconditionally and reports executable/auth state through its oauth check, so it stays beside the other provider lane.\n\t{ id: \"cursor-cli-oauth\", factory: cursorCliOauthExtension },\n\t// Config reload follows settings-dependent builtins so reloads rebuild their resolved settings before catalog feeders observe them.\n\t{ id: \"config-reload\", factory: configReloadExtension },\n\t// Shared catalog wiring loads before MCP, which feeds its tools into the shared catalog as the final builtin.\n\t{ id: \"tool-search\", factory: toolSearchExtension },\n\t// Keep MCP last so its eventual provider-payload tap observes all co-resident builtin mutations.\n\t{ id: \"mcp\", factory: mcpExtension },\n];\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/core/extensions/builtin/index.ts"],"names":[],"mappings":"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","sourcesContent":["import type { ExtensionFactory } from \"../types.ts\";\nimport anthropicBashExtension from \"./anthropic-bash/index.ts\";\nimport anthropicWebSearchExtension from \"./anthropic-web-search/index.ts\";\nimport bashTimeoutExtension from \"./bash-timeout/index.ts\";\nimport btwExtension from \"./btw/index.ts\";\nimport cacheKeepAliveExtension from \"./cache-keepalive/index.ts\";\nimport claudeSdkOauthExtension from \"./claude-sdk-oauth/index.ts\";\nimport compactionExtension from \"./compaction/index.ts\";\nimport configReloadExtension from \"./config-reload/index.ts\";\nimport cursorCliOauthExtension from \"./cursor-cli-oauth/index.ts\";\nimport diffExtension from \"./diff.ts\";\nimport filesExtension from \"./files.ts\";\nimport goalExtension from \"./goal/index.ts\";\nimport gptApplyPatchExtension from \"./gpt-apply-patch/index.ts\";\nimport helpExtension from \"./help/index.ts\";\nimport historySearchExtension from \"./history-search/index.ts\";\nimport hooksExtension from \"./hooks/index.ts\";\nimport imageGenExtension from \"./imagegen/index.ts\";\nimport importReproExtension from \"./import-repro.ts\";\nimport lookAtExtension from \"./look-at/index.ts\";\nimport loopExtension from \"./loop/index.ts\";\nimport loopGuardExtension from \"./loop-guard/index.ts\";\nimport mcpExtension from \"./mcp/index.ts\";\nimport modelFallbackExtension from \"./model-fallback/index.ts\";\nimport nestedAgentsMdExtension from \"./nested-agents-md/index.ts\";\nimport openaiImageGenExtension from \"./openai-image-gen/index.ts\";\nimport openaiWebSearchExtension from \"./openai-web-search/index.ts\";\nimport permissionSystemExtension from \"./permission-system/index.ts\";\nimport promptPresetExtension from \"./prompt-preset/index.ts\";\nimport promptUrlWidgetExtension from \"./prompt-url-widget.ts\";\nimport reasoningExtension from \"./reasoning/index.ts\";\nimport recommendedModelsExtension from \"./recommended-models/index.ts\";\nimport redrawsExtension from \"./redraws.ts\";\nimport piRulesExtension from \"./rules/index.ts\";\nimport serviceTierExtension from \"./service-tier.ts\";\nimport terminalExtension from \"./terminal/index.ts\";\nimport todowriteExtension from \"./todotools/index.ts\";\nimport toolPairGuardExtension from \"./tool-pair-guard/index.ts\";\nimport toolSearchExtension from \"./tool-search/index.ts\";\nimport tpsExtension from \"./tps.ts\";\nimport ttsrExtension from \"./ttsr/index.ts\";\nimport videoInExtension from \"./video-in/index.ts\";\nimport webfetchExtension from \"./webfetch/index.ts\";\nimport websearchExtension from \"./websearch/index.ts\";\n\nexport interface BuiltinExtensionFactory {\n\tid: string;\n\tfactory: ExtensionFactory;\n}\n\nexport const globalDefaultExtensionIds = [\"diff\", \"files\", \"prompt-url-widget\", \"tps\"] as const;\n\nexport const globalDefaultExtensionFactories = {\n\tdiff: diffExtension,\n\tfiles: filesExtension,\n\t\"prompt-url-widget\": promptUrlWidgetExtension,\n\ttps: tpsExtension,\n} satisfies Record<(typeof globalDefaultExtensionIds)[number], ExtensionFactory>;\n\nexport const builtinExtensions: BuiltinExtensionFactory[] = [\n\t// Loop guard owns the first veto opportunity so repeated calls never re-run hooks or permission prompts.\n\t{ id: \"loop-guard\", factory: loopGuardExtension },\n\t{ id: \"hooks\", factory: hooksExtension },\n\t{ id: \"permission-system\", factory: permissionSystemExtension },\n\t{ id: \"gpt-apply-patch\", factory: gptApplyPatchExtension },\n\t{ id: \"imagegen\", factory: imageGenExtension },\n\t// Follows imagegen so the native injector's bypass wiring observes the registered client tool.\n\t{ id: \"openai-image-gen\", factory: openaiImageGenExtension },\n\t{ id: \"prompt-preset\", factory: promptPresetExtension },\n\t{ id: \"todowrite\", factory: todowriteExtension },\n\t{ id: \"redraws\", factory: redrawsExtension },\n\t{ id: \"anthropic-web-search\", factory: anthropicWebSearchExtension },\n\t{ id: \"anthropic-bash\", factory: anthropicBashExtension },\n\t{ id: \"openai-web-search\", factory: openaiWebSearchExtension },\n\t{ id: \"service-tier\", factory: serviceTierExtension },\n\t// Sits beside service-tier: both are capability-aware model-control commands that only read\n\t// the active model and notify; neither mutates payloads, so relative order is not load-bearing.\n\t{ id: \"reasoning\", factory: reasoningExtension },\n\t{ id: \"model-fallback\", factory: modelFallbackExtension },\n\t{ id: \"recommended-models\", factory: recommendedModelsExtension },\n\t{ id: \"bash-timeout\", factory: bashTimeoutExtension },\n\t// Terminal follows bash-timeout so its injected default reaches the PTY bash, and follows\n\t// anthropic-bash so mutual-exclusion (companion step-aside) is evaluated after it registers.\n\t{ id: \"terminal\", factory: terminalExtension },\n\t{ id: \"tool-pair-guard\", factory: toolPairGuardExtension },\n\t{ id: \"compaction\", factory: compactionExtension },\n\t{ id: \"history-search\", factory: historySearchExtension },\n\t{ id: \"help\", factory: helpExtension },\n\t{ id: \"import-repro\", factory: importReproExtension },\n\t{ id: \"websearch\", factory: websearchExtension },\n\t{ id: \"webfetch\", factory: webfetchExtension },\n\t{ id: \"video-in\", factory: videoInExtension },\n\t{ id: \"look-at\", factory: lookAtExtension },\n\t{ id: \"nested-agents-md\", factory: nestedAgentsMdExtension },\n\t{ id: \"rules\", factory: piRulesExtension },\n\t{ id: \"goal\", factory: goalExtension },\n\t{ id: \"loop\", factory: loopExtension },\n\t{ id: \"cache-keepalive\", factory: cacheKeepAliveExtension },\n\t{ id: \"ttsr\", factory: ttsrExtension },\n\t{ id: \"btw\", factory: btwExtension },\n\t{ id: \"claude-sdk-oauth\", factory: claudeSdkOauthExtension },\n\t// Registers unconditionally and reports executable/auth state through its oauth check, so it stays beside the other provider lane.\n\t{ id: \"cursor-cli-oauth\", factory: cursorCliOauthExtension },\n\t// Config reload follows settings-dependent builtins so reloads rebuild their resolved settings before catalog feeders observe them.\n\t{ id: \"config-reload\", factory: configReloadExtension },\n\t// Shared catalog wiring loads before MCP, which feeds its tools into the shared catalog as the final builtin.\n\t{ id: \"tool-search\", factory: toolSearchExtension },\n\t// Keep MCP last so its eventual provider-payload tap observes all co-resident builtin mutations.\n\t{ id: \"mcp\", factory: mcpExtension },\n];\n"]}

package/dist/core/extensions/builtin/loop/command-registration.d.ts

@@ -0,0 +1,7 @@
+/**
+ * `/loop` command registration: metadata, argument hint, and subcommand completions.
+ */
+import type { ExtensionAPI } from "../../types.ts";
+import { type LoopCommandDeps } from "./command.ts";
+export declare function registerLoopCommand(pi: ExtensionAPI, deps: LoopCommandDeps): void;
+//# sourceMappingURL=command-registration.d.ts.map

package/dist/core/extensions/builtin/loop/command-registration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"command-registration.d.ts","sourceRoot":"","sources":["../../../../../src/core/extensions/builtin/loop/command-registration.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,EAIN,KAAK,eAAe,EAEpB,MAAM,cAAc,CAAC;AAEtB,wBAAgB,mBAAmB,CAAC,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE,eAAe,GAAG,IAAI,CAOjF"}

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

@@ -0,0 +1,13 @@
+/**
+ * `/loop` command registration: metadata, argument hint, and subcommand completions.
+ */
+import { completeLoopArguments, LOOP_ARGUMENT_HINT, LOOP_COMMAND_DESCRIPTION, runLoopCommand, } from "./command.js";
+export function registerLoopCommand(pi, deps) {
+    pi.registerCommand("loop", {
+        description: LOOP_COMMAND_DESCRIPTION,
+        argumentHint: LOOP_ARGUMENT_HINT,
+        getArgumentCompletions: completeLoopArguments,
+        handler: (rawArgs, ctx) => runLoopCommand(rawArgs, ctx, deps),
+    });
+}
+//# sourceMappingURL=command-registration.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"command-registration.js","sourceRoot":"","sources":["../../../../../src/core/extensions/builtin/loop/command-registration.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EACN,qBAAqB,EACrB,kBAAkB,EAClB,wBAAwB,EAExB,cAAc,GACd,MAAM,cAAc,CAAC;AAEtB,MAAM,UAAU,mBAAmB,CAAC,EAAgB,EAAE,IAAqB;IAC1E,EAAE,CAAC,eAAe,CAAC,MAAM,EAAE;QAC1B,WAAW,EAAE,wBAAwB;QACrC,YAAY,EAAE,kBAAkB;QAChC,sBAAsB,EAAE,qBAAqB;QAC7C,OAAO,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE,EAAE,CAAC,cAAc,CAAC,OAAO,EAAE,GAAG,EAAE,IAAI,CAAC;KAC7D,CAAC,CAAC;AACJ,CAAC","sourcesContent":["/**\n * `/loop` command registration: metadata, argument hint, and subcommand completions.\n */\n\nimport type { ExtensionAPI } from \"../../types.ts\";\nimport {\n\tcompleteLoopArguments,\n\tLOOP_ARGUMENT_HINT,\n\tLOOP_COMMAND_DESCRIPTION,\n\ttype LoopCommandDeps,\n\trunLoopCommand,\n} from \"./command.ts\";\n\nexport function registerLoopCommand(pi: ExtensionAPI, deps: LoopCommandDeps): void {\n\tpi.registerCommand(\"loop\", {\n\t\tdescription: LOOP_COMMAND_DESCRIPTION,\n\t\targumentHint: LOOP_ARGUMENT_HINT,\n\t\tgetArgumentCompletions: completeLoopArguments,\n\t\thandler: (rawArgs, ctx) => runLoopCommand(rawArgs, ctx, deps),\n\t});\n}\n"]}

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

@@ -0,0 +1,41 @@
+/**
+ * `/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 type { ExtensionCommandContext } from "../../types.ts";
+import type { LoopController, LoopCreateOk } from "./index.ts";
+import type { CronEntry, LoopState } from "./types.ts";
+export declare const LOOP_ARGUMENT_HINT = "[interval] [prompt] | stop [id|all] | status | pause | resume";
+export declare const LOOP_COMMAND_DESCRIPTION = "Repeat a prompt on a fixed interval or a self-paced schedule (e.g. /loop 5m check the deploy)";
+export interface LoopCommandDeps {
+    readonly controller: LoopController;
+}
+/**
+ * Argument completions for the subcommand keywords, modeled on the todo extension's
+ * verb completions: prefix-filtered, `null` when nothing matches.
+ */
+export declare function completeLoopArguments(argumentPrefix: string): Array<{
+    value: string;
+    label: string;
+}> | null;
+/** Fixed-loop confirmation: id, cron, effective cadence, rounding notice, expiry, stop command. */
+export declare function formatFixedLoopConfirmation(outcome: LoopCreateOk, requestedRaw: string): string;
+/** Dynamic-loop confirmation, including the supersession line when one replaced another. */
+export declare function formatDynamicLoopConfirmation(outcome: LoopCreateOk): string;
+/** Bare-invocation confirmation; the mode comes from the entry the controller created. */
+export declare function formatBareLoopConfirmation(outcome: LoopCreateOk, entry: CronEntry | undefined): string;
+/**
+ * The `/loop status` listing: the live status line (countdown + stop affordance) plus
+ * one row per active loop.
+ */
+export declare function formatLoopStatusListing(statusLine: string | undefined, state: LoopState): string;
+/** The `/loop` command entry point. */
+export declare function runLoopCommand(rawArgs: string, ctx: ExtensionCommandContext, deps: LoopCommandDeps): Promise<void>;
+//# sourceMappingURL=command.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"command.d.ts","sourceRoot":"","sources":["../../../../../src/core/extensions/builtin/loop/command.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,gBAAgB,CAAC;AAC9D,OAAO,KAAK,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE/D,OAAO,KAAK,EAAE,SAAS,EAAU,SAAS,EAAE,MAAM,YAAY,CAAC;AAE/D,eAAO,MAAM,kBAAkB,kEAAkE,CAAC;AAClG,eAAO,MAAM,wBAAwB,kGAC2D,CAAC;AAOjG,MAAM,WAAW,eAAe;IAC/B,QAAQ,CAAC,UAAU,EAAE,cAAc,CAAC;CACpC;AAOD;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,cAAc,EAAE,MAAM,GAAG,KAAK,CAAC;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC,GAAG,IAAI,CAK5G;AAMD,mGAAmG;AACnG,wBAAgB,2BAA2B,CAAC,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,GAAG,MAAM,CAU/F;AAED,4FAA4F;AAC5F,wBAAgB,6BAA6B,CAAC,OAAO,EAAE,YAAY,GAAG,MAAM,CAS3E;AAED,0FAA0F;AAC1F,wBAAgB,0BAA0B,CAAC,OAAO,EAAE,YAAY,EAAE,KAAK,EAAE,SAAS,GAAG,SAAS,GAAG,MAAM,CAOtG;AAWD;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,UAAU,EAAE,MAAM,GAAG,SAAS,EAAE,KAAK,EAAE,SAAS,GAAG,MAAM,CAOhG;AAsID,uCAAuC;AACvC,wBAAsB,cAAc,CACnC,OAAO,EAAE,MAAM,EACf,GAAG,EAAE,uBAAuB,EAC5B,IAAI,EAAE,eAAe,GACnB,OAAO,CAAC,IAAI,CAAC,CA6Ef"}

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":"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","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"}