@stateforge-labs/herdr 0.0.0-stage → 0.3.0

package/dist/herdr/client/watch.js

@@ -0,0 +1,138 @@
+// Role: watch(): a subscription that reconnects with backoff and forwards frames until the caller stops.
+// Informs HERDR-ADR-0017, HERDR-ADR-0007, HERDR-ADR-0016, plan 3.6; merged by HERDR-ADR-0021 from types.ts, default-sleep.ts, sleep-or-abort.ts, merge-signals.ts, forward-frames.ts, subscription-specs.ts, backoff.ts, watch-cycle.ts, watch.ts.
+import { WatchKind, Backoff, GLOBAL_SUBSCRIPTION_TYPES } from '../../constants.js';
+import { setTimeout as delay } from 'node:timers/promises';
+import { createReplayBuffer } from './watch-pane-set.js';
+export const defaultSleep = async function defaultSleep(ms, signal) {
+    try {
+        await delay(ms, undefined, { signal });
+    }
+    catch (error) {
+        // The abort is the answer: the caller checks the signal and stops. Any other failure is real.
+        if (!signal.aborted) {
+            throw error;
+        }
+    }
+};
+export async function sleepOrAbort(sleep, ms, signal) {
+    try {
+        await sleep(ms, signal);
+    }
+    catch (error) {
+        // The abort is the answer: the caller checks the signal and stops. Any other failure is real.
+        if (!signal.aborted) {
+            throw error;
+        }
+    }
+}
+// AbortSignal.any is on every target (Node >= 22.18, Bun); a missing parent just returns the own signal.
+export function linkSignal(own, parent) {
+    return parent === undefined ? own : AbortSignal.any([own, parent]);
+}
+export async function forwardFrames(subscription, accept) {
+    for await (const frame of subscription) {
+        if (!accept(frame)) {
+            return;
+        }
+    }
+}
+// Every type given here is a bare member of Subscription (no pane_id, no match): the callers pass GLOBAL_SUBSCRIPTION_TYPES
+// and PANE_LIFECYCLE_SUBSCRIPTION_TYPES, and the watch tests assert each spec has only its type.
+export function bareSpecs(types) {
+    return types.map((type) => ({ type }));
+}
+const DEFAULT_POLICY = {
+    initialMs: Backoff.InitialMs,
+    maxMs: Backoff.MaxMs,
+    factor: Backoff.Factor,
+    stableResetMs: Backoff.StableResetMs,
+};
+export function resolveBackoff(partial) {
+    return { ...DEFAULT_POLICY, ...partial };
+}
+// Delay before attempt number `attempt` (0 is the first retry): InitialMs * Factor^attempt, capped at MaxMs.
+export function nextDelayMs(policy, attempt) {
+    return Math.min(policy.initialMs * policy.factor ** attempt, policy.maxMs);
+}
+// The clock is injected so tests move time instead of waiting for it. A cycle up for at least StableResetMs resets the attempt count.
+export function createBackoffState(policy, now) {
+    let attempt = 0;
+    let startedAt = now();
+    return {
+        startCycle() {
+            startedAt = now();
+        },
+        delayAfterFailure() {
+            if (now() - startedAt >= policy.stableResetMs) {
+                attempt = 0;
+            }
+            const delay = nextDelayMs(policy, attempt);
+            attempt += 1;
+            return delay;
+        },
+    };
+}
+// Returns normally when the subscription ends without failing (close, abort, or the client closed). Throws when the cycle
+// failed (subscribe rejected, the snapshot rejected, or the subscription failed); the caller resubscribes after the backoff.
+export async function* runCycle(input) {
+    const { subscribe, specs, options, signal } = input;
+    const subscription = await subscribe(specs, { signal, queue: options.queue, onUnknown: options.onUnknown });
+    const buffer = createReplayBuffer(options.queue);
+    const endOnAbort = () => buffer.end();
+    signal.addEventListener('abort', endOnAbort, { once: true });
+    void forwardFrames(subscription, (frame) => buffer.push(frame)).then(() => buffer.end(), (error) => buffer.fail(error));
+    try {
+        const snapshot = await options.snapshot(signal);
+        if (signal.aborted) {
+            return;
+        }
+        yield { kind: WatchKind.Live, snapshot };
+        for (;;) {
+            const next = await buffer.take();
+            if (next.done === true || signal.aborted) {
+                return;
+            }
+            yield { kind: WatchKind.Frame, frame: next.value };
+        }
+    }
+    finally {
+        signal.removeEventListener('abort', endOnAbort);
+        subscription.close();
+    }
+}
+const DEFAULT_SPECS = bareSpecs(GLOBAL_SUBSCRIPTION_TYPES);
+export const createWatch = (subscribe) => createWatchWithClock(subscribe, Date.now);
+// The clock is a parameter so the backoff reset (a cycle up for stableResetMs) is tested with a fake clock. The client uses Date.now.
+export function createWatchWithClock(subscribe, now) {
+    return function watch(options) {
+        const controller = new AbortController();
+        const signal = linkSignal(controller.signal, options.signal);
+        return {
+            close() {
+                controller.abort();
+            },
+            [Symbol.asyncIterator]() {
+                return watchLoop(subscribe, options, signal, now);
+            },
+        };
+    };
+}
+// Repeats cycles until one ends normally. A failure sleeps the backoff delay (unless the signal already aborted) and tries again.
+async function* watchLoop(subscribe, options, signal, now) {
+    const backoff = createBackoffState(resolveBackoff(options.backoff), now);
+    const sleep = options.sleep ?? defaultSleep;
+    const specs = options.subscriptions ?? DEFAULT_SPECS;
+    while (!signal.aborted) {
+        backoff.startCycle();
+        try {
+            yield* runCycle({ subscribe, specs, options, signal });
+            return;
+        }
+        catch {
+            if (signal.aborted) {
+                return;
+            }
+            await sleepOrAbort(sleep, backoff.delayAfterFailure(), signal);
+        }
+    }
+}

package/dist/herdr/effect/to-tagged-error.d.ts

@@ -0,0 +1,2 @@
+import type { ToTaggedError } from './types.js';
+export declare const toTaggedError: ToTaggedError;

package/dist/herdr/effect/to-tagged-error.js

