@toolproof-core/schema 1.0.16 → 1.0.18

package/dist/scripts/generateStandaloneZodSchema.js

@@ -0,0 +1,116 @@
+import fs from 'fs';
+import path from 'path';
+import { getConfig } from './_lib/config.js';
+import { jsonSchemaToZodExpressions } from './_lib/utils/jsonSchemaToZod.js';
+/**
+ * Generate a Zod v4 validator module from a standalone schema JSON file.
+ *
+ * Usage:
+ *   node ./dist/scripts/generateStandaloneZodSchema.js --name <DefName>
+ */
+function stripSurroundingQuotes(value) {
+    if ((value.startsWith('"') && value.endsWith('"')) || (value.startsWith("'") && value.endsWith("'"))) {
+        return value.slice(1, -1);
+    }
+    return value;
+}
+function parseArgs(args) {
+    let name;
+    for (let i = 0; i < args.length; i++) {
+        const a = args[i];
+        if (a === '--name') {
+            name = args[i + 1];
+            i++;
+        }
+        else if (a.startsWith('--name=')) {
+            name = a.split('=')[1];
+        }
+    }
+    const normalized = typeof name === 'string' ? stripSurroundingQuotes(name) : undefined;
+    return { name: normalized?.trim() ? normalized : undefined };
+}
+function isValidIdentifier(name) {
+    return /^[A-Za-z_][A-Za-z0-9_]*$/.test(name);
+}
+function toIdentifier(name) {
+    // Standalone def names in Genesis are already identifier-friendly.
+    // We still sanitize minimally to avoid codegen footguns.
+    let out = name.replace(/[^A-Za-z0-9_]/g, '_');
+    if (!/^[A-Za-z_]/.test(out))
+        out = '_' + out;
+    return out;
+}
+function emitHeader(name) {
+    return (`// Auto-generated from standalone schema '${name}'. Do not edit.\n` +
+        `import { z } from 'zod/v4';\n\n`);
+}
+function emitModule(name, expressionsByName, warnings) {
+    const lines = [];
+    lines.push(emitHeader(name));
+    if (warnings.length > 0) {
+        const warningsName = `${toIdentifier(name)}ZodGenerationWarnings`;
+        lines.push(`export const ${warningsName} = ` + JSON.stringify(warnings, null, 2) + ' as const;\n');
+    }
+    const rootIdent = toIdentifier(name);
+    // Emit file-local defs first (not exported) to avoid name collisions across modules.
+    const defNames = Object.keys(expressionsByName)
+        .filter((n) => n !== name)
+        .sort((a, b) => a.localeCompare(b));
+    for (const schemaName of defNames) {
+        const ident = toIdentifier(schemaName);
+        if (!isValidIdentifier(ident)) {
+            throw new Error(`Invalid generated identifier for schema '${schemaName}': '${ident}'`);
+        }
+        const expr = expressionsByName[schemaName];
+        lines.push(`const ${ident}Schema: z.ZodTypeAny = z.lazy(() => ${expr});`);
+    }
+    lines.push('');
+    // Export only the root schema.
+    const rootExpr = expressionsByName[name];
+    lines.push(`export const ${rootIdent}Schema: z.ZodTypeAny = z.lazy(() => ${rootExpr});`);
+    return lines.join('\n') + '\n';
+}
+function writeBarrelFile(zodDir) {
+    const entries = fs
+        .readdirSync(zodDir)
+        .filter((f) => f.endsWith('.ts') && f !== 'index.ts' && !f.startsWith('.'))
+        .sort((a, b) => a.localeCompare(b));
+    const exports = entries.map((f) => {
+        const base = path.basename(f, '.ts');
+        const ident = toIdentifier(base);
+        // Export only the root schema to avoid name collisions across modules.
+        return `export { ${ident}Schema } from './${base}.js';`;
+    });
+    const content = `// Auto-generated barrel file. Do not edit.\n${exports.join('\n')}\n`;
+    fs.writeFileSync(path.join(zodDir, 'index.ts'), content, 'utf8');
+}
+async function main() {
+    try {
+        const config = getConfig();
+        const { name } = parseArgs(process.argv.slice(2));
+        if (!name)
+            throw new Error('Missing --name <DefName> argument');
+        const inPath = config.getStandaloneSchemaPath(`${name}.json`);
+        if (!fs.existsSync(inPath)) {
+            throw new Error(`Standalone schema not found at ${inPath}. Run generateStandaloneSchema -- --name ${name} first.`);
+        }
+        const raw = fs.readFileSync(inPath, 'utf8');
+        const parsed = JSON.parse(raw);
+        const { expressionsByName, warnings } = jsonSchemaToZodExpressions(parsed, name);
+        const zodDir = config.getZodSchemasDir();
+        const outPath = config.getZodSchemaPath(`${name}.ts`);
+        fs.mkdirSync(zodDir, { recursive: true });
+        const content = emitModule(name, expressionsByName, warnings);
+        fs.writeFileSync(outPath, content, 'utf8');
+        writeBarrelFile(zodDir);
+        if (warnings.length > 0) {
+            console.warn(`Generated Zod schema '${name}' with ${warnings.length} warning(s).`);
+        }
+        console.log(`Wrote ${outPath}`);
+    }
+    catch (e) {
+        console.error(e?.message ?? e);
+        process.exitCode = 1;
+    }
+}
+void main();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@toolproof-core/schema",
-  "version": "1.0.16",
+  "version": "1.0.18",
   "description": "JSON schemas and TypeScript types for ToolProof",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -21,6 +21,9 @@
   "publishConfig": {
     "access": "public"
   },
