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

package/dist/cjs/Chat/index.js

@@ -0,0 +1,179 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const TypedEventEmitter_1 = __importDefault(require("../lib/TypedEventEmitter"));
+const getUUID_1 = __importDefault(require("../lib/getUUID"));
+const ChatStream_1 = __importDefault(require("./ChatStream"));
+/**
+ * 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.
+ */
+class ChatApi extends TypedEventEmitter_1.default {
+    constructor(client) {
+        super();
+        this._streams = new Map();
+        this._availableModels = {};
+        this.completions = {
+            create: ((params) => this._create(params))
+        };
+        this._client = client;
+        client.socket.on('chatTokens', (e) => this._onTokens(e));
+        client.socket.on('chatResult', (e) => this._onResult(e));
+        client.socket.on('chatError', (e) => this._onError(e));
+        client.socket.on('swarmLLMModels', (e) => this._onModels(e));
+    }
+    /** Snapshot of the latest LLM model list pushed by the server. */
+    getAvailableModels() {
+        return { ...this._availableModels };
+    }
+    /** Subscribe to model-list updates. Returns an unsubscribe function. */
+    onModelsUpdated(listener) {
+        return this.on('modelsUpdated', listener);
+    }
+    async _create(params) {
+        if (!this._client.socket.isConnected) {
+            throw new Error('Cannot start chat completion: WebSocket is not connected. Authenticate first.');
+        }
+        if (params.autoExecuteTools) {
+            if (params.stream) {
+                throw new Error('autoExecuteTools is not supported with stream: true. Drive the tool loop yourself instead.');
+            }
+            if (!params.onToolCall) {
+                throw new Error('autoExecuteTools requires an onToolCall handler');
+            }
+            return this._runAutoToolLoop(params);
+        }
+        const stream = await this._dispatchCompletion(params);
+        if (params.stream)
+            return stream;
+        return stream.result;
+    }
+    async _dispatchCompletion(params) {
+        const jobId = (0, getUUID_1.default)();
+        const request = {
+            jobID: jobId,
+            type: 'llm',
+            model: params.model,
+            messages: params.messages,
+            max_tokens: params.max_tokens,
+            temperature: params.temperature,
+            top_p: params.top_p,
+            top_k: params.top_k,
+            min_p: params.min_p,
+            stream: !!params.stream,
+            repetition_penalty: params.repetition_penalty,
+            frequency_penalty: params.frequency_penalty,
+            presence_penalty: params.presence_penalty,
+            stop: params.stop,
+            tokenType: params.tokenType,
+            tools: params.tools,
+            tool_choice: params.tool_choice,
+            chat_template_kwargs: params.chat_template_kwargs,
+            taskProfile: params.taskProfile
+        };
+        const stream = new ChatStream_1.default(jobId, () => this._cancelStream(jobId));
+        this._streams.set(jobId, stream);
+        await this._client.socket.send('llmJobRequest', request);
+        return stream;
+    }
+    /**
+     * 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.
+     */
+    async _runAutoToolLoop(params) {
+        const maxRounds = params.maxToolRounds ?? 5;
+        const onToolCall = params.onToolCall;
+        const history = [];
+        let messages = params.messages.slice();
+        for (let round = 1; round <= maxRounds; round++) {
+            const stream = await this._dispatchCompletion({
+                ...params,
+                messages,
+                stream: false,
+                autoExecuteTools: false,
+                onToolCall: undefined
+            });
+            const result = await stream.result;
+            if (!result.tool_calls?.length || result.finishReason !== 'tool_calls') {
+                return { ...result, ...(history.length ? { toolHistory: history } : {}) };
+            }
+            const toolResults = [];
+            for (const call of result.tool_calls) {
+                const content = await onToolCall(call);
+                toolResults.push({ tool_call_id: call.id, content });
+            }
+            history.push({ round, toolCalls: result.tool_calls, toolResults });
+            messages = [
+                ...messages,
+                {
+                    role: 'assistant',
+                    content: result.content || null,
+                    tool_calls: result.tool_calls
+                },
+                ...result.tool_calls.map((call, i) => ({
+                    role: 'tool',
+                    content: toolResults[i].content,
+                    tool_call_id: call.id,
+                    name: call.function.name
+                }))
+            ];
+        }
+        throw new Error(`autoExecuteTools exceeded maxToolRounds (${maxRounds}) — the model kept requesting tool calls`);
+    }
+    _onTokens(e) {
+        const stream = this._streams.get(e.jobId);
+        if (!stream)
+            return;
+        const chunk = {
+            jobId: e.jobId,
+            content: e.content,
+            ...(e.role ? { role: e.role } : {}),
+            ...(e.finishReason !== undefined ? { finishReason: e.finishReason } : {}),
+            ...(e.usage ? { usage: e.usage } : {}),
+            ...(e.tool_calls ? { tool_calls: e.tool_calls } : {})
+        };
+        stream._pushChunk(chunk);
+        this.emit('token', chunk);
+    }
+    _onResult(e) {
+        const stream = this._streams.get(e.jobId);
+        if (!stream)
+            return;
+        stream._complete(e.timeTaken, e.usage, e.workerName);
+        stream.result.then((r) => this.emit('completed', r)).catch(() => undefined);
+        this._streams.delete(e.jobId);
+    }
+    _onError(e) {
+        const stream = this._streams.get(e.jobId);
+        if (!stream)
+            return;
+        stream._fail({ code: 5000, originalCode: e.rawCode, message: e.message });
+        this.emit('failed', {
+            jobId: e.jobId,
+            error: new Error(e.message)
+        });
+        this._streams.delete(e.jobId);
+    }
+    _onModels(e) {
+        this._availableModels = e.models;
+        this.emit('modelsUpdated', this._availableModels);
+    }
+    async _cancelStream(jobId) {
+        try {
+            await this._client.socket.send('llmJobCancel', { jobID: jobId });
+        }
+        catch (e) {
+            this._client.logger.warn(`Failed to cancel chat job ${jobId}:`, e);
+        }
+    }
+}
+exports.default = ChatApi;
+//# sourceMappingURL=index.js.map

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

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

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

