@xrkseek/harness 0.6.21 → 0.7.0-rc.1

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

@@ -0,0 +1,252 @@
+/**
+ * The bridge without Cordis.
+ *
+ * `ClaudeCodeMods` is a Cordis service because upstream that is how a
+ * composition mounts behaviour. Our shipped runtime drives `core-agent` /
+ * `core-tools` directly and has no Cordis container in the request path, so this
+ * module assembles the same engine over a small service bag the host hands in.
+ *
+ * The Cordis-shaped pieces the engine actually touches are three: `ctx.get(name)`
+ * for the services `$` reaches, `ctx.logger` for diagnostics, and `ctx.effect`
+ * for teardown. `createServiceContext` supplies exactly those, so the engine,
+ * chain, module and `$` code stay byte-identical to the Cordis path.
+ *
+ * ```ts
+ * const mods = createModsRuntime({
+ *   services: { fs, subprocess, commands, tools, workingDirectory, storageDomain },
+ *   pipeline,
+ *   dirs: ['~/.xrk/plugins/claude-code/my-plugin'],
+ * })
+ * ```
+ * @module
+ */
+import { ModsEngine } from "./engine.js";
+import { createHostOps } from "./host-ops.js";
+import { definePluginDir } from "./plugin-dir.js";
+import { SurfaceTable } from "./surfaces.js";
+import { createToolNameAliases } from "./tool-names.js";
+import { messageOf, record } from "./values.js";
+/** A signal that never aborts, for a host seam that supplies none. */
+const DETACHED = new AbortController().signal;
+function consoleLogger() {
+    return {
+        debug: (line) => console.debug(line),
+        info: (line) => console.info(line),
+        warn: (line) => console.warn(line),
+        error: (line) => console.error(line),
+    };
+}
+/**
+ * The three Cordis members the engine uses, over a plain service bag.
+ *
+ * `effect` records teardown callbacks; `dispose` runs them once, in reverse
+ * registration order, the way a Cordis fiber unwinds.
+ */
+function createServiceContext(services, logger) {
+    const teardowns = [];
+    const ctx = {
+        get: (name) => services[name],
+        logger,
+        effect: (work) => {
+            teardowns.push(work());
+        },
+    };
+    return {
+        // The engine and host-ops only touch `get`, `logger` and `effect`; the cast
+        // keeps their published signatures without dragging in Cordis.
+        ctx: ctx,
+        dispose: () => {
+            for (const teardown of teardowns.splice(0).reverse())
+                void teardown();
+        },
+    };
+}
+/**
+ * Build a bridge runtime over the host's own services and tool pipeline.
+ *
+ * Loading is awaited: a plugin whose `register` throws surfaces here, at
+ * composition time, rather than half-loading and becoming hooks that never fire.
+ */
+export async function createModsRuntime(options) {
+    const logger = options.logger ?? consoleLogger();
+    const { ctx, dispose: disposeContext } = createServiceContext(options.services, logger);
+    const config = options.config ?? {};
+    const hookTimeoutMs = config.hookTimeoutMs ?? 10_000;
+    const catchTimeoutMs = config.catchTimeoutMs ?? 1_000;
+    const processTimeoutMs = config.processTimeoutMs ?? 30_000;
+    const bandColumns = config.bandColumns ?? 120;
+    const bandRows = config.bandRows ?? 10;
+    const aliases = createToolNameAliases(config.toolAliases);
+    const report = (line) => {
+        // One sink, not two: a host that supplies a report channel already owns
+        // logging, and echoing to the console as well printed every line twice.
+        if (options.report !== undefined)
+            options.report(line);
+        else
+            logger.warn(`claude-code-mods: ${line}`);
+    };
+    const registrations = new Map();
+    const callOrigins = new Map();
+    const modCommands = new Set();
+    const modTools = new Set();
+    // Surfaces need the engine to raise `ui.render`; host-ops need redraw to
+    // ask the band to refresh. Circular init: surfaces → engine → ops → redraw → surfaces.
+    const engineSlot = {};
+    const agentOfSession = (sessionId) => options.agentOfSession?.(sessionId);
+    const surfaces = new SurfaceTable({
+        columns: bandColumns,
+        rows: bandRows,
+        render: (sessionId, input) => {
+            const agent = agentOfSession(sessionId);
+            if (agent === undefined)
+                return Promise.resolve(null);
+            return engineSlot.current.raise("ui.render", input, () => null, { binding: { agent }, signal: DETACHED });
+        },
+        runAction: async (_sessionId, callback) => {
+            try {
+                await callback();
+            }
+            catch (error) {
+                report(`a button's onPress failed: ${messageOf(error)}`);
+            }
+        },
+        report,
+    });
+    // Deferred by one macrotask: a mod sets its own state right after the `$`
+    // call that triggers the redraw resolves (same as the Cordis bridge).
+    const redraw = (sessionId) => {
+        setTimeout(() => {
+            if (agentOfSession(sessionId) !== undefined)
+                void surfaces.refresh(sessionId);
+        }, 0).unref?.();
+    };
+    const ops = createHostOps({
+        ctx,
+        aliases,
+        processTimeoutMs,
+        registrations,
+        callOrigins,
+        modCommands,
+        modTools,
+        redraw,
+    });
+    engineSlot.current = new ModsEngine({
+        ops: (op) => ops[op],
+        stateKey: (binding) => binding.agent?.session.id ?? "",
+        budgetMs: hookTimeoutMs,
+        catchBudgetMs: catchTimeoutMs,
+        report,
+        onStateRead: (key, slot) => {
+            surfaces.stateRead(key, slot);
+        },
+        onStateWritten: (key, slot) => {
+            surfaces.stateWritten(key, slot);
+        },
+    });
+    const engine = engineSlot.current;
+    const pipelineDisposers = [];
+    if (options.pipeline !== undefined) {
+        const pipeline = options.pipeline;
+        const bindingOf = (context) => {
+            const agent = options.agentOf?.(context);
+            return agent === undefined ? { agent: undefined } : { agent };
+        };
+        const inputOf = (context) => ({
+            tool: aliases.toMod(context.call.name),
+            tool_use_id: context.call.id,
+            ...record(context.args),
+        });
+        // A `{ result }` in the pre pass means "do not run the tool, this is what the
+        // model reads" — the only way a mod-supplied tool (whose registered body is
+        // a placeholder that rejects) can ever answer. The pipeline's pre outcome
+        // has no such arm, so the answer is parked here and settled in the execute
+        // wrapper: the one seam that can skip the body without failing the call.
+        const earlyAnswers = new WeakMap();
+        const answeredEarly = new WeakSet();
+        const resultContent = (value, isError) => ({
+            content: typeof value === "string" ? value : JSON.stringify(value),
+            ...(isError === true ? { isError: true } : {}),
+        });
+        // Before dispatch: a mod may refuse; that refusal becomes the tool error the
+        // model reads, in the same place the host's own policy denies.
+        pipelineDisposers.push(pipeline.onPre(async (context) => {
+            const answer = await engine.raise("tool.call", inputOf(context), () => ({ result: undefined }), { binding: bindingOf(context), signal: context.signal ?? DETACHED });
+            if (answer.deny !== undefined)
+                return { action: "deny", reason: answer.deny };
+            if (answer.result !== undefined)
+                earlyAnswers.set(context, answer);
+            return { action: "continue", args: context.args };
+        }));
+        // Dispatch, or its cancellation: an early answer never reaches the body.
+        pipelineDisposers.push(pipeline.onExecute(async (context, next) => {
+            const early = earlyAnswers.get(context);
+            if (early === undefined) {
+                await next();
+                return;
+            }
+            earlyAnswers.delete(context);
+            answeredEarly.add(context);
+            context.result = resultContent(early.result, early.isError);
+        }));
+        // After dispatch: a mod may replace what the model reads. `deny` is
+        // meaningless once the call has run, so only `{ result }` is honoured.
+        pipelineDisposers.push(pipeline.onPost(async (context) => {
+            // Answered before dispatch: nothing left to replace, and raising again
+            // would run this call's hooks a second time.
+            if (answeredEarly.delete(context))
+                return { action: "accept" };
+            const answer = await engine.raise("tool.call", inputOf(context), () => ({ result: undefined }), { binding: bindingOf(context), signal: context.signal ?? DETACHED });
+            if (answer.result === undefined)
+                return { action: "accept" };
+            return {
+                action: "replace",
+                ...resultContent(answer.result, answer.isError),
+            };
+        }));
+    }
+    const runtime = {
+        get mods() {
+            return engine.registry.list();
+        },
+        modCommands,
+        modTools,
+        dispatch: (event, input, fallback, dispatchOptions = {}) => engine.raise(event, input, fallback, {
+            binding: { agent: dispatchOptions.agent },
+            signal: dispatchOptions.signal ?? DETACHED,
+        }),
+        currentBand: (sessionId) => surfaces.current(sessionId),
+        watchBand: (sessionId, signal) => surfaces.watch(sessionId, signal),
+        pressBand: (sessionId, generation, actionId) => surfaces.press(sessionId, generation, actionId),
+        refreshBand: (sessionId) => surfaces.refresh(sessionId),
+        forgetBand: (sessionId) => {
+            surfaces.forget(sessionId);
+        },
+        async loadDir(dir) {
+            const plugin = await definePluginDir(dir);
+            return engine.add(plugin.definition);
+        },
+        add: (definition) => engine.add(definition),
+        async dispose() {
+            for (const dispose of pipelineDisposers.splice(0))
+                dispose();
+            for (const owned of registrations.values())
+                for (const dispose of owned)
+                    dispose();
+            registrations.clear();
+            surfaces.dispose();
+            await engine.dispose();
+            disposeContext();
+        },
+    };
+    for (const dir of options.dirs ?? []) {
+        try {
+            await runtime.loadDir(dir);
+        }
+        catch (error) {
+            // One bad plugin must not take the composition down: name it, keep going.
+            report(`plugins under ${dir} did not load: ${messageOf(error)}`);
+        }
+    }
+    return runtime;
+}
+//# sourceMappingURL=runtime.js.map

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

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

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