@@ -0,0 +1,54 @@
+// Role: maps a Promise-core error to its Effect tagged error. S0 returns plain objects that match the shapes in effect/types.ts; S1 (after A1) builds the Data.TaggedError classes instead.
+// Informs HERDR-ADR-0004 (Effect as a wrapper over the Promise core) and plan 3.7 (error table); contract in effect/types.ts (ToTaggedError).
+import { EffectErrorTag, EffectFallbackMessage } from '../../constants.js';
+import { HerdrError, HerdrTransportError, ProtocolMismatchError, SubscriptionEnded, UnsupportedByServerError, } from '../errors.js';
+// A server refusal keeps its method, code and message.
+function refused(error) {
+    return { _tag: EffectErrorTag.Refused, method: error.method, code: error.code, message: error.message };
+}
+// A transport failure keeps its timeout flag and the original error as cause.
+function transportFailure(error) {
+    return { _tag: EffectErrorTag.Unavailable, message: error.message, cause: error, isTimeout: error.isTimeout };
+}
+// A protocol mismatch keeps both protocol numbers.
+function protocolMismatch(error) {
+    return {
+        _tag: EffectErrorTag.ProtocolMismatch,
+        message: error.message,
+        expected: error.expected,
+        actual: error.actual,
+    };
+}
+// A missing server capability keeps the method and the capability that was missing.
+function unsupported(error) {
+    return {
+        _tag: EffectErrorTag.Unsupported,
+        message: error.message,
+        method: error.method,
+        capability: error.capability,
+    };
+}
+// An ended subscription is unavailable, not a timeout; the original error is the cause.
+function subscriptionEnded(error) {
+    return { _tag: EffectErrorTag.Unavailable, message: error.message, cause: error, isTimeout: false };
+}
+// Anything else is unavailable with the value as cause; its message is used when it has one.
+function unknownFailure(value) {
+    const message = value instanceof Error && value.message ? value.message : EffectFallbackMessage.UnknownError;
+    return { _tag: EffectErrorTag.Unavailable, message, cause: value, isTimeout: false };
+}
+// Dispatch order follows the table in effect/types.ts; the first matching class wins.
+function mapError(error) {
+    if (error instanceof HerdrError)
+        return refused(error);
+    if (error instanceof HerdrTransportError)
+        return transportFailure(error);
+    if (error instanceof ProtocolMismatchError)
+        return protocolMismatch(error);
+    if (error instanceof UnsupportedByServerError)
+        return unsupported(error);
+    if (error instanceof SubscriptionEnded)
+        return subscriptionEnded(error);
+    return unknownFailure(error);
+}
+export const toTaggedError = (error) => mapError(error);

package/dist/herdr/effect/types.d.ts

@@ -0,0 +1,51 @@
+import type { EffectErrorTag, ProtocolPolicy } from '../../constants.js';
+import type { Method, ServerCapability } from '../generated/index.js';
+import type { EnvMap } from '../wire/socket-path.js';
+import type { OnCall, UnknownFrame } from '../wire/types.js';
+/** Options of every Herdr layer. timeoutMs is required: no default timeout, the composition root decides (plan 3.7). */
+export interface HerdrLayerOptions {
+    readonly socketPath?: string | undefined;
+    readonly timeoutMs: number;
+    readonly protocolPolicy?: ProtocolPolicy | undefined;
+    readonly onCall?: OnCall | undefined;
+    /** Same rule as ConnectOptions.onUnknown (client hook first, then any per-call hook). */
+    readonly onUnknown?: ((frame: UnknownFrame) => void) | undefined;
+    /** Same as ConnectOptions.env; tests pass their own. */
+    readonly env?: EnvMap | undefined;
+}
+/**
+ * Fields of each tagged error (plan 3.7 table). Every shape has
+ * `message` (Data.TaggedError provides it; it is the Promise error's message), so toolResult reads it without a cast.
+ */
+export interface HerdrRefusedShape {
+    readonly _tag: typeof EffectErrorTag.Refused;
+    readonly method: string;
+    readonly code: string;
+    readonly message: string;
+}
+export interface HerdrUnavailableShape {
+    readonly _tag: typeof EffectErrorTag.Unavailable;
+    readonly message: string;
+    readonly cause: unknown;
+    readonly isTimeout: boolean;
+}
+export interface ProtocolMismatchShape {
+    readonly _tag: typeof EffectErrorTag.ProtocolMismatch;
+    readonly message: string;
+    readonly expected: number;
+    readonly actual: number;
+}
+export interface HerdrUnsupportedShape {
+    readonly _tag: typeof EffectErrorTag.Unsupported;
+    readonly message: string;
+    readonly method: Method;
+    readonly capability: ServerCapability;
+}
+/** Every error an Effect herdr call can fail with. P6a's Data.TaggedError classes satisfy these shapes structurally. */
+export type HerdrTaggedError = HerdrRefusedShape | HerdrUnavailableShape | ProtocolMismatchShape | HerdrUnsupportedShape;
+/**
+ * Maps a Promise-core error to its tagged error: HerdrError -> HerdrRefused; HerdrTransportError and SubscriptionEnded
+ * -> HerdrUnavailable; ProtocolMismatchError -> ProtocolMismatch; UnsupportedByServerError -> HerdrUnsupported;
+ * anything else -> HerdrUnavailable with the value as cause. Implemented by effect/to-tagged-error.ts (P6a).
+ */
+export type ToTaggedError = (error: unknown) => HerdrTaggedError;

package/dist/herdr/effect/types.js

