@agent-phonon/protocol 0.2.11 → 0.6.0

package/dist/schemas/workflow.d.ts

@@ -0,0 +1,2965 @@
+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>;
+    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;
+}>;
+export type WorkflowNode = z.infer<typeof WorkflowNode>;
+export declare const WorkflowEdge: z.ZodObject<{
+    edgeId: z.ZodOptional<z.ZodString>;
+    from: z.ZodString;
+    to: z.ZodString;
+    label: z.ZodOptional<z.ZodString>;
+    condition: z.ZodOptional<z.ZodString>;
+    metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, "strip", z.ZodTypeAny, {
+    from: string;
+    to: string;
+    label?: string | undefined;
+    metadata?: Record<string, unknown> | undefined;
+    edgeId?: string | undefined;
+    condition?: string | undefined;
+}, {
+    from: string;
+    to: string;
+    label?: string | undefined;
+    metadata?: Record<string, unknown> | undefined;
+    edgeId?: string | undefined;
+    condition?: string | undefined;
+}>;
+export type WorkflowEdge = z.infer<typeof WorkflowEdge>;
+export declare const WorkflowDagPlan: 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>;
+        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">;
+    edges: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        edgeId: z.ZodOptional<z.ZodString>;
+        from: z.ZodString;
+        to: z.ZodString;
+        label: z.ZodOptional<z.ZodString>;
+        condition: z.ZodOptional<z.ZodString>;
+        metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, "strip", z.ZodTypeAny, {
+        from: string;
+        to: string;
+        label?: string | undefined;
+        metadata?: Record<string, unknown> | undefined;
+        edgeId?: string | undefined;
+        condition?: string | undefined;
+    }, {
+        from: string;
+        to: string;
+        label?: string | undefined;
+        metadata?: Record<string, unknown> | undefined;
+        edgeId?: string | undefined;
+        condition?: string | undefined;
+    }>, "many">>;
+    finalNodeId: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    mode: "dag";
+    nodes: {
+        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;
+    }[];
+    edges?: {
+        from: string;
+        to: string;
+        label?: string | undefined;
+        metadata?: Record<string, unknown> | undefined;
+        edgeId?: string | undefined;
+        condition?: string | undefined;
+    }[] | undefined;
+    finalNodeId?: string | undefined;
+}, {
+    mode: "dag";
+    nodes: {
+        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;
+    }[];
+    edges?: {
+        from: string;
+        to: string;
+        label?: string | undefined;
+        metadata?: Record<string, unknown> | undefined;
+        edgeId?: string | undefined;
+        condition?: string | undefined;
+    }[] | undefined;
+    finalNodeId?: string | undefined;
+}>;
+export type WorkflowDagPlan = z.infer<typeof WorkflowDagPlan>;
+export declare const WorkflowCommunicationGraph: z.ZodObject<{
+    edges: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        edgeId: z.ZodOptional<z.ZodString>;
+        from: z.ZodString;
+        to: z.ZodString;
+        label: z.ZodOptional<z.ZodString>;
+        condition: z.ZodOptional<z.ZodString>;
+        metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, "strip", z.ZodTypeAny, {
+        from: string;
+        to: string;
+        label?: string | undefined;
+        metadata?: Record<string, unknown> | undefined;
+        edgeId?: string | undefined;
+        condition?: string | undefined;
+    }, {
+        from: string;
+        to: string;
+        label?: string | undefined;
+        metadata?: Record<string, unknown> | undefined;
+        edgeId?: string | undefined;
+        condition?: string | undefined;
+    }>, "many">>;
+    allowSelfLoop: z.ZodDefault<z.ZodBoolean>;
+    maxIterations: z.ZodDefault<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    edges: {
+        from: string;
+        to: string;
+        label?: string | undefined;
+        metadata?: Record<string, unknown> | undefined;
+        edgeId?: string | undefined;
+        condition?: string | undefined;
+    }[];
+    allowSelfLoop: boolean;
+    maxIterations: number;
+}, {
+    edges?: {
+        from: string;
+        to: string;
+        label?: string | undefined;
+        metadata?: Record<string, unknown> | undefined;
+        edgeId?: string | undefined;
+        condition?: string | undefined;
+    }[] | undefined;
+    allowSelfLoop?: boolean | undefined;
+    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;
+        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>;
+        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">;
+    communicationGraph: z.ZodObject<{
+        edges: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            edgeId: z.ZodOptional<z.ZodString>;
+            from: z.ZodString;
+            to: z.ZodString;
+            label: z.ZodOptional<z.ZodString>;
+            condition: z.ZodOptional<z.ZodString>;
+            metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        }, "strip", z.ZodTypeAny, {
+            from: string;
+            to: string;
+            label?: string | undefined;
+            metadata?: Record<string, unknown> | undefined;
+            edgeId?: string | undefined;
+            condition?: string | undefined;
+        }, {
+            from: string;
+            to: string;
+            label?: string | undefined;
+            metadata?: Record<string, unknown> | undefined;
+            edgeId?: string | undefined;
+            condition?: string | undefined;
+        }>, "many">>;
+        allowSelfLoop: z.ZodDefault<z.ZodBoolean>;
+        maxIterations: z.ZodDefault<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        edges: {
+            from: string;
+            to: string;
+            label?: string | undefined;
+            metadata?: Record<string, unknown> | undefined;
+            edgeId?: string | undefined;
+            condition?: string | undefined;
+        }[];
+        allowSelfLoop: boolean;
+        maxIterations: number;
+    }, {
+        edges?: {
+            from: string;
+            to: string;
+            label?: string | undefined;
+            metadata?: Record<string, unknown> | undefined;
+            edgeId?: string | undefined;
+            condition?: string | undefined;
+        }[] | undefined;
+        allowSelfLoop?: boolean | undefined;
+        maxIterations?: number | undefined;
+    }>;
+}, "strip", z.ZodTypeAny, {
+    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;
+    }[];
+    communicationGraph: {
+        edges: {
+            from: string;
+            to: string;
+            label?: string | undefined;
+            metadata?: Record<string, unknown> | undefined;
+            edgeId?: string | undefined;
+            condition?: string | undefined;
+        }[];
+        allowSelfLoop: boolean;
+        maxIterations: number;
+    };
+}, {
+    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;
+    }[];
+    communicationGraph: {
+        edges?: {
+            from: string;
+            to: string;
+            label?: string | undefined;
+            metadata?: Record<string, unknown> | undefined;
+            edgeId?: string | undefined;
+            condition?: string | undefined;
+        }[] | undefined;
+        allowSelfLoop?: boolean | undefined;
+        maxIterations?: number | undefined;
+    };
+}>;
+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>;
+        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">;
+    edges: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        edgeId: z.ZodOptional<z.ZodString>;
+        from: z.ZodString;
+        to: z.ZodString;
+        label: z.ZodOptional<z.ZodString>;
+        condition: z.ZodOptional<z.ZodString>;
+        metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, "strip", z.ZodTypeAny, {
+        from: string;
+        to: string;
+        label?: string | undefined;
+        metadata?: Record<string, unknown> | undefined;
+        edgeId?: string | undefined;
+        condition?: string | undefined;
+    }, {
+        from: string;
+        to: string;
+        label?: string | undefined;
+        metadata?: Record<string, unknown> | undefined;
+        edgeId?: string | undefined;
+        condition?: string | undefined;
+    }>, "many">>;
+    finalNodeId: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    mode: "dag";
+    nodes: {
+        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;
+    }[];
+    edges?: {
+        from: string;
+        to: string;
+        label?: string | undefined;
+        metadata?: Record<string, unknown> | undefined;
+        edgeId?: string | undefined;
+        condition?: string | undefined;
+    }[] | undefined;
+    finalNodeId?: string | undefined;
+}, {
+    mode: "dag";
+    nodes: {
+        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;
+    }[];
+    edges?: {
+        from: string;
+        to: string;
+        label?: string | undefined;
+        metadata?: Record<string, unknown> | undefined;
+        edgeId?: string | undefined;
+        condition?: string | undefined;
+    }[] | undefined;
+    finalNodeId?: string | undefined;
+}>, z.ZodObject<{
+    mode: z.ZodLiteral<"graph">;
+    executor: 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;
+    }>;
+    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>;
+        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">;
+    communicationGraph: z.ZodObject<{
+        edges: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            edgeId: z.ZodOptional<z.ZodString>;
+            from: z.ZodString;
+            to: z.ZodString;
+            label: z.ZodOptional<z.ZodString>;
+            condition: z.ZodOptional<z.ZodString>;
+            metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        }, "strip", z.ZodTypeAny, {
+            from: string;
+            to: string;
+            label?: string | undefined;
+            metadata?: Record<string, unknown> | undefined;
+            edgeId?: string | undefined;
+            condition?: string | undefined;
+        }, {
+            from: string;
+            to: string;
+            label?: string | undefined;
+            metadata?: Record<string, unknown> | undefined;
+            edgeId?: string | undefined;
+            condition?: string | undefined;
+        }>, "many">>;
+        allowSelfLoop: z.ZodDefault<z.ZodBoolean>;
+        maxIterations: z.ZodDefault<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        edges: {
+            from: string;
+            to: string;
+            label?: string | undefined;
+            metadata?: Record<string, unknown> | undefined;
+            edgeId?: string | undefined;
+            condition?: string | undefined;
+        }[];
+        allowSelfLoop: boolean;
+        maxIterations: number;
+    }, {
+        edges?: {
+            from: string;
+            to: string;
+            label?: string | undefined;
+            metadata?: Record<string, unknown> | undefined;
+            edgeId?: string | undefined;
+            condition?: string | undefined;
+        }[] | undefined;
+        allowSelfLoop?: boolean | undefined;
+        maxIterations?: number | undefined;
+    }>;
+}, "strip", z.ZodTypeAny, {
+    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;
+    }[];
+    communicationGraph: {
+        edges: {
+            from: string;
+            to: string;
+            label?: string | undefined;
+            metadata?: Record<string, unknown> | undefined;
+            edgeId?: string | undefined;
+            condition?: string | undefined;
+        }[];
+        allowSelfLoop: boolean;
+        maxIterations: number;
+    };
+}, {
+    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;
+    }[];
+    communicationGraph: {
+        edges?: {
+            from: string;
+            to: string;
+            label?: string | undefined;
+            metadata?: Record<string, unknown> | undefined;
+            edgeId?: string | undefined;
+            condition?: string | undefined;
+        }[] | undefined;
+        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。可以省略，但如果某个 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>;
+            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">;
+        edges: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            edgeId: z.ZodOptional<z.ZodString>;
+            from: z.ZodString;
+            to: z.ZodString;
+            label: z.ZodOptional<z.ZodString>;
+            condition: z.ZodOptional<z.ZodString>;
+            metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        }, "strip", z.ZodTypeAny, {
+            from: string;
+            to: string;
+            label?: string | undefined;
+            metadata?: Record<string, unknown> | undefined;
+            edgeId?: string | undefined;
+            condition?: string | undefined;
+        }, {
+            from: string;
+            to: string;
+            label?: string | undefined;
+            metadata?: Record<string, unknown> | undefined;
+            edgeId?: string | undefined;
+            condition?: string | undefined;
+        }>, "many">>;
+        finalNodeId: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        mode: "dag";
+        nodes: {
+            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;
+        }[];
+        edges?: {
+            from: string;
+            to: string;
+            label?: string | undefined;
+            metadata?: Record<string, unknown> | undefined;
+            edgeId?: string | undefined;
+            condition?: string | undefined;
+        }[] | undefined;
+        finalNodeId?: string | undefined;
+    }, {
+        mode: "dag";
+        nodes: {
+            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;
+        }[];
+        edges?: {
+            from: string;
+            to: string;
+            label?: string | undefined;
+            metadata?: Record<string, unknown> | undefined;
+            edgeId?: string | undefined;
+            condition?: string | undefined;
+        }[] | undefined;
+        finalNodeId?: string | undefined;
+    }>, z.ZodObject<{
+        mode: z.ZodLiteral<"graph">;
+        executor: 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;
+        }>;
+        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>;
+            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">;
+        communicationGraph: z.ZodObject<{
+            edges: z.ZodDefault<z.ZodArray<z.ZodObject<{
+                edgeId: z.ZodOptional<z.ZodString>;
+                from: z.ZodString;
+                to: z.ZodString;
+                label: z.ZodOptional<z.ZodString>;
+                condition: z.ZodOptional<z.ZodString>;
+                metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+            }, "strip", z.ZodTypeAny, {
+                from: string;
+                to: string;
+                label?: string | undefined;
+                metadata?: Record<string, unknown> | undefined;
+                edgeId?: string | undefined;
+                condition?: string | undefined;
+            }, {
+                from: string;
+                to: string;
+                label?: string | undefined;
+                metadata?: Record<string, unknown> | undefined;
+                edgeId?: string | undefined;
+                condition?: string | undefined;
+            }>, "many">>;
+            allowSelfLoop: z.ZodDefault<z.ZodBoolean>;
+            maxIterations: z.ZodDefault<z.ZodNumber>;
+        }, "strip", z.ZodTypeAny, {
+            edges: {
+                from: string;
+                to: string;
+                label?: string | undefined;
+                metadata?: Record<string, unknown> | undefined;
+                edgeId?: string | undefined;
+                condition?: string | undefined;
+            }[];
+            allowSelfLoop: boolean;
+            maxIterations: number;
+        }, {
+            edges?: {
+                from: string;
+                to: string;
+                label?: string | undefined;
+                metadata?: Record<string, unknown> | undefined;
+                edgeId?: string | undefined;
+                condition?: string | undefined;
+            }[] | undefined;
+            allowSelfLoop?: boolean | undefined;
+            maxIterations?: number | undefined;
+        }>;
+    }, "strip", z.ZodTypeAny, {
+        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;
+        }[];
+        communicationGraph: {
+            edges: {
+                from: string;
+                to: string;
+                label?: string | undefined;
+                metadata?: Record<string, unknown> | undefined;
+                edgeId?: string | undefined;
+                condition?: string | undefined;
+            }[];
+            allowSelfLoop: boolean;
+            maxIterations: number;
+        };
+    }, {
+        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;
+        }[];
+        communicationGraph: {
+            edges?: {
+                from: string;
+                to: string;
+                label?: string | undefined;
+                metadata?: Record<string, unknown> | undefined;
+                edgeId?: string | undefined;
+                condition?: string | undefined;
+            }[] | undefined;
+            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, {
+    plan: {
+        mode: "dag";
+        nodes: {
+            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;
+        }[];
+        edges?: {
+            from: string;
+            to: string;
+            label?: string | undefined;
+            metadata?: Record<string, unknown> | undefined;
+            edgeId?: string | undefined;
+            condition?: string | undefined;
+        }[] | undefined;
+        finalNodeId?: string | undefined;
+    } | {
+        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;
+        }[];
+        communicationGraph: {
+            edges: {
+                from: string;
+                to: string;
+                label?: string | undefined;
+                metadata?: Record<string, unknown> | undefined;
+                edgeId?: string | undefined;
+                condition?: string | undefined;
+            }[];
+            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;
+}, {
+    plan: {
+        mode: "dag";
+        nodes: {
+            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;
+        }[];
+        edges?: {
+            from: string;
+            to: string;
+            label?: string | undefined;
+            metadata?: Record<string, unknown> | undefined;
+            edgeId?: string | undefined;
+            condition?: string | undefined;
+        }[] | undefined;
+        finalNodeId?: string | undefined;
+    } | {
+        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;
+        }[];
+        communicationGraph: {
+            edges?: {
+                from: string;
+                to: string;
+                label?: string | undefined;
+                metadata?: Record<string, unknown> | undefined;
+                edgeId?: string | undefined;
+                condition?: string | undefined;
+            }[] | undefined;
+            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 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, {
+    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;
+}>;
+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"]>;
+    agent: z.ZodBranded<z.ZodString, "AgentId">;
+    model: z.ZodString;
+    role: z.ZodOptional<z.ZodString>;
+    sessionId: z.ZodOptional<z.ZodBranded<z.ZodString, "SessionId">>;
+    turnId: z.ZodOptional<z.ZodString>;
+    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">;
+    model: string;
+    nodeId: string;
+    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;
+    model: string;
+    nodeId: string;
+    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"]>;
+    /** 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"]>;
+        agent: z.ZodBranded<z.ZodString, "AgentId">;
+        model: z.ZodString;
+        role: z.ZodOptional<z.ZodString>;
+        sessionId: z.ZodOptional<z.ZodBranded<z.ZodString, "SessionId">>;
+        turnId: z.ZodOptional<z.ZodString>;
+        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">;
+        model: string;
+        nodeId: string;
+        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;
+        model: string;
+        nodeId: string;
+        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";
+    createdAt: string;
+    mode: "dag" | "graph" | "discussion";
+    workflowId: string;
+    updatedAt: string;
+    nodes: {
+        status: "running" | "completed" | "failed" | "pending" | "cancelled" | "ready" | "skipped";
+        agent: string & z.BRAND<"AgentId">;
+        model: string;
+        nodeId: string;
+        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;
+    }[];
+    resumable: boolean;
+    project?: (string & z.BRAND<"ProjectId">) | undefined;
+    error?: string | undefined;
+    completedAt?: string | undefined;
+    finalText?: string | undefined;
+}, {
+    status: "running" | "queued" | "completed" | "failed" | "timeout" | "cancelled";
+    createdAt: string;
+    mode: "dag" | "graph" | "discussion";
+    workflowId: string;
+    updatedAt: string;
+    nodes: {
+        status: "running" | "completed" | "failed" | "pending" | "cancelled" | "ready" | "skipped";
+        agent: string;
+        model: string;
+        nodeId: string;
+        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;
+    }[];
+    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<{
+    workflowId: z.ZodString;
+    reason: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    workflowId: string;
+    reason?: string | undefined;
+}, {
+    workflowId: string;
+    reason?: string | undefined;
+}>;
+export type WorkflowCancelParams = z.infer<typeof WorkflowCancelParams>;
+export declare const WorkflowCancelResult: z.ZodObject<{
+    workflowId: z.ZodString;
+    status: z.ZodLiteral<"cancelled">;
+}, "strip", z.ZodTypeAny, {
+    status: "cancelled";
+    workflowId: string;
+}, {
+    status: "cancelled";
+    workflowId: string;
+}>;
+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"]>;
+        /** 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"]>;
+            agent: z.ZodBranded<z.ZodString, "AgentId">;
+            model: z.ZodString;
+            role: z.ZodOptional<z.ZodString>;
+            sessionId: z.ZodOptional<z.ZodBranded<z.ZodString, "SessionId">>;
+            turnId: z.ZodOptional<z.ZodString>;
+            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">;
+            model: string;
+            nodeId: string;
+            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;
+            model: string;
+            nodeId: string;
+            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";
+        createdAt: string;
+        mode: "dag" | "graph" | "discussion";
+        workflowId: string;
+        updatedAt: string;
+        nodes: {
+            status: "running" | "completed" | "failed" | "pending" | "cancelled" | "ready" | "skipped";
+            agent: string & z.BRAND<"AgentId">;
+            model: string;
+            nodeId: string;
+            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;
+        }[];
+        resumable: boolean;
+        project?: (string & z.BRAND<"ProjectId">) | undefined;
+        error?: string | undefined;
+        completedAt?: string | undefined;
+        finalText?: string | undefined;
+    }, {
+        status: "running" | "queued" | "completed" | "failed" | "timeout" | "cancelled";
+        createdAt: string;
+        mode: "dag" | "graph" | "discussion";
+        workflowId: string;
+        updatedAt: string;
+        nodes: {
+            status: "running" | "completed" | "failed" | "pending" | "cancelled" | "ready" | "skipped";
+            agent: string;
+            model: string;
+            nodeId: string;
+            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;
+        }[];
+        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";
+        createdAt: string;
+        mode: "dag" | "graph" | "discussion";
+        workflowId: string;
+        updatedAt: string;
+        nodes: {
+            status: "running" | "completed" | "failed" | "pending" | "cancelled" | "ready" | "skipped";
+            agent: string & z.BRAND<"AgentId">;
+            model: string;
+            nodeId: string;
+            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;
+        }[];
+        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";
+        createdAt: string;
+        mode: "dag" | "graph" | "discussion";
+        workflowId: string;
+        updatedAt: string;
+        nodes: {
+            status: "running" | "completed" | "failed" | "pending" | "cancelled" | "ready" | "skipped";
+            agent: string;
+            model: string;
+            nodeId: string;
+            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;
+        }[];
+        project?: string | undefined;
+        error?: string | undefined;
+        completedAt?: string | undefined;
+        finalText?: string | undefined;
+        resumable?: boolean | undefined;
+    }[];
+    nextCursor?: string | undefined;
+}>;
+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", "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>;
+    agent: z.ZodOptional<z.ZodBranded<z.ZodString, "AgentId">>;
+    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" | "edge.route" | "executor.decision" | "round.started" | "round.completed" | "discussion.terminated";
+    seq: number;
+    workflowId: string;
+    timestamp: string;
+    status?: "running" | "queued" | "completed" | "failed" | "timeout" | "pending" | "cancelled" | "ready" | "skipped" | undefined;
+    sessionId?: (string & z.BRAND<"SessionId">) | undefined;
+    agent?: (string & z.BRAND<"AgentId">) | undefined;
+    role?: string | undefined;
+    model?: string | undefined;
+    turnId?: string | 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" | "edge.route" | "executor.decision" | "round.started" | "round.completed" | "discussion.terminated";
+    seq: number;
+    workflowId: string;
+    timestamp: string;
+    status?: "running" | "queued" | "completed" | "failed" | "timeout" | "pending" | "cancelled" | "ready" | "skipped" | undefined;
+    sessionId?: string | undefined;
+    agent?: string | undefined;
+    role?: string | undefined;
+    model?: string | undefined;
+    turnId?: string | 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