@anthara/pi-claude 0.0.0-stage → 0.1.0

package/dist/extensions/hooks/bridges/tool-call-subject.d.ts

@@ -0,0 +1,10 @@
+import type { ExtensionContext } from '@earendil-works/pi-coding-agent';
+import type { JsonObject } from '../../../kernel/private-files/private-files.js';
+import type { MatchSubject } from '../registry/match-subject.js';
+import type { BridgeServices } from './event-bridge.js';
+type ToolContext = Pick<ExtensionContext, 'cwd' | 'sessionManager'>;
+export declare const isMcpTool: (piName: string) => boolean;
+export declare function claudeNameOf(piName: string, ctx: ToolContext): string;
+export declare function toolSubject(piName: string, input: unknown, ctx: ToolContext, services: BridgeServices): MatchSubject;
+export declare function toolFields(piName: string, input: unknown, toolCallId: string, ctx: ToolContext): JsonObject;
+export {};

package/dist/extensions/hooks/bridges/tool-call-subject.js

@@ -0,0 +1,18 @@
+import { homedir } from 'node:os';
+import { mcpNameRoster } from '../../../kernel/mcp-names/mcp-names.js';
+import { toClaudeToolName } from '../../../kernel/vocabulary/claude-tool-names.js';
+import { claudeToolInput } from './payload-translator.js';
+const MCP_TOOL_PREFIX = 'mcp__';
+export const isMcpTool = (piName) => piName.startsWith(MCP_TOOL_PREFIX);
+export function claudeNameOf(piName, ctx) {
+    return isMcpTool(piName) ? mcpNameRoster().claudeNameOf(ctx.sessionManager.getSessionId(), piName) : toClaudeToolName(piName);
+}
+export function toolSubject(piName, input, ctx, services) {
+    const names = [...new Set([claudeNameOf(piName, ctx), piName])];
+    const anchors = { cwd: ctx.cwd, projectRoot: services.projectDir, home: homedir() };
+    return { kind: 'tool', call: { names, claudeInput: claudeToolInput(piName, input, ctx.cwd), anchors } };
+}
+export function toolFields(piName, input, toolCallId, ctx) {
+    return { tool_name: claudeNameOf(piName, ctx), tool_input: claudeToolInput(piName, input, ctx.cwd), tool_use_id: toolCallId };
+}
+//# sourceMappingURL=tool-call-subject.js.map

package/dist/extensions/hooks/bridges/tool-call-subject.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-call-subject.js","sourceRoot":"","sources":["../../../../src/extensions/hooks/bridges/tool-call-subject.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAElC,OAAO,EAAE,aAAa,EAAE,MAAM,wCAAwC,CAAC;AAEvE,OAAO,EAAE,gBAAgB,EAAE,MAAM,iDAAiD,CAAC;AAGnF,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAE1D,MAAM,eAAe,GAAG,OAAO,CAAC;AAIhC,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,MAAc,EAAW,EAAE,CAAC,MAAM,CAAC,UAAU,CAAC,eAAe,CAAC,CAAC;AAEzF,MAAM,UAAU,YAAY,CAAC,MAAc,EAAE,GAAgB;IAC3D,OAAO,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,aAAa,EAAE,CAAC,YAAY,CAAC,GAAG,CAAC,cAAc,CAAC,YAAY,EAAE,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,gBAAgB,CAAC,MAAM,CAAC,CAAC;AAChI,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,MAAc,EAAE,KAAc,EAAE,GAAgB,EAAE,QAAwB;IACpG,MAAM,KAAK,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,CAAC,YAAY,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC;IAChE,MAAM,OAAO,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,GAAG,EAAE,WAAW,EAAE,QAAQ,CAAC,UAAU,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,CAAC;IACpF,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE,KAAK,EAAE,WAAW,EAAE,eAAe,CAAC,MAAM,EAAE,KAAK,EAAE,GAAG,CAAC,GAAG,CAAC,EAAE,OAAO,EAAE,EAAE,CAAC;AAC1G,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,MAAc,EAAE,KAAc,EAAE,UAAkB,EAAE,GAAgB;IAC7F,OAAO,EAAE,SAAS,EAAE,YAAY,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,UAAU,EAAE,eAAe,CAAC,MAAM,EAAE,KAAK,EAAE,GAAG,CAAC,GAAG,CAAC,EAAE,WAAW,EAAE,UAAU,EAAE,CAAC;AAChI,CAAC"}

package/dist/extensions/hooks/bridges/triggers.d.ts

@@ -0,0 +1,11 @@
+export declare const PI_EVENT_NAMES: readonly ["tool_call", "tool_result", "input", "session_start", "session_compact", "agent_end", "session_before_compact", "session_shutdown", "turn_end", "model_select"];
+export declare const BUS_CHANNELS: readonly ["anthara.pi-claude:instructions-loaded", "anthara.pi-claude:prompt-expanded", "anthara.pi-claude:worktree"];
+export declare const SUBAGENT_STARTING = "subagent-starting";
+export declare const SUBAGENT_STOPPED = "subagent-stopped";
+export declare const IDLE_PROMPT = "idle_prompt";
+export type PiEventName = (typeof PI_EVENT_NAMES)[number];
+export type BusChannel = (typeof BUS_CHANNELS)[number];
+export type HookTrigger = PiEventName | BusChannel | typeof SUBAGENT_STARTING | typeof SUBAGENT_STOPPED | typeof IDLE_PROMPT;
+export declare const isPiEvent: (trigger: HookTrigger) => trigger is PiEventName;
+export declare const isBusChannel: (trigger: HookTrigger) => trigger is BusChannel;
+export declare const isAnnouncement: (channel: BusChannel, data: unknown) => boolean;

