@agimon-ai/doompi-loop 0.0.1-alpha.76 → 0.0.1-alpha.78

package/dist/src/schemas/loopLaunchers.cjs

@@ -0,0 +1,17 @@
+//#region src/schemas/loopLaunchers.ts
+/** Provider-owned Cordis service for session-scoped recurring-loop launchers. */
+const DOOM_LOOP_LAUNCHERS_SERVICE = "doom/loop-launchers";
+function readDoomLoopLaunchers(context) {
+	return context.get(DOOM_LOOP_LAUNCHERS_SERVICE);
+}
+function requireDoomLoopLaunchers(context) {
+	const service = readDoomLoopLaunchers(context);
+	if (!service) throw new Error("Doom loop launchers are unavailable. Load @agimon-ai/doompi-loop.");
+	return service;
+}
+//#endregion
+exports.DOOM_LOOP_LAUNCHERS_SERVICE = DOOM_LOOP_LAUNCHERS_SERVICE;
+exports.readDoomLoopLaunchers = readDoomLoopLaunchers;
+exports.requireDoomLoopLaunchers = requireDoomLoopLaunchers;
+
+//# sourceMappingURL=loopLaunchers.cjs.map

package/dist/src/schemas/loopLaunchers.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"loopLaunchers.cjs","names":[],"sources":["../../../src/schemas/loopLaunchers.ts"],"sourcesContent":["import type { Context } from '@deepseek-ai/cordis';\n\n/** Provider-owned Cordis service for session-scoped recurring-loop launchers. */\nexport const DOOM_LOOP_LAUNCHERS_SERVICE = 'doom/loop-launchers';\n\nexport interface LoopLaunchRequest {\n  readonly instanceId: string;\n  readonly signal: AbortSignal;\n}\n\nexport interface StoppableLoop {\n  readonly instanceId: string;\n  readonly label?: string;\n  readonly detail?: string;\n  stop(reason?: string): void | Promise<void>;\n}\n\nexport interface LoopLauncherSummary {\n  readonly id: string;\n  readonly source: string;\n  readonly label: string;\n  readonly description?: string;\n}\n\nexport interface LoopInstanceSnapshot {\n  readonly instanceId: string;\n  readonly launcherId: string;\n  readonly launcherLabel: string;\n  readonly label?: string;\n  readonly detail?: string;\n  readonly state: 'starting' | 'running' | 'stopping';\n  readonly startedAt?: string;\n}\n\nexport interface LoopLauncherDefinition extends LoopLauncherSummary {\n  launch(request: LoopLaunchRequest): Promise<StoppableLoop | undefined>;\n}\n\nexport interface LoopLauncherRegistration {\n  readonly id: string;\n  readonly generation: string;\n  dispose(reason?: string): Promise<void>;\n}\n\n/** Direct registrar/control seam owned and provided by doompi-loop. */\nexport interface DoomLoopLaunchersService {\n  readonly generation: string;\n  register(definition: LoopLauncherDefinition): LoopLauncherRegistration;\n  listLaunchers(): readonly LoopLauncherSummary[];\n  listInstances(): readonly LoopInstanceSnapshot[];\n  subscribe(listener: () => void): () => void;\n  launch(launcherId: string, options?: { instanceId?: string }): Promise<LoopInstanceSnapshot | undefined>;\n  stop(instanceId: string, reason?: string): Promise<boolean>;\n  stopAll(reason?: string): Promise<void>;\n  dispose(reason?: string): Promise<void>;\n}\n\ndeclare module '@deepseek-ai/cordis' {\n  interface Context {\n    'doom/loop-launchers': DoomLoopLaunchersService;\n  }\n}\n\nexport function readDoomLoopLaunchers(context: Context): DoomLoopLaunchersService | undefined {\n  return context.get(DOOM_LOOP_LAUNCHERS_SERVICE) as DoomLoopLaunchersService | undefined;\n}\n\nexport function requireDoomLoopLaunchers(context: Context): DoomLoopLaunchersService {\n  const service = readDoomLoopLaunchers(context);\n  if (!service) throw new Error('Doom loop launchers are unavailable. Load @agimon-ai/doompi-loop.');\n  return service;\n}\n"],"mappings":";;AAGA,MAAa,8BAA8B;AA4D3C,SAAgB,sBAAsB,SAAwD;CAC5F,OAAO,QAAQ,IAAI,2BAA2B;AAChD;AAEA,SAAgB,yBAAyB,SAA4C;CACnF,MAAM,UAAU,sBAAsB,OAAO;CAC7C,IAAI,CAAC,SAAS,MAAM,IAAI,MAAM,mEAAmE;CACjG,OAAO;AACT"}

package/dist/src/schemas/loopLaunchers.d.cts

@@ -0,0 +1,60 @@
+import { Context } from "@deepseek-ai/cordis";
+//#region src/schemas/loopLaunchers.d.ts
+/** Provider-owned Cordis service for session-scoped recurring-loop launchers. */
+export declare const DOOM_LOOP_LAUNCHERS_SERVICE = "doom/loop-launchers";
+export interface LoopLaunchRequest {
+  readonly instanceId: string;
+  readonly signal: AbortSignal;
+}
+export interface StoppableLoop {
+  readonly instanceId: string;
+  readonly label?: string;
+  readonly detail?: string;
+  stop(reason?: string): void | Promise<void>;
+}
+export interface LoopLauncherSummary {
+  readonly id: string;
+  readonly source: string;
+  readonly label: string;
+  readonly description?: string;
+}
+export interface LoopInstanceSnapshot {
+  readonly instanceId: string;
+  readonly launcherId: string;
+  readonly launcherLabel: string;
+  readonly label?: string;
+  readonly detail?: string;
+  readonly state: 'starting' | 'running' | 'stopping';
+  readonly startedAt?: string;
+}
+export interface LoopLauncherDefinition extends LoopLauncherSummary {
+  launch(request: LoopLaunchRequest): Promise<StoppableLoop | undefined>;
+}
+export interface LoopLauncherRegistration {
+  readonly id: string;
+  readonly generation: string;
+  dispose(reason?: string): Promise<void>;
+}
+/** Direct registrar/control seam owned and provided by doompi-loop. */
+export interface DoomLoopLaunchersService {
+  readonly generation: string;
+  register(definition: LoopLauncherDefinition): LoopLauncherRegistration;
+  listLaunchers(): readonly LoopLauncherSummary[];
+  listInstances(): readonly LoopInstanceSnapshot[];
+  subscribe(listener: () => void): () => void;
+  launch(launcherId: string, options?: {
+    instanceId?: string;
+  }): Promise<LoopInstanceSnapshot | undefined>;
+  stop(instanceId: string, reason?: string): Promise<boolean>;
+  stopAll(reason?: string): Promise<void>;
+  dispose(reason?: string): Promise<void>;
+}
+declare module '@deepseek-ai/cordis' {
+  interface Context {
+    'doom/loop-launchers': DoomLoopLaunchersService;
+  }
+}
+export declare function readDoomLoopLaunchers(context: Context): DoomLoopLaunchersService | undefined;
+export declare function requireDoomLoopLaunchers(context: Context): DoomLoopLaunchersService;
+//#endregion
+//# sourceMappingURL=loopLaunchers.d.cts.map

package/dist/src/schemas/loopLaunchers.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loopLaunchers.d.cts","names":[],"sources":["../../../src/schemas/loopLaunchers.ts"],"mappings":";;;qBAGa;iBAEI;WACN;WACA,QAAQ;;iBAGF;WACN;WACA;WACA;EACT,KAAK,yBAAyB;;iBAGf;WACN;WACA;WACA;WACA;;iBAGM;WACN;WACA;WACA;WACA;WACA;WACA;WACA;;iBAGM,+BAA+B;EAC9C,OAAO,SAAS,oBAAoB,QAAQ;;iBAG7B;WACN;WACA;EACT,QAAQ,kBAAkB;;;iBAIX;WACN;EACT,SAAS,YAAY,yBAAyB;EAC9C,0BAA0B;EAC1B,0BAA0B;EAC1B,UAAU;EACV,OAAO,oBAAoB;IAAY;MAAwB,QAAQ;EACvE,KAAK,oBAAoB,kBAAkB;EAC3C,QAAQ,kBAAkB;EAC1B,QAAQ,kBAAkB;;;YAIhB;IACR,uBAAuB;;;wBAIX,sBAAsB,SAAS,UAAU;wBAIzC,yBAAyB,SAAS,UAAU"}

