@pelotto-tech/bellwether 0.0.0 → 0.1.0

package/runtime/adapter/dist/bin.js

@@ -0,0 +1,121 @@
+#!/usr/bin/env node
+import { parseArgs } from 'node:util';
+import { createSource, loadSourceConfig } from './config.js';
+import { MockSource } from './mock.js';
+import { recordTo, ReplaySource } from './recording.js';
+import { scrubDelta, scrubFile } from './scrub.js';
+import { DEFAULT_PORT, DELTA_PATH, DeltaServer } from './server.js';
+const USAGE = `bellwether-adapter: stream Herdr world deltas over WebSocket
+
+Source (default from bellwether.toml / BELLWETHER_SOURCE, else mock):
+  --live               read the live Herdr TUI socket API
+  --mock               generate mock agents
+  --replay <file>      replay a recorded .jsonl (loops)
+  --session <name>     live: one named session      --all   live: every running session
+  --socket <path>      live: explicit socket/pipe path
+  --config <file>      config file (default bellwether.toml)
+  --seed <n>           mock seed (default 1)
+  --interval <ms>      mock delta interval (default 1500)
+  --speed <n>          replay speed multiplier (default 1)
+
+Output:
+  --port <n>           WebSocket port (default ${DEFAULT_PORT}); deltas on ${DELTA_PATH}
+  --serve <dir>        also serve a built renderer from <dir>
+  --record <file>      append every delta to a .jsonl file
+  --scrub              with --record: hash repo/branch/workspace labels, strip say text and titles
+  --scrub-file <in> <out>  scrub an existing .jsonl recording and exit
+  --actions            let the overlay send prompts and keys to agents (focus is always allowed)
+  --pack <name>        skin pack for the served overlay (default from bellwether.toml, else neutral)
+  --print              print every delta to stdout as JSON lines
+  -h, --help`;
+const { values, positionals } = parseArgs({
+    options: {
+        live: { type: 'boolean' },
+        mock: { type: 'boolean' },
+        replay: { type: 'string' },
+        session: { type: 'string' },
+        all: { type: 'boolean' },
+        socket: { type: 'string' },
+        config: { type: 'string' },
+        seed: { type: 'string' },
+        interval: { type: 'string' },
+        speed: { type: 'string' },
+        port: { type: 'string' },
+        serve: { type: 'string' },
+        record: { type: 'string' },
+        scrub: { type: 'boolean' },
+        actions: { type: 'boolean' },
+        'scrub-file': { type: 'string' },
+        print: { type: 'boolean' },
+        pack: { type: 'string' },
+        help: { type: 'boolean', short: 'h' },
+    },
+    allowPositionals: true,
+});
+let scrubConfig = false;
+let actionsConfig = false;
+let clientPack = values.pack;
+if (values.help) {
+    console.log(USAGE);
+    process.exit(0);
+}
+if (values['scrub-file']) {
+    const out = positionals[0];
+    if (!out) {
+        process.stderr.write('usage: --scrub-file <in.jsonl> <out.jsonl>\n');
+        process.exit(1);
+    }
+    const n = scrubFile(values['scrub-file'], out);
+    process.stderr.write(`bellwether-adapter: scrubbed ${n} deltas into ${out}\n`);
+    process.exit(0);
+}
+const log = (m) => process.stderr.write(m + '\n');
+async function pickSource() {
+    if (values.replay) {
+        return ReplaySource.fromFile(values.replay, { speed: Number(values.speed ?? 1), loop: true });
+    }
+    const cfg = await loadSourceConfig(values.config ?? 'bellwether.toml');
+    if (values.pack)
+        cfg.pack = values.pack;
+    clientPack = cfg.pack ?? clientPack;
+    scrubConfig = cfg.scrub ?? false;
+    actionsConfig = cfg.actions ?? false;
+    if (values.live)
+        cfg.source = 'live';
+    if (values.mock)
+        cfg.source = 'mock';
+    if (values.session)
+        cfg.herdr.sessions = [values.session];
+    if (values.all)
+        cfg.herdr.sessions = 'all';
+    if (values.socket)
+        cfg.herdr.socket = values.socket;
+    log(`bellwether-adapter: source=${cfg.source}`);
+    return createSource(cfg, {
+        log,
+        mock: () => new MockSource({ seed: Number(values.seed ?? 1), intervalMs: Number(values.interval ?? 1500) }),
+    });
+}
+const source = await pickSource();
+const server = new DeltaServer({ port: Number(values.port ?? DEFAULT_PORT), staticDir: values.serve, clientConfig: clientPack ? { pack: clientPack } : {}, actions: values.actions || actionsConfig, log });
+server.attach(source);
+if (values.record) {
+    const rec = recordTo(values.record);
+    const scrubOn = values.scrub || scrubConfig;
+    source.on('delta', scrubOn ? (d) => rec(scrubDelta(d)) : rec);
+}
+if (values.print)
+    source.on('delta', (d) => process.stdout.write(JSON.stringify(d) + '\n'));
+const port = await server.listen();
+await source.start();
+log(`bellwether-adapter: deltas on ws://127.0.0.1:${port}${DELTA_PATH}`);
+if (values.serve)
+    log(`bellwether-adapter: overlay at http://127.0.0.1:${port}/`);
+const shutdown = async () => {
+    await source.stop();
+    await server.close();
+    process.exit(0);
+};
+process.on('SIGINT', shutdown);
+process.on('SIGTERM', shutdown);
+//# sourceMappingURL=bin.js.map

