@optima-chat/agentic-sdk 0.1.0

package/dist/client/conversation-api.d.ts

@@ -0,0 +1,23 @@
+import type { Conversation, Message } from '../types.js';
+export type AuthenticatedFetchFn = (url: string, init?: RequestInit) => Promise<Response>;
+/**
+ * REST API client for conversation CRUD and message history.
+ *
+ * Gateway REST responses use snake_case and some types do not match the
+ * agentic-sdk camelCase public types. This client performs all normalization
+ * internally so callers always see the SDK-native shapes.
+ */
+export declare class ConversationAPI {
+    private readonly authenticatedFetch;
+    private readonly httpBase;
+    constructor(gatewayUrl: string, authenticatedFetch: AuthenticatedFetchFn);
+    listConversations(): Promise<Conversation[]>;
+    createConversation(title?: string): Promise<Conversation>;
+    deleteConversation(conversationId: string): Promise<void>;
+    renameConversation(conversationId: string, title: string): Promise<void>;
+    getMessages(conversationId: string, options?: {
+        skip?: number;
+        take?: number;
+    }): Promise<Message[]>;
+}
+//# sourceMappingURL=conversation-api.d.ts.map

package/dist/client/conversation-api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"conversation-api.d.ts","sourceRoot":"","sources":["../../src/client/conversation-api.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,OAAO,EAAuB,MAAM,aAAa,CAAC;AAE9E,MAAM,MAAM,oBAAoB,GAAG,CACjC,GAAG,EAAE,MAAM,EACX,IAAI,CAAC,EAAE,WAAW,KACf,OAAO,CAAC,QAAQ,CAAC,CAAC;AAEvB;;;;;;GAMG;AACH,qBAAa,eAAe;IAKxB,OAAO,CAAC,QAAQ,CAAC,kBAAkB;IAJrC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;gBAGhC,UAAU,EAAE,MAAM,EACD,kBAAkB,EAAE,oBAAoB;IAOrD,iBAAiB,IAAI,OAAO,CAAC,YAAY,EAAE,CAAC;IAU5C,kBAAkB,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;IAczD,kBAAkB,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAQzD,kBAAkB,CACtB,cAAc,EAAE,MAAM,EACtB,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,IAAI,CAAC;IAYV,WAAW,CACf,cAAc,EAAE,MAAM,EACtB,OAAO,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,GACzC,OAAO,CAAC,OAAO,EAAE,CAAC;CAYtB"}

package/dist/client/conversation-api.js

