@plurnk/plurnk-hooks 1.24.0 → 1.25.0

package/.env.defaults

@@ -7,5 +7,9 @@
 # PLURNK_HOOKS_ARGS=["/absolute/path/to/plurnk-hook.mjs"]
 # Selected events, comma-separated.
 # PLURNK_HOOKS_EVENTS=loop/terminated,loop/proposal,notice/event
-# Delivery deadline, positive ms; expiry terminates the hook, not the loop.
+# Delivery deadline from admission, including queue time; expiry kills the command, not the loop.
 PLURNK_HOOKS_TIMEOUT_MS=30000
+# Maximum simultaneous commands; 1 preserves delivery completion order.
+PLURNK_HOOKS_CONCURRENCY=1
+# Waiting events beyond running commands; excess events are reported, not silently dropped.
+PLURNK_HOOKS_QUEUE_LIMIT=64

package/README.md

@@ -16,18 +16,10 @@ PLURNK_HOOKS_ARGS=["/absolute/path/to/plurnk-hook.mjs"]
 PLURNK_HOOKS_EVENTS=loop/terminated,loop/proposal,notice/event
 ```
 
-`PLURNK_HOOKS_ARGS` is a JSON string array. `PLURNK_HOOKS_EVENTS` is an
-explicit comma-separated selection from:
-
-```text
-log/entry
-loop/proposal
-loop/terminated
-notice/event
-stream/concluded
-stream/event
-workspace/created
-```
+`PLURNK_HOOKS_ARGS` is a JSON string array. Select exact event names from the
+[core event reference](../plurnk-core/SPEC.md#notifications-core-events),
+such as `loop/terminated`, `loop/interaction`, or `workspace/preparation`.
+There is no hook-specific event vocabulary or wildcard syntax.
 
 Each process receives one line such as:
 
@@ -42,6 +34,12 @@ failure is reported to daemon diagnostics without changing loop control flow.
 Event payloads retain the core contract and may contain project or model
 content; treat the command and any downstream sink as trusted.
 
+By default, commands run one at a time with up to 64 waiting events and a
+30-second deadline from admission. Queue overflow and deadline expiry are
+reported; neither blocks the agent. Adjust `PLURNK_HOOKS_CONCURRENCY`,
+`PLURNK_HOOKS_QUEUE_LIMIT`, and `PLURNK_HOOKS_TIMEOUT_MS` through the same
+environment cascade. Delivery is best-effort, without retries or replay.
+
 ## Test one hook
 
 Save this as the script path named in `PLURNK_HOOKS_ARGS`:
@@ -61,6 +59,15 @@ printf '%s\n' '{"workspaceId":42,"method":"loop/terminated","params":{}}' \
   | /usr/bin/node /absolute/path/to/plurnk-hook.mjs
 ```
 
