@toolproof-core/schema 1.0.15 → 1.0.17

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.15",
+  "version": "1.0.17",
   "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/Genesis.json

@@ -1087,41 +1087,6 @@
                     "unevaluatedProperties": false
                 }
             },
-            "JsonData": {
-                "identity": "TYPE-JsonData",
-                "name": "JsonData",
-                "description": "dummy-description",
-                "nucleusSchema": {
-                    "$anchor": "JsonData",
-                    "$schema": "https://json-schema.org/draft/2020-12/schema",
-                    "oneOf": [
-                        {
-                            "type": "null"
-                        },
-                        {
-                            "type": "boolean"
-                        },
-                        {
-                            "type": "number"
-                        },
-                        {
-                            "type": "string"
-                        },
-                        {
-                            "type": "array",
-                            "items": {
-                                "$ref": "#JsonData"
-                            }
-                        },
-                        {
-                            "type": "object",
-                            "additionalProperties": {
-                                "$ref": "#JsonData"
-                            }
-                        }
-                    ]
-                }
-            },
             "Nucleus": {
                 "identity": "TYPE-Nucleus",
                 "name": "Nucleus",
@@ -1130,9 +1095,8 @@
                     "$anchor": "Nucleus",
                     "$schema": "https://json-schema.org/draft/2020-12/schema",
                     "type": "object",
-                    "additionalProperties": {
-                        "$ref": "#JsonData"
-                    }
+                    "additionalProperties": true,
+                    "$comment": "Currently not used."
                 }
             },
             "NucleusFacet": {

package/src/generated/artifacts/constants.ts

@@ -23,7 +23,6 @@ const CONSTANTS = {
         JobStep: 'JobStep',
         JobStepIdentity: 'JobStepIdentity',
         JobStepSocket: 'JobStepSocket',
-        JsonData: 'JsonData',
         Name: 'Name',
         NameFacet: 'NameFacet',
         Natural: 'Natural',

package/src/generated/artifacts/dependencyMap.json

@@ -164,10 +164,7 @@
         "ResourceInputPotential",
         "ResourceOutputPotential"
     ],
-    "JsonData": [],
-    "Nucleus": [
-        "JsonData"
-    ],
+    "Nucleus": [],
     "NucleusFacet": [],
     "Resource": [
         "ShellMaterializedBase",

package/src/generated/normalized/Genesis.json

@@ -1034,40 +1034,6 @@
                     "unevaluatedProperties": false
                 }
             },
-            "JsonData": {
-                "identity": "TYPE-JsonData",
-                "name": "JsonData",
-                "description": "dummy-description",
-                "nucleusSchema": {
-                    "$schema": "https://json-schema.org/draft/2020-12/schema",
-                    "oneOf": [
-                        {
-                            "type": "null"
-                        },
-                        {
-                            "type": "boolean"
-                        },
-                        {
-                            "type": "number"
-                        },
-                        {
-                            "type": "string"
-                        },
-                        {
-                            "type": "array",
-                            "items": {
-                                "$ref": "#/$defs/JsonData"
-                            }
-                        },
-                        {
-                            "type": "object",
-                            "additionalProperties": {
-                                "$ref": "#/$defs/JsonData"
-                            }
-                        }
-                    ]
-                }
-            },
             "Nucleus": {
                 "identity": "TYPE-Nucleus",
                 "name": "Nucleus",
@@ -1075,9 +1041,8 @@
                 "nucleusSchema": {
                     "$schema": "https://json-schema.org/draft/2020-12/schema",
                     "type": "object",
-                    "additionalProperties": {
-                        "$ref": "#/$defs/JsonData"
-                    }
+                    "additionalProperties": true,
+                    "$comment": "Currently not used."
                 }
             },
             "NucleusFacet": {

package/src/generated/resources/Genesis.json

@@ -1663,52 +1663,6 @@
             }
         }
     },
-    "JsonData": {
-        "identity": "RESOURCE-JsonData",
-        "resourceTypeHandle": "TYPE-ResourceType",
-        "creationContext": {
-            "resourceRoleHandle": "ROLE-Genesis",
-            "jobStepHandle": "JOB_STEP-Genesis"
-        },
-        "resourceShellKind": "materialized",
-        "version": 1,
-        "timestamp": "2025-11-30T00:00:00.000Z",
-        "path": "https://schemas.toolproof.com/v1/Genesis.json#/$defs/JsonData",
-        "nucleus": {
-            "identity": "TYPE-JsonData",
-            "name": "JsonData",
-            "description": "dummy-description",
-            "nucleusSchema": {
-                "$schema": "https://json-schema.org/draft/2020-12/schema",
-                "oneOf": [
-                    {
-                        "type": "null"
-                    },
-                    {
-                        "type": "boolean"
-                    },
-                    {
-                        "type": "number"
-                    },
-                    {
-                        "type": "string"
-                    },
-                    {
-                        "type": "array",
-                        "items": {
-                            "$ref": "#/$defs/JsonData"
-                        }
-                    },
-                    {
-                        "type": "object",
-                        "additionalProperties": {
-                            "$ref": "#/$defs/JsonData"
-                        }
-                    }
-                ]
-            }
-        }
-    },
     "Nucleus": {
         "identity": "RESOURCE-Nucleus",
         "resourceTypeHandle": "TYPE-ResourceType",
@@ -1727,9 +1681,8 @@
             "nucleusSchema": {
                 "$schema": "https://json-schema.org/draft/2020-12/schema",
                 "type": "object",
-                "additionalProperties": {
-                    "$ref": "#/$defs/JsonData"
-                }
+                "additionalProperties": true,
+                "$comment": "Currently not used."
             }
         }
     },

package/src/generated/schemas/Genesis.json

@@ -767,41 +767,11 @@
             ],
             "unevaluatedProperties": false
         },
-        "JsonData": {
-            "$schema": "https://json-schema.org/draft/2020-12/schema",
-            "oneOf": [
-                {
-                    "type": "null"
-                },
-                {
-                    "type": "boolean"
-                },
-                {
-                    "type": "number"
-                },
-                {
-                    "type": "string"
-                },
-                {
-                    "type": "array",
-                    "items": {
-                        "$ref": "#/$defs/JsonData"
-                    }
-                },
-                {
-                    "type": "object",
-                    "additionalProperties": {
-                        "$ref": "#/$defs/JsonData"
-                    }
-                }
-            ]
-        },
         "Nucleus": {
             "$schema": "https://json-schema.org/draft/2020-12/schema",
             "type": "object",
-            "additionalProperties": {
-                "$ref": "#/$defs/JsonData"
-            }
+            "additionalProperties": true,
+            "$comment": "Currently not used."
         },
         "NucleusFacet": {
             "$schema": "https://json-schema.org/draft/2020-12/schema",

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());