@pelotto-tech/bellwether 0.0.0 → 0.1.0

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

@@ -0,0 +1,316 @@
+import { EventEmitter } from 'node:events';
+import os from 'node:os';
+import { HerdrConnection, HerdrError } from './connection.js';
+import { applyStatusChange, diffParties, paneIds, partiesFromSnapshot } from './mapper.js';
+import { discoverSessions, resolveTarget } from './paths.js';
+import { AGENT_STATUS_CHANGED, LIFECYCLE_SUBSCRIPTIONS, } from './protocol.js';
+/**
+ * Live source for one Herdr session.
+ *
+ * Follows the recovery rules in docs/research/socket-api.mdx: subscribe first,
+ * then read `session.snapshot` on another connection; lifecycle events only
+ * invalidate and trigger a serialized re-read; `events_lost` or a dropped
+ * connection means reconnect, resubscribe and re-read. Agent status changes
+ * arrive on a second, per-pane subscription that is reopened whenever the pane
+ * set changes.
+ */
+export class HerdrSessionSource extends EventEmitter {
+    opts;
+    session;
+    parties = {};
+    branches = new Map();
+    lifecycle;
+    status;
+    rpc;
+    statusPanes = '';
+    running = false;
+    hasSnapshot = false;
+    refreshing = false;
+    dirty = false;
+    refreshTimer;
+    reconnectTimer;
+    backoff;
+    now;
+    log;
+    ctx;
+    constructor(opts) {
+        super();
+        this.opts = opts;
+        this.session = opts.target.session;
+        this.now = opts.now ?? Date.now;
+        this.log = opts.log ?? (() => { });
+        this.backoff = opts.minBackoffMs ?? 500;
+        this.ctx = { session: this.session, branches: this.branches };
+    }
+    /** Current parties for this session (read-only view). */
+    get current() {
+        return this.parties;
+    }
+    async start() {
+        if (this.running)
+            return;
+        this.running = true;
+        try {
+            await this.connect();
+        }
+        catch (err) {
+            this.log(`[${this.session}] connect failed: ${err.message}`);
+            this.scheduleReconnect();
+        }
+    }
+    async stop() {
+        this.running = false;
+        clearTimeout(this.refreshTimer);
+        clearTimeout(this.reconnectTimer);
+        for (const c of [this.lifecycle, this.status, this.rpc])
+            c?.close();
+        this.lifecycle = this.status = this.rpc = undefined;
+        this.statusPanes = '';
+    }
+    emitDelta(d) {
+        this.emit('delta', d);
+    }
+    async connect() {
+        const { connectPath } = this.opts.target;
+        const lc = await HerdrConnection.open(connectPath, this.opts.connector);
+        this.lifecycle = lc;
+        lc.on('event', (e) => this.onLifecycle(e));
+        lc.on('error', (err) => this.onStreamError('lifecycle', err));
+        lc.on('close', () => this.onStreamClosed(lc));
+        await lc.subscribe(LIFECYCLE_SUBSCRIPTIONS.map((type) => ({ type })));
+        this.backoff = this.opts.minBackoffMs ?? 500;
+        this.log(`[${this.session}] subscribed at ${connectPath}`);
+        await this.refresh();
+    }
+    onStreamError(which, err) {
+        const code = err instanceof HerdrError ? err.code : 'error';
+        this.log(`[${this.session}] ${which} stream: ${err.message}`);
+        if (code === 'events_lost') {
+            // Herdr closes the connection after this; onStreamClosed handles recovery.
+        }
+    }
+    onStreamClosed(conn) {
+        if (!this.running)
+            return;
+        if (conn === this.lifecycle) {
+            this.lifecycle = undefined;
+            this.status?.close();
+            this.rpc?.close();
+            this.scheduleReconnect();
+        }
+        else if (conn === this.status) {
+            // Status stream lost (events_lost, or a pane vanished before subscribe): re-read and resubscribe.
+            this.status = undefined;
+            this.statusPanes = '';
+            this.scheduleRefresh();
+        }
+    }
+    scheduleReconnect() {
+        if (!this.running)
+            return;
+        clearTimeout(this.reconnectTimer);
+        const delay = this.backoff;
+        this.backoff = Math.min(this.backoff * 2, this.opts.maxBackoffMs ?? 15_000);
+        this.reconnectTimer = setTimeout(() => {
+            this.connect().catch((err) => {
+                this.log(`[${this.session}] reconnect failed: ${err.message}`);
+                this.scheduleReconnect();
+            });
+        }, delay);
+    }
+    onLifecycle(e) {
+        const type = e.data.type ?? e.event;
+        if (type === 'worktree_created' || type === 'worktree_opened') {
+            const wt = e.data.worktree;
+            const ws = e.data.workspace;
+            if (wt?.branch && ws?.workspace_id)
+                this.branches.set(ws.workspace_id, wt.branch);
+        }
+        this.scheduleRefresh();
+    }
+    onStatus(e) {
+        if (e.event !== AGENT_STATUS_CHANGED)
+            return;
+        const ev = e.data;
+        const res = applyStatusChange(this.parties, ev, this.ctx);
+        if (!res) {
+            // A pane we don't model as a member yet (agent just appeared): re-read.
+            this.scheduleRefresh();
+            return;
+        }
+        this.parties = { ...this.parties, [res.party.id]: res.party };
+        const t = this.now();
+        this.emitDelta({ t, kind: 'member', partyId: res.party.id, member: res.member });
+        if (res.rollupChanged)
+            this.emitDelta({ t, kind: 'party', party: res.party });
+    }
+    scheduleRefresh() {
+        if (!this.running)
+            return;
+        clearTimeout(this.refreshTimer);
+        this.refreshTimer = setTimeout(() => void this.refresh(), this.opts.refreshDebounceMs ?? 50);
+    }
+    /** Serialized authoritative re-read. Events that land mid-read trigger one more read. */
+    async refresh() {
+        if (!this.running)
+            return;
+        if (this.refreshing) {
+            this.dirty = true;
+            return;
+        }
+        this.refreshing = true;
+        try {
+            do {
+                this.dirty = false;
+                const snap = await this.snapshot();
+                this.applySnapshot(snap);
+                await this.syncStatusSubscription(snap);
+            } while (this.dirty && this.running);
+        }
+        catch (err) {
+            this.log(`[${this.session}] refresh failed: ${err.message}`);
+            if (this.running && this.lifecycle)
+                this.scheduleRefresh();
+        }
+        finally {
+            this.refreshing = false;
+        }
+    }
+    async rpcConn() {
+        if (!this.rpc || this.rpc.isClosed) {
+            this.rpc = await HerdrConnection.open(this.opts.target.connectPath, this.opts.connector);
+            this.rpc.on('error', () => { });
+        }
+        return this.rpc;
+    }
+    /** Actions for this session, mapped to Herdr's request/response API. */
+    actions = {
+        focus: async (paneId) => void (await (await this.rpcConn()).request('pane.focus', { pane_id: paneId })),
+        prompt: async (paneId, text) => void (await (await this.rpcConn()).request('agent.prompt', { target: paneId, text })),
+        sendKeys: async (paneId, keys) => void (await (await this.rpcConn()).request('agent.send_keys', { target: paneId, keys })),
+    };
+    /** Whether this session currently has a member in `paneId`. */
+    hasPane(paneId) {
+        return Object.values(this.parties).some((p) => paneId in p.members);
+    }
+    async snapshot() {
+        const rpc = await this.rpcConn();
+        const res = await rpc.request('session.snapshot');
+        if (res.type !== 'session_snapshot')
+            throw new HerdrError('unexpected', `snapshot answered ${res.type}`);
+        return res.snapshot;
+    }
+    applySnapshot(snap) {
+        const next = partiesFromSnapshot(snap, this.ctx);
+        const t = this.now();
+        if (!this.hasSnapshot) {
+            this.hasSnapshot = true;
+            this.parties = next;
+            this.emitDelta({ t, kind: 'snapshot', world: { machine: 'local', parties: next } });
+            return;
+        }
+        const deltas = diffParties(this.parties, next, t);
+        this.parties = next;
+        for (const d of deltas)
+            this.emitDelta(d);
+    }
+    async syncStatusSubscription(snap) {
+        const panes = paneIds(snap);
+        const key = panes.join(',');
+        if (key === this.statusPanes && this.status && !this.status.isClosed)
+            return;
+        const old = this.status;
+        this.status = undefined;
+        this.statusPanes = '';
+        old?.close();
+        if (!panes.length) {
+            this.statusPanes = key;
+            return;
+        }
+        const conn = await HerdrConnection.open(this.opts.target.connectPath, this.opts.connector);
+        conn.on('event', (e) => this.onStatus(e));
+        conn.on('error', (err) => this.onStreamError('status', err));
+        conn.on('close', () => this.onStreamClosed(conn));
+        this.status = conn;
+        try {
+            await conn.subscribe(panes.map((pane_id) => ({ type: AGENT_STATUS_CHANGED, pane_id })));
+            this.statusPanes = key;
+        }
+        catch (err) {
+            // Herdr rejects the whole request if any pane vanished; close fires and we re-read.
+            conn.close();
+            throw err;
+        }
+    }
+}
+/** Live Herdr source across one or more sessions, merged into one world. */
+export class HerdrSource extends EventEmitter {
+    opts;
+    children = [];
+    machine;
+    constructor(opts = {}) {
+        super();
+        this.opts = opts;
+        this.machine = opts.machine ?? os.hostname() ?? 'local';
+    }
+    async targets() {
+        const { sessions, socket } = this.opts;
+        if (socket)
+            return [resolveTarget({ socket, session: Array.isArray(sessions) ? sessions[0] : undefined })];
+        if (sessions === 'all')
+            return discoverSessions();
+        if (Array.isArray(sessions) && sessions.length)
+            return sessions.map((session) => resolveTarget({ session }));
+        return [resolveTarget({})];
+    }
+    async start() {
+        const targets = await this.targets();
+        if (!targets.length)
+            this.opts.log?.('no running Herdr sessions found');
+        this.children = targets.map((target) => new HerdrSessionSource({
+            target,
+            connector: this.opts.connector,
+            now: this.opts.now,
+            refreshDebounceMs: this.opts.refreshDebounceMs,
+            minBackoffMs: this.opts.minBackoffMs,
+            maxBackoffMs: this.opts.maxBackoffMs,
+            log: this.opts.log,
+        }));
+        for (const c of this.children) {
+            c.on('delta', (d) => {
+                // A session's snapshot replaces only its parties; send the merged world.
+                if (d.kind === 'snapshot')
+                    this.emit('delta', { ...d, world: this.world() });
+                else
+                    this.emit('delta', d);
+            });
+        }
+        await Promise.all(this.children.map((c) => c.start()));
+    }
+    async stop() {
+        await Promise.all(this.children.map((c) => c.stop()));
+        this.children = [];
+    }
+    /**
+     * Routes to the session that owns the pane. Pane ids are session-local, so with
+     * several sessions the first one holding the id wins.
+     */
+    actions = {
+        focus: async (paneId) => this.route(paneId).focus(paneId),
+        prompt: async (paneId, text) => this.route(paneId).prompt(paneId, text),
+        sendKeys: async (paneId, keys) => this.route(paneId).sendKeys(paneId, keys),
+    };
+    route(paneId) {
+        const child = this.children.find((c) => c.hasPane(paneId));
+        if (!child)
+            throw new Error(`no pane ${paneId} in any session`);
+        return child.actions;
+    }
+    world() {
+        const parties = {};
+        for (const c of this.children)
+            Object.assign(parties, c.current);
+        return { machine: this.machine, parties };
+    }
+}
+//# sourceMappingURL=source.js.map

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

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

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