@@ -0,0 +1,207 @@
+/**
+ * REST API client for conversation CRUD and message history.
+ *
+ * Gateway REST responses use snake_case and some types do not match the
+ * agentic-sdk camelCase public types. This client performs all normalization
+ * internally so callers always see the SDK-native shapes.
+ */
+export class ConversationAPI {
+    authenticatedFetch;
+    httpBase;
+    constructor(gatewayUrl, authenticatedFetch) {
+        this.authenticatedFetch = authenticatedFetch;
+        // Derive REST base URL from the WebSocket gateway URL.
+        // e.g. wss://host/ws -> https://host
+        this.httpBase = deriveHttpBase(gatewayUrl);
+    }
+    async listConversations() {
+        const res = await this.authenticatedFetch(`${this.httpBase}/api/conversations`);
+        if (!res.ok)
+            throw await toChatError(res, 'listConversations');
+        const raw = (await res.json());
+        const list = extractList(raw);
+        return list.map(mapConversation);
+    }
+    async createConversation(title) {
+        const res = await this.authenticatedFetch(`${this.httpBase}/api/conversations`, {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json' },
+            body: JSON.stringify(title ? { title } : {}),
+        });
+        if (!res.ok)
+            throw await toChatError(res, 'createConversation');
+        const raw = (await res.json());
+        return mapConversation(raw);
+    }
+    async deleteConversation(conversationId) {
+        const res = await this.authenticatedFetch(`${this.httpBase}/api/conversations/${encodeURIComponent(conversationId)}`, { method: 'DELETE' });
+        if (!res.ok)
+            throw await toChatError(res, 'deleteConversation');
+    }
+    async renameConversation(conversationId, title) {
+        const res = await this.authenticatedFetch(`${this.httpBase}/api/conversations/${encodeURIComponent(conversationId)}`, {
+            method: 'PATCH',
+            headers: { 'Content-Type': 'application/json' },
+            body: JSON.stringify({ title }),
+        });
+        if (!res.ok)
+            throw await toChatError(res, 'renameConversation');
+    }
+    async getMessages(conversationId, options) {
+        const params = new URLSearchParams();
+        if (options?.skip !== undefined)
+            params.set('skip', String(options.skip));
+        if (options?.take !== undefined)
+            params.set('take', String(options.take));
+        const qs = params.toString();
+        const url = `${this.httpBase}/api/conversations/${encodeURIComponent(conversationId)}/messages${qs ? `?${qs}` : ''}`;
+        const res = await this.authenticatedFetch(url);
+        if (!res.ok)
+            throw await toChatError(res, 'getMessages');
+        const raw = (await res.json());
+        const list = extractList(raw);
+        return list.map((item, index) => mapMessage(item, conversationId, index));
+    }
+}
+// ---- helpers ----
+function deriveHttpBase(gatewayUrl) {
+    try {
+        const u = new URL(gatewayUrl);
+        u.protocol = u.protocol === 'wss:' ? 'https:' : u.protocol === 'ws:' ? 'http:' : u.protocol;
+        // Strip path entirely — REST base is scheme://host[:port]
+        u.pathname = '/';
+        u.search = '';
+        u.hash = '';
+        const asString = u.toString();
+        return asString.endsWith('/') ? asString.slice(0, -1) : asString;
+    }
+    catch {
+        return gatewayUrl;
+    }
+}
+function extractList(raw) {
+    if (Array.isArray(raw))
+        return raw;
+    if (raw && typeof raw === 'object') {
+        const obj = raw;
+        if (Array.isArray(obj.items))
+            return obj.items;
+        if (Array.isArray(obj.data))
+            return obj.data;
+        if (Array.isArray(obj.conversations))
+            return obj.conversations;
+        if (Array.isArray(obj.messages))
+            return obj.messages;
+    }
+    return [];
+}
+function mapConversation(raw) {
+    const r = (raw ?? {});
+    const id = r.id ??
+        r.conversation_id ??
+        '';
+    const title = r.title ?? '';
+    const lastRaw = r.lastMessageAt ??
+        r.last_message_at;
+    const createdRaw = r.createdAt ??
+        r.created_at;
+    const messageCount = r.messageCount ??
+        r.message_count ??
+        0;
+    return {
+        id,
+        title,
+        lastMessageAt: toEpochMs(lastRaw),
+        messageCount,
+        createdAt: toEpochMs(createdRaw),
+    };
+}
+function toEpochMs(v) {
+    if (v === undefined || v === null)
+        return 0;
+    if (typeof v === 'number')
+        return v;
+    const t = new Date(v).getTime();
+    return Number.isFinite(t) ? t : 0;
+}
+function mapMessage(raw, conversationId, index) {
+    const r = (raw ?? {});
+    const role = r.role ?? 'assistant';
+    const content = typeof r.content === 'string' ? r.content : '';
+    const rawToolCalls = r.toolCalls ?? r.tool_calls;
+    const toolCalls = Array.isArray(rawToolCalls)
+        ? rawToolCalls.map(mapToolCall)
+        : [];
+    const id = r.id ??
+        `${conversationId}-${index}-${Date.now()}`;
+    return {
+        id,
+        conversationId,
+        role,
+        content,
+        toolCalls,
+        status: 'complete',
+        createdAt: toEpochMs(r.createdAt ??
+            r.created_at),
+    };
+}
+function mapToolCall(raw) {
+    const r = (raw ?? {});
+    // SG format: { id, function: { name, arguments } }
+    const fn = r.function;
+    return {
+        id: r.id ?? crypto.randomUUID(),
+        toolName: r.toolName ??
+            r.tool_name ??
+            fn?.name ??
+            '',
+        arguments: r.arguments ?? fn?.arguments ?? '{}',
+        status: 'completed',
+        ...(r.result !== undefined ? { result: r.result } : {}),
+    };
+}
+async function toChatError(res, opName) {
+    let detail;
+    try {
+        detail = await res.clone().json();
+    }
+    catch {
+        try {
+            detail = await res.clone().text();
+        }
+        catch {
+            /* noop */
+        }
+    }
+    if (res.status === 401) {
+        return {
+            code: 'auth_expired',
+            message: `${opName}: authentication expired`,
+            retryable: false,
+            details: detail,
+        };
+    }
+    if (res.status === 404) {
+        return {
+            code: 'conversation_not_found',
+            message: `${opName}: conversation not found`,
+            retryable: false,
+            details: detail,
+        };
+    }
+    if (res.status >= 500) {
+        return {
+            code: 'server_error',
+            message: `${opName}: server error (${res.status})`,
+            retryable: true,
+            details: detail,
+        };
+    }
+    return {
+        code: 'server_error',
+        message: `${opName}: request failed (${res.status})`,
+        retryable: false,
+        details: detail,
+    };
+}
+//# sourceMappingURL=conversation-api.js.map