+  "dependencies": {
+    "zod": "^4.3.6"
+  },
   "devDependencies": {
     "@types/node": "^20.8.1",
     "json-schema-to-typescript": "^15.0.4",
@@ -34,6 +37,7 @@
     "normalizeAnchorsToPointers": "node ./dist/scripts/normalizeAnchorsToPointers.js",
     "extractSchemasFromResourceTypeShells": "node ./dist/scripts/extractSchemasFromResourceTypeShells.js",
     "generateStandaloneSchema": "node ./dist/scripts/generateStandaloneSchema.js",
+    "generateStandaloneZodSchema": "node ./dist/scripts/generateStandaloneZodSchema.js",
     "generateTypes": "node ./dist/scripts/generateTypes.js",
     "generateStandaloneType": "node ./dist/scripts/generateStandaloneType.js",
     "wrapResourceTypesWithResourceShells": "node ./dist/scripts/wrapResourceTypesWithResourceShells.js",
@@ -42,6 +46,6 @@
     "generateConstantsAndMappings": "node ./dist/scripts/generateConstantsAndMappings.js",
     "generateTerminals": "node ./dist/scripts/generateTerminals.js",
     "generateResourceTypeGenesisType": "node ./dist/scripts/generateStandaloneType.js --name Genesis",
-    "update": "rimraf /s /q dist && pnpm run build:scripts && pnpm run normalizeAnchorsToPointers && pnpm run extractSchemasFromResourceTypeShells && pnpm run generateConstantsAndMappings && pnpm run generateStandaloneSchema -- --name Job && pnpm run generateStandaloneSchema -- --name ResourceType && pnpm run generateStandaloneSchema -- --name RawStrategy && pnpm run generateStandaloneSchema -- --name RunnableStrategy && pnpm run generateStandaloneSchema -- --name StrategyRun && pnpm run generateStandaloneSchema -- --name Goal && pnpm run wrapResourceTypesWithResourceShells && pnpm run generateSchemaShims && pnpm run generateTypes && pnpm run generateStandaloneType -- --name Job && pnpm run generateStandaloneType -- --name ResourceType && pnpm run generateStandaloneType -- --name RawStrategy && pnpm run generateStandaloneType -- --name RunnableStrategy && pnpm run generateResourceTypeGenesisType && pnpm run generateDependencies && pnpm run generateTerminals && pnpm run build"
+    "update": "rimraf /s /q dist && pnpm run build:scripts && pnpm run normalizeAnchorsToPointers && pnpm run extractSchemasFromResourceTypeShells && pnpm run generateConstantsAndMappings && pnpm run generateStandaloneSchema -- --name Job && pnpm run generateStandaloneSchema -- --name ResourceType && pnpm run generateStandaloneSchema -- --name RawStrategy && pnpm run generateStandaloneSchema -- --name RunnableStrategy && pnpm run generateStandaloneSchema -- --name StrategyRun && pnpm run generateStandaloneSchema -- --name Goal && pnpm run generateStandaloneZodSchema -- --name Job && pnpm run generateStandaloneZodSchema -- --name ResourceType && pnpm run generateStandaloneZodSchema -- --name RawStrategy && pnpm run generateStandaloneZodSchema -- --name RunnableStrategy && pnpm run generateStandaloneZodSchema -- --name StrategyRun && pnpm run generateStandaloneZodSchema -- --name Goal && pnpm run wrapResourceTypesWithResourceShells && pnpm run generateSchemaShims && pnpm run generateTypes && pnpm run generateStandaloneType -- --name Job && pnpm run generateStandaloneType -- --name ResourceType && pnpm run generateStandaloneType -- --name RawStrategy && pnpm run generateStandaloneType -- --name RunnableStrategy && pnpm run generateResourceTypeGenesisType && pnpm run generateDependencies && pnpm run generateTerminals && pnpm run build"
   }
 }

package/src/generated/schemas/zod/Goal.ts

@@ -0,0 +1,8 @@
+// Auto-generated from standalone schema 'Goal'. Do not edit.
+import { z } from 'zod/v4';
+
+
+const GoalIdentitySchema: z.ZodTypeAny = z.lazy(() => z.string().regex(new RegExp("^GOAL-.+$")));
+const JobIdentitySchema: z.ZodTypeAny = z.lazy(() => z.string().regex(new RegExp("^JOB-.+$")));
+
+export const GoalSchema: z.ZodTypeAny = z.lazy(() => z.object({ "identity": GoalIdentitySchema, "target": z.number().int().min(0), "disallowedJobs": z.array(JobIdentitySchema).optional(), "disallowedSequences": z.array(z.array(JobIdentitySchema)).optional(), "minSteps": z.number().int().min(1).optional(), "maxSteps": z.number().int().min(1).optional() }).strict());

package/src/generated/schemas/zod/Job.ts

@@ -0,0 +1,26 @@
+// Auto-generated from standalone schema 'Job'. Do not edit.
+import { z } from 'zod/v4';
+
+
+export const JobZodGenerationWarnings = [
+  {
+    "path": "$defs.Roles.properties.outputDict.allOfMerged.propertyNames",
+    "message": "propertyNames on fixed-shape object not enforced by generated Zod."
+  }
+] as const;
+
+const DescriptionSchema: z.ZodTypeAny = z.lazy(() => z.string().min(1));
+const DescriptionFacetSchema: z.ZodTypeAny = z.lazy(() => z.object({ "description": DescriptionSchema }));
+const DocumentationFacetSchema: z.ZodTypeAny = z.lazy(() => z.object({ "name": NameSchema, "description": DescriptionSchema }));
+const JobIdentitySchema: z.ZodTypeAny = z.lazy(() => z.string().regex(new RegExp("^JOB-.+$")));
+const NameSchema: z.ZodTypeAny = z.lazy(() => z.string().min(1).regex(new RegExp("^(?:[A-Z][^0-9]*|[a-z]+/[a-z.+&-]+)$")));
+const NameFacetSchema: z.ZodTypeAny = z.lazy(() => z.object({ "name": NameSchema }));
+const ResourceRoleIdentitySchema: z.ZodTypeAny = z.lazy(() => z.string().regex(new RegExp("^ROLE-.+$")));
+const ResourceRoleValueSchema: z.ZodTypeAny = z.lazy(() => z.object({ "resourceTypeHandle": ResourceTypeIdentitySchema, "name": NameSchema, "description": DescriptionSchema }));
+const ResourceTypeIdentitySchema: z.ZodTypeAny = z.lazy(() => z.string().regex(new RegExp("^TYPE-.+$")));
+const RoleDictSchema: z.ZodTypeAny = z.lazy(() => z.record(z.string(), ResourceRoleValueSchema).superRefine((obj, ctx) => { for (const k of Object.keys(obj)) { if (!new RegExp("^ROLE-.+$").test(k)) ctx.addIssue({ code: 'custom', message: 'Invalid key: ' + k }); } }));
+const RolesSchema: z.ZodTypeAny = z.lazy(() => z.object({ "inputDict": RoleDictSchema, "outputDict": z.object({ "ROLE-ErrorOutput": z.object({ "resourceTypeHandle": z.intersection(ResourceTypeIdentitySchema, z.literal("TYPE-Error")), "name": z.intersection(NameSchema, z.literal("ErrorOutput")), "description": z.intersection(DescriptionSchema, z.literal("Represents error outputs from job runs.")) }) }).catchall(ResourceRoleValueSchema) }).strict());
+const RolesFacetSchema: z.ZodTypeAny = z.lazy(() => z.object({ "roles": RolesSchema }));
+const UriSchema: z.ZodTypeAny = z.lazy(() => z.string().url());
+
+export const JobSchema: z.ZodTypeAny = z.lazy(() => z.object({ "identity": JobIdentitySchema, "implementationUri": UriSchema, "name": NameSchema, "description": DescriptionSchema, "roles": RolesSchema }).strict());

package/src/generated/schemas/zod/RawStrategy.ts