package/dist/extensions/hooks/bridges/triggers.js

@@ -0,0 +1,30 @@
+import { INSTRUCTIONS_LOADED_CHANNEL, isInstructionLoad } from '../../../kernel/instruction-events/instruction-events.js';
+import { isPromptExpansion, PROMPT_EXPANDED_CHANNEL } from '../../../kernel/prompt-expansion-events/prompt-expansion-events.js';
+import { isWorktreeLifecycle, WORKTREE_CHANNEL } from '../../../kernel/worktree-events/worktree-events.js';
+export const PI_EVENT_NAMES = [
+    'tool_call',
+    'tool_result',
+    'input',
+    'session_start',
+    'session_compact',
+    'agent_end',
+    'session_before_compact',
+    'session_shutdown',
+    'turn_end',
+    'model_select',
+];
+export const BUS_CHANNELS = [INSTRUCTIONS_LOADED_CHANNEL, PROMPT_EXPANDED_CHANNEL, WORKTREE_CHANNEL];
+export const SUBAGENT_STARTING = 'subagent-starting';
+export const SUBAGENT_STOPPED = 'subagent-stopped';
+export const IDLE_PROMPT = 'idle_prompt';
+const piEventNames = PI_EVENT_NAMES;
+const busChannels = BUS_CHANNELS;
+export const isPiEvent = (trigger) => piEventNames.includes(trigger);
+export const isBusChannel = (trigger) => busChannels.includes(trigger);
+const ANNOUNCEMENT_GUARDS = {
+    [INSTRUCTIONS_LOADED_CHANNEL]: isInstructionLoad,
+    [PROMPT_EXPANDED_CHANNEL]: isPromptExpansion,
+    [WORKTREE_CHANNEL]: isWorktreeLifecycle,
+};
+export const isAnnouncement = (channel, data) => ANNOUNCEMENT_GUARDS[channel](data);
+//# sourceMappingURL=triggers.js.map

package/dist/extensions/hooks/bridges/triggers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"triggers.js","sourceRoot":"","sources":["../../../../src/extensions/hooks/bridges/triggers.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,2BAA2B,EAAE,iBAAiB,EAAE,MAAM,0DAA0D,CAAC;AAC1H,OAAO,EAAE,iBAAiB,EAAE,uBAAuB,EAAE,MAAM,oEAAoE,CAAC;AAChI,OAAO,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,MAAM,oDAAoD,CAAC;AAE3G,MAAM,CAAC,MAAM,cAAc,GAAG;IAC5B,WAAW;IACX,aAAa;IACb,OAAO;IACP,eAAe;IACf,iBAAiB;IACjB,WAAW;IACX,wBAAwB;IACxB,kBAAkB;IAClB,UAAU;IACV,cAAc;CACN,CAAC;AAEX,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,2BAA2B,EAAE,uBAAuB,EAAE,gBAAgB,CAAU,CAAC;AAE9G,MAAM,CAAC,MAAM,iBAAiB,GAAG,mBAAmB,CAAC;AACrD,MAAM,CAAC,MAAM,gBAAgB,GAAG,kBAAkB,CAAC;AACnD,MAAM,CAAC,MAAM,WAAW,GAAG,aAAa,CAAC;AAQzC,MAAM,YAAY,GAAsB,cAAc,CAAC;AACvD,MAAM,WAAW,GAAsB,YAAY,CAAC;AAEpD,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,OAAoB,EAA0B,EAAE,CAAC,YAAY,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;AAE1G,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,OAAoB,EAAyB,EAAE,CAAC,WAAW,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;AAE3G,MAAM,mBAAmB,GAA6D;IACpF,CAAC,2BAA2B,CAAC,EAAE,iBAAiB;IAChD,CAAC,uBAAuB,CAAC,EAAE,iBAAiB;IAC5C,CAAC,gBAAgB,CAAC,EAAE,mBAAmB;CACxC,CAAC;AAEF,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,OAAmB,EAAE,IAAa,EAAW,EAAE,CAAC,mBAAmB,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC"}

package/dist/extensions/hooks/decisions/combine.d.ts