@@ -0,0 +1,13 @@
+import { ToolCall } from './types';
+/**
+ * Parse a tool call's arguments JSON into a typed object.
+ *
+ * Tool call arguments arrive from the model as a string (so they can be
+ * streamed character-by-character). This helper does the JSON.parse with
+ * a clearer error message than a raw SyntaxError.
+ *
+ * @example
+ * const args = parseToolCallArguments<{ description: string; tags: string[] }>(call);
+ */
+export declare function parseToolCallArguments<T = Record<string, unknown>>(toolCall: ToolCall): T;
+//# sourceMappingURL=tools.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../../../src/Chat/tools.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAEnC;;;;;;;;;GASG;AACH,wBAAgB,sBAAsB,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,QAAQ,EAAE,QAAQ,GAAG,CAAC,CAUzF"}

package/dist/cjs/Chat/tools.js

@@ -0,0 +1,22 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseToolCallArguments = parseToolCallArguments;
+/**
+ * Parse a tool call's arguments JSON into a typed object.
+ *
+ * Tool call arguments arrive from the model as a string (so they can be
+ * streamed character-by-character). This helper does the JSON.parse with
+ * a clearer error message than a raw SyntaxError.
+ *
+ * @example
+ * const args = parseToolCallArguments<{ description: string; tags: string[] }>(call);
+ */
+function parseToolCallArguments(toolCall) {
+    try {
+        return JSON.parse(toolCall.function.arguments);
+    }
+    catch (err) {
+        throw new Error(`Failed to parse arguments for tool ${toolCall.function.name} (id=${toolCall.id}): ${err instanceof Error ? err.message : String(err)}. Raw arguments: ${toolCall.function.arguments}`);
+    }
+}
+//# sourceMappingURL=tools.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"tools.js","sourceRoot":"","sources":["../../../src/Chat/tools.ts"],"names":[],"mappings":";;AAYA,wDAUC;AApBD;;;;;;;;;GASG;AACH,SAAgB,sBAAsB,CAA8B,QAAkB;IACpF,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,QAAQ,CAAC,SAAS,CAAM,CAAC;IACtD,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CACb,sCAAsC,QAAQ,CAAC,QAAQ,CAAC,IAAI,QAAQ,QAAQ,CAAC,EAAE,MAC7E,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CACjD,oBAAoB,QAAQ,CAAC,QAAQ,CAAC,SAAS,EAAE,CAClD,CAAC;IACJ,CAAC;AACH,CAAC"}

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

