@xemahq/llm-registry-internal-api-client 0.7.11 → 0.7.21

package/dist/custom-fetch.d.ts

@@ -47,6 +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 resolver for the CORRELATION ID of the request being made — the
+     * handle that ties one causal chain together across every service hop.
+     *
+     * WHY IT IS A CALLBACK AND NOT A VALUE. `ClientConfig` is process-global
+     * (`configureClient` is called once at wiring time), and a correlation id is
+     * per-request. This is invoked INSIDE the request, so a server can point it
+     * at whatever carries its ambient request context and get the CURRENT id
+     * rather than the one that happened to be live at boot.
+     *
+     * WHY THE TRANSPORT DOES NOT MINT ONE. Returning `undefined` sends no header,
+     * and the receiving service's `RequestContextMiddleware` mints its own — a
+     * new trace, which is honest. A transport that minted per call would produce
+     * a FRESH id on every hop while looking like propagation, which is strictly
+     * worse than none: every row would carry a correlation id and no two rows
+     * that belong together would share one. That is the exact defect this exists
+     * to fix, so the transport must not reproduce it one layer down.
+     *
+     * A caller-supplied `X-Correlation-Id` header always wins, and so does one
+     * from `getHeaders`.
+     */
+    getCorrelationId?: () => string | undefined | Promise<string | undefined>;
     /**
      * 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

package/dist/custom-fetch.js

@@ -89,6 +89,16 @@ function getClientConfig() {
  */
 /** The only statuses that state the request was NOT processed. See above. */
 const RETRYABLE_STATUSES = [429, 503];
+/**
+ * The platform's correlation header, spelled once.
+ *
+ * Value-identical to what `RequestContextMiddleware` reads in
+ * `@xemahq/platform-common`. It is a literal here rather than an import
+ * because this file has ZERO imports on purpose: it ships byte-identical into
+ * browser-target clients as well as server-target ones, and a dependency on a
+ * NestJS-peer package would follow it into every one of them.
+ */
+const CORRELATION_ID_HEADER = 'X-Correlation-Id';
 /** 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. */
@@ -104,6 +114,23 @@ async function buildHeaders(config, callerHeaders) {
             }
         }
     }
