@toolproof-npm/schema 0.1.39 → 0.1.41

package/dist/_lib/types/Resource_Job.d.ts

@@ -29,7 +29,7 @@ export interface ResourceSocket {
   resourceRoleId: string;
 }
 export interface ResourceKind {
-  kind: "potential-input" | "potential-output" | "materialized";
+  kind: "missing" | "potential-input" | "potential-output" | "materialized";
 }
 export interface Timestamp {
   timestamp: string;

package/dist/_lib/types/Resource_ResourceFormat.d.ts

@@ -24,7 +24,7 @@ export interface ResourceSocket {
   resourceRoleId: string;
 }
 export interface ResourceKind {
-  kind: "potential-input" | "potential-output" | "materialized";
+  kind: "missing" | "potential-input" | "potential-output" | "materialized";
 }
 export interface Timestamp {
   timestamp: string;

package/dist/_lib/types/Resource_ResourceType.d.ts

@@ -42,7 +42,7 @@ export interface ResourceSocket {
   resourceRoleId: string;
 }
 export interface ResourceKind {
-  kind: "potential-input" | "potential-output" | "materialized";
+  kind: "missing" | "potential-input" | "potential-output" | "materialized";
 }
 export interface Timestamp {
   timestamp: string;

package/dist/_lib/types/Resource_StatelessStrategy.d.ts

@@ -52,7 +52,7 @@ export interface ResourceSocket {
   resourceRoleId: string;
 }
 export interface ResourceKind {
-  kind: "potential-input" | "potential-output" | "materialized";
+  kind: "missing" | "potential-input" | "potential-output" | "materialized";
 }
 export interface Timestamp {
   timestamp: string;

package/dist/_lib/types/types.d.ts

@@ -210,6 +210,15 @@ export type ResourceMetaBase1 =
     kind: "materialized";
 } & Timestamp &
   Path;
+/**
+ * This interface was referenced by `GenesisJson`'s JSON-Schema
+ * via the `definition` "ResourceMissing".
+ */
+export type ResourceMissing =
+ ResourceBase &
+  ResourceKind & {
+    kind: "missing";
+};
 /**
  * This interface was referenced by `GenesisJson`'s JSON-Schema
  * via the `definition` "ResourcePotentialInput".
@@ -445,7 +454,7 @@ export interface ResourceSocket1 {
  * via the `definition` "ResourceKind".
  */
 export interface ResourceKind {
-  kind: "potential-input" | "potential-output" | "materialized";
+  kind: "missing" | "potential-input" | "potential-output" | "materialized";
 }
 /**
  * This interface was referenced by `GenesisJson`'s JSON-Schema
@@ -474,7 +483,7 @@ export interface StrategyState {
  */
 export interface StrategyStateValue {
   [k: string]: {
-    [k: string]: ResourcePotentialInput | ResourcePotentialOutput | Resource;
+    [k: string]: ResourceMissing | ResourcePotentialInput | ResourcePotentialOutput | Resource;
   };
 }
 
@@ -627,11 +636,11 @@ export type ForStep =
 };
 export type ForStepId =
  string;
-export type ResourcePotentialInput =
+export type ResourceMissing =
  ResourceBase &
   ResourceKind & {
-    kind: "potential-input";
-} & PendingRef;
+    kind: "missing";
+};
 export type ResourceBase =
  {
   identity: ResourceId;
@@ -641,6 +650,11 @@ export type ResourceTypeId =
  string;
 export type ResourceRoleId =
  string;
+export type ResourcePotentialInput =
+ ResourceBase &
+  ResourceKind & {
+    kind: "potential-input";
+} & PendingRef;
 export type ResourcePotentialOutput =
  ResourceBase &
   ResourceKind & {
@@ -688,7 +702,7 @@ export interface StrategyState {
 }
 export interface StrategyStateValue {
   [k: string]: {
-    [k: string]: ResourcePotentialInput | ResourcePotentialOutput | Resource;
+    [k: string]: ResourceMissing | ResourcePotentialInput | ResourcePotentialOutput | Resource;
   };
 }
 export interface CreationContext {
@@ -699,7 +713,7 @@ export interface ResourceSocket {
   resourceRoleId: ResourceRoleId;
 }
 export interface ResourceKind {
-  kind: "potential-input" | "potential-output" | "materialized";
+  kind: "missing" | "potential-input" | "potential-output" | "materialized";
 }
 export interface PendingRef {
   pendingRef: ResourceSocket1;

package/dist/genesis/generated/resources/Genesis.json

@@ -1077,6 +1077,7 @@
                 "properties": {
                     "kind": {
                         "enum": [
+                            "missing",
                             "potential-input",
                             "potential-output",
                             "materialized"
@@ -1086,6 +1087,46 @@
             }
         }
     },
+    "ResourceMissing": {
+        "identity": "RESOURCE-ResourceMissing",
+        "resourceTypeId": "TYPE-ResourceType",
+        "creationContext": {
+            "resourceRoleId": "ROLE-Genesis",
+            "executionId": "EXECUTION-ResourceMissing"
+        },
+        "kind": "materialized",
+        "timestamp": "2025-11-30T00:00:00.000Z",
+        "extractedData": {
+            "identity": "TYPE-ResourceMissing",
+            "name": "ResourceMissing",
+            "description": "dummy-description",
+            "resourceFormatId": "FORMAT-ApplicationJson",
+            "extractionSchema": {
+                "$anchor": "ResourceMissing",
+                "$schema": "https://json-schema.org/draft/2020-12/schema",
+                "type": "object",
+                "allOf": [
+                    {
+                        "$ref": "#/$defs/ResourceBase"
+                    },
+                    {
+                        "$ref": "#/$defs/ResourceKind"
+                    },
+                    {
+                        "required": [
+                            "kind"
+                        ],
+                        "properties": {
+                            "kind": {
+                                "const": "missing"
+                            }
+                        }
+                    }
+                ],
+                "unevaluatedProperties": false
+            }
+        }
+    },
     "PendingRef": {
         "identity": "RESOURCE-PendingRef",
         "resourceTypeId": "TYPE-ResourceType",
@@ -1109,7 +1150,7 @@
                 ],
                 "properties": {
                     "pendingRef": {
-                        "$comment": "This points to a resource created at a previous step in the same workflow. This resource is not yet materialized at the time of defining the workflow, but will be materialized when the step using this resource is executed.The Engine resolves this ref at runtime.",
+                        "$comment": "This points to a resource created at a previous step in the same execution. This resource is not yet materialized at the time of defining the execution, but will be materialized when the step using this resource is executed.The Engine resolves this ref at runtime.",
                         "$ref": "#/$defs/ResourceSocket"
                     }
                 }
@@ -1948,6 +1989,9 @@
                     },
                     "additionalProperties": {
                         "oneOf": [
+                            {
+                                "$ref": "#/$defs/ResourceMissing"
+                            },
                             {
                                 "$ref": "#/$defs/ResourcePotentialInput"
                             },

package/dist/genesis/generated/schemas/Genesis.json

@@ -522,7 +522,7 @@
             "type": "object",
             "properties": {
                 "pendingRef": {
-                    "$comment": "This points to a resource created at a previous step in the same workflow. This resource is not yet materialized at the time of defining the workflow, but will be materialized when the step using this resource is executed.The Engine resolves this ref at runtime.",
+                    "$comment": "This points to a resource created at a previous step in the same execution. This resource is not yet materialized at the time of defining the execution, but will be materialized when the step using this resource is executed.The Engine resolves this ref at runtime.",
                     "$ref": "#/$defs/ResourceSocket"
                 }
             },
@@ -619,6 +619,7 @@
             "properties": {
                 "kind": {
                     "enum": [
+                        "missing",
                         "potential-input",
                         "potential-output",
                         "materialized"
@@ -666,6 +667,30 @@
             ],
             "$anchor": "ResourceMetaBase"
         },
+        "ResourceMissing": {
+            "$schema": "https://json-schema.org/draft/2020-12/schema",
+            "type": "object",
+            "allOf": [
+                {
+                    "$ref": "#/$defs/ResourceBase"
+                },
+                {
+                    "$ref": "#/$defs/ResourceKind"
+                },
+                {
+                    "properties": {
+                        "kind": {
+                            "const": "missing"
+                        }
+                    },
+                    "required": [
+                        "kind"
+                    ]
+                }
+            ],
+            "unevaluatedProperties": false,
+            "$anchor": "ResourceMissing"
+        },
         "ResourcePotentialInput": {
             "$schema": "https://json-schema.org/draft/2020-12/schema",
             "type": "object",
@@ -1029,6 +1054,9 @@
                 "type": "object",
                 "additionalProperties": {
                     "oneOf": [
+                        {
+                            "$ref": "#/$defs/ResourceMissing"
+                        },
                         {
                             "$ref": "#/$defs/ResourcePotentialInput"
                         },

package/dist/genesis/generated/schemas/StatefulStrategy.json

@@ -101,6 +101,9 @@
                 "type": "object",
                 "additionalProperties": {
                     "oneOf": [
+                        {
+                            "$ref": "#/$defs/ResourceMissing"
+                        },
                         {
                             "$ref": "#/$defs/ResourcePotentialInput"
                         },
@@ -242,6 +245,30 @@
             ],
             "$anchor": "ForStep"
         },
+        "ResourceMissing": {
+            "$schema": "https://json-schema.org/draft/2020-12/schema",
+            "type": "object",
+            "allOf": [
+                {
+                    "$ref": "#/$defs/ResourceBase"
+                },
+                {
+                    "$ref": "#/$defs/ResourceKind"
+                },
+                {
+                    "properties": {
+                        "kind": {
+                            "const": "missing"
+                        }
+                    },
+                    "required": [
+                        "kind"
+                    ]
+                }
+            ],
+            "unevaluatedProperties": false,
+            "$anchor": "ResourceMissing"
+        },
         "ResourcePotentialInput": {
             "$schema": "https://json-schema.org/draft/2020-12/schema",
             "type": "object",
@@ -447,6 +474,7 @@
             "properties": {
                 "kind": {
                     "enum": [
+                        "missing",
                         "potential-input",
                         "potential-output",
                         "materialized"
@@ -463,7 +491,7 @@
             "type": "object",
             "properties": {
                 "pendingRef": {
-                    "$comment": "This points to a resource created at a previous step in the same workflow. This resource is not yet materialized at the time of defining the workflow, but will be materialized when the step using this resource is executed.The Engine resolves this ref at runtime.",
+                    "$comment": "This points to a resource created at a previous step in the same execution. This resource is not yet materialized at the time of defining the execution, but will be materialized when the step using this resource is executed.The Engine resolves this ref at runtime.",
                     "$ref": "#/$defs/ResourceSocket"
                 }
             },

package/dist/genesis/resourceTypes/Genesis.json

@@ -786,6 +786,7 @@
                     "properties": {
                         "kind": {
                             "enum": [
+                                "missing",
                                 "potential-input",
                                 "potential-output",
                                 "materialized"
@@ -794,6 +795,36 @@
                     }
                 }
             },
+            "ResourceMissing": {
+                "identity": "TYPE-ResourceMissing",
+                "name": "ResourceMissing",
+                "description": "dummy-description",
+                "resourceFormatId": "FORMAT-ApplicationJson",
+                "extractionSchema": {
+                    "$anchor": "ResourceMissing",
+                    "$schema": "https://json-schema.org/draft/2020-12/schema",
+                    "type": "object",
+                    "allOf": [
+                        {
+                            "$ref": "#ResourceBase"
+                        },
+                        {
+                            "$ref": "#ResourceKind"
+                        },
+                        {
+                            "required": [
+                                "kind"
+                            ],
+                            "properties": {
+                                "kind": {
+                                    "const": "missing"
+                                }
+                            }
+                        }
+                    ],
+                    "unevaluatedProperties": false
+                }
+            },
             "PendingRef": {
                 "identity": "TYPE-PendingRef",
                 "name": "PendingRef",
@@ -808,7 +839,7 @@
                     ],
                     "properties": {
                         "pendingRef": {
-                            "$comment": "This points to a resource created at a previous step in the same workflow. This resource is not yet materialized at the time of defining the workflow, but will be materialized when the step using this resource is executed.The Engine resolves this ref at runtime.",
+                            "$comment": "This points to a resource created at a previous step in the same execution. This resource is not yet materialized at the time of defining the execution, but will be materialized when the step using this resource is executed.The Engine resolves this ref at runtime.",
                             "$ref": "#ResourceSocket"
                         }
                     }
@@ -1407,6 +1438,9 @@
                         },
                         "additionalProperties": {
                             "oneOf": [
+                                {
+                                    "$ref": "#ResourceMissing"
+                                },
                                 {
                                     "$ref": "#ResourcePotentialInput"
                                 },

package/dist/index.d.ts

@@ -5,5 +5,5 @@ export type { Resource_ResourceFormat as Resource_ResourceFormatJson } from './_
 export type { Resource_ResourceType as Resource_ResourceTypeJson } from './_lib/types/Resource_ResourceType.js';
 export type { Resource_Job as Resource_JobJson } from './_lib/types/Resource_Job.js';
 export type { Documented as DocumentedJson, ResourceFormatId as ResourceFormatIdJson, ResourceFormat as ResourceFormatJson, ExtractionSchema as ExtractionSchemaJson, ExtractionSchemaValue as ExtractionSchemaValueJson, IdentityProp as IdentityPropJson, MeritProp as MeritPropJson, ResourceTypeId as ResourceTypeIdJson, ResourceType as ResourceTypeJson, ResourceRoleId as ResourceRoleIdJson, ResourceRoleValue as ResourceRoleValueJson, ExecutionId as ExecutionIdJson, Execution as ExecutionJson, ConditionalWrapper as ConditionalWrapperJson, RoleMap as RoleMapJson, RolesOuter as RolesOuterJson, RoleBindingMap as RoleBindingMapJson, RoleBindingsOuter as RoleBindingsOuterJson, ResourceId as ResourceIdJson, WorkStepId as WorkStepIdJson, BranchStepId as BranchStepIdJson, WhileStepId as WhileStepIdJson, ForStepId as ForStepIdJson, WorkStep as WorkStepJson, BranchStep as BranchStepJson, WhileStep as WhileStepJson, ForStep as ForStepJson, Step as StepJson, ResourceSocket as ResourceSocketJson, ResourcePotentialInput as ResourcePotentialInputJson, ResourcePotentialOutput as ResourcePotentialOutputJson, ResourceMetaBase as ResourceMetaJson, // ATTENTION: type not generated for ResourceMeta
-Resource as ResourceJson, StrategyState as StrategyStateJson, StrategyStateValue as StrategyStateValueJson, StatelessStrategyId as StatelessStrategyIdJson, StatelessStrategy as StatelessStrategyJson, StatefulStrategyId as StatefulStrategyIdJson, StatefulStrategy as StatefulStrategyJson, Job as JobJson, JsonValue as JsonValueJson, } from './_lib/types/types.js';
+Resource as ResourceJson, StrategyState as StrategyStateJson, StrategyStateValue as StrategyStateValueJson, StatelessStrategyId as StatelessStrategyIdJson, StatelessStrategy as StatelessStrategyJson, StatefulStrategyId as StatefulStrategyIdJson, StatefulStrategy as StatefulStrategyJson, JobId as JobIdJson, Job as JobJson, JsonValue as JsonValueJson, } from './_lib/types/types.js';
 export { unsafeBrand, asResourceTypeId, asResourceRoleId, asExecutionId, asResourceId, asWorkStepId, asBranchStepId, asForStepId, asResourceFormatId, asWhileStepId, asStatelessStrategyId, asStatefulStrategyId, asResourceTypeIds, asResourceRoleIds, asExecutionIds, asResourceIds, asWorkStepIds, asBranchStepIds, asForStepIds, asResourceFormatIds, asWhileStepIds, asStatelessStrategyIds, asStatefulStrategyIds, } from './scripts/brandFactories.js';

package/dist/scripts/generateTypes.js

@@ -246,7 +246,7 @@ async function main() {
         ts = ts.replace(/^(export interface IdentityProp[\s\S]*?)(required:\s*\[\{type:\s*"array";\s*contains:\s*\{const:\s*"identity"\};\s*items:\s*\{type:\s*"string"\};\s*uniqueItems:\s*true\}\];)/gm, '$1required?: string[];');
         // Prune verbose type/interface names produced from absolute $id URLs.
         // Deterministic pruning based on original $id -> baseName map
-        // This avoids heuristic truncation that dropped prefixes like Resource / Workflow.
+        // This avoids heuristic truncation that dropped prefixes.
         function idToGeneratedIdentifier(id) {
             // json-schema-to-typescript seems to create a PascalCase of the URL with protocol prefix
             // Simplified reconstruction: 'https://' => 'Https', then capitalize path & host segments
@@ -324,8 +324,7 @@ async function main() {
             // Common form: ^PREFIX-.+$ => PREFIX-${string}
             const m1 = /^\^([^$]+)\.\+\$/.exec(pattern);
             if (m1) {
-                const prefix = m1[1]; // e.g., 'WORKFLOW-'
-                // Basic safety: ensure backticks/interpolations aren't present
+                const prefix = m1[1];
                 if (!/[`]/.test(prefix)) {
                     return '`' + prefix + '${string}`';
                 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@toolproof-npm/schema",
-  "version": "0.1.39",
+  "version": "0.1.41",
   "description": "JSON schemas and TypeScript types for ToolProof",
   "keywords": [
     "toolproof",