@@ -0,0 +1,18 @@
+import type { JsonObject } from '../../../kernel/private-files/private-files.js';
+import { type HookOutcome, type Verdict } from './hook-outcome.js';
+export interface CombinePolicy {
+    readonly noVerdict: 'blocks' | 'proceeds';
+    readonly plainTextIsContext: boolean;
+}
+export interface CombinedDecision {
+    readonly verdict: Verdict;
+    readonly reason: string | undefined;
+    readonly denials: readonly string[];
+    readonly contexts: readonly string[];
+    readonly updatedInput: JsonObject | undefined;
+    readonly updatedToolOutput: unknown;
+    readonly stopReason: string | undefined;
+    readonly systemMessages: readonly string[];
+    readonly notices: readonly string[];
+}
+export declare function combineOutcomes(outcomes: readonly HookOutcome[], policy: CombinePolicy): CombinedDecision;

package/dist/extensions/hooks/decisions/combine.js

@@ -0,0 +1,43 @@
+import { SILENT_ANSWER } from './hook-outcome.js';
+const PRECEDENCE = { none: 0, allow: 1, ask: 2, defer: 3, deny: 4 };
+const DEFAULT_BLOCK_REASON = 'Blocked by hook';
+export function combineOutcomes(outcomes, policy) {
+    const answers = outcomes.flatMap((outcome) => answersOf(outcome, policy));
+    const decider = answers.reduce((best, answer) => (PRECEDENCE[answer.verdict] > PRECEDENCE[best.verdict] ? answer : best), SILENT_ANSWER);
+    return {
+        verdict: decider.verdict,
+        reason: reasonOf(decider),
+        denials: answers.filter(({ verdict }) => verdict === 'deny').map(({ reason }) => reason ?? DEFAULT_BLOCK_REASON),
+        contexts: answers.flatMap((answer) => contextOf(answer, policy)),
+        updatedInput: answers.flatMap(({ updatedInput }) => (updatedInput === undefined ? [] : [updatedInput])).at(-1),
+        updatedToolOutput: answers.map(({ updatedToolOutput }) => updatedToolOutput).find((output) => output !== undefined),
+        stopReason: answers.map(({ stopReason }) => stopReason).find((reason) => reason !== undefined),
+        systemMessages: answers.flatMap(({ systemMessage }) => (systemMessage === undefined ? [] : [systemMessage])),
+        notices: outcomes.flatMap((outcome) => noticesOf(outcome, policy)),
+    };
+}
+function answersOf(outcome, policy) {
+    if (outcome.kind === 'answered') {
+        return [outcome.answer];
+    }
+    return outcome.kind === 'unanswered' && policy.noVerdict === 'blocks' ? [{ ...SILENT_ANSWER, verdict: 'deny', reason: outcome.notice }] : [];
+}
+function noticesOf(outcome, policy) {
+    if (outcome.kind === 'failed') {
+        return [outcome.notice];
+    }
+    return outcome.kind === 'unanswered' && policy.noVerdict === 'proceeds' ? [outcome.notice] : [];
+}
+function reasonOf({ verdict, reason }) {
+    if (verdict === 'none') {
+        return undefined;
+    }
+    return verdict === 'deny' ? (reason ?? DEFAULT_BLOCK_REASON) : reason;
+}
+function contextOf({ context, plainText }, { plainTextIsContext }) {
+    if (context !== undefined) {
+        return [context];
+    }
+    return plainTextIsContext && plainText !== undefined ? [plainText] : [];
+}
+//# sourceMappingURL=combine.js.map

package/dist/extensions/hooks/decisions/combine.js.map

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

package/dist/extensions/hooks/decisions/hook-outcome.d.ts

@@ -0,0 +1,26 @@
+import type { JsonObject } from '../../../kernel/private-files/private-files.js';
+export type Verdict = 'none' | 'allow' | 'ask' | 'defer' | 'deny';
+export interface HookAnswer {
+    readonly verdict: Verdict;
+    readonly reason: string | undefined;
+    readonly context: string | undefined;
+    readonly plainText: string | undefined;
+    readonly updatedInput: JsonObject | undefined;
+    readonly updatedToolOutput: unknown;
+    readonly stopReason: string | undefined;
+    readonly systemMessage: string | undefined;
+}
+export type HookOutcome = {
+    readonly kind: 'answered';
+    readonly answer: HookAnswer;
+    readonly succeeded: boolean;
+} | {
+    readonly kind: 'failed';
+    readonly notice: string;
+} | {
+    readonly kind: 'unanswered';
+    readonly notice: string;
+} | {
+    readonly kind: 'detached';
+};
+export declare const SILENT_ANSWER: HookAnswer;

package/dist/extensions/hooks/decisions/hook-outcome.js

@@ -0,0 +1,11 @@
+export const SILENT_ANSWER = {
+    verdict: 'none',
+    reason: undefined,
+    context: undefined,
+    plainText: undefined,
+    updatedInput: undefined,
+    updatedToolOutput: undefined,
+    stopReason: undefined,
+    systemMessage: undefined,
+};
+//# sourceMappingURL=hook-outcome.js.map

package/dist/extensions/hooks/decisions/hook-outcome.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hook-outcome.js","sourceRoot":"","sources":["../../../../src/extensions/hooks/decisions/hook-outcome.ts"],"names":[],"mappings":"AAqBA,MAAM,CAAC,MAAM,aAAa,GAAe;IACvC,OAAO,EAAE,MAAM;IACf,MAAM,EAAE,SAAS;IACjB,OAAO,EAAE,SAAS;IAClB,SAAS,EAAE,SAAS;IACpB,YAAY,EAAE,SAAS;IACvB,iBAAiB,EAAE,SAAS;IAC5B,UAAU,EAAE,SAAS;IACrB,aAAa,EAAE,SAAS;CACzB,CAAC"}

