@xrkseek/harness 0.6.21 → 0.7.0-rc.1

package/node_modules/@xrkseek/claude-code-mods/dist/engine.js

@@ -0,0 +1,356 @@
+/**
+ * The mods engine: loaded mods and their hooks, engine-raised events, mods
+ * API calls raised as events, per-session `$.state`, and the timers mods
+ * start. It knows nothing of Cordis; the plugin supplies the engine behavior
+ * for each mods API call and the test kit supplies stubs.
+ * @module
+ */
+import { dispatch, ENGINE_ORIGIN } from "./chain.js";
+import { createModsApi } from "./api.js";
+import { messageOf, record } from "./values.js";
+import { HookRegistry, registerMod } from "./module.js";
+/**
+ * Thrown by an engine behavior to answer a mods API call with `{ deny }`, so
+ * the calling mod's `$` call rejects with the reason.
+ */
+export class OpDenied extends Error {
+    reason;
+    constructor(reason) {
+        super(reason);
+        this.reason = reason;
+        this.name = "OpDenied";
+    }
+}
+const NEVER_ABORTS = new AbortController().signal;
+/** Wait `ms`, or reject with the signal's reason when the event is cancelled before or while waiting. */
+function sleepUnless(ms, signal) {
+    return new Promise((resolve, reject) => {
+        if (signal.aborted) {
+            reject(abortReasonOf(signal));
+            return;
+        }
+        const timer = setTimeout(() => {
+            signal.removeEventListener("abort", onAbort);
+            resolve();
+        }, ms);
+        function onAbort() {
+            clearTimeout(timer);
+            reject(abortReasonOf(signal));
+        }
+        signal.addEventListener("abort", onAbort, { once: true });
+    });
+}
+function abortReasonOf(signal) {
+    const reason = signal.reason;
+    return reason instanceof Error
+        ? reason
+        : new Error(`$.clock.sleep cancelled: ${messageOf(reason)}`);
+}
+/** One named `$.state` slot: `<plugin>\u0000<key>`. */
+function stateSlot(plugin, key) {
+    if (typeof plugin !== "string" || typeof key !== "string")
+        throw new TypeError("$.state needs { plugin, key } strings");
+    return `${plugin}\u0000${key}`;
+}
+/**
+ * Timers owned by the engine on one mod's behalf. Closing cancels every
+ * scheduled timer, refuses new ones, and waits for the callbacks already
+ * running, so a mod cannot reschedule itself or touch the host after unload.
+ */
+class TimerSet {
+    report;
+    owner;
+    active = new Set();
+    running = new Set();
+    closed = false;
+    constructor(report, owner) {
+        this.report = report;
+        this.owner = owner;
+    }
+    after(ms, fn) {
+        if (this.closed)
+            return { cancel() { } };
+        const handle = setTimeout(() => {
+            this.active.delete(handle);
+            this.run(fn);
+        }, ms);
+        handle.unref();
+        this.active.add(handle);
+        return {
+            cancel: () => {
+                clearTimeout(handle);
+                this.active.delete(handle);
+            },
+        };
+    }
+    every(ms, fn) {
+        if (this.closed)
+            return { cancel() { } };
+        const handle = setInterval(() => {
+            this.run(fn);
+        }, ms);
+        handle.unref();
+        this.active.add(handle);
+        return {
+            cancel: () => {
+                clearInterval(handle);
+                this.active.delete(handle);
+            },
+        };
+    }
+    /**
+     * Cancel every scheduled timer, refuse new ones, and settle once the
+     * callbacks already running have finished.
+     */
+    async close() {
+        this.closed = true;
+        for (const handle of this.active)
+            clearTimeout(handle);
+        this.active.clear();
+        await Promise.all(this.running);
+    }
+    run(fn) {
+        const settled = Promise.resolve()
+            .then(fn)
+            .then(() => undefined, (error) => {
+            this.report(`${this.owner}: timer callback failed: ${messageOf(error)}`);
+        });
+        this.running.add(settled);
+        void settled.finally(() => {
+            this.running.delete(settled);
+        });
+    }
+}
+/**
+ * Loaded mods, their hooks, and the two ways events reach them: the engine
+ * raises one through every selected hook, and a mod's `$` call raises one
+ * through the mods loaded before it.
+ */
+export class ModsEngine {
+    options;
+    /** The loaded mods and their registrations. */
+    registry = new HookRegistry();
+    state = new Map();
+    /** Timer sets by `<session key>\u0000<plugin>`: a mod's timers belong to the session whose event started them. */
+    timers = new Map();
+    nextOrder = 0;
+    constructor(options) {
+        this.options = options;
+    }
+    /**
+     * Run one mod's `register` and add its hooks beneath every mod added before it.
+     * @param definition - the mod as its plugin defined it.
+     * @returns the loaded mod.
+     * @throws Error when the name is taken or invalid, or when `register` throws.
+     */
+    async add(definition) {
+        if (this.registry.list().some((loaded) => loaded.name === definition.name)) {
+            throw new Error(`mod "${definition.name}" not loaded: another mod of that name is already loaded`);
+        }
+        const order = this.nextOrder;
+        this.nextOrder += 1;
+        const { mod, hooks } = await registerMod(definition, order);
+        this.registry.add(mod, hooks);
+        return mod;
+    }
+    /**
+     * Raise one engine event through its hooks, outermost first.
+     * @param event - the event name.
+     * @param input - the event input; frozen before a hook sees it.
+     * @param core - the engine behavior beneath every hook.
+     * @param options - the binding events of this agent share, and its cancellation.
+     * @returns the result as the outermost hook returned it.
+     */
+    raise(event, input, core, options) {
+        return this.raiseWith(event, this.registry.select(event), undefined, input, core, options);
+    }
+    /**
+     * Raise one event through hooks the caller already selected, attributed to
+     * the mod that caused it: the engine, or a mod whose `$` call the host turned
+     * back into this event.
+     * @param event - the event name.
+     * @param hooks - the selected hooks, outermost first.
+     * @param raisedBy - the mod the event is attributed to, or undefined for the engine.
+     * @param input - the event input; frozen before a hook sees it.
+     * @param core - the engine behavior beneath every hook.
+     * @param options - the binding events of this agent share, and its cancellation.
+     * @returns the result as the outermost hook returned it.
+     */
+    raiseWith(event, hooks, raisedBy, input, core, options) {
+        const signal = options.signal ?? NEVER_ABORTS;
+        return dispatch({
+            event,
+            input,
+            core,
+            origin: raisedBy === undefined
+                ? ENGINE_ORIGIN
+                : { plugin: raisedBy.name, tier: "user" },
+            hooks,
+            api: (hook, clock) => this.api(hook.mod, clock, options.binding, signal),
+            budgetMs: this.options.budgetMs,
+            catchBudgetMs: this.options.catchBudgetMs,
+            signal,
+            report: this.options.report,
+            ...(options.validateNext === undefined
+                ? {}
+                : { validateNext: options.validateNext }),
+        });
+    }
+    /**
+     * Raise one mods API call as its event through the mods loaded before the
+     * caller, then answer it with the engine behavior.
+     * @param mod - the calling mod.
+     * @param op - the event name, `<namespace>.<method>`.
+     * @param input - the call's input.
+     * @param binding - the binding of the event the caller is handling.
+     * @param signal - cancellation of that event.
+     * @returns the value the chain answered with.
+     * @throws Error with the reason when a hook or the engine answered `{ deny }`.
+     */
+    async invoke(mod, op, input, binding, signal) {
+        const result = await dispatch({
+            event: op,
+            input,
+            // `tool.call` reaches the earlier mods once the host raises it from the tool pipeline, not here as well.
+            hooks: op === "tool.call" ? [] : this.registry.select(op, mod),
+            core: async (e) => {
+                try {
+                    return {
+                        value: await this.opCore(op, e, { mod, binding, signal, engine: this }),
+                    };
+                }
+                catch (error) {
+                    if (error instanceof OpDenied)
+                        return { deny: error.reason };
+                    throw error;
+                }
+            },
+            origin: { plugin: mod.name, tier: "user" },
+            api: (hook, clock) => this.api(hook.mod, clock, binding, signal),
+            budgetMs: this.options.budgetMs,
+            catchBudgetMs: this.options.catchBudgetMs,
+            signal,
+            report: this.options.report,
+        });
+        // Hooks that settle with anything but an object are skipped, so the result is the core's or a hook's object — or null.
+        const answer = result;
+        if (answer === null || (!("value" in answer) && !("deny" in answer))) {
+            throw new Error(`${op}: a hook returned neither { value } nor { deny }`);
+        }
+        if (typeof answer.deny === "string")
+            throw new Error(`${op} refused: ${answer.deny}`);
+        return answer.value;
+    }
+    /**
+     * Build the `$` for one mod inside one event.
+     * @param mod - the mod the instance belongs to.
+     * @param clock - the running hook's clock, or undefined outside a hook.
+     * @param binding - the event's binding.
+     * @param signal - the event's cancellation.
+     * @returns the mods API.
+     */
+    api(mod, clock, binding, signal) {
+        return createModsApi({
+            mod,
+            clock,
+            invoke: (op, input) => this.invoke(mod, op, input, binding, signal),
+            timers: this.timersOf(mod, this.options.stateKey(binding)),
+            report: this.options.report,
+        });
+    }
+    /**
+     * Forget one session's `$.state` values and close the timers its events started.
+     * @param key - the session key the values and timers were kept under.
+     * @returns settles once the session's timer callbacks have finished.
+     */
+    async forgetSession(key) {
+        this.state.delete(key);
+        const closing = [];
+        for (const [timerKey, timers] of this.timers) {
+            if (timerKey.startsWith(`${key}\u0000`)) {
+                this.timers.delete(timerKey);
+                closing.push(timers.close());
+            }
+        }
+        await Promise.all(closing);
+    }
+    /**
+     * The `claude plugin validate` style `hooks:` line for one mod.
+     * @param mod - the loaded mod.
+     * @returns its events with matchers, comma-separated.
+     */
+    describe(mod) {
+        return this.registry.describe(mod);
+    }
+    /**
+     * Drop one mod: its hooks stop receiving events, its timers are cancelled,
+     * and its running timer callbacks are awaited.
+     * @param name - the plugin name.
+     * @returns settles once the mod's timer callbacks have finished.
+     */
+    async unload(name) {
+        this.registry.remove(name);
+        const closing = [];
+        for (const [timerKey, timers] of this.timers) {
+            if (timerKey.endsWith(`\u0000${name}`)) {
+                this.timers.delete(timerKey);
+                closing.push(timers.close());
+            }
+        }
+        await Promise.all(closing);
+    }
+    /**
+     * Drop every registration and close every mod's timers.
+     * @returns settles once every timer callback has finished.
+     */
+    async dispose() {
+        await Promise.all([...this.registry.list()].map((mod) => this.unload(mod.name)));
+        this.state.clear();
+    }
+    timersOf(mod, sessionKey) {
+        const timerKey = `${sessionKey}\u0000${mod.name}`;
+        let timers = this.timers.get(timerKey);
+        if (timers === undefined) {
+            timers = new TimerSet(this.options.report, mod.name);
+            this.timers.set(timerKey, timers);
+        }
+        return timers;
+    }
+    opCore(op, input, context) {
+        const served = this.options.ops(op);
+        if (served !== undefined)
+            return served(input, context);
+        const fields = record(input);
+        switch (op) {
+            case "state.get": {
+                const slot = stateSlot(fields.plugin, fields.key);
+                const key = this.options.stateKey(context.binding);
+                this.options.onStateRead?.(key, slot);
+                return { value: this.state.get(key)?.get(slot) };
+            }
+            case "state.set": {
+                const slot = stateSlot(fields.plugin, fields.key);
+                const key = this.options.stateKey(context.binding);
+                let values = this.state.get(key);
+                if (values === undefined) {
+                    values = new Map();
+                    this.state.set(key, values);
+                }
+                values.set(slot, fields.value);
+                this.options.onStateWritten?.(key, slot);
+                return undefined;
+            }
+            case "clock.now":
+                return Date.now();
+            case "clock.sleep": {
+                const ms = fields.ms;
+                if (typeof ms !== "number" || !Number.isFinite(ms) || ms < 0)
+                    throw new TypeError("$.clock.sleep needs a non-negative number of milliseconds");
+                return sleepUnless(ms, context.signal);
+            }
+            default:
+                throw new Error(`no implementation for ${op}`);
+        }
+    }
+}
+//# sourceMappingURL=engine.js.map

