skedyul 1.2.44 → 1.2.48

package/dist/scheduling/types-workflow.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Workflow-Safe Scheduling Types
+ *
+ * These types are plain TypeScript interfaces without zod dependencies.
+ * They can be safely imported in Temporal workflow code.
+ *
+ * Note: The zod schemas in types.ts are the source of truth for validation.
+ * These interfaces mirror them for workflow use.
+ */
+/**
+ * TimeStamp can be either:
+ * - A number representing hour of day (0-23)
+ * - An object with hour, minute, second (minute and second default to 0 in parsing)
+ *
+ * Note: After zod parsing, minute and second are always numbers (defaulted to 0).
+ * For workflow input, you can omit them but the resolved type expects numbers.
+ */
+export type TimeStamp = number | {
+    hour: number;
+    minute: number;
+    second: number;
+};
+export type DayOfWeek = 'monday' | 'tuesday' | 'wednesday' | 'thursday' | 'friday' | 'saturday' | 'sunday';
+export interface TimeWindowSlot {
+    startTime: TimeStamp;
+    endTime: TimeStamp;
+    days: DayOfWeek[];
+    timezone?: string;
+}
+export type WaitUnit = 'second' | 'seconds' | 'minute' | 'minutes' | 'hour' | 'hours' | 'day' | 'days' | 'week' | 'weeks' | 'month' | 'months' | 'year' | 'years';
+export interface WaitInputRelative {
+    mode: 'relative';
+    amount: number;
+    unit: WaitUnit;
+    windows?: TimeWindowSlot[];
+}
+export interface WaitInputAbsolute {
+    mode: 'absolute';
+    scheduleAt: string | number;
+}
+export type WaitInputType = WaitInputRelative | WaitInputAbsolute;
+export interface CalculateWaitTimeResult {
+    waitTime: number;
+    scheduledAt: Date;
+}
+export interface TimeWindowPolicy {
+    timezone: string;
+    windows: TimeWindowSlot[];
+    behavior?: {
+        responseMode?: 'immediate' | 'ack_and_schedule' | 'schedule_only';
+        prompt?: string;
+        scheduleFor?: string;
+    };
+}

package/dist/scheduling/types.d.ts

