@nklisch/pi-enhanced 0.1.0

package/node_modules/@nklisch/pi-plugins/dist/runtime/hooks/hook-output-parser.js

@@ -0,0 +1,182 @@
+import { CommandHookJsonOutputSchema, HookOutputEventPolicyRegistry, HookOutputFieldRegistry } from "../../domain/hook-output-contract.js";
+import { HOOK_MAX_AGGREGATED_TEXT_BYTES, HOOK_STDERR_MAX_BYTES, HOOK_STDOUT_MAX_BYTES } from "../../domain/hook-runtime-limits.js";
+import { createHookRuntimeDiagnostic } from "./hook-runtime-diagnostic.js";
+const decoder = new TextDecoder("utf-8", { fatal: true });
+function bytes(value) {
+    return new TextEncoder().encode(value).byteLength;
+}
+function diagnostic(execution, event, code) {
+    return createHookRuntimeDiagnostic(execution.binding, event, code);
+}
+function deepFreeze(value, seen = new WeakSet()) {
+    if (value === null || typeof value !== "object" || seen.has(value))
+        return value;
+    seen.add(value);
+    for (const child of Object.values(value))
+        deepFreeze(child, seen);
+    Object.freeze(value);
+    return value;
+}
+function redactJson(value, redact) {
+    if (typeof value === "string")
+        return redact(value);
+    if (Array.isArray(value))
+        return deepFreeze(value.map((item) => redactJson(item, redact)));
+    if (value !== null && typeof value === "object") {
+        return deepFreeze(Object.fromEntries(Object.entries(value).map(([key, item]) => [key, redactJson(item, redact)])));
+    }
+    return value;
+}
+function sameJson(left, right) {
+    return JSON.stringify(left) === JSON.stringify(right);
+}
+function fieldAllowed(event, field) {
+    const definition = HookOutputFieldRegistry[field];
+    return definition !== undefined && definition.events.includes(event);
+}
+function mergeOutput(event, output) {
+    const nested = output.hookSpecificOutput;
+    if (nested === undefined)
+        return { kind: "accepted", output };
+    if (nested.hookEventName !== event)
+        return { kind: "unsupported" };
+    const result = { ...output };
+    delete result.hookSpecificOutput;
+    for (const [field, value] of Object.entries(nested)) {
+        if (field === "hookEventName" || value === undefined)
+            continue;
+        if (!fieldAllowed(event, field))
+            return { kind: "unsupported" };
+        if (field in result && !sameJson(result[field], value))
+            return { kind: "unsupported" };
+        result[field] = value;
+    }
+    return { kind: "accepted", output: result };
+}
+function parseObject(event, text, execution) {
+    let value;
+    try {
+        value = JSON.parse(text);
+    }
+    catch {
+        return diagnostic(execution, event, "HOOK_INVALID_OUTPUT");
+    }
+    const parsed = CommandHookJsonOutputSchema.safeParse(value);
+    if (!parsed.success)
+        return diagnostic(execution, event, "HOOK_INVALID_OUTPUT");
+    const merged = mergeOutput(event, parsed.data);
+    if (merged.kind === "unsupported")
+        return diagnostic(execution, event, "HOOK_UNSUPPORTED_OUTPUT");
+    return merged.output;
+}
+function makeDecision(event, output, execution, redact) {
+    const values = output;
+    for (const field of Object.keys(values)) {
+        if (field === "hookSpecificOutput" || values[field] === undefined)
+            continue;
+        if (!fieldAllowed(event, field))
+            return diagnostic(execution, event, "HOOK_UNSUPPORTED_OUTPUT");
+    }
+    const contextValues = [];
+    if (output.additionalContext !== undefined)
+        contextValues.push(redact(output.additionalContext));
+    const reason = output.reason === undefined ? undefined : redact(output.reason);
+    const stopReason = output.stopReason === undefined ? reason : redact(output.stopReason);
+    const permissionReason = output.permissionDecisionReason === undefined ? undefined : redact(output.permissionDecisionReason);
+    const blockReason = reason ?? stopReason;
+    const block = output.decision === "block"
+        ? { ...(blockReason === undefined ? {} : { reason: blockReason }) }
+        : undefined;
+    const permission = output.permissionDecision === undefined
+        ? undefined
+        : { kind: output.permissionDecision, ...(permissionReason === undefined ? {} : { reason: permissionReason }) };
+    const updatedInput = output.updatedInput === undefined
+        ? undefined
+        : deepFreeze(Object.fromEntries(Object.entries(output.updatedInput).map(([key, value]) => [key, redactJson(value, redact)])));
+    const updatedToolOutput = output.updatedToolOutput === undefined ? undefined : redactJson(output.updatedToolOutput, redact);
+    const title = output.title === undefined ? undefined : redact(output.title);
+    const isContinuationEvent = event === "Stop" || event === "SubagentStop";
+    const continuation = isContinuationEvent && (output.decision === "block" || output.continue === false || output.stopReason !== undefined)
+        ? { ...(blockReason === undefined ? {} : { reason: blockReason }) }
+        : undefined;
+    const effectiveBlock = isContinuationEvent ? undefined : block;
+    const stop = !isContinuationEvent && (output.continue === false || output.stopReason !== undefined)
+        ? { ...(stopReason === undefined ? {} : { reason: stopReason }) }
+        : undefined;
+    return Object.freeze({
+        binding: execution.binding,
+        contexts: Object.freeze(contextValues),
+        systemMessages: output.systemMessage === undefined ? Object.freeze([]) : Object.freeze([redact(output.systemMessage)]),
+        ...(effectiveBlock === undefined ? {} : { block: effectiveBlock }),
+        ...(permission === undefined ? {} : { permission }),
+        ...(updatedInput === undefined ? {} : { updatedInput }),
+        ...(updatedToolOutput === undefined ? {} : { updatedToolOutput }),
+        ...(stop === undefined ? {} : { stop }),
+        ...(title === undefined ? {} : { title }),
+        ...(continuation === undefined ? {} : { continuation }),
+    });
+}
+/** Parse one already-bounded process result while still inside the config callback. */
+export function parseHookHandlerOutput(input) {
+    const { event, execution, redact } = input;
+    if (execution.stdout.byteLength > HOOK_STDOUT_MAX_BYTES || execution.stderr.byteLength > HOOK_STDERR_MAX_BYTES || execution.stderrTruncated === true) {
+        return diagnostic(execution, event, "HOOK_OUTPUT_LIMIT");
+    }
+    let stdout;
+    try {
+        // Decode stderr as well even though it never enters a decision. A process
+        // that emits invalid bytes must not get a different observable contract.
+        decoder.decode(execution.stderr);
+        stdout = decoder.decode(execution.stdout);
+    }
+    catch {
+        return diagnostic(execution, event, "HOOK_INVALID_UTF8");
+    }
+    const policy = HookOutputEventPolicyRegistry[event];
+    if (policy === undefined)
+        return diagnostic(execution, event, "HOOK_UNSUPPORTED_OUTPUT");
+    if (execution.exitCode !== 0 && execution.exitCode !== 2)
+        return diagnostic(execution, event, "HOOK_EXIT_STATUS");
+    if (stdout.length === 0) {
+        if (execution.exitCode === 2 && policy.exitTwo !== "unsupported") {
+            const fallback = policy.exitTwo === "continuation"
+                ? { decision: "block" }
+                : { decision: "block" };
+            return makeDecision(event, fallback, execution, redact);
+        }
+        if (execution.exitCode === 2)
+            return diagnostic(execution, event, "HOOK_EXIT_STATUS");
+        return Object.freeze({ binding: execution.binding, contexts: Object.freeze([]), systemMessages: Object.freeze([]) });
+    }
+    const first = stdout.trimStart()[0];
+    let parsed;
+    if (first === "{" && stdout.trimEnd().endsWith("}")) {
+        const object = parseObject(event, stdout, execution);
+        if ("code" in object)
+            return object;
+        parsed = makeDecision(event, object, execution, redact);
+    }
+    else {
+        if (!policy.plain || execution.exitCode !== 0)
+            return diagnostic(execution, event, "HOOK_INVALID_OUTPUT");
+        if (bytes(stdout) > HOOK_MAX_AGGREGATED_TEXT_BYTES)
+            return diagnostic(execution, event, "HOOK_OUTPUT_LIMIT");
+        parsed = Object.freeze({
+            binding: execution.binding,
+            contexts: Object.freeze([redact(stdout)]),
+            systemMessages: Object.freeze([]),
+        });
+    }
+    if ("code" in parsed)
+        return parsed;
+    if (execution.exitCode === 2) {
+        if (policy.exitTwo === "unsupported")
+            return diagnostic(execution, event, "HOOK_EXIT_STATUS");
+        if (policy.exitTwo === "continuation") {
+            return Object.freeze({ ...parsed, continuation: parsed.continuation ?? { ...(parsed.stop?.reason === undefined ? {} : { reason: parsed.stop.reason }) } });
+        }
+        return Object.freeze({ ...parsed, block: parsed.block ?? { ...(parsed.stop?.reason === undefined ? {} : { reason: parsed.stop.reason }) } });
+    }
+    return parsed;
+}
+//# sourceMappingURL=hook-output-parser.js.map

