@toolproof-npm/schema 0.1.79 → 0.1.81

package/dist/genesis/generated/types/types.d.ts

@@ -190,6 +190,105 @@ export type ForStep =
  */
 export type ForStepIdentity =
  `FORSTEP-${string}`;
+/**
+ * This interface was referenced by `GenesisJson`'s JSON-Schema
+ * via the `definition` "GraphEndRunEvent".
+ */
+export type GraphEndRunEvent =
+ RunEventBase & {
+  kind?: "graph_end";
+};
+/**
+ * This interface was referenced by `GenesisJson`'s JSON-Schema
+ * via the `definition` "RunEventKind".
+ */
+export type RunEventKind =
+ "graph_start" | "tick" | "interrupt" | "graph_end";
+/**
+ * This interface was referenced by `GenesisJson`'s JSON-Schema
+ * via the `definition` "RunEventStepKind".
+ */
+export type RunEventStepKind =
+ "work" | "branch" | "while" | "for";
+/**
+ * This interface was referenced by `GenesisJson`'s JSON-Schema
+ * via the `definition` "WhileStepIdentity".
+ */
+export type WhileStepIdentity =
+ `WHILESTEP-${string}`;
+/**
+ * This interface was referenced by `GenesisJson`'s JSON-Schema
+ * via the `definition` "StrategyRunIdentity".
+ */
+export type StrategyRunIdentity =
+ `STRATEGY_RUN-${string}`;
+/**
+ * This interface was referenced by `GenesisJson`'s JSON-Schema
+ * via the `definition` "StrategyThreadIdentity".
+ */
+export type StrategyThreadIdentity =
+ `STRATEGY_THREAD-${string}`;
+/**
+ * This interface was referenced by `GenesisJson`'s JSON-Schema
+ * via the `definition` "RunEventUpdates".
+ */
+export type RunEventUpdates =
+ {
+  interruptData?: {
+} | null;
+  stepsMutation?: {
+    insertAt: number;
+    inserted: Step[];
+};
+} & StrategyStateDelta;
+/**
+ * This interface was referenced by `GenesisJson`'s JSON-Schema
+ * via the `definition` "Step".
+ */
+export type Step =
+ WorkStep | BranchStep | WhileStep | ForStep;
+/**
+ * This interface was referenced by `GenesisJson`'s JSON-Schema
+ * via the `definition` "WhileStep".
+ */
+export type WhileStep =
+ {
+  case: Conditional;
+  identity: WhileStepIdentity;
+  kind: "while";
+} & StepKind;
+/**
+ * This interface was referenced by `GenesisJson`'s JSON-Schema
+ * via the `definition` "GraphStartRunEvent".
+ */
+export type GraphStartRunEvent =
+ RunEventBase & {
+  kind?: "graph_start";
+  strategyRunSeed: StrategyRun;
+};
+/**
+ * This interface was referenced by `GenesisJson`'s JSON-Schema
+ * via the `definition` "StrategyRun".
+ */
+export type StrategyRun =
+ {
+  identity: StrategyRunIdentity;
+  statefulStrategyRef: StatefulStrategyIdentity;
+  strategyRunContext: StrategyRunContext;
+} & StrategyThreadMapWrapper &
+  StrategyStateWrapper;
+/**
+ * This interface was referenced by `GenesisJson`'s JSON-Schema
+ * via the `definition` "StatefulStrategyIdentity".
+ */
+export type StatefulStrategyIdentity =
+ `STATEFUL_STRATEGY-${string}`;
+/**
+ * This interface was referenced by `GenesisJson`'s JSON-Schema
+ * via the `definition` "StrategyRunStatus".
+ */
+export type StrategyRunStatus =
+ "pending" | "running" | "completed" | "failed" | "cancelled";
 /**
  * This interface was referenced by `undefined`'s JSON-Schema definition
  * via the `patternProperty` "^[A-Za-z][A-Za-z0-9._-]*Identity$".
@@ -213,6 +312,14 @@ export type IdentitySchema =
   pattern?: string;
 } & {
 };
+/**
+ * This interface was referenced by `GenesisJson`'s JSON-Schema
+ * via the `definition` "InterruptRunEvent".
+ */
+export type InterruptRunEvent =
+ RunEventBase & {
+  kind?: "interrupt";
+};
 /**
  * This interface was referenced by `GenesisJson`'s JSON-Schema
  * via the `definition` "Job".
@@ -302,6 +409,20 @@ export type ResourceType =
 } & Documented &
   ExtractionSchemaWrapper & {
 };
+/**
+ * This interface was referenced by `GenesisJson`'s JSON-Schema
+ * via the `definition` "RunEvent".
+ */
+export type RunEvent =
+ GraphStartRunEvent | TickRunEvent | InterruptRunEvent | GraphEndRunEvent;
+/**
+ * This interface was referenced by `GenesisJson`'s JSON-Schema
+ * via the `definition` "TickRunEvent".
+ */
+export type TickRunEvent =
+ RunEventBase & {
+  kind?: "tick";
+};
 /**
  * This interface was referenced by `GenesisJson`'s JSON-Schema
  * via the `definition` "StatefulStrategy".
@@ -310,13 +431,7 @@ export type StatefulStrategy =
  {
   identity: StatefulStrategyIdentity;
 } & StatelessStrategyWrapper &
-  StrategyStateWrapper;
-/**
- * This interface was referenced by `GenesisJson`'s JSON-Schema
- * via the `definition` "StatefulStrategyIdentity".
- */
-export type StatefulStrategyIdentity =
- `STATEFUL_STRATEGY-${string}`;
+  StrategyStateWrapper1;
 /**
  * This interface was referenced by `GenesisJson`'s JSON-Schema
  * via the `definition` "StatelessStrategyIdentity".
@@ -325,62 +440,20 @@ export type StatelessStrategyIdentity =
  `STATELESS_STRATEGY-${string}`;
 /**
  * This interface was referenced by `GenesisJson`'s JSON-Schema
- * via the `definition` "Step".
- */
-export type Step =
- WorkStep | BranchStep | WhileStep | ForStep;
-/**
- * This interface was referenced by `GenesisJson`'s JSON-Schema
- * via the `definition` "WhileStep".
- */
-export type WhileStep =
- {
-  case: Conditional;
-  identity: WhileStepIdentity;
-  kind: "while";
-} & StepKind;
-/**
- * This interface was referenced by `GenesisJson`'s JSON-Schema
- * via the `definition` "WhileStepIdentity".
- */
-export type WhileStepIdentity =
- `WHILESTEP-${string}`;
-/**
- * This interface was referenced by `GenesisJson`'s JSON-Schema
- * via the `definition` "StrategyRun".
+ * via the `definition` "StrategyRunUpdate".
  */