@@ -0,0 +1,6 @@
+export * from './core.js';
+export * from './server.js';
+export * from './recording.js';
+export * from './scrub.js';
+export * from './config.js';
+export * from './herdr/index.js';

package/runtime/adapter/dist/index.js

@@ -0,0 +1,7 @@
+export * from './core.js';
+export * from './server.js';
+export * from './recording.js';
+export * from './scrub.js';
+export * from './config.js';
+export * from './herdr/index.js';
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,WAAW,CAAC;AAC1B,cAAc,aAAa,CAAC;AAC5B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,kBAAkB,CAAC"}

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

@@ -0,0 +1,33 @@
+import { BaseSource } from './source.js';
+import type { Delta, World } from './types.js';
+export interface MockOptions {
+    seed?: number;
+    machine?: string;
+}
+/**
+ * Deterministic world generator. `initial()` builds a starting World and
+ * `step()` returns the next Delta. No timers, so tests can drive it directly.
+ */
+export declare class MockGenerator {
+    private rng;
+    private world;
+    private seq;
+    constructor(opts?: MockOptions);
+    initial(t?: number): Delta;
+    /** Current world after every delta handed out so far. */
+    get current(): World;
+    step(t?: number): Delta;
+}
+export interface MockSourceOptions extends MockOptions {
+    /** Milliseconds between deltas. */
+    intervalMs?: number;
+}
+/** Timer-driven WorldSource over MockGenerator. Safe to use in the browser. */
+export declare class MockSource extends BaseSource {
+    private gen;
+    private timer;
+    private intervalMs;
+    constructor(opts?: MockSourceOptions);
+    start(): Promise<void>;
+    stop(): Promise<void>;
+}

