berry-agent-sdk 0.1.0-alpha.2

package/README.md

@@ -0,0 +1,78 @@
+# berry-agent-sdk
+
+berry-agent 的类型化 SDK 客户端。两种传输同一方法面：
+
+- **spawn serve stdio**——托管子进程（一条 stdin/stdout NDJSON 线，适合脚本内嵌）；
+- **直连 HTTP**——daemon Unix socket 或前台 TCP（POST + SSE，适合常驻服务）。
+
+类型面与线协议词汇与主仓单源同编译（零拷贝漂移）：`AgentEvent`、
+`SdkWireFrame` 等帧类型直出自 berry-agent 契约件。
+
+## 安装与快速上手
+
+```bash
+npm install berry-agent-sdk
+```
+
+### stdio 形（spawn serve 子进程）
+
+```ts
+import { createSdkClient, spawnServeTransport } from 'berry-agent-sdk';
+
+const transport = spawnServeTransport({
+  // 缺省 command = process.execPath（node 直跑形）；args 由调用方知悉安装布局
+  args: ['<berry-agent 包路径>/dist/host/main.js', 'serve'],
+});
+
+const client = createSdkClient(transport);
+
+// 发起会话（sessionId 缺席即新建；messageId 缺省客户端计数器形 sdk-N）
+const ack = await client.prompt({ content: '帮我看看这个仓库' });
+
+// 直播订阅：重放段（entries → replay-end）与直播段（event/heartbeat/ask）
+// 一律入 onFrame；订阅柄在 replay-end 后 resolve
+const handle = await client.subscribe({ sessionId: ack.sessionId }, (frame) => {
+  if (frame.kind === 'event') console.log(frame.event);
+});
+
+await client.close(); // 收线子进程（stdin EOF → 优雅退出）
+```
+
+### HTTP 形（daemon socket / 前台 TCP）
+
+```ts
+import { createSdkClient, httpSdkTransport } from 'berry-agent-sdk';
+
+const transport = httpSdkTransport({
+  socketPath: '<daemon socket 路径>', // 或 host + port（TCP 形）
+  token: '<面侧预置 token>',
+});
+
+const client = createSdkClient(transport);
+const sessions = await client.sessions(); // 会话清单
+const first = sessions[0]!;
+const page = await client.getEntries({ sessionId: first.id }); // 断线对账（since 缺省从头）
+const handle = await client.subscribe(
+  { sessionId: first.id, after: 41 }, // after = 已收末条 seq（重放窗口 (after, 高水位]）
+  (frame) => {
+    /* … */
+  },
+);
+await client.close();
+```
+
+## API 面
+
+- `createSdkClient(transport)` —— `prompt` / `getEntries` / `sessions` /
+  `interrupt` / `decide` / `subscribe` / `close`；错误帧统一投形
+  `SdkError`（`code` / `message` / `sessionId?`）。
+- `spawnServeTransport({ args, … })` / `httpSdkTransport({ socketPath | host+port, token })`
+  —— 两实装同 `SdkTransport` 三档抽象：请求档（单帧应答）、无应答档
+  （interrupt）、直播档（SSE / 线内 hello，replay-end 后建立）。
+- 类型面：`AgentEvent` / `ApprovalAskAnswer` / `SdkRequest` / `SdkWireFrame` /
+  `SdkAckFrame` / `SdkEntriesFrame` / `SdkSessionSummary` / `SdkDurableEntry` /
+  `SdkEventFrame` / `SdkHelloFrame` / `SdkErrorFrame` / `SDK_PROTOCOL_VERSION`。
+
+## 状态
+
+0.1.0-alpha.2——随主仓演进（版本真源 = 本包 `package.json` 的 `version` 字段）；npm 分发走主仓发布机器 `release:sdk`。

package/dist/packages/berry-agent-sdk/src/client.d.ts

@@ -0,0 +1,6 @@
+import type { SdkClient, SdkTransport } from './types.js';
+/**
+ * 建客户端。messageId 缺省计数器形（每客户端实例独立 `sdk-N` 自增——
+ * 幂等语义未申请即不虚构；跨实例幂等由调用方自选键）。
+ */
+export declare function createSdkClient(transport: SdkTransport): SdkClient;