@@ -0,0 +1,68 @@
+/**
+ * Storage domain: the durable, per-plugin JSON object `$.store` writes to.
+ *
+ * Upstream this is its own composable service (`dsh-storage-domain`). This
+ * repository has no such service yet, so the contract lives here — with the
+ * same shape the bridge was written against (`ctx.get('storageDomain').open(spec)`
+ * returning a domain whose tables read synchronously and write asynchronously)
+ * — plus a JSON-file implementation a Host can compose in one line:
+ *
+ * ```ts
+ * ctx.plugin(createJsonStorageDomain({ root: path.join(home, 'mods-store') }))
+ * ```
+ *
+ * Tables are loaded fully into memory when the domain opens: the store holds a
+ * handful of small JSON objects per plugin (capped at 4 MiB by the bridge), so
+ * `get` can stay synchronous as the `$.store` handlers expect.
+ */
+/** One table's value type, declared with the schema the host would validate. */
+export interface DomainTableSpec<V> {
+    /** Present for hosts that validate on write; this one only passes it through. */
+    readonly schema?: unknown;
+    /** Phantom marker so `DomainTableSpec<V>` infers `V` at `table()`. */
+    readonly __value?: V;
+}
+export interface DomainSpec {
+    readonly name: string;
+    readonly version: number;
+    readonly tables: Readonly<Record<string, DomainTableSpec<unknown>>>;
+}
+/** Declare a table. `V` is the stored value, `K` the key type (informational). */
+export declare function domainTable<K, V>(schema?: unknown): DomainTableSpec<V>;
+/** Declare a domain (name + version + tables). Identity function by design. */
+export declare function defineDomain<const S extends DomainSpec>(spec: S): S;
+type TableValue<S extends DomainSpec, K extends keyof S["tables"]> = S["tables"][K] extends DomainTableSpec<infer V> ? V : never;
+/** A table inside an open domain: synchronous reads, awaited writes. */
+export interface DomainTable<V> {
+    get(key: string): V | undefined;
+    put(key: string, value: V): Promise<void>;
+    delete(key: string): Promise<void>;
+    keys(): readonly string[];
+}
+export interface Domain<S extends DomainSpec = DomainSpec> {
+    readonly spec: S;
+    table<K extends keyof S["tables"]>(name: K): DomainTable<TableValue<S, K>>;
+    close(): Promise<void>;
+}
+/** The service a Host composes; `$.store` needs it to exist. */
+export interface StorageDomainService {
+    open<S extends DomainSpec>(spec: S): Promise<Domain<S>>;
+}
+declare module "@xrkseek/cordis" {
+    interface Context {
+        storageDomain: StorageDomainService;
+    }
+}
+export interface JsonStorageDomainOptions {
+    /** Directory holding one `<domain>.json` per opened domain. */
+    readonly root: string;
+}
+/**
+ * Compose a file-backed storage domain service.
+ *
+ * This is the one-service implementation of `StorageDomainService`; a Host that
+ * already owns durable storage should provide its own instead.
+ */
+export declare function createJsonStorageDomain(options: JsonStorageDomainOptions): StorageDomainService;
+export {};
+//# sourceMappingURL=storage-domain.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"storage-domain.d.ts","sourceRoot":"","sources":["../src/storage-domain.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAKH,gFAAgF;AAChF,MAAM,WAAW,eAAe,CAAC,CAAC;IAChC,iFAAiF;IACjF,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC;IAC1B,sEAAsE;IACtE,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;CACtB;AAED,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;CACrE;AAED,kFAAkF;AAClF,wBAAgB,WAAW,CAAC,CAAC,EAAE,CAAC,EAAE,MAAM,CAAC,EAAE,OAAO,GAAG,eAAe,CAAC,CAAC,CAAC,CAGtE;AAED,+EAA+E;AAC/E,wBAAgB,YAAY,CAAC,KAAK,CAAC,CAAC,SAAS,UAAU,EAAE,IAAI,EAAE,CAAC,GAAG,CAAC,CAEnE;AAED,KAAK,UAAU,CAAC,CAAC,SAAS,UAAU,EAAE,CAAC,SAAS,MAAM,CAAC,CAAC,QAAQ,CAAC,IAC/D,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,SAAS,eAAe,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;AAE9D,wEAAwE;AACxE,MAAM,WAAW,WAAW,CAAC,CAAC;IAC5B,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,CAAC,GAAG,SAAS,CAAC;IAChC,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1C,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACnC,IAAI,IAAI,SAAS,MAAM,EAAE,CAAC;CAC3B;AAED,MAAM,WAAW,MAAM,CAAC,CAAC,SAAS,UAAU,GAAG,UAAU;IACvD,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC;IACjB,KAAK,CAAC,CAAC,SAAS,MAAM,CAAC,CAAC,QAAQ,CAAC,EAAE,IAAI,EAAE,CAAC,GAAG,WAAW,CAAC,UAAU,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IAC3E,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB;AAED,gEAAgE;AAChE,MAAM,WAAW,oBAAoB;IACnC,IAAI,CAAC,CAAC,SAAS,UAAU,EAAE,IAAI,EAAE,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;CACzD;AAED,OAAO,QAAQ,iBAAiB,CAAC;IAC/B,UAAU,OAAO;QACf,aAAa,EAAE,oBAAoB,CAAC;KACrC;CACF;AAED,MAAM,WAAW,wBAAwB;IACvC,+DAA+D;IAC/D,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAuED;;;;;GAKG;AACH,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,wBAAwB,GAChC,oBAAoB,CAKtB"}

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

