@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,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 agentClass = z.string().trim().min(1).max(100).regex(/^[a-z][a-z0-9-]*$/u);
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).superRefine((items, context) => {
7
- if (new Set(items.map((value) => JSON.stringify(value))).size !== items.length) {
8
- context.addIssue({ code: z.ZodIssueCode.custom, message: "Values must be unique." });
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().refine((value) => Boolean(value.agents?.length || value.events?.length), {
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().refine((value) => Object.keys(value).length > 0, {
44
- message: "At least one activity profile is required."
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: unique(identifier).refine((value) => value.length > 0, "At least one capability is required."),
54
- context: z.object({ include: unique(identifier).refine((value) => value.length > 0) }).strict(),
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().superRefine((agent, context) => {
57
- if (agent.agentClass !== "reviewer" && agent.activityProfiles.reviewing) {
58
- context.addIssue({
59
- code: z.ZodIssueCode.custom,
60
- path: ["activityProfiles", "reviewing"],
61
- message: "Only the Reviewer agent class may enable reviewing."
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";