@synova-cloud/sdk 1.3.1 → 1.5.0

package/dist/index.cjs

@@ -73,7 +73,7 @@ var NetworkSynovaError = class extends SynovaError {
 };
 
 // src/version.ts
-var SDK_VERSION = "1.3.1" ;
+var SDK_VERSION = "1.5.0" ;
 
 // src/utils/http.ts
 var HttpClient = class {

package/dist/index.d.cts

@@ -2,6 +2,23 @@ type TSynovaMessageRole = 'system' | 'user' | 'assistant' | 'tool';
 type TSynovaResponseType = 'message' | 'tool_calls' | 'image' | 'audio' | 'error';
 type TSynovaModelType = 'text' | 'image';
 type TSynovaUsageType = 'tokens' | 'images' | 'time';
+type TSynovaJsonSchemaType = 'string' | 'number' | 'integer' | 'boolean' | 'object' | 'array';
+interface ISynovaJsonSchema {
+    /** Schema type */
+    type?: TSynovaJsonSchemaType;
+    /** Description of the field */
+    description?: string;
+    /** Allowed values (for enum-like fields) */
+    enum?: (string | number | boolean | null)[];
+    /** Schema for array items (when type='array') */
+    items?: ISynovaJsonSchema;
+    /** Object properties (when type='object') */
+    properties?: Record<string, ISynovaJsonSchema>;
+    /** Required property names (when type='object') */
+    required?: string[];
+    /** Whether additional properties are allowed (when type='object') */
+    additionalProperties?: boolean;
+}
 interface ISynovaLogger {
     debug: (message: string, ...args: unknown[]) => void;
     info: (message: string, ...args: unknown[]) => void;
@@ -100,7 +117,7 @@ interface ISynovaExecuteOptions {
     /** Model parameters (temperature, maxTokens, topP, topK, etc.) */
     parameters?: Record<string, unknown>;
     /** JSON Schema for structured output */
-    responseSchema?: Record<string, unknown>;
+    responseSchema?: ISynovaJsonSchema;
 }
 interface ISynovaExecutionUsage {
     /** Usage type: 'tokens' for LLM, 'images' for image generation, 'time' for time-based billing */
@@ -118,13 +135,40 @@ interface ISynovaExecutionUsage {
     /** Prediction time in seconds (when type='time') */
     predictTimeSeconds?: number;
 }
+interface ISynovaProviderResponse {
+    /** HTTP status code from the LLM provider */
+    statusCode?: number;
+    /** Error message from the LLM provider */
+    message?: string;
+}
+interface ISynovaExecutionErrorDetails {
+    /** Model used for the execution */
+    model?: string;
+    /** API key ID used for the execution */
+    apiKeyId?: string;
+    /** API key label (human-readable name) */
+    apiKeyLabel?: string;
+    /** Prompt ID (if execution was via prompt) */
+    promptId?: string;
+    /** Prompt version (if execution was via prompt) */
+    promptVersion?: string;
+    /** Execution log ID for debugging */
+    executionLogId?: string;
+    /** Input tokens count (for CONTEXT_TOO_LONG errors) */
+    inputTokens?: number;
+    /** Model context window limit (for CONTEXT_TOO_LONG errors) */
+    contextLimit?: number;
+}
 interface ISynovaExecutionError {
     code: string;
     message: string;
     provider?: string;
     retryable: boolean;
     retryAfterMs?: number;
-    details?: unknown;
+    /** Raw response from the LLM provider's API */
+    providerResponse?: ISynovaProviderResponse;
+    /** Our context details */
+    details?: ISynovaExecutionErrorDetails;
 }
 interface ISynovaFileThumbnails {
     /** Small thumbnail URL (120px width) */
@@ -720,4 +764,4 @@ declare class NetworkSynovaError extends SynovaError {
     constructor(message: string, cause?: Error);
 }
 
-export { ApiSynovaError, AuthSynovaError, type ISynovaAzureConfig, type ISynovaConfig, type ISynovaCreateLlmProviderKeyOptions, type ISynovaExecuteOptions, type ISynovaExecuteResponse, type ISynovaExecutionError, type ISynovaExecutionUsage, type ISynovaFileAttachment, type ISynovaFileThumbnails, type ISynovaGetPromptOptions, type ISynovaListModelsOptions, type ISynovaLlmProviderKey, type ISynovaLlmProviderKeyListResponse, type ISynovaLogger, type ISynovaMessage, type ISynovaModel, type ISynovaModelCapabilities, type ISynovaModelLimits, type ISynovaModelPricing, type ISynovaModelsResponse, type ISynovaPrompt, type ISynovaPromptVariable, type ISynovaProvider, type ISynovaRetryConfig, type ISynovaToolCall, type ISynovaToolResult, type ISynovaUploadOptions, type ISynovaUploadResponse, type ISynovaUploadedFile, NetworkSynovaError, NotFoundSynovaError, RateLimitSynovaError, ServerSynovaError, SynovaCloudSdk, SynovaError, type TSynovaLlmProvider, type TSynovaMessageRole, type TSynovaModelType, type TSynovaResponseType, type TSynovaRetryStrategy, type TSynovaUsageType, TimeoutSynovaError };
+export { ApiSynovaError, AuthSynovaError, type ISynovaAzureConfig, type ISynovaConfig, type ISynovaCreateLlmProviderKeyOptions, type ISynovaExecuteOptions, type ISynovaExecuteResponse, type ISynovaExecutionError, type ISynovaExecutionErrorDetails, type ISynovaExecutionUsage, type ISynovaFileAttachment, type ISynovaFileThumbnails, type ISynovaGetPromptOptions, type ISynovaListModelsOptions, type ISynovaLlmProviderKey, type ISynovaLlmProviderKeyListResponse, type ISynovaLogger, type ISynovaMessage, type ISynovaModel, type ISynovaModelCapabilities, type ISynovaModelLimits, type ISynovaModelPricing, type ISynovaModelsResponse, type ISynovaPrompt, type ISynovaPromptVariable, type ISynovaProvider, type ISynovaProviderResponse, type ISynovaRetryConfig, type ISynovaToolCall, type ISynovaToolResult, type ISynovaUploadOptions, type ISynovaUploadResponse, type ISynovaUploadedFile, NetworkSynovaError, NotFoundSynovaError, RateLimitSynovaError, ServerSynovaError, SynovaCloudSdk, SynovaError, type TSynovaLlmProvider, type TSynovaMessageRole, type TSynovaModelType, type TSynovaResponseType, type TSynovaRetryStrategy, type TSynovaUsageType, TimeoutSynovaError };

package/dist/index.d.ts

@@ -2,6 +2,23 @@ type TSynovaMessageRole = 'system' | 'user' | 'assistant' | 'tool';
 type TSynovaResponseType = 'message' | 'tool_calls' | 'image' | 'audio' | 'error';
 type TSynovaModelType = 'text' | 'image';
 type TSynovaUsageType = 'tokens' | 'images' | 'time';
+type TSynovaJsonSchemaType = 'string' | 'number' | 'integer' | 'boolean' | 'object' | 'array';
+interface ISynovaJsonSchema {
+    /** Schema type */
+    type?: TSynovaJsonSchemaType;
+    /** Description of the field */
+    description?: string;
+    /** Allowed values (for enum-like fields) */
+    enum?: (string | number | boolean | null)[];
+    /** Schema for array items (when type='array') */
+    items?: ISynovaJsonSchema;
+    /** Object properties (when type='object') */
+    properties?: Record<string, ISynovaJsonSchema>;
+    /** Required property names (when type='object') */
+    required?: string[];
+    /** Whether additional properties are allowed (when type='object') */
+    additionalProperties?: boolean;
+}
 interface ISynovaLogger {
     debug: (message: string, ...args: unknown[]) => void;
     info: (message: string, ...args: unknown[]) => void;
@@ -100,7 +117,7 @@ interface ISynovaExecuteOptions {
     /** Model parameters (temperature, maxTokens, topP, topK, etc.) */
     parameters?: Record<string, unknown>;
     /** JSON Schema for structured output */
-    responseSchema?: Record<string, unknown>;
+    responseSchema?: ISynovaJsonSchema;
 }
 interface ISynovaExecutionUsage {
     /** Usage type: 'tokens' for LLM, 'images' for image generation, 'time' for time-based billing */
@@ -118,13 +135,40 @@ interface ISynovaExecutionUsage {
     /** Prediction time in seconds (when type='time') */
     predictTimeSeconds?: number;
 }
+interface ISynovaProviderResponse {
+    /** HTTP status code from the LLM provider */
+    statusCode?: number;
+    /** Error message from the LLM provider */
+    message?: string;
+}
+interface ISynovaExecutionErrorDetails {
+    /** Model used for the execution */
+    model?: string;
+    /** API key ID used for the execution */
+    apiKeyId?: string;
+    /** API key label (human-readable name) */
+    apiKeyLabel?: string;
+    /** Prompt ID (if execution was via prompt) */
+    promptId?: string;
+    /** Prompt version (if execution was via prompt) */
+    promptVersion?: string;
+    /** Execution log ID for debugging */
+    executionLogId?: string;
+    /** Input tokens count (for CONTEXT_TOO_LONG errors) */
+    inputTokens?: number;
+    /** Model context window limit (for CONTEXT_TOO_LONG errors) */
+    contextLimit?: number;
+}
 interface ISynovaExecutionError {
     code: string;
     message: string;
     provider?: string;
     retryable: boolean;
     retryAfterMs?: number;
-    details?: unknown;
+    /** Raw response from the LLM provider's API */
+    providerResponse?: ISynovaProviderResponse;
+    /** Our context details */
+    details?: ISynovaExecutionErrorDetails;
 }
 interface ISynovaFileThumbnails {
     /** Small thumbnail URL (120px width) */
@@ -720,4 +764,4 @@ declare class NetworkSynovaError extends SynovaError {
     constructor(message: string, cause?: Error);
 }
 
-export { ApiSynovaError, AuthSynovaError, type ISynovaAzureConfig, type ISynovaConfig, type ISynovaCreateLlmProviderKeyOptions, type ISynovaExecuteOptions, type ISynovaExecuteResponse, type ISynovaExecutionError, type ISynovaExecutionUsage, type ISynovaFileAttachment, type ISynovaFileThumbnails, type ISynovaGetPromptOptions, type ISynovaListModelsOptions, type ISynovaLlmProviderKey, type ISynovaLlmProviderKeyListResponse, type ISynovaLogger, type ISynovaMessage, type ISynovaModel, type ISynovaModelCapabilities, type ISynovaModelLimits, type ISynovaModelPricing, type ISynovaModelsResponse, type ISynovaPrompt, type ISynovaPromptVariable, type ISynovaProvider, type ISynovaRetryConfig, type ISynovaToolCall, type ISynovaToolResult, type ISynovaUploadOptions, type ISynovaUploadResponse, type ISynovaUploadedFile, NetworkSynovaError, NotFoundSynovaError, RateLimitSynovaError, ServerSynovaError, SynovaCloudSdk, SynovaError, type TSynovaLlmProvider, type TSynovaMessageRole, type TSynovaModelType, type TSynovaResponseType, type TSynovaRetryStrategy, type TSynovaUsageType, TimeoutSynovaError };
+export { ApiSynovaError, AuthSynovaError, type ISynovaAzureConfig, type ISynovaConfig, type ISynovaCreateLlmProviderKeyOptions, type ISynovaExecuteOptions, type ISynovaExecuteResponse, type ISynovaExecutionError, type ISynovaExecutionErrorDetails, type ISynovaExecutionUsage, type ISynovaFileAttachment, type ISynovaFileThumbnails, type ISynovaGetPromptOptions, type ISynovaListModelsOptions, type ISynovaLlmProviderKey, type ISynovaLlmProviderKeyListResponse, type ISynovaLogger, type ISynovaMessage, type ISynovaModel, type ISynovaModelCapabilities, type ISynovaModelLimits, type ISynovaModelPricing, type ISynovaModelsResponse, type ISynovaPrompt, type ISynovaPromptVariable, type ISynovaProvider, type ISynovaProviderResponse, type ISynovaRetryConfig, type ISynovaToolCall, type ISynovaToolResult, type ISynovaUploadOptions, type ISynovaUploadResponse, type ISynovaUploadedFile, NetworkSynovaError, NotFoundSynovaError, RateLimitSynovaError, ServerSynovaError, SynovaCloudSdk, SynovaError, type TSynovaLlmProvider, type TSynovaMessageRole, type TSynovaModelType, type TSynovaResponseType, type TSynovaRetryStrategy, type TSynovaUsageType, TimeoutSynovaError };

package/dist/index.js

@@ -71,7 +71,7 @@ var NetworkSynovaError = class extends SynovaError {
 };
 
 // src/version.ts
-var SDK_VERSION = "1.3.1" ;
+var SDK_VERSION = "1.5.0" ;
 
 // src/utils/http.ts
 var HttpClient = class {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@synova-cloud/sdk",
-  "version": "1.3.1",
+  "version": "1.5.0",
   "description": "Official Node.js SDK for Synova Cloud API",
   "type": "module",
   "main": "./dist/index.cjs",