package/node_modules/@nklisch/pi-plugins/dist/runtime/hooks/hook-output-parser.js.map

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

package/node_modules/@nklisch/pi-plugins/dist/runtime/hooks/hook-runtime-diagnostic.d.ts

@@ -0,0 +1,107 @@
+import { z } from "zod";
+import { type OrdinaryHookEvent, type SubagentHookEvent } from "../../domain/hook-runtime-contract.js";
+import type { HookExecutionBinding } from "../../domain/hook-execution-binding.js";
+export declare const HookRuntimeDiagnosticCodeRegistry: Readonly<{
+    readonly invalidPlan: "HOOK_INVALID_PLAN";
+    readonly selectedLimit: "HOOK_SELECTED_LIMIT";
+    readonly cancelled: "HOOK_CANCELLED";
+    readonly authorityRejected: "HOOK_AUTHORITY_REJECTED";
+    readonly configurationFailed: "HOOK_CONFIGURATION_FAILED";
+    readonly executableUnavailable: "HOOK_EXECUTABLE_UNAVAILABLE";
+    readonly spawnFailed: "HOOK_SPAWN_FAILED";
+    readonly timeout: "HOOK_TIMEOUT";
+    readonly outputLimit: "HOOK_OUTPUT_LIMIT";
+    readonly invalidUtf8: "HOOK_INVALID_UTF8";
+    readonly invalidOutput: "HOOK_INVALID_OUTPUT";
+    readonly unsupportedOutput: "HOOK_UNSUPPORTED_OUTPUT";
+    readonly exitStatus: "HOOK_EXIT_STATUS";
+    readonly aggregateLimit: "HOOK_AGGREGATE_LIMIT";
+    readonly continuationExhausted: "HOOK_CONTINUATION_EXHAUSTED";
+    readonly permissionUnavailable: "HOOK_PERMISSION_UNAVAILABLE";
+}>;
+export type HookRuntimeDiagnosticCode = typeof HookRuntimeDiagnosticCodeRegistry[keyof typeof HookRuntimeDiagnosticCodeRegistry];
+export declare const HookRuntimeDiagnosticCodeSchema: z.ZodEnum<{
+    HOOK_AGGREGATE_LIMIT: "HOOK_AGGREGATE_LIMIT";
+    HOOK_AUTHORITY_REJECTED: "HOOK_AUTHORITY_REJECTED";
+    HOOK_CANCELLED: "HOOK_CANCELLED";
+    HOOK_CONFIGURATION_FAILED: "HOOK_CONFIGURATION_FAILED";
+    HOOK_CONTINUATION_EXHAUSTED: "HOOK_CONTINUATION_EXHAUSTED";
+    HOOK_EXECUTABLE_UNAVAILABLE: "HOOK_EXECUTABLE_UNAVAILABLE";
+    HOOK_EXIT_STATUS: "HOOK_EXIT_STATUS";
+    HOOK_INVALID_OUTPUT: "HOOK_INVALID_OUTPUT";
+    HOOK_INVALID_PLAN: "HOOK_INVALID_PLAN";
+    HOOK_INVALID_UTF8: "HOOK_INVALID_UTF8";
+    HOOK_OUTPUT_LIMIT: "HOOK_OUTPUT_LIMIT";
+    HOOK_PERMISSION_UNAVAILABLE: "HOOK_PERMISSION_UNAVAILABLE";
+    HOOK_SELECTED_LIMIT: "HOOK_SELECTED_LIMIT";
+    HOOK_SPAWN_FAILED: "HOOK_SPAWN_FAILED";
+    HOOK_TIMEOUT: "HOOK_TIMEOUT";
+    HOOK_UNSUPPORTED_OUTPUT: "HOOK_UNSUPPORTED_OUTPUT";
+}>;
+export declare const HookRuntimeDiagnosticSchema: z.ZodReadonly<z.ZodObject<{
+    code: z.ZodEnum<{
+        HOOK_AGGREGATE_LIMIT: "HOOK_AGGREGATE_LIMIT";
+        HOOK_AUTHORITY_REJECTED: "HOOK_AUTHORITY_REJECTED";
+        HOOK_CANCELLED: "HOOK_CANCELLED";
+        HOOK_CONFIGURATION_FAILED: "HOOK_CONFIGURATION_FAILED";
+        HOOK_CONTINUATION_EXHAUSTED: "HOOK_CONTINUATION_EXHAUSTED";
+        HOOK_EXECUTABLE_UNAVAILABLE: "HOOK_EXECUTABLE_UNAVAILABLE";
+        HOOK_EXIT_STATUS: "HOOK_EXIT_STATUS";
+        HOOK_INVALID_OUTPUT: "HOOK_INVALID_OUTPUT";
+        HOOK_INVALID_PLAN: "HOOK_INVALID_PLAN";
+        HOOK_INVALID_UTF8: "HOOK_INVALID_UTF8";
+        HOOK_OUTPUT_LIMIT: "HOOK_OUTPUT_LIMIT";
+        HOOK_PERMISSION_UNAVAILABLE: "HOOK_PERMISSION_UNAVAILABLE";
+        HOOK_SELECTED_LIMIT: "HOOK_SELECTED_LIMIT";
+        HOOK_SPAWN_FAILED: "HOOK_SPAWN_FAILED";
+        HOOK_TIMEOUT: "HOOK_TIMEOUT";
+        HOOK_UNSUPPORTED_OUTPUT: "HOOK_UNSUPPORTED_OUTPUT";
+    }>;
+    severity: z.ZodEnum<{
+        error: "error";
+        warning: "warning";
+    }>;
+    event: z.ZodEnum<{
+        ConfigChange: "ConfigChange";
+        CwdChanged: "CwdChanged";
+        Elicitation: "Elicitation";
+        ElicitationResult: "ElicitationResult";
+        FileChanged: "FileChanged";
+        InstructionsLoaded: "InstructionsLoaded";
+        MessageDisplay: "MessageDisplay";
+        Notification: "Notification";
+        PermissionDenied: "PermissionDenied";
+        PermissionRequest: "PermissionRequest";
+        PostCompact: "PostCompact";
+        PostToolBatch: "PostToolBatch";
+        PostToolUse: "PostToolUse";
+        PostToolUseFailure: "PostToolUseFailure";
+        PreCompact: "PreCompact";
+        PreToolUse: "PreToolUse";
+        SessionEnd: "SessionEnd";
+        SessionStart: "SessionStart";
+        Setup: "Setup";
+        Stop: "Stop";
+        StopFailure: "StopFailure";
+        SubagentStart: "SubagentStart";
+        SubagentStop: "SubagentStop";
+        TaskCompleted: "TaskCompleted";
+        TaskCreated: "TaskCreated";
+        TeammateIdle: "TeammateIdle";
+        UserPromptExpansion: "UserPromptExpansion";
+        UserPromptSubmit: "UserPromptSubmit";
+        WorktreeCreate: "WorktreeCreate";
+        WorktreeRemove: "WorktreeRemove";
+    }>;
+    plugin: z.core.$ZodBranded<z.ZodString, "PluginKey", "out">;
+    componentId: z.core.$ZodBranded<z.ZodString, "ComponentId", "out">;
+    sourceOrder: z.ZodReadonly<z.ZodObject<{
+        snapshotOrdinal: z.ZodNumber;
+        hookOrdinal: z.ZodNumber;
+    }, z.core.$strict>>;
+    message: z.ZodString;
+}, z.core.$strict>>;
+export type HookRuntimeDiagnostic = z.infer<typeof HookRuntimeDiagnosticSchema>;
+export declare function createHookRuntimeDiagnostic(binding: HookExecutionBinding, event: OrdinaryHookEvent | SubagentHookEvent, code: HookRuntimeDiagnosticCode, severity?: "warning" | "error", 
+/** Underlying cause preserved for the failure log; never user-supplied text. */
+detail?: string): HookRuntimeDiagnostic;

