@xrkseek/harness 0.6.23 → 0.7.0-rc.2

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

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

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

@@ -0,0 +1,105 @@
+/**
+ * The middleware chain: runs the hooks selected for one event in order, each
+ * hook's `next` reaching the hooks beneath and then the engine behavior, under
+ * Claude Code's failure rules (skip a hook that throws, times out, or returns
+ * no result; keep the result from beneath when it had already called `next`;
+ * give a `.catch` handler the chance to answer in its place).
+ * @module
+ */
+import type { AnyHook, HookOrigin, HookMatcher, ModsApi, PluginOptions } from "./types.js";
+/** One loaded mod: its plugin identity and the `register` options it received. */
+export interface LoadedMod {
+    readonly name: string;
+    readonly version: string | undefined;
+    /** Absolute directory the mod ships in, as `$.plugin.root` reports it. */
+    readonly root: string;
+    readonly options: PluginOptions;
+    /** Load order; hooks of an earlier mod run outside those of a later one. */
+    readonly order: number;
+}
+/** One `on(...)` registration. */
+export interface RegisteredHook {
+    readonly mod: LoadedMod;
+    readonly event: string;
+    readonly matcher: HookMatcher | undefined;
+    readonly hook: AnyHook;
+    catchHandler: AnyHook | undefined;
+    /** Failure kinds already reported for this hook; one line per kind until the mod reloads. */
+    readonly reported: Set<string>;
+}
+/** The `next.error.kind === 'timeout'` failure. */
+export declare class HookTimeoutError extends Error {
+    constructor(budgetMs: number);
+}
+/**
+ * Accounts a hook's own running time: the clock runs while the hook is busy
+ * and pauses while it awaits `next` or a mods API call. The deadline promise
+ * rejects once the busy time reaches the limit.
+ */
+export declare class BudgetClock {
+    readonly ms: number;
+    private readonly now;
+    private spent;
+    private busySince;
+    private pauses;
+    private stopped;
+    private timer;
+    private readonly deadline;
+    /**
+     * @param ms - the running-time limit in milliseconds.
+     * @param now - monotonic clock in milliseconds.
+     */
+    constructor(ms: number, now?: () => number);
+    /** Rejects with {@link HookTimeoutError} when the busy time reaches the limit. */
+    get expired(): Promise<never>;
+    /** Milliseconds left before the deadline fires. */
+    get remainingMs(): number;
+    /** Start counting; the hook is busy from now on. */
+    start(): void;
+    /** Stop counting while the hook awaits `next` or a mods API call. Nested pauses are counted. */
+    pause(): void;
+    /** Resume counting after the awaited call settled. */
+    resume(): void;
+    /** The hook settled: no deadline can fire from now on. */
+    stop(): void;
+    private arm;
+    private disarm;
+}
+/** Everything one dispatch needs besides the hooks themselves. */
+export interface DispatchRequest<E, R> {
+    readonly event: string;
+    readonly input: E;
+    /** The engine behavior at the bottom of the chain; receives the input as the chain left it. */
+    readonly core: (e: E) => Promise<R> | R;
+    readonly origin: HookOrigin;
+    /** Hooks whose event pattern selects this event, outermost first; matchers are evaluated per hook. */
+    readonly hooks: readonly RegisteredHook[];
+    /** Builds the `$` a hook receives; the clock pauses while its calls are awaited. */
+    readonly api: (hook: RegisteredHook, clock: BudgetClock) => ModsApi;
+    /** A hook's own running-time limit. */
+    readonly budgetMs: number;
+    /** A `.catch` handler's running-time limit. */
+    readonly catchBudgetMs: number;
+    readonly signal: AbortSignal;
+    /** Receives one diagnostic line per skipped hook and failure kind. */
+    readonly report: (line: string) => void;
+    /**
+     * Checks the input a hook passes to `next` before anything beneath runs; a
+     * throw skips that hook as a failure of its own and the chain continues with
+     * the input the hook received.
+     */
+    readonly validateNext?: (e: E, hook: RegisteredHook) => void;
+}
+/** Thrown by {@link DispatchRequest.validateNext}: the hook asked for a rewrite this host does not serve. */
+export declare class RewriteRefusedError extends Error {
+    constructor(message: string);
+}
+/** The engine's own origin. */
+export declare const ENGINE_ORIGIN: HookOrigin;
+/**
+ * Run one event through its hooks and the engine behavior.
+ * @param request - the event, its hooks, and the engine behavior beneath them.
+ * @returns the event's result as the outermost hook returned it.
+ */
+export declare function dispatch<E, R>(request: DispatchRequest<E, R>): Promise<R>;
+//# sourceMappingURL=chain.d.ts.map

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

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

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

