@anthara/pi-claude 0.0.0-stage → 0.1.0

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

@@ -0,0 +1,3 @@
+import type { HookSource, ParsedHooks } from './hook-handler.js';
+export declare function parseHookMap(eventMap: unknown, source: HookSource): ParsedHooks;
+export declare function mergeParsed(parts: readonly ParsedHooks[]): ParsedHooks;

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

@@ -0,0 +1,124 @@
+// Portions adapted from pi-code (MIT, github.com/ilovepixelart/pi-code), extensions/hooks/config.ts and extensions/hooks/matcher.ts.
+import { isJsonObject } from '../../../kernel/private-files/private-files.js';
+const NO_HOOKS = { groups: [], skipped: [] };
+const COMMAND_TYPE = 'command';
+const HTTP_SCHEME = /^https?:$/;
+const UNSUPPORTED_HANDLER_TYPES = {
+    mcp_tool: 'mcp_tool hooks are not supported: pi gives a hook no way to call a tool on an MCP server it connects',
+};
+export function parseHookMap(eventMap, source) {
+    const events = isJsonObject(eventMap) ? Object.entries(eventMap) : [];
+    return mergeParsed(events.map(([event, groups]) => parseEvent(event, groups, source)));
+}
+function parseEvent(event, groups, source) {
+    if (!Array.isArray(groups)) {
+        return skippedOnly({ event, source, group: 0, index: 0 }, 'an event must list its matcher groups');
+    }
+    return mergeParsed(groups.map((group, index) => parseGroup(group, { event, source, group: index, index: 0 })));
+}
+function parseGroup(group, at) {
+    if (!isJsonObject(group)) {
+        return skippedOnly(at, 'a matcher group must be an object');
+    }
+    if (group.matcher !== undefined && typeof group.matcher !== 'string') {
+        return skippedOnly(at, 'a matcher must be a string');
+    }
+    const entries = Array.isArray(group.hooks) ? group.hooks : [];
+    const reads = entries.map((entry, index) => readHandler(entry, { ...at, index }));
+    const handlers = reads.flatMap((read) => (read.kind === 'handler' ? [read.handler] : []));
+    const skipped = reads.flatMap((read) => (read.kind === 'skipped' ? [skippedAt(at, read.reason)] : []));
+    const parsedGroup = { event: at.event, matcher: group.matcher, handlers };
+    return { groups: [parsedGroup], skipped };
+}
+function readHandler(entry, at) {
+    if (!isJsonObject(entry)) {
+        return skip('a hook entry must be an object');
+    }
+    const type = typeOf(entry);
+    const reader = HANDLER_READERS.get(type);
+    return reader === undefined ? skip(UNSUPPORTED_HANDLER_TYPES[type] ?? `the hook type ${type} is unknown`) : reader(entry, baseOf(entry, at));
+}
+function typeOf({ type }) {
+    if (type === undefined) {
+        return COMMAND_TYPE;
+    }
+    return typeof type === 'string' ? type : JSON.stringify(type);
+}
+function baseOf(entry, at) {
+    return {
+        source: at.source,
+        identity: JSON.stringify(entry),
+        timeoutSeconds: typeof entry.timeout === 'number' && entry.timeout > 0 ? entry.timeout : undefined,
+        ifRule: typeof entry.if === 'string' ? entry.if : undefined,
+        blocksOnFailure: entry.onFailure === 'block',
+        onceKey: onceKeyOf(entry, at),
+    };
+}
+function onceKeyOf(entry, { event, source, group, index }) {
+    return source.kind === 'scoped' && entry.once === true ? `${source.name}:${event}:${String(group)}:${String(index)}` : undefined;
+}
+function readCommand(entry, base) {
+    const problem = commandProblemOf(entry);
+    if (problem !== undefined) {
+        return skip(problem);
+    }
+    const command = String(entry.command);
+    const args = isStringList(entry.args) ? entry.args : undefined;
+    const label = args === undefined ? command : [command, ...args].join(' ');
+    return { kind: 'handler', handler: { ...base, type: 'command', command, args, background: backgroundOf(entry), label } };
+}
+function commandProblemOf({ command, args }) {
+    if (typeof command !== 'string' || command.trim() === '') {
+        return 'a command hook needs a command';
+    }
+    return args === undefined || isStringList(args) ? undefined : 'the args of a command hook must be a list of strings';
+}
+function backgroundOf(entry) {
+    if (entry.asyncRewake === true) {
+        return 'rewake';
+    }
+    return entry.async === true ? 'async' : 'none';
+}
+function readHttp(entry, base) {
+    const url = typeof entry.url === 'string' ? entry.url : '';
+    const parsed = parsedUrl(url);
+    if (parsed === undefined || !HTTP_SCHEME.test(parsed.protocol)) {
+        return skip('an http hook needs an http or https url');
+    }
+    return { kind: 'handler', handler: { ...base, type: 'http', url, ...requestPartsOf(entry), label: `${parsed.origin}${parsed.pathname}` } };
+}
+function requestPartsOf({ headers, allowedEnvVars }) {
+    return { headers: isJsonObject(headers) ? stringEntries(headers) : {}, allowedEnvVars: isStringList(allowedEnvVars) ? allowedEnvVars : [] };
+}
+const readPrompt = (entry, base) => readModelHandler(entry, base, 'prompt', 'a prompt hook needs a prompt');
+const readAgent = (entry, base) => readModelHandler(entry, base, 'agent', 'an agent hook needs a prompt');
+function readModelHandler(entry, base, type, missingPrompt) {
+    if (typeof entry.prompt !== 'string' || entry.prompt.trim() === '') {
+        return skip(missingPrompt);
+    }
+    const model = typeof entry.model === 'string' ? entry.model : undefined;
+    return { kind: 'handler', handler: { ...base, type, prompt: entry.prompt, model, label: entry.prompt } };
+}
+const HANDLER_READERS = new Map([
+    [COMMAND_TYPE, readCommand],
+    ['http', readHttp],
+    ['prompt', readPrompt],
+    ['agent', readAgent],
+]);
+function parsedUrl(text) {
+    try {
+        return new URL(text);
+    }
+    catch {
+        return undefined;
+    }
+}
+const isStringList = (value) => Array.isArray(value) && value.every((item) => typeof item === 'string');
+const stringEntries = (record) => Object.fromEntries(Object.entries(record).filter((entry) => typeof entry[1] === 'string'));
+const skip = (reason) => ({ kind: 'skipped', reason });
+const skippedAt = ({ event, source }, reason) => ({ event, source, reason });
+const skippedOnly = (at, reason) => ({ groups: [], skipped: [skippedAt(at, reason)] });
+export function mergeParsed(parts) {
+    return parts.reduce((merged, part) => ({ groups: [...merged.groups, ...part.groups], skipped: [...merged.skipped, ...part.skipped] }), NO_HOOKS);
+}
+//# sourceMappingURL=parse-hooks.js.map

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

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

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

