@acpus/runtime 0.8.0 → 0.9.0-alpha.1

package/dist/hooks/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/hooks/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAW,KAAK,MAAM,EAAE,MAAM,YAAY,CAAC;AAElD,eAAO,MAAM,UAAU,0IASb,CAAC;AAEX,MAAM,MAAM,SAAS,GAAG,CAAC,OAAO,UAAU,CAAC,CAAC,MAAM,CAAC,CAAC;AACpD,MAAM,MAAM,UAAU,GAAG,SAAS,GAAG,QAAQ,CAAC;AAE9C,MAAM,MAAM,SAAS,GAAG;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,CAAC;AAEF,MAAM,MAAM,UAAU,GAAG;IACvB,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF,MAAM,MAAM,SAAS,GAAG,OAAO,CAAC,MAAM,CAAC,SAAS,EAAE,UAAU,EAAE,CAAC,CAAC,CAAC;AAEjE,MAAM,MAAM,gBAAgB,GAAG,UAAU,GAAG;IAC1C,KAAK,EAAE,SAAS,CAAC;IACjB,MAAM,EAAE,UAAU,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,eAAe,EAAE,MAAM,CAAC;IACxB,cAAc,EAAE,MAAM,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;CACrB,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC;AAOF,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,SAAS,CAE7D;AAED,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,CAAC,SAAS,EAAE,mBAAmB,EAAE,CAAC,CA2B3F"}

package/dist/hooks/config.js

@@ -0,0 +1,112 @@
+import { err, ok } from "neverthrow";
+export const hookEvents = [
+    "run.started",
+    "run.completed",
+    "run.failed",
+    "run.canceled",
+    "run.awaiting",
+    "node.started",
+    "node.completed",
+    "node.failed",
+];
+const hookEventSet = new Set(hookEvents);
+const allowedHookFields = new Set(["id", "match", "command", "timeout"]);
+const allowedMatchFields = new Set(["workflow", "nodeId", "nodeKey", "kind"]);
+const durationPattern = /^\d+(ms|s|m|h)?$/;
+export function isHookEvent(value) {
+    return hookEventSet.has(value);
+}
+export function validateHooksFile(config) {
+    const errors = [];
+    if (!isRecord(config))
+        return err([{ path: "$", message: "Hooks file must be an object." }]);
+    const output = {};
+    for (const [event, value] of Object.entries(config)) {
+        if (event === "hooks") {
+            errors.push({ path: "$.hooks", message: "Hooks file must be an event map, not a hooks wrapper." });
+            continue;
+        }
+        if (!isHookEvent(event)) {
+            errors.push({ path: `$.${event}`, message: `Unknown hook event '${event}'.` });
+            continue;
+        }
+        if (!Array.isArray(value)) {
+            errors.push({ path: `$.${event}`, message: "Hook event value must be an array." });
+            continue;
+        }
+        const entries = [];
+        for (const [index, entry] of value.entries()) {
+            const parsed = validateHookEntry(entry, event, `$.${event}[${index}]`, errors);
+            if (parsed)
+                entries.push(parsed);
+        }
+        output[event] = entries;
+    }
+    return errors.length > 0 ? err(errors) : ok(output);
+}
+function validateHookEntry(entry, event, path, errors) {
+    if (!isRecord(entry)) {
+        errors.push({ path, message: "Hook entry must be an object." });
+        return undefined;
+    }
+    for (const key of Object.keys(entry)) {
+        if (!allowedHookFields.has(key))
+            errors.push({ path: `${path}.${key}`, message: `Unknown hook field '${key}'.` });
+    }
+    const id = entry.id;
+    if (id !== undefined && (typeof id !== "string" || id.length === 0)) {
+        errors.push({ path: `${path}.id`, message: "Hook id must be a non-empty string." });
+    }
+    if (typeof entry.command !== "string" || entry.command.length === 0) {
+        errors.push({ path: `${path}.command`, message: "Hook command must be a non-empty string." });
+    }
+    const timeout = entry.timeout;
+    if (timeout !== undefined && (typeof timeout !== "string" || !durationPattern.test(timeout))) {
+        errors.push({ path: `${path}.timeout`, message: "Hook timeout must be a duration such as 500ms, 30s, 5m, or 1h." });
+    }
+    const match = validateMatch(entry.match, event, `${path}.match`, errors);
+    if (errors.some(error => error.path === `${path}.command`))
+        return undefined;
+    return {
+        ...(typeof id === "string" ? { id } : {}),
+        ...(match === undefined ? {} : { match }),
+        command: String(entry.command),
+        ...(typeof timeout === "string" ? { timeout } : {}),
+    };
+}
+function validateMatch(match, event, path, errors) {
+    if (match === undefined)
+        return undefined;
+    if (!isRecord(match)) {
+        errors.push({ path, message: "Hook match must be an object." });
+        return undefined;
+    }
+    const output = {};
+    for (const [key, value] of Object.entries(match)) {
+        if (!allowedMatchFields.has(key)) {
+            errors.push({ path: `${path}.${key}`, message: `Unknown hook match field '${key}'.` });
+            continue;
+        }
+        if (event.startsWith("run.") && event !== "run.awaiting" && key !== "workflow") {
+            errors.push({ path: `${path}.${key}`, message: `Match field '${key}' is not valid for ${event}.` });
+            continue;
+        }
+        if (typeof value !== "string") {
+            errors.push({ path: `${path}.${key}`, message: "Hook match value must be a regex string." });
+            continue;
+        }
+        try {
+            new RegExp(value);
+        }
+        catch (error) {
+            errors.push({ path: `${path}.${key}`, message: `Invalid regex: ${error instanceof Error ? error.message : String(error)}` });
+            continue;
+        }
+        output[key] = value;
+    }
+    return output;
+}
+function isRecord(value) {
+    return !!value && typeof value === "object" && !Array.isArray(value);
+}
+//# sourceMappingURL=config.js.map