package/dist/extensions/hooks/decisions/parse-output.d.ts

@@ -0,0 +1,5 @@
+import type { HookHandler } from '../registry/hook-handler.js';
+import type { HookRun } from '../runners/hook-runner.js';
+import { type HookOutcome } from './hook-outcome.js';
+export declare function parseHookOutput(exitCode: number, stdout: string, stderr: string): HookOutcome;
+export declare function outcomeOf(run: HookRun, handler: HookHandler, event: string): HookOutcome;

package/dist/extensions/hooks/decisions/parse-output.js

@@ -0,0 +1,112 @@
+// Portions adapted from pi-code (MIT, github.com/ilovepixelart/pi-code), extensions/hooks/decisions.ts.
+import { isJsonObject, parseJson } from '../../../kernel/private-files/private-files.js';
+import { SILENT_ANSWER } from './hook-outcome.js';
+const BLOCKING_EXIT_CODE = 2;
+const SUCCESS_EXIT_CODE = 0;
+const DEFAULT_BLOCK_REASON = 'Blocked by hook';
+const DEFAULT_STOP_REASON = 'Stopped by hook';
+const MALFORMED_OUTPUT = { kind: 'malformed' };
+const MALFORMED_NOTICE = 'its output looks like JSON but does not parse';
+const OUTPUT_FIELDS = new Set(['decision', 'reason', 'continue', 'stopReason', 'systemMessage', 'suppressOutput', 'hookSpecificOutput', 'updatedToolOutput', 'updatedMCPToolOutput', 'ok']);
+const VERDICT_BY_DECISION = new Map([
+    ['allow', 'allow'],
+    ['approve', 'allow'],
+    ['deny', 'deny'],
+    ['block', 'deny'],
+    ['ask', 'ask'],
+    ['defer', 'defer'],
+]);
+export function parseHookOutput(exitCode, stdout, stderr) {
+    const output = readStdout(stdout);
+    if (exitCode === BLOCKING_EXIT_CODE) {
+        return { kind: 'answered', answer: blockingAnswer(output, stderr), succeeded: false };
+    }
+    if (output.kind === 'json') {
+        return { kind: 'answered', answer: answerFrom(output.value), succeeded: true };
+    }
+    return output.kind === 'malformed' ? { kind: 'failed', notice: MALFORMED_NOTICE } : plainOutcome(exitCode, output.text, stderr);
+}
+function plainOutcome(exitCode, text, stderr) {
+    if (exitCode === SUCCESS_EXIT_CODE) {
+        return { kind: 'answered', answer: { ...SILENT_ANSWER, plainText: text === '' ? undefined : text }, succeeded: true };
+    }
+    return { kind: 'failed', notice: `Failed with non-blocking status code: ${firstLine(stderr) || String(exitCode)}` };
+}
+function readStdout(stdout) {
+    const trimmed = stdout.trim();
+    if (!looksLikeJsonObject(trimmed)) {
+        return { kind: 'text', text: trimmed };
+    }
+    const value = jsonObjectIn(trimmed);
+    if (value !== undefined) {
+        return { kind: 'json', value };
+    }
+    return isIndependentJsonLines(trimmed) ? { kind: 'text', text: trimmed } : MALFORMED_OUTPUT;
+}
+const looksLikeJsonObject = (text) => text.startsWith('{') && text.endsWith('}');
+function jsonObjectIn(text) {
+    const parsed = parseJson(text);
+    return parsed.kind === 'parsed' && isJsonObject(parsed.value) ? parsed.value : undefined;
+}
+function isIndependentJsonLines(text) {
+    const lines = text
+        .split('\n')
+        .map((line) => line.trim())
+        .filter((line) => line !== '');
+    const values = lines.map(parseJson);
+    return lines.length > 1 && values.every((value) => value.kind === 'parsed' && !setsOutputField(value.value));
+}
+const setsOutputField = (value) => isJsonObject(value) && Object.keys(value).some((key) => OUTPUT_FIELDS.has(key));
+function blockingAnswer(output, stderr) {
+    const fromJson = output.kind === 'json' ? answerFrom(output.value) : SILENT_ANSWER;
+    const jsonReason = fromJson.verdict === 'deny' ? fromJson.reason : undefined;
+    return { ...fromJson, verdict: 'deny', reason: jsonReason ?? (stderr.trim() || DEFAULT_BLOCK_REASON) };
+}
+function answerFrom(json) {
+    const specific = objectOf(json.hookSpecificOutput) ?? {};
+    return {
+        verdict: verdictOf(json, specific),
+        reason: textOf(specific.permissionDecisionReason) ?? textOf(json.reason),
+        context: textOf(specific.additionalContext),
+        plainText: undefined,
+        updatedInput: objectOf(specific.updatedInput),
+        updatedToolOutput: [specific.updatedToolOutput, specific.updatedMCPToolOutput, json.updatedToolOutput, json.updatedMCPToolOutput].find((value) => value !== undefined),
+        stopReason: stopReasonOf(json),
+        systemMessage: textOf(json.systemMessage),
+    };
+}
+const objectOf = (value) => (isJsonObject(value) ? value : undefined);
+const stopReasonOf = (json) => (json.continue === false ? (textOf(json.stopReason) ?? DEFAULT_STOP_REASON) : undefined);
+function verdictOf(json, specific) {
+    const named = VERDICT_BY_DECISION.get(textOf(specific.permissionDecision) ?? textOf(json.decision) ?? '');
+    if (named !== undefined) {
+        return named;
+    }
+    return json.ok === false ? 'deny' : 'none';
+}
+const textOf = (value) => (typeof value === 'string' ? value : undefined);
+const firstLine = (text) => text.trim().split('\n')[0] ?? '';
+export function outcomeOf(run, handler, event) {
+    const outcome = rawOutcomeOf(run, handler, event);
+    return handler.blocksOnFailure ? blockingOnFailure(outcome) : outcome;
+}
+function rawOutcomeOf(run, { label }, event) {
+    switch (run.kind) {
+        case 'exited':
+            return withHookNamed(parseHookOutput(run.exitCode, run.stdout, run.stderr), `${event} hook error: [${label}]: `);
+        case 'failed':
+            return { kind: 'failed', notice: `${event} hook error: [${label}]: ${run.reason}` };
+        case 'timed-out':
+            return { kind: 'unanswered', notice: `Hook timed out after ${String(run.afterMs)}ms: ${label}` };
+        case 'not-started':
+            return { kind: 'unanswered', notice: `Hook failed to run: ${label}: ${run.reason}` };
+    }
+}
+const withHookNamed = (outcome, prefix) => (outcome.kind === 'failed' ? { kind: 'failed', notice: `${prefix}${outcome.notice}` } : outcome);
+function blockingOnFailure(outcome) {
+    if (outcome.kind !== 'failed' && outcome.kind !== 'unanswered') {
+        return outcome;
+    }
+    return { kind: 'answered', answer: { ...SILENT_ANSWER, verdict: 'deny', reason: outcome.notice }, succeeded: false };
+}
+//# sourceMappingURL=parse-output.js.map