package/node_modules/@nklisch/pi-plugins/dist/runtime/hooks/hook-runtime-diagnostic.js

@@ -0,0 +1,64 @@
+import { z } from "zod";
+import { ComponentIdSchema } from "../../domain/components.js";
+import { HookEventNameSchema } from "../../domain/hook-runtime-contract.js";
+import { PluginKeySchema } from "../../domain/identity.js";
+export const HookRuntimeDiagnosticCodeRegistry = Object.freeze({
+    invalidPlan: "HOOK_INVALID_PLAN",
+    selectedLimit: "HOOK_SELECTED_LIMIT",
+    cancelled: "HOOK_CANCELLED",
+    authorityRejected: "HOOK_AUTHORITY_REJECTED",
+    configurationFailed: "HOOK_CONFIGURATION_FAILED",
+    executableUnavailable: "HOOK_EXECUTABLE_UNAVAILABLE",
+    spawnFailed: "HOOK_SPAWN_FAILED",
+    timeout: "HOOK_TIMEOUT",
+    outputLimit: "HOOK_OUTPUT_LIMIT",
+    invalidUtf8: "HOOK_INVALID_UTF8",
+    invalidOutput: "HOOK_INVALID_OUTPUT",
+    unsupportedOutput: "HOOK_UNSUPPORTED_OUTPUT",
+    exitStatus: "HOOK_EXIT_STATUS",
+    aggregateLimit: "HOOK_AGGREGATE_LIMIT",
+    continuationExhausted: "HOOK_CONTINUATION_EXHAUSTED",
+    permissionUnavailable: "HOOK_PERMISSION_UNAVAILABLE",
+});
+export const HookRuntimeDiagnosticCodeSchema = z.enum(Object.values(HookRuntimeDiagnosticCodeRegistry));
+const messages = Object.freeze({
+    HOOK_INVALID_PLAN: "Hook execution plan is invalid",
+    HOOK_SELECTED_LIMIT: "Hook execution selection exceeds its bound",
+    HOOK_CANCELLED: "Hook execution was cancelled",
+    HOOK_AUTHORITY_REJECTED: "Hook execution authority rejected the active binding",
+    HOOK_CONFIGURATION_FAILED: "Hook configuration could not be resolved",
+    HOOK_EXECUTABLE_UNAVAILABLE: "Hook executable could not be resolved",
+    HOOK_SPAWN_FAILED: "Hook process could not be started",
+    HOOK_TIMEOUT: "Hook process exceeded its time limit",
+    HOOK_OUTPUT_LIMIT: "Hook output exceeded its bound",
+    HOOK_INVALID_UTF8: "Hook output was not valid UTF-8",
+    HOOK_INVALID_OUTPUT: "Hook output did not match the supported contract",
+    HOOK_UNSUPPORTED_OUTPUT: "Hook output requested an unsupported behavior",
+    HOOK_EXIT_STATUS: "Hook process returned an unsupported status",
+    HOOK_AGGREGATE_LIMIT: "Hook decisions exceeded their aggregate bound",
+    HOOK_CONTINUATION_EXHAUSTED: "Hook continuation budget is exhausted",
+    HOOK_PERMISSION_UNAVAILABLE: "Hook permission could not be confirmed in this mode",
+});
+export const HookRuntimeDiagnosticSchema = z.object({
+    code: HookRuntimeDiagnosticCodeSchema,
+    severity: z.enum(["warning", "error"]),
+    event: HookEventNameSchema,
+    plugin: PluginKeySchema,
+    componentId: ComponentIdSchema,
+    sourceOrder: z.object({ snapshotOrdinal: z.number().int().nonnegative(), hookOrdinal: z.number().int().nonnegative() }).strict().readonly(),
+    message: z.string().min(1),
+}).strict().readonly();
+export function createHookRuntimeDiagnostic(binding, event, code, severity = "error", 
+/** Underlying cause preserved for the failure log; never user-supplied text. */
+detail) {
+    return HookRuntimeDiagnosticSchema.parse({
+        code,
+        severity,
+        event,
+        plugin: binding.plugin,
+        componentId: binding.componentId,
+        sourceOrder: binding.sourceOrder,
+        message: detail === undefined ? messages[code] : `${messages[code]} (${detail})`.slice(0, 512),
+    });
+}
+//# sourceMappingURL=hook-runtime-diagnostic.js.map

