@kweaver-ai/kweaver-sdk 0.5.1 → 0.6.0

package/dist/cli.js

@@ -1,3 +1,4 @@
+import { NO_AUTH_TOKEN } from "./config/no-auth.js";
 import { applyTlsEnvFromSavedTokens } from "./config/tls-env.js";
 import { runAgentCommand } from "./commands/agent.js";
 import { runAuthCommand } from "./commands/auth.js";
@@ -5,18 +6,22 @@ import { runKnCommand } from "./commands/bkn.js";
 import { runCallCommand } from "./commands/call.js";
 import { runConfigCommand } from "./commands/config.js";
 import { runContextLoaderCommand } from "./commands/context-loader.js";
+import { runDataflowCommand } from "./commands/dataflow.js";
 import { runDsCommand } from "./commands/ds.js";
+import { runExploreCommand } from "./commands/explore.js";
 import { runDataviewCommand } from "./commands/dataview.js";
+import { runSkillCommand } from "./commands/skill.js";
 import { runTokenCommand } from "./commands/token.js";
 import { runVegaCommand } from "./commands/vega.js";
 function printHelp() {
     console.log(`kweaver
 
 Usage:
+  kweaver [--user <userId|username>] <command> [options]
   kweaver --version | -V
   kweaver --help | -h
 
-  kweaver auth <platform-url> [--alias name] [-u user] [-p pass] [--playwright] [--insecure|-k]
+  kweaver auth <platform-url> [--alias name] [--no-auth] [-u user] [-p pass] [--playwright] [--insecure|-k]
   kweaver auth login <platform-url>          (alias for auth <url>)
   kweaver auth login <url> --client-id ID --client-secret S --refresh-token T   (run on host without browser)
   kweaver auth whoami [platform-url|alias] [--json]
@@ -24,8 +29,10 @@ Usage:
   kweaver auth status [platform-url|alias]
   kweaver auth list
   kweaver auth use <platform-url|alias>
-  kweaver auth logout [platform-url|alias]
-  kweaver auth delete <platform-url|alias>
+  kweaver auth users [platform-url|alias]
+  kweaver auth switch [platform-url|alias] --user <userId|username>
+  kweaver auth logout [platform-url|alias] [--user <userId>]
+  kweaver auth delete <platform-url|alias> [--user <userId>]
   kweaver token
 
   kweaver call <url> [-X METHOD] [-H "Name: value"] [-d BODY] [--data-raw BODY]
@@ -51,10 +58,15 @@ Usage:
   kweaver ds tables <id> [--keyword X] [--pretty]
   kweaver ds connect <db_type> <host> <port> <database> --account X --password Y [--schema S] [--name N]
 
+  kweaver dataflow list [-bd value]
+  kweaver dataflow run <dagId> (--file <path> | --url <remote-url> --name <filename>) [-bd value]
+  kweaver dataflow runs <dagId> [--since <date-like>] [-bd value]
+  kweaver dataflow logs <dagId> <instanceId> [--detail] [-bd value]
+
   kweaver dataview list [--datasource-id id] [--type atomic|custom] [--limit n] [-bd value] [--pretty]
   kweaver dataview find --name <name> [--exact] [--datasource-id id] [--wait] [--timeout ms] [-bd value] [--pretty]
   kweaver dataview get <id> [-bd value] [--pretty]
-  kweaver dataview query <id> [--sql sql] [--limit n] [--offset n] [--need-total] [-bd value] [--pretty]
+  kweaver dataview query <id> [--sql sql] [--limit n] [--offset n] [--need-total] [--raw-sql] [-bd value] [--pretty]
   kweaver dataview delete <id> [-y] [-bd value]
 
   kweaver bkn list [options]
@@ -81,6 +93,12 @@ Usage:
   kweaver config list-bd
   kweaver config show
 
+  kweaver skill list|get|register|status|delete [options]
+  kweaver skill market [options]
+  kweaver skill content <skill-id> [--raw] [--output file]
+  kweaver skill read-file <skill-id> <rel-path> [--raw] [--output file]
+  kweaver skill download|install <skill-id> [path] [options]
+
   kweaver vega health|stats|inspect
   kweaver vega catalog list|get|health|test-connection|discover|resources [options]
   kweaver vega resource list|get|query [options]
@@ -95,23 +113,40 @@ Usage:
   kweaver context-loader query-object-instance|query-instance-subgraph|get-logic-properties|get-action-info ...
   (alias: kweaver context ...)
 
+Global options:
+  --user <id|name>  Use a specific user's credentials for this command (env: KWEAVER_USER)
+
 Commands:
   auth           Login, list, inspect, and switch saved platform auth profiles
   token          Print the current access token, refreshing it first if needed
   call (curl)    Call an API with curl-style flags and auto-injected token headers
   agent          Agent CRUD, chat, sessions, history, publish/unpublish
   ds             Manage datasources (list, get, delete, tables, connect)
+  dataflow       Dataflow document workflows (list, run, runs, logs)
   dataview|dv    List, find, get, query (SQL), delete data views (atomic / custom)
   bkn            Knowledge network (CRUD, build, validate, export, stats, push/pull,
                  object-type, relation-type, subgraph, action-type, action-execution, action-log)
   config         Per-platform configuration (business domain)
+  skill          Skill registry and market (register, search, progressive read, download/install)
   vega           Vega observability (catalog, resource, connector-type, health/stats/inspect)
   context-loader Context-loader MCP (config, tools, resources, prompts, kn-search, query-*, etc.)
   help           Show this message`);
 }
 export async function run(argv) {
     applyTlsEnvFromSavedTokens();
-    const [command, ...rest] = argv;
+    const noAuthEnv = process.env.KWEAVER_NO_AUTH;
+    if ((noAuthEnv === "1" || noAuthEnv === "true" || noAuthEnv === "yes") &&
+        !process.env.KWEAVER_TOKEN) {
+        process.env.KWEAVER_TOKEN = NO_AUTH_TOKEN;
+    }
+    // Global --user flag: override active user for this invocation
+    const userIdx = argv.indexOf("--user");
+    let filteredArgv = argv;
+    if (userIdx !== -1 && userIdx + 1 < argv.length) {
+        process.env.KWEAVER_USER = argv[userIdx + 1];
+        filteredArgv = [...argv.slice(0, userIdx), ...argv.slice(userIdx + 2)];
+    }
+    const [command, ...rest] = filteredArgv;
     if (command === "--version" || command === "-V" || command === "version") {
         const { createRequire } = await import("node:module");
         const require = createRequire(import.meta.url);
@@ -132,6 +167,9 @@ export async function run(argv) {
     if (command === "ds") {
         return runDsCommand(rest);
     }
+    if (command === "dataflow") {
+        return runDataflowCommand(rest);
+    }
     if (command === "dataview" || command === "dv") {
         return runDataviewCommand(rest);
     }
@@ -141,6 +179,9 @@ export async function run(argv) {
     if (command === "agent") {
         return runAgentCommand(rest);
     }
+    if (command === "explore") {
+        return runExploreCommand(rest);
+    }
     if (command === "bkn") {
         return runKnCommand(rest);
     }
@@ -150,6 +191,9 @@ export async function run(argv) {
     if (command === "config") {
         return runConfigCommand(rest);
     }
+    if (command === "skill") {
+        return runSkillCommand(rest);
+    }
     if (command === "context-loader" || command === "context") {
         return runContextLoaderCommand(rest);
     }

package/dist/client.d.ts

@@ -6,6 +6,7 @@ import { DataSourcesResource } from "./resources/datasources.js";
 import { DataViewsResource } from "./resources/dataviews.js";
 import { KnowledgeNetworksResource } from "./resources/knowledge-networks.js";
 import { BknResource } from "./resources/bkn.js";
+import { SkillsResource } from "./resources/skills.js";
 import { VegaResource } from "./resources/vega.js";
 /**
  * Shared credentials passed to every resource method.
@@ -39,8 +40,17 @@ export interface KWeaverClientOptions {
      * When true, read credentials exclusively from ~/.kweaver/ (saved by
      * `kweaver auth login`), ignoring KWEAVER_BASE_URL / KWEAVER_TOKEN env vars.
      * Useful when env vars hold stale tokens or are intended for other tooling.
+     * Incompatible with `auth: false` — the constructor throws if both are set.
      */
     config?: boolean;
+    /**
+     * When false, use no-auth mode: API requests omit Authorization / token headers.
+     * Requires a resolvable base URL: `baseUrl`, `KWEAVER_BASE_URL`, or the active
+     * platform from `kweaver auth login`. Incompatible with `config: true` — use
+     * saved `~/.kweaver/` credentials (including `__NO_AUTH__`) via `config: true`
+     * alone instead of passing `auth: false`.
+     */
+    auth?: boolean;
 }
 /**
  * Main entry point for the KWeaver TypeScript SDK.
@@ -90,6 +100,8 @@ export declare class KWeaverClient implements ClientContext {
     readonly dataviews: DataViewsResource;
     /** Vega observability platform (catalogs, resources, connector types). */
     readonly vega: VegaResource;
+    /** ADP/KWeaver skill registry, market, progressive read, and install helpers. */
+    readonly skills: SkillsResource;
     constructor(opts?: KWeaverClientOptions);
     /**
      * Async factory that auto-refreshes expired or revoked tokens.

package/dist/client.js

@@ -1,5 +1,7 @@
 import { applyTlsEnvFromSavedTokens } from "./config/tls-env.js";
+import { NO_AUTH_TOKEN, isNoAuth } from "./config/no-auth.js";
 import { getCurrentPlatform, loadTokenConfig, } from "./config/store.js";
+import { buildHeaders } from "./api/headers.js";
 import { ensureValidToken } from "./auth/oauth.js";
 import { AgentsResource } from "./resources/agents.js";
 import { ConversationsResource } from "./resources/conversations.js";
@@ -9,6 +11,7 @@ import { DataSourcesResource } from "./resources/datasources.js";
 import { DataViewsResource } from "./resources/dataviews.js";
 import { KnowledgeNetworksResource } from "./resources/knowledge-networks.js";
 import { BknResource } from "./resources/bkn.js";
+import { SkillsResource } from "./resources/skills.js";
 import { VegaResource } from "./resources/vega.js";
 // ── KWeaverClient ─────────────────────────────────────────────────────────────
 /**
@@ -59,10 +62,43 @@ export class KWeaverClient {
     dataviews;
     /** Vega observability platform (catalogs, resources, connector types). */
     vega;
+    /** ADP/KWeaver skill registry, market, progressive read, and install helpers. */
+    skills;
     constructor(opts = {}) {
         const envDomain = process.env.KWEAVER_BUSINESS_DOMAIN;
+        if (opts.auth === false && opts.config) {
+            throw new Error("KWeaverClient: auth: false is incompatible with config: true.");
+        }
         let baseUrl;
         let accessToken;
+        if (opts.auth === false) {
+            {
+                const envUrl = process.env.KWEAVER_BASE_URL;
+                baseUrl = opts.baseUrl ?? envUrl;
+                if (!baseUrl) {
+                    const platform = getCurrentPlatform();
+                    if (platform)
+                        baseUrl = platform;
+                }
+            }
+            if (!baseUrl) {
+                throw new Error("KWeaverClient: baseUrl is required when auth is false. " +
+                    "Pass it explicitly, set KWEAVER_BASE_URL, or run `kweaver auth login`.");
+            }
+            this._baseUrl = baseUrl.replace(/\/+$/, "");
+            this._accessToken = NO_AUTH_TOKEN;
+            this._businessDomain = opts.businessDomain ?? envDomain ?? "bd_public";
+            this.knowledgeNetworks = new KnowledgeNetworksResource(this);
+            this.agents = new AgentsResource(this);
+            this.bkn = new BknResource(this);
+            this.conversations = new ConversationsResource(this);
+            this.dataflows = new DataflowsResource(this);
+            this.datasources = new DataSourcesResource(this);
+            this.dataviews = new DataViewsResource(this);
+            this.vega = new VegaResource(this);
+            this.skills = new SkillsResource(this);
+            return;
+        }
         if (opts.config) {
             // config: true — read exclusively from ~/.kweaver/, ignore env vars
             const platform = getCurrentPlatform();
@@ -114,6 +150,7 @@ export class KWeaverClient {
         this.datasources = new DataSourcesResource(this);
         this.dataviews = new DataViewsResource(this);
         this.vega = new VegaResource(this);
+        this.skills = new SkillsResource(this);
     }
     /**
      * Async factory that auto-refreshes expired or revoked tokens.
@@ -136,15 +173,22 @@ export class KWeaverClient {
             accessToken: token.accessToken,
             ...opts,
         });
-        // Quick probe — if the token was revoked server-side, force refresh
-        try {
-            const probe = await fetch(`${token.baseUrl.replace(/\/+$/, "")}/api/ontology-manager/v1/knowledge-networks?limit=1`, { headers: { authorization: `Bearer ${token.accessToken}`, token: token.accessToken } });
-            if (probe.status === 401) {
-                throw new Error("Access token revoked. Run `kweaver auth login` to re-authenticate.");
+        if (!isNoAuth(token.accessToken)) {
+            // Quick probe — if the token was revoked server-side, force refresh
+            try {
+                const bd = client.base().businessDomain;
+                const probe = await fetch(`${token.baseUrl.replace(/\/+$/, "")}/api/ontology-manager/v1/knowledge-networks?limit=1`, { headers: buildHeaders(token.accessToken, bd) });
+                if (probe.status === 401) {
+                    throw new Error("Access token revoked. Run `kweaver auth login` to re-authenticate.");
+                }
+            }
+            catch (e) {
+                if (e instanceof Error &&
+                    e.message.startsWith("Access token revoked")) {
+                    throw e;
+                }
+                // Network error — return client as-is, let the caller deal with it
             }
-        }
-        catch {
-            // Network error — return client as-is, let the caller deal with it
         }
         return client;
     }

package/dist/commands/agent.d.ts

@@ -9,7 +9,36 @@ export interface AgentListOptions {
     pretty: boolean;
     verbose: boolean;
 }
+export interface AgentPersonalListOptions {
+    name: string;
+    pagination_marker_str: string;
+    publish_status: string;
+    publish_to_be: string;
+    size: number;
+    businessDomain: string;
+    pretty: boolean;
+    verbose: boolean;
+}
+export interface AgentTemplateListOptions {
+    category_id: string;
+    name: string;
+    pagination_marker_str: string;
+    size: number;
+    businessDomain: string;
+    pretty: boolean;
+    verbose: boolean;
+}
+export interface AgentTemplateGetOptions {
+    templateId: string;
+    businessDomain: string;
+    pretty: boolean;
+    verbose: boolean;
+    saveConfig: string | null;
+}
 export declare function formatSimpleAgentList(text: string, pretty: boolean): string;
+export declare function parseAgentTemplateGetArgs(args: string[]): AgentTemplateGetOptions;
+export declare function parseAgentTemplateListArgs(args: string[]): AgentTemplateListOptions;
+export declare function parseAgentPersonalListArgs(args: string[]): AgentPersonalListOptions;
 export declare function parseAgentListArgs(args: string[]): AgentListOptions;
 export interface AgentSessionsOptions {
     agentId: string;
@@ -19,13 +48,15 @@ export interface AgentSessionsOptions {
 }
 export declare function parseAgentSessionsArgs(args: string[]): AgentSessionsOptions;
 export interface AgentHistoryOptions {
+    agentId: string | undefined;
     conversationId: string;
     businessDomain: string;
-    limit?: number;
     pretty: boolean;
+    limit?: number;
 }
 export declare function parseAgentHistoryArgs(args: string[]): AgentHistoryOptions;
 export interface AgentTraceOptions {
+    agentId: string;
     conversationId: string;
     pretty: boolean;
 }
@@ -36,5 +67,6 @@ export interface AgentGetOptions {
     businessDomain: string;
     pretty: boolean;
     verbose: boolean;
+    saveConfig: string | null;
 }
 export declare function parseAgentGetArgs(args: string[]): AgentGetOptions;