@tryvira/sdk 0.1.30 → 0.1.32

package/README.md

@@ -7,7 +7,7 @@ approved behavior, and resolve it at runtime.
 ## Install
 
 ```bash
-npm install @tryvira/sdk@0.1.29
+npm install @tryvira/sdk@0.1.31
 ```
 
 Configure the organization, project, and environment for every request. Keep the API
@@ -112,17 +112,10 @@ const imported = await vira.importPack({
 const packId = String(imported.body.pack.id);
 await vira.installPack(packId, { variables: {} });
 const evaluation = await vira.evaluatePack(packId, {
-  candidateExecutionRequired: true,
-  rubric: {
-    taskCorrectness: 1,
-    behaviorCompliance: 1,
-    groundedness: 1,
-    safetyAuthority: 1,
-    usefulSpecificity: 1,
-  },
+  evaluationId: "evaluation-from-vira-provider",
   idempotencyKey: "pack:evaluate:support.billing:1.0.0",
 });
-if (evaluation.body.passed !== true) throw new Error("Candidate evaluation failed");
+if (evaluation.body.pack?.status !== "EVALUATED") throw new Error("Pack evaluation was not accepted");
 await vira.approvePack(packId);
 await vira.releasePack(packId);
 ```

package/dist/index.js

@@ -197,6 +197,11 @@ var ViraClient = class {
   trace(event, options = {}) {
     return this.observe({ ...event, eventType: "model.response" }, options);
   }
+  searchRuntimeTraces(query = {}) {
+    const params = new URLSearchParams();
+    for (const [key, value] of Object.entries(query)) if (value !== void 0) params.set(key, String(value));
+    return this.request({ method: "GET", path: `/v1/runtime/traces/search${params.size ? `?${params.toString()}` : ""}` });
+  }
   outcome(event, options = {}) {
     return this.observe({ ...event, eventType: "business.outcome" }, options);
   }
@@ -716,10 +721,12 @@ var ViraClient = class {
       { idempotencyKey: options.idempotencyKey }
     );
   }
-  /** Start a persisted OFF/current-ON (and optional candidate-ON) comparison. */
+  /** Request a server-executed OFF/current-ON/candidate-ON comparison.
+   * The server owns arm execution and receipts; callers cannot submit outputs.
+   */
   startComparativeEvaluation(input, options = {}) {
-    if (!Array.isArray(input.comparativeCases) || input.comparativeCases.length === 0)
-      throw new Error("SDK_COMPARATIVE_CASES_REQUIRED");
+    if (!input.comparisonPlan || typeof input.comparisonPlan !== "object")
+      throw new Error("SDK_COMPARISON_PLAN_REQUIRED");
     return this.startEvaluation(input, options);
   }
   evaluateQuality(input, options = {}) {

package/dist/js-client.d.ts

@@ -176,6 +176,12 @@ export declare class ViraClient {
     }, options?: {
         idempotencyKey?: string;
     }): Promise<ViraResponse<ClientBody> | null>;
+    searchRuntimeTraces(query?: {
+        limit?: number;
+        cursor?: string;
+        query?: string;
+        event?: string;
+    }): Promise<ViraResponse<ClientBody> | null>;
     outcome(event: {
         eventId: string;
         aiSystemId: string;
@@ -417,9 +423,11 @@ export declare class ViraClient {
     startEvaluation(input: ClientBody, options?: {
         idempotencyKey?: string;
     }): Promise<ViraResponse<ClientBody> | null>;
-    /** Start a persisted OFF/current-ON (and optional candidate-ON) comparison. */
+    /** Request a server-executed OFF/current-ON/candidate-ON comparison.
+     * The server owns arm execution and receipts; callers cannot submit outputs.
+     */
     startComparativeEvaluation(input: ClientBody & {
-        comparativeCases: readonly ClientBody[];
+        comparisonPlan: ClientBody;
     }, options?: {
         idempotencyKey?: string;
     }): Promise<ViraResponse<ClientBody> | null>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tryvira/sdk",
-  "version": "0.1.30",
+  "version": "0.1.32",
   "description": "Typed Vira SDK for connect-once, observation and governed runtime execution.",
   "keywords": ["vira", "ai-governance", "ai-runtime", "semantic-routing"],
   "engines": {"node": ">=20"},