@acpus/runtime 0.6.0 → 0.6.1

package/dist/hooks/journal.js

@@ -0,0 +1,49 @@
+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;
+    }
+}
+//# sourceMappingURL=journal.js.map

package/dist/hooks/journal.js.map

@@ -0,0 +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"}

package/dist/hooks/loader.d.ts

@@ -0,0 +1,41 @@
+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 {
+    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;
+//# sourceMappingURL=loader.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../src/hooks/loader.ts"],"names":[],"mappings":"AAKA,OAAO,EAKL,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;AAyED,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"}

package/dist/hooks/loader.js

@@ -0,0 +1,168 @@
+import { createHash } from "node:crypto";
+import { existsSync, readFileSync } from "node:fs";
+import { homedir } from "node:os";
+import { join, resolve } from "node:path";
+import { parse as parseYaml } from "yaml";
+import { EVENT_NAMES, INJECTOR_NAMES } from "@acpus/core";
+/** Absolute path to the global hooks file (~/.acpus/hooks.yaml). */
+export function globalHookConfigPath() {
+    return join(homedir(), ".acpus", "hooks.yaml");
+}
+/** Absolute path to the project hooks file (<workspace>/.acpus/hooks.yaml). */
+export function projectHookConfigPath(workspace) {
+    return join(resolve(workspace), ".acpus", "hooks.yaml");
+}
+/** True when the config declares no injectors and no events. */
+export function isEmptyHookConfig(config) {
+    const injectorCount = INJECTOR_NAMES.reduce((n, k) => n + (config.injectors?.[k]?.length ?? 0), 0);
+    const eventCount = EVENT_NAMES.reduce((n, k) => n + (config.events?.[k]?.length ?? 0), 0);
+    return injectorCount === 0 && eventCount === 0;
+}
+/**
+ * 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 class HookConfigLoader {
+    workspace;
+    constructor(workspace = process.cwd()) {
+        this.workspace = workspace;
+    }
+    /** Read a single layer; absent or empty files yield an empty config. */
+    loadLayer(path) {
+        if (!existsSync(path))
+            return { path, config: {}, exists: false };
+        const raw = readFileSync(path, "utf8").trim();
+        if (raw.length === 0)
+            return { path, config: {}, exists: true };
+        const parsed = parseYaml(raw);
+        validateHookConfig(parsed, path);
+        return { path, config: parsed, exists: true };
+    }
+    /** Load and merge both layers, returning the merged config plus source paths. */
+    load() {
+        const globalLayer = this.loadLayer(globalHookConfigPath());
+        const projectLayer = this.loadLayer(projectHookConfigPath(this.workspace));
+        const merged = mergeHookConfigs(globalLayer.config, projectLayer.config);
+        return { merged, globalLayer, projectLayer };
+    }
+    /**
+     * Freeze the merged configuration into a snapshot. Returns `undefined` when
+     * both layers are absent/empty so the runtime can skip all hook machinery.
+     */
+    freeze() {
+        const { merged, globalLayer, projectLayer } = this.load();
+        if (isEmptyHookConfig(merged))
+            return undefined;
+        return {
+            hash: hashHookConfig(merged),
+            globalConfigPath: globalLayer.exists ? globalLayer.path : undefined,
+            projectConfigPath: projectLayer.exists ? projectLayer.path : undefined,
+            mergedConfig: merged
+        };
+    }
+}
+/** Validate the minimal command-only hook config shape used by the runtime. */
+function validateHookConfig(config, path) {
+    if (!config || typeof config !== "object" || Array.isArray(config)) {
+        throw new Error(`${path}: hook config must be an object`);
+    }
+    validateGroup(config.injectors, "injectors", path, INJECTOR_NAMES);
+    validateGroup(config.events, "events", path, EVENT_NAMES);
+}
+function validateGroup(group, groupName, path, allowedNames) {
+    for (const [hookName, handlers] of Object.entries(group ?? {})) {
+        if (!allowedNames.includes(hookName)) {
+            throw new Error(`${path}: unknown hook name '${hookName}' in ${groupName}`);
+        }
+        if (!Array.isArray(handlers)) {
+            throw new Error(`${path}: ${groupName}.${hookName} must be an array`);
+        }
+        handlers.forEach((handler, index) => validateHandler(handler, `${path}: ${groupName}.${hookName}[${index}]`, groupName));
+    }
+}
+function validateHandler(handler, label, groupName) {
+    if (!handler || typeof handler !== "object") {
+        throw new Error(`${label} must be an object`);
+    }
+    const h = handler;
+    const allowedFields = groupName === "injectors"
+        ? new Set(["command", "timeout", "env", "cwd", "on_failure"])
+        : new Set(["command", "timeout", "env", "cwd", "sync"]);
+    for (const field of Object.keys(h)) {
+        if (!allowedFields.has(field)) {
+            throw new Error(`${label}.${field} is not supported`);
+        }
+    }
+    if (typeof h.command !== "string" || h.command.length === 0) {
+        throw new Error(`${label}.command must be a non-empty string`);
+    }
+    if ("timeout" in h && typeof h.timeout !== "string") {
+        throw new Error(`${label}.timeout must be a string`);
+    }
+    if ("cwd" in h && typeof h.cwd !== "string") {
+        throw new Error(`${label}.cwd must be a string`);
+    }
+    if ("env" in h && !isStringRecord(h.env)) {
+        throw new Error(`${label}.env must be a string map`);
+    }
+    if (groupName === "injectors") {
+        if ("sync" in h)
+            throw new Error(`${label}.sync is supported only on event handlers`);
+        if ("on_failure" in h && h.on_failure !== "fail" && h.on_failure !== "skip") {
+            throw new Error(`${label}.on_failure must be "fail" or "skip"`);
+        }
+    }
+    else {
+        if ("on_failure" in h)
+            throw new Error(`${label}.on_failure is supported only on injector handlers`);
+        if ("sync" in h && typeof h.sync !== "boolean") {
+            throw new Error(`${label}.sync must be boolean`);
+        }
+    }
+}
+function isStringRecord(value) {
+    return Boolean(value)
+        && typeof value === "object"
+        && !Array.isArray(value)
+        && Object.values(value).every((v) => typeof v === "string");
+}
+/** Concatenate handler arrays per key; global handlers precede project handlers. */
+export function mergeHookConfigs(global, project) {
+    const injectors = {};
+    for (const key of INJECTOR_NAMES) {
+        const combined = [...(global.injectors?.[key] ?? []), ...(project.injectors?.[key] ?? [])];
+        if (combined.length > 0)
+            injectors[key] = combined;
+    }
+    const events = {};
+    for (const key of EVENT_NAMES) {
+        const combined = [...(global.events?.[key] ?? []), ...(project.events?.[key] ?? [])];
+        if (combined.length > 0)
+            events[key] = combined;
+    }
+    const result = {};
+    if (Object.keys(injectors).length > 0)
+        result.injectors = injectors;
+    if (Object.keys(events).length > 0)
+        result.events = events;
+    return result;
+}
+/** Stable "sha256:..." hash over the canonicalized merged configuration. */
+export function hashHookConfig(config) {
+    return `sha256:${createHash("sha256").update(canonicalJson(config)).digest("hex")}`;
+}
+/** Deterministic JSON with object keys sorted recursively. */
+function canonicalJson(value) {
+    if (Array.isArray(value))
+        return `[${value.map(canonicalJson).join(",")}]`;
+    if (value && typeof value === "object") {
+        const entries = Object.entries(value)
+            .filter(([, v]) => v !== undefined)
+            .sort(([a], [b]) => (a < b ? -1 : a > b ? 1 : 0));
+        return `{${entries.map(([k, v]) => `${JSON.stringify(k)}:${canonicalJson(v)}`).join(",")}}`;
+    }
+    return JSON.stringify(value ?? null);
+}
+//# sourceMappingURL=loader.js.map

