@sogni-ai/expo-client 1.0.0-alpha.10

package/dist/cjs/ApiClient/WebSocketClient/wireTypes.d.ts

@@ -0,0 +1,161 @@
+/**
+ * Wire-level message shapes as the sogni-socket server sends them.
+ * These are NOT exposed to consumers. They are translated into clean public
+ * types by `normalize.ts`.
+ *
+ * Authoritative source: ../sogni-socket/controllers/jobsController.js and
+ * ../sogni-socket/controllers/websocketsController.js.
+ */
+/** Envelope wrapping all socket messages in both directions. */
+export interface RawSocketEnvelope {
+    type: string;
+    /** base64-encoded JSON.stringify(payload) */
+    data: string;
+}
+/** `authenticated` event — sent right after the server upgrades a connection. */
+export interface RawAuthenticated {
+    id: string;
+    clientType: string;
+    username: string;
+    address: string;
+    SID: number;
+    clientSID: number;
+    addressSID: number;
+    balanceVersion?: 1 | 2;
+    /** v1: BigNumber/string; v2: { sogni, spark } */
+    tokens: RawBalanceV1Tokens | RawBalanceV2Tokens;
+    activeProjects: string[];
+    unclaimedCompletedProjects: string[];
+    isMainnet: boolean;
+    accountWasMigrated: boolean;
+    hasUnclaimedAirdrop: boolean;
+    firstLoginAfterMigration: boolean;
+}
+export interface RawBalanceV1Tokens {
+    settled: string;
+    credit: string;
+    debit: string;
+    net: string;
+}
+export interface RawBalanceV2Tokens {
+    sogni: RawBalanceV1Tokens & {
+        premiumCredit?: string;
+    };
+    spark: RawBalanceV1Tokens & {
+        premiumCredit?: string;
+    };
+}
+/** `balanceUpdate` event — fired when the user's balance changes. */
+export type RawBalanceUpdate = RawBalanceV1Tokens | RawBalanceV2Tokens;
+/** `changeNetwork` event — confirms a network switch. */
+export interface RawChangeNetwork {
+    network: 'fast' | 'relaxed';
+}
+/** `toastMessage` event — server-initiated UI message. */
+export interface RawToastMessage {
+    type: 'info' | 'success' | 'warning' | 'error';
+    message: string;
+    autoClose?: number;
+    stickyID?: string;
+}
+/** `jobState` event — composite. `type` field carries the actual sub-state. */
+export interface RawJobState {
+    jobID: string;
+    imgID?: string;
+    type: 'jobStarted' | 'initiatingModel' | 'jobCompleted';
+    workerName?: string;
+    queuePosition?: number;
+}
+/** `jobProgress` event — fine-grained step/stepCount progress. */
+export interface RawJobProgress {
+    jobID: string;
+    imgID: string;
+    step: number;
+    stepCount: number;
+    /** Optional preview image bytes — ignored in this SDK. */
+    currentImages?: unknown[];
+}
+/**
+ * `jobResult` event — terminal result for one job in a project.
+ * Note that `userCanceled` and `triggeredNSFWFilter` flags signal failure paths
+ * even though the message type is "result". Normalize splits these out.
+ */
+export interface RawJobResult {
+    jobID: string;
+    imgID: string;
+    lastSeed: number;
+    userCanceled: boolean;
+    triggeredNSFWFilter: boolean;
+    performedStepCount: number;
+    interval?: number;
+    itsPerSecond?: number;
+    timings?: Record<string, number>;
+}
+/** `jobError` event. */
+export interface RawJobError {
+    jobID: string;
+    imgID?: string;
+    error: string;
+    error_message: string;
+    isFromWorker: boolean;
+}
+/** `jobETA` event — server's running estimate of remaining seconds. */
+export interface RawJobETA {
+    jobID: string;
+    imgID: string;
+    etaSeconds: number;
+}
+/** `artistCancelConfirmation` — sent after the artist requests a project cancel. */
+export interface RawArtistCancelConfirmation {
+    jobID: string;
+    didCancel: boolean;
+    error_message?: string;
+}
+export interface RawToolCallDelta {
+    index: number;
+    id?: string;
+    type?: 'function';
+    function?: {
+        name?: string;
+        arguments?: string;
+    };
+}
+/** `jobTokens` — streaming chunk from an LLM completion. */
+export interface RawJobTokens {
+    jobID: string;
+    content?: string;
+    role?: string;
+    finishReason?: string | null;
+    usage?: {
+        prompt_tokens: number;
+        completion_tokens: number;
+        total_tokens?: number;
+    };
+    tool_calls?: RawToolCallDelta[];
+}
+/** `llmJobResult` — terminal result for an LLM completion. */
+export interface RawLLMJobResult {
+    jobID: string;
+    usage: {
+        prompt_tokens: number;
+        completion_tokens: number;
+        total_tokens?: number;
+    };
+    timeTaken: number;
+    workerName?: string;
+    cost?: unknown;
+}
+/** `llmJobError` — terminal error for an LLM completion. */
+export interface RawLLMJobError {
+    jobID: string;
+    error: string;
+    error_message: string;
+    workerName?: string;
+}
+/** `swarmLLMModels` — available LLM models on the active network. */
+export type RawSwarmLLMModels = Record<string, number | {
+    workers: number;
+    displayName?: string;
+    contextLength?: number;
+}>;
+//# sourceMappingURL=wireTypes.d.ts.map