package/dist/src/schemas/loopLaunchers.d.mts

@@ -0,0 +1,60 @@
+import { Context } from "@deepseek-ai/cordis";
+//#region src/schemas/loopLaunchers.d.ts
+/** Provider-owned Cordis service for session-scoped recurring-loop launchers. */
+export declare const DOOM_LOOP_LAUNCHERS_SERVICE = "doom/loop-launchers";
+export interface LoopLaunchRequest {
+  readonly instanceId: string;
+  readonly signal: AbortSignal;
+}
+export interface StoppableLoop {
+  readonly instanceId: string;
+  readonly label?: string;
+  readonly detail?: string;
+  stop(reason?: string): void | Promise<void>;
+}
+export interface LoopLauncherSummary {
+  readonly id: string;
+  readonly source: string;
+  readonly label: string;
+  readonly description?: string;
+}
+export interface LoopInstanceSnapshot {
+  readonly instanceId: string;
+  readonly launcherId: string;
+  readonly launcherLabel: string;
+  readonly label?: string;
+  readonly detail?: string;
+  readonly state: 'starting' | 'running' | 'stopping';
+  readonly startedAt?: string;
+}
+export interface LoopLauncherDefinition extends LoopLauncherSummary {
+  launch(request: LoopLaunchRequest): Promise<StoppableLoop | undefined>;
+}
+export interface LoopLauncherRegistration {
+  readonly id: string;
+  readonly generation: string;
+  dispose(reason?: string): Promise<void>;
+}
+/** Direct registrar/control seam owned and provided by doompi-loop. */
+export interface DoomLoopLaunchersService {
+  readonly generation: string;
+  register(definition: LoopLauncherDefinition): LoopLauncherRegistration;
+  listLaunchers(): readonly LoopLauncherSummary[];
+  listInstances(): readonly LoopInstanceSnapshot[];
+  subscribe(listener: () => void): () => void;
+  launch(launcherId: string, options?: {
+    instanceId?: string;
+  }): Promise<LoopInstanceSnapshot | undefined>;
+  stop(instanceId: string, reason?: string): Promise<boolean>;
+  stopAll(reason?: string): Promise<void>;
+  dispose(reason?: string): Promise<void>;
+}
+declare module '@deepseek-ai/cordis' {
+  interface Context {
+    'doom/loop-launchers': DoomLoopLaunchersService;
+  }
+}
+export declare function readDoomLoopLaunchers(context: Context): DoomLoopLaunchersService | undefined;
+export declare function requireDoomLoopLaunchers(context: Context): DoomLoopLaunchersService;
+//#endregion
+//# sourceMappingURL=loopLaunchers.d.mts.map

package/dist/src/schemas/loopLaunchers.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loopLaunchers.d.mts","names":[],"sources":["../../../src/schemas/loopLaunchers.ts"],"mappings":";;;qBAGa;iBAEI;WACN;WACA,QAAQ;;iBAGF;WACN;WACA;WACA;EACT,KAAK,yBAAyB;;iBAGf;WACN;WACA;WACA;WACA;;iBAGM;WACN;WACA;WACA;WACA;WACA;WACA;WACA;;iBAGM,+BAA+B;EAC9C,OAAO,SAAS,oBAAoB,QAAQ;;iBAG7B;WACN;WACA;EACT,QAAQ,kBAAkB;;;iBAIX;WACN;EACT,SAAS,YAAY,yBAAyB;EAC9C,0BAA0B;EAC1B,0BAA0B;EAC1B,UAAU;EACV,OAAO,oBAAoB;IAAY;MAAwB,QAAQ;EACvE,KAAK,oBAAoB,kBAAkB;EAC3C,QAAQ,kBAAkB;EAC1B,QAAQ,kBAAkB;;;YAIhB;IACR,uBAAuB;;;wBAIX,sBAAsB,SAAS,UAAU;wBAIzC,yBAAyB,SAAS,UAAU"}

package/dist/src/schemas/loopLaunchers.mjs

@@ -0,0 +1,15 @@
+//#region src/schemas/loopLaunchers.ts
+/** Provider-owned Cordis service for session-scoped recurring-loop launchers. */
+const DOOM_LOOP_LAUNCHERS_SERVICE = "doom/loop-launchers";
+function readDoomLoopLaunchers(context) {
+	return context.get(DOOM_LOOP_LAUNCHERS_SERVICE);
+}
+function requireDoomLoopLaunchers(context) {
+	const service = readDoomLoopLaunchers(context);
+	if (!service) throw new Error("Doom loop launchers are unavailable. Load @agimon-ai/doompi-loop.");
+	return service;
+}
+//#endregion
+export { DOOM_LOOP_LAUNCHERS_SERVICE, readDoomLoopLaunchers, requireDoomLoopLaunchers };
+
+//# sourceMappingURL=loopLaunchers.mjs.map

package/dist/src/schemas/loopLaunchers.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"loopLaunchers.mjs","names":[],"sources":["../../../src/schemas/loopLaunchers.ts"],"sourcesContent":["import type { Context } from '@deepseek-ai/cordis';\n\n/** Provider-owned Cordis service for session-scoped recurring-loop launchers. */\nexport const DOOM_LOOP_LAUNCHERS_SERVICE = 'doom/loop-launchers';\n\nexport interface LoopLaunchRequest {\n  readonly instanceId: string;\n  readonly signal: AbortSignal;\n}\n\nexport interface StoppableLoop {\n  readonly instanceId: string;\n  readonly label?: string;\n  readonly detail?: string;\n  stop(reason?: string): void | Promise<void>;\n}\n\nexport interface LoopLauncherSummary {\n  readonly id: string;\n  readonly source: string;\n  readonly label: string;\n  readonly description?: string;\n}\n\nexport interface LoopInstanceSnapshot {\n  readonly instanceId: string;\n  readonly launcherId: string;\n  readonly launcherLabel: string;\n  readonly label?: string;\n  readonly detail?: string;\n  readonly state: 'starting' | 'running' | 'stopping';\n  readonly startedAt?: string;\n}\n\nexport interface LoopLauncherDefinition extends LoopLauncherSummary {\n  launch(request: LoopLaunchRequest): Promise<StoppableLoop | undefined>;\n}\n\nexport interface LoopLauncherRegistration {\n  readonly id: string;\n  readonly generation: string;\n  dispose(reason?: string): Promise<void>;\n}\n\n/** Direct registrar/control seam owned and provided by doompi-loop. */\nexport interface DoomLoopLaunchersService {\n  readonly generation: string;\n  register(definition: LoopLauncherDefinition): LoopLauncherRegistration;\n  listLaunchers(): readonly LoopLauncherSummary[];\n  listInstances(): readonly LoopInstanceSnapshot[];\n  subscribe(listener: () => void): () => void;\n  launch(launcherId: string, options?: { instanceId?: string }): Promise<LoopInstanceSnapshot | undefined>;\n  stop(instanceId: string, reason?: string): Promise<boolean>;\n  stopAll(reason?: string): Promise<void>;\n  dispose(reason?: string): Promise<void>;\n}\n\ndeclare module '@deepseek-ai/cordis' {\n  interface Context {\n    'doom/loop-launchers': DoomLoopLaunchersService;\n  }\n}\n\nexport function readDoomLoopLaunchers(context: Context): DoomLoopLaunchersService | undefined {\n  return context.get(DOOM_LOOP_LAUNCHERS_SERVICE) as DoomLoopLaunchersService | undefined;\n}\n\nexport function requireDoomLoopLaunchers(context: Context): DoomLoopLaunchersService {\n  const service = readDoomLoopLaunchers(context);\n  if (!service) throw new Error('Doom loop launchers are unavailable. Load @agimon-ai/doompi-loop.');\n  return service;\n}\n"],"mappings":";;AAGA,MAAa,8BAA8B;AA4D3C,SAAgB,sBAAsB,SAAwD;CAC5F,OAAO,QAAQ,IAAI,2BAA2B;AAChD;AAEA,SAAgB,yBAAyB,SAA4C;CACnF,MAAM,UAAU,sBAAsB,OAAO;CAC7C,IAAI,CAAC,SAAS,MAAM,IAAI,MAAM,mEAAmE;CACjG,OAAO;AACT"}

