@code-yeongyu/senpi 2026.6.21 → 2026.6.30

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

@@ -0,0 +1,216 @@
+import { existsSync, readFileSync } from "node:fs";
+import { registerHooksCommand } from "./command.js";
+import { loadHookConfigSources } from "./config-loader.js";
+import { dispatchHookEvent } from "./dispatcher.js";
+import { buildPostCompactHookInput, buildPreCompactHookInput, buildSessionStartHookInput, dispatchLifecycleHookEvent, postCompactResultDetails, preCompactResultDetails, recordLifecycleHookResult, sessionBeforeCompactResult, sessionStartResultDetails, } from "./lifecycle-adapter.js";
+import { appendSystemMessages, buildUserPromptHookInput, formatPromptContextMessage, HOOK_CUSTOM_MESSAGE_TYPE, promptBlockReasonFromResult, promptContextFromResult, safeDiagnosticDetails, } from "./prompt-adapter.js";
+import { applyStopHookResult, buildStopHookInput, createStopTurnTracker } from "./stop-adapter.js";
+import { applyPostToolUseResult, applyPreToolUseResult, buildPostToolUseHookInput, buildPreToolUseHookInput, toolContextsFromResult, } from "./tool-adapter.js";
+import { emptyHookTrustState } from "./trust.js";
+import { FileHookStateStorage } from "./trust-storage.js";
+export { parseHookConfig } from "./schema.js";
+export default function hooksExtension(pi) {
+    const pendingPromptContexts = [];
+    const pendingPreToolContexts = new Map();
+    const stopTurnTracker = createStopTurnTracker();
+    const refreshState = (ctx) => {
+        const sources = ctx.getLoadedHookSources?.() ?? fallbackHookSources(ctx.cwd);
+        const parsed = loadHookConfigSources({
+            agentDir: sources.agentDir,
+            cwd: sources.cwd,
+            fileSystem: {
+                readTextFile(path) {
+                    return existsSync(path) ? readFileSync(path, "utf-8") : undefined;
+                },
+            },
+            globalHookSourcePaths: sources.globalHookSourcePaths,
+            globalHooksPath: sources.globalHooksPath,
+            globalSettingsHooks: sources.globalSettingsHooks,
+            preSessionHookSourcePaths: sources.preSessionHookSourcePaths,
+            projectHookSourcePaths: sources.projectHookSourcePaths,
+            projectHooksPath: sources.projectHooksPath,
+            projectSettingsHooks: sources.projectSettingsHooks,
+            runtimeHookSourcePaths: sources.runtimeHookSourcePaths,
+        });
+        const storage = new FileHookStateStorage({ agentDir: sources.agentDir, cwd: sources.cwd });
+        const trust = mergeTrustStates(storage.read("global"), ctx.isProjectTrusted() ? storage.read("project") : emptyHookTrustState());
+        return { parsed, trust, storage };
+    };
+    pi.on("session_start", async (event, ctx) => {
+        const state = refreshState(ctx);
+        const input = buildSessionStartHookInput(event, ctx);
+        const result = await dispatchLifecycleHookEvent({
+            cwd: ctx.cwd,
+            handlers: state.parsed.executableHandlers,
+            input,
+            matcherInputs: ["SessionStart", event.reason],
+            ...(ctx.signal === undefined ? {} : { signal: ctx.signal }),
+            trustState: state.trust,
+        });
+        recordLifecycleHookResult(pi, "SessionStart", sessionStartResultDetails(result));
+    });
+    pi.on("input", async (event, ctx) => {
+        if (event.source === "extension")
+            return undefined;
+        stopTurnTracker.reset();
+        pendingPromptContexts.splice(0);
+        const state = refreshState(ctx);
+        const input = buildUserPromptHookInput({
+            cwd: ctx.cwd,
+            permissionMode: "default",
+            prompt: event.text,
+            sessionId: ctx.sessionManager.getSessionId(),
+            transcriptPath: ctx.sessionManager.getSessionFile(),
+        });
+        const result = await dispatchHookEvent({
+            cwd: ctx.cwd,
+            handlers: state.parsed.executableHandlers,
+            input,
+            signal: ctx.signal,
+            trustOptions: { platform: process.platform },
+            trustState: state.trust,
+        });
+        if (result.decision.kind === "block") {
+            const reason = promptBlockReasonFromResult(result);
+            ctx.ui.notify(reason, "warning");
+            pi.sendMessage({
+                customType: HOOK_CUSTOM_MESSAGE_TYPE,
+                content: reason,
+                display: false,
+                details: {
+                    decision: "block",
+                    event: "UserPromptSubmit",
+                    sourcePath: result.decision.source.sourcePath,
+                },
+            }, { triggerTurn: false });
+            return { action: "handled" };
+        }
+        if (ctx.isIdle()) {
+            const pending = promptContextFromResult(result);
+            if (pending !== undefined) {
+                pendingPromptContexts.push(pending);
+            }
+        }
+        return { action: "continue" };
+    });
+    pi.on("before_agent_start", async (event) => {
+        const pending = pendingPromptContexts.shift();
+        if (pending === undefined)
+            return undefined;
+        const messageContent = formatPromptContextMessage(pending);
+        const systemPrompt = appendSystemMessages(event.systemPrompt, pending.systemMessages);
+        if (messageContent === undefined && systemPrompt === event.systemPrompt)
+            return undefined;
+        const result = {};
+        if (messageContent !== undefined) {
+            result.message = {
+                customType: HOOK_CUSTOM_MESSAGE_TYPE,
+                content: messageContent,
+                display: false,
+                details: {
+                    event: "UserPromptSubmit",
+                    diagnostics: pending.diagnostics.map(safeDiagnosticDetails),
+                },
+            };
+        }
+        if (systemPrompt !== event.systemPrompt) {
+            result.systemPrompt = systemPrompt;
+        }
+        return result;
+    });
+    pi.on("tool_call", async (event, ctx) => {
+        pendingPreToolContexts.delete(event.toolCallId);
+        const state = refreshState(ctx);
+        const result = await dispatchHookEvent({
+            cwd: ctx.cwd,
+            handlers: state.parsed.executableHandlers,
+            input: buildPreToolUseHookInput(event, ctx),
+            signal: ctx.signal,
+            trustOptions: { platform: process.platform },
+            trustState: state.trust,
+        });
+        const toolResult = applyPreToolUseResult(event, result);
+        if (toolResult?.block) {
+            pendingPreToolContexts.delete(event.toolCallId);
+            return toolResult;
+        }
+        const contexts = toolContextsFromResult(result);
+        if (contexts.length > 0) {
+            pendingPreToolContexts.set(event.toolCallId, contexts);
+        }
+        return toolResult;
+    });
+    pi.on("tool_result", async (event, ctx) => {
+        const preToolContexts = pendingPreToolContexts.get(event.toolCallId) ?? [];
+        pendingPreToolContexts.delete(event.toolCallId);
+        const state = refreshState(ctx);
+        const result = await dispatchHookEvent({
+            cwd: ctx.cwd,
+            handlers: state.parsed.executableHandlers,
+            input: buildPostToolUseHookInput(event, ctx),
+            signal: ctx.signal,
+            trustOptions: { platform: process.platform },
+            trustState: state.trust,
+        });
+        return applyPostToolUseResult(event, result, preToolContexts);
+    });
+    pi.on("session_before_compact", async (event, ctx) => {
+        const state = refreshState(ctx);
+        const result = await dispatchLifecycleHookEvent({
+            cwd: ctx.cwd,
+            handlers: state.parsed.executableHandlers,
+            input: buildPreCompactHookInput(event, ctx),
+            matcherInputs: ["PreCompact", event.reason],
+            signal: event.signal,
+            trustState: state.trust,
+        });
+        const details = preCompactResultDetails(result);
+        recordLifecycleHookResult(pi, "PreCompact", details);
+        return sessionBeforeCompactResult(details);
+    });
+    pi.on("session_compact", async (event, ctx) => {
+        if (!event.accepted)
+            return undefined;
+        const state = refreshState(ctx);
+        const result = await dispatchLifecycleHookEvent({
+            cwd: ctx.cwd,
+            handlers: state.parsed.executableHandlers,
+            input: buildPostCompactHookInput(event, ctx),
+            matcherInputs: ["PostCompact", event.reason],
+            ...(ctx.signal === undefined ? {} : { signal: ctx.signal }),
+            trustState: state.trust,
+        });
+        recordLifecycleHookResult(pi, "PostCompact", postCompactResultDetails(result));
+        return undefined;
+    });
+    pi.on("agent_end", async (event, ctx) => {
+        const state = refreshState(ctx);
+        const result = await dispatchHookEvent({
+            cwd: ctx.cwd,
+            handlers: state.parsed.executableHandlers,
+            input: buildStopHookInput(event, ctx),
+            signal: ctx.signal,
+            trustOptions: { platform: process.platform },
+            trustState: state.trust,
+        });
+        await applyStopHookResult(pi, ctx, result, stopTurnTracker.turnKey(ctx));
+    });
+    registerHooksCommand(pi, refreshState);
+}
+function mergeTrustStates(globalState, projectState) {
+    return { version: 1, hooks: { ...globalState.hooks, ...projectState.hooks } };
+}
+function fallbackHookSources(cwd) {
+    return {
+        agentDir: cwd,
+        cwd,
+        globalHookSourcePaths: [],
+        globalHooksPath: `${cwd}/hooks.json`,
+        preSessionHookSourcePaths: [],
+        projectHookSourcePaths: [],
+        projectHooksPath: `${cwd}/.senpi/hooks.json`,
+        runtimeHookSourcePaths: [],
+    };
+}
+export { SUPPORTED_HOOK_EVENTS, UNSUPPORTED_HANDLER_TYPES, UNSUPPORTED_KNOWN_HOOK_EVENTS, } from "./types.js";
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/core/extensions/builtin/hooks/index.ts"],"names":[],"mappings":"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","sourcesContent":["import { existsSync, readFileSync } from \"node:fs\";\nimport type { BeforeAgentStartEventResult, ExtensionAPI, ExtensionContext, LoadedHookSources } from \"../../types.ts\";\nimport { registerHooksCommand } from \"./command.ts\";\nimport { loadHookConfigSources } from \"./config-loader.ts\";\nimport { dispatchHookEvent } from \"./dispatcher.ts\";\nimport {\n\tbuildPostCompactHookInput,\n\tbuildPreCompactHookInput,\n\tbuildSessionStartHookInput,\n\tdispatchLifecycleHookEvent,\n\tpostCompactResultDetails,\n\tpreCompactResultDetails,\n\trecordLifecycleHookResult,\n\tsessionBeforeCompactResult,\n\tsessionStartResultDetails,\n} from \"./lifecycle-adapter.ts\";\nimport {\n\tappendSystemMessages,\n\tbuildUserPromptHookInput,\n\tformatPromptContextMessage,\n\tHOOK_CUSTOM_MESSAGE_TYPE,\n\ttype PendingPromptHookContext,\n\tpromptBlockReasonFromResult,\n\tpromptContextFromResult,\n\tsafeDiagnosticDetails,\n} from \"./prompt-adapter.ts\";\nimport { applyStopHookResult, buildStopHookInput, createStopTurnTracker } from \"./stop-adapter.ts\";\nimport {\n\tapplyPostToolUseResult,\n\tapplyPreToolUseResult,\n\tbuildPostToolUseHookInput,\n\tbuildPreToolUseHookInput,\n\ttoolContextsFromResult,\n} from \"./tool-adapter.ts\";\nimport { emptyHookTrustState } from \"./trust.ts\";\nimport { FileHookStateStorage } from \"./trust-storage.ts\";\nimport type { HookTrustState } from \"./types.ts\";\n\nexport { parseHookConfig } from \"./schema.ts\";\nexport type {\n\tCommandHookConfig,\n\tExecutableHookHandler,\n\tHookDiagnostic,\n\tHookDiagnosticCode,\n\tHookInputWire,\n\tHookOutputWire,\n\tHookRuntimeState,\n\tHookSourceMetadata,\n\tHookTrustEntry,\n\tHookTrustState,\n\tParsedHookConfig,\n\tSupportedHookEvent,\n\tUnsupportedKnownHookEvent,\n} from \"./types.ts\";\n\nexport default function hooksExtension(pi: ExtensionAPI): void {\n\tconst pendingPromptContexts: PendingPromptHookContext[] = [];\n\tconst pendingPreToolContexts = new Map<string, readonly string[]>();\n\tconst stopTurnTracker = createStopTurnTracker();\n\n\tconst refreshState = (ctx: ExtensionContext) => {\n\t\tconst sources = ctx.getLoadedHookSources?.() ?? fallbackHookSources(ctx.cwd);\n\t\tconst parsed = loadHookConfigSources({\n\t\t\tagentDir: sources.agentDir,\n\t\t\tcwd: sources.cwd,\n\t\t\tfileSystem: {\n\t\t\t\treadTextFile(path) {\n\t\t\t\t\treturn existsSync(path) ? readFileSync(path, \"utf-8\") : undefined;\n\t\t\t\t},\n\t\t\t},\n\t\t\tglobalHookSourcePaths: sources.globalHookSourcePaths,\n\t\t\tglobalHooksPath: sources.globalHooksPath,\n\t\t\tglobalSettingsHooks: sources.globalSettingsHooks,\n\t\t\tpreSessionHookSourcePaths: sources.preSessionHookSourcePaths,\n\t\t\tprojectHookSourcePaths: sources.projectHookSourcePaths,\n\t\t\tprojectHooksPath: sources.projectHooksPath,\n\t\t\tprojectSettingsHooks: sources.projectSettingsHooks,\n\t\t\truntimeHookSourcePaths: sources.runtimeHookSourcePaths,\n\t\t});\n\t\tconst storage = new FileHookStateStorage({ agentDir: sources.agentDir, cwd: sources.cwd });\n\t\tconst trust = mergeTrustStates(\n\t\t\tstorage.read(\"global\"),\n\t\t\tctx.isProjectTrusted() ? storage.read(\"project\") : emptyHookTrustState(),\n\t\t);\n\t\treturn { parsed, trust, storage };\n\t};\n\n\tpi.on(\"session_start\", async (event, ctx) => {\n\t\tconst state = refreshState(ctx);\n\t\tconst input = buildSessionStartHookInput(event, ctx);\n\t\tconst result = await dispatchLifecycleHookEvent({\n\t\t\tcwd: ctx.cwd,\n\t\t\thandlers: state.parsed.executableHandlers,\n\t\t\tinput,\n\t\t\tmatcherInputs: [\"SessionStart\", event.reason],\n\t\t\t...(ctx.signal === undefined ? {} : { signal: ctx.signal }),\n\t\t\ttrustState: state.trust,\n\t\t});\n\t\trecordLifecycleHookResult(pi, \"SessionStart\", sessionStartResultDetails(result));\n\t});\n\n\tpi.on(\"input\", async (event, ctx) => {\n\t\tif (event.source === \"extension\") return undefined;\n\t\tstopTurnTracker.reset();\n\t\tpendingPromptContexts.splice(0);\n\t\tconst state = refreshState(ctx);\n\t\tconst input = buildUserPromptHookInput({\n\t\t\tcwd: ctx.cwd,\n\t\t\tpermissionMode: \"default\",\n\t\t\tprompt: event.text,\n\t\t\tsessionId: ctx.sessionManager.getSessionId(),\n\t\t\ttranscriptPath: ctx.sessionManager.getSessionFile(),\n\t\t});\n\t\tconst result = await dispatchHookEvent({\n\t\t\tcwd: ctx.cwd,\n\t\t\thandlers: state.parsed.executableHandlers,\n\t\t\tinput,\n\t\t\tsignal: ctx.signal,\n\t\t\ttrustOptions: { platform: process.platform },\n\t\t\ttrustState: state.trust,\n\t\t});\n\t\tif (result.decision.kind === \"block\") {\n\t\t\tconst reason = promptBlockReasonFromResult(result);\n\t\t\tctx.ui.notify(reason, \"warning\");\n\t\t\tpi.sendMessage(\n\t\t\t\t{\n\t\t\t\t\tcustomType: HOOK_CUSTOM_MESSAGE_TYPE,\n\t\t\t\t\tcontent: reason,\n\t\t\t\t\tdisplay: false,\n\t\t\t\t\tdetails: {\n\t\t\t\t\t\tdecision: \"block\",\n\t\t\t\t\t\tevent: \"UserPromptSubmit\",\n\t\t\t\t\t\tsourcePath: result.decision.source.sourcePath,\n\t\t\t\t\t},\n\t\t\t\t},\n\t\t\t\t{ triggerTurn: false },\n\t\t\t);\n\t\t\treturn { action: \"handled\" };\n\t\t}\n\t\tif (ctx.isIdle()) {\n\t\t\tconst pending = promptContextFromResult(result);\n\t\t\tif (pending !== undefined) {\n\t\t\t\tpendingPromptContexts.push(pending);\n\t\t\t}\n\t\t}\n\t\treturn { action: \"continue\" };\n\t});\n\n\tpi.on(\"before_agent_start\", async (event) => {\n\t\tconst pending = pendingPromptContexts.shift();\n\t\tif (pending === undefined) return undefined;\n\n\t\tconst messageContent = formatPromptContextMessage(pending);\n\t\tconst systemPrompt = appendSystemMessages(event.systemPrompt, pending.systemMessages);\n\t\tif (messageContent === undefined && systemPrompt === event.systemPrompt) return undefined;\n\n\t\tconst result: BeforeAgentStartEventResult = {};\n\t\tif (messageContent !== undefined) {\n\t\t\tresult.message = {\n\t\t\t\tcustomType: HOOK_CUSTOM_MESSAGE_TYPE,\n\t\t\t\tcontent: messageContent,\n\t\t\t\tdisplay: false,\n\t\t\t\tdetails: {\n\t\t\t\t\tevent: \"UserPromptSubmit\",\n\t\t\t\t\tdiagnostics: pending.diagnostics.map(safeDiagnosticDetails),\n\t\t\t\t},\n\t\t\t};\n\t\t}\n\t\tif (systemPrompt !== event.systemPrompt) {\n\t\t\tresult.systemPrompt = systemPrompt;\n\t\t}\n\t\treturn result;\n\t});\n\n\tpi.on(\"tool_call\", async (event, ctx) => {\n\t\tpendingPreToolContexts.delete(event.toolCallId);\n\t\tconst state = refreshState(ctx);\n\t\tconst result = await dispatchHookEvent({\n\t\t\tcwd: ctx.cwd,\n\t\t\thandlers: state.parsed.executableHandlers,\n\t\t\tinput: buildPreToolUseHookInput(event, ctx),\n\t\t\tsignal: ctx.signal,\n\t\t\ttrustOptions: { platform: process.platform },\n\t\t\ttrustState: state.trust,\n\t\t});\n\t\tconst toolResult = applyPreToolUseResult(event, result);\n\t\tif (toolResult?.block) {\n\t\t\tpendingPreToolContexts.delete(event.toolCallId);\n\t\t\treturn toolResult;\n\t\t}\n\t\tconst contexts = toolContextsFromResult(result);\n\t\tif (contexts.length > 0) {\n\t\t\tpendingPreToolContexts.set(event.toolCallId, contexts);\n\t\t}\n\t\treturn toolResult;\n\t});\n\n\tpi.on(\"tool_result\", async (event, ctx) => {\n\t\tconst preToolContexts = pendingPreToolContexts.get(event.toolCallId) ?? [];\n\t\tpendingPreToolContexts.delete(event.toolCallId);\n\t\tconst state = refreshState(ctx);\n\t\tconst result = await dispatchHookEvent({\n\t\t\tcwd: ctx.cwd,\n\t\t\thandlers: state.parsed.executableHandlers,\n\t\t\tinput: buildPostToolUseHookInput(event, ctx),\n\t\t\tsignal: ctx.signal,\n\t\t\ttrustOptions: { platform: process.platform },\n\t\t\ttrustState: state.trust,\n\t\t});\n\t\treturn applyPostToolUseResult(event, result, preToolContexts);\n\t});\n\n\tpi.on(\"session_before_compact\", async (event, ctx) => {\n\t\tconst state = refreshState(ctx);\n\t\tconst result = await dispatchLifecycleHookEvent({\n\t\t\tcwd: ctx.cwd,\n\t\t\thandlers: state.parsed.executableHandlers,\n\t\t\tinput: buildPreCompactHookInput(event, ctx),\n\t\t\tmatcherInputs: [\"PreCompact\", event.reason],\n\t\t\tsignal: event.signal,\n\t\t\ttrustState: state.trust,\n\t\t});\n\t\tconst details = preCompactResultDetails(result);\n\t\trecordLifecycleHookResult(pi, \"PreCompact\", details);\n\t\treturn sessionBeforeCompactResult(details);\n\t});\n\n\tpi.on(\"session_compact\", async (event, ctx) => {\n\t\tif (!event.accepted) return undefined;\n\t\tconst state = refreshState(ctx);\n\t\tconst result = await dispatchLifecycleHookEvent({\n\t\t\tcwd: ctx.cwd,\n\t\t\thandlers: state.parsed.executableHandlers,\n\t\t\tinput: buildPostCompactHookInput(event, ctx),\n\t\t\tmatcherInputs: [\"PostCompact\", event.reason],\n\t\t\t...(ctx.signal === undefined ? {} : { signal: ctx.signal }),\n\t\t\ttrustState: state.trust,\n\t\t});\n\t\trecordLifecycleHookResult(pi, \"PostCompact\", postCompactResultDetails(result));\n\t\treturn undefined;\n\t});\n\n\tpi.on(\"agent_end\", async (event, ctx) => {\n\t\tconst state = refreshState(ctx);\n\t\tconst result = await dispatchHookEvent({\n\t\t\tcwd: ctx.cwd,\n\t\t\thandlers: state.parsed.executableHandlers,\n\t\t\tinput: buildStopHookInput(event, ctx),\n\t\t\tsignal: ctx.signal,\n\t\t\ttrustOptions: { platform: process.platform },\n\t\t\ttrustState: state.trust,\n\t\t});\n\t\tawait applyStopHookResult(pi, ctx, result, stopTurnTracker.turnKey(ctx));\n\t});\n\n\tregisterHooksCommand(pi, refreshState);\n}\n\nfunction mergeTrustStates(globalState: HookTrustState, projectState: HookTrustState): HookTrustState {\n\treturn { version: 1, hooks: { ...globalState.hooks, ...projectState.hooks } };\n}\n\nfunction fallbackHookSources(cwd: string): LoadedHookSources {\n\treturn {\n\t\tagentDir: cwd,\n\t\tcwd,\n\t\tglobalHookSourcePaths: [],\n\t\tglobalHooksPath: `${cwd}/hooks.json`,\n\t\tpreSessionHookSourcePaths: [],\n\t\tprojectHookSourcePaths: [],\n\t\tprojectHooksPath: `${cwd}/.senpi/hooks.json`,\n\t\truntimeHookSourcePaths: [],\n\t};\n}\n\nexport {\n\tSUPPORTED_HOOK_EVENTS,\n\tUNSUPPORTED_HANDLER_TYPES,\n\tUNSUPPORTED_KNOWN_HOOK_EVENTS,\n} from \"./types.ts\";\n"]}