-The complete contract and event-to-core mapping live in
+## Plugin or external tool?
+
+An ordinary executable needs only the configuration above. An installed daemon
+module can instead use `ApplicationPort.subscribeToEvents` directly. Both
+observe the same core events. Producer modules implement `stop()` to refuse
+new work and settle existing work; observers unsubscribe in `close()`, after
+producer settlement. See the
+[module contract](../plurnk-core/SPEC.md#module-lifecycle-module-lifecycle-and-setup-seam).
+
+The complete delivery contract lives in
 [`SPEC.md`](./SPEC.md). Portable defaults live in
 [`.env.defaults`](./.env.defaults).

package/SPEC.md

@@ -2,46 +2,65 @@
 
 ## §hooks-command-delivery Exact command delivery
 
-One selected core event starts one configured executable with its configured
-argument array and `shell: false`. The child receives one complete
+An admitted selected event is delivered to the configured executable with its
+argument array and `shell: false`, subject to {§hooks-bounded-delivery}. The child receives one complete
 `{ workspaceId, method, params }` JSON envelope followed by a newline on stdin.
 The core-supplied workspace scope and payload pass through without inferred
 coordinates or payload translation. The child inherits the daemon's working
-directory and environment; its standard output and error remain visible in the
-daemon's streams.
+directory and resolved daemon environment captured at module construction;
+its standard output and error remain visible in the daemon's streams. Event
+data is serialized at publication, never read later from a mutable payload.
 
 ## §hooks-selection Event selection
 
-`PLURNK_HOOKS_EVENTS` is a comma-separated set from the following closed
-inventory. These are core event names, not a hook-local vocabulary or filter
-language.
+`PLURNK_HOOKS_EVENTS` selects exact comma-separated event names from
+{§notifications}. Hooks do not maintain a second closed inventory, translate
+names, infer lifecycle transitions, or implement a wildcard/filter language.
+A selected name with no corresponding publication causes no delivery.
 
-| Exposed event | Owning core notification |
+| Consumer | Integration |
 |---|---|
-| `log/entry` | `{§notifications-log-entry-notify}` |
-| `loop/proposal` | `{§notifications-loop-proposal}` |
-| `loop/terminated` | `{§notifications-loop-terminated}` |
-| `notice/event` | `{§notifications-notice-event}` |
-| `stream/concluded` | `{§notifications-stream-concluded}` |
-| `stream/event` | `{§notifications-stream-event-on-channel-change}` |
-| `workspace/created` | `{§notifications-workspace-created}` |
+| Installed module | `ApplicationPort.subscribeToEvents`, under {§module-lifecycle} |
+| Ordinary executable or script | This package's JSON-stdin adapter; no plugin manifest required |
+| Client | The client-interface protocol's projection; not a raw event-bus subscription |
+
+## §hooks-bounded-delivery Bounded delivery
+
+| Boundary | Behavior |
+|---|---|
+| Admission | Start immediately when a command slot is free; otherwise queue FIFO up to the configured waiting-event limit. Reject excess events with a diagnostic. |
+| Concurrency | At most `PLURNK_HOOKS_CONCURRENCY` commands at once. A value of `1` preserves completion order; larger values permit overlapping completion. |
+| Deadline | `PLURNK_HOOKS_TIMEOUT_MS` starts at admission, including queue time. Expired queued events are reported without execution; a running executable is killed on expiry. |
+| Failure | At most one command attempt per admitted event; no retry, replay, or durable queue. |
+| Shutdown | Remain subscribed through producer settlement under {§module-shutdown-order}; unsubscribe in `close()`, then drain already admitted deliveries. Repeated close joins the same drain. |
+
+The daemon's absolute shutdown deadline also bounds hook drainage. Forced
+shutdown can lose notifications. A command owns any subprocesses it creates;
+this adapter is not a process-tree supervisor.
 
 ## §hooks-failure-isolation Failure isolation
 
-Configuration errors fail module construction. Delivery runs outside the core
-subscriber call. Spawn, stdin, nonzero-exit, signal, and timeout failures are
+Typed configuration errors refuse module construction; the host contains them
+according to {§configuration-repair-path}. Event dispatch never awaits
+command completion. Serialization, spawn, stdin, nonzero-exit, signal, and timeout failures are
 reported to daemon diagnostics and cannot alter loop state or event dispatch.
-Module close first unsubscribes, then settles admitted deliveries; the required
-positive timeout bounds each child process.
+Command output and exit status cannot veto or rewrite an operation. Child
+ownership lasts until process closure, including after a broken stdin. A failed
+diagnostic reporter preserves both errors in the fallback diagnostic.
 
 ## §hooks-config Operator configuration
 
 | Variable | Contract |
 |---|---|
 | `PLURNK_HOOKS_COMMAND` | One executable; absent disables hooks |
-| `PLURNK_HOOKS_ARGS` | Optional JSON string array; invalid JSON or non-string members fail startup |
+| `PLURNK_HOOKS_ARGS` | Optional JSON string array; invalid JSON or non-string members refuse hook configuration |
 | `PLURNK_HOOKS_EVENTS` | Required with a command; explicit comma-separated names from {§hooks-selection} |
-| `PLURNK_HOOKS_TIMEOUT_MS` | Required positive integer delivery bound |
+| `PLURNK_HOOKS_TIMEOUT_MS` | Positive integer delivery deadline including queue time |
+| `PLURNK_HOOKS_CONCURRENCY` | Positive integer simultaneous-command limit |
+| `PLURNK_HOOKS_QUEUE_LIMIT` | Nonnegative integer waiting-event limit; `0` disables queueing |
 
-Arguments or events without a command, unknown or duplicate event names,
-shell-shaped command text, and malformed timeouts fail at this module boundary.
+Arguments or events without a command, malformed or duplicate event names,
+malformed arguments, and invalid bounds fail at this module boundary. The
+command is an executable name or path, including paths containing spaces;
+it is never split or interpreted as shell text. Choices come from the assembled
+cascading daemon environment; workspace and model inputs cannot configure hooks.

package/dist/Module.d.ts

@@ -1,16 +1,12 @@
-interface HooksSeam {
-    subscribeToEvents(handler: (workspaceId: number | null, method: string, params: unknown) => void): () => void;
-}
+import type { ApplicationPort } from "@plurnk/plurnk-contracts";
 export interface ModuleOptions {
-    readonly env?: NodeJS.ProcessEnv;
     readonly report?: (message: string, cause: unknown) => void;
 }
 export default class Module {
     #private;
     static init(options?: ModuleOptions): Module;
     private constructor();
-    start(seam: HooksSeam): void;
+    start(seam: Pick<ApplicationPort, "subscribeToEvents">): void;
     close(): Promise<void>;
 }
-export {};
 //# sourceMappingURL=Module.d.ts.map

package/dist/Module.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Module.d.ts","sourceRoot":"","sources":["../src/Module.ts"],"names":[],"mappings":"AAGA,UAAU,SAAS;IACf,iBAAiB,CACb,OAAO,EAAE,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,KAAK,IAAI,GAC/E,MAAM,IAAI,CAAC;CACjB;AAED,MAAM,WAAW,aAAa;IAC1B,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IACjC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;CAC/D;AAED,MAAM,CAAC,OAAO,OAAO,MAAM;;IAOvB,MAAM,CAAC,IAAI,CAAC,OAAO,GAAE,aAAkB,GAAG,MAAM,CAK/C;IAED,OAAO,eAGN;IAED,KAAK,CAAC,IAAI,EAAE,SAAS,GAAG,IAAI,CAkB3B;IAEK,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAI3B;CAyBJ"}
+{"version":3,"file":"Module.d.ts","sourceRoot":"","sources":["../src/Module.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAShE,MAAM,WAAW,aAAa;IAC1B,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;CAC/D;AAED,MAAM,CAAC,OAAO,OAAO,MAAM;;IAUvB,MAAM,CAAC,IAAI,CAAC,OAAO,GAAE,aAAkB,GAAG,MAAM,CAM/C;IAED,OAAO,eAIN;IAED,KAAK,CAAC,IAAI,EAAE,IAAI,CAAC,eAAe,EAAE,mBAAmB,CAAC,GAAG,IAAI,CAe5D;IAED,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAKrB;CA2DJ"}

package/dist/Module.js

@@ -2,67 +2,110 @@ import { spawn } from "node:child_process";
 import { hookConfig } from "./config.js";
 export default class Module {
     #config;
+    #environment;
     #report;
     #active = new Set();
+    #queued = [];
     #unsubscribe = null;
     #started = false;
+    #closing = null;
     static init(options = {}) {
-        return new Module(hookConfig(options.env ?? process.env), options.report ?? ((message, cause) => { console.error(`${message}:`, cause); }));
+        return new Module(hookConfig(), { ...process.env }, options.report ?? ((message, cause) => { console.error(`${message}:`, cause); }));
     }
-    constructor(config, report) {
+    constructor(config, environment, report) {
         this.#config = config;
+        this.#environment = environment;
         this.#report = report;
     }
     start(seam) {
-        if (this.#started)
-            throw new Error("hooks module already started");
+        if (this.#started || this.#closing !== null)
+            throw new Error("hooks module cannot be started again");
         this.#started = true;
         if (this.#config === null)
             return;
         this.#unsubscribe = seam.subscribeToEvents((workspaceId, method, params) => {
             if (!this.#config?.events.has(method))
                 return;
-            let observed;
-            observed = this.#deliver({ workspaceId, method, params })
-                .catch((cause) => {
-                try {
-                    this.#report(`hook command failed for ${method}`, cause);
-                }
-                catch (reportCause) {
-                    console.error(`hook failure reporter failed for ${method}:`, reportCause);
-                }
-            })
-                .finally(() => { this.#active.delete(observed); });
-            this.#active.add(observed);
+            if (this.#active.size >= this.#config.concurrency && this.#queued.length >= this.#config.queueLimit) {
+                this.#failed(method, new Error("Hook delivery queue is full; event not delivered."));
+                return;
+            }
+            try {
+                this.#queued.push({ method, input: `${JSON.stringify({ workspaceId, method, params })}\n`, deadline: Date.now() + this.#config.timeoutMs });
+                this.#pump();
+            }
+            catch (cause) {
+                this.#failed(method, cause);
+            }
         });
     }
-    async close() {
+    close() {
         this.#unsubscribe?.();
         this.#unsubscribe = null;
-        await Promise.all(this.#active);
+        this.#closing ??= this.#drain();
+        return this.#closing;
+    }
+    async #drain() {
+        while (this.#active.size > 0)
+            await Promise.all(this.#active);
     }
-    #deliver(envelope) {
+    #failed(method, cause) {
+        try {
+            this.#report(`hook command failed for ${method}`, cause);
+        }
+        catch (reportCause) {
+            console.error(`hook failure reporter failed for ${method}:`, new AggregateError([cause, reportCause]));
+        }
+    }
+    #pump() {
         const config = this.#config;
         if (config === null)
-            return Promise.resolve();
-        return new Promise((resolve, reject) => {
+            return;
+        while (this.#queued.length > 0 && this.#active.size < config.concurrency) {
+            const delivery = this.#queued.shift();
+            const remaining = delivery.deadline - Date.now();
+            if (remaining <= 0) {
+                this.#failed(delivery.method, new Error("Hook delivery deadline expired in queue; event not delivered."));
+                continue;
+            }
+            let observed;
+            observed = this.#deliver(delivery.input, remaining)
+                .catch((cause) => { this.#failed(delivery.method, cause); })
+                .finally(() => { this.#active.delete(observed); this.#pump(); });
+            this.#active.add(observed);
+        }
+    }
+    async #deliver(input, timeoutMs) {
+        const config = this.#config;
+        if (config === null)
+            return;
+        await new Promise((resolve, reject) => {
+            const failures = [];
             const child = spawn(config.command, config.args, {
                 shell: false,
+                env: this.#environment,
                 stdio: ["pipe", "inherit", "inherit"],
-                signal: AbortSignal.timeout(config.timeoutMs),
+                signal: AbortSignal.timeout(timeoutMs),
                 killSignal: "SIGKILL",
             });
-            child.once("error", reject);
+            child.once("error", (cause) => { failures.push(cause); });
             child.once("close", (code, signal) => {
-                if (code === 0)
+                if (failures.length > 1)
+                    reject(new AggregateError(failures, "Hook delivery failed."));
+                else if (failures.length === 1)
+                    reject(failures[0]);
+                else if (code === 0)
                     resolve();
                 else
                     reject(new Error(signal === null
                         ? `hook command exited with status ${String(code)}`
                         : `hook command exited on ${signal}`));
             });
-            child.stdin.once("error", reject);
-            child.stdin.end(`${JSON.stringify(envelope)}\n`, "utf8");
+            child.stdin.once("error", (cause) => {
+                failures.push(cause);
+                child.kill("SIGKILL");
+            });
+            child.stdin.end(input, "utf8");
         });
     }
 }

package/dist/Module.js.map

@@ -1 +1 @@
-{"version":3,"file":"Module.js","sourceRoot":"","sources":["../src/Module.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAC3C,OAAO,EAAE,UAAU,EAAmC,MAAM,aAAa,CAAC;AAa1E,MAAM,CAAC,OAAO,OAAO,MAAM;IACd,OAAO,CAAoB;IAC3B,OAAO,CAA4C;IACnD,OAAO,GAAG,IAAI,GAAG,EAAiB,CAAC;IAC5C,YAAY,GAAwB,IAAI,CAAC;IACzC,QAAQ,GAAG,KAAK,CAAC;IAEjB,MAAM,CAAC,IAAI,CAAC,OAAO,GAAkB,EAAE;QACnC,OAAO,IAAI,MAAM,CACb,UAAU,CAAC,OAAO,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,CAAC,EACtC,OAAO,CAAC,MAAM,IAAI,CAAC,CAAC,OAAO,EAAE,KAAK,EAAE,EAAE,GAAG,OAAO,CAAC,KAAK,CAAC,GAAG,OAAO,GAAG,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CACnF,CAAC;IACN,CAAC;IAED,YAAoB,MAAyB,EAAE,MAAiD;QAC5F,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC;QACtB,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC;IAC1B,CAAC;IAED,KAAK,CAAC,IAAe;QACjB,IAAI,IAAI,CAAC,QAAQ;YAAE,MAAM,IAAI,KAAK,CAAC,8BAA8B,CAAC,CAAC;QACnE,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC;QACrB,IAAI,IAAI,CAAC,OAAO,KAAK,IAAI;YAAE,OAAO;QAClC,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC,iBAAiB,CAAC,CAAC,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE;YACvE,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,GAAG,CAAC,MAAmB,CAAC;gBAAE,OAAO;YAC3D,IAAI,QAAuB,CAAC;YAC5B,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC;iBACpD,KAAK,CAAC,CAAC,KAAc,EAAE,EAAE;gBACtB,IAAI,CAAC;oBACD,IAAI,CAAC,OAAO,CAAC,2BAA2B,MAAM,EAAE,EAAE,KAAK,CAAC,CAAC;gBAC7D,CAAC;gBAAC,OAAO,WAAW,EAAE,CAAC;oBACnB,OAAO,CAAC,KAAK,CAAC,oCAAoC,MAAM,GAAG,EAAE,WAAW,CAAC,CAAC;gBAC9E,CAAC;YACL,CAAC,CAAC;iBACD,OAAO,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;YACvD,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAC/B,CAAC,CAAC,CAAC;IACP,CAAC;IAED,KAAK,CAAC,KAAK;QACP,IAAI,CAAC,YAAY,EAAE,EAAE,CAAC;QACtB,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC;QACzB,MAAM,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACpC,CAAC;IAED,QAAQ,CAAC,QAAyE;QAC9E,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC;QAC5B,IAAI,MAAM,KAAK,IAAI;YAAE,OAAO,OAAO,CAAC,OAAO,EAAE,CAAC;QAC9C,OAAO,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YACzC,MAAM,KAAK,GAAG,KAAK,CAAC,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC,IAAI,EAAE;gBAC7C,KAAK,EAAE,KAAK;gBACZ,KAAK,EAAE,CAAC,MAAM,EAAE,SAAS,EAAE,SAAS,CAAC;gBACrC,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,MAAM,CAAC,SAAS,CAAC;gBAC7C,UAAU,EAAE,SAAS;aACxB,CAAC,CAAC;YACH,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;YAC5B,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE;gBACjC,IAAI,IAAI,KAAK,CAAC;oBAAE,OAAO,EAAE,CAAC;;oBACrB,MAAM,CAAC,IAAI,KAAK,CACjB,MAAM,KAAK,IAAI;wBACX,CAAC,CAAC,mCAAmC,MAAM,CAAC,IAAI,CAAC,EAAE;wBACnD,CAAC,CAAC,0BAA0B,MAAM,EAAE,CAC3C,CAAC,CAAC;YACP,CAAC,CAAC,CAAC;YACH,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;YAClC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QAC7D,CAAC,CAAC,CAAC;IACP,CAAC;CACJ"}
+{"version":3,"file":"Module.js","sourceRoot":"","sources":["../src/Module.ts"],"names":[],"mappings":"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"}

package/dist/config.d.ts

@@ -1,10 +1,10 @@
-export declare const HOOK_EVENTS: readonly ["log/entry", "loop/proposal", "loop/terminated", "notice/event", "stream/concluded", "stream/event", "workspace/created"];
-export type HookEvent = typeof HOOK_EVENTS[number];
 export interface HookConfig {
     readonly command: string;
     readonly args: string[];
-    readonly events: ReadonlySet<HookEvent>;
+    readonly events: ReadonlySet<string>;
     readonly timeoutMs: number;
+    readonly concurrency: number;
+    readonly queueLimit: number;
 }
-export declare const hookConfig: (environment?: NodeJS.ProcessEnv) => HookConfig | null;
+export declare const hookConfig: () => HookConfig | null;
 //# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,WAAW,YACpB,WAAW,EACX,eAAe,EACf,iBAAiB,EACjB,cAAc,EACd,kBAAkB,EAClB,cAAc,EACd,mBAAmB,CACb,CAAC;AAEX,MAAM,MAAM,SAAS,GAAG,OAAO,WAAW,CAAC,MAAM,CAAC,CAAC;AAEnD,MAAM,WAAW,UAAU;IACvB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC,SAAS,CAAC,CAAC;IACxC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC9B;AAwCD,eAAO,MAAM,UAAU,iBAAiB,MAAM,CAAC,UAAU,KAAiB,UAAU,GAAG,IAqBtF,CAAC"}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,UAAU;IACvB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IACrC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC/B;AA+BD,eAAO,MAAM,UAAU,QAAO,UAAU,GAAG,IAuB1C,CAAC"}

package/dist/config.js

@@ -1,12 +1,4 @@
-export const HOOK_EVENTS = [
-    "log/entry",
-    "loop/proposal",
-    "loop/terminated",
-    "notice/event",
-    "stream/concluded",
-    "stream/event",
-    "workspace/created",
-];
+import { ConfigurationError, Knob } from "@plurnk/plurnk-meta";
 const hookArgs = (raw) => {
     if (raw === undefined || raw.length === 0)
         return [];
@@ -15,54 +7,48 @@ const hookArgs = (raw) => {
         parsed = JSON.parse(raw);
     }
     catch (cause) {
-        throw new Error("PLURNK_HOOKS_ARGS must be a JSON array of strings.", { cause });
+        throw new ConfigurationError("PLURNK_HOOKS_ARGS", "PLURNK_HOOKS_ARGS must be a JSON array of strings.", { cause });
     }
     if (!Array.isArray(parsed) || !parsed.every((value) => typeof value === "string")) {
-        throw new Error("PLURNK_HOOKS_ARGS must be a JSON array of strings.");
+        throw new ConfigurationError("PLURNK_HOOKS_ARGS", "PLURNK_HOOKS_ARGS must be a JSON array of strings.");
     }
     return parsed;
 };
 const hookEvents = (raw) => {
     if (raw === undefined || raw.trim().length === 0) {
-        throw new Error("PLURNK_HOOKS_EVENTS must select at least one event.");
+        throw new ConfigurationError("PLURNK_HOOKS_EVENTS", "PLURNK_HOOKS_EVENTS must select at least one event.");
     }
-    const known = new Set(HOOK_EVENTS);
     const selected = new Set();
     for (const event of raw.split(",").map((value) => value.trim())) {
-        if (!known.has(event))
-            throw new Error(`PLURNK_HOOKS_EVENTS names unknown core event '${event}'.`);
+        if (!/^[^\s,/*]+(?:\/[^\s,/*]+)+$/u.test(event))
+            throw new ConfigurationError("PLURNK_HOOKS_EVENTS", `PLURNK_HOOKS_EVENTS requires exact event names; got '${event}'.`);
         if (selected.has(event)) {
-            throw new Error(`PLURNK_HOOKS_EVENTS selects '${event}' more than once.`);
+            throw new ConfigurationError("PLURNK_HOOKS_EVENTS", `PLURNK_HOOKS_EVENTS selects '${event}' more than once.`);
         }
         selected.add(event);
     }
     return selected;
 };
-const hookTimeoutMs = (raw) => {
-    const timeoutMs = Number(raw);
-    if (!Number.isSafeInteger(timeoutMs) || timeoutMs < 1) {
-        throw new Error(`PLURNK_HOOKS_TIMEOUT_MS must be a positive integer; got ${JSON.stringify(raw)}.`);
-    }
-    return timeoutMs;
-};
-export const hookConfig = (environment = process.env) => {
-    const timeoutMs = hookTimeoutMs(environment.PLURNK_HOOKS_TIMEOUT_MS);
+export const hookConfig = () => {
+    const environment = process.env;
+    const timeoutMs = Knob.integer("PLURNK_HOOKS_TIMEOUT_MS", 1);
+    const concurrency = Knob.integer("PLURNK_HOOKS_CONCURRENCY", 1);
+    const queueLimit = Knob.integer("PLURNK_HOOKS_QUEUE_LIMIT", 0);
     const command = environment.PLURNK_HOOKS_COMMAND?.trim() ?? "";
     if (command.length === 0) {
         if ((environment.PLURNK_HOOKS_ARGS?.length ?? 0) > 0
             || (environment.PLURNK_HOOKS_EVENTS?.length ?? 0) > 0) {
-            throw new Error("PLURNK_HOOKS configuration has companions but no PLURNK_HOOKS_COMMAND.");
+            throw new ConfigurationError("PLURNK_HOOKS_COMMAND", "PLURNK_HOOKS configuration has companions but no PLURNK_HOOKS_COMMAND.");
         }
         return null;
     }
-    if (/\s/.test(command)) {
-        throw new Error("PLURNK_HOOKS_COMMAND must contain one executable; put arguments in PLURNK_HOOKS_ARGS.");
-    }
     return {
         command,
         args: hookArgs(environment.PLURNK_HOOKS_ARGS),
         events: hookEvents(environment.PLURNK_HOOKS_EVENTS),
         timeoutMs,
+        concurrency,
+        queueLimit,
     };
 };
 //# sourceMappingURL=config.js.map

package/dist/config.js.map

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

package/dist/index.d.ts

@@ -1,6 +1,6 @@
 export { default as Module } from "./Module.ts";
 export { default } from "./Module.ts";
 export type { ModuleOptions } from "./Module.ts";
-export { hookConfig, HOOK_EVENTS } from "./config.ts";
-export type { HookConfig, HookEvent } from "./config.ts";
+export { hookConfig } from "./config.ts";
+export type { HookConfig } from "./config.ts";
 //# 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":"AAAA,OAAO,EAAE,OAAO,IAAI,MAAM,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AACtC,YAAY,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AACtD,YAAY,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,IAAI,MAAM,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AACtC,YAAY,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,YAAY,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC"}

package/dist/index.js

@@ -1,4 +1,4 @@
 export { default as Module } from "./Module.js";
 export { default } from "./Module.js";
-export { hookConfig, HOOK_EVENTS } from "./config.js";
+export { hookConfig } from "./config.js";
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,IAAI,MAAM,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAEtC,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,IAAI,MAAM,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAEtC,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@plurnk/plurnk-hooks",
-  "version": "1.24.0",
+  "version": "1.25.0",
   "description": "Deliver selected Plurnk lifecycle events to exact local commands.",
   "keywords": [
     "plurnk",
@@ -23,6 +23,10 @@
   "license": "MIT",
   "author": "@wikitopian",
   "type": "module",
+  "dependencies": {
+    "@plurnk/plurnk-contracts": "1.25.0",
+    "@plurnk/plurnk-meta": "1.25.0"
+  },
   "publishConfig": {
     "access": "public"
   },