@agimon-ai/doompi-hook 0.0.1-alpha.8 → 0.0.1-alpha.80

package/README.md

@@ -12,7 +12,7 @@ after one, at session start, when the agent settles, and at session end. Command
 ## Requirements
 
 - Node.js 22.19.0 or newer
-- Pi 0.84.2
+- Pi 0.85.0
 - `/bin/bash`
 
 Configure hooks in `.doom/hooks.yaml`:
@@ -41,8 +41,9 @@ repository group replaces the global group of the same ID outright.
 
 ## Activation
 
-The DoomPi distribution activates this package by default. Layers only declare the `hookGroups`
-that should run in a major mode:
+The distribution activates this package by default through the `default.packages` list written by
+`doompi init` and `dpi init` in `.doom/modes.yaml`. Keep it there, or declare it in a selected layer,
+for hooks to run. Layers only declare the `hookGroups` to select; they do not define the hook commands:
 
 ```yaml
 # .doom/modes.yaml
@@ -90,7 +91,7 @@ is withdrawn when the package or Help provider unloads.
 
 ## Install
 
-DoomPi already includes this package. For standalone Pi installation:
+For standalone Pi installation:
 
 ```bash
 pi install npm:@agimon-ai/doompi-hook
@@ -117,3 +118,9 @@ Maintained by [Agimon](https://agimon.ai/about).
 ## License
 
 MIT
+
+## Extension lifecycle and source layout
+
+`extensions/pi.ts` declares Config-dependent service bindings, typed controller events, and Help resources. The readiness gate in `services/hookRuntime/` keeps session-start hooks ahead of dependent events and rejects stale generations. Session-end hooks finish during `session_shutdown` before the shared helper disposes the service binding.
+
+`extensions/server.ts` declares the server hooks from `controllers/serverHooks.ts`. Controllers dispatch through `services/<name>/`; constants and shared types have their own roots. Flat `exports/` publishes reusable capabilities, and extension entry points are built directly.

package/dist/apiContracts.cjs

@@ -0,0 +1,17 @@
+Object.defineProperties(exports, {
+	__esModule: { value: true },
+	[Symbol.toStringTag]: { value: "Module" }
+});
+//#region src/schemas/apiContracts.ts
+/** This facet contributes agent tools, commands or lifecycle only, with no separate HTTP or socket surface. */
+const apiContracts = (0, require("@agimon-ai/doompi-core/apiContracts").defineApiContract)({
+	version: 1,
+	http: [],
+	sockets: [],
+	dynamic: []
+});
+//#endregion
+exports.apiContracts = apiContracts;
+exports.default = apiContracts;
+
+//# sourceMappingURL=apiContracts.cjs.map

package/dist/apiContracts.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"apiContracts.cjs","names":["defineApiContract"],"sources":["../src/schemas/apiContracts.ts"],"sourcesContent":["import { defineApiContract } from '@agimon-ai/doompi-core/apiContracts';\n\n/** This facet contributes agent tools, commands or lifecycle only, with no separate HTTP or socket surface. */\nexport const apiContracts = defineApiContract({ version: 1, http: [], sockets: [], dynamic: [] });\nexport default apiContracts;\n"],"mappings":";;;;;;AAGA,MAAa,gBAAA,gDAAeA,CAAAA,CAAAA,kBAAAA,CAAkB;CAAE,SAAS;CAAG,MAAM,CAAC;CAAG,SAAS,CAAC;CAAG,SAAS,CAAC;AAAE,CAAC"}

package/dist/apiContracts.d.mts

