@aicopycoders/exodus 2026.7.200-beta.12 → 2026.7.200-beta.13

package/README.md

@@ -0,0 +1,51 @@
+# @aicopycoders/exodus
+
+The Exodus CLI + Claude Code skills for the Copycoders ad pipeline. It drives the
+Genesis creative bots, workflows, banks, and image/meme pipelines against your
+brand — from your terminal and from Claude Code.
+
+You don't install it globally. Run it with `npx` from your workspace folder.
+
+## Quickstart
+
+```bash
+# 1. Scaffold (or refresh) the workspace in the current folder
+npx -y @aicopycoders/exodus@beta init
+```
+
+`init` creates the workspace (the `.claude/` skills, docs, and your brand
+subfolder) and prints the next steps. The `@beta` tag is the dev/preview channel;
+drop it (`@aicopycoders/exodus`) for the stable release channel.
+
+### Connect your account
+
+1. Open the Exodus dashboard → **Settings → Claude Code**.
+2. Copy the `.env` snippet it shows you (your `EXODUS_API_KEY` + dashboard URL)
+   and paste it into a `.env` file in your workspace folder.
+3. Pull your provider keys down so the local tools have them:
+
+   ```bash
+   npx -y @aicopycoders/exodus@beta keys pull
+   ```
+
+   This writes your dashboard provider + image keys into `.env` (it only upserts
+   those keys and preserves the rest of the file). Values are never printed.
+
+### Check everything is wired up
+
+```bash
+npx -y @aicopycoders/exodus@beta doctor
+```
+
+`doctor` diagnoses local and dashboard-side issues in one shot — keys, workspace
+health, CLI currency — and tells you exactly what to fix.
+
+## Where to go next
+
+- `npx -y @aicopycoders/exodus@beta --help` — the full command surface.
+- `npx -y @aicopycoders/exodus@beta workflow --help` — run, build, and automate
+  saved multi-node workflows; resolve gate/repair parks from the inbox; read
+  banks and promote winners.
+
+Inside Claude Code, just say **"exodus"** plus what you want
+("exodus, write me some ads") and the skills route the rest.

package/dist/commands/bank.d.ts