package/dist/packages/berry-agent-sdk/src/client.js

@@ -0,0 +1,59 @@
+import { SdkError } from './types.js';
+/** 错误帧投形位（error 帧抛 SdkError；其余 kind 原样透传——窄卫由调用位断言承接） */
+function ensureNotError(frame) {
+    if (frame.kind !== 'error')
+        return;
+    const err = frame;
+    throw new SdkError(err.code, err.message, err.sessionId);
+}
+/**
+ * 建客户端。messageId 缺省计数器形（每客户端实例独立 `sdk-N` 自增——
+ * 幂等语义未申请即不虚构；跨实例幂等由调用方自选键）。
+ */
+export function createSdkClient(transport) {
+    let unkeyedSeq = 0;
+    return {
+        prompt: async (input) => {
+            const messageId = input.messageId ?? `sdk-${++unkeyedSeq}`;
+            const frame = await transport.request({
+                verb: 'prompt',
+                messageId,
+                content: input.content,
+                ...(input.sessionId !== undefined ? { sessionId: input.sessionId } : {}),
+            });
+            ensureNotError(frame);
+            return frame; // 应答闭集 {ack, error}——error 已投形
+        },
+        getEntries: async (input) => {
+            const frame = await transport.request({
+                verb: 'getEntries',
+                sessionId: input.sessionId,
+                since: input.since ?? -1,
+                // cursor 分页续读游标回送位——SDK 面亦透传（缺席即省略）
+                ...(input.cursor !== undefined ? { cursor: input.cursor } : {}),
+            });
+            ensureNotError(frame);
+            return frame; // 应答闭集 {entries, error}
+        },
+        sessions: async () => {
+            const frame = await transport.request({ verb: 'sessions' });
+            ensureNotError(frame);
+            return frame.sessions; // 应答闭集 {sessions, error}
+        },
+        // 无应答档（interrupt 受理经事件流可观察——写后即决；missing 会话错误帧走订阅帧面）
+        interrupt: (sessionId) => transport.send({ verb: 'interrupt', sessionId }),
+        decide: async (approvalId, answer, note) => {
+            const frame = await transport.request({
+                verb: 'decide',
+                approvalId,
+                answer,
+                ...(note !== undefined ? { note } : {}),
+            });
+            ensureNotError(frame);
+            return frame.outcome; // 应答闭集 {decide-result, error}
+        },
+        subscribe: (params, onFrame) => transport.openLive(params, onFrame),
+        close: () => transport.close(),
+    };
+}
+//# sourceMappingURL=client.js.map

