@synova-cloud/sdk 1.7.0 → 1.9.0

package/dist/index.js

@@ -105,7 +105,7 @@ var ValidationSynovaError = class extends SynovaError {
 };
 
 // src/version.ts
-var SDK_VERSION = "1.7.0" ;
+var SDK_VERSION = "1.9.0" ;
 
 // src/utils/http.ts
 var HttpClient = class {
@@ -340,7 +340,9 @@ var SCHEMA_METADATA_KEYS = {
   // Array constraints
   MIN_ITEMS: "synova:schema:minItems",
   MAX_ITEMS: "synova:schema:maxItems",
-  UNIQUE_ITEMS: "synova:schema:uniqueItems"
+  UNIQUE_ITEMS: "synova:schema:uniqueItems",
+  // Object constraints
+  ADDITIONAL_PROPERTIES: "synova:schema:additionalProperties"
 };
 function createMetadataDecorator(key, value) {
   return function(target, propertyKey) {
@@ -731,6 +733,12 @@ var ClassSchema = class {
       propertyName
     );
     if (uniqueItems) schema.uniqueItems = uniqueItems;
+    const additionalProperties = getSchemaMetadata(
+      SCHEMA_METADATA_KEYS.ADDITIONAL_PROPERTIES,
+      prototype,
+      propertyName
+    );
+    if (additionalProperties !== void 0) schema.additionalProperties = additionalProperties;
   }
   /**
    * Get required properties (properties without @IsOptional)
@@ -818,6 +826,7 @@ var PromptsResource = class {
     if (options.metadata !== void 0) body.metadata = options.metadata;
     if (options.parameters !== void 0) body.parameters = options.parameters;
     if (options.responseSchema !== void 0) body.responseSchema = options.responseSchema;
+    if (options.sessionId !== void 0) body.sessionId = options.sessionId;
     const response = await this.http.request({
       method: "POST",
       path: `/api/v1/prompts/${promptId}/run`,
@@ -1002,6 +1011,137 @@ var FilesResource = class {
   }
 };
 
+// src/resources/spans.ts
+var SpansResource = class {
+  constructor(http) {
+    this.http = http;
+  }
+  /**
+   * Create a new span within a trace
+   *
+   * @param traceId - The trace ID to create span in
+   * @param options - Span creation options
+   * @returns Created span
+   */
+  async create(traceId, options) {
+    const body = {
+      type: options.type
+    };
+    if (options.parentSpanId !== void 0) body.parentSpanId = options.parentSpanId;
+    if (options.name !== void 0) body.name = options.name;
+    if (options.input !== void 0) body.input = options.input;
+    if (options.toolName !== void 0) body.toolName = options.toolName;
+    if (options.toolArguments !== void 0) body.toolArguments = options.toolArguments;
+    if (options.metadata !== void 0) body.metadata = options.metadata;
+    return this.http.request({
+      method: "POST",
+      path: `/api/v1/traces/${traceId}/spans`,
+      body
+    });
+  }
+  /**
+   * End/complete a span
+   *
+   * @param spanId - The span ID to end
+   * @param options - Span end options
+   * @returns Updated span
+   */
+  async end(spanId, options) {
+    const body = {};
+    if (options?.status !== void 0) body.status = options.status;
+    if (options?.level !== void 0) body.level = options.level;
+    if (options?.statusMessage !== void 0) body.statusMessage = options.statusMessage;
+    if (options?.output !== void 0) body.output = options.output;
+    if (options?.toolResult !== void 0) body.toolResult = options.toolResult;
+    if (options?.durationMs !== void 0) body.durationMs = options.durationMs;
+    return this.http.request({
+      method: "PATCH",
+      path: `/api/v1/spans/${spanId}`,
+      body
+    });
+  }
+  /**
+   * Wrap an async function with automatic span tracking
+   *
+   * @param options - Span options (traceId, type, name, etc.)
+   * @param input - Input data to record in span
+   * @param fn - Async function to execute
+   * @returns Result of the function
+   *
+   * @example
+   * ```ts
+   * const result = await client.spans.wrap(
+   *   { traceId: 'trc_123', type: 'retriever', name: 'vector_search' },
+   *   { query: 'how to...', topK: 5 },
+   *   async () => vectorDb.search(query),
+   * );
+   * ```
+   */
+  async wrap(options, input, fn) {
+    const span = await this.create(options.traceId, {
+      type: options.type,
+      name: options.name,
+      parentSpanId: options.parentSpanId,
+      input,
+      metadata: options.metadata
+    });
+    try {
+      const result = await fn();
+      await this.end(span.id, {
+        status: "completed",
+        output: result
+      });
+      return result;
+    } catch (error) {
+      await this.end(span.id, {
+        status: "error",
+        statusMessage: error instanceof Error ? error.message : String(error)
+      });
+      throw error;
+    }
+  }
+  /**
+   * Wrap a tool function with automatic span tracking
+   *
+   * @param options - Tool span options (traceId, toolName, etc.)
+   * @param args - Tool arguments to record
+   * @param fn - Tool function to execute
+   * @returns Result of the tool
+   *
+   * @example
+   * ```ts
+   * const weather = await client.spans.wrapTool(
+   *   { traceId: 'trc_123', toolName: 'fetch_weather', parentSpanId: 'spn_abc' },
+   *   { city: 'NYC' },
+   *   async (args) => fetchWeather(args.city),
+   * );
+   * ```
+   */
+  async wrapTool(options, args, fn) {
+    const span = await this.create(options.traceId, {
+      type: "tool",
+      toolName: options.toolName,
+      toolArguments: args,
+      parentSpanId: options.parentSpanId,
+      metadata: options.metadata
+    });
+    try {
+      const result = await fn(args);
+      await this.end(span.id, {
+        status: "completed",
+        toolResult: result
+      });
+      return result;
+    } catch (error) {
+      await this.end(span.id, {
+        status: "error",
+        statusMessage: error instanceof Error ? error.message : String(error)
+      });
+      throw error;
+    }
+  }
+};
+
 // src/client.ts
 var DEFAULT_BASE_URL = "https://api.synova.cloud";
 var DEFAULT_TIMEOUT = 3e4;
@@ -1022,6 +1162,7 @@ var SynovaCloudSdk = class {
   prompts;
   models;
   files;
+  spans;
   http;
   /**
    * Create a new Synova Cloud SDK client
@@ -1050,6 +1191,7 @@ var SynovaCloudSdk = class {
     this.prompts = new PromptsResource(this.http);
     this.models = new ModelsResource(this.http);
     this.files = new FilesResource(this.http);
+    this.spans = new SpansResource(this.http);
   }
 };