@@ -0,0 +1,53 @@
+//#region src/schemas/apiContracts.d.ts
+/** This facet contributes agent tools, commands or lifecycle only, with no separate HTTP or socket surface. */
+export declare const apiContracts: {
+  version: 1;
+  protocols?: Record<string, string> | undefined;
+  schemas?: Record<string, boolean | object> | undefined;
+  http: {
+    id: string;
+    scope: "global" | "session" | "workspace";
+    basePath?: string | undefined;
+    path: string;
+    method: "DELETE" | "GET" | "HEAD" | "OPTIONS" | "PATCH" | "POST" | "PUT";
+    description: string;
+    availability?: string | undefined;
+    authentication: "device" | "none" | "owner";
+    parameters?: {
+      name: string;
+      in: "header" | "path" | "query";
+      required: boolean;
+      schema: boolean | object;
+    }[] | undefined;
+    body?: {
+      contentType: string;
+      contentTypes?: string[] | undefined;
+      required: boolean;
+      schema: boolean | object;
+    } | undefined;
+    responses: Record<string, {
+      description: string;
+      contentType?: string | undefined;
+      schema?: boolean | object | undefined;
+      events?: Record<string, boolean | object> | undefined;
+    }>;
+  }[];
+  sockets: {
+    id: string;
+    scope: "global" | "session" | "workspace";
+    description: string;
+    availability?: string | undefined;
+    service: string;
+    member: string;
+    direction: "client-to-server" | "server-to-client";
+    kind: "channel" | "method" | "state";
+    input: boolean | object;
+    output?: boolean | object | undefined;
+    errors?: boolean | object | undefined;
+  }[];
+  dynamic: string[];
+  gaps?: string[] | undefined;
+};
+//#endregion
+export { apiContracts as default };
+//# sourceMappingURL=apiContracts.d.mts.map

package/dist/apiContracts.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"apiContracts.d.mts","names":[],"sources":["../src/schemas/apiContracts.ts"],"mappings":";;qBAGa"}

package/dist/apiContracts.mjs

@@ -0,0 +1,13 @@
+import { defineApiContract } from "@agimon-ai/doompi-core/apiContracts";
+//#region src/schemas/apiContracts.ts
+/** This facet contributes agent tools, commands or lifecycle only, with no separate HTTP or socket surface. */
+const apiContracts = defineApiContract({
+	version: 1,
+	http: [],
+	sockets: [],
+	dynamic: []
+});
+//#endregion
+export { apiContracts, apiContracts as default };
+
+//# sourceMappingURL=apiContracts.mjs.map

package/dist/apiContracts.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"apiContracts.mjs","names":[],"sources":["../src/schemas/apiContracts.ts"],"sourcesContent":["import { defineApiContract } from '@agimon-ai/doompi-core/apiContracts';\n\n/** This facet contributes agent tools, commands or lifecycle only, with no separate HTTP or socket surface. */\nexport const apiContracts = defineApiContract({ version: 1, http: [], sockets: [], dynamic: [] });\nexport default apiContracts;\n"],"mappings":";;;AAGA,MAAa,eAAe,kBAAkB;CAAE,SAAS;CAAG,MAAM,CAAC;CAAG,SAAS,CAAC;CAAG,SAAS,CAAC;AAAE,CAAC"}

package/dist/extensions/mcp.cjs

@@ -0,0 +1,26 @@
+Object.defineProperties(exports, {
+	__esModule: { value: true },
+	[Symbol.toStringTag]: { value: "Module" }
+});
+let _agimon_ai_doompi_core_mcpFacet = require("@agimon-ai/doompi-core/mcpFacet");
+let _agimon_ai_doompi_core_serverFacet = require("@agimon-ai/doompi-core/serverFacet");
+//#region src/extensions/workspaces/sessions/(backend)/skill/doompi-author-hook.mcp.ts
+var doompi_author_hook_mcp_default = (0, _agimon_ai_doompi_core_mcpFacet.defineMcpSkill)({
+	name: "doompi-author-hook",
+	description: "Author DoomPi repository or plugin hooks. Use when creating or changing .doom/hooks.yaml, selecting hook groups from modes.yaml, writing hook commands, or adapting Claude Code hook payloads and decisions to DoomPi.",
+	read: () => (0, _agimon_ai_doompi_core_serverFacet.readPackageResource)(require("url").pathToFileURL(__filename).href, "src/prompts/doompi-author-hook/SKILL.md")
+});
+//#endregion
+//#region generated/mcp.ts
+const at = (value, context) => typeof value === "function" ? value(context) : value;
+const mcp = (0, _agimon_ai_doompi_core_mcpFacet.defineMcpPlugin)({
+	name: "@agimon-ai/doompi-hook",
+	session: (context) => ({ get skills() {
+		return [at(doompi_author_hook_mcp_default, context)];
+	} })
+});
+//#endregion
+exports.default = mcp;
+exports.mcp = mcp;
+
+//# sourceMappingURL=mcp.cjs.map

