berry-agent-sdk 0.1.0-alpha.2

package/dist/src/channels/sdk/jsonl.js

@@ -0,0 +1,201 @@
+import { SDK_FRAME_KINDS, SDK_REQUEST_VERBS } from './protocol.js';
+import { validateSdkRequest } from './schema.js';
+/** 行终止符两位（编码转义对象——显式转义写法防字面量在编辑/传输中丢失） */
+const LS = '\u2028';
+const PS = '\u2029';
+/** 判别字段的受控名（请求 `verb` / 线帧 `kind`） */
+const FRAME_KIND_SET = new Set(SDK_FRAME_KINDS);
+const REQUEST_VERB_SET = new Set(SDK_REQUEST_VERBS);
+/** decide.answer 四值闭集（contracts ApprovalAskAnswer 减 'unavailable'——结构性
+ * 自报值非通道答案，SDK 通道面不受理；2026-09-13 复盘发现 #28：修前注称「同集」
+ * 在 unavailable 入集后失真） */
+const APPROVAL_ANSWERS = new Set(['approve', 'reject', 'cancel', 'always']);
+/** decide-result.outcome 闭集（跨入口竞速回执两档） */
+const DECIDE_OUTCOMES = new Set(['applied', 'superseded']);
+/** 解码失败（fail-loud——坏行不产半帧；线面应答形〔错误帧映射〕归宿主 serve 装配批） */
+export class SdkDecodeError extends Error {
+    rawLine;
+    constructor(message, 
+    /** 原始行文本（审计面——截断到 200 字符防日志洪水） */
+    rawLine) {
+        super(`SDK 线解码失败：${message}`);
+        this.rawLine = rawLine;
+        this.name = 'SdkDecodeError';
+    }
+}
+/**
+ * 编码单帧为一行（含行尾 `\n`）。出站纪律：序列化 + U+2028/U+2029 转义——
+ * 返回值保证恰一个 `\n` 且在末尾（行安全锁，测试在册）。
+ */
+export function encodeWireLine(frame) {
+    const json = JSON.stringify(frame).replaceAll(LS, '\\u2028').replaceAll(PS, '\\u2029');
+    return `${json}\n`;
+}
+/** 值判别：请求（verb 判别字段在闭集内）——非抛型窄卫（消费面路由用） */
+export function isSdkRequest(value) {
+    return (typeof value === 'object' &&
+        value !== null &&
+        'verb' in value &&
+        typeof value.verb === 'string' &&
+        REQUEST_VERB_SET.has(value.verb));
+}
+/** 结构校验：非对象 / 判别字段缺席 / 判别值不在闭集 —— 各自独立报因 */
+function classify(value, rawLine) {
+    if (typeof value !== 'object' || value === null) {
+        throw new SdkDecodeError('非 JSON 对象', rawLine);
+    }
+    const v = value;
+    if (typeof v.verb === 'string' && REQUEST_VERB_SET.has(v.verb))
+        return 'request';
+    if (typeof v.kind === 'string' && FRAME_KIND_SET.has(v.kind))
+        return 'frame';
+    if (v.verb !== undefined || v.kind !== undefined) {
+        throw new SdkDecodeError(`判别值不识别（verb=${String(v.verb)} kind=${String(v.kind)}——闭集外）`, rawLine);
+    }
+    throw new SdkDecodeError('判别字段缺席（verb/kind 均无）', rawLine);
+}
+/** 标量必填断言（结构性校验——深校验挂账见文件头） */
+function requireString(shape, key, rawLine) {
+    const v = shape[key];
+    if (typeof v !== 'string')
+        throw new SdkDecodeError(`${key} 必填且须为 string`, rawLine);
+    return v;
+}
+function requireNumber(shape, key, rawLine) {
+    const v = shape[key];
+    if (typeof v !== 'number' || !Number.isFinite(v)) {
+        throw new SdkDecodeError(`${key} 必填且须为有限数`, rawLine);
+    }
+    return v;
+}
+/** 逐请求动词的结构性必填校验（六动词族——03 §10.6 收窄律闭集） */
+function validateRequest(shape, verb, rawLine) {
+    switch (verb) {
+        case 'hello':
+            requireNumber(shape, 'protocolVersion', rawLine);
+            break;
+        case 'prompt':
+            requireString(shape, 'messageId', rawLine);
+            requireString(shape, 'content', rawLine);
+            break;
+        case 'interrupt':
+            requireString(shape, 'sessionId', rawLine);
+            break;
+        case 'getEntries':
+            requireString(shape, 'sessionId', rawLine);
+            requireNumber(shape, 'since', rawLine);
+            break;
+        case 'decide':
+            requireString(shape, 'approvalId', rawLine);
+            if (!APPROVAL_ANSWERS.has(shape.answer)) {
+                throw new SdkDecodeError('answer 必填且须为 approve/reject/cancel/always 四值闭集', rawLine);
+            }
+            break;
+        case 'sessions':
+            break;
+    }
+}
+/** 逐线帧 kind 的结构性必填校验 */
+function validateFrame(shape, kind, rawLine) {
+    switch (kind) {
+        case 'event':
+            requireNumber(shape, 'seq', rawLine);
+            requireString(shape, 'sessionId', rawLine);
+            if (typeof shape.event !== 'object' ||
+                shape.event === null ||
+                typeof shape.event.type !== 'string') {
+                throw new SdkDecodeError('event 必填且须携 string type（04 §2 十型判别）', rawLine);
+            }
+            break;
+        case 'hello':
+            requireString(shape, 'sessionId', rawLine);
+            requireNumber(shape, 'protocolVersion', rawLine);
+            requireNumber(shape, 'highWaterSeq', rawLine);
+            break;
+        case 'heartbeat':
+            requireString(shape, 'sessionId', rawLine);
+            if (shape.runState !== 'idle' && shape.runState !== 'running') {
+                throw new SdkDecodeError('runState 必填且须为 idle/running 两值闭集', rawLine);
+            }
+            requireNumber(shape, 'elapsedMs', rawLine);
+            break;
+        case 'ack':
+            requireString(shape, 'sessionId', rawLine);
+            requireString(shape, 'messageId', rawLine);
+            if (typeof shape.duplicate !== 'boolean') {
+                throw new SdkDecodeError('duplicate 必填且须为 boolean', rawLine);
+            }
+            requireNumber(shape, 'highWaterSeq', rawLine);
+            break;
+        case 'replay-end':
+            requireString(shape, 'sessionId', rawLine);
+            requireNumber(shape, 'lastReplayedSeq', rawLine);
+            break;
+        case 'entries':
+            requireString(shape, 'sessionId', rawLine);
+            break;
+        case 'decide-result':
+            requireString(shape, 'approvalId', rawLine);
+            if (!DECIDE_OUTCOMES.has(shape.outcome)) {
+                throw new SdkDecodeError('outcome 必填且须为 applied/superseded 两值闭集', rawLine);
+            }
+            break;
+        case 'ask':
+            // 审批外推帧恰三必填标量（reason/toolName/suggestedEntry 可选呈现位不校验）
+            requireString(shape, 'sessionId', rawLine);
+            requireString(shape, 'approvalId', rawLine);
+            requireString(shape, 'summary', rawLine);
+            break;
+        case 'sessions':
+            break;
+        case 'error':
+            requireString(shape, 'code', rawLine);
+            requireString(shape, 'message', rawLine);
+            break;
+    }
+}
+/**
+ * 解码单行为请求或线帧（fail-loud：非 JSON / 判别缺席 / 必填缺失各自报因，
+ * 坏行不产半帧）。行尾 `\r` 容忍（CRLF 传输面统一 LF——与 TUI 输入解码同律）。
+ */
+export function decodeWireLine(line) {
+    const rawLine = line;
+    let parsed;
+    try {
+        parsed = JSON.parse(line);
+    }
+    catch {
+        throw new SdkDecodeError('非合法 JSON', rawLine);
+    }
+    const which = classify(parsed, rawLine);
+    const shape = parsed;
+    if (which === 'request') {
+        validateRequest(shape, shape.verb, rawLine);
+        // 深校验（批 13e 接入——./schema.ts 单源）：结构层过后逐字段 typebox 校验
+        //（未知字段拒收/选填语义——HTTP 体校验位同源同件）
+        const deep = validateSdkRequest(parsed);
+        if (!deep.ok)
+            throw new SdkDecodeError(deep.reason, rawLine);
+        return deep.value;
+    }
+    validateFrame(shape, shape.kind, rawLine);
+    return parsed;
+}
+/**
+ * 流式分帧（stdio 管道跨 chunk 边界的安全分帧）：按 `\n` 切行、行尾 `\r` 剥离
+ * （CRLF 统一 LF）、空行跳过（心跳间隙的空拍不产帧）。入参 chunk 与上次
+ * remainder 拼接后切分；无完整行的 chunk 只进 remainder（零字节丢失、零半帧）。
+ */
+export function splitWireLines(chunk, remainder = '') {
+    const joined = remainder + chunk;
+    const lastNewline = joined.lastIndexOf('\n');
+    if (lastNewline === -1)
+        return { lines: [], remainder: joined };
+    const lines = joined
+        .slice(0, lastNewline)
+        .split('\n')
+        .map((line) => (line.endsWith('\r') ? line.slice(0, -1) : line))
+        .filter((line) => line.length > 0);
+    return { lines, remainder: joined.slice(lastNewline + 1) };
+}
+//# sourceMappingURL=jsonl.js.map

