@xemahq/llm-registry-api-client 0.4.1 → 0.4.2

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

@@ -11,11 +11,11 @@ export declare const getAgentControllerCreateUrl: () => string;
  * @summary Create an Agent. Created in draft lifecycle; publish separately.
  */
 export declare const agentControllerCreate: (createAgentDto: CreateAgentDto, options?: RequestInit) => Promise<AgentResponseDtoDataEnvelope>;
-export declare const getAgentControllerListUrl: (params: AgentControllerListParams) => string;
+export declare const getAgentControllerListUrl: (params?: AgentControllerListParams) => string;
 /**
  * @summary List Agent Agents for the org.
  */
-export declare const agentControllerList: (params: AgentControllerListParams, options?: RequestInit) => Promise<AgentResponseDtoPaginatedEnvelope>;
+export declare const agentControllerList: (params?: AgentControllerListParams, options?: RequestInit) => Promise<AgentResponseDtoPaginatedEnvelope>;
 export declare const getAgentControllerGetUrl: (id: string) => string;
 /**
  * @summary Get a single Agent by id.
@@ -54,18 +54,18 @@ export declare const getAgentControllerRescopeUrl: (id: string) => string;
  * @summary Re-scope an Agent — promote its owner UP the scope ladder (the "add to project" / "publish to org" action). Legal promotions: user → project|org, project → org. Touches only the owner columns; the slug, version and node tree are unchanged, so it is allowed in any lifecycle state. Illegal promotions / non-owner attempts fail fast with 400/403.
  */
 export declare const agentControllerRescope: (id: string, rescopeDto: RescopeDto, options?: RequestInit) => Promise<AgentResponseDtoDataEnvelope>;
-export declare const getAgentControllerResolveUrl: (ref: string, params: AgentControllerResolveParams) => string;
+export declare const getAgentControllerResolveUrl: (ref: string, params?: AgentControllerResolveParams) => string;
 /**
  * @summary Resolve a composition by `slug@version` (or bare `slug` = latest published) into the runtime-facing tree (agent versions pinned, capability envelope present). agent-session-api and the workflow runtime call this at session/dispatch time.
  */
-export declare const agentControllerResolve: (ref: string, params: AgentControllerResolveParams, options?: RequestInit) => Promise<ResolvedAgentResponseDtoDataEnvelope>;
-export declare const getAgentControllerResolveDraftCapableUrl: (id: string, params: AgentControllerResolveDraftCapableParams) => string;
+export declare const agentControllerResolve: (ref: string, params?: AgentControllerResolveParams, options?: RequestInit) => Promise<ResolvedAgentResponseDtoDataEnvelope>;
+export declare const getAgentControllerResolveDraftCapableUrl: (id: string, params?: AgentControllerResolveDraftCapableParams) => string;
 /**
  * @summary Resolve a composition by row id into the runtime-facing tree, allowing a DRAFT composition. Used only by the Agent Studio sandbox harness so an author can test an in-progress composition before publishing. An archived composition is still refused.
  */
-export declare const agentControllerResolveDraftCapable: (id: string, params: AgentControllerResolveDraftCapableParams, options?: RequestInit) => Promise<ResolvedAgentResponseDtoDataEnvelope>;
-export declare const getAgentControllerCapabilityAnalysisUrl: (id: string, params: AgentControllerCapabilityAnalysisParams) => string;
+export declare const agentControllerResolveDraftCapable: (id: string, params?: AgentControllerResolveDraftCapableParams, options?: RequestInit) => Promise<ResolvedAgentResponseDtoDataEnvelope>;
+export declare const getAgentControllerCapabilityAnalysisUrl: (id: string, params?: AgentControllerCapabilityAnalysisParams) => string;
 /**
  * @summary Chunk 3 — the read-only auto-grant-from-arming manifest: the union of CapabilityRefs the agent needs to drive its armed tools + skills across the whole sub-agent tree, plus the unresolved-ref diagnostics. Powers the Agent Studio "review & approve" surface. Draft-capable; computes nothing to disk.
  */
-export declare const agentControllerCapabilityAnalysis: (id: string, params: AgentControllerCapabilityAnalysisParams, options?: RequestInit) => Promise<AgentCapabilityAnalysisDtoDataEnvelope>;
+export declare const agentControllerCapabilityAnalysis: (id: string, params?: AgentControllerCapabilityAnalysisParams, options?: RequestInit) => Promise<AgentCapabilityAnalysisDtoDataEnvelope>;

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

@@ -5,9 +5,9 @@
  * Central registry for LLM providers, models, and per-project model configuration
  * OpenAPI spec version: 0.1.0
  */
-import type { WidgetKindListDto } from '../../models';
+import type { WidgetKindListDtoDataEnvelope } from '../../models';
 export declare const getWidgetCatalogueControllerListUrl: () => string;
 /**
  * @summary List every ChatWidget kind (first-party + biome-contributed) with its payload JSON Schema, so the frontend can render and register them.
  */
-export declare const widgetCatalogueControllerList: (options?: RequestInit) => Promise<WidgetKindListDto>;
+export declare const widgetCatalogueControllerList: (options?: RequestInit) => Promise<WidgetKindListDtoDataEnvelope>;

package/dist/models/agentControllerCapabilityAnalysisParams.d.ts

