@aicopycoders/exodus 2026.7.200-beta.9 → 2026.8.1100

package/dist/commands/session.js

@@ -0,0 +1,202 @@
+import { apiGet, apiPostDashboard } from "../lib/client.js";
+import { formatError } from "../lib/format.js";
+import { getChannel } from "../lib/channel.js";
+import { missingRouteLine } from "../lib/route-support.js";
+export const helpText = `
+exodus session — Inspect and continue workflow chat sessions
+
+Usage:
+  exodus session list [--json]
+  exodus session show <sessionId> [--json]
+  exodus session chat <sessionId> "message" [--json]
+
+Flags:
+  --json                 Machine-readable JSON output (the raw API response)
+
+Notes:
+  Sessions are born from workflow runs whose bots run in session-mode — you do
+  not create them here. "session list" shows the sessions on the active brand;
+  "session show" prints a session's turns (system rows are hidden in the human
+  view but kept in --json); "session chat" appends your message and prints the
+  assistant's reply. The chat route can take up to ~5 minutes to answer.
+
+Examples:
+  exodus session list
+  exodus session show sess_123
+  exodus session chat sess_123 "make the hook punchier"
+`.trim();
+const SESSIONS_PATH = "/api/v2/sessions";
+const SESSION_SHOW_PATH = "/api/v2/sessions/show";
+const CHAT_PATH = "/api/sessions/chat";
+const CHAT_TIMEOUT_MS = 320_000;
+const defaultDeps = {
+    get: (path) => apiGet(path),
+    postDashboard: (path, body, opts) => apiPostDashboard(path, body, opts),
+    channel: getChannel(),
+};
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+export function shortId(id) {
+    return id.length <= 12 ? id : `${id.slice(0, 11)}…`;
+}
+export function formatAge(value, now = Date.now()) {
+    if (value === undefined || value === null)
+        return "-";
+    const t = typeof value === "number" ? value : Date.parse(value);
+    if (Number.isNaN(t))
+        return "-";
+    const sec = Math.max(0, Math.floor((now - t) / 1000));
+    if (sec < 60)
+        return `${sec}s`;
+    const min = Math.floor(sec / 60);
+    if (min < 60)
+        return `${min}m`;
+    const hr = Math.floor(min / 60);
+    if (hr < 24)
+        return `${hr}h`;
+    return `${Math.floor(hr / 24)}d`;
+}
+function table(headers, rows) {
+    const widths = headers.map((h, i) => Math.max(h.length, ...rows.map((row) => row[i]?.length ?? 0)));
+    const fmt = (row) => row.map((cell, i) => cell.padEnd(widths[i])).join("  ").trimEnd();
+    return [fmt(headers), fmt(headers.map((h) => "-".repeat(h.length))), ...rows.map(fmt)].join("\n");
+}
+const NO_SESSIONS = "No sessions yet. Sessions are born from workflow runs whose bots run in session-mode.";
+export function formatSessionList(sessions, now = Date.now()) {
+    if (sessions.length === 0)
+        return NO_SESSIONS;
+    return table(["id", "title", "bot", "run", "age"], sessions.map((s) => [
+        shortId(s._id),
+        s.title || "(untitled)",
+        s.botSlug,
+        s.runId ? shortId(s.runId) : "-",
+        formatAge(s.lastTouchedAt, now),
+    ]));
+}
+export function formatSessionShow(data) {
+    const s = data.session;
+    const lines = [];
+    lines.push(`Session — ${s.title || "(untitled)"}`);
+    lines.push(`sessionId:  ${s._id}`);
+    lines.push(`bot:        ${s.botSlug}`);
+    lines.push(`run:        ${s.runId ?? "-"}`);
+    const turns = (data.messages ?? []).filter((m) => m.role !== "system");
+    lines.push("");
+    if (turns.length === 0) {
+        lines.push("(no messages yet)");
+    }
+    else {
+        for (const m of turns)
+            lines.push(`${m.role}: ${m.body}`);
+    }
+    return lines.join("\n");
+}
+function routeErrorText(data, status) {
+    if (isRecord(data)) {
+        const err = data.error;
+        if (typeof err === "string" && err)
+            return err;
+        if (isRecord(err) && typeof err.message === "string")
+            return err.message;
+        if (typeof data.message === "string" && data.message)
+            return data.message;
+    }
+    return `HTTP ${status}`;
+}
+function apiErrorResult(res, verb, json, channel) {
+    const missing = missingRouteLine(res, verb, channel);
+    if (missing) {
+        return {
+            code: 1,
+            lines: json
+                ? [JSON.stringify({ ok: false, status: res.status, error: missing })]
+                : [missing],
+        };
+    }
+    return {
+        code: 1,
+        lines: json
+            ? [JSON.stringify({ ok: false, status: res.status, data: res.data })]
+            : [formatError(res)],
+    };
+}
+export async function listFlow(json, deps) {
+    const res = await deps.get(SESSIONS_PATH);
+    if (!res.ok)
+        return apiErrorResult(res, "session list", json, deps.channel);
+    const data = res.data;
+    return {
+        code: 0,
+        lines: json ? [JSON.stringify(data)] : [formatSessionList(data.sessions ?? [])],
+    };
+}
+export async function showFlow(sessionId, opts, deps) {
+    const res = await deps.get(`${SESSION_SHOW_PATH}?sessionId=${encodeURIComponent(sessionId)}`);
+    if (!res.ok)
+        return apiErrorResult(res, "session show", opts.json, deps.channel);
+    const data = res.data;
+    return {
+        code: 0,
+        lines: opts.json ? [JSON.stringify(data)] : [formatSessionShow(data)],
+    };
+}
+export async function chatFlow(sessionId, message, opts, deps) {
+    const res = await deps.postDashboard(CHAT_PATH, { sessionId, text: message }, { timeoutMs: CHAT_TIMEOUT_MS });
+    if (!res.ok) {
+        const err = routeErrorText(res.data, res.status);
+        return {
+            code: 1,
+            lines: opts.json
+                ? [JSON.stringify({ ok: false, status: res.status, error: err })]
+                : [`exodus session chat: ${err} (HTTP ${res.status})`],
+        };
+    }
+    const data = res.data;
+    return {
+        code: 0,
+        lines: opts.json ? [JSON.stringify(data)] : [data.reply ?? ""],
+    };
+}
+function parsePositional(args = process.argv.slice(3)) {
+    return args.filter((a) => !a.startsWith("--"));
+}
+async function printResult(result) {
+    for (const line of result.lines)
+        console.log(line);
+    if (result.code !== 0)
+        process.exit(result.code);
+}
+export async function run(flags) {
+    const positional = parsePositional();
+    const [sub, ...rest] = positional;
+    const json = !!flags["json"];
+    if (!sub) {
+        console.log(helpText);
+        return;
+    }
+    if (sub === "list")
+        return printResult(await listFlow(json, defaultDeps));
+    if (sub === "show") {
+        const sessionId = rest[0];
+        if (!sessionId) {
+            console.error("Error: session show requires <sessionId>.");
+            console.log("Usage: exodus session show <sessionId> [--json]");
+            process.exit(1);
+        }
+        return printResult(await showFlow(sessionId, { json }, defaultDeps));
+    }
+    if (sub === "chat") {
+        const sessionId = rest[0];
+        const message = rest[1];
+        if (!sessionId || !message) {
+            console.error('Error: session chat requires <sessionId> and a "message".');
+            console.log('Usage: exodus session chat <sessionId> "message" [--json]');
+            process.exit(1);
+        }
+        return printResult(await chatFlow(sessionId, message, { json }, defaultDeps));
+    }
+    console.error(`Unknown subcommand: "${sub}"\n`);
+    console.log(helpText);
+    process.exit(1);
+}

