@toolproof-core/genesis 1.0.48 → 1.0.50

package/generated-src/schemas/standalone/Tool.json

@@ -9,17 +9,17 @@
     "handle": {
       "$ref": "#/$defs/ToolHandle"
     },
-    "isTemplate": {
-      "type": "boolean"
-    },
     "templateToolHandle": {
       "$ref": "#/$defs/ToolHandle"
     },
+    "isTemplate": {
+      "type": "boolean"
+    },
     "instantiationRoleSpec": {
       "$ref": "#/$defs/RoleSpec"
     }
   },
-  "$comment": "Template Tools own dispatch contract: Core scans all instantiation Tools grouped by templateToolHandle, derives a specializationKey from each tool's generic role assignment (canonical order of genericRoleName -> resourceTypeHandle pairs), and asserts injectivity (no two instantiation Tools share the same key for the same template). At invocation time Core injects the specializationKey -> instantiationToolHandle lookup as the second input, then resolves the first input against it to return one instantiation Tool. Cross-resource compatibility between an instantiation Tool's roleSpec and the template's instantiationRoleSpec is deferred to the validation package.",
+  "$comment": "Template Tools own dispatch contract: Core scans all instantiation Tools grouped by templateToolHandle, derives a specializationKey from each instantiation tool's generic assignment by taking the canonical order of genericRoleName -> assigned ResourceType.resourceTypeHandle pairs, and asserts injectivity (no two instantiation Tools share the same key for the same template). At invocation time Core injects the specializationKey -> instantiationToolHandle lookup as the second input, then the template resolves the first input against it to return one instantiation Tool. Cross-resource compatibility between an instantiation Tool's roleSpec and the template's instantiationRoleSpec is deferred to the validation package.",
   "semanticValidation": "Deferred: verify injectivity of specializationKey map per template; verify instantiation Tool roleSpec matches template instantiationRoleSpec; verify every supplied generic assignment key-set exactly equals roleSpec.inputRoleValueByName.GenericAssignmentByRoleName.mapKeys; verify every supplied generic assignment matches a registered specializationKey.",
   "allOf": [
     {
@@ -50,7 +50,7 @@
       }
     },
     {
-      "$comment": "Template Tools must declare named roles: two map inputs (GenericAssignmentByRoleName and InstantiationToolHandleBySpecializationKey) and one scalar TYPE-Tool output (InstantiationTool). Runtime semantic validation enforces that invocation input keys for GenericAssignmentByRoleName exactly match this role's declared mapKeys.",
+      "$comment": "Template Tools must declare named roles: two map inputs (GenericAssignmentByRoleName and InstantiationToolHandleBySpecializationKey) and one scalar TYPE-Tool output (InstantiationTool). GenericAssignmentByRoleName.mapKeys declares the generic parameter names accepted by the template. Runtime semantic validation enforces that each invocation's GenericAssignmentByRoleName object has exactly that key set: no missing keys, no extra keys. These keys are the generic parameter names later referenced via roleSchema refs such as #OperandType; they are not required to match the top-level role names of instantiationRoleSpec.",
       "if": {
         "required": [
           "isTemplate"
@@ -289,7 +289,7 @@
     },
     "RoleValue": {
       "$schema": "https://json-schema.org/draft/2020-12/schema",
-      "$comment": "Pairs a type reference (typeRef) with a container shape. typeRef is either resource-backed (resourceTypeHandle) or schema-backed (roleSchema).",
+      "$comment": "Pairs a type reference (typeRef) with a container shape. typeRef may be a single atomic type reference or a finite sum type over atomic successful value alternatives.",
       "type": "object",
       "required": [
         "typeRef",
@@ -443,8 +443,49 @@
       "semanticValidation": "Ajv custom keyword to verify description."
     },
     "TypeRef": {
+      "$comment": "A type reference is either a single AtomicTypeRef or a finite sum type expressed as oneOfTypeRefs. The oneOfTypeRefs branch permits a union of atomic successful value alternatives and does not permit nested unions.",
+      "oneOf": [
+        {
+          "$ref": "#/$defs/AtomicTypeRef"
+        },
+        {
+          "type": "object",
+          "required": [
+            "oneOfTypeRefs"
+          ],
+          "properties": {
+            "oneOfTypeRefs": {
+              "type": "array",
+              "items": {
+                "$ref": "#/$defs/AtomicTypeRef"
+              },
+              "minItems": 2,
+              "uniqueItems": true
+            }
+          },
+          "additionalProperties": false
+        }
+      ]
+    },
+    "ContainerKind": {
       "$schema": "https://json-schema.org/draft/2020-12/schema",
-      "$comment": "A type reference is either resource-backed (resourceTypeHandle, strategy-legal) or schema-backed (roleSchema, internal/Core-only). The roleSchema branch holds an object whose $ref names the type parameter (e.g. '#OperandType'), matching an entry in the template's GenericAssignmentByRoleName.mapKeys. Exactly one branch must be present.",
+      "type": "string",
+      "enum": [
+        "scalar",
+        "array",
+        "map"
+      ]
+    },
+    "RoleNameArray": {
+      "$schema": "https://json-schema.org/draft/2020-12/schema",
+      "type": "array",
+      "items": {
+        "$ref": "#/$defs/RoleName"
+      }
+    },
+    "AtomicTypeRef": {
+      "$schema": "https://json-schema.org/draft/2020-12/schema",
+      "$comment": "An atomic type reference is either resource-backed (resourceTypeHandle, strategy-legal) or schema-backed (roleSchema, internal/Core-only). The roleSchema branch holds an object whose $ref names the type parameter (e.g. '#OperandType'), matching an entry in the template's GenericAssignmentByRoleName.mapKeys. Exactly one atomic branch must be present.",
       "oneOf": [
         {
           "type": "object",
@@ -483,22 +524,6 @@
         }
       ]
     },
-    "ContainerKind": {
-      "$schema": "https://json-schema.org/draft/2020-12/schema",
-      "type": "string",
-      "enum": [
-        "scalar",
-        "array",
-        "map"
-      ]
-    },
-    "RoleNameArray": {
-      "$schema": "https://json-schema.org/draft/2020-12/schema",
-      "type": "array",
-      "items": {
-        "$ref": "#/$defs/RoleName"
-      }
-    },
     "ResourceTypeHandle": {
       "$schema": "https://json-schema.org/draft/2020-12/schema",
       "type": "string",

package/generated-src/schemas/zod/Resource.ts

@@ -2,14 +2,14 @@
 import { z } from 'zod/v4';
 
 
-const BaseResourceSchema: z.ZodTypeAny = z.lazy(() => z.object({ "value": z.any(), "id": ResourceIdSchema, "resourceTypeHandle": ResourceTypeHandleSchema, "version": z.literal(1), "provenance": ProvenanceSchema }).strict());
+const BaseResourceSchema: z.ZodTypeAny = z.lazy(() => z.object({ "projection": z.any(), "id": ResourceIdSchema, "resourceTypeHandle": ResourceTypeHandleSchema, "provenance": ProvenanceSchema }).strict());
 const GenesisProvenanceSchema: z.ZodTypeAny = z.lazy(() => z.object({ "provenanceKind": z.literal("genesis") }).strict());
 const NameSchema: z.ZodTypeAny = z.lazy(() => z.string().min(1).regex(new RegExp("^[A-Z][a-zA-Z0-9]*$")));
 const OutputAddressSchema: z.ZodTypeAny = z.lazy(() => z.object({ "roleName": RoleNameSchema, "toolStepPath": ToolStepPathSchema }).strict());
 const ProvenanceSchema: z.ZodTypeAny = z.lazy(() => z.union([GenesisProvenanceSchema, StrategyProvenanceSchema]));
 const ProvenanceFacetSchema: z.ZodTypeAny = z.lazy(() => z.object({ "provenance": ProvenanceSchema }));
 const ResourceIdSchema: z.ZodTypeAny = z.lazy(() => z.string().regex(new RegExp("^RESOURCE-.+$")));
-const ResourcePointerSchema: z.ZodTypeAny = z.lazy(() => z.object({ "id": ResourceIdSchema, "resourceTypeHandle": ResourceTypeHandleSchema, "version": z.literal(1), "provenance": ProvenanceSchema }).strict());
+const ResourcePointerSchema: z.ZodTypeAny = z.lazy(() => z.object({ "id": ResourceIdSchema, "resourceTypeHandle": ResourceTypeHandleSchema, "provenance": ProvenanceSchema }).strict());
 const ResourceTypeHandleSchema: z.ZodTypeAny = z.lazy(() => z.string().regex(new RegExp("^TYPE-.+$")));
 const RoleNameSchema: z.ZodTypeAny = z.lazy(() => NameSchema);
 const StrategyProvenanceSchema: z.ZodTypeAny = z.lazy(() => z.object({ "provenanceKind": z.literal("strategy"), "strategyTraceHandle": StrategyTraceHandleSchema, "outputAddress": OutputAddressSchema }).strict());

package/generated-src/schemas/zod/ResourceType.ts

@@ -11,4 +11,4 @@ const NameFacetSchema: z.ZodTypeAny = z.lazy(() => z.object({ "name": NameSchema
 const ResourceTypeHandleSchema: z.ZodTypeAny = z.lazy(() => z.string().regex(new RegExp("^TYPE-.+$")));
 const ToolHandleSchema: z.ZodTypeAny = z.lazy(() => z.string().regex(new RegExp("^TOOL-.+$")));
 
-export const ResourceTypeSchema: z.ZodTypeAny = z.lazy(() => z.intersection(z.intersection(z.object({ "handle": ResourceTypeHandleSchema, "valueSchema": JsonSchemaObjectSchema.optional(), "parserToolHandle": ToolHandleSchema.optional(), "embeddingModelTools": z.array(ToolHandleSchema).min(1).optional() }).strict(), DocumentationSpecSchema), z.union([z.object({  }), z.object({  })])));
+export const ResourceTypeSchema: z.ZodTypeAny = z.lazy(() => z.intersection(z.intersection(z.intersection(z.object({ "handle": ResourceTypeHandleSchema, "projectionSchema": JsonSchemaObjectSchema.optional(), "ingestorToolHandle": ToolHandleSchema.optional(), "ingestorToolInputSchema": JsonSchemaObjectSchema.optional(), "embeddingModelTools": z.array(ToolHandleSchema).min(1).optional() }).strict(), DocumentationSpecSchema), z.union([z.object({  }), z.object({  })])), z.any()));

package/generated-src/schemas/zod/Strategy.ts

@@ -17,7 +17,7 @@ export const StrategyZodGenerationWarnings = [
   }
 ] as const;
 
-const BaseResourceSchema: z.ZodTypeAny = z.lazy(() => z.object({ "value": z.any(), "id": ResourceIdSchema, "resourceTypeHandle": ResourceTypeHandleSchema, "version": z.literal(1), "provenance": ProvenanceSchema }).strict());
+const BaseResourceSchema: z.ZodTypeAny = z.lazy(() => z.object({ "projection": z.any(), "id": ResourceIdSchema, "resourceTypeHandle": ResourceTypeHandleSchema, "provenance": ProvenanceSchema }).strict());
 const BaseStrategySchema: z.ZodTypeAny = z.lazy(() => z.object({ "handle": StrategyHandleSchema, "strategyKind": StrategyKindSchema }));
 const BranchStepSchema: z.ZodTypeAny = z.lazy(() => z.object({ "stepKind": z.intersection(z.literal("branch"), StepKindSchema), "cases": z.array(CaseSchema).min(1) }));
 const CaseSchema: z.ZodTypeAny = z.lazy(() => z.object({ "when": ToolStepSchema, "what": ToolStepSchema }).strict());
@@ -26,14 +26,14 @@ const ExternalInputPotentialSchema: z.ZodTypeAny = z.lazy(() => z.object({ "stra
 const ForStepSchema: z.ZodTypeAny = z.lazy(() => z.object({ "stepKind": z.intersection(z.literal("for"), StepKindSchema), "case": CaseSchema }));
 const GenesisProvenanceSchema: z.ZodTypeAny = z.lazy(() => z.object({ "provenanceKind": z.literal("genesis") }).strict());
 const InputPotentialSchema: z.ZodTypeAny = z.lazy(() => z.union([ExternalInputPotentialSchema, InternalInputPotentialSchema]));
-const InputResourceSchema: z.ZodTypeAny = z.lazy(() => z.object({ "strategyStateInputKind": z.literal("inputResource"), "value": z.any(), "id": ResourceIdSchema, "resourceTypeHandle": ResourceTypeHandleSchema, "version": z.literal(1), "provenance": ProvenanceSchema }).strict());
+const InputResourceSchema: z.ZodTypeAny = z.lazy(() => z.object({ "strategyStateInputKind": z.literal("inputResource"), "projection": z.any(), "id": ResourceIdSchema, "resourceTypeHandle": ResourceTypeHandleSchema, "provenance": ProvenanceSchema }).strict());
 const InternalInputPotentialSchema: z.ZodTypeAny = z.lazy(() => z.object({ "strategyStateInputKind": z.literal("internalInputPotential"), "id": ResourceIdSchema, "resourceTypeHandle": ResourceTypeHandleSchema, "provenance": DeferredStrategyProvenanceSchema }).strict());
 const NameSchema: z.ZodTypeAny = z.lazy(() => z.string().min(1).regex(new RegExp("^[A-Z][a-zA-Z0-9]*$")));
 const OutputAddressSchema: z.ZodTypeAny = z.lazy(() => z.object({ "roleName": RoleNameSchema, "toolStepPath": ToolStepPathSchema }).strict());
 const ProvenanceSchema: z.ZodTypeAny = z.lazy(() => z.union([GenesisProvenanceSchema, StrategyProvenanceSchema]));
 const ProvenanceFacetSchema: z.ZodTypeAny = z.lazy(() => z.object({ "provenance": ProvenanceSchema }));
 const ResourceIdSchema: z.ZodTypeAny = z.lazy(() => z.string().regex(new RegExp("^RESOURCE-.+$")));
-const ResourcePointerSchema: z.ZodTypeAny = z.lazy(() => z.object({ "id": ResourceIdSchema, "resourceTypeHandle": ResourceTypeHandleSchema, "version": z.literal(1), "provenance": ProvenanceSchema }).strict());
+const ResourcePointerSchema: z.ZodTypeAny = z.lazy(() => z.object({ "id": ResourceIdSchema, "resourceTypeHandle": ResourceTypeHandleSchema, "provenance": ProvenanceSchema }).strict());
 const ResourceTypeHandleSchema: z.ZodTypeAny = z.lazy(() => z.string().regex(new RegExp("^TYPE-.+$")));
 const RoleBindingSpecSchema: z.ZodTypeAny = z.lazy(() => z.object({ "inputBindings": RoleNameArraySchema, "outputBindings": RoleNameArraySchema }).strict());
 const RoleBindingSpecFacetSchema: z.ZodTypeAny = z.lazy(() => z.object({ "roleBindingSpec": RoleBindingSpecSchema }));

package/generated-src/schemas/zod/StrategyTrace.ts

@@ -17,7 +17,7 @@ export const StrategyTraceZodGenerationWarnings = [
   }
 ] as const;
 
-const BaseResourceSchema: z.ZodTypeAny = z.lazy(() => z.object({ "value": z.any(), "id": ResourceIdSchema, "resourceTypeHandle": ResourceTypeHandleSchema, "version": z.literal(1), "provenance": ProvenanceSchema }).strict());
+const BaseResourceSchema: z.ZodTypeAny = z.lazy(() => z.object({ "projection": z.any(), "id": ResourceIdSchema, "resourceTypeHandle": ResourceTypeHandleSchema, "provenance": ProvenanceSchema }).strict());
 const BaseStrategySchema: z.ZodTypeAny = z.lazy(() => z.object({ "handle": StrategyHandleSchema, "strategyKind": StrategyKindSchema }));
 const BaseTracePointSchema: z.ZodTypeAny = z.lazy(() => z.object({ "tracePointKind": TracePointKindSchema, "strategyHandle": StrategyHandleSchema, "threadIndex": NaturalSchema, "tracePointIndex": NaturalSchema }));
 const BranchStepSchema: z.ZodTypeAny = z.lazy(() => z.object({ "stepKind": z.intersection(z.literal("branch"), StepKindSchema), "cases": z.array(CaseSchema).min(1) }));
@@ -29,7 +29,7 @@ const GenesisProvenanceSchema: z.ZodTypeAny = z.lazy(() => z.object({ "provenanc
 const GraphEndTracePointSchema: z.ZodTypeAny = z.lazy(() => z.object({ "tracePointKind": z.intersection(TracePointKindSchema, z.literal("graph_end")), "strategyHandle": StrategyHandleSchema, "threadIndex": NaturalSchema, "tracePointIndex": NaturalSchema }));
 const GraphStartTracePointSchema: z.ZodTypeAny = z.lazy(() => z.object({ "tracePointKind": z.intersection(TracePointKindSchema, z.literal("graph_start")), "strategyHandle": StrategyHandleSchema, "threadIndex": NaturalSchema, "tracePointIndex": NaturalSchema, "threadedStrategy": ThreadedStrategySchema }));
 const InputPotentialSchema: z.ZodTypeAny = z.lazy(() => z.union([ExternalInputPotentialSchema, InternalInputPotentialSchema]));
-const InputResourceSchema: z.ZodTypeAny = z.lazy(() => z.object({ "strategyStateInputKind": z.literal("inputResource"), "value": z.any(), "id": ResourceIdSchema, "resourceTypeHandle": ResourceTypeHandleSchema, "version": z.literal(1), "provenance": ProvenanceSchema }).strict());
+const InputResourceSchema: z.ZodTypeAny = z.lazy(() => z.object({ "strategyStateInputKind": z.literal("inputResource"), "projection": z.any(), "id": ResourceIdSchema, "resourceTypeHandle": ResourceTypeHandleSchema, "provenance": ProvenanceSchema }).strict());
 const InternalInputPotentialSchema: z.ZodTypeAny = z.lazy(() => z.object({ "strategyStateInputKind": z.literal("internalInputPotential"), "id": ResourceIdSchema, "resourceTypeHandle": ResourceTypeHandleSchema, "provenance": DeferredStrategyProvenanceSchema }).strict());
 const InterruptTracePointSchema: z.ZodTypeAny = z.lazy(() => z.object({ "tracePointKind": z.intersection(TracePointKindSchema, z.literal("interrupt")), "strategyHandle": StrategyHandleSchema, "threadIndex": NaturalSchema, "tracePointIndex": NaturalSchema, "counterSnapshot": TracePointCounterSnapshotSchema, "toolStepPath": ThreadedToolStepPathSchema, "delta": z.object({ "stepsMutation": z.object({ "insertAt": NaturalSchema, "insertedSteps": StepArraySchema }).optional(), "strategyStateDelta": ThreadedStrategyStateSchema.optional(), "interruptData": z.intersection(z.union([z.object({  }), z.null()]), z.object({  })) }) }));
 const NameSchema: z.ZodTypeAny = z.lazy(() => z.string().min(1).regex(new RegExp("^[A-Z][a-zA-Z0-9]*$")));
@@ -38,7 +38,7 @@ const OutputAddressSchema: z.ZodTypeAny = z.lazy(() => z.object({ "roleName": Ro
 const ProvenanceSchema: z.ZodTypeAny = z.lazy(() => z.union([GenesisProvenanceSchema, StrategyProvenanceSchema]));
 const ProvenanceFacetSchema: z.ZodTypeAny = z.lazy(() => z.object({ "provenance": ProvenanceSchema }));
 const ResourceIdSchema: z.ZodTypeAny = z.lazy(() => z.string().regex(new RegExp("^RESOURCE-.+$")));
-const ResourcePointerSchema: z.ZodTypeAny = z.lazy(() => z.object({ "id": ResourceIdSchema, "resourceTypeHandle": ResourceTypeHandleSchema, "version": z.literal(1), "provenance": ProvenanceSchema }).strict());
+const ResourcePointerSchema: z.ZodTypeAny = z.lazy(() => z.object({ "id": ResourceIdSchema, "resourceTypeHandle": ResourceTypeHandleSchema, "provenance": ProvenanceSchema }).strict());
 const ResourceTypeHandleSchema: z.ZodTypeAny = z.lazy(() => z.string().regex(new RegExp("^TYPE-.+$")));
 const RoleBindingSpecSchema: z.ZodTypeAny = z.lazy(() => z.object({ "inputBindings": RoleNameArraySchema, "outputBindings": RoleNameArraySchema }).strict());
 const RoleBindingSpecFacetSchema: z.ZodTypeAny = z.lazy(() => z.object({ "roleBindingSpec": RoleBindingSpecSchema }));

package/generated-src/schemas/zod/Suite.ts

@@ -0,0 +1,44 @@
+// Auto-generated from standalone schema 'Suite'. Do not edit.
+import { z } from 'zod/v4';
+
+
+export const SuiteZodGenerationWarnings = [
+  {
+    "path": "$defs.RoleValueByName.propertyNames",
+    "message": "Unsupported propertyNames $ref target; keys will not be validated."
+  },
+  {
+    "path": "$defs.TypeRef.oneOf[1].properties.oneOfTypeRefs.uniqueItems",
+    "message": "uniqueItems not enforced by generated Zod."
+  },
+  {
+    "path": "Suite.allOfMerged.properties.resourceTypes.uniqueItems",
+    "message": "uniqueItems not enforced by generated Zod."
+  },
+  {
+    "path": "Suite.allOfMerged.properties.tools.uniqueItems",
+    "message": "uniqueItems not enforced by generated Zod."
+  }
+] as const;
+
+const AtomicTypeRefSchema: z.ZodTypeAny = z.lazy(() => z.union([z.object({ "resourceTypeHandle": ResourceTypeHandleSchema }).strict(), z.object({ "roleSchema": z.object({ "$ref": z.string().regex(new RegExp("^#[A-Z][a-zA-Z0-9]*$")) }).strict() }).strict()]));
+const ContainerKindSchema: z.ZodTypeAny = z.lazy(() => z.union([z.literal("scalar"), z.literal("array"), z.literal("map")]));
+const DescriptionSchema: z.ZodTypeAny = z.lazy(() => z.string().min(1));
+const DescriptionFacetSchema: z.ZodTypeAny = z.lazy(() => z.object({ "description": DescriptionSchema }));
+const DocumentationSpecSchema: z.ZodTypeAny = z.lazy(() => z.object({ "name": NameSchema, "symbol": z.string().optional(), "description": DescriptionSchema }));
+const JsonSchemaObjectSchema: z.ZodTypeAny = z.lazy(() => z.object({ "$schema": z.literal("https://json-schema.org/draft/2020-12/schema") }).passthrough());
+const NameSchema: z.ZodTypeAny = z.lazy(() => z.string().min(1).regex(new RegExp("^[A-Z][a-zA-Z0-9]*$")));
+const NameFacetSchema: z.ZodTypeAny = z.lazy(() => z.object({ "name": NameSchema }));
+const ResourceTypeSchema: z.ZodTypeAny = z.lazy(() => z.intersection(z.intersection(z.intersection(z.object({ "handle": ResourceTypeHandleSchema, "projectionSchema": JsonSchemaObjectSchema.optional(), "ingestorToolHandle": ToolHandleSchema.optional(), "ingestorToolInputSchema": JsonSchemaObjectSchema.optional(), "embeddingModelTools": z.array(ToolHandleSchema).min(1).optional() }).strict(), DocumentationSpecSchema), z.union([z.object({  }), z.object({  })])), z.any()));
+const ResourceTypeHandleSchema: z.ZodTypeAny = z.lazy(() => z.string().regex(new RegExp("^TYPE-.+$")));
+const RoleNameSchema: z.ZodTypeAny = z.lazy(() => NameSchema);
+const RoleNameArraySchema: z.ZodTypeAny = z.lazy(() => z.array(RoleNameSchema));
+const RoleSpecSchema: z.ZodTypeAny = z.lazy(() => z.object({ "inputRoleValueByName": RoleValueByNameSchema, "outputRoleValueByName": RoleValueByNameSchema, "refinementSchema": JsonSchemaObjectSchema.optional() }).strict());
+const RoleSpecFacetSchema: z.ZodTypeAny = z.lazy(() => z.object({ "roleSpec": RoleSpecSchema }));
+const RoleValueSchema: z.ZodTypeAny = z.lazy(() => z.intersection(z.intersection(z.intersection(z.intersection(z.object({ "typeRef": TypeRefSchema, "refinementSchema": JsonSchemaObjectSchema.optional(), "containerKind": ContainerKindSchema, "containerSchema": JsonSchemaObjectSchema.optional(), "mapKeys": RoleNameArraySchema.optional() }).strict(), z.any()), z.any()), z.any()), z.any()));
+const RoleValueByNameSchema: z.ZodTypeAny = z.lazy(() => z.record(z.string(), RoleValueSchema));
+const ToolSchema: z.ZodTypeAny = z.lazy(() => z.intersection(z.intersection(z.intersection(z.intersection(z.object({ "handle": ToolHandleSchema, "templateToolHandle": ToolHandleSchema.optional(), "isTemplate": z.boolean(), "instantiationRoleSpec": RoleSpecSchema.optional() }).strict(), DocumentationSpecSchema), z.any()), z.any()), RoleSpecFacetSchema));
+const ToolHandleSchema: z.ZodTypeAny = z.lazy(() => z.string().regex(new RegExp("^TOOL-.+$")));
+const TypeRefSchema: z.ZodTypeAny = z.lazy(() => z.union([AtomicTypeRefSchema, z.object({ "oneOfTypeRefs": z.array(AtomicTypeRefSchema).min(2) }).strict()]));
+
+export const SuiteSchema: z.ZodTypeAny = z.lazy(() => z.object({ "name": NameSchema, "version": z.string().min(1), "description": DescriptionSchema, "resourceTypes": z.array(ResourceTypeSchema), "tools": z.array(ToolSchema) }).strict());

package/generated-src/schemas/zod/Tool.ts

@@ -6,9 +6,14 @@ export const ToolZodGenerationWarnings = [
   {
     "path": "$defs.RoleValueByName.propertyNames",
     "message": "Unsupported propertyNames $ref target; keys will not be validated."
+  },
+  {
+    "path": "$defs.TypeRef.oneOf[1].properties.oneOfTypeRefs.uniqueItems",
+    "message": "uniqueItems not enforced by generated Zod."
   }
 ] as const;
 
+const AtomicTypeRefSchema: z.ZodTypeAny = z.lazy(() => z.union([z.object({ "resourceTypeHandle": ResourceTypeHandleSchema }).strict(), z.object({ "roleSchema": z.object({ "$ref": z.string().regex(new RegExp("^#[A-Z][a-zA-Z0-9]*$")) }).strict() }).strict()]));
 const ContainerKindSchema: z.ZodTypeAny = z.lazy(() => z.union([z.literal("scalar"), z.literal("array"), z.literal("map")]));
 const DescriptionSchema: z.ZodTypeAny = z.lazy(() => z.string().min(1));
 const DescriptionFacetSchema: z.ZodTypeAny = z.lazy(() => z.object({ "description": DescriptionSchema }));
@@ -24,6 +29,6 @@ const RoleSpecFacetSchema: z.ZodTypeAny = z.lazy(() => z.object({ "roleSpec": Ro
 const RoleValueSchema: z.ZodTypeAny = z.lazy(() => z.intersection(z.intersection(z.intersection(z.intersection(z.object({ "typeRef": TypeRefSchema, "refinementSchema": JsonSchemaObjectSchema.optional(), "containerKind": ContainerKindSchema, "containerSchema": JsonSchemaObjectSchema.optional(), "mapKeys": RoleNameArraySchema.optional() }).strict(), z.any()), z.any()), z.any()), z.any()));
 const RoleValueByNameSchema: z.ZodTypeAny = z.lazy(() => z.record(z.string(), RoleValueSchema));
 const ToolHandleSchema: z.ZodTypeAny = z.lazy(() => z.string().regex(new RegExp("^TOOL-.+$")));
-const TypeRefSchema: z.ZodTypeAny = z.lazy(() => z.union([z.object({ "resourceTypeHandle": ResourceTypeHandleSchema }).strict(), z.object({ "roleSchema": z.object({ "$ref": z.string().regex(new RegExp("^#[A-Z][a-zA-Z0-9]*$")) }).strict() }).strict()]));
+const TypeRefSchema: z.ZodTypeAny = z.lazy(() => z.union([AtomicTypeRefSchema, z.object({ "oneOfTypeRefs": z.array(AtomicTypeRefSchema).min(2) }).strict()]));
 
-export const ToolSchema: z.ZodTypeAny = z.lazy(() => z.intersection(z.intersection(z.intersection(z.intersection(z.object({ "handle": ToolHandleSchema, "isTemplate": z.boolean(), "templateToolHandle": ToolHandleSchema.optional(), "instantiationRoleSpec": RoleSpecSchema.optional() }).strict(), DocumentationSpecSchema), z.any()), z.any()), RoleSpecFacetSchema));
+export const ToolSchema: z.ZodTypeAny = z.lazy(() => z.intersection(z.intersection(z.intersection(z.intersection(z.object({ "handle": ToolHandleSchema, "templateToolHandle": ToolHandleSchema.optional(), "isTemplate": z.boolean(), "instantiationRoleSpec": RoleSpecSchema.optional() }).strict(), DocumentationSpecSchema), z.any()), z.any()), RoleSpecFacetSchema));

package/generated-src/schemas/zod/index.ts

@@ -7,4 +7,5 @@ export { ResourceSchema } from './Resource.js';
 export { ResourceTypeSchema } from './ResourceType.js';
 export { StrategySchema } from './Strategy.js';
 export { StrategyTraceSchema } from './StrategyTrace.js';
+export { SuiteSchema } from './Suite.js';
 export { ToolSchema } from './Tool.js';

package/{src/genesis/resources → generated-src/timestampedResources}/booleans.json

@@ -1,24 +1,20 @@
-[
-    {
-        "id": "RESOURCE-False",
-        "resourceTypeHandle": "TYPE-Boolean",
-        "provenance": {
-            "resourceProvenanceKind": "genesis"
-        },
-        "version": 1,
-        
-        "timestamp": "2025-11-30T00:00:00.000Z",
-        "value": false
-    },
-    {
-        "id": "RESOURCE-True",
-        "resourceTypeHandle": "TYPE-Boolean",
-        "provenance": {
-            "resourceProvenanceKind": "genesis"
-        },
-        "version": 1,
-        
-        "timestamp": "2025-11-30T00:00:00.000Z",
-        "value": true
-    }
+[
+    {
+        "id": "RESOURCE-BOOLEAN:False",
+        "resourceTypeHandle": "TYPE-Boolean",
+        "provenance": {
+            "resourceProvenanceKind": "genesis"
+        },
+        "timestamp": "2025-11-30T00:00:00.000Z",
+        "projection": false
+    },
+    {
+        "id": "RESOURCE-BOOLEAN:True",
+        "resourceTypeHandle": "TYPE-Boolean",
+        "provenance": {
+            "resourceProvenanceKind": "genesis"
+        },
+        "timestamp": "2025-11-30T00:00:00.000Z",
+        "projection": true
+    }
 ]

package/generated-src/timestampedResources/booleans.ts

@@ -0,0 +1,2 @@
+import timestampedResources from './booleans.json' with { type: 'json' };
+export default timestampedResources;

package/{src/genesis/resources → generated-src/timestampedResources}/naturals.json

@@ -1,112 +1,101 @@
-[
-    {
-        "id": "RESOURCE-0",
-        "resourceTypeHandle": "TYPE-Natural",
-        "provenance": {
-            "resourceProvenanceKind": "genesis"
-        },
-        "version": 1,
-        "timestamp": "2025-11-30T00:00:00.000Z",
-        "value": 0
-    },
-    {
-        "id": "RESOURCE-1",
-        "resourceTypeHandle": "TYPE-Natural",
-        "provenance": {
-            "resourceProvenanceKind": "genesis"
-        },
-        "version": 1,
-        "timestamp": "2025-11-30T00:00:00.000Z",
-        "value": 1
-    },
-    {
-        "id": "RESOURCE-2",
-        "resourceTypeHandle": "TYPE-Natural",
-        "provenance": {
-            "resourceProvenanceKind": "genesis"
-        },
-        "version": 1,
-        "timestamp": "2025-11-30T00:00:00.000Z",
-        "value": 2
-    },
-    {
-        "id": "RESOURCE-3",
-        "resourceTypeHandle": "TYPE-Natural",
-        "provenance": {
-            "resourceProvenanceKind": "genesis"
-        },
-        "version": 1,
-        "timestamp": "2025-11-30T00:00:00.000Z",
-        "value": 3
-    },
-    {
-        "id": "RESOURCE-4",
-        "resourceTypeHandle": "TYPE-Natural",
-        "provenance": {
-            "resourceProvenanceKind": "genesis"
-        },
-        "version": 1,
-        "timestamp": "2025-11-30T00:00:00.000Z",
-        "value": 4
-    },
-    {
-        "id": "RESOURCE-5",
-        "resourceTypeHandle": "TYPE-Natural",
-        "provenance": {
-            "resourceProvenanceKind": "genesis"
-        },
-        "version": 1,
-        "timestamp": "2025-11-30T00:00:00.000Z",
-        "value": 5
-    },
-    {
-        "id": "RESOURCE-6",
-        "resourceTypeHandle": "TYPE-Natural",
-        "provenance": {
-            "resourceProvenanceKind": "genesis"
-        },
-        "version": 1,
-        "timestamp": "2025-11-30T00:00:00.000Z",
-        "value": 6
-    },
-    {
-        "id": "RESOURCE-7",
-        "resourceTypeHandle": "TYPE-Natural",
-        "provenance": {
-            "resourceProvenanceKind": "genesis"
-        },
-        "version": 1,
-        "timestamp": "2025-11-30T00:00:00.000Z",
-        "value": 7
-    },
-    {
-        "id": "RESOURCE-8",
-        "resourceTypeHandle": "TYPE-Natural",
-        "provenance": {
-            "resourceProvenanceKind": "genesis"
-        },
-        "version": 1,
-        "timestamp": "2025-11-30T00:00:00.000Z",
-        "value": 8
-    },
-    {
-        "id": "RESOURCE-9",
-        "resourceTypeHandle": "TYPE-Natural",
-        "provenance": {
-            "resourceProvenanceKind": "genesis"
-        },
-        "version": 1,
-        "timestamp": "2025-11-30T00:00:00.000Z",
-        "value": 9
-    },
-    {
-        "id": "RESOURCE-100",
-        "resourceTypeHandle": "TYPE-Natural",
-        "provenance": {
-            "resourceProvenanceKind": "genesis"
-        },
-        "version": 1,
-        "timestamp": "2025-11-30T00:00:00.000Z",
-        "value": 100
-    }
+[
+    {
+        "id": "RESOURCE-NATURAL:0",
+        "resourceTypeHandle": "TYPE-Natural",
+        "provenance": {
+            "resourceProvenanceKind": "genesis"
+        },
+        "timestamp": "2025-11-30T00:00:00.000Z",
+        "projection": 0
+    },
+    {
+        "id": "RESOURCE-NATURAL:1",
+        "resourceTypeHandle": "TYPE-Natural",
+        "provenance": {
+            "resourceProvenanceKind": "genesis"
+        },
+        "timestamp": "2025-11-30T00:00:00.000Z",
+        "projection": 1
+    },
+    {
+        "id": "RESOURCE-NATURAL:2",
+        "resourceTypeHandle": "TYPE-Natural",
+        "provenance": {
+            "resourceProvenanceKind": "genesis"
+        },
+        "timestamp": "2025-11-30T00:00:00.000Z",
+        "projection": 2
+    },
+    {
+        "id": "RESOURCE-NATURAL:3",
+        "resourceTypeHandle": "TYPE-Natural",
+        "provenance": {
+            "resourceProvenanceKind": "genesis"
+        },
+        "timestamp": "2025-11-30T00:00:00.000Z",
+        "projection": 3
+    },
+    {
+        "id": "RESOURCE-NATURAL:4",
+        "resourceTypeHandle": "TYPE-Natural",
+        "provenance": {
+            "resourceProvenanceKind": "genesis"
+        },
+        "timestamp": "2025-11-30T00:00:00.000Z",
+        "projection": 4
+    },
+    {
+        "id": "RESOURCE-NATURAL:5",
+        "resourceTypeHandle": "TYPE-Natural",
+        "provenance": {
+            "resourceProvenanceKind": "genesis"
+        },
+        "timestamp": "2025-11-30T00:00:00.000Z",
+        "projection": 5
+    },
+    {
+        "id": "RESOURCE-NATURAL:6",
+        "resourceTypeHandle": "TYPE-Natural",
+        "provenance": {
+            "resourceProvenanceKind": "genesis"
+        },
+        "timestamp": "2025-11-30T00:00:00.000Z",
+        "projection": 6
+    },
+    {
+        "id": "RESOURCE-NATURAL:7",
+        "resourceTypeHandle": "TYPE-Natural",
+        "provenance": {
+            "resourceProvenanceKind": "genesis"
+        },
+        "timestamp": "2025-11-30T00:00:00.000Z",
+        "projection": 7
+    },
+    {
+        "id": "RESOURCE-NATURAL:8",
+        "resourceTypeHandle": "TYPE-Natural",
+        "provenance": {
+            "resourceProvenanceKind": "genesis"
+        },
+        "timestamp": "2025-11-30T00:00:00.000Z",
+        "projection": 8
+    },
+    {
+        "id": "RESOURCE-NATURAL:9",
+        "resourceTypeHandle": "TYPE-Natural",
+        "provenance": {
+            "resourceProvenanceKind": "genesis"
+        },
+        "timestamp": "2025-11-30T00:00:00.000Z",
+        "projection": 9
+    },
+    {
+        "id": "RESOURCE-NATURAL:100",
+        "resourceTypeHandle": "TYPE-Natural",
+        "provenance": {
+            "resourceProvenanceKind": "genesis"
+        },
+        "timestamp": "2025-11-30T00:00:00.000Z",
+        "projection": 100
+    }
 ]

package/generated-src/timestampedResources/naturals.ts

@@ -0,0 +1,2 @@
+import timestampedResources from './naturals.json' with { type: 'json' };
+export default timestampedResources;