package/dist/cjs/ApiClient/WebSocketClient/wireTypes.d.ts.map

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

package/dist/cjs/ApiClient/WebSocketClient/wireTypes.js

@@ -0,0 +1,11 @@
+"use strict";
+/**
+ * Wire-level message shapes as the sogni-socket server sends them.
+ * These are NOT exposed to consumers. They are translated into clean public
+ * types by `normalize.ts`.
+ *
+ * Authoritative source: ../sogni-socket/controllers/jobsController.js and
+ * ../sogni-socket/controllers/websocketsController.js.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=wireTypes.js.map

package/dist/cjs/ApiClient/WebSocketClient/wireTypes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wireTypes.js","sourceRoot":"","sources":["../../../../src/ApiClient/WebSocketClient/wireTypes.ts"],"names":[],"mappings":";AAAA;;;;;;;GAOG"}

package/dist/cjs/ApiClient/index.d.ts

@@ -0,0 +1,60 @@
+import RestClient from '../lib/RestClient';
+import TypedEventEmitter from '../lib/TypedEventEmitter';
+import { JSONValue } from '../types/json';
+import { Logger } from '../lib/DefaultLogger';
+import { AuthManager, AuthStorage } from '../lib/AuthManager';
+import WebSocketClient from './WebSocketClient';
+import { SupernetType } from './WebSocketClient/types';
+import { ConnectedEvent, DisconnectedEvent } from './WebSocketClient/events';
+export interface ApiResponse<D = JSONValue> {
+    status: 'success';
+    data: D;
+}
+export interface ApiErrorResponse {
+    status: 'error';
+    message: string;
+    errorCode: number;
+}
+export declare class ApiError extends Error {
+    status: number;
+    payload: ApiErrorResponse;
+    constructor(status: number, payload: ApiErrorResponse);
+}
+interface ApiClientEvents {
+    authUpdated: boolean;
+    connected: ConnectedEvent;
+    disconnected: DisconnectedEvent;
+}
+export interface ApiClientOptions {
+    baseUrl: string;
+    socketUrl: string;
+    appId: string;
+    appSource?: string;
+    networkType: SupernetType;
+    logger: Logger;
+    authType: 'token' | 'apiKey';
+    authStorage?: AuthStorage;
+    disableSocket?: boolean;
+}
+declare class ApiClient extends TypedEventEmitter<ApiClientEvents> {
+    readonly appId: string;
+    readonly appSource?: string;
+    readonly logger: Logger;
+    private _rest;
+    private _socketRest;
+    private _auth;
+    private _socket;
+    private _disableSocket;
+    constructor({ baseUrl, socketUrl, appId, appSource, networkType, authType, logger, authStorage, disableSocket }: ApiClientOptions);
+    get isAuthenticated(): boolean;
+    get auth(): AuthManager;
+    get rest(): RestClient;
+    /** REST client bound to the socket server URL (used for model lists, image upload/download URLs, etc.). */
+    get socketRest(): RestClient;
+    get socket(): WebSocketClient;
+    get socketEnabled(): boolean;
+    private _handleAuthUpdated;
+    dispose(): void;
+}
+export default ApiClient;
+//# sourceMappingURL=index.d.ts.map