package/dist/client/conversation-api.js.map

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

package/dist/client/error-mapper.d.ts

@@ -0,0 +1,5 @@
+import type { ErrorInfo, BillingError } from '@optima-chat/gateway-protocol';
+import type { ChatError } from '../types.js';
+export declare function mapGatewayError(error: ErrorInfo): ChatError;
+export declare function mapBillingError(billing: BillingError): ChatError;
+//# sourceMappingURL=error-mapper.d.ts.map

package/dist/client/error-mapper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-mapper.d.ts","sourceRoot":"","sources":["../../src/client/error-mapper.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAC7E,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAE7C,wBAAgB,eAAe,CAAC,KAAK,EAAE,SAAS,GAAG,SAAS,CAS3D;AAED,wBAAgB,eAAe,CAAC,OAAO,EAAE,YAAY,GAAG,SAAS,CAOhE"}

package/dist/client/error-mapper.js

@@ -0,0 +1,19 @@
+export function mapGatewayError(error) {
+    return {
+        code: error.code || 'server_error',
+        message: error.message,
+        retryable: error.retryable,
+        details: error.activeConversationId
+            ? { activeConversationId: error.activeConversationId }
+            : undefined,
+    };
+}
+export function mapBillingError(billing) {
+    return {
+        code: billing.reason || 'insufficient_credits',
+        message: billing.message,
+        retryable: false,
+        details: billing,
+    };
+}
+//# sourceMappingURL=error-mapper.js.map

package/dist/client/error-mapper.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-mapper.js","sourceRoot":"","sources":["../../src/client/error-mapper.ts"],"names":[],"mappings":"AAGA,MAAM,UAAU,eAAe,CAAC,KAAgB;IAC9C,OAAO;QACL,IAAI,EAAE,KAAK,CAAC,IAAI,IAAI,cAAc;QAClC,OAAO,EAAE,KAAK,CAAC,OAAO;QACtB,SAAS,EAAE,KAAK,CAAC,SAAS;QAC1B,OAAO,EAAE,KAAK,CAAC,oBAAoB;YACjC,CAAC,CAAC,EAAE,oBAAoB,EAAE,KAAK,CAAC,oBAAoB,EAAE;YACtD,CAAC,CAAC,SAAS;KACd,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,OAAqB;IACnD,OAAO;QACL,IAAI,EAAE,OAAO,CAAC,MAAM,IAAI,sBAAsB;QAC9C,OAAO,EAAE,OAAO,CAAC,OAAO;QACxB,SAAS,EAAE,KAAK;QAChB,OAAO,EAAE,OAAO;KACjB,CAAC;AACJ,CAAC"}

package/dist/client/event-parser.d.ts

