@sentry/junior-scheduler 0.57.0

package/dist/plugin.d.ts

@@ -0,0 +1,4 @@
+/** Create Junior's built-in trusted scheduler plugin. */
+export declare function createSchedulerPlugin(): import("@sentry/junior-plugin-api").JuniorPlugin;
+/** Register trusted scheduler runtime hooks for scheduled Junior tasks. */
+export declare const schedulerPlugin: typeof createSchedulerPlugin;

package/dist/prompt.d.ts

@@ -0,0 +1,7 @@
+import { type ScheduledRun, type ScheduledTask } from "./types";
+/** Build the marker-delimited user prompt for one scheduled task execution. */
+export declare function buildScheduledTaskRunPrompt(args: {
+    nowMs: number;
+    run: ScheduledRun;
+    task: ScheduledTask;
+}): string;

package/dist/schedule-tools.d.ts

@@ -0,0 +1,25 @@
+import { type AgentPluginRequester, type AgentPluginState, type AgentPluginToolDefinition } from "@sentry/junior-plugin-api";
+export interface SchedulerToolContext {
+    channelCapabilities: {
+        canAddReactions: boolean;
+        canCreateCanvas: boolean;
+        canPostToChannel: boolean;
+    };
+    channelId?: string;
+    messageTs?: string;
+    requester?: AgentPluginRequester;
+    state: AgentPluginState;
+    teamId?: string;
+    threadTs?: string;
+    userText?: string;
+}
+/** Create a tool that stores a scheduled task for the active Slack context. */
+export declare function createSlackScheduleCreateTaskTool(context: SchedulerToolContext): AgentPluginToolDefinition<any>;
+/** Create a tool that lists scheduled tasks for the active Slack destination. */
+export declare function createSlackScheduleListTasksTool(context: SchedulerToolContext): AgentPluginToolDefinition<any>;
+/** Create a tool that edits a scheduled task in the active Slack destination. */
+export declare function createSlackScheduleUpdateTaskTool(context: SchedulerToolContext): AgentPluginToolDefinition<any>;
+/** Create a tool that removes a scheduled task from the active Slack destination. */
+export declare function createSlackScheduleDeleteTaskTool(context: SchedulerToolContext): AgentPluginToolDefinition<any>;
+/** Create a tool that marks an existing scheduled task due immediately. */
+export declare function createSlackScheduleRunTaskNowTool(context: SchedulerToolContext): AgentPluginToolDefinition<any>;

package/dist/store.d.ts

@@ -0,0 +1,49 @@
+import type { AgentPluginState } from "@sentry/junior-plugin-api";
+import type { ScheduledRun, ScheduledTask } from "./types";
+export interface SchedulerStore {
+    claimDueRun(args: {
+        nowMs: number;
+    }): Promise<ScheduledRun | undefined>;
+    getRun(runId: string): Promise<ScheduledRun | undefined>;
+    getTask(taskId: string): Promise<ScheduledTask | undefined>;
+    listIncompleteRuns(): Promise<ScheduledRun[]>;
+    listTasksForTeam(teamId: string): Promise<ScheduledTask[]>;
+    markRunBlocked(args: {
+        completedAtMs: number;
+        errorMessage: string;
+        runId: string;
+        startedAtMs?: number;
+    }): Promise<ScheduledRun | undefined>;
+    markRunCompleted(args: {
+        completedAtMs: number;
+        resultMessageTs?: string;
+        runId: string;
+        startedAtMs: number;
+    }): Promise<ScheduledRun | undefined>;
+    markRunFailed(args: {
+        completedAtMs: number;
+        errorMessage: string;
+        startedAtMs?: number;
+        runId: string;
+    }): Promise<ScheduledRun | undefined>;
+    markRunSkipped(args: {
+        completedAtMs: number;
+        errorMessage: string;
+        runId: string;
+    }): Promise<ScheduledRun | undefined>;
+    markRunDispatched(args: {
+        claimedAtMs: number;
+        dispatchId: string;
+        nowMs: number;
+        runId: string;
+    }): Promise<ScheduledRun | undefined>;
+    saveTask(task: ScheduledTask): Promise<void>;
+    updateTaskAfterRun(args: {
+        errorMessage?: string;
+        nowMs: number;
+        run: ScheduledRun;
+        status: "blocked" | "completed" | "failed";
+    }): Promise<void>;
+}
+/** Create a scheduler store backed by this plugin's durable state namespace. */
+export declare function createSchedulerStore(state: AgentPluginState): SchedulerStore;

