@agent-phonon/protocol 0.2.0

package/dist/schemas/stream.d.ts

@@ -0,0 +1,688 @@
+import { z } from "zod";
+/**
+ * 流式事件（design §4 / §6 / 订阅模型）——phonon → server 异步推送。
+ *
+ * 关键：session 不只是「请求-响应」，还是一条**可订阅的持续输出流**。
+ * 输出分两种来源（origin）：
+ *   - solicited  ：某次 session.send 触发的响应（用 send 返回的 turnId）。
+ *   - unsolicited：agent 自发输出（OpenClaw 的 cron/定时/心跳），无 send 触发；
+ *                  turnId 由 phonon 生成，source 标明冲泡来源。
+ *
+ * “create 即订阅”：server 拥有的 session 的**所有** stream.event（含自发）都自动
+ * 推给该 tenant 连接，无需显式 subscribe。Codex 一次性 session 流到 result final 就停；
+ * OpenClaw 持久 session 即使不 send 也会持续往上冒。
+ *
+ * 不同事件对应不同 verbosity 档位：
+ *   final    → 只会收到 result
+ *   messages → message + result
+ *   tools    → message + tool_call + tool_result + result
+ *   trace    → 以上 + thinking + token delta
+ */
+/** 输出来源：请求触发 vs agent 自发。 */
+export declare const StreamOrigin: z.ZodEnum<["solicited", "unsolicited"]>;
+export type StreamOrigin = z.infer<typeof StreamOrigin>;
+/** 事件种类。 */
+export declare const StreamEventType: z.ZodEnum<["message", "thinking", "tool_call", "tool_result", "token", "result", "error"]>;
+export type StreamEventType = z.infer<typeof StreamEventType>;
+export declare const StreamMessageEvent: z.ZodObject<{
+    sessionId: z.ZodBranded<z.ZodString, "SessionId">;
+    /**
+     * 本轮关联 id。solicited 事件用 send 返回的 turnId；
+     * unsolicited（自发）事件由 phonon 生成，server 从事件中首次见到。
+     */
+    turnId: z.ZodString;
+    /** 输出来源：默认 solicited；agent 自发为 unsolicited。 */
+    origin: z.ZodDefault<z.ZodEnum<["solicited", "unsolicited"]>>;
+    /** unsolicited 时的冲泡来源标签，如 "cron" / "scheduled" / "heartbeat"。 */
+    source: z.ZodOptional<z.ZodString>;
+    /** 单调递增序号（按 session），保证调用方可排序/去重。 */
+    seq: z.ZodNumber;
+    at: z.ZodString;
+} & {
+    type: z.ZodLiteral<"message">;
+    role: z.ZodDefault<z.ZodEnum<["assistant", "user", "system"]>>;
+    text: z.ZodString;
+    /** 是否为增量分片（true 表示需要与同 turn 的后续 message 拼接）。 */
+    delta: z.ZodDefault<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    at: string;
+    type: "message";
+    sessionId: string & z.BRAND<"SessionId">;
+    role: "system" | "user" | "assistant";
+    turnId: string;
+    origin: "solicited" | "unsolicited";
+    seq: number;
+    text: string;
+    delta: boolean;
+    source?: string | undefined;
+}, {
+    at: string;
+    type: "message";
+    sessionId: string;
+    turnId: string;
+    seq: number;
+    text: string;
+    role?: "system" | "user" | "assistant" | undefined;
+    origin?: "solicited" | "unsolicited" | undefined;
+    source?: string | undefined;
+    delta?: boolean | undefined;
+}>;
+export declare const StreamThinkingEvent: z.ZodObject<{
+    sessionId: z.ZodBranded<z.ZodString, "SessionId">;
+    /**
+     * 本轮关联 id。solicited 事件用 send 返回的 turnId；
+     * unsolicited（自发）事件由 phonon 生成，server 从事件中首次见到。
+     */
+    turnId: z.ZodString;
+    /** 输出来源：默认 solicited；agent 自发为 unsolicited。 */
+    origin: z.ZodDefault<z.ZodEnum<["solicited", "unsolicited"]>>;
+    /** unsolicited 时的冲泡来源标签，如 "cron" / "scheduled" / "heartbeat"。 */
+    source: z.ZodOptional<z.ZodString>;
+    /** 单调递增序号（按 session），保证调用方可排序/去重。 */
+    seq: z.ZodNumber;
+    at: z.ZodString;
+} & {
+    type: z.ZodLiteral<"thinking">;
+    text: z.ZodString;
+    delta: z.ZodDefault<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    at: string;
+    type: "thinking";
+    sessionId: string & z.BRAND<"SessionId">;
+    turnId: string;
+    origin: "solicited" | "unsolicited";
+    seq: number;
+    text: string;
+    delta: boolean;
+    source?: string | undefined;
+}, {
+    at: string;
+    type: "thinking";
+    sessionId: string;
+    turnId: string;
+    seq: number;
+    text: string;
+    origin?: "solicited" | "unsolicited" | undefined;
+    source?: string | undefined;
+    delta?: boolean | undefined;
+}>;
+export declare const StreamToolCallEvent: z.ZodObject<{
+    sessionId: z.ZodBranded<z.ZodString, "SessionId">;
+    /**
+     * 本轮关联 id。solicited 事件用 send 返回的 turnId；
+     * unsolicited（自发）事件由 phonon 生成，server 从事件中首次见到。
+     */
+    turnId: z.ZodString;
+    /** 输出来源：默认 solicited；agent 自发为 unsolicited。 */
+    origin: z.ZodDefault<z.ZodEnum<["solicited", "unsolicited"]>>;
+    /** unsolicited 时的冲泡来源标签，如 "cron" / "scheduled" / "heartbeat"。 */
+    source: z.ZodOptional<z.ZodString>;
+    /** 单调递增序号（按 session），保证调用方可排序/去重。 */
+    seq: z.ZodNumber;
+    at: z.ZodString;
+} & {
+    type: z.ZodLiteral<"tool_call">;
+    toolName: z.ZodString;
+    /** 工具入参（原样透传，结构由 agent/工具决定）。 */
+    args: z.ZodOptional<z.ZodUnknown>;
+    /** 工具调用 id，用于和 tool_result 配对。 */
+    toolCallId: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    at: string;
+    type: "tool_call";
+    sessionId: string & z.BRAND<"SessionId">;
+    turnId: string;
+    origin: "solicited" | "unsolicited";
+    seq: number;
+    toolName: string;
+    source?: string | undefined;
+    args?: unknown;
+    toolCallId?: string | undefined;
+}, {
+    at: string;
+    type: "tool_call";
+    sessionId: string;
+    turnId: string;
+    seq: number;
+    toolName: string;
+    origin?: "solicited" | "unsolicited" | undefined;
+    source?: string | undefined;
+    args?: unknown;
+    toolCallId?: string | undefined;
+}>;
+export declare const StreamToolResultEvent: z.ZodObject<{
+    sessionId: z.ZodBranded<z.ZodString, "SessionId">;
+    /**
+     * 本轮关联 id。solicited 事件用 send 返回的 turnId；
+     * unsolicited（自发）事件由 phonon 生成，server 从事件中首次见到。
+     */
+    turnId: z.ZodString;
+    /** 输出来源：默认 solicited；agent 自发为 unsolicited。 */
+    origin: z.ZodDefault<z.ZodEnum<["solicited", "unsolicited"]>>;
+    /** unsolicited 时的冲泡来源标签，如 "cron" / "scheduled" / "heartbeat"。 */
+    source: z.ZodOptional<z.ZodString>;
+    /** 单调递增序号（按 session），保证调用方可排序/去重。 */
+    seq: z.ZodNumber;
+    at: z.ZodString;
+} & {
+    type: z.ZodLiteral<"tool_result">;
+    toolName: z.ZodString;
+    toolCallId: z.ZodOptional<z.ZodString>;
+    ok: z.ZodBoolean;
+    /** 工具输出（可能被截断，取决于 verbosity/大小限制）。 */
+    output: z.ZodOptional<z.ZodUnknown>;
+}, "strip", z.ZodTypeAny, {
+    at: string;
+    type: "tool_result";
+    sessionId: string & z.BRAND<"SessionId">;
+    turnId: string;
+    origin: "solicited" | "unsolicited";
+    seq: number;
+    toolName: string;
+    ok: boolean;
+    source?: string | undefined;
+    toolCallId?: string | undefined;
+    output?: unknown;
+}, {
+    at: string;
+    type: "tool_result";
+    sessionId: string;
+    turnId: string;
+    seq: number;
+    toolName: string;
+    ok: boolean;
+    origin?: "solicited" | "unsolicited" | undefined;
+    source?: string | undefined;
+    toolCallId?: string | undefined;
+    output?: unknown;
+}>;
+export declare const StreamTokenEvent: z.ZodObject<{
+    sessionId: z.ZodBranded<z.ZodString, "SessionId">;
+    /**
+     * 本轮关联 id。solicited 事件用 send 返回的 turnId；
+     * unsolicited（自发）事件由 phonon 生成，server 从事件中首次见到。
+     */
+    turnId: z.ZodString;
+    /** 输出来源：默认 solicited；agent 自发为 unsolicited。 */
+    origin: z.ZodDefault<z.ZodEnum<["solicited", "unsolicited"]>>;
+    /** unsolicited 时的冲泡来源标签，如 "cron" / "scheduled" / "heartbeat"。 */
+    source: z.ZodOptional<z.ZodString>;
+    /** 单调递增序号（按 session），保证调用方可排序/去重。 */
+    seq: z.ZodNumber;
+    at: z.ZodString;
+} & {
+    type: z.ZodLiteral<"token">;
+    text: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    at: string;
+    type: "token";
+    sessionId: string & z.BRAND<"SessionId">;
+    turnId: string;
+    origin: "solicited" | "unsolicited";
+    seq: number;
+    text: string;
+    source?: string | undefined;
+}, {
+    at: string;
+    type: "token";
+    sessionId: string;
+    turnId: string;
+    seq: number;
+    text: string;
+    origin?: "solicited" | "unsolicited" | undefined;
+    source?: string | undefined;
+}>;
+export declare const StreamResultEvent: z.ZodObject<{
+    sessionId: z.ZodBranded<z.ZodString, "SessionId">;
+    /**
+     * 本轮关联 id。solicited 事件用 send 返回的 turnId；
+     * unsolicited（自发）事件由 phonon 生成，server 从事件中首次见到。
+     */
+    turnId: z.ZodString;
+    /** 输出来源：默认 solicited；agent 自发为 unsolicited。 */
+    origin: z.ZodDefault<z.ZodEnum<["solicited", "unsolicited"]>>;
+    /** unsolicited 时的冲泡来源标签，如 "cron" / "scheduled" / "heartbeat"。 */
+    source: z.ZodOptional<z.ZodString>;
+    /** 单调递增序号（按 session），保证调用方可排序/去重。 */
+    seq: z.ZodNumber;
+    at: z.ZodString;
+} & {
+    type: z.ZodLiteral<"result">;
+    /** 本轮最终文本结果。 */
+    text: z.ZodString;
+    /** 可选 usage 统计。 */
+    usage: z.ZodOptional<z.ZodObject<{
+        inputTokens: z.ZodOptional<z.ZodNumber>;
+        outputTokens: z.ZodOptional<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        inputTokens?: number | undefined;
+        outputTokens?: number | undefined;
+    }, {
+        inputTokens?: number | undefined;
+        outputTokens?: number | undefined;
+    }>>;
+    /**
+     * 本轮终态（P0-2）——每个 turn 必须有明确终态，服务端状态机才不会悬空：
+     * completed   正常完成
+     * interrupted 被 session.interrupt 打断
+     * aborted     被 hook abort / 主动中止
+     * failed      出错终止（详情另见 error 事件）
+     * timeout     超时
+     */
+    status: z.ZodDefault<z.ZodEnum<["completed", "interrupted", "aborted", "failed", "timeout"]>>;
+    /** 标记本轮结束。 */
+    final: z.ZodLiteral<true>;
+}, "strip", z.ZodTypeAny, {
+    at: string;
+    type: "result";
+    status: "aborted" | "interrupted" | "completed" | "failed" | "timeout";
+    final: true;
+    sessionId: string & z.BRAND<"SessionId">;
+    turnId: string;
+    origin: "solicited" | "unsolicited";
+    seq: number;
+    text: string;
+    source?: string | undefined;
+    usage?: {
+        inputTokens?: number | undefined;
+        outputTokens?: number | undefined;
+    } | undefined;
+}, {
+    at: string;
+    type: "result";
+    final: true;
+    sessionId: string;
+    turnId: string;
+    seq: number;
+    text: string;
+    status?: "aborted" | "interrupted" | "completed" | "failed" | "timeout" | undefined;
+    origin?: "solicited" | "unsolicited" | undefined;
+    source?: string | undefined;
+    usage?: {
+        inputTokens?: number | undefined;
+        outputTokens?: number | undefined;
+    } | undefined;
+}>;
+export declare const StreamErrorEvent: z.ZodObject<{
+    sessionId: z.ZodBranded<z.ZodString, "SessionId">;
+    /**
+     * 本轮关联 id。solicited 事件用 send 返回的 turnId；
+     * unsolicited（自发）事件由 phonon 生成，server 从事件中首次见到。
+     */
+    turnId: z.ZodString;
+    /** 输出来源：默认 solicited；agent 自发为 unsolicited。 */
+    origin: z.ZodDefault<z.ZodEnum<["solicited", "unsolicited"]>>;
+    /** unsolicited 时的冲泡来源标签，如 "cron" / "scheduled" / "heartbeat"。 */
+    source: z.ZodOptional<z.ZodString>;
+    /** 单调递增序号（按 session），保证调用方可排序/去重。 */
+    seq: z.ZodNumber;
+    at: z.ZodString;
+} & {
+    type: z.ZodLiteral<"error">;
+    message: z.ZodString;
+    /** 可选应用错误码（与 common.PhononErrorCode 对齐）。 */
+    appCode: z.ZodOptional<z.ZodString>;
+    /** 终态（与 result.status 对齐，错误场景通常 failed/aborted/timeout）。 */
+    status: z.ZodDefault<z.ZodEnum<["failed", "aborted", "timeout", "interrupted"]>>;
+    final: z.ZodLiteral<true>;
+}, "strip", z.ZodTypeAny, {
+    at: string;
+    message: string;
+    type: "error";
+    status: "aborted" | "interrupted" | "failed" | "timeout";
+    final: true;
+    sessionId: string & z.BRAND<"SessionId">;
+    turnId: string;
+    origin: "solicited" | "unsolicited";
+    seq: number;
+    appCode?: string | undefined;
+    source?: string | undefined;
+}, {
+    at: string;
+    message: string;
+    type: "error";
+    final: true;
+    sessionId: string;
+    turnId: string;
+    seq: number;
+    status?: "aborted" | "interrupted" | "failed" | "timeout" | undefined;
+    appCode?: string | undefined;
+    origin?: "solicited" | "unsolicited" | undefined;
+    source?: string | undefined;
+}>;
+export declare const StreamAckParams: z.ZodObject<{
+    /** 按 session 确认；缺省表示该连接全局。 */
+    sessionId: z.ZodOptional<z.ZodBranded<z.ZodString, "SessionId">>;
+    /** 已收到的最大连续 seq（含）；phonon 可清理 <= 此值的 outbox。 */
+    lastSeq: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    lastSeq: number;
+    sessionId?: (string & z.BRAND<"SessionId">) | undefined;
+}, {
+    lastSeq: number;
+    sessionId?: string | undefined;
+}>;
+export type StreamAckParams = z.infer<typeof StreamAckParams>;
+/** 流式事件联合体（phonon → server，方法名 stream.event）。 */
+export declare const StreamEvent: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
+    sessionId: z.ZodBranded<z.ZodString, "SessionId">;
+    /**
+     * 本轮关联 id。solicited 事件用 send 返回的 turnId；
+     * unsolicited（自发）事件由 phonon 生成，server 从事件中首次见到。
+     */
+    turnId: z.ZodString;
+    /** 输出来源：默认 solicited；agent 自发为 unsolicited。 */
+    origin: z.ZodDefault<z.ZodEnum<["solicited", "unsolicited"]>>;
+    /** unsolicited 时的冲泡来源标签，如 "cron" / "scheduled" / "heartbeat"。 */
+    source: z.ZodOptional<z.ZodString>;
+    /** 单调递增序号（按 session），保证调用方可排序/去重。 */
+    seq: z.ZodNumber;
+    at: z.ZodString;
+} & {
+    type: z.ZodLiteral<"message">;
+    role: z.ZodDefault<z.ZodEnum<["assistant", "user", "system"]>>;
+    text: z.ZodString;
+    /** 是否为增量分片（true 表示需要与同 turn 的后续 message 拼接）。 */
+    delta: z.ZodDefault<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    at: string;
+    type: "message";
+    sessionId: string & z.BRAND<"SessionId">;
+    role: "system" | "user" | "assistant";
+    turnId: string;
+    origin: "solicited" | "unsolicited";
+    seq: number;
+    text: string;
+    delta: boolean;
+    source?: string | undefined;
+}, {
+    at: string;
+    type: "message";
+    sessionId: string;
+    turnId: string;
+    seq: number;
+    text: string;
+    role?: "system" | "user" | "assistant" | undefined;
+    origin?: "solicited" | "unsolicited" | undefined;
+    source?: string | undefined;
+    delta?: boolean | undefined;
+}>, z.ZodObject<{
+    sessionId: z.ZodBranded<z.ZodString, "SessionId">;
+    /**
+     * 本轮关联 id。solicited 事件用 send 返回的 turnId；
+     * unsolicited（自发）事件由 phonon 生成，server 从事件中首次见到。
+     */
+    turnId: z.ZodString;
+    /** 输出来源：默认 solicited；agent 自发为 unsolicited。 */
+    origin: z.ZodDefault<z.ZodEnum<["solicited", "unsolicited"]>>;
+    /** unsolicited 时的冲泡来源标签，如 "cron" / "scheduled" / "heartbeat"。 */
+    source: z.ZodOptional<z.ZodString>;
+    /** 单调递增序号（按 session），保证调用方可排序/去重。 */
+    seq: z.ZodNumber;
+    at: z.ZodString;
+} & {
+    type: z.ZodLiteral<"thinking">;
+    text: z.ZodString;
+    delta: z.ZodDefault<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    at: string;
+    type: "thinking";
+    sessionId: string & z.BRAND<"SessionId">;
+    turnId: string;
+    origin: "solicited" | "unsolicited";
+    seq: number;
+    text: string;
+    delta: boolean;
+    source?: string | undefined;
+}, {
+    at: string;
+    type: "thinking";
+    sessionId: string;
+    turnId: string;
+    seq: number;
+    text: string;
+    origin?: "solicited" | "unsolicited" | undefined;
+    source?: string | undefined;
+    delta?: boolean | undefined;
+}>, z.ZodObject<{
+    sessionId: z.ZodBranded<z.ZodString, "SessionId">;
+    /**
+     * 本轮关联 id。solicited 事件用 send 返回的 turnId；
+     * unsolicited（自发）事件由 phonon 生成，server 从事件中首次见到。
+     */
+    turnId: z.ZodString;
+    /** 输出来源：默认 solicited；agent 自发为 unsolicited。 */
+    origin: z.ZodDefault<z.ZodEnum<["solicited", "unsolicited"]>>;
+    /** unsolicited 时的冲泡来源标签，如 "cron" / "scheduled" / "heartbeat"。 */
+    source: z.ZodOptional<z.ZodString>;
+    /** 单调递增序号（按 session），保证调用方可排序/去重。 */
+    seq: z.ZodNumber;
+    at: z.ZodString;
+} & {
+    type: z.ZodLiteral<"tool_call">;
+    toolName: z.ZodString;
+    /** 工具入参（原样透传，结构由 agent/工具决定）。 */
+    args: z.ZodOptional<z.ZodUnknown>;
+    /** 工具调用 id，用于和 tool_result 配对。 */
+    toolCallId: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    at: string;
+    type: "tool_call";
+    sessionId: string & z.BRAND<"SessionId">;
+    turnId: string;
+    origin: "solicited" | "unsolicited";
+    seq: number;
+    toolName: string;
+    source?: string | undefined;
+    args?: unknown;
+    toolCallId?: string | undefined;
+}, {
+    at: string;
+    type: "tool_call";
+    sessionId: string;
+    turnId: string;
+    seq: number;
+    toolName: string;
+    origin?: "solicited" | "unsolicited" | undefined;
+    source?: string | undefined;
+    args?: unknown;
+    toolCallId?: string | undefined;
+}>, z.ZodObject<{
+    sessionId: z.ZodBranded<z.ZodString, "SessionId">;
+    /**
+     * 本轮关联 id。solicited 事件用 send 返回的 turnId；
+     * unsolicited（自发）事件由 phonon 生成，server 从事件中首次见到。
+     */
+    turnId: z.ZodString;
+    /** 输出来源：默认 solicited；agent 自发为 unsolicited。 */
+    origin: z.ZodDefault<z.ZodEnum<["solicited", "unsolicited"]>>;
+    /** unsolicited 时的冲泡来源标签，如 "cron" / "scheduled" / "heartbeat"。 */
+    source: z.ZodOptional<z.ZodString>;
+    /** 单调递增序号（按 session），保证调用方可排序/去重。 */
+    seq: z.ZodNumber;
+    at: z.ZodString;
+} & {
+    type: z.ZodLiteral<"tool_result">;
+    toolName: z.ZodString;
+    toolCallId: z.ZodOptional<z.ZodString>;
+    ok: z.ZodBoolean;
+    /** 工具输出（可能被截断，取决于 verbosity/大小限制）。 */
+    output: z.ZodOptional<z.ZodUnknown>;
+}, "strip", z.ZodTypeAny, {
+    at: string;
+    type: "tool_result";
+    sessionId: string & z.BRAND<"SessionId">;
+    turnId: string;
+    origin: "solicited" | "unsolicited";
+    seq: number;
+    toolName: string;
+    ok: boolean;
+    source?: string | undefined;
+    toolCallId?: string | undefined;
+    output?: unknown;
+}, {
+    at: string;
+    type: "tool_result";
+    sessionId: string;
+    turnId: string;
+    seq: number;
+    toolName: string;
+    ok: boolean;
+    origin?: "solicited" | "unsolicited" | undefined;
+    source?: string | undefined;
+    toolCallId?: string | undefined;
+    output?: unknown;
+}>, z.ZodObject<{
+    sessionId: z.ZodBranded<z.ZodString, "SessionId">;
+    /**
+     * 本轮关联 id。solicited 事件用 send 返回的 turnId；
+     * unsolicited（自发）事件由 phonon 生成，server 从事件中首次见到。
+     */
+    turnId: z.ZodString;
+    /** 输出来源：默认 solicited；agent 自发为 unsolicited。 */
+    origin: z.ZodDefault<z.ZodEnum<["solicited", "unsolicited"]>>;
+    /** unsolicited 时的冲泡来源标签，如 "cron" / "scheduled" / "heartbeat"。 */
+    source: z.ZodOptional<z.ZodString>;
+    /** 单调递增序号（按 session），保证调用方可排序/去重。 */
+    seq: z.ZodNumber;
+    at: z.ZodString;
+} & {
+    type: z.ZodLiteral<"token">;
+    text: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    at: string;
+    type: "token";
+    sessionId: string & z.BRAND<"SessionId">;
+    turnId: string;
+    origin: "solicited" | "unsolicited";
+    seq: number;
+    text: string;
+    source?: string | undefined;
+}, {
+    at: string;
+    type: "token";
+    sessionId: string;
+    turnId: string;
+    seq: number;
+    text: string;
+    origin?: "solicited" | "unsolicited" | undefined;
+    source?: string | undefined;
+}>, z.ZodObject<{
+    sessionId: z.ZodBranded<z.ZodString, "SessionId">;
+    /**
+     * 本轮关联 id。solicited 事件用 send 返回的 turnId；
+     * unsolicited（自发）事件由 phonon 生成，server 从事件中首次见到。
+     */
+    turnId: z.ZodString;
+    /** 输出来源：默认 solicited；agent 自发为 unsolicited。 */
+    origin: z.ZodDefault<z.ZodEnum<["solicited", "unsolicited"]>>;
+    /** unsolicited 时的冲泡来源标签，如 "cron" / "scheduled" / "heartbeat"。 */
+    source: z.ZodOptional<z.ZodString>;
+    /** 单调递增序号（按 session），保证调用方可排序/去重。 */
+    seq: z.ZodNumber;
+    at: z.ZodString;
+} & {
+    type: z.ZodLiteral<"result">;
+    /** 本轮最终文本结果。 */
+    text: z.ZodString;
+    /** 可选 usage 统计。 */
+    usage: z.ZodOptional<z.ZodObject<{
+        inputTokens: z.ZodOptional<z.ZodNumber>;
+        outputTokens: z.ZodOptional<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        inputTokens?: number | undefined;
+        outputTokens?: number | undefined;
+    }, {
+        inputTokens?: number | undefined;
+        outputTokens?: number | undefined;
+    }>>;
+    /**
+     * 本轮终态（P0-2）——每个 turn 必须有明确终态，服务端状态机才不会悬空：
+     * completed   正常完成
+     * interrupted 被 session.interrupt 打断
+     * aborted     被 hook abort / 主动中止
+     * failed      出错终止（详情另见 error 事件）
+     * timeout     超时
+     */
+    status: z.ZodDefault<z.ZodEnum<["completed", "interrupted", "aborted", "failed", "timeout"]>>;
+    /** 标记本轮结束。 */
+    final: z.ZodLiteral<true>;
+}, "strip", z.ZodTypeAny, {
+    at: string;
+    type: "result";
+    status: "aborted" | "interrupted" | "completed" | "failed" | "timeout";
+    final: true;
+    sessionId: string & z.BRAND<"SessionId">;
+    turnId: string;
+    origin: "solicited" | "unsolicited";
+    seq: number;
+    text: string;
+    source?: string | undefined;
+    usage?: {
+        inputTokens?: number | undefined;
+        outputTokens?: number | undefined;
+    } | undefined;
+}, {
+    at: string;
+    type: "result";
+    final: true;
+    sessionId: string;
+    turnId: string;
+    seq: number;
+    text: string;
+    status?: "aborted" | "interrupted" | "completed" | "failed" | "timeout" | undefined;
+    origin?: "solicited" | "unsolicited" | undefined;
+    source?: string | undefined;
+    usage?: {
+        inputTokens?: number | undefined;
+        outputTokens?: number | undefined;
+    } | undefined;
+}>, z.ZodObject<{
+    sessionId: z.ZodBranded<z.ZodString, "SessionId">;
+    /**
+     * 本轮关联 id。solicited 事件用 send 返回的 turnId；
+     * unsolicited（自发）事件由 phonon 生成，server 从事件中首次见到。
+     */
+    turnId: z.ZodString;
+    /** 输出来源：默认 solicited；agent 自发为 unsolicited。 */
+    origin: z.ZodDefault<z.ZodEnum<["solicited", "unsolicited"]>>;
+    /** unsolicited 时的冲泡来源标签，如 "cron" / "scheduled" / "heartbeat"。 */
+    source: z.ZodOptional<z.ZodString>;
+    /** 单调递增序号（按 session），保证调用方可排序/去重。 */
+    seq: z.ZodNumber;
+    at: z.ZodString;
+} & {
+    type: z.ZodLiteral<"error">;
+    message: z.ZodString;
+    /** 可选应用错误码（与 common.PhononErrorCode 对齐）。 */
+    appCode: z.ZodOptional<z.ZodString>;
+    /** 终态（与 result.status 对齐，错误场景通常 failed/aborted/timeout）。 */
+    status: z.ZodDefault<z.ZodEnum<["failed", "aborted", "timeout", "interrupted"]>>;
+    final: z.ZodLiteral<true>;
+}, "strip", z.ZodTypeAny, {
+    at: string;
+    message: string;
+    type: "error";
+    status: "aborted" | "interrupted" | "failed" | "timeout";
+    final: true;
+    sessionId: string & z.BRAND<"SessionId">;
+    turnId: string;
+    origin: "solicited" | "unsolicited";
+    seq: number;
+    appCode?: string | undefined;
+    source?: string | undefined;
+}, {
+    at: string;
+    message: string;
+    type: "error";
+    final: true;
+    sessionId: string;
+    turnId: string;
+    seq: number;
+    status?: "aborted" | "interrupted" | "failed" | "timeout" | undefined;
+    appCode?: string | undefined;
+    origin?: "solicited" | "unsolicited" | undefined;
+    source?: string | undefined;
+}>]>;
+export type StreamEvent = z.infer<typeof StreamEvent>;
+//# sourceMappingURL=stream.d.ts.map

package/dist/schemas/stream.d.ts.map

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