package/dist/hooks/loader.js.map

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

package/dist/hooks/payload.d.ts

@@ -0,0 +1,17 @@
+import type { AcpusIr, HookPayload, IrNode } from "@acpus/core";
+import type { ExpressionContext, NodeExecutionState, NodeKeyDynamic, RunState } from "../types.js";
+/** Run-scoped fields shared by every payload built during a Run. */
+export interface RunScope {
+    runId: string;
+    workflowName: string;
+    workflowSourcePath: string;
+    workflowSourceDir: string;
+    cwd: string;
+}
+/** Derive the run scope once per Run from the frozen IR and metadata. */
+export declare function runScope(ir: AcpusIr, meta: RunState): RunScope;
+/** Base payload carrying the common fields for any hook event/injector. */
+export declare function basePayload(scope: RunScope, hookEventName: string): HookPayload;
+/** Attach node-level identity and dynamic-context fields to a payload. */
+export declare function withNodeFields(payload: HookPayload, node: IrNode, nodeKey: string, state: NodeExecutionState | undefined, dynamic: NodeKeyDynamic, ctx?: ExpressionContext): HookPayload;
+//# sourceMappingURL=payload.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"payload.d.ts","sourceRoot":"","sources":["../../src/hooks/payload.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAChE,OAAO,KAAK,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAEnG,oEAAoE;AACpE,MAAM,WAAW,QAAQ;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,EAAE,MAAM,CAAC;IACrB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,GAAG,EAAE,MAAM,CAAC;CACb;AAED,yEAAyE;AACzE,wBAAgB,QAAQ,CAAC,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,GAAG,QAAQ,CAS9D;AAED,2EAA2E;AAC3E,wBAAgB,WAAW,CAAC,KAAK,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,GAAG,WAAW,CAU/E;AAED,0EAA0E;AAC1E,wBAAgB,cAAc,CAC5B,OAAO,EAAE,WAAW,EACpB,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,kBAAkB,GAAG,SAAS,EACrC,OAAO,EAAE,cAAc,EACvB,GAAG,CAAC,EAAE,iBAAiB,GACtB,WAAW,CAUb"}