package/dist/extensions/hooks/decisions/parse-output.js.map

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

package/dist/extensions/hooks/delivery/idle-watch.d.ts

@@ -0,0 +1,5 @@
+export declare class IdleWatch {
+    #private;
+    arm(onIdle: () => void): void;
+    cancel(): void;
+}

package/dist/extensions/hooks/delivery/idle-watch.js

@@ -0,0 +1,17 @@
+const IDLE_DELAY_MS = 60_000;
+export class IdleWatch {
+    #timer;
+    arm(onIdle) {
+        this.cancel();
+        this.#timer = setTimeout(() => {
+            this.#timer = undefined;
+            onIdle();
+        }, IDLE_DELAY_MS);
+        this.#timer.unref();
+    }
+    cancel() {
+        clearTimeout(this.#timer);
+        this.#timer = undefined;
+    }
+}
+//# sourceMappingURL=idle-watch.js.map

package/dist/extensions/hooks/delivery/idle-watch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"idle-watch.js","sourceRoot":"","sources":["../../../../src/extensions/hooks/delivery/idle-watch.ts"],"names":[],"mappings":"AAAA,MAAM,aAAa,GAAG,MAAM,CAAC;AAE7B,MAAM,OAAO,SAAS;IACpB,MAAM,CAA4C;IAElD,GAAG,CAAC,MAAkB;QACpB,IAAI,CAAC,MAAM,EAAE,CAAC;QACd,IAAI,CAAC,MAAM,GAAG,UAAU,CAAC,GAAG,EAAE;YAC5B,IAAI,CAAC,MAAM,GAAG,SAAS,CAAC;YACxB,MAAM,EAAE,CAAC;QACX,CAAC,EAAE,aAAa,CAAC,CAAC;QAClB,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;IACtB,CAAC;IAED,MAAM;QACJ,YAAY,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAC1B,IAAI,CAAC,MAAM,GAAG,SAAS,CAAC;IAC1B,CAAC;CACF"}

package/dist/extensions/hooks/delivery/pending-context.d.ts

@@ -0,0 +1,7 @@
+import type { BeforeAgentStartEventResult } from '@earendil-works/pi-coding-agent';
+export declare const HOOK_CONTEXT_MESSAGE = "claude-hook-context";
+export declare class PendingContext {
+    #private;
+    add(texts: readonly string[]): void;
+    take(): BeforeAgentStartEventResult | undefined;
+}

package/dist/extensions/hooks/delivery/pending-context.js

@@ -0,0 +1,16 @@
+export const HOOK_CONTEXT_MESSAGE = 'claude-hook-context';
+export class PendingContext {
+    #texts = [];
+    add(texts) {
+        this.#texts = [...this.#texts, ...texts];
+    }
+    take() {
+        if (this.#texts.length === 0) {
+            return undefined;
+        }
+        const content = this.#texts.join('\n');
+        this.#texts = [];
+        return { message: { customType: HOOK_CONTEXT_MESSAGE, content, display: false } };
+    }
+}
+//# sourceMappingURL=pending-context.js.map

