@openbkn/bkn-sdk - npm Package Compare versions

Comparing version 0.1.3 to 0.1.4

dist/index.js

@@ -8,2 +8,3 @@ import {
   ManagedTrace,
+  NonJsonResponseError,
   ToolError,
@@ -15,5 +16,5 @@ admin,
   createClient,
-  dataflows,
   kn,
   models,
+  parseBigIntJSON,
   releaseLifecycleSessions,
@@ -24,2 +25,3 @@ request,
   skills,
+  stringifyBigIntJSON,
   toolboxes,
@@ -29,3 +31,3 @@ trace,
   vega
-} from "./chunk-PC2F54XD.js";
+} from "./chunk-Z2NRTUB3.js";
 export {
@@ -38,2 +40,3 @@ DEFAULT_BUSINESS_DOMAIN,
   ManagedTrace,
+  NonJsonResponseError,
   ToolError,
@@ -45,5 +48,5 @@ admin,
   createClient,
-  dataflows,
   kn,
   models,
+  parseBigIntJSON,
   releaseLifecycleSessions,
@@ -54,2 +57,3 @@ request,
   skills,
+  stringifyBigIntJSON,
   toolboxes,
@@ -56,0 +60,0 @@ trace,

package.json

 {
   "name": "@openbkn/bkn-sdk",
-  "version": "0.1.3",
+  "version": "0.1.4",
   "description": "Unified TypeScript SDK + CLI for the BKN (Business Knowledge Network) platform.",
@@ -8,3 +8,3 @@ "type": "module",
   "engines": {
-    "node": ">=22.19.0"
+    "node": ">=24.19.0"
   },
@@ -40,2 +40,5 @@ "bin": {
     "test:e2e:trace-business": "npm run build && node test/e2e/bkn-trace-business-interaction.mjs",
+    "test:e2e:smoke": "npm run build && test/e2e/live-smoke.sh",
+    "test:e2e:suite": "npm run build && test/e2e/live-suite.sh",
+    "test:e2e:write": "npm run build && test/e2e/live-write.sh",
     "test:cover": "vitest run --coverage",
@@ -58,3 +61,3 @@ "ci": "npm run lint && npm test",
     "@types/js-yaml": "^4.0.9",
-    "@types/node": "^22.13.0",
+    "@types/node": "^24.0.0",
     "tsup": "^8.4.0",
@@ -61,0 +64,0 @@ "typescript": "^5.8.0",

README.md

@@ -23,3 +23,3 @@ # @openbkn/bkn-sdk
 
-Requires Node ≥ 22.19.
+Requires Node ≥ 24.19.0.
 
@@ -42,3 +42,2 @@ ## CLI
 openbkn vega catalog list
-openbkn dataflow list
 openbkn model llm list
@@ -59,5 +58,12 @@
 #               --conversation-id/--interaction-id (BKN Trace correlation; also BKN_CONVERSATION_ID/BKN_INTERACTION_ID)
+#               --new-conversation (ignore the remembered conversation for this command)
 openbkn --help        # grouped command map
 ```
 
+On a `managed-v2` deploy, commands continue the conversation the previous one
+opened, so work spanning several commands lands in one thread. `openbkn context conversation` shows which
+is in force and where it came from; `--forget` drops it. An explicit `--token` /
+`BKN_TOKEN` opts out (identity there is the token, not the stored user) — use
+`BKN_CONVERSATION_ID` to thread such a script's commands together.
+
 Tokens are stored per platform/user under `~/.bkn/` (override: `BKN_CONFIG_DIR`).
@@ -79,2 +85,6 @@
 
+Dynamic-data responses (including Vega and ontology queries) may contain native
+`bigint` values for integers outside JavaScript's safe range. Serialize such a result with the exported
+`stringifyBigIntJSON()` helper instead of native `JSON.stringify()`.
+
 ## Develop
@@ -101,3 +111,3 @@
 command-group map, examples, and cautions) plus per-domain cheat sheets under
-`references/` (auth, bkn, agent, model, vega, resource, dataflow, context,
+`references/` (auth, bkn, agent, model, vega, resource, context,
 skill, toolbox, trace, admin, call) and two how-tos (build-a-KN, troubleshooting).
@@ -104,0 +114,0 @@

README.zh.md

@@ -18,3 +18,3 @@ # @openbkn/bkn-sdk
 
-需要 Node ≥ 22.19。
+需要 Node ≥ 24.19.0。
 
@@ -36,3 +36,2 @@ ## CLI
 openbkn vega catalog list
-openbkn dataflow list
 openbkn model llm list
@@ -53,5 +52,11 @@
 #           --conversation-id/--interaction-id（BKN Trace 关联，等价 env：BKN_CONVERSATION_ID/BKN_INTERACTION_ID）
+#           --new-conversation（这条命令不沿用记住的 conversation）
 openbkn --help        # 分组命令树
 ```
 
+`managed-v2` 部署上，命令会接着上一条开的 conversation，跨命令的一件事因此落在同一个线程里。
+`openbkn context conversation` 显示当前生效的是哪个、来自哪一层；`--forget` 丢掉它。
+显式 `--token` / `BKN_TOKEN` 不参与（那里的身份是 token 本身，不是存下来的用户）——
+这类脚本用 `BKN_CONVERSATION_ID` 把多条命令串起来。
+
 Token 按平台/用户存于 `~/.bkn/`（可用 `BKN_CONFIG_DIR` 覆盖）。
@@ -73,2 +78,6 @@
 
+Vega 和本体查询等动态数据响应中，超出 JavaScript 安全整数范围的值可能是原生 `bigint`。
+序列化这类结果时，请使用导出的 `stringifyBigIntJSON()`，不要使用原生
+`JSON.stringify()`。
+
 ## 开发
@@ -75,0 +84,0 @@

New alerts

AI-detected potential security risk

Supply chain risk

AI has determined that this package may contain potential security issues or vulnerabilities.

Major refactor

Supply chain risk

Package has recently undergone a major refactor. It may be unstable or indicate significant internal changes. Use caution when updating to versions that include significant changes.

Filesystem access

Supply chain risk

Accesses the file system, and could potentially read sensitive data.

URL strings

Supply chain risk

Package contains fragments of external URLs or IP addresses, which the package may be accessing at runtime.

Fixed alerts

Filesystem access

Supply chain risk

Accesses the file system, and could potentially read sensitive data.

Found 2 instances

AI-detected potential code anomaly

Supply chain risk

AI has identified unusual behaviors that may pose a security risk.

URL strings

Supply chain risk

Package contains fragments of external URLs or IP addresses, which the package may be accessing at runtime.

Improved metrics

Total package byte prevSize

876763

61.21%

Lines of code

20318

50.73%

Number of lines in readme file

137

7.87%

Worsened metrics

Number of medium supply chain risk alerts

8

33.33%

No dependency changes