@@ -0,0 +1,26 @@
+export {};
+/*
+ * LOCKED IN PROSE, TYPED IN AMENDMENT A1 (P6a builds exactly this; it may not change it):
+ *
+ * - Services (Context tags): `Herdr`, `HerdrReadOnly`, `HerdrPrompt`, `HerdrAdmin`, with service shapes
+ *   `EffectNamespaces<ClientNamespaces | ReadOnlyNamespaces | PromptNamespaces | AdminNamespaces>`: the generated namespace
+ *   type with every `(params, options?) => Promise<R>` leaf mapped to `(params, options?) => Effect<R, HerdrTaggedError>`,
+ *   built by one runtime wrapper over the Promise tree (plan 3.7: no second decoder).
+ * - Base members of every service: `capabilities: ClientCapabilities` and `serverInfo: ServerInfo` (plain values, read
+ *   from the Promise client). No `close`: the layer's scope closes the client (Layer.scoped + acquireRelease).
+ * - Streams: `events.subscribe(specs, options?: SubscribeOptions)` maps to `Stream<DecodedFrame, HerdrTaggedError>`;
+ *   `watch(options: EffectWatchOptions<S, E>)` to `Stream<WatchChange<S>, HerdrTaggedError | E>`, where
+ *   `EffectWatchOptions<S, E>` is `WatchOptions<S>` with `snapshot: Effect<S, E>` (an Effect, not a Promise function; the
+ *   wrapper runs it with Effect.runPromise and the watch abort signal) and without `signal` (fiber interruption ends it).
+ *   `hold()` maps to `Effect<HeldConnection, HerdrTaggedError, Scope>` (closed with the scope).
+ * - Layers: `Herdr.layer(options: HerdrLayerOptions)`, `Herdr.layerReadOnly(options: HerdrLayerOptions & ReadOnlyOptions)`,
+ *   `Herdr.layerPrompt(options: HerdrLayerOptions)`, `Herdr.layerAdmin(options: HerdrLayerOptions)`; each
+ *   `Layer<Service, ProtocolMismatch | HerdrUnavailable>` (connect runs in the layer). onUnknown and env are layer options.
+ * - `watchPaneSet(herdr: EffectNamespaces<ReadOnlyNamespaces>, options?: WatchPaneSetOptions): Stream<PaneSetChange, HerdrTaggedError>`,
+ *   a wrapper over client/watch watchPaneSet (P4b). It adapts the service to a PaneSetSource with one bridge:
+ *   `pane.list` = `(params) => Effect.runPromise(herdr.pane.list(params))` and `events.subscribe` taken from the Promise
+ *   client the layer holds (the service keeps a private reference to it; no second subscribe implementation).
+ * - Fiber interruption destroys the connection (rpc signal, subscription close, held close).
+ * - Stubs: A1 also creates `src/herdr/effect/services.ts` exporting the four tags (declared) and the four layers as typed
+ *   stubs that throw NotImplementedError (Lane.P6a), so a test layer can import the tags the day A1 lands.
+ */

package/dist/herdr/errors.d.ts

@@ -0,0 +1,53 @@
+import type { Lane } from '../constants.js';
+import type { ErrorBody, Method, ServerCapability } from './generated/index.js';
+export declare class HerdrError extends Error {
+    readonly name: string;
+    readonly code: string;
+    readonly method: string;
+    readonly body: ErrorBody;
+    constructor(method: string, body: ErrorBody);
+    static from(method: string, body: ErrorBody): HerdrError;
+}
+export interface TransportErrorOptions {
+    cause?: unknown;
+    isTimeout?: boolean;
+}
+export declare class HerdrTransportError extends Error {
+    readonly name: string;
+    readonly isTimeout: boolean;
+    constructor(message: string, options?: TransportErrorOptions);
+}
+export declare class ProtocolMismatchError extends Error {
+    readonly name: string;
+    readonly expected: number;
+    readonly actual: number;
+    constructor(expected: number, actual: number);
+}
+export declare class UnsupportedByServerError extends Error {
+    readonly name: string;
+    readonly method: Method;
+    readonly capability: ServerCapability;
+    constructor(method: Method, capability: ServerCapability);
+}
+export declare class UnsupportedWatchError extends TypeError {
+    readonly name: string;
+    constructor(message: string);
+}
+export declare class SubscriptionEnded extends Error {
+    readonly name: string;
+    readonly method: Method;
+    constructor(method: Method, options?: {
+        cause?: unknown;
+    });
+}
+export declare class NotImplementedError extends Error {
+    readonly name: string;
+    readonly what: string;
+    readonly lane: Lane;
+    constructor(what: string, lane: Lane);
+}
+export declare function notImplemented(what: string, lane: Lane): never;
+export declare class MalformedSchemaError extends Error {
+    readonly name: string;
+    constructor(message: string);
+}

package/dist/herdr/errors.js

@@ -0,0 +1,87 @@
+// Role: every error the herdr server client and its tools throw: a server refusal, a transport failure, a protocol mismatch, a capability the server lacks, an ended subscription, an unsupported watch, a malformed schema and a not-yet-implemented stub. Messages and names come from src/constants.ts.
+// Informs HERDR-ADR-0017, HERDR-ADR-0003, HERDR-ADR-0016, plan 3.1, HERDR-ADR-0009; merged by HERDR-ADR-0021 from errors.ts, not-implemented.ts, malformed-schema-error.ts.
+import { ErrorName, ErrorText } from '../constants.js';
+// A server error envelope: the call reached herdr and herdr refused it.
+export class HerdrError extends Error {
+    name = ErrorName.Herdr;
+    code;
+    method;
+    body;
+    constructor(method, body) {
+        super(ErrorText.Refused(method, body.message, body.code));
+        this.code = body.code;
+        this.method = method;
+        this.body = body;
+    }
+    static from(method, body) {
+        return new HerdrError(method, body);
+    }
+}
+// The call never got a usable answer: connect, timeout, abort, socket or malformed line.
+export class HerdrTransportError extends Error {
+    name = ErrorName.Transport;
+    isTimeout;
+    constructor(message, options = {}) {
+        super(message, { cause: options.cause });
+        this.isTimeout = options.isTimeout ?? false;
+    }
+}
+// The server speaks another protocol than the one this library was generated for.
+export class ProtocolMismatchError extends Error {
+    name = ErrorName.ProtocolMismatch;
+    expected;
+    actual;
+    constructor(expected, actual) {
+        super(ErrorText.ProtocolMismatch(expected, actual));
+        this.expected = expected;
+        this.actual = actual;
+    }
+}
+// A method needs a server capability that the server did not advertise; nothing was sent.
+export class UnsupportedByServerError extends Error {
+    name = ErrorName.UnsupportedByServer;
+    method;
+    capability;
+    constructor(method, capability) {
+        super(ErrorText.Unsupported(method, capability));
+        this.method = method;
+        this.capability = capability;
+    }
+}
+// A caller asked watchPaneSet for a per-pane type it cannot follow yet (pane.output_matched, open issue 8). A TypeError: an argument error, not a wire error.
+export class UnsupportedWatchError extends TypeError {
+    name = ErrorName.UnsupportedWatch;
+    constructor(message) {
+        super(message);
+    }
+}
+// The server closed a subscription connection (or it failed after the ack). Mapped to HerdrUnavailable in /effect (plan 3.7).
+export class SubscriptionEnded extends Error {
+    name = ErrorName.SubscriptionEnded;
+    method;
+    constructor(method, options = {}) {
+        super(ErrorText.SubscriptionEnded(method), { cause: options.cause });
+        this.method = method;
+    }
+}
+// A contract function whose lane has not landed yet. Never thrown by finished code.
+export class NotImplementedError extends Error {
+    name = ErrorName.NotImplemented;
+    what;
+    lane;
+    constructor(what, lane) {
+        super(ErrorText.NotImplemented(what, lane));
+        this.what = what;
+        this.lane = lane;
+    }
+}
+// Stub body: `return notImplemented('connectReadOnly', Lane.P2b)`.
+export function notImplemented(what, lane) {
+    throw new NotImplementedError(what, lane);
+}
+export class MalformedSchemaError extends Error {
+    name = ErrorName.MalformedSchema;
+    constructor(message) {
+        super(message);
+    }
+}