package/dist/hooks/config.js.map

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

package/dist/hooks/context.d.ts

@@ -0,0 +1,50 @@
+import type { WorkflowIR } from "@acpus/core/ir";
+import { type EvaluationScope } from "../evaluation/evaluator.js";
+import type { SchedulerProjection } from "../scheduler/types.js";
+import type { HookEvent } from "./config.js";
+import type { CommittedRuntimeEventRow } from "./events.js";
+export type HookContext = {
+    event: HookEvent;
+    eventSequence: number;
+    run: {
+        id: string;
+        workflowName: string;
+        workflowPath: string;
+        workspaceDir: string;
+        status: string;
+    };
+    node?: {
+        id: string;
+        key: string;
+        kind: "task" | "agent" | "signal";
+        status: string;
+        output?: unknown;
+        error?: {
+            message: string;
+        };
+        agentPrompt?: string;
+        taskInput?: unknown;
+    };
+    output?: unknown;
+    error?: {
+        message: string;
+    };
+    cancellation?: {
+        reason: string;
+    };
+    signal?: {
+        nodeId: string;
+        nodeKey: string;
+        prompt: string;
+    };
+};
+export declare function buildHookContext(input: {
+    row: CommittedRuntimeEventRow;
+    hookEvent: HookEvent;
+    projection: SchedulerProjection;
+    ir: WorkflowIR;
+    workspaceDir: string;
+    workflowPath: string;
+    baseScope: EvaluationScope;
+}): HookContext;
+//# sourceMappingURL=context.d.ts.map

package/dist/hooks/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../src/hooks/context.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAmC,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAElF,OAAO,EAAgC,KAAK,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAGhG,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AACjE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,aAAa,CAAC;AAE5D,MAAM,MAAM,WAAW,GAAG;IACxB,KAAK,EAAE,SAAS,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;IACtB,GAAG,EAAE;QACH,EAAE,EAAE,MAAM,CAAC;QACX,YAAY,EAAE,MAAM,CAAC;QACrB,YAAY,EAAE,MAAM,CAAC;QACrB,YAAY,EAAE,MAAM,CAAC;QACrB,MAAM,EAAE,MAAM,CAAC;KAChB,CAAC;IACF,IAAI,CAAC,EAAE;QACL,EAAE,EAAE,MAAM,CAAC;QACX,GAAG,EAAE,MAAM,CAAC;QACZ,IAAI,EAAE,MAAM,GAAG,OAAO,GAAG,QAAQ,CAAC;QAClC,MAAM,EAAE,MAAM,CAAC;QACf,MAAM,CAAC,EAAE,OAAO,CAAC;QACjB,KAAK,CAAC,EAAE;YAAE,OAAO,EAAE,MAAM,CAAA;SAAE,CAAC;QAC5B,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,SAAS,CAAC,EAAE,OAAO,CAAC;KACrB,CAAC;IACF,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IAC5B,YAAY,CAAC,EAAE;QAAE,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IAClC,MAAM,CAAC,EAAE;QACP,MAAM,EAAE,MAAM,CAAC;QACf,OAAO,EAAE,MAAM,CAAC;QAChB,MAAM,EAAE,MAAM,CAAC;KAChB,CAAC;CACH,CAAC;AAEF,wBAAgB,gBAAgB,CAAC,KAAK,EAAE;IACtC,GAAG,EAAE,wBAAwB,CAAC;IAC9B,SAAS,EAAE,SAAS,CAAC;IACrB,UAAU,EAAE,mBAAmB,CAAC;IAChC,EAAE,EAAE,UAAU,CAAC;IACf,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,eAAe,CAAC;CAC5B,GAAG,WAAW,CAqCd"}