package/dist/cjs/ApiClient/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/ApiClient/index.ts"],"names":[],"mappings":"AAAA,OAAO,UAAU,MAAM,mBAAmB,CAAC;AAC3C,OAAO,iBAAiB,MAAM,0BAA0B,CAAC;AACzD,OAAO,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAC1C,OAAO,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAC9C,OAAO,EAAqB,WAAW,EAAE,WAAW,EAAoB,MAAM,oBAAoB,CAAC;AACnG,OAAO,eAAe,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AACvD,OAAO,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAE7E,MAAM,WAAW,WAAW,CAAC,CAAC,GAAG,SAAS;IACxC,MAAM,EAAE,SAAS,CAAC;IAClB,IAAI,EAAE,CAAC,CAAC;CACT;AAED,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,OAAO,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,qBAAa,QAAS,SAAQ,KAAK;IACjC,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,gBAAgB,CAAC;gBACd,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,gBAAgB;CAKtD;AAED,UAAU,eAAe;IACvB,WAAW,EAAE,OAAO,CAAC;IACrB,SAAS,EAAE,cAAc,CAAC;IAC1B,YAAY,EAAE,iBAAiB,CAAC;CACjC;AAED,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,YAAY,CAAC;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,OAAO,GAAG,QAAQ,CAAC;IAC7B,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAED,cAAM,SAAU,SAAQ,iBAAiB,CAAC,eAAe,CAAC;IACxD,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,OAAO,CAAC,KAAK,CAAa;IAC1B,OAAO,CAAC,WAAW,CAAa;IAChC,OAAO,CAAC,KAAK,CAAc;IAC3B,OAAO,CAAC,OAAO,CAAkB;IACjC,OAAO,CAAC,cAAc,CAAU;gBAEpB,EACV,OAAO,EACP,SAAS,EACT,KAAK,EACL,SAAS,EACT,WAAW,EACX,QAAQ,EACR,MAAM,EACN,WAAW,EACX,aAAqB,EACtB,EAAE,gBAAgB;IA6BnB,IAAI,eAAe,IAAI,OAAO,CAE7B;IAED,IAAI,IAAI,IAAI,WAAW,CAEtB;IAED,IAAI,IAAI,IAAI,UAAU,CAErB;IAED,2GAA2G;IAC3G,IAAI,UAAU,IAAI,UAAU,CAE3B;IAED,IAAI,MAAM,IAAI,eAAe,CAE5B;IAED,IAAI,aAAa,IAAI,OAAO,CAE3B;IAED,OAAO,CAAC,kBAAkB;IAS1B,OAAO;CAMR;AASD,eAAe,SAAS,CAAC"}

package/dist/cjs/ApiClient/index.js