@@ -0,0 +1,64 @@
+// Auto-generated from standalone schema 'RawStrategy'. Do not edit.
+import { z } from 'zod/v4';
+
+
+export const RawStrategyZodGenerationWarnings = [
+  {
+    "path": "$defs.StepArray.uniqueItems",
+    "message": "uniqueItems not enforced by generated Zod."
+  },
+  {
+    "path": "$defs.BranchStep.allOfMerged.properties.cases.uniqueItems",
+    "message": "uniqueItems not enforced by generated Zod."
+  },
+  {
+    "path": "$defs.Path.format",
+    "message": "Ignoring format 'uri-reference' (not enforced by generated Zod)."
+  }
+] as const;
+
+const BranchStepSchema: z.ZodTypeAny = z.lazy(() => z.object({ "identity": BranchStepIdentitySchema, "stepKind": z.intersection(z.literal("branch"), StepKindSchema), "cases": z.array(CaseSchema).min(1) }));
+const BranchStepIdentitySchema: z.ZodTypeAny = z.lazy(() => z.string().regex(new RegExp("^BRANCH_STEP-.+$")));
+const CaseSchema: z.ZodTypeAny = z.lazy(() => z.object({ "when": JobStepSchema, "what": JobStepSchema }).strict());
+const CreationContextSchema: z.ZodTypeAny = z.lazy(() => z.object({ "resourceRoleHandle": ResourceRoleIdentitySchema, "jobStepHandle": JobStepIdentitySchema }));
+const CreationContextFacetSchema: z.ZodTypeAny = z.lazy(() => z.object({ "creationContext": CreationContextSchema }));
+const ForStepSchema: z.ZodTypeAny = z.lazy(() => z.object({ "identity": ForStepIdentitySchema, "stepKind": z.intersection(z.literal("for"), StepKindSchema), "case": CaseSchema }));
+const ForStepIdentitySchema: z.ZodTypeAny = z.lazy(() => z.string().regex(new RegExp("^FOR_STEP-.+$")));
+const JobIdentitySchema: z.ZodTypeAny = z.lazy(() => z.string().regex(new RegExp("^JOB-.+$")));
+const JobStepSchema: z.ZodTypeAny = z.lazy(() => z.object({ "identity": JobStepIdentitySchema, "stepKind": z.intersection(z.literal("job"), StepKindSchema), "jobHandle": JobIdentitySchema, "roleBindings": RoleBindingsSchema }));
+const JobStepIdentitySchema: z.ZodTypeAny = z.lazy(() => z.string().regex(new RegExp("^JOB_STEP-.+$")));
+const JobStepSocketSchema: z.ZodTypeAny = z.lazy(() => z.record(z.string(), z.union([ResourcePotentialSchema, ResourceSchema])).superRefine((obj, ctx) => { for (const k of Object.keys(obj)) { if (!new RegExp("^ROLE-.+$").test(k)) ctx.addIssue({ code: 'custom', message: 'Invalid key: ' + k }); } }));
+const NucleusFacetSchema: z.ZodTypeAny = z.lazy(() => z.object({ "nucleus": z.any() }));
+const PathSchema: z.ZodTypeAny = z.lazy(() => z.string());
+const PathFacetSchema: z.ZodTypeAny = z.lazy(() => z.object({ "path": PathSchema }));
+const ResourceSchema: z.ZodTypeAny = z.lazy(() => z.object({ "version": z.literal(1), "resourceShellKind": z.intersection(z.intersection(z.literal("materialized"), ResourceShellKindSchema), ResourceShellKindSchema), "identity": ResourceIdentitySchema, "resourceTypeHandle": ResourceTypeIdentitySchema, "creationContext": CreationContextSchema, "timestamp": TimestampSchema, "path": PathSchema, "nucleus": z.any() }).strict());
+const ResourceIdentitySchema: z.ZodTypeAny = z.lazy(() => z.string().regex(new RegExp("^RESOURCE-.+$")));
+const ResourceInputPotentialSchema: z.ZodTypeAny = z.lazy(() => ShellInputPotentialSchema);
+const ResourceMissingSchema: z.ZodTypeAny = z.lazy(() => ShellMissingSchema);
+const ResourceOutputPotentialSchema: z.ZodTypeAny = z.lazy(() => ShellOutputPotentialSchema);
+const ResourcePotentialSchema: z.ZodTypeAny = z.lazy(() => z.union([ResourceMissingSchema, ResourceInputPotentialSchema, ResourceOutputPotentialSchema]));
+const ResourceRoleIdentitySchema: z.ZodTypeAny = z.lazy(() => z.string().regex(new RegExp("^ROLE-.+$")));
+const ResourceShellBaseSchema: z.ZodTypeAny = z.lazy(() => z.object({ "identity": ResourceIdentitySchema, "resourceTypeHandle": ResourceTypeIdentitySchema, "resourceShellKind": ResourceShellKindSchema }));
+const ResourceShellKindSchema: z.ZodTypeAny = z.lazy(() => z.union([z.literal("missing"), z.literal("inputPotential"), z.literal("outputPotential"), z.literal("materialized")]));
+const ResourceShellKindFacetSchema: z.ZodTypeAny = z.lazy(() => z.object({ "resourceShellKind": ResourceShellKindSchema }));
+const ResourceTypeIdentitySchema: z.ZodTypeAny = z.lazy(() => z.string().regex(new RegExp("^TYPE-.+$")));
+const RoleBindingArraySchema: z.ZodTypeAny = z.lazy(() => z.array(ResourceRoleIdentitySchema));
+const RoleBindingsSchema: z.ZodTypeAny = z.lazy(() => z.object({ "inputBindings": RoleBindingArraySchema, "outputBindings": RoleBindingArraySchema }));
+const RoleBindingsFacetSchema: z.ZodTypeAny = z.lazy(() => z.object({ "roleBindings": RoleBindingsSchema }));
+const ShellInputPotentialSchema: z.ZodTypeAny = z.lazy(() => z.object({ "resourceShellKind": z.intersection(z.intersection(z.literal("inputPotential"), ResourceShellKindSchema), ResourceShellKindSchema), "identity": ResourceIdentitySchema, "resourceTypeHandle": ResourceTypeIdentitySchema, "creationContext": CreationContextSchema }).strict());
+const ShellMaterializedBaseSchema: z.ZodTypeAny = z.lazy(() => z.object({ "version": z.literal(1), "resourceShellKind": z.intersection(z.intersection(z.literal("materialized"), ResourceShellKindSchema), ResourceShellKindSchema), "identity": ResourceIdentitySchema, "resourceTypeHandle": ResourceTypeIdentitySchema, "creationContext": CreationContextSchema, "timestamp": TimestampSchema, "path": PathSchema }));
+const ShellMissingSchema: z.ZodTypeAny = z.lazy(() => z.object({ "resourceShellKind": z.intersection(z.intersection(z.literal("missing"), ResourceShellKindSchema), ResourceShellKindSchema), "identity": ResourceIdentitySchema, "resourceTypeHandle": ResourceTypeIdentitySchema }).strict());
+const ShellOutputPotentialSchema: z.ZodTypeAny = z.lazy(() => z.object({ "resourceShellKind": z.intersection(z.intersection(z.literal("outputPotential"), ResourceShellKindSchema), ResourceShellKindSchema), "identity": ResourceIdentitySchema, "resourceTypeHandle": ResourceTypeIdentitySchema, "creationContext": CreationContextSchema }).strict());
+const StepSchema: z.ZodTypeAny = z.lazy(() => z.union([JobStepSchema, BranchStepSchema, WhileStepSchema, ForStepSchema]));
+const StepArraySchema: z.ZodTypeAny = z.lazy(() => z.array(StepSchema));
+const StepKindSchema: z.ZodTypeAny = z.lazy(() => z.union([z.literal("job"), z.literal("branch"), z.literal("while"), z.literal("for")]));
+const StepKindFacetSchema: z.ZodTypeAny = z.lazy(() => z.object({ "stepKind": StepKindSchema }));
+const StepsFacetSchema: z.ZodTypeAny = z.lazy(() => z.object({ "steps": StepArraySchema }));
+const StrategyStateSchema: z.ZodTypeAny = z.lazy(() => z.record(z.string(), JobStepSocketSchema).superRefine((obj, ctx) => { for (const k of Object.keys(obj)) { if (!new RegExp("^JOB_STEP-.+$").test(k)) ctx.addIssue({ code: 'custom', message: 'Invalid key: ' + k }); } }));
+const StrategyStateFacetSchema: z.ZodTypeAny = z.lazy(() => z.object({ "strategyState": StrategyStateSchema }));
+const TimestampSchema: z.ZodTypeAny = z.lazy(() => z.string().datetime());
+const TimestampFacetSchema: z.ZodTypeAny = z.lazy(() => z.object({ "timestamp": TimestampSchema }));
+const WhileStepSchema: z.ZodTypeAny = z.lazy(() => z.object({ "identity": WhileStepIdentitySchema, "stepKind": z.intersection(z.literal("while"), StepKindSchema), "case": CaseSchema }));
+const WhileStepIdentitySchema: z.ZodTypeAny = z.lazy(() => z.string().regex(new RegExp("^WHILE_STEP-.+$")));
+
+export const RawStrategySchema: z.ZodTypeAny = z.lazy(() => z.object({ "steps": StepArraySchema, "strategyState": StrategyStateSchema }).strict());

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