package/dist/hooks/context.js

@@ -0,0 +1,116 @@
+import { evaluateExpr, renderTemplate } from "../evaluation/evaluator.js";
+import { indexNodes } from "../scheduler/ir-walk.js";
+import { scopeForNodeAttempt } from "../scheduler/scope.js";
+export function buildHookContext(input) {
+    const context = {
+        event: input.hookEvent,
+        eventSequence: input.row.sequence,
+        run: {
+            id: input.row.runId,
+            workflowName: input.ir.name,
+            workflowPath: input.workflowPath,
+            workspaceDir: input.workspaceDir,
+            status: runStatusForEvent(input.hookEvent),
+        },
+    };
+    if (input.hookEvent === "run.completed")
+        return { ...context, output: input.row.payload.output };
+    if (input.hookEvent === "run.failed")
+        return { ...context, error: errorFrom(input.row.payload) };
+    if (input.hookEvent === "run.canceled")
+        return { ...context, cancellation: { reason: stringField(input.row.payload, "reason") ?? "canceled" } };
+    if (input.hookEvent === "run.awaiting") {
+        const nodeKey = stringField(input.row.payload, "nodeKey") ?? input.row.nodeKey ?? "";
+        const wait = input.projection.signalWaits[nodeKey];
+        const nodeId = stringField(input.row.payload, "nodeId") ?? wait?.nodeId ?? "";
+        const node = indexNodes(input.ir.root).get(nodeId);
+        const prompt = stringField(input.row.payload, "renderedPrompt") ?? wait?.renderedPrompt ?? renderSignalPrompt(node, input.baseScope, input.projection, nodeKey);
+        const nodeContext = buildNodeContext(input, nodeKey);
+        return {
+            ...context,
+            ...(nodeContext === undefined ? {} : { node: nodeContext }),
+            signal: { nodeId, nodeKey, prompt },
+        };
+    }
+    if (input.hookEvent.startsWith("node.")) {
+        const nodeKey = stringField(input.row.payload, "nodeKey") ?? input.row.nodeKey;
+        const nodeContext = nodeKey ? buildNodeContext(input, nodeKey) : undefined;
+        return nodeContext ? { ...context, node: nodeContext } : context;
+    }
+    return context;
+}
+function buildNodeContext(input, nodeKey) {
+    const instance = input.projection.instances[nodeKey];
+    const nodeId = instance?.nodeId ?? stringField(input.row.payload, "nodeId");
+    if (!nodeId)
+        return undefined;
+    const node = indexNodes(input.ir.root).get(nodeId);
+    if (!node || !isHookNode(node))
+        return undefined;
+    const scope = scopeForNodeAttempt(input.baseScope, input.projection, nodeKey);
+    const base = {
+        id: node.id,
+        key: nodeKey,
+        kind: node.kind,
+        status: nodeStatusForEvent(input.hookEvent) ?? instance?.status ?? input.projection.signalWaits[nodeKey]?.status ?? "unknown",
+    };
+    if (node.kind === "agent")
+        return { ...base, agentPrompt: renderTemplate(node.run.prompt, scope), ...nodeResultFields(input.hookEvent, input.row.payload) };
+    if (node.kind === "task")
+        return { ...base, taskInput: taskInput(node, scope), ...nodeResultFields(input.hookEvent, input.row.payload) };
+    return { ...base, ...nodeResultFields(input.hookEvent, input.row.payload) };
+}
+function taskInput(node, scope) {
+    return Object.fromEntries(Object.entries(node.run.input).map(([key, expr]) => [key, evaluateExpr(expr, scope)]));
+}
+function renderSignalPrompt(node, baseScope, projection, nodeKey) {
+    if (!node || node.kind !== "signal")
+        return "";
+    return renderTemplate(node.run.prompt, scopeForNodeAttempt(baseScope, projection, nodeKey));
+}
+function nodeResultFields(hookEvent, payload) {
+    return {
+        ...(hookEvent === "node.completed" && payload.output !== undefined ? { output: payload.output } : {}),
+        ...(hookEvent === "node.failed" && payload.error !== undefined ? { error: errorFrom(payload.error) } : {}),
+    };
+}
+function runStatusForEvent(hookEvent) {
+    if (hookEvent === "run.started")
+        return "running";
+    if (hookEvent === "run.awaiting")
+        return "awaiting";
+    if (hookEvent === "run.completed")
+        return "completed";
+    if (hookEvent === "run.failed")
+        return "failed";
+    if (hookEvent === "run.canceled")
+        return "canceled";
+    return "running";
+}
+function nodeStatusForEvent(hookEvent) {
+    if (hookEvent === "node.started")
+        return "running";
+    if (hookEvent === "node.completed")
+        return "completed";
+    if (hookEvent === "node.failed")
+        return "failed";
+    if (hookEvent === "run.awaiting")
+        return "awaiting";
+    return undefined;
+}
+function errorFrom(value) {
+    if (value && typeof value === "object" && !Array.isArray(value)) {
+        const message = value.message ?? value.reason;
+        if (typeof message === "string")
+            return { message };
+    }
+    return { message: value === undefined ? "failed" : String(value) };
+}
+function stringField(value, key) {
+    const found = value[key];
+    return typeof found === "string" ? found : undefined;
+}
+function isHookNode(node) {
+    return node.kind === "agent" || node.kind === "task" || node.kind === "signal";
+}
+//# sourceMappingURL=context.js.map