@@ -0,0 +1,79 @@
+import type { ServerEvent, FinishInfo, Question } from '@optima-chat/gateway-protocol';
+import type { Conversation, ToolCall, ChatError, ApprovalRequestWithId } from '../types.js';
+/**
+ * Output of parseServerEvent — a declarative action (or list of actions) for
+ * the caller to apply to the store + forward to consumer callbacks. Returning
+ * `null` means the event is intentionally ignored.
+ */
+export type ParsedAction = {
+    type: 'setSessionInfo';
+    sessionId: string;
+    userId: string;
+    provider?: string;
+    model?: string;
+} | {
+    type: 'setConversations';
+    conversations: Conversation[];
+} | {
+    type: 'mergeConversations';
+    conversations: Conversation[];
+} | {
+    type: 'recovery';
+    conversationId: string;
+} | {
+    type: 'createAssistantMessage';
+    conversationId: string;
+} | {
+    type: 'appendContent';
+    conversationId: string;
+    text: string;
+} | {
+    type: 'addToolCall';
+    conversationId: string;
+    toolCall: ToolCall;
+} | {
+    type: 'updateToolCall';
+    conversationId: string;
+    toolCallId: string;
+    updates: Partial<ToolCall>;
+} | {
+    type: 'finishMessage';
+    conversationId: string;
+    finish: FinishInfo;
+} | {
+    type: 'setError';
+    error: ChatError;
+    conversationId?: string;
+} | {
+    type: 'setPendingQuestion';
+    requestId: string;
+    conversationId: string;
+    questions: Question[];
+} | {
+    type: 'addPendingApproval';
+    approval: ApprovalRequestWithId;
+} | {
+    type: 'updateConversationTitle';
+    conversationId: string;
+    title: string;
+} | {
+    type: 'updateConversationActivity';
+    conversationId: string;
+    lastMessageAt: number;
+} | {
+    type: 'notification';
+    notificationType: 'info' | 'warning' | 'error';
+    message: string;
+    code?: string;
+} | {
+    type: 'tokenRefresh';
+} | {
+    type: 'connectionStateChange';
+    state: 'reconnecting' | 'connected';
+};
+/**
+ * Parse a ServerEvent into zero or more declarative store actions.
+ * Returns null for events that are intentionally ignored.
+ */
+export declare function parseServerEvent(event: ServerEvent, activeConversationId: string | null): ParsedAction | ParsedAction[] | null;
+//# sourceMappingURL=event-parser.d.ts.map

package/dist/client/event-parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-parser.d.ts","sourceRoot":"","sources":["../../src/client/event-parser.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,WAAW,EACX,UAAU,EACV,QAAQ,EACT,MAAM,+BAA+B,CAAC;AACvC,OAAO,KAAK,EACV,YAAY,EACZ,QAAQ,EACR,SAAS,EACT,qBAAqB,EACtB,MAAM,aAAa,CAAC;AAGrB;;;;GAIG;AACH,MAAM,MAAM,YAAY,GACpB;IACE,IAAI,EAAE,gBAAgB,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,GACD;IAAE,IAAI,EAAE,kBAAkB,CAAC;IAAC,aAAa,EAAE,YAAY,EAAE,CAAA;CAAE,GAC3D;IAAE,IAAI,EAAE,oBAAoB,CAAC;IAAC,aAAa,EAAE,YAAY,EAAE,CAAA;CAAE,GAC7D;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,cAAc,EAAE,MAAM,CAAA;CAAE,GAC5C;IAAE,IAAI,EAAE,wBAAwB,CAAC;IAAC,cAAc,EAAE,MAAM,CAAA;CAAE,GAC1D;IAAE,IAAI,EAAE,eAAe,CAAC;IAAC,cAAc,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAC/D;IAAE,IAAI,EAAE,aAAa,CAAC;IAAC,cAAc,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,QAAQ,CAAA;CAAE,GACnE;IACE,IAAI,EAAE,gBAAgB,CAAC;IACvB,cAAc,EAAE,MAAM,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC;CAC5B,GACD;IACE,IAAI,EAAE,eAAe,CAAC;IACtB,cAAc,EAAE,MAAM,CAAC;IACvB,MAAM,EAAE,UAAU,CAAC;CACpB,GACD;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,KAAK,EAAE,SAAS,CAAC;IAAC,cAAc,CAAC,EAAE,MAAM,CAAA;CAAE,GAC/D;IACE,IAAI,EAAE,oBAAoB,CAAC;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,EAAE,QAAQ,EAAE,CAAC;CACvB,GACD;IAAE,IAAI,EAAE,oBAAoB,CAAC;IAAC,QAAQ,EAAE,qBAAqB,CAAA;CAAE,GAC/D;IACE,IAAI,EAAE,yBAAyB,CAAC;IAChC,cAAc,EAAE,MAAM,CAAC;IACvB,KAAK,EAAE,MAAM,CAAC;CACf,GACD;IACE,IAAI,EAAE,4BAA4B,CAAC;IACnC,cAAc,EAAE,MAAM,CAAC;IACvB,aAAa,EAAE,MAAM,CAAC;CACvB,GACD;IACE,IAAI,EAAE,cAAc,CAAC;IACrB,gBAAgB,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAAC;IAC/C,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,GACD;IAAE,IAAI,EAAE,cAAc,CAAA;CAAE,GACxB;IAAE,IAAI,EAAE,uBAAuB,CAAC;IAAC,KAAK,EAAE,cAAc,GAAG,WAAW,CAAA;CAAE,CAAC;AAO3E;;;GAGG;AACH,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,WAAW,EAClB,oBAAoB,EAAE,MAAM,GAAG,IAAI,GAClC,YAAY,GAAG,YAAY,EAAE,GAAG,IAAI,CAuOtC"}

