@code-yeongyu/senpi 2026.6.21 → 2026.6.30

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

@@ -0,0 +1,60 @@
+import { type CommandHookRunOptions, type CommandHookRunResult } from "./command-runner.ts";
+import { type ParsedHookOutput } from "./output-parser.ts";
+import { type HookOutputPolicy } from "./safety.ts";
+import { type HookTrustOptions, type HookTrustRecord } from "./trust.ts";
+import type { ExecutableHookHandler, HookDiagnostic, HookInputWire, HookSourceMetadata, HookTrustState } from "./types.ts";
+export type HookCommandRunner = (handler: ExecutableHookHandler, input: HookInputWire, options: CommandHookRunOptions) => Promise<CommandHookRunResult>;
+export type HookDispatchDecision = {
+    readonly kind: "none";
+} | {
+    readonly kind: "allow" | "block";
+    readonly reason?: string;
+    readonly source: HookSourceMetadata;
+    readonly sourceCommand: string;
+    readonly updatedInput?: unknown;
+} | {
+    readonly fallback: {
+        readonly kind: "block";
+        readonly reason: string;
+    };
+    readonly kind: "ask";
+    readonly nativeRepresentable: false;
+    readonly reason?: string;
+    readonly source: HookSourceMetadata;
+    readonly sourceCommand: string;
+};
+export type HookDispatchSkipped = {
+    readonly diagnostics: readonly HookDiagnostic[];
+    readonly handler: ExecutableHookHandler;
+    readonly reason: "disabled" | "untrusted" | "unsafe";
+    readonly record: HookTrustRecord;
+};
+export type HookDispatchSummary = {
+    readonly completionIndex: number;
+    readonly diagnostics: readonly HookDiagnostic[];
+    readonly handler: ExecutableHookHandler;
+    readonly output: ParsedHookOutput["output"];
+    readonly run: CommandHookRunResult;
+};
+export type HookDispatchResult = {
+    readonly decision: HookDispatchDecision;
+    readonly diagnostics: readonly HookDiagnostic[];
+    readonly executableHandlers: readonly ExecutableHookHandler[];
+    readonly matchedHandlers: readonly ExecutableHookHandler[];
+    readonly skipped: readonly HookDispatchSkipped[];
+    readonly summaries: readonly HookDispatchSummary[];
+};
+export type HookDispatchOptions = {
+    readonly cwd: string;
+    readonly envPassthrough?: readonly string[];
+    readonly handlers: readonly ExecutableHookHandler[];
+    readonly input: HookInputWire;
+    readonly outputPolicy?: HookOutputPolicy;
+    readonly runCommand?: HookCommandRunner;
+    readonly signal?: AbortSignal;
+    readonly sourceEnv?: NodeJS.ProcessEnv;
+    readonly trustOptions?: HookTrustOptions;
+    readonly trustState: HookTrustState;
+};
+export declare function dispatchHookEvent(options: HookDispatchOptions): Promise<HookDispatchResult>;
+//# sourceMappingURL=dispatcher.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"dispatcher.d.ts","sourceRoot":"","sources":["../../../../../src/core/extensions/builtin/hooks/dispatcher.ts"],"names":[],"mappings":"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"}

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

