@arbidocs/cli 0.4.32 → 0.4.37

package/dist/index.js

@@ -3694,7 +3694,7 @@ function getLatestVersion(skipCache = false) {
   }
 }
 function getCurrentVersion() {
-  return "0.4.32";
+  return "0.4.37";
 }
 function readChangelog(fromVersion, toVersion) {
   try {
@@ -3747,17 +3747,17 @@ function showChangelog(fromVersion, toVersion) {
 async function checkForUpdates(autoUpdate) {
   try {
     const latest = getLatestVersion();
-    if (!latest || latest === "0.4.32") return;
+    if (!latest || latest === "0.4.37") return;
     if (autoUpdate) {
       warn(`
-Your arbi version is out of date (${"0.4.32"} \u2192 ${latest}). Updating...`);
+Your arbi version is out of date (${"0.4.37"} \u2192 ${latest}). Updating...`);
       child_process.execSync("npm install -g @arbidocs/cli@latest", { stdio: "inherit" });
-      showChangelog("0.4.32", latest);
+      showChangelog("0.4.37", latest);
       console.log(`Updated to ${latest}.`);
     } else {
       warn(
         `
-Your arbi version is out of date (${"0.4.32"} \u2192 ${latest}).
+Your arbi version is out of date (${"0.4.37"} \u2192 ${latest}).
 Run "arbi update" to upgrade, or "arbi update auto" to always stay up to date.`
       );
     }
@@ -3789,10 +3789,10 @@ function markNagShown(latest) {
 function hintUpdateOnError() {
   try {
     const cached = readCache();
-    if (!cached || cached.latest === "0.4.32") return;
+    if (!cached || cached.latest === "0.4.37") return;
     if (!shouldShowNag(cached.latest)) return;
     warn(
-      `Your arbi version is out of date (${"0.4.32"} \u2192 ${cached.latest}). Run "arbi update".`
+      `Your arbi version is out of date (${"0.4.37"} \u2192 ${cached.latest}). Run "arbi update".`
     );
     markNagShown(cached.latest);
   } catch {
@@ -9583,7 +9583,7 @@ function resolveTaskId(taskIdArg) {
 }
 function statusColor2(s) {
   if (s === "completed") return chalk2__default.default.green(s);
-  if (s === "failed") return chalk2__default.default.red(s);
+  if (s === "failed" || s === "cancelled") return chalk2__default.default.red(s);
   if (s === "queued" || s === "in_progress") return chalk2__default.default.yellow(s);
   return s;
 }
@@ -9633,7 +9633,7 @@ function registerTaskCommand(program2) {
       const id = resolveTaskId(taskId);
       const { accessToken, config } = await resolveWorkspace(opts?.workspace);
       const result = await sdk.responses.getResponse({ baseUrl: config.baseUrl, accessToken }, id);
-      if (result.status === "completed" || result.status === "failed") {
+      if (result.status === "completed" || result.status === "failed" || result.status === "cancelled") {
         updateTaskStatus(id, result.status);
       }
       if (opts?.json) {
@@ -9653,7 +9653,7 @@ function registerTaskCommand(program2) {
       const id = resolveTaskId(taskId);
       const { accessToken, config } = await resolveWorkspace(opts?.workspace);
       const result = await sdk.responses.getResponse({ baseUrl: config.baseUrl, accessToken }, id);
-      if (result.status === "completed" || result.status === "failed") {
+      if (result.status === "completed" || result.status === "failed" || result.status === "cancelled") {
         updateTaskStatus(id, result.status);
       }
       if (opts?.json) {
@@ -9675,8 +9675,12 @@ function registerTaskCommand(program2) {
   );
 }
 function registerWorkflowCommand(program2) {
-  const workflow = program2.command("workflow").description("Workflows (/v1/workflow): create, list, resume, pause, run, delete");
-  workflow.command("create").description("Create a workflow with exactly one trigger").requiredOption("--name <name>", "Workflow name (required)").option("--rrule <RRULE>", "Trigger: RFC-5545 recurrence rule").option("--run-at <ISO>", "Trigger: run once at this time (ISO-8601)").option("--event-kind <kind>", "Trigger: a notification type to react to").option("--after <con-id>", "Trigger: when this task (conversation) is done").option("--timezone <tz>", "IANA timezone for --rrule", "UTC").option("--prompt <text>", "Instruction the agent runs").option("--skill <ref>", "Skill reference to run").option("--agent <agt-id>", "Agent to run it as (external id)").option("--workspace <wrk-id>", "Workspace to scope the workflow to (default: the current one)").option("--shared", "Share it with the workspace").option("--json", "Output as JSON").action(
+  const workflow = program2.command("workflow").alias("automation").description("Workflows (/v1/workflow): create, list, resume, pause, run, delete");
+  workflow.command("create").description("Create a workflow with exactly one trigger").requiredOption("--name <name>", "Workflow name (required)").option("--rrule <RRULE>", "Trigger: RFC-5545 recurrence rule").option("--run-at <ISO>", "Trigger: run once at this time (ISO-8601)").option("--event-kind <kind>", "Trigger: a notification type to react to").option("--after <con-id>", "Trigger: when this task (conversation) is done").option("--timezone <tz>", "IANA timezone for --rrule", "UTC").option("--action <type>", "Action: annotate_documents or email_documents").option("--documents <ids>", "Comma-separated document IDs").option("--labels <ids>", "Select documents matching these label IDs at execution time").option("--latest", "Select documents uploaded since the previous successful run").option("--tags <ids>", "Annotation field IDs for AI review").option("--overwrite", "Regenerate existing annotation answers").option(
+    "--auth-mode <mode>",
+    "scheduled_require_auth or scheduled_permanent",
+    "scheduled_require_auth"
+  ).option("--event-filter <json>", "Notification attribute filters as a JSON object").option("--prompt <text>", "Instruction the agent runs").option("--skill <ref>", "Skill reference to run").option("--agent <agt-id>", "Agent to run it as (external id)").option("--workspace <wrk-id>", "Workspace to scope the workflow to (default: the current one)").option("--shared", "Share it with the workspace").option("--json", "Output as JSON").action(
     (opts) => runAction(async () => {
       const { arbi, workspaceId } = await resolveWorkspace();
       const body = {
@@ -9688,9 +9692,31 @@ function registerWorkflowCommand(program2) {
         timezone: opts.timezone,
         prompt: opts.prompt ?? "",
         // Unattended runs ask the owner for access each time unless the workflow is made permanent.
-        auth_mode: "scheduled_require_auth",
+        auth_mode: opts.authMode,
         workspace_ext_id: opts.workspace ?? workspaceId
       };
+      if (!["scheduled_require_auth", "scheduled_permanent"].includes(opts.authMode)) {
+        throw new Error(
+          "Invalid --auth-mode: use scheduled_require_auth or scheduled_permanent"
+        );
+      }
+      if (opts.action) {
+        if (!["annotate_documents", "email_documents"].includes(opts.action)) {
+          throw new Error("Invalid --action: use annotate_documents or email_documents");
+        }
+        const ids = (value) => value?.split(",").map((id) => id.trim()).filter(Boolean) ?? [];
+        body.action = {
+          type: opts.action,
+          documents: {
+            doc_ext_ids: ids(opts.documents),
+            label_ext_ids: ids(opts.labels),
+            latest: !!opts.latest
+          },
+          tag_ext_ids: ids(opts.tags),
+          overwrite: !!opts.overwrite
+        };
+      }
+      if (opts.eventFilter) body.event_filter = JSON.parse(opts.eventFilter);
       if (opts.rrule) body.rrule = opts.rrule;
       if (opts.runAt) body.run_at = opts.runAt;
       if (opts.eventKind) body.event_kind = opts.eventKind;
@@ -9735,7 +9761,7 @@ function registerWorkflowCommand(program2) {
       })()
     );
   }
-  workflow.command("run <id>").description("Run a workflow now (creates a task like its trigger would)").option("--json", "Output as JSON").action(
+  workflow.command("run <id>").description("Start the saved action now (document actions do not create a thread)").option("--json", "Output as JSON").action(
     (id, opts) => runAction(async () => {
       const { arbi } = await resolveAuth();
       const data = await sdk.workflows.runWorkflow(arbi, id);
@@ -9743,7 +9769,47 @@ function registerWorkflowCommand(program2) {
         printJson(data);
         return;
       }
-      success(`Started workflow ${ref(id)}`);
+      if (data.error) throw new Error(data.error);
+      success(
+        `${data.started ? "Started" : "Submitted"} automation ${ref(id)}${data.execution_id ? ` \u2014 execution ${data.execution_id}` : ""}${data.conversation_ext_id ? ` \u2014 thread ${ref(data.conversation_ext_id)}` : ""}`
+      );
+    })()
+  );
+  workflow.command("get <id>").description("Read the complete saved automation configuration").action(
+    (id) => runAction(async () => {
+      const { arbi } = await resolveAuth();
+      printJson(await sdk.workflows.getWorkflow(arbi, id));
+    })()
+  );
+  workflow.command("runs <id>").alias("executions").description("Show persisted document-action runs, results and failures").option("--json", "Output as JSON").action(
+    (id, opts) => runAction(async () => {
+      const { arbi } = await resolveAuth();
+      const data = await sdk.workflows.listWorkflowRuns(arbi, id);
+      if (!emitListOrTable(data, opts, "This automation has not run yet.")) return;
+      printTable(
+        [
+          { header: "RUN", width: 10, value: (r) => String(r.id) },
+          { header: "STATUS", width: 14, value: (r) => String(r.status) },
+          { header: "ACTION", width: 22, value: (r) => String(r.action_type) },
+          {
+            header: "DOCUMENTS",
+            width: 12,
+            value: (r) => String(r.document_ext_ids.length)
+          },
+          { header: "CREATED", width: 26, value: (r) => String(r.created_at) },
+          { header: "ERROR", width: 40, value: (r) => String(r.error ?? "") }
+        ],
+        data
+      );
+    })()
+  );
+  workflow.command("update <id>").description("Update any saved automation settings from a JSON file").requiredOption("--file <path>", "JSON UpdateWorkflowRequest file").option("--json", "Output as JSON").action(
+    (id, opts) => runAction(async () => {
+      const { arbi } = await resolveAuth();
+      const body = JSON.parse(fs5.readFileSync(opts.file, "utf8"));
+      const data = await sdk.workflows.updateWorkflow(arbi, id, body);
+      if (opts.json) printJson(data);
+      else success(`Updated automation ${ref(id)}`);
     })()
   );
   workflow.command("delete <id>").description("Delete a workflow (tasks it already created stay)").action(
@@ -10045,6 +10111,204 @@ function registerSessionCommand(program2) {
     await session.commands.find((c) => c.name() === "list").parseAsync([], { from: "user" });
   });
 }
+function parseAddress(value) {
+  const match = /^\s*(.*?)\s*<([^<>\s]+)>\s*$/.exec(value);
+  const email = (match ? match[2] : value).trim();
+  if (!/^[^\s@<>]+@[^\s@<>]+\.[^\s@<>]+$/.test(email)) {
+    throw new Error(`Not an email address: ${value}`);
+  }
+  const name = match?.[1].replace(/^"|"$/g, "");
+  return name ? { email, name } : { email };
+}
+function collect(value, previous = []) {
+  return [...previous, ...value.split(",").filter((v) => v.trim())];
+}
+var readTextFile = (path7) => fs5__default.default.readFileSync(path7 === "-" ? 0 : path7, "utf8");
+function buildCompose(options) {
+  const read = options.readText ?? readTextFile;
+  if (options.text !== void 0 && options.textFile) {
+    throw new Error("Use either --text or --text-file, not both");
+  }
+  if (options.html !== void 0 && options.htmlFile) {
+    throw new Error("Use either --html or --html-file, not both");
+  }
+  const html = options.html ?? (options.htmlFile ? read(options.htmlFile) : void 0);
+  return {
+    to: (options.to ?? []).map(parseAddress),
+    cc: (options.cc ?? []).map(parseAddress),
+    bcc: (options.bcc ?? []).map(parseAddress),
+    subject: options.subject ?? "",
+    text: options.text ?? (options.textFile ? read(options.textFile) : ""),
+    ...html ? { html } : {},
+    secure_delivery: false,
+    attachments: (options.attach ?? []).map((file) => sdk.mailNode.attachmentFromFile(file))
+  };
+}
+function addComposeOptions(command) {
+  return command.option("--to <addresses>", "Recipient(s), comma-separated or repeated", collect).option("--cc <addresses>", "Cc recipient(s)", collect).option("--bcc <addresses>", "Bcc recipient(s)", collect).option("-s, --subject <subject>", "Subject").option("--text <text>", "Plain-text body").option("--text-file <path>", "Read the plain-text body from a file (- for stdin)").option("--html <html>", "HTML body (the plain text stays as the fallback)").option("--html-file <path>", "Read the HTML body from a file (- for stdin)").option("-a, --attach <path>", "Attach a file (repeatable)", (v, prev = []) => [
+    ...prev,
+    v
+  ]).option("--json", "Output as JSON (recommended for scripting / agents)");
+}
+function registerMailCommand(program2) {
+  const mail = program2.command("mail").enablePositionalOptions().description("Your ARBI mailbox: read, draft and send (an agent can only draft)");
+  async function connect() {
+    const { loginResult, config } = await resolveAuth();
+    return {
+      fetch: sdk.mail.createMailFetch({
+        baseUrl: config.baseUrl,
+        accessToken: loginResult.accessToken
+      }),
+      login: loginResult,
+      isAgent: Boolean(loginResult.parentExtId)
+    };
+  }
+  async function connectToRead() {
+    const ctx = await connect();
+    if (ctx.isAgent) {
+      error("Agents can only create drafts. Use: arbi mail draft --to <address> ...");
+      process.exit(1);
+    }
+    await sdk.mail.unlockNativeMail(ctx.fetch, {
+      signingPrivateKey: ctx.login.signingPrivateKey,
+      serverSessionKey: ctx.login.serverSessionKey
+    });
+    return ctx;
+  }
+  mail.command("alias <name>").description("Claim your ARBI address, name@<deployment domain> (one per user)").action(
+    (name) => runAction(async () => {
+      const { fetch: fetch2 } = await connect();
+      success(`Your ARBI email is ${await sdk.mail.claimNativeAlias(fetch2, name.toLowerCase())}`);
+    })()
+  );
+  mail.command("folders").description("List folders with unread counts").option("--json", "Output as JSON").action(
+    (opts) => runAction(async () => {
+      const { fetch: fetch2 } = await connectToRead();
+      const folders = await sdk.mail.listFolders(fetch2);
+      if (opts.json) return printJson(folders);
+      printTable(
+        [
+          { header: "ID", width: 14, value: (f) => f.id },
+          { header: "NAME", width: 20, value: (f) => f.name },
+          { header: "UNREAD", width: 8, value: (f) => String(f.unread ?? 0) }
+        ],
+        folders
+      );
+    })()
+  );
+  mail.command("list").description("List messages in a folder (default: inbox)").option("-f, --folder <id>", "Folder id: inbox, sent, drafts, archive, trash", "inbox").option("-q, --query <text>", "Filter by subject, sender or recipient").option("-l, --limit <n>", "Messages per page", (v) => parseInt(v, 10), 30).option("--cursor <cursor>", "Continue from a previous page (its next_cursor)").option("--json", "Output as JSON (includes next_cursor)").action(
+    (opts) => runAction(async () => {
+      const { fetch: fetch2 } = await connectToRead();
+      const page = await sdk.mail.listMessages(fetch2, {
+        folderId: opts.folder,
+        query: opts.query,
+        limit: opts.limit,
+        cursor: opts.cursor
+      });
+      if (opts.json) return printJson(page);
+      if (page.messages.length === 0) {
+        process.stderr.write("No messages.\n");
+        return;
+      }
+      const people = (m) => (["sent", "drafts"].includes(opts.folder) ? m.to : m.sender).map((a) => a.name || a.email).join(", ");
+      printTable(
+        [
+          { header: "ID", width: 38, value: (m) => m.id },
+          { header: "WHO", width: 24, value: (m) => truncate(people(m), 23) },
+          {
+            header: "SUBJECT",
+            width: 40,
+            value: (m) => truncate(m.subject || "(no subject)", 39)
+          },
+          {
+            header: "FLAGS",
+            width: 14,
+            value: (m) => [
+              m.unread ? "unread" : "",
+              m.attachments.length ? "attach" : "",
+              m.drafted_by ? `by ${m.drafted_by}` : ""
+            ].filter(Boolean).join(" ")
+          }
+        ],
+        page.messages
+      );
+      if (page.next_cursor) dim(`More: --cursor ${page.next_cursor}`);
+    })()
+  );
+  mail.command("read <id>").description("Read a message, or save one of its attachments with --attachment").option("--attachment <id>", "Save this attachment (id from the attachment list) instead").option("-o, --output <path>", "Where to save the attachment (default: its file name)").option("--json", "Output the full message as JSON").action(
+    (id, opts) => runAction(async () => {
+      const { fetch: fetch2 } = await connectToRead();
+      const message = await sdk.mail.getMessage(fetch2, id);
+      if (opts.attachment !== void 0) {
+        const meta = message.attachments.find((a) => a.id === opts.attachment);
+        if (!meta) throw new Error(`No attachment ${opts.attachment} on this message`);
+        const bytes = await sdk.mail.downloadAttachment(fetch2, id, meta.id);
+        const target = opts.output ?? meta.name;
+        fs5__default.default.writeFileSync(target, bytes);
+        success(`Saved ${target} (${bytes.length} bytes)`);
+        return;
+      }
+      if (opts.json) return printJson(message);
+      const who = (list) => list.map((a) => a.name ? `${a.name} <${a.email}>` : a.email).join(", ");
+      console.log(`From:    ${who(message.sender)}`);
+      console.log(`To:      ${who(message.to)}`);
+      if (message.cc.length) console.log(`Cc:      ${who(message.cc)}`);
+      console.log(`Subject: ${message.subject}`);
+      if (message.received_at) console.log(`Date:    ${message.received_at}`);
+      if (message.drafted_by) console.log(`Drafted by: ${message.drafted_by}`);
+      if (message.attachments.length) {
+        console.log(
+          `Attachments: ${message.attachments.map((a) => `${a.name} (id ${a.id}, ${a.size} bytes)`).join("; ")}`
+        );
+      }
+      console.log(`
+${message.text}`);
+    })()
+  );
+  addComposeOptions(
+    mail.command("draft").description(
+      "Save a draft. Run by an agent, it goes to its owner's Drafts, from their address, for them to review and send"
+    )
+  ).action(
+    (opts) => runAction(async () => {
+      const compose = buildCompose(opts);
+      const { fetch: fetch2, isAgent } = await connect();
+      const saved = await sdk.mail.saveDraft(fetch2, compose);
+      if (opts.json) return printJson(saved);
+      success(
+        isAgent ? `Draft ${saved.id} saved to your owner's Drafts. They review it and send.` : `Draft ${saved.id} saved to Drafts.`
+      );
+    })()
+  );
+  addComposeOptions(
+    mail.command("send").description("Send a message from your ARBI address (not available to agents)")
+  ).option("--request-id <id>", "Idempotency key: retrying with the same id never sends twice").action(
+    (opts) => runAction(async () => {
+      const compose = buildCompose(opts);
+      if (compose.to?.length === 0 && compose.cc?.length === 0 && compose.bcc?.length === 0) {
+        throw new Error("Add at least one recipient with --to, --cc or --bcc");
+      }
+      const { fetch: fetch2, isAgent } = await connect();
+      if (isAgent) {
+        error("Agents cannot send mail. Save a draft instead: arbi mail draft ...");
+        process.exit(1);
+      }
+      const result = await sdk.mail.sendMessage(fetch2, { ...compose, request_id: opts.requestId });
+      if (opts.json) return printJson(result);
+      success(`Sent (${result.id}).`);
+    })()
+  );
+  mail.arguments("[maybeSubcommand]").action((maybe) => {
+    if (maybe) {
+      suggestSubcommandAndExit(
+        "mail",
+        maybe,
+        mail.commands.map((c) => c.name())
+      );
+    }
+    mail.outputHelp();
+  });
+}
 function registerNotificationsCommand(program2) {
   const notif = program2.command("notifications").enablePositionalOptions().description("Non-DM notifications");
   notif.command("list").description("List non-DM notifications (workspace invites, contact accepts, \u2026)").option("--unread", "Only show unread notifications").option("--type <comma-list>", "Filter to specific type(s), e.g. workspaceuser_invited").option("-l, --limit <n>", "Cap to N most-recent", (v) => parseInt(v, 10)).option("--json", "Output as JSON (recommended for scripting / agents)").action(
@@ -10610,7 +10874,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.4.32").showHelpAfterError(true).showSuggestionAfterError(true);
+program.name("arbi").description("ARBI CLI \u2014 interact with ARBI from the terminal").version("0.4.37").showHelpAfterError(true).showSuggestionAfterError(true);
 registerConfigCommand(program);
 registerLoginCommand(program);
 registerRegisterCommand(program);
@@ -10645,6 +10909,7 @@ registerListenCommand(program);
 registerSessionCommand(program);
 registerLocalCommand(program);
 registerNotificationsCommand(program);
+registerMailCommand(program);
 registerProjectCommand(program);
 registerFilesCommand(program);
 registerUsageCommand(program);