package/dist/hooks/payload.js

@@ -0,0 +1,45 @@
+/** Derive the run scope once per Run from the frozen IR and metadata. */
+export function runScope(ir, meta) {
+    const sourcePath = meta.workflowSourcePath ?? ir.source.path ?? "";
+    return {
+        runId: meta.runId,
+        workflowName: meta.workflowName,
+        workflowSourcePath: sourcePath,
+        workflowSourceDir: sourcePath ? dirnameOf(sourcePath) : "",
+        cwd: process.cwd()
+    };
+}
+/** Base payload carrying the common fields for any hook event/injector. */
+export function basePayload(scope, hookEventName) {
+    return {
+        hook_event_name: hookEventName,
+        run_id: scope.runId,
+        workflow_name: scope.workflowName,
+        workflow_source_path: scope.workflowSourcePath,
+        workflow_source_dir: scope.workflowSourceDir,
+        cwd: scope.cwd,
+        timestamp: new Date().toISOString()
+    };
+}
+/** Attach node-level identity and dynamic-context fields to a payload. */
+export function withNodeFields(payload, node, nodeKey, state, dynamic, ctx) {
+    payload.node_key = nodeKey;
+    payload.node_id = node.id;
+    payload.node_kind = node.kind;
+    if (state?.attempt !== undefined)
+        payload.node_attempt = state.attempt;
+    if (dynamic.loopRound !== undefined)
+        payload.loop_round = dynamic.loopRound;
+    if (dynamic.fanoutItemId !== undefined)
+        payload.fanout_item_id = dynamic.fanoutItemId;
+    if (dynamic.laneId !== undefined)
+        payload.parallel_lane_id = dynamic.laneId;
+    if (ctx?.item_index !== undefined)
+        payload.fanout_item_index = ctx.item_index;
+    return payload;
+}
+function dirnameOf(p) {
+    const idx = p.lastIndexOf("/");
+    return idx > 0 ? p.slice(0, idx) : idx === 0 ? "/" : "";
+}
+//# sourceMappingURL=payload.js.map

