@arbidocs/cli 0.3.13 → 0.3.15

package/CHANGELOG.md

@@ -1,12 +1,94 @@
 # Changelog
 
+## v0.3.15
+
+[compare changes](https://github.com/arbicity/ARBI-frontend/compare/v0.3.14...HEAD)
+
+### 🚀 Enhancements
+
+- Adopt message status field for failed message UI ([b267e7b8](https://github.com/arbicity/ARBI-frontend/commit/b267e7b8))
+
+### 🩹 Fixes
+
+- **cli:** Always start fresh conversation for background queries ([891ed884](https://github.com/arbicity/ARBI-frontend/commit/891ed884))
+
+## v0.3.14
+
+[compare changes](https://github.com/arbicity/ARBI-frontend/compare/v0.3.13...HEAD)
+
+### 🚀 Enhancements
+
+- **cli:** Verbose default, configurable watch, default notifications ([22f0faea](https://github.com/arbicity/ARBI-frontend/commit/22f0faea))
+- **cli:** Add response summary line and per-step token usage ([506c723d](https://github.com/arbicity/ARBI-frontend/commit/506c723d))
+- **cli:** Add `arbi task` command for background query submission ([fb492311](https://github.com/arbicity/ARBI-frontend/commit/fb492311))
+- Update schema, SSE token context, and context usage display ([9f908e99](https://github.com/arbicity/ARBI-frontend/commit/9f908e99))
+
+### 🩹 Fixes
+
+- Remove stray fi in publish script causing exit code 2 ([7739d8de](https://github.com/arbicity/ARBI-frontend/commit/7739d8de))
+- Changelog generation and enforce conventional commits ([ac5b2e75](https://github.com/arbicity/ARBI-frontend/commit/ac5b2e75))
+
+### 💅 Refactors
+
+- **cli:** Move background mode to `arbi ask -b`, simplify task command ([2b9a1a51](https://github.com/arbicity/ARBI-frontend/commit/2b9a1a51))
+
 ## v0.3.13
 
-[compare changes](https://github.com/arbicity/ARBI-frontend/compare/v0.3.11...HEAD)
+[compare changes](https://github.com/arbicity/ARBI-frontend/compare/v0.3.10...v0.3.13)
+
+### 🚀 Enhancements
+
+- Tool-specific icons and labels for agent step rendering ([22377ee4](https://github.com/arbicity/ARBI-frontend/commit/22377ee4))
+- Move TOOL_LABELS and LIFECYCLE_LABELS to SDK as single source of truth ([b180663f](https://github.com/arbicity/ARBI-frontend/commit/b180663f))
+- Move templates to agentic mode with get_full_document ([9e625515](https://github.com/arbicity/ARBI-frontend/commit/9e625515))
+- CLI DX improvements: error messages, JWT caching, auto-detect, watch flags, quickstart & agent-create ([eefcc3ef](https://github.com/arbicity/ARBI-frontend/commit/eefcc3ef))
+- Add comprehensive CLI integration tests ([bb5088d2](https://github.com/arbicity/ARBI-frontend/commit/bb5088d2))
+- Simplified template modals v2 ([b2639ea7](https://github.com/arbicity/ARBI-frontend/commit/b2639ea7))
+- Searchable document combobox for Summarise and Translate templates ([880db107](https://github.com/arbicity/ARBI-frontend/commit/880db107))
+- Document page/token counts with size warnings ([49c72ab8](https://github.com/arbicity/ARBI-frontend/commit/49c72ab8))
+- Preserve folder structure on upload ([dc09dbfa](https://github.com/arbicity/ARBI-frontend/commit/dc09dbfa))
+- Folder UI for Documents page ([aaf08dbc](https://github.com/arbicity/ARBI-frontend/commit/aaf08dbc))
+- Uploaded/generated toggle and folder tree in FilterDropdown ([87351c31](https://github.com/arbicity/ARBI-frontend/commit/87351c31))
+- Add text search to Documents page ([bda72622](https://github.com/arbicity/ARBI-frontend/commit/bda72622))
+- Add search field selector and expose folder/content_hash columns ([595d02eb](https://github.com/arbicity/ARBI-frontend/commit/595d02eb))
+- Agentic mode toggle and agent step text handling ([22852e84](https://github.com/arbicity/ARBI-frontend/commit/22852e84))
+- Add Duplicates tri-state filter for documents ([e1682939](https://github.com/arbicity/ARBI-frontend/commit/e1682939))
+- Home page cards: left-align, group by matter ID with collapsible sub-sections ([f3e51750](https://github.com/arbicity/ARBI-frontend/commit/f3e51750))
+- Documents grid improvements, collapsible folder filter, agent step durations ([735f066b](https://github.com/arbicity/ARBI-frontend/commit/735f066b))
+- Developer tab: nested schema fields, footer layout, Apply button ([7daac802](https://github.com/arbicity/ARBI-frontend/commit/7daac802))
+- Redesign templates as horizontal rows with pin button ([8ed4c4e1](https://github.com/arbicity/ARBI-frontend/commit/8ed4c4e1))
+- Make @arbidocs/sdk WebContainer-compatible ([2e5446f3](https://github.com/arbicity/ARBI-frontend/commit/2e5446f3))
+- Optimize HtmlViewer for large documents with lazy loading ([aa3f7733](https://github.com/arbicity/ARBI-frontend/commit/aa3f7733))
+
+### 🩹 Fixes
+
+- Fix stale cached token after login/workspace switch ([ef222604](https://github.com/arbicity/ARBI-frontend/commit/ef222604))
+- Fix CI publish: restore PAT_PUBLISH, fail loudly on push errors ([15b8d8e8](https://github.com/arbicity/ARBI-frontend/commit/15b8d8e8))
+- Fix bulk actions toolbar hidden in document modals ([fcf70be3](https://github.com/arbicity/ARBI-frontend/commit/fcf70be3))
+- Resolve document titles in agent step display ([71da1b41](https://github.com/arbicity/ARBI-frontend/commit/71da1b41))
+- Fix document grid in modals by using fixed height ([0e5ed342](https://github.com/arbicity/ARBI-frontend/commit/0e5ed342))
+- Fix citation scroll-to-chunk and show page nav for HTML view ([624a6cfc](https://github.com/arbicity/ARBI-frontend/commit/624a6cfc))
+- Fix citation scroll-to-passage and remove markdown arrow artifacts ([3ce0d32d](https://github.com/arbicity/ARBI-frontend/commit/3ce0d32d))
+- Fix Apply button: stop resetting newConfigId on parentMessageId change ([729f30e9](https://github.com/arbicity/ARBI-frontend/commit/729f30e9))
+- Fix streaming content truncated in non-agentic mode ([7f338f25](https://github.com/arbicity/ARBI-frontend/commit/7f338f25))
+- Prevent agent step preamble from appearing in message body ([0e99e3ed](https://github.com/arbicity/ARBI-frontend/commit/0e99e3ed))
+- Fix model selector resets on messageHistory/parentConfig changes ([c30e4d7c](https://github.com/arbicity/ARBI-frontend/commit/c30e4d7c))
+- Fix workspace switch revert when triggered from home page ([370a46a5](https://github.com/arbicity/ARBI-frontend/commit/370a46a5))
+- Sanitize folder paths for backend API ([70dc0f4a](https://github.com/arbicity/ARBI-frontend/commit/70dc0f4a))
+- Remove selectedThreadId, unify into parentMessageId ([c20f0785](https://github.com/arbicity/ARBI-frontend/commit/c20f0785))
+- Extract metadata from response.completed SSE event ([e8bff08d](https://github.com/arbicity/ARBI-frontend/commit/e8bff08d))
+- Extract conversation documents from last user message instead of leaf ([b3d2718e](https://github.com/arbicity/ARBI-frontend/commit/b3d2718e))
+- CLI integration test failures ([b092962e](https://github.com/arbicity/ARBI-frontend/commit/b092962e))
+- Handle protected branches in publish script ([7746517e](https://github.com/arbicity/ARBI-frontend/commit/7746517e))
 
 ### 🏡 Chore
 
-- Bump packages to v0.3.12 for publish ([a13842c0](https://github.com/arbicity/ARBI-frontend/commit/a13842c0))
+- Update schema: add scores to CitationData, chunker tokenizer config ([7fc18309](https://github.com/arbicity/ARBI-frontend/commit/7fc18309))
+- Schema updates ([ab08dc54](https://github.com/arbicity/ARBI-frontend/commit/ab08dc54), [76046067](https://github.com/arbicity/ARBI-frontend/commit/76046067))
+- Remove MemoryLLM from schema ([6806daea](https://github.com/arbicity/ARBI-frontend/commit/6806daea))
+- CI: move integration tests off PR triggers, gate deploy behind them ([ff23f07a](https://github.com/arbicity/ARBI-frontend/commit/ff23f07a))
+- Move PA mode toggle behind experimental feature flag ([2f00bce8](https://github.com/arbicity/ARBI-frontend/commit/2f00bce8))
+- Replace MCP references with TUI in SDK comments ([42683222](https://github.com/arbicity/ARBI-frontend/commit/42683222))
 
 ## v0.3.10
 

package/dist/index.js

@@ -125,7 +125,9 @@ function registerConfigCommand(program2) {
     label("Server URL:", cfg.baseUrl);
     label("Domain:", cfg.deploymentDomain);
     label("Auto-update:", cfg.autoUpdate ? "on" : "off");
-    label("Notifications:", cfg.notifications ? "on" : "off");
+    label("Verbose:", cfg.verbose !== false ? "on" : "off");
+    label("Watch:", cfg.watch !== false ? "on" : "off");
+    label("Notifications:", cfg.notifications !== false ? "on" : "off");
     if (cfg.selectedWorkspaceId) {
       label("Workspace:", cfg.selectedWorkspaceId);
     }
@@ -133,7 +135,7 @@ function registerConfigCommand(program2) {
   config.command("notifications [on|off]").description("Toggle background WebSocket notifications").action((toggle) => {
     const cfg = getConfig();
     if (!toggle) {
-      label("Notifications:", cfg?.notifications ? "on" : "off");
+      label("Notifications:", cfg?.notifications !== false ? "on" : "off");
       return;
     }
     if (toggle !== "on" && toggle !== "off") {
@@ -143,6 +145,32 @@ function registerConfigCommand(program2) {
     updateConfig({ notifications: toggle === "on" });
     success(`Notifications: ${toggle}`);
   });
+  config.command("verbose [on|off]").description("Toggle verbose agent steps in ask (default: on)").action((toggle) => {
+    const cfg = getConfig();
+    if (!toggle) {
+      label("Verbose:", cfg?.verbose !== false ? "on" : "off");
+      return;
+    }
+    if (toggle !== "on" && toggle !== "off") {
+      error("Usage: arbi config verbose [on|off]");
+      process.exit(1);
+    }
+    updateConfig({ verbose: toggle === "on" });
+    success(`Verbose: ${toggle}`);
+  });
+  config.command("watch [on|off]").description("Toggle upload watch (default: on)").action((toggle) => {
+    const cfg = getConfig();
+    if (!toggle) {
+      label("Watch:", cfg?.watch !== false ? "on" : "off");
+      return;
+    }
+    if (toggle !== "on" && toggle !== "off") {
+      error("Usage: arbi config watch [on|off]");
+      process.exit(1);
+    }
+    updateConfig({ watch: toggle === "on" });
+    success(`Watch: ${toggle}`);
+  });
   config.command("alias").description('Set up shell alias A for "arbi ask"').action(() => {
     const rcPath = getShellRcPath();
     if (isAliasInstalled(rcPath)) {
@@ -3509,7 +3537,7 @@ function getLatestVersion(skipCache = false) {
   }
 }
 function getCurrentVersion() {
-  return "0.3.13";
+  return "0.3.15";
 }
 function readChangelog(fromVersion, toVersion) {
   try {
@@ -3562,17 +3590,17 @@ function showChangelog(fromVersion, toVersion) {
 async function checkForUpdates(autoUpdate) {
   try {
     const latest = getLatestVersion();
-    if (!latest || latest === "0.3.13") return;
+    if (!latest || latest === "0.3.15") return;
     if (autoUpdate) {
       warn(`
-Your arbi version is out of date (${"0.3.13"} \u2192 ${latest}). Updating...`);
+Your arbi version is out of date (${"0.3.15"} \u2192 ${latest}). Updating...`);
       child_process.execSync("npm install -g @arbidocs/cli@latest", { stdio: "inherit" });
-      showChangelog("0.3.13", latest);
+      showChangelog("0.3.15", latest);
       console.log(`Updated to ${latest}.`);
     } else {
       warn(
         `
-Your arbi version is out of date (${"0.3.13"} \u2192 ${latest}).
+Your arbi version is out of date (${"0.3.15"} \u2192 ${latest}).
 Run "arbi update" to upgrade, or "arbi update auto" to always stay up to date.`
       );
     }
@@ -3582,9 +3610,9 @@ Run "arbi update" to upgrade, or "arbi update auto" to always stay up to date.`
 function hintUpdateOnError() {
   try {
     const cached = readCache();
-    if (cached && cached.latest !== "0.3.13") {
+    if (cached && cached.latest !== "0.3.15") {
       warn(
-        `Your arbi version is out of date (${"0.3.13"} \u2192 ${cached.latest}). Run "arbi update".`
+        `Your arbi version is out of date (${"0.3.15"} \u2192 ${cached.latest}). Run "arbi update".`
       );
     }
   } catch {
@@ -3852,6 +3880,54 @@ function registerStatusCommand(program2) {
     }
   });
 }
+var MAX_TASKS = 50;
+var MAX_AGE_MS = 7 * 24 * 60 * 60 * 1e3;
+function getTasksFile() {
+  const configDir = process.env.ARBI_CONFIG_DIR ?? path__default.default.join(os__default.default.homedir(), ".arbi");
+  return path__default.default.join(configDir, "tasks.json");
+}
+function ensureDir(filePath) {
+  const dir = path__default.default.dirname(filePath);
+  if (!fs__default.default.existsSync(dir)) {
+    fs__default.default.mkdirSync(dir, { recursive: true, mode: 448 });
+  }
+}
+function readTasks() {
+  try {
+    const content = fs__default.default.readFileSync(getTasksFile(), "utf-8");
+    return JSON.parse(content);
+  } catch {
+    return [];
+  }
+}
+function writeTasks(tasks) {
+  const filePath = getTasksFile();
+  ensureDir(filePath);
+  fs__default.default.writeFileSync(filePath, JSON.stringify(tasks, null, 2) + "\n", { mode: 384 });
+}
+function getTasks() {
+  const now = Date.now();
+  const tasks = readTasks().filter((t) => now - new Date(t.submittedAt).getTime() < MAX_AGE_MS);
+  return tasks;
+}
+function addTask(task) {
+  const tasks = [task, ...getTasks().filter((t) => t.id !== task.id)].slice(0, MAX_TASKS);
+  writeTasks(tasks);
+}
+function updateTaskStatus(id, status2) {
+  const tasks = readTasks();
+  const task = tasks.find((t) => t.id === id);
+  if (task) {
+    task.status = status2;
+    writeTasks(tasks);
+  }
+}
+function getLatestTask() {
+  const tasks = getTasks();
+  return tasks[0] ?? null;
+}
+
+// src/notifications.ts
 var activeConnection = null;
 function timestamp() {
   return (/* @__PURE__ */ new Date()).toLocaleTimeString("en-GB", { hour12: false });
@@ -3869,6 +3945,9 @@ async function startBackgroundNotifications(baseUrl, accessToken) {
       baseUrl,
       accessToken,
       onMessage: (msg) => {
+        if (client.isMessageType(msg, "response_complete")) {
+          updateTaskStatus(msg.response_id, msg.status);
+        }
         const { text, level } = sdk.formatWsMessage(msg);
         process.stderr.write(`
 ${colorize(level, `[${timestamp()}] ${text}`)}
@@ -3973,7 +4052,7 @@ async function resolveWorkspace(workspaceOpt) {
   try {
     resolveConfig();
     const ctx = await sdk.resolveWorkspace(store, workspaceOpt);
-    if (getConfig()?.notifications) {
+    if (getConfig()?.notifications !== false) {
       startBackgroundNotifications(ctx.config.baseUrl, ctx.accessToken).catch(() => {
       });
     }
@@ -4367,7 +4446,7 @@ function registerDocsCommand(program2) {
   );
 }
 function registerUploadCommand(program2) {
-  program2.command("upload <paths...>").description("Upload files, directories, or zip archives to the active workspace").option("-w, --workspace <id>", "Workspace ID (defaults to selected workspace)").option("-W, --watch", "Watch document processing progress after upload").action(
+  program2.command("add <paths...>").alias("upload").description("Add files, directories, or zip archives to the active workspace").option("-w, --workspace <id>", "Workspace ID (defaults to selected workspace)").option("-W, --watch", "Watch document processing progress after upload").option("--no-watch", "Skip watching document processing").action(
     (paths, opts) => runAction(async () => {
       for (const p of paths) {
         if (!fs__default.default.existsSync(p)) {
@@ -4426,7 +4505,8 @@ function registerUploadCommand(program2) {
         }
       }
       const isInteractive = process.stdout.isTTY === true;
-      const shouldWatch = opts.watch === true || paths.length === 1 && isInteractive;
+      const watchPref = getConfig()?.watch !== false;
+      const shouldWatch = opts.watch === false ? false : opts.watch === true || watchPref && isInteractive;
       if (shouldWatch && uploadedDocs.size > 0) {
         const pending = new Set(uploadedDocs.keys());
         const failed = /* @__PURE__ */ new Map();
@@ -4524,22 +4604,55 @@ function registerDownloadCommand(program2) {
   );
 }
 function registerAskCommand(program2) {
-  program2.command("ask <question...>").description("Ask the RAG assistant a question (no quotes needed)").option("-w, --workspace <id>", "Workspace ID (defaults to selected workspace)").option("-c, --config <id>", "Config ext_id to use (e.g. cfg-xxx)").option("-n, --new", "Start a new conversation (ignore previous context)").option("-v, --verbose", "Show agent steps and tool calls").action(
+  program2.command("ask <question...>").description("Ask the RAG assistant a question (no quotes needed)").option("-w, --workspace <id>", "Workspace ID (defaults to selected workspace)").option("-c, --continue <msg-id>", "Continue from a specific message ID").option("--config <id>", "Config ext_id to use (e.g. cfg-xxx)").option("-n, --new", "Start a new conversation (ignore previous context)").option("-b, --background", "Submit as background task (fire and forget)").option("-q, --quiet", "Suppress agent steps and tool calls").option("--json", "Output in JSON format (background mode only)").action(
     (words, opts) => runAction(async () => {
       const question = words.join(" ");
       const { arbi, accessToken, workspaceKeyHeader, workspaceId, config } = await resolveWorkspace(opts.workspace);
-      const session = getChatSession();
-      const workspaceChanged = session.lastMessageExtId && session.workspaceId && session.workspaceId !== workspaceId;
       let previousResponseId = null;
-      if (opts.new) {
-        clearChatSession();
-      } else if (workspaceChanged) {
+      if (opts.continue) {
+        previousResponseId = opts.continue;
+      } else if (opts.new) {
         clearChatSession();
-      } else if (session.lastMessageExtId) {
-        previousResponseId = session.lastMessageExtId;
+      } else {
+        const session = getChatSession();
+        const workspaceChanged = session.lastMessageExtId && session.workspaceId && session.workspaceId !== workspaceId;
+        if (workspaceChanged) {
+          clearChatSession();
+        } else if (session.lastMessageExtId) {
+          previousResponseId = session.lastMessageExtId;
+        }
       }
       const docs = await sdk.documents.listDocuments(arbi);
       const docIds = docs.map((d) => d.external_id);
+      if (opts.background) {
+        const result2 = await sdk.responses.submitBackgroundQuery({
+          baseUrl: config.baseUrl,
+          accessToken,
+          workspaceKeyHeader,
+          workspaceId,
+          question,
+          docIds,
+          previousResponseId: null,
+          model: opts.config
+        });
+        addTask({
+          id: result2.id,
+          question: question.slice(0, 200),
+          workspaceId,
+          submittedAt: (/* @__PURE__ */ new Date()).toISOString(),
+          status: "queued",
+          model: result2.model
+        });
+        if (opts.json) {
+          console.log(JSON.stringify({ id: result2.id, status: result2.status }));
+        } else {
+          console.log(`Task queued: ${chalk2__default.default.cyan(result2.id)}`);
+          console.log(
+            chalk2__default.default.dim("Use `arbi task status` or `arbi task result` to check progress.")
+          );
+        }
+        return;
+      }
       let res;
       try {
         res = await sdk.assistant.queryAssistant({
@@ -4567,19 +4680,47 @@ function registerAskCommand(program2) {
           model: opts.config
         });
       }
+      const verbose = opts.quiet === true ? false : getConfig()?.verbose !== false;
+      let elapsedTime = null;
       const result = await sdk.streamSSE(res, {
         onToken: (content) => process.stdout.write(content),
         onAgentStep: (data) => {
-          if (opts.verbose) {
+          if (verbose) {
             const label2 = sdk.formatAgentStepLabel(data);
             if (label2) console.error(chalk2__default.default.dim(`
 [agent] ${label2}`));
           }
         },
+        onElapsedTime: (t) => {
+          elapsedTime = t;
+        },
         onError: (message) => console.error(chalk2__default.default.red(`
 Error: ${message}`))
       });
       process.stdout.write("\n");
+      const parts = [];
+      if (result.agentSteps.length > 0) {
+        let stepLabel = `${result.agentSteps.length} step${result.agentSteps.length === 1 ? "" : "s"}`;
+        if (result.toolCallCount > 0) {
+          stepLabel += ` (${result.toolCallCount} tool call${result.toolCallCount === 1 ? "" : "s"})`;
+        }
+        parts.push(stepLabel);
+      }
+      if (result.usage) {
+        parts.push(`${result.usage.total_tokens.toLocaleString()} tokens`);
+      }
+      if (result.context && result.context.context_window > 0) {
+        const used = result.context.all_llm_calls?.last_input_tokens ?? result.context.total_input;
+        parts.push(
+          `${used.toLocaleString()}/${result.context.context_window.toLocaleString()} context`
+        );
+      }
+      if (elapsedTime != null) {
+        parts.push(`${elapsedTime.toFixed(1)}s`);
+      }
+      if (parts.length > 0) {
+        console.error(chalk2__default.default.dim(`[${parts.join(" \xB7 ")}]`));
+      }
       if (result.assistantMessageExtId) {
         const updates = {
           lastMessageExtId: result.assistantMessageExtId,
@@ -4594,6 +4735,109 @@ Error: ${message}`))
     })()
   );
 }
+function chunkScore(chunk) {
+  return chunk.metadata.rerank_score ?? chunk.metadata.score ?? 0;
+}
+function truncate(text, max) {
+  const oneLine = text.replace(/\n/g, " ").trim();
+  return oneLine.length > max ? oneLine.slice(0, max - 1) + "\u2026" : oneLine;
+}
+function fmtScore(score) {
+  const pct = Math.min(Math.round(score * 100), 100);
+  return `[${pct}%]`;
+}
+function registerFindCommand(program2) {
+  program2.command("find <query...>").description("Search documents without LLM generation (retrieve only)").option("-w, --workspace <id>", "Workspace ID (defaults to selected workspace)").option("-m, --mode <mode>", "Search mode: semantic, keyword, hybrid", "semantic").option("-d, --docs <ids>", "Comma-separated document IDs to search within").option("--min-score <n>", "Minimum relevance score 0-1", "0.2").option("-l, --limit <n>", "Max results to display", "20").option("--flat", "Flat list sorted by relevance (instead of grouped by document)").option("--toc <ids>", "Comma-separated doc IDs to fetch table of contents for").option("--full-context <ids>", "Comma-separated doc IDs to fetch full content for").option("--json", "Raw JSON output for scripting").action(
+    (words, opts) => runAction(async () => {
+      const query = words.join(" ");
+      const { arbi, workspaceId } = await resolveWorkspace(opts.workspace);
+      let docIds;
+      if (opts.docs) {
+        docIds = opts.docs.split(",").map((id) => id.trim());
+      } else {
+        const docs = await sdk.documents.listDocuments(arbi);
+        docIds = docs.map((d) => d.external_id);
+      }
+      if (docIds.length === 0) {
+        console.log("No documents found in workspace.");
+        return;
+      }
+      const searchMode = opts.mode ?? "semantic";
+      const tocDocIds = opts.toc ? opts.toc.split(",").map((id) => id.trim()) : void 0;
+      const fullContextDocIds = opts.fullContext ? opts.fullContext.split(",").map((id) => id.trim()) : void 0;
+      const result = await sdk.assistant.retrieve({
+        arbi,
+        workspaceId,
+        query,
+        docIds,
+        searchMode,
+        tocDocIds,
+        fullContextDocIds
+      });
+      const allChunks = [];
+      if (result.retrieval_chunk?.tool_responses) {
+        for (const chunks of Object.values(result.retrieval_chunk.tool_responses)) {
+          allChunks.push(...chunks);
+        }
+      }
+      const minScore = parseFloat(opts.minScore ?? "0.2");
+      const limit = parseInt(opts.limit ?? "20", 10);
+      const filtered = allChunks.filter((c) => chunkScore(c) >= minScore).sort((a, b) => chunkScore(b) - chunkScore(a)).slice(0, limit);
+      const uniqueDocs = new Set(filtered.map((c) => c.metadata.doc_ext_id));
+      if (opts.json) {
+        console.log(JSON.stringify(result, null, 2));
+        return;
+      }
+      if (filtered.length === 0) {
+        console.log("No results found.");
+        return;
+      }
+      console.log(
+        `
+Found ${chalk2__default.default.bold(String(filtered.length))} result${filtered.length === 1 ? "" : "s"} across ${chalk2__default.default.bold(String(uniqueDocs.size))} document${uniqueDocs.size === 1 ? "" : "s"}
+`
+      );
+      if (opts.flat) {
+        for (let i = 0; i < filtered.length; i++) {
+          const chunk = filtered[i];
+          const score = fmtScore(chunkScore(chunk));
+          const doc = chunk.metadata.doc_title ?? chunk.metadata.doc_ext_id ?? "";
+          const page = chunk.metadata.page_number ? `p.${chunk.metadata.page_number}` : "";
+          const preview = truncate(chunk.content, 80);
+          console.log(
+            `  ${chalk2__default.default.dim(String(i + 1).padStart(2, " "))}. ${chalk2__default.default.yellow(score)} ${chalk2__default.default.cyan(doc)} ${chalk2__default.default.dim(page)}`
+          );
+          console.log(`     ${chalk2__default.default.dim(preview)}`);
+        }
+        console.log();
+        return;
+      }
+      const grouped = /* @__PURE__ */ new Map();
+      for (const chunk of filtered) {
+        const key = chunk.metadata.doc_ext_id ?? "unknown";
+        if (!grouped.has(key)) grouped.set(key, []);
+        grouped.get(key).push(chunk);
+      }
+      for (const [, chunks] of grouped) {
+        const docTitle = chunks[0].metadata.doc_title ?? chunks[0].metadata.doc_ext_id ?? "Unknown";
+        const hitCount = chunks.length;
+        const header = `${docTitle} (${hitCount} hit${hitCount === 1 ? "" : "s"})`;
+        console.log(
+          `${chalk2__default.default.dim("\u2500\u2500")} ${chalk2__default.default.bold(header)} ${chalk2__default.default.dim("\u2500".repeat(Math.max(0, 50 - header.length)))}`
+        );
+        for (const chunk of chunks) {
+          const score = fmtScore(chunkScore(chunk));
+          const page = chunk.metadata.page_number ? `p.${chunk.metadata.page_number}` : "";
+          const preview = truncate(chunk.content, 72);
+          console.log(
+            `  ${chalk2__default.default.yellow(score)} ${chalk2__default.default.dim(page.padEnd(6))} ${chalk2__default.default.dim(preview)}`
+          );
+        }
+        console.log();
+      }
+    })()
+  );
+}
 function colorize2(level, text) {
   if (level === "success") return chalk2__default.default.green(text);
   if (level === "error") return chalk2__default.default.red(text);
@@ -5711,6 +5955,103 @@ function registerAgentCreateCommand(program2) {
     }
   );
 }
+function formatAge(isoDate) {
+  const ms = Date.now() - new Date(isoDate).getTime();
+  if (ms < 6e4) return `${Math.round(ms / 1e3)}s`;
+  if (ms < 36e5) return `${Math.round(ms / 6e4)}m`;
+  if (ms < 864e5) return `${Math.round(ms / 36e5)}h`;
+  return `${Math.round(ms / 864e5)}d`;
+}
+function resolveTaskId(taskIdArg) {
+  if (taskIdArg) return taskIdArg;
+  const latest = getLatestTask();
+  if (!latest) {
+    console.error(chalk2__default.default.red('No tasks found. Submit one with: arbi ask -b "your question"'));
+    process.exit(1);
+  }
+  return latest.id;
+}
+function statusColor(s) {
+  if (s === "completed") return chalk2__default.default.green(s);
+  if (s === "failed") return chalk2__default.default.red(s);
+  if (s === "queued" || s === "in_progress") return chalk2__default.default.yellow(s);
+  return s;
+}
+function registerTaskCommand(program2) {
+  const task = program2.command("task").description("Manage background tasks");
+  task.action(async (_opts, cmd) => {
+    await cmd.commands.find((c) => c.name() === "list").parseAsync([], { from: "user" });
+  });
+  task.command("list").description("List background tasks").action(
+    () => runAction(async () => {
+      const tasks = getTasks();
+      if (tasks.length === 0) {
+        console.log('No tasks. Submit one with: arbi ask -b "your question"');
+        return;
+      }
+      printTable(
+        [
+          { header: "ID", width: 20, value: (r) => r.id },
+          { header: "STATUS", width: 14, value: (r) => statusColor(r.status) },
+          { header: "QUESTION", width: 42, value: (r) => r.question },
+          { header: "AGE", width: 6, value: (r) => formatAge(r.submittedAt) }
+        ],
+        tasks
+      );
+    })()
+  );
+  task.command("status [task-id]").description("Check current task status (defaults to most recent)").option("-w, --workspace <id>", "Workspace ID").option("--json", "Output in JSON format").action(
+    (taskId, opts) => runAction(async () => {
+      const id = resolveTaskId(taskId);
+      const { accessToken, workspaceKeyHeader, config } = await resolveWorkspace(opts?.workspace);
+      const result = await sdk.responses.getResponse(
+        { baseUrl: config.baseUrl, accessToken, workspaceKeyHeader },
+        id
+      );
+      if (result.status === "completed" || result.status === "failed") {
+        updateTaskStatus(id, result.status);
+      }
+      if (opts?.json) {
+        console.log(JSON.stringify(result, null, 2));
+      } else {
+        console.log(`${chalk2__default.default.bold("ID:")}     ${result.id}`);
+        console.log(`${chalk2__default.default.bold("Status:")} ${statusColor(result.status)}`);
+        if (result.model) console.log(`${chalk2__default.default.bold("Model:")}  ${result.model}`);
+        if (result.usage) {
+          console.log(`${chalk2__default.default.bold("Tokens:")} ${result.usage.total_tokens.toLocaleString()}`);
+        }
+      }
+    })()
+  );
+  task.command("result [task-id]").description("Fetch and print the completed task result").option("-w, --workspace <id>", "Workspace ID").option("--json", "Output in JSON format").action(
+    (taskId, opts) => runAction(async () => {
+      const id = resolveTaskId(taskId);
+      const { accessToken, workspaceKeyHeader, config } = await resolveWorkspace(opts?.workspace);
+      const result = await sdk.responses.getResponse(
+        { baseUrl: config.baseUrl, accessToken, workspaceKeyHeader },
+        id
+      );
+      if (result.status === "completed" || result.status === "failed") {
+        updateTaskStatus(id, result.status);
+      }
+      if (opts?.json) {
+        console.log(JSON.stringify(result, null, 2));
+        return;
+      }
+      if (result.status !== "completed") {
+        console.error(
+          chalk2__default.default.yellow(`Task is ${result.status}. Use \`arbi task status\` to check progress.`)
+        );
+        process.exit(1);
+      }
+      const text = sdk.responses.extractResponseText(result);
+      process.stdout.write(text + "\n");
+      if (result.usage) {
+        console.error(chalk2__default.default.dim(`[${result.usage.total_tokens.toLocaleString()} tokens]`));
+      }
+    })()
+  );
+}
 
 // src/index.ts
 console.debug = () => {
@@ -5721,7 +6062,7 @@ console.info = (...args) => {
   _origInfo(...args);
 };
 var program = new commander.Command();
-program.name("arbi").description("ARBI CLI \u2014 interact with ARBI from the terminal").version("0.3.13");
+program.name("arbi").description("ARBI CLI \u2014 interact with ARBI from the terminal").version("0.3.15");
 registerConfigCommand(program);
 registerLoginCommand(program);
 registerRegisterCommand(program);
@@ -5732,6 +6073,7 @@ registerDocsCommand(program);
 registerUploadCommand(program);
 registerDownloadCommand(program);
 registerAskCommand(program);
+registerFindCommand(program);
 registerWatchCommand(program);
 registerContactsCommand(program);
 registerDmCommand(program);
@@ -5745,6 +6087,7 @@ registerTuiCommand(program);
 registerUpdateCommand(program);
 registerQuickstartCommand(program);
 registerAgentCreateCommand(program);
+registerTaskCommand(program);
 program.parse();
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map