@chatu-ai/builder-sdk 0.8.1 → 0.8.3

package/dist/client.d.ts

@@ -116,6 +116,47 @@ 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;
+        /** 空闲多久自动休眠（秒，按机型） */
+        idleTtlSeconds?: number;
+        /** 预计自动休眠时间（最近活跃 + TTL）；生成中不会被回收，仅为预计值 */
+        hibernateAt?: 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 +292,8 @@ export interface BuilderClient {
             ok: boolean;
             state?: string;
         }>;
+        /** 沙箱诊断信息：编排侧（状态/Pod/机型/时间/快照）+ runtime（版本/Node/Skills/CLI）+ 平台配置镜像 */
+        meta(conversationId: string): Promise<SandboxMeta>;
     };
     versions: {
         list(conversationId: string, opts?: {

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 透传）

package/package.json

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