@chatu-ai/builder-sdk 0.8.2 → 0.8.4

package/dist/client.d.ts

@@ -127,6 +127,10 @@ export interface SandboxMeta {
         createdAt?: string | null;
         lastActivity?: string | null;
         lastAgentActivity?: string | null;
+        /** 空闲多久自动休眠（秒，按机型） */
+        idleTtlSeconds?: number;
+        /** 预计自动休眠时间（最近活跃 + TTL）；生成中不会被回收，仅为预计值 */
+        hibernateAt?: string | null;
         hasSnapshot?: boolean;
         snapshotKey?: string | null;
     };
@@ -153,6 +157,28 @@ export interface SandboxMeta {
         };
     } | null;
 }
+/** 沙箱启动进度：step 0 调度 1 网络 2 拉镜像 3 启动容器 4 健康检查 5 就绪 */
+export interface SandboxStartup {
+    ok: boolean;
+    state?: string;
+    exists?: boolean;
+    phase?: string | null;
+    ready?: boolean;
+    containerState?: string | null;
+    startedAt?: string | null;
+    elapsedMs?: number;
+    step?: number;
+    percent?: number;
+    etaSeconds?: number;
+    detail?: string | null;
+    events?: Array<{
+        type: string;
+        reason: string;
+        message: string;
+        time?: string | null;
+        count?: number;
+    }>;
+}
 export type FunctionProvider = 'aliyun-fc' | 'tencent-scf' | 'volc-vefaas';
 /** 函数计算部署（技术方案 17）：凭据二选一 credentialId（凭据库 aliyun/tencent/volcengine）或 accessKeyId+accessKeySecret */
 export interface FunctionDeployInput {
@@ -290,6 +316,8 @@ export interface BuilderClient {
         }>;
         /** 沙箱诊断信息：编排侧（状态/Pod/机型/时间/快照）+ runtime（版本/Node/Skills/CLI）+ 平台配置镜像 */
         meta(conversationId: string): Promise<SandboxMeta>;
+        /** 启动进度（Pod 事件推导）：沙箱创建/恢复期间轮询展示 */
+        startup(conversationId: string): Promise<SandboxStartup>;
     };
     versions: {
         list(conversationId: string, opts?: {

package/dist/client.js

@@ -64,6 +64,7 @@ export function createBuilderClient(options) {
             hibernate: id => req(`/sandbox/${id}/hibernate`, { method: 'POST' }),
             terminate: id => req(`/sandbox/${id}/terminate`, { method: 'POST' }),
             meta: id => req(`/sandbox/${id}/meta`),
+            startup: id => req(`/sandbox/${id}/startup`),
         },
         versions: {
             // 服务端形状：{ versions: VersionInfo[] }（runtime 透传）

package/package.json

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