@treeseed/sdk 0.13.0-rc.55 → 0.13.0-rc.56

package/dist/operator-contracts/control-plane-operations.js

@@ -4,6 +4,8 @@ import { communicationOperations, providerCommunicationLifecycleOperations, prov
 import { inboxOperations } from "./catalog/inbox-operations.js";
 import { adminAccountOperations, adminTeamOperations } from "./catalog/admin-account-team-operations.js";
 import { TREEAI_CONTROL_PLANE_OPERATIONS } from "./catalog/treeai-operations.js";
+import { capabilityOntologyOperations } from "./catalog/capability-ontology-operations.js";
+import { buildControlPlaneCatalog, flattenControlPlaneOperations } from "./catalog/control-plane-catalog.js";
 const empty = z.object({}).strict();
 const none = z.undefined();
 const record = z.record(z.unknown());
@@ -98,6 +100,7 @@ function resource(operationId, method, path, pathShape, options = { capability:
   }, { path: z.object(pathShape).strict(), query: kind === "read" ? record : empty, body: kind === "read" ? none : record, output: payload });
 }
 const CONTROL_PLANE_OPERATIONS = {
+  capabilities: capabilityOntologyOperations(),
   inbox: inboxOperations(),
   treeai: TREEAI_CONTROL_PLANE_OPERATIONS,
   status: {
@@ -453,6 +456,8 @@ const CONTROL_PLANE_OPERATIONS = {
     }
   },
   providers: {
+    capabilityProposal: noPathProvider("providers.capabilities.propose", "POST", "/v1/provider/capability-proposals"),
+    capabilityProposalStatus: providerPath("providers.capabilities.proposal.show", "GET", "/v1/provider/capability-proposals/{proposalId}", { proposalId: z.string().min(1) }, { read: true }),
     list: resource("providers.list", "GET", "/v1/teams/{teamId}/capacity-providers", { teamId: z.string().min(1) }, { capability: "providers.read", surfaces: ["rest", "cli", "mcp_tool"], pagination: "cursor" }),
     show: resource("providers.show", "GET", "/v1/teams/{teamId}/capacity-providers/{providerId}", { teamId: z.string().min(1), providerId: z.string().min(1) }, { capability: "providers.read", surfaces: ["rest", "cli", "mcp_resource"] }),
     status: resource("providers.status", "GET", "/v1/teams/{teamId}/capacity-providers/{providerId}/status", { teamId: z.string().min(1), providerId: z.string().min(1) }, { capability: "providers.read", surfaces: ["rest", "cli", "mcp_tool"] }),
@@ -501,16 +506,8 @@ const CONTROL_PLANE_OPERATIONS = {
     workflowRun: providerPath("providers.assignments.workflow.show", "GET", "/v1/provider/assignments/{assignmentId}/workflow-runs/{runId}", { assignmentId: z.string().min(1), runId: z.string().min(1) }, { read: true })
   }
 };
-function flatten(value, output = []) {
-  if (value && typeof value === "object" && "descriptor" in value && "schema" in value) output.push(value);
-  else if (value && typeof value === "object") for (const child of Object.values(value)) flatten(child, output);
-  return output;
-}
-const CONTROL_PLANE_OPERATION_LIST = Object.freeze(flatten(CONTROL_PLANE_OPERATIONS));
-const CONTROL_PLANE_CATALOG = Object.freeze({
-  schemaVersion: "treeseed.control-plane-catalog/v1",
-  operations: CONTROL_PLANE_OPERATION_LIST.map((operation) => operation.descriptor)
-});
+const CONTROL_PLANE_OPERATION_LIST = Object.freeze(flattenControlPlaneOperations(CONTROL_PLANE_OPERATIONS));
+const CONTROL_PLANE_CATALOG = buildControlPlaneCatalog(CONTROL_PLANE_OPERATION_LIST);
 function controlPlaneOperation(operationId) {
   const operation = CONTROL_PLANE_OPERATION_LIST.find((candidate) => candidate.descriptor.operationId === operationId);
   if (!operation) throw new Error(`Unknown control-plane operation ${operationId}.`);

package/dist/operator-contracts/index.d.ts

@@ -9,4 +9,5 @@ export * from './oauth.js';
 export * from './communication/contracts.js';
 export * from './communication/addressing.js';
 export * from './inbox/contracts.js';
+export * from '../capacity-provider/capability-ontology.js';
 export * from './seed/seed-bundle.js';

package/dist/operator-contracts/index.js

@@ -9,4 +9,5 @@ export * from "./oauth.js";
 export * from "./communication/contracts.js";
 export * from "./communication/addressing.js";
 export * from "./inbox/contracts.js";
+export * from "../capacity-provider/capability-ontology.js";
 export * from "./seed/seed-bundle.js";

package/dist/types/agents/agent-activity-profile.d.ts

@@ -4,6 +4,18 @@ export interface AgentContentRevisionRef {
     id: string;
     revision: number;
 }
+export interface AgentCapabilityConfigurationValue {
+    value: unknown;
+    requirement: 'required' | 'preferred';
+}
+export interface AgentCapabilityRequirement {
+    capabilityId: string;
+    versionRange: string;
+    requirement: 'required' | 'preferred';
+    alternativeGroup?: string | null;
+    requiredFeatures?: string[];
+    configuration?: Record<string, AgentCapabilityConfigurationValue>;
+}
 export interface AgentActivityProfile {
     activityType?: AgentActivityType;
     enabled: boolean;
@@ -15,6 +27,7 @@ export interface AgentActivityProfile {
     contextQueryRefs?: AgentContentRevisionRef[];
     contextQuerySetRefs?: AgentContentRevisionRef[];
     instructionTemplateRefs?: AgentContentRevisionRef[];
+    capabilityRequirements?: AgentCapabilityRequirement[];
     artifactTriggers?: Array<{
         event: string;
         artifactKind: string;
@@ -27,15 +40,6 @@ export interface AgentActivityProfile {
         requiredArtifactKinds?: string[];
         blockOnOpenQuestions?: boolean;
     };
-    providerOverrides?: {
-        requiredCapabilities?: string[];
-        disallowedProviderIds?: string[];
-        promptRef?: string;
-        instructionTemplateRefs?: AgentContentRevisionRef[];
-        maxRuntimeSeconds?: number;
-        maxTotalTokens?: number;
-        maxCostAmount?: number;
-    };
     tools: AgentToolPolicy;
     signals?: AgentSignalPolicy;
     outputs: AgentOutputContract;
@@ -48,7 +52,7 @@ export interface AgentChatProfileConfiguration {
     foundation: 'discussion-v1';
     responseStyle?: string;
     promptTask?: string;
-    requiredCapabilities?: string[];
+    capabilityRequirements?: AgentCapabilityRequirement[];
     maxRuntimeSeconds?: number;
     maxTotalTokens?: number;
     warningTokens?: number;
@@ -81,8 +85,6 @@ export interface AgentDefinition {
     chatProfile?: AgentChatProfileConfiguration;
 }
 export interface AgentExecutionConfig {
-    provider?: string;
-    model?: string;
     approvalPolicy?: 'never' | 'on_request' | 'always' | string;
     sandboxMode?: 'read_only' | 'workspace_write' | string;
     reasoningEffort?: 'low' | 'medium' | 'high' | string;
@@ -99,30 +101,10 @@ export interface AgentExecutionConfig {
     leaseSeconds: number;
     retryLimit: number;
     branchPrefix: string;
-    providerProfile?: AgentProviderProfile;
 }
 export type AgentProviderFallbackPolicy = 'allow_substitution' | 'require_same_model_class' | 'fail_if_unavailable' | 'ask_for_approval';
-export interface AgentExecutionProviderPreference {
-    providerId?: string;
-    provider?: string;
-    model?: string;
-    modelClass?: string;
-    weight: number;
-    reason?: string;
-}
-export interface AgentProviderFallback {
-    providerId?: string;
-    provider?: string;
-    model?: string;
-    modelClass?: string;
-    maxQualityPenalty?: number;
-}
 export interface AgentProviderProfile {
-    requiredCapabilities: string[];
-    preferredExecutionProviders: AgentExecutionProviderPreference[];
-    acceptableFallbacks: AgentProviderFallback[];
-    disallowedProviders?: string[];
-    disallowedRegions?: string[];
+    capabilityRequirements: AgentCapabilityRequirement[];
     fallbackPolicy: AgentProviderFallbackPolicy;
 }
 export interface ExecutionResourceNeed {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@treeseed/sdk",
-  "version": "0.13.0-rc.55",
+  "version": "0.13.0-rc.56",
   "description": "Portable TreeSeed contracts, standards, and typed remote control-plane clients.",
   "license": "Apache-2.0",
   "repository": {