@@ -0,0 +1,153 @@
+import { TokenType } from '../types/token';
+export interface TextContentPart {
+    type: 'text';
+    text: string;
+}
+/**
+ * Image input for multimodal (vision) chat. Pass a base64-encoded data URI like
+ * `data:image/jpeg;base64,...`. Server limits: max 20 images per request, 10 MB
+ * each, longest side 1024px.
+ */
+export interface ImageUrlContentPart {
+    type: 'image_url';
+    image_url: {
+        url: string;
+        detail?: 'auto' | 'low' | 'high';
+    };
+}
+export type ContentPart = TextContentPart | ImageUrlContentPart;
+export interface ChatMessage {
+    role: 'system' | 'user' | 'assistant' | 'tool';
+    content: string | ContentPart[] | null;
+    /** Tool calls returned by an assistant message. */
+    tool_calls?: ToolCall[];
+    /** Identifies which tool call this message responds to. */
+    tool_call_id?: string;
+    name?: string;
+}
+/**
+ * Tool-calling types are kept structural only for Phase 4b. The SDK exposes
+ * the wire shape (so apps that want to drive their own tool loops can do so),
+ * but the multi-round auto-execution loop and Sogni hosted tools are deferred
+ * to a follow-up release.
+ */
+export interface ToolFunction {
+    name: string;
+    description?: string;
+    parameters?: Record<string, unknown>;
+}
+export interface ToolDefinition {
+    type: 'function';
+    function: ToolFunction;
+}
+export interface ToolCallFunction {
+    name: string;
+    arguments: string;
+}
+export interface ToolCall {
+    id: string;
+    type: 'function';
+    function: ToolCallFunction;
+}
+export interface ToolCallDelta {
+    index: number;
+    id?: string;
+    type?: 'function';
+    function?: {
+        name?: string;
+        arguments?: string;
+    };
+}
+export type ToolChoice = 'none' | 'auto' | 'required' | {
+    type: 'function';
+    function: {
+        name: string;
+    };
+};
+export interface ChatCompletionParams {
+    model: string;
+    messages: ChatMessage[];
+    max_tokens?: number;
+    temperature?: number;
+    top_p?: number;
+    top_k?: number;
+    min_p?: number;
+    stream?: boolean;
+    repetition_penalty?: number;
+    frequency_penalty?: number;
+    presence_penalty?: number;
+    stop?: string | string[];
+    /** Token type to use for billing. Defaults to 'sogni'. */
+    tokenType?: TokenType;
+    tools?: ToolDefinition[];
+    tool_choice?: ToolChoice;
+    /** Per-request chat template arguments (e.g. `{ enable_thinking: false }`). */
+    chat_template_kwargs?: Record<string, unknown>;
+    /** Hint for server-side preset selection. */
+    taskProfile?: 'general' | 'coding' | 'reasoning';
+    /**
+     * Automatically run a multi-round tool calling loop. The SDK sends the
+     * completion, executes any returned tool calls via `onToolCall`, feeds the
+     * results back as `role: 'tool'` messages, and repeats until the model
+     * answers without calling more tools (or `maxToolRounds` is reached).
+     *
+     * Only supported when `stream: false`. For streaming flows, drive the loop
+     * yourself by inspecting `result.tool_calls` and issuing follow-up
+     * completions.
+     */
+    autoExecuteTools?: boolean;
+    /**
+     * Required when `autoExecuteTools` is true. Called for each tool call the
+     * model emits. Must return the tool result content (a string the model
+     * will see as the tool's output).
+     */
+    onToolCall?: (toolCall: ToolCall) => Promise<string> | string;
+    /**
+     * Max number of tool-calling rounds when `autoExecuteTools` is true.
+     * Defaults to 5. Prevents infinite loops if the model keeps calling tools.
+     */
+    maxToolRounds?: number;
+}
+/** Re-export for app-side use. */
+/** One round of tool calls + results captured during an autoExecuteTools loop. */
+export interface ToolRound {
+    round: number;
+    toolCalls: ToolCall[];
+    toolResults: Array<{
+        tool_call_id: string;
+        content: string;
+    }>;
+}
+export interface TokenUsage {
+    prompt_tokens: number;
+    completion_tokens: number;
+    total_tokens?: number;
+}
+export interface ChatCompletionChunk {
+    jobId: string;
+    content: string;
+    role?: string;
+    finishReason?: string | null;
+    usage?: TokenUsage;
+    tool_calls?: ToolCallDelta[];
+}
+export interface ChatCompletionResult {
+    jobId: string;
+    content: string;
+    role: string;
+    finishReason: string | null;
+    usage: TokenUsage;
+    timeTaken: number;
+    workerName?: string;
+    tool_calls?: ToolCall[];
+    /** History of tool-calling rounds when `autoExecuteTools` was used. */
+    toolHistory?: ToolRound[];
+}
+export interface LLMModelInfo {
+    /** Worker count currently serving this model on the selected network. */
+    workers: number;
+    /** Optional richer metadata when the server sends the full LLMModelInfo shape. */
+    displayName?: string;
+    contextLength?: number;
+}
+//# sourceMappingURL=types.d.ts.map

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

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