package/dist/herdr/generated/entries/admin.d.ts

@@ -0,0 +1,2 @@
+/** Method names of the admin entry point, sorted. */
+export declare const ADMIN_METHODS: readonly ["agent.explain", "agent.focus", "agent.get", "agent.list", "agent.prompt", "agent.read", "agent.rename", "agent.send_keys", "agent.start", "agent.view.clear", "agent.view.set", "agent.wait", "command.invoke", "events.subscribe", "events.wait", "integration.install", "integration.list", "integration.uninstall", "layout.apply", "layout.export", "layout.set_split_ratio", "notification.show", "pane.clear", "pane.clear_agent_authority", "pane.close", "pane.copy_motion", "pane.copy_search", "pane.current", "pane.edges", "pane.edit_scrollback", "pane.focus", "pane.focus_direction", "pane.get", "pane.input.set", "pane.layout", "pane.link.activate", "pane.link.resolve", "pane.list", "pane.move", "pane.neighbor", "pane.process_info", "pane.read", "pane.release_agent", "pane.rename", "pane.report_agent", "pane.report_agent_session", "pane.report_metadata", "pane.resize", "pane.scroll", "pane.selection.read", "pane.send_input", "pane.send_keys", "pane.send_text", "pane.split", "pane.swap", "pane.wait_for_output", "pane.zoom", "ping", "plugin.action.invoke", "plugin.action.list", "plugin.disable", "plugin.enable", "plugin.link", "plugin.list", "plugin.log.list", "plugin.pane.close", "plugin.pane.focus", "plugin.pane.open", "plugin.unlink", "popup.close", "product_announcement.dismiss", "release_notes.dismiss", "server.agent_manifests", "server.live_handoff", "server.reload_agent_manifests", "server.reload_config", "server.stop", "session.snapshot", "tab.close", "tab.create", "tab.focus", "tab.get", "tab.list", "tab.move", "tab.rename", "workspace.close", "workspace.create", "workspace.focus", "workspace.get", "workspace.list", "workspace.move", "workspace.move_block", "workspace.rename", "workspace.report_metadata", "worktree.create", "worktree.list", "worktree.open", "worktree.remove"];

package/dist/herdr/generated/entries/admin.js