@@ -0,0 +1,2 @@
+import type { PathAnchors } from './match-subject.js';
+export declare function matchesPathRule(filePath: string, pattern: string, anchors: PathAnchors): boolean;

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

@@ -0,0 +1,19 @@
+import { join, matchesGlob } from 'node:path';
+const ANCHORS = [
+    { prefix: '//', base: () => '/' },
+    { prefix: '~/', base: ({ home }) => home },
+    { prefix: '/', base: ({ projectRoot }) => projectRoot },
+    { prefix: './', base: ({ cwd }) => cwd },
+];
+const ANY_DEPTH = '/**';
+export function matchesPathRule(filePath, pattern, anchors) {
+    return matchesGlob(filePath, anchoredPattern(pattern, anchors));
+}
+function anchoredPattern(pattern, anchors) {
+    const anchor = ANCHORS.find(({ prefix }) => pattern.startsWith(prefix));
+    if (anchor !== undefined) {
+        return join(anchor.base(anchors), pattern.slice(anchor.prefix.length));
+    }
+    return pattern.includes('/') ? join(anchors.cwd, pattern) : join(ANY_DEPTH, pattern);
+}
+//# sourceMappingURL=path-rule.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"path-rule.js","sourceRoot":"","sources":["../../../../src/extensions/hooks/registry/path-rule.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAQ9C,MAAM,OAAO,GAAsB;IACjC,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC,GAAG,EAAE;IACjC,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,IAAI,EAAE;IAC1C,EAAE,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC,EAAE,WAAW,EAAE,EAAE,EAAE,CAAC,WAAW,EAAE;IACvD,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,EAAE,GAAG,EAAE,EAAE,EAAE,CAAC,GAAG,EAAE;CACzC,CAAC;AAEF,MAAM,SAAS,GAAG,KAAK,CAAC;AAExB,MAAM,UAAU,eAAe,CAAC,QAAgB,EAAE,OAAe,EAAE,OAAoB;IACrF,OAAO,WAAW,CAAC,QAAQ,EAAE,eAAe,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC;AAClE,CAAC;AAED,SAAS,eAAe,CAAC,OAAe,EAAE,OAAoB;IAC5D,MAAM,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,OAAO,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC;IACxE,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;QACzB,OAAO,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC;IACzE,CAAC;IACD,OAAO,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;AACvF,CAAC"}

package/dist/extensions/hooks/registry/unsupported-notices.d.ts

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

