npm - @agent-phonon/protocol - Versions diffs - 0.6.1 → 0.8.1 - Mend

@agent-phonon/protocol 0.6.1 → 0.8.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (16) hide show

package/dist/schemas/methods.d.ts +1071 -3
package/dist/schemas/methods.d.ts.map +1 -1
package/dist/schemas/methods.js +55 -2
package/dist/schemas/methods.js.map +1 -1
package/dist/schemas/project.d.ts +447 -0
package/dist/schemas/project.d.ts.map +1 -1
package/dist/schemas/project.js +165 -0
package/dist/schemas/project.js.map +1 -1
package/dist/schemas/workflow.d.ts +927 -3
package/dist/schemas/workflow.d.ts.map +1 -1
package/dist/schemas/workflow.js +93 -0
package/dist/schemas/workflow.js.map +1 -1
package/package.json +1 -1
package/src/schemas/methods.ts +67 -0
package/src/schemas/project.ts +198 -0
package/src/schemas/workflow.ts +111 -0

package/dist/schemas/workflow.d.ts CHANGED Viewed

@@ -1311,6 +1311,55 @@ export declare const WorkflowResumeFrom: z.ZodObject<{
     rerunNodes?: string[] | undefined;
 }>;
 export type WorkflowResumeFrom = z.infer<typeof WorkflowResumeFrom>;
