@kweaver-ai/kweaver-sdk 0.7.2 → 0.7.4

package/dist/cli.js

@@ -10,6 +10,7 @@ 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 { runModelCommand } from "./commands/model.js";
 import { runSkillCommand } from "./commands/skill.js";
 import { runTokenCommand } from "./commands/token.js";
 import { runToolboxCommand } from "./commands/toolbox.js";
@@ -62,11 +63,19 @@ Usage:
   kweaver ds connect <db_type> <host> <port> <database> --account X --password Y [--schema S] [--name N]
                      [--reuse-existing|--force-new]
 
+  kweaver dataflow templates [--json]
+  kweaver dataflow create-dataset --template <name> --set "key=value" [--json] [-bd value]
+  kweaver dataflow create-bkn --template <name> --set "key=value" [--json] [-bd value]
+  kweaver dataflow create (--template <name> --set "key=value" | <json>) [-bd value]
   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 model llm   list|get|add|edit|delete|test|chat|--template ...   (mf-model-manager + mf-model-api)
+  kweaver model small list|get|add|edit|delete|test|embeddings|rerank|--template ...
+  kweaver model --help
+
   kweaver dataview list [--datasource-id id] [--type atomic|custom] [--limit n] [-bd value]
   kweaver dataview find --name <name> [--exact] [--datasource-id id] [--wait] [--timeout ms] [-bd value]
   kweaver dataview get <id> [-bd value]
@@ -87,6 +96,7 @@ Usage:
   kweaver bkn push <directory> [--branch main] [-bd value] [--detect-encoding|--no-detect-encoding] [--source-encoding name]
   kweaver bkn pull <kn-id> [directory] [--branch main] [-bd value]
   kweaver bkn object-type list|get|create|update|delete|query|properties <kn-id> ...
+  kweaver bkn metric list|get|create|search|validate|update|delete|query|dry-run <kn-id> ...
   kweaver bkn relation-type list|get|create|update|delete <kn-id> ...
   kweaver bkn subgraph <kn-id> <body-json>
   kweaver bkn action-type list|query|inputs|execute <kn-id> ... [--wait] [--no-wait] [--timeout N]
@@ -116,7 +126,7 @@ Usage:
   kweaver tool enable|disable --toolbox <box-id> <tool-id>... [-bd value]
   kweaver tool execute|debug --toolbox <box-id> <tool-id>
                              [--body '<json>'|--body-file <path>]
-                             [--header '<json>'] [--query '<json>'] [--timeout <s>]
+                             [--header '<json>'] [--query '<json>'] [--path '<json>'] [--timeout <s>]
 
   kweaver vega health|stats|inspect
   kweaver vega catalog list|get|health|test-connection|discover|resources [options]
@@ -139,7 +149,19 @@ Usage:
 Global options:
   --base-url <url>  Override platform base URL for this command (env: KWEAVER_BASE_URL)
   --token <value>   Override access token for this command (env: KWEAVER_TOKEN; disables write-to-disk commands)