package/dist/core/extensions/builtin/hooks/lifecycle-adapter.d.ts

@@ -0,0 +1,29 @@
+import type { ExtensionAPI, ExtensionContext, SessionBeforeCompactEvent, SessionBeforeCompactResult, SessionCompactEvent, SessionStartEvent } from "../../types.ts";
+import { type HookDispatchResult } from "./dispatcher.ts";
+import type { ExecutableHookHandler, HookDiagnostic, HookInputWire, HookTrustState } from "./types.ts";
+type LifecycleHookEvent = "SessionStart" | "PreCompact" | "PostCompact";
+type LifecycleDispatchOptions = {
+    readonly cwd: string;
+    readonly handlers: readonly ExecutableHookHandler[];
+    readonly input: HookInputWire;
+    readonly matcherInputs: readonly string[];
+    readonly signal?: AbortSignal;
+    readonly trustState: HookTrustState;
+};
+type LifecycleResultDetails = {
+    readonly cancel: boolean;
+    readonly contexts: readonly string[];
+    readonly diagnostics: readonly HookDiagnostic[];
+    readonly reason?: string;
+};
+export declare function buildSessionStartHookInput(event: SessionStartEvent, ctx: ExtensionContext): HookInputWire;
+export declare function buildPreCompactHookInput(event: SessionBeforeCompactEvent, ctx: ExtensionContext): HookInputWire;
+export declare function buildPostCompactHookInput(event: SessionCompactEvent, ctx: ExtensionContext): HookInputWire;
+export declare function dispatchLifecycleHookEvent(options: LifecycleDispatchOptions): Promise<HookDispatchResult | undefined>;
+export declare function sessionStartResultDetails(result: HookDispatchResult | undefined): LifecycleResultDetails;
+export declare function preCompactResultDetails(result: HookDispatchResult | undefined): LifecycleResultDetails;
+export declare function postCompactResultDetails(result: HookDispatchResult | undefined): LifecycleResultDetails;
+export declare function sessionBeforeCompactResult(details: LifecycleResultDetails): SessionBeforeCompactResult | undefined;
+export declare function recordLifecycleHookResult(pi: Pick<ExtensionAPI, "sendMessage">, event: LifecycleHookEvent, details: LifecycleResultDetails): void;
+export {};
+//# sourceMappingURL=lifecycle-adapter.d.ts.map