package/dist/hooks/context.js.map

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

package/dist/hooks/events.d.ts

@@ -0,0 +1,22 @@
+import type { HookEvent } from "./config.js";
+export type CommittedRuntimeEventRow = {
+    runId: string;
+    sequence: number;
+    type: string;
+    nodeKey?: string;
+    payload: Record<string, unknown>;
+    createdAt: string;
+    idempotencyKey: string;
+};
+export declare function mapRuntimeEventToHookEvent(row: CommittedRuntimeEventRow): HookEvent | undefined;
+export declare function decodeCommittedRuntimeEventRow(row: {
+    run_id: string;
+    sequence: number;
+    type: string;
+    node_key: string | null;
+    payload_json: string;
+    created_at: string;
+    idempotency_key: string;
+}): CommittedRuntimeEventRow;
+export declare function decodeRuntimeEventPayload(payloadJson: string, eventType: string): Record<string, unknown>;
+//# sourceMappingURL=events.d.ts.map

package/dist/hooks/events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../../src/hooks/events.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAE7C,MAAM,MAAM,wBAAwB,GAAG;IACrC,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;CACxB,CAAC;AAEF,wBAAgB,0BAA0B,CAAC,GAAG,EAAE,wBAAwB,GAAG,SAAS,GAAG,SAAS,CAU/F;AAED,wBAAgB,8BAA8B,CAAC,GAAG,EAAE;IAClD,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,eAAe,EAAE,MAAM,CAAC;CACzB,GAAG,wBAAwB,CAU3B;AAED,wBAAgB,yBAAyB,CAAC,WAAW,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAOzG"}

package/dist/hooks/events.js

@@ -0,0 +1,41 @@
+import { decodeSchedulerPayload, isSchedulerEventType } from "../scheduler/event-codec.js";
+export function mapRuntimeEventToHookEvent(row) {
+    if (row.type === "frame.started" && row.payload.frameKey === "root" && row.payload.frameKind === "root")
+        return "run.started";
+    if (row.type === "run.completed")
+        return "run.completed";
+    if (row.type === "run.failed")
+        return "run.failed";
+    if (row.type === "run.canceled")
+        return "run.canceled";
+    if (row.type === "instance.completed")
+        return "node.completed";
+    if (row.type === "instance.failed")
+        return "node.failed";
+    if (row.type === "instance.started")
+        return "node.started";
+    if (row.type === "signal.awaiting")
+        return "run.awaiting";
+    return undefined;
+}
+export function decodeCommittedRuntimeEventRow(row) {
+    return {
+        runId: row.run_id,
+        sequence: row.sequence,
+        type: row.type,
+        ...(row.node_key === null ? {} : { nodeKey: row.node_key }),
+        payload: decodeRuntimeEventPayload(row.payload_json, row.type),
+        createdAt: row.created_at,
+        idempotencyKey: row.idempotency_key,
+    };
+}
+export function decodeRuntimeEventPayload(payloadJson, eventType) {
+    const parsed = JSON.parse(payloadJson);
+    if (isSchedulerEventType(eventType)) {
+        return decodeSchedulerPayload(payloadJson, eventType);
+    }
+    if (!parsed || typeof parsed !== "object" || Array.isArray(parsed))
+        return {};
+    return parsed;
+}
+//# sourceMappingURL=events.js.map

