@letta-ai/letta-code 0.30.0 → 0.30.2

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.2",
     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"
         ],
@@ -5785,11 +5796,14 @@ function getNodeRoutingHeader() {
   const enabled = NODE_HEADER_ENABLED_VALUES.has(raw.trim().toLowerCase());
   return { "x-letta-node": enabled ? "1" : "0" };
 }
+function getRuntimeEnvironmentDeviceId() {
+  return process.env[RUNTIME_ENVIRONMENT_DEVICE_ID_ENV]?.trim() || settingsManager.getOrCreateDeviceId();
+}
 function getClientDefaultHeaders() {
   return {
     "X-Letta-Source": "letta-code",
     "User-Agent": `letta-code/${package_default.version}`,
-    "X-Letta-Environment-Device-Id": settingsManager.getOrCreateDeviceId(),
+    "X-Letta-Environment-Device-Id": getRuntimeEnvironmentDeviceId(),
     ...getNodeRoutingHeader(),
     ...process.env.LETTA_MEMFS_BACKEND === "hosted" ? { "x-letta-memfs-backend": "hosted" } : {}
   };
@@ -5883,7 +5897,7 @@ If you experience this issue multiple times, move ~/.letta to ~/.letta_backup, a
   };
   return client;
 }
-var SDK_DIAGNOSTIC_MAX_LEN = 400, SDK_DIAGNOSTIC_MAX_LINES = 4, lastSDKDiagnostic = null, _cachedApiKey, _testClientOverride = null, sdkLogger, NODE_HEADER_ENABLED_VALUES;
+var SDK_DIAGNOSTIC_MAX_LEN = 400, SDK_DIAGNOSTIC_MAX_LINES = 4, lastSDKDiagnostic = null, _cachedApiKey, _testClientOverride = null, sdkLogger, NODE_HEADER_ENABLED_VALUES, RUNTIME_ENVIRONMENT_DEVICE_ID_ENV = "LETTA_RUNTIME_ENVIRONMENT_DEVICE_ID";
 var init_client2 = __esm(() => {
   init_letta_client();
   init_oauth();
@@ -437141,7 +437155,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 +437237,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 +437277,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 +437712,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(),
@@ -437778,6 +437821,57 @@ function buildCloudScheduleInput(params) {
 }
 var CLOUD_EXECUTION_TARGET = "cloud-sandbox", SYNTHETIC_CLOUD_DEVICE_ID = "__letta_cloud__", SYNTHETIC_LOCAL_PLACEHOLDER_ID = "local", CLOUD_CRON_UTC_NOTE = "Recurring Cloud schedules currently interpret cron expressions in UTC (timezone support is tracked in LET-9815).", CLOUD_DEVICE_FALLBACK_NOTE = "If the target computer is offline when the schedule fires, execution falls back to the agent's cloud sandbox.";
 
+// src/cli/subcommands/cron-task-ref.ts
+async function ensureSettingsForCloud() {
+  const { settingsManager: settingsManager2 } = await Promise.resolve().then(() => (init_settings_manager(), exports_settings_manager));
+  await settingsManager2.initialize();
+}
+async function resolveTaskName(name, options3) {
+  const matches2 = [];
+  if (options3.runner !== "cloud") {
+    for (const task2 of listTasks2()) {
+      if (task2.name === name) {
+        matches2.push({ id: task2.id, store: "local" });
+      }
+    }
+  }
+  if (options3.runner !== "local" && options3.agentId) {
+    const backendMode = resolveBackendMode();
+    const preliminary = resolveCronRunner({
+      agentId: options3.agentId,
+      backendMode
+    });
+    const cloudCandidate = !("error" in preliminary) && preliminary.runner === "cloud";
+    if (cloudCandidate || options3.runner === "cloud") {
+      try {
+        await ensureSettingsForCloud();
+        const response = await listCloudSchedules(options3.agentId);
+        for (const schedule of response.scheduled_messages) {
+          if (schedule.name === name) {
+            matches2.push({ id: schedule.id, store: "cloud" });
+          }
+        }
+      } catch {}
+    }
+  }
+  if (matches2.length === 0)
+    return null;
+  if (matches2.length === 1)
+    return matches2[0] ?? null;
+  return { ambiguous: matches2 };
+}
+function printAmbiguousTaskName(name, matches2) {
+  console.error(`Error: multiple tasks are named "${name}". Use an ID instead:`);
+  for (const match4 of matches2) {
+    console.error(`  ${match4.id} (${match4.store})`);
+  }
+}
+var init_cron_task_ref = __esm(async () => {
+  init_schedules2();
+  init_backend_mode();
+  await init_cron();
+});
+
 // src/backend/api/environments.ts
 var exports_environments2 = {};
 __export(exports_environments2, {
@@ -437881,9 +437975,9 @@ Usage:
   letta cron add --prompt <text> --at <time> [--once] [options]
   letta cron add --prompt <text> --cron <expr> [options]
   letta cron list [options]
-  letta cron get <id> [--runner local|cloud]
+  letta cron get <id|name> [--runner local|cloud]
   letta cron runs --id <id> [--limit <n>] [--runner local|cloud]
-  letta cron delete <id> [--runner local|cloud]
+  letta cron delete <id|name> [--runner local|cloud]   (alias: remove)
   letta cron delete --all [--agent <id>] [--runner local|cloud]
 
 Add options:
@@ -437943,10 +438037,6 @@ async function probeCloudScheduleSupport(agentId) {
     return true;
   }
 }
-async function ensureSettingsForCloud() {
-  const { settingsManager: settingsManager2 } = await Promise.resolve().then(() => (init_settings_manager(), exports_settings_manager));
-  await settingsManager2.initialize();
-}
 async function getRunnerForAgent(explicit, agentId) {
   const backendMode = resolveBackendMode();
   const preliminary = resolveCronRunner({ explicit, agentId, backendMode });
@@ -438212,11 +438302,13 @@ async function handleList(values2) {
     }
   }
   if (includeCloud && agentId) {
-    const resolved = await getRunnerForAgent(undefined, agentId);
-    const cloudCapable = !("error" in resolved) && resolved.runner === "cloud";
     const cloudExplicit = values2.runner === "cloud";
-    if (cloudCapable || cloudExplicit) {
+    const backendMode = resolveBackendMode();
+    const preliminary = resolveCronRunner({ agentId, backendMode });
+    const cloudCandidate = !("error" in preliminary) && preliminary.runner === "cloud";
+    if (cloudCandidate || cloudExplicit) {
       try {
+        await ensureSettingsForCloud();
         const response = await listCloudSchedules(agentId);
         for (const schedule of response.scheduled_messages) {
           if (conversationId && (schedule.conversation_id ?? "default") !== conversationId) {
@@ -438225,7 +438317,11 @@ async function handleList(values2) {
           output.push(formatCloudScheduleOutput(schedule));
         }
       } catch (err) {
-        console.error(`Warning: failed to list Cloud schedules: ${err instanceof Error ? err.message : String(err)}`);
+        if (err instanceof ApiRequestError && (err.status === 404 || err.status === 405)) {
+          console.error("Note: Cloud schedules not listed (server does not serve the schedule routes, or this agent is not visible to the current credential).");
+        } else {
+          console.error(`Warning: Cloud schedules not listed: ${err instanceof Error ? err.message : String(err)}`);
+        }
         if (cloudExplicit) {
           return 1;
         }
@@ -438243,40 +438339,60 @@ async function handleGet(values2, positionals) {
     console.error(`Error: invalid --runner "${values2.runner}". Expected "local" or "cloud".`);
     return 1;
   }
-  const taskId = positionals[1];
-  if (!taskId) {
-    console.error("Error: task ID required. Usage: letta cron get <id>");
+  const taskRef = positionals[1];
+  if (!taskRef) {
+    console.error("Error: task ID or name required. Usage: letta cron get <id|name>");
     return 1;
   }
+  const agentId = getAgentId3(values2.agent);
   if (values2.runner !== "cloud") {
-    const task2 = getTask2(taskId);
+    const task2 = getTask2(taskRef);
     if (task2) {
       console.log(JSON.stringify({ ...task2, runner: "local" }, null, 2));
       return 0;
     }
-    if (values2.runner === "local") {
-      console.error(`Error: task ${taskId} not found.`);
-      return 1;
+  }
+  if (values2.runner !== "local" && agentId) {
+    try {
+      await ensureSettingsForCloud();
+      const schedule = await getCloudSchedule(agentId, taskRef);
+      console.log(JSON.stringify(formatCloudScheduleOutput(schedule), null, 2));
+      return 0;
+    } catch (err) {
+      if (!(err instanceof ApiRequestError && err.status === 404)) {
+        console.error(`Error: ${err instanceof Error ? err.message : String(err)}`);
+        return 1;
+      }
     }
   }
-  const agentId = getAgentId3(values2.agent);
-  if (!agentId) {
-    console.error(`Error: task ${taskId} not found locally, and --agent or LETTA_AGENT_ID is required to look up Cloud schedules.`);
+  if (values2.runner !== "local" && !agentId) {
+    console.error(`Error: task ${taskRef} not found locally, and --agent or LETTA_AGENT_ID is required to look up Cloud schedules.`);
     return 1;
   }
-  try {
-    await ensureSettingsForCloud();
-    const schedule = await getCloudSchedule(agentId, taskId);
-    console.log(JSON.stringify(formatCloudScheduleOutput(schedule), null, 2));
-    return 0;
-  } catch (err) {
-    if (err instanceof ApiRequestError && err.status === 404) {
-      console.error(`Error: task ${taskId} not found.`);
-    } else {
-      console.error(`Error: ${err instanceof Error ? err.message : String(err)}`);
-    }
+  const resolved = await resolveTaskName(taskRef, {
+    runner: values2.runner,
+    agentId
+  });
+  if (resolved && "ambiguous" in resolved) {
+    printAmbiguousTaskName(taskRef, resolved.ambiguous);
     return 1;
   }
+  if (resolved?.store === "local") {
+    const task2 = getTask2(resolved.id);
+    if (task2) {
+      console.log(JSON.stringify({ ...task2, runner: "local" }, null, 2));
+      return 0;
+    }
+  }
+  if (resolved?.store === "cloud" && agentId) {
+    try {
+      const schedule = await getCloudSchedule(agentId, resolved.id);
+      console.log(JSON.stringify(formatCloudScheduleOutput(schedule), null, 2));
+      return 0;
+    } catch {}
+  }
+  console.error(`Error: task ${taskRef} not found.`);
+  return 1;
 }
 async function handleRuns(values2) {
   if (!isRunnerFlagValid(values2.runner)) {
@@ -438337,41 +438453,65 @@ async function handleDelete(values2, positionals) {
   if (values2.all) {
     return handleDeleteAll(values2);
   }
-  const taskId = positionals[1];
-  if (!taskId) {
-    console.error("Error: task ID required. Usage: letta cron delete <id> or --all --agent <id>");
+  const taskRef = positionals[1];
+  if (!taskRef) {
+    console.error("Error: task ID or name required. Usage: letta cron delete <id|name> or --all --agent <id>");
     return 1;
   }
   if (values2.runner !== "cloud") {
-    const found = deleteTask(taskId);
+    const found = deleteTask(taskRef);
     if (found) {
-      console.log(JSON.stringify({ deleted: taskId, runner: "local" }));
+      console.log(JSON.stringify({ deleted: taskRef, runner: "local" }));
       return 0;
     }
-    if (values2.runner === "local") {
-      console.error(`Error: task ${taskId} not found.`);
+  }
+  const agentId = getAgentId3(values2.agent);
+  if (values2.runner !== "local") {
+    if (!agentId) {
+      console.error(`Error: task ${taskRef} not found locally, and --agent or LETTA_AGENT_ID is required to delete Cloud schedules.`);
       return 1;
     }
+    try {
+      await ensureSettingsForCloud();
+      await getCloudSchedule(agentId, taskRef);
+      await deleteCloudSchedule(agentId, taskRef);
+      console.log(JSON.stringify({ deleted: taskRef, runner: "cloud" }));
+      return 0;
+    } catch (err) {
+      if (!(err instanceof ApiRequestError && err.status === 404)) {
+        console.error(`Error: ${err instanceof Error ? err.message : String(err)}`);
+        return 1;
+      }
+    }
   }
-  const agentId = getAgentId3(values2.agent);
-  if (!agentId) {
-    console.error(`Error: task ${taskId} not found locally, and --agent or LETTA_AGENT_ID is required to delete Cloud schedules.`);
+  const resolved = await resolveTaskName(taskRef, {
+    runner: values2.runner,
+    agentId
+  });
+  if (resolved && "ambiguous" in resolved) {
+    printAmbiguousTaskName(taskRef, resolved.ambiguous);
     return 1;
   }
-  try {
-    await ensureSettingsForCloud();
-    await getCloudSchedule(agentId, taskId);
-    await deleteCloudSchedule(agentId, taskId);
-    console.log(JSON.stringify({ deleted: taskId, runner: "cloud" }));
+  if (resolved?.store === "local" && deleteTask(resolved.id)) {
+    console.log(JSON.stringify({ deleted: resolved.id, name: taskRef, runner: "local" }));
     return 0;
-  } catch (err) {
-    if (err instanceof ApiRequestError && err.status === 404) {
-      console.error(`Error: task ${taskId} not found.`);
-    } else {
+  }
+  if (resolved?.store === "cloud" && agentId) {
+    try {
+      await deleteCloudSchedule(agentId, resolved.id);
+      console.log(JSON.stringify({
+        deleted: resolved.id,
+        name: taskRef,
+        runner: "cloud"
+      }));
+      return 0;
+    } catch (err) {
       console.error(`Error: ${err instanceof Error ? err.message : String(err)}`);
+      return 1;
     }
-    return 1;
   }
+  console.error(`Error: task ${taskRef} not found.`);
+  return 1;
 }
 async function handleDeleteAll(values2) {
   const agentId = getAgentId3(values2.agent);
@@ -438436,6 +438576,7 @@ async function runCronSubcommand(argv) {
     case "runs":
       return handleRuns(parsed.values);
     case "delete":
+    case "remove":
       return handleDelete(parsed.values, parsed.positionals);
     default:
       console.error(`Unknown action: ${action3}`);
@@ -438448,7 +438589,10 @@ var init_cron2 = __esm(async () => {
   init_request();
   init_schedules2();
   init_backend_mode();
-  await init_cron();
+  await __promiseAll([
+    init_cron(),
+    init_cron_task_ref()
+  ]);
   CRON_OPTIONS = {
     help: { type: "boolean", short: "h" },
     name: { type: "string" },
@@ -488523,7 +488667,7 @@ var init_mcp_client = __esm(() => {
   init_streamableHttp();
   DEFAULT_CLIENT_INFO = {
     name: "letta-code",
-    version: "0.30.0"
+    version: "0.30.2"
   };
 });
 
@@ -555546,4 +555690,4 @@ function registerBunOAuthFlows() {
 registerBunOAuthFlows();
 await init_src5().then(() => exports_src2);
 
-//# debugId=B9D60EB55EA6EE2C64756E2164756E21
+//# debugId=F9C406BD13E4AE1D64756E2164756E21

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@letta-ai/letta-code",
-  "version": "0.30.0",
+  "version": "0.30.2",
   "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"
       ],