package/dist/extensions/hooks/registry/unsupported-notices.js

@@ -0,0 +1,9 @@
+import { isUnsupportedHookEvent, UNSUPPORTED_HOOK_EVENTS } from '../unsupported-events.js';
+import { describeSource } from './hook-handler.js';
+const whereOf = (source) => (source.kind === 'plugin' ? `plugin ${source.plugin}` : describeSource(source));
+const noticeFor = (event, source) => `${event} hook in ${whereOf(source)} is not run: ${UNSUPPORTED_HOOK_EVENTS[event]}`;
+export function unsupportedNotices(groups) {
+    const notices = groups.flatMap(({ event, handlers }) => (isUnsupportedHookEvent(event) ? handlers.map(({ source }) => noticeFor(event, source)) : []));
+    return [...new Set(notices)];
+}
+//# sourceMappingURL=unsupported-notices.js.map

package/dist/extensions/hooks/registry/unsupported-notices.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"unsupported-notices.js","sourceRoot":"","sources":["../../../../src/extensions/hooks/registry/unsupported-notices.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,uBAAuB,EAA6B,MAAM,0BAA0B,CAAC;AACtH,OAAO,EAAE,cAAc,EAAmC,MAAM,mBAAmB,CAAC;AAEpF,MAAM,OAAO,GAAG,CAAC,MAAkB,EAAU,EAAE,CAAC,CAAC,MAAM,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,UAAU,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC,CAAC;AAEhI,MAAM,SAAS,GAAG,CAAC,KAA2B,EAAE,MAAkB,EAAU,EAAE,CAAC,GAAG,KAAK,YAAY,OAAO,CAAC,MAAM,CAAC,gBAAgB,uBAAuB,CAAC,KAAK,CAAC,EAAE,CAAC;AAEnK,MAAM,UAAU,kBAAkB,CAAC,MAA4B;IAC7D,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC,EAAE,KAAK,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC,CAAC,sBAAsB,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,SAAS,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IACvJ,OAAO,CAAC,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC;AAC/B,CAAC"}

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

@@ -0,0 +1 @@
+export declare const wholeTextWildcard: (pattern: string) => RegExp;

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

@@ -0,0 +1,3 @@
+const REGULAR_EXPRESSION_CHARACTER = /[.*+?^${}()|[\]\\]/g;
+export const wholeTextWildcard = (pattern) => new RegExp(`^${pattern.split('*').map((part) => part.replace(REGULAR_EXPRESSION_CHARACTER, '\\$&')).join('[^]*')}$`);
+//# sourceMappingURL=wildcard.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"wildcard.js","sourceRoot":"","sources":["../../../../src/extensions/hooks/registry/wildcard.ts"],"names":[],"mappings":"AAAA,MAAM,4BAA4B,GAAG,qBAAqB,CAAC;AAE3D,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,OAAe,EAAU,EAAE,CAC3D,IAAI,MAAM,CAAC,IAAI,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,4BAA4B,EAAE,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC"}

package/dist/extensions/hooks/runners/agent-runner.d.ts

@@ -0,0 +1,3 @@
+import type { AgentHandler } from '../registry/hook-handler.js';
+import type { HookHandlerRunner } from './hook-runner.js';
+export declare const agentRunner: HookHandlerRunner<AgentHandler>;

package/dist/extensions/hooks/runners/agent-runner.js

@@ -0,0 +1,26 @@
+import { promptWith } from './prompt-template.js';
+const AGENT_HOOK_NAME = 'hook';
+const AGENT_HOOK_SYSTEM_PROMPT = [
+    'You are a Claude Code hook verifying whether an action should proceed. You may read files to check, but you cannot change anything.',
+    'When you are done, answer with ONLY a JSON object and nothing else:',
+    '{"ok": true} to let it proceed, or {"ok": false, "reason": "<short reason>"} to stop it.',
+].join('\n');
+export const agentRunner = {
+    run: async (handler, payload, context) => {
+        const signal = context.timeoutMs === undefined ? new AbortController().signal : AbortSignal.timeout(context.timeoutMs);
+        const question = { name: AGENT_HOOK_NAME, systemPrompt: AGENT_HOOK_SYSTEM_PROMPT, prompt: promptWith(handler.prompt, payload), ...(handler.model === undefined ? {} : { model: handler.model }) };
+        try {
+            return { kind: 'exited', exitCode: 0, stdout: await context.agents.ask(question, signal), stderr: '' };
+        }
+        catch (error) {
+            return failureOf(signal, context.timeoutMs, error);
+        }
+    },
+};
+function failureOf(signal, timeoutMs, error) {
+    if (signal.aborted && timeoutMs !== undefined) {
+        return { kind: 'timed-out', afterMs: timeoutMs };
+    }
+    return { kind: 'failed', reason: error instanceof Error ? error.message : String(error) };
+}
+//# sourceMappingURL=agent-runner.js.map