package/dist/extensions/mcp.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp.cjs","names":["defineMcpSkill","readPackageResource","defineMcpPlugin","skillDoompiAuthorHook"],"sources":["../../src/extensions/workspaces/sessions/(backend)/skill/doompi-author-hook.mcp.ts","../../generated/mcp.ts"],"sourcesContent":["import { defineMcpSkill } from '@agimon-ai/doompi-core/mcpFacet';\nimport { readPackageResource } from '@agimon-ai/doompi-core/serverFacet';\n\nexport default defineMcpSkill({\n  name: 'doompi-author-hook',\n  description:\n    'Author DoomPi repository or plugin hooks. Use when creating or changing .doom/hooks.yaml, selecting hook groups from modes.yaml, writing hook commands, or adapting Claude Code hook payloads and decisions to DoomPi.',\n  read: () => readPackageResource(import.meta.url, 'src/prompts/doompi-author-hook/SKILL.md'),\n});\n","// Generated by @agimon-ai/doompi-build. Do not edit by hand.\nimport { defineMcpPlugin, type DoomMcpSessionPlugin } from '@agimon-ai/doompi-core/mcpFacet';\n\nimport skillDoompiAuthorHook from '../src/extensions/workspaces/sessions/(backend)/skill/doompi-author-hook.mcp';\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 mcp = defineMcpPlugin({\n  name: '@agimon-ai/doompi-hook',\n  session: (context) => ({\n    get skills(): DoomMcpSessionPlugin['skills'] { return [at(skillDoompiAuthorHook, context)]; },\n  }) satisfies DoomMcpSessionPlugin,\n});\n\nexport default mcp;\n"],"mappings":";;;;;;;AAGA,IAAA,kCAAA,GAAeA,gCAAAA,eAAAA,CAAe;CAC5B,MAAM;CACN,aACE;CACF,aAAA,GAAYC,mCAAAA,oBAAAA,CAAAA,QAAAA,KAAAA,CAAAA,CAAAA,cAAAA,UAAAA,CAAAA,CAAAA,MAAqC,yCAAyC;AAC5F,CAAC;;;ACFD,MAAM,MAAY,OAA0B,YAC1C,OAAO,UAAU,aAAc,MAAwB,OAAO,IAAI;AAEpE,MAAa,OAAA,GAAMC,gCAAAA,gBAAAA,CAAgB;CACjC,MAAM;CACN,UAAU,aAAa,EACrB,IAAI,SAAyC;EAAE,OAAO,CAAC,GAAGC,gCAAuB,OAAO,CAAC;CAAG,EAC9F;AACF,CAAC"}

package/dist/extensions/mcp.d.mts

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

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

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

package/dist/extensions/mcp.mjs

@@ -0,0 +1,21 @@
+import { defineMcpPlugin, defineMcpSkill } from "@agimon-ai/doompi-core/mcpFacet";
+import { readPackageResource } from "@agimon-ai/doompi-core/serverFacet";
+//#region src/extensions/workspaces/sessions/(backend)/skill/doompi-author-hook.mcp.ts
+var doompi_author_hook_mcp_default = defineMcpSkill({
+	name: "doompi-author-hook",
+	description: "Author DoomPi repository or plugin hooks. Use when creating or changing .doom/hooks.yaml, selecting hook groups from modes.yaml, writing hook commands, or adapting Claude Code hook payloads and decisions to DoomPi.",
+	read: () => readPackageResource(import.meta.url, "src/prompts/doompi-author-hook/SKILL.md")
+});
+//#endregion
+//#region generated/mcp.ts
+const at = (value, context) => typeof value === "function" ? value(context) : value;
+const mcp = defineMcpPlugin({
+	name: "@agimon-ai/doompi-hook",
+	session: (context) => ({ get skills() {
+		return [at(doompi_author_hook_mcp_default, context)];
+	} })
+});
+//#endregion
+export { mcp as default, mcp };
+
+//# sourceMappingURL=mcp.mjs.map