package/dist/client/event-parser.js

@@ -0,0 +1,219 @@
+import { mapGatewayError, mapBillingError } from './error-mapper.js';
+function isoToEpoch(value) {
+    const ts = new Date(value).getTime();
+    return Number.isFinite(ts) ? ts : 0;
+}
+/**
+ * Parse a ServerEvent into zero or more declarative store actions.
+ * Returns null for events that are intentionally ignored.
+ */
+export function parseServerEvent(event, activeConversationId) {
+    switch (event.type) {
+        case 'session_ready': {
+            const actions = [];
+            const session = event.session;
+            const session_info = {
+                type: 'setSessionInfo',
+                sessionId: session.sessionId,
+                userId: session.userId,
+            };
+            if (session.provider !== undefined) {
+                session_info.provider = session.provider;
+            }
+            if (session.model !== undefined) {
+                session_info.model = session.model;
+            }
+            actions.push(session_info);
+            const conversations = (session.conversations ?? []).map((c) => ({
+                id: c.id,
+                title: c.title,
+                lastMessageAt: isoToEpoch(c.lastMessageAt),
+                messageCount: c.messageCount,
+                // session_ready's ConversationSummary doesn't carry createdAt.
+                createdAt: 0,
+            }));
+            actions.push({ type: 'setConversations', conversations });
+            if (session.activeConversation) {
+                actions.push({
+                    type: 'recovery',
+                    conversationId: session.activeConversation.conversationId,
+                });
+            }
+            return actions;
+        }
+        case 'text_delta': {
+            return [
+                { type: 'appendContent', conversationId: event.conversation_id, text: event.delta.text },
+            ];
+        }
+        case 'content': {
+            return [
+                { type: 'appendContent', conversationId: event.conversation_id, text: event.content.text },
+            ];
+        }
+        case 'tool_call': {
+            const tc = event.tool_call;
+            const toolCall = {
+                id: tc.id,
+                toolName: tc.name,
+                arguments: tc.arguments,
+                status: 'executing',
+            };
+            return { type: 'addToolCall', conversationId: event.conversation_id, toolCall };
+        }
+        case 'tool_result': {
+            const tr = event.tool_result;
+            const updates = {
+                result: tr.output,
+                status: tr.error ? 'error' : 'completed',
+            };
+            if (tr.error !== undefined)
+                updates.error = tr.error;
+            if (tr.content_blocks !== undefined) {
+                updates.resultContentBlocks = tr.content_blocks;
+            }
+            return {
+                type: 'updateToolCall',
+                conversationId: event.conversation_id,
+                toolCallId: tr.tool_call_id,
+                updates,
+            };
+        }
+        case 'finish': {
+            return {
+                type: 'finishMessage',
+                conversationId: event.conversation_id,
+                finish: event.finish,
+            };
+        }
+        case 'error': {
+            return {
+                type: 'setError',
+                error: mapGatewayError(event.error),
+            };
+        }
+        case 'billing_error': {
+            const action = {
+                type: 'setError',
+                error: mapBillingError(event.billing),
+            };
+            const convId = event.conversation_id ?? activeConversationId ?? undefined;
+            if (convId) {
+                action.conversationId = convId;
+            }
+            return action;
+        }
+        case 'ask_question': {
+            const conversationId = event.conversation_id ?? activeConversationId ?? '';
+            return {
+                type: 'setPendingQuestion',
+                requestId: event.request_id,
+                conversationId,
+                questions: event.questions,
+            };
+        }
+        case 'approval_request': {
+            const conversationId = event.conversation_id ?? activeConversationId ?? '';
+            return {
+                type: 'addPendingApproval',
+                approval: {
+                    requestId: event.approval.requestId,
+                    conversationId,
+                    toolName: event.approval.toolName,
+                    args: event.approval.args,
+                    ...(event.approval.description !== undefined
+                        ? { description: event.approval.description }
+                        : {}),
+                    ...(event.approval.risk !== undefined ? { risk: event.approval.risk } : {}),
+                },
+            };
+        }
+        case 'conversation_title_updated': {
+            return {
+                type: 'updateConversationTitle',
+                conversationId: event.conversation_id,
+                title: event.title,
+            };
+        }
+        case 'conversation_update': {
+            return {
+                type: 'updateConversationActivity',
+                conversationId: event.update.conversation_id,
+                lastMessageAt: isoToEpoch(event.update.last_message_at),
+            };
+        }
+        case 'restore_conversations': {
+            const conversations = event.conversations.map((c) => ({
+                id: c.conversation_id,
+                title: c.title,
+                lastMessageAt: isoToEpoch(c.last_message_at),
+                messageCount: 0,
+                createdAt: isoToEpoch(c.created_at),
+            }));
+            return { type: 'mergeConversations', conversations };
+        }
+        case 'info': {
+            const action = {
+                type: 'notification',
+                notificationType: 'info',
+                message: event.info.message,
+            };
+            if (event.info.code !== undefined) {
+                action.code = event.info.code;
+            }
+            return action;
+        }
+        case 'warning': {
+            const action = {
+                type: 'notification',
+                notificationType: 'warning',
+                message: event.message,
+                code: event.code,
+            };
+            return action;
+        }
+        case 'session_recovering':
+            return [
+                { type: 'connectionStateChange', state: 'reconnecting' },
+                {
+                    type: 'notification',
+                    notificationType: 'info',
+                    message: event.info.message,
+                    ...(event.info.code !== undefined ? { code: event.info.code } : {}),
+                },
+            ];
+        case 'session_recovered':
+            return [
+                { type: 'connectionStateChange', state: 'connected' },
+                {
+                    type: 'notification',
+                    notificationType: 'info',
+                    message: event.info.message,
+                    ...(event.info.code !== undefined ? { code: event.info.code } : {}),
+                },
+            ];
+        case 'token_refresh_needed':
+            return { type: 'tokenRefresh' };
+        case 'restore_failed':
+            return {
+                type: 'notification',
+                notificationType: 'error',
+                message: event.reason ?? 'Conversation restore failed',
+                code: 'restore_failed',
+            };
+        // Intentionally ignored — consumers can still observe via onRawEvent.
+        case 'thinking':
+        case 'pong':
+        case 'init':
+        case 'ready':
+        case 'progress':
+        case 'restore_started':
+        case 'restore_complete':
+        case 'skills_synced':
+        case 'skills_sync_error':
+            return null;
+        default:
+            return null;
+    }
+}
+//# sourceMappingURL=event-parser.js.map

