@anthara/pi-claude 0.0.0-stage → 0.1.0

package/dist/extensions/hooks/hook-session.js

@@ -0,0 +1,127 @@
+import { homedir } from 'node:os';
+import { claudeConfigDir } from '../../kernel/claude-home/config-dir.js';
+import { projectFolders } from '../../kernel/claude-home/project-folders.js';
+import { projectSettingsFiles } from '../../kernel/claude-home/project-settings.js';
+import { userSettingsPath } from '../../kernel/claude-home/user-settings.js';
+import { publishSubagentHooks, withdrawSubagentHooks } from '../../kernel/subagent-hooks/subagent-hooks-slot.js';
+import { sessionPluginCatalog } from '../../kernel/plugin-catalog/catalog-slot.js';
+import { loadPluginCatalog } from '../../kernel/plugin-catalog/plugin-catalog.js';
+import { projectTrustFor } from '../../kernel/project-trust/project-trust.js';
+import { scopedHooks } from '../../kernel/scoped-hooks/scoped-hooks.js';
+import { announce } from './bridges/event-bridge.js';
+import { bridgesOn } from './bridges/event-bridges.js';
+import { IDLE_PROMPT, SUBAGENT_STARTING, SUBAGENT_STOPPED } from './bridges/triggers.js';
+import { IdleWatch } from './delivery/idle-watch.js';
+import { PendingContext } from './delivery/pending-context.js';
+import { StopContinuations } from './delivery/stop-continuations.js';
+import { ToolCallNotes } from './delivery/tool-call-notes.js';
+import { HookDispatcher } from './dispatch/hook-dispatcher.js';
+import { describeSource } from './registry/hook-handler.js';
+import { unsupportedNotices } from './registry/unsupported-notices.js';
+import { collectHooks } from './registry/hook-sources.js';
+import { hookRegistry } from './registry/hook-registry.js';
+import { formatHooksSummary } from './registry/hooks-summary.js';
+import { BackgroundHooks } from './runners/background-hooks.js';
+const IDLE_SUBJECT = { kind: 'value', value: IDLE_PROMPT };
+const NOTHING_LOADED = { registry: hookRegistry(() => [], () => false), current: () => ({ groups: [], skipped: [] }) };
+export class HookSession {
+    #background;
+    #dispatcher;
+    #reported = new Set();
+    #idle = new IdleWatch();
+    #heldContext;
+    #services;
+    #loaded = NOTHING_LOADED;
+    constructor(pi) {
+        this.#background = new BackgroundHooks(pi);
+        this.#dispatcher = new HookDispatcher(() => this.#loaded.registry, this.#background);
+        this.#services = { pi, projectDir: '', sessionContext: new PendingContext(), toolCalls: new ToolCallNotes(), stops: new StopContinuations(pi) };
+    }
+    async open(ctx) {
+        const folders = projectFolders(ctx.cwd, homedir());
+        const trusted = (await projectTrustFor(ctx)) === 'trusted';
+        this.#services = { ...this.#services, projectDir: folders.at(-1) ?? ctx.cwd };
+        this.#loaded = collectHooks(hookSourcesFor(ctx, folders, trusted));
+        this.#heldContext = ctx;
+        publishSubagentHooks(ctx.sessionManager.getSessionId(), this.#subagentHooks());
+    }
+    async runBridges(trigger, event, ctx) {
+        this.#reportUnrunnable(ctx);
+        const results = [];
+        for (const bridge of bridgesOn(trigger)) {
+            results.push(await this.#runBridge(bridge, event, ctx));
+        }
+        return results.find((result) => result !== undefined);
+    }
+    runAnnounced(trigger, event) {
+        return this.#heldContext === undefined ? Promise.resolve(undefined) : this.#runWhileSessionLives(trigger, event, this.#heldContext);
+    }
+    armIdle(ctx) {
+        if (this.#loaded.registry.handlersFor('Notification', IDLE_SUBJECT).length > 0) {
+            this.#idle.arm(() => {
+                void this.#runWhileSessionLives(IDLE_PROMPT, undefined, ctx);
+            });
+        }
+    }
+    disarmIdle() {
+        this.#idle.cancel();
+    }
+    takeSessionContext() {
+        return this.#services.sessionContext.take();
+    }
+    settleToolCall(toolCallId, ctx) {
+        this.#services.toolCalls.settle(toolCallId, ctx);
+    }
+    close(ctx) {
+        this.#idle.cancel();
+        withdrawSubagentHooks(ctx.sessionManager.getSessionId());
+        if (!ctx.hasUI) {
+            this.#background.stopAll();
+        }
+    }
+    summary() {
+        return formatHooksSummary(this.#loaded.current().groups);
+    }
+    async #runBridge(bridge, event, ctx) {
+        const call = { event: event, ctx, services: this.#services };
+        if (!bridge.firesOn(call.event)) {
+            return undefined;
+        }
+        return bridge.apply(await this.#dispatcher.dispatch(bridge, call), call);
+    }
+    async #runWhileSessionLives(trigger, event, ctx) {
+        try {
+            return await this.runBridges(trigger, event, ctx);
+        }
+        catch {
+            return undefined;
+        }
+    }
+    #subagentHooks() {
+        return {
+            start: async (starting) => stringsIn(await this.runAnnounced(SUBAGENT_STARTING, starting)),
+            stop: async (stopped) => {
+                await this.runAnnounced(SUBAGENT_STOPPED, stopped);
+            },
+        };
+    }
+    #reportUnrunnable(ctx) {
+        const { skipped, groups } = this.#loaded.current();
+        const unreported = [...skipped.map(skippedNotice), ...unsupportedNotices(groups)].filter((notice) => !this.#reported.has(notice));
+        unreported.forEach((notice) => this.#reported.add(notice));
+        announce(ctx, unreported);
+    }
+}
+const skippedNotice = ({ event, source, reason }) => `${event} hook in ${describeSource(source)} is not run: ${reason}`;
+const stringsIn = (value) => (Array.isArray(value) ? value.filter((item) => typeof item === 'string') : []);
+function hookSourcesFor(ctx, folders, trusted) {
+    const claudeDir = claudeConfigDir(process.env, homedir());
+    const sessionId = ctx.sessionManager.getSessionId();
+    return {
+        settingsFiles: [userSettingsPath(claudeDir), ...(trusted ? projectSettingsFiles(folders) : [])],
+        plugins: sessionPluginCatalog(sessionId, () => loadPluginCatalog({ claudeDir })).enabled(),
+        scoped: () => scopedHooks().all(sessionId).filter((set) => trusted || !set.fromProject),
+        isSpent: (onceKey) => scopedHooks().isSpent(sessionId, onceKey),
+    };
+}
+//# sourceMappingURL=hook-session.js.map

package/dist/extensions/hooks/hook-session.js.map

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

package/dist/extensions/hooks/index.d.ts

@@ -0,0 +1,2 @@
+import type { ExtensionAPI } from '@earendil-works/pi-coding-agent';
+export default function hooksExtension(pi: ExtensionAPI): void;

package/dist/extensions/hooks/index.js

@@ -0,0 +1,60 @@
+import { BRIDGED_CHANNELS, BRIDGED_PI_EVENTS } from './bridges/event-bridges.js';
+import { isAnnouncement } from './bridges/triggers.js';
+import { HookSession } from './hook-session.js';
+const HOOKS_COMMAND = 'hooks';
+const HOOKS_COMMAND_DESCRIPTION = 'Show the Claude hooks this session runs, per event, with where each came from';
+export default function hooksExtension(pi) {
+    const session = new HookSession(pi);
+    pi.on('session_start', (_event, ctx) => session.open(ctx));
+    for (const piEvent of BRIDGED_PI_EVENTS) {
+        onPiEvent(pi, piEvent, (event, ctx) => session.runBridges(piEvent, event, ctx));
+    }
+    const leaveChannels = followAnnouncements(pi, session);
+    followIdleness(pi, session);
+    pi.on('before_agent_start', () => session.takeSessionContext());
+    pi.on('tool_execution_end', (event, ctx) => {
+        session.settleToolCall(event.toolCallId, ctx);
+    });
+    pi.on('session_shutdown', (_event, ctx) => {
+        leaveChannels();
+        session.close(ctx);
+    });
+    registerHooksCommand(pi, session);
+}
+function followIdleness(pi, session) {
+    pi.on('agent_end', (_event, ctx) => {
+        session.armIdle(ctx);
+    });
+    pi.on('input', () => {
+        session.disarmIdle();
+    });
+    pi.on('agent_start', () => {
+        session.disarmIdle();
+    });
+}
+function followAnnouncements(pi, session) {
+    const leavers = BRIDGED_CHANNELS.map((channel) => pi.events.on(channel, (data) => {
+        if (isAnnouncement(channel, data)) {
+            void session.runAnnounced(channel, data);
+        }
+    }));
+    return () => {
+        leavers.forEach((leave) => {
+            leave();
+        });
+    };
+}
+function registerHooksCommand(pi, session) {
+    pi.registerCommand(HOOKS_COMMAND, {
+        description: HOOKS_COMMAND_DESCRIPTION,
+        handler: (_args, ctx) => {
+            ctx.ui.notify(session.summary(), 'info');
+            return Promise.resolve();
+        },
+    });
+}
+function onPiEvent(pi, piEvent, handler) {
+    const on = pi.on.bind(pi);
+    on(piEvent, handler);
+}
+//# sourceMappingURL=index.js.map

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

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

package/dist/extensions/hooks/registry/bash-if-filter.d.ts

@@ -0,0 +1 @@
+export declare function matchesBashIfFilter(command: string, rule: string): boolean;

package/dist/extensions/hooks/registry/bash-if-filter.js

@@ -0,0 +1,40 @@
+// Portions adapted from pi-code (MIT, github.com/ilovepixelart/pi-code), extensions/internal/bash-rules.ts and extensions/internal/shell-split.ts.
+import { splitSegments } from '../../../kernel/prompt-expansion/shell-segments.js';
+import { wholeTextWildcard } from './wildcard.js';
+const SUBSTITUTION = /\$\(|`|<\(|>\(/;
+const SUBSTITUTION_BODY = /\$\(([^()]*)\)|`([^`]*)`|[<>]\(([^()]*)\)/g;
+const LEADING_ASSIGNMENTS = /^(?:[A-Za-z_]\w*=(?:"[^"]*"|'[^']*'|\S*)\s+)+/;
+const VARIABLE_REFERENCE = /\$[A-Za-z_{]/;
+const UNRESOLVABLE_HEAD = /[$`]/;
+const PREFIX_WILDCARD = ':*';
+const TRAILING_WILDCARD = ' *';
+export function matchesBashIfFilter(command, rule) {
+    const pattern = withTrailingWildcard(rule.trim());
+    const segments = splitSegments(command);
+    if (segments.length === 0) {
+        return command.trim() !== '';
+    }
+    const candidates = segments.flatMap(candidatesOf);
+    return candidates.some((candidate) => matchesRule(candidate, pattern) || headIsUnresolvable(candidate)) || hidesWhatItRuns(command, pattern);
+}
+const withTrailingWildcard = (rule) => (rule.endsWith(PREFIX_WILDCARD) ? `${rule.slice(0, -PREFIX_WILDCARD.length)}${TRAILING_WILDCARD}` : rule);
+const withoutAssignments = (segment) => segment.replace(LEADING_ASSIGNMENTS, '');
+function candidatesOf(segment) {
+    const stripped = withoutAssignments(segment);
+    const inner = substitutionBodies(stripped).flatMap((body) => splitSegments(body).map(withoutAssignments));
+    return [stripped, ...inner];
+}
+function substitutionBodies(command) {
+    return [...command.matchAll(SUBSTITUTION_BODY)].map((match) => (match[1] ?? match[2] ?? match[3] ?? '').trim()).filter((body) => body !== '');
+}
+function matchesRule(segment, pattern) {
+    if (isBareCommandOf(segment, pattern)) {
+        return true;
+    }
+    return pattern.includes('*') ? wholeTextWildcard(pattern).test(segment) : segment === pattern;
+}
+const isBareCommandOf = (segment, pattern) => pattern.endsWith(TRAILING_WILDCARD) && pattern.indexOf('*') === pattern.length - 1 && segment === pattern.slice(0, -TRAILING_WILDCARD.length);
+const headIsUnresolvable = (segment) => UNRESOLVABLE_HEAD.test(segment.split(/\s+/, 1)[0] ?? '');
+const namesMoreThanCommand = (pattern) => (pattern.split('*', 1)[0] ?? '').trim().includes(' ');
+const hidesWhatItRuns = (command, pattern) => namesMoreThanCommand(pattern) && (SUBSTITUTION.test(command) || VARIABLE_REFERENCE.test(command));
+//# sourceMappingURL=bash-if-filter.js.map

package/dist/extensions/hooks/registry/bash-if-filter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bash-if-filter.js","sourceRoot":"","sources":["../../../../src/extensions/hooks/registry/bash-if-filter.ts"],"names":[],"mappings":"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"}

package/dist/extensions/hooks/registry/hook-handler.d.ts

@@ -0,0 +1,63 @@
+export type HookSource = {
+    readonly kind: 'settings';
+    readonly file: string;
+} | {
+    readonly kind: 'plugin';
+    readonly plugin: string;
+    readonly root: string;
+    readonly dataDir: string;
+    readonly file: string;
+} | {
+    readonly kind: 'scoped';
+    readonly name: string;
+};
+export type Background = 'none' | 'async' | 'rewake';
+interface HandlerBase {
+    readonly source: HookSource;
+    readonly label: string;
+    readonly identity: string;
+    readonly timeoutSeconds: number | undefined;
+    readonly ifRule: string | undefined;
+    readonly blocksOnFailure: boolean;
+    readonly onceKey: string | undefined;
+}
+export interface CommandHandler extends HandlerBase {
+    readonly type: 'command';
+    readonly command: string;
+    readonly args: readonly string[] | undefined;
+    readonly background: Background;
+}
+export interface HttpHandler extends HandlerBase {
+    readonly type: 'http';
+    readonly url: string;
+    readonly headers: Readonly<Record<string, string>>;
+    readonly allowedEnvVars: readonly string[];
+}
+export interface PromptHandler extends HandlerBase {
+    readonly type: 'prompt';
+    readonly prompt: string;
+    readonly model: string | undefined;
+}
+export interface AgentHandler extends HandlerBase {
+    readonly type: 'agent';
+    readonly prompt: string;
+    readonly model: string | undefined;
+}
+export type HookHandler = CommandHandler | HttpHandler | PromptHandler | AgentHandler;
+export type HookHandlerType = HookHandler['type'];
+export interface HookGroup {
+    readonly event: string;
+    readonly matcher: string | undefined;
+    readonly handlers: readonly HookHandler[];
+}
+export interface SkippedHook {
+    readonly event: string;
+    readonly source: HookSource;
+    readonly reason: string;
+}
+export interface ParsedHooks {
+    readonly groups: readonly HookGroup[];
+    readonly skipped: readonly SkippedHook[];
+}
+export declare function describeSource(source: HookSource): string;
+export {};

package/dist/extensions/hooks/registry/hook-handler.js

@@ -0,0 +1,4 @@
+export function describeSource(source) {
+    return source.kind === 'scoped' ? source.name : source.file;
+}
+//# sourceMappingURL=hook-handler.js.map

package/dist/extensions/hooks/registry/hook-handler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hook-handler.js","sourceRoot":"","sources":["../../../../src/extensions/hooks/registry/hook-handler.ts"],"names":[],"mappings":"AAgEA,MAAM,UAAU,cAAc,CAAC,MAAkB;IAC/C,OAAO,MAAM,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC;AAC9D,CAAC"}

package/dist/extensions/hooks/registry/hook-registry.d.ts

@@ -0,0 +1,6 @@
+import type { HookGroup, HookHandler } from './hook-handler.js';
+import type { MatchSubject } from './match-subject.js';
+export interface HookRegistry {
+    handlersFor(event: string, subject: MatchSubject): readonly HookHandler[];
+}
+export declare function hookRegistry(groups: () => readonly HookGroup[], isSpent: (onceKey: string) => boolean): HookRegistry;

package/dist/extensions/hooks/registry/hook-registry.js

@@ -0,0 +1,39 @@
+import { compileIfRule } from './if-rule.js';
+import { compileMatcher } from './matcher.js';
+export function hookRegistry(groups, isSpent) {
+    return {
+        handlersFor: (event, subject) => distinct(groups()
+            .filter((group) => group.event === event && groupApplies(group, subject))
+            .flatMap(({ handlers }) => handlers)
+            .filter((handler) => passesIfRule(handler, subject) && !isSpentOnce(handler, isSpent))),
+    };
+}
+function groupApplies({ matcher }, subject) {
+    if (subject.kind === 'none') {
+        return true;
+    }
+    return compileMatcher(matcher).matches(subject.kind === 'tool' ? subject.call.names : [subject.value]);
+}
+function passesIfRule({ ifRule }, subject) {
+    if (ifRule === undefined) {
+        return true;
+    }
+    return subject.kind === 'tool' && compileIfRule(ifRule).allows(subject.call);
+}
+const isSpentOnce = ({ onceKey }, isSpent) => onceKey !== undefined && isSpent(onceKey);
+function distinct(handlers) {
+    const seen = new Set();
+    return handlers.filter((handler) => {
+        const key = `${dedupScope(handler.source)}\n${handler.identity}`;
+        const fresh = !seen.has(key);
+        seen.add(key);
+        return fresh;
+    });
+}
+function dedupScope(source) {
+    if (source.kind === 'settings') {
+        return 'settings';
+    }
+    return source.kind === 'plugin' ? `plugin:${source.plugin}` : `scoped:${source.name}`;
+}
+//# sourceMappingURL=hook-registry.js.map

package/dist/extensions/hooks/registry/hook-registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hook-registry.js","sourceRoot":"","sources":["../../../../src/extensions/hooks/registry/hook-registry.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAE7C,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAM9C,MAAM,UAAU,YAAY,CAAC,MAAkC,EAAE,OAAqC;IACpG,OAAO;QACL,WAAW,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE,CAC9B,QAAQ,CACN,MAAM,EAAE;aACL,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,KAAK,KAAK,KAAK,IAAI,YAAY,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;aACxE,OAAO,CAAC,CAAC,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC,QAAQ,CAAC;aACnC,MAAM,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,YAAY,CAAC,OAAO,EAAE,OAAO,CAAC,IAAI,CAAC,WAAW,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CACzF;KACJ,CAAC;AACJ,CAAC;AAED,SAAS,YAAY,CAAC,EAAE,OAAO,EAAa,EAAE,OAAqB;IACjE,IAAI,OAAO,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;QAC5B,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO,cAAc,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,KAAK,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC;AACzG,CAAC;AAED,SAAS,YAAY,CAAC,EAAE,MAAM,EAAe,EAAE,OAAqB;IAClE,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;QACzB,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO,OAAO,CAAC,IAAI,KAAK,MAAM,IAAI,aAAa,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;AAC/E,CAAC;AAED,MAAM,WAAW,GAAG,CAAC,EAAE,OAAO,EAAe,EAAE,OAAqC,EAAW,EAAE,CAAC,OAAO,KAAK,SAAS,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;AAE5I,SAAS,QAAQ,CAAC,QAAgC;IAChD,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,OAAO,QAAQ,CAAC,MAAM,CAAC,CAAC,OAAO,EAAE,EAAE;QACjC,MAAM,GAAG,GAAG,GAAG,UAAU,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,OAAO,CAAC,QAAQ,EAAE,CAAC;QACjE,MAAM,KAAK,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAC7B,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACd,OAAO,KAAK,CAAC;IACf,CAAC,CAAC,CAAC;AACL,CAAC;AAED,SAAS,UAAU,CAAC,MAAkB;IACpC,IAAI,MAAM,CAAC,IAAI,KAAK,UAAU,EAAE,CAAC;QAC/B,OAAO,UAAU,CAAC;IACpB,CAAC;IACD,OAAO,MAAM,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,UAAU,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,UAAU,MAAM,CAAC,IAAI,EAAE,CAAC;AACxF,CAAC"}

package/dist/extensions/hooks/registry/hook-sources.d.ts

@@ -0,0 +1,15 @@
+import type { CatalogPlugin } from '../../../kernel/plugin-catalog/plugin-catalog.js';
+import type { ScopedHookSet } from '../../../kernel/scoped-hooks/scoped-hooks.js';
+import type { ParsedHooks } from './hook-handler.js';
+import { type HookRegistry } from './hook-registry.js';
+export interface HookSources {
+    readonly settingsFiles: readonly string[];
+    readonly plugins: readonly CatalogPlugin[];
+    readonly scoped: () => readonly ScopedHookSet[];
+    readonly isSpent: (onceKey: string) => boolean;
+}
+export interface LoadedHooks {
+    readonly registry: HookRegistry;
+    current(): ParsedHooks;
+}
+export declare function collectHooks(sources: HookSources): LoadedHooks;

package/dist/extensions/hooks/registry/hook-sources.js

@@ -0,0 +1,48 @@
+import { join } from 'node:path';
+import { PLUGIN_MANIFEST_PATH } from '../../../kernel/claude-home/plugin-layout.js';
+import { isJsonObject, readJsonObjectLeniently } from '../../../kernel/private-files/private-files.js';
+import { hookRegistry } from './hook-registry.js';
+import { mergeParsed, parseHookMap } from './parse-hooks.js';
+import { wholeTextWildcard } from './wildcard.js';
+const PLUGIN_HOOKS_FILE = join('hooks', 'hooks.json');
+const NO_HOOKS = { groups: [], skipped: [] };
+const ALL_HOOKS_OFF = { registry: hookRegistry(() => [], () => false), current: () => NO_HOOKS };
+export function collectHooks(sources) {
+    const settings = sources.settingsFiles.map((file) => ({ file, content: readJsonObjectLeniently(file) }));
+    if (settings.some(({ content }) => content.disableAllHooks === true)) {
+        return ALL_HOOKS_OFF;
+    }
+    const allowlist = allowedHttpUrls(settings);
+    const fixed = admitted(mergeParsed([...settings.map(settingsHooks), ...sources.plugins.flatMap(pluginHooks)]), allowlist);
+    const current = () => mergeParsed([fixed, admitted(mergeParsed(sources.scoped().map(scopedHooksOf)), allowlist)]);
+    return { registry: hookRegistry(() => current().groups, sources.isSpent), current };
+}
+const settingsHooks = ({ file, content }) => parseHookMap(content.hooks, { kind: 'settings', file });
+const scopedHooksOf = ({ name, hooks }) => parseHookMap(hooks, { kind: 'scoped', name });
+function pluginHooks(plugin) {
+    const defaultFile = join(plugin.root, PLUGIN_HOOKS_FILE);
+    const files = [defaultFile, ...plugin.manifest.declaredPaths('hooks').filter((file) => file !== defaultFile)];
+    const fromFiles = files.map((file) => parseHookMap(readJsonObjectLeniently(file).hooks, pluginSource(plugin, file)));
+    const manifest = join(plugin.root, PLUGIN_MANIFEST_PATH);
+    return [...fromFiles, ...inlineHookMaps(plugin.manifest.declaredValue('hooks')).map((map) => parseHookMap(map, pluginSource(plugin, manifest)))];
+}
+const pluginSource = ({ name, root, dataDir }, file) => ({ kind: 'plugin', plugin: name, root, dataDir, file });
+function inlineHookMaps(declared) {
+    const entries = Array.isArray(declared) ? declared : [declared];
+    return entries.filter(isJsonObject);
+}
+function allowedHttpUrls(settings) {
+    const lists = settings.map(({ content }) => content.allowedHttpHookUrls).filter(Array.isArray);
+    return lists.length === 0 ? undefined : lists.flat().filter((entry) => typeof entry === 'string');
+}
+function admitted(parsed, allowlist) {
+    if (allowlist === undefined) {
+        return parsed;
+    }
+    const refusedIn = (group) => group.handlers.filter((handler) => !isAllowed(handler, allowlist));
+    const refusals = parsed.groups.flatMap((group) => refusedIn(group).map((handler) => ({ event: group.event, source: handler.source, reason: `${handler.label} is not in allowedHttpHookUrls` })));
+    const groups = parsed.groups.map((group) => ({ ...group, handlers: group.handlers.filter((handler) => isAllowed(handler, allowlist)) }));
+    return { groups, skipped: [...parsed.skipped, ...refusals] };
+}
+const isAllowed = (handler, allowlist) => handler.type !== 'http' || allowlist.some((pattern) => wholeTextWildcard(pattern).test(handler.url));
+//# sourceMappingURL=hook-sources.js.map

package/dist/extensions/hooks/registry/hook-sources.js.map

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

package/dist/extensions/hooks/registry/hooks-summary.d.ts

@@ -0,0 +1,2 @@
+import { type HookGroup } from './hook-handler.js';
+export declare function formatHooksSummary(groups: readonly HookGroup[]): string;

package/dist/extensions/hooks/registry/hooks-summary.js

@@ -0,0 +1,15 @@
+import { describeSource } from './hook-handler.js';
+const NO_HOOKS_CONFIGURED = 'No hooks configured. Add a "hooks" section to the Claude settings.json, or .claude/settings.json in a trusted project.';
+export function formatHooksSummary(groups) {
+    const linesByEvent = new Map();
+    for (const group of groups) {
+        linesByEvent.set(group.event, [...(linesByEvent.get(group.event) ?? []), ...entryLines(group)]);
+    }
+    const sections = [...linesByEvent].filter(([, lines]) => lines.length > 0);
+    return sections.length === 0 ? NO_HOOKS_CONFIGURED : sections.flatMap(([event, lines]) => [`${event}:`, ...lines]).join('\n');
+}
+function entryLines({ matcher, handlers }) {
+    const shown = matcher === undefined || matcher === '' ? '*' : matcher;
+    return handlers.map((handler) => `  [${shown}] ${handler.type}: ${handler.label} (${describeSource(handler.source)})`);
+}
+//# sourceMappingURL=hooks-summary.js.map

package/dist/extensions/hooks/registry/hooks-summary.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hooks-summary.js","sourceRoot":"","sources":["../../../../src/extensions/hooks/registry/hooks-summary.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAkB,MAAM,mBAAmB,CAAC;AAEnE,MAAM,mBAAmB,GAAG,wHAAwH,CAAC;AAErJ,MAAM,UAAU,kBAAkB,CAAC,MAA4B;IAC7D,MAAM,YAAY,GAAG,IAAI,GAAG,EAAoB,CAAC;IACjD,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,YAAY,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,EAAE,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IAClG,CAAC;IACD,MAAM,QAAQ,GAAG,CAAC,GAAG,YAAY,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IAC3E,OAAO,QAAQ,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,mBAAmB,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,KAAK,GAAG,EAAE,GAAG,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAChI,CAAC;AAED,SAAS,UAAU,CAAC,EAAE,OAAO,EAAE,QAAQ,EAAa;IAClD,MAAM,KAAK,GAAG,OAAO,KAAK,SAAS,IAAI,OAAO,KAAK,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC;IACtE,OAAO,QAAQ,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,MAAM,KAAK,KAAK,OAAO,CAAC,IAAI,KAAK,OAAO,CAAC,KAAK,KAAK,cAAc,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;AACzH,CAAC"}

package/dist/extensions/hooks/registry/if-rule.d.ts

@@ -0,0 +1,5 @@
+import type { ToolCallSubject } from './match-subject.js';
+export interface PermissionRule {
+    allows(call: ToolCallSubject): boolean;
+}
+export declare function compileIfRule(rule: string): PermissionRule;

package/dist/extensions/hooks/registry/if-rule.js

@@ -0,0 +1,41 @@
+// Portions adapted from pi-code (MIT, github.com/ilovepixelart/pi-code), extensions/hooks/matcher.ts.
+import { isJsonObject } from '../../../kernel/private-files/private-files.js';
+import { matchesBashIfFilter } from './bash-if-filter.js';
+import { matchesPathRule } from './path-rule.js';
+const RULE_SHAPE = /^([\w|-]+?)(?:\((.*)\))?$/;
+const TOOL_SEPARATOR = '|';
+const UNREADABLE_RULE = { allows: () => true };
+const COMMAND_RULE = { fieldOf: ({ command }) => command, matches: (command, pattern) => matchesBashIfFilter(command, pattern) };
+const PATH_RULE = {
+    fieldOf: ({ file_path: filePath, path }) => filePath ?? path,
+    matches: (path, pattern, call) => matchesPathRule(path, pattern, call.anchors),
+};
+export function compileIfRule(rule) {
+    const parsed = RULE_SHAPE.exec(rule.trim());
+    if (parsed === null) {
+        return UNREADABLE_RULE;
+    }
+    const tools = new Set((parsed[1] ?? '').split(TOOL_SEPARATOR).map(foldToolName));
+    const pattern = parsed[2];
+    return { allows: (call) => call.names.some((name) => tools.has(foldToolName(name))) && (pattern === undefined || argumentsMatch(call, pattern)) };
+}
+const foldToolName = (name) => name.toLowerCase().replaceAll('-', '_');
+const ARGUMENT_RULES = new Map([
+    ['bash', COMMAND_RULE],
+    ['powershell', COMMAND_RULE],
+    ['read', PATH_RULE],
+    ['edit', PATH_RULE],
+    ['write', PATH_RULE],
+    ['glob', PATH_RULE],
+    ['find', PATH_RULE],
+    ['grep', PATH_RULE],
+]);
+function argumentsMatch(call, pattern) {
+    const rule = call.names.map((name) => ARGUMENT_RULES.get(foldToolName(name))).find((candidate) => candidate !== undefined);
+    if (rule === undefined) {
+        return true;
+    }
+    const value = rule.fieldOf(isJsonObject(call.claudeInput) ? call.claudeInput : {});
+    return typeof value === 'string' && value !== '' && rule.matches(value, pattern, call);
+}
+//# sourceMappingURL=if-rule.js.map

package/dist/extensions/hooks/registry/if-rule.js.map

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

package/dist/extensions/hooks/registry/match-subject.d.ts

@@ -0,0 +1,19 @@
+export interface PathAnchors {
+    readonly cwd: string;
+    readonly projectRoot: string;
+    readonly home: string;
+}
+export interface ToolCallSubject {
+    readonly names: readonly string[];
+    readonly claudeInput: unknown;
+    readonly anchors: PathAnchors;
+}
+export type MatchSubject = {
+    readonly kind: 'tool';
+    readonly call: ToolCallSubject;
+} | {
+    readonly kind: 'value';
+    readonly value: string;
+} | {
+    readonly kind: 'none';
+};

package/dist/extensions/hooks/registry/match-subject.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=match-subject.js.map

package/dist/extensions/hooks/registry/match-subject.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"match-subject.js","sourceRoot":"","sources":["../../../../src/extensions/hooks/registry/match-subject.ts"],"names":[],"mappings":""}

package/dist/extensions/hooks/registry/matcher.d.ts

@@ -0,0 +1,4 @@
+export interface ToolMatcher {
+    matches(candidates: readonly string[]): boolean;
+}
+export declare function compileMatcher(pattern: string | undefined): ToolMatcher;

package/dist/extensions/hooks/registry/matcher.js

@@ -0,0 +1,35 @@
+// Portions adapted from pi-code (MIT, github.com/ilovepixelart/pi-code), extensions/hooks/matcher.ts.
+import { foldMcpName } from '../../../kernel/vocabulary/claude-tool-names.js';
+const EXACT_NAMES = /^[\w\- ,|]*$/;
+const NAME_SEPARATOR = /[|,]/;
+const MATCH_EVERYTHING = new Set(['', '*']);
+const MCP_PREFIX = 'mcp__';
+const EVERY_CALL = { matches: () => true };
+const compiledMatchers = new Map();
+export function compileMatcher(pattern) {
+    if (pattern === undefined || MATCH_EVERYTHING.has(pattern)) {
+        return EVERY_CALL;
+    }
+    const compiled = compiledMatchers.get(pattern) ?? (EXACT_NAMES.test(pattern) ? exactNames(pattern) : regularExpression(pattern));
+    compiledMatchers.set(pattern, compiled);
+    return compiled;
+}
+function exactNames(pattern) {
+    const names = new Set(pattern
+        .split(NAME_SEPARATOR)
+        .map((name) => name.trim())
+        .filter((name) => name !== '')
+        .flatMap(spellingsOf));
+    return { matches: (candidates) => candidates.some((candidate) => names.has(candidate)) };
+}
+const spellingsOf = (name) => (name.startsWith(MCP_PREFIX) ? [name, foldMcpName(name)] : [name]);
+function regularExpression(pattern) {
+    try {
+        const expression = new RegExp(pattern);
+        return { matches: (candidates) => candidates.some((candidate) => expression.test(candidate)) };
+    }
+    catch {
+        return { matches: (candidates) => candidates.includes(pattern) };
+    }
+}
+//# sourceMappingURL=matcher.js.map

package/dist/extensions/hooks/registry/matcher.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"matcher.js","sourceRoot":"","sources":["../../../../src/extensions/hooks/registry/matcher.ts"],"names":[],"mappings":"AAAA,sGAAsG;AACtG,OAAO,EAAE,WAAW,EAAE,MAAM,iDAAiD,CAAC;AAM9E,MAAM,WAAW,GAAG,cAAc,CAAC;AACnC,MAAM,cAAc,GAAG,MAAM,CAAC;AAC9B,MAAM,gBAAgB,GAAG,IAAI,GAAG,CAAC,CAAC,EAAE,EAAE,GAAG,CAAC,CAAC,CAAC;AAC5C,MAAM,UAAU,GAAG,OAAO,CAAC;AAC3B,MAAM,UAAU,GAAgB,EAAE,OAAO,EAAE,GAAG,EAAE,CAAC,IAAI,EAAE,CAAC;AAExD,MAAM,gBAAgB,GAAG,IAAI,GAAG,EAAuB,CAAC;AAExD,MAAM,UAAU,cAAc,CAAC,OAA2B;IACxD,IAAI,OAAO,KAAK,SAAS,IAAI,gBAAgB,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC;QAC3D,OAAO,UAAU,CAAC;IACpB,CAAC;IACD,MAAM,QAAQ,GAAG,gBAAgB,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,iBAAiB,CAAC,OAAO,CAAC,CAAC,CAAC;IACjI,gBAAgB,CAAC,GAAG,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;IACxC,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,SAAS,UAAU,CAAC,OAAe;IACjC,MAAM,KAAK,GAAG,IAAI,GAAG,CACnB,OAAO;SACJ,KAAK,CAAC,cAAc,CAAC;SACrB,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;SAC1B,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,KAAK,EAAE,CAAC;SAC7B,OAAO,CAAC,WAAW,CAAC,CACxB,CAAC;IACF,OAAO,EAAE,OAAO,EAAE,CAAC,UAAU,EAAE,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC;AAC3F,CAAC;AAED,MAAM,WAAW,GAAG,CAAC,IAAY,EAAY,EAAE,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;AAEnH,SAAS,iBAAiB,CAAC,OAAe;IACxC,IAAI,CAAC;QACH,MAAM,UAAU,GAAG,IAAI,MAAM,CAAC,OAAO,CAAC,CAAC;QACvC,OAAO,EAAE,OAAO,EAAE,CAAC,UAAU,EAAE,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC;IACjG,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,OAAO,EAAE,CAAC,UAAU,EAAE,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;IACnE,CAAC;AACH,CAAC"}