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

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.
@@ -3,13 +3,13 @@
3
3
  * LLM Registry API
4
4
  * OpenAPI spec version: 0.1.3
5
5
  */
6
- import type { AgentBundleRenderDtoAgentMode } from './agentBundleRenderDtoAgentMode.js';
6
+ import type { AgentExecutionMode } from './agentExecutionMode.js';
7
7
  import type { PromptMergeMode } from './promptMergeMode.js';
8
8
  export interface AgentBundleRenderDto {
9
9
  /** Phase key for scope-aware resolution. Optional: absent ⇒ stage-neutral resolution — interactive sessions (e.g. design-system-builder) have no pipeline stage. Currently advisory; the bundle handler resolves by org → project → biome → system precedence and does not branch on stage, so omitting it is valid. */
10
10
  stageKey?: string;
11
11
  /** Whether this agent is the root primary or a delegated subagent */
12
- agentMode: AgentBundleRenderDtoAgentMode;
12
+ agentMode: AgentExecutionMode;
13
13
  /** Per-composition-node instructions resolved from the AgentNode. Combined with the base agent prompt per `promptMode`. Absent → the base agent prompt renders verbatim. */
14
14
  instructions?: string;
15
15
  /** 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. */
@@ -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 type AgentExecutionMode = typeof AgentExecutionMode[keyof typeof AgentExecutionMode];
7
+ export declare const AgentExecutionMode: {
8
+ readonly primary: "primary";
9
+ readonly subagent: "subagent";
10
+ };
@@ -5,8 +5,8 @@
5
5
  * OpenAPI spec version: 0.1.3
6
6
  */
7
7
  Object.defineProperty(exports, "__esModule", { value: true });
8
- exports.AgentBundleRenderDtoAgentMode = void 0;
9
- exports.AgentBundleRenderDtoAgentMode = {
8
+ exports.AgentExecutionMode = void 0;
9
+ exports.AgentExecutionMode = {
10
10
  primary: 'primary',
11
11
  subagent: 'subagent',
12
12
  };
@@ -3,6 +3,7 @@
3
3
  * LLM Registry API
4
4
  * OpenAPI spec version: 0.1.3
5
5
  */
6
+ import type { AgentExecutionMode } from './agentExecutionMode.js';
6
7
  import type { AgentKernelResponseDtoDefinitionHash } from './agentKernelResponseDtoDefinitionHash.js';
7
8
  import type { AgentKernelResponseDtoModelClass } from './agentKernelResponseDtoModelClass.js';
8
9
  import type { AgentWorkspaceDto } from './agentWorkspaceDto.js';
@@ -53,7 +54,7 @@ export interface AgentKernelResponseDto {
53
54
  avatarSeed?: string | null;
54
55
  avatarStyle: string;
55
56
  skills: string[];
56
- executionMode: string;
57
+ executionMode: AgentExecutionMode;
57
58
  supportsAgentSessions: boolean;
58
59
  /** Hidden from user-facing pickers. Stays invocable via `task` delegation and workflow `agentRef:`. */
59
60
  hidden: boolean;
@@ -24,6 +24,11 @@ export interface AgentNodeDto {
24
24
  tools: AgentToolRefDto[];
25
25
  modelOverride?: AgentModelOverrideDto;
26
26
  biomeAvailability?: AgentBiomeAvailabilityDto;
27
+ /**
28
+ * Server-stamped, resolve-only: SHA-256 of the ACTIVE revision of the agent this node references. Rejected on write.
29
+ * @pattern ^[a-f0-9]{64}$
30
+ */
31
+ agentContentHash?: string;
27
32
  /** Sub-agents — recursive composition nodes. */
28
33
  children: AgentNodeDto[];
29
34
  }
@@ -3,6 +3,7 @@
3
3
  * LLM Registry API
4
4
  * OpenAPI spec version: 0.1.3
5
5
  */
6
+ import type { AgentExecutionMode } from './agentExecutionMode.js';
6
7
  import type { AgentProfileDtoAvatarSeed } from './agentProfileDtoAvatarSeed.js';
7
8
  import type { AgentProfileDtoDescription } from './agentProfileDtoDescription.js';
8
9
  import type { AgentProfileDtoModelClass } from './agentProfileDtoModelClass.js';
@@ -18,7 +19,7 @@ export interface AgentProfileDto {
18
19
  isActive: boolean;
19
20
  identityVersion: number;
20
21
  /** Role hint resolved from the agent's source manifest `mode:` frontmatter. `primary` agents lead a session; `subagent` agents are designed to be invoked via a primary's `task` tool. The distinction is a UI hint — any agent may be bound in either role at session/step time. */
21
- executionMode: string;
22
+ executionMode: AgentExecutionMode;
22
23
  /** Scope tier the row lives in. `system` rows ship with the platform; `biome` rows are contributed by an installed biome and grouped by `biomeId`; `org` rows are authored in the org; `project` rows are scoped to a single project. */
23
24
  source: string;
24
25
  /**
@@ -4,7 +4,6 @@ export * from './agentAuthoringResponseDtoDataEnvelope';
4
4
  export * from './agentAuthoringResponseDtoState';
5
5
  export * from './agentBiomeAvailabilityDto';
6
6
  export * from './agentBundleRenderDto';
7
- export * from './agentBundleRenderDtoAgentMode';
8
7
  export * from './agentCapabilityAnalysisDto';
9
8
  export * from './agentCapabilityAnalysisDtoDataEnvelope';
10
9
  export * from './agentCapabilityLayerDto';
@@ -20,6 +19,7 @@ export * from './agentConfigBlocksResponseDto';
20
19
  export * from './agentConfigBlocksResponseDtoDataEnvelope';
21
20
  export * from './agentCredentialDto';
22
21
  export * from './agentEnvVarDto';
22
+ export * from './agentExecutionMode';
23
23
  export * from './agentKernelControllerBrowseTalentPoolParams';
24
24
  export * from './agentKernelControllerListDefinitionsParams';
25
25
  export * from './agentKernelControllerListInteractiveCatalogParams';
@@ -258,6 +258,7 @@ export * from './renderedMountPlanDto';
258
258
  export * from './rescopeDto';
259
259
  export * from './resolveFullResponseDto';
260
260
  export * from './resolveFullResponseDtoDataEnvelope';
261
+ export * from './resolveFullResponseDtoIntrinsicSubAgentPins';
261
262
  export * from './resolveFullResponseDtoModelClass';
262
263
  export * from './resolvedAgentKernelResponseDto';
263
264
  export * from './resolvedAgentKernelResponseDtoDataEnvelope';
@@ -21,7 +21,6 @@ __exportStar(require("./agentAuthoringResponseDtoDataEnvelope"), exports);
21
21
  __exportStar(require("./agentAuthoringResponseDtoState"), exports);
22
22
  __exportStar(require("./agentBiomeAvailabilityDto"), exports);
23
23
  __exportStar(require("./agentBundleRenderDto"), exports);
24
- __exportStar(require("./agentBundleRenderDtoAgentMode"), exports);
25
24
  __exportStar(require("./agentCapabilityAnalysisDto"), exports);
26
25
  __exportStar(require("./agentCapabilityAnalysisDtoDataEnvelope"), exports);
27
26
  __exportStar(require("./agentCapabilityLayerDto"), exports);
@@ -37,6 +36,7 @@ __exportStar(require("./agentConfigBlocksResponseDto"), exports);
37
36
  __exportStar(require("./agentConfigBlocksResponseDtoDataEnvelope"), exports);
38
37
  __exportStar(require("./agentCredentialDto"), exports);
39
38
  __exportStar(require("./agentEnvVarDto"), exports);
39
+ __exportStar(require("./agentExecutionMode"), exports);
40
40
  __exportStar(require("./agentKernelControllerBrowseTalentPoolParams"), exports);
41
41
  __exportStar(require("./agentKernelControllerListDefinitionsParams"), exports);
42
42
  __exportStar(require("./agentKernelControllerListInteractiveCatalogParams"), exports);
@@ -275,6 +275,7 @@ __exportStar(require("./renderedMountPlanDto"), exports);
275
275
  __exportStar(require("./rescopeDto"), exports);
276
276
  __exportStar(require("./resolveFullResponseDto"), exports);
277
277
  __exportStar(require("./resolveFullResponseDtoDataEnvelope"), exports);
278
+ __exportStar(require("./resolveFullResponseDtoIntrinsicSubAgentPins"), exports);
278
279
  __exportStar(require("./resolveFullResponseDtoModelClass"), exports);
279
280
  __exportStar(require("./resolvedAgentKernelResponseDto"), exports);
280
281
  __exportStar(require("./resolvedAgentKernelResponseDtoDataEnvelope"), exports);
@@ -3,10 +3,12 @@
3
3
  * LLM Registry API
4
4
  * OpenAPI spec version: 0.1.3
5
5
  */
6
+ import type { AgentExecutionMode } from './agentExecutionMode.js';
6
7
  import type { ResolvedAgentToolProfileDto } from './resolvedAgentToolProfileDto.js';
7
8
  import type { ResolvedModelSelectionDto } from './resolvedModelSelectionDto.js';
8
9
  import type { ResolvedModelStubDto } from './resolvedModelStubDto.js';
9
10
  import type { ResolvedSkillEntryDto } from './resolvedSkillEntryDto.js';
11
+ import type { ResolveFullResponseDtoIntrinsicSubAgentPins } from './resolveFullResponseDtoIntrinsicSubAgentPins.js';
10
12
  import type { ResolveFullResponseDtoModelClass } from './resolveFullResponseDtoModelClass.js';
11
13
  export interface ResolveFullResponseDto {
12
14
  /** Agent definition slug. */
@@ -19,7 +21,7 @@ export interface ResolveFullResponseDto {
19
21
  */
20
22
  description?: string | null;
21
23
  /** Execution mode (primary, subagent). */
22
- executionMode: string;
24
+ executionMode: AgentExecutionMode;
23
25
  /** LLM-routing tier. Distinct from AgentRunRole (permissions). */
24
26
  modelClass: ResolveFullResponseDtoModelClass;
25
27
  /** Merged system prompt (base + project override append). */
@@ -29,11 +31,6 @@ export interface ResolveFullResponseDto {
29
31
  * @nullable
30
32
  */
31
33
  temperature?: number | null;
32
- /**
33
- * AGENTS.md default content.
34
- * @nullable
35
- */
36
- agentsmdDefault?: string | null;
37
34
  /** Merged tool profiles. */
38
35
  toolProfiles: ResolvedAgentToolProfileDto[];
39
36
  /** Skills resolved (system-wide + base + pinned). */
@@ -50,6 +47,8 @@ export interface ResolveFullResponseDto {
50
47
  resolvedConfigHash: string;
51
48
  /** Sub-agent slugs the primary may delegate to (parsed from its source manifest's `permission.task` map). These are intrinsic to the agent's design and form the FLOOR of the runtime sub-agent set — workspace/session/step bindings layer on top but never remove from this list. */
52
49
  intrinsicSubAgents: string[];
50
+ /** Definition PIN per intrinsic sub-agent slug: the content address of the agent definition that slug resolves to in this org/project scope, folded over its `extends` chain — the same value the resolver stamps as `AgentNodeDto.agentContentHash`. It reaches the warm-pool static template fingerprint, so editing an intrinsic delegate's prompt retires the pods primed against the previous one instead of serving it silently for the whole idle TTL. A slug with no active definition in scope is ABSENT from the map rather than carrying a substituted value: absent is the pre-pin identity, and an invented one would name a definition that does not exist. */
51
+ intrinsicSubAgentPins: ResolveFullResponseDtoIntrinsicSubAgentPins;
53
52
  /** Built-in OpenCode tool keys the agent may invoke directly (parsed from its source manifest's `permission.<toolKey>` map, excluding `task`). Tools like `edit` / `write` / `read` / `bash` / `glob` / `grep` / `webfetch` / `question`. Separate from `toolProfiles` which carries the MCP-served catalog bindings. */
54
53
  intrinsicTools: string[];
55
54
  /** Full LLM routing record (modelId + providerSlug + opencodeProviderId + temperature + contextWindow). Carries the same data as `model` plus the worker-side `opencodeProviderId`. Decoupled from `structuralConfigHash` on purpose. */
@@ -0,0 +1,11 @@
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
+ * Definition PIN per intrinsic sub-agent slug: the content address of the agent definition that slug resolves to in this org/project scope, folded over its `extends` chain — the same value the resolver stamps as `AgentNodeDto.agentContentHash`. It reaches the warm-pool static template fingerprint, so editing an intrinsic delegate's prompt retires the pods primed against the previous one instead of serving it silently for the whole idle TTL. A slug with no active definition in scope is ABSENT from the map rather than carrying a substituted value: absent is the pre-pin identity, and an invented one would name a definition that does not exist.
8
+ */
9
+ export type ResolveFullResponseDtoIntrinsicSubAgentPins = {
10
+ [key: string]: string;
11
+ };
@@ -0,0 +1,7 @@
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 });
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@xemahq/llm-registry-api-client",
3
- "version": "0.7.2",
3
+ "version": "0.7.7",
4
4
  "main": "./dist/index.js",
5
5
  "types": "./dist/index.d.ts",
6
6
  "files": [
@@ -19,7 +19,7 @@
19
19
  "service": "llm-registry-api",
20
20
  "biome": "agent-runtime",
21
21
  "target": "server",
22
- "generator": "@xemahq/api-client-generator@0.5.0",
22
+ "generator": "@xemahq/api-client-generator@0.12.0",
23
23
  "source": "openapi.public.json"
24
24
  },
25
25
  "license": "LicenseRef-Xema-BSL-1.1",
@@ -1,13 +0,0 @@
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
- * Whether this agent is the root primary or a delegated subagent
8
- */
9
- export type AgentBundleRenderDtoAgentMode = typeof AgentBundleRenderDtoAgentMode[keyof typeof AgentBundleRenderDtoAgentMode];
10
- export declare const AgentBundleRenderDtoAgentMode: {
11
- readonly primary: "primary";
12
- readonly subagent: "subagent";
13
- };