@letta-ai/letta-code 0.30.0 → 0.30.1

package/dist/schedules.js

@@ -0,0 +1,189 @@
+// src/cron/scheduled-task-prompt.ts
+var SYSTEM_REMINDER_OPEN = "<system-reminder>";
+var SYSTEM_REMINDER_CLOSE = "</system-reminder>";
+var AUTONOMOUS_NOTICE_PREFIX = "You are running autonomously:";
+var AUTONOMOUS_NOTICE = "You are running autonomously: no user is watching this turn and questions will not be answered. Deliver results through your available channels or record them in memory, and work until the task is done or genuinely blocked.";
+function pad(value, width) {
+  return String(value).padStart(width, "0");
+}
+function formatOffset(minutes) {
+  const sign = minutes >= 0 ? "+" : "-";
+  const abs = Math.abs(minutes);
+  return `${sign}${pad(Math.floor(abs / 60), 2)}:${pad(abs % 60, 2)}`;
+}
+function getLocalDateTimeParts(date) {
+  return {
+    year: date.getFullYear(),
+    month: date.getMonth() + 1,
+    day: date.getDate(),
+    hour: date.getHours(),
+    minute: date.getMinutes(),
+    second: date.getSeconds()
+  };
+}
+function isValidTimezone(timezone) {
+  try {
+    new Intl.DateTimeFormat("en-US", { timeZone: timezone });
+    return true;
+  } catch {
+    return false;
+  }
+}
+function getSystemTimezone() {
+  const timezone = Intl.DateTimeFormat().resolvedOptions().timeZone;
+  if (!timezone || !isValidTimezone(timezone)) {
+    return null;
+  }
+  return timezone;
+}
+function getEffectiveTimezone(timezone) {
+  const trimmed = timezone.trim();
+  if (trimmed && isValidTimezone(trimmed)) {
+    return trimmed;
+  }
+  return getSystemTimezone();
+}
+function formatTimezoneDisplay(timezone) {
+  const trimmed = timezone.trim();
+  if (!trimmed) {
+    return "local time";
+  }
+  if (isValidTimezone(trimmed)) {
+    return trimmed;
+  }
+  return `${trimmed} (invalid; using local time)`;
+}
+function getZonedDateTimeParts(date, timezone) {
+  const formatter = new Intl.DateTimeFormat("en-US", {
+    timeZone: timezone,
+    calendar: "iso8601",
+    numberingSystem: "latn",
+    hourCycle: "h23",
+    year: "numeric",
+    month: "2-digit",
+    day: "2-digit",
+    hour: "2-digit",
+    minute: "2-digit",
+    second: "2-digit"
+  });
+  const parts = new Map(formatter.formatToParts(date).map((part) => [part.type, part.value]));
+  return {
+    year: Number.parseInt(parts.get("year") ?? "0", 10),
+    month: Number.parseInt(parts.get("month") ?? "1", 10),
+    day: Number.parseInt(parts.get("day") ?? "1", 10),
+    hour: Number.parseInt(parts.get("hour") ?? "0", 10),
+    minute: Number.parseInt(parts.get("minute") ?? "0", 10),
+    second: Number.parseInt(parts.get("second") ?? "0", 10)
+  };
+}
+function formatTimezoneQualifiedIso(date, timezone) {
+  const effectiveTimezone = getEffectiveTimezone(timezone);
+  const parts = effectiveTimezone ? getZonedDateTimeParts(date, effectiveTimezone) : getLocalDateTimeParts(date);
+  const millis = date.getMilliseconds();
+  const zonedAsUtcMs = Date.UTC(parts.year, parts.month - 1, parts.day, parts.hour, parts.minute, parts.second, millis);
+  const offsetMinutes = Math.round((zonedAsUtcMs - date.getTime()) / 60000);
+  return `${pad(parts.year, 4)}-${pad(parts.month, 2)}-${pad(parts.day, 2)}T${pad(parts.hour, 2)}:${pad(parts.minute, 2)}:${pad(parts.second, 2)}.${pad(millis, 3)}${formatOffset(offsetMinutes)}[${effectiveTimezone ?? "local"}]`;
+}
+function formatRecurrence(recurrence) {
+  if (recurrence.type === "one-off") {
+    return "This is a one-off scheduled task.";
+  }
+  if (recurrence.fireNumber !== undefined) {
+    return `This is fire #${recurrence.fireNumber} (cron: ${recurrence.cron}).`;
+  }
+  return `This is a recurring scheduled task (cron: ${recurrence.cron}).`;
+}
+function formatScheduledTaskPrompt(input) {
+  const lines = [
+    `Scheduled task "${input.name}" is firing.`,
+    ...input.description ? [`Description: ${input.description}`] : [],
+    `Timezone: ${formatTimezoneDisplay(input.timezone)}`,
+    `Scheduled for: ${formatTimezoneQualifiedIso(input.scheduledFor, input.timezone)}`,
+    `Current time: ${formatTimezoneQualifiedIso(input.currentTime, input.timezone)}`,
+    formatRecurrence(input.recurrence),
+    "",
+    AUTONOMOUS_NOTICE,
+    "",
+    `Prompt: ${input.prompt}`
+  ];
+  return lines.join(`
+`);
+}
+function unwrapSystemReminder(text) {
+  const trimmed = text.trim();
+  if (trimmed.startsWith(SYSTEM_REMINDER_OPEN) && trimmed.endsWith(SYSTEM_REMINDER_CLOSE)) {
+    return trimmed.slice(SYSTEM_REMINDER_OPEN.length, -SYSTEM_REMINDER_CLOSE.length).trim();
+  }
+  return trimmed;
+}
+function getField(lines, prefix) {
+  const line = lines.find((candidate) => candidate.startsWith(prefix));
+  const value = line?.slice(prefix.length).trim();
+  return value || null;
+}
+function getPrompt(text, recurrenceLineIndex) {
+  const promptMarker = `
+Prompt: `;
+  const promptIndex = text.indexOf(promptMarker);
+  if (promptIndex >= 0) {
+    return text.slice(promptIndex + promptMarker.length).trim() || null;
+  }
+  const trailingLines = text.split(`
+`).slice(recurrenceLineIndex + 1);
+  while (trailingLines[0]?.trim() === "")
+    trailingLines.shift();
+  if (trailingLines[0]?.startsWith(AUTONOMOUS_NOTICE_PREFIX)) {
+    trailingLines.shift();
+    while (trailingLines[0]?.trim() === "")
+      trailingLines.shift();
+  }
+  return trailingLines.join(`
+`).trim() || null;
+}
+function parseScheduledTaskPrompt(rawText) {
+  const text = unwrapSystemReminder(rawText).replace(/\r\n/g, `
+`);
+  const lines = text.split(`
+`);
+  const titleMatch = /^Scheduled task ["“](.+)["”] is firing\.$/.exec(lines[0]?.trim() ?? "");
+  if (!titleMatch?.[1])
+    return null;
+  const recurrenceLineIndex = lines.findIndex((line) => {
+    const trimmed = line.trim();
+    return trimmed === "This is a one-off scheduled task." || /^This is fire #\d+ \(cron: .+\)\.$/.test(trimmed) || /^This is a recurring scheduled task \(cron: .+\)\.$/.test(trimmed);
+  });
+  if (recurrenceLineIndex < 0)
+    return null;
+  const recurrenceLine = lines[recurrenceLineIndex]?.trim() ?? "";
+  const countedRecurringMatch = /^This is fire #(\d+) \(cron: (.+)\)\.$/.exec(recurrenceLine);
+  const recurringMatch = /^This is a recurring scheduled task \(cron: (.+)\)\.$/.exec(recurrenceLine);
+  let recurrence;
+  if (countedRecurringMatch) {
+    recurrence = {
+      type: "recurring",
+      fireNumber: Number.parseInt(countedRecurringMatch[1] ?? "0", 10),
+      cron: countedRecurringMatch[2] ?? ""
+    };
+  } else if (recurringMatch) {
+    recurrence = { type: "recurring", cron: recurringMatch[1] ?? "" };
+  } else {
+    recurrence = { type: "one-off" };
+  }
+  const prompt = getPrompt(text, recurrenceLineIndex);
+  if (!prompt)
+    return null;
+  return {
+    name: titleMatch[1],
+    description: getField(lines, "Description:"),
+    timezone: getField(lines, "Timezone:"),
+    scheduledFor: getField(lines, "Scheduled for:"),
+    recurrence,
+    prompt
+  };
+}
+export {
+  parseScheduledTaskPrompt,
+  formatScheduledTaskPrompt
+};
+
+//# debugId=07276DD08883835A64756E2164756E21

