@xrkseek/harness 0.6.23 → 0.7.0-rc.2

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

@@ -0,0 +1,112 @@
+/**
+ * Experimental bridge for Claude Code mods. A mod is a DSH plugin built with
+ * {@link defineMod} around the mod's `register(on, options)`; this service
+ * keeps the loaded mods and raises their events from harness extension
+ * points — `session.start` on `agent/created`, `prompt.submit` and
+ * `turn.start` on `agent/pre-step`, `tool.call` around `tools/execute`,
+ * `turn.complete` on `turn/end`, `session.end` on `agent/disposed`, and
+ * `command.run` from the commands a mod registers. The `$` a hook receives is
+ * served by {@link createHostOps} over the composed harness services.
+ * @module @xrkseek/claude-code-mods
+ */
+import type { Context } from "@xrkseek/cordis";
+import z from "@xrkseek/schemastery";
+import type { Agent } from "@xrkseek/xrk-agent";
+import { TypertRemoteService } from "@xrkseek/xrk-typert-protocol";
+import type { LoadedMod } from "./chain.js";
+import type { AgentBinding } from "./host-ops.js";
+import type { ModDefinition, SurfaceSnapshot } from "./types.js";
+declare module "@xrkseek/cordis" {
+    interface Context {
+        claudeCodeMods: ClaudeCodeMods;
+    }
+}
+export type * from "./types.js";
+export type { BoxProps, ButtonProps, TextProps, UiElement, UiElements, UiNode, } from "./elements.js";
+export { defineMod, type ModConfig, type ModPlugin, type ModSpec, } from "./define-mod.js";
+export { definePluginDir, PluginDirError, readPluginDir, type LoadPluginDirOptions, type PluginDirInfo, } from "./plugin-dir.js";
+export { createJsonStorageDomain, type JsonStorageDomainOptions, type StorageDomainService, } from "./storage-domain.js";
+export { createSessionWorkingDirectory, type WorkingDirectoryService, } from "./working-directory.js";
+export { DEFAULT_TOOL_ALIASES } from "./tool-names.js";
+export { KNOWN_EVENTS } from "./matcher.js";
+export { MODS_API_VERSION } from "./host-ops.js";
+/** Plugin config: the limits mod hooks run under. */
+export interface Config {
+    /** A hook's own running-time limit in milliseconds (Claude Code: 10 seconds). */
+    hookTimeoutMs?: number;
+    /** A `.catch` handler's running-time limit in milliseconds (Claude Code: 1 second). */
+    catchTimeoutMs?: number;
+    /** Default `$.process.run` and `$.http.fetch` timeout in milliseconds (Claude Code: 30 seconds). */
+    processTimeoutMs?: number;
+    /** Claude Code tool name → harness tool name entries added to the built-in alias table. */
+    toolAliases?: Record<string, string>;
+    /** Columns the band above the prompt reports to `ui.render` as `bodyColumns` and `viewport.columns`. */
+    bandColumns?: number;
+    /** Rows the band reports as `maxRows`. */
+    bandRows?: number;
+}
+/** Engine events this host raises; a hook on any other known event registers and is reported as unserved. */
+export declare const SERVED_EVENTS: ReadonlySet<string>;
+/**
+ * The bridge service: loaded mods, their hooks, and the harness listeners
+ * that raise their events. Mods join through {@link ClaudeCodeMods.add},
+ * which {@link defineMod} calls when a mod plugin mounts. The Remote methods
+ * let a Client draw each session's band above the prompt and press its buttons.
+ */
+export declare class ClaudeCodeMods extends TypertRemoteService {
+    static Config: z<Config>;
+    static inject: string[];
+    private readonly engine;
+    private readonly registrations;
+    private readonly surfaces;
+    constructor(ctx: Context, config: Config);
+    /**
+     * Watch the band above the prompt of one session: the current drawing, then
+     * every redraw, until the Client stops watching.
+     * @param agent - the session's agent, resolved by the Gateway.
+     * @param signal - carrier cancellation.
+     * @returns the band's snapshots.
+     */
+    watchBand(agent: Agent, signal: AbortSignal): AsyncIterable<SurfaceSnapshot>;
+    /**
+     * Press a button of the band's current drawing: runs the mod's `onPress` and redraws.
+     * @param agent - the session's agent, resolved by the Gateway.
+     * @param generation - the drawing the Client saw.
+     * @param actionId - the button's action id in that drawing.
+     * @returns the snapshot after the press.
+     */
+    pressBand(agent: Agent, generation: number, actionId: string): Promise<SurfaceSnapshot>;
+    /**
+     * Load one mod beneath every mod loaded before it: run its `register`,
+     * keep its hooks, and report which of its events this host never raises.
+     * @param definition - the mod as its plugin defined it.
+     * @returns the disposer that removes the mod's hooks, closes its timers, and releases its registrations.
+     * @throws Error when the name is invalid or taken, or when `register` throws (Claude Code's `hooks module did not load` wording).
+     */
+    add(definition: ModDefinition): Promise<() => Promise<void>>;
+    /** The loaded mods in chain order. */
+    get mods(): readonly LoadedMod[];
+    /**
+     * Raise one engine event from a host seam that is not one of the listeners
+     * this service already installed.
+     *
+     * The bridge installs its own listeners for the seams our agent loop and tool
+     * registry expose directly; a product that reaches a seam differently (its own
+     * pipeline, a test kit, another host's turn boundary) calls the same engine
+     * through here rather than re-implementing chain dispatch.
+     * @param event - the engine event name.
+     * @param input - the event payload mods receive.
+     * @param fallback - the answer when no mod decides.
+     * @param options - the agent binding and cancellation for this dispatch.
+     * @returns the chain's answer.
+     */
+    raise<I, R>(event: string, input: I, fallback: (input: I) => R, options: {
+        readonly binding: AgentBinding;
+        readonly signal: AbortSignal;
+    }): Promise<R>;
+}
+export default ClaudeCodeMods;
+export { attachClaudeCodeMods, type AttachClaudeCodeModsOptions, type AttachedClaudeCodeMods, } from "./attach.js";
+export { createModsRuntime, type CreateModsRuntimeOptions, type ModsHostServices, type ModsLogger, type ModsRuntime, type ModsRuntimeConfig, } from "./runtime.js";
+export { createProductAgent, discoverClaudeCodePluginDirs, type ProductAgentInput, } from "./product-agent.js";
+//# sourceMappingURL=index.d.ts.map

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

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