package/dist/hooks/payload.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"payload.js","sourceRoot":"","sources":["../../src/hooks/payload.ts"],"names":[],"mappings":"AAYA,yEAAyE;AACzE,MAAM,UAAU,QAAQ,CAAC,EAAW,EAAE,IAAc;IAClD,MAAM,UAAU,GAAG,IAAI,CAAC,kBAAkB,IAAI,EAAE,CAAC,MAAM,CAAC,IAAI,IAAI,EAAE,CAAC;IACnE,OAAO;QACL,KAAK,EAAE,IAAI,CAAC,KAAK;QACjB,YAAY,EAAE,IAAI,CAAC,YAAY;QAC/B,kBAAkB,EAAE,UAAU;QAC9B,iBAAiB,EAAE,UAAU,CAAC,CAAC,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,EAAE;QAC1D,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE;KACnB,CAAC;AACJ,CAAC;AAED,2EAA2E;AAC3E,MAAM,UAAU,WAAW,CAAC,KAAe,EAAE,aAAqB;IAChE,OAAO;QACL,eAAe,EAAE,aAAa;QAC9B,MAAM,EAAE,KAAK,CAAC,KAAK;QACnB,aAAa,EAAE,KAAK,CAAC,YAAY;QACjC,oBAAoB,EAAE,KAAK,CAAC,kBAAkB;QAC9C,mBAAmB,EAAE,KAAK,CAAC,iBAAiB;QAC5C,GAAG,EAAE,KAAK,CAAC,GAAG;QACd,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;KACpC,CAAC;AACJ,CAAC;AAED,0EAA0E;AAC1E,MAAM,UAAU,cAAc,CAC5B,OAAoB,EACpB,IAAY,EACZ,OAAe,EACf,KAAqC,EACrC,OAAuB,EACvB,GAAuB;IAEvB,OAAO,CAAC,QAAQ,GAAG,OAAO,CAAC;IAC3B,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC,EAAE,CAAC;IAC1B,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC;IAC9B,IAAI,KAAK,EAAE,OAAO,KAAK,SAAS;QAAE,OAAO,CAAC,YAAY,GAAG,KAAK,CAAC,OAAO,CAAC;IACvE,IAAI,OAAO,CAAC,SAAS,KAAK,SAAS;QAAE,OAAO,CAAC,UAAU,GAAG,OAAO,CAAC,SAAS,CAAC;IAC5E,IAAI,OAAO,CAAC,YAAY,KAAK,SAAS;QAAE,OAAO,CAAC,cAAc,GAAG,OAAO,CAAC,YAAY,CAAC;IACtF,IAAI,OAAO,CAAC,MAAM,KAAK,SAAS;QAAE,OAAO,CAAC,gBAAgB,GAAG,OAAO,CAAC,MAAM,CAAC;IAC5E,IAAI,GAAG,EAAE,UAAU,KAAK,SAAS;QAAE,OAAO,CAAC,iBAAiB,GAAG,GAAG,CAAC,UAAU,CAAC;IAC9E,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,SAAS,SAAS,CAAC,CAAS;IAC1B,MAAM,GAAG,GAAG,CAAC,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;IAC/B,OAAO,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;AAC1D,CAAC"}

package/dist/hooks/runner.d.ts

@@ -0,0 +1,42 @@
+import { type EventName, type HookConfig, type InjectorHookHandler, type HookPayload, type InjectorName, type InjectorResult } from "@acpus/core";
+/**
+ * Thrown when an injector handler fails under the `on_failure: "fail"` policy.
+ * The interpreter maps this to a node failure with `failureKind: "hook_failure"`.
+ */
+export declare class HookFailureError extends Error {
+    constructor(message: string);
+}
+/**
+ * Executes hook command handlers. Injectors run sequentially and may fail the
+ * node; events never affect outcome. The runner holds the frozen, merged
+ * configuration for a single Run.
+ */
+export declare class HookRunner {
+    private readonly config;
+    constructor(config: HookConfig);
+    hasInjector(name: InjectorName): boolean;
+    hasEvent(name: EventName): boolean;
+    injectorHandlers(name: InjectorName): InjectorHookHandler[];
+    /**
+     * Run all handlers for an injector sequentially, merging their results.
+     * `prependPrompt` is concatenated in order for beforeAgentExec; `env` maps
+     * merge with later handlers overriding earlier ones for beforeProgramExec.
+     * A failing handler under `fail` throws
+     * HookFailureError; under `skip` it logs a warning and injects nothing.
+     *
+     * `onHandler` is called once per handler with the resolved per-handler result
+     * (for journaling).
+     */
+    runInjector(name: InjectorName, payload: HookPayload, onHandler?: (handlerIndex: number, result: InjectorResult, durationMs: number) => void): Promise<InjectorResult>;
+    /**
+     * Fire all handlers for an event. Event handlers are async by default;
+     * `sync: true` handlers are awaited. Event handlers never throw and never
+     * affect Run/Node outcome — failures are logged as warnings.
+     */
+    emitEvent(name: EventName, payload: HookPayload): Promise<void>;
+    private runHandler;
+    private runCommand;
+    /** Parse handler stdout as an InjectorResult. Empty output → empty result. */
+    private parseInjectorStdout;
+}
+//# sourceMappingURL=runner.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"runner.d.ts","sourceRoot":"","sources":["../../src/hooks/runner.ts"],"names":[],"mappings":"AACA,OAAO,EAIL,KAAK,SAAS,EACd,KAAK,UAAU,EAEf,KAAK,mBAAmB,EACxB,KAAK,WAAW,EAChB,KAAK,YAAY,EACjB,KAAK,cAAc,EAEpB,MAAM,aAAa,CAAC;AAKrB;;;GAGG;AACH,qBAAa,gBAAiB,SAAQ,KAAK;IACzC,YAAY,OAAO,EAAE,MAAM,EAG1B;CACF;AAWD;;;;GAIG;AACH,qBAAa,UAAU;IACT,OAAO,CAAC,QAAQ,CAAC,MAAM;IAAnC,YAA6B,MAAM,EAAE,UAAU,EAAI;IAEnD,WAAW,CAAC,IAAI,EAAE,YAAY,GAAG,OAAO,CAEvC;IAED,QAAQ,CAAC,IAAI,EAAE,SAAS,GAAG,OAAO,CAEjC;IAED,gBAAgB,CAAC,IAAI,EAAE,YAAY,GAAG,mBAAmB,EAAE,CAE1D;IAED;;;;;;;;;OASG;IACG,WAAW,CACf,IAAI,EAAE,YAAY,EAClB,OAAO,EAAE,WAAW,EACpB,SAAS,CAAC,EAAE,CAAC,YAAY,EAAE,MAAM,EAAE,MAAM,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,KAAK,IAAI,GACrF,OAAO,CAAC,cAAc,CAAC,CA6CzB;IAED;;;;OAIG;IACG,SAAS,CAAC,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAepE;YAGa,UAAU;YAUV,UAAU;IA8BxB,8EAA8E;IAC9E,OAAO,CAAC,mBAAmB;CAU5B"}

