@nklisch/pi-enhanced 0.1.0

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

@@ -0,0 +1,248 @@
+import { ContentDigestSchema } from "../../domain/content-manifest.js";
+import { HookComponentSchema, } from "../../domain/components.js";
+import { compileHookSelector, matchesHookSelector, } from "../../domain/hook-runtime-contract.js";
+import { PluginKeySchema } from "../../domain/identity.js";
+import { ProjectionRootRefSchema, PluginContentRefSchema, PluginDataRefSchema, } from "../../domain/state/references.js";
+import { ScopeReferenceSchema } from "../../domain/state/scope.js";
+import { CurrentProjectRuntimeContextSchema } from "../../application/ports/project-trust.js";
+import { HookCancellationSchema, HookEventPlanSchema, HookSessionEvidenceSchema, } from "./event-contract.js";
+import { buildCompactSessionStartInput, buildPostCompactInput, buildPreCompactInput, buildSessionEndInput, buildSessionStartInput, buildStopInput, buildSubagentStartInput, buildSubagentStopInput, buildUserPromptSubmitInput, compactTrigger, } from "./event-input.js";
+import { buildPostToolInput, buildPreToolUseInput, createHookToolIdentityResolver, subjectForTool, } from "./tool-event-input.js";
+function canonicalize(value) {
+    if (Array.isArray(value))
+        return value.map(canonicalize);
+    if (value !== null && typeof value === "object") {
+        const record = value;
+        return Object.fromEntries(Object.keys(record).sort().map((key) => [key, canonicalize(record[key])]));
+    }
+    return value;
+}
+function sameJson(left, right) {
+    return JSON.stringify(canonicalize(left)) === JSON.stringify(canonicalize(right));
+}
+function abortSignal(value) {
+    return value !== null && typeof value === "object" && typeof value.aborted === "boolean" && typeof value.addEventListener === "function";
+}
+function cancellation(signal, absent) {
+    if (signal !== undefined && abortSignal(signal))
+        return HookCancellationSchema.parse({ kind: "available", signal, abortedAtPlanning: signal.aborted });
+    return HookCancellationSchema.parse({ kind: "unavailable", reason: absent });
+}
+function persistence(session) {
+    return session.transcriptPath === undefined ? "ephemeral" : "persisted";
+}
+function failure(code, snapshot, component) {
+    return {
+        kind: "failed",
+        code,
+        ...(snapshot === undefined ? {} : { plugin: PluginKeySchema.parse(snapshot.plugin) }),
+        ...(component === undefined ? {} : { componentId: component.id }),
+    };
+}
+function verifySnapshot(snapshot, session, piTrusted) {
+    try {
+        if (snapshot.schemaVersion !== 1)
+            return failure("PROJECTION_MISMATCH", snapshot);
+        ScopeReferenceSchema.parse(snapshot.scope);
+        PluginKeySchema.parse(snapshot.plugin);
+        ContentDigestSchema.parse(snapshot.revision);
+        ContentDigestSchema.parse(snapshot.projectionDigest);
+        ProjectionRootRefSchema.parse(snapshot.projectionRef);
+        ContentDigestSchema.parse(snapshot.contributionDigest);
+        CurrentProjectRuntimeContextSchema.parse(snapshot.currentProject);
+        if (!sameJson(snapshot.currentProject, session.currentProject))
+            return failure("CURRENT_PROJECT_MISMATCH", snapshot);
+        if (snapshot.content.kind !== "plugin" || typeof snapshot.content.root !== "string" || snapshot.content.root.length === 0)
+            return failure("PROJECTION_MISMATCH", snapshot);
+        PluginContentRefSchema.parse(snapshot.content.contentRef);
+        PluginDataRefSchema.parse(snapshot.data.dataRef);
+        if (snapshot.data.root.length === 0 || snapshot.data.plugin !== snapshot.plugin || snapshot.data.scope.kind !== snapshot.scope.kind || (snapshot.scope.kind === "project" && snapshot.data.scope.kind === "project" && snapshot.data.scope.projectKey !== snapshot.scope.projectKey))
+            return failure("PROJECTION_MISMATCH", snapshot);
+        if (snapshot.scope.kind === "project") {
+            if (snapshot.scope.projectKey !== session.currentProject.projectKey)
+                return failure("PROJECT_SCOPE_MISMATCH", snapshot);
+            if (session.currentProject.trust.kind !== "trusted")
+                return failure("PROJECT_UNTRUSTED", snapshot);
+            if (!piTrusted)
+                return failure("PI_PROJECT_UNTRUSTED", snapshot);
+        }
+        for (const hook of snapshot.hooks)
+            HookComponentSchema.parse(hook);
+        return undefined;
+    }
+    catch {
+        return failure("PROJECTION_MISMATCH", snapshot);
+    }
+}
+function plannedHook(snapshot, component, snapshotOrdinal, hookOrdinal) {
+    return {
+        sourceOrder: { snapshotOrdinal, hookOrdinal },
+        scope: ScopeReferenceSchema.parse(snapshot.scope),
+        plugin: PluginKeySchema.parse(snapshot.plugin),
+        revision: ContentDigestSchema.parse(snapshot.revision),
+        projectionDigest: ContentDigestSchema.parse(snapshot.projectionDigest),
+        contributionDigest: ContentDigestSchema.parse(snapshot.contributionDigest),
+        component: HookComponentSchema.parse(component),
+        pluginRoot: snapshot.content.root,
+        pluginDataRoot: snapshot.data.root,
+    };
+}
+function subjectForEvent(event, value) {
+    return { event, ...(value === undefined ? {} : { matcherCandidates: [value] }) };
+}
+function freezePlan(plan) {
+    Object.freeze(plan.input);
+    Object.freeze(plan.hooks);
+    Object.freeze(plan);
+    return plan;
+}
+export function createHookEventPlanner(input) {
+    if (input === null || typeof input !== "object" || input.catalog === undefined)
+        throw new TypeError("hook planner requires a runtime catalog");
+    const catalog = input.catalog;
+    if (typeof catalog.list !== "function" || typeof catalog.get !== "function")
+        throw new TypeError("hook planner requires a verified runtime catalog");
+    const tools = createHookToolIdentityResolver({ additional: input.additionalToolAliases ?? [] });
+    function catalogSnapshots(session) {
+        let snapshots;
+        try {
+            snapshots = catalog.list();
+        }
+        catch {
+            return { error: failure("CATALOG_UNAVAILABLE") };
+        }
+        if (!Array.isArray(snapshots))
+            return { error: failure("CATALOG_UNAVAILABLE") };
+        for (const snapshot of snapshots) {
+            const invalid = verifySnapshot(snapshot, session, session.piProjectTrusted);
+            if (invalid !== undefined)
+                return { error: invalid };
+        }
+        return { snapshots };
+    }
+    function select(event, session, subject) {
+        const checked = catalogSnapshots(session);
+        if ("error" in checked)
+            return checked.error;
+        const selected = [];
+        for (const [snapshotOrdinal, snapshot] of checked.snapshots.entries()) {
+            for (const [hookOrdinal, component] of snapshot.hooks.entries()) {
+                const compiled = compileHookSelector(component);
+                if (compiled.kind === "incompatible")
+                    return failure("SELECTOR_RECOMPILATION_MISMATCH", snapshot, component);
+                if (compiled.selector.event !== event)
+                    continue;
+                if (matchesHookSelector(compiled.selector, subject))
+                    selected.push(plannedHook(snapshot, component, snapshotOrdinal, hookOrdinal));
+            }
+        }
+        return selected;
+    }
+    function makePlan(event, inputValue, session, subject, cancellationValue) {
+        const selected = select(event, session, subject);
+        if ("kind" in selected)
+            return selected;
+        try {
+            const plan = HookEventPlanSchema.parse({ schemaVersion: 1, event, input: inputValue, cancellation: cancellationValue, hooks: selected });
+            return { kind: "ready", plans: Object.freeze([freezePlan(plan)]) };
+        }
+        catch {
+            return failure("INVALID_REQUEST");
+        }
+    }
+    function hasMatchingSubagentHooks(event, agentType) {
+        if (typeof agentType !== "string" || agentType.length === 0)
+            return true;
+        let snapshots;
+        try {
+            snapshots = catalog.list();
+        }
+        catch {
+            return true;
+        }
+        if (!Array.isArray(snapshots))
+            return true;
+        for (const snapshot of snapshots) {
+            for (const component of snapshot.hooks) {
+                const compiled = compileHookSelector(component);
+                if (compiled.kind === "incompatible")
+                    return true;
+                if (compiled.selector.event === event && matchesHookSelector(compiled.selector, subjectForEvent(event, agentType))) {
+                    return true;
+                }
+            }
+        }
+        return false;
+    }
+    function plan(request) {
+        try {
+            const session = HookSessionEvidenceSchema.parse(request.session);
+            switch (request.kind) {
+                case "session-start": {
+                    const inputValue = buildSessionStartInput(session, request.reason, persistence(session));
+                    return makePlan("SessionStart", inputValue, session, subjectForEvent("SessionStart", inputValue.source), cancellation(undefined, "session-boundary"));
+                }
+                case "session-end": {
+                    const inputValue = buildSessionEndInput(session, request.reason, persistence(session));
+                    return makePlan("SessionEnd", inputValue, session, subjectForEvent("SessionEnd"), cancellation(undefined, "session-boundary"));
+                }
+                case "input": {
+                    const inputValue = buildUserPromptSubmitInput(session, request.text, request.source, request.streamingBehavior, persistence(session));
+                    return makePlan("UserPromptSubmit", inputValue, session, subjectForEvent("UserPromptSubmit"), cancellation(request.signal, "pi-signal-unavailable"));
+                }
+                case "tool-call": {
+                    const identity = tools.resolve(request.evidence.toolName);
+                    const inputValue = buildPreToolUseInput(session, request.evidence, identity);
+                    const subject = subjectForTool(identity, "PreToolUse", request.evidence.input);
+                    return makePlan("PreToolUse", inputValue, session, subject, cancellation(request.evidence.signal, "pi-signal-unavailable"));
+                }
+                case "tool-result": {
+                    const identity = tools.resolve(request.evidence.toolName);
+                    const inputValue = buildPostToolInput(session, request.evidence, identity);
+                    const event = inputValue.hook_event_name;
+                    const response = "tool_response" in inputValue ? inputValue.tool_response : undefined;
+                    const subject = subjectForTool(identity, event, request.evidence.input, response);
+                    return makePlan(event, inputValue, session, subject, cancellation(request.evidence.signal, "pi-signal-unavailable"));
+                }
+                case "before-compact": {
+                    const inputValue = buildPreCompactInput(session, request.reason, request.willRetry, persistence(session));
+                    return makePlan("PreCompact", inputValue, session, subjectForEvent("PreCompact", compactTrigger(request.reason)), cancellation(request.signal, "pi-signal-unavailable"));
+                }
+                case "compact": {
+                    const postInput = buildPostCompactInput(session, request.reason, request.willRetry, request.fromExtension, persistence(session));
+                    const compactStart = buildCompactSessionStartInput(session, request.reason, request.willRetry, request.fromExtension, persistence(session));
+                    const post = makePlan("PostCompact", postInput, session, subjectForEvent("PostCompact", postInput.trigger), cancellation(undefined, "session-boundary"));
+                    if (post.kind === "failed")
+                        return post;
+                    const start = makePlan("SessionStart", compactStart, session, subjectForEvent("SessionStart", "compact"), cancellation(undefined, "session-boundary"));
+                    if (start.kind === "failed")
+                        return start;
+                    return { kind: "ready", plans: Object.freeze([...post.plans, ...start.plans]) };
+                }
+                case "agent-settled": {
+                    const inputValue = buildStopInput(session, request.lastAssistantMessage, request.stopHookActive, persistence(session));
+                    return makePlan("Stop", inputValue, session, subjectForEvent("Stop"), cancellation(undefined, "idle-boundary"));
+                }
+                case "subagent-start": {
+                    if (request.identity.parentSessionId !== session.sessionId)
+                        return failure("INVALID_REQUEST");
+                    const inputValue = buildSubagentStartInput(session, request.identity, request.execution);
+                    return makePlan("SubagentStart", inputValue, session, subjectForEvent("SubagentStart", request.identity.agentType), cancellation(request.signal, "pi-signal-unavailable"));
+                }
+                case "subagent-stop": {
+                    if (request.identity.parentSessionId !== session.sessionId)
+                        return failure("INVALID_REQUEST");
+                    const inputValue = buildSubagentStopInput(session, request.identity, request.execution, request.proposedResult, request.outcome, request.continuationRound, request.maxContinuationRounds);
+                    return makePlan("SubagentStop", inputValue, session, subjectForEvent("SubagentStop", request.identity.agentType), cancellation(request.signal, "pi-signal-unavailable"));
+                }
+                default:
+                    return failure("UNSUPPORTED_EVENT");
+            }
+        }
+        catch {
+            return failure("INVALID_REQUEST");
+        }
+    }
+    return Object.freeze({ plan, hasMatchingSubagentHooks });
+}
+//# sourceMappingURL=hook-event-planner.js.map

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

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

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

