@autoposting.ai/cli 0.3.0 → 0.3.1

package/dist/cli.cjs

@@ -46,7 +46,7 @@ var VERSION, AutopostingError, AuthenticationError, ScopeError, NotFoundError, V
 var init_dist = __esm({
   "../sdk/dist/index.mjs"() {
     "use strict";
-    VERSION = "0.3.0";
+    VERSION = "0.3.1";
     AutopostingError = class extends Error {
       status;
       code;
@@ -93,6 +93,7 @@ var init_dist = __esm({
       }
     };
     AgentsResource = class extends Resource {
+      /** GET /agents — backend returns `{ items, total, limit, offset }`. */
       list() {
         return this.get("/agents");
       }
@@ -108,12 +109,14 @@ var init_dist = __esm({
       remove(id) {
         return this.delete(`/agents/${id}`);
       }
+      /** POST /agents/:id/run — queues a run; returns `{ runId, status }`, not a full AgentRun. */
       run(id) {
         return this.post(`/agents/${id}/run`);
       }
       toggle(id) {
         return this.post(`/agents/${id}/toggle`);
       }
+      /** GET /agents/:id/runs — backend returns `{ items, total, limit, offset }`. */
       runs(id) {
         return this.get(`/agents/${id}/runs`);
       }
@@ -147,6 +150,7 @@ var init_dist = __esm({
       }
     };
     CarouselsResource = class extends Resource {
+      /** GET /carousels — backend paginates: `{ items, total, limit, offset }`. */
       list() {
         return this.get("/carousels");
       }
@@ -159,37 +163,38 @@ var init_dist = __esm({
       generate(params) {
         return this.post("/carousels/generate", params);
       }
-      /** POST /carousels/:id/draft — converts carousel to a post draft */
+      /** POST /carousels/:id/create-draft — converts carousel to a post draft */
       draft(id) {
-        return this.post(`/carousels/${id}/draft`);
+        return this.post(`/carousels/${id}/create-draft`);
       }
       remove(id) {
         return this.client.request("DELETE", `/carousels/${id}`);
       }
     };
     ClipsResource = class extends Resource {
+      /** GET /clips — backend returns `{ clips, pagination }`, not a bare array. */
       list() {
         return this.client.request("GET", "/clips");
       }
       retrieve(id) {
         return this.client.request("GET", `/clips/${id}`);
       }
-      async upload(filePath, options) {
-        const fs3 = await import("fs");
-        const path2 = await import("path");
-        const data = fs3.readFileSync(filePath);
-        const name = options?.name ?? path2.basename(filePath);
-        const formData = new FormData();
-        formData.append("file", new Blob([data]), name);
-        formData.append("name", name);
-        options?.onProgress?.(0);
-        const clip = await this.client.request("POST", "/clips/upload", formData);
-        options?.onProgress?.(100);
-        return clip;
+      // ponytail: the backend has no single-request /clips/upload; uploading a file means the
+      // multipart init/presign/complete flow (upload-initiate → upload-presign → upload-complete).
+      // That's too much surface for v0.3.1 — fail honestly and point at importUrl. Upgrade path:
+      // implement the init/presign/complete dance here when direct upload is actually needed.
+      async upload(_filePath, _options) {
+        throw new AutopostingError(
+          "Direct clip file upload is not supported by the API yet \u2014 use `importUrl` with a public video URL instead.",
+          0,
+          "NOT_IMPLEMENTED"
+        );
       }
+      /** POST /clips/import-url — backend returns `{ clipId }`, not a full Clip. */
       importUrl(params) {
-        return this.client.request("POST", "/clips/import", params);
+        return this.client.request("POST", "/clips/import-url", params);
       }
+      /** POST /clips/:id/render — backend returns render job ids, not a Clip. */
       render(id) {
         return this.client.request("POST", `/clips/${id}/render`);
       }
@@ -198,45 +203,45 @@ var init_dist = __esm({
       }
     };
     PostsResource = class extends Resource {
-      list(params) {
-        return this.client.request(
-          "GET",
-          "/v1/posts",
-          void 0,
-          params
-        );
-      }
-      /** GET /v1/posts/:id */
+      /** GET /posts — backend returns a bare array (no pagination metadata). */
+      list(params = {}) {
+        const { brandSlug, status, limit, page } = params;
+        const query = {};
+        if (brandSlug) query.brandSlug = brandSlug;
+        if (status) query.status = status;
+        if (limit !== void 0) query.limit = limit;
+        if (page !== void 0 && page > 1) query.offset = (page - 1) * (limit ?? 20);
+        return this.client.request("GET", "/posts", void 0, query);
+      }
+      /** GET /posts/:id */
       getById(id) {
-        return this.client.request("GET", `/v1/posts/${id}`);
+        return this.client.request("GET", `/posts/${id}`);
       }
       create(params) {
-        return this.client.request("POST", "/v1/posts", params);
+        return this.client.request("POST", "/posts", params);
       }
       update(id, params) {
-        return this.client.request("PUT", `/v1/posts/${id}`, params);
+        return this.client.request("PUT", `/posts/${id}`, params);
       }
-      /** DELETE /v1/posts/:id */
+      /** DELETE /posts/:id */
       remove(id) {
-        return this.client.request("DELETE", `/v1/posts/${id}`);
+        return this.client.request("DELETE", `/posts/${id}`);
       }
       publish(id) {
-        return this.client.request("POST", `/v1/posts/${id}/publish`);
+        return this.client.request("POST", `/posts/${id}/publish`);
       }
       schedule(id, scheduledAt) {
-        return this.client.request("PUT", `/v1/posts/${id}/schedule`, { scheduledAt });
+        return this.client.request("PUT", `/posts/${id}/schedule`, { scheduledAt });
       }
       retry(id) {
-        return this.client.request("POST", `/v1/posts/${id}/retry`);
+        return this.client.request("POST", `/posts/${id}/retry`);
       }
       rewrite(id) {
-        return this.client.request("POST", `/v1/posts/${id}/rewrite`);
+        return this.client.request("POST", `/posts/${id}/rewrite`);
       }
+      /** POST /posts/:id/score — backend returns `{ score }` only (no feedback). */
       score(id) {
-        return this.client.request(
-          "POST",
-          `/v1/posts/${id}/score`
-        );
+        return this.client.request("POST", `/posts/${id}/score`);
       }
     };
     KbResource = class extends Resource {
@@ -253,7 +258,10 @@ var init_dist = __esm({
         return this.delete(`/kbs/${id}`);
       }
       search(id, query) {
-        return this.post(`/kbs/${id}/search`, { query });
+        return this.post(
+          `/kbs/${id}/search`,
+          { query }
+        );
       }
       ingestUrl(id, url) {
         return this.post(`/kbs/${id}/docs/ingest-url`, { url });
@@ -263,14 +271,21 @@ var init_dist = __esm({
       }
     };
     IdeasResource = class extends Resource {
+      /** POST /ideas/generate-topic — returns an object whose `ideas` holds the generated ideas. */
       generate(params = {}) {
-        return this.post("/ideas/generate", params);
+        return this.post("/ideas/generate-topic", params);
       }
+      /** GET /ideas — backend paginates: `{ items, total, limit, offset }`. */
       list() {
         return this.get("/ideas");
       }
-      enrich(id) {
-        return this.post(`/ideas/${id}/enrich`);
+      /**
+       * POST /ideas/enrich — enrich an idea (title/hook/angle) across 1..5 platforms.
+       * Async: returns a job id (202). NOTE: the backend enriches the idea *object*, not an
+       * id — there is no enrich-by-id route. Poll the result separately (not yet wrapped).
+       */
+      enrich(params) {
+        return this.post("/ideas/enrich", params);
       }
       remove(id) {
         return this.delete(`/ideas/${id}`);
@@ -285,6 +300,7 @@ var init_dist = __esm({
       list() {
         return this.get("/webhooks");
       }
+      // NOTE: the backend has no GET /webhooks/:id route — this 404s until front-back adds it.
       retrieve(id) {
         return this.get(`/webhooks/${id}`);
       }
@@ -297,6 +313,7 @@ var init_dist = __esm({
       remove(id) {
         return this.client.request("DELETE", `/webhooks/${id}`);
       }
+      // POST /webhooks/:id/test — backend returns `{ delivered, httpStatus }`.
       test(id) {
         return this.post(`/webhooks/${id}/test`);
       }
@@ -305,6 +322,10 @@ var init_dist = __esm({
       constructor(client) {
         super(client);
       }
+      /**
+       * GET /orgs — backend returns `{ organizations, activeOrgId }`, not a bare array.
+       * NOTE: this route is session-only (better-auth session); an API key receives 401.
+       */
       list() {
         return this.get("/orgs");
       }
@@ -316,7 +337,7 @@ var init_dist = __esm({
             )
           );
         }
-        return this.post("/orgs/set-active", { organizationId: id });
+        return this.client.request("PUT", "/orgs/active", { organizationId: id });
       }
     };
     Autoposting = class {
@@ -346,7 +367,7 @@ var init_dist = __esm({
           );
         }
         this._apiKey = key;
-        this.baseUrl = (config.baseUrl ?? "https://app.autoposting.ai").replace(/\/$/, "");
+        this.baseUrl = (config.baseUrl || process.env.AUTOPOSTING_BASE_URL || "https://app.autoposting.ai/api-proxy").replace(/\/$/, "");
         this.timeout = config.timeout ?? 3e4;
         this.extraHeaders = config.headers ?? {};
         this.authSource = config.authSource ?? "api-key";
@@ -375,46 +396,101 @@ var init_dist = __esm({
         }
         const isFormData = body instanceof FormData;
         const headers = {
+          ...this.extraHeaders,
           authorization: `Bearer ${this._apiKey}`,
           "user-agent": `autoposting-sdk/${VERSION}`,
-          "x-source": "sdk",
-          ...this.extraHeaders
+          "x-source": "sdk"
         };
         if (!isFormData) {
           headers["content-type"] = "application/json";
         }
         const controller = new AbortController();
         const timer = setTimeout(() => controller.abort(), this.timeout);
-        let response;
         try {
-          response = await fetch(url, {
-            method,
-            headers,
-            body: isFormData ? body : body !== void 0 ? JSON.stringify(body) : void 0,
-            signal: controller.signal
-          });
-        } finally {
-          clearTimeout(timer);
-        }
-        if (!response.ok) {
-          let errorBody = {};
+          let response;
           try {
-            errorBody = await response.json();
-          } catch {
+            response = await fetch(url, {
+              method,
+              headers,
+              body: isFormData ? body : body !== void 0 ? JSON.stringify(body) : void 0,
+              signal: controller.signal
+            });
+          } catch (err) {
+            if (err instanceof Error && err.name === "AbortError") {
+              throw new AutopostingError(
+                `Request to ${method} ${path2} timed out after ${this.timeout}ms.`,
+                0,
+                "TIMEOUT"
+              );
+            }
+            throw new AutopostingError(
+              `Network request to ${method} ${path2} failed: ${err instanceof Error ? err.message : String(err)}`,
+              0,
+              "NETWORK_ERROR"
+            );
           }
-          const err = createError(response.status, errorBody);
-          if (err instanceof RateLimitError) {
-            const retryAfter = response.headers.get("Retry-After");
-            if (retryAfter) {
-              err.retryAfter = parseInt(retryAfter, 10);
+          if (!response.ok) {
+            const raw = await response.text();
+            let errorBody = {};
+            if (raw) {
+              try {
+                errorBody = JSON.parse(raw);
+              } catch {
+              }
+            }
+            if (!errorBody.error) {
+              const snippet = raw.replace(/\s+/g, " ").trim().slice(0, 120);
+              errorBody.error = snippet ? `HTTP ${response.status} ${response.statusText}: ${snippet}` : `HTTP ${response.status} ${response.statusText}`;
+            }
+            const err = createError(response.status, errorBody);
+            if (err instanceof RateLimitError) {
+              const retryAfter = response.headers.get("Retry-After");
+              if (retryAfter) {
+                const seconds = Number(retryAfter);
+                if (Number.isFinite(seconds)) {
+                  err.retryAfter = Math.max(0, Math.round(seconds));
+                } else {
+                  const dateMs = Date.parse(retryAfter);
+                  if (!Number.isNaN(dateMs)) {
+                    err.retryAfter = Math.max(0, Math.round((dateMs - Date.now()) / 1e3));
+                  }
+                }
+              }
             }
+            throw err;
+          }
+          if (response.status === 204) {
+            return {};
+          }
+          const text = await response.text();
+          if (!text) return {};
+          let parsed;
+          try {
+            parsed = JSON.parse(text);
+          } catch {
+            throw new AutopostingError(
+              `Expected a JSON response from ${method} ${path2} but received non-JSON (HTTP ${response.status}). Verify the API base URL (AUTOPOSTING_BASE_URL / --base-url) points at the API, not the web app.`,
+              response.status,
+              "INVALID_RESPONSE"
+            );
+          }
+          if (typeof parsed === "object" && parsed !== null && parsed.success === true) {
+            const env = parsed;
+            return env.data !== void 0 ? env.data : {};
+          }
+          return parsed;
+        } catch (err) {
+          if (err instanceof Error && err.name === "AbortError") {
+            throw new AutopostingError(
+              `Request to ${method} ${path2} timed out after ${this.timeout}ms.`,
+              0,
+              "TIMEOUT"
+            );
           }
           throw err;
+        } finally {
+          clearTimeout(timer);
         }
-        if (response.status === 204) {
-          return {};
-        }
-        return response.json();
       }
     };
   }
@@ -862,13 +938,26 @@ var init_tools = __esm({
       },
       {
         name: "enrich-idea",
-        description: "Enrich an idea with additional AI-generated context.",
+        description: "Enrich an idea (title/hook/angle) into platform-ready drafts across 1..5 platforms. Async \u2014 returns a job ID.",
         inputSchema: {
           type: "object",
           properties: {
-            id: { type: "string", description: "Idea ID to enrich" }
+            title: { type: "string", description: "Idea title" },
+            hook: { type: "string", description: "Idea hook" },
+            angle: { type: "string", description: "Idea angle" },
+            platforms: {
+              type: "array",
+              description: "Target platforms (1..5)",
+              items: {
+                type: "string",
+                enum: ["twitter", "linkedin", "instagram", "youtube", "threads"]
+              },
+              minItems: 1,
+              maxItems: 5
+            },
+            kbId: { type: "string", description: "Optional knowledge base ID for context" }
           },
-          required: ["id"],
+          required: ["title", "hook", "angle", "platforms"],
           additionalProperties: false
         }
       },
@@ -1345,7 +1434,17 @@ async function dispatchToolCall(name, args, client) {
       return ok(result);
     }
     case "enrich-idea": {
-      const result = await client.ideas.enrich(args.id);
+      const result = await client.ideas.enrich({
+        idea: {
+          title: args.title,
+          hook: args.hook,
+          angle: args.angle
+        },
+        platforms: args.platforms.map((platform) => ({
+          platform
+        })),
+        ...args.kbId ? { kbId: args.kbId } : {}
+      });
       return ok(result);
     }
     case "delete-idea": {
@@ -1523,7 +1622,8 @@ var import_node_fs = __toESM(require("fs"));
 var import_node_os = __toESM(require("os"));
 var import_node_path = __toESM(require("path"));
 function getCredentialsPath() {
-  const configBase = process.env.XDG_CONFIG_HOME ?? import_node_path.default.join(import_node_os.default.homedir(), ".config");
+  const xdg = process.env.XDG_CONFIG_HOME;
+  const configBase = xdg && import_node_path.default.isAbsolute(xdg) ? xdg : import_node_path.default.join(import_node_os.default.homedir(), ".config");
   return import_node_path.default.join(configBase, "autoposting", "credentials.json");
 }
 function readCredentials() {
@@ -1539,11 +1639,27 @@ function writeCredentials(creds) {
   const filePath = getCredentialsPath();
   const dir = import_node_path.default.dirname(filePath);
   import_node_fs.default.mkdirSync(dir, { recursive: true, mode: 448 });
-  import_node_fs.default.writeFileSync(filePath, JSON.stringify(creds, null, 2), { encoding: "utf8", mode: 384 });
+  const tmpPath = `${filePath}.${process.pid}.tmp`;
+  try {
+    import_node_fs.default.writeFileSync(tmpPath, JSON.stringify(creds, null, 2), { encoding: "utf8", mode: 384 });
+    import_node_fs.default.renameSync(tmpPath, filePath);
+  } catch (err) {
+    try {
+      import_node_fs.default.unlinkSync(tmpPath);
+    } catch {
+    }
+    throw err;
+  }
   import_node_fs.default.chmodSync(filePath, 384);
 }
 function saveProfile(name, profile) {
   const existing = readCredentials();
+  if (!existing && import_node_fs.default.existsSync(getCredentialsPath())) {
+    try {
+      import_node_fs.default.renameSync(getCredentialsPath(), `${getCredentialsPath()}.corrupt`);
+    } catch {
+    }
+  }
   const creds = existing ?? { activeProfile: name, profiles: {} };
   creds.profiles[name] = profile;
   creds.activeProfile = name;
@@ -1608,7 +1724,9 @@ function red(text) {
 }
 function detectOutputMode(options) {
   if (options.quiet) return "quiet";
-  if (options.json || !process.stdout.isTTY) return "json";
+  if (options.format === "json" || options.json) return "json";
+  if (options.format === "table") return "tty";
+  if (!process.stdout.isTTY) return "json";
   return "tty";
 }
 function formatOutput(data, mode) {
@@ -1741,12 +1859,18 @@ function matchesClass(error, className) {
   return false;
 }
 function exitCodeFromError(error) {
+  const attached = error?.exitCode;
+  if (typeof attached === "number" && Number.isInteger(attached) && attached >= 0) {
+    return attached;
+  }
   if (matchesClass(error, "AuthenticationError")) return EXIT_CODES.AUTH_ERROR;
   if (matchesClass(error, "ScopeError")) return EXIT_CODES.SCOPE_ERROR;
   if (matchesClass(error, "NotFoundError")) return EXIT_CODES.NOT_FOUND;
   if (matchesClass(error, "RateLimitError")) return EXIT_CODES.RATE_LIMITED;
   if (matchesClass(error, "ValidationError")) return EXIT_CODES.VALIDATION_ERROR;
   if (matchesClass(error, "NetworkError")) return EXIT_CODES.NETWORK_ERROR;
+  const code = error?.code;
+  if (code === "NETWORK_ERROR" || code === "TIMEOUT") return EXIT_CODES.NETWORK_ERROR;
   return EXIT_CODES.GENERAL_ERROR;
 }
 
@@ -1767,7 +1891,7 @@ function createAgentsCommand() {
       const client = new Autoposting({ apiKey: cred.apiKey });
       const list = await client.agents.list();
       spinner.stop();
-      const rows = list.map((a) => ({
+      const rows = list.items.map((a) => ({
         id: a.id,
         name: a.name,
         type: a.type,
@@ -1876,9 +2000,9 @@ function createAgentsCommand() {
     try {
       const cred = resolveAuth({ apiKey: globals.apiKey });
       const client = new Autoposting({ apiKey: cred.apiKey });
-      const agentRun = await client.agents.run(id);
+      const queued = await client.agents.run(id);
       spinner.stop();
-      printer.log(agentRun);
+      printer.log({ runId: queued.runId, status: queued.status });
     } catch (err) {
       spinner.stop();
       printer.error(err);
@@ -1910,7 +2034,7 @@ function createAgentsCommand() {
       const client = new Autoposting({ apiKey: cred.apiKey });
       const list = await client.agents.runs(id);
       spinner.stop();
-      const rows = list.map((r) => ({
+      const rows = list.items.map((r) => ({
         id: r.id,
         status: r.status,
         output: r.output ? r.output.length > 60 ? `${r.output.slice(0, 57)}\u2026` : r.output : "\u2014",
@@ -1931,8 +2055,32 @@ var import_commander2 = require("commander");
 var import_node_child_process = require("child_process");
 
 // src/auth/device-code-client.ts
+async function fetchWithTimeout(url, init = {}, timeoutMs = 3e4) {
+  const controller = new AbortController();
+  const timer = setTimeout(() => controller.abort(), timeoutMs);
+  try {
+    return await fetch(url, { ...init, signal: controller.signal });
+  } catch (err) {
+    if (err instanceof Error && err.name === "AbortError") {
+      throw new Error(`Request to ${url} timed out after ${timeoutMs}ms`);
+    }
+    throw err;
+  } finally {
+    clearTimeout(timer);
+  }
+}
+async function parseJson(res) {
+  const text = await res.text();
+  try {
+    return JSON.parse(text);
+  } catch {
+    throw new Error(
+      `Expected a JSON response (HTTP ${res.status}) but received non-JSON. Verify the API base URL points at the API, not the web app.`
+    );
+  }
+}
 async function requestDeviceCode(baseUrl) {
-  const res = await fetch(`${baseUrl}/auth/cli/device-code`, {
+  const res = await fetchWithTimeout(`${baseUrl}/auth/cli/device-code`, {
     method: "POST",
     headers: { "Content-Type": "application/json" }
   });
@@ -1940,22 +2088,20 @@ async function requestDeviceCode(baseUrl) {
     const text = await res.text().catch(() => res.statusText);
     throw new Error(`Device code request failed (${res.status}): ${text}`);
   }
-  const data = await res.json();
-  return data;
+  return parseJson(res);
 }
 async function pollDeviceCode(baseUrl, deviceCode) {
   const url = `${baseUrl}/auth/cli/poll?device_code=${encodeURIComponent(deviceCode)}`;
-  const res = await fetch(url);
+  const res = await fetchWithTimeout(url);
   if (!res.ok) {
     const text = await res.text().catch(() => res.statusText);
     throw new Error(`Poll request failed (${res.status}): ${text}`);
   }
-  const data = await res.json();
-  return data;
+  return parseJson(res);
 }
 
 // src/commands/auth.ts
-var DEFAULT_BASE_URL = "https://app.autoposting.ai";
+var DEFAULT_BASE_URL = "https://app.autoposting.ai/api-proxy";
 function resolveBaseUrl(globals) {
   return globals.baseUrl ?? process.env.AUTOPOSTING_BASE_URL ?? DEFAULT_BASE_URL;
 }
@@ -2129,14 +2275,16 @@ function createBillingCommand() {
       printer.table(
         [
           {
-            plan: status.plan,
-            status: status.status,
-            "trial ends": status.trialEndsAt ?? "\u2014",
-            "renewal date": status.renewalDate ?? "\u2014",
-            "cancels at": status.cancelAt ?? "\u2014"
+            plan: status.planName,
+            status: status.status ?? "\u2014",
+            cycle: status.billingCycle ?? "\u2014",
+            accounts: `${status.accountsUsed}/${status.accountLimit === -1 ? "\u221E" : status.accountLimit}`,
+            credits: status.creditBalance,
+            renews: status.currentPeriodEnd ?? "\u2014",
+            "trial ends": status.trialEnd ?? "\u2014"
           }
         ],
-        ["plan", "status", "trial ends", "renewal date", "cancels at"]
+        ["plan", "status", "cycle", "accounts", "credits", "renews", "trial ends"]
       );
     } catch (err) {
       spinner.stop();
@@ -2156,19 +2304,20 @@ function createBillingCommand() {
       printer.table(
         [
           {
-            total: credits.total,
-            used: credits.used,
-            remaining: credits.remaining
+            balance: credits.balanceFormatted,
+            "spent (30d)": credits.totalSpent30d
           }
         ],
-        ["total", "used", "remaining"]
+        ["balance", "spent (30d)"]
       );
-      if (credits.breakdown && Object.keys(credits.breakdown).length > 0) {
-        const breakdownRows = Object.entries(credits.breakdown).map(([key, val]) => ({
-          category: key,
-          credits: val
+      if (credits.recentUsage.length > 0) {
+        const usageRows = credits.recentUsage.map((e) => ({
+          date: e.date,
+          description: e.description,
+          amount: e.amount,
+          type: e.type
         }));
-        printer.table(breakdownRows, ["category", "credits"]);
+        printer.table(usageRows, ["date", "description", "amount", "type"]);
       }
     } catch (err) {
       spinner.stop();
@@ -2324,7 +2473,7 @@ function createCarouselsCommand() {
       const client = new Autoposting({ apiKey: cred.apiKey });
       const list = await client.carousels.list();
       spinner.stop();
-      const rows = list.map((c) => ({
+      const rows = list.items.map((c) => ({
         id: c.id,
         title: c.title ?? "\u2014",
         slides: c.slides.length,
@@ -2450,7 +2599,7 @@ function createClipsCommand() {
       const client = new Autoposting({ apiKey: cred.apiKey });
       const list = await client.clips.list();
       spinner.stop();
-      const rows = list.map((c) => ({
+      const rows = list.clips.map((c) => ({
         id: c.id,
         name: c.name,
         status: c.status,
@@ -2507,12 +2656,12 @@ function createClipsCommand() {
     try {
       const cred = resolveAuth({ apiKey: globals.apiKey });
       const client = new Autoposting({ apiKey: cred.apiKey });
-      const clip = await client.clips.importUrl({
+      const { clipId } = await client.clips.importUrl({
         url: opts.url,
         ...opts.name ? { name: opts.name } : {}
       });
       spinner.stop();
-      printer.log(clip);
+      printer.log({ clipId });
     } catch (err) {
       spinner.stop();
       printer.error(err);
@@ -2526,9 +2675,9 @@ function createClipsCommand() {
     try {
       const cred = resolveAuth({ apiKey: globals.apiKey });
       const client = new Autoposting({ apiKey: cred.apiKey });
-      const clip = await client.clips.render(id);
+      const { jobIds, activeJobIds, reusedJobIds } = await client.clips.render(id);
       spinner.stop();
-      printer.log(clip);
+      printer.log({ jobIds, activeJobIds, reusedJobIds });
     } catch (err) {
       spinner.stop();
       printer.error(err);
@@ -2561,8 +2710,34 @@ function createClipsCommand() {
 // src/commands/posts.ts
 var import_commander7 = require("commander");
 init_dist();
+var VALID_PLATFORMS = ["x", "linkedin", "instagram", "threads", "youtube"];
 function parsePlatforms(raw) {
-  return raw.split(",").map((p) => p.trim());
+  const parts = raw.split(",").map((p) => p.trim()).filter(Boolean);
+  if (parts.length === 0) {
+    throw new Error("No platforms provided. Pass a comma-separated list, e.g. --platforms x,linkedin");
+  }
+  const invalid = parts.filter((p) => !VALID_PLATFORMS.includes(p));
+  if (invalid.length > 0) {
+    throw new Error(
+      `Unsupported platform(s): ${invalid.join(", ")}. Valid platforms: ${VALID_PLATFORMS.join(", ")}`
+    );
+  }
+  return parts;
+}
+function parsePositiveInt(value, flag) {
+  const n = Number(value);
+  if (!Number.isInteger(n) || n < 1) {
+    throw new Error(`${flag} must be a positive integer (received "${value}").`);
+  }
+  return n;
+}
+function validateScheduledAt(value) {
+  if (Number.isNaN(Date.parse(value)) || !/^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}/.test(value)) {
+    throw new Error(
+      `--at must be a valid ISO 8601 datetime, e.g. 2026-06-30T14:00:00Z (received "${value}").`
+    );
+  }
+  return value;
 }
 function resolveExitCode5(err) {
   const attached = err.exitCode;
@@ -2581,11 +2756,11 @@ function createPostsCommand() {
       const result = await client.posts.list({
         brandSlug: opts.brand,
         status: opts.status,
-        limit: parseInt(opts.limit, 10),
-        page: parseInt(opts.page, 10)
+        limit: parsePositiveInt(opts.limit, "--limit"),
+        page: parsePositiveInt(opts.page, "--page")
       });
       spinner.stop();
-      const rows = result.data.map((p) => ({
+      const rows = result.map((p) => ({
         id: p.id,
         brand: p.brandSlug,
         status: p.status,
@@ -2616,7 +2791,10 @@ function createPostsCommand() {
       process.exit(resolveExitCode5(err));
     }
   });
-  posts.command("create").description("Create a new post").requiredOption("--brand <slug>", "Brand slug").requiredOption("--text <text>", "Post text content").requiredOption("--platforms <list>", "Comma-separated platforms (e.g. x,linkedin)").option("--at <iso>", "Schedule date/time (ISO 8601)").action(
+  posts.command("create").description("Create a new post").requiredOption("--brand <slug>", "Brand slug").requiredOption("--text <text>", "Post text content").requiredOption("--platforms <list>", "Comma-separated platforms (e.g. x,linkedin)").option("--at <iso>", "Schedule date/time (ISO 8601)").option(
+    "--thread <text...>",
+    "Additional posts appended after --text to form a thread (X/Threads only, max 25)"
+  ).action(
     async (opts, cmd) => {
       const globals = cmd.optsWithGlobals();
       const printer = createPrinter(globals);
@@ -2628,7 +2806,8 @@ function createPostsCommand() {
           brandSlug: opts.brand,
           text: opts.text,
           platforms: parsePlatforms(opts.platforms),
-          ...opts.at ? { scheduledAt: opts.at } : {}
+          ...opts.at ? { scheduledAt: validateScheduledAt(opts.at) } : {},
+          ...opts.thread && opts.thread.length > 0 ? { thread: opts.thread } : {}
         });
         spinner.stop();
         printer.log(post);
@@ -2650,7 +2829,7 @@ function createPostsCommand() {
         const post = await client.posts.update(id, {
           ...opts.text ? { text: opts.text } : {},
           ...opts.platforms ? { platforms: parsePlatforms(opts.platforms) } : {},
-          ...opts.at ? { scheduledAt: opts.at } : {}
+          ...opts.at ? { scheduledAt: validateScheduledAt(opts.at) } : {}
         });
         spinner.stop();
         printer.log(post);
@@ -2704,7 +2883,7 @@ function createPostsCommand() {
     try {
       const cred = resolveAuth({ apiKey: globals.apiKey });
       const client = new Autoposting({ apiKey: cred.apiKey });
-      const post = await client.posts.schedule(id, opts.at);
+      const post = await client.posts.schedule(id, validateScheduledAt(opts.at));
       spinner.stop();
       printer.log(post);
     } catch (err) {
@@ -2855,14 +3034,15 @@ function createKbCommand() {
     try {
       const cred = resolveAuth({ apiKey: globals.apiKey });
       const client = new Autoposting({ apiKey: cred.apiKey });
-      const results = await client.kb.search(id, opts.query);
+      const res = await client.kb.search(id, opts.query);
       spinner.stop();
-      const rows = results.map((r) => ({
-        docId: r.docId,
-        score: r.score.toFixed(3),
+      const rows = res.results.map((r) => ({
+        kind: r.kind,
+        score: r.score != null ? r.score.toFixed(3) : "\u2014",
+        uri: r.uri ?? "\u2014",
         content: r.content.length > 80 ? `${r.content.slice(0, 77)}\u2026` : r.content
       }));
-      printer.table(rows, ["docId", "score", "content"]);
+      printer.table(rows, ["kind", "score", "uri", "content"]);
     } catch (err) {
       spinner.stop();
       printer.error(err);
@@ -2919,6 +3099,23 @@ function resolveExitCode7(err) {
   if (typeof attached === "number") return attached;
   return exitCodeFromError(err);
 }
+var VALID_IDEA_PLATFORMS = ["twitter", "linkedin", "instagram", "youtube", "threads"];
+function parseIdeaPlatforms(raw) {
+  const parts = raw.split(",").map((p) => p.trim()).filter(Boolean);
+  if (parts.length === 0) {
+    throw new Error("No platforms provided. e.g. --platforms twitter,linkedin");
+  }
+  if (parts.length > 5) {
+    throw new Error("At most 5 platforms allowed per enrichment request.");
+  }
+  const invalid = parts.filter((p) => !VALID_IDEA_PLATFORMS.includes(p));
+  if (invalid.length > 0) {
+    throw new Error(
+      `Unsupported platform(s): ${invalid.join(", ")}. Valid: ${VALID_IDEA_PLATFORMS.join(", ")}`
+    );
+  }
+  return parts.map((platform) => ({ platform }));
+}
 function createIdeasCommand() {
   const ideas = new import_commander9.Command("ideas").description("Manage content ideas");
   ideas.command("generate").description("Generate content ideas").option("--kb <id>", "Knowledge base ID to draw context from").option("--topic <text>", "Topic or theme for ideas").option("--count <n>", "Number of ideas to generate", "5").action(async (opts, cmd) => {
@@ -2934,13 +3131,13 @@ function createIdeasCommand() {
         count: parseInt(opts.count, 10)
       });
       spinner.stop();
-      const rows = result.map((i) => ({
-        id: i.id,
-        topic: i.topic ?? "\u2014",
-        enriched: i.enriched ? "yes" : "no",
-        text: i.text.length > 80 ? `${i.text.slice(0, 77)}\u2026` : i.text
+      const rows = (result.ideas ?? []).map((i) => ({
+        id: i.id ?? "\u2014",
+        platform: i.targetPlatform,
+        score: i.viralityScore,
+        title: i.title.length > 80 ? `${i.title.slice(0, 77)}\u2026` : i.title
       }));
-      printer.table(rows, ["id", "topic", "enriched", "text"]);
+      printer.table(rows, ["id", "platform", "score", "title"]);
     } catch (err) {
       spinner.stop();
       printer.error(err);
@@ -2956,36 +3153,43 @@ function createIdeasCommand() {
       const client = new Autoposting({ apiKey: cred.apiKey });
       const list = await client.ideas.list();
       spinner.stop();
-      const rows = list.map((i) => ({
+      const rows = list.items.map((i) => ({
         id: i.id,
-        topic: i.topic ?? "\u2014",
-        enriched: i.enriched ? "yes" : "no",
-        text: i.text.length > 80 ? `${i.text.slice(0, 77)}\u2026` : i.text,
-        createdAt: i.createdAt
+        topic: i.topic || "\u2014",
+        platform: i.targetPlatform,
+        score: i.viralityScore,
+        status: i.status,
+        title: i.title.length > 60 ? `${i.title.slice(0, 57)}\u2026` : i.title
       }));
-      printer.table(rows, ["id", "topic", "enriched", "text", "createdAt"]);
+      printer.table(rows, ["id", "topic", "platform", "score", "status", "title"]);
     } catch (err) {
       spinner.stop();
       printer.error(err);
       process.exit(resolveExitCode7(err));
     }
   });
-  ideas.command("enrich <id>").description("Enrich an idea with AI context").action(async (id, _opts, cmd) => {
-    const globals = cmd.optsWithGlobals();
-    const printer = createPrinter(globals);
-    const spinner = printer.spinner(`Enriching idea "${id}"\u2026`);
-    try {
-      const cred = resolveAuth({ apiKey: globals.apiKey });
-      const client = new Autoposting({ apiKey: cred.apiKey });
-      const idea = await client.ideas.enrich(id);
-      spinner.stop();
-      printer.log(idea);
-    } catch (err) {
-      spinner.stop();
-      printer.error(err);
-      process.exit(resolveExitCode7(err));
+  ideas.command("enrich").description("Enrich an idea into platform-ready drafts (async; returns a job ID)").requiredOption("--title <text>", "Idea title").requiredOption("--hook <text>", "Idea hook").requiredOption("--angle <text>", "Idea angle").requiredOption("--platforms <list>", `Comma-separated platforms (${VALID_IDEA_PLATFORMS.join(",")})`).option("--kb <id>", "Knowledge base ID for additional context").action(
+    async (opts, cmd) => {
+      const globals = cmd.optsWithGlobals();
+      const printer = createPrinter(globals);
+      const spinner = printer.spinner("Queuing enrichment\u2026");
+      try {
+        const cred = resolveAuth({ apiKey: globals.apiKey });
+        const client = new Autoposting({ apiKey: cred.apiKey });
+        const { jobId } = await client.ideas.enrich({
+          idea: { title: opts.title, hook: opts.hook, angle: opts.angle },
+          platforms: parseIdeaPlatforms(opts.platforms),
+          ...opts.kb ? { kbId: opts.kb } : {}
+        });
+        spinner.stop();
+        printer.log(`Enrichment queued. Job ID: ${jobId}`);
+      } catch (err) {
+        spinner.stop();
+        printer.error(err);
+        process.exit(resolveExitCode7(err));
+      }
     }
-  });
+  );
   ideas.command("delete <id>").description("Delete an idea (requires --force)").option("--force", "Confirm deletion without interactive prompt").action(async (id, opts, cmd) => {
     const globals = cmd.optsWithGlobals();
     const printer = createPrinter(globals);
@@ -3028,18 +3232,25 @@ function createUsageCommand() {
       const client = new Autoposting({ apiKey: cred.apiKey });
       const summary = await client.usage.summary();
       spinner.stop();
-      const rows = Object.entries(summary.platforms).map(([platform, stats]) => ({
-        platform,
-        posts: stats.posts,
-        published: stats.published,
-        failed: stats.failed
+      printer.log(`Period: ${summary.range.from.slice(0, 10)} \u2192 ${summary.range.to.slice(0, 10)}`);
+      printer.table(
+        [
+          {
+            posts: summary.posts.total,
+            published: summary.posts.published,
+            agents: summary.agents.total,
+            "active agents": summary.agents.active,
+            "ai cost (usd)": summary.ai.totalCostUsd,
+            "ai requests": summary.ai.requests
+          }
+        ],
+        ["posts", "published", "agents", "active agents", "ai cost (usd)", "ai requests"]
+      );
+      const sourceRows = Object.entries(summary.posts.bySource).map(([source, count]) => ({
+        source,
+        posts: count
       }));
-      if (rows.length === 0) {
-        printer.log(`No usage data for period: ${summary.period}`);
-      } else {
-        printer.log(`Period: ${summary.period}`);
-        printer.table(rows, ["platform", "posts", "published", "failed"]);
-      }
+      printer.table(sourceRows, ["source", "posts"]);
     } catch (err) {
       spinner.stop();
       printer.error(err);
@@ -3169,9 +3380,11 @@ function createWebhooksCommand() {
     try {
       const cred = resolveAuth({ apiKey: globals.apiKey });
       const client = new Autoposting({ apiKey: cred.apiKey });
-      await client.webhooks.test(id);
+      const result = await client.webhooks.test(id);
       spinner.stop();
-      printer.log(`Test event sent to webhook "${id}".`);
+      printer.log(
+        `Test event sent to webhook "${id}" \u2014 delivered: ${result.delivered ? "yes" : "no"} (HTTP ${result.httpStatus}).`
+      );
     } catch (err) {
       spinner.stop();
       printer.error(err);
@@ -3198,13 +3411,13 @@ function createWorkspacesCommand() {
     try {
       const cred = resolveAuth({ apiKey: globals.apiKey });
       const client = new Autoposting({ apiKey: cred.apiKey });
-      const list = await client.workspaces.list();
+      const res = await client.workspaces.list();
       spinner.stop();
-      const rows = list.map((w) => ({
+      const rows = res.organizations.map((w) => ({
         id: w.id,
         name: w.name,
         slug: w.slug,
-        active: w.isActive ? "yes" : "no",
+        active: w.id === res.activeOrgId ? "yes" : "no",
         createdAt: w.createdAt
       }));
       printer.table(rows, ["id", "name", "slug", "active", "createdAt"]);
@@ -3238,7 +3451,7 @@ function createWorkspacesCommand() {
 var import_commander13 = require("commander");
 init_dist();
 var import_node_fs2 = __toESM(require("fs"));
-var API_HEALTH_URL = "https://app.autoposting.ai/api/health";
+var API_HEALTH_URL = "https://app.autoposting.ai/api-proxy/health";
 async function runChecks() {
   const results = [];
   results.push({ name: "CLI Version", status: "pass", value: VERSION });
@@ -3251,7 +3464,7 @@ async function runChecks() {
   });
   try {
     resolveAuth();
-    results.push({ name: "Auth", status: "pass", value: "authenticated" });
+    results.push({ name: "Auth", status: "pass", value: "credentials configured" });
   } catch {
     results.push({ name: "Auth", status: "fail", value: "not configured" });
   }
@@ -3309,39 +3522,55 @@ function createDoctorCommand() {
 
 // src/commands/whoami.ts
 var import_commander14 = require("commander");
+init_dist();
 function createWhoamiCommand() {
-  return new import_commander14.Command("whoami").description("Show current authentication identity (alias for `auth whoami`)").action((_opts, cmd) => {
+  return new import_commander14.Command("whoami").description("Show the current identity and validate the key against the server").action(async (_opts, cmd) => {
+    const globals = cmd.optsWithGlobals();
+    let cred;
     try {
-      const globals = cmd.optsWithGlobals();
-      const cred = resolveAuth({ apiKey: globals.apiKey });
-      const masked = `${cred.apiKey.slice(0, 8)}${"*".repeat(Math.max(0, cred.apiKey.length - 8))}`;
-      if (globals.json) {
-        const out = { source: cred.source, apiKey: masked };
-        if (cred.source === "stored") {
-          const creds = readCredentials();
-          const profileName = creds?.activeProfile ?? "unknown";
-          const profile = creds?.profiles[profileName];
-          out.profile = profileName;
-          if (profile?.workspace) out.workspace = profile.workspace;
-          if (profile?.email) out.email = profile.email;
-        }
-        console.log(JSON.stringify(out, null, 2));
-        return;
-      }
-      console.log(`Source:  ${cred.source}`);
-      if (cred.source === "stored") {
-        const creds = readCredentials();
-        const profileName = creds?.activeProfile ?? "unknown";
-        const profile = creds?.profiles[profileName];
-        console.log(`Profile: ${profileName}`);
-        if (profile?.workspace) console.log(`Workspace: ${profile.workspace}`);
-        if (profile?.email) console.log(`Email:     ${profile.email}`);
-      }
-      console.log(`API key: ${masked}`);
+      cred = resolveAuth({ apiKey: globals.apiKey });
     } catch (err) {
       console.error(`Error: ${err.message}`);
-      process.exit(2);
+      process.exitCode = exitCodeFromError(err);
+      return;
+    }
+    const masked = `${cred.apiKey.slice(0, 8)}${"*".repeat(Math.max(0, cred.apiKey.length - 8))}`;
+    let validity = "unverified";
+    try {
+      const client = new Autoposting({ apiKey: cred.apiKey });
+      await client.usage.summary();
+      validity = "valid";
+    } catch (err) {
+      const code = exitCodeFromError(err);
+      validity = code === EXIT_CODES.AUTH_ERROR || code === EXIT_CODES.SCOPE_ERROR ? "rejected" : "unverified";
+    }
+    const exitCode = validity === "rejected" ? EXIT_CODES.AUTH_ERROR : 0;
+    const creds = cred.source === "stored" ? readCredentials() : void 0;
+    const profileName = creds?.activeProfile ?? "unknown";
+    const email = creds?.profiles[profileName]?.email;
+    if (globals.json) {
+      const out = {
+        source: cred.source,
+        apiKey: masked,
+        valid: validity === "valid",
+        validity
+      };
+      if (cred.source === "stored") {
+        out.profile = profileName;
+        if (email) out.email = email;
+      }
+      console.log(JSON.stringify(out, null, 2));
+      process.exitCode = exitCode;
+      return;
+    }
+    console.log(`Source:  ${cred.source}`);
+    if (cred.source === "stored") {
+      console.log(`Profile: ${profileName}`);
+      if (email) console.log(`Email:   ${email}`);
     }
+    const tag = validity === "valid" ? "\u2713 valid" : validity === "rejected" ? "\u2717 rejected by server" : "\u26A0 unverified (could not reach server)";
+    console.log(`API key: ${masked}  ${tag}`);
+    process.exitCode = exitCode;
   });
 }