@tryvira/sdk 0.1.22 → 0.1.24

package/LICENSE

@@ -1,21 +1,21 @@
-MIT License
-
-Copyright (c) 2026 Vira / Esad Türkel
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+MIT License
+
+Copyright (c) 2026 Vira / Esad Türkel
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,90 +1,94 @@
-# @tryvira/sdk
-
-MIT-licensed client library. The Vira service, application, and backend remain
-proprietary and are governed separately.
-
-Typed JavaScript/TypeScript client for Vira's scoped control and runtime APIs.
-
-## Install
-
-```bash
-npm install @tryvira/sdk
-```
-
-The client sends requests to Vira; it does not execute tools locally or create a second
-authority/telemetry store. Use a customer API key for hosted deployments and a local
-development key only with the local stack.
-
-## Connect and record an observation
-
-```ts
-import { ViraClient } from '@tryvira/sdk';
-
-const vira = new ViraClient({
-  baseUrl: process.env.VIRA_CONTROL_URL ?? 'http://127.0.0.1:4185',
-  apiKey: process.env.VIRA_API_KEY,
-});
-
-const connected = await vira.connectOnce({
-  name: 'my-agent', systemType: 'custom-agent',
-  organizationId: 'org', projectId: 'project', environmentId: 'local',
-  adapterType: 'custom-node', adapterVersion: '1',
-});
-
-const systemId = String(connected?.body.system?.id);
-const connectionId = String(connected?.body.connection?.id);
-await vira.observe({
-  eventId: `event-${Date.now()}`,
-  eventType: 'model.response',
-  aiSystemId: systemId,
-  connectionId,
-  payload: { message: 'A model response was produced.' },
-}, { idempotencyKey: `event-${Date.now()}` });
-```
-
-## Semantic and runtime resolution
-
-Semantic resolution finds an eligible governed target. Runtime resolution is the effectful
-boundary and therefore requires a released behavior point, scope and idempotency key.
-
-```ts
-const semantic = await vira.resolveSemantic({
-  input: 'answer a customer billing question',
-  profile: { domain: 'support' },
-});
-
-const runtime = await vira.resolveRuntime({
-  behaviorPoint: 'support.answer',
-  executionBoundary: { organizationId: 'org', projectId: 'project', environmentId: 'local' },
-  idempotencyKey: 'runtime-request-001',
-});
-```
-
-Do not treat a semantic result as authorization. The server remains the authority and may
-abstain, deny or require a released revision.
-
-## Packs and Strategy executions
-
-The normal pack lifecycle is import → install → evaluate → approve → release. Strategy
-execution starts only from an immutable, released artifact and can be continued with
-state/references when it reaches `WAITING_USER` or `WAITING_HOST`.
-
-```ts
-const packs = await vira.listPacks();
-const imported = await vira.importPack({
-  manifest: { id: 'example.pack', name: 'Example', version: '1.0.0' },
-  objects: {},
-  idempotencyKey: 'pack-import-001',
-});
-console.log(packs?.body, imported?.body);
-
-const continued = await vira.continueStrategyExecution('execution-id', {
-  authorityDigest: 'digest-from-the-execution',
-  state: { answer: 'approved' },
-  references: { userInput: { answer: 'approved' } },
-});
-```
-
-## Documentation
-
-See the public Vira documentation at https://github.com/hrpering/tryvira.
+# @tryvira/sdk
+
+MIT-licensed client library. The Vira service, application, and backend remain
+proprietary and are governed separately.
+
+Typed JavaScript/TypeScript client for Vira's scoped control and runtime APIs.
+
+## Install
+
+```bash
+npm install @tryvira/sdk
+```
+
+The client sends requests to Vira; it does not execute tools locally or create a second
+authority/telemetry store. Use a customer API key for hosted deployments and a local
+development key only with the local stack.
+
+## Connect and record an observation
+
+```ts
+import { ViraClient } from '@tryvira/sdk';
+
+const vira = new ViraClient({
+  baseUrl: process.env.VIRA_CONTROL_URL ?? 'http://127.0.0.1:4185',
+  apiKey: process.env.VIRA_API_KEY,
+});
+
+const connected = await vira.connectOnce({
+  name: 'my-agent', systemType: 'custom-agent',
+  organizationId: 'org', projectId: 'project', environmentId: 'local',
+  adapterType: 'custom-node', adapterVersion: '1',
+});
+
+const systemId = String(connected?.body.system?.id);
+const connectionId = String(connected?.body.connection?.id);
+await vira.observe({
+  eventId: `event-${Date.now()}`,
+  eventType: 'model.response',
+  aiSystemId: systemId,
+  connectionId,
+  payload: { message: 'A model response was produced.' },
+}, { idempotencyKey: `event-${Date.now()}` });
+```
+
+## Semantic and runtime resolution
+
+Semantic resolution finds an eligible governed target. Runtime resolution is the effectful
+boundary and therefore requires a released behavior point, scope and idempotency key.
+
+```ts
+const semantic = await vira.resolveSemantic({
+  input: 'answer a customer billing question',
+  profile: { domain: 'support' },
+});
+
+const runtime = await vira.resolveRuntime({
+  behaviorPoint: 'support.answer',
+  executionBoundary: { organizationId: 'org', projectId: 'project', environmentId: 'local' },
+  idempotencyKey: 'runtime-request-001',
+});
+```
+
+Do not treat a semantic result as authorization. The server remains the authority and may
+abstain, deny or require a released revision.
+
+## Packs and Strategy executions
+
+The normal pack lifecycle is import → install → evaluate → approve → release. Strategy
+execution starts only from an immutable, released artifact and can be continued with
+state/references when it reaches `WAITING_USER` or `WAITING_HOST`.
+
+```ts
+const packs = await vira.listPacks();
+const imported = await vira.importPack({
+  manifest: { id: 'example.pack', name: 'Example', version: '1.0.0' },
+  objects: {},
+  idempotencyKey: 'pack-import-001',
+});
+console.log(packs?.body, imported?.body);
+
+const continued = await vira.continueStrategyExecution('execution-id', {
+  authorityDigest: 'digest-from-the-execution',
+  state: { answer: 'approved' },
+  references: { userInput: { answer: 'approved' } },
+});
+
+// Pack evaluation consumes a persisted, server-verified evaluation. The SDK
+// never accepts a client-provided passed/score as release evidence.
+await vira.evaluatePack('pack-id', { evaluationId: 'evaluation-id' });
+```
+
+## Documentation
+
+See the public Vira documentation at https://github.com/hrpering/tryvira.

