@tryvira/sdk 0.1.12 → 0.1.14

package/dist/index.js

@@ -1,831 +1,840 @@
-// ../../sdks/js-client.ts
-var ViraApiError = class extends Error {
-  status;
-  body;
-  requestId;
-  constructor(message, status, body, requestId) {
-    super(message);
-    this.name = "ViraApiError";
-    this.status = status;
-    this.body = body;
-    this.requestId = requestId;
-  }
-};
-var required = (value, code) => {
-  if (typeof value !== "string" || !value.trim()) throw new Error(code);
-  return value;
-};
-var wait = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
-var ViraClient = class {
-  baseUrl;
-  apiKey;
-  fetcher;
-  timeoutMs;
-  retries;
-  failureMode;
-  defaultHeaders;
-  constructor(options) {
-    this.baseUrl = required(options.baseUrl, "SDK_BASE_URL_REQUIRED").replace(
-      /\/$/,
-      ""
-    );
-    this.apiKey = options.apiKey;
-    this.fetcher = options.fetcher ?? fetch;
-    this.timeoutMs = Math.max(
-      1e3,
-      Math.min(options.timeoutMs ?? 15e3, 12e4)
-    );
-    this.retries = Math.max(0, Math.min(options.retries ?? 2, 5));
-    this.failureMode = options.failureMode ?? "throw";
-    this.defaultHeaders = options.defaultHeaders ?? {};
-  }
-  async request(request, options = {}) {
-    const url = new URL(this.baseUrl + request.path);
-    for (const [key, value] of Object.entries(request.query ?? {}))
-      url.searchParams.set(key, value);
-    const headers = {
-      accept: "application/json",
-      ...this.defaultHeaders
-    };
-    if (request.body) headers["content-type"] = "application/json";
-    if (this.apiKey) headers.authorization = `Bearer ${this.apiKey}`;
-    if (options.idempotencyKey)
-      headers["idempotency-key"] = options.idempotencyKey;
-    const retryable = request.method === "GET" || Boolean(options.idempotencyKey);
-    const attempts = retryable ? this.retries + 1 : 1;
-    let lastError;
-    for (let attempt = 0; attempt < attempts; attempt += 1) {
-      const controller = new AbortController();
-      const timer = setTimeout(() => controller.abort(), this.timeoutMs);
-      try {
-        const response = await this.fetcher(url, {
-          method: request.method,
-          headers,
-          body: request.body ? JSON.stringify(request.body) : void 0,
-          signal: controller.signal
-        });
-        const raw = await response.text();
-        let body = null;
-        try {
-          body = raw ? JSON.parse(raw) : null;
-        } catch {
-          body = raw;
-        }
-        const requestId = response.headers.get("x-request-id") ?? "";
-        if (!response.ok) {
-          const error = new ViraApiError(
-            `VIRA_API_${response.status}`,
-            response.status,
-            body,
-            requestId
-          );
-          if ((response.status >= 500 || response.status === 429) && attempt + 1 < attempts) {
-            const retryAfter = Number(response.headers.get("retry-after") ?? "");
-            const serverDelay = Number.isFinite(retryAfter) && retryAfter >= 0 ? Math.min(retryAfter * 1e3, 12e4) : 0;
-            const jitter = Math.floor(Math.random() * 25);
-            await wait(Math.max(serverDelay, 25 * 2 ** attempt) + jitter);
-            continue;
-          }
-          if (this.failureMode === "open" && !options.enforcing && response.status >= 500)
-            return null;
-          throw error;
-        }
-        return { status: response.status, body, requestId };
-      } catch (error) {
-        lastError = error;
-        if (error instanceof ViraApiError) throw error;
-        if (attempt + 1 < attempts) {
-          await wait(25 * 2 ** attempt);
-          continue;
-        }
-        if (this.failureMode === "open" && !options.enforcing) return null;
-        throw error;
-      } finally {
-        clearTimeout(timer);
-      }
-    }
-    throw lastError;
-  }
-  connectSystem(input) {
-    const request = buildAISystemRequest(input);
-    return this.request(request, {
-      idempotencyKey: input.idempotencyKey
-    });
-  }
-  listAISystems() {
-    return this.request({ method: "GET", path: "/v1/ai-systems" });
-  }
-  deleteAISystem(systemId, options = {}) {
-    required(systemId, "SDK_SYSTEM_ID_REQUIRED");
-    return this.request({ method: "DELETE", path: `/v1/ai-systems/${encodeURIComponent(systemId)}`, body: { confirm: options.confirm === true } }, { idempotencyKey: options.idempotencyKey ?? `sdk:delete:ai-system:${systemId}` });
-  }
-  getAISystem(systemId) {
-    required(systemId, "SDK_SYSTEM_ID_REQUIRED");
-    return this.request({ method: "GET", path: `/v1/ai-systems/${encodeURIComponent(systemId)}` });
-  }
-  connectAdapter(systemId, input) {
-    required(systemId, "SDK_SYSTEM_ID_REQUIRED");
-    const body = {
-      ...input,
-      capabilities: [...input.capabilities ?? []]
-    };
-    delete body.idempotencyKey;
-    return this.request(
-      {
-        method: "POST",
-        path: `/v1/ai-systems/${encodeURIComponent(systemId)}/connections`,
-        body
-      },
-      { idempotencyKey: input.idempotencyKey }
-    );
-  }
-  async connectOnce(input) {
-    const systemResult = await this.connectSystem(input);
-    if (!systemResult) return null;
-    const systemId = String(systemResult.body.system.id ?? "");
-    required(systemId, "SDK_SYSTEM_ID_MISSING");
-    const connectionResult = await this.connectAdapter(systemId, {
-      adapterType: input.adapterType,
-      adapterVersion: input.adapterVersion,
-      capabilities: input.capabilities,
-      config: input.config,
-      idempotencyKey: input.idempotencyKey
-    });
-    if (!connectionResult) return null;
-    return {
-      status: connectionResult.status,
-      requestId: connectionResult.requestId,
-      body: {
-        system: systemResult.body.system,
-        connection: connectionResult.body.connection,
-        handshake: connectionResult.body.handshake
-      }
-    };
-  }
-  observe(event, options = {}) {
-    return this.request(buildObservationRequest(event), {
-      idempotencyKey: options.idempotencyKey ?? event.eventId
-    });
-  }
-  trace(event, options = {}) {
-    return this.observe({ ...event, eventType: "model.response" }, options);
-  }
-  outcome(event, options = {}) {
-    return this.observe({ ...event, eventType: "business.outcome" }, options);
-  }
-  feedback(event, options = {}) {
-    return this.observe({ ...event, eventType: "feedback.user" }, options);
-  }
-  observeBatch(events, options = {}) {
-    if (!Array.isArray(events) || events.length < 1 || events.length > 100)
-      throw new Error("SDK_OBSERVATION_BATCH_INVALID");
-    return this.request(
-      {
-        method: "POST",
-        path: "/v1/observations/batch",
-        body: { events: [...events] }
-      },
-      { idempotencyKey: options.idempotencyKey }
-    );
-  }
-  observeSdk(delivery, options = {}) {
-    return this.request(
-      { method: "POST", path: "/v1/observations/sdk", body: delivery },
-      { idempotencyKey: options.idempotencyKey }
-    );
-  }
-  discover(reviewState) {
-    return this.request({
-      method: "GET",
-      path: "/v1/discovery/candidates",
-      query: reviewState ? { reviewState } : void 0
-    });
-  }
-  createSignalDiscoveryProposal(input, options = {}) {
-    return this.request({ method: "POST", path: "/v1/signals/discovery-proposals", body: input }, { idempotencyKey: options.idempotencyKey ?? String(input.signalStableKey ?? "") });
-  }
-  reviewSignalDiscoveryProposal(proposalId, decision, options = {}) {
-    required(proposalId, "SDK_SIGNAL_PROPOSAL_ID_REQUIRED");
-    return this.request({ method: "POST", path: `/v1/signals/discovery-proposals/${encodeURIComponent(proposalId)}/review`, body: { decision } }, { idempotencyKey: options.idempotencyKey ?? `signal-review:${proposalId}` });
-  }
-  materializeSignalDiscovery(proposalId, input = {}, options = {}) {
-    required(proposalId, "SDK_SIGNAL_PROPOSAL_ID_REQUIRED");
-    return this.request({ method: "POST", path: `/v1/signals/discovery-proposals/${encodeURIComponent(proposalId)}/materialize`, body: input }, { idempotencyKey: options.idempotencyKey ?? `signal-materialize:${proposalId}` });
-  }
-  createSignalMapping(input, options = {}) {
-    return this.request({ method: "POST", path: "/v1/signals/mappings", body: input }, { idempotencyKey: options.idempotencyKey ?? String(input.signalStableKey ?? "") });
-  }
-  getSignalMapping(mappingId) {
-    required(mappingId, "SDK_SIGNAL_MAPPING_ID_REQUIRED");
-    return this.request({ method: "GET", path: `/v1/signals/mappings/${encodeURIComponent(mappingId)}` });
-  }
-  reviewSignalMapping(mappingId, input = {}, options = {}) {
-    required(mappingId, "SDK_SIGNAL_MAPPING_ID_REQUIRED");
-    return this.request({ method: "POST", path: `/v1/signals/mappings/${encodeURIComponent(mappingId)}/review`, body: input }, { idempotencyKey: options.idempotencyKey ?? `signal-mapping-review:${mappingId}` });
-  }
-  connectionHealth(connectionId) {
-    required(connectionId, "SDK_CONNECTION_ID_REQUIRED");
-    return this.request({
-      method: "GET",
-      path: `/v1/connections/${encodeURIComponent(connectionId)}/health`
-    });
-  }
-  inventory(systemId) {
-    required(systemId, "SDK_SYSTEM_ID_REQUIRED");
-    return this.request({
-      method: "GET",
-      path: `/v1/ai-systems/${encodeURIComponent(systemId)}/inventory`
-    });
-  }
-  listPacks() {
-    return this.request({
-      method: "GET",
-      path: "/v1/packs"
-    });
-  }
-  importPack(input) {
-    if (!input?.manifest && !input?.archiveBase64)
-      throw new Error("SDK_PACK_MANIFEST_OR_ARCHIVE_REQUIRED");
-    if (input.archiveBase64 && !input.fileName)
-      throw new Error("SDK_PACK_FILE_NAME_REQUIRED");
-    return this.request(
-      {
-        method: "POST",
-        path: "/v1/packs/import",
-        body: {
-          ...input.manifest ? { manifest: input.manifest } : {},
-          objects: input.objects ?? {},
-          ...input.archiveBase64 ? { archiveBase64: input.archiveBase64, fileName: input.fileName } : {}
-        }
-      },
-      { idempotencyKey: input.idempotencyKey ?? `sdk:pack:${Date.now()}` }
-    );
-  }
-  installPack(packId, variables = {}) {
-    required(packId, "SDK_PACK_ID_REQUIRED");
-    return this.request(
-      {
-        method: "POST",
-        path: `/v1/packs/${encodeURIComponent(packId)}/install`,
-        body: { variables }
-      },
-      { idempotencyKey: `sdk:pack:install:${packId}` }
-    );
-  }
-  evaluatePack(packId, input) {
-    required(packId, "SDK_PACK_ID_REQUIRED");
-    return this.request(
-      {
-        method: "POST",
-        path: `/v1/packs/${encodeURIComponent(packId)}/evaluate`,
-        body: { ...input }
-      },
-      { idempotencyKey: `sdk:pack:evaluate:${packId}` }
-    );
-  }
-  approvePack(packId) {
-    required(packId, "SDK_PACK_ID_REQUIRED");
-    return this.request(
-      {
-        method: "POST",
-        path: `/v1/packs/${encodeURIComponent(packId)}/approve`,
-        body: {}
-      },
-      { idempotencyKey: `sdk:pack:approve:${packId}` }
-    );
-  }
-  releasePack(packId) {
-    required(packId, "SDK_PACK_ID_REQUIRED");
-    return this.request(
-      {
-        method: "POST",
-        path: `/v1/packs/${encodeURIComponent(packId)}/release`,
-        body: {}
-      },
-      { idempotencyKey: `sdk:pack:release:${packId}` }
-    );
-  }
-  previewPackUpgrade(packId, incoming) {
-    required(packId, "SDK_PACK_ID_REQUIRED");
-    if (!incoming || typeof incoming !== "object")
-      throw new Error("SDK_PACK_UPGRADE_INPUT_REQUIRED");
-    return this.request(
-      {
-        method: "POST",
-        path: `/v1/packs/${encodeURIComponent(packId)}/upgrade-preview`,
-        body: { incoming }
-      },
-      { idempotencyKey: `sdk:pack:upgrade-preview:${packId}` }
-    );
-  }
-  executeRuntime(input) {
-    return this.request(
-      {
-        method: "POST",
-        path: "/v1/runtime/execute",
-        body: buildRuntimeRequest(
-          input
-        )
-      },
-      { idempotencyKey: input.idempotencyKey, enforcing: true }
-    );
-  }
-  resolveRuntime(input) {
-    if (!input.behaviorPoint && !input.executionBoundary && !input.semanticContext)
-      throw new Error("SDK_RUNTIME_ROUTE_REQUIRED");
-    return this.request(
-      {
-        method: "POST",
-        path: "/v1/runtime/resolve",
-        body: {
-          ...input.behaviorPoint ? { behaviorPoint: input.behaviorPoint } : {},
-          ...input.executionBoundary ? { executionBoundary: input.executionBoundary } : {},
-          ...input.semanticContext ? { semanticContext: input.semanticContext } : {}
-        }
-      },
-      {
-        idempotencyKey: input.idempotencyKey ?? `sdk:resolve:${input.behaviorPoint ?? "boundary"}`,
-        enforcing: true
-      }
-    );
-  }
-  /** Resolve a runtime route from a governed execution boundary and semantic context. */
-  resolveBoundary(input) {
-    if (!input.executionBoundary || typeof input.executionBoundary !== "object")
-      throw new Error("SDK_EXECUTION_BOUNDARY_REQUIRED");
-    return this.resolveRuntime({
-      executionBoundary: input.executionBoundary,
-      ...input.semanticContext ? { semanticContext: input.semanticContext } : {},
-      idempotencyKey: input.idempotencyKey
-    });
-  }
-  resolveSemantic(input) {
-    required(input.input, "SDK_SEMANTIC_INPUT_REQUIRED");
-    const { idempotencyKey, requestId, ...body } = input;
-    const resolvedRequestId = requestId ?? `sdk-semantic-${Date.now()}-${Math.random().toString(36).slice(2, 10)}`;
-    return this.request(
-      {
-        method: "POST",
-        path: "/v1/semantic/resolve",
-        body: { ...body, requestId: resolvedRequestId }
-      },
-      { idempotencyKey: idempotencyKey ?? `sdk:semantic:${resolvedRequestId}` }
-    );
-  }
-  async resolveSemanticRuntime(input) {
-    const semantic = await this.resolveSemantic(input);
-    if (!semantic) return null;
-    const body = semantic.body;
-    const receipt = body.receipt && typeof body.receipt === "object" ? body.receipt : {};
-    if (receipt.outcome !== "select" || typeof receipt.taskKey !== "string")
-      return { semantic, runtime: null };
-    const capsules = Array.isArray(body.capsules) ? body.capsules : [];
-    const firstCapsule = capsules[0] && typeof capsules[0] === "object" ? capsules[0] : {};
-    const behaviorPoint = typeof firstCapsule.behaviorKey === "string" && firstCapsule.behaviorKey.trim() ? firstCapsule.behaviorKey : receipt.taskKey;
-    const runtime = input.executionBoundary ? await this.resolveBoundary({
-      executionBoundary: input.executionBoundary,
-      semanticContext: {
-        taskKey: receipt.taskKey,
-        behaviorPoint,
-        capsule: firstCapsule
-      },
-      idempotencyKey: input.idempotencyKey ? `sdk:runtime:${input.idempotencyKey}` : void 0
-    }) : await this.resolveRuntime({
-      semanticContext: { taskKey: receipt.taskKey, behaviorPoint, capsule: firstCapsule },
-      idempotencyKey: input.idempotencyKey ? `sdk:runtime:${input.idempotencyKey}` : void 0
-    });
-    return { semantic, runtime };
-  }
-  listBehaviorStrategies() {
-    return this.request({
-      method: "GET",
-      path: "/v1/behavior-strategies"
-    });
-  }
-  deleteBehaviorStrategy(strategyId, options = {}) {
-    required(strategyId, "SDK_STRATEGY_ID_REQUIRED");
-    return this.request({ method: "DELETE", path: `/v1/behavior-strategies/${encodeURIComponent(strategyId)}`, body: { confirm: options.confirm === true } }, { idempotencyKey: options.idempotencyKey ?? `sdk:delete:strategy:${strategyId}` });
-  }
-  getBehaviorStrategy(strategyId) {
-    required(strategyId, "SDK_STRATEGY_ID_REQUIRED");
-    return this.request({
-      method: "GET",
-      path: `/v1/behavior-strategies/${encodeURIComponent(strategyId)}`
-    });
-  }
-  createBehaviorStrategy(definition, id) {
-    if (!definition) throw new Error("SDK_STRATEGY_DEFINITION_REQUIRED");
-    return this.request({
-      method: "POST",
-      path: "/v1/behavior-strategies",
-      body: { definition, ...id ? { id } : {} }
-    });
-  }
-  listSemanticTasks() {
-    return this.request({ method: "GET", path: "/v1/semantic-tasks" });
-  }
-  deleteSemanticTask(taskId, options = {}) {
-    required(taskId, "SDK_SEMANTIC_TASK_ID_REQUIRED");
-    return this.request({ method: "DELETE", path: `/v1/semantic-tasks/${encodeURIComponent(taskId)}`, body: { confirm: options.confirm === true } }, { idempotencyKey: options.idempotencyKey ?? `sdk:delete:semantic-task:${taskId}` });
-  }
-  createSemanticTask(task, options = {}) {
-    required(task?.taskKey, "SDK_SEMANTIC_TASK_KEY_REQUIRED");
-    return this.request({ method: "POST", path: "/v1/semantic-tasks", body: { ...task, ...options.id ? { id: options.id } : {} } }, { idempotencyKey: options.idempotencyKey ?? `sdk:semantic-task:${task.taskKey}` });
-  }
-  listBehaviorPoints() {
-    return this.request({ method: "GET", path: "/v1/behavior-points" });
-  }
-  deleteBehaviorPoint(pointId, options = {}) {
-    required(pointId, "SDK_BEHAVIOR_POINT_ID_REQUIRED");
-    return this.request({ method: "DELETE", path: `/v1/behavior-points/${encodeURIComponent(pointId)}`, body: { confirm: options.confirm === true } }, { idempotencyKey: options.idempotencyKey ?? `sdk:delete:behavior-point:${pointId}` });
-  }
-  createBehaviorPoint(point, options = {}) {
-    required(point?.key, "SDK_BEHAVIOR_POINT_KEY_REQUIRED");
-    if (!point.taskId && !point.taskIds?.length) throw new Error("SDK_BEHAVIOR_POINT_TASK_REQUIRED");
-    return this.request({ method: "POST", path: "/v1/behavior-points", body: { ...point, ...options.id ? { id: options.id } : {} } }, { idempotencyKey: options.idempotencyKey ?? `sdk:behavior-point:${point.key}` });
-  }
-  createBehaviorStrategyVariant(strategyId, variant, options = {}) {
-    required(strategyId, "SDK_STRATEGY_ID_REQUIRED");
-    if (!variant || typeof variant !== "object")
-      throw new Error("SDK_STRATEGY_VARIANT_REQUIRED");
-    return this.request(
-      {
-        method: "POST",
-        path: `/v1/behavior-strategies/${encodeURIComponent(strategyId)}/variants`,
-        body: variant
-      },
-      { idempotencyKey: options.idempotencyKey }
-    );
-  }
-  validateBehaviorStrategy(strategyId) {
-    required(strategyId, "SDK_STRATEGY_ID_REQUIRED");
-    return this.request({
-      method: "POST",
-      path: `/v1/behavior-strategies/${encodeURIComponent(strategyId)}/validate`,
-      body: {}
-    });
-  }
-  activateBehaviorStrategy(strategyId) {
-    required(strategyId, "SDK_STRATEGY_ID_REQUIRED");
-    return this.request({ method: "POST", path: `/v1/behavior-strategies/${encodeURIComponent(strategyId)}/activate`, body: {} });
-  }
-  simulateBehaviorStrategy(strategyId, initialState = {}) {
-    required(strategyId, "SDK_STRATEGY_ID_REQUIRED");
-    return this.request({
-      method: "POST",
-      path: `/v1/behavior-strategies/${encodeURIComponent(strategyId)}/simulate`,
-      body: { initialState }
-    });
-  }
-  startStrategyExecution(input) {
-    required(input.artifactDigest, "SDK_ARTIFACT_DIGEST_REQUIRED");
-    for (const value of [
-      input.organizationId,
-      input.projectId,
-      input.environmentId,
-      input.revisionId,
-      input.idempotencyKey,
-      input.nonce,
-      input.decisionPlanId,
-      input.policy
-    ])
-      required(value, "SDK_STRATEGY_START_FIELD_REQUIRED");
-    if (input.behaviorPoint !== void 0)
-      required(input.behaviorPoint, "SDK_BEHAVIOR_POINT_REQUIRED");
-    if (!Array.isArray(input.candidates) || input.candidates.length === 0)
-      throw new Error("SDK_STRATEGY_CANDIDATES_REQUIRED");
-    if (!Number.isFinite(input.expiresAt))
-      throw new Error("SDK_EXPIRY_REQUIRED");
-    const body = {
-      ...buildRuntimeRequest(input),
-      artifactDigest: input.artifactDigest,
-      ...input.behaviorPoint ? { behaviorPoint: input.behaviorPoint } : {},
-      ...input.executionBoundary ? { executionBoundary: input.executionBoundary } : {},
-      ...input.traceId ? { traceId: input.traceId } : {},
-      ...input.executionId ? { executionId: input.executionId } : {},
-      ...input.state ? { state: input.state } : {}
-    };
-    return this.request(
-      { method: "POST", path: "/v1/runtime/strategy-executions", body },
-      { idempotencyKey: input.idempotencyKey }
-    );
-  }
-  getStrategyExecution(executionId) {
-    required(executionId, "SDK_EXECUTION_ID_REQUIRED");
-    return this.request({
-      method: "GET",
-      path: `/v1/runtime/strategy-executions/${encodeURIComponent(executionId)}`
-    });
-  }
-  getStrategyExecutionTrace(executionId) {
-    required(executionId, "SDK_EXECUTION_ID_REQUIRED");
-    return this.request({
-      method: "GET",
-      path: `/v1/runtime/strategy-executions/${encodeURIComponent(executionId)}/trace`
-    });
-  }
-  continueStrategyExecution(executionId, continuation) {
-    required(executionId, "SDK_EXECUTION_ID_REQUIRED");
-    const input = typeof continuation === "string" ? { authorityDigest: continuation } : continuation ?? {};
-    return this.request({
-      method: "POST",
-      path: `/v1/runtime/strategy-executions/${encodeURIComponent(executionId)}/continue`,
-      body: {
-        ...input.authorityDigest ? { authorityDigest: input.authorityDigest } : {},
-        ...input.state ? { state: input.state } : {},
-        ...input.references ? { references: input.references } : {}
-      }
-    });
-  }
-  cancelStrategyExecution(executionId) {
-    required(executionId, "SDK_EXECUTION_ID_REQUIRED");
-    return this.request({
-      method: "POST",
-      path: `/v1/runtime/strategy-executions/${encodeURIComponent(executionId)}/cancel`,
-      body: {}
-    });
-  }
-  listBehaviorPrograms() {
-    return this.request({
-      method: "GET",
-      path: "/v1/behavior-programs"
-    });
-  }
-  listCapabilities(options = {}) {
-    const query = options.surface ? `?surface=${encodeURIComponent(options.surface)}` : "";
-    return this.request({ method: "GET", path: `/v1/capabilities${query}` });
-  }
-  getBehaviorProgram(programId) {
-    required(programId, "SDK_PROGRAM_ID_REQUIRED");
-    return this.request({
-      method: "GET",
-      path: `/v1/behavior-programs/${encodeURIComponent(programId)}`
-    });
-  }
-  createBehaviorProgram(program, options = {}) {
-    if (!program || typeof program !== "object")
-      throw new Error("SDK_PROGRAM_REQUIRED");
-    return this.request(
-      { method: "POST", path: "/v1/behavior-programs", body: program },
-      {
-        idempotencyKey: options.idempotencyKey ?? `sdk:program:${String(program.id ?? "")}`
-      }
-    );
-  }
-  attestCapabilities(attestation, options = {}) {
-    return this.request(
-      {
-        method: "POST",
-        path: "/v1/runtime/capabilities/attest",
-        body: attestation
-      },
-      { idempotencyKey: options.idempotencyKey }
-    );
-  }
-  resolveCapabilities(attestationId, request, options = {}) {
-    required(attestationId, "SDK_ATTESTATION_ID_REQUIRED");
-    return this.request(
-      {
-        method: "POST",
-        path: "/v1/runtime/capabilities/resolve",
-        body: { attestationId, request }
-      },
-      { idempotencyKey: options.idempotencyKey, enforcing: true }
-    );
-  }
-  recordCapabilityTrace(decisionDigest, trace, options = {}) {
-    required(decisionDigest, "SDK_DECISION_DIGEST_REQUIRED");
-    return this.request(
-      {
-        method: "POST",
-        path: "/v1/runtime/capabilities/traces",
-        body: { decisionDigest, trace }
-      },
-      { idempotencyKey: options.idempotencyKey }
-    );
-  }
-  resolveModelServing(request, options = {}) {
-    return this.request(
-      { method: "POST", path: "/v1/model-serving/resolve", body: request },
-      { idempotencyKey: options.idempotencyKey, enforcing: true }
-    );
-  }
-  recordModelServingTrace(trace, selection, options = {}) {
-    return this.request(
-      {
-        method: "POST",
-        path: "/v1/model-serving/traces",
-        body: { trace, selection }
-      },
-      { idempotencyKey: options.idempotencyKey }
-    );
-  }
-  submitTeachEvidence(evidence, options = {}) {
-    return this.request(
-      { method: "POST", path: "/v1/teach/evidence", body: evidence },
-      { idempotencyKey: options.idempotencyKey }
-    );
-  }
-  createTeachProposal(input, options = {}) {
-    return this.request({ method: "POST", path: "/v1/teach/proposals", body: input }, { idempotencyKey: options.idempotencyKey });
-  }
-  transitionTeachProposal(proposalId, transition, input = {}, options = {}) {
-    required(proposalId, "SDK_TEACH_PROPOSAL_ID_REQUIRED");
-    return this.request({ method: "POST", path: `/v1/teach/proposals/${encodeURIComponent(proposalId)}/${transition}`, body: input }, { idempotencyKey: options.idempotencyKey ?? `sdk:teach:${transition}:${proposalId}` });
-  }
-  startEvaluation(input, options = {}) {
-    return this.request(
-      { method: "POST", path: "/v1/evaluations", body: input },
-      { idempotencyKey: options.idempotencyKey }
-    );
-  }
-  evaluateQuality(input, options = {}) {
-    return this.request(
-      { method: "POST", path: "/v1/quality/evaluate", body: input },
-      { idempotencyKey: options.idempotencyKey }
-    );
-  }
-  getEvaluation(evaluationId) {
-    required(evaluationId, "SDK_EVALUATION_ID_REQUIRED");
-    return this.request({
-      method: "GET",
-      path: `/v1/evaluations/${encodeURIComponent(evaluationId)}`
-    });
-  }
-  createRelease(input, options = {}) {
-    return this.request(
-      { method: "POST", path: "/v1/releases", body: input },
-      { idempotencyKey: options.idempotencyKey }
-    );
-  }
-  recordDeploymentComparison(deploymentId, comparison, options = {}) {
-    required(deploymentId, "SDK_DEPLOYMENT_ID_REQUIRED");
-    return this.request(
-      {
-        method: "POST",
-        path: `/v1/deployments/${encodeURIComponent(deploymentId)}/comparisons`,
-        body: comparison
-      },
-      { idempotencyKey: options.idempotencyKey }
-    );
-  }
-  recordDeploymentHealth(deploymentId, health, options = {}) {
-    required(deploymentId, "SDK_DEPLOYMENT_ID_REQUIRED");
-    return this.request(
-      {
-        method: "POST",
-        path: `/v1/deployments/${encodeURIComponent(deploymentId)}/authoritative-health`,
-        body: health
-      },
-      { idempotencyKey: options.idempotencyKey }
-    );
-  }
-  compileBehaviorCapsule(input) {
-    required(input.programId, "SDK_PROGRAM_ID_REQUIRED");
-    required(input.input, "SDK_RUNTIME_INPUT_REQUIRED");
-    return this.request(
-      {
-        method: "POST",
-        path: "/v1/runtime/behavior-capsule",
-        body: { ...input }
-      },
-      {
-        idempotencyKey: input.idempotencyKey ?? `sdk:capsule:${input.programId}`
-      }
-    );
-  }
-  serveBehaviorProjection(input) {
-    required(input.input, "SDK_RUNTIME_INPUT_REQUIRED");
-    required(input.provider, "SDK_PROVIDER_REQUIRED");
-    return this.request(
-      {
-        method: "POST",
-        path: "/v1/runtime/behavior-projection",
-        body: { ...input }
-      },
-      {
-        idempotencyKey: input.idempotencyKey ?? `sdk:projection:${input.programId ?? "active"}`
-      }
-    );
-  }
-  async testConnection(connectionId) {
-    required(connectionId, "SDK_CONNECTION_ID_REQUIRED");
-    return this.request({
-      method: "POST",
-      path: `/v1/connections/${encodeURIComponent(connectionId)}/test`,
-      body: {}
-    });
-  }
-};
-function buildRuntimeRequest(input) {
-  const {
-    organizationId,
-    projectId,
-    environmentId,
-    revisionId,
-    idempotencyKey,
-    nonce,
-    expiresAt,
-    decisionPlanId,
-    calibrationId,
-    candidates,
-    allowedIds,
-    policy,
-    postModelJudge,
-    shadow
-  } = input;
-  for (const value of [
-    organizationId,
-    projectId,
-    environmentId,
-    revisionId,
-    idempotencyKey,
-    nonce
-  ])
-    if (typeof value !== "string" || !value.trim())
-      throw new Error("SDK_REQUEST_FIELD_REQUIRED");
-  if (!Number.isFinite(expiresAt)) throw new Error("SDK_EXPIRY_REQUIRED");
-  const boundary = {
-    ...typeof decisionPlanId === "string" ? { decisionPlanId } : {},
-    ...typeof calibrationId === "string" ? { calibrationId } : {},
-    ...Array.isArray(candidates) ? { candidates } : {},
-    ...Array.isArray(allowedIds) ? { allowedIds } : {},
-    ...typeof policy === "string" ? { policy } : {},
-    ...postModelJudge !== void 0 ? { postModelJudge } : {},
-    ...shadow !== void 0 ? { shadow } : {}
-  };
-  return Object.freeze({
-    organizationId,
-    projectId,
-    environmentId,
-    revisionId,
-    idempotencyKey,
-    nonce,
-    expiresAt,
-    ...boundary
-  });
-}
-function buildPublicContentRequest(input) {
-  const { slug, version = "v1" } = input;
-  if (typeof slug !== "string" || !slug.trim())
-    throw new Error("SDK_SLUG_REQUIRED");
-  if (version !== "v1") throw new Error("SDK_VERSION_UNSUPPORTED");
-  return Object.freeze({
-    method: "GET",
-    path: "/v1/content",
-    query: Object.freeze({ slug })
-  });
-}
-function buildDocsQueryRequest(input) {
-  const { query, operation = "search" } = input;
-  if (typeof query !== "string" || !query.trim())
-    throw new Error("SDK_QUERY_REQUIRED");
-  if (!["search", "ask"].includes(operation))
-    throw new Error("SDK_OPERATION_UNSUPPORTED");
-  return Object.freeze({
-    method: "GET",
-    path: `/docs/${operation}`,
-    query: Object.freeze({ query })
-  });
-}
-function buildAISystemRequest(input) {
-  const { name, systemType, organizationId, projectId, environmentId } = input;
-  for (const value of [
-    name,
-    systemType,
-    organizationId,
-    projectId,
-    environmentId
-  ])
-    if (typeof value !== "string" || !value.trim())
-      throw new Error("SDK_AI_SYSTEM_FIELD_REQUIRED");
-  return Object.freeze({
-    method: "POST",
-    path: "/v1/ai-systems",
-    body: Object.freeze({
-      name,
-      systemType,
-      organizationId,
-      projectId,
-      environmentId
-    })
-  });
-}
-function buildObservationRequest(event) {
-  if (!event?.eventId || !event.eventType || !event.aiSystemId || !event.connectionId)
-    throw new Error("SDK_OBSERVATION_FIELD_REQUIRED");
-  return Object.freeze({
-    method: "POST",
-    path: "/v1/observations",
-    body: Object.freeze({ ...event })
-  });
-}
-export {
-  ViraApiError,
-  ViraClient,
-  buildAISystemRequest,
-  buildDocsQueryRequest,
-  buildObservationRequest,
-  buildPublicContentRequest,
-  buildRuntimeRequest
-};
+// sdks/js-client.ts
+var ViraApiError = class extends Error {
+  status;
+  body;
+  requestId;
+  constructor(message, status, body, requestId) {
+    super(message);
+    this.name = "ViraApiError";
+    this.status = status;
+    this.body = body;
+    this.requestId = requestId;
+  }
+};
+var required = (value, code) => {
+  if (typeof value !== "string" || !value.trim()) throw new Error(code);
+  return value;
+};
+var wait = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
+var ViraClient = class {
+  baseUrl;
+  apiKey;
+  fetcher;
+  timeoutMs;
+  retries;
+  failureMode;
+  defaultHeaders;
+  constructor(options) {
+    this.baseUrl = required(options.baseUrl, "SDK_BASE_URL_REQUIRED").replace(
+      /\/$/,
+      ""
+    );
+    this.apiKey = options.apiKey;
+    this.fetcher = options.fetcher ?? fetch;
+    this.timeoutMs = Math.max(
+      1e3,
+      Math.min(options.timeoutMs ?? 15e3, 12e4)
+    );
+    this.retries = Math.max(0, Math.min(options.retries ?? 2, 5));
+    this.failureMode = options.failureMode ?? "throw";
+    this.defaultHeaders = options.defaultHeaders ?? {};
+  }
+  async request(request, options = {}) {
+    const url = new URL(this.baseUrl + request.path);
+    for (const [key, value] of Object.entries(request.query ?? {}))
+      url.searchParams.set(key, value);
+    const headers = {
+      accept: "application/json",
+      ...this.defaultHeaders
+    };
+    if (request.body) headers["content-type"] = "application/json";
+    if (this.apiKey) headers.authorization = `Bearer ${this.apiKey}`;
+    if (options.idempotencyKey)
+      headers["idempotency-key"] = options.idempotencyKey;
+    const retryable = request.method === "GET" || Boolean(options.idempotencyKey);
+    const attempts = retryable ? this.retries + 1 : 1;
+    let lastError;
+    for (let attempt = 0; attempt < attempts; attempt += 1) {
+      const controller = new AbortController();
+      const timer = setTimeout(() => controller.abort(), this.timeoutMs);
+      try {
+        const response = await this.fetcher(url, {
+          method: request.method,
+          headers,
+          body: request.body ? JSON.stringify(request.body) : void 0,
+          signal: controller.signal
+        });
+        const raw = await response.text();
+        let body = null;
+        try {
+          body = raw ? JSON.parse(raw) : null;
+        } catch {
+          body = raw;
+        }
+        const requestId = response.headers.get("x-request-id") ?? "";
+        if (!response.ok) {
+          const error = new ViraApiError(
+            `VIRA_API_${response.status}`,
+            response.status,
+            body,
+            requestId
+          );
+          if ((response.status >= 500 || response.status === 429) && attempt + 1 < attempts) {
+            const retryAfter = Number(response.headers.get("retry-after") ?? "");
+            const serverDelay = Number.isFinite(retryAfter) && retryAfter >= 0 ? Math.min(retryAfter * 1e3, 12e4) : 0;
+            const jitter = Math.floor(Math.random() * 25);
+            await wait(Math.max(serverDelay, 25 * 2 ** attempt) + jitter);
+            continue;
+          }
+          if (this.failureMode === "open" && !options.enforcing && response.status >= 500)
+            return null;
+          throw error;
+        }
+        return { status: response.status, body, requestId };
+      } catch (error) {
+        lastError = error;
+        if (error instanceof ViraApiError) throw error;
+        if (attempt + 1 < attempts) {
+          await wait(25 * 2 ** attempt);
+          continue;
+        }
+        if (this.failureMode === "open" && !options.enforcing) return null;
+        throw error;
+      } finally {
+        clearTimeout(timer);
+      }
+    }
+    throw lastError;
+  }
+  connectSystem(input) {
+    const request = buildAISystemRequest(input);
+    return this.request(request, {
+      idempotencyKey: input.idempotencyKey
+    });
+  }
+  listAISystems() {
+    return this.request({ method: "GET", path: "/v1/ai-systems" });
+  }
+  deleteAISystem(systemId, options = {}) {
+    required(systemId, "SDK_SYSTEM_ID_REQUIRED");
+    return this.request({ method: "DELETE", path: `/v1/ai-systems/${encodeURIComponent(systemId)}`, body: { confirm: options.confirm === true } }, { idempotencyKey: options.idempotencyKey ?? `sdk:delete:ai-system:${systemId}` });
+  }
+  getAISystem(systemId) {
+    required(systemId, "SDK_SYSTEM_ID_REQUIRED");
+    return this.request({ method: "GET", path: `/v1/ai-systems/${encodeURIComponent(systemId)}` });
+  }
+  connectAdapter(systemId, input) {
+    required(systemId, "SDK_SYSTEM_ID_REQUIRED");
+    const body = {
+      ...input,
+      capabilities: [...input.capabilities ?? []]
+    };
+    delete body.idempotencyKey;
+    return this.request(
+      {
+        method: "POST",
+        path: `/v1/ai-systems/${encodeURIComponent(systemId)}/connections`,
+        body
+      },
+      { idempotencyKey: input.idempotencyKey }
+    );
+  }
+  async connectOnce(input) {
+    const systemResult = await this.connectSystem(input);
+    if (!systemResult) return null;
+    const systemId = String(systemResult.body.system.id ?? "");
+    required(systemId, "SDK_SYSTEM_ID_MISSING");
+    const connectionResult = await this.connectAdapter(systemId, {
+      adapterType: input.adapterType,
+      adapterVersion: input.adapterVersion,
+      capabilities: input.capabilities,
+      config: input.config,
+      idempotencyKey: input.idempotencyKey
+    });
+    if (!connectionResult) return null;
+    return {
+      status: connectionResult.status,
+      requestId: connectionResult.requestId,
+      body: {
+        system: systemResult.body.system,
+        connection: connectionResult.body.connection,
+        handshake: connectionResult.body.handshake
+      }
+    };
+  }
+  observe(event, options = {}) {
+    return this.request(buildObservationRequest(event), {
+      idempotencyKey: options.idempotencyKey ?? event.eventId
+    });
+  }
+  trace(event, options = {}) {
+    return this.observe({ ...event, eventType: "model.response" }, options);
+  }
+  outcome(event, options = {}) {
+    return this.observe({ ...event, eventType: "business.outcome" }, options);
+  }
+  feedback(event, options = {}) {
+    return this.observe({ ...event, eventType: "feedback.user" }, options);
+  }
+  observeBatch(events, options = {}) {
+    if (!Array.isArray(events) || events.length < 1 || events.length > 100)
+      throw new Error("SDK_OBSERVATION_BATCH_INVALID");
+    return this.request(
+      {
+        method: "POST",
+        path: "/v1/observations/batch",
+        body: { events: [...events] }
+      },
+      { idempotencyKey: options.idempotencyKey }
+    );
+  }
+  observeSdk(delivery, options = {}) {
+    return this.request(
+      { method: "POST", path: "/v1/observations/sdk", body: delivery },
+      { idempotencyKey: options.idempotencyKey }
+    );
+  }
+  discover(reviewState) {
+    return this.request({
+      method: "GET",
+      path: "/v1/discovery/candidates",
+      query: reviewState ? { reviewState } : void 0
+    });
+  }
+  createSignalDiscoveryProposal(input, options = {}) {
+    return this.request({ method: "POST", path: "/v1/signals/discovery-proposals", body: input }, { idempotencyKey: options.idempotencyKey ?? String(input.signalStableKey ?? "") });
+  }
+  reviewSignalDiscoveryProposal(proposalId, decision, options = {}) {
+    required(proposalId, "SDK_SIGNAL_PROPOSAL_ID_REQUIRED");
+    return this.request({ method: "POST", path: `/v1/signals/discovery-proposals/${encodeURIComponent(proposalId)}/review`, body: { decision } }, { idempotencyKey: options.idempotencyKey ?? `signal-review:${proposalId}` });
+  }
+  materializeSignalDiscovery(proposalId, input = {}, options = {}) {
+    required(proposalId, "SDK_SIGNAL_PROPOSAL_ID_REQUIRED");
+    return this.request({ method: "POST", path: `/v1/signals/discovery-proposals/${encodeURIComponent(proposalId)}/materialize`, body: input }, { idempotencyKey: options.idempotencyKey ?? `signal-materialize:${proposalId}` });
+  }
+  createSignalMapping(input, options = {}) {
+    return this.request({ method: "POST", path: "/v1/signals/mappings", body: input }, { idempotencyKey: options.idempotencyKey ?? String(input.signalStableKey ?? "") });
+  }
+  getSignalMapping(mappingId) {
+    required(mappingId, "SDK_SIGNAL_MAPPING_ID_REQUIRED");
+    return this.request({ method: "GET", path: `/v1/signals/mappings/${encodeURIComponent(mappingId)}` });
+  }
+  reviewSignalMapping(mappingId, input = {}, options = {}) {
+    required(mappingId, "SDK_SIGNAL_MAPPING_ID_REQUIRED");
+    return this.request({ method: "POST", path: `/v1/signals/mappings/${encodeURIComponent(mappingId)}/review`, body: input }, { idempotencyKey: options.idempotencyKey ?? `signal-mapping-review:${mappingId}` });
+  }
+  connectionHealth(connectionId) {
+    required(connectionId, "SDK_CONNECTION_ID_REQUIRED");
+    return this.request({
+      method: "GET",
+      path: `/v1/connections/${encodeURIComponent(connectionId)}/health`
+    });
+  }
+  inventory(systemId) {
+    required(systemId, "SDK_SYSTEM_ID_REQUIRED");
+    return this.request({
+      method: "GET",
+      path: `/v1/ai-systems/${encodeURIComponent(systemId)}/inventory`
+    });
+  }
+  listPacks() {
+    return this.request({
+      method: "GET",
+      path: "/v1/packs"
+    });
+  }
+  importPack(input) {
+    if (!input?.manifest && !input?.archiveBase64)
+      throw new Error("SDK_PACK_MANIFEST_OR_ARCHIVE_REQUIRED");
+    if (input.archiveBase64 && !input.fileName)
+      throw new Error("SDK_PACK_FILE_NAME_REQUIRED");
+    return this.request(
+      {
+        method: "POST",
+        path: "/v1/packs/import",
+        body: {
+          ...input.manifest ? { manifest: input.manifest } : {},
+          objects: input.objects ?? {},
+          ...input.archiveBase64 ? { archiveBase64: input.archiveBase64, fileName: input.fileName } : {}
+        }
+      },
+      { idempotencyKey: input.idempotencyKey ?? `sdk:pack:${Date.now()}` }
+    );
+  }
+  installPack(packId, variables = {}) {
+    required(packId, "SDK_PACK_ID_REQUIRED");
+    return this.request(
+      {
+        method: "POST",
+        path: `/v1/packs/${encodeURIComponent(packId)}/install`,
+        body: { variables }
+      },
+      { idempotencyKey: `sdk:pack:install:${packId}` }
+    );
+  }
+  evaluatePack(packId, input) {
+    required(packId, "SDK_PACK_ID_REQUIRED");
+    return this.request(
+      {
+        method: "POST",
+        path: `/v1/packs/${encodeURIComponent(packId)}/evaluate`,
+        body: { ...input }
+      },
+      { idempotencyKey: `sdk:pack:evaluate:${packId}` }
+    );
+  }
+  approvePack(packId) {
+    required(packId, "SDK_PACK_ID_REQUIRED");
+    return this.request(
+      {
+        method: "POST",
+        path: `/v1/packs/${encodeURIComponent(packId)}/approve`,
+        body: {}
+      },
+      { idempotencyKey: `sdk:pack:approve:${packId}` }
+    );
+  }
+  releasePack(packId) {
+    required(packId, "SDK_PACK_ID_REQUIRED");
+    return this.request(
+      {
+        method: "POST",
+        path: `/v1/packs/${encodeURIComponent(packId)}/release`,
+        body: {}
+      },
+      { idempotencyKey: `sdk:pack:release:${packId}` }
+    );
+  }
+  previewPackUpgrade(packId, incoming) {
+    required(packId, "SDK_PACK_ID_REQUIRED");
+    if (!incoming || typeof incoming !== "object")
+      throw new Error("SDK_PACK_UPGRADE_INPUT_REQUIRED");
+    return this.request(
+      {
+        method: "POST",
+        path: `/v1/packs/${encodeURIComponent(packId)}/upgrade-preview`,
+        body: { incoming }
+      },
+      { idempotencyKey: `sdk:pack:upgrade-preview:${packId}` }
+    );
+  }
+  executeRuntime(input) {
+    return this.request(
+      {
+        method: "POST",
+        path: "/v1/runtime/execute",
+        body: buildRuntimeRequest(
+          input
+        )
+      },
+      { idempotencyKey: input.idempotencyKey, enforcing: true }
+    );
+  }
+  resolveRuntime(input) {
+    if (!input.behaviorPoint && !input.executionBoundary && !input.semanticContext)
+      throw new Error("SDK_RUNTIME_ROUTE_REQUIRED");
+    return this.request(
+      {
+        method: "POST",
+        path: "/v1/runtime/resolve",
+        body: {
+          ...input.behaviorPoint ? { behaviorPoint: input.behaviorPoint } : {},
+          ...input.executionBoundary ? { executionBoundary: input.executionBoundary } : {},
+          ...input.semanticContext ? { semanticContext: input.semanticContext } : {}
+        }
+      },
+      {
+        idempotencyKey: input.idempotencyKey ?? `sdk:resolve:${input.behaviorPoint ?? "boundary"}`,
+        enforcing: true
+      }
+    );
+  }
+  /** Resolve a runtime route from a governed execution boundary and semantic context. */
+  resolveBoundary(input) {
+    if (!input.executionBoundary || typeof input.executionBoundary !== "object")
+      throw new Error("SDK_EXECUTION_BOUNDARY_REQUIRED");
+    return this.resolveRuntime({
+      executionBoundary: input.executionBoundary,
+      ...input.semanticContext ? { semanticContext: input.semanticContext } : {},
+      idempotencyKey: input.idempotencyKey
+    });
+  }
+  resolveSemantic(input) {
+    required(input.input, "SDK_SEMANTIC_INPUT_REQUIRED");
+    const { idempotencyKey, requestId, ...body } = input;
+    const resolvedRequestId = requestId ?? `sdk-semantic-${Date.now()}-${Math.random().toString(36).slice(2, 10)}`;
+    return this.request(
+      {
+        method: "POST",
+        path: "/v1/semantic/resolve",
+        body: { ...body, requestId: resolvedRequestId }
+      },
+      { idempotencyKey: idempotencyKey ?? `sdk:semantic:${resolvedRequestId}` }
+    );
+  }
+  async resolveSemanticRuntime(input) {
+    const semantic = await this.resolveSemantic(input);
+    if (!semantic) return null;
+    const body = semantic.body;
+    const receipt = body.receipt && typeof body.receipt === "object" ? body.receipt : {};
+    if (receipt.outcome !== "select" || typeof receipt.taskKey !== "string")
+      return { semantic, runtime: null };
+    const capsules = Array.isArray(body.capsules) ? body.capsules : [];
+    const firstCapsule = capsules[0] && typeof capsules[0] === "object" ? capsules[0] : {};
+    const behaviorPoint = typeof firstCapsule.behaviorKey === "string" && firstCapsule.behaviorKey.trim() ? firstCapsule.behaviorKey : receipt.taskKey;
+    const runtime = input.executionBoundary ? await this.resolveBoundary({
+      executionBoundary: input.executionBoundary,
+      semanticContext: {
+        taskKey: receipt.taskKey,
+        behaviorPoint,
+        capsule: firstCapsule
+      },
+      idempotencyKey: input.idempotencyKey ? `sdk:runtime:${input.idempotencyKey}` : void 0
+    }) : await this.resolveRuntime({
+      semanticContext: { taskKey: receipt.taskKey, behaviorPoint, capsule: firstCapsule },
+      idempotencyKey: input.idempotencyKey ? `sdk:runtime:${input.idempotencyKey}` : void 0
+    });
+    return { semantic, runtime };
+  }
+  listBehaviorStrategies() {
+    return this.request({
+      method: "GET",
+      path: "/v1/behavior-strategies"
+    });
+  }
+  deleteBehaviorStrategy(strategyId, options = {}) {
+    required(strategyId, "SDK_STRATEGY_ID_REQUIRED");
+    return this.request({ method: "DELETE", path: `/v1/behavior-strategies/${encodeURIComponent(strategyId)}`, body: { confirm: options.confirm === true } }, { idempotencyKey: options.idempotencyKey ?? `sdk:delete:strategy:${strategyId}` });
+  }
+  getBehaviorStrategy(strategyId) {
+    required(strategyId, "SDK_STRATEGY_ID_REQUIRED");
+    return this.request({
+      method: "GET",
+      path: `/v1/behavior-strategies/${encodeURIComponent(strategyId)}`
+    });
+  }
+  createBehaviorStrategy(definition, id) {
+    if (!definition) throw new Error("SDK_STRATEGY_DEFINITION_REQUIRED");
+    return this.request({
+      method: "POST",
+      path: "/v1/behavior-strategies",
+      body: { definition, ...id ? { id } : {} }
+    });
+  }
+  listSemanticTasks() {
+    return this.request({ method: "GET", path: "/v1/semantic-tasks" });
+  }
+  deleteSemanticTask(taskId, options = {}) {
+    required(taskId, "SDK_SEMANTIC_TASK_ID_REQUIRED");
+    return this.request({ method: "DELETE", path: `/v1/semantic-tasks/${encodeURIComponent(taskId)}`, body: { confirm: options.confirm === true } }, { idempotencyKey: options.idempotencyKey ?? `sdk:delete:semantic-task:${taskId}` });
+  }
+  createSemanticTask(task, options = {}) {
+    required(task?.taskKey, "SDK_SEMANTIC_TASK_KEY_REQUIRED");
+    return this.request({ method: "POST", path: "/v1/semantic-tasks", body: { ...task, ...options.id ? { id: options.id } : {} } }, { idempotencyKey: options.idempotencyKey ?? `sdk:semantic-task:${task.taskKey}` });
+  }
+  listBehaviorPoints() {
+    return this.request({ method: "GET", path: "/v1/behavior-points" });
+  }
+  deleteBehaviorPoint(pointId, options = {}) {
+    required(pointId, "SDK_BEHAVIOR_POINT_ID_REQUIRED");
+    return this.request({ method: "DELETE", path: `/v1/behavior-points/${encodeURIComponent(pointId)}`, body: { confirm: options.confirm === true } }, { idempotencyKey: options.idempotencyKey ?? `sdk:delete:behavior-point:${pointId}` });
+  }
+  createBehaviorPoint(point, options = {}) {
+    required(point?.key, "SDK_BEHAVIOR_POINT_KEY_REQUIRED");
+    if (!point.taskId && !point.taskIds?.length) throw new Error("SDK_BEHAVIOR_POINT_TASK_REQUIRED");
+    return this.request({ method: "POST", path: "/v1/behavior-points", body: { ...point, ...options.id ? { id: options.id } : {} } }, { idempotencyKey: options.idempotencyKey ?? `sdk:behavior-point:${point.key}` });
+  }
+  createBehaviorStrategyVariant(strategyId, variant, options = {}) {
+    required(strategyId, "SDK_STRATEGY_ID_REQUIRED");
+    if (!variant || typeof variant !== "object")
+      throw new Error("SDK_STRATEGY_VARIANT_REQUIRED");
+    return this.request(
+      {
+        method: "POST",
+        path: `/v1/behavior-strategies/${encodeURIComponent(strategyId)}/variants`,
+        body: variant
+      },
+      { idempotencyKey: options.idempotencyKey }
+    );
+  }
+  validateBehaviorStrategy(strategyId) {
+    required(strategyId, "SDK_STRATEGY_ID_REQUIRED");
+    return this.request({
+      method: "POST",
+      path: `/v1/behavior-strategies/${encodeURIComponent(strategyId)}/validate`,
+      body: {}
+    });
+  }
+  activateBehaviorStrategy(strategyId) {
+    required(strategyId, "SDK_STRATEGY_ID_REQUIRED");
+    return this.request({ method: "POST", path: `/v1/behavior-strategies/${encodeURIComponent(strategyId)}/activate`, body: {} });
+  }
+  simulateBehaviorStrategy(strategyId, initialState = {}) {
+    required(strategyId, "SDK_STRATEGY_ID_REQUIRED");
+    return this.request({
+      method: "POST",
+      path: `/v1/behavior-strategies/${encodeURIComponent(strategyId)}/simulate`,
+      body: { initialState }
+    });
+  }
+  startStrategyExecution(input) {
+    required(input.artifactDigest, "SDK_ARTIFACT_DIGEST_REQUIRED");
+    for (const value of [
+      input.organizationId,
+      input.projectId,
+      input.environmentId,
+      input.revisionId,
+      input.idempotencyKey,
+      input.nonce,
+      input.decisionPlanId,
+      input.policy
+    ])
+      required(value, "SDK_STRATEGY_START_FIELD_REQUIRED");
+    if (input.behaviorPoint !== void 0)
+      required(input.behaviorPoint, "SDK_BEHAVIOR_POINT_REQUIRED");
+    if (!Array.isArray(input.candidates) || input.candidates.length === 0)
+      throw new Error("SDK_STRATEGY_CANDIDATES_REQUIRED");
+    if (!Number.isFinite(input.expiresAt))
+      throw new Error("SDK_EXPIRY_REQUIRED");
+    const body = {
+      ...buildRuntimeRequest(input),
+      artifactDigest: input.artifactDigest,
+      ...input.behaviorPoint ? { behaviorPoint: input.behaviorPoint } : {},
+      ...input.executionBoundary ? { executionBoundary: input.executionBoundary } : {},
+      ...input.traceId ? { traceId: input.traceId } : {},
+      ...input.executionId ? { executionId: input.executionId } : {},
+      ...input.state ? { state: input.state } : {}
+    };
+    return this.request(
+      { method: "POST", path: "/v1/runtime/strategy-executions", body },
+      { idempotencyKey: input.idempotencyKey }
+    );
+  }
+  getStrategyExecution(executionId) {
+    required(executionId, "SDK_EXECUTION_ID_REQUIRED");
+    return this.request({
+      method: "GET",
+      path: `/v1/runtime/strategy-executions/${encodeURIComponent(executionId)}`
+    });
+  }
+  getStrategyExecutionTrace(executionId) {
+    required(executionId, "SDK_EXECUTION_ID_REQUIRED");
+    return this.request({
+      method: "GET",
+      path: `/v1/runtime/strategy-executions/${encodeURIComponent(executionId)}/trace`
+    });
+  }
+  continueStrategyExecution(executionId, continuation) {
+    required(executionId, "SDK_EXECUTION_ID_REQUIRED");
+    const input = typeof continuation === "string" ? { authorityDigest: continuation } : continuation ?? {};
+    return this.request({
+      method: "POST",
+      path: `/v1/runtime/strategy-executions/${encodeURIComponent(executionId)}/continue`,
+      body: {
+        ...input.authorityDigest ? { authorityDigest: input.authorityDigest } : {},
+        ...input.state ? { state: input.state } : {},
+        ...input.references ? { references: input.references } : {}
+      }
+    });
+  }
+  cancelStrategyExecution(executionId) {
+    required(executionId, "SDK_EXECUTION_ID_REQUIRED");
+    return this.request({
+      method: "POST",
+      path: `/v1/runtime/strategy-executions/${encodeURIComponent(executionId)}/cancel`,
+      body: {}
+    });
+  }
+  listBehaviorPrograms() {
+    return this.request({
+      method: "GET",
+      path: "/v1/behavior-programs"
+    });
+  }
+  listCapabilities(options = {}) {
+    const query = options.surface ? `?surface=${encodeURIComponent(options.surface)}` : "";
+    return this.request({ method: "GET", path: `/v1/capabilities${query}` });
+  }
+  getBehaviorProgram(programId) {
+    required(programId, "SDK_PROGRAM_ID_REQUIRED");
+    return this.request({
+      method: "GET",
+      path: `/v1/behavior-programs/${encodeURIComponent(programId)}`
+    });
+  }
+  createBehaviorProgram(program, options = {}) {
+    if (!program || typeof program !== "object")
+      throw new Error("SDK_PROGRAM_REQUIRED");
+    return this.request(
+      { method: "POST", path: "/v1/behavior-programs", body: program },
+      {
+        idempotencyKey: options.idempotencyKey ?? `sdk:program:${String(program.id ?? "")}`
+      }
+    );
+  }
+  attestCapabilities(attestation, options = {}) {
+    return this.request(
+      {
+        method: "POST",
+        path: "/v1/runtime/capabilities/attest",
+        body: attestation
+      },
+      { idempotencyKey: options.idempotencyKey }
+    );
+  }
+  resolveCapabilities(attestationId, request, options = {}) {
+    required(attestationId, "SDK_ATTESTATION_ID_REQUIRED");
+    return this.request(
+      {
+        method: "POST",
+        path: "/v1/runtime/capabilities/resolve",
+        body: { attestationId, request }
+      },
+      { idempotencyKey: options.idempotencyKey, enforcing: true }
+    );
+  }
+  recordCapabilityTrace(decisionDigest, trace, options = {}) {
+    required(decisionDigest, "SDK_DECISION_DIGEST_REQUIRED");
+    return this.request(
+      {
+        method: "POST",
+        path: "/v1/runtime/capabilities/traces",
+        body: { decisionDigest, trace }
+      },
+      { idempotencyKey: options.idempotencyKey }
+    );
+  }
+  resolveModelServing(request, options = {}) {
+    return this.request(
+      { method: "POST", path: "/v1/model-serving/resolve", body: request },
+      { idempotencyKey: options.idempotencyKey, enforcing: true }
+    );
+  }
+  recordModelServingTrace(trace, selection, options = {}) {
+    return this.request(
+      {
+        method: "POST",
+        path: "/v1/model-serving/traces",
+        body: { trace, selection }
+      },
+      { idempotencyKey: options.idempotencyKey }
+    );
+  }
+  submitTeachEvidence(evidence, options = {}) {
+    return this.request(
+      { method: "POST", path: "/v1/teach/evidence", body: evidence },
+      { idempotencyKey: options.idempotencyKey }
+    );
+  }
+  createTeachProposal(input, options = {}) {
+    return this.request({ method: "POST", path: "/v1/teach/proposals", body: input }, { idempotencyKey: options.idempotencyKey });
+  }
+  transitionTeachProposal(proposalId, transition, input = {}, options = {}) {
+    required(proposalId, "SDK_TEACH_PROPOSAL_ID_REQUIRED");
+    return this.request({ method: "POST", path: `/v1/teach/proposals/${encodeURIComponent(proposalId)}/${transition}`, body: input }, { idempotencyKey: options.idempotencyKey ?? `sdk:teach:${transition}:${proposalId}` });
+  }
+  startEvaluation(input, options = {}) {
+    return this.request(
+      { method: "POST", path: "/v1/evaluations", body: input },
+      { idempotencyKey: options.idempotencyKey }
+    );
+  }
+  evaluateQuality(input, options = {}) {
+    return this.request(
+      { method: "POST", path: "/v1/quality/evaluate", body: input },
+      { idempotencyKey: options.idempotencyKey }
+    );
+  }
+  getEvaluation(evaluationId) {
+    required(evaluationId, "SDK_EVALUATION_ID_REQUIRED");
+    return this.request({
+      method: "GET",
+      path: `/v1/evaluations/${encodeURIComponent(evaluationId)}`
+    });
+  }
+  createRelease(input, options = {}) {
+    return this.request(
+      { method: "POST", path: "/v1/releases", body: input },
+      { idempotencyKey: options.idempotencyKey }
+    );
+  }
+  createManualRelease(input, options = {}) {
+    if (!input || typeof input !== "object" || !input.manualApproval) throw new Error("SDK_MANUAL_RELEASE_APPROVAL_REQUIRED");
+    return this.createRelease(input, { idempotencyKey: options.idempotencyKey });
+  }
+  releaseProgramManually(input, options = {}) {
+    required(input?.programId, "SDK_MANUAL_RELEASE_PROGRAM_REQUIRED");
+    required(input?.reason, "SDK_MANUAL_RELEASE_REASON_REQUIRED");
+    return this.request({ method: "POST", path: "/v1/releases/manual-program", body: { programId: input.programId, reason: input.reason } }, { idempotencyKey: options.idempotencyKey ?? `sdk:manual-release:${input.programId}` });
+  }
+  recordDeploymentComparison(deploymentId, comparison, options = {}) {
+    required(deploymentId, "SDK_DEPLOYMENT_ID_REQUIRED");
+    return this.request(
+      {
+        method: "POST",
+        path: `/v1/deployments/${encodeURIComponent(deploymentId)}/comparisons`,
+        body: comparison
+      },
+      { idempotencyKey: options.idempotencyKey }
+    );
+  }
+  recordDeploymentHealth(deploymentId, health, options = {}) {
+    required(deploymentId, "SDK_DEPLOYMENT_ID_REQUIRED");
+    return this.request(
+      {
+        method: "POST",
+        path: `/v1/deployments/${encodeURIComponent(deploymentId)}/authoritative-health`,
+        body: health
+      },
+      { idempotencyKey: options.idempotencyKey }
+    );
+  }
+  compileBehaviorCapsule(input) {
+    required(input.programId, "SDK_PROGRAM_ID_REQUIRED");
+    required(input.input, "SDK_RUNTIME_INPUT_REQUIRED");
+    return this.request(
+      {
+        method: "POST",
+        path: "/v1/runtime/behavior-capsule",
+        body: { ...input }
+      },
+      {
+        idempotencyKey: input.idempotencyKey ?? `sdk:capsule:${input.programId}`
+      }
+    );
+  }
+  serveBehaviorProjection(input) {
+    required(input.input, "SDK_RUNTIME_INPUT_REQUIRED");
+    required(input.provider, "SDK_PROVIDER_REQUIRED");
+    return this.request(
+      {
+        method: "POST",
+        path: "/v1/runtime/behavior-projection",
+        body: { ...input }
+      },
+      {
+        idempotencyKey: input.idempotencyKey ?? `sdk:projection:${input.programId ?? "active"}`
+      }
+    );
+  }
+  async testConnection(connectionId) {
+    required(connectionId, "SDK_CONNECTION_ID_REQUIRED");
+    return this.request({
+      method: "POST",
+      path: `/v1/connections/${encodeURIComponent(connectionId)}/test`,
+      body: {}
+    });
+  }
+};
+function buildRuntimeRequest(input) {
+  const {
+    organizationId,
+    projectId,
+    environmentId,
+    revisionId,
+    idempotencyKey,
+    nonce,
+    expiresAt,
+    decisionPlanId,
+    calibrationId,
+    candidates,
+    allowedIds,
+    policy,
+    postModelJudge,
+    shadow
+  } = input;
+  for (const value of [
+    organizationId,
+    projectId,
+    environmentId,
+    revisionId,
+    idempotencyKey,
+    nonce
+  ])
+    if (typeof value !== "string" || !value.trim())
+      throw new Error("SDK_REQUEST_FIELD_REQUIRED");
+  if (!Number.isFinite(expiresAt)) throw new Error("SDK_EXPIRY_REQUIRED");
+  const boundary = {
+    ...typeof decisionPlanId === "string" ? { decisionPlanId } : {},
+    ...typeof calibrationId === "string" ? { calibrationId } : {},
+    ...Array.isArray(candidates) ? { candidates } : {},
+    ...Array.isArray(allowedIds) ? { allowedIds } : {},
+    ...typeof policy === "string" ? { policy } : {},
+    ...postModelJudge !== void 0 ? { postModelJudge } : {},
+    ...shadow !== void 0 ? { shadow } : {}
+  };
+  return Object.freeze({
+    organizationId,
+    projectId,
+    environmentId,
+    revisionId,
+    idempotencyKey,
+    nonce,
+    expiresAt,
+    ...boundary
+  });
+}
+function buildPublicContentRequest(input) {
+  const { slug, version = "v1" } = input;
+  if (typeof slug !== "string" || !slug.trim())
+    throw new Error("SDK_SLUG_REQUIRED");
+  if (version !== "v1") throw new Error("SDK_VERSION_UNSUPPORTED");
+  return Object.freeze({
+    method: "GET",
+    path: "/v1/content",
+    query: Object.freeze({ slug })
+  });
+}
+function buildDocsQueryRequest(input) {
+  const { query, operation = "search" } = input;
+  if (typeof query !== "string" || !query.trim())
+    throw new Error("SDK_QUERY_REQUIRED");
+  if (!["search", "ask"].includes(operation))
+    throw new Error("SDK_OPERATION_UNSUPPORTED");
+  return Object.freeze({
+    method: "GET",
+    path: `/docs/${operation}`,
+    query: Object.freeze({ query })
+  });
+}
+function buildAISystemRequest(input) {
+  const { name, systemType, organizationId, projectId, environmentId } = input;
+  for (const value of [
+    name,
+    systemType,
+    organizationId,
+    projectId,
+    environmentId
+  ])
+    if (typeof value !== "string" || !value.trim())
+      throw new Error("SDK_AI_SYSTEM_FIELD_REQUIRED");
+  return Object.freeze({
+    method: "POST",
+    path: "/v1/ai-systems",
+    body: Object.freeze({
+      name,
+      systemType,
+      organizationId,
+      projectId,
+      environmentId
+    })
+  });
+}
+function buildObservationRequest(event) {
+  if (!event?.eventId || !event.eventType || !event.aiSystemId || !event.connectionId)
+    throw new Error("SDK_OBSERVATION_FIELD_REQUIRED");
+  return Object.freeze({
+    method: "POST",
+    path: "/v1/observations",
+    body: Object.freeze({ ...event })
+  });
+}
+export {
+  ViraApiError,
+  ViraClient,
+  buildAISystemRequest,
+  buildDocsQueryRequest,
+  buildObservationRequest,
+  buildPublicContentRequest,
+  buildRuntimeRequest
+};