package/dist/src/services/defaultLoopLauncher/index.cjs

@@ -0,0 +1,92 @@
+const require_piLoop = require("../../constants/piLoop.cjs");
+//#region src/services/defaultLoopLauncher/index.ts
+const DEFAULT_LAUNCHER_ID = "doompi.default";
+const DEFAULT_INTERVAL_SECONDS = 300;
+const MIN_INTERVAL_SECONDS = 30;
+const MAX_INTERVAL_SECONDS = 3600;
+const MILLISECONDS_PER_SECOND = 1e3;
+const PROMPT_PREVIEW_LENGTH = 80;
+function intervalError(raw) {
+	const seconds = Number(raw);
+	if (!Number.isInteger(seconds)) return `Interval must be a whole number of seconds, got ${raw}.`;
+	if (seconds < MIN_INTERVAL_SECONDS || seconds > MAX_INTERVAL_SECONDS) return `Interval must be between ${MIN_INTERVAL_SECONDS} and ${MAX_INTERVAL_SECONDS} seconds.`;
+}
+async function prepareDefaultLoop(ui, signal) {
+	const prompt = (await ui.editor("Loop prompt", ""))?.trim();
+	if (!prompt || signal.aborted) return void 0;
+	const rawInterval = await ui.input("Loop interval in seconds", `Default: ${DEFAULT_INTERVAL_SECONDS}s`);
+	if (rawInterval === void 0 || signal.aborted) return void 0;
+	const normalizedInterval = rawInterval.trim() || String(DEFAULT_INTERVAL_SECONDS);
+	const error = intervalError(normalizedInterval);
+	if (error) {
+		ui.notify(error, require_piLoop.NOTIFY_WARNING_LEVEL);
+		return;
+	}
+	return {
+		prompt,
+		intervalSeconds: Number(normalizedInterval)
+	};
+}
+function promptPreview(prompt) {
+	const oneLine = prompt.replaceAll(/\s+/gu, " ").trim();
+	return oneLine.length > PROMPT_PREVIEW_LENGTH ? `${oneLine.slice(0, 79)}…` : oneLine;
+}
+function createDefaultLoopLauncher(pi) {
+	const pending = /* @__PURE__ */ new Set();
+	const requestPass = (loop) => {
+		if (loop.stopped) return;
+		if (!loop.context.isIdle()) {
+			pending.add(loop);
+			return;
+		}
+		pending.delete(loop);
+		try {
+			pi.sendUserMessage(loop.prompt);
+		} catch (error) {
+			loop.context.ui.notify(`Default loop pass could not start: ${error instanceof Error ? error.message : String(error)}`, require_piLoop.NOTIFY_WARNING_LEVEL);
+		}
+	};
+	const onAgentSettled = () => {
+		const next = pending.values().next().value;
+		if (next) requestPass(next);
+	};
+	return {
+		onAgentSettled,
+		register(ctx, launchers) {
+			return launchers.register({
+				id: DEFAULT_LAUNCHER_ID,
+				source: require_piLoop.PACKAGE_SOURCE,
+				label: "Default loop",
+				description: "Run your own prompt in this session on an interval",
+				async launch({ instanceId, signal }) {
+					const prepared = await prepareDefaultLoop(ctx.ui, signal);
+					if (!prepared || signal.aborted) return void 0;
+					const loop = {
+						...prepared,
+						context: ctx,
+						stopped: false
+					};
+					loop.timer = setInterval(() => requestPass(loop), loop.intervalSeconds * MILLISECONDS_PER_SECOND);
+					loop.timer.unref?.();
+					requestPass(loop);
+					return {
+						instanceId,
+						label: "Default loop",
+						detail: `every ${loop.intervalSeconds}s · ${promptPreview(loop.prompt)}`,
+						stop() {
+							if (loop.stopped) return;
+							loop.stopped = true;
+							if (loop.timer) clearInterval(loop.timer);
+							loop.timer = void 0;
+							pending.delete(loop);
+						}
+					};
+				}
+			});
+		}
+	};
+}
+//#endregion
+exports.createDefaultLoopLauncher = createDefaultLoopLauncher;
+
+//# sourceMappingURL=index.cjs.map

