@kweaver-ai/kweaver-sdk 0.6.9 → 0.7.1

package/README.md

@@ -143,15 +143,20 @@ const rows = await client.vega.sqlQuery(
   JSON.stringify({ query: "SELECT * FROM {{res-1}} LIMIT 5", resource_type: "mysql" }),
 );
 
-// Context Loader (semantic search over a BKN via MCP)
+// Context Loader (MCP search_schema plus generic tools/call)
 const cl      = client.contextLoader(mcpUrl, "bkn-id");
-const results = await cl.search({ query: "hypertension treatment" });
+const schema  = await cl.searchSchema({ query: "hypertension treatment" });
+const rawTool = await cl.callTool("search_schema", { query: "hypertension treatment" });
 
 // Skills (registry + market + progressive read)
 const skills = await client.skills.market({ name: "kweaver" });
 const skillMd = await client.skills.fetchContent("skill-id");
 ```
 
+`searchSchema()` is the typed wrapper for the Context Loader MCP `search_schema` tool. It defaults `response_format` to `json` and accepts `query`, `response_format`, `search_scope`, `max_concepts`, `schema_brief`, and `enable_rerank`. The parsed response may contain `object_types`, `relation_types`, `action_types`, and `metric_types`.
+
+Use `callTool(name, args)` when you need native MCP `tools/call` access for newly added server tools before the SDK adds a typed wrapper. Arguments are passed through unchanged.
+
 ## CLI Reference
 
 ```
@@ -184,7 +189,7 @@ kweaver agent list/get/create/update/delete/chat/sessions/history/publish/unpubl
 kweaver skill list/market/get/register/status/delete/content/read-file/download/install
 kweaver vega health/stats/inspect/sql/catalog/resource/connector-type
 kweaver context-loader config set/use/list/show
-kweaver context-loader kn-search/query-object-instance/...
+kweaver context-loader search-schema/tool-call/kn-search/query-object-instance/find-skills/...
 kweaver toolbox create/list/publish/unpublish/delete
 kweaver tool upload/list/enable/disable
 kweaver call <path> [-X METHOD] [-d BODY] [-H header] [-F key=value]

package/README.zh.md

@@ -136,15 +136,20 @@ const rows = await client.vega.sqlQuery(
   JSON.stringify({ query: "SELECT * FROM {{res-1}} LIMIT 5", resource_type: "mysql" }),
 );
 
-// Context Loader（通过 MCP 对 BKN 做语义搜索）
+// Context Loader（MCP search_schema + 通用 tools/call）
 const cl      = client.contextLoader(mcpUrl, "bkn-id");
-const results = await cl.search({ query: "高血压 治疗" });
+const schema  = await cl.searchSchema({ query: "高血压 治疗" });
+const rawTool = await cl.callTool("search_schema", { query: "高血压 治疗" });
 
 // Skill（注册表/市场/渐进式读取）
 const skills = await client.skills.market({ name: "kweaver" });
 const skillMd = await client.skills.fetchContent("skill-id");
 ```
 
+`searchSchema()` 是 Context Loader MCP `search_schema` 的类型化封装，默认 `response_format` 为 `json`，支持 `query`、`response_format`、`search_scope`、`max_concepts`、`schema_brief`、`enable_rerank`。解析后的返回结果可能包含 `object_types`、`relation_types`、`action_types`、`metric_types`。
+
+需要直接使用 MCP 原生 `tools/call` 时，使用 `callTool(name, args)`。这适用于服务端新增工具但 SDK 尚未提供类型化封装的场景，参数会原样透传。
+
 ## 命令速查
 
 ```
@@ -172,7 +177,7 @@ kweaver agent list/get/chat/sessions/history
 kweaver skill list/market/get/register/status/delete/content/read-file/download/install
 kweaver vega health|stats|inspect|sql|catalog|resource|connector-type
 kweaver context-loader config set/use/list/show
