@toolproof-core/schema 1.0.9 → 1.0.11

package/dist/generated/schemas/Genesis.json

@@ -1,7 +1,7 @@
 {
     "$schema": "https://json-schema.org/draft/2020-12/schema",
     "$comment": "This file defines all schemas used internally by ToolProof.",
-    "$id": "https://schemas.toolproof.com/v2/Genesis.json",
+    "$id": "https://schemas.toolproof.com/v1/Genesis.json",
     "$defs": {
         "Name": {
             "$schema": "https://json-schema.org/draft/2020-12/schema",
@@ -76,7 +76,7 @@
                     "$ref": "#/$defs/ResourceTypeIdentity"
                 },
                 "nucleusSchema": true,
-                "embeddingUriMap": {
+                "embeddingUriDict": {
                     "type": "object",
                     "propertyNames": {
                         "type": "string",
@@ -86,9 +86,9 @@
                         "$ref": "#/$defs/Uri"
                     },
                     "minProperties": 1,
-                    "$comment": "A ResourceType may specify a set of embedding models that convert the raw data (or one of its alternative representations) into vector embeddings. The build process enforces that the keys of this map are members of a set of predefined embedding models."
+                    "$comment": "A ResourceType may specify a set of embedding models that convert the raw data (or one of its alternative representations) into vector embeddings. The build process enforces that the keys of this dict are members of a set of predefined embedding models."
                 },
-                "generatorUriMap": {
+                "generatorUriDict": {
                     "type": "object",
                     "propertyNames": {
                         "type": "string",
@@ -98,7 +98,7 @@
                         "$ref": "#/$defs/Uri"
                     },
                     "minProperties": 1,
-                    "$comment": "A ResourceType may specify a set of generators that generate different representations of its instances from the raw file. A ToolProof Resource is always backed by a raw file. This is also true for the Resources (of type ResourceType) defined in this file! The build process enforces that the keys of this map are members of a set of predefined generators. GENERATOR-Json is an identifier for a generator that generates JSON data from the raw file. If the raw file is a JSON file, GENERATOR-Json is an implicit identity operation (i.e. an operation that does nothing) and must not be present in the map. A ResourceType may also specify other generators, such as GENERATOR-LeanTerm, which generates an instance (or 'term' in Lean jargon) of a corresponding Lean type from the raw file. ResourceTypes that specify GENERATOR-LeanTerm must also specify a corresponding GENERATOR-LeanType. While the term-version runs when data instances enter the ecosystem, the type-version runs when the ResourceType itself enters the ecosystem."
+                    "$comment": "A ResourceType may specify a set of generators that generate different representations of its instances from the raw file. A ToolProof Resource is always backed by a raw file. This is also true for the Resources (of type ResourceType) defined in this file! The build process enforces that the keys of this dict are members of a set of predefined generators. GENERATOR-Json is an identifier for a generator that generates JSON data from the raw file. If the raw file is a JSON file, GENERATOR-Json is an implicit identity operation (i.e. an operation that does nothing) and must not be present in the dict. A ResourceType may also specify other generators, such as GENERATOR-LeanTerm, which generates an instance (or 'term' in Lean jargon) of a corresponding Lean type from the raw file. ResourceTypes that specify GENERATOR-LeanTerm must also specify a corresponding GENERATOR-LeanType. While the term-version runs when data instances enter the ecosystem, the type-version runs when the ResourceType itself enters the ecosystem."
                 }
             },
             "allOf": [
@@ -117,7 +117,6 @@
             "type": "object",
             "allOf": [
                 {
-                    "$comment": "A ResourceRole does not have a self-contained identity, as it is always defined in the context of a RoleMap. ResourceRoleValue uses the Value suffix to mean 'the value stored in this map' (RoleMap.additionalProperties).",
                     "required": [
                         "resourceTypeHandle"
                     ],
@@ -132,7 +131,27 @@
                 }
             ]
         },
-        "RoleMap": {
+        "ResourceRole": {
+            "$schema": "https://json-schema.org/draft/2020-12/schema",
+            "type": "object",
+            "allOf": [
+                {
+                    "type": "object",
+                    "required": [
+                        "identity"
+                    ],
+                    "properties": {
+                        "identity": {
+                            "$ref": "#/$defs/ResourceRoleIdentity"
+                        }
+                    }
+                },
+                {
+                    "$ref": "#/$defs/ResourceRoleValue"
+                }
+            ]
+        },
+        "RoleDict": {
             "$schema": "https://json-schema.org/draft/2020-12/schema",
             "type": "object",
             "propertyNames": {
@@ -163,19 +182,20 @@
             "$schema": "https://json-schema.org/draft/2020-12/schema",
             "type": "object",
             "required": [
-                "inputMap",
-                "outputMap"
+                "inputDict",
+                "outputDict"
             ],
             "properties": {
-                "inputMap": {
-                    "$ref": "#/$defs/RoleMap"
+                "inputDict": {
+                    "$ref": "#/$defs/RoleDict"
                 },
-                "outputMap": {
+                "outputDict": {
                     "allOf": [
                         {
-                            "$ref": "#/$defs/RoleMap"
+                            "$ref": "#/$defs/RoleDict"
                         },
                         {
+                            "type": "object",
                             "required": [
                                 "ROLE-ErrorOutput"
                             ],
@@ -242,6 +262,7 @@
                     "$ref": "#/$defs/JobIdentity"
                 },
                 "implementationUri": {
+                    "$comment": "Instances of a ResourceType that requires implementationUri are 'executable' ResourceTypes. TYPE-Job is the canonical executable ResourceType in the ecosystem.",
                     "$ref": "#/$defs/Uri"
                 }
             },
@@ -534,7 +555,7 @@
             "required": [
                 "identity",
                 "resourceTypeHandle",
-                "resourceKind"
+                "resourceShellKind"
             ],
             "properties": {
                 "identity": {
@@ -543,12 +564,12 @@
                 "resourceTypeHandle": {
                     "$ref": "#/$defs/ResourceTypeIdentity"
                 },
-                "resourceKind": {
-                    "$ref": "#/$defs/ResourceKind"
+                "resourceShellKind": {
+                    "$ref": "#/$defs/ResourceShellKind"
                 }
             }
         },
-        "ResourceKind": {
+        "ResourceShellKind": {
             "$schema": "https://json-schema.org/draft/2020-12/schema",
             "type": "string",
             "enum": [
@@ -558,23 +579,26 @@
                 "materialized"
             ]
         },
-        "ResourceKindFacet": {
+        "ResourceShellKindFacet": {
             "$schema": "https://json-schema.org/draft/2020-12/schema",
             "type": "object",
             "required": [
-                "resourceKind"
+                "resourceShellKind"
             ],
             "properties": {
-                "resourceKind": {
-                    "$ref": "#/$defs/ResourceKind"
+                "resourceShellKind": {
+                    "$ref": "#/$defs/ResourceShellKind"
                 }
             }
         },
         "ShellMissing": {
             "$schema": "https://json-schema.org/draft/2020-12/schema",
             "type": "object",
+            "required": [
+                "resourceShellKind"
+            ],
             "properties": {
-                "resourceKind": {
+                "resourceShellKind": {
                     "const": "missing"
                 }
             },
@@ -583,7 +607,7 @@
                     "$ref": "#/$defs/ResourceShellBase"
                 },
                 {
-                    "$ref": "#/$defs/ResourceKindFacet"
+                    "$ref": "#/$defs/ResourceShellKindFacet"
                 }
             ],
             "unevaluatedProperties": false
@@ -591,8 +615,11 @@
         "ShellInputPotential": {
             "$schema": "https://json-schema.org/draft/2020-12/schema",
             "type": "object",
+            "required": [
+                "resourceShellKind"
+            ],
             "properties": {
-                "resourceKind": {
+                "resourceShellKind": {
                     "const": "inputPotential"
                 }
             },
@@ -604,7 +631,7 @@
                     "$ref": "#/$defs/CreationContextFacet"
                 },
                 {
-                    "$ref": "#/$defs/ResourceKindFacet"
+                    "$ref": "#/$defs/ResourceShellKindFacet"
                 }
             ],
             "unevaluatedProperties": false
@@ -612,8 +639,11 @@
         "ShellOutputPotential": {
             "$schema": "https://json-schema.org/draft/2020-12/schema",
             "type": "object",
+            "required": [
+                "resourceShellKind"
+            ],
             "properties": {
-                "resourceKind": {
+                "resourceShellKind": {
                     "const": "outputPotential"
                 }
             },
@@ -625,7 +655,7 @@
                     "$ref": "#/$defs/CreationContextFacet"
                 },
                 {
-                    "$ref": "#/$defs/ResourceKindFacet"
+                    "$ref": "#/$defs/ResourceShellKindFacet"
                 }
             ],
             "unevaluatedProperties": false
@@ -668,13 +698,14 @@
             "$schema": "https://json-schema.org/draft/2020-12/schema",
             "type": "object",
             "required": [
-                "version"
+                "version",
+                "resourceShellKind"
             ],
             "properties": {
                 "version": {
                     "const": 1
                 },
-                "resourceKind": {
+                "resourceShellKind": {
                     "const": "materialized"
                 }
             },
@@ -686,7 +717,7 @@
                     "$ref": "#/$defs/CreationContextFacet"
                 },
                 {
-                    "$ref": "#/$defs/ResourceKindFacet"
+                    "$ref": "#/$defs/ResourceShellKindFacet"
                 },
                 {
                     "$ref": "#/$defs/TimestampFacet"
@@ -720,6 +751,22 @@
             "$ref": "#/$defs/ShellOutputPotential",
             "unevaluatedProperties": false
         },
+        "ResourcePotential": {
+            "$schema": "https://json-schema.org/draft/2020-12/schema",
+            "type": "object",
+            "oneOf": [
+                {
+                    "$ref": "#/$defs/ResourceMissing"
+                },
+                {
+                    "$ref": "#/$defs/ResourceInputPotential"
+                },
+                {
+                    "$ref": "#/$defs/ResourceOutputPotential"
+                }
+            ],
+            "unevaluatedProperties": false
+        },
         "JsonData": {
             "$schema": "https://json-schema.org/draft/2020-12/schema",
             "oneOf": [
@@ -763,12 +810,10 @@
                 "nucleus"
             ],
             "properties": {
-                "nucleus": {
-                    "$ref": "#/$defs/Nucleus"
-                }
+                "nucleus": true
             }
         },
-        "ResourceMaterialized": {
+        "Resource": {
             "$schema": "https://json-schema.org/draft/2020-12/schema",
             "type": "object",
             "allOf": [
@@ -782,25 +827,6 @@
             ],
             "unevaluatedProperties": false
         },
-        "Resource": {
-            "$schema": "https://json-schema.org/draft/2020-12/schema",
-            "type": "object",
-            "oneOf": [
-                {
-                    "$ref": "#/$defs/ResourceMissing"
-                },
-                {
-                    "$ref": "#/$defs/ResourceInputPotential"
-                },
-                {
-                    "$ref": "#/$defs/ResourceOutputPotential"
-                },
-                {
-                    "$ref": "#/$defs/ResourceMaterialized"
-                }
-            ],
-            "unevaluatedProperties": false
-        },
         "JobStepSocket": {
             "$schema": "https://json-schema.org/draft/2020-12/schema",
             "type": "object",
@@ -808,7 +834,14 @@
                 "$ref": "#/$defs/ResourceRoleIdentity"
             },
             "additionalProperties": {
-                "$ref": "#/$defs/Resource"
+                "oneOf": [
+                    {
+                        "$ref": "#/$defs/ResourcePotential"
+                    },
+                    {
+                        "$ref": "#/$defs/Resource"
+                    }
+                ]
             }
         },
         "StrategyState": {
@@ -906,7 +939,7 @@
             "type": "string",
             "pattern": "^STRATEGY_THREAD-.+$"
         },
-        "StrategyThreadMap": {
+        "StrategyThreadDict": {
             "$schema": "https://json-schema.org/draft/2020-12/schema",
             "type": "object",
             "propertyNames": {
@@ -917,15 +950,15 @@
             },
             "$comment": "Each thread contains an array of steps, allowing for sequential execution within a thread while supporting parallel execution across multiple threads."
         },
-        "StrategyThreadMapFacet": {
+        "StrategyThreadDictFacet": {
             "$schema": "https://json-schema.org/draft/2020-12/schema",
             "type": "object",
             "required": [
-                "strategyThreadMap"
+                "strategyThreadDict"
             ],
             "properties": {
-                "strategyThreadMap": {
-                    "$ref": "#/$defs/StrategyThreadMap"
+                "strategyThreadDict": {
+                    "$ref": "#/$defs/StrategyThreadDict"
                 }
             }
         },
@@ -946,8 +979,8 @@
             },
             "allOf": [
                 {
-                    "$comment": "The Engine runs jobs specified by steps in strategyThreadMap. The Engine  also injects repeted steps when encountering loops.",
-                    "$ref": "#/$defs/StrategyThreadMapFacet"
+                    "$comment": "The Engine runs jobs specified by steps in strategyThreadDict. The Engine  also injects repeted steps when encountering loops.",
+                    "$ref": "#/$defs/StrategyThreadDictFacet"
                 },
                 {
                     "$comment": "The Engine updates strategyState with materialized Resources upon job completions and runtime-provided input events. It also inserts inputPotential and outputPotential Resources upon step injections.",

package/dist/generated/schemas/standalone/Job.json

@@ -10,6 +10,7 @@
             "$ref": "#/$defs/JobIdentity"
         },
         "implementationUri": {
+            "$comment": "Instances of a ResourceType that requires implementationUri are 'executable' ResourceTypes. TYPE-Job is the canonical executable ResourceType in the ecosystem.",
             "$ref": "#/$defs/Uri"
         }
     },
@@ -85,19 +86,20 @@
             "$schema": "https://json-schema.org/draft/2020-12/schema",
             "type": "object",
             "required": [
-                "inputMap",
-                "outputMap"
+                "inputDict",
+                "outputDict"
             ],
             "properties": {
-                "inputMap": {
-                    "$ref": "#/$defs/RoleMap"
+                "inputDict": {
+                    "$ref": "#/$defs/RoleDict"
                 },
-                "outputMap": {
+                "outputDict": {
                     "allOf": [
                         {
-                            "$ref": "#/$defs/RoleMap"
+                            "$ref": "#/$defs/RoleDict"
                         },
                         {
+                            "type": "object",
                             "required": [
                                 "ROLE-ErrorOutput"
                             ],
@@ -150,7 +152,7 @@
             "$comment": "Validation is intercepted by an AI Agent that verifies the description against Toolproof's documentation standards.",
             "semanticValidation": "Ajv custom keyword to verify description."
         },
-        "RoleMap": {
+        "RoleDict": {
             "$schema": "https://json-schema.org/draft/2020-12/schema",
             "type": "object",
             "propertyNames": {
@@ -165,7 +167,6 @@
             "type": "object",
             "allOf": [
                 {
-                    "$comment": "A ResourceRole does not have a self-contained identity, as it is always defined in the context of a RoleMap. ResourceRoleValue uses the Value suffix to mean 'the value stored in this map' (RoleMap.additionalProperties).",
                     "required": [
                         "resourceTypeHandle"
                     ],