@pdhaku0/gemini-cli-agent-sdk 0.1.0

package/README.md

@@ -0,0 +1,109 @@
+# Agent Chat SDK
+
+A TypeScript SDK for building chat UIs on top of the Gemini CLI Agent via ACP (Agent Chat Protocol). It provides a browser-safe client, a bridge for the CLI, and a UI-friendly event model.
+
+## Features
+
+- **WebSocket transport** with reconnect + ACP framing
+- **Client event model** tuned for UI rendering
+- **Tool call parsing** (permissions, inputs, diff rendering)
+- **Replay support** for late joiners / infinite scroll
+- **Bridge process** to run Gemini CLI via stdio
+- **Optional store** (`AgentChatStore`) for React/GUI state
+
+## Installation
+
+```bash
+npm install @pdhaku0/gemini-cli-agent-sdk
+```
+
+## Requirements
+
+- Node.js 18+ (bridge and any server usage)
+- Gemini CLI with `--experimental-acp`
+- Browser client or Node with `ws`
+
+## Quick Start
+
+### 1) Start the bridge
+
+```bash
+npm run start:bridge
+```
+
+### 2) Connect a client
+
+```ts
+import { AgentChatClient } from '@pdhaku0/gemini-cli-agent-sdk/client';
+
+const client = new AgentChatClient({
+  url: 'ws://localhost:4444',
+  cwd: '/path/to/project',
+  replay: { limit: 15 },
+});
+
+client.on('text_delta', ({ delta }) => process.stdout.write(delta));
+client.on('tool_update', ({ toolCall }) => {
+  console.log(`[tool] ${toolCall.name} ${toolCall.status}`);
+});
+
+await client.connect();
+await client.sendMessage('List files in the current directory.');
+```
+
+### 3) Replay older turns (infinite scroll)
+
+```ts
+const older = await AgentChatClient.fetchReplay('ws://localhost:4444', {
+  before: oldestTimestampMs,
+  limit: 10,
+});
+client.prependMessages(older);
+```
+
+### 4) Optional SYS tags (structured capture)
+
+Use SYS tags in assistant output and capture them on the bridge:
+
+```ts
+import { GeminiBridge } from '@pdhaku0/gemini-cli-agent-sdk/server';
+import { createSysTagTransform } from '@pdhaku0/gemini-cli-agent-sdk/extras';
+
+const bridge = new GeminiBridge({
+  outgoingTransform: createSysTagTransform({ mode: 'event' }),
+});
+bridge.start();
+```
+
+### 5) Hidden initial prompt
+
+```ts
+await client.sendMessage('System priming...', { hidden: 'turn' });
+```
+
+## Examples
+
+- `examples/next-app` — full Next.js App Router UI (auth, approvals, replay, session persistence)
+- `examples/cli` — minimal Node CLI (streaming + tool approvals)
+
+Examples are **kept in the repo** but **excluded from npm** to keep the package lean.
+
+## Documentation
+
+- `docs/USAGE.md` — full end-to-end guide
+- `docs/API.md` — API surface
+- `docs/EVENTS.md` — event model + rendering rules
+- `docs/INTEGRATION.md` — Next/Node integration patterns
+- `docs/TROUBLESHOOTING.md` — common pitfalls
+
+## Development
+
+- Build: `npm run build`
+- Bridge: `npm run start:bridge`
+- CLI example: `node examples/cli/index.js`
+
+## Notes
+
+- The bridge keeps **in-memory replay only**. Restarting the bridge clears replay history.
+- Reusing sessions across reloads is supported by passing a saved `sessionId` to the client.
+- Replay `limit` is **turns**, not messages.

package/client/index.d.ts

@@ -0,0 +1 @@
+export * from '../dist/client';

package/client/index.js

@@ -0,0 +1 @@
+export * from '../dist/client.js';

package/client/package.json

@@ -0,0 +1 @@
+{"type":"module"}

package/dist/client.d.ts

@@ -0,0 +1,5 @@
+export { AgentChatClient } from './core/AgentChatClient.js';
+export { AcpWebSocketTransport } from './core/AcpWebSocketTransport.js';
+export { AgentChatStore } from './ui/AgentChatStore.js';
+export * from './common/types.js';
+export type { AgentChatState } from './common/types.js';

package/dist/client.js

@@ -0,0 +1,5 @@
+export { AgentChatClient } from './core/AgentChatClient.js';
+export { AcpWebSocketTransport } from './core/AcpWebSocketTransport.js';
+export { AgentChatStore } from './ui/AgentChatStore.js';
+export * from './common/types.js';
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAC5D,OAAO,EAAE,qBAAqB,EAAE,MAAM,iCAAiC,CAAC;AACxE,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AACxD,cAAc,mBAAmB,CAAC"}