package/dist/core/extensions/builtin/hooks/lifecycle-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lifecycle-adapter.d.ts","sourceRoot":"","sources":["../../../../../src/core/extensions/builtin/hooks/lifecycle-adapter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACX,YAAY,EACZ,gBAAgB,EAChB,yBAAyB,EACzB,0BAA0B,EAC1B,mBAAmB,EACnB,iBAAiB,EACjB,MAAM,gBAAgB,CAAC;AAExB,OAAO,EAAqB,KAAK,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAG7E,OAAO,KAAK,EAAE,qBAAqB,EAAE,cAAc,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEvG,KAAK,kBAAkB,GAAG,cAAc,GAAG,YAAY,GAAG,aAAa,CAAC;AAExE,KAAK,wBAAwB,GAAG;IAC/B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,QAAQ,EAAE,SAAS,qBAAqB,EAAE,CAAC;IACpD,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC;IAC9B,QAAQ,CAAC,aAAa,EAAE,SAAS,MAAM,EAAE,CAAC;IAC1C,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC;IAC9B,QAAQ,CAAC,UAAU,EAAE,cAAc,CAAC;CACpC,CAAC;AAcF,KAAK,sBAAsB,GAAG;IAC7B,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;IACrC,QAAQ,CAAC,WAAW,EAAE,SAAS,cAAc,EAAE,CAAC;IAChD,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CACzB,CAAC;AAEF,wBAAgB,0BAA0B,CAAC,KAAK,EAAE,iBAAiB,EAAE,GAAG,EAAE,gBAAgB,GAAG,aAAa,CAWzG;AAED,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,yBAAyB,EAAE,GAAG,EAAE,gBAAgB,GAAG,aAAa,CAa/G;AAED,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,mBAAmB,EAAE,GAAG,EAAE,gBAAgB,GAAG,aAAa,CAa1G;AAED,wBAAsB,0BAA0B,CAC/C,OAAO,EAAE,wBAAwB,GAC/B,OAAO,CAAC,kBAAkB,GAAG,SAAS,CAAC,CAuBzC;AAED,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,kBAAkB,GAAG,SAAS,GAAG,sBAAsB,CAExG;AAED,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,kBAAkB,GAAG,SAAS,GAAG,sBAAsB,CActG;AAED,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,kBAAkB,GAAG,SAAS,GAAG,sBAAsB,CAEvG;AAED,wBAAgB,0BAA0B,CAAC,OAAO,EAAE,sBAAsB,GAAG,0BAA0B,GAAG,SAAS,CAElH;AAED,wBAAgB,yBAAyB,CACxC,EAAE,EAAE,IAAI,CAAC,YAAY,EAAE,aAAa,CAAC,EACrC,KAAK,EAAE,kBAAkB,EACzB,OAAO,EAAE,sBAAsB,GAC7B,IAAI,CAgBN"}

