@arbidocs/cli 0.3.65 → 0.3.67

package/CHANGELOG.md

@@ -1,5 +1,45 @@
 # Changelog
 
+## v0.3.67
+
+[compare changes](https://github.com/arbicity/ARBI-frontend/compare/v0.3.66...HEAD)
+
+### 🚀 Enhancements
+
+- **tui:** SOTA amendments — citations, events, tool blocks, view/sources/history ([#774](https://github.com/arbicity/ARBI-frontend/pull/774))
+- **sdk,cli,tui:** Consume GET /v1/assistant/skills for slash autocomplete ([#776](https://github.com/arbicity/ARBI-frontend/pull/776))
+- **tui,cli:** Unified slash dispatcher + autocomplete merges static commands and skills ([#777](https://github.com/arbicity/ARBI-frontend/pull/777))
+- **sdk,tui,cli,react:** Skill iteration loop — edit/install/pre-flight + React slash menu ([#778](https://github.com/arbicity/ARBI-frontend/pull/778))
+
+## v0.3.66
+
+[compare changes](https://github.com/arbicity/ARBI-frontend/compare/v0.3.65...HEAD)
+
+### 🚀 Enhancements
+
+- **artifact:** Always-editable .md tab + mount-time normalisation absorption ([#754](https://github.com/arbicity/ARBI-frontend/pull/754))
+- **dm:** WhatsApp-style chat bubbles, conversation header, date separators ([#762](https://github.com/arbicity/ARBI-frontend/pull/762))
+
+### 🩹 Fixes
+
+- **pdf:** Polyfill the bleeding-edge TC39 APIs pdfjs 5.x relies on ([#755](https://github.com/arbicity/ARBI-frontend/pull/755))
+- **grid:** Filter task_update transactions to rows the grid actually has ([#756](https://github.com/arbicity/ARBI-frontend/pull/756))
+- **auth:** Gate protected queries on token+user, not token alone ([#757](https://github.com/arbicity/ARBI-frontend/pull/757))
+- **mcp:** Read 'sk' JWT claim, not 'session_key', in openAllWorkspacesForSession ([#758](https://github.com/arbicity/ARBI-frontend/pull/758))
+- **docviewer:** Treat *.md uploads as markdown docs; restore Edit/Cancel toggle ([#760](https://github.com/arbicity/ARBI-frontend/pull/760))
+- **ui:** Restore logout modal with active sessions list ([#768](https://github.com/arbicity/ARBI-frontend/pull/768))
+- **sdk,cli:** Keep PA-agent CLI on the same session across workspace touches ([#769](https://github.com/arbicity/ARBI-frontend/pull/769))
+- **sdk:** Restore userExtId and always call /open in session fast-path ([#771](https://github.com/arbicity/ARBI-frontend/pull/771))
+
+### 💅 Refactors
+
+- Remove obsolete isDelegatedSession state ([#765](https://github.com/arbicity/ARBI-frontend/pull/765), [#766](https://github.com/arbicity/ARBI-frontend/pull/766))
+
+### 🏡 Chore
+
+- **lint:** Zero warnings — drop unused userSettings hook in Dashboard, extract UserSettings experimental section ([#753](https://github.com/arbicity/ARBI-frontend/pull/753))
+- **ci:** Run SDK unit tests on every PR ([#770](https://github.com/arbicity/ARBI-frontend/pull/770))
+
 ## v0.3.65
 
 [compare changes](https://github.com/arbicity/ARBI-frontend/compare/v0.3.64...HEAD)

package/dist/index.js

@@ -113,9 +113,9 @@ function getCachedWorkspaceName(id) {
     return null;
   }
 }
-function updateCompletionCache(workspaces3) {
+function updateCompletionCache(workspaces4) {
   const cache = {
-    workspaces: workspaces3.filter((w) => w.external_id).map((w) => ({ id: w.external_id, name: w.name ?? "" })),
+    workspaces: workspaces4.filter((w) => w.external_id).map((w) => ({ id: w.external_id, name: w.name ?? "" })),
     updatedAt: (/* @__PURE__ */ new Date()).toISOString()
   };
   const filePath = getCacheFile();
@@ -3694,7 +3694,7 @@ function getLatestVersion(skipCache = false) {
   }
 }
 function getCurrentVersion() {
-  return "0.3.65";
+  return "0.3.67";
 }
 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.3.65") return;
+    if (!latest || latest === "0.3.67") return;
     if (autoUpdate) {
       warn(`
-Your arbi version is out of date (${"0.3.65"} \u2192 ${latest}). Updating...`);
+Your arbi version is out of date (${"0.3.67"} \u2192 ${latest}). Updating...`);
       child_process.execSync("npm install -g @arbidocs/cli@latest", { stdio: "inherit" });
-      showChangelog("0.3.65", latest);
+      showChangelog("0.3.67", latest);
       console.log(`Updated to ${latest}.`);
     } else {
       warn(
         `
-Your arbi version is out of date (${"0.3.65"} \u2192 ${latest}).
+Your arbi version is out of date (${"0.3.67"} \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.3.65") return;
+    if (!cached || cached.latest === "0.3.67") return;
     if (!shouldShowNag(cached.latest)) return;
     warn(
-      `Your arbi version is out of date (${"0.3.65"} \u2192 ${cached.latest}). Run "arbi update".`
+      `Your arbi version is out of date (${"0.3.67"} \u2192 ${cached.latest}). Run "arbi update".`
     );
     markNagShown(cached.latest);
   } catch {
@@ -4353,8 +4353,8 @@ Open this URL in your browser:
         })();
         if (!opts.json) success(`Logged in as ${email}`);
         clearChatSession();
-        const { data: workspaces3 } = await arbi.fetch.GET("/v1/user/workspaces");
-        const wsList = workspaces3 || [];
+        const { data: workspaces4 } = await arbi.fetch.GET("/v1/user/workspaces");
+        const wsList = workspaces4 || [];
         updateCompletionCache(wsList);
         const memberWorkspaces = wsList.filter(
           (ws) => ws.users?.some((u) => u.user.email === email)
@@ -4688,8 +4688,8 @@ async function loginAfterRegister(config, email, password2, { json = false } = {
   try {
     const { arbi, loginResult } = await sdk.performPasswordLogin(config, email, password2, store);
     if (!json) success(`Logged in as ${email}`);
-    const { data: workspaces3 } = await arbi.fetch.GET("/v1/user/workspaces");
-    const wsList = workspaces3 || [];
+    const { data: workspaces4 } = await arbi.fetch.GET("/v1/user/workspaces");
+    const wsList = workspaces4 || [];
     updateCompletionCache(wsList);
     const memberWorkspaces = wsList.filter((ws) => ws.users?.some((u) => u.user.email === email));
     let selectedWorkspace;
@@ -4842,8 +4842,12 @@ function registerWorkspacesCommand(program2) {
       }
       if (opts.json) {
         const selectedId2 = getConfig()?.selectedWorkspaceId ?? null;
+        const myEmail = store.requireCredentials().email;
         const out = data.map((w) => {
-          const role = w.users?.[0]?.role ?? null;
+          const myRow = w.users?.find(
+            (u) => u?.user?.email === myEmail
+          );
+          const role = myRow?.role ?? null;
           return {
             id: w.external_id,
             name: w.name,
@@ -4884,10 +4888,16 @@ function registerWorkspacesCommand(program2) {
           {
             header: "ROLE",
             width: 12,
-            // `common` (italics dimmed) for memberless rows the caller can
-            // see only because it's a deployment-wide workspace. The blank
-            // ROLE that used to render here read like missing data.
-            value: (r) => r.users?.[0]?.role ?? "common"
+            // `common` (italics dimmed) for memberless rows the caller
+            // can see only because it's a deployment-wide workspace.
+            // Match by the caller's email so we render *our* role, not
+            // whichever membership happens to come first in the array.
+            value: (r) => {
+              const myRow = r.users?.find(
+                (u) => u?.user?.email === store.requireCredentials().email
+              );
+              return myRow?.role ?? "common";
+            }
           }
         ],
         data
@@ -5359,7 +5369,13 @@ function registerDocsCommand(program2) {
     "Write output to a file instead of stdout. Extension determines the format when combined with --ids/--json/--csv (default: csv with doc_id, file_name, folder, status)"
   ).action(
     (opts) => runAction(async () => {
-      const { arbi } = await resolveWorkspace(opts.workspace);
+      const { arbi, workspaceId } = await resolveWorkspace(opts.workspace);
+      let workspaceName = null;
+      try {
+        const list = await sdk.workspaces.listWorkspaces(arbi);
+        workspaceName = list.find((w) => w.external_id === workspaceId)?.name ?? null;
+      } catch {
+      }
       const fields = opts.lite ? "lite" : void 0;
       const hardLimit = opts.limit ? parseInt(opts.limit, 10) : void 0;
       const needsSort = !!(opts.sort && opts.sort !== "status");
@@ -5416,15 +5432,27 @@ function registerDocsCommand(program2) {
       }
       if (totalFetched === 0 && data.length === 0) {
         if (opts.json) {
-          if (opts.output) fs5.writeFileSync(opts.output, "[]\n");
-          else console.log("[]");
+          const emptyPayload = JSON.stringify(
+            {
+              workspace: { external_id: workspaceId, name: workspaceName },
+              documents: []
+            },
+            null,
+            opts.output ? 2 : 0
+          );
+          if (opts.output) fs5.writeFileSync(opts.output, emptyPayload + "\n");
+          else console.log(emptyPayload);
         } else if (opts.ids) {
           if (opts.output) fs5.writeFileSync(opts.output, "");
         } else if (opts.csv) {
           if (opts.output) fs5.writeFileSync(opts.output, csvHeader + "\n");
         } else if (opts.count) {
+          const wsLabel2 = workspaceName ? `${workspaceName} (${workspaceId})` : workspaceId;
+          console.log(chalk2__default.default.dim(`Workspace: ${wsLabel2}`));
           console.log("0");
         } else {
+          const wsLabel2 = workspaceName ? `${workspaceName} (${workspaceId})` : workspaceId;
+          console.log(chalk2__default.default.dim(`Workspace: ${wsLabel2}`));
           console.log("No documents found.");
         }
         return;
@@ -5466,6 +5494,8 @@ function registerDocsCommand(program2) {
           }).length;
           const totalPages = data.reduce((sum, d) => sum + (d.n_pages ?? 0), 0);
           const totalTokens = data.reduce((sum, d) => sum + (d.tokens ?? 0), 0);
+          const wsLabel2 = workspaceName ? `${workspaceName} (${workspaceId})` : workspaceId;
+          console.log(chalk2__default.default.dim(`Workspace: ${wsLabel2}`));
           console.log(chalk2__default.default.bold(`Total: ${data.length} documents`));
           for (const [status2, count] of Object.entries(counts).sort()) {
             const colorFn = statusColor(status2);
@@ -5491,7 +5521,11 @@ function registerDocsCommand(program2) {
         return;
       }
       if (opts.json) {
-        writeOut(JSON.stringify(data, null, opts.output ? 2 : 0), "json");
+        const payload = {
+          workspace: { external_id: workspaceId, name: workspaceName },
+          documents: data
+        };
+        writeOut(JSON.stringify(payload, null, opts.output ? 2 : 0), "json");
         return;
       }
       if (opts.csv || opts.output && !opts.ids && !opts.json) {
@@ -5502,6 +5536,8 @@ function registerDocsCommand(program2) {
         writeOut(lines.join("\n"), "csv");
         return;
       }
+      const wsLabel = workspaceName ? `${workspaceName} (${workspaceId})` : workspaceId;
+      console.log(chalk2__default.default.dim(`Workspace: ${wsLabel}`));
       console.log(chalk2__default.default.dim(`${data.length} documents
 `));
       printTable(
@@ -6335,7 +6371,10 @@ function registerUploadCommand(program2) {
   ).option(
     "-s, --s3",
     "Upload via the direct-to-MinIO flow (SecretBox on the client, presigned PUT)"
-  ).option("--folder <name>", "Backend folder for plain-file uploads (direct upload only)").action(
+  ).option("--folder <name>", "Backend folder for plain-file uploads (direct upload only)").option(
+    "--wp-type <type>",
+    "Work product type: source (default), skill, memory, artifact, webpage. Use --wp-type skill with --folder skills/<slug> to upload a SKILL.md."
+  ).action(
     (paths, opts) => runAction(async () => {
       const isManifestMode = Boolean(opts.manifest || opts.log || opts.resume);
       const inputPaths = paths ?? [];
@@ -6492,7 +6531,10 @@ function registerUploadCommand(program2) {
             summary.totalFiles += 1;
             continue;
           }
-          const result = await sdk.documentsNode.uploadLocalFile(auth, filePath);
+          const result = await sdk.documentsNode.uploadLocalFile(auth, filePath, {
+            folder: opts.folder,
+            wpType: opts.wpType
+          });
           if (!opts.json) {
             success(`Uploaded: ${result.fileName} (${(result.doc_ext_ids ?? []).join(", ")})`);
             if (result.skipped && result.skipped.length > 0) {
@@ -8947,8 +8989,8 @@ async function runQuickstart(url) {
   try {
     const { arbi, loginResult } = await sdk.performPasswordLogin(config, email, password2, store);
     success(`Logged in as ${email}`);
-    const { data: workspaces3 } = await arbi.fetch.GET("/v1/user/workspaces");
-    const wsList = workspaces3 || [];
+    const { data: workspaces4 } = await arbi.fetch.GET("/v1/user/workspaces");
+    const wsList = workspaces4 || [];
     const memberWorkspaces = wsList.filter((ws) => ws.users?.some((u) => u.user.email === email));
     const userProjects = await sdk.projects.listProjects(arbi);
     const defaultProjectExtId = userProjects[0]?.external_id;
@@ -10040,6 +10082,142 @@ function registerAuthCommand(program2) {
     await auth.commands.find((c) => c.name() === "profile").parseAsync(tail, { from: "user" });
   });
 }
+function extractSlugFromFrontmatter(body) {
+  const normalized = body.replace(/\r\n/g, "\n");
+  if (!normalized.startsWith("---\n")) return null;
+  const end = normalized.indexOf("\n---", 4);
+  if (end < 0) return null;
+  const block = normalized.slice(4, end);
+  for (const line of block.split("\n")) {
+    const m = /^name:\s*(.+?)\s*$/.exec(line);
+    if (m) {
+      return m[1].toLowerCase().replace(/['"]/g, "").replace(/[_\s]+/g, "-").replace(/[^a-z0-9-]/g, "").replace(/-+/g, "-").replace(/^-|-$/g, "");
+    }
+  }
+  return null;
+}
+async function loadSkillSource(source) {
+  if (source.startsWith("http://") || source.startsWith("https://")) {
+    const res = await fetch(source);
+    if (!res.ok) {
+      throw new Error(`Failed to fetch ${source}: HTTP ${res.status} ${res.statusText}`);
+    }
+    return await res.text();
+  }
+  const stat = fs5.statSync(source);
+  if (stat.isDirectory()) {
+    throw new Error(
+      `${source} is a directory. Pass a single SKILL.md file, or use \`\`arbi upload --folder skills/<slug> --wp-type skill\`\` for multi-file skills.`
+    );
+  }
+  return fs5.readFileSync(source, "utf8");
+}
+function registerSkillsCommand(program2) {
+  const skills = program2.command("skills").description("Skills: list, show");
+  skills.command("list").description("List user-invocable skills in the active workspace").option("--json", "Output as JSON").option("--include-hidden", "Include skills with user-invocable: false").action(
+    (opts) => runAction(async () => {
+      const { arbi } = await resolveWorkspace();
+      const list = await sdk.assistant.listSkills(arbi, {
+        includeHidden: opts.includeHidden
+      });
+      if (opts.json) {
+        console.log(JSON.stringify(list, null, 2));
+        return;
+      }
+      if (list.length === 0) {
+        process.stderr.write(
+          "No skills in this workspace yet. Upload a SKILL.md with wp_type=skill to add one.\n"
+        );
+        return;
+      }
+      printTable(
+        [
+          { header: "SLUG", width: 20, value: (r) => r.slug ?? "" },
+          { header: "NAME", width: 24, value: (r) => r.name ?? "" },
+          {
+            header: "TYPE",
+            width: 10,
+            value: (r) => r.skill_type ?? "markdown"
+          },
+          {
+            header: "ARGS",
+            width: 20,
+            value: (r) => r.arg_hint ?? ""
+          },
+          {
+            header: "DESCRIPTION",
+            width: 40,
+            value: (r) => r.description ?? ""
+          }
+        ],
+        list
+      );
+    })()
+  );
+  skills.command("install <source>").description(
+    "Install a skill from a URL or local path (SKILL.md). Slug derived from frontmatter unless --slug is given."
+  ).option("--slug <slug>", "Override the slug (default: derived from frontmatter name)").option("--json", "Output the upload result as JSON").action(
+    (source, opts) => runAction(async () => {
+      const ctx = await resolveWorkspace();
+      const authHeaders = {
+        baseUrl: ctx.config.baseUrl,
+        accessToken: ctx.accessToken
+      };
+      const body = await loadSkillSource(source);
+      const slug = opts.slug ?? extractSlugFromFrontmatter(body) ?? (() => {
+        process.stderr.write(
+          "Could not derive slug: no --slug flag and no ``name:`` in frontmatter.\nAdd a frontmatter block like:\n\n  ---\n  name: my-skill\n  description: \u2026\n  ---\n\nor pass ``--slug my-skill`` explicitly.\n"
+        );
+        process.exit(1);
+      })();
+      const blob = new Blob([body], { type: "text/markdown" });
+      const result = await sdk.documents.uploadFile(authHeaders, blob, "SKILL.md", {
+        folder: `skills/${slug}`,
+        wpType: "skill"
+      });
+      if (opts.json) {
+        console.log(JSON.stringify({ slug, ...result }, null, 2));
+        return;
+      }
+      console.log(bold(`Installed skill: ${slug}`));
+      console.log(dim(`source: ${source}`));
+      console.log(dim(`folder: skills/${slug}`));
+      console.log(
+        dim("Backend frontmatter loader picks it up on the next /v1/assistant/skills call.")
+      );
+    })()
+  );
+  skills.command("show <slug>").description("Show a skill's SKILL.md body (read-only)").option("--json", "Output as JSON (includes metadata)").action(
+    (slug, opts) => runAction(async () => {
+      const ctx = await resolveWorkspace();
+      const list = await sdk.assistant.listSkills(ctx.arbi, { includeHidden: true });
+      const skill = list.find((s) => s.slug === slug || s.name === slug);
+      if (!skill) {
+        process.stderr.write(
+          `No skill matching "${slug}" in this workspace. Try \`arbi skills list\`.
+`
+        );
+        process.exit(1);
+      }
+      const authHeaders = {
+        baseUrl: ctx.config.baseUrl,
+        accessToken: ctx.accessToken
+      };
+      const dlRes = await sdk.documents.downloadDocument(authHeaders, skill.doc_ext_id);
+      const body = dlRes.ok ? await dlRes.text() : "";
+      if (opts.json) {
+        console.log(JSON.stringify({ ...skill, body }, null, 2));
+        return;
+      }
+      console.log(bold(`${skill.name} (${skill.slug})`));
+      if (skill.description) console.log(dim(skill.description));
+      if (skill.arg_hint) console.log(dim(`args: ${skill.arg_hint}`));
+      console.log(dim(`type: ${skill.skill_type}  doc: ${skill.doc_ext_id}`));
+      console.log("");
+      console.log(body);
+    })()
+  );
+}
 
 // src/index.ts
 console.debug = () => {
@@ -10050,7 +10228,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.65").showHelpAfterError(true).showSuggestionAfterError(true);
+program.name("arbi").description("ARBI CLI \u2014 interact with ARBI from the terminal").version("0.3.67").showHelpAfterError(true).showSuggestionAfterError(true);
 registerConfigCommand(program);
 registerLoginCommand(program);
 registerRegisterCommand(program);
@@ -10087,6 +10265,7 @@ registerProjectCommand(program);
 registerFilesCommand(program);
 registerUsageCommand(program);
 registerAuthCommand(program);
+registerSkillsCommand(program);
 applyHelpGroups(program, {
   "Getting started:": [
     "quickstart",