@treeseed/sdk 0.13.0-rc.121 → 0.13.0-rc.123

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 (157) hide show
  1. package/dist/agent-capacity/contracts/capacity/assignments/agent-execution.d.ts +2365 -1275
  2. package/dist/agent-capacity/contracts/capacity/assignments/agent-execution.js +94 -28
  3. package/dist/agent-capacity/contracts/capacity/assignments/assignment-context-pack.d.ts +38 -38
  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 +2 -59
  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 +2 -4
  10. package/dist/agent-capacity/contracts/capacity/workdays/assignment-allocation.js +22 -16
  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 +244 -85
  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 +216 -70
  16. package/dist/agent-capacity/contracts/capacity/workdays/workday-records.js +19 -0
  17. package/dist/agent-capacity/contracts/configuration/configuration.d.ts +1 -1
  18. package/dist/agent-capacity/contracts/configuration/configuration.js +0 -2
  19. package/dist/agent-capacity/contracts/operations/agent-team-clone.d.ts +55 -55
  20. package/dist/agent-capacity/contracts/projects/agents/project-agent-class.d.ts +119 -23
  21. package/dist/agent-capacity/contracts/projects/agents/project-agent-class.js +16 -0
  22. package/dist/agent-capacity/contracts/runtime/runtime-observability.d.ts +2 -154
  23. package/dist/agent-capacity/contracts/support/agent-atlas.d.ts +0 -13
  24. package/dist/agent-capacity/contracts/support/execution-graph.d.ts +496 -292
  25. package/dist/agent-capacity/contracts/support/execution-graph.js +21 -19
  26. package/dist/agent-capacity/contracts/support/financial-records.d.ts +3 -6
  27. package/dist/agent-capacity/contracts/support/planning-records.d.ts +1 -87
  28. package/dist/agent-capacity/grant.d.ts +34 -0
  29. package/dist/agent-capacity/grant.js +4 -0
  30. package/dist/agent-capacity/validation/agent-definition-schema.d.ts +1178 -1152
  31. package/dist/agent-capacity/validation/agent-definition-schema.js +21 -28
  32. package/dist/agent-capacity/validation/agent-lab-forensics-schema.d.ts +10 -10
  33. package/dist/agent-capacity/validation/agent-lab-forensics-schema.js +0 -1
  34. package/dist/agent-capacity/validation/assignment-records.d.ts +1 -6
  35. package/dist/agent-capacity/validation/assignment-records.js +49 -35
  36. package/dist/agent-capacity/validation/configuration.d.ts +1 -1
  37. package/dist/agent-capacity/validation/configuration.js +2 -6
  38. package/dist/agent-capacity/validation/grant.d.ts +11 -0
  39. package/dist/agent-capacity/validation/grant.js +31 -0
  40. package/dist/capacity/agents/agent-capacity.d.ts +3 -4
  41. package/dist/capacity/agents/agent-capacity.js +2 -3
  42. package/dist/capacity-provider/capability-ontology.d.ts +150 -150
  43. package/dist/capacity-provider/client.d.ts +15 -9
  44. package/dist/capacity-provider/client.js +1 -10
  45. package/dist/capacity-provider/contracts/capacity-facts.d.ts +0 -1
  46. package/dist/capacity-provider/contracts/environment-profiles.d.ts +44 -44
  47. package/dist/capacity-provider/contracts/governance.d.ts +2 -17
  48. package/dist/capacity-provider/contracts/index.d.ts +2 -0
  49. package/dist/capacity-provider/contracts/index.js +2 -0
  50. package/dist/capacity-provider/core-capability-catalog.d.ts +7 -7
  51. package/dist/capacity-provider/environment-catalog.d.ts +188 -188
  52. package/dist/capacity-provider/environment-catalog.js +1 -1
  53. package/dist/capacity-provider/install-configuration.d.ts +2 -2
  54. package/dist/capacity-provider/sandbox-contracts.d.ts +92 -92
  55. package/dist/capacity-provider/source-workspace.d.ts +166 -68
  56. package/dist/capacity-provider/source-workspace.js +5 -1
  57. package/dist/capacity-provider/validation.d.ts +10 -2
  58. package/dist/capacity-provider/validation.js +52 -22
  59. package/dist/content/validation/agent-operational-content-schemas.d.ts +144 -142
  60. package/dist/content/validation/agent-operational-content-schemas.js +2 -0
  61. package/dist/content/validation/auxiliary-content-schemas.d.ts +158 -158
  62. package/dist/content/validation/content-model-schemas.d.ts +9105 -5295
  63. package/dist/content/validation/content-model-schemas.js +192 -115
  64. package/dist/content/validation/portable-content-data.d.ts +411 -238
  65. package/dist/content/validation/portable-content-data.js +6 -1
  66. package/dist/content/validation/schema-constraints.d.ts +78 -0
  67. package/dist/content/validation/schema-constraints.js +149 -0
  68. package/dist/deployment/ai/storage.d.ts +24 -24
  69. package/dist/deployment/ai-hosting.d.ts +18 -18
  70. package/dist/deployment/ai-instance.d.ts +16 -16
  71. package/dist/deployment/ai-mode.d.ts +92 -92
  72. package/dist/deployment/hosted-topology-template.d.ts +44 -44
  73. package/dist/deployment/hosted-topology.d.ts +335 -335
  74. package/dist/deployment/postgres/contracts.d.ts +52 -52
  75. package/dist/deployment/postgres/transfer.d.ts +6 -6
  76. package/dist/deployment/schemas.d.ts +1114 -1114
  77. package/dist/development/schemas.d.ts +633 -633
  78. package/dist/graph/context-query-contracts.js +1 -1
  79. package/dist/guarantees/index.d.ts +26 -2
  80. package/dist/identity/contracts.js +6 -1
  81. package/dist/knowledge/contracts.d.ts +9 -2
  82. package/dist/knowledge/contracts.js +2 -2
  83. package/dist/model-registry/discussion-models.js +0 -1
  84. package/dist/operator-contracts/canonical-command-tree.js +25 -9
  85. package/dist/operator-contracts/catalog/agents/agent-team-clone-operations.d.ts +29 -29
  86. package/dist/operator-contracts/catalog/capability-ontology-operations.d.ts +30 -30
  87. package/dist/operator-contracts/catalog/commands/command-tree-builders.d.ts +15 -13
  88. package/dist/operator-contracts/catalog/communication-operations.d.ts +176 -158
  89. package/dist/operator-contracts/catalog/hosted-topology-operations.d.ts +67 -67
  90. package/dist/operator-contracts/catalog/inbox-operations.d.ts +65 -65
  91. package/dist/operator-contracts/catalog/infrastructure/ai-instance-operations.d.ts +6 -6
  92. package/dist/operator-contracts/catalog/infrastructure/ai-instance-operations.js +2 -1
  93. package/dist/operator-contracts/catalog/knowledge-share-operations.d.ts +10 -10
  94. package/dist/operator-contracts/catalog/provider-environment-operations.d.ts +3 -3
  95. package/dist/operator-contracts/catalog/services/secret-operations.d.ts +16 -8
  96. package/dist/operator-contracts/catalog/services/secret-operations.js +2 -1
  97. package/dist/operator-contracts/catalog/workdays/profile-operations.d.ts +11 -11
  98. package/dist/operator-contracts/catalog/workdays/selection-commands.js +3 -0
  99. package/dist/operator-contracts/communication/contracts.d.ts +537 -395
  100. package/dist/operator-contracts/communication/contracts.js +6 -1
  101. package/dist/operator-contracts/control-plane-operation.d.ts +7 -0
  102. package/dist/operator-contracts/control-plane-operation.js +6 -0
  103. package/dist/operator-contracts/control-plane-operations.d.ts +631 -610
  104. package/dist/operator-contracts/control-plane-operations.js +26 -12
  105. package/dist/operator-contracts/inbox/contracts.d.ts +229 -229
  106. package/dist/operator-contracts/knowledge/contracts.d.ts +16 -16
  107. package/dist/operator-contracts/mcp.js +4 -3
  108. package/dist/operator-contracts/workday-lifecycle.d.ts +192 -0
  109. package/dist/operator-contracts/workday-lifecycle.js +109 -45
  110. package/dist/platform/agent-schema-verification.d.ts +3 -0
  111. package/dist/platform/agent-schema-verification.js +377 -0
  112. package/dist/platform/contracts.d.ts +72 -72
  113. package/dist/platform/schemas.d.ts +144 -36
  114. package/dist/platform/schemas.js +26 -0
  115. package/dist/platform/verification.js +10 -0
  116. package/dist/sdk-types/support/planning-policy.d.ts +1 -1
  117. package/dist/sdk-types/support/sdk-search-request.d.ts +2 -2
  118. package/dist/secrets-capability/secret-contracts.d.ts +2 -2
  119. package/dist/secrets-capability/shared-access.d.ts +3 -3
  120. package/dist/secrets-capability/shared-resources.d.ts +50 -50
  121. package/dist/secrets-capability/vault-contracts.d.ts +2 -2
  122. package/dist/security/encrypted-envelope.d.ts +14 -14
  123. package/dist/treedx/client.d.ts +4 -4
  124. package/dist/treedx/index.d.ts +1 -1
  125. package/dist/treedx/index.js +1 -0
  126. package/dist/treedx/types.d.ts +286 -0
  127. package/dist/treedx/types.js +44 -0
  128. package/guarantees/agent/golden/component-boundaries.guarantee.yaml +12 -0
  129. package/guarantees/agent/golden/product-custody.guarantee.yaml +12 -0
  130. package/guarantees/agent/golden/product.guarantee.yaml +12 -0
  131. package/guarantees/agent/golden/scenes/component-boundaries.scene.yaml +837 -0
  132. package/guarantees/agent/golden/scenes/product-custody.scene.yaml +53 -0
  133. package/guarantees/agent/golden/scenes/product.scene.yaml +8 -0
  134. package/guarantees/verifiers/golden.verifiers.yaml +1429 -0
  135. package/package.json +9 -3
  136. package/tests/acceptance/golden-product.test.ts +205 -0
  137. package/tests/acceptance/golden-product.ts +404 -0
  138. package/tests/acceptance/product/base-red.ts +73 -0
  139. package/tests/acceptance/product/documentation-examples.ts +68 -0
  140. package/tests/acceptance/product/intent-runtime.ts +145 -0
  141. package/tests/acceptance/product/release-output.ts +160 -0
  142. package/tests/acceptance/product/research-artifact.ts +87 -0
  143. package/tests/acceptance/product/research-revision.ts +82 -0
  144. package/tests/acceptance/product/research-source.ts +91 -0
  145. package/tests/acceptance/product/test-chain.ts +192 -0
  146. package/treeseed.package.yaml +147 -0
  147. package/dist/.treeseed-build-complete.json +0 -1
  148. package/dist/agent-capacity/allocation.d.ts +0 -183
  149. package/dist/agent-capacity/allocation.js +0 -5
  150. package/dist/agent-capacity/artifact-mutation-receipt.d.ts +0 -49
  151. package/dist/agent-capacity/artifact-mutation-receipt.js +0 -36
  152. package/dist/agent-capacity/artifacts.d.ts +0 -123
  153. package/dist/agent-capacity/artifacts.js +0 -39
  154. package/dist/agent-capacity/contracts/support/decision-work.d.ts +0 -227
  155. package/dist/agent-capacity/contracts/support/decision-work.js +0 -0
  156. package/dist/agent-capacity/validation/allocation.d.ts +0 -12
  157. package/dist/agent-capacity/validation/allocation.js +0 -115
