@openbkn/bkn-sdk 0.1.1-alpha.15 → 0.1.1-alpha.18

package/dist/{chunk-KF3J46WL.js → chunk-LCOMMFH7.js}

@@ -296,7 +296,11 @@ var DEFAULT_TIMEOUT_MS = 3e4;
 async function request(ctx, path, init = {}) {
   const url = new URL(path.startsWith("http") ? path : `${ctx.baseUrl}${path}`);
   for (const [k, v] of Object.entries(init.query ?? {})) {
-    if (v !== void 0) url.searchParams.set(k, String(v));
+    if (Array.isArray(v)) {
+      for (const item of v) url.searchParams.append(k, String(item));
+    } else if (v !== void 0) {
+      url.searchParams.set(k, String(v));
+    }
   }
   applyTls(ctx);
   const hasBody = init.body !== void 0;
@@ -694,6 +698,43 @@ async function setRolePermissionSafe(ctx, roleId, grant, perm) {
   });
   return { ok: true };
 }
+function getLicenseSafe(ctx) {
+  return request(ctx, `${ADMIN}/license`);
+}
+async function importLicenseSafe(ctx, licenseText, opts = {}) {
+  const text = licenseText.trim();
+  if (!text) throw new InputError("license text is empty");
+  try {
+    return await request(ctx, `${ADMIN}/license/${opts.receipt ? "receipt" : "import"}`, {
+      method: "POST",
+      body: { license: text }
+    });
+  } catch (err) {
+    if (err instanceof HttpError) {
+      const stored = storedImport(err.body);
+      if (stored) return stored;
+    }
+    throw err;
+  }
+}
+function storedImport(body) {
+  try {
+    const parsed = JSON.parse(body);
+    if (parsed && parsed.stored === true) return parsed;
+  } catch {
+  }
+  return null;
+}
+function activateLicenseSafe(ctx) {
+  return request(ctx, `${ADMIN}/license/activate`, { method: "POST" });
+}
+async function removeLicenseSafe(ctx) {
+  await request(ctx, `${ADMIN}/license`, { method: "DELETE" });
+  return { ok: true };
+}
+function getLicenseFingerprintSafe(ctx) {
+  return request(ctx, `${ADMIN}/license/fingerprint`);
+}
 
 // src/resources/admin.ts
 var DEFAULT_NEW_USER_PASSWORD = "openbkn";
@@ -754,7 +795,13 @@ function admin(ctx) {
     roleUpdate: (roleId, input) => updateRoleSafe(ctx, roleId, input),
     roleDelete: (roleId) => deleteRoleSafe(ctx, roleId),
     rolePermission: (roleId, grant, resourceType, resourceId, operations) => setRolePermissionSafe(ctx, roleId, grant, { resourceType, resourceId, operations }),
-    auditList: (_opts) => notOnSafe("audit list")
+    auditList: (_opts) => notOnSafe("audit list"),
+    // ── license (cluster license hub; weak judgements — display/ops only) ──
+    licenseGet: () => getLicenseSafe(ctx),
+    licenseImport: (licenseText, opts) => importLicenseSafe(ctx, licenseText, opts),
+    licenseActivate: () => activateLicenseSafe(ctx),
+    licenseRemove: () => removeLicenseSafe(ctx),
+    licenseFingerprint: () => getLicenseFingerprintSafe(ctx)
   };
 }
 
@@ -1148,6 +1195,17 @@ function findSkills(ctx, knId, objectTypeId, topK) {
   if (topK !== void 0) args.top_k = topK;
   return callTool(ctx, knId, "find_skills", args);
 }
+function getKnDetail(ctx, knId, detailLevel) {
+  const args = { response_format: "json" };
+  if (detailLevel) args.detail_level = detailLevel;
+  return callTool(ctx, knId, "get_kn_detail", args);
+}
+function getObjectTypes(ctx, knId, ids) {
+  return callTool(ctx, knId, "get_object_types", { ids, response_format: "json" });
+}
+function getRelationTypes(ctx, knId, ids) {
+  return callTool(ctx, knId, "get_relation_types", { ids, response_format: "json" });
+}
 function listTools(ctx, knId) {
   return callMethod(ctx, knId, "tools/list");
 }