package/dist/types.d.ts

@@ -0,0 +1,86 @@
+export type ScheduledTaskStatus = "active" | "paused" | "blocked" | "deleted";
+export type ScheduledRunStatus = "pending" | "running" | "completed" | "failed" | "blocked" | "skipped";
+export interface ScheduledTaskPrincipal {
+    slackUserId: string;
+    fullName?: string;
+    userName?: string;
+}
+export interface ScheduledTaskExecutionActor {
+    type: "system";
+    id: string;
+}
+export declare const SCHEDULED_TASK_SYSTEM_ACTOR: Readonly<{
+    type: "system";
+    id: string;
+}>;
+export interface ScheduledTaskDestination {
+    platform: "slack";
+    teamId: string;
+    channelId: string;
+}
+export interface ScheduledTaskConversationAccess {
+    audience: "direct" | "group" | "channel";
+    visibility: "private" | "public" | "unknown";
+}
+export interface ScheduledTaskCredentialSubject {
+    type: "user";
+    userId: string;
+    allowedWhen: "private-direct-conversation";
+}
+export type ScheduledCalendarFrequency = "daily" | "weekly" | "monthly" | "yearly";
+export interface ScheduledLocalTime {
+    hour: number;
+    minute: number;
+}
+export interface ScheduledTaskRecurrence {
+    dayOfMonth?: number;
+    frequency: ScheduledCalendarFrequency;
+    interval: number;
+    month?: number;
+    startDate: string;
+    time: ScheduledLocalTime;
+    weekdays?: number[];
+}
+export interface ScheduledTaskSchedule {
+    description: string;
+    timezone: string;
+    kind: "one_off" | "recurring";
+    recurrence?: ScheduledTaskRecurrence;
+}
+export interface ScheduledTaskSpec {
+    text: string;
+}
+export interface ScheduledTask {
+    id: string;
+    createdAtMs: number;
+    createdBy: ScheduledTaskPrincipal;
+    conversationAccess?: ScheduledTaskConversationAccess;
+    credentialSubject?: ScheduledTaskCredentialSubject;
+    destination: ScheduledTaskDestination;
+    executionActor?: ScheduledTaskExecutionActor;
+    lastRunAtMs?: number;
+    nextRunAtMs?: number;
+    originalRequest?: string;
+    runNowAtMs?: number;
+    schedule: ScheduledTaskSchedule;
+    status: ScheduledTaskStatus;
+    statusReason?: string;
+    task: ScheduledTaskSpec;
+    updatedAtMs: number;
+    version: number;
+}
+export interface ScheduledRun {
+    id: string;
+    attempt: number;
+    claimedAtMs: number;
+    completedAtMs?: number;
+    dispatchId?: string;
+    errorMessage?: string;
+    idempotencyKey: string;
+    resultMessageTs?: string;
+    scheduledForMs: number;
+    startedAtMs?: number;
+    status: ScheduledRunStatus;
+    taskId: string;
+    taskVersion: number;
+}

package/package.json

@@ -0,0 +1,38 @@
+{
+  "name": "@sentry/junior-scheduler",
+  "version": "0.57.0",
+  "private": false,
+  "publishConfig": {
+    "access": "public"
+  },
+  "type": "module",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/getsentry/junior.git",
+    "directory": "packages/junior-scheduler"
+  },
+  "exports": {
+    ".": {
+      "types": "./src/index.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "src",
+    "plugin.yaml"
+  ],
+  "dependencies": {
+    "@sinclair/typebox": "^0.34.49",
+    "@sentry/junior-plugin-api": "0.57.0"
+  },
+  "devDependencies": {
+    "@types/node": "^25.9.1",
+    "tsup": "^8.5.1",
+    "typescript": "^6.0.3"
+  },
+  "scripts": {
+    "build": "tsup && tsc -p tsconfig.build.json --emitDeclarationOnly",
+    "typecheck": "tsc --noEmit"
+  }
+}

package/plugin.yaml

@@ -0,0 +1,2 @@
+name: scheduler
+description: Scheduled Junior task management and heartbeat dispatch