package/runtime/adapter/dist/bin.js.map

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

package/runtime/adapter/dist/config.d.ts

@@ -0,0 +1,41 @@
+import type { WorldSource } from './source.js';
+export type SourceKind = 'mock' | 'live';
+export interface SourceConfig {
+    source: SourceKind;
+    /** Skin pack the overlay shows (a folder name under themes/). The renderer falls back to neutral if it is unknown. */
+    pack?: string;
+    /** Scrub recordings at record time (`scrub = true`). */
+    scrub?: boolean;
+    /** Let the overlay send prompts and keys to agents (`actions = true`). Focus is always allowed. */
+    actions?: boolean;
+    herdr: {
+        /** `"all"` discovers running sessions; a list names them; omitted uses HERDR_SESSION or default. */
+        sessions?: 'all' | string[];
+        socket?: string;
+    };
+}
+export declare const DEFAULT_CONFIG: SourceConfig;
+/**
+ * Parse the source section of `bellwether.toml`:
+ *
+ * ```toml
+ * source = "live"            # or "mock"
+ * pack = "aesir"             # skin pack: neutral, aesir, wayfarers, or a private theme folder
+ * scrub = true               # hash labels and strip say text in recordings
+ * actions = true             # let the overlay prompt and send keys to agents (focus is always on)
+ * [herdr]
+ * sessions = "all"           # or ["default", "overlay-dev"]
+ * # socket = "/path/to/herdr.sock"
+ * ```
+ */
+export declare function parseSourceConfig(text: string): SourceConfig;
+/** Load config from a file (missing file means defaults), then apply env overrides. */
+export declare function loadSourceConfig(file?: string, env?: NodeJS.ProcessEnv): Promise<SourceConfig>;
+export interface CreateSourceDeps {
+    log?: (msg: string) => void;
+    /** Factories, overridable in tests. */
+    live?: (cfg: SourceConfig) => WorldSource;
+    mock?: (cfg: SourceConfig) => WorldSource;
+}
+/** Pick the world source named by config. */
+export declare function createSource(cfg: SourceConfig, deps?: CreateSourceDeps): WorldSource;

package/runtime/adapter/dist/config.js