@@ -0,0 +1,5 @@
+// GENERATED by tools/gen/ from schema/herdr-api.schema.json. Do not edit.
+// herdr protocol 22, schema_version 1.
+import { MethodAgentExplain, MethodAgentFocus, MethodAgentGet, MethodAgentList, MethodAgentPrompt, MethodAgentRead, MethodAgentRename, MethodAgentSendKeys, MethodAgentStart, MethodAgentViewClear, MethodAgentViewSet, MethodAgentWait, MethodCommandInvoke, MethodEventsSubscribe, MethodEventsWait, MethodIntegrationInstall, MethodIntegrationList, MethodIntegrationUninstall, MethodLayoutApply, MethodLayoutExport, MethodLayoutSetSplitRatio, MethodNotificationShow, MethodPaneClear, MethodPaneClearAgentAuthority, MethodPaneClose, MethodPaneCopyMotion, MethodPaneCopySearch, MethodPaneCurrent, MethodPaneEdges, MethodPaneEditScrollback, MethodPaneFocus, MethodPaneFocusDirection, MethodPaneGet, MethodPaneInputSet, MethodPaneLayout, MethodPaneLinkActivate, MethodPaneLinkResolve, MethodPaneList, MethodPaneMove, MethodPaneNeighbor, MethodPaneProcessInfo, MethodPaneRead, MethodPaneReleaseAgent, MethodPaneRename, MethodPaneReportAgent, MethodPaneReportAgentSession, MethodPaneReportMetadata, MethodPaneResize, MethodPaneScroll, MethodPaneSelectionRead, MethodPaneSendInput, MethodPaneSendKeys, MethodPaneSendText, MethodPaneSplit, MethodPaneSwap, MethodPaneWaitForOutput, MethodPaneZoom, MethodPing, MethodPluginActionInvoke, MethodPluginActionList, MethodPluginDisable, MethodPluginEnable, MethodPluginLink, MethodPluginList, MethodPluginLogList, MethodPluginPaneClose, MethodPluginPaneFocus, MethodPluginPaneOpen, MethodPluginUnlink, MethodPopupClose, MethodProductAnnouncementDismiss, MethodReleaseNotesDismiss, MethodServerAgentManifests, MethodServerLiveHandoff, MethodServerReloadAgentManifests, MethodServerReloadConfig, MethodServerStop, MethodSessionSnapshot, MethodTabClose, MethodTabCreate, MethodTabFocus, MethodTabGet, MethodTabList, MethodTabMove, MethodTabRename, MethodWorkspaceClose, MethodWorkspaceCreate, MethodWorkspaceFocus, MethodWorkspaceGet, MethodWorkspaceList, MethodWorkspaceMove, MethodWorkspaceMoveBlock, MethodWorkspaceRename, MethodWorkspaceReportMetadata, MethodWorktreeCreate, MethodWorktreeList, MethodWorktreeOpen, MethodWorktreeRemove } from '../names/method.js';
+/** Method names of the admin entry point, sorted. */
+export const ADMIN_METHODS = [MethodAgentExplain, MethodAgentFocus, MethodAgentGet, MethodAgentList, MethodAgentPrompt, MethodAgentRead, MethodAgentRename, MethodAgentSendKeys, MethodAgentStart, MethodAgentViewClear, MethodAgentViewSet, MethodAgentWait, MethodCommandInvoke, MethodEventsSubscribe, MethodEventsWait, MethodIntegrationInstall, MethodIntegrationList, MethodIntegrationUninstall, MethodLayoutApply, MethodLayoutExport, MethodLayoutSetSplitRatio, MethodNotificationShow, MethodPaneClear, MethodPaneClearAgentAuthority, MethodPaneClose, MethodPaneCopyMotion, MethodPaneCopySearch, MethodPaneCurrent, MethodPaneEdges, MethodPaneEditScrollback, MethodPaneFocus, MethodPaneFocusDirection, MethodPaneGet, MethodPaneInputSet, MethodPaneLayout, MethodPaneLinkActivate, MethodPaneLinkResolve, MethodPaneList, MethodPaneMove, MethodPaneNeighbor, MethodPaneProcessInfo, MethodPaneRead, MethodPaneReleaseAgent, MethodPaneRename, MethodPaneReportAgent, MethodPaneReportAgentSession, MethodPaneReportMetadata, MethodPaneResize, MethodPaneScroll, MethodPaneSelectionRead, MethodPaneSendInput, MethodPaneSendKeys, MethodPaneSendText, MethodPaneSplit, MethodPaneSwap, MethodPaneWaitForOutput, MethodPaneZoom, MethodPing, MethodPluginActionInvoke, MethodPluginActionList, MethodPluginDisable, MethodPluginEnable, MethodPluginLink, MethodPluginList, MethodPluginLogList, MethodPluginPaneClose, MethodPluginPaneFocus, MethodPluginPaneOpen, MethodPluginUnlink, MethodPopupClose, MethodProductAnnouncementDismiss, MethodReleaseNotesDismiss, MethodServerAgentManifests, MethodServerLiveHandoff, MethodServerReloadAgentManifests, MethodServerReloadConfig, MethodServerStop, MethodSessionSnapshot, MethodTabClose, MethodTabCreate, MethodTabFocus, MethodTabGet, MethodTabList, MethodTabMove, MethodTabRename, MethodWorkspaceClose, MethodWorkspaceCreate, MethodWorkspaceFocus, MethodWorkspaceGet, MethodWorkspaceList, MethodWorkspaceMove, MethodWorkspaceMoveBlock, MethodWorkspaceRename, MethodWorkspaceReportMetadata, MethodWorktreeCreate, MethodWorktreeList, MethodWorktreeOpen, MethodWorktreeRemove];

package/dist/herdr/generated/entries/client.d.ts

@@ -0,0 +1,2 @@
+/** Method names of the client entry point, sorted. */
+export declare const CLIENT_METHODS: readonly ["agent.explain", "agent.focus", "agent.get", "agent.list", "agent.prompt", "agent.read", "agent.rename", "agent.send_keys", "agent.view.clear", "agent.view.set", "agent.wait", "events.subscribe", "events.wait", "integration.list", "layout.apply", "layout.export", "layout.set_split_ratio", "notification.show", "pane.clear", "pane.clear_agent_authority", "pane.copy_motion", "pane.copy_search", "pane.current", "pane.edges", "pane.focus", "pane.focus_direction", "pane.get", "pane.input.set", "pane.layout", "pane.link.resolve", "pane.list", "pane.move", "pane.neighbor", "pane.process_info", "pane.read", "pane.release_agent", "pane.rename", "pane.report_agent", "pane.report_agent_session", "pane.report_metadata", "pane.resize", "pane.scroll", "pane.selection.read", "pane.send_input", "pane.send_keys", "pane.send_text", "pane.split", "pane.swap", "pane.wait_for_output", "pane.zoom", "ping", "plugin.action.list", "plugin.disable", "plugin.list", "plugin.log.list", "plugin.pane.focus", "product_announcement.dismiss", "release_notes.dismiss", "server.agent_manifests", "session.snapshot", "tab.create", "tab.focus", "tab.get", "tab.list", "tab.move", "tab.rename", "workspace.create", "workspace.focus", "workspace.get", "workspace.list", "workspace.move", "workspace.move_block", "workspace.rename", "workspace.report_metadata", "worktree.create", "worktree.list", "worktree.open"];

package/dist/herdr/generated/entries/client.js