package/dist/src/channels/sdk/jsonl.js.map

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

package/dist/src/channels/sdk/protocol.d.ts

@@ -0,0 +1,297 @@
+/**
+ * SDK 线协议词汇与信封（03 篇 §10.6 线协议七原则 + 线事件词汇条——批 13a 契约先行笔）。
+ *
+ * 架构位（03 §10.6 件身份条）：协议核心（事件外推/请求受理/admit/seq 游标）代码位与
+ * channels 通道核同体——SDK 通道后端 = UiBackend 第三后端，本件目录即其协议面；
+ * stdio JSONL 传输归宿主 serve 子命令（07 §5）；HTTP+SSE 传输与 MCP server 包装归
+ * core:sdk 件（src/sdk/ 随批 13e 起域）——三传输同律吃本件词汇，零第二套。
+ *
+ * 信封定形（03 §10.6 线事件词汇条「信封词面（`{seq, sessionId, event}` 形）随落码
+ * 批定形」——本批即定形批）：活体事件帧 kind:'event' 恰携三载荷字段 {seq, sessionId,
+ * event}；线控帧族与请求应答帧平铺自持各自载荷（hello/ack 必携 sessionId——03 §10.6
+ * 请求面动词族条·会话生命周期段）。全部帧以顶层 `kind` 判别、全部请求以顶层 `verb`
+ * 判别（NDJSON 行一级判别，编解码见 ./jsonl.ts）。
+ */
+import type { AgentEvent } from '../../agent/index.js';
+import type { ApprovalAskAnswer, RetryProbe } from '../../contracts/index.js';
+/** 线协议版本（③/⑤ 版本握手第一天就有：连接即 hello 双方携 protocolVersion 比对） */
+export declare const SDK_PROTOCOL_VERSION = 1;
+/**
+ * 高水位约定（全件单源——05 §3.5 崩溃重连对账条）：**highWaterSeq = 会话日志当前
+ * 长度**（= 下一将分配 seq；既存末条 seq = highWaterSeq − 1；空会话 = 0）。在此
+ * 约定下两执法句自洽：调用方已收末 seq ≥ 高水位 ⇒ 尾被截（seq 复用/幻影）；
+ * `after=N` ≥ 高水位 ⇒ 游标非法（声称已收不存在的事件）。
+ */
+/** 心跳阶段三形（② 心跳是协议义务——载荷「thinking / tool:<名>+<耗时> / retry <attempt>/<next>」定形为判别联合） */
+export type SdkHeartbeatStage = {
+    type: 'thinking';
+}
+/** 工具执行中：工具名 + 该阶段已耗时毫秒 */
+ | {
+    type: 'tool';
+    name: string;
+    stageElapsedMs: number;
+}
+/**
+ * 驱动重试续入中：probe = contracts RetryProbe（驱动 retryState 只读小面直载
+ * ——attempt/nextAt/maxAttempts 单形单源）。重试进度状态源 = 驱动重试循环对
+ * 通道核的只读小面（暴露 attempt/nextAt，非事件型、不进 durable——04 §2
+ * 「重试续入零新事件型」），心跳载荷是该 seam 的唯一线面出口。
+ */
+ | {
+    type: 'retry';
+    probe: RetryProbe;
+};
+/**
+ * 活体事件帧（信封形 `{seq, sessionId, event}` 恰三载荷字段——03 §10.6 线事件
+ * 词汇条定形）。event = 04 §2 活体十型直出（拍板③单源律——不设第二套粗粒度
+ * 词汇）；message_update 线形剥累积快照只留 delta（① delta 缺省开，改造位在
+ * 通道核外推腿、不改活体层事件形状——05 §3.5 第三腿），`--no-delta` 退订降
+ * 流量档（07 §5）。
+ *
+ * **双轨律（批 13b 落码定形——立题批可抄清单 #2「delta 仅直播、Ended 可重放」
+ * 同源）**：直播段 = 本帧族（AgentEvent 直出/改造形）；重放段 = durable 平铺
+ * 投影（{@link SdkDurableEntry}，queryEntries 同源读面）——两段词汇按构造零
+ * 重叠（durable 词 ≠ 活体十型），衔接 = 先重放（至订阅时高水位）后全量吐直播
+ * 缓冲，无跨段去重面。掉帧语义：纯活体帧（message_update delta/工具进度）
+ * 丢失无害——重放兜底在 durable 面（05 §3.5「累积错无立足点」）。
+ */
+export interface SdkEventFrame {
+    kind: 'event';
+    /**
+     * per-session 单调 seq——**durable 水位语义**（批 13b 落码定形）：值 = 外推
+     * 时刻会话内存日志长度（05 §1.1 seq = 写入时 log.length；含未落库在飞事件
+     * 的内存序）。弱单调（纯活体帧间可同号）；durable 锚定帧（message_end 等——
+     * durable 落账腿先于外部汇腿同步分发）恒 > 订阅重放尾。崩溃对账消费位：
+     * 调用方记已收最大 seq，重连携 after 比对高水位（05 §3.5 尾截断侦测）。
+     */
+    seq: number;
+    sessionId: string;
+    event: AgentEvent;
+}
+/** hello 应答帧（连接受理 + 版本握手结果 + 会话高水位——崩溃对账锚） */
+export interface SdkHelloFrame {
+    kind: 'hello';
+    /** 服务端线协议版本（与请求侧比对，不符即 SDK_PROTOCOL_MISMATCH 拒连） */
+    protocolVersion: number;
+    /** 订阅会话 id（请求侧未携会话订阅时 = 连接级握手缺省会话，随首个 ack 落定） */
+    sessionId: string;
+    /** 会话当前 seq 高水位（约定见文件头——空会话 = 0） */
+    highWaterSeq: number;
+}
+/** 心跳帧（②——idle 超阈值即发；间隔值随落码批实测定，13b 接装配定时） */
+export interface SdkHeartbeatFrame {
+    kind: 'heartbeat';
+    sessionId: string;
+    /** run 态两值闭集（审批挂起属 run 内等待，经 ask 外推事件可观察——不发明第三态） */
+    runState: 'idle' | 'running';
+    /** 当前阶段（idle 态为 null） */
+    stage: SdkHeartbeatStage | null;
+    /** 当前 run 从启动起累计毫秒（idle 态 = 上一 run 尾值或 0） */
+    elapsedMs: number;
+}
+/**
+ * admit 回执帧（④ 幂等 admit——线控事件族四件之一）。同 messageId 同内容重发
+ * = 幂等重收执（回执即既存事件本身，经 after 重放可取——不重跑）。
+ */
+export interface SdkAckFrame {
+    kind: 'ack';
+    sessionId: string;
+    /** 回执所归属的调用方 messageId（受理时即落账为 data.dedupeKey——两词一字段两面） */
+    messageId: string;
+    /** true = 同键同内容既存重收执（幂等档）；false = 新受理 */
+    duplicate: boolean;
+    /**
+     * 路由结果观察字段（驱动侧单源路由进 steer/followUp——04 §4 硬律：三通道判定
+     * 是驱动侧单源、发送方不指定通道；观察非控制）。缺席 = 新开轮（受理时无在飞 run）。
+     */
+    routedChannel?: 'steer' | 'followUp';
+    /** 受理时会话高水位（崩溃对账锚） */
+    highWaterSeq: number;
+}
+/**
+ * 重放游标标记帧（线控事件族四件之四——重放段与直播段的衔接界标）。
+ * 直播起播 = 后续 event 帧 seq > lastReplayedSeq 首条（含未落库在飞——05 §3.5
+ * 衔接序第 ③ 步；重放尾与直播首无缝衔接 = 落码回归锁位，见 ./cursor.ts）。
+ *
+ * 〔2026-09-14 遗漏扫描四役定形：本帧曾携 nextCursor 续读游标位——发射位
+ * （wire-core handleHello）结构性永不携带，属死契约字段已删；v1 serve 桥
+ * 单页全窗成文定案（重放腿跟尽义务由桥并页兑现），跟尽语义活位在 entries
+ * 帧的 nextCursor（getEntries 腿续读位）——03 §10.6 四役注记。〕
+ */
+export interface SdkReplayEndFrame {
+    kind: 'replay-end';
+    sessionId: string;
+    /** 重放段末条 seq（空重放 = after 原值或 −1） */
+    lastReplayedSeq: number;
+}
+/**
+ * 结构化错误帧（⑥ 结构化错误单源：code 直出 contracts 错误码注册表一一对应，
+ * 不发明第二套）。willRetry 系**错误事件载荷位**非新事件型；retryAfterMs 系
+ * `SDK_OVERLOADED` 专属载荷（⑦ 背压——codex -32001 形）。
+ */
+export interface SdkErrorFrame {
+    kind: 'error';
+    /** 关联会话（连接级错误缺席——版本握手拒连等） */
+    sessionId?: string;
+    code: string;
+    message: string;
+    /** 可重试位（错误事件载荷位——重试期不打断事件流，进度并入心跳载荷） */
+    willRetry?: boolean;
+    /** SDK_OVERLOADED 携带：建议重试等待毫秒 */
+    retryAfterMs?: number;
+}
+/**
+ * durable 事件线面平铺投影形（重放/getEntries 载荷——批 13b 落码定形）。
+ * 05 §1.1 durable 事件信封的线面投影：{type, seq, time, data} 平铺直出
+ * （queryEntries 同源读面——05 §3.5 第一腿「服务端实现即 queryEvents 同源
+ * 读面，无第二查询机制」）；type 词汇 = durable 十五型（线面透传不二校验——
+ * 词汇注册表单源在 session 侧）。双轨律见 {@link SdkEventFrame} 文注——
+ * 本形只走重放/对账段，永不走直播段。
+ */
+export interface SdkDurableEntry {
+    /** durable 事件类型（05 §1.1 词汇——`user/message` 式） */
+    type: string;
+    /** per-session 单调 seq（= 写入时 log.length——重放游标/对账锚） */
+    seq: number;
+    /** Unix 毫秒时间戳 */
+    time: number;
+    /** 事件载荷（frozen 投影——预算刀裁后形） */
+    data: unknown;
+}
+/** getEntries 应答帧——断线对账读面（服务端实现即 queryEvents 同源读面，05 §3.5 第一腿） */
+export interface SdkEntriesFrame {
+    kind: 'entries';
+    sessionId: string;
+    /** (since, 高水位] 窗口内 durable 事件（重放源 = 会话内存日志——含未落库在飞，装配桥接） */
+    entries: SdkDurableEntry[];
+    /**
+     * 分页续读游标（05 §3.4 强制有帽有界——缺省帽 1000 / 硬帽 10000；缺席 =
+     * 已跟尽）。跟尽义务在调用方：在场即携 cursor 续读（SdkGetEntriesRequest
+     * .cursor 位回传），单页即止 = 截断不报错（系调用方违约，协议不补发）——
+     * 2026-09-14 四役定形：跟尽语义单源在本帧（replay-end 帧曾携同名字段系
+     * 死契约位已删，见彼处文注）。
+     */
+    nextCursor?: string;
+}
+/** sessions 应答帧——会话清单（与 webui §10.4 会话族端点同读面，词面本批定形） */
+export interface SdkSessionsFrame {
+    kind: 'sessions';
+    sessions: SdkSessionSummary[];
+}
+/** 会话清单条目（id/标题/末活动时间——03 §10.6 请求面动词族条 sessions 词面定形） */
+export interface SdkSessionSummary {
+    id: string;
+    /** 无标题会话为 null（不造占位串） */
+    title: string | null;
+    /** 末活动时间 epoch 毫秒 */
+    lastActivityAt: number;
+}
+/** decide 应答帧——跨入口审批竞速回执（03 §10.6 审批外推第三腿） */
+export interface SdkDecideResultFrame {
+    kind: 'decide-result';
+    /** 所应答审批标识（与 ask 外推事件载荷同词同源——contracts ApprovalAskRequest.approvalId） */
+    approvalId: string;
+    /** applied = 本应答先 settle 胜出；superseded = 已被他入口应答（幂等回执——TUI/web/SDK 三入口同漏斗） */
+    outcome: 'applied' | 'superseded';
+}
+/**
+ * 审批 ask 外推帧（03 §10.6 审批外推第三腿：「serve/SDK 面审批 = ask 外推
+ * （线事件）+ decide 请求应答——汇入 10.4 跨入口审批同一 pending Promise
+ * 竞速」）。审批是挂起态非活体流——独立帧族（不入 SDK_FRAME_KINDS 的 event
+ * 位、不占 seq、不进 durable）；重连补推：hello 订阅受理后未决 ask 全量重推
+ * （decide 的应答面才不断线）。approvalId 由 SDK 后端指派（contracts
+ * ApprovalAskRequest.approvalId 缺席时补一——挂起身份短形，多连接防串答）。
+ */
+export interface SdkAskFrame {
+    kind: 'ask';
+    sessionId: string;
+    /** 挂起审批身份（decide 请求以此应答——同词同源） */
+    approvalId: string;
+    /** 目标动作摘要（人可读一行） */
+    summary: string;
+    /** 请求方/理由（可选呈现） */
+    reason?: string;
+    /** 发起审批的工具名（可选呈现） */
+    toolName?: string;
+    /** 「始终允许」草案条目（always 应答的策略表回写目标——缺席 = always 视同 approve） */
+    suggestedEntry?: string;
+}
+/** 服务端 → 调用方线帧全族（判别字段 `kind`；闭集见 {@link SDK_FRAME_KINDS}） */
+export type SdkWireFrame = SdkEventFrame | SdkHelloFrame | SdkHeartbeatFrame | SdkAckFrame | SdkReplayEndFrame | SdkErrorFrame | SdkEntriesFrame | SdkSessionsFrame | SdkDecideResultFrame | SdkAskFrame;
+/**
+ * 线帧 kind 闭集（十：活体事件帧 + 线控四件〔hello/heartbeat/ack/replay-end〕+
+ * 请求应答三件〔entries/sessions/decide-result〕+ 错误帧 + ask 审批外推帧——
+ * ask 独立于 event 位，审批挂起态非活体流，见 {@link SdkAskFrame} 文注）。
+ */
+export declare const SDK_FRAME_KINDS: readonly ["event", "hello", "heartbeat", "ack", "replay-end", "error", "entries", "sessions", "decide-result", "ask"];
+/**
+ * hello 请求（握手动词）。sessionId 携带 = 续接并订阅该会话事件流（携 after 先
+ * 重放后直播）；缺席 = 连接级握手（后续 prompt 按各自 sessionId 路由——stdio 单
+ * 连接内复用 N 会话，07 §5 serve 细则④）。after 缺席 = 只直播不重放。
+ */
+export interface SdkHelloRequest {
+    verb: 'hello';
+    protocolVersion: number;
+    sessionId?: string;
+    /** 订阅游标：重放窗口 = (after, 订阅时高水位]；合法性见 ./cursor.ts */
+    after?: number;
+    /**
+     * 退订 message_update delta（`--no-delta` 线面承载位——07 §5 serve 细则：
+     * 降流量档；durable 定稿事件不受影响——只剥直播 delta 流）。受理后本连接
+     * 不再外推 message_update 帧（Ended 帧/重放面照常）。
+     */
+    noDelta?: boolean;
+}
+/**
+ * prompt 请求（新发——携 messageId 幂等键）。**prompt 单入口、调用方不选通道**：
+ * 会话内在飞 run 时的并发 prompt 由驱动侧单源路由进 steer/followUp（04 §4 硬律），
+ * 路由结果随 ack 观察字段回示；三通道词 steer/followUp/inject 不出现在请求面。
+ * sessionId 缺席即新建会话（ack 与事件信封必携 sessionId——调用方以首应答获
+ * 会话句柄）；显式携带即续接；命中已闭会话回结构化错误（对齐 webui 已闭 404 语义）。
+ */
+export interface SdkPromptRequest {
+    verb: 'prompt';
+    /** 调用方自选幂等键——受理时即落账为 data.dedupeKey（05 §3.5 两词一字段两面） */
+    messageId: string;
+    content: string;
+    sessionId?: string;
+}
+/** interrupt 请求（受理经事件流可观察：turn/end reason='interrupted'；心跳转 idle） */
+export interface SdkInterruptRequest {
+    verb: 'interrupt';
+    sessionId: string;
+}
+/**
+ * decide 请求（审批应答——汇入 10.4 跨入口审批同一 pending Promise 竞速：先
+ * settle 者胜、后到 superseded 幂等回执）。answer 值域 = contracts
+ * ApprovalAskAnswer 四值闭集（approve/reject/cancel/always——与 TUI/web 入口
+ * 同一 settle 值域，跨入口竞速语义才闭合）；approvalId 与 ask 外推事件载荷
+ * 同词同源（contracts ApprovalAskRequest.approvalId）。
+ */
+export interface SdkDecideRequest {
+    verb: 'decide';
+    approvalId: string;
+    answer: ApprovalAskAnswer;
+    /** 应答附注（进审批审计面，可选） */
+    note?: string;
+}
+/** getEntries 请求（断线对账——since 语义同 hello.after：窗口 (since, 高水位]） */
+export interface SdkGetEntriesRequest {
+    verb: 'getEntries';
+    sessionId: string;
+    since: number;
+    /** 分页续读游标（首轮缺席；跟尽义务在调用方） */
+    cursor?: string;
+}
+/** sessions 请求（会话清单——id/标题/末活动时间） */
+export interface SdkSessionsRequest {
+    verb: 'sessions';
+}
+/** 调用方请求全族（判别字段 `verb`；闭集见 {@link SDK_REQUEST_VERBS}） */
+export type SdkRequest = SdkHelloRequest | SdkPromptRequest | SdkInterruptRequest | SdkDecideRequest | SdkGetEntriesRequest | SdkSessionsRequest;
+/**
+ * 请求动词六件闭集（03 §10.6 请求面动词族条——v1 收窄律；steer/followUp/inject
+ * 三通道词**不在场**是执法位：驱动侧单源律的结构锁，测试断言在册）。
+ */
+export declare const SDK_REQUEST_VERBS: readonly ["hello", "prompt", "interrupt", "decide", "getEntries", "sessions"];