@@ -0,0 +1,27 @@
+/**
+ * Debuggability seam for the best-effort hook policy. Infrastructure failures
+ * no longer block prompts, tools, compaction, or subagents, so this append
+ * log is the durable record that a failure happened at all. Every write is
+ * fire-and-forget: logging must never break, delay, or block a hook boundary.
+ */
+export type HookFailurePhase = "planning" | "execution" | "decision";
+export type HookFailureRecord = Readonly<{
+    /** Epoch milliseconds. */
+    at: number;
+    event: string;
+    phase: HookFailurePhase;
+    code: string;
+    plugin?: string;
+    componentId?: string;
+    detail?: string;
+}>;
+export interface HookFailureLog {
+    record(entry: HookFailureRecord): void;
+    readonly file: string;
+}
+export declare function createHookFailureLog(input: Readonly<{
+    file: string;
+    maxBytes?: number;
+    now?: () => number;
+}>): HookFailureLog;
+export declare function createNullHookFailureLog(): HookFailureLog;

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

@@ -0,0 +1,63 @@
+import { appendFile, mkdir, rename, stat } from "node:fs/promises";
+import { dirname } from "node:path";
+const DEFAULT_MAX_BYTES = 512 * 1024;
+const MAX_FIELD = 256;
+function clip(value) {
+    if (value === undefined)
+        return undefined;
+    // Control characters would break the one-record-per-line contract.
+    const clean = value.replace(/[\u0000-\u001f\u007f-\u009f]/gu, "?");
+    return clean.length > MAX_FIELD ? clean.slice(0, MAX_FIELD) : clean;
+}
+function line(entry) {
+    return `${JSON.stringify({
+        at: entry.at,
+        event: clip(entry.event) ?? "unknown",
+        phase: entry.phase,
+        code: clip(entry.code) ?? "UNKNOWN",
+        ...(entry.plugin === undefined ? {} : { plugin: clip(entry.plugin) }),
+        ...(entry.componentId === undefined ? {} : { componentId: clip(entry.componentId) }),
+        ...(entry.detail === undefined ? {} : { detail: clip(entry.detail) }),
+    })}\n`;
+}
+export function createHookFailureLog(input) {
+    if (typeof input.file !== "string" || input.file.length === 0) {
+        throw new TypeError("hook failure log requires a file path");
+    }
+    const maxBytes = input.maxBytes ?? DEFAULT_MAX_BYTES;
+    // Writes chain behind one promise so concurrent boundaries cannot
+    // interleave partial lines. Size is re-checked whenever the bytes appended
+    // since the last check could have crossed the bound, so a long-lived
+    // session still rotates.
+    let tail = Promise.resolve();
+    // Seed at the bound so the first write always measures any pre-existing file.
+    let uncheckedBytes = maxBytes;
+    async function write(text) {
+        try {
+            uncheckedBytes += Buffer.byteLength(text);
+            if (uncheckedBytes >= maxBytes) {
+                uncheckedBytes = 0;
+                const current = await stat(input.file).catch(() => undefined);
+                if (current !== undefined && current.size >= maxBytes) {
+                    await rename(input.file, `${input.file}.1`).catch(() => undefined);
+                }
+            }
+            await mkdir(dirname(input.file), { recursive: true });
+            await appendFile(input.file, text, "utf8");
+        }
+        catch {
+            // The log is observability, not authority; a broken log must be silent.
+        }
+    }
+    return Object.freeze({
+        file: input.file,
+        record(entry) {
+            const stamped = entry.at > 0 ? entry : { ...entry, at: (input.now ?? Date.now)() };
+            tail = tail.then(() => write(line(stamped)));
+        },
+    });
+}
+export function createNullHookFailureLog() {
+    return Object.freeze({ file: "", record() { } });
+}
+//# sourceMappingURL=hook-failure-log.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"hook-failure-log.js","sourceRoot":"","sources":["../../../src/runtime/hooks/hook-failure-log.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AACnE,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AA2BpC,MAAM,iBAAiB,GAAG,GAAG,GAAG,IAAI,CAAC;AACrC,MAAM,SAAS,GAAG,GAAG,CAAC;AAEtB,SAAS,IAAI,CAAC,KAAyB;IACrC,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IAC1C,mEAAmE;IACnE,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,gCAAgC,EAAE,GAAG,CAAC,CAAC;IACnE,OAAO,KAAK,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;AACtE,CAAC;AAED,SAAS,IAAI,CAAC,KAAwB;IACpC,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC;QACvB,EAAE,EAAE,KAAK,CAAC,EAAE;QACZ,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,SAAS;QACrC,KAAK,EAAE,KAAK,CAAC,KAAK;QAClB,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,SAAS;QACnC,GAAG,CAAC,KAAK,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC;QACrE,GAAG,CAAC,KAAK,CAAC,WAAW,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,EAAE,CAAC;QACpF,GAAG,CAAC,KAAK,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC;KACtE,CAAC,IAAI,CAAC;AACT,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,KAInC;IACA,IAAI,OAAO,KAAK,CAAC,IAAI,KAAK,QAAQ,IAAI,KAAK,CAAC,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC9D,MAAM,IAAI,SAAS,CAAC,uCAAuC,CAAC,CAAC;IAC/D,CAAC;IACD,MAAM,QAAQ,GAAG,KAAK,CAAC,QAAQ,IAAI,iBAAiB,CAAC;IACrD,kEAAkE;IAClE,2EAA2E;IAC3E,qEAAqE;IACrE,yBAAyB;IACzB,IAAI,IAAI,GAAkB,OAAO,CAAC,OAAO,EAAE,CAAC;IAC5C,8EAA8E;IAC9E,IAAI,cAAc,GAAG,QAAQ,CAAC;IAE9B,KAAK,UAAU,KAAK,CAAC,IAAY;QAC/B,IAAI,CAAC;YACH,cAAc,IAAI,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;YAC1C,IAAI,cAAc,IAAI,QAAQ,EAAE,CAAC;gBAC/B,cAAc,GAAG,CAAC,CAAC;gBACnB,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;gBAC9D,IAAI,OAAO,KAAK,SAAS,IAAI,OAAO,CAAC,IAAI,IAAI,QAAQ,EAAE,CAAC;oBACtD,MAAM,MAAM,CAAC,KAAK,CAAC,IAAI,EAAE,GAAG,KAAK,CAAC,IAAI,IAAI,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;gBACrE,CAAC;YACH,CAAC;YACD,MAAM,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;YACtD,MAAM,UAAU,CAAC,KAAK,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;QAC7C,CAAC;QAAC,MAAM,CAAC;YACP,wEAAwE;QAC1E,CAAC;IACH,CAAC;IAED,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,MAAM,CAAC,KAAwB;YAC7B,MAAM,OAAO,GAAG,KAAK,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,GAAG,KAAK,EAAE,EAAE,EAAE,CAAC,KAAK,CAAC,GAAG,IAAI,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;YACnF,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;QAC/C,CAAC;KACF,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,wBAAwB;IACtC,OAAO,MAAM,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,MAAM,KAAU,CAAC,EAAE,CAAC,CAAC;AACxD,CAAC"}

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