package/dist/cjs/Chat/types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/Chat/types.ts"],"names":[],"mappings":""}

package/dist/cjs/Projects/ControlNet.d.ts

@@ -0,0 +1,30 @@
+import { MediaInput } from '../lib/mediaInput';
+export type ControlNetName = 'canny' | 'depth' | 'inpaint' | 'instrp2p' | 'lineart' | 'lineartanime' | 'mlsd' | 'normalbae' | 'openpose' | 'scribble' | 'segmentation' | 'shuffle' | 'softedge' | 'tile' | 'instantid';
+export type ControlNetMode = 'balanced' | 'prompt_priority' | 'cn_priority';
+export interface ControlNetParams {
+    /** Short name of the ControlNet model. */
+    name: ControlNetName;
+    /** Control image input. Omit `image` and pass `imageAlreadyUploaded: true` if the image is already on the server. */
+    image?: MediaInput;
+    /** True when the control image was uploaded out of band and only the flag should be sent. */
+    imageAlreadyUploaded?: boolean;
+    /** 0..1. 0 = full control to prompt, 1 = full control to ControlNet. */
+    strength?: number;
+    mode?: ControlNetMode;
+    /** Step at which the ControlNet first applies (0..1). Must be < guidanceEnd. */
+    guidanceStart?: number;
+    /** Step at which the ControlNet last applies (0..1). Must be > guidanceStart. */
+    guidanceEnd?: number;
+}
+export interface ControlNetParamsRaw {
+    name: ControlNetName;
+    cnImageState: 'original';
+    hasImage: boolean;
+    controlStrength?: number;
+    controlMode?: 0 | 1 | 2;
+    controlGuidanceStart?: number;
+    controlGuidanceEnd?: number;
+}
+export declare function toControlNetRaw(params: ControlNetParams): ControlNetParamsRaw;
+export declare function getMaxContextImages(modelId: string): number;
+//# sourceMappingURL=ControlNet.d.ts.map

package/dist/cjs/Projects/ControlNet.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ControlNet.d.ts","sourceRoot":"","sources":["../../../src/Projects/ControlNet.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAE/C,MAAM,MAAM,cAAc,GACtB,OAAO,GACP,OAAO,GACP,SAAS,GACT,UAAU,GACV,SAAS,GACT,cAAc,GACd,MAAM,GACN,WAAW,GACX,UAAU,GACV,UAAU,GACV,cAAc,GACd,SAAS,GACT,UAAU,GACV,MAAM,GACN,WAAW,CAAC;AAEhB,MAAM,MAAM,cAAc,GAAG,UAAU,GAAG,iBAAiB,GAAG,aAAa,CAAC;AAE5E,MAAM,WAAW,gBAAgB;IAC/B,0CAA0C;IAC1C,IAAI,EAAE,cAAc,CAAC;IACrB,qHAAqH;IACrH,KAAK,CAAC,EAAE,UAAU,CAAC;IACnB,6FAA6F;IAC7F,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B,wEAAwE;IACxE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,cAAc,CAAC;IACtB,gFAAgF;IAChF,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,iFAAiF;IACjF,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,cAAc,CAAC;IACrB,YAAY,EAAE,UAAU,CAAC;IACzB,QAAQ,EAAE,OAAO,CAAC;IAClB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,WAAW,CAAC,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IACxB,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B;AAQD,wBAAgB,eAAe,CAAC,MAAM,EAAE,gBAAgB,GAAG,mBAAmB,CAe7E;AASD,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAM3D"}

package/dist/cjs/Projects/ControlNet.js

@@ -0,0 +1,45 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.toControlNetRaw = toControlNetRaw;
+exports.getMaxContextImages = getMaxContextImages;
+const MODE_MAP = {
+    balanced: 0,
+    prompt_priority: 1,
+    cn_priority: 2
+};
+function toControlNetRaw(params) {
+    const raw = {
+        name: params.name,
+        cnImageState: 'original',
+        hasImage: !!params.image || !!params.imageAlreadyUploaded
+    };
+    if (params.strength !== undefined)
+        raw.controlStrength = clamp01(params.strength, 'strength');
+    if (params.mode)
+        raw.controlMode = MODE_MAP[params.mode];
+    if (params.guidanceStart !== undefined) {
+        raw.controlGuidanceStart = clamp01(params.guidanceStart, 'guidanceStart');
+    }
+    if (params.guidanceEnd !== undefined) {
+        raw.controlGuidanceEnd = clamp01(params.guidanceEnd, 'guidanceEnd');
+    }
+    return raw;
+}
+function clamp01(value, name) {
+    if (Number.isNaN(value) || value < 0 || value > 1) {
+        throw new Error(`${name} must be between 0 and 1 (got ${value})`);
+    }
+    return value;
+}
+function getMaxContextImages(modelId) {
+    if (modelId === 'gpt-image-2')
+        return 16;
+    if (modelId.startsWith('flux2_'))
+        return 6;
+    if (modelId.startsWith('qwen_image_'))
+        return 3;
+    if (modelId.includes('kontext'))
+        return 2;
+    return 3;
+}
+//# sourceMappingURL=ControlNet.js.map