@@ -0,0 +1,161 @@
+import { runCommandHook } from "./command-runner.js";
+import { matchingHookHandlers } from "./matcher.js";
+import { parseHookOutput } from "./output-parser.js";
+import { validateHookHandlerSafety } from "./safety.js";
+import { listHookTrustRecords } from "./trust.js";
+export async function dispatchHookEvent(options) {
+    const match = matchingHookHandlers(options.input, options.handlers);
+    const ordered = declarationOrdered(match.handlers);
+    const selected = selectExecutableHandlers(ordered, options.trustState, options.trustOptions);
+    let nextCompletionIndex = 0;
+    const runner = options.runCommand ?? runCommandHook;
+    const completed = await Promise.all(selected.runnable.map(async ({ handler, declarationIndex }) => {
+        const run = await runner(handler, options.input, {
+            cwd: options.cwd,
+            ...(options.envPassthrough === undefined ? {} : { envPassthrough: options.envPassthrough }),
+            ...(options.outputPolicy === undefined ? {} : { outputPolicy: options.outputPolicy }),
+            ...(options.signal === undefined ? {} : { signal: options.signal }),
+            ...(options.sourceEnv === undefined ? {} : { sourceEnv: options.sourceEnv }),
+        });
+        const parsed = parseHookOutput({
+            event: options.input.event,
+            exitCode: run.exitCode ?? 1,
+            source: handler.source,
+            stderr: run.stderr,
+            stdout: run.stdout,
+        });
+        const completionIndex = nextCompletionIndex;
+        nextCompletionIndex += 1;
+        return { completionIndex, declarationIndex, handler, parsed, run };
+    }));
+    const declarationSummaries = completed
+        .toSorted((left, right) => left.declarationIndex - right.declarationIndex)
+        .map((run) => ({
+        completionIndex: run.completionIndex,
+        diagnostics: run.parsed.diagnostics,
+        handler: run.handler,
+        output: run.parsed.output,
+        run: run.run,
+    }));
+    const diagnostics = [
+        ...match.diagnostics,
+        ...selected.skipped.flatMap((skip) => skip.diagnostics),
+        ...declarationSummaries.flatMap((summary) => summary.diagnostics),
+    ];
+    return {
+        decision: aggregateDecision(options.input.event, declarationSummaries),
+        diagnostics,
+        executableHandlers: selected.runnable.map((item) => item.handler),
+        matchedHandlers: ordered.map((item) => item.handler),
+        skipped: selected.skipped,
+        summaries: declarationSummaries,
+    };
+}
+function declarationOrdered(handlers) {
+    return handlers
+        .map((handler, index) => ({ declarationIndex: index, handler }))
+        .toSorted((left, right) => compareHandlers(left.handler, right.handler) || left.declarationIndex - right.declarationIndex);
+}
+function compareHandlers(left, right) {
+    return (left.source.displayOrder - right.source.displayOrder ||
+        left.groupIndex - right.groupIndex ||
+        left.handlerIndex - right.handlerIndex);
+}
+function selectExecutableHandlers(handlers, trustState, trustOptions) {
+    const records = listHookTrustRecords(handlers.map((item) => item.handler), trustState, trustOptions);
+    const runnable = [];
+    const skipped = [];
+    for (const [index, item] of handlers.entries()) {
+        const record = records[index];
+        if (record === undefined)
+            continue;
+        const safetyDiagnostics = validateHookHandlerSafety(item.handler);
+        const unsafe = safetyDiagnostics.some((diagnostic) => diagnostic.severity === "error");
+        if (unsafe) {
+            skipped.push({ diagnostics: safetyDiagnostics, handler: item.handler, reason: "unsafe", record });
+            continue;
+        }
+        if (!record.enabled) {
+            skipped.push({ diagnostics: [], handler: item.handler, reason: "disabled", record });
+            continue;
+        }
+        if (!record.trusted) {
+            skipped.push({ diagnostics: [], handler: item.handler, reason: "untrusted", record });
+            continue;
+        }
+        runnable.push({ ...item, record });
+    }
+    return { runnable, skipped };
+}
+function aggregateDecision(event, summaries) {
+    switch (event) {
+        case "PreToolUse":
+            return aggregatePreToolUseDecision(summaries);
+        case "PostToolUse":
+        case "UserPromptSubmit":
+        case "SessionStart":
+        case "PreCompact":
+        case "PostCompact":
+        case "Stop":
+            return aggregateBlockingDecision(summaries);
+    }
+}
+function aggregatePreToolUseDecision(summaries) {
+    const blocker = summaries.find(hasBlockingDecision);
+    if (blocker !== undefined) {
+        return decisionWithSource("block", blocker, blocker.output.reason);
+    }
+    const ask = summaries.find((summary) => summary.output.decision === "ask");
+    if (ask !== undefined) {
+        const reason = ask.output.reason ?? "Hook requested manual approval.";
+        return {
+            fallback: { kind: "block", reason },
+            kind: "ask",
+            nativeRepresentable: false,
+            ...reasonField(ask.output.reason),
+            source: ask.handler.source,
+            sourceCommand: ask.handler.config.command,
+        };
+    }
+    let allowSummary;
+    for (const summary of summaries) {
+        if (summary.output.decision === "allow" || summary.output.decision === "approve")
+            allowSummary = summary;
+    }
+    if (allowSummary !== undefined) {
+        return decisionWithSource("allow", allowSummary, undefined, allowSummary.output.updatedInput);
+    }
+    return { kind: "none" };
+}
+function aggregateBlockingDecision(summaries) {
+    const blocker = summaries.find(hasBlockingDecision);
+    if (blocker !== undefined) {
+        return decisionWithSource("block", blocker, blocker.output.reason ?? blocker.output.stopReason);
+    }
+    return { kind: "none" };
+}
+function hasBlockingDecision(summary) {
+    return summary.output.decision === "block" || summary.output.decision === "deny";
+}
+function decisionWithSource(kind, summary, reason, updatedInput) {
+    return {
+        kind,
+        ...reasonField(reason),
+        source: summary.handler.source,
+        sourceCommand: summary.handler.config.command,
+        ...updatedInputField(updatedInput),
+    };
+}
+function reasonField(reason) {
+    if (reason === undefined) {
+        return {};
+    }
+    return { reason };
+}
+function updatedInputField(updatedInput) {
+    if (updatedInput === undefined) {
+        return {};
+    }
+    return { updatedInput };
+}
+//# sourceMappingURL=dispatcher.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"dispatcher.js","sourceRoot":"","sources":["../../../../../src/core/extensions/builtin/hooks/dispatcher.ts"],"names":[],"mappings":"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","sourcesContent":["import { type CommandHookRunOptions, type CommandHookRunResult, runCommandHook } from \"./command-runner.ts\";\nimport { matchingHookHandlers } from \"./matcher.ts\";\nimport { type ParsedHookOutput, parseHookOutput } from \"./output-parser.ts\";\nimport { type HookOutputPolicy, validateHookHandlerSafety } from \"./safety.ts\";\nimport { type HookTrustOptions, type HookTrustRecord, listHookTrustRecords } from \"./trust.ts\";\nimport type {\n\tExecutableHookHandler,\n\tHookDiagnostic,\n\tHookInputWire,\n\tHookSourceMetadata,\n\tHookTrustState,\n} from \"./types.ts\";\n\nexport type HookCommandRunner = (\n\thandler: ExecutableHookHandler,\n\tinput: HookInputWire,\n\toptions: CommandHookRunOptions,\n) => Promise<CommandHookRunResult>;\n\nexport type HookDispatchDecision =\n\t| { readonly kind: \"none\" }\n\t| {\n\t\t\treadonly kind: \"allow\" | \"block\";\n\t\t\treadonly reason?: string;\n\t\t\treadonly source: HookSourceMetadata;\n\t\t\treadonly sourceCommand: string;\n\t\t\treadonly updatedInput?: unknown;\n\t  }\n\t| {\n\t\t\treadonly fallback: { readonly kind: \"block\"; readonly reason: string };\n\t\t\treadonly kind: \"ask\";\n\t\t\treadonly nativeRepresentable: false;\n\t\t\treadonly reason?: string;\n\t\t\treadonly source: HookSourceMetadata;\n\t\t\treadonly sourceCommand: string;\n\t  };\n\nexport type HookDispatchSkipped = {\n\treadonly diagnostics: readonly HookDiagnostic[];\n\treadonly handler: ExecutableHookHandler;\n\treadonly reason: \"disabled\" | \"untrusted\" | \"unsafe\";\n\treadonly record: HookTrustRecord;\n};\n\nexport type HookDispatchSummary = {\n\treadonly completionIndex: number;\n\treadonly diagnostics: readonly HookDiagnostic[];\n\treadonly handler: ExecutableHookHandler;\n\treadonly output: ParsedHookOutput[\"output\"];\n\treadonly run: CommandHookRunResult;\n};\n\nexport type HookDispatchResult = {\n\treadonly decision: HookDispatchDecision;\n\treadonly diagnostics: readonly HookDiagnostic[];\n\treadonly executableHandlers: readonly ExecutableHookHandler[];\n\treadonly matchedHandlers: readonly ExecutableHookHandler[];\n\treadonly skipped: readonly HookDispatchSkipped[];\n\treadonly summaries: readonly HookDispatchSummary[];\n};\n\nexport type HookDispatchOptions = {\n\treadonly cwd: string;\n\treadonly envPassthrough?: readonly string[];\n\treadonly handlers: readonly ExecutableHookHandler[];\n\treadonly input: HookInputWire;\n\treadonly outputPolicy?: HookOutputPolicy;\n\treadonly runCommand?: HookCommandRunner;\n\treadonly signal?: AbortSignal;\n\treadonly sourceEnv?: NodeJS.ProcessEnv;\n\treadonly trustOptions?: HookTrustOptions;\n\treadonly trustState: HookTrustState;\n};\n\ntype OrderedHandler = {\n\treadonly declarationIndex: number;\n\treadonly handler: ExecutableHookHandler;\n};\n\ntype RunnableHandler = OrderedHandler & {\n\treadonly record: HookTrustRecord;\n};\n\nexport async function dispatchHookEvent(options: HookDispatchOptions): Promise<HookDispatchResult> {\n\tconst match = matchingHookHandlers(options.input, options.handlers);\n\tconst ordered = declarationOrdered(match.handlers);\n\tconst selected = selectExecutableHandlers(ordered, options.trustState, options.trustOptions);\n\tlet nextCompletionIndex = 0;\n\tconst runner = options.runCommand ?? runCommandHook;\n\tconst completed = await Promise.all(\n\t\tselected.runnable.map(async ({ handler, declarationIndex }) => {\n\t\t\tconst run = await runner(handler, options.input, {\n\t\t\t\tcwd: options.cwd,\n\t\t\t\t...(options.envPassthrough === undefined ? {} : { envPassthrough: options.envPassthrough }),\n\t\t\t\t...(options.outputPolicy === undefined ? {} : { outputPolicy: options.outputPolicy }),\n\t\t\t\t...(options.signal === undefined ? {} : { signal: options.signal }),\n\t\t\t\t...(options.sourceEnv === undefined ? {} : { sourceEnv: options.sourceEnv }),\n\t\t\t});\n\t\t\tconst parsed = parseHookOutput({\n\t\t\t\tevent: options.input.event,\n\t\t\t\texitCode: run.exitCode ?? 1,\n\t\t\t\tsource: handler.source,\n\t\t\t\tstderr: run.stderr,\n\t\t\t\tstdout: run.stdout,\n\t\t\t});\n\t\t\tconst completionIndex = nextCompletionIndex;\n\t\t\tnextCompletionIndex += 1;\n\t\t\treturn { completionIndex, declarationIndex, handler, parsed, run };\n\t\t}),\n\t);\n\tconst declarationSummaries = completed\n\t\t.toSorted((left, right) => left.declarationIndex - right.declarationIndex)\n\t\t.map((run) => ({\n\t\t\tcompletionIndex: run.completionIndex,\n\t\t\tdiagnostics: run.parsed.diagnostics,\n\t\t\thandler: run.handler,\n\t\t\toutput: run.parsed.output,\n\t\t\trun: run.run,\n\t\t}));\n\tconst diagnostics = [\n\t\t...match.diagnostics,\n\t\t...selected.skipped.flatMap((skip) => skip.diagnostics),\n\t\t...declarationSummaries.flatMap((summary) => summary.diagnostics),\n\t];\n\treturn {\n\t\tdecision: aggregateDecision(options.input.event, declarationSummaries),\n\t\tdiagnostics,\n\t\texecutableHandlers: selected.runnable.map((item) => item.handler),\n\t\tmatchedHandlers: ordered.map((item) => item.handler),\n\t\tskipped: selected.skipped,\n\t\tsummaries: declarationSummaries,\n\t};\n}\n\nfunction declarationOrdered(handlers: readonly ExecutableHookHandler[]): readonly OrderedHandler[] {\n\treturn handlers\n\t\t.map((handler, index) => ({ declarationIndex: index, handler }))\n\t\t.toSorted(\n\t\t\t(left, right) =>\n\t\t\t\tcompareHandlers(left.handler, right.handler) || left.declarationIndex - right.declarationIndex,\n\t\t);\n}\n\nfunction compareHandlers(left: ExecutableHookHandler, right: ExecutableHookHandler): number {\n\treturn (\n\t\tleft.source.displayOrder - right.source.displayOrder ||\n\t\tleft.groupIndex - right.groupIndex ||\n\t\tleft.handlerIndex - right.handlerIndex\n\t);\n}\n\nfunction selectExecutableHandlers(\n\thandlers: readonly OrderedHandler[],\n\ttrustState: HookTrustState,\n\ttrustOptions: HookTrustOptions | undefined,\n): { readonly runnable: readonly RunnableHandler[]; readonly skipped: readonly HookDispatchSkipped[] } {\n\tconst records = listHookTrustRecords(\n\t\thandlers.map((item) => item.handler),\n\t\ttrustState,\n\t\ttrustOptions,\n\t);\n\tconst runnable: RunnableHandler[] = [];\n\tconst skipped: HookDispatchSkipped[] = [];\n\tfor (const [index, item] of handlers.entries()) {\n\t\tconst record = records[index];\n\t\tif (record === undefined) continue;\n\t\tconst safetyDiagnostics = validateHookHandlerSafety(item.handler);\n\t\tconst unsafe = safetyDiagnostics.some((diagnostic) => diagnostic.severity === \"error\");\n\t\tif (unsafe) {\n\t\t\tskipped.push({ diagnostics: safetyDiagnostics, handler: item.handler, reason: \"unsafe\", record });\n\t\t\tcontinue;\n\t\t}\n\t\tif (!record.enabled) {\n\t\t\tskipped.push({ diagnostics: [], handler: item.handler, reason: \"disabled\", record });\n\t\t\tcontinue;\n\t\t}\n\t\tif (!record.trusted) {\n\t\t\tskipped.push({ diagnostics: [], handler: item.handler, reason: \"untrusted\", record });\n\t\t\tcontinue;\n\t\t}\n\t\trunnable.push({ ...item, record });\n\t}\n\treturn { runnable, skipped };\n}\n\nfunction aggregateDecision(\n\tevent: HookInputWire[\"event\"],\n\tsummaries: readonly HookDispatchSummary[],\n): HookDispatchDecision {\n\tswitch (event) {\n\t\tcase \"PreToolUse\":\n\t\t\treturn aggregatePreToolUseDecision(summaries);\n\t\tcase \"PostToolUse\":\n\t\tcase \"UserPromptSubmit\":\n\t\tcase \"SessionStart\":\n\t\tcase \"PreCompact\":\n\t\tcase \"PostCompact\":\n\t\tcase \"Stop\":\n\t\t\treturn aggregateBlockingDecision(summaries);\n\t}\n}\n\nfunction aggregatePreToolUseDecision(summaries: readonly HookDispatchSummary[]): HookDispatchDecision {\n\tconst blocker = summaries.find(hasBlockingDecision);\n\tif (blocker !== undefined) {\n\t\treturn decisionWithSource(\"block\", blocker, blocker.output.reason);\n\t}\n\tconst ask = summaries.find((summary) => summary.output.decision === \"ask\");\n\tif (ask !== undefined) {\n\t\tconst reason = ask.output.reason ?? \"Hook requested manual approval.\";\n\t\treturn {\n\t\t\tfallback: { kind: \"block\", reason },\n\t\t\tkind: \"ask\",\n\t\t\tnativeRepresentable: false,\n\t\t\t...reasonField(ask.output.reason),\n\t\t\tsource: ask.handler.source,\n\t\t\tsourceCommand: ask.handler.config.command,\n\t\t};\n\t}\n\tlet allowSummary: HookDispatchSummary | undefined;\n\tfor (const summary of summaries) {\n\t\tif (summary.output.decision === \"allow\" || summary.output.decision === \"approve\") allowSummary = summary;\n\t}\n\tif (allowSummary !== undefined) {\n\t\treturn decisionWithSource(\"allow\", allowSummary, undefined, allowSummary.output.updatedInput);\n\t}\n\treturn { kind: \"none\" };\n}\n\nfunction aggregateBlockingDecision(summaries: readonly HookDispatchSummary[]): HookDispatchDecision {\n\tconst blocker = summaries.find(hasBlockingDecision);\n\tif (blocker !== undefined) {\n\t\treturn decisionWithSource(\"block\", blocker, blocker.output.reason ?? blocker.output.stopReason);\n\t}\n\treturn { kind: \"none\" };\n}\n\nfunction hasBlockingDecision(summary: HookDispatchSummary): boolean {\n\treturn summary.output.decision === \"block\" || summary.output.decision === \"deny\";\n}\n\nfunction decisionWithSource(\n\tkind: \"allow\" | \"block\",\n\tsummary: HookDispatchSummary,\n\treason: string | undefined,\n\tupdatedInput?: unknown,\n): HookDispatchDecision {\n\treturn {\n\t\tkind,\n\t\t...reasonField(reason),\n\t\tsource: summary.handler.source,\n\t\tsourceCommand: summary.handler.config.command,\n\t\t...updatedInputField(updatedInput),\n\t};\n}\n\nfunction reasonField(reason: string | undefined): { readonly reason?: string } {\n\tif (reason === undefined) {\n\t\treturn {};\n\t}\n\treturn { reason };\n}\n\nfunction updatedInputField(updatedInput: unknown): { readonly updatedInput?: unknown } {\n\tif (updatedInput === undefined) {\n\t\treturn {};\n\t}\n\treturn { updatedInput };\n}\n"]}

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