package/dist/hooks/events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.js","sourceRoot":"","sources":["../../src/hooks/events.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,sBAAsB,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AAa3F,MAAM,UAAU,0BAA0B,CAAC,GAA6B;IACtE,IAAI,GAAG,CAAC,IAAI,KAAK,eAAe,IAAI,GAAG,CAAC,OAAO,CAAC,QAAQ,KAAK,MAAM,IAAI,GAAG,CAAC,OAAO,CAAC,SAAS,KAAK,MAAM;QAAE,OAAO,aAAa,CAAC;IAC9H,IAAI,GAAG,CAAC,IAAI,KAAK,eAAe;QAAE,OAAO,eAAe,CAAC;IACzD,IAAI,GAAG,CAAC,IAAI,KAAK,YAAY;QAAE,OAAO,YAAY,CAAC;IACnD,IAAI,GAAG,CAAC,IAAI,KAAK,cAAc;QAAE,OAAO,cAAc,CAAC;IACvD,IAAI,GAAG,CAAC,IAAI,KAAK,oBAAoB;QAAE,OAAO,gBAAgB,CAAC;IAC/D,IAAI,GAAG,CAAC,IAAI,KAAK,iBAAiB;QAAE,OAAO,aAAa,CAAC;IACzD,IAAI,GAAG,CAAC,IAAI,KAAK,kBAAkB;QAAE,OAAO,cAAc,CAAC;IAC3D,IAAI,GAAG,CAAC,IAAI,KAAK,iBAAiB;QAAE,OAAO,cAAc,CAAC;IAC1D,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,MAAM,UAAU,8BAA8B,CAAC,GAQ9C;IACC,OAAO;QACL,KAAK,EAAE,GAAG,CAAC,MAAM;QACjB,QAAQ,EAAE,GAAG,CAAC,QAAQ;QACtB,IAAI,EAAE,GAAG,CAAC,IAAI;QACd,GAAG,CAAC,GAAG,CAAC,QAAQ,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,GAAG,CAAC,QAAQ,EAAE,CAAC;QAC3D,OAAO,EAAE,yBAAyB,CAAC,GAAG,CAAC,YAAY,EAAE,GAAG,CAAC,IAAI,CAAC;QAC9D,SAAS,EAAE,GAAG,CAAC,UAAU;QACzB,cAAc,EAAE,GAAG,CAAC,eAAe;KACpC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,yBAAyB,CAAC,WAAmB,EAAE,SAAiB;IAC9E,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,WAAW,CAAc,CAAC;IACpD,IAAI,oBAAoB,CAAC,SAAS,CAAC,EAAE,CAAC;QACpC,OAAO,sBAAsB,CAAC,WAAW,EAAE,SAAS,CAAC,CAAC;IACxD,CAAC;IACD,IAAI,CAAC,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC;QAAE,OAAO,EAAE,CAAC;IAC9E,OAAO,MAAiC,CAAC;AAC3C,CAAC"}

package/dist/hooks/journal.d.ts

