@letta-ai/letta-code 0.30.1 → 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.1",
+    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",
@@ -5796,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" } : {}
   };
@@ -5894,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();
@@ -437818,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, {
@@ -437921,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:
@@ -437983,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 });
@@ -438252,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) {
@@ -438265,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;
         }
@@ -438283,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)) {
@@ -438377,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);
@@ -438476,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}`);
@@ -438488,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" },
@@ -488563,7 +488667,7 @@ var init_mcp_client = __esm(() => {
   init_streamableHttp();
   DEFAULT_CLIENT_INFO = {
     name: "letta-code",
-    version: "0.30.1"
+    version: "0.30.2"
   };
 });
 
@@ -555586,4 +555690,4 @@ function registerBunOAuthFlows() {
 registerBunOAuthFlows();
 await init_src5().then(() => exports_src2);
 
-//# debugId=176DD519C90983F764756E2164756E21
+//# debugId=F9C406BD13E4AE1D64756E2164756E21

package/package.json

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