@openbkn/bkn-sdk 0.1.0 → 0.1.1-alpha.0

package/dist/cli.js

@@ -13,6 +13,7 @@ import {
   formatError,
   listPlatforms,
   logout,
+  parseEmbeddingFields,
   parsePkMap,
   rawCall,
   readPlatformConfig,
@@ -27,7 +28,7 @@ import {
   usersOf,
   whoami,
   writePlatformConfig
-} from "./chunk-4NXAIG4G.js";
+} from "./chunk-DXA44XWY.js";
 
 // src/cli.ts
 import { Command as Command16 } from "commander";
@@ -35,7 +36,7 @@ import { Command as Command16 } from "commander";
 // package.json
 var package_default = {
   name: "@openbkn/bkn-sdk",
-  version: "0.1.0",
+  version: "0.1.1-alpha.0",
   description: "Unified TypeScript SDK + CLI for the BKN (Business Knowledge Network) platform.",
   type: "module",
   license: "Apache-2.0",
@@ -1379,8 +1380,18 @@ function bknCommand() {
   job.command("delete <kn-id> <job-ids>").description("Delete job(s) (comma-joined ids)").action(async (knId, ids, _o, cmd) => {
     printJson(await clientFrom(cmd).kn.jobDelete(knId, ids), outputOptions(cmd));
   });
-  bkn.command("push <directory>").description("Pack a BKN directory into a tar and import it as a knowledge network").option("--branch <name>", "target branch", "main").action(async (dir, opts, cmd) => {
-    printJson(await clientFrom(cmd).kn.push(dir, { branch: opts.branch }), outputOptions(cmd));
+  bkn.command("push <directory>").description("Pack a BKN directory into a tar and import it as a knowledge network").option("--branch <name>", "target branch", "main").option("--build", "submit a Vega build task for each object type declaring a vector index").option(
+    "--embedding-model <id>",
+    "embedding model id for declared vector indexes (with --build)"
+  ).action(async (dir, opts, cmd) => {
+    printJson(
+      await clientFrom(cmd).kn.push(dir, {
+        branch: opts.branch,
+        build: Boolean(opts.build),
+        embeddingModel: opts.embeddingModel
+      }),
+      outputOptions(cmd)
+    );
   });
   bkn.command("pull <kn-id> [directory]").description("Download a knowledge network as a BKN tar and extract it locally").option("--branch <name>", "source branch", "main").action(async (knId, dir, opts, cmd) => {
     printJson(
@@ -1397,7 +1408,10 @@ function bknCommand() {
   bkn.command("resources").description("List BKN-backend resources").action(async (_opts, cmd) => {
     printJson(await clientFrom(cmd).kn.bknResources(), outputOptions(cmd));
   });
-  bkn.command("create-from-catalog <catalog-id>").description("Build a knowledge network from a Vega catalog's tables").requiredOption("--name <name>", "knowledge network name").option("--tables <list>", "comma-separated table names (default: all)").option("--pk-map <map>", "explicit primary keys: '<table>:<col>[,<table>:<col>...]'").option("--build", "submit a Vega build task per resource after creation").option("--no-rollback", "keep a partially-created KN on failure").action(async (catalogId, opts, cmd) => {
+  bkn.command("create-from-catalog <catalog-id>").description("Build a knowledge network from a Vega catalog's tables").requiredOption("--name <name>", "knowledge network name").option("--tables <list>", "comma-separated table names (default: all)").option("--pk-map <map>", "explicit primary keys: '<table>:<col>[,<table>:<col>...]'").option("--build", "submit a Vega build task per resource after creation").option(
+    "--embedding-fields <map>",
+    "columns to vectorize per table (with --build): '<table>:<col>[+<col>...][,...]'"
+  ).option("--embedding-model <id>", "embedding model id for the vector index (with --build)").option("--no-rollback", "keep a partially-created KN on failure").action(async (catalogId, opts, cmd) => {
     printJson(
       await clientFrom(cmd).kn.createFromCatalog({
         catalogId,
@@ -1405,6 +1419,8 @@ function bknCommand() {
         tables: csv(opts.tables),
         pkMap: opts.pkMap ? parsePkMap(opts.pkMap) : void 0,
         build: Boolean(opts.build),
+        embeddingFields: opts.embeddingFields ? parseEmbeddingFields(opts.embeddingFields) : void 0,
+        embeddingModel: opts.embeddingModel,
         noRollback: opts.rollback === false,
         onProgress: (m) => console.error(m)
       }),
@@ -1416,7 +1432,10 @@ function bknCommand() {
     printJson(result, outputOptions(cmd));
     if (!result.valid) process.exitCode = 1;
   });
-  bkn.command("create-from-csv <catalog-id>").description("Import CSV files into a Vega catalog, then build a KN from them").requiredOption("--files <glob>", "CSV paths (comma-separated or glob)").requiredOption("--name <name>", "knowledge network name").option("--table-prefix <s>", "prefix for derived table names", "").option("--batch-size <n>", "rows per insert batch", int3, 500).option("--tables <list>", "subset of imported tables to include in the KN").option("--pk-map <map>", "explicit primary keys: '<table>:<col>[,...]'").option("--build", "submit a Vega build task per resource after creation").option("--no-rollback", "keep a partially-created KN on failure").action(async (catalogId, opts, cmd) => {
+  bkn.command("create-from-csv <catalog-id>").description("Import CSV files into a Vega catalog, then build a KN from them").requiredOption("--files <glob>", "CSV paths (comma-separated or glob)").requiredOption("--name <name>", "knowledge network name").option("--table-prefix <s>", "prefix for derived table names", "").option("--batch-size <n>", "rows per insert batch", int3, 500).option("--tables <list>", "subset of imported tables to include in the KN").option("--pk-map <map>", "explicit primary keys: '<table>:<col>[,...]'").option("--build", "submit a Vega build task per resource after creation").option(
+    "--embedding-fields <map>",
+    "columns to vectorize per table (with --build): '<table>:<col>[+<col>...][,...]'"
+  ).option("--embedding-model <id>", "embedding model id for the vector index (with --build)").option("--no-rollback", "keep a partially-created KN on failure").action(async (catalogId, opts, cmd) => {
     printJson(
       await clientFrom(cmd).kn.createFromCsv({
         catalogId,
@@ -1427,6 +1446,8 @@ function bknCommand() {
         tables: csv(opts.tables),
         pkMap: opts.pkMap ? parsePkMap(opts.pkMap) : void 0,
         build: Boolean(opts.build),
+        embeddingFields: opts.embeddingFields ? parseEmbeddingFields(opts.embeddingFields) : void 0,
+        embeddingModel: opts.embeddingModel,
         noRollback: opts.rollback === false,
         onProgress: (m) => console.error(m)
       }),
@@ -2234,6 +2255,34 @@ function vegaCommand() {
   catalog.command("health <ids...>").description("Health-status for one or more catalogs").action(async (ids, _opts, cmd) => {
     printJson(await clientFrom(cmd).vega.catalogHealth(ids), outputOptions(cmd));
   });
+  catalog.command("create").description("Create a catalog (data source)").requiredOption("--name <s>", "catalog name").requiredOption("--connector-type <s>", "connector type (e.g. mysql)").requiredOption("--connector-config <json>", "connector config JSON").option("--tags <t1,t2>", "comma-separated tags").option("--description <s>", "description").option("--enabled", "create enabled (default: disabled)").action(async (opts, cmd) => {
+    let connectorConfig;
+    try {
+      connectorConfig = JSON.parse(opts.connectorConfig);
+    } catch {
+      throw new Error("--connector-config must be valid JSON");
+    }
+    printJson(
+      await clientFrom(cmd).vega.createCatalog({
+        name: opts.name,
+        connectorType: opts.connectorType,
+        connectorConfig,
+        tags: opts.tags ? String(opts.tags).split(",").map((t) => t.trim()).filter(Boolean) : void 0,
+        description: opts.description,
+        enabled: opts.enabled ? true : void 0
+      }),
+      outputOptions(cmd)
+    );
+  });
+  catalog.command("enable <id>").description("Enable a catalog (required before discovery)").action(async (id, _opts, cmd) => {
+    printJson(await clientFrom(cmd).vega.enableCatalog(id), outputOptions(cmd));
+  });
+  catalog.command("discover <id>").description("Trigger catalog resource discovery").option("--wait", "wait for discovery to complete").action(async (id, opts, cmd) => {
+    printJson(
+      await clientFrom(cmd).vega.discoverCatalog(id, Boolean(opts.wait)),
+      outputOptions(cmd)
+    );
+  });
   const connector = vega.command("connector-type").description("Connector types");
   connector.command("list").description("List connector types").action(async (_opts, cmd) => {
     printJson(await clientFrom(cmd).vega.connectorTypes(), outputOptions(cmd));
@@ -2242,11 +2291,11 @@ function vegaCommand() {
     printJson(await clientFrom(cmd).vega.connectorType(type), outputOptions(cmd));
   });
   const resource = vega.command("resource").description("Vega-backend resources");
-  resource.command("list").description("List resources").option("--datasource-id <id>", "filter by catalog/datasource id").option("--type <category>", "resource category").option("--limit <n>", "page size", (v) => Number.parseInt(v, 10), DEFAULT_LIST_LIMIT).action(async (opts, cmd) => {
+  resource.command("list").description("List resources").option("--datasource-id <id>", "filter by catalog/datasource id").option("--catalog-id <id>", "alias of --datasource-id").option("--type <category>", "resource category").option("--category <category>", "alias of --type").option("--limit <n>", "page size", (v) => Number.parseInt(v, 10), DEFAULT_LIST_LIMIT).action(async (opts, cmd) => {
     printJson(
       await clientFrom(cmd).resource.list({
-        datasourceId: opts.datasourceId,
-        category: opts.type,
+        datasourceId: opts.datasourceId ?? opts.catalogId,
+        category: opts.type ?? opts.category,
         limit: opts.limit
       }),
       outputOptions(cmd)