@@ -0,0 +1,27 @@
+import type { HookHandler, HookShell } from "../../domain/components.js";
+import type { ResolvedConfiguration } from "../../application/resolved-configuration.js";
+import { type PluginLaunchRootValues } from "../plugin-launch-roots.js";
+export type { HookExecutableIdentity } from "../../application/ports/hook-executable-resolver.js";
+export type HookLaunchPathValues = PluginLaunchRootValues;
+export type HookLaunchEnvironment = Readonly<Record<string, string | undefined>>;
+export type HookLaunch = Readonly<{
+    kind: "shell" | "exec";
+    shell?: HookShell;
+    command: string;
+    args: readonly string[];
+    timeoutMs: number;
+    environment: HookLaunchEnvironment;
+}>;
+export type HookTemplateResolutionContext = Readonly<{
+    paths: HookLaunchPathValues;
+    configuration: ResolvedConfiguration;
+    shellForm: boolean;
+}>;
+/**
+ * Resolve only the exact Plugin Host vocabulary. Shell parameter expansion and
+ * command substitution are deliberately left intact as one opaque token so
+ * shell handlers, unlike exec handlers, retain their native semantics.
+ */
+export declare function resolveHookTemplate(template: string, context: HookTemplateResolutionContext): string;
+export declare function resolveHookEnvironment(values: HookLaunchEnvironment, context: HookTemplateResolutionContext): HookLaunchEnvironment;
+export declare function resolveHookLaunch(handler: HookHandler, context: HookTemplateResolutionContext, environment?: HookLaunchEnvironment): HookLaunch;

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

