@pelotto-tech/bellwether 0.0.0-stage → 0.1.0

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

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

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

@@ -0,0 +1,29 @@
+export declare const DEFAULT_SESSION = "default";
+export interface PathEnv {
+    platform?: NodeJS.Platform;
+    env?: NodeJS.ProcessEnv;
+    home?: string;
+}
+/** Herdr config dir: `%APPDATA%\herdr` on Windows, `$XDG_CONFIG_HOME/herdr` or `~/.config/herdr` elsewhere. */
+export declare function herdrConfigDir(e?: PathEnv): string;
+/** Socket file path for a session (before Windows pipe prefixing). */
+export declare function sessionSocketFile(session: string, e?: PathEnv): string;
+/** What `net.connect` takes: the socket path on Unix, `\\.\pipe\<path>` on Windows. */
+export declare function toConnectPath(socketFile: string, platform?: NodeJS.Platform): string;
+export interface SessionTarget {
+    session: string;
+    connectPath: string;
+}
+/**
+ * Resolve one explicit target. Order mirrors Herdr: explicit socket, explicit
+ * session, HERDR_SOCKET_PATH, HERDR_SESSION, default.
+ */
+export declare function resolveTarget(opts: {
+    session?: string;
+    socket?: string;
+}, e?: PathEnv): SessionTarget;
+/**
+ * Enumerate running sessions: the default socket plus `sessions/<name>/herdr.sock`.
+ * On Windows a session is live when its pipe exists; elsewhere when the socket file exists.
+ */
+export declare function discoverSessions(e?: PathEnv): Promise<SessionTarget[]>;

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

