@creativeintelligence/abbie 0.1.0

package/dist/lib/nvim/remote.d.ts

@@ -0,0 +1,81 @@
+/**
+ * Neovim RPC layer using nvim CLI (no msgpack dependency).
+ * Uses `nvim --server <addr> --remote-expr <expr>` for communication.
+ */
+/**
+ * Execute a Vim expression on a remote nvim server.
+ *
+ * @param serverAddr - The nvim server address (socket path or host:port)
+ * @param expr - The Vim expression to evaluate
+ * @returns The result as a string, or null on error
+ */
+export declare function remoteExpr(serverAddr: string, expr: string): Promise<string | null>;
+/**
+ * Send keystrokes to a remote nvim server.
+ * Uses `nvim --server <addr> --remote-send <keys>`.
+ */
+export declare function remoteSend(serverAddr: string, keys: string): Promise<boolean>;
+/**
+ * Execute a Vim expression and parse the result as JSON.
+ *
+ * The expression should use json_encode() to return JSON, e.g.:
+ * `json_encode(nvim_list_bufs())`
+ *
+ * @param serverAddr - The nvim server address
+ * @param expr - The Vim expression (should return JSON via json_encode)
+ * @returns The parsed JSON, or null on error
+ */
+export declare function remoteExprJson<T>(serverAddr: string, expr: string): Promise<T | null>;
+/**
+ * Check if an nvim server is reachable.
+ */
+export declare function isServerReachable(serverAddr: string): Promise<boolean>;
+/**
+ * Get the current buffer info from nvim.
+ */
+export interface NvimBufferInfo {
+    bufnr: number;
+    name: string;
+    filetype: string;
+    modified: boolean;
+    loaded: boolean;
+    listed: boolean;
+    cursor?: {
+        line: number;
+        col: number;
+    };
+}
+/**
+ * List all buffers in the nvim instance.
+ */
+export declare function listBuffers(serverAddr: string): Promise<NvimBufferInfo[] | null>;
+/**
+ * Get the current buffer number.
+ */
+export declare function getCurrentBuffer(serverAddr: string): Promise<number | null>;
+/**
+ * Get buffer content for a specific buffer.
+ *
+ * @param serverAddr - The nvim server address
+ * @param bufnr - Buffer number (use 0 or omit for current buffer)
+ * @param startLine - Start line (1-indexed, inclusive)
+ * @param endLine - End line (1-indexed, inclusive, use '$' for last)
+ */
+export declare function getBufferLines(serverAddr: string, bufnr?: number, startLine?: number, endLine?: number | "$"): Promise<string[] | null>;
+/**
+ * Get visible window range for a buffer.
+ */
+export interface WindowRange {
+    topLine: number;
+    bottomLine: number;
+    cursor: {
+        line: number;
+        col: number;
+    };
+}
+export declare function getVisibleRange(serverAddr: string, bufnr?: number): Promise<WindowRange | null>;
+/**
+ * Get current buffer info including name, filetype, and cursor position.
+ */
+export declare function getCurrentBufferInfo(serverAddr: string): Promise<NvimBufferInfo | null>;
+//# sourceMappingURL=remote.d.ts.map

package/dist/lib/nvim/remote.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"remote.d.ts","sourceRoot":"","sources":["../../../src/lib/nvim/remote.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAgDH;;;;;;GAMG;AACH,wBAAsB,UAAU,CAAC,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAUzF;AAED;;;GAGG;AACH,wBAAsB,UAAU,CAAC,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAMnF;AAED;;;;;;;;;GASG;AACH,wBAAsB,cAAc,CAAC,CAAC,EAAE,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC,CAS3F;AAED;;GAEG;AACH,wBAAsB,iBAAiB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAG5E;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,OAAO,CAAC;IAClB,MAAM,EAAE,OAAO,CAAC;IAChB,MAAM,EAAE,OAAO,CAAC;IAChB,MAAM,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC;CACxC;AAED;;GAEG;AACH,wBAAsB,WAAW,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,EAAE,GAAG,IAAI,CAAC,CAGtF;AAED;;GAEG;AACH,wBAAsB,gBAAgB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAKjF;AAED;;;;;;;GAOG;AACH,wBAAsB,cAAc,CAClC,UAAU,EAAE,MAAM,EAClB,KAAK,SAAI,EACT,SAAS,SAAI,EACb,OAAO,GAAE,MAAM,GAAG,GAAS,GAC1B,OAAO,CAAC,MAAM,EAAE,GAAG,IAAI,CAAC,CAK1B;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC;CACvC;AAED,wBAAsB,eAAe,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,SAAI,GAAG,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,CAIhG;AAED;;GAEG;AACH,wBAAsB,oBAAoB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC,CAG7F"}

