@xemahq/llm-registry-api-client 0.1.2 → 0.2.0

package/dist/endpoints/agent-compositions/agent-compositions.js

@@ -2,13 +2,13 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.compositionControllerResolveDraftCapable = exports.getCompositionControllerResolveDraftCapableUrl = exports.compositionControllerResolve = exports.getCompositionControllerResolveUrl = exports.compositionControllerRescope = exports.getCompositionControllerRescopeUrl = exports.compositionControllerArchive = exports.getCompositionControllerArchiveUrl = exports.compositionControllerPublishDraft = exports.getCompositionControllerPublishDraftUrl = exports.compositionControllerDelete = exports.getCompositionControllerDeleteUrl = exports.compositionControllerUpdate = exports.getCompositionControllerUpdateUrl = exports.compositionControllerGet = exports.getCompositionControllerGetUrl = exports.compositionControllerList = exports.getCompositionControllerListUrl = exports.compositionControllerCreate = exports.getCompositionControllerCreateUrl = void 0;
 const custom_fetch_1 = require("../../custom-fetch");
-/**
- * @summary Create an Agent Composition. Created in draft lifecycle; publish separately.
- */
 const getCompositionControllerCreateUrl = () => {
     return `/compositions`;
 };
 exports.getCompositionControllerCreateUrl = getCompositionControllerCreateUrl;