-  --user <id|name>  Use a specific user's credentials for this command (env: KWEAVER_USER)
+  --user <id|name>  Use a specific user's credentials for this command, transient (env: KWEAVER_USER)
+
+Multi-shell account isolation:
+  KWEAVER_PROFILE=<name>     Scope state.json (active platform / active user) to a named
+                             profile. Tokens under platforms/ are still shared, so each
+                             profile reuses logins. Required for \`auth switch\` and
+                             \`auth use\` (use --global to override). Name must match
+                             [A-Za-z0-9_-]{1,64}.
+  KWEAVERC_CONFIG_DIR=<dir>  Override the entire config root (~/.kweaver by default).
+                             Use this for hard isolation (separate token store per shell).
+
+For agents / multi-terminal scripts: prefer \`--user <id>\` (transient, no persistence)
+over \`auth switch\` (persistent, requires KWEAVER_PROFILE).
   --pretty / --compact
                     Toggle pretty-printed JSON output. Supported by every
                     command that prints a JSON payload (default: pretty).
@@ -151,6 +173,7 @@ Commands:
   agent          Agent CRUD, chat, sessions, history, publish/unpublish
   ds             Manage datasources (list, get, delete, tables, connect)
   dataflow       Dataflow document workflows (list, run, runs, logs)
+  model          Model factory: LLM/small-model CRUD (manager) and llm chat (OpenAI-compatible API)
   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)
@@ -228,6 +251,9 @@ export async function run(argv) {
     if (command === "dataflow") {
         return runDataflowCommand(rest);
     }
+    if (command === "model") {
+        return runModelCommand(rest);
+    }
     if (command === "dataview" || command === "dv") {
         return runDataviewCommand(rest);
     }

package/dist/client.d.ts

@@ -9,6 +9,7 @@ import { BknResource } from "./resources/bkn.js";
 import { SkillsResource } from "./resources/skills.js";
 import { ToolboxesResource } from "./resources/toolboxes.js";
 import { VegaResource } from "./resources/vega.js";
+import { ModelsResource } from "./resources/models.js";
 /**
  * Shared credentials passed to every resource method.
  * Internal — use KWeaverClient.
@@ -105,6 +106,8 @@ export declare class KWeaverClient implements ClientContext {
     readonly skills: SkillsResource;
     /** Toolbox / tool management plus execute & debug invocation. */
     readonly toolboxes: ToolboxesResource;
+    /** Model factory (mf-model-manager CRUD + mf-model-api chat / embedding / rerank). */
+    readonly models: ModelsResource;
     constructor(opts?: KWeaverClientOptions);
     /**
      * Async factory that auto-refreshes expired or revoked tokens.

package/dist/client.js

@@ -14,6 +14,7 @@ import { BknResource } from "./resources/bkn.js";
 import { SkillsResource } from "./resources/skills.js";
 import { ToolboxesResource } from "./resources/toolboxes.js";
 import { VegaResource } from "./resources/vega.js";
+import { ModelsResource } from "./resources/models.js";
 // ── KWeaverClient ─────────────────────────────────────────────────────────────
 /**
  * Main entry point for the KWeaver TypeScript SDK.
@@ -67,6 +68,8 @@ export class KWeaverClient {
     skills;
     /** Toolbox / tool management plus execute & debug invocation. */
     toolboxes;
+    /** Model factory (mf-model-manager CRUD + mf-model-api chat / embedding / rerank). */
+    models;
     constructor(opts = {}) {
         const envDomain = process.env.KWEAVER_BUSINESS_DOMAIN;
         if (opts.auth === false && opts.config) {
@@ -101,6 +104,7 @@ export class KWeaverClient {
             this.vega = new VegaResource(this);
             this.skills = new SkillsResource(this);
             this.toolboxes = new ToolboxesResource(this);
+            this.models = new ModelsResource(this);
             return;
         }
         if (opts.config) {
@@ -156,6 +160,7 @@ export class KWeaverClient {
         this.vega = new VegaResource(this);
         this.skills = new SkillsResource(this);
         this.toolboxes = new ToolboxesResource(this);
+        this.models = new ModelsResource(this);
     }
     /**
      * Async factory that auto-refreshes expired or revoked tokens.

package/dist/commands/agent.d.ts

@@ -65,8 +65,14 @@ export interface AgentHistoryOptions {
 }
 export declare function parseAgentHistoryArgs(args: string[]): AgentHistoryOptions;
 export interface AgentTraceOptions {
-    agentId: string;
+    /** Optional. Retained as positional arg for backward compatibility; trace-ai keys by conversation_id only. */
+    agentId?: string;
     conversationId: string;
+    view: "tree" | "perf" | "evidence" | "reasoning" | "all";
+    /** When true, emit raw JSON of the TracesByConversationResult instead of a rendered view. */
+    json: boolean;
+    /** Disable per-message truncation in the reasoning view. */
+    full: boolean;
     pretty: boolean;
 }
 export declare function parseAgentTraceArgs(args: string[]): AgentTraceOptions;

package/dist/commands/agent.js

@@ -468,21 +468,43 @@ export function parseAgentHistoryArgs(args) {
     const finalConversationId = optionStartIndex === 2 ? args[1] : args[0];
     return { agentId: finalAgentId, conversationId: finalConversationId, businessDomain, pretty, limit };
 }
+const TRACE_VIEWS = new Set(["tree", "perf", "evidence", "reasoning", "all"]);
 export function parseAgentTraceArgs(args) {
-    const agentId = args[0];
-    if (!agentId || agentId.startsWith("-")) {
-        throw new Error("Missing agent_id");
-    }
-    const conversationId = args[1];
-    if (!conversationId || conversationId.startsWith("-")) {
-        throw new Error("Missing conversation_id");
-    }
+    const positional = [];
+    let view = "tree";
+    let json = false;
+    let full = false;
     let pretty = true;
-    for (let i = 2; i < args.length; i += 1) {
+    for (let i = 0; i < args.length; i += 1) {
         const arg = args[i];
         if (arg === "--help" || arg === "-h") {
             throw new Error("help");
         }
+        if (arg === "--view") {
+            const next = args[i + 1];
+            if (!next || !TRACE_VIEWS.has(next)) {
+                throw new Error(`--view requires one of: tree, perf, evidence, reasoning, all`);
+            }
+            view = next;
+            i += 1;
+            continue;
+        }
+        if (arg.startsWith("--view=")) {
+            const value = arg.slice("--view=".length);
+            if (!TRACE_VIEWS.has(value)) {
+                throw new Error(`--view requires one of: tree, perf, evidence, reasoning, all`);
+            }
+            view = value;
+            continue;
+        }
+        if (arg === "--json") {
+            json = true;
+            continue;
+        }
+        if (arg === "--full") {
+            full = true;
+            continue;
+        }
         if (arg === "--pretty") {
             pretty = true;
             continue;
@@ -491,9 +513,26 @@ export function parseAgentTraceArgs(args) {
             pretty = false;
             continue;
         }
-        throw new Error(`Unsupported agent trace argument: ${arg}`);
+        if (arg.startsWith("-")) {
+            throw new Error(`Unsupported agent trace argument: ${arg}`);
+        }
+        positional.push(arg);
+    }
+    // Backward-compat: legacy form is `trace <agent_id> <conversation_id>`.
+    // New form: `trace <conversation_id>`. We disambiguate by argument count.
+    let agentId;
+    let conversationId;
+    if (positional.length === 0) {
+        throw new Error("Missing conversation_id");
+    }
+    else if (positional.length === 1) {
+        conversationId = positional[0];
     }
-    return { agentId, conversationId, pretty };
+    else {
+        agentId = positional[0];
+        conversationId = positional[1];
+    }
+    return { agentId, conversationId, view, json, full, pretty };
 }
 export async function runAgentCommand(args) {
     const [subcommand, ...rest] = args;
@@ -520,7 +559,8 @@ Subcommands:
   skill <verb> ...                   Manage skills attached to an agent (add/remove/list)
   sessions <agent_id>                List all conversations for an agent
   history <agent_id> <conversation_id> Show message history for a conversation
-  trace <agent_id> <conversation_id>  Get trace data for a conversation`);
+  trace <conversation_id> [--view tree|perf|evidence|reasoning|all] [--json]
+                                       Get trace data for a conversation`);
         return Promise.resolve(0);
     }
     const dispatch = async () => {
@@ -724,13 +764,16 @@ Options:
     }
     if (subcommand === "trace") {
         if (rest.length === 1 && (rest[0] === "--help" || rest[0] === "-h")) {
-            console.log(`kweaver agent trace <agent_id> <conversation_id> [options]
+            console.log(`kweaver agent trace <conversation_id> [options]
+       kweaver agent trace <agent_id> <conversation_id> [options]   (legacy)
 
 Get trace data for a conversation.
 
 Options:
-  --pretty                  Pretty-print JSON output (default)
-  --compact                 Compact JSON output`);
+  --view tree|perf|evidence|reasoning|all   Render style (default: tree)
+  --json                          Emit raw TracesByConversationResult JSON
+  --pretty                        Pretty-print JSON output (default)
+  --compact                       Compact JSON output`);
             return 0;
         }
     }
@@ -1031,13 +1074,18 @@ async function runAgentTraceCommand(args) {
     }
     catch (error) {
         if (error instanceof Error && error.message === "help") {
-            console.log(`kweaver agent trace <agent_id> <conversation_id> [options]
+            console.log(`kweaver agent trace <conversation_id> [options]
+       kweaver agent trace <agent_id> <conversation_id> [options]   (legacy)
 
-Get trace data for a conversation.
+Get trace data for a conversation. Spans are fetched from trace-ai via a 2-jump
+lookup that recovers pipeline spans (HTTP entry, internal RPCs, prompt-build)
+which the simpler /by-conversation endpoint omits.
 
 Options:
-  --pretty                  Pretty-print JSON output (default)
-  --compact                 Compact JSON output`);
+  --view tree|perf|evidence|reasoning|all   Render style (default: tree)
+  --json                          Emit raw TracesByConversationResult JSON
+  --pretty                        Pretty-print JSON output (default)
+  --compact                       Compact JSON output`);
             return 0;
         }
         console.error(formatHttpError(error));
@@ -1045,13 +1093,19 @@ Options:
     }
     try {
         const token = await ensureValidToken();
-        const body = await getTracesByConversation({
+        const result = await getTracesByConversation({
             baseUrl: token.baseUrl,
             accessToken: token.accessToken,
             agentId: options.agentId,
             conversationId: options.conversationId,
         });
-        console.log(formatCallOutput(body, options.pretty));
+        if (options.json) {
+            console.log(formatCallOutput(JSON.stringify(result), options.pretty));
+        }
+        else {
+            const { formatTraceResult } = await import("../utils/trace-views.js");
+            console.log(formatTraceResult(result, options.view, { full: options.full }));
+        }
         return 0;
     }
     catch (error) {

package/dist/commands/auth.js

@@ -1,9 +1,31 @@
 import { isNoAuth } from "../config/no-auth.js";
 import { assertNotStatelessForWrite } from "../config/stateless.js";
-import { autoSelectBusinessDomain, clearPlatformSession, deletePlatform, deleteUser, getActiveUser, getConfigDir, getCurrentPlatform, getPlatformAlias, hasPlatform, listPlatforms, listUserProfiles, loadClientConfig, loadTokenConfig, loadUserTokenConfig, resolveBusinessDomain, resolvePlatformIdentifier, resolveUserId, saveNoAuthPlatform, setActiveUser, setCurrentPlatform, setPlatformAlias, } from "../config/store.js";
+import { autoSelectBusinessDomain, clearPlatformSession, deletePlatform, deleteUser, getActiveUser, getConfigDir, getCurrentPlatform, getPlatformAlias, getProfileName, hasPlatform, listPlatforms, listUserProfiles, loadClientConfig, loadTokenConfig, loadUserTokenConfig, resolveBusinessDomain, resolvePlatformIdentifier, resolveUserId, saveNoAuthPlatform, setActiveUser, setCurrentPlatform, setPlatformAlias, } from "../config/store.js";
 import { decodeJwtPayload } from "../config/jwt.js";
 import { eacpModifyPassword } from "../auth/eacp-modify-password.js";
 import { buildCopyCommand, fetchEacpUserInfo, formatHttpError, InitialPasswordChangeRequiredError, normalizeBaseUrl, oauth2Login, oauth2PasswordSigninLogin, promptForUsername, promptForPassword, refreshTokenLogin, resolveActivePlatform, } from "../auth/oauth.js";
+function consumeGlobalFlag(args) {
+    const idx = args.indexOf("--global");
+    if (idx === -1)
+        return { args, isGlobal: false };
+    return { args: [...args.slice(0, idx), ...args.slice(idx + 1)], isGlobal: true };
+}
+function requireProfileOrGlobal(command, isGlobal) {
+    if (isGlobal)
+        return null;
+    try {
+        if (getProfileName())
+            return null;
+    }
+    catch (err) {
+        return err instanceof Error ? err.message : String(err);
+    }
+    return (`kweaver auth ${command} mutates the active account globally and would affect every shell using ~/.kweaver.\n` +
+        `Pick one:\n` +
+        `  - Transient: prepend \`--user <id|name>\` (or \`KWEAVER_USER=<id>\`) to the command you actually want to run; no persistent switch.\n` +
+        `  - Persistent (this shell only): \`export KWEAVER_PROFILE=<name>\`, then re-run.\n` +
+        `  - Intentionally global (CI / single-user setup): re-run with \`--global\`.`);
+}
 export async function runAuthCommand(args) {
     const target = args[0];
     const rest = args.slice(1);
@@ -357,10 +379,16 @@ Login options:
         return 0;
     }
     if (target === "use") {
-        const resolvedTarget = args[1] ? resolvePlatformIdentifier(args[1]) : "";
+        const { args: useArgs, isGlobal } = consumeGlobalFlag(args);
+        const refusal = requireProfileOrGlobal("use", isGlobal);
+        if (refusal !== null) {
+            console.error(refusal);
+            return 1;
+        }
+        const resolvedTarget = useArgs[1] ? resolvePlatformIdentifier(useArgs[1]) : "";
         const useTarget = resolvedTarget && /^https?:\/\//.test(resolvedTarget) ? normalizeBaseUrl(resolvedTarget) : resolvedTarget;
         if (!useTarget) {
-            console.error("Usage: kweaver auth use <platform-url|alias>");
+            console.error("Usage: kweaver auth use [--global] <platform-url|alias>");
             return 1;
         }
         if (!hasPlatform(useTarget)) {
@@ -490,18 +518,25 @@ You can use either userId or username with --user in switch/logout/delete.`);
 }
 function runAuthSwitchCommand(args) {
     if (args[0] === "--help" || args[0] === "-h") {
-        console.log(`kweaver auth switch [platform-url|alias] --user <userId|username>
+        console.log(`kweaver auth switch [--global] [platform-url|alias] --user <userId|username>
 
 Switch the active user for a platform.
 You can specify either the userId (sub claim) or the username (preferred_username from id_token).`);
         return 0;
     }
-    const userArg = readOption(args, "--user");
+    const { args: switchArgs, isGlobal } = consumeGlobalFlag(args);
+    const refusal = requireProfileOrGlobal("switch", isGlobal);
+    if (refusal !== null) {
+        console.error(refusal);
+        return 1;
+    }
+    const cleanedArgs = switchArgs;
+    const userArg = readOption(cleanedArgs, "--user") ?? process.env.KWEAVER_USER;
     if (!userArg) {
-        console.error("Usage: kweaver auth switch [platform-url|alias] --user <userId|username>");
+        console.error("Usage: kweaver auth switch [--global] [platform-url|alias] --user <userId|username>");
         return 1;
     }
-    const filteredArgs = args.filter((a) => a !== "--user" && a !== userArg);
+    const filteredArgs = cleanedArgs.filter((a) => a !== "--user" && a !== userArg);
     const platform = resolvePlatformArg(filteredArgs);
     if (!platform) {
         console.error("No active platform. Run `kweaver auth login <platform-url>` first.");

package/dist/commands/bkn-metric.d.ts

@@ -0,0 +1 @@
+export declare function runKnMetricCommand(args: string[]): Promise<number>;