@@ -0,0 +1,89 @@
+import { readdir, stat } from 'node:fs/promises';
+import os from 'node:os';
+import path from 'node:path';
+export const DEFAULT_SESSION = 'default';
+const PIPE_PREFIX = '\\\\.\\pipe\\';
+/** Herdr config dir: `%APPDATA%\herdr` on Windows, `$XDG_CONFIG_HOME/herdr` or `~/.config/herdr` elsewhere. */
+export function herdrConfigDir(e = {}) {
+    const platform = e.platform ?? process.platform;
+    const env = e.env ?? process.env;
+    const home = e.home ?? os.homedir();
+    const p = platform === 'win32' ? path.win32 : path.posix;
+    if (platform === 'win32')
+        return p.join(env.APPDATA ?? p.join(home, 'AppData', 'Roaming'), 'herdr');
+    return p.join(env.XDG_CONFIG_HOME ?? p.join(home, '.config'), 'herdr');
+}
+/** Socket file path for a session (before Windows pipe prefixing). */
+export function sessionSocketFile(session, e = {}) {
+    const platform = e.platform ?? process.platform;
+    const p = platform === 'win32' ? path.win32 : path.posix;
+    const dir = herdrConfigDir(e);
+    return session === DEFAULT_SESSION ? p.join(dir, 'herdr.sock') : p.join(dir, 'sessions', session, 'herdr.sock');
+}
+/** What `net.connect` takes: the socket path on Unix, `\\.\pipe\<path>` on Windows. */
+export function toConnectPath(socketFile, platform = process.platform) {
+    if (platform !== 'win32' || socketFile.startsWith(PIPE_PREFIX))
+        return socketFile;
+    return PIPE_PREFIX + socketFile;
+}
+/**
+ * Resolve one explicit target. Order mirrors Herdr: explicit socket, explicit
+ * session, HERDR_SOCKET_PATH, HERDR_SESSION, default.
+ */
+export function resolveTarget(opts, e = {}) {
+    const platform = e.platform ?? process.platform;
+    const env = e.env ?? process.env;
+    if (opts.socket)
+        return { session: opts.session ?? 'custom', connectPath: toConnectPath(opts.socket, platform) };
+    if (opts.session)
+        return { session: opts.session, connectPath: toConnectPath(sessionSocketFile(opts.session, e), platform) };
+    if (env.HERDR_SOCKET_PATH)
+        return { session: env.HERDR_SESSION ?? DEFAULT_SESSION, connectPath: toConnectPath(env.HERDR_SOCKET_PATH, platform) };
+    const s = env.HERDR_SESSION ?? DEFAULT_SESSION;
+    return { session: s, connectPath: toConnectPath(sessionSocketFile(s, e), platform) };
+}
+/**
+ * Enumerate running sessions: the default socket plus `sessions/<name>/herdr.sock`.
+ * On Windows a session is live when its pipe exists; elsewhere when the socket file exists.
+ */
+export async function discoverSessions(e = {}) {
+    const platform = e.platform ?? process.platform;
+    const dir = herdrConfigDir(e);
+    const p = platform === 'win32' ? path.win32 : path.posix;
+    const names = [DEFAULT_SESSION];
+    try {
+        for (const d of await readdir(p.join(dir, 'sessions'), { withFileTypes: true }))
+            if (d.isDirectory())
+                names.push(d.name);
+    }
+    catch {
+        /* no named sessions */
+    }
+    let pipes;
+    if (platform === 'win32') {
+        try {
+            pipes = new Set((await readdir(PIPE_PREFIX)).map((n) => n.toLowerCase()));
+        }
+        catch {
+            pipes = new Set();
+        }
+    }
+    const out = [];
+    for (const name of names) {
+        const file = sessionSocketFile(name, e);
+        const live = pipes ? pipes.has(file.toLowerCase()) : await exists(file);
+        if (live)
+            out.push({ session: name, connectPath: toConnectPath(file, platform) });
+    }
+    return out;
+}
+async function exists(f) {
+    try {
+        await stat(f);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=paths.js.map

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

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

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

@@ -0,0 +1,102 @@
+export type AgentStatus = 'idle' | 'working' | 'blocked' | 'done' | 'unknown';
+export interface WorkspaceWorktreeInfo {
+    repo_key: string;
+    repo_name: string;
+    repo_root: string;
+    checkout_path: string;
+    is_linked_worktree: boolean;
+}
+export interface WorkspaceInfo {
+    workspace_id: string;
+    number: number;
+    label: string;
+    focused: boolean;
+    pane_count: number;
+    tab_count: number;
+    active_tab_id: string;
+    agent_status: AgentStatus;
+    tokens?: Record<string, string>;
+    worktree?: WorkspaceWorktreeInfo | null;
+}
+export interface PaneInfo {
+    pane_id: string;
+    terminal_id: string;
+    workspace_id: string;
+    tab_id: string;
+    focused: boolean;
+    agent_status: AgentStatus;
+    revision: number;
+    agent?: string | null;
+    display_agent?: string | null;
+    title?: string | null;
+    label?: string | null;
+    cwd?: string | null;
+    state_labels?: Record<string, string>;
+    tokens?: Record<string, string>;
+}
+export interface AgentInfo extends PaneInfo {
+    name?: string | null;
+    state_change_seq?: number;
+}
+export interface WorktreeInfo {
+    branch?: string | null;
+    path?: string;
+    label?: string;
+    open_workspace_id?: string | null;
+    [k: string]: unknown;
+}
+export interface SessionSnapshot {
+    version: string;
+    protocol: number;
+    workspaces: WorkspaceInfo[];
+    tabs: unknown[];
+    panes: PaneInfo[];
+    layouts: unknown[];
+    agents: AgentInfo[];
+    focused_workspace_id?: string | null;
+    focused_tab_id?: string | null;
+    focused_pane_id?: string | null;
+}
+export interface Request {
+    id: string;
+    method: string;
+    params: Record<string, unknown>;
+}
+export interface SuccessResponse {
+    id: string;
+    result: {
+        type: string;
+        [k: string]: unknown;
+    };
+}
+export interface ErrorResponse {
+    id: string;
+    error: {
+        code: string;
+        message: string;
+    };
+}
+/** Pushed on a subscription connection. Lifecycle kinds use underscores
+ *  (`pane_closed`), subscription kinds use dots (`pane.agent_status_changed`). */
+export interface EventLine {
+    event: string;
+    data: Record<string, unknown> & {
+        type?: string;
+    };
+}
+export type Line = SuccessResponse | ErrorResponse | EventLine;
+export declare function isEvent(l: Line): l is EventLine;
+export declare function isError(l: Line): l is ErrorResponse;
+export interface AgentStatusChanged {
+    pane_id: string;
+    workspace_id: string;
+    agent_status: AgentStatus;
+    agent?: string | null;
+    display_agent?: string | null;
+    title?: string | null;
+    state_labels?: Record<string, string>;
+}
+/** Global lifecycle subscriptions. `pane.agent_status_changed` is per pane and
+ *  is opened separately (PLAN §1 gotcha 1). */
+export declare const LIFECYCLE_SUBSCRIPTIONS: readonly ["workspace.created", "workspace.updated", "workspace.metadata_updated", "workspace.renamed", "workspace.closed", "worktree.created", "worktree.opened", "worktree.removed", "tab.created", "tab.closed", "pane.created", "pane.closed", "pane.updated", "pane.moved", "pane.exited", "pane.agent_detected"];
+export declare const AGENT_STATUS_CHANGED = "pane.agent_status_changed";

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

@@ -0,0 +1,19 @@
+// Subset of the Herdr TUI socket protocol (protocol 22) that Bellwether reads.
+// Source of truth: docs/research/herdr-api.schema.json.
+export function isEvent(l) {
+    return typeof l.event === 'string';
+}
+export function isError(l) {
+    return typeof l.error === 'object' && l.error !== null;
+}
+/** Global lifecycle subscriptions. `pane.agent_status_changed` is per pane and
+ *  is opened separately (PLAN §1 gotcha 1). */
+export const LIFECYCLE_SUBSCRIPTIONS = [
+    'workspace.created', 'workspace.updated', 'workspace.metadata_updated', 'workspace.renamed',
+    'workspace.closed',
+    'worktree.created', 'worktree.opened', 'worktree.removed',
+    'tab.created', 'tab.closed',
+    'pane.created', 'pane.closed', 'pane.updated', 'pane.moved', 'pane.exited', 'pane.agent_detected',
+];
+export const AGENT_STATUS_CHANGED = 'pane.agent_status_changed';
+//# sourceMappingURL=protocol.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"protocol.js","sourceRoot":"","sources":["../../src/herdr/protocol.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,wDAAwD;AA6FxD,MAAM,UAAU,OAAO,CAAC,CAAO;IAC7B,OAAO,OAAQ,CAAe,CAAC,KAAK,KAAK,QAAQ,CAAC;AACpD,CAAC;AACD,MAAM,UAAU,OAAO,CAAC,CAAO;IAC7B,OAAO,OAAQ,CAAmB,CAAC,KAAK,KAAK,QAAQ,IAAK,CAAmB,CAAC,KAAK,KAAK,IAAI,CAAC;AAC/F,CAAC;AAYD;+CAC+C;AAC/C,MAAM,CAAC,MAAM,uBAAuB,GAAG;IACrC,mBAAmB,EAAE,mBAAmB,EAAE,4BAA4B,EAAE,mBAAmB;IAC3F,kBAAkB;IAClB,kBAAkB,EAAE,iBAAiB,EAAE,kBAAkB;IACzD,aAAa,EAAE,YAAY;IAC3B,cAAc,EAAE,aAAa,EAAE,cAAc,EAAE,YAAY,EAAE,aAAa,EAAE,qBAAqB;CACzF,CAAC;AAEX,MAAM,CAAC,MAAM,oBAAoB,GAAG,2BAA2B,CAAC"}

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

@@ -0,0 +1,99 @@
+import { EventEmitter } from 'node:events';
+import type { Action } from '../actions.js';
+import type { WorldSource } from '../source.js';
+import type { Party, World } from '../types.js';
+import { type Connector } from './connection.js';
+import { type SessionTarget } from './paths.js';
+export interface SessionSourceOptions {
+    target: SessionTarget;
+    connector?: Connector;
+    now?: () => number;
+    /** Coalesce bursts of lifecycle events into one re-read. */
+    refreshDebounceMs?: number;
+    /** Reconnect backoff bounds. */
+    minBackoffMs?: number;
+    maxBackoffMs?: number;
+    log?: (msg: string) => void;
+}
+/**
+ * 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 declare class HerdrSessionSource extends EventEmitter implements WorldSource {
+    private readonly opts;
+    readonly session: string;
+    private parties;
+    private branches;
+    private lifecycle?;
+    private status?;
+    private rpc?;
+    private statusPanes;
+    private running;
+    private hasSnapshot;
+    private refreshing;
+    private dirty;
+    private refreshTimer?;
+    private reconnectTimer?;
+    private backoff;
+    private readonly now;
+    private readonly log;
+    private readonly ctx;
+    constructor(opts: SessionSourceOptions);
+    /** Current parties for this session (read-only view). */
+    get current(): Readonly<Record<string, Party>>;
+    start(): Promise<void>;
+    stop(): Promise<void>;
+    private emitDelta;
+    private connect;
+    private onStreamError;
+    private onStreamClosed;
+    private scheduleReconnect;
+    private onLifecycle;
+    private onStatus;
+    private scheduleRefresh;
+    /** Serialized authoritative re-read. Events that land mid-read trigger one more read. */
+    refresh(): Promise<void>;
+    private rpcConn;
+    /** Actions for this session, mapped to Herdr's request/response API. */
+    readonly actions: Action;
+    /** Whether this session currently has a member in `paneId`. */
+    hasPane(paneId: string): boolean;
+    private snapshot;
+    private applySnapshot;
+    private syncStatusSubscription;
+}
+export interface LiveOptions {
+    /** `'all'` discovers running sessions; otherwise explicit names. Default: resolve one target from env. */
+    sessions?: 'all' | string[];
+    socket?: string;
+    machine?: string;
+    connector?: Connector;
+    now?: () => number;
+    refreshDebounceMs?: number;
+    minBackoffMs?: number;
+    maxBackoffMs?: number;
+    log?: (msg: string) => void;
+}
+/** Live Herdr source across one or more sessions, merged into one world. */
+export declare class HerdrSource extends EventEmitter implements WorldSource {
+    private readonly opts;
+    private children;
+    private readonly machine;
+    constructor(opts?: LiveOptions);
+    targets(): Promise<SessionTarget[]>;
+    start(): Promise<void>;
+    stop(): Promise<void>;
+    /**
+     * Routes to the session that owns the pane. Pane ids are session-local, so with
+     * several sessions the first one holding the id wins.
+     */
+    readonly actions: Action;
+    private route;
+    world(): World;
+}