package/dist/client/event-parser.js.map

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

package/dist/client/gateway-client.d.ts

@@ -0,0 +1,45 @@
+import type { ServerEvent, ClientEvent } from '@optima-chat/gateway-protocol';
+import type { ChatError, ConnectionState } from '../types.js';
+export interface GatewayClientOptions {
+    gatewayUrl: string;
+    tokenProvider: () => Promise<string> | string;
+    onEvent: (event: ServerEvent) => void;
+    onConnectionStateChange: (state: ConnectionState) => void;
+    onError: (error: ChatError) => void;
+    onAuthError: (error: ChatError) => void;
+    onBeforeSend?: (event: ClientEvent) => ClientEvent | null;
+    reconnectOptions?: {
+        maxRetries?: number;
+        baseDelay?: number;
+        maxDelay?: number;
+    };
+    heartbeatInterval?: number;
+}
+/**
+ * WebSocket client for the Optima gateway. Handles connect/reconnect,
+ * heartbeat, token-refresh signalling, and event dispatch. Does not own any
+ * state — everything flows out via the callbacks.
+ */
+export declare class GatewayClient {
+    private readonly options;
+    private ws;
+    private heartbeatTimer;
+    private reconnectTimer;
+    private reconnectAttempt;
+    private intentionalDisconnect;
+    private readonly reconnectConfig;
+    private readonly heartbeatInterval;
+    constructor(options: GatewayClientOptions);
+    connect(): Promise<void>;
+    disconnect(): void;
+    /** Returns true if the event was dispatched, false otherwise. */
+    send(event: ClientEvent): boolean;
+    /** Exposed so ChatProvider can trigger token refresh manually if needed. */
+    handleTokenRefresh(): Promise<void>;
+    private openSocket;
+    private handleMessage;
+    private scheduleReconnect;
+    private startHeartbeat;
+    private stopHeartbeat;
+}
+//# sourceMappingURL=gateway-client.d.ts.map

