@treeseed/sdk 0.13.0-rc.11 → 0.13.0-rc.111

package/dist/agent-capacity/contracts/projects/agents/project-agent-class.d.ts

@@ -26,7 +26,6 @@ export interface ProjectAgentClass {
     name: string;
     status: ProjectAgentClassStatus;
     allowedModes: AgentExecutionMode[];
-    requiredCapabilities: string[];
     kernelProfile: AgentKernelProfile;
     kernelPolicy: AgentKernelPolicy;
     handlerRefs: Record<string, unknown>;

package/dist/agent-capacity/contracts/runtime/runtime-observability.d.ts

@@ -1,9 +1,9 @@
 import type { CapacityPageInfo } from '../../../capacity/capacity-core/capacity-pagination.js';
 import type { ExecutionCapabilityDemand, ExecutionCapabilitySupply } from '../../../types/agents.js';
-import type { AgentCapacityEnvelope, AgentExecutionMode, AgentModeRun, DecisionExecutionInput, ProviderAssignment, ProviderAssignmentSynthesisSource, TreeDxProxyHandle, WorkdayCapacityEnvelope } from '../capacity/assignments/assignment-records.js';
-import type { AgentKernelPolicy, AgentKernelProfile } from '../projects/agents/project-agent-class.js';
+import type { AgentCapacityEnvelope, AgentExecutionMode, AgentModeRun, AgentModeRunUsageSettlement, DecisionExecutionInput, ProviderAssignment, ProviderAssignmentSynthesisSource, TreeDxProxyHandle, WorkdayCapacityEnvelope } from '../capacity/assignments/assignment-records.js';
+import type { AgentKernelPolicy, AgentKernelProfile, ProjectAgentClass } from '../projects/agents/project-agent-class.js';
 import type { CapacityLedgerEntry, CapacityReservation, CapacityUsageActual } from '../support/financial-records.js';
-import type { WorkdayCapacityEnvelopeRecord } from '../support/planning-records.js';
+import type { DecisionPlanningStatus, WorkdayCapacityEnvelopeRecord } from '../support/planning-records.js';
 export type AgentKernelModeExecutionStatus = 'completed' | 'waiting' | 'failed' | 'returned';
 export type AgentKernelModeFallbackCode = 'assignment_missing_project_or_agent' | 'assignment_governance_provenance_missing' | 'assignment_lease_expired' | 'assignment_mode_not_allowed' | 'assignment_missing_capacity_envelope' | 'assignment_missing_decision_input' | 'assignment_handler_failed' | 'assignment_project_not_synced' | 'assignment_agent_not_found' | 'assignment_insufficient_capability' | 'assignment_decision_not_ready' | 'assignment_capacity_plan_not_accepted' | 'assignment_capacity_not_reserved' | 'assignment_capability_handle_invalid' | 'assignment_capability_handle_secret_material' | 'assignment_capability_handle_write_not_ready' | 'assignment_capability_handle_workspace_denied' | 'assignment_repository_ref_scope_invalid' | 'assignment_workflow_operation_denied' | 'assignment_eligibility_capability_mismatch' | 'assignment_retry_policy_exceeded' | 'assignment_treedx_proxy_scope_invalid' | 'assignment_fallback_quota_exceeded' | 'assignment_output_invalid';
 export interface AgentCapacityPlan {

package/dist/agent-capacity/contracts/support/decision-work.d.ts

@@ -17,7 +17,7 @@ export interface ProviderNativeEstimateRange {
     minimum: number;
     expected: number;
     maximum: number;
-    providerClass?: string;
+    providerCapabilities?: string[];
 }
 export interface AgentOutputRequirement {
     id?: string;
@@ -34,7 +34,6 @@ export interface DecisionDependencySpec {
     optional?: boolean;
     deliverableType?: string;
     capability?: string;
-    agentClass?: string;
     contentRefs?: string[];
     humanInputPolicy?: {
         requiredFrom: 'team-human' | 'any-human' | 'any-human-or-agent';
@@ -190,7 +189,7 @@ export interface DecisionAssignmentGraph {
     edges: DecisionAssignmentGraphEdge[];
     compiledAt?: string | null;
     compiledBy: 'api-control-plane';
-    executionMode?: import('./execution-mode.js').AgentWorkExecutionMode;
+    executionMode?: import('./authority/execution-mode.js').AgentWorkExecutionMode;
     metadata?: Record<string, unknown>;
 }
 export interface DecisionAssignmentGraphRecord extends DecisionAssignmentGraph {

package/dist/agent-capacity/validation/activity-profile.js

@@ -1,12 +1,12 @@
 import { AGENT_ACTIVITY_TYPES, AGENT_HANDLER_KINDS } from "../../types/agents.js";
 import { compileAgentAuthoritySnapshot } from "../authority/agent-authority-presets.js";
-const PROFILE_KEYS = /* @__PURE__ */ new Set(["activityType", "enabled", "handler", "prompt", "branchPolicy", "contextQueryRefs", "contextQuerySetRefs", "instructionTemplateRefs", "permissions", "authorityPresets", "artifactTriggers", "closeoutPolicy", "providerOverrides", "tools", "signals", "outputs", "planningIntent", "questionPolicy", "execution"]);
+const PROFILE_KEYS = /* @__PURE__ */ new Set(["activityType", "enabled", "handler", "prompt", "branchPolicy", "contextQueryRefs", "contextQuerySetRefs", "instructionTemplateRefs", "capabilityRequirements", "permissions", "authorityPresets", "artifactTriggers", "closeoutPolicy", "tools", "signals", "outputs", "planningIntent", "questionPolicy", "execution"]);
 const PROMPT_KEYS = /* @__PURE__ */ new Set(["system", "task", "templates"]);
 const TOOL_KEYS = /* @__PURE__ */ new Set(["allowed", "denied"]);
 const SIGNAL_KEYS = /* @__PURE__ */ new Set(["subscribesTo", "publishes"]);
 const SUBSCRIPTION_KEYS = /* @__PURE__ */ new Set(["contract", "groupScope", "filters", "cardinality", "producerPolicy", "quorum"]);
 const OUTPUT_KEYS = /* @__PURE__ */ new Set(["messageTypes", "modelMutations"]);
-const EXECUTION_KEYS = /* @__PURE__ */ new Set(["requiredCapabilities", "maxRuntimeSeconds", "preparationSeconds", "closeoutSeconds", "closeoutWarningSeconds", "maxRetries", "verificationRequired", "maxTotalTokens", "warningTokens", "maxCostAmount", "costCurrency", "nativeLimits", "pricingGeneration", "enforcementConfidence", "allowedPaths", "forbiddenPaths"]);
+const EXECUTION_KEYS = /* @__PURE__ */ new Set(["reasoningEffort", "maxRuntimeSeconds", "preparationSeconds", "closeoutSeconds", "closeoutWarningSeconds", "maxRetries", "verificationRequired", "maxTotalTokens", "warningTokens", "maxCostAmount", "costCurrency", "nativeLimits", "pricingGeneration", "enforcementConfidence", "allowedPaths", "forbiddenPaths"]);
 const CONTENT_ACCESS_KEYS = /* @__PURE__ */ new Set(["content", "commit", "repository", "network", "shell"]);
 const MODEL_PERMISSION_KEYS = /* @__PURE__ */ new Set(["operations", "filters"]);
 const QUESTION_KEYS = /* @__PURE__ */ new Set(["defaultAnswerPolicy", "blockExecutionWhenCreated"]);
@@ -67,9 +67,9 @@ function validateAgentActivityProfilesConfiguration(value) {
     validateContentAccess(raw.permissions, `${path}.permissions`, add);
     if (raw.authorityPresets !== void 0 && (!strings(raw.authorityPresets) || raw.authorityPresets.some((preset) => !["messaging", "direction", "influence", "estimation", "plan-contribution", "source-execution", "review-authority", "reporting"].includes(preset)))) add("agent_activity_authority_presets_invalid", `${path}.authorityPresets`, "authorityPresets must contain supported unique preset ids.");
     for (const key of ["contextQueryRefs", "contextQuerySetRefs", "instructionTemplateRefs"]) if (raw[key] !== void 0 && !exactRefs(raw[key])) add("agent_activity_revision_refs_invalid", `${path}.${key}`, `${path}.${key} must contain unique exact id and revision references.`);
+    validateCapabilityRequirements(raw.capabilityRequirements, `${path}.capabilityRequirements`, add);
     validateArtifactTriggers(raw.artifactTriggers, `${path}.artifactTriggers`, add);
     validateCloseoutPolicy(raw.closeoutPolicy, `${path}.closeoutPolicy`, add);
-    validateProviderOverrides(raw.providerOverrides, `${path}.providerOverrides`, add);
     validateQuestionPolicy(raw.questionPolicy, `${path}.questionPolicy`, add);
     validateExecution(raw.execution, `${path}.execution`, add);
     if (typeof raw.enabled === "boolean" && typeof raw.handler === "string" && record(raw.tools) && record(raw.outputs) && record(raw.branchPolicy)) {
@@ -217,16 +217,28 @@ function validateCloseoutPolicy(value, path, add) {
   if (value.warningSeconds !== void 0 && (!Number.isInteger(value.warningSeconds) || Number(value.warningSeconds) < 1)) add("agent_activity_closeout_warning_invalid", `${path}.warningSeconds`, "warningSeconds must be positive.");
   if (value.requiredArtifactKinds !== void 0 && !strings(value.requiredArtifactKinds)) add("agent_activity_string_list_invalid", `${path}.requiredArtifactKinds`, "requiredArtifactKinds must contain unique non-empty strings.");
 }
-function validateProviderOverrides(value, path, add) {
-  if (value === void 0) return;
-  if (!record(value)) {
-    add("agent_activity_provider_overrides_invalid", path, "providerOverrides must be an object.");
+function validateCapabilityRequirements(value, path, add) {
+  if (value === void 0) {
+    add("agent_activity_capability_requirements_required", path, "capabilityRequirements is required.");
     return;
   }
-  unknownKeys(value, /* @__PURE__ */ new Set(["requiredCapabilities", "disallowedProviderIds", "promptRef", "instructionTemplateRefs", "maxRuntimeSeconds", "maxTotalTokens", "maxCostAmount"]), path, add);
-  for (const key of ["requiredCapabilities", "disallowedProviderIds"]) if (value[key] !== void 0 && !strings(value[key])) add("agent_activity_string_list_invalid", `${path}.${key}`, `${key} must contain unique non-empty strings.`);
-  if (value.instructionTemplateRefs !== void 0 && !exactRefs(value.instructionTemplateRefs)) add("agent_activity_revision_refs_invalid", `${path}.instructionTemplateRefs`, "instructionTemplateRefs must contain unique exact id and revision references.");
-  if (value.promptRef !== void 0 && (typeof value.promptRef !== "string" || !value.promptRef.trim())) add("agent_activity_provider_prompt_invalid", `${path}.promptRef`, "promptRef must be non-empty.");
+  if (!Array.isArray(value) || value.length === 0) {
+    add("agent_activity_capability_requirements_required", path, "capabilityRequirements must be a non-empty array.");
+    return;
+  }
+  value.forEach((candidate, index) => {
+    const itemPath = `${path}[${index}]`;
+    if (!record(candidate)) {
+      add("agent_activity_capability_requirement_invalid", itemPath, "Capability requirement must be an object.");
+      return;
+    }
+    unknownKeys(candidate, /* @__PURE__ */ new Set(["capabilityId", "versionRange", "requirement", "alternativeGroup", "requiredFeatures", "configuration"]), itemPath, add);
+    if (typeof candidate.capabilityId !== "string" || !/^(?:treeseed\.|provider\.)/u.test(candidate.capabilityId)) add("agent_activity_capability_id_invalid", `${itemPath}.capabilityId`, "capabilityId must use a TreeSeed or provider namespace.");
+    if (typeof candidate.versionRange !== "string" || !candidate.versionRange.trim()) add("agent_activity_capability_version_invalid", `${itemPath}.versionRange`, "versionRange is required.");
+    if (!["required", "preferred"].includes(String(candidate.requirement))) add("agent_activity_capability_requirement_invalid", `${itemPath}.requirement`, "requirement must be required or preferred.");
+    if (candidate.requiredFeatures !== void 0 && !strings(candidate.requiredFeatures)) add("agent_activity_capability_features_invalid", `${itemPath}.requiredFeatures`, "requiredFeatures must contain unique values.");
+    if (candidate.configuration !== void 0 && !record(candidate.configuration)) add("agent_activity_capability_configuration_invalid", `${itemPath}.configuration`, "configuration must be an object.");
+  });
 }
 function validateQuestionPolicy(value, path, add) {
   if (value === void 0) return;
@@ -251,7 +263,8 @@ function validateExecution(value, path, add) {
     return;
   }
   unknownKeys(value, EXECUTION_KEYS, path, add);
-  for (const key of ["requiredCapabilities", "allowedPaths", "forbiddenPaths"]) if (value[key] !== void 0 && !strings(value[key])) add("agent_activity_string_list_invalid", `${path}.${key}`, `${path}.${key} must contain unique non-empty strings.`);
+  for (const key of ["allowedPaths", "forbiddenPaths"]) if (value[key] !== void 0 && !strings(value[key])) add("agent_activity_string_list_invalid", `${path}.${key}`, `${path}.${key} must contain unique non-empty strings.`);
+  if (value.reasoningEffort !== void 0 && !["minimal", "low", "medium", "high", "xhigh"].includes(String(value.reasoningEffort))) add("agent_activity_reasoning_effort_invalid", `${path}.reasoningEffort`, "reasoningEffort must be minimal, low, medium, high, or xhigh.");
   if (value.maxRuntimeSeconds !== void 0 && (!Number.isInteger(value.maxRuntimeSeconds) || Number(value.maxRuntimeSeconds) < 1)) add("agent_activity_runtime_invalid", `${path}.maxRuntimeSeconds`, "maxRuntimeSeconds must be a positive integer.");
   if (value.closeoutWarningSeconds !== void 0 && (!Number.isInteger(value.closeoutWarningSeconds) || Number(value.closeoutWarningSeconds) < 1)) add("agent_activity_closeout_warning_invalid", `${path}.closeoutWarningSeconds`, "closeoutWarningSeconds must be a positive integer.");
   if (value.preparationSeconds !== void 0 && (!Number.isInteger(value.preparationSeconds) || Number(value.preparationSeconds) < 1)) add("agent_activity_preparation_duration_invalid", `${path}.preparationSeconds`, "preparationSeconds must be a positive integer.");