@kweaver-ai/kweaver-sdk 0.6.2 → 0.6.3

package/dist/api/skills.d.ts

@@ -1,7 +1,7 @@
 export type SkillStatus = "unpublish" | "published" | "offline";
 export type SkillFileType = "zip" | "content";
 export interface SkillSummary {
-    skill_id: string;
+    id: string;
     name: string;
     description?: string;
     version?: string;
@@ -26,20 +26,20 @@ export interface SkillFileSummary {
     mime_type?: string;
 }
 export interface SkillContentIndex {
-    skill_id: string;
+    id: string;
     url: string;
     files: SkillFileSummary[];
     status?: SkillStatus;
 }
 export interface SkillFileReadResult {
-    skill_id: string;
+    id: string;
     rel_path: string;
     url: string;
     mime_type?: string;
     file_type?: string;
 }
 export interface RegisterSkillResult {
-    skill_id: string;
+    id: string;
     name: string;
     description?: string;
     version?: string;
@@ -47,11 +47,11 @@ export interface RegisterSkillResult {
     files?: string[];
 }
 export interface DeleteSkillResult {
-    skill_id: string;
+    id: string;
     deleted: boolean;
 }
 export interface UpdateSkillStatusResult {
-    skill_id: string;
+    id: string;
     status: SkillStatus;
 }
 export interface SkillListResult {

package/dist/api/skills.js

@@ -18,6 +18,20 @@ function unwrapEnvelope(raw) {
     }
     return parsed;
 }
+/** Rename `skill_id` → `id` for consistent output with other modules. */
+function normalizeSkillId(obj) {
+    if (!obj || typeof obj !== "object")
+        return obj;
+    if (Array.isArray(obj))
+        return obj.map(normalizeSkillId);
+    const record = obj;
+    const out = {};
+    for (const [key, value] of Object.entries(record)) {
+        const newKey = key === "skill_id" ? "id" : key;
+        out[newKey] = typeof value === "object" ? normalizeSkillId(value) : value;
+    }
+    return out;
+}
 function appendCommonListParams(url, opts) {
     if (opts.page !== undefined)
         url.searchParams.set("page", String(opts.page));
@@ -60,23 +74,23 @@ export async function listSkills(options) {
     if (options.createUser)
         url.searchParams.set("create_user", options.createUser);
     const { body } = await fetchTextOrThrow(url, { headers: baseHeaders(options) });
-    return unwrapEnvelope(body);
+    return normalizeSkillId(unwrapEnvelope(body));
 }
 export async function listSkillMarket(options) {
     const url = new URL(buildUrl(options.baseUrl, `${SKILL_API_PREFIX}/skills/market`));
     appendCommonListParams(url, options);
     const { body } = await fetchTextOrThrow(url, { headers: baseHeaders(options) });
-    return unwrapEnvelope(body);
+    return normalizeSkillId(unwrapEnvelope(body));
 }
 export async function getSkill(options) {
     const url = buildUrl(options.baseUrl, `${SKILL_API_PREFIX}/skills/${encodeURIComponent(options.skillId)}`);
     const { body } = await fetchTextOrThrow(url, { headers: baseHeaders(options) });
-    return unwrapEnvelope(body);
+    return normalizeSkillId(unwrapEnvelope(body));
 }
 export async function deleteSkill(options) {
     const url = buildUrl(options.baseUrl, `${SKILL_API_PREFIX}/skills/${encodeURIComponent(options.skillId)}`);
     const { body } = await fetchTextOrThrow(url, { method: "DELETE", headers: baseHeaders(options) });
-    return unwrapEnvelope(body);
+    return normalizeSkillId(unwrapEnvelope(body));
 }
 export async function updateSkillStatus(options) {
     const url = buildUrl(options.baseUrl, `${SKILL_API_PREFIX}/skills/${encodeURIComponent(options.skillId)}/status`);
@@ -85,7 +99,7 @@ export async function updateSkillStatus(options) {
         headers: { ...baseHeaders(options), "content-type": "application/json" },
         body: JSON.stringify({ status: options.status }),
     });
-    return unwrapEnvelope(body);
+    return normalizeSkillId(unwrapEnvelope(body));
 }
 export async function registerSkillContent(options) {
     const url = buildUrl(options.baseUrl, `${SKILL_API_PREFIX}/skills`);
@@ -102,7 +116,7 @@ export async function registerSkillContent(options) {
         headers: { ...baseHeaders(options), "content-type": "application/json" },
         body: JSON.stringify(payload),
     });
-    return unwrapEnvelope(body);
+    return normalizeSkillId(unwrapEnvelope(body));
 }
 export async function registerSkillZip(options) {
     const url = buildUrl(options.baseUrl, `${SKILL_API_PREFIX}/skills`);
@@ -118,12 +132,12 @@ export async function registerSkillZip(options) {
         headers: baseHeaders(options),
         body: form,
     });
-    return unwrapEnvelope(body);
+    return normalizeSkillId(unwrapEnvelope(body));
 }
 export async function getSkillContentIndex(options) {
     const url = buildUrl(options.baseUrl, `${SKILL_API_PREFIX}/skills/${encodeURIComponent(options.skillId)}/content`);
     const { body } = await fetchTextOrThrow(url, { headers: baseHeaders(options) });
-    return unwrapEnvelope(body);
+    return normalizeSkillId(unwrapEnvelope(body));
 }
 export async function fetchSkillContent(options) {
     const index = await getSkillContentIndex(options);
@@ -137,7 +151,7 @@ export async function readSkillFile(options) {
         headers: { ...baseHeaders(options), "content-type": "application/json" },
         body: JSON.stringify({ rel_path: options.relPath }),
     });
