@elizaos/plugin-scheduling 2.0.3-beta.6 → 2.0.3-beta.7

package/dist/scheduled-task/types.d.ts

@@ -0,0 +1,368 @@
+/**
+ * Frozen interface contract for `ScheduledTask`.
+ *
+ * The runner deliberately does NOT pattern-match on `promptInstructions` or
+ * on specific `kind` values — behavior is driven by the typed fields.
+ *
+ * Terminal-state vocabulary note:
+ *  - `completed`, `skipped`, `expired`, `dismissed` are reachable via the
+ *    public chat verbs in `ScheduledTaskVerb` (and via fire-time gate /
+ *    completion-check decisions).
+ *  - `failed` is a **dispatcher-runtime outcome**, not a chat verb. There is
+ *    no public `apply("failed")` entry point. The runner enters `failed`
+ *    when an infra-level dispatch error surfaces, when a child task
+ *    propagates `failed` upstream, or when callers invoke
+ *    `runner.pipeline(taskId, "failed")` directly. `pipeline.onFail` then
+ *    propagates the outcome to children and flips the parent's state to
+ *    `failed` so observers see one consistent terminal state per branch.
+ */
+export type TerminalState = "completed" | "skipped" | "expired" | "failed" | "dismissed";
+export type ScheduledTaskStatus = TerminalState | "scheduled" | "fired" | "acknowledged";
+export type ScheduledTaskKind = "reminder" | "checkin" | "followup" | "approval" | "recap" | "watcher" | "output" | "custom";
+/**
+ * What kind of host execution environment a scheduled task needs at fire
+ * time. The runner consults this against `getHostExecutionCapabilities`
+ * (in `@elizaos/app-core/services/local-inference/host-capabilities`) and
+ * substitutes `notify-only` semantics when the host can't satisfy the
+ * requested profile (e.g. mobile background without an FGS / BGProcessingTask).
+ *
+ * - `"foreground"`: requires the app to be foregrounded. Anything that
+ *   would block the UI thread or needs the user present.
+ * - `"bg-light-30s"`: bookkeeping that fits in ~30 s. Safe in iOS
+ *   BGAppRefreshTask windows; no LLM action.
+ * - `"bg-heavy-fgs"`: needs an Android foreground service OR an iOS
+ *   BGProcessingTask. Can run LLM inference. Long-running but bounded.
+ * - `"notify-only"`: just deliver a local notification; the user's tap
+ *   opens the app in foreground where the real work runs.
+ */
+export type TaskExecutionProfile = "foreground" | "bg-light-30s" | "bg-heavy-fgs" | "notify-only";
+export declare const TASK_EXECUTION_PROFILES: readonly ["foreground", "bg-light-30s", "bg-heavy-fgs", "notify-only"];
+/**
+ * Default profile assumed when a persisted task has no `executionProfile`
+ * column (back-compat for tasks written before this field landed).
+ * Foreground is the safest default — the runner downgrades to notify-only
+ * if even that isn't available.
+ */
+export declare const DEFAULT_TASK_EXECUTION_PROFILE: TaskExecutionProfile;
+export type ScheduledTaskPriority = "low" | "medium" | "high";
+export type ScheduledTaskSource = "default_pack" | "user_chat" | "first_run" | "plugin";
+export interface ScheduledTaskContextRequest {
+    includeOwnerFacts?: ("preferredName" | "timezone" | "morningWindow" | "eveningWindow" | "locale")[];
+    includeEntities?: {
+        entityIds: string[];
+        fields?: ("preferredName" | "type" | "identities" | "state.lastInteractionPlatform")[];
+    };
+    includeRelationships?: {
+        relationshipIds?: string[];
+        forEntityIds?: string[];
+        types?: string[];
+    };
+    includeRecentTaskStates?: {
+        kind?: ScheduledTaskKind;
+        lookbackHours?: number;
+    };
+    includeEventPayload?: boolean;
+}
+export type ScheduledTaskTrigger = {
+    kind: "once";
+    atIso: string;
+} | {
+    kind: "cron";
+    expression: string;
+    tz: string;
+} | {
+    kind: "interval";
+    everyMinutes: number;
+    from?: string;
+    until?: string;
+} | {
+    kind: "relative_to_anchor";
+    anchorKey: string;
+    offsetMinutes: number;
+} | {
+    kind: "during_window";
+    windowKey: string;
+} | {
+    kind: "event";
+    eventKind: string;
+    filter?: EventFilter;
+} | {
+    kind: "manual";
+} | {
+    kind: "after_task";
+    taskId: string;
+    outcome: TerminalState;
+};
+export type GateCompose = "all" | "any" | "first_deny";
+export interface ScheduledTaskGateRef {
+    kind: string;
+    params?: GateParams;
+}
+export interface ScheduledTaskShouldFire {
+    compose?: GateCompose;
+    gates: ScheduledTaskGateRef[];
+}
+export interface ScheduledTaskCompletionCheck {
+    kind: string;
+    params?: CompletionCheckParams;
+    /**
+     * Mutually exclusive with `pipeline.onSkip`. If both set, runner uses
+     * `pipeline.onSkip` and ignores this.
+     *
+     * For `kind === "approval"` tasks, the runner defaults this to
+     * {@link APPROVAL_DEFAULT_FOLLOWUP_AFTER_MINUTES} when the curator did
+     * not provide an explicit value (and `pipeline.onSkip` is empty).
+     */
+    followupAfterMinutes?: number;
+}
+/**
+ * Default `completionCheck.followupAfterMinutes` for approval-kind tasks
+ * when the curator did not set one explicitly. Approvals stale fast; a
+ * 60-minute followup is the documented baseline so curators do not need
+ * to repeat it on every approval definition.
+ */
+export declare const APPROVAL_DEFAULT_FOLLOWUP_AFTER_MINUTES = 60;
+export interface EscalationStep {
+    delayMinutes: number;
+    channelKey: string;
+    intensity?: "soft" | "normal" | "urgent";
+}
+export interface ScheduledTaskEscalation {
+    ladderKey?: string;
+    steps?: EscalationStep[];
+}
+export type ScheduledTaskOutputDestination = "in_app_card" | "channel" | "apple_notes" | "gmail_draft" | "memory";
+export interface ScheduledTaskOutput {
+    destination: ScheduledTaskOutputDestination;
+    target?: string;
+    persistAs?: "task_metadata" | "external_only";
+}
+export interface ScheduledTaskPipeline {
+    onComplete?: ScheduledTaskRef[];
+    onSkip?: ScheduledTaskRef[];
+    onFail?: ScheduledTaskRef[];
+}
+export type ScheduledTaskSubjectKind = "entity" | "relationship" | "thread" | "document" | "calendar_event" | "self";
+export interface ScheduledTaskSubject {
+    kind: ScheduledTaskSubjectKind;
+    id: string;
+}
+export interface ScheduledTaskState {
+    status: ScheduledTaskStatus;
+    firedAt?: string;
+    acknowledgedAt?: string;
+    completedAt?: string;
+    followupCount: number;
+    lastFollowupAt?: string;
+    pipelineParentId?: string;
+    lastDecisionLog?: string;
+}
+export interface ScheduledTask {
+    taskId: string;
+    kind: ScheduledTaskKind;
+    promptInstructions: string;
+    contextRequest?: ScheduledTaskContextRequest;
+    trigger: ScheduledTaskTrigger;
+    priority: ScheduledTaskPriority;
+    shouldFire?: ScheduledTaskShouldFire;
+    completionCheck?: ScheduledTaskCompletionCheck;
+    escalation?: ScheduledTaskEscalation;
+    output?: ScheduledTaskOutput;
+    pipeline?: ScheduledTaskPipeline;
+    subject?: ScheduledTaskSubject;
+    idempotencyKey?: string;
+    respectsGlobalPause: boolean;
+    state: ScheduledTaskState;
+    source: ScheduledTaskSource;
+    createdBy: string;
+    ownerVisible: boolean;
+    metadata?: Record<string, unknown>;
+    /**
+     * Host execution profile required at fire time. The runner consults the
+     * platform's `getHostExecutionCapabilities` and substitutes `notify-only`
+     * delivery when the requested profile isn't available (e.g. an LLM-heavy
+     * `"bg-heavy-fgs"` task on an iOS build with no BGProcessingTask
+     * identifier registered).
+     *
+     * Optional in this interface — repository reads default to
+     * {@link DEFAULT_TASK_EXECUTION_PROFILE} for back-compat with rows
+     * persisted before this field landed. The DB column is **not** NOT NULL
+     * yet; the next major version should backfill and tighten the schema.
+     *
+     * Schema migration note: once rows are backfilled, make this required and
+     * mark the column NOT NULL in the next major scheduled-task schema update.
+     */
+    executionProfile?: TaskExecutionProfile;
+}
+export type ScheduledTaskRef = string | ScheduledTask;
+export type EventFilter = unknown;
+export type GateParams = unknown;
+export type CompletionCheckParams = unknown;
+export type ScheduledTaskVerb = "snooze" | "skip" | "complete" | "dismiss" | "escalate" | "acknowledge" | "edit" | "reopen";
+export interface ScheduledTaskFilter {
+    kind?: ScheduledTaskKind;
+    status?: ScheduledTaskStatus | ScheduledTaskStatus[];
+    subject?: ScheduledTaskSubject;
+    source?: ScheduledTaskSource;
+    firedSince?: string;
+    ownerVisibleOnly?: boolean;
+}
+export interface ScheduledTaskRunner {
+    schedule(task: Omit<ScheduledTask, "taskId" | "state">): Promise<ScheduledTask>;
+    list(filter?: ScheduledTaskFilter): Promise<ScheduledTask[]>;
+    apply(taskId: string, verb: ScheduledTaskVerb, payload?: unknown): Promise<ScheduledTask>;
+    pipeline(taskId: string, outcome: TerminalState): Promise<ScheduledTask[]>;
+}
+export type GateDecision = {
+    kind: "allow";
+} | {
+    kind: "deny";
+    reason: string;
+} | {
+    kind: "defer";
+    until: {
+        offsetMinutes: number;
+    } | {
+        atIso: string;
+    };
+    reason: string;
+};
+/**
+ * Owner facts the gates / completion-checks read — the minimal surface every
+ * owner-fact consumer agrees to.
+ */
+export interface OwnerFactsView {
+    preferredName?: string;
+    timezone?: string;
+    locale?: string;
+    morningWindow?: {
+        start?: string;
+        end?: string;
+    };
+    eveningWindow?: {
+        start?: string;
+        end?: string;
+    };
+    quietHours?: {
+        start: string;
+        end: string;
+        tz: string;
+    };
+    travelActive?: boolean;
+    personalBaseline?: {
+        sampleCount?: number;
+        windowDays?: number;
+    };
+}
+/**
+ * Activity-signal subscriber surface. The runner consumes only the read
+ * side — completion-checks (`subject_updated`, `health_signal_observed`)
+ * and `trigger.kind = "event"` listeners need "did X happen since Y?"
+ * lookups.
+ */
+export interface ActivitySignalBusView {
+    hasSignalSince(args: {
+        signalKind: string;
+        sinceIso: string;
+        subject?: ScheduledTaskSubject;
+    }): boolean | Promise<boolean>;
+}
+/**
+ * Subject-resolution surface — the minimum the runner needs to know about a
+ * subject to evaluate a completion-check.
+ */
+export interface SubjectStoreView {
+    wasUpdatedSince(args: {
+        subject: ScheduledTaskSubject;
+        sinceIso: string;
+    }): boolean | Promise<boolean>;
+}
+/**
+ * Global-pause surface (`GlobalPauseStore`). The runner consults it pre-fire;
+ * tasks with `respectsGlobalPause: true` skip with `reason = "global_pause"`.
+ */
+export interface GlobalPauseView {
+    current(now?: Date): Promise<{
+        active: boolean;
+        startIso?: string;
+        endIso?: string;
+        reason?: string;
+    }>;
+}
+export interface GateEvaluationContext {
+    task: ScheduledTask;
+    nowIso: string;
+    ownerFacts: OwnerFactsView;
+    activity: ActivitySignalBusView;
+    subjectStore: SubjectStoreView;
+}
+export interface CompletionCheckContext {
+    task: ScheduledTask;
+    nowIso: string;
+    ownerFacts: OwnerFactsView;
+    activity: ActivitySignalBusView;
+    subjectStore: SubjectStoreView;
+    /** Whether the user explicitly acknowledged this fire (for `user_acknowledged`). */
+    acknowledged: boolean;
+    /** Whether the user replied (any inbound) since the most recent fire. */
+    repliedSinceFiredAt?: {
+        atIso: string;
+    };
+}
+export interface TaskGateContribution {
+    kind: string;
+    paramsSchema?: unknown;
+    evaluate(task: ScheduledTask, context: GateEvaluationContext): GateDecision | Promise<GateDecision>;
+}
+export interface CompletionCheckContribution {
+    kind: string;
+    paramsSchema?: unknown;
+    shouldComplete(task: ScheduledTask, context: CompletionCheckContext): boolean | Promise<boolean>;
+}
+export interface AnchorContext {
+    nowIso: string;
+    ownerFacts: OwnerFactsView;
+}
+export interface AnchorContribution {
+    anchorKey: string;
+    describe: {
+        label: string;
+        provider: string;
+    };
+    resolve(context: AnchorContext): {
+        atIso: string;
+    } | null | Promise<{
+        atIso: string;
+    } | null>;
+}
+export type AnchorConsolidationMode = "merge" | "sequential" | "parallel";
+export interface AnchorConsolidationPolicy {
+    anchorKey: string;
+    mode: AnchorConsolidationMode;
+    staggerMinutes?: number;
+    maxBatchSize?: number;
+    sortBy?: "priority_desc" | "fired_at_asc";
+}
+export type ScheduledTaskLogTransition = "scheduled" | "fire_attempt" | "fired" | "acknowledged" | "completed" | "skipped" | "snoozed" | "dismissed" | "escalated" | "edited" | "reopened" | "expired" | "failed" | "rolled_up"
+/**
+ * Emitted when the host can't satisfy the task's `executionProfile` and the
+ * runner downgrades dispatch to `notify-only`. The log row's `detail`
+ * carries `{ originalProfile, substituteProfile: "notify-only", reason }`
+ * so dashboards can show why a heavy task became a notification.
+ */
+ | "substituted";
+export interface ScheduledTaskLogEntry {
+    logId: string;
+    taskId: string;
+    agentId: string;
+    occurredAtIso: string;
+    transition: ScheduledTaskLogTransition;
+    reason?: string;
+    /**
+     * `true` when this row is a daily-summary rollup of expired raw entries
+     * (per IMPL §3.1 risk-and-tradeoff "State-log volume").
+     */
+    rolledUp: boolean;
+    detail?: Record<string, unknown>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/scheduled-task/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/scheduled-task/types.ts"],"names":[],"mappings":"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"}

package/dist/scheduled-task/types.js

@@ -0,0 +1,14 @@
+const TASK_EXECUTION_PROFILES = [
+  "foreground",
+  "bg-light-30s",
+  "bg-heavy-fgs",
+  "notify-only"
+];
+const DEFAULT_TASK_EXECUTION_PROFILE = "foreground";
+const APPROVAL_DEFAULT_FOLLOWUP_AFTER_MINUTES = 60;
+export {
+  APPROVAL_DEFAULT_FOLLOWUP_AFTER_MINUTES,
+  DEFAULT_TASK_EXECUTION_PROFILE,
+  TASK_EXECUTION_PROFILES
+};
+//# sourceMappingURL=types.js.map

package/dist/scheduled-task/types.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/scheduled-task/types.ts"],"sourcesContent":["/**\n * Frozen interface contract for `ScheduledTask`.\n *\n * The runner deliberately does NOT pattern-match on `promptInstructions` or\n * on specific `kind` values — behavior is driven by the typed fields.\n *\n * Terminal-state vocabulary note:\n *  - `completed`, `skipped`, `expired`, `dismissed` are reachable via the\n *    public chat verbs in `ScheduledTaskVerb` (and via fire-time gate /\n *    completion-check decisions).\n *  - `failed` is a **dispatcher-runtime outcome**, not a chat verb. There is\n *    no public `apply(\"failed\")` entry point. The runner enters `failed`\n *    when an infra-level dispatch error surfaces, when a child task\n *    propagates `failed` upstream, or when callers invoke\n *    `runner.pipeline(taskId, \"failed\")` directly. `pipeline.onFail` then\n *    propagates the outcome to children and flips the parent's state to\n *    `failed` so observers see one consistent terminal state per branch.\n */\n\n// ---------------------------------------------------------------------------\n// ScheduledTask schema (frozen)\n// ---------------------------------------------------------------------------\n\nexport type TerminalState =\n  | \"completed\"\n  | \"skipped\"\n  | \"expired\"\n  | \"failed\"\n  | \"dismissed\";\n\nexport type ScheduledTaskStatus =\n  | TerminalState\n  | \"scheduled\"\n  | \"fired\"\n  | \"acknowledged\";\n\nexport type ScheduledTaskKind =\n  | \"reminder\"\n  | \"checkin\"\n  | \"followup\"\n  | \"approval\"\n  | \"recap\"\n  | \"watcher\"\n  | \"output\"\n  | \"custom\";\n\n/**\n * What kind of host execution environment a scheduled task needs at fire\n * time. The runner consults this against `getHostExecutionCapabilities`\n * (in `@elizaos/app-core/services/local-inference/host-capabilities`) and\n * substitutes `notify-only` semantics when the host can't satisfy the\n * requested profile (e.g. mobile background without an FGS / BGProcessingTask).\n *\n * - `\"foreground\"`: requires the app to be foregrounded. Anything that\n *   would block the UI thread or needs the user present.\n * - `\"bg-light-30s\"`: bookkeeping that fits in ~30 s. Safe in iOS\n *   BGAppRefreshTask windows; no LLM action.\n * - `\"bg-heavy-fgs\"`: needs an Android foreground service OR an iOS\n *   BGProcessingTask. Can run LLM inference. Long-running but bounded.\n * - `\"notify-only\"`: just deliver a local notification; the user's tap\n *   opens the app in foreground where the real work runs.\n */\nexport type TaskExecutionProfile =\n  | \"foreground\"\n  | \"bg-light-30s\"\n  | \"bg-heavy-fgs\"\n  | \"notify-only\";\n\nexport const TASK_EXECUTION_PROFILES = [\n  \"foreground\",\n  \"bg-light-30s\",\n  \"bg-heavy-fgs\",\n  \"notify-only\",\n] as const satisfies readonly TaskExecutionProfile[];\n\n/**\n * Default profile assumed when a persisted task has no `executionProfile`\n * column (back-compat for tasks written before this field landed).\n * Foreground is the safest default — the runner downgrades to notify-only\n * if even that isn't available.\n */\nexport const DEFAULT_TASK_EXECUTION_PROFILE: TaskExecutionProfile =\n  \"foreground\";\n\nexport type ScheduledTaskPriority = \"low\" | \"medium\" | \"high\";\n\nexport type ScheduledTaskSource =\n  | \"default_pack\"\n  | \"user_chat\"\n  | \"first_run\"\n  | \"plugin\";\n\nexport interface ScheduledTaskContextRequest {\n  includeOwnerFacts?: (\n    | \"preferredName\"\n    | \"timezone\"\n    | \"morningWindow\"\n    | \"eveningWindow\"\n    | \"locale\"\n  )[];\n  includeEntities?: {\n    entityIds: string[];\n    fields?: (\n      | \"preferredName\"\n      | \"type\"\n      | \"identities\"\n      | \"state.lastInteractionPlatform\"\n    )[];\n  };\n  includeRelationships?: {\n    relationshipIds?: string[];\n    forEntityIds?: string[];\n    types?: string[];\n  };\n  includeRecentTaskStates?: {\n    kind?: ScheduledTaskKind;\n    lookbackHours?: number;\n  };\n  includeEventPayload?: boolean;\n}\n\nexport type ScheduledTaskTrigger =\n  | { kind: \"once\"; atIso: string }\n  | { kind: \"cron\"; expression: string; tz: string }\n  | { kind: \"interval\"; everyMinutes: number; from?: string; until?: string }\n  | { kind: \"relative_to_anchor\"; anchorKey: string; offsetMinutes: number }\n  | { kind: \"during_window\"; windowKey: string }\n  | { kind: \"event\"; eventKind: string; filter?: EventFilter }\n  | { kind: \"manual\" }\n  | { kind: \"after_task\"; taskId: string; outcome: TerminalState };\n\nexport type GateCompose = \"all\" | \"any\" | \"first_deny\";\n\nexport interface ScheduledTaskGateRef {\n  kind: string;\n  params?: GateParams;\n}\n\nexport interface ScheduledTaskShouldFire {\n  compose?: GateCompose;\n  gates: ScheduledTaskGateRef[];\n}\n\nexport interface ScheduledTaskCompletionCheck {\n  kind: string;\n  params?: CompletionCheckParams;\n  /**\n   * Mutually exclusive with `pipeline.onSkip`. If both set, runner uses\n   * `pipeline.onSkip` and ignores this.\n   *\n   * For `kind === \"approval\"` tasks, the runner defaults this to\n   * {@link APPROVAL_DEFAULT_FOLLOWUP_AFTER_MINUTES} when the curator did\n   * not provide an explicit value (and `pipeline.onSkip` is empty).\n   */\n  followupAfterMinutes?: number;\n}\n\n/**\n * Default `completionCheck.followupAfterMinutes` for approval-kind tasks\n * when the curator did not set one explicitly. Approvals stale fast; a\n * 60-minute followup is the documented baseline so curators do not need\n * to repeat it on every approval definition.\n */\nexport const APPROVAL_DEFAULT_FOLLOWUP_AFTER_MINUTES = 60;\n\nexport interface EscalationStep {\n  delayMinutes: number;\n  channelKey: string;\n  intensity?: \"soft\" | \"normal\" | \"urgent\";\n}\n\nexport interface ScheduledTaskEscalation {\n  ladderKey?: string;\n  steps?: EscalationStep[];\n}\n\nexport type ScheduledTaskOutputDestination =\n  | \"in_app_card\"\n  | \"channel\"\n  | \"apple_notes\"\n  | \"gmail_draft\"\n  | \"memory\";\n\nexport interface ScheduledTaskOutput {\n  destination: ScheduledTaskOutputDestination;\n  target?: string;\n  persistAs?: \"task_metadata\" | \"external_only\";\n}\n\nexport interface ScheduledTaskPipeline {\n  onComplete?: ScheduledTaskRef[];\n  onSkip?: ScheduledTaskRef[];\n  onFail?: ScheduledTaskRef[];\n}\n\nexport type ScheduledTaskSubjectKind =\n  | \"entity\"\n  | \"relationship\"\n  | \"thread\"\n  | \"document\"\n  | \"calendar_event\"\n  | \"self\";\n\nexport interface ScheduledTaskSubject {\n  kind: ScheduledTaskSubjectKind;\n  id: string;\n}\n\nexport interface ScheduledTaskState {\n  status: ScheduledTaskStatus;\n  firedAt?: string;\n  acknowledgedAt?: string;\n  completedAt?: string;\n  followupCount: number;\n  lastFollowupAt?: string;\n  pipelineParentId?: string;\n  lastDecisionLog?: string;\n}\n\nexport interface ScheduledTask {\n  taskId: string;\n  kind: ScheduledTaskKind;\n  promptInstructions: string;\n  contextRequest?: ScheduledTaskContextRequest;\n  trigger: ScheduledTaskTrigger;\n  priority: ScheduledTaskPriority;\n  shouldFire?: ScheduledTaskShouldFire;\n  completionCheck?: ScheduledTaskCompletionCheck;\n  escalation?: ScheduledTaskEscalation;\n  output?: ScheduledTaskOutput;\n  pipeline?: ScheduledTaskPipeline;\n  subject?: ScheduledTaskSubject;\n  idempotencyKey?: string;\n  respectsGlobalPause: boolean;\n  state: ScheduledTaskState;\n  source: ScheduledTaskSource;\n  createdBy: string;\n  ownerVisible: boolean;\n  metadata?: Record<string, unknown>;\n  /**\n   * Host execution profile required at fire time. The runner consults the\n   * platform's `getHostExecutionCapabilities` and substitutes `notify-only`\n   * delivery when the requested profile isn't available (e.g. an LLM-heavy\n   * `\"bg-heavy-fgs\"` task on an iOS build with no BGProcessingTask\n   * identifier registered).\n   *\n   * Optional in this interface — repository reads default to\n   * {@link DEFAULT_TASK_EXECUTION_PROFILE} for back-compat with rows\n   * persisted before this field landed. The DB column is **not** NOT NULL\n   * yet; the next major version should backfill and tighten the schema.\n   *\n   * Schema migration note: once rows are backfilled, make this required and\n   * mark the column NOT NULL in the next major scheduled-task schema update.\n   */\n  executionProfile?: TaskExecutionProfile;\n}\n\nexport type ScheduledTaskRef = string | ScheduledTask;\nexport type EventFilter = unknown; // typed via EventKindRegistry per kind\nexport type GateParams = unknown; // typed via TaskGateRegistry per kind\nexport type CompletionCheckParams = unknown; // typed via CompletionCheckRegistry per kind\n\n// ---------------------------------------------------------------------------\n// §1.2 Runner verbs (frozen)\n// ---------------------------------------------------------------------------\n\nexport type ScheduledTaskVerb =\n  | \"snooze\"\n  | \"skip\"\n  | \"complete\"\n  | \"dismiss\"\n  | \"escalate\"\n  | \"acknowledge\"\n  | \"edit\"\n  | \"reopen\";\n\nexport interface ScheduledTaskFilter {\n  kind?: ScheduledTaskKind;\n  status?: ScheduledTaskStatus | ScheduledTaskStatus[];\n  subject?: ScheduledTaskSubject;\n  source?: ScheduledTaskSource;\n  firedSince?: string;\n  ownerVisibleOnly?: boolean;\n}\n\nexport interface ScheduledTaskRunner {\n  schedule(\n    task: Omit<ScheduledTask, \"taskId\" | \"state\">,\n  ): Promise<ScheduledTask>;\n  list(filter?: ScheduledTaskFilter): Promise<ScheduledTask[]>;\n  apply(\n    taskId: string,\n    verb: ScheduledTaskVerb,\n    payload?: unknown,\n  ): Promise<ScheduledTask>;\n  pipeline(taskId: string, outcome: TerminalState): Promise<ScheduledTask[]>;\n}\n\n// ---------------------------------------------------------------------------\n// §1.3 Gate / completion-check registries (frozen)\n// ---------------------------------------------------------------------------\n\nexport type GateDecision =\n  | { kind: \"allow\" }\n  | { kind: \"deny\"; reason: string }\n  | {\n      kind: \"defer\";\n      until: { offsetMinutes: number } | { atIso: string };\n      reason: string;\n    };\n\n/**\n * Owner facts the gates / completion-checks read — the minimal surface every\n * owner-fact consumer agrees to.\n */\nexport interface OwnerFactsView {\n  preferredName?: string;\n  timezone?: string;\n  locale?: string;\n  morningWindow?: { start?: string; end?: string };\n  eveningWindow?: { start?: string; end?: string };\n  quietHours?: { start: string; end: string; tz: string };\n  travelActive?: boolean;\n  personalBaseline?: {\n    sampleCount?: number;\n    windowDays?: number;\n  };\n}\n\n/**\n * Activity-signal subscriber surface. The runner consumes only the read\n * side — completion-checks (`subject_updated`, `health_signal_observed`)\n * and `trigger.kind = \"event\"` listeners need \"did X happen since Y?\"\n * lookups.\n */\nexport interface ActivitySignalBusView {\n  hasSignalSince(args: {\n    signalKind: string;\n    sinceIso: string;\n    subject?: ScheduledTaskSubject;\n  }): boolean | Promise<boolean>;\n}\n\n/**\n * Subject-resolution surface — the minimum the runner needs to know about a\n * subject to evaluate a completion-check.\n */\nexport interface SubjectStoreView {\n  wasUpdatedSince(args: {\n    subject: ScheduledTaskSubject;\n    sinceIso: string;\n  }): boolean | Promise<boolean>;\n}\n\n/**\n * Global-pause surface (`GlobalPauseStore`). The runner consults it pre-fire;\n * tasks with `respectsGlobalPause: true` skip with `reason = \"global_pause\"`.\n */\nexport interface GlobalPauseView {\n  current(now?: Date): Promise<{\n    active: boolean;\n    startIso?: string;\n    endIso?: string;\n    reason?: string;\n  }>;\n}\n\nexport interface GateEvaluationContext {\n  task: ScheduledTask;\n  nowIso: string;\n  ownerFacts: OwnerFactsView;\n  activity: ActivitySignalBusView;\n  subjectStore: SubjectStoreView;\n}\n\nexport interface CompletionCheckContext {\n  task: ScheduledTask;\n  nowIso: string;\n  ownerFacts: OwnerFactsView;\n  activity: ActivitySignalBusView;\n  subjectStore: SubjectStoreView;\n  /** Whether the user explicitly acknowledged this fire (for `user_acknowledged`). */\n  acknowledged: boolean;\n  /** Whether the user replied (any inbound) since the most recent fire. */\n  repliedSinceFiredAt?: { atIso: string };\n}\n\nexport interface TaskGateContribution {\n  kind: string;\n  paramsSchema?: unknown;\n  evaluate(\n    task: ScheduledTask,\n    context: GateEvaluationContext,\n  ): GateDecision | Promise<GateDecision>;\n}\n\nexport interface CompletionCheckContribution {\n  kind: string;\n  paramsSchema?: unknown;\n  shouldComplete(\n    task: ScheduledTask,\n    context: CompletionCheckContext,\n  ): boolean | Promise<boolean>;\n}\n\n// ---------------------------------------------------------------------------\n// §1.4 Anchor + consolidation registries (frozen)\n// ---------------------------------------------------------------------------\n\nexport interface AnchorContext {\n  nowIso: string;\n  ownerFacts: OwnerFactsView;\n}\n\nexport interface AnchorContribution {\n  anchorKey: string;\n  describe: { label: string; provider: string };\n  resolve(\n    context: AnchorContext,\n  ): { atIso: string } | null | Promise<{ atIso: string } | null>;\n}\n\nexport type AnchorConsolidationMode = \"merge\" | \"sequential\" | \"parallel\";\n\nexport interface AnchorConsolidationPolicy {\n  anchorKey: string;\n  mode: AnchorConsolidationMode;\n  staggerMinutes?: number;\n  maxBatchSize?: number;\n  sortBy?: \"priority_desc\" | \"fired_at_asc\";\n}\n\n// ---------------------------------------------------------------------------\n// State-log row\n// ---------------------------------------------------------------------------\n\nexport type ScheduledTaskLogTransition =\n  | \"scheduled\"\n  | \"fire_attempt\"\n  | \"fired\"\n  | \"acknowledged\"\n  | \"completed\"\n  | \"skipped\"\n  | \"snoozed\"\n  | \"dismissed\"\n  | \"escalated\"\n  | \"edited\"\n  | \"reopened\"\n  | \"expired\"\n  | \"failed\"\n  | \"rolled_up\"\n  /**\n   * Emitted when the host can't satisfy the task's `executionProfile` and the\n   * runner downgrades dispatch to `notify-only`. The log row's `detail`\n   * carries `{ originalProfile, substituteProfile: \"notify-only\", reason }`\n   * so dashboards can show why a heavy task became a notification.\n   */\n  | \"substituted\";\n\nexport interface ScheduledTaskLogEntry {\n  logId: string;\n  taskId: string;\n  agentId: string;\n  occurredAtIso: string;\n  transition: ScheduledTaskLogTransition;\n  reason?: string;\n  /**\n   * `true` when this row is a daily-summary rollup of expired raw entries\n   * (per IMPL §3.1 risk-and-tradeoff \"State-log volume\").\n   */\n  rolledUp: boolean;\n  detail?: Record<string, unknown>;\n}\n"],"mappings":"AAoEO,MAAM,0BAA0B;AAAA,EACrC;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF;AAQO,MAAM,iCACX;AAiFK,MAAM,0CAA0C;","names":[]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@elizaos/plugin-scheduling",
-  "version": "2.0.3-beta.6",
+  "version": "2.0.3-beta.7",
   "type": "module",
   "description": "Scheduling spine for elizaOS agents: the storage-agnostic ScheduledTask state machine — trigger evaluation (cron/interval/once/event/after_task/relative_to_anchor/during_window), gate + completion-check + escalation-ladder + anchor + consolidation registries, the due/next-fire-at math, and the runner. Persistence + owner/channel/connector deps are injected by the host (e.g. @elizaos/plugin-personal-assistant). Reminders register a tick-hook via the ports here.",
   "main": "./dist/index.js",
@@ -47,12 +47,12 @@
     }
   },
   "dependencies": {
-    "@elizaos/core": "2.0.3-beta.6",
-    "@elizaos/shared": "2.0.3-beta.6",
+    "@elizaos/core": "2.0.3-beta.7",
+    "@elizaos/shared": "2.0.3-beta.7",
     "drizzle-orm": "^0.45.1"
   },
   "peerDependencies": {
-    "@elizaos/plugin-sql": "2.0.3-beta.6"
+    "@elizaos/plugin-sql": "2.0.3-beta.7"
   },
   "publishConfig": {
     "access": "public"
@@ -69,5 +69,5 @@
     "typescript": "^6.0.3",
     "vitest": "^4.0.17"
   },
-  "gitHead": "990dc996172b3e0fb525a75052a5ac28a4cd4de5"
+  "gitHead": "61094f10458d11055c75b3dd0bae374e3f66bac5"
 }