+    // Correlation id (caller and global headers still take precedence).
+    //
+    // Without this, every server-to-server hop through a generated client started
+    // a NEW trace: the id is read-or-minted per hop by the receiving service's
+    // RequestContextMiddleware, and nothing carried it outbound — so an audit
+    // journal could record a whole causal chain and offer no way to join it back
+    // together.
+    //
+    // Absent resolver, or a resolver that answers `undefined`: NO header. The
+    // receiver mints and a new trace begins, which is the truthful outcome when
+    // there is nothing to continue.
+    if (config.getCorrelationId && !headers.has(CORRELATION_ID_HEADER)) {
+        const correlationId = await Promise.resolve(config.getCorrelationId());
+        if (correlationId) {
+            headers.set(CORRELATION_ID_HEADER, correlationId);
+        }
+    }
     // Auth token (caller or global headers take precedence)
     if (config.getAuthToken && !headers.has('Authorization')) {
         const token = await config.getAuthToken();

package/dist/endpoints/internal-exact-model-matrix-resolution/internal-exact-model-matrix-resolution.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Generated by @xemahq/api-client-generator — do not edit manually.
+ * LLM Registry API
+ * OpenAPI spec version: 0.1.3
+ */
+import type { ExactLogicalModelResolutionDtoDataEnvelope, ResolveExactLogicalModelDto } from '../../models';
+export declare const getExactModelResolutionControllerResolveExactUrl: () => string;
+export declare const exactModelResolutionControllerResolveExact: (resolveExactLogicalModelDto: ResolveExactLogicalModelDto, options?: RequestInit) => Promise<ExactLogicalModelResolutionDtoDataEnvelope>;

package/dist/endpoints/internal-exact-model-matrix-resolution/internal-exact-model-matrix-resolution.js

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.exactModelResolutionControllerResolveExact = exports.getExactModelResolutionControllerResolveExactUrl = void 0;
+const custom_fetch_1 = require("../../custom-fetch");
+const getExactModelResolutionControllerResolveExactUrl = () => {
+    return `/internal/model-matrix/resolve-exact`;
+};
+exports.getExactModelResolutionControllerResolveExactUrl = getExactModelResolutionControllerResolveExactUrl;
+const exactModelResolutionControllerResolveExact = async (resolveExactLogicalModelDto, options) => {
+    return (0, custom_fetch_1.customFetch)((0, exports.getExactModelResolutionControllerResolveExactUrl)(), {
+        ...options,
+        method: 'POST',
+        headers: { 'Content-Type': 'application/json', ...options?.headers },
+        body: JSON.stringify(resolveExactLogicalModelDto)
+    });
+};
+exports.exactModelResolutionControllerResolveExact = exactModelResolutionControllerResolveExact;

package/dist/index.d.ts

@@ -3,5 +3,6 @@ export * from './models';
 export * from './endpoints/contribution-sync/contribution-sync';
 export * from './endpoints/describe-objects/describe-objects';
 export * from './endpoints/internal-agent-invocation/internal-agent-invocation';
+export * from './endpoints/internal-exact-model-matrix-resolution/internal-exact-model-matrix-resolution';
 export * from './endpoints/internal-managed-model-resolution-rules/internal-managed-model-resolution-rules';
 export * from './endpoints/org-erasure/org-erasure';

package/dist/index.js

@@ -25,5 +25,6 @@ __exportStar(require("./models"), exports);
 __exportStar(require("./endpoints/contribution-sync/contribution-sync"), exports);
 __exportStar(require("./endpoints/describe-objects/describe-objects"), exports);
 __exportStar(require("./endpoints/internal-agent-invocation/internal-agent-invocation"), exports);
+__exportStar(require("./endpoints/internal-exact-model-matrix-resolution/internal-exact-model-matrix-resolution"), exports);
 __exportStar(require("./endpoints/internal-managed-model-resolution-rules/internal-managed-model-resolution-rules"), exports);
 __exportStar(require("./endpoints/org-erasure/org-erasure"), exports);

package/dist/models/agentInvokeRequestDto.d.ts

@@ -4,14 +4,18 @@
  * OpenAPI spec version: 0.1.3
  */
 import type { AgentInvokeRequestDtoInput } from './agentInvokeRequestDtoInput.js';
+import type { AgentInvokeRequestDtoLaunchDefinition } from './agentInvokeRequestDtoLaunchDefinition.js';
+import type { AgentInvokeRequestDtoWorkspace } from './agentInvokeRequestDtoWorkspace.js';
 import type { ExecutionRequirementsDto } from './executionRequirementsDto.js';
 export interface AgentInvokeRequestDto {
-    /** Agent ref (`slug` or `slug@generatedRevisionNumber`) to execute. */
-    agentRef: string;
+    /** Canonical LaunchDefinition RevisionTarget. Stable/channel selection is resolved centrally by agent-session. */
+    launchDefinition: AgentInvokeRequestDtoLaunchDefinition;
+    /** Canonical workspace action for the session launch. */
+    workspace: AgentInvokeRequestDtoWorkspace;
     /** Tenant scope: organization id. */
     orgId: string;
-    /** Tenant scope: project id (optional). */
-    projectId?: string;
+    /** Tenant scope: project id. */
+    projectId: string;
     /** Thread key (org+mailbox+emailThreadId for mail). Carries thread-continuity intent; STRICT isolation in Phase 1. */
     threadKey: string;
     /** Correlation id propagated through execution and audit. */

package/dist/models/agentInvokeRequestDtoLaunchDefinition.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Generated by @xemahq/api-client-generator — do not edit manually.
+ * LLM Registry API
+ * OpenAPI spec version: 0.1.3
+ */
+/**
+ * Canonical LaunchDefinition RevisionTarget. Stable/channel selection is resolved centrally by agent-session.
+ */
+export type AgentInvokeRequestDtoLaunchDefinition = {
+    [key: string]: unknown;
+};

package/dist/models/agentInvokeRequestDtoLaunchDefinition.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/dist/models/agentInvokeRequestDtoWorkspace.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Generated by @xemahq/api-client-generator — do not edit manually.
+ * LLM Registry API
+ * OpenAPI spec version: 0.1.3
+ */
+/**
+ * Canonical workspace action for the session launch.
+ */
+export type AgentInvokeRequestDtoWorkspace = {
+    [key: string]: unknown;
+};

package/dist/models/agentInvokeRequestDtoWorkspace.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/dist/models/exactContentPinDto.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Generated by @xemahq/api-client-generator — do not edit manually.
+ * LLM Registry API
+ * OpenAPI spec version: 0.1.3
+ */
+export interface ExactContentPinDto {
+    ref: string;
+    contentHash: string;
+}

package/dist/models/exactContentPinDto.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/dist/models/exactLogicalModelResolutionDto.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Generated by @xemahq/api-client-generator — do not edit manually.
+ * LLM Registry API
+ * OpenAPI spec version: 0.1.3
+ */
+import type { ExactContentPinDto } from './exactContentPinDto.js';
+import type { ExactLogicalModelResolutionDtoContextWindow } from './exactLogicalModelResolutionDtoContextWindow.js';
+import type { LogicalModelIntentDto } from './logicalModelIntentDto.js';
+export interface ExactLogicalModelResolutionDto {
+    intent: LogicalModelIntentDto;
+    matrixRevision: ExactContentPinDto;
+    /** Opaque secret-free pin for the exact centrally selected provider/model deployment. */
+    deployment: ExactContentPinDto;
+    /** Concrete model identity selected by the Matrix. Callers cannot submit this value. */
+    modelRef: string;
+    /** Secret-free exact provider routing slug covered by the deployment pin. */
+    providerSlug: string;
+    /** Exact OpenCode provider namespace covered by the deployment pin. */
+    opencodeProviderId: string;
+    /** @nullable */
+    contextWindow: ExactLogicalModelResolutionDtoContextWindow;
+    capabilities: string[];
+    /** Content-addressed evidence for the exact Matrix context, decision, and deployment. */
+    decisionEvidence: ExactContentPinDto;
+}

package/dist/models/exactLogicalModelResolutionDto.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/models/exactLogicalModelResolutionDtoContextWindow.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Generated by @xemahq/api-client-generator — do not edit manually.
+ * LLM Registry API
+ * OpenAPI spec version: 0.1.3
+ */
+/**
+ * @nullable
+ */
+export type ExactLogicalModelResolutionDtoContextWindow = {
+    [key: string]: unknown;
+} | null;

package/dist/models/exactLogicalModelResolutionDtoContextWindow.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/dist/models/exactLogicalModelResolutionDtoDataEnvelope.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Generated by @xemahq/api-client-generator — do not edit manually.
+ * LLM Registry API
+ * OpenAPI spec version: 0.1.3
+ */
+import type { ExactLogicalModelResolutionDto } from './exactLogicalModelResolutionDto.js';
+export interface ExactLogicalModelResolutionDtoDataEnvelope {
+    data: ExactLogicalModelResolutionDto;
+}

package/dist/models/exactLogicalModelResolutionDtoDataEnvelope.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/models/executionRequirementsDto.d.ts

@@ -8,7 +8,7 @@ import type { ExecutionRequirementsDtoPriority } from './executionRequirementsDt
 import type { InvocationLimitsDto } from './invocationLimitsDto.js';
 import type { IsolationLevel } from './isolationLevel.js';
 export interface ExecutionRequirementsDto {
-    /** Requested delivery mode. Omitted ⇒ `sync` (the documented wire default). A mode this runtime cannot execute is refused with a 400 — never silently changed. Only `sync` is executable today. */
+    /** Requested delivery mode. Omitted ⇒ `sync`. `sync` is the only currently supported public value. */
     mode?: ExecutionRequirementsDtoMode;
     /** Thread isolation level. `strict` = fresh, never-reused thread context per invocation. */
     isolation: IsolationLevel;

package/dist/models/executionRequirementsDtoMode.d.ts

@@ -4,11 +4,9 @@
  * OpenAPI spec version: 0.1.3
  */
 /**
- * Requested delivery mode. Omitted ⇒ `sync` (the documented wire default). A mode this runtime cannot execute is refused with a 400 — never silently changed. Only `sync` is executable today.
+ * Requested delivery mode. Omitted ⇒ `sync`. `sync` is the only currently supported public value.
  */
 export type ExecutionRequirementsDtoMode = typeof ExecutionRequirementsDtoMode[keyof typeof ExecutionRequirementsDtoMode];
 export declare const ExecutionRequirementsDtoMode: {
     readonly sync: "sync";
-    readonly async: "async";
-    readonly event: "event";
 };

package/dist/models/executionRequirementsDtoMode.js

@@ -8,6 +8,4 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.ExecutionRequirementsDtoMode = void 0;
 exports.ExecutionRequirementsDtoMode = {
     sync: 'sync',
-    async: 'async',
-    event: 'event',
 };

package/dist/models/index.d.ts

@@ -1,5 +1,7 @@
 export * from './agentInvokeRequestDto';
 export * from './agentInvokeRequestDtoInput';
+export * from './agentInvokeRequestDtoLaunchDefinition';
+export * from './agentInvokeRequestDtoWorkspace';
 export * from './agentInvokeResponseDto';
 export * from './agentInvokeResponseDtoDataEnvelope';
 export * from './agentInvokeResponseDtoMode';
@@ -12,6 +14,10 @@ export * from './errorDetailsDto';
 export * from './errorDetailsDtoDetails';
 export * from './errorPayloadDto';
 export * from './errorResponseDto';
+export * from './exactContentPinDto';
+export * from './exactLogicalModelResolutionDto';
+export * from './exactLogicalModelResolutionDtoContextWindow';
+export * from './exactLogicalModelResolutionDtoDataEnvelope';
 export * from './executionRequirementsDto';
 export * from './executionRequirementsDtoMode';
 export * from './executionRequirementsDtoPriority';
@@ -19,6 +25,8 @@ export * from './invocationDecisionDto';
 export * from './invocationDecisionDtoPayload';
 export * from './invocationLimitsDto';
 export * from './isolationLevel';
+export * from './logicalModelIntentDto';
+export * from './modelClass';
 export * from './modelResolutionRuleResponseDto';
 export * from './modelResolutionRuleResponseDtoDataEnvelope';
 export * from './modelResolutionRuleResponseDtoDefaultTargetOverridePrevModelClass';
@@ -35,6 +43,7 @@ export * from './modelResolutionSelectorResponseDtoModelCapability';
 export * from './modelResolutionSelectorResponseDtoModelClass';
 export * from './objectLifecycle';
 export * from './repointDefaultTargetDto';
+export * from './resolveExactLogicalModelDto';
 export * from './spaceKind';
 export * from './upsertManagedModelResolutionRuleDto';
 export * from './upsertManagedModelResolutionRuleDtoTargetKind';

package/dist/models/index.js

@@ -17,6 +17,8 @@ Object.defineProperty(exports, "__esModule", { value: true });
 // Auto-generated by tooling/codegen/regenerate-models-barrel.js — do not edit manually.
 __exportStar(require("./agentInvokeRequestDto"), exports);
 __exportStar(require("./agentInvokeRequestDtoInput"), exports);
+__exportStar(require("./agentInvokeRequestDtoLaunchDefinition"), exports);
+__exportStar(require("./agentInvokeRequestDtoWorkspace"), exports);
 __exportStar(require("./agentInvokeResponseDto"), exports);
 __exportStar(require("./agentInvokeResponseDtoDataEnvelope"), exports);
 __exportStar(require("./agentInvokeResponseDtoMode"), exports);
@@ -29,6 +31,10 @@ __exportStar(require("./errorDetailsDto"), exports);
 __exportStar(require("./errorDetailsDtoDetails"), exports);
 __exportStar(require("./errorPayloadDto"), exports);
 __exportStar(require("./errorResponseDto"), exports);
+__exportStar(require("./exactContentPinDto"), exports);
+__exportStar(require("./exactLogicalModelResolutionDto"), exports);
+__exportStar(require("./exactLogicalModelResolutionDtoContextWindow"), exports);
+__exportStar(require("./exactLogicalModelResolutionDtoDataEnvelope"), exports);
 __exportStar(require("./executionRequirementsDto"), exports);
 __exportStar(require("./executionRequirementsDtoMode"), exports);
 __exportStar(require("./executionRequirementsDtoPriority"), exports);
@@ -36,6 +42,8 @@ __exportStar(require("./invocationDecisionDto"), exports);
 __exportStar(require("./invocationDecisionDtoPayload"), exports);
 __exportStar(require("./invocationLimitsDto"), exports);
 __exportStar(require("./isolationLevel"), exports);
+__exportStar(require("./logicalModelIntentDto"), exports);
+__exportStar(require("./modelClass"), exports);
 __exportStar(require("./modelResolutionRuleResponseDto"), exports);
 __exportStar(require("./modelResolutionRuleResponseDtoDataEnvelope"), exports);
 __exportStar(require("./modelResolutionRuleResponseDtoDefaultTargetOverridePrevModelClass"), exports);
@@ -52,6 +60,7 @@ __exportStar(require("./modelResolutionSelectorResponseDtoModelCapability"), exp
 __exportStar(require("./modelResolutionSelectorResponseDtoModelClass"), exports);
 __exportStar(require("./objectLifecycle"), exports);
 __exportStar(require("./repointDefaultTargetDto"), exports);
+__exportStar(require("./resolveExactLogicalModelDto"), exports);
 __exportStar(require("./spaceKind"), exports);
 __exportStar(require("./upsertManagedModelResolutionRuleDto"), exports);
 __exportStar(require("./upsertManagedModelResolutionRuleDtoTargetKind"), exports);

package/dist/models/logicalModelIntentDto.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Generated by @xemahq/api-client-generator — do not edit manually.
+ * LLM Registry API
+ * OpenAPI spec version: 0.1.3
+ */
+import type { ModelClass } from './modelClass.js';
+export interface LogicalModelIntentDto {
+    modelClass: ModelClass;
+}

package/dist/models/logicalModelIntentDto.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/models/modelClass.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Generated by @xemahq/api-client-generator — do not edit manually.
+ * LLM Registry API
+ * OpenAPI spec version: 0.1.3
+ */
+export type ModelClass = typeof ModelClass[keyof typeof ModelClass];
+export declare const ModelClass: {
+    readonly coding: "coding";
+    readonly review: "review";
+    readonly creative: "creative";
+    readonly planning: "planning";
+    readonly utility: "utility";
+};

package/dist/models/modelClass.js

@@ -0,0 +1,15 @@
+"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 });
+exports.ModelClass = void 0;
+exports.ModelClass = {
+    coding: 'coding',
+    review: 'review',
+    creative: 'creative',
+    planning: 'planning',
+    utility: 'utility',
+};

package/dist/models/resolveExactLogicalModelDto.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Generated by @xemahq/api-client-generator — do not edit manually.
+ * LLM Registry API
+ * OpenAPI spec version: 0.1.3
+ */
+import type { LogicalModelIntentDto } from './logicalModelIntentDto.js';
+export interface ResolveExactLogicalModelDto {
+    /** Exact Agent revision resource identity used only as a Matrix dimension. */
+    agentRef: string;
+    /** Exact project Matrix dimension. Omitted for an org-owned Workspace. */
+    projectRef?: string;
+    intent: LogicalModelIntentDto;
+}

package/dist/models/resolveExactLogicalModelDto.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/models/xemaObjectKind.d.ts

@@ -27,10 +27,10 @@ export declare const XemaObjectKind: {
     readonly 'mount-source': "mount-source";
     readonly 'artifact-type': "artifact-type";
     readonly artifact: "artifact";
+    readonly 'output-route': "output-route";
+    readonly resource: "resource";
     readonly 'knowledge-space': "knowledge-space";
     readonly 'knowledge-page': "knowledge-page";
-    readonly 'document-template': "document-template";
-    readonly 'document-theme': "document-theme";
     readonly 'chart-runtime': "chart-runtime";
     readonly 'presentation-runtime': "presentation-runtime";
     readonly 'widget-kind': "widget-kind";

package/dist/models/xemaObjectKind.js

@@ -26,10 +26,10 @@ exports.XemaObjectKind = {
     'mount-source': 'mount-source',
     'artifact-type': 'artifact-type',
     artifact: 'artifact',
+    'output-route': 'output-route',
+    resource: 'resource',
     'knowledge-space': 'knowledge-space',
     'knowledge-page': 'knowledge-page',
-    'document-template': 'document-template',
-    'document-theme': 'document-theme',
     'chart-runtime': 'chart-runtime',
     'presentation-runtime': 'presentation-runtime',
     'widget-kind': 'widget-kind',

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xemahq/llm-registry-internal-api-client",
-  "version": "0.7.11",
+  "version": "0.7.21",
   "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.13.0",
+    "generator": "@xemahq/api-client-generator@0.14.1",
     "source": "openapi.internal.json"
   },
   "license": "LicenseRef-Xema-BSL-1.1",