package/dist/src/services/defaultLoopLauncher/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.cjs","names":["NOTIFY_WARNING_LEVEL","PACKAGE_SOURCE"],"sources":["../../../../src/services/defaultLoopLauncher/index.ts"],"sourcesContent":["import type { ExtensionAPI, ExtensionContext, ExtensionUIContext } from '@earendil-works/pi-coding-agent';\n\nimport { NOTIFY_WARNING_LEVEL, PACKAGE_SOURCE } from '../../constants/piLoop';\nimport type { DoomLoopLaunchersService, LoopLauncherRegistration, StoppableLoop } from '../../schemas/loopLaunchers';\n\nconst DEFAULT_LAUNCHER_ID = 'doompi.default';\nconst DEFAULT_INTERVAL_SECONDS = 300;\nconst MIN_INTERVAL_SECONDS = 30;\nconst MAX_INTERVAL_SECONDS = 3600;\nconst MILLISECONDS_PER_SECOND = 1000;\nconst PROMPT_PREVIEW_LENGTH = 80;\n\ninterface PreparedDefaultLoop {\n  readonly prompt: string;\n  readonly intervalSeconds: number;\n}\n\ninterface ActiveDefaultLoop extends PreparedDefaultLoop {\n  readonly context: ExtensionContext;\n  timer?: ReturnType<typeof setInterval>;\n  stopped: boolean;\n}\n\nexport interface DefaultLoopLauncher {\n  onAgentSettled(this: void): void;\n  register(ctx: ExtensionContext, launchers: DoomLoopLaunchersService): LoopLauncherRegistration;\n}\n\nfunction intervalError(raw: string): string | undefined {\n  const seconds = Number(raw);\n  if (!Number.isInteger(seconds)) return `Interval must be a whole number of seconds, got ${raw}.`;\n  if (seconds < MIN_INTERVAL_SECONDS || seconds > MAX_INTERVAL_SECONDS) {\n    return `Interval must be between ${MIN_INTERVAL_SECONDS} and ${MAX_INTERVAL_SECONDS} seconds.`;\n  }\n  return undefined;\n}\n\nasync function prepareDefaultLoop(\n  ui: ExtensionUIContext,\n  signal: AbortSignal,\n): Promise<PreparedDefaultLoop | undefined> {\n  const prompt = (await ui.editor('Loop prompt', ''))?.trim();\n  if (!prompt || signal.aborted) return undefined;\n\n  const rawInterval = await ui.input('Loop interval in seconds', `Default: ${DEFAULT_INTERVAL_SECONDS}s`);\n  if (rawInterval === undefined || signal.aborted) return undefined;\n  const normalizedInterval = rawInterval.trim() || String(DEFAULT_INTERVAL_SECONDS);\n  const error = intervalError(normalizedInterval);\n  if (error) {\n    ui.notify(error, NOTIFY_WARNING_LEVEL);\n    return undefined;\n  }\n\n  return { prompt, intervalSeconds: Number(normalizedInterval) };\n}\n\nfunction promptPreview(prompt: string): string {\n  const oneLine = prompt.replaceAll(/\\s+/gu, ' ').trim();\n  return oneLine.length > PROMPT_PREVIEW_LENGTH ? `${oneLine.slice(0, PROMPT_PREVIEW_LENGTH - 1)}…` : oneLine;\n}\n\nexport function createDefaultLoopLauncher(pi: Pick<ExtensionAPI, 'sendUserMessage'>): DefaultLoopLauncher {\n  const pending = new Set<ActiveDefaultLoop>();\n\n  const requestPass = (loop: ActiveDefaultLoop): void => {\n    if (loop.stopped) return;\n    if (!loop.context.isIdle()) {\n      pending.add(loop);\n      return;\n    }\n\n    pending.delete(loop);\n    try {\n      pi.sendUserMessage(loop.prompt);\n    } catch (error) {\n      loop.context.ui.notify(\n        `Default loop pass could not start: ${error instanceof Error ? error.message : String(error)}`,\n        NOTIFY_WARNING_LEVEL,\n      );\n    }\n  };\n\n  const onAgentSettled = (): void => {\n    const next = pending.values().next().value;\n    if (next) requestPass(next);\n  };\n\n  return {\n    onAgentSettled,\n    register(ctx, launchers) {\n      return launchers.register({\n        id: DEFAULT_LAUNCHER_ID,\n        source: PACKAGE_SOURCE,\n        label: 'Default loop',\n        description: 'Run your own prompt in this session on an interval',\n        async launch({ instanceId, signal }) {\n          const prepared = await prepareDefaultLoop(ctx.ui, signal);\n          if (!prepared || signal.aborted) return undefined;\n\n          const loop: ActiveDefaultLoop = { ...prepared, context: ctx, stopped: false };\n          loop.timer = setInterval(() => requestPass(loop), loop.intervalSeconds * MILLISECONDS_PER_SECOND);\n          loop.timer.unref?.();\n          requestPass(loop);\n\n          const handle: StoppableLoop = {\n            instanceId,\n            label: 'Default loop',\n            detail: `every ${loop.intervalSeconds}s · ${promptPreview(loop.prompt)}`,\n            stop() {\n              if (loop.stopped) return;\n              loop.stopped = true;\n              if (loop.timer) clearInterval(loop.timer);\n              loop.timer = undefined;\n              pending.delete(loop);\n            },\n          };\n          return handle;\n        },\n      });\n    },\n  };\n}\n"],"mappings":";;AAKA,MAAM,sBAAsB;AAC5B,MAAM,2BAA2B;AACjC,MAAM,uBAAuB;AAC7B,MAAM,uBAAuB;AAC7B,MAAM,0BAA0B;AAChC,MAAM,wBAAwB;AAkB9B,SAAS,cAAc,KAAiC;CACtD,MAAM,UAAU,OAAO,GAAG;CAC1B,IAAI,CAAC,OAAO,UAAU,OAAO,GAAG,OAAO,mDAAmD,IAAI;CAC9F,IAAI,UAAU,wBAAwB,UAAU,sBAC9C,OAAO,4BAA4B,qBAAqB,OAAO,qBAAqB;AAGxF;AAEA,eAAe,mBACb,IACA,QAC0C;CAC1C,MAAM,UAAU,MAAM,GAAG,OAAO,eAAe,EAAE,EAAA,EAAI,KAAK;CAC1D,IAAI,CAAC,UAAU,OAAO,SAAS,OAAO,KAAA;CAEtC,MAAM,cAAc,MAAM,GAAG,MAAM,4BAA4B,YAAY,yBAAyB,EAAE;CACtG,IAAI,gBAAgB,KAAA,KAAa,OAAO,SAAS,OAAO,KAAA;CACxD,MAAM,qBAAqB,YAAY,KAAK,KAAK,OAAO,wBAAwB;CAChF,MAAM,QAAQ,cAAc,kBAAkB;CAC9C,IAAI,OAAO;EACT,GAAG,OAAO,OAAOA,eAAAA,oBAAoB;EACrC;CACF;CAEA,OAAO;EAAE;EAAQ,iBAAiB,OAAO,kBAAkB;CAAE;AAC/D;AAEA,SAAS,cAAc,QAAwB;CAC7C,MAAM,UAAU,OAAO,WAAW,SAAS,GAAG,CAAC,CAAC,KAAK;CACrD,OAAO,QAAQ,SAAS,wBAAwB,GAAG,QAAQ,MAAM,GAAG,EAAyB,EAAE,KAAK;AACtG;AAEA,SAAgB,0BAA0B,IAAgE;CACxG,MAAM,0BAAU,IAAI,IAAuB;CAE3C,MAAM,eAAe,SAAkC;EACrD,IAAI,KAAK,SAAS;EAClB,IAAI,CAAC,KAAK,QAAQ,OAAO,GAAG;GAC1B,QAAQ,IAAI,IAAI;GAChB;EACF;EAEA,QAAQ,OAAO,IAAI;EACnB,IAAI;GACF,GAAG,gBAAgB,KAAK,MAAM;EAChC,SAAS,OAAO;GACd,KAAK,QAAQ,GAAG,OACd,sCAAsC,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK,KAC3FA,eAAAA,oBACF;EACF;CACF;CAEA,MAAM,uBAA6B;EACjC,MAAM,OAAO,QAAQ,OAAO,CAAC,CAAC,KAAK,CAAC,CAAC;EACrC,IAAI,MAAM,YAAY,IAAI;CAC5B;CAEA,OAAO;EACL;EACA,SAAS,KAAK,WAAW;GACvB,OAAO,UAAU,SAAS;IACxB,IAAI;IACJ,QAAQC,eAAAA;IACR,OAAO;IACP,aAAa;IACb,MAAM,OAAO,EAAE,YAAY,UAAU;KACnC,MAAM,WAAW,MAAM,mBAAmB,IAAI,IAAI,MAAM;KACxD,IAAI,CAAC,YAAY,OAAO,SAAS,OAAO,KAAA;KAExC,MAAM,OAA0B;MAAE,GAAG;MAAU,SAAS;MAAK,SAAS;KAAM;KAC5E,KAAK,QAAQ,kBAAkB,YAAY,IAAI,GAAG,KAAK,kBAAkB,uBAAuB;KAChG,KAAK,MAAM,QAAQ;KACnB,YAAY,IAAI;KAchB,OAAO;MAXL;MACA,OAAO;MACP,QAAQ,SAAS,KAAK,gBAAgB,MAAM,cAAc,KAAK,MAAM;MACrE,OAAO;OACL,IAAI,KAAK,SAAS;OAClB,KAAK,UAAU;OACf,IAAI,KAAK,OAAO,cAAc,KAAK,KAAK;OACxC,KAAK,QAAQ,KAAA;OACb,QAAQ,OAAO,IAAI;MACrB;KAEU;IACd;GACF,CAAC;EACH;CACF;AACF"}

package/dist/src/services/defaultLoopLauncher/index.mjs