package/dist/extensions/mcp.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp.mjs","names":["skillDoompiAuthorHook"],"sources":["../../src/extensions/workspaces/sessions/(backend)/skill/doompi-author-hook.mcp.ts","../../generated/mcp.ts"],"sourcesContent":["import { defineMcpSkill } from '@agimon-ai/doompi-core/mcpFacet';\nimport { readPackageResource } from '@agimon-ai/doompi-core/serverFacet';\n\nexport default defineMcpSkill({\n  name: 'doompi-author-hook',\n  description:\n    'Author DoomPi repository or plugin hooks. Use when creating or changing .doom/hooks.yaml, selecting hook groups from modes.yaml, writing hook commands, or adapting Claude Code hook payloads and decisions to DoomPi.',\n  read: () => readPackageResource(import.meta.url, 'src/prompts/doompi-author-hook/SKILL.md'),\n});\n","// Generated by @agimon-ai/doompi-build. Do not edit by hand.\nimport { defineMcpPlugin, type DoomMcpSessionPlugin } from '@agimon-ai/doompi-core/mcpFacet';\n\nimport skillDoompiAuthorHook from '../src/extensions/workspaces/sessions/(backend)/skill/doompi-author-hook.mcp';\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 mcp = defineMcpPlugin({\n  name: '@agimon-ai/doompi-hook',\n  session: (context) => ({\n    get skills(): DoomMcpSessionPlugin['skills'] { return [at(skillDoompiAuthorHook, context)]; },\n  }) satisfies DoomMcpSessionPlugin,\n});\n\nexport default mcp;\n"],"mappings":";;;AAGA,IAAA,iCAAe,eAAe;CAC5B,MAAM;CACN,aACE;CACF,YAAY,oBAAoB,YAAY,KAAK,yCAAyC;AAC5F,CAAC;;;ACFD,MAAM,MAAY,OAA0B,YAC1C,OAAO,UAAU,aAAc,MAAwB,OAAO,IAAI;AAEpE,MAAa,MAAM,gBAAgB;CACjC,MAAM;CACN,UAAU,aAAa,EACrB,IAAI,SAAyC;EAAE,OAAO,CAAC,GAAGA,gCAAuB,OAAO,CAAC;CAAG,EAC9F;AACF,CAAC"}

package/dist/extensions/pi.cjs