@@ -0,0 +1,13 @@
+// Auto-generated from standalone schema 'ResourceType'. Do not edit.
+import { z } from 'zod/v4';
+
+
+const DescriptionSchema: z.ZodTypeAny = z.lazy(() => z.string().min(1));
+const DescriptionFacetSchema: z.ZodTypeAny = z.lazy(() => z.object({ "description": DescriptionSchema }));
+const DocumentationFacetSchema: z.ZodTypeAny = z.lazy(() => z.object({ "name": NameSchema, "description": DescriptionSchema }));
+const NameSchema: z.ZodTypeAny = z.lazy(() => z.string().min(1).regex(new RegExp("^(?:[A-Z][^0-9]*|[a-z]+/[a-z.+&-]+)$")));
+const NameFacetSchema: z.ZodTypeAny = z.lazy(() => z.object({ "name": NameSchema }));
+const ResourceTypeIdentitySchema: z.ZodTypeAny = z.lazy(() => z.string().regex(new RegExp("^TYPE-.+$")));
+const UriSchema: z.ZodTypeAny = z.lazy(() => z.string().url());
+
+export const ResourceTypeSchema: z.ZodTypeAny = z.lazy(() => z.object({ "identity": ResourceTypeIdentitySchema, "nucleusSchema": z.any(), "embeddingUriDict": z.record(z.string(), UriSchema).superRefine((obj, ctx) => { for (const k of Object.keys(obj)) { if (!new RegExp("^EMBEDDING-.+$").test(k)) ctx.addIssue({ code: 'custom', message: 'Invalid key: ' + k }); } if (Object.keys(obj).length < 1) ctx.addIssue({ code: 'custom', message: 'Expected at least 1 properties' }); }).optional(), "generatorUriDict": z.record(z.string(), UriSchema).superRefine((obj, ctx) => { for (const k of Object.keys(obj)) { if (!new RegExp("^GENERATOR-.+$").test(k)) ctx.addIssue({ code: 'custom', message: 'Invalid key: ' + k }); } if (Object.keys(obj).length < 1) ctx.addIssue({ code: 'custom', message: 'Expected at least 1 properties' }); }).optional(), "name": NameSchema, "description": DescriptionSchema }));

package/src/generated/schemas/zod/RunnableStrategy.ts