@@ -0,0 +1,12 @@
+import type { ExecutableHookHandler, HookDiagnostic, HookSourceMetadata, SupportedHookEvent } from "./types.ts";
+type HandlerParseContext = {
+    readonly event: SupportedHookEvent;
+    readonly matcher?: string;
+    readonly groupIndex: number;
+    readonly handlerIndex: number;
+    readonly source: HookSourceMetadata;
+    readonly diagnostics: HookDiagnostic[];
+};
+export declare function parseHandler(handler: unknown, context: HandlerParseContext): ExecutableHookHandler | undefined;
+export {};
+//# sourceMappingURL=handler.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"handler.d.ts","sourceRoot":"","sources":["../../../../../src/core/extensions/builtin/hooks/handler.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAEX,qBAAqB,EACrB,cAAc,EACd,kBAAkB,EAClB,kBAAkB,EAClB,MAAM,YAAY,CAAC;AAIpB,KAAK,mBAAmB,GAAG;IAC1B,QAAQ,CAAC,KAAK,EAAE,kBAAkB,CAAC;IACnC,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,MAAM,EAAE,kBAAkB,CAAC;IACpC,QAAQ,CAAC,WAAW,EAAE,cAAc,EAAE,CAAC;CACvC,CAAC;AAEF,wBAAgB,YAAY,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,mBAAmB,GAAG,qBAAqB,GAAG,SAAS,CAiE9G"}

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