-export type StrategyRun =
+export type StrategyRunUpdate =
  {
-  identity: StrategyRunIdentity;
-  statefulStrategyRef: StatefulStrategyIdentity;
-  strategyRunContext: StrategyRunContext;
-} & StrategyThreadMapWrapper &
-  StrategyStateWrapper1;
-/**
- * This interface was referenced by `GenesisJson`'s JSON-Schema
- * via the `definition` "StrategyRunIdentity".
- */
-export type StrategyRunIdentity =
- `STRATEGY_RUN-${string}`;
-/**
- * This interface was referenced by `GenesisJson`'s JSON-Schema
- * via the `definition` "StrategyRunStatus".
- */
-export type StrategyRunStatus =
- "pending" | "running" | "completed" | "failed" | "cancelled";
+  strategyRun?: StrategyRun1;
+  strategyRunRef: StrategyRunIdentity;
+} & StrategyStateDelta;
 export type StrategyRun1 =
  {
   identity: StrategyRunIdentity;
   statefulStrategyRef: StatefulStrategyIdentity;
   strategyRunContext: StrategyRunContext;
 } & StrategyThreadMapWrapper &
-  StrategyStateWrapper1;
-/**
- * This interface was referenced by `GenesisJson`'s JSON-Schema
- * via the `definition` "StrategyThreadIdentity".
- */
-export type StrategyThreadIdentity =
- `STRATEGY_THREAD-${string}`;
+  StrategyStateWrapper;
 
 export interface GenesisJson {
 }
@@ -490,6 +563,75 @@ export type ExecutionSocketMaterialized = Record<ResourceRoleIdentity, Resource>
 export interface ExtractionSchemaWrapper {
   extractionSchema: ExtractionSchema;
 }