@@ -0,0 +1,324 @@
+/**
+ * The middleware chain: runs the hooks selected for one event in order, each
+ * hook's `next` reaching the hooks beneath and then the engine behavior, under
+ * Claude Code's failure rules (skip a hook that throws, times out, or returns
+ * no result; keep the result from beneath when it had already called `next`;
+ * give a `.catch` handler the chance to answer in its place).
+ * @module
+ */
+import { deepFreeze } from "./values.js";
+import { messageOf } from "./values.js";
+import { matcherMatches } from "./matcher.js";
+/** The `next.error.kind === 'timeout'` failure. */
+export class HookTimeoutError extends Error {
+    constructor(budgetMs) {
+        super(`ran past its ${budgetMs} ms limit`);
+        this.name = "HookTimeoutError";
+    }
+}
+/**
+ * Accounts a hook's own running time: the clock runs while the hook is busy
+ * and pauses while it awaits `next` or a mods API call. The deadline promise
+ * rejects once the busy time reaches the limit.
+ */
+export class BudgetClock {
+    ms;
+    now;
+    spent = 0;
+    busySince;
+    pauses = 0;
+    stopped = false;
+    timer;
+    deadline = Promise.withResolvers();
+    /**
+     * @param ms - the running-time limit in milliseconds.
+     * @param now - monotonic clock in milliseconds.
+     */
+    constructor(ms, now = () => performance.now()) {
+        this.ms = ms;
+        this.now = now;
+        // The deadline only matters while a race awaits it; an unobserved
+        // rejection after the hook settled must not surface.
+        this.deadline.promise.catch(() => { });
+    }
+    /** Rejects with {@link HookTimeoutError} when the busy time reaches the limit. */
+    get expired() {
+        return this.deadline.promise;
+    }
+    /** Milliseconds left before the deadline fires. */
+    get remainingMs() {
+        const busy = this.busySince === undefined ? 0 : this.now() - this.busySince;
+        return Math.max(0, this.ms - this.spent - busy);
+    }
+    /** Start counting; the hook is busy from now on. */
+    start() {
+        if (this.stopped)
+            return;
+        this.busySince = this.now();
+        this.arm();
+    }
+    /** Stop counting while the hook awaits `next` or a mods API call. Nested pauses are counted. */
+    pause() {
+        if (this.stopped)
+            return;
+        this.pauses += 1;
+        if (this.busySince !== undefined) {
+            this.spent += this.now() - this.busySince;
+            this.busySince = undefined;
+        }
+        this.disarm();
+    }
+    /** Resume counting after the awaited call settled. */
+    resume() {
+        if (this.stopped || this.pauses === 0)
+            return;
+        this.pauses -= 1;
+        if (this.pauses === 0) {
+            this.busySince = this.now();
+            this.arm();
+        }
+    }
+    /** The hook settled: no deadline can fire from now on. */
+    stop() {
+        if (this.busySince !== undefined)
+            this.spent += this.now() - this.busySince;
+        this.stopped = true;
+        this.busySince = undefined;
+        this.disarm();
+    }
+    arm() {
+        this.disarm();
+        const remaining = this.remainingMs;
+        this.timer = setTimeout(() => {
+            this.stopped = true;
+            this.busySince = undefined;
+            this.spent = this.ms;
+            this.deadline.reject(new HookTimeoutError(this.ms));
+        }, remaining);
+        this.timer.unref();
+    }
+    disarm() {
+        if (this.timer !== undefined)
+            clearTimeout(this.timer);
+        this.timer = undefined;
+    }
+}
+/** Thrown by {@link DispatchRequest.validateNext}: the hook asked for a rewrite this host does not serve. */
+export class RewriteRefusedError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "RewriteRefusedError";
+    }
+}
+/** The engine's own origin. */
+export const ENGINE_ORIGIN = Object.freeze({
+    plugin: "engine",
+    tier: "core",
+});
+/** A hook settled with something other than a result object. */
+class NoResultError extends Error {
+    constructor() {
+        super("returned no result");
+        this.name = "NoResultError";
+    }
+}
+/** Classify a failed hook and word the diagnostic line's tail. */
+function failureOf(error) {
+    if (error instanceof HookTimeoutError)
+        return {
+            kind: "timeout",
+            message: error.message,
+            line: `timeout, ${error.message}`,
+        };
+    if (error instanceof NoResultError || error instanceof RewriteRefusedError)
+        return { kind: "throw", message: error.message, line: error.message };
+    const message = error instanceof Error ? `${error.name}: ${error.message}` : messageOf(error);
+    return { kind: "throw", message, line: `threw ${message}` };
+}
+/** Freeze the event input in place at every depth, as the mods API promises. */
+function freezeInput(input) {
+    return typeof input === "object" && input !== null ? deepFreeze(input) : input;
+}
+/**
+ * Run one event through its hooks and the engine behavior.
+ * @param request - the event, its hooks, and the engine behavior beneath them.
+ * @returns the event's result as the outermost hook returned it.
+ */
+export async function dispatch(request) {
+    const { hooks } = request;
+    async function runFrom(index, input) {
+        for (let i = index; i < hooks.length; i += 1) {
+            const hook = hooks[i];
+            if (hook.matcher !== undefined && !matcherMatches(hook.matcher, input))
+                continue;
+            return runHook(hook, i, input);
+        }
+        return request.core(input);
+    }
+    async function runHook(hook, index, input) {
+        const frozen = freezeInput(input);
+        const clock = new BudgetClock(request.budgetMs);
+        // Closure-written flags live on one object so the catch path reads their current values.
+        const state = {
+            abandoned: false,
+            called: false,
+            beneath: undefined,
+            beneathError: undefined,
+            refused: undefined,
+        };
+        const next = Object.assign((e) => {
+            state.called = true;
+            // One run beneath per hook: a second call hands back the first run.
+            if (state.beneath !== undefined)
+                return state.beneath;
+            if (state.abandoned)
+                return Promise.resolve(undefined);
+            if (request.validateNext !== undefined) {
+                try {
+                    request.validateNext(e, hook);
+                }
+                catch (error) {
+                    const refused = error instanceof Error ? error : new Error(messageOf(error));
+                    state.refused = { error: refused };
+                    return Promise.reject(refused);
+                }
+            }
+            clock.pause();
+            state.beneath = runFrom(index + 1, e)
+                .catch((error) => {
+                state.beneathError = { error };
+                throw error;
+            })
+                .finally(() => {
+                clock.resume();
+            });
+            return state.beneath;
+        }, {
+            signal: request.signal,
+            origin: request.origin,
+            budget: {
+                ms: request.budgetMs,
+                get remainingMs() {
+                    return clock.remainingMs;
+                },
+            },
+            to() {
+                return Promise.reject(new Error("next.to is only available to mods in managed prependPlugins or appendPlugins"));
+            },
+        });
+        const api = request.api(hook, clock);
+        clock.start();
+        try {
+            const running = Promise.resolve().then(() => hook.hook(api, frozen, next));
+            // An abandoned hook's later rejection is not an unhandled rejection.
+            running.catch(() => { });
+            const result = await Promise.race([running, clock.expired]);
+            // `null` is an answer (a surface drawn empty); only a hook that settles with no object at all is skipped.
+            if (typeof result !== "object")
+                throw new NoResultError();
+            // The hook answered; whatever it started beneath still runs to its end before the event settles.
+            clock.stop();
+            if (state.beneath !== undefined) {
+                await state.beneath.catch((error) => {
+                    request.report(`${hook.mod.name}: ${request.event}: the chain beneath failed after the hook answered: ${messageOf(error)}`);
+                });
+            }
+            return result;
+        }
+        catch (error) {
+            state.abandoned = true;
+            // The engine beneath failed, not the hook: the failure is the event's own.
+            if (state.beneathError !== undefined && error === state.beneathError.error)
+                throw error;
+            // A refused rewrite is the hook's failure even when the hook let the rejection through unchanged.
+            const failure = failureOf(state.refused !== undefined && error === state.refused.error
+                ? state.refused.error
+                : error);
+            // A hook that ran the chain beneath and then returned nothing is the
+            // ordinary "observe, do not modify" shape (`await next(e)` followed by a
+            // side effect). The result from beneath already stands, so there is
+            // nothing to warn about. A hook that returned nothing and never ran
+            // anything *is* a mistake worth naming once.
+            const observedOnly = error instanceof NoResultError && state.called;
+            if (!observedOnly && !hook.reported.has(failure.kind)) {
+                hook.reported.add(failure.kind);
+                request.report(`${hook.mod.name}: ${request.event} hook skipped: ${failure.line}`);
+            }
+            if (hook.catchHandler !== undefined) {
+                const answered = await runCatch(hook, index, frozen, { kind: failure.kind, message: failure.message }, state);
+                if (answered !== undefined)
+                    return answered;
+            }
+            // Whatever ran beneath, for the hook or its handler, ran once; its result stands.
+            if (state.beneath !== undefined)
+                return await state.beneath;
+            return await runFrom(index + 1, input);
+        }
+        finally {
+            clock.stop();
+        }
+    }
+    /**
+     * Run the failed hook's `.catch` handler. It shares the hook's beneath state:
+     * what the hook already ran is handed back, what the handler runs is recorded
+     * for the skip path, so nothing beneath runs twice.
+     */
+    async function runCatch(hook, index, input, failure, state) {
+        const clock = new BudgetClock(request.catchBudgetMs);
+        let handlerAbandoned = false;
+        const next = Object.assign((e) => {
+            if (state.beneath !== undefined)
+                return state.beneath;
+            if (handlerAbandoned)
+                return Promise.resolve(undefined);
+            if (request.validateNext !== undefined) {
+                // The same check the hook's own next makes: a handler cannot pass a rewrite beneath either.
+                try {
+                    request.validateNext(e, hook);
+                }
+                catch (error) {
+                    return Promise.reject(error instanceof Error ? error : new Error(messageOf(error)));
+                }
+            }
+            clock.pause();
+            state.beneath = runFrom(index + 1, e).finally(() => {
+                clock.resume();
+            });
+            return state.beneath;
+        }, {
+            signal: request.signal,
+            origin: request.origin,
+            budget: {
+                ms: request.catchBudgetMs,
+                get remainingMs() {
+                    return clock.remainingMs;
+                },
+            },
+            to() {
+                return Promise.reject(new Error("next.to is not available in a .catch handler"));
+            },
+            error: failure,
+            called: state.called,
+        });
+        const api = request.api(hook, clock);
+        clock.start();
+        try {
+            const handler = hook.catchHandler;
+            const running = Promise.resolve().then(() => handler(api, input, next));
+            running.catch(() => { });
+            const result = await Promise.race([running, clock.expired]);
+            if (typeof result === "object")
+                return result;
+        }
+        catch (error) {
+            request.report(`${hook.mod.name}: ${request.event} .catch handler skipped: ${failureOf(error).line}`);
+        }
+        finally {
+            handlerAbandoned = true;
+            clock.stop();
+        }
+        return undefined;
+    }
+    return runFrom(0, request.input);
+}
+//# sourceMappingURL=chain.js.map

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

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