package/node_modules/@nklisch/pi-plugins/dist/runtime/hooks/hook-runtime-diagnostic.js.map

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

package/node_modules/@nklisch/pi-plugins/dist/runtime/hooks/stop-continuation-guard.d.ts

@@ -0,0 +1,11 @@
+export interface StopContinuationGuard {
+    state(): Readonly<{
+        stopHookActive: boolean;
+        used: number;
+        remaining: number;
+    }>;
+    request(): "allowed" | "exhausted";
+    settleWithoutContinuation(): void;
+    reset(): void;
+}
+export declare function createStopContinuationGuard(budget?: number): StopContinuationGuard;

package/node_modules/@nklisch/pi-plugins/dist/runtime/hooks/stop-continuation-guard.js

@@ -0,0 +1,27 @@
+import { HOOK_STOP_CONTINUATION_BUDGET } from "../../domain/hook-runtime-limits.js";
+export function createStopContinuationGuard(budget = HOOK_STOP_CONTINUATION_BUDGET) {
+    if (!Number.isSafeInteger(budget) || budget < 0)
+        throw new TypeError("stop continuation budget must be nonnegative");
+    let active = false;
+    let used = 0;
+    const state = () => Object.freeze({ stopHookActive: active, used, remaining: Math.max(0, budget - used) });
+    return Object.freeze({
+        state,
+        request() {
+            if (used >= budget)
+                return "exhausted";
+            used += 1;
+            active = true;
+            return "allowed";
+        },
+        settleWithoutContinuation() {
+            active = false;
+            used = 0;
+        },
+        reset() {
+            active = false;
+            used = 0;
+        },
+    });
+}
+//# sourceMappingURL=stop-continuation-guard.js.map