@@ -1,20 +1,22 @@
-import type { HookJournalEntry } from "@acpus/core";
-/**
- * Append-only per-Run journal of injector handler invocations.
- *
- * One line of JSON per handler call, storing the full resolved Agent prompt
- * prefix and Program env (not a boolean flag) for audit/observability. Events
- * are never journaled.
- */
-export declare class HookJournal {
-    private readonly path;
-    private sequence;
-    constructor(runDir: string);
-    /** Append one injector record, assigning the next monotonic sequence. */
-    append(entry: Omit<HookJournalEntry, "sequence">): HookJournalEntry;
-    /** Read all journal records in append order. */
-    read(): HookJournalEntry[];
-    /** Highest sequence already on disk (0 when the journal is empty). */
-    private lastSequence;
-}
+import type { HookEvent, HookSource } from "./config.js";
+export type HookJournalStatus = "completed" | "failed" | "timed_out";
+export type HookJournalEntry = {
+    id?: number;
+    runId: string;
+    eventSequence: number;
+    triggerOrder: number;
+    event: HookEvent;
+    source: HookSource;
+    sourcePath: string;
+    handlerId: string;
+    definitionHash: string;
+    nodeKey?: string;
+    status: HookJournalStatus;
+    exitCode?: number;
+    stdout?: string;
+    stderr?: string;
+    durationMs?: number;
+    error?: string;
+    triggeredAt: string;
+};
 //# sourceMappingURL=journal.d.ts.map