package/dist/hooks/runner.js

@@ -0,0 +1,161 @@
+import { execa } from "execa";
+import { parseDurationMs } from "@acpus/core";
+const DEFAULT_INJECTOR_TIMEOUT_MS = 5_000;
+const DEFAULT_EVENT_TIMEOUT_MS = 30_000;
+/**
+ * Thrown when an injector handler fails under the `on_failure: "fail"` policy.
+ * The interpreter maps this to a node failure with `failureKind: "hook_failure"`.
+ */
+export class HookFailureError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "HookFailureError";
+    }
+}
+/**
+ * Executes hook command handlers. Injectors run sequentially and may fail the
+ * node; events never affect outcome. The runner holds the frozen, merged
+ * configuration for a single Run.
+ */
+export class HookRunner {
+    config;
+    constructor(config) {
+        this.config = config;
+    }
+    hasInjector(name) {
+        return (this.config.injectors?.[name]?.length ?? 0) > 0;
+    }
+    hasEvent(name) {
+        return (this.config.events?.[name]?.length ?? 0) > 0;
+    }
+    injectorHandlers(name) {
+        return this.config.injectors?.[name] ?? [];
+    }
+    /**
+     * Run all handlers for an injector sequentially, merging their results.
+     * `prependPrompt` is concatenated in order for beforeAgentExec; `env` maps
+     * merge with later handlers overriding earlier ones for beforeProgramExec.
+     * A failing handler under `fail` throws
+     * HookFailureError; under `skip` it logs a warning and injects nothing.
+     *
+     * `onHandler` is called once per handler with the resolved per-handler result
+     * (for journaling).
+     */
+    async runInjector(name, payload, onHandler) {
+        const handlers = this.injectorHandlers(name);
+        const contexts = [];
+        let env;
+        for (let i = 0; i < handlers.length; i++) {
+            const handler = handlers[i];
+            const started = Date.now();
+            const outcome = await this.runHandler(handler, payload, DEFAULT_INJECTOR_TIMEOUT_MS, true);
+            const durationMs = Date.now() - started;
+            if (!outcome.ok) {
+                const policy = handler.on_failure ?? "fail";
+                if (policy === "fail") {
+                    throw new HookFailureError(`Injector '${name}' handler #${i} failed: ${outcome.error ?? "unknown error"}`);
+                }
+                console.warn(`Injector '${name}' handler #${i} failed (skipped): ${outcome.error ?? "unknown error"}`);
+                onHandler?.(i, {}, durationMs);
+                continue;
+            }
+            const result = outcome.result ?? {};
+            if (name === "beforeAgentExec") {
+                const agentResult = result;
+                if (typeof agentResult.prependPrompt === "string" && agentResult.prependPrompt.length > 0) {
+                    contexts.push(agentResult.prependPrompt);
+                }
+            }
+            if (name === "beforeProgramExec") {
+                const programResult = result;
+                if (programResult.env && Object.keys(programResult.env).length > 0) {
+                    env = { ...(env ?? {}), ...programResult.env };
+                }
+            }
+            onHandler?.(i, result, durationMs);
+        }
+        if (name === "beforeAgentExec") {
+            const merged = {};
+            if (contexts.length > 0)
+                merged.prependPrompt = contexts.join("\n");
+            return merged;
+        }
+        const merged = {};
+        if (env)
+            merged.env = env;
+        return merged;
+    }
+    /**
+     * Fire all handlers for an event. Event handlers are async by default;
+     * `sync: true` handlers are awaited. Event handlers never throw and never
+     * affect Run/Node outcome — failures are logged as warnings.
+     */
+    async emitEvent(name, payload) {
+        const handlers = this.config.events?.[name] ?? [];
+        for (let i = 0; i < handlers.length; i++) {
+            const handler = handlers[i];
+            const run = this.runHandler(handler, payload, DEFAULT_EVENT_TIMEOUT_MS, false)
+                .then((outcome) => {
+                if (!outcome.ok) {
+                    console.warn(`Event '${name}' handler #${i} failed (ignored): ${outcome.error ?? "unknown error"}`);
+                }
+            })
+                .catch((error) => {
+                console.warn(`Event '${name}' handler #${i} threw (ignored): ${error instanceof Error ? error.message : String(error)}`);
+            });
+            if (handler.sync)
+                await run;
+        }
+    }
+    /** Dispatch a single command handler. `parseResult` only for injectors. */
+    async runHandler(handler, payload, defaultTimeoutMs, parseResult) {
+        const timeoutMs = handler.timeout ? parseDurationMs(handler.timeout) || defaultTimeoutMs : defaultTimeoutMs;
+        return this.runCommand(handler, payload, timeoutMs, parseResult);
+    }
+    async runCommand(handler, payload, timeoutMs, parseResult) {
+        try {
+            const result = await execa(handler.command, {
+                shell: true,
+                cwd: handler.cwd ?? process.cwd(),
+                timeout: timeoutMs > 0 ? timeoutMs : undefined,
+                reject: false,
+                input: JSON.stringify(payload),
+                env: handler.env
+                    ? { ...Object.fromEntries(Object.entries(process.env).filter(([, v]) => v !== undefined)), ...handler.env }
+                    : undefined
+            });
+            if (result.timedOut) {
+                return { ok: false, error: `timed out after ${timeoutMs}ms` };
+            }
+            if ((result.exitCode ?? 0) !== 0) {
+                return { ok: false, error: `exit code ${result.exitCode}: ${stderrTail(result.stderr)}` };
+            }
+            if (!parseResult)
+                return { ok: true };
+            return this.parseInjectorStdout(result.stdout ?? "");
+        }
+        catch (error) {
+            return { ok: false, error: error instanceof Error ? error.message : String(error) };
+        }
+    }
+    /** Parse handler stdout as an InjectorResult. Empty output → empty result. */
+    parseInjectorStdout(raw) {
+        const trimmed = raw.trim();
+        if (trimmed.length === 0)
+            return { ok: true, result: {} };
+        try {
+            const parsed = JSON.parse(trimmed);
+            return { ok: true, result: parsed ?? {} };
+        }
+        catch {
+            return { ok: false, error: "stdout is not valid JSON" };
+        }
+    }
+}
+/** Last few lines of stderr for a concise failure summary. */
+function stderrTail(stderr) {
+    if (!stderr)
+        return "";
+    return stderr.replace(/\s+$/u, "").split(/\r?\n/u).slice(-5).join("\n");
+}
+//# sourceMappingURL=runner.js.map