package/dist/schedules.js.map

@@ -0,0 +1,10 @@
+{
+  "version": 3,
+  "sources": ["../src/cron/scheduled-task-prompt.ts"],
+  "sourcesContent": [
+    "export type ScheduledTaskRecurrence =\n  | { type: \"one-off\" }\n  | { type: \"recurring\"; cron: string; fireNumber?: number };\n\nexport interface ScheduledTaskPromptInput {\n  name: string;\n  description?: string | null;\n  timezone: string;\n  scheduledFor: Date;\n  currentTime: Date;\n  recurrence: ScheduledTaskRecurrence;\n  prompt: string;\n}\n\nexport interface ScheduledTaskPromptInfo {\n  name: string;\n  description: string | null;\n  timezone: string | null;\n  scheduledFor: string | null;\n  recurrence: ScheduledTaskRecurrence;\n  prompt: string;\n}\n\ninterface ZonedDateTimeParts {\n  year: number;\n  month: number;\n  day: number;\n  hour: number;\n  minute: number;\n  second: number;\n}\n\nconst SYSTEM_REMINDER_OPEN = \"<system-reminder>\";\nconst SYSTEM_REMINDER_CLOSE = \"</system-reminder>\";\nconst AUTONOMOUS_NOTICE_PREFIX = \"You are running autonomously:\";\nconst AUTONOMOUS_NOTICE =\n  \"You are running autonomously: no user is watching this turn and questions will not be answered. Deliver results through your available channels or record them in memory, and work until the task is done or genuinely blocked.\";\n\nfunction pad(value: number, width: number): string {\n  return String(value).padStart(width, \"0\");\n}\n\nfunction formatOffset(minutes: number): string {\n  const sign = minutes >= 0 ? \"+\" : \"-\";\n  const abs = Math.abs(minutes);\n  return `${sign}${pad(Math.floor(abs / 60), 2)}:${pad(abs % 60, 2)}`;\n}\n\nfunction getLocalDateTimeParts(date: Date): ZonedDateTimeParts {\n  return {\n    year: date.getFullYear(),\n    month: date.getMonth() + 1,\n    day: date.getDate(),\n    hour: date.getHours(),\n    minute: date.getMinutes(),\n    second: date.getSeconds(),\n  };\n}\n\nfunction isValidTimezone(timezone: string): boolean {\n  try {\n    new Intl.DateTimeFormat(\"en-US\", { timeZone: timezone });\n    return true;\n  } catch {\n    return false;\n  }\n}\n\nfunction getSystemTimezone(): string | null {\n  const timezone = Intl.DateTimeFormat().resolvedOptions().timeZone;\n  if (!timezone || !isValidTimezone(timezone)) {\n    return null;\n  }\n  return timezone;\n}\n\nfunction getEffectiveTimezone(timezone: string): string | null {\n  const trimmed = timezone.trim();\n  if (trimmed && isValidTimezone(trimmed)) {\n    return trimmed;\n  }\n  return getSystemTimezone();\n}\n\nfunction formatTimezoneDisplay(timezone: string): string {\n  const trimmed = timezone.trim();\n  if (!trimmed) {\n    return \"local time\";\n  }\n  if (isValidTimezone(trimmed)) {\n    return trimmed;\n  }\n  return `${trimmed} (invalid; using local time)`;\n}\n\nfunction getZonedDateTimeParts(\n  date: Date,\n  timezone: string,\n): ZonedDateTimeParts {\n  const formatter = new Intl.DateTimeFormat(\"en-US\", {\n    timeZone: timezone,\n    calendar: \"iso8601\",\n    numberingSystem: \"latn\",\n    hourCycle: \"h23\",\n    year: \"numeric\",\n    month: \"2-digit\",\n    day: \"2-digit\",\n    hour: \"2-digit\",\n    minute: \"2-digit\",\n    second: \"2-digit\",\n  });\n  const parts = new Map(\n    formatter.formatToParts(date).map((part) => [part.type, part.value]),\n  );\n\n  return {\n    year: Number.parseInt(parts.get(\"year\") ?? \"0\", 10),\n    month: Number.parseInt(parts.get(\"month\") ?? \"1\", 10),\n    day: Number.parseInt(parts.get(\"day\") ?? \"1\", 10),\n    hour: Number.parseInt(parts.get(\"hour\") ?? \"0\", 10),\n    minute: Number.parseInt(parts.get(\"minute\") ?? \"0\", 10),\n    second: Number.parseInt(parts.get(\"second\") ?? \"0\", 10),\n  };\n}\n\nexport function formatTimezoneQualifiedIso(\n  date: Date,\n  timezone: string,\n): string {\n  const effectiveTimezone = getEffectiveTimezone(timezone);\n  const parts = effectiveTimezone\n    ? getZonedDateTimeParts(date, effectiveTimezone)\n    : getLocalDateTimeParts(date);\n  const millis = date.getMilliseconds();\n  const zonedAsUtcMs = Date.UTC(\n    parts.year,\n    parts.month - 1,\n    parts.day,\n    parts.hour,\n    parts.minute,\n    parts.second,\n    millis,\n  );\n  const offsetMinutes = Math.round((zonedAsUtcMs - date.getTime()) / 60_000);\n\n  return `${pad(parts.year, 4)}-${pad(parts.month, 2)}-${pad(parts.day, 2)}T${pad(parts.hour, 2)}:${pad(parts.minute, 2)}:${pad(parts.second, 2)}.${pad(millis, 3)}${formatOffset(offsetMinutes)}[${effectiveTimezone ?? \"local\"}]`;\n}\n\nfunction formatRecurrence(recurrence: ScheduledTaskRecurrence): string {\n  if (recurrence.type === \"one-off\") {\n    return \"This is a one-off scheduled task.\";\n  }\n  if (recurrence.fireNumber !== undefined) {\n    return `This is fire #${recurrence.fireNumber} (cron: ${recurrence.cron}).`;\n  }\n  return `This is a recurring scheduled task (cron: ${recurrence.cron}).`;\n}\n\n/**\n * Build the canonical prompt envelope for a scheduled agent turn.\n *\n * Every schedule runner should call this immediately before dispatch while\n * keeping its stored authored prompt separate from runtime metadata.\n */\nexport function formatScheduledTaskPrompt(\n  input: ScheduledTaskPromptInput,\n): string {\n  const lines = [\n    `Scheduled task \"${input.name}\" is firing.`,\n    ...(input.description ? [`Description: ${input.description}`] : []),\n    `Timezone: ${formatTimezoneDisplay(input.timezone)}`,\n    `Scheduled for: ${formatTimezoneQualifiedIso(input.scheduledFor, input.timezone)}`,\n    `Current time: ${formatTimezoneQualifiedIso(input.currentTime, input.timezone)}`,\n    formatRecurrence(input.recurrence),\n    \"\",\n    AUTONOMOUS_NOTICE,\n    \"\",\n    `Prompt: ${input.prompt}`,\n  ];\n  return lines.join(\"\\n\");\n}\n\nfunction unwrapSystemReminder(text: string): string {\n  const trimmed = text.trim();\n  if (\n    trimmed.startsWith(SYSTEM_REMINDER_OPEN) &&\n    trimmed.endsWith(SYSTEM_REMINDER_CLOSE)\n  ) {\n    return trimmed\n      .slice(SYSTEM_REMINDER_OPEN.length, -SYSTEM_REMINDER_CLOSE.length)\n      .trim();\n  }\n  return trimmed;\n}\n\nfunction getField(lines: string[], prefix: string): string | null {\n  const line = lines.find((candidate) => candidate.startsWith(prefix));\n  const value = line?.slice(prefix.length).trim();\n  return value || null;\n}\n\nfunction getPrompt(text: string, recurrenceLineIndex: number): string | null {\n  const promptMarker = \"\\nPrompt: \";\n  const promptIndex = text.indexOf(promptMarker);\n  if (promptIndex >= 0) {\n    return text.slice(promptIndex + promptMarker.length).trim() || null;\n  }\n\n  const trailingLines = text.split(\"\\n\").slice(recurrenceLineIndex + 1);\n  while (trailingLines[0]?.trim() === \"\") trailingLines.shift();\n  if (trailingLines[0]?.startsWith(AUTONOMOUS_NOTICE_PREFIX)) {\n    trailingLines.shift();\n    while (trailingLines[0]?.trim() === \"\") trailingLines.shift();\n  }\n  return trailingLines.join(\"\\n\").trim() || null;\n}\n\n/** Parse canonical and legacy scheduled-task envelopes from persisted messages. */\nexport function parseScheduledTaskPrompt(\n  rawText: string,\n): ScheduledTaskPromptInfo | null {\n  const text = unwrapSystemReminder(rawText).replace(/\\r\\n/g, \"\\n\");\n  const lines = text.split(\"\\n\");\n  const titleMatch = /^Scheduled task [\"“](.+)[\"”] is firing\\.$/.exec(\n    lines[0]?.trim() ?? \"\",\n  );\n  if (!titleMatch?.[1]) return null;\n\n  const recurrenceLineIndex = lines.findIndex((line) => {\n    const trimmed = line.trim();\n    return (\n      trimmed === \"This is a one-off scheduled task.\" ||\n      /^This is fire #\\d+ \\(cron: .+\\)\\.$/.test(trimmed) ||\n      /^This is a recurring scheduled task \\(cron: .+\\)\\.$/.test(trimmed)\n    );\n  });\n  if (recurrenceLineIndex < 0) return null;\n\n  const recurrenceLine = lines[recurrenceLineIndex]?.trim() ?? \"\";\n  const countedRecurringMatch = /^This is fire #(\\d+) \\(cron: (.+)\\)\\.$/.exec(\n    recurrenceLine,\n  );\n  const recurringMatch =\n    /^This is a recurring scheduled task \\(cron: (.+)\\)\\.$/.exec(\n      recurrenceLine,\n    );\n  let recurrence: ScheduledTaskRecurrence;\n  if (countedRecurringMatch) {\n    recurrence = {\n      type: \"recurring\",\n      fireNumber: Number.parseInt(countedRecurringMatch[1] ?? \"0\", 10),\n      cron: countedRecurringMatch[2] ?? \"\",\n    };\n  } else if (recurringMatch) {\n    recurrence = { type: \"recurring\", cron: recurringMatch[1] ?? \"\" };\n  } else {\n    recurrence = { type: \"one-off\" };\n  }\n\n  const prompt = getPrompt(text, recurrenceLineIndex);\n  if (!prompt) return null;\n\n  return {\n    name: titleMatch[1],\n    description: getField(lines, \"Description:\"),\n    timezone: getField(lines, \"Timezone:\"),\n    scheduledFor: getField(lines, \"Scheduled for:\"),\n    recurrence,\n    prompt,\n  };\n}\n"
+  ],
+  "mappings": "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",
+  "debugId": "07276DD08883835A64756E2164756E21",
+  "names": []
+}

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