package/dist/extensions/hooks/delivery/pending-context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pending-context.js","sourceRoot":"","sources":["../../../../src/extensions/hooks/delivery/pending-context.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,oBAAoB,GAAG,qBAAqB,CAAC;AAE1D,MAAM,OAAO,cAAc;IACzB,MAAM,GAAa,EAAE,CAAC;IAEtB,GAAG,CAAC,KAAwB;QAC1B,IAAI,CAAC,MAAM,GAAG,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,GAAG,KAAK,CAAC,CAAC;IAC3C,CAAC;IAED,IAAI;QACF,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC7B,OAAO,SAAS,CAAC;QACnB,CAAC;QACD,MAAM,OAAO,GAAG,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACvC,IAAI,CAAC,MAAM,GAAG,EAAE,CAAC;QACjB,OAAO,EAAE,OAAO,EAAE,EAAE,UAAU,EAAE,oBAAoB,EAAE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,CAAC;IACpF,CAAC;CACF"}

package/dist/extensions/hooks/delivery/stop-continuations.d.ts

@@ -0,0 +1,9 @@
+import type { ExtensionAPI, ExtensionContext } from '@earendil-works/pi-coding-agent';
+export declare class StopContinuations {
+    #private;
+    constructor(pi: Pick<ExtensionAPI, 'sendMessage'>);
+    get active(): boolean;
+    continueWith(reason: string, ctx: Pick<ExtensionContext, 'ui'>): void;
+    release(): void;
+    madeProgress(): void;
+}

package/dist/extensions/hooks/delivery/stop-continuations.js

@@ -0,0 +1,31 @@
+const STOP_HOOK_MESSAGE = 'claude-stop-hook';
+const CONSECUTIVE_CONTINUATION_CAP = 8;
+export class StopContinuations {
+    #pi;
+    #continuations = 0;
+    #active = false;
+    constructor(pi) {
+        this.#pi = pi;
+    }
+    get active() {
+        return this.#active;
+    }
+    continueWith(reason, ctx) {
+        if (this.#continuations >= CONSECUTIVE_CONTINUATION_CAP) {
+            this.release();
+            ctx.ui.notify(`Stop hooks blocked ${String(CONSECUTIVE_CONTINUATION_CAP)} consecutive times; the turn ends here.`, 'warning');
+            return;
+        }
+        this.#continuations += 1;
+        this.#active = true;
+        this.#pi.sendMessage({ customType: STOP_HOOK_MESSAGE, content: reason, display: true }, { triggerTurn: true });
+    }
+    release() {
+        this.#continuations = 0;
+        this.#active = false;
+    }
+    madeProgress() {
+        this.#continuations = 0;
+    }
+}
+//# sourceMappingURL=stop-continuations.js.map

package/dist/extensions/hooks/delivery/stop-continuations.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stop-continuations.js","sourceRoot":"","sources":["../../../../src/extensions/hooks/delivery/stop-continuations.ts"],"names":[],"mappings":"AAEA,MAAM,iBAAiB,GAAG,kBAAkB,CAAC;AAC7C,MAAM,4BAA4B,GAAG,CAAC,CAAC;AAEvC,MAAM,OAAO,iBAAiB;IACnB,GAAG,CAAoC;IAChD,cAAc,GAAG,CAAC,CAAC;IACnB,OAAO,GAAG,KAAK,CAAC;IAEhB,YAAY,EAAqC;QAC/C,IAAI,CAAC,GAAG,GAAG,EAAE,CAAC;IAChB,CAAC;IAED,IAAI,MAAM;QACR,OAAO,IAAI,CAAC,OAAO,CAAC;IACtB,CAAC;IAED,YAAY,CAAC,MAAc,EAAE,GAAiC;QAC5D,IAAI,IAAI,CAAC,cAAc,IAAI,4BAA4B,EAAE,CAAC;YACxD,IAAI,CAAC,OAAO,EAAE,CAAC;YACf,GAAG,CAAC,EAAE,CAAC,MAAM,CAAC,sBAAsB,MAAM,CAAC,4BAA4B,CAAC,yCAAyC,EAAE,SAAS,CAAC,CAAC;YAC9H,OAAO;QACT,CAAC;QACD,IAAI,CAAC,cAAc,IAAI,CAAC,CAAC;QACzB,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC;QACpB,IAAI,CAAC,GAAG,CAAC,WAAW,CAAC,EAAE,UAAU,EAAE,iBAAiB,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,EAAE,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC,CAAC;IACjH,CAAC;IAED,OAAO;QACL,IAAI,CAAC,cAAc,GAAG,CAAC,CAAC;QACxB,IAAI,CAAC,OAAO,GAAG,KAAK,CAAC;IACvB,CAAC;IAED,YAAY;QACV,IAAI,CAAC,cAAc,GAAG,CAAC,CAAC;IAC1B,CAAC;CACF"}

