@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.
- package/dist/agent-capacity/contracts/capacity/assignments/agent-execution.d.ts +1392 -974
- package/dist/agent-capacity/contracts/capacity/assignments/agent-execution.js +72 -27
- package/dist/agent-capacity/contracts/capacity/assignments/assignment-context-pack.d.ts +34 -34
- package/dist/agent-capacity/contracts/capacity/assignments/assignment-path.d.ts +2 -0
- package/dist/agent-capacity/contracts/capacity/assignments/assignment-path.js +13 -0
- package/dist/agent-capacity/contracts/capacity/assignments/assignment-records.d.ts +1 -0
- package/dist/agent-capacity/contracts/capacity/providers/supply-policy.d.ts +126 -1
- package/dist/agent-capacity/contracts/capacity/providers/supply-policy.js +35 -1
- package/dist/agent-capacity/contracts/capacity/workdays/assignment-allocation.d.ts +1 -3
- package/dist/agent-capacity/contracts/capacity/workdays/assignment-allocation.js +21 -15
- package/dist/agent-capacity/contracts/capacity/workdays/capability-accounting.d.ts +3 -42
- package/dist/agent-capacity/contracts/capacity/workdays/capability-accounting.js +8 -8
- package/dist/agent-capacity/contracts/capacity/workdays/workday-allocation.d.ts +227 -66
- package/dist/agent-capacity/contracts/capacity/workdays/workday-allocation.js +54 -19
- package/dist/agent-capacity/contracts/capacity/workdays/workday-records.d.ts +214 -5
- package/dist/agent-capacity/contracts/capacity/workdays/workday-records.js +19 -0
- package/dist/agent-capacity/contracts/operations/agent-team-clone.d.ts +47 -47
- package/dist/agent-capacity/contracts/projects/agents/project-agent-class.d.ts +119 -0
- package/dist/agent-capacity/contracts/projects/agents/project-agent-class.js +16 -0
- package/dist/agent-capacity/contracts/support/execution-graph.d.ts +434 -230
- package/dist/agent-capacity/contracts/support/execution-graph.js +20 -18
- package/dist/agent-capacity/contracts/support/financial-records.d.ts +2 -0
- package/dist/agent-capacity/validation/agent-definition-schema.d.ts +286 -254
- package/dist/agent-capacity/validation/agent-definition-schema.js +22 -28
- package/dist/agent-capacity/validation/agent-lab-forensics-schema.d.ts +1 -1
- package/dist/agent-capacity/validation/assignment-records.js +45 -0
- package/dist/capacity/agents/agent-capacity.d.ts +1 -0
- package/dist/capacity/agents/agent-capacity.js +1 -0
- package/dist/capacity-provider/capability-ontology.d.ts +102 -102
- package/dist/capacity-provider/client.d.ts +14 -7
- package/dist/capacity-provider/client.js +1 -4
- package/dist/capacity-provider/contracts/capacity-facts.d.ts +0 -1
- package/dist/capacity-provider/contracts/environment-profiles.d.ts +40 -40
- package/dist/capacity-provider/contracts/governance.d.ts +2 -17
- package/dist/capacity-provider/contracts/index.d.ts +2 -0
- package/dist/capacity-provider/contracts/index.js +2 -0
- package/dist/capacity-provider/core-capability-catalog.d.ts +7 -7
- package/dist/capacity-provider/environment-catalog.d.ts +22 -22
- package/dist/capacity-provider/environment-catalog.js +1 -1
- package/dist/capacity-provider/install-configuration.d.ts +4 -4
- package/dist/capacity-provider/sandbox-contracts.d.ts +54 -54
- package/dist/capacity-provider/source-workspace.d.ts +76 -76
- package/dist/capacity-provider/validation.d.ts +10 -2
- package/dist/capacity-provider/validation.js +52 -22
- package/dist/content/validation/agent-operational-content-schemas.d.ts +120 -118
- package/dist/content/validation/agent-operational-content-schemas.js +2 -0
- package/dist/content/validation/auxiliary-content-schemas.d.ts +92 -92
- package/dist/content/validation/content-model-schemas.d.ts +3155 -2512
- package/dist/content/validation/content-model-schemas.js +97 -87
- package/dist/content/validation/portable-content-data.d.ts +173 -168
- package/dist/content/validation/schema-constraints.d.ts +78 -0
- package/dist/content/validation/schema-constraints.js +149 -0
- package/dist/deployment/ai/storage.d.ts +20 -20
- package/dist/deployment/ai-hosting.d.ts +12 -12
- package/dist/deployment/ai-instance.d.ts +12 -12
- package/dist/deployment/ai-mode.d.ts +34 -34
- package/dist/deployment/hosted-topology-template.d.ts +25 -25
- package/dist/deployment/hosted-topology.d.ts +146 -146
- package/dist/deployment/postgres/transfer.d.ts +2 -2
- package/dist/deployment/schemas.d.ts +504 -504
- package/dist/development/schemas.d.ts +325 -325
- package/dist/graph/context-query-contracts.js +1 -1
- package/dist/guarantees/index.d.ts +26 -2
- package/dist/identity/contracts.js +6 -1
- package/dist/operator-contracts/canonical-command-tree.js +22 -8
- package/dist/operator-contracts/catalog/agents/agent-team-clone-operations.d.ts +27 -27
- package/dist/operator-contracts/catalog/capability-ontology-operations.d.ts +25 -25
- package/dist/operator-contracts/catalog/commands/command-tree-builders.d.ts +11 -9
- package/dist/operator-contracts/catalog/communication-operations.d.ts +108 -90
- package/dist/operator-contracts/catalog/hosted-topology-operations.d.ts +33 -33
- package/dist/operator-contracts/catalog/inbox-operations.d.ts +27 -27
- package/dist/operator-contracts/catalog/infrastructure/ai-instance-operations.d.ts +4 -4
- package/dist/operator-contracts/catalog/infrastructure/ai-instance-operations.js +2 -1
- package/dist/operator-contracts/catalog/knowledge-share-operations.d.ts +5 -5
- package/dist/operator-contracts/catalog/provider-environment-operations.d.ts +3 -3
- package/dist/operator-contracts/catalog/services/secret-operations.d.ts +16 -8
- package/dist/operator-contracts/catalog/services/secret-operations.js +2 -1
- package/dist/operator-contracts/catalog/workdays/profile-operations.d.ts +11 -11
- package/dist/operator-contracts/catalog/workdays/selection-commands.js +7 -6
- package/dist/operator-contracts/communication/contracts.d.ts +340 -198
- package/dist/operator-contracts/communication/contracts.js +6 -1
- package/dist/operator-contracts/control-plane-operation.d.ts +7 -0
- package/dist/operator-contracts/control-plane-operation.js +6 -0
- package/dist/operator-contracts/control-plane-operations.d.ts +469 -442
- package/dist/operator-contracts/control-plane-operations.js +26 -10
- package/dist/operator-contracts/inbox/contracts.d.ts +100 -100
- package/dist/operator-contracts/knowledge/contracts.d.ts +6 -6
- package/dist/operator-contracts/mcp.js +4 -3
- package/dist/operator-contracts/workday-lifecycle.d.ts +192 -2
- package/dist/operator-contracts/workday-lifecycle.js +108 -45
- package/dist/platform/agent-schema-verification.js +316 -33
- package/dist/platform/contracts.d.ts +72 -72
- package/dist/platform/schemas.d.ts +144 -36
- package/dist/platform/schemas.js +26 -0
- package/dist/platform/verification.js +4 -0
- package/dist/sdk-types/support/sdk-search-request.d.ts +2 -2
- package/dist/secrets-capability/secret-contracts.d.ts +2 -2
- package/dist/secrets-capability/shared-access.d.ts +1 -1
- package/dist/secrets-capability/shared-resources.d.ts +30 -30
- package/dist/security/encrypted-envelope.d.ts +6 -6
- package/dist/treedx/client.d.ts +4 -4
- package/dist/treedx/index.d.ts +1 -1
- package/dist/treedx/index.js +1 -0
- package/dist/treedx/types.d.ts +286 -0
- package/dist/treedx/types.js +44 -0
- package/dist/types/agents/agent-activity-profile.d.ts +1 -0
- package/guarantees/agent/golden/component-boundaries.guarantee.yaml +12 -0
- package/guarantees/agent/golden/product-custody.guarantee.yaml +12 -0
- package/guarantees/agent/golden/product.guarantee.yaml +12 -0
- package/guarantees/agent/golden/scenes/component-boundaries.scene.yaml +837 -0
- package/guarantees/agent/golden/scenes/product-custody.scene.yaml +53 -0
- package/guarantees/agent/golden/scenes/product.scene.yaml +8 -0
- package/guarantees/verifiers/golden.verifiers.yaml +1429 -0
- package/package.json +10 -5
- package/tests/acceptance/golden-product.test.ts +205 -0
- package/tests/acceptance/golden-product.ts +404 -0
- package/tests/acceptance/product/base-red.ts +73 -0
- package/tests/acceptance/product/documentation-examples.ts +68 -0
- package/tests/acceptance/product/intent-runtime.ts +145 -0
- package/tests/acceptance/product/release-output.ts +160 -0
- package/tests/acceptance/product/research-artifact.ts +87 -0
- package/tests/acceptance/product/research-revision.ts +82 -0
- package/tests/acceptance/product/research-source.ts +91 -0
- package/tests/acceptance/product/test-chain.ts +192 -0
- package/treeseed.package.yaml +147 -0
- 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/
|
|
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
|
|
52
|
-
|
|
53
|
-
|
|
54
|
-
|
|
55
|
-
|
|
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
|
|
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,
|