package/dist/extensions/hooks/runners/agent-runner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-runner.js","sourceRoot":"","sources":["../../../../src/extensions/hooks/runners/agent-runner.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAElD,MAAM,eAAe,GAAG,MAAM,CAAC;AAC/B,MAAM,wBAAwB,GAAG;IAC/B,qIAAqI;IACrI,qEAAqE;IACrE,0FAA0F;CAC3F,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAEb,MAAM,CAAC,MAAM,WAAW,GAAoC;IAC1D,GAAG,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,EAAE;QACvC,MAAM,MAAM,GAAG,OAAO,CAAC,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,eAAe,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,WAAW,CAAC,OAAO,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;QACvH,MAAM,QAAQ,GAAG,EAAE,IAAI,EAAE,eAAe,EAAE,YAAY,EAAE,wBAAwB,EAAE,MAAM,EAAE,UAAU,CAAC,OAAO,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,CAAC,OAAO,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,CAAC,EAAE,CAAC;QAClM,IAAI,CAAC;YACH,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,CAAC,EAAE,MAAM,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,QAAQ,EAAE,MAAM,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;QACzG,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,SAAS,CAAC,MAAM,EAAE,OAAO,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;QACrD,CAAC;IACH,CAAC;CACF,CAAC;AAEF,SAAS,SAAS,CAAC,MAAmB,EAAE,SAA6B,EAAE,KAAc;IACnF,IAAI,MAAM,CAAC,OAAO,IAAI,SAAS,KAAK,SAAS,EAAE,CAAC;QAC9C,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC;IACnD,CAAC;IACD,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;AAC5F,CAAC"}

package/dist/extensions/hooks/runners/background-hooks.d.ts

@@ -0,0 +1,10 @@
+import type { ExtensionAPI } from '@earendil-works/pi-coding-agent';
+import type { JsonObject } from '../../../kernel/private-files/private-files.js';
+import type { CommandHandler } from '../registry/hook-handler.js';
+import type { RunContext } from './hook-runner.js';
+export declare class BackgroundHooks {
+    #private;
+    constructor(pi: Pick<ExtensionAPI, 'sendMessage'>);
+    start(handler: CommandHandler, payload: JsonObject, context: RunContext): void;
+    stopAll(): void;
+}

package/dist/extensions/hooks/runners/background-hooks.js

@@ -0,0 +1,56 @@
+import { parseHookOutput } from '../decisions/parse-output.js';
+import { runHandler } from './runners-by-type.js';
+const ASYNC_HOOK_MESSAGE = 'claude-async-hook';
+const WAKE_EXIT_CODE = 2;
+export class BackgroundHooks {
+    #pi;
+    #running = new Set();
+    constructor(pi) {
+        this.#pi = pi;
+    }
+    start(handler, payload, context) {
+        const stops = [];
+        const tracked = {
+            ...context,
+            onStarted: (stop) => {
+                stops.push(stop);
+                this.#running.add(stop);
+            },
+        };
+        void runHandler(handler, payload, tracked)
+            .then((run) => {
+            this.#deliver(handler, run);
+        })
+            .catch(() => undefined)
+            .finally(() => {
+            stops.forEach((stop) => this.#running.delete(stop));
+        });
+    }
+    stopAll() {
+        this.#running.forEach((stop) => {
+            stop();
+        });
+        this.#running.clear();
+    }
+    #deliver(handler, run) {
+        if (run.kind !== 'exited') {
+            return;
+        }
+        if (asksForAttention(handler, run.exitCode)) {
+            this.#pi.sendMessage({ customType: ASYNC_HOOK_MESSAGE, content: `A background hook asked for attention:\n${run.stderr.trim() || run.stdout.trim()}`, display: true }, { triggerTurn: true });
+            return;
+        }
+        const parts = laterParts(parseHookOutput(run.exitCode, run.stdout, run.stderr));
+        if (parts.length > 0) {
+            this.#pi.sendMessage({ customType: ASYNC_HOOK_MESSAGE, content: parts.join('\n'), display: false }, { deliverAs: 'nextTurn' });
+        }
+    }
+}
+const asksForAttention = ({ background }, exitCode) => background === 'rewake' && exitCode === WAKE_EXIT_CODE;
+function laterParts(outcome) {
+    if (outcome.kind !== 'answered') {
+        return [];
+    }
+    return [outcome.answer.systemMessage, outcome.answer.context].filter((part) => part !== undefined && part !== '');
+}
+//# sourceMappingURL=background-hooks.js.map