package/node_modules/@xrkseek/claude-code-mods/dist/define-mod.d.ts

@@ -0,0 +1,39 @@
+/**
+ * `defineMod`: wrap a Claude Code mod's `register(on, options)` as a DSH
+ * plugin. Mounting the plugin registers the mod with the bridge service
+ * (`ctx.claudeCodeMods`); unmounting it removes the mod's hooks, timers, and
+ * registrations. Mods load in composition order, which is their chain order.
+ * @module
+ */
+import type { Context } from "@xrkseek/cordis";
+import z from "@xrkseek/schemastery";
+import type { ModDefinition, ModRegister, PluginOptions } from "./types.js";
+/** The option values a composition may set for a mod: `userConfig`'s value types. */
+export type ModConfig = Record<string, string | number | boolean | string[]>;
+/** What a mod's plugin declares: the plugin identity and the hooks module's `register`. */
+export interface ModSpec {
+    /** Plugin name, as `.claude-plugin/plugin.json` names it: letters, digits, `_` and `-`. */
+    readonly name: string;
+    readonly version?: string;
+    /** Absolute directory the mod ships in, reported by `$.plugin.root`. */
+    readonly root?: string;
+    /** `userConfig` defaults: the `options` `register` receives when the composition sets none. */
+    readonly userConfig?: PluginOptions;
+    readonly register: ModRegister;
+}
+/** A mod wrapped as a DSH plugin; its config is the mod's `options`. */
+export interface ModPlugin {
+    readonly name: string;
+    readonly inject: readonly string[];
+    readonly Config: z<ModConfig>;
+    /** The mod as the bridge and the test kit load it, with `userConfig` as its options. */
+    readonly definition: ModDefinition;
+    apply(ctx: Context, config: ModConfig): Promise<() => Promise<void>>;
+}
+/**
+ * Wrap one mod as a DSH plugin.
+ * @param spec - the mod's identity, `userConfig` defaults, and `register`.
+ * @returns a plugin object for `cordis.yml` or `ctx.plugin`; its `config` overlays `userConfig` as `register`'s `options`.
+ */
+export declare function defineMod(spec: ModSpec): ModPlugin;
+//# sourceMappingURL=define-mod.d.ts.map