package/node_modules/@nklisch/pi-plugins/dist/runtime/hooks/stop-continuation-guard.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stop-continuation-guard.js","sourceRoot":"","sources":["../../../src/runtime/hooks/stop-continuation-guard.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,6BAA6B,EAAE,MAAM,qCAAqC,CAAC;AASpF,MAAM,UAAU,2BAA2B,CACzC,MAAM,GAAG,6BAA6B;IAEtC,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,MAAM,GAAG,CAAC;QAAE,MAAM,IAAI,SAAS,CAAC,8CAA8C,CAAC,CAAC;IACrH,IAAI,MAAM,GAAG,KAAK,CAAC;IACnB,IAAI,IAAI,GAAG,CAAC,CAAC;IACb,MAAM,KAAK,GAAG,GAAG,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,cAAc,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC,EAAE,CAAC,CAAC;IAC3G,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,KAAK;QACL,OAAO;YACL,IAAI,IAAI,IAAI,MAAM;gBAAE,OAAO,WAAW,CAAC;YACvC,IAAI,IAAI,CAAC,CAAC;YACV,MAAM,GAAG,IAAI,CAAC;YACd,OAAO,SAAS,CAAC;QACnB,CAAC;QACD,yBAAyB;YACvB,MAAM,GAAG,KAAK,CAAC;YACf,IAAI,GAAG,CAAC,CAAC;QACX,CAAC;QACD,KAAK;YACH,MAAM,GAAG,KAAK,CAAC;YACf,IAAI,GAAG,CAAC,CAAC;QACX,CAAC;KACF,CAAC,CAAC;AACL,CAAC"}