package/dist/hooks/runner.js.map

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

package/dist/index.d.ts

@@ -22,4 +22,8 @@ export { ensureWorkspaceSupervisor } from "./supervisor-discovery.js";
 export { RunSupervisorClient, ForkRejectedError } from "./client.js";
 export { planForkedRun, materializeForkedRun, ForkError } from "./fork.js";
 export type { ForkPlan, BoundaryReason, PlanForkedRunOptions, MaterializeForkOptions, MaterializeForkedRunOptions, MaterializedFork } from "./fork.js";
+export { HookConfigLoader, mergeHookConfigs, hashHookConfig, isEmptyHookConfig, globalHookConfigPath, projectHookConfigPath } from "./hooks/loader.js";
+export type { LoadedLayer } from "./hooks/loader.js";
+export { HookRunner, HookFailureError } from "./hooks/runner.js";
+export { HookJournal } from "./hooks/journal.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,YAAY,EACV,SAAS,EACT,SAAS,EACT,cAAc,EACd,kBAAkB,EAClB,QAAQ,EACR,UAAU,EACV,aAAa,EACb,iBAAiB,EACjB,cAAc,EACd,WAAW,EACX,kBAAkB,EAClB,UAAU,EACV,gBAAgB,EAChB,kBAAkB,EAClB,gBAAgB,EAChB,eAAe,EACf,UAAU,EACV,YAAY,EACZ,cAAc,EACd,YAAY,EACZ,cAAc,EACd,kBAAkB,EAClB,iBAAiB,EACjB,eAAe,EACf,0BAA0B,EAC1B,cAAc,EACd,sBAAsB,EACtB,mBAAmB,EACnB,qBAAqB,EACrB,cAAc,EACf,MAAM,YAAY,CAAC;AAGpB,YAAY,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAG9E,OAAO,EACL,cAAc,EACd,YAAY,EACZ,qBAAqB,EACrB,kBAAkB,EAClB,uBAAuB,EACvB,uBAAuB,EACvB,iBAAiB,EACjB,kBAAkB,EAClB,mBAAmB,EACpB,MAAM,WAAW,CAAC;AACnB,YAAY,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAG/C,OAAO,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AACrD,OAAO,EAAE,yBAAyB,EAAE,uBAAuB,EAAE,oBAAoB,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AAGzI,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAGtC,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,UAAU,EAAE,sBAAsB,EAAE,mBAAmB,EAAE,4BAA4B,EAAE,6BAA6B,EAAE,MAAM,oBAAoB,CAAC;AACrL,OAAO,EAAE,aAAa,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAGlE,OAAO,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AACnE,YAAY,EAAE,uBAAuB,EAAE,MAAM,gBAAgB,CAAC;AAG9D,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAGvD,OAAO,EAAE,sBAAsB,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAC5E,YAAY,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AACvD,OAAO,EAAE,4BAA4B,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAG3F,OAAO,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AAClE,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAGrD,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAC5D,OAAO,EAAE,yBAAyB,EAAE,MAAM,2BAA2B,CAAC;AAGtE,OAAO,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAGrE,OAAO,EAAE,aAAa,EAAE,oBAAoB,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAC3E,YAAY,EACV,QAAQ,EACR,cAAc,EACd,oBAAoB,EACpB,sBAAsB,EACtB,2BAA2B,EAC3B,gBAAgB,EACjB,MAAM,WAAW,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,YAAY,EACV,SAAS,EACT,SAAS,EACT,cAAc,EACd,kBAAkB,EAClB,QAAQ,EACR,UAAU,EACV,aAAa,EACb,iBAAiB,EACjB,cAAc,EACd,WAAW,EACX,kBAAkB,EAClB,UAAU,EACV,gBAAgB,EAChB,kBAAkB,EAClB,gBAAgB,EAChB,eAAe,EACf,UAAU,EACV,YAAY,EACZ,cAAc,EACd,YAAY,EACZ,cAAc,EACd,kBAAkB,EAClB,iBAAiB,EACjB,eAAe,EACf,0BAA0B,EAC1B,cAAc,EACd,sBAAsB,EACtB,mBAAmB,EACnB,qBAAqB,EACrB,cAAc,EACf,MAAM,YAAY,CAAC;AAGpB,YAAY,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAG9E,OAAO,EACL,cAAc,EACd,YAAY,EACZ,qBAAqB,EACrB,kBAAkB,EAClB,uBAAuB,EACvB,uBAAuB,EACvB,iBAAiB,EACjB,kBAAkB,EAClB,mBAAmB,EACpB,MAAM,WAAW,CAAC;AACnB,YAAY,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAG/C,OAAO,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AACrD,OAAO,EAAE,yBAAyB,EAAE,uBAAuB,EAAE,oBAAoB,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AAGzI,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAGtC,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,UAAU,EAAE,sBAAsB,EAAE,mBAAmB,EAAE,4BAA4B,EAAE,6BAA6B,EAAE,MAAM,oBAAoB,CAAC;AACrL,OAAO,EAAE,aAAa,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAGlE,OAAO,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AACnE,YAAY,EAAE,uBAAuB,EAAE,MAAM,gBAAgB,CAAC;AAG9D,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAGvD,OAAO,EAAE,sBAAsB,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAC5E,YAAY,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AACvD,OAAO,EAAE,4BAA4B,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAG3F,OAAO,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AAClE,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAGrD,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAC5D,OAAO,EAAE,yBAAyB,EAAE,MAAM,2BAA2B,CAAC;AAGtE,OAAO,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAGrE,OAAO,EAAE,aAAa,EAAE,oBAAoB,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAC3E,YAAY,EACV,QAAQ,EACR,cAAc,EACd,oBAAoB,EACpB,sBAAsB,EACtB,2BAA2B,EAC3B,gBAAgB,EACjB,MAAM,WAAW,CAAC;AAGnB,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,cAAc,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AACvJ,YAAY,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AACjE,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/index.js

