@kweaver-ai/kweaver-sdk 0.5.1 → 0.6.0

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 { HttpError, fetchWithRetry } from "../utils/http.js";
+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(/\/+$/, "");
@@ -21,7 +12,7 @@ export async function listAgents(options) {
         custom_space_id,
         is_to_square,
     });
-    const response = await fetch(url, {
+    const response = await fetchWithRetry(url, {
         method: "POST",
         headers: buildHeaders(accessToken, businessDomain),
         body,
@@ -36,7 +27,7 @@ export async function getAgent(options) {
     const { baseUrl, accessToken, agentId, businessDomain = "bd_public", } = options;
     const base = baseUrl.replace(/\/+$/, "");
     const url = `${base}/api/agent-factory/v3/agent/${encodeURIComponent(agentId)}`;
-    const response = await fetch(url, {
+    const response = await fetchWithRetry(url, {
         method: "GET",
         headers: buildHeaders(accessToken, businessDomain),
     });
@@ -50,7 +41,7 @@ export async function getAgentByKey(options) {
     const { baseUrl, accessToken, key, businessDomain = "bd_public", } = options;
     const base = baseUrl.replace(/\/+$/, "");
     const url = `${base}/api/agent-factory/v3/agent/by-key/${encodeURIComponent(key)}`;
-    const response = await fetch(url, {
+    const response = await fetchWithRetry(url, {
         method: "GET",
         headers: buildHeaders(accessToken, businessDomain),
     });
@@ -64,7 +55,7 @@ export async function createAgent(options) {
     const { baseUrl, accessToken, body, businessDomain = "bd_public", } = options;
     const base = baseUrl.replace(/\/+$/, "");
     const url = `${base}/api/agent-factory/v3/agent`;
-    const response = await fetch(url, {
+    const response = await fetchWithRetry(url, {
         method: "POST",
         headers: {
             ...buildHeaders(accessToken, businessDomain),
@@ -82,7 +73,7 @@ export async function updateAgent(options) {
     const { baseUrl, accessToken, agentId, body, businessDomain = "bd_public", } = options;
     const base = baseUrl.replace(/\/+$/, "");
     const url = `${base}/api/agent-factory/v3/agent/${encodeURIComponent(agentId)}`;
-    const response = await fetch(url, {
+    const response = await fetchWithRetry(url, {
         method: "PUT",
         headers: {
             ...buildHeaders(accessToken, businessDomain),
@@ -100,7 +91,7 @@ export async function deleteAgent(options) {
     const { baseUrl, accessToken, agentId, businessDomain = "bd_public", } = options;
     const base = baseUrl.replace(/\/+$/, "");
     const url = `${base}/api/agent-factory/v3/agent/${encodeURIComponent(agentId)}`;
-    const response = await fetch(url, {
+    const response = await fetchWithRetry(url, {
         method: "DELETE",
         headers: buildHeaders(accessToken, businessDomain),
     });
@@ -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`;
-    const response = await fetch(url, {
+    // 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 fetchWithRetry(url, {
         method: "POST",
         headers: {
             ...buildHeaders(accessToken, businessDomain),
             "content-type": "application/json",
         },
-        body,
+        body: requestBody,
     });
     const responseBody = await response.text();
     if (!response.ok) {
@@ -131,7 +131,7 @@ export async function unpublishAgent(options) {
     const { baseUrl, accessToken, agentId, businessDomain = "bd_public", } = options;
     const base = baseUrl.replace(/\/+$/, "");
     const url = `${base}/api/agent-factory/v3/agent/${encodeURIComponent(agentId)}/unpublish`;
-    const response = await fetch(url, {
+    const response = await fetchWithRetry(url, {
         method: "PUT",
         headers: buildHeaders(accessToken, businessDomain),
     });
@@ -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 fetchWithRetry(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 fetchWithRetry(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 fetchWithRetry(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 fetchWithRetry(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/business-domains.js

@@ -1,3 +1,4 @@
+import { isNoAuth } from "../config/no-auth.js";
 import { HttpError } from "../utils/http.js";
 async function withTlsInsecure(tlsInsecure, fn) {
     if (!tlsInsecure) {
@@ -26,13 +27,16 @@ export async function listBusinessDomains(options) {
     const base = baseUrl.replace(/\/+$/, "");
     const url = `${base}/api/business-system/v1/business-domain`;
     return withTlsInsecure(tlsInsecure, async () => {
+        const headers = {
+            accept: "application/json, text/plain, */*",
+        };
+        if (!isNoAuth(accessToken)) {
+            headers.authorization = `Bearer ${accessToken}`;
+            headers.token = accessToken;
+        }
         const response = await fetch(url, {
             method: "GET",
-            headers: {
-                accept: "application/json, text/plain, */*",
-                authorization: `Bearer ${accessToken}`,
-                token: accessToken,
-            },
+            headers,
         });
         const body = await response.text();
         if (!response.ok) {

package/dist/api/context-loader.js

@@ -1,3 +1,4 @@
+import { isNoAuth } from "../config/no-auth.js";
 import { fetchTextOrThrow } from "../utils/http.js";
 const MCP_PROTOCOL_VERSION = "2024-11-05";
 const SESSION_TTL_MS = 300_000; // 5 minutes
@@ -9,10 +10,12 @@ function buildHeaders(options, sessionId) {
     const headers = {
         "Content-Type": "application/json",
         Accept: "application/json, text/event-stream",
-        Authorization: `Bearer ${options.accessToken}`,
         "X-Kn-ID": options.knId,
         "MCP-Protocol-Version": MCP_PROTOCOL_VERSION,
     };
+    if (!isNoAuth(options.accessToken)) {
+        headers.Authorization = `Bearer ${options.accessToken}`;
+    }
     if (sessionId) {
         headers["MCP-Session-Id"] = sessionId;
     }

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,53 +1,55 @@
-function buildConversationsUrl(baseUrl, agentId) {
+import { buildHeaders } from "./headers.js";
+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: {
             accept: "application/json",
-            authorization: `Bearer ${accessToken}`,
-            token: accessToken,
-            "x-business-domain": businessDomain,
+            ...buildHeaders(accessToken, 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,
+            ...buildHeaders(accessToken, 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,26 +62,18 @@ 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",
-            authorization: `Bearer ${accessToken}`,
-            token: accessToken,
-            "x-business-domain": businessDomain,
+            ...buildHeaders(accessToken, 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/dataflow2.d.ts

@@ -0,0 +1,95 @@
+export interface DataflowListItem {
+    id: string;
+    title?: string;
+    status?: string;
+    trigger?: string;
+    creator?: string;
+    updated_at?: number;
+    version_id?: string;
+}
+export interface DataflowListResponse {
+    dags: DataflowListItem[];
+    limit?: number;
+    page?: number;
+    total?: number;
+}
+export interface DataflowRunSource {
+    name?: string;
+    content_type?: string;
+    size?: number;
+    [key: string]: unknown;
+}
+export interface DataflowRunItem {
+    id: string;
+    status?: string;
+    started_at?: number;
+    ended_at?: number | null;
+    reason?: string | null;
+    source?: DataflowRunSource;
+}
+export interface DataflowRunsResponse {
+    results: DataflowRunItem[];
+    limit?: number;
+    page?: number;
+    total?: number;
+}
+export interface DataflowLogMetadata {
+    duration?: number;
+    [key: string]: unknown;
+}
+export interface DataflowLogItem {
+    id: string;
+    operator?: string;
+    status?: string;
+    started_at?: number;
+    updated_at?: number;
+    inputs?: unknown;
+    outputs?: unknown;
+    taskId?: string;
+    metadata?: DataflowLogMetadata;
+}
+export interface DataflowLogsResponse {
+    results: DataflowLogItem[];
+    limit?: number;
+    page?: number;
+    total?: number;
+}
+export interface DataflowRunResponse {
+    dag_instance_id: string;
+}
+interface BaseOptions {
+    baseUrl: string;
+    accessToken: string;
+    businessDomain?: string;
+}
+export interface RunDataflowWithFileOptions extends BaseOptions {
+    dagId: string;
+    fileName: string;
+    fileBytes: Uint8Array;
+}
+export interface RunDataflowWithRemoteUrlOptions extends BaseOptions {
+    dagId: string;
+    url: string;
+    name: string;
+}
+export interface ListDataflowRunsOptions extends BaseOptions {
+    dagId: string;
+    page?: number;
+    limit?: number;
+    sortBy?: string;
+    order?: string;
+    startTime?: number;
+    endTime?: number;
+}
+export interface GetDataflowLogsPageOptions extends BaseOptions {
+    dagId: string;
+    instanceId: string;
+    page: number;
+    limit?: number;
+}
+export declare function listDataflows(options: BaseOptions): Promise<DataflowListResponse>;
+export declare function runDataflowWithFile(options: RunDataflowWithFileOptions): Promise<DataflowRunResponse>;
+export declare function runDataflowWithRemoteUrl(options: RunDataflowWithRemoteUrlOptions): Promise<DataflowRunResponse>;
+export declare function listDataflowRuns(options: ListDataflowRunsOptions): Promise<DataflowRunsResponse>;
+export declare function getDataflowLogsPage(options: GetDataflowLogsPageOptions): Promise<DataflowLogsResponse>;
+export {};