package/dist/extensions/hooks/delivery/tool-call-notes.d.ts

@@ -0,0 +1,8 @@
+import type { ExtensionContext } from '@earendil-works/pi-coding-agent';
+export declare class ToolCallNotes {
+    #private;
+    addContexts(toolCallId: string, contexts: readonly string[]): void;
+    takeContexts(toolCallId: string): readonly string[];
+    holdStop(toolCallId: string, stopReason: string | undefined): void;
+    settle(toolCallId: string, ctx: Pick<ExtensionContext, 'ui' | 'abort'>): void;
+}

package/dist/extensions/hooks/delivery/tool-call-notes.js

@@ -0,0 +1,30 @@
+export class ToolCallNotes {
+    #contexts = new Map();
+    #stops = new Map();
+    addContexts(toolCallId, contexts) {
+        if (contexts.length > 0) {
+            this.#contexts.set(toolCallId, [...(this.#contexts.get(toolCallId) ?? []), ...contexts]);
+        }
+    }
+    takeContexts(toolCallId) {
+        const contexts = this.#contexts.get(toolCallId) ?? [];
+        this.#contexts.delete(toolCallId);
+        return contexts;
+    }
+    holdStop(toolCallId, stopReason) {
+        if (stopReason !== undefined) {
+            this.#stops.set(toolCallId, stopReason);
+        }
+    }
+    settle(toolCallId, ctx) {
+        const stopReason = this.#stops.get(toolCallId);
+        this.#contexts.delete(toolCallId);
+        if (stopReason === undefined) {
+            return;
+        }
+        this.#stops.delete(toolCallId);
+        ctx.ui.notify(stopReason, 'warning');
+        ctx.abort();
+    }
+}
+//# sourceMappingURL=tool-call-notes.js.map

package/dist/extensions/hooks/delivery/tool-call-notes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-call-notes.js","sourceRoot":"","sources":["../../../../src/extensions/hooks/delivery/tool-call-notes.ts"],"names":[],"mappings":"AAEA,MAAM,OAAO,aAAa;IACf,SAAS,GAAG,IAAI,GAAG,EAA6B,CAAC;IACjD,MAAM,GAAG,IAAI,GAAG,EAAkB,CAAC;IAE5C,WAAW,CAAC,UAAkB,EAAE,QAA2B;QACzD,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACxB,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,UAAU,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,EAAE,CAAC,EAAE,GAAG,QAAQ,CAAC,CAAC,CAAC;QAC3F,CAAC;IACH,CAAC;IAED,YAAY,CAAC,UAAkB;QAC7B,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,EAAE,CAAC;QACtD,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;QAClC,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,QAAQ,CAAC,UAAkB,EAAE,UAA8B;QACzD,IAAI,UAAU,KAAK,SAAS,EAAE,CAAC;YAC7B,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC;QAC1C,CAAC;IACH,CAAC;IAED,MAAM,CAAC,UAAkB,EAAE,GAA2C;QACpE,MAAM,UAAU,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;QAC/C,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;QAClC,IAAI,UAAU,KAAK,SAAS,EAAE,CAAC;YAC7B,OAAO;QACT,CAAC;QACD,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;QAC/B,GAAG,CAAC,EAAE,CAAC,MAAM,CAAC,UAAU,EAAE,SAAS,CAAC,CAAC;QACrC,GAAG,CAAC,KAAK,EAAE,CAAC;IACd,CAAC;CACF"}

package/dist/extensions/hooks/dispatch/common-fields.d.ts

@@ -0,0 +1,3 @@
+import type { ExtensionContext } from '@earendil-works/pi-coding-agent';
+import type { JsonObject } from '../../../kernel/private-files/private-files.js';
+export declare function commonFields(ctx: Pick<ExtensionContext, 'cwd' | 'sessionManager'>, claudeEvent: string): JsonObject;

package/dist/extensions/hooks/dispatch/common-fields.js

@@ -0,0 +1,10 @@
+export function commonFields(ctx, claudeEvent) {
+    const transcript = ctx.sessionManager.getSessionFile();
+    return {
+        session_id: ctx.sessionManager.getSessionId(),
+        ...(transcript === undefined ? {} : { transcript_path: transcript }),
+        cwd: ctx.cwd,
+        hook_event_name: claudeEvent,
+    };
+}
+//# sourceMappingURL=common-fields.js.map

package/dist/extensions/hooks/dispatch/common-fields.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"common-fields.js","sourceRoot":"","sources":["../../../../src/extensions/hooks/dispatch/common-fields.ts"],"names":[],"mappings":"AAGA,MAAM,UAAU,YAAY,CAAC,GAAqD,EAAE,WAAmB;IACrG,MAAM,UAAU,GAAG,GAAG,CAAC,cAAc,CAAC,cAAc,EAAE,CAAC;IACvD,OAAO;QACL,UAAU,EAAE,GAAG,CAAC,cAAc,CAAC,YAAY,EAAE;QAC7C,GAAG,CAAC,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,eAAe,EAAE,UAAU,EAAE,CAAC;QACpE,GAAG,EAAE,GAAG,CAAC,GAAG;QACZ,eAAe,EAAE,WAAW;KAC7B,CAAC;AACJ,CAAC"}