@@ -0,0 +1,35 @@
+export type ScheduledTaskRecurrence = {
+    type: "one-off";
+} | {
+    type: "recurring";
+    cron: string;
+    fireNumber?: number;
+};
+export interface ScheduledTaskPromptInput {
+    name: string;
+    description?: string | null;
+    timezone: string;
+    scheduledFor: Date;
+    currentTime: Date;
+    recurrence: ScheduledTaskRecurrence;
+    prompt: string;
+}
+export interface ScheduledTaskPromptInfo {
+    name: string;
+    description: string | null;
+    timezone: string | null;
+    scheduledFor: string | null;
+    recurrence: ScheduledTaskRecurrence;
+    prompt: string;
+}
+export declare function formatTimezoneQualifiedIso(date: Date, timezone: string): string;
+/**
+ * Build the canonical prompt envelope for a scheduled agent turn.
+ *
+ * Every schedule runner should call this immediately before dispatch while
+ * keeping its stored authored prompt separate from runtime metadata.
+ */
+export declare function formatScheduledTaskPrompt(input: ScheduledTaskPromptInput): string;
+/** Parse canonical and legacy scheduled-task envelopes from persisted messages. */
+export declare function parseScheduledTaskPrompt(rawText: string): ScheduledTaskPromptInfo | null;
+//# sourceMappingURL=scheduled-task-prompt.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"scheduled-task-prompt.d.ts","sourceRoot":"","sources":["../../../src/cron/scheduled-task-prompt.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,uBAAuB,GAC/B;IAAE,IAAI,EAAE,SAAS,CAAA;CAAE,GACnB;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAE7D,MAAM,WAAW,wBAAwB;IACvC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,IAAI,CAAC;IACnB,WAAW,EAAE,IAAI,CAAC;IAClB,UAAU,EAAE,uBAAuB,CAAC;IACpC,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,uBAAuB;IACtC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,UAAU,EAAE,uBAAuB,CAAC;IACpC,MAAM,EAAE,MAAM,CAAC;CAChB;AAwGD,wBAAgB,0BAA0B,CACxC,IAAI,EAAE,IAAI,EACV,QAAQ,EAAE,MAAM,GACf,MAAM,CAkBR;AAYD;;;;;GAKG;AACH,wBAAgB,yBAAyB,CACvC,KAAK,EAAE,wBAAwB,GAC9B,MAAM,CAcR;AAqCD,mFAAmF;AACnF,wBAAgB,wBAAwB,CACtC,OAAO,EAAE,MAAM,GACd,uBAAuB,GAAG,IAAI,CAkDhC"}