package/node_modules/@nklisch/pi-plugins/dist/runtime/hooks/tool-event-input.d.ts

@@ -0,0 +1,38 @@
+import { z } from "zod";
+import { type CompiledHookSelector, type HookSelectorSubject, type HookToolAliasDefinition } from "../../domain/hook-runtime-contract.js";
+import { type JsonValue } from "../../domain/schema.js";
+import { type HookSessionEvidence, type ForeignHookInput, type HookPiContent } from "./event-contract.js";
+export declare const HookToolIdentitySchema: z.ZodReadonly<z.ZodObject<{
+    piName: z.ZodString;
+    foreignName: z.ZodString;
+    aliases: z.ZodReadonly<z.ZodArray<z.ZodString>>;
+}, z.core.$strict>>;
+export type HookToolIdentity = z.infer<typeof HookToolIdentitySchema>;
+export type HookToolCallEvidence = Readonly<{
+    toolName: string;
+    toolCallId: string;
+    input: JsonValue;
+    signal?: AbortSignal;
+}>;
+export type HookToolResultEvidence = Readonly<{
+    toolName: string;
+    toolCallId: string;
+    input: JsonValue;
+    content: readonly HookPiContent[];
+    details?: unknown;
+    isError: boolean;
+    signal?: AbortSignal;
+}>;
+export declare function createHookToolIdentityResolver(input?: Readonly<{
+    additional: readonly HookToolAliasDefinition[];
+}>): Readonly<{
+    resolve(piName: string): HookToolIdentity;
+}>;
+export declare function buildPreToolUseInput(sessionInput: HookSessionEvidence, evidenceInput: HookToolCallEvidence, identityInput?: HookToolIdentity): Extract<ForeignHookInput, {
+    hook_event_name: "PreToolUse";
+}>;
+export declare function buildPostToolInput(sessionInput: HookSessionEvidence, evidenceInput: HookToolResultEvidence, identityInput?: HookToolIdentity): Extract<ForeignHookInput, {
+    hook_event_name: "PostToolUse" | "PostToolUseFailure";
+}>;
+export declare function subjectForTool(identity: HookToolIdentity, event: "PreToolUse" | "PostToolUse" | "PostToolUseFailure", input: JsonValue, response?: JsonValue): HookSelectorSubject;
+export declare function evaluateHookConditions(selector: CompiledHookSelector, subject: HookSelectorSubject): boolean;