package/dist/packages/berry-agent-sdk/src/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../../../../src/client.ts"],"names":[],"mappings":"AAWA,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AActC,yDAAyD;AACzD,SAAS,cAAc,CAAC,KAAmB;IACzC,IAAI,KAAK,CAAC,IAAI,KAAK,OAAO;QAAE,OAAO;IACnC,MAAM,GAAG,GAAG,KAAsB,CAAC;IACnC,MAAM,IAAI,QAAQ,CAAC,GAAG,CAAC,IAAI,EAAE,GAAG,CAAC,OAAO,EAAE,GAAG,CAAC,SAAS,CAAC,CAAC;AAC3D,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,eAAe,CAAC,SAAuB;IACrD,IAAI,UAAU,GAAG,CAAC,CAAC;IAEnB,OAAO;QACL,MAAM,EAAE,KAAK,EAAE,KAAqB,EAAE,EAAE;YACtC,MAAM,SAAS,GAAG,KAAK,CAAC,SAAS,IAAI,OAAO,EAAE,UAAU,EAAE,CAAC;YAC3D,MAAM,KAAK,GAAG,MAAM,SAAS,CAAC,OAAO,CAAC;gBACpC,IAAI,EAAE,QAAQ;gBACd,SAAS;gBACT,OAAO,EAAE,KAAK,CAAC,OAAO;gBACtB,GAAG,CAAC,KAAK,CAAC,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,KAAK,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aACzE,CAAC,CAAC;YACH,cAAc,CAAC,KAAK,CAAC,CAAC;YACtB,OAAO,KAAoB,CAAC,CAAC,+BAA+B;QAC9D,CAAC;QAED,UAAU,EAAE,KAAK,EAAE,KAAsB,EAAE,EAAE;YAC3C,MAAM,KAAK,GAAG,MAAM,SAAS,CAAC,OAAO,CAAC;gBACpC,IAAI,EAAE,YAAY;gBAClB,SAAS,EAAE,KAAK,CAAC,SAAS;gBAC1B,KAAK,EAAE,KAAK,CAAC,KAAK,IAAI,CAAC,CAAC;gBACxB,oCAAoC;gBACpC,GAAG,CAAC,KAAK,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aAChE,CAAC,CAAC;YACH,cAAc,CAAC,KAAK,CAAC,CAAC;YACtB,OAAO,KAAwB,CAAC,CAAC,wBAAwB;QAC3D,CAAC;QAED,QAAQ,EAAE,KAAK,IAAI,EAAE;YACnB,MAAM,KAAK,GAAG,MAAM,SAAS,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC,CAAC;YAC5D,cAAc,CAAC,KAAK,CAAC,CAAC;YACtB,OAAQ,KAA2C,CAAC,QAAQ,CAAC,CAAC,yBAAyB;QACzF,CAAC;QAED,qDAAqD;QACrD,SAAS,EAAE,CAAC,SAAiB,EAAE,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,SAAS,EAAE,CAAC;QAElF,MAAM,EAAE,KAAK,EAAE,UAAkB,EAAE,MAAyB,EAAE,IAAa,EAAE,EAAE;YAC7E,MAAM,KAAK,GAAG,MAAM,SAAS,CAAC,OAAO,CAAC;gBACpC,IAAI,EAAE,QAAQ;gBACd,UAAU;gBACV,MAAM;gBACN,GAAG,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aACxC,CAAC,CAAC;YACH,cAAc,CAAC,KAAK,CAAC,CAAC;YACtB,OAAQ,KAA+C,CAAC,OAAO,CAAC,CAAC,8BAA8B;QACjG,CAAC;QAED,SAAS,EAAE,CAAC,MAAqB,EAAE,OAAyB,EAA0B,EAAE,CACtF,SAAS,CAAC,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;QAErC,KAAK,EAAE,GAAG,EAAE,CAAC,SAAS,CAAC,KAAK,EAAE;KAC/B,CAAC;AACJ,CAAC"}

package/dist/packages/berry-agent-sdk/src/http.d.ts

@@ -0,0 +1,24 @@
+import type { IncomingMessage } from 'node:http';
+import type { SdkTransport } from './types.js';
+/** HTTP 传输选项（sock 与 host/port 二选一——daemon 缺省接入位即 sock） */
+export interface HttpSdkOptions {
+    /** Unix domain socket 路径（daemon 形） */
+    readonly socketPath?: string;
+    /** TCP 主机（前台形；与 port 成对） */
+    readonly host?: string;
+    /** TCP 端口（前台形；与 host 成对） */
+    readonly port?: number;
+    /** 鉴权 token（Bearer 形——面侧每请求验） */
+    readonly token: string;
+    /** 坏行/SSE 诊断面（缺省静默） */
+    readonly onWarn?: (message: string) => void;
+}
+/** 直连 HTTP 传输 */
+export declare function httpSdkTransport(options: HttpSdkOptions): SdkTransport;
+/**
+ * 单订阅收口工厂（幂等——流账摘除先于销毁；res 'close' 终局另有摘账兜底）。
+ *
+ * 模块缝注：具名导出仅供同模块测试件锁账纪纪律（摘账先于销毁），包公开面
+ * （index.ts）不转发——外部勿依赖。
+ */
+export declare function liveClose(res: IncomingMessage, streams: Set<IncomingMessage>): () => Promise<void>;

package/dist/packages/berry-agent-sdk/src/http.js