@@ -0,0 +1,87 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ApiError = void 0;
+const RestClient_1 = __importDefault(require("../lib/RestClient"));
+const TypedEventEmitter_1 = __importDefault(require("../lib/TypedEventEmitter"));
+const AuthManager_1 = require("../lib/AuthManager");
+const WebSocketClient_1 = __importDefault(require("./WebSocketClient"));
+class ApiError extends Error {
+    constructor(status, payload) {
+        super(payload.message);
+        this.status = status;
+        this.payload = payload;
+    }
+}
+exports.ApiError = ApiError;
+class ApiClient extends TypedEventEmitter_1.default {
+    constructor({ baseUrl, socketUrl, appId, appSource, networkType, authType, logger, authStorage, disableSocket = false }) {
+        super();
+        this.appId = appId;
+        this.appSource = appSource?.trim() || undefined;
+        this.logger = logger;
+        this._disableSocket = disableSocket;
+        if (authType === 'apiKey') {
+            this._auth = new AuthManager_1.ApiKeyAuthManager(logger);
+        }
+        else {
+            this._auth = new AuthManager_1.TokenAuthManager(baseUrl, logger, authStorage);
+        }
+        this._rest = new RestClient_1.default(baseUrl, this._auth, logger);
+        this._socketRest = new RestClient_1.default(normalizeHttpUrl(socketUrl), this._auth, logger);
+        this._socket = new WebSocketClient_1.default(socketUrl, this._auth, appId, networkType, logger, this.appSource);
+        this._auth.on('updated', (isAuthenticated) => {
+            this.emit('authUpdated', isAuthenticated);
+            this._handleAuthUpdated(isAuthenticated);
+        });
+        this._socket.on('connected', (e) => this.emit('connected', e));
+        this._socket.on('disconnected', (e) => this.emit('disconnected', e));
+    }
+    get isAuthenticated() {
+        return this._auth.isAuthenticated;
+    }
+    get auth() {
+        return this._auth;
+    }
+    get rest() {
+        return this._rest;
+    }
+    /** REST client bound to the socket server URL (used for model lists, image upload/download URLs, etc.). */
+    get socketRest() {
+        return this._socketRest;
+    }
+    get socket() {
+        return this._socket;
+    }
+    get socketEnabled() {
+        return !this._disableSocket;
+    }
+    _handleAuthUpdated(isAuthenticated) {
+        if (this._disableSocket)
+            return;
+        if (isAuthenticated && !this._socket.isConnected) {
+            void this._socket.connect();
+        }
+        else if (!isAuthenticated && this._socket.isConnected) {
+            this._socket.disconnect();
+        }
+    }
+    dispose() {
+        this._socket.dispose();
+        this._auth.removeAllListeners();
+        this.removeAllListeners();
+        this._auth.clear();
+    }
+}
+function normalizeHttpUrl(url) {
+    const u = new URL(url);
+    if (u.protocol === 'http:' || u.protocol === 'ws:')
+        u.protocol = 'http:';
+    else
+        u.protocol = 'https:';
+    return u.toString();
+}
+exports.default = ApiClient;
+//# sourceMappingURL=index.js.map

package/dist/cjs/ApiClient/index.js.map

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

package/dist/cjs/Chat/ChatStream.d.ts

@@ -0,0 +1,42 @@
+import ErrorData from '../types/ErrorData';
+import { ChatCompletionChunk, ChatCompletionResult, TokenUsage } from './types';
+/**
+ * Async iterable representing a streaming chat completion.
+ *
+ * Iterate with `for await (const chunk of stream)`. Each chunk has `content`
+ * (token text) and may carry a `finishReason` on the final chunk. After the
+ * stream completes, `stream.result` resolves to the full ChatCompletionResult.
+ *
+ * Cancel mid-stream with `stream.cancel()` (sends a server-side abort).
+ */
+declare class ChatStream implements AsyncIterable<ChatCompletionChunk> {
+    readonly jobId: string;
+    private _queue;
+    private _pendingResolver;
+    private _pendingRejecter;
+    private _content;
+    private _role;
+    private _finishReason;
+    private _usage;
+    private _timeTaken;
+    private _workerName;
+    private _toolCallAccumulator;
+    private _done;
+    private _error;
+    private _resultPromise;
+    private _resultResolve;
+    private _resultReject;
+    private _onCancel;
+    constructor(jobId: string, onCancel: () => Promise<void>);
+    /** Resolves to the full result after the stream completes. */
+    get result(): Promise<ChatCompletionResult>;
+    cancel(): Promise<void>;
+    [Symbol.asyncIterator](): AsyncIterator<ChatCompletionChunk>;
+    private _next;
+    _pushChunk(chunk: ChatCompletionChunk): void;
+    _complete(timeTaken: number, usage?: TokenUsage, workerName?: string): void;
+    _fail(error: ErrorData): void;
+    private _accumulateToolCalls;
+}
+export default ChatStream;
+//# sourceMappingURL=ChatStream.d.ts.map