package/dist/src/channels/sdk/protocol.js

@@ -0,0 +1,25 @@
+/** 线协议版本（③/⑤ 版本握手第一天就有：连接即 hello 双方携 protocolVersion 比对） */
+export const SDK_PROTOCOL_VERSION = 1;
+/**
+ * 线帧 kind 闭集（十：活体事件帧 + 线控四件〔hello/heartbeat/ack/replay-end〕+
+ * 请求应答三件〔entries/sessions/decide-result〕+ 错误帧 + ask 审批外推帧——
+ * ask 独立于 event 位，审批挂起态非活体流，见 {@link SdkAskFrame} 文注）。
+ */
+export const SDK_FRAME_KINDS = [
+    'event',
+    'hello',
+    'heartbeat',
+    'ack',
+    'replay-end',
+    'error',
+    'entries',
+    'sessions',
+    'decide-result',
+    'ask',
+];
+/**
+ * 请求动词六件闭集（03 §10.6 请求面动词族条——v1 收窄律；steer/followUp/inject
+ * 三通道词**不在场**是执法位：驱动侧单源律的结构锁，测试断言在册）。
+ */
+export const SDK_REQUEST_VERBS = ['hello', 'prompt', 'interrupt', 'decide', 'getEntries', 'sessions'];
+//# sourceMappingURL=protocol.js.map