-kweaver context-loader kn-search/query-object-instance/...
+kweaver context-loader search-schema/tool-call/kn-search/query-object-instance/find-skills/...
 kweaver call <path> [-X METHOD] [-d BODY] [-H header]
 ```
 

package/dist/api/agent-list.js

@@ -12,11 +12,24 @@ export async function listAgents(options) {
         custom_space_id,
         is_to_square,
     });
-    const response = await fetchWithRetry(url, {
+    // Some deployments (observed on dip-poc.aishu.cn) return an empty entries
+    // array when this endpoint is called with `application/json`; the same
+    // payload sent as `text/plain` works. Other deployments only accept
+    // `application/json` (and reject text/plain with 4xx). Try text/plain first
+    // and fall back to application/json on 4xx so both platform variants work
+    // out of the box.
+    const tryPost = async (contentType) => fetchWithRetry(url, {
         method: "POST",
-        headers: buildHeaders(accessToken, businessDomain),
+        headers: {
+            ...buildHeaders(accessToken, businessDomain),
+            "content-type": contentType,
+        },
         body,
     });
+    let response = await tryPost("text/plain;charset=UTF-8");
+    if (!response.ok && response.status >= 400 && response.status < 500) {
+        response = await tryPost("application/json");
+    }
     const responseBody = await response.text();
     if (!response.ok) {
         throw new HttpError(response.status, response.statusText, responseBody);

package/dist/api/context-loader.d.ts

@@ -4,15 +4,28 @@ export interface ContextLoaderCallOptions {
     knId: string;
     accessToken: string;
 }
-/** Layer 1: kn_search arguments. */
-export interface KnSearchArgs {
-    query: string;
-    only_schema?: boolean;
+export interface SearchSchemaScope {
+    include_object_types?: boolean;
+    include_relation_types?: boolean;
+    include_action_types?: boolean;
+    include_metric_types?: boolean;
 }
-/** Layer 1: kn_schema_search arguments. */
-export interface KnSchemaSearchArgs {
+/** Layer 1: search_schema arguments. */
+export interface SearchSchemaArgs {
     query: string;
+    response_format?: "json" | "toon";
+    search_scope?: SearchSchemaScope;
     max_concepts?: number;
+    schema_brief?: boolean;
+    enable_rerank?: boolean;
+}
+/** Layer 1: search_schema result. */
+export interface SearchSchemaResult {
+    object_types?: unknown[];
+    relation_types?: unknown[];
+    action_types?: unknown[];
+    metric_types?: unknown[];
+    raw?: string;
 }
 /** Condition for query_object_instance and query_instance_subgraph. */
 export interface ConditionSpec {
@@ -60,6 +73,24 @@ export interface GetActionInfoArgs {
     at_id: string;
     _instance_identity: Record<string, string>;
 }
+/** Layer 3: find_skills arguments (object_type_id is required). */
+export interface FindSkillsArgs {
+    object_type_id: string;
+    response_format?: "json" | "toon";
+    instance_identities?: Record<string, unknown>[];
+    skill_query?: string;
+    /** 1..20, default 10 on the server side. */
+    top_k?: number;
+}
+/** Layer 3: find_skills result. */
+export interface FindSkillsResult {
+    entries: Array<{
+        skill_id: string;
+        name: string;
+        description?: string;
+    }>;
+    message?: string;
+}
 /** Error when get_logic_properties_values returns MISSING_INPUT_PARAMS. */
 export interface MissingInputParamsError {
     error_code: "MISSING_INPUT_PARAMS";
@@ -81,10 +112,9 @@ export declare function validateCondition(condition: unknown): void;
 export declare function validateInstanceIdentity(v: unknown, label: string): void;
 /** Guardrail: _instance_identities must be array of plain objects from Layer 2. */
 export declare function validateInstanceIdentities(v: unknown): void;
-/** Layer 1: kn_search. Returns object_types, relation_types, action_types. */
-export declare function knSearch(options: ContextLoaderCallOptions, args: KnSearchArgs): Promise<unknown>;
-/** Layer 1: kn_schema_search. Returns concepts (candidate discovery only). */
-export declare function knSchemaSearch(options: ContextLoaderCallOptions, args: KnSchemaSearchArgs): Promise<unknown>;
+export declare function callTool(options: ContextLoaderCallOptions, toolName: string, args: Record<string, unknown>): Promise<unknown>;
+/** Layer 1: search_schema. Returns object_types, relation_types, action_types, metric_types. */
+export declare function searchSchema(options: ContextLoaderCallOptions, args: SearchSchemaArgs): Promise<SearchSchemaResult>;
 /** Layer 2: query_object_instance. Returns datas with _instance_identity. */
 export declare function queryObjectInstance(options: ContextLoaderCallOptions, args: QueryObjectInstanceArgs): Promise<unknown>;
 /** Layer 2: query_instance_subgraph. Returns entries with nested _instance_identity. */
@@ -93,6 +123,11 @@ export declare function queryInstanceSubgraph(options: ContextLoaderCallOptions,
 export declare function getLogicPropertiesValues(options: ContextLoaderCallOptions, args: GetLogicPropertiesValuesArgs): Promise<unknown>;
 /** Layer 3: get_action_info. Returns _dynamic_tools. */
 export declare function getActionInfo(options: ContextLoaderCallOptions, args: GetActionInfoArgs): Promise<unknown>;
+/**
+ * Layer 3: find_skills. Recall skills attached to an object type or
+ * (optionally) narrowed to specific instances.
+ */
+export declare function findSkills(options: ContextLoaderCallOptions, args: FindSkillsArgs): Promise<FindSkillsResult>;
 /** MCP tools/list. Returns list of available tools. */
 export declare function listTools(options: ContextLoaderCallOptions, params?: {
     cursor?: string;

package/dist/api/context-loader.js

@@ -149,7 +149,7 @@ async function callMcpMethod(options, method, params = {}) {
     }
     throw new Error("Context-loader returned no result");
 }
-async function callTool(options, toolName, args) {
+export async function callTool(options, toolName, args) {
     const sessionId = await ensureSession(options);
     const id = (requestId += 1);
     const body = JSON.stringify({
@@ -208,13 +208,21 @@ async function callTool(options, toolName, args) {
     }
     throw new Error("Context-loader returned no result");
 }
-/** Layer 1: kn_search. Returns object_types, relation_types, action_types. */
-export async function knSearch(options, args) {
-    return callTool(options, "kn_search", { ...args });
-}
-/** Layer 1: kn_schema_search. Returns concepts (candidate discovery only). */
-export async function knSchemaSearch(options, args) {
-    return callTool(options, "kn_schema_search", { ...args });
+/** Layer 1: search_schema. Returns object_types, relation_types, action_types, metric_types. */
+export async function searchSchema(options, args) {
+    const toolArgs = {
+        query: args.query,
+        response_format: args.response_format ?? "json",
+    };
+    if (args.search_scope !== undefined)
+        toolArgs.search_scope = args.search_scope;
+    if (args.max_concepts !== undefined)
+        toolArgs.max_concepts = args.max_concepts;
+    if (args.schema_brief !== undefined)
+        toolArgs.schema_brief = args.schema_brief;
+    if (args.enable_rerank !== undefined)
+        toolArgs.enable_rerank = args.enable_rerank;
+    return (await callTool(options, "search_schema", toolArgs));
 }
 /** Layer 2: query_object_instance. Returns datas with _instance_identity. */
 export async function queryObjectInstance(options, args) {
@@ -240,6 +248,33 @@ export async function getActionInfo(options, args) {
     validateInstanceIdentity(args._instance_identity, "_instance_identity");
     return callTool(options, "get_action_info", { ...args });
 }
+/**
+ * Layer 3: find_skills. Recall skills attached to an object type or
+ * (optionally) narrowed to specific instances.
+ */
+export async function findSkills(options, args) {
+    if (!args.object_type_id || typeof args.object_type_id !== "string") {
+        throw new Error("find_skills: object_type_id is required.");
+    }
+    if (args.top_k !== undefined && (args.top_k < 1 || args.top_k > 20)) {
+        throw new Error("find_skills: top_k must be between 1 and 20.");
+    }
+    if (args.instance_identities !== undefined) {
+        validateInstanceIdentities(args.instance_identities);
+    }
+    const toolArgs = {
+        object_type_id: args.object_type_id,
+    };
+    if (args.response_format !== undefined)
+        toolArgs.response_format = args.response_format;
+    if (args.instance_identities !== undefined)
+        toolArgs.instance_identities = args.instance_identities;
+    if (args.skill_query !== undefined)
+        toolArgs.skill_query = args.skill_query;
+    if (args.top_k !== undefined)
+        toolArgs.top_k = args.top_k;
+    return (await callTool(options, "find_skills", toolArgs));
+}
 /** MCP tools/list. Returns list of available tools. */
 export async function listTools(options, params) {
     return callMcpMethod(options, "tools/list", params ? { cursor: params.cursor } : {});

package/dist/api/ontology-query.d.ts

@@ -44,11 +44,40 @@ export declare function actionTypeQuery(options: ActionTypeQueryOptions): Promis
 /**
  * Action-type execute: POST (has side effects).
  *
- * The request body must include `_instance_identities` — an array of objects
- * identifying which instances the action operates on:
+ * The request body must use the envelope shape below — top-level scalar fields
+ * (other than `trigger_type` and `_instance_identities`) are silently dropped
+ * by the backend, which causes downstream tools to receive `null` parameters
+ * (and typically respond with 401 token expired or 500 type errors).
+ *
  * ```json