package/runtime/adapter/dist/mock.js

@@ -0,0 +1,130 @@
+import { createRng, pick } from './random.js';
+import { BaseSource } from './source.js';
+import { applyDelta, emptyWorld } from './world.js';
+const PARTIES = [
+    { label: 'auth-refresh', repo: 'api', branch: 'feat/auth-refresh', roles: ['coordinator', 'architect', 'implementer', 'reviewer'] },
+    { label: 'docs-site', repo: 'docs', branch: 'docs/getting-started', roles: ['coordinator', 'writer', 'researcher'] },
+    { label: 'deploy-pipeline', repo: 'infra', roles: ['architect', 'ops', 'implementer'] },
+    { label: 'orchestrator', repo: 'home', roles: ['orchestrator'] },
+];
+const AGENTS = ['claude', 'claude', 'copilot', 'codex'];
+const LINES = {
+    coordinator: ['Handing off the next task', 'Two branches left to merge', 'Checking in on the team'],
+    architect: ['Sketching the module split', 'This needs an interface', 'Reading the schema'],
+    implementer: ['Tests are green', 'Fixing a flaky test', 'Wiring up the handler'],
+    reviewer: ['Left three comments', 'Looks good to me', 'Can we name this better?'],
+    researcher: ['Found the upstream issue', 'Comparing two libraries'],
+    writer: ['Drafting the README', 'Tightening the intro'],
+    ops: ['Pipeline is running', 'Bumping the runner image'],
+    orchestrator: ['Starting a new worktree', 'Reviewing the plan'],
+};
+/** Weighted next-status table: mostly working/idle, sometimes done, rarely blocked. */
+const NEXT = {
+    working: [['working', 3], ['done', 2], ['idle', 1], ['blocked', 1]],
+    done: [['idle', 3], ['working', 2]],
+    blocked: [['working', 3], ['blocked', 1]],
+    idle: [['working', 4], ['idle', 2]],
+    unknown: [['idle', 1], ['working', 1]],
+};
+function weighted(rng, table) {
+    const total = table.reduce((n, [, w]) => n + w, 0);
+    let roll = rng() * total;
+    for (const [status, w] of table) {
+        roll -= w;
+        if (roll < 0)
+            return status;
+    }
+    return table[table.length - 1][0];
+}
+/**
+ * Deterministic world generator. `initial()` builds a starting World and
+ * `step()` returns the next Delta. No timers, so tests can drive it directly.
+ */
+export class MockGenerator {
+    rng;
+    world;
+    seq = 0;
+    constructor(opts = {}) {
+        this.rng = createRng(opts.seed ?? 1);
+        this.world = emptyWorld(opts.machine ?? 'local');
+    }
+    initial(t = 0) {
+        const parties = {};
+        PARTIES.forEach((seed, i) => {
+            const id = `w${i + 1}`;
+            const members = {};
+            seed.roles.forEach((role, j) => {
+                const paneId = `${id}:p${j + 1}`;
+                members[paneId] = {
+                    paneId,
+                    agent: pick(this.rng, AGENTS),
+                    role,
+                    status: pick(this.rng, ['working', 'working', 'idle', 'done']),
+                    title: role,
+                    lastChange: this.seq++,
+                };
+            });
+            parties[id] = {
+                id,
+                label: seed.label,
+                session: 'default',
+                repo: seed.repo,
+                branch: seed.branch,
+                isWorktree: seed.branch !== undefined,
+                status: 'unknown',
+                members,
+                tokens: {},
+            };
+        });
+        const delta = { t, kind: 'snapshot', world: { machine: this.world.machine, parties } };
+        this.world = applyDelta(this.world, delta);
+        return delta;
+    }
+    /** Current world after every delta handed out so far. */
+    get current() {
+        return this.world;
+    }
+    step(t = 0) {
+        const parties = Object.values(this.world.parties);
+        const party = pick(this.rng, parties);
+        const member = pick(this.rng, Object.values(party.members));
+        const roll = this.rng();
+        let delta;
+        if (roll < 0.25 && member.status === 'working') {
+            const lines = LINES[member.role] ?? ['Working on it'];
+            delta = { t, kind: 'say', partyId: party.id, paneId: member.paneId, text: pick(this.rng, lines) };
+        }
+        else {
+            const status = weighted(this.rng, NEXT[member.status]);
+            delta = {
+                t,
+                kind: 'member',
+                partyId: party.id,
+                member: { ...member, status, say: undefined, lastChange: this.seq++ },
+            };
+        }
+        this.world = applyDelta(this.world, delta);
+        return delta;
+    }
+}
+/** Timer-driven WorldSource over MockGenerator. Safe to use in the browser. */
+export class MockSource extends BaseSource {
+    gen;
+    timer;
+    intervalMs;
+    constructor(opts = {}) {
+        super();
+        this.gen = new MockGenerator(opts);
+        this.intervalMs = opts.intervalMs ?? 1500;
+    }
+    async start() {
+        this.emit(this.gen.initial(Date.now()));
+        this.timer = setInterval(() => this.emit(this.gen.step(Date.now())), this.intervalMs);
+    }
+    async stop() {
+        if (this.timer)
+            clearInterval(this.timer);
+        this.timer = undefined;
+    }
+}
+//# sourceMappingURL=mock.js.map

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

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

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

