@kweaver-ai/kweaver-sdk 0.4.1 → 0.4.4

package/dist/config/store.d.ts

@@ -1,14 +1,3 @@
-export interface ClientConfig {
-    baseUrl: string;
-    clientId: string;
-    clientSecret: string;
-    redirectUri: string;
-    logoutRedirectUri: string;
-    scope: string;
-    lang?: string;
-    product?: string;
-    xForwardedPrefix?: string;
-}
 export interface TokenConfig {
     baseUrl: string;
     accessToken: string;
@@ -20,14 +9,6 @@ export interface TokenConfig {
     idToken?: string;
     obtainedAt: string;
 }
-export interface CallbackSession {
-    baseUrl: string;
-    redirectUri: string;
-    code: string;
-    state: string;
-    scope?: string;
-    receivedAt: string;
-}
 /** Single context-loader entry (named kn_id). */
 export interface ContextLoaderEntry {
     name: string;
@@ -51,12 +32,8 @@ export declare function setPlatformAlias(baseUrl: string, alias: string): void;
 export declare function deletePlatformAlias(baseUrl: string): void;
 export declare function getPlatformAlias(baseUrl: string): string | null;
 export declare function resolvePlatformIdentifier(value: string): string | null;
-export declare function loadClientConfig(baseUrl?: string): ClientConfig | null;
-export declare function saveClientConfig(config: ClientConfig): void;
 export declare function loadTokenConfig(baseUrl?: string): TokenConfig | null;
 export declare function saveTokenConfig(config: TokenConfig): void;
-export declare function loadCallbackSession(baseUrl?: string): CallbackSession | null;
-export declare function saveCallbackSession(session: CallbackSession): void;
 export declare function loadContextLoaderConfig(baseUrl?: string): ContextLoaderConfig | null;
 export declare function saveContextLoaderConfig(baseUrl: string, config: ContextLoaderConfig): void;
 export interface CurrentContextLoaderKn {
@@ -69,9 +46,19 @@ export declare function setCurrentContextLoader(baseUrl: string, name: string):
 export declare function removeContextLoaderEntry(baseUrl: string, name: string): void;
 export declare function hasPlatform(baseUrl: string): boolean;
 /**
- * Remove token and callback for a platform so the next auth will do a full login.
- * Keeps client config so the same app registration can be reused.
+ * Remove token for a platform so the next auth will do a full login.
  */
 export declare function clearPlatformSession(baseUrl: string): void;
 export declare function deletePlatform(baseUrl: string): void;
 export declare function listPlatforms(): PlatformSummary[];
+/** Per-platform config (not auth — general settings). */
+export interface PlatformConfig {
+    businessDomain?: string;
+}
+export declare function loadPlatformBusinessDomain(baseUrl: string): string | null;
+export declare function savePlatformBusinessDomain(baseUrl: string, businessDomain: string): void;
+/**
+ * Resolve businessDomain: env var > per-platform config > "bd_public".
+ * If baseUrl is omitted, uses the current platform.
+ */
+export declare function resolveBusinessDomain(baseUrl?: string): string;

package/dist/config/store.js

@@ -175,19 +175,6 @@ export function resolvePlatformIdentifier(value) {
     }
     return normalized;
 }
-export function loadClientConfig(baseUrl) {
-    ensureStoreReady();
-    const targetBaseUrl = baseUrl ?? getCurrentPlatform();
-    if (!targetBaseUrl) {
-        return null;
-    }
-    return readJsonFile(getPlatformFile(targetBaseUrl, "client.json"));
-}
-export function saveClientConfig(config) {
-    ensureStoreReady();
-    ensurePlatformDir(config.baseUrl);
-    writeJsonFile(getPlatformFile(config.baseUrl, "client.json"), config);
-}
 export function loadTokenConfig(baseUrl) {
     ensureStoreReady();
     const targetBaseUrl = baseUrl ?? getCurrentPlatform();
@@ -201,19 +188,6 @@ export function saveTokenConfig(config) {
     ensurePlatformDir(config.baseUrl);
     writeJsonFile(getPlatformFile(config.baseUrl, "token.json"), config);
 }
-export function loadCallbackSession(baseUrl) {
-    ensureStoreReady();
-    const targetBaseUrl = baseUrl ?? getCurrentPlatform();
-    if (!targetBaseUrl) {
-        return null;
-    }
-    return readJsonFile(getPlatformFile(targetBaseUrl, "callback.json"));
-}
-export function saveCallbackSession(session) {
-    ensureStoreReady();
-    ensurePlatformDir(session.baseUrl);
-    writeJsonFile(getPlatformFile(session.baseUrl, "callback.json"), session);
-}
 function migrateLegacyContextLoader(raw) {
     const leg = raw;
     if (leg?.knId && !Array.isArray(raw.configs)) {
@@ -258,8 +232,8 @@ export function getCurrentContextLoaderKn(baseUrl) {
     const targetBaseUrl = baseUrl ?? getCurrentPlatform();
     if (!targetBaseUrl)
         return null;
-    const client = loadClientConfig(targetBaseUrl);
-    if (!client?.baseUrl)
+    const token = loadTokenConfig(targetBaseUrl);
+    if (!token?.baseUrl)
         return null;
     const config = loadContextLoaderConfig(targetBaseUrl);
     if (!config)
@@ -268,7 +242,7 @@ export function getCurrentContextLoaderKn(baseUrl) {
     if (!entry)
         return null;
     return {
-        mcpUrl: buildMcpUrl(client.baseUrl),
+        mcpUrl: buildMcpUrl(token.baseUrl),
         knId: entry.knId,
     };
 }
@@ -320,22 +294,17 @@ export function removeContextLoaderEntry(baseUrl, name) {
 }
 export function hasPlatform(baseUrl) {
     ensureStoreReady();
-    return existsSync(getPlatformFile(baseUrl, "client.json"));
+    return existsSync(getPlatformFile(baseUrl, "token.json"));
 }
 /**
- * Remove token and callback for a platform so the next auth will do a full login.
- * Keeps client config so the same app registration can be reused.
+ * Remove token for a platform so the next auth will do a full login.
  */
 export function clearPlatformSession(baseUrl) {
     ensureStoreReady();
     const tokenFile = getPlatformFile(baseUrl, "token.json");
-    const callbackFile = getPlatformFile(baseUrl, "callback.json");
     if (existsSync(tokenFile)) {
         rmSync(tokenFile, { force: true });
     }
-    if (existsSync(callbackFile)) {
-        rmSync(callbackFile, { force: true });
-    }
 }
 export function deletePlatform(baseUrl) {
     ensureStoreReady();
@@ -364,17 +333,49 @@ export function listPlatforms() {
         if (!statSync(dirPath).isDirectory()) {
             continue;
         }
-        const client = readJsonFile(join(dirPath, "client.json"));
-        if (!client?.baseUrl) {
+        const token = readJsonFile(join(dirPath, "token.json"));
+        if (!token?.baseUrl) {
             continue;
         }
         items.push({
-            baseUrl: client.baseUrl,
-            hasToken: existsSync(join(dirPath, "token.json")),
-            isCurrent: client.baseUrl === currentPlatform,
-            alias: getPlatformAlias(client.baseUrl) ?? undefined,
+            baseUrl: token.baseUrl,
+            hasToken: true,
+            isCurrent: token.baseUrl === currentPlatform,
+            alias: getPlatformAlias(token.baseUrl) ?? undefined,
         });
     }
     items.sort((a, b) => a.baseUrl.localeCompare(b.baseUrl));
     return items;
 }
+function loadPlatformConfig(baseUrl) {
+    ensureStoreReady();
+    return readJsonFile(getPlatformFile(baseUrl, "config.json"));
+}
+function savePlatformConfig(baseUrl, config) {
+    ensureStoreReady();
+    ensurePlatformDir(baseUrl);
+    writeJsonFile(getPlatformFile(baseUrl, "config.json"), config);
+}
+export function loadPlatformBusinessDomain(baseUrl) {
+    return loadPlatformConfig(baseUrl)?.businessDomain ?? null;
+}
+export function savePlatformBusinessDomain(baseUrl, businessDomain) {
+    const existing = loadPlatformConfig(baseUrl) ?? {};
+    savePlatformConfig(baseUrl, { ...existing, businessDomain });
+}
+/**
+ * Resolve businessDomain: env var > per-platform config > "bd_public".
+ * If baseUrl is omitted, uses the current platform.
+ */
+export function resolveBusinessDomain(baseUrl) {
+    const fromEnv = process.env.KWEAVER_BUSINESS_DOMAIN;
+    if (fromEnv)
+        return fromEnv;
+    const targetUrl = baseUrl ?? getCurrentPlatform();
+    if (targetUrl) {
+        const fromConfig = loadPlatformBusinessDomain(targetUrl);
+        if (fromConfig)
+            return fromConfig;
+    }
+    return "bd_public";
+}

package/dist/index.d.ts

@@ -31,8 +31,8 @@ export type { OntologyQueryBaseOptions, ObjectTypeQueryOptions, ObjectTypeProper
 export { objectTypeQuery, objectTypeProperties, subgraph, actionTypeQuery, actionTypeExecute, actionExecutionGet, actionLogsList, actionLogGet, actionLogCancel, } from "./api/ontology-query.js";
 export type { SendChatRequestOptions, SendChatRequestStreamCallbacks, ChatResult, ProgressItem, AgentInfo, } from "./api/agent-chat.js";
 export { sendChatRequest, sendChatRequestStream, fetchAgentInfo, buildChatUrl, buildAgentInfoUrl, extractText, } from "./api/agent-chat.js";
-export type { ListAgentsOptions } from "./api/agent-list.js";
-export { listAgents } from "./api/agent-list.js";
+export type { ListAgentsOptions, GetAgentOptions, GetAgentByKeyOptions, CreateAgentOptions, UpdateAgentOptions, DeleteAgentOptions, PublishAgentOptions, UnpublishAgentOptions, } from "./api/agent-list.js";
+export { listAgents, getAgent, getAgentByKey, createAgent, updateAgent, deleteAgent, publishAgent, unpublishAgent, } from "./api/agent-list.js";
 export type { ListConversationsOptions, ListMessagesOptions } from "./api/conversations.js";
 export { listConversations, listMessages } from "./api/conversations.js";
 export type { SemanticSearchOptions } from "./api/semantic-search.js";
@@ -45,9 +45,10 @@ export type { KWeaverClientOptions, ClientContext } from "./client.js";
 export { KWeaverClient } from "./client.js";
 export { KnowledgeNetworksResource } from "./resources/knowledge-networks.js";
 export { AgentsResource } from "./resources/agents.js";
+export type { AgentConfig, AgentInput, AgentInputField, AgentOutput, AgentLlmConfig, AgentLlmItem, CreateAgentBody, UpdateAgentBody, } from "./resources/agents.js";
 export { BknResource } from "./resources/bkn.js";
 export { ConversationsResource } from "./resources/conversations.js";
 export { ContextLoaderResource } from "./resources/context-loader.js";
 export { HttpError, NetworkRequestError, fetchTextOrThrow } from "./utils/http.js";
-export type { ClientConfig, TokenConfig, ContextLoaderEntry, ContextLoaderConfig, PlatformSummary, } from "./config/store.js";
+export type { TokenConfig, ContextLoaderEntry, ContextLoaderConfig, } from "./config/store.js";
 export { getConfigDir, getCurrentPlatform } from "./config/store.js";

package/dist/index.js

@@ -28,7 +28,7 @@
 export { listKnowledgeNetworks, getKnowledgeNetwork, createKnowledgeNetwork, updateKnowledgeNetwork, deleteKnowledgeNetwork, listObjectTypes, listRelationTypes, listActionTypes, } from "./api/knowledge-networks.js";
 export { objectTypeQuery, objectTypeProperties, subgraph, actionTypeQuery, actionTypeExecute, actionExecutionGet, actionLogsList, actionLogGet, actionLogCancel, } from "./api/ontology-query.js";
 export { sendChatRequest, sendChatRequestStream, fetchAgentInfo, buildChatUrl, buildAgentInfoUrl, extractText, } from "./api/agent-chat.js";
-export { listAgents } from "./api/agent-list.js";
+export { listAgents, getAgent, getAgentByKey, createAgent, updateAgent, deleteAgent, publishAgent, unpublishAgent, } from "./api/agent-list.js";
 export { listConversations, listMessages } from "./api/conversations.js";
 export { semanticSearch } from "./api/semantic-search.js";
 export { knSearch, knSchemaSearch, queryObjectInstance, queryInstanceSubgraph, getLogicPropertiesValues, getActionInfo, formatMissingInputParamsHint, validateCondition, validateInstanceIdentity, validateInstanceIdentities, } from "./api/context-loader.js";

package/dist/resources/agents.d.ts

@@ -1,5 +1,76 @@
 import type { ChatResult, SendChatRequestStreamCallbacks } from "../api/agent-chat.js";
 import type { ClientContext } from "../client.js";
+export interface AgentLlmConfig {
+    id?: string;
+    name: string;
+    model_type?: string;
+    temperature?: number;
+    top_p?: number;
+    top_k?: number;
+    frequency_penalty?: number;
+    presence_penalty?: number;
+    max_tokens: number;
+}
+export interface AgentLlmItem {
+    is_default: boolean;
+    llm_config: AgentLlmConfig;
+}
+export interface AgentInputField {
+    name: string;
+    type?: string;
+    desc?: string;
+}
+export interface AgentInput {
+    fields: AgentInputField[];
+    rewrite?: Record<string, unknown>;
+    augment?: Record<string, unknown>;
+}
+export interface AgentOutput {
+    variables?: Record<string, unknown>;
+    default_format?: string;
+}
+export interface AgentConfig {
+    input: AgentInput;
+    output: AgentOutput;
+    system_prompt?: string;
+    dolphin?: string;
+    is_dolphin_mode?: number;
+    data_source?: Record<string, unknown>;
+    skills?: Record<string, unknown>;
+    llms?: AgentLlmItem[];
+    opening_remark_config?: Record<string, unknown>;
+    preset_questions?: Array<{
+        question: string;
+    }>;
+    memory?: {
+        is_enabled: boolean;
+    };
+    related_question?: {
+        is_enabled: boolean;
+    };
+    plan_mode?: {
+        is_enabled: boolean;
+    };
+    conversation_history_config?: Record<string, unknown>;
+    [key: string]: unknown;
+}
+export interface CreateAgentBody {
+    name: string;
+    profile: string;
+    avatar_type?: number;
+    avatar?: string;
+    product_key?: string;
+    key?: string;
+    config: AgentConfig;
+}
+export interface UpdateAgentBody {
+    name: string;
+    profile: string;
+    avatar_type: number;
+    avatar: string;
+    product_key: string;
+    config: AgentConfig;
+}
 export declare class AgentsResource {
     private readonly ctx;
     constructor(ctx: ClientContext);
@@ -9,26 +80,29 @@ export declare class AgentsResource {
         offset?: number;
         limit?: number;
     }): Promise<unknown[]>;
-    /** Resolve agent key and version for a given agent id. */
+    get(agentId: string): Promise<unknown>;
+    getByKey(key: string): Promise<unknown>;
+    create(body: CreateAgentBody): Promise<{
+        id: string;
+        version: string;
+    }>;
+    update(agentId: string, body: UpdateAgentBody): Promise<void>;
+    delete(agentId: string): Promise<void>;
+    publish(agentId: string, opts?: {
+        business_domain_id?: string;
+    }): Promise<unknown>;
+    unpublish(agentId: string): Promise<void>;
     info(agentId: string, version?: string): Promise<{
         id: string;
         key: string;
         version: string;
     }>;
-    /**
-     * Send a single message and return the full response.
-     * Automatically resolves the agent key/version before sending.
-     */
     chat(agentId: string, message: string, opts?: {
         conversationId?: string;
         version?: string;
         stream?: boolean;
         verbose?: boolean;
     }): Promise<ChatResult>;
-    /**
-     * Send a message with streaming callbacks.
-     * Automatically resolves the agent key/version before sending.
-     */
     stream(agentId: string, message: string, callbacks: SendChatRequestStreamCallbacks, opts?: {
         conversationId?: string;
         version?: string;

package/dist/resources/agents.js

@@ -1,10 +1,12 @@
-import { listAgents } from "../api/agent-list.js";
+import { listAgents, getAgent, getAgentByKey, createAgent, updateAgent, deleteAgent, publishAgent, unpublishAgent, } from "../api/agent-list.js";
 import { fetchAgentInfo, sendChatRequest, sendChatRequestStream, } from "../api/agent-chat.js";
+// ── AgentsResource ───────────────────────────────────────────────────────────
 export class AgentsResource {
     ctx;
     constructor(ctx) {
         this.ctx = ctx;
     }
+    // ── List (published agents) ──────────────────────────────────────────────
     async list(opts = {}) {
         const { keyword, ...rest } = opts;
         const raw = await listAgents({ ...this.ctx.base(), name: keyword, ...rest });
@@ -16,15 +18,52 @@ export class AgentsResource {
                 : [];
         return items;
     }
-    /** Resolve agent key and version for a given agent id. */
+    // ── Get by ID ────────────────────────────────────────────────────────────
+    async get(agentId) {
+        const raw = await getAgent({ ...this.ctx.base(), agentId });
+        return JSON.parse(raw);
+    }
+    // ── Get by key ───────────────────────────────────────────────────────────
+    async getByKey(key) {
+        const raw = await getAgentByKey({ ...this.ctx.base(), key });
+        return JSON.parse(raw);
+    }
+    // ── Create ───────────────────────────────────────────────────────────────
+    async create(body) {
+        // Apply defaults for required fields the user may omit
+        const payload = {
+            avatar_type: body.avatar_type ?? 1,
+            avatar: body.avatar ?? "icon-dip-agent-default",
+            product_key: body.product_key ?? "DIP",
+            ...body,
+        };
+        const raw = await createAgent({ ...this.ctx.base(), body: JSON.stringify(payload) });
+        return JSON.parse(raw);
+    }
+    // ── Update ───────────────────────────────────────────────────────────────
+    async update(agentId, body) {
+        await updateAgent({ ...this.ctx.base(), agentId, body: JSON.stringify(body) });
+    }
+    // ── Delete ───────────────────────────────────────────────────────────────
+    async delete(agentId) {
+        await deleteAgent({ ...this.ctx.base(), agentId });
+    }
+    // ── Publish ──────────────────────────────────────────────────────────────
+    async publish(agentId, opts = {}) {
+        const body = JSON.stringify({ agent_id: agentId, ...opts });
+        const raw = await publishAgent({ ...this.ctx.base(), agentId, body });
+        return JSON.parse(raw);
+    }
+    // ── Unpublish ────────────────────────────────────────────────────────────
+    async unpublish(agentId) {
+        await unpublishAgent({ ...this.ctx.base(), agentId });
+    }
+    // ── Agent info (resolve key/version) ─────────────────────────────────────
     async info(agentId, version = "v0") {
         const info = await fetchAgentInfo({ ...this.ctx.base(), agentId, version });
         return info;
     }
-    /**
-     * Send a single message and return the full response.
-     * Automatically resolves the agent key/version before sending.
-     */
+    // ── Chat (single-shot) ──────────────────────────────────────────────────
     async chat(agentId, message, opts = {}) {
         const { version = "v0", stream = false, conversationId, verbose } = opts;
         const info = await fetchAgentInfo({ ...this.ctx.base(), agentId, version });
@@ -39,10 +78,7 @@ export class AgentsResource {
             verbose,
         });
     }
-    /**
-     * Send a message with streaming callbacks.
-     * Automatically resolves the agent key/version before sending.
-     */
+    // ── Stream ──────────────────────────────────────────────────────────────
     async stream(agentId, message, callbacks, opts = {}) {
         const { version = "v0", conversationId, verbose } = opts;
         const info = await fetchAgentInfo({ ...this.ctx.base(), agentId, version });

package/dist/resources/knowledge-networks.js

@@ -8,9 +8,8 @@ export class KnowledgeNetworksResource {
     async list(opts = {}) {
         const raw = await listKnowledgeNetworks({ ...this.ctx.base(), ...opts });
         const parsed = JSON.parse(raw);
-        const data = parsed && typeof parsed === "object" && "data" in parsed
-            ? parsed.data
-            : parsed;
+        // API returns { entries: [...] }
+        const data = parsed?.entries ?? parsed?.data ?? parsed;
         return Array.isArray(data) ? data : [];
     }
     async get(knId, opts = {}) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kweaver-ai/kweaver-sdk",
-  "version": "0.4.1",
+  "version": "0.4.4",
   "description": "KWeaver TypeScript SDK — CLI tool and programmatic API for knowledge networks and Decision Agents.",
   "type": "module",
   "main": "./dist/index.js",
@@ -53,7 +53,16 @@
     "tsx": "^4.20.5",
     "typescript": "^5.9.3"
   },
+  "peerDependencies": {
+    "playwright": ">=1.40.0"
+  },
+  "peerDependenciesMeta": {
+    "playwright": {
+      "optional": true
+    }
+  },
   "dependencies": {
+    "@kweaver-ai/bkn": "^0.1.0",
     "ink": "^6.8.0",
     "ink-spinner": "^5.0.0",
     "ink-text-input": "^6.0.0",