@agimon-ai/doompi-loop 0.0.1-alpha.8 → 0.0.1-alpha.81

package/README.md

@@ -1,42 +1,104 @@
 # @agimon-ai/doompi-loop
 
-Generic multi-loop controller for Doompi.
+Send a prompt now, then repeat it at a bounded interval for the current session.
 
-Runs a prompt on a schedule. Loop is a minor mode: it toggles mid-session, stacks with
-the others, and reports itself on the shared `MODES` line.
+Part of the [DoomPi distribution](https://www.npmjs.com/package/@agimon-ai/doompi).
 
-Part of [Doompi](https://www.npmjs.com/package/@agimon-ai/doompi), a coding agent that loads
-only the skills and tools you name. This package is composed by Doompi and is not usually
-installed on its own.
+Several loops can coexist. Loop is a minor mode and remains active while at least one scheduled
+prompt belongs to the current session.
+
+> **Alpha:** launcher and scheduling contracts may change between releases.
+
+## Requirements
+
+- Node.js 22.19.0 or newer
+- Pi 0.85.0 and Pi TUI 0.85.0
 
 ## Install
 
+The seeded `modes.yaml` selects Loop in `default.packages`. Keep it there or select it through a
+layer; it is not fixed host infrastructure. For standalone Pi:
+
 ```bash
-npm install @agimon-ai/doompi-loop
+pi install npm:@agimon-ai/doompi-loop
 ```
 
-## How it loads
+## Start and manage loops
+
+Use `/loop` to start a loop and `/loops` to inspect or stop active loops. In DoomPi, `SPC l s` opens
+the start flow and `SPC l l` opens the list.
+
+The default interval is 300 seconds. Accepted intervals range from 30 to 3600 seconds. A loop runs
+its prompt once immediately, then schedules later passes.
+
+If Pi is busy, a due pass waits for the shared agent to become idle. Multiple due signals can
+coalesce rather than creating overlapping model turns. Stopping a loop prevents future passes but
+does not rewind side effects from a pass already sent.
+
+## Lifecycle and cost
+
+Loop state belongs to the session's `doom/loop-launchers` service; it is not a durable queue.
+Replacing or shutting down the session aborts pending launches and stops active timers. Resuming a
+transcript does not restart old loops.
 
-Doompi loads this unconditionally. It is core, not a layer, so it does not appear in
-`.doom/modes.yaml`: making it optional would only create broken configurations.
+Every pass can start another model turn and repeat tool or external side effects. Choose
+conservative intervals, make prompts idempotent where possible, and stop loops when the recurring
+work is complete.
 
-Extension entry: `@agimon-ai/doompi-loop/extensions/pi`
+## Web extension slots
 
-## Leader
+The Loop Activity section declares `loop.registration` for start controls and `loop.items` for
+session-scoped instance rows. Other web plugins may fill either slot; Loop owns the section shell and
+renders all registered fills without requiring a feature-specific dependency.
 
-`SPC l s` starts a loop, `SPC l l` lists and stops them, once the extension is loaded.
+## Extension authors: cross-extension launchers
 
-The built-in **Default loop** asks for a prompt and an interval, runs one pass immediately,
-and repeats while the session is open. Other extensions can register domain-specific loop
-launchers alongside it.
+Launcher definitions use the shared Cordis service. A consumer registers a launcher and returns its
+cleanup callback. Cordis removes that launcher when either package or the session unloads, then
+registers it again when the provider returns.
 
-## Entry points
+```ts
+import { DOOM_LOOP_LAUNCHERS_SERVICE, requireDoomLoopLaunchers } from '@agimon-ai/doompi-loop/loop-launchers';
+import type { Context } from '@deepseek-ai/cordis';
 
-| Import                                 |
-| -------------------------------------- |
-| `@agimon-ai/doompi-loop`               |
-| `@agimon-ai/doompi-loop/extensions/pi` |
+export function myLoopPlugin(ctx: Context): void {
+  ctx.inject([DOOM_LOOP_LAUNCHERS_SERVICE], (sessionContext) => {
+    const registration = requireDoomLoopLaunchers(sessionContext).register({
+      id: 'example.recurring-check',
+      source: '@example/doompi-recurring-check',
+      label: 'Recurring check',
+      async launch({ instanceId, signal }) {
+        signal.throwIfAborted();
+        // Start session work. The returned stop callback owns cleanup.
+        return { instanceId, stop: () => undefined };
+      },
+    });
+    return () => registration.dispose('Contributor unloaded.');
+  });
+}
+```
+
+Mount that plugin on the runner's shared Doom Cordis root. Loop owns the registry and default
+launcher. Consumers depend only on
+`@agimon-ai/doompi-loop/loop-launchers`; there is no process-global registry or
+session-ID lookup API.
+
+The package root exports the service contract
+types. Normal Pi activation uses the discovered `extensions/pi` entry.
+
+## Development
+
+```bash
+pnpm build
+pnpm typecheck
+pnpm test
+pnpm lint
+```
+
+Maintained by [Agimon](https://agimon.ai/about).
 
 ## License
 
 MIT
+
+Pi and server entries live directly in `src/extensions/`. They declare commands, minor mode owners, and optional services. The helpers own registration and cleanup; `onDispose` clears UI state, while session service disposal stops pending launches and timers. Services live in named folders and public exports remain flat.

package/dist/api-contracts.cjs

@@ -0,0 +1,7 @@
+Object.defineProperties(exports, {
+	__esModule: { value: true },
+	[Symbol.toStringTag]: { value: "Module" }
+});
+const require_apiContracts = require("./src/schemas/apiContracts.cjs");
+exports.apiContracts = require_apiContracts.apiContracts;
+exports.default = require_apiContracts.apiContracts;

package/dist/api-contracts.d.cts

@@ -0,0 +1,2 @@
+import { apiContracts } from "./src/schemas/apiContracts.cjs";
+export { apiContracts, apiContracts as default };

package/dist/api-contracts.d.mts

@@ -0,0 +1,2 @@
+import { apiContracts } from "./src/schemas/apiContracts.mjs";
+export { apiContracts, apiContracts as default };

package/dist/api-contracts.mjs

@@ -0,0 +1,2 @@
+import { apiContracts } from "./src/schemas/apiContracts.mjs";
+export { apiContracts, apiContracts as default };

package/dist/extensions/pi.cjs

@@ -1,2 +1,36 @@
-var e=require("../extension.cjs").registerLoopExtension;module.exports=e;
+Object.defineProperties(exports, {
+	__esModule: { value: true },
+	[Symbol.toStringTag]: { value: "Module" }
+});
+const require_root_cli = require("../src/extensions/workspaces/sessions/(backend)/root.cli.cjs");
+const require_loop_cli = require("../src/extensions/workspaces/sessions/(backend)/command/loop.cli.cjs");
+const require_loops_cli = require("../src/extensions/workspaces/sessions/(backend)/command/loops.cli.cjs");
+const require_agent_settled_cli = require("../src/extensions/workspaces/sessions/(backend)/hook/agent-settled.cli.cjs");
+const require_doompi_use_loop_cli = require("../src/extensions/workspaces/sessions/(backend)/resource/doompi-use-loop.cli.cjs");
+let _agimon_ai_doompi_core_pi_extension = require("@agimon-ai/doompi-core/pi-extension");
+let _agimon_ai_doompi_core_extension_file = require("@agimon-ai/doompi-core/extension-file");
+//#region generated/pi.ts
+const at = (value, context) => typeof value === "function" ? value(context) : value;
+const extension = (0, _agimon_ai_doompi_core_pi_extension.definePiExtension)("@agimon-ai/doompi-loop", async (context) => {
+	const scopeSession = await require_root_cli.default(context);
+	const contextSession = {
+		...context,
+		root: scopeSession.value
+	};
+	return {
+		...(0, _agimon_ai_doompi_core_extension_file.composeRootHooks)(scopeSession),
+		get commands() {
+			return [at(require_loop_cli.default, contextSession), at(require_loops_cli.default, contextSession)];
+		},
+		events: { agent_settled: at(require_agent_settled_cli.default, contextSession) },
+		get resources() {
+			return [at(require_doompi_use_loop_cli.default, contextSession)];
+		},
+		services: [...scopeSession.services ?? []]
+	};
+});
+//#endregion
+exports.default = extension;
+exports.extension = extension;
+
 //# sourceMappingURL=pi.cjs.map

package/dist/extensions/pi.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"pi.cjs","names":["registerLoopExtension"],"sources":["../../src/extensions/pi.ts"],"sourcesContent":["import { registerLoopExtension } from '../extension.ts';\n\nexport default registerLoopExtension;\n"],"mappings":"AAEA,IAAA,4BAAeA,CAAAA,CAAAA"}
+{"version":3,"file":"pi.cjs","names":["definePiExtension","rootSession","composeRootHooks","commandLoop","commandLoops","hookAgentSettled","resourceDoompiUseLoop"],"sources":["../../generated/pi.ts"],"sourcesContent":["// Generated by @agimon-ai/doompi-build. Do not edit by hand.\nimport { definePiExtension, type PiPluginContext, type PiPluginContributions } from '@agimon-ai/doompi-core/pi-extension';\nimport { composeRootHooks } from '@agimon-ai/doompi-core/extension-file';\n\nimport rootSession from '../src/extensions/workspaces/sessions/(backend)/root.cli';\nimport commandLoop from '../src/extensions/workspaces/sessions/(backend)/command/loop.cli';\nimport commandLoops from '../src/extensions/workspaces/sessions/(backend)/command/loops.cli';\nimport hookAgentSettled from '../src/extensions/workspaces/sessions/(backend)/hook/agent-settled.cli';\nimport resourceDoompiUseLoop from '../src/extensions/workspaces/sessions/(backend)/resource/doompi-use-loop.cli';\n\ntype OptionsOf<T> = T extends (context: PiPluginContext<infer Options>) => unknown ? Options : never;\ntype InferredOptions = Exclude<OptionsOf<typeof rootSession> | OptionsOf<typeof commandLoop> | OptionsOf<typeof commandLoops> | OptionsOf<typeof hookAgentSettled> | OptionsOf<typeof resourceDoompiUseLoop>, undefined>;\ntype Intersect<Union> =\n  (Union extends unknown ? (value: Union) => void : never) extends (value: infer Value) => void ? Value : never;\ntype ExtensionOptions = [InferredOptions] extends [never] ? undefined : Intersect<InferredOptions>;\n\ntype Factory<T, C> = (context: C) => T;\nconst at = <T, C>(value: T | Factory<T, C>, context: C): T =>\n  typeof value === 'function' ? (value as Factory<T, C>)(context) : value;\n\nexport const extension = definePiExtension<ExtensionOptions>('@agimon-ai/doompi-loop', async (context) => {\n  const scopeSession = await rootSession(context);\n  const contextSession = { ...context, root: scopeSession.value };\n  return {\n    ...composeRootHooks(scopeSession),\n    get commands(): PiPluginContributions['commands'] { return [at(commandLoop, contextSession), at(commandLoops, contextSession)]; },\n    events: {\n      agent_settled: at(hookAgentSettled, contextSession) as NonNullable<PiPluginContributions['events']>['agent_settled'],\n    },\n    get resources(): PiPluginContributions['resources'] { return [at(resourceDoompiUseLoop, contextSession)]; },\n    services: [...(scopeSession.services ?? [])],\n  };\n});\n\nexport default extension;\n"],"mappings":";;;;;;;;;;;;AAiBA,MAAM,MAAY,OAA0B,YAC1C,OAAO,UAAU,aAAc,MAAwB,OAAO,IAAI;AAEpE,MAAa,aAAA,GAAYA,oCAAAA,kBAAAA,CAAoC,0BAA0B,OAAO,YAAY;CACxG,MAAM,eAAe,MAAMC,iBAAAA,QAAY,OAAO;CAC9C,MAAM,iBAAiB;EAAE,GAAG;EAAS,MAAM,aAAa;CAAM;CAC9D,OAAO;EACL,IAAA,GAAGC,sCAAAA,iBAAAA,CAAiB,YAAY;EAChC,IAAI,WAA8C;GAAE,OAAO,CAAC,GAAGC,iBAAAA,SAAa,cAAc,GAAG,GAAGC,kBAAAA,SAAc,cAAc,CAAC;EAAG;EAChI,QAAQ,EACN,eAAe,GAAGC,0BAAAA,SAAkB,cAAc,EACpD;EACA,IAAI,YAAgD;GAAE,OAAO,CAAC,GAAGC,4BAAAA,SAAuB,cAAc,CAAC;EAAG;EAC1G,UAAU,CAAC,GAAI,aAAa,YAAY,CAAC,CAAE;CAC7C;AACF,CAAC"}

package/dist/extensions/pi.d.cts

@@ -1,2 +1,5 @@
-import { registerLoopExtension } from "../extension.cjs";
-export = registerLoopExtension;
+//#region generated/pi.d.ts
+export declare const extension: import("@agimon-ai/doompi-core/runtime-pi-extension").DefinedPiExtension<undefined>;
+//#endregion
+export { extension as default };
+//# sourceMappingURL=pi.d.cts.map

package/dist/extensions/pi.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pi.d.cts","names":[],"sources":["../../generated/pi.ts"],"mappings":";qBAoBa,iEAAS"}

package/dist/extensions/pi.d.mts

@@ -1,2 +1,5 @@
-import { registerLoopExtension } from "../extension.mjs";
-export { registerLoopExtension as default };
+//#region generated/pi.d.ts
+export declare const extension: import("@agimon-ai/doompi-core/runtime-pi-extension").DefinedPiExtension<undefined>;
+//#endregion
+export { extension as default };
+//# sourceMappingURL=pi.d.mts.map

package/dist/extensions/pi.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pi.d.mts","names":[],"sources":["../../generated/pi.ts"],"mappings":";qBAoBa,iEAAS"}

package/dist/extensions/pi.mjs

@@ -1,2 +1,31 @@
-import{registerLoopExtension as e}from"../extension.mjs";var t=e;export{t as default};
+import root_cli_default from "../src/extensions/workspaces/sessions/(backend)/root.cli.mjs";
+import loop_cli_default from "../src/extensions/workspaces/sessions/(backend)/command/loop.cli.mjs";
+import loops_cli_default from "../src/extensions/workspaces/sessions/(backend)/command/loops.cli.mjs";
+import agent_settled_cli_default from "../src/extensions/workspaces/sessions/(backend)/hook/agent-settled.cli.mjs";
+import doompi_use_loop_cli_default from "../src/extensions/workspaces/sessions/(backend)/resource/doompi-use-loop.cli.mjs";
+import { definePiExtension } from "@agimon-ai/doompi-core/pi-extension";
+import { composeRootHooks } from "@agimon-ai/doompi-core/extension-file";
+//#region generated/pi.ts
+const at = (value, context) => typeof value === "function" ? value(context) : value;
+const extension = definePiExtension("@agimon-ai/doompi-loop", async (context) => {
+	const scopeSession = await root_cli_default(context);
+	const contextSession = {
+		...context,
+		root: scopeSession.value
+	};
+	return {
+		...composeRootHooks(scopeSession),
+		get commands() {
+			return [at(loop_cli_default, contextSession), at(loops_cli_default, contextSession)];
+		},
+		events: { agent_settled: at(agent_settled_cli_default, contextSession) },
+		get resources() {
+			return [at(doompi_use_loop_cli_default, contextSession)];
+		},
+		services: [...scopeSession.services ?? []]
+	};
+});
+//#endregion
+export { extension as default, extension };
+
 //# sourceMappingURL=pi.mjs.map

package/dist/extensions/pi.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"pi.mjs","names":[],"sources":["../../src/extensions/pi.ts"],"sourcesContent":["import { registerLoopExtension } from '../extension.ts';\n\nexport default registerLoopExtension;\n"],"mappings":"yDAEA,IAAA,EAAe"}
+{"version":3,"file":"pi.mjs","names":["rootSession","commandLoop","commandLoops","hookAgentSettled","resourceDoompiUseLoop"],"sources":["../../generated/pi.ts"],"sourcesContent":["// Generated by @agimon-ai/doompi-build. Do not edit by hand.\nimport { definePiExtension, type PiPluginContext, type PiPluginContributions } from '@agimon-ai/doompi-core/pi-extension';\nimport { composeRootHooks } from '@agimon-ai/doompi-core/extension-file';\n\nimport rootSession from '../src/extensions/workspaces/sessions/(backend)/root.cli';\nimport commandLoop from '../src/extensions/workspaces/sessions/(backend)/command/loop.cli';\nimport commandLoops from '../src/extensions/workspaces/sessions/(backend)/command/loops.cli';\nimport hookAgentSettled from '../src/extensions/workspaces/sessions/(backend)/hook/agent-settled.cli';\nimport resourceDoompiUseLoop from '../src/extensions/workspaces/sessions/(backend)/resource/doompi-use-loop.cli';\n\ntype OptionsOf<T> = T extends (context: PiPluginContext<infer Options>) => unknown ? Options : never;\ntype InferredOptions = Exclude<OptionsOf<typeof rootSession> | OptionsOf<typeof commandLoop> | OptionsOf<typeof commandLoops> | OptionsOf<typeof hookAgentSettled> | OptionsOf<typeof resourceDoompiUseLoop>, undefined>;\ntype Intersect<Union> =\n  (Union extends unknown ? (value: Union) => void : never) extends (value: infer Value) => void ? Value : never;\ntype ExtensionOptions = [InferredOptions] extends [never] ? undefined : Intersect<InferredOptions>;\n\ntype Factory<T, C> = (context: C) => T;\nconst at = <T, C>(value: T | Factory<T, C>, context: C): T =>\n  typeof value === 'function' ? (value as Factory<T, C>)(context) : value;\n\nexport const extension = definePiExtension<ExtensionOptions>('@agimon-ai/doompi-loop', async (context) => {\n  const scopeSession = await rootSession(context);\n  const contextSession = { ...context, root: scopeSession.value };\n  return {\n    ...composeRootHooks(scopeSession),\n    get commands(): PiPluginContributions['commands'] { return [at(commandLoop, contextSession), at(commandLoops, contextSession)]; },\n    events: {\n      agent_settled: at(hookAgentSettled, contextSession) as NonNullable<PiPluginContributions['events']>['agent_settled'],\n    },\n    get resources(): PiPluginContributions['resources'] { return [at(resourceDoompiUseLoop, contextSession)]; },\n    services: [...(scopeSession.services ?? [])],\n  };\n});\n\nexport default extension;\n"],"mappings":";;;;;;;;AAiBA,MAAM,MAAY,OAA0B,YAC1C,OAAO,UAAU,aAAc,MAAwB,OAAO,IAAI;AAEpE,MAAa,YAAY,kBAAoC,0BAA0B,OAAO,YAAY;CACxG,MAAM,eAAe,MAAMA,iBAAY,OAAO;CAC9C,MAAM,iBAAiB;EAAE,GAAG;EAAS,MAAM,aAAa;CAAM;CAC9D,OAAO;EACL,GAAG,iBAAiB,YAAY;EAChC,IAAI,WAA8C;GAAE,OAAO,CAAC,GAAGC,kBAAa,cAAc,GAAG,GAAGC,mBAAc,cAAc,CAAC;EAAG;EAChI,QAAQ,EACN,eAAe,GAAGC,2BAAkB,cAAc,EACpD;EACA,IAAI,YAAgD;GAAE,OAAO,CAAC,GAAGC,6BAAuB,cAAc,CAAC;EAAG;EAC1G,UAAU,CAAC,GAAI,aAAa,YAAY,CAAC,CAAE;CAC7C;AACF,CAAC"}

package/dist/extensions/server.cjs

@@ -0,0 +1,51 @@
+Object.defineProperties(exports, {
+	__esModule: { value: true },
+	[Symbol.toStringTag]: { value: "Module" }
+});
+const require_root_server = require("../src/extensions/workspaces/sessions/(backend)/root.server.cjs");
+const require_loop_server = require("../src/extensions/workspaces/sessions/(backend)/command/loop.server.cjs");
+const require_loops_server = require("../src/extensions/workspaces/sessions/(backend)/command/loops.server.cjs");
+const require_session_shutdown_server = require("../src/extensions/workspaces/sessions/(backend)/hook/session-shutdown.server.cjs");
+const require_session_start_server = require("../src/extensions/workspaces/sessions/(backend)/hook/session-start.server.cjs");
+const require_doompi_use_loop_server = require("../src/extensions/workspaces/sessions/(backend)/resource/doompi-use-loop.server.cjs");
+let _agimon_ai_doompi_core_extension_file = require("@agimon-ai/doompi-core/extension-file");
+let _agimon_ai_doompi_core_server_facet = require("@agimon-ai/doompi-core/server-facet");
+//#region generated/server.ts
+const at = (value, context) => typeof value === "function" ? value(context) : value;
+/* v8 ignore next -- generated normalization branch */
+const defined = (values) => values.filter((value) => value !== void 0);
+const via = (identity, value) => ({
+	...identity,
+	...value
+});
+const facet = (0, _agimon_ai_doompi_core_server_facet.defineServerPlugin)({
+	name: "@agimon-ai/doompi-loop",
+	session: async (context) => {
+		const scopeSession = await require_root_server.default(context);
+		const contextSession = {
+			...context,
+			root: scopeSession.value
+		};
+		return {
+			...(0, _agimon_ai_doompi_core_extension_file.composeRootHooks)(scopeSession),
+			get commands() {
+				return defined([via({ name: "loop" }, at(require_loop_server.default, contextSession)), via({ name: "loops" }, at(require_loops_server.default, contextSession))]);
+			},
+			get hooks() {
+				return defined([via({ event: "session_shutdown" }, at(require_session_shutdown_server.default, contextSession)), via({ event: "session_start" }, at(require_session_start_server.default, contextSession))]);
+			},
+			get resources() {
+				return defined([at(require_doompi_use_loop_server.default, contextSession)]);
+			},
+			services: [...scopeSession.services ?? []],
+			get activities() {
+				return [...scopeSession.activities ?? []];
+			}
+		};
+	}
+});
+//#endregion
+exports.default = facet;
+exports.facet = facet;
+
+//# sourceMappingURL=server.cjs.map

package/dist/extensions/server.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.cjs","names":["defineServerPlugin","rootSession","composeRootHooks","commandLoop","commandLoops","hookSessionShutdown","hookSessionStart","resourceDoompiUseLoop"],"sources":["../../generated/server.ts"],"sourcesContent":["// Generated by @agimon-ai/doompi-build. Do not edit by hand.\nimport { defineServerPlugin, type DoomServerSessionPlugin } from '@agimon-ai/doompi-core/server-facet';\nimport { composeRootHooks } from '@agimon-ai/doompi-core/extension-file';\n\nimport rootSession from '../src/extensions/workspaces/sessions/(backend)/root.server';\nimport commandLoop from '../src/extensions/workspaces/sessions/(backend)/command/loop.server';\nimport commandLoops from '../src/extensions/workspaces/sessions/(backend)/command/loops.server';\nimport hookSessionShutdown from '../src/extensions/workspaces/sessions/(backend)/hook/session-shutdown.server';\nimport hookSessionStart from '../src/extensions/workspaces/sessions/(backend)/hook/session-start.server';\nimport resourceDoompiUseLoop from '../src/extensions/workspaces/sessions/(backend)/resource/doompi-use-loop.server';\n\ntype Factory<T, C> = (context: C) => T;\nconst at = <T, C>(value: T | Factory<T, C>, context: C): T =>\n  typeof value === 'function' ? (value as Factory<T, C>)(context) : value;\n/* v8 ignore next -- generated normalization branch */\nconst defined = <T>(values: readonly (T | undefined)[]): T[] =>\n  values.filter((value): value is T => value !== undefined);\nconst via = <T>(identity: Record<string, unknown>, value: unknown): T => ({ ...identity, ...(value as object) }) as T;\n\nexport const facet = defineServerPlugin({\n  name: '@agimon-ai/doompi-loop',\n  session: async (context) => {\n    const scopeSession = await rootSession(context);\n    const contextSession = { ...context, root: scopeSession.value };\n    return {\n      ...composeRootHooks(scopeSession),\n      get commands(): DoomServerSessionPlugin['commands'] { return defined([via({ name: 'loop' }, at(commandLoop, contextSession)), via({ name: 'loops' }, at(commandLoops, contextSession))]); },\n      get hooks(): DoomServerSessionPlugin['hooks'] { return defined([via({ event: 'session_shutdown' }, at(hookSessionShutdown, contextSession)), via({ event: 'session_start' }, at(hookSessionStart, contextSession))]); },\n      get resources(): DoomServerSessionPlugin['resources'] { return defined([at(resourceDoompiUseLoop, contextSession)]); },\n      services: [...(scopeSession.services ?? [])],\n      get activities(): DoomServerSessionPlugin['activities'] { return [...(scopeSession.activities ?? [])]; },\n    };\n  },\n});\n\nexport default facet;\n"],"mappings":";;;;;;;;;;;;;AAYA,MAAM,MAAY,OAA0B,YAC1C,OAAO,UAAU,aAAc,MAAwB,OAAO,IAAI;;AAEpE,MAAM,WAAc,WAClB,OAAO,QAAQ,UAAsB,UAAU,KAAA,CAAS;AAC1D,MAAM,OAAU,UAAmC,WAAuB;CAAE,GAAG;CAAU,GAAI;AAAiB;AAE9G,MAAa,SAAA,GAAQA,oCAAAA,mBAAAA,CAAmB;CACtC,MAAM;CACN,SAAS,OAAO,YAAY;EAC1B,MAAM,eAAe,MAAMC,oBAAAA,QAAY,OAAO;EAC9C,MAAM,iBAAiB;GAAE,GAAG;GAAS,MAAM,aAAa;EAAM;EAC9D,OAAO;GACL,IAAA,GAAGC,sCAAAA,iBAAAA,CAAiB,YAAY;GAChC,IAAI,WAAgD;IAAE,OAAO,QAAQ,CAAC,IAAI,EAAE,MAAM,OAAO,GAAG,GAAGC,oBAAAA,SAAa,cAAc,CAAC,GAAG,IAAI,EAAE,MAAM,QAAQ,GAAG,GAAGC,qBAAAA,SAAc,cAAc,CAAC,CAAC,CAAC;GAAG;GAC1L,IAAI,QAA0C;IAAE,OAAO,QAAQ,CAAC,IAAI,EAAE,OAAO,mBAAmB,GAAG,GAAGC,gCAAAA,SAAqB,cAAc,CAAC,GAAG,IAAI,EAAE,OAAO,gBAAgB,GAAG,GAAGC,6BAAAA,SAAkB,cAAc,CAAC,CAAC,CAAC;GAAG;GACtN,IAAI,YAAkD;IAAE,OAAO,QAAQ,CAAC,GAAGC,+BAAAA,SAAuB,cAAc,CAAC,CAAC;GAAG;GACrH,UAAU,CAAC,GAAI,aAAa,YAAY,CAAC,CAAE;GAC3C,IAAI,aAAoD;IAAE,OAAO,CAAC,GAAI,aAAa,cAAc,CAAC,CAAE;GAAG;EACzG;CACF;AACF,CAAC"}

package/dist/extensions/server.d.cts

@@ -0,0 +1,5 @@
+//#region generated/server.d.ts
+export declare const facet: import("@agimon-ai/doompi-core/server-facet").DoomServerFacet;
+//#endregion
+export { facet as default };
+//# sourceMappingURL=server.d.cts.map

package/dist/extensions/server.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.cts","names":[],"sources":["../../generated/server.ts"],"mappings":";qBAmBa,qDAAK"}

package/dist/extensions/server.d.mts

@@ -0,0 +1,5 @@
+//#region generated/server.d.ts
+export declare const facet: import("@agimon-ai/doompi-core/server-facet").DoomServerFacet;
+//#endregion
+export { facet as default };
+//# sourceMappingURL=server.d.mts.map

package/dist/extensions/server.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.mts","names":[],"sources":["../../generated/server.ts"],"mappings":";qBAmBa,qDAAK"}

package/dist/extensions/server.mjs

@@ -0,0 +1,46 @@
+import root_server_default from "../src/extensions/workspaces/sessions/(backend)/root.server.mjs";
+import loop_server_default from "../src/extensions/workspaces/sessions/(backend)/command/loop.server.mjs";
+import loops_server_default from "../src/extensions/workspaces/sessions/(backend)/command/loops.server.mjs";
+import session_shutdown_server_default from "../src/extensions/workspaces/sessions/(backend)/hook/session-shutdown.server.mjs";
+import session_start_server_default from "../src/extensions/workspaces/sessions/(backend)/hook/session-start.server.mjs";
+import doompi_use_loop_server_default from "../src/extensions/workspaces/sessions/(backend)/resource/doompi-use-loop.server.mjs";
+import { composeRootHooks } from "@agimon-ai/doompi-core/extension-file";
+import { defineServerPlugin } from "@agimon-ai/doompi-core/server-facet";
+//#region generated/server.ts
+const at = (value, context) => typeof value === "function" ? value(context) : value;
+/* v8 ignore next -- generated normalization branch */
+const defined = (values) => values.filter((value) => value !== void 0);
+const via = (identity, value) => ({
+	...identity,
+	...value
+});
+const facet = defineServerPlugin({
+	name: "@agimon-ai/doompi-loop",
+	session: async (context) => {
+		const scopeSession = await root_server_default(context);
+		const contextSession = {
+			...context,
+			root: scopeSession.value
+		};
+		return {
+			...composeRootHooks(scopeSession),
+			get commands() {
+				return defined([via({ name: "loop" }, at(loop_server_default, contextSession)), via({ name: "loops" }, at(loops_server_default, contextSession))]);
+			},
+			get hooks() {
+				return defined([via({ event: "session_shutdown" }, at(session_shutdown_server_default, contextSession)), via({ event: "session_start" }, at(session_start_server_default, contextSession))]);
+			},
+			get resources() {
+				return defined([at(doompi_use_loop_server_default, contextSession)]);
+			},
+			services: [...scopeSession.services ?? []],
+			get activities() {
+				return [...scopeSession.activities ?? []];
+			}
+		};
+	}
+});
+//#endregion
+export { facet as default, facet };
+
+//# sourceMappingURL=server.mjs.map

package/dist/extensions/server.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.mjs","names":["rootSession","commandLoop","commandLoops","hookSessionShutdown","hookSessionStart","resourceDoompiUseLoop"],"sources":["../../generated/server.ts"],"sourcesContent":["// Generated by @agimon-ai/doompi-build. Do not edit by hand.\nimport { defineServerPlugin, type DoomServerSessionPlugin } from '@agimon-ai/doompi-core/server-facet';\nimport { composeRootHooks } from '@agimon-ai/doompi-core/extension-file';\n\nimport rootSession from '../src/extensions/workspaces/sessions/(backend)/root.server';\nimport commandLoop from '../src/extensions/workspaces/sessions/(backend)/command/loop.server';\nimport commandLoops from '../src/extensions/workspaces/sessions/(backend)/command/loops.server';\nimport hookSessionShutdown from '../src/extensions/workspaces/sessions/(backend)/hook/session-shutdown.server';\nimport hookSessionStart from '../src/extensions/workspaces/sessions/(backend)/hook/session-start.server';\nimport resourceDoompiUseLoop from '../src/extensions/workspaces/sessions/(backend)/resource/doompi-use-loop.server';\n\ntype Factory<T, C> = (context: C) => T;\nconst at = <T, C>(value: T | Factory<T, C>, context: C): T =>\n  typeof value === 'function' ? (value as Factory<T, C>)(context) : value;\n/* v8 ignore next -- generated normalization branch */\nconst defined = <T>(values: readonly (T | undefined)[]): T[] =>\n  values.filter((value): value is T => value !== undefined);\nconst via = <T>(identity: Record<string, unknown>, value: unknown): T => ({ ...identity, ...(value as object) }) as T;\n\nexport const facet = defineServerPlugin({\n  name: '@agimon-ai/doompi-loop',\n  session: async (context) => {\n    const scopeSession = await rootSession(context);\n    const contextSession = { ...context, root: scopeSession.value };\n    return {\n      ...composeRootHooks(scopeSession),\n      get commands(): DoomServerSessionPlugin['commands'] { return defined([via({ name: 'loop' }, at(commandLoop, contextSession)), via({ name: 'loops' }, at(commandLoops, contextSession))]); },\n      get hooks(): DoomServerSessionPlugin['hooks'] { return defined([via({ event: 'session_shutdown' }, at(hookSessionShutdown, contextSession)), via({ event: 'session_start' }, at(hookSessionStart, contextSession))]); },\n      get resources(): DoomServerSessionPlugin['resources'] { return defined([at(resourceDoompiUseLoop, contextSession)]); },\n      services: [...(scopeSession.services ?? [])],\n      get activities(): DoomServerSessionPlugin['activities'] { return [...(scopeSession.activities ?? [])]; },\n    };\n  },\n});\n\nexport default facet;\n"],"mappings":";;;;;;;;;AAYA,MAAM,MAAY,OAA0B,YAC1C,OAAO,UAAU,aAAc,MAAwB,OAAO,IAAI;;AAEpE,MAAM,WAAc,WAClB,OAAO,QAAQ,UAAsB,UAAU,KAAA,CAAS;AAC1D,MAAM,OAAU,UAAmC,WAAuB;CAAE,GAAG;CAAU,GAAI;AAAiB;AAE9G,MAAa,QAAQ,mBAAmB;CACtC,MAAM;CACN,SAAS,OAAO,YAAY;EAC1B,MAAM,eAAe,MAAMA,oBAAY,OAAO;EAC9C,MAAM,iBAAiB;GAAE,GAAG;GAAS,MAAM,aAAa;EAAM;EAC9D,OAAO;GACL,GAAG,iBAAiB,YAAY;GAChC,IAAI,WAAgD;IAAE,OAAO,QAAQ,CAAC,IAAI,EAAE,MAAM,OAAO,GAAG,GAAGC,qBAAa,cAAc,CAAC,GAAG,IAAI,EAAE,MAAM,QAAQ,GAAG,GAAGC,sBAAc,cAAc,CAAC,CAAC,CAAC;GAAG;GAC1L,IAAI,QAA0C;IAAE,OAAO,QAAQ,CAAC,IAAI,EAAE,OAAO,mBAAmB,GAAG,GAAGC,iCAAqB,cAAc,CAAC,GAAG,IAAI,EAAE,OAAO,gBAAgB,GAAG,GAAGC,8BAAkB,cAAc,CAAC,CAAC,CAAC;GAAG;GACtN,IAAI,YAAkD;IAAE,OAAO,QAAQ,CAAC,GAAGC,gCAAuB,cAAc,CAAC,CAAC;GAAG;GACrH,UAAU,CAAC,GAAI,aAAa,YAAY,CAAC,CAAE;GAC3C,IAAI,aAAoD;IAAE,OAAO,CAAC,GAAI,aAAa,cAAc,CAAC,CAAE;GAAG;EACzG;CACF;AACF,CAAC"}

package/dist/extensions/web.mjs

@@ -0,0 +1,228 @@
+import { defineActivityGroup, defineFill, defineLeaderBinding, defineMinorModeFile, defineSlotFile, defineWebPlugin } from "@agimon-ai/doompi-core/web";
+import { Button, Dot } from "@agimon-ai/doompi-web-components";
+import { jsx, jsxs } from "react/jsx-runtime";
+//#region src/types/loopView.ts
+/** The browser-only status that carries active Loop instances into the activity dock. */
+const LOOP_VIEW_STATUS_KEY = "doom-loop-instances";
+const ANSI = new RegExp(String.raw`\u001b\[[0-9;]*m`, "gu");
+function isRecord(value) {
+	return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function isState(value) {
+	return value === "starting" || value === "running" || value === "stopping";
+}
+/** Reads a Loop status without letting malformed session data crash the activity dock. */
+function parseLoopStatusView(raw) {
+	if (raw === void 0) return void 0;
+	const text = raw.replace(ANSI, "").trim();
+	if (text === "") return void 0;
+	try {
+		const value = JSON.parse(text);
+		if (!Array.isArray(value) || value.length === 0) return void 0;
+		const items = [];
+		for (const item of value) {
+			if (!isRecord(item) || typeof item.instanceId !== "string" || item.instanceId.trim() === "" || typeof item.label !== "string" || item.label.trim() === "" || typeof item.detail !== "string" || !isState(item.state)) return;
+			items.push({
+				instanceId: item.instanceId,
+				label: item.label,
+				detail: item.detail,
+				state: item.state
+			});
+		}
+		return items;
+	} catch {
+		return;
+	}
+}
+//#endregion
+//#region src/extensions/workspaces/sessions/(frontend)/activity-group/loops.web.ts
+var loops_web_default = defineActivityGroup({
+	keys: "l l",
+	statusKey: LOOP_VIEW_STATUS_KEY,
+	order: 40
+});
+//#endregion
+//#region src/extensions/workspaces/sessions/(frontend)/fill/_components/LoopsActivitySection.tsx
+const MANAGE_COMMAND = "/loops";
+const DEFAULT_LOOP_COMMAND = "/loop doompi.default";
+/** Starts the built-in prompt loop without opening a generic launcher chooser. */
+function DefaultLoopLauncher({ sessionId, sendSessionFrame }) {
+	return /* @__PURE__ */ jsx(Button, {
+		variant: "subtle",
+		size: "xs",
+		"data-testid": "activity-loop-default-launch",
+		"aria-label": "launch default loop",
+		disabled: sessionId === null,
+		onClick: () => {
+			if (sessionId === null) return;
+			sendSessionFrame(sessionId, {
+				type: "prompt",
+				message: DEFAULT_LOOP_COMMAND
+			});
+		},
+		className: "text-2xs font-bold",
+		children: "default loop"
+	});
+}
+function toneOf(state) {
+	if (state === "running") return "green";
+	if (state === "stopping") return "orange";
+	return "yellow";
+}
+/** Renders active recurring prompts contributed to the Loop activity section. */
+function LoopActivityItems({ statuses }) {
+	const raw = statuses[LOOP_VIEW_STATUS_KEY];
+	const loops = parseLoopStatusView(raw);
+	const unavailable = raw !== void 0 && raw.trim() !== "" && loops === void 0;
+	if (!loops && !unavailable) return null;
+	return loops ? /* @__PURE__ */ jsx("ul", {
+		"aria-label": "active loops",
+		className: "flex flex-col gap-1",
+		children: loops.map((loop) => /* @__PURE__ */ jsxs("li", {
+			"data-testid": `activity-loop-${loop.instanceId}`,
+			"data-loop-state": loop.state,
+			title: `${loop.label}: ${loop.detail}`,
+			className: "flex min-w-0 flex-col gap-0.5 px-1 py-0.5",
+			children: [/* @__PURE__ */ jsxs("span", {
+				className: "flex min-w-0 items-center gap-1.5",
+				children: [
+					/* @__PURE__ */ jsx(Dot, {
+						tone: toneOf(loop.state),
+						pulse: loop.state !== "running"
+					}),
+					/* @__PURE__ */ jsx("span", {
+						className: "min-w-0 flex-1 truncate text-xs font-bold text-doom-hi",
+						children: loop.label
+					}),
+					/* @__PURE__ */ jsx("span", {
+						className: "shrink-0 text-2xs text-doom-faint",
+						children: loop.state
+					})
+				]
+			}), /* @__PURE__ */ jsx("span", {
+				className: "truncate pl-3 text-2xs text-doom-faint",
+				children: loop.detail
+			})]
+		}, loop.instanceId))
+	}) : /* @__PURE__ */ jsx("p", {
+		className: "px-1 text-xs text-doom-faint",
+		children: "loop status unavailable"
+	});
+}
+/** Idle-safe Loop activity shell with extension registration and instance slots. */
+function LoopsActivitySection({ sessionId, renderSlot, sendSessionFrame }) {
+	return /* @__PURE__ */ jsxs("div", {
+		"data-testid": "activity-loop-instances",
+		className: "flex flex-col gap-2",
+		children: [
+			/* @__PURE__ */ jsxs("div", {
+				className: "flex flex-wrap items-center gap-1",
+				children: [/* @__PURE__ */ jsx(DefaultLoopLauncher, {
+					sessionId,
+					sendSessionFrame
+				}), renderSlot("loop.registration")]
+			}),
+			renderSlot("loop.items"),
+			/* @__PURE__ */ jsx(Button, {
+				variant: "subtle",
+				size: "xs",
+				"data-testid": "activity-loops-manage",
+				"aria-label": "manage loops",
+				disabled: sessionId === null,
+				onClick: () => {
+					if (sessionId === null) return;
+					sendSessionFrame(sessionId, {
+						type: "prompt",
+						message: MANAGE_COMMAND
+					});
+				},
+				className: "self-end text-2xs font-bold",
+				children: "manage"
+			})
+		]
+	});
+}
+//#endregion
+//#region src/extensions/workspaces/sessions/(frontend)/fill/Instances.loop.items.web.tsx
+var Instances_loop_items_web_default = defineFill({ component: LoopActivityItems });
+//#endregion
+//#region src/extensions/workspaces/sessions/(frontend)/fill/Loops.activity.loops.web.tsx
+var Loops_activity_loops_web_default = defineFill({ component: LoopsActivitySection });
+//#endregion
+//#region src/extensions/workspaces/sessions/(frontend)/leader/list.web.ts
+var list_web_default = defineLeaderBinding({
+	path: [{
+		key: "l",
+		label: "loops",
+		detail: "recurring prompt loops"
+	}, {
+		key: "l",
+		label: "list",
+		detail: "loops in this session"
+	}],
+	command: "loops"
+});
+//#endregion
+//#region src/extensions/workspaces/sessions/(frontend)/leader/start.web.ts
+var start_web_default = defineLeaderBinding({
+	path: [{
+		key: "l",
+		label: "loops",
+		detail: "recurring prompt loops"
+	}, {
+		key: "s",
+		label: "start",
+		detail: "begin a recurring loop"
+	}],
+	command: "loop"
+});
+//#endregion
+//#region src/extensions/workspaces/sessions/(frontend)/mode/loop/mode.web.ts
+var mode_web_default = defineMinorModeFile({
+	keys: "l l",
+	statusKey: "doom-loop",
+	activityGroup: "loops",
+	order: 30
+});
+//#endregion
+//#region src/extensions/workspaces/sessions/(frontend)/slot/items.web.ts
+var items_web_default = defineSlotFile({});
+//#endregion
+//#region src/extensions/workspaces/sessions/(frontend)/slot/registration.web.ts
+var registration_web_default = defineSlotFile({});
+//#endregion
+//#region generated/web.ts
+const via = (identity, value) => ({
+	...identity,
+	...value
+});
+const webPlugin = defineWebPlugin({
+	id: "loop",
+	session: {
+		get activityGroups() {
+			return [via({ name: "loops" }, loops_web_default)];
+		},
+		get fills() {
+			return [via({
+				slot: "loop.items",
+				id: "instances"
+			}, Instances_loop_items_web_default), via({
+				slot: "activity.loops",
+				id: "loops"
+			}, Loops_activity_loops_web_default)];
+		},
+		get leaderBindings() {
+			return [via({ id: "loop.list" }, list_web_default), via({ id: "loop.start" }, start_web_default)];
+		},
+		get minorModes() {
+			return [via({ name: "loop" }, mode_web_default)];
+		},
+		get slots() {
+			return [via({ slot: "loop.items" }, items_web_default), via({ slot: "loop.registration" }, registration_web_default)];
+		}
+	}
+});
+//#endregion
+export { webPlugin };
+
+//# sourceMappingURL=web.mjs.map