openhome-cli 0.1.17 → 0.1.20

package/dist/cli.js

@@ -49,6 +49,12 @@ var ApiError = class extends Error {
     this.name = "ApiError";
   }
 };
+var SessionExpiredError = class extends Error {
+  constructor() {
+    super("Session token expired or invalid");
+    this.name = "SessionExpiredError";
+  }
+};
 var ApiClient = class {
   constructor(apiKey, baseUrl, jwt) {
     this.apiKey = apiKey;
@@ -82,6 +88,9 @@ var ApiClient = class {
         throw new NotImplementedError(path);
       }
       const message = body?.detail ?? body?.error?.message ?? response.statusText;
+      if (useJwt && (response.status === 401 || message.toLowerCase().includes("token not valid") || message.toLowerCase().includes("token is invalid") || message.toLowerCase().includes("not valid for any token"))) {
+        throw new SessionExpiredError();
+      }
       throw new ApiError(String(response.status), message);
     }
     return response.json();
@@ -101,9 +110,7 @@ var ApiClient = class {
     const form = new FormData();
     form.append(
       "zip_file",
-      new Blob([zipBuffer], {
-        type: "application/zip"
-      }),
+      new Blob([new Uint8Array(zipBuffer)], { type: "application/zip" }),
       "ability.zip"
     );
     if (imageBuffer && imageName) {
@@ -111,7 +118,7 @@ var ApiClient = class {
       const imageMime = imageExt === "jpg" || imageExt === "jpeg" ? "image/jpeg" : "image/png";
       form.append(
         "image_file",
-        new Blob([imageBuffer], { type: imageMime }),
+        new Blob([new Uint8Array(imageBuffer)], { type: imageMime }),
         imageName
       );
     }
@@ -684,6 +691,25 @@ async function createAbilityZip(dirPath) {
   });
 }
 
+// src/commands/handle-session-expired.ts
+import chalk3 from "chalk";
+async function handleIfSessionExpired(err) {
+  if (!(err instanceof SessionExpiredError)) return false;
+  console.log("");
+  p.note(
+    [
+      "Your session token has expired or been invalidated.",
+      "This happens when you log into the OpenHome website again.",
+      "",
+      `You need to grab a fresh token \u2014 it only takes 30 seconds.`
+    ].join("\n"),
+    chalk3.yellow("Session expired")
+  );
+  await setupJwt();
+  p.note("Token updated. Run the command again to continue.", "Ready");
+  return true;
+}
+
 // src/api/mock-client.ts
 var MOCK_PERSONALITIES = [
   { id: "pers_alice", name: "Alice", description: "Friendly assistant" },
@@ -791,6 +817,12 @@ var MockApiClient = class {
 };
 
 // src/commands/deploy.ts
+function expandPath(p2) {
+  if (p2.startsWith("~/") || p2 === "~") {
+    return join2(homedir(), p2.slice(2));
+  }
+  return resolve(p2);
+}
 var IMAGE_EXTENSIONS = ["png", "jpg", "jpeg"];
 var ICON_NAMES = IMAGE_EXTENSIONS.flatMap((ext) => [
   `icon.${ext}`,
@@ -854,7 +886,7 @@ async function resolveAbilityDir(pathArg) {
     }
   });
   handleCancel(pathInput);
-  return resolve(pathInput.trim());
+  return expandPath(pathInput.trim());
 }
 async function deployCommand(pathArg, opts = {}) {
   p.intro("\u{1F680} Upload Ability");
@@ -934,13 +966,13 @@ async function deployCommand(pathArg, opts = {}) {
             placeholder: "~/path/to/ability.zip",
             validate: (val) => {
               if (!val || !val.trim()) return "Path is required";
-              if (!existsSync2(resolve(val.trim())))
+              if (!existsSync2(expandPath(val.trim())))
                 return `File not found: ${val.trim()}`;
               if (!val.trim().endsWith(".zip")) return "Must be a .zip file";
             }
           });
           handleCancel(zipInput);
-          zipPath = resolve(zipInput.trim());
+          zipPath = expandPath(zipInput.trim());
         } else {
           zipPath = selected;
         }
@@ -950,13 +982,13 @@ async function deployCommand(pathArg, opts = {}) {
           placeholder: "~/Downloads/my-ability.zip",
           validate: (val) => {
             if (!val || !val.trim()) return "Path is required";
-            if (!existsSync2(resolve(val.trim())))
+            if (!existsSync2(expandPath(val.trim())))
               return `File not found: ${val.trim()}`;
             if (!val.trim().endsWith(".zip")) return "Must be a .zip file";
           }
         });
         handleCancel(zipInput);
-        zipPath = resolve(zipInput.trim());
+        zipPath = expandPath(zipInput.trim());
       }
       await deployZip(zipPath, opts);
       return;
