brosh 0.2.2

package/dist/tools/startRecording.js.map

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

package/dist/tools/stopRecording.d.ts

@@ -0,0 +1,31 @@
+import { z } from "zod";
+import { TerminalManager } from "../terminal/index.js";
+export declare const stopRecordingSchema: z.ZodObject<{
+    recordingId: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    recordingId: string;
+}, {
+    recordingId: string;
+}>;
+export declare const stopRecordingTool: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            recordingId: {
+                type: string;
+                description: string;
+            };
+        };
+        required: string[];
+    };
+};
+export declare function handleStopRecording(manager: TerminalManager, args: unknown): Promise<{
+    content: Array<{
+        type: "text";
+        text: string;
+    }>;
+    isError?: boolean;
+}>;
+//# sourceMappingURL=stopRecording.d.ts.map

package/dist/tools/stopRecording.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stopRecording.d.ts","sourceRoot":"","sources":["../../src/tools/stopRecording.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAEvD,eAAO,MAAM,mBAAmB;;;;;;EAE9B,CAAC;AAEH,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;CAa7B,CAAC;AAEF,wBAAsB,mBAAmB,CACvC,OAAO,EAAE,eAAe,EACxB,IAAI,EAAE,OAAO,GACZ,OAAO,CAAC;IAAE,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAAC,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,CAAC,CA+DhF"}

package/dist/tools/stopRecording.js

@@ -0,0 +1,76 @@
+import { z } from "zod";
+export const stopRecordingSchema = z.object({
+    recordingId: z.string(),
+});
+export const stopRecordingTool = {
+    name: "stopRecording",
+    description: "Stop a recording and finalize the asciicast file. Returns metadata about the saved recording including the file path and duration.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            recordingId: {
+                type: "string",
+                description: "The recording ID returned by startRecording",
+            },
+        },
+        required: ["recordingId"],
+    },
+};
+export async function handleStopRecording(manager, args) {
+    const parsed = stopRecordingSchema.parse(args);
+    const recordingManager = manager.getRecordingManager();
+    const recorder = recordingManager.getRecording(parsed.recordingId);
+    if (!recorder) {
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `Error: Recording not found: ${parsed.recordingId}`,
+                },
+            ],
+            isError: true,
+        };
+    }
+    if (!recorder.isActive()) {
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `Error: Recording already finalized: ${parsed.recordingId}`,
+                },
+            ],
+            isError: true,
+        };
+    }
+    // Finalize with exit code 0 (explicit stop means success)
+    const metadata = await recordingManager.finalizeRecording(parsed.recordingId, 0, 'explicit');
+    if (!metadata) {
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `Error: Failed to finalize recording: ${parsed.recordingId}`,
+                },
+            ],
+            isError: true,
+        };
+    }
+    const result = {
+        recordingId: metadata.id,
+        path: metadata.path,
+        durationMs: metadata.durationMs,
+        bytesWritten: metadata.bytesWritten,
+        saved: metadata.saved,
+        mode: metadata.mode,
+        stopReason: metadata.stopReason,
+    };
+    return {
+        content: [
+            {
+                type: "text",
+                text: JSON.stringify(result, null, 2),
+            },
+        ],
+    };
+}
+//# sourceMappingURL=stopRecording.js.map