@@ -6,5 +6,8 @@
  * OpenAPI spec version: 0.1.0
  */
 export type AgentControllerCapabilityAnalysisParams = {
-    projectId: string;
+    /**
+     * Optional project scope for the resolution ladder. Omit for an org-layer (project-less) caller — resolution then runs the org/biome/system tiers only.
+     */
+    projectId?: string;
 };

package/dist/models/agentControllerListParams.d.ts

@@ -6,7 +6,16 @@
  * OpenAPI spec version: 0.1.0
  */
 export type AgentControllerListParams = {
-    projectId: string;
-    scope: string;
-    lifecycle: string;
+    /**
+     * Optional project scope for the resolution ladder. Omit for an org-layer (project-less) caller — resolution then runs the org/biome/system tiers only.
+     */
+    projectId?: string;
+    /**
+     * Optional `ScopeSource` filter.
+     */
+    scope?: string;
+    /**
+     * Optional `CompositionLifecycle` filter.
+     */
+    lifecycle?: string;
 };

package/dist/models/agentControllerResolveDraftCapableParams.d.ts

@@ -6,5 +6,8 @@
  * OpenAPI spec version: 0.1.0
  */
 export type AgentControllerResolveDraftCapableParams = {
-    projectId: string;
+    /**
+     * Optional project scope for the resolution ladder. Omit for an org-layer (project-less) caller — resolution then runs the org/biome/system tiers only.
+     */
+    projectId?: string;
 };

package/dist/models/agentControllerResolveParams.d.ts

@@ -6,5 +6,8 @@
  * OpenAPI spec version: 0.1.0
  */
 export type AgentControllerResolveParams = {
-    projectId: string;
+    /**
+     * Optional project scope for the resolution ladder. Omit for an org-layer (project-less) caller — resolution then runs the org/biome/system tiers only.
+     */
+    projectId?: string;
 };

package/dist/models/agentResponseDto.d.ts

@@ -11,7 +11,9 @@ import type { AgentReachTier } from './agentReachTier.js';
 import type { AgentResponseDtoLifecycle } from './agentResponseDtoLifecycle.js';
 import type { AgentSessionLifecycle } from './agentSessionLifecycle.js';
 import type { AgentWorkspaceDto } from './agentWorkspaceDto.js';
+import type { DurableWorkspaceRefDto } from './durableWorkspaceRefDto.js';
 import type { ScopeSource } from './scopeSource.js';