@@ -1079,7 +1111,7 @@ async function deployCommand(pathArg, opts = {}) {
           placeholder: "./icon.png",
           validate: (val) => {
             if (!val || !val.trim()) return void 0;
-            const resolved = resolve(val.trim());
+            const resolved = expandPath(val.trim());
             if (!existsSync2(resolved)) return `File not found: ${val.trim()}`;
             if (!IMAGE_EXTS.has(extname(resolved).toLowerCase()))
               return "Image must be PNG or JPG";
@@ -1087,7 +1119,7 @@ async function deployCommand(pathArg, opts = {}) {
         });
         handleCancel(imgInput);
         const trimmed = imgInput.trim();
-        if (trimmed) imagePath = resolve(trimmed);
+        if (trimmed) imagePath = expandPath(trimmed);
       } else if (selected !== "__skip__") {
         imagePath = selected;
       }
@@ -1097,7 +1129,7 @@ async function deployCommand(pathArg, opts = {}) {
         placeholder: "./icon.png",
         validate: (val) => {
           if (!val || !val.trim()) return void 0;
-          const resolved = resolve(val.trim());
+          const resolved = expandPath(val.trim());
           if (!existsSync2(resolved)) return `File not found: ${val.trim()}`;
           if (!IMAGE_EXTS.has(extname(resolved).toLowerCase()))
             return "Image must be PNG or JPG";
@@ -1105,7 +1137,7 @@ async function deployCommand(pathArg, opts = {}) {
       });
       handleCancel(imgInput);
       const trimmed = imgInput.trim();
-      if (trimmed) imagePath = resolve(trimmed);
+      if (trimmed) imagePath = expandPath(trimmed);
     }
   }
   const imageBuffer = imagePath ? readFileSync2(imagePath) : null;
@@ -1219,6 +1251,7 @@ async function deployCommand(pathArg, opts = {}) {
       p.outro("Zip ready for manual upload.");
       return;
     }
+    if (await handleIfSessionExpired(err)) return;
     const msg = err instanceof Error ? err.message : String(err);
     if (msg.toLowerCase().includes("same name")) {
       error(`An ability named "${uniqueName}" already exists.`);
@@ -1341,6 +1374,7 @@ async function deployZip(zipPath, opts = {}) {
     p.outro("Deployed successfully! \u{1F389}");
   } catch (err) {
     s.stop("Upload failed.");
+    if (await handleIfSessionExpired(err)) return;
     error(`Deploy failed: ${err instanceof Error ? err.message : String(err)}`);
     process.exit(1);
   }
@@ -2139,7 +2173,7 @@ async function initCommand(nameArg) {
 }
 
 // src/commands/delete.ts
-import chalk3 from "chalk";
+import chalk4 from "chalk";
 async function deleteCommand(abilityArg, opts = {}) {
   p.intro("\u{1F5D1}\uFE0F  Delete ability");
   let client;
@@ -2194,7 +2228,7 @@ async function deleteCommand(abilityArg, opts = {}) {
       options: abilities.map((a) => ({
         value: a.ability_id,
         label: a.unique_name,
-        hint: `${chalk3.gray(a.status)}  v${a.version}`
+        hint: `${chalk4.gray(a.status)}  v${a.version}`
       }))
     });
     handleCancel(selected);
@@ -2222,13 +2256,14 @@ async function deleteCommand(abilityArg, opts = {}) {
       p.note("API Not Available Yet", "Delete endpoint not yet implemented.");
       return;
     }
+    if (await handleIfSessionExpired(err)) return;
     error(`Delete failed: ${err instanceof Error ? err.message : String(err)}`);
     process.exit(1);
   }
 }
 
 // src/commands/toggle.ts
-import chalk4 from "chalk";
+import chalk5 from "chalk";
 async function toggleCommand(abilityArg, opts = {}) {
   p.intro("\u26A1 Enable / Disable ability");
   let client;
@@ -2283,7 +2318,7 @@ async function toggleCommand(abilityArg, opts = {}) {
       options: abilities.map((a) => ({
         value: a.ability_id,
         label: a.unique_name,
-        hint: `${a.status === "disabled" ? chalk4.gray("disabled") : chalk4.green("enabled")}  v${a.version}`
+        hint: `${a.status === "disabled" ? chalk5.gray("disabled") : chalk5.green("enabled")}  v${a.version}`
       }))
     });
     handleCancel(selected);
@@ -2321,13 +2356,14 @@ async function toggleCommand(abilityArg, opts = {}) {
       p.note("Toggle endpoint not yet implemented.", "API Not Available Yet");
       return;
     }
+    if (await handleIfSessionExpired(err)) return;
     error(`Toggle failed: ${err instanceof Error ? err.message : String(err)}`);
     process.exit(1);
   }
 }
 
 // src/commands/assign.ts
-import chalk5 from "chalk";
+import chalk6 from "chalk";
 async function assignCommand(opts = {}) {
   p.intro("\u{1F517} Assign abilities to agent");
   let client;
@@ -2378,7 +2414,7 @@ async function assignCommand(opts = {}) {
     options: personalities.map((pers) => ({
       value: pers.id,
       label: pers.name,
-      hint: chalk5.gray(pers.id)
+      hint: chalk6.gray(pers.id)
     }))
   });
   handleCancel(agentId);
