@xemahq/llm-registry-api-client 0.7.29 → 0.8.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (104) hide show
  1. package/dist/endpoints/llm-registry/llm-registry.d.ts +4 -4
  2. package/dist/endpoints/llm-registry/llm-registry.js +11 -28
  3. package/dist/endpoints/work-kinds/work-kinds.d.ts +11 -0
  4. package/dist/endpoints/work-kinds/work-kinds.js +37 -0
  5. package/dist/index.d.ts +1 -0
  6. package/dist/index.js +1 -0
  7. package/dist/models/agentCapabilityLayerDto.d.ts +1 -1
  8. package/dist/models/agentKernelResponseDto.d.ts +5 -0
  9. package/dist/models/agentKernelResponseDtoDefinitionHash.d.ts +4 -1
  10. package/dist/models/agentModelOverrideDto.d.ts +5 -2
  11. package/dist/models/agentNodeDto.d.ts +7 -0
  12. package/dist/models/agentProfileDto.d.ts +2 -0
  13. package/dist/models/agentProfileDtoAvatarSeed.d.ts +4 -1
  14. package/dist/models/agentProfileDtoDescription.d.ts +4 -1
  15. package/dist/models/agentWorkingFileDto.d.ts +3 -0
  16. package/dist/models/bundleFileResponseDto.d.ts +8 -2
  17. package/dist/models/bundleFileResponseDtoBiomeId.d.ts +2 -1
  18. package/dist/models/bundleFileResponseDtoForkedFrom.d.ts +2 -1
  19. package/dist/models/createAgentDto.d.ts +4 -1
  20. package/dist/models/createModelDto.d.ts +4 -1
  21. package/dist/models/createModelResolutionRuleDto.d.ts +12 -4
  22. package/dist/models/createModelStrategyEntryDto.d.ts +9 -3
  23. package/dist/models/createProviderDto.d.ts +4 -1
  24. package/dist/models/index.d.ts +10 -17
  25. package/dist/models/index.js +10 -17
  26. package/dist/models/inputArtifactEntryDto.d.ts +2 -0
  27. package/dist/models/migrationHeartbeatDto.d.ts +8 -2
  28. package/dist/models/migrationProvisionDto.d.ts +4 -1
  29. package/dist/models/modelCapability.d.ts +17 -0
  30. package/dist/models/{llmRegistryControllerResolveForInvocationPurpose.js → modelCapability.js} +7 -4
  31. package/dist/models/modelClass.d.ts +17 -0
  32. package/dist/models/{resolvedModelRefDtoModelClass.js → modelClass.js} +3 -2
  33. package/dist/models/modelResolutionRuleResponseDto.d.ts +10 -5
  34. package/dist/models/modelResolutionSelectorDto.d.ts +5 -3
  35. package/dist/models/modelResolutionSelectorResponseDto.d.ts +1 -2
  36. package/dist/models/modelResponseDto.d.ts +1 -0
  37. package/dist/models/modelResponseDtoContextWindow.d.ts +4 -1
  38. package/dist/models/modelStrategyEntryResponseDto.d.ts +5 -0
  39. package/dist/models/mountEntryDto.d.ts +1 -0
  40. package/dist/models/moveRevisionPinsDto.d.ts +8 -2
  41. package/dist/models/problemDetailsDto.d.ts +24 -0
  42. package/dist/models/problemFieldIssueDto.d.ts +10 -0
  43. package/dist/models/projectAgentOverrideResponseDto.d.ts +2 -0
  44. package/dist/models/projectAgentOverrideResponseDtoSystemPromptAppend.d.ts +4 -1
  45. package/dist/models/projectAgentOverrideResponseDtoTemperature.d.ts +4 -1
  46. package/dist/models/publishAgentRevisionDto.d.ts +5 -1
  47. package/dist/models/renderAgentRunContextRequestDto.d.ts +1 -0
  48. package/dist/models/resolveModelForInvocationDto.d.ts +55 -0
  49. package/dist/models/resolvedModelRefDto.d.ts +4 -3
  50. package/dist/models/resolvedPhaseConfigDto.d.ts +5 -0
  51. package/dist/models/resolvedStageModelConfigDto.d.ts +5 -0
  52. package/dist/models/resolvedToolProfileDto.d.ts +2 -0
  53. package/dist/models/resolvedToolProfileDtoCatalogId.d.ts +4 -1
  54. package/dist/models/restoreAgentRevisionDto.d.ts +4 -1
  55. package/dist/models/roleCapabilityProfileDto.d.ts +0 -2
  56. package/dist/models/rollbackAgentRevisionDto.d.ts +4 -1
  57. package/dist/models/strategyTemplateEntryDto.d.ts +5 -0
  58. package/dist/models/toolProfileResponseDto.d.ts +6 -0
  59. package/dist/models/updateAgentDraftDto.d.ts +4 -1
  60. package/dist/models/updateModelDto.d.ts +4 -1
  61. package/dist/models/updateModelResolutionRuleDto.d.ts +7 -2
  62. package/dist/models/updateProviderDto.d.ts +1 -0
  63. package/dist/models/upsertAgentModelOverrideDto.d.ts +5 -1
  64. package/dist/models/workKindAxis.d.ts +13 -0
  65. package/dist/models/workKindAxis.js +12 -0
  66. package/dist/models/workKindControllerListParams.d.ts +12 -0
  67. package/dist/models/workKindDto.d.ts +19 -0
  68. package/dist/models/{errorDetailsDtoDetails.d.ts → workKindListDto.d.ts} +4 -6
  69. package/dist/models/workKindListDto.js +2 -0
  70. package/dist/models/workKindListDtoDataEnvelope.d.ts +9 -0
  71. package/dist/models/workKindListDtoDataEnvelope.js +2 -0
  72. package/dist/models/workingFileEntryDto.d.ts +5 -0
  73. package/package.json +26 -2
  74. package/dist/models/agentModelOverrideDtoModelClass.d.ts +0 -13
  75. package/dist/models/agentModelOverrideDtoModelClass.js +0 -15
  76. package/dist/models/createModelResolutionRuleDtoTargetModelClass.d.ts +0 -16
  77. package/dist/models/createModelResolutionRuleDtoTargetModelClass.js +0 -15
  78. package/dist/models/createModelStrategyEntryDtoModelClass.d.ts +0 -13
  79. package/dist/models/createModelStrategyEntryDtoModelClass.js +0 -15
  80. package/dist/models/errorDetailsDto.d.ts +0 -10
  81. package/dist/models/errorPayloadDto.d.ts +0 -11
  82. package/dist/models/errorResponseDto.d.ts +0 -9
  83. package/dist/models/llmRegistryControllerResolveForInvocationModelClass.d.ts +0 -14
  84. package/dist/models/llmRegistryControllerResolveForInvocationModelClass.js +0 -16
  85. package/dist/models/llmRegistryControllerResolveForInvocationParams.d.ts +0 -34
  86. package/dist/models/llmRegistryControllerResolveForInvocationPreferredModelClass.d.ts +0 -14
  87. package/dist/models/llmRegistryControllerResolveForInvocationPreferredModelClass.js +0 -16
  88. package/dist/models/llmRegistryControllerResolveForInvocationPurpose.d.ts +0 -11
  89. package/dist/models/modelResolutionRuleResponseDtoDefaultTargetOverridePrevModelClass.d.ts +0 -17
  90. package/dist/models/modelResolutionRuleResponseDtoDefaultTargetOverridePrevModelClass.js +0 -15
  91. package/dist/models/modelResolutionRuleResponseDtoTargetModelClass.d.ts +0 -16
  92. package/dist/models/modelResolutionRuleResponseDtoTargetModelClass.js +0 -15
  93. package/dist/models/modelResolutionSelectorDtoModelClass.d.ts +0 -16
  94. package/dist/models/modelResolutionSelectorDtoModelClass.js +0 -15
  95. package/dist/models/modelResolutionSelectorResponseDtoModelClass.d.ts +0 -16
  96. package/dist/models/modelResolutionSelectorResponseDtoModelClass.js +0 -15
  97. package/dist/models/resolvedModelRefDtoModelClass.d.ts +0 -17
  98. package/dist/models/updateModelResolutionRuleDtoTargetModelClass.d.ts +0 -13
  99. package/dist/models/updateModelResolutionRuleDtoTargetModelClass.js +0 -15
  100. /package/dist/models/{errorDetailsDto.js → problemDetailsDto.js} +0 -0
  101. /package/dist/models/{errorDetailsDtoDetails.js → problemFieldIssueDto.js} +0 -0
  102. /package/dist/models/{errorPayloadDto.js → resolveModelForInvocationDto.js} +0 -0
  103. /package/dist/models/{errorResponseDto.js → workKindControllerListParams.js} +0 -0
  104. /package/dist/models/{llmRegistryControllerResolveForInvocationParams.js → workKindDto.js} +0 -0
