@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,19 +1,14 @@
|
|
|
1
1
|
import { z } from "zod";
|
|
2
|
+
import { conditionalFields, minimumProperties, uniqueArray } from "../../content/validation/schema-constraints.js";
|
|
2
3
|
import { AGENT_CONTENT_MODELS, AGENT_TOOL_GROUPS } from "../../types/agents.js";
|
|
3
4
|
const identifier = z.string().trim().min(1).max(200).regex(/^[A-Za-z0-9][A-Za-z0-9._:/-]*$/u);
|
|
4
|
-
const
|
|
5
|
+
const agentClassSchema = z.string().min(1).max(100).regex(/^[a-z][a-z0-9-]*$/u);
|
|
5
6
|
const nonEmpty = z.string().trim().min(1);
|
|
6
|
-
const unique = (item) => z.array(item)
|
|
7
|
-
|
|
8
|
-
|
|
9
|
-
}
|
|
10
|
-
});
|
|
11
|
-
const dependenciesSchema = z.object({
|
|
12
|
-
agents: unique(agentClass).optional(),
|
|
7
|
+
const unique = (item) => uniqueArray(z.array(item));
|
|
8
|
+
const dependenciesSchema = minimumProperties(z.object({
|
|
9
|
+
agents: unique(agentClassSchema).optional(),
|
|
13
10
|
events: unique(z.literal("workday-closing")).optional()
|
|
14
|
-
}).strict()
|
|
15
|
-
message: "At least one dependency selector is required."
|
|
16
|
-
});
|
|
11
|
+
}).strict(), 1, "At least one dependency selector property is required.");
|
|
17
12
|
const permissionSetSchema = z.object({
|
|
18
13
|
content: z.object({
|
|
19
14
|
read: unique(z.enum(AGENT_CONTENT_MODELS)),
|
|
@@ -33,35 +28,32 @@ const activityProfileSchema = z.object({
|
|
|
33
28
|
additionalContext: unique(identifier).optional(),
|
|
34
29
|
parameters: z.record(z.unknown()).optional()
|
|
35
30
|
}).strict();
|
|
36
|
-
const activityProfilesSchema = z.object({
|
|
31
|
+
const activityProfilesSchema = minimumProperties(z.object({
|
|
37
32
|
planning: activityProfileSchema.optional(),
|
|
38
33
|
estimating: activityProfileSchema.optional(),
|
|
39
34
|
acting: activityProfileSchema.optional(),
|
|
40
35
|
reviewing: activityProfileSchema.optional(),
|
|
41
36
|
reporting: activityProfileSchema.optional(),
|
|
42
37
|
chat: activityProfileSchema.optional()
|
|
43
|
-
}).strict()
|
|
44
|
-
|
|
45
|
-
});
|
|
46
|
-
const agentDefinitionSchema = z.object({
|
|
38
|
+
}).strict(), 1, "At least one activity profile is required.");
|
|
39
|
+
const agentDefinitionSchema = conditionalFields(z.object({
|
|
47
40
|
schemaVersion: z.literal("treeseed.agent/v1"),
|
|
48
41
|
id: identifier,
|
|
49
42
|
name: nonEmpty,
|
|
50
|
-
agentClass,
|
|
43
|
+
agentClass: agentClassSchema,
|
|
44
|
+
groupIds: unique(identifier).optional(),
|
|
51
45
|
purpose: nonEmpty,
|
|
52
46
|
responsibilities: z.array(nonEmpty).min(1),
|
|
53
|
-
capabilities:
|
|
54
|
-
context: z.object({ include:
|
|
47
|
+
capabilities: uniqueArray(z.array(identifier).min(1, "At least one capability is required.")),
|
|
48
|
+
context: z.object({ include: uniqueArray(z.array(identifier).min(1)) }).strict(),
|
|
55
49
|
activityProfiles: activityProfilesSchema
|
|
56
|
-
}).strict()
|
|
57
|
-
|
|
58
|
-
|
|
59
|
-
|
|
60
|
-
|
|
61
|
-
|
|
62
|
-
|
|
63
|
-
}
|
|
64
|
-
});
|
|
50
|
+
}).strict(), [{
|
|
51
|
+
field: "agentClass",
|
|
52
|
+
notEquals: "reviewer",
|
|
53
|
+
forbidden: { field: "activityProfiles", key: "reviewing" },
|
|
54
|
+
path: ["activityProfiles", "reviewing"],
|
|
55
|
+
message: "Only the Reviewer agent class may enable reviewing."
|
|
56
|
+
}]);
|
|
65
57
|
function issuePath(path) {
|
|
66
58
|
return path.reduce((current, segment) => typeof segment === "number" ? `${current}[${segment}]` : current ? `${current}.${String(segment)}` : String(segment), "");
|
|
67
59
|
}
|
|
@@ -82,7 +74,9 @@ function validateAgentDefinitionModel(value) {
|
|
|
82
74
|
export {
|
|
83
75
|
activityProfileSchema,
|
|
84
76
|
activityProfilesSchema,
|
|
77
|
+
agentClassSchema,
|
|
85
78
|
agentDefinitionSchema,
|
|
86
79
|
diagnosticsFromZod,
|
|
80
|
+
permissionSetSchema,
|
|
87
81
|
validateAgentDefinitionModel
|
|
88
82
|
};
|
|
@@ -157,13 +157,13 @@ export declare const agentForensicPayloadSchema: z.ZodObject<{
|
|
|
157
157
|
severity: "error" | "warning" | "info";
|
|
158
158
|
}>, "many">>;
|
|
159
159
|
}, "strict", z.ZodTypeAny, {
|
|
160
|
+
activity: AgentActivityEvent;
|
|
160
161
|
diagnostics: {
|
|
161
162
|
code: string;
|
|
162
163
|
path: string;
|
|
163
164
|
message: string;
|
|
164
165
|
severity: "error" | "warning" | "info";
|
|
165
166
|
}[];
|
|
166
|
-
activity: AgentActivityEvent;
|
|
167
167
|
contract: "treeseed.agent-forensic-payload/v1";
|
|
168
168
|
payload?: Record<string, unknown> | undefined;
|
|
169
169
|
transcript?: {
|
|
@@ -1,3 +1,5 @@
|
|
|
1
|
+
import { assignmentAttemptSchema, assignmentResultSchema } from "../contracts/capacity/assignments/agent-execution.js";
|
|
2
|
+
import { isDeepStrictEqual } from "node:util";
|
|
1
3
|
const ASSIGNMENT_STATUSES = /* @__PURE__ */ new Set(["pending", "leased", "running", "completed", "failed", "returned", "expired", "cancelled"]);
|
|
2
4
|
const LEASE_STATES = /* @__PURE__ */ new Set(["unleased", "leased", "released", "expired"]);
|
|
3
5
|
const SYNTHESIS_SOURCES = /* @__PURE__ */ new Set(["living_execution_graph"]);
|
|
@@ -48,6 +50,49 @@ function validateProviderAssignment(value) {
|
|
|
48
50
|
validateCapacityEnvelope(assignment.capacityEnvelope, "capacityEnvelope", diagnostics);
|
|
49
51
|
if (!timestamp(assignment.createdAt)) push(diagnostics, "provider_assignment_timestamp_invalid", "createdAt", "createdAt must be an ISO timestamp.");
|
|
50
52
|
if (!timestamp(assignment.updatedAt)) push(diagnostics, "provider_assignment_timestamp_invalid", "updatedAt", "updatedAt must be an ISO timestamp.");
|
|
53
|
+
const parsed = assignmentAttemptSchema.safeParse(assignment.assignmentAttempt);
|
|
54
|
+
if (!parsed.success || !isDeepStrictEqual(parsed.data, assignment.assignmentAttempt)) {
|
|
55
|
+
push(diagnostics, "provider_assignment_contract_invalid", "assignmentAttempt", "A complete unchanged canonical attempt is required.");
|
|
56
|
+
} else {
|
|
57
|
+
const attempt = parsed.data, envelope = record(assignment.capacityEnvelope);
|
|
58
|
+
const expected = {
|
|
59
|
+
id: attempt.id,
|
|
60
|
+
teamId: attempt.teamId,
|
|
61
|
+
projectId: attempt.projectId,
|
|
62
|
+
workDayId: attempt.workdayId,
|
|
63
|
+
capacityProviderId: attempt.provider.providerId,
|
|
64
|
+
executionProviderId: attempt.provider.executionProviderId,
|
|
65
|
+
reservationId: attempt.reservationId,
|
|
66
|
+
executionNodeId: attempt.nodeId,
|
|
67
|
+
executionNodeRevision: attempt.nodeRevision,
|
|
68
|
+
graphRevision: attempt.graphRevision,
|
|
69
|
+
attemptCount: attempt.attempt,
|
|
70
|
+
createdAt: attempt.createdAt
|
|
71
|
+
};
|
|
72
|
+
for (const [field, value2] of Object.entries(expected)) if (assignment[field] !== value2) {
|
|
73
|
+
push(diagnostics, "provider_assignment_contract_invalid", field, "Operational identity contradicts its immutable canonical attempt.");
|
|
74
|
+
}
|
|
75
|
+
for (const field of [
|
|
76
|
+
"teamId",
|
|
77
|
+
"projectId",
|
|
78
|
+
"workDayId",
|
|
79
|
+
"mode",
|
|
80
|
+
"projectAgentClassId",
|
|
81
|
+
"capacityProviderId",
|
|
82
|
+
"executionProviderId",
|
|
83
|
+
"reservationId"
|
|
84
|
+
]) if (envelope[field] !== assignment[field]) {
|
|
85
|
+
push(diagnostics, "provider_assignment_contract_invalid", `capacityEnvelope.${field}`, "The admitted capacity envelope contradicts its owning record.");
|
|
86
|
+
}
|
|
87
|
+
const suppliedResult = assignment.assignmentResult;
|
|
88
|
+
if (assignment.status === "completed" || suppliedResult !== void 0 && suppliedResult !== null) {
|
|
89
|
+
const result = assignmentResultSchema.safeParse(suppliedResult);
|
|
90
|
+
const failedCloseout = result.success && result.data.status === "failed" && ["failed", "cancelled", "expired"].includes(String(assignment.status));
|
|
91
|
+
if (!result.success || !isDeepStrictEqual(result.data, suppliedResult) || result.data.assignmentId !== attempt.id || (assignment.status === "completed" ? result.data.status !== "completed" : ["failed", "returned", "expired", "cancelled"].includes(String(assignment.status)) && result.data.status === "completed") || Date.parse(result.data.completedAt) < Date.parse(attempt.startedAt ?? attempt.createdAt) || failedCloseout && (!timestamp(assignment.failedAt) || Date.parse(result.data.completedAt) > Date.parse(String(assignment.failedAt))) || Date.parse(result.data.completedAt) > Date.parse(attempt.finishedAt ?? (failedCloseout ? String(assignment.failedAt) : attempt.deadline)) || !failedCloseout && Date.parse(result.data.completedAt) > Date.parse(attempt.deadline) || timestamp(assignment.completedAt) && Date.parse(result.data.completedAt) > Date.parse(String(assignment.completedAt))) {
|
|
92
|
+
push(diagnostics, "provider_assignment_contract_invalid", "assignmentResult", "The canonical result must belong to this attempt and its original interval and disposition.");
|
|
93
|
+
}
|
|
94
|
+
}
|
|
95
|
+
}
|
|
51
96
|
return { ok: diagnostics.length === 0, diagnostics };
|
|
52
97
|
}
|
|
53
98
|
function assertProviderAssignment(value) {
|
|
@@ -1,6 +1,7 @@
|
|
|
1
1
|
export type { ProjectAgentClass, ProjectAgentClassStatus } from '../../agent-capacity/contracts/projects/agents/project-agent-class.js';
|
|
2
2
|
export type { AgentDefinition, AgentActivityProfile } from '../../types/agents.js';
|
|
3
3
|
export * from '../../agent-capacity/grant.js';
|
|
4
|
+
export * from '../../agent-capacity/contracts/capacity/assignments/assignment-path.js';
|
|
4
5
|
export * from '../../agent-capacity/validation/index.js';
|
|
5
6
|
export * from '../../agent-capacity/contracts/capacity/assignments/assignment-records.js';
|
|
6
7
|
export * from '../../agent-capacity/contracts/capacity/assignments/assignment-context-pack.js';
|
|
@@ -1,4 +1,5 @@
|
|
|
1
1
|
export * from "../../agent-capacity/grant.js";
|
|
2
|
+
export * from "../../agent-capacity/contracts/capacity/assignments/assignment-path.js";
|
|
2
3
|
export * from "../../agent-capacity/validation/index.js";
|
|
3
4
|
export * from "../../agent-capacity/contracts/capacity/assignments/assignment-records.js";
|
|
4
5
|
export * from "../../agent-capacity/contracts/capacity/assignments/assignment-context-pack.js";
|