+import type { StandingSessionRefDto } from './standingSessionRefDto.js';
 import type { WorkspaceSharingPolicy } from './workspaceSharingPolicy.js';
 export interface AgentResponseDto {
     id: string;
@@ -43,6 +45,10 @@ export interface AgentResponseDto {
     sessionLifecycle?: AgentSessionLifecycle | null;
     /** The agent's workspace-sharing policy — whether a session launch may POOL onto a compatible running pod (`shareable`) or must always run isolated (`isolated`). Always a concrete value — a row with no stored value reads `isolated` (WORKSPACE_SHARING_DEFAULT). */
     workspaceSharing: WorkspaceSharingPolicy;
+    /** The agent's standing-session pin, or absent when it declares none. When present, every launch reuses ONE session keyed by `pinKey` (agent-session-api adopts-or-creates by `(orgId, projectId, pinKey)`). */
+    standingSession?: StandingSessionRefDto | null;
+    /** The agent's durable shared-workspace binding, or absent when it declares none. When present, every session it launches attaches to ONE durable, NAMED workspace shared across sessions/pods keyed by `workspaceRef`. */
+    durableWorkspace?: DurableWorkspaceRefDto | null;
     /** Special-ability CapabilityRefs granted on top of the reach tier; unioned into the auto-grant manifest. Always present (defaults to []). */
     abilities: string[];
     /** @nullable */

package/dist/models/createAgentDto.d.ts

@@ -10,7 +10,9 @@ import type { AgentNodeDto } from './agentNodeDto.js';
 import type { AgentReachTier } from './agentReachTier.js';
 import type { AgentSessionLifecycle } from './agentSessionLifecycle.js';
 import type { AgentWorkspaceDto } from './agentWorkspaceDto.js';
+import type { DurableWorkspaceRefDto } from './durableWorkspaceRefDto.js';
 import type { ScopeSource } from './scopeSource.js';
+import type { StandingSessionRefDto } from './standingSessionRefDto.js';
 import type { WorkspaceSharingPolicy } from './workspaceSharingPolicy.js';
 export interface CreateAgentDto {
     /** Stable slug; lowercase, hyphenated. */
@@ -33,6 +35,10 @@ export interface CreateAgentDto {
     sessionLifecycle?: AgentSessionLifecycle;
     /** Whether a session launch of this agent may POOL onto a compatible, already-running pod as a new thread (`shareable`) or must always run in its own isolated worker (`isolated`). Omitted ⇒ the DB default `isolated` (the fail-safe) — mark `shareable` ONLY for workspace-stateless / chat-style agents that never mutate `/workspace`. */
     workspaceSharing?: WorkspaceSharingPolicy;
+    /** Declares that every launch of this agent runs in ONE reusable "standing" session keyed by `pinKey` — agent-session-api adopts a non-terminal existing session for `(orgId, projectId, pinKey)` instead of minting a fresh one. Omitted / `null` ⇒ a fresh session per launch (the default). */
+    standingSession?: StandingSessionRefDto | null;
+    /** Declares that every session this agent launches attaches to ONE durable, NAMED workspace shared across independent sessions/pods (multi-pod `WorkspaceSharingPolicy.Shared`) keyed by `workspaceRef` — its files are the source of truth and cross-session mutating turns serialize through a write-lease. Omitted / `null` ⇒ a private per-session workspace (the default). */
+    durableWorkspace?: DurableWorkspaceRefDto | null;
     /** Special-ability CapabilityRefs granted on top of the reach tier; unioned into the auto-grant manifest. */
     abilities?: string[];
 }

package/dist/models/durableWorkspaceRefDto.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Generated by orval v8.16.0 🍺
+ * Do not edit manually.
+ * LLM Registry API
+ * Central registry for LLM providers, models, and per-project model configuration
+ * OpenAPI spec version: 0.1.0
+ */
+export interface DurableWorkspaceRefDto {
+    /** Stable identity of the durable shared workspace. Every session of every agent that resolves this ref within the same `(orgId, projectId)` mounts the SAME durable `/workspace` (its files are the source of truth; a session is a disposable cache). */
+    workspaceRef: string;
+}

package/dist/models/durableWorkspaceRefDto.js

@@ -0,0 +1,9 @@
+"use strict";
+/**
+ * Generated by orval v8.16.0 🍺
+ * Do not edit manually.
+ * LLM Registry API
+ * Central registry for LLM providers, models, and per-project model configuration
+ * OpenAPI spec version: 0.1.0
+ */
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/models/index.d.ts

@@ -119,6 +119,7 @@ export * from './createProviderDto';
 export * from './createProviderDtoApiType';
 export * from './createProviderDtoAuthType';
 export * from './credentialKind';
+export * from './durableWorkspaceRefDto';
 export * from './embeddingCommitmentDto';
 export * from './embeddingCommitmentDtoDataEnvelope';
 export * from './embeddingCommitmentDtoState';
@@ -144,6 +145,7 @@ export * from './llmReadinessResponseDtoDataEnvelope';
 export * from './llmReadinessResponseDtoStatus';
 export * from './llmRegistryControllerResolveForInvocationModelClass';
 export * from './llmRegistryControllerResolveForInvocationParams';
+export * from './llmRegistryControllerResolveForInvocationPreferredModelClass';
 export * from './llmRegistryControllerResolveForInvocationPurpose';
 export * from './migrationConsumerDoneDto';
 export * from './migrationConsumerDoneDtoConsumer';
@@ -162,14 +164,18 @@ export * from './modelMode';
 export * from './modelPricingTierDto';
 export * from './modelResolutionRuleResponseDto';
 export * from './modelResolutionRuleResponseDtoDataEnvelope';
+export * from './modelResolutionRuleResponseDtoDefaultTargetOverridePrevModelClass';
+export * from './modelResolutionRuleResponseDtoDefaultTargetOverridePrevTargetKind';
 export * from './modelResolutionRuleResponseDtoPaginatedEnvelope';
 export * from './modelResolutionRuleResponseDtoTargetKind';
 export * from './modelResolutionRuleResponseDtoTargetModelClass';
 export * from './modelResolutionSelectorDto';
 export * from './modelResolutionSelectorDtoExtra';
+export * from './modelResolutionSelectorDtoModelCapability';
 export * from './modelResolutionSelectorDtoModelClass';
 export * from './modelResolutionSelectorResponseDto';
 export * from './modelResolutionSelectorResponseDtoExtra';
+export * from './modelResolutionSelectorResponseDtoModelCapability';
 export * from './modelResolutionSelectorResponseDtoModelClass';
 export * from './modelResponseDto';
 export * from './modelResponseDtoContextWindow';
@@ -273,6 +279,7 @@ export * from './roleCapabilityProfileDtoPaginatedEnvelope';
 export * from './roleCapabilityProfileDtoSurface';
 export * from './roleCapabilityProfileDtoWritePolicy';
 export * from './scopeSource';
+export * from './standingSessionRefDto';
 export * from './startEmbeddingMigrationDto';
 export * from './syncModelsResponseDto';
 export * from './syncModelsResponseDtoDataEnvelope';
@@ -304,6 +311,7 @@ export * from './upsertToolProfileDto';
 export * from './widgetKindDto';
 export * from './widgetKindDtoPayloadSchema';
 export * from './widgetKindListDto';
+export * from './widgetKindListDtoDataEnvelope';
 export * from './widgetKindSource';
 export * from './workingFileEntryDto';
 export * from './workingFileEntryDtoSourceRef';

package/dist/models/index.js

@@ -136,6 +136,7 @@ __exportStar(require("./createProviderDto"), exports);
 __exportStar(require("./createProviderDtoApiType"), exports);
 __exportStar(require("./createProviderDtoAuthType"), exports);
 __exportStar(require("./credentialKind"), exports);
+__exportStar(require("./durableWorkspaceRefDto"), exports);
 __exportStar(require("./embeddingCommitmentDto"), exports);
 __exportStar(require("./embeddingCommitmentDtoDataEnvelope"), exports);
 __exportStar(require("./embeddingCommitmentDtoState"), exports);
@@ -161,6 +162,7 @@ __exportStar(require("./llmReadinessResponseDtoDataEnvelope"), exports);
 __exportStar(require("./llmReadinessResponseDtoStatus"), exports);
 __exportStar(require("./llmRegistryControllerResolveForInvocationModelClass"), exports);
 __exportStar(require("./llmRegistryControllerResolveForInvocationParams"), exports);
+__exportStar(require("./llmRegistryControllerResolveForInvocationPreferredModelClass"), exports);
 __exportStar(require("./llmRegistryControllerResolveForInvocationPurpose"), exports);
 __exportStar(require("./migrationConsumerDoneDto"), exports);
 __exportStar(require("./migrationConsumerDoneDtoConsumer"), exports);
@@ -179,14 +181,18 @@ __exportStar(require("./modelMode"), exports);
 __exportStar(require("./modelPricingTierDto"), exports);
 __exportStar(require("./modelResolutionRuleResponseDto"), exports);
 __exportStar(require("./modelResolutionRuleResponseDtoDataEnvelope"), exports);
+__exportStar(require("./modelResolutionRuleResponseDtoDefaultTargetOverridePrevModelClass"), exports);
+__exportStar(require("./modelResolutionRuleResponseDtoDefaultTargetOverridePrevTargetKind"), exports);
 __exportStar(require("./modelResolutionRuleResponseDtoPaginatedEnvelope"), exports);
 __exportStar(require("./modelResolutionRuleResponseDtoTargetKind"), exports);
 __exportStar(require("./modelResolutionRuleResponseDtoTargetModelClass"), exports);
 __exportStar(require("./modelResolutionSelectorDto"), exports);
 __exportStar(require("./modelResolutionSelectorDtoExtra"), exports);
+__exportStar(require("./modelResolutionSelectorDtoModelCapability"), exports);
 __exportStar(require("./modelResolutionSelectorDtoModelClass"), exports);
 __exportStar(require("./modelResolutionSelectorResponseDto"), exports);
 __exportStar(require("./modelResolutionSelectorResponseDtoExtra"), exports);
+__exportStar(require("./modelResolutionSelectorResponseDtoModelCapability"), exports);
 __exportStar(require("./modelResolutionSelectorResponseDtoModelClass"), exports);
 __exportStar(require("./modelResponseDto"), exports);
 __exportStar(require("./modelResponseDtoContextWindow"), exports);
@@ -290,6 +296,7 @@ __exportStar(require("./roleCapabilityProfileDtoPaginatedEnvelope"), exports);
 __exportStar(require("./roleCapabilityProfileDtoSurface"), exports);
 __exportStar(require("./roleCapabilityProfileDtoWritePolicy"), exports);
 __exportStar(require("./scopeSource"), exports);
+__exportStar(require("./standingSessionRefDto"), exports);
 __exportStar(require("./startEmbeddingMigrationDto"), exports);
 __exportStar(require("./syncModelsResponseDto"), exports);
 __exportStar(require("./syncModelsResponseDtoDataEnvelope"), exports);
@@ -321,6 +328,7 @@ __exportStar(require("./upsertToolProfileDto"), exports);
 __exportStar(require("./widgetKindDto"), exports);
 __exportStar(require("./widgetKindDtoPayloadSchema"), exports);
 __exportStar(require("./widgetKindListDto"), exports);
+__exportStar(require("./widgetKindListDtoDataEnvelope"), exports);
 __exportStar(require("./widgetKindSource"), exports);
 __exportStar(require("./workingFileEntryDto"), exports);
 __exportStar(require("./workingFileEntryDtoSourceRef"), exports);

package/dist/models/llmRegistryControllerResolveForInvocationParams.d.ts

@@ -6,8 +6,13 @@
  * OpenAPI spec version: 0.1.0
  */
 import type { LlmRegistryControllerResolveForInvocationModelClass } from './llmRegistryControllerResolveForInvocationModelClass.js';
+import type { LlmRegistryControllerResolveForInvocationPreferredModelClass } from './llmRegistryControllerResolveForInvocationPreferredModelClass.js';
 import type { LlmRegistryControllerResolveForInvocationPurpose } from './llmRegistryControllerResolveForInvocationPurpose.js';
 export type LlmRegistryControllerResolveForInvocationParams = {
+    /**
+     * Per-session "smartness" preference — the matrix `modelClass` MATCHED DIMENSION (NOT an above-rules override, unlike `modelClass`). Populates `context.modelClass` so the Matrix still runs its full rule evaluation: a tier-injected managed rule selecting on `modelClass` CLAMPS the preference (a managed org can never reach a model outside its tier); an unmapped class falls through to the org default rule (safe); a BYOK org resolves directly. Not privilege-escalating — it can only match existing rules. Ignored when an explicit `modelClass`/`modelId` override is present (the override pre-empts the matrix). The route as a whole is service-actor gated.
+     */
+    preferredModelClass?: LlmRegistryControllerResolveForInvocationPreferredModelClass;
     /**
      * Non-agent invocation purpose — matrix `purpose` dimension. Set by system flows that route LLM calls outside the agent/skill model (memory summarization, embedding, reorganization). Falls through to the org default rule when no purpose-specific rule exists.
      */

package/dist/models/llmRegistryControllerResolveForInvocationPreferredModelClass.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Generated by orval v8.16.0 🍺
+ * Do not edit manually.
+ * LLM Registry API
+ * Central registry for LLM providers, models, and per-project model configuration
+ * OpenAPI spec version: 0.1.0
+ */
+export type LlmRegistryControllerResolveForInvocationPreferredModelClass = typeof LlmRegistryControllerResolveForInvocationPreferredModelClass[keyof typeof LlmRegistryControllerResolveForInvocationPreferredModelClass];
+export declare const LlmRegistryControllerResolveForInvocationPreferredModelClass: {
+    readonly coding: "coding";
+    readonly review: "review";
+    readonly creative: "creative";
+    readonly planning: "planning";
+    readonly utility: "utility";
+};

package/dist/models/llmRegistryControllerResolveForInvocationPreferredModelClass.js

@@ -0,0 +1,17 @@
+"use strict";
+/**
+ * Generated by orval v8.16.0 🍺
+ * Do not edit manually.
+ * LLM Registry API
+ * Central registry for LLM providers, models, and per-project model configuration
+ * OpenAPI spec version: 0.1.0
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LlmRegistryControllerResolveForInvocationPreferredModelClass = void 0;
+exports.LlmRegistryControllerResolveForInvocationPreferredModelClass = {
+    coding: 'coding',
+    review: 'review',
+    creative: 'creative',
+    planning: 'planning',
+    utility: 'utility',
+};

package/dist/models/modelResolutionRuleResponseDto.d.ts

@@ -5,6 +5,8 @@
  * Central registry for LLM providers, models, and per-project model configuration
  * OpenAPI spec version: 0.1.0
  */
+import type { ModelResolutionRuleResponseDtoDefaultTargetOverridePrevModelClass } from './modelResolutionRuleResponseDtoDefaultTargetOverridePrevModelClass.js';
+import type { ModelResolutionRuleResponseDtoDefaultTargetOverridePrevTargetKind } from './modelResolutionRuleResponseDtoDefaultTargetOverridePrevTargetKind.js';
 import type { ModelResolutionRuleResponseDtoTargetKind } from './modelResolutionRuleResponseDtoTargetKind.js';
 import type { ModelResolutionRuleResponseDtoTargetModelClass } from './modelResolutionRuleResponseDtoTargetModelClass.js';
 import type { ModelResolutionSelectorResponseDto } from './modelResolutionSelectorResponseDto.js';
@@ -23,6 +25,51 @@ export interface ModelResolutionRuleResponseDto {
     targetTemperature?: number | null;
     priority: number;
     isDefault: boolean;
+    /**
+       * ResourceManagedBy ownership KIND (`ui`/`iac`/`seeder`/`runtime_registered`/`system`). NULL for a plain user/org-admin-authored rule.
+       * @nullable
+       */
+    managedBy?: string | null;
+    /**
+       * Owning service identity for a service-actor-upserted rule (derived from the service subject). NULL for authored/reconciler rules.
+       * @nullable
+       */
+    managedOwner?: string | null;
+    /**
+       * The owner's stable natural key. NULL for authored rules; non-null for managed/reconciler rows.
+       * @nullable
+       */
+    managedKey?: string | null;
+    /**
+       * SEAM #2: the service that repointed THIS org-default rule's target (derived from its subject). Non-null ONLY on the default row while a default-target override is active; the flag that an override is in effect. NULL otherwise.
+       * @nullable
+       */
+    defaultTargetOverrideOwner?: string | null;
+    /**
+       * SEAM #2: the target KIND the default rule had before the first override, restored on revert. NULL when no override is active.
+       * @nullable
+       */
+    defaultTargetOverridePrevTargetKind?: ModelResolutionRuleResponseDtoDefaultTargetOverridePrevTargetKind;
+    /**
+       * SEAM #2: the concrete model id the default rule had before the first override. NULL when no override is active or the prior default was not concrete.
+       * @nullable
+       */
+    defaultTargetOverridePrevModelId?: string | null;
+    /**
+       * SEAM #2: the provider slug the default rule had before the first override. NULL when no override is active.
+       * @nullable
+       */
+    defaultTargetOverridePrevProviderSlug?: string | null;
+    /**
+       * SEAM #2: the strategy class the default rule had before the first override. NULL when no override is active or the prior default was not a strategy ref.
+       * @nullable
+       */
+    defaultTargetOverridePrevModelClass?: ModelResolutionRuleResponseDtoDefaultTargetOverridePrevModelClass;
+    /**
+       * SEAM #2: the temperature the default rule carried before the first override. NULL when no override is active or none was set.
+       * @nullable
+       */
+    defaultTargetOverridePrevTemperature?: number | null;
     createdBy: string;
     createdAt: string;
     updatedAt: string;

package/dist/models/modelResolutionRuleResponseDtoDefaultTargetOverridePrevModelClass.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Generated by orval v8.16.0 🍺
+ * Do not edit manually.
+ * LLM Registry API
+ * Central registry for LLM providers, models, and per-project model configuration
+ * OpenAPI spec version: 0.1.0
+ */
+/**
+ * SEAM #2: the strategy class the default rule had before the first override. NULL when no override is active or the prior default was not a strategy ref.
+ * @nullable
+ */
+export type ModelResolutionRuleResponseDtoDefaultTargetOverridePrevModelClass = typeof ModelResolutionRuleResponseDtoDefaultTargetOverridePrevModelClass[keyof typeof ModelResolutionRuleResponseDtoDefaultTargetOverridePrevModelClass] | null;
+export declare const ModelResolutionRuleResponseDtoDefaultTargetOverridePrevModelClass: {
+    readonly coding: "coding";
+    readonly review: "review";
+    readonly creative: "creative";
+    readonly planning: "planning";
+    readonly utility: "utility";
+};

package/dist/models/modelResolutionRuleResponseDtoDefaultTargetOverridePrevModelClass.js

@@ -0,0 +1,17 @@
+"use strict";
+/**
+ * Generated by orval v8.16.0 🍺
+ * Do not edit manually.
+ * LLM Registry API
+ * Central registry for LLM providers, models, and per-project model configuration
+ * OpenAPI spec version: 0.1.0
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ModelResolutionRuleResponseDtoDefaultTargetOverridePrevModelClass = void 0;
+exports.ModelResolutionRuleResponseDtoDefaultTargetOverridePrevModelClass = {
+    coding: 'coding',
+    review: 'review',
+    creative: 'creative',
+    planning: 'planning',
+    utility: 'utility',
+};

package/dist/models/modelResolutionRuleResponseDtoDefaultTargetOverridePrevTargetKind.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Generated by orval v8.16.0 🍺
+ * Do not edit manually.
+ * LLM Registry API
+ * Central registry for LLM providers, models, and per-project model configuration
+ * OpenAPI spec version: 0.1.0
+ */
+/**
+ * SEAM #2: the target KIND the default rule had before the first override, restored on revert. NULL when no override is active.
+ * @nullable
+ */
+export type ModelResolutionRuleResponseDtoDefaultTargetOverridePrevTargetKind = typeof ModelResolutionRuleResponseDtoDefaultTargetOverridePrevTargetKind[keyof typeof ModelResolutionRuleResponseDtoDefaultTargetOverridePrevTargetKind] | null;
+export declare const ModelResolutionRuleResponseDtoDefaultTargetOverridePrevTargetKind: {
+    readonly concrete: "concrete";
+    readonly strategy: "strategy";
+};

package/dist/models/modelResolutionRuleResponseDtoDefaultTargetOverridePrevTargetKind.js

@@ -0,0 +1,14 @@
+"use strict";
+/**
+ * Generated by orval v8.16.0 🍺
+ * Do not edit manually.
+ * LLM Registry API
+ * Central registry for LLM providers, models, and per-project model configuration
+ * OpenAPI spec version: 0.1.0
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ModelResolutionRuleResponseDtoDefaultTargetOverridePrevTargetKind = void 0;
+exports.ModelResolutionRuleResponseDtoDefaultTargetOverridePrevTargetKind = {
+    concrete: 'concrete',
+    strategy: 'strategy',
+};

package/dist/models/modelResolutionSelectorDto.d.ts

@@ -6,6 +6,7 @@
  * OpenAPI spec version: 0.1.0
  */
 import type { ModelResolutionSelectorDtoExtra } from './modelResolutionSelectorDtoExtra.js';
+import type { ModelResolutionSelectorDtoModelCapability } from './modelResolutionSelectorDtoModelCapability.js';
 import type { ModelResolutionSelectorDtoModelClass } from './modelResolutionSelectorDtoModelClass.js';
 export interface ModelResolutionSelectorDto {
     /** Match when the resolving agent slug equals this value. */
@@ -20,6 +21,8 @@ export interface ModelResolutionSelectorDto {
     purpose?: string;
     /** Match when the resolving agent's model class equals this value (the Phase-4 `modelClass` dimension — one rule routes e.g. every `review`-class agent). */
     modelClass?: ModelResolutionSelectorDtoModelClass;
+    /** Match when the invocation REQUIRES this model capability/modality (the `modelCapability` dimension — one rule routes e.g. every vision-requiring invocation to a multimodal model without pinning a provider). */
+    modelCapability?: ModelResolutionSelectorDtoModelCapability;
     /** Forward-compat bag of additional registry dimensions → required literal. Omit / {} when only structured dimensions are used. */
     extra?: ModelResolutionSelectorDtoExtra;
 }

package/dist/models/modelResolutionSelectorDtoModelCapability.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Generated by orval v8.16.0 🍺
+ * Do not edit manually.
+ * LLM Registry API
+ * Central registry for LLM providers, models, and per-project model configuration
+ * OpenAPI spec version: 0.1.0
+ */
+/**
+ * Match when the invocation REQUIRES this model capability/modality (the `modelCapability` dimension — one rule routes e.g. every vision-requiring invocation to a multimodal model without pinning a provider).
+ */
+export type ModelResolutionSelectorDtoModelCapability = typeof ModelResolutionSelectorDtoModelCapability[keyof typeof ModelResolutionSelectorDtoModelCapability];
+export declare const ModelResolutionSelectorDtoModelCapability: {
+    readonly vision: "vision";
+    readonly long_context: "long_context";
+    readonly reasoning: "reasoning";
+    readonly function_calling: "function_calling";
+    readonly audio: "audio";
+    readonly embedding: "embedding";
+};

package/dist/models/modelResolutionSelectorDtoModelCapability.js

@@ -0,0 +1,18 @@
+"use strict";
+/**
+ * Generated by orval v8.16.0 🍺
+ * Do not edit manually.
+ * LLM Registry API
+ * Central registry for LLM providers, models, and per-project model configuration
+ * OpenAPI spec version: 0.1.0
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ModelResolutionSelectorDtoModelCapability = void 0;
+exports.ModelResolutionSelectorDtoModelCapability = {
+    vision: 'vision',
+    long_context: 'long_context',
+    reasoning: 'reasoning',
+    function_calling: 'function_calling',
+    audio: 'audio',
+    embedding: 'embedding',
+};

package/dist/models/modelResolutionSelectorResponseDto.d.ts

@@ -6,6 +6,7 @@
  * OpenAPI spec version: 0.1.0
  */
 import type { ModelResolutionSelectorResponseDtoExtra } from './modelResolutionSelectorResponseDtoExtra.js';
+import type { ModelResolutionSelectorResponseDtoModelCapability } from './modelResolutionSelectorResponseDtoModelCapability.js';
 import type { ModelResolutionSelectorResponseDtoModelClass } from './modelResolutionSelectorResponseDtoModelClass.js';
 export interface ModelResolutionSelectorResponseDto {
     /** @nullable */
@@ -20,6 +21,8 @@ export interface ModelResolutionSelectorResponseDto {
     purpose?: string | null;
     /** @nullable */
     modelClass?: ModelResolutionSelectorResponseDtoModelClass;
+    /** @nullable */
+    modelCapability?: ModelResolutionSelectorResponseDtoModelCapability;
     /** Additional registry dimensions. `{}` when none. */
     extra: ModelResolutionSelectorResponseDtoExtra;
 }

package/dist/models/modelResolutionSelectorResponseDtoModelCapability.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Generated by orval v8.16.0 🍺
+ * Do not edit manually.
+ * LLM Registry API
+ * Central registry for LLM providers, models, and per-project model configuration
+ * OpenAPI spec version: 0.1.0
+ */
+/**
+ * @nullable
+ */
+export type ModelResolutionSelectorResponseDtoModelCapability = typeof ModelResolutionSelectorResponseDtoModelCapability[keyof typeof ModelResolutionSelectorResponseDtoModelCapability] | null;
+export declare const ModelResolutionSelectorResponseDtoModelCapability: {
+    readonly vision: "vision";
+    readonly long_context: "long_context";
+    readonly reasoning: "reasoning";
+    readonly function_calling: "function_calling";
+    readonly audio: "audio";
+    readonly embedding: "embedding";
+};

package/dist/models/modelResolutionSelectorResponseDtoModelCapability.js

@@ -0,0 +1,18 @@
+"use strict";
+/**
+ * Generated by orval v8.16.0 🍺
+ * Do not edit manually.
+ * LLM Registry API
+ * Central registry for LLM providers, models, and per-project model configuration
+ * OpenAPI spec version: 0.1.0
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ModelResolutionSelectorResponseDtoModelCapability = void 0;
+exports.ModelResolutionSelectorResponseDtoModelCapability = {
+    vision: 'vision',
+    long_context: 'long_context',
+    reasoning: 'reasoning',
+    function_calling: 'function_calling',
+    audio: 'audio',
+    embedding: 'embedding',
+};

package/dist/models/resolvedAgentResponseDto.d.ts

@@ -10,7 +10,9 @@ import type { AgentNodeDto } from './agentNodeDto.js';
 import type { AgentReachTier } from './agentReachTier.js';
 import type { AgentSessionLifecycle } from './agentSessionLifecycle.js';
 import type { AgentWorkspaceDto } from './agentWorkspaceDto.js';
+import type { DurableWorkspaceRefDto } from './durableWorkspaceRefDto.js';
 import type { ScopeSource } from './scopeSource.js';
+import type { StandingSessionRefDto } from './standingSessionRefDto.js';
 import type { WorkspaceSharingPolicy } from './workspaceSharingPolicy.js';
 export interface ResolvedAgentResponseDto {
     slug: string;
@@ -27,6 +29,10 @@ export interface ResolvedAgentResponseDto {
     sessionLifecycle?: AgentSessionLifecycle | null;
     /** Resolved workspace-sharing policy — whether a session launch of this agent may POOL onto a compatible running pod as a new thread (`shareable`) or must always run in its own isolated worker (`isolated`). Always populated: a row with no stored value resolves to `isolated` (WORKSPACE_SHARING_DEFAULT). agent-session-api reads this to gate session-thread pooling at launch. */
     workspaceSharing: WorkspaceSharingPolicy;
+    /** Resolved standing-session pin — present only when the agent declares one. When present, agent-session-api does a `(orgId, projectId, pinKey)` get-or-create at `POST /sessions` and ADOPTS a non-terminal existing session instead of minting a fresh one. Absent ⇒ a fresh session per launch. */
+    standingSession?: StandingSessionRefDto | null;
+    /** Resolved durable shared-workspace binding — present only when the agent declares one. When present, agent-session-api stores `workspaceRef` on `Session.workspaceRef` so the session attaches to the SHARED, workspaceRef-keyed durable workspace (multi-pod `WorkspaceSharingPolicy.Shared`) instead of a private per-session one. Absent ⇒ a private per-session workspace. */
+    durableWorkspace?: DurableWorkspaceRefDto | null;
     /** Chunk 3 — the deduped, sorted union of every CapabilityRef the agent needs to drive its armed tools + skills across the whole sub-agent tree (the auto-grant-from-arming manifest). Derived at resolve time from the MCP catalog (tools) + skill frontmatter (skills). Empty when nothing armed declares a capability — the default-safe no-op. The capability-analysis endpoint returns the same union plus the unresolved-ref diagnostics. */
     requiredCapabilities: string[];
     /** Special-ability CapabilityRefs granted on top of the reach tier; unioned into the auto-grant manifest (so they also appear in `requiredCapabilities`). Always present (defaults to []). */

package/dist/models/standingSessionRefDto.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Generated by orval v8.16.0 🍺
+ * Do not edit manually.
+ * LLM Registry API
+ * Central registry for LLM providers, models, and per-project model configuration
+ * OpenAPI spec version: 0.1.0
+ */
+export interface StandingSessionRefDto {
+    /** Stable key identifying the standing session for a purpose/biome, e.g. `{biomeId}:{purpose}`. Two launches of the same agent within the same `(orgId, projectId)` that resolve this key reuse ONE session row. */
+    pinKey: string;
+}

package/dist/models/standingSessionRefDto.js

@@ -0,0 +1,9 @@
+"use strict";
+/**
+ * Generated by orval v8.16.0 🍺
+ * Do not edit manually.
+ * LLM Registry API
+ * Central registry for LLM providers, models, and per-project model configuration
+ * OpenAPI spec version: 0.1.0
+ */
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/models/updateAgentDto.d.ts

@@ -10,6 +10,8 @@ import type { AgentNodeDto } from './agentNodeDto.js';
 import type { AgentReachTier } from './agentReachTier.js';
 import type { AgentSessionLifecycle } from './agentSessionLifecycle.js';
 import type { AgentWorkspaceDto } from './agentWorkspaceDto.js';
+import type { DurableWorkspaceRefDto } from './durableWorkspaceRefDto.js';
+import type { StandingSessionRefDto } from './standingSessionRefDto.js';
 import type { WorkspaceSharingPolicy } from './workspaceSharingPolicy.js';
 export interface UpdateAgentDto {
     displayName?: string;
@@ -24,6 +26,10 @@ export interface UpdateAgentDto {
     sessionLifecycle?: AgentSessionLifecycle;
     /** Whether a session launch may POOL onto a compatible running pod (`shareable`) or must always run isolated (`isolated`). Omitted leaves the stored value unchanged; the column default is `isolated`. */
     workspaceSharing?: WorkspaceSharingPolicy;
+    /** Standing-session pin. Omitted leaves the stored value unchanged; set `{ pinKey }` to make every launch reuse ONE session keyed by `pinKey`; pass `null` to clear the pin (the agent stops being a standing agent). */
+    standingSession?: StandingSessionRefDto | null;
+    /** Durable shared-workspace binding. Omitted leaves the stored value unchanged; set `{ workspaceRef }` to attach every session this agent launches to ONE durable shared workspace; pass `null` to clear it (the agent reverts to a private per-session workspace). */
+    durableWorkspace?: DurableWorkspaceRefDto | null;
     /** Special-ability CapabilityRefs granted on top of the reach tier; unioned into the auto-grant manifest. */
     abilities?: string[];
 }

package/dist/models/widgetKindListDtoDataEnvelope.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Generated by orval v8.16.0 🍺
+ * Do not edit manually.
+ * LLM Registry API
+ * Central registry for LLM providers, models, and per-project model configuration
+ * OpenAPI spec version: 0.1.0
+ */
+import type { WidgetKindListDto } from './widgetKindListDto.js';
+export interface WidgetKindListDtoDataEnvelope {
+    data: WidgetKindListDto;
+}

package/dist/models/widgetKindListDtoDataEnvelope.js

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

package/dist/models/workspaceSharingPolicy.d.ts

@@ -12,4 +12,5 @@ export type WorkspaceSharingPolicy = typeof WorkspaceSharingPolicy[keyof typeof
 export declare const WorkspaceSharingPolicy: {
     readonly isolated: "isolated";
     readonly shareable: "shareable";
+    readonly shared: "shared";
 };

package/dist/models/workspaceSharingPolicy.js

@@ -11,4 +11,5 @@ exports.WorkspaceSharingPolicy = void 0;
 exports.WorkspaceSharingPolicy = {
     isolated: 'isolated',
     shareable: 'shareable',
+    shared: 'shared',
 };

package/package.json

@@ -1,14 +1,14 @@
 {
   "name": "@xemahq/llm-registry-api-client",
-  "version": "0.4.1",
+  "version": "0.4.2",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
   "files": [
     "dist"
   ],
   "publishConfig": {
-    "registry": "https://registry.npmjs.org/",
-    "access": "public"
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
   },
   "devDependencies": {
     "typescript": "5.9.3"
@@ -19,7 +19,7 @@
     "service": "llm-registry-api",
     "biome": "agent-runtime",
     "target": "server",
-    "generator": "@xemahq/api-client-generator@0.1.3",
+    "generator": "@xemahq/api-client-generator@0.2.0",
     "source": "openapi.public.json"
   },
   "license": "LicenseRef-Xema-BSL-1.1",