@@ -0,0 +1,71 @@
+import { readFile } from 'node:fs/promises';
+import { parse } from 'smol-toml';
+import { HerdrSource } from './herdr/source.js';
+import { MockSource } from './mock.js';
+export const DEFAULT_CONFIG = { source: 'mock', herdr: {} };
+/**
+ * Parse the source section of `bellwether.toml`:
+ *
+ * ```toml
+ * source = "live"            # or "mock"
+ * pack = "aesir"             # skin pack: neutral, aesir, wayfarers, or a private theme folder
+ * scrub = true               # hash labels and strip say text in recordings
+ * actions = true             # let the overlay prompt and send keys to agents (focus is always on)
+ * [herdr]
+ * sessions = "all"           # or ["default", "overlay-dev"]
+ * # socket = "/path/to/herdr.sock"
+ * ```
+ */
+export function parseSourceConfig(text) {
+    const raw = parse(text);
+    const source = raw.source ?? DEFAULT_CONFIG.source;
+    if (source !== 'mock' && source !== 'live')
+        throw new Error(`bellwether.toml: source must be "mock" or "live", got ${JSON.stringify(source)}`);
+    const h = (raw.herdr ?? {});
+    const herdr = {};
+    if (h.sessions !== undefined) {
+        if (h.sessions === 'all')
+            herdr.sessions = 'all';
+        else if (typeof h.sessions === 'string')
+            herdr.sessions = [h.sessions];
+        else if (Array.isArray(h.sessions) && h.sessions.every((s) => typeof s === 'string'))
+            herdr.sessions = h.sessions;
+        else
+            throw new Error('bellwether.toml: herdr.sessions must be "all", a name, or a list of names');
+    }
+    if (typeof h.socket === 'string')
+        herdr.socket = h.socket;
+    if (raw.pack !== undefined && (typeof raw.pack !== 'string' || !/^[a-z0-9][a-z0-9_-]*$/i.test(raw.pack))) {
+        throw new Error('bellwether.toml: pack must be a theme folder name');
+    }
+    if (raw.scrub !== undefined && typeof raw.scrub !== 'boolean')
+        throw new Error('bellwether.toml: scrub must be true or false');
+    if (raw.actions !== undefined && typeof raw.actions !== 'boolean')
+        throw new Error('bellwether.toml: actions must be true or false');
+    return { source, ...(raw.actions === true ? { actions: true } : {}), ...(raw.scrub === true ? { scrub: true } : {}), ...(typeof raw.pack === 'string' ? { pack: raw.pack } : {}), herdr };
+}
+/** Load config from a file (missing file means defaults), then apply env overrides. */
+export async function loadSourceConfig(file = 'bellwether.toml', env = process.env) {
+    let cfg = { ...DEFAULT_CONFIG, herdr: {} };
+    try {
+        cfg = parseSourceConfig(await readFile(file, 'utf8'));
+    }
+    catch (err) {
+        if (err.code !== 'ENOENT')
+            throw err;
+    }
+    const override = env.BELLWETHER_SOURCE;
+    if (override === 'mock' || override === 'live')
+        cfg.source = override;
+    if (env.BELLWETHER_PACK && /^[a-z0-9][a-z0-9_-]*$/i.test(env.BELLWETHER_PACK))
+        cfg.pack = env.BELLWETHER_PACK;
+    return cfg;
+}
+/** Pick the world source named by config. */
+export function createSource(cfg, deps = {}) {
+    if (cfg.source === 'live') {
+        return deps.live ? deps.live(cfg) : new HerdrSource({ sessions: cfg.herdr.sessions, socket: cfg.herdr.socket, log: deps.log });
+    }
+    return deps.mock ? deps.mock(cfg) : new MockSource();
+}
+//# sourceMappingURL=config.js.map

package/runtime/adapter/dist/config.js.map

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

package/runtime/adapter/dist/core.d.ts

@@ -0,0 +1,8 @@
+export * from './types.js';
+export * from './rollup.js';
+export * from './roles.js';
+export * from './world.js';
+export * from './source.js';
+export * from './actions.js';
+export * from './mock.js';
+export { createRng } from './random.js';

