openhome-cli 0.1.3 → 0.1.5

package/dist/cli.js

@@ -1,7 +1,7 @@
 import {
   getApiKey,
   getConfig,
-  getJwt as getJwt2,
+  getJwt,
   getTrackedAbilities,
   keychainDelete,
   registerAbility,
@@ -16,6 +16,9 @@ import { fileURLToPath } from "url";
 import { dirname, join as join6 } from "path";
 import { readFileSync as readFileSync5 } from "fs";
 
+// src/commands/login.ts
+import { execFile } from "child_process";
+
 // src/api/endpoints.ts
 var API_BASE = "https://app.openhome.com";
 var WS_BASE = "wss://app.openhome.com";
@@ -272,10 +275,38 @@ function handleCancel(value) {
 
 // src/commands/login.ts
 import chalk2 from "chalk";
+var SETTINGS_URL = "https://app.openhome.com/dashboard/settings";
+function openBrowser(url) {
+  try {
+    if (process.platform === "darwin") {
+      execFile("open", [url]);
+    } else if (process.platform === "win32") {
+      execFile("cmd", ["/c", "start", url]);
+    } else {
+      execFile("xdg-open", [url]);
+    }
+  } catch {
+  }
+}
 async function loginCommand() {
   p.intro("\u{1F511} OpenHome Login");
+  const open = await p.confirm({
+    message: `Press Enter to open your browser and navigate to the ${chalk2.bold("API Keys")} tab`,
+    initialValue: true,
+    active: "Open browser",
+    inactive: "Skip"
+  });
+  handleCancel(open);
+  if (open) {
+    openBrowser(SETTINGS_URL);
+    console.log(
+      `
+  ${chalk2.dim(`Opened ${chalk2.bold("app.openhome.com/dashboard/settings")} \u2014 click the ${chalk2.bold("API Keys")} tab`)}
+`
+    );
+  }
   const apiKey = await p.password({
-    message: "Enter your OpenHome API key",
+    message: "Paste your API key here",
     validate: (val) => {
       if (!val || !val.trim()) return "API key is required";
     }
@@ -286,17 +317,13 @@ async function loginCommand() {
   let agents;
   try {
     const client = new ApiClient(apiKey);
-    const verification = await client.verifyApiKey(apiKey);
-    if (!verification.valid) {
-      s.stop("Verification failed.");
-      error(verification.message ?? "Invalid API key.");
-      process.exit(1);
-    }
     agents = await client.getPersonalities();
     s.stop("API key verified.");
   } catch (err) {
     s.stop("Verification failed.");
-    error(err instanceof Error ? err.message : String(err));
+    error(
+      err instanceof Error && err.message.includes("401") ? "Invalid API key \u2014 check the value and try again." : err instanceof Error ? err.message : String(err)
+    );
     process.exit(1);
   }
   saveApiKey(apiKey);
@@ -548,7 +575,7 @@ import archiver from "archiver";
 import { createWriteStream } from "fs";
 import { Writable } from "stream";
 async function createAbilityZip(dirPath) {
-  return new Promise((resolve5, reject) => {
+  return new Promise((resolve6, reject) => {
     const chunks = [];
     const writable = new Writable({
       write(chunk, _encoding, callback) {
@@ -557,7 +584,7 @@ async function createAbilityZip(dirPath) {
       }
     });
     writable.on("finish", () => {
-      resolve5(Buffer.concat(chunks));
+      resolve6(Buffer.concat(chunks));
     });
     writable.on("error", reject);
     const archive = archiver("zip", { zlib: { level: 9 } });
@@ -1825,7 +1852,7 @@ async function deleteCommand(abilityArg, opts = {}) {
     client = new MockApiClient();
   } else {
     const apiKey = getApiKey() ?? "";
-    const jwt = getJwt2() ?? void 0;
+    const jwt = getJwt() ?? void 0;
     if (!apiKey && !jwt) {
       error("Not authenticated. Run: openhome login");
       process.exit(1);
@@ -1914,7 +1941,7 @@ async function toggleCommand(abilityArg, opts = {}) {
     client = new MockApiClient();
   } else {
     const apiKey = getApiKey() ?? "";
-    const jwt = getJwt2() ?? void 0;
+    const jwt = getJwt() ?? void 0;
     if (!apiKey && !jwt) {
       error("Not authenticated. Run: openhome login");
       process.exit(1);
@@ -2013,7 +2040,7 @@ async function assignCommand(opts = {}) {
     client = new MockApiClient();
   } else {
     const apiKey = getApiKey() ?? "";
-    const jwt = getJwt2() ?? void 0;
+    const jwt = getJwt() ?? void 0;
     if (!apiKey && !jwt) {
       error("Not authenticated. Run: openhome login");
       process.exit(1);
@@ -2122,7 +2149,7 @@ async function listCommand(opts = {}) {
     client = new MockApiClient();
   } else {
     const apiKey = getApiKey() ?? "";
-    const jwt = getJwt2() ?? void 0;
+    const jwt = getJwt() ?? void 0;
     if (!apiKey && !jwt) {
       error("Not authenticated. Run: openhome login");
       process.exit(1);
@@ -2422,7 +2449,7 @@ async function chatCommand(agentArg, opts = {}) {
   }
   const wsUrl = `${WS_BASE}${ENDPOINTS.voiceStream(apiKey, agentId)}`;
   info(`Connecting to agent ${chalk9.bold(agentId)}...`);
-  await new Promise((resolve5) => {
+  await new Promise((resolve6) => {
     const ws = new WebSocket(wsUrl, {
       perMessageDeflate: false,
       headers: {
@@ -2550,7 +2577,7 @@ async function chatCommand(agentArg, opts = {}) {
       console.error("");
       error(`WebSocket error: ${err.message}`);
       rl.close();
-      resolve5();
+      resolve6();
     });
     ws.on("close", (code) => {
       if (pingInterval) clearInterval(pingInterval);
@@ -2561,7 +2588,7 @@ async function chatCommand(agentArg, opts = {}) {
         info(`Connection closed (code: ${code})`);
       }
       rl.close();
-      resolve5();
+      resolve6();
     });
     rl.on("close", () => {
       if (connected) {
@@ -2628,7 +2655,7 @@ async function triggerCommand(phraseArg, opts = {}) {
   info(`Sending "${chalk10.bold(phrase)}" to agent ${chalk10.bold(agentId)}...`);
   const s = p.spinner();
   s.start("Waiting for response...");
-  await new Promise((resolve5) => {
+  await new Promise((resolve6) => {
     const ws = new WebSocket2(wsUrl, {
       perMessageDeflate: false,
       headers: {
@@ -2658,7 +2685,7 @@ async function triggerCommand(phraseArg, opts = {}) {
 ${chalk10.cyan("Agent:")} ${fullResponse}`);
         }
         cleanup();
-        resolve5();
+        resolve6();
       }, RESPONSE_TIMEOUT);
     });
     ws.on("message", (raw) => {
@@ -2675,7 +2702,7 @@ ${chalk10.cyan("Agent:")} ${fullResponse}`);
 ${chalk10.cyan("Agent:")} ${fullResponse}
 `);
                 cleanup();
-                resolve5();
+                resolve6();
               }
             }
             break;
@@ -2692,7 +2719,7 @@ ${chalk10.cyan("Agent:")} ${fullResponse}
 ${chalk10.cyan("Agent:")} ${fullResponse}
 `);
                 cleanup();
-                resolve5();
+                resolve6();
               }
             }
             break;
@@ -2707,7 +2734,7 @@ ${chalk10.cyan("Agent:")} ${fullResponse}
               `Server error: ${errData?.message || errData?.title || "Unknown"}`
             );
             cleanup();
-            resolve5();
+            resolve6();
             break;
           }
         }
@@ -2717,12 +2744,12 @@ ${chalk10.cyan("Agent:")} ${fullResponse}
     ws.on("error", (err) => {
       s.stop("Connection error.");
       error(err.message);
-      resolve5();
+      resolve6();
     });
     ws.on("close", () => {
       if (pingInterval) clearInterval(pingInterval);
       if (responseTimer) clearTimeout(responseTimer);
-      resolve5();
+      resolve6();
     });
   });
 }
@@ -2947,7 +2974,7 @@ async function logsCommand(opts = {}) {
   info(`Streaming logs from agent ${chalk12.bold(agentId)}...`);
   info(`Press ${chalk12.bold("Ctrl+C")} to stop.
 `);
-  await new Promise((resolve5) => {
+  await new Promise((resolve6) => {
     const ws = new WebSocket3(wsUrl, {
       perMessageDeflate: false,
       headers: {
@@ -3027,13 +3054,13 @@ async function logsCommand(opts = {}) {
     });
     ws.on("error", (err) => {
       error(`WebSocket error: ${err.message}`);
-      resolve5();
+      resolve6();
     });
     ws.on("close", (code) => {
       if (pingInterval) clearInterval(pingInterval);
       console.log("");
       info(`Connection closed (code: ${code})`);
-      resolve5();
+      resolve6();
     });
     process.on("SIGINT", () => {
       console.log("");
@@ -3044,17 +3071,17 @@ async function logsCommand(opts = {}) {
 }
 
 // src/commands/set-jwt.ts
-import { execFile } from "child_process";
+import { execFile as execFile2 } from "child_process";
 import chalk13 from "chalk";
 var OPENHOME_URL = "https://app.openhome.com";
-function openBrowser(url) {
+function openBrowser2(url) {
   try {
     if (process.platform === "darwin") {
-      execFile("open", [url]);
+      execFile2("open", [url]);
     } else if (process.platform === "win32") {
-      execFile("cmd", ["/c", "start", url]);
+      execFile2("cmd", ["/c", "start", url]);
     } else {
-      execFile("xdg-open", [url]);
+      execFile2("xdg-open", [url]);
     }
   } catch {
   }
@@ -3091,7 +3118,7 @@ async function setJwtCommand(token) {
   console.log(
     chalk13.dim(`  Opening ${chalk13.bold("app.openhome.com")} in your browser...`)
   );
-  openBrowser(OPENHOME_URL);
+  openBrowser2(OPENHOME_URL);
   console.log("");
   p.note(
     [
@@ -3144,6 +3171,45 @@ async function setJwtCommand(token) {
   }
 }
 
+// src/commands/validate.ts
+import { resolve as resolve5 } from "path";
+import chalk14 from "chalk";
+async function validateCommand(pathArg = ".") {
+  const targetDir = resolve5(pathArg);
+  p.intro(`\u{1F50E} Validate ability`);
+  const s = p.spinner();
+  s.start("Running checks...");
+  const result = validateAbility(targetDir);
+  if (result.errors.length === 0 && result.warnings.length === 0) {
+    s.stop("All checks passed.");
+    p.outro("Ability is ready to deploy! \u{1F389}");
+    return;
+  }
+  s.stop("Checks complete.");
+  if (result.errors.length > 0) {
+    p.note(
+      result.errors.map(
+        (issue) => `${chalk14.red("\u2717")} ${issue.file ? chalk14.bold(`[${issue.file}]`) + " " : ""}${issue.message}`
+      ).join("\n"),
+      `${result.errors.length} Error(s)`
+    );
+  }
+  if (result.warnings.length > 0) {
+    p.note(
+      result.warnings.map(
+        (w) => `${chalk14.yellow("\u26A0")} ${w.file ? chalk14.bold(`[${w.file}]`) + " " : ""}${w.message}`
+      ).join("\n"),
+      `${result.warnings.length} Warning(s)`
+    );
+  }
+  if (result.passed) {
+    p.outro("Validation passed (with warnings).");
+  } else {
+    error("Fix errors before deploying.");
+    process.exit(1);
+  }
+}
+
 // src/cli.ts
 var __filename = fileURLToPath(import.meta.url);
 var __dirname = dirname(__filename);
@@ -3176,16 +3242,6 @@ async function interactiveMenu() {
           label: "\u2728  Create Ability",
           hint: "Scaffold and deploy a new ability"
         },
-        {
-          value: "chat",
-          label: "\u{1F4AC}  Chat",
-          hint: "Talk to your agent"
-        },
-        {
-          value: "trigger",
-          label: "\u26A1  Trigger",
-          hint: "Fire an ability remotely with a phrase"
-        },
         {
           value: "list",
           label: "\u{1F4CB}  My Abilities",
@@ -3212,30 +3268,15 @@ async function interactiveMenu() {
           hint: "View agents and set default"
         },
         {
-          value: "status",
-          label: "\u{1F50D}  Status",
-          hint: "Check ability status"
-        },
-        {
-          value: "config",
-          label: "\u2699\uFE0F   Edit Config",
-          hint: "Update trigger words, description, category"
+          value: "chat",
+          label: "\u{1F4AC}  Chat",
+          hint: "Talk to your agent"
         },
         {
           value: "logs",
           label: "\u{1F4E1}  Logs",
           hint: "Stream live agent messages"
         },
-        {
-          value: "whoami",
-          label: "\u{1F464}  Who Am I",
-          hint: "Show auth, default agent, tracked abilities"
-        },
-        {
-          value: "set-jwt",
-          label: "\u{1F511}  Enable Management",
-          hint: "Unlock list, delete, toggle, assign"
-        },
         {
           value: "logout",
           label: "\u{1F513}  Log Out",
@@ -3249,12 +3290,6 @@ async function interactiveMenu() {
       case "init":
         await initCommand();
         break;
-      case "chat":
-        await chatCommand();
-        break;
-      case "trigger":
-        await triggerCommand();
-        break;
       case "list":
         await listCommand();
         break;
@@ -3270,21 +3305,12 @@ async function interactiveMenu() {
       case "agents":
         await agentsCommand();
         break;
-      case "status":
-        await statusCommand();
-        break;
-      case "config":
-        await configEditCommand();
+      case "chat":
+        await chatCommand();
         break;
       case "logs":
         await logsCommand();
         break;
-      case "whoami":
-        await whoamiCommand();
-        break;
-      case "set-jwt":
-        await setJwtCommand();
-        break;
       case "logout":
         await logoutCommand();
         await ensureLoggedIn();
@@ -3350,6 +3376,9 @@ program.command("logs").description("Stream live agent messages and logs").optio
 program.command("whoami").description("Show auth status, default agent, and tracked abilities").action(async () => {
   await whoamiCommand();
 });
+program.command("validate [path]").description("Check an ability for errors before deploying").action(async (path) => {
+  await validateCommand(path);
+});
 program.command("set-jwt [token]").description(
   "Save a session token to enable management commands (list, delete, toggle, assign)"
 ).action(async (token) => {

package/package.json

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

package/src/cli.ts

@@ -19,6 +19,7 @@ import { whoamiCommand } from "./commands/whoami.js";
 import { configEditCommand } from "./commands/config-edit.js";
 import { logsCommand } from "./commands/logs.js";
 import { setJwtCommand } from "./commands/set-jwt.js";
+import { validateCommand } from "./commands/validate.js";
 import { p, handleCancel } from "./ui/format.js";
 
 // Read version from package.json
@@ -61,16 +62,6 @@ async function interactiveMenu(): Promise<void> {
           label: "✨  Create Ability",
           hint: "Scaffold and deploy a new ability",
         },
-        {
-          value: "chat",
-          label: "💬  Chat",
-          hint: "Talk to your agent",
-        },
-        {
-          value: "trigger",
-          label: "⚡  Trigger",
-          hint: "Fire an ability remotely with a phrase",
-        },
         {
           value: "list",
           label: "📋  My Abilities",
@@ -97,30 +88,15 @@ async function interactiveMenu(): Promise<void> {
           hint: "View agents and set default",
         },
         {
-          value: "status",
-          label: "🔍  Status",
-          hint: "Check ability status",
-        },
-        {
-          value: "config",
-          label: "⚙️   Edit Config",
-          hint: "Update trigger words, description, category",
+          value: "chat",
+          label: "💬  Chat",
+          hint: "Talk to your agent",
         },
         {
           value: "logs",
           label: "📡  Logs",
           hint: "Stream live agent messages",
         },
-        {
-          value: "whoami",
-          label: "👤  Who Am I",
-          hint: "Show auth, default agent, tracked abilities",
-        },
-        {
-          value: "set-jwt",
-          label: "🔑  Enable Management",
-          hint: "Unlock list, delete, toggle, assign",
-        },
         {
           value: "logout",
           label: "🔓  Log Out",
@@ -135,12 +111,6 @@ async function interactiveMenu(): Promise<void> {
       case "init":
         await initCommand();
         break;
-      case "chat":
-        await chatCommand();
-        break;
-      case "trigger":
-        await triggerCommand();
-        break;
       case "list":
         await listCommand();
         break;
@@ -156,21 +126,12 @@ async function interactiveMenu(): Promise<void> {
       case "agents":
         await agentsCommand();
         break;
-      case "status":
-        await statusCommand();
-        break;
-      case "config":
-        await configEditCommand();
+      case "chat":
+        await chatCommand();
         break;
       case "logs":
         await logsCommand();
         break;
-      case "whoami":
-        await whoamiCommand();
-        break;
-      case "set-jwt":
-        await setJwtCommand();
-        break;
       case "logout":
         await logoutCommand();
         await ensureLoggedIn();
@@ -325,6 +286,13 @@ program
     await whoamiCommand();
   });
 
+program
+  .command("validate [path]")
+  .description("Check an ability for errors before deploying")
+  .action(async (path?: string) => {
+    await validateCommand(path);
+  });
+
 program
   .command("set-jwt [token]")
   .description(

package/src/commands/login.ts

@@ -1,14 +1,46 @@
+import { execFile } from "node:child_process";
 import { ApiClient } from "../api/client.js";
 import type { Personality } from "../api/contracts.js";
-import { saveApiKey, saveJwt } from "../config/store.js";
+import { saveApiKey } from "../config/store.js";
 import { success, error, info, p, handleCancel } from "../ui/format.js";
 import chalk from "chalk";
 
+const SETTINGS_URL = "https://app.openhome.com/dashboard/settings";
+
+function openBrowser(url: string): void {
+  try {
+    if (process.platform === "darwin") {
+      execFile("open", [url]);
+    } else if (process.platform === "win32") {
+      execFile("cmd", ["/c", "start", url]);
+    } else {
+      execFile("xdg-open", [url]);
+    }
+  } catch {
+    // best-effort
+  }
+}
+
 export async function loginCommand(): Promise<void> {
   p.intro("🔑 OpenHome Login");
 
+  const open = await p.confirm({
+    message: `Press Enter to open your browser and navigate to the ${chalk.bold("API Keys")} tab`,
+    initialValue: true,
+    active: "Open browser",
+    inactive: "Skip",
+  });
+  handleCancel(open);
+
+  if (open) {
+    openBrowser(SETTINGS_URL);
+    console.log(
+      `\n  ${chalk.dim(`Opened ${chalk.bold("app.openhome.com/dashboard/settings")} — click the ${chalk.bold("API Keys")} tab`)}\n`,
+    );
+  }
+
   const apiKey = await p.password({
-    message: "Enter your OpenHome API key",
+    message: "Paste your API key here",
     validate: (val) => {
       if (!val || !val.trim()) return "API key is required";
     },
@@ -21,24 +53,23 @@ export async function loginCommand(): Promise<void> {
   let agents: Personality[];
   try {
     const client = new ApiClient(apiKey as string);
-    const verification = await client.verifyApiKey(apiKey as string);
-    if (!verification.valid) {
-      s.stop("Verification failed.");
-      error(verification.message ?? "Invalid API key.");
-      process.exit(1);
-    }
     agents = await client.getPersonalities();
     s.stop("API key verified.");
   } catch (err) {
     s.stop("Verification failed.");
-    error(err instanceof Error ? err.message : String(err));
+    error(
+      err instanceof Error && err.message.includes("401")
+        ? "Invalid API key — check the value and try again."
+        : err instanceof Error
+          ? err.message
+          : String(err),
+    );
     process.exit(1);
   }
 
   saveApiKey(apiKey as string);
   success("API key saved.");
 
-  // Show agents on this account
   if (agents.length > 0) {
     p.note(
       agents

package/src/commands/status.ts

@@ -3,7 +3,12 @@ import { existsSync, readFileSync } from "node:fs";
 import { homedir } from "node:os";
 import { ApiClient, NotImplementedError } from "../api/client.js";
 import { MockApiClient } from "../api/mock-client.js";
-import { getApiKey, getConfig, getTrackedAbilities } from "../config/store.js";
+import {
+  getApiKey,
+  getConfig,
+  getJwt,
+  getTrackedAbilities,
+} from "../config/store.js";
 import { error, warn, info, p, handleCancel } from "../ui/format.js";
 import chalk from "chalk";