@senso-ai/cli 0.6.0 → 0.7.0

package/dist/cli.js

@@ -164,7 +164,7 @@ import pc3 from "picocolors";
 // src/lib/api-client.ts
 var ApiError = class extends Error {
   constructor(status, statusText, body) {
-    const msg = typeof body === "object" && body && "error" in body ? body.error : statusText;
+    const msg = typeof body === "object" && body ? "error" in body ? body.error : "message" in body ? body.message : statusText : statusText;
     super(msg);
     this.status = status;
     this.statusText = statusText;
@@ -230,8 +230,10 @@ function formatApiError(err) {
     switch (err.status) {
       case 401:
         return "Authentication failed. Run `senso login` to update your API key.";
+      case 402:
+        return "Insufficient credits or spending limit reached. Check your plan at https://app.senso.ai.";
       case 403:
-        return "Permission denied. Check your API key permissions.";
+        return `Permission denied: ${err.message}`;
       case 404:
         return "Resource not found.";
       case 409:
@@ -666,12 +668,17 @@ function output(format, data) {
 }
 
 // src/commands/search.ts
+function parseMaxResults(value) {
+  const n = parseInt(value);
+  if (isNaN(n) || n < 1) return 5;
+  return Math.min(n, 20);
+}
 function registerSearchCommands(program2) {
   const search = program2.command("search").description("Search the knowledge base with natural language queries. Returns AI-generated answers synthesised from matching content chunks, or raw chunks/content IDs.");
-  search.argument("<query>", "Search query").option("--max-results <n>", "Maximum number of results", "5").option("--content-ids <ids...>", "Restrict search to specific content item IDs (space-separated UUIDs)").option("--require-scoped-ids", "Only return results from the specified --content-ids (omit to allow fallback to all content)").action(async (query, cmdOpts) => {
+  search.argument("<query>", "Search query").option("--max-results <n>", "Maximum number of results (max: 20)", "5").option("--content-ids <ids...>", "Restrict search to specific content item IDs (space-separated UUIDs)").option("--require-scoped-ids", "Only return results from the specified --content-ids (omit to allow fallback to all content)").action(async (query, cmdOpts) => {
     const opts = program2.opts();
     try {
-      const body = { query, max_results: parseInt(cmdOpts.maxResults) };
+      const body = { query, max_results: parseMaxResults(cmdOpts.maxResults) };
       if (cmdOpts.contentIds) body.content_ids = cmdOpts.contentIds;
       if (cmdOpts.requireScopedIds) body.require_scoped_ids = true;
       const data = await apiRequest({
@@ -710,10 +717,10 @@ function registerSearchCommands(program2) {
       process.exit(1);
     }
   });
-  search.command("context <query>").description("Search the knowledge base \u2014 returns matching content chunks only, without AI answer generation. Use this to feed verified chunks into your own LLM pipeline instead of using Senso's generated answer.").option("--max-results <n>", "Maximum results", "5").option("--content-ids <ids...>", "Restrict search to specific content item IDs (space-separated UUIDs)").option("--require-scoped-ids", "Only return results from the specified --content-ids").action(async (query, cmdOpts) => {
+  search.command("context <query>").description("Search the knowledge base \u2014 returns matching content chunks only, without AI answer generation. Use this to feed verified chunks into your own LLM pipeline instead of using Senso's generated answer.").option("--max-results <n>", "Maximum results (max: 20)", "5").option("--content-ids <ids...>", "Restrict search to specific content item IDs (space-separated UUIDs)").option("--require-scoped-ids", "Only return results from the specified --content-ids").action(async (query, cmdOpts) => {
     const opts = program2.opts();
     try {
-      const body = { query, max_results: parseInt(cmdOpts.maxResults) };
+      const body = { query, max_results: parseMaxResults(cmdOpts.maxResults) };
       if (cmdOpts.contentIds) body.content_ids = cmdOpts.contentIds;
       if (cmdOpts.requireScopedIds) body.require_scoped_ids = true;
       const data = await apiRequest({
@@ -729,10 +736,10 @@ function registerSearchCommands(program2) {
       process.exit(1);
     }
   });
-  search.command("content <query>").description("Search the knowledge base \u2014 returns deduplicated content IDs and titles only. Use this to discover which documents are relevant before fetching full content with 'content get <id>'.").option("--max-results <n>", "Maximum results", "5").option("--content-ids <ids...>", "Restrict search to specific content item IDs (space-separated UUIDs)").option("--require-scoped-ids", "Only return results from the specified --content-ids").action(async (query, cmdOpts) => {
+  search.command("content <query>").description("Search the knowledge base \u2014 returns deduplicated content IDs and titles only. Use this to discover which documents are relevant before fetching full content with 'content get <id>'.").option("--max-results <n>", "Maximum results (max: 20)", "5").option("--content-ids <ids...>", "Restrict search to specific content item IDs (space-separated UUIDs)").option("--require-scoped-ids", "Only return results from the specified --content-ids").action(async (query, cmdOpts) => {
     const opts = program2.opts();
     try {
-      const body = { query, max_results: parseInt(cmdOpts.maxResults) };
+      const body = { query, max_results: parseMaxResults(cmdOpts.maxResults) };
       if (cmdOpts.contentIds) body.content_ids = cmdOpts.contentIds;
       if (cmdOpts.requireScopedIds) body.require_scoped_ids = true;
       const data = await apiRequest({
@@ -748,10 +755,10 @@ function registerSearchCommands(program2) {
       process.exit(1);
     }
   });
-  search.command("full <query>").description("Alias for the default search \u2014 returns AI answer plus matching chunks. Equivalent to 'senso search <query>'.").option("--max-results <n>", "Maximum results", "5").option("--content-ids <ids...>", "Restrict search to specific content item IDs (space-separated UUIDs)").option("--require-scoped-ids", "Only return results from the specified --content-ids").action(async (query, cmdOpts) => {
+  search.command("full <query>").description("Alias for the default search \u2014 returns AI answer plus matching chunks. Equivalent to 'senso search <query>'.").option("--max-results <n>", "Maximum results (max: 20)", "5").option("--content-ids <ids...>", "Restrict search to specific content item IDs (space-separated UUIDs)").option("--require-scoped-ids", "Only return results from the specified --content-ids").action(async (query, cmdOpts) => {
     const opts = program2.opts();
     try {
-      const body = { query, max_results: parseInt(cmdOpts.maxResults) };
+      const body = { query, max_results: parseMaxResults(cmdOpts.maxResults) };
       if (cmdOpts.contentIds) body.content_ids = cmdOpts.contentIds;
       if (cmdOpts.requireScopedIds) body.require_scoped_ids = true;
       const data = await apiRequest({
@@ -835,60 +842,63 @@ function registerIngestCommands(program2) {
     }
     try {
       const fileData = await Promise.all(files.map(getFileMetadata));
-      const results = await apiRequest({
+      const response = await apiRequest({
         method: "POST",
         path: "/org/kb/upload",
         body: { files: fileData.map((f) => f.meta) },
         apiKey: opts.apiKey,
         baseUrl: opts.baseUrl
       });
-      const items = Array.isArray(results) ? results : [];
+      const items = response.results ?? [];
       let uploaded = 0;
       for (const item of items) {
         if (item.status === "upload_pending" && item.upload_url) {
           const match = fileData.find((f) => f.meta.filename === item.filename);
-          if (match) {
+          if (!match) {
+            error(`Could not match server filename "${item.filename}" to a local file \u2014 skipping upload.`);
+            continue;
+          }
+          try {
             await uploadToS3(item.upload_url, match.buffer, match.meta.content_type);
             uploaded++;
             success(`Uploaded ${item.filename} (content_id: ${item.content_id})`);
+          } catch (uploadErr) {
+            error(`S3 upload failed for ${item.filename}: ${uploadErr instanceof Error ? uploadErr.message : String(uploadErr)}`);
           }
         } else {
-          warn(`Skipped ${item.filename}: ${item.status}${item.message ? ` \u2014 ${item.message}` : ""}`);
+          warn(`Skipped ${item.filename}: ${item.status}${item.error ? ` \u2014 ${item.error}` : ""}`);
         }
       }
       if (uploaded > 0) {
         success(`${uploaded} file(s) uploaded. Background processing will parse, chunk, and embed them.`);
       }
       if (opts.output === "json") {
-        console.log(JSON.stringify(results, null, 2));
+        console.log(JSON.stringify(response, null, 2));
       }
     } catch (err) {
       error(formatApiError(err));
       process.exit(1);
     }
   });
-  ingest.command("reprocess <contentId> <file>").description("Re-ingest an existing content item with a new file version. Provide the content ID and the path to the replacement file.").action(async (contentId, file) => {
+  ingest.command("reprocess <nodeId> <file>").description("Re-ingest an existing document with a new file version. Provide the KB node ID (kb_node_id) and the path to the replacement file.").action(async (nodeId, file) => {
     const opts = program2.opts();
     try {
       const { meta, buffer } = await getFileMetadata(file);
-      const results = await apiRequest({
+      const item = await apiRequest({
         method: "PUT",
-        path: `/org/kb/nodes/${contentId}/file`,
+        path: `/org/kb/nodes/${nodeId}/file`,
         body: { file: meta },
         apiKey: opts.apiKey,
         baseUrl: opts.baseUrl
       });
-      const items = Array.isArray(results) ? results : [];
-      for (const item of items) {
-        if (item.status === "upload_pending" && item.upload_url) {
-          await uploadToS3(item.upload_url, buffer, meta.content_type);
-          success(`Uploaded ${meta.filename} for content ${contentId}. Background re-processing started.`);
-        } else {
-          warn(`Skipped: ${item.status}${item.message ? ` \u2014 ${item.message}` : ""}`);
-        }
+      if (item.status === "upload_pending" && item.upload_url) {
+        await uploadToS3(item.upload_url, buffer, meta.content_type);
+        success(`Uploaded ${meta.filename} for node ${nodeId}. Background re-processing started.`);
+      } else {
+        warn(`Skipped: ${item.status}${item.error ? ` \u2014 ${item.error}` : ""}`);
       }
       if (opts.output === "json") {
-        console.log(JSON.stringify(results, null, 2));
+        console.log(JSON.stringify(item, null, 2));
       }
     } catch (err) {
       error(formatApiError(err));
@@ -916,7 +926,7 @@ function registerContentCommands(program2) {
         json: data,
         table: {
           rows: rows.map((r) => ({
-            id: r.node_id,
+            id: r.kb_node_id,
             name: r.name,
             type: r.type,
             status: r.processing_status
@@ -924,7 +934,7 @@ function registerContentCommands(program2) {
           columns: ["id", "name", "type", "status"]
         },
         plain: rows.length ? rows.map(
-          (r) => `  ${pc6.bold(String(r.name || "Untitled"))} ${pc6.dim(`(${r.node_id})`)} ${r.type ? pc6.dim(`[${r.type}]`) : ""}`
+          (r) => `  ${pc6.bold(String(r.name || "Untitled"))} ${pc6.dim(`(${r.kb_node_id})`)} ${r.type ? pc6.dim(`[${r.type}]`) : ""}`
         ) : ["  No content found."]
       });
     } catch (err) {
@@ -1049,7 +1059,7 @@ function registerGenerateCommands(program2) {
       process.exit(1);
     }
   });
-  gen.command("update-settings").description("Update content generation settings. Control auto-publish, generation toggle, and schedule (days of week 0-6).").requiredOption("--data <json>", 'JSON settings: { "enable_content_generation": bool, "content_auto_publish": bool, "content_schedule": [0-6] }').action(async (cmdOpts) => {
+  gen.command("update-settings").description("Update content generation settings. Control auto-publish, generation toggle, and schedule (days of week 0-6).").requiredOption("--data <json>", 'JSON settings: { "enable_content_generation": bool, "content_auto_publish": bool, "content_schedule": [0-6], "selected_content_type_id": "<uuid>" }').action(async (cmdOpts) => {
     const opts = program2.opts();
     try {
       const body = JSON.parse(cmdOpts.data);
@@ -1084,11 +1094,14 @@ function registerGenerateCommands(program2) {
       process.exit(1);
     }
   });
-  gen.command("run").description("Trigger a content generation run. Processes all prompts (or a specific subset) through the content engine. Runs asynchronously \u2014 use 'generate runs-list' to monitor progress.").option("--prompt-ids <ids...>", "Optional list of prompt IDs to process (omit to run all)").action(async (cmdOpts) => {
+  gen.command("run").description("Trigger a content generation run. Processes all prompts (or a specific subset) through the content engine. Runs asynchronously \u2014 use 'generate runs-list' to monitor progress.").option("--prompt-ids <ids...>", "Optional list of prompt IDs to process (omit to run all)").option("--content-type-id <id>", "Override the org's default content type for this run").option("--publisher-ids <ids...>", "Restrict publishing to specific publisher IDs").action(async (cmdOpts) => {
     const opts = program2.opts();
     try {
-      const body = cmdOpts.promptIds ? { prompt_ids: cmdOpts.promptIds } : void 0;
-      const data = await apiRequest({ method: "POST", path: "/org/content-generation/run", body, apiKey: opts.apiKey, baseUrl: opts.baseUrl });
+      const body = {};
+      if (cmdOpts.promptIds) body.prompt_ids = cmdOpts.promptIds;
+      if (cmdOpts.contentTypeId) body.content_type_id = cmdOpts.contentTypeId;
+      if (cmdOpts.publisherIds) body.publisher_ids = cmdOpts.publisherIds;
+      const data = await apiRequest({ method: "POST", path: "/org/content-generation/run", body: Object.keys(body).length > 0 ? body : {}, apiKey: opts.apiKey, baseUrl: opts.baseUrl });
       success("Content generation run triggered.");
       console.log(JSON.stringify(data, null, 2));
     } catch (err) {
@@ -1732,7 +1745,7 @@ function registerKBCommands(program2) {
     const opts = program2.opts();
     try {
       const body = { name: cmdOpts.name };
-      if (cmdOpts.parentId) body.parent_node_id = cmdOpts.parentId;
+      if (cmdOpts.parentId) body.parent_id = cmdOpts.parentId;
       const data = await apiRequest({ method: "POST", path: "/org/kb/folders", body, apiKey: opts.apiKey, baseUrl: opts.baseUrl });
       success(`Folder "${cmdOpts.name}" created.`);
       console.log(JSON.stringify(data, null, 2));
@@ -1755,7 +1768,7 @@ function registerKBCommands(program2) {
   kb.command("move <id>").description("Move a KB node to a different parent folder.").requiredOption("--parent-id <parentId>", "Target parent folder node ID").action(async (id, cmdOpts) => {
     const opts = program2.opts();
     try {
-      const data = await apiRequest({ method: "PATCH", path: `/org/kb/nodes/${id}/move`, body: { parent_node_id: cmdOpts.parentId }, apiKey: opts.apiKey, baseUrl: opts.baseUrl });
+      const data = await apiRequest({ method: "PATCH", path: `/org/kb/nodes/${id}/move`, body: { new_parent_id: cmdOpts.parentId }, apiKey: opts.apiKey, baseUrl: opts.baseUrl });
       success(`Node ${id} moved.`);
       console.log(JSON.stringify(data, null, 2));
     } catch (err) {
@@ -1773,7 +1786,7 @@ function registerKBCommands(program2) {
       process.exit(1);
     }
   });
-  kb.command("create-raw").description("Create a raw (text/markdown) content item in the knowledge base.").requiredOption("--data <json>", 'JSON: { "name": "My doc", "text": "# Hello", "kb_folder_node_id": "<uuid>" }').action(async (cmdOpts) => {
+  kb.command("create-raw").description("Create a raw (text/markdown) content item in the knowledge base.").requiredOption("--data <json>", 'JSON: { "title": "My doc", "text": "# Hello", "kb_folder_node_id": "<uuid>", "tag_ids": ["<uuid>"] }').action(async (cmdOpts) => {
     const opts = program2.opts();
     try {
       const body = JSON.parse(cmdOpts.data);
@@ -1785,7 +1798,7 @@ function registerKBCommands(program2) {
       process.exit(1);
     }
   });
-  kb.command("update-raw <id>").description("Fully replace the text content of a raw KB node (creates a new version).").requiredOption("--data <json>", 'JSON: { "text": "# Updated content" }').action(async (id, cmdOpts) => {
+  kb.command("update-raw <id>").description("Fully replace the text content of a raw KB node (creates a new version).").requiredOption("--data <json>", 'JSON: { "title": "Title", "text": "# Updated content", "tag_ids": ["<uuid>"] }').action(async (id, cmdOpts) => {
     const opts = program2.opts();
     try {
       const body = JSON.parse(cmdOpts.data);
@@ -1797,7 +1810,7 @@ function registerKBCommands(program2) {
       process.exit(1);
     }
   });
-  kb.command("patch-raw <id>").description("Partially update the text content of a raw KB node.").requiredOption("--data <json>", 'JSON: { "text": "Updated text", "name": "New name" }').action(async (id, cmdOpts) => {
+  kb.command("patch-raw <id>").description("Partially update the text content of a raw KB node.").requiredOption("--data <json>", 'JSON: { "title": "New title", "text": "Updated text", "summary": "...", "tag_ids": ["<uuid>"] }').action(async (id, cmdOpts) => {
     const opts = program2.opts();
     try {
       const body = JSON.parse(cmdOpts.data);
@@ -1819,31 +1832,37 @@ function registerKBCommands(program2) {
       const fileData = await Promise.all(files.map(getFileMetadata2));
       const body = { files: fileData.map((f) => f.meta) };
       if (cmdOpts.folderId) body.kb_folder_node_id = cmdOpts.folderId;
-      const results = await apiRequest({
+      const response = await apiRequest({
         method: "POST",
         path: "/org/kb/upload",
         body,
         apiKey: opts.apiKey,
         baseUrl: opts.baseUrl
       });
-      const items = Array.isArray(results) ? results : [];
+      const items = response.results ?? [];
       let uploaded = 0;
       for (const item of items) {
         if (item.status === "upload_pending" && item.upload_url) {
           const match = fileData.find((f) => f.meta.filename === item.filename);
-          if (match) {
+          if (!match) {
+            error(`Could not match server filename "${item.filename}" to a local file \u2014 skipping upload.`);
+            continue;
+          }
+          try {
             await uploadToS32(item.upload_url, match.buffer, match.meta.content_type);
             uploaded++;
             success(`Uploaded ${item.filename} (content_id: ${item.content_id})`);
+          } catch (uploadErr) {
+            error(`S3 upload failed for ${item.filename}: ${uploadErr instanceof Error ? uploadErr.message : String(uploadErr)}`);
           }
         } else {
-          warn(`Skipped ${item.filename}: ${item.status}${item.message ? ` \u2014 ${item.message}` : ""}`);
+          warn(`Skipped ${item.filename}: ${item.status}${item.error ? ` \u2014 ${item.error}` : ""}`);
         }
       }
       if (uploaded > 0) {
         success(`${uploaded} file(s) uploaded. Background processing will parse, chunk, and embed them.`);
       }
-      if (opts.output === "json") console.log(JSON.stringify(results, null, 2));
+      if (opts.output === "json") console.log(JSON.stringify(response, null, 2));
     } catch (err) {
       error(formatApiError(err));
       process.exit(1);
@@ -1853,23 +1872,20 @@ function registerKBCommands(program2) {
     const opts = program2.opts();
     try {
       const { meta, buffer } = await getFileMetadata2(file);
-      const results = await apiRequest({
+      const item = await apiRequest({
         method: "PUT",
         path: `/org/kb/nodes/${id}/file`,
         body: { file: meta },
         apiKey: opts.apiKey,
         baseUrl: opts.baseUrl
       });
-      const items = Array.isArray(results) ? results : [];
-      for (const item of items) {
-        if (item.status === "upload_pending" && item.upload_url) {
-          await uploadToS32(item.upload_url, buffer, meta.content_type);
-          success(`Uploaded ${meta.filename} for node ${id}. Background re-processing started.`);
-        } else {
-          warn(`Skipped: ${item.status}${item.message ? ` \u2014 ${item.message}` : ""}`);
-        }
+      if (item.status === "upload_pending" && item.upload_url) {
+        await uploadToS32(item.upload_url, buffer, meta.content_type);
+        success(`Uploaded ${meta.filename} for node ${id}. Background re-processing started.`);
+      } else {
+        warn(`Skipped: ${item.status}${item.error ? ` \u2014 ${item.error}` : ""}`);
       }
-      if (opts.output === "json") console.log(JSON.stringify(results, null, 2));
+      if (opts.output === "json") console.log(JSON.stringify(item, null, 2));
     } catch (err) {
       error(formatApiError(err));
       process.exit(1);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@senso-ai/cli",
-  "version": "0.6.0",
+  "version": "0.7.0",
   "description": "Senso CLI — Infrastructure for the Agentic Web. Interact with your Senso knowledge base from the terminal.",
   "type": "module",
   "bin": {