package/dist/extensions/hooks/dispatch/hook-dispatcher.d.ts

@@ -0,0 +1,9 @@
+import type { BridgeCall, EventBridge } from '../bridges/event-bridge.js';
+import { type CombinedDecision } from '../decisions/combine.js';
+import type { HookRegistry } from '../registry/hook-registry.js';
+import type { BackgroundHooks } from '../runners/background-hooks.js';
+export declare class HookDispatcher {
+    #private;
+    constructor(registry: () => HookRegistry, background: BackgroundHooks);
+    dispatch(bridge: EventBridge, call: BridgeCall<never>): Promise<CombinedDecision>;
+}

package/dist/extensions/hooks/dispatch/hook-dispatcher.js

@@ -0,0 +1,62 @@
+import { scopedHooks } from '../../../kernel/scoped-hooks/scoped-hooks.js';
+import { combineOutcomes } from '../decisions/combine.js';
+import { outcomeOf } from '../decisions/parse-output.js';
+import { piHookAgents } from '../runners/pi-hook-agents.js';
+import { piHookModels } from '../runners/pi-hook-models.js';
+import { runHandler } from '../runners/runners-by-type.js';
+import { commonFields } from './common-fields.js';
+const MILLISECONDS_PER_SECOND = 1000;
+const PROMPT_DEFAULT_SECONDS = 30;
+const DETACHED = { kind: 'detached' };
+export class HookDispatcher {
+    #registry;
+    #background;
+    constructor(registry, background) {
+        this.#registry = registry;
+        this.#background = background;
+    }
+    async dispatch(bridge, call) {
+        const handlers = this.#registry().handlersFor(bridge.claudeEvent, bridge.subject(call));
+        if (handlers.length === 0) {
+            return combineOutcomes([], bridge.policy);
+        }
+        const invocation = { bridge, call, payload: { ...commonFields(call.ctx, bridge.claudeEvent), ...bridge.payload(call) } };
+        const outcomes = await Promise.all(handlers.map((handler) => this.#outcomeOf(handler, invocation)));
+        spendOnceHooks(handlers, outcomes, call.ctx.sessionManager.getSessionId());
+        return combineOutcomes(outcomes, bridge.policy);
+    }
+    async #outcomeOf(handler, { bridge, call, payload }) {
+        const context = runContextFor(handler, bridge.timeouts, call);
+        if (handler.type === 'command' && handler.background !== 'none') {
+            this.#background.start(handler, payload, context);
+            return DETACHED;
+        }
+        return outcomeOf(await runHandler(handler, payload, context), handler, bridge.claudeEvent);
+    }
+}
+function runContextFor(handler, timeouts, { ctx, services }) {
+    return {
+        timeoutMs: timeoutMsFor(handler, timeouts),
+        environment: { cwd: ctx.cwd, projectDir: services.projectDir },
+        models: piHookModels(ctx),
+        agents: piHookAgents(ctx),
+        onStarted: () => undefined,
+    };
+}
+function timeoutMsFor(handler, timeouts) {
+    if (handler.type === 'command' && handler.background === 'async') {
+        return undefined;
+    }
+    const seconds = handler.timeoutSeconds === undefined ? defaultSecondsFor(handler, timeouts) : Math.min(handler.timeoutSeconds, timeouts.maxSeconds);
+    return Math.round(seconds * MILLISECONDS_PER_SECOND);
+}
+const defaultSecondsFor = (handler, timeouts) => (handler.type === 'prompt' ? PROMPT_DEFAULT_SECONDS : timeouts.defaultSeconds);
+function spendOnceHooks(handlers, outcomes, sessionId) {
+    handlers.forEach(({ onceKey }, index) => {
+        const outcome = outcomes[index];
+        if (onceKey !== undefined && outcome?.kind === 'answered' && outcome.succeeded) {
+            scopedHooks().markSpent(sessionId, onceKey);
+        }
+    });
+}
+//# sourceMappingURL=hook-dispatcher.js.map

package/dist/extensions/hooks/dispatch/hook-dispatcher.js.map

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

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

@@ -0,0 +1,15 @@
+import type { ExtensionAPI, ExtensionContext, BeforeAgentStartEventResult } from '@earendil-works/pi-coding-agent';
+import { type HookTrigger } from './bridges/triggers.js';
+export declare class HookSession {
+    #private;
+    constructor(pi: Pick<ExtensionAPI, 'sendMessage'>);
+    open(ctx: ExtensionContext): Promise<void>;
+    runBridges(trigger: HookTrigger, event: unknown, ctx: ExtensionContext): Promise<unknown>;
+    runAnnounced(trigger: HookTrigger, event: unknown): Promise<unknown>;
+    armIdle(ctx: ExtensionContext): void;
+    disarmIdle(): void;
+    takeSessionContext(): BeforeAgentStartEventResult | undefined;
+    settleToolCall(toolCallId: string, ctx: ExtensionContext): void;
+    close(ctx: Pick<ExtensionContext, 'hasUI' | 'sessionManager'>): void;
+    summary(): string;
+}