@@ -0,0 +1,128 @@
+import { diagnostic } from "./diagnostics.js";
+import { isValidHookTimeoutSeconds } from "./safety.js";
+const UNSUPPORTED_COMMAND_FIELDS = ["if", "shell", "asyncRewake", "terminalSequence", "continueOnBlock"];
+export function parseHandler(handler, context) {
+    const path = `hooks.${context.event}[${context.groupIndex}].hooks[${context.handlerIndex}]`;
+    if (!isRecord(handler)) {
+        context.diagnostics.push(diagnostic({ code: "invalid_handler", event: context.event, message: "Hook handler must be an object.", path }, context.source));
+        return undefined;
+    }
+    const type = handler.type;
+    if (type !== "command") {
+        context.diagnostics.push(diagnostic({
+            code: "unsupported_handler_type",
+            event: context.event,
+            message: 'Only type: "command" hook handlers are executable in builtin hooks v1.',
+            path: `${path}.type`,
+            severity: "warning",
+        }, context.source));
+        return undefined;
+    }
+    if (hasUnsupportedCommandShape(handler, path, context)) {
+        return undefined;
+    }
+    const command = handler.command;
+    if (typeof command !== "string") {
+        context.diagnostics.push(diagnostic({
+            code: "invalid_command",
+            event: context.event,
+            message: "Command hook command must be a string.",
+            path: `${path}.command`,
+        }, context.source));
+        return undefined;
+    }
+    const normalized = normalizeCommandConfig(handler, command, path, context);
+    if (!normalized) {
+        return undefined;
+    }
+    const base = {
+        config: normalized,
+        event: context.event,
+        groupIndex: context.groupIndex,
+        handlerIndex: context.handlerIndex,
+        source: context.source,
+    };
+    if (context.matcher === undefined) {
+        return base;
+    }
+    return { ...base, matcher: context.matcher };
+}
+function hasUnsupportedCommandShape(handler, path, context) {
+    let unsupported = false;
+    for (const field of UNSUPPORTED_COMMAND_FIELDS) {
+        if (field in handler) {
+            unsupported = true;
+            context.diagnostics.push(diagnostic({
+                code: "unsupported_field",
+                event: context.event,
+                message: `Command hook field ${field} is not executable in builtin hooks v1.`,
+                path: `${path}.${field}`,
+                severity: "warning",
+            }, context.source));
+        }
+    }
+    if (handler.async === true) {
+        unsupported = true;
+        context.diagnostics.push(diagnostic({
+            code: "unsupported_async_handler",
+            event: context.event,
+            message: "Async hook handlers are not executable in builtin hooks v1.",
+            path: `${path}.async`,
+            severity: "warning",
+        }, context.source));
+    }
+    if ("args" in handler || isRecord(handler.command)) {
+        unsupported = true;
+        context.diagnostics.push(diagnostic({
+            code: "unsupported_command_variant",
+            event: context.event,
+            message: "Exec-form command hooks are not executable in builtin hooks v1.",
+            path: `${path}.command`,
+            severity: "warning",
+        }, context.source));
+    }
+    return unsupported;
+}
+function normalizeCommandConfig(handler, command, path, context) {
+    const commandWindowsValue = handler.commandWindows ?? handler.command_windows;
+    if (commandWindowsValue !== undefined && typeof commandWindowsValue !== "string") {
+        context.diagnostics.push(diagnostic({
+            code: "invalid_command_windows",
+            event: context.event,
+            message: "commandWindows must be a string.",
+            path: `${path}.commandWindows`,
+        }, context.source));
+        return undefined;
+    }
+    const timeout = handler.timeout;
+    if (timeout !== undefined && (typeof timeout !== "number" || !isValidHookTimeoutSeconds(timeout))) {
+        context.diagnostics.push(diagnostic({
+            code: "invalid_timeout",
+            event: context.event,
+            message: "Command hook timeout must be a finite number greater than 0.",
+            path: `${path}.timeout`,
+        }, context.source));
+        return undefined;
+    }
+    const statusMessage = handler.statusMessage;
+    if (statusMessage !== undefined && typeof statusMessage !== "string") {
+        context.diagnostics.push(diagnostic({
+            code: "invalid_status_message",
+            event: context.event,
+            message: "Command hook statusMessage must be a string.",
+            path: `${path}.statusMessage`,
+        }, context.source));
+        return undefined;
+    }
+    return {
+        type: "command",
+        command,
+        ...(typeof commandWindowsValue === "string" ? { commandWindows: commandWindowsValue } : {}),
+        ...(typeof timeout === "number" ? { timeout } : {}),
+        ...(typeof statusMessage === "string" ? { statusMessage } : {}),
+    };
+}
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+//# sourceMappingURL=handler.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"handler.js","sourceRoot":"","sources":["../../../../../src/core/extensions/builtin/hooks/handler.ts"],"names":[],"mappings":"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","sourcesContent":["import { diagnostic } from \"./diagnostics.ts\";\nimport { isValidHookTimeoutSeconds } from \"./safety.ts\";\nimport type {\n\tCommandHookConfig,\n\tExecutableHookHandler,\n\tHookDiagnostic,\n\tHookSourceMetadata,\n\tSupportedHookEvent,\n} from \"./types.ts\";\n\nconst UNSUPPORTED_COMMAND_FIELDS = [\"if\", \"shell\", \"asyncRewake\", \"terminalSequence\", \"continueOnBlock\"] as const;\n\ntype HandlerParseContext = {\n\treadonly event: SupportedHookEvent;\n\treadonly matcher?: string;\n\treadonly groupIndex: number;\n\treadonly handlerIndex: number;\n\treadonly source: HookSourceMetadata;\n\treadonly diagnostics: HookDiagnostic[];\n};\n\nexport function parseHandler(handler: unknown, context: HandlerParseContext): ExecutableHookHandler | undefined {\n\tconst path = `hooks.${context.event}[${context.groupIndex}].hooks[${context.handlerIndex}]`;\n\tif (!isRecord(handler)) {\n\t\tcontext.diagnostics.push(\n\t\t\tdiagnostic(\n\t\t\t\t{ code: \"invalid_handler\", event: context.event, message: \"Hook handler must be an object.\", path },\n\t\t\t\tcontext.source,\n\t\t\t),\n\t\t);\n\t\treturn undefined;\n\t}\n\n\tconst type = handler.type;\n\tif (type !== \"command\") {\n\t\tcontext.diagnostics.push(\n\t\t\tdiagnostic(\n\t\t\t\t{\n\t\t\t\t\tcode: \"unsupported_handler_type\",\n\t\t\t\t\tevent: context.event,\n\t\t\t\t\tmessage: 'Only type: \"command\" hook handlers are executable in builtin hooks v1.',\n\t\t\t\t\tpath: `${path}.type`,\n\t\t\t\t\tseverity: \"warning\",\n\t\t\t\t},\n\t\t\t\tcontext.source,\n\t\t\t),\n\t\t);\n\t\treturn undefined;\n\t}\n\n\tif (hasUnsupportedCommandShape(handler, path, context)) {\n\t\treturn undefined;\n\t}\n\n\tconst command = handler.command;\n\tif (typeof command !== \"string\") {\n\t\tcontext.diagnostics.push(\n\t\t\tdiagnostic(\n\t\t\t\t{\n\t\t\t\t\tcode: \"invalid_command\",\n\t\t\t\t\tevent: context.event,\n\t\t\t\t\tmessage: \"Command hook command must be a string.\",\n\t\t\t\t\tpath: `${path}.command`,\n\t\t\t\t},\n\t\t\t\tcontext.source,\n\t\t\t),\n\t\t);\n\t\treturn undefined;\n\t}\n\n\tconst normalized = normalizeCommandConfig(handler, command, path, context);\n\tif (!normalized) {\n\t\treturn undefined;\n\t}\n\n\tconst base = {\n\t\tconfig: normalized,\n\t\tevent: context.event,\n\t\tgroupIndex: context.groupIndex,\n\t\thandlerIndex: context.handlerIndex,\n\t\tsource: context.source,\n\t};\n\tif (context.matcher === undefined) {\n\t\treturn base;\n\t}\n\treturn { ...base, matcher: context.matcher };\n}\n\nfunction hasUnsupportedCommandShape(\n\thandler: Record<string, unknown>,\n\tpath: string,\n\tcontext: HandlerParseContext,\n): boolean {\n\tlet unsupported = false;\n\tfor (const field of UNSUPPORTED_COMMAND_FIELDS) {\n\t\tif (field in handler) {\n\t\t\tunsupported = true;\n\t\t\tcontext.diagnostics.push(\n\t\t\t\tdiagnostic(\n\t\t\t\t\t{\n\t\t\t\t\t\tcode: \"unsupported_field\",\n\t\t\t\t\t\tevent: context.event,\n\t\t\t\t\t\tmessage: `Command hook field ${field} is not executable in builtin hooks v1.`,\n\t\t\t\t\t\tpath: `${path}.${field}`,\n\t\t\t\t\t\tseverity: \"warning\",\n\t\t\t\t\t},\n\t\t\t\t\tcontext.source,\n\t\t\t\t),\n\t\t\t);\n\t\t}\n\t}\n\n\tif (handler.async === true) {\n\t\tunsupported = true;\n\t\tcontext.diagnostics.push(\n\t\t\tdiagnostic(\n\t\t\t\t{\n\t\t\t\t\tcode: \"unsupported_async_handler\",\n\t\t\t\t\tevent: context.event,\n\t\t\t\t\tmessage: \"Async hook handlers are not executable in builtin hooks v1.\",\n\t\t\t\t\tpath: `${path}.async`,\n\t\t\t\t\tseverity: \"warning\",\n\t\t\t\t},\n\t\t\t\tcontext.source,\n\t\t\t),\n\t\t);\n\t}\n\n\tif (\"args\" in handler || isRecord(handler.command)) {\n\t\tunsupported = true;\n\t\tcontext.diagnostics.push(\n\t\t\tdiagnostic(\n\t\t\t\t{\n\t\t\t\t\tcode: \"unsupported_command_variant\",\n\t\t\t\t\tevent: context.event,\n\t\t\t\t\tmessage: \"Exec-form command hooks are not executable in builtin hooks v1.\",\n\t\t\t\t\tpath: `${path}.command`,\n\t\t\t\t\tseverity: \"warning\",\n\t\t\t\t},\n\t\t\t\tcontext.source,\n\t\t\t),\n\t\t);\n\t}\n\treturn unsupported;\n}\n\nfunction normalizeCommandConfig(\n\thandler: Record<string, unknown>,\n\tcommand: string,\n\tpath: string,\n\tcontext: HandlerParseContext,\n): CommandHookConfig | undefined {\n\tconst commandWindowsValue = handler.commandWindows ?? handler.command_windows;\n\tif (commandWindowsValue !== undefined && typeof commandWindowsValue !== \"string\") {\n\t\tcontext.diagnostics.push(\n\t\t\tdiagnostic(\n\t\t\t\t{\n\t\t\t\t\tcode: \"invalid_command_windows\",\n\t\t\t\t\tevent: context.event,\n\t\t\t\t\tmessage: \"commandWindows must be a string.\",\n\t\t\t\t\tpath: `${path}.commandWindows`,\n\t\t\t\t},\n\t\t\t\tcontext.source,\n\t\t\t),\n\t\t);\n\t\treturn undefined;\n\t}\n\n\tconst timeout = handler.timeout;\n\tif (timeout !== undefined && (typeof timeout !== \"number\" || !isValidHookTimeoutSeconds(timeout))) {\n\t\tcontext.diagnostics.push(\n\t\t\tdiagnostic(\n\t\t\t\t{\n\t\t\t\t\tcode: \"invalid_timeout\",\n\t\t\t\t\tevent: context.event,\n\t\t\t\t\tmessage: \"Command hook timeout must be a finite number greater than 0.\",\n\t\t\t\t\tpath: `${path}.timeout`,\n\t\t\t\t},\n\t\t\t\tcontext.source,\n\t\t\t),\n\t\t);\n\t\treturn undefined;\n\t}\n\n\tconst statusMessage = handler.statusMessage;\n\tif (statusMessage !== undefined && typeof statusMessage !== \"string\") {\n\t\tcontext.diagnostics.push(\n\t\t\tdiagnostic(\n\t\t\t\t{\n\t\t\t\t\tcode: \"invalid_status_message\",\n\t\t\t\t\tevent: context.event,\n\t\t\t\t\tmessage: \"Command hook statusMessage must be a string.\",\n\t\t\t\t\tpath: `${path}.statusMessage`,\n\t\t\t\t},\n\t\t\t\tcontext.source,\n\t\t\t),\n\t\t);\n\t\treturn undefined;\n\t}\n\n\treturn {\n\t\ttype: \"command\",\n\t\tcommand,\n\t\t...(typeof commandWindowsValue === \"string\" ? { commandWindows: commandWindowsValue } : {}),\n\t\t...(typeof timeout === \"number\" ? { timeout } : {}),\n\t\t...(typeof statusMessage === \"string\" ? { statusMessage } : {}),\n\t};\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/index.d.ts