@@ -0,0 +1,69 @@
+// Auto-generated from standalone schema 'RunnableStrategy'. Do not edit.
+import { z } from 'zod/v4';
+
+
+export const RunnableStrategyZodGenerationWarnings = [
+  {
+    "path": "$defs.StepArray.uniqueItems",
+    "message": "uniqueItems not enforced by generated Zod."
+  },
+  {
+    "path": "$defs.BranchStep.allOfMerged.properties.cases.uniqueItems",
+    "message": "uniqueItems not enforced by generated Zod."
+  },
+  {
+    "path": "$defs.Path.format",
+    "message": "Ignoring format 'uri-reference' (not enforced by generated Zod)."
+  }
+] as const;
+
+const BranchStepSchema: z.ZodTypeAny = z.lazy(() => z.object({ "identity": BranchStepIdentitySchema, "stepKind": z.intersection(z.literal("branch"), StepKindSchema), "cases": z.array(CaseSchema).min(1) }));
+const BranchStepIdentitySchema: z.ZodTypeAny = z.lazy(() => z.string().regex(new RegExp("^BRANCH_STEP-.+$")));
+const CaseSchema: z.ZodTypeAny = z.lazy(() => z.object({ "when": JobStepSchema, "what": JobStepSchema }).strict());
+const CreationContextSchema: z.ZodTypeAny = z.lazy(() => z.object({ "resourceRoleHandle": ResourceRoleIdentitySchema, "jobStepHandle": JobStepIdentitySchema }));
+const CreationContextFacetSchema: z.ZodTypeAny = z.lazy(() => z.object({ "creationContext": CreationContextSchema }));
+const ForStepSchema: z.ZodTypeAny = z.lazy(() => z.object({ "identity": ForStepIdentitySchema, "stepKind": z.intersection(z.literal("for"), StepKindSchema), "case": CaseSchema }));
+const ForStepIdentitySchema: z.ZodTypeAny = z.lazy(() => z.string().regex(new RegExp("^FOR_STEP-.+$")));
+const JobIdentitySchema: z.ZodTypeAny = z.lazy(() => z.string().regex(new RegExp("^JOB-.+$")));
+const JobStepSchema: z.ZodTypeAny = z.lazy(() => z.object({ "identity": JobStepIdentitySchema, "stepKind": z.intersection(z.literal("job"), StepKindSchema), "jobHandle": JobIdentitySchema, "roleBindings": RoleBindingsSchema }));
+const JobStepIdentitySchema: z.ZodTypeAny = z.lazy(() => z.string().regex(new RegExp("^JOB_STEP-.+$")));
+const JobStepSocketSchema: z.ZodTypeAny = z.lazy(() => z.record(z.string(), z.union([ResourcePotentialSchema, ResourceSchema])).superRefine((obj, ctx) => { for (const k of Object.keys(obj)) { if (!new RegExp("^ROLE-.+$").test(k)) ctx.addIssue({ code: 'custom', message: 'Invalid key: ' + k }); } }));
+const NucleusFacetSchema: z.ZodTypeAny = z.lazy(() => z.object({ "nucleus": z.any() }));
+const PathSchema: z.ZodTypeAny = z.lazy(() => z.string());
+const PathFacetSchema: z.ZodTypeAny = z.lazy(() => z.object({ "path": PathSchema }));
+const ResourceSchema: z.ZodTypeAny = z.lazy(() => z.object({ "version": z.literal(1), "resourceShellKind": z.intersection(z.intersection(z.literal("materialized"), ResourceShellKindSchema), ResourceShellKindSchema), "identity": ResourceIdentitySchema, "resourceTypeHandle": ResourceTypeIdentitySchema, "creationContext": CreationContextSchema, "timestamp": TimestampSchema, "path": PathSchema, "nucleus": z.any() }).strict());
+const ResourceIdentitySchema: z.ZodTypeAny = z.lazy(() => z.string().regex(new RegExp("^RESOURCE-.+$")));
+const ResourceInputPotentialSchema: z.ZodTypeAny = z.lazy(() => ShellInputPotentialSchema);
+const ResourceMissingSchema: z.ZodTypeAny = z.lazy(() => ShellMissingSchema);
+const ResourceOutputPotentialSchema: z.ZodTypeAny = z.lazy(() => ShellOutputPotentialSchema);
+const ResourcePotentialSchema: z.ZodTypeAny = z.lazy(() => z.union([ResourceMissingSchema, ResourceInputPotentialSchema, ResourceOutputPotentialSchema]));
+const ResourceRoleIdentitySchema: z.ZodTypeAny = z.lazy(() => z.string().regex(new RegExp("^ROLE-.+$")));
+const ResourceShellBaseSchema: z.ZodTypeAny = z.lazy(() => z.object({ "identity": ResourceIdentitySchema, "resourceTypeHandle": ResourceTypeIdentitySchema, "resourceShellKind": ResourceShellKindSchema }));
+const ResourceShellKindSchema: z.ZodTypeAny = z.lazy(() => z.union([z.literal("missing"), z.literal("inputPotential"), z.literal("outputPotential"), z.literal("materialized")]));
+const ResourceShellKindFacetSchema: z.ZodTypeAny = z.lazy(() => z.object({ "resourceShellKind": ResourceShellKindSchema }));
+const ResourceTypeIdentitySchema: z.ZodTypeAny = z.lazy(() => z.string().regex(new RegExp("^TYPE-.+$")));
+const RoleBindingArraySchema: z.ZodTypeAny = z.lazy(() => z.array(ResourceRoleIdentitySchema));
+const RoleBindingsSchema: z.ZodTypeAny = z.lazy(() => z.object({ "inputBindings": RoleBindingArraySchema, "outputBindings": RoleBindingArraySchema }));
+const RoleBindingsFacetSchema: z.ZodTypeAny = z.lazy(() => z.object({ "roleBindings": RoleBindingsSchema }));
+const RunnableStrategyContextSchema: z.ZodTypeAny = z.lazy(() => z.object({ "status": RunnableStrategyStatusSchema, "startedAt": TimestampSchema.optional(), "completedAt": TimestampSchema.optional() }).strict());
+const RunnableStrategyIdentitySchema: z.ZodTypeAny = z.lazy(() => z.string().regex(new RegExp("^RUNNABLE_STRATEGY-.+$")));
+const RunnableStrategyStatusSchema: z.ZodTypeAny = z.lazy(() => z.union([z.literal("pending"), z.literal("running"), z.literal("completed"), z.literal("failed"), z.literal("cancelled")]));
+const ShellInputPotentialSchema: z.ZodTypeAny = z.lazy(() => z.object({ "resourceShellKind": z.intersection(z.intersection(z.literal("inputPotential"), ResourceShellKindSchema), ResourceShellKindSchema), "identity": ResourceIdentitySchema, "resourceTypeHandle": ResourceTypeIdentitySchema, "creationContext": CreationContextSchema }).strict());
+const ShellMaterializedBaseSchema: z.ZodTypeAny = z.lazy(() => z.object({ "version": z.literal(1), "resourceShellKind": z.intersection(z.intersection(z.literal("materialized"), ResourceShellKindSchema), ResourceShellKindSchema), "identity": ResourceIdentitySchema, "resourceTypeHandle": ResourceTypeIdentitySchema, "creationContext": CreationContextSchema, "timestamp": TimestampSchema, "path": PathSchema }));
+const ShellMissingSchema: z.ZodTypeAny = z.lazy(() => z.object({ "resourceShellKind": z.intersection(z.intersection(z.literal("missing"), ResourceShellKindSchema), ResourceShellKindSchema), "identity": ResourceIdentitySchema, "resourceTypeHandle": ResourceTypeIdentitySchema }).strict());
+const ShellOutputPotentialSchema: z.ZodTypeAny = z.lazy(() => z.object({ "resourceShellKind": z.intersection(z.intersection(z.literal("outputPotential"), ResourceShellKindSchema), ResourceShellKindSchema), "identity": ResourceIdentitySchema, "resourceTypeHandle": ResourceTypeIdentitySchema, "creationContext": CreationContextSchema }).strict());
+const StepSchema: z.ZodTypeAny = z.lazy(() => z.union([JobStepSchema, BranchStepSchema, WhileStepSchema, ForStepSchema]));
+const StepArraySchema: z.ZodTypeAny = z.lazy(() => z.array(StepSchema));
+const StepKindSchema: z.ZodTypeAny = z.lazy(() => z.union([z.literal("job"), z.literal("branch"), z.literal("while"), z.literal("for")]));
+const StepKindFacetSchema: z.ZodTypeAny = z.lazy(() => z.object({ "stepKind": StepKindSchema }));
+const StrategyStateSchema: z.ZodTypeAny = z.lazy(() => z.record(z.string(), JobStepSocketSchema).superRefine((obj, ctx) => { for (const k of Object.keys(obj)) { if (!new RegExp("^JOB_STEP-.+$").test(k)) ctx.addIssue({ code: 'custom', message: 'Invalid key: ' + k }); } }));
+const StrategyStateFacetSchema: z.ZodTypeAny = z.lazy(() => z.object({ "strategyState": StrategyStateSchema }));
+const StrategyThreadDictSchema: z.ZodTypeAny = z.lazy(() => z.record(z.string(), StepArraySchema).superRefine((obj, ctx) => { for (const k of Object.keys(obj)) { if (!new RegExp("^STRATEGY_THREAD-.+$").test(k)) ctx.addIssue({ code: 'custom', message: 'Invalid key: ' + k }); } }));
+const StrategyThreadDictFacetSchema: z.ZodTypeAny = z.lazy(() => z.object({ "strategyThreadDict": StrategyThreadDictSchema }));
+const StrategyThreadIdentitySchema: z.ZodTypeAny = z.lazy(() => z.string().regex(new RegExp("^STRATEGY_THREAD-.+$")));
+const TimestampSchema: z.ZodTypeAny = z.lazy(() => z.string().datetime());
+const TimestampFacetSchema: z.ZodTypeAny = z.lazy(() => z.object({ "timestamp": TimestampSchema }));
+const WhileStepSchema: z.ZodTypeAny = z.lazy(() => z.object({ "identity": WhileStepIdentitySchema, "stepKind": z.intersection(z.literal("while"), StepKindSchema), "case": CaseSchema }));
+const WhileStepIdentitySchema: z.ZodTypeAny = z.lazy(() => z.string().regex(new RegExp("^WHILE_STEP-.+$")));
+
+export const RunnableStrategySchema: z.ZodTypeAny = z.lazy(() => z.object({ "identity": RunnableStrategyIdentitySchema, "runnableStrategyContext": RunnableStrategyContextSchema, "strategyThreadDict": StrategyThreadDictSchema, "strategyState": StrategyStateSchema }).strict());