@@ -0,0 +1,5 @@
+// GENERATED by tools/gen/ from schema/herdr-api.schema.json. Do not edit.
+// herdr protocol 22, schema_version 1.
+import { MethodAgentExplain, MethodAgentFocus, MethodAgentGet, MethodAgentList, MethodAgentPrompt, MethodAgentRead, MethodAgentRename, MethodAgentSendKeys, MethodAgentViewClear, MethodAgentViewSet, MethodAgentWait, MethodEventsSubscribe, MethodEventsWait, MethodIntegrationList, MethodLayoutApply, MethodLayoutExport, MethodLayoutSetSplitRatio, MethodNotificationShow, MethodPaneClear, MethodPaneClearAgentAuthority, MethodPaneCopyMotion, MethodPaneCopySearch, MethodPaneCurrent, MethodPaneEdges, MethodPaneFocus, MethodPaneFocusDirection, MethodPaneGet, MethodPaneInputSet, MethodPaneLayout, MethodPaneLinkResolve, MethodPaneList, MethodPaneMove, MethodPaneNeighbor, MethodPaneProcessInfo, MethodPaneRead, MethodPaneReleaseAgent, MethodPaneRename, MethodPaneReportAgent, MethodPaneReportAgentSession, MethodPaneReportMetadata, MethodPaneResize, MethodPaneScroll, MethodPaneSelectionRead, MethodPaneSendInput, MethodPaneSendKeys, MethodPaneSendText, MethodPaneSplit, MethodPaneSwap, MethodPaneWaitForOutput, MethodPaneZoom, MethodPing, MethodPluginActionList, MethodPluginDisable, MethodPluginList, MethodPluginLogList, MethodPluginPaneFocus, MethodProductAnnouncementDismiss, MethodReleaseNotesDismiss, MethodServerAgentManifests, MethodSessionSnapshot, MethodTabCreate, MethodTabFocus, MethodTabGet, MethodTabList, MethodTabMove, MethodTabRename, MethodWorkspaceCreate, MethodWorkspaceFocus, MethodWorkspaceGet, MethodWorkspaceList, MethodWorkspaceMove, MethodWorkspaceMoveBlock, MethodWorkspaceRename, MethodWorkspaceReportMetadata, MethodWorktreeCreate, MethodWorktreeList, MethodWorktreeOpen } from '../names/method.js';
+/** Method names of the client entry point, sorted. */
+export const CLIENT_METHODS = [MethodAgentExplain, MethodAgentFocus, MethodAgentGet, MethodAgentList, MethodAgentPrompt, MethodAgentRead, MethodAgentRename, MethodAgentSendKeys, MethodAgentViewClear, MethodAgentViewSet, MethodAgentWait, MethodEventsSubscribe, MethodEventsWait, MethodIntegrationList, MethodLayoutApply, MethodLayoutExport, MethodLayoutSetSplitRatio, MethodNotificationShow, MethodPaneClear, MethodPaneClearAgentAuthority, MethodPaneCopyMotion, MethodPaneCopySearch, MethodPaneCurrent, MethodPaneEdges, MethodPaneFocus, MethodPaneFocusDirection, MethodPaneGet, MethodPaneInputSet, MethodPaneLayout, MethodPaneLinkResolve, MethodPaneList, MethodPaneMove, MethodPaneNeighbor, MethodPaneProcessInfo, MethodPaneRead, MethodPaneReleaseAgent, MethodPaneRename, MethodPaneReportAgent, MethodPaneReportAgentSession, MethodPaneReportMetadata, MethodPaneResize, MethodPaneScroll, MethodPaneSelectionRead, MethodPaneSendInput, MethodPaneSendKeys, MethodPaneSendText, MethodPaneSplit, MethodPaneSwap, MethodPaneWaitForOutput, MethodPaneZoom, MethodPing, MethodPluginActionList, MethodPluginDisable, MethodPluginList, MethodPluginLogList, MethodPluginPaneFocus, MethodProductAnnouncementDismiss, MethodReleaseNotesDismiss, MethodServerAgentManifests, MethodSessionSnapshot, MethodTabCreate, MethodTabFocus, MethodTabGet, MethodTabList, MethodTabMove, MethodTabRename, MethodWorkspaceCreate, MethodWorkspaceFocus, MethodWorkspaceGet, MethodWorkspaceList, MethodWorkspaceMove, MethodWorkspaceMoveBlock, MethodWorkspaceRename, MethodWorkspaceReportMetadata, MethodWorktreeCreate, MethodWorktreeList, MethodWorktreeOpen];

package/dist/herdr/generated/entries/held.d.ts

@@ -0,0 +1,2 @@
+/** Method names of the held entry point, sorted. */
+export declare const HELD_METHODS: readonly ["client.window_title.clear", "client.window_title.set", "client_shell.surface.set", "server.ssh_agent.register"];

package/dist/herdr/generated/entries/held.js

@@ -0,0 +1,5 @@
+// GENERATED by tools/gen/ from schema/herdr-api.schema.json. Do not edit.
+// herdr protocol 22, schema_version 1.
+import { MethodClientWindowTitleClear, MethodClientWindowTitleSet, MethodClientShellSurfaceSet, MethodServerSshAgentRegister } from '../names/method.js';
+/** Method names of the held entry point, sorted. */
+export const HELD_METHODS = [MethodClientWindowTitleClear, MethodClientWindowTitleSet, MethodClientShellSurfaceSet, MethodServerSshAgentRegister];

package/dist/herdr/generated/entries/prompt.d.ts

@@ -0,0 +1,2 @@
+/** Method names of the prompt entry point, sorted. */
+export declare const PROMPT_METHODS: readonly ["agent.explain", "agent.get", "agent.list", "agent.prompt", "integration.list", "layout.export", "pane.current", "pane.edges", "pane.get", "pane.layout", "pane.link.resolve", "pane.list", "pane.neighbor", "pane.process_info", "ping", "plugin.action.list", "plugin.list", "plugin.log.list", "server.agent_manifests", "session.snapshot", "tab.get", "tab.list", "workspace.get", "workspace.list", "worktree.list"];

package/dist/herdr/generated/entries/prompt.js

@@ -0,0 +1,5 @@
+// GENERATED by tools/gen/ from schema/herdr-api.schema.json. Do not edit.
+// herdr protocol 22, schema_version 1.
+import { MethodAgentExplain, MethodAgentGet, MethodAgentList, MethodAgentPrompt, MethodIntegrationList, MethodLayoutExport, MethodPaneCurrent, MethodPaneEdges, MethodPaneGet, MethodPaneLayout, MethodPaneLinkResolve, MethodPaneList, MethodPaneNeighbor, MethodPaneProcessInfo, MethodPing, MethodPluginActionList, MethodPluginList, MethodPluginLogList, MethodServerAgentManifests, MethodSessionSnapshot, MethodTabGet, MethodTabList, MethodWorkspaceGet, MethodWorkspaceList, MethodWorktreeList } from '../names/method.js';
+/** Method names of the prompt entry point, sorted. */
+export const PROMPT_METHODS = [MethodAgentExplain, MethodAgentGet, MethodAgentList, MethodAgentPrompt, MethodIntegrationList, MethodLayoutExport, MethodPaneCurrent, MethodPaneEdges, MethodPaneGet, MethodPaneLayout, MethodPaneLinkResolve, MethodPaneList, MethodPaneNeighbor, MethodPaneProcessInfo, MethodPing, MethodPluginActionList, MethodPluginList, MethodPluginLogList, MethodServerAgentManifests, MethodSessionSnapshot, MethodTabGet, MethodTabList, MethodWorkspaceGet, MethodWorkspaceList, MethodWorktreeList];