@@ -0,0 +1,232 @@
+/**
+ * berry-agent-sdk/http — 直连 HTTP 传输（批 13f-3）。
+ *
+ * 面向 13e 落码的 SDK HTTP face（daemon sock / 前台 TCP 两监听形）。路由与
+ * 鉴权头常量单源自 `src/sdk/types.js` 复导入——端点词面漂移在结构上不可能。
+ * node:http 直用（fetch 无 Unix socket 支持——daemon 缺省接入位即 sock）。
+ *
+ * 应答归属：HTTP 请求/响应一一对应，帧归属天然无歧义——无需 stdio 形的
+ * 事务串行链。错误帧以非 2xx + 错误体（与线协议错误帧同构）回达 → 本层
+ * 还原为帧原样返回（投形归 client）；传输级失败（连接拒/断）抛
+ * `SDK_TRANSPORT`——建连期错误发在 req、应答期夭折错误发在 res，两期皆
+ * 接线 reject（不留悬挂 Promise）。直播档 = GET /v1/events SSE：`data:
+ * <单行 JSON>` 块 + `: ping` 注释行——与 face 写侧纪律一一对应；建立期
+ * （replay-end 界标前）流终结同样 fail-loud reject，已建立后流错误只诊断。
+ */
+import { request as httpRequest } from 'node:http';
+import { decodeWireLine, isSdkRequest } from '../../../src/channels/sdk/jsonl.js';
+import { SDK_PROTOCOL_VERSION } from '../../../src/channels/sdk/protocol.js';
+import { SDK_AUTH_HEADER, SDK_HTTP_ENDPOINTS, SDK_PROTOCOL_HEADER } from '../../../src/sdk/types.js';
+import { SdkError } from './types.js';
+/** 各请求档动词 → 端点路由（GET/POST 与体形由面定形） */
+const ROUTES = {
+    prompt: { method: 'POST', path: SDK_HTTP_ENDPOINTS.prompt },
+    decide: { method: 'POST', path: SDK_HTTP_ENDPOINTS.decide },
+    getEntries: { method: 'POST', path: SDK_HTTP_ENDPOINTS.entries },
+    sessions: { method: 'GET', path: SDK_HTTP_ENDPOINTS.sessions },
+};
+/** 直连 HTTP 传输 */
+export function httpSdkTransport(options) {
+    if ((options.socketPath === undefined) === (options.host === undefined)) {
+        throw new SdkError('SDK_TRANSPORT', 'socketPath 与 host/port 须二选一');
+    }
+    const warn = options.onWarn ?? (() => { });
+    /** 在场 SSE 流账（close 时逐一收口） */
+    const liveStreams = new Set();
+    /** 单次请求（socketPath XOR host/port——Node 语义自动取舍） */
+    const roundTrip = (method, path, body) => new Promise((resolve, reject) => {
+        const req = httpRequest({
+            socketPath: options.socketPath,
+            host: options.host,
+            port: options.port,
+            method,
+            path,
+            headers: {
+                ...(body !== undefined ? { 'content-type': 'application/json; charset=utf-8' } : {}),
+                [SDK_AUTH_HEADER]: `Bearer ${options.token}`,
+                [SDK_PROTOCOL_HEADER]: String(SDK_PROTOCOL_VERSION),
+            },
+        }, (res) => {
+            const chunks = [];
+            res.on('data', (chunk) => chunks.push(chunk));
+            res.on('end', () => resolve({ status: res.statusCode ?? 0, body: Buffer.concat(chunks).toString('utf8') }));
+            // 应答阶段连接夭折（ECONNRESET 等）错误发在 res 而非 req——不挂即悬挂
+            res.on('error', (err) => reject(new SdkError('SDK_TRANSPORT', `${method} ${path} 传输失败：${err.message}`)));
+        });
+        req.on('error', (err) => reject(new SdkError('SDK_TRANSPORT', `${method} ${path} 传输失败：${err.message}`)));
+        if (body !== undefined)
+            req.write(body);
+        req.end();
+    });
+    /** 应答体 → 帧：2xx 解帧；非 2xx 错误体还原错误帧原样返回（投形归 client） */
+    const toFrame = (result, what) => {
+        if (result.status >= 200 && result.status < 300) {
+            try {
+                return decodeWireLine(result.body);
+            }
+            catch (err) {
+                // 2xx 却非帧形 = 面侧违约——收进传输错词面（fail-loud 不裸抛解码错）
+                throw new SdkError('SDK_TRANSPORT', `${what} → 2xx 应答非帧形：${err instanceof Error ? err.message : String(err)}`);
+            }
+        }
+        try {
+            // face 错误体与线协议错误帧同构（码→状态映射——词汇零第二套）
+            const frame = decodeWireLine(result.body);
+            if (!isSdkRequest(frame) && frame.kind === 'error')
+                return frame;
+        }
+        catch {
+            // 落到传输错——非帧形错误体
+        }
+        throw new SdkError('SDK_TRANSPORT', `${what} → HTTP ${result.status}：${result.body.slice(0, 200)}`);
+    };
+    const transport = {
+        request: async (req) => {
+            const route = ROUTES[req.verb];
+            if (route === undefined) {
+                return Promise.reject(new SdkError('SDK_TRANSPORT', `动词 ${req.verb} 不走请求档（hello→subscribe / interrupt→send）`));
+            }
+            // 体 = 载荷去 verb（端点即动词——面侧注入权威）
+            const { verb: _verb, ...payload } = req;
+            const result = await roundTrip(route.method, route.path, route.method === 'POST' ? JSON.stringify(payload) : undefined);
+            return toFrame(result, `${route.method} ${route.path}`);
+        },
+        // 无应答档 HTTP 形：POST /v1/interrupt → 204 空体（写后即决）
+        send: async (req) => {
+            const { verb: _verb, ...payload } = req;
+            const result = await roundTrip('POST', SDK_HTTP_ENDPOINTS.interrupt, JSON.stringify(payload));
+            if (result.status < 200 || result.status >= 300) {
+                throw new SdkError('SDK_TRANSPORT', `interrupt → HTTP ${result.status}：${result.body.slice(0, 200)}`);
+            }
+        },
+        openLive: (params, onFrame) => new Promise((resolve, reject) => {
+            const query = new URLSearchParams({ sessionId: params.sessionId });
+            if (params.after !== undefined)
+                query.set('after', String(params.after));
+            // 布尔词面 = 宿主解码位字面（只认 'true'/'false'，其余 400 SDK_DECODE）——'1'/'0' 形恒被拒
+            if (params.noDelta !== undefined)
+                query.set('noDelta', params.noDelta ? 'true' : 'false');
+            const req = httpRequest({
+                socketPath: options.socketPath,
+                host: options.host,
+                port: options.port,
+                method: 'GET',
+                path: `${SDK_HTTP_ENDPOINTS.events}?${query.toString()}`,
+                headers: {
+                    accept: 'text/event-stream',
+                    [SDK_AUTH_HEADER]: `Bearer ${options.token}`,
+                    [SDK_PROTOCOL_HEADER]: String(SDK_PROTOCOL_VERSION),
+                },
+            }, (res) => {
+                if ((res.statusCode ?? 0) !== 200) {
+                    // 建流失败：错误体还原错误帧投形拒绝（订阅失败即整档失败）
+                    const chunks = [];
+                    res.on('data', (chunk) => chunks.push(chunk));
+                    res.on('end', () => {
+                        try {
+                            const frame = decodeWireLine(Buffer.concat(chunks).toString('utf8'));
+                            if (!isSdkRequest(frame) && frame.kind === 'error') {
+                                reject(new SdkError(frame.code, frame.message));
+                                return;
+                            }
+                        }
+                        catch {
+                            // 落到传输错
+                        }
+                        reject(new SdkError('SDK_TRANSPORT', `SSE 建流 → HTTP ${res.statusCode ?? 0}`));
+                    });
+                    return;
+                }
+                liveStreams.add(res);
+                let settled = false; // 建立界标守卫：replay-end resolve 置位——界标前终局一律建流失败
+                let highWaterSeq = -1;
+                let buffer = '';
+                res.setEncoding('utf8');
+                res.on('data', (chunk) => {
+                    buffer += chunk;
+                    // SSE 事件块以空行分隔；注释行（: ping）跳过——与 face 写侧纪律对应
+                    let sep;
+                    while ((sep = buffer.indexOf('\n\n')) !== -1) {
+                        const block = buffer.slice(0, sep);
+                        buffer = buffer.slice(sep + 2);
+                        for (const data of sseDataPayloads(block)) {
+                            try {
+                                const frame = decodeWireLine(data);
+                                if (isSdkRequest(frame)) {
+                                    warn(`SSE 反向帧跳过：${data.slice(0, 120)}`);
+                                    continue;
+                                }
+                                if (frame.kind === 'hello') {
+                                    // 握手首帧：取快照高水位，不入监听面（与 stdio 形同语义）
+                                    highWaterSeq = frame.highWaterSeq;
+                                    continue;
+                                }
+                                onFrame(frame);
+                                if (frame.kind === 'replay-end') {
+                                    // 衔接界标即建立点——界标帧已入监听面（重放段全量承诺）
+                                    settled = true;
+                                    resolve({ sessionId: params.sessionId, highWaterSeq, close: liveClose(res, liveStreams) });
+                                }
+                            }
+                            catch (err) {
+                                warn(`SSE 坏载荷跳过：${err instanceof Error ? err.message : String(err)}`);
+                            }
+                        }
+                    }
+                });
+                // 终局摘账 + 建立期守卫：流终结先摘 liveStreams 账（对端收流/server 侧
+                // 断开同族——终局即离场，不滞留已死流对象）；replay-end 未至的终局 =
+                // 建流失败 fail-loud（调用方拿到悬空 Future 无超时兜底可依，最劣形）。
+                const terminate = (why) => {
+                    liveStreams.delete(res);
+                    if (!settled)
+                        reject(new SdkError('SDK_TRANSPORT', `SSE 流在 replay-end 前终止（${why}）`));
+                };
+                res.on('end', () => terminate('应答流结束'));
+                res.on('close', () => terminate('连接关闭'));
+                res.on('error', (err) => {
+                    if (settled) {
+                        // 已建立后的流中断只诊断不打回（收口归 handle.close / transport.close）
+                        warn(`SSE 流错误：${err.message}`);
+                        return;
+                    }
+                    reject(new SdkError('SDK_TRANSPORT', `SSE 流在 replay-end 前终止（流错误：${err.message}）`));
+                });
+            });
+            req.on('error', (err) => reject(new SdkError('SDK_TRANSPORT', `SSE 建流传输失败：${err.message}`)));
+            req.end();
+        }),
+        // 整连接收口（幂等）：在场 SSE 流逐一销毁（请求档无长连——keep-alive 由 agent 自理）
+        close: async () => {
+            for (const res of liveStreams)
+                res.destroy();
+            liveStreams.clear();
+        },
+    };
+    return transport;
+}
+/** SSE 事件块 → data 载荷列表（`data: ` 前缀行拼接——多行 data 续接；注释行跳过） */
+function sseDataPayloads(block) {
+    const data = [];
+    for (const line of block.split('\n')) {
+        if (line.startsWith(':'))
+            continue; // 注释行（30s ping）
+        if (line.startsWith('data:'))
+            data.push(line.slice(5).trimStart());
+    }
+    return data;
+}
+/**
+ * 单订阅收口工厂（幂等——流账摘除先于销毁；res 'close' 终局另有摘账兜底）。
+ *
+ * 模块缝注：具名导出仅供同模块测试件锁账纪纪律（摘账先于销毁），包公开面
+ * （index.ts）不转发——外部勿依赖。
+ */
+export function liveClose(res, streams) {
+    return async () => {
+        // 摘账先于销毁——滞留已销毁流对象即无界账（每订阅周期一漏，跨会话反复订阅累积）
+        streams.delete(res);
+        res.destroy();
+    };
+}
+//# sourceMappingURL=http.js.map

