@chatu-ai/builder-sdk 0.5.0 → 0.6.1

package/dist/client.d.ts

@@ -32,10 +32,13 @@ export interface BuilderClientOptions {
 export interface SandboxStatus {
     state: SandboxState;
     previewUrl?: string;
+    /** dev server：running 且 !ready = 首屏编译中（1c 机型冷启动可能 1–2 分钟） */
     devServer?: {
         running: boolean;
-        lastError?: string;
-    };
+        ready?: boolean;
+        startingForMs?: number | null;
+        lastError?: string | null;
+    } | null;
 }
 export interface VersionInfo {
     sha: string;
@@ -207,6 +210,76 @@ export interface BuilderClient {
         }>;
         /** 本月用量：dev/prod 原始计量与折算点数估算、只读状态、单价 */
         usage(conversationId: string): Promise<DataUsage>;
+        /** 资源面板：KV 浏览/编辑（经服务端代理，用户鉴权） */
+        kv: {
+            list(conversationId: string, opts?: {
+                env?: 'dev' | 'prod';
+                prefix?: string;
+                cursor?: string | null;
+                limit?: number;
+            }): Promise<{
+                ok: boolean;
+                keys: string[];
+                nextCursor: string | null;
+            }>;
+            get(conversationId: string, key: string, env?: 'dev' | 'prod'): Promise<{
+                ok: boolean;
+                key: string;
+                value: unknown;
+                exists: boolean;
+                ttl?: number | null;
+            }>;
+            set(conversationId: string, key: string, value: unknown, opts?: {
+                env?: 'dev' | 'prod';
+                ex?: number;
+            }): Promise<{
+                ok: boolean;
+            }>;
+            remove(conversationId: string, key: string, env?: 'dev' | 'prod'): Promise<{
+                ok: boolean;
+                removed?: boolean;
+            }>;
+        };
+        /** 资源面板：对象存储浏览 */
+        storage: {
+            list(conversationId: string, opts?: {
+                env?: 'dev' | 'prod';
+                prefix?: string;
+                cursor?: string | null;
+                limit?: number;
+            }): Promise<{
+                ok: boolean;
+                items: Array<{
+                    key: string;
+                    size: number;
+                    lastModified?: string | null;
+                }>;
+                nextCursor: string | null;
+            }>;
+            sign(conversationId: string, key: string, opts?: {
+                env?: 'dev' | 'prod';
+                expiresIn?: number;
+                downloadName?: string;
+            }): Promise<{
+                ok: boolean;
+                url: string;
+            }>;
+            uploadUrl(conversationId: string, key: string, opts?: {
+                env?: 'dev' | 'prod';
+                contentType?: string;
+                size?: number;
+            }): Promise<{
+                ok: boolean;
+                url: string;
+                method: 'PUT';
+                headers?: {
+                    contentType?: string;
+                } | null;
+            }>;
+            remove(conversationId: string, key: string, env?: 'dev' | 'prod'): Promise<{
+                ok: boolean;
+            }>;
+        };
         /** 复制命名空间（默认 dev→prod） */
         promote(conversationId: string, input?: {
             from?: 'dev' | 'prod';
@@ -243,6 +316,12 @@ export interface BuilderClient {
             }>;
         }>;
     };
+    logs: {
+        /** dev server 最近日志（沙箱未运行返回空） */
+        tail(conversationId: string, lines?: number): Promise<{
+            lines: string[];
+        }>;
+    };
     export: {
         /**
          * 导出应用源码 ZIP（含 Dockerfile/DEPLOY.md）。沙箱未运行时服务端返回 409 SANDBOX_NOT_RUNNING —— 调用方先 sandbox.wake()。

package/dist/client.js

@@ -90,9 +90,27 @@ export function createBuilderClient(options) {
         data: {
             access: id => req(`/${id}/data-access`),
             usage: id => req(`/${id}/data-usage`),
+            kv: {
+                list: (id, o) => req(`/${id}/data/kv?${qs({ env: o?.env, prefix: o?.prefix, cursor: o?.cursor ?? undefined, limit: o?.limit })}`),
+                get: (id, key, env) => req(`/${id}/data/kv/${encPath(key)}?${qs({ env })}`),
+                set: (id, key, value, o) => req(`/${id}/data/kv/${encPath(key)}?${qs({ env: o?.env })}`, { method: 'PUT', headers: { 'content-type': 'application/json' }, body: JSON.stringify({ value, ex: o?.ex }) }),
+                remove: (id, key, env) => req(`/${id}/data/kv/${encPath(key)}?${qs({ env })}`, { method: 'DELETE' }),
+            },
+            storage: {
+                list: (id, o) => req(`/${id}/data/storage?${qs({ env: o?.env, prefix: o?.prefix, cursor: o?.cursor ?? undefined, limit: o?.limit })}`),
+                sign: (id, key, o) => req(`/${id}/data/storage/sign?${qs({ env: o?.env })}`, { method: 'POST', headers: { 'content-type': 'application/json' }, body: JSON.stringify({ key, expiresIn: o?.expiresIn, downloadName: o?.downloadName }) }),
+                uploadUrl: (id, key, o) => req(`/${id}/data/storage/upload-url?${qs({ env: o?.env })}`, { method: 'POST', headers: { 'content-type': 'application/json' }, body: JSON.stringify({ key, contentType: o?.contentType, size: o?.size }) }),
+                remove: (id, key, env) => req(`/${id}/data/storage/${encPath(key)}?${qs({ env })}`, { method: 'DELETE' }),
+            },
             promote: (id, input) => req(`/${id}/data/promote`, { method: 'POST', headers: { 'content-type': 'application/json' }, body: JSON.stringify(input ?? {}) }),
             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 ?? []) };
+            },
+        },
         export: {
             zip: async (id) => {
                 const res = await doFetch(`${restBase}/${id}/export/zip`, auth.apply({}));
@@ -126,10 +144,13 @@ export class BuilderApiError extends Error {
         this.status = status;
     }
 }
+function encPath(key) {
+    return key.split('/').map(encodeURIComponent).join('/');
+}
 function qs(obj) {
     const p = new URLSearchParams();
     for (const [k, v] of Object.entries(obj ?? {}))
-        if (v !== undefined)
-            p.set(k, v);
+        if (v !== undefined && v !== null)
+            p.set(k, String(v));
     return p.toString();
 }

package/package.json

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