@@ -0,0 +1,92 @@
+import { NOTIFY_WARNING_LEVEL, PACKAGE_SOURCE } from "../../constants/piLoop.mjs";
+//#region src/services/defaultLoopLauncher/index.ts
+const DEFAULT_LAUNCHER_ID = "doompi.default";
+const DEFAULT_INTERVAL_SECONDS = 300;
+const MIN_INTERVAL_SECONDS = 30;
+const MAX_INTERVAL_SECONDS = 3600;
+const MILLISECONDS_PER_SECOND = 1e3;
+const PROMPT_PREVIEW_LENGTH = 80;
+function intervalError(raw) {
+	const seconds = Number(raw);
+	if (!Number.isInteger(seconds)) return `Interval must be a whole number of seconds, got ${raw}.`;
+	if (seconds < MIN_INTERVAL_SECONDS || seconds > MAX_INTERVAL_SECONDS) return `Interval must be between ${MIN_INTERVAL_SECONDS} and ${MAX_INTERVAL_SECONDS} seconds.`;
+}
+async function prepareDefaultLoop(ui, signal) {
+	const prompt = (await ui.editor("Loop prompt", ""))?.trim();
+	if (!prompt || signal.aborted) return void 0;
+	const rawInterval = await ui.input("Loop interval in seconds", `Default: ${DEFAULT_INTERVAL_SECONDS}s`);
+	if (rawInterval === void 0 || signal.aborted) return void 0;
+	const normalizedInterval = rawInterval.trim() || String(DEFAULT_INTERVAL_SECONDS);
+	const error = intervalError(normalizedInterval);
+	if (error) {
+		ui.notify(error, NOTIFY_WARNING_LEVEL);
+		return;
+	}
+	return {
+		prompt,
+		intervalSeconds: Number(normalizedInterval)
+	};
+}
+function promptPreview(prompt) {
+	const oneLine = prompt.replaceAll(/\s+/gu, " ").trim();
+	return oneLine.length > PROMPT_PREVIEW_LENGTH ? `${oneLine.slice(0, 79)}…` : oneLine;
+}
+function createDefaultLoopLauncher(pi) {
+	const pending = /* @__PURE__ */ new Set();
+	const requestPass = (loop) => {
+		if (loop.stopped) return;
+		if (!loop.context.isIdle()) {
+			pending.add(loop);
+			return;
+		}
+		pending.delete(loop);
+		try {
+			pi.sendUserMessage(loop.prompt);
+		} catch (error) {
+			loop.context.ui.notify(`Default loop pass could not start: ${error instanceof Error ? error.message : String(error)}`, NOTIFY_WARNING_LEVEL);
+		}
+	};
+	const onAgentSettled = () => {
+		const next = pending.values().next().value;
+		if (next) requestPass(next);
+	};
+	return {
+		onAgentSettled,
+		register(ctx, launchers) {
+			return launchers.register({
+				id: DEFAULT_LAUNCHER_ID,
+				source: PACKAGE_SOURCE,
+				label: "Default loop",
+				description: "Run your own prompt in this session on an interval",
+				async launch({ instanceId, signal }) {
+					const prepared = await prepareDefaultLoop(ctx.ui, signal);
+					if (!prepared || signal.aborted) return void 0;
+					const loop = {
+						...prepared,
+						context: ctx,
+						stopped: false
+					};
+					loop.timer = setInterval(() => requestPass(loop), loop.intervalSeconds * MILLISECONDS_PER_SECOND);
+					loop.timer.unref?.();
+					requestPass(loop);
+					return {
+						instanceId,
+						label: "Default loop",
+						detail: `every ${loop.intervalSeconds}s · ${promptPreview(loop.prompt)}`,
+						stop() {
+							if (loop.stopped) return;
+							loop.stopped = true;
+							if (loop.timer) clearInterval(loop.timer);
+							loop.timer = void 0;
+							pending.delete(loop);
+						}
+					};
+				}
+			});
+		}
+	};
+}
+//#endregion
+export { createDefaultLoopLauncher };
+
+//# sourceMappingURL=index.mjs.map

package/dist/src/services/defaultLoopLauncher/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","names":[],"sources":["../../../../src/services/defaultLoopLauncher/index.ts"],"sourcesContent":["import type { ExtensionAPI, ExtensionContext, ExtensionUIContext } from '@earendil-works/pi-coding-agent';\n\nimport { NOTIFY_WARNING_LEVEL, PACKAGE_SOURCE } from '../../constants/piLoop';\nimport type { DoomLoopLaunchersService, LoopLauncherRegistration, StoppableLoop } from '../../schemas/loopLaunchers';\n\nconst DEFAULT_LAUNCHER_ID = 'doompi.default';\nconst DEFAULT_INTERVAL_SECONDS = 300;\nconst MIN_INTERVAL_SECONDS = 30;\nconst MAX_INTERVAL_SECONDS = 3600;\nconst MILLISECONDS_PER_SECOND = 1000;\nconst PROMPT_PREVIEW_LENGTH = 80;\n\ninterface PreparedDefaultLoop {\n  readonly prompt: string;\n  readonly intervalSeconds: number;\n}\n\ninterface ActiveDefaultLoop extends PreparedDefaultLoop {\n  readonly context: ExtensionContext;\n  timer?: ReturnType<typeof setInterval>;\n  stopped: boolean;\n}\n\nexport interface DefaultLoopLauncher {\n  onAgentSettled(this: void): void;\n  register(ctx: ExtensionContext, launchers: DoomLoopLaunchersService): LoopLauncherRegistration;\n}\n\nfunction intervalError(raw: string): string | undefined {\n  const seconds = Number(raw);\n  if (!Number.isInteger(seconds)) return `Interval must be a whole number of seconds, got ${raw}.`;\n  if (seconds < MIN_INTERVAL_SECONDS || seconds > MAX_INTERVAL_SECONDS) {\n    return `Interval must be between ${MIN_INTERVAL_SECONDS} and ${MAX_INTERVAL_SECONDS} seconds.`;\n  }\n  return undefined;\n}\n\nasync function prepareDefaultLoop(\n  ui: ExtensionUIContext,\n  signal: AbortSignal,\n): Promise<PreparedDefaultLoop | undefined> {\n  const prompt = (await ui.editor('Loop prompt', ''))?.trim();\n  if (!prompt || signal.aborted) return undefined;\n\n  const rawInterval = await ui.input('Loop interval in seconds', `Default: ${DEFAULT_INTERVAL_SECONDS}s`);\n  if (rawInterval === undefined || signal.aborted) return undefined;\n  const normalizedInterval = rawInterval.trim() || String(DEFAULT_INTERVAL_SECONDS);\n  const error = intervalError(normalizedInterval);\n  if (error) {\n    ui.notify(error, NOTIFY_WARNING_LEVEL);\n    return undefined;\n  }\n\n  return { prompt, intervalSeconds: Number(normalizedInterval) };\n}\n\nfunction promptPreview(prompt: string): string {\n  const oneLine = prompt.replaceAll(/\\s+/gu, ' ').trim();\n  return oneLine.length > PROMPT_PREVIEW_LENGTH ? `${oneLine.slice(0, PROMPT_PREVIEW_LENGTH - 1)}…` : oneLine;\n}\n\nexport function createDefaultLoopLauncher(pi: Pick<ExtensionAPI, 'sendUserMessage'>): DefaultLoopLauncher {\n  const pending = new Set<ActiveDefaultLoop>();\n\n  const requestPass = (loop: ActiveDefaultLoop): void => {\n    if (loop.stopped) return;\n    if (!loop.context.isIdle()) {\n      pending.add(loop);\n      return;\n    }\n\n    pending.delete(loop);\n    try {\n      pi.sendUserMessage(loop.prompt);\n    } catch (error) {\n      loop.context.ui.notify(\n        `Default loop pass could not start: ${error instanceof Error ? error.message : String(error)}`,\n        NOTIFY_WARNING_LEVEL,\n      );\n    }\n  };\n\n  const onAgentSettled = (): void => {\n    const next = pending.values().next().value;\n    if (next) requestPass(next);\n  };\n\n  return {\n    onAgentSettled,\n    register(ctx, launchers) {\n      return launchers.register({\n        id: DEFAULT_LAUNCHER_ID,\n        source: PACKAGE_SOURCE,\n        label: 'Default loop',\n        description: 'Run your own prompt in this session on an interval',\n        async launch({ instanceId, signal }) {\n          const prepared = await prepareDefaultLoop(ctx.ui, signal);\n          if (!prepared || signal.aborted) return undefined;\n\n          const loop: ActiveDefaultLoop = { ...prepared, context: ctx, stopped: false };\n          loop.timer = setInterval(() => requestPass(loop), loop.intervalSeconds * MILLISECONDS_PER_SECOND);\n          loop.timer.unref?.();\n          requestPass(loop);\n\n          const handle: StoppableLoop = {\n            instanceId,\n            label: 'Default loop',\n            detail: `every ${loop.intervalSeconds}s · ${promptPreview(loop.prompt)}`,\n            stop() {\n              if (loop.stopped) return;\n              loop.stopped = true;\n              if (loop.timer) clearInterval(loop.timer);\n              loop.timer = undefined;\n              pending.delete(loop);\n            },\n          };\n          return handle;\n        },\n      });\n    },\n  };\n}\n"],"mappings":";;AAKA,MAAM,sBAAsB;AAC5B,MAAM,2BAA2B;AACjC,MAAM,uBAAuB;AAC7B,MAAM,uBAAuB;AAC7B,MAAM,0BAA0B;AAChC,MAAM,wBAAwB;AAkB9B,SAAS,cAAc,KAAiC;CACtD,MAAM,UAAU,OAAO,GAAG;CAC1B,IAAI,CAAC,OAAO,UAAU,OAAO,GAAG,OAAO,mDAAmD,IAAI;CAC9F,IAAI,UAAU,wBAAwB,UAAU,sBAC9C,OAAO,4BAA4B,qBAAqB,OAAO,qBAAqB;AAGxF;AAEA,eAAe,mBACb,IACA,QAC0C;CAC1C,MAAM,UAAU,MAAM,GAAG,OAAO,eAAe,EAAE,EAAA,EAAI,KAAK;CAC1D,IAAI,CAAC,UAAU,OAAO,SAAS,OAAO,KAAA;CAEtC,MAAM,cAAc,MAAM,GAAG,MAAM,4BAA4B,YAAY,yBAAyB,EAAE;CACtG,IAAI,gBAAgB,KAAA,KAAa,OAAO,SAAS,OAAO,KAAA;CACxD,MAAM,qBAAqB,YAAY,KAAK,KAAK,OAAO,wBAAwB;CAChF,MAAM,QAAQ,cAAc,kBAAkB;CAC9C,IAAI,OAAO;EACT,GAAG,OAAO,OAAO,oBAAoB;EACrC;CACF;CAEA,OAAO;EAAE;EAAQ,iBAAiB,OAAO,kBAAkB;CAAE;AAC/D;AAEA,SAAS,cAAc,QAAwB;CAC7C,MAAM,UAAU,OAAO,WAAW,SAAS,GAAG,CAAC,CAAC,KAAK;CACrD,OAAO,QAAQ,SAAS,wBAAwB,GAAG,QAAQ,MAAM,GAAG,EAAyB,EAAE,KAAK;AACtG;AAEA,SAAgB,0BAA0B,IAAgE;CACxG,MAAM,0BAAU,IAAI,IAAuB;CAE3C,MAAM,eAAe,SAAkC;EACrD,IAAI,KAAK,SAAS;EAClB,IAAI,CAAC,KAAK,QAAQ,OAAO,GAAG;GAC1B,QAAQ,IAAI,IAAI;GAChB;EACF;EAEA,QAAQ,OAAO,IAAI;EACnB,IAAI;GACF,GAAG,gBAAgB,KAAK,MAAM;EAChC,SAAS,OAAO;GACd,KAAK,QAAQ,GAAG,OACd,sCAAsC,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK,KAC3F,oBACF;EACF;CACF;CAEA,MAAM,uBAA6B;EACjC,MAAM,OAAO,QAAQ,OAAO,CAAC,CAAC,KAAK,CAAC,CAAC;EACrC,IAAI,MAAM,YAAY,IAAI;CAC5B;CAEA,OAAO;EACL;EACA,SAAS,KAAK,WAAW;GACvB,OAAO,UAAU,SAAS;IACxB,IAAI;IACJ,QAAQ;IACR,OAAO;IACP,aAAa;IACb,MAAM,OAAO,EAAE,YAAY,UAAU;KACnC,MAAM,WAAW,MAAM,mBAAmB,IAAI,IAAI,MAAM;KACxD,IAAI,CAAC,YAAY,OAAO,SAAS,OAAO,KAAA;KAExC,MAAM,OAA0B;MAAE,GAAG;MAAU,SAAS;MAAK,SAAS;KAAM;KAC5E,KAAK,QAAQ,kBAAkB,YAAY,IAAI,GAAG,KAAK,kBAAkB,uBAAuB;KAChG,KAAK,MAAM,QAAQ;KACnB,YAAY,IAAI;KAchB,OAAO;MAXL;MACA,OAAO;MACP,QAAQ,SAAS,KAAK,gBAAgB,MAAM,cAAc,KAAK,MAAM;MACrE,OAAO;OACL,IAAI,KAAK,SAAS;OAClB,KAAK,UAAU;OACf,IAAI,KAAK,OAAO,cAAc,KAAK,KAAK;OACxC,KAAK,QAAQ,KAAA;OACb,QAAQ,OAAO,IAAI;MACrB;KAEU;IACd;GACF,CAAC;EACH;CACF;AACF"}