+/**
+ * This interface was referenced by `GenesisJson`'s JSON-Schema
+ * via the `definition` "RunEventBase".
+ */
+export interface RunEventBase {
+  counters?: RunEventCounters;
+  createdAt: Timestamp;
+  eventSeq: number;
+  kind: RunEventKind;
+  nodeName: string;
+  stepMetaData?: RunEventStepMetaData;
+  strategyRunRef: StrategyRunIdentity;
+  strategyThreadRef: StrategyThreadIdentity;
+  updates?: RunEventUpdates;
+}
+/**
+ * This interface was referenced by `GenesisJson`'s JSON-Schema
+ * via the `definition` "RunEventCounters".
+ */
+export interface RunEventCounters {
+  iterationCounterAfter?: number;
+  stepCounterAfter?: number;
+}
+/**
+ * This interface was referenced by `GenesisJson`'s JSON-Schema
+ * via the `definition` "RunEventStepMetaData".
+ */
+export interface RunEventStepMetaData {
+  executionRef?: ExecutionIdentity;
+  jobRef?: JobIdentity;
+  stepKind: RunEventStepKind;
+  stepRef: WorkStepIdentity | BranchStepIdentity | WhileStepIdentity | ForStepIdentity;
+  threadStepIndex: number;
+}
+/**
+ * This interface was referenced by `GenesisJson`'s JSON-Schema
+ * via the `definition` "StrategyStateDelta".
+ */
+export interface StrategyStateDelta {
+  strategyStateUpdate?: {
+    [k: string]: ExecutionSocketMaterialized;
+  };
+  strategyStateUpdateWide?: Record<ExecutionIdentity, ExecutionSocket>;
+}
+/**
+ * This interface was referenced by `GenesisJson`'s JSON-Schema
+ * via the `definition` "StrategyRunContext".
+ */
+export interface StrategyRunContext {
+  completedAt?: Timestamp;
+  startedAt?: Timestamp;
+  status: StrategyRunStatus;
+}
+export interface StrategyThreadMapWrapper {
+  strategyThreadMap: StrategyThreadMap;
+}
+/**
+ * This interface was referenced by `GenesisJson`'s JSON-Schema
+ * via the `definition` "StrategyThreadMap".
+ */
+export type StrategyThreadMap = Record<StrategyThreadIdentity, Step[]>;
+export interface StrategyStateWrapper {
+  strategyState: StrategyState;
+}
+/**
+ * This interface was referenced by `GenesisJson`'s JSON-Schema
+ * via the `definition` "StrategyState".
+ */
+export type StrategyState = Record<ExecutionIdentity, ExecutionSocket>;
 /**
  * This interface was referenced by `GenesisJson`'s JSON-Schema
  * via the `definition` "IdentityProp".
@@ -561,6 +703,19 @@ export interface MeritSchemaRef {
 export interface RoleBindingsWrapper1 {
   roleBindings: RoleBindings;
 }
+/**
+ * This interface was referenced by `GenesisJson`'s JSON-Schema
+ * via the `definition` "RunRecording".
+ */
+export interface RunRecording {
+  recordedAt?: Timestamp1;
+  runEvents: RunEvent[];
+  strategyRunRef?: string;
+  strategyThreadRef?: string;
+}
+export interface Timestamp1 {
+  timestamp: string;
+}
 /**
  * This interface was referenced by `GenesisJson`'s JSON-Schema
  * via the `definition` "StatelessStrategyWrapper".
@@ -580,44 +735,9 @@ export interface StatelessStrategy {
  * This interface was referenced by `GenesisJson`'s JSON-Schema
  * via the `definition` "StrategyStateWrapper".
  */
-export interface StrategyStateWrapper {
-  strategyState: StrategyState;
-}
-/**
- * This interface was referenced by `GenesisJson`'s JSON-Schema
- * via the `definition` "StrategyState".
- */
-export type StrategyState = Record<ExecutionIdentity, ExecutionSocket>;
-/**
- * This interface was referenced by `GenesisJson`'s JSON-Schema
- * via the `definition` "StrategyRunContext".
- */
-export interface StrategyRunContext {
-  completedAt?: Timestamp;
-  startedAt?: Timestamp;
-  status: StrategyRunStatus;
-}
-export interface StrategyThreadMapWrapper {
-  strategyThreadMap: StrategyThreadMap;
-}
-/**
- * This interface was referenced by `GenesisJson`'s JSON-Schema
- * via the `definition` "StrategyThreadMap".
- */
-export type StrategyThreadMap = Record<StrategyThreadIdentity, Step[]>;
 export interface StrategyStateWrapper1 {
   strategyState: StrategyState;
 }
