@xemahq/llm-registry-api-client 0.8.12 → 0.10.0

package/dist/custom-fetch.d.ts

@@ -97,6 +97,7 @@ export declare class ClientError extends Error {
     readonly url: string;
     readonly body: unknown;
     constructor(status: number, url: string, body: unknown);
+    static [Symbol.hasInstance](candidate: unknown): boolean;
 }
 export declare function configureClient(config: ClientConfig): void;
 export declare function getClientConfig(): ClientConfig;

package/dist/custom-fetch.js

@@ -19,6 +19,50 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.customFetch = exports.ClientError = void 0;
 exports.configureClient = configureClient;
 exports.getClientConfig = getClientConfig;
+/**
+ * Cross-package identity for `ClientError`.
+ *
+ * ── THE OUTAGE THIS IS FOR ────────────────────────────────────────────────
+ *
+ * PRODUCTION, 2026-09-22. A session launch aborted on
+ * `HTTP 503 from http://skill-registry-api…/skills`. A 503 is the archetypal
+ * TRANSIENT — agent-session's launch taxonomy already listed it as retryable —
+ * but it was classified PERMANENT and the launch was abandoned.
+ *
+ * The cause was this file. Every generated client package gets its OWN copy of
+ * `ClientError`, so there are as many classes as there are clients (81 at the
+ * time of writing), all byte-identical and all DIFFERENT OBJECTS. A consumer
+ * naturally writes `err instanceof ClientError` against the one client it
+ * imported — which reads as obviously correct and is silently package-local. An
+ * error from any OTHER client fails it, falls past every status check, and lands
+ * on whatever the default is.
+ *
+ * That was not the first time: biome-host had already switched to structural
+ * detection for the same reason, and canopy imports TWO `ClientError` classes
+ * and tests both. Three more call sites elsewhere carry the same shape.
+ *
+ * ── WHY A BRAND AND NOT A SHARED PACKAGE ─────────────────────────────────
+ *
+ * The obvious fix is one shared runtime class every client imports. It was
+ * rejected on measurement: the 81 generated clients are DEPENDENCY-FREE by
+ * design (exactly one has any dependency at all), and a shared class would have
+ * to be a PEER dependency to be safe — a normal dependency can be installed
+ * twice under version skew, which reinstates this identical bug in a form that
+ * is HARDER to see, because the classes then look like they ought to match.
+ *
+ * `Symbol.for` is a process-wide registry keyed by STRING, so every copy of
+ * this template resolves the same symbol without importing anything. The brand
+ * costs no dependency, cannot skew, and needs no new package.
+ *
+ * `Symbol.hasInstance` then makes plain `instanceof` mean the right thing
+ * fleet-wide: an error from ANY generated client satisfies `instanceof
+ * ClientError` in ANY other. A helper would have made the safe pattern
+ * available; this makes the dangerous pattern impossible.
+ *
+ * Narrow on purpose — the brand is set only by this constructor, so an unrelated
+ * error carrying a `status` is not admitted.
+ */
+const CLIENT_ERROR_BRAND = Symbol.for('xema.generatedClientError');
 class ClientError extends Error {
     status;
     url;
@@ -29,6 +73,14 @@ class ClientError extends Error {
         this.url = url;
         this.body = body;
         this.name = 'ClientError';
+        // Non-enumerable: it must not appear in JSON, logs or snapshots — it is an
+        // identity marker, not payload.
+        Object.defineProperty(this, CLIENT_ERROR_BRAND, { value: true });
+    }
+    static [Symbol.hasInstance](candidate) {
+        return (typeof candidate === 'object' &&
+            candidate !== null &&
+            CLIENT_ERROR_BRAND in candidate);
     }
 }
 exports.ClientError = ClientError;

package/dist/endpoints/model-strategies/model-strategies.d.ts

@@ -3,7 +3,7 @@
  * LLM Registry API
  * OpenAPI spec version: 0.1.3
  */