package/node_modules/@xrkseek/claude-code-mods/dist/engine.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"engine.js","sourceRoot":"","sources":["../src/engine.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AACrD,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAYxD;;;GAGG;AACH,MAAM,OAAO,QAAS,SAAQ,KAAK;IACZ;IAArB,YAAqB,MAAc;QACjC,KAAK,CAAC,MAAM,CAAC,CAAC;QADK,WAAM,GAAN,MAAM,CAAQ;QAEjC,IAAI,CAAC,IAAI,GAAG,UAAU,CAAC;IACzB,CAAC;CACF;AA2CD,MAAM,YAAY,GAAG,IAAI,eAAe,EAAE,CAAC,MAAM,CAAC;AAElD,yGAAyG;AACzG,SAAS,WAAW,CAAC,EAAU,EAAE,MAAmB;IAClD,OAAO,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QAC3C,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;YACnB,MAAM,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC,CAAC;YAC9B,OAAO;QACT,CAAC;QACD,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE;YAC5B,MAAM,CAAC,mBAAmB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;YAC7C,OAAO,EAAE,CAAC;QACZ,CAAC,EAAE,EAAE,CAAC,CAAC;QACP,SAAS,OAAO;YACd,YAAY,CAAC,KAAK,CAAC,CAAC;YACpB,MAAM,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC,CAAC;QAChC,CAAC;QACD,MAAM,CAAC,gBAAgB,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;IAC5D,CAAC,CAAC,CAAC;AACL,CAAC;AAED,SAAS,aAAa,CAAC,MAAmB;IACxC,MAAM,MAAM,GAAY,MAAM,CAAC,MAAM,CAAC;IACtC,OAAO,MAAM,YAAY,KAAK;QAC5B,CAAC,CAAC,MAAM;QACR,CAAC,CAAC,IAAI,KAAK,CAAC,4BAA4B,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;AACjE,CAAC;AAED,uDAAuD;AACvD,SAAS,SAAS,CAAC,MAAe,EAAE,GAAY;IAC9C,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,OAAO,GAAG,KAAK,QAAQ;QACvD,MAAM,IAAI,SAAS,CAAC,uCAAuC,CAAC,CAAC;IAC/D,OAAO,GAAG,MAAM,SAAS,GAAG,EAAE,CAAC;AACjC,CAAC;AAED;;;;GAIG;AACH,MAAM,QAAQ;IAMO;IACA;IANF,MAAM,GAAG,IAAI,GAAG,EAAiC,CAAC;IAClD,OAAO,GAAG,IAAI,GAAG,EAAiB,CAAC;IAC5C,MAAM,GAAG,KAAK,CAAC;IAEvB,YACmB,MAA8B,EAC9B,KAAa;QADb,WAAM,GAAN,MAAM,CAAwB;QAC9B,UAAK,GAAL,KAAK,CAAQ;IAC7B,CAAC;IAEJ,KAAK,CAAC,EAAU,EAAE,EAAiB;QACjC,IAAI,IAAI,CAAC,MAAM;YAAE,OAAO,EAAE,MAAM,KAAI,CAAC,EAAE,CAAC;QACxC,MAAM,MAAM,GAAG,UAAU,CAAC,GAAG,EAAE;YAC7B,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;YAC3B,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACf,CAAC,EAAE,EAAE,CAAC,CAAC;QACP,MAAM,CAAC,KAAK,EAAE,CAAC;QACf,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QACxB,OAAO;YACL,MAAM,EAAE,GAAG,EAAE;gBACX,YAAY,CAAC,MAAM,CAAC,CAAC;gBACrB,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;YAC7B,CAAC;SACF,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,EAAU,EAAE,EAAiB;QACjC,IAAI,IAAI,CAAC,MAAM;YAAE,OAAO,EAAE,MAAM,KAAI,CAAC,EAAE,CAAC;QACxC,MAAM,MAAM,GAAG,WAAW,CAAC,GAAG,EAAE;YAC9B,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACf,CAAC,EAAE,EAAE,CAAC,CAAC;QACP,MAAM,CAAC,KAAK,EAAE,CAAC;QACf,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QACxB,OAAO;YACL,MAAM,EAAE,GAAG,EAAE;gBACX,aAAa,CAAC,MAAM,CAAC,CAAC;gBACtB,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;YAC7B,CAAC;SACF,CAAC;IACJ,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,KAAK;QACT,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;QACnB,KAAK,MAAM,MAAM,IAAI,IAAI,CAAC,MAAM;YAAE,YAAY,CAAC,MAAM,CAAC,CAAC;QACvD,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;QACpB,MAAM,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAClC,CAAC;IAEO,GAAG,CAAC,EAAiB;QAC3B,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,EAAE;aAC9B,IAAI,CAAC,EAAE,CAAC;aACR,IAAI,CACH,GAAG,EAAE,CAAC,SAAS,EACf,CAAC,KAAc,EAAE,EAAE;YACjB,IAAI,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,4BAA4B,SAAS,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QAC3E,CAAC,CACF,CAAC;QACJ,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QAC1B,KAAK,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE;YACxB,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QAC/B,CAAC,CAAC,CAAC;IACL,CAAC;CACF;AAED;;;;GAIG;AACH,MAAM,OAAO,UAAU;IAQQ;IAP7B,+CAA+C;IACtC,QAAQ,GAAG,IAAI,YAAY,EAAE,CAAC;IACtB,KAAK,GAAG,IAAI,GAAG,EAAgC,CAAC;IACjE,kHAAkH;IACjG,MAAM,GAAG,IAAI,GAAG,EAAoB,CAAC;IAC9C,SAAS,GAAG,CAAC,CAAC;IAEtB,YAA6B,OAA6B;QAA7B,YAAO,GAAP,OAAO,CAAsB;IAAG,CAAC;IAE9D;;;;;OAKG;IACH,KAAK,CAAC,GAAG,CAAC,UAAyB;QACjC,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,KAAK,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;YAC3E,MAAM,IAAI,KAAK,CACb,QAAQ,UAAU,CAAC,IAAI,0DAA0D,CAClF,CAAC;QACJ,CAAC;QACD,MAAM,KAAK,GAAG,IAAI,CAAC,SAAS,CAAC;QAC7B,IAAI,CAAC,SAAS,IAAI,CAAC,CAAC;QACpB,MAAM,EAAE,GAAG,EAAE,KAAK,EAAE,GAAG,MAAM,WAAW,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC;QAC5D,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;QAC9B,OAAO,GAAG,CAAC;IACb,CAAC;IAED;;;;;;;OAOG;IACH,KAAK,CACH,KAAa,EACb,KAAQ,EACR,IAA8B,EAC9B,OAA2B;QAE3B,OAAO,IAAI,CAAC,SAAS,CACnB,KAAK,EACL,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,EAC3B,SAAS,EACT,KAAK,EACL,IAAI,EACJ,OAAO,CACR,CAAC;IACJ,CAAC;IAED;;;;;;;;;;;OAWG;IACH,SAAS,CACP,KAAa,EACb,KAAgC,EAChC,QAA+B,EAC/B,KAAQ,EACR,IAA8B,EAC9B,OAA2B;QAE3B,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,YAAY,CAAC;QAC9C,OAAO,QAAQ,CAAO;YACpB,KAAK;YACL,KAAK;YACL,IAAI;YACJ,MAAM,EACJ,QAAQ,KAAK,SAAS;gBACpB,CAAC,CAAC,aAAa;gBACf,CAAC,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE;YAC7C,KAAK;YACL,GAAG,EAAE,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,EAAE,KAAK,EAAE,OAAO,CAAC,OAAO,EAAE,MAAM,CAAC;YACxE,QAAQ,EAAE,IAAI,CAAC,OAAO,CAAC,QAAQ;YAC/B,aAAa,EAAE,IAAI,CAAC,OAAO,CAAC,aAAa;YACzC,MAAM;YACN,MAAM,EAAE,IAAI,CAAC,OAAO,CAAC,MAAM;YAC3B,GAAG,CAAC,OAAO,CAAC,YAAY,KAAK,SAAS;gBACpC,CAAC,CAAC,EAAE;gBACJ,CAAC,CAAC,EAAE,YAAY,EAAE,OAAO,CAAC,YAAY,EAAE,CAAC;SAC5C,CAAC,CAAC;IACL,CAAC;IAED;;;;;;;;;;OAUG;IACH,KAAK,CAAC,MAAM,CACV,GAAc,EACd,EAAU,EACV,KAAc,EACd,OAAU,EACV,MAAmB;QAEnB,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAmB;YAC9C,KAAK,EAAE,EAAE;YACT,KAAK;YACL,yGAAyG;YACzG,KAAK,EAAE,EAAE,KAAK,WAAW,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,EAAE,GAAG,CAAC;YAC9D,IAAI,EAAE,KAAK,EAAE,CAAC,EAAqB,EAAE;gBACnC,IAAI,CAAC;oBACH,OAAO;wBACL,KAAK,EAAE,MAAM,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC,EAAE,EAAE,GAAG,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;qBACxE,CAAC;gBACJ,CAAC;gBAAC,OAAO,KAAc,EAAE,CAAC;oBACxB,IAAI,KAAK,YAAY,QAAQ;wBAAE,OAAO,EAAE,IAAI,EAAE,KAAK,CAAC,MAAM,EAAE,CAAC;oBAC7D,MAAM,KAAK,CAAC;gBACd,CAAC;YACH,CAAC;YACD,MAAM,EAAE,EAAE,MAAM,EAAE,GAAG,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE;YAC1C,GAAG,EAAE,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,CAAC;YAChE,QAAQ,EAAE,IAAI,CAAC,OAAO,CAAC,QAAQ;YAC/B,aAAa,EAAE,IAAI,CAAC,OAAO,CAAC,aAAa;YACzC,MAAM;YACN,MAAM,EAAE,IAAI,CAAC,OAAO,CAAC,MAAM;SAC5B,CAAC,CAAC;QACH,uHAAuH;QACvH,MAAM,MAAM,GAAG,MAAoD,CAAC;QACpE,IAAI,MAAM,KAAK,IAAI,IAAI,CAAC,CAAC,CAAC,OAAO,IAAI,MAAM,CAAC,IAAI,CAAC,CAAC,MAAM,IAAI,MAAM,CAAC,CAAC,EAAE,CAAC;YACrE,MAAM,IAAI,KAAK,CAAC,GAAG,EAAE,kDAAkD,CAAC,CAAC;QAC3E,CAAC;QACD,IAAI,OAAO,MAAM,CAAC,IAAI,KAAK,QAAQ;YACjC,MAAM,IAAI,KAAK,CAAC,GAAG,EAAE,aAAa,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;QACnD,OAAO,MAAM,CAAC,KAAK,CAAC;IACtB,CAAC;IAED;;;;;;;OAOG;IACH,GAAG,CACD,GAAc,EACd,KAA8B,EAC9B,OAAU,EACV,MAAmB;QAEnB,OAAO,aAAa,CAAC;YACnB,GAAG;YACH,KAAK;YACL,MAAM,EAAE,CAAC,EAAE,EAAE,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,EAAE,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,CAAC;YACnE,MAAM,EAAE,IAAI,CAAC,QAAQ,CAAC,GAAG,EAAE,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;YAC1D,MAAM,EAAE,IAAI,CAAC,OAAO,CAAC,MAAM;SAC5B,CAAC,CAAC;IACL,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,aAAa,CAAC,GAAW;QAC7B,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QACvB,MAAM,OAAO,GAAoB,EAAE,CAAC;QACpC,KAAK,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YAC7C,IAAI,QAAQ,CAAC,UAAU,CAAC,GAAG,GAAG,QAAQ,CAAC,EAAE,CAAC;gBACxC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;gBAC7B,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC;YAC/B,CAAC;QACH,CAAC;QACD,MAAM,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IAC7B,CAAC;IAED;;;;OAIG;IACH,QAAQ,CAAC,GAAc;QACrB,OAAO,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;IACrC,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,MAAM,CAAC,IAAY;QACvB,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QAC3B,MAAM,OAAO,GAAoB,EAAE,CAAC;QACpC,KAAK,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YAC7C,IAAI,QAAQ,CAAC,QAAQ,CAAC,SAAS,IAAI,EAAE,CAAC,EAAE,CAAC;gBACvC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;gBAC7B,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC;YAC/B,CAAC;QACH,CAAC;QACD,MAAM,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IAC7B,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,OAAO;QACX,MAAM,OAAO,CAAC,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACjF,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;IACrB,CAAC;IAEO,QAAQ,CAAC,GAAc,EAAE,UAAkB;QACjD,MAAM,QAAQ,GAAG,GAAG,UAAU,SAAS,GAAG,CAAC,IAAI,EAAE,CAAC;QAClD,IAAI,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QACvC,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;YACzB,MAAM,GAAG,IAAI,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,IAAI,CAAC,CAAC;YACrD,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;QACpC,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;IAEO,MAAM,CAAC,EAAU,EAAE,KAAc,EAAE,OAAqB;QAC9D,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACpC,IAAI,MAAM,KAAK,SAAS;YAAE,OAAO,MAAM,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;QACxD,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;QAC7B,QAAQ,EAAE,EAAE,CAAC;YACX,KAAK,WAAW,CAAC,CAAC,CAAC;gBACjB,MAAM,IAAI,GAAG,SAAS,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC;gBAClD,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;gBACnD,IAAI,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;gBACtC,OAAO,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;YACnD,CAAC;YACD,KAAK,WAAW,CAAC,CAAC,CAAC;gBACjB,MAAM,IAAI,GAAG,SAAS,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC;gBAClD,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;gBACnD,IAAI,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;gBACjC,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;oBACzB,MAAM,GAAG,IAAI,GAAG,EAAE,CAAC;oBACnB,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;gBAC9B,CAAC;gBACD,MAAM,CAAC,GAAG,CAAC,IAAI,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC;gBAC/B,IAAI,CAAC,OAAO,CAAC,cAAc,EAAE,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;gBACzC,OAAO,SAAS,CAAC;YACnB,CAAC;YACD,KAAK,WAAW;gBACd,OAAO,IAAI,CAAC,GAAG,EAAE,CAAC;YACpB,KAAK,aAAa,CAAC,CAAC,CAAC;gBACnB,MAAM,EAAE,GAAG,MAAM,CAAC,EAAE,CAAC;gBACrB,IAAI,OAAO,EAAE,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,GAAG,CAAC;oBAC1D,MAAM,IAAI,SAAS,CACjB,2DAA2D,CAC5D,CAAC;gBACJ,OAAO,WAAW,CAAC,EAAE,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;YACzC,CAAC;YACD;gBACE,MAAM,IAAI,KAAK,CAAC,yBAAyB,EAAE,EAAE,CAAC,CAAC;QACnD,CAAC;IACH,CAAC;CACF"}