@@ -0,0 +1,166 @@
+/**
+ * Scheduling Types
+ *
+ * Time window and scheduling types used for agent scheduling and workflow waits.
+ * This is the source of truth - skedyul-core re-exports these for backward compatibility.
+ */
+import { z } from 'zod/v4';
+/**
+ * TimeStamp can be either:
+ * - A number representing hour of day (0-23)
+ * - An object with hour, minute, second
+ */
+export declare const TimeStampSchema: z.ZodUnion<readonly [z.ZodNumber, z.ZodObject<{
+    hour: z.ZodNumber;
+    minute: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    second: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+}, z.core.$strip>]>;
+export type TimeStamp = z.infer<typeof TimeStampSchema>;
+export declare const DayOfWeekSchema: z.ZodEnum<{
+    monday: "monday";
+    tuesday: "tuesday";
+    wednesday: "wednesday";
+    thursday: "thursday";
+    friday: "friday";
+    saturday: "saturday";
+    sunday: "sunday";
+}>;
+export type DayOfWeek = z.infer<typeof DayOfWeekSchema>;
+export declare const TimeWindowSlotSchema: z.ZodObject<{
+    startTime: z.ZodUnion<readonly [z.ZodNumber, z.ZodObject<{
+        hour: z.ZodNumber;
+        minute: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+        second: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    }, z.core.$strip>]>;
+    endTime: z.ZodUnion<readonly [z.ZodNumber, z.ZodObject<{
+        hour: z.ZodNumber;
+        minute: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+        second: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    }, z.core.$strip>]>;
+    days: z.ZodArray<z.ZodEnum<{
+        monday: "monday";
+        tuesday: "tuesday";
+        wednesday: "wednesday";
+        thursday: "thursday";
+        friday: "friday";
+        saturday: "saturday";
+        sunday: "sunday";
+    }>>;
+    timezone: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type TimeWindowSlot = z.infer<typeof TimeWindowSlotSchema>;
+export declare const WaitUnitSchema: z.ZodEnum<{
+    hour: "hour";
+    minute: "minute";
+    days: "days";
+    second: "second";
+    seconds: "seconds";
+    minutes: "minutes";
+    hours: "hours";
+    day: "day";
+    week: "week";
+    weeks: "weeks";
+    month: "month";
+    months: "months";
+    year: "year";
+    years: "years";
+}>;
+export type WaitUnit = z.infer<typeof WaitUnitSchema>;
+export declare const WaitInputRelativeSchema: z.ZodObject<{
+    mode: z.ZodLiteral<"relative">;
+    amount: z.ZodNumber;
+    unit: z.ZodEnum<{
+        hour: "hour";
+        minute: "minute";
+        days: "days";
+        second: "second";
+        seconds: "seconds";
+        minutes: "minutes";
+        hours: "hours";
+        day: "day";
+        week: "week";
+        weeks: "weeks";
+        month: "month";
+        months: "months";
+        year: "year";
+        years: "years";
+    }>;
+    windows: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        startTime: z.ZodUnion<readonly [z.ZodNumber, z.ZodObject<{
+            hour: z.ZodNumber;
+            minute: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+            second: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+        }, z.core.$strip>]>;
+        endTime: z.ZodUnion<readonly [z.ZodNumber, z.ZodObject<{
+            hour: z.ZodNumber;
+            minute: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+            second: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+        }, z.core.$strip>]>;
+        days: z.ZodArray<z.ZodEnum<{
+            monday: "monday";
+            tuesday: "tuesday";
+            wednesday: "wednesday";
+            thursday: "thursday";
+            friday: "friday";
+            saturday: "saturday";
+            sunday: "sunday";
+        }>>;
+        timezone: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>>;
+}, z.core.$strip>;
+export declare const WaitInputAbsoluteSchema: z.ZodObject<{
+    mode: z.ZodLiteral<"absolute">;
+    scheduleAt: z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>;
+}, z.core.$strip>;
+export declare const WaitInputSchema: z.ZodUnion<readonly [z.ZodObject<{
+    mode: z.ZodLiteral<"relative">;
+    amount: z.ZodNumber;
+    unit: z.ZodEnum<{
+        hour: "hour";
+        minute: "minute";
+        days: "days";
+        second: "second";
+        seconds: "seconds";
+        minutes: "minutes";
+        hours: "hours";
+        day: "day";
+        week: "week";
+        weeks: "weeks";
+        month: "month";
+        months: "months";
+        year: "year";
+        years: "years";
+    }>;
+    windows: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        startTime: z.ZodUnion<readonly [z.ZodNumber, z.ZodObject<{
+            hour: z.ZodNumber;
+            minute: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+            second: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+        }, z.core.$strip>]>;
+        endTime: z.ZodUnion<readonly [z.ZodNumber, z.ZodObject<{
+            hour: z.ZodNumber;
+            minute: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+            second: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+        }, z.core.$strip>]>;
+        days: z.ZodArray<z.ZodEnum<{
+            monday: "monday";
+            tuesday: "tuesday";
+            wednesday: "wednesday";
+            thursday: "thursday";
+            friday: "friday";
+            saturday: "saturday";
+            sunday: "sunday";
+        }>>;
+        timezone: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>>;
+}, z.core.$strip>, z.ZodObject<{
+    mode: z.ZodLiteral<"absolute">;
+    scheduleAt: z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>;
+}, z.core.$strip>]>;
+export type WaitInputRelative = z.infer<typeof WaitInputRelativeSchema>;
+export type WaitInputAbsolute = z.infer<typeof WaitInputAbsoluteSchema>;
+export type WaitInputType = z.infer<typeof WaitInputSchema>;
+export interface CalculateWaitTimeResult {
+    waitTime: number;
+    scheduledAt: Date;
+}