package/runtime/adapter/dist/core.js

@@ -0,0 +1,10 @@
+// Browser-safe entry: no Node built-ins. The renderer imports from here.
+export * from './types.js';
+export * from './rollup.js';
+export * from './roles.js';
+export * from './world.js';
+export * from './source.js';
+export * from './actions.js';
+export * from './mock.js';
+export { createRng } from './random.js';
+//# sourceMappingURL=core.js.map

package/runtime/adapter/dist/core.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"core.js","sourceRoot":"","sources":["../src/core.ts"],"names":[],"mappings":"AAAA,yEAAyE;AACzE,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,WAAW,CAAC;AAC1B,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC"}

package/runtime/adapter/dist/herdr/connection.d.ts

@@ -0,0 +1,34 @@
+import { EventEmitter } from 'node:events';
+import net from 'node:net';
+import type { SuccessResponse } from './protocol.js';
+export declare class HerdrError extends Error {
+    readonly code: string;
+    constructor(code: string, message: string);
+}
+export type Connector = (connectPath: string) => net.Socket;
+/**
+ * One NDJSON connection to a Herdr server socket (Unix socket or Windows named pipe).
+ *
+ * Events:
+ * - `event` (EventLine) pushed lines on a subscription connection
+ * - `error` (Error) a request-less error, e.g. `events_lost` on a subscription
+ * - `close` () the socket closed
+ */
+export declare class HerdrConnection extends EventEmitter {
+    private readonly socket;
+    private buf;
+    private seq;
+    private pending;
+    private closed;
+    private constructor();
+    static open(connectPath: string, connector?: Connector, timeoutMs?: number): Promise<HerdrConnection>;
+    get isClosed(): boolean;
+    request(method: string, params?: Record<string, unknown>, timeoutMs?: number): Promise<SuccessResponse['result']>;
+    /** Start a subscription on this connection. Resolves on `subscription_started`. */
+    subscribe(subscriptions: Array<Record<string, unknown>>, timeoutMs?: number): Promise<void>;
+    close(): void;
+    private onData;
+    private onLine;
+    private failAll;
+    private onClose;
+}

package/runtime/adapter/dist/herdr/connection.js