package/dist/core/extensions/builtin/hooks/lifecycle-adapter.js

@@ -0,0 +1,276 @@
+import { diagnostic } from "./diagnostics.js";
+import { dispatchHookEvent } from "./dispatcher.js";
+import { HOOK_CUSTOM_MESSAGE_TYPE, safeDiagnosticDetails } from "./prompt-adapter.js";
+import { createHookTrustEntry, hookTrustId, listHookTrustRecords } from "./trust.js";
+export function buildSessionStartHookInput(event, ctx) {
+    const transcriptPath = ctx.sessionManager.getSessionFile();
+    return {
+        cwd: ctx.cwd,
+        event: "SessionStart",
+        hook_event_name: "SessionStart",
+        reason: event.reason,
+        sessionId: ctx.sessionManager.getSessionId(),
+        session_id: ctx.sessionManager.getSessionId(),
+        ...(transcriptPath === undefined ? {} : { transcript_path: transcriptPath }),
+    };
+}
+export function buildPreCompactHookInput(event, ctx) {
+    const transcriptPath = ctx.sessionManager.getSessionFile();
+    return {
+        cwd: ctx.cwd,
+        event: "PreCompact",
+        hook_event_name: "PreCompact",
+        reason: event.reason,
+        request_id: event.requestId,
+        session_id: ctx.sessionManager.getSessionId(),
+        will_retry: event.willRetry,
+        ...(event.customInstructions === undefined ? {} : { custom_instructions: event.customInstructions }),
+        ...(transcriptPath === undefined ? {} : { transcript_path: transcriptPath }),
+    };
+}
+export function buildPostCompactHookInput(event, ctx) {
+    const transcriptPath = ctx.sessionManager.getSessionFile();
+    return {
+        accepted: event.accepted,
+        cwd: ctx.cwd,
+        event: "PostCompact",
+        hook_event_name: "PostCompact",
+        reason: event.reason,
+        request_id: event.requestId,
+        session_id: ctx.sessionManager.getSessionId(),
+        will_retry: event.willRetry,
+        ...(transcriptPath === undefined ? {} : { transcript_path: transcriptPath }),
+    };
+}
+export async function dispatchLifecycleHookEvent(options) {
+    const selection = selectLifecycleHandlers(options);
+    if (selection.handlers.length === 0 && selection.diagnostics.length === 0)
+        return undefined;
+    const trustedHandlers = selection.handlers.map((handler) => stripLifecycleMatcher(handler));
+    const hooks = {};
+    for (const handler of trustedHandlers) {
+        hooks[hookTrustId(handler)] = createHookTrustEntry(handler, {
+            platform: process.platform,
+            updatedAt: "2026-06-29T00:00:00.000Z",
+        });
+    }
+    const result = await dispatchHookEvent({
+        cwd: options.cwd,
+        handlers: trustedHandlers,
+        input: options.input,
+        ...(options.signal === undefined ? {} : { signal: options.signal }),
+        trustOptions: { platform: process.platform },
+        trustState: { hooks, version: 1 },
+    });
+    return {
+        ...result,
+        diagnostics: [...selection.diagnostics, ...result.diagnostics],
+    };
+}
+export function sessionStartResultDetails(result) {
+    return lifecycleResultDetails("SessionStart", result);
+}
+export function preCompactResultDetails(result) {
+    const details = lifecycleResultDetails("PreCompact", result);
+    if (details.cancel)
+        return details;
+    const blocker = result?.summaries.find((summary) => {
+        const output = readLifecycleHookOutput("PreCompact", summary.run.stdout);
+        return output?.decision === "block" || output?.decision === "deny";
+    });
+    if (blocker === undefined)
+        return details;
+    const output = readLifecycleHookOutput("PreCompact", blocker.run.stdout);
+    return {
+        ...details,
+        cancel: true,
+        ...(output?.reason === undefined ? {} : { reason: output.reason }),
+    };
+}
+export function postCompactResultDetails(result) {
+    return lifecycleResultDetails("PostCompact", result);
+}
+export function sessionBeforeCompactResult(details) {
+    return details.cancel ? { cancel: true } : undefined;
+}
+export function recordLifecycleHookResult(pi, event, details) {
+    if (details.contexts.length === 0 && details.diagnostics.length === 0 && details.reason === undefined)
+        return;
+    const content = details.contexts.length > 0 ? details.contexts.join("\n\n") : (details.reason ?? `${event} hook diagnostics.`);
+    pi.sendMessage({
+        customType: HOOK_CUSTOM_MESSAGE_TYPE,
+        content,
+        display: false,
+        details: {
+            event,
+            diagnostics: details.diagnostics.map(safeDiagnosticDetails),
+        },
+    }, { triggerTurn: false });
+}
+function selectLifecycleHandlers(options) {
+    const matched = [];
+    const diagnostics = [];
+    for (const handler of options.handlers) {
+        if (handler.event !== options.input.event)
+            continue;
+        if (isInitialRuntimeSessionStart(handler, options.input)) {
+            diagnostics.push(diagnostic({
+                code: "unsupported_event",
+                event: "SessionStart",
+                message: "Runtime SessionStart hooks are loaded for reload or the next session only.",
+                path: "hooks.SessionStart",
+                severity: "warning",
+            }, handler.source));
+            continue;
+        }
+        const match = matchesLifecycleMatcher(handler, options.matcherInputs);
+        diagnostics.push(...match.diagnostics);
+        if (match.matched)
+            matched.push(handler);
+    }
+    const trustRecords = listHookTrustRecords(matched, options.trustState, { platform: process.platform });
+    const trusted = matched.filter((_handler, index) => trustRecords[index]?.executable === true);
+    return { diagnostics, handlers: trusted };
+}
+function isInitialRuntimeSessionStart(handler, input) {
+    return input.event === "SessionStart" && input.reason === "startup" && handler.source.discoveredAt === "runtime";
+}
+function matchesLifecycleMatcher(handler, inputs) {
+    const matcher = handler.matcher?.trim();
+    if (matcher === undefined || matcher.length === 0 || matcher === "*") {
+        return { diagnostics: [], matched: true };
+    }
+    const literalMatched = matcher
+        .split(/[|,]/)
+        .map((part) => part.trim())
+        .filter((part) => part.length > 0)
+        .some((part) => inputs.includes(part));
+    try {
+        const regex = new RegExp(matcher);
+        return { diagnostics: [], matched: literalMatched || inputs.some((input) => regex.test(input)) };
+    }
+    catch (error) {
+        if (error instanceof SyntaxError) {
+            return {
+                diagnostics: [
+                    diagnostic({
+                        code: "invalid_matcher",
+                        event: handler.event,
+                        message: `Hook matcher is not a valid JavaScript regular expression: ${error.message}`,
+                        path: `hooks.${handler.event}[${handler.groupIndex}].matcher`,
+                        severity: "warning",
+                    }, handler.source),
+                ],
+                matched: literalMatched,
+            };
+        }
+        throw error;
+    }
+}
+function stripLifecycleMatcher(handler) {
+    return {
+        config: handler.config,
+        event: handler.event,
+        groupIndex: handler.groupIndex,
+        handlerIndex: handler.handlerIndex,
+        source: handler.source,
+    };
+}
+function lifecycleResultDetails(event, result) {
+    if (result === undefined) {
+        return { cancel: false, contexts: [], diagnostics: [] };
+    }
+    const diagnostics = [...result.diagnostics, ...commandFailureDiagnostics(event, result)];
+    const contexts = [];
+    for (const summary of result.summaries) {
+        const output = readLifecycleHookOutput(event, summary.run.stdout);
+        if (output?.additionalContext !== undefined && event !== "PreCompact") {
+            contexts.push(output.additionalContext);
+        }
+        if (event === "PreCompact") {
+            diagnostics.push(...preCompactUnsupportedDiagnostics(summary.handler, output));
+        }
+    }
+    const reason = event === "PreCompact" && result.decision.kind === "block" ? result.decision.reason : undefined;
+    return {
+        cancel: event === "PreCompact" && result.decision.kind === "block",
+        contexts,
+        diagnostics,
+        ...(reason === undefined ? {} : { reason }),
+    };
+}
+function commandFailureDiagnostics(event, result) {
+    return result.summaries.flatMap((summary) => {
+        if (summary.run.exitCode === 0 || (summary.run.exitCode === 2 && event === "PreCompact"))
+            return [];
+        const status = summary.run.exitCode === null ? "without an exit code" : `with exit code ${summary.run.exitCode}`;
+        return [
+            diagnostic({
+                code: "invalid_root",
+                event,
+                message: `Hook command failed ${status}.`,
+                path: "process.exitCode",
+                severity: "warning",
+            }, summary.handler.source),
+        ];
+    });
+}
+function preCompactUnsupportedDiagnostics(handler, output) {
+    if (output === undefined)
+        return [];
+    const diagnostics = [];
+    if (output.additionalContext !== undefined) {
+        diagnostics.push(diagnostic({
+            code: "unsupported_field",
+            event: "PreCompact",
+            message: "PreCompact additionalContext is diagnostic-only in builtin hooks v1.",
+            path: "stdout.hookSpecificOutput.additionalContext",
+            severity: "warning",
+        }, handler.source));
+    }
+    if (output.customInstructions !== undefined) {
+        diagnostics.push(diagnostic({
+            code: "unsupported_field",
+            event: "PreCompact",
+            message: "PreCompact customInstructions cannot mutate compaction in builtin hooks v1.",
+            path: "stdout.hookSpecificOutput.customInstructions",
+            severity: "warning",
+        }, handler.source));
+    }
+    return diagnostics;
+}
+function readLifecycleHookOutput(event, stdout) {
+    const trimmed = stdout.trim();
+    if (trimmed.length === 0)
+        return undefined;
+    let parsed;
+    try {
+        parsed = JSON.parse(trimmed);
+    }
+    catch (error) {
+        if (error instanceof SyntaxError)
+            return undefined;
+        throw error;
+    }
+    if (!isRecord(parsed))
+        return undefined;
+    const specific = isRecord(parsed.hookSpecificOutput) ? parsed.hookSpecificOutput : undefined;
+    if (specific?.hookEventName !== undefined && specific.hookEventName !== event)
+        return undefined;
+    return {
+        ...textField(specific?.additionalContext ?? parsed.additionalContext, "additionalContext"),
+        ...textField(specific?.customInstructions ?? parsed.customInstructions, "customInstructions"),
+        ...textField(parsed.decision, "decision"),
+        ...textField(specific?.permissionDecisionReason ?? parsed.reason, "reason"),
+    };
+}
+function textField(value, key) {
+    if (typeof value !== "string")
+        return {};
+    const trimmed = value.trim();
+    return trimmed.length === 0 ? {} : { [key]: trimmed };
+}
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+//# sourceMappingURL=lifecycle-adapter.js.map