@@ -1182,6 +1240,10 @@ function context(ctx) {
     searchSchema: (knId, query, opts) => searchSchema(ctx, knId, query, opts),
     queryObjectInstance: (knId, args) => queryObjectInstance(ctx, knId, args),
     findSkills: (knId, objectTypeId, topK) => findSkills(ctx, knId, objectTypeId, topK),
+    // Progressive schema disclosure: skeleton first (summary), then drill down.
+    knDetail: (knId, detailLevel) => getKnDetail(ctx, knId, detailLevel),
+    objectTypes: (knId, ids) => getObjectTypes(ctx, knId, ids),
+    relationTypes: (knId, ids) => getRelationTypes(ctx, knId, ids),
     info: () => mcpInfo(ctx),
     tools: (knId) => listTools(ctx, knId),
     toolCall: (knId, name, args) => callTool(ctx, knId, name, args),
@@ -1507,7 +1569,16 @@ function listResources2(ctx, opts = {}) {
       catalog_id: opts.datasourceId || void 0,
       name: opts.name || void 0,
       category: opts.category || void 0,
-      limit: opts.limit && opts.limit > 0 ? opts.limit : void 0
+      status: opts.status || void 0,
+      database: opts.database || void 0,
+      limit: opts.limit && opts.limit > 0 ? opts.limit : void 0,
+      offset: opts.offset,
+      sort: opts.sort,
+      direction: opts.direction,
+      include_extensions: opts.includeExtensions === void 0 ? void 0 : String(opts.includeExtensions),
+      include_extension_keys: opts.includeExtensionKeys || void 0,
+      extension_key: opts.extensionPairs?.map((p) => p.key),
+      extension_value: opts.extensionPairs?.map((p) => p.value)
     }
   });
 }