@@ -0,0 +1,137 @@
+import { EventEmitter } from 'node:events';
+import net from 'node:net';
+import { isError, isEvent } from './protocol.js';
+export class HerdrError extends Error {
+    code;
+    constructor(code, message) {
+        super(`${code}: ${message}`);
+        this.code = code;
+        this.name = 'HerdrError';
+    }
+}
+const defaultConnector = (p) => net.connect(p);
+/**
+ * One NDJSON connection to a Herdr server socket (Unix socket or Windows named pipe).
+ *
+ * Events:
+ * - `event` (EventLine) pushed lines on a subscription connection
+ * - `error` (Error) a request-less error, e.g. `events_lost` on a subscription
+ * - `close` () the socket closed
+ */
+export class HerdrConnection extends EventEmitter {
+    socket;
+    buf = '';
+    seq = 0;
+    pending = new Map();
+    closed = false;
+    constructor(socket) {
+        super();
+        this.socket = socket;
+        socket.setEncoding('utf8');
+        socket.on('data', (chunk) => this.onData(chunk));
+        socket.on('close', () => this.onClose());
+        socket.on('error', (err) => this.failAll(err));
+    }
+    static open(connectPath, connector = defaultConnector, timeoutMs = 5000) {
+        return new Promise((resolve, reject) => {
+            const socket = connector(connectPath);
+            const timer = setTimeout(() => {
+                socket.destroy();
+                reject(new HerdrError('connect_timeout', `no answer from ${connectPath}`));
+            }, timeoutMs);
+            socket.once('connect', () => {
+                clearTimeout(timer);
+                socket.removeListener('error', onErr);
+                resolve(new HerdrConnection(socket));
+            });
+            const onErr = (err) => {
+                clearTimeout(timer);
+                reject(err);
+            };
+            socket.once('error', onErr);
+        });
+    }
+    get isClosed() {
+        return this.closed;
+    }
+    request(method, params = {}, timeoutMs = 10_000) {
+        if (this.closed)
+            return Promise.reject(new HerdrError('closed', 'connection closed'));
+        const id = `bw_${++this.seq}`;
+        return new Promise((resolve, reject) => {
+            const p = { resolve, reject };
+            if (timeoutMs > 0) {
+                p.timer = setTimeout(() => {
+                    this.pending.delete(id);
+                    reject(new HerdrError('timeout', `${method} timed out`));
+                }, timeoutMs);
+            }
+            this.pending.set(id, p);
+            this.socket.write(JSON.stringify({ id, method, params }) + '\n');
+        });
+    }
+    /** Start a subscription on this connection. Resolves on `subscription_started`. */
+    async subscribe(subscriptions, timeoutMs = 10_000) {
+        const res = await this.request('events.subscribe', { subscriptions }, timeoutMs);
+        if (res.type !== 'subscription_started')
+            throw new HerdrError('unexpected', `subscribe answered ${res.type}`);
+    }
+    close() {
+        if (this.closed)
+            return;
+        this.socket.destroy();
+    }
+    onData(chunk) {
+        this.buf += chunk;
+        let nl;
+        while ((nl = this.buf.indexOf('\n')) >= 0) {
+            const raw = this.buf.slice(0, nl).trim();
+            this.buf = this.buf.slice(nl + 1);
+            if (!raw)
+                continue;
+            let line;
+            try {
+                line = JSON.parse(raw);
+            }
+            catch {
+                continue; // tolerate garbage lines
+            }
+            this.onLine(line);
+        }
+    }
+    onLine(line) {
+        if (isEvent(line)) {
+            this.emit('event', line);
+            return;
+        }
+        const p = this.pending.get(line.id);
+        if (p) {
+            this.pending.delete(line.id);
+            if (p.timer)
+                clearTimeout(p.timer);
+            if (isError(line))
+                p.reject(new HerdrError(line.error.code, line.error.message));
+            else
+                p.resolve(line.result);
+            return;
+        }
+        if (isError(line)) {
+            // e.g. events_lost, sent with the original subscription id after it started
+            this.emit('error', new HerdrError(line.error.code, line.error.message));
+        }
+    }
+    failAll(err) {
+        for (const [, p] of this.pending) {
+            if (p.timer)
+                clearTimeout(p.timer);
+            p.reject(err);
+        }
+        this.pending.clear();
+    }
+    onClose() {
+        this.closed = true;
+        this.failAll(new HerdrError('closed', 'connection closed'));
+        this.emit('close');
+    }
+}
+//# sourceMappingURL=connection.js.map

package/runtime/adapter/dist/herdr/connection.js.map

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

package/runtime/adapter/dist/herdr/index.d.ts

@@ -0,0 +1,5 @@
+export { HerdrConnection, HerdrError, type Connector } from './connection.js';
+export * from './mapper.js';
+export * from './paths.js';
+export { HerdrSessionSource, HerdrSource, type LiveOptions, type SessionSourceOptions } from './source.js';
+export type * from './protocol.js';

package/runtime/adapter/dist/herdr/index.js

@@ -0,0 +1,5 @@
+export { HerdrConnection, HerdrError } from './connection.js';
+export * from './mapper.js';
+export * from './paths.js';
+export { HerdrSessionSource, HerdrSource } from './source.js';
+//# sourceMappingURL=index.js.map

package/runtime/adapter/dist/herdr/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/herdr/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,UAAU,EAAkB,MAAM,iBAAiB,CAAC;AAC9E,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,OAAO,EAAE,kBAAkB,EAAE,WAAW,EAA+C,MAAM,aAAa,CAAC"}