-/**
- * This interface was referenced by `GenesisJson`'s JSON-Schema
- * via the `definition` "StrategyRunUpdate".
- */
-export interface StrategyRunUpdate {
-  strategyRun?: StrategyRun1;
-  strategyRunRef: StrategyRunIdentity;
-  strategyStateUpdate: Record<ExecutionIdentity, ExecutionSocketMaterialized>;
-  strategyStateUpdateWide?: Record<ExecutionIdentity, ExecutionSocket>;
-}
 /**
  * This interface was referenced by `GenesisJson`'s JSON-Schema
  * via the `definition` "StrategyThreadMapWrapper".

package/dist/identityGuards.d.ts

@@ -0,0 +1,3 @@
+import type { ResourceRoleIdentity, StrategyThreadIdentity } from './genesis/generated/types/types.js';
+export declare function isResourceRoleIdentityJson(value: string): value is ResourceRoleIdentity;
+export declare function isStrategyThreadIdentityJson(value: string): value is StrategyThreadIdentity;

package/dist/identityGuards.js

@@ -0,0 +1,6 @@
+export function isResourceRoleIdentityJson(value) {
+    return value.startsWith('ROLE-');
+}
+export function isStrategyThreadIdentityJson(value) {
+    return value.startsWith('STRATEGY_THREAD-');
+}

package/dist/index.d.ts

@@ -14,3 +14,4 @@ export type { Resource_StrategyRun as Resource_StrategyRunJson } from './genesis
 export type StepIdentityJson = WorkStepIdentity | BranchStepIdentity | WhileStepIdentity | ForStepIdentity;
 export type { Documented as DocumentedJson, ResourceFormatIdentity as ResourceFormatIdentityJson, ResourceFormat as ResourceFormatJson, ExtractionSchema as ExtractionSchemaJson, IdentityProp as IdentityPropJson, MeritProp as MeritPropJson, ResourceTypeIdentity as ResourceTypeIdentityJson, ResourceType as ResourceTypeJson, ResourceRoleIdentity as ResourceRoleIdentityJson, ResourceRoleValue as ResourceRoleValueJson, ExecutionIdentity as ExecutionIdentityJson, Execution as ExecutionJson, Conditional as ConditionalJson, RoleMap as RoleMapJson, Roles as RolesJson, RoleBindingMap as RoleBindingMapJson, RoleBindings as RoleBindingsJson, ResourceIdentity as ResourceIdentityJson, WorkStepIdentity as WorkStepIdentityJson, BranchStepIdentity as BranchStepIdentityJson, WhileStepIdentity as WhileStepIdentityJson, ForStepIdentity as ForStepIdentityJson, WorkStep as WorkStepJson, BranchStep as BranchStepJson, WhileStep as WhileStepJson, ForStep as ForStepJson, StepKind as StepKindJson, Step as StepJson, CreationContext as CreationContextJson, ResourceMissing as ResourceMissingJson, ResourcePotentialInput as ResourcePotentialInputJson, ResourcePotentialOutput as ResourcePotentialOutputJson, ResourceMetaBase as ResourceMetaJson, // ATTENTION: type not generated for ResourceMeta
 Resource as ResourceJson, StrategyState as StrategyStateJson, StatelessStrategyIdentity as StatelessStrategyIdentityJson, StatelessStrategy as StatelessStrategyJson, StatefulStrategyIdentity as StatefulStrategyIdentityJson, StatefulStrategy as StatefulStrategyJson, StrategyRunIdentity as StrategyRunIdentityJson, StrategyRunStatus as StrategyRunStatusJson, StrategyRun as StrategyRunJson, StrategyRunUpdate as StrategyRunUpdateJson, JobIdentity as JobIdentityJson, Job as JobJson, JsonData as JsonDataJson, StrategyThreadIdentity as StrategyThreadIdentityJson, StrategyThreadMap as StrategyThreadMapJson, ExecutionSocket as ExecutionSocketJson, ExecutionSocketMaterialized as ExecutionSocketMaterializedJson, Timestamp as TimestampJson, } from './genesis/generated/types/types.js';
+export { isResourceRoleIdentityJson, isStrategyThreadIdentityJson } from './identityGuards.js';

package/dist/index.js

@@ -4,3 +4,4 @@ export { default as SchemaJob } from './genesis/generated/schemas/Job.js';
 export { default as ResourceTypeGenesis } from './genesis/generated/resource-type-envelopes/Genesis.js';
 export { default as dependencies } from './genesis/generated/dependencies_ordered.json';
 export { default as terminals } from './genesis/generated/terminals.json';
+export { isResourceRoleIdentityJson, isStrategyThreadIdentityJson } from './identityGuards.js';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@toolproof-npm/schema",
-  "version": "0.1.79",
+  "version": "0.1.81",
   "description": "JSON schemas and TypeScript types for ToolProof",
   "keywords": [
     "toolproof",
@@ -26,6 +26,10 @@
     ".": {
       "import": "./dist/index.js",
       "types": "./dist/index.d.ts"
+    },
+    "./identityGuards": {
+      "import": "./dist/identityGuards.js",
+      "types": "./dist/identityGuards.d.ts"
     }
   },
   "files": [