package/node_modules/@xrkseek/claude-code-mods/dist/host-ops.d.ts

@@ -0,0 +1,72 @@
+/**
+ * The engine behavior for each mods API call this bridge serves, mapped onto
+ * harness services: commands and tools on the agent's scoped registries,
+ * `ui.ask` on the user-questions answerer, files on `ctx.fs`, processes on
+ * `ctx.subprocess`, the store on a storage domain, session facts on the
+ * agent's Session and projections. A service a deployment did not compose
+ * fails the call with the service name.
+ * @module
+ */
+import type { Context } from "@xrkseek/cordis";
+import type { ToolExecutionResult } from "@xrkseek/xrk-tools";
+import type { LoadedMod } from "./chain.js";
+import type { ModsEngine, OpTable } from "./engine.js";
+import type { ToolNameAliases } from "./tool-names.js";
+import type { SessionVersion, ToolCallResult } from "./types.js";
+import type { ModAgent } from "./types.js";
+/** The binding every event of this bridge carries: the agent it belongs to, when one does. */
+export interface AgentBinding {
+    readonly agent: ModAgent | undefined;
+}
+/** The mods API version string `$.session.version()` reports. */
+export declare const MODS_API_VERSION: SessionVersion;
+/** Largest file `$.fs.read` returns and `$.fs.write` accepts, Claude Code's own limit. */
+export declare const FS_MAX_BYTES: number;
+/** Largest JSON a plugin's `$.store` holds in total, Claude Code's own limit. */
+export declare const STORE_MAX_BYTES: number;
+/** Largest response body `$.http.fetch` returns. */
+export declare const HTTP_MAX_BYTES: number;
+/**
+ * Full name the model sees for a mod-registered tool: Claude Code's MCP-style spelling.
+ * @param plugin - the registering plugin's name.
+ * @param tool - the name the mod registered.
+ * @returns `mcp__<plugin>__<tool>`.
+ */
+export declare function modToolName(plugin: string, tool: string): string;
+/** Options the host op table is built from. */
+export interface HostOpsOptions {
+    readonly ctx: Context;
+    readonly aliases: ToolNameAliases;
+    /** Default `$.process.run` timeout in milliseconds. */
+    readonly processTimeoutMs: number;
+    /**
+     * Disposers of registrations mods made, keyed by the session they were scoped to
+     * (`''` for global ones), so bridge disposal undoes them and a disposed agent's
+     * entries can be dropped.
+     */
+    readonly registrations: Map<string, Set<() => void>>;
+    /** The mod that raised each in-flight `$.tool.call`, by call id, so the pipeline raises `tool.call` from it. */
+    readonly callOrigins: Map<string, LoadedMod>;
+    /** Names of commands mods registered, for `$.command.list` sources. */
+    readonly modCommands: Set<string>;
+    /** Full names of tools mods registered, whose calls a `tool.call` hook may answer with a successful result. */
+    readonly modTools: Set<string>;
+    /** Redraw a session's band after a `$.ui` call that changes what it shows; absent when no surface is drawn. */
+    readonly redraw?: (sessionId: string) => void;
+    /** Note a prompt a mod submitted, so the `prompt.submit` it raises carries the mod as its origin. */
+    readonly submitted?: (messageId: string, mod: string) => void;
+}
+/**
+ * Project one tool outcome onto Claude Code's `tool.call` result.
+ * @param result - the harness tool outcome.
+ * @returns its text as `result`, with `isError` on a failure.
+ */
+export declare function toolCallResultOf(result: ToolExecutionResult): ToolCallResult;
+/**
+ * Build the op table over the composed harness services.
+ * @param options - the context, aliases, limits, and registration tracking.
+ * @returns engine behaviors by event name.
+ */
+export declare function createHostOps(options: HostOpsOptions): OpTable<AgentBinding>;
+export type { ModsEngine };
+//# sourceMappingURL=host-ops.d.ts.map