package/dist/tools/stopRecording.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stopRecording.js","sourceRoot":"","sources":["../../src/tools/stopRecording.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC1C,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE;CACxB,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAC/B,IAAI,EAAE,eAAe;IACrB,WAAW,EAAE,oIAAoI;IACjJ,WAAW,EAAE;QACX,IAAI,EAAE,QAAiB;QACvB,UAAU,EAAE;YACV,WAAW,EAAE;gBACX,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,6CAA6C;aAC3D;SACF;QACD,QAAQ,EAAE,CAAC,aAAa,CAAC;KAC1B;CACF,CAAC;AAEF,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,OAAwB,EACxB,IAAa;IAEb,MAAM,MAAM,GAAG,mBAAmB,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAE/C,MAAM,gBAAgB,GAAG,OAAO,CAAC,mBAAmB,EAAE,CAAC;IACvD,MAAM,QAAQ,GAAG,gBAAgB,CAAC,YAAY,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;IAEnE,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAe;oBACrB,IAAI,EAAE,+BAA+B,MAAM,CAAC,WAAW,EAAE;iBAC1D;aACF;YACD,OAAO,EAAE,IAAI;SACd,CAAC;IACJ,CAAC;IAED,IAAI,CAAC,QAAQ,CAAC,QAAQ,EAAE,EAAE,CAAC;QACzB,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAe;oBACrB,IAAI,EAAE,uCAAuC,MAAM,CAAC,WAAW,EAAE;iBAClE;aACF;YACD,OAAO,EAAE,IAAI;SACd,CAAC;IACJ,CAAC;IAED,0DAA0D;IAC1D,MAAM,QAAQ,GAAG,MAAM,gBAAgB,CAAC,iBAAiB,CAAC,MAAM,CAAC,WAAW,EAAE,CAAC,EAAE,UAAU,CAAC,CAAC;IAE7F,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAe;oBACrB,IAAI,EAAE,wCAAwC,MAAM,CAAC,WAAW,EAAE;iBACnE;aACF;YACD,OAAO,EAAE,IAAI;SACd,CAAC;IACJ,CAAC;IAED,MAAM,MAAM,GAAG;QACb,WAAW,EAAE,QAAQ,CAAC,EAAE;QACxB,IAAI,EAAE,QAAQ,CAAC,IAAI;QACnB,UAAU,EAAE,QAAQ,CAAC,UAAU;QAC/B,YAAY,EAAE,QAAQ,CAAC,YAAY;QACnC,KAAK,EAAE,QAAQ,CAAC,KAAK;QACrB,IAAI,EAAE,QAAQ,CAAC,IAAI;QACnB,UAAU,EAAE,QAAQ,CAAC,UAAU;KAChC,CAAC;IAEF,OAAO;QACL,OAAO,EAAE;YACP;gBACE,IAAI,EAAE,MAAe;gBACrB,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;aACtC;SACF;KACF,CAAC;AACJ,CAAC"}

package/dist/tools/type.d.ts

@@ -0,0 +1,31 @@
+import { z } from "zod";
+import { TerminalManager } from "../terminal/index.js";
+export declare const typeSchema: z.ZodObject<{
+    text: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    text: string;
+}, {
+    text: string;
+}>;
+export type TypeArgs = z.infer<typeof typeSchema>;
+export declare const typeTool: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            text: {
+                type: string;
+                description: string;
+            };
+        };
+        required: string[];
+    };
+};
+export declare function handleType(manager: TerminalManager, args: unknown): {
+    content: Array<{
+        type: "text";
+        text: string;
+    }>;
+};
+//# sourceMappingURL=type.d.ts.map

package/dist/tools/type.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"type.d.ts","sourceRoot":"","sources":["../../src/tools/type.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAEvD,eAAO,MAAM,UAAU;;;;;;EAErB,CAAC;AAEH,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,UAAU,CAAC,CAAC;AAElD,eAAO,MAAM,QAAQ;;;;;;;;;;;;;CAapB,CAAC;AAEF,wBAAgB,UAAU,CAAC,OAAO,EAAE,eAAe,EAAE,IAAI,EAAE,OAAO,GAAG;IAAE,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CAAE,CAYtH"}

package/dist/tools/type.js

