@xemahq/llm-registry-api-client 0.1.2

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

@@ -0,0 +1,217 @@
+"use strict";
+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;
+const compositionControllerCreate = async (createCompositionDto, options) => {
+    return (0, custom_fetch_1.customFetch)((0, exports.getCompositionControllerCreateUrl)(), {
+        ...options,
+        method: 'POST',
+        headers: { 'Content-Type': 'application/json', ...options?.headers },
+        body: JSON.stringify(createCompositionDto)
+    });
+};
+exports.compositionControllerCreate = compositionControllerCreate;
+/**
+ * @summary List Agent Compositions for the org.
+ */
+const getCompositionControllerListUrl = (params) => {
+    const normalizedParams = new URLSearchParams();
+    Object.entries(params || {}).forEach(([key, value]) => {
+        if (value === undefined)
+            return;
+        if (value === null) {
+            normalizedParams.append(key, 'null');
+            return;
+        }
+        if (Array.isArray(value)) {
+            for (const item of value) {
+                if (item === undefined || item === null)
+                    continue;
+                normalizedParams.append(key, item.toString());
+            }
+            return;
+        }
+        normalizedParams.append(key, value.toString());
+    });
+    const stringifiedParams = normalizedParams.toString();
+    return stringifiedParams.length > 0 ? `/compositions?${stringifiedParams}` : `/compositions`;
+};
+exports.getCompositionControllerListUrl = getCompositionControllerListUrl;
+const compositionControllerList = async (params, options) => {
+    return (0, custom_fetch_1.customFetch)((0, exports.getCompositionControllerListUrl)(params), {
+        ...options,
+        method: 'GET'
+    });
+};
+exports.compositionControllerList = compositionControllerList;
+/**
+ * @summary Get a single Agent Composition by id.
+ */
+const getCompositionControllerGetUrl = (id) => {
+    return `/compositions/${id}`;
+};
+exports.getCompositionControllerGetUrl = getCompositionControllerGetUrl;
+const compositionControllerGet = async (id, options) => {
+    return (0, custom_fetch_1.customFetch)((0, exports.getCompositionControllerGetUrl)(id), {
+        ...options,
+        method: 'GET'
+    });
+};
+exports.compositionControllerGet = compositionControllerGet;
+/**
+ * @summary Update a draft Agent Composition. Published/archived compositions are immutable.
+ */
+const getCompositionControllerUpdateUrl = (id) => {
+    return `/compositions/${id}`;
+};
+exports.getCompositionControllerUpdateUrl = getCompositionControllerUpdateUrl;
+const compositionControllerUpdate = async (id, updateCompositionDto, options) => {
+    return (0, custom_fetch_1.customFetch)((0, exports.getCompositionControllerUpdateUrl)(id), {
+        ...options,
+        method: 'PATCH',
+        headers: { 'Content-Type': 'application/json', ...options?.headers },
+        body: JSON.stringify(updateCompositionDto)
+    });
+};
+exports.compositionControllerUpdate = compositionControllerUpdate;
+/**
+ * @summary Delete a draft Agent Composition. Published/archived rows are kept.
+ */
+const getCompositionControllerDeleteUrl = (id) => {
+    return `/compositions/${id}`;
+};
+exports.getCompositionControllerDeleteUrl = getCompositionControllerDeleteUrl;
+const compositionControllerDelete = async (id, options) => {
+    return (0, custom_fetch_1.customFetch)((0, exports.getCompositionControllerDeleteUrl)(id), {
+        ...options,
+        method: 'DELETE'
+    });
+};
+exports.compositionControllerDelete = compositionControllerDelete;
+/**
+ * @summary Publish a draft revision of an Agent Composition 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).
+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,
+        method: 'POST',
+        headers: { 'Content-Type': 'application/json', ...options?.headers },
+        body: JSON.stringify(publishCompositionDto)
+    });
+};
+exports.compositionControllerPublishDraft = compositionControllerPublishDraft;
+/**
+ * @summary Archive an Agent Composition version. Archived rows are never resolved.
+ */
+const getCompositionControllerArchiveUrl = (id) => {
+    return `/compositions/${id}/archive`;
+};
+exports.getCompositionControllerArchiveUrl = getCompositionControllerArchiveUrl;
+const compositionControllerArchive = async (id, options) => {
+    return (0, custom_fetch_1.customFetch)((0, exports.getCompositionControllerArchiveUrl)(id), {
+        ...options,
+        method: 'PATCH'
+    });
+};
+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;
+const compositionControllerRescope = async (id, rescopeDto, options) => {
+    return (0, custom_fetch_1.customFetch)((0, exports.getCompositionControllerRescopeUrl)(id), {
+        ...options,
+        method: 'POST',
+        headers: { 'Content-Type': 'application/json', ...options?.headers },
+        body: JSON.stringify(rescopeDto)
+    });
+};
+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]) => {
+        if (value === undefined)
+            return;
+        if (value === null) {
+            normalizedParams.append(key, 'null');
+            return;
+        }
+        if (Array.isArray(value)) {
+            for (const item of value) {
+                if (item === undefined || item === null)
+                    continue;
+                normalizedParams.append(key, item.toString());
+            }
+            return;
+        }
+        normalizedParams.append(key, value.toString());
+    });
+    const stringifiedParams = normalizedParams.toString();
+    return stringifiedParams.length > 0 ? `/compositions/resolve/${ref}?${stringifiedParams}` : `/compositions/resolve/${ref}`;
+};
+exports.getCompositionControllerResolveUrl = getCompositionControllerResolveUrl;
+const compositionControllerResolve = async (ref, params, options) => {
+    return (0, custom_fetch_1.customFetch)((0, exports.getCompositionControllerResolveUrl)(ref, params), {
+        ...options,
+        method: 'GET'
+    });
+};
+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]) => {
+        if (value === undefined)
+            return;
+        if (value === null) {
+            normalizedParams.append(key, 'null');
+            return;
+        }
+        if (Array.isArray(value)) {
+            for (const item of value) {
+                if (item === undefined || item === null)
+                    continue;
+                normalizedParams.append(key, item.toString());
+            }
+            return;
+        }
+        normalizedParams.append(key, value.toString());
+    });
+    const stringifiedParams = normalizedParams.toString();
+    return stringifiedParams.length > 0 ? `/compositions/${id}/resolved?${stringifiedParams}` : `/compositions/${id}/resolved`;
+};
+exports.getCompositionControllerResolveDraftCapableUrl = getCompositionControllerResolveDraftCapableUrl;
+const compositionControllerResolveDraftCapable = async (id, params, options) => {
+    return (0, custom_fetch_1.customFetch)((0, exports.getCompositionControllerResolveDraftCapableUrl)(id, params), {
+        ...options,
+        method: 'GET'
+    });
+};
+exports.compositionControllerResolveDraftCapable = compositionControllerResolveDraftCapable;

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