package/dist/core/extensions/builtin/hooks/lifecycle-adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lifecycle-adapter.js","sourceRoot":"","sources":["../../../../../src/core/extensions/builtin/hooks/lifecycle-adapter.ts"],"names":[],"mappings":"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","sourcesContent":["import type {\n\tExtensionAPI,\n\tExtensionContext,\n\tSessionBeforeCompactEvent,\n\tSessionBeforeCompactResult,\n\tSessionCompactEvent,\n\tSessionStartEvent,\n} from \"../../types.ts\";\nimport { diagnostic } from \"./diagnostics.ts\";\nimport { dispatchHookEvent, type HookDispatchResult } from \"./dispatcher.ts\";\nimport { HOOK_CUSTOM_MESSAGE_TYPE, safeDiagnosticDetails } from \"./prompt-adapter.ts\";\nimport { createHookTrustEntry, hookTrustId, listHookTrustRecords } from \"./trust.ts\";\nimport type { ExecutableHookHandler, HookDiagnostic, HookInputWire, HookTrustState } from \"./types.ts\";\n\ntype LifecycleHookEvent = \"SessionStart\" | \"PreCompact\" | \"PostCompact\";\n\ntype LifecycleDispatchOptions = {\n\treadonly cwd: string;\n\treadonly handlers: readonly ExecutableHookHandler[];\n\treadonly input: HookInputWire;\n\treadonly matcherInputs: readonly string[];\n\treadonly signal?: AbortSignal;\n\treadonly trustState: HookTrustState;\n};\n\ntype LifecycleDispatchSelection = {\n\treadonly diagnostics: readonly HookDiagnostic[];\n\treadonly handlers: readonly ExecutableHookHandler[];\n};\n\ntype LifecycleHookOutput = {\n\treadonly additionalContext?: string;\n\treadonly customInstructions?: string;\n\treadonly decision?: string;\n\treadonly reason?: string;\n};\n\ntype LifecycleResultDetails = {\n\treadonly cancel: boolean;\n\treadonly contexts: readonly string[];\n\treadonly diagnostics: readonly HookDiagnostic[];\n\treadonly reason?: string;\n};\n\nexport function buildSessionStartHookInput(event: SessionStartEvent, ctx: ExtensionContext): HookInputWire {\n\tconst transcriptPath = ctx.sessionManager.getSessionFile();\n\treturn {\n\t\tcwd: ctx.cwd,\n\t\tevent: \"SessionStart\",\n\t\thook_event_name: \"SessionStart\",\n\t\treason: event.reason,\n\t\tsessionId: ctx.sessionManager.getSessionId(),\n\t\tsession_id: ctx.sessionManager.getSessionId(),\n\t\t...(transcriptPath === undefined ? {} : { transcript_path: transcriptPath }),\n\t};\n}\n\nexport function buildPreCompactHookInput(event: SessionBeforeCompactEvent, ctx: ExtensionContext): HookInputWire {\n\tconst transcriptPath = ctx.sessionManager.getSessionFile();\n\treturn {\n\t\tcwd: ctx.cwd,\n\t\tevent: \"PreCompact\",\n\t\thook_event_name: \"PreCompact\",\n\t\treason: event.reason,\n\t\trequest_id: event.requestId,\n\t\tsession_id: ctx.sessionManager.getSessionId(),\n\t\twill_retry: event.willRetry,\n\t\t...(event.customInstructions === undefined ? {} : { custom_instructions: event.customInstructions }),\n\t\t...(transcriptPath === undefined ? {} : { transcript_path: transcriptPath }),\n\t};\n}\n\nexport function buildPostCompactHookInput(event: SessionCompactEvent, ctx: ExtensionContext): HookInputWire {\n\tconst transcriptPath = ctx.sessionManager.getSessionFile();\n\treturn {\n\t\taccepted: event.accepted,\n\t\tcwd: ctx.cwd,\n\t\tevent: \"PostCompact\",\n\t\thook_event_name: \"PostCompact\",\n\t\treason: event.reason,\n\t\trequest_id: event.requestId,\n\t\tsession_id: ctx.sessionManager.getSessionId(),\n\t\twill_retry: event.willRetry,\n\t\t...(transcriptPath === undefined ? {} : { transcript_path: transcriptPath }),\n\t};\n}\n\nexport async function dispatchLifecycleHookEvent(\n\toptions: LifecycleDispatchOptions,\n): Promise<HookDispatchResult | undefined> {\n\tconst selection = selectLifecycleHandlers(options);\n\tif (selection.handlers.length === 0 && selection.diagnostics.length === 0) return undefined;\n\tconst trustedHandlers = selection.handlers.map((handler) => stripLifecycleMatcher(handler));\n\tconst hooks: Record<string, ReturnType<typeof createHookTrustEntry>> = {};\n\tfor (const handler of trustedHandlers) {\n\t\thooks[hookTrustId(handler)] = createHookTrustEntry(handler, {\n\t\t\tplatform: process.platform,\n\t\t\tupdatedAt: \"2026-06-29T00:00:00.000Z\",\n\t\t});\n\t}\n\tconst result = await dispatchHookEvent({\n\t\tcwd: options.cwd,\n\t\thandlers: trustedHandlers,\n\t\tinput: options.input,\n\t\t...(options.signal === undefined ? {} : { signal: options.signal }),\n\t\ttrustOptions: { platform: process.platform },\n\t\ttrustState: { hooks, version: 1 },\n\t});\n\treturn {\n\t\t...result,\n\t\tdiagnostics: [...selection.diagnostics, ...result.diagnostics],\n\t};\n}\n\nexport function sessionStartResultDetails(result: HookDispatchResult | undefined): LifecycleResultDetails {\n\treturn lifecycleResultDetails(\"SessionStart\", result);\n}\n\nexport function preCompactResultDetails(result: HookDispatchResult | undefined): LifecycleResultDetails {\n\tconst details = lifecycleResultDetails(\"PreCompact\", result);\n\tif (details.cancel) return details;\n\tconst blocker = result?.summaries.find((summary) => {\n\t\tconst output = readLifecycleHookOutput(\"PreCompact\", summary.run.stdout);\n\t\treturn output?.decision === \"block\" || output?.decision === \"deny\";\n\t});\n\tif (blocker === undefined) return details;\n\tconst output = readLifecycleHookOutput(\"PreCompact\", blocker.run.stdout);\n\treturn {\n\t\t...details,\n\t\tcancel: true,\n\t\t...(output?.reason === undefined ? {} : { reason: output.reason }),\n\t};\n}\n\nexport function postCompactResultDetails(result: HookDispatchResult | undefined): LifecycleResultDetails {\n\treturn lifecycleResultDetails(\"PostCompact\", result);\n}\n\nexport function sessionBeforeCompactResult(details: LifecycleResultDetails): SessionBeforeCompactResult | undefined {\n\treturn details.cancel ? { cancel: true } : undefined;\n}\n\nexport function recordLifecycleHookResult(\n\tpi: Pick<ExtensionAPI, \"sendMessage\">,\n\tevent: LifecycleHookEvent,\n\tdetails: LifecycleResultDetails,\n): void {\n\tif (details.contexts.length === 0 && details.diagnostics.length === 0 && details.reason === undefined) return;\n\tconst content =\n\t\tdetails.contexts.length > 0 ? details.contexts.join(\"\\n\\n\") : (details.reason ?? `${event} hook diagnostics.`);\n\tpi.sendMessage(\n\t\t{\n\t\t\tcustomType: HOOK_CUSTOM_MESSAGE_TYPE,\n\t\t\tcontent,\n\t\t\tdisplay: false,\n\t\t\tdetails: {\n\t\t\t\tevent,\n\t\t\t\tdiagnostics: details.diagnostics.map(safeDiagnosticDetails),\n\t\t\t},\n\t\t},\n\t\t{ triggerTurn: false },\n\t);\n}\n\nfunction selectLifecycleHandlers(options: LifecycleDispatchOptions): LifecycleDispatchSelection {\n\tconst matched: ExecutableHookHandler[] = [];\n\tconst diagnostics: HookDiagnostic[] = [];\n\tfor (const handler of options.handlers) {\n\t\tif (handler.event !== options.input.event) continue;\n\t\tif (isInitialRuntimeSessionStart(handler, options.input)) {\n\t\t\tdiagnostics.push(\n\t\t\t\tdiagnostic(\n\t\t\t\t\t{\n\t\t\t\t\t\tcode: \"unsupported_event\",\n\t\t\t\t\t\tevent: \"SessionStart\",\n\t\t\t\t\t\tmessage: \"Runtime SessionStart hooks are loaded for reload or the next session only.\",\n\t\t\t\t\t\tpath: \"hooks.SessionStart\",\n\t\t\t\t\t\tseverity: \"warning\",\n\t\t\t\t\t},\n\t\t\t\t\thandler.source,\n\t\t\t\t),\n\t\t\t);\n\t\t\tcontinue;\n\t\t}\n\t\tconst match = matchesLifecycleMatcher(handler, options.matcherInputs);\n\t\tdiagnostics.push(...match.diagnostics);\n\t\tif (match.matched) matched.push(handler);\n\t}\n\tconst trustRecords = listHookTrustRecords(matched, options.trustState, { platform: process.platform });\n\tconst trusted = matched.filter((_handler, index) => trustRecords[index]?.executable === true);\n\treturn { diagnostics, handlers: trusted };\n}\n\nfunction isInitialRuntimeSessionStart(handler: ExecutableHookHandler, input: HookInputWire): boolean {\n\treturn input.event === \"SessionStart\" && input.reason === \"startup\" && handler.source.discoveredAt === \"runtime\";\n}\n\nfunction matchesLifecycleMatcher(\n\thandler: ExecutableHookHandler,\n\tinputs: readonly string[],\n): { readonly diagnostics: readonly HookDiagnostic[]; readonly matched: boolean } {\n\tconst matcher = handler.matcher?.trim();\n\tif (matcher === undefined || matcher.length === 0 || matcher === \"*\") {\n\t\treturn { diagnostics: [], matched: true };\n\t}\n\tconst literalMatched = matcher\n\t\t.split(/[|,]/)\n\t\t.map((part) => part.trim())\n\t\t.filter((part) => part.length > 0)\n\t\t.some((part) => inputs.includes(part));\n\ttry {\n\t\tconst regex = new RegExp(matcher);\n\t\treturn { diagnostics: [], matched: literalMatched || inputs.some((input) => regex.test(input)) };\n\t} catch (error) {\n\t\tif (error instanceof SyntaxError) {\n\t\t\treturn {\n\t\t\t\tdiagnostics: [\n\t\t\t\t\tdiagnostic(\n\t\t\t\t\t\t{\n\t\t\t\t\t\t\tcode: \"invalid_matcher\",\n\t\t\t\t\t\t\tevent: handler.event,\n\t\t\t\t\t\t\tmessage: `Hook matcher is not a valid JavaScript regular expression: ${error.message}`,\n\t\t\t\t\t\t\tpath: `hooks.${handler.event}[${handler.groupIndex}].matcher`,\n\t\t\t\t\t\t\tseverity: \"warning\",\n\t\t\t\t\t\t},\n\t\t\t\t\t\thandler.source,\n\t\t\t\t\t),\n\t\t\t\t],\n\t\t\t\tmatched: literalMatched,\n\t\t\t};\n\t\t}\n\t\tthrow error;\n\t}\n}\n\nfunction stripLifecycleMatcher(handler: ExecutableHookHandler): ExecutableHookHandler {\n\treturn {\n\t\tconfig: handler.config,\n\t\tevent: handler.event,\n\t\tgroupIndex: handler.groupIndex,\n\t\thandlerIndex: handler.handlerIndex,\n\t\tsource: handler.source,\n\t};\n}\n\nfunction lifecycleResultDetails(\n\tevent: LifecycleHookEvent,\n\tresult: HookDispatchResult | undefined,\n): LifecycleResultDetails {\n\tif (result === undefined) {\n\t\treturn { cancel: false, contexts: [], diagnostics: [] };\n\t}\n\tconst diagnostics = [...result.diagnostics, ...commandFailureDiagnostics(event, result)];\n\tconst contexts: string[] = [];\n\tfor (const summary of result.summaries) {\n\t\tconst output = readLifecycleHookOutput(event, summary.run.stdout);\n\t\tif (output?.additionalContext !== undefined && event !== \"PreCompact\") {\n\t\t\tcontexts.push(output.additionalContext);\n\t\t}\n\t\tif (event === \"PreCompact\") {\n\t\t\tdiagnostics.push(...preCompactUnsupportedDiagnostics(summary.handler, output));\n\t\t}\n\t}\n\tconst reason = event === \"PreCompact\" && result.decision.kind === \"block\" ? result.decision.reason : undefined;\n\treturn {\n\t\tcancel: event === \"PreCompact\" && result.decision.kind === \"block\",\n\t\tcontexts,\n\t\tdiagnostics,\n\t\t...(reason === undefined ? {} : { reason }),\n\t};\n}\n\nfunction commandFailureDiagnostics(event: LifecycleHookEvent, result: HookDispatchResult): readonly HookDiagnostic[] {\n\treturn result.summaries.flatMap((summary) => {\n\t\tif (summary.run.exitCode === 0 || (summary.run.exitCode === 2 && event === \"PreCompact\")) return [];\n\t\tconst status = summary.run.exitCode === null ? \"without an exit code\" : `with exit code ${summary.run.exitCode}`;\n\t\treturn [\n\t\t\tdiagnostic(\n\t\t\t\t{\n\t\t\t\t\tcode: \"invalid_root\",\n\t\t\t\t\tevent,\n\t\t\t\t\tmessage: `Hook command failed ${status}.`,\n\t\t\t\t\tpath: \"process.exitCode\",\n\t\t\t\t\tseverity: \"warning\",\n\t\t\t\t},\n\t\t\t\tsummary.handler.source,\n\t\t\t),\n\t\t];\n\t});\n}\n\nfunction preCompactUnsupportedDiagnostics(\n\thandler: ExecutableHookHandler,\n\toutput: LifecycleHookOutput | undefined,\n): readonly HookDiagnostic[] {\n\tif (output === undefined) return [];\n\tconst diagnostics: HookDiagnostic[] = [];\n\tif (output.additionalContext !== undefined) {\n\t\tdiagnostics.push(\n\t\t\tdiagnostic(\n\t\t\t\t{\n\t\t\t\t\tcode: \"unsupported_field\",\n\t\t\t\t\tevent: \"PreCompact\",\n\t\t\t\t\tmessage: \"PreCompact additionalContext is diagnostic-only in builtin hooks v1.\",\n\t\t\t\t\tpath: \"stdout.hookSpecificOutput.additionalContext\",\n\t\t\t\t\tseverity: \"warning\",\n\t\t\t\t},\n\t\t\t\thandler.source,\n\t\t\t),\n\t\t);\n\t}\n\tif (output.customInstructions !== undefined) {\n\t\tdiagnostics.push(\n\t\t\tdiagnostic(\n\t\t\t\t{\n\t\t\t\t\tcode: \"unsupported_field\",\n\t\t\t\t\tevent: \"PreCompact\",\n\t\t\t\t\tmessage: \"PreCompact customInstructions cannot mutate compaction in builtin hooks v1.\",\n\t\t\t\t\tpath: \"stdout.hookSpecificOutput.customInstructions\",\n\t\t\t\t\tseverity: \"warning\",\n\t\t\t\t},\n\t\t\t\thandler.source,\n\t\t\t),\n\t\t);\n\t}\n\treturn diagnostics;\n}\n\nfunction readLifecycleHookOutput(event: LifecycleHookEvent, stdout: string): LifecycleHookOutput | undefined {\n\tconst trimmed = stdout.trim();\n\tif (trimmed.length === 0) return undefined;\n\tlet parsed: unknown;\n\ttry {\n\t\tparsed = JSON.parse(trimmed);\n\t} catch (error) {\n\t\tif (error instanceof SyntaxError) return undefined;\n\t\tthrow error;\n\t}\n\tif (!isRecord(parsed)) return undefined;\n\tconst specific = isRecord(parsed.hookSpecificOutput) ? parsed.hookSpecificOutput : undefined;\n\tif (specific?.hookEventName !== undefined && specific.hookEventName !== event) return undefined;\n\treturn {\n\t\t...textField(specific?.additionalContext ?? parsed.additionalContext, \"additionalContext\"),\n\t\t...textField(specific?.customInstructions ?? parsed.customInstructions, \"customInstructions\"),\n\t\t...textField(parsed.decision, \"decision\"),\n\t\t...textField(specific?.permissionDecisionReason ?? parsed.reason, \"reason\"),\n\t};\n}\n\nfunction textField<K extends keyof LifecycleHookOutput>(\n\tvalue: unknown,\n\tkey: K,\n): Pick<LifecycleHookOutput, K> | Record<string, never> {\n\tif (typeof value !== \"string\") return {};\n\tconst trimmed = value.trim();\n\treturn trimmed.length === 0 ? {} : ({ [key]: trimmed } as Pick<LifecycleHookOutput, K>);\n}\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n\treturn typeof value === \"object\" && value !== null && !Array.isArray(value);\n}\n"]}