package/dist/src/services/loopCommand/index.cjs

@@ -0,0 +1,15 @@
+const require_loop = require("../../constants/loop.cjs");
+//#region src/services/loopCommand/index.ts
+function createLoopCommands(handlers) {
+	return [[require_loop.START_COMMAND_NAME, {
+		description: require_loop.START_COMMAND_DESCRIPTION,
+		handler: async (args, ctx) => handlers.start(ctx, args)
+	}], [require_loop.LIST_COMMAND_NAME, {
+		description: require_loop.LIST_COMMAND_DESCRIPTION,
+		handler: async (_args, ctx) => handlers.list(ctx)
+	}]];
+}
+//#endregion
+exports.createLoopCommands = createLoopCommands;
+
+//# sourceMappingURL=index.cjs.map

package/dist/src/services/loopCommand/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.cjs","names":["START_COMMAND_NAME","START_COMMAND_DESCRIPTION","LIST_COMMAND_NAME","LIST_COMMAND_DESCRIPTION"],"sources":["../../../../src/services/loopCommand/index.ts"],"sourcesContent":["import type { ExtensionAPI } from '@earendil-works/pi-coding-agent';\n\nimport { START_COMMAND_DESCRIPTION, LIST_COMMAND_DESCRIPTION } from '../../constants/loop';\nimport { LIST_COMMAND_NAME, START_COMMAND_NAME } from '../../constants/loop';\nimport type { LoopCommandHandlers } from '../../types/loopCommand';\nexport function createLoopCommands(\n  handlers: LoopCommandHandlers,\n): readonly (readonly [string, Parameters<ExtensionAPI['registerCommand']>[1]])[] {\n  return [\n    [\n      START_COMMAND_NAME,\n      {\n        description: START_COMMAND_DESCRIPTION,\n        handler: async (args, ctx) => handlers.start(ctx, args),\n      },\n    ],\n    [\n      LIST_COMMAND_NAME,\n      {\n        description: LIST_COMMAND_DESCRIPTION,\n        handler: async (_args, ctx) => handlers.list(ctx),\n      },\n    ],\n  ];\n}\n"],"mappings":";;AAKA,SAAgB,mBACd,UACgF;CAChF,OAAO,CACL,CACEA,aAAAA,oBACA;EACE,aAAaC,aAAAA;EACb,SAAS,OAAO,MAAM,QAAQ,SAAS,MAAM,KAAK,IAAI;CACxD,CACF,GACA,CACEC,aAAAA,mBACA;EACE,aAAaC,aAAAA;EACb,SAAS,OAAO,OAAO,QAAQ,SAAS,KAAK,GAAG;CAClD,CACF,CACF;AACF"}

package/dist/src/services/loopCommand/index.mjs

@@ -0,0 +1,15 @@
+import { LIST_COMMAND_DESCRIPTION, LIST_COMMAND_NAME, START_COMMAND_DESCRIPTION, START_COMMAND_NAME } from "../../constants/loop.mjs";
+//#region src/services/loopCommand/index.ts
+function createLoopCommands(handlers) {
+	return [[START_COMMAND_NAME, {
+		description: START_COMMAND_DESCRIPTION,
+		handler: async (args, ctx) => handlers.start(ctx, args)
+	}], [LIST_COMMAND_NAME, {
+		description: LIST_COMMAND_DESCRIPTION,
+		handler: async (_args, ctx) => handlers.list(ctx)
+	}]];
+}
+//#endregion
+export { createLoopCommands };
+
+//# sourceMappingURL=index.mjs.map