package/runtime/adapter/dist/herdr/mapper.d.ts

@@ -0,0 +1,27 @@
+import type { Delta, Member, Party, Status } from '../types.js';
+import type { AgentInfo, AgentStatusChanged, PaneInfo, SessionSnapshot, WorkspaceInfo } from './protocol.js';
+export declare function toStatus(s: unknown): Status;
+/** Party ids are unique across sessions: `<session>/<workspace_id>`. */
+export declare function partyId(session: string, workspaceId: string): string;
+export interface MapContext {
+    session: string;
+    /** Branch names learned from worktree events, keyed by workspace_id. */
+    branches?: ReadonlyMap<string, string>;
+}
+export declare function memberFromPane(pane: PaneInfo | AgentInfo): Member | undefined;
+export declare function partyFromWorkspace(ws: WorkspaceInfo, members: Record<string, Member>, ctx: MapContext): Party;
+/** Build every party for one session from `session.snapshot`. Agent records win over pane records. */
+export declare function partiesFromSnapshot(snap: SessionSnapshot, ctx: MapContext): Record<string, Party>;
+/** Every pane id in the snapshot, for per-pane status subscriptions. */
+export declare function paneIds(snap: SessionSnapshot): string[];
+/**
+ * Apply a `pane.agent_status_changed` event. Returns the updated party, or
+ * undefined when the pane is not a known member (caller should re-read).
+ */
+export declare function applyStatusChange(parties: Record<string, Party>, ev: AgentStatusChanged, ctx: MapContext): {
+    party: Party;
+    member: Member;
+    rollupChanged: boolean;
+} | undefined;
+/** Deltas that turn `prev` into `next`. New parties and header changes send the whole party. */
+export declare function diffParties(prev: Record<string, Party>, next: Record<string, Party>, t: number): Delta[];

package/runtime/adapter/dist/herdr/mapper.js

