@chatu-ai/builder-sdk 0.8.4 → 0.8.6

package/dist/client.d.ts

@@ -157,7 +157,7 @@ export interface SandboxMeta {
         };
     } | null;
 }
-/** 沙箱启动进度：step 0 调度 1 网络 2 拉镜像 3 启动容器 4 健康检查 5 就绪 */
+/** 沙箱启动进度：step 0 调度 1 网络 2 拉镜像 3 启动容器 4 配置环境 5 恢复数据 6 启动应用 7 就绪 */
 export interface SandboxStartup {
     ok: boolean;
     state?: string;
@@ -165,6 +165,9 @@ export interface SandboxStartup {
     phase?: string | null;
     ready?: boolean;
     containerState?: string | null;
+    /** 编排阶段（Pod Running 之后）：assigning | restoring | starting-devserver | ready | failed */
+    orchestrationPhase?: string | null;
+    phaseMessage?: string | null;
     startedAt?: string | null;
     elapsedMs?: number;
     step?: number;
@@ -536,9 +539,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.4",
+  "version": "0.8.6",
   "description": "ChatU Builder client SDK core: REST + streaming client, zod event schemas, seq resume",
   "license": "MIT",
   "type": "module",