package/dist/common/types.d.ts

@@ -0,0 +1,191 @@
+import { z } from 'zod';
+/**
+ * Base JSON-RPC 2.0 types
+ */
+export declare const JsonRpcIdSchema: z.ZodUnion<[z.ZodString, z.ZodNumber, z.ZodNull]>;
+export type JsonRpcId = z.infer<typeof JsonRpcIdSchema>;
+export declare const JsonRpcMessageSchema: z.ZodObject<{
+    jsonrpc: z.ZodLiteral<"2.0">;
+    id: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNumber, z.ZodNull]>>;
+    method: z.ZodOptional<z.ZodString>;
+    params: z.ZodOptional<z.ZodAny>;
+    result: z.ZodOptional<z.ZodAny>;
+    error: z.ZodOptional<z.ZodObject<{
+        code: z.ZodNumber;
+        message: z.ZodString;
+        data: z.ZodOptional<z.ZodAny>;
+    }, "strip", z.ZodTypeAny, {
+        code: number;
+        message: string;
+        data?: any;
+    }, {
+        code: number;
+        message: string;
+        data?: any;
+    }>>;
+}, "strip", z.ZodTypeAny, {
+    jsonrpc: "2.0";
+    params?: any;
+    id?: string | number | null | undefined;
+    method?: string | undefined;
+    result?: any;
+    error?: {
+        code: number;
+        message: string;
+        data?: any;
+    } | undefined;
+}, {
+    jsonrpc: "2.0";
+    params?: any;
+    id?: string | number | null | undefined;
+    method?: string | undefined;
+    result?: any;
+    error?: {
+        code: number;
+        message: string;
+        data?: any;
+    } | undefined;
+}>;
+export type JsonRpcMessage = z.infer<typeof JsonRpcMessageSchema>;
+/**
+ * ACP Specific Types
+ */
+export type ConnectionState = 'connecting' | 'connected' | 'reconnecting' | 'disconnected';
+export type HiddenMode = 'none' | 'user' | 'assistant' | 'turn';
+export interface PendingApproval {
+    requestId: JsonRpcId;
+    toolCall: {
+        toolCallId: string;
+        kind: string;
+        title: string;
+        locations?: any[];
+        input?: string;
+        description?: string;
+        workingDir?: string;
+        args?: any;
+    };
+    options: Array<{
+        optionId: string;
+        kind: 'allow_once' | 'allow_always' | 'deny' | 'deny_always' | 'reject_once';
+        label?: string;
+        name?: string;
+    }>;
+}
+export interface AcpSessionNewParams {
+    cwd: string;
+    mcpServers?: any[];
+    model?: string;
+}
+export interface AcpSessionNewResult {
+    sessionId: string;
+}
+export interface AcpPromptParams {
+    sessionId: string;
+    prompt: Array<{
+        type: 'text';
+        text: string;
+    }>;
+}
+export type AcpSessionUpdateType = 'agent_thought_chunk' | 'agent_message_chunk' | 'end_of_turn' | 'tool_call' | 'tool_call_update' | 'response.completed';
+export interface AcpSessionUpdateNotification {
+    method: 'session/update';
+    params: {
+        update: {
+            sessionUpdate: AcpSessionUpdateType;
+            content?: {
+                type: 'text';
+                text: string;
+            };
+            toolCallId?: string;
+            kind?: string;
+            title?: string;
+            status?: string;
+            locations?: any[];
+            stopReason?: string;
+        };
+    };
+}
+export interface AcpRequestPermissionNotification {
+    id: JsonRpcId;
+    method: 'session/request_permission';
+    params: {
+        toolCall: {
+            toolCallId: string;
+            kind: string;
+            title: string;
+            locations?: any[];
+        };
+        options: Array<{
+            optionId: string;
+            kind: 'allow_once' | 'deny' | 'allow_always' | 'deny_always';
+            label?: string;
+        }>;
+    };
+}
+export interface AcpAuthUrlNotification {
+    method: 'gemini/authUrl';
+    params: {
+        url: string;
+    };
+}
+export interface AcpSubmitAuthCodeParams {
+    code: string;
+}
+export type ChatRole = 'user' | 'assistant' | 'system' | 'tool';
+export type ToolStatus = 'queued' | 'running' | 'completed' | 'failed' | 'cancelled';
+export interface ToolCall {
+    id: string;
+    name: string;
+    title: string;
+    description?: string;
+    workingDir?: string;
+    status: ToolStatus;
+    input?: string;
+    args?: any;
+    result?: string;
+    diff?: {
+        path?: string;
+        unified: string;
+        oldTextLength?: number;
+        newTextLength?: number;
+    };
+    ts: number;
+}
+export type MessageContentPart = {
+    type: 'text';
+    text: string;
+} | {
+    type: 'thought';
+    thought: string;
+} | {
+    type: 'tool_call';
+    call: ToolCall;
+};
+export interface AssistantMessage {
+    id: string;
+    role: 'assistant';
+    thought: string;
+    text: string;
+    content: MessageContentPart[];
+    toolCalls: ToolCall[];
+    stopReason?: string;
+    hidden?: boolean;
+    ts: number;
+}
+export interface UserMessage {
+    id: string;
+    role: 'user';
+    text: string;
+    hidden?: boolean;
+    ts: number;
+}
+export type ChatMessage = UserMessage | AssistantMessage;
+export interface AgentChatState {
+    connectionState: ConnectionState;
+    isStreaming: boolean;
+    messages: ChatMessage[];
+    pendingApproval: PendingApproval | null;
+    authUrl: string | null;
+    lastStopReason: string | null;
+    lastError: unknown | null;
+}

