@chatu-ai/builder-sdk 0.9.2 → 0.9.4

package/dist/client.d.ts

@@ -38,6 +38,8 @@ export interface SandboxStatus {
         ready?: boolean;
         startingForMs?: number | null;
         lastError?: string | null;
+        /** 沙箱内处于 LISTEN 的端口，首个为 dev server；用于多端口预览切换 */
+        ports?: number[] | null;
         /** 最近一次异常退出；gaveUp=true 表示 runtime 已停止自动重启，需要修代码后手动重启 */
         crash?: {
             at?: string | null;
@@ -250,6 +252,23 @@ export type GitPushStreamEvent = {
     type: 'result';
     result: GitPushResult;
 };
+/** 沙箱终端：一次一条命令的执行结果 */
+export interface ExecResult {
+    ok: boolean;
+    code?: number | null;
+    signal?: string | null;
+    truncated?: boolean;
+    durationMs?: number;
+    error?: string | null;
+    message?: string | null;
+}
+export type ExecStreamEvent = {
+    type: 'log';
+    line: string;
+} | {
+    type: 'result';
+    result: ExecResult;
+};
 export interface DeployInput {
     provider: 'edgeone';
     projectName: string;
@@ -296,7 +315,10 @@ export interface BuilderClient {
             state?: SandboxState | string;
         }>;
         /** 一次性预览 token（06 §6.1）：返回可直接作 iframe src 的带 ?t= 的 URL */
-        previewToken(conversationId: string): Promise<{
+        /** port：应用自己起的第二个服务（多端口预览）；不传即 dev server */
+        previewToken(conversationId: string, opts?: {
+            port?: number | null;
+        }): Promise<{
             token: string;
             previewUrl: string;
         }>;
@@ -396,6 +418,11 @@ export interface BuilderClient {
             signal?: AbortSignal;
         }): AsyncIterable<FunctionDeployStreamEvent>;
     };
+    /** 沙箱终端（001/09 P2-A）：执行一条命令并流式回输出；AI 生成中会被拒绝（409） */
+    exec(conversationId: string, command: string, opts?: {
+        timeoutMs?: number;
+        signal?: AbortSignal;
+    }): AsyncIterable<ExecStreamEvent>;
     /** 平台数据能力接入信息（技术方案 15）：线上部署所需环境变量；apiKey 为服务端密钥 */
     data: {
         access(conversationId: string): Promise<{

package/dist/client.js

@@ -56,7 +56,7 @@ export function createBuilderClient(options) {
                 headers: { 'content-type': 'application/json' },
                 body: JSON.stringify(opts),
             }),
-            previewToken: id => req(`/${id}/preview-token`),
+            previewToken: (id, opts) => req(`/${id}/preview-token?${qs({ port: opts?.port ?? undefined })}`),
             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 +103,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),
         },
+        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`),
             usage: id => req(`/${id}/data-usage`),

package/package.json

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