@@ -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,31 @@ 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,
51
44
  purpose: nonEmpty,
52
45
  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(),
46
+ capabilities: uniqueArray(z.array(identifier).min(1, "At least one capability is required.")),
47
+ context: z.object({ include: uniqueArray(z.array(identifier).min(1)) }).strict(),
55
48
  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
- });
49
+ }).strict(), [{
50
+ field: "agentClass",
51
+ notEquals: "reviewer",
52
+ forbidden: { field: "activityProfiles", key: "reviewing" },
53
+ path: ["activityProfiles", "reviewing"],
54
+ message: "Only the Reviewer agent class may enable reviewing."
55
+ }]);
65
56
  function issuePath(path) {
66
57
  return path.reduce((current, segment) => typeof segment === "number" ? `${current}[${segment}]` : current ? `${current}.${String(segment)}` : String(segment), "");
67
58
  }
@@ -82,7 +73,9 @@ function validateAgentDefinitionModel(value) {
82
73
  export {
83
74
  activityProfileSchema,
84
75
  activityProfilesSchema,
76
+ agentClassSchema,
85
77
  agentDefinitionSchema,
86
78
  diagnosticsFromZod,
79
+ permissionSetSchema,
87
80
  validateAgentDefinitionModel
88
81
  };
@@ -13,15 +13,15 @@ export declare const agentActivityQuerySchema: z.ZodObject<{
13
13
  after: number;
14
14
  type?: string | string[] | undefined;
15
15
  agent?: string | string[] | undefined;
16
- severity?: string | string[] | undefined;
17
16
  agentClass?: string | string[] | undefined;
17
+ severity?: string | string[] | undefined;
18
18
  }, {
19
19
  type?: string | string[] | undefined;
20
20
  agent?: string | string[] | undefined;
21
+ agentClass?: string | string[] | undefined;
22
+ severity?: string | string[] | undefined;
21
23
  limit?: number | undefined;
22
24
  after?: number | undefined;
23
- severity?: string | string[] | undefined;
24
- agentClass?: string | string[] | undefined;
25
25
  }>;
26
26
  export declare const agentActivityPageSchema: z.ZodObject<{
27
27
  items: z.ZodArray<z.ZodType<AgentActivityEvent, z.ZodTypeDef, AgentActivityEvent>, "many">;
@@ -43,24 +43,24 @@ export declare const agentReplayRequestSchema: z.ZodEffects<z.ZodObject<{
43
43
  includeDiagnostics: boolean;
44
44
  includePayloads: boolean;
45
45
  at?: string | undefined;
46
- cursor?: string | null | undefined;
47
46
  workdayId?: string | undefined;
47
+ cursor?: string | null | undefined;
48
48
  }, {
49
49
  at?: string | undefined;
50
- cursor?: string | null | undefined;
51
50
  workdayId?: string | undefined;
51
+ cursor?: string | null | undefined;
52
52
  includeDiagnostics?: boolean | undefined;
53
53
  includePayloads?: boolean | undefined;
54
54
  }>, {
55
55
  includeDiagnostics: boolean;
56
56
  includePayloads: boolean;
57
57
  at?: string | undefined;
58
- cursor?: string | null | undefined;
59
58
  workdayId?: string | undefined;
59
+ cursor?: string | null | undefined;
60
60
  }, {
61
61
  at?: string | undefined;
62
- cursor?: string | null | undefined;
63
62
  workdayId?: string | undefined;
63
+ cursor?: string | null | undefined;
64
64
  includeDiagnostics?: boolean | undefined;
65
65
  includePayloads?: boolean | undefined;
66
66
  }>;
@@ -179,13 +179,13 @@ export declare const agentForensicPayloadSchema: z.ZodObject<{
179
179
  }, {
180
180
  activity: AgentActivityEvent;
181
181
  contract: "treeseed.agent-forensic-payload/v1";
182
- payload?: Record<string, unknown> | undefined;
183
182
  diagnostics?: {
184
183
  code: string;
185
184
  path: string;
186
185
  message: string;
187
186
  severity: "error" | "warning" | "info";
188
187
  }[] | undefined;
188
+ payload?: Record<string, unknown> | undefined;
189
189
  transcript?: {
190
190
  entries: Record<string, unknown>[];
191
191
  page: {
@@ -208,8 +208,8 @@ export declare function parseAgentActivityQuery(value: unknown): {
208
208
  after: number;
209
209
  type?: string | string[] | undefined;
210
210
  agent?: string | string[] | undefined;
211
- severity?: string | string[] | undefined;
212
211
  agentClass?: string | string[] | undefined;
212
+ severity?: string | string[] | undefined;
213
213
  };
214
214
  export declare function parseAgentActivityPage(value: unknown): {
215
215
  items: AgentActivityEvent[];
@@ -219,8 +219,8 @@ export declare function parseAgentReplayRequest(value: unknown): {
219
219
  includeDiagnostics: boolean;
220
220
  includePayloads: boolean;
221
221
  at?: string | undefined;
222
- cursor?: string | null | undefined;
223
222
  workdayId?: string | undefined;
223
+ cursor?: string | null | undefined;
224
224
  };
225
225
  export declare function parseAgentTranscriptPayload(value: unknown): {
226
226
  entries: Record<string, unknown>[];
@@ -12,7 +12,6 @@ const agentActivityEventSchema = z.object({
12
12
  projectId: optionalId,
13
13
  workdayId: nonEmpty,
14
14
  assignmentId: optionalId,
15
- modeRunId: optionalId,
16
15
  executionRunId: optionalId,
17
16
  agentId: optionalId,
18
17
  agentClassId: optionalId,
@@ -1,4 +1,4 @@
1
- import type { AgentModeRun, ProviderAssignment } from '../contracts/capacity/assignments/assignment-records.js';
1
+ import type { ProviderAssignment } from '../contracts/capacity/assignments/assignment-records.js';
2
2
  export interface AssignmentRecordDiagnostic {
3
3
  code: string;
4
4
  path: string;
@@ -9,8 +9,3 @@ export declare function validateProviderAssignment(value: unknown): {
9
9
  diagnostics: AssignmentRecordDiagnostic[];
10
10
  };
11
11
  export declare function assertProviderAssignment(value: unknown): ProviderAssignment;
12
- export declare function validateAgentModeRun(value: unknown): {
13
- ok: boolean;
14
- diagnostics: AssignmentRecordDiagnostic[];
15
- };
16
- export declare function assertAgentModeRun(value: unknown): AgentModeRun;
@@ -1,7 +1,8 @@
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
- const MODE_RUN_STATUSES = /* @__PURE__ */ new Set(["queued", "running", "succeeded", "failed", "cancelled"]);
4
- const SYNTHESIS_SOURCES = /* @__PURE__ */ new Set(["approved_decision", "planning_input_request", "capacity_plan", "living_execution_graph", "workday_demand", "verification_failure", "fallback_queue"]);
5
+ const SYNTHESIS_SOURCES = /* @__PURE__ */ new Set(["living_execution_graph"]);
5
6
  function record(value) {
6
7
  return value !== null && typeof value === "object" && !Array.isArray(value) ? value : {};
7
8
  }
@@ -38,21 +39,60 @@ function validateProviderAssignment(value) {
38
39
  if (!LEASE_STATES.has(String(assignment.leaseState ?? ""))) push(diagnostics, "provider_assignment_lease_state_invalid", "leaseState", "leaseState is invalid.");
39
40
  if (!Number.isInteger(assignment.attemptCount) || Number(assignment.attemptCount) < 0) push(diagnostics, "provider_assignment_attempt_count_invalid", "attemptCount", "attemptCount must be a nonnegative integer.");
40
41
  if (assignment.synthesizedFrom != null && !SYNTHESIS_SOURCES.has(String(assignment.synthesizedFrom))) push(diagnostics, "provider_assignment_synthesis_source_invalid", "synthesizedFrom", "synthesizedFrom is invalid.");
42
+ if (Object.hasOwn(assignment, "decisionInput")) push(diagnostics, "provider_assignment_retired_input", "decisionInput", "Use the immutable assignmentAttempt instead.");
43
+ if (Object.hasOwn(assignment, "allocationSetId")) push(diagnostics, "provider_assignment_retired_allocation", "allocationSetId", "Use the living-graph reservation instead.");
41
44
  for (const field of ["leaseExpiresAt", "leaseRenewedAt", "assignedAt", "claimedAt", "completedAt", "returnedAt", "failedAt"]) {
42
45
  if (!optionalTimestamp(assignment[field])) push(diagnostics, "provider_assignment_timestamp_invalid", field, `${field} must be an ISO timestamp when provided.`);
43
46
  }
44
- for (const field of ["capacityEnvelope", "decisionInput", "workspaceContext", "allowedOutputs", "explanation", "lifecycleOutput", "metadata"]) {
47
+ for (const field of ["capacityEnvelope", "workspaceContext", "allowedOutputs", "explanation", "lifecycleOutput", "metadata"]) {
45
48
  if (!jsonRecord(assignment[field])) push(diagnostics, "provider_assignment_json_invalid", field, `${field} must be an object.`);
46
49
  }
47
50
  validateCapacityEnvelope(assignment.capacityEnvelope, "capacityEnvelope", diagnostics);
48
- const decisionInput = record(assignment.decisionInput);
49
- for (const field of ["teamId", "projectId", "projectAgentClassId"]) {
50
- if (!present(decisionInput[field])) push(diagnostics, "decision_execution_input_field_invalid", `decisionInput.${field}`, `${field} is required.`);
51
- }
52
- if (decisionInput.mode !== "planning" && decisionInput.mode !== "acting") push(diagnostics, "decision_execution_input_mode_invalid", "decisionInput.mode", "mode must be planning or acting.");
53
- if (!jsonRecord(decisionInput.input)) push(diagnostics, "decision_execution_input_json_invalid", "decisionInput.input", "input must be an object.");
54
51
  if (!timestamp(assignment.createdAt)) push(diagnostics, "provider_assignment_timestamp_invalid", "createdAt", "createdAt must be an ISO timestamp.");
55
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
+ }
56
96
  return { ok: diagnostics.length === 0, diagnostics };
57
97
  }
58
98
  function assertProviderAssignment(value) {
@@ -60,33 +100,7 @@ function assertProviderAssignment(value) {
60
100
  if (!result.ok) throw new Error(`Invalid provider assignment: ${result.diagnostics.map((entry) => `${entry.code} at ${entry.path}`).join(", ")}`);
61
101
  return value;
62
102
  }
63
- function validateAgentModeRun(value) {
64
- const modeRun = record(value);
65
- const diagnostics = [];
66
- for (const field of ["id", "teamId", "projectId", "providerAssignmentId", "capacityProviderId", "projectAgentClassId", "createdAt", "updatedAt"]) {
67
- if (!present(modeRun[field])) push(diagnostics, "agent_mode_run_field_invalid", field, `${field} is required.`);
68
- }
69
- if (modeRun.mode !== "planning" && modeRun.mode !== "acting") push(diagnostics, "agent_mode_run_mode_invalid", "mode", "mode must be planning or acting.");
70
- if (!MODE_RUN_STATUSES.has(String(modeRun.status ?? ""))) push(diagnostics, "agent_mode_run_status_invalid", "status", "status is invalid.");
71
- for (const field of ["selectedInput", "capacityEnvelope", "outputs", "traceRefs", "usageActual", "validation", "metadata"]) {
72
- if (!jsonRecord(modeRun[field])) push(diagnostics, "agent_mode_run_json_invalid", field, `${field} must be an object.`);
73
- }
74
- validateCapacityEnvelope(modeRun.capacityEnvelope, "capacityEnvelope", diagnostics);
75
- for (const field of ["startedAt", "completedAt", "failedAt"]) {
76
- if (!optionalTimestamp(modeRun[field])) push(diagnostics, "agent_mode_run_timestamp_invalid", field, `${field} must be an ISO timestamp when provided.`);
77
- }
78
- if (!timestamp(modeRun.createdAt)) push(diagnostics, "agent_mode_run_timestamp_invalid", "createdAt", "createdAt must be an ISO timestamp.");
79
- if (!timestamp(modeRun.updatedAt)) push(diagnostics, "agent_mode_run_timestamp_invalid", "updatedAt", "updatedAt must be an ISO timestamp.");
80
- return { ok: diagnostics.length === 0, diagnostics };
81
- }
82
- function assertAgentModeRun(value) {
83
- const result = validateAgentModeRun(value);
84
- if (!result.ok) throw new Error(`Invalid agent mode run: ${result.diagnostics.map((entry) => `${entry.code} at ${entry.path}`).join(", ")}`);
85
- return value;
86
- }
87
103
  export {
88
- assertAgentModeRun,
89
104
  assertProviderAssignment,
90
- validateAgentModeRun,
91
105
  validateProviderAssignment
92
106
  };
@@ -10,5 +10,5 @@ export interface CapacityConfigurationValidation {
10
10
  diagnostics: CapacityConfigurationDiagnostic[];
11
11
  }
12
12
  export declare function validateProjectAgentClassConfiguration(value: unknown): CapacityConfigurationValidation;
13
- export type ProjectAgentClassConfiguration = Pick<ProjectAgentClass, 'id' | 'slug' | 'name' | 'status' | 'allowedModes' | 'kernelProfile' | 'kernelPolicy' | 'handlerRefs' | 'outputContracts' | 'metadata'>;
13
+ export type ProjectAgentClassConfiguration = Pick<ProjectAgentClass, 'id' | 'slug' | 'name' | 'status' | 'handlerRefs' | 'metadata'>;
14
14
  export type PortableActivityProfilesConfiguration = AgentActivityProfilesConfiguration;
@@ -1,20 +1,16 @@
1
1
  function record(value) {
2
2
  return Boolean(value) && typeof value === "object" && !Array.isArray(value);
3
3
  }
4
- function strings(value) {
5
- return Array.isArray(value) && value.every((entry) => typeof entry === "string" && entry.trim().length > 0) && new Set(value).size === value.length;
6
- }
7
4
  function validateProjectAgentClassConfiguration(value) {
8
5
  const diagnostics = [];
9
6
  const add = (code, path, message) => diagnostics.push({ code, path, message });
10
7
  if (!record(value)) return { ok: false, diagnostics: [{ code: "project_agent_class_configuration_invalid", path: "", message: "Project agent class configuration must be an object." }] };
11
- const allowed = /* @__PURE__ */ new Set(["id", "slug", "name", "status", "allowedModes", "kernelProfile", "kernelPolicy", "handlerRefs", "outputContracts", "metadata"]);
8
+ const allowed = /* @__PURE__ */ new Set(["id", "slug", "name", "status", "handlerRefs", "metadata"]);
12
9
  for (const key of Object.keys(value)) if (!allowed.has(key)) add("project_agent_class_configuration_unknown_field", key, `Unknown project agent class field ${key}.`);
13
10
  for (const key of ["id", "slug"]) if (typeof value[key] !== "string" || !String(value[key]).trim()) add("project_agent_class_configuration_field_required", key, `${key} is required.`);
14
11
  if (value.name !== void 0 && (typeof value.name !== "string" || !value.name.trim())) add("project_agent_class_configuration_name_invalid", "name", "name must be a non-empty string.");
15
12
  if (value.status !== void 0 && !["active", "paused", "archived"].includes(String(value.status))) add("project_agent_class_configuration_status_invalid", "status", "status is invalid.");
16
- if (!strings(value.allowedModes) || value.allowedModes.some((mode) => mode !== "planning" && mode !== "acting")) add("project_agent_class_configuration_modes_invalid", "allowedModes", "allowedModes must contain unique planning and/or acting values.");
17
- for (const key of ["kernelProfile", "kernelPolicy", "handlerRefs", "outputContracts", "metadata"]) if (value[key] !== void 0 && !record(value[key])) add("project_agent_class_configuration_object_invalid", key, `${key} must be an object.`);
13
+ for (const key of ["handlerRefs", "metadata"]) if (value[key] !== void 0 && !record(value[key])) add("project_agent_class_configuration_object_invalid", key, `${key} must be an object.`);
18
14
  return { ok: diagnostics.length === 0, diagnostics };
19
15
  }
20
16
  export {
@@ -0,0 +1,11 @@
1
+ import type { CapacityGrantV2 } from '../grant.js';
2
+ export interface CapacityGrantDiagnostic {
3
+ code: string;
4
+ path: string;
5
+ message: string;
6
+ }
7
+ export interface CapacityGrantValidation {
8
+ ok: boolean;
9
+ diagnostics: CapacityGrantDiagnostic[];
10
+ }
11
+ export declare function validateCapacityGrantV2(grant: CapacityGrantV2): CapacityGrantValidation;
@@ -0,0 +1,31 @@
1
+ function validateCapacityGrantV2(grant) {
2
+ const diagnostics = [];
3
+ const add = (code, path, message) => diagnostics.push({ code, path, message });
4
+ for (const [path, value] of [["id", grant.id], ["membershipId", grant.membershipId], ["teamId", grant.teamId], ["providerId", grant.providerId], ["projectId", grant.projectId], ["environment", grant.environment]]) {
5
+ if (!value?.trim()) add("capacity_grant_field_required", path, `${path} is required.`);
6
+ }
7
+ if (grant.schemaVersion !== 2) add("capacity_grant_schema_invalid", "schemaVersion", "Grant schemaVersion must be 2.");
8
+ if (!Array.isArray(grant.allowedModes) || grant.allowedModes.length === 0 || grant.allowedModes.some((mode) => !["planning", "acting"].includes(mode))) add("capacity_grant_modes_invalid", "allowedModes", "Grant allowedModes must contain planning and/or acting.");
9
+ for (const [path, values] of [["executionProviderIds", grant.executionProviderIds], ["laneIds", grant.laneIds], ["capabilities", grant.capabilities]]) {
10
+ if (!Array.isArray(values) || values.some((value) => !value?.trim()) || new Set(values).size !== values.length) add("capacity_grant_list_invalid", path, `${path} must contain unique non-empty strings.`);
11
+ }
12
+ for (const [path, value] of [["dailyAgentSecondsLimit", grant.dailyAgentSecondsLimit], ["monthlyAgentSecondsLimit", grant.monthlyAgentSecondsLimit]]) {
13
+ if (value != null && (!Number.isFinite(value) || value < 0)) add("capacity_grant_limit_invalid", path, `${path} must be zero or greater when configured.`);
14
+ }
15
+ if (grant.maxConcurrentAssignments != null && (!Number.isInteger(grant.maxConcurrentAssignments) || grant.maxConcurrentAssignments < 0)) add("capacity_grant_concurrency_invalid", "maxConcurrentAssignments", "maxConcurrentAssignments must be a non-negative integer when configured.");
16
+ if (grant.budgetLimits?.tokens != null && (!Number.isFinite(grant.budgetLimits.tokens) || grant.budgetLimits.tokens < 0)) add("capacity_grant_token_limit_invalid", "budgetLimits.tokens", "Token limit must be finite and non-negative.");
17
+ if (grant.budgetLimits?.cost && (!Number.isFinite(grant.budgetLimits.cost.amount) || grant.budgetLimits.cost.amount < 0 || !grant.budgetLimits.cost.currency.trim())) add("capacity_grant_cost_limit_invalid", "budgetLimits.cost", "Cost limit requires a non-negative amount and currency.");
18
+ if (grant.budgetLimits?.native?.some((entry) => !entry.unit.trim() || !Number.isFinite(entry.amount) || entry.amount < 0)) add("capacity_grant_native_limit_invalid", "budgetLimits.native", "Native limits require a unit and non-negative amount.");
19
+ if (!Array.isArray(grant.executionProviderIds) || grant.executionProviderIds.length === 0) add("capacity_grant_execution_provider_required", "executionProviderIds", "At least one execution provider is required.");
20
+ if (!grant.unmetered && grant.dailyAgentSecondsLimit == null && grant.monthlyAgentSecondsLimit == null) add("capacity_grant_budget_required", "unmetered", "A metered grant requires a daily or monthly agent-time limit.");
21
+ if (grant.unmetered && (grant.dailyAgentSecondsLimit != null || grant.monthlyAgentSecondsLimit != null)) add("capacity_grant_budget_ambiguous", "unmetered", "An unmetered grant must not also declare agent-time limits.");
22
+ if (grant.expiresAt && timestamp(grant.expiresAt) === null) add("capacity_grant_expiry_invalid", "expiresAt", "expiresAt must be an ISO timestamp.");
23
+ return { ok: diagnostics.length === 0, diagnostics };
24
+ }
25
+ function timestamp(value) {
26
+ const parsed = value ? Date.parse(value) : Number.NaN;
27
+ return Number.isFinite(parsed) ? parsed : null;
28
+ }
29
+ export {
30
+ validateCapacityGrantV2
31
+ };
@@ -1,7 +1,7 @@
1
- export type { AgentKernelPolicy, AgentKernelProfile, ProjectAgentClass, ProjectAgentClassStatus } from '../../agent-capacity/contracts/projects/agents/project-agent-class.js';
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
- export * from '../../agent-capacity/allocation.js';
4
- export * from '../../agent-capacity/artifacts.js';
3
+ export * from '../../agent-capacity/grant.js';
4
+ export * from '../../agent-capacity/contracts/capacity/assignments/assignment-path.js';
5
5
  export * from '../../agent-capacity/validation/index.js';
6
6
  export * from '../../agent-capacity/contracts/capacity/assignments/assignment-records.js';
7
7
  export * from '../../agent-capacity/contracts/capacity/assignments/assignment-context-pack.js';
@@ -17,7 +17,6 @@ export * from '../../agent-capacity/contracts/operations/research-workflow.js';
17
17
  export * from '../../agent-capacity/contracts/operations/agent-team-clone.js';
18
18
  export * from '../../agent-capacity/contracts/projects/agents/project-agent-class.js';
19
19
  export * from '../../agent-capacity/contracts/runtime/runtime-observability.js';
20
- export * from '../../agent-capacity/contracts/support/decision-work.js';
21
20
  export * from '../../agent-capacity/contracts/support/execution-graph.js';
22
21
  export * from '../../agent-capacity/contracts/support/agent-lab-monitoring.js';
23
22
  export * from '../../agent-capacity/contracts/support/agent-atlas.js';
@@ -1,5 +1,5 @@
1
- export * from "../../agent-capacity/allocation.js";
2
- export * from "../../agent-capacity/artifacts.js";
1
+ export * from "../../agent-capacity/grant.js";
2
+ export * from "../../agent-capacity/contracts/capacity/assignments/assignment-path.js";
3
3
  export * from "../../agent-capacity/validation/index.js";
4
4
  export * from "../../agent-capacity/contracts/capacity/assignments/assignment-records.js";
5
5
  export * from "../../agent-capacity/contracts/capacity/assignments/assignment-context-pack.js";
@@ -15,7 +15,6 @@ export * from "../../agent-capacity/contracts/operations/research-workflow.js";
15
15
  export * from "../../agent-capacity/contracts/operations/agent-team-clone.js";
16
16
  export * from "../../agent-capacity/contracts/projects/agents/project-agent-class.js";
17
17
  export * from "../../agent-capacity/contracts/runtime/runtime-observability.js";
18
- export * from "../../agent-capacity/contracts/support/decision-work.js";
19
18
  export * from "../../agent-capacity/contracts/support/execution-graph.js";
20
19
  export * from "../../agent-capacity/contracts/support/agent-lab-monitoring.js";
21
20
  export * from "../../agent-capacity/contracts/support/agent-atlas.js";