@@ -0,0 +1,31 @@
+import { z } from "zod";
+export const typeSchema = z.object({
+    text: z.string().describe("The text to type into the terminal"),
+});
+export const typeTool = {
+    name: "type",
+    description: "Send text input to the terminal. Text is written exactly as provided - no Enter key is sent automatically. To execute a command, use type() followed by sendKey('Enter'). Example workflow: type('ls -la') → sendKey('Enter') → getContent(). IMPORTANT: In zsh, avoid '!' inside double quotes as it triggers history expansion - use single quotes instead (e.g., echo 'Hello!' not echo \"Hello!\").",
+    inputSchema: {
+        type: "object",
+        properties: {
+            text: {
+                type: "string",
+                description: "The text to type into the terminal",
+            },
+        },
+        required: ["text"],
+    },
+};
+export function handleType(manager, args) {
+    const parsed = typeSchema.parse(args);
+    manager.write(parsed.text);
+    return {
+        content: [
+            {
+                type: "text",
+                text: `Typed ${parsed.text.length} character(s) to terminal`,
+            },
+        ],
+    };
+}
+//# sourceMappingURL=type.js.map

package/dist/tools/type.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"type.js","sourceRoot":"","sources":["../../src/tools/type.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,CAAC,MAAM,CAAC;IACjC,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,oCAAoC,CAAC;CAChE,CAAC,CAAC;AAIH,MAAM,CAAC,MAAM,QAAQ,GAAG;IACtB,IAAI,EAAE,MAAM;IACZ,WAAW,EAAE,yYAAyY;IACtZ,WAAW,EAAE;QACX,IAAI,EAAE,QAAiB;QACvB,UAAU,EAAE;YACV,IAAI,EAAE;gBACJ,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,oCAAoC;aAClD;SACF;QACD,QAAQ,EAAE,CAAC,MAAM,CAAC;KACnB;CACF,CAAC;AAEF,MAAM,UAAU,UAAU,CAAC,OAAwB,EAAE,IAAa;IAChE,MAAM,MAAM,GAAG,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACtC,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IAE3B,OAAO;QACL,OAAO,EAAE;YACP;gBACE,IAAI,EAAE,MAAM;gBACZ,IAAI,EAAE,SAAS,MAAM,CAAC,IAAI,CAAC,MAAM,2BAA2B;aAC7D;SACF;KACF,CAAC;AACJ,CAAC"}

package/dist/transport/gui-protocol.d.ts

