@treeseed/sdk 0.13.0-rc.122 → 0.13.0-rc.124

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.
Files changed (126) hide show
  1. package/dist/agent-capacity/contracts/capacity/assignments/agent-execution.d.ts +1392 -974
  2. package/dist/agent-capacity/contracts/capacity/assignments/agent-execution.js +72 -27
  3. package/dist/agent-capacity/contracts/capacity/assignments/assignment-context-pack.d.ts +34 -34
  4. package/dist/agent-capacity/contracts/capacity/assignments/assignment-path.d.ts +2 -0
  5. package/dist/agent-capacity/contracts/capacity/assignments/assignment-path.js +13 -0
  6. package/dist/agent-capacity/contracts/capacity/assignments/assignment-records.d.ts +1 -0
  7. package/dist/agent-capacity/contracts/capacity/providers/supply-policy.d.ts +126 -1
  8. package/dist/agent-capacity/contracts/capacity/providers/supply-policy.js +35 -1
  9. package/dist/agent-capacity/contracts/capacity/workdays/assignment-allocation.d.ts +1 -3
  10. package/dist/agent-capacity/contracts/capacity/workdays/assignment-allocation.js +21 -15
  11. package/dist/agent-capacity/contracts/capacity/workdays/capability-accounting.d.ts +3 -42
  12. package/dist/agent-capacity/contracts/capacity/workdays/capability-accounting.js +8 -8
  13. package/dist/agent-capacity/contracts/capacity/workdays/workday-allocation.d.ts +227 -66
  14. package/dist/agent-capacity/contracts/capacity/workdays/workday-allocation.js +54 -19
  15. package/dist/agent-capacity/contracts/capacity/workdays/workday-records.d.ts +214 -5
  16. package/dist/agent-capacity/contracts/capacity/workdays/workday-records.js +19 -0
  17. package/dist/agent-capacity/contracts/operations/agent-team-clone.d.ts +47 -47
  18. package/dist/agent-capacity/contracts/projects/agents/project-agent-class.d.ts +119 -0
  19. package/dist/agent-capacity/contracts/projects/agents/project-agent-class.js +16 -0
  20. package/dist/agent-capacity/contracts/support/execution-graph.d.ts +434 -230
  21. package/dist/agent-capacity/contracts/support/execution-graph.js +20 -18
  22. package/dist/agent-capacity/contracts/support/financial-records.d.ts +2 -0
  23. package/dist/agent-capacity/validation/agent-definition-schema.d.ts +286 -254
  24. package/dist/agent-capacity/validation/agent-definition-schema.js +22 -28
  25. package/dist/agent-capacity/validation/agent-lab-forensics-schema.d.ts +1 -1
  26. package/dist/agent-capacity/validation/assignment-records.js +45 -0
  27. package/dist/capacity/agents/agent-capacity.d.ts +1 -0
  28. package/dist/capacity/agents/agent-capacity.js +1 -0
  29. package/dist/capacity-provider/capability-ontology.d.ts +102 -102
  30. package/dist/capacity-provider/client.d.ts +14 -7
  31. package/dist/capacity-provider/client.js +1 -4
  32. package/dist/capacity-provider/contracts/capacity-facts.d.ts +0 -1
  33. package/dist/capacity-provider/contracts/environment-profiles.d.ts +40 -40
  34. package/dist/capacity-provider/contracts/governance.d.ts +2 -17
  35. package/dist/capacity-provider/contracts/index.d.ts +2 -0
  36. package/dist/capacity-provider/contracts/index.js +2 -0
  37. package/dist/capacity-provider/core-capability-catalog.d.ts +7 -7
  38. package/dist/capacity-provider/environment-catalog.d.ts +22 -22
  39. package/dist/capacity-provider/environment-catalog.js +1 -1
  40. package/dist/capacity-provider/install-configuration.d.ts +4 -4
  41. package/dist/capacity-provider/sandbox-contracts.d.ts +54 -54
  42. package/dist/capacity-provider/source-workspace.d.ts +76 -76
  43. package/dist/capacity-provider/validation.d.ts +10 -2
  44. package/dist/capacity-provider/validation.js +52 -22
  45. package/dist/content/validation/agent-operational-content-schemas.d.ts +120 -118
  46. package/dist/content/validation/agent-operational-content-schemas.js +2 -0
  47. package/dist/content/validation/auxiliary-content-schemas.d.ts +92 -92
  48. package/dist/content/validation/content-model-schemas.d.ts +3155 -2512
  49. package/dist/content/validation/content-model-schemas.js +97 -87
  50. package/dist/content/validation/portable-content-data.d.ts +173 -168
  51. package/dist/content/validation/schema-constraints.d.ts +78 -0
  52. package/dist/content/validation/schema-constraints.js +149 -0
  53. package/dist/deployment/ai/storage.d.ts +20 -20
  54. package/dist/deployment/ai-hosting.d.ts +12 -12
  55. package/dist/deployment/ai-instance.d.ts +12 -12
  56. package/dist/deployment/ai-mode.d.ts +34 -34
  57. package/dist/deployment/hosted-topology-template.d.ts +25 -25
  58. package/dist/deployment/hosted-topology.d.ts +146 -146
  59. package/dist/deployment/postgres/transfer.d.ts +2 -2
  60. package/dist/deployment/schemas.d.ts +504 -504
  61. package/dist/development/schemas.d.ts +325 -325
  62. package/dist/graph/context-query-contracts.js +1 -1
  63. package/dist/guarantees/index.d.ts +26 -2
  64. package/dist/identity/contracts.js +6 -1
  65. package/dist/operator-contracts/canonical-command-tree.js +22 -8
  66. package/dist/operator-contracts/catalog/agents/agent-team-clone-operations.d.ts +27 -27
  67. package/dist/operator-contracts/catalog/capability-ontology-operations.d.ts +25 -25
  68. package/dist/operator-contracts/catalog/commands/command-tree-builders.d.ts +11 -9
  69. package/dist/operator-contracts/catalog/communication-operations.d.ts +108 -90
  70. package/dist/operator-contracts/catalog/hosted-topology-operations.d.ts +33 -33
  71. package/dist/operator-contracts/catalog/inbox-operations.d.ts +27 -27
  72. package/dist/operator-contracts/catalog/infrastructure/ai-instance-operations.d.ts +4 -4
  73. package/dist/operator-contracts/catalog/infrastructure/ai-instance-operations.js +2 -1
  74. package/dist/operator-contracts/catalog/knowledge-share-operations.d.ts +5 -5
  75. package/dist/operator-contracts/catalog/provider-environment-operations.d.ts +3 -3
  76. package/dist/operator-contracts/catalog/services/secret-operations.d.ts +16 -8
  77. package/dist/operator-contracts/catalog/services/secret-operations.js +2 -1
  78. package/dist/operator-contracts/catalog/workdays/profile-operations.d.ts +11 -11
  79. package/dist/operator-contracts/catalog/workdays/selection-commands.js +7 -6
  80. package/dist/operator-contracts/communication/contracts.d.ts +340 -198
  81. package/dist/operator-contracts/communication/contracts.js +6 -1
  82. package/dist/operator-contracts/control-plane-operation.d.ts +7 -0
  83. package/dist/operator-contracts/control-plane-operation.js +6 -0
  84. package/dist/operator-contracts/control-plane-operations.d.ts +469 -442
  85. package/dist/operator-contracts/control-plane-operations.js +26 -10
  86. package/dist/operator-contracts/inbox/contracts.d.ts +100 -100
  87. package/dist/operator-contracts/knowledge/contracts.d.ts +6 -6
  88. package/dist/operator-contracts/mcp.js +4 -3
  89. package/dist/operator-contracts/workday-lifecycle.d.ts +192 -2
  90. package/dist/operator-contracts/workday-lifecycle.js +108 -45
  91. package/dist/platform/agent-schema-verification.js +316 -33
  92. package/dist/platform/contracts.d.ts +72 -72
  93. package/dist/platform/schemas.d.ts +144 -36
  94. package/dist/platform/schemas.js +26 -0
  95. package/dist/platform/verification.js +4 -0
  96. package/dist/sdk-types/support/sdk-search-request.d.ts +2 -2
  97. package/dist/secrets-capability/secret-contracts.d.ts +2 -2
  98. package/dist/secrets-capability/shared-access.d.ts +1 -1
  99. package/dist/secrets-capability/shared-resources.d.ts +30 -30
  100. package/dist/security/encrypted-envelope.d.ts +6 -6
  101. package/dist/treedx/client.d.ts +4 -4
  102. package/dist/treedx/index.d.ts +1 -1
  103. package/dist/treedx/index.js +1 -0
  104. package/dist/treedx/types.d.ts +286 -0
  105. package/dist/treedx/types.js +44 -0
  106. package/dist/types/agents/agent-activity-profile.d.ts +1 -0
  107. package/guarantees/agent/golden/component-boundaries.guarantee.yaml +12 -0
  108. package/guarantees/agent/golden/product-custody.guarantee.yaml +12 -0
  109. package/guarantees/agent/golden/product.guarantee.yaml +12 -0
  110. package/guarantees/agent/golden/scenes/component-boundaries.scene.yaml +837 -0
  111. package/guarantees/agent/golden/scenes/product-custody.scene.yaml +53 -0
  112. package/guarantees/agent/golden/scenes/product.scene.yaml +8 -0
  113. package/guarantees/verifiers/golden.verifiers.yaml +1429 -0
  114. package/package.json +10 -5
  115. package/tests/acceptance/golden-product.test.ts +205 -0
  116. package/tests/acceptance/golden-product.ts +404 -0
  117. package/tests/acceptance/product/base-red.ts +73 -0
  118. package/tests/acceptance/product/documentation-examples.ts +68 -0
  119. package/tests/acceptance/product/intent-runtime.ts +145 -0
  120. package/tests/acceptance/product/release-output.ts +160 -0
  121. package/tests/acceptance/product/research-artifact.ts +87 -0
  122. package/tests/acceptance/product/research-revision.ts +82 -0
  123. package/tests/acceptance/product/research-source.ts +91 -0
  124. package/tests/acceptance/product/test-chain.ts +192 -0
  125. package/treeseed.package.yaml +147 -0
  126. package/dist/.treeseed-build-complete.json +0 -1