-    return unwrapEnvelope(body);
+    return normalizeSkillId(unwrapEnvelope(body));
 }
 export async function fetchSkillFile(options) {
     const file = await readSkillFile(options);

package/dist/api/vega.d.ts

@@ -235,4 +235,6 @@ export interface ListAllVegaResourcesOptions {
     offset?: number;
     businessDomain?: string;
 }
+/** List all Vega resources (no catalog filter). Uses GET /resources — not /resources/list, which
+ * conflicts with GET /resources/{id} on some gateways (path segment "list" is treated as an id). */
 export declare function listAllVegaResources(options: ListAllVegaResourcesOptions): Promise<string>;

package/dist/api/vega.js

@@ -476,20 +476,15 @@ export async function vegaSQLQuery(options) {
         throw new HttpError(response.status, response.statusText, body);
     return body;
 }
+/** List all Vega resources (no catalog filter). Uses GET /resources — not /resources/list, which
+ * conflicts with GET /resources/{id} on some gateways (path segment "list" is treated as an id). */
 export async function listAllVegaResources(options) {
     const { baseUrl, accessToken, limit, offset, businessDomain = "bd_public" } = options;
-    const base = baseUrl.replace(/\/+$/, "");
-    const url = new URL(`${base}${VEGA_BASE}/resources/list`);
-    if (limit !== undefined)
-        url.searchParams.set("limit", String(limit));
-    if (offset !== undefined)
-        url.searchParams.set("offset", String(offset));
-    const response = await fetch(url.toString(), {
-        method: "GET",
-        headers: buildHeaders(accessToken, businessDomain),
+    return listVegaResources({
+        baseUrl,
+        accessToken,
+        limit,
+        offset,
+        businessDomain,
     });
-    const body = await response.text();
-    if (!response.ok)
-        throw new HttpError(response.status, response.statusText, body);
-    return body;
 }

package/dist/commands/agent-chat.js

@@ -84,7 +84,7 @@ export function parseChatArgs(args) {
             stream = false;
             continue;
         }
-        if (arg === "--verbose" || arg === "-v") {
+        if (arg === "--verbose" || arg === "-v" || arg === "--debug") {
             verbose = true;
             continue;
         }

package/dist/commands/agent.d.ts

@@ -1,3 +1,12 @@
+/** Build llm_config with valid defaults for fields that mf-model-api validates. */
+export declare function buildLlmConfig(id: string, name: string, maxTokens: number): Record<string, unknown>;
+/** Resolve LLM model name from mf-model-manager API by model ID. Falls back to llmId on failure. */
+export declare function resolveLlmName(options: {
+    baseUrl: string;
+    accessToken: string;
+    llmId: string;
+    businessDomain?: string;
+}): Promise<string>;
 export interface AgentListOptions {
     name: string;
     offset: number;

package/dist/commands/agent.js

@@ -7,6 +7,44 @@ import { formatCallOutput } from "./call.js";
 import { resolveBusinessDomain } from "../config/store.js";
 import { promises as fs } from "fs";
 import { join, dirname, basename, extname } from "path";
+import { buildHeaders } from "../api/headers.js";
+/** Build llm_config with valid defaults for fields that mf-model-api validates. */
+export function buildLlmConfig(id, name, maxTokens) {
+    return {
+        id,
+        name,
+        max_tokens: maxTokens,
+        temperature: 0.7,
+        top_p: 1,
+        top_k: 1,
+    };
+}
+/** Resolve LLM model name from mf-model-manager API by model ID. Falls back to llmId on failure. */
+export async function resolveLlmName(options) {
+    const { baseUrl, accessToken, llmId, businessDomain = "bd_public" } = options;
+    const base = baseUrl.replace(/\/+$/, "");
+    const url = `${base}/api/mf-model-manager/v1/llm/list?page=1&size=50`;
+    try {
+        const response = await fetch(url, {
+            method: "GET",
+            headers: buildHeaders(accessToken, businessDomain),
+        });
+        if (!response.ok)
+            return llmId;
+        const body = (await response.json());
+        const items = (body.data ?? body.entries ?? []);
+        const match = items.find((m) => String(m.model_id ?? m.id) === llmId);
+        if (match) {
+            const name = match.model_name ?? match.name;
+            if (typeof name === "string" && name)
+                return name;
+        }
+        return llmId;
+    }
+    catch {
+        return llmId;
+    }
+}
 /**
  * 生成带时间戳的文件路径
  * @param path 用户提供的路径
@@ -480,7 +518,7 @@ Subcommands:
   chat <agent_id> -m "message"       Send a single message (non-interactive)
   sessions <agent_id>                List all conversations for an agent
   history <agent_id> <conversation_id> Show message history for a conversation
-  trace <conversation_id>            Get trace data for a conversation`);
+  trace <agent_id> <conversation_id>  Get trace data for a conversation`);
         return Promise.resolve(0);
     }
     const dispatch = async () => {
@@ -1144,9 +1182,6 @@ Optional:
             output: { default_format: "markdown" },
             system_prompt: systemPrompt,
         };
-        if (llmId) {
-            config.llms = [{ is_default: true, llm_config: { id: llmId, name: llmId, max_tokens: llmMaxTokens } }];
-        }
     }
     const payload = {
         name,
@@ -1161,6 +1196,11 @@ Optional:
         payload.key = key;
     try {
         const token = await ensureValidToken();
+        // Resolve LLM model name from model-factory before creating agent
+        if (llmId && !configStr) {
+            const llmName = await resolveLlmName({ baseUrl: token.baseUrl, accessToken: token.accessToken, llmId, businessDomain });
+            config.llms = [{ is_default: true, llm_config: buildLlmConfig(llmId, llmName, llmMaxTokens) }];
+        }
         const body = await createAgent({
             baseUrl: token.baseUrl,
             accessToken: token.accessToken,

package/dist/commands/bkn-schema.js

@@ -1185,8 +1185,13 @@ query/execute: Query or execute actions. execute has side effects - only use whe
                 console.error("Usage: kweaver bkn action-type create <kn-id> '<json>'");
                 return 1;
             }
+            // Wrap in {"entries": [...]} if needed (ontology-manager expects this envelope)
+            const entry = JSON.parse(bodyJson);
+            const wrapped = entry && typeof entry === "object" && "entries" in entry
+                ? bodyJson
+                : JSON.stringify({ entries: Array.isArray(entry) ? entry : [entry] });
             const token = await ensureValidToken();
-            const result = await createActionTypes({ baseUrl: token.baseUrl, accessToken: token.accessToken, knId, body: bodyJson, businessDomain: parsed.businessDomain });
+            const result = await createActionTypes({ baseUrl: token.baseUrl, accessToken: token.accessToken, knId, body: wrapped, businessDomain: parsed.businessDomain });
             console.log(formatCallOutput(result, parsed.pretty));
             return 0;
         }

package/dist/commands/dataflow.js

@@ -6,6 +6,7 @@ import yargs from "yargs";
 import { ensureValidToken, formatHttpError, with401RefreshRetry } from "../auth/oauth.js";
 import { resolveBusinessDomain } from "../config/store.js";
 import { getDataflowLogsPage, listDataflowRuns, listDataflows, runDataflowWithFile, runDataflowWithRemoteUrl, } from "../api/dataflow2.js";
+import { createDataflow } from "../api/dataflow.js";
 function renderTable(rows) {
     if (rows.length === 0)
         return "";
@@ -101,16 +102,47 @@ export async function runDataflowCommand(args) {
         .fail((message, error) => {
         throw error ?? new Error(message);
     })
-        .command("list", "List all dataflows", (command) => command.option("biz-domain", {
+        .command("create <json>", "Create a new dataflow (DAG) from a JSON definition", (command) => command
+        .positional("json", {
+        type: "string",
+        describe: "JSON body string or @file-path to read from file",
+    })
+        .option("biz-domain", { alias: "bd", type: "string" }), async (argv) => {
+        exitCode = await with401RefreshRetry(async () => {
+            const base = await requireTokenAndBusinessDomain(argv.bizDomain);
+            let raw = argv.json;
+            if (raw.startsWith("@")) {
+                const filePath = raw.slice(1);
+                await access(filePath, constants.R_OK);
+                raw = (await readFile(filePath, "utf8")).toString();
+            }
+            const body = JSON.parse(raw);
+            const dagId = await createDataflow({ ...base, body });
+            console.log(JSON.stringify({ id: dagId }, null, 2));
+            return 0;
+        });
+    })
+        .command("list", "List all dataflows", (command) => command
+        .option("biz-domain", {
         alias: "bd",
         type: "string",
+    })
+        .option("table", {
+        type: "boolean",
+        default: false,
+        describe: "Output as human-readable table instead of JSON",
     }), async (argv) => {
         exitCode = await with401RefreshRetry(async () => {
             const base = await requireTokenAndBusinessDomain(argv.bizDomain);
             const body = await listDataflows(base);
-            const table = renderTable(buildListTableRows(body.dags));
-            if (table) {
-                console.log(table);
+            if (argv.table) {
+                const table = renderTable(buildListTableRows(body.dags));
+                if (table) {
+                    console.log(table);
+                }
+            }
+            else {
+                console.log(JSON.stringify(body, null, 2));
             }
             return 0;
         });
@@ -160,6 +192,11 @@ export async function runDataflowCommand(args) {
         .command("runs <dagId>", "List run records for one dataflow", (command) => command
         .positional("dagId", { type: "string" })
         .option("since", { type: "string" })
+        .option("table", {
+        type: "boolean",
+        default: false,
+        describe: "Output as human-readable table instead of JSON",
+    })
         .option("biz-domain", { alias: "bd", type: "string" }), async (argv) => {
         exitCode = await with401RefreshRetry(async () => {
             const base = await requireTokenAndBusinessDomain(argv.bizDomain);
@@ -203,9 +240,14 @@ export async function runDataflowCommand(args) {
                     results = results.concat(next.results);
                 }
             }
-            const table = renderTable(buildRunTableRows(results));
-            if (table) {
-                console.log(table);
+            if (argv.table) {
+                const table = renderTable(buildRunTableRows(results));
+                if (table) {
+                    console.log(table);
+                }
+            }
+            else {
+                console.log(JSON.stringify(results, null, 2));
             }
             return 0;
         });

package/dist/commands/skill.js

@@ -23,8 +23,8 @@ function printSkillHelp(subcommand) {
                        [--source src] [--extend-info json] [-bd value] [--pretty|--compact]`);
         return;
     }
-    if (subcommand === "status") {
-        console.log("kweaver skill status <skill-id> <unpublish|published|offline> [-bd value] [--pretty|--compact]");
+    if (subcommand === "set-status" || subcommand === "status") {
+        console.log("kweaver skill set-status <skill-id> <unpublish|published|offline> [-bd value] [--pretty|--compact]");
         return;
     }
     if (subcommand === "delete") {
@@ -54,7 +54,7 @@ Subcommands:
   market [--name kw] [--source src] [--page N] [--page-size N] [-bd value]
   get <skill-id> [-bd value]
   register --content-file <path> | --zip-file <path> [--source src] [--extend-info json]
-  status <skill-id> <unpublish|published|offline> [-bd value]
+  set-status <skill-id> <unpublish|published|offline> [-bd value]
   delete <skill-id> [-y] [-bd value]
   content <skill-id> [--raw] [--output file] [-bd value]
   read-file <skill-id> <rel-path> [--raw] [--output file] [-bd value]
@@ -419,7 +419,7 @@ export async function runSkillCommand(args) {
                     return 0;
                 }
             }
-            if (subcommand === "status") {
+            if (subcommand === "set-status" || subcommand === "status") {
                 const opts = parseStatusArgs(rest);
                 const result = await updateSkillStatus({ ...token, ...opts });
                 console.log(format(result, opts.pretty));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kweaver-ai/kweaver-sdk",
-  "version": "0.6.2",
+  "version": "0.6.3",
   "description": "KWeaver TypeScript SDK — CLI tool and programmatic API for knowledge networks and Decision Agents.",
   "type": "module",
   "main": "./dist/index.js",
@@ -29,7 +29,6 @@
     "lint": "tsc --noEmit -p tsconfig.json",
     "test": "node --import tsx --test test/*.test.ts",
     "test:e2e": "node --import tsx --test test/e2e/*.test.ts",
-    "test:e2e:live": "KWEAVER_BASE_URL=${KWEAVER_BASE_URL:-https://43.129.210.161} KWEAVER_NO_AUTH=1 KWEAVER_TLS_INSECURE=1 node --import tsx --test test/e2e/*.test.ts",
     "prepublishOnly": "npm run build"
   },
   "keywords": [