sim 2.1.9 → 2.1.10

package/README.md

@@ -188,6 +188,7 @@ The commands you will use most often are:
 | Upload or download files | `sim files upload ./report.pdf`, `sim files get <fileId>` |
 | Search knowledge bases | `sim knowledge search --query "refund policy" --kb <knowledgeBaseId>` |
 | Upload a knowledge document | `sim knowledge documents upload <knowledgeBaseId> ./handbook.pdf` |
+| Export a knowledge base | `sim knowledge export <knowledgeBaseId> -o ./kb.simkb.zip` |
 | Manage integration credentials | `sim credentials --help` |
 | Manage workspace secrets | `sim secrets list`, `sim secrets set <name>` |
 

package/dist/index.js

@@ -10474,6 +10474,25 @@ var V2_OPERATIONS = {
       }
     }
   },
+  exportKnowledgeBase: {
+    method: "GET",
+    path: "/api/v2/knowledge/[knowledgeBaseId]/export",
+    pathParams: ["knowledgeBaseId"],
+    pathParamDocs: { knowledgeBaseId: "Unique knowledge base identifier." },
+    responseMode: "binary",
+    summary: "Export Knowledge Base",
+    query: {
+      workspaceId: {
+        kind: "string",
+        required: true,
+        describe: "Workspace that owns the knowledge base."
+      },
+      vectors: {
+        kind: "boolean",
+        describe: "Include chunk vectors so an import into a deployment with the same embedding model reuses them instead of re-embedding."
+      }
+    }
+  },
   exportWorkflow: {
     method: "GET",
     path: "/api/v2/workflows/[workflowId]/export",
@@ -17851,6 +17870,60 @@ function attachKnowledgeDocumentUpload(documents) {
   });
 }
 
+// src/commands/protocol/knowledge-export.ts
+import { basename as basename2, join as join3 } from "node:path";
+function attachmentFileName(contentDisposition) {
+  if (!contentDisposition)
+    return null;
+  const encoded = /filename\*=UTF-8''([^;]+)/i.exec(contentDisposition)?.[1];
+  if (encoded) {
+    try {
+      return safeBaseName(decodeURIComponent(encoded));
+    } catch {}
+  }
+  const quoted = /filename="([^"]*)"/.exec(contentDisposition)?.[1];
+  return quoted === undefined ? null : safeBaseName(quoted);
+}
+function safeBaseName(name) {
+  const base = basename2(name.trim());
+  return base && base !== "." && base !== ".." ? base : null;
+}
+function attachKnowledgeExport(knowledge) {
+  knowledge.command("export").argument("<knowledgeBaseId>", "Knowledge base to export").allowExcessArguments(false).description("Export a knowledge base as a .simkb.zip bundle").option("-o, --output-file <path>", "Write the bundle to this path instead of the name the server suggests; pass - to stream it to stdout").option("--force", "Overwrite --output-file if it already exists").option("--no-vectors", "Leave chunk vectors out of the bundle, so an import re-embeds every chunk").action(async (knowledgeBaseId, options, command) => {
+    const writesToStdout = options.outputFile === "-";
+    if (writesToStdout && options.force) {
+      throw new SimApiError("--force requires --output-file <path>", 0);
+    }
+    const { client, profile } = clientFrom(command);
+    const workspaceId = client.requireWorkspace();
+    const operation = V2_OPERATIONS.exportKnowledgeBase;
+    const response = await client.requestRaw(resolvePath(operation.path, { knowledgeBaseId }), {
+      method: operation.method,
+      query: { workspaceId, vectors: options.vectors }
+    });
+    if (!response.body) {
+      throw new SimApiError("Knowledge base export response was empty.", response.status);
+    }
+    if (writesToStdout) {
+      const contentType = response.headers.get("content-type");
+      if (process.stdout.isTTY && !isTerminalSafeContentType(contentType)) {
+        await response.body.cancel();
+        throw new SimApiError(`Refusing to write ${contentType ?? "unknown content"} to an interactive terminal. Use --output-file <path> or pipe stdout.`, 0);
+      }
+      await streamToStdout(response.body);
+      return;
+    }
+    const target = options.outputFile ?? join3(process.cwd(), attachmentFileName(response.headers.get("content-disposition")) ?? `${knowledgeBaseId}.simkb.zip`);
+    await saveToFile(response.body, target, Boolean(options.force));
+    printProtocolResult(profile.output, {
+      id: knowledgeBaseId,
+      path: target,
+      status: "saved",
+      vectors: options.vectors
+    });
+  });
+}
+
 // src/commands/protocol/logs-follow.ts
 var DEFAULT_BACKLOG = 10;
 var DEFAULT_INTERVAL_SECONDS = 3;
@@ -18800,6 +18873,7 @@ function attachProtocolCommands(program) {
   });
   const knowledge = group(program, "knowledge");
   attachKnowledgeDocumentUpload(group(knowledge, "documents"));
+  attachKnowledgeExport(knowledge);
   attachResourceDirectoryCommands(knowledge, {
     kind: "knowledge",
     resources: "listKnowledgeBases",
@@ -19336,6 +19410,7 @@ Examples:
   $ sim knowledge search --query "refund policy" --kb 4c1b7f60-2d55-4a3e-9c18-70b6ea2f9d31
   $ sim workflows export 3a9e21d8-5f47-4c0b-b2ea-91d7c6034ef8 > wf.json
   $ sim workflows import --workflow @wf.json
+  $ sim knowledge export 4c1b7f60-2d55-4a3e-9c18-70b6ea2f9d31 -o ./kb.simkb.zip
   $ sim whoami --profile dev
 `;
 var ROOT_VALUE_FLAGS = new Set([

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sim",
-  "version": "2.1.9",
+  "version": "2.1.10",
   "description": "Sim CLI - talk to the Sim API from your terminal",
   "type": "module",
   "bin": {