@kweaver-ai/kweaver-sdk 0.4.9 → 0.4.10

package/README.md

@@ -98,7 +98,7 @@ const results = await cl.search({ query: "hypertension treatment" });
 ## CLI Reference
 
 ```
-kweaver auth login/status/list/use/delete/logout
+kweaver auth login <url> [--alias name] [-u user] [-p pass] [--playwright] — also: status, list, use, delete, logout
 kweaver token
 kweaver bkn list/get/stats/export/create/update/delete
 kweaver bkn object-type list/get/create/update/delete/query/properties

package/README.zh.md

@@ -98,7 +98,7 @@ const results = await cl.search({ query: "高血压 治疗" });
 ## 命令速查
 
 ```
-kweaver auth login/status/list/use/delete/logout
+kweaver auth login <url> [--alias name] [-u user] [-p pass] [--playwright] — 另有 status、list、use、delete、logout
 kweaver token
 kweaver bkn list/get/stats/export/create/update/delete
 kweaver bkn object-type list/get/create/update/delete/query/properties

package/dist/cli.js

@@ -33,7 +33,7 @@ Usage:
   kweaver agent get <agent_id> [-bd value] [--pretty]
   kweaver agent get-by-key <key> [-bd value] [--pretty]
   kweaver agent sessions <agent_id> [-bd value] [--limit N] [--pretty]
-  kweaver agent history <agent_id> <session_id> [-bd value] [--limit N] [--pretty]
+  kweaver agent history <conversation_id> [-bd value] [--limit N] [--pretty]
   kweaver agent create [options]
   kweaver agent update <agent_id> [options]
   kweaver agent delete <agent_id> [-bd value]

package/dist/commands/auth.js