package/dist/herdr/generated/entries/read-only-content.d.ts

@@ -0,0 +1,2 @@
+/** Method names of the readOnlyContent entry point, sorted. */
+export declare const READ_ONLY_CONTENT_METHODS: readonly ["agent.explain", "agent.get", "agent.list", "agent.read", "agent.wait", "events.subscribe", "events.wait", "integration.list", "layout.export", "pane.current", "pane.edges", "pane.get", "pane.layout", "pane.link.resolve", "pane.list", "pane.neighbor", "pane.process_info", "pane.read", "pane.selection.read", "pane.wait_for_output", "ping", "plugin.action.list", "plugin.list", "plugin.log.list", "server.agent_manifests", "session.snapshot", "tab.get", "tab.list", "workspace.get", "workspace.list", "worktree.list"];

package/dist/herdr/generated/entries/read-only-content.js

@@ -0,0 +1,5 @@
+// GENERATED by tools/gen/ from schema/herdr-api.schema.json. Do not edit.
+// herdr protocol 22, schema_version 1.
+import { MethodAgentExplain, MethodAgentGet, MethodAgentList, MethodAgentRead, MethodAgentWait, MethodEventsSubscribe, MethodEventsWait, MethodIntegrationList, MethodLayoutExport, MethodPaneCurrent, MethodPaneEdges, MethodPaneGet, MethodPaneLayout, MethodPaneLinkResolve, MethodPaneList, MethodPaneNeighbor, MethodPaneProcessInfo, MethodPaneRead, MethodPaneSelectionRead, MethodPaneWaitForOutput, MethodPing, MethodPluginActionList, MethodPluginList, MethodPluginLogList, MethodServerAgentManifests, MethodSessionSnapshot, MethodTabGet, MethodTabList, MethodWorkspaceGet, MethodWorkspaceList, MethodWorktreeList } from '../names/method.js';
+/** Method names of the readOnlyContent entry point, sorted. */
+export const READ_ONLY_CONTENT_METHODS = [MethodAgentExplain, MethodAgentGet, MethodAgentList, MethodAgentRead, MethodAgentWait, MethodEventsSubscribe, MethodEventsWait, MethodIntegrationList, MethodLayoutExport, MethodPaneCurrent, MethodPaneEdges, MethodPaneGet, MethodPaneLayout, MethodPaneLinkResolve, MethodPaneList, MethodPaneNeighbor, MethodPaneProcessInfo, MethodPaneRead, MethodPaneSelectionRead, MethodPaneWaitForOutput, MethodPing, MethodPluginActionList, MethodPluginList, MethodPluginLogList, MethodServerAgentManifests, MethodSessionSnapshot, MethodTabGet, MethodTabList, MethodWorkspaceGet, MethodWorkspaceList, MethodWorktreeList];

package/dist/herdr/generated/entries/read-only.d.ts

@@ -0,0 +1,2 @@
+/** Method names of the readOnly entry point, sorted. */
+export declare const READ_ONLY_METHODS: readonly ["agent.explain", "agent.get", "agent.list", "agent.wait", "events.subscribe", "events.wait", "integration.list", "layout.export", "pane.current", "pane.edges", "pane.get", "pane.layout", "pane.link.resolve", "pane.list", "pane.neighbor", "pane.process_info", "pane.wait_for_output", "ping", "plugin.action.list", "plugin.list", "plugin.log.list", "server.agent_manifests", "session.snapshot", "tab.get", "tab.list", "workspace.get", "workspace.list", "worktree.list"];

package/dist/herdr/generated/entries/read-only.js

@@ -0,0 +1,5 @@
+// GENERATED by tools/gen/ from schema/herdr-api.schema.json. Do not edit.
+// herdr protocol 22, schema_version 1.
+import { MethodAgentExplain, MethodAgentGet, MethodAgentList, MethodAgentWait, MethodEventsSubscribe, MethodEventsWait, MethodIntegrationList, MethodLayoutExport, MethodPaneCurrent, MethodPaneEdges, MethodPaneGet, MethodPaneLayout, MethodPaneLinkResolve, MethodPaneList, MethodPaneNeighbor, MethodPaneProcessInfo, MethodPaneWaitForOutput, MethodPing, MethodPluginActionList, MethodPluginList, MethodPluginLogList, MethodServerAgentManifests, MethodSessionSnapshot, MethodTabGet, MethodTabList, MethodWorkspaceGet, MethodWorkspaceList, MethodWorktreeList } from '../names/method.js';
+/** Method names of the readOnly entry point, sorted. */
+export const READ_ONLY_METHODS = [MethodAgentExplain, MethodAgentGet, MethodAgentList, MethodAgentWait, MethodEventsSubscribe, MethodEventsWait, MethodIntegrationList, MethodLayoutExport, MethodPaneCurrent, MethodPaneEdges, MethodPaneGet, MethodPaneLayout, MethodPaneLinkResolve, MethodPaneList, MethodPaneNeighbor, MethodPaneProcessInfo, MethodPaneWaitForOutput, MethodPing, MethodPluginActionList, MethodPluginList, MethodPluginLogList, MethodServerAgentManifests, MethodSessionSnapshot, MethodTabGet, MethodTabList, MethodWorkspaceGet, MethodWorkspaceList, MethodWorktreeList];

package/dist/herdr/generated/entry-methods.d.ts