@@ -1517,18 +1588,103 @@ function getResource(ctx, id) {
 function createResourceRaw(ctx, body) {
   return request(ctx, BASE3, { method: "POST", body });
 }
-function createResource(ctx, opts) {
+function updateResourceRaw(ctx, id, body) {
+  return request(ctx, `${BASE3}/${encodeURIComponent(id)}`, { method: "PUT", body });
+}
+async function updateResource(ctx, id, patch) {
+  const current = firstResource(await getResource(ctx, id));
+  return updateResourceRaw(ctx, id, resourceUpdateBody(id, current, patch));
+}
+async function configureResourceIndex(ctx, id, opts) {
+  const current = firstResource(await getResource(ctx, id));
+  const schema = (current.schema_definition ?? []).map((prop) => ({ ...prop }));
+  const indexConfig = {
+    ...current.index_config ?? {},
+    ...opts.buildKeyFields?.length ? { build_key_fields: opts.buildKeyFields } : {},
+    ...opts.embeddingModel ? { default_embedding_model: opts.embeddingModel } : {},
+    ...opts.fulltextAnalyzer ? { default_fulltext_analyzer: opts.fulltextAnalyzer } : {}
+  };
+  for (const field of opts.embeddingFields ?? []) {
+    ensureFeature(
+      schema,
+      field,
+      "vector",
+      opts.embeddingModel ? { embedding_model: opts.embeddingModel } : void 0
+    );
+  }
+  for (const field of opts.fulltextFields ?? []) {
+    ensureFeature(
+      schema,
+      field,
+      "fulltext",
+      opts.fulltextAnalyzer ? { analyzer: opts.fulltextAnalyzer } : void 0
+    );
+  }
+  return updateResourceRaw(
+    ctx,
+    id,
+    resourceUpdateBody(id, current, { schemaDefinition: schema, indexConfig })
+  );
+}
+function resourceUpdateBody(id, current, patch) {
   const body = {
-    name: opts.name,
-    catalog_id: opts.catalogId,
-    category: "table",
-    source_identifier: opts.sourceIdentifier
+    id,
+    name: patch.name ?? current.name,
+    catalog_id: patch.catalogId ?? current.catalog_id,
+    tags: patch.tags ?? current.tags ?? [],
+    description: patch.description ?? current.description ?? "",
+    category: patch.category ?? current.category,
+    status: patch.status ?? current.status,
+    database: patch.database ?? current.database,
+    source_identifier: patch.sourceIdentifier ?? current.source_identifier,
+    source_metadata: patch.sourceMetadata ?? current.source_metadata,
+    schema_definition: patch.schemaDefinition ?? current.schema_definition,
+    index_config: patch.indexConfig === void 0 ? current.index_config : patch.indexConfig,
+    logic_definition: patch.logicDefinition ?? current.logic_definition
   };
-  if (opts.fields && opts.fields.length > 0) body.schema_definition = opts.fields;
-  return request(ctx, BASE3, { method: "POST", body });
+  if (patch.extensions !== void 0 || current.extensions !== void 0) {
+    body.extensions = patch.extensions ?? current.extensions;
+  }
+  return body;
+}
+function ensureFeature(schema, field, featureType, config) {
+  const prop = schema.find((p) => p.name === field);
+  if (!prop) throw new Error(`resource field '${field}' not found in schema_definition`);
+  const features = [...prop.features ?? []];
+  const existing = features.find(
+    (f) => f.feature_type === featureType && (f.ref_property || field) === field
+  );
+  if (existing) {
+    existing.ref_property = existing.ref_property || field;
+    existing.config = { ...existing.config ?? {}, ...config ?? {} };
+  } else {
+    features.push({
+      name: `${field}_${featureType}`,
+      feature_type: featureType,
+      ref_property: field,
+      is_default: false,
+      is_native: false,
+      ...config ? { config } : {}
+    });
+  }
+  prop.features = features;
 }
-function deleteResource(ctx, id) {
-  return request(ctx, `${BASE3}/${encodeURIComponent(id)}`, { method: "DELETE" });
+function firstResource(result) {
+  if (result && typeof result === "object") {
+    const o = result;
+    if (Array.isArray(o.entries)) return o.entries[0] ?? {};
+    return o;
+  }
+  return {};
+}
+function deleteResource(ctx, id, opts = {}) {
+  const ids = Array.isArray(id) ? id : [id];
+  return request(ctx, `${BASE3}/${ids.map(encodeURIComponent).join(",")}`, {
+    method: "DELETE",
+    query: {
+      ignore_missing: opts.ignoreMissing === void 0 ? void 0 : String(opts.ignoreMissing)
+    }
+  });
 }
 async function findResource(ctx, name, opts = {}) {
   const result = await listResources2(ctx, { name, datasourceId: opts.datasourceId });
@@ -2860,10 +3016,7 @@ var BuildMode = z.enum(["batch", "streaming"]);
 var CreateBuildTaskRequest = z.object({
   resource_id: z.string().min(1),
   mode: BuildMode,
-  embedding_fields: z.array(z.string()).optional(),
-  build_key_fields: z.array(z.string()).optional(),
-  embedding_model: z.string().optional(),
-  model_dimensions: z.number().int().positive().optional()
+  execute_type: z.enum(["incremental", "full"]).optional()
 });
 var BuildTask = z.object({
   id: z.string(),
@@ -2874,34 +3027,83 @@ var BuildTask = z.object({
   total_count: z.number().optional(),
   synced_count: z.number().optional(),
   vectorized_count: z.number().optional(),
-  embedding_fields: z.string().optional(),
-  build_key_fields: z.string().optional(),
-  embedding_model: z.string().optional(),
-  model_dimensions: z.number().optional()
+  index_config: z.unknown().optional(),
+  catalog_id: z.string().optional(),
+  index_health: z.object({
+    embedding: z.string(),
+    fulltext: z.string(),
+    usable: z.boolean()
+  }).passthrough().optional()
 }).passthrough();
 async function createBuildTask(ctx, req) {
   const p = CreateBuildTaskRequest.parse(req);
   const body = {
     resource_id: p.resource_id,
     mode: p.mode,
-    ...p.embedding_fields?.length ? { embedding_fields: p.embedding_fields.join(",") } : {},
-    ...p.build_key_fields?.length ? { build_key_fields: p.build_key_fields.join(",") } : {},
-    ...p.embedding_model ? { embedding_model: p.embedding_model } : {},
-    ...p.model_dimensions ? { model_dimensions: p.model_dimensions } : {}
+    ...p.execute_type ? { execute_type: p.execute_type } : {}
   };
   const res = await request(ctx, `${VEGA_BASE}/build-tasks`, { method: "POST", body });
   return BuildTask.parse(res);
 }
+function listBuildTasks(ctx, opts = {}) {
+  return request(ctx, `${VEGA_BASE}/build-tasks`, {
+    query: {
+      limit: opts.limit,
+      offset: opts.offset,
+      resource_id: opts.resourceId || void 0,
+      catalog_id: opts.catalogId || void 0,
+      status: Array.isArray(opts.status) ? opts.status.join(",") : opts.status || void 0,
+      active: opts.active === void 0 ? void 0 : String(opts.active),
+      mode: opts.mode,
+      order_by: opts.orderBy,
+      order: opts.order
+    }
+  });
+}
 async function getBuildTask(ctx, taskId) {
   const res = await request(ctx, `${VEGA_BASE}/build-tasks/${encodeURIComponent(taskId)}`);
   return BuildTask.parse(res);
 }
+function deleteBuildTasks(ctx, ids, opts = {}) {
+  return request(ctx, `${VEGA_BASE}/build-tasks/${ids.map(encodeURIComponent).join(",")}`, {
+    method: "DELETE",
+    query: {
+      ignore_missing: opts.ignoreMissing === void 0 ? void 0 : String(opts.ignoreMissing),
+      delete_active_index: opts.deleteActiveIndex === void 0 ? void 0 : String(opts.deleteActiveIndex)
+    }
+  });
+}
+function startBuildTask(ctx, taskId, opts = {}) {
+  return request(ctx, `${VEGA_BASE}/build-tasks/${encodeURIComponent(taskId)}/start`, {
+    method: "POST",
+    body: opts.reset === void 0 ? {} : { reset: opts.reset }
+  });
+}
+function stopBuildTask(ctx, taskId) {
+  return request(ctx, `${VEGA_BASE}/build-tasks/${encodeURIComponent(taskId)}/stop`, {
+    method: "POST"
+  });
+}
 function runSql(ctx, body) {
   return request(ctx, `${VEGA_BASE}/resources/query`, { method: "POST", body });
 }
 async function listCatalogs(ctx, opts = {}) {
   return request(ctx, `${VEGA_BASE}/catalogs`, {
-    query: { limit: opts.limit, offset: opts.offset }
+    query: {
+      limit: opts.limit,
+      offset: opts.offset,
+      name: opts.name || void 0,
+      tag: opts.tag || void 0,
+      type: opts.type || void 0,
+      enabled: opts.enabled === void 0 ? void 0 : String(opts.enabled),
+      health_check_status: opts.healthCheckStatus || void 0,
+      include_extensions: opts.includeExtensions === void 0 ? void 0 : String(opts.includeExtensions),
+      include_extension_keys: opts.includeExtensionKeys || void 0,
+      extension_key: opts.extensionPairs?.map((p) => p.key),
+      extension_value: opts.extensionPairs?.map((p) => p.value),
+      sort: opts.sort,
+      direction: opts.direction
+    }
   });
 }
 function getCatalog(ctx, id) {
@@ -2911,18 +3113,49 @@ function createCatalog(ctx, req) {
   return request(ctx, `${VEGA_BASE}/catalogs`, {
     method: "POST",
     body: {
+      ...req.id ? { id: req.id } : {},
       name: req.name,
       connector_type: req.connectorType,
       connector_config: req.connectorConfig,
       ...req.tags ? { tags: req.tags } : {},
       ...req.description ? { description: req.description } : {},
-      ...req.enabled !== void 0 ? { enabled: req.enabled } : {}
+      ...req.enabled !== void 0 ? { enabled: req.enabled } : {},
+      ...req.internal !== void 0 ? { internal: req.internal } : {},
+      ...req.extensions ? { extensions: req.extensions } : {}
+    }
+  });
+}
+function updateCatalog(ctx, id, req) {
+  return request(ctx, `${VEGA_BASE}/catalogs/${encodeURIComponent(id)}`, {
+    method: "PUT",
+    body: {
+      ...req.id ? { id: req.id } : {},
+      ...req.name ? { name: req.name } : {},
+      ...req.connectorType ? { connector_type: req.connectorType } : {},
+      ...req.connectorConfig !== void 0 ? { connector_config: req.connectorConfig } : {},
+      ...req.tags ? { tags: req.tags } : {},
+      ...req.description !== void 0 ? { description: req.description } : {},
+      ...req.enabled !== void 0 ? { enabled: req.enabled } : {},
+      ...req.extensions ? { extensions: req.extensions } : {}
     }
   });
 }
 function enableCatalog(ctx, id) {
   return request(ctx, `${VEGA_BASE}/catalogs/${encodeURIComponent(id)}/enable`, { method: "POST" });
 }
+function disableCatalog(ctx, id) {
+  return request(ctx, `${VEGA_BASE}/catalogs/${encodeURIComponent(id)}/disable`, {
+    method: "POST"
+  });
+}
+function deleteCatalog(ctx, id) {
+  return request(ctx, `${VEGA_BASE}/catalogs/${encodeURIComponent(id)}`, { method: "DELETE" });
+}
+function testCatalogConnection(ctx, id) {
+  return request(ctx, `${VEGA_BASE}/catalogs/${encodeURIComponent(id)}/test-connection`, {
+    method: "POST"
+  });
+}
 function discoverCatalog(ctx, id, wait = true) {
   return request(ctx, `${VEGA_BASE}/catalogs/${encodeURIComponent(id)}/discover`, {
     method: "POST",
@@ -3392,7 +3625,7 @@ async function createFromCatalog(ctx, opts) {
     }
     tablePk[t.name] = res.pk;
   }
-  log(`Creating resources for ${targets.length} table(s)...`);
+  log(`Resolving discovered resources for ${targets.length} table(s)...`);
   const viewMap = {};
   for (const t of targets) {
     const found = asArray(
@@ -3402,13 +3635,9 @@ async function createFromCatalog(ctx, opts) {
     if (existingId) {
       viewMap[t.name] = existingId;
     } else {
-      const created = await createResource(ctx, {
-        name: t.name,
-        catalogId: opts.catalogId,
-        sourceIdentifier: t.name,
-        fields: t.columns.map((c) => ({ name: c.name, type: c.type }))
-      });
-      viewMap[t.name] = String(created.id ?? "");
+      throw new Error(
+        `Table '${t.name}' has no discovered Vega resource. Run catalog discover and retry.`
+      );
     }
   }
   const knCreated = await createKnowledgeNetwork(ctx, { name: opts.name });
@@ -3440,12 +3669,14 @@ async function createFromCatalog(ctx, opts) {
       log("Submitting build tasks...");
       for (const t of targets) {
         const embedding = opts.embeddingFields?.[t.name];
+        await configureResourceIndex(ctx, viewMap[t.name], {
+          buildKeyFields: [tablePk[t.name]],
+          ...embedding && embedding.length > 0 ? { embeddingFields: embedding } : {},
+          ...opts.embeddingModel ? { embeddingModel: opts.embeddingModel } : {}
+        });
         const task = await createBuildTask(ctx, {
           resource_id: viewMap[t.name],
-          mode: "batch",
-          build_key_fields: [tablePk[t.name]],
-          ...embedding && embedding.length > 0 ? { embedding_fields: embedding } : {},
-          ...opts.embeddingModel ? { embedding_model: opts.embeddingModel } : {}
+          mode: "batch"
         });
         builds.push({ table: t.name, taskId: String(task.id ?? "") });
       }
@@ -3623,12 +3854,19 @@ function kn(ctx) {
       const targets = collectIndexTargets(dir);
       const buildTasks = [];
       for (const t of targets) {
+        if (!t.buildKey) {
+          throw new Error(
+            `Object type '${t.objectType}' declares a vector index but no build key; batch Vega builds require resource index_config.build_key_fields.`
+          );
+        }
+        await configureResourceIndex(ctx, t.resourceId, {
+          buildKeyFields: [t.buildKey],
+          embeddingFields: t.embeddingFields,
+          ...t.embeddingModel ?? opts.embeddingModel ? { embeddingModel: t.embeddingModel ?? opts.embeddingModel } : {}
+        });
         const task = await createBuildTask(ctx, {
           resource_id: t.resourceId,
-          mode: "batch",
-          embedding_fields: t.embeddingFields,
-          ...t.buildKey ? { build_key_fields: [t.buildKey] } : {},
-          ...t.embeddingModel ?? opts.embeddingModel ? { embedding_model: t.embeddingModel ?? opts.embeddingModel } : {}
+          mode: "batch"
         });
         buildTasks.push({
           objectType: t.objectType,
@@ -3807,6 +4045,8 @@ function resources(ctx) {
     list: (opts) => listResources2(ctx, opts),
     get: (id) => getResource(ctx, id),
     delete: (id) => deleteResource(ctx, id),
+    update: (id, patch) => updateResource(ctx, id, patch),
+    configureIndex: (id, opts) => configureResourceIndex(ctx, id, opts),
     find: (name, opts) => findResource(ctx, name, opts),
     query: (id, opts) => queryResource(ctx, id, opts)
   };
@@ -4219,7 +4459,7 @@ async function getSpansByConversation(ctx, conversationId, opts = {}) {
   return (spans.hits?.hits ?? []).map((h) => h._source ?? {});
 }
 
-// src/trace-ai/claude-judge.ts
+// src/bkn-trace/claude-judge.ts
 import { spawn as spawn2, spawnSync as spawnSync2 } from "child_process";
 var ClaudeJudgeError = class extends Error {
   constructor(message, reason) {
@@ -4301,7 +4541,7 @@ async function judgeJson(prompt, opts = {}) {
   return JSON.parse(extractJsonObject(text));
 }
 
-// src/trace-ai/diagnose.ts
+// src/bkn-trace/diagnose.ts
 var KIND_MAP = {
   chat: "llm",
   text_completion: "llm",
@@ -4695,7 +4935,7 @@ function renderReportMarkdown(r) {
   return lines.join("\n");
 }
 
-// src/trace-ai/eval-set.ts
+// src/bkn-trace/eval-set.ts
 function hashId(s) {
   let h = 5381;
   for (let i = 0; i < s.length; i++) h = h * 33 ^ s.charCodeAt(i);
@@ -4959,7 +5199,11 @@ function vega(ctx) {
     catalogs: (opts) => listCatalogs(ctx, opts),
     getCatalog: (id) => getCatalog(ctx, id),
     createCatalog: (req) => createCatalog(ctx, req),
+    updateCatalog: (id, req) => updateCatalog(ctx, id, req),
     enableCatalog: (id) => enableCatalog(ctx, id),
+    disableCatalog: (id) => disableCatalog(ctx, id),
+    deleteCatalog: (id) => deleteCatalog(ctx, id),
+    testCatalogConnection: (id) => testCatalogConnection(ctx, id),
     discoverCatalog: (id, wait = false) => discoverCatalog(ctx, id, wait),
     catalogResources: (id, category) => listCatalogResources(ctx, id, category),
     catalogHealth: (ids) => catalogHealthStatus(ctx, ids),
@@ -4973,7 +5217,11 @@ function vega(ctx) {
       if (!opts.wait) return task;
       return pollBuildTask(ctx, task.id, opts.timeoutMs ?? 3e5, opts.intervalMs ?? 2e3);
     },
-    buildStatus: (taskId) => getBuildTask(ctx, taskId)
+    buildStatus: (taskId) => getBuildTask(ctx, taskId),
+    buildTasks: (opts) => listBuildTasks(ctx, opts),
+    deleteBuildTasks: (ids, opts) => deleteBuildTasks(ctx, ids, opts),
+    startBuildTask: (taskId, opts) => startBuildTask(ctx, taskId, opts),
+    stopBuildTask: (taskId) => stopBuildTask(ctx, taskId)
   };
 }
 async function pollBuildTask(ctx, taskId, timeoutMs, intervalMs) {
@@ -5331,4 +5579,4 @@ export {
   exportCreds,
   auth_exports
 };
-//# sourceMappingURL=chunk-KF3J46WL.js.map
+//# sourceMappingURL=chunk-LCOMMFH7.js.map