package/dist/common/types.js

@@ -0,0 +1,18 @@
+import { z } from 'zod';
+/**
+ * Base JSON-RPC 2.0 types
+ */
+export const JsonRpcIdSchema = z.union([z.string(), z.number(), z.null()]);
+export const JsonRpcMessageSchema = z.object({
+    jsonrpc: z.literal('2.0'),
+    id: JsonRpcIdSchema.optional(),
+    method: z.string().optional(),
+    params: z.any().optional(),
+    result: z.any().optional(),
+    error: z.object({
+        code: z.number(),
+        message: z.string(),
+        data: z.any().optional(),
+    }).optional(),
+});
+//# sourceMappingURL=types.js.map

package/dist/common/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/common/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;GAEG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;AAG3E,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC,MAAM,CAAC;IACzC,OAAO,EAAE,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC;IACzB,EAAE,EAAE,eAAe,CAAC,QAAQ,EAAE;IAC9B,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC7B,MAAM,EAAE,CAAC,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE;IAC1B,MAAM,EAAE,CAAC,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE;IAC1B,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC;QACZ,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;QAChB,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;QACnB,IAAI,EAAE,CAAC,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE;KAC3B,CAAC,CAAC,QAAQ,EAAE;CAChB,CAAC,CAAC"}

package/dist/core/AcpWebSocketTransport.d.ts

@@ -0,0 +1,25 @@
+import { EventEmitter } from 'events';
+import { JsonRpcId } from '../common/types.js';
+export interface AcpWebSocketOptions {
+    url: string;
+    reconnect?: boolean;
+    reconnectInterval?: number;
+    webSocketCtor?: any;
+}
+export declare class AcpWebSocketTransport extends EventEmitter {
+    private ws;
+    private options;
+    private pendingRequests;
+    private nextId;
+    private connectionState;
+    constructor(options: AcpWebSocketOptions);
+    private resolveWebSocketConstructor;
+    connect(): void;
+    private openWebSocket;
+    sendRequest(method: string, params: any): Promise<any>;
+    sendNotification(method: string, params: any): void;
+    sendResponse(id: JsonRpcId, result: any): void;
+    private handleMessage;
+    dispose(): void;
+    private setConnectionState;
+}

package/dist/core/AcpWebSocketTransport.js

