@objectstack/spec 1.0.11 → 1.1.0

package/dist/automation/index.mjs

@@ -155,6 +155,8 @@ var FlowNodeAction = z3.enum([
   // Webhook/API Call
   "script",
   // Custom Script (JS/TS)
+  "screen",
+  // Screen / User-Input Element
   "wait",
   // Delay/Sleep
   "subflow",
@@ -1453,7 +1455,77 @@ var Sync = {
     enabled: true
   })
 };
+
+// src/automation/state-machine.zod.ts
+import { z as z10 } from "zod";
+var ActionRefSchema = z10.union([
+  z10.string().describe("Action Name"),
+  z10.object({
+    type: z10.string(),
+    // e.g., 'xstate.assign', 'log', 'email'
+    params: z10.record(z10.string(), z10.any()).optional()
+  })
+]);
+var GuardRefSchema = z10.union([
+  z10.string().describe('Guard Name (e.g., "isManager", "amountGT1000")'),
+  z10.object({
+    type: z10.string(),
+    params: z10.record(z10.string(), z10.any()).optional()
+  })
+]);
+var TransitionSchema = z10.object({
+  target: z10.string().optional().describe("Target State ID"),
+  cond: GuardRefSchema.optional().describe("Condition (Guard) required to take this path"),
+  actions: z10.array(ActionRefSchema).optional().describe("Actions to execute during transition"),
+  description: z10.string().optional().describe("Human readable description of this rule")
+});
+var EventSchema = z10.object({
+  type: z10.string().describe('Event Type (e.g. "APPROVE", "REJECT", "Submit")'),
+  // Payload validation schema could go here if we want deep validation
+  schema: z10.record(z10.string(), z10.any()).optional().describe("Expected event payload structure")
+});
+var StateNodeSchema = z10.lazy(() => z10.object({
+  /** Type of state */
+  type: z10.enum(["atomic", "compound", "parallel", "final", "history"]).default("atomic"),
+  /** Entry/Exit Actions */
+  entry: z10.array(ActionRefSchema).optional().describe("Actions to run when entering this state"),
+  exit: z10.array(ActionRefSchema).optional().describe("Actions to run when leaving this state"),
+  /** Transitions (Events) */
+  on: z10.record(z10.string(), z10.union([
+    z10.string(),
+    // Shorthand target
+    TransitionSchema,
+    z10.array(TransitionSchema)
+  ])).optional().describe("Map of Event Type -> Transition Definition"),
+  /** Always Transitions (Eventless) */
+  always: z10.array(TransitionSchema).optional(),
+  /** Nesting (Hierarchical States) */
+  initial: z10.string().optional().describe("Initial child state (if compound)"),
+  states: z10.record(z10.string(), StateNodeSchema).optional(),
+  /** Metadata for UI/AI */
+  meta: z10.object({
+    label: z10.string().optional(),
+    description: z10.string().optional(),
+    color: z10.string().optional(),
+    // For UI diagrams
+    // Instructions for AI Agent when in this state
+    aiInstructions: z10.string().optional().describe("Specific instructions for AI when in this state")
+  }).optional()
+}));
+var StateMachineSchema = z10.object({
+  id: SnakeCaseIdentifierSchema.describe("Unique Machine ID"),
+  description: z10.string().optional(),
+  /** Context (Memory) Schema */
+  contextSchema: z10.record(z10.string(), z10.any()).optional().describe("Zod Schema for the machine context/memory"),
+  /** Initial State */
+  initial: z10.string().describe("Initial State ID"),
+  /** State Definitions */
+  states: z10.record(z10.string(), StateNodeSchema).describe("State Nodes"),
+  /** Global Listeners */
+  on: z10.record(z10.string(), z10.union([z10.string(), TransitionSchema, z10.array(TransitionSchema)])).optional()
+});
 export {
+  ActionRefSchema,
   ApprovalActionSchema,
   ApprovalActionType,
   ApprovalProcess,
@@ -1486,17 +1558,21 @@ export {
   ETLTransformationSchema,
   ETLTransformationTypeSchema,
   EmailAlertActionSchema,
+  EventSchema,
   FieldUpdateActionSchema,
   FlowEdgeSchema,
   FlowNodeAction,
   FlowNodeSchema,
   FlowSchema,
   FlowVariableSchema,
+  GuardRefSchema,
   HttpCallActionSchema,
   OAuth2ConfigSchema,
   OperationParameterSchema,
   OperationTypeSchema,
   PushNotificationActionSchema,
+  StateMachineSchema,
+  StateNodeSchema,
   Sync,
   SyncDirectionSchema,
   SyncExecutionResultSchema,
@@ -1504,6 +1580,7 @@ export {
   SyncModeSchema,
   TaskCreationActionSchema,
   TimeTriggerSchema,
+  TransitionSchema,
   WebhookReceiverSchema,
   WebhookSchema,
   WebhookTriggerType,