package/dist/src/channels/sdk/protocol.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"protocol.js","sourceRoot":"","sources":["../../../../../../src/channels/sdk/protocol.ts"],"names":[],"mappings":"AAiBA,4DAA4D;AAC5D,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC;AAkOtC;;;;GAIG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,OAAO;IACP,OAAO;IACP,WAAW;IACX,KAAK;IACL,YAAY;IACZ,OAAO;IACP,SAAS;IACT,UAAU;IACV,eAAe;IACf,KAAK;CACG,CAAC;AAoFX;;;GAGG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,QAAQ,EAAE,YAAY,EAAE,UAAU,CAAU,CAAC"}

package/dist/src/channels/sdk/schema.d.ts

@@ -0,0 +1,12 @@
+import type { SdkRequest } from './protocol.js';
+/**
+ * 请求深校验（非抛型）。输入须已过 jsonl.ts 结构层（verb 在闭集内）——本层
+ * 补逐字段校验；独立调用时对判别字段缺席/闭集外同样诚实拒收（reason 单句）。
+ */
+export declare function validateSdkRequest(value: unknown): {
+    ok: true;
+    value: SdkRequest;
+} | {
+    ok: false;
+    reason: string;
+};

package/dist/src/channels/sdk/schema.js

@@ -0,0 +1,92 @@
+/**
+ * SDK 线协议请求面 typebox 深校验（03 §10.6 请求面动词族条「每动词 typebox
+ * schema 校验后消费——webui 微路由同纪律」；13a 挂账批 13e 兑现件）。
+ *
+ * 单源律：六动词 schema 全集即请求面唯一深校验真源——stdio 解码位
+ * （./jsonl.ts decodeWireLine 尾段）与 HTTP 体校验位（core:sdk 件经 channels
+ * 公开面消费）同源接入，零第二套。结构层（判别字段闭集/必填标量型）仍由
+ * jsonl.ts 先行快校——本层补齐逐字段型/选填语义/未知字段拒收。
+ *
+ * 非抛型结果面：{ok, value} | {ok:false, reason}——错误帧映射归宿主传输层
+ * （stdio = SdkDecodeError 包装；HTTP = 400 携结构化错误码），本层零错误词。
+ */
+import { Type } from 'typebox';
+import { Value } from 'typebox/value';
+// 顶部 typebox 注入形态说明：typebox 主包 + value 子路径均入 channels externals
+// 白名单（tools/conversation/web/exec/skills 同律——schema 层宿主件直用）。
+/** 公共字段词面：未知字段拒收（收窄律执法——请求面六动词载荷即全集） */
+const strict = { additionalProperties: false };
+/** hello 请求 schema（protocolVersion 必填；sessionId/after/noDelta 选填） */
+const HelloSchema = Type.Object({
+    verb: Type.Literal('hello'),
+    protocolVersion: Type.Integer(),
+    sessionId: Type.Optional(Type.String()),
+    after: Type.Optional(Type.Integer()),
+    noDelta: Type.Optional(Type.Boolean()),
+}, strict);
+/** prompt 请求 schema（messageId/content 必填；sessionId 选填——缺席即新建） */
+const PromptSchema = Type.Object({
+    verb: Type.Literal('prompt'),
+    messageId: Type.String(),
+    content: Type.String(),
+    sessionId: Type.Optional(Type.String()),
+}, strict);
+/** interrupt 请求 schema（sessionId 必填） */
+const InterruptSchema = Type.Object({
+    verb: Type.Literal('interrupt'),
+    sessionId: Type.String(),
+}, strict);
+/** decide 请求 schema（approvalId/answer 必填；note 选填——answer 四值闭集） */
+const DecideSchema = Type.Object({
+    verb: Type.Literal('decide'),
+    approvalId: Type.String(),
+    answer: Type.Union([
+        Type.Literal('approve'),
+        Type.Literal('reject'),
+        Type.Literal('cancel'),
+        Type.Literal('always'),
+    ]),
+    note: Type.Optional(Type.String()),
+}, strict);
+/** getEntries 请求 schema（sessionId/since 必填；cursor 选填——分页续读） */
+const GetEntriesSchema = Type.Object({
+    verb: Type.Literal('getEntries'),
+    sessionId: Type.String(),
+    since: Type.Integer(),
+    cursor: Type.Optional(Type.String()),
+}, strict);
+/** sessions 请求 schema（零载荷） */
+const SessionsSchema = Type.Object({ verb: Type.Literal('sessions') }, strict);
+/** 六动词 schema 分派表（verb 判别字段路由——与 SDK_REQUEST_VERBS 同序） */
+const SCHEMAS_BY_VERB = {
+    hello: HelloSchema,
+    prompt: PromptSchema,
+    interrupt: InterruptSchema,
+    decide: DecideSchema,
+    getEntries: GetEntriesSchema,
+    sessions: SessionsSchema,
+};
+/**
+ * 请求深校验（非抛型）。输入须已过 jsonl.ts 结构层（verb 在闭集内）——本层
+ * 补逐字段校验；独立调用时对判别字段缺席/闭集外同样诚实拒收（reason 单句）。
+ */
+export function validateSdkRequest(value) {
+    if (typeof value !== 'object' || value === null) {
+        return { ok: false, reason: '请求须为 JSON 对象' };
+    }
+    const verb = value.verb;
+    const schema = typeof verb === 'string' ? SCHEMAS_BY_VERB[verb] : undefined;
+    if (schema === undefined) {
+        return { ok: false, reason: `请求动词不识别（verb=${String(verb)}——闭集外或缺席）` };
+    }
+    if (!Value.Check(schema, value)) {
+        // 逐字段首错定位（fail-loud 可行动报因——webui 微路由同纪律）
+        const errors = [...Value.Errors(schema, value)];
+        const first = errors[0];
+        const at = first === undefined ? '' : `（${first.instancePath || '(root)'}：${first.message}）`;
+        return { ok: false, reason: `${verb} 请求载荷不合 schema${at}` };
+    }
+    // Value.Check 通过即结构吻合 SdkRequest 判别联合——窄化断言位
+    return { ok: true, value: value };
+}
+//# sourceMappingURL=schema.js.map

package/dist/src/channels/sdk/schema.js.map

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