package/dist/client/gateway-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gateway-client.d.ts","sourceRoot":"","sources":["../../src/client/gateway-client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,WAAW,EACX,WAAW,EACZ,MAAM,+BAA+B,CAAC;AACvC,OAAO,KAAK,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAE9D,MAAM,WAAW,oBAAoB;IACnC,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,GAAG,MAAM,CAAC;IAC9C,OAAO,EAAE,CAAC,KAAK,EAAE,WAAW,KAAK,IAAI,CAAC;IACtC,uBAAuB,EAAE,CAAC,KAAK,EAAE,eAAe,KAAK,IAAI,CAAC;IAC1D,OAAO,EAAE,CAAC,KAAK,EAAE,SAAS,KAAK,IAAI,CAAC;IACpC,WAAW,EAAE,CAAC,KAAK,EAAE,SAAS,KAAK,IAAI,CAAC;IACxC,YAAY,CAAC,EAAE,CAAC,KAAK,EAAE,WAAW,KAAK,WAAW,GAAG,IAAI,CAAC;IAC1D,gBAAgB,CAAC,EAAE;QACjB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;KACnB,CAAC;IACF,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAQD;;;;GAIG;AACH,qBAAa,aAAa;IASZ,OAAO,CAAC,QAAQ,CAAC,OAAO;IARpC,OAAO,CAAC,EAAE,CAA0B;IACpC,OAAO,CAAC,cAAc,CAA+C;IACrE,OAAO,CAAC,cAAc,CAA8C;IACpE,OAAO,CAAC,gBAAgB,CAAK;IAC7B,OAAO,CAAC,qBAAqB,CAAS;IACtC,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAkB;IAClD,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAS;gBAEd,OAAO,EAAE,oBAAoB;IASpD,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAM9B,UAAU,IAAI,IAAI;IAkBlB,iEAAiE;IACjE,IAAI,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO;IAWjC,4EAA4E;IACtE,kBAAkB,IAAI,OAAO,CAAC,IAAI,CAAC;YAqB3B,UAAU;IAqDxB,OAAO,CAAC,aAAa;IAiBrB,OAAO,CAAC,iBAAiB;IAezB,OAAO,CAAC,cAAc;IAStB,OAAO,CAAC,aAAa;CAMtB"}