package/node_modules/@nklisch/pi-plugins/dist/runtime/hooks/tool-event-input.js

@@ -0,0 +1,129 @@
+import { z } from "zod";
+import { matchesHookSelector, validateHookToolAliasDefinitions, } from "../../domain/hook-runtime-contract.js";
+import { JsonValueSchema } from "../../domain/schema.js";
+import { HookSessionEvidenceSchema, PreToolUseHookInputSchema, PostToolUseHookInputSchema, PostToolUseFailureHookInputSchema, HookPiContentSchema, cloneJson, } from "./event-contract.js";
+export const HookToolIdentitySchema = z.object({
+    piName: z.string().min(1).max(256),
+    foreignName: z.string().min(1).max(256),
+    aliases: z.array(z.string().min(1).max(256)).min(1).readonly(),
+}).strict().readonly();
+function dedupe(values) {
+    return Object.freeze([...new Set(values)]);
+}
+export function createHookToolIdentityResolver(input = { additional: [] }) {
+    const rows = validateHookToolAliasDefinitions(input.additional);
+    function resolve(piNameInput) {
+        const piName = z.string().min(1).max(256).parse(piNameInput);
+        const row = rows.find((candidate) => candidate.piNames.includes(piName));
+        if (row === undefined)
+            return HookToolIdentitySchema.parse({ piName, foreignName: piName, aliases: [piName] });
+        return HookToolIdentitySchema.parse({ piName, foreignName: row.preferred, aliases: dedupe(row.aliases) });
+    }
+    return Object.freeze({ resolve });
+}
+const defaultToolIdentityResolver = createHookToolIdentityResolver({ additional: [] });
+function jsonObject(value) {
+    if (value === null || Array.isArray(value) || typeof value !== "object")
+        throw new TypeError("tool input must be a JSON object");
+    return cloneJson(value);
+}
+function jsonDetails(value) {
+    const result = JsonValueSchema.safeParse(value);
+    return result.success ? cloneJson(result.data) : undefined;
+}
+function snapshotPiContent(content) {
+    const projected = content.map((item) => {
+        if (item === null || typeof item !== "object")
+            throw new TypeError("tool result content item must be an object");
+        const value = item;
+        if (value.type === "text")
+            return { type: "text", text: z.string().parse(value.text) };
+        if (value.type === "image") {
+            return {
+                type: "image",
+                data: z.string().parse(value.data),
+                mimeType: z.string().min(1).parse(value.mimeType),
+            };
+        }
+        throw new TypeError("unsupported tool result content item");
+    });
+    const validated = HookPiContentSchema.array().parse(projected);
+    return cloneJson(validated);
+}
+function resultText(content) {
+    const text = content.filter((item) => item.type === "text").map((item) => item.text).filter((value) => value.length > 0).join("\n");
+    return text.length === 0 ? undefined : text;
+}
+export function buildPreToolUseInput(sessionInput, evidenceInput, identityInput) {
+    const session = HookSessionEvidenceSchema.parse(sessionInput);
+    const evidence = {
+        toolName: z.string().min(1).max(256).parse(evidenceInput.toolName),
+        toolCallId: z.string().min(1).parse(evidenceInput.toolCallId),
+        input: JsonValueSchema.parse(evidenceInput.input),
+    };
+    const identity = identityInput ?? defaultToolIdentityResolver.resolve(evidence.toolName);
+    return PreToolUseHookInputSchema.parse({
+        session_id: session.sessionId,
+        ...(session.transcriptPath === undefined ? {} : { transcript_path: session.transcriptPath }),
+        cwd: session.cwd,
+        hook_event_name: "PreToolUse",
+        tool_name: identity.foreignName,
+        tool_input: jsonObject(evidence.input),
+        tool_use_id: evidence.toolCallId,
+    });
+}
+export function buildPostToolInput(sessionInput, evidenceInput, identityInput) {
+    const session = HookSessionEvidenceSchema.parse(sessionInput);
+    const evidence = {
+        toolName: z.string().min(1).max(256).parse(evidenceInput.toolName),
+        toolCallId: z.string().min(1).parse(evidenceInput.toolCallId),
+        input: JsonValueSchema.parse(evidenceInput.input),
+        content: evidenceInput.content,
+        details: evidenceInput.details,
+        isError: z.boolean().parse(evidenceInput.isError),
+        signal: evidenceInput.signal,
+    };
+    const content = snapshotPiContent(evidence.content);
+    const response = jsonDetails(evidence.details);
+    const identity = identityInput ?? defaultToolIdentityResolver.resolve(evidence.toolName);
+    const common = {
+        session_id: session.sessionId,
+        ...(session.transcriptPath === undefined ? {} : { transcript_path: session.transcriptPath }),
+        cwd: session.cwd,
+        tool_name: identity.foreignName,
+        tool_input: jsonObject(evidence.input),
+        ...(response === undefined ? {} : { tool_response: response }),
+        tool_use_id: evidence.toolCallId,
+    };
+    const pi = {
+        toolResult: {
+            content,
+            ...(response === undefined ? {} : { details: response }),
+            isError: evidence.isError,
+        },
+    };
+    if (!evidence.isError)
+        return PostToolUseHookInputSchema.parse({ ...common, hook_event_name: "PostToolUse", pi });
+    const error = resultText(content);
+    const interrupted = evidence.signal?.aborted === true;
+    return PostToolUseFailureHookInputSchema.parse({
+        ...common,
+        hook_event_name: "PostToolUseFailure",
+        ...(error === undefined ? {} : { error }),
+        ...(interrupted ? { is_interrupt: true } : {}),
+        pi,
+    });
+}
+export function subjectForTool(identity, event, input, response) {
+    return {
+        event,
+        matcherCandidates: identity.aliases,
+        toolNameAliases: identity.aliases,
+        toolInput: input,
+        ...(response === undefined ? {} : { toolResponse: response }),
+    };
+}
+export function evaluateHookConditions(selector, subject) {
+    return matchesHookSelector(selector, subject);
+}
+//# sourceMappingURL=tool-event-input.js.map