package/dist/index.js

@@ -68,7 +68,10 @@ var ViraClient = class {
       ...this.defaultHeaders
     };
     if (request.body) headers["content-type"] = "application/json";
-    if (this.apiKey) headers.authorization = `Bearer ${this.apiKey}`;
+    if (this.apiKey) {
+      headers.authorization = `Bearer ${this.apiKey}`;
+      headers["x-vira-api-key"] = this.apiKey;
+    }
     if (options.idempotencyKey)
       headers["idempotency-key"] = options.idempotencyKey;
     const retryable = request.method === "GET" || Boolean(options.idempotencyKey);
@@ -294,11 +297,12 @@ var ViraClient = class {
   }
   evaluatePack(packId, input) {
     required(packId, "SDK_PACK_ID_REQUIRED");
+    required(input?.evaluationId, "SDK_EVALUATION_ID_REQUIRED");
     return this.request(
       {
         method: "POST",
         path: `/v1/packs/${encodeURIComponent(packId)}/evaluate`,
-        body: { ...input }
+        body: { evaluationId: input.evaluationId }
       },
       { idempotencyKey: `sdk:pack:evaluate:${packId}` }
     );

package/dist/js-client.d.ts

@@ -232,9 +232,7 @@ export declare class ViraClient {
     }): Promise<ViraResponse<ClientBody> | null>;
     installPack(packId: string, variables?: Record<string, unknown>): Promise<ViraResponse<ClientBody> | null>;
     evaluatePack(packId: string, input: {
-        passed: boolean;
-        score?: number;
-        runId?: string;
+        evaluationId: string;
     }): Promise<ViraResponse<ClientBody> | null>;
     approvePack(packId: string, options?: {
         manualApproval?: boolean;

package/package.json

@@ -1,18 +1,18 @@
-{
-  "name": "@tryvira/sdk",
-  "version": "0.1.22",
-  "description": "Typed Vira SDK for connect-once, observation and governed runtime execution.",
-  "keywords": ["vira", "ai-governance", "ai-runtime", "semantic-routing"],
-  "engines": {"node": ">=20"},
-  "repository": {"type": "git", "url": "https://github.com/hrpering/tryvira.git"},
-  "homepage": "https://github.com/hrpering/tryvira#readme",
-  "bugs": {"url": "https://github.com/hrpering/tryvira/issues"},
-  "type": "module",
-  "main": "./dist/index.js",
-  "types": "./dist/index.d.ts",
-  "exports": {".": {"types": "./dist/index.d.ts", "import": "./dist/index.js"}},
-  "files": ["dist/index.js", "dist/index.d.ts", "dist/js-client.d.ts", "README.md"],
-  "publishConfig": {"access": "public"},
-  "scripts": {"build": "node ../../scripts/build-publishable-packages.mjs sdk", "pack:check": "npm run build && npm pack --dry-run && npm run public:surface:smoke", "public:surface:smoke": "node ../../scripts/public-surface-contract-acceptance.mjs --sdk-package", "prepublishOnly": "npm run pack:check && npm run public:surface:smoke", "publish:public": "npm run pack:check && npm run public:surface:smoke && npm publish --access public"},
-  "license": "MIT"
-}
+{
+  "name": "@tryvira/sdk",
+  "version": "0.1.24",
+  "description": "Typed Vira SDK for connect-once, observation and governed runtime execution.",
+  "keywords": ["vira", "ai-governance", "ai-runtime", "semantic-routing"],
+  "engines": {"node": ">=20"},
+  "repository": {"type": "git", "url": "https://github.com/hrpering/tryvira.git"},
+  "homepage": "https://github.com/hrpering/tryvira#readme",
+  "bugs": {"url": "https://github.com/hrpering/tryvira/issues"},
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {".": {"types": "./dist/index.d.ts", "import": "./dist/index.js"}},
+  "files": ["dist/index.js", "dist/index.d.ts", "dist/js-client.d.ts", "README.md"],
+  "publishConfig": {"access": "public"},
+  "scripts": {"build": "node ../../scripts/build-publishable-packages.mjs sdk", "pack:check": "npm run build && npm pack --dry-run && npm run public:surface:smoke", "public:surface:smoke": "node ../../scripts/public-surface-contract-acceptance.mjs --sdk-package", "prepublishOnly": "npm run pack:check && npm run public:surface:smoke", "publish:public": "npm run pack:check && npm run public:surface:smoke && npm publish --access public"},
+  "license": "MIT"
+}