-import type { BindModelStrategyDto, CreateModelStrategyDto, ModelStrategyControllerGetProjectBinding200, ModelStrategyResponseDtoDataArrayEnvelope, ModelStrategyResponseDtoDataEnvelope, OrgDefaultStrategyStatusResponseDtoDataEnvelope, ProjectModelStrategyBindingResponseDtoDataEnvelope, StrategyDeletionImpactResponseDtoDataEnvelope, StrategyTemplateResponseDtoDataArrayEnvelope, UpdateModelStrategyDto, UpsertModelStrategyEntriesDto } from '../../models';
+import type { BindModelStrategyDto, CreateModelStrategyDto, ModelStrategyControllerGetProjectBinding200, ModelStrategyResponseDtoDataArrayEnvelope, ModelStrategyResponseDtoDataEnvelope, OrgDefaultStrategyStatusResponseDtoDataEnvelope, ProjectModelStrategyBindingResponseDtoDataEnvelope, StrategyDeletionImpactResponseDtoDataEnvelope, StrategyTemplateResponseDtoDataArrayEnvelope, UpdateModelStrategyDto, UpsertModelStrategyEntriesDto, UpsertModelStrategyEntryDto } from '../../models';
 export declare const getModelStrategyControllerCreateStrategyUrl: () => string;
 /**
  * @summary Create a model strategy
@@ -54,6 +54,16 @@ export declare const getModelStrategyControllerUpsertEntriesUrl: (id: string) =>
  * @summary Replace all strategy entries
  */
 export declare const modelStrategyControllerUpsertEntries: (id: string, upsertModelStrategyEntriesDto: UpsertModelStrategyEntriesDto, options?: RequestInit) => Promise<ModelStrategyResponseDtoDataEnvelope>;
+export declare const getModelStrategyControllerUpsertEntryUrl: (id: string, lane: string) => string;
+/**
+ * @summary Bind one model lane, leaving every other lane untouched
+ */
+export declare const modelStrategyControllerUpsertEntry: (id: string, lane: string, upsertModelStrategyEntryDto: UpsertModelStrategyEntryDto, options?: RequestInit) => Promise<ModelStrategyResponseDtoDataEnvelope>;
+export declare const getModelStrategyControllerDeleteEntryUrl: (id: string, lane: string) => string;
+/**
+ * @summary Clear one model lane, so it falls back to the default binding
+ */
+export declare const modelStrategyControllerDeleteEntry: (id: string, lane: string, options?: RequestInit) => Promise<ModelStrategyResponseDtoDataEnvelope>;
 export declare const getModelStrategyControllerBindStrategyUrl: (projectId: string) => string;
 /**
  * @summary Bind a model strategy to a project

package/dist/endpoints/model-strategies/model-strategies.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.modelStrategyControllerUnbindStrategy = exports.getModelStrategyControllerUnbindStrategyUrl = exports.modelStrategyControllerGetProjectBinding = exports.getModelStrategyControllerGetProjectBindingUrl = exports.modelStrategyControllerBindStrategy = exports.getModelStrategyControllerBindStrategyUrl = exports.modelStrategyControllerUpsertEntries = exports.getModelStrategyControllerUpsertEntriesUrl = exports.modelStrategyControllerGetStrategyDeletionImpact = exports.getModelStrategyControllerGetStrategyDeletionImpactUrl = exports.modelStrategyControllerDeleteStrategy = exports.getModelStrategyControllerDeleteStrategyUrl = exports.modelStrategyControllerUpdateStrategy = exports.getModelStrategyControllerUpdateStrategyUrl = exports.modelStrategyControllerGetStrategy = exports.getModelStrategyControllerGetStrategyUrl = exports.modelStrategyControllerAdoptTemplate = exports.getModelStrategyControllerAdoptTemplateUrl = exports.modelStrategyControllerListTemplates = exports.getModelStrategyControllerListTemplatesUrl = exports.modelStrategyControllerGetOrgDefaultStatus = exports.getModelStrategyControllerGetOrgDefaultStatusUrl = exports.modelStrategyControllerListStrategies = exports.getModelStrategyControllerListStrategiesUrl = exports.modelStrategyControllerCreateStrategy = exports.getModelStrategyControllerCreateStrategyUrl = void 0;
+exports.modelStrategyControllerUnbindStrategy = exports.getModelStrategyControllerUnbindStrategyUrl = exports.modelStrategyControllerGetProjectBinding = exports.getModelStrategyControllerGetProjectBindingUrl = exports.modelStrategyControllerBindStrategy = exports.getModelStrategyControllerBindStrategyUrl = exports.modelStrategyControllerDeleteEntry = exports.getModelStrategyControllerDeleteEntryUrl = exports.modelStrategyControllerUpsertEntry = exports.getModelStrategyControllerUpsertEntryUrl = exports.modelStrategyControllerUpsertEntries = exports.getModelStrategyControllerUpsertEntriesUrl = exports.modelStrategyControllerGetStrategyDeletionImpact = exports.getModelStrategyControllerGetStrategyDeletionImpactUrl = exports.modelStrategyControllerDeleteStrategy = exports.getModelStrategyControllerDeleteStrategyUrl = exports.modelStrategyControllerUpdateStrategy = exports.getModelStrategyControllerUpdateStrategyUrl = exports.modelStrategyControllerGetStrategy = exports.getModelStrategyControllerGetStrategyUrl = exports.modelStrategyControllerAdoptTemplate = exports.getModelStrategyControllerAdoptTemplateUrl = exports.modelStrategyControllerListTemplates = exports.getModelStrategyControllerListTemplatesUrl = exports.modelStrategyControllerGetOrgDefaultStatus = exports.getModelStrategyControllerGetOrgDefaultStatusUrl = exports.modelStrategyControllerListStrategies = exports.getModelStrategyControllerListStrategiesUrl = exports.modelStrategyControllerCreateStrategy = exports.getModelStrategyControllerCreateStrategyUrl = void 0;
 const custom_fetch_1 = require("../../custom-fetch");
 const getModelStrategyControllerCreateStrategyUrl = () => {
     return `/model-strategies`;
@@ -148,6 +148,36 @@ const modelStrategyControllerUpsertEntries = async (id, upsertModelStrategyEntri
     });
 };
 exports.modelStrategyControllerUpsertEntries = modelStrategyControllerUpsertEntries;
+const getModelStrategyControllerUpsertEntryUrl = (id, lane) => {
+    return `/model-strategies/${id}/entries/${lane}`;
+};
+exports.getModelStrategyControllerUpsertEntryUrl = getModelStrategyControllerUpsertEntryUrl;
+/**
+ * @summary Bind one model lane, leaving every other lane untouched
+ */
+const modelStrategyControllerUpsertEntry = async (id, lane, upsertModelStrategyEntryDto, options) => {
+    return (0, custom_fetch_1.customFetch)((0, exports.getModelStrategyControllerUpsertEntryUrl)(id, lane), {
+        ...options,
+        method: 'PUT',
+        headers: { 'Content-Type': 'application/json', ...options?.headers },
+        body: JSON.stringify(upsertModelStrategyEntryDto)
+    });
+};
+exports.modelStrategyControllerUpsertEntry = modelStrategyControllerUpsertEntry;
+const getModelStrategyControllerDeleteEntryUrl = (id, lane) => {
+    return `/model-strategies/${id}/entries/${lane}`;
+};
+exports.getModelStrategyControllerDeleteEntryUrl = getModelStrategyControllerDeleteEntryUrl;
+/**
+ * @summary Clear one model lane, so it falls back to the default binding
+ */
+const modelStrategyControllerDeleteEntry = async (id, lane, options) => {
+    return (0, custom_fetch_1.customFetch)((0, exports.getModelStrategyControllerDeleteEntryUrl)(id, lane), {
+        ...options,
+        method: 'DELETE'
+    });
+};
+exports.modelStrategyControllerDeleteEntry = modelStrategyControllerDeleteEntry;
 const getModelStrategyControllerBindStrategyUrl = (projectId) => {
     return `/projects/${projectId}/model-strategy`;
 };