@@ -4,8 +4,10 @@
4
4
  * OpenAPI spec version: 0.1.3
5
5
  */
6
6
  export interface InputArtifactEntryDto {
7
+ /** @minLength 1 */
7
8
  path: string;
8
9
  contentType?: string;
10
+ /** @minLength 1 */
9
11
  sourceArtifactId: string;
10
12
  sourceVersion: number;
11
13
  }
@@ -9,8 +9,14 @@ export interface MigrationHeartbeatDto {
9
9
  consumer: MigrationHeartbeatDtoConsumer;
10
10
  /** Last source row id processed. */
11
11
  lastProcessedId: string;
12
- /** Number of new items processed since the last heartbeat. */
12
+ /**
13
+ * Number of new items processed since the last heartbeat.
14
+ * @minimum 0
15
+ */
13
16
  processedDelta: number;
14
- /** Number of items that failed since the last heartbeat. */
17
+ /**
18
+ * Number of items that failed since the last heartbeat.
19
+ * @minimum 0
20
+ */
15
21
  failedDelta?: number;
16
22
  }
@@ -7,7 +7,10 @@ import type { MigrationProvisionDtoConsumer } from './migrationProvisionDtoConsu
7
7
  export interface MigrationProvisionDto {
8
8
  /** Which consumer is provisioning. */
9
9
  consumer: MigrationProvisionDtoConsumer;
10
- /** Total source items the consumer plans to process. */
10
+ /**
11
+ * Total source items the consumer plans to process.
12
+ * @minimum 0
13
+ */
11
14
  totalItems: number;
12
15
  /** High-water-mark cursor snapshot taken at provision time. */
13
16
  sourceCursor: string;
@@ -0,0 +1,17 @@
1
+ /**
2
+ * Generated by @xemahq/api-client-generator — do not edit manually.
3
+ * LLM Registry API
4
+ * OpenAPI spec version: 0.1.3
5
+ */
6
+ /**
7
+ * A modality this invocation REQUIRES — the Matrix `modelCapability` dimension, so one rule can route every vision-needing invocation to a multimodal model without pinning a provider. Closed kernel set; an unknown value is a 400.
8
+ */
9
+ export type ModelCapability = typeof ModelCapability[keyof typeof ModelCapability];
10
+ export declare const ModelCapability: {
11
+ readonly vision: "vision";
12
+ readonly long_context: "long_context";
13
+ readonly reasoning: "reasoning";
14
+ readonly function_calling: "function_calling";
15
+ readonly audio: "audio";
16
+ readonly embedding: "embedding";
17
+ };
@@ -5,9 +5,12 @@
5
5
  * OpenAPI spec version: 0.1.3
6
6
  */
7
7
  Object.defineProperty(exports, "__esModule", { value: true });
8
- exports.LlmRegistryControllerResolveForInvocationPurpose = void 0;
9
- exports.LlmRegistryControllerResolveForInvocationPurpose = {
10
- summarization: 'summarization',
8
+ exports.ModelCapability = void 0;
9
+ exports.ModelCapability = {
10
+ vision: 'vision',
11
+ long_context: 'long_context',
12
+ reasoning: 'reasoning',
13
+ function_calling: 'function_calling',
14
+ audio: 'audio',
11
15
  embedding: 'embedding',
12
- reorganization: 'reorganization',
13
16
  };
@@ -0,0 +1,17 @@
1
+ /**
2
+ * Generated by @xemahq/api-client-generator — do not edit manually.
3
+ * LLM Registry API
4
+ * OpenAPI spec version: 0.1.3
5
+ */
6
+ /**
7
+ * Per-session "smartness" preference — the Matrix `modelClass` MATCHED dimension, NOT an above-rules override. It populates the resolution context so a tier-injected managed rule can CLAMP it, and an unmapped class falls through to the org default rule. Ignored when an explicit `modelClass`/`modelId` override is present.
8
+ */
9
+ export type ModelClass = typeof ModelClass[keyof typeof ModelClass];
10
+ export declare const ModelClass: {
11
+ readonly generic: "generic";
12
+ readonly coding: "coding";
13
+ readonly review: "review";
14
+ readonly creative: "creative";
15
+ readonly planning: "planning";
16
+ readonly utility: "utility";
17
+ };
@@ -5,8 +5,9 @@
5
5
  * OpenAPI spec version: 0.1.3
6
6
  */
7
7
  Object.defineProperty(exports, "__esModule", { value: true });
8
- exports.ResolvedModelRefDtoModelClass = void 0;
9
- exports.ResolvedModelRefDtoModelClass = {
8
+ exports.ModelClass = void 0;
9
+ exports.ModelClass = {
10
+ generic: 'generic',
10
11
  coding: 'coding',
11
12
  review: 'review',
12
13
  creative: 'creative',
@@ -3,10 +3,8 @@
3
3
  * LLM Registry API
4
4
  * OpenAPI spec version: 0.1.3
5
5
  */
6
- import type { ModelResolutionRuleResponseDtoDefaultTargetOverridePrevModelClass } from './modelResolutionRuleResponseDtoDefaultTargetOverridePrevModelClass.js';
7
6
  import type { ModelResolutionRuleResponseDtoDefaultTargetOverridePrevTargetKind } from './modelResolutionRuleResponseDtoDefaultTargetOverridePrevTargetKind.js';
8
7
  import type { ModelResolutionRuleResponseDtoTargetKind } from './modelResolutionRuleResponseDtoTargetKind.js';
9
- import type { ModelResolutionRuleResponseDtoTargetModelClass } from './modelResolutionRuleResponseDtoTargetModelClass.js';
10
8
  import type { ModelResolutionSelectorResponseDto } from './modelResolutionSelectorResponseDto.js';
11
9
  export interface ModelResolutionRuleResponseDto {
12
10
  id: string;
@@ -18,9 +16,11 @@ export interface ModelResolutionRuleResponseDto {
18
16
  /** @nullable */
19
17
  targetProviderSlug?: string | null;
20
18
  /** @nullable */
21
- targetModelClass?: ModelResolutionRuleResponseDtoTargetModelClass;
19
+ targetModelClass?: string | null;
22
20
  /** @nullable */
23
21
  targetTemperature?: number | null;
22
+ /** @nullable */
23
+ targetReasoningEffort?: string | null;
24
24
  priority: number;
25
25
  isDefault: boolean;
26
26
  /**
@@ -59,15 +59,20 @@ export interface ModelResolutionRuleResponseDto {
59
59
  */
60
60
  defaultTargetOverridePrevProviderSlug?: string | null;
61
61
  /**
62
- * 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.
62
+ * SEAM #2: the work kind the default rule had before the first override. NULL when no override is active or the prior default was not a strategy ref.
63
63
  * @nullable
64
64
  */
65
- defaultTargetOverridePrevModelClass?: ModelResolutionRuleResponseDtoDefaultTargetOverridePrevModelClass;
65
+ defaultTargetOverridePrevModelClass?: string | null;
66
66
  /**
67
67
  * SEAM #2: the temperature the default rule carried before the first override. NULL when no override is active or none was set.
68
68
  * @nullable
69
69
  */
70
70
  defaultTargetOverridePrevTemperature?: number | null;
71
+ /**
72
+ * SEAM #2: the reasoning effort the default rule carried before the first override. NULL when no override is active or none was set.
73
+ * @nullable
74
+ */
75
+ defaultTargetOverridePrevReasoningEffort?: string | null;
71
76
  createdBy: string;
72
77
  createdAt: string;
73
78
  updatedAt: string;
@@ -5,7 +5,6 @@
5
5
  */
6
6
  import type { ModelResolutionSelectorDtoExtra } from './modelResolutionSelectorDtoExtra.js';
7
7
  import type { ModelResolutionSelectorDtoModelCapability } from './modelResolutionSelectorDtoModelCapability.js';
8
- import type { ModelResolutionSelectorDtoModelClass } from './modelResolutionSelectorDtoModelClass.js';
9
8
  export interface ModelResolutionSelectorDto {
10
9
  /** Match when the resolving agent slug equals this value. */
11
10
  agent?: string;
@@ -17,8 +16,11 @@ export interface ModelResolutionSelectorDto {
17
16
  stage?: string;
18
17
  /** 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). */
19
18
  purpose?: string;
20
- /** 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). */
21
- modelClass?: ModelResolutionSelectorDtoModelClass;
19
+ /**
20
+ * Match when the resolving agent's work kind equals this value (the `modelClass` dimension — one rule routes e.g. every `review`-kind agent). OPEN vocabulary: the kernel core is generic | coding | review | creative | planning | utility, plus any key a biome or this org has declared. Checked against the org's visible set on write.
21
+ * @pattern ^[a-z][a-z0-9-]{0,62}$
22
+ */
23
+ modelClass?: string;
22
24
  /** 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). */
23
25
  modelCapability?: ModelResolutionSelectorDtoModelCapability;
24
26
  /** Forward-compat bag of additional registry dimensions → required literal. Omit / {} when only structured dimensions are used. */
@@ -5,7 +5,6 @@
5
5
  */
6
6
  import type { ModelResolutionSelectorResponseDtoExtra } from './modelResolutionSelectorResponseDtoExtra.js';
7
7
  import type { ModelResolutionSelectorResponseDtoModelCapability } from './modelResolutionSelectorResponseDtoModelCapability.js';
8
- import type { ModelResolutionSelectorResponseDtoModelClass } from './modelResolutionSelectorResponseDtoModelClass.js';
9
8
  export interface ModelResolutionSelectorResponseDto {
10
9
  /** @nullable */
11
10
  agent?: string | null;
@@ -18,7 +17,7 @@ export interface ModelResolutionSelectorResponseDto {
18
17
  /** @nullable */
19
18
  purpose?: string | null;
20
19
  /** @nullable */
21
- modelClass?: ModelResolutionSelectorResponseDtoModelClass;
20
+ modelClass?: string | null;
22
21
  /** @nullable */
23
22
  modelCapability?: ModelResolutionSelectorResponseDtoModelCapability;
24
23
  /** Additional registry dimensions. `{}` when none. */
@@ -12,6 +12,7 @@ export interface ModelResponseDto {
12
12
  providerId: string;
13
13
  modelId: string;
14
14
  displayName: string;
15
+ /** @nullable */
15
16
  contextWindow?: ModelResponseDtoContextWindow;
16
17
  /**
17
18
  * Max generation/output tokens. Distinct from contextWindow (the input budget). Null when no authoritative source declares one.
@@ -3,6 +3,9 @@
3
3
  * LLM Registry API
4
4
  * OpenAPI spec version: 0.1.3
5
5
  */
6
+ /**
7
+ * @nullable
8
+ */
6
9
  export type ModelResponseDtoContextWindow = {
7
10
  [key: string]: unknown;
8
- };
11
+ } | null;
@@ -16,6 +16,11 @@ export interface ModelStrategyEntryResponseDto {
16
16
  * @nullable
17
17
  */
18
18
  temperature?: number | null;
19
+ /**
20
+ * Reasoning effort the entry asks of the model (kernel `ModelOptions.reasoningEffort`). `null` defers to the engine/model default.
21
+ * @nullable
22
+ */
23
+ reasoningEffort?: string | null;
19
24
  createdAt: string;
20
25
  updatedAt: string;
21
26
  }
@@ -5,6 +5,7 @@
5
5
  */
6
6
  import type { MountEntryDtoMode } from './mountEntryDtoMode.js';
7
7
  export interface MountEntryDto {
8
+ /** @minLength 1 */
8
9
  mount: string;
9
10
  mode: MountEntryDtoMode;
10
11
  /** Source URI the activity resolves at mount time. Schemes: `artifact-store://`, `deliverable-spec://`, `scm://`, `literal://`. Omitted when the renderer only needs `(mount, mode)` (e.g. compose-time mount-plan summarization). */
@@ -4,8 +4,14 @@
4
4
  * OpenAPI spec version: 0.1.3
5
5
  */
6
6
  export interface MoveRevisionPinsDto {
7
- /** The revision pins are currently held on. */
7
+ /**
8
+ * The revision pins are currently held on.
9
+ * @minLength 1
10
+ */
8
11
  fromRevisionId: string;
9
- /** The revision movable pins should point at. */
12
+ /**
13
+ * The revision movable pins should point at.
14
+ * @minLength 1
15
+ */
10
16
  toRevisionId: string;
11
17
  }
@@ -0,0 +1,24 @@
1
+ /**
2
+ * Generated by @xemahq/api-client-generator — do not edit manually.
3
+ * LLM Registry API
4
+ * OpenAPI spec version: 0.1.3
5
+ */
6
+ import type { ProblemFieldIssueDto } from './problemFieldIssueDto.js';
7
+ export interface ProblemDetailsDto {
8
+ /** Absolute URI identifying the refusal TYPE. Derived one-to-one from `code`, so a caller may branch on either and can never be told two different things. Never `about:blank`. */
9
+ type: string;
10
+ /** Short, human-readable, and STABLE for a given `type`. Never per-occurrence — that is `detail`. */
11
+ title: string;
12
+ /** The HTTP status code, repeated in the body so a logged document is self-contained. */
13
+ status: number;
14
+ /** SCREAMING_SNAKE_CASE. The machine-branchable refusal, and the value a policy rule, a retry predicate and a UI branch all name. */
15
+ code: string;
16
+ /** Human-readable and specific to THIS occurrence. */
17
+ detail?: string;
18
+ /** URI reference identifying the occurrence — a request path, a run, a row. */
19
+ instance?: string;
20
+ /** W3C trace-context trace-id, present when the caller sent a `traceparent`. Omitted rather than invented when it did not. */
21
+ traceId?: string;
22
+ /** Field-level issues, when the refusal is about the request body. */
23
+ errors?: ProblemFieldIssueDto[];
24
+ }
@@ -0,0 +1,10 @@
1
+ /**
2
+ * Generated by @xemahq/api-client-generator — do not edit manually.
3
+ * LLM Registry API
4
+ * OpenAPI spec version: 0.1.3
5
+ */
6
+ export interface ProblemFieldIssueDto {
7
+ /** RFC 6901 JSON Pointer into the request body. Root is "/". */
8
+ pointer: string;
9
+ detail: string;
10
+ }
@@ -16,7 +16,9 @@ export interface ProjectAgentOverrideResponseDto {
16
16
  * @pattern ^[a-f0-9]{64}$
17
17
  */
18
18
  agentContentHash: string;
19
+ /** @nullable */
19
20
  systemPromptAppend?: ProjectAgentOverrideResponseDtoSystemPromptAppend;
21
+ /** @nullable */
20
22
  temperature?: ProjectAgentOverrideResponseDtoTemperature;
21
23
  mcpServicesAdd: string[];
22
24
  mcpServicesRemove: string[];
@@ -3,6 +3,9 @@
3
3
  * LLM Registry API
4
4
  * OpenAPI spec version: 0.1.3
5
5
  */
6
+ /**
7
+ * @nullable
8
+ */
6
9
  export type ProjectAgentOverrideResponseDtoSystemPromptAppend = {
7
10
  [key: string]: unknown;
8
- };
11
+ } | null;
@@ -3,6 +3,9 @@
3
3
  * LLM Registry API
4
4
  * OpenAPI spec version: 0.1.3
5
5
  */
6
+ /**
7
+ * @nullable
8
+ */
6
9
  export type ProjectAgentOverrideResponseDtoTemperature = {
7
10
  [key: string]: unknown;
8
- };
11
+ } | null;
@@ -4,10 +4,14 @@
4
4
  * OpenAPI spec version: 0.1.3
5
5
  */
6
6
  export interface PublishAgentRevisionDto {
7
- /** Current draft concurrency token. Publication fails if another author changed the draft. */
7
+ /**
8
+ * Current draft concurrency token. Publication fails if another author changed the draft.
9
+ * @minLength 1
10
+ */
8
11
  expectedDraftUpdatedAt: string;
9
12
  /**
10
13
  * Caller-stable key for retry-safe publication of this exact draft.
14
+ * @minLength 1
11
15
  * @maxLength 200
12
16
  */
13
17
  idempotencyKey: string;
@@ -9,6 +9,7 @@ import type { MountEntryDto } from './mountEntryDto.js';
9
9
  import type { RenderAgentRunContextRequestDtoWorkflowInputs } from './renderAgentRunContextRequestDtoWorkflowInputs.js';
10
10
  import type { WorkingFileEntryDto } from './workingFileEntryDto.js';
11
11
  export interface RenderAgentRunContextRequestDto {
12
+ /** @minLength 1 */
12
13
  agentSlug: string;
13
14
  projectId: string;
14
15
  role: AgentRunRole;
@@ -0,0 +1,55 @@
1
+ /**
2
+ * Generated by @xemahq/api-client-generator — do not edit manually.
3
+ * LLM Registry API
4
+ * OpenAPI spec version: 0.1.3
5
+ */
6
+ import type { ModelCapability } from './modelCapability.js';
7
+ import type { ModelClass } from './modelClass.js';
8
+ export interface ResolveModelForInvocationDto {
9
+ /**
10
+ * The Space this invocation happens in, as a canonical `xema://` SpaceRef. `xema://orgs/<orgId>` for an org-scoped invocation (a Canopy turn, a memory summarization, an org-layer session); `xema://orgs/<orgId>/projects/<projectId>` when the invocation genuinely belongs to a project. The org segment MUST match the calling context's org — it selects a Space inside the tenant the token already proved, and never widens it. Only the `project` form contributes the Matrix's `project` dimension; an org-scoped resolve carries no project dimension at all, so a `project` selector rule cannot match it.
11
+ * @minLength 1
12
+ * @maxLength 2048
13
+ */
14
+ space: string;
15
+ /**
16
+ * The Matrix `stage` dimension. A caller with no stage passes its agent slug here; the resolver drops the dimension when the two are equal, so a stage-less call never injects a stage nothing would match.
17
+ * @minLength 1
18
+ * @maxLength 512
19
+ */
20
+ stageKey: string;
21
+ /**
22
+ * The resolving agent — the Matrix `agent` dimension.
23
+ * @maxLength 512
24
+ */
25
+ agentSlug?: string;
26
+ /**
27
+ * ABOVE-RULES strategy-class override. When supplied, resolution routes through the named work kind directly and the Matrix rule evaluation is pre-empted entirely. This is NOT `preferredModelClass`.
28
+ * @maxLength 512
29
+ */
30
+ modelClass?: string;
31
+ /**
32
+ * ABOVE-RULES concrete-model override. Pins this credentialed model and skips the strategy cascade.
33
+ * @maxLength 512
34
+ */
35
+ modelId?: string;
36
+ /**
37
+ * Disambiguates `modelId` when one model id is credentialed under two providers. Optional partner to `modelId`.
38
+ * @maxLength 512
39
+ */
40
+ providerSlug?: string;
41
+ /**
42
+ * Non-agent invocation purpose — the Matrix `purpose` dimension, and the MACHINE half of the contributed work-kind vocabulary. Must be a declared machine-axis work kind (`GET /work-kinds?axis=machine`); an undeclared value is a 400 so a typo never silently lands as the default rule's match path.
43
+ * @maxLength 512
44
+ */
45
+ purpose?: string;
46
+ /** Per-session "smartness" preference — the Matrix `modelClass` MATCHED dimension, NOT an above-rules override. It populates the resolution context so a tier-injected managed rule can CLAMP it, and an unmapped class falls through to the org default rule. Ignored when an explicit `modelClass`/`modelId` override is present. */
47
+ preferredModelClass?: ModelClass;
48
+ /**
49
+ * The active/launched skill — the Matrix `skill` dimension. Free-form: the skill vocabulary is open and owned by `skill-registry-api`, so an unknown value simply matches no rule rather than being refused.
50
+ * @maxLength 512
51
+ */
52
+ skillSlug?: string;
53
+ /** A modality this invocation REQUIRES — the Matrix `modelCapability` dimension, so one rule can route every vision-needing invocation to a multimodal model without pinning a provider. Closed kernel set; an unknown value is a 400. */
54
+ modelCapability?: ModelCapability;
55
+ }
@@ -4,7 +4,6 @@
4
4
  * OpenAPI spec version: 0.1.3
5
5
  */
6
6
  import type { ResolvedModelRefDtoKind } from './resolvedModelRefDtoKind.js';
7
- import type { ResolvedModelRefDtoModelClass } from './resolvedModelRefDtoModelClass.js';
8
7
  export interface ResolvedModelRefDto {
9
8
  kind: ResolvedModelRefDtoKind;
10
9
  /**
@@ -18,10 +17,12 @@ export interface ResolvedModelRefDto {
18
17
  */
19
18
  providerSlug?: string | null;
20
19
  /**
21
- * Strategy routing class (kind=strategy).
20
+ * Work kind this ref routes through (kind=strategy).
22
21
  * @nullable
23
22
  */
24
- modelClass?: ResolvedModelRefDtoModelClass;
23
+ modelClass?: string | null;
25
24
  /** @nullable */
26
25
  temperature?: number | null;
26
+ /** @nullable */
27
+ reasoningEffort?: string | null;
27
28
  }
@@ -17,6 +17,11 @@ export interface ResolvedPhaseConfigDto {
17
17
  * @nullable
18
18
  */
19
19
  temperature?: number | null;
20
+ /**
21
+ * Reasoning effort the resolution path selected, forwarded verbatim to the provider. `null` defers to the model default — never a substituted value.
22
+ * @nullable
23
+ */
24
+ reasoningEffort?: string | null;
20
25
  source: string;
21
26
  /** Model Resolution Matrix win-reason trace — which rule won and why. Null only for the persisted per-agent override path. */
22
27
  decision?: ResolvedModelDecisionDto | null;
@@ -23,6 +23,11 @@ export interface ResolvedStageModelConfigDto {
23
23
  * @nullable
24
24
  */
25
25
  temperature?: number | null;
26
+ /**
27
+ * Reasoning effort this stage currently resolves to. `null` defers to the model default.
28
+ * @nullable
29
+ */
30
+ reasoningEffort?: string | null;
26
31
  /** Which resolution path produced this selection. */
27
32
  source: ModelResolutionSource;
28
33
  /** Model Resolution Matrix win-reason trace — which rule won and why. Null only for the persisted per-agent override path. */
@@ -9,7 +9,9 @@ export interface ResolvedToolProfileDto {
9
9
  mcpServiceKey: string;
10
10
  toolGroups: string[];
11
11
  allowedTools: string[];
12
+ /** @nullable */
12
13
  catalogId?: ResolvedToolProfileDtoCatalogId;
13
14
  isOptional: boolean;
15
+ /** Owner tier that resolved this profile. */
14
16
  source: ScopeSource;
15
17
  }
@@ -3,6 +3,9 @@
3
3
  * LLM Registry API
4
4
  * OpenAPI spec version: 0.1.3
5
5
  */
6
+ /**
7
+ * @nullable
8
+ */
6
9
  export type ResolvedToolProfileDtoCatalogId = {
7
10
  [key: string]: unknown;
8
- };
11
+ } | null;
@@ -4,6 +4,9 @@
4
4
  * OpenAPI spec version: 0.1.3
5
5
  */
6
6
  export interface RestoreAgentRevisionDto {
7
- /** Current draft concurrency token. Restore fails if another author changed the draft. */
7
+ /**
8
+ * Current draft concurrency token. Restore fails if another author changed the draft.
9
+ * @minLength 1
10
+ */
8
11
  expectedDraftUpdatedAt: string;
9
12
  }
@@ -17,6 +17,4 @@ export interface RoleCapabilityProfileDto {
17
17
  mayEditRepos: RoleCapabilityProfileDtoMayEditRepos;
18
18
  /** Knowledge-base write capability */
19
19
  mayWriteKnowledgeBase: boolean;
20
- /** Xema-namespaced tool names this role may call */
21
- allowedXemaTools: string[];
22
20
  }
@@ -4,7 +4,10 @@
4
4
  * OpenAPI spec version: 0.1.3
5
5
  */
6
6
  export interface RollbackAgentRevisionDto {
7
- /** Owner-fenced immutable ReleaseSet whose stable state should be replayed. */
7
+ /**
8
+ * Owner-fenced immutable ReleaseSet whose stable state should be replayed.
9
+ * @minLength 1
10
+ */
8
11
  priorReleaseSetId: string;
9
12
  /** @minimum 1 */
10
13
  expectedChannelVersion: number;
@@ -13,4 +13,9 @@ export interface StrategyTemplateEntryDto {
13
13
  * @nullable
14
14
  */
15
15
  temperature: number | null;
16
+ /**
17
+ * Reasoning effort the entry asks of the model (kernel `ModelOptions.reasoningEffort`), or null to let the engine/model own the default.
18
+ * @nullable
19
+ */
20
+ reasoningEffort: string | null;
16
21
  }
@@ -8,6 +8,12 @@ export interface ToolProfileResponseDto {
8
8
  id: string;
9
9
  /** @nullable */
10
10
  orgId?: string | null;
11
+ /**
12
+ * Owner tier — the kernel's `SpaceKind`, narrowed to the five tiers this
13
+ * registry owns. The wire schema keeps the name `ScopeSource`.
14
+ * Resolution precedence at read time: user > project > org > biome >
15
+ * system.
16
+ */
11
17
  source: ScopeSource;
12
18
  /**
13
19
  * Biome id when source='biome', otherwise null.
@@ -30,6 +30,9 @@ export interface UpdateAgentDraftDto {
30
30
  durableWorkspace?: DurableWorkspaceRefDto | null;
31
31
  /** Special-ability CapabilityRefs granted on top of the reach tier; unioned into the auto-grant manifest. */
32
32
  abilities?: string[];
33
- /** Current draft concurrency token. The update fails on stale writes. */
33
+ /**
34
+ * Current draft concurrency token. The update fails on stale writes.
35
+ * @minLength 1
36
+ */
34
37
  expectedDraftUpdatedAt: string;
35
38
  }
@@ -7,7 +7,10 @@ import type { ModelModality } from './modelModality.js';
7
7
  export interface UpdateModelDto {
8
8
  /** Human-friendly display name */
9
9
  displayName?: string;
10
- /** Context window size in tokens */
10
+ /**
11
+ * Context window size in tokens
12
+ * @minimum 1
13
+ */
11
14
  contextWindow?: number;
12
15
  /** Model capabilities */
13
16
  capabilities?: string[];
@@ -5,13 +5,18 @@
5
5
  */
6
6
  import type { ModelResolutionSelectorDto } from './modelResolutionSelectorDto.js';
7
7
  import type { UpdateModelResolutionRuleDtoTargetKind } from './updateModelResolutionRuleDtoTargetKind.js';
8
- import type { UpdateModelResolutionRuleDtoTargetModelClass } from './updateModelResolutionRuleDtoTargetModelClass.js';
9
8
  export interface UpdateModelResolutionRuleDto {
10
9
  selector?: ModelResolutionSelectorDto;
11
10
  targetKind?: UpdateModelResolutionRuleDtoTargetKind;
12
11
  targetModelId?: string;
13
12
  targetProviderSlug?: string;
14
- targetModelClass?: UpdateModelResolutionRuleDtoTargetModelClass;
13
+ /** @pattern ^[a-z][a-z0-9-]{0,62}$ */
14
+ targetModelClass?: string;
15
+ /**
16
+ * @minimum 0
17
+ * @maximum 2
18
+ */
15
19
  targetTemperature?: number;
20
+ targetReasoningEffort?: string;
16
21
  priority?: number;
17
22
  }
@@ -15,6 +15,7 @@ export interface UpdateProviderDto {
15
15
  isActive?: boolean;
16
16
  /**
17
17
  * Maximum concurrent requests. Set to null to remove the limit.
18
+ * @minimum 1
18
19
  * @nullable
19
20
  */
20
21
  maxConcurrentRequests?: number | null;
@@ -13,6 +13,10 @@ export interface UpsertAgentModelOverrideDto {
13
13
  agentSlug: string;
14
14
  /** LLM model ID to assign to this agent. */
15
15
  modelId: string;
16
- /** Optional temperature override (0.0 - 2.0). */
16
+ /**
17
+ * Optional temperature override (0.0 - 2.0).
18
+ * @minimum 0
19
+ * @maximum 2
20
+ */
17
21
  temperature?: number;
18
22
  }
@@ -0,0 +1,13 @@
1
+ /**
2
+ * Generated by @xemahq/api-client-generator — do not edit manually.
3
+ * LLM Registry API
4
+ * OpenAPI spec version: 0.1.3
5
+ */
6
+ /**
7
+ * Which Matrix dimension this key may select. `agent` — work an agent does, selecting `modelClass`. `machine` — a use the platform or a biome makes of a model on nobody's behalf, selecting `purpose`.
8
+ */
9
+ export type WorkKindAxis = typeof WorkKindAxis[keyof typeof WorkKindAxis];
10
+ export declare const WorkKindAxis: {
11
+ readonly agent: "agent";
12
+ readonly machine: "machine";
13
+ };
@@ -0,0 +1,12 @@
1
+ "use strict";
2
+ /**
3
+ * Generated by @xemahq/api-client-generator — do not edit manually.
4
+ * LLM Registry API
5
+ * OpenAPI spec version: 0.1.3
6
+ */
7
+ Object.defineProperty(exports, "__esModule", { value: true });
8
+ exports.WorkKindAxis = void 0;
9
+ exports.WorkKindAxis = {
10
+ agent: 'agent',
11
+ machine: 'machine',
12
+ };