skedyul 1.2.40 → 1.2.43

package/dist/workflows/types.d.ts

@@ -0,0 +1,295 @@
+import { z } from 'zod/v4';
+/**
+ * Workflow YAML schema version
+ */
+export declare const WORKFLOW_SCHEMA_VERSION = "https://skedyul.com/schemas/workflow/v1";
+/**
+ * Workflow input definition (what inputs the workflow needs)
+ */
+export declare const WorkflowInputSchema: z.ZodObject<{
+    type: z.ZodString;
+    required: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    description: z.ZodOptional<z.ZodString>;
+    default: z.ZodOptional<z.ZodUnknown>;
+}, z.core.$strip>;
+export type WorkflowInput = z.infer<typeof WorkflowInputSchema>;
+/**
+ * Workflow step input - can be a literal value or a Liquid template
+ */
+export declare const WorkflowStepInputSchema: z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodRecord<z.ZodString, z.ZodUnknown>]>;
+export type WorkflowStepInput = z.infer<typeof WorkflowStepInputSchema>;
+/**
+ * Workflow step definition
+ */
+export declare const WorkflowStepSchema: z.ZodObject<{
+    service: z.ZodString;
+    cmd: z.ZodString;
+    needs: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    inputs: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodRecord<z.ZodString, z.ZodUnknown>]>>>;
+    condition: z.ZodOptional<z.ZodString>;
+    retry: z.ZodOptional<z.ZodObject<{
+        attempts: z.ZodOptional<z.ZodNumber>;
+        backoff: z.ZodOptional<z.ZodEnum<{
+            linear: "linear";
+            exponential: "exponential";
+        }>>;
+    }, z.core.$strip>>;
+    timeout: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type WorkflowStep = z.infer<typeof WorkflowStepSchema>;
+/**
+ * Workflow runtime configuration
+ */
+export declare const WorkflowRuntimeSchema: z.ZodObject<{
+    durable: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    timeout: z.ZodOptional<z.ZodString>;
+    retry: z.ZodOptional<z.ZodObject<{
+        attempts: z.ZodOptional<z.ZodNumber>;
+        backoff: z.ZodOptional<z.ZodEnum<{
+            linear: "linear";
+            exponential: "exponential";
+        }>>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type WorkflowRuntime = z.infer<typeof WorkflowRuntimeSchema>;
+/**
+ * Full Workflow YAML schema (v2 - event-driven)
+ */
+export declare const WorkflowYAMLSchema: z.ZodObject<{
+    $schema: z.ZodOptional<z.ZodString>;
+    handle: z.ZodString;
+    name: z.ZodString;
+    version: z.ZodOptional<z.ZodString>;
+    description: z.ZodOptional<z.ZodString>;
+    inputs: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+        type: z.ZodString;
+        required: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+        description: z.ZodOptional<z.ZodString>;
+        default: z.ZodOptional<z.ZodUnknown>;
+    }, z.core.$strip>>>;
+    events: z.ZodOptional<z.ZodObject<{
+        subscribes: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodEnum<{
+            "thread.message.received": "thread.message.received";
+            "thread.message.sent": "thread.message.sent";
+            "thread.participant.joined": "thread.participant.joined";
+            "thread.participant.left": "thread.participant.left";
+            "thread.participant.mentioned": "thread.participant.mentioned";
+            "thread.context.changed": "thread.context.changed";
+            "thread.status.changed": "thread.status.changed";
+            "thread.agent.delegated": "thread.agent.delegated";
+            "thread.agent.completed": "thread.agent.completed";
+            "thread.workflow.triggered": "thread.workflow.triggered";
+            "thread.workflow.completed": "thread.workflow.completed";
+            "thread.follow_up.due": "thread.follow_up.due";
+            "thread.reminder.due": "thread.reminder.due";
+        }>, z.ZodString]>>>;
+        condition: z.ZodOptional<z.ZodString>;
+        emits: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodEnum<{
+            "thread.message.received": "thread.message.received";
+            "thread.message.sent": "thread.message.sent";
+            "thread.participant.joined": "thread.participant.joined";
+            "thread.participant.left": "thread.participant.left";
+            "thread.participant.mentioned": "thread.participant.mentioned";
+            "thread.context.changed": "thread.context.changed";
+            "thread.status.changed": "thread.status.changed";
+            "thread.agent.delegated": "thread.agent.delegated";
+            "thread.agent.completed": "thread.agent.completed";
+            "thread.workflow.triggered": "thread.workflow.triggered";
+            "thread.workflow.completed": "thread.workflow.completed";
+            "thread.follow_up.due": "thread.follow_up.due";
+            "thread.reminder.due": "thread.reminder.due";
+        }>, z.ZodString]>>>;
+        waits: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            event: z.ZodUnion<readonly [z.ZodEnum<{
+                "thread.message.received": "thread.message.received";
+                "thread.message.sent": "thread.message.sent";
+                "thread.participant.joined": "thread.participant.joined";
+                "thread.participant.left": "thread.participant.left";
+                "thread.participant.mentioned": "thread.participant.mentioned";
+                "thread.context.changed": "thread.context.changed";
+                "thread.status.changed": "thread.status.changed";
+                "thread.agent.delegated": "thread.agent.delegated";
+                "thread.agent.completed": "thread.agent.completed";
+                "thread.workflow.triggered": "thread.workflow.triggered";
+                "thread.workflow.completed": "thread.workflow.completed";
+                "thread.follow_up.due": "thread.follow_up.due";
+                "thread.reminder.due": "thread.reminder.due";
+            }>, z.ZodString]>;
+            timeout: z.ZodOptional<z.ZodString>;
+            onTimeout: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>>;
+        cancels: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodEnum<{
+            "thread.message.received": "thread.message.received";
+            "thread.message.sent": "thread.message.sent";
+            "thread.participant.joined": "thread.participant.joined";
+            "thread.participant.left": "thread.participant.left";
+            "thread.participant.mentioned": "thread.participant.mentioned";
+            "thread.context.changed": "thread.context.changed";
+            "thread.status.changed": "thread.status.changed";
+            "thread.agent.delegated": "thread.agent.delegated";
+            "thread.agent.completed": "thread.agent.completed";
+            "thread.workflow.triggered": "thread.workflow.triggered";
+            "thread.workflow.completed": "thread.workflow.completed";
+            "thread.follow_up.due": "thread.follow_up.due";
+            "thread.reminder.due": "thread.reminder.due";
+        }>, z.ZodString]>>>;
+        cancelCondition: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    steps: z.ZodRecord<z.ZodString, z.ZodObject<{
+        service: z.ZodString;
+        cmd: z.ZodString;
+        needs: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        inputs: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodRecord<z.ZodString, z.ZodUnknown>]>>>;
+        condition: z.ZodOptional<z.ZodString>;
+        retry: z.ZodOptional<z.ZodObject<{
+            attempts: z.ZodOptional<z.ZodNumber>;
+            backoff: z.ZodOptional<z.ZodEnum<{
+                linear: "linear";
+                exponential: "exponential";
+            }>>;
+        }, z.core.$strip>>;
+        timeout: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    runtime: z.ZodOptional<z.ZodObject<{
+        durable: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+        timeout: z.ZodOptional<z.ZodString>;
+        retry: z.ZodOptional<z.ZodObject<{
+            attempts: z.ZodOptional<z.ZodNumber>;
+            backoff: z.ZodOptional<z.ZodEnum<{
+                linear: "linear";
+                exponential: "exponential";
+            }>>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type WorkflowYAML = z.infer<typeof WorkflowYAMLSchema>;
+/**
+ * Workflow file metadata (for registry)
+ */
+export declare const WorkflowMetadataSchema: z.ZodObject<{
+    handle: z.ZodString;
+    name: z.ZodString;
+    version: z.ZodOptional<z.ZodString>;
+    description: z.ZodOptional<z.ZodString>;
+    inputs: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+        type: z.ZodString;
+        required: z.ZodOptional<z.ZodBoolean>;
+        description: z.ZodOptional<z.ZodString>;
+        default: z.ZodOptional<z.ZodUnknown>;
+    }, z.core.$strip>>>;
+    events: z.ZodOptional<z.ZodObject<{
+        subscribes: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodEnum<{
+            "thread.message.received": "thread.message.received";
+            "thread.message.sent": "thread.message.sent";
+            "thread.participant.joined": "thread.participant.joined";
+            "thread.participant.left": "thread.participant.left";
+            "thread.participant.mentioned": "thread.participant.mentioned";
+            "thread.context.changed": "thread.context.changed";
+            "thread.status.changed": "thread.status.changed";
+            "thread.agent.delegated": "thread.agent.delegated";
+            "thread.agent.completed": "thread.agent.completed";
+            "thread.workflow.triggered": "thread.workflow.triggered";
+            "thread.workflow.completed": "thread.workflow.completed";
+            "thread.follow_up.due": "thread.follow_up.due";
+            "thread.reminder.due": "thread.reminder.due";
+        }>, z.ZodString]>>>;
+        condition: z.ZodOptional<z.ZodString>;
+        emits: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodEnum<{
+            "thread.message.received": "thread.message.received";
+            "thread.message.sent": "thread.message.sent";
+            "thread.participant.joined": "thread.participant.joined";
+            "thread.participant.left": "thread.participant.left";
+            "thread.participant.mentioned": "thread.participant.mentioned";
+            "thread.context.changed": "thread.context.changed";
+            "thread.status.changed": "thread.status.changed";
+            "thread.agent.delegated": "thread.agent.delegated";
+            "thread.agent.completed": "thread.agent.completed";
+            "thread.workflow.triggered": "thread.workflow.triggered";
+            "thread.workflow.completed": "thread.workflow.completed";
+            "thread.follow_up.due": "thread.follow_up.due";
+            "thread.reminder.due": "thread.reminder.due";
+        }>, z.ZodString]>>>;
+        waits: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            event: z.ZodUnion<readonly [z.ZodEnum<{
+                "thread.message.received": "thread.message.received";
+                "thread.message.sent": "thread.message.sent";
+                "thread.participant.joined": "thread.participant.joined";
+                "thread.participant.left": "thread.participant.left";
+                "thread.participant.mentioned": "thread.participant.mentioned";
+                "thread.context.changed": "thread.context.changed";
+                "thread.status.changed": "thread.status.changed";
+                "thread.agent.delegated": "thread.agent.delegated";
+                "thread.agent.completed": "thread.agent.completed";
+                "thread.workflow.triggered": "thread.workflow.triggered";
+                "thread.workflow.completed": "thread.workflow.completed";
+                "thread.follow_up.due": "thread.follow_up.due";
+                "thread.reminder.due": "thread.reminder.due";
+            }>, z.ZodString]>;
+            timeout: z.ZodOptional<z.ZodString>;
+            onTimeout: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>>;
+        cancels: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodEnum<{
+            "thread.message.received": "thread.message.received";
+            "thread.message.sent": "thread.message.sent";
+            "thread.participant.joined": "thread.participant.joined";
+            "thread.participant.left": "thread.participant.left";
+            "thread.participant.mentioned": "thread.participant.mentioned";
+            "thread.context.changed": "thread.context.changed";
+            "thread.status.changed": "thread.status.changed";
+            "thread.agent.delegated": "thread.agent.delegated";
+            "thread.agent.completed": "thread.agent.completed";
+            "thread.workflow.triggered": "thread.workflow.triggered";
+            "thread.workflow.completed": "thread.workflow.completed";
+            "thread.follow_up.due": "thread.follow_up.due";
+            "thread.reminder.due": "thread.reminder.due";
+        }>, z.ZodString]>>>;
+        cancelCondition: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type WorkflowMetadata = z.infer<typeof WorkflowMetadataSchema>;
+/**
+ * Workflow execution status
+ */
+export declare const WorkflowExecutionStatusSchema: z.ZodEnum<{
+    PENDING: "PENDING";
+    RUNNING: "RUNNING";
+    COMPLETED: "COMPLETED";
+    FAILED: "FAILED";
+    CANCELLED: "CANCELLED";
+    WAITING: "WAITING";
+}>;
+export type WorkflowExecutionStatus = z.infer<typeof WorkflowExecutionStatusSchema>;
+/**
+ * Workflow execution result
+ */
+export declare const WorkflowExecutionResultSchema: z.ZodObject<{
+    status: z.ZodEnum<{
+        PENDING: "PENDING";
+        RUNNING: "RUNNING";
+        COMPLETED: "COMPLETED";
+        FAILED: "FAILED";
+        CANCELLED: "CANCELLED";
+        WAITING: "WAITING";
+    }>;
+    outputs: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    error: z.ZodOptional<z.ZodString>;
+    startedAt: z.ZodOptional<z.ZodString>;
+    completedAt: z.ZodOptional<z.ZodString>;
+    cancelledAt: z.ZodOptional<z.ZodString>;
+    cancelReason: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type WorkflowExecutionResult = z.infer<typeof WorkflowExecutionResultSchema>;
+/**
+ * Helper function to define a workflow with type safety
+ */
+export declare function defineWorkflowYAML(workflow: WorkflowYAML): WorkflowYAML;
+/**
+ * Validate a workflow YAML object
+ */
+export declare function validateWorkflowYAML(workflow: unknown): {
+    success: true;
+    data: WorkflowYAML;
+} | {
+    success: false;
+    error: z.ZodError;
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "skedyul",
-  "version": "1.2.40",
+  "version": "1.2.43",
   "description": "The Skedyul SDK for Node.js",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -31,6 +31,24 @@
       "types": "./dist/cli/utils/auth.d.ts",
       "require": "./dist/cli/utils/auth.js",
       "default": "./dist/cli/utils/auth.js"
+    },
+    "./schemas/agent-schema": {
+      "types": "./dist/schemas/agent-schema.d.ts",
+      "import": "./dist/schemas/agent-schema.mjs",
+      "require": "./dist/schemas/agent-schema.js",
+      "default": "./dist/schemas/agent-schema.js"
+    },
+    "./schemas/agent-schema-v3": {
+      "types": "./dist/schemas/agent-schema-v3.d.ts",
+      "import": "./dist/schemas/agent-schema-v3.mjs",
+      "require": "./dist/schemas/agent-schema-v3.js",
+      "default": "./dist/schemas/agent-schema-v3.js"
+    },
+    "./skills/types": {
+      "types": "./dist/skills/types.d.ts",
+      "import": "./dist/skills/types.mjs",
+      "require": "./dist/skills/types.js",
+      "default": "./dist/skills/types.js"
     }
   },
   "files": [