@@ -0,0 +1,163 @@
+/**
+ * GUI Communication Protocol
+ *
+ * Defines the message types for communication between the brosh backend
+ * and GUI frontends (Electron, web, etc.)
+ *
+ * Messages are JSON-encoded and sent over IPC (Electron) or Unix socket/WebSocket.
+ * Binary data (terminal output/input) is base64 encoded for JSON transport.
+ */
+/** Send user input (keystrokes) to a terminal session */
+export interface GuiInputMessage {
+    type: "input";
+    sessionId: string;
+    /** Base64-encoded input bytes */
+    data: string;
+}
+/** Request creation of a new terminal session */
+export interface GuiCreateSessionMessage {
+    type: "create-session";
+    /** Shell to use (e.g., "/bin/zsh"). If omitted, uses system default */
+    shell?: string;
+    /** Terminal width in columns */
+    cols: number;
+    /** Terminal height in rows */
+    rows: number;
+    /** Working directory. If omitted, uses current directory */
+    cwd?: string;
+    /** Additional environment variables */
+    env?: Record<string, string>;
+}
+/** Request to close a terminal session */
+export interface GuiCloseSessionMessage {
+    type: "close-session";
+    sessionId: string;
+}
+/** Request to resize a terminal session */
+export interface GuiResizeMessage {
+    type: "resize";
+    sessionId: string;
+    cols: number;
+    rows: number;
+}
+/** Request to start recording a session */
+export interface GuiStartRecordingMessage {
+    type: "start-recording";
+    sessionId: string;
+    /** Optional filename override */
+    filename?: string;
+}
+/** Request to stop recording a session */
+export interface GuiStopRecordingMessage {
+    type: "stop-recording";
+    sessionId: string;
+}
+/** Request current terminal content (for initial sync) */
+export interface GuiGetContentMessage {
+    type: "get-content";
+    sessionId: string;
+}
+/** Request list of active sessions */
+export interface GuiListSessionsMessage {
+    type: "list-sessions";
+}
+/** Union type of all messages from GUI to backend */
+export type GuiMessageToBackend = GuiInputMessage | GuiCreateSessionMessage | GuiCloseSessionMessage | GuiResizeMessage | GuiStartRecordingMessage | GuiStopRecordingMessage | GuiGetContentMessage | GuiListSessionsMessage;
+/** Raw terminal output data */
+export interface BackendOutputMessage {
+    type: "output";
+    sessionId: string;
+    /** Base64-encoded output bytes */
+    data: string;
+}
+/** Notification that a new session was created */
+export interface BackendSessionCreatedMessage {
+    type: "session-created";
+    sessionId: string;
+    shell: string;
+    cols: number;
+    rows: number;
+    cwd: string;
+}
+/** Notification that a session was closed */
+export interface BackendSessionClosedMessage {
+    type: "session-closed";
+    sessionId: string;
+    exitCode: number;
+}
+/** Notification that a session was resized */
+export interface BackendResizeMessage {
+    type: "resize";
+    sessionId: string;
+    cols: number;
+    rows: number;
+}
+/** Notification that recording started */
+export interface BackendRecordingStartedMessage {
+    type: "recording-started";
+    sessionId: string;
+    filename: string;
+}
+/** Notification that recording stopped */
+export interface BackendRecordingStoppedMessage {
+    type: "recording-stopped";
+    sessionId: string;
+    filename: string;
+    /** Whether the recording was saved (vs discarded due to mode) */
+    saved: boolean;
+}
+/** Response to get-content request */
+export interface BackendContentMessage {
+    type: "content";
+    sessionId: string;
+    /** Full terminal buffer content */
+    content: string;
+    cursor: {
+        x: number;
+        y: number;
+    };
+    dimensions: {
+        cols: number;
+        rows: number;
+    };
+}
+/** Response to list-sessions request */
+export interface BackendSessionListMessage {
+    type: "session-list";
+    sessions: Array<{
+        sessionId: string;
+        shell: string;
+        cols: number;
+        rows: number;
+        cwd: string;
+        isRecording: boolean;
+    }>;
+}
+/** Error response */
+export interface BackendErrorMessage {
+    type: "error";
+    /** Original request type that caused the error */
+    requestType: string;
+    sessionId?: string;
+    message: string;
+    code?: string;
+}
+/** Union type of all messages from backend to GUI */
+export type GuiMessageToFrontend = BackendOutputMessage | BackendSessionCreatedMessage | BackendSessionClosedMessage | BackendResizeMessage | BackendRecordingStartedMessage | BackendRecordingStoppedMessage | BackendContentMessage | BackendSessionListMessage | BackendErrorMessage;
+/**
+ * Encode a string to base64 for transport
+ */
+export declare function encodeData(data: string): string;
+/**
+ * Decode base64 data back to string
+ */
+export declare function decodeData(base64: string): string;
+/**
+ * Type guard for GUI messages to backend
+ */
+export declare function isGuiMessageToBackend(msg: unknown): msg is GuiMessageToBackend;
+/**
+ * Type guard for backend messages to GUI
+ */
+export declare function isGuiMessageToFrontend(msg: unknown): msg is GuiMessageToFrontend;
+//# sourceMappingURL=gui-protocol.d.ts.map

package/dist/transport/gui-protocol.d.ts.map

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

package/dist/transport/gui-protocol.js