package/src/generated/schemas/zod/StrategyRun.ts

@@ -0,0 +1,83 @@
+// Auto-generated from standalone schema 'StrategyRun'. Do not edit.
+import { z } from 'zod/v4';
+
+
+export const StrategyRunZodGenerationWarnings = [
+  {
+    "path": "$defs.StepArray.uniqueItems",
+    "message": "uniqueItems not enforced by generated Zod."
+  },
+  {
+    "path": "$defs.BranchStep.allOfMerged.properties.cases.uniqueItems",
+    "message": "uniqueItems not enforced by generated Zod."
+  },
+  {
+    "path": "$defs.Path.format",
+    "message": "Ignoring format 'uri-reference' (not enforced by generated Zod)."
+  }
+] as const;
+
+const BranchStepSchema: z.ZodTypeAny = z.lazy(() => z.object({ "identity": BranchStepIdentitySchema, "stepKind": z.intersection(z.literal("branch"), StepKindSchema), "cases": z.array(CaseSchema).min(1) }));
+const BranchStepIdentitySchema: z.ZodTypeAny = z.lazy(() => z.string().regex(new RegExp("^BRANCH_STEP-.+$")));
+const CaseSchema: z.ZodTypeAny = z.lazy(() => z.object({ "when": JobStepSchema, "what": JobStepSchema }).strict());
+const CreationContextSchema: z.ZodTypeAny = z.lazy(() => z.object({ "resourceRoleHandle": ResourceRoleIdentitySchema, "jobStepHandle": JobStepIdentitySchema }));
+const CreationContextFacetSchema: z.ZodTypeAny = z.lazy(() => z.object({ "creationContext": CreationContextSchema }));
+const ForStepSchema: z.ZodTypeAny = z.lazy(() => z.object({ "identity": ForStepIdentitySchema, "stepKind": z.intersection(z.literal("for"), StepKindSchema), "case": CaseSchema }));
+const ForStepIdentitySchema: z.ZodTypeAny = z.lazy(() => z.string().regex(new RegExp("^FOR_STEP-.+$")));
+const GraphEndRunEventSchema: z.ZodTypeAny = z.lazy(() => z.object({ "runEventKind": z.intersection(RunEventKindSchema, z.literal("graph_end")), "runnableStrategyHandle": RunnableStrategyIdentitySchema, "strategyThreadHandle": StrategyThreadIdentitySchema, "createdAt": TimestampSchema, "nodeName": z.string(), "eventSeq": z.number().int(), "counters": RunEventCountersSchema.optional(), "stepMetadata": RunEventStepMetadataSchema.optional(), "updates": RunEventUpdatesSchema.optional() }));
+const GraphStartRunEventSchema: z.ZodTypeAny = z.lazy(() => z.object({ "runEventKind": z.intersection(RunEventKindSchema, z.literal("graph_start")), "runnableStrategyHandle": RunnableStrategyIdentitySchema, "strategyThreadHandle": StrategyThreadIdentitySchema, "createdAt": TimestampSchema, "nodeName": z.string(), "eventSeq": z.number().int(), "counters": RunEventCountersSchema.optional(), "stepMetadata": RunEventStepMetadataSchema.optional(), "updates": RunEventUpdatesSchema.optional(), "runnableStrategySeed": RunnableStrategySchema }));
+const InterruptRunEventSchema: z.ZodTypeAny = z.lazy(() => z.object({ "runEventKind": z.intersection(RunEventKindSchema, z.literal("interrupt")), "runnableStrategyHandle": RunnableStrategyIdentitySchema, "strategyThreadHandle": StrategyThreadIdentitySchema, "createdAt": TimestampSchema, "nodeName": z.string(), "eventSeq": z.number().int(), "counters": RunEventCountersSchema.optional(), "stepMetadata": RunEventStepMetadataSchema.optional(), "updates": RunEventUpdatesSchema.optional() }));
+const JobIdentitySchema: z.ZodTypeAny = z.lazy(() => z.string().regex(new RegExp("^JOB-.+$")));
+const JobStepSchema: z.ZodTypeAny = z.lazy(() => z.object({ "identity": JobStepIdentitySchema, "stepKind": z.intersection(z.literal("job"), StepKindSchema), "jobHandle": JobIdentitySchema, "roleBindings": RoleBindingsSchema }));
+const JobStepIdentitySchema: z.ZodTypeAny = z.lazy(() => z.string().regex(new RegExp("^JOB_STEP-.+$")));
+const JobStepSocketSchema: z.ZodTypeAny = z.lazy(() => z.record(z.string(), z.union([ResourcePotentialSchema, ResourceSchema])).superRefine((obj, ctx) => { for (const k of Object.keys(obj)) { if (!new RegExp("^ROLE-.+$").test(k)) ctx.addIssue({ code: 'custom', message: 'Invalid key: ' + k }); } }));
+const NucleusFacetSchema: z.ZodTypeAny = z.lazy(() => z.object({ "nucleus": z.any() }));
+const PathSchema: z.ZodTypeAny = z.lazy(() => z.string());
+const PathFacetSchema: z.ZodTypeAny = z.lazy(() => z.object({ "path": PathSchema }));
+const ResourceSchema: z.ZodTypeAny = z.lazy(() => z.object({ "version": z.literal(1), "resourceShellKind": z.intersection(z.intersection(z.literal("materialized"), ResourceShellKindSchema), ResourceShellKindSchema), "identity": ResourceIdentitySchema, "resourceTypeHandle": ResourceTypeIdentitySchema, "creationContext": CreationContextSchema, "timestamp": TimestampSchema, "path": PathSchema, "nucleus": z.any() }).strict());
+const ResourceIdentitySchema: z.ZodTypeAny = z.lazy(() => z.string().regex(new RegExp("^RESOURCE-.+$")));
+const ResourceInputPotentialSchema: z.ZodTypeAny = z.lazy(() => ShellInputPotentialSchema);
+const ResourceMissingSchema: z.ZodTypeAny = z.lazy(() => ShellMissingSchema);
+const ResourceOutputPotentialSchema: z.ZodTypeAny = z.lazy(() => ShellOutputPotentialSchema);
+const ResourcePotentialSchema: z.ZodTypeAny = z.lazy(() => z.union([ResourceMissingSchema, ResourceInputPotentialSchema, ResourceOutputPotentialSchema]));
+const ResourceRoleIdentitySchema: z.ZodTypeAny = z.lazy(() => z.string().regex(new RegExp("^ROLE-.+$")));
+const ResourceShellBaseSchema: z.ZodTypeAny = z.lazy(() => z.object({ "identity": ResourceIdentitySchema, "resourceTypeHandle": ResourceTypeIdentitySchema, "resourceShellKind": ResourceShellKindSchema }));
+const ResourceShellKindSchema: z.ZodTypeAny = z.lazy(() => z.union([z.literal("missing"), z.literal("inputPotential"), z.literal("outputPotential"), z.literal("materialized")]));
+const ResourceShellKindFacetSchema: z.ZodTypeAny = z.lazy(() => z.object({ "resourceShellKind": ResourceShellKindSchema }));
+const ResourceTypeIdentitySchema: z.ZodTypeAny = z.lazy(() => z.string().regex(new RegExp("^TYPE-.+$")));
+const RoleBindingArraySchema: z.ZodTypeAny = z.lazy(() => z.array(ResourceRoleIdentitySchema));
+const RoleBindingsSchema: z.ZodTypeAny = z.lazy(() => z.object({ "inputBindings": RoleBindingArraySchema, "outputBindings": RoleBindingArraySchema }));
+const RoleBindingsFacetSchema: z.ZodTypeAny = z.lazy(() => z.object({ "roleBindings": RoleBindingsSchema }));
+const RunEventSchema: z.ZodTypeAny = z.lazy(() => z.union([GraphStartRunEventSchema, TickRunEventSchema, InterruptRunEventSchema, GraphEndRunEventSchema]));
+const RunEventBaseSchema: z.ZodTypeAny = z.lazy(() => z.object({ "runEventKind": RunEventKindSchema, "runnableStrategyHandle": RunnableStrategyIdentitySchema, "strategyThreadHandle": StrategyThreadIdentitySchema, "createdAt": TimestampSchema, "nodeName": z.string(), "eventSeq": z.number().int(), "counters": RunEventCountersSchema.optional(), "stepMetadata": RunEventStepMetadataSchema.optional(), "updates": RunEventUpdatesSchema.optional() }));
+const RunEventCountersSchema: z.ZodTypeAny = z.lazy(() => z.object({ "stepCounterAfter": z.number().int().optional(), "iterationCounterAfter": z.number().int().optional() }));
+const RunEventKindSchema: z.ZodTypeAny = z.lazy(() => z.union([z.literal("graph_start"), z.literal("tick"), z.literal("interrupt"), z.literal("graph_end")]));
+const RunEventStepMetadataSchema: z.ZodTypeAny = z.lazy(() => z.object({ "stepHandle": StepIdentitySchema, "stepKind": StepKindSchema, "threadStepIndex": z.number().int() }));
+const RunEventUpdatesSchema: z.ZodTypeAny = z.lazy(() => z.object({ "stepsMutation": z.object({ "insertAt": z.number().int(), "inserted": StepArraySchema }).optional(), "interruptData": z.union([z.object({  }), z.null()]).optional(), "strategyStateUpdate": StrategyStateSchema }));
+const RunnableStrategySchema: z.ZodTypeAny = z.lazy(() => z.object({ "identity": RunnableStrategyIdentitySchema, "runnableStrategyContext": RunnableStrategyContextSchema, "strategyThreadDict": StrategyThreadDictSchema, "strategyState": StrategyStateSchema }).strict());
+const RunnableStrategyContextSchema: z.ZodTypeAny = z.lazy(() => z.object({ "status": RunnableStrategyStatusSchema, "startedAt": TimestampSchema.optional(), "completedAt": TimestampSchema.optional() }).strict());
+const RunnableStrategyIdentitySchema: z.ZodTypeAny = z.lazy(() => z.string().regex(new RegExp("^RUNNABLE_STRATEGY-.+$")));
+const RunnableStrategyStatusSchema: z.ZodTypeAny = z.lazy(() => z.union([z.literal("pending"), z.literal("running"), z.literal("completed"), z.literal("failed"), z.literal("cancelled")]));
+const ShellInputPotentialSchema: z.ZodTypeAny = z.lazy(() => z.object({ "resourceShellKind": z.intersection(z.intersection(z.literal("inputPotential"), ResourceShellKindSchema), ResourceShellKindSchema), "identity": ResourceIdentitySchema, "resourceTypeHandle": ResourceTypeIdentitySchema, "creationContext": CreationContextSchema }).strict());
+const ShellMaterializedBaseSchema: z.ZodTypeAny = z.lazy(() => z.object({ "version": z.literal(1), "resourceShellKind": z.intersection(z.intersection(z.literal("materialized"), ResourceShellKindSchema), ResourceShellKindSchema), "identity": ResourceIdentitySchema, "resourceTypeHandle": ResourceTypeIdentitySchema, "creationContext": CreationContextSchema, "timestamp": TimestampSchema, "path": PathSchema }));
+const ShellMissingSchema: z.ZodTypeAny = z.lazy(() => z.object({ "resourceShellKind": z.intersection(z.intersection(z.literal("missing"), ResourceShellKindSchema), ResourceShellKindSchema), "identity": ResourceIdentitySchema, "resourceTypeHandle": ResourceTypeIdentitySchema }).strict());
+const ShellOutputPotentialSchema: z.ZodTypeAny = z.lazy(() => z.object({ "resourceShellKind": z.intersection(z.intersection(z.literal("outputPotential"), ResourceShellKindSchema), ResourceShellKindSchema), "identity": ResourceIdentitySchema, "resourceTypeHandle": ResourceTypeIdentitySchema, "creationContext": CreationContextSchema }).strict());
+const StepSchema: z.ZodTypeAny = z.lazy(() => z.union([JobStepSchema, BranchStepSchema, WhileStepSchema, ForStepSchema]));
+const StepArraySchema: z.ZodTypeAny = z.lazy(() => z.array(StepSchema));
+const StepIdentitySchema: z.ZodTypeAny = z.lazy(() => z.union([JobStepIdentitySchema, BranchStepIdentitySchema, WhileStepIdentitySchema, ForStepIdentitySchema]));
+const StepKindSchema: z.ZodTypeAny = z.lazy(() => z.union([z.literal("job"), z.literal("branch"), z.literal("while"), z.literal("for")]));
+const StepKindFacetSchema: z.ZodTypeAny = z.lazy(() => z.object({ "stepKind": StepKindSchema }));
+const StrategyRunIdentitySchema: z.ZodTypeAny = z.lazy(() => z.string().regex(new RegExp("^STRATEGY_RUN-.+$")));
+const StrategyStateSchema: z.ZodTypeAny = z.lazy(() => z.record(z.string(), JobStepSocketSchema).superRefine((obj, ctx) => { for (const k of Object.keys(obj)) { if (!new RegExp("^JOB_STEP-.+$").test(k)) ctx.addIssue({ code: 'custom', message: 'Invalid key: ' + k }); } }));
+const StrategyStateDeltaSchema: z.ZodTypeAny = z.lazy(() => z.object({ "strategyStateUpdate": StrategyStateSchema }));
+const StrategyStateFacetSchema: z.ZodTypeAny = z.lazy(() => z.object({ "strategyState": StrategyStateSchema }));
+const StrategyThreadDictSchema: z.ZodTypeAny = z.lazy(() => z.record(z.string(), StepArraySchema).superRefine((obj, ctx) => { for (const k of Object.keys(obj)) { if (!new RegExp("^STRATEGY_THREAD-.+$").test(k)) ctx.addIssue({ code: 'custom', message: 'Invalid key: ' + k }); } }));
+const StrategyThreadDictFacetSchema: z.ZodTypeAny = z.lazy(() => z.object({ "strategyThreadDict": StrategyThreadDictSchema }));
+const StrategyThreadIdentitySchema: z.ZodTypeAny = z.lazy(() => z.string().regex(new RegExp("^STRATEGY_THREAD-.+$")));
+const TickRunEventSchema: z.ZodTypeAny = z.lazy(() => z.object({ "runEventKind": z.intersection(RunEventKindSchema, z.literal("tick")), "runnableStrategyHandle": RunnableStrategyIdentitySchema, "strategyThreadHandle": StrategyThreadIdentitySchema, "createdAt": TimestampSchema, "nodeName": z.string(), "eventSeq": z.number().int(), "counters": RunEventCountersSchema.optional(), "stepMetadata": RunEventStepMetadataSchema.optional(), "updates": RunEventUpdatesSchema.optional() }));
+const TimestampSchema: z.ZodTypeAny = z.lazy(() => z.string().datetime());
+const TimestampFacetSchema: z.ZodTypeAny = z.lazy(() => z.object({ "timestamp": TimestampSchema }));
+const WhileStepSchema: z.ZodTypeAny = z.lazy(() => z.object({ "identity": WhileStepIdentitySchema, "stepKind": z.intersection(z.literal("while"), StepKindSchema), "case": CaseSchema }));
+const WhileStepIdentitySchema: z.ZodTypeAny = z.lazy(() => z.string().regex(new RegExp("^WHILE_STEP-.+$")));
+
+export const StrategyRunSchema: z.ZodTypeAny = z.lazy(() => z.object({ "identity": StrategyRunIdentitySchema, "runnableStrategyHandle": RunnableStrategyIdentitySchema, "recordedAt": TimestampSchema, "runEvents": z.array(RunEventSchema) }).strict());

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