package/dist/core/extensions/builtin/hooks/matcher.d.ts

@@ -0,0 +1,7 @@
+import type { ExecutableHookHandler, HookDiagnostic, HookInputWire } from "./types.ts";
+export type HookMatcherResult = {
+    readonly handlers: readonly ExecutableHookHandler[];
+    readonly diagnostics: readonly HookDiagnostic[];
+};
+export declare function matchingHookHandlers(input: HookInputWire, handlers: readonly ExecutableHookHandler[]): HookMatcherResult;
+//# sourceMappingURL=matcher.d.ts.map

package/dist/core/extensions/builtin/hooks/matcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"matcher.d.ts","sourceRoot":"","sources":["../../../../../src/core/extensions/builtin/hooks/matcher.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,qBAAqB,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEvF,MAAM,MAAM,iBAAiB,GAAG;IAC/B,QAAQ,CAAC,QAAQ,EAAE,SAAS,qBAAqB,EAAE,CAAC;IACpD,QAAQ,CAAC,WAAW,EAAE,SAAS,cAAc,EAAE,CAAC;CAChD,CAAC;AAsBF,wBAAgB,oBAAoB,CACnC,KAAK,EAAE,aAAa,EACpB,QAAQ,EAAE,SAAS,qBAAqB,EAAE,GACxC,iBAAiB,CAsBnB"}