@@ -0,0 +1,104 @@
+/**
+ * Storage domain: the durable, per-plugin JSON object `$.store` writes to.
+ *
+ * Upstream this is its own composable service (`dsh-storage-domain`). This
+ * repository has no such service yet, so the contract lives here — with the
+ * same shape the bridge was written against (`ctx.get('storageDomain').open(spec)`
+ * returning a domain whose tables read synchronously and write asynchronously)
+ * — plus a JSON-file implementation a Host can compose in one line:
+ *
+ * ```ts
+ * ctx.plugin(createJsonStorageDomain({ root: path.join(home, 'mods-store') }))
+ * ```
+ *
+ * Tables are loaded fully into memory when the domain opens: the store holds a
+ * handful of small JSON objects per plugin (capped at 4 MiB by the bridge), so
+ * `get` can stay synchronous as the `$.store` handlers expect.
+ */
+import { mkdir, readFile, rename, writeFile } from "node:fs/promises";
+import path from "node:path";
+/** Declare a table. `V` is the stored value, `K` the key type (informational). */
+export function domainTable(schema) {
+    void 0;
+    return schema === undefined ? {} : { schema };
+}
+/** Declare a domain (name + version + tables). Identity function by design. */
+export function defineDomain(spec) {
+    return spec;
+}
+/** Open domain backed by a single JSON file, read once and written on change. */
+function openJsonDomain(spec, root) {
+    const file = path.join(root, `${spec.name}.json`);
+    const tables = new Map();
+    for (const name of Object.keys(spec.tables))
+        tables.set(name, new Map());
+    const persist = async () => {
+        const encoded = {};
+        for (const [name, table] of tables)
+            encoded[name] = Object.fromEntries(table);
+        const text = JSON.stringify(encoded);
+        await mkdir(root, { recursive: true });
+        const temporary = `${file}.tmp`;
+        await writeFile(temporary, text, "utf8");
+        await rename(temporary, file);
+    };
+    let writes = Promise.resolve();
+    const serialize = (work) => {
+        const next = writes.then(work, work);
+        writes = next.catch(() => undefined);
+        return next;
+    };
+    return (async () => {
+        try {
+            const text = await readFile(file, "utf8");
+            const parsed = JSON.parse(text);
+            for (const [name, table] of tables) {
+                const stored = parsed[name];
+                if (stored === undefined)
+                    continue;
+                for (const [key, value] of Object.entries(stored))
+                    table.set(key, value);
+            }
+        }
+        catch (error) {
+            if (error.code !== "ENOENT")
+                throw error;
+        }
+        return {
+            spec,
+            table(name) {
+                const table = tables.get(name);
+                if (table === undefined)
+                    throw new Error(`storage domain "${spec.name}" has no table "${String(name)}"`);
+                return {
+                    get: (key) => table.get(key),
+                    put: async (key, value) => {
+                        table.set(key, value);
+                        await serialize(persist);
+                    },
+                    delete: async (key) => {
+                        table.delete(key);
+                        await serialize(persist);
+                    },
+                    keys: () => [...table.keys()],
+                };
+            },
+            close: async () => {
+                await writes;
+            },
+        };
+    })();
+}
+/**
+ * Compose a file-backed storage domain service.
+ *
+ * This is the one-service implementation of `StorageDomainService`; a Host that
+ * already owns durable storage should provide its own instead.
+ */
+export function createJsonStorageDomain(options) {
+    const root = options.root;
+    return {
+        open: (spec) => openJsonDomain(spec, root),
+    };
+}
+//# sourceMappingURL=storage-domain.js.map

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

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

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