package/dist/packages/berry-agent-sdk/src/http.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.js","sourceRoot":"","sources":["../../../../src/http.ts"],"names":[],"mappings":"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"}

package/dist/packages/berry-agent-sdk/src/index.d.ts

@@ -0,0 +1,25 @@
+/**
+ * berry-agent-sdk —— 类型化 SDK 客户端公共面（批 13f-3）。
+ *
+ * 两传输同面：spawn serve stdio（子进程托管形）与直连 HTTP（daemon sock /
+ * 前台 TCP 形）；client 方法面传输无关。类型面自仓单源策展 re-export——
+ * 进什么出什么逐项过目（见 ./types.ts）。
+ *
+ * 用法骨架：
+ * ```ts
+ * import { createSdkClient, spawnServeTransport } from 'berry-agent-sdk';
+ * const transport = spawnServeTransport({ args: ['<主包>/dist/host/main.js', 'serve'] });
+ * const client = createSdkClient(transport);
+ * const ack = await client.prompt({ content: '你好' });
+ * const handle = await client.subscribe({ sessionId: ack.sessionId }, (frame) => { … });
+ * await client.close();
+ * ```
+ */
+export { SdkError, SDK_PROTOCOL_VERSION } from './types.js';
+export type { SdkFrameListener, SdkLiveHandle, SdkLiveParams, SdkTransport, SdkClient, SdkPromptInput, SdkEntriesInput, } from './types.js';
+export type { AgentEvent, ApprovalAskAnswer, SdkRequest, SdkWireFrame, SdkAckFrame, SdkEntriesFrame, SdkSessionSummary, SdkDurableEntry, SdkEventFrame, SdkHelloFrame, SdkErrorFrame, } from './types.js';
+export { createSdkClient } from './client.js';
+export { spawnServeTransport } from './stdio.js';
+export type { SpawnServeOptions, SdkStdioTransport } from './stdio.js';
+export { httpSdkTransport } from './http.js';
+export type { HttpSdkOptions } from './http.js';

