@sentry/junior-scheduler 0.107.1 → 0.109.0

package/README.md

@@ -9,8 +9,17 @@ Junior's durable agent runtime.
   prompt text, timezone-aware schedule, recurrence, credential mode, status, and
   next-run state.
 - SQL schemas and migrations are authoritative for persistence.
-- Schedule parsing normalizes calendar intent before storage; execution does not
+- Model-facing tools accept structured schedule intent. The scheduler resolves
+  relative delays and calendar fields against its server clock and timezone,
+  computes `nextRunAtMs`, and stores the canonical schedule. Execution does not
   reinterpret the original natural-language request.
+- Relative delays are elapsed durations. Calendar schedules use local wall-clock
+  time: nonexistent recurring times are skipped, nonexistent one-off times are
+  rejected, and repeated times use their first instant.
+- Multi-week recurrences use Monday-based calendar weeks; `startDate` is the
+  lower bound and its containing week is the first active week.
+- Create tool-call identities produce stable task ids so retrying one committed
+  tool invocation returns the existing task instead of duplicating it.
 - Updates and deletion invalidate obsolete pending run times.
 
 ## Dispatch

package/dist/cadence.d.ts

@@ -1,6 +1,4 @@
-import type { ScheduledCalendarFrequency, ScheduledTask, ScheduledTaskRecurrence } from "./types";
-/** Parse an ISO timestamp into a finite Unix timestamp in milliseconds. */
-export declare function parseScheduleTimestamp(value: string): number | undefined;
+import type { ScheduledLocalTime, ScheduledTask, ScheduledTaskRecurrence } from "./types";
 export interface ZonedDateTimeParts {
     day: number;
     hour: number;
@@ -12,13 +10,17 @@ export interface ZonedDateTimeParts {
 }
 /** Resolve a UTC timestamp into calendar parts for a named time zone. */
 export declare function getZonedDateTimeParts(timestampMs: number, timezone: string): ZonedDateTimeParts;
-/** Build a calendar recurrence anchored to an exact first run timestamp. */
-export declare function buildCalendarRecurrence(args: {
-    frequency: ScheduledCalendarFrequency;
-    interval?: number;
-    nextRunAtMs: number;
+/** Resolve local time, rejecting DST gaps and choosing the earlier instant in a fold. */
+export declare function resolveLocalScheduleAtMs(args: {
+    date: string;
+    time: ScheduledLocalTime;
     timezone: string;
-    weekdays?: number[];
-}): ScheduledTaskRecurrence;
+}): number | undefined;
+/** Compute the first recurring calendar occurrence strictly after a timestamp. */
+export declare function getFirstRunAtMs(args: {
+    afterMs: number;
+    recurrence: ScheduledTaskRecurrence;
+    timezone: string;
+}): number | undefined;
 /** Return the next fire time after a completed run, when the task recurs. */
 export declare function getNextRunAtMs(task: ScheduledTask, scheduledForMs: number, afterMs?: number): number | undefined;

package/dist/index.d.ts

@@ -1,4 +1,4 @@
 export { createSchedulerPlugin, schedulerPlugin } from "./plugin";
 export { createSlackScheduleCreateTaskTool, createSlackScheduleDeleteTaskTool, createSlackScheduleListTasksTool, createSlackScheduleRunTaskNowTool, createSlackScheduleUpdateTaskTool, type SchedulerToolContext, } from "./schedule-tools";
-export { createSchedulerOperationalSqlStore, createSchedulerSqlStore, migrateSchedulerStateToSql, type SchedulerDb, } from "./store";
+export { createSchedulerOperationalSqlStore, createSchedulerSqlStore, type SchedulerDb, } from "./store";
 export type { ScheduledCalendarFrequency, ScheduledLocalTime, ScheduledRun, ScheduledRunStatus, ScheduledTask, ScheduledTaskConversationAccess, ScheduledTaskExecutionActor, ScheduledTaskPrincipal, ScheduledTaskRecurrence, ScheduledTaskSchedule, ScheduledTaskSpec, ScheduledTaskStatus, } from "./types";