@@ -0,0 +1,222 @@
+import { EventEmitter } from 'events';
+import { JsonRpcMessageSchema } from '../common/types.js';
+export class AcpWebSocketTransport extends EventEmitter {
+    ws = null;
+    options;
+    pendingRequests = new Map();
+    nextId = 1;
+    connectionState = 'disconnected';
+    constructor(options) {
+        super();
+        this.options = {
+            reconnect: true,
+            reconnectInterval: 2000,
+            ...options,
+        };
+    }
+    async resolveWebSocketConstructor() {
+        if (this.options.webSocketCtor)
+            return this.options.webSocketCtor;
+        // In browser, window.WebSocket is most likely to be the "real" native one.
+        // Bundlers like Turbopack often shim globalThis.WebSocket to 'ws' shim.
+        if (typeof window !== 'undefined' && typeof window.WebSocket === 'function') {
+            return window.WebSocket;
+        }
+        const global = globalThis;
+        const win = typeof window !== 'undefined' ? window : {};
+        // Follow-up checks
+        if (typeof global.WebSocket === 'function')
+            return global.WebSocket;
+        if (global.WebSocket?.WebSocket)
+            return global.WebSocket.WebSocket;
+        if (win.WebSocket?.WebSocket)
+            return win.WebSocket.WebSocket;
+        if (typeof win.MozWebSocket === 'function')
+            return win.MozWebSocket;
+        // Node fallback (dynamic import to avoid bundler issues)
+        if (typeof process !== 'undefined' && process.versions?.node) {
+            try {
+                const mod = await import('ws');
+                return mod?.WebSocket || mod;
+            }
+            catch {
+                return null;
+            }
+        }
+        return null;
+    }
+    connect() {
+        if (this.connectionState === 'connecting' || this.connectionState === 'connected') {
+            return;
+        }
+        this.setConnectionState('connecting');
+        console.log(`[ACP] Connecting to ${this.options.url}...`);
+        void this.openWebSocket();
+    }
+    async openWebSocket() {
+        const WS = await this.resolveWebSocketConstructor();
+        if (!WS) {
+            const err = new Error('WebSocket constructor not found in this environment');
+            console.error('[ACP]', err);
+            this.emit('error', err);
+            this.setConnectionState('disconnected');
+            return;
+        }
+        try {
+            this.ws = new WS(this.options.url);
+            const handleOpen = () => {
+                console.log(`[ACP] WebSocket Connected to ${this.options.url}`);
+                this.setConnectionState('connected');
+                this.emit('connected');
+            };
+            const handleMessage = async (eventOrData) => {
+                try {
+                    // Normalize data to string (browser event or ws data)
+                    let data = eventOrData?.data ?? eventOrData;
+                    if (typeof Blob !== 'undefined' && data instanceof Blob) {
+                        data = await data.text();
+                    }
+                    else if (typeof ArrayBuffer !== 'undefined' && (data instanceof ArrayBuffer || ArrayBuffer.isView(data))) {
+                        data = new TextDecoder().decode(data);
+                    }
+                    const strData = data.toString();
+                    if (strData.includes('"error"')) {
+                        console.log('[ACP] Received Error Message:', strData);
+                    }
+                    this.handleMessage(strData);
+                }
+                catch (e) {
+                    console.error('[ACP] Error processing message:', e);
+                }
+            };
+            const handleClose = (event) => {
+                const reason = event?.reason || 'no reason provided';
+                const code = event?.code;
+                console.log(`[ACP] WebSocket Closed (URL: ${this.options.url}, Code: ${code}, Reason: ${reason})`);
+                if (this.pendingRequests.size) {
+                    const err = new Error(`WebSocket closed: ${reason} (code: ${code})`);
+                    for (const [, pending] of this.pendingRequests) {
+                        pending.reject(err);
+                    }
+                    this.pendingRequests.clear();
+                }
+                this.emit('disconnected');
+                if (this.options.reconnect) {
+                    this.setConnectionState('reconnecting');
+                    setTimeout(() => this.connect(), this.options.reconnectInterval);
+                }
+                else {
+                    this.setConnectionState('disconnected');
+                }
+            };
+            const handleError = (err) => {
+                // Browsers often fire a generic error event with no details.
+                const msg = `WebSocket connection failed to ${this.options.url}. Check if the server is running and accessible.`;
+                console.error(`[ACP] ${msg}`, err);
+                this.emit('error', new Error(msg));
+            };
+            if (typeof this.ws.on === 'function') {
+                this.ws.on('open', handleOpen);
+                this.ws.on('message', handleMessage);
+                this.ws.on('close', handleClose);
+                this.ws.on('error', handleError);
+            }
+            else {
+                this.ws.onopen = handleOpen;
+                this.ws.onmessage = handleMessage;
+                this.ws.onclose = handleClose;
+                this.ws.onerror = handleError;
+            }
+        }
+        catch (e) {
+            console.error(`[ACP] Failed to initialize WebSocket for ${this.options.url}:`, e);
+            this.emit('error', e);
+        }
+    }
+    sendRequest(method, params) {
+        const id = this.nextId++;
+        const message = {
+            jsonrpc: '2.0',
+            id,
+            method,
+            params,
+        };
+        return new Promise((resolve, reject) => {
+            const ws = this.ws;
+            if (!ws || ws.readyState !== 1) { // 1 = OPEN
+                reject(new Error('WebSocket is not open'));
+                return;
+            }
+            this.pendingRequests.set(id, { resolve, reject });
+            ws.send(JSON.stringify(message));
+        });
+    }
+    sendNotification(method, params) {
+        const message = {
+            jsonrpc: '2.0',
+            method,
+            params,
+        };
+        if (this.ws?.readyState === 1) {
+            this.ws.send(JSON.stringify(message));
+        }
+    }
+    sendResponse(id, result) {
+        const message = {
+            jsonrpc: '2.0',
+            id,
+            result,
+        };
+        if (this.ws?.readyState === 1) {
+            this.ws.send(JSON.stringify(message));
+        }
+    }
+    handleMessage(data) {
+        try {
+            const raw = JSON.parse(data);
+            const msg = JsonRpcMessageSchema.parse(raw);
+            // Handle Response
+            if (msg.id !== undefined && (msg.result !== undefined || msg.error !== undefined)) {
+                const pending = this.pendingRequests.get(msg.id);
+                if (pending) {
+                    this.pendingRequests.delete(msg.id);
+                    if (msg.error) {
+                        const errorMsg = msg.error.message || 'Unknown JSON-RPC error';
+                        const error = new Error(errorMsg);
+                        error.code = msg.error.code;
+                        error.data = msg.error.data;
+                        pending.reject(error);
+                    }
+                    else {
+                        pending.resolve(msg.result);
+                    }
+                }
+                return;
+            }
+            // Handle Request/Notification
+            if (msg.method) {
+                this.emit('notification', msg);
+                this.emit(`method:${msg.method}`, msg);
+            }
+        }
+        catch (err) {
+            console.error('[ACP] Failed to parse message:', err);
+        }
+    }
+    dispose() {
+        this.options.reconnect = false;
+        if (this.ws) {
+            this.ws.onclose = null; // Prevent reconnect loop
+            this.ws.close();
+        }
+        this.pendingRequests.clear();
+        this.setConnectionState('disconnected');
+    }
+    setConnectionState(state) {
+        if (this.connectionState === state)
+            return;
+        this.connectionState = state;
+        this.emit('connection_state', state);
+    }
+}
+//# sourceMappingURL=AcpWebSocketTransport.js.map

