@dench.com/cli 3.5.8-staging.350 → 3.6.0-staging.356

package/crm.ts

@@ -74,6 +74,7 @@ import {
   enrichProfiles,
 } from "./lib/enrichment-gateway";
 import { closestMatch, levenshteinDistance } from "./lib/levenshtein";
+import { publicErrorMessage } from "./lib/public-error";
 
 type JsonRecord = Record<string, unknown>;
 
@@ -233,8 +234,10 @@ function userFacingConvexErrorMessage(error: unknown): string | null {
 function normalizeRpcError(error: unknown): Error {
   if (error instanceof CrmCliError) return error;
   return new CrmCliError(
-    userFacingConvexErrorMessage(error) ??
-      (error instanceof Error ? error.message : String(error)),
+    publicErrorMessage(
+      userFacingConvexErrorMessage(error) ??
+        (error instanceof Error ? error.message : String(error)),
+    ),
   );
 }
 
@@ -840,7 +843,9 @@ function getFieldEnrichmentFlag(args: string[]):
   | undefined {
   const category = parseCategoryFlag(getFlag(args, "--enrichment-category"));
   const key = getFlag(args, "--enrichment-key");
-  const apolloPath = getFlag(args, "--apollo-path");
+  const apolloPath = getFlagWithAliases(args, "--response-path", [
+    "--apollo-path",
+  ]);
   const inputFieldName = getFlag(args, "--input-field");
   const sawAny =
     category !== undefined ||
@@ -850,7 +855,7 @@ function getFieldEnrichmentFlag(args: string[]):
   if (!sawAny) return undefined;
   if (!category || !apolloPath || !inputFieldName) {
     throw new CrmCliError(
-      "Enrichment fields require --enrichment-category people|company, --apollo-path <path>, and --input-field <field>.",
+      "Enrichment fields require --enrichment-category people|company, --response-path <path>, and --input-field <field>.",
     );
   }
   return {
@@ -3991,7 +3996,7 @@ function resolveEnrichmentColumn(args: {
     };
   }
   throw new CrmCliError(
-    `No enrichment catalog column found for "${args.fieldName}". Pass --apollo-path for a custom gateway response path.`,
+    `No enrichment catalog column found for "${args.fieldName}". Pass --response-path for a custom response path.`,
   );
 }
 
@@ -4493,7 +4498,9 @@ async function runEnrichCommand(ctx: CrmCliContext): Promise<void> {
       const fieldName = shift(ctx.args, "field name");
       const inputFieldName = getFlag(ctx.args, "--input-field");
       const category = parseCategoryFlag(getFlag(ctx.args, "--category"));
-      const apolloPath = getFlag(ctx.args, "--apollo-path");
+      const apolloPath = getFlagWithAliases(ctx.args, "--response-path", [
+        "--apollo-path",
+      ]);
       const overwrite = hasFlag(ctx.args, "--overwrite");
       assertNoUnknownFlags(ctx.args, "crm enrich cell");
       out(
@@ -4516,13 +4523,15 @@ async function runEnrichCommand(ctx: CrmCliContext): Promise<void> {
       const missingOnly = !hasFlag(ctx.args, "--all");
       const inputFieldName = getFlag(ctx.args, "--input-field");
       const category = parseCategoryFlag(getFlag(ctx.args, "--category"));
-      const apolloPath = getFlag(ctx.args, "--apollo-path");
+      const apolloPath = getFlagWithAliases(ctx.args, "--response-path", [
+        "--apollo-path",
+      ]);
       const overwrite = hasFlag(ctx.args, "--overwrite");
       const limit = parsePositiveInt("--limit", getFlag(ctx.args, "--limit"));
       assertNoUnknownFlags(ctx.args, "crm enrich object");
       if (!fieldName) {
         throw new CrmCliError(
-          "dench crm enrich object <name> --field <field> [--input-field <field>] [--category people|company] [--apollo-path <path>] [--limit N] [--all] [--overwrite]",
+          "dench crm enrich object <name> --field <field> [--input-field <field>] [--category people|company] [--response-path <path>] [--limit N] [--all] [--overwrite]",
         );
       }
       out(
@@ -4679,9 +4688,9 @@ Fields (columns):
   dench crm fields create <object> <name> --type text|email|phone|url|number|boolean|date|enum|relation|user|tags|action|file|richtext \\
         [--required] [--description ...] [--enum-values JSON] [--enum-colors JSON] \\
         [--enum-multiple] [--related-object <name>] [--relationship many_to_one|many_to_many] \\
-        [--indexed | --no-indexed] [--enrichment-category people|company --apollo-path <path> --input-field <field>]
+        [--indexed | --no-indexed] [--enrichment-category people|company --response-path <path> --input-field <field>]
   dench crm fields update <object> <field> [--description ...] [--required] [--enum-values JSON] [--indexed | --no-indexed] \\
-        [--enrichment-category people|company --apollo-path <path> --input-field <field> | --clear-enrichment]
+        [--enrichment-category people|company --response-path <path> --input-field <field> | --clear-enrichment]
   dench crm fields create <object> "Email opened" --calculation email_opened [--campaign <id>]
   dench crm fields update <object> <field> --calculation <metric> [--campaign <id>]
       Metrics: email_opened, email_clicked, replied, linkedin_connected.
@@ -4950,8 +4959,8 @@ People + companies shortcuts:
 
 Cell / row / object enrichment:
   dench crm enrich profiles --kind people|companies --file lookups.json [--json]
-  dench crm enrich cell <object> <entryId> <field> [--input-field <field>] [--category people|company] [--apollo-path <path>] [--overwrite]
-  dench crm enrich object <object> --field <field> [--input-field <field>] [--category people|company] [--apollo-path <path>] [--limit N] [--all] [--overwrite]
+  dench crm enrich cell <object> <entryId> <field> [--input-field <field>] [--category people|company] [--response-path <path>] [--overwrite]
+  dench crm enrich object <object> --field <field> [--input-field <field>] [--category people|company] [--response-path <path>] [--limit N] [--all] [--overwrite]
 
 Reports (chart-ready JSON):
   dench crm reports generate '<name>' --object <object> --type pie|bar|line|table --group-by <field> [--metric count|sum --metric-field <field>]

package/cron.ts

@@ -409,14 +409,15 @@ async function runCreate(ctx: CronCliContext): Promise<void> {
   if (target && target !== "chat_turn") {
     throw new CronCliError(`--target must be chat_turn (got "${target}")`);
   }
-  const triggerType = (getFlag(ctx.args, "--type") ?? "schedule") as
+  const requestedType = getFlag(ctx.args, "--type") ?? "schedule";
+  const triggerType = (requestedType === "app" ? "composio" : requestedType) as
     | "schedule"
     | "webhook"
     | "composio"
     | "crm";
   if (!["schedule", "webhook", "composio", "crm"].includes(triggerType)) {
     throw new CronCliError(
-      `--type must be schedule|webhook|composio|crm (got "${triggerType}").`,
+      `--type must be schedule|webhook|app|crm (got "${requestedType}").`,
     );
   }
 
@@ -601,7 +602,7 @@ export function buildAppOrCrmCreateBody(
           "  Discover events: dench cron events <toolkit>    (use the event slug)\n" +
           "Example:\n" +
           '  dench cron create "New GitHub star" --prompt "Thank the new stargazer" \\\n' +
-          "    --type composio --connection ca_123 --event GITHUB_STAR_ADDED_EVENT --toolkit github",
+          "    --type app --connection ca_123 --event GITHUB_STAR_ADDED_EVENT --toolkit github",
       );
     }
     const toolkit = getFlag(args, "--toolkit");
@@ -867,7 +868,7 @@ Browse:
 Create / update:
   dench cron create "Daily standup digest" \\
       --prompt "Pull yesterday's commits + Slack #standup msgs and post a summary…" \\
-      --type schedule                     # default. also: webhook | composio | crm (see below)
+      --type schedule                     # default. also: webhook | app | crm (see below)
       --every 1d                          # or --cron "0 9 * * 1-5"  or --at 2026-05-04T09:00:00Z
       [--description "..."]               # human-readable note shown in dashboard / list
       [--overlap skip|queue|kill_old]     # default: skip
@@ -885,7 +886,7 @@ Create / update:
   #   1. dench apps --json                    → connectedAccountId + toolkit
   #   2. dench cron events <toolkit>          → event slug
   dench cron create "New GitHub star" --prompt "Thank the new stargazer" \\
-      --type composio --connection <connectedAccountId> --event <triggerSlug> \\
+      --type app --connection <connectedAccountId> --event <triggerSlug> \\
       [--toolkit <slug>] [--trigger-config '<json>']
 
   # CRM-event automation (fires on a CRM object create/update/delete).

package/dench.ts

@@ -28,7 +28,9 @@ import {
   resolveHostFromArgs,
   STAGING_HOST,
 } from "./host";
+import { cliVersion } from "./lib/cli-version";
 import { resolveOrganizationBySelector } from "./lib/organizationSelector";
+import { backendErrorText } from "./lib/public-error";
 import { normalizeUnipileToolkitSlug } from "./lib/unipile-toolkits";
 import { formatApprovalOpenMessage, openUrl } from "./openUrl";
 import {
@@ -47,6 +49,7 @@ import {
   withSavedSession,
 } from "./session";
 import {
+  connectionSource,
   fetchConnectedAppsSummary,
   fetchUnipileConnections,
   runToolCommand,
@@ -214,19 +217,6 @@ const json = args.includes("--json");
 const filteredArgs = args.filter((arg) => arg !== "--json");
 const scopedStatus = args.includes("--mine") || args.includes("--self");
 
-async function cliVersion() {
-  try {
-    const packageJson = JSON.parse(
-      await readFile(new URL("./package.json", import.meta.url), "utf8"),
-    ) as { version?: unknown };
-    return typeof packageJson.version === "string"
-      ? packageJson.version
-      : "unknown";
-  } catch {
-    return "unknown";
-  }
-}
-
 function readEnv(name: string) {
   const value = process.env[name]?.trim();
   if (!value) {
@@ -248,6 +238,12 @@ function hasFlag(name: string) {
 const BOOLEAN_FLAGS = new Set([
   "--all",
   "--allow-duplicates",
+  "--allow-active",
+  "--raw",
+  "--check",
+  "--allow-single-braces",
+  "--with-ids",
+  "--yes",
   "--ack-linkedin-risk",
   "--stop-on-reply",
   "--no-stop-on-reply",
@@ -326,41 +322,16 @@ function throwIfCliError(value: unknown) {
   }
 }
 
-/**
- * Production Convex deployments mask `error.message` ("[Request ID: …]
- * Server Error") but forward `ConvexError.data` verbatim. Prefer the data
- * payload so agents see the actionable message instead of the mask.
- */
-function convexErrorData(error: unknown): string | undefined {
-  if (!error || typeof error !== "object" || !("data" in error)) {
-    return undefined;
-  }
-  const data = (error as { data?: unknown }).data;
-  if (typeof data === "string" && data.trim()) return data;
-  if (data && typeof data === "object") {
-    const message = (data as { message?: unknown }).message;
-    if (typeof message === "string" && message.trim()) return message;
-    try {
-      return JSON.stringify(data);
-    } catch {
-      return undefined;
-    }
-  }
-  return undefined;
-}
-
 function normalizeCliError(error: unknown): CliError {
   if (error instanceof CliError) return error;
-  const message =
-    convexErrorData(error) ??
-    (error instanceof Error ? error.message : String(error));
+  const message = backendErrorText(error);
   if (message.includes("Invalid dev agent key")) {
     return new CliError("Invalid dev agent key", {
       code: "invalid_dev_agent_key",
       nextActions: [
-        "Check that DENCH_DEV_AGENT_KEY in your shell matches the Convex deployment env.",
-        "Use --dev only for a local/dev Convex deployment configured with that key.",
-        "For normal terminal usage, run dench signin or set DENCH_API_KEY + CONVEX_URL.",
+        "Check that DENCH_DEV_AGENT_KEY in your shell matches the dev deployment env.",
+        "Use --dev only for a local/dev deployment configured with that key.",
+        "For normal terminal usage, run dench signin or set DENCH_API_KEY.",
       ],
     });
   }
@@ -369,7 +340,7 @@ function normalizeCliError(error: unknown): CliError {
       code: "dev_access_disabled",
       nextActions: [
         "Remove --dev and run dench signin for terminal access.",
-        "Or use DENCH_API_KEY + CONVEX_URL for sandbox/automation access.",
+        "Or use DENCH_API_KEY for sandbox/automation access.",
       ],
     });
   }
@@ -389,7 +360,7 @@ function normalizeCliError(error: unknown): CliError {
     return new CliError("Invalid Dench API key", {
       code: "invalid_api_key",
       nextActions: [
-        "Check DENCH_API_KEY and CONVEX_URL point to the same organization/deployment.",
+        "Check that DENCH_API_KEY is a current key for your workspace.",
         "Unset DENCH_API_KEY to use a saved dench signin session instead.",
         "Or run dench signin to create a new terminal session.",
       ],
@@ -521,8 +492,8 @@ Usage:
   dench tool status [toolkit] [--json]
   dench tool connect <toolkit> [--json]
   dench tool search "create github issue" [--toolkit github] [--limit 20] [--compact] [--json]
-  dench tool run <composio_tool_slug> --args '{"key":"value"}' [--account <connected_account_id>] [--approval <approvalId>] [--json]
-CRM (Daytona-native rewrite):
+  dench tool run <tool_slug> --args '{"key":"value"}' [--account <connected_account_id>] [--approval <approvalId>] [--json]
+CRM:
   dench crm objects <list|get|create|update|rename|delete> ...
   dench crm fields <list|create|update|delete|reorder> <object> ...
   dench crm entries <list|get|create|create-many|update|update-many|delete|bulk-delete> <object> ...
@@ -579,7 +550,7 @@ Workspace members (for CRM \`user\`-type fields, and who's doing what):
   dench members presence [<userId|email>...]   online / away / offline
   dench members me [--name --tagline --timezone --avatar <file>]   your own profile
 
-Live web search (Exa via the Dench Gateway, auths with the active \`dench signin\` agent session or DENCH_API_KEY):
+Live web search (via the Dench Gateway, auths with the active \`dench signin\` agent session or DENCH_API_KEY):
   dench search "<query>" [--num-results N] [--type auto|fast|deep|deep-reasoning|neural] [--category news|company|people|...] [--include-domains a.com,b.com] [--exclude-domains c.com] [--max-chars 800] [--json]
   dench search contents <url> [<url>...] [--max-chars 4000] [--summary "..."] [--json]
   dench search answer "<query>" [--json]
@@ -624,14 +595,23 @@ Managed email campaigns:
   Help: dench email help
 
 Outreach campaigns (email + LinkedIn steps on one schedule; leads move New → Contacted → Replied):
-  dench campaign list [--all] [--json]
-  dench campaign create --name "Founder outreach" [--timezone America/Los_Angeles] [--window "Mon-Fri 9-18"] [--daily-cap 30] [--json]
-  dench campaign steps set <campaign> --file steps.json [--json]
-  dench campaign add <campaign> --object lead --view "Q3 targets" [--json]
+  dench campaign accounts [--json]                    (sender ids, warm-up and capacity)
+  dench campaign draft --name "Founder outreach" --request-id founders-q4 [--timezone America/Los_Angeles] [--window "Mon-Fri 9-18"] [--json]
+  dench campaign search --filters '{"titles":["Founder"]}' [--not-industries "Staffing and Recruiting"] [--limit 25] [--out audience.json] [--json]   (1 cent per person returned)
+  dench campaign add <campaign> --people-file audience.json | --csv people.csv | --list <artifactId> | --search '{...}' | --object lead --view "Q3 targets" [--json]
+  dench campaign steps get|set|edit <campaign> [--file steps.json] [--json]   (set: drafts only; edit: text and waits, also after launch)
+  dench campaign personalize set <campaign> --file lines.json   (AI-written lines, about 3 cents a person)
+  dench campaign preview <campaign> [--person <name>] [--step N]   (the exact messages one person gets)
+  dench campaign launch <campaign> --check [--json]   (readiness only; never launches)
   dench campaign launch <campaign> [--ack-linkedin-risk] [--json]
   dench campaign get <campaign> [--json]              (status, funnel, Now/Next, holds, people)
-  dench campaign pause|resume|archive <campaign> [--json]
-  Help: dench campaign help
+  dench campaign people|events|replies|pipeline <campaign> [--json]
+  dench campaign duplicate|pause|resume|archive <campaign> [--json]
+  dench campaign stop|remove|resume-person <campaign> --person <id> [--json]
+  dench campaign person show|set <campaign> --person <id> [--json]   ·   dench campaign sync <campaign>   ·   dench campaign where <entryId>
+  dench campaign builder profile|save|get|build|create|opener|autofill|terms|estimate [--json]
+  dench campaign sources get|signals|set|preview <campaign> [--json]
+  Help: dench campaign help   (recipe from a brief to launch: references/CAMPAIGNS.md)
 
 Image generation / editing (via the Dench Gateway):
   dench image generate "<prompt>" [--size 1024x1024] [--quality auto|low|medium|high] [--format png|jpeg|webp] [--save-path /workspace/path/file.png] [--output <local file>] [--no-write] [--json]
@@ -674,7 +654,7 @@ returns ENOSYS on the FUSE-backed volume mount):
   dench files rm <path> [--recursive] [--json]
   dench files download <path> [<local-dest>] [--url] [--json]
 
-Persist scratch -> workspace (cp from /tmp into /workspace + Convex sync):
+Persist scratch -> workspace (cp from /tmp into /workspace + cloud sync):
   dench stage <local-path> [<workspace-dest>] [--clean] [--json]
 
 Subagents:
@@ -704,7 +684,7 @@ Self-updating agent harness:
 
 External tools:
   dench integrations is an alias for dench tool status -- it lists connected apps.
-  dench apps is the App Store (create / install / publish / list), not Composio.
+  dench apps is the App Store (create / install / publish / list), not connected apps.
   dench tool with no subcommand prints tool help.
   Read-only FETCH, GET, LIST, SEARCH, READ, and FIND tools do not need manual approval.
 
@@ -741,10 +721,10 @@ Backends and hosts:
     dench --host https://example.com <cmd>
     DENCH_HOST=https://example.com dench <cmd>
 
-Dev fallback (run against a local Convex deployment with a dev key):
-  DENCH_DEV_AGENT_KEY=... DENCH_WORKSPACE=... NEXT_PUBLIC_CONVEX_URL=... dench status --dev
-  Inside the dench.com repo, --dev also auto-loads .env / .env.local
-  so GATEWAY_URL etc. flow through. Use --use-dev-env (or
+Dev fallback (run against a local dev deployment with a dev key):
+  DENCH_DEV_AGENT_KEY=... DENCH_WORKSPACE=... dench status --dev
+  Inside the dench.com repo, --dev also auto-loads .env / .env.local,
+  which carry the dev backend URL and GATEWAY_URL etc. Use --use-dev-env (or
   DENCH_USE_DEV_ENV=1) when you want that auto-load without switching
   the runtime to the dev workspace mode.
 
@@ -800,22 +780,9 @@ lists agent suggested-work artifacts. Rename/delete saved searches with
 `);
 }
 
-function listsCliHelp() {
-  console.log(`Dench lists
-
-Usage:
-  dench lists [--limit 25] [--json]
-  dench lists show <id> [--json]
-  dench lists save --title "Shortlist" --people-file <people.json> [--json]
-  dench lists rename <id> "New name" [--json]
-  dench lists update <id> [--title "New name"] [--filters-json '{"titles":["CTO"]}'] [--json]
-  dench lists delete <id> [--json]
-
-Lists are saved searches from Find (people / companies / job postings).
-Create one with \`dench leads|companies|jobs find --save-as "Name"\`.
-Delete removes the list, its exported CSV/JSONL files, and any linked watch.
-CRM lists (saved views) are managed with \`dench crm views ...\`.
-`);
+async function listsCliHelp() {
+  const { listsHelp } = await import("./leads");
+  listsHelp();
 }
 
 function leadsHelp() {
@@ -925,26 +892,26 @@ function integrationsHelp() {
 Usage:
   dench integrations [--json]
 
-Lists every app connected to this organization, from both brokers:
+Lists every app connected to this organization:
 
-  - Composio apps (GitHub, Notion, HubSpot, …), each with a
+  - Connected apps (GitHub, Notion, HubSpot, …), each with a
     \`connectedAccountId\` you can pass to \`dench tool run --account\`.
-  - Gmail, Outlook, Calendar, LinkedIn (\`source: "unipile"\`) and Slack
-    (\`source: "dench"\`), which Dench connects itself. These have no
-    connected-account id, but they run through the SAME \`dench tool
-    search\` / \`dench tool run\` — find the slug and run it. \`dench tool
-    connect slack\` prints the in-house Slack install URL (org admin);
-    \`dench tool connect <gmail|outlook|linkedin|calendar>\` prints a
-    Unipile hosted-auth link using the web app's configuration. Open
-    that link to authorize the account, then check \`dench tool status\`.
-    Slack is ALWAYS in-house (never Composio): SLACK_* tools can post
-    to / read any channel, with Block Kit blocks and buttons.
+  - Gmail, Outlook, Calendar, LinkedIn and Slack (\`source: "dench"\`), which
+    Dench connects itself. These have no connected-account id, but they run
+    through the SAME \`dench tool search\` / \`dench tool run\` — find the
+    slug and run it. \`dench tool connect slack\` prints the in-house Slack
+    install URL (org admin); \`dench tool connect <gmail|outlook|linkedin|calendar>\`
+    prints a Dench sign-in link using the web app's configuration. Open that
+    link to authorize the account, then check \`dench tool status\`.
+    Slack is ALWAYS in-house: SLACK_* tools can post to / read any channel,
+    with Block Kit blocks and buttons.
     For reading, the CRM is usually better: calendar events sync into
     \`calendar_event\` and recordings into \`meeting\`.
 
-Other toolkits connect through Composio. If \`unipileAvailable\` is
-false, native status could not be checked; do not assume an account
-is disconnected. Any Composio lookup failure is reported separately.
+Other toolkits connect as connected apps. If \`nativeAvailable\` is
+false, Dench-connected accounts could not be checked; do not assume an
+account is disconnected. A failure to check connected apps is reported
+separately.
 
 Authenticates with the active \`dench signin\` agent session or
 DENCH_API_KEY (Bearer), whichever is set. Same output as
@@ -2579,7 +2546,7 @@ function loginRequiredError(
       : {}),
     nextActions: [
       ...mismatchActions,
-      "Set DENCH_API_KEY (and CONVEX_URL) in your env if running inside a sandbox or CI.",
+      "Set DENCH_API_KEY in your env if running inside a sandbox or CI.",
       'Or run dench signin --kind <kind> --name "AI Agent - Project" to mint an agent session.',
       "If already approved, run dench sessions --json, then dench use <session-key-or-workspace-slug>.",
     ],
@@ -3062,8 +3029,8 @@ async function connectedAppsContext(runtime: Runtime) {
       reason: errorMessage(error),
       count: unipile.connections.length,
       connections: unipile.connections,
-      unipileAvailable: unipile.available,
-      ...(unipile.error ? { unipileError: unipile.error } : {}),
+      nativeAvailable: unipile.available,
+      ...(unipile.error ? { nativeError: unipile.error } : {}),
     };
   }
 }
@@ -3183,7 +3150,9 @@ function formatContext(context: JsonRecord) {
       ...connections.slice(0, 8).map((connection) => {
         const label = stringField(connection, "accountLabel");
         const via =
-          stringField(connection, "source") === "unipile" ? " via Dench" : "";
+          connectionSource(stringField(connection, "source"), "app") === "dench"
+            ? " via Dench"
+            : "";
         return `  - ${stringField(connection, "toolkit") ?? "unknown"} [${
           stringField(connection, "status") ?? "unknown"
         }]${label ? ` ${label}` : ""}${via}`;
@@ -3191,16 +3160,16 @@ function formatContext(context: JsonRecord) {
     );
     if (connectedApps?.available === false) {
       lines.push(
-        `  (could not check Composio apps: ${
+        `  (could not check connected apps: ${
           stringField(connectedApps, "error", "reason") ?? "unknown error"
         })`,
       );
     }
   }
-  if (connectedApps?.unipileAvailable === false) {
+  if (connectedApps?.nativeAvailable === false) {
     lines.push(
       `  (could not check Gmail/Outlook/Calendar/LinkedIn: ${
-        stringField(connectedApps, "unipileError") ?? "unknown error"
+        stringField(connectedApps, "nativeError") ?? "unknown error"
       })`,
     );
   }
@@ -3549,7 +3518,7 @@ async function uploadConvexFileBytes(
   });
   if (!response.ok) {
     throw new Error(
-      `convex storage upload failed (${response.status}): ${await response
+      `workspace storage upload failed (${response.status}): ${await response
         .text()
         .catch(() => "")}`,
     );
@@ -3633,7 +3602,7 @@ async function runFilesMv() {
     await listConvexTreeAt(runtime, apiKey, parentOfPath(from))
   ).find((row) => row.path === from);
   if (!sourceSelf && sourceRows.length === 0) {
-    throw new CliError(`Source not found in Convex: ${from}`, {
+    throw new CliError(`Source not found in workspace storage: ${from}`, {
       code: "files_mv_not_found",
       nextActions: [
         "Run `dench files ls` on the parent directory to confirm.",
@@ -3704,7 +3673,7 @@ async function runFilesRm() {
       print({ ok: true, path: target, removedFiles: 0, removedDirs: 0 });
     } else {
       process.stdout.write(
-        `dench files rm: ${target} not present in Convex (already absent)\n`,
+        `dench files rm: ${target} not present in workspace storage (already absent)\n`,
       );
     }
     return;
@@ -3779,7 +3748,7 @@ async function runFilesCat() {
   } | null;
 
   if (!file) {
-    throw new CliError(`Not found in Convex: ${target}`, {
+    throw new CliError(`Not found in workspace storage: ${target}`, {
       code: "files_cat_not_found",
       nextActions: [
         "Run `dench files ls` on the parent directory to confirm.",
@@ -3915,7 +3884,7 @@ async function runFilesDownload() {
   if (!isDir) {
     const bytes = await downloadConvexFileBytes(runtime, apiKey, target);
     if (!bytes) {
-      throw new CliError(`Not found in Convex: ${target}`, {
+      throw new CliError(`Not found in workspace storage: ${target}`, {
         code: "files_download_not_found",
         nextActions: [
           "Run `dench files ls` on the parent directory to confirm.",
@@ -4005,10 +3974,10 @@ async function runFilesCommand() {
         "  dench files download <path> [<local-dest>] [--url] [--json]",
         "",
         "Paths are POSIX paths under /workspace; you can pass either form.",
-        "These mutate Convex directly (and the daemon syncs to the volume).",
+        "These change workspace storage directly (and the daemon syncs to the volume).",
         "cat prints inline text and is the only way to read the magic files",
         "(IDENTITY.md, ORGANISATION.md, …), which have no stored bytes.",
-        "download fetches canonical bytes from Convex (dirs recurse);",
+        "download fetches the canonical bytes from workspace storage (dirs recurse);",
         "--url prints a short-lived signed URL instead of saving.",
       ].join("\n"),
     );
@@ -4444,7 +4413,7 @@ async function main() {
   }
 
   if (command === "lists" && (subcommand === "help" || hasFlag("--help"))) {
-    listsCliHelp();
+    await listsCliHelp();
     return;
   }
 
@@ -5131,6 +5100,7 @@ async function main() {
       args: subArgs,
       jsonOutput: json,
       sessionToken: authedRuntime.sessionToken,
+      host: authedRuntime.host,
     });
     return;
   }
@@ -5396,7 +5366,7 @@ async function main() {
       jsonOutput: json,
       sessionToken,
     });
-    if (!handled) listsCliHelp();
+    if (!handled) await listsCliHelp();
     return;
   }
 

package/fs-daemon.ts

@@ -545,7 +545,7 @@ async function processPullRequests(args: {
           deadline,
         );
         if (!row || row.isDir || !row.contentHash) {
-          throw new Error("File is not present in Convex fileTree.");
+          throw new Error("File is not present in the workspace file tree.");
         }
         await pullDownRemoteFile(args.client, {
           expectedHash: row.contentHash,
@@ -600,7 +600,7 @@ async function runDaemon(daemonArgs: Args): Promise<void> {
   );
   if (mount.isFuse) {
     console.log(
-      "[dench-fs-daemon] FUSE backing detected; enabling polling mode (inotify is not delivered through Mountpoint-S3)",
+      "[dench-fs-daemon] FUSE backing detected; enabling polling mode (inotify is not delivered through the mounted workspace)",
     );
   }
   daemonMode = true;
@@ -1692,9 +1692,9 @@ function printStatusHuman(report: StatusReport): void {
   lines.push("file counts");
   lines.push("─".repeat(40));
   lines.push(`on disk:         ${report.counts.onDisk}`);
-  lines.push(`in convex:       ${report.counts.inConvex}`);
+  lines.push(`in cloud:        ${report.counts.inConvex}`);
   lines.push(`only on disk:    ${report.counts.onlyOnDisk}`);
-  lines.push(`only in convex:  ${report.counts.onlyInConvex}`);
+  lines.push(`only in cloud:   ${report.counts.onlyInConvex}`);
   lines.push(`hash mismatches: ${report.counts.hashMismatches}`);
 
   if (report.drift.length > 0) {
@@ -1705,10 +1705,10 @@ function printStatusHuman(report: StatusReport): void {
       if (item.kind === "only_disk") {
         lines.push(`  + ${item.path}  ${item.size}B (only on disk)`);
       } else if (item.kind === "only_convex") {
-        lines.push(`  - ${item.path}  (only in convex)`);
+        lines.push(`  - ${item.path}  (only in cloud)`);
       } else {
         lines.push(
-          `  ! ${item.path}  disk=${item.diskHashShort}… convex=${item.convexHashShort}…`,
+          `  ! ${item.path}  disk=${item.diskHashShort}… cloud=${item.convexHashShort}…`,
         );
       }
     }

package/image.ts

@@ -177,7 +177,7 @@ function formatGenerationResult(
   localPath: string | null,
 ): string {
   const lines: string[] = [];
-  lines.push(`Generated image (${res.model ?? "gpt-image-2"})`);
+  lines.push("Generated image");
   if (res.prompt) {
     lines.push(`  Prompt: ${res.prompt}`);
   }
@@ -386,10 +386,10 @@ async function runEditSubcommand(ctx: ImageCliContext): Promise<void> {
 function imageHelp(): void {
   console.log(`Usage: dench image <subcommand>
 
-Generate or edit images via the Dench Cloud Gateway (gpt-image-2). Auths
+Generate or edit images via the Dench Cloud Gateway. Auths
 with DENCH_API_KEY or the active \`dench signin\` agent session. Agent
-sessions require a paid workspace. Each call writes the bytes to Convex
-Storage (workspace tree updates immediately) and, when running inside a sandbox,
+sessions require a paid workspace. Each call writes the bytes to workspace
+storage (workspace tree updates immediately) and, when running inside a sandbox,
 also writes the decoded bytes to
 local disk so subsequent bash commands see the file without waiting on
 the daemon's downward sync.