@kweaver-ai/kweaver-sdk 0.4.13 → 0.4.15

package/README.md

@@ -31,6 +31,18 @@ export KWEAVER_BASE_URL=https://your-kweaver-instance.com
 export KWEAVER_TOKEN=your-token
 ```
 
+### Business domain (platform)
+
+Set or verify **before** calling list/query APIs that scope by tenant. DIP deployments often need a UUID, not only `bd_public`.
+
+```bash
+kweaver config show
+kweaver config list-bd
+kweaver config set-bd <uuid>
+```
+
+After `kweaver auth login`, the CLI may auto-select a domain when none is saved yet. Override with `KWEAVER_BUSINESS_DOMAIN` or `-bd` / `--biz-domain` on commands. See [`../../skills/kweaver-core/references/config.md`](../../skills/kweaver-core/references/config.md).
+
 ### Simple API (recommended)
 
 ```typescript
@@ -130,8 +142,8 @@ kweaver auth login <url> [--alias name] [-u user] [-p pass] [--playwright] [--in
 kweaver auth login <url> --client-id ID --client-secret S --refresh-token T   (headless login)
 kweaver auth export [url|alias] [--json]   (export command to run on a headless host)
 kweaver auth status/list/use/delete/logout
+kweaver config show / list-bd / set-bd <value>   # platform business domain — after login
 kweaver token
-kweaver config show / set-bd <value>
 kweaver ds list/get/delete/tables/connect
 kweaver ds import-csv <ds_id> --files <glob> [--table-prefix <p>] [--batch-size 500]
 kweaver dataview list/find/get/query/delete

package/README.zh.md

@@ -31,6 +31,18 @@ export KWEAVER_BASE_URL=https://your-kweaver-instance.com
 export KWEAVER_TOKEN=your-token
 ```
 
+### 业务域（平台配置）
+
+在调用依赖租户范围的接口前，应先确认业务域；DIP 环境通常使用 **UUID**，不能长期只依赖默认 `bd_public`。
+
+```bash
+kweaver config show
+kweaver config list-bd
+kweaver config set-bd <uuid>
+```
+
+`kweaver auth login` 成功后，若尚未配置，CLI 可能自动选择业务域。也可用环境变量 `KWEAVER_BUSINESS_DOMAIN` 或各命令的 `-bd` / `--biz-domain` 覆盖。详见 [`../../skills/kweaver-core/references/config.md`](../../skills/kweaver-core/references/config.md)。
+
 ### 简洁 API（推荐）
 
 ```typescript
@@ -119,6 +131,7 @@ kweaver auth login <url> [--alias name] [-u user] [-p pass] [--playwright] [--in
 kweaver auth login <url> --client-id ID --client-secret S --refresh-token T   (无浏览器登录)
 kweaver auth export [url|alias] [--json]   (导出在无浏览器机器上运行的命令)
 kweaver auth status/list/use/delete/logout
+kweaver config show / list-bd / set-bd <value>   # 平台业务域，登录后优先
 kweaver token
 kweaver ds list/get/delete/tables/connect
 kweaver dataview list/find/get/query/delete

package/dist/api/business-domains.d.ts

@@ -0,0 +1,20 @@
+/** One business domain entry from GET /api/business-system/v1/business-domain */
+export interface BusinessDomain {
+    id: string;
+    name?: string;
+    description?: string;
+    creator?: string;
+    products?: string[];
+    create_time?: string;
+}
+export interface ListBusinessDomainsOptions {
+    baseUrl: string;
+    accessToken: string;
+    /** When true, skip TLS verification (matches `--insecure` login). */
+    tlsInsecure?: boolean;
+}
+/**
+ * List business domains for the authenticated user. Does not send x-business-domain
+ * (the endpoint returns all domains the user can access).
+ */
+export declare function listBusinessDomains(options: ListBusinessDomainsOptions): Promise<BusinessDomain[]>;

package/dist/api/business-domains.js

@@ -0,0 +1,54 @@
+import { HttpError } from "../utils/http.js";
+async function withTlsInsecure(tlsInsecure, fn) {
+    if (!tlsInsecure) {
+        return fn();
+    }
+    const prev = process.env.NODE_TLS_REJECT_UNAUTHORIZED;
+    process.env.NODE_TLS_REJECT_UNAUTHORIZED = "0";
+    try {
+        return await fn();
+    }
+    finally {
+        if (prev === undefined) {
+            delete process.env.NODE_TLS_REJECT_UNAUTHORIZED;
+        }
+        else {
+            process.env.NODE_TLS_REJECT_UNAUTHORIZED = prev;
+        }
+    }
+}
+/**
+ * List business domains for the authenticated user. Does not send x-business-domain
+ * (the endpoint returns all domains the user can access).
+ */
+export async function listBusinessDomains(options) {
+    const { baseUrl, accessToken, tlsInsecure } = options;
+    const base = baseUrl.replace(/\/+$/, "");
+    const url = `${base}/api/business-system/v1/business-domain`;
+    return withTlsInsecure(tlsInsecure, async () => {
+        const response = await fetch(url, {
+            method: "GET",
+            headers: {
+                accept: "application/json, text/plain, */*",
+                authorization: `Bearer ${accessToken}`,
+                token: accessToken,
+            },
+        });
+        const body = await response.text();
+        if (!response.ok) {
+            throw new HttpError(response.status, response.statusText, body);
+        }
+        const data = JSON.parse(body);
+        if (!Array.isArray(data)) {
+            throw new Error("Business domain list response was not a JSON array.");
+        }
+        return data.map((item) => {
+            const row = item;
+            const id = row.id;
+            if (typeof id !== "string" || id.length === 0) {
+                throw new Error("Business domain entry missing string id.");
+            }
+            return item;
+        });
+    });
+}

package/dist/api/conversations.d.ts

@@ -12,11 +12,17 @@ export interface ListMessagesOptions {
     businessDomain?: string;
     limit?: number;
 }
+export interface GetTracesOptions {
+    baseUrl: string;
+    accessToken: string;
+    conversationId: string;
+}
 /**
  * List conversations for an agent.
  * Returns empty array on 404 (endpoint may not be available in all deployments).
  */
 export declare function listConversations(opts: ListConversationsOptions): Promise<string>;
+export declare function getTracesByConversation(opts: GetTracesOptions): Promise<string>;
 /**
  * List messages for a conversation.
  * Returns empty array on 404 (endpoint may not be available in all deployments).

package/dist/api/conversations.js

@@ -34,6 +34,27 @@ export async function listConversations(opts) {
     }
     return body || "[]";
 }
+function buildTracesUrl(baseUrl, conversationId) {
+    const base = baseUrl.replace(/\/+$/, "");
+    return `${base}/api/agent-observability/v1/traces/by-conversation?conversation_id=${conversationId}`;
+}
+export async function getTracesByConversation(opts) {
+    const { baseUrl, accessToken, conversationId } = opts;
+    const url = buildTracesUrl(baseUrl, conversationId);
+    const response = await fetch(url, {
+        method: "GET",
+        headers: {
+            accept: "application/json",
+            authorization: `Bearer ${accessToken}`,
+            token: accessToken,
+        },
+    });
+    const body = await response.text();
+    if (!response.ok) {
+        throw new Error(`getTracesByConversation failed: HTTP ${response.status} ${response.statusText} — ${body.slice(0, 200)}`);
+    }
+    return body || "{}";
+}
 /**
  * List messages for a conversation.
  * Returns empty array on 404 (endpoint may not be available in all deployments).

package/dist/api/vega.d.ts

@@ -20,6 +20,28 @@ export interface GetVegaCatalogOptions {
     businessDomain?: string;
 }
 export declare function getVegaCatalog(options: GetVegaCatalogOptions): Promise<string>;
+export interface CreateVegaCatalogOptions {
+    baseUrl: string;
+    accessToken: string;
+    body: string;
+    businessDomain?: string;
+}
+export declare function createVegaCatalog(options: CreateVegaCatalogOptions): Promise<string>;
+export interface UpdateVegaCatalogOptions {
+    baseUrl: string;
+    accessToken: string;
+    id: string;
+    body: string;
+    businessDomain?: string;
+}
+export declare function updateVegaCatalog(options: UpdateVegaCatalogOptions): Promise<string>;
+export interface DeleteVegaCatalogsOptions {
+    baseUrl: string;
+    accessToken: string;
+    ids: string;
+    businessDomain?: string;
+}
+export declare function deleteVegaCatalogs(options: DeleteVegaCatalogsOptions): Promise<string>;
 export interface VegaCatalogHealthStatusOptions {
     baseUrl: string;
     accessToken: string;
@@ -78,14 +100,28 @@ export interface QueryVegaResourceDataOptions {
     businessDomain?: string;
 }
 export declare function queryVegaResourceData(options: QueryVegaResourceDataOptions): Promise<string>;
-export interface PreviewVegaResourceOptions {
+export interface CreateVegaResourceOptions {
+    baseUrl: string;
+    accessToken: string;
+    body: string;
+    businessDomain?: string;
+}
+export declare function createVegaResource(options: CreateVegaResourceOptions): Promise<string>;
+export interface UpdateVegaResourceOptions {
     baseUrl: string;
     accessToken: string;
     id: string;
-    limit?: number;
+    body: string;
+    businessDomain?: string;
+}
+export declare function updateVegaResource(options: UpdateVegaResourceOptions): Promise<string>;
+export interface DeleteVegaResourcesOptions {
+    baseUrl: string;
+    accessToken: string;
+    ids: string;
     businessDomain?: string;
 }
-export declare function previewVegaResource(options: PreviewVegaResourceOptions): Promise<string>;
+export declare function deleteVegaResources(options: DeleteVegaResourcesOptions): Promise<string>;
 export interface ListVegaConnectorTypesOptions {
     baseUrl: string;
     accessToken: string;
@@ -99,6 +135,36 @@ export interface GetVegaConnectorTypeOptions {
     businessDomain?: string;
 }
 export declare function getVegaConnectorType(options: GetVegaConnectorTypeOptions): Promise<string>;
+export interface RegisterVegaConnectorTypeOptions {
+    baseUrl: string;
+    accessToken: string;
+    body: string;
+    businessDomain?: string;
+}
+export declare function registerVegaConnectorType(options: RegisterVegaConnectorTypeOptions): Promise<string>;
+export interface UpdateVegaConnectorTypeOptions {
+    baseUrl: string;
+    accessToken: string;
+    type: string;
+    body: string;
+    businessDomain?: string;
+}
+export declare function updateVegaConnectorType(options: UpdateVegaConnectorTypeOptions): Promise<string>;
+export interface DeleteVegaConnectorTypeOptions {
+    baseUrl: string;
+    accessToken: string;
+    type: string;
+    businessDomain?: string;
+}
+export declare function deleteVegaConnectorType(options: DeleteVegaConnectorTypeOptions): Promise<string>;
+export interface SetVegaConnectorTypeEnabledOptions {
+    baseUrl: string;
+    accessToken: string;
+    type: string;
+    enabled: boolean;
+    businessDomain?: string;
+}
+export declare function setVegaConnectorTypeEnabled(options: SetVegaConnectorTypeEnabledOptions): Promise<string>;
 export interface ListVegaDiscoverTasksOptions {
     baseUrl: string;
     accessToken: string;
@@ -108,3 +174,10 @@ export interface ListVegaDiscoverTasksOptions {
     businessDomain?: string;
 }
 export declare function listVegaDiscoverTasks(options: ListVegaDiscoverTasksOptions): Promise<string>;
+export interface GetVegaDiscoverTaskOptions {
+    baseUrl: string;
+    accessToken: string;
+    id: string;
+    businessDomain?: string;
+}
+export declare function getVegaDiscoverTask(options: GetVegaDiscoverTaskOptions): Promise<string>;

package/dist/api/vega.js

@@ -61,11 +61,52 @@ export async function getVegaCatalog(options) {
     }
     return body;
 }
+export async function createVegaCatalog(options) {
+    const { baseUrl, accessToken, body: requestBody, businessDomain = "bd_public" } = options;
+    const base = baseUrl.replace(/\/+$/, "");
+    const url = `${base}${VEGA_BASE}/catalogs`;
+    const response = await fetch(url, {
+        method: "POST",
+        headers: { ...buildHeaders(accessToken, businessDomain), "content-type": "application/json" },
+        body: requestBody,
+    });
+    const body = await response.text();
+    if (!response.ok)
+        throw new HttpError(response.status, response.statusText, body);
+    return body;
+}
+export async function updateVegaCatalog(options) {
+    const { baseUrl, accessToken, id, body: requestBody, businessDomain = "bd_public" } = options;
+    const base = baseUrl.replace(/\/+$/, "");
+    const url = `${base}${VEGA_BASE}/catalogs/${encodeURIComponent(id)}`;
+    const response = await fetch(url, {
+        method: "PUT",
+        headers: { ...buildHeaders(accessToken, businessDomain), "content-type": "application/json" },
+        body: requestBody,
+    });
+    const body = await response.text();
+    if (!response.ok)
+        throw new HttpError(response.status, response.statusText, body);
+    return body;
+}
+export async function deleteVegaCatalogs(options) {
+    const { baseUrl, accessToken, ids, businessDomain = "bd_public" } = options;
+    const base = baseUrl.replace(/\/+$/, "");
+    const url = `${base}${VEGA_BASE}/catalogs/${ids}`;
+    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 async function vegaCatalogHealthStatus(options) {
     const { baseUrl, accessToken, ids, businessDomain = "bd_public", } = options;
     const base = baseUrl.replace(/\/+$/, "");
-    const url = new URL(`${base}${VEGA_BASE}/catalogs/health-status`);
-    url.searchParams.set("ids", ids);
+    // ids go in the path segment: GET /catalogs/{ids}/health-status
+    const url = new URL(`${base}${VEGA_BASE}/catalogs/${ids}/health-status`);
     const response = await fetch(url.toString(), {
         method: "GET",
         headers: buildHeaders(accessToken, businessDomain),
@@ -189,19 +230,45 @@ export async function queryVegaResourceData(options) {
     }
     return body;
 }
-export async function previewVegaResource(options) {
-    const { baseUrl, accessToken, id, limit = 50, businessDomain = "bd_public", } = options;
+export async function createVegaResource(options) {
+    const { baseUrl, accessToken, body: requestBody, businessDomain = "bd_public" } = options;
     const base = baseUrl.replace(/\/+$/, "");
-    const url = new URL(`${base}${VEGA_BASE}/resources/${encodeURIComponent(id)}/preview`);
-    url.searchParams.set("limit", String(limit));
-    const response = await fetch(url.toString(), {
-        method: "GET",
+    const url = `${base}${VEGA_BASE}/resources`;
+    const response = await fetch(url, {
+        method: "POST",
+        headers: { ...buildHeaders(accessToken, businessDomain), "content-type": "application/json" },
+        body: requestBody,
+    });
+    const body = await response.text();
+    if (!response.ok)
+        throw new HttpError(response.status, response.statusText, body);
+    return body;
+}
+export async function updateVegaResource(options) {
+    const { baseUrl, accessToken, id, body: requestBody, businessDomain = "bd_public" } = options;
+    const base = baseUrl.replace(/\/+$/, "");
+    const url = `${base}${VEGA_BASE}/resources/${encodeURIComponent(id)}`;
+    const response = await fetch(url, {
+        method: "PUT",
+        headers: { ...buildHeaders(accessToken, businessDomain), "content-type": "application/json" },
+        body: requestBody,
+    });
+    const body = await response.text();
+    if (!response.ok)
+        throw new HttpError(response.status, response.statusText, body);
+    return body;
+}
+export async function deleteVegaResources(options) {
+    const { baseUrl, accessToken, ids, businessDomain = "bd_public" } = options;
+    const base = baseUrl.replace(/\/+$/, "");
+    const url = `${base}${VEGA_BASE}/resources/${ids}`;
+    const response = await fetch(url, {
+        method: "DELETE",
         headers: buildHeaders(accessToken, businessDomain),
     });
     const body = await response.text();
-    if (!response.ok) {
+    if (!response.ok)
         throw new HttpError(response.status, response.statusText, body);
-    }
     return body;
 }
 export async function listVegaConnectorTypes(options) {
@@ -232,6 +299,61 @@ export async function getVegaConnectorType(options) {
     }
     return body;
 }
+export async function registerVegaConnectorType(options) {
+    const { baseUrl, accessToken, body: requestBody, businessDomain = "bd_public" } = options;
+    const base = baseUrl.replace(/\/+$/, "");
+    const url = `${base}${VEGA_BASE}/connector-types`;
+    const response = await fetch(url, {
+        method: "POST",
+        headers: { ...buildHeaders(accessToken, businessDomain), "content-type": "application/json" },
+        body: requestBody,
+    });
+    const body = await response.text();
+    if (!response.ok)
+        throw new HttpError(response.status, response.statusText, body);
+    return body;
+}
+export async function updateVegaConnectorType(options) {
+    const { baseUrl, accessToken, type, body: requestBody, businessDomain = "bd_public" } = options;
+    const base = baseUrl.replace(/\/+$/, "");
+    const url = `${base}${VEGA_BASE}/connector-types/${encodeURIComponent(type)}`;
+    const response = await fetch(url, {
+        method: "PUT",
+        headers: { ...buildHeaders(accessToken, businessDomain), "content-type": "application/json" },
+        body: requestBody,
+    });
+    const body = await response.text();
+    if (!response.ok)
+        throw new HttpError(response.status, response.statusText, body);
+    return body;
+}
+export async function deleteVegaConnectorType(options) {
+    const { baseUrl, accessToken, type, businessDomain = "bd_public" } = options;
+    const base = baseUrl.replace(/\/+$/, "");
+    const url = `${base}${VEGA_BASE}/connector-types/${encodeURIComponent(type)}`;
+    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 async function setVegaConnectorTypeEnabled(options) {
+    const { baseUrl, accessToken, type, enabled, businessDomain = "bd_public" } = options;
+    const base = baseUrl.replace(/\/+$/, "");
+    const url = `${base}${VEGA_BASE}/connector-types/${encodeURIComponent(type)}/enabled`;
+    const response = await fetch(url, {
+        method: "POST",
+        headers: { ...buildHeaders(accessToken, businessDomain), "content-type": "application/json" },
+        body: JSON.stringify({ enabled }),
+    });
+    const body = await response.text();
+    if (!response.ok)
+        throw new HttpError(response.status, response.statusText, body);
+    return body;
+}
 export async function listVegaDiscoverTasks(options) {
     const { baseUrl, accessToken, status, limit, offset, businessDomain = "bd_public", } = options;
     const base = baseUrl.replace(/\/+$/, "");
@@ -252,3 +374,16 @@ export async function listVegaDiscoverTasks(options) {
     }
     return body;
 }
+export async function getVegaDiscoverTask(options) {
+    const { baseUrl, accessToken, id, businessDomain = "bd_public" } = options;
+    const base = baseUrl.replace(/\/+$/, "");
+    const url = `${base}${VEGA_BASE}/discover-tasks/${encodeURIComponent(id)}`;
+    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;
+}

package/dist/auth/oauth.d.ts

@@ -60,6 +60,15 @@ export declare function refreshTokenLogin(baseUrl: string, options: {
  * Persists the new token to ~/.kweaver/ and returns it.
  */
 export declare function refreshAccessToken(token: TokenConfig): Promise<TokenConfig>;
+/**
+ * Resolve a usable access token for the current platform.
+ *
+ * **Default behavior** (saved `~/.kweaver/` session from OAuth2 code login): when the access
+ * token is expired or near expiry, automatically exchanges the saved **refresh_token** for a new
+ * access token (OAuth2 `refresh_token` grant) and persists it. No extra flags are required.
+ *
+ * Static env `KWEAVER_TOKEN` bypasses refresh (see implementation).
+ */
 export declare function ensureValidToken(opts?: {
     forceRefresh?: boolean;
 }): Promise<TokenConfig>;

package/dist/auth/oauth.js

@@ -592,6 +592,15 @@ export async function refreshAccessToken(token) {
     saveTokenConfig(newToken);
     return newToken;
 }
+/**
+ * Resolve a usable access token for the current platform.
+ *
+ * **Default behavior** (saved `~/.kweaver/` session from OAuth2 code login): when the access
+ * token is expired or near expiry, automatically exchanges the saved **refresh_token** for a new
+ * access token (OAuth2 `refresh_token` grant) and persists it. No extra flags are required.
+ *
+ * Static env `KWEAVER_TOKEN` bypasses refresh (see implementation).
+ */
 export async function ensureValidToken(opts) {
     const envToken = process.env.KWEAVER_TOKEN;
     const envBaseUrl = process.env.KWEAVER_BASE_URL;

package/dist/cli.js

@@ -77,11 +77,12 @@ Usage:
   kweaver bkn action-log list|get|cancel <kn-id> ...
 
   kweaver config set-bd <value>
+  kweaver config list-bd
   kweaver config show
 
   kweaver vega health|stats|inspect
   kweaver vega catalog list|get|health|test-connection|discover|resources [options]
-  kweaver vega resource list|get|query|preview [options]
+  kweaver vega resource list|get|query [options]
   kweaver vega connector-type list|get [options]
 
   kweaver context-loader config set|use|list|remove|show [options]

package/dist/commands/agent.d.ts

@@ -25,6 +25,11 @@ export interface AgentHistoryOptions {
     pretty: boolean;
 }
 export declare function parseAgentHistoryArgs(args: string[]): AgentHistoryOptions;
+export interface AgentTraceOptions {
+    conversationId: string;
+    pretty: boolean;
+}
+export declare function parseAgentTraceArgs(args: string[]): AgentTraceOptions;
 export declare function runAgentCommand(args: string[]): Promise<number>;
 export interface AgentGetOptions {
     agentId: string;

package/dist/commands/agent.js

@@ -1,7 +1,7 @@
 import { ensureValidToken, formatHttpError, with401RefreshRetry } from "../auth/oauth.js";
 import { runAgentChatCommand } from "./agent-chat.js";
 import { listAgents, getAgent, getAgentByKey, createAgent, updateAgent, deleteAgent, publishAgent, unpublishAgent, } from "../api/agent-list.js";
-import { listConversations, listMessages } from "../api/conversations.js";
+import { listConversations, listMessages, getTracesByConversation } from "../api/conversations.js";
 import { formatCallOutput } from "./call.js";
 import { resolveBusinessDomain } from "../config/store.js";
 function readStringField(value, ...keys) {
@@ -212,6 +212,29 @@ export function parseAgentHistoryArgs(args) {
         businessDomain = resolveBusinessDomain();
     return { conversationId, businessDomain, limit, pretty };
 }
+export function parseAgentTraceArgs(args) {
+    const conversationId = args[0];
+    if (!conversationId || conversationId.startsWith("-")) {
+        throw new Error("Missing conversation_id");
+    }
+    let pretty = true;
+    for (let i = 1; i < args.length; i += 1) {
+        const arg = args[i];
+        if (arg === "--help" || arg === "-h") {
+            throw new Error("help");
+        }
+        if (arg === "--pretty") {
+            pretty = true;
+            continue;
+        }
+        if (arg === "--compact") {
+            pretty = false;
+            continue;
+        }
+        throw new Error(`Unsupported agent trace argument: ${arg}`);
+    }
+    return { conversationId, pretty };
+}
 export async function runAgentCommand(args) {
     const [subcommand, ...rest] = args;
     if (!subcommand || subcommand === "--help" || subcommand === "-h") {
@@ -231,7 +254,8 @@ Subcommands:
   chat <agent_id>                    Start interactive chat with an agent
   chat <agent_id> -m "message"       Send a single message (non-interactive)
   sessions <agent_id>                List all conversations for an agent
-  history <conversation_id>          Show message history for a conversation`);
+  history <conversation_id>          Show message history for a conversation
+  trace <conversation_id>            Get trace data for a conversation`);
         return Promise.resolve(0);
     }
     const dispatch = async () => {
@@ -245,6 +269,8 @@ Subcommands:
             return runAgentSessionsCommand(rest);
         if (subcommand === "history")
             return runAgentHistoryCommand(rest);
+        if (subcommand === "trace")
+            return runAgentTraceCommand(rest);
         if (subcommand === "get-by-key")
             return runAgentGetByKeyCommand(rest);
         if (subcommand === "create")
@@ -345,6 +371,18 @@ Options:
             return 0;
         }
     }
+    if (subcommand === "trace") {
+        if (rest.length === 1 && (rest[0] === "--help" || rest[0] === "-h")) {
+            console.log(`kweaver agent trace <conversation_id> [options]
+
+Get trace data for a conversation.
+
+Options:
+  --pretty                  Pretty-print JSON output (default)
+  --compact                 Compact JSON output`);
+            return 0;
+        }
+    }
     try {
         return await with401RefreshRetry(async () => {
             const code = await dispatch();
@@ -571,6 +609,40 @@ Options:
         return 1;
     }
 }
+async function runAgentTraceCommand(args) {
+    let options;
+    try {
+        options = parseAgentTraceArgs(args);
+    }
+    catch (error) {
+        if (error instanceof Error && error.message === "help") {
+            console.log(`kweaver agent trace <conversation_id> [options]
+
+Get trace data for a conversation.
+
+Options:
+  --pretty                  Pretty-print JSON output (default)
+  --compact                 Compact JSON output`);
+            return 0;
+        }
+        console.error(formatHttpError(error));
+        return 1;
+    }
+    try {
+        const token = await ensureValidToken();
+        const body = await getTracesByConversation({
+            baseUrl: token.baseUrl,
+            accessToken: token.accessToken,
+            conversationId: options.conversationId,
+        });
+        console.log(formatCallOutput(body, options.pretty));
+        return 0;
+    }
+    catch (error) {
+        console.error(formatHttpError(error));
+        return 1;
+    }
+}
 // ── Get by key ───────────────────────────────────────────────────────────────
 async function runAgentGetByKeyCommand(args) {
     const key = args[0];

package/dist/commands/auth.js

@@ -1,4 +1,4 @@
-import { clearPlatformSession, deletePlatform, getConfigDir, getCurrentPlatform, getPlatformAlias, hasPlatform, listPlatforms, loadClientConfig, loadTokenConfig, resolvePlatformIdentifier, setCurrentPlatform, setPlatformAlias, } from "../config/store.js";
+import { autoSelectBusinessDomain, clearPlatformSession, deletePlatform, getConfigDir, getCurrentPlatform, getPlatformAlias, hasPlatform, listPlatforms, loadClientConfig, loadTokenConfig, resolvePlatformIdentifier, setCurrentPlatform, setPlatformAlias, } from "../config/store.js";
 import { buildCopyCommand, formatHttpError, normalizeBaseUrl, oauth2Login, playwrightLogin, refreshTokenLogin, } from "../auth/oauth.js";
 export async function runAuthCommand(args) {
     const target = args[0];
@@ -115,6 +115,10 @@ Login options:
             if (token.expiresAt) {
                 console.log(`Token expires at: ${token.expiresAt}`);
             }
+            const selectedBd = await autoSelectBusinessDomain(normalizedTarget, token.accessToken, {
+                tlsInsecure: token.tlsInsecure,
+            });
+            console.log(`Business domain: ${selectedBd}`);
             return 0;
         }
         catch (error) {