@otto-assistant/bridge 0.4.92

package/src/task-schedule.ts

@@ -0,0 +1,311 @@
+// Scheduled task parsing utilities for `send --send-at` and task runner execution.
+
+import { CronExpressionParser } from 'cron-parser'
+import * as errore from 'errore'
+
+export type ScheduledTaskPayload =
+  | {
+      kind: 'thread'
+      threadId: string
+      prompt: string
+      agent: string | null
+      model: string | null
+      username: string | null
+      userId: string | null
+      permissions: string[] | null
+      injectionGuardPatterns: string[] | null
+    }
+  | {
+      kind: 'channel'
+      channelId: string
+      prompt: string
+      name: string | null
+      notifyOnly: boolean
+      worktreeName: string | null
+      cwd: string | null
+      agent: string | null
+      model: string | null
+      username: string | null
+      userId: string | null
+      permissions: string[] | null
+      injectionGuardPatterns: string[] | null
+    }
+
+export type ParsedSendAt =
+  | {
+      scheduleKind: 'at'
+      runAt: Date
+      cronExpr: null
+      timezone: null
+      nextRunAt: Date
+    }
+  | {
+      scheduleKind: 'cron'
+      runAt: null
+      cronExpr: string
+      timezone: string
+      nextRunAt: Date
+    }
+
+const UTC_SEND_AT_DATE_REGEX =
+  /^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}(?::\d{2}(?:\.\d{1,3})?)?Z$/
+
+export function getLocalTimeZone(): string {
+  const tz = Intl.DateTimeFormat().resolvedOptions().timeZone
+  if (!tz) {
+    return 'UTC'
+  }
+  return tz
+}
+
+export function getPromptPreview(prompt: string): string {
+  const normalized = prompt.replace(/\s+/g, ' ').trim()
+  if (normalized.length <= 120) {
+    return normalized
+  }
+  return `${normalized.slice(0, 117)}...`
+}
+
+function parseUtcSendAtDate({
+  value,
+  now,
+}: {
+  value: string
+  now: Date
+}): Date | Error | null {
+  const looksLikeDate = value.includes('T') || /^\d{4}-\d{2}-\d{2}/.test(value)
+  if (!looksLikeDate) {
+    return null
+  }
+
+  if (!UTC_SEND_AT_DATE_REGEX.test(value)) {
+    return new Error(
+      `--send-at date must be UTC ISO format ending with Z (example: 2026-03-01T09:00:00Z). Received: ${value}`,
+    )
+  }
+
+  const runAt = new Date(value)
+  if (Number.isNaN(runAt.getTime())) {
+    return new Error(`Invalid UTC date for --send-at: ${value}`)
+  }
+
+  if (runAt.getTime() <= now.getTime()) {
+    return new Error(`--send-at date must be in the future (UTC): ${value}`)
+  }
+
+  return runAt
+}
+
+export function parseSendAtValue({
+  value,
+  now,
+  timezone,
+}: {
+  value: string
+  now: Date
+  timezone: string
+}): ParsedSendAt | Error {
+  const trimmed = value.trim()
+  if (!trimmed) {
+    return new Error('--send-at cannot be empty')
+  }
+
+  const utcDateResult = parseUtcSendAtDate({ value: trimmed, now })
+  if (utcDateResult instanceof Error) {
+    return utcDateResult
+  }
+  if (utcDateResult) {
+    return {
+      scheduleKind: 'at',
+      runAt: utcDateResult,
+      cronExpr: null,
+      timezone: null,
+      nextRunAt: utcDateResult,
+    }
+  }
+
+  const looksLikeCron =
+    trimmed.startsWith('@') || trimmed.split(/\s+/).length >= 5
+  if (looksLikeCron) {
+    const nextRunAtResult = getNextCronRun({
+      cronExpr: trimmed,
+      timezone,
+      from: now,
+    })
+    if (!(nextRunAtResult instanceof Error)) {
+      return {
+        scheduleKind: 'cron',
+        runAt: null,
+        cronExpr: trimmed,
+        timezone,
+        nextRunAt: nextRunAtResult,
+      }
+    }
+  }
+
+  const cronResult = getNextCronRun({ cronExpr: trimmed, timezone, from: now })
+  if (cronResult instanceof Error) {
+    return new Error(
+      `Invalid --send-at value: "${trimmed}". Use UTC ISO date/time ending in Z or a cron expression.`,
+      {
+        cause: cronResult,
+      },
+    )
+  }
+
+  return {
+    scheduleKind: 'cron',
+    runAt: null,
+    cronExpr: trimmed,
+    timezone,
+    nextRunAt: cronResult,
+  }
+}
+
+export function getNextCronRun({
+  cronExpr,
+  timezone,
+  from,
+}: {
+  cronExpr: string
+  timezone: string
+  from: Date
+}): Date | Error {
+  const parsed = errore.try({
+    try: () => {
+      return CronExpressionParser.parse(cronExpr, {
+        currentDate: from,
+        tz: timezone,
+      })
+    },
+    catch: (error) => {
+      return new Error(`Invalid cron expression: ${cronExpr}`, { cause: error })
+    },
+  })
+  if (parsed instanceof Error) {
+    return parsed
+  }
+
+  const next = errore.try({
+    try: () => {
+      return parsed.next().toDate()
+    },
+    catch: (error) => {
+      return new Error(`Could not compute next run for cron: ${cronExpr}`, {
+        cause: error,
+      })
+    },
+  })
+  if (next instanceof Error) {
+    return next
+  }
+
+  return next
+}
+
+export function serializeScheduledTaskPayload(
+  payload: ScheduledTaskPayload,
+): string {
+  return JSON.stringify(payload)
+}
+
+function isRecord(value: unknown): value is Record<string, unknown> {
+  return typeof value === 'object' && value !== null
+}
+
+function asString(value: unknown): string | null {
+  if (typeof value !== 'string') {
+    return null
+  }
+  return value
+}
+
+function asStringArray(value: unknown): string[] | null {
+  if (!Array.isArray(value)) {
+    return null
+  }
+  return value.filter((v): v is string => {
+    return typeof v === 'string'
+  })
+}
+
+export function parseScheduledTaskPayload(
+  payloadJson: string,
+): ScheduledTaskPayload | Error {
+  const parsed = errore.try({
+    try: () => {
+      return JSON.parse(payloadJson) as unknown
+    },
+    catch: (error) => {
+      return new Error('Task payload is not valid JSON', { cause: error })
+    },
+  })
+  if (parsed instanceof Error) {
+    return parsed
+  }
+  if (!isRecord(parsed)) {
+    return new Error('Task payload must be an object')
+  }
+
+  const kind = asString(parsed.kind)
+  if (kind === 'thread') {
+    const threadId = asString(parsed.threadId)
+    const prompt = asString(parsed.prompt)
+    const agent = asString(parsed.agent)
+    const model = asString(parsed.model)
+    const username = asString(parsed.username)
+    const userId = asString(parsed.userId)
+    const permissions = asStringArray(parsed.permissions)
+    const injectionGuardPatterns = asStringArray(parsed.injectionGuardPatterns)
+    if (!threadId || !prompt) {
+      return new Error('Thread task payload requires threadId and prompt')
+    }
+    return {
+      kind: 'thread',
+      threadId,
+      prompt,
+      agent,
+      model,
+      username,
+      userId,
+      permissions,
+      injectionGuardPatterns,
+    }
+  }
+
+  if (kind === 'channel') {
+    const channelId = asString(parsed.channelId)
+    const prompt = asString(parsed.prompt)
+    const nameValue = parsed.name
+    const name = typeof nameValue === 'string' ? nameValue : null
+    const notifyOnly = parsed.notifyOnly === true
+    const worktreeName = asString(parsed.worktreeName)
+    const cwd = asString(parsed.cwd)
+    const agent = asString(parsed.agent)
+    const model = asString(parsed.model)
+    const username = asString(parsed.username)
+    const userId = asString(parsed.userId)
+    const permissions = asStringArray(parsed.permissions)
+    const injectionGuardPatterns = asStringArray(parsed.injectionGuardPatterns)
+    if (!channelId || !prompt) {
+      return new Error('Channel task payload requires channelId and prompt')
+    }
+    return {
+      kind: 'channel',
+      channelId,
+      prompt,
+      name,
+      notifyOnly,
+      worktreeName,
+      cwd,
+      agent,
+      model,
+      username,
+      userId,
+      permissions,
+      injectionGuardPatterns,
+    }
+  }
+
+  return new Error('Task payload has unknown kind')
+}