@@ -0,0 +1,68 @@
+/**
+ * GUI Communication Protocol
+ *
+ * Defines the message types for communication between the brosh backend
+ * and GUI frontends (Electron, web, etc.)
+ *
+ * Messages are JSON-encoded and sent over IPC (Electron) or Unix socket/WebSocket.
+ * Binary data (terminal output/input) is base64 encoded for JSON transport.
+ */
+// ============================================================================
+// Utility Functions
+// ============================================================================
+/**
+ * Encode a string to base64 for transport
+ */
+export function encodeData(data) {
+    return Buffer.from(data, "utf-8").toString("base64");
+}
+/**
+ * Decode base64 data back to string
+ */
+export function decodeData(base64) {
+    return Buffer.from(base64, "base64").toString("utf-8");
+}
+/**
+ * Type guard for GUI messages to backend
+ */
+export function isGuiMessageToBackend(msg) {
+    if (typeof msg !== "object" || msg === null)
+        return false;
+    const m = msg;
+    if (typeof m.type !== "string")
+        return false;
+    const validTypes = [
+        "input",
+        "create-session",
+        "close-session",
+        "resize",
+        "start-recording",
+        "stop-recording",
+        "get-content",
+        "list-sessions",
+    ];
+    return validTypes.includes(m.type);
+}
+/**
+ * Type guard for backend messages to GUI
+ */
+export function isGuiMessageToFrontend(msg) {
+    if (typeof msg !== "object" || msg === null)
+        return false;
+    const m = msg;
+    if (typeof m.type !== "string")
+        return false;
+    const validTypes = [
+        "output",
+        "session-created",
+        "session-closed",
+        "resize",
+        "recording-started",
+        "recording-stopped",
+        "content",
+        "session-list",
+        "error",
+    ];
+    return validTypes.includes(m.type);
+}
+//# sourceMappingURL=gui-protocol.js.map

package/dist/transport/gui-protocol.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gui-protocol.js","sourceRoot":"","sources":["../../src/transport/gui-protocol.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAuLH,+EAA+E;AAC/E,oBAAoB;AACpB,+EAA+E;AAE/E;;GAEG;AACH,MAAM,UAAU,UAAU,CAAC,IAAY;IACrC,OAAO,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;AACvD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,UAAU,CAAC,MAAc;IACvC,OAAO,MAAM,CAAC,IAAI,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;AACzD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,qBAAqB,CAAC,GAAY;IAChD,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG,KAAK,IAAI;QAAE,OAAO,KAAK,CAAC;IAC1D,MAAM,CAAC,GAAG,GAA8B,CAAC;IACzC,IAAI,OAAO,CAAC,CAAC,IAAI,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IAE7C,MAAM,UAAU,GAAG;QACjB,OAAO;QACP,gBAAgB;QAChB,eAAe;QACf,QAAQ;QACR,iBAAiB;QACjB,gBAAgB;QAChB,aAAa;QACb,eAAe;KAChB,CAAC;IAEF,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;AACrC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,sBAAsB,CAAC,GAAY;IACjD,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG,KAAK,IAAI;QAAE,OAAO,KAAK,CAAC;IAC1D,MAAM,CAAC,GAAG,GAA8B,CAAC;IACzC,IAAI,OAAO,CAAC,CAAC,IAAI,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IAE7C,MAAM,UAAU,GAAG;QACjB,QAAQ;QACR,iBAAiB;QACjB,gBAAgB;QAChB,QAAQ;QACR,mBAAmB;QACnB,mBAAmB;QACnB,SAAS;QACT,cAAc;QACd,OAAO;KACR,CAAC;IAEF,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;AACrC,CAAC"}

package/dist/transport/gui-stream.d.ts