package/dist/commands/status.js

@@ -1,5 +1,5 @@
 import { apiGet } from "../lib/client.js";
-import { formatGeneration, formatGenesisRun, formatError } from "../lib/format.js";
+import { formatGeneration, formatGenesisRun, formatError, displayRunStatus } from "../lib/format.js";
 import { hydrateScoutIdeasCount } from "../lib/scout-hydrate.js";
 import { formatIntelResult as formatIntelResultRich } from "../lib/intel-format.js";
 export const helpText = `
@@ -31,7 +31,7 @@ export function formatIntelResult(data) {
 export function formatPulseResult(data) {
     const lines = [];
     lines.push("## Pulse Status");
-    lines.push(`**Status:** ${data["status"] ?? "unknown"}`);
+    lines.push(`**Status:** ${displayRunStatus(data["status"])}`);
     if (data["accountId"])
         lines.push(`**Account ID:** ${data["accountId"]}`);
     if (data["commentsAnalyzed"] !== undefined)
@@ -61,7 +61,7 @@ export function formatPulseResult(data) {
 export function formatScoutResult(data) {
     const lines = [];
     lines.push("## Scout Status");
-    lines.push(`**Status:** ${data["status"] ?? "unknown"}`);
+    lines.push(`**Status:** ${displayRunStatus(data["status"])}`);
     const pipelineSlug = data["pipelineSlug"];
     if (pipelineSlug)
         lines.push(`**Pipeline:** ${pipelineSlug}`);
@@ -123,7 +123,7 @@ export function formatScoutResult(data) {
 export function formatCreativeSuiteStatus(title, data) {
     const lines = [];
     lines.push(`## ${title}`);