package/dist/lib/nvim/remote.js

@@ -0,0 +1,136 @@
+/**
+ * Neovim RPC layer using nvim CLI (no msgpack dependency).
+ * Uses `nvim --server <addr> --remote-expr <expr>` for communication.
+ */
+import { spawn } from "node:child_process";
+/**
+ * Execute a command and return stdout.
+ */
+async function exec(command, args, options) {
+    const { timeout = 5000 } = options || {};
+    return new Promise((resolve) => {
+        const proc = spawn(command, args, { stdio: ["ignore", "pipe", "pipe"] });
+        let stdout = "";
+        let stderr = "";
+        let killed = false;
+        const timer = setTimeout(() => {
+            killed = true;
+            proc.kill("SIGTERM");
+        }, timeout);
+        proc.stdout.on("data", (data) => {
+            stdout += data.toString();
+        });
+        proc.stderr.on("data", (data) => {
+            stderr += data.toString();
+        });
+        proc.on("close", (code) => {
+            clearTimeout(timer);
+            resolve({
+                stdout: stdout.trim(),
+                stderr: stderr.trim(),
+                exitCode: killed ? -1 : (code ?? 1),
+            });
+        });
+        proc.on("error", () => {
+            clearTimeout(timer);
+            resolve({ stdout: "", stderr: "spawn error", exitCode: 1 });
+        });
+    });
+}
+/**
+ * Execute a Vim expression on a remote nvim server.
+ *
+ * @param serverAddr - The nvim server address (socket path or host:port)
+ * @param expr - The Vim expression to evaluate
+ * @returns The result as a string, or null on error
+ */
+export async function remoteExpr(serverAddr, expr) {
+    const result = await exec("nvim", ["--server", serverAddr, "--remote-expr", expr], {
+        timeout: 5000,
+    });
+    if (result.exitCode !== 0) {
+        return null;
+    }
+    return result.stdout;
+}
+/**
+ * Send keystrokes to a remote nvim server.
+ * Uses `nvim --server <addr> --remote-send <keys>`.
+ */
+export async function remoteSend(serverAddr, keys) {
+    const result = await exec("nvim", ["--server", serverAddr, "--remote-send", keys], {
+        timeout: 5000,
+    });
+    return result.exitCode === 0;
+}
+/**
+ * Execute a Vim expression and parse the result as JSON.
+ *
+ * The expression should use json_encode() to return JSON, e.g.:
+ * `json_encode(nvim_list_bufs())`
+ *
+ * @param serverAddr - The nvim server address
+ * @param expr - The Vim expression (should return JSON via json_encode)
+ * @returns The parsed JSON, or null on error
+ */
+export async function remoteExprJson(serverAddr, expr) {
+    const result = await remoteExpr(serverAddr, expr);
+    if (result === null)
+        return null;
+    try {
+        return JSON.parse(result);
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Check if an nvim server is reachable.
+ */
+export async function isServerReachable(serverAddr) {
+    const result = await remoteExpr(serverAddr, "1+1");
+    return result === "2";
+}
+/**
+ * List all buffers in the nvim instance.
+ */
+export async function listBuffers(serverAddr) {
+    const expr = `json_encode(map(filter(getbufinfo(), 'v:val.listed'), {_, b -> {'bufnr': b.bufnr, 'name': b.name, 'loaded': b.loaded, 'listed': b.listed, 'modified': b.changed}}))`;
+    return remoteExprJson(serverAddr, expr);
+}
+/**
+ * Get the current buffer number.
+ */
+export async function getCurrentBuffer(serverAddr) {
+    const result = await remoteExpr(serverAddr, "bufnr()");
+    if (result === null)
+        return null;
+    const num = parseInt(result, 10);
+    return Number.isNaN(num) ? null : num;
+}
+/**
+ * Get buffer content for a specific buffer.
+ *
+ * @param serverAddr - The nvim server address
+ * @param bufnr - Buffer number (use 0 or omit for current buffer)
+ * @param startLine - Start line (1-indexed, inclusive)
+ * @param endLine - End line (1-indexed, inclusive, use '$' for last)
+ */
+export async function getBufferLines(serverAddr, bufnr = 0, startLine = 1, endLine = "$") {
+    const bufnrExpr = bufnr === 0 ? "bufnr()" : String(bufnr);
+    const endExpr = endLine === "$" ? `line('$', bufwinid(${bufnrExpr}))` : String(endLine);
+    const expr = `json_encode(getbufline(${bufnrExpr}, ${startLine}, ${endExpr}))`;
+    return remoteExprJson(serverAddr, expr);
+}
+export async function getVisibleRange(serverAddr, bufnr = 0) {
+    const bufnrExpr = bufnr === 0 ? "bufnr()" : String(bufnr);
+    const expr = `json_encode({'topLine': line('w0', bufwinid(${bufnrExpr})), 'bottomLine': line('w$', bufwinid(${bufnrExpr})), 'cursor': {'line': line('.', bufwinid(${bufnrExpr})), 'col': col('.', bufwinid(${bufnrExpr}))}})`;
+    return remoteExprJson(serverAddr, expr);
+}
+/**
+ * Get current buffer info including name, filetype, and cursor position.
+ */
+export async function getCurrentBufferInfo(serverAddr) {
+    const expr = `json_encode({'bufnr': bufnr(), 'name': expand('%:p'), 'filetype': &filetype, 'modified': &modified, 'loaded': 1, 'listed': 1, 'cursor': {'line': line('.'), 'col': col('.')}})`;
+    return remoteExprJson(serverAddr, expr);
+}

package/dist/lib/nvim/remote.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/lib/nvim/remote.test.js

@@ -0,0 +1,18 @@
+import { describe, it, expect } from 'bun:test';
+import { isServerReachable } from './remote.js';
+// Note: Full mocking of spawn is complex in bun:test.
+// These tests focus on integration behavior with actual nvim when available,
+// or graceful degradation when not.
+describe('nvim remote', () => {
+    describe('isServerReachable', () => {
+        it('returns false for non-existent server', async () => {
+            // Non-existent socket should return false
+            const result = await isServerReachable('/tmp/nonexistent-nvim-socket-12345.sock');
+            expect(result).toBe(false);
+        });
+        it('returns false for invalid address', async () => {
+            const result = await isServerReachable('');
+            expect(result).toBe(false);
+        });
+    });
+});

package/dist/lib/panes/broker.d.ts

@@ -0,0 +1,130 @@
+import { type Socket } from "node:net";
+/**
+ * Panes broker protocol (local fanout).
+ *
+ * Transport: Unix domain socket (newline-delimited JSON).
+ * - Client → server: control messages (subscribe/unsubscribe, ping)
+ * - Server → client: pane snapshots + deltas + status
+ *
+ * Goal: enable multiple clients (TUI + tools) to subscribe without each
+ * attaching to tmux / mutating pane state.
+ *
+ * This file defines the protocol + a minimal client helper. The daemon/broker
+ * implementation lives elsewhere and can be integrated later.
+ */
+export type PanesBrokerRedactionMode = "raw" | "default";
+export type PanesBrokerContentEncoding = "text" | "ansi";
+export type PanesBrokerPaneTarget = {
+    paneId: string;
+    ref?: string;
+} | {
+    ref: string;
+    paneId?: string;
+};
+export type PanesBrokerSubscribeOptions = {
+    requestId?: string;
+    target: PanesBrokerPaneTarget;
+    redaction?: PanesBrokerRedactionMode;
+    encoding?: PanesBrokerContentEncoding;
+    history?: {
+        lines: number;
+    };
+    follow?: boolean;
+};
+export type PanesBrokerClientHello = {
+    type: "client.hello";
+    at: string;
+    clientId: string;
+    version: 1;
+    pid: number;
+};
+export type PanesBrokerSubscribe = {
+    type: "panes.subscribe";
+    at: string;
+    requestId: string;
+    target: PanesBrokerPaneTarget;
+    redaction: PanesBrokerRedactionMode;
+    encoding: PanesBrokerContentEncoding;
+    history?: {
+        lines: number;
+    };
+    follow: boolean;
+};
+export type PanesBrokerUnsubscribe = {
+    type: "panes.unsubscribe";
+    at: string;
+    requestId: string;
+};
+export type PanesBrokerPing = {
+    type: "client.ping";
+    at: string;
+    nonce: string;
+};
+export type PanesBrokerClientMessage = PanesBrokerClientHello | PanesBrokerSubscribe | PanesBrokerUnsubscribe | PanesBrokerPing;
+export type PanesBrokerServerHello = {
+    type: "broker.hello";
+    at: string;
+    version: 1;
+    pid: number;
+};
+export type PanesBrokerPong = {
+    type: "broker.pong";
+    at: string;
+    nonce: string;
+};
+export type PanesBrokerPanesSnapshot = {
+    type: "panes.snapshot";
+    at: string;
+    requestId: string;
+    paneId: string;
+    ref?: string;
+    encoding: PanesBrokerContentEncoding;
+    redaction: PanesBrokerRedactionMode;
+    cols?: number;
+    rows?: number;
+    truncated?: boolean;
+    content: string;
+};
+export type PanesBrokerPanesDelta = {
+    type: "panes.delta";
+    at: string;
+    requestId: string;
+    paneId: string;
+    ref?: string;
+    encoding: PanesBrokerContentEncoding;
+    redaction: PanesBrokerRedactionMode;
+    chunk: string;
+};
+export type PanesBrokerPanesStatus = {
+    type: "panes.status";
+    at: string;
+    requestId?: string;
+    paneId?: string;
+    level: "info" | "warn" | "error";
+    message: string;
+};
+export type PanesBrokerServerMessage = PanesBrokerServerHello | PanesBrokerPong | PanesBrokerPanesSnapshot | PanesBrokerPanesDelta | PanesBrokerPanesStatus;
+export type PanesBrokerConnectOptions = {
+    socketPath?: string;
+};
+export declare function getDefaultPanesBrokerSocketPath(): string;
+export type LineParser<T> = {
+    pushChunk: (chunk: Buffer | string) => void;
+    onMessage: (fn: (msg: T) => void) => void;
+    onError: (fn: (err: Error) => void) => void;
+};
+export declare function createNdjsonLineParser<T>(): LineParser<T>;
+export type PanesBrokerClient = {
+    socket: Socket;
+    clientId: string;
+    send: (msg: PanesBrokerClientMessage) => void;
+    subscribe: (opts: PanesBrokerSubscribeOptions) => string;
+    unsubscribe: (requestId: string) => void;
+    ping: () => string;
+};
+export declare function connectPanesBroker(opts?: PanesBrokerConnectOptions, handlers?: {
+    onMessage?: (msg: PanesBrokerServerMessage) => void;
+    onError?: (err: Error) => void;
+    onClose?: () => void;
+}): PanesBrokerClient;
+//# sourceMappingURL=broker.d.ts.map

package/dist/lib/panes/broker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"broker.d.ts","sourceRoot":"","sources":["../../../src/lib/panes/broker.ts"],"names":[],"mappings":"AAEA,OAAO,EAAoB,KAAK,MAAM,EAAE,MAAM,UAAU,CAAC;AAIzD;;;;;;;;;;;;GAYG;AAEH,MAAM,MAAM,wBAAwB,GAAG,KAAK,GAAG,SAAS,CAAC;AACzD,MAAM,MAAM,0BAA0B,GAAG,MAAM,GAAG,MAAM,CAAC;AAEzD,MAAM,MAAM,qBAAqB,GAC7B;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAA;CAAE,GAChC;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAErC,MAAM,MAAM,2BAA2B,GAAG;IACxC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,qBAAqB,CAAC;IAC9B,SAAS,CAAC,EAAE,wBAAwB,CAAC;IACrC,QAAQ,CAAC,EAAE,0BAA0B,CAAC;IACtC,OAAO,CAAC,EAAE;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IAC5B,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB,CAAC;AAEF,MAAM,MAAM,sBAAsB,GAAG;IACnC,IAAI,EAAE,cAAc,CAAC;IACrB,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,CAAC,CAAC;IACX,GAAG,EAAE,MAAM,CAAC;CACb,CAAC;AAEF,MAAM,MAAM,oBAAoB,GAAG;IACjC,IAAI,EAAE,iBAAiB,CAAC;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,qBAAqB,CAAC;IAC9B,SAAS,EAAE,wBAAwB,CAAC;IACpC,QAAQ,EAAE,0BAA0B,CAAC;IACrC,OAAO,CAAC,EAAE;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IAC5B,MAAM,EAAE,OAAO,CAAC;CACjB,CAAC;AAEF,MAAM,MAAM,sBAAsB,GAAG;IACnC,IAAI,EAAE,mBAAmB,CAAC;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG;IAC5B,IAAI,EAAE,aAAa,CAAC;IACpB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;CACf,CAAC;AAEF,MAAM,MAAM,wBAAwB,GAChC,sBAAsB,GACtB,oBAAoB,GACpB,sBAAsB,GACtB,eAAe,CAAC;AAEpB,MAAM,MAAM,sBAAsB,GAAG;IACnC,IAAI,EAAE,cAAc,CAAC;IACrB,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,CAAC,CAAC;IACX,GAAG,EAAE,MAAM,CAAC;CACb,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG;IAC5B,IAAI,EAAE,aAAa,CAAC;IACpB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;CACf,CAAC;AAEF,MAAM,MAAM,wBAAwB,GAAG;IACrC,IAAI,EAAE,gBAAgB,CAAC;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,0BAA0B,CAAC;IACrC,SAAS,EAAE,wBAAwB,CAAC;IACpC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,MAAM,MAAM,qBAAqB,GAAG;IAClC,IAAI,EAAE,aAAa,CAAC;IACpB,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,0BAA0B,CAAC;IACrC,SAAS,EAAE,wBAAwB,CAAC;IACpC,KAAK,EAAE,MAAM,CAAC;CACf,CAAC;AAEF,MAAM,MAAM,sBAAsB,GAAG;IACnC,IAAI,EAAE,cAAc,CAAC;IACrB,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;IACjC,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,MAAM,MAAM,wBAAwB,GAChC,sBAAsB,GACtB,eAAe,GACf,wBAAwB,GACxB,qBAAqB,GACrB,sBAAsB,CAAC;AAE3B,MAAM,MAAM,yBAAyB,GAAG;IACtC,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,CAAC;AAEF,wBAAgB,+BAA+B,IAAI,MAAM,CAMxD;AAWD,MAAM,MAAM,UAAU,CAAC,CAAC,IAAI;IAC1B,SAAS,EAAE,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,KAAK,IAAI,CAAC;IAC5C,SAAS,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,EAAE,CAAC,KAAK,IAAI,KAAK,IAAI,CAAC;IAC1C,OAAO,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,EAAE,KAAK,KAAK,IAAI,KAAK,IAAI,CAAC;CAC7C,CAAC;AAEF,wBAAgB,sBAAsB,CAAC,CAAC,KAAK,UAAU,CAAC,CAAC,CAAC,CA+BzD;AAED,MAAM,MAAM,iBAAiB,GAAG;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,CAAC,GAAG,EAAE,wBAAwB,KAAK,IAAI,CAAC;IAC9C,SAAS,EAAE,CAAC,IAAI,EAAE,2BAA2B,KAAK,MAAM,CAAC;IACzD,WAAW,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,IAAI,CAAC;IACzC,IAAI,EAAE,MAAM,MAAM,CAAC;CACpB,CAAC;AAEF,wBAAgB,kBAAkB,CAChC,IAAI,GAAE,yBAA8B,EACpC,QAAQ,CAAC,EAAE;IACT,SAAS,CAAC,EAAE,CAAC,GAAG,EAAE,wBAAwB,KAAK,IAAI,CAAC;IACpD,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,KAAK,KAAK,IAAI,CAAC;IAC/B,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;CACtB,GACA,iBAAiB,CAyDnB"}

package/dist/lib/panes/broker.js

@@ -0,0 +1,97 @@
+import { randomUUID } from "node:crypto";
+import { mkdirSync } from "node:fs";
+import { createConnection } from "node:net";
+import { homedir } from "node:os";
+import { dirname, join } from "node:path";
+export function getDefaultPanesBrokerSocketPath() {
+    const runtimeDir = process.env.XDG_RUNTIME_DIR;
+    if (runtimeDir)
+        return join(runtimeDir, "abbie-panes-broker.sock");
+    const home = homedir() || process.env.HOME || "~";
+    return join(home, ".abbie", "run", "panes-broker.sock");
+}
+function ensureSocketDir(path) {
+    const dir = dirname(path);
+    mkdirSync(dir, { recursive: true });
+}
+function nowIso() {
+    return new Date().toISOString();
+}
+export function createNdjsonLineParser() {
+    let buf = "";
+    let onMessageFn = null;
+    let onErrorFn = null;
+    return {
+        pushChunk(chunk) {
+            buf += chunk.toString();
+            for (;;) {
+                const idx = buf.indexOf("\n");
+                if (idx === -1)
+                    break;
+                const line = buf.slice(0, idx).trimEnd();
+                buf = buf.slice(idx + 1);
+                if (!line)
+                    continue;
+                try {
+                    const msg = JSON.parse(line);
+                    onMessageFn?.(msg);
+                }
+                catch (err) {
+                    onErrorFn?.(new Error(err instanceof Error ? err.message : "Failed to parse NDJSON line"));
+                }
+            }
+        },
+        onMessage(fn) {
+            onMessageFn = fn;
+        },
+        onError(fn) {
+            onErrorFn = fn;
+        },
+    };
+}
+export function connectPanesBroker(opts = {}, handlers) {
+    const socketPath = opts.socketPath ?? getDefaultPanesBrokerSocketPath();
+    ensureSocketDir(socketPath);
+    const socket = createConnection({ path: socketPath });
+    const parser = createNdjsonLineParser();
+    parser.onMessage((msg) => handlers?.onMessage?.(msg));
+    parser.onError((err) => handlers?.onError?.(err));
+    socket.on("data", (chunk) => parser.pushChunk(chunk));
+    socket.on("error", (err) => handlers?.onError?.(err instanceof Error ? err : new Error(String(err))));
+    socket.on("close", () => handlers?.onClose?.());
+    const clientId = randomUUID();
+    const send = (msg) => {
+        socket.write(`${JSON.stringify(msg)}\n`);
+    };
+    // Send hello immediately; server can ignore if not required.
+    send({
+        type: "client.hello",
+        at: nowIso(),
+        clientId,
+        version: 1,
+        pid: process.pid,
+    });
+    const subscribe = (sub) => {
+        const requestId = sub.requestId ?? randomUUID();
+        send({
+            type: "panes.subscribe",
+            at: nowIso(),
+            requestId,
+            target: sub.target,
+            redaction: sub.redaction ?? "raw",
+            encoding: sub.encoding ?? "text",
+            history: sub.history,
+            follow: sub.follow ?? true,
+        });
+        return requestId;
+    };
+    const unsubscribe = (requestId) => {
+        send({ type: "panes.unsubscribe", at: nowIso(), requestId });
+    };
+    const ping = () => {
+        const nonce = randomUUID();
+        send({ type: "client.ping", at: nowIso(), nonce });
+        return nonce;
+    };
+    return { socket, clientId, send, subscribe, unsubscribe, ping };
+}

package/dist/lib/panes/index.d.ts

@@ -0,0 +1,2 @@
+export * from "./broker.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/lib/panes/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/lib/panes/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC"}

