@byokit/herdr 0.1.0-next.dbe7142 → 0.1.1

package/dist/testing/fake-herdr/world.js

@@ -24,18 +24,36 @@ export function agentRecord(o) {
         name: o.name,
         agent: o.kind,
         display_agent: o.name,
+        title: o.name,
         agent_status: 'idle',
         interactive_ready: true,
         launch_pending: false,
         revision: o.revision,
+        terminal_id: `term-${o.paneId}`,
+        focused: o.focused ?? false,
         agent_session: { source: `herdr:${o.kind}`, agent: o.kind, kind: 'id', value: `gen-${o.paneId}` },
     };
 }
+export function pluginRecord(o) {
+    return {
+        plugin_id: o.seed.plugin_id,
+        name: o.seed.name ?? o.seed.plugin_id,
+        version: o.seed.version ?? '0.0.0',
+        manifest_path: `${o.dir}/plugins/${o.seed.plugin_id}/herdr.plugin.json`,
+        plugin_root: `${o.dir}/plugins/${o.seed.plugin_id}`,
+        enabled: o.seed.enabled ?? true,
+    };
+}
+export function paneScroll() {
+    return { offset_from_bottom: 0, max_offset_from_bottom: 0, viewport_rows: ROWS };
+}
 export function createWorld(o) {
     const workspace = {
         workspace_id: 'w1',
         label: o.cwd,
         focused: true,
+        number: 1,
+        tokens: {},
         worktree: {
             repo_key: 'fake-herdr',
             repo_name: 'fake-herdr',
@@ -58,6 +76,8 @@ export function createWorld(o) {
         tokens: {},
         rect: paneRect(0, 2),
         text: ['ready.'],
+        revision: 0,
+        scroll: paneScroll(),
     };
     const kind = o.kinds[0] ?? 'pi';
     const agentPane = {
@@ -69,12 +89,15 @@ export function createWorld(o) {
         label: kind,
         terminal_title: `${kind} · ${kind}`,
         terminal_title_stripped: `${kind} · ${kind}`,
+        revision: 0,
+        scroll: paneScroll(), // its own scroll: the spread would alias the shell's object
     };
     const agent = agentRecord({
         paneId: agentPane.pane_id, tabId: tab.tab_id, workspaceId: 'w1', cwd: o.cwd,
         name: kind, kind, revision: 0,
     });
-    return { cwd: o.cwd, workspaces: [workspace], tabs: [tab], panes: [shell, agentPane], agents: [agent] };
+    const plugins = (o.plugins ?? []).map((seed) => pluginRecord({ dir: o.cwd, seed }));
+    return { cwd: o.cwd, workspaces: [workspace], tabs: [tab], panes: [shell, agentPane], agents: [agent], plugins };
 }
 export function relayoutTab(world, tabId) {
     const panes = world.panes.filter((pane) => pane.tab_id === tabId);

package/dist/testing/index.d.ts

@@ -1,4 +1,4 @@
-export { startFakeHerdr, type FakeHerdr, type FakeHerdrOptions } from './fake-herdr/server.ts';
+export { startFakeHerdr, type AgentStartFault, type FakeHerdr, type FakeHerdrOptions } from './fake-herdr/server.ts';
 export { writeBinShim, main as fakeHerdrBinMain } from './fake-herdr/bin.ts';
 export { createWorld, type FakeWorld } from './fake-herdr/world.ts';
-export { herdrContract, type HerdrContractBench } from './contract.ts';
+export { herdrContract, type HerdrContractBench, type HerdrContractOptions, type HerdrContractTestFn, type HerdrContractTestContext } from './contract.ts';

package/dist/testing/index.js

@@ -1,6 +1,15 @@
 // The kit's fake Herdr and contract suite (docs/runtime-kits.md 6.8). Built in H6; H3/H5 run the
 // contract against the fake, H9 against the real pinned Herdr. Tests import this by relative path —
 // the package's public exports stay the kit surface.
+//
+// The fake's documented test handle is `FakeHerdr`: `fake.world` is the LIVE world the server
+// answers from (mutable, with seeded ids from `world.seed`), `fake.emit` routes frames to the
+// sockets watching them (filtered kinds reach only their pane's watchers), `fake.watching()`
+// lists the watched panes, `fake.snapshotCount()` counts `session.snapshot` calls, and the
+// `holdSnapshot`/`failNextSnapshot`/`holdAck`/`failNextAck` hooks script slow or failing answers.
+// The bin shim speaks real terminal frames (`{ type: 'terminal.frame', full, bytes }`, plus a
+// `data` alias) with `terminal.resize`/`terminal.input` on stdin, and `api schema` prints the
+// pinned v0.9.1 snapshot.
 export { startFakeHerdr } from "./fake-herdr/server.js";
 export { writeBinShim, main as fakeHerdrBinMain } from "./fake-herdr/bin.js";
 export { createWorld } from "./fake-herdr/world.js";

package/dist/types.d.ts

@@ -2,6 +2,10 @@ export type HerdrState = {
     phase: 'stopped' | 'connecting' | 'ready' | 'reconnecting' | 'needs-update' | 'missing' | 'failed';
     why?: 'binary' | 'socket' | 'version' | 'server-exited';
 };
+export type HerdrProtocolRange = {
+    min?: number;
+    max?: number;
+};
 export type HerdrKitOptions = {
     mode: 'adopt';
     bin: string;
@@ -9,7 +13,9 @@ export type HerdrKitOptions = {
     env?: Record<string, string>;
     path?: string[];
     transport?: HerdrTransport;
+    protocolRange?: HerdrProtocolRange;
     onState?: (s: HerdrState) => void;
+    onLog?: (message: string) => void;
 } | {
     mode: 'own';
     bin: string;
@@ -17,14 +23,21 @@ export type HerdrKitOptions = {
     env?: Record<string, string>;
     path?: string[];
     transport?: HerdrTransport;
+    protocolRange?: HerdrProtocolRange;
     onState?: (s: HerdrState) => void;
+    onLog?: (message: string) => void;
+};
+export type HerdrSubscribeStop = (() => void) & {
+    ready: Promise<boolean>;
+    onReconnect(fn: () => void): void;
+    onDisconnect(fn: () => void): void;
 };
 export interface HerdrTransport {
     call(method: string, params: Record<string, unknown>, timeoutMs?: number): Promise<unknown>;
     subscribe(subs: {
         type: string;
         [k: string]: unknown;
-    }[], on: (e: HerdrEvent) => void, onError: (code: string, message: string) => void): () => void;
+    }[], on: (e: HerdrEvent) => void, onError: (code: string, message: string) => void): HerdrSubscribeStop;
     close(): void;
 }
 export type HerdrEvent = {
@@ -56,7 +69,7 @@ export type StartAgent = {
         pane: string;
     };
     worktree?: {
-        branch: string;
+        branch?: string;
         base?: string;
     };
     args?: string[];
@@ -78,28 +91,57 @@ export type BlockedAgent = {
     prompt: string;
     since: number;
 };
+export type AgentSessionRef = {
+    source: string;
+    agent: string;
+    kind: string;
+    value: string;
+};
+export type HerdrSnapshotWorktree = {
+    repoKey: string;
+    repoName: string;
+    repoRoot: string;
+    checkoutPath: string;
+    isLinkedWorktree: boolean;
+};
+export type HerdrSnapshotAgent = {
+    kind?: string;
+    name?: string;
+    displayAgent?: string;
+    title?: string;
+    status: AgentStatus;
+    revision: number;
+    launchPending?: boolean;
+    interactiveReady?: boolean;
+    agentSession?: AgentSessionRef;
+    foregroundCwd?: string;
+};
+export type HerdrSnapshotPane = {
+    id: string;
+    cwd?: string;
+    label?: string;
+    focused: boolean;
+    terminalTitle?: string;
+    tokens?: Record<string, string>;
+    agent?: HerdrSnapshotAgent;
+};
+export type HerdrSnapshotTab = {
+    id: string;
+    label: string;
+    panes: HerdrSnapshotPane[];
+};
+export type HerdrSnapshotWorkspace = {
+    id: string;
+    label: string;
+    focused: boolean;
+    number: number;
+    tokens?: Record<string, string>;
+    worktree?: HerdrSnapshotWorktree;
+    tabs: HerdrSnapshotTab[];
+};
 export type HerdrSnapshot = {
     connected: boolean;
-    workspaces: {
-        id: string;
-        label: string;
-        tabs: {
-            id: string;
-            label: string;
-            panes: {
-                id: string;
-                cwd?: string;
-                agent?: {
-                    kind?: string;
-                    name?: string;
-                    status: AgentStatus;
-                    revision: number;
-                    launchPending?: boolean;
-                    interactiveReady?: boolean;
-                };
-            }[];
-        }[];
-    }[];
+    workspaces: HerdrSnapshotWorkspace[];
 };
 export type TerminalSession = {
     ready: Promise<void>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@byokit/herdr",
-  "version": "0.1.0-next.dbe7142",
+  "version": "0.1.1",
   "description": "Drive the Herdr on this computer — workspaces, tabs, panes, agents and blocked-approval answers — from an app, or hand it to a phone over @byokit/link.",
   "license": "Apache-2.0",
   "type": "module",
@@ -17,6 +17,10 @@
       "types": "./dist/index.d.ts",
       "default": "./dist/index.js"
     },
+    "./binary": {
+      "types": "./dist/binary.d.ts",
+      "default": "./dist/binary.js"
+    },
     "./device": {
       "react-native": {
         "types": "./dist/device.d.ts",
@@ -48,8 +52,8 @@
     "prepack": "tsc -b && node ../../scripts/fix-words-dts.cjs"
   },
   "dependencies": {
-    "@byokit/link": "0.3.1",
-    "@byokit/relay": "0.1.3",
+    "@byokit/link": "0.3.2",
+    "@byokit/relay": "0.2.0",
     "@byokit/reach": "0.2.0",
     "@byokit/seal": "0.1.0",
     "ws": "8.21.3"