@@ -0,0 +1,3 @@
+/** mulberry32: tiny seeded PRNG so mock runs and tests are reproducible. */
+export declare function createRng(seed: number): () => number;
+export declare function pick<T>(rng: () => number, items: readonly T[]): T;

package/runtime/adapter/dist/random.js

@@ -0,0 +1,18 @@
+/** mulberry32: tiny seeded PRNG so mock runs and tests are reproducible. */
+export function createRng(seed) {
+    let a = seed >>> 0;
+    return () => {
+        a = (a + 0x6d2b79f5) >>> 0;
+        let t = a;
+        t = Math.imul(t ^ (t >>> 15), t | 1);
+        t ^= t + Math.imul(t ^ (t >>> 7), t | 61);
+        return ((t ^ (t >>> 14)) >>> 0) / 4294967296;
+    };
+}
+export function pick(rng, items) {
+    const item = items[Math.floor(rng() * items.length)];
+    if (item === undefined)
+        throw new Error('pick() from an empty list');
+    return item;
+}
+//# sourceMappingURL=random.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"random.js","sourceRoot":"","sources":["../src/random.ts"],"names":[],"mappings":"AAAA,4EAA4E;AAC5E,MAAM,UAAU,SAAS,CAAC,IAAY;IACpC,IAAI,CAAC,GAAG,IAAI,KAAK,CAAC,CAAC;IACnB,OAAO,GAAG,EAAE;QACV,CAAC,GAAG,CAAC,CAAC,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC;QAC3B,IAAI,CAAC,GAAG,CAAC,CAAC;QACV,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;QACrC,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,GAAG,EAAE,CAAC,CAAC;QAC1C,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,GAAG,UAAU,CAAC;IAC/C,CAAC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,IAAI,CAAI,GAAiB,EAAE,KAAmB;IAC5D,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC;IACrD,IAAI,IAAI,KAAK,SAAS;QAAE,MAAM,IAAI,KAAK,CAAC,2BAA2B,CAAC,CAAC;IACrE,OAAO,IAAI,CAAC;AACd,CAAC"}

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