package/node_modules/@nklisch/pi-plugins/dist/runtime/hooks/tool-event-input.js.map

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

package/node_modules/@nklisch/pi-plugins/dist/runtime/mcp/launch-error.d.ts

@@ -0,0 +1,5 @@
+import { McpLaunchContextError, McpLaunchErrorCodes } from "../../application/ports/mcp-launch-context.js";
+import type { ErrorCode } from "../../domain/errors.js";
+/** Classify only typed codes and reason kind/code; native messages are ignored. */
+export declare function classifyMcpLaunchFailure(error: unknown, signal: AbortSignal): ErrorCode;
+export { McpLaunchContextError, McpLaunchErrorCodes };

package/node_modules/@nklisch/pi-plugins/dist/runtime/mcp/launch-error.js

@@ -0,0 +1,29 @@
+import { McpLaunchContextError, McpLaunchErrorCodes, } from "../../application/ports/mcp-launch-context.js";
+function reasonShape(error) {
+    return error !== null && typeof error === "object" ? error : {};
+}
+function isTimeout(error) {
+    const { name, code } = reasonShape(error);
+    return name === "TimeoutError" || code === "ETIMEDOUT" || code === "TIMEOUT" || code === "ERR_TIMEOUT";
+}
+function isCancellation(error) {
+    const { name, code } = reasonShape(error);
+    return name === "AbortError" || code === "ABORT_ERR" || code === "ERR_ABORTED";
+}
+/** Classify only typed codes and reason kind/code; native messages are ignored. */
+export function classifyMcpLaunchFailure(error, signal) {
+    if (signal.aborted) {
+        return isTimeout(signal.reason)
+            ? McpLaunchErrorCodes.timeout
+            : McpLaunchErrorCodes.cancelled;
+    }
+    if (error instanceof McpLaunchContextError)
+        return error.code;
+    if (isTimeout(error))
+        return McpLaunchErrorCodes.timeout;
+    if (isCancellation(error))
+        return McpLaunchErrorCodes.cancelled;
+    return McpLaunchErrorCodes.valueInvalid;
+}
+export { McpLaunchContextError, McpLaunchErrorCodes };
+//# sourceMappingURL=launch-error.js.map