package/dist/extensions/hooks/runners/background-hooks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"background-hooks.js","sourceRoot":"","sources":["../../../../src/extensions/hooks/runners/background-hooks.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAG/D,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAElD,MAAM,kBAAkB,GAAG,mBAAmB,CAAC;AAC/C,MAAM,cAAc,GAAG,CAAC,CAAC;AAEzB,MAAM,OAAO,eAAe;IACjB,GAAG,CAAoC;IACvC,QAAQ,GAAG,IAAI,GAAG,EAAc,CAAC;IAE1C,YAAY,EAAqC;QAC/C,IAAI,CAAC,GAAG,GAAG,EAAE,CAAC;IAChB,CAAC;IAED,KAAK,CAAC,OAAuB,EAAE,OAAmB,EAAE,OAAmB;QACrE,MAAM,KAAK,GAAmB,EAAE,CAAC;QACjC,MAAM,OAAO,GAAe;YAC1B,GAAG,OAAO;YACV,SAAS,EAAE,CAAC,IAAI,EAAE,EAAE;gBAClB,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;gBACjB,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YAC1B,CAAC;SACF,CAAC;QACF,KAAK,UAAU,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC;aACvC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE;YACZ,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;QAC9B,CAAC,CAAC;aACD,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC;aACtB,OAAO,CAAC,GAAG,EAAE;YACZ,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC;QACtD,CAAC,CAAC,CAAC;IACP,CAAC;IAED,OAAO;QACL,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE;YAC7B,IAAI,EAAE,CAAC;QACT,CAAC,CAAC,CAAC;QACH,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC;IACxB,CAAC;IAED,QAAQ,CAAC,OAAuB,EAAE,GAAY;QAC5C,IAAI,GAAG,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YAC1B,OAAO;QACT,CAAC;QACD,IAAI,gBAAgB,CAAC,OAAO,EAAE,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC5C,IAAI,CAAC,GAAG,CAAC,WAAW,CAAC,EAAE,UAAU,EAAE,kBAAkB,EAAE,OAAO,EAAE,2CAA2C,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,EAAE,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC,CAAC;YAC7L,OAAO;QACT,CAAC;QACD,MAAM,KAAK,GAAG,UAAU,CAAC,eAAe,CAAC,GAAG,CAAC,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC;QAChF,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACrB,IAAI,CAAC,GAAG,CAAC,WAAW,CAAC,EAAE,UAAU,EAAE,kBAAkB,EAAE,OAAO,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,EAAE,SAAS,EAAE,UAAU,EAAE,CAAC,CAAC;QACjI,CAAC;IACH,CAAC;CACF;AAED,MAAM,gBAAgB,GAAG,CAAC,EAAE,UAAU,EAAkB,EAAE,QAAgB,EAAW,EAAE,CAAC,UAAU,KAAK,QAAQ,IAAI,QAAQ,KAAK,cAAc,CAAC;AAE/I,SAAS,UAAU,CAAC,OAA2C;IAC7D,IAAI,OAAO,CAAC,IAAI,KAAK,UAAU,EAAE,CAAC;QAChC,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,aAAa,EAAE,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,EAAkB,EAAE,CAAC,IAAI,KAAK,SAAS,IAAI,IAAI,KAAK,EAAE,CAAC,CAAC;AACpI,CAAC"}

package/dist/extensions/hooks/runners/command-runner.d.ts

@@ -0,0 +1,5 @@
+import type { UserConfigResolver } from '../../../kernel/plugin-config/user-config-resolver.js';
+import type { CommandHandler } from '../registry/hook-handler.js';
+import type { HookHandlerRunner } from './hook-runner.js';
+export declare const createCommandRunner: (userConfig: () => UserConfigResolver) => HookHandlerRunner<CommandHandler>;
+export declare const commandRunner: HookHandlerRunner<CommandHandler>;

package/dist/extensions/hooks/runners/command-runner.js