package/dist/cjs/Chat/ChatStream.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ChatStream.d.ts","sourceRoot":"","sources":["../../../src/Chat/ChatStream.ts"],"names":[],"mappings":"AAAA,OAAO,SAAS,MAAM,oBAAoB,CAAC;AAC3C,OAAO,EACL,mBAAmB,EACnB,oBAAoB,EAGpB,UAAU,EACX,MAAM,SAAS,CAAC;AAKjB;;;;;;;;GAQG;AACH,cAAM,UAAW,YAAW,aAAa,CAAC,mBAAmB,CAAC;IAC5D,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,OAAO,CAAC,MAAM,CAA6B;IAC3C,OAAO,CAAC,gBAAgB,CAAyB;IACjD,OAAO,CAAC,gBAAgB,CAAyB;IACjD,OAAO,CAAC,QAAQ,CAAM;IACtB,OAAO,CAAC,KAAK,CAAuB;IACpC,OAAO,CAAC,aAAa,CAAuB;IAC5C,OAAO,CAAC,MAAM,CAA0D;IACxE,OAAO,CAAC,UAAU,CAAK;IACvB,OAAO,CAAC,WAAW,CAAqB;IACxC,OAAO,CAAC,oBAAoB,CAA+B;IAC3D,OAAO,CAAC,KAAK,CAAS;IACtB,OAAO,CAAC,MAAM,CAAsB;IACpC,OAAO,CAAC,cAAc,CAAgC;IACtD,OAAO,CAAC,cAAc,CAAqC;IAC3D,OAAO,CAAC,aAAa,CAAsB;IAC3C,OAAO,CAAC,SAAS,CAAsB;gBAE3B,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC;IASxD,8DAA8D;IAC9D,IAAI,MAAM,IAAI,OAAO,CAAC,oBAAoB,CAAC,CAE1C;IAEK,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;IAI7B,CAAC,MAAM,CAAC,aAAa,CAAC,IAAI,aAAa,CAAC,mBAAmB,CAAC;IAM5D,OAAO,CAAC,KAAK;IAmBb,UAAU,CAAC,KAAK,EAAE,mBAAmB,GAAG,IAAI;IAmB5C,SAAS,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,UAAU,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI;IA8B3E,KAAK,CAAC,KAAK,EAAE,SAAS,GAAG,IAAI;IAgB7B,OAAO,CAAC,oBAAoB;CAa7B;AAED,eAAe,UAAU,CAAC"}

package/dist/cjs/Chat/ChatStream.js