- * {"_instance_identities": [{"<primary_key>": "<value>"}], ...otherParams}
+ * {
+ *   "trigger_type": "manual",
+ *   "_instance_identities": [{"<primary_key>": "<value>"}],
+ *   "dynamic_params": {
+ *     "<param_name>": "<value>",
+ *     "Authorization": "Bearer <token>"
+ *   }
+ * }
  * ```
+ *
+ * - `_instance_identities` may be `[]` for "create"-style actions.
+ * - Each ActionType parameter has a `value_from` discriminator:
+ *     • `input`    — caller MUST supply via `dynamic_params`. Includes
+ *                    `source: header` params (e.g. `Authorization`/`token`),
+ *                    which are usually credentials for the DOWNSTREAM system
+ *                    the action calls — NOT the platform session token. The
+ *                    SDK never auto-forwards its session token.
+ *     • `const`    — frozen in the ActionType snapshot; values in body are
+ *                    silently ignored. Edit the ActionType definition to
+ *                    `input` first if you need caller override.
+ *     • `property` — auto-populated from the resolved instance's property;
+ *                    do not (and cannot) supply via body.
+ *
+ * Practical recipe: query the ActionType, filter parameters where
+ * `value_from == "input"`, put exactly those names into `dynamic_params`.
+ *
+ * See `skills/kweaver-core/references/bkn.md` ("action-type execute 请求体契约")
+ * for the full contract and troubleshooting table.
  */
 export interface ActionTypeExecuteOptions extends OntologyQueryBaseOptions {
     atId: string;

package/dist/api/semantic-search.d.ts

@@ -10,3 +10,12 @@ export interface SemanticSearchOptions {
     returnQueryUnderstanding?: boolean;
 }
 export declare function semanticSearch(options: SemanticSearchOptions): Promise<string>;
+export interface KnSearchHttpOptions {
+    baseUrl: string;
+    accessToken: string;
+    knId: string;
+    query: string;
+    businessDomain?: string;
+    onlySchema?: boolean;
+}
+export declare function knSearchHttp(options: KnSearchHttpOptions): Promise<string>;

package/dist/api/semantic-search.js

@@ -22,3 +22,22 @@ export async function semanticSearch(options) {
     }
     return body;
 }
+export async function knSearchHttp(options) {
+    const { baseUrl, accessToken, knId, query, businessDomain = "bd_public", onlySchema = false, } = options;
+    const base = baseUrl.replace(/\/+$/, "");
+    const url = `${base}/api/agent-retrieval/v1/kn/kn_search`;
+    const response = await fetch(url, {
+        method: "POST",
+        headers: { ...buildHeaders(accessToken, businessDomain), "content-type": "application/json" },
+        body: JSON.stringify({
+            kn_id: knId,
+            query,
+            only_schema: onlySchema,
+        }),
+    });
+    const body = await response.text();
+    if (!response.ok) {
+        throw new HttpError(response.status, response.statusText, body);
+    }
+    return body;
+}

package/dist/api/toolboxes.d.ts

@@ -44,4 +44,32 @@ export interface ListToolsOptions extends BaseOpts {
     boxId: string;
 }
 export declare function listTools(opts: ListToolsOptions): Promise<string>;
+export type ImpexType = "toolbox" | "mcp" | "operator";
+export interface ExportConfigOptions extends BaseOpts {
+    id: string;
+    type?: ImpexType;
+}
+export declare function exportConfig(opts: ExportConfigOptions): Promise<Uint8Array>;
+export interface ImportConfigOptions extends BaseOpts {
+    /** Path to a previously exported `.adp` JSON file. */
+    filePath: string;
+    type?: ImpexType;
+}
+export declare function importConfig(opts: ImportConfigOptions): Promise<string>;
+export interface InvokeToolOptions extends BaseOpts {
+    boxId: string;
+    toolId: string;
+    /** Optional headers to forward to the downstream tool (e.g. Authorization). */
+    header?: Record<string, unknown>;
+    /** Optional query params to forward. */
+    query?: Record<string, unknown>;
+    /** JSON body forwarded to the downstream tool. */
+    body?: unknown;
+    /** Per-call timeout in seconds; backend default applies when omitted. */
+    timeout?: number;
+}
+/** Execute a published+enabled tool through the toolbox proxy. */
+export declare function executeTool(opts: InvokeToolOptions): Promise<string>;
+/** Debug a tool through the toolbox proxy (works on draft/disabled tools too). */
+export declare function debugTool(opts: InvokeToolOptions): Promise<string>;
 export {};

package/dist/api/toolboxes.js

@@ -1,19 +1,28 @@
 import { readFile } from "node:fs/promises";
 import { basename } from "node:path";
-import { fetchTextOrThrow } from "../utils/http.js";
+import { HttpError, fetchTextOrThrow, fetchWithRetry } from "../utils/http.js";
 import { buildHeaders } from "./headers.js";
 // Backend endpoints under /api/agent-operator-integration/v1/tool-box.
 //
 // Verified against kweaver/examples/03-action-lifecycle/run.sh (lines 78–197):
-//   POST   /tool-box                   create
-//   DELETE /tool-box/{id}              delete
-//   POST   /tool-box/{id}/status       publish/draft
-//   POST   /tool-box/{id}/tool         upload tool (multipart)
-//   POST   /tool-box/{id}/tools/status enable/disable (batch)
+//   POST   /tool-box                       create
+//   DELETE /tool-box/{id}                  delete
+//   POST   /tool-box/{id}/status           publish/draft
+//   POST   /tool-box/{id}/tool             upload tool (multipart)
+//   POST   /tool-box/{id}/tools/status     enable/disable (batch)
 //
 // Verified during Task 8 e2e against the live backend (2026-04-18):
 //   GET    /tool-box/list?keyword=&limit=&offset=  list toolboxes
 //   GET    /tool-box/{id}/tools/list               list tools
+//
+// Verified live on 2026-04-23 against dip-poc.aishu.cn:
+//   POST   /tool-box/{box}/proxy/{tool}            execute tool (envelope JSON)
+//   POST   /tool-box/{box}/tool/{tool}/debug       debug tool (envelope JSON)
+//
+// Envelope shape required by /proxy and /debug:
+//   { "timeout": <s>, "header": {...}, "query": {...}, "body": {...} }
+// Flat-shape requests cause the forwarder to drop downstream Authorization
+// headers, which manifests as 401 "token expired" from the underlying tool.
 const PATH = "/api/agent-operator-integration/v1/tool-box";
 function url(base, suffix = "") {
     return `${base.replace(/\/+$/, "")}${PATH}${suffix}`;
@@ -88,3 +97,70 @@ export async function listTools(opts) {
     });
     return body;
 }
+// ── impex (export / import) ──────────────────────────────────────────────────
+//
+// Backend mounts the impex endpoints on the same service but under a different
+// path:
+//
+//   GET  /api/agent-operator-integration/v1/impex/export/{type}/{id}
+//   POST /api/agent-operator-integration/v1/impex/import/{type}   (multipart, field "data")
+//
+// Supported {type} values today: "toolbox" | "mcp" | "operator".
+//
+// Export response is the raw JSON config (Content-Type: application/json) plus
+// a `Content-Disposition: attachment; filename=<type>_export_<ts>.adp` header.
+const IMPEX_PATH = "/api/agent-operator-integration/v1/impex";
+export async function exportConfig(opts) {
+    const t = opts.type ?? "toolbox";
+    const target = `${opts.baseUrl.replace(/\/+$/, "")}${IMPEX_PATH}/export/${encodeURIComponent(t)}/${encodeURIComponent(opts.id)}`;
+    // Use raw bytes (not text) so we never lose precision on non-ASCII payloads
+    // and stay symmetric with the Python SDK's `export_config -> bytes`.
+    const response = await fetchWithRetry(target, {
+        method: "GET",
+        headers: buildHeaders(opts.accessToken, opts.businessDomain ?? "bd_public"),
+    });
+    const buf = new Uint8Array(await response.arrayBuffer());
+    if (!response.ok) {
+        const text = new TextDecoder("utf-8").decode(buf);
+        throw new HttpError(response.status, response.statusText, text);
+    }
+    return buf;
+}
+export async function importConfig(opts) {
+    const buf = await readFile(opts.filePath);
+    const t = opts.type ?? "toolbox";
+    const form = new FormData();
+    form.append("data", new Blob([buf]), basename(opts.filePath));
+    const target = `${opts.baseUrl.replace(/\/+$/, "")}${IMPEX_PATH}/import/${encodeURIComponent(t)}`;
+    const { body } = await fetchTextOrThrow(target, {
+        method: "POST",
+        headers: buildHeaders(opts.accessToken, opts.businessDomain ?? "bd_public"),
+        body: form,
+    });
+    return body;
+}
+function buildEnvelope(opts) {
+    const envelope = {};
+    if (opts.timeout !== undefined)
+        envelope.timeout = opts.timeout;
+    envelope.header = opts.header ?? {};
+    envelope.query = opts.query ?? {};
+    envelope.body = opts.body ?? {};
+    return JSON.stringify(envelope);
+}
+async function invokeTool(opts, suffix) {
+    const { body } = await fetchTextOrThrow(url(opts.baseUrl, suffix), {
+        method: "POST",
+        headers: { ...buildHeaders(opts.accessToken, opts.businessDomain ?? "bd_public"), "content-type": "application/json" },
+        body: buildEnvelope(opts),
+    });
+    return body;
+}
+/** Execute a published+enabled tool through the toolbox proxy. */
+export async function executeTool(opts) {
+    return invokeTool(opts, `/${encodeURIComponent(opts.boxId)}/proxy/${encodeURIComponent(opts.toolId)}`);
+}
+/** Debug a tool through the toolbox proxy (works on draft/disabled tools too). */
+export async function debugTool(opts) {
+    return invokeTool(opts, `/${encodeURIComponent(opts.boxId)}/tool/${encodeURIComponent(opts.toolId)}/debug`);
+}

package/dist/cli.js

@@ -39,26 +39,26 @@ Usage:
   kweaver token
 
   kweaver call <url> [-X METHOD] [-H "Name: value"] [-d BODY] [--data-raw BODY]
-             [--url URL] [--pretty] [--verbose] [-bd value]
+             [--url URL] [--verbose] [-bd value]
   (alias: kweaver curl ...)
 
   kweaver agent chat <agent_id> [-m "message"] [--version value] [--conversation-id id]
                 [--stream] [--no-stream] [--verbose] [-bd value]
-  kweaver agent list [--name X] [--limit N] [--offset N] [-bd value] [--pretty]
-  kweaver agent get <agent_id> [-bd value] [--pretty]
-  kweaver agent get-by-key <key> [-bd value] [--pretty]
-  kweaver agent sessions <agent_id> [-bd value] [--limit N] [--pretty]
-  kweaver agent history <conversation_id> [-bd value] [--limit N] [--pretty]
+  kweaver agent list [--name X] [--limit N] [--offset N] [-bd value]
+  kweaver agent get <agent_id> [-bd value]
+  kweaver agent get-by-key <key> [-bd value]
+  kweaver agent sessions <agent_id> [-bd value] [--limit N]
+  kweaver agent history <conversation_id> [-bd value] [--limit N]
   kweaver agent create [options]
   kweaver agent update <agent_id> [options]
   kweaver agent delete <agent_id> [-bd value]
   kweaver agent publish <agent_id> [-bd value]
   kweaver agent unpublish <agent_id> [-bd value]
 
-  kweaver ds list [--keyword X] [--type T] [-bd value] [--pretty]
+  kweaver ds list [--keyword X] [--type T] [-bd value]
   kweaver ds get <id>
   kweaver ds delete <id> [-y]
-  kweaver ds tables <id> [--keyword X] [--pretty]
+  kweaver ds tables <id> [--keyword X]
   kweaver ds connect <db_type> <host> <port> <database> --account X --password Y [--schema S] [--name N]
 
   kweaver dataflow list [-bd value]
@@ -66,15 +66,15 @@ Usage:
   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] [--raw-sql] [-bd value] [--pretty]
+  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]
+  kweaver dataview query <id> [--sql sql] [--limit n] [--offset n] [--need-total] [--raw-sql] [-bd value]
   kweaver dataview delete <id> [-y] [-bd value]
 
   kweaver bkn list [options]
   kweaver bkn get <kn-id> [options]
-  kweaver bkn search <kn-id> <query> [--max-concepts N] [--mode M] [--pretty] [-bd value]
+  kweaver bkn search <kn-id> <query> [--max-concepts N] [--mode M] [-bd value]
   kweaver bkn create [options]
   kweaver bkn create-from-ds [options]
   kweaver bkn update <kn-id> [options]
@@ -88,7 +88,8 @@ Usage:
   kweaver bkn object-type list|get|create|update|delete|query|properties <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|execute <kn-id> ... [--wait] [--no-wait] [--timeout N]
+  kweaver bkn action-type list|query|inputs|execute <kn-id> ... [--wait] [--no-wait] [--timeout N]
+  kweaver bkn action-type execute <kn-id> <at-id> [<envelope-json>|--dynamic-params '<json>' --instance '<json>' --trigger-type <v>]
   kweaver bkn action-execution get <kn-id> <execution-id>
   kweaver bkn action-log list|get|cancel <kn-id> ...
 
@@ -106,10 +107,15 @@ Usage:
   kweaver toolbox list [--keyword X] [--limit N] [--offset N] [-bd value]
   kweaver toolbox publish|unpublish <box-id> [-bd value]
   kweaver toolbox delete <box-id> [-y] [-bd value]
+  kweaver toolbox export <box-id> [-o <file>|-] [--type toolbox|mcp|operator]
+  kweaver toolbox import <file> [--type toolbox|mcp|operator]
 
   kweaver tool upload --toolbox <box-id> <openapi-spec-path> [--metadata-type openapi]
   kweaver tool list --toolbox <box-id> [-bd value]
   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>]
 
   kweaver vega health|stats|inspect
   kweaver vega catalog list|get|health|test-connection|discover|resources [options]
@@ -121,13 +127,18 @@ Usage:
   kweaver context-loader tools|resources|templates|prompts [--cursor]
   kweaver context-loader resource <uri>
   kweaver context-loader prompt <name> [--args json]
-  kweaver context-loader kn-search <query> [--only-schema]
-  kweaver context-loader kn-schema-search <query> [--max N]
-  kweaver context-loader query-object-instance|query-instance-subgraph|get-logic-properties|get-action-info ...
+  kweaver context-loader search-schema <query> [--scope object,relation,action,metric] [--max N]
+  kweaver context-loader tool-call <name> --args '<json>'
+  kweaver context-loader kn-search <query> [--only-schema]      (compat HTTP)
+  kweaver context-loader kn-schema-search <query> [--max N]     (compat HTTP)
+  kweaver context-loader query-object-instance|query-instance-subgraph|get-logic-properties|get-action-info|find-skills ...
   (alias: kweaver context ...)
 
 Global options:
   --user <id|name>  Use a specific user's credentials for this command (env: KWEAVER_USER)
+  --pretty / --compact
+                    Toggle pretty-printed JSON output. Supported by every
+                    command that prints a JSON payload (default: pretty).
 
 Commands:
   auth           Login, list, inspect, and switch saved platform auth profiles
@@ -141,10 +152,10 @@ Commands:
                  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)
-  toolbox        Agent toolbox lifecycle (create, list, publish, delete)
+  toolbox        Agent toolbox lifecycle (create, list, publish, delete, export, import)
   tool           Tools inside a toolbox (upload OpenAPI spec, list, enable/disable)
   vega           Vega observability (catalog, resource, query/sql, connector-type, health/stats/inspect)
-  context-loader Context-loader MCP (config, tools, resources, prompts, kn-search, query-*, etc.)
+  context-loader Context-loader MCP/HTTP (config, tools, resources, search-schema, tool-call, query-*, etc.)
   help           Show this message`);
 }
 export async function run(argv) {

package/dist/client.d.ts

@@ -7,6 +7,7 @@ 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 { ToolboxesResource } from "./resources/toolboxes.js";
 import { VegaResource } from "./resources/vega.js";
 /**
  * Shared credentials passed to every resource method.
@@ -102,6 +103,8 @@ export declare class KWeaverClient implements ClientContext {
     readonly vega: VegaResource;
     /** ADP/KWeaver skill registry, market, progressive read, and install helpers. */
     readonly skills: SkillsResource;
+    /** Toolbox / tool management plus execute & debug invocation. */
+    readonly toolboxes: ToolboxesResource;
     constructor(opts?: KWeaverClientOptions);
     /**
      * Async factory that auto-refreshes expired or revoked tokens.

package/dist/client.js

@@ -12,6 +12,7 @@ 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 { ToolboxesResource } from "./resources/toolboxes.js";
 import { VegaResource } from "./resources/vega.js";
 // ── KWeaverClient ─────────────────────────────────────────────────────────────
 /**
@@ -64,6 +65,8 @@ export class KWeaverClient {
     vega;
     /** ADP/KWeaver skill registry, market, progressive read, and install helpers. */
     skills;
+    /** Toolbox / tool management plus execute & debug invocation. */
+    toolboxes;
     constructor(opts = {}) {
         const envDomain = process.env.KWEAVER_BUSINESS_DOMAIN;
         if (opts.auth === false && opts.config) {
@@ -97,6 +100,7 @@ export class KWeaverClient {
             this.dataviews = new DataViewsResource(this);
             this.vega = new VegaResource(this);
             this.skills = new SkillsResource(this);
+            this.toolboxes = new ToolboxesResource(this);
             return;
         }
         if (opts.config) {
@@ -151,6 +155,7 @@ export class KWeaverClient {
         this.dataviews = new DataViewsResource(this);
         this.vega = new VegaResource(this);
         this.skills = new SkillsResource(this);
+        this.toolboxes = new ToolboxesResource(this);
     }
     /**
      * Async factory that auto-refreshes expired or revoked tokens.