package/dist/packages/berry-agent-sdk/src/index.js

@@ -0,0 +1,22 @@
+/**
+ * berry-agent-sdk —— 类型化 SDK 客户端公共面（批 13f-3）。
+ *
+ * 两传输同面：spawn serve stdio（子进程托管形）与直连 HTTP（daemon sock /
+ * 前台 TCP 形）；client 方法面传输无关。类型面自仓单源策展 re-export——
+ * 进什么出什么逐项过目（见 ./types.ts）。
+ *
+ * 用法骨架：
+ * ```ts
+ * import { createSdkClient, spawnServeTransport } from 'berry-agent-sdk';
+ * const transport = spawnServeTransport({ args: ['<主包>/dist/host/main.js', 'serve'] });
+ * const client = createSdkClient(transport);
+ * const ack = await client.prompt({ content: '你好' });
+ * const handle = await client.subscribe({ sessionId: ack.sessionId }, (frame) => { … });
+ * await client.close();
+ * ```
+ */
+export { SdkError, SDK_PROTOCOL_VERSION } from './types.js';
+export { createSdkClient } from './client.js';
+export { spawnServeTransport } from './stdio.js';
+export { httpSdkTransport } from './http.js';
+//# sourceMappingURL=index.js.map

package/dist/packages/berry-agent-sdk/src/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AACH,OAAO,EAAE,QAAQ,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAyB5D,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAEjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC"}

