@the-ai-company/cbio-node-runtime 1.72.0 → 1.73.0

package/docs/api/type-aliases/VaultPrincipalKind.md

@@ -1,4 +1,4 @@
-[**CBIO Node Runtime Agent API v1.72.0**](../README.md)
+[**CBIO Node Runtime Agent API v1.73.0**](../README.md)
 
 ***
 

package/docs/api/variables/DEFAULT_VAULT_KEY_CUSTODY_BLOB_KEY.md

@@ -1,4 +1,4 @@
-[**CBIO Node Runtime Agent API v1.72.0**](../README.md)
+[**CBIO Node Runtime Agent API v1.73.0**](../README.md)
 
 ***
 

package/docs/zh/README.md

@@ -1,4 +1,4 @@
-# cbio Vault Runtime（中文文档）
+# cbio Vault Runtime（中文文档 v1.72.0）
 
 cbio Vault Runtime 采用 **Vault（保险箱）** 架构：管理权限扎根于主密码，Agent 身份与机密材料由保险箱加密托管。
 
@@ -8,10 +8,10 @@ cbio Vault Runtime 采用 **Vault（保险箱）** 架构：管理权限扎根
 
 - **库优先**：纯 JavaScript/TypeScript 库，无 CLI 或 TUI。
 - **权限中心化**：管理权限绑定于保险箱主密码，而非外部身份密钥。
+- **统一 ID 架构**：所有标识符（VaultId, SecretId, AgentId）均采用原生字符串管理。
 - **Agent 身份托管**：支持在保险箱内直接生成并加密存储 Agent 私钥。
-- **Agent Session Token**：为 Agent 发放可撤销的 session token，避免在消费进程中持有原始私钥。默认内存实现中，每个 Agent 任意时刻只保留一个当前 token。
-- **进程隔离**：安全进程（Security Process）与 Agent 进程（Consumer Process）物理分离。
-- **零泄露发现**：保险箱元数据全加密，未解锁前对外部完全透明。
+- **Agent Session Token**：为 Agent 发放可撤销的 session token。
+- **环境韧性**：原生支持在无法使用 SQLite 的环境下自动回退至内存模式。
 
 ## 安装
 