@@ -0,0 +1,7 @@
+// Auto-generated barrel file. Do not edit.
+export { GoalSchema } from './Goal.js';
+export { JobSchema } from './Job.js';
+export { RawStrategySchema } from './RawStrategy.js';
+export { ResourceTypeSchema } from './ResourceType.js';
+export { RunnableStrategySchema } from './RunnableStrategy.js';
+export { StrategyRunSchema } from './StrategyRun.js';

package/src/index.ts

@@ -8,6 +8,20 @@ export { default as ResourceGenesis } from './generated/resources/Genesis.js';
 export { default as CONSTANTS } from './generated/artifacts/constants.js';
 export { default as MAPPINGS } from './generated/artifacts/mappings.js';
 
+// Re-export internals // ATTENTION: does this work?
+export { default as NATURALS } from './internals/naturals.json';
+export { default as BOOLEANS } from './internals/booleans.json';
+export { default as JOBS } from './internals/jobs.json';
+
+// Re-export generated Zod validators
+export { JobSchema as ZodJobSchema } from './generated/schemas/zod/Job.js';
+export { ResourceTypeSchema as ZodResourceTypeSchema } from './generated/schemas/zod/ResourceType.js';
+export { RawStrategySchema as ZodRawStrategySchema } from './generated/schemas/zod/RawStrategy.js';
+export { RunnableStrategySchema as ZodRunnableStrategySchema } from './generated/schemas/zod/RunnableStrategy.js';
+export { StrategyRunSchema as ZodStrategyRunSchema } from './generated/schemas/zod/StrategyRun.js';
+export { GoalSchema as ZodGoalSchema } from './generated/schemas/zod/Goal.js';
+export * as ZodSchemas from './generated/schemas/zod/index.js';
+
 
 export type {
   Resource_Genesis as Resource_GenesisJson
@@ -54,6 +68,7 @@ export type {
   ResourceMissingJson,
   ResourceInputPotentialJson,
   ResourceOutputPotentialJson,
+  ResourcePotentialJson,
   ShellMaterializedBaseJson,
   ResourceJson,
   StrategyStateJson,

package/src/internals/booleans.json

@@ -0,0 +1,32 @@
+[
+    {
+        "identity": "RESOURCE-False",
+        "resourceTypeHandle": "TYPE-Boolean",
+        "creationContext": {
+            "resourceRoleHandle": "ROLE-Manual",
+            "jobStepHandle": "JOB_STEP-Genesis"
+        },
+        "resourceShellKind": "materialized",
+        "version": 1,
+        "path": "internals://boolean/false",
+        "timestamp": "2025-11-30T00:00:00.000Z",
+        "nucleus": {
+            "identity": false
+        }
+    },
+    {
+        "identity": "RESOURCE-True",
+        "resourceTypeHandle": "TYPE-Boolean",
+        "creationContext": {
+            "resourceRoleHandle": "ROLE-Manual",
+            "jobStepHandle": "JOB_STEP-Genesis"
+        },
+        "resourceShellKind": "materialized",
+        "version": 1,
+        "path": "internals://boolean/true",
+        "timestamp": "2025-11-30T00:00:00.000Z",
+        "nucleus": {
+            "identity": true
+        }
+    }
+]