package/dist/hooks/journal.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"journal.d.ts","sourceRoot":"","sources":["../../src/hooks/journal.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAEpD;;;;;;GAMG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAS;IAC9B,OAAO,CAAC,QAAQ,CAAS;IAEzB,YAAY,MAAM,EAAE,MAAM,EAGzB;IAED,yEAAyE;IACzE,MAAM,CAAC,KAAK,EAAE,IAAI,CAAC,gBAAgB,EAAE,UAAU,CAAC,GAAG,gBAAgB,CAKlE;IAED,gDAAgD;IAChD,IAAI,IAAI,gBAAgB,EAAE,CAczB;IAED,sEAAsE;IACtE,OAAO,CAAC,YAAY;CAIrB"}
+{"version":3,"file":"journal.d.ts","sourceRoot":"","sources":["../../src/hooks/journal.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzD,MAAM,MAAM,iBAAiB,GAAG,WAAW,GAAG,QAAQ,GAAG,WAAW,CAAC;AAErE,MAAM,MAAM,gBAAgB,GAAG;IAC7B,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,SAAS,CAAC;IACjB,MAAM,EAAE,UAAU,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;IACvB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,iBAAiB,CAAC;IAC1B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;CACrB,CAAC"}

package/dist/hooks/journal.js

@@ -1,49 +1,2 @@
-import { appendFileSync, existsSync, mkdirSync, readFileSync } from "node:fs";
-import { dirname, join } from "node:path";
-/**
- * Append-only per-Run journal of injector handler invocations.
- *
- * One line of JSON per handler call, storing the full resolved Agent prompt
- * prefix and Program env (not a boolean flag) for audit/observability. Events
- * are never journaled.
- */
-export class HookJournal {
-    path;
-    sequence;
-    constructor(runDir) {
-        this.path = join(runDir, "hook-journal.jsonl");
-        this.sequence = this.lastSequence();
-    }
-    /** Append one injector record, assigning the next monotonic sequence. */
-    append(entry) {
-        const full = { sequence: ++this.sequence, ...entry };
-        mkdirSync(dirname(this.path), { recursive: true });
-        appendFileSync(this.path, `${JSON.stringify(full)}\n`, "utf8");
-        return full;
-    }
-    /** Read all journal records in append order. */
-    read() {
-        if (!existsSync(this.path))
-            return [];
-        const entries = [];
-        for (const line of readFileSync(this.path, "utf8").split("\n")) {
-            if (line.trim().length === 0)
-                continue;
-            // appendFileSync is not atomic; a crash mid-append can leave a torn final
-            // line. Skip unparseable lines rather than throwing on the whole journal.
-            try {
-                entries.push(JSON.parse(line));
-            }
-            catch {
-                continue;
-            }
-        }
-        return entries;
-    }
-    /** Highest sequence already on disk (0 when the journal is empty). */
-    lastSequence() {
-        const entries = this.read();
-        return entries.length > 0 ? entries[entries.length - 1].sequence : 0;
-    }
-}
+export {};
 //# sourceMappingURL=journal.js.map

package/dist/hooks/journal.js.map

@@ -1 +1 @@
-{"version":3,"file":"journal.js","sourceRoot":"","sources":["../../src/hooks/journal.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,UAAU,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAC9E,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAG1C;;;;;;GAMG;AACH,MAAM,OAAO,WAAW;IACL,IAAI,CAAS;IACtB,QAAQ,CAAS;IAEzB,YAAY,MAAc;QACxB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,MAAM,EAAE,oBAAoB,CAAC,CAAC;QAC/C,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,YAAY,EAAE,CAAC;IACtC,CAAC;IAED,yEAAyE;IACzE,MAAM,CAAC,KAAyC;QAC9C,MAAM,IAAI,GAAqB,EAAE,QAAQ,EAAE,EAAE,IAAI,CAAC,QAAQ,EAAE,GAAG,KAAK,EAAE,CAAC;QACvE,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACnD,cAAc,CAAC,IAAI,CAAC,IAAI,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QAC/D,OAAO,IAAI,CAAC;IACd,CAAC;IAED,gDAAgD;IAChD,IAAI;QACF,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC;YAAE,OAAO,EAAE,CAAC;QACtC,MAAM,OAAO,GAAuB,EAAE,CAAC;QACvC,KAAK,MAAM,IAAI,IAAI,YAAY,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;YAC/D,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC;gBAAE,SAAS;YACvC,0EAA0E;YAC1E,0EAA0E;YAC1E,IAAI,CAAC;gBACH,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAqB,CAAC,CAAC;YACrD,CAAC;YAAC,MAAM,CAAC;gBACP,SAAS;YACX,CAAC;QACH,CAAC;QACD,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,sEAAsE;IAC9D,YAAY;QAClB,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;QAC5B,OAAO,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;IACvE,CAAC;CACF"}
+{"version":3,"file":"journal.js","sourceRoot":"","sources":["../../src/hooks/journal.ts"],"names":[],"mappings":""}

package/dist/hooks/loader.d.ts

@@ -1,41 +1,35 @@
-import { type HookConfig, type HookConfigSnapshot } from "@acpus/core";
-/** Absolute path to the global hooks file (~/.acpus/hooks.yaml). */
-export declare function globalHookConfigPath(): string;
-/** Absolute path to the project hooks file (<workspace>/.acpus/hooks.yaml). */
-export declare function projectHookConfigPath(workspace: string): string;
-/** True when the config declares no injectors and no events. */
-export declare function isEmptyHookConfig(config: HookConfig): boolean;
-/** A loaded layer, plus its source path when the file existed. */
-export interface LoadedLayer {
+import { type Result } from "neverthrow";
+import { type HooksFile, type HookSource, type HookValidationError, type LoadedHookConfig } from "./config.js";
+export type HookConfigScope = {
+    source: HookSource;
     path: string;
-    config: HookConfig;
-    exists: boolean;
-}
-/**
- * Loads and merges hook configuration from the global and project layers.
- *
- * A missing layer is treated as empty (no error). Merge concatenates handler
- * arrays per key with global handlers ordered before project handlers.
- */
-export declare class HookConfigLoader {
-    private readonly workspace;
-    constructor(workspace?: string);
-    /** Read a single layer; absent or empty files yield an empty config. */
-    loadLayer(path: string): LoadedLayer;
-    /** Load and merge both layers, returning the merged config plus source paths. */
-    load(): {
-        merged: HookConfig;
-        globalLayer: LoadedLayer;
-        projectLayer: LoadedLayer;
-    };
-    /**
-     * Freeze the merged configuration into a snapshot. Returns `undefined` when
-     * both layers are absent/empty so the runtime can skip all hook machinery.
-     */
-    freeze(): HookConfigSnapshot | undefined;
-}
-/** Concatenate handler arrays per key; global handlers precede project handlers. */
-export declare function mergeHookConfigs(global: HookConfig, project: HookConfig): HookConfig;
-/** Stable "sha256:..." hash over the canonicalized merged configuration. */
-export declare function hashHookConfig(config: HookConfig): string;
+    hooks: LoadedHookConfig[];
+};
+export type HookLoadError = {
+    type: "invalid-json";
+    source: HookSource;
+    path: string;
+    message: string;
+} | {
+    type: "invalid-config";
+    source: HookSource;
+    path: string;
+    errors: HookValidationError[];
+} | {
+    type: "read-failed";
+    source: HookSource;
+    path: string;
+    message: string;
+};
+export declare function formatHookLoadError(error: HookLoadError): string;
+export declare function projectHooksPath(workspaceDir: string): string;
+export declare function globalHooksPath(homeDir?: string): string;
+export declare function loadHooksConfig(workspaceDir: string, options?: {
+    homeDir?: string;
+}): Promise<Result<LoadedHookConfig[], HookLoadError>>;
+export declare function loadHooksConfigScopes(workspaceDir: string, options?: {
+    homeDir?: string;
+}): Promise<Result<HookConfigScope[], HookLoadError>>;
+export declare function loadHooksConfigScope(source: HookSource, path: string): Promise<Result<HookConfigScope, HookLoadError>>;
+export declare function flattenHooksFile(file: HooksFile, source: HookSource, sourcePath: string): LoadedHookConfig[];
 //# sourceMappingURL=loader.d.ts.map

package/dist/hooks/loader.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../src/hooks/loader.ts"],"names":[],"mappings":"AAKA,OAAO,EAML,KAAK,UAAU,EACf,KAAK,kBAAkB,EAGxB,MAAM,aAAa,CAAC;AAErB,oEAAoE;AACpE,wBAAgB,oBAAoB,IAAI,MAAM,CAE7C;AAED,+EAA+E;AAC/E,wBAAgB,qBAAqB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAE/D;AAED,gEAAgE;AAChE,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAI7D;AAED,kEAAkE;AAClE,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,UAAU,CAAC;IACnB,MAAM,EAAE,OAAO,CAAC;CACjB;AAED;;;;;GAKG;AACH,qBAAa,gBAAgB;IACf,OAAO,CAAC,QAAQ,CAAC,SAAS;IAAtC,YAA6B,SAAS,GAAE,MAAsB,EAAI;IAElE,wEAAwE;IACxE,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,CAOnC;IAED,iFAAiF;IACjF,IAAI,IAAI;QAAE,MAAM,EAAE,UAAU,CAAC;QAAC,WAAW,EAAE,WAAW,CAAC;QAAC,YAAY,EAAE,WAAW,CAAA;KAAE,CAKlF;IAED;;;OAGG;IACH,MAAM,IAAI,kBAAkB,GAAG,SAAS,CASvC;CACF;AASD,oFAAoF;AACpF,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,UAAU,EAAE,OAAO,EAAE,UAAU,GAAG,UAAU,CAepF;AAED,4EAA4E;AAC5E,wBAAgB,cAAc,CAAC,MAAM,EAAE,UAAU,GAAG,MAAM,CAEzD"}
+{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../src/hooks/loader.ts"],"names":[],"mappings":"AAIA,OAAO,EAAW,KAAK,MAAM,EAAE,MAAM,YAAY,CAAC;AAClD,OAAO,EAAkD,KAAK,SAAS,EAAE,KAAK,UAAU,EAAE,KAAK,mBAAmB,EAAE,KAAK,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAE/J,MAAM,MAAM,eAAe,GAAG;IAC5B,MAAM,EAAE,UAAU,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,gBAAgB,EAAE,CAAC;CAC3B,CAAC;AAEF,MAAM,MAAM,aAAa,GACrB;IAAE,IAAI,EAAE,cAAc,CAAC;IAAC,MAAM,EAAE,UAAU,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GAC3E;IAAE,IAAI,EAAE,gBAAgB,CAAC;IAAC,MAAM,EAAE,UAAU,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,mBAAmB,EAAE,CAAA;CAAE,GAC3F;IAAE,IAAI,EAAE,aAAa,CAAC;IAAC,MAAM,EAAE,UAAU,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AAE/E,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,aAAa,GAAG,MAAM,CAKhE;AAED,wBAAgB,gBAAgB,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAE7D;AAED,wBAAgB,eAAe,CAAC,OAAO,SAAY,GAAG,MAAM,CAE3D;AAED,wBAAsB,eAAe,CAAC,YAAY,EAAE,MAAM,EAAE,OAAO,GAAE;IAAE,OAAO,CAAC,EAAE,MAAM,CAAA;CAAO,GAAG,OAAO,CAAC,MAAM,CAAC,gBAAgB,EAAE,EAAE,aAAa,CAAC,CAAC,CAGlJ;AAED,wBAAsB,qBAAqB,CAAC,YAAY,EAAE,MAAM,EAAE,OAAO,GAAE;IAAE,OAAO,CAAC,EAAE,MAAM,CAAA;CAAO,GAAG,OAAO,CAAC,MAAM,CAAC,eAAe,EAAE,EAAE,aAAa,CAAC,CAAC,CAMvJ;AAED,wBAAsB,oBAAoB,CAAC,MAAM,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,eAAe,EAAE,aAAa,CAAC,CAAC,CAE5H;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,GAAG,gBAAgB,EAAE,CAkB5G"}