@@ -42,57 +42,29 @@ const myVault = await createVault(storage, {
 import { recoverVault } from '@the-ai-company/cbio-node-runtime';
 
 const vault = await recoverVault(storage, {
-  vaultId: myVault.core.vaultId.value,
+  vault_id: myVault.vault_id,
   password: 'your-secure-password'
 });
 ```
 
-### 3. GUI 的 Owner Session
-
-对于 GUI 这类长生命周期进程，应该持有 `OwnerSession`，而不是长期缓存裸 `OwnerClient`。
-
-`createOwnerClient(...)` 只负责基于当前 runtime 创建 owner client；它不应该跨 HMR、模块重载或 runtime 替换被长期复用。`OwnerSession` 会提供稳定的 SDK 句柄，并暴露清晰的读取方法。
-
-```ts
-import { openOwnerSession } from '@the-ai-company/cbio-node-runtime';
-
-const session = openOwnerSession(storage, {
-  vaultId: myVault.core.vaultId.value,
-  password: 'your-secure-password',
-});
-
-const createdAgent = await session.withOwnerClient((client) =>
-  client.ownerCreateAgent({ nickname: '后台处理插件' })
-);
-
-const ownerClient = await session.getOwnerClient();
-const agents = await ownerClient.ownerListAgents();
-// ownerListAgents() 会直接返回每个 agent 当前的 session_token
-
-session.invalidate();
-```
-
-如果你写的是一次性脚本，`recoverVault(...)` 配合 `createOwnerClient(...)` 仍然是合适的。
-
-### 4. 托管 Agent 身份
+### 3. 托管 Agent 身份
 
 ```ts
 import { createOwnerClient } from '@the-ai-company/cbio-node-runtime';
 
-const client = createOwnerClient({
+const client = await createOwnerClient({
   vault: vault.vault,
-  passwordVerifier: vault.verifyPassword,
+  password_verifier: (pwd) => pwd === 'your-secure-password',
 });
 
-const createdAgent = await client.ownerCreateAgent({
+const { agent, session_token } = await client.ownerCreateAgent({
   nickname: '后台处理插件',
 });
 
-const rootAgentId = createdAgent.agent.rootAgentId;
-const sessionToken = createdAgent.sessionToken;
+const root_agent_id = agent.root_agent_id;
 ```
 
-### 5. 机密与授权管理（Grant Model）
+### 4. 机密与授权管理（Grant Model）
 
 v1.65+ 采用了简化的 **Grant（授权）** 模型，通过白名单控制访问：
 
@@ -103,52 +75,45 @@ const record = await client.ownerCreateSecret({
   plaintext: 'secret-value'
 });
 
-// 1b. 批量创建（原子性：全部成功或全部失败）
-await client.ownerCreateSecret([
-  { alias: 'stripe-key', plaintext: 'sk_test_...' },
-  { alias: 'openai-key', plaintext: 'sk-proj-...' }
-]);
-
 // 2. 授权 Agent 使用该机密
 await client.ownerGrantAgentSecret({
-  rootAgentId,
-  secretAlias: 'api-token',
+  root_agent_id,
+  secret_alias: 'api-token',
 });
 
 // 3. 授权该机密可发送至的目标域名
 await client.ownerGrantSecretDestination({
-  secretAlias: 'api-token',
-  siteId: 'api.example.com',
+  secret_alias: 'api-token',
+  site_id: 'api.example.com',
 });
 ```
 
-### 6. Agent 消费机密与自省
+### 5. Agent 消费机密与自省
 
 Agent 使用 `AgentClient` 进行操作，支持 **零配置（Zero-Configuration）** 自省：
 
 ```ts
 import { createAgentClient } from '@the-ai-company/cbio-node-runtime';
 
-const agent = createAgentClient({
-  rootAgentIdentity: { rootAgentId },
-  token: sessionToken.token,
+const agentClient = createAgentClient({
+  agentRecord: agent,
+  token: session_token.token,
   vault: vault.vault
 });
 
 // 执行机密驱动的请求
-const result = await agent.agentDispatch({ 
-  targetUrl: 'https://api.example.com/data',
+const result = await agentClient.agentDispatch({ 
+  target_url: 'https://api.example.com/data',
   method: 'POST',
   reason: '同步业务数据' 
 });
 
 // 自省：查看自己的身份、权限和可用工具
-const manifest = await agent.agentGetRuntimeManifest();
-console.log(manifest.agent.nickname);
-console.log(manifest.grants.agentSecrets); // 已获得的机密授权
+const manifest = await agentClient.agentIntrospect();
+console.log(manifest.nickname);
 ```
 
-### 7. 人机协同（HITL）与语义化审计
+### 6. 人机协同（HITL）与事实审计
 
 如果 Agent 尝试的请求未获授权，`agentDispatch` 会返回 `AWAITING_APPROVAL` 状态，进入人工审批流。
 
@@ -160,19 +125,21 @@ const unsubscribe = client.ownerOnPendingDispatch({
 });
 
 // 审批待处理的请求
-const pending = await client.ownerListRequests({ root_agent_id: rootAgentId });
-if (pending.length > 0) {
+const pending = await client.ownerListRequests();
+const awaitingApproval = pending.filter(r => r.execution.status === "AWAITING_APPROVAL");
+
+if (awaitingApproval.length > 0) {
   await client.ownerApproveDispatch({
-    request_id: pending[0].request_id,
+    request_id: awaitingApproval[0].request_id,
     decision: "allow_and_grant", // 允许执行并自动补齐缺少的授权
   });
 }
 
 unsubscribe();
 
-// 查看语义化审计日志
+// 查看基于事实的审计日志
 const logs = await client.ownerReadAudit({ 
-  action: 'APPROVE_DISPATCH' // 使用业务感知的语义化动作进行查询
+  query: { root_agent_id } 
 });
 ```
 
@@ -188,5 +155,5 @@ const logs = await client.ownerReadAudit({
 
 1. **机密隔离**：机密明文绝不离开安全进程。
 2. **密码即权限**：主密码是唯一的管理授权来源。
-3. **语义化审计**：所有操作均记录为具有业务含义的动作（如 `APPROVE_DISPATCH`），而非底层技术术语。
-4. **二元状态**：保险箱要么被解锁并可见，要么只是磁盘上一组加密碎片。
+3. **基于事实的审计**：记录具体的函数调用与参数（如 `ownerApproveDispatch`），而非模糊的分类。
+4. **统一 ID 架构**：全系统采用 raw string ID，消除冗余包装。

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@the-ai-company/cbio-node-runtime",
-  "version": "1.72.0",
+  "version": "1.73.0",
   "publishConfig": {
     "access": "public"
   },

package/docs/api/enumerations/AuditOperation.md

@@ -1,107 +0,0 @@
-[**CBIO Node Runtime Agent API v1.72.0**](../README.md)
-
-***
-
-# Enumeration: AuditOperation
-
-## Enumeration Members
-
-### DISPATCH\_APPROVE
-
-> **DISPATCH\_APPROVE**: `"dispatch.approve"`
-
-***
-
-### DISPATCH\_HOLD
-
-> **DISPATCH\_HOLD**: `"dispatch.pending_approval"`
-
-***
-
-### DISPATCH\_REJECT
-
-> **DISPATCH\_REJECT**: `"dispatch.reject"`
-
-***
-
-### GRANT\_DESTINATION
-
-> **GRANT\_DESTINATION**: `"grant.grant_destination"`
-
-***
-
-### GRANT\_SECRET
-
-> **GRANT\_SECRET**: `"grant.grant_secret"`
-
-***
-
-### IDENTITY\_ISSUE\_TOKEN
-
-> **IDENTITY\_ISSUE\_TOKEN**: `"identity.issue_token"`
-
-***
-
-### IDENTITY\_REGISTER
-
-> **IDENTITY\_REGISTER**: `"identity.register"`
-
-***
-
-### IDENTITY\_REVOKE\_TOKEN
-
-> **IDENTITY\_REVOKE\_TOKEN**: `"identity.revoke_token"`
-
-***
-
-### IDENTITY\_UPDATE
-
-> **IDENTITY\_UPDATE**: `"identity.update"`
-
-***
-
-### POLICY\_EVALUATE
-
-> **POLICY\_EVALUATE**: `"policy.evaluate_dispatch"`
-
-***
-
-### REVOKE\_DESTINATION
-
-> **REVOKE\_DESTINATION**: `"grant.revoke_destination"`
-
-***
-
-### REVOKE\_SECRET
-
-> **REVOKE\_SECRET**: `"grant.revoke_secret"`
-
-***
-
-### SECRET\_BATCH\_EXPORT
-
-> **SECRET\_BATCH\_EXPORT**: `"secret.batch_export"`
-
-***
-
-### SECRET\_DELETE
-
-> **SECRET\_DELETE**: `"secret.delete"`
-
-***
-
-### SECRET\_DISPATCH
-
-> **SECRET\_DISPATCH**: `"secret.dispatch"`
-
-***
-
-### SECRET\_EXPORT
-
-> **SECRET\_EXPORT**: `"secret.export"`
-
-***
-
-### SECRET\_WRITE
-
-> **SECRET\_WRITE**: `"secret.write"`

package/docs/api/interfaces/AgentVisibleRequestRecord.md

@@ -1,59 +0,0 @@
-[**CBIO Node Runtime Agent API v1.72.0**](../README.md)
-
-***
-
-# Interface: AgentVisibleRequestRecord
-
-## Properties
-
-### created\_at
-
-> **created\_at**: `string`
-
-***
-
-### error?
-
-> `optional` **error?**: `string`
-
-***
-
-### execution\_status
-
-> **execution\_status**: [`DispatchStatus`](../enumerations/DispatchStatus.md)
-
-***
-
-### has\_response\_body
-
-> **has\_response\_body**: `boolean`
-
-***
-
-### reason
-
-> **reason**: `string`
-
-***
-
-### request\_id
-
-> **request\_id**: `string`
-
-***
-
-### response\_status?
-
-> `optional` **response\_status?**: `number`
-
-***
-
-### secret\_id?
-
-> `optional` **secret\_id?**: [`SecretId`](SecretId.md)
-
-***
-
-### target\_url
-
-> **target\_url**: `string`

package/docs/api/interfaces/AgentVisibleSecretRecord.md

@@ -1,65 +0,0 @@
-[**CBIO Node Runtime Agent API v1.72.0**](../README.md)
-
-***
-
-# Interface: AgentVisibleSecretRecord
-
-## Properties
-
-### alias
-
-> **alias**: [`SecretAlias`](SecretAlias.md)
-
-***
-
-### created\_at
-
-> **created\_at**: `string`
-
-***
-
-### granted
-
-> **granted**: `boolean`
-
-***
-
-### issuer\_id
-
-> **issuer\_id**: `string` \| `null`
-
-***
-
-### lifecycle\_status
-
-> **lifecycle\_status**: [`SecretLifecycleStatus`](../type-aliases/SecretLifecycleStatus.md)
-
-***
-
-### secret\_id
-
-> **secret\_id**: [`SecretId`](SecretId.md)
-
-***
-
-### source
-
-> **source**: `SecretSource`
-
-***
-
-### updated\_at
-
-> **updated\_at**: `string`
-
-***
-
-### vault\_id
-
-> **vault\_id**: [`VaultId`](VaultId.md)
-
-***
-
-### version
-
-> **version**: `SecretVersion`

package/docs/api/interfaces/OwnerVisibleRequestRecord.md

@@ -1,79 +0,0 @@
-[**CBIO Node Runtime Agent API v1.72.0**](../README.md)
-
-***
-
-# Interface: OwnerVisibleRequestRecord
-
-## Properties
-
-### created\_at
-
-> **created\_at**: `string`
-
-***
-
-### error?
-
-> `optional` **error?**: `string`
-
-***
-
-### execution\_status
-
-> **execution\_status**: [`DispatchStatus`](../enumerations/DispatchStatus.md)
-
-***
-
-### has\_response\_body
-
-> **has\_response\_body**: `boolean`
-
-***
-
-### missing\_grants?
-
-> `optional` **missing\_grants?**: `object`
-
-#### agent\_secret?
-
-> `optional` **agent\_secret?**: `boolean`
-
-#### secret\_destination?
-
-> `optional` **secret\_destination?**: `boolean`
-
-***
-
-### reason
-
-> **reason**: `string`
-
-***
-
-### request\_id
-
-> **request\_id**: `string`
-
-***
-
-### response\_status?
-
-> `optional` **response\_status?**: `number`
-
-***
-
-### root\_agent\_id
-
-> **root\_agent\_id**: `string`
-
-***
-
-### secret\_id?
-
-> `optional` **secret\_id?**: [`SecretId`](SecretId.md)
-
-***
-
-### target\_url
-
-> **target\_url**: `string`

package/docs/api/interfaces/SecretAlias.md

@@ -1,11 +0,0 @@
-[**CBIO Node Runtime Agent API v1.72.0**](../README.md)
-
-***
-
-# Interface: SecretAlias
-
-## Properties
-
-### value
-
-> `readonly` **value**: `string`

package/docs/api/interfaces/SecretId.md

@@ -1,11 +0,0 @@
-[**CBIO Node Runtime Agent API v1.72.0**](../README.md)
-
-***
-
-# Interface: SecretId
-
-## Properties
-
-### value
-
-> `readonly` **value**: `string`

package/docs/api/interfaces/VaultId.md

@@ -1,11 +0,0 @@
-[**CBIO Node Runtime Agent API v1.72.0**](../README.md)
-
-***
-
-# Interface: VaultId
-
-## Properties
-
-### value
-
-> `readonly` **value**: `string`