package/dist/core/AcpWebSocketTransport.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AcpWebSocketTransport.js","sourceRoot":"","sources":["../../src/core/AcpWebSocketTransport.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AACtC,OAAO,EAA6B,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AASrF,MAAM,OAAO,qBAAsB,SAAQ,YAAY;IAC3C,EAAE,GAAe,IAAI,CAAC;IACtB,OAAO,CAAsB;IAC7B,eAAe,GAAG,IAAI,GAAG,EAA0E,CAAC;IACpG,MAAM,GAAG,CAAC,CAAC;IACX,eAAe,GAAiE,cAAc,CAAC;IAEvG,YAAY,OAA4B;QACpC,KAAK,EAAE,CAAC;QACR,IAAI,CAAC,OAAO,GAAG;YACX,SAAS,EAAE,IAAI;YACf,iBAAiB,EAAE,IAAI;YACvB,GAAG,OAAO;SACb,CAAC;IACN,CAAC;IAEO,KAAK,CAAC,2BAA2B;QACrC,IAAI,IAAI,CAAC,OAAO,CAAC,aAAa;YAAE,OAAO,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC;QAClE,2EAA2E;QAC3E,wEAAwE;QACxE,IAAI,OAAO,MAAM,KAAK,WAAW,IAAI,OAAO,MAAM,CAAC,SAAS,KAAK,UAAU,EAAE,CAAC;YAC1E,OAAO,MAAM,CAAC,SAAS,CAAC;QAC5B,CAAC;QAED,MAAM,MAAM,GAAQ,UAAU,CAAC;QAC/B,MAAM,GAAG,GAAQ,OAAO,MAAM,KAAK,WAAW,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC;QAE7D,mBAAmB;QACnB,IAAI,OAAO,MAAM,CAAC,SAAS,KAAK,UAAU;YAAE,OAAO,MAAM,CAAC,SAAS,CAAC;QACpE,IAAI,MAAM,CAAC,SAAS,EAAE,SAAS;YAAE,OAAO,MAAM,CAAC,SAAS,CAAC,SAAS,CAAC;QACnE,IAAI,GAAG,CAAC,SAAS,EAAE,SAAS;YAAE,OAAO,GAAG,CAAC,SAAS,CAAC,SAAS,CAAC;QAC7D,IAAI,OAAO,GAAG,CAAC,YAAY,KAAK,UAAU;YAAE,OAAO,GAAG,CAAC,YAAY,CAAC;QAEpE,yDAAyD;QACzD,IAAI,OAAO,OAAO,KAAK,WAAW,IAAI,OAAO,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC;YAC3D,IAAI,CAAC;gBACD,MAAM,GAAG,GAAQ,MAAM,MAAM,CAAC,IAAI,CAAC,CAAC;gBACpC,OAAO,GAAG,EAAE,SAAS,IAAI,GAAG,CAAC;YACjC,CAAC;YAAC,MAAM,CAAC;gBACL,OAAO,IAAI,CAAC;YAChB,CAAC;QACL,CAAC;QAED,OAAO,IAAI,CAAC;IAChB,CAAC;IAED,OAAO;QACH,IAAI,IAAI,CAAC,eAAe,KAAK,YAAY,IAAI,IAAI,CAAC,eAAe,KAAK,WAAW,EAAE,CAAC;YAChF,OAAO;QACX,CAAC;QACD,IAAI,CAAC,kBAAkB,CAAC,YAAY,CAAC,CAAC;QACtC,OAAO,CAAC,GAAG,CAAC,uBAAuB,IAAI,CAAC,OAAO,CAAC,GAAG,KAAK,CAAC,CAAC;QAE1D,KAAK,IAAI,CAAC,aAAa,EAAE,CAAC;IAC9B,CAAC;IAEO,KAAK,CAAC,aAAa;QACvB,MAAM,EAAE,GAAG,MAAM,IAAI,CAAC,2BAA2B,EAAE,CAAC;QACpD,IAAI,CAAC,EAAE,EAAE,CAAC;YACN,MAAM,GAAG,GAAG,IAAI,KAAK,CAAC,qDAAqD,CAAC,CAAC;YAC7E,OAAO,CAAC,KAAK,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;YAC5B,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;YACxB,IAAI,CAAC,kBAAkB,CAAC,cAAc,CAAC,CAAC;YACxC,OAAO;QACX,CAAC;QAED,IAAI,CAAC;YACD,IAAI,CAAC,EAAE,GAAG,IAAI,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;YAEnC,MAAM,UAAU,GAAG,GAAG,EAAE;gBACpB,OAAO,CAAC,GAAG,CAAC,gCAAgC,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;gBAChE,IAAI,CAAC,kBAAkB,CAAC,WAAW,CAAC,CAAC;gBACrC,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;YAC3B,CAAC,CAAC;YAEF,MAAM,aAAa,GAAG,KAAK,EAAE,WAAgB,EAAE,EAAE;gBAC7C,IAAI,CAAC;oBACD,sDAAsD;oBACtD,IAAI,IAAI,GAAG,WAAW,EAAE,IAAI,IAAI,WAAW,CAAC;oBAC5C,IAAI,OAAO,IAAI,KAAK,WAAW,IAAI,IAAI,YAAY,IAAI,EAAE,CAAC;wBACtD,IAAI,GAAG,MAAM,IAAI,CAAC,IAAI,EAAE,CAAC;oBAC7B,CAAC;yBAAM,IAAI,OAAO,WAAW,KAAK,WAAW,IAAI,CAAC,IAAI,YAAY,WAAW,IAAI,WAAW,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC;wBACzG,IAAI,GAAG,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;oBAC1C,CAAC;oBAED,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,EAAE,CAAC;oBAChC,IAAI,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC;wBAC9B,OAAO,CAAC,GAAG,CAAC,+BAA+B,EAAE,OAAO,CAAC,CAAC;oBAC1D,CAAC;oBAED,IAAI,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC;gBAChC,CAAC;gBAAC,OAAO,CAAC,EAAE,CAAC;oBACT,OAAO,CAAC,KAAK,CAAC,iCAAiC,EAAE,CAAC,CAAC,CAAC;gBACxD,CAAC;YACL,CAAC,CAAC;YAEF,MAAM,WAAW,GAAG,CAAC,KAAU,EAAE,EAAE;gBAC/B,MAAM,MAAM,GAAG,KAAK,EAAE,MAAM,IAAI,oBAAoB,CAAC;gBACrD,MAAM,IAAI,GAAG,KAAK,EAAE,IAAI,CAAC;gBACzB,OAAO,CAAC,GAAG,CAAC,gCAAgC,IAAI,CAAC,OAAO,CAAC,GAAG,WAAW,IAAI,aAAa,MAAM,GAAG,CAAC,CAAC;gBAEnG,IAAI,IAAI,CAAC,eAAe,CAAC,IAAI,EAAE,CAAC;oBAC5B,MAAM,GAAG,GAAG,IAAI,KAAK,CAAC,qBAAqB,MAAM,WAAW,IAAI,GAAG,CAAC,CAAC;oBACrE,KAAK,MAAM,CAAC,EAAE,OAAO,CAAC,IAAI,IAAI,CAAC,eAAe,EAAE,CAAC;wBAC7C,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;oBACxB,CAAC;oBACD,IAAI,CAAC,eAAe,CAAC,KAAK,EAAE,CAAC;gBACjC,CAAC;gBACD,IAAI,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;gBAE1B,IAAI,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,CAAC;oBACzB,IAAI,CAAC,kBAAkB,CAAC,cAAc,CAAC,CAAC;oBACxC,UAAU,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,OAAO,EAAE,EAAE,IAAI,CAAC,OAAO,CAAC,iBAAiB,CAAC,CAAC;gBACrE,CAAC;qBAAM,CAAC;oBACJ,IAAI,CAAC,kBAAkB,CAAC,cAAc,CAAC,CAAC;gBAC5C,CAAC;YACL,CAAC,CAAC;YAEF,MAAM,WAAW,GAAG,CAAC,GAAQ,EAAE,EAAE;gBAC7B,6DAA6D;gBAC7D,MAAM,GAAG,GAAG,kCAAkC,IAAI,CAAC,OAAO,CAAC,GAAG,kDAAkD,CAAC;gBACjH,OAAO,CAAC,KAAK,CAAC,SAAS,GAAG,EAAE,EAAE,GAAG,CAAC,CAAC;gBACnC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC;YACvC,CAAC,CAAC;YAEF,IAAI,OAAO,IAAI,CAAC,EAAE,CAAC,EAAE,KAAK,UAAU,EAAE,CAAC;gBACnC,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;gBAC/B,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC,SAAS,EAAE,aAAa,CAAC,CAAC;gBACrC,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC;gBACjC,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC;YACrC,CAAC;iBAAM,CAAC;gBACJ,IAAI,CAAC,EAAE,CAAC,MAAM,GAAG,UAAU,CAAC;gBAC5B,IAAI,CAAC,EAAE,CAAC,SAAS,GAAG,aAAa,CAAC;gBAClC,IAAI,CAAC,EAAE,CAAC,OAAO,GAAG,WAAW,CAAC;gBAC9B,IAAI,CAAC,EAAE,CAAC,OAAO,GAAG,WAAW,CAAC;YAClC,CAAC;QACL,CAAC;QAAC,OAAO,CAAM,EAAE,CAAC;YACd,OAAO,CAAC,KAAK,CAAC,4CAA4C,IAAI,CAAC,OAAO,CAAC,GAAG,GAAG,EAAE,CAAC,CAAC,CAAC;YAClF,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;QAC1B,CAAC;IACL,CAAC;IAED,WAAW,CAAC,MAAc,EAAE,MAAW;QACnC,MAAM,EAAE,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC;QACzB,MAAM,OAAO,GAAmB;YAC5B,OAAO,EAAE,KAAK;YACd,EAAE;YACF,MAAM;YACN,MAAM;SACT,CAAC;QAEF,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YACnC,MAAM,EAAE,GAAG,IAAI,CAAC,EAAE,CAAC;YACnB,IAAI,CAAC,EAAE,IAAI,EAAE,CAAC,UAAU,KAAK,CAAC,EAAE,CAAC,CAAC,WAAW;gBACzC,MAAM,CAAC,IAAI,KAAK,CAAC,uBAAuB,CAAC,CAAC,CAAC;gBAC3C,OAAO;YACX,CAAC;YACD,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,EAAE,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,CAAC;YAClD,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC;QACrC,CAAC,CAAC,CAAC;IACP,CAAC;IAED,gBAAgB,CAAC,MAAc,EAAE,MAAW;QACxC,MAAM,OAAO,GAAmB;YAC5B,OAAO,EAAE,KAAK;YACd,MAAM;YACN,MAAM;SACT,CAAC;QACF,IAAI,IAAI,CAAC,EAAE,EAAE,UAAU,KAAK,CAAC,EAAE,CAAC;YAC5B,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC;QAC1C,CAAC;IACL,CAAC;IAED,YAAY,CAAC,EAAa,EAAE,MAAW;QACnC,MAAM,OAAO,GAAmB;YAC5B,OAAO,EAAE,KAAK;YACd,EAAE;YACF,MAAM;SACT,CAAC;QACF,IAAI,IAAI,CAAC,EAAE,EAAE,UAAU,KAAK,CAAC,EAAE,CAAC;YAC5B,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC;QAC1C,CAAC;IACL,CAAC;IAEO,aAAa,CAAC,IAAY;QAC9B,IAAI,CAAC;YACD,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YAC7B,MAAM,GAAG,GAAG,oBAAoB,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;YAE5C,kBAAkB;YAClB,IAAI,GAAG,CAAC,EAAE,KAAK,SAAS,IAAI,CAAC,GAAG,CAAC,MAAM,KAAK,SAAS,IAAI,GAAG,CAAC,KAAK,KAAK,SAAS,CAAC,EAAE,CAAC;gBAChF,MAAM,OAAO,GAAG,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;gBACjD,IAAI,OAAO,EAAE,CAAC;oBACV,IAAI,CAAC,eAAe,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;oBACpC,IAAI,GAAG,CAAC,KAAK,EAAE,CAAC;wBACZ,MAAM,QAAQ,GAAG,GAAG,CAAC,KAAK,CAAC,OAAO,IAAI,wBAAwB,CAAC;wBAC/D,MAAM,KAAK,GAAG,IAAI,KAAK,CAAC,QAAQ,CAAC,CAAC;wBACjC,KAAa,CAAC,IAAI,GAAG,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC;wBACpC,KAAa,CAAC,IAAI,GAAG,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC;wBACrC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;oBAC1B,CAAC;yBAAM,CAAC;wBACJ,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;oBAChC,CAAC;gBACL,CAAC;gBACD,OAAO;YACX,CAAC;YAED,8BAA8B;YAC9B,IAAI,GAAG,CAAC,MAAM,EAAE,CAAC;gBACb,IAAI,CAAC,IAAI,CAAC,cAAc,EAAE,GAAG,CAAC,CAAC;gBAC/B,IAAI,CAAC,IAAI,CAAC,UAAU,GAAG,CAAC,MAAM,EAAE,EAAE,GAAG,CAAC,CAAC;YAC3C,CAAC;QACL,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACX,OAAO,CAAC,KAAK,CAAC,gCAAgC,EAAE,GAAG,CAAC,CAAC;QACzD,CAAC;IACL,CAAC;IAED,OAAO;QACH,IAAI,CAAC,OAAO,CAAC,SAAS,GAAG,KAAK,CAAC;QAC/B,IAAI,IAAI,CAAC,EAAE,EAAE,CAAC;YACV,IAAI,CAAC,EAAE,CAAC,OAAO,GAAG,IAAI,CAAC,CAAC,yBAAyB;YACjD,IAAI,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC;QACpB,CAAC;QACD,IAAI,CAAC,eAAe,CAAC,KAAK,EAAE,CAAC;QAC7B,IAAI,CAAC,kBAAkB,CAAC,cAAc,CAAC,CAAC;IAC5C,CAAC;IAEO,kBAAkB,CAAC,KAAmE;QAC1F,IAAI,IAAI,CAAC,eAAe,KAAK,KAAK;YAAE,OAAO;QAC3C,IAAI,CAAC,eAAe,GAAG,KAAK,CAAC;QAC7B,IAAI,CAAC,IAAI,CAAC,kBAAkB,EAAE,KAAK,CAAC,CAAC;IACzC,CAAC;CACJ"}