package/dist/packages/berry-agent-sdk/src/stdio.d.ts

@@ -0,0 +1,23 @@
+import type { SdkTransport } from './types.js';
+/** spawn 选项（args 必填——serve 启动形由调用方知悉，本件不猜安装布局） */
+export interface SpawnServeOptions {
+    /** 可执行（缺省 process.execPath——node 直跑形） */
+    readonly command?: string;
+    /** 子进程参数（必填——serve 形态启动面） */
+    readonly args: readonly string[];
+    /** 环境变量（缺省继承 process.env） */
+    readonly env?: Record<string, string | undefined>;
+    /** 工作目录（缺省继承） */
+    readonly cwd?: string;
+    /** 子进程 stderr 观察面（诊断——缺省静默；注意 serve 形 stderr 含日志） */
+    readonly onStderr?: (chunk: string) => void;
+    /** 坏行/反向帧诊断面（缺省静默） */
+    readonly onWarn?: (message: string) => void;
+}
+/** stdio 传输柄（传输三档 + 子进程终局） */
+export interface SdkStdioTransport extends SdkTransport {
+    /** 子进程退出码终局（close 后落定；spawn 失败形 = -1） */
+    readonly exited: Promise<number>;
+}
+/** spawn serve 子进程并建传输 */
+export declare function spawnServeTransport(options: SpawnServeOptions): SdkStdioTransport;