-    lines.push(`**Status:** ${data["status"] ?? "unknown"}`);
+    lines.push(`**Status:** ${displayRunStatus(data["status"])}`);
     const show = (label, key) => {
         const v = data[key];
         if (v !== undefined && v !== null && v !== "")

package/dist/commands/swipe.js

@@ -1,6 +1,6 @@
 import fs from "node:fs";
 import { apiGet, apiPost } from "../lib/client.js";
-import { formatError } from "../lib/format.js";
+import { displayRunStatus, formatError } from "../lib/format.js";
 export const helpText = `
 exodus swipe — Swipe pipeline lifecycle + competitor watchlist
 
@@ -121,7 +121,7 @@ async function runRunPipeline(flags) {
         return;
     }
     console.log(`Run started: ${res.data.runId}`);
-    console.log(`  status:        ${res.data.status ?? "selecting"}`);
+    console.log(`  status:        ${displayRunStatus(res.data.status, "Running")}`);
     if (res.data.triggerRunId)
         console.log(`  triggerRunId:  ${res.data.triggerRunId}`);
     console.log(`\nPoll:    exodus swipe status ${res.data.runId}`);
@@ -224,13 +224,13 @@ async function runHistory(flags) {
     for (const r of runs) {
         const when = r.startedAt ? new Date(r.startedAt).toLocaleString() : "?";
         const doc = r.docUrl ? `  doc=${r.docUrl}` : r.error ? `  error=${r.error}` : "";
-        console.log(`  ${r.runId}  ${r.status}  ads=${r.adsSelectedCount}  by=${r.triggeredBy}  ${when}${doc}`);
+        console.log(`  ${r.runId}  ${displayRunStatus(r.status, "—")}  ads=${r.adsSelectedCount}  by=${r.triggeredBy}  ${when}${doc}`);
     }
 }
 function printRunStatus(r) {
     console.log(`Run ${r.runId ?? "?"}`);
     console.log(`  brand:    ${r.targetBrandSlug ?? "?"}`);
-    console.log(`  status:   ${r.status ?? "?"}`);
+    console.log(`  status:   ${displayRunStatus(r.status, "?")}`);
     console.log(`  by:       ${r.triggeredBy ?? "?"}`);
     console.log(`  ads:      ${r.adsSelectedCount ?? 0}`);
     if (r.startedAt)

package/dist/commands/template.js

@@ -1,5 +1,5 @@
 import { apiGet, apiPost, apiPostDashboard, getDashboardUrl } from "../lib/client.js";
-import { formatError } from "../lib/format.js";
+import { displayRunStatus, formatError } from "../lib/format.js";
 import { AD_TYPES, AD_TYPE_NAMES, REPTILE_TRIGGERS, } from "../lib/template-constants.js";
 export const helpText = `
 exodus template — Fernando's Template pipeline (${AD_TYPES.length} AD_TYPES, resume)
@@ -225,7 +225,7 @@ async function runStatus(flags) {
     console.log(`runId:        ${d._id ?? runId}`);
     if (d.name)
         console.log(`name:         ${d.name}`);
-    console.log(`status:       ${d.status ?? "—"}`);
+    console.log(`status:       ${displayRunStatus(d.status, "—")}`);
     if (d.completedImageCount !== undefined || d.requestedImageCount !== undefined) {
         console.log(`progress:     ${d.completedImageCount ?? 0} / ${d.requestedImageCount ?? "?"} completed${d.failedImageCount ? `, ${d.failedImageCount} failed` : ""}`);
     }

package/dist/commands/update.d.ts

@@ -0,0 +1,2 @@
+export declare const helpText: string;
+export declare function run(flags: Record<string, string | boolean>): Promise<void>;

package/dist/commands/update.js

@@ -0,0 +1,20 @@
+import { getVersion } from "../lib/version.js";
+import { run as runInit } from "./init.js";
+export const helpText = `
+exodus update — refresh this workspace from the installed CLI (alias of init)
+
+Re-runs the init refresh: rewrites .claude/skills/, the workspace docs
+(CLAUDE.md, PIPELINES.md), and syncs brand folders from the package you
+invoked. Your .env, state/, and outputs are left untouched.
+
+Usage:
+  exodus update
+
+Note: the CLI itself updates because npx resolves your channel fresh on each
+run — so invoke this as \`npx @aicopycoders/exodus update\` (or @beta on the
+beta channel), not from a stale local install.
+`.trim();
+export async function run(flags) {
+    console.log(`Exodus ${getVersion()} — refreshing workspace scaffold…`);
+    await runInit(flags);
+}

package/dist/commands/winners.js

@@ -1,7 +1,7 @@
 import fs from "node:fs";
 import path from "node:path";
 import { apiGet, apiPost } from "../lib/client.js";
-import { formatError } from "../lib/format.js";
+import { displayRunStatus, formatError, tickerRunStatus } from "../lib/format.js";
 import { pollUntilDone } from "../lib/poll.js";
 export const helpText = `
 exodus winners — Import your own brand's winning ads as generative fuel
@@ -84,6 +84,11 @@ export function validatePackageLocally(pkg) {
         if ((typeof w.bodyText !== "string" || !w.bodyText.trim()) &&
             (typeof w.headline !== "string" || !w.headline.trim()))
             warnings.push(`${label}${id ? ` (${id})` : ""}: needs bodyText or headline`);
+        const assets = (w.assets ?? {});
+        const hasPoster = (typeof assets.posterPath === "string" && assets.posterPath.trim()) ||
+            (typeof assets.posterStorageId === "string" && assets.posterStorageId.trim());
+        if (w.format === "video" && !hasPoster)
+            warnings.push(`${label}${id ? ` (${id})` : ""}: video winner has no posterPath — it will show a blank placeholder in the gallery (grab the poster image via ads_get_ad_videos and attach it)`);
     });
     return { ok: errors.length === 0, errors, warnings, winnerCount };
 }
@@ -230,6 +235,11 @@ async function runImport(positional, flags) {
             ["videoPath", "videoStorageId"],
             ["posterPath", "posterStorageId"],
         ];
+        for (const [, idKey] of pairs) {
+            const existing = assets[idKey];
+            if (typeof existing === "string" && existing.trim())
+                swapped[idKey] = existing;
+        }
         for (const [pathKey, idKey] of pairs) {
             const rel = assets[pathKey];
             if (typeof rel !== "string" || !rel.trim())
@@ -280,7 +290,7 @@ async function runImport(positional, flags) {
             const status = typeof data.status === "string" ? data.status : "";
             if (!json && status && status !== lastStatus) {
                 lastStatus = status;
-                console.log(`  status: ${status}`);
+                console.log(`  status: ${tickerRunStatus(status)}`);
             }
         },
     });
@@ -333,7 +343,7 @@ async function uploadAsset(absPath, json) {
 }
 function printOutcomeTable(data) {
     const winners = data.winners ?? [];
-    console.log(`\nImport ${data.importId ?? "?"}: ${data.status ?? "?"}`);
+    console.log(`\nImport ${data.importId ?? "?"}: ${displayRunStatus(data.status, "?")}`);
     if (data.error)
         console.log(`  error: ${data.error}`);
     const created = winners.filter((w) => w.created === true).length;