+/**
+ * workflow.resume：独立 method（v0.7），取代之前用 workflow.run.resumeFrom 偷渡的方式。
+ * resumeFrom 字段保留向后兼容，但 SDK 优先使用 workflow.resume。
+ */
+export declare const WorkflowResumeParams: z.ZodObject<{
+    workflowId: z.ZodString;
+    strategy: z.ZodDefault<z.ZodUnion<[z.ZodLiteral<"last_success_dependents">, z.ZodLiteral<"failed_node">, z.ZodString]>>;
+    rerunNodes: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    /** 可选：附加给 executor 的反馈文本（HITL 后特别有用） */
+    feedback: z.ZodOptional<z.ZodString>;
+    /** 可选：恢复时调整 sharedContext */
+    sharedContextPatch: 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;
+    }>>;
+}, "strip", z.ZodTypeAny, {
+    strategy: string;
+    workflowId: string;
+    rerunNodes?: string[] | undefined;
+    feedback?: string | undefined;
+    sharedContextPatch?: {
+        placement: "prepend" | "append";
+        text?: string | undefined;
+        files?: string[] | undefined;
+    } | undefined;
+}, {
+    workflowId: string;
+    strategy?: string | undefined;
+    rerunNodes?: string[] | undefined;
+    feedback?: string | undefined;
+    sharedContextPatch?: {
+        text?: string | undefined;
+        files?: string[] | undefined;
+        placement?: "prepend" | "append" | undefined;
+    } | undefined;
+}>;
+export type WorkflowResumeParams = z.infer<typeof WorkflowResumeParams>;
 export declare const WorkflowRunParams: z.ZodObject<{
     /**
      * 默认 project。可以省略，但如果某个 node 也没传 project，phonon 会拒接。
@@ -2167,12 +2216,42 @@ export declare const WorkflowNodeResult: z.ZodObject<{
     usage: z.ZodOptional<z.ZodObject<{
         inputTokens: z.ZodOptional<z.ZodNumber>;
         outputTokens: z.ZodOptional<z.ZodNumber>;
+        cachedTokens: z.ZodOptional<z.ZodNumber>;
+        reasoningTokens: z.ZodOptional<z.ZodNumber>;
+        toolCalls: z.ZodOptional<z.ZodNumber>;
+        durationMs: z.ZodOptional<z.ZodNumber>;
+        costEstimate: z.ZodOptional<z.ZodObject<{
+            amount: z.ZodNumber;
+            currency: z.ZodEnum<["USD", "CNY"]>;
+        }, "strip", z.ZodTypeAny, {
+            amount: number;
+            currency: "USD" | "CNY";
+        }, {
+            amount: number;
+            currency: "USD" | "CNY";
+        }>>;
     }, "strip", z.ZodTypeAny, {
         inputTokens?: number | undefined;
         outputTokens?: number | undefined;
+        durationMs?: number | undefined;
+        cachedTokens?: number | undefined;
+        reasoningTokens?: number | undefined;
+        toolCalls?: number | undefined;
+        costEstimate?: {
+            amount: number;
+            currency: "USD" | "CNY";
+        } | undefined;
     }, {
         inputTokens?: number | undefined;
         outputTokens?: number | undefined;
+        durationMs?: number | undefined;
+        cachedTokens?: number | undefined;
+        reasoningTokens?: number | undefined;
+        toolCalls?: number | undefined;
+        costEstimate?: {
+            amount: number;
+            currency: "USD" | "CNY";
+        } | undefined;
     }>>;
 }, "strip", z.ZodTypeAny, {
     status: "aborted" | "interrupted" | "completed" | "failed" | "timeout";
@@ -2180,6 +2259,14 @@ export declare const WorkflowNodeResult: z.ZodObject<{
     usage?: {
         inputTokens?: number | undefined;
         outputTokens?: number | undefined;
+        durationMs?: number | undefined;
+        cachedTokens?: number | undefined;
+        reasoningTokens?: number | undefined;
+        toolCalls?: number | undefined;
+        costEstimate?: {
+            amount: number;
+            currency: "USD" | "CNY";
+        } | undefined;
     } | undefined;
 }, {
     status: "aborted" | "interrupted" | "completed" | "failed" | "timeout";
@@ -2187,6 +2274,14 @@ export declare const WorkflowNodeResult: z.ZodObject<{
     usage?: {
         inputTokens?: number | undefined;
         outputTokens?: number | undefined;
+        durationMs?: number | undefined;
+        cachedTokens?: number | undefined;
+        reasoningTokens?: number | undefined;
+        toolCalls?: number | undefined;
+        costEstimate?: {
+            amount: number;
+            currency: "USD" | "CNY";
+        } | undefined;
     } | undefined;
 }>;
 export type WorkflowNodeResult = z.infer<typeof WorkflowNodeResult>;
@@ -2207,12 +2302,42 @@ export declare const WorkflowNodeRuntime: z.ZodObject<{
         usage: z.ZodOptional<z.ZodObject<{
             inputTokens: z.ZodOptional<z.ZodNumber>;
             outputTokens: z.ZodOptional<z.ZodNumber>;
+            cachedTokens: z.ZodOptional<z.ZodNumber>;
+            reasoningTokens: z.ZodOptional<z.ZodNumber>;
+            toolCalls: z.ZodOptional<z.ZodNumber>;
+            durationMs: z.ZodOptional<z.ZodNumber>;
+            costEstimate: z.ZodOptional<z.ZodObject<{
+                amount: z.ZodNumber;
+                currency: z.ZodEnum<["USD", "CNY"]>;
+            }, "strip", z.ZodTypeAny, {
+                amount: number;
+                currency: "USD" | "CNY";
+            }, {
+                amount: number;
+                currency: "USD" | "CNY";
+            }>>;
         }, "strip", z.ZodTypeAny, {
             inputTokens?: number | undefined;
             outputTokens?: number | undefined;
+            durationMs?: number | undefined;
+            cachedTokens?: number | undefined;
+            reasoningTokens?: number | undefined;
+            toolCalls?: number | undefined;
+            costEstimate?: {
+                amount: number;
+                currency: "USD" | "CNY";
+            } | undefined;
         }, {
             inputTokens?: number | undefined;
             outputTokens?: number | undefined;
+            durationMs?: number | undefined;
+            cachedTokens?: number | undefined;
+            reasoningTokens?: number | undefined;
+            toolCalls?: number | undefined;
+            costEstimate?: {
+                amount: number;
+                currency: "USD" | "CNY";
+            } | undefined;
         }>>;
     }, "strip", z.ZodTypeAny, {
         status: "aborted" | "interrupted" | "completed" | "failed" | "timeout";
@@ -2220,6 +2345,14 @@ export declare const WorkflowNodeRuntime: z.ZodObject<{
         usage?: {
             inputTokens?: number | undefined;
             outputTokens?: number | undefined;
+            durationMs?: number | undefined;
+            cachedTokens?: number | undefined;
+            reasoningTokens?: number | undefined;
+            toolCalls?: number | undefined;
+            costEstimate?: {
+                amount: number;
+                currency: "USD" | "CNY";
+            } | undefined;
         } | undefined;
     }, {
         status: "aborted" | "interrupted" | "completed" | "failed" | "timeout";
@@ -2227,6 +2360,14 @@ export declare const WorkflowNodeRuntime: z.ZodObject<{
         usage?: {
             inputTokens?: number | undefined;
             outputTokens?: number | undefined;
+            durationMs?: number | undefined;
+            cachedTokens?: number | undefined;
+            reasoningTokens?: number | undefined;
+            toolCalls?: number | undefined;
+            costEstimate?: {
+                amount: number;
+                currency: "USD" | "CNY";
+            } | undefined;
         } | undefined;
     }>>;
     /** 该节点完成的轮次计数（discussion 用；DAG/Graph 一次执行 = 1）。 */
@@ -2245,6 +2386,14 @@ export declare const WorkflowNodeRuntime: z.ZodObject<{
         usage?: {
             inputTokens?: number | undefined;
             outputTokens?: number | undefined;
+            durationMs?: number | undefined;
+            cachedTokens?: number | undefined;
+            reasoningTokens?: number | undefined;
+            toolCalls?: number | undefined;
+            costEstimate?: {
+                amount: number;
+                currency: "USD" | "CNY";
+            } | undefined;
         } | undefined;
     } | undefined;
     error?: string | undefined;
@@ -2265,6 +2414,14 @@ export declare const WorkflowNodeRuntime: z.ZodObject<{
         usage?: {
             inputTokens?: number | undefined;
             outputTokens?: number | undefined;
+            durationMs?: number | undefined;
+            cachedTokens?: number | undefined;
+            reasoningTokens?: number | undefined;
+            toolCalls?: number | undefined;
+            costEstimate?: {
+                amount: number;
+                currency: "USD" | "CNY";
+            } | undefined;
         } | undefined;
     } | undefined;
     error?: string | undefined;
@@ -2304,12 +2461,42 @@ export declare const WorkflowStatusResult: z.ZodObject<{
             usage: z.ZodOptional<z.ZodObject<{
                 inputTokens: z.ZodOptional<z.ZodNumber>;
                 outputTokens: z.ZodOptional<z.ZodNumber>;
+                cachedTokens: z.ZodOptional<z.ZodNumber>;
+                reasoningTokens: z.ZodOptional<z.ZodNumber>;
+                toolCalls: z.ZodOptional<z.ZodNumber>;
+                durationMs: z.ZodOptional<z.ZodNumber>;
+                costEstimate: z.ZodOptional<z.ZodObject<{
+                    amount: z.ZodNumber;
+                    currency: z.ZodEnum<["USD", "CNY"]>;
+                }, "strip", z.ZodTypeAny, {
+                    amount: number;
+                    currency: "USD" | "CNY";
+                }, {
+                    amount: number;
+                    currency: "USD" | "CNY";
+                }>>;
             }, "strip", z.ZodTypeAny, {
                 inputTokens?: number | undefined;
                 outputTokens?: number | undefined;
+                durationMs?: number | undefined;
+                cachedTokens?: number | undefined;
+                reasoningTokens?: number | undefined;
+                toolCalls?: number | undefined;
+                costEstimate?: {
+                    amount: number;
+                    currency: "USD" | "CNY";
+                } | undefined;
             }, {
                 inputTokens?: number | undefined;
                 outputTokens?: number | undefined;
+                durationMs?: number | undefined;
+                cachedTokens?: number | undefined;
+                reasoningTokens?: number | undefined;
+                toolCalls?: number | undefined;
+                costEstimate?: {
+                    amount: number;
+                    currency: "USD" | "CNY";
+                } | undefined;
             }>>;
         }, "strip", z.ZodTypeAny, {
             status: "aborted" | "interrupted" | "completed" | "failed" | "timeout";
@@ -2317,6 +2504,14 @@ export declare const WorkflowStatusResult: z.ZodObject<{
             usage?: {
                 inputTokens?: number | undefined;
                 outputTokens?: number | undefined;
+                durationMs?: number | undefined;
+                cachedTokens?: number | undefined;
+                reasoningTokens?: number | undefined;
+                toolCalls?: number | undefined;
+                costEstimate?: {
+                    amount: number;
+                    currency: "USD" | "CNY";
+                } | undefined;
             } | undefined;
         }, {
             status: "aborted" | "interrupted" | "completed" | "failed" | "timeout";
@@ -2324,6 +2519,14 @@ export declare const WorkflowStatusResult: z.ZodObject<{
             usage?: {
                 inputTokens?: number | undefined;
                 outputTokens?: number | undefined;
+                durationMs?: number | undefined;
+                cachedTokens?: number | undefined;
+                reasoningTokens?: number | undefined;
+                toolCalls?: number | undefined;
+                costEstimate?: {
+                    amount: number;
+                    currency: "USD" | "CNY";
+                } | undefined;
             } | undefined;
         }>>;
         /** 该节点完成的轮次计数（discussion 用；DAG/Graph 一次执行 = 1）。 */
@@ -2342,6 +2545,14 @@ export declare const WorkflowStatusResult: z.ZodObject<{
             usage?: {
                 inputTokens?: number | undefined;
                 outputTokens?: number | undefined;
+                durationMs?: number | undefined;
+                cachedTokens?: number | undefined;
+                reasoningTokens?: number | undefined;
+                toolCalls?: number | undefined;
+                costEstimate?: {
+                    amount: number;
+                    currency: "USD" | "CNY";
+                } | undefined;
             } | undefined;
         } | undefined;
         error?: string | undefined;
@@ -2362,6 +2573,14 @@ export declare const WorkflowStatusResult: z.ZodObject<{
             usage?: {
                 inputTokens?: number | undefined;
                 outputTokens?: number | undefined;
+                durationMs?: number | undefined;
+                cachedTokens?: number | undefined;
+                reasoningTokens?: number | undefined;
+                toolCalls?: number | undefined;
+                costEstimate?: {
+                    amount: number;
+                    currency: "USD" | "CNY";
+                } | undefined;
             } | undefined;
         } | undefined;
         error?: string | undefined;
@@ -2396,6 +2615,14 @@ export declare const WorkflowStatusResult: z.ZodObject<{
             usage?: {
                 inputTokens?: number | undefined;
                 outputTokens?: number | undefined;
+                durationMs?: number | undefined;
+                cachedTokens?: number | undefined;
+                reasoningTokens?: number | undefined;
+                toolCalls?: number | undefined;
+                costEstimate?: {
+                    amount: number;
+                    currency: "USD" | "CNY";
+                } | undefined;
             } | undefined;
         } | undefined;
         error?: string | undefined;
@@ -2428,6 +2655,14 @@ export declare const WorkflowStatusResult: z.ZodObject<{
             usage?: {
                 inputTokens?: number | undefined;
                 outputTokens?: number | undefined;
+                durationMs?: number | undefined;
+                cachedTokens?: number | undefined;
+                reasoningTokens?: number | undefined;
+                toolCalls?: number | undefined;
+                costEstimate?: {
+                    amount: number;
+                    currency: "USD" | "CNY";
+                } | undefined;
             } | undefined;
         } | undefined;
         error?: string | undefined;
@@ -2511,12 +2746,42 @@ export declare const WorkflowListResult: z.ZodObject<{
                 usage: z.ZodOptional<z.ZodObject<{
                     inputTokens: z.ZodOptional<z.ZodNumber>;
                     outputTokens: z.ZodOptional<z.ZodNumber>;
+                    cachedTokens: z.ZodOptional<z.ZodNumber>;
+                    reasoningTokens: z.ZodOptional<z.ZodNumber>;
+                    toolCalls: z.ZodOptional<z.ZodNumber>;
+                    durationMs: z.ZodOptional<z.ZodNumber>;
+                    costEstimate: z.ZodOptional<z.ZodObject<{
+                        amount: z.ZodNumber;
+                        currency: z.ZodEnum<["USD", "CNY"]>;
+                    }, "strip", z.ZodTypeAny, {
+                        amount: number;
+                        currency: "USD" | "CNY";
+                    }, {
+                        amount: number;
+                        currency: "USD" | "CNY";
+                    }>>;
                 }, "strip", z.ZodTypeAny, {
                     inputTokens?: number | undefined;
                     outputTokens?: number | undefined;
+                    durationMs?: number | undefined;
+                    cachedTokens?: number | undefined;
+                    reasoningTokens?: number | undefined;
+                    toolCalls?: number | undefined;
+                    costEstimate?: {
+                        amount: number;
+                        currency: "USD" | "CNY";
+                    } | undefined;
                 }, {
                     inputTokens?: number | undefined;
                     outputTokens?: number | undefined;
+                    durationMs?: number | undefined;
+                    cachedTokens?: number | undefined;
+                    reasoningTokens?: number | undefined;
+                    toolCalls?: number | undefined;
+                    costEstimate?: {
+                        amount: number;
+                        currency: "USD" | "CNY";
+                    } | undefined;
                 }>>;
             }, "strip", z.ZodTypeAny, {
                 status: "aborted" | "interrupted" | "completed" | "failed" | "timeout";
@@ -2524,6 +2789,14 @@ export declare const WorkflowListResult: z.ZodObject<{
                 usage?: {
                     inputTokens?: number | undefined;
                     outputTokens?: number | undefined;
+                    durationMs?: number | undefined;
+                    cachedTokens?: number | undefined;
+                    reasoningTokens?: number | undefined;
+                    toolCalls?: number | undefined;
+                    costEstimate?: {
+                        amount: number;
+                        currency: "USD" | "CNY";
+                    } | undefined;
                 } | undefined;
             }, {
                 status: "aborted" | "interrupted" | "completed" | "failed" | "timeout";
@@ -2531,6 +2804,14 @@ export declare const WorkflowListResult: z.ZodObject<{
                 usage?: {
                     inputTokens?: number | undefined;
                     outputTokens?: number | undefined;
+                    durationMs?: number | undefined;
+                    cachedTokens?: number | undefined;
+                    reasoningTokens?: number | undefined;
+                    toolCalls?: number | undefined;
+                    costEstimate?: {
+                        amount: number;
+                        currency: "USD" | "CNY";
+                    } | undefined;
                 } | undefined;
             }>>;
             /** 该节点完成的轮次计数（discussion 用；DAG/Graph 一次执行 = 1）。 */
@@ -2549,6 +2830,14 @@ export declare const WorkflowListResult: z.ZodObject<{
                 usage?: {
                     inputTokens?: number | undefined;
                     outputTokens?: number | undefined;
+                    durationMs?: number | undefined;
+                    cachedTokens?: number | undefined;
+                    reasoningTokens?: number | undefined;
+                    toolCalls?: number | undefined;
+                    costEstimate?: {
+                        amount: number;
+                        currency: "USD" | "CNY";
+                    } | undefined;
                 } | undefined;
             } | undefined;
             error?: string | undefined;
@@ -2569,6 +2858,14 @@ export declare const WorkflowListResult: z.ZodObject<{
                 usage?: {
                     inputTokens?: number | undefined;
                     outputTokens?: number | undefined;
+                    durationMs?: number | undefined;
+                    cachedTokens?: number | undefined;
+                    reasoningTokens?: number | undefined;
+                    toolCalls?: number | undefined;
+                    costEstimate?: {
+                        amount: number;
+                        currency: "USD" | "CNY";
+                    } | undefined;
                 } | undefined;
             } | undefined;
             error?: string | undefined;
@@ -2603,6 +2900,14 @@ export declare const WorkflowListResult: z.ZodObject<{
                 usage?: {
                     inputTokens?: number | undefined;
                     outputTokens?: number | undefined;
+                    durationMs?: number | undefined;
+                    cachedTokens?: number | undefined;
+                    reasoningTokens?: number | undefined;
+                    toolCalls?: number | undefined;
+                    costEstimate?: {
+                        amount: number;
+                        currency: "USD" | "CNY";
+                    } | undefined;
                 } | undefined;
             } | undefined;
             error?: string | undefined;
@@ -2635,6 +2940,14 @@ export declare const WorkflowListResult: z.ZodObject<{
                 usage?: {
                     inputTokens?: number | undefined;
                     outputTokens?: number | undefined;
+                    durationMs?: number | undefined;
+                    cachedTokens?: number | undefined;
+                    reasoningTokens?: number | undefined;
+                    toolCalls?: number | undefined;
+                    costEstimate?: {
+                        amount: number;
+                        currency: "USD" | "CNY";
+                    } | undefined;
                 } | undefined;
             } | undefined;
             error?: string | undefined;
@@ -2670,6 +2983,14 @@ export declare const WorkflowListResult: z.ZodObject<{
                 usage?: {
                     inputTokens?: number | undefined;
                     outputTokens?: number | undefined;
+                    durationMs?: number | undefined;
+                    cachedTokens?: number | undefined;
+                    reasoningTokens?: number | undefined;
+                    toolCalls?: number | undefined;
+                    costEstimate?: {
+                        amount: number;
+                        currency: "USD" | "CNY";
+                    } | undefined;
                 } | undefined;
             } | undefined;
             error?: string | undefined;
@@ -2705,6 +3026,14 @@ export declare const WorkflowListResult: z.ZodObject<{
                 usage?: {
                     inputTokens?: number | undefined;
                     outputTokens?: number | undefined;
+                    durationMs?: number | undefined;
+                    cachedTokens?: number | undefined;
+                    reasoningTokens?: number | undefined;
+                    toolCalls?: number | undefined;
+                    costEstimate?: {
+                        amount: number;
+                        currency: "USD" | "CNY";
+                    } | undefined;
                 } | undefined;
             } | undefined;
             error?: string | undefined;
@@ -2724,7 +3053,7 @@ export type WorkflowListResult = z.infer<typeof WorkflowListResult>;
 export declare const WorkflowEvent: z.ZodObject<{
     workflowId: z.ZodString;
     seq: z.ZodNumber;
-    type: z.ZodEnum<["workflow.status", "node.status", "edge.route", "executor.decision", "round.started", "round.completed", "discussion.terminated"]>;
+    type: z.ZodEnum<["workflow.status", "node.status", "edge.route", "executor.decision", "round.started", "round.completed", "discussion.terminated", "human_review.requested", "human_review.resolved", "artifact.written", "node.diagnostic"]>;
     nodeId: z.ZodOptional<z.ZodString>;
     sessionId: z.ZodOptional<z.ZodBranded<z.ZodString, "SessionId">>;
     turnId: z.ZodOptional<z.ZodString>;
@@ -2738,12 +3067,42 @@ export declare const WorkflowEvent: z.ZodObject<{
         usage: z.ZodOptional<z.ZodObject<{
             inputTokens: z.ZodOptional<z.ZodNumber>;
             outputTokens: z.ZodOptional<z.ZodNumber>;
+            cachedTokens: z.ZodOptional<z.ZodNumber>;
+            reasoningTokens: z.ZodOptional<z.ZodNumber>;
+            toolCalls: z.ZodOptional<z.ZodNumber>;
+            durationMs: z.ZodOptional<z.ZodNumber>;
+            costEstimate: z.ZodOptional<z.ZodObject<{
+                amount: z.ZodNumber;
+                currency: z.ZodEnum<["USD", "CNY"]>;
+            }, "strip", z.ZodTypeAny, {
+                amount: number;
+                currency: "USD" | "CNY";
+            }, {
+                amount: number;
+                currency: "USD" | "CNY";
+            }>>;
         }, "strip", z.ZodTypeAny, {
             inputTokens?: number | undefined;
             outputTokens?: number | undefined;
+            durationMs?: number | undefined;
+            cachedTokens?: number | undefined;
+            reasoningTokens?: number | undefined;
+            toolCalls?: number | undefined;
+            costEstimate?: {
+                amount: number;
+                currency: "USD" | "CNY";
+            } | undefined;
         }, {
             inputTokens?: number | undefined;
             outputTokens?: number | undefined;
+            durationMs?: number | undefined;
+            cachedTokens?: number | undefined;
+            reasoningTokens?: number | undefined;
+            toolCalls?: number | undefined;
+            costEstimate?: {
+                amount: number;
+                currency: "USD" | "CNY";
+            } | undefined;
         }>>;
     }, "strip", z.ZodTypeAny, {
         status: "aborted" | "interrupted" | "completed" | "failed" | "timeout";
@@ -2751,6 +3110,14 @@ export declare const WorkflowEvent: z.ZodObject<{
         usage?: {
             inputTokens?: number | undefined;
             outputTokens?: number | undefined;
+            durationMs?: number | undefined;
+            cachedTokens?: number | undefined;
+            reasoningTokens?: number | undefined;
+            toolCalls?: number | undefined;
+            costEstimate?: {
+                amount: number;
+                currency: "USD" | "CNY";
+            } | undefined;
         } | undefined;
     }, {
         status: "aborted" | "interrupted" | "completed" | "failed" | "timeout";
@@ -2758,13 +3125,21 @@ export declare const WorkflowEvent: z.ZodObject<{
         usage?: {
             inputTokens?: number | undefined;
             outputTokens?: number | undefined;
+            durationMs?: number | undefined;
+            cachedTokens?: number | undefined;
+            reasoningTokens?: number | undefined;
+            toolCalls?: number | undefined;
+            costEstimate?: {
+                amount: number;
+                currency: "USD" | "CNY";
+            } | 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";
+    type: "workflow.status" | "node.status" | "edge.route" | "executor.decision" | "round.started" | "round.completed" | "discussion.terminated" | "human_review.requested" | "human_review.resolved" | "artifact.written" | "node.diagnostic";
     seq: number;
     workflowId: string;
     timestamp: string;
@@ -2780,12 +3155,20 @@ export declare const WorkflowEvent: z.ZodObject<{
         usage?: {
             inputTokens?: number | undefined;
             outputTokens?: number | undefined;
+            durationMs?: number | undefined;
+            cachedTokens?: number | undefined;
+            reasoningTokens?: number | undefined;
+            toolCalls?: number | undefined;
+            costEstimate?: {
+                amount: number;
+                currency: "USD" | "CNY";
+            } | 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";
+    type: "workflow.status" | "node.status" | "edge.route" | "executor.decision" | "round.started" | "round.completed" | "discussion.terminated" | "human_review.requested" | "human_review.resolved" | "artifact.written" | "node.diagnostic";
     seq: number;
     workflowId: string;
     timestamp: string;
@@ -2801,6 +3184,14 @@ export declare const WorkflowEvent: z.ZodObject<{
         usage?: {
             inputTokens?: number | undefined;
             outputTokens?: number | undefined;
+            durationMs?: number | undefined;
+            cachedTokens?: number | undefined;
+            reasoningTokens?: number | undefined;
+            toolCalls?: number | undefined;
+            costEstimate?: {
+                amount: number;
+                currency: "USD" | "CNY";
+            } | undefined;
         } | undefined;
     } | undefined;
     nodeId?: string | undefined;
@@ -2818,6 +3209,430 @@ export declare const WorkflowAckParams: z.ZodObject<{
     lastSeq: number;
 }>;
 export type WorkflowAckParams = z.infer<typeof WorkflowAckParams>;
+export declare const WorkflowEventsListParams: z.ZodObject<{
+    workflowId: z.ZodString;
+    afterSeq: z.ZodOptional<z.ZodNumber>;
+    limit: z.ZodOptional<z.ZodDefault<z.ZodNumber>>;
+}, "strip", z.ZodTypeAny, {
+    workflowId: string;
+    limit?: number | undefined;
+    afterSeq?: number | undefined;
+}, {
+    workflowId: string;
+    limit?: number | undefined;
+    afterSeq?: number | undefined;
+}>;
+export type WorkflowEventsListParams = z.infer<typeof WorkflowEventsListParams>;
+export declare const WorkflowEventsListResult: z.ZodObject<{
+    events: z.ZodArray<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", "human_review.requested", "human_review.resolved", "artifact.written", "node.diagnostic"]>;
+        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>;
+                cachedTokens: z.ZodOptional<z.ZodNumber>;
+                reasoningTokens: z.ZodOptional<z.ZodNumber>;
+                toolCalls: z.ZodOptional<z.ZodNumber>;
+                durationMs: z.ZodOptional<z.ZodNumber>;
+                costEstimate: z.ZodOptional<z.ZodObject<{
+                    amount: z.ZodNumber;
+                    currency: z.ZodEnum<["USD", "CNY"]>;
+                }, "strip", z.ZodTypeAny, {
+                    amount: number;
+                    currency: "USD" | "CNY";
+                }, {
+                    amount: number;
+                    currency: "USD" | "CNY";
+                }>>;
+            }, "strip", z.ZodTypeAny, {
+                inputTokens?: number | undefined;
+                outputTokens?: number | undefined;
+                durationMs?: number | undefined;
+                cachedTokens?: number | undefined;
+                reasoningTokens?: number | undefined;
+                toolCalls?: number | undefined;
+                costEstimate?: {
+                    amount: number;
+                    currency: "USD" | "CNY";
+                } | undefined;
+            }, {
+                inputTokens?: number | undefined;
+                outputTokens?: number | undefined;
+                durationMs?: number | undefined;
+                cachedTokens?: number | undefined;
+                reasoningTokens?: number | undefined;
+                toolCalls?: number | undefined;
+                costEstimate?: {
+                    amount: number;
+                    currency: "USD" | "CNY";
+                } | undefined;
+            }>>;
+        }, "strip", z.ZodTypeAny, {
+            status: "aborted" | "interrupted" | "completed" | "failed" | "timeout";
+            text?: string | undefined;
+            usage?: {
+                inputTokens?: number | undefined;
+                outputTokens?: number | undefined;
+                durationMs?: number | undefined;
+                cachedTokens?: number | undefined;
+                reasoningTokens?: number | undefined;
+                toolCalls?: number | undefined;
+                costEstimate?: {
+                    amount: number;
+                    currency: "USD" | "CNY";
+                } | undefined;
+            } | undefined;
+        }, {
+            status: "aborted" | "interrupted" | "completed" | "failed" | "timeout";
+            text?: string | undefined;
+            usage?: {
+                inputTokens?: number | undefined;
+                outputTokens?: number | undefined;
+                durationMs?: number | undefined;
+                cachedTokens?: number | undefined;
+                reasoningTokens?: number | undefined;
+                toolCalls?: number | undefined;
+                costEstimate?: {
+                    amount: number;
+                    currency: "USD" | "CNY";
+                } | 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" | "human_review.requested" | "human_review.resolved" | "artifact.written" | "node.diagnostic";
+        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;
+                durationMs?: number | undefined;
+                cachedTokens?: number | undefined;
+                reasoningTokens?: number | undefined;
+                toolCalls?: number | undefined;
+                costEstimate?: {
+                    amount: number;
+                    currency: "USD" | "CNY";
+                } | 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" | "human_review.requested" | "human_review.resolved" | "artifact.written" | "node.diagnostic";
+        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;
+                durationMs?: number | undefined;
+                cachedTokens?: number | undefined;
+                reasoningTokens?: number | undefined;
+                toolCalls?: number | undefined;
+                costEstimate?: {
+                    amount: number;
+                    currency: "USD" | "CNY";
+                } | undefined;
+            } | undefined;
+        } | undefined;
+        nodeId?: string | undefined;
+        payload?: Record<string, unknown> | undefined;
+    }>, "many">;
+    nextSeq: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    events: {
+        type: "workflow.status" | "node.status" | "edge.route" | "executor.decision" | "round.started" | "round.completed" | "discussion.terminated" | "human_review.requested" | "human_review.resolved" | "artifact.written" | "node.diagnostic";
+        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;
+                durationMs?: number | undefined;
+                cachedTokens?: number | undefined;
+                reasoningTokens?: number | undefined;
+                toolCalls?: number | undefined;
+                costEstimate?: {
+                    amount: number;
+                    currency: "USD" | "CNY";
+                } | undefined;
+            } | undefined;
+        } | undefined;
+        nodeId?: string | undefined;
+        payload?: Record<string, unknown> | undefined;
+    }[];
+    nextSeq?: number | undefined;
+}, {
+    events: {
+        type: "workflow.status" | "node.status" | "edge.route" | "executor.decision" | "round.started" | "round.completed" | "discussion.terminated" | "human_review.requested" | "human_review.resolved" | "artifact.written" | "node.diagnostic";
+        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;
+                durationMs?: number | undefined;
+                cachedTokens?: number | undefined;
+                reasoningTokens?: number | undefined;
+                toolCalls?: number | undefined;
+                costEstimate?: {
+                    amount: number;
+                    currency: "USD" | "CNY";
+                } | undefined;
+            } | undefined;
+        } | undefined;
+        nodeId?: string | undefined;
+        payload?: Record<string, unknown> | undefined;
+    }[];
+    nextSeq?: number | undefined;
+}>;
+export type WorkflowEventsListResult = z.infer<typeof WorkflowEventsListResult>;
+export declare const WorkflowArtifact: z.ZodObject<{
+    artifactId: z.ZodString;
+    workflowId: z.ZodString;
+    nodeId: z.ZodOptional<z.ZodString>;
+    kind: z.ZodEnum<["report", "diff", "spec", "log", "patch", "image", "binary", "other"]>;
+    path: z.ZodString;
+    title: z.ZodOptional<z.ZodString>;
+    mimeType: z.ZodOptional<z.ZodString>;
+    size: z.ZodOptional<z.ZodNumber>;
+    createdAt: z.ZodString;
+    metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, "strip", z.ZodTypeAny, {
+    path: string;
+    kind: "patch" | "image" | "other" | "report" | "diff" | "spec" | "log" | "binary";
+    createdAt: string;
+    workflowId: string;
+    artifactId: string;
+    nodeId?: string | undefined;
+    mimeType?: string | undefined;
+    title?: string | undefined;
+    metadata?: Record<string, unknown> | undefined;
+    size?: number | undefined;
+}, {
+    path: string;
+    kind: "patch" | "image" | "other" | "report" | "diff" | "spec" | "log" | "binary";
+    createdAt: string;
+    workflowId: string;
+    artifactId: string;
+    nodeId?: string | undefined;
+    mimeType?: string | undefined;
+    title?: string | undefined;
+    metadata?: Record<string, unknown> | undefined;
+    size?: number | undefined;
+}>;
+export type WorkflowArtifact = z.infer<typeof WorkflowArtifact>;
+export declare const WorkflowArtifactRegisterParams: z.ZodObject<{
+    workflowId: z.ZodString;
+    nodeId: z.ZodOptional<z.ZodString>;
+    kind: z.ZodEnum<["report", "diff", "spec", "log", "patch", "image", "binary", "other"]>;
+    path: z.ZodString;
+    title: z.ZodOptional<z.ZodString>;
+    mimeType: z.ZodOptional<z.ZodString>;
+    metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, "strip", z.ZodTypeAny, {
+    path: string;
+    kind: "patch" | "image" | "other" | "report" | "diff" | "spec" | "log" | "binary";
+    workflowId: string;
+    nodeId?: string | undefined;
+    mimeType?: string | undefined;
+    title?: string | undefined;
+    metadata?: Record<string, unknown> | undefined;
+}, {
+    path: string;
+    kind: "patch" | "image" | "other" | "report" | "diff" | "spec" | "log" | "binary";
+    workflowId: string;
+    nodeId?: string | undefined;
+    mimeType?: string | undefined;
+    title?: string | undefined;
+    metadata?: Record<string, unknown> | undefined;
+}>;
+export type WorkflowArtifactRegisterParams = z.infer<typeof WorkflowArtifactRegisterParams>;
+export declare const WorkflowArtifactRegisterResult: z.ZodObject<{
+    artifact: z.ZodObject<{
+        artifactId: z.ZodString;
+        workflowId: z.ZodString;
+        nodeId: z.ZodOptional<z.ZodString>;
+        kind: z.ZodEnum<["report", "diff", "spec", "log", "patch", "image", "binary", "other"]>;
+        path: z.ZodString;
+        title: z.ZodOptional<z.ZodString>;
+        mimeType: z.ZodOptional<z.ZodString>;
+        size: z.ZodOptional<z.ZodNumber>;
+        createdAt: z.ZodString;
+        metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, "strip", z.ZodTypeAny, {
+        path: string;
+        kind: "patch" | "image" | "other" | "report" | "diff" | "spec" | "log" | "binary";
+        createdAt: string;
+        workflowId: string;
+        artifactId: string;
+        nodeId?: string | undefined;
+        mimeType?: string | undefined;
+        title?: string | undefined;
+        metadata?: Record<string, unknown> | undefined;
+        size?: number | undefined;
+    }, {
+        path: string;
+        kind: "patch" | "image" | "other" | "report" | "diff" | "spec" | "log" | "binary";
+        createdAt: string;
+        workflowId: string;
+        artifactId: string;
+        nodeId?: string | undefined;
+        mimeType?: string | undefined;
+        title?: string | undefined;
+        metadata?: Record<string, unknown> | undefined;
+        size?: number | undefined;
+    }>;
+}, "strip", z.ZodTypeAny, {
+    artifact: {
+        path: string;
+        kind: "patch" | "image" | "other" | "report" | "diff" | "spec" | "log" | "binary";
+        createdAt: string;
+        workflowId: string;
+        artifactId: string;
+        nodeId?: string | undefined;
+        mimeType?: string | undefined;
+        title?: string | undefined;
+        metadata?: Record<string, unknown> | undefined;
+        size?: number | undefined;
+    };
+}, {
+    artifact: {
+        path: string;
+        kind: "patch" | "image" | "other" | "report" | "diff" | "spec" | "log" | "binary";
+        createdAt: string;
+        workflowId: string;
+        artifactId: string;
+        nodeId?: string | undefined;
+        mimeType?: string | undefined;
+        title?: string | undefined;
+        metadata?: Record<string, unknown> | undefined;
+        size?: number | undefined;
+    };
+}>;
+export type WorkflowArtifactRegisterResult = z.infer<typeof WorkflowArtifactRegisterResult>;
+export declare const WorkflowArtifactsListParams: z.ZodObject<{
+    workflowId: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    workflowId: string;
+}, {
+    workflowId: string;
+}>;
+export type WorkflowArtifactsListParams = z.infer<typeof WorkflowArtifactsListParams>;
+export declare const WorkflowArtifactsListResult: z.ZodObject<{
+    artifacts: z.ZodArray<z.ZodObject<{
+        artifactId: z.ZodString;
+        workflowId: z.ZodString;
+        nodeId: z.ZodOptional<z.ZodString>;
+        kind: z.ZodEnum<["report", "diff", "spec", "log", "patch", "image", "binary", "other"]>;
+        path: z.ZodString;
+        title: z.ZodOptional<z.ZodString>;
+        mimeType: z.ZodOptional<z.ZodString>;
+        size: z.ZodOptional<z.ZodNumber>;
+        createdAt: z.ZodString;
+        metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, "strip", z.ZodTypeAny, {
+        path: string;
+        kind: "patch" | "image" | "other" | "report" | "diff" | "spec" | "log" | "binary";
+        createdAt: string;
+        workflowId: string;
+        artifactId: string;
+        nodeId?: string | undefined;
+        mimeType?: string | undefined;
+        title?: string | undefined;
+        metadata?: Record<string, unknown> | undefined;
+        size?: number | undefined;
+    }, {
+        path: string;
+        kind: "patch" | "image" | "other" | "report" | "diff" | "spec" | "log" | "binary";
+        createdAt: string;
+        workflowId: string;
+        artifactId: string;
+        nodeId?: string | undefined;
+        mimeType?: string | undefined;
+        title?: string | undefined;
+        metadata?: Record<string, unknown> | undefined;
+        size?: number | undefined;
+    }>, "many">;
+}, "strip", z.ZodTypeAny, {
+    artifacts: {
+        path: string;
+        kind: "patch" | "image" | "other" | "report" | "diff" | "spec" | "log" | "binary";
+        createdAt: string;
+        workflowId: string;
+        artifactId: string;
+        nodeId?: string | undefined;
+        mimeType?: string | undefined;
+        title?: string | undefined;
+        metadata?: Record<string, unknown> | undefined;
+        size?: number | undefined;
+    }[];
+}, {
+    artifacts: {
+        path: string;
+        kind: "patch" | "image" | "other" | "report" | "diff" | "spec" | "log" | "binary";
+        createdAt: string;
+        workflowId: string;
+        artifactId: string;
+        nodeId?: string | undefined;
+        mimeType?: string | undefined;
+        title?: string | undefined;
+        metadata?: Record<string, unknown> | undefined;
+        size?: number | undefined;
+    }[];
+}>;
+export type WorkflowArtifactsListResult = z.infer<typeof WorkflowArtifactsListResult>;
 /** route：派新任务给目标 worker（v0.4 既有语义）。 */
 export declare const WorkflowRouteDirective: z.ZodObject<{
     kind: z.ZodLiteral<"workflow.route">;
@@ -2895,6 +3710,75 @@ export declare const WorkflowDoneDirective: z.ZodObject<{
     finalSummary?: string | undefined;
 }>;
 export type WorkflowDoneDirective = z.infer<typeof WorkflowDoneDirective>;
+/**
+ * human_review: 请求 server 进行人工审查（v0.7 新增）。
+ *
+ * Executor emit 这个 directive 后，phonon 暂停 workflow，通过 `interaction.request`
+ * 反向问 server；server 返回 { approved, feedback? } 后：
+ *   - approved=true   → 当作 workflow.done 处理（finalSummary = feedback ?? executor 文本）
+ *   - approved=false  → 把 feedback 文本作为 executor 下一轮的输入（"revise based on review"）
+ * phonon 同时 emit workflow.event { type: "human_review.requested" / "human_review.resolved" }。
+ *
+ * 这是设备侧底层 HITL 机制；UI 渲染、表单字段、文档关联、Feishu 集成等业务由 server 实现。
+ */
+export declare const WorkflowHumanReviewDirective: z.ZodObject<{
+    kind: z.ZodLiteral<"workflow.human_review">;
+    /** 审查标题（短，给 UI 显示用） */
+    title: z.ZodString;
+    /** 审查内容/摘要（长，给 reviewer 看） */
+    summary: z.ZodString;
+    /** 关联的产物文件路径（workspace 相对） */
+    artifacts: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        path: z.ZodString;
+        role: z.ZodDefault<z.ZodEnum<["report", "diff", "spec", "log", "other"]>>;
+    }, "strip", z.ZodTypeAny, {
+        path: string;
+        role: "other" | "report" | "diff" | "spec" | "log";
+    }, {
+        path: string;
+        role?: "other" | "report" | "diff" | "spec" | "log" | undefined;
+    }>, "many">>;
+    reason: z.ZodOptional<z.ZodString>;
+    /** 等待 server 响应的超时秒数，默认 1800 (30min) */
+    timeoutSeconds: z.ZodDefault<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    kind: "workflow.human_review";
+    summary: string;
+    title: string;
+    timeoutSeconds: number;
+    reason?: string | undefined;
+    artifacts?: {
+        path: string;
+        role: "other" | "report" | "diff" | "spec" | "log";
+    }[] | undefined;
+}, {
+    kind: "workflow.human_review";
+    summary: string;
+    title: string;
+    reason?: string | undefined;
+    timeoutSeconds?: number | undefined;
+    artifacts?: {
+        path: string;
+        role?: "other" | "report" | "diff" | "spec" | "log" | undefined;
+    }[] | undefined;
+}>;
+export type WorkflowHumanReviewDirective = z.infer<typeof WorkflowHumanReviewDirective>;
+/** server 对 human_review 的响应 schema（通过 interaction.respond 走 form value） */
+export declare const WorkflowHumanReviewResponse: z.ZodObject<{
+    approved: z.ZodBoolean;
+    /** 反馈文字。approved=true 时可作 finalSummary；approved=false 时作 executor 下一轮输入 */
+    feedback: z.ZodOptional<z.ZodString>;
+    reviewer: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    approved: boolean;
+    feedback?: string | undefined;
+    reviewer?: string | undefined;
+}, {
+    approved: boolean;
+    feedback?: string | undefined;
+    reviewer?: string | undefined;
+}>;
+export type WorkflowHumanReviewResponse = z.infer<typeof WorkflowHumanReviewResponse>;
 export declare const WorkflowRoutingDirective: z.ZodDiscriminatedUnion<"kind", [z.ZodObject<{
     kind: z.ZodLiteral<"workflow.route">;
     to: z.ZodUnion<[z.ZodString, z.ZodArray<z.ZodString, "many">]>;
@@ -2960,6 +3844,46 @@ export declare const WorkflowRoutingDirective: z.ZodDiscriminatedUnion<"kind", [
     kind: "workflow.done";
     reason?: string | undefined;
     finalSummary?: string | undefined;
+}>, z.ZodObject<{
+    kind: z.ZodLiteral<"workflow.human_review">;
+    /** 审查标题（短，给 UI 显示用） */
+    title: z.ZodString;
+    /** 审查内容/摘要（长，给 reviewer 看） */
+    summary: z.ZodString;
+    /** 关联的产物文件路径（workspace 相对） */
+    artifacts: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        path: z.ZodString;
+        role: z.ZodDefault<z.ZodEnum<["report", "diff", "spec", "log", "other"]>>;
+    }, "strip", z.ZodTypeAny, {
+        path: string;
+        role: "other" | "report" | "diff" | "spec" | "log";
+    }, {
+        path: string;
+        role?: "other" | "report" | "diff" | "spec" | "log" | undefined;
+    }>, "many">>;
+    reason: z.ZodOptional<z.ZodString>;
+    /** 等待 server 响应的超时秒数，默认 1800 (30min) */
+    timeoutSeconds: z.ZodDefault<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    kind: "workflow.human_review";
+    summary: string;
+    title: string;
+    timeoutSeconds: number;
+    reason?: string | undefined;
+    artifacts?: {
+        path: string;
+        role: "other" | "report" | "diff" | "spec" | "log";
+    }[] | undefined;
+}, {
+    kind: "workflow.human_review";
+    summary: string;
+    title: string;
+    reason?: string | undefined;
+    timeoutSeconds?: number | undefined;
+    artifacts?: {
+        path: string;
+        role?: "other" | "report" | "diff" | "spec" | "log" | undefined;
+    }[] | undefined;
 }>]>;
 export type WorkflowRoutingDirective = z.infer<typeof WorkflowRoutingDirective>;
 //# sourceMappingURL=workflow.d.ts.map