@@ -0,0 +1,82 @@
+/**
+ * The band above the prompt as the host draws it for one session: renders
+ * through the mods' `ui.render` hooks, keeps the latest tree with its button
+ * callbacks held host-side, redraws when a `$.state` value a render read
+ * changes or a mod asks, and hands watchers each new generation.
+ * @module
+ */
+import type { UiNode } from "./elements.js";
+import type { SurfaceSnapshot, UiRenderInput } from "./types.js";
+export type { SurfaceSnapshot } from "./types.js";
+/** What the table needs from the host. */
+export interface SurfaceHost {
+    /** Columns the band reports to `ui.render` as `bodyColumns` and `viewport.columns`. */
+    readonly columns: number;
+    /** Rows the band reports as `maxRows`. */
+    readonly rows: number;
+    /** Raise `ui.render` for one session through the mods and return the tree. */
+    render(sessionId: string, input: UiRenderInput): Promise<UiNode>;
+    /** Run one button's callback inside the session; the host owns the invocation and its reporting. */
+    runAction(sessionId: string, callback: () => unknown): Promise<void>;
+    /** Receives diagnostics: invalid trees, failed presses. */
+    report(line: string): void;
+}
+/**
+ * Bands by session id.
+ */
+export declare class SurfaceTable {
+    private readonly host;
+    private readonly bands;
+    private disposed;
+    constructor(host: SurfaceHost);
+    /**
+     * The latest snapshot of a session's band, drawing it first when nothing was drawn yet.
+     * @param sessionId - the session.
+     * @returns the current generation.
+     */
+    current(sessionId: string): Promise<SurfaceSnapshot>;
+    /**
+     * Watch a session's band: the current snapshot first, then every redraw, until the signal aborts.
+     * @param sessionId - the session.
+     * @param signal - ends the watch.
+     * @returns the snapshots.
+     */
+    watch(sessionId: string, signal: AbortSignal): AsyncIterable<SurfaceSnapshot>;
+    /**
+     * Redraw a session's band through the mods and notify watchers when the tree changed.
+     * @param sessionId - the session.
+     * @returns settles once the redraw landed.
+     */
+    refresh(sessionId: string): Promise<void>;
+    /**
+     * Run the callback a button holds and redraw. A press from an earlier
+     * generation is ignored: the button it names may no longer exist.
+     * @param sessionId - the session.
+     * @param generation - the generation the client saw.
+     * @param actionId - the id the serialized Button carried.
+     * @returns the snapshot after the press.
+     */
+    press(sessionId: string, generation: number, actionId: string): Promise<SurfaceSnapshot>;
+    /**
+     * Note a `$.state` read: during a render it subscribes the band to the slot.
+     * @param sessionId - the session the state belongs to.
+     * @param slot - the `<plugin>\u0000<key>` slot.
+     */
+    stateRead(sessionId: string, slot: string): void;
+    /**
+     * Note a `$.state` write: a subscribed band redraws.
+     * @param sessionId - the session the state belongs to.
+     * @param slot - the `<plugin>\u0000<key>` slot.
+     */
+    stateWritten(sessionId: string, slot: string): void;
+    /**
+     * Forget a session's band: its watch streams end and no further pass renders it.
+     * @param sessionId - the disposed session.
+     */
+    forget(sessionId: string): void;
+    /** Stop drawing: every band is forgotten and its watch streams end. */
+    dispose(): void;
+    private bandOf;
+    private renderOnce;
+}
+//# sourceMappingURL=surfaces.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"surfaces.d.ts","sourceRoot":"","sources":["../src/surfaces.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAE5C,OAAO,KAAK,EAAkB,eAAe,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEjF,YAAY,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAElD,0CAA0C;AAC1C,MAAM,WAAW,WAAW;IAC1B,uFAAuF;IACvF,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,0CAA0C;IAC1C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,8EAA8E;IAC9E,MAAM,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IACjE,oGAAoG;IACpG,SAAS,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACrE,2DAA2D;IAC3D,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;CAC5B;AAyBD;;GAEG;AACH,qBAAa,YAAY;IAIX,OAAO,CAAC,QAAQ,CAAC,IAAI;IAHjC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAkC;IACxD,OAAO,CAAC,QAAQ,CAAS;gBAEI,IAAI,EAAE,WAAW;IAE9C;;;;OAIG;IACG,OAAO,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC;IAM1D;;;;;OAKG;IACI,KAAK,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,GAAG,aAAa,CAAC,eAAe,CAAC;IA0CpF;;;;OAIG;IACH,OAAO,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAgBzC;;;;;;;OAOG;IACG,KAAK,CACT,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,eAAe,CAAC;IAe3B;;;;OAIG;IACH,SAAS,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI;IAIhD;;;;OAIG;IACH,YAAY,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI;IAMnD;;;OAGG;IACH,MAAM,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAS/B,uEAAuE;IACvE,OAAO,IAAI,IAAI;IAKf,OAAO,CAAC,MAAM;YASA,UAAU;CAmDzB"}