package/dist/models/index.d.ts

@@ -350,6 +350,7 @@ export * from './upsertAgentModelOverrideDto';
 export * from './upsertAgentModelOverrideDtoScope';
 export * from './upsertEmbeddingCommitmentDto';
 export * from './upsertModelStrategyEntriesDto';
+export * from './upsertModelStrategyEntryDto';
 export * from './upsertToolProfileDto';
 export * from './widgetKindDto';
 export * from './widgetKindDtoPayloadSchema';

package/dist/models/index.js

@@ -367,6 +367,7 @@ __exportStar(require("./upsertAgentModelOverrideDto"), exports);
 __exportStar(require("./upsertAgentModelOverrideDtoScope"), exports);
 __exportStar(require("./upsertEmbeddingCommitmentDto"), exports);
 __exportStar(require("./upsertModelStrategyEntriesDto"), exports);
+__exportStar(require("./upsertModelStrategyEntryDto"), exports);
 __exportStar(require("./upsertToolProfileDto"), exports);
 __exportStar(require("./widgetKindDto"), exports);
 __exportStar(require("./widgetKindDtoPayloadSchema"), exports);

package/dist/models/modelCapability.d.ts

@@ -4,7 +4,7 @@
  * OpenAPI spec version: 0.1.3
  */
 /**
- * A modality this invocation REQUIRES — the Matrix `modelCapability` dimension, so one rule can route every vision-needing invocation to a multimodal model without pinning a provider. Closed kernel set; an unknown value is a 400.
+ * A modality this invocation REQUIRES — the Matrix `modelCapability` dimension, so one rule can route every vision-needing invocation to a multimodal model without pinning a provider. It is ALSO a requirement on whatever the resolution selects: a resolved model that does not provide it is refused with 422 `MODEL_CAPABILITY_UNSUPPORTED` rather than returned, and no other model is substituted. Closed kernel set; an unknown value is a 400.
  */
 export type ModelCapability = typeof ModelCapability[keyof typeof ModelCapability];
 export declare const ModelCapability: {

package/dist/models/modelStrategyResponseDto.d.ts

@@ -17,6 +17,8 @@ export interface ModelStrategyResponseDto {
     isSystem: boolean;
     isDefault: boolean;
     createdBy: string;
+    /** The entry set's concurrency counter. Send it back as `expectedVersion` when replacing the whole entry set. Moves on every write that changes the entries — including a per-lane write — and not on an unrelated metadata edit. */
+    version: number;
     createdAt: string;
     updatedAt: string;
     /**

package/dist/models/modelVocabularyKeyDto.d.ts

@@ -12,4 +12,6 @@ export interface ModelVocabularyKeyDto {
     title: string;
     /** What work this key names, in the reader's words. */
     description: string;
+    /** The biome(s) that declare this key, among the declarations visible to the caller — sorted, de-duplicated, and EVERY declarer rather than one: two biomes may declare the same key, and both are reported. Empty for a key no biome declared. PROVENANCE, NOT IDENTITY: the key alone is the stable identifier, and this list moves when a biome is renamed or replaced — group or explain by it, never key a binding on it. */
+    declaringBiomeIds: string[];
 }

package/dist/models/resolveModelForInvocationDto.d.ts

@@ -49,6 +49,6 @@ export interface ResolveModelForInvocationDto {
        * @maxLength 512
        */
     skillSlug?: string;
-    /** A modality this invocation REQUIRES — the Matrix `modelCapability` dimension, so one rule can route every vision-needing invocation to a multimodal model without pinning a provider. Closed kernel set; an unknown value is a 400. */
+    /** A modality this invocation REQUIRES — the Matrix `modelCapability` dimension, so one rule can route every vision-needing invocation to a multimodal model without pinning a provider. It is ALSO a requirement on whatever the resolution selects: a resolved model that does not provide it is refused with 422 `MODEL_CAPABILITY_UNSUPPORTED` rather than returned, and no other model is substituted. Closed kernel set; an unknown value is a 400. */
     modelCapability?: ModelCapability;
 }

package/dist/models/upsertModelStrategyEntriesDto.d.ts

@@ -7,4 +7,9 @@ import type { CreateModelStrategyEntryDto } from './createModelStrategyEntryDto.
 export interface UpsertModelStrategyEntriesDto {
     /** Role entries (replaces all entries) */
     entries: CreateModelStrategyEntryDto[];
+    /**
+       * The `version` read from this strategy. When sent, a stale value is refused with 409 `MODEL_STRATEGY_VERSION_MISMATCH`, which carries `currentVersion` to retry with. Send it: it is optional only for one transition and will become REQUIRED — without it this route replaces the whole entry set unconditionally, so a concurrent edit to a DIFFERENT lane is silently discarded. To change one lane, use PUT /model-strategies/:id/entries/:lane, which needs no version.
+       * @minimum 1
+       */
+    expectedVersion?: number;
 }

package/dist/models/upsertModelStrategyEntryDto.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Generated by @xemahq/api-client-generator — do not edit manually.
+ * LLM Registry API
+ * OpenAPI spec version: 0.1.3
+ */
+export interface UpsertModelStrategyEntryDto {
+    /** Model slug/ID to match against LlmModel.modelId */
+    modelSlug: string;
+    /**
+       * Temperature (0-2). Omitted = the engine/model owns it; no platform value is ever materialized.
+       * @minimum 0
+       * @maximum 2
+       */
+    temperature?: number;
+    /** Reasoning effort asked of the model — the kernel's `ModelOptions.reasoningEffort`, an open string the provider interprets (`low`/`medium`/`high`/…). Omitted = the engine/model owns it. */
+    reasoningEffort?: string;
+}

package/dist/models/upsertModelStrategyEntryDto.js

@@ -0,0 +1,7 @@
+"use strict";
+/**
+ * Generated by @xemahq/api-client-generator — do not edit manually.
+ * LLM Registry API
+ * OpenAPI spec version: 0.1.3
+ */
+Object.defineProperty(exports, "__esModule", { value: true });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xemahq/llm-registry-api-client",
-  "version": "0.8.12",
+  "version": "0.10.0",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
   "files": [
@@ -19,7 +19,7 @@
     "service": "llm-registry-api",
     "biome": "agent-runtime",
     "target": "server",
-    "generator": "@xemahq/api-client-generator@0.21.0",
+    "generator": "@xemahq/api-client-generator@1.1.2",
     "source": "openapi.public.json"
   },
   "license": "LicenseRef-Xema-BSL-1.1",