@kweaver-ai/kweaver-sdk 0.5.1 → 0.5.2

package/README.md

@@ -133,6 +133,10 @@ const health   = await client.vega.health();
 // Context Loader (semantic search over a BKN via MCP)
 const cl      = client.contextLoader(mcpUrl, "bkn-id");
 const results = await cl.search({ query: "hypertension treatment" });
+
+// Skills (registry + market + progressive read)
+const skills = await client.skills.market({ name: "kweaver" });
+const skillMd = await client.skills.fetchContent("skill-id");
 ```
 
 ## CLI Reference
@@ -145,7 +149,7 @@ kweaver auth status/list/use/delete/logout
 kweaver config show / list-bd / set-bd <value>   # platform business domain — after login
 kweaver token
 kweaver ds list/get/delete/tables/connect
-kweaver ds import-csv <ds_id> --files <glob> [--table-prefix <p>] [--batch-size 500]
+kweaver ds import-csv <ds_id> --files <glob> [--table-prefix <p>] [--batch-size 500] [--recreate]
 kweaver dataview list/find/get/query/delete
 kweaver bkn list/get/stats/export/create/update/delete
 kweaver bkn create-from-ds <ds_id> --name <name> [--tables t1,t2] [--build]
@@ -158,6 +162,7 @@ kweaver bkn subgraph / search
 kweaver bkn action-execution get
 kweaver bkn action-log list/get/cancel
 kweaver agent list/get/create/update/delete/chat/sessions/history/publish/unpublish
+kweaver skill list/market/get/register/status/delete/content/read-file/download/install
 kweaver vega health/stats/inspect/catalog/resource/connector-type
 kweaver context-loader config set/use/list/show
 kweaver context-loader kn-search/query-object-instance/...

package/README.zh.md

@@ -122,6 +122,10 @@ const queryRows = await client.dataviews.query(viewId, {
 // Context Loader（通过 MCP 对 BKN 做语义搜索）
 const cl      = client.contextLoader(mcpUrl, "bkn-id");
 const results = await cl.search({ query: "高血压 治疗" });
+
+// Skill（注册表/市场/渐进式读取）
+const skills = await client.skills.market({ name: "kweaver" });
+const skillMd = await client.skills.fetchContent("skill-id");
 ```
 
 ## 命令速查
@@ -143,6 +147,7 @@ kweaver bkn subgraph
 kweaver bkn action-execution get
 kweaver bkn action-log list/get/cancel
 kweaver agent list/get/chat/sessions/history
+kweaver skill list/market/get/register/status/delete/content/read-file/download/install
 kweaver context-loader config set/use/list/show
 kweaver context-loader kn-search/query-object-instance/...
 kweaver call <path> [-X METHOD] [-d BODY] [-H header]

package/dist/api/agent-chat.d.ts

@@ -41,7 +41,7 @@ export interface AgentInfo {
     key: string;
     version: string;
 }
