@chatu-ai/builder-sdk 0.8.0 → 0.8.2

package/dist/client.d.ts

@@ -116,6 +116,43 @@ export interface DataUsage {
     rates?: Record<string, number>;
     error?: string;
 }
+/** 沙箱诊断信息（技术方案 08）：用于判断 Pod 是否已使用最新镜像、是否加载了预期能力 */
+export interface SandboxMeta {
+    ok: boolean;
+    sandbox?: {
+        sandboxId?: string;
+        state?: string;
+        podName?: string | null;
+        machineType?: string | null;
+        createdAt?: string | null;
+        lastActivity?: string | null;
+        lastAgentActivity?: string | null;
+        hasSnapshot?: boolean;
+        snapshotKey?: string | null;
+    };
+    /** 平台当前配置的 Builder 镜像（与 runtime.version 对照可判断 Pod 是否为最新） */
+    configuredImage?: string | null;
+    runtime?: {
+        ok?: boolean;
+        error?: string;
+        message?: string;
+        version?: string | null;
+        image?: string | null;
+        node?: string;
+        startedAt?: string;
+        uptimeMs?: number;
+        workspaceDir?: string;
+        appSdkVersion?: string | null;
+        skills?: string[];
+        clis?: Record<string, string | null>;
+        devServer?: Record<string, unknown>;
+        agent?: {
+            executing?: boolean;
+            xid?: string | null;
+            sinceMs?: number | null;
+        };
+    } | null;
+}
 export type FunctionProvider = 'aliyun-fc' | 'tencent-scf' | 'volc-vefaas';
 /** 函数计算部署（技术方案 17）：凭据二选一 credentialId（凭据库 aliyun/tencent/volcengine）或 accessKeyId+accessKeySecret */
 export interface FunctionDeployInput {
@@ -251,6 +288,8 @@ export interface BuilderClient {
             ok: boolean;
             state?: string;
         }>;
+        /** 沙箱诊断信息：编排侧（状态/Pod/机型/时间/快照）+ runtime（版本/Node/Skills/CLI）+ 平台配置镜像 */
+        meta(conversationId: string): Promise<SandboxMeta>;
     };
     versions: {
         list(conversationId: string, opts?: {
@@ -353,6 +392,40 @@ export interface BuilderClient {
                 removed?: boolean;
             }>;
         };
+        /** 资源面板：文档集合浏览（技术方案 19） */
+        db: {
+            collections(conversationId: string, env?: 'dev' | 'prod'): Promise<{
+                ok: boolean;
+                collections: Array<{
+                    name: string;
+                    count: number;
+                }>;
+            }>;
+            query(conversationId: string, collection: string, opts?: {
+                env?: 'dev' | 'prod';
+                filter?: Record<string, unknown>;
+                sort?: Record<string, 1 | -1>;
+                skip?: number;
+                limit?: number;
+            }): Promise<{
+                ok: boolean;
+                docs: Array<Record<string, unknown>>;
+                total: number;
+                nextSkip: number | null;
+            }>;
+            replace(conversationId: string, collection: string, id: string, doc: Record<string, unknown>, env?: 'dev' | 'prod'): Promise<{
+                ok: boolean;
+                doc?: Record<string, unknown>;
+            }>;
+            remove(conversationId: string, collection: string, id: string, env?: 'dev' | 'prod'): Promise<{
+                ok: boolean;
+                removed?: boolean;
+            }>;
+            drop(conversationId: string, collection: string, env?: 'dev' | 'prod'): Promise<{
+                ok: boolean;
+                dropped?: boolean;
+            }>;
+        };
         /** 资源面板：对象存储浏览 */
         storage: {
             list(conversationId: string, opts?: {
@@ -400,6 +473,7 @@ export interface BuilderClient {
             overwrite?: boolean;
             kv?: boolean;
             storage?: boolean;
+            db?: boolean;
         }): Promise<{
             ok: boolean;
             error?: string;
@@ -412,6 +486,10 @@ export interface BuilderClient {
                 skipped: number;
                 bytes: number;
             } | null;
+            db?: {
+                copied: number;
+                skipped: number;
+            } | null;
         }>;
         /** 导出数据：KV 键值 + 对象清单（1 小时下载地址） */
         export(conversationId: string, env?: 'dev' | 'prod'): Promise<{

package/dist/client.js

@@ -63,6 +63,7 @@ export function createBuilderClient(options) {
             restartDevServer: (id, opts) => req(`/${id}/devserver/restart?clean=${opts?.clean ? 'true' : 'false'}`, { method: 'POST' }),
             hibernate: id => req(`/sandbox/${id}/hibernate`, { method: 'POST' }),
             terminate: id => req(`/sandbox/${id}/terminate`, { method: 'POST' }),
+            meta: id => req(`/sandbox/${id}/meta`),
         },
         versions: {
             // 服务端形状：{ versions: VersionInfo[] }（runtime 透传）
@@ -110,6 +111,13 @@ export function createBuilderClient(options) {
                 set: (id, key, value, o) => req(`/${id}/data/kv/${encPath(key)}?${qs({ env: o?.env })}`, { method: 'PUT', headers: { 'content-type': 'application/json' }, body: JSON.stringify({ value, ex: o?.ex }) }),
                 remove: (id, key, env) => req(`/${id}/data/kv/${encPath(key)}?${qs({ env })}`, { method: 'DELETE' }),
             },
+            db: {
+                collections: (id, env) => req(`/${id}/data/db?${qs({ env })}`),
+                query: (id, coll, o) => req(`/${id}/data/db/${encPath(coll)}/query?${qs({ env: o?.env })}`, { method: 'POST', headers: { 'content-type': 'application/json' }, body: JSON.stringify({ filter: o?.filter, sort: o?.sort, skip: o?.skip, limit: o?.limit }) }),
+                replace: (id, coll, docId, doc, env) => req(`/${id}/data/db/${encPath(coll)}/${encPath(docId)}?${qs({ env })}`, { method: 'PUT', headers: { 'content-type': 'application/json' }, body: JSON.stringify(doc) }),
+                remove: (id, coll, docId, env) => req(`/${id}/data/db/${encPath(coll)}/${encPath(docId)}?${qs({ env })}`, { method: 'DELETE' }),
+                drop: (id, coll, env) => req(`/${id}/data/db/${encPath(coll)}?${qs({ env })}`, { method: 'DELETE' }),
+            },
             storage: {
                 list: (id, o) => req(`/${id}/data/storage?${qs({ env: o?.env, prefix: o?.prefix, cursor: o?.cursor ?? undefined, limit: o?.limit })}`),
                 sign: (id, key, o) => req(`/${id}/data/storage/sign?${qs({ env: o?.env })}`, { method: 'POST', headers: { 'content-type': 'application/json' }, body: JSON.stringify({ key, expiresIn: o?.expiresIn, downloadName: o?.downloadName }) }),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@chatu-ai/builder-sdk",
-  "version": "0.8.0",
+  "version": "0.8.2",
   "description": "ChatU Builder client SDK core: REST + streaming client, zod event schemas, seq resume",
   "license": "MIT",
   "type": "module",