@@ -0,0 +1,126 @@
+// Portions adapted from pi-code (MIT, github.com/ilovepixelart/pi-code), extensions/hooks/runners.ts and extensions/internal/process-tree.ts.
+import { spawn } from 'node:child_process';
+import { referencesUserConfig } from '../../../kernel/plugin-config/shell-reference-check.js';
+import { sessionUserConfigResolver } from '../../../kernel/plugin-config/session-resolver.js';
+import { ShellHookReferencesUserConfigError } from './errors.js';
+import { hookProcessEnvironment, hookVariables, optionVariables, withPlaceholders, withUserConfig } from './hook-process-environment.js';
+const SHELL = '/bin/sh';
+const SHELL_COMMAND_FLAG = '-c';
+const OUTPUT_LIMIT = 1_000_000;
+const KILL_SIGNAL = 'SIGKILL';
+export const createCommandRunner = (userConfig) => ({
+    run: (handler, payload, context) => new Promise((settle) => {
+        startHook({ handler, payload, context, userConfig: userConfig(), settle });
+    }),
+});
+export const commandRunner = createCommandRunner(sessionUserConfigResolver);
+function startHook({ handler, payload, context, userConfig, settle }) {
+    const spawned = spawnHook(handler, context, userConfig);
+    if (spawned.kind === 'not-started') {
+        settle(spawned);
+        return;
+    }
+    new RunningHook(spawned.child, context, settle).feed(JSON.stringify(payload));
+}
+function spawnHook(handler, context, userConfig) {
+    const variables = { ...hookVariables(handler.source, context.environment), ...optionVariables(handler.source, userConfig) };
+    const target = spawnTarget(handler, variables, userConfig);
+    try {
+        const child = spawn(target.file, target.args, { cwd: context.environment.cwd, env: hookProcessEnvironment(variables), stdio: 'pipe', detached: true });
+        return { kind: 'started', child };
+    }
+    catch (error) {
+        return { kind: 'not-started', reason: error instanceof Error ? error.message : String(error) };
+    }
+}
+function spawnTarget(handler, variables, userConfig) {
+    const { command, args } = handler;
+    if (args === undefined) {
+        return shellTarget(handler);
+    }
+    const fill = (text) => withUserConfig(withPlaceholders(text, variables), handler.source, userConfig);
+    return { file: fill(command), args: args.map(fill) };
+}
+function shellTarget({ command, label }) {
+    if (referencesUserConfig(command)) {
+        throw new ShellHookReferencesUserConfigError(label);
+    }
+    return { file: SHELL, args: [SHELL_COMMAND_FLAG, command] };
+}
+class RunningHook {
+    #child;
+    #settle;
+    #timer;
+    #stdout = '';
+    #stderr = '';
+    #settled = false;
+    constructor(child, context, settle) {
+        this.#child = child;
+        this.#settle = settle;
+        this.#timer = this.#deadline(context.timeoutMs);
+        context.onStarted(() => {
+            this.#kill();
+        });
+        this.#collectOutput();
+        child.on('close', (code, signal) => {
+            this.#finish(this.#exitRun(code, signal));
+        });
+        child.on('error', (error) => {
+            this.#finish({ kind: 'not-started', reason: error.message });
+        });
+    }
+    feed(payload) {
+        this.#child.stdin?.on('error', () => undefined);
+        this.#child.stdin?.end(payload);
+    }
+    #exitRun(code, signal) {
+        if (code === null) {
+            return { kind: 'failed', reason: `the hook was stopped by ${String(signal)}` };
+        }
+        return { kind: 'exited', exitCode: code, stdout: this.#stdout, stderr: this.#stderr };
+    }
+    #deadline(timeoutMs) {
+        if (timeoutMs === undefined) {
+            return undefined;
+        }
+        return setTimeout(() => {
+            this.#kill();
+            this.#finish({ kind: 'timed-out', afterMs: timeoutMs });
+        }, timeoutMs);
+    }
+    #collectOutput() {
+        this.#child.stdout?.setEncoding('utf8');
+        this.#child.stderr?.setEncoding('utf8');
+        this.#child.stdout?.on('data', (chunk) => {
+            this.#stdout = withinLimit(this.#stdout, chunk);
+        });
+        this.#child.stderr?.on('data', (chunk) => {
+            this.#stderr = withinLimit(this.#stderr, chunk);
+        });
+    }
+    #finish(run) {
+        if (this.#settled) {
+            return;
+        }
+        this.#settled = true;
+        clearTimeout(this.#timer);
+        this.#settle(run);
+    }
+    #kill() {
+        killProcessGroup(this.#child);
+    }
+}
+const withinLimit = (collected, chunk) => (collected.length < OUTPUT_LIMIT ? collected + chunk : collected);
+function killProcessGroup(child) {
+    if (child.pid === undefined) {
+        child.kill(KILL_SIGNAL);
+        return;
+    }
+    try {
+        process.kill(-child.pid, KILL_SIGNAL);
+    }
+    catch {
+        child.kill(KILL_SIGNAL);
+    }
+}
+//# sourceMappingURL=command-runner.js.map

package/dist/extensions/hooks/runners/command-runner.js.map

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

package/dist/extensions/hooks/runners/errors.d.ts

@@ -0,0 +1,10 @@
+import { AntharaError } from '../../../errors/anthara-error.js';
+export declare class ShellHookReferencesUserConfigError extends AntharaError {
+    constructor(hookLabel: string);
+}
+export declare class NoSubAgentAvailableError extends AntharaError {
+    constructor();
+}
+export declare class AgentHookRunFailedError extends AntharaError {
+    constructor(reason: string);
+}