@@ -0,0 +1,146 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+/**
+ * Async iterable representing a streaming chat completion.
+ *
+ * Iterate with `for await (const chunk of stream)`. Each chunk has `content`
+ * (token text) and may carry a `finishReason` on the final chunk. After the
+ * stream completes, `stream.result` resolves to the full ChatCompletionResult.
+ *
+ * Cancel mid-stream with `stream.cancel()` (sends a server-side abort).
+ */
+class ChatStream {
+    constructor(jobId, onCancel) {
+        this._queue = [];
+        this._pendingResolver = null;
+        this._pendingRejecter = null;
+        this._content = '';
+        this._role = 'assistant';
+        this._finishReason = null;
+        this._usage = { prompt_tokens: 0, completion_tokens: 0 };
+        this._timeTaken = 0;
+        this._toolCallAccumulator = new Map();
+        this._done = false;
+        this._error = null;
+        this.jobId = jobId;
+        this._onCancel = onCancel;
+        this._resultPromise = new Promise((resolve, reject) => {
+            this._resultResolve = resolve;
+            this._resultReject = reject;
+        });
+    }
+    /** Resolves to the full result after the stream completes. */
+    get result() {
+        return this._resultPromise;
+    }
+    async cancel() {
+        await this._onCancel();
+    }
+    [Symbol.asyncIterator]() {
+        return {
+            next: () => this._next()
+        };
+    }
+    _next() {
+        return new Promise((resolve, reject) => {
+            if (this._error) {
+                reject(this._error);
+                return;
+            }
+            if (this._queue.length > 0) {
+                resolve({ value: this._queue.shift(), done: false });
+                return;
+            }
+            if (this._done) {
+                resolve({ value: undefined, done: true });
+                return;
+            }
+            this._pendingResolver = resolve;
+            this._pendingRejecter = reject;
+        });
+    }
+    _pushChunk(chunk) {
+        if (chunk.content)
+            this._content += chunk.content;
+        if (chunk.role)
+            this._role = chunk.role;
+        if (chunk.finishReason !== undefined && chunk.finishReason !== null) {
+            this._finishReason = chunk.finishReason;
+        }
+        if (chunk.usage)
+            this._usage = chunk.usage;
+        if (chunk.tool_calls)
+            this._accumulateToolCalls(chunk.tool_calls);
+        if (this._pendingResolver) {
+            const resolve = this._pendingResolver;
+            this._pendingResolver = null;
+            this._pendingRejecter = null;
+            resolve({ value: chunk, done: false });
+        }
+        else {
+            this._queue.push(chunk);
+        }
+    }
+    _complete(timeTaken, usage, workerName) {
+        if (this._done)
+            return;
+        if (usage)
+            this._usage = usage;
+        this._timeTaken = timeTaken;
+        if (workerName)
+            this._workerName = workerName;
+        this._done = true;
+        const toolCalls = Array.from(this._toolCallAccumulator.values()).filter((tc) => tc.id && tc.function.name);
+        const result = {
+            jobId: this.jobId,
+            content: this._content,
+            role: this._role,
+            finishReason: this._finishReason,
+            usage: this._usage,
+            timeTaken: this._timeTaken,
+            ...(this._workerName ? { workerName: this._workerName } : {}),
+            ...(toolCalls.length ? { tool_calls: toolCalls } : {})
+        };
+        this._resultResolve(result);
+        if (this._pendingResolver) {
+            const resolve = this._pendingResolver;
+            this._pendingResolver = null;
+            this._pendingRejecter = null;
+            resolve({ value: undefined, done: true });
+        }
+    }
+    _fail(error) {
+        if (this._done)
+            return;
+        this._done = true;
+        const err = new Error(error.message || 'Chat completion failed');
+        err.code = error.code;
+        err.rawCode = error.originalCode;
+        this._error = err;
+        this._resultReject(err);
+        if (this._pendingRejecter) {
+            const reject = this._pendingRejecter;
+            this._pendingResolver = null;
+            this._pendingRejecter = null;
+            reject(err);
+        }
+    }
+    _accumulateToolCalls(deltas) {
+        for (const delta of deltas) {
+            const existing = this._toolCallAccumulator.get(delta.index) ?? {
+                id: delta.id ?? '',
+                type: 'function',
+                function: { name: '', arguments: '' }
+            };
+            if (delta.id)
+                existing.id = delta.id;
+            if (delta.function?.name)
+                existing.function.name += delta.function.name;
+            if (delta.function?.arguments)
+                existing.function.arguments += delta.function.arguments;
+            this._toolCallAccumulator.set(delta.index, existing);
+        }
+    }
+}
+exports.default = ChatStream;
+//# sourceMappingURL=ChatStream.js.map

package/dist/cjs/Chat/ChatStream.js.map

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

package/dist/cjs/Chat/index.d.ts