@@ -2416,23 +2452,24 @@ async function assignCommand(opts = {}) {
       p.note("Assign endpoint not yet implemented.", "API Not Available Yet");
       return;
     }
+    if (await handleIfSessionExpired(err)) return;
     error(`Assign failed: ${err instanceof Error ? err.message : String(err)}`);
     process.exit(1);
   }
 }
 
 // src/commands/list.ts
-import chalk6 from "chalk";
+import chalk7 from "chalk";
 function statusColor(status) {
   switch (status) {
     case "active":
-      return chalk6.green(status);
+      return chalk7.green(status);
     case "processing":
-      return chalk6.yellow(status);
+      return chalk7.yellow(status);
     case "failed":
-      return chalk6.red(status);
+      return chalk7.red(status);
     case "disabled":
-      return chalk6.gray(status);
+      return chalk7.gray(status);
     default:
       return status;
   }
@@ -2484,6 +2521,7 @@ async function listCommand(opts = {}) {
       p.outro("List endpoint not yet implemented.");
       return;
     }
+    if (await handleIfSessionExpired(err)) return;
     error(
       `Failed to list abilities: ${err instanceof Error ? err.message : String(err)}`
     );
@@ -2495,19 +2533,19 @@ async function listCommand(opts = {}) {
 import { join as join4, resolve as resolve3 } from "path";
 import { existsSync as existsSync4, readFileSync as readFileSync3 } from "fs";
 import { homedir as homedir3 } from "os";
-import chalk7 from "chalk";
+import chalk8 from "chalk";
 function statusBadge(status) {
   switch (status) {
     case "active":
-      return chalk7.bgGreen.black(` ${status.toUpperCase()} `);
+      return chalk8.bgGreen.black(` ${status.toUpperCase()} `);
     case "processing":
-      return chalk7.bgYellow.black(` ${status.toUpperCase()} `);
+      return chalk8.bgYellow.black(` ${status.toUpperCase()} `);
     case "failed":
-      return chalk7.bgRed.white(` ${status.toUpperCase()} `);
+      return chalk8.bgRed.white(` ${status.toUpperCase()} `);
     case "disabled":
-      return chalk7.bgGray.white(` ${status.toUpperCase()} `);
+      return chalk8.bgGray.white(` ${status.toUpperCase()} `);
     default:
-      return chalk7.bgWhite.black(` ${status.toUpperCase()} `);
+      return chalk8.bgWhite.black(` ${status.toUpperCase()} `);
   }
 }
 function readAbilityName(dir) {
@@ -2596,14 +2634,14 @@ async function statusCommand(abilityArg, opts = {}) {
     );
     if (ability.validation_errors.length > 0) {
       p.note(
-        ability.validation_errors.map((e) => chalk7.red(`\u2717 ${e}`)).join("\n"),
+        ability.validation_errors.map((e) => chalk8.red(`\u2717 ${e}`)).join("\n"),
         "Validation Errors"
       );
     }
     if (ability.deploy_history.length > 0) {
       const historyLines = ability.deploy_history.map((event) => {
-        const icon = event.status === "success" ? chalk7.green("\u2713") : chalk7.red("\u2717");
-        return `${icon}  v${event.version}  ${event.message}  ${chalk7.gray(new Date(event.timestamp).toLocaleString())}`;
+        const icon = event.status === "success" ? chalk8.green("\u2713") : chalk8.red("\u2717");
+        return `${icon}  v${event.version}  ${event.message}  ${chalk8.gray(new Date(event.timestamp).toLocaleString())}`;
       });
       p.note(historyLines.join("\n"), "Deploy History");
     }
@@ -2623,7 +2661,7 @@ async function statusCommand(abilityArg, opts = {}) {
 }
 
 // src/commands/agents.ts
-import chalk8 from "chalk";
+import chalk9 from "chalk";
 async function agentsCommand(opts = {}) {
   p.intro("\u{1F916} Your Agents");
   let client;
@@ -2648,7 +2686,7 @@ async function agentsCommand(opts = {}) {
       return;
     }
     p.note(
-      personalities.map((pers) => `${chalk8.bold(pers.name)}  ${chalk8.gray(pers.id)}`).join("\n"),
+      personalities.map((pers) => `${chalk9.bold(pers.name)}  ${chalk9.gray(pers.id)}`).join("\n"),
       "Agents"
     );
     const config = getConfig();
@@ -2702,7 +2740,7 @@ async function logoutCommand() {
 
 // src/commands/chat.ts
 import WebSocket from "ws";
-import chalk9 from "chalk";
+import chalk10 from "chalk";
 import * as readline from "readline";
 var PING_INTERVAL = 3e4;
 async function chatCommand(agentArg, opts = {}) {
@@ -2743,7 +2781,7 @@ async function chatCommand(agentArg, opts = {}) {
     }
   }
   const wsUrl = `${WS_BASE}${ENDPOINTS.voiceStream(apiKey, agentId)}`;
-  info(`Connecting to agent ${chalk9.bold(agentId)}...`);
+  info(`Connecting to agent ${chalk10.bold(agentId)}...`);
   await new Promise((resolve6) => {
     const ws = new WebSocket(wsUrl, {
       perMessageDeflate: false,
@@ -2759,7 +2797,7 @@ async function chatCommand(agentArg, opts = {}) {
       output: process.stdout
     });
     function promptUser() {
-      rl.question(chalk9.green("You: "), (input) => {
+      rl.question(chalk10.green("You: "), (input) => {
         const trimmed = input.trim();
         if (!trimmed) {
           promptUser();
@@ -2795,7 +2833,7 @@ async function chatCommand(agentArg, opts = {}) {
       }, PING_INTERVAL);
       success("Connected! Type a message and press Enter. Type /quit to exit.");
       console.log(
-        chalk9.gray(
+        chalk10.gray(
           "  Tip: Send trigger words to activate abilities (e.g. 'play aquaprime')"
         )
       );
@@ -2810,7 +2848,7 @@ async function chatCommand(agentArg, opts = {}) {
             const data = msg.data;
             if (data.content && data.role === "assistant") {
               if (data.live && !data.final) {
-                const prefix = `${chalk9.cyan("Agent:")} `;
+                const prefix = `${chalk10.cyan("Agent:")} `;
                 readline.clearLine(process.stdout, 0);
                 readline.cursorTo(process.stdout, 0);
                 process.stdout.write(`${prefix}${data.content}`);
@@ -2819,7 +2857,7 @@ async function chatCommand(agentArg, opts = {}) {
                 if (currentResponse !== "") {
                   console.log("");
                 } else {
-                  console.log(`${chalk9.cyan("Agent:")} ${data.content}`);
+                  console.log(`${chalk10.cyan("Agent:")} ${data.content}`);
                 }
                 currentResponse = "";
                 console.log("");
@@ -2835,7 +2873,7 @@ async function chatCommand(agentArg, opts = {}) {
               ws.send(JSON.stringify({ type: "text", data: "bot-speak-end" }));
               if (currentResponse === "") {
                 console.log(
-                  chalk9.gray("  (Agent sent audio \u2014 text-only mode)")
+                  chalk10.gray("  (Agent sent audio \u2014 text-only mode)")
                 );
                 console.log("");
               }
@@ -2895,7 +2933,7 @@ async function chatCommand(agentArg, opts = {}) {
 
 // src/commands/trigger.ts
 import WebSocket2 from "ws";
-import chalk10 from "chalk";
+import chalk11 from "chalk";
 var PING_INTERVAL2 = 3e4;
 var RESPONSE_TIMEOUT = 3e4;
 async function triggerCommand(phraseArg, opts = {}) {
@@ -2947,7 +2985,7 @@ async function triggerCommand(phraseArg, opts = {}) {
     }
   }
   const wsUrl = `${WS_BASE}${ENDPOINTS.voiceStream(apiKey, agentId)}`;
-  info(`Sending "${chalk10.bold(phrase)}" to agent ${chalk10.bold(agentId)}...`);
+  info(`Sending "${chalk11.bold(phrase)}" to agent ${chalk11.bold(agentId)}...`);
   const s = p.spinner();
   s.start("Waiting for response...");
   await new Promise((resolve6) => {
@@ -2977,7 +3015,7 @@ async function triggerCommand(phraseArg, opts = {}) {
         s.stop("Timed out waiting for response.");
         if (fullResponse) {
           console.log(`
-${chalk10.cyan("Agent:")} ${fullResponse}`);
+${chalk11.cyan("Agent:")} ${fullResponse}`);
         }
         cleanup();
         resolve6();
@@ -2994,7 +3032,7 @@ ${chalk10.cyan("Agent:")} ${fullResponse}`);
               if (!data.live || data.final) {
                 s.stop("Response received.");
                 console.log(`
-${chalk10.cyan("Agent:")} ${fullResponse}
+${chalk11.cyan("Agent:")} ${fullResponse}
 `);
                 cleanup();
                 resolve6();
@@ -3011,7 +3049,7 @@ ${chalk10.cyan("Agent:")} ${fullResponse}
               if (fullResponse) {
                 s.stop("Response received.");
                 console.log(`
-${chalk10.cyan("Agent:")} ${fullResponse}
+${chalk11.cyan("Agent:")} ${fullResponse}
 `);
                 cleanup();
                 resolve6();
@@ -3050,7 +3088,7 @@ ${chalk10.cyan("Agent:")} ${fullResponse}
 }
 
 // src/commands/whoami.ts
-import chalk11 from "chalk";
+import chalk12 from "chalk";
 import { homedir as homedir4 } from "os";
 async function whoamiCommand() {
   p.intro("\u{1F464} OpenHome CLI Status");
@@ -3060,17 +3098,17 @@ async function whoamiCommand() {
   const home = homedir4();
   if (apiKey) {
     const masked = apiKey.slice(0, 6) + "..." + apiKey.slice(-4);
-    info(`Authenticated: ${chalk11.green("yes")}  (key: ${chalk11.gray(masked)})`);
+    info(`Authenticated: ${chalk12.green("yes")}  (key: ${chalk12.gray(masked)})`);
   } else {
     info(
-      `Authenticated: ${chalk11.red("no")}  \u2014 run ${chalk11.bold("openhome login")}`
+      `Authenticated: ${chalk12.red("no")}  \u2014 run ${chalk12.bold("openhome login")}`
     );
   }
   if (config.default_personality_id) {
-    info(`Default agent: ${chalk11.bold(config.default_personality_id)}`);
+    info(`Default agent: ${chalk12.bold(config.default_personality_id)}`);
   } else {
     info(
-      `Default agent: ${chalk11.gray("not set")}  \u2014 run ${chalk11.bold("openhome agents")}`
+      `Default agent: ${chalk12.gray("not set")}  \u2014 run ${chalk12.bold("openhome agents")}`
     );
   }
   if (config.api_base_url) {
@@ -3079,12 +3117,12 @@ async function whoamiCommand() {
   if (tracked.length > 0) {
     const lines = tracked.map((a) => {
       const shortPath = a.path.startsWith(home) ? `~${a.path.slice(home.length)}` : a.path;
-      return `  ${chalk11.bold(a.name)}  ${chalk11.gray(shortPath)}`;
+      return `  ${chalk12.bold(a.name)}  ${chalk12.gray(shortPath)}`;
     });
     p.note(lines.join("\n"), `${tracked.length} tracked ability(s)`);
   } else {
     info(
-      `Tracked abilities: ${chalk11.gray("none")}  \u2014 run ${chalk11.bold("openhome init")}`
+      `Tracked abilities: ${chalk12.gray("none")}  \u2014 run ${chalk12.bold("openhome init")}`
     );
   }
   p.outro("Done.");
@@ -3226,7 +3264,7 @@ async function configEditCommand(pathArg) {
 
 // src/commands/logs.ts
 import WebSocket3 from "ws";
-import chalk12 from "chalk";
+import chalk13 from "chalk";
 var PING_INTERVAL3 = 3e4;
 async function logsCommand(opts = {}) {
   p.intro("\u{1F4E1} Stream agent logs");
@@ -3266,8 +3304,8 @@ async function logsCommand(opts = {}) {
     }
   }
   const wsUrl = `${WS_BASE}${ENDPOINTS.voiceStream(apiKey, agentId)}`;
-  info(`Streaming logs from agent ${chalk12.bold(agentId)}...`);
-  info(`Press ${chalk12.bold("Ctrl+C")} to stop.
+  info(`Streaming logs from agent ${chalk13.bold(agentId)}...`);
+  info(`Press ${chalk13.bold("Ctrl+C")} to stop.
 `);
   await new Promise((resolve6) => {
     const ws = new WebSocket3(wsUrl, {
@@ -3289,33 +3327,33 @@ async function logsCommand(opts = {}) {
     ws.on("message", (raw) => {
       try {
         const msg = JSON.parse(raw.toString());
-        const ts = chalk12.gray((/* @__PURE__ */ new Date()).toLocaleTimeString());
+        const ts = chalk13.gray((/* @__PURE__ */ new Date()).toLocaleTimeString());
         switch (msg.type) {
           case "log":
             console.log(
-              `${ts} ${chalk12.blue("[LOG]")} ${JSON.stringify(msg.data)}`
+              `${ts} ${chalk13.blue("[LOG]")} ${JSON.stringify(msg.data)}`
             );
             break;
           case "action":
             console.log(
-              `${ts} ${chalk12.magenta("[ACTION]")} ${JSON.stringify(msg.data)}`
+              `${ts} ${chalk13.magenta("[ACTION]")} ${JSON.stringify(msg.data)}`
             );
             break;
           case "progress":
             console.log(
-              `${ts} ${chalk12.yellow("[PROGRESS]")} ${JSON.stringify(msg.data)}`
+              `${ts} ${chalk13.yellow("[PROGRESS]")} ${JSON.stringify(msg.data)}`
             );
             break;
           case "question":
             console.log(
-              `${ts} ${chalk12.cyan("[QUESTION]")} ${JSON.stringify(msg.data)}`
+              `${ts} ${chalk13.cyan("[QUESTION]")} ${JSON.stringify(msg.data)}`
             );
             break;
           case "message": {
             const data = msg.data;
             if (data.content && !data.live) {
-              const role = data.role === "assistant" ? chalk12.cyan("AGENT") : chalk12.green("USER");
-              console.log(`${ts} ${chalk12.white(`[${role}]`)} ${data.content}`);
+              const role = data.role === "assistant" ? chalk13.cyan("AGENT") : chalk13.green("USER");
+              console.log(`${ts} ${chalk13.white(`[${role}]`)} ${data.content}`);
             }
             break;
           }
@@ -3334,13 +3372,13 @@ async function logsCommand(opts = {}) {
           case "error-event": {
             const errData = msg.data;
             console.log(
-              `${ts} ${chalk12.red("[ERROR]")} ${errData?.message || errData?.title || JSON.stringify(msg.data)}`
+              `${ts} ${chalk13.red("[ERROR]")} ${errData?.message || errData?.title || JSON.stringify(msg.data)}`
             );
             break;
           }
           default:
             console.log(
-              `${ts} ${chalk12.gray(`[${msg.type}]`)} ${JSON.stringify(msg.data)}`
+              `${ts} ${chalk13.gray(`[${msg.type}]`)} ${JSON.stringify(msg.data)}`
             );
             break;
         }
@@ -3366,7 +3404,7 @@ async function logsCommand(opts = {}) {
 }
 
 // src/commands/set-jwt.ts
-import chalk13 from "chalk";
+import chalk14 from "chalk";
 async function setJwtCommand(token) {
   p.intro("\u{1F511} Enable Management Features");
   if (token) {
@@ -3388,21 +3426,21 @@ async function setJwtCommand(token) {
     [
       "Here's what you'll do:",
       "",
-      `${chalk13.bold("1.")}  We'll open ${chalk13.bold("app.openhome.com")} \u2014 make sure you're logged in`,
+      `${chalk14.bold("1.")}  We'll open ${chalk14.bold("app.openhome.com")} \u2014 make sure you're logged in`,
       "",
-      `${chalk13.bold("2.")}  Open the browser console:`,
-      `     Mac \u2192 ${chalk13.cyan("Cmd + Option + J")}`,
-      `     Windows / Linux \u2192 ${chalk13.cyan("F12")} then click ${chalk13.cyan("Console")}`,
+      `${chalk14.bold("2.")}  Open the browser console:`,
+      `     Mac \u2192 ${chalk14.cyan("Cmd + Option + J")}`,
+      `     Windows / Linux \u2192 ${chalk14.cyan("F12")} then click ${chalk14.cyan("Console")}`,
       "",
-      `${chalk13.bold("3.")}  Chrome may show this warning \u2014 it's expected:`,
-      `     ${chalk13.yellow(`"Don't paste code you don't understand..."`)}`,
-      `     Type ${chalk13.cyan("allow pasting")} and press Enter to dismiss it.`,
+      `${chalk14.bold("3.")}  Chrome may show this warning \u2014 it's expected:`,
+      `     ${chalk14.yellow(`"Don't paste code you don't understand..."`)}`,
+      `     Type ${chalk14.cyan("allow pasting")} and press Enter to dismiss it.`,
       "",
-      `${chalk13.bold("4.")}  Paste this command and press Enter:`,
+      `${chalk14.bold("4.")}  Paste this command and press Enter:`,
       "",
-      `     ${chalk13.green("copy(localStorage.getItem('access_token')), '\u2713 Token copied to clipboard!'")}`,
+      `     ${chalk14.green("copy(localStorage.getItem('access_token')), '\u2713 Token copied to clipboard!'")}`,
       "",
-      `${chalk13.bold("5.")}  Your token is copied to clipboard \u2014 paste it back here.`
+      `${chalk14.bold("5.")}  Your token is copied to clipboard \u2014 paste it back here.`
     ].join("\n"),
     "Enable management features (one-time setup)"
   );
@@ -3423,7 +3461,7 @@ async function setJwtCommand(token) {
 
 // src/commands/validate.ts
 import { resolve as resolve5 } from "path";
-import chalk14 from "chalk";
+import chalk15 from "chalk";
 async function validateCommand(pathArg = ".") {
   const targetDir = resolve5(pathArg);
   p.intro(`\u{1F50E} Validate ability`);
@@ -3439,7 +3477,7 @@ async function validateCommand(pathArg = ".") {
   if (result.errors.length > 0) {
     p.note(
       result.errors.map(
-        (issue) => `${chalk14.red("\u2717")} ${issue.file ? chalk14.bold(`[${issue.file}]`) + " " : ""}${issue.message}`
+        (issue) => `${chalk15.red("\u2717")} ${issue.file ? chalk15.bold(`[${issue.file}]`) + " " : ""}${issue.message}`
       ).join("\n"),
       `${result.errors.length} Error(s)`
     );
@@ -3447,7 +3485,7 @@ async function validateCommand(pathArg = ".") {
   if (result.warnings.length > 0) {
     p.note(
       result.warnings.map(
-        (w) => `${chalk14.yellow("\u26A0")} ${w.file ? chalk14.bold(`[${w.file}]`) + " " : ""}${w.message}`
+        (w) => `${chalk15.yellow("\u26A0")} ${w.file ? chalk15.bold(`[${w.file}]`) + " " : ""}${w.message}`
       ).join("\n"),
       `${result.warnings.length} Warning(s)`
     );
@@ -3493,9 +3531,9 @@ async function checkForUpdates() {
       );
       process.exit(0);
     } else {
-      const { default: chalk15 } = await import("chalk");
+      const { default: chalk16 } = await import("chalk");
       console.log(
-        chalk15.yellow(
+        chalk16.yellow(
           `  Update available: v${version} \u2192 v${latest}   Run: npm install -g openhome-cli@latest
 `
         )

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "openhome-cli",
-  "version": "0.1.17",
+  "version": "0.1.20",
   "description": "CLI for managing OpenHome voice AI abilities",
   "type": "module",
   "bin": {

package/src/api/client.ts

@@ -33,6 +33,13 @@ export class ApiError extends Error {
   }
 }
 
+export class SessionExpiredError extends Error {
+  constructor() {
+    super("Session token expired or invalid");
+    this.name = "SessionExpiredError";
+  }
+}
+
 export interface IApiClient {
   getPersonalities(): Promise<Personality[]>;
   verifyApiKey(apiKey: string): Promise<VerifyApiKeyResponse>;
@@ -107,6 +114,17 @@ export class ApiClient implements IApiClient {
         (body as ApiErrorResponse | null)?.error?.message ??
         response.statusText;
 
+      // Detect expired/invalid JWT
+      if (
+        useJwt &&
+        (response.status === 401 ||
+          message.toLowerCase().includes("token not valid") ||
+          message.toLowerCase().includes("token is invalid") ||
+          message.toLowerCase().includes("not valid for any token"))
+      ) {
+        throw new SessionExpiredError();
+      }
+
       throw new ApiError(String(response.status), message);
     }
 
@@ -134,9 +152,7 @@ export class ApiClient implements IApiClient {
     const form = new FormData();
     form.append(
       "zip_file",
-      new Blob([zipBuffer as unknown as ArrayBuffer], {
-        type: "application/zip",
-      }),
+      new Blob([new Uint8Array(zipBuffer)], { type: "application/zip" }),
       "ability.zip",
     );
 
@@ -146,7 +162,7 @@ export class ApiClient implements IApiClient {
         imageExt === "jpg" || imageExt === "jpeg" ? "image/jpeg" : "image/png";
       form.append(
         "image_file",
-        new Blob([imageBuffer as unknown as ArrayBuffer], { type: imageMime }),
+        new Blob([new Uint8Array(imageBuffer)], { type: imageMime }),
         imageName,
       );
     }

package/src/commands/assign.ts

@@ -1,4 +1,5 @@
 import { ApiClient, NotImplementedError } from "../api/client.js";
+import { handleIfSessionExpired } from "./handle-session-expired.js";
 import { MockApiClient } from "../api/mock-client.js";
 import { getApiKey, getConfig, getJwt } from "../config/store.js";
 import { error, success, info, p, handleCancel } from "../ui/format.js";
@@ -124,6 +125,7 @@ export async function assignCommand(
       return;
     }
 
+    if (await handleIfSessionExpired(err)) return;
     error(`Assign failed: ${err instanceof Error ? err.message : String(err)}`);
     process.exit(1);
   }

package/src/commands/delete.ts

@@ -1,4 +1,5 @@
 import { ApiClient, NotImplementedError } from "../api/client.js";
+import { handleIfSessionExpired } from "./handle-session-expired.js";
 import { MockApiClient } from "../api/mock-client.js";
 import { getApiKey, getConfig, getJwt } from "../config/store.js";
 import { error, success, p, handleCancel } from "../ui/format.js";
@@ -108,6 +109,7 @@ export async function deleteCommand(
       return;
     }
 
+    if (await handleIfSessionExpired(err)) return;
     error(`Delete failed: ${err instanceof Error ? err.message : String(err)}`);
     process.exit(1);
   }

package/src/commands/deploy.ts

@@ -10,6 +10,7 @@ import { homedir } from "node:os";
 import { validateAbility } from "../validation/validator.js";
 import { createAbilityZip } from "../util/zip.js";
 import { ApiClient, NotImplementedError } from "../api/client.js";
+import { handleIfSessionExpired } from "./handle-session-expired.js";
 import { MockApiClient } from "../api/mock-client.js";
 import {
   getApiKey,
@@ -31,6 +32,13 @@ interface AbilityConfig {
   [key: string]: unknown;
 }
 
+function expandPath(p: string): string {
+  if (p.startsWith("~/") || p === "~") {
+    return join(homedir(), p.slice(2));
+  }
+  return resolve(p);
+}
+
 const IMAGE_EXTENSIONS = ["png", "jpg", "jpeg"];
 const ICON_NAMES = IMAGE_EXTENSIONS.flatMap((ext) => [
   `icon.${ext}`,
@@ -113,7 +121,7 @@ async function resolveAbilityDir(pathArg?: string): Promise<string> {
     },
   });
   handleCancel(pathInput);
-  return resolve((pathInput as string).trim());
+  return expandPath((pathInput as string).trim());
 }
 
 export async function deployCommand(
@@ -218,13 +226,13 @@ export async function deployCommand(
             placeholder: "~/path/to/ability.zip",
             validate: (val) => {
               if (!val || !val.trim()) return "Path is required";
-              if (!existsSync(resolve(val.trim())))
+              if (!existsSync(expandPath(val.trim())))
                 return `File not found: ${val.trim()}`;
               if (!val.trim().endsWith(".zip")) return "Must be a .zip file";
             },
           });
           handleCancel(zipInput);
-          zipPath = resolve((zipInput as string).trim());
+          zipPath = expandPath((zipInput as string).trim());
         } else {
           zipPath = selected as string;
         }
@@ -234,13 +242,13 @@ export async function deployCommand(
           placeholder: "~/Downloads/my-ability.zip",
           validate: (val) => {
             if (!val || !val.trim()) return "Path is required";
-            if (!existsSync(resolve(val.trim())))
+            if (!existsSync(expandPath(val.trim())))
               return `File not found: ${val.trim()}`;
             if (!val.trim().endsWith(".zip")) return "Must be a .zip file";
           },
         });
         handleCancel(zipInput);
-        zipPath = resolve((zipInput as string).trim());
+        zipPath = expandPath((zipInput as string).trim());
       }
 
       await deployZip(zipPath, opts);
@@ -386,7 +394,7 @@ export async function deployCommand(
           placeholder: "./icon.png",
           validate: (val) => {
             if (!val || !val.trim()) return undefined;
-            const resolved = resolve(val.trim());
+            const resolved = expandPath(val.trim());
             if (!existsSync(resolved)) return `File not found: ${val.trim()}`;
             if (!IMAGE_EXTS.has(extname(resolved).toLowerCase()))
               return "Image must be PNG or JPG";
@@ -394,7 +402,7 @@ export async function deployCommand(
         });
         handleCancel(imgInput);
         const trimmed = (imgInput as string).trim();
-        if (trimmed) imagePath = resolve(trimmed);
+        if (trimmed) imagePath = expandPath(trimmed);
       } else if (selected !== "__skip__") {
         imagePath = selected as string;
       }
@@ -405,7 +413,7 @@ export async function deployCommand(
         placeholder: "./icon.png",
         validate: (val) => {
           if (!val || !val.trim()) return undefined;
-          const resolved = resolve(val.trim());
+          const resolved = expandPath(val.trim());
           if (!existsSync(resolved)) return `File not found: ${val.trim()}`;
           if (!IMAGE_EXTS.has(extname(resolved).toLowerCase()))
             return "Image must be PNG or JPG";
@@ -413,7 +421,7 @@ export async function deployCommand(
       });
       handleCancel(imgInput);
       const trimmed = (imgInput as string).trim();
-      if (trimmed) imagePath = resolve(trimmed);
+      if (trimmed) imagePath = expandPath(trimmed);
     }
   }
 
@@ -549,6 +557,7 @@ export async function deployCommand(
       return;
     }
 
+    if (await handleIfSessionExpired(err)) return;
     const msg = err instanceof Error ? err.message : String(err);
     if (msg.toLowerCase().includes("same name")) {
       error(`An ability named "${uniqueName}" already exists.`);
@@ -693,6 +702,7 @@ async function deployZip(
     p.outro("Deployed successfully! 🎉");
   } catch (err) {
     s.stop("Upload failed.");
+    if (await handleIfSessionExpired(err)) return;
     error(`Deploy failed: ${err instanceof Error ? err.message : String(err)}`);
     process.exit(1);
   }

package/src/commands/handle-session-expired.ts

@@ -0,0 +1,23 @@
+import { SessionExpiredError } from "../api/client.js";
+import { setupJwt } from "./login.js";
+import { error, p } from "../ui/format.js";
+import chalk from "chalk";
+
+export async function handleIfSessionExpired(err: unknown): Promise<boolean> {
+  if (!(err instanceof SessionExpiredError)) return false;
+
+  console.log("");
+  p.note(
+    [
+      "Your session token has expired or been invalidated.",
+      "This happens when you log into the OpenHome website again.",
+      "",
+      `You need to grab a fresh token — it only takes 30 seconds.`,
+    ].join("\n"),
+    chalk.yellow("Session expired"),
+  );
+
+  await setupJwt();
+  p.note("Token updated. Run the command again to continue.", "Ready");
+  return true;
+}

package/src/commands/list.ts

@@ -1,4 +1,5 @@
 import { ApiClient, NotImplementedError } from "../api/client.js";
+import { handleIfSessionExpired } from "./handle-session-expired.js";
 import { MockApiClient } from "../api/mock-client.js";
 import { getApiKey, getConfig, getJwt } from "../config/store.js";
 import { error, warn, info, table, p } from "../ui/format.js";
@@ -77,6 +78,7 @@ export async function listCommand(
       p.outro("List endpoint not yet implemented.");
       return;
     }
+    if (await handleIfSessionExpired(err)) return;
     error(
       `Failed to list abilities: ${err instanceof Error ? err.message : String(err)}`,
     );

package/src/commands/toggle.ts

@@ -1,4 +1,5 @@
 import { ApiClient, NotImplementedError } from "../api/client.js";
+import { handleIfSessionExpired } from "./handle-session-expired.js";
 import { MockApiClient } from "../api/mock-client.js";
 import { getApiKey, getConfig, getJwt } from "../config/store.js";
 import { error, success, p, handleCancel } from "../ui/format.js";
@@ -119,6 +120,7 @@ export async function toggleCommand(
       return;
     }
 
+    if (await handleIfSessionExpired(err)) return;
     error(`Toggle failed: ${err instanceof Error ? err.message : String(err)}`);
     process.exit(1);
   }