@@ -0,0 +1,113 @@
+/**
+ * Generated by orval v8.6.2 🍺
+ * 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';
+/**
+ * @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>;
+/**
+ * @summary Create an agent definition
+ */
+export declare const getAgentDefinitionControllerCreateDefinitionUrl: () => string;
+export declare const agentDefinitionControllerCreateDefinition: (createAgentDefinitionDto: CreateAgentDefinitionDto, options?: RequestInit) => Promise<AgentDefinitionResponseDtoDataEnvelope>;
+/**
+ * @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>;
+/**
+ * @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>;
+/**
+ * @summary Get agent usage stats (v1 stub)
+ */
+export declare const getAgentDefinitionControllerGetTalentPoolStatsUrl: (slug: string) => string;
+export declare const agentDefinitionControllerGetTalentPoolStats: (slug: string, options?: RequestInit) => Promise<unknown>;
+/**
+ * @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>;
+/**
+ * @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>;
+/**
+ * @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>;
+/**
+ * @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>;
+/**
+ * @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>;
+/**
+ * @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>;
+/**
+ * @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>;
+/**
+ * @summary Get agent definition by slug
+ */
+export declare const getAgentDefinitionControllerGetDefinitionBySlugUrl: (slug: string) => string;
+export declare const agentDefinitionControllerGetDefinitionBySlug: (slug: string, options?: RequestInit) => Promise<AgentDefinitionResponseDtoDataEnvelope>;
+/**
+ * @summary Update an agent definition
+ */
+export declare const getAgentDefinitionControllerUpdateDefinitionUrl: (id: string) => string;
+export declare const agentDefinitionControllerUpdateDefinition: (id: string, updateAgentDefinitionDto: UpdateAgentDefinitionDto, options?: RequestInit) => Promise<AgentDefinitionResponseDtoDataEnvelope>;
+/**
+ * @summary Delete an agent definition
+ */
+export declare const getAgentDefinitionControllerDeleteDefinitionUrl: (id: string) => string;
+export declare const agentDefinitionControllerDeleteDefinition: (id: string, options?: RequestInit) => Promise<unknown>;
+/**
+ * @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>;
+/**
+ * @summary List project-level agent overrides
+ */
+export declare const getAgentDefinitionControllerListOverridesUrl: (projectId: string) => string;
+export declare const agentDefinitionControllerListOverrides: (projectId: string, options?: RequestInit) => Promise<ProjectAgentOverrideResponseDtoPaginatedEnvelope>;
+/**
+ * @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>;
+/**
+ * @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>;
+/**
+ * @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>;
+/**
+ * @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>;