@@ -0,0 +1,139 @@
+/**
+ * GUI Output Stream
+ *
+ * Manages connections from GUI clients and broadcasts terminal events to them.
+ * Supports multiple concurrent GUI clients (e.g., multiple Electron windows).
+ *
+ * This module provides the bridge between brosh's core PTY handling
+ * and GUI frontends like Electron.
+ */
+import { EventEmitter } from "events";
+import type { GuiMessageToFrontend, GuiMessageToBackend } from "./gui-protocol.js";
+import type { TerminalManager } from "../terminal/index.js";
+import type { TerminalSession } from "../terminal/session.js";
+/** Callback type for sending messages to a GUI client */
+export type GuiClientCallback = (message: GuiMessageToFrontend) => void;
+/** Events emitted by GUIOutputStream */
+export interface GUIOutputStreamEvents {
+    "client-connected": (clientId: string) => void;
+    "client-disconnected": (clientId: string) => void;
+    error: (error: Error) => void;
+}
+/**
+ * Manages GUI client connections and routes messages between
+ * terminal sessions and GUI frontends.
+ *
+ * Currently works with TerminalManager's single-session model.
+ * Multi-session support will be added when TerminalManager is extended.
+ */
+export declare class GUIOutputStream extends EventEmitter {
+    private clients;
+    private sessionSubscriptions;
+    private manager;
+    private clientCounter;
+    private sessionEventsBound;
+    constructor();
+    /**
+     * Attach a TerminalManager to handle session operations
+     */
+    attachManager(manager: TerminalManager): void;
+    /**
+     * Add a GUI client connection
+     * @returns clientId for this connection
+     */
+    addClient(callback: GuiClientCallback): string;
+    /**
+     * Remove a GUI client connection
+     */
+    removeClient(clientId: string): void;
+    /**
+     * Get the number of connected clients
+     */
+    getClientCount(): number;
+    /**
+     * Send a message to a specific client
+     */
+    sendToClient(clientId: string, message: GuiMessageToFrontend): void;
+    /**
+     * Broadcast a message to all connected clients
+     */
+    broadcast(message: GuiMessageToFrontend): void;
+    /**
+     * Broadcast a message to clients subscribed to a specific session
+     */
+    broadcastToSession(sessionId: string, message: GuiMessageToFrontend): void;
+    /**
+     * Subscribe a client to a session's events
+     */
+    subscribeToSession(clientId: string, sessionId: string): void;
+    /**
+     * Unsubscribe a client from a session's events
+     */
+    unsubscribeFromSession(clientId: string, sessionId: string): void;
+    /**
+     * Emit terminal output to subscribed GUI clients
+     */
+    emitOutput(sessionId: string, data: string): void;
+    /**
+     * Emit session created event
+     */
+    emitSessionCreated(sessionId: string, shell: string, cols: number, rows: number, cwd: string): void;
+    /**
+     * Emit session closed event
+     */
+    emitSessionClosed(sessionId: string, exitCode: number): void;
+    /**
+     * Emit resize event
+     */
+    emitResize(sessionId: string, cols: number, rows: number): void;
+    /**
+     * Emit recording started event
+     */
+    emitRecordingStarted(sessionId: string, filename: string): void;
+    /**
+     * Emit recording stopped event
+     */
+    emitRecordingStopped(sessionId: string, filename: string, saved: boolean): void;
+    /**
+     * Handle an incoming message from a GUI client
+     */
+    handleMessage(clientId: string, message: GuiMessageToBackend): Promise<void>;
+    /**
+     * Handle create-session request
+     * Currently uses TerminalManager's single-session model
+     */
+    private handleCreateSession;
+    /**
+     * Handle close-session request
+     */
+    private handleCloseSession;
+    /**
+     * Handle input message
+     */
+    private handleInput;
+    /**
+     * Handle resize message
+     */
+    private handleResize;
+    /**
+     * Handle get-content request
+     */
+    private handleGetContent;
+    /**
+     * Handle list-sessions request
+     */
+    private handleListSessions;
+    /**
+     * Set up event forwarding from a session to GUI clients
+     */
+    setupSessionEventForwarding(session: TerminalSession): void;
+    /**
+     * Dispose of all connections
+     */
+    dispose(): void;
+}
+/**
+ * Create a GUIOutputStream instance attached to a manager
+ */
+export declare function createGUIOutputStream(manager: TerminalManager): GUIOutputStream;
+//# sourceMappingURL=gui-stream.d.ts.map

package/dist/transport/gui-stream.d.ts.map

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