-export declare function buildChatUrl(baseUrl: string, agentId: string): string;
+export declare function buildChatUrl(baseUrl: string, agentKey: string): string;
 export declare function buildAgentInfoUrl(baseUrl: string, agentId: string, version: string): string;
 export declare function fetchAgentInfo(options: {
     baseUrl: string;

package/dist/api/agent-chat.js

@@ -2,9 +2,9 @@ import { fetchTextOrThrow, HttpError } from "../utils/http.js";
 import { normalizeDisplayText } from "../utils/display-text.js";
 const CHAT_PATH = "/api/agent-factory/v1/app";
 const AGENT_INFO_PATH = "/api/agent-factory/v3/agent-market/agent";
-export function buildChatUrl(baseUrl, agentId) {
+export function buildChatUrl(baseUrl, agentKey) {
     const base = baseUrl.replace(/\/+$/, "");
-    return `${base}${CHAT_PATH}/${agentId}/chat/completion`;
+    return `${base}${CHAT_PATH}/${agentKey}/chat/completion`;
 }
 export function buildAgentInfoUrl(baseUrl, agentId, version) {
     const base = baseUrl.replace(/\/+$/, "");
@@ -233,7 +233,7 @@ function applySseDataLine(line, state, verbose, onTextDelta, onProgress) {
 }
 export async function sendChatRequest(options) {
     const { baseUrl, accessToken, agentId, agentKey, agentVersion, query, conversationId, stream, verbose, businessDomain = "bd_public", } = options;
-    const url = buildChatUrl(baseUrl, agentId);
+    const url = buildChatUrl(baseUrl, agentKey);
     const body = {
         agent_id: agentId,
         agent_key: agentKey,
@@ -292,7 +292,7 @@ export async function sendChatRequest(options) {
 export async function sendChatRequestStream(options, callbacks) {
     const opts = { ...options, stream: true };
     const { baseUrl, accessToken, agentId, agentKey, agentVersion, query, conversationId, verbose, businessDomain = "bd_public", } = opts;
-    const url = buildChatUrl(baseUrl, agentId);
+    const url = buildChatUrl(baseUrl, agentKey);
     const body = {
         agent_id: agentId,
         agent_key: agentKey,

package/dist/api/agent-list.d.ts

@@ -51,6 +51,7 @@ export interface PublishAgentOptions {
     accessToken: string;
     agentId: string;
     body?: string;
+    categoryId?: string;
     businessDomain?: string;
 }
 export declare function publishAgent(options: PublishAgentOptions): Promise<string>;
@@ -61,3 +62,37 @@ export interface UnpublishAgentOptions {
     businessDomain?: string;
 }
 export declare function unpublishAgent(options: UnpublishAgentOptions): Promise<void>;
+export interface ListPersonalAgentsOptions {
+    baseUrl: string;
+    accessToken: string;
+    businessDomain?: string;
+    name?: string;
+    pagination_marker_str?: string;
+    publish_status?: string;
+    publish_to_be?: string;
+    size?: number;
+}
+export declare function listPersonalAgents(options: ListPersonalAgentsOptions): Promise<string>;
+export interface ListPublishedAgentTemplatesOptions {
+    baseUrl: string;
+    accessToken: string;
+    businessDomain?: string;
+    category_id?: string;
+    name?: string;
+    pagination_marker_str?: string;
+    size?: number;
+}
+export declare function listPublishedAgentTemplates(options: ListPublishedAgentTemplatesOptions): Promise<string>;
+export interface GetPublishedAgentTemplateOptions {
+    baseUrl: string;
+    accessToken: string;
+    templateId: string;
+    businessDomain?: string;
+}
+export declare function getPublishedAgentTemplate(options: GetPublishedAgentTemplateOptions): Promise<string>;
+export interface ListAgentCategoriesOptions {
+    baseUrl: string;
+    accessToken: string;
+    businessDomain?: string;
+}
+export declare function listAgentCategories(options: ListAgentCategoriesOptions): Promise<string>;

package/dist/api/agent-list.js

@@ -1,14 +1,5 @@
 import { HttpError } from "../utils/http.js";
-function buildHeaders(accessToken, businessDomain) {
-    return {
-        accept: "application/json, text/plain, */*",
-        "accept-language": "zh-CN",
-        authorization: `Bearer ${accessToken}`,
-        token: accessToken,
-        "x-business-domain": businessDomain,
-        "x-language": "zh-CN",
-    };
-}
+import { buildHeaders } from "./headers.js";
 export async function listAgents(options) {
     const { baseUrl, accessToken, businessDomain = "bd_public", name = "", offset = 0, limit = 50, category_id = "", custom_space_id = "", is_to_square = 1, } = options;
     const base = baseUrl.replace(/\/+$/, "");
@@ -110,16 +101,25 @@ export async function deleteAgent(options) {
     }
 }
 export async function publishAgent(options) {
-    const { baseUrl, accessToken, agentId, body = "{}", businessDomain = "bd_public", } = options;
+    const { baseUrl, accessToken, agentId, body, categoryId, businessDomain = "bd_public", } = options;
     const base = baseUrl.replace(/\/+$/, "");
     const url = `${base}/api/agent-factory/v3/agent/${encodeURIComponent(agentId)}/publish`;
+    // Build default body if not provided
+    const requestBody = body || JSON.stringify({
+        business_domain_id: "bd_public",
+        category_ids: categoryId ? [categoryId] : [],
+        description: "",
+        publish_to_where: ["square"],
+        publish_to_bes: ["skill_agent"],
+        pms_control: null,
+    });
     const response = await fetch(url, {
         method: "POST",
         headers: {
             ...buildHeaders(accessToken, businessDomain),
             "content-type": "application/json",
         },
-        body,
+        body: requestBody,
     });
     const responseBody = await response.text();
     if (!response.ok) {
@@ -140,3 +140,77 @@ export async function unpublishAgent(options) {
         throw new HttpError(response.status, response.statusText, responseBody);
     }
 }
+export async function listPersonalAgents(options) {
+    const { baseUrl, accessToken, businessDomain = "bd_public", name = "", pagination_marker_str = "", publish_status = "", publish_to_be = "", size = 48, } = options;
+    const base = baseUrl.replace(/\/+$/, "");
+    const params = new URLSearchParams();
+    if (name)
+        params.append("name", name);
+    if (pagination_marker_str)
+        params.append("pagination_marker_str", pagination_marker_str);
+    if (publish_status)
+        params.append("publish_status", publish_status);
+    if (publish_to_be)
+        params.append("publish_to_be", publish_to_be);
+    params.append("size", String(size));
+    const url = `${base}/api/agent-factory/v3/personal-space/agent-list?${params.toString()}`;
+    const response = await fetch(url, {
+        method: "GET",
+        headers: buildHeaders(accessToken, businessDomain),
+    });
+    const responseBody = await response.text();
+    if (!response.ok) {
+        throw new HttpError(response.status, response.statusText, responseBody);
+    }
+    return responseBody;
+}
+export async function listPublishedAgentTemplates(options) {
+    const { baseUrl, accessToken, businessDomain = "bd_public", category_id = "", name = "", pagination_marker_str = "", size = 48, } = options;
+    const base = baseUrl.replace(/\/+$/, "");
+    const params = new URLSearchParams();
+    if (category_id)
+        params.append("category_id", category_id);
+    if (name)
+        params.append("name", name);
+    if (pagination_marker_str)
+        params.append("pagination_marker_str", pagination_marker_str);
+    params.append("size", String(size));
+    const url = `${base}/api/agent-factory/v3/published/agent-tpl?${params.toString()}`;
+    const response = await fetch(url, {
+        method: "GET",
+        headers: buildHeaders(accessToken, businessDomain),
+    });
+    const responseBody = await response.text();
+    if (!response.ok) {
+        throw new HttpError(response.status, response.statusText, responseBody);
+    }
+    return responseBody;
+}
+export async function getPublishedAgentTemplate(options) {
+    const { baseUrl, accessToken, templateId, businessDomain = "bd_public", } = options;
+    const base = baseUrl.replace(/\/+$/, "");
+    const url = `${base}/api/agent-factory/v3/published/agent-tpl/${encodeURIComponent(templateId)}`;
+    const response = await fetch(url, {
+        method: "GET",
+        headers: buildHeaders(accessToken, businessDomain),
+    });
+    const responseBody = await response.text();
+    if (!response.ok) {
+        throw new HttpError(response.status, response.statusText, responseBody);
+    }
+    return responseBody;
+}
+export async function listAgentCategories(options) {
+    const { baseUrl, accessToken, businessDomain = "bd_public", } = options;
+    const base = baseUrl.replace(/\/+$/, "");
+    const url = `${base}/api/agent-factory/v3/category`;
+    const response = await fetch(url, {
+        method: "GET",
+        headers: buildHeaders(accessToken, businessDomain),
+    });
+    const responseBody = await response.text();
+    if (!response.ok) {
+        throw new HttpError(response.status, response.statusText, responseBody);
+    }
+    return responseBody;
+}

package/dist/api/bkn-backend.d.ts

@@ -6,6 +6,66 @@ export interface UploadBknOptions {
     branch?: string;
 }
 export declare function uploadBkn(options: UploadBknOptions): Promise<string>;
+export interface BknBackendBaseOptions {
+    baseUrl: string;
+    accessToken: string;
+    businessDomain?: string;
+}
+export interface BknBackendKnOptions extends BknBackendBaseOptions {
+    knId: string;
+}
+export interface ConceptGroupOptions extends BknBackendKnOptions {
+    cgId: string;
+}
+export interface ConceptGroupBodyOptions extends BknBackendKnOptions {
+    body: string;
+}
+export interface ConceptGroupMutateOptions extends ConceptGroupOptions {
+    body: string;
+}
+export interface ConceptGroupRemoveMembersOptions extends ConceptGroupOptions {
+    otIds: string;
+}
+export declare function listConceptGroups(opts: BknBackendKnOptions): Promise<string>;
+export declare function getConceptGroup(opts: ConceptGroupOptions): Promise<string>;
+export declare function createConceptGroup(opts: ConceptGroupBodyOptions): Promise<string>;
+export declare function updateConceptGroup(opts: ConceptGroupMutateOptions): Promise<string>;
+export declare function deleteConceptGroup(opts: ConceptGroupOptions): Promise<string>;
+export declare function addConceptGroupMembers(opts: ConceptGroupMutateOptions): Promise<string>;
+export declare function removeConceptGroupMembers(opts: ConceptGroupRemoveMembersOptions): Promise<string>;
+export interface ActionScheduleOptions extends BknBackendKnOptions {
+    scheduleId: string;
+}
+export interface ActionScheduleBodyOptions extends BknBackendKnOptions {
+    body: string;
+}
+export interface ActionScheduleMutateOptions extends ActionScheduleOptions {
+    body: string;
+}
+export interface ActionScheduleDeleteOptions extends BknBackendKnOptions {
+    scheduleIds: string;
+}
+export declare function listActionSchedules(opts: BknBackendKnOptions): Promise<string>;
+export declare function getActionSchedule(opts: ActionScheduleOptions): Promise<string>;
+export declare function createActionSchedule(opts: ActionScheduleBodyOptions): Promise<string>;
+export declare function updateActionSchedule(opts: ActionScheduleMutateOptions): Promise<string>;
+export declare function setActionScheduleStatus(opts: ActionScheduleMutateOptions): Promise<string>;
+export declare function deleteActionSchedules(opts: ActionScheduleDeleteOptions): Promise<string>;
+export interface JobOptions extends BknBackendKnOptions {
+    jobId: string;
+}
+export interface JobDeleteOptions extends BknBackendKnOptions {
+    jobIds: string;
+}
+export declare function listJobs(opts: BknBackendKnOptions): Promise<string>;
+export declare function getJob(opts: JobOptions): Promise<string>;
+export declare function getJobTasks(opts: JobOptions): Promise<string>;
+export declare function deleteJobs(opts: JobDeleteOptions): Promise<string>;
+export interface RelationTypePathsOptions extends BknBackendKnOptions {
+    body: string;
+}
+export declare function queryRelationTypePaths(opts: RelationTypePathsOptions): Promise<string>;
+export declare function listBknResources(opts: BknBackendBaseOptions): Promise<string>;
 export interface DownloadBknOptions {
     baseUrl: string;
     accessToken: string;

package/dist/api/bkn-backend.js

@@ -1,14 +1,5 @@
 import { HttpError } from "../utils/http.js";
-function buildHeaders(accessToken, businessDomain) {
-    return {
-        accept: "application/json, text/plain, */*",
-        "accept-language": "zh-cn",
-        authorization: `Bearer ${accessToken}`,
-        token: accessToken,
-        "x-business-domain": businessDomain,
-        "x-language": "zh-cn",
-    };
-}
+import { buildHeaders } from "./headers.js";
 export async function uploadBkn(options) {
     const { baseUrl, accessToken, tarBuffer, businessDomain = "bd_public", branch = "main", } = options;
     const base = baseUrl.replace(/\/+$/, "");
@@ -28,6 +19,108 @@ export async function uploadBkn(options) {
     }
     return body;
 }
+const BKN_BASE = "/api/bkn-backend/v1";
+function knUrl(baseUrl, knId, path) {
+    const base = baseUrl.replace(/\/+$/, "");
+    return `${base}${BKN_BASE}/knowledge-networks/${encodeURIComponent(knId)}/${path}`;
+}
+function baseUrlOnly(baseUrl, path) {
+    const base = baseUrl.replace(/\/+$/, "");
+    return `${base}${BKN_BASE}/${path}`;
+}
+async function bknGet(url, accessToken, businessDomain = "bd_public") {
+    const response = await fetch(url, { method: "GET", headers: buildHeaders(accessToken, businessDomain) });
+    const body = await response.text();
+    if (!response.ok)
+        throw new HttpError(response.status, response.statusText, body);
+    return body;
+}
+async function bknPost(url, accessToken, reqBody, businessDomain = "bd_public") {
+    const response = await fetch(url, {
+        method: "POST",
+        headers: { ...buildHeaders(accessToken, businessDomain), "content-type": "application/json" },
+        body: reqBody,
+    });
+    const body = await response.text();
+    if (!response.ok)
+        throw new HttpError(response.status, response.statusText, body);
+    return body;
+}
+async function bknPut(url, accessToken, reqBody, businessDomain = "bd_public") {
+    const response = await fetch(url, {
+        method: "PUT",
+        headers: { ...buildHeaders(accessToken, businessDomain), "content-type": "application/json" },
+        body: reqBody,
+    });
+    const body = await response.text();
+    if (!response.ok)
+        throw new HttpError(response.status, response.statusText, body);
+    return body;
+}
+async function bknDelete(url, accessToken, businessDomain = "bd_public") {
+    const response = await fetch(url, { method: "DELETE", headers: buildHeaders(accessToken, businessDomain) });
+    const body = await response.text();
+    if (!response.ok)
+        throw new HttpError(response.status, response.statusText, body);
+    return body;
+}
+export function listConceptGroups(opts) {
+    return bknGet(knUrl(opts.baseUrl, opts.knId, "concept-groups"), opts.accessToken, opts.businessDomain);
+}
+export function getConceptGroup(opts) {
+    return bknGet(knUrl(opts.baseUrl, opts.knId, `concept-groups/${encodeURIComponent(opts.cgId)}`), opts.accessToken, opts.businessDomain);
+}
+export function createConceptGroup(opts) {
+    return bknPost(knUrl(opts.baseUrl, opts.knId, "concept-groups"), opts.accessToken, opts.body, opts.businessDomain);
+}
+export function updateConceptGroup(opts) {
+    return bknPut(knUrl(opts.baseUrl, opts.knId, `concept-groups/${encodeURIComponent(opts.cgId)}`), opts.accessToken, opts.body, opts.businessDomain);
+}
+export function deleteConceptGroup(opts) {
+    return bknDelete(knUrl(opts.baseUrl, opts.knId, `concept-groups/${encodeURIComponent(opts.cgId)}`), opts.accessToken, opts.businessDomain);
+}
+export function addConceptGroupMembers(opts) {
+    return bknPost(knUrl(opts.baseUrl, opts.knId, `concept-groups/${encodeURIComponent(opts.cgId)}/object-types`), opts.accessToken, opts.body, opts.businessDomain);
+}
+export function removeConceptGroupMembers(opts) {
+    return bknDelete(knUrl(opts.baseUrl, opts.knId, `concept-groups/${encodeURIComponent(opts.cgId)}/object-types/${opts.otIds}`), opts.accessToken, opts.businessDomain);
+}
+export function listActionSchedules(opts) {
+    return bknGet(knUrl(opts.baseUrl, opts.knId, "action-schedules"), opts.accessToken, opts.businessDomain);
+}
+export function getActionSchedule(opts) {
+    return bknGet(knUrl(opts.baseUrl, opts.knId, `action-schedules/${encodeURIComponent(opts.scheduleId)}`), opts.accessToken, opts.businessDomain);
+}
+export function createActionSchedule(opts) {
+    return bknPost(knUrl(opts.baseUrl, opts.knId, "action-schedules"), opts.accessToken, opts.body, opts.businessDomain);
+}
+export function updateActionSchedule(opts) {
+    return bknPut(knUrl(opts.baseUrl, opts.knId, `action-schedules/${encodeURIComponent(opts.scheduleId)}`), opts.accessToken, opts.body, opts.businessDomain);
+}
+export function setActionScheduleStatus(opts) {
+    return bknPut(knUrl(opts.baseUrl, opts.knId, `action-schedules/${encodeURIComponent(opts.scheduleId)}/status`), opts.accessToken, opts.body, opts.businessDomain);
+}
+export function deleteActionSchedules(opts) {
+    return bknDelete(knUrl(opts.baseUrl, opts.knId, `action-schedules/${opts.scheduleIds}`), opts.accessToken, opts.businessDomain);
+}
+export function listJobs(opts) {
+    return bknGet(knUrl(opts.baseUrl, opts.knId, "jobs"), opts.accessToken, opts.businessDomain);
+}
+export function getJob(opts) {
+    return bknGet(knUrl(opts.baseUrl, opts.knId, `jobs/${encodeURIComponent(opts.jobId)}`), opts.accessToken, opts.businessDomain);
+}
+export function getJobTasks(opts) {
+    return bknGet(knUrl(opts.baseUrl, opts.knId, `jobs/${encodeURIComponent(opts.jobId)}/tasks`), opts.accessToken, opts.businessDomain);
+}
+export function deleteJobs(opts) {
+    return bknDelete(knUrl(opts.baseUrl, opts.knId, `jobs/${opts.jobIds}`), opts.accessToken, opts.businessDomain);
+}
+export function queryRelationTypePaths(opts) {
+    return bknPost(knUrl(opts.baseUrl, opts.knId, "relation-type-paths"), opts.accessToken, opts.body, opts.businessDomain);
+}
+export function listBknResources(opts) {
+    return bknGet(baseUrlOnly(opts.baseUrl, "resources"), opts.accessToken, opts.businessDomain);
+}
 export async function downloadBkn(options) {
     const { baseUrl, accessToken, knId, businessDomain = "bd_public", branch = "main", } = options;
     const base = baseUrl.replace(/\/+$/, "");

package/dist/api/conversations.d.ts

@@ -1,21 +1,24 @@
 export interface ListConversationsOptions {
     baseUrl: string;
     accessToken: string;
-    agentId: string;
+    agentKey: string;
     businessDomain?: string;
-    limit?: number;
+    page?: number;
+    size?: number;
 }
 export interface ListMessagesOptions {
     baseUrl: string;
     accessToken: string;
+    agentKey: string;
     conversationId: string;
     businessDomain?: string;
-    limit?: number;
 }
 export interface GetTracesOptions {
     baseUrl: string;
     accessToken: string;
+    agentId: string;
     conversationId: string;
+    businessDomain?: string;
 }
 /**
  * List conversations for an agent.

package/dist/api/conversations.js

@@ -1,21 +1,20 @@
-function buildConversationsUrl(baseUrl, agentId) {
+function buildConversationsUrl(baseUrl, agentKey) {
     const base = baseUrl.replace(/\/+$/, "");
-    return `${base}/api/agent-app/v1/app/${agentId}/conversations`;
+    return `${base}/api/agent-factory/v1/app/${agentKey}/conversation`;
 }
-function buildMessagesUrl(baseUrl, conversationId) {
+function buildMessagesUrl(baseUrl, agentKey, conversationId) {
     const base = baseUrl.replace(/\/+$/, "");
-    return `${base}/api/agent-app/v1/conversations/${conversationId}/messages`;
+    return `${base}/api/agent-factory/v1/app/${agentKey}/conversation/${conversationId}`;
 }
 /**
  * List conversations for an agent.
  * Returns empty array on 404 (endpoint may not be available in all deployments).
  */
 export async function listConversations(opts) {
-    const { baseUrl, accessToken, agentId, businessDomain = "bd_public", limit } = opts;
-    const url = new URL(buildConversationsUrl(baseUrl, agentId));
-    if (limit !== undefined) {
-        url.searchParams.set("limit", String(limit));
-    }
+    const { baseUrl, accessToken, agentKey, businessDomain = "bd_public", page = 1, size = 10 } = opts;
+    const url = new URL(buildConversationsUrl(baseUrl, agentKey));
+    url.searchParams.set("page", String(page));
+    url.searchParams.set("size", String(size));
     const response = await fetch(url.toString(), {
         method: "GET",
         headers: {
@@ -25,29 +24,35 @@ export async function listConversations(opts) {
             "x-business-domain": businessDomain,
         },
     });
-    if (response.status === 404) {
-        return "[]";
-    }
     const body = await response.text();
     if (!response.ok) {
         throw new Error(`listConversations failed: HTTP ${response.status} ${response.statusText} — ${body.slice(0, 200)}`);
     }
     return body || "[]";
 }
-function buildTracesUrl(baseUrl, conversationId) {
+function buildTracesUrl(baseUrl, agentId, conversationId) {
     const base = baseUrl.replace(/\/+$/, "");
-    return `${base}/api/agent-observability/v1/traces/by-conversation?conversation_id=${conversationId}`;
+    return `${base}/api/agent-factory/v1/observability/agent/${agentId}/conversation/${conversationId}/session`;
 }
 export async function getTracesByConversation(opts) {
-    const { baseUrl, accessToken, conversationId } = opts;
-    const url = buildTracesUrl(baseUrl, conversationId);
+    const { baseUrl, accessToken, agentId, conversationId, businessDomain = "bd_public" } = opts;
+    const url = buildTracesUrl(baseUrl, agentId, conversationId);
     const response = await fetch(url, {
-        method: "GET",
+        method: "POST",
         headers: {
+            "Content-Type": "application/json",
             accept: "application/json",
             authorization: `Bearer ${accessToken}`,
             token: accessToken,
+            "x-business-domain": businessDomain,
         },
+        body: JSON.stringify({
+            agent_id: agentId,
+            start_time: 1,
+            end_time: Date.now() + 86400000,
+            page: 1,
+            size: 50,
+        }),
     });
     const body = await response.text();
     if (!response.ok) {
@@ -60,12 +65,9 @@ export async function getTracesByConversation(opts) {
  * Returns empty array on 404 (endpoint may not be available in all deployments).
  */
 export async function listMessages(opts) {
-    const { baseUrl, accessToken, conversationId, businessDomain = "bd_public", limit } = opts;
-    const url = new URL(buildMessagesUrl(baseUrl, conversationId));
-    if (limit !== undefined) {
-        url.searchParams.set("limit", String(limit));
-    }
-    const response = await fetch(url.toString(), {
+    const { baseUrl, accessToken, agentKey, conversationId, businessDomain = "bd_public" } = opts;
+    const url = buildMessagesUrl(baseUrl, agentKey, conversationId);
+    const response = await fetch(url, {
         method: "GET",
         headers: {
             accept: "application/json",
@@ -74,12 +76,9 @@ export async function listMessages(opts) {
             "x-business-domain": businessDomain,
         },
     });
-    if (response.status === 404) {
-        return "[]";
-    }
     const body = await response.text();
     if (!response.ok) {
         throw new Error(`listMessages failed: HTTP ${response.status} ${response.statusText} — ${body.slice(0, 200)}`);
     }
-    return body || "[]";
+    return body || "{}";
 }

package/dist/api/dataflow.js

@@ -1,14 +1,5 @@
 import { HttpError } from "../utils/http.js";
-function buildHeaders(accessToken, businessDomain) {
-    return {
-        accept: "application/json, text/plain, */*",
-        "accept-language": "zh-cn",
-        authorization: `Bearer ${accessToken}`,
-        token: accessToken,
-        "x-business-domain": businessDomain,
-        "x-language": "zh-cn",
-    };
-}
+import { buildHeaders } from "./headers.js";
 function debugLog(method, url, headers, body) {
     if (!process.env["KWEAVER_DEBUG_HTTP"])
         return;

package/dist/api/datasources.js

@@ -1,5 +1,6 @@
 import { HttpError } from "../utils/http.js";
 import { encryptPassword } from "../utils/crypto.js";
+import { buildHeaders } from "./headers.js";
 const HTTPS_PROTOCOLS = new Set(["maxcompute", "anyshare7", "opensearch"]);
 function connectProtocol(dsType) {
     return HTTPS_PROTOCOLS.has(dsType) ? "https" : "jdbc";
@@ -18,16 +19,6 @@ function makeBinData(type, host, port, database, account, password, schema) {
     }
     return d;
 }
-function buildHeaders(accessToken, businessDomain) {
-    return {
-        accept: "application/json, text/plain, */*",
-        "accept-language": "zh-cn",
-        authorization: `Bearer ${accessToken}`,
-        token: accessToken,
-        "x-business-domain": businessDomain,
-        "x-language": "zh-cn",
-    };
-}
 export async function testDatasource(options) {
     const { baseUrl, accessToken, type, host, port, database, account, password, schema, businessDomain = "bd_public", } = options;
     const base = baseUrl.replace(/\/+$/, "");

package/dist/api/dataviews.js

@@ -1,15 +1,6 @@
 import { createHash } from "node:crypto";
 import { HttpError } from "../utils/http.js";
-function buildHeaders(accessToken, businessDomain) {
-    return {
-        accept: "application/json, text/plain, */*",
-        "accept-language": "zh-cn",
-        authorization: `Bearer ${accessToken}`,
-        token: accessToken,
-        "x-business-domain": businessDomain,
-        "x-language": "zh-cn",
-    };
-}
+import { buildHeaders } from "./headers.js";
 function extractViewId(data) {
     if (Array.isArray(data) && data.length > 0) {
         const item = data[0];

package/dist/api/headers.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Shared HTTP header builder for all KWeaver API calls.
+ *
+ * Supports optional x-account-id / x-account-type headers read from
+ * environment variables KWEAVER_ACCOUNT_ID and KWEAVER_ACCOUNT_TYPE.
+ * These are required by older platform versions (e.g. dip-poc.aishu.cn)
+ * that do not infer account info from the token automatically.
+ */
+export declare function buildHeaders(accessToken: string, businessDomain: string): Record<string, string>;