@xemahq/llm-registry-api-client 0.7.0 → 0.7.2

package/dist/custom-fetch.d.ts

@@ -1,24 +1,36 @@
 /**
  * Configurable fetch wrapper for Orval-generated clients.
  *
+ * GENERATED by `@xemahq/api-client-generator` — do not edit. Every client in
+ * the fleet ships this file byte-for-byte; a local edit is erased by the next
+ * `pnpm refresh` and, until then, makes this one client speak to the platform
+ * differently from all of its siblings. Change the template instead:
+ * `api-client-generator/src/lib/custom-fetch-template.ts`.
+ *
  * Consumers must call `configureClient()` before using any endpoint function.
  * The baseUrl is prepended to the relative paths generated by Orval.
  *
- * Features:
- *   - Automatic bearer-token injection via `getAuthToken` callback
- *   - Per-request header injection via `getHeaders` callback
- *   - Automatic 401 handling via `onUnauthorized` callback (single retry)
- *   - Exponential-backoff retry for transient failures (429, 502, 503, 504)
- *   - Typed `ClientError` for non-2xx responses
- *   - Per-call header overrides (take precedence over global headers)
- *
- * @example
- *   configureClient({
- *     baseUrl: 'http://governance-api:3400',
- *     getAuthToken: () => identityBootstrapService.getAccessToken(),
- *     getHeaders: () => ({ 'X-Xema-Org-Id': orgId, 'X-Correlation-Id': crypto.randomUUID() }),
- *   });
+ * By default this transport issues exactly ONE request and adds no delay of its
+ * own, so a slow call is a slow server. Retrying is opt-in, and opting in
+ * requires supplying an observer — see `maxRetries` / `onRetry` below.
  */