package/dist/lib/panes/index.js

@@ -0,0 +1 @@
+export * from "./broker.js";

package/dist/lib/panes/server.d.ts

@@ -0,0 +1,17 @@
+import { type Server } from "node:net";
+type BrokerOptions = {
+    socketPath?: string;
+    fps?: number;
+    forcePipe?: boolean;
+};
+export declare function startPanesBroker(opts: BrokerOptions, ctx: {
+    agentsBinPath: string;
+    logInfo: (msg: string) => void;
+    logWarn: (msg: string) => void;
+}): Promise<{
+    socketPath: string;
+    server: Server;
+    stop: () => Promise<void>;
+}>;
+export {};
+//# sourceMappingURL=server.d.ts.map

package/dist/lib/panes/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../../src/lib/panes/server.ts"],"names":[],"mappings":"AACA,OAAO,EAAgB,KAAK,MAAM,EAAe,MAAM,UAAU,CAAC;AAwClE,KAAK,aAAa,GAAG;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB,CAAC;AAyCF,wBAAsB,gBAAgB,CACpC,IAAI,EAAE,aAAa,EACnB,GAAG,EAAE;IACH,aAAa,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;IAC/B,OAAO,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;CAChC,GACA,OAAO,CAAC;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;CAAE,CAAC,CA6R5E"}