@chatu-ai/builder-sdk 0.1.0

package/dist/resume.test.js

@@ -0,0 +1,73 @@
+import { describe, expect, it } from 'vitest';
+import { resilientStream } from './resume';
+const ev = (seq, kind = 'taskCard') => kind === 'done'
+    ? { kind: 'done', xid: 'x1', seq, state: 'completed' }
+    : { kind: 'taskCard', xid: 'x1', seq, id: `t${seq}`, label: `step ${seq}`, state: 'running' };
+async function* iter(events, failAfter) {
+    for (let i = 0;; i++) {
+        if (failAfter !== undefined && i === failAfter)
+            throw new Error('connection dropped');
+        if (i >= events.length)
+            return;
+        yield events[i];
+    }
+}
+async function collect(src) {
+    const out = [];
+    for await (const e of src)
+        out.push(e);
+    return out;
+}
+const noSleep = { sleep: async () => { }, baseDelayMs: 0 };
+describe('resilientStream', () => {
+    it('passes events through and stops at done', async () => {
+        const src = {
+            open: () => iter([ev(1), ev(2), ev(3, 'done')]),
+            reopen: () => iter([]),
+        };
+        const got = await collect(resilientStream(src, noSleep));
+        expect(got.map(e => e.seq)).toEqual([1, 2, 3]);
+    });
+    it('dedupes replayed events after reconnect (seq <= lastSeq dropped)', async () => {
+        let reopenedWith = -1;
+        const src = {
+            open: () => iter([ev(1), ev(2)], 2), // 两条后断线
+            reopen: lastSeq => {
+                reopenedWith = lastSeq;
+                // 服务端回放含重复（seq 1..2）+ 新事件
+                return iter([ev(1), ev(2), ev(3), ev(4, 'done')]);
+            },
+        };
+        const got = await collect(resilientStream(src, noSleep));
+        expect(reopenedWith).toBe(2);
+        expect(got.map(e => e.seq)).toEqual([1, 2, 3, 4]);
+    });
+    it('ack (seq=0) does not affect dedupe window', async () => {
+        const ack = {
+            kind: 'ack', xid: 'x1', seq: 0,
+            sandbox: { sandboxId: 'sbx1', state: 'ready', previewUrl: 'https://sbx1.n.example.com' },
+        };
+        const src = {
+            open: () => iter([ack, ev(1), ev(2, 'done')]),
+            reopen: () => iter([]),
+        };
+        const got = await collect(resilientStream(src, noSleep));
+        expect(got[0].kind).toBe('ack');
+        expect(got.map(e => e.seq)).toEqual([0, 1, 2]);
+    });
+    it('throws after maxRetries consecutive failures', async () => {
+        const src = {
+            open: () => iter([ev(1)], 1),
+            reopen: () => iter([], 0), // 每次重连立刻再断
+        };
+        await expect(collect(resilientStream(src, { ...noSleep, maxRetries: 2 }))).rejects.toThrow('dropped');
+    });
+    it('skips null (unparsed) events', async () => {
+        const src = {
+            open: () => iter([null, ev(1), null, ev(2, 'done')]),
+            reopen: () => iter([]),
+        };
+        const got = await collect(resilientStream(src, noSleep));
+        expect(got.map(e => e.seq)).toEqual([1, 2]);
+    });
+});

package/dist/sse.d.ts

@@ -0,0 +1,10 @@
+/**
+ * SSE 传输（BuilderController create/connect）：fetch 流式读取 → 逐条 data 行 → JSON。
+ * 与 EventSource 相比支持 POST + 自定义 header + AbortSignal。
+ */
+export interface SseOptions {
+    fetchImpl?: typeof fetch;
+    signal?: AbortSignal;
+}
+/** 逐条产出 SSE data 载荷（已 JSON.parse；非 JSON 行原样以 string 产出；[DONE] 结束） */
+export declare function readSse(url: string, init: RequestInit, opts?: SseOptions): AsyncIterable<unknown>;

package/dist/sse.js

@@ -0,0 +1,40 @@
+/** 逐条产出 SSE data 载荷（已 JSON.parse；非 JSON 行原样以 string 产出；[DONE] 结束） */
+export async function* readSse(url, init, opts = {}) {
+    const doFetch = opts.fetchImpl ?? fetch;
+    const res = await doFetch(url, { ...init, signal: opts.signal ?? init.signal });
+    if (!res.ok || !res.body) {
+        throw new Error(`sse ${res.status}: ${await res.text().catch(() => '')}`.slice(0, 300));
+    }
+    const reader = res.body.getReader();
+    const decoder = new TextDecoder();
+    let buffer = '';
+    try {
+        for (;;) {
+            const { value, done } = await reader.read();
+            if (done)
+                break;
+            buffer += decoder.decode(value, { stream: true });
+            let nl;
+            while ((nl = buffer.indexOf('\n')) >= 0) {
+                const line = buffer.slice(0, nl).replace(/\r$/, '');
+                buffer = buffer.slice(nl + 1);
+                if (!line.startsWith('data:'))
+                    continue;
+                const data = line.slice(5).trim();
+                if (!data)
+                    continue;
+                if (data === '[DONE]')
+                    return;
+                try {
+                    yield JSON.parse(data);
+                }
+                catch {
+                    yield data;
+                }
+            }
+        }
+    }
+    finally {
+        reader.releaseLock();
+    }
+}

package/package.json

@@ -0,0 +1,55 @@
+{
+  "name": "@chatu-ai/builder-sdk",
+  "version": "0.1.0",
+  "description": "ChatU Builder client SDK core: REST + streaming client, zod event schemas, seq resume",
+  "license": "MIT",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "sideEffects": false,
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/chatu-ai/chatu-builder-sdk.git",
+    "directory": "packages/core"
+  },
+  "homepage": "https://github.com/chatu-ai/chatu-builder-sdk/tree/main/packages/core#readme",
+  "bugs": "https://github.com/chatu-ai/chatu-builder-sdk/issues",
+  "keywords": [
+    "chatu",
+    "builder",
+    "ai",
+    "app-builder",
+    "sdk",
+    "a2a",
+    "sse"
+  ],
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "dependencies": {
+    "zod": "^3.24.0"
+  },
+  "devDependencies": {
+    "typescript": "^5.7.0",
+    "vitest": "^3.0.0"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "test": "vitest run"
+  }
+}