+/** What {@link ClientConfig.onRetry} is told before each re-attempt. */
+export interface RetryNotice {
+    /** 1-based index of the re-attempt about to be made. */
+    attempt: number;
+    /** The configured budget this re-attempt is spending from. */
+    maxRetries: number;
+    /** The response status that made the previous attempt retryable. */
+    status: number;
+    /** Delay before the re-attempt, in ms — from `Retry-After` when the server sent one. */
+    waitMs: number;
+    /** Whether {@link waitMs} came from the server's `Retry-After` header. */
+    retryAfterHonoured: boolean;
+    /** Absolute URL being re-requested. */
+    url: string;
+    /** HTTP method being re-requested. */
+    method: string;
+}
 export interface ClientConfig {
     /**
      * Static base URL (e.g. 'http://localhost:3140') — no trailing slash.
@@ -35,10 +47,28 @@ export interface ClientConfig {
     getAuthToken?: () => Promise<string>;
     /** Optional callback returning headers to inject on every request. Per-call headers take precedence. */
     getHeaders?: () => Record<string, string> | Promise<Record<string, string>>;
-    /** Optional callback invoked on 401 before a single retry (e.g. force-refresh auth token). */
+    /**
+     * Optional callback invoked on a 401 before ONE re-attempt. Supplying it is
+     * what opts this client into that re-attempt; without it a 401 comes back to
+     * the caller as a `ClientError` like any other 4xx.
+     */
     onUnauthorized?: () => Promise<void>;
-    /** Maximum retry attempts for transient failures (default: 3). Set to 0 to disable retries. */
+    /**
+     * Re-attempts for a retryable status. **Defaults to 0 — no retry.**
+     *
+     * Setting it above 0 REQUIRES `onRetry`; `configureClient` throws otherwise.
+     * See the block above `customFetch` for why the budget is opt-in and why an
+     * observer is mandatory rather than advisory.
+     */
     maxRetries?: number;
+    /**
+     * Called immediately before every re-attempt, with the reason and the delay.
+     *
+     * Mandatory whenever `maxRetries` is above 0. It is the difference between a
+     * retry and a hidden degradation path: without it a caller cannot tell a slow
+     * server from this transport sleeping between attempts.
+     */
+    onRetry?: (notice: RetryNotice) => void;
 }
 export declare class ClientError extends Error {
     readonly status: number;

package/dist/custom-fetch.js

@@ -2,23 +2,18 @@
 /**
  * Configurable fetch wrapper for Orval-generated clients.
  *
+ * GENERATED by `@xemahq/api-client-generator` — do not edit. Every client in
+ * the fleet ships this file byte-for-byte; a local edit is erased by the next
+ * `pnpm refresh` and, until then, makes this one client speak to the platform
+ * differently from all of its siblings. Change the template instead:
+ * `api-client-generator/src/lib/custom-fetch-template.ts`.
+ *
  * Consumers must call `configureClient()` before using any endpoint function.
  * The baseUrl is prepended to the relative paths generated by Orval.
  *
- * Features:
- *   - Automatic bearer-token injection via `getAuthToken` callback
- *   - Per-request header injection via `getHeaders` callback
- *   - Automatic 401 handling via `onUnauthorized` callback (single retry)
- *   - Exponential-backoff retry for transient failures (429, 502, 503, 504)
- *   - Typed `ClientError` for non-2xx responses
- *   - Per-call header overrides (take precedence over global headers)
- *
- * @example
- *   configureClient({
- *     baseUrl: 'http://governance-api:3400',
- *     getAuthToken: () => identityBootstrapService.getAccessToken(),
- *     getHeaders: () => ({ 'X-Xema-Org-Id': orgId, 'X-Correlation-Id': crypto.randomUUID() }),
- *   });
+ * By default this transport issues exactly ONE request and adds no delay of its
+ * own, so a slow call is a slow server. Retrying is opt-in, and opting in
+ * requires supplying an observer — see `maxRetries` / `onRetry` below.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.customFetch = exports.ClientError = void 0;
@@ -39,6 +34,14 @@ class ClientError extends Error {
 exports.ClientError = ClientError;
 let clientConfig = null;
 function configureClient(config) {
+    // Fail at WIRING time, not on the request that happens to be retried. A
+    // client configured to retry without an observer is the exact defect this
+    // transport was rebuilt to remove, so it must not be constructible.
+    if ((config.maxRetries ?? 0) > 0 && !config.onRetry) {
+        throw new Error('configureClient: maxRetries above 0 requires onRetry. A retry nothing ' +
+            'reports is indistinguishable from a slow server, which is how two ' +
+            'silent re-attempts were read as a 3,312ms call.');
+    }
     clientConfig = config;
 }
 function getClientConfig() {
@@ -47,7 +50,49 @@ function getClientConfig() {
     }
     return clientConfig;
 }
-const RETRYABLE_STATUSES = [429, 502, 503, 504];
+/*
+ * RETRYING IS OPT-IN, OBSERVED, AND NARROW. Do not widen any of the three.
+ *
+ * This transport used to retry up to `maxRetries` (defaulting to THREE) over
+ * 429/502/503/504 AND over any thrown network error, backing off from 1000ms,
+ * with no log line anywhere. Three properties were wrong:
+ *
+ *   1. The DEFAULT was on. ~99% of the fleet's client configurations never
+ *      mention `maxRetries`, so two re-attempts could add ~3s to any call with
+ *      nothing to distinguish that from a slow peer. Every caller that DID set
+ *      it set it LOWER — canopy's control plane to 1, "so a hard outage
+ *      surfaces inside the turn's latency budget rather than after three
+ *      backoffs"; two llm-registry callers to 1; a test to 0. Nobody ever
+ *      raised it. A default three separate call sites work around is not a
+ *      default, and `configureOrvalClientResolved` cannot express the field at
+ *      all, so most callers could not have opted out if they had wanted to.
+ *   2. It retried AMBIGUOUS failures. 502 and 504 mean a gateway did not get a
+ *      timely answer from upstream — the upstream may well have APPLIED the
+ *      request. So did a thrown network error mid-flight. Re-sending a POST in
+ *      either case is a duplicate write, and no amount of logging makes that
+ *      safe. Only 429 and 503 state positively that the request was NOT
+ *      processed, so only those are retried; everything else surfaces at once.
+ *   3. Nothing reported it. Now `onRetry` is mandatory whenever the budget is
+ *      above 0, enforced in `configureClient`.
+ *
+ * Also note `baseUrlResolver` is awaited ONCE, above the loop: a re-attempt
+ * returns to the same resolved instance. In a registry-resolved fleet the cure
+ * for an unhealthy peer is re-resolution, which lives above this file — which
+ * is a further reason not to lean on retrying here.
+ *
+ * Retry policy a caller genuinely wants belongs in `@xemahq/managed-fetch`,
+ * which has backoff, a circuit breaker, a token bucket and health reporting,
+ * and reports what it did.
+ *
+ * Enforced fleet-wide by `check-client-transport-envelope`, which compares
+ * every client's transport to this template.
+ */
+/** The only statuses that state the request was NOT processed. See above. */
+const RETRYABLE_STATUSES = [429, 503];
+/** Backoff floor, doubling per attempt up to {@link MAX_BACKOFF_MS}. */
+const BASE_BACKOFF_MS = 1000;
+/** Ceiling on a single backoff, however many attempts have elapsed. */
+const MAX_BACKOFF_MS = 30_000;
 async function buildHeaders(config, callerHeaders) {
     const headers = new Headers(callerHeaders);
     // Global headers from config (caller-provided headers take precedence)
@@ -66,6 +111,29 @@ async function buildHeaders(config, callerHeaders) {
     }
     return headers;
 }
+/*
+ * THE TRANSPORT RETURNS THE BODY UNCHANGED. Do not reintroduce an unwrap here.
+ *
+ * Xema services wrap every 2xx payload in a { data: T } envelope via the global
+ * ResponseEnvelopeInterceptor (platform-common), and the generator emits types
+ * that describe THAT ENVELOPE — every endpoint returns Promise<XDataEnvelope>
+ * or Promise<XPaginatedEnvelope>, never a bare inner T. Consumers read the data
+ * property themselves.
+ *
+ * This template used to peel data, justified by a comment claiming generated
+ * types describe the inner T. That stopped being true when the generator moved
+ * to envelope-typed returns, and the comment outlived the fact — so the peel
+ * then contradicted every type in every package it seeded. Four clients shipped
+ * that way (resource-governance x3, workload-runtime-api): declared
+ * *DataEnvelope, returned the already-peeled inner object, so .data read
+ * undefined at runtime on every non-paginated endpoint. Paginated calls hid it,
+ * because the old peel deliberately preserved an envelope carrying pagination.
+ *
+ * Four MORE shipped it in repositories the gate could not see — license-api and
+ * license-internal-api in xema-operator, plus their host-web mirrors — because
+ * the gate ran in xema-base only. That is why it now runs in every repository
+ * that ships a client, and why this file is generator-owned rather than seeded.
+ */
 const customFetch = async (url, options) => {
     const config = getClientConfig();
     const base = config.baseUrlResolver
@@ -75,55 +143,57 @@ const customFetch = async (url, options) => {
         throw new Error('Client not configured: set baseUrl or baseUrlResolver via configureClient().');
     }
     const fullUrl = `${base}${url}`;
-    const maxRetries = config.maxRetries ?? 3;
+    const maxRetries = config.maxRetries ?? 0;
+    // A caller that supplied its own Authorization header owns that credential.
+    // `buildHeaders` lets it win, so refreshing the CLIENT-WIDE token and
+    // re-sending would replay the identical failing request with the identical
+    // credential: one wasted round trip, plus a global refresh nobody asked for.
+    const callerSuppliedAuth = new Headers(options.headers).has('Authorization');
     const headers = await buildHeaders(config, options.headers);
     const requestInit = { ...options, headers };
-    let delay = 1000;
-    let lastError;
-    for (let attempt = 0; attempt <= maxRetries; attempt++) {
-        try {
-            const response = await fetch(fullUrl, requestInit);
-            // 401 — invoke onUnauthorized and retry once (outside the transient retry loop)
-            if (response.status === 401 && config.onUnauthorized && attempt === 0) {
-                await config.onUnauthorized();
-                const refreshedHeaders = await buildHeaders(config, options.headers);
-                const retryResponse = await fetch(fullUrl, {
-                    ...options,
-                    headers: refreshedHeaders,
-                });
-                const retryBody = await parseBody(retryResponse);
-                if (retryResponse.status >= 400) {
-                    throw new ClientError(retryResponse.status, fullUrl, retryBody);
-                }
-                return retryBody;
-            }
-            // Non-retryable status — return or throw
-            if (!RETRYABLE_STATUSES.includes(response.status) ||
-                attempt >= maxRetries) {
-                const body = await parseBody(response);
-                if (response.status >= 400) {
-                    throw new ClientError(response.status, fullUrl, body);
-                }
-                return body;
+    let delay = BASE_BACKOFF_MS;
+    for (let attempt = 0;; attempt++) {
+        const response = await fetch(fullUrl, requestInit);
+        if (response.status === 401 &&
+            config.onUnauthorized &&
+            !callerSuppliedAuth &&
+            attempt === 0) {
+            await config.onUnauthorized();
+            const refreshedHeaders = await buildHeaders(config, options.headers);
+            const retryResponse = await fetch(fullUrl, {
+                ...options,
+                headers: refreshedHeaders,
+            });
+            const retryBody = await parseBody(retryResponse);
+            if (retryResponse.status >= 400) {
+                throw new ClientError(retryResponse.status, fullUrl, retryBody);
             }
-            // Retryable — wait and retry
-            const retryAfter = parseRetryAfter(response.headers.get('Retry-After'));
-            const waitMs = retryAfter ?? addJitter(delay);
-            await sleep(waitMs);
-            delay = Math.min(delay * 2, 30_000);
+            return retryBody;
         }
-        catch (error) {
-            if (error instanceof ClientError)
-                throw error; // Don't retry client errors
-            lastError = error instanceof Error ? error : new Error(String(error));
-            if (attempt >= maxRetries)
-                throw lastError;
-            const waitMs = addJitter(delay);
-            await sleep(waitMs);
-            delay = Math.min(delay * 2, 30_000);
+        if (!RETRYABLE_STATUSES.includes(response.status) ||
+            attempt >= maxRetries) {
+            const body = await parseBody(response);
+            if (response.status >= 400) {
+                throw new ClientError(response.status, fullUrl, body);
+            }
+            return body;
         }
+        const retryAfter = parseRetryAfter(response.headers.get('Retry-After'));
+        const waitMs = retryAfter ?? addJitter(delay);
+        // Non-null: `configureClient` refuses a budget above 0 without an observer,
+        // and this line is unreachable unless `maxRetries` is above 0.
+        config.onRetry({
+            attempt: attempt + 1,
+            maxRetries,
+            status: response.status,
+            waitMs,
+            retryAfterHonoured: retryAfter !== undefined,
+            url: fullUrl,
+            method: options.method ?? 'GET',
+        });
+        await sleep(waitMs);
+        delay = Math.min(delay * 2, MAX_BACKOFF_MS);
     }
-    throw lastError ?? new Error(`All retries exhausted for ${fullUrl}`);
 };
 exports.customFetch = customFetch;
 async function parseBody(response) {

package/dist/endpoints/agent-kernels/agent-kernels.d.ts

@@ -1,16 +1,14 @@
 /**
- * Generated by orval v8.16.0 🍺
- * Do not edit manually.
+ * Generated by @xemahq/api-client-generator — do not edit manually.
  * LLM Registry API
- * Central registry for LLM providers, models, and per-project model configuration
  * OpenAPI spec version: 0.1.3
  */
-import type { AgentBundleRenderDto, AgentConfigBlocksResponseDtoDataEnvelope, AgentKernelControllerBrowseTalentPoolParams, AgentKernelControllerListDefinitionsParams, AgentKernelControllerListInteractiveCatalogParams, AgentKernelControllerResolveAgentBlocksParams, AgentKernelResponseDtoDataEnvelope, AgentKernelResponseDtoPaginatedEnvelope, AgentProfileDtoDataEnvelope, AgentProfileDtoPaginatedEnvelope, BundleFileResponseDtoDataEnvelope, CreateAgentKernelDto, CreateProjectAgentOverrideDto, OrgInteractiveSubagentsResponseDtoDataEnvelope, ProjectAgentOverrideResponseDtoDataEnvelope, ProjectAgentOverrideResponseDtoPaginatedEnvelope, RescopeDto, ResolveFullResponseDtoDataEnvelope, ResolvedAgentKernelResponseDtoDataEnvelope, ResolvedConfigSnapshotResponseDtoDataEnvelope, UpdateAgentKernelDto, UpdateProjectAgentOverrideDto } from '../../models';
+import type { AgentBundleRenderDto, AgentConfigBlocksResponseDtoDataEnvelope, AgentKernelControllerBrowseTalentPoolParams, AgentKernelControllerListDefinitionsParams, AgentKernelControllerListInteractiveCatalogParams, AgentKernelControllerResolveAgentBlocksParams, AgentKernelResponseDtoDataArrayEnvelope, AgentKernelResponseDtoDataEnvelope, AgentKernelResponseDtoPaginatedEnvelope, AgentProfileDtoDataEnvelope, AgentProfileDtoPaginatedEnvelope, AgentTalentPoolStatsDtoDataEnvelope, BundleFileResponseDtoDataEnvelope, CreateAgentKernelDto, CreateProjectAgentOverrideDto, OrgInteractiveSubagentsResponseDtoDataEnvelope, ProjectAgentOverrideResponseDtoDataArrayEnvelope, ProjectAgentOverrideResponseDtoDataEnvelope, RescopeDto, ResolveFullResponseDtoDataEnvelope, ResolvedAgentKernelResponseDtoDataEnvelope, ResolvedConfigSnapshotResponseDtoDataEnvelope, UpdateAgentKernelDto, UpdateProjectAgentOverrideDto } from '../../models';
 export declare const getAgentKernelControllerListDefinitionsUrl: (params?: AgentKernelControllerListDefinitionsParams) => string;
 /**
  * @summary List agent definitions. Biome-attributed rows are filtered through `@xemahq/biome-governance-client` against the caller org's enablement view; agents shipped by disabled biomes are hidden.
  */
-export declare const agentKernelControllerListDefinitions: (params?: AgentKernelControllerListDefinitionsParams, options?: RequestInit) => Promise<AgentKernelResponseDtoPaginatedEnvelope>;
+export declare const agentKernelControllerListDefinitions: (params?: AgentKernelControllerListDefinitionsParams, options?: RequestInit) => Promise<AgentKernelResponseDtoDataArrayEnvelope>;
 export declare const getAgentKernelControllerCreateDefinitionUrl: () => string;
 /**
  * @summary Create an agent definition
@@ -30,7 +28,7 @@ export declare const getAgentKernelControllerGetTalentPoolStatsUrl: (slug: strin
 /**
  * @summary Get agent usage stats (v1 stub)
  */
-export declare const agentKernelControllerGetTalentPoolStats: (slug: string, options?: RequestInit) => Promise<unknown>;
+export declare const agentKernelControllerGetTalentPoolStats: (slug: string, options?: RequestInit) => Promise<AgentTalentPoolStatsDtoDataEnvelope>;
 export declare const getAgentKernelControllerListInteractiveCatalogUrl: (params?: AgentKernelControllerListInteractiveCatalogParams) => string;
 /**
  * @summary List agents available for interactive sessions — filtered by supportsAgentSessions=true
@@ -90,7 +88,7 @@ export declare const getAgentKernelControllerListOverridesUrl: (projectId: strin
 /**
  * @summary List project-level agent overrides
  */
-export declare const agentKernelControllerListOverrides: (projectId: string, options?: RequestInit) => Promise<ProjectAgentOverrideResponseDtoPaginatedEnvelope>;
+export declare const agentKernelControllerListOverrides: (projectId: string, options?: RequestInit) => Promise<ProjectAgentOverrideResponseDtoDataArrayEnvelope>;
 export declare const getAgentKernelControllerCreateOverrideUrl: (projectId: string) => string;
 /**
  * @summary Create a project-level agent override

package/dist/endpoints/agent-model-overrides/agent-model-overrides.d.ts

@@ -1,16 +1,14 @@
 /**
- * Generated by orval v8.16.0 🍺
- * Do not edit manually.
+ * Generated by @xemahq/api-client-generator — do not edit manually.
  * LLM Registry API
- * Central registry for LLM providers, models, and per-project model configuration
  * OpenAPI spec version: 0.1.3
  */
-import type { AgentModelOverrideControllerListParams, AgentModelOverrideControllerResolveBatchParams, AgentModelOverrideControllerResolveModelParams, AgentModelOverrideResponseDtoDataEnvelope, AgentModelOverrideResponseDtoPaginatedEnvelope, ResolvedAgentModelResponseDtoDataArrayEnvelope, ResolvedAgentModelResponseDtoDataEnvelope, UpsertAgentModelOverrideDto } from '../../models';
+import type { AgentModelOverrideControllerListParams, AgentModelOverrideControllerResolveBatch200, AgentModelOverrideControllerResolveBatchParams, AgentModelOverrideControllerResolveModelParams, AgentModelOverrideResponseDtoDataArrayEnvelope, AgentModelOverrideResponseDtoDataEnvelope, ResolvedAgentModelResponseDtoDataEnvelope, UpsertAgentModelOverrideDto } from '../../models';
 export declare const getAgentModelOverrideControllerListUrl: (params?: AgentModelOverrideControllerListParams) => string;
 /**
  * @summary List agent model overrides (filterable by scope, scopeId, agentSlug)
  */
-export declare const agentModelOverrideControllerList: (params?: AgentModelOverrideControllerListParams, options?: RequestInit) => Promise<AgentModelOverrideResponseDtoPaginatedEnvelope>;
+export declare const agentModelOverrideControllerList: (params?: AgentModelOverrideControllerListParams, options?: RequestInit) => Promise<AgentModelOverrideResponseDtoDataArrayEnvelope>;
 export declare const getAgentModelOverrideControllerUpsertUrl: () => string;
 /**
  * @summary Upsert an agent model override (idempotent)
@@ -30,4 +28,4 @@ export declare const getAgentModelOverrideControllerResolveBatchUrl: (params: Ag
 /**
  * @summary Batch resolve models for multiple agents
  */
-export declare const agentModelOverrideControllerResolveBatch: (params: AgentModelOverrideControllerResolveBatchParams, options?: RequestInit) => Promise<ResolvedAgentModelResponseDtoDataArrayEnvelope>;
+export declare const agentModelOverrideControllerResolveBatch: (params: AgentModelOverrideControllerResolveBatchParams, options?: RequestInit) => Promise<AgentModelOverrideControllerResolveBatch200>;

package/dist/endpoints/agent-run-context/agent-run-context.d.ts

@@ -1,8 +1,6 @@
 /**
- * Generated by orval v8.16.0 🍺
- * Do not edit manually.
+ * Generated by @xemahq/api-client-generator — do not edit manually.
  * LLM Registry API
- * Central registry for LLM providers, models, and per-project model configuration
  * OpenAPI spec version: 0.1.3
  */
 import type { RenderAgentRunContextRequestDto, RenderAgentRunContextResponseDtoDataEnvelope } from '../../models';

package/dist/endpoints/agent-runtime/agent-runtime.d.ts

@@ -1,8 +1,6 @@
 /**
- * Generated by orval v8.16.0 🍺
- * Do not edit manually.
+ * Generated by @xemahq/api-client-generator — do not edit manually.
  * LLM Registry API
- * Central registry for LLM providers, models, and per-project model configuration
  * OpenAPI spec version: 0.1.3
  */
 import type { AgentCapabilityAnalysisDtoDataEnvelope, AgentRuntimeControllerAnalyzeParams, AgentRuntimeControllerResolveDraftParams, AgentRuntimeControllerResolveParams, AgentRuntimeControllerResolveRevisionParams, ResolvedAgentResponseDtoDataEnvelope } from '../../models';

package/dist/endpoints/agents/agents.d.ts

@@ -1,11 +1,9 @@
 /**
- * Generated by orval v8.16.0 🍺
- * Do not edit manually.
+ * Generated by @xemahq/api-client-generator — do not edit manually.
  * LLM Registry API
- * Central registry for LLM providers, models, and per-project model configuration
  * OpenAPI spec version: 0.1.3
  */
-import type { AgentAuthoringResponseDtoDataEnvelope, AgentAuthoringResponseDtoPaginatedEnvelope, AgentRevisionHistoryEntryDtoPaginatedEnvelope, CreateAgentDto, PublishAgentRevisionDto, RestoreAgentRevisionDto, UpdateAgentDraftDto } from '../../models';
+import type { AgentAuthoringResponseDtoDataArrayEnvelope, AgentAuthoringResponseDtoDataEnvelope, AgentRevisionHistoryEntryDtoDataArrayEnvelope, CreateAgentDto, PublishAgentRevisionDto, RestoreAgentRevisionDto, UpdateAgentDraftDto } from '../../models';
 export declare const getAgentAuthoringControllerCreateUrl: () => string;
 /**
  * @summary Create a stable Agent identity with one mutable draft.
@@ -15,7 +13,7 @@ export declare const getAgentAuthoringControllerListUrl: () => string;
 /**
  * @summary List stable Agents owned by the organization.
  */
-export declare const agentAuthoringControllerList: (options?: RequestInit) => Promise<AgentAuthoringResponseDtoPaginatedEnvelope>;
+export declare const agentAuthoringControllerList: (options?: RequestInit) => Promise<AgentAuthoringResponseDtoDataArrayEnvelope>;
 export declare const getAgentAuthoringControllerGetUrl: (identityId: string) => string;
 /**
  * @summary Get a stable Agent identity and current draft/live pointers.
@@ -40,7 +38,7 @@ export declare const getAgentAuthoringControllerHistoryUrl: (identityId: string)
 /**
  * @summary List immutable Agent revision history.
  */
-export declare const agentAuthoringControllerHistory: (identityId: string, options?: RequestInit) => Promise<AgentRevisionHistoryEntryDtoPaginatedEnvelope>;
+export declare const agentAuthoringControllerHistory: (identityId: string, options?: RequestInit) => Promise<AgentRevisionHistoryEntryDtoDataArrayEnvelope>;
 export declare const getAgentAuthoringControllerRestoreUrl: (identityId: string, revisionId: string) => string;
 /**
  * @summary Copy an immutable historical revision into the mutable draft.

package/dist/endpoints/catalog/catalog.d.ts

@@ -1,11 +1,9 @@
 /**
- * Generated by orval v8.16.0 🍺
- * Do not edit manually.
+ * Generated by @xemahq/api-client-generator — do not edit manually.
  * LLM Registry API
- * Central registry for LLM providers, models, and per-project model configuration
  * OpenAPI spec version: 0.1.3
  */
-import type { CatalogControllerGetModelStatusParams, CatalogControllerListModelsParams, CatalogControllerValidateModelsParams, CatalogModelDtoPaginatedEnvelope, CatalogProviderDtoDataArrayEnvelope, ModelStatusDtoDataEnvelope } from '../../models';
+import type { CatalogControllerGetModelStatusParams, CatalogControllerListModelsParams, CatalogControllerValidateModels200, CatalogControllerValidateModelsParams, CatalogModelDtoDataArrayEnvelope, CatalogProviderDtoDataArrayEnvelope, ModelStatusDtoDataEnvelope } from '../../models';
 export declare const getCatalogControllerListProvidersUrl: () => string;
 /**
  * @summary List known LLM providers from the curated catalog
@@ -15,7 +13,7 @@ export declare const getCatalogControllerListModelsUrl: (slug: string, params: C
 /**
  * @summary List models for a provider (from models.dev, with deprecation flags)
  */
-export declare const catalogControllerListModels: (slug: string, params: CatalogControllerListModelsParams, options?: RequestInit) => Promise<CatalogModelDtoPaginatedEnvelope>;
+export declare const catalogControllerListModels: (slug: string, params: CatalogControllerListModelsParams, options?: RequestInit) => Promise<CatalogModelDtoDataArrayEnvelope>;
 export declare const getCatalogControllerGetModelStatusUrl: (modelId: string, params: CatalogControllerGetModelStatusParams) => string;
 /**
  * @summary Check if a model is current or deprecated
@@ -25,4 +23,4 @@ export declare const getCatalogControllerValidateModelsUrl: (params: CatalogCont
 /**
  * @summary Batch-validate model IDs for deprecation status
  */
-export declare const catalogControllerValidateModels: (params: CatalogControllerValidateModelsParams, options?: RequestInit) => Promise<ModelStatusDtoDataEnvelope>;
+export declare const catalogControllerValidateModels: (params: CatalogControllerValidateModelsParams, options?: RequestInit) => Promise<CatalogControllerValidateModels200>;

package/dist/endpoints/chat-widget-catalogue/chat-widget-catalogue.d.ts

@@ -1,8 +1,6 @@
 /**
- * Generated by orval v8.16.0 🍺
- * Do not edit manually.
+ * Generated by @xemahq/api-client-generator — do not edit manually.
  * LLM Registry API
- * Central registry for LLM providers, models, and per-project model configuration
  * OpenAPI spec version: 0.1.3
  */
 import type { WidgetKindListDtoDataEnvelope } from '../../models';

package/dist/endpoints/code-standards/code-standards.d.ts

@@ -1,11 +1,9 @@
 /**
- * Generated by orval v8.16.0 🍺
- * Do not edit manually.
+ * Generated by @xemahq/api-client-generator — do not edit manually.
  * LLM Registry API
- * Central registry for LLM providers, models, and per-project model configuration
  * OpenAPI spec version: 0.1.3
  */
-import type { CodeStandardControllerListParams, CodeStandardResponseDtoDataEnvelope, CodeStandardResponseDtoPaginatedEnvelope, CreateCodeStandardDto, UpdateCodeStandardDto } from '../../models';
+import type { CodeStandardControllerListParams, CodeStandardResponseDtoDataArrayEnvelope, CodeStandardResponseDtoDataEnvelope, CreateCodeStandardDto, UpdateCodeStandardDto } from '../../models';
 export declare const getCodeStandardControllerCreateUrl: () => string;
 /**
  * @summary Create a code standard
@@ -15,7 +13,7 @@ export declare const getCodeStandardControllerListUrl: (params: CodeStandardCont
 /**
  * @summary List code standards
  */
-export declare const codeStandardControllerList: (params: CodeStandardControllerListParams, options?: RequestInit) => Promise<CodeStandardResponseDtoPaginatedEnvelope>;
+export declare const codeStandardControllerList: (params: CodeStandardControllerListParams, options?: RequestInit) => Promise<CodeStandardResponseDtoDataArrayEnvelope>;
 export declare const getCodeStandardControllerGetUrl: (id: string) => string;
 /**
  * @summary Get a code standard
@@ -35,4 +33,4 @@ export declare const getCodeStandardControllerResolveForProjectUrl: (projectId:
 /**
  * @summary Get resolved code standards for a project (org-wide + project-specific merged)
  */
-export declare const codeStandardControllerResolveForProject: (projectId: string, options?: RequestInit) => Promise<CodeStandardResponseDtoDataEnvelope>;
+export declare const codeStandardControllerResolveForProject: (projectId: string, options?: RequestInit) => Promise<CodeStandardResponseDtoDataArrayEnvelope>;

package/dist/endpoints/embedding-commitment/embedding-commitment.d.ts

@@ -1,11 +1,9 @@
 /**
- * Generated by orval v8.16.0 🍺
- * Do not edit manually.
+ * Generated by @xemahq/api-client-generator — do not edit manually.
  * LLM Registry API
- * Central registry for LLM providers, models, and per-project model configuration
  * OpenAPI spec version: 0.1.3
  */
-import type { EmbeddingCommitmentDtoDataEnvelope, EmbeddingMigrationDtoDataEnvelope, EmbeddingModelOptionDtoDataArrayEnvelope, MigrationConsumerDoneDto, MigrationConsumerFailedDto, MigrationHeartbeatDto, MigrationProvisionDto, ResolvedEmbeddingCommitmentDtoDataEnvelope, StartEmbeddingMigrationDto, UpsertEmbeddingCommitmentDto } from '../../models';
+import type { EmbeddingCommitmentActivationDtoDataEnvelope, EmbeddingCommitmentDtoDataEnvelope, EmbeddingMigrationDtoDataEnvelope, EmbeddingMigrationRollbackDtoDataEnvelope, EmbeddingModelOptionDtoDataArrayEnvelope, MigrationAcknowledgementDtoDataEnvelope, MigrationConsumerDoneDto, MigrationConsumerFailedDto, MigrationHeartbeatDto, MigrationProvisionDto, ResolvedEmbeddingCommitmentDtoDataEnvelope, StartEmbeddingMigrationDto, UpsertEmbeddingCommitmentDto } from '../../models';
 export declare const getEmbeddingCommitmentControllerGetCommitmentUrl: () => string;
 /**
  * @summary Get the org's embedding commitment
@@ -25,7 +23,7 @@ export declare const getEmbeddingCommitmentControllerActivateUrl: () => string;
 /**
  * @summary Idempotent activation: flips proposed → active on first index event. Called by consumers (search-api, memory-api) and is safe to invoke concurrently from multiple pods.
  */
-export declare const embeddingCommitmentControllerActivate: (options?: RequestInit) => Promise<unknown>;
+export declare const embeddingCommitmentControllerActivate: (options?: RequestInit) => Promise<EmbeddingCommitmentActivationDtoDataEnvelope>;
 export declare const getEmbeddingCommitmentControllerStartMigrationUrl: () => string;
 /**
  * @summary Start a dimension-changing migration. Requires explicit user confirmation: typedOrgSlug must match the org id and acknowledgeReprocessing must be true.
@@ -35,27 +33,27 @@ export declare const getEmbeddingCommitmentControllerRollbackUrl: (migrationId:
 /**
  * @summary Roll back an in-flight migration
  */
-export declare const embeddingCommitmentControllerRollback: (migrationId: string, options?: RequestInit) => Promise<unknown>;
+export declare const embeddingCommitmentControllerRollback: (migrationId: string, options?: RequestInit) => Promise<EmbeddingMigrationRollbackDtoDataEnvelope>;
 export declare const getEmbeddingCommitmentControllerProvisionUrl: (migrationId: string) => string;
 /**
  * @summary Consumer worker reports that it has provisioned target storage and is ready to dual-write. Records the high-water-mark cursor.
  */
-export declare const embeddingCommitmentControllerProvision: (migrationId: string, migrationProvisionDto: MigrationProvisionDto, options?: RequestInit) => Promise<unknown>;
+export declare const embeddingCommitmentControllerProvision: (migrationId: string, migrationProvisionDto: MigrationProvisionDto, options?: RequestInit) => Promise<MigrationAcknowledgementDtoDataEnvelope>;
 export declare const getEmbeddingCommitmentControllerHeartbeatUrl: (migrationId: string) => string;
 /**
  * @summary Consumer worker advances the durable cursor after processing a batch. Used by the reconciliation cron to detect stalled walkers.
  */
-export declare const embeddingCommitmentControllerHeartbeat: (migrationId: string, migrationHeartbeatDto: MigrationHeartbeatDto, options?: RequestInit) => Promise<unknown>;
+export declare const embeddingCommitmentControllerHeartbeat: (migrationId: string, migrationHeartbeatDto: MigrationHeartbeatDto, options?: RequestInit) => Promise<MigrationAcknowledgementDtoDataEnvelope>;
 export declare const getEmbeddingCommitmentControllerConsumerDoneUrl: (migrationId: string) => string;
 /**
  * @summary Consumer reports that its backfill has reached the source cursor. Triggers the completion watcher; commitment flips when ALL consumers report done.
  */
-export declare const embeddingCommitmentControllerConsumerDone: (migrationId: string, migrationConsumerDoneDto: MigrationConsumerDoneDto, options?: RequestInit) => Promise<unknown>;
+export declare const embeddingCommitmentControllerConsumerDone: (migrationId: string, migrationConsumerDoneDto: MigrationConsumerDoneDto, options?: RequestInit) => Promise<MigrationAcknowledgementDtoDataEnvelope>;
 export declare const getEmbeddingCommitmentControllerConsumerFailedUrl: (migrationId: string) => string;
 /**
  * @summary Consumer worker reports a terminal failure. Fails the whole migration and returns the commitment to active on the OLD model.
  */
-export declare const embeddingCommitmentControllerConsumerFailed: (migrationId: string, migrationConsumerFailedDto: MigrationConsumerFailedDto, options?: RequestInit) => Promise<unknown>;
+export declare const embeddingCommitmentControllerConsumerFailed: (migrationId: string, migrationConsumerFailedDto: MigrationConsumerFailedDto, options?: RequestInit) => Promise<MigrationAcknowledgementDtoDataEnvelope>;
 export declare const getEmbeddingCommitmentControllerResolveOrgUrl: () => string;
 /**
  * @summary Resolve the org's embedding model for runtime use

package/dist/endpoints/instruction-sections/instruction-sections.d.ts

@@ -1,16 +1,14 @@
 /**
- * Generated by orval v8.16.0 🍺
- * Do not edit manually.
+ * Generated by @xemahq/api-client-generator — do not edit manually.
  * LLM Registry API
- * Central registry for LLM providers, models, and per-project model configuration
  * OpenAPI spec version: 0.1.3
  */
-import type { InstructionSectionResponseDtoDataEnvelope, InstructionSectionResponseDtoPaginatedEnvelope, UpsertInstructionSectionDto } from '../../models';
+import type { InstructionSectionResponseDtoDataArrayEnvelope, InstructionSectionResponseDtoDataEnvelope, UpsertInstructionSectionDto } from '../../models';
 export declare const getInstructionSectionControllerListSectionsUrl: () => string;
 /**
  * @summary List instruction sections at the caller scope (project override > org > system), deterministic order
  */
-export declare const instructionSectionControllerListSections: (options?: RequestInit) => Promise<InstructionSectionResponseDtoPaginatedEnvelope>;
+export declare const instructionSectionControllerListSections: (options?: RequestInit) => Promise<InstructionSectionResponseDtoDataArrayEnvelope>;
 export declare const getInstructionSectionControllerUpsertSectionUrl: (sectionKey: string) => string;
 /**
  * @summary Upsert an instruction section at the caller scope — a project context writes that project’s override, never the org default

package/dist/endpoints/llm-readiness/llm-readiness.d.ts

@@ -1,8 +1,6 @@
 /**
- * Generated by orval v8.16.0 🍺
- * Do not edit manually.
+ * Generated by @xemahq/api-client-generator — do not edit manually.
  * LLM Registry API
- * Central registry for LLM providers, models, and per-project model configuration
  * OpenAPI spec version: 0.1.3
  */
 import type { LlmReadinessResponseDtoDataEnvelope } from '../../models';