@sogni-ai/sogni-client 4.2.0-alpha.2 → 4.2.0-alpha.21

package/dist/Chat/tools.js

@@ -1,255 +1,99 @@
 "use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.SogniTools = exports.generateMusicTool = exports.generateVideoTool = exports.generateImageTool = void 0;
+exports.SogniTools = exports.generateMusicTool = exports.videoToVideoTool = exports.soundToVideoTool = exports.generateVideoTool = exports.editImageTool = exports.generateImageTool = void 0;
 exports.buildSogniTools = buildSogniTools;
 exports.isSogniToolCall = isSogniToolCall;
 exports.parseToolCallArguments = parseToolCallArguments;
-/**
- * Built-in Sogni platform tool definitions for use with LLM tool calling.
- *
- * These tools allow the LLM to generate images, videos, and music
- * through the Sogni Supernet. Include them in your `tools` array when
- * calling `sogni.chat.completions.create()`.
- *
- * @example
- * ```typescript
- * import { SogniTools } from '@sogni-ai/sogni-client';
- *
- * const stream = await sogni.chat.completions.create({
- *   model: 'qwen3.6-35b-a3b-gguf-iq4xs',
- *   messages: [{ role: 'user', content: 'Generate an image of a sunset' }],
- *   tools: SogniTools.all,
- *   tool_choice: 'auto',
- *   stream: true,
- * });
- * ```
- */
-/** Tool definition: Generate an image using the Sogni Supernet */
-exports.generateImageTool = {
-    type: 'function',
-    function: {
-        name: 'sogni_generate_image',
-        description: 'Generate an image using AI image generation on the Sogni Supernet. Returns a URL to the generated image. Use this tool EVERY TIME the user asks to create, generate, draw, or make an image or picture. Do NOT generate URLs yourself — you MUST call this tool.',
-        parameters: {
-            type: 'object',
-            properties: {
-                prompt: {
-                    type: 'string',
-                    description: 'Detailed text description of the image to generate. Be specific about style, composition, lighting, colors, and subject matter.'
-                },
-                negative_prompt: {
-                    type: 'string',
-                    description: 'Things to avoid in the generated image (e.g., "blurry, low quality, distorted").'
-                },
-                width: {
-                    type: 'number',
-                    description: 'Image width in pixels. Must be a multiple of 16. Default: 1024. Max: 2048.'
-                },
-                height: {
-                    type: 'number',
-                    description: 'Image height in pixels. Must be a multiple of 16. Default: 1024. Max: 2048.'
-                },
-                model: {
-                    type: 'string',
-                    description: 'Image generation model to use.',
-                    enum: [
-                        'flux1-schnell-fp8',
-                        'flux2-dev_fp8',
-                        'chroma-v.46-flash_fp8',
-                        'z_image_turbo_bf16'
-                    ]
-                },
-                steps: {
-                    type: 'number',
-                    description: 'Number of inference steps. Higher = better quality but slower. Default depends on model (4-50).'
-                },
-                seed: {
-                    type: 'number',
-                    description: 'Random seed for reproducible generation. Use -1 for random.'
-                }
-            },
-            required: ['prompt']
-        }
+const sogniHostedTools_generated_json_1 = __importDefault(require("./sogniHostedTools.generated.json"));
+const modelRouting_1 = require("./modelRouting");
+const hostedTools = sogniHostedTools_generated_json_1.default.tools;
+function getHostedTool(name) {
+    const tool = hostedTools.find((candidate) => candidate.function.name === name);
+    if (!tool) {
+        throw new Error(`Missing hosted Sogni tool definition: ${name}`);
     }
-};
-/** Tool definition: Generate a video using the Sogni Supernet */
-exports.generateVideoTool = {
-    type: 'function',
-    function: {
-        name: 'sogni_generate_video',
-        description: 'Generate a short video using AI video generation on the Sogni Supernet. Returns a URL to the generated video. Use this tool EVERY TIME the user asks to create, generate, or make a video, clip, or animation. Do NOT generate URLs yourself — you MUST call this tool. Write the prompt as a cohesive mini-scene in present tense, describing motion, camera movement, lighting, and atmosphere in flowing prose.',
-        parameters: {
-            type: 'object',
-            properties: {
-                prompt: {
-                    type: 'string',
-                    description: 'Detailed text description of the video to generate. Write it as a flowing present-tense scene: describe the subject, action, camera movement, lighting, and atmosphere. Clear camera-to-subject relationship improves motion consistency. Be specific and vivid.'
-                },
-                negative_prompt: {
-                    type: 'string',
-                    description: 'Things to avoid in the generated video (e.g., "blurry, low quality, distorted, watermark").'
-                },
-                width: {
-                    type: 'number',
-                    description: 'Video width in pixels. Default: 1920. Standard resolutions: 1920x1088 (landscape), 1088x1920 (portrait), 1280x720.'
-                },
-                height: {
-                    type: 'number',
-                    description: 'Video height in pixels. Default: 1088. Must be a multiple of 16.'
-                },
-                duration: {
-                    type: 'number',
-                    description: 'Video duration in seconds. Range: 1-20. Default: 5.'
-                },
-                fps: {
-                    type: 'number',
-                    description: 'Frames per second. Default: 24. Range: 1-60.'
-                },
-                model: {
-                    type: 'string',
-                    description: 'Video generation model to use. Prefer LTX-2.3 text-to-video (t2v) models for best quality.'
-                },
-                seed: {
-                    type: 'number',
-                    description: 'Random seed for reproducible generation. Use -1 for random.'
-                }
-            },
-            required: ['prompt']
-        }
-    }
-};
-/** Tool definition: Generate music using the Sogni Supernet */
-exports.generateMusicTool = {
-    type: 'function',
-    function: {
-        name: 'sogni_generate_music',
-        description: 'Generate a music track using AI music generation on the Sogni Supernet. Returns a URL to the generated audio file. Use this tool EVERY TIME the user asks to create, generate, compose, or make music, a song, a beat, or audio. Do NOT generate URLs yourself — you MUST call this tool.',
-        parameters: {
-            type: 'object',
-            properties: {
-                prompt: {
-                    type: 'string',
-                    description: 'Description of the music to generate. Include genre, mood, tempo, instruments, and style. Can also include lyrics wrapped in [verse], [chorus], etc. tags.'
-                },
-                duration: {
-                    type: 'number',
-                    description: 'Duration of the generated music in seconds. Range: 10-600. Default: 30.'
-                },
-                bpm: {
-                    type: 'number',
-                    description: 'Beats per minute. Range: 30-300. Default: 120.'
-                },
-                keyscale: {
-                    type: 'string',
-                    description: 'Musical key and scale (e.g., "C major", "A minor", "F# minor", "Bb major"). Default: "C major".'
-                },
-                timesignature: {
-                    type: 'string',
-                    description: 'Time signature. "4" for 4/4, "3" for 3/4, "2" for 2/4. Default: "4".',
-                    enum: ['4', '3', '2']
-                },
-                model: {
-                    type: 'string',
-                    description: 'Music generation model. "ace_step_1.5_turbo" for fast/catchy, "ace_step_1.5_sft" for more control over lyrics.',
-                    enum: ['ace_step_1.5_turbo', 'ace_step_1.5_sft']
-                },
-                output_format: {
-                    type: 'string',
-                    description: 'Audio output format. Default: "mp3".',
-                    enum: ['mp3', 'flac', 'wav']
-                },
-                seed: {
-                    type: 'number',
-                    description: 'Random seed for reproducible generation. Use -1 for random.'
-                }
-            },
-            required: ['prompt']
-        }
+    return tool;
+}
+function cloneTool(tool) {
+    return structuredClone(tool);
+}
+function setModelEnum(tool, modelIds, description) {
+    if (modelIds.length === 0) {
+        return tool;
     }
-};
+    tool.function.parameters.properties.model = {
+        type: 'string',
+        description,
+        enum: modelIds
+    };
+    return tool;
+}
 /**
- * Collection of all Sogni platform tool definitions.
+ * Built-in Sogni platform tool definitions for use with LLM tool calling.
+ *
+ * These definitions are generated from the shared
+ * `@sogni/creative-agent` hosted tool backbone. The public SDK keeps a local
+ * generated copy so consumers do not need access to the private package.
  */
+exports.generateImageTool = getHostedTool('sogni_generate_image');
+exports.editImageTool = getHostedTool('sogni_edit_image');
+exports.generateVideoTool = getHostedTool('sogni_generate_video');
+exports.soundToVideoTool = getHostedTool('sogni_sound_to_video');
+exports.videoToVideoTool = getHostedTool('sogni_video_to_video');
+exports.generateMusicTool = getHostedTool('sogni_generate_music');
 exports.SogniTools = {
-    /** Generate an image */
     generateImage: exports.generateImageTool,
-    /** Generate a video */
+    editImage: exports.editImageTool,
     generateVideo: exports.generateVideoTool,
-    /** Generate music */
+    soundToVideo: exports.soundToVideoTool,
+    videoToVideo: exports.videoToVideoTool,
     generateMusic: exports.generateMusicTool,
-    /** All Sogni tools combined — convenience array for `tools` param */
     get all() {
-        return [exports.generateImageTool, exports.generateVideoTool, exports.generateMusicTool];
+        return [
+            exports.generateImageTool,
+            exports.editImageTool,
+            exports.generateVideoTool,
+            exports.soundToVideoTool,
+            exports.videoToVideoTool,
+            exports.generateMusicTool
+        ];
     }
 };
-/**
- * Build Sogni tool definitions with dynamically populated model enums
- * based on currently available models on the network.
- *
- * @param availableModels - Result of `sogni.projects.waitForModels()`. If omitted, returns
- *   the default tool definitions with static model lists.
- *
- * @example
- * ```typescript
- * import { buildSogniTools } from '@sogni-ai/sogni-client';
- *
- * const models = await sogni.projects.waitForModels();
- * const tools = buildSogniTools(models);
- *
- * const stream = await sogni.chat.completions.create({
- *   model: 'qwen3.6-35b-a3b-gguf-iq4xs',
- *   messages,
- *   tools,
- *   stream: true,
- * });
- * ```
- */
 function buildSogniTools(availableModels) {
     if (!availableModels || availableModels.length === 0) {
         return exports.SogniTools.all;
     }
-    const imageModels = availableModels.filter((m) => m.media === 'image').map((m) => m.id);
-    const videoModels = availableModels.filter((m) => m.media === 'video').map((m) => m.id);
-    const audioModels = availableModels.filter((m) => m.media === 'audio').map((m) => m.id);
-    const tools = [];
-    // Image tool — override model enum if image models are available
-    const imageTool = structuredClone(exports.generateImageTool);
-    if (imageModels.length > 0) {
-        imageTool.function.parameters.properties.model.enum = imageModels;
-    }
-    tools.push(imageTool);
-    // Video tool — override model enum if video models are available
-    const videoTool = structuredClone(exports.generateVideoTool);
-    if (videoModels.length > 0) {
-        videoTool.function.parameters.properties.model = {
-            type: 'string',
-            description: 'Video generation model to use. Choose a text-to-video (t2v) model.',
-            enum: videoModels
-        };
-    }
-    tools.push(videoTool);
-    // Music tool — override model enum if audio models are available
-    const musicTool = structuredClone(exports.generateMusicTool);
-    if (audioModels.length > 0) {
-        musicTool.function.parameters.properties.model = {
-            type: 'string',
-            description: 'Music generation model. "ace_step_1.5_turbo" for fast/catchy, "ace_step_1.5_sft" for more control over lyrics.',
-            enum: audioModels
-        };
-    }
-    tools.push(musicTool);
-    return tools;
+    const imageModels = availableModels
+        .filter((model) => model.media === 'image')
+        .map((model) => model.id);
+    const editImageModels = availableModels
+        .filter((model) => model.media === 'image' && (0, modelRouting_1.isEditImageModel)(model.id))
+        .map((model) => model.id);
+    const videoModels = (0, modelRouting_1.filterVideoModelsByWorkflow)(availableModels, ['t2v', 'i2v']);
+    const soundToVideoModels = (0, modelRouting_1.filterVideoModelsByWorkflow)(availableModels, ['s2v', 'ia2v', 'a2v']);
+    const videoToVideoModels = (0, modelRouting_1.filterVideoModelsByWorkflow)(availableModels, [
+        'animate-move',
+        'animate-replace',
+        'v2v'
+    ]);
+    const audioModels = availableModels
+        .filter((model) => model.media === 'audio')
+        .map((model) => model.id);
+    return [
+        setModelEnum(cloneTool(exports.generateImageTool), imageModels, 'Image generation model to use.'),
+        setModelEnum(cloneTool(exports.editImageTool), editImageModels, 'Image editing model to use. These models support reference-guided editing.'),
+        setModelEnum(cloneTool(exports.generateVideoTool), videoModels, 'Video generation model to use. Prefer t2v models for text-only generation and i2v models when reference images are supplied.'),
+        setModelEnum(cloneTool(exports.soundToVideoTool), soundToVideoModels, 'Audio-driven video model to use.'),
+        setModelEnum(cloneTool(exports.videoToVideoTool), videoToVideoModels, 'Video-to-video model to use.'),
+        setModelEnum(cloneTool(exports.generateMusicTool), audioModels, 'Music generation model to use.')
+    ];
 }
-/**
- * Check if a tool call is a Sogni platform tool.
- */
 function isSogniToolCall(toolCall) {
     return toolCall.function.name.startsWith('sogni_');
 }
-/**
- * Parse arguments from a tool call's JSON string.
- * Returns the parsed object or an empty object if parsing fails.
- */
 function parseToolCallArguments(toolCall) {
     try {
         return JSON.parse(toolCall.function.arguments);

package/dist/Chat/tools.js.map

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

package/dist/Chat/types.d.ts

@@ -31,6 +31,30 @@ export type ToolChoice = 'auto' | 'none' | 'required' | {
         name: string;
     };
 };
+export type SogniToolsMode = boolean | 'creative-agent' | 'creative-tools' | 'rich';
+/**
+ * OpenAI-compatible structured-output controls. Forwarded to the worker
+ * unchanged; honored natively by llama-server (compiles JSON Schema → GBNF
+ * internally) and vLLM (`xgrammar` / `outlines`). Per-request opt-in — when
+ * omitted, the model generates without constraint.
+ */
+export type ChatResponseFormat = {
+    type: 'text';
+} | {
+    type: 'json_object';
+} | {
+    type: 'json_schema';
+    json_schema: {
+        /** Identifier for cached grammar reuse. */
+        name: string;
+        /** JSON Schema describing the required output shape. */
+        schema: Record<string, unknown>;
+        /** When true, only fields named in `schema` may appear. Default: false. */
+        strict?: boolean;
+        /** Optional description shown to the model. */
+        description?: string;
+    };
+};
 /** Text content part for multimodal messages. */
 export interface TextContentPart {
     type: 'text';
@@ -40,7 +64,7 @@ export interface TextContentPart {
 export interface ImageUrlContentPart {
     type: 'image_url';
     image_url: {
-        /** Supports http(s) URLs and data URIs (e.g., `data:image/jpeg;base64,...`). */
+        /** Supports inline base64-encoded JPEG or PNG data URIs only (e.g., `data:image/jpeg;base64,...`) for vision-model inputs. Max 20 images per request, 10MB each, longest side 1024px. */
         url: string;
         /** Controls how the model processes the image: 'auto' (default), 'low' (faster), 'high' (more detail). */
         detail?: 'auto' | 'low' | 'high';
@@ -58,6 +82,8 @@ export interface ChatMessage {
 export interface ChatCompletionParams {
     model: string;
     messages: ChatMessage[];
+    /** Optional source label for this request. Defaults to the client appSource when configured. */
+    appSource?: string;
     max_tokens?: number;
     temperature?: number;
     top_p?: number;
@@ -74,6 +100,19 @@ export interface ChatCompletionParams {
     tools?: ToolDefinition[];
     /** Controls which (if any) tool is called by the model. */
     tool_choice?: ToolChoice;
+    /**
+     * Ask the Sogni API to inject server-side media-generation tool families.
+     * `true` or `'creative-tools'` injects the hosted creative media/planning tool family.
+     * `'rich'` is accepted as a legacy alias for `'creative-tools'`.
+     * `'creative-agent'` adds hosted workflow-control and asset-manifest tools.
+     */
+    sogni_tools?: SogniToolsMode;
+    /**
+     * When `sogni_tools` is enabled, ask the Sogni API to execute requested Sogni
+     * tools server-side before returning the chat response. This is separate from
+     * the SDK-local `autoExecuteTools` loop.
+     */
+    sogni_tool_execution?: boolean;
     /**
      * Control thinking/reasoning mode for supported models (e.g. Qwen3/3.5).
      * When `false`, sends `chat_template_kwargs: { enable_thinking: false }` so
@@ -83,6 +122,12 @@ export interface ChatCompletionParams {
     think?: boolean;
     /** Hint for server-side preset selection. */
     taskProfile?: 'general' | 'coding' | 'reasoning';
+    /**
+     * Constrain output structure (OpenAI-compatible). Most useful on tool-call
+     * rounds where the model must emit a specific argument shape — eliminates
+     * JSON drift on quantized models. Forwarded to the worker unchanged.
+     */
+    response_format?: ChatResponseFormat;
     /**
      * Automatically execute Sogni tool calls (image/video/music generation) when the
      * model requests them. The SDK handles the full multi-round tool calling loop:
@@ -114,6 +159,7 @@ export interface ChatRequestMessage {
     type: 'llm';
     model: string;
     messages: ChatMessage[];
+    appSource?: string;
     max_tokens?: number;
     temperature?: number;
     top_p?: number;
@@ -127,9 +173,13 @@ export interface ChatRequestMessage {
     tokenType?: 'sogni' | 'spark';
     tools?: ToolDefinition[];
     tool_choice?: ToolChoice;
+    sogni_tools?: SogniToolsMode;
+    sogni_tool_execution?: boolean;
     taskProfile?: 'general' | 'coding' | 'reasoning';
     /** Per-request chat template arguments (e.g. `{ enable_thinking: false }` for llama.cpp). */
     chat_template_kwargs?: Record<string, unknown>;
+    /** Per-request structured-output constraint (OpenAI-compatible). */
+    response_format?: ChatResponseFormat;
 }
 export interface ChatCompletionChunk {
     jobID: string;
@@ -161,6 +211,44 @@ export interface ChatCompletionResult {
     /** History of tool calling rounds when `autoExecuteTools` was used. */
     toolHistory?: ToolHistoryEntry[];
 }
+export interface HostedChatCompletionMessage {
+    role: 'system' | 'user' | 'assistant' | 'tool';
+    content: string | null;
+    tool_calls?: ToolCall[];
+    tool_call_id?: string;
+}
+export interface HostedChatCompletionChoice {
+    index: number;
+    message: HostedChatCompletionMessage;
+    finish_reason: string | null;
+}
+export interface HostedCreativeWorkflowReference {
+    workflowId: string;
+    status: string;
+    url: string;
+    eventsUrl: string;
+    streamUrl: string;
+}
+export interface HostedChatCompletionResult {
+    id: string;
+    object: 'chat.completion';
+    created: number;
+    model: string;
+    choices: HostedChatCompletionChoice[];
+    usage?: TokenUsage;
+    creative_workflows?: HostedCreativeWorkflowReference[];
+    sogni_tool_results?: Record<string, unknown>[];
+}
+export type HostedChatCompletionParams = Omit<ChatCompletionParams, 'stream' | 'autoExecuteTools' | 'onToolCall' | 'onToolProgress' | 'maxToolRounds'> & {
+    stream?: false;
+    token_type?: 'sogni' | 'spark' | 'auto';
+    app_source?: string;
+    chat_template_kwargs?: Record<string, unknown>;
+    media_references?: unknown[];
+    mediaReferences?: unknown[];
+    api_media_references?: unknown[];
+    apiMediaReferences?: unknown[];
+};
 export interface ChatJobStateEvent {
     jobID: string;
     type: string;
@@ -176,6 +264,7 @@ export interface LLMParamConstraint {
     max: number;
     decimals?: number;
     default: number;
+    thinkingComplexDefault?: number;
 }
 /** Recommended sampling defaults for a specific thinking mode. */
 export interface LLMSamplingDefaults {
@@ -301,7 +390,7 @@ export interface ToolExecutionOptions {
      * complete within this time, the tool call will fail with a timeout error
      * and the project will be canceled.
      *
-     * Default: 600000 (10 minutes).
+     * Default: 1800000 (30 minutes).
      */
     timeout?: number;
 }

package/dist/CreativeWorkflows/index.d.ts

@@ -0,0 +1,23 @@
+import ApiGroup, { ApiConfig } from '../ApiGroup';
+import { CreativeWorkflowRecord, CreativeWorkflowEvent, CreativeWorkflowSseEvent, ListCreativeWorkflowOptions, StartCreativeWorkflowOptions, StartCreativeWorkflowParams, StartHostedToolSequenceWorkflowInput, StartImageToVideoWorkflowInput, StreamCreativeWorkflowEventsOptions } from './types';
+export declare function parseCreativeWorkflowSseChunk(chunk: string): CreativeWorkflowSseEvent[];
+declare class CreativeWorkflowsApi extends ApiGroup {
+    constructor(config: ApiConfig);
+    start(params: StartCreativeWorkflowParams, options?: StartCreativeWorkflowOptions): Promise<CreativeWorkflowRecord>;
+    startImageToVideo(input: StartImageToVideoWorkflowInput, options?: StartCreativeWorkflowOptions & {
+        tokenType?: StartCreativeWorkflowParams['tokenType'];
+    }): Promise<CreativeWorkflowRecord>;
+    startHostedToolSequence(input: StartHostedToolSequenceWorkflowInput, options?: StartCreativeWorkflowOptions & {
+        tokenType?: StartCreativeWorkflowParams['tokenType'];
+    }): Promise<CreativeWorkflowRecord>;
+    list(options?: ListCreativeWorkflowOptions): Promise<CreativeWorkflowRecord[]>;
+    get(workflowId: string): Promise<CreativeWorkflowRecord>;
+    events(workflowId: string): Promise<CreativeWorkflowEvent[]>;
+    cancel(workflowId: string): Promise<CreativeWorkflowRecord>;
+    streamEvents(workflowId: string, options?: StreamCreativeWorkflowEventsOptions): AsyncIterableIterator<CreativeWorkflowSseEvent>;
+    private request;
+    private fetch;
+    private toApiError;
+}
+export default CreativeWorkflowsApi;
+export * from './types';