@@ -1 +1,373 @@
-Object.defineProperties(exports,{__esModule:{value:!0},[Symbol.toStringTag]:{value:`Module`}});const e=require("../adapters/pi/extension.cjs");exports.default=e.default,exports.hookExtension=e.default;
+Object.defineProperties(exports, {
+	__esModule: { value: true },
+	[Symbol.toStringTag]: { value: "Module" }
+});
+const require_hooks = require("../hooks-CReMXrU9.cjs");
+let _agimon_ai_doompi_core_piExtension = require("@agimon-ai/doompi-core/piExtension");
+let _agimon_ai_doompi_core_extensionFile = require("@agimon-ai/doompi-core/extensionFile");
+let _agimon_ai_doompi_config_piContext = require("@agimon-ai/doompi-config/piContext");
+let _agimon_ai_doompi_core_config = require("@agimon-ai/doompi-core/config");
+let _agimon_ai_doompi_core_readiness = require("@agimon-ai/doompi-core/readiness");
+//#region src/constants/hookHandlers.ts
+const STATUS_PREFIX = "repository-hooks";
+const FAILURE_MESSAGE_TYPE = "repository-hook-failure";
+const CONTEXT_MESSAGE_TYPE = "repository-hook-context";
+/** A Stop hook refused the stop; its reason sends the agent back to work. */
+const STOP_BLOCK_MESSAGE_TYPE = "repository-hook-stop-block";
+const STEER = { deliverAs: "steer" };
+/** Starts a new turn on a settled agent, so a refused stop is not a silent one. */
+const FOLLOW_UP_TURN = {
+	deliverAs: "followUp",
+	triggerTurn: true
+};
+/** Adds a message to a settled agent's conversation without starting a turn. */
+const NO_TURN = { triggerTurn: false };
+/** Claude's Stop hook input field: true when the agent is already continuing because of a Stop hook. */
+const STOP_HOOK_ACTIVE_FIELD = "stop_hook_active";
+const SUBAGENT_ENVIRONMENT_FLAG = "PI_SUBAGENT_CHILD";
+//#endregion
+//#region src/services/hookHandlers/index.ts
+/**
+* Registry rows plus plugin hooks for one event, in that order.
+*
+* Both sources are read on every dispatch because either can change mid-session:
+* /mode switches the selected groups and a plugin can rewrite its own config.
+*/
+async function resolveHooks(session, ctx, eventName, toolName) {
+	const harness = session.config().harness;
+	const repoRoot = harness.root ?? ctx.cwd;
+	const [registry, plugins] = await Promise.all([session.documents.registry(repoRoot), session.documents.plugins(harness.pluginHooks)]);
+	const hooks = [...require_hooks.selectRegistryHooks(registry.entries, {
+		event: eventName,
+		toolName,
+		allowedGroups: harness.hookGroups,
+		inSubagent: Boolean(process.env[SUBAGENT_ENVIRONMENT_FLAG])
+	}), ...require_hooks.selectPluginHooks(plugins.documents, eventName, toolName)];
+	return {
+		repoRoot,
+		sessionId: ctx.sessionManager.getSessionId(),
+		hooks,
+		failures: [...registry.failure ? [registry.failure] : [], ...plugins.failures]
+	};
+}
+/** Session end is plugin-only: the registry has no binding for it. */
+async function resolvePluginHooks(session, ctx, eventName) {
+	const harness = session.config().harness;
+	const plugins = await session.documents.plugins(harness.pluginHooks);
+	return {
+		repoRoot: harness.root ?? ctx.cwd,
+		sessionId: ctx.sessionManager.getSessionId(),
+		hooks: require_hooks.selectPluginHooks(plugins.documents, eventName),
+		failures: plugins.failures
+	};
+}
+async function runHooks(session, ctx, dispatch, payload, statusKey, statusLabel) {
+	const outcomes = [];
+	try {
+		for (const [index, resolved] of dispatch.hooks.entries()) {
+			if (ctx.hasUI) ctx.ui.setStatus(statusKey, `${statusLabel} (${index + 1}/${dispatch.hooks.length})...`);
+			outcomes.push(await session.runner.run(resolved.hook, payload, {
+				repoRoot: dispatch.repoRoot,
+				pluginRoot: resolved.root
+			}));
+		}
+	} finally {
+		if (ctx.hasUI) ctx.ui.setStatus(statusKey, void 0);
+	}
+	return outcomes;
+}
+function allFailures(dispatch, outcomes) {
+	return [...dispatch.failures, ...require_hooks.failuresFrom(outcomes)];
+}
+function steerHookFailures(pi, failures) {
+	if (failures.length === 0) return;
+	pi.sendMessage({
+		customType: FAILURE_MESSAGE_TYPE,
+		content: require_hooks.hookFailureMessage(failures),
+		display: true
+	}, STEER);
+}
+async function runSessionStartHooks(pi, session, ctx, signal, isCurrent = () => true) {
+	signal?.throwIfAborted();
+	const dispatch = await resolveHooks(session, ctx, require_hooks.HOOK_EVENT.sessionStart);
+	signal?.throwIfAborted();
+	const outcomes = await runHooks(session, ctx, dispatch, require_hooks.sessionHookPayload(dispatch.sessionId, dispatch.repoRoot), `${STATUS_PREFIX}:${dispatch.sessionId}:start`, "Running session-start hooks");
+	signal?.throwIfAborted();
+	if (!isCurrent()) return;
+	steerHookFailures(pi, allFailures(dispatch, outcomes));
+	const context = require_hooks.additionalContextsFrom(require_hooks.decisionsFrom(outcomes)).join("\n\n");
+	if (context) pi.sendMessage({
+		customType: CONTEXT_MESSAGE_TYPE,
+		content: context,
+		display: true
+	}, STEER);
+}
+function createSessionStart(pi, resolveRuntime) {
+	return (_event, ctx) => {
+		const runtime = resolveRuntime();
+		if (!runtime?.isCurrent()) return void 0;
+		const { readiness, session } = runtime;
+		if (readiness) return readiness.start(ctx, (signal, isReady) => runSessionStartHooks(pi, session, ctx, signal, () => runtime.isCurrent() && isReady()));
+		return runSessionStartHooks(pi, session, ctx);
+	};
+}
+function createBeforeAgentStart(_pi, resolveRuntime) {
+	return async (_event, ctx) => {
+		const runtime = resolveRuntime();
+		if (!runtime?.isCurrent()) return;
+		await runtime.readiness?.wait(ctx);
+	};
+}
+function createToolCall(pi, resolveRuntime) {
+	return async (event, ctx) => {
+		const runtime = resolveRuntime();
+		if (!runtime?.isCurrent()) return void 0;
+		await runtime.readiness?.wait(ctx);
+		if (!runtime.isCurrent()) return void 0;
+		const dispatch = await resolveHooks(runtime.session, ctx, require_hooks.HOOK_EVENT.preToolUse, event.toolName);
+		if (!runtime.isCurrent()) return void 0;
+		const payload = require_hooks.toolHookPayload(event, require_hooks.HOOK_EVENT.preToolUse, dispatch.repoRoot, dispatch.sessionId);
+		const outcomes = await runHooks(runtime.session, ctx, dispatch, payload, `${STATUS_PREFIX}:${event.toolCallId}:pre`, `Running pre-tool hooks for ${event.toolName}`);
+		if (!runtime.isCurrent()) return void 0;
+		const decisions = require_hooks.decisionsFrom(outcomes);
+		steerHookFailures(pi, allFailures(dispatch, outcomes));
+		const denied = decisions.find(require_hooks.isDenied);
+		if (denied) return {
+			block: true,
+			reason: require_hooks.decisionReason(denied) ?? "Blocked by repository hook"
+		};
+		const context = require_hooks.additionalContextsFrom(decisions).join("\n\n");
+		return context ? {
+			block: true,
+			reason: context
+		} : void 0;
+	};
+}
+function createToolResult(_pi, resolveRuntime) {
+	return async (event, ctx) => {
+		const runtime = resolveRuntime();
+		if (!runtime?.isCurrent()) return void 0;
+		await runtime.readiness?.wait(ctx);
+		if (!runtime.isCurrent()) return void 0;
+		const dispatch = await resolveHooks(runtime.session, ctx, require_hooks.HOOK_EVENT.postToolUse, event.toolName);
+		if (!runtime.isCurrent()) return void 0;
+		const payload = require_hooks.toolHookPayload(event, require_hooks.HOOK_EVENT.postToolUse, dispatch.repoRoot, dispatch.sessionId);
+		const outcomes = await runHooks(runtime.session, ctx, dispatch, payload, `${STATUS_PREFIX}:${event.toolCallId}:post`, `Running post-tool hooks for ${event.toolName}`);
+		if (!runtime.isCurrent()) return void 0;
+		const decisions = require_hooks.decisionsFrom(outcomes);
+		const failures = allFailures(dispatch, outcomes);
+		const messages = require_hooks.toolResultMessages(decisions);
+		if (failures.length > 0) messages.push(require_hooks.hookFailureMessage(failures));
+		if (messages.length === 0) return void 0;
+		return {
+			content: [...event.content, {
+				type: "text",
+				text: messages.join("\n\n")
+			}],
+			isError: event.isError || decisions.some(require_hooks.isDenied)
+		};
+	};
+}
+function createAgentSettled(pi, resolveRuntime) {
+	let refusals = 0;
+	return async (_event, ctx) => {
+		const runtime = resolveRuntime();
+		if (!runtime?.isCurrent()) return;
+		await runtime.readiness?.wait(ctx);
+		if (!runtime.isCurrent()) return;
+		const dispatch = await resolveHooks(runtime.session, ctx, require_hooks.HOOK_EVENT.stop);
+		if (!runtime.isCurrent()) return;
+		const outcomes = await runHooks(runtime.session, ctx, dispatch, {
+			...require_hooks.sessionHookPayload(dispatch.sessionId, dispatch.repoRoot),
+			[STOP_HOOK_ACTIVE_FIELD]: refusals > 0
+		}, `${STATUS_PREFIX}:${dispatch.sessionId}:stop`, "Running stop hooks");
+		if (!runtime.isCurrent()) return;
+		const reason = require_hooks.decisionReason(require_hooks.decisionsFrom(outcomes).find(require_hooks.isDenied));
+		if (!reason) {
+			refusals = 0;
+			return;
+		}
+		if (refusals >= 5) {
+			refusals = 0;
+			pi.sendMessage({
+				customType: FAILURE_MESSAGE_TYPE,
+				content: `A Stop hook refused ${String(5)} stops in a row, so the agent stops here. Its last reason: ${reason}`,
+				display: true
+			}, NO_TURN);
+			return;
+		}
+		refusals += 1;
+		pi.sendMessage({
+			customType: STOP_BLOCK_MESSAGE_TYPE,
+			content: reason,
+			display: true
+		}, FOLLOW_UP_TURN);
+	};
+}
+function createHookHandlers(pi, resolveRuntime) {
+	let shutdown;
+	return {
+		session_start: createSessionStart(pi, resolveRuntime),
+		before_agent_start: createBeforeAgentStart(pi, resolveRuntime),
+		tool_call: createToolCall(pi, resolveRuntime),
+		tool_result: createToolResult(pi, resolveRuntime),
+		agent_settled: createAgentSettled(pi, resolveRuntime),
+		session_shutdown: (_event, ctx) => {
+			const current = resolveRuntime();
+			if (!current?.isCurrent()) return void 0;
+			shutdown ??= runSessionEndHooks(current.session, ctx);
+			return shutdown;
+		}
+	};
+}
+/** Runs the plugin SessionEnd hooks while the session is still usable. */
+async function runSessionEndHooks(session, ctx) {
+	const dispatch = await resolvePluginHooks(session, ctx, require_hooks.HOOK_EVENT.sessionEnd);
+	await runHooks(session, ctx, dispatch, require_hooks.sessionHookPayload(dispatch.sessionId, dispatch.repoRoot), `${STATUS_PREFIX}:${dispatch.sessionId}:end`, "Running session-end hooks");
+}
+//#endregion
+//#region src/constants/hook.ts
+const PACKAGE_SOURCE = "@agimon-ai/doompi-hook";
+const HOOK_HELP_SKILL = {
+	name: "doompi-author-hook",
+	description: "Author DoomPi repository or plugin hooks. Use when creating or changing .doom/hooks.yaml, selecting hook groups from modes.yaml, writing hook commands, or adapting Claude Code hook payloads and decisions to DoomPi."
+};
+//#endregion
+//#region src/services/hookRuntime/index.ts
+function hookSession(cordis, options) {
+	let telemetry = options.telemetry;
+	const requireTelemetry = () => telemetry ??= require_hooks.createHookTelemetry();
+	return {
+		config: () => (0, _agimon_ai_doompi_config_piContext.requireDoomConfigContext)(cordis),
+		runner: options.runner ?? require_hooks.createBashHookRunner({ telemetry: requireTelemetry() }),
+		documents: options.documents ?? require_hooks.createHookDocumentReader({ telemetry: requireTelemetry() })
+	};
+}
+function createHookRuntime(cordis, options) {
+	const session = hookSession(cordis, options);
+	let active = true;
+	let generation = 0;
+	let readiness;
+	return {
+		session,
+		readiness: {
+			start(context, operation) {
+				const ownGeneration = ++generation;
+				const isCurrent = () => active && ownGeneration === generation;
+				const coordinator = (0, _agimon_ai_doompi_core_readiness.readDoomReadinessCoordinator)(cordis);
+				if (!coordinator) return operation(new AbortController().signal, isCurrent);
+				const previous = readiness;
+				const readinessOperation = (async () => {
+					if (previous?.coordinator === coordinator) await previous.operation.catch(() => void 0);
+					if (!isCurrent()) return;
+					await coordinator.start(PACKAGE_SOURCE, `${context.sessionManager.getSessionId()}:${ownGeneration}`, async (signal) => {
+						await operation(signal, isCurrent);
+						return { value: void 0 };
+					}).wait();
+				})();
+				readinessOperation.catch(() => void 0);
+				readiness = {
+					sessionManager: context.sessionManager,
+					coordinator,
+					operation: readinessOperation
+				};
+			},
+			async wait(context) {
+				const current = readiness;
+				if (!current) return;
+				if (current.sessionManager !== context.sessionManager) throw new Error("Hook readiness belongs to a stale Pi session.");
+				await current.operation;
+				if (!active || current !== readiness) throw new Error("Hook readiness belongs to a stale extension generation.");
+			}
+		},
+		isCurrent: () => active,
+		dispose() {
+			active = false;
+			generation += 1;
+			readiness = void 0;
+		}
+	};
+}
+function createHookBinding(options) {
+	let runtime;
+	return {
+		plugin(cordis) {
+			cordis.inject([_agimon_ai_doompi_core_config.DOOM_CONFIG_SERVICE], (configContext) => {
+				const binding = createHookRuntime(configContext, options);
+				runtime = binding;
+				return () => {
+					binding.dispose();
+					if (runtime === binding) runtime = void 0;
+				};
+			});
+		},
+		runtime: () => runtime
+	};
+}
+//#endregion
+//#region src/extensions/workspaces/sessions/(backend)/_lib/piRoot.ts
+const createHookPiRoot = ({ pi, options }) => {
+	const binding = createHookBinding(options ?? {});
+	return {
+		value: createHookHandlers(pi, binding.runtime),
+		services: [binding.plugin]
+	};
+};
+//#endregion
+//#region src/extensions/workspaces/sessions/(backend)/root.cli.ts
+var root_cli_default = (0, _agimon_ai_doompi_core_extensionFile.defineRoot)(createHookPiRoot);
+//#endregion
+//#region src/extensions/workspaces/sessions/(backend)/hook/agent-settled.cli.ts
+var agent_settled_cli_default = (0, _agimon_ai_doompi_core_extensionFile.defineCliHook)((context) => context.root.agent_settled);
+//#endregion
+//#region src/extensions/workspaces/sessions/(backend)/hook/before-agent-start.cli.ts
+var before_agent_start_cli_default = (0, _agimon_ai_doompi_core_extensionFile.defineCliHook)((context) => context.root.before_agent_start);
+//#endregion
+//#region src/extensions/workspaces/sessions/(backend)/hook/session-shutdown.cli.ts
+var session_shutdown_cli_default = (0, _agimon_ai_doompi_core_extensionFile.defineCliHook)((context) => context.root.session_shutdown);
+//#endregion
+//#region src/extensions/workspaces/sessions/(backend)/hook/session-start.cli.ts
+var session_start_cli_default = (0, _agimon_ai_doompi_core_extensionFile.defineCliHook)((context) => context.root.session_start);
+//#endregion
+//#region src/extensions/workspaces/sessions/(backend)/hook/tool-call.cli.ts
+var tool_call_cli_default = (0, _agimon_ai_doompi_core_extensionFile.defineCliHook)((context) => context.root.tool_call);
+//#endregion
+//#region src/extensions/workspaces/sessions/(backend)/hook/tool-result.cli.ts
+var tool_result_cli_default = (0, _agimon_ai_doompi_core_extensionFile.defineCliHook)((context) => context.root.tool_result);
+//#endregion
+//#region src/extensions/workspaces/sessions/(backend)/resource/doompi-use-hook.cli.ts
+var doompi_use_hook_cli_default = (0, _agimon_ai_doompi_core_extensionFile.defineResource)({
+	source: PACKAGE_SOURCE,
+	moduleUrl: require("url").pathToFileURL(__filename).href,
+	skills: [HOOK_HELP_SKILL]
+});
+//#endregion
+//#region generated/pi.ts
+const at = (value, context) => typeof value === "function" ? value(context) : value;
+const extension = (0, _agimon_ai_doompi_core_piExtension.definePiExtension)("@agimon-ai/doompi-hook", async (context) => {
+	const scopeSession = await root_cli_default(context);
+	const contextSession = {
+		...context,
+		root: scopeSession.value
+	};
+	return {
+		...(0, _agimon_ai_doompi_core_extensionFile.composeRootHooks)(scopeSession),
+		events: {
+			agent_settled: at(agent_settled_cli_default, contextSession),
+			before_agent_start: at(before_agent_start_cli_default, contextSession),
+			session_shutdown: at(session_shutdown_cli_default, contextSession),
+			session_start: at(session_start_cli_default, contextSession),
+			tool_call: at(tool_call_cli_default, contextSession),
+			tool_result: at(tool_result_cli_default, contextSession)
+		},
+		get resources() {
+			return [at(doompi_use_hook_cli_default, contextSession)];
+		},
+		services: [...scopeSession.services ?? []]
+	};
+});
+//#endregion
+exports.default = extension;
+exports.extension = extension;
+
+//# sourceMappingURL=pi.cjs.map