@@ -4,19 +4,29 @@ export async function runAuthCommand(args) {
     const target = args[0];
     const rest = args.slice(1);
     if (!target || target === "--help" || target === "-h") {
-        console.log(`kweaver auth login <url>     Login to a platform (browser login)
-kweaver auth <url>           Login (shorthand)
-kweaver auth status [url]    Show current auth status
+        console.log(`kweaver auth login <url> [--alias <name>] [-u user] [-p pass] [--playwright]
+kweaver auth <url>           Login (shorthand; same options as login)
+kweaver auth status [url|alias]
 kweaver auth list            List saved platforms
-kweaver auth use <url>       Switch active platform
-kweaver auth logout [url]    Logout (clear local token)
-kweaver auth delete <url>    Delete saved credentials`);
+kweaver auth use <url|alias> Switch active platform
+kweaver auth logout [url|alias]   Logout (clear local token)
+kweaver auth delete <url|alias>   Delete saved credentials
+
+Login options (browser OAuth2 by default; use -u/-p for headless Playwright):
+  --alias <name>   Short name for this platform (use with auth use / status / logout)
+  -u, --username   Username (with -p triggers Playwright login)
+  -p, --password   Password
+  --playwright     Force browser (Playwright) login even without -u/-p`);
         return 0;
     }
     if (target === "login") {
+        if (rest[0] === "--help" || rest[0] === "-h") {
+            console.log(`kweaver auth login <platform-url> [--alias <name>] [-u user] [-p pass] [--playwright]`);
+            return 0;
+        }
         const url = rest[0];
-        if (!url) {
-            console.error("Usage: kweaver auth login <platform-url>");
+        if (!url || url.startsWith("-")) {
+            console.error("Usage: kweaver auth login <platform-url> [--alias <name>] [-u user] [-p pass] [--playwright]");
             return 1;
         }
         return runAuthCommand([url, ...rest.slice(1)]);
@@ -182,8 +192,8 @@ kweaver auth delete <url>    Delete saved credentials`);
         console.log(`Run \`kweaver auth login ${logoutTarget}\` to sign in again.`);
         return 0;
     }
-    console.error("Usage: kweaver auth login <platform-url>");
-    console.error("       kweaver auth <platform-url> [--alias <name>]");
+    console.error("Usage: kweaver auth login <platform-url> [--alias <name>] [-u user] [-p pass] [--playwright]");
+    console.error("       kweaver auth <platform-url> [--alias <name>] [-u user] [-p pass] [--playwright]");
     console.error("       kweaver auth status [platform-url|alias]");
     console.error("       kweaver auth list");
     console.error("       kweaver auth use <platform-url|alias>");

package/dist/commands/bkn.d.ts

@@ -66,6 +66,14 @@ export interface KnObjectTypeQueryOptions {
 }
 export declare function parseKnObjectTypeQueryArgs(args: string[]): KnObjectTypeQueryOptions;
 export declare function runKnCommand(args: string[]): Promise<number>;
+/** Parse object-type create args: --name --dataview-id --primary-key --display-key [--property '<json>' ...] */
+export declare function parseObjectTypeCreateArgs(args: string[]): {
+    knId: string;
+    body: string;
+    businessDomain: string;
+    branch: string;
+    pretty: boolean;
+};
 /** Fields merged via GET → modify → PUT (not raw body mode). */
 export interface ObjectTypeMergeFields {
     name?: string;
@@ -112,6 +120,14 @@ export interface KnActionTypeExecuteOptions {
     timeout: number;
 }
 export declare function parseKnActionTypeExecuteArgs(args: string[]): KnActionTypeExecuteOptions;
+/** Parse relation-type create args: --name --source --target [--mapping src:tgt ...] */
+export declare function parseRelationTypeCreateArgs(args: string[]): {
+    knId: string;
+    body: string;
+    businessDomain: string;
+    branch: string;
+    pretty: boolean;
+};
 export declare function parseKnBuildArgs(args: string[]): {
     knId: string;
     wait: boolean;

package/dist/commands/bkn.js

@@ -603,8 +603,8 @@ Subcommands:
   update <kn-id> [options]  Update a knowledge network
   delete <kn-id>       Delete a knowledge network
   build <kn-id> [--wait|--no-wait] [--timeout n]   Trigger full build
-  validate <directory>   Validate a local BKN directory (no upload)
-  push <directory> [--branch main]   Upload BKN directory as tar
+  validate <directory> [--detect-encoding|--no-detect-encoding] [--source-encoding n]   Validate local BKN (no upload)
+  push <directory> [--branch main] [--detect-encoding|--no-detect-encoding] [--source-encoding n]   Upload BKN as tar
   pull <kn-id> [<directory>] [--branch main]   Download BKN tar and extract
   export <kn-id>       Export knowledge network (alias for get --export)
   stats <kn-id>        Get statistics (alias for get --stats)
@@ -694,7 +694,7 @@ export async function runKnCommand(args) {
     }
 }
 /** Parse object-type create args: --name --dataview-id --primary-key --display-key [--property '<json>' ...] */
-function parseObjectTypeCreateArgs(args) {
+export function parseObjectTypeCreateArgs(args) {
     let name = "";
     let dataviewId = "";
     let primaryKey = "";
@@ -748,6 +748,7 @@ function parseObjectTypeCreateArgs(args) {
         throw new Error("Usage: kweaver bkn object-type create <kn-id> --name X --dataview-id Y --primary-key Z --display-key W");
     }
     const entry = {
+        branch,
         name,
         data_source: { type: "data_view", id: dataviewId },
         primary_keys: [primaryKey],
@@ -764,7 +765,7 @@ function parseObjectTypeCreateArgs(args) {
             type: "string",
         }));
     }
-    const body = JSON.stringify({ entries: [entry], branch });
+    const body = JSON.stringify({ entries: [entry] });
     if (!businessDomain)
         businessDomain = resolveBusinessDomain();
     return { knId, body, businessDomain, branch, pretty };
@@ -1287,7 +1288,7 @@ kweaver bkn object-type delete <kn-id> <ot-ids> [-y]`);
     }
 }
 /** Parse relation-type create args: --name --source --target [--mapping src:tgt ...] */
-function parseRelationTypeCreateArgs(args) {
+export function parseRelationTypeCreateArgs(args) {
     let name = "";
     let source = "";
     let target = "";
@@ -1341,6 +1342,7 @@ function parseRelationTypeCreateArgs(args) {
         throw new Error("Usage: kweaver bkn relation-type create <kn-id> --name X --source <ot-id> --target <ot-id> [--mapping src:tgt ...]");
     }
     const entry = {
+        branch,
         name,
         source_object_type_id: source,
         target_object_type_id: target,
@@ -1350,7 +1352,7 @@ function parseRelationTypeCreateArgs(args) {
             target_property: { name: t },
         })),
     };
-    const body = JSON.stringify({ entries: [entry], branch });
+    const body = JSON.stringify({ entries: [entry] });
     if (!businessDomain)
         businessDomain = resolveBusinessDomain();
     return { knId, body, businessDomain, branch, pretty };
@@ -2196,6 +2198,7 @@ async function runKnCreateFromDsCommand(args) {
             const pk = detectPrimaryKey(t);
             const dk = detectDisplayKey(t, pk);
             const entry = {
+                branch: "main",
                 name: t.name,
                 data_source: { type: "data_view", id: viewMap[t.name] },
                 primary_keys: [pk],
@@ -2206,7 +2209,7 @@ async function runKnCreateFromDsCommand(args) {
                     type: "string",
                 })),
             };
-            const otBody = JSON.stringify({ entries: [entry], branch: "main" });
+            const otBody = JSON.stringify({ entries: [entry] });
             const otResponse = await createObjectTypes({
                 ...base,
                 knId,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kweaver-ai/kweaver-sdk",
-  "version": "0.4.9",
+  "version": "0.4.10",
   "description": "KWeaver TypeScript SDK — CLI tool and programmatic API for knowledge networks and Decision Agents.",
   "type": "module",
   "main": "./dist/index.js",