package/dist/src/services/loopCommand/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","names":[],"sources":["../../../../src/services/loopCommand/index.ts"],"sourcesContent":["import type { ExtensionAPI } from '@earendil-works/pi-coding-agent';\n\nimport { START_COMMAND_DESCRIPTION, LIST_COMMAND_DESCRIPTION } from '../../constants/loop';\nimport { LIST_COMMAND_NAME, START_COMMAND_NAME } from '../../constants/loop';\nimport type { LoopCommandHandlers } from '../../types/loopCommand';\nexport function createLoopCommands(\n  handlers: LoopCommandHandlers,\n): readonly (readonly [string, Parameters<ExtensionAPI['registerCommand']>[1]])[] {\n  return [\n    [\n      START_COMMAND_NAME,\n      {\n        description: START_COMMAND_DESCRIPTION,\n        handler: async (args, ctx) => handlers.start(ctx, args),\n      },\n    ],\n    [\n      LIST_COMMAND_NAME,\n      {\n        description: LIST_COMMAND_DESCRIPTION,\n        handler: async (_args, ctx) => handlers.list(ctx),\n      },\n    ],\n  ];\n}\n"],"mappings":";;AAKA,SAAgB,mBACd,UACgF;CAChF,OAAO,CACL,CACE,oBACA;EACE,aAAa;EACb,SAAS,OAAO,MAAM,QAAQ,SAAS,MAAM,KAAK,IAAI;CACxD,CACF,GACA,CACE,mBACA;EACE,aAAa;EACb,SAAS,OAAO,OAAO,QAAQ,SAAS,KAAK,GAAG;CAClD,CACF,CACF;AACF"}

package/dist/src/services/loopLaunchers/index.cjs

@@ -0,0 +1,180 @@
+//#region src/services/loopLaunchers/index.ts
+const MAX_ID_LENGTH = 256;
+const MAX_GENERATION_LENGTH = 256;
+const LAUNCHER_ID_LABEL = "loop launcher id";
+const INSTANCE_ID_LABEL = "loop instance id";
+function validId(value, label) {
+	const normalized = value.trim();
+	let hasControl = false;
+	for (const character of normalized) {
+		const code = character.codePointAt(0);
+		if (code !== void 0 && (code <= 31 || code === 127)) {
+			hasControl = true;
+			break;
+		}
+	}
+	if (!normalized || normalized.length > MAX_ID_LENGTH || hasControl) throw new Error(`Invalid ${label}.`);
+	return normalized;
+}
+function snapshot(entry) {
+	return {
+		instanceId: entry.instanceId,
+		launcherId: entry.launcher.definition.id,
+		launcherLabel: entry.launcher.definition.label,
+		...entry.handle?.label ? { label: entry.handle.label } : {},
+		...entry.handle?.detail ? { detail: entry.handle.detail } : {},
+		state: entry.state,
+		...entry.startedAt ? { startedAt: entry.startedAt } : {}
+	};
+}
+/** Creates the provider-owned launcher registry for one active Doom session. */
+function createDoomLoopLaunchersService({ generation, createInstanceId, timestamp }) {
+	if (!generation || generation.length > MAX_GENERATION_LENGTH) throw new TypeError("Doom loop launchers require a valid generation.");
+	const launchers = /* @__PURE__ */ new Map();
+	const instances = /* @__PURE__ */ new Map();
+	const listeners = /* @__PURE__ */ new Set();
+	let registrationSequence = 0;
+	let disposed = false;
+	const ensureActive = () => {
+		if (disposed) throw new Error("The Doom loop-launchers service is disposed.");
+	};
+	const notify = () => {
+		for (const listener of listeners) listener();
+	};
+	const stopEntry = async (entry, reason) => {
+		if (instances.get(entry.instanceId) !== entry) return;
+		entry.state = "stopping";
+		entry.abortController.abort(reason);
+		notify();
+		try {
+			await entry.handle?.stop(reason);
+		} finally {
+			if (instances.get(entry.instanceId) === entry) instances.delete(entry.instanceId);
+			notify();
+		}
+	};
+	return Object.freeze({
+		generation,
+		register(definition) {
+			ensureActive();
+			const id = validId(definition.id, LAUNCHER_ID_LABEL);
+			if (launchers.has(id)) throw new Error(`Loop launcher '${id}' is already registered.`);
+			const token = Symbol(id);
+			const entry = {
+				token,
+				definition: {
+					...definition,
+					id
+				}
+			};
+			launchers.set(id, entry);
+			registrationSequence += 1;
+			notify();
+			let registrationDisposed = false;
+			return Object.freeze({
+				id,
+				generation: `${generation}:launcher:${registrationSequence}`,
+				async dispose(reason = "Loop launcher disposed.") {
+					if (registrationDisposed) return;
+					registrationDisposed = true;
+					if (launchers.get(id)?.token !== token) return;
+					launchers.delete(id);
+					const owned = [...instances.values()].filter((instance) => instance.launcher.token === token);
+					await Promise.allSettled(owned.map((instance) => stopEntry(instance, reason)));
+					notify();
+				}
+			});
+		},
+		listLaunchers() {
+			ensureActive();
+			return [...launchers.values()].map(({ definition }) => ({
+				id: definition.id,
+				source: definition.source,
+				label: definition.label,
+				...definition.description ? { description: definition.description } : {}
+			})).sort((left, right) => left.label.localeCompare(right.label) || left.id.localeCompare(right.id));
+		},
+		listInstances() {
+			ensureActive();
+			return [...instances.values()].map(snapshot).sort((left, right) => left.instanceId.localeCompare(right.instanceId));
+		},
+		subscribe(listener) {
+			ensureActive();
+			listeners.add(listener);
+			let subscribed = true;
+			return () => {
+				if (!subscribed) return;
+				subscribed = false;
+				listeners.delete(listener);
+			};
+		},
+		async launch(launcherId, options) {
+			ensureActive();
+			const normalizedLauncherId = validId(launcherId, LAUNCHER_ID_LABEL);
+			const launcher = launchers.get(normalizedLauncherId);
+			if (!launcher) throw new Error(`Loop launcher '${normalizedLauncherId}' is unavailable.`);
+			const instanceId = validId(options?.instanceId ?? createInstanceId(), INSTANCE_ID_LABEL);
+			if (instances.has(instanceId)) throw new Error(`Loop instance '${instanceId}' already exists.`);
+			const entry = {
+				instanceId,
+				launcher,
+				abortController: new AbortController(),
+				state: "starting"
+			};
+			instances.set(instanceId, entry);
+			notify();
+			try {
+				const handle = await launcher.definition.launch({
+					instanceId,
+					signal: entry.abortController.signal
+				});
+				const active = !disposed && instances.get(instanceId) === entry && !entry.abortController.signal.aborted;
+				if (!handle) {
+					if (instances.get(instanceId) === entry) instances.delete(instanceId);
+					notify();
+					return;
+				}
+				if (!active || handle.instanceId !== instanceId) {
+					await handle.stop(active ? "Loop launcher returned a mismatched instance id." : "Loop launch was cancelled.");
+					if (instances.get(instanceId) === entry) instances.delete(instanceId);
+					notify();
+					if (active) throw new Error(`Loop launcher '${normalizedLauncherId}' returned a mismatched instance id.`);
+					return;
+				}
+				entry.handle = handle;
+				entry.state = "running";
+				entry.startedAt = timestamp();
+				notify();
+				return snapshot(entry);
+			} catch (error) {
+				const cancelled = entry.abortController.signal.aborted || disposed;
+				if (instances.get(instanceId) === entry) instances.delete(instanceId);
+				notify();
+				if (cancelled) return void 0;
+				throw error;
+			}
+		},
+		async stop(instanceId, reason) {
+			ensureActive();
+			const entry = instances.get(validId(instanceId, INSTANCE_ID_LABEL));
+			if (!entry) return false;
+			await stopEntry(entry, reason);
+			return true;
+		},
+		async stopAll(reason) {
+			if (disposed && instances.size === 0) return;
+			await Promise.allSettled([...instances.values()].map((entry) => stopEntry(entry, reason)));
+		},
+		async dispose(reason = "Doom loop-launchers service disposed.") {
+			if (disposed) return;
+			disposed = true;
+			launchers.clear();
+			await Promise.allSettled([...instances.values()].map((entry) => stopEntry(entry, reason)));
+			listeners.clear();
+		}
+	});
+}
+//#endregion
+exports.createDoomLoopLaunchersService = createDoomLoopLaunchersService;
+
+//# sourceMappingURL=index.cjs.map