package/dist/extensions/hooks/runners/errors.js

@@ -0,0 +1,18 @@
+import { AntharaError } from '../../../errors/anthara-error.js';
+export class ShellHookReferencesUserConfigError extends AntharaError {
+    constructor(hookLabel) {
+        super(`The hook "${hookLabel}" runs through a shell and references \${user_config.*}, which is refused ` +
+            'because a configured value could change what the shell runs. Use the exec form with "args", or read CLAUDE_PLUGIN_OPTION_<KEY> from the hook\'s environment.');
+    }
+}
+export class NoSubAgentAvailableError extends AntharaError {
+    constructor() {
+        super('no sub-agent is available to run an agent hook');
+    }
+}
+export class AgentHookRunFailedError extends AntharaError {
+    constructor(reason) {
+        super(`The agent hook's sub-agent run failed: ${reason}`);
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/extensions/hooks/runners/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../../../src/extensions/hooks/runners/errors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,kCAAkC,CAAC;AAEhE,MAAM,OAAO,kCAAmC,SAAQ,YAAY;IAClE,YAAY,SAAiB;QAC3B,KAAK,CACH,aAAa,SAAS,4EAA4E;YAChG,8JAA8J,CACjK,CAAC;IACJ,CAAC;CACF;AAED,MAAM,OAAO,wBAAyB,SAAQ,YAAY;IACxD;QACE,KAAK,CAAC,gDAAgD,CAAC,CAAC;IAC1D,CAAC;CACF;AAED,MAAM,OAAO,uBAAwB,SAAQ,YAAY;IACvD,YAAY,MAAc;QACxB,KAAK,CAAC,0CAA0C,MAAM,EAAE,CAAC,CAAC;IAC5D,CAAC;CACF"}

package/dist/extensions/hooks/runners/hook-process-environment.d.ts

@@ -0,0 +1,8 @@
+import type { UserConfigResolver } from '../../../kernel/plugin-config/user-config-resolver.js';
+import type { HookSource } from '../registry/hook-handler.js';
+import type { HookEnvironment } from './hook-runner.js';
+export declare function hookVariables(source: HookSource, { projectDir }: HookEnvironment): Readonly<Record<string, string>>;
+export declare function hookProcessEnvironment(variables: Readonly<Record<string, string>>): NodeJS.ProcessEnv;
+export declare const withPlaceholders: (text: string, variables: Readonly<Record<string, string>>) => string;
+export declare function optionVariables(source: HookSource, userConfig: UserConfigResolver): Readonly<Record<string, string>>;
+export declare const withUserConfig: (text: string, source: HookSource, userConfig: UserConfigResolver) => string;

package/dist/extensions/hooks/runners/hook-process-environment.js

@@ -0,0 +1,20 @@
+const PROJECT_DIR_VAR = 'CLAUDE_PROJECT_DIR';
+const PLUGIN_ROOT_VAR = 'CLAUDE_PLUGIN_ROOT';
+const PLUGIN_DATA_VAR = 'CLAUDE_PLUGIN_DATA';
+const PLUGIN_VARIABLES = new Set([PLUGIN_ROOT_VAR, PLUGIN_DATA_VAR]);
+const OPTION_VARIABLE_PREFIX = 'CLAUDE_PLUGIN_OPTION_';
+const PLACEHOLDER = /\$\{(CLAUDE_PROJECT_DIR|CLAUDE_PLUGIN_ROOT|CLAUDE_PLUGIN_DATA)\}/g;
+export function hookVariables(source, { projectDir }) {
+    const plugin = source.kind === 'plugin' ? { [PLUGIN_ROOT_VAR]: source.root, [PLUGIN_DATA_VAR]: source.dataDir } : {};
+    return { CLAUDECODE: '1', [PROJECT_DIR_VAR]: projectDir, ...plugin };
+}
+export function hookProcessEnvironment(variables) {
+    const inherited = Object.entries(process.env).filter(([name]) => !PLUGIN_VARIABLES.has(name) && !name.startsWith(OPTION_VARIABLE_PREFIX));
+    return { ...Object.fromEntries(inherited), ...variables };
+}
+export const withPlaceholders = (text, variables) => text.replace(PLACEHOLDER, (placeholder, name) => variables[name] ?? placeholder);
+export function optionVariables(source, userConfig) {
+    return source.kind === 'plugin' ? userConfig.optionEnvironment({ name: source.plugin, root: source.root }) : {};
+}
+export const withUserConfig = (text, source, userConfig) => source.kind === 'plugin' ? userConfig.substitute(text, { name: source.plugin, root: source.root }, 'hook-args') : text;
+//# sourceMappingURL=hook-process-environment.js.map

package/dist/extensions/hooks/runners/hook-process-environment.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hook-process-environment.js","sourceRoot":"","sources":["../../../../src/extensions/hooks/runners/hook-process-environment.ts"],"names":[],"mappings":"AAIA,MAAM,eAAe,GAAG,oBAAoB,CAAC;AAC7C,MAAM,eAAe,GAAG,oBAAoB,CAAC;AAC7C,MAAM,eAAe,GAAG,oBAAoB,CAAC;AAC7C,MAAM,gBAAgB,GAAwB,IAAI,GAAG,CAAC,CAAC,eAAe,EAAE,eAAe,CAAC,CAAC,CAAC;AAC1F,MAAM,sBAAsB,GAAG,uBAAuB,CAAC;AACvD,MAAM,WAAW,GAAG,mEAAmE,CAAC;AAExF,MAAM,UAAU,aAAa,CAAC,MAAkB,EAAE,EAAE,UAAU,EAAmB;IAC/E,MAAM,MAAM,GAAG,MAAM,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,eAAe,CAAC,EAAE,MAAM,CAAC,IAAI,EAAE,CAAC,eAAe,CAAC,EAAE,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IACrH,OAAO,EAAE,UAAU,EAAE,GAAG,EAAE,CAAC,eAAe,CAAC,EAAE,UAAU,EAAE,GAAG,MAAM,EAAE,CAAC;AACvE,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,SAA2C;IAChF,MAAM,SAAS,GAAG,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC,gBAAgB,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,sBAAsB,CAAC,CAAC,CAAC;IAC1I,OAAO,EAAE,GAAG,MAAM,CAAC,WAAW,CAAC,SAAS,CAAC,EAAE,GAAG,SAAS,EAAE,CAAC;AAC5D,CAAC;AAED,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,IAAY,EAAE,SAA2C,EAAU,EAAE,CACpG,IAAI,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC,WAAW,EAAE,IAAY,EAAE,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,WAAW,CAAC,CAAC;AAE3F,MAAM,UAAU,eAAe,CAAC,MAAkB,EAAE,UAA8B;IAChF,OAAO,MAAM,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,UAAU,CAAC,iBAAiB,CAAC,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;AAClH,CAAC;AAED,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,IAAY,EAAE,MAAkB,EAAE,UAA8B,EAAU,EAAE,CACzG,MAAM,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,UAAU,CAAC,UAAU,CAAC,IAAI,EAAE,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC"}

package/dist/extensions/hooks/runners/hook-runner.d.ts

@@ -0,0 +1,47 @@
+import type { ReadOnlyAgentTask } from '../../../kernel/agent-runner/sub-agent-runner.js';
+import type { JsonObject } from '../../../kernel/private-files/private-files.js';
+import type { HookHandler } from '../registry/hook-handler.js';
+export interface HookEnvironment {
+    readonly cwd: string;
+    readonly projectDir: string;
+}
+export interface HookModel {
+    readonly id: string;
+}
+export interface ModelQuestion {
+    readonly systemPrompt: string;
+    readonly prompt: string;
+}
+export interface HookModels {
+    sessionModel(): HookModel | undefined;
+    find(modelId: string): HookModel | undefined;
+    ask(model: HookModel, question: ModelQuestion, signal: AbortSignal): Promise<string>;
+}
+export interface HookAgents {
+    ask(question: ReadOnlyAgentTask, signal: AbortSignal): Promise<string>;
+}
+export interface RunContext {
+    readonly timeoutMs: number | undefined;
+    readonly environment: HookEnvironment;
+    readonly models: HookModels;
+    readonly agents: HookAgents;
+    readonly onStarted: (stop: () => void) => void;
+}
+export type HookRun = {
+    readonly kind: 'exited';
+    readonly exitCode: number;
+    readonly stdout: string;
+    readonly stderr: string;
+} | {
+    readonly kind: 'failed';
+    readonly reason: string;
+} | {
+    readonly kind: 'timed-out';
+    readonly afterMs: number;
+} | {
+    readonly kind: 'not-started';
+    readonly reason: string;
+};
+export interface HookHandlerRunner<H extends HookHandler> {
+    run(handler: H, payload: JsonObject, context: RunContext): Promise<HookRun>;
+}

package/dist/extensions/hooks/runners/hook-runner.js

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

package/dist/extensions/hooks/runners/hook-runner.js.map

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

package/dist/extensions/hooks/runners/http-runner.d.ts

@@ -0,0 +1,3 @@
+import type { HttpHandler } from '../registry/hook-handler.js';
+import type { HookHandlerRunner } from './hook-runner.js';
+export declare const httpRunner: HookHandlerRunner<HttpHandler>;