@@ -0,0 +1,98 @@
+import { HOOK_DEFAULT_TIMEOUT_MS, HOOK_MAX_TIMEOUT_MS, } from "../../domain/hook-runtime-limits.js";
+import { isPluginLaunchRootName, } from "../plugin-launch-roots.js";
+function exactToken(body) {
+    return isPluginLaunchRootName(body) ? body : undefined;
+}
+function matchingBrace(value, start) {
+    let depth = 0;
+    for (let index = start; index < value.length - 1; index += 1) {
+        if (value[index] !== "$" || value[index + 1] !== "{")
+            continue;
+        depth += 1;
+        index += 1;
+        for (let cursor = index + 1; cursor < value.length; cursor += 1) {
+            if (value[cursor] === "{")
+                depth += 1;
+            else if (value[cursor] === "}") {
+                depth -= 1;
+                if (depth === 0)
+                    return cursor;
+            }
+        }
+        return -1;
+    }
+    return -1;
+}
+/**
+ * Resolve only the exact Plugin Host vocabulary. Shell parameter expansion and
+ * command substitution are deliberately left intact as one opaque token so
+ * shell handlers, unlike exec handlers, retain their native semantics.
+ */
+export function resolveHookTemplate(template, context) {
+    if (typeof template !== "string")
+        throw new TypeError("hook template must be a string");
+    let result = "";
+    let index = 0;
+    while (index < template.length) {
+        const start = template.indexOf("${", index);
+        if (start < 0) {
+            result += template.slice(index);
+            break;
+        }
+        result += template.slice(index, start);
+        const end = matchingBrace(template, start);
+        if (end < 0) {
+            result += template.slice(start);
+            break;
+        }
+        const raw = template.slice(start, end + 1);
+        const body = template.slice(start + 2, end);
+        const pathKey = exactToken(body);
+        if (pathKey !== undefined) {
+            result += context.paths[pathKey];
+        }
+        else if (/^user_config\.[A-Za-z_][A-Za-z0-9_]*$/.test(body)) {
+            // substitute() owns required/optional configuration semantics and never
+            // exposes a getter for the backing value.
+            result += context.configuration.substitute(raw);
+        }
+        else {
+            result += raw;
+        }
+        index = end + 1;
+    }
+    return result;
+}
+export function resolveHookEnvironment(values, context) {
+    const result = {};
+    for (const key of Object.keys(values).sort()) {
+        const value = values[key];
+        result[key] = value === undefined ? undefined : resolveHookTemplate(value, context);
+    }
+    return Object.freeze(result);
+}
+export function resolveHookLaunch(handler, context, environment = {}) {
+    const timeoutMs = handler.timeoutMs ?? HOOK_DEFAULT_TIMEOUT_MS;
+    if (!Number.isSafeInteger(timeoutMs) || timeoutMs <= 0 || timeoutMs > HOOK_MAX_TIMEOUT_MS) {
+        throw new TypeError("hook timeout is outside the supported range");
+    }
+    const command = resolveHookTemplate(handler.command, context);
+    if (handler.kind === "shell") {
+        return Object.freeze({
+            kind: "shell",
+            ...(handler.shell === undefined ? {} : { shell: handler.shell }),
+            command,
+            args: [],
+            timeoutMs,
+            environment: resolveHookEnvironment(environment, context),
+        });
+    }
+    return Object.freeze({
+        kind: "exec",
+        command,
+        args: Object.freeze(handler.args.map((value) => resolveHookTemplate(value, context))),
+        timeoutMs,
+        environment: resolveHookEnvironment(environment, context),
+    });
+}
+//# sourceMappingURL=hook-launch-contract.js.map

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

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

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

@@ -0,0 +1,18 @@
+import { type ParsedHookDecision } from "../../domain/hook-output-contract.js";
+import type { HookExecutionBinding } from "../../domain/hook-execution-binding.js";
+import type { OrdinaryHookEvent, SubagentHookEvent } from "../../domain/hook-runtime-contract.js";
+import { type HookRuntimeDiagnostic } from "./hook-runtime-diagnostic.js";
+type HookHandlerExecution = Readonly<{
+    binding: HookExecutionBinding;
+    exitCode: number;
+    stdout: Uint8Array;
+    stderr: Uint8Array;
+    stderrTruncated?: boolean;
+}>;
+/** Parse one already-bounded process result while still inside the config callback. */
+export declare function parseHookHandlerOutput(input: Readonly<{
+    event: OrdinaryHookEvent | SubagentHookEvent;
+    execution: HookHandlerExecution;
+    redact(text: string): string;
+}>): ParsedHookDecision | HookRuntimeDiagnostic;
+export type { HookHandlerExecution };