@chatu-ai/builder-sdk 0.9.5 → 0.9.7

package/dist/client.d.ts

@@ -315,6 +315,23 @@ export interface BuilderClient {
             state?: SandboxState | string;
         }>;
         /** 一次性预览 token（06 §6.1）：返回可直接作 iframe src 的带 ?t= 的 URL */
+        /** 快照清单（新→旧）：沙箱信息面板展示"有几个快照、多大、什么时候" */
+        snapshots(conversationId: string): Promise<{
+            ok: boolean;
+            error?: string;
+            snapshots: Array<{
+                key: string;
+                bytes: number;
+                createdAt: number;
+            }>;
+        }>;
+        /** 恢复到指定快照（覆盖工作区文件并重启 dev server）；AI 生成中返回 ok:false, error:'BUSY' */
+        restoreSnapshot(conversationId: string, key: string): Promise<{
+            ok: boolean;
+            error?: string;
+            message?: string;
+            key?: string;
+        }>;
         /** port：应用自己起的第二个服务（多端口预览）；不传即 dev server */
         previewToken(conversationId: string, opts?: {
             port?: number | null;
@@ -418,6 +435,15 @@ export interface BuilderClient {
             signal?: AbortSignal;
         }): AsyncIterable<FunctionDeployStreamEvent>;
     };
+    /**
+     * 生成事件里的单条消息全文（技术方案 22 S2）：平台把超大的工具结果改为"预览 + 引用"下发，
+     * 前端展开时用 `chatuRef`（`{xid}/{seq}`）回取完整内容。
+     */
+    runMessage(conversationId: string, xid: string, seq: number): Promise<{
+        ok: boolean;
+        error?: string;
+        message?: Record<string, unknown>;
+    }>;
     /** 沙箱终端（001/09 P2-A）：执行一条命令并流式回输出；AI 生成中会被拒绝（409） */
     exec(conversationId: string, command: string, opts?: {
         timeoutMs?: number;

package/dist/client.js

@@ -57,6 +57,8 @@ export function createBuilderClient(options) {
                 body: JSON.stringify(opts),
             }),
             previewToken: (id, opts) => req(`/${id}/preview-token?${qs({ port: opts?.port ?? undefined })}`),
+            snapshots: id => req(`/sandbox/${id}/snapshots`),
+            restoreSnapshot: (id, key) => req(`/sandbox/${id}/snapshots/restore`, { method: 'POST', headers: { 'content-type': 'application/json' }, body: JSON.stringify({ key }) }),
             wake: id => req(`/sandbox/${id}/wake`, { method: 'POST' }),
             share: (id, ttlHours) => req(`/${id}/preview-share`, { method: 'POST', headers: { 'content-type': 'application/json' }, body: JSON.stringify({ ttlHours }) }),
             revokeShare: (id, token) => req(`/${id}/preview-share/revoke`, { method: 'POST', headers: { 'content-type': 'application/json' }, body: JSON.stringify({ token }) }),
@@ -103,6 +105,7 @@ export function createBuilderClient(options) {
             deployFunctionStream: (id, input, o) => readNamedSse(`${restBase}/${id}/export/deploy-function/stream`, auth.apply({ method: 'POST', headers: { 'content-type': 'application/json', accept: 'text/event-stream' }, body: JSON.stringify(input), signal: o?.signal }), doFetch),
             deployStream: (id, input, o) => readNamedSse(`${restBase}/${id}/export/deploy/stream`, auth.apply({ method: 'POST', headers: { 'content-type': 'application/json', accept: 'text/event-stream' }, body: JSON.stringify(input), signal: o?.signal }), doFetch),
         },
+        runMessage: (id, xid, seq) => req(`/${id}/runs/${encPath(xid)}/messages/${seq}`),
         exec: (id, command, o) => readNamedSse(`${restBase}/${id}/exec/stream`, auth.apply({ method: 'POST', headers: { 'content-type': 'application/json', accept: 'text/event-stream' }, body: JSON.stringify({ command, timeoutMs: o?.timeoutMs }), signal: o?.signal }), doFetch),
         data: {
             access: id => req(`/${id}/data-access`),

package/package.json

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