@@ -0,0 +1,61 @@
+import ApiClient from '../ApiClient';
+import TypedEventEmitter from '../lib/TypedEventEmitter';
+import ChatStream from './ChatStream';
+import { ChatCompletionChunk, ChatCompletionParams, ChatCompletionResult, LLMModelInfo } from './types';
+interface ChatApiEvents {
+    /** Fired for each streaming chunk on any active completion. */
+    token: ChatCompletionChunk;
+    /** Fired when any completion finishes successfully. */
+    completed: ChatCompletionResult;
+    /** Fired when any completion fails. */
+    failed: {
+        jobId: string;
+        error: Error;
+    };
+    /** Fired when the server pushes an updated LLM model list. */
+    modelsUpdated: Record<string, LLMModelInfo>;
+}
+/**
+ * Chat / LLM API — OpenAI-compatible completions over WebSocket.
+ *
+ * Phase 4b MVP: streaming + non-streaming text and multimodal (vision)
+ * completions. Tool-calling deltas are exposed on chunks/results for apps
+ * that drive their own tool loops, but the auto-execution loop and Sogni
+ * hosted tools are not yet wired up.
+ */
+declare class ChatApi extends TypedEventEmitter<ChatApiEvents> {
+    private _client;
+    private _streams;
+    private _availableModels;
+    constructor(client: ApiClient);
+    /** Snapshot of the latest LLM model list pushed by the server. */
+    getAvailableModels(): Record<string, LLMModelInfo>;
+    /** Subscribe to model-list updates. Returns an unsubscribe function. */
+    onModelsUpdated(listener: (models: Record<string, LLMModelInfo>) => void): () => void;
+    completions: {
+        create: {
+            (params: ChatCompletionParams & {
+                stream: true;
+            }): Promise<ChatStream>;
+            (params: ChatCompletionParams & {
+                stream?: false;
+            }): Promise<ChatCompletionResult>;
+        };
+    };
+    private _create;
+    private _dispatchCompletion;
+    /**
+     * Multi-round tool-calling loop. Each round sends a completion, then
+     * executes any returned tool_calls via the user's onToolCall handler and
+     * appends the results to the conversation. Stops when the model returns a
+     * normal completion (no tool calls) or when maxToolRounds is reached.
+     */
+    private _runAutoToolLoop;
+    private _onTokens;
+    private _onResult;
+    private _onError;
+    private _onModels;
+    private _cancelStream;
+}
+export default ChatApi;
+//# sourceMappingURL=index.d.ts.map

package/dist/cjs/Chat/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/Chat/index.ts"],"names":[],"mappings":"AAAA,OAAO,SAAS,MAAM,cAAc,CAAC;AAOrC,OAAO,iBAAiB,MAAM,0BAA0B,CAAC;AAEzD,OAAO,UAAU,MAAM,cAAc,CAAC;AACtC,OAAO,EACL,mBAAmB,EACnB,oBAAoB,EACpB,oBAAoB,EAEpB,YAAY,EAEb,MAAM,SAAS,CAAC;AAEjB,UAAU,aAAa;IACrB,+DAA+D;IAC/D,KAAK,EAAE,mBAAmB,CAAC;IAC3B,uDAAuD;IACvD,SAAS,EAAE,oBAAoB,CAAC;IAChC,uCAAuC;IACvC,MAAM,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,KAAK,CAAA;KAAE,CAAC;IACxC,8DAA8D;IAC9D,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;CAC7C;AAED;;;;;;;GAOG;AACH,cAAM,OAAQ,SAAQ,iBAAiB,CAAC,aAAa,CAAC;IACpD,OAAO,CAAC,OAAO,CAAY;IAC3B,OAAO,CAAC,QAAQ,CAAiC;IACjD,OAAO,CAAC,gBAAgB,CAAoC;gBAEhD,MAAM,EAAE,SAAS;IAS7B,kEAAkE;IAClE,kBAAkB,IAAI,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC;IAIlD,wEAAwE;IACxE,eAAe,CAAC,QAAQ,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,KAAK,IAAI,GAAG,MAAM,IAAI;IAIrF,WAAW;gBAC2D;YAClE,CAAC,MAAM,EAAE,oBAAoB,GAAG;gBAAE,MAAM,EAAE,IAAI,CAAA;aAAE,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;YACvE,CAAC,MAAM,EAAE,oBAAoB,GAAG;gBAAE,MAAM,CAAC,EAAE,KAAK,CAAA;aAAE,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAAC;SACpF;MACD;YAEY,OAAO;YAuBP,mBAAmB;IA6BjC;;;;;OAKG;YACW,gBAAgB;IAgD9B,OAAO,CAAC,SAAS;IAejB,OAAO,CAAC,SAAS;IAQjB,OAAO,CAAC,QAAQ;IAWhB,OAAO,CAAC,SAAS;YAKH,aAAa;CAO5B;AAED,eAAe,OAAO,CAAC"}