package/dist/core/AgentChatClient.d.ts

@@ -0,0 +1,75 @@
+import { EventEmitter } from 'events';
+import { ChatMessage, ConnectionState, PendingApproval, HiddenMode } from '../common/types.js';
+export interface AgentChatClientOptions {
+    url: string;
+    model?: string;
+    cwd?: string;
+    diffContextLines?: number;
+    sessionId?: string;
+    replay?: {
+        limit?: number;
+        since?: number;
+        before?: number;
+    };
+}
+export declare class AgentChatClient extends EventEmitter {
+    private transport;
+    private sessionId;
+    private messages;
+    private authUrl;
+    private pendingApproval;
+    private options;
+    private connectionState;
+    private inTurn;
+    private activeAssistantId;
+    private lastFinalizedAssistantId;
+    private timeOverride;
+    private idCounter;
+    private replayNonce;
+    private currentTurnHidden;
+    constructor(options: AgentChatClientOptions);
+    connect(options?: {
+        autoSession?: boolean;
+    }): Promise<void>;
+    private initializeSession;
+    setSessionId(sessionId: string | null): void;
+    getSessionId(): string | null;
+    sendMessage(text: string, options?: {
+        hidden?: HiddenMode;
+    }): Promise<void>;
+    submitAuthCode(code: string): Promise<void>;
+    cancel(): Promise<void>;
+    approveTool(optionId: string): Promise<void>;
+    getMessages(options?: {
+        includeHidden?: boolean;
+    }): ChatMessage[];
+    prependMessages(messages: ChatMessage[]): void;
+    getAuthUrl(): string | null;
+    getPendingApproval(): PendingApproval | null;
+    getConnectionState(): ConnectionState;
+    dispose(): void;
+    private setupHandlers;
+    private handleSessionUpdate;
+    private updateAssistantMessageNormalized;
+    private handleToolCall;
+    private handleToolUpdate;
+    private getOrCreateAssistantMessage;
+    private handleAuthUrl;
+    private handlePermissionRequest;
+    disconnect(): void;
+    private shouldEmitUser;
+    private shouldEmitAssistant;
+    private shouldAutoRejectApproval;
+    private resolveApproval;
+    private parseToolTitle;
+    private createToolCallFromPermission;
+    private extractDiffData;
+    private normalizeDiffContextLines;
+    private now;
+    private handleReplayPrompt;
+    private makeId;
+    private buildUrlWithReplay;
+    static fetchReplay(baseUrl: string, replay: AgentChatClientOptions['replay'], options?: {
+        idleMs?: number;
+    }): Promise<ChatMessage[]>;
+}