@@ -0,0 +1,141 @@
+// Pure mapping from Herdr protocol records to the Bellwether world model.
+import { resolveRole } from '../roles.js';
+import { rollup } from '../rollup.js';
+const STATUSES = new Set(['working', 'done', 'blocked', 'idle', 'unknown']);
+export function toStatus(s) {
+    return typeof s === 'string' && STATUSES.has(s) ? s : 'unknown';
+}
+/** Party ids are unique across sessions: `<session>/<workspace_id>`. */
+export function partyId(session, workspaceId) {
+    return `${session}/${workspaceId}`;
+}
+export function memberFromPane(pane) {
+    if (!pane.agent)
+        return undefined;
+    const tokens = pane.tokens ?? {};
+    const name = 'name' in pane ? pane.name : undefined;
+    const seq = 'state_change_seq' in pane ? pane.state_change_seq : undefined;
+    const m = {
+        paneId: pane.pane_id,
+        agent: pane.agent,
+        role: resolveRole({ tokens, agentName: name, title: pane.title }),
+        status: toStatus(pane.agent_status),
+        lastChange: seq ?? pane.revision ?? 0,
+    };
+    if (pane.title)
+        m.title = pane.title;
+    if (tokens.say)
+        m.say = tokens.say;
+    return m;
+}
+export function partyFromWorkspace(ws, members, ctx) {
+    const list = Object.values(members);
+    const p = {
+        id: partyId(ctx.session, ws.workspace_id),
+        label: ws.label,
+        session: ctx.session,
+        isWorktree: ws.worktree?.is_linked_worktree ?? false,
+        status: list.length ? rollup(list) : toStatus(ws.agent_status),
+        members,
+        tokens: { ...(ws.tokens ?? {}) },
+    };
+    if (ws.worktree?.repo_name)
+        p.repo = ws.worktree.repo_name;
+    const branch = ctx.branches?.get(ws.workspace_id);
+    if (branch)
+        p.branch = branch;
+    return p;
+}
+/** Build every party for one session from `session.snapshot`. Agent records win over pane records. */
+export function partiesFromSnapshot(snap, ctx) {
+    const byWs = new Map();
+    const seen = new Set();
+    for (const rec of [...(snap.agents ?? []), ...(snap.panes ?? [])]) {
+        if (seen.has(rec.pane_id))
+            continue;
+        const m = memberFromPane(rec);
+        if (!m)
+            continue;
+        seen.add(rec.pane_id);
+        let ms = byWs.get(rec.workspace_id);
+        if (!ms)
+            byWs.set(rec.workspace_id, (ms = {}));
+        ms[m.paneId] = m;
+    }
+    const out = {};
+    for (const ws of snap.workspaces) {
+        // A workspace with no agents has nothing to show; it appears once an agent starts.
+        const members = byWs.get(ws.workspace_id);
+        if (!members)
+            continue;
+        const p = partyFromWorkspace(ws, members, ctx);
+        out[p.id] = p;
+    }
+    return out;
+}
+/** Every pane id in the snapshot, for per-pane status subscriptions. */
+export function paneIds(snap) {
+    return [...new Set((snap.panes ?? []).map((p) => p.pane_id))].sort();
+}
+/**
+ * Apply a `pane.agent_status_changed` event. Returns the updated party, or
+ * undefined when the pane is not a known member (caller should re-read).
+ */
+export function applyStatusChange(parties, ev, ctx) {
+    const party = parties[partyId(ctx.session, ev.workspace_id)];
+    const prev = party?.members[ev.pane_id];
+    if (!party || !prev)
+        return undefined;
+    const member = { ...prev, status: toStatus(ev.agent_status), lastChange: prev.lastChange + 1 };
+    if (ev.agent)
+        member.agent = ev.agent;
+    if (ev.title)
+        member.title = ev.title;
+    const members = { ...party.members, [member.paneId]: member };
+    const status = rollup(Object.values(members));
+    const next = { ...party, members, status };
+    return { party: next, member, rollupChanged: status !== party.status };
+}
+function sameMember(a, b) {
+    return a.agent === b.agent && a.role === b.role && a.status === b.status && a.title === b.title && a.say === b.say;
+}
+function samePartyHeader(a, b) {
+    return (a.label === b.label &&
+        a.repo === b.repo &&
+        a.branch === b.branch &&
+        a.isWorktree === b.isWorktree &&
+        a.status === b.status &&
+        a.session === b.session &&
+        JSON.stringify(a.tokens) === JSON.stringify(b.tokens));
+}
+/** Deltas that turn `prev` into `next`. New parties and header changes send the whole party. */
+export function diffParties(prev, next, t) {
+    const out = [];
+    for (const id of Object.keys(prev))
+        if (!next[id])
+            out.push({ t, kind: 'removed', partyId: id });
+    for (const [id, np] of Object.entries(next)) {
+        const op = prev[id];
+        if (!op) {
+            out.push({ t, kind: 'party', party: np });
+            for (const m of Object.values(np.members))
+                if (m.say)
+                    out.push({ t, kind: 'say', partyId: id, paneId: m.paneId, text: m.say });
+            continue;
+        }
+        for (const paneId of Object.keys(op.members))
+            if (!np.members[paneId])
+                out.push({ t, kind: 'removed', partyId: id, paneId });
+        for (const [paneId, nm] of Object.entries(np.members)) {
+            const om = op.members[paneId];
+            if (!om || !sameMember(om, nm))
+                out.push({ t, kind: 'member', partyId: id, member: nm });
+            if (nm.say && nm.say !== om?.say)
+                out.push({ t, kind: 'say', partyId: id, paneId, text: nm.say });
+        }
+        if (!samePartyHeader(op, np))
+            out.push({ t, kind: 'party', party: np });
+    }
+    return out;
+}
+//# sourceMappingURL=mapper.js.map