@kweaver-ai/kweaver-sdk 0.5.1 → 0.6.0

package/dist/kweaver.js

@@ -41,8 +41,25 @@ export function configure(opts) {
     _client = null;
     _defaultBknId = null;
     _defaultAgentId = null;
-    const { bknId, agentId, businessDomain, config, baseUrl, accessToken } = opts;
-    if (config) {
+    const { bknId, agentId, businessDomain, config, baseUrl, accessToken, auth } = opts;
+    if (auth === false && config) {
+        throw new Error("Cannot use auth: false with config: true.");
+    }
+    if (auth === false && accessToken) {
+        throw new Error("Cannot use auth: false with accessToken.");
+    }
+    if (auth === false) {
+        const resolvedBase = baseUrl ?? process.env.KWEAVER_BASE_URL;
+        if (!resolvedBase) {
+            throw new Error("Provide baseUrl= or set KWEAVER_BASE_URL when auth is false.");
+        }
+        _client = new KWeaverClient({
+            baseUrl: resolvedBase,
+            auth: false,
+            businessDomain,
+        });
+    }
+    else if (config) {
         // Use saved credentials — do NOT pass baseUrl to avoid cross-env leaks
         const platform = getCurrentPlatform();
         if (!platform) {
@@ -58,6 +75,19 @@ export function configure(opts) {
             businessDomain,
         });
     }
+    else if (!accessToken &&
+        !process.env.KWEAVER_TOKEN &&
+        ["1", "true", "yes"].includes((process.env.KWEAVER_NO_AUTH ?? "").toLowerCase())) {
+        const resolvedBase = baseUrl ?? process.env.KWEAVER_BASE_URL;
+        if (!resolvedBase) {
+            throw new Error("Provide baseUrl= or set KWEAVER_BASE_URL when KWEAVER_NO_AUTH is set.");
+        }
+        _client = new KWeaverClient({
+            baseUrl: resolvedBase,
+            auth: false,
+            businessDomain,
+        });
+    }
     else {
         if (!baseUrl && !process.env.KWEAVER_BASE_URL) {
             throw new Error("Provide baseUrl=, config=true, or set KWEAVER_BASE_URL.");

package/dist/resources/bkn.d.ts

@@ -32,6 +32,10 @@ export declare class BknResource {
     queryProperties(knId: string, otId: string, body: Record<string, unknown>): Promise<unknown>;
     querySubgraph(knId: string, body: Record<string, unknown>): Promise<unknown>;
     queryAction(knId: string, atId: string, body: Record<string, unknown>): Promise<unknown>;
+    /**
+     * Execute an action type (has side effects).
+     * @param body - Must include `_instance_identities`: `[{"<primary_key>": "<value>"}]`
+     */
     executeAction(knId: string, atId: string, body: Record<string, unknown>): Promise<unknown>;
     getExecution(knId: string, executionId: string): Promise<unknown>;
     listActionLogs(knId: string, opts?: {

package/dist/resources/bkn.js

@@ -1,3 +1,4 @@
+import { buildHeaders } from "../api/headers.js";
 import { objectTypeQuery, objectTypeProperties, subgraph, actionTypeQuery, actionTypeExecute, actionExecutionGet, actionLogsList, actionLogGet, actionLogCancel, } from "../api/ontology-query.js";
 import { fetchTextOrThrow } from "../utils/http.js";
 /** BKN engine resource — instance queries, subgraph, action execution and logs. */
@@ -21,9 +22,7 @@ export class BknResource {
             method: "POST",
             headers: {
                 "content-type": "application/json",
-                authorization: `Bearer ${accessToken}`,
-                token: accessToken,
-                "x-business-domain": businessDomain,
+                ...buildHeaders(accessToken, businessDomain),
             },
             body: JSON.stringify({
                 kn_id: bknId,
@@ -57,6 +56,10 @@ export class BknResource {
         const raw = await actionTypeQuery({ ...this.ctx.base(), knId, atId, body: JSON.stringify(body) });
         return JSON.parse(raw);
     }
+    /**
+     * Execute an action type (has side effects).
+     * @param body - Must include `_instance_identities`: `[{"<primary_key>": "<value>"}]`
+     */
     async executeAction(knId, atId, body) {
         const raw = await actionTypeExecute({ ...this.ctx.base(), knId, atId, body: JSON.stringify(body) });
         return JSON.parse(raw);

package/dist/resources/conversations.d.ts

@@ -4,8 +4,11 @@ export declare class ConversationsResource {
     constructor(ctx: ClientContext);
     list(agentId: string, opts?: {
         limit?: number;
+        page?: number;
+        size?: number;
+        version?: string;
     }): Promise<unknown[]>;
-    listMessages(conversationId: string, opts?: {
-        limit?: number;
+    listMessages(agentId: string, conversationId: string, opts?: {
+        version?: string;
     }): Promise<unknown[]>;
 }

package/dist/resources/conversations.js

@@ -1,16 +1,30 @@
 import { listConversations, listMessages } from "../api/conversations.js";
+import { fetchAgentInfo } from "../api/agent-chat.js";
 export class ConversationsResource {
     ctx;
     constructor(ctx) {
         this.ctx = ctx;
     }
     async list(agentId, opts = {}) {
-        const raw = await listConversations({ ...this.ctx.base(), agentId, ...opts });
+        const { version = "v0", limit, page, size } = opts;
+        const info = await fetchAgentInfo({ ...this.ctx.base(), agentId, version });
+        const raw = await listConversations({
+            ...this.ctx.base(),
+            agentKey: info.key,
+            page: page ?? 1,
+            size: size ?? (limit ?? 10),
+        });
         const parsed = JSON.parse(raw);
         return Array.isArray(parsed) ? parsed : [];
     }
-    async listMessages(conversationId, opts = {}) {
-        const raw = await listMessages({ ...this.ctx.base(), conversationId, ...opts });
+    async listMessages(agentId, conversationId, opts = {}) {
+        const { version = "v0" } = opts;
+        const info = await fetchAgentInfo({ ...this.ctx.base(), agentId, version });
+        const raw = await listMessages({
+            ...this.ctx.base(),
+            agentKey: info.key,
+            conversationId,
+        });
         const parsed = JSON.parse(raw);
         return Array.isArray(parsed) ? parsed : [];
     }

package/dist/resources/knowledge-networks.js

@@ -1,3 +1,4 @@
+import { buildHeaders } from "../api/headers.js";
 import { listKnowledgeNetworks, getKnowledgeNetwork, createKnowledgeNetwork, updateKnowledgeNetwork, deleteKnowledgeNetwork, listObjectTypes, listRelationTypes, listActionTypes, } from "../api/knowledge-networks.js";
 import { fetchTextOrThrow } from "../utils/http.js";
 export class KnowledgeNetworksResource {
@@ -69,9 +70,7 @@ export class KnowledgeNetworksResource {
         const { baseUrl, accessToken, businessDomain } = this.ctx.base();
         const headers = {
             "content-type": "application/json",
-            authorization: `Bearer ${accessToken}`,
-            token: accessToken,
-            "x-business-domain": businessDomain,
+            ...buildHeaders(accessToken, businessDomain),
         };
         await fetchTextOrThrow(`${baseUrl}/api/ontology-manager/v1/knowledge-networks/${encodeURIComponent(bknId)}/jobs`, {
             method: "POST",
@@ -82,11 +81,7 @@ export class KnowledgeNetworksResource {
     /** Poll build status for a BKN. */
     async buildStatus(bknId) {
         const { baseUrl, accessToken, businessDomain } = this.ctx.base();
-        const headers = {
-            authorization: `Bearer ${accessToken}`,
-            token: accessToken,
-            "x-business-domain": businessDomain,
-        };
+        const headers = buildHeaders(accessToken, businessDomain);
         const { body } = await fetchTextOrThrow(`${baseUrl}/api/ontology-manager/v1/knowledge-networks/${encodeURIComponent(bknId)}/jobs?limit=1&direction=desc`, { headers });
         const data = JSON.parse(body);
         const jobs = Array.isArray(data)

package/dist/resources/skills.d.ts

@@ -0,0 +1,47 @@
+import type { ClientContext } from "../client.js";
+import { type SkillListResult, type SkillStatus } from "../api/skills.js";
+export declare class SkillsResource {
+    private readonly ctx;
+    constructor(ctx: ClientContext);
+    list(opts?: {
+        page?: number;
+        pageSize?: number;
+        sortBy?: "create_time" | "update_time" | "name";
+        sortOrder?: "asc" | "desc";
+        all?: boolean;
+        name?: string;
+        status?: SkillStatus;
+        source?: string;
+        createUser?: string;
+    }): Promise<SkillListResult>;
+    market(opts?: {
+        page?: number;
+        pageSize?: number;
+        sortBy?: "create_time" | "update_time" | "name";
+        sortOrder?: "asc" | "desc";
+        all?: boolean;
+        name?: string;
+        source?: string;
+    }): Promise<SkillListResult>;
+    get(skillId: string): Promise<import("../api/skills.js").SkillInfo>;
+    registerContent(content: string, opts?: {
+        source?: string;
+        extendInfo?: Record<string, unknown>;
+    }): Promise<import("../api/skills.js").RegisterSkillResult>;
+    registerZip(filename: string, bytes: Uint8Array, opts?: {
+        source?: string;
+        extendInfo?: Record<string, unknown>;
+    }): Promise<import("../api/skills.js").RegisterSkillResult>;
+    delete(skillId: string): Promise<import("../api/skills.js").DeleteSkillResult>;
+    updateStatus(skillId: string, status: SkillStatus): Promise<import("../api/skills.js").UpdateSkillStatusResult>;
+    content(skillId: string): Promise<import("../api/skills.js").SkillContentIndex>;
+    fetchContent(skillId: string): Promise<string>;
+    readFile(skillId: string, relPath: string): Promise<import("../api/skills.js").SkillFileReadResult>;
+    fetchFile(skillId: string, relPath: string): Promise<Uint8Array<ArrayBufferLike>>;
+    download(skillId: string): Promise<import("../api/skills.js").DownloadedSkillArchive>;
+    install(skillId: string, directory: string, opts?: {
+        force?: boolean;
+    }): Promise<{
+        directory: string;
+    }>;
+}

package/dist/resources/skills.js

@@ -0,0 +1,47 @@
+import { deleteSkill, downloadSkill, fetchSkillContent, fetchSkillFile, getSkill, getSkillContentIndex, installSkillArchive, listSkillMarket, listSkills, readSkillFile, registerSkillContent, registerSkillZip, updateSkillStatus, } from "../api/skills.js";
+export class SkillsResource {
+    ctx;
+    constructor(ctx) {
+        this.ctx = ctx;
+    }
+    async list(opts = {}) {
+        return listSkills({ ...this.ctx.base(), pageSize: 30, ...opts });
+    }
+    async market(opts = {}) {
+        return listSkillMarket({ ...this.ctx.base(), pageSize: 30, ...opts });
+    }
+    async get(skillId) {
+        return getSkill({ ...this.ctx.base(), skillId });
+    }
+    async registerContent(content, opts = {}) {
+        return registerSkillContent({ ...this.ctx.base(), content, ...opts });
+    }
+    async registerZip(filename, bytes, opts = {}) {
+        return registerSkillZip({ ...this.ctx.base(), filename, bytes, ...opts });
+    }
+    async delete(skillId) {
+        return deleteSkill({ ...this.ctx.base(), skillId });
+    }
+    async updateStatus(skillId, status) {
+        return updateSkillStatus({ ...this.ctx.base(), skillId, status });
+    }
+    async content(skillId) {
+        return getSkillContentIndex({ ...this.ctx.base(), skillId });
+    }
+    async fetchContent(skillId) {
+        return fetchSkillContent({ ...this.ctx.base(), skillId });
+    }
+    async readFile(skillId, relPath) {
+        return readSkillFile({ ...this.ctx.base(), skillId, relPath });
+    }
+    async fetchFile(skillId, relPath) {
+        return fetchSkillFile({ ...this.ctx.base(), skillId, relPath });
+    }
+    async download(skillId) {
+        return downloadSkill({ ...this.ctx.base(), skillId });
+    }
+    async install(skillId, directory, opts = {}) {
+        const archive = await this.download(skillId);
+        return installSkillArchive({ bytes: archive.bytes, directory, force: opts.force });
+    }
+}

package/dist/resources/vega.d.ts

@@ -40,16 +40,21 @@ export declare class VegaResource {
     createResource(body: string): Promise<unknown>;
     updateResource(id: string, body: string): Promise<unknown>;
     deleteResources(ids: string): Promise<unknown>;
+    createDatasetDocs(id: string, body: string): Promise<unknown>;
+    updateDatasetDocs(id: string, body: string): Promise<unknown>;
+    deleteDatasetDocs(id: string, docIds: string): Promise<unknown>;
+    deleteDatasetDocsQuery(id: string, body: string): Promise<unknown>;
+    buildDataset(id: string, mode?: string): Promise<unknown>;
+    getDatasetBuildStatus(id: string, taskId: string): Promise<unknown>;
+    executeQuery(body: string): Promise<unknown>;
+    listAllResources(opts?: {
+        limit?: number;
+        offset?: number;
+    }): Promise<unknown[]>;
     listConnectorTypes(): Promise<unknown[]>;
     getConnectorType(type: string): Promise<unknown>;
     registerConnectorType(body: string): Promise<unknown>;
     updateConnectorType(type: string, body: string): Promise<unknown>;
     deleteConnectorType(type: string): Promise<unknown>;
     setConnectorTypeEnabled(type: string, enabled: boolean): Promise<unknown>;
-    listDiscoverTasks(opts?: {
-        status?: string;
-        limit?: number;
-        offset?: number;
-    }): Promise<unknown[]>;
-    getDiscoverTask(id: string): Promise<unknown>;
 }

package/dist/resources/vega.js

@@ -1,4 +1,4 @@
-import { vegaHealth, listVegaCatalogs, getVegaCatalog, createVegaCatalog, updateVegaCatalog, deleteVegaCatalogs, vegaCatalogHealthStatus, testVegaCatalogConnection, discoverVegaCatalog, listVegaCatalogResources, listVegaResources, getVegaResource, queryVegaResourceData, createVegaResource, updateVegaResource, deleteVegaResources, listVegaConnectorTypes, getVegaConnectorType, registerVegaConnectorType, updateVegaConnectorType, deleteVegaConnectorType, setVegaConnectorTypeEnabled, listVegaDiscoverTasks, getVegaDiscoverTask, } from "../api/vega.js";
+import { vegaHealth, listVegaCatalogs, getVegaCatalog, createVegaCatalog, updateVegaCatalog, deleteVegaCatalogs, vegaCatalogHealthStatus, testVegaCatalogConnection, discoverVegaCatalog, listVegaCatalogResources, listVegaResources, getVegaResource, queryVegaResourceData, createVegaResource, updateVegaResource, deleteVegaResources, createVegaDatasetDocs, updateVegaDatasetDocs, deleteVegaDatasetDocs, deleteVegaDatasetDocsQuery, buildVegaDataset, getVegaDatasetBuildStatus, executeVegaQuery, listAllVegaResources, listVegaConnectorTypes, getVegaConnectorType, registerVegaConnectorType, updateVegaConnectorType, deleteVegaConnectorType, setVegaConnectorTypeEnabled, } from "../api/vega.js";
 function unwrapArray(raw) {
     const parsed = JSON.parse(raw);
     if (Array.isArray(parsed))
@@ -83,6 +83,42 @@ export class VegaResource {
         const raw = await deleteVegaResources({ ...this.ctx.base(), ids });
         return raw ? JSON.parse(raw) : {};
     }
+    // ── Dataset Docs ────────────────────────────────────────────────────────────
+    async createDatasetDocs(id, body) {
+        const raw = await createVegaDatasetDocs({ ...this.ctx.base(), id, body });
+        return JSON.parse(raw);
+    }
+    async updateDatasetDocs(id, body) {
+        const raw = await updateVegaDatasetDocs({ ...this.ctx.base(), id, body });
+        return raw ? JSON.parse(raw) : {};
+    }
+    async deleteDatasetDocs(id, docIds) {
+        const raw = await deleteVegaDatasetDocs({ ...this.ctx.base(), id, docIds });
+        return raw ? JSON.parse(raw) : {};
+    }
+    async deleteDatasetDocsQuery(id, body) {
+        const raw = await deleteVegaDatasetDocsQuery({ ...this.ctx.base(), id, body });
+        return raw ? JSON.parse(raw) : {};
+    }
+    // ── Dataset Build ──────────────────────────────────────────────────────────
+    async buildDataset(id, mode) {
+        const raw = await buildVegaDataset({ ...this.ctx.base(), id, mode });
+        return JSON.parse(raw);
+    }
+    async getDatasetBuildStatus(id, taskId) {
+        const raw = await getVegaDatasetBuildStatus({ ...this.ctx.base(), id, taskId });
+        return JSON.parse(raw);
+    }
+    // ── Query ──────────────────────────────────────────────────────────────────
+    async executeQuery(body) {
+        const raw = await executeVegaQuery({ ...this.ctx.base(), body });
+        return JSON.parse(raw);
+    }
+    // ── Resource List All ──────────────────────────────────────────────────────
+    async listAllResources(opts = {}) {
+        const raw = await listAllVegaResources({ ...this.ctx.base(), ...opts });
+        return unwrapArray(raw);
+    }
     // ── Connector Types ─────────────────────────────────────────────────────────
     async listConnectorTypes() {
         const raw = await listVegaConnectorTypes(this.ctx.base());
@@ -108,13 +144,4 @@ export class VegaResource {
         const raw = await setVegaConnectorTypeEnabled({ ...this.ctx.base(), type, enabled });
         return raw ? JSON.parse(raw) : {};
     }
-    // ── Discover Tasks ──────────────────────────────────────────────────────────
-    async listDiscoverTasks(opts = {}) {
-        const raw = await listVegaDiscoverTasks({ ...this.ctx.base(), ...opts });
-        return unwrapArray(raw);
-    }
-    async getDiscoverTask(id) {
-        const raw = await getVegaDiscoverTask({ ...this.ctx.base(), id });
-        return JSON.parse(raw);
-    }
 }

package/dist/templates/explorer/app.js

@@ -0,0 +1,136 @@
+// ---------------------------------------------------------------------------
+// Shared state
+// ---------------------------------------------------------------------------
+let navGeneration = 0;
+
+// ---------------------------------------------------------------------------
+// Utilities
+// ---------------------------------------------------------------------------
+function esc(s) {
+  if (s == null) return "";
+  return String(s).replace(/&/g, "&amp;").replace(/</g, "&lt;")
+    .replace(/>/g, "&gt;").replace(/"/g, "&quot;");
+}
+
+function enc(s) { return encodeURIComponent(s); }
+
+function formatValue(v) {
+  if (v == null) return '<span class="null">—</span>';
+  if (typeof v === "object") return "<pre>" + esc(JSON.stringify(v, null, 2)) + "</pre>";
+  return esc(String(v));
+}
+
+// ---------------------------------------------------------------------------
+// Cache utility
+// ---------------------------------------------------------------------------
+const CACHE_TTL = 5 * 60 * 1000;
+
+function cachedFetch(cache, key, fetcher) {
+  const entry = cache[key];
+  if (entry && Date.now() - entry.ts < CACHE_TTL) return Promise.resolve(entry.data);
+  return fetcher().then(data => { cache[key] = { data, ts: Date.now() }; return data; });
+}
+
+// ---------------------------------------------------------------------------
+// API helper
+// ---------------------------------------------------------------------------
+async function api(method, url, body) {
+  const opts = { method, headers: {} };
+  if (body) {
+    opts.headers["Content-Type"] = "application/json";
+    opts.body = JSON.stringify(body);
+  }
+  const res = await fetch(url, opts);
+  if (!res.ok) {
+    let msg = `${res.status} ${res.statusText}`;
+    try { const err = await res.json(); if (err.error) msg = err.error; } catch {}
+    const error = new Error(msg);
+    error.status = res.status;
+    throw error;
+  }
+  return res.json();
+}
+
+// ---------------------------------------------------------------------------
+// List extraction helper (handles various API response shapes)
+// ---------------------------------------------------------------------------
+function extractList(obj) {
+  if (obj == null || obj.error) return [];
+  if (Array.isArray(obj)) return obj;
+  for (const k of ["entries", "data", "knowledge_networks", "items"]) {
+    if (Array.isArray(obj[k])) return obj[k];
+  }
+  return [];
+}
+
+// ---------------------------------------------------------------------------
+// Router
+// ---------------------------------------------------------------------------
+function getRoute() {
+  const hash = location.hash.slice(1) || "/";
+  const [path, qs] = hash.split("?");
+  const parts = path.split("/").filter(Boolean);
+  const params = new URLSearchParams(qs || "");
+
+  if (parts.length === 0) return { view: "dashboard" };
+
+  const tab = parts[0];
+  return { tab, parts: parts.slice(1), params };
+}
+
+function navigate() {
+  navGeneration++;
+  const route = getRoute();
+  const $content = document.getElementById("content");
+
+  // Update active tab
+  document.querySelectorAll("#tab-bar .tab").forEach(t => {
+    const tabName = t.dataset.tab;
+    const isActive = route.view === "dashboard"
+      ? tabName === "dashboard"
+      : tabName === route.tab;
+    t.classList.toggle("active", isActive);
+  });
+
+  // Dispatch to tab renderer
+  if (route.view === "dashboard") {
+    if (typeof renderDashboard === "function") renderDashboard($content);
+    else $content.innerHTML = '<div class="loading">Dashboard loading...</div>';
+  } else if (route.tab === "chat") {
+    if (typeof renderChat === "function") renderChat($content, route.parts, route.params);
+    else $content.innerHTML = '<div class="loading">Chat loading...</div>';
+  } else if (route.tab === "bkn") {
+    if (typeof renderBkn === "function") renderBkn($content, route.parts, route.params);
+    else $content.innerHTML = '<div class="loading">BKN loading...</div>';
+  } else if (route.tab === "vega") {
+    if (typeof renderVega === "function") renderVega($content, route.parts, route.params);
+    else $content.innerHTML = '<div class="loading">Vega loading...</div>';
+  } else {
+    $content.innerHTML = '<div class="error-banner">Unknown route</div>';
+  }
+}
+
+// ---------------------------------------------------------------------------
+// Init
+// ---------------------------------------------------------------------------
+window.addEventListener("hashchange", navigate);
+window.addEventListener("DOMContentLoaded", () => {
+  // Theme Toggle
+  const themeToggle = document.getElementById("theme-toggle");
+  if (themeToggle) {
+    const savedTheme = localStorage.getItem("kweaver-theme");
+    if (savedTheme) {
+      document.documentElement.setAttribute("data-theme", savedTheme);
+      themeToggle.textContent = savedTheme === "dark" ? "☀️" : "🌙";
+    }
+    themeToggle.addEventListener("click", () => {
+      const currentTheme = document.documentElement.getAttribute("data-theme");
+      const newTheme = currentTheme === "dark" ? "light" : "dark";
+      document.documentElement.setAttribute("data-theme", newTheme);
+      localStorage.setItem("kweaver-theme", newTheme);
+      themeToggle.textContent = newTheme === "dark" ? "☀️" : "🌙";
+    });
+  }
+
+  navigate();
+});