@kweaver-ai/kweaver-sdk 0.4.1 → 0.4.2

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.2",
   "description": "KWeaver TypeScript SDK — CLI tool and programmatic API for knowledge networks and Decision Agents.",
   "type": "module",
   "main": "./dist/index.js",
@@ -54,6 +54,7 @@
     "typescript": "^5.9.3"
   },
   "dependencies": {
+    "@kweaver-ai/bkn": "^0.1.0",
     "ink": "^6.8.0",
     "ink-spinner": "^5.0.0",
     "ink-text-input": "^6.0.0",