package/dist/cjs/Projects/ControlNet.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ControlNet.js","sourceRoot":"","sources":["../../../src/Projects/ControlNet.ts"],"names":[],"mappings":";;AAqDA,0CAeC;AASD,kDAMC;AApCD,MAAM,QAAQ,GAAsC;IAClD,QAAQ,EAAE,CAAC;IACX,eAAe,EAAE,CAAC;IAClB,WAAW,EAAE,CAAC;CACf,CAAC;AAEF,SAAgB,eAAe,CAAC,MAAwB;IACtD,MAAM,GAAG,GAAwB;QAC/B,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,YAAY,EAAE,UAAU;QACxB,QAAQ,EAAE,CAAC,CAAC,MAAM,CAAC,KAAK,IAAI,CAAC,CAAC,MAAM,CAAC,oBAAoB;KAC1D,CAAC;IACF,IAAI,MAAM,CAAC,QAAQ,KAAK,SAAS;QAAE,GAAG,CAAC,eAAe,GAAG,OAAO,CAAC,MAAM,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC;IAC9F,IAAI,MAAM,CAAC,IAAI;QAAE,GAAG,CAAC,WAAW,GAAG,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IACzD,IAAI,MAAM,CAAC,aAAa,KAAK,SAAS,EAAE,CAAC;QACvC,GAAG,CAAC,oBAAoB,GAAG,OAAO,CAAC,MAAM,CAAC,aAAa,EAAE,eAAe,CAAC,CAAC;IAC5E,CAAC;IACD,IAAI,MAAM,CAAC,WAAW,KAAK,SAAS,EAAE,CAAC;QACrC,GAAG,CAAC,kBAAkB,GAAG,OAAO,CAAC,MAAM,CAAC,WAAW,EAAE,aAAa,CAAC,CAAC;IACtE,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,SAAS,OAAO,CAAC,KAAa,EAAE,IAAY;IAC1C,IAAI,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,KAAK,GAAG,CAAC,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;QAClD,MAAM,IAAI,KAAK,CAAC,GAAG,IAAI,iCAAiC,KAAK,GAAG,CAAC,CAAC;IACpE,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAgB,mBAAmB,CAAC,OAAe;IACjD,IAAI,OAAO,KAAK,aAAa;QAAE,OAAO,EAAE,CAAC;IACzC,IAAI,OAAO,CAAC,UAAU,CAAC,QAAQ,CAAC;QAAE,OAAO,CAAC,CAAC;IAC3C,IAAI,OAAO,CAAC,UAAU,CAAC,aAAa,CAAC;QAAE,OAAO,CAAC,CAAC;IAChD,IAAI,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC;QAAE,OAAO,CAAC,CAAC;IAC1C,OAAO,CAAC,CAAC;AACX,CAAC"}

package/dist/cjs/Projects/createJobRequestMessage.d.ts

@@ -0,0 +1,11 @@
+import { ProjectParams } from './types';
+/**
+ * Build the wire-level `jobRequest` payload from public ProjectParams.
+ *
+ * The template includes a lot of fields that look video/animation-specific
+ * because the server validates the full shape regardless of project type. We
+ * send everything verbatim and the server picks what it needs based on the
+ * model family.
+ */
+export default function createJobRequestMessage(id: string, params: ProjectParams): Record<string, unknown>;
+//# sourceMappingURL=createJobRequestMessage.d.ts.map

package/dist/cjs/Projects/createJobRequestMessage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createJobRequestMessage.d.ts","sourceRoot":"","sources":["../../../src/Projects/createJobRequestMessage.ts"],"names":[],"mappings":"AACA,OAAO,EAA0C,aAAa,EAAsB,MAAM,SAAS,CAAC;AAGpG;;;;;;;GAOG;AACH,MAAM,CAAC,OAAO,UAAU,uBAAuB,CAC7C,EAAE,EAAE,MAAM,EACV,MAAM,EAAE,aAAa,GACpB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAWzB"}