package/dist/types/schedules.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Package export: `@letta-ai/letta-code/schedules`
+ *
+ * Pure scheduled-turn envelope contract shared by every scheduler producer and
+ * transcript consumer. This entry must remain free of Node and backend imports.
+ */
+export { formatScheduledTaskPrompt, parseScheduledTaskPrompt, type ScheduledTaskPromptInfo, type ScheduledTaskPromptInput, type ScheduledTaskRecurrence, } from "./cron/scheduled-task-prompt";
+//# sourceMappingURL=schedules.d.ts.map

package/dist/types/schedules.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schedules.d.ts","sourceRoot":"","sources":["../../src/schedules.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EACL,yBAAyB,EACzB,wBAAwB,EACxB,KAAK,uBAAuB,EAC5B,KAAK,wBAAwB,EAC7B,KAAK,uBAAuB,GAC7B,MAAM,8BAA8B,CAAC"}

package/letta.js

@@ -5462,7 +5462,7 @@ var package_default;
 var init_package = __esm(() => {
   package_default = {
     name: "@letta-ai/letta-code",
-    version: "0.30.0",
+    version: "0.30.1",
     description: "Letta Code is a CLI tool for interacting with stateful Letta agents from the terminal.",
     type: "module",
     packageManager: "bun@1.3.0",
@@ -5488,6 +5488,8 @@ var init_package = __esm(() => {
       "dist/mcp-client.js.map",
       "dist/agent-presets.js",
       "dist/agent-presets.js.map",
+      "dist/schedules.js",
+      "dist/schedules.js.map",
       "dist/channels-public.js",
       "dist/channels-public.js.map",
       "dist/channels-slack.js",
@@ -5532,6 +5534,12 @@ var init_package = __esm(() => {
         import: "./dist/agent-presets.js",
         default: "./dist/agent-presets.js"
       },
+      "./schedules": {
+        types: "./dist/types/schedules.d.ts",
+        browser: "./dist/schedules.js",
+        import: "./dist/schedules.js",
+        default: "./dist/schedules.js"
+      },
       "./channels": {
         types: "./dist/types/channels-public.d.ts",
         browser: "./dist/channels-public.js",
@@ -5634,6 +5642,9 @@ var init_package = __esm(() => {
         "agent-presets": [
           "./dist/types/agent-presets.d.ts"
         ],
+        schedules: [
+          "./dist/types/schedules.d.ts"
+        ],
         "app-server-protocol": [
           "./dist/types/types/app-server-protocol.d.ts"
         ],
@@ -437141,7 +437152,7 @@ var init_conversation_runtime = __esm(async () => {
   ]);
 });
 
-// src/cron/prompt.ts
+// src/cron/scheduled-task-prompt.ts
 function pad(value, width) {
   return String(value).padStart(width, "0");
 }
@@ -437223,6 +437234,34 @@ function formatTimezoneQualifiedIso(date6, timezone) {
   const offsetMinutes = Math.round((zonedAsUtcMs - date6.getTime()) / 60000);
   return `${pad(parts.year, 4)}-${pad(parts.month, 2)}-${pad(parts.day, 2)}T${pad(parts.hour, 2)}:${pad(parts.minute, 2)}:${pad(parts.second, 2)}.${pad(millis, 3)}${formatOffset(offsetMinutes)}[${effectiveTimezone ?? "local"}]`;
 }
+function formatRecurrence(recurrence) {
+  if (recurrence.type === "one-off") {
+    return "This is a one-off scheduled task.";
+  }
+  if (recurrence.fireNumber !== undefined) {
+    return `This is fire #${recurrence.fireNumber} (cron: ${recurrence.cron}).`;
+  }
+  return `This is a recurring scheduled task (cron: ${recurrence.cron}).`;
+}
+function formatScheduledTaskPrompt(input) {
+  const lines = [
+    `Scheduled task "${input.name}" is firing.`,
+    ...input.description ? [`Description: ${input.description}`] : [],
+    `Timezone: ${formatTimezoneDisplay(input.timezone)}`,
+    `Scheduled for: ${formatTimezoneQualifiedIso(input.scheduledFor, input.timezone)}`,
+    `Current time: ${formatTimezoneQualifiedIso(input.currentTime, input.timezone)}`,
+    formatRecurrence(input.recurrence),
+    "",
+    AUTONOMOUS_NOTICE,
+    "",
+    `Prompt: ${input.prompt}`
+  ];
+  return lines.join(`
+`);
+}
+var AUTONOMOUS_NOTICE = "You are running autonomously: no user is watching this turn and questions will not be answered. Deliver results through your available channels or record them in memory, and work until the task is done or genuinely blocked.";
+
+// src/cron/prompt.ts
 function getIntendedCronOccurrence(task2, matchedAt) {
   if (!task2.recurring && task2.scheduled_for) {
     const scheduledFor = new Date(task2.scheduled_for);
@@ -437235,22 +437274,21 @@ function getIntendedCronOccurrence(task2, matchedAt) {
   return occurrence;
 }
 function formatCronPrompt(task2, timing) {
-  const timezone = typeof task2.timezone === "string" ? task2.timezone : "";
-  const lines = [
-    `Scheduled task "${task2.name}" is firing.`,
-    `Description: ${task2.description}`,
-    `Timezone: ${formatTimezoneDisplay(timezone)}`,
-    `Scheduled for: ${formatTimezoneQualifiedIso(timing.intendedOccurrence, timezone)}`,
-    `Current time: ${formatTimezoneQualifiedIso(timing.schedulerNow, timezone)}`,
-    task2.recurring ? `This is fire #${task2.fire_count + 1} (cron: ${task2.cron}).` : "This is a one-off scheduled task.",
-    "",
-    "You are running autonomously: no user is watching this turn and questions will not be answered. Deliver results through your available channels or record them in memory, and work until the task is done or genuinely blocked.",
-    "",
-    `Prompt: ${task2.prompt}`
-  ];
-  return lines.join(`
-`);
-}
+  return formatScheduledTaskPrompt({
+    name: task2.name,
+    description: task2.description,
+    timezone: typeof task2.timezone === "string" ? task2.timezone : "",
+    scheduledFor: timing.intendedOccurrence,
+    currentTime: timing.schedulerNow,
+    recurrence: task2.recurring ? {
+      type: "recurring",
+      cron: task2.cron,
+      fireNumber: task2.fire_count + 1
+    } : { type: "one-off" },
+    prompt: task2.prompt
+  });
+}
+var init_prompt = () => {};
 
 // src/cron/scheduler.ts
 function minuteKey(date6) {
@@ -437671,7 +437709,9 @@ var init_scheduler = __esm(async () => {
   init_runtime6();
   init_cron_file();
   init_parse_interval();
+  init_prompt();
   init_run_log();
+  init_prompt();
   await __promiseAll([
     init_conversation_runtime(),
     init_protocol_outbound(),
@@ -488523,7 +488563,7 @@ var init_mcp_client = __esm(() => {
   init_streamableHttp();
   DEFAULT_CLIENT_INFO = {
     name: "letta-code",
-    version: "0.30.0"
+    version: "0.30.1"
   };
 });
 
@@ -555546,4 +555586,4 @@ function registerBunOAuthFlows() {
 registerBunOAuthFlows();
 await init_src5().then(() => exports_src2);
 
-//# debugId=B9D60EB55EA6EE2C64756E2164756E21
+//# debugId=176DD519C90983F764756E2164756E21

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@letta-ai/letta-code",
-  "version": "0.30.0",
+  "version": "0.30.1",
   "description": "Letta Code is a CLI tool for interacting with stateful Letta agents from the terminal.",
   "type": "module",
   "packageManager": "bun@1.3.0",
@@ -26,6 +26,8 @@
     "dist/mcp-client.js.map",
     "dist/agent-presets.js",
     "dist/agent-presets.js.map",
+    "dist/schedules.js",
+    "dist/schedules.js.map",
     "dist/channels-public.js",
     "dist/channels-public.js.map",
     "dist/channels-slack.js",
@@ -70,6 +72,12 @@
       "import": "./dist/agent-presets.js",
       "default": "./dist/agent-presets.js"
     },
+    "./schedules": {
+      "types": "./dist/types/schedules.d.ts",
+      "browser": "./dist/schedules.js",
+      "import": "./dist/schedules.js",
+      "default": "./dist/schedules.js"
+    },
     "./channels": {
       "types": "./dist/types/channels-public.d.ts",
       "browser": "./dist/channels-public.js",
@@ -172,6 +180,9 @@
       "agent-presets": [
         "./dist/types/agent-presets.d.ts"
       ],
+      "schedules": [
+        "./dist/types/schedules.d.ts"
+      ],
       "app-server-protocol": [
         "./dist/types/types/app-server-protocol.d.ts"
       ],