@@ -52,6 +52,7 @@ export interface BankPromoteBody {
 export interface BankPromoteResponse {
     entryId: string;
     bankName: string;
+    event?: string;
 }
 export interface FlowResult {
     code: number;

package/dist/commands/bank.js

@@ -1,6 +1,6 @@
 import fs from "node:fs";
 import { apiGet, apiPost } from "../lib/client.js";
-import { formatError } from "../lib/format.js";
+import { formatApiError } from "../lib/format.js";
 import { getChannel } from "../lib/channel.js";
 import { missingRouteLine } from "../lib/route-support.js";
 export const helpText = `
@@ -37,7 +37,7 @@ Examples:
   exodus bank list
   exodus bank show hooks
   exodus bank promote hooks "Stop scrolling — your knees will thank you"
-  exodus bank promote body --file winner.txt --awareness solutionProductAware
+  exodus bank promote body:solutionProductAware --file winner.txt --awareness solutionProductAware
   cat winner.txt | exodus bank promote hooks
   exodus bank promote hooks "..." --spend 4200 --roas 3.1 --ctr 1.8 --note "Q3 winner"
   exodus bank promote hooks "..." --run wr_123 --node bot-4
@@ -66,7 +66,7 @@ function asErrorResult(res, json) {
         code: 1,
         lines: json
             ? [JSON.stringify({ ok: false, status: res.status, data: res.data })]
-            : [formatError(res)],
+            : [formatApiError(res)],
     };
 }
 function table(headers, rows) {

package/dist/commands/keys.js

@@ -26,6 +26,7 @@ const PROVIDER_LABEL = {
     kie: "Kie.ai",
     imgflip: "Imgflip",
     scrapecreators: "ScrapeCreators",
+    apify: "Apify",
 };
 async function status() {
     let remote;

package/dist/commands/workflow.d.ts

@@ -63,6 +63,7 @@ export interface WorkflowImportResult {
     workflowId?: string;
     nodeCount: number;
     edgeCount: number;
+    triggers?: WorkflowTrigger[];
     unresolved: UnresolvedWorkflowRef[];
     warnings: string[];
 }
@@ -240,6 +241,11 @@ export type WorkflowArtifact = {
     type: "image";
     storageId: string;
     imageUrl?: string;
+} | {
+    type: "session";
+    sessionId: string;
+    label?: string;
+    port?: string;
 };
 export interface WorkflowRunOutput {
     nodeId: string;

package/dist/commands/workflow.js

@@ -1,6 +1,6 @@
 import fs from "node:fs";
 import { apiGet, apiGetText, apiPost, apiPostDashboard, getDashboardUrl, } from "../lib/client.js";
-import { formatError } from "../lib/format.js";
+import { formatApiError } from "../lib/format.js";
 import { pollUntilDone } from "../lib/poll.js";
 import { workflowToYaml, parseWorkflowText } from "../lib/workflowText.js";
 import { missingRouteLine } from "../lib/route-support.js";
@@ -207,7 +207,24 @@ function asErrorResult(res, json) {
         code: 1,
         lines: json
             ? [JSON.stringify({ ok: false, status: res.status, data: res.data })]
-            : [formatError(res)],
+            : [formatApiError(res)],
+    };
+}
+function resolveIdErrorResult(e, json) {
+    if (e instanceof WorkflowResolveError) {
+        return {
+            code: 1,
+            lines: json
+                ? [JSON.stringify({ ok: false, status: e.status, data: e.data })]
+                : [e.message],
+        };
+    }
+    const message = e instanceof Error ? e.message : String(e);
+    return {
+        code: 1,
+        lines: json
+            ? [JSON.stringify({ ok: false, status: 0, data: { error: { message } } })]
+            : [message],
     };
 }
 function isRecord(value) {
@@ -252,12 +269,26 @@ function outputLines(output) {
     if (output.type === "primer") {
         return [`    primer:${output.primerKind}: ${truncateText(output.text)}`];
     }
-    return [`    image: ${output.imageUrl ?? output.storageId}`];
+    if (output.type === "image") {
+        const url = output.imageUrl ?? output.storageId;
+        return url ? [`    image: ${url}`] : [];
+    }
+    return [];
 }
-function progressLine(node) {
+function progressLine(node, parked = false) {
     const err = node.error ? ` — error: ${node.error}` : "";
+    if (parked) {
+        return `  ⏸ ${node.nodeId} (${node.kind}) awaiting review`;
+    }
     return `  ${statusIcon(node.status)} ${node.nodeId} (${node.kind}) ${node.status}${err}`;
 }
+function gateParkedNodeId(status, pauseReason, pausedNodeId) {
+    if (status !== "awaiting-review")
+        return undefined;
+    if (pauseReason === "taste" || pauseReason === undefined)
+        return pausedNodeId;
+    return undefined;
+}
 export function formatPauseNotice(pauseReason, runId, dashboardUrl) {
     if (!pauseReason) {
         return [
@@ -398,6 +429,28 @@ export function formatImportSummary(result, mode = {}) {
         lines.push(`workflowId:  ${result.workflowId}`);
     lines.push(`nodes:       ${result.nodeCount}`);
     lines.push(`edges:       ${result.edgeCount}`);
+    if (result.triggers && result.triggers.length > 0) {
+        lines.push("");
+        const enabledCount = result.triggers.filter((t) => t.enabled).length;
+        lines.push(`Triggers (${result.triggers.length}):`);
+        for (const t of result.triggers) {
+            const detail = t.type === "event" ? `event (${t.event})` : `cron (${t.cron})`;
+            if (t.enabled) {
+                const fires = t.type === "event"
+                    ? t.event === "winner-promoted"
+                        ? "fires on every promote"
+                        : `fires on ${t.event}`
+                    : `fires on schedule ${t.cron}`;
+                lines.push(`  ⚠ ${detail} — ENABLED, ${fires}`);
+            }
+            else {
+                lines.push(`  ${detail} — disabled`);
+            }
+        }
+        if (enabledCount > 0) {
+            lines.push(`  ⚠ ${enabledCount} enabled trigger${enabledCount === 1 ? "" : "s"} armed — a background run may start on the owner's keys. Disable with: exodus workflow triggers <id> disable <n>`);
+        }
+    }
     if (result.unresolved.length > 0) {
         lines.push("");
         lines.push(`Unresolved references (${result.unresolved.length}):`);
@@ -430,11 +483,12 @@ export function formatWorkflowRun(run) {
         const inputs = Object.entries(run.inputs).map(([k, v]) => `${k}=${v}`).join(", ");
         lines.push(`inputs:       ${inputs}`);
     }
+    const parkedNodeId = gateParkedNodeId(run.status, run.pauseReason, run.pausedNodeId);
     if (run.nodes.length > 0) {
         lines.push("");
         lines.push(`Nodes (${run.nodes.length}):`);
         for (const node of run.nodes) {
-            lines.push(progressLine(node));
+            lines.push(progressLine(node, parkedNodeId !== undefined && node.nodeId === parkedNodeId));
             for (const output of node.outputs)
                 lines.push(...outputLines(output));
         }
@@ -442,8 +496,9 @@ export function formatWorkflowRun(run) {
     if (run.outputs && run.outputs.length > 0) {
         lines.push("");
         lines.push(`Outputs (${run.outputs.length}):`);
-        for (const output of run.outputs)
-            lines.push(...runOutputLines(output));
+        for (const output of run.outputs) {
+            lines.push(...runOutputLines(output, parkedNodeId !== undefined && output.nodeId === parkedNodeId));
+        }
     }
     if (run.sessions && run.sessions.length > 0) {
         lines.push("");
@@ -454,30 +509,31 @@ export function formatWorkflowRun(run) {
     }
     return lines.join("\n");
 }
-function runOutputLines(output) {
+function runOutputLines(output, awaitingReview = false) {
     const slug = output.botSlug ? ` (${output.botSlug})` : "";
+    const review = awaitingReview ? " — awaiting review, not yet approved" : "";
     if (output.type === "image") {
-        return [`  ${output.label} [image]${slug}: ${output.imageUrl ?? output.imageId ?? "(no url)"}`];
+        return [`  ${output.label} [image]${slug}: ${output.imageUrl ?? output.imageId ?? "(no url)"}${review}`];
     }
     if (output.type === "video") {
         const tag = output.final === true ? "final video" : "video";
-        return [`  ${output.label} [${tag}]${slug}: ${output.videoUrl ?? "(no url)"}`];
+        return [`  ${output.label} [${tag}]${slug}: ${output.videoUrl ?? "(no url)"}${review}`];
     }
     if (output.type === "audio") {
-        return [`  ${output.label} [audio]${slug}: ${output.audioUrl ?? "(no url)"}`];
+        return [`  ${output.label} [audio]${slug}: ${output.audioUrl ?? "(no url)"}${review}`];
     }
     if (output.type === "frames") {
         const n = output.frames?.length ?? 0;
-        return [`  ${output.label} [frames]${slug}: ${n} scene${n === 1 ? "" : "s"}`];
+        return [`  ${output.label} [frames]${slug}: ${n} scene${n === 1 ? "" : "s"}${review}`];
     }
     if (output.type === "storyboard") {
-        return [`  ${output.label} [storyboard]${slug}: use --json for the scene plan`];
+        return [`  ${output.label} [storyboard]${slug}: use --json for the scene plan${review}`];
     }
     const raw = output.text ?? "";
     const normalized = raw.replace(/\s+/g, " ").trim();
     const body = truncateText(raw, 400);
     const note = normalized.length > 400 ? "\n    (truncated — use --json for the full text)" : "";
-    return [`  ${output.label} [text]${slug}:`, `    ${body}${note}`];
+    return [`  ${output.label} [text]${slug}${review}:`, `    ${body}${note}`];
 }
 export function formatDescribe(res) {
     const lines = [];
@@ -812,15 +868,31 @@ function formatImportError(res) {
         lines.push(`fix: ${remedy}`);
         return lines.join("\n");
     }
-    return formatError(res);
+    return formatApiError(res);
+}
+class WorkflowResolveError extends Error {
+    status;
+    data;
+    constructor(status, data, message) {
+        super(message);
+        this.status = status;
+        this.data = data;
+        this.name = "WorkflowResolveError";
+    }
 }
 export async function resolveWorkflowId(ref, deps) {
     const res = await deps.get(LIST_PATH);
     if (!res.ok)
-        throw new Error(formatError(res));
+        throw new WorkflowResolveError(res.status, res.data, formatApiError(res));
     const workflows = res.data.workflows ?? [];
-    const match = workflows.find((w) => w.name.toLowerCase() === ref.toLowerCase());
-    return match?._id ?? ref;
+    const byName = workflows.find((w) => w.name.toLowerCase() === ref.toLowerCase());
+    if (byName)
+        return byName._id;
+    const byId = workflows.find((w) => w._id === ref);
+    if (byId)
+        return byId._id;
+    const message = `No workflow named "${ref}" on this brand — run: exodus workflow list`;
+    throw new WorkflowResolveError(404, { error: { code: "NOT_FOUND", message } }, message);
 }
 export async function listFlow(json, deps) {
     const res = await deps.get(LIST_PATH);
@@ -838,7 +910,7 @@ export async function describeFlow(workflowRef, opts, deps) {
         workflowId = await resolveWorkflowId(workflowRef, deps);
     }
     catch (e) {
-        return { code: 1, lines: [e instanceof Error ? e.message : String(e)] };
+        return resolveIdErrorResult(e, opts.json ?? false);
     }
     const res = await deps.get(`${DESCRIBE_PATH}?id=${encodeURIComponent(workflowId)}`);
     if (!res.ok)
@@ -872,7 +944,7 @@ export async function runFlow(workflowRef, opts, deps) {
         workflowId = await resolveWorkflowId(workflowRef, deps);
     }
     catch (e) {
-        return { code: 1, lines: [e instanceof Error ? e.message : String(e)] };
+        return resolveIdErrorResult(e, opts.json ?? false);
     }
     const body = {
         workflowId,
@@ -927,12 +999,15 @@ async function waitForRun(runId, opts, deps) {
                     opts.onProgressLine(line);
                 }
             }
+            const parkedNodeId = gateParkedNodeId(raw["status"], raw["pauseReason"], raw["pausedNodeId"]);
             const nodes = Array.isArray(raw["nodes"]) ? raw["nodes"] : [];
             for (const node of nodes) {
-                if (seen.get(node.nodeId) === node.status)
+                const isParked = parkedNodeId !== undefined && node.nodeId === parkedNodeId;
+                const renderKey = `${node.status}:${isParked}`;
+                if (seen.get(node.nodeId) === renderKey)
                     continue;
-                seen.set(node.nodeId, node.status);
-                opts.onProgressLine(progressLine(node));
+                seen.set(node.nodeId, renderKey);
+                opts.onProgressLine(progressLine(node, isParked));
             }
         },
     });
@@ -977,7 +1052,7 @@ export async function exportFlow(workflowRef, opts, deps) {
         workflowId = await resolveWorkflowId(workflowRef, deps);
     }
     catch (e) {
-        return { code: 1, lines: [e instanceof Error ? e.message : String(e)] };
+        return resolveIdErrorResult(e, opts.json ?? false);
     }
     const versionParam = opts.version !== undefined ? `&version=${encodeURIComponent(String(opts.version))}` : "";
     const res = await deps.get(`${EXPORT_PATH}?id=${encodeURIComponent(workflowId)}${versionParam}`);
@@ -1011,7 +1086,7 @@ export async function versionsFlow(workflowRef, opts, deps, channel = getChannel
         workflowId = await resolveWorkflowId(workflowRef, deps);
     }
     catch (e) {
-        return { code: 1, lines: [e instanceof Error ? e.message : String(e)] };
+        return resolveIdErrorResult(e, opts.json ?? false);
     }
     const res = await deps.get(`${VERSIONS_PATH}?id=${encodeURIComponent(workflowId)}`);
     const unsupported = missingRouteLine(res, "workflow versions", channel);
@@ -1148,7 +1223,7 @@ export async function triggersListFlow(workflowRef, opts, deps) {
         workflowId = await resolveWorkflowId(workflowRef, deps);
     }
     catch (e) {
-        return { code: 1, lines: [e instanceof Error ? e.message : String(e)] };
+        return resolveIdErrorResult(e, opts.json ?? false);
     }
     const fetched = await fetchTriggers(workflowId, deps);
     if (!fetched.ok)
@@ -1177,7 +1252,7 @@ export async function triggersSetEnabledFlow(workflowRef, n, enabled, opts, deps
         workflowId = await resolveWorkflowId(workflowRef, deps);
     }
     catch (e) {
-        return { code: 1, lines: [e instanceof Error ? e.message : String(e)] };
+        return resolveIdErrorResult(e, opts.json ?? false);
     }
     const fetched = await fetchTriggers(workflowId, deps);
     if (!fetched.ok)
@@ -1206,7 +1281,7 @@ export async function triggersFireFlow(workflowRef, opts, deps) {
         workflowId = await resolveWorkflowId(workflowRef, deps);
     }
     catch (e) {
-        return { code: 1, lines: [e instanceof Error ? e.message : String(e)] };
+        return resolveIdErrorResult(e, opts.json ?? false);
     }
     const fetched = await fetchTriggers(workflowId, deps);
     if (!fetched.ok)
@@ -1335,9 +1410,9 @@ function formatTextError(res) {
     }
     catch {
         const snippet = body.replace(/\s+/g, " ").trim().slice(0, 300);
-        return formatError({ ok: false, status: res.status, data: snippet || "(empty response)" });
+        return formatApiError({ ok: false, status: res.status, data: snippet || "(empty response)" });
     }
-    return formatError({ ok: false, status: res.status, data: parsed });
+    return formatApiError({ ok: false, status: res.status, data: parsed });
 }
 export async function schemaFlow(opts, deps) {
     const res = await deps.get(SCHEMA_PATH);
@@ -1358,9 +1433,6 @@ export async function schemaFlow(opts, deps) {
     }
     return { code: 0, lines: [formatSchema(payload)] };
 }
-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 "-";
@@ -1399,7 +1471,7 @@ export function formatInbox(rows, now = Date.now()) {
     if (rows.length === 0)
         return NO_INBOX;
     return table(["run", "workflow", "kind", "node", "via", "age"], rows.map((r) => [
-        shortId(r._id),
+        r._id,
         r.workflowName || "(unnamed)",
         parkBadge(r.pauseReason),
         r.pausedNodeId ?? "-",
@@ -1607,17 +1679,28 @@ export async function gateEditFlow(runId, n, sources, opts, deps) {
         return triggerErrorResult(res, "workflow gate edit", opts.json);
     return okLine(`Edited candidate ${n} at ${pf.run.pausedNodeId}.`, { ok: true, runId, nodeId: pf.run.pausedNodeId, outputIndex: cand.outputIndex }, opts.json);
 }
+function resolveGateSessionId(run) {
+    const gateNode = (run.nodes ?? []).find((x) => x.nodeId === run.pausedNodeId);
+    const artifact = (gateNode?.outputs ?? []).find((a) => a.type === "session" && a.port === "session" && !!a.sessionId);
+    if (artifact)
+        return artifact.sessionId;
+    const sessions = run.sessions ?? [];
+    const byNode = sessions.find((s) => s.nodeId === run.pausedNodeId);
+    if (byNode)
+        return byNode.sessionId;
+    return undefined;
+}
 export async function gatePushFlow(runId, message, opts, deps) {
     const pf = await preflightPark(runId, "taste", "workflow gate push", opts.json, deps);
     if (!pf.ok)
         return pf.result;
-    const session = (pf.run.sessions ?? []).find((s) => s.nodeId === pf.run.pausedNodeId);
-    if (!session)
+    const sessionId = resolveGateSessionId(pf.run);
+    if (!sessionId)
         return errLine("This gate has no live session — nothing to push to.", opts.json);
     if (!deps.postDashboard) {
         return errLine("gate push is unavailable here (no dashboard client).", opts.json);
     }
-    const chat = await deps.postDashboard(CHAT_PATH, { sessionId: session.sessionId, text: message }, { timeoutMs: CHAT_TIMEOUT_MS });
+    const chat = await deps.postDashboard(CHAT_PATH, { sessionId, text: message }, { timeoutMs: CHAT_TIMEOUT_MS });
     if (!chat.ok) {
         const err = routeErrorText(chat.data, chat.status);
         return {

package/dist/lib/format.d.ts

@@ -1,6 +1,11 @@
 export declare function formatGeneration(data: Record<string, unknown>): string;
 export declare function formatGenesisRun(data: Record<string, unknown>): string;
 export declare function formatBrowse(generations: unknown[]): string;
+export declare function formatApiError(res: {
+    ok: boolean;
+    status: number;
+    data: unknown;
+}): string;
 export declare function formatError(res: {
     ok: boolean;
     status: number;

package/dist/lib/format.js

@@ -140,6 +140,37 @@ export function formatBrowse(generations) {
     }
     return lines.join("\n");
 }
+export function formatApiError(res) {
+    let message;
+    let remedy;
+    const d = res.data;
+    if (d && typeof d === "object" && !Array.isArray(d)) {
+        const rec = d;
+        const err = rec["error"];
+        if (typeof err === "string" && err) {
+            message = err;
+        }
+        else if (err && typeof err === "object") {
+            const e = err;
+            if (typeof e["message"] === "string" && e["message"])
+                message = e["message"];
+            if (typeof e["remedy"] === "string" && e["remedy"])
+                remedy = e["remedy"];
+        }
+        if (!message && typeof rec["message"] === "string" && rec["message"]) {
+            message = rec["message"];
+        }
+        if (!remedy && typeof rec["remedy"] === "string" && rec["remedy"]) {
+            remedy = rec["remedy"];
+        }
+    }
+    else if (typeof d === "string" && d.trim()) {
+        message = d.trim();
+    }
+    if (!message)
+        message = `HTTP ${res.status}`;
+    return remedy ? `${message}\nfix: ${remedy}` : message;
+}
 export function formatError(res) {
     const lines = [];
     lines.push(`## Error`);

package/dist/lib/keys-sync.js

@@ -11,6 +11,7 @@ export const PROVIDER_ENV_MAP = {
 export const SERVER_RESOLVED_PROVIDERS = new Set([
     "imgflip",
     "scrapecreators",
+    "apify",
 ]);
 export async function fetchRemoteKeys() {
     const res = await apiGetDashboard("/api/settings/keys");

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aicopycoders/exodus",
-  "version": "2026.7.200-beta.12",
+  "version": "2026.7.200-beta.13",
   "description": "CLI + Claude Code skills for the Copycoders Exodus ad pipeline",
   "repository": {
     "type": "git",