@@ -1,10 +1,13 @@
1
1
  import { validateResearchSourcePolicy } from "../agent-capacity/validation/research/source-policy.js";
2
+ import { capabilityAccountingLimitsSchema } from "../agent-capacity/contracts/capacity/workdays/capability-accounting.js";
2
3
  import {
3
4
  CAPACITY_PROVIDER_ACCESS_TOKEN_REFRESH_SECONDS,
4
5
  CAPACITY_PROVIDER_ACCESS_TOKEN_TTL_SECONDS,
5
6
  CAPACITY_PROVIDER_PROOF_TTL_SECONDS
6
- } from "./contracts/index.js";
7
+ } from "./contracts/governance.js";
7
8
  import { validateExecutionProviderRuntimeConfiguration } from "../ai-appliance/validation.js";
9
+ import { CORE_CAPABILITY_DEFINITIONS } from "./core-capability-catalog.js";
10
+ import { capabilityOfferSchema, capabilityOfferDigest } from "./capability-ontology.js";
8
11
  function result(diagnostics) {
9
12
  return { ok: diagnostics.length === 0, diagnostics };
10
13
  }
@@ -14,6 +17,38 @@ function add(diagnostics, code, path, message) {
14
17
  function nonEmpty(value) {
15
18
  return typeof value === "string" && value.trim().length > 0;
16
19
  }
20
+ function validateCapabilityOfferQualification(value, options = {}) {
21
+ const diagnostics = [], parsed = capabilityOfferSchema.safeParse(value);
22
+ if (!parsed.success) {
23
+ add(diagnostics, "provider_offer_invalid", "offer", "A complete canonical capability offer is required.");
24
+ return result(diagnostics);
25
+ }
26
+ const offer = parsed.data, { offerDigest, ...material } = offer;
27
+ if (capabilityOfferDigest(material) !== offerDigest) add(diagnostics, "provider_offer_digest_mismatch", "offer.offerDigest", "Offer digest does not bind its exact material.");
28
+ const now = (options.now ?? /* @__PURE__ */ new Date()).getTime(), definitions = options.definitions ?? CORE_CAPABILITY_DEFINITIONS;
29
+ const tiers = ["signed-attestation", "automated-suite", "reviewed-certification"], keys = /* @__PURE__ */ new Set();
30
+ const matches = (left, right) => left.id === right.id && left.version === right.version && left.digest === right.digest;
31
+ for (const reference of offer.capabilities) {
32
+ const key = `${reference.id}@${reference.version}`, receipts = offer.conformance.filter((receipt) => matches(receipt.capability, reference));
33
+ const definition = definitions.find((entry) => entry.id === reference.id && entry.version === reference.version);
34
+ if (keys.has(key) || !Number.isFinite(now) || receipts.length !== 1 || definition && (definition.status === "revoked" || definition.digest !== reference.digest) || !definition && (options.definitions !== void 0 || reference.id.startsWith("treeseed."))) {
35
+ add(diagnostics, "provider_offer_conformance_invalid", "offer.conformance", "Qualification requires unique exact current capability authority.");
36
+ }
37
+ keys.add(key);
38
+ for (const receipt of receipts) {
39
+ if (receipt.status !== "passed" || options.providerId !== void 0 && receipt.providerId !== options.providerId || receipt.tier !== "signed-attestation" && receipt.suite === null || Date.parse(receipt.issuedAt) > now || receipt.expiresAt !== null && (Date.parse(receipt.expiresAt) <= now || Date.parse(receipt.expiresAt) <= Date.parse(receipt.issuedAt))) {
40
+ add(diagnostics, "provider_offer_conformance_invalid", "offer.conformance", "Qualification must be passed, current and bind its provider and suite.");
41
+ }
42
+ if (definition && tiers.indexOf(receipt.tier) < tiers.indexOf(definition.qualificationTier)) {
43
+ add(diagnostics, "provider_offer_qualification_insufficient", "offer.conformance", "Qualification is below the declared capability tier.");
44
+ }
45
+ }
46
+ }
47
+ if (offer.conformance.some((receipt) => !offer.capabilities.some((reference) => matches(receipt.capability, reference)))) {
48
+ add(diagnostics, "provider_offer_conformance_invalid", "offer.conformance", "Orphan qualification receipts cannot be advertised.");
49
+ }
50
+ return result(diagnostics);
51
+ }
17
52
  function validateCapacityProviderPublicJwk(jwk) {
18
53
  const diagnostics = [];
19
54
  if (jwk?.kty !== "OKP") add(diagnostics, "provider_jwk_kty_invalid", "publicJwk.kty", "Provider identity key type must be OKP.");
@@ -48,11 +83,17 @@ function validateCapacityProviderProofPayload(payload, options = {}) {
48
83
  }
49
84
  function validateProviderSupplyOffer(offer, path = "offer") {
50
85
  const diagnostics = [];
51
- if (offer.weight !== void 0 && (!Number.isFinite(offer.weight) || offer.weight <= 0)) add(diagnostics, "provider_offer_weight_invalid", `${path}.weight`, "Offer weight must be greater than zero.");
52
- if (offer.sharePercent !== void 0 && (!Number.isFinite(offer.sharePercent) || offer.sharePercent <= 0 || offer.sharePercent > 100)) add(diagnostics, "provider_offer_share_invalid", `${path}.sharePercent`, "Offer share must be greater than zero and no more than 100.");
53
- if (offer.weight !== void 0 && offer.sharePercent !== void 0) add(diagnostics, "provider_offer_distribution_ambiguous", path, "Use either weight or sharePercent for one offer, not both.");
54
- if (offer.maxConcurrentRunners !== void 0 && (!Number.isInteger(offer.maxConcurrentRunners) || offer.maxConcurrentRunners < 1)) add(diagnostics, "provider_offer_concurrency_invalid", `${path}.maxConcurrentRunners`, "Connection concurrency must be a positive integer.");
55
- if (!Array.isArray(offer.capabilities) || offer.capabilities.some((entry) => !nonEmpty(entry))) add(diagnostics, "provider_offer_capabilities_invalid", `${path}.capabilities`, "Offer capabilities must be non-empty strings.");
86
+ if (!offer || typeof offer !== "object" || Array.isArray(offer)) {
87
+ add(diagnostics, "provider_offer_invalid", path, "A supply offer object is required.");
88
+ return result(diagnostics);
89
+ }
90
+ const weight = "weight" in offer ? offer.weight : void 0, share = "sharePercent" in offer ? offer.sharePercent : void 0;
91
+ const concurrency = "maxConcurrentRunners" in offer ? offer.maxConcurrentRunners : void 0;
92
+ if (weight !== void 0 && (typeof weight !== "number" || !Number.isFinite(weight) || weight <= 0)) add(diagnostics, "provider_offer_weight_invalid", `${path}.weight`, "Offer weight must be greater than zero.");
93
+ if (share !== void 0 && (typeof share !== "number" || !Number.isFinite(share) || share <= 0 || share > 100)) add(diagnostics, "provider_offer_share_invalid", `${path}.sharePercent`, "Offer share must be greater than zero and no more than 100.");
94
+ if (weight !== void 0 && share !== void 0) add(diagnostics, "provider_offer_distribution_ambiguous", path, "Use either weight or sharePercent for one offer, not both.");
95
+ if (concurrency !== void 0 && (typeof concurrency !== "number" || !Number.isInteger(concurrency) || concurrency < 1)) add(diagnostics, "provider_offer_concurrency_invalid", `${path}.maxConcurrentRunners`, "Connection concurrency must be a positive integer.");
96
+ if (!("capabilities" in offer) || !Array.isArray(offer.capabilities) || offer.capabilities.some((entry) => !nonEmpty(entry))) add(diagnostics, "provider_offer_capabilities_invalid", `${path}.capabilities`, "Offer capabilities must be non-empty strings.");
56
97
  return result(diagnostics);
57
98
  }
58
99
  function validateCapacityProviderManifestV5(manifest) {
@@ -105,21 +146,6 @@ function validateCapacityProviderManifestV5(manifest) {
105
146
  if (!Number.isInteger(lane.queueLimit) || lane.queueLimit < 0) add(diagnostics, "provider_lane_queue_limit_invalid", `${lanePath}.queueLimit`, "Lane queueLimit must be a non-negative integer.");
106
147
  if (!Number.isInteger(lane.timeoutSeconds) || lane.timeoutSeconds < 1) add(diagnostics, "provider_lane_timeout_invalid", `${lanePath}.timeoutSeconds`, "Lane timeoutSeconds must be a positive integer.");
107
148
  if (lane.capabilities && lane.capabilities.some((entry) => !nonEmpty(entry))) add(diagnostics, "provider_lane_capabilities_invalid", `${lanePath}.capabilities`, "Provider lane capabilities must be non-empty strings.");
108
- const minimumDuration = lane.minimumAssignmentDuration;
109
- if (minimumDuration !== void 0) {
110
- if (!Number.isInteger(minimumDuration.amount) || minimumDuration.amount < 1) add(diagnostics, "provider_lane_minimum_duration_invalid", `${lanePath}.minimumAssignmentDuration.amount`, "Minimum assignment duration amount must be a positive integer.");
111
- if (!["seconds", "business-days"].includes(minimumDuration.unit)) add(diagnostics, "provider_lane_minimum_duration_unit_invalid", `${lanePath}.minimumAssignmentDuration.unit`, "Minimum assignment duration unit must be seconds or business-days.");
112
- if (minimumDuration.unit === "business-days") {
113
- try {
114
- new Intl.DateTimeFormat("en", { timeZone: minimumDuration.calendar?.timeZone }).format();
115
- } catch {
116
- add(diagnostics, "provider_lane_minimum_duration_timezone_invalid", `${lanePath}.minimumAssignmentDuration.calendar.timeZone`, "Business-day duration requires a valid IANA time zone.");
117
- }
118
- const weekdays = minimumDuration.calendar?.weekdays ?? [1, 2, 3, 4, 5];
119
- if (!Array.isArray(weekdays) || weekdays.length === 0 || weekdays.some((day) => !Number.isInteger(day) || day < 1 || day > 7) || new Set(weekdays).size !== weekdays.length) add(diagnostics, "provider_lane_minimum_duration_weekdays_invalid", `${lanePath}.minimumAssignmentDuration.calendar.weekdays`, "Business weekdays must be unique ISO weekday numbers from 1 through 7.");
120
- if ((minimumDuration.calendar?.holidayDates ?? []).some((date) => !/^\d{4}-\d{2}-\d{2}$/u.test(date))) add(diagnostics, "provider_lane_minimum_duration_holidays_invalid", `${lanePath}.minimumAssignmentDuration.calendar.holidayDates`, "Business-day holidays must use YYYY-MM-DD dates.");
121
- }
122
- }
123
149
  }
124
150
  if (reservedWorkers > manifest?.capacity?.maxConcurrentWorkers) add(diagnostics, "provider_lane_reservations_exceed_capacity", "lanes", "Total reserved workers may not exceed provider capacity.");
125
151
  for (const purpose of ["communication", "platform", "workday"]) if (!purposes.has(purpose)) add(diagnostics, "provider_lane_purpose_required", "lanes", `Unified providers require a ${purpose} lane.`);
@@ -138,7 +164,7 @@ function validateCapacityProviderManifestV5(manifest) {
138
164
  if (!Array.isArray(adapter.laneIds) || adapter.laneIds.length === 0) add(diagnostics, "provider_adapter_lanes_required", `${path}.laneIds`, "Every adapter must serve at least one lane.");
139
165
  for (const laneId of adapter.laneIds ?? []) if (!laneIds.has(laneId)) add(diagnostics, "provider_adapter_lane_unknown", `${path}.laneIds`, `Adapter references unknown lane ${laneId}.`);
140
166
  for (const bindingId of adapter.credentialProfiles ?? []) if (!bindingIds.has(bindingId)) add(diagnostics, "provider_adapter_credential_unknown", `${path}.credentialProfiles`, `Adapter references unknown credential profile ${bindingId}.`);
141
- if (!adapter.nativeLimits || typeof adapter.nativeLimits !== "object" || Array.isArray(adapter.nativeLimits)) add(diagnostics, "provider_adapter_limits_invalid", `${path}.nativeLimits`, "Adapter nativeLimits must be an object.");
167
+ if (!adapter.nativeLimits || typeof adapter.nativeLimits !== "object" || Array.isArray(adapter.nativeLimits) || (adapter.offers?.length || ["modelConfigurationId", "dailyActiveSecondsLimit", "capabilityLimits"].some((key) => Object.hasOwn(adapter.nativeLimits, key))) && !capabilityAccountingLimitsSchema.safeParse(adapter.nativeLimits).success) add(diagnostics, "provider_adapter_limits_invalid", `${path}.nativeLimits`, "Adapter nativeLimits must contain valid shared-model and capability accounting bounds.");
142
168
  for (const entry of validateExecutionProviderRuntimeConfiguration(adapter, path).diagnostics) add(diagnostics, entry.code, entry.path, entry.message);
143
169
  if (adapter.researchSourcePolicy !== void 0) for (const diagnostic of validateResearchSourcePolicy(adapter.researchSourcePolicy).diagnostics) add(diagnostics, diagnostic.code, `${path}.researchSourcePolicy.${diagnostic.path}`, diagnostic.message);
144
170
  }
@@ -197,6 +223,9 @@ function validateCapacityProviderManifestV5(manifest) {
197
223
  if (!profiles.has(binding.sandboxProfileId)) add(diagnostics, "provider_offer_sandbox_unknown", `${path}.sandboxProfileId`, "Offer references an unknown provider-local sandbox profile.");
198
224
  if (binding.offer.capabilities.some((reference) => !reference.id.startsWith("treeseed.") && !reference.id.startsWith("provider."))) add(diagnostics, "provider_offer_capability_namespace_invalid", `${path}.offer.capabilities`, "Offers require standardized TreeSeed or provider capability references.");
199
225
  if (binding.offer.conformance.some((entry) => entry.status !== "passed")) add(diagnostics, "provider_offer_conformance_failed", `${path}.offer.conformance`, "Only passing capability conformance may be advertised.");
226
+ if (!validateCapabilityOfferQualification(binding.offer).ok) {
227
+ add(diagnostics, "provider_offer_conformance_invalid", `${path}.offer.conformance`, "Capability qualification must be unique, current, and satisfy its declared tier and suite.");
228
+ }
200
229
  }
201
230
  }
202
231
  return result(diagnostics);
@@ -213,6 +242,7 @@ export {
213
242
  capacityProviderSecurityDefaults,
214
243
  nonEmpty,
215
244
  result,
245
+ validateCapabilityOfferQualification,
216
246
  validateCapacityProviderManifestV5,
217
247
  validateCapacityProviderProofPayload,
218
248
  validateCapacityProviderPublicJwk,