@@ -27,4 +27,8 @@ export { ensureWorkspaceSupervisor } from "./supervisor-discovery.js";
 export { RunSupervisorClient, ForkRejectedError } from "./client.js";
 // ─── Fork ────────────────────────────────────────────────────────
 export { planForkedRun, materializeForkedRun, ForkError } from "./fork.js";
+// ─── Hooks ───────────────────────────────────────────────────────
+export { HookConfigLoader, mergeHookConfigs, hashHookConfig, isEmptyHookConfig, globalHookConfigPath, projectHookConfigPath } from "./hooks/loader.js";
+export { HookRunner, HookFailureError } from "./hooks/runner.js";
+export { HookJournal } from "./hooks/journal.js";
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAqCA,oEAAoE;AACpE,OAAO,EACL,cAAc,EACd,YAAY,EACZ,qBAAqB,EACrB,kBAAkB,EAClB,uBAAuB,EACvB,uBAAuB,EACvB,iBAAiB,EACjB,kBAAkB,EAClB,mBAAmB,EACpB,MAAM,WAAW,CAAC;AAGnB,oEAAoE;AACpE,OAAO,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AACrD,OAAO,EAAE,yBAAyB,EAAE,uBAAuB,EAAE,oBAAoB,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AAEzI,oEAAoE;AACpE,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAEtC,oEAAoE;AACpE,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,UAAU,EAAE,sBAAsB,EAAE,mBAAmB,EAAE,4BAA4B,EAAE,6BAA6B,EAAE,MAAM,oBAAoB,CAAC;AACrL,OAAO,EAAE,aAAa,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAElE,oEAAoE;AACpE,OAAO,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAGnE,oEAAoE;AACpE,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAEvD,oEAAoE;AACpE,OAAO,EAAE,sBAAsB,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAE5E,OAAO,EAAE,4BAA4B,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAE3F,oEAAoE;AACpE,OAAO,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AAClE,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAErD,oEAAoE;AACpE,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAC5D,OAAO,EAAE,yBAAyB,EAAE,MAAM,2BAA2B,CAAC;AAEtE,oEAAoE;AACpE,OAAO,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAErE,oEAAoE;AACpE,OAAO,EAAE,aAAa,EAAE,oBAAoB,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAqCA,oEAAoE;AACpE,OAAO,EACL,cAAc,EACd,YAAY,EACZ,qBAAqB,EACrB,kBAAkB,EAClB,uBAAuB,EACvB,uBAAuB,EACvB,iBAAiB,EACjB,kBAAkB,EAClB,mBAAmB,EACpB,MAAM,WAAW,CAAC;AAGnB,oEAAoE;AACpE,OAAO,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AACrD,OAAO,EAAE,yBAAyB,EAAE,uBAAuB,EAAE,oBAAoB,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AAEzI,oEAAoE;AACpE,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAEtC,oEAAoE;AACpE,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,UAAU,EAAE,sBAAsB,EAAE,mBAAmB,EAAE,4BAA4B,EAAE,6BAA6B,EAAE,MAAM,oBAAoB,CAAC;AACrL,OAAO,EAAE,aAAa,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAElE,oEAAoE;AACpE,OAAO,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAGnE,oEAAoE;AACpE,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAEvD,oEAAoE;AACpE,OAAO,EAAE,sBAAsB,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAE5E,OAAO,EAAE,4BAA4B,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAE3F,oEAAoE;AACpE,OAAO,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AAClE,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAErD,oEAAoE;AACpE,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAC5D,OAAO,EAAE,yBAAyB,EAAE,MAAM,2BAA2B,CAAC;AAEtE,oEAAoE;AACpE,OAAO,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAErE,oEAAoE;AACpE,OAAO,EAAE,aAAa,EAAE,oBAAoB,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAU3E,oEAAoE;AACpE,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,cAAc,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAEvJ,OAAO,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AACjE,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC"}