package/node_modules/@xrkseek/claude-code-mods/dist/define-mod.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"define-mod.d.ts","sourceRoot":"","sources":["../src/define-mod.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,CAAC,MAAM,sBAAsB,CAAC;AACrC,OAAO,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAE5E,qFAAqF;AACrF,MAAM,MAAM,SAAS,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,EAAE,CAAC,CAAC;AAE7E,2FAA2F;AAC3F,MAAM,WAAW,OAAO;IACtB,2FAA2F;IAC3F,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,wEAAwE;IACxE,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,+FAA+F;IAC/F,QAAQ,CAAC,UAAU,CAAC,EAAE,aAAa,CAAC;IACpC,QAAQ,CAAC,QAAQ,EAAE,WAAW,CAAC;CAChC;AAED,wEAAwE;AACxE,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;IACnC,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC;IAC9B,wFAAwF;IACxF,QAAQ,CAAC,UAAU,EAAE,aAAa,CAAC;IACnC,KAAK,CAAC,GAAG,EAAE,OAAO,EAAE,MAAM,EAAE,SAAS,GAAG,OAAO,CAAC,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;CACtE;AAID;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,OAAO,GAAG,SAAS,CAuBlD"}

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

@@ -0,0 +1,39 @@
+/**
+ * `defineMod`: wrap a Claude Code mod's `register(on, options)` as a DSH
+ * plugin. Mounting the plugin registers the mod with the bridge service
+ * (`ctx.claudeCodeMods`); unmounting it removes the mod's hooks, timers, and
+ * registrations. Mods load in composition order, which is their chain order.
+ * @module
+ */
+import z from "@xrkseek/schemastery";
+const optionValue = z.union([z.string(), z.number(), z.boolean(), z.array(z.string())]);
+/**
+ * Wrap one mod as a DSH plugin.
+ * @param spec - the mod's identity, `userConfig` defaults, and `register`.
+ * @returns a plugin object for `cordis.yml` or `ctx.plugin`; its `config` overlays `userConfig` as `register`'s `options`.
+ */
+export function defineMod(spec) {
+    const userConfig = Object.freeze({ ...spec.userConfig });
+    const definition = Object.freeze({
+        name: spec.name,
+        ...(spec.version === undefined ? {} : { version: spec.version }),
+        ...(spec.root === undefined ? {} : { root: spec.root }),
+        options: userConfig,
+        register: spec.register,
+    });
+    return {
+        name: `claude-code-mod-${spec.name}`,
+        inject: ["claudeCodeMods"],
+        Config: z.dict(optionValue).default({}),
+        definition,
+        // A `register` that throws fails this plugin's mount, as any misconfigured plugin does; the rest of the composition continues.
+        // The disposer is the return value, which Cordis collects even when the plugin was removed while `register` ran.
+        apply(ctx, config) {
+            return ctx.claudeCodeMods.add({
+                ...definition,
+                options: Object.freeze({ ...userConfig, ...config }),
+            });
+        },
+    };
+}
+//# sourceMappingURL=define-mod.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"define-mod.js","sourceRoot":"","sources":["../src/define-mod.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,CAAC,MAAM,sBAAsB,CAAC;AA4BrC,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,CAAC;AAExF;;;;GAIG;AACH,MAAM,UAAU,SAAS,CAAC,IAAa;IACrC,MAAM,UAAU,GAAkB,MAAM,CAAC,MAAM,CAAC,EAAE,GAAG,IAAI,CAAC,UAAU,EAAE,CAAC,CAAC;IACxE,MAAM,UAAU,GAAkB,MAAM,CAAC,MAAM,CAAC;QAC9C,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,GAAG,CAAC,IAAI,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,CAAC;QAChE,GAAG,CAAC,IAAI,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC;QACvD,OAAO,EAAE,UAAU;QACnB,QAAQ,EAAE,IAAI,CAAC,QAAQ;KACxB,CAAC,CAAC;IACH,OAAO;QACL,IAAI,EAAE,mBAAmB,IAAI,CAAC,IAAI,EAAE;QACpC,MAAM,EAAE,CAAC,gBAAgB,CAAC;QAC1B,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;QACvC,UAAU;QACV,+HAA+H;QAC/H,iHAAiH;QACjH,KAAK,CAAC,GAAY,EAAE,MAAiB;YACnC,OAAO,GAAG,CAAC,cAAc,CAAC,GAAG,CAAC;gBAC5B,GAAG,UAAU;gBACb,OAAO,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,GAAG,UAAU,EAAE,GAAG,MAAM,EAAE,CAAC;aACrD,CAAC,CAAC;QACL,CAAC;KACF,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,96 @@
+/**
+ * The element vocabulary a `ui.render` hook answers with — Claude Code's
+ * `Box`, `Text`, and `Button` constructors — and what the host does with a
+ * tree: validate it, serialize it with callbacks replaced by action ids, and
+ * search it the way a mod's test does.
+ * @module
+ */
+import type { SerializedNode } from "./types.js";
+/** One element a constructor returns; `props` are the constructor's argument, frozen. */
+export interface UiElement {
+    readonly type: "Box" | "Text" | "Button";
+    readonly props: Readonly<Record<string, unknown>>;
+}
+/** What a `ui.render` hook returns: an element, text, nothing, or a list of those. */
+export type UiNode = UiElement | string | number | null | undefined | false | readonly UiNode[];
+/** `Box` props this host lays out; a prop set to `undefined` is one a mod left out. */
+export interface BoxProps {
+    readonly flexDirection?: "row" | "column" | undefined;
+    readonly paddingX?: number | undefined;
+    readonly paddingY?: number | undefined;
+    readonly padding?: number | undefined;
+    readonly gap?: number | undefined;
+    readonly border?: boolean | string | undefined;
+    readonly borderColor?: string | undefined;
+    readonly children?: UiNode | undefined;
+}
+/** `Text` props this host styles. */
+export interface TextProps {
+    readonly color?: string | undefined;
+    readonly bold?: boolean | undefined;
+    readonly dimColor?: boolean | undefined;
+    readonly italic?: boolean | undefined;
+    readonly underline?: boolean | undefined;
+    readonly children?: UiNode | undefined;
+}
+/** `Button` props: a label, an optional hotkey hint, and the callback a press runs on the host. */
+export interface ButtonProps {
+    readonly label: string;
+    readonly hotkey?: string | undefined;
+    readonly disabled?: boolean | undefined;
+    readonly onPress?: (() => unknown) | undefined;
+}
+/** The constructors `$.ui.resolve(e)` returns. */
+export interface UiElements {
+    readonly Box: (props: BoxProps) => UiElement;
+    readonly Text: (props: TextProps) => UiElement;
+    readonly Button: (props: ButtonProps) => UiElement;
+}
+export type { SerializedElement, SerializedNode } from "./types.js";
+/**
+ * Whether a value is an element one of this host's constructors returned.
+ * @param value - the candidate.
+ * @returns true for a constructor-made element.
+ */
+export declare function isUiElement(value: unknown): value is UiElement;
+/**
+ * The element constructors for one render.
+ * @returns `Box`, `Text`, and `Button`.
+ */
+export declare function uiElements(): UiElements;
+/**
+ * Check a `ui.render` answer against the vocabulary.
+ * @param node - the hook's answer.
+ * @returns undefined for a valid tree, or the reason it does not validate.
+ */
+export declare function treeProblem(node: UiNode): string | undefined;
+/**
+ * Serialize a validated tree for a client: scalars kept, children flattened,
+ * each `onPress` replaced by the id `holdAction` returns for it.
+ * @param node - the hook's answer, already validated with {@link treeProblem}.
+ * @param holdAction - stores one callback and returns its id.
+ * @returns the serialized nodes, in drawing order.
+ */
+export declare function serializeTree(node: UiNode, holdAction: (callback: () => unknown) => string): SerializedNode[];
+/** What a tree search matches on. */
+export interface TreePattern {
+    readonly type?: UiElement["type"];
+    /** Text drawn by the element, including its descendants; a string matches as a substring. */
+    readonly text?: string | RegExp;
+    /** A Button's label. */
+    readonly label?: string | RegExp;
+}
+/**
+ * Every element of a tree matching a pattern, in drawing order.
+ * @param node - the tree.
+ * @param pattern - the type, text, and label to match; an empty pattern matches every element.
+ * @returns the matching elements.
+ */
+export declare function findAll(node: UiNode, pattern: TreePattern): UiElement[];
+/**
+ * The plain text a tree draws, one line per top-level node: the test kit's and the host log's view of a surface.
+ * @param node - the tree.
+ * @returns the drawn text.
+ */
+export declare function renderText(node: UiNode): string;
+//# sourceMappingURL=elements.d.ts.map

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

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