package/dist/src/services/loopLaunchers/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.cjs","names":[],"sources":["../../../../src/services/loopLaunchers/index.ts"],"sourcesContent":["import type {\n  DoomLoopLaunchersService,\n  LoopInstanceSnapshot,\n  LoopLauncherDefinition,\n  LoopLauncherRegistration,\n  StoppableLoop,\n} from '../../schemas/loopLaunchers';\n\nconst MAX_ID_LENGTH = 256;\nconst MAX_GENERATION_LENGTH = 256;\nconst LAUNCHER_ID_LABEL = 'loop launcher id';\nconst INSTANCE_ID_LABEL = 'loop instance id';\n\ninterface LauncherEntry {\n  readonly token: symbol;\n  readonly definition: LoopLauncherDefinition;\n}\n\ninterface InstanceEntry {\n  readonly instanceId: string;\n  readonly launcher: LauncherEntry;\n  readonly abortController: AbortController;\n  state: LoopInstanceSnapshot['state'];\n  handle?: StoppableLoop;\n  startedAt?: string;\n}\n\nexport interface LoopLaunchersDependencies {\n  readonly generation: string;\n  readonly createInstanceId: () => string;\n  readonly timestamp: () => string;\n}\n\nfunction validId(value: string, label: string): string {\n  const normalized = value.trim();\n  let hasControl = false;\n  for (const character of normalized) {\n    const code = character.codePointAt(0);\n    if (code !== undefined && (code <= 0x1f || code === 0x7f)) {\n      hasControl = true;\n      break;\n    }\n  }\n  if (!normalized || normalized.length > MAX_ID_LENGTH || hasControl) throw new Error(`Invalid ${label}.`);\n  return normalized;\n}\n\nfunction snapshot(entry: InstanceEntry): LoopInstanceSnapshot {\n  return {\n    instanceId: entry.instanceId,\n    launcherId: entry.launcher.definition.id,\n    launcherLabel: entry.launcher.definition.label,\n    ...(entry.handle?.label ? { label: entry.handle.label } : {}),\n    ...(entry.handle?.detail ? { detail: entry.handle.detail } : {}),\n    state: entry.state,\n    ...(entry.startedAt ? { startedAt: entry.startedAt } : {}),\n  };\n}\n\n/** Creates the provider-owned launcher registry for one active Doom session. */\nexport function createDoomLoopLaunchersService({\n  generation,\n  createInstanceId,\n  timestamp,\n}: LoopLaunchersDependencies): DoomLoopLaunchersService {\n  if (!generation || generation.length > MAX_GENERATION_LENGTH) {\n    throw new TypeError('Doom loop launchers require a valid generation.');\n  }\n\n  const launchers = new Map<string, LauncherEntry>();\n  const instances = new Map<string, InstanceEntry>();\n  const listeners = new Set<() => void>();\n  let registrationSequence = 0;\n  let disposed = false;\n\n  const ensureActive = (): void => {\n    if (disposed) throw new Error('The Doom loop-launchers service is disposed.');\n  };\n  const notify = (): void => {\n    for (const listener of listeners) listener();\n  };\n  const stopEntry = async (entry: InstanceEntry, reason?: string): Promise<void> => {\n    if (instances.get(entry.instanceId) !== entry) return;\n    entry.state = 'stopping';\n    entry.abortController.abort(reason);\n    notify();\n    try {\n      await entry.handle?.stop(reason);\n    } finally {\n      if (instances.get(entry.instanceId) === entry) instances.delete(entry.instanceId);\n      notify();\n    }\n  };\n\n  const service: DoomLoopLaunchersService = {\n    generation,\n    register(definition): LoopLauncherRegistration {\n      ensureActive();\n      const id = validId(definition.id, LAUNCHER_ID_LABEL);\n      if (launchers.has(id)) throw new Error(`Loop launcher '${id}' is already registered.`);\n      const token = Symbol(id);\n      const entry: LauncherEntry = { token, definition: { ...definition, id } };\n      launchers.set(id, entry);\n      registrationSequence += 1;\n      notify();\n      let registrationDisposed = false;\n      return Object.freeze({\n        id,\n        generation: `${generation}:launcher:${registrationSequence}`,\n        async dispose(reason = 'Loop launcher disposed.'): Promise<void> {\n          if (registrationDisposed) return;\n          registrationDisposed = true;\n          if (launchers.get(id)?.token !== token) return;\n          launchers.delete(id);\n          const owned = [...instances.values()].filter((instance) => instance.launcher.token === token);\n          await Promise.allSettled(owned.map((instance) => stopEntry(instance, reason)));\n          notify();\n        },\n      });\n    },\n    listLaunchers() {\n      ensureActive();\n      return [...launchers.values()]\n        .map(({ definition }) => ({\n          id: definition.id,\n          source: definition.source,\n          label: definition.label,\n          ...(definition.description ? { description: definition.description } : {}),\n        }))\n        .sort((left, right) => left.label.localeCompare(right.label) || left.id.localeCompare(right.id));\n    },\n    listInstances() {\n      ensureActive();\n      return [...instances.values()]\n        .map(snapshot)\n        .sort((left, right) => left.instanceId.localeCompare(right.instanceId));\n    },\n    subscribe(listener) {\n      ensureActive();\n      listeners.add(listener);\n      let subscribed = true;\n      return () => {\n        if (!subscribed) return;\n        subscribed = false;\n        listeners.delete(listener);\n      };\n    },\n    async launch(launcherId, options) {\n      ensureActive();\n      const normalizedLauncherId = validId(launcherId, LAUNCHER_ID_LABEL);\n      const launcher = launchers.get(normalizedLauncherId);\n      if (!launcher) throw new Error(`Loop launcher '${normalizedLauncherId}' is unavailable.`);\n      const instanceId = validId(options?.instanceId ?? createInstanceId(), INSTANCE_ID_LABEL);\n      if (instances.has(instanceId)) throw new Error(`Loop instance '${instanceId}' already exists.`);\n      const entry: InstanceEntry = { instanceId, launcher, abortController: new AbortController(), state: 'starting' };\n      instances.set(instanceId, entry);\n      notify();\n      try {\n        const handle = await launcher.definition.launch({ instanceId, signal: entry.abortController.signal });\n        const active = !disposed && instances.get(instanceId) === entry && !entry.abortController.signal.aborted;\n        if (!handle) {\n          if (instances.get(instanceId) === entry) instances.delete(instanceId);\n          notify();\n          return undefined;\n        }\n        if (!active || handle.instanceId !== instanceId) {\n          await handle.stop(active ? 'Loop launcher returned a mismatched instance id.' : 'Loop launch was cancelled.');\n          if (instances.get(instanceId) === entry) instances.delete(instanceId);\n          notify();\n          if (active) throw new Error(`Loop launcher '${normalizedLauncherId}' returned a mismatched instance id.`);\n          return undefined;\n        }\n        entry.handle = handle;\n        entry.state = 'running';\n        entry.startedAt = timestamp();\n        notify();\n        return snapshot(entry);\n      } catch (error) {\n        const cancelled = entry.abortController.signal.aborted || disposed;\n        if (instances.get(instanceId) === entry) instances.delete(instanceId);\n        notify();\n        if (cancelled) return undefined;\n        throw error;\n      }\n    },\n    async stop(instanceId, reason) {\n      ensureActive();\n      const entry = instances.get(validId(instanceId, INSTANCE_ID_LABEL));\n      if (!entry) return false;\n      await stopEntry(entry, reason);\n      return true;\n    },\n    async stopAll(reason) {\n      if (disposed && instances.size === 0) return;\n      await Promise.allSettled([...instances.values()].map((entry) => stopEntry(entry, reason)));\n    },\n    async dispose(reason = 'Doom loop-launchers service disposed.') {\n      if (disposed) return;\n      disposed = true;\n      launchers.clear();\n      await Promise.allSettled([...instances.values()].map((entry) => stopEntry(entry, reason)));\n      listeners.clear();\n    },\n  };\n\n  return Object.freeze(service);\n}\n"],"mappings":"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"}