package/node_modules/@xrkseek/claude-code-mods/dist/host-ops.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"host-ops.d.ts","sourceRoot":"","sources":["../src/host-ops.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAc/C,OAAO,KAAK,EAAkB,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAO9E,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAC5C,OAAO,KAAK,EAAE,UAAU,EAAa,OAAO,EAAE,MAAM,aAAa,CAAC;AAClE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AACvD,OAAO,KAAK,EAUV,cAAc,EAEd,cAAc,EAGf,MAAM,YAAY,CAAC;AACpB,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAE3C,8FAA8F;AAC9F,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,KAAK,EAAE,QAAQ,GAAG,SAAS,CAAC;CACtC;AAED,iEAAiE;AACjE,eAAO,MAAM,gBAAgB,EAAE,cAG7B,CAAC;AAEH,0FAA0F;AAC1F,eAAO,MAAM,YAAY,QAAkB,CAAC;AAE5C,iFAAiF;AACjF,eAAO,MAAM,eAAe,QAAkB,CAAC;AAE/C,oDAAoD;AACpD,eAAO,MAAM,cAAc,QAAkB,CAAC;AAE9C;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAEhE;AAgBD,+CAA+C;AAC/C,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,GAAG,EAAE,OAAO,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,eAAe,CAAC;IAClC,uDAAuD;IACvD,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC;;;;OAIG;IACH,QAAQ,CAAC,aAAa,EAAE,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM,IAAI,CAAC,CAAC,CAAC;IACrD,gHAAgH;IAChH,QAAQ,CAAC,WAAW,EAAE,GAAG,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IAC7C,uEAAuE;IACvE,QAAQ,CAAC,WAAW,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAClC,+GAA+G;IAC/G,QAAQ,CAAC,QAAQ,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAC/B,+GAA+G;IAC/G,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,IAAI,CAAC;IAC9C,qGAAqG;IACrG,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;CAC/D;AAmBD;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,mBAAmB,GAAG,cAAc,CAI5E;AAkCD;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,YAAY,CAAC,CAikB5E;AAED,YAAY,EAAE,UAAU,EAAE,CAAC"}