@sentry/junior-scheduler 0.107.1 → 0.108.0

package/dist/schedule-intent.d.ts

@@ -0,0 +1,61 @@
+/**
+ * Owns model-facing schedule intent and materializes it against the trusted
+ * server clock into the canonical schedule persisted by the scheduler.
+ */
+import { z } from "zod";
+import type { ScheduledTaskSchedule } from "./types";
+export declare const scheduleIntentSchema: z.ZodUnion<readonly [z.ZodObject<{
+    kind: z.ZodLiteral<"one_off">;
+    timezone: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    timing: z.ZodDiscriminatedUnion<[z.ZodObject<{
+        type: z.ZodLiteral<"after">;
+        value: z.ZodNumber;
+        unit: z.ZodEnum<{
+            day: "day";
+            hour: "hour";
+            minute: "minute";
+            second: "second";
+            week: "week";
+        }>;
+    }, z.core.$strict>, z.ZodObject<{
+        type: z.ZodLiteral<"at">;
+        date: z.ZodString;
+        time: z.ZodString;
+    }, z.core.$strict>], "type">;
+}, z.core.$strict>, z.ZodObject<{
+    kind: z.ZodLiteral<"recurring">;
+    frequency: z.ZodEnum<{
+        daily: "daily";
+        weekly: "weekly";
+        monthly: "monthly";
+        yearly: "yearly";
+    }>;
+    interval: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    time: z.ZodString;
+    weekdays: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodEnum<{
+        sunday: "sunday";
+        monday: "monday";
+        tuesday: "tuesday";
+        wednesday: "wednesday";
+        thursday: "thursday";
+        friday: "friday";
+        saturday: "saturday";
+    }>>>>;
+    day_of_month: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    month: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    start_date: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    timezone: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, z.core.$strict>]>;
+export type ScheduleIntent = z.infer<typeof scheduleIntentSchema>;
+export interface CompiledScheduleIntent {
+    nextRunAtMs: number;
+    schedule: ScheduledTaskSchedule;
+}
+export declare class ScheduleIntentError extends Error {
+}
+/** Materialize model-interpreted schedule intent against the trusted server clock. */
+export declare function compileScheduleIntent(args: {
+    defaultTimezone: string;
+    intent: ScheduleIntent;
+    nowMs: number;
+}): CompiledScheduleIntent;

package/dist/store.d.ts

@@ -8,6 +8,7 @@ export interface SchedulerStore {
     claimDueRun(args: {
         nowMs: number;
     }): Promise<ScheduledRun | undefined>;
+    createTask(task: ScheduledTask): Promise<ScheduledTask>;
     getRun(runId: string): Promise<ScheduledRun | undefined>;
     getTask(taskId: string): Promise<ScheduledTask | undefined>;
     listIncompleteRuns(): Promise<ScheduledRun[]>;

package/dist/tool-support.d.ts

@@ -1,9 +1,10 @@
 import { type SlackDestination, type SlackActor, type SlackSource } from "@sentry/junior-plugin-api";
 import { z } from "zod";
 import { type SchedulerStore } from "./store";
-import type { ScheduledTask, ScheduledTaskConversationAccess, ScheduledTaskPrincipal, ScheduledTaskRecurrence, ScheduledTaskStatus } from "./types";
+import type { ScheduledTask, ScheduledTaskConversationAccess, ScheduledTaskPrincipal, ScheduledTaskStatus } from "./types";
 export interface SchedulerToolContext {
     actor?: SlackActor;
+    now?: () => number;
     source?: SlackSource;
     store: SchedulerStore;
     userText?: string;
@@ -245,40 +246,16 @@ export declare function scheduleListToolResult(args: {
     }[];
     readonly truncated: boolean;
 };
-/** Prefix generated scheduler ids so tool results are distinguishable from provider ids. */
-export declare function buildTaskId(): string;
+/** Build a retry-stable scheduler id scoped to the creating actor and destination. */
+export declare function buildTaskId(args: {
+    actor: ScheduledTaskPrincipal;
+    destination: SlackDestination;
+    toolCallId: string | undefined;
+}): string;
 /** Keep concrete scheduler tools coupled to the injected store, not global state. */
 export declare function schedulerStore(context: SchedulerToolContext): SchedulerStore;
 /** Accept only persisted scheduler statuses from model-facing update input. */
 export declare function normalizeStatus(value: string | undefined): ScheduledTaskStatus | undefined;
-/** Rebuild recurrence only from validated daily-or-slower schedule requests. */
-export declare function buildRecurrence(args: {
-    existing?: ScheduledTaskRecurrence;
-    input: {
-        recurrence?: unknown;
-    };
-    nextRunAtMs: number | undefined;
-    timezone: string;
-}): ScheduledTaskRecurrence | undefined;
-/** Reject recurrence values that would exceed the scheduler cadence policy. */
-export declare function validateRecurringFrequencyLimit(input: {
-    recurrence?: unknown;
-}): void;
-/** Force create-tool callers to explicitly choose one-off versus recurring semantics. */
-export declare function validateCreateScheduleKind(input: {
-    recurrence?: unknown;
-    schedule_kind?: unknown;
-}): void;
-/** Detect update inputs that affect calendar recurrence materialization. */
-export declare function shouldRebuildRecurrence(input: {
-    next_run_at?: string;
-    recurrence?: unknown;
-    timezone?: string;
-}): boolean;
 /** Centralize scheduler timezone defaulting for all concrete tool entry points. */
 export declare function getDefaultScheduleTimezone(): string;
-/** Validate IANA timezone names before persisting scheduler cadence state. */
-export declare function isValidTimeZone(timezone: string): boolean;
-/** Parse model-supplied timestamps without leaking date parser details to tools. */
-export declare function parseNextRunAtMs(nextRunAtIso: string | undefined): number | undefined;
 export {};

package/dist/tools/create-task.d.ts

@@ -2,11 +2,29 @@ import { type SchedulerToolContext } from "../tool-support";
 /** Create a tool that stores a scheduled task for the active Slack context. */
 export declare function createSlackScheduleCreateTaskTool(context: SchedulerToolContext): import("@sentry/junior-plugin-api").PluginToolDefinition<{
     task: string;
-    schedule: string;
-    schedule_kind: "one_off" | "recurring";
-    timezone?: string | undefined;
-    next_run_at?: string | undefined;
-    recurrence?: "daily" | "weekly" | "monthly" | "yearly" | null | undefined;
+    schedule: {
+        kind: "recurring";
+        frequency: "daily" | "weekly" | "monthly" | "yearly";
+        time: string;
+        interval?: number | null | undefined;
+        weekdays?: ("sunday" | "monday" | "tuesday" | "wednesday" | "thursday" | "friday" | "saturday")[] | null | undefined;
+        day_of_month?: number | null | undefined;
+        month?: number | null | undefined;
+        start_date?: string | null | undefined;
+        timezone?: string | null | undefined;
+    } | {
+        kind: "one_off";
+        timing: {
+            type: "after";
+            value: number;
+            unit: "day" | "hour" | "minute" | "second" | "week";
+        } | {
+            type: "at";
+            date: string;
+            time: string;
+        };
+        timezone?: string | null | undefined;
+    };
     credential_mode?: "system" | "creator" | null | undefined;
 }, {
     [x: string]: unknown;

package/dist/tools/update-task.d.ts

@@ -3,10 +3,29 @@ import { type SchedulerToolContext } from "../tool-support";
 export declare function createSlackScheduleUpdateTaskTool(context: SchedulerToolContext): import("@sentry/junior-plugin-api").PluginToolDefinition<{
     task_id: string;
     task?: string | undefined;
-    schedule?: string | undefined;
-    timezone?: string | undefined;
-    next_run_at?: string | undefined;
-    recurrence?: "daily" | "weekly" | "monthly" | "yearly" | null | undefined;
+    schedule?: {
+        kind: "recurring";
+        frequency: "daily" | "weekly" | "monthly" | "yearly";
+        time: string;
+        interval?: number | null | undefined;
+        weekdays?: ("sunday" | "monday" | "tuesday" | "wednesday" | "thursday" | "friday" | "saturday")[] | null | undefined;
+        day_of_month?: number | null | undefined;
+        month?: number | null | undefined;
+        start_date?: string | null | undefined;
+        timezone?: string | null | undefined;
+    } | {
+        kind: "one_off";
+        timing: {
+            type: "after";
+            value: number;
+            unit: "day" | "hour" | "minute" | "second" | "week";
+        } | {
+            type: "at";
+            date: string;
+            time: string;
+        };
+        timezone?: string | null | undefined;
+    } | null | undefined;
     status?: "blocked" | "active" | "paused" | undefined;
     credential_mode?: "system" | "creator" | null | undefined;
 }, {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sentry/junior-scheduler",
-  "version": "0.107.1",
+  "version": "0.108.0",
   "private": false,
   "publishConfig": {
     "access": "public"
@@ -25,7 +25,7 @@
   "dependencies": {
     "drizzle-orm": "^0.45.2",
     "zod": "^4.4.3",
-    "@sentry/junior-plugin-api": "0.107.1"
+    "@sentry/junior-plugin-api": "0.108.0"
   },
   "devDependencies": {
     "@types/node": "^25.9.1",