@agent-phonon/protocol 0.3.0 → 0.6.0

package/dist/schemas/workflow.d.ts

@@ -2,11 +2,19 @@ import { z } from "zod";
 export declare const WorkflowId: z.ZodString;
 export declare const WorkflowNodeId: z.ZodString;
 export declare const WorkflowEdgeId: z.ZodString;
+/**
+ * Role 字段说明（review v0.5）：
+ *   role 是这个 agent 在当前 workflow 中扮演的角色，由调用方自由定义。
+ *   phonon 只做透传 + 在 stream.event / workflow.event 里回显，不解析其语义。
+ *   常见示例："executor" / "worker" / "reviewer" / "coder" / "planner" / "chairman" / "participant"
+ *   上层服务可以把 role 映射到 category / system prompt / 模型选择，phonon 不感知。
+ */
 export declare const WorkflowRoleId: z.ZodString;
 export declare const WorkflowNode: z.ZodObject<{
     nodeId: z.ZodString;
     agent: z.ZodBranded<z.ZodString, "AgentId">;
     model: z.ZodString;
+    /** 该节点在 workflow 中扮演的角色（由调用方定义，phonon 仅回显）。 */
     role: z.ZodOptional<z.ZodString>;
     input: z.ZodOptional<z.ZodString>;
     systemPrompt: z.ZodOptional<z.ZodString>;
@@ -14,14 +22,41 @@ export declare const WorkflowNode: z.ZodObject<{
     sessionId: z.ZodOptional<z.ZodBranded<z.ZodString, "SessionId">>;
     agentConfig: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
     metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    /**
+     * 此节点跑在哪个 project。不传默认继承 workflow 级 project。
+     * project + workflow 级都没传，phonon 拒接。
+     */
+    project: z.ZodOptional<z.ZodBranded<z.ZodString, "ProjectId">>;
+    /**
+     * 隔离 key。调用方自定义的任意字符串。
+     * - 不传  → 该节点跑在 project 主目录
+     * - 传了 → phonon 按 (projectId, worktreeId) 复合键维护隔离 worktree：
+     *           • 同一 workflow 内首次看到 → 创建 worktree（branch 名 phonon 自动生成）
+     *           • 同一 workflow 内后续节点用同一 key → 复用同一 worktree
+     *           • 不跨 workflow 复用（下次 workflow.run 同名 key 是新 worktree）
+     * - workflow 终态时 phonon 尝试自动清理：git status 干净则 worktree remove；dirty 则保留
+     *   且发 workflow.status payload warn。创出的 branch 一律不删。
+     */
+    worktreeId: z.ZodOptional<z.ZodString>;
+    /**
+     * Git branch。意义联动 worktreeId：
+     * - 不传 worktreeId 传 branch → 在 project 主目录先 `git checkout <branch>` 再跑（对主目录有副作用，法定调用方负责）
+     * - 传 worktreeId 首次传 branch → 作为新 worktree 的 base branch（从它检出）
+     * - 传 worktreeId 未传 branch 首次 → 从 project 当前 branch 检出
+     * - worktreeId 复用时 branch 被忽略（worktree 已存在）
+     */
+    branch: z.ZodOptional<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
     agent: string & z.BRAND<"AgentId">;
     model: string;
     nodeId: string;
     sessionId?: (string & z.BRAND<"SessionId">) | undefined;
     role?: string | undefined;
+    project?: (string & z.BRAND<"ProjectId">) | undefined;
+    worktreeId?: string | undefined;
     agentConfig?: Record<string, unknown> | undefined;
     input?: string | undefined;
+    branch?: string | undefined;
     systemPrompt?: string | undefined;
     dependsOn?: string[] | undefined;
     metadata?: Record<string, unknown> | undefined;
@@ -31,8 +66,11 @@ export declare const WorkflowNode: z.ZodObject<{
     nodeId: string;
     sessionId?: string | undefined;
     role?: string | undefined;
+    project?: string | undefined;
+    worktreeId?: string | undefined;
     agentConfig?: Record<string, unknown> | undefined;
     input?: string | undefined;
+    branch?: string | undefined;
     systemPrompt?: string | undefined;
     dependsOn?: string[] | undefined;
     metadata?: Record<string, unknown> | undefined;
@@ -67,6 +105,7 @@ export declare const WorkflowDagPlan: z.ZodObject<{
         nodeId: z.ZodString;
         agent: z.ZodBranded<z.ZodString, "AgentId">;
         model: z.ZodString;
+        /** 该节点在 workflow 中扮演的角色（由调用方定义，phonon 仅回显）。 */
         role: z.ZodOptional<z.ZodString>;
         input: z.ZodOptional<z.ZodString>;
         systemPrompt: z.ZodOptional<z.ZodString>;
@@ -74,14 +113,41 @@ export declare const WorkflowDagPlan: z.ZodObject<{
         sessionId: z.ZodOptional<z.ZodBranded<z.ZodString, "SessionId">>;
         agentConfig: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
         metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        /**
+         * 此节点跑在哪个 project。不传默认继承 workflow 级 project。
+         * project + workflow 级都没传，phonon 拒接。
+         */
+        project: z.ZodOptional<z.ZodBranded<z.ZodString, "ProjectId">>;
+        /**
+         * 隔离 key。调用方自定义的任意字符串。
+         * - 不传  → 该节点跑在 project 主目录
+         * - 传了 → phonon 按 (projectId, worktreeId) 复合键维护隔离 worktree：
+         *           • 同一 workflow 内首次看到 → 创建 worktree（branch 名 phonon 自动生成）
+         *           • 同一 workflow 内后续节点用同一 key → 复用同一 worktree
+         *           • 不跨 workflow 复用（下次 workflow.run 同名 key 是新 worktree）
+         * - workflow 终态时 phonon 尝试自动清理：git status 干净则 worktree remove；dirty 则保留
+         *   且发 workflow.status payload warn。创出的 branch 一律不删。
+         */
+        worktreeId: z.ZodOptional<z.ZodString>;
+        /**
+         * Git branch。意义联动 worktreeId：
+         * - 不传 worktreeId 传 branch → 在 project 主目录先 `git checkout <branch>` 再跑（对主目录有副作用，法定调用方负责）
+         * - 传 worktreeId 首次传 branch → 作为新 worktree 的 base branch（从它检出）
+         * - 传 worktreeId 未传 branch 首次 → 从 project 当前 branch 检出
+         * - worktreeId 复用时 branch 被忽略（worktree 已存在）
+         */
+        branch: z.ZodOptional<z.ZodString>;
     }, "strip", z.ZodTypeAny, {
         agent: string & z.BRAND<"AgentId">;
         model: string;
         nodeId: string;
         sessionId?: (string & z.BRAND<"SessionId">) | undefined;
         role?: string | undefined;
+        project?: (string & z.BRAND<"ProjectId">) | undefined;
+        worktreeId?: string | undefined;
         agentConfig?: Record<string, unknown> | undefined;
         input?: string | undefined;
+        branch?: string | undefined;
         systemPrompt?: string | undefined;
         dependsOn?: string[] | undefined;
         metadata?: Record<string, unknown> | undefined;
@@ -91,8 +157,11 @@ export declare const WorkflowDagPlan: z.ZodObject<{
         nodeId: string;
         sessionId?: string | undefined;
         role?: string | undefined;
+        project?: string | undefined;
+        worktreeId?: string | undefined;
         agentConfig?: Record<string, unknown> | undefined;
         input?: string | undefined;
+        branch?: string | undefined;
         systemPrompt?: string | undefined;
         dependsOn?: string[] | undefined;
         metadata?: Record<string, unknown> | undefined;
@@ -128,8 +197,11 @@ export declare const WorkflowDagPlan: z.ZodObject<{
         nodeId: string;
         sessionId?: (string & z.BRAND<"SessionId">) | undefined;
         role?: string | undefined;
+        project?: (string & z.BRAND<"ProjectId">) | undefined;
+        worktreeId?: string | undefined;
         agentConfig?: Record<string, unknown> | undefined;
         input?: string | undefined;
+        branch?: string | undefined;
         systemPrompt?: string | undefined;
         dependsOn?: string[] | undefined;
         metadata?: Record<string, unknown> | undefined;
@@ -151,8 +223,11 @@ export declare const WorkflowDagPlan: z.ZodObject<{
         nodeId: string;
         sessionId?: string | undefined;
         role?: string | undefined;
+        project?: string | undefined;
+        worktreeId?: string | undefined;
         agentConfig?: Record<string, unknown> | undefined;
         input?: string | undefined;
+        branch?: string | undefined;
         systemPrompt?: string | undefined;
         dependsOn?: string[] | undefined;
         metadata?: Record<string, unknown> | undefined;
@@ -217,34 +292,102 @@ export declare const WorkflowCommunicationGraph: z.ZodObject<{
     maxIterations?: number | undefined;
 }>;
 export type WorkflowCommunicationGraph = z.infer<typeof WorkflowCommunicationGraph>;
+export declare const WorkflowExecutorNode: z.ZodObject<{
+    nodeId: z.ZodString;
+    agent: z.ZodBranded<z.ZodString, "AgentId">;
+    model: z.ZodString;
+    input: z.ZodOptional<z.ZodString>;
+    systemPrompt: z.ZodOptional<z.ZodString>;
+    dependsOn: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    sessionId: z.ZodOptional<z.ZodBranded<z.ZodString, "SessionId">>;
+    agentConfig: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    project: z.ZodOptional<z.ZodBranded<z.ZodString, "ProjectId">>;
+    worktreeId: z.ZodOptional<z.ZodString>;
+    branch: z.ZodOptional<z.ZodString>;
+} & {
+    role: z.ZodDefault<z.ZodLiteral<"executor">>;
+}, "strip", z.ZodTypeAny, {
+    agent: string & z.BRAND<"AgentId">;
+    role: "executor";
+    model: string;
+    nodeId: string;
+    sessionId?: (string & z.BRAND<"SessionId">) | undefined;
+    project?: (string & z.BRAND<"ProjectId">) | undefined;
+    worktreeId?: string | undefined;
+    agentConfig?: Record<string, unknown> | undefined;
+    input?: string | undefined;
+    branch?: string | undefined;
+    systemPrompt?: string | undefined;
+    dependsOn?: string[] | undefined;
+    metadata?: Record<string, unknown> | undefined;
+}, {
+    agent: string;
+    model: string;
+    nodeId: string;
+    sessionId?: string | undefined;
+    role?: "executor" | undefined;
+    project?: string | undefined;
+    worktreeId?: string | undefined;
+    agentConfig?: Record<string, unknown> | undefined;
+    input?: string | undefined;
+    branch?: string | undefined;
+    systemPrompt?: string | undefined;
+    dependsOn?: string[] | undefined;
+    metadata?: Record<string, unknown> | undefined;
+}>;
+export type WorkflowExecutorNode = z.infer<typeof WorkflowExecutorNode>;
 export declare const WorkflowGraphPlan: z.ZodObject<{
     mode: z.ZodLiteral<"graph">;
     executor: z.ZodObject<{
         nodeId: z.ZodString;
         agent: z.ZodBranded<z.ZodString, "AgentId">;
         model: z.ZodString;
-        role: z.ZodDefault<z.ZodLiteral<"executor">>;
+        input: z.ZodOptional<z.ZodString>;
         systemPrompt: z.ZodOptional<z.ZodString>;
+        dependsOn: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        sessionId: z.ZodOptional<z.ZodBranded<z.ZodString, "SessionId">>;
         agentConfig: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        project: z.ZodOptional<z.ZodBranded<z.ZodString, "ProjectId">>;
+        worktreeId: z.ZodOptional<z.ZodString>;
+        branch: z.ZodOptional<z.ZodString>;
+    } & {
+        role: z.ZodDefault<z.ZodLiteral<"executor">>;
     }, "strip", z.ZodTypeAny, {
         agent: string & z.BRAND<"AgentId">;
         role: "executor";
         model: string;
         nodeId: string;
+        sessionId?: (string & z.BRAND<"SessionId">) | undefined;
+        project?: (string & z.BRAND<"ProjectId">) | undefined;
+        worktreeId?: string | undefined;
         agentConfig?: Record<string, unknown> | undefined;
+        input?: string | undefined;
+        branch?: string | undefined;
         systemPrompt?: string | undefined;
+        dependsOn?: string[] | undefined;
+        metadata?: Record<string, unknown> | undefined;
     }, {
         agent: string;
         model: string;
         nodeId: string;
+        sessionId?: string | undefined;
         role?: "executor" | undefined;
+        project?: string | undefined;
+        worktreeId?: string | undefined;
         agentConfig?: Record<string, unknown> | undefined;
+        input?: string | undefined;
+        branch?: string | undefined;
         systemPrompt?: string | undefined;
+        dependsOn?: string[] | undefined;
+        metadata?: Record<string, unknown> | undefined;
     }>;
     workers: z.ZodArray<z.ZodObject<{
         nodeId: z.ZodString;
         agent: z.ZodBranded<z.ZodString, "AgentId">;
         model: z.ZodString;
+        /** 该节点在 workflow 中扮演的角色（由调用方定义，phonon 仅回显）。 */
         role: z.ZodOptional<z.ZodString>;
         input: z.ZodOptional<z.ZodString>;
         systemPrompt: z.ZodOptional<z.ZodString>;
@@ -252,14 +395,41 @@ export declare const WorkflowGraphPlan: z.ZodObject<{
         sessionId: z.ZodOptional<z.ZodBranded<z.ZodString, "SessionId">>;
         agentConfig: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
         metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        /**
+         * 此节点跑在哪个 project。不传默认继承 workflow 级 project。
+         * project + workflow 级都没传，phonon 拒接。
+         */
+        project: z.ZodOptional<z.ZodBranded<z.ZodString, "ProjectId">>;
+        /**
+         * 隔离 key。调用方自定义的任意字符串。
+         * - 不传  → 该节点跑在 project 主目录
+         * - 传了 → phonon 按 (projectId, worktreeId) 复合键维护隔离 worktree：
+         *           • 同一 workflow 内首次看到 → 创建 worktree（branch 名 phonon 自动生成）
+         *           • 同一 workflow 内后续节点用同一 key → 复用同一 worktree
+         *           • 不跨 workflow 复用（下次 workflow.run 同名 key 是新 worktree）
+         * - workflow 终态时 phonon 尝试自动清理：git status 干净则 worktree remove；dirty 则保留
+         *   且发 workflow.status payload warn。创出的 branch 一律不删。
+         */
+        worktreeId: z.ZodOptional<z.ZodString>;
+        /**
+         * Git branch。意义联动 worktreeId：
+         * - 不传 worktreeId 传 branch → 在 project 主目录先 `git checkout <branch>` 再跑（对主目录有副作用，法定调用方负责）
+         * - 传 worktreeId 首次传 branch → 作为新 worktree 的 base branch（从它检出）
+         * - 传 worktreeId 未传 branch 首次 → 从 project 当前 branch 检出
+         * - worktreeId 复用时 branch 被忽略（worktree 已存在）
+         */
+        branch: z.ZodOptional<z.ZodString>;
     }, "strip", z.ZodTypeAny, {
         agent: string & z.BRAND<"AgentId">;
         model: string;
         nodeId: string;
         sessionId?: (string & z.BRAND<"SessionId">) | undefined;
         role?: string | undefined;
+        project?: (string & z.BRAND<"ProjectId">) | undefined;
+        worktreeId?: string | undefined;
         agentConfig?: Record<string, unknown> | undefined;
         input?: string | undefined;
+        branch?: string | undefined;
         systemPrompt?: string | undefined;
         dependsOn?: string[] | undefined;
         metadata?: Record<string, unknown> | undefined;
@@ -269,8 +439,11 @@ export declare const WorkflowGraphPlan: z.ZodObject<{
         nodeId: string;
         sessionId?: string | undefined;
         role?: string | undefined;
+        project?: string | undefined;
+        worktreeId?: string | undefined;
         agentConfig?: Record<string, unknown> | undefined;
         input?: string | undefined;
+        branch?: string | undefined;
         systemPrompt?: string | undefined;
         dependsOn?: string[] | undefined;
         metadata?: Record<string, unknown> | undefined;
@@ -324,23 +497,33 @@ export declare const WorkflowGraphPlan: z.ZodObject<{
         maxIterations?: number | undefined;
     }>;
 }, "strip", z.ZodTypeAny, {
-    mode: "graph";
     executor: {
         agent: string & z.BRAND<"AgentId">;
         role: "executor";
         model: string;
         nodeId: string;
+        sessionId?: (string & z.BRAND<"SessionId">) | undefined;
+        project?: (string & z.BRAND<"ProjectId">) | undefined;
+        worktreeId?: string | undefined;
         agentConfig?: Record<string, unknown> | undefined;
+        input?: string | undefined;
+        branch?: string | undefined;
         systemPrompt?: string | undefined;
+        dependsOn?: string[] | undefined;
+        metadata?: Record<string, unknown> | undefined;
     };
+    mode: "graph";
     workers: {
         agent: string & z.BRAND<"AgentId">;
         model: string;
         nodeId: string;
         sessionId?: (string & z.BRAND<"SessionId">) | undefined;
         role?: string | undefined;
+        project?: (string & z.BRAND<"ProjectId">) | undefined;
+        worktreeId?: string | undefined;
         agentConfig?: Record<string, unknown> | undefined;
         input?: string | undefined;
+        branch?: string | undefined;
         systemPrompt?: string | undefined;
         dependsOn?: string[] | undefined;
         metadata?: Record<string, unknown> | undefined;
@@ -358,23 +541,33 @@ export declare const WorkflowGraphPlan: z.ZodObject<{
         maxIterations: number;
     };
 }, {
-    mode: "graph";
     executor: {
         agent: string;
         model: string;
         nodeId: string;
+        sessionId?: string | undefined;
         role?: "executor" | undefined;
+        project?: string | undefined;
+        worktreeId?: string | undefined;
         agentConfig?: Record<string, unknown> | undefined;
+        input?: string | undefined;
+        branch?: string | undefined;
         systemPrompt?: string | undefined;
+        dependsOn?: string[] | undefined;
+        metadata?: Record<string, unknown> | undefined;
     };
+    mode: "graph";
     workers: {
         agent: string;
         model: string;
         nodeId: string;
         sessionId?: string | undefined;
         role?: string | undefined;
+        project?: string | undefined;
+        worktreeId?: string | undefined;
         agentConfig?: Record<string, unknown> | undefined;
         input?: string | undefined;
+        branch?: string | undefined;
         systemPrompt?: string | undefined;
         dependsOn?: string[] | undefined;
         metadata?: Record<string, unknown> | undefined;
@@ -393,12 +586,151 @@ export declare const WorkflowGraphPlan: z.ZodObject<{
     };
 }>;
 export type WorkflowGraphPlan = z.infer<typeof WorkflowGraphPlan>;
+export declare const WorkflowDiscussionPlan: z.ZodObject<{
+    mode: z.ZodLiteral<"discussion">;
+    /** 主题（initial input） — 所有 participant 第一轮收到这个。 */
+    topic: z.ZodString;
+    /** 参与者列表（无主从）。 */
+    participants: z.ZodArray<z.ZodObject<{
+        nodeId: z.ZodString;
+        agent: z.ZodBranded<z.ZodString, "AgentId">;
+        model: z.ZodString;
+        /** 该节点在 workflow 中扮演的角色（由调用方定义，phonon 仅回显）。 */
+        role: z.ZodOptional<z.ZodString>;
+        input: z.ZodOptional<z.ZodString>;
+        systemPrompt: z.ZodOptional<z.ZodString>;
+        dependsOn: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        sessionId: z.ZodOptional<z.ZodBranded<z.ZodString, "SessionId">>;
+        agentConfig: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        /**
+         * 此节点跑在哪个 project。不传默认继承 workflow 级 project。
+         * project + workflow 级都没传，phonon 拒接。
+         */
+        project: z.ZodOptional<z.ZodBranded<z.ZodString, "ProjectId">>;
+        /**
+         * 隔离 key。调用方自定义的任意字符串。
+         * - 不传  → 该节点跑在 project 主目录
+         * - 传了 → phonon 按 (projectId, worktreeId) 复合键维护隔离 worktree：
+         *           • 同一 workflow 内首次看到 → 创建 worktree（branch 名 phonon 自动生成）
+         *           • 同一 workflow 内后续节点用同一 key → 复用同一 worktree
+         *           • 不跨 workflow 复用（下次 workflow.run 同名 key 是新 worktree）
+         * - workflow 终态时 phonon 尝试自动清理：git status 干净则 worktree remove；dirty 则保留
+         *   且发 workflow.status payload warn。创出的 branch 一律不删。
+         */
+        worktreeId: z.ZodOptional<z.ZodString>;
+        /**
+         * Git branch。意义联动 worktreeId：
+         * - 不传 worktreeId 传 branch → 在 project 主目录先 `git checkout <branch>` 再跑（对主目录有副作用，法定调用方负责）
+         * - 传 worktreeId 首次传 branch → 作为新 worktree 的 base branch（从它检出）
+         * - 传 worktreeId 未传 branch 首次 → 从 project 当前 branch 检出
+         * - worktreeId 复用时 branch 被忽略（worktree 已存在）
+         */
+        branch: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        agent: string & z.BRAND<"AgentId">;
+        model: string;
+        nodeId: string;
+        sessionId?: (string & z.BRAND<"SessionId">) | undefined;
+        role?: string | undefined;
+        project?: (string & z.BRAND<"ProjectId">) | undefined;
+        worktreeId?: string | undefined;
+        agentConfig?: Record<string, unknown> | undefined;
+        input?: string | undefined;
+        branch?: string | undefined;
+        systemPrompt?: string | undefined;
+        dependsOn?: string[] | undefined;
+        metadata?: Record<string, unknown> | undefined;
+    }, {
+        agent: string;
+        model: string;
+        nodeId: string;
+        sessionId?: string | undefined;
+        role?: string | undefined;
+        project?: string | undefined;
+        worktreeId?: string | undefined;
+        agentConfig?: Record<string, unknown> | undefined;
+        input?: string | undefined;
+        branch?: string | undefined;
+        systemPrompt?: string | undefined;
+        dependsOn?: string[] | undefined;
+        metadata?: Record<string, unknown> | undefined;
+    }>, "many">;
+    /** Chairman 必须是 participants 之一的 nodeId，每轮所有 participant 发完它再 review + 决定续/停。 */
+    chairman: z.ZodString;
+    termination: z.ZodDefault<z.ZodObject<{
+        /** chairman 输出含该信号则终止。 */
+        chairmanSignal: z.ZodDefault<z.ZodString>;
+        /** 硬上限。 */
+        maxRounds: z.ZodDefault<z.ZodNumber>;
+        /** 自然达成共识的检测字符串（任一 participant 输出含此则终止，可选）。 */
+        consensusSignal: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        chairmanSignal: string;
+        maxRounds: number;
+        consensusSignal?: string | undefined;
+    }, {
+        chairmanSignal?: string | undefined;
+        maxRounds?: number | undefined;
+        consensusSignal?: string | undefined;
+    }>>;
+}, "strip", z.ZodTypeAny, {
+    mode: "discussion";
+    topic: string;
+    participants: {
+        agent: string & z.BRAND<"AgentId">;
+        model: string;
+        nodeId: string;
+        sessionId?: (string & z.BRAND<"SessionId">) | undefined;
+        role?: string | undefined;
+        project?: (string & z.BRAND<"ProjectId">) | undefined;
+        worktreeId?: string | undefined;
+        agentConfig?: Record<string, unknown> | undefined;
+        input?: string | undefined;
+        branch?: string | undefined;
+        systemPrompt?: string | undefined;
+        dependsOn?: string[] | undefined;
+        metadata?: Record<string, unknown> | undefined;
+    }[];
+    chairman: string;
+    termination: {
+        chairmanSignal: string;
+        maxRounds: number;
+        consensusSignal?: string | undefined;
+    };
+}, {
+    mode: "discussion";
+    topic: string;
+    participants: {
+        agent: string;
+        model: string;
+        nodeId: string;
+        sessionId?: string | undefined;
+        role?: string | undefined;
+        project?: string | undefined;
+        worktreeId?: string | undefined;
+        agentConfig?: Record<string, unknown> | undefined;
+        input?: string | undefined;
+        branch?: string | undefined;
+        systemPrompt?: string | undefined;
+        dependsOn?: string[] | undefined;
+        metadata?: Record<string, unknown> | undefined;
+    }[];
+    chairman: string;
+    termination?: {
+        chairmanSignal?: string | undefined;
+        maxRounds?: number | undefined;
+        consensusSignal?: string | undefined;
+    } | undefined;
+}>;
+export type WorkflowDiscussionPlan = z.infer<typeof WorkflowDiscussionPlan>;
 export declare const WorkflowPlan: z.ZodDiscriminatedUnion<"mode", [z.ZodObject<{
     mode: z.ZodLiteral<"dag">;
     nodes: z.ZodArray<z.ZodObject<{
         nodeId: z.ZodString;
         agent: z.ZodBranded<z.ZodString, "AgentId">;
         model: z.ZodString;
+        /** 该节点在 workflow 中扮演的角色（由调用方定义，phonon 仅回显）。 */
         role: z.ZodOptional<z.ZodString>;
         input: z.ZodOptional<z.ZodString>;
         systemPrompt: z.ZodOptional<z.ZodString>;
@@ -406,14 +738,41 @@ export declare const WorkflowPlan: z.ZodDiscriminatedUnion<"mode", [z.ZodObject<
         sessionId: z.ZodOptional<z.ZodBranded<z.ZodString, "SessionId">>;
         agentConfig: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
         metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        /**
+         * 此节点跑在哪个 project。不传默认继承 workflow 级 project。
+         * project + workflow 级都没传，phonon 拒接。
+         */
+        project: z.ZodOptional<z.ZodBranded<z.ZodString, "ProjectId">>;
+        /**
+         * 隔离 key。调用方自定义的任意字符串。
+         * - 不传  → 该节点跑在 project 主目录
+         * - 传了 → phonon 按 (projectId, worktreeId) 复合键维护隔离 worktree：
+         *           • 同一 workflow 内首次看到 → 创建 worktree（branch 名 phonon 自动生成）
+         *           • 同一 workflow 内后续节点用同一 key → 复用同一 worktree
+         *           • 不跨 workflow 复用（下次 workflow.run 同名 key 是新 worktree）
+         * - workflow 终态时 phonon 尝试自动清理：git status 干净则 worktree remove；dirty 则保留
+         *   且发 workflow.status payload warn。创出的 branch 一律不删。
+         */
+        worktreeId: z.ZodOptional<z.ZodString>;
+        /**
+         * Git branch。意义联动 worktreeId：
+         * - 不传 worktreeId 传 branch → 在 project 主目录先 `git checkout <branch>` 再跑（对主目录有副作用，法定调用方负责）
+         * - 传 worktreeId 首次传 branch → 作为新 worktree 的 base branch（从它检出）
+         * - 传 worktreeId 未传 branch 首次 → 从 project 当前 branch 检出
+         * - worktreeId 复用时 branch 被忽略（worktree 已存在）
+         */
+        branch: z.ZodOptional<z.ZodString>;
     }, "strip", z.ZodTypeAny, {
         agent: string & z.BRAND<"AgentId">;
         model: string;
         nodeId: string;
         sessionId?: (string & z.BRAND<"SessionId">) | undefined;
         role?: string | undefined;
+        project?: (string & z.BRAND<"ProjectId">) | undefined;
+        worktreeId?: string | undefined;
         agentConfig?: Record<string, unknown> | undefined;
         input?: string | undefined;
+        branch?: string | undefined;
         systemPrompt?: string | undefined;
         dependsOn?: string[] | undefined;
         metadata?: Record<string, unknown> | undefined;
@@ -423,8 +782,11 @@ export declare const WorkflowPlan: z.ZodDiscriminatedUnion<"mode", [z.ZodObject<
         nodeId: string;
         sessionId?: string | undefined;
         role?: string | undefined;
+        project?: string | undefined;
+        worktreeId?: string | undefined;
         agentConfig?: Record<string, unknown> | undefined;
         input?: string | undefined;
+        branch?: string | undefined;
         systemPrompt?: string | undefined;
         dependsOn?: string[] | undefined;
         metadata?: Record<string, unknown> | undefined;
@@ -460,8 +822,11 @@ export declare const WorkflowPlan: z.ZodDiscriminatedUnion<"mode", [z.ZodObject<
         nodeId: string;
         sessionId?: (string & z.BRAND<"SessionId">) | undefined;
         role?: string | undefined;
+        project?: (string & z.BRAND<"ProjectId">) | undefined;
+        worktreeId?: string | undefined;
         agentConfig?: Record<string, unknown> | undefined;
         input?: string | undefined;
+        branch?: string | undefined;
         systemPrompt?: string | undefined;
         dependsOn?: string[] | undefined;
         metadata?: Record<string, unknown> | undefined;
@@ -483,8 +848,11 @@ export declare const WorkflowPlan: z.ZodDiscriminatedUnion<"mode", [z.ZodObject<
         nodeId: string;
         sessionId?: string | undefined;
         role?: string | undefined;
+        project?: string | undefined;
+        worktreeId?: string | undefined;
         agentConfig?: Record<string, unknown> | undefined;
         input?: string | undefined;
+        branch?: string | undefined;
         systemPrompt?: string | undefined;
         dependsOn?: string[] | undefined;
         metadata?: Record<string, unknown> | undefined;
@@ -504,28 +872,51 @@ export declare const WorkflowPlan: z.ZodDiscriminatedUnion<"mode", [z.ZodObject<
         nodeId: z.ZodString;
         agent: z.ZodBranded<z.ZodString, "AgentId">;
         model: z.ZodString;
-        role: z.ZodDefault<z.ZodLiteral<"executor">>;
+        input: z.ZodOptional<z.ZodString>;
         systemPrompt: z.ZodOptional<z.ZodString>;
+        dependsOn: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        sessionId: z.ZodOptional<z.ZodBranded<z.ZodString, "SessionId">>;
         agentConfig: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        project: z.ZodOptional<z.ZodBranded<z.ZodString, "ProjectId">>;
+        worktreeId: z.ZodOptional<z.ZodString>;
+        branch: z.ZodOptional<z.ZodString>;
+    } & {
+        role: z.ZodDefault<z.ZodLiteral<"executor">>;
     }, "strip", z.ZodTypeAny, {
         agent: string & z.BRAND<"AgentId">;
         role: "executor";
         model: string;
         nodeId: string;
+        sessionId?: (string & z.BRAND<"SessionId">) | undefined;
+        project?: (string & z.BRAND<"ProjectId">) | undefined;
+        worktreeId?: string | undefined;
         agentConfig?: Record<string, unknown> | undefined;
+        input?: string | undefined;
+        branch?: string | undefined;
         systemPrompt?: string | undefined;
+        dependsOn?: string[] | undefined;
+        metadata?: Record<string, unknown> | undefined;
     }, {
         agent: string;
         model: string;
         nodeId: string;
+        sessionId?: string | undefined;
         role?: "executor" | undefined;
+        project?: string | undefined;
+        worktreeId?: string | undefined;
         agentConfig?: Record<string, unknown> | undefined;
+        input?: string | undefined;
+        branch?: string | undefined;
         systemPrompt?: string | undefined;
+        dependsOn?: string[] | undefined;
+        metadata?: Record<string, unknown> | undefined;
     }>;
     workers: z.ZodArray<z.ZodObject<{
         nodeId: z.ZodString;
         agent: z.ZodBranded<z.ZodString, "AgentId">;
         model: z.ZodString;
+        /** 该节点在 workflow 中扮演的角色（由调用方定义，phonon 仅回显）。 */
         role: z.ZodOptional<z.ZodString>;
         input: z.ZodOptional<z.ZodString>;
         systemPrompt: z.ZodOptional<z.ZodString>;
@@ -533,14 +924,41 @@ export declare const WorkflowPlan: z.ZodDiscriminatedUnion<"mode", [z.ZodObject<
         sessionId: z.ZodOptional<z.ZodBranded<z.ZodString, "SessionId">>;
         agentConfig: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
         metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        /**
+         * 此节点跑在哪个 project。不传默认继承 workflow 级 project。
+         * project + workflow 级都没传，phonon 拒接。
+         */
+        project: z.ZodOptional<z.ZodBranded<z.ZodString, "ProjectId">>;
+        /**
+         * 隔离 key。调用方自定义的任意字符串。
+         * - 不传  → 该节点跑在 project 主目录
+         * - 传了 → phonon 按 (projectId, worktreeId) 复合键维护隔离 worktree：
+         *           • 同一 workflow 内首次看到 → 创建 worktree（branch 名 phonon 自动生成）
+         *           • 同一 workflow 内后续节点用同一 key → 复用同一 worktree
+         *           • 不跨 workflow 复用（下次 workflow.run 同名 key 是新 worktree）
+         * - workflow 终态时 phonon 尝试自动清理：git status 干净则 worktree remove；dirty 则保留
+         *   且发 workflow.status payload warn。创出的 branch 一律不删。
+         */
+        worktreeId: z.ZodOptional<z.ZodString>;
+        /**
+         * Git branch。意义联动 worktreeId：
+         * - 不传 worktreeId 传 branch → 在 project 主目录先 `git checkout <branch>` 再跑（对主目录有副作用，法定调用方负责）
+         * - 传 worktreeId 首次传 branch → 作为新 worktree 的 base branch（从它检出）
+         * - 传 worktreeId 未传 branch 首次 → 从 project 当前 branch 检出
+         * - worktreeId 复用时 branch 被忽略（worktree 已存在）
+         */
+        branch: z.ZodOptional<z.ZodString>;
     }, "strip", z.ZodTypeAny, {
         agent: string & z.BRAND<"AgentId">;
         model: string;
         nodeId: string;
         sessionId?: (string & z.BRAND<"SessionId">) | undefined;
         role?: string | undefined;
+        project?: (string & z.BRAND<"ProjectId">) | undefined;
+        worktreeId?: string | undefined;
         agentConfig?: Record<string, unknown> | undefined;
         input?: string | undefined;
+        branch?: string | undefined;
         systemPrompt?: string | undefined;
         dependsOn?: string[] | undefined;
         metadata?: Record<string, unknown> | undefined;
@@ -550,8 +968,11 @@ export declare const WorkflowPlan: z.ZodDiscriminatedUnion<"mode", [z.ZodObject<
         nodeId: string;
         sessionId?: string | undefined;
         role?: string | undefined;
+        project?: string | undefined;
+        worktreeId?: string | undefined;
         agentConfig?: Record<string, unknown> | undefined;
         input?: string | undefined;
+        branch?: string | undefined;
         systemPrompt?: string | undefined;
         dependsOn?: string[] | undefined;
         metadata?: Record<string, unknown> | undefined;
@@ -605,23 +1026,33 @@ export declare const WorkflowPlan: z.ZodDiscriminatedUnion<"mode", [z.ZodObject<
         maxIterations?: number | undefined;
     }>;
 }, "strip", z.ZodTypeAny, {
-    mode: "graph";
     executor: {
         agent: string & z.BRAND<"AgentId">;
         role: "executor";
         model: string;
         nodeId: string;
+        sessionId?: (string & z.BRAND<"SessionId">) | undefined;
+        project?: (string & z.BRAND<"ProjectId">) | undefined;
+        worktreeId?: string | undefined;
         agentConfig?: Record<string, unknown> | undefined;
+        input?: string | undefined;
+        branch?: string | undefined;
         systemPrompt?: string | undefined;
+        dependsOn?: string[] | undefined;
+        metadata?: Record<string, unknown> | undefined;
     };
+    mode: "graph";
     workers: {
         agent: string & z.BRAND<"AgentId">;
         model: string;
         nodeId: string;
         sessionId?: (string & z.BRAND<"SessionId">) | undefined;
         role?: string | undefined;
+        project?: (string & z.BRAND<"ProjectId">) | undefined;
+        worktreeId?: string | undefined;
         agentConfig?: Record<string, unknown> | undefined;
         input?: string | undefined;
+        branch?: string | undefined;
         systemPrompt?: string | undefined;
         dependsOn?: string[] | undefined;
         metadata?: Record<string, unknown> | undefined;
@@ -639,23 +1070,33 @@ export declare const WorkflowPlan: z.ZodDiscriminatedUnion<"mode", [z.ZodObject<
         maxIterations: number;
     };
 }, {
-    mode: "graph";
     executor: {
         agent: string;
         model: string;
         nodeId: string;
+        sessionId?: string | undefined;
         role?: "executor" | undefined;
+        project?: string | undefined;
+        worktreeId?: string | undefined;
         agentConfig?: Record<string, unknown> | undefined;
+        input?: string | undefined;
+        branch?: string | undefined;
         systemPrompt?: string | undefined;
+        dependsOn?: string[] | undefined;
+        metadata?: Record<string, unknown> | undefined;
     };
+    mode: "graph";
     workers: {
         agent: string;
         model: string;
         nodeId: string;
         sessionId?: string | undefined;
         role?: string | undefined;
+        project?: string | undefined;
+        worktreeId?: string | undefined;
         agentConfig?: Record<string, unknown> | undefined;
         input?: string | undefined;
+        branch?: string | undefined;
         systemPrompt?: string | undefined;
         dependsOn?: string[] | undefined;
         metadata?: Record<string, unknown> | undefined;
@@ -672,21 +1113,221 @@ export declare const WorkflowPlan: z.ZodDiscriminatedUnion<"mode", [z.ZodObject<
         allowSelfLoop?: boolean | undefined;
         maxIterations?: number | undefined;
     };
+}>, z.ZodObject<{
+    mode: z.ZodLiteral<"discussion">;
+    /** 主题（initial input） — 所有 participant 第一轮收到这个。 */
+    topic: z.ZodString;
+    /** 参与者列表（无主从）。 */
+    participants: z.ZodArray<z.ZodObject<{
+        nodeId: z.ZodString;
+        agent: z.ZodBranded<z.ZodString, "AgentId">;
+        model: z.ZodString;
+        /** 该节点在 workflow 中扮演的角色（由调用方定义，phonon 仅回显）。 */
+        role: z.ZodOptional<z.ZodString>;
+        input: z.ZodOptional<z.ZodString>;
+        systemPrompt: z.ZodOptional<z.ZodString>;
+        dependsOn: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        sessionId: z.ZodOptional<z.ZodBranded<z.ZodString, "SessionId">>;
+        agentConfig: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        /**
+         * 此节点跑在哪个 project。不传默认继承 workflow 级 project。
+         * project + workflow 级都没传，phonon 拒接。
+         */
+        project: z.ZodOptional<z.ZodBranded<z.ZodString, "ProjectId">>;
+        /**
+         * 隔离 key。调用方自定义的任意字符串。
+         * - 不传  → 该节点跑在 project 主目录
+         * - 传了 → phonon 按 (projectId, worktreeId) 复合键维护隔离 worktree：
+         *           • 同一 workflow 内首次看到 → 创建 worktree（branch 名 phonon 自动生成）
+         *           • 同一 workflow 内后续节点用同一 key → 复用同一 worktree
+         *           • 不跨 workflow 复用（下次 workflow.run 同名 key 是新 worktree）
+         * - workflow 终态时 phonon 尝试自动清理：git status 干净则 worktree remove；dirty 则保留
+         *   且发 workflow.status payload warn。创出的 branch 一律不删。
+         */
+        worktreeId: z.ZodOptional<z.ZodString>;
+        /**
+         * Git branch。意义联动 worktreeId：
+         * - 不传 worktreeId 传 branch → 在 project 主目录先 `git checkout <branch>` 再跑（对主目录有副作用，法定调用方负责）
+         * - 传 worktreeId 首次传 branch → 作为新 worktree 的 base branch（从它检出）
+         * - 传 worktreeId 未传 branch 首次 → 从 project 当前 branch 检出
+         * - worktreeId 复用时 branch 被忽略（worktree 已存在）
+         */
+        branch: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        agent: string & z.BRAND<"AgentId">;
+        model: string;
+        nodeId: string;
+        sessionId?: (string & z.BRAND<"SessionId">) | undefined;
+        role?: string | undefined;
+        project?: (string & z.BRAND<"ProjectId">) | undefined;
+        worktreeId?: string | undefined;
+        agentConfig?: Record<string, unknown> | undefined;
+        input?: string | undefined;
+        branch?: string | undefined;
+        systemPrompt?: string | undefined;
+        dependsOn?: string[] | undefined;
+        metadata?: Record<string, unknown> | undefined;
+    }, {
+        agent: string;
+        model: string;
+        nodeId: string;
+        sessionId?: string | undefined;
+        role?: string | undefined;
+        project?: string | undefined;
+        worktreeId?: string | undefined;
+        agentConfig?: Record<string, unknown> | undefined;
+        input?: string | undefined;
+        branch?: string | undefined;
+        systemPrompt?: string | undefined;
+        dependsOn?: string[] | undefined;
+        metadata?: Record<string, unknown> | undefined;
+    }>, "many">;
+    /** Chairman 必须是 participants 之一的 nodeId，每轮所有 participant 发完它再 review + 决定续/停。 */
+    chairman: z.ZodString;
+    termination: z.ZodDefault<z.ZodObject<{
+        /** chairman 输出含该信号则终止。 */
+        chairmanSignal: z.ZodDefault<z.ZodString>;
+        /** 硬上限。 */
+        maxRounds: z.ZodDefault<z.ZodNumber>;
+        /** 自然达成共识的检测字符串（任一 participant 输出含此则终止，可选）。 */
+        consensusSignal: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        chairmanSignal: string;
+        maxRounds: number;
+        consensusSignal?: string | undefined;
+    }, {
+        chairmanSignal?: string | undefined;
+        maxRounds?: number | undefined;
+        consensusSignal?: string | undefined;
+    }>>;
+}, "strip", z.ZodTypeAny, {
+    mode: "discussion";
+    topic: string;
+    participants: {
+        agent: string & z.BRAND<"AgentId">;
+        model: string;
+        nodeId: string;
+        sessionId?: (string & z.BRAND<"SessionId">) | undefined;
+        role?: string | undefined;
+        project?: (string & z.BRAND<"ProjectId">) | undefined;
+        worktreeId?: string | undefined;
+        agentConfig?: Record<string, unknown> | undefined;
+        input?: string | undefined;
+        branch?: string | undefined;
+        systemPrompt?: string | undefined;
+        dependsOn?: string[] | undefined;
+        metadata?: Record<string, unknown> | undefined;
+    }[];
+    chairman: string;
+    termination: {
+        chairmanSignal: string;
+        maxRounds: number;
+        consensusSignal?: string | undefined;
+    };
+}, {
+    mode: "discussion";
+    topic: string;
+    participants: {
+        agent: string;
+        model: string;
+        nodeId: string;
+        sessionId?: string | undefined;
+        role?: string | undefined;
+        project?: string | undefined;
+        worktreeId?: string | undefined;
+        agentConfig?: Record<string, unknown> | undefined;
+        input?: string | undefined;
+        branch?: string | undefined;
+        systemPrompt?: string | undefined;
+        dependsOn?: string[] | undefined;
+        metadata?: Record<string, unknown> | undefined;
+    }[];
+    chairman: string;
+    termination?: {
+        chairmanSignal?: string | undefined;
+        maxRounds?: number | undefined;
+        consensusSignal?: string | undefined;
+    } | undefined;
 }>]>;
 export type WorkflowPlan = z.infer<typeof WorkflowPlan>;
 export declare const WorkflowStatus: z.ZodEnum<["queued", "running", "completed", "failed", "cancelled", "timeout"]>;
 export type WorkflowStatus = z.infer<typeof WorkflowStatus>;
 export declare const WorkflowNodeStatus: z.ZodEnum<["pending", "ready", "running", "completed", "failed", "skipped", "cancelled"]>;
 export type WorkflowNodeStatus = z.infer<typeof WorkflowNodeStatus>;
+export declare const WorkflowPolicy: z.ZodObject<{
+    timeoutSeconds: z.ZodOptional<z.ZodOptional<z.ZodNumber>>;
+    perNodeTimeoutSeconds: z.ZodOptional<z.ZodOptional<z.ZodNumber>>;
+    onNodeFailure: z.ZodOptional<z.ZodDefault<z.ZodEnum<["fail_workflow", "skip_dependents", "continue"]>>>;
+    maxParallel: z.ZodOptional<z.ZodOptional<z.ZodNumber>>;
+}, "strip", z.ZodTypeAny, {
+    timeoutSeconds?: number | undefined;
+    perNodeTimeoutSeconds?: number | undefined;
+    onNodeFailure?: "continue" | "fail_workflow" | "skip_dependents" | undefined;
+    maxParallel?: number | undefined;
+}, {
+    timeoutSeconds?: number | undefined;
+    perNodeTimeoutSeconds?: number | undefined;
+    onNodeFailure?: "continue" | "fail_workflow" | "skip_dependents" | undefined;
+    maxParallel?: number | undefined;
+}>;
+export type WorkflowPolicy = z.infer<typeof WorkflowPolicy>;
+export declare const WorkflowSharedContext: z.ZodObject<{
+    /** 直接文本：phonon 原样追加到每个 node 的 systemPrompt。 */
+    text: z.ZodOptional<z.ZodString>;
+    /** workspace 相对路径列表（受 policy 沙箱）；phonon 读取后拼成 markdown 段追加到 systemPrompt。 */
+    files: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    /** 注入位置：prepend 在最前，append 在最后，默认 append。 */
+    placement: z.ZodDefault<z.ZodEnum<["prepend", "append"]>>;
+}, "strip", z.ZodTypeAny, {
+    placement: "prepend" | "append";
+    text?: string | undefined;
+    files?: string[] | undefined;
+}, {
+    text?: string | undefined;
+    files?: string[] | undefined;
+    placement?: "prepend" | "append" | undefined;
+}>;
+export type WorkflowSharedContext = z.infer<typeof WorkflowSharedContext>;
+export declare const WorkflowResumeFrom: z.ZodObject<{
+    /** 要恢复的 workflowId（必须先前 run 过，并有 checkpoint）。 */
+    workflowId: z.ZodString;
+    /**
+     * 起点策略：
+     * - "last_success_dependents" : 从最后成功节点的下游开始（DAG 默认）
+     * - "failed_node"              : 重跑失败的那个 node（其他成功 node 不重做）
+     * - "node:<nodeId>"            : 显式指定从某 node 开始
+     */
+    strategy: z.ZodDefault<z.ZodUnion<[z.ZodLiteral<"last_success_dependents">, z.ZodLiteral<"failed_node">, z.ZodString]>>;
+    /** 可选：重置某些 node 的状态（让它们重跑），覆盖默认策略。 */
+    rerunNodes: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+}, "strip", z.ZodTypeAny, {
+    strategy: string;
+    workflowId: string;
+    rerunNodes?: string[] | undefined;
+}, {
+    workflowId: string;
+    strategy?: string | undefined;
+    rerunNodes?: string[] | undefined;
+}>;
+export type WorkflowResumeFrom = z.infer<typeof WorkflowResumeFrom>;
 export declare const WorkflowRunParams: z.ZodObject<{
-    project: z.ZodBranded<z.ZodString, "ProjectId">;
+    /**
+     * 默认 project。可以省略，但如果某个 node 也没传 project，phonon 会拒接。
+     * v0.6 起改为可选，支持每个 node 跳不同 project 的跨项目编排场景。
+     */
+    project: z.ZodOptional<z.ZodBranded<z.ZodString, "ProjectId">>;
+    /** 默认隔离 key；node 未传 worktreeId 时继承该值。含义及复用规则同 WorkflowNode.worktreeId。 */
     worktreeId: z.ZodOptional<z.ZodString>;
+    /** 默认 branch；node 未传 branch 时继承。含义同 WorkflowNode.branch。 */
+    branch: z.ZodOptional<z.ZodString>;
     plan: z.ZodDiscriminatedUnion<"mode", [z.ZodObject<{
         mode: z.ZodLiteral<"dag">;
         nodes: z.ZodArray<z.ZodObject<{
             nodeId: z.ZodString;
             agent: z.ZodBranded<z.ZodString, "AgentId">;
             model: z.ZodString;
+            /** 该节点在 workflow 中扮演的角色（由调用方定义，phonon 仅回显）。 */
             role: z.ZodOptional<z.ZodString>;
             input: z.ZodOptional<z.ZodString>;
             systemPrompt: z.ZodOptional<z.ZodString>;
@@ -694,14 +1335,41 @@ export declare const WorkflowRunParams: z.ZodObject<{
             sessionId: z.ZodOptional<z.ZodBranded<z.ZodString, "SessionId">>;
             agentConfig: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
             metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+            /**
+             * 此节点跑在哪个 project。不传默认继承 workflow 级 project。
+             * project + workflow 级都没传，phonon 拒接。
+             */
+            project: z.ZodOptional<z.ZodBranded<z.ZodString, "ProjectId">>;
+            /**
+             * 隔离 key。调用方自定义的任意字符串。
+             * - 不传  → 该节点跑在 project 主目录
+             * - 传了 → phonon 按 (projectId, worktreeId) 复合键维护隔离 worktree：
+             *           • 同一 workflow 内首次看到 → 创建 worktree（branch 名 phonon 自动生成）
+             *           • 同一 workflow 内后续节点用同一 key → 复用同一 worktree
+             *           • 不跨 workflow 复用（下次 workflow.run 同名 key 是新 worktree）
+             * - workflow 终态时 phonon 尝试自动清理：git status 干净则 worktree remove；dirty 则保留
+             *   且发 workflow.status payload warn。创出的 branch 一律不删。
+             */
+            worktreeId: z.ZodOptional<z.ZodString>;
+            /**
+             * Git branch。意义联动 worktreeId：
+             * - 不传 worktreeId 传 branch → 在 project 主目录先 `git checkout <branch>` 再跑（对主目录有副作用，法定调用方负责）
+             * - 传 worktreeId 首次传 branch → 作为新 worktree 的 base branch（从它检出）
+             * - 传 worktreeId 未传 branch 首次 → 从 project 当前 branch 检出
+             * - worktreeId 复用时 branch 被忽略（worktree 已存在）
+             */
+            branch: z.ZodOptional<z.ZodString>;
         }, "strip", z.ZodTypeAny, {
             agent: string & z.BRAND<"AgentId">;
             model: string;
             nodeId: string;
             sessionId?: (string & z.BRAND<"SessionId">) | undefined;
             role?: string | undefined;
+            project?: (string & z.BRAND<"ProjectId">) | undefined;
+            worktreeId?: string | undefined;
             agentConfig?: Record<string, unknown> | undefined;
             input?: string | undefined;
+            branch?: string | undefined;
             systemPrompt?: string | undefined;
             dependsOn?: string[] | undefined;
             metadata?: Record<string, unknown> | undefined;
@@ -711,8 +1379,11 @@ export declare const WorkflowRunParams: z.ZodObject<{
             nodeId: string;
             sessionId?: string | undefined;
             role?: string | undefined;
+            project?: string | undefined;
+            worktreeId?: string | undefined;
             agentConfig?: Record<string, unknown> | undefined;
             input?: string | undefined;
+            branch?: string | undefined;
             systemPrompt?: string | undefined;
             dependsOn?: string[] | undefined;
             metadata?: Record<string, unknown> | undefined;
@@ -748,8 +1419,11 @@ export declare const WorkflowRunParams: z.ZodObject<{
             nodeId: string;
             sessionId?: (string & z.BRAND<"SessionId">) | undefined;
             role?: string | undefined;
+            project?: (string & z.BRAND<"ProjectId">) | undefined;
+            worktreeId?: string | undefined;
             agentConfig?: Record<string, unknown> | undefined;
             input?: string | undefined;
+            branch?: string | undefined;
             systemPrompt?: string | undefined;
             dependsOn?: string[] | undefined;
             metadata?: Record<string, unknown> | undefined;
@@ -771,8 +1445,11 @@ export declare const WorkflowRunParams: z.ZodObject<{
             nodeId: string;
             sessionId?: string | undefined;
             role?: string | undefined;
+            project?: string | undefined;
+            worktreeId?: string | undefined;
             agentConfig?: Record<string, unknown> | undefined;
             input?: string | undefined;
+            branch?: string | undefined;
             systemPrompt?: string | undefined;
             dependsOn?: string[] | undefined;
             metadata?: Record<string, unknown> | undefined;
@@ -792,28 +1469,51 @@ export declare const WorkflowRunParams: z.ZodObject<{
             nodeId: z.ZodString;
             agent: z.ZodBranded<z.ZodString, "AgentId">;
             model: z.ZodString;
-            role: z.ZodDefault<z.ZodLiteral<"executor">>;
+            input: z.ZodOptional<z.ZodString>;
             systemPrompt: z.ZodOptional<z.ZodString>;
+            dependsOn: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+            sessionId: z.ZodOptional<z.ZodBranded<z.ZodString, "SessionId">>;
             agentConfig: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+            metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+            project: z.ZodOptional<z.ZodBranded<z.ZodString, "ProjectId">>;
+            worktreeId: z.ZodOptional<z.ZodString>;
+            branch: z.ZodOptional<z.ZodString>;
+        } & {
+            role: z.ZodDefault<z.ZodLiteral<"executor">>;
         }, "strip", z.ZodTypeAny, {
             agent: string & z.BRAND<"AgentId">;
             role: "executor";
             model: string;
             nodeId: string;
+            sessionId?: (string & z.BRAND<"SessionId">) | undefined;
+            project?: (string & z.BRAND<"ProjectId">) | undefined;
+            worktreeId?: string | undefined;
             agentConfig?: Record<string, unknown> | undefined;
+            input?: string | undefined;
+            branch?: string | undefined;
             systemPrompt?: string | undefined;
+            dependsOn?: string[] | undefined;
+            metadata?: Record<string, unknown> | undefined;
         }, {
             agent: string;
             model: string;
             nodeId: string;
+            sessionId?: string | undefined;
             role?: "executor" | undefined;
+            project?: string | undefined;
+            worktreeId?: string | undefined;
             agentConfig?: Record<string, unknown> | undefined;
+            input?: string | undefined;
+            branch?: string | undefined;
             systemPrompt?: string | undefined;
+            dependsOn?: string[] | undefined;
+            metadata?: Record<string, unknown> | undefined;
         }>;
         workers: z.ZodArray<z.ZodObject<{
             nodeId: z.ZodString;
             agent: z.ZodBranded<z.ZodString, "AgentId">;
             model: z.ZodString;
+            /** 该节点在 workflow 中扮演的角色（由调用方定义，phonon 仅回显）。 */
             role: z.ZodOptional<z.ZodString>;
             input: z.ZodOptional<z.ZodString>;
             systemPrompt: z.ZodOptional<z.ZodString>;
@@ -821,14 +1521,41 @@ export declare const WorkflowRunParams: z.ZodObject<{
             sessionId: z.ZodOptional<z.ZodBranded<z.ZodString, "SessionId">>;
             agentConfig: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
             metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+            /**
+             * 此节点跑在哪个 project。不传默认继承 workflow 级 project。
+             * project + workflow 级都没传，phonon 拒接。
+             */
+            project: z.ZodOptional<z.ZodBranded<z.ZodString, "ProjectId">>;
+            /**
+             * 隔离 key。调用方自定义的任意字符串。
+             * - 不传  → 该节点跑在 project 主目录
+             * - 传了 → phonon 按 (projectId, worktreeId) 复合键维护隔离 worktree：
+             *           • 同一 workflow 内首次看到 → 创建 worktree（branch 名 phonon 自动生成）
+             *           • 同一 workflow 内后续节点用同一 key → 复用同一 worktree
+             *           • 不跨 workflow 复用（下次 workflow.run 同名 key 是新 worktree）
+             * - workflow 终态时 phonon 尝试自动清理：git status 干净则 worktree remove；dirty 则保留
+             *   且发 workflow.status payload warn。创出的 branch 一律不删。
+             */
+            worktreeId: z.ZodOptional<z.ZodString>;
+            /**
+             * Git branch。意义联动 worktreeId：
+             * - 不传 worktreeId 传 branch → 在 project 主目录先 `git checkout <branch>` 再跑（对主目录有副作用，法定调用方负责）
+             * - 传 worktreeId 首次传 branch → 作为新 worktree 的 base branch（从它检出）
+             * - 传 worktreeId 未传 branch 首次 → 从 project 当前 branch 检出
+             * - worktreeId 复用时 branch 被忽略（worktree 已存在）
+             */
+            branch: z.ZodOptional<z.ZodString>;
         }, "strip", z.ZodTypeAny, {
             agent: string & z.BRAND<"AgentId">;
             model: string;
             nodeId: string;
             sessionId?: (string & z.BRAND<"SessionId">) | undefined;
             role?: string | undefined;
+            project?: (string & z.BRAND<"ProjectId">) | undefined;
+            worktreeId?: string | undefined;
             agentConfig?: Record<string, unknown> | undefined;
             input?: string | undefined;
+            branch?: string | undefined;
             systemPrompt?: string | undefined;
             dependsOn?: string[] | undefined;
             metadata?: Record<string, unknown> | undefined;
@@ -838,8 +1565,11 @@ export declare const WorkflowRunParams: z.ZodObject<{
             nodeId: string;
             sessionId?: string | undefined;
             role?: string | undefined;
+            project?: string | undefined;
+            worktreeId?: string | undefined;
             agentConfig?: Record<string, unknown> | undefined;
             input?: string | undefined;
+            branch?: string | undefined;
             systemPrompt?: string | undefined;
             dependsOn?: string[] | undefined;
             metadata?: Record<string, unknown> | undefined;
@@ -893,23 +1623,33 @@ export declare const WorkflowRunParams: z.ZodObject<{
             maxIterations?: number | undefined;
         }>;
     }, "strip", z.ZodTypeAny, {
-        mode: "graph";
         executor: {
             agent: string & z.BRAND<"AgentId">;
             role: "executor";
             model: string;
             nodeId: string;
+            sessionId?: (string & z.BRAND<"SessionId">) | undefined;
+            project?: (string & z.BRAND<"ProjectId">) | undefined;
+            worktreeId?: string | undefined;
             agentConfig?: Record<string, unknown> | undefined;
+            input?: string | undefined;
+            branch?: string | undefined;
             systemPrompt?: string | undefined;
+            dependsOn?: string[] | undefined;
+            metadata?: Record<string, unknown> | undefined;
         };
+        mode: "graph";
         workers: {
             agent: string & z.BRAND<"AgentId">;
             model: string;
             nodeId: string;
             sessionId?: (string & z.BRAND<"SessionId">) | undefined;
             role?: string | undefined;
+            project?: (string & z.BRAND<"ProjectId">) | undefined;
+            worktreeId?: string | undefined;
             agentConfig?: Record<string, unknown> | undefined;
             input?: string | undefined;
+            branch?: string | undefined;
             systemPrompt?: string | undefined;
             dependsOn?: string[] | undefined;
             metadata?: Record<string, unknown> | undefined;
@@ -927,23 +1667,33 @@ export declare const WorkflowRunParams: z.ZodObject<{
             maxIterations: number;
         };
     }, {
-        mode: "graph";
         executor: {
             agent: string;
             model: string;
             nodeId: string;
+            sessionId?: string | undefined;
             role?: "executor" | undefined;
+            project?: string | undefined;
+            worktreeId?: string | undefined;
             agentConfig?: Record<string, unknown> | undefined;
+            input?: string | undefined;
+            branch?: string | undefined;
             systemPrompt?: string | undefined;
+            dependsOn?: string[] | undefined;
+            metadata?: Record<string, unknown> | undefined;
         };
+        mode: "graph";
         workers: {
             agent: string;
             model: string;
             nodeId: string;
             sessionId?: string | undefined;
             role?: string | undefined;
+            project?: string | undefined;
+            worktreeId?: string | undefined;
             agentConfig?: Record<string, unknown> | undefined;
             input?: string | undefined;
+            branch?: string | undefined;
             systemPrompt?: string | undefined;
             dependsOn?: string[] | undefined;
             metadata?: Record<string, unknown> | undefined;
@@ -960,12 +1710,202 @@ export declare const WorkflowRunParams: z.ZodObject<{
             allowSelfLoop?: boolean | undefined;
             maxIterations?: number | undefined;
         };
+    }>, z.ZodObject<{
+        mode: z.ZodLiteral<"discussion">;
+        /** 主题（initial input） — 所有 participant 第一轮收到这个。 */
+        topic: z.ZodString;
+        /** 参与者列表（无主从）。 */
+        participants: z.ZodArray<z.ZodObject<{
+            nodeId: z.ZodString;
+            agent: z.ZodBranded<z.ZodString, "AgentId">;
+            model: z.ZodString;
+            /** 该节点在 workflow 中扮演的角色（由调用方定义，phonon 仅回显）。 */
+            role: z.ZodOptional<z.ZodString>;
+            input: z.ZodOptional<z.ZodString>;
+            systemPrompt: z.ZodOptional<z.ZodString>;
+            dependsOn: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+            sessionId: z.ZodOptional<z.ZodBranded<z.ZodString, "SessionId">>;
+            agentConfig: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+            metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+            /**
+             * 此节点跑在哪个 project。不传默认继承 workflow 级 project。
+             * project + workflow 级都没传，phonon 拒接。
+             */
+            project: z.ZodOptional<z.ZodBranded<z.ZodString, "ProjectId">>;
+            /**
+             * 隔离 key。调用方自定义的任意字符串。
+             * - 不传  → 该节点跑在 project 主目录
+             * - 传了 → phonon 按 (projectId, worktreeId) 复合键维护隔离 worktree：
+             *           • 同一 workflow 内首次看到 → 创建 worktree（branch 名 phonon 自动生成）
+             *           • 同一 workflow 内后续节点用同一 key → 复用同一 worktree
+             *           • 不跨 workflow 复用（下次 workflow.run 同名 key 是新 worktree）
+             * - workflow 终态时 phonon 尝试自动清理：git status 干净则 worktree remove；dirty 则保留
+             *   且发 workflow.status payload warn。创出的 branch 一律不删。
+             */
+            worktreeId: z.ZodOptional<z.ZodString>;
+            /**
+             * Git branch。意义联动 worktreeId：
+             * - 不传 worktreeId 传 branch → 在 project 主目录先 `git checkout <branch>` 再跑（对主目录有副作用，法定调用方负责）
+             * - 传 worktreeId 首次传 branch → 作为新 worktree 的 base branch（从它检出）
+             * - 传 worktreeId 未传 branch 首次 → 从 project 当前 branch 检出
+             * - worktreeId 复用时 branch 被忽略（worktree 已存在）
+             */
+            branch: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            agent: string & z.BRAND<"AgentId">;
+            model: string;
+            nodeId: string;
+            sessionId?: (string & z.BRAND<"SessionId">) | undefined;
+            role?: string | undefined;
+            project?: (string & z.BRAND<"ProjectId">) | undefined;
+            worktreeId?: string | undefined;
+            agentConfig?: Record<string, unknown> | undefined;
+            input?: string | undefined;
+            branch?: string | undefined;
+            systemPrompt?: string | undefined;
+            dependsOn?: string[] | undefined;
+            metadata?: Record<string, unknown> | undefined;
+        }, {
+            agent: string;
+            model: string;
+            nodeId: string;
+            sessionId?: string | undefined;
+            role?: string | undefined;
+            project?: string | undefined;
+            worktreeId?: string | undefined;
+            agentConfig?: Record<string, unknown> | undefined;
+            input?: string | undefined;
+            branch?: string | undefined;
+            systemPrompt?: string | undefined;
+            dependsOn?: string[] | undefined;
+            metadata?: Record<string, unknown> | undefined;
+        }>, "many">;
+        /** Chairman 必须是 participants 之一的 nodeId，每轮所有 participant 发完它再 review + 决定续/停。 */
+        chairman: z.ZodString;
+        termination: z.ZodDefault<z.ZodObject<{
+            /** chairman 输出含该信号则终止。 */
+            chairmanSignal: z.ZodDefault<z.ZodString>;
+            /** 硬上限。 */
+            maxRounds: z.ZodDefault<z.ZodNumber>;
+            /** 自然达成共识的检测字符串（任一 participant 输出含此则终止，可选）。 */
+            consensusSignal: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            chairmanSignal: string;
+            maxRounds: number;
+            consensusSignal?: string | undefined;
+        }, {
+            chairmanSignal?: string | undefined;
+            maxRounds?: number | undefined;
+            consensusSignal?: string | undefined;
+        }>>;
+    }, "strip", z.ZodTypeAny, {
+        mode: "discussion";
+        topic: string;
+        participants: {
+            agent: string & z.BRAND<"AgentId">;
+            model: string;
+            nodeId: string;
+            sessionId?: (string & z.BRAND<"SessionId">) | undefined;
+            role?: string | undefined;
+            project?: (string & z.BRAND<"ProjectId">) | undefined;
+            worktreeId?: string | undefined;
+            agentConfig?: Record<string, unknown> | undefined;
+            input?: string | undefined;
+            branch?: string | undefined;
+            systemPrompt?: string | undefined;
+            dependsOn?: string[] | undefined;
+            metadata?: Record<string, unknown> | undefined;
+        }[];
+        chairman: string;
+        termination: {
+            chairmanSignal: string;
+            maxRounds: number;
+            consensusSignal?: string | undefined;
+        };
+    }, {
+        mode: "discussion";
+        topic: string;
+        participants: {
+            agent: string;
+            model: string;
+            nodeId: string;
+            sessionId?: string | undefined;
+            role?: string | undefined;
+            project?: string | undefined;
+            worktreeId?: string | undefined;
+            agentConfig?: Record<string, unknown> | undefined;
+            input?: string | undefined;
+            branch?: string | undefined;
+            systemPrompt?: string | undefined;
+            dependsOn?: string[] | undefined;
+            metadata?: Record<string, unknown> | undefined;
+        }[];
+        chairman: string;
+        termination?: {
+            chairmanSignal?: string | undefined;
+            maxRounds?: number | undefined;
+            consensusSignal?: string | undefined;
+        } | undefined;
     }>]>;
     input: z.ZodOptional<z.ZodString>;
+    policy: z.ZodOptional<z.ZodObject<{
+        timeoutSeconds: z.ZodOptional<z.ZodOptional<z.ZodNumber>>;
+        perNodeTimeoutSeconds: z.ZodOptional<z.ZodOptional<z.ZodNumber>>;
+        onNodeFailure: z.ZodOptional<z.ZodDefault<z.ZodEnum<["fail_workflow", "skip_dependents", "continue"]>>>;
+        maxParallel: z.ZodOptional<z.ZodOptional<z.ZodNumber>>;
+    }, "strip", z.ZodTypeAny, {
+        timeoutSeconds?: number | undefined;
+        perNodeTimeoutSeconds?: number | undefined;
+        onNodeFailure?: "continue" | "fail_workflow" | "skip_dependents" | undefined;
+        maxParallel?: number | undefined;
+    }, {
+        timeoutSeconds?: number | undefined;
+        perNodeTimeoutSeconds?: number | undefined;
+        onNodeFailure?: "continue" | "fail_workflow" | "skip_dependents" | undefined;
+        maxParallel?: number | undefined;
+    }>>;
+    /** 共享上下文（v0.5 新增）。 */
+    sharedContext: z.ZodOptional<z.ZodObject<{
+        /** 直接文本：phonon 原样追加到每个 node 的 systemPrompt。 */
+        text: z.ZodOptional<z.ZodString>;
+        /** workspace 相对路径列表（受 policy 沙箱）；phonon 读取后拼成 markdown 段追加到 systemPrompt。 */
+        files: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        /** 注入位置：prepend 在最前，append 在最后，默认 append。 */
+        placement: z.ZodDefault<z.ZodEnum<["prepend", "append"]>>;
+    }, "strip", z.ZodTypeAny, {
+        placement: "prepend" | "append";
+        text?: string | undefined;
+        files?: string[] | undefined;
+    }, {
+        text?: string | undefined;
+        files?: string[] | undefined;
+        placement?: "prepend" | "append" | undefined;
+    }>>;
+    /** 断点续跑（v0.5 新增）。传入则跳过 plan 重新规划，从 checkpoint 恢复。 */
+    resumeFrom: z.ZodOptional<z.ZodObject<{
+        /** 要恢复的 workflowId（必须先前 run 过，并有 checkpoint）。 */
+        workflowId: z.ZodString;
+        /**
+         * 起点策略：
+         * - "last_success_dependents" : 从最后成功节点的下游开始（DAG 默认）
+         * - "failed_node"              : 重跑失败的那个 node（其他成功 node 不重做）
+         * - "node:<nodeId>"            : 显式指定从某 node 开始
+         */
+        strategy: z.ZodDefault<z.ZodUnion<[z.ZodLiteral<"last_success_dependents">, z.ZodLiteral<"failed_node">, z.ZodString]>>;
+        /** 可选：重置某些 node 的状态（让它们重跑），覆盖默认策略。 */
+        rerunNodes: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    }, "strip", z.ZodTypeAny, {
+        strategy: string;
+        workflowId: string;
+        rerunNodes?: string[] | undefined;
+    }, {
+        workflowId: string;
+        strategy?: string | undefined;
+        rerunNodes?: string[] | undefined;
+    }>>;
     clientRequestId: z.ZodOptional<z.ZodString>;
     metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
 }, "strip", z.ZodTypeAny, {
-    project: string & z.BRAND<"ProjectId">;
     plan: {
         mode: "dag";
         nodes: {
@@ -974,8 +1914,11 @@ export declare const WorkflowRunParams: z.ZodObject<{
             nodeId: string;
             sessionId?: (string & z.BRAND<"SessionId">) | undefined;
             role?: string | undefined;
+            project?: (string & z.BRAND<"ProjectId">) | undefined;
+            worktreeId?: string | undefined;
             agentConfig?: Record<string, unknown> | undefined;
             input?: string | undefined;
+            branch?: string | undefined;
             systemPrompt?: string | undefined;
             dependsOn?: string[] | undefined;
             metadata?: Record<string, unknown> | undefined;
@@ -990,23 +1933,33 @@ export declare const WorkflowRunParams: z.ZodObject<{
         }[] | undefined;
         finalNodeId?: string | undefined;
     } | {
-        mode: "graph";
         executor: {
             agent: string & z.BRAND<"AgentId">;
             role: "executor";
             model: string;
             nodeId: string;
+            sessionId?: (string & z.BRAND<"SessionId">) | undefined;
+            project?: (string & z.BRAND<"ProjectId">) | undefined;
+            worktreeId?: string | undefined;
             agentConfig?: Record<string, unknown> | undefined;
+            input?: string | undefined;
+            branch?: string | undefined;
             systemPrompt?: string | undefined;
+            dependsOn?: string[] | undefined;
+            metadata?: Record<string, unknown> | undefined;
         };
+        mode: "graph";
         workers: {
             agent: string & z.BRAND<"AgentId">;
             model: string;
             nodeId: string;
             sessionId?: (string & z.BRAND<"SessionId">) | undefined;
             role?: string | undefined;
+            project?: (string & z.BRAND<"ProjectId">) | undefined;
+            worktreeId?: string | undefined;
             agentConfig?: Record<string, unknown> | undefined;
             input?: string | undefined;
+            branch?: string | undefined;
             systemPrompt?: string | undefined;
             dependsOn?: string[] | undefined;
             metadata?: Record<string, unknown> | undefined;
@@ -1023,13 +1976,54 @@ export declare const WorkflowRunParams: z.ZodObject<{
             allowSelfLoop: boolean;
             maxIterations: number;
         };
+    } | {
+        mode: "discussion";
+        topic: string;
+        participants: {
+            agent: string & z.BRAND<"AgentId">;
+            model: string;
+            nodeId: string;
+            sessionId?: (string & z.BRAND<"SessionId">) | undefined;
+            role?: string | undefined;
+            project?: (string & z.BRAND<"ProjectId">) | undefined;
+            worktreeId?: string | undefined;
+            agentConfig?: Record<string, unknown> | undefined;
+            input?: string | undefined;
+            branch?: string | undefined;
+            systemPrompt?: string | undefined;
+            dependsOn?: string[] | undefined;
+            metadata?: Record<string, unknown> | undefined;
+        }[];
+        chairman: string;
+        termination: {
+            chairmanSignal: string;
+            maxRounds: number;
+            consensusSignal?: string | undefined;
+        };
     };
     clientRequestId?: string | undefined;
+    project?: (string & z.BRAND<"ProjectId">) | undefined;
     worktreeId?: string | undefined;
     input?: string | undefined;
+    branch?: string | undefined;
+    resumeFrom?: {
+        strategy: string;
+        workflowId: string;
+        rerunNodes?: string[] | undefined;
+    } | undefined;
     metadata?: Record<string, unknown> | undefined;
+    policy?: {
+        timeoutSeconds?: number | undefined;
+        perNodeTimeoutSeconds?: number | undefined;
+        onNodeFailure?: "continue" | "fail_workflow" | "skip_dependents" | undefined;
+        maxParallel?: number | undefined;
+    } | undefined;
+    sharedContext?: {
+        placement: "prepend" | "append";
+        text?: string | undefined;
+        files?: string[] | undefined;
+    } | undefined;
 }, {
-    project: string;
     plan: {
         mode: "dag";
         nodes: {
@@ -1038,8 +2032,11 @@ export declare const WorkflowRunParams: z.ZodObject<{
             nodeId: string;
             sessionId?: string | undefined;
             role?: string | undefined;
+            project?: string | undefined;
+            worktreeId?: string | undefined;
             agentConfig?: Record<string, unknown> | undefined;
             input?: string | undefined;
+            branch?: string | undefined;
             systemPrompt?: string | undefined;
             dependsOn?: string[] | undefined;
             metadata?: Record<string, unknown> | undefined;
@@ -1054,23 +2051,33 @@ export declare const WorkflowRunParams: z.ZodObject<{
         }[] | undefined;
         finalNodeId?: string | undefined;
     } | {
-        mode: "graph";
         executor: {
             agent: string;
             model: string;
             nodeId: string;
+            sessionId?: string | undefined;
             role?: "executor" | undefined;
+            project?: string | undefined;
+            worktreeId?: string | undefined;
             agentConfig?: Record<string, unknown> | undefined;
+            input?: string | undefined;
+            branch?: string | undefined;
             systemPrompt?: string | undefined;
+            dependsOn?: string[] | undefined;
+            metadata?: Record<string, unknown> | undefined;
         };
+        mode: "graph";
         workers: {
             agent: string;
             model: string;
             nodeId: string;
             sessionId?: string | undefined;
             role?: string | undefined;
+            project?: string | undefined;
+            worktreeId?: string | undefined;
             agentConfig?: Record<string, unknown> | undefined;
             input?: string | undefined;
+            branch?: string | undefined;
             systemPrompt?: string | undefined;
             dependsOn?: string[] | undefined;
             metadata?: Record<string, unknown> | undefined;
@@ -1087,35 +2094,102 @@ export declare const WorkflowRunParams: z.ZodObject<{
             allowSelfLoop?: boolean | undefined;
             maxIterations?: number | undefined;
         };
+    } | {
+        mode: "discussion";
+        topic: string;
+        participants: {
+            agent: string;
+            model: string;
+            nodeId: string;
+            sessionId?: string | undefined;
+            role?: string | undefined;
+            project?: string | undefined;
+            worktreeId?: string | undefined;
+            agentConfig?: Record<string, unknown> | undefined;
+            input?: string | undefined;
+            branch?: string | undefined;
+            systemPrompt?: string | undefined;
+            dependsOn?: string[] | undefined;
+            metadata?: Record<string, unknown> | undefined;
+        }[];
+        chairman: string;
+        termination?: {
+            chairmanSignal?: string | undefined;
+            maxRounds?: number | undefined;
+            consensusSignal?: string | undefined;
+        } | undefined;
     };
     clientRequestId?: string | undefined;
+    project?: string | undefined;
     worktreeId?: string | undefined;
     input?: string | undefined;
+    branch?: string | undefined;
+    resumeFrom?: {
+        workflowId: string;
+        strategy?: string | undefined;
+        rerunNodes?: string[] | undefined;
+    } | undefined;
     metadata?: Record<string, unknown> | undefined;
+    policy?: {
+        timeoutSeconds?: number | undefined;
+        perNodeTimeoutSeconds?: number | undefined;
+        onNodeFailure?: "continue" | "fail_workflow" | "skip_dependents" | undefined;
+        maxParallel?: number | undefined;
+    } | undefined;
+    sharedContext?: {
+        text?: string | undefined;
+        files?: string[] | undefined;
+        placement?: "prepend" | "append" | undefined;
+    } | undefined;
 }>;
 export type WorkflowRunParams = z.infer<typeof WorkflowRunParams>;
 export declare const WorkflowRunResult: z.ZodObject<{
     workflowId: z.ZodString;
     status: z.ZodEnum<["queued", "running", "completed", "failed", "cancelled", "timeout"]>;
     createdAt: z.ZodString;
+    /** 是否走的 resume 路径。 */
+    resumed: z.ZodDefault<z.ZodBoolean>;
 }, "strip", z.ZodTypeAny, {
     status: "running" | "queued" | "completed" | "failed" | "timeout" | "cancelled";
     createdAt: string;
     workflowId: string;
+    resumed: boolean;
 }, {
     status: "running" | "queued" | "completed" | "failed" | "timeout" | "cancelled";
     createdAt: string;
     workflowId: string;
+    resumed?: boolean | undefined;
 }>;
 export type WorkflowRunResult = z.infer<typeof WorkflowRunResult>;
-export declare const WorkflowStatusParams: z.ZodObject<{
-    workflowId: z.ZodString;
+export declare const WorkflowNodeResult: z.ZodObject<{
+    text: z.ZodOptional<z.ZodString>;
+    status: z.ZodEnum<["completed", "interrupted", "aborted", "failed", "timeout"]>;
+    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;
+    }>>;
 }, "strip", z.ZodTypeAny, {
-    workflowId: string;
+    status: "aborted" | "interrupted" | "completed" | "failed" | "timeout";
+    text?: string | undefined;
+    usage?: {
+        inputTokens?: number | undefined;
+        outputTokens?: number | undefined;
+    } | undefined;
 }, {
-    workflowId: string;
+    status: "aborted" | "interrupted" | "completed" | "failed" | "timeout";
+    text?: string | undefined;
+    usage?: {
+        inputTokens?: number | undefined;
+        outputTokens?: number | undefined;
+    } | undefined;
 }>;
-export type WorkflowStatusParams = z.infer<typeof WorkflowStatusParams>;
+export type WorkflowNodeResult = z.infer<typeof WorkflowNodeResult>;
 export declare const WorkflowNodeRuntime: z.ZodObject<{
     nodeId: z.ZodString;
     status: z.ZodEnum<["pending", "ready", "running", "completed", "failed", "skipped", "cancelled"]>;
@@ -1127,6 +2201,36 @@ export declare const WorkflowNodeRuntime: z.ZodObject<{
     startedAt: z.ZodOptional<z.ZodString>;
     completedAt: z.ZodOptional<z.ZodString>;
     error: z.ZodOptional<z.ZodString>;
+    result: z.ZodOptional<z.ZodObject<{
+        text: z.ZodOptional<z.ZodString>;
+        status: z.ZodEnum<["completed", "interrupted", "aborted", "failed", "timeout"]>;
+        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;
+        }>>;
+    }, "strip", z.ZodTypeAny, {
+        status: "aborted" | "interrupted" | "completed" | "failed" | "timeout";
+        text?: string | undefined;
+        usage?: {
+            inputTokens?: number | undefined;
+            outputTokens?: number | undefined;
+        } | undefined;
+    }, {
+        status: "aborted" | "interrupted" | "completed" | "failed" | "timeout";
+        text?: string | undefined;
+        usage?: {
+            inputTokens?: number | undefined;
+            outputTokens?: number | undefined;
+        } | undefined;
+    }>>;
+    /** 该节点完成的轮次计数（discussion 用；DAG/Graph 一次执行 = 1）。 */
+    iterations: z.ZodOptional<z.ZodNumber>;
 }, "strip", z.ZodTypeAny, {
     status: "running" | "completed" | "failed" | "pending" | "cancelled" | "ready" | "skipped";
     agent: string & z.BRAND<"AgentId">;
@@ -1135,9 +2239,18 @@ export declare const WorkflowNodeRuntime: z.ZodObject<{
     sessionId?: (string & z.BRAND<"SessionId">) | undefined;
     role?: string | undefined;
     turnId?: string | undefined;
+    result?: {
+        status: "aborted" | "interrupted" | "completed" | "failed" | "timeout";
+        text?: string | undefined;
+        usage?: {
+            inputTokens?: number | undefined;
+            outputTokens?: number | undefined;
+        } | undefined;
+    } | undefined;
     error?: string | undefined;
     startedAt?: string | undefined;
     completedAt?: string | undefined;
+    iterations?: number | undefined;
 }, {
     status: "running" | "completed" | "failed" | "pending" | "cancelled" | "ready" | "skipped";
     agent: string;
@@ -1146,16 +2259,34 @@ export declare const WorkflowNodeRuntime: z.ZodObject<{
     sessionId?: string | undefined;
     role?: string | undefined;
     turnId?: string | undefined;
+    result?: {
+        status: "aborted" | "interrupted" | "completed" | "failed" | "timeout";
+        text?: string | undefined;
+        usage?: {
+            inputTokens?: number | undefined;
+            outputTokens?: number | undefined;
+        } | undefined;
+    } | undefined;
     error?: string | undefined;
     startedAt?: string | undefined;
     completedAt?: string | undefined;
+    iterations?: number | undefined;
 }>;
 export type WorkflowNodeRuntime = z.infer<typeof WorkflowNodeRuntime>;
+export declare const WorkflowStatusParams: z.ZodObject<{
+    workflowId: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    workflowId: string;
+}, {
+    workflowId: string;
+}>;
+export type WorkflowStatusParams = z.infer<typeof WorkflowStatusParams>;
 export declare const WorkflowStatusResult: z.ZodObject<{
     workflowId: z.ZodString;
     status: z.ZodEnum<["queued", "running", "completed", "failed", "cancelled", "timeout"]>;
-    project: z.ZodBranded<z.ZodString, "ProjectId">;
-    mode: z.ZodEnum<["dag", "graph"]>;
+    /** workflow 默认 project；v0.6 起可选。 */
+    project: z.ZodOptional<z.ZodBranded<z.ZodString, "ProjectId">>;
+    mode: z.ZodEnum<["dag", "graph", "discussion"]>;
     nodes: z.ZodArray<z.ZodObject<{
         nodeId: z.ZodString;
         status: z.ZodEnum<["pending", "ready", "running", "completed", "failed", "skipped", "cancelled"]>;
@@ -1167,6 +2298,36 @@ export declare const WorkflowStatusResult: z.ZodObject<{
         startedAt: z.ZodOptional<z.ZodString>;
         completedAt: z.ZodOptional<z.ZodString>;
         error: z.ZodOptional<z.ZodString>;
+        result: z.ZodOptional<z.ZodObject<{
+            text: z.ZodOptional<z.ZodString>;
+            status: z.ZodEnum<["completed", "interrupted", "aborted", "failed", "timeout"]>;
+            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;
+            }>>;
+        }, "strip", z.ZodTypeAny, {
+            status: "aborted" | "interrupted" | "completed" | "failed" | "timeout";
+            text?: string | undefined;
+            usage?: {
+                inputTokens?: number | undefined;
+                outputTokens?: number | undefined;
+            } | undefined;
+        }, {
+            status: "aborted" | "interrupted" | "completed" | "failed" | "timeout";
+            text?: string | undefined;
+            usage?: {
+                inputTokens?: number | undefined;
+                outputTokens?: number | undefined;
+            } | undefined;
+        }>>;
+        /** 该节点完成的轮次计数（discussion 用；DAG/Graph 一次执行 = 1）。 */
+        iterations: z.ZodOptional<z.ZodNumber>;
     }, "strip", z.ZodTypeAny, {
         status: "running" | "completed" | "failed" | "pending" | "cancelled" | "ready" | "skipped";
         agent: string & z.BRAND<"AgentId">;
@@ -1175,9 +2336,18 @@ export declare const WorkflowStatusResult: z.ZodObject<{
         sessionId?: (string & z.BRAND<"SessionId">) | undefined;
         role?: string | undefined;
         turnId?: string | undefined;
+        result?: {
+            status: "aborted" | "interrupted" | "completed" | "failed" | "timeout";
+            text?: string | undefined;
+            usage?: {
+                inputTokens?: number | undefined;
+                outputTokens?: number | undefined;
+            } | undefined;
+        } | undefined;
         error?: string | undefined;
         startedAt?: string | undefined;
         completedAt?: string | undefined;
+        iterations?: number | undefined;
     }, {
         status: "running" | "completed" | "failed" | "pending" | "cancelled" | "ready" | "skipped";
         agent: string;
@@ -1186,19 +2356,31 @@ export declare const WorkflowStatusResult: z.ZodObject<{
         sessionId?: string | undefined;
         role?: string | undefined;
         turnId?: string | undefined;
+        result?: {
+            status: "aborted" | "interrupted" | "completed" | "failed" | "timeout";
+            text?: string | undefined;
+            usage?: {
+                inputTokens?: number | undefined;
+                outputTokens?: number | undefined;
+            } | undefined;
+        } | undefined;
         error?: string | undefined;
         startedAt?: string | undefined;
         completedAt?: string | undefined;
+        iterations?: number | undefined;
     }>, "many">;
     createdAt: z.ZodString;
     updatedAt: z.ZodString;
     completedAt: z.ZodOptional<z.ZodString>;
     error: z.ZodOptional<z.ZodString>;
+    finalText: z.ZodOptional<z.ZodString>;
+    /** 是否可 resume：phonon 持有该 workflow 的 checkpoint。 */
+    resumable: z.ZodDefault<z.ZodBoolean>;
 }, "strip", z.ZodTypeAny, {
     status: "running" | "queued" | "completed" | "failed" | "timeout" | "cancelled";
-    project: string & z.BRAND<"ProjectId">;
     createdAt: string;
-    mode: "dag" | "graph";
+    mode: "dag" | "graph" | "discussion";
+    workflowId: string;
     updatedAt: string;
     nodes: {
         status: "running" | "completed" | "failed" | "pending" | "cancelled" | "ready" | "skipped";
@@ -1208,18 +2390,29 @@ export declare const WorkflowStatusResult: z.ZodObject<{
         sessionId?: (string & z.BRAND<"SessionId">) | undefined;
         role?: string | undefined;
         turnId?: string | undefined;
+        result?: {
+            status: "aborted" | "interrupted" | "completed" | "failed" | "timeout";
+            text?: string | undefined;
+            usage?: {
+                inputTokens?: number | undefined;
+                outputTokens?: number | undefined;
+            } | undefined;
+        } | undefined;
         error?: string | undefined;
         startedAt?: string | undefined;
         completedAt?: string | undefined;
+        iterations?: number | undefined;
     }[];
-    workflowId: string;
+    resumable: boolean;
+    project?: (string & z.BRAND<"ProjectId">) | undefined;
     error?: string | undefined;
     completedAt?: string | undefined;
+    finalText?: string | undefined;
 }, {
     status: "running" | "queued" | "completed" | "failed" | "timeout" | "cancelled";
-    project: string;
     createdAt: string;
-    mode: "dag" | "graph";
+    mode: "dag" | "graph" | "discussion";
+    workflowId: string;
     updatedAt: string;
     nodes: {
         status: "running" | "completed" | "failed" | "pending" | "cancelled" | "ready" | "skipped";
@@ -1229,13 +2422,24 @@ export declare const WorkflowStatusResult: z.ZodObject<{
         sessionId?: string | undefined;
         role?: string | undefined;
         turnId?: string | undefined;
+        result?: {
+            status: "aborted" | "interrupted" | "completed" | "failed" | "timeout";
+            text?: string | undefined;
+            usage?: {
+                inputTokens?: number | undefined;
+                outputTokens?: number | undefined;
+            } | undefined;
+        } | undefined;
         error?: string | undefined;
         startedAt?: string | undefined;
         completedAt?: string | undefined;
+        iterations?: number | undefined;
     }[];
-    workflowId: string;
+    project?: string | undefined;
     error?: string | undefined;
     completedAt?: string | undefined;
+    finalText?: string | undefined;
+    resumable?: boolean | undefined;
 }>;
 export type WorkflowStatusResult = z.infer<typeof WorkflowStatusResult>;
 export declare const WorkflowCancelParams: z.ZodObject<{
@@ -1262,24 +2466,34 @@ export declare const WorkflowCancelResult: z.ZodObject<{
 export type WorkflowCancelResult = z.infer<typeof WorkflowCancelResult>;
 export declare const WorkflowListParams: z.ZodObject<{
     status: z.ZodOptional<z.ZodEnum<["queued", "running", "completed", "failed", "cancelled", "timeout"]>>;
+    projectId: z.ZodOptional<z.ZodBranded<z.ZodString, "ProjectId">>;
+    since: z.ZodOptional<z.ZodString>;
+    until: z.ZodOptional<z.ZodString>;
     limit: z.ZodOptional<z.ZodDefault<z.ZodNumber>>;
     cursor: z.ZodOptional<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
     status?: "running" | "queued" | "completed" | "failed" | "timeout" | "cancelled" | undefined;
     limit?: number | undefined;
     cursor?: string | undefined;
+    projectId?: (string & z.BRAND<"ProjectId">) | undefined;
+    since?: string | undefined;
+    until?: string | undefined;
 }, {
     status?: "running" | "queued" | "completed" | "failed" | "timeout" | "cancelled" | undefined;
     limit?: number | undefined;
     cursor?: string | undefined;
+    projectId?: string | undefined;
+    since?: string | undefined;
+    until?: string | undefined;
 }>;
 export type WorkflowListParams = z.infer<typeof WorkflowListParams>;
 export declare const WorkflowListResult: z.ZodObject<{
     workflows: z.ZodArray<z.ZodObject<{
         workflowId: z.ZodString;
         status: z.ZodEnum<["queued", "running", "completed", "failed", "cancelled", "timeout"]>;
-        project: z.ZodBranded<z.ZodString, "ProjectId">;
-        mode: z.ZodEnum<["dag", "graph"]>;
+        /** workflow 默认 project；v0.6 起可选。 */
+        project: z.ZodOptional<z.ZodBranded<z.ZodString, "ProjectId">>;
+        mode: z.ZodEnum<["dag", "graph", "discussion"]>;
         nodes: z.ZodArray<z.ZodObject<{
             nodeId: z.ZodString;
             status: z.ZodEnum<["pending", "ready", "running", "completed", "failed", "skipped", "cancelled"]>;
@@ -1291,6 +2505,36 @@ export declare const WorkflowListResult: z.ZodObject<{
             startedAt: z.ZodOptional<z.ZodString>;
             completedAt: z.ZodOptional<z.ZodString>;
             error: z.ZodOptional<z.ZodString>;
+            result: z.ZodOptional<z.ZodObject<{
+                text: z.ZodOptional<z.ZodString>;
+                status: z.ZodEnum<["completed", "interrupted", "aborted", "failed", "timeout"]>;
+                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;
+                }>>;
+            }, "strip", z.ZodTypeAny, {
+                status: "aborted" | "interrupted" | "completed" | "failed" | "timeout";
+                text?: string | undefined;
+                usage?: {
+                    inputTokens?: number | undefined;
+                    outputTokens?: number | undefined;
+                } | undefined;
+            }, {
+                status: "aborted" | "interrupted" | "completed" | "failed" | "timeout";
+                text?: string | undefined;
+                usage?: {
+                    inputTokens?: number | undefined;
+                    outputTokens?: number | undefined;
+                } | undefined;
+            }>>;
+            /** 该节点完成的轮次计数（discussion 用；DAG/Graph 一次执行 = 1）。 */
+            iterations: z.ZodOptional<z.ZodNumber>;
         }, "strip", z.ZodTypeAny, {
             status: "running" | "completed" | "failed" | "pending" | "cancelled" | "ready" | "skipped";
             agent: string & z.BRAND<"AgentId">;
@@ -1299,9 +2543,18 @@ export declare const WorkflowListResult: z.ZodObject<{
             sessionId?: (string & z.BRAND<"SessionId">) | undefined;
             role?: string | undefined;
             turnId?: string | undefined;
+            result?: {
+                status: "aborted" | "interrupted" | "completed" | "failed" | "timeout";
+                text?: string | undefined;
+                usage?: {
+                    inputTokens?: number | undefined;
+                    outputTokens?: number | undefined;
+                } | undefined;
+            } | undefined;
             error?: string | undefined;
             startedAt?: string | undefined;
             completedAt?: string | undefined;
+            iterations?: number | undefined;
         }, {
             status: "running" | "completed" | "failed" | "pending" | "cancelled" | "ready" | "skipped";
             agent: string;
@@ -1310,19 +2563,31 @@ export declare const WorkflowListResult: z.ZodObject<{
             sessionId?: string | undefined;
             role?: string | undefined;
             turnId?: string | undefined;
+            result?: {
+                status: "aborted" | "interrupted" | "completed" | "failed" | "timeout";
+                text?: string | undefined;
+                usage?: {
+                    inputTokens?: number | undefined;
+                    outputTokens?: number | undefined;
+                } | undefined;
+            } | undefined;
             error?: string | undefined;
             startedAt?: string | undefined;
             completedAt?: string | undefined;
+            iterations?: number | undefined;
         }>, "many">;
         createdAt: z.ZodString;
         updatedAt: z.ZodString;
         completedAt: z.ZodOptional<z.ZodString>;
         error: z.ZodOptional<z.ZodString>;
+        finalText: z.ZodOptional<z.ZodString>;
+        /** 是否可 resume：phonon 持有该 workflow 的 checkpoint。 */
+        resumable: z.ZodDefault<z.ZodBoolean>;
     }, "strip", z.ZodTypeAny, {
         status: "running" | "queued" | "completed" | "failed" | "timeout" | "cancelled";
-        project: string & z.BRAND<"ProjectId">;
         createdAt: string;
-        mode: "dag" | "graph";
+        mode: "dag" | "graph" | "discussion";
+        workflowId: string;
         updatedAt: string;
         nodes: {
             status: "running" | "completed" | "failed" | "pending" | "cancelled" | "ready" | "skipped";
@@ -1332,18 +2597,29 @@ export declare const WorkflowListResult: z.ZodObject<{
             sessionId?: (string & z.BRAND<"SessionId">) | undefined;
             role?: string | undefined;
             turnId?: string | undefined;
+            result?: {
+                status: "aborted" | "interrupted" | "completed" | "failed" | "timeout";
+                text?: string | undefined;
+                usage?: {
+                    inputTokens?: number | undefined;
+                    outputTokens?: number | undefined;
+                } | undefined;
+            } | undefined;
             error?: string | undefined;
             startedAt?: string | undefined;
             completedAt?: string | undefined;
+            iterations?: number | undefined;
         }[];
-        workflowId: string;
+        resumable: boolean;
+        project?: (string & z.BRAND<"ProjectId">) | undefined;
         error?: string | undefined;
         completedAt?: string | undefined;
+        finalText?: string | undefined;
     }, {
         status: "running" | "queued" | "completed" | "failed" | "timeout" | "cancelled";
-        project: string;
         createdAt: string;
-        mode: "dag" | "graph";
+        mode: "dag" | "graph" | "discussion";
+        workflowId: string;
         updatedAt: string;
         nodes: {
             status: "running" | "completed" | "failed" | "pending" | "cancelled" | "ready" | "skipped";
@@ -1353,21 +2629,32 @@ export declare const WorkflowListResult: z.ZodObject<{
             sessionId?: string | undefined;
             role?: string | undefined;
             turnId?: string | undefined;
+            result?: {
+                status: "aborted" | "interrupted" | "completed" | "failed" | "timeout";
+                text?: string | undefined;
+                usage?: {
+                    inputTokens?: number | undefined;
+                    outputTokens?: number | undefined;
+                } | undefined;
+            } | undefined;
             error?: string | undefined;
             startedAt?: string | undefined;
             completedAt?: string | undefined;
+            iterations?: number | undefined;
         }[];
-        workflowId: string;
+        project?: string | undefined;
         error?: string | undefined;
         completedAt?: string | undefined;
+        finalText?: string | undefined;
+        resumable?: boolean | undefined;
     }>, "many">;
     nextCursor: z.ZodOptional<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
     workflows: {
         status: "running" | "queued" | "completed" | "failed" | "timeout" | "cancelled";
-        project: string & z.BRAND<"ProjectId">;
         createdAt: string;
-        mode: "dag" | "graph";
+        mode: "dag" | "graph" | "discussion";
+        workflowId: string;
         updatedAt: string;
         nodes: {
             status: "running" | "completed" | "failed" | "pending" | "cancelled" | "ready" | "skipped";
@@ -1377,21 +2664,32 @@ export declare const WorkflowListResult: z.ZodObject<{
             sessionId?: (string & z.BRAND<"SessionId">) | undefined;
             role?: string | undefined;
             turnId?: string | undefined;
+            result?: {
+                status: "aborted" | "interrupted" | "completed" | "failed" | "timeout";
+                text?: string | undefined;
+                usage?: {
+                    inputTokens?: number | undefined;
+                    outputTokens?: number | undefined;
+                } | undefined;
+            } | undefined;
             error?: string | undefined;
             startedAt?: string | undefined;
             completedAt?: string | undefined;
+            iterations?: number | undefined;
         }[];
-        workflowId: string;
+        resumable: boolean;
+        project?: (string & z.BRAND<"ProjectId">) | undefined;
         error?: string | undefined;
         completedAt?: string | undefined;
+        finalText?: string | undefined;
     }[];
     nextCursor?: string | undefined;
 }, {
     workflows: {
         status: "running" | "queued" | "completed" | "failed" | "timeout" | "cancelled";
-        project: string;
         createdAt: string;
-        mode: "dag" | "graph";
+        mode: "dag" | "graph" | "discussion";
+        workflowId: string;
         updatedAt: string;
         nodes: {
             status: "running" | "completed" | "failed" | "pending" | "cancelled" | "ready" | "skipped";
@@ -1401,13 +2699,24 @@ export declare const WorkflowListResult: z.ZodObject<{
             sessionId?: string | undefined;
             role?: string | undefined;
             turnId?: string | undefined;
+            result?: {
+                status: "aborted" | "interrupted" | "completed" | "failed" | "timeout";
+                text?: string | undefined;
+                usage?: {
+                    inputTokens?: number | undefined;
+                    outputTokens?: number | undefined;
+                } | undefined;
+            } | undefined;
             error?: string | undefined;
             startedAt?: string | undefined;
             completedAt?: string | undefined;
+            iterations?: number | undefined;
         }[];
-        workflowId: string;
+        project?: string | undefined;
         error?: string | undefined;
         completedAt?: string | undefined;
+        finalText?: string | undefined;
+        resumable?: boolean | undefined;
     }[];
     nextCursor?: string | undefined;
 }>;
@@ -1415,7 +2724,7 @@ export type WorkflowListResult = z.infer<typeof WorkflowListResult>;
 export declare const WorkflowEvent: z.ZodObject<{
     workflowId: z.ZodString;
     seq: z.ZodNumber;
-    type: z.ZodEnum<["workflow.status", "node.status", "node.stream", "edge.route", "executor.decision"]>;
+    type: z.ZodEnum<["workflow.status", "node.status", "edge.route", "executor.decision", "round.started", "round.completed", "discussion.terminated"]>;
     nodeId: z.ZodOptional<z.ZodString>;
     sessionId: z.ZodOptional<z.ZodBranded<z.ZodString, "SessionId">>;
     turnId: z.ZodOptional<z.ZodString>;
@@ -1423,10 +2732,39 @@ export declare const WorkflowEvent: z.ZodObject<{
     model: z.ZodOptional<z.ZodString>;
     role: z.ZodOptional<z.ZodString>;
     status: z.ZodOptional<z.ZodUnion<[z.ZodEnum<["queued", "running", "completed", "failed", "cancelled", "timeout"]>, z.ZodEnum<["pending", "ready", "running", "completed", "failed", "skipped", "cancelled"]>]>>;
+    result: z.ZodOptional<z.ZodObject<{
+        text: z.ZodOptional<z.ZodString>;
+        status: z.ZodEnum<["completed", "interrupted", "aborted", "failed", "timeout"]>;
+        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;
+        }>>;
+    }, "strip", z.ZodTypeAny, {
+        status: "aborted" | "interrupted" | "completed" | "failed" | "timeout";
+        text?: string | undefined;
+        usage?: {
+            inputTokens?: number | undefined;
+            outputTokens?: number | undefined;
+        } | undefined;
+    }, {
+        status: "aborted" | "interrupted" | "completed" | "failed" | "timeout";
+        text?: string | undefined;
+        usage?: {
+            inputTokens?: number | undefined;
+            outputTokens?: number | undefined;
+        } | undefined;
+    }>>;
+    /** 自由载荷。常见字段：iteration, from, to, reason, terminationReason 等。 */
     payload: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
     timestamp: z.ZodString;
 }, "strip", z.ZodTypeAny, {
-    type: "workflow.status" | "node.status" | "node.stream" | "edge.route" | "executor.decision";
+    type: "workflow.status" | "node.status" | "edge.route" | "executor.decision" | "round.started" | "round.completed" | "discussion.terminated";
     seq: number;
     workflowId: string;
     timestamp: string;
@@ -1436,10 +2774,18 @@ export declare const WorkflowEvent: z.ZodObject<{
     role?: string | undefined;
     model?: string | undefined;
     turnId?: string | undefined;
-    payload?: Record<string, unknown> | undefined;
+    result?: {
+        status: "aborted" | "interrupted" | "completed" | "failed" | "timeout";
+        text?: string | undefined;
+        usage?: {
+            inputTokens?: number | undefined;
+            outputTokens?: number | undefined;
+        } | undefined;
+    } | undefined;
     nodeId?: string | undefined;
+    payload?: Record<string, unknown> | undefined;
 }, {
-    type: "workflow.status" | "node.status" | "node.stream" | "edge.route" | "executor.decision";
+    type: "workflow.status" | "node.status" | "edge.route" | "executor.decision" | "round.started" | "round.completed" | "discussion.terminated";
     seq: number;
     workflowId: string;
     timestamp: string;
@@ -1449,8 +2795,171 @@ export declare const WorkflowEvent: z.ZodObject<{
     role?: string | undefined;
     model?: string | undefined;
     turnId?: string | undefined;
-    payload?: Record<string, unknown> | undefined;
+    result?: {
+        status: "aborted" | "interrupted" | "completed" | "failed" | "timeout";
+        text?: string | undefined;
+        usage?: {
+            inputTokens?: number | undefined;
+            outputTokens?: number | undefined;
+        } | undefined;
+    } | undefined;
     nodeId?: string | undefined;
+    payload?: Record<string, unknown> | undefined;
 }>;
 export type WorkflowEvent = z.infer<typeof WorkflowEvent>;
+export declare const WorkflowAckParams: z.ZodObject<{
+    workflowId: z.ZodString;
+    lastSeq: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    workflowId: string;
+    lastSeq: number;
+}, {
+    workflowId: string;
+    lastSeq: number;
+}>;
+export type WorkflowAckParams = z.infer<typeof WorkflowAckParams>;
+/** route：派新任务给目标 worker（v0.4 既有语义）。 */
+export declare const WorkflowRouteDirective: z.ZodObject<{
+    kind: z.ZodLiteral<"workflow.route">;
+    to: z.ZodUnion<[z.ZodString, z.ZodArray<z.ZodString, "many">]>;
+    message: z.ZodString;
+    reason: z.ZodOptional<z.ZodString>;
+    metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, "strip", z.ZodTypeAny, {
+    message: string;
+    kind: "workflow.route";
+    to: string | string[];
+    reason?: string | undefined;
+    metadata?: Record<string, unknown> | undefined;
+}, {
+    message: string;
+    kind: "workflow.route";
+    to: string | string[];
+    reason?: string | undefined;
+    metadata?: Record<string, unknown> | undefined;
+}>;
+export type WorkflowRouteDirective = z.infer<typeof WorkflowRouteDirective>;
+/** feedback：让目标 worker 基于上次输出返工修订（显式语义，区分于新任务）。 */
+export declare const WorkflowFeedbackDirective: z.ZodObject<{
+    kind: z.ZodLiteral<"workflow.feedback">;
+    to: z.ZodString;
+    message: z.ZodString;
+    reason: z.ZodOptional<z.ZodString>;
+    metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, "strip", z.ZodTypeAny, {
+    message: string;
+    kind: "workflow.feedback";
+    to: string;
+    reason?: string | undefined;
+    metadata?: Record<string, unknown> | undefined;
+}, {
+    message: string;
+    kind: "workflow.feedback";
+    to: string;
+    reason?: string | undefined;
+    metadata?: Record<string, unknown> | undefined;
+}>;
+export type WorkflowFeedbackDirective = z.infer<typeof WorkflowFeedbackDirective>;
+/** reply：模拟键盘输入（应答目标 agent 卡住的交互提示，如 [Y/n]）。 */
+export declare const WorkflowReplyDirective: z.ZodObject<{
+    kind: z.ZodLiteral<"workflow.reply">;
+    to: z.ZodString;
+    /** 应答内容（通常 1-2 字符："Y"/"n"/"y" 等）。 */
+    keystroke: z.ZodString;
+    reason: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    kind: "workflow.reply";
+    to: string;
+    keystroke: string;
+    reason?: string | undefined;
+}, {
+    kind: "workflow.reply";
+    to: string;
+    keystroke: string;
+    reason?: string | undefined;
+}>;
+export type WorkflowReplyDirective = z.infer<typeof WorkflowReplyDirective>;
+/** done：显式宣告 workflow 完成。 */
+export declare const WorkflowDoneDirective: z.ZodObject<{
+    kind: z.ZodLiteral<"workflow.done">;
+    /** 最终总结文本，作为 workflow.finalText。 */
+    finalSummary: z.ZodOptional<z.ZodString>;
+    reason: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    kind: "workflow.done";
+    reason?: string | undefined;
+    finalSummary?: string | undefined;
+}, {
+    kind: "workflow.done";
+    reason?: string | undefined;
+    finalSummary?: string | undefined;
+}>;
+export type WorkflowDoneDirective = z.infer<typeof WorkflowDoneDirective>;
+export declare const WorkflowRoutingDirective: z.ZodDiscriminatedUnion<"kind", [z.ZodObject<{
+    kind: z.ZodLiteral<"workflow.route">;
+    to: z.ZodUnion<[z.ZodString, z.ZodArray<z.ZodString, "many">]>;
+    message: z.ZodString;
+    reason: z.ZodOptional<z.ZodString>;
+    metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, "strip", z.ZodTypeAny, {
+    message: string;
+    kind: "workflow.route";
+    to: string | string[];
+    reason?: string | undefined;
+    metadata?: Record<string, unknown> | undefined;
+}, {
+    message: string;
+    kind: "workflow.route";
+    to: string | string[];
+    reason?: string | undefined;
+    metadata?: Record<string, unknown> | undefined;
+}>, z.ZodObject<{
+    kind: z.ZodLiteral<"workflow.feedback">;
+    to: z.ZodString;
+    message: z.ZodString;
+    reason: z.ZodOptional<z.ZodString>;
+    metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, "strip", z.ZodTypeAny, {
+    message: string;
+    kind: "workflow.feedback";
+    to: string;
+    reason?: string | undefined;
+    metadata?: Record<string, unknown> | undefined;
+}, {
+    message: string;
+    kind: "workflow.feedback";
+    to: string;
+    reason?: string | undefined;
+    metadata?: Record<string, unknown> | undefined;
+}>, z.ZodObject<{
+    kind: z.ZodLiteral<"workflow.reply">;
+    to: z.ZodString;
+    /** 应答内容（通常 1-2 字符："Y"/"n"/"y" 等）。 */
+    keystroke: z.ZodString;
+    reason: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    kind: "workflow.reply";
+    to: string;
+    keystroke: string;
+    reason?: string | undefined;
+}, {
+    kind: "workflow.reply";
+    to: string;
+    keystroke: string;
+    reason?: string | undefined;
+}>, z.ZodObject<{
+    kind: z.ZodLiteral<"workflow.done">;
+    /** 最终总结文本，作为 workflow.finalText。 */
+    finalSummary: z.ZodOptional<z.ZodString>;
+    reason: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    kind: "workflow.done";
+    reason?: string | undefined;
+    finalSummary?: string | undefined;
+}, {
+    kind: "workflow.done";
+    reason?: string | undefined;
+    finalSummary?: string | undefined;
+}>]>;
+export type WorkflowRoutingDirective = z.infer<typeof WorkflowRoutingDirective>;
 //# sourceMappingURL=workflow.d.ts.map