@@ -0,0 +1,6 @@
+import type { ExtensionAPI } from "../../types.ts";
+export { parseHookConfig } from "./schema.ts";
+export type { CommandHookConfig, ExecutableHookHandler, HookDiagnostic, HookDiagnosticCode, HookInputWire, HookOutputWire, HookRuntimeState, HookSourceMetadata, HookTrustEntry, HookTrustState, ParsedHookConfig, SupportedHookEvent, UnsupportedKnownHookEvent, } from "./types.ts";
+export default function hooksExtension(pi: ExtensionAPI): void;
+export { SUPPORTED_HOOK_EVENTS, UNSUPPORTED_HANDLER_TYPES, UNSUPPORTED_KNOWN_HOOK_EVENTS, } from "./types.ts";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/core/extensions/builtin/hooks/index.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAA+B,YAAY,EAAuC,MAAM,gBAAgB,CAAC;AAqCrH,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC9C,YAAY,EACX,iBAAiB,EACjB,qBAAqB,EACrB,cAAc,EACd,kBAAkB,EAClB,aAAa,EACb,cAAc,EACd,gBAAgB,EAChB,kBAAkB,EAClB,cAAc,EACd,cAAc,EACd,gBAAgB,EAChB,kBAAkB,EAClB,yBAAyB,GACzB,MAAM,YAAY,CAAC;AAEpB,MAAM,CAAC,OAAO,UAAU,cAAc,CAAC,EAAE,EAAE,YAAY,GAAG,IAAI,CAyM7D;AAmBD,OAAO,EACN,qBAAqB,EACrB,yBAAyB,EACzB,6BAA6B,GAC7B,MAAM,YAAY,CAAC"}