@agent-phonon/protocol 0.9.1 → 0.10.0

package/dist/schemas/stream.d.ts

@@ -22,17 +22,44 @@ import { z } from "zod";
 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 declare const StreamEventType: z.ZodEnum<["runtime_settings", "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">;
     turnId: z.ZodString;
     origin: z.ZodDefault<z.ZodEnum<["solicited", "unsolicited"]>>;
     source: z.ZodOptional<z.ZodString>;
+    sourceEventId: z.ZodOptional<z.ZodString>;
+    nativeProactive: z.ZodOptional<z.ZodObject<{
+        anchorRunId: z.ZodString;
+        employeeId: z.ZodString;
+        employeeRevision: z.ZodNumber;
+        upstreamId: z.ZodString;
+        project: z.ZodString;
+        agent: z.ZodString;
+        model: z.ZodString;
+    }, "strict", z.ZodTypeAny, {
+        agent: string;
+        model: string;
+        project: string;
+        employeeId: string;
+        employeeRevision: number;
+        anchorRunId: string;
+        upstreamId: string;
+    }, {
+        agent: string;
+        model: string;
+        project: string;
+        employeeId: string;
+        employeeRevision: number;
+        anchorRunId: string;
+        upstreamId: string;
+    }>>;
     seq: z.ZodNumber;
     at: z.ZodString;
     workflowId: z.ZodOptional<z.ZodString>;
     nodeId: z.ZodOptional<z.ZodString>;
+    nativeRunId: z.ZodOptional<z.ZodString>;
 } & {
     type: z.ZodLiteral<"message">;
     role: z.ZodDefault<z.ZodEnum<["assistant", "user", "system"]>>;
@@ -42,15 +69,26 @@ export declare const StreamMessageEvent: z.ZodObject<{
     at: string;
     type: "message";
     sessionId: string & z.BRAND<"SessionId">;
-    role: "system" | "user" | "assistant";
     turnId: string;
+    role: "system" | "user" | "assistant";
     origin: "solicited" | "unsolicited";
     seq: number;
     text: string;
     delta: boolean;
+    nodeId?: string | undefined;
     source?: string | undefined;
+    sourceEventId?: string | undefined;
+    nativeProactive?: {
+        agent: string;
+        model: string;
+        project: string;
+        employeeId: string;
+        employeeRevision: number;
+        anchorRunId: string;
+        upstreamId: string;
+    } | undefined;
     workflowId?: string | undefined;
-    nodeId?: string | undefined;
+    nativeRunId?: string | undefined;
 }, {
     at: string;
     type: "message";
@@ -58,11 +96,22 @@ export declare const StreamMessageEvent: z.ZodObject<{
     turnId: string;
     seq: number;
     text: string;
+    nodeId?: string | undefined;
+    source?: string | undefined;
     role?: "system" | "user" | "assistant" | undefined;
     origin?: "solicited" | "unsolicited" | undefined;
-    source?: string | undefined;
+    sourceEventId?: string | undefined;
+    nativeProactive?: {
+        agent: string;
+        model: string;
+        project: string;
+        employeeId: string;
+        employeeRevision: number;
+        anchorRunId: string;
+        upstreamId: string;
+    } | undefined;
     workflowId?: string | undefined;
-    nodeId?: string | undefined;
+    nativeRunId?: string | undefined;
     delta?: boolean | undefined;
 }>;
 export declare const StreamThinkingEvent: z.ZodObject<{
@@ -76,6 +125,33 @@ export declare const StreamThinkingEvent: z.ZodObject<{
     origin: z.ZodDefault<z.ZodEnum<["solicited", "unsolicited"]>>;
     /** unsolicited 时的冲泡来源标签，如 "cron" / "scheduled" / "heartbeat"。 */
     source: z.ZodOptional<z.ZodString>;
+    /** Native harness output identity; not a caller-selected conversation or sender. */
+    sourceEventId: z.ZodOptional<z.ZodString>;
+    nativeProactive: z.ZodOptional<z.ZodObject<{
+        anchorRunId: z.ZodString;
+        employeeId: z.ZodString;
+        employeeRevision: z.ZodNumber;
+        upstreamId: z.ZodString;
+        project: z.ZodString;
+        agent: z.ZodString;
+        model: z.ZodString;
+    }, "strict", z.ZodTypeAny, {
+        agent: string;
+        model: string;
+        project: string;
+        employeeId: string;
+        employeeRevision: number;
+        anchorRunId: string;
+        upstreamId: string;
+    }, {
+        agent: string;
+        model: string;
+        project: string;
+        employeeId: string;
+        employeeRevision: number;
+        anchorRunId: string;
+        upstreamId: string;
+    }>>;
     /** 单调递增序号（按 session），保证调用方可排序/去重。 */
     seq: z.ZodNumber;
     at: z.ZodString;
@@ -88,6 +164,8 @@ export declare const StreamThinkingEvent: z.ZodObject<{
     workflowId: z.ZodOptional<z.ZodString>;
     nodeId: z.ZodOptional<z.ZodString>;
     role: z.ZodOptional<z.ZodString>;
+    /** Server-generated native conversation run correlation, stamped by core. */
+    nativeRunId: z.ZodOptional<z.ZodString>;
 } & {
     type: z.ZodLiteral<"thinking">;
     text: z.ZodString;
@@ -101,10 +179,21 @@ export declare const StreamThinkingEvent: z.ZodObject<{
     seq: number;
     text: string;
     delta: boolean;
-    role?: string | undefined;
+    nodeId?: string | undefined;
     source?: string | undefined;
+    role?: string | undefined;
+    sourceEventId?: string | undefined;
+    nativeProactive?: {
+        agent: string;
+        model: string;
+        project: string;
+        employeeId: string;
+        employeeRevision: number;
+        anchorRunId: string;
+        upstreamId: string;
+    } | undefined;
     workflowId?: string | undefined;
-    nodeId?: string | undefined;
+    nativeRunId?: string | undefined;
 }, {
     at: string;
     type: "thinking";
@@ -112,11 +201,22 @@ export declare const StreamThinkingEvent: z.ZodObject<{
     turnId: string;
     seq: number;
     text: string;
+    nodeId?: string | undefined;
+    source?: string | undefined;
     role?: string | undefined;
     origin?: "solicited" | "unsolicited" | undefined;
-    source?: string | undefined;
+    sourceEventId?: string | undefined;
+    nativeProactive?: {
+        agent: string;
+        model: string;
+        project: string;
+        employeeId: string;
+        employeeRevision: number;
+        anchorRunId: string;
+        upstreamId: string;
+    } | undefined;
     workflowId?: string | undefined;
-    nodeId?: string | undefined;
+    nativeRunId?: string | undefined;
     delta?: boolean | undefined;
 }>;
 export declare const StreamToolCallEvent: z.ZodObject<{
@@ -130,6 +230,33 @@ export declare const StreamToolCallEvent: z.ZodObject<{
     origin: z.ZodDefault<z.ZodEnum<["solicited", "unsolicited"]>>;
     /** unsolicited 时的冲泡来源标签，如 "cron" / "scheduled" / "heartbeat"。 */
     source: z.ZodOptional<z.ZodString>;
+    /** Native harness output identity; not a caller-selected conversation or sender. */
+    sourceEventId: z.ZodOptional<z.ZodString>;
+    nativeProactive: z.ZodOptional<z.ZodObject<{
+        anchorRunId: z.ZodString;
+        employeeId: z.ZodString;
+        employeeRevision: z.ZodNumber;
+        upstreamId: z.ZodString;
+        project: z.ZodString;
+        agent: z.ZodString;
+        model: z.ZodString;
+    }, "strict", z.ZodTypeAny, {
+        agent: string;
+        model: string;
+        project: string;
+        employeeId: string;
+        employeeRevision: number;
+        anchorRunId: string;
+        upstreamId: string;
+    }, {
+        agent: string;
+        model: string;
+        project: string;
+        employeeId: string;
+        employeeRevision: number;
+        anchorRunId: string;
+        upstreamId: string;
+    }>>;
     /** 单调递增序号（按 session），保证调用方可排序/去重。 */
     seq: z.ZodNumber;
     at: z.ZodString;
@@ -142,6 +269,8 @@ export declare const StreamToolCallEvent: z.ZodObject<{
     workflowId: z.ZodOptional<z.ZodString>;
     nodeId: z.ZodOptional<z.ZodString>;
     role: z.ZodOptional<z.ZodString>;
+    /** Server-generated native conversation run correlation, stamped by core. */
+    nativeRunId: z.ZodOptional<z.ZodString>;
 } & {
     type: z.ZodLiteral<"tool_call">;
     toolName: z.ZodString;
@@ -157,10 +286,21 @@ export declare const StreamToolCallEvent: z.ZodObject<{
     origin: "solicited" | "unsolicited";
     seq: number;
     toolName: string;
-    role?: string | undefined;
+    nodeId?: string | undefined;
     source?: string | undefined;
+    role?: string | undefined;
+    sourceEventId?: string | undefined;
+    nativeProactive?: {
+        agent: string;
+        model: string;
+        project: string;
+        employeeId: string;
+        employeeRevision: number;
+        anchorRunId: string;
+        upstreamId: string;
+    } | undefined;
     workflowId?: string | undefined;
-    nodeId?: string | undefined;
+    nativeRunId?: string | undefined;
     args?: unknown;
     toolCallId?: string | undefined;
 }, {
@@ -170,11 +310,22 @@ export declare const StreamToolCallEvent: z.ZodObject<{
     turnId: string;
     seq: number;
     toolName: string;
+    nodeId?: string | undefined;
+    source?: string | undefined;
     role?: string | undefined;
     origin?: "solicited" | "unsolicited" | undefined;
-    source?: string | undefined;
+    sourceEventId?: string | undefined;
+    nativeProactive?: {
+        agent: string;
+        model: string;
+        project: string;
+        employeeId: string;
+        employeeRevision: number;
+        anchorRunId: string;
+        upstreamId: string;
+    } | undefined;
     workflowId?: string | undefined;
-    nodeId?: string | undefined;
+    nativeRunId?: string | undefined;
     args?: unknown;
     toolCallId?: string | undefined;
 }>;
@@ -189,6 +340,33 @@ export declare const StreamToolResultEvent: z.ZodObject<{
     origin: z.ZodDefault<z.ZodEnum<["solicited", "unsolicited"]>>;
     /** unsolicited 时的冲泡来源标签，如 "cron" / "scheduled" / "heartbeat"。 */
     source: z.ZodOptional<z.ZodString>;
+    /** Native harness output identity; not a caller-selected conversation or sender. */
+    sourceEventId: z.ZodOptional<z.ZodString>;
+    nativeProactive: z.ZodOptional<z.ZodObject<{
+        anchorRunId: z.ZodString;
+        employeeId: z.ZodString;
+        employeeRevision: z.ZodNumber;
+        upstreamId: z.ZodString;
+        project: z.ZodString;
+        agent: z.ZodString;
+        model: z.ZodString;
+    }, "strict", z.ZodTypeAny, {
+        agent: string;
+        model: string;
+        project: string;
+        employeeId: string;
+        employeeRevision: number;
+        anchorRunId: string;
+        upstreamId: string;
+    }, {
+        agent: string;
+        model: string;
+        project: string;
+        employeeId: string;
+        employeeRevision: number;
+        anchorRunId: string;
+        upstreamId: string;
+    }>>;
     /** 单调递增序号（按 session），保证调用方可排序/去重。 */
     seq: z.ZodNumber;
     at: z.ZodString;
@@ -201,6 +379,8 @@ export declare const StreamToolResultEvent: z.ZodObject<{
     workflowId: z.ZodOptional<z.ZodString>;
     nodeId: z.ZodOptional<z.ZodString>;
     role: z.ZodOptional<z.ZodString>;
+    /** Server-generated native conversation run correlation, stamped by core. */
+    nativeRunId: z.ZodOptional<z.ZodString>;
 } & {
     type: z.ZodLiteral<"tool_result">;
     toolName: z.ZodString;
@@ -217,10 +397,21 @@ export declare const StreamToolResultEvent: z.ZodObject<{
     seq: number;
     toolName: string;
     ok: boolean;
-    role?: string | undefined;
+    nodeId?: string | undefined;
     source?: string | undefined;
+    role?: string | undefined;
+    sourceEventId?: string | undefined;
+    nativeProactive?: {
+        agent: string;
+        model: string;
+        project: string;
+        employeeId: string;
+        employeeRevision: number;
+        anchorRunId: string;
+        upstreamId: string;
+    } | undefined;
     workflowId?: string | undefined;
-    nodeId?: string | undefined;
+    nativeRunId?: string | undefined;
     toolCallId?: string | undefined;
     output?: unknown;
 }, {
@@ -231,11 +422,22 @@ export declare const StreamToolResultEvent: z.ZodObject<{
     seq: number;
     toolName: string;
     ok: boolean;
+    nodeId?: string | undefined;
+    source?: string | undefined;
     role?: string | undefined;
     origin?: "solicited" | "unsolicited" | undefined;
-    source?: string | undefined;
+    sourceEventId?: string | undefined;
+    nativeProactive?: {
+        agent: string;
+        model: string;
+        project: string;
+        employeeId: string;
+        employeeRevision: number;
+        anchorRunId: string;
+        upstreamId: string;
+    } | undefined;
     workflowId?: string | undefined;
-    nodeId?: string | undefined;
+    nativeRunId?: string | undefined;
     toolCallId?: string | undefined;
     output?: unknown;
 }>;
@@ -250,6 +452,33 @@ export declare const StreamTokenEvent: z.ZodObject<{
     origin: z.ZodDefault<z.ZodEnum<["solicited", "unsolicited"]>>;
     /** unsolicited 时的冲泡来源标签，如 "cron" / "scheduled" / "heartbeat"。 */
     source: z.ZodOptional<z.ZodString>;
+    /** Native harness output identity; not a caller-selected conversation or sender. */
+    sourceEventId: z.ZodOptional<z.ZodString>;
+    nativeProactive: z.ZodOptional<z.ZodObject<{
+        anchorRunId: z.ZodString;
+        employeeId: z.ZodString;
+        employeeRevision: z.ZodNumber;
+        upstreamId: z.ZodString;
+        project: z.ZodString;
+        agent: z.ZodString;
+        model: z.ZodString;
+    }, "strict", z.ZodTypeAny, {
+        agent: string;
+        model: string;
+        project: string;
+        employeeId: string;
+        employeeRevision: number;
+        anchorRunId: string;
+        upstreamId: string;
+    }, {
+        agent: string;
+        model: string;
+        project: string;
+        employeeId: string;
+        employeeRevision: number;
+        anchorRunId: string;
+        upstreamId: string;
+    }>>;
     /** 单调递增序号（按 session），保证调用方可排序/去重。 */
     seq: z.ZodNumber;
     at: z.ZodString;
@@ -262,6 +491,8 @@ export declare const StreamTokenEvent: z.ZodObject<{
     workflowId: z.ZodOptional<z.ZodString>;
     nodeId: z.ZodOptional<z.ZodString>;
     role: z.ZodOptional<z.ZodString>;
+    /** Server-generated native conversation run correlation, stamped by core. */
+    nativeRunId: z.ZodOptional<z.ZodString>;
 } & {
     type: z.ZodLiteral<"token">;
     text: z.ZodString;
@@ -273,10 +504,21 @@ export declare const StreamTokenEvent: z.ZodObject<{
     origin: "solicited" | "unsolicited";
     seq: number;
     text: string;
-    role?: string | undefined;
+    nodeId?: string | undefined;
     source?: string | undefined;
+    role?: string | undefined;
+    sourceEventId?: string | undefined;
+    nativeProactive?: {
+        agent: string;
+        model: string;
+        project: string;
+        employeeId: string;
+        employeeRevision: number;
+        anchorRunId: string;
+        upstreamId: string;
+    } | undefined;
     workflowId?: string | undefined;
-    nodeId?: string | undefined;
+    nativeRunId?: string | undefined;
 }, {
     at: string;
     type: "token";
@@ -284,11 +526,150 @@ export declare const StreamTokenEvent: z.ZodObject<{
     turnId: string;
     seq: number;
     text: string;
+    nodeId?: string | undefined;
+    source?: string | undefined;
     role?: string | undefined;
     origin?: "solicited" | "unsolicited" | undefined;
+    sourceEventId?: string | undefined;
+    nativeProactive?: {
+        agent: string;
+        model: string;
+        project: string;
+        employeeId: string;
+        employeeRevision: number;
+        anchorRunId: string;
+        upstreamId: string;
+    } | undefined;
+    workflowId?: string | undefined;
+    nativeRunId?: string | undefined;
+}>;
+export declare const StreamRuntimeSettingsEvent: 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>;
+    /** Native harness output identity; not a caller-selected conversation or sender. */
+    sourceEventId: z.ZodOptional<z.ZodString>;
+    nativeProactive: z.ZodOptional<z.ZodObject<{
+        anchorRunId: z.ZodString;
+        employeeId: z.ZodString;
+        employeeRevision: z.ZodNumber;
+        upstreamId: z.ZodString;
+        project: z.ZodString;
+        agent: z.ZodString;
+        model: z.ZodString;
+    }, "strict", z.ZodTypeAny, {
+        agent: string;
+        model: string;
+        project: string;
+        employeeId: string;
+        employeeRevision: number;
+        anchorRunId: string;
+        upstreamId: string;
+    }, {
+        agent: string;
+        model: string;
+        project: string;
+        employeeId: string;
+        employeeRevision: number;
+        anchorRunId: string;
+        upstreamId: string;
+    }>>;
+    /** 单调递增序号（按 session），保证调用方可排序/去重。 */
+    seq: z.ZodNumber;
+    at: z.ZodString;
+    /**
+     * L3 编排归属（review P0-1，2026-06-23）。
+     * session 由 workflow node 创建时，phonon 自动给该 session 所有事件打上这些字段，
+     * 服务端按 workflowId 筛流、按 nodeId/role 区分来源。
+     * 没有归属的普通 session 留空，向后兼容。
+     */
+    workflowId: z.ZodOptional<z.ZodString>;
+    nodeId: z.ZodOptional<z.ZodString>;
+    role: z.ZodOptional<z.ZodString>;
+    /** Server-generated native conversation run correlation, stamped by core. */
+    nativeRunId: z.ZodOptional<z.ZodString>;
+} & {
+    type: z.ZodLiteral<"runtime_settings">;
+    agent: z.ZodString;
+    model: z.ZodString;
+    reasoning: z.ZodObject<{
+        requestedLevel: z.ZodNullable<z.ZodEnum<["low", "standard", "high", "xhigh", "max"]>>;
+        nativeValue: z.ZodNullable<z.ZodEnum<["off", "none", "minimal", "low", "medium", "high", "xhigh", "max", "ultra", "auto", "adaptive"]>>;
+        effectiveLevel: z.ZodOptional<z.ZodEnum<["low", "standard", "high", "xhigh", "max"]>>;
+    }, "strict", z.ZodTypeAny, {
+        requestedLevel: "low" | "standard" | "high" | "xhigh" | "max" | null;
+        nativeValue: "low" | "high" | "xhigh" | "max" | "off" | "none" | "minimal" | "medium" | "ultra" | "auto" | "adaptive" | null;
+        effectiveLevel?: "low" | "standard" | "high" | "xhigh" | "max" | undefined;
+    }, {
+        requestedLevel: "low" | "standard" | "high" | "xhigh" | "max" | null;
+        nativeValue: "low" | "high" | "xhigh" | "max" | "off" | "none" | "minimal" | "medium" | "ultra" | "auto" | "adaptive" | null;
+        effectiveLevel?: "low" | "standard" | "high" | "xhigh" | "max" | undefined;
+    }>;
+}, "strip", z.ZodTypeAny, {
+    at: string;
+    type: "runtime_settings";
+    sessionId: string & z.BRAND<"SessionId">;
+    agent: string;
+    model: string;
+    turnId: string;
+    reasoning: {
+        requestedLevel: "low" | "standard" | "high" | "xhigh" | "max" | null;
+        nativeValue: "low" | "high" | "xhigh" | "max" | "off" | "none" | "minimal" | "medium" | "ultra" | "auto" | "adaptive" | null;
+        effectiveLevel?: "low" | "standard" | "high" | "xhigh" | "max" | undefined;
+    };
+    origin: "solicited" | "unsolicited";
+    seq: number;
+    nodeId?: string | undefined;
     source?: string | undefined;
+    role?: string | undefined;
+    sourceEventId?: string | undefined;
+    nativeProactive?: {
+        agent: string;
+        model: string;
+        project: string;
+        employeeId: string;
+        employeeRevision: number;
+        anchorRunId: string;
+        upstreamId: string;
+    } | undefined;
     workflowId?: string | undefined;
+    nativeRunId?: string | undefined;
+}, {
+    at: string;
+    type: "runtime_settings";
+    sessionId: string;
+    agent: string;
+    model: string;
+    turnId: string;
+    reasoning: {
+        requestedLevel: "low" | "standard" | "high" | "xhigh" | "max" | null;
+        nativeValue: "low" | "high" | "xhigh" | "max" | "off" | "none" | "minimal" | "medium" | "ultra" | "auto" | "adaptive" | null;
+        effectiveLevel?: "low" | "standard" | "high" | "xhigh" | "max" | undefined;
+    };
+    seq: number;
     nodeId?: string | undefined;
+    source?: string | undefined;
+    role?: string | undefined;
+    origin?: "solicited" | "unsolicited" | undefined;
+    sourceEventId?: string | undefined;
+    nativeProactive?: {
+        agent: string;
+        model: string;
+        project: string;
+        employeeId: string;
+        employeeRevision: number;
+        anchorRunId: string;
+        upstreamId: string;
+    } | undefined;
+    workflowId?: string | undefined;
+    nativeRunId?: string | undefined;
 }>;
 export declare const StreamResultEvent: z.ZodObject<{
     sessionId: z.ZodBranded<z.ZodString, "SessionId">;
@@ -301,6 +682,33 @@ export declare const StreamResultEvent: z.ZodObject<{
     origin: z.ZodDefault<z.ZodEnum<["solicited", "unsolicited"]>>;
     /** unsolicited 时的冲泡来源标签，如 "cron" / "scheduled" / "heartbeat"。 */
     source: z.ZodOptional<z.ZodString>;
+    /** Native harness output identity; not a caller-selected conversation or sender. */
+    sourceEventId: z.ZodOptional<z.ZodString>;
+    nativeProactive: z.ZodOptional<z.ZodObject<{
+        anchorRunId: z.ZodString;
+        employeeId: z.ZodString;
+        employeeRevision: z.ZodNumber;
+        upstreamId: z.ZodString;
+        project: z.ZodString;
+        agent: z.ZodString;
+        model: z.ZodString;
+    }, "strict", z.ZodTypeAny, {
+        agent: string;
+        model: string;
+        project: string;
+        employeeId: string;
+        employeeRevision: number;
+        anchorRunId: string;
+        upstreamId: string;
+    }, {
+        agent: string;
+        model: string;
+        project: string;
+        employeeId: string;
+        employeeRevision: number;
+        anchorRunId: string;
+        upstreamId: string;
+    }>>;
     /** 单调递增序号（按 session），保证调用方可排序/去重。 */
     seq: z.ZodNumber;
     at: z.ZodString;
@@ -313,6 +721,8 @@ export declare const StreamResultEvent: z.ZodObject<{
     workflowId: z.ZodOptional<z.ZodString>;
     nodeId: z.ZodOptional<z.ZodString>;
     role: z.ZodOptional<z.ZodString>;
+    /** Server-generated native conversation run correlation, stamped by core. */
+    nativeRunId: z.ZodOptional<z.ZodString>;
 } & {
     type: z.ZodLiteral<"result">;
     /** 本轮最终文本结果。 */
@@ -342,17 +752,28 @@ export declare const StreamResultEvent: z.ZodObject<{
 }, "strip", z.ZodTypeAny, {
     at: string;
     type: "result";
-    status: "aborted" | "interrupted" | "completed" | "failed" | "timeout";
+    status: "aborted" | "failed" | "interrupted" | "completed" | "timeout";
     final: true;
     sessionId: string & z.BRAND<"SessionId">;
     turnId: string;
     origin: "solicited" | "unsolicited";
     seq: number;
     text: string;
-    role?: string | undefined;
+    nodeId?: string | undefined;
     source?: string | undefined;
+    role?: string | undefined;
+    sourceEventId?: string | undefined;
+    nativeProactive?: {
+        agent: string;
+        model: string;
+        project: string;
+        employeeId: string;
+        employeeRevision: number;
+        anchorRunId: string;
+        upstreamId: string;
+    } | undefined;
     workflowId?: string | undefined;
-    nodeId?: string | undefined;
+    nativeRunId?: string | undefined;
     usage?: {
         inputTokens?: number | undefined;
         outputTokens?: number | undefined;
@@ -365,12 +786,23 @@ export declare const StreamResultEvent: z.ZodObject<{
     turnId: string;
     seq: number;
     text: string;
-    status?: "aborted" | "interrupted" | "completed" | "failed" | "timeout" | undefined;
+    status?: "aborted" | "failed" | "interrupted" | "completed" | "timeout" | undefined;
+    nodeId?: string | undefined;
+    source?: string | undefined;
     role?: string | undefined;
     origin?: "solicited" | "unsolicited" | undefined;
-    source?: string | undefined;
+    sourceEventId?: string | undefined;
+    nativeProactive?: {
+        agent: string;
+        model: string;
+        project: string;
+        employeeId: string;
+        employeeRevision: number;
+        anchorRunId: string;
+        upstreamId: string;
+    } | undefined;
     workflowId?: string | undefined;
-    nodeId?: string | undefined;
+    nativeRunId?: string | undefined;
     usage?: {
         inputTokens?: number | undefined;
         outputTokens?: number | undefined;
@@ -387,6 +819,33 @@ export declare const StreamErrorEvent: z.ZodObject<{
     origin: z.ZodDefault<z.ZodEnum<["solicited", "unsolicited"]>>;
     /** unsolicited 时的冲泡来源标签，如 "cron" / "scheduled" / "heartbeat"。 */
     source: z.ZodOptional<z.ZodString>;
+    /** Native harness output identity; not a caller-selected conversation or sender. */
+    sourceEventId: z.ZodOptional<z.ZodString>;
+    nativeProactive: z.ZodOptional<z.ZodObject<{
+        anchorRunId: z.ZodString;
+        employeeId: z.ZodString;
+        employeeRevision: z.ZodNumber;
+        upstreamId: z.ZodString;
+        project: z.ZodString;
+        agent: z.ZodString;
+        model: z.ZodString;
+    }, "strict", z.ZodTypeAny, {
+        agent: string;
+        model: string;
+        project: string;
+        employeeId: string;
+        employeeRevision: number;
+        anchorRunId: string;
+        upstreamId: string;
+    }, {
+        agent: string;
+        model: string;
+        project: string;
+        employeeId: string;
+        employeeRevision: number;
+        anchorRunId: string;
+        upstreamId: string;
+    }>>;
     /** 单调递增序号（按 session），保证调用方可排序/去重。 */
     seq: z.ZodNumber;
     at: z.ZodString;
@@ -399,6 +858,8 @@ export declare const StreamErrorEvent: z.ZodObject<{
     workflowId: z.ZodOptional<z.ZodString>;
     nodeId: z.ZodOptional<z.ZodString>;
     role: z.ZodOptional<z.ZodString>;
+    /** Server-generated native conversation run correlation, stamped by core. */
+    nativeRunId: z.ZodOptional<z.ZodString>;
 } & {
     type: z.ZodLiteral<"error">;
     message: z.ZodString;
@@ -411,17 +872,28 @@ export declare const StreamErrorEvent: z.ZodObject<{
     at: string;
     message: string;
     type: "error";
-    status: "aborted" | "interrupted" | "failed" | "timeout";
+    status: "aborted" | "failed" | "interrupted" | "timeout";
     final: true;
     sessionId: string & z.BRAND<"SessionId">;
     turnId: string;
     origin: "solicited" | "unsolicited";
     seq: number;
     appCode?: string | undefined;
-    role?: string | undefined;
+    nodeId?: string | undefined;
     source?: string | undefined;
+    role?: string | undefined;
+    sourceEventId?: string | undefined;
+    nativeProactive?: {
+        agent: string;
+        model: string;
+        project: string;
+        employeeId: string;
+        employeeRevision: number;
+        anchorRunId: string;
+        upstreamId: string;
+    } | undefined;
     workflowId?: string | undefined;
-    nodeId?: string | undefined;
+    nativeRunId?: string | undefined;
 }, {
     at: string;
     message: string;
@@ -430,37 +902,230 @@ export declare const StreamErrorEvent: z.ZodObject<{
     sessionId: string;
     turnId: string;
     seq: number;
-    status?: "aborted" | "interrupted" | "failed" | "timeout" | undefined;
+    status?: "aborted" | "failed" | "interrupted" | "timeout" | undefined;
     appCode?: string | undefined;
+    nodeId?: string | undefined;
+    source?: string | undefined;
     role?: string | undefined;
     origin?: "solicited" | "unsolicited" | undefined;
-    source?: string | undefined;
+    sourceEventId?: string | undefined;
+    nativeProactive?: {
+        agent: string;
+        model: string;
+        project: string;
+        employeeId: string;
+        employeeRevision: number;
+        anchorRunId: string;
+        upstreamId: string;
+    } | undefined;
     workflowId?: string | undefined;
-    nodeId?: string | undefined;
+    nativeRunId?: string | undefined;
 }>;
 export declare const StreamAckParams: z.ZodObject<{
-    /** 按 session 确认；缺省表示该连接全局。 */
-    sessionId: z.ZodOptional<z.ZodBranded<z.ZodString, "SessionId">>;
+    /** 必须按 session 确认；单一标量无法安全表达连接全局水位。 */
+    sessionId: z.ZodBranded<z.ZodString, "SessionId">;
     /** 已收到的最大连续 seq（含）；phonon 可清理 <= 此值的 outbox。 */
     lastSeq: z.ZodNumber;
 }, "strip", z.ZodTypeAny, {
+    sessionId: string & z.BRAND<"SessionId">;
     lastSeq: number;
-    sessionId?: (string & z.BRAND<"SessionId">) | undefined;
 }, {
+    sessionId: string;
     lastSeq: number;
-    sessionId?: string | undefined;
 }>;
 export type StreamAckParams = z.infer<typeof StreamAckParams>;
+export declare const StreamReplayParams: z.ZodObject<{
+    sessionId: z.ZodBranded<z.ZodString, "SessionId">;
+    fromSeq: z.ZodDefault<z.ZodNumber>;
+    limit: z.ZodDefault<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    sessionId: string & z.BRAND<"SessionId">;
+    limit: number;
+    fromSeq: number;
+}, {
+    sessionId: string;
+    limit?: number | undefined;
+    fromSeq?: number | undefined;
+}>;
+export type StreamReplayParams = z.infer<typeof StreamReplayParams>;
+export declare const StreamReplayResult: z.ZodObject<{
+    sessionId: z.ZodBranded<z.ZodString, "SessionId">;
+    replayed: z.ZodNumber;
+    nextSeq: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    sessionId: string & z.BRAND<"SessionId">;
+    replayed: number;
+    nextSeq?: number | undefined;
+}, {
+    sessionId: string;
+    replayed: number;
+    nextSeq?: number | undefined;
+}>;
+export type StreamReplayResult = z.infer<typeof StreamReplayResult>;
 /** 流式事件联合体（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>;
+    /** Native harness output identity; not a caller-selected conversation or sender. */
+    sourceEventId: z.ZodOptional<z.ZodString>;
+    nativeProactive: z.ZodOptional<z.ZodObject<{
+        anchorRunId: z.ZodString;
+        employeeId: z.ZodString;
+        employeeRevision: z.ZodNumber;
+        upstreamId: z.ZodString;
+        project: z.ZodString;
+        agent: z.ZodString;
+        model: z.ZodString;
+    }, "strict", z.ZodTypeAny, {
+        agent: string;
+        model: string;
+        project: string;
+        employeeId: string;
+        employeeRevision: number;
+        anchorRunId: string;
+        upstreamId: string;
+    }, {
+        agent: string;
+        model: string;
+        project: string;
+        employeeId: string;
+        employeeRevision: number;
+        anchorRunId: string;
+        upstreamId: string;
+    }>>;
+    /** 单调递增序号（按 session），保证调用方可排序/去重。 */
     seq: z.ZodNumber;
     at: z.ZodString;
+    /**
+     * L3 编排归属（review P0-1，2026-06-23）。
+     * session 由 workflow node 创建时，phonon 自动给该 session 所有事件打上这些字段，
+     * 服务端按 workflowId 筛流、按 nodeId/role 区分来源。
+     * 没有归属的普通 session 留空，向后兼容。
+     */
     workflowId: z.ZodOptional<z.ZodString>;
     nodeId: z.ZodOptional<z.ZodString>;
+    role: z.ZodOptional<z.ZodString>;
+    /** Server-generated native conversation run correlation, stamped by core. */
+    nativeRunId: z.ZodOptional<z.ZodString>;
+} & {
+    type: z.ZodLiteral<"runtime_settings">;
+    agent: z.ZodString;
+    model: z.ZodString;
+    reasoning: z.ZodObject<{
+        requestedLevel: z.ZodNullable<z.ZodEnum<["low", "standard", "high", "xhigh", "max"]>>;
+        nativeValue: z.ZodNullable<z.ZodEnum<["off", "none", "minimal", "low", "medium", "high", "xhigh", "max", "ultra", "auto", "adaptive"]>>;
+        effectiveLevel: z.ZodOptional<z.ZodEnum<["low", "standard", "high", "xhigh", "max"]>>;
+    }, "strict", z.ZodTypeAny, {
+        requestedLevel: "low" | "standard" | "high" | "xhigh" | "max" | null;
+        nativeValue: "low" | "high" | "xhigh" | "max" | "off" | "none" | "minimal" | "medium" | "ultra" | "auto" | "adaptive" | null;
+        effectiveLevel?: "low" | "standard" | "high" | "xhigh" | "max" | undefined;
+    }, {
+        requestedLevel: "low" | "standard" | "high" | "xhigh" | "max" | null;
+        nativeValue: "low" | "high" | "xhigh" | "max" | "off" | "none" | "minimal" | "medium" | "ultra" | "auto" | "adaptive" | null;
+        effectiveLevel?: "low" | "standard" | "high" | "xhigh" | "max" | undefined;
+    }>;
+}, "strip", z.ZodTypeAny, {
+    at: string;
+    type: "runtime_settings";
+    sessionId: string & z.BRAND<"SessionId">;
+    agent: string;
+    model: string;
+    turnId: string;
+    reasoning: {
+        requestedLevel: "low" | "standard" | "high" | "xhigh" | "max" | null;
+        nativeValue: "low" | "high" | "xhigh" | "max" | "off" | "none" | "minimal" | "medium" | "ultra" | "auto" | "adaptive" | null;
+        effectiveLevel?: "low" | "standard" | "high" | "xhigh" | "max" | undefined;
+    };
+    origin: "solicited" | "unsolicited";
+    seq: number;
+    nodeId?: string | undefined;
+    source?: string | undefined;
+    role?: string | undefined;
+    sourceEventId?: string | undefined;
+    nativeProactive?: {
+        agent: string;
+        model: string;
+        project: string;
+        employeeId: string;
+        employeeRevision: number;
+        anchorRunId: string;
+        upstreamId: string;
+    } | undefined;
+    workflowId?: string | undefined;
+    nativeRunId?: string | undefined;
+}, {
+    at: string;
+    type: "runtime_settings";
+    sessionId: string;
+    agent: string;
+    model: string;
+    turnId: string;
+    reasoning: {
+        requestedLevel: "low" | "standard" | "high" | "xhigh" | "max" | null;
+        nativeValue: "low" | "high" | "xhigh" | "max" | "off" | "none" | "minimal" | "medium" | "ultra" | "auto" | "adaptive" | null;
+        effectiveLevel?: "low" | "standard" | "high" | "xhigh" | "max" | undefined;
+    };
+    seq: number;
+    nodeId?: string | undefined;
+    source?: string | undefined;
+    role?: string | undefined;
+    origin?: "solicited" | "unsolicited" | undefined;
+    sourceEventId?: string | undefined;
+    nativeProactive?: {
+        agent: string;
+        model: string;
+        project: string;
+        employeeId: string;
+        employeeRevision: number;
+        anchorRunId: string;
+        upstreamId: string;
+    } | undefined;
+    workflowId?: string | undefined;
+    nativeRunId?: string | undefined;
+}>, z.ZodObject<{
+    sessionId: z.ZodBranded<z.ZodString, "SessionId">;
+    turnId: z.ZodString;
+    origin: z.ZodDefault<z.ZodEnum<["solicited", "unsolicited"]>>;
+    source: z.ZodOptional<z.ZodString>;
+    sourceEventId: z.ZodOptional<z.ZodString>;
+    nativeProactive: z.ZodOptional<z.ZodObject<{
+        anchorRunId: z.ZodString;
+        employeeId: z.ZodString;
+        employeeRevision: z.ZodNumber;
+        upstreamId: z.ZodString;
+        project: z.ZodString;
+        agent: z.ZodString;
+        model: z.ZodString;
+    }, "strict", z.ZodTypeAny, {
+        agent: string;
+        model: string;
+        project: string;
+        employeeId: string;
+        employeeRevision: number;
+        anchorRunId: string;
+        upstreamId: string;
+    }, {
+        agent: string;
+        model: string;
+        project: string;
+        employeeId: string;
+        employeeRevision: number;
+        anchorRunId: string;
+        upstreamId: string;
+    }>>;
+    seq: z.ZodNumber;
+    at: z.ZodString;
+    workflowId: z.ZodOptional<z.ZodString>;
+    nodeId: z.ZodOptional<z.ZodString>;
+    nativeRunId: z.ZodOptional<z.ZodString>;
 } & {
     type: z.ZodLiteral<"message">;
     role: z.ZodDefault<z.ZodEnum<["assistant", "user", "system"]>>;
@@ -470,15 +1135,26 @@ export declare const StreamEvent: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
     at: string;
     type: "message";
     sessionId: string & z.BRAND<"SessionId">;
-    role: "system" | "user" | "assistant";
     turnId: string;
+    role: "system" | "user" | "assistant";
     origin: "solicited" | "unsolicited";
     seq: number;
     text: string;
     delta: boolean;
+    nodeId?: string | undefined;
     source?: string | undefined;
+    sourceEventId?: string | undefined;
+    nativeProactive?: {
+        agent: string;
+        model: string;
+        project: string;
+        employeeId: string;
+        employeeRevision: number;
+        anchorRunId: string;
+        upstreamId: string;
+    } | undefined;
     workflowId?: string | undefined;
-    nodeId?: string | undefined;
+    nativeRunId?: string | undefined;
 }, {
     at: string;
     type: "message";
@@ -486,11 +1162,22 @@ export declare const StreamEvent: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
     turnId: string;
     seq: number;
     text: string;
+    nodeId?: string | undefined;
+    source?: string | undefined;
     role?: "system" | "user" | "assistant" | undefined;
     origin?: "solicited" | "unsolicited" | undefined;
-    source?: string | undefined;
+    sourceEventId?: string | undefined;
+    nativeProactive?: {
+        agent: string;
+        model: string;
+        project: string;
+        employeeId: string;
+        employeeRevision: number;
+        anchorRunId: string;
+        upstreamId: string;
+    } | undefined;
     workflowId?: string | undefined;
-    nodeId?: string | undefined;
+    nativeRunId?: string | undefined;
     delta?: boolean | undefined;
 }>, z.ZodObject<{
     sessionId: z.ZodBranded<z.ZodString, "SessionId">;
@@ -503,6 +1190,33 @@ export declare const StreamEvent: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
     origin: z.ZodDefault<z.ZodEnum<["solicited", "unsolicited"]>>;
     /** unsolicited 时的冲泡来源标签，如 "cron" / "scheduled" / "heartbeat"。 */
     source: z.ZodOptional<z.ZodString>;
+    /** Native harness output identity; not a caller-selected conversation or sender. */
+    sourceEventId: z.ZodOptional<z.ZodString>;
+    nativeProactive: z.ZodOptional<z.ZodObject<{
+        anchorRunId: z.ZodString;
+        employeeId: z.ZodString;
+        employeeRevision: z.ZodNumber;
+        upstreamId: z.ZodString;
+        project: z.ZodString;
+        agent: z.ZodString;
+        model: z.ZodString;
+    }, "strict", z.ZodTypeAny, {
+        agent: string;
+        model: string;
+        project: string;
+        employeeId: string;
+        employeeRevision: number;
+        anchorRunId: string;
+        upstreamId: string;
+    }, {
+        agent: string;
+        model: string;
+        project: string;
+        employeeId: string;
+        employeeRevision: number;
+        anchorRunId: string;
+        upstreamId: string;
+    }>>;
     /** 单调递增序号（按 session），保证调用方可排序/去重。 */
     seq: z.ZodNumber;
     at: z.ZodString;
@@ -515,6 +1229,8 @@ export declare const StreamEvent: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
     workflowId: z.ZodOptional<z.ZodString>;
     nodeId: z.ZodOptional<z.ZodString>;
     role: z.ZodOptional<z.ZodString>;
+    /** Server-generated native conversation run correlation, stamped by core. */
+    nativeRunId: z.ZodOptional<z.ZodString>;
 } & {
     type: z.ZodLiteral<"thinking">;
     text: z.ZodString;
@@ -528,10 +1244,21 @@ export declare const StreamEvent: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
     seq: number;
     text: string;
     delta: boolean;
-    role?: string | undefined;
+    nodeId?: string | undefined;
     source?: string | undefined;
+    role?: string | undefined;
+    sourceEventId?: string | undefined;
+    nativeProactive?: {
+        agent: string;
+        model: string;
+        project: string;
+        employeeId: string;
+        employeeRevision: number;
+        anchorRunId: string;
+        upstreamId: string;
+    } | undefined;
     workflowId?: string | undefined;
-    nodeId?: string | undefined;
+    nativeRunId?: string | undefined;
 }, {
     at: string;
     type: "thinking";
@@ -539,11 +1266,22 @@ export declare const StreamEvent: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
     turnId: string;
     seq: number;
     text: string;
+    nodeId?: string | undefined;
+    source?: string | undefined;
     role?: string | undefined;
     origin?: "solicited" | "unsolicited" | undefined;
-    source?: string | undefined;
+    sourceEventId?: string | undefined;
+    nativeProactive?: {
+        agent: string;
+        model: string;
+        project: string;
+        employeeId: string;
+        employeeRevision: number;
+        anchorRunId: string;
+        upstreamId: string;
+    } | undefined;
     workflowId?: string | undefined;
-    nodeId?: string | undefined;
+    nativeRunId?: string | undefined;
     delta?: boolean | undefined;
 }>, z.ZodObject<{
     sessionId: z.ZodBranded<z.ZodString, "SessionId">;
@@ -556,6 +1294,33 @@ export declare const StreamEvent: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
     origin: z.ZodDefault<z.ZodEnum<["solicited", "unsolicited"]>>;
     /** unsolicited 时的冲泡来源标签，如 "cron" / "scheduled" / "heartbeat"。 */
     source: z.ZodOptional<z.ZodString>;
+    /** Native harness output identity; not a caller-selected conversation or sender. */
+    sourceEventId: z.ZodOptional<z.ZodString>;
+    nativeProactive: z.ZodOptional<z.ZodObject<{
+        anchorRunId: z.ZodString;
+        employeeId: z.ZodString;
+        employeeRevision: z.ZodNumber;
+        upstreamId: z.ZodString;
+        project: z.ZodString;
+        agent: z.ZodString;
+        model: z.ZodString;
+    }, "strict", z.ZodTypeAny, {
+        agent: string;
+        model: string;
+        project: string;
+        employeeId: string;
+        employeeRevision: number;
+        anchorRunId: string;
+        upstreamId: string;
+    }, {
+        agent: string;
+        model: string;
+        project: string;
+        employeeId: string;
+        employeeRevision: number;
+        anchorRunId: string;
+        upstreamId: string;
+    }>>;
     /** 单调递增序号（按 session），保证调用方可排序/去重。 */
     seq: z.ZodNumber;
     at: z.ZodString;
@@ -568,6 +1333,8 @@ export declare const StreamEvent: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
     workflowId: z.ZodOptional<z.ZodString>;
     nodeId: z.ZodOptional<z.ZodString>;
     role: z.ZodOptional<z.ZodString>;
+    /** Server-generated native conversation run correlation, stamped by core. */
+    nativeRunId: z.ZodOptional<z.ZodString>;
 } & {
     type: z.ZodLiteral<"tool_call">;
     toolName: z.ZodString;
@@ -583,10 +1350,21 @@ export declare const StreamEvent: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
     origin: "solicited" | "unsolicited";
     seq: number;
     toolName: string;
-    role?: string | undefined;
+    nodeId?: string | undefined;
     source?: string | undefined;
+    role?: string | undefined;
+    sourceEventId?: string | undefined;
+    nativeProactive?: {
+        agent: string;
+        model: string;
+        project: string;
+        employeeId: string;
+        employeeRevision: number;
+        anchorRunId: string;
+        upstreamId: string;
+    } | undefined;
     workflowId?: string | undefined;
-    nodeId?: string | undefined;
+    nativeRunId?: string | undefined;
     args?: unknown;
     toolCallId?: string | undefined;
 }, {
@@ -596,11 +1374,22 @@ export declare const StreamEvent: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
     turnId: string;
     seq: number;
     toolName: string;
+    nodeId?: string | undefined;
+    source?: string | undefined;
     role?: string | undefined;
     origin?: "solicited" | "unsolicited" | undefined;
-    source?: string | undefined;
+    sourceEventId?: string | undefined;
+    nativeProactive?: {
+        agent: string;
+        model: string;
+        project: string;
+        employeeId: string;
+        employeeRevision: number;
+        anchorRunId: string;
+        upstreamId: string;
+    } | undefined;
     workflowId?: string | undefined;
-    nodeId?: string | undefined;
+    nativeRunId?: string | undefined;
     args?: unknown;
     toolCallId?: string | undefined;
 }>, z.ZodObject<{
@@ -614,6 +1403,33 @@ export declare const StreamEvent: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
     origin: z.ZodDefault<z.ZodEnum<["solicited", "unsolicited"]>>;
     /** unsolicited 时的冲泡来源标签，如 "cron" / "scheduled" / "heartbeat"。 */
     source: z.ZodOptional<z.ZodString>;
+    /** Native harness output identity; not a caller-selected conversation or sender. */
+    sourceEventId: z.ZodOptional<z.ZodString>;
+    nativeProactive: z.ZodOptional<z.ZodObject<{
+        anchorRunId: z.ZodString;
+        employeeId: z.ZodString;
+        employeeRevision: z.ZodNumber;
+        upstreamId: z.ZodString;
+        project: z.ZodString;
+        agent: z.ZodString;
+        model: z.ZodString;
+    }, "strict", z.ZodTypeAny, {
+        agent: string;
+        model: string;
+        project: string;
+        employeeId: string;
+        employeeRevision: number;
+        anchorRunId: string;
+        upstreamId: string;
+    }, {
+        agent: string;
+        model: string;
+        project: string;
+        employeeId: string;
+        employeeRevision: number;
+        anchorRunId: string;
+        upstreamId: string;
+    }>>;
     /** 单调递增序号（按 session），保证调用方可排序/去重。 */
     seq: z.ZodNumber;
     at: z.ZodString;
@@ -626,6 +1442,8 @@ export declare const StreamEvent: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
     workflowId: z.ZodOptional<z.ZodString>;
     nodeId: z.ZodOptional<z.ZodString>;
     role: z.ZodOptional<z.ZodString>;
+    /** Server-generated native conversation run correlation, stamped by core. */
+    nativeRunId: z.ZodOptional<z.ZodString>;
 } & {
     type: z.ZodLiteral<"tool_result">;
     toolName: z.ZodString;
@@ -642,10 +1460,21 @@ export declare const StreamEvent: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
     seq: number;
     toolName: string;
     ok: boolean;
-    role?: string | undefined;
+    nodeId?: string | undefined;
     source?: string | undefined;
+    role?: string | undefined;
+    sourceEventId?: string | undefined;
+    nativeProactive?: {
+        agent: string;
+        model: string;
+        project: string;
+        employeeId: string;
+        employeeRevision: number;
+        anchorRunId: string;
+        upstreamId: string;
+    } | undefined;
     workflowId?: string | undefined;
-    nodeId?: string | undefined;
+    nativeRunId?: string | undefined;
     toolCallId?: string | undefined;
     output?: unknown;
 }, {
@@ -656,11 +1485,22 @@ export declare const StreamEvent: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
     seq: number;
     toolName: string;
     ok: boolean;
+    nodeId?: string | undefined;
+    source?: string | undefined;
     role?: string | undefined;
     origin?: "solicited" | "unsolicited" | undefined;
-    source?: string | undefined;
+    sourceEventId?: string | undefined;
+    nativeProactive?: {
+        agent: string;
+        model: string;
+        project: string;
+        employeeId: string;
+        employeeRevision: number;
+        anchorRunId: string;
+        upstreamId: string;
+    } | undefined;
     workflowId?: string | undefined;
-    nodeId?: string | undefined;
+    nativeRunId?: string | undefined;
     toolCallId?: string | undefined;
     output?: unknown;
 }>, z.ZodObject<{
@@ -674,6 +1514,33 @@ export declare const StreamEvent: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
     origin: z.ZodDefault<z.ZodEnum<["solicited", "unsolicited"]>>;
     /** unsolicited 时的冲泡来源标签，如 "cron" / "scheduled" / "heartbeat"。 */
     source: z.ZodOptional<z.ZodString>;
+    /** Native harness output identity; not a caller-selected conversation or sender. */
+    sourceEventId: z.ZodOptional<z.ZodString>;
+    nativeProactive: z.ZodOptional<z.ZodObject<{
+        anchorRunId: z.ZodString;
+        employeeId: z.ZodString;
+        employeeRevision: z.ZodNumber;
+        upstreamId: z.ZodString;
+        project: z.ZodString;
+        agent: z.ZodString;
+        model: z.ZodString;
+    }, "strict", z.ZodTypeAny, {
+        agent: string;
+        model: string;
+        project: string;
+        employeeId: string;
+        employeeRevision: number;
+        anchorRunId: string;
+        upstreamId: string;
+    }, {
+        agent: string;
+        model: string;
+        project: string;
+        employeeId: string;
+        employeeRevision: number;
+        anchorRunId: string;
+        upstreamId: string;
+    }>>;
     /** 单调递增序号（按 session），保证调用方可排序/去重。 */
     seq: z.ZodNumber;
     at: z.ZodString;
@@ -686,6 +1553,8 @@ export declare const StreamEvent: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
     workflowId: z.ZodOptional<z.ZodString>;
     nodeId: z.ZodOptional<z.ZodString>;
     role: z.ZodOptional<z.ZodString>;
+    /** Server-generated native conversation run correlation, stamped by core. */
+    nativeRunId: z.ZodOptional<z.ZodString>;
 } & {
     type: z.ZodLiteral<"token">;
     text: z.ZodString;
@@ -697,10 +1566,21 @@ export declare const StreamEvent: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
     origin: "solicited" | "unsolicited";
     seq: number;
     text: string;
-    role?: string | undefined;
+    nodeId?: string | undefined;
     source?: string | undefined;
+    role?: string | undefined;
+    sourceEventId?: string | undefined;
+    nativeProactive?: {
+        agent: string;
+        model: string;
+        project: string;
+        employeeId: string;
+        employeeRevision: number;
+        anchorRunId: string;
+        upstreamId: string;
+    } | undefined;
     workflowId?: string | undefined;
-    nodeId?: string | undefined;
+    nativeRunId?: string | undefined;
 }, {
     at: string;
     type: "token";
@@ -708,11 +1588,22 @@ export declare const StreamEvent: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
     turnId: string;
     seq: number;
     text: string;
+    nodeId?: string | undefined;
+    source?: string | undefined;
     role?: string | undefined;
     origin?: "solicited" | "unsolicited" | undefined;
-    source?: string | undefined;
+    sourceEventId?: string | undefined;
+    nativeProactive?: {
+        agent: string;
+        model: string;
+        project: string;
+        employeeId: string;
+        employeeRevision: number;
+        anchorRunId: string;
+        upstreamId: string;
+    } | undefined;
     workflowId?: string | undefined;
-    nodeId?: string | undefined;
+    nativeRunId?: string | undefined;
 }>, z.ZodObject<{
     sessionId: z.ZodBranded<z.ZodString, "SessionId">;
     /**
@@ -724,6 +1615,33 @@ export declare const StreamEvent: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
     origin: z.ZodDefault<z.ZodEnum<["solicited", "unsolicited"]>>;
     /** unsolicited 时的冲泡来源标签，如 "cron" / "scheduled" / "heartbeat"。 */
     source: z.ZodOptional<z.ZodString>;
+    /** Native harness output identity; not a caller-selected conversation or sender. */
+    sourceEventId: z.ZodOptional<z.ZodString>;
+    nativeProactive: z.ZodOptional<z.ZodObject<{
+        anchorRunId: z.ZodString;
+        employeeId: z.ZodString;
+        employeeRevision: z.ZodNumber;
+        upstreamId: z.ZodString;
+        project: z.ZodString;
+        agent: z.ZodString;
+        model: z.ZodString;
+    }, "strict", z.ZodTypeAny, {
+        agent: string;
+        model: string;
+        project: string;
+        employeeId: string;
+        employeeRevision: number;
+        anchorRunId: string;
+        upstreamId: string;
+    }, {
+        agent: string;
+        model: string;
+        project: string;
+        employeeId: string;
+        employeeRevision: number;
+        anchorRunId: string;
+        upstreamId: string;
+    }>>;
     /** 单调递增序号（按 session），保证调用方可排序/去重。 */
     seq: z.ZodNumber;
     at: z.ZodString;
@@ -736,6 +1654,8 @@ export declare const StreamEvent: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
     workflowId: z.ZodOptional<z.ZodString>;
     nodeId: z.ZodOptional<z.ZodString>;
     role: z.ZodOptional<z.ZodString>;
+    /** Server-generated native conversation run correlation, stamped by core. */
+    nativeRunId: z.ZodOptional<z.ZodString>;
 } & {
     type: z.ZodLiteral<"result">;
     /** 本轮最终文本结果。 */
@@ -765,17 +1685,28 @@ export declare const StreamEvent: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
 }, "strip", z.ZodTypeAny, {
     at: string;
     type: "result";
-    status: "aborted" | "interrupted" | "completed" | "failed" | "timeout";
+    status: "aborted" | "failed" | "interrupted" | "completed" | "timeout";
     final: true;
     sessionId: string & z.BRAND<"SessionId">;
     turnId: string;
     origin: "solicited" | "unsolicited";
     seq: number;
     text: string;
-    role?: string | undefined;
+    nodeId?: string | undefined;
     source?: string | undefined;
+    role?: string | undefined;
+    sourceEventId?: string | undefined;
+    nativeProactive?: {
+        agent: string;
+        model: string;
+        project: string;
+        employeeId: string;
+        employeeRevision: number;
+        anchorRunId: string;
+        upstreamId: string;
+    } | undefined;
     workflowId?: string | undefined;
-    nodeId?: string | undefined;
+    nativeRunId?: string | undefined;
     usage?: {
         inputTokens?: number | undefined;
         outputTokens?: number | undefined;
@@ -788,12 +1719,23 @@ export declare const StreamEvent: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
     turnId: string;
     seq: number;
     text: string;
-    status?: "aborted" | "interrupted" | "completed" | "failed" | "timeout" | undefined;
+    status?: "aborted" | "failed" | "interrupted" | "completed" | "timeout" | undefined;
+    nodeId?: string | undefined;
+    source?: string | undefined;
     role?: string | undefined;
     origin?: "solicited" | "unsolicited" | undefined;
-    source?: string | undefined;
+    sourceEventId?: string | undefined;
+    nativeProactive?: {
+        agent: string;
+        model: string;
+        project: string;
+        employeeId: string;
+        employeeRevision: number;
+        anchorRunId: string;
+        upstreamId: string;
+    } | undefined;
     workflowId?: string | undefined;
-    nodeId?: string | undefined;
+    nativeRunId?: string | undefined;
     usage?: {
         inputTokens?: number | undefined;
         outputTokens?: number | undefined;
@@ -809,6 +1751,33 @@ export declare const StreamEvent: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
     origin: z.ZodDefault<z.ZodEnum<["solicited", "unsolicited"]>>;
     /** unsolicited 时的冲泡来源标签，如 "cron" / "scheduled" / "heartbeat"。 */
     source: z.ZodOptional<z.ZodString>;
+    /** Native harness output identity; not a caller-selected conversation or sender. */
+    sourceEventId: z.ZodOptional<z.ZodString>;
+    nativeProactive: z.ZodOptional<z.ZodObject<{
+        anchorRunId: z.ZodString;
+        employeeId: z.ZodString;
+        employeeRevision: z.ZodNumber;
+        upstreamId: z.ZodString;
+        project: z.ZodString;
+        agent: z.ZodString;
+        model: z.ZodString;
+    }, "strict", z.ZodTypeAny, {
+        agent: string;
+        model: string;
+        project: string;
+        employeeId: string;
+        employeeRevision: number;
+        anchorRunId: string;
+        upstreamId: string;
+    }, {
+        agent: string;
+        model: string;
+        project: string;
+        employeeId: string;
+        employeeRevision: number;
+        anchorRunId: string;
+        upstreamId: string;
+    }>>;
     /** 单调递增序号（按 session），保证调用方可排序/去重。 */
     seq: z.ZodNumber;
     at: z.ZodString;
@@ -821,6 +1790,8 @@ export declare const StreamEvent: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
     workflowId: z.ZodOptional<z.ZodString>;
     nodeId: z.ZodOptional<z.ZodString>;
     role: z.ZodOptional<z.ZodString>;
+    /** Server-generated native conversation run correlation, stamped by core. */
+    nativeRunId: z.ZodOptional<z.ZodString>;
 } & {
     type: z.ZodLiteral<"error">;
     message: z.ZodString;
@@ -833,17 +1804,28 @@ export declare const StreamEvent: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
     at: string;
     message: string;
     type: "error";
-    status: "aborted" | "interrupted" | "failed" | "timeout";
+    status: "aborted" | "failed" | "interrupted" | "timeout";
     final: true;
     sessionId: string & z.BRAND<"SessionId">;
     turnId: string;
     origin: "solicited" | "unsolicited";
     seq: number;
     appCode?: string | undefined;
-    role?: string | undefined;
+    nodeId?: string | undefined;
     source?: string | undefined;
+    role?: string | undefined;
+    sourceEventId?: string | undefined;
+    nativeProactive?: {
+        agent: string;
+        model: string;
+        project: string;
+        employeeId: string;
+        employeeRevision: number;
+        anchorRunId: string;
+        upstreamId: string;
+    } | undefined;
     workflowId?: string | undefined;
-    nodeId?: string | undefined;
+    nativeRunId?: string | undefined;
 }, {
     at: string;
     message: string;
@@ -852,13 +1834,24 @@ export declare const StreamEvent: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
     sessionId: string;
     turnId: string;
     seq: number;
-    status?: "aborted" | "interrupted" | "failed" | "timeout" | undefined;
+    status?: "aborted" | "failed" | "interrupted" | "timeout" | undefined;
     appCode?: string | undefined;
+    nodeId?: string | undefined;
+    source?: string | undefined;
     role?: string | undefined;
     origin?: "solicited" | "unsolicited" | undefined;
-    source?: string | undefined;
+    sourceEventId?: string | undefined;
+    nativeProactive?: {
+        agent: string;
+        model: string;
+        project: string;
+        employeeId: string;
+        employeeRevision: number;
+        anchorRunId: string;
+        upstreamId: string;
+    } | undefined;
     workflowId?: string | undefined;
-    nodeId?: string | undefined;
+    nativeRunId?: string | undefined;
 }>]>;
 export type StreamEvent = z.infer<typeof StreamEvent>;
 //# sourceMappingURL=stream.d.ts.map