@chatu-ai/builder-sdk 0.8.5 → 0.8.7

package/dist/client.d.ts

@@ -45,6 +45,11 @@ export interface SandboxStatus {
         xid?: string | null;
         sinceMs?: number | null;
     } | null;
+    /** 关闭过程中（休眠/强制关闭，Pod 尚未真正释放）：此时不应唤醒，前端显示"关闭中" */
+    closing?: boolean;
+    /** 编排阶段：creating-pod|assigning|restoring|starting-devserver|ready|hibernating|releasing|terminating|hibernated|recycled|failed */
+    phase?: string | null;
+    phaseMessage?: string | null;
 }
 export interface VersionInfo {
     sha: string;
@@ -539,9 +544,17 @@ export interface BuilderClient {
         }>;
     };
     logs: {
-        /** dev server 最近日志（沙箱未运行返回空） */
-        tail(conversationId: string, lines?: number): Promise<{
+        /**
+         * dev server 日志（沙箱未运行时读落盘快照）。
+         * 传 `since`（上次返回的 nextSeq）只取新增行；`truncated=true` 表示需整体替换（首次/缓冲区已滚动/来自快照）。
+         */
+        tail(conversationId: string, lines?: number, opts?: {
+            since?: number | null;
+        }): Promise<{
             lines: string[];
+            nextSeq?: number | null;
+            truncated?: boolean;
+            source?: string;
         }>;
     };
     export: {

package/dist/client.js

@@ -129,9 +129,13 @@ export function createBuilderClient(options) {
             export: (id, env) => req(`/${id}/data/export?env=${env ?? 'prod'}`),
         },
         logs: {
-            tail: async (id, lines) => {
-                const r = await req(`/${id}/logs?tail=${lines ?? 200}`);
-                return { lines: Array.isArray(r) ? r : (r.lines ?? []) };
+            tail: async (id, lines, opts) => {
+                const since = opts?.since;
+                const q = `tail=${lines ?? 200}${since === undefined || since === null ? '' : `&since=${since}`}`;
+                const r = await req(`/${id}/logs?${q}`);
+                if (Array.isArray(r))
+                    return { lines: r, truncated: true };
+                return { lines: r.lines ?? [], nextSeq: r.nextSeq ?? null, truncated: r.truncated ?? since === undefined, source: r.source };
             },
         },
         export: {

package/package.json

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