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

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/{resolvedAgentResponseDtoModelClass.js → modelResolutionRuleResponseDtoDefaultTargetOverridePrevModelClass.js}

@@ -7,8 +7,8 @@
  * OpenAPI spec version: 0.1.0
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.ResolvedAgentResponseDtoModelClass = void 0;
-exports.ResolvedAgentResponseDtoModelClass = {
+exports.ModelResolutionRuleResponseDtoDefaultTargetOverridePrevModelClass = void 0;
+exports.ModelResolutionRuleResponseDtoDefaultTargetOverridePrevModelClass = {
     coding: 'coding',
     review: 'review',
     creative: 'creative',

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/{compositionModelOverrideDtoKind.js → modelResolutionRuleResponseDtoDefaultTargetOverridePrevTargetKind.js}

@@ -7,8 +7,8 @@
  * OpenAPI spec version: 0.1.0
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.CompositionModelOverrideDtoKind = void 0;
-exports.CompositionModelOverrideDtoKind = {
+exports.ModelResolutionRuleResponseDtoDefaultTargetOverridePrevTargetKind = void 0;
+exports.ModelResolutionRuleResponseDtoDefaultTargetOverridePrevTargetKind = {
     concrete: 'concrete',
     strategy: 'strategy',
 };

package/dist/models/modelResolutionSelectorDto.d.ts

@@ -6,6 +6,8 @@
  * 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. */
     agent?: string;
@@ -17,6 +19,10 @@ export interface ModelResolutionSelectorDto {
     stage?: string;
     /** Match when the non-agent invocation purpose equals this value. Used by system flows that route LLM calls outside the agent/skill model (memory summarization, embedding, reorganization). Closed value set is owned per consumer (see `MemoryMatrixPurpose` in memory-api). */
     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/{createAgentDefinitionDtoModelClass.d.ts → modelResolutionSelectorDtoModelClass.d.ts}

@@ -6,10 +6,10 @@
  * OpenAPI spec version: 0.1.0
  */
 /**
- * LLM-routing tier. Strategy entries map class → modelSlug. Distinct from AgentRunRole (permissions).
+ * 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).
  */
-export type CreateAgentDefinitionDtoModelClass = typeof CreateAgentDefinitionDtoModelClass[keyof typeof CreateAgentDefinitionDtoModelClass];
-export declare const CreateAgentDefinitionDtoModelClass: {
+export type ModelResolutionSelectorDtoModelClass = typeof ModelResolutionSelectorDtoModelClass[keyof typeof ModelResolutionSelectorDtoModelClass];
+export declare const ModelResolutionSelectorDtoModelClass: {
     readonly coding: "coding";
     readonly review: "review";
     readonly creative: "creative";

package/dist/models/{agentDefinitionResponseDtoModelClass.js → modelResolutionSelectorDtoModelClass.js}

@@ -7,8 +7,8 @@
  * OpenAPI spec version: 0.1.0
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.AgentDefinitionResponseDtoModelClass = void 0;
-exports.AgentDefinitionResponseDtoModelClass = {
+exports.ModelResolutionSelectorDtoModelClass = void 0;
+exports.ModelResolutionSelectorDtoModelClass = {
     coding: 'coding',
     review: 'review',
     creative: 'creative',

package/dist/models/modelResolutionSelectorResponseDto.d.ts

@@ -6,6 +6,8 @@
  * 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 */
     agent?: string | null;
@@ -17,6 +19,10 @@ export interface ModelResolutionSelectorResponseDto {
     stage?: string | null;
     /** @nullable */
     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/{agentDefinitionResponseDtoModelClass.d.ts → modelResolutionSelectorResponseDtoModelClass.d.ts}

@@ -5,8 +5,11 @@
  * Central registry for LLM providers, models, and per-project model configuration
  * OpenAPI spec version: 0.1.0
  */
-export type AgentDefinitionResponseDtoModelClass = typeof AgentDefinitionResponseDtoModelClass[keyof typeof AgentDefinitionResponseDtoModelClass];
-export declare const AgentDefinitionResponseDtoModelClass: {
+/**
+ * @nullable
+ */
+export type ModelResolutionSelectorResponseDtoModelClass = typeof ModelResolutionSelectorResponseDtoModelClass[keyof typeof ModelResolutionSelectorResponseDtoModelClass] | null;
+export declare const ModelResolutionSelectorResponseDtoModelClass: {
     readonly coding: "coding";
     readonly review: "review";
     readonly creative: "creative";

package/dist/models/{compositionModelOverrideDtoModelClass.js → modelResolutionSelectorResponseDtoModelClass.js}

@@ -7,8 +7,8 @@
  * OpenAPI spec version: 0.1.0
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.CompositionModelOverrideDtoModelClass = void 0;
-exports.CompositionModelOverrideDtoModelClass = {
+exports.ModelResolutionSelectorResponseDtoModelClass = void 0;
+exports.ModelResolutionSelectorResponseDtoModelClass = {
     coding: 'coding',
     review: 'review',
     creative: 'creative',

package/dist/models/modelResponseDto.d.ts

@@ -6,6 +6,8 @@
  * OpenAPI spec version: 0.1.0
  */
 import type { ModelModality } from './modelModality.js';
+import type { ModelMode } from './modelMode.js';
+import type { ModelPricingTierDto } from './modelPricingTierDto.js';
 import type { ModelResponseDtoContextWindow } from './modelResponseDtoContextWindow.js';
 export interface ModelResponseDto {
     id: string;
@@ -13,9 +15,84 @@ export interface ModelResponseDto {
     modelId: string;
     displayName: string;
     contextWindow?: ModelResponseDtoContextWindow;
+    /**
+       * Max generation/output tokens. Distinct from contextWindow (the input budget). Null when no authoritative source declares one.
+       * @nullable
+       */
+    maxOutputTokens?: number | null;
+    /** Operating mode of the model. Null when no signal resolved one. */
+    mode?: ModelMode | null;
+    /**
+       * Embedding output vector dimension (only for embedding models).
+       * @nullable
+       */
+    embeddingDimension?: number | null;
     capabilities: string[];
     /** Closed-enum input/output modalities the model serves. Empty when none declared. */
     modalities: ModelModality[];
+    /** Model exposes function/tool calling. */
+    supportsTools: boolean;
+    /** Model accepts image inputs. */
+    supportsVision: boolean;
+    /** Model performs explicit reasoning. */
+    supportsReasoning: boolean;
+    /** Model accepts audio inputs. */
+    supportsAudioInput: boolean;
+    /** Model accepts PDF inputs. */
+    supportsPdfInput: boolean;
+    /** Model supports prompt caching. */
+    supportsPromptCaching: boolean;
+    /** Model supports structured JSON output mode. */
+    supportsJsonMode: boolean;
+    /** Model supports built-in web search. */
+    supportsWebSearch: boolean;
+    /** Model has rolled out of the current window. */
+    deprecated: boolean;
+    /**
+       * Retirement date (ISO 8601) when a source publishes one; null otherwise.
+       * @nullable
+       */
+    deprecationDate?: string | null;
+    /**
+       * Input price (USD per 1M tokens).
+       * @nullable
+       */
+    inputPricePerMToken?: number | null;
+    /**
+       * Output price (USD per 1M tokens).
+       * @nullable
+       */
+    outputPricePerMToken?: number | null;
+    /**
+       * Cache-read price (USD per 1M tokens).
+       * @nullable
+       */
+    cacheReadPerMToken?: number | null;
+    /**
+       * Cache-write price (USD per 1M tokens).
+       * @nullable
+       */
+    cacheWritePerMToken?: number | null;
+    /**
+       * Currency of the price columns ('USD' when any price is present, null otherwise).
+       * @nullable
+       */
+    priceCurrency?: string | null;
+    /**
+       * Context-tier pricing overlay sorted ascending by minInputTokens. Null when no tier is published.
+       * @nullable
+       */
+    tieredPricing?: ModelPricingTierDto[] | null;
+    /**
+       * Per-input-image price (USD per unit).
+       * @nullable
+       */
+    imageInputPerUnit?: number | null;
+    /**
+       * Per-input-audio-second price (USD per second).
+       * @nullable
+       */
+    audioInputPerSecond?: number | null;
     isActive: boolean;
     createdAt: string;
 }

package/dist/models/{compositionPermissionsDto.d.ts → probeProviderDto.d.ts}

@@ -5,7 +5,9 @@
  * Central registry for LLM providers, models, and per-project model configuration
  * OpenAPI spec version: 0.1.0
  */
-import type { CompositionPermissionsToolsDto } from './compositionPermissionsToolsDto.js';
-export interface CompositionPermissionsDto {
-    tools: CompositionPermissionsToolsDto;
+import type { ProbeProviderDtoApiType } from './probeProviderDtoApiType.js';
+export interface ProbeProviderDto {
+    apiType: ProbeProviderDtoApiType;
+    baseUrl: string;
+    apiKey: string;
 }

package/dist/models/{createSystemProviderDtoApiType.d.ts → probeProviderDtoApiType.d.ts}

@@ -1,12 +1,12 @@
 /**
- * Generated by orval v8.6.2 🍺
+ * 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 CreateSystemProviderDtoApiType = typeof CreateSystemProviderDtoApiType[keyof typeof CreateSystemProviderDtoApiType];
-export declare const CreateSystemProviderDtoApiType: {
+export type ProbeProviderDtoApiType = typeof ProbeProviderDtoApiType[keyof typeof ProbeProviderDtoApiType];
+export declare const ProbeProviderDtoApiType: {
     readonly 'openai-compatible': "openai-compatible";
     readonly anthropic: "anthropic";
     readonly google: "google";

package/dist/models/{createSystemProviderDtoApiType.js → probeProviderDtoApiType.js}

@@ -1,14 +1,14 @@
 "use strict";
 /**
- * Generated by orval v8.6.2 🍺
+ * 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.CreateSystemProviderDtoApiType = void 0;
-exports.CreateSystemProviderDtoApiType = {
+exports.ProbeProviderDtoApiType = void 0;
+exports.ProbeProviderDtoApiType = {
     'openai-compatible': 'openai-compatible',
     anthropic: 'anthropic',
     google: 'google',

package/dist/models/probedModelDto.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 interface ProbedModelDto {
+    /** Model ID as reported by the provider /models endpoint. */
+    id: string;
+    /** Human-readable model name, when the provider reports one. */
+    displayName?: string;
+    /** Context window resolved from the provider /models response or gateway metadata. Absent when no authoritative value was found. */
+    contextWindow?: number;
+}

package/dist/models/promptMergeMode.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
+ */
+/**
+ * How `instructions` combine with the base agent `systemPrompt`. `append` appends after the base prompt; `replace` makes `instructions` the prompt body (config still inherited). Absent ⇒ append.
+ */
+export type PromptMergeMode = typeof PromptMergeMode[keyof typeof PromptMergeMode];
+export declare const PromptMergeMode: {
+    readonly append: "append";
+    readonly replace: "replace";
+};

package/dist/models/promptMergeMode.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.PromptMergeMode = void 0;
+exports.PromptMergeMode = {
+    append: 'append',
+    replace: 'replace',
+};

package/dist/models/providerProbeResponseDto.d.ts

@@ -0,0 +1,12 @@
+/**
+ * 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 { ProbedModelDto } from './probedModelDto.js';
+export interface ProviderProbeResponseDto {
+    /** Models discovered at the probed endpoint (server-side, before the provider is saved). */
+    models: ProbedModelDto[];
+}

package/dist/models/{compositionPermissionsToolsDto.d.ts → providerProbeResponseDtoDataEnvelope.d.ts}

@@ -5,8 +5,7 @@
  * Central registry for LLM providers, models, and per-project model configuration
  * OpenAPI spec version: 0.1.0
  */
-import type { ToolsetKey } from './toolsetKey.js';
-export interface CompositionPermissionsToolsDto {
-    allow: ToolsetKey[];
-    deny: ToolsetKey[];
+import type { ProviderProbeResponseDto } from './providerProbeResponseDto.js';
+export interface ProviderProbeResponseDtoDataEnvelope {
+    data: ProviderProbeResponseDto;
 }

package/dist/models/resolvedAgentResponseDto.d.ts

@@ -7,8 +7,13 @@
  */
 import type { AgentCapabilityLayerDto } from './agentCapabilityLayerDto.js';
 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;
     version: string;
@@ -18,6 +23,20 @@ export interface ResolvedAgentResponseDto {
     root: AgentNodeDto;
     /** Capability envelope applied to the whole composition at runtime. Always present. */
     capability: AgentCapabilityLayerDto;
+    /** The root composition agent's reach-tier permission ceiling (Chunk 2). A composition row with no explicit tier resolves to `as-owner` (the default), so this field is always populated. agent-session-api persists it onto the session and stamps it onto `ExecutionContext.reachTier` so authorization-api applies the tier constraint inside the verdict. */
+    reachTier: AgentReachTier;
+    /** The resolved agent's declared default session lifecycle (`ephemeral`|`persistent`), or null when it declares no preference. agent-session-api inherits this as the session `lifecyclePolicy` unless the launch passes an explicit override; null ⇒ agent-session applies its own `ephemeral` default last. */
+    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 []). */
+    abilities: string[];
     /** Resolved workspace-layout config — present when the source composition declared a workspace block. The `${input.x}` interpolation in env values is already resolved here. The workspace pipeline projects this onto the run's WorkspaceSpec. */
     workspace?: AgentWorkspaceDto;
 }

package/dist/models/resolvedConfigSnapshotResponseDto.d.ts

@@ -16,11 +16,6 @@ export interface ResolvedConfigSnapshotResponseDto {
     resolvedConfigHash: string;
     /** Agent slug captured by this snapshot. */
     agentSlug: string;
-    /**
-       * Phase key captured by this snapshot.
-       * @nullable
-       */
-    stageKey?: string | null;
     /**
        * External payload object key when the snapshot is offloaded from the database.
        * @nullable

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/toolProfileResponseDto.d.ts

@@ -29,8 +29,6 @@ export interface ToolProfileResponseDto {
        */
     forkedFrom?: string | null;
     agentSlug: string;
-    /** @nullable */
-    stageKey?: string | null;
     mcpServiceKey: string;
     toolGroups: string[];
     allowedTools: string[];

package/dist/models/{agentDefinitionResponseDtoDefinitionHash.d.ts → unresolvedToolDto.d.ts}

@@ -5,6 +5,8 @@
  * Central registry for LLM providers, models, and per-project model configuration
  * OpenAPI spec version: 0.1.0
  */
-export type AgentDefinitionResponseDtoDefinitionHash = {
-    [key: string]: unknown;
-};
+export interface UnresolvedToolDto {
+    providerKind: string;
+    resourceId: string;
+    toolName?: string;
+}

package/dist/models/updateAgentDto.d.ts

@@ -7,7 +7,12 @@
  */
 import type { AgentCapabilityLayerDto } from './agentCapabilityLayerDto.js';
 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;
     description?: string;
@@ -15,4 +20,16 @@ export interface UpdateAgentDto {
     capability?: AgentCapabilityLayerDto;
     /** Authored workspace-layout config — persist-paths + per-slot overrides, env vars, output surface. */
     workspace?: AgentWorkspaceDto;
+    /** The agent's permission ceiling. Omitted leaves the stored value unchanged; a NULL stored value reads as `as-owner`. */
+    reachTier?: AgentReachTier;
+    /** The agent's default session lifecycle (`ephemeral`|`persistent`). Omitted leaves the stored value unchanged; a NULL stored value means the agent declares no preference. */
+    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[];
 }