@@ -0,0 +1,9 @@
+/** Method names per entry point, sorted; the class sets are in tools/gen/capabilities.ts. */
+export declare const ENTRY_METHODS: {
+    readonly readOnly: readonly ["agent.explain", "agent.get", "agent.list", "agent.wait", "events.subscribe", "events.wait", "integration.list", "layout.export", "pane.current", "pane.edges", "pane.get", "pane.layout", "pane.link.resolve", "pane.list", "pane.neighbor", "pane.process_info", "pane.wait_for_output", "ping", "plugin.action.list", "plugin.list", "plugin.log.list", "server.agent_manifests", "session.snapshot", "tab.get", "tab.list", "workspace.get", "workspace.list", "worktree.list"];
+    readonly readOnlyContent: readonly ["agent.explain", "agent.get", "agent.list", "agent.read", "agent.wait", "events.subscribe", "events.wait", "integration.list", "layout.export", "pane.current", "pane.edges", "pane.get", "pane.layout", "pane.link.resolve", "pane.list", "pane.neighbor", "pane.process_info", "pane.read", "pane.selection.read", "pane.wait_for_output", "ping", "plugin.action.list", "plugin.list", "plugin.log.list", "server.agent_manifests", "session.snapshot", "tab.get", "tab.list", "workspace.get", "workspace.list", "worktree.list"];
+    readonly prompt: readonly ["agent.explain", "agent.get", "agent.list", "agent.prompt", "integration.list", "layout.export", "pane.current", "pane.edges", "pane.get", "pane.layout", "pane.link.resolve", "pane.list", "pane.neighbor", "pane.process_info", "ping", "plugin.action.list", "plugin.list", "plugin.log.list", "server.agent_manifests", "session.snapshot", "tab.get", "tab.list", "workspace.get", "workspace.list", "worktree.list"];
+    readonly client: readonly ["agent.explain", "agent.focus", "agent.get", "agent.list", "agent.prompt", "agent.read", "agent.rename", "agent.send_keys", "agent.view.clear", "agent.view.set", "agent.wait", "events.subscribe", "events.wait", "integration.list", "layout.apply", "layout.export", "layout.set_split_ratio", "notification.show", "pane.clear", "pane.clear_agent_authority", "pane.copy_motion", "pane.copy_search", "pane.current", "pane.edges", "pane.focus", "pane.focus_direction", "pane.get", "pane.input.set", "pane.layout", "pane.link.resolve", "pane.list", "pane.move", "pane.neighbor", "pane.process_info", "pane.read", "pane.release_agent", "pane.rename", "pane.report_agent", "pane.report_agent_session", "pane.report_metadata", "pane.resize", "pane.scroll", "pane.selection.read", "pane.send_input", "pane.send_keys", "pane.send_text", "pane.split", "pane.swap", "pane.wait_for_output", "pane.zoom", "ping", "plugin.action.list", "plugin.disable", "plugin.list", "plugin.log.list", "plugin.pane.focus", "product_announcement.dismiss", "release_notes.dismiss", "server.agent_manifests", "session.snapshot", "tab.create", "tab.focus", "tab.get", "tab.list", "tab.move", "tab.rename", "workspace.create", "workspace.focus", "workspace.get", "workspace.list", "workspace.move", "workspace.move_block", "workspace.rename", "workspace.report_metadata", "worktree.create", "worktree.list", "worktree.open"];
+    readonly admin: readonly ["agent.explain", "agent.focus", "agent.get", "agent.list", "agent.prompt", "agent.read", "agent.rename", "agent.send_keys", "agent.start", "agent.view.clear", "agent.view.set", "agent.wait", "command.invoke", "events.subscribe", "events.wait", "integration.install", "integration.list", "integration.uninstall", "layout.apply", "layout.export", "layout.set_split_ratio", "notification.show", "pane.clear", "pane.clear_agent_authority", "pane.close", "pane.copy_motion", "pane.copy_search", "pane.current", "pane.edges", "pane.edit_scrollback", "pane.focus", "pane.focus_direction", "pane.get", "pane.input.set", "pane.layout", "pane.link.activate", "pane.link.resolve", "pane.list", "pane.move", "pane.neighbor", "pane.process_info", "pane.read", "pane.release_agent", "pane.rename", "pane.report_agent", "pane.report_agent_session", "pane.report_metadata", "pane.resize", "pane.scroll", "pane.selection.read", "pane.send_input", "pane.send_keys", "pane.send_text", "pane.split", "pane.swap", "pane.wait_for_output", "pane.zoom", "ping", "plugin.action.invoke", "plugin.action.list", "plugin.disable", "plugin.enable", "plugin.link", "plugin.list", "plugin.log.list", "plugin.pane.close", "plugin.pane.focus", "plugin.pane.open", "plugin.unlink", "popup.close", "product_announcement.dismiss", "release_notes.dismiss", "server.agent_manifests", "server.live_handoff", "server.reload_agent_manifests", "server.reload_config", "server.stop", "session.snapshot", "tab.close", "tab.create", "tab.focus", "tab.get", "tab.list", "tab.move", "tab.rename", "workspace.close", "workspace.create", "workspace.focus", "workspace.get", "workspace.list", "workspace.move", "workspace.move_block", "workspace.rename", "workspace.report_metadata", "worktree.create", "worktree.list", "worktree.open", "worktree.remove"];
+    readonly held: readonly ["client.window_title.clear", "client.window_title.set", "client_shell.surface.set", "server.ssh_agent.register"];
+};

package/dist/herdr/generated/entry-methods.js

@@ -0,0 +1,17 @@
+// GENERATED by tools/gen/ from schema/herdr-api.schema.json. Do not edit.
+// herdr protocol 22, schema_version 1.
+import { READ_ONLY_METHODS } from './entries/read-only.js';
+import { READ_ONLY_CONTENT_METHODS } from './entries/read-only-content.js';
+import { PROMPT_METHODS } from './entries/prompt.js';
+import { CLIENT_METHODS } from './entries/client.js';
+import { ADMIN_METHODS } from './entries/admin.js';
+import { HELD_METHODS } from './entries/held.js';
+/** Method names per entry point, sorted; the class sets are in tools/gen/capabilities.ts. */
+export const ENTRY_METHODS = {
+    "readOnly": READ_ONLY_METHODS,
+    "readOnlyContent": READ_ONLY_CONTENT_METHODS,
+    "prompt": PROMPT_METHODS,
+    "client": CLIENT_METHODS,
+    "admin": ADMIN_METHODS,
+    "held": HELD_METHODS,
+};

package/dist/herdr/generated/errors.d.ts

@@ -0,0 +1,4 @@
+export type ErrorBody = {
+    "code": string;
+    "message": string;
+};

package/dist/herdr/generated/errors.js

@@ -0,0 +1,3 @@
+// GENERATED by tools/gen/ from schema/herdr-api.schema.json. Do not edit.
+// herdr protocol 22, schema_version 1.
+export {};