@@ -0,0 +1,22 @@
+import { BaseSource } from './source.js';
+import type { Delta } from './types.js';
+/** Appends each delta as one JSON line. Recordings are local and gitignored. */
+export declare function recordTo(path: string): (delta: Delta) => void;
+export declare function parseRecording(text: string): Delta[];
+export interface ReplayOptions {
+    /** Playback speed multiplier. */
+    speed?: number;
+    loop?: boolean;
+}
+/** Replays a recorded delta stream with its original timing, scaled by `speed`. */
+export declare class ReplaySource extends BaseSource {
+    private deltas;
+    private opts;
+    private timer;
+    private stopped;
+    constructor(deltas: Delta[], opts?: ReplayOptions);
+    static fromFile(path: string, opts?: ReplayOptions): ReplaySource;
+    start(): Promise<void>;
+    private play;
+    stop(): Promise<void>;
+}

package/runtime/adapter/dist/recording.js

@@ -0,0 +1,52 @@
+import { appendFileSync, readFileSync } from 'node:fs';
+import { BaseSource } from './source.js';
+/** Appends each delta as one JSON line. Recordings are local and gitignored. */
+export function recordTo(path) {
+    return (delta) => appendFileSync(path, JSON.stringify(delta) + '\n');
+}
+export function parseRecording(text) {
+    return text
+        .split('\n')
+        .map((l) => l.trim())
+        .filter(Boolean)
+        .map((l) => JSON.parse(l));
+}
+/** Replays a recorded delta stream with its original timing, scaled by `speed`. */
+export class ReplaySource extends BaseSource {
+    deltas;
+    opts;
+    timer;
+    stopped = false;
+    constructor(deltas, opts = {}) {
+        super();
+        this.deltas = deltas;
+        this.opts = opts;
+    }
+    static fromFile(path, opts) {
+        return new ReplaySource(parseRecording(readFileSync(path, 'utf8')), opts);
+    }
+    async start() {
+        this.stopped = false;
+        this.play(0);
+    }
+    play(i) {
+        if (this.stopped)
+            return;
+        const delta = this.deltas[i];
+        if (!delta) {
+            if (this.opts.loop && this.deltas.length > 0)
+                this.play(0);
+            return;
+        }
+        this.emit(delta);
+        const next = this.deltas[i + 1];
+        const gap = next ? Math.max(0, next.t - delta.t) / (this.opts.speed ?? 1) : 1000;
+        this.timer = setTimeout(() => this.play(i + 1), gap);
+    }
+    async stop() {
+        this.stopped = true;
+        if (this.timer)
+            clearTimeout(this.timer);
+    }
+}
+//# sourceMappingURL=recording.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"recording.js","sourceRoot":"","sources":["../src/recording.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvD,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAGzC,gFAAgF;AAChF,MAAM,UAAU,QAAQ,CAAC,IAAY;IACnC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,cAAc,CAAC,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,CAAC;AACvE,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,IAAY;IACzC,OAAO,IAAI;SACR,KAAK,CAAC,IAAI,CAAC;SACX,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;SACpB,MAAM,CAAC,OAAO,CAAC;SACf,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAU,CAAC,CAAC;AACxC,CAAC;AAQD,mFAAmF;AACnF,MAAM,OAAO,YAAa,SAAQ,UAAU;IAKhC;IACA;IALF,KAAK,CAA4C;IACjD,OAAO,GAAG,KAAK,CAAC;IAExB,YACU,MAAe,EACf,OAAsB,EAAE;QAEhC,KAAK,EAAE,CAAC;QAHA,WAAM,GAAN,MAAM,CAAS;QACf,SAAI,GAAJ,IAAI,CAAoB;IAGlC,CAAC;IAED,MAAM,CAAC,QAAQ,CAAC,IAAY,EAAE,IAAoB;QAChD,OAAO,IAAI,YAAY,CAAC,cAAc,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC;IAC5E,CAAC;IAED,KAAK,CAAC,KAAK;QACT,IAAI,CAAC,OAAO,GAAG,KAAK,CAAC;QACrB,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACf,CAAC;IAEO,IAAI,CAAC,CAAS;QACpB,IAAI,IAAI,CAAC,OAAO;YAAE,OAAO;QACzB,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;QAC7B,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,IAAI,IAAI,CAAC,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC;gBAAE,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YAC3D,OAAO;QACT,CAAC;QACD,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACjB,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;QAChC,MAAM,GAAG,GAAG,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;QACjF,IAAI,CAAC,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IACvD,CAAC;IAED,KAAK,CAAC,IAAI;QACR,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC;QACpB,IAAI,IAAI,CAAC,KAAK;YAAE,YAAY,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC3C,CAAC;CACF"}

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

@@ -0,0 +1,16 @@
+import { type Role } from './types.js';
+export interface RoleHints {
+    /** Pane tokens; `role` is set by the installed skill pack or SessionStart hook. */
+    tokens?: Record<string, string>;
+    /** Name from `herdr agent rename`. */
+    agentName?: string | null;
+    /** Pane title. */
+    title?: string | null;
+}
+/**
+ * Role fallback chain from docs/PLAN.md §1b: `role` token (written by the skill
+ * pack or the HERDR_ROLE hook), then agent rename name, then pane title, then
+ * `generic`. Names and titles match when they contain a role as a whole word,
+ * so `reviewer-2` and `Lead architect` both resolve.
+ */
+export declare function resolveRole(hints: RoleHints): Role;