+/**
+ * @summary Create an Agent. Created in draft lifecycle; publish separately.
+ */
 const compositionControllerCreate = async (createCompositionDto, options) => {
     return (0, custom_fetch_1.customFetch)((0, exports.getCompositionControllerCreateUrl)(), {
         ...options,
@@ -18,9 +18,6 @@ const compositionControllerCreate = async (createCompositionDto, options) => {
     });
 };
 exports.compositionControllerCreate = compositionControllerCreate;
-/**
- * @summary List Agent Compositions for the org.
- */
 const getCompositionControllerListUrl = (params) => {
     const normalizedParams = new URLSearchParams();
     Object.entries(params || {}).forEach(([key, value]) => {
@@ -44,6 +41,9 @@ const getCompositionControllerListUrl = (params) => {
     return stringifiedParams.length > 0 ? `/compositions?${stringifiedParams}` : `/compositions`;
 };
 exports.getCompositionControllerListUrl = getCompositionControllerListUrl;
+/**
+ * @summary List Agent Compositions for the org.
+ */
 const compositionControllerList = async (params, options) => {
     return (0, custom_fetch_1.customFetch)((0, exports.getCompositionControllerListUrl)(params), {
         ...options,
@@ -51,13 +51,13 @@ const compositionControllerList = async (params, options) => {
     });
 };
 exports.compositionControllerList = compositionControllerList;
-/**
- * @summary Get a single Agent Composition by id.
- */
 const getCompositionControllerGetUrl = (id) => {
     return `/compositions/${id}`;
 };
 exports.getCompositionControllerGetUrl = getCompositionControllerGetUrl;
+/**
+ * @summary Get a single Agent by id.
+ */
 const compositionControllerGet = async (id, options) => {
     return (0, custom_fetch_1.customFetch)((0, exports.getCompositionControllerGetUrl)(id), {
         ...options,
@@ -65,13 +65,13 @@ const compositionControllerGet = async (id, options) => {
     });
 };
 exports.compositionControllerGet = compositionControllerGet;
-/**
- * @summary Update a draft Agent Composition. Published/archived compositions are immutable.
- */
 const getCompositionControllerUpdateUrl = (id) => {
     return `/compositions/${id}`;
 };
 exports.getCompositionControllerUpdateUrl = getCompositionControllerUpdateUrl;
+/**
+ * @summary Update a draft Agent. Published/archived compositions are immutable.
+ */
 const compositionControllerUpdate = async (id, updateCompositionDto, options) => {
     return (0, custom_fetch_1.customFetch)((0, exports.getCompositionControllerUpdateUrl)(id), {
         ...options,
@@ -81,13 +81,13 @@ const compositionControllerUpdate = async (id, updateCompositionDto, options) =>
     });
 };
 exports.compositionControllerUpdate = compositionControllerUpdate;
-/**
- * @summary Delete a draft Agent Composition. Published/archived rows are kept.
- */
 const getCompositionControllerDeleteUrl = (id) => {
     return `/compositions/${id}`;
 };
 exports.getCompositionControllerDeleteUrl = getCompositionControllerDeleteUrl;
+/**
+ * @summary Delete a draft Agent. Published/archived rows are kept.
+ */
 const compositionControllerDelete = async (id, options) => {
     return (0, custom_fetch_1.customFetch)((0, exports.getCompositionControllerDeleteUrl)(id), {
         ...options,
@@ -95,21 +95,21 @@ const compositionControllerDelete = async (id, options) => {
     });
 };
 exports.compositionControllerDelete = compositionControllerDelete;
+const getCompositionControllerPublishDraftUrl = (slug) => {
+    return `/compositions/${slug}/publish`;
+};
+exports.getCompositionControllerPublishDraftUrl = getCompositionControllerPublishDraftUrl;
 /**
- * @summary Publish a draft revision of an Agent Composition as a NEW immutable `published` version. The service:
+ * @summary Publish a draft revision of an Agent as a NEW immutable `published` version. The service:
 
 1. Loads the draft row by (`slug`, `fromDraftRevisionId`).
 2. Computes the next version by applying `semverBump` to the latest published version for `slug`.
-3. Creates a new `published` Composition row at the bumped version (immutable; the only state the resolver serves).
+3. Creates a new `published` Agent row at the bumped version (immutable; the only state the resolver serves).
 4. Archives the source draft as a "consumed" lineage marker.
 5. Emits `xema.composition.published.v1`.
 
 Mediated by `composition:publish@1` against xema-capability-router (fail-CLOSED — a gateway 5xx aborts the publish). Typed denials map to the closed `CompositionPublishError` set.
  */
-const getCompositionControllerPublishDraftUrl = (slug) => {
-    return `/compositions/${slug}/publish`;
-};
-exports.getCompositionControllerPublishDraftUrl = getCompositionControllerPublishDraftUrl;
 const compositionControllerPublishDraft = async (slug, publishCompositionDto, options) => {
     return (0, custom_fetch_1.customFetch)((0, exports.getCompositionControllerPublishDraftUrl)(slug), {
         ...options,
@@ -119,13 +119,13 @@ const compositionControllerPublishDraft = async (slug, publishCompositionDto, op
     });
 };
 exports.compositionControllerPublishDraft = compositionControllerPublishDraft;
-/**
- * @summary Archive an Agent Composition version. Archived rows are never resolved.
- */
 const getCompositionControllerArchiveUrl = (id) => {
     return `/compositions/${id}/archive`;
 };
 exports.getCompositionControllerArchiveUrl = getCompositionControllerArchiveUrl;
+/**
+ * @summary Archive an Agent version. Archived rows are never resolved.
+ */
 const compositionControllerArchive = async (id, options) => {
     return (0, custom_fetch_1.customFetch)((0, exports.getCompositionControllerArchiveUrl)(id), {
         ...options,
@@ -133,13 +133,13 @@ const compositionControllerArchive = async (id, options) => {
     });
 };
 exports.compositionControllerArchive = compositionControllerArchive;
-/**
- * @summary Re-scope an Agent Composition — 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.
- */
 const getCompositionControllerRescopeUrl = (id) => {
     return `/compositions/${id}/rescope`;
 };
 exports.getCompositionControllerRescopeUrl = getCompositionControllerRescopeUrl;
+/**
+ * @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.
+ */
 const compositionControllerRescope = async (id, rescopeDto, options) => {
     return (0, custom_fetch_1.customFetch)((0, exports.getCompositionControllerRescopeUrl)(id), {
         ...options,
@@ -149,9 +149,6 @@ const compositionControllerRescope = async (id, rescopeDto, options) => {
     });
 };
 exports.compositionControllerRescope = compositionControllerRescope;
-/**
- * @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.
- */
 const getCompositionControllerResolveUrl = (ref, params) => {
     const normalizedParams = new URLSearchParams();
     Object.entries(params || {}).forEach(([key, value]) => {
@@ -175,6 +172,9 @@ const getCompositionControllerResolveUrl = (ref, params) => {
     return stringifiedParams.length > 0 ? `/compositions/resolve/${ref}?${stringifiedParams}` : `/compositions/resolve/${ref}`;
 };
 exports.getCompositionControllerResolveUrl = getCompositionControllerResolveUrl;
+/**
+ * @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.
+ */
 const compositionControllerResolve = async (ref, params, options) => {
     return (0, custom_fetch_1.customFetch)((0, exports.getCompositionControllerResolveUrl)(ref, params), {
         ...options,
@@ -182,9 +182,6 @@ const compositionControllerResolve = async (ref, params, options) => {
     });
 };
 exports.compositionControllerResolve = compositionControllerResolve;
-/**
- * @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.
- */
 const getCompositionControllerResolveDraftCapableUrl = (id, params) => {
     const normalizedParams = new URLSearchParams();
     Object.entries(params || {}).forEach(([key, value]) => {
@@ -208,6 +205,9 @@ const getCompositionControllerResolveDraftCapableUrl = (id, params) => {
     return stringifiedParams.length > 0 ? `/compositions/${id}/resolved?${stringifiedParams}` : `/compositions/${id}/resolved`;
 };
 exports.getCompositionControllerResolveDraftCapableUrl = getCompositionControllerResolveDraftCapableUrl;
+/**
+ * @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.
+ */
 const compositionControllerResolveDraftCapable = async (id, params, options) => {
     return (0, custom_fetch_1.customFetch)((0, exports.getCompositionControllerResolveDraftCapableUrl)(id, params), {
         ...options,

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

@@ -1,113 +1,113 @@
 /**
- * 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
  */
 import type { AgentConfigBlocksResponseDtoDataEnvelope, AgentDefinitionControllerBrowseTalentPoolParams, AgentDefinitionControllerListDefinitionsParams, AgentDefinitionControllerListInteractiveCatalogParams, AgentDefinitionControllerResolveAgentBlocksParams, AgentDefinitionControllerResolveAgentBundleFileParams, AgentDefinitionResponseDtoDataEnvelope, AgentDefinitionResponseDtoPaginatedEnvelope, AgentProfileDtoDataEnvelope, AgentProfileDtoPaginatedEnvelope, BundleFileResponseDtoDataEnvelope, CreateAgentDefinitionDto, CreateProjectAgentOverrideDto, OrgInteractiveSubagentsResponseDtoDataEnvelope, ProjectAgentOverrideResponseDtoDataEnvelope, ProjectAgentOverrideResponseDtoPaginatedEnvelope, RescopeDto, ResolveFullResponseDtoDataEnvelope, ResolvedAgentResponseDtoDataEnvelope, ResolvedConfigSnapshotResponseDtoDataEnvelope, UpdateAgentDefinitionDto, UpdateProjectAgentOverrideDto } from '../../models';
+export declare const getAgentDefinitionControllerListDefinitionsUrl: (params?: AgentDefinitionControllerListDefinitionsParams) => string;
 /**
  * @summary List agent definitions. Biome-attributed rows are filtered through `@xemahq/biome-governance-client` against the caller org's enablement view; agents shipped by disabled biomes are hidden.
  */
-export declare const getAgentDefinitionControllerListDefinitionsUrl: (params?: AgentDefinitionControllerListDefinitionsParams) => string;
 export declare const agentDefinitionControllerListDefinitions: (params?: AgentDefinitionControllerListDefinitionsParams, options?: RequestInit) => Promise<AgentDefinitionResponseDtoPaginatedEnvelope>;
+export declare const getAgentDefinitionControllerCreateDefinitionUrl: () => string;
 /**
  * @summary Create an agent definition
  */
-export declare const getAgentDefinitionControllerCreateDefinitionUrl: () => string;
 export declare const agentDefinitionControllerCreateDefinition: (createAgentDefinitionDto: CreateAgentDefinitionDto, options?: RequestInit) => Promise<AgentDefinitionResponseDtoDataEnvelope>;
+export declare const getAgentDefinitionControllerBrowseTalentPoolUrl: (params?: AgentDefinitionControllerBrowseTalentPoolParams) => string;
 /**
  * @summary Browse the talent pool — paginated, filterable agent profiles
  */
-export declare const getAgentDefinitionControllerBrowseTalentPoolUrl: (params?: AgentDefinitionControllerBrowseTalentPoolParams) => string;
 export declare const agentDefinitionControllerBrowseTalentPool: (params?: AgentDefinitionControllerBrowseTalentPoolParams, options?: RequestInit) => Promise<AgentProfileDtoPaginatedEnvelope>;
+export declare const getAgentDefinitionControllerGetTalentPoolProfileUrl: (slug: string) => string;
 /**
  * @summary Get agent profile by slug from the talent pool
  */
-export declare const getAgentDefinitionControllerGetTalentPoolProfileUrl: (slug: string) => string;
 export declare const agentDefinitionControllerGetTalentPoolProfile: (slug: string, options?: RequestInit) => Promise<AgentProfileDtoDataEnvelope>;
+export declare const getAgentDefinitionControllerGetTalentPoolStatsUrl: (slug: string) => string;
 /**
  * @summary Get agent usage stats (v1 stub)
  */
-export declare const getAgentDefinitionControllerGetTalentPoolStatsUrl: (slug: string) => string;
 export declare const agentDefinitionControllerGetTalentPoolStats: (slug: string, options?: RequestInit) => Promise<unknown>;
+export declare const getAgentDefinitionControllerListInteractiveCatalogUrl: (params?: AgentDefinitionControllerListInteractiveCatalogParams) => string;
 /**
  * @summary List agents available for interactive sessions — filtered by supportsAgentSessions=true
  */
-export declare const getAgentDefinitionControllerListInteractiveCatalogUrl: (params?: AgentDefinitionControllerListInteractiveCatalogParams) => string;
 export declare const agentDefinitionControllerListInteractiveCatalog: (params?: AgentDefinitionControllerListInteractiveCatalogParams, options?: RequestInit) => Promise<AgentDefinitionResponseDtoPaginatedEnvelope>;
+export declare const getAgentDefinitionControllerListOrgInteractiveSubagentsUrl: () => string;
 /**
  * @summary Internal: list org-defined subagents eligible for mounting on interactive workers. Consumed by opencode-pool at session-acquire time so org-defined agents are staged in /workspace/.opencode/agents/<slug>.md. Returns only org-owned (NOT system) isActive definitions with executionMode=subagent.
  */
-export declare const getAgentDefinitionControllerListOrgInteractiveSubagentsUrl: () => string;
 export declare const agentDefinitionControllerListOrgInteractiveSubagents: (options?: RequestInit) => Promise<OrgInteractiveSubagentsResponseDtoDataEnvelope>;
+export declare const getAgentDefinitionControllerResolveAgentBundleFileUrl: (slug: string, params: AgentDefinitionControllerResolveAgentBundleFileParams) => string;
 /**
  * @summary Internal: resolve a single agent's `.opencode/agents/<slug>.md` content for the mount-apply pipeline. Honors project → org → biome → system precedence. `agentMode` controls the rendered frontmatter `mode` field (primary or subagent).
  */
-export declare const getAgentDefinitionControllerResolveAgentBundleFileUrl: (slug: string, params: AgentDefinitionControllerResolveAgentBundleFileParams) => string;
 export declare const agentDefinitionControllerResolveAgentBundleFile: (slug: string, params: AgentDefinitionControllerResolveAgentBundleFileParams, options?: RequestInit) => Promise<BundleFileResponseDtoDataEnvelope>;
+export declare const getAgentDefinitionControllerResolveAgentBlocksUrl: (params: AgentDefinitionControllerResolveAgentBlocksParams) => string;
 /**
  * @summary Internal: resolve the per-agent OpenCode runtime config blocks (description/color/steps/temperature/tools/permission) for an explicit, closed slug set. Used by opencode-pool-api at allocation time. Honors project → org → biome → system precedence. Unknown slugs raise 404. The "fetch every agent at scope" mode was deleted in Phase B3 — sessions must declare their closure (primary + intrinsic floor + DSL overrides).
  */
-export declare const getAgentDefinitionControllerResolveAgentBlocksUrl: (params: AgentDefinitionControllerResolveAgentBlocksParams) => string;
 export declare const agentDefinitionControllerResolveAgentBlocks: (params: AgentDefinitionControllerResolveAgentBlocksParams, options?: RequestInit) => Promise<AgentConfigBlocksResponseDtoDataEnvelope>;
+export declare const getAgentDefinitionControllerResolveInstructionSectionBundleFileUrl: (sectionKey: string) => string;
 /**
  * @summary Internal: resolve a single instruction section's content for the mount-apply pipeline. Mounted at `/workspace/.xema/instructions/<sectionKey>.md` and auto-discovered by OpenCode via the static `instructions` glob in base opencode.jsonc.
  */
-export declare const getAgentDefinitionControllerResolveInstructionSectionBundleFileUrl: (sectionKey: string) => string;
 export declare const agentDefinitionControllerResolveInstructionSectionBundleFile: (sectionKey: string, options?: RequestInit) => Promise<BundleFileResponseDtoDataEnvelope>;
+export declare const getAgentDefinitionControllerResolveFullConfigUrl: (slug: string) => string;
 /**
  * @summary Resolve the complete agent configuration (base + overrides + tools + skills)
  */
-export declare const getAgentDefinitionControllerResolveFullConfigUrl: (slug: string) => string;
 export declare const agentDefinitionControllerResolveFullConfig: (slug: string, options?: RequestInit) => Promise<ResolveFullResponseDtoDataEnvelope>;
+export declare const getAgentDefinitionControllerGetResolvedSnapshotUrl: (snapshotId: string) => string;
 /**
  * @summary Get a persisted resolved config snapshot for audit, replay, and debugging
  */
-export declare const getAgentDefinitionControllerGetResolvedSnapshotUrl: (snapshotId: string) => string;
 export declare const agentDefinitionControllerGetResolvedSnapshot: (snapshotId: string, options?: RequestInit) => Promise<ResolvedConfigSnapshotResponseDtoDataEnvelope>;
+export declare const getAgentDefinitionControllerGetDefinitionBySlugUrl: (slug: string) => string;
 /**
  * @summary Get agent definition by slug
  */
-export declare const getAgentDefinitionControllerGetDefinitionBySlugUrl: (slug: string) => string;
 export declare const agentDefinitionControllerGetDefinitionBySlug: (slug: string, options?: RequestInit) => Promise<AgentDefinitionResponseDtoDataEnvelope>;
+export declare const getAgentDefinitionControllerUpdateDefinitionUrl: (id: string) => string;
 /**
  * @summary Update an agent definition
  */
-export declare const getAgentDefinitionControllerUpdateDefinitionUrl: (id: string) => string;
 export declare const agentDefinitionControllerUpdateDefinition: (id: string, updateAgentDefinitionDto: UpdateAgentDefinitionDto, options?: RequestInit) => Promise<AgentDefinitionResponseDtoDataEnvelope>;
+export declare const getAgentDefinitionControllerDeleteDefinitionUrl: (id: string) => string;
 /**
  * @summary Delete an agent definition
  */
-export declare const getAgentDefinitionControllerDeleteDefinitionUrl: (id: string) => string;
 export declare const agentDefinitionControllerDeleteDefinition: (id: string, options?: RequestInit) => Promise<unknown>;
+export declare const getAgentDefinitionControllerRescopeDefinitionUrl: (id: string) => string;
 /**
  * @summary Re-scope an agent definition — promote its owner UP the scope ladder (the "add to project" / "publish to org" action). Legal promotions: user → project|org, project → org. Content is unchanged; only the owner columns move. Illegal promotions and non-owner attempts fail fast with 400/403.
  */
-export declare const getAgentDefinitionControllerRescopeDefinitionUrl: (id: string) => string;
 export declare const agentDefinitionControllerRescopeDefinition: (id: string, rescopeDto: RescopeDto, options?: RequestInit) => Promise<AgentDefinitionResponseDtoDataEnvelope>;
+export declare const getAgentDefinitionControllerListOverridesUrl: (projectId: string) => string;
 /**
  * @summary List project-level agent overrides
  */
-export declare const getAgentDefinitionControllerListOverridesUrl: (projectId: string) => string;
 export declare const agentDefinitionControllerListOverrides: (projectId: string, options?: RequestInit) => Promise<ProjectAgentOverrideResponseDtoPaginatedEnvelope>;
+export declare const getAgentDefinitionControllerCreateOverrideUrl: (projectId: string) => string;
 /**
  * @summary Create a project-level agent override
  */
-export declare const getAgentDefinitionControllerCreateOverrideUrl: (projectId: string) => string;
 export declare const agentDefinitionControllerCreateOverride: (projectId: string, createProjectAgentOverrideDto: CreateProjectAgentOverrideDto, options?: RequestInit) => Promise<ProjectAgentOverrideResponseDtoDataEnvelope>;
+export declare const getAgentDefinitionControllerUpdateOverrideUrl: (projectId: string, id: string) => string;
 /**
  * @summary Update a project-level agent override
  */
-export declare const getAgentDefinitionControllerUpdateOverrideUrl: (projectId: string, id: string) => string;
 export declare const agentDefinitionControllerUpdateOverride: (projectId: string, id: string, updateProjectAgentOverrideDto: UpdateProjectAgentOverrideDto, options?: RequestInit) => Promise<ProjectAgentOverrideResponseDtoDataEnvelope>;
+export declare const getAgentDefinitionControllerDeleteOverrideUrl: (projectId: string, id: string) => string;
 /**
  * @summary Delete a project-level agent override
  */
-export declare const getAgentDefinitionControllerDeleteOverrideUrl: (projectId: string, id: string) => string;
 export declare const agentDefinitionControllerDeleteOverride: (projectId: string, id: string, options?: RequestInit) => Promise<unknown>;
+export declare const getAgentDefinitionControllerResolveAgentUrl: (projectId: string, slug: string) => string;
 /**
  * @summary Resolve effective agent config for a project (base + overrides)
  */
-export declare const getAgentDefinitionControllerResolveAgentUrl: (projectId: string, slug: string) => string;
 export declare const agentDefinitionControllerResolveAgent: (projectId: string, slug: string, options?: RequestInit) => Promise<ResolvedAgentResponseDtoDataEnvelope>;