@agent-phonon/protocol 0.2.0

package/dist/schemas/interaction.d.ts

@@ -0,0 +1,1583 @@
+import { z } from "zod";
+/**
+ * 人机交互协议（design 平面③ / D21）。
+ *
+ * 场景：HITL 时、或 agent 主动想问人，发一个**可交互卡片/表单**（抽象结构），
+ * phonon → server 渲染给人（飞书卡片/网页/TG 按钮…由服务端决定，复用「甩锅服务端」原则），
+ * 人填完 → 原路返回 → 注入回 agent。
+ *
+ * 两个层次：
+ *   - InteractionDirective ：agent emit 的表单定义（skill 教，让任何模型都能发）
+ *   - interaction.request   ：phonon → server 线协议（带 requestId，阻塞等回填）
+ *   - interaction.response  ：server → phonon 线协议（人填完的值）
+ *
+ * 表单只定义**抽象字段结构**，不绑定任何渲染方式——服务端自由渲染。
+ */
+/** 字段类型（抽象，渲染由服务端决定）。 */
+export declare const FieldType: z.ZodEnum<["text", "textarea", "number", "boolean", "select", "multiselect", "date"]>;
+export type FieldType = z.infer<typeof FieldType>;
+export declare const FormFieldOption: z.ZodObject<{
+    label: z.ZodString;
+    value: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    value: string;
+    label: string;
+}, {
+    value: string;
+    label: string;
+}>;
+export type FormFieldOption = z.infer<typeof FormFieldOption>;
+export declare const FormField: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
+    type: z.ZodLiteral<"text">;
+    placeholder: z.ZodOptional<z.ZodString>;
+    defaultValue: z.ZodOptional<z.ZodString>;
+    key: z.ZodString;
+    label: z.ZodString;
+    required: z.ZodDefault<z.ZodBoolean>;
+    help: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    type: "text";
+    label: string;
+    key: string;
+    required: boolean;
+    placeholder?: string | undefined;
+    defaultValue?: string | undefined;
+    help?: string | undefined;
+}, {
+    type: "text";
+    label: string;
+    key: string;
+    placeholder?: string | undefined;
+    defaultValue?: string | undefined;
+    required?: boolean | undefined;
+    help?: string | undefined;
+}>, z.ZodObject<{
+    type: z.ZodLiteral<"textarea">;
+    placeholder: z.ZodOptional<z.ZodString>;
+    defaultValue: z.ZodOptional<z.ZodString>;
+    key: z.ZodString;
+    label: z.ZodString;
+    required: z.ZodDefault<z.ZodBoolean>;
+    help: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    type: "textarea";
+    label: string;
+    key: string;
+    required: boolean;
+    placeholder?: string | undefined;
+    defaultValue?: string | undefined;
+    help?: string | undefined;
+}, {
+    type: "textarea";
+    label: string;
+    key: string;
+    placeholder?: string | undefined;
+    defaultValue?: string | undefined;
+    required?: boolean | undefined;
+    help?: string | undefined;
+}>, z.ZodObject<{
+    type: z.ZodLiteral<"number">;
+    defaultValue: z.ZodOptional<z.ZodNumber>;
+    key: z.ZodString;
+    label: z.ZodString;
+    required: z.ZodDefault<z.ZodBoolean>;
+    help: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    type: "number";
+    label: string;
+    key: string;
+    required: boolean;
+    defaultValue?: number | undefined;
+    help?: string | undefined;
+}, {
+    type: "number";
+    label: string;
+    key: string;
+    defaultValue?: number | undefined;
+    required?: boolean | undefined;
+    help?: string | undefined;
+}>, z.ZodObject<{
+    type: z.ZodLiteral<"boolean">;
+    defaultValue: z.ZodOptional<z.ZodBoolean>;
+    key: z.ZodString;
+    label: z.ZodString;
+    required: z.ZodDefault<z.ZodBoolean>;
+    help: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    type: "boolean";
+    label: string;
+    key: string;
+    required: boolean;
+    defaultValue?: boolean | undefined;
+    help?: string | undefined;
+}, {
+    type: "boolean";
+    label: string;
+    key: string;
+    defaultValue?: boolean | undefined;
+    required?: boolean | undefined;
+    help?: string | undefined;
+}>, z.ZodObject<{
+    type: z.ZodLiteral<"select">;
+    options: z.ZodArray<z.ZodObject<{
+        label: z.ZodString;
+        value: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        value: string;
+        label: string;
+    }, {
+        value: string;
+        label: string;
+    }>, "many">;
+    defaultValue: z.ZodOptional<z.ZodString>;
+    key: z.ZodString;
+    label: z.ZodString;
+    required: z.ZodDefault<z.ZodBoolean>;
+    help: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    options: {
+        value: string;
+        label: string;
+    }[];
+    type: "select";
+    label: string;
+    key: string;
+    required: boolean;
+    defaultValue?: string | undefined;
+    help?: string | undefined;
+}, {
+    options: {
+        value: string;
+        label: string;
+    }[];
+    type: "select";
+    label: string;
+    key: string;
+    defaultValue?: string | undefined;
+    required?: boolean | undefined;
+    help?: string | undefined;
+}>, z.ZodObject<{
+    type: z.ZodLiteral<"multiselect">;
+    options: z.ZodArray<z.ZodObject<{
+        label: z.ZodString;
+        value: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        value: string;
+        label: string;
+    }, {
+        value: string;
+        label: string;
+    }>, "many">;
+    defaultValue: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    key: z.ZodString;
+    label: z.ZodString;
+    required: z.ZodDefault<z.ZodBoolean>;
+    help: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    options: {
+        value: string;
+        label: string;
+    }[];
+    type: "multiselect";
+    label: string;
+    key: string;
+    required: boolean;
+    defaultValue?: string[] | undefined;
+    help?: string | undefined;
+}, {
+    options: {
+        value: string;
+        label: string;
+    }[];
+    type: "multiselect";
+    label: string;
+    key: string;
+    defaultValue?: string[] | undefined;
+    required?: boolean | undefined;
+    help?: string | undefined;
+}>, z.ZodObject<{
+    type: z.ZodLiteral<"date">;
+    defaultValue: z.ZodOptional<z.ZodString>;
+    key: z.ZodString;
+    label: z.ZodString;
+    required: z.ZodDefault<z.ZodBoolean>;
+    help: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    type: "date";
+    label: string;
+    key: string;
+    required: boolean;
+    defaultValue?: string | undefined;
+    help?: string | undefined;
+}, {
+    type: "date";
+    label: string;
+    key: string;
+    defaultValue?: string | undefined;
+    required?: boolean | undefined;
+    help?: string | undefined;
+}>]>;
+export type FormField = z.infer<typeof FormField>;
+/** 表单/卡片定义（抽象）。 */
+export declare const InteractionForm: z.ZodObject<{
+    title: z.ZodString;
+    /** 卡片正文/说明（可选）。 */
+    description: z.ZodOptional<z.ZodString>;
+    fields: z.ZodDefault<z.ZodArray<z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
+        type: z.ZodLiteral<"text">;
+        placeholder: z.ZodOptional<z.ZodString>;
+        defaultValue: z.ZodOptional<z.ZodString>;
+        key: z.ZodString;
+        label: z.ZodString;
+        required: z.ZodDefault<z.ZodBoolean>;
+        help: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        type: "text";
+        label: string;
+        key: string;
+        required: boolean;
+        placeholder?: string | undefined;
+        defaultValue?: string | undefined;
+        help?: string | undefined;
+    }, {
+        type: "text";
+        label: string;
+        key: string;
+        placeholder?: string | undefined;
+        defaultValue?: string | undefined;
+        required?: boolean | undefined;
+        help?: string | undefined;
+    }>, z.ZodObject<{
+        type: z.ZodLiteral<"textarea">;
+        placeholder: z.ZodOptional<z.ZodString>;
+        defaultValue: z.ZodOptional<z.ZodString>;
+        key: z.ZodString;
+        label: z.ZodString;
+        required: z.ZodDefault<z.ZodBoolean>;
+        help: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        type: "textarea";
+        label: string;
+        key: string;
+        required: boolean;
+        placeholder?: string | undefined;
+        defaultValue?: string | undefined;
+        help?: string | undefined;
+    }, {
+        type: "textarea";
+        label: string;
+        key: string;
+        placeholder?: string | undefined;
+        defaultValue?: string | undefined;
+        required?: boolean | undefined;
+        help?: string | undefined;
+    }>, z.ZodObject<{
+        type: z.ZodLiteral<"number">;
+        defaultValue: z.ZodOptional<z.ZodNumber>;
+        key: z.ZodString;
+        label: z.ZodString;
+        required: z.ZodDefault<z.ZodBoolean>;
+        help: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        type: "number";
+        label: string;
+        key: string;
+        required: boolean;
+        defaultValue?: number | undefined;
+        help?: string | undefined;
+    }, {
+        type: "number";
+        label: string;
+        key: string;
+        defaultValue?: number | undefined;
+        required?: boolean | undefined;
+        help?: string | undefined;
+    }>, z.ZodObject<{
+        type: z.ZodLiteral<"boolean">;
+        defaultValue: z.ZodOptional<z.ZodBoolean>;
+        key: z.ZodString;
+        label: z.ZodString;
+        required: z.ZodDefault<z.ZodBoolean>;
+        help: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        type: "boolean";
+        label: string;
+        key: string;
+        required: boolean;
+        defaultValue?: boolean | undefined;
+        help?: string | undefined;
+    }, {
+        type: "boolean";
+        label: string;
+        key: string;
+        defaultValue?: boolean | undefined;
+        required?: boolean | undefined;
+        help?: string | undefined;
+    }>, z.ZodObject<{
+        type: z.ZodLiteral<"select">;
+        options: z.ZodArray<z.ZodObject<{
+            label: z.ZodString;
+            value: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            value: string;
+            label: string;
+        }, {
+            value: string;
+            label: string;
+        }>, "many">;
+        defaultValue: z.ZodOptional<z.ZodString>;
+        key: z.ZodString;
+        label: z.ZodString;
+        required: z.ZodDefault<z.ZodBoolean>;
+        help: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        options: {
+            value: string;
+            label: string;
+        }[];
+        type: "select";
+        label: string;
+        key: string;
+        required: boolean;
+        defaultValue?: string | undefined;
+        help?: string | undefined;
+    }, {
+        options: {
+            value: string;
+            label: string;
+        }[];
+        type: "select";
+        label: string;
+        key: string;
+        defaultValue?: string | undefined;
+        required?: boolean | undefined;
+        help?: string | undefined;
+    }>, z.ZodObject<{
+        type: z.ZodLiteral<"multiselect">;
+        options: z.ZodArray<z.ZodObject<{
+            label: z.ZodString;
+            value: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            value: string;
+            label: string;
+        }, {
+            value: string;
+            label: string;
+        }>, "many">;
+        defaultValue: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        key: z.ZodString;
+        label: z.ZodString;
+        required: z.ZodDefault<z.ZodBoolean>;
+        help: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        options: {
+            value: string;
+            label: string;
+        }[];
+        type: "multiselect";
+        label: string;
+        key: string;
+        required: boolean;
+        defaultValue?: string[] | undefined;
+        help?: string | undefined;
+    }, {
+        options: {
+            value: string;
+            label: string;
+        }[];
+        type: "multiselect";
+        label: string;
+        key: string;
+        defaultValue?: string[] | undefined;
+        required?: boolean | undefined;
+        help?: string | undefined;
+    }>, z.ZodObject<{
+        type: z.ZodLiteral<"date">;
+        defaultValue: z.ZodOptional<z.ZodString>;
+        key: z.ZodString;
+        label: z.ZodString;
+        required: z.ZodDefault<z.ZodBoolean>;
+        help: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        type: "date";
+        label: string;
+        key: string;
+        required: boolean;
+        defaultValue?: string | undefined;
+        help?: string | undefined;
+    }, {
+        type: "date";
+        label: string;
+        key: string;
+        defaultValue?: string | undefined;
+        required?: boolean | undefined;
+        help?: string | undefined;
+    }>]>, "many">>;
+    /** 提交/操作按钮；纯通知类可只放一个「知道了」。 */
+    submitLabel: z.ZodDefault<z.ZodString>;
+    cancelLabel: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    title: string;
+    fields: ({
+        type: "text";
+        label: string;
+        key: string;
+        required: boolean;
+        placeholder?: string | undefined;
+        defaultValue?: string | undefined;
+        help?: string | undefined;
+    } | {
+        type: "textarea";
+        label: string;
+        key: string;
+        required: boolean;
+        placeholder?: string | undefined;
+        defaultValue?: string | undefined;
+        help?: string | undefined;
+    } | {
+        type: "number";
+        label: string;
+        key: string;
+        required: boolean;
+        defaultValue?: number | undefined;
+        help?: string | undefined;
+    } | {
+        type: "boolean";
+        label: string;
+        key: string;
+        required: boolean;
+        defaultValue?: boolean | undefined;
+        help?: string | undefined;
+    } | {
+        options: {
+            value: string;
+            label: string;
+        }[];
+        type: "select";
+        label: string;
+        key: string;
+        required: boolean;
+        defaultValue?: string | undefined;
+        help?: string | undefined;
+    } | {
+        options: {
+            value: string;
+            label: string;
+        }[];
+        type: "multiselect";
+        label: string;
+        key: string;
+        required: boolean;
+        defaultValue?: string[] | undefined;
+        help?: string | undefined;
+    } | {
+        type: "date";
+        label: string;
+        key: string;
+        required: boolean;
+        defaultValue?: string | undefined;
+        help?: string | undefined;
+    })[];
+    submitLabel: string;
+    description?: string | undefined;
+    cancelLabel?: string | undefined;
+}, {
+    title: string;
+    description?: string | undefined;
+    fields?: ({
+        type: "text";
+        label: string;
+        key: string;
+        placeholder?: string | undefined;
+        defaultValue?: string | undefined;
+        required?: boolean | undefined;
+        help?: string | undefined;
+    } | {
+        type: "textarea";
+        label: string;
+        key: string;
+        placeholder?: string | undefined;
+        defaultValue?: string | undefined;
+        required?: boolean | undefined;
+        help?: string | undefined;
+    } | {
+        type: "number";
+        label: string;
+        key: string;
+        defaultValue?: number | undefined;
+        required?: boolean | undefined;
+        help?: string | undefined;
+    } | {
+        type: "boolean";
+        label: string;
+        key: string;
+        defaultValue?: boolean | undefined;
+        required?: boolean | undefined;
+        help?: string | undefined;
+    } | {
+        options: {
+            value: string;
+            label: string;
+        }[];
+        type: "select";
+        label: string;
+        key: string;
+        defaultValue?: string | undefined;
+        required?: boolean | undefined;
+        help?: string | undefined;
+    } | {
+        options: {
+            value: string;
+            label: string;
+        }[];
+        type: "multiselect";
+        label: string;
+        key: string;
+        defaultValue?: string[] | undefined;
+        required?: boolean | undefined;
+        help?: string | undefined;
+    } | {
+        type: "date";
+        label: string;
+        key: string;
+        defaultValue?: string | undefined;
+        required?: boolean | undefined;
+        help?: string | undefined;
+    })[] | undefined;
+    submitLabel?: string | undefined;
+    cancelLabel?: string | undefined;
+}>;
+export type InteractionForm = z.infer<typeof InteractionForm>;
+/**
+ * agent emit 的指令（skill 教）——和 interaction.request 结构基本一致，
+ * 但不带 requestId（由 phonon 生成）。
+ */
+export declare const InteractionDirective: z.ZodObject<{
+    form: z.ZodObject<{
+        title: z.ZodString;
+        /** 卡片正文/说明（可选）。 */
+        description: z.ZodOptional<z.ZodString>;
+        fields: z.ZodDefault<z.ZodArray<z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
+            type: z.ZodLiteral<"text">;
+            placeholder: z.ZodOptional<z.ZodString>;
+            defaultValue: z.ZodOptional<z.ZodString>;
+            key: z.ZodString;
+            label: z.ZodString;
+            required: z.ZodDefault<z.ZodBoolean>;
+            help: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            type: "text";
+            label: string;
+            key: string;
+            required: boolean;
+            placeholder?: string | undefined;
+            defaultValue?: string | undefined;
+            help?: string | undefined;
+        }, {
+            type: "text";
+            label: string;
+            key: string;
+            placeholder?: string | undefined;
+            defaultValue?: string | undefined;
+            required?: boolean | undefined;
+            help?: string | undefined;
+        }>, z.ZodObject<{
+            type: z.ZodLiteral<"textarea">;
+            placeholder: z.ZodOptional<z.ZodString>;
+            defaultValue: z.ZodOptional<z.ZodString>;
+            key: z.ZodString;
+            label: z.ZodString;
+            required: z.ZodDefault<z.ZodBoolean>;
+            help: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            type: "textarea";
+            label: string;
+            key: string;
+            required: boolean;
+            placeholder?: string | undefined;
+            defaultValue?: string | undefined;
+            help?: string | undefined;
+        }, {
+            type: "textarea";
+            label: string;
+            key: string;
+            placeholder?: string | undefined;
+            defaultValue?: string | undefined;
+            required?: boolean | undefined;
+            help?: string | undefined;
+        }>, z.ZodObject<{
+            type: z.ZodLiteral<"number">;
+            defaultValue: z.ZodOptional<z.ZodNumber>;
+            key: z.ZodString;
+            label: z.ZodString;
+            required: z.ZodDefault<z.ZodBoolean>;
+            help: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            type: "number";
+            label: string;
+            key: string;
+            required: boolean;
+            defaultValue?: number | undefined;
+            help?: string | undefined;
+        }, {
+            type: "number";
+            label: string;
+            key: string;
+            defaultValue?: number | undefined;
+            required?: boolean | undefined;
+            help?: string | undefined;
+        }>, z.ZodObject<{
+            type: z.ZodLiteral<"boolean">;
+            defaultValue: z.ZodOptional<z.ZodBoolean>;
+            key: z.ZodString;
+            label: z.ZodString;
+            required: z.ZodDefault<z.ZodBoolean>;
+            help: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            type: "boolean";
+            label: string;
+            key: string;
+            required: boolean;
+            defaultValue?: boolean | undefined;
+            help?: string | undefined;
+        }, {
+            type: "boolean";
+            label: string;
+            key: string;
+            defaultValue?: boolean | undefined;
+            required?: boolean | undefined;
+            help?: string | undefined;
+        }>, z.ZodObject<{
+            type: z.ZodLiteral<"select">;
+            options: z.ZodArray<z.ZodObject<{
+                label: z.ZodString;
+                value: z.ZodString;
+            }, "strip", z.ZodTypeAny, {
+                value: string;
+                label: string;
+            }, {
+                value: string;
+                label: string;
+            }>, "many">;
+            defaultValue: z.ZodOptional<z.ZodString>;
+            key: z.ZodString;
+            label: z.ZodString;
+            required: z.ZodDefault<z.ZodBoolean>;
+            help: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            options: {
+                value: string;
+                label: string;
+            }[];
+            type: "select";
+            label: string;
+            key: string;
+            required: boolean;
+            defaultValue?: string | undefined;
+            help?: string | undefined;
+        }, {
+            options: {
+                value: string;
+                label: string;
+            }[];
+            type: "select";
+            label: string;
+            key: string;
+            defaultValue?: string | undefined;
+            required?: boolean | undefined;
+            help?: string | undefined;
+        }>, z.ZodObject<{
+            type: z.ZodLiteral<"multiselect">;
+            options: z.ZodArray<z.ZodObject<{
+                label: z.ZodString;
+                value: z.ZodString;
+            }, "strip", z.ZodTypeAny, {
+                value: string;
+                label: string;
+            }, {
+                value: string;
+                label: string;
+            }>, "many">;
+            defaultValue: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+            key: z.ZodString;
+            label: z.ZodString;
+            required: z.ZodDefault<z.ZodBoolean>;
+            help: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            options: {
+                value: string;
+                label: string;
+            }[];
+            type: "multiselect";
+            label: string;
+            key: string;
+            required: boolean;
+            defaultValue?: string[] | undefined;
+            help?: string | undefined;
+        }, {
+            options: {
+                value: string;
+                label: string;
+            }[];
+            type: "multiselect";
+            label: string;
+            key: string;
+            defaultValue?: string[] | undefined;
+            required?: boolean | undefined;
+            help?: string | undefined;
+        }>, z.ZodObject<{
+            type: z.ZodLiteral<"date">;
+            defaultValue: z.ZodOptional<z.ZodString>;
+            key: z.ZodString;
+            label: z.ZodString;
+            required: z.ZodDefault<z.ZodBoolean>;
+            help: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            type: "date";
+            label: string;
+            key: string;
+            required: boolean;
+            defaultValue?: string | undefined;
+            help?: string | undefined;
+        }, {
+            type: "date";
+            label: string;
+            key: string;
+            defaultValue?: string | undefined;
+            required?: boolean | undefined;
+            help?: string | undefined;
+        }>]>, "many">>;
+        /** 提交/操作按钮；纯通知类可只放一个「知道了」。 */
+        submitLabel: z.ZodDefault<z.ZodString>;
+        cancelLabel: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        title: string;
+        fields: ({
+            type: "text";
+            label: string;
+            key: string;
+            required: boolean;
+            placeholder?: string | undefined;
+            defaultValue?: string | undefined;
+            help?: string | undefined;
+        } | {
+            type: "textarea";
+            label: string;
+            key: string;
+            required: boolean;
+            placeholder?: string | undefined;
+            defaultValue?: string | undefined;
+            help?: string | undefined;
+        } | {
+            type: "number";
+            label: string;
+            key: string;
+            required: boolean;
+            defaultValue?: number | undefined;
+            help?: string | undefined;
+        } | {
+            type: "boolean";
+            label: string;
+            key: string;
+            required: boolean;
+            defaultValue?: boolean | undefined;
+            help?: string | undefined;
+        } | {
+            options: {
+                value: string;
+                label: string;
+            }[];
+            type: "select";
+            label: string;
+            key: string;
+            required: boolean;
+            defaultValue?: string | undefined;
+            help?: string | undefined;
+        } | {
+            options: {
+                value: string;
+                label: string;
+            }[];
+            type: "multiselect";
+            label: string;
+            key: string;
+            required: boolean;
+            defaultValue?: string[] | undefined;
+            help?: string | undefined;
+        } | {
+            type: "date";
+            label: string;
+            key: string;
+            required: boolean;
+            defaultValue?: string | undefined;
+            help?: string | undefined;
+        })[];
+        submitLabel: string;
+        description?: string | undefined;
+        cancelLabel?: string | undefined;
+    }, {
+        title: string;
+        description?: string | undefined;
+        fields?: ({
+            type: "text";
+            label: string;
+            key: string;
+            placeholder?: string | undefined;
+            defaultValue?: string | undefined;
+            required?: boolean | undefined;
+            help?: string | undefined;
+        } | {
+            type: "textarea";
+            label: string;
+            key: string;
+            placeholder?: string | undefined;
+            defaultValue?: string | undefined;
+            required?: boolean | undefined;
+            help?: string | undefined;
+        } | {
+            type: "number";
+            label: string;
+            key: string;
+            defaultValue?: number | undefined;
+            required?: boolean | undefined;
+            help?: string | undefined;
+        } | {
+            type: "boolean";
+            label: string;
+            key: string;
+            defaultValue?: boolean | undefined;
+            required?: boolean | undefined;
+            help?: string | undefined;
+        } | {
+            options: {
+                value: string;
+                label: string;
+            }[];
+            type: "select";
+            label: string;
+            key: string;
+            defaultValue?: string | undefined;
+            required?: boolean | undefined;
+            help?: string | undefined;
+        } | {
+            options: {
+                value: string;
+                label: string;
+            }[];
+            type: "multiselect";
+            label: string;
+            key: string;
+            defaultValue?: string[] | undefined;
+            required?: boolean | undefined;
+            help?: string | undefined;
+        } | {
+            type: "date";
+            label: string;
+            key: string;
+            defaultValue?: string | undefined;
+            required?: boolean | undefined;
+            help?: string | undefined;
+        })[] | undefined;
+        submitLabel?: string | undefined;
+        cancelLabel?: string | undefined;
+    }>;
+    /** 是否阻塞等待人回填（true=问答；false=纯通知不等）。 */
+    blocking: z.ZodDefault<z.ZodBoolean>;
+    /** 关联 hookId（若由 HITL hook 触发，便于和 hook.resolve 合流）。 */
+    hookId: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    form: {
+        title: string;
+        fields: ({
+            type: "text";
+            label: string;
+            key: string;
+            required: boolean;
+            placeholder?: string | undefined;
+            defaultValue?: string | undefined;
+            help?: string | undefined;
+        } | {
+            type: "textarea";
+            label: string;
+            key: string;
+            required: boolean;
+            placeholder?: string | undefined;
+            defaultValue?: string | undefined;
+            help?: string | undefined;
+        } | {
+            type: "number";
+            label: string;
+            key: string;
+            required: boolean;
+            defaultValue?: number | undefined;
+            help?: string | undefined;
+        } | {
+            type: "boolean";
+            label: string;
+            key: string;
+            required: boolean;
+            defaultValue?: boolean | undefined;
+            help?: string | undefined;
+        } | {
+            options: {
+                value: string;
+                label: string;
+            }[];
+            type: "select";
+            label: string;
+            key: string;
+            required: boolean;
+            defaultValue?: string | undefined;
+            help?: string | undefined;
+        } | {
+            options: {
+                value: string;
+                label: string;
+            }[];
+            type: "multiselect";
+            label: string;
+            key: string;
+            required: boolean;
+            defaultValue?: string[] | undefined;
+            help?: string | undefined;
+        } | {
+            type: "date";
+            label: string;
+            key: string;
+            required: boolean;
+            defaultValue?: string | undefined;
+            help?: string | undefined;
+        })[];
+        submitLabel: string;
+        description?: string | undefined;
+        cancelLabel?: string | undefined;
+    };
+    blocking: boolean;
+    hookId?: string | undefined;
+}, {
+    form: {
+        title: string;
+        description?: string | undefined;
+        fields?: ({
+            type: "text";
+            label: string;
+            key: string;
+            placeholder?: string | undefined;
+            defaultValue?: string | undefined;
+            required?: boolean | undefined;
+            help?: string | undefined;
+        } | {
+            type: "textarea";
+            label: string;
+            key: string;
+            placeholder?: string | undefined;
+            defaultValue?: string | undefined;
+            required?: boolean | undefined;
+            help?: string | undefined;
+        } | {
+            type: "number";
+            label: string;
+            key: string;
+            defaultValue?: number | undefined;
+            required?: boolean | undefined;
+            help?: string | undefined;
+        } | {
+            type: "boolean";
+            label: string;
+            key: string;
+            defaultValue?: boolean | undefined;
+            required?: boolean | undefined;
+            help?: string | undefined;
+        } | {
+            options: {
+                value: string;
+                label: string;
+            }[];
+            type: "select";
+            label: string;
+            key: string;
+            defaultValue?: string | undefined;
+            required?: boolean | undefined;
+            help?: string | undefined;
+        } | {
+            options: {
+                value: string;
+                label: string;
+            }[];
+            type: "multiselect";
+            label: string;
+            key: string;
+            defaultValue?: string[] | undefined;
+            required?: boolean | undefined;
+            help?: string | undefined;
+        } | {
+            type: "date";
+            label: string;
+            key: string;
+            defaultValue?: string | undefined;
+            required?: boolean | undefined;
+            help?: string | undefined;
+        })[] | undefined;
+        submitLabel?: string | undefined;
+        cancelLabel?: string | undefined;
+    };
+    hookId?: string | undefined;
+    blocking?: boolean | undefined;
+}>;
+export type InteractionDirective = z.infer<typeof InteractionDirective>;
+export declare const InteractionRequestParams: z.ZodObject<{
+    /** 本次交互唯一 id，response 用它配对。 */
+    requestId: z.ZodString;
+    sessionId: z.ZodOptional<z.ZodBranded<z.ZodString, "SessionId">>;
+    turnId: z.ZodOptional<z.ZodString>;
+    form: z.ZodObject<{
+        title: z.ZodString;
+        /** 卡片正文/说明（可选）。 */
+        description: z.ZodOptional<z.ZodString>;
+        fields: z.ZodDefault<z.ZodArray<z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
+            type: z.ZodLiteral<"text">;
+            placeholder: z.ZodOptional<z.ZodString>;
+            defaultValue: z.ZodOptional<z.ZodString>;
+            key: z.ZodString;
+            label: z.ZodString;
+            required: z.ZodDefault<z.ZodBoolean>;
+            help: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            type: "text";
+            label: string;
+            key: string;
+            required: boolean;
+            placeholder?: string | undefined;
+            defaultValue?: string | undefined;
+            help?: string | undefined;
+        }, {
+            type: "text";
+            label: string;
+            key: string;
+            placeholder?: string | undefined;
+            defaultValue?: string | undefined;
+            required?: boolean | undefined;
+            help?: string | undefined;
+        }>, z.ZodObject<{
+            type: z.ZodLiteral<"textarea">;
+            placeholder: z.ZodOptional<z.ZodString>;
+            defaultValue: z.ZodOptional<z.ZodString>;
+            key: z.ZodString;
+            label: z.ZodString;
+            required: z.ZodDefault<z.ZodBoolean>;
+            help: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            type: "textarea";
+            label: string;
+            key: string;
+            required: boolean;
+            placeholder?: string | undefined;
+            defaultValue?: string | undefined;
+            help?: string | undefined;
+        }, {
+            type: "textarea";
+            label: string;
+            key: string;
+            placeholder?: string | undefined;
+            defaultValue?: string | undefined;
+            required?: boolean | undefined;
+            help?: string | undefined;
+        }>, z.ZodObject<{
+            type: z.ZodLiteral<"number">;
+            defaultValue: z.ZodOptional<z.ZodNumber>;
+            key: z.ZodString;
+            label: z.ZodString;
+            required: z.ZodDefault<z.ZodBoolean>;
+            help: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            type: "number";
+            label: string;
+            key: string;
+            required: boolean;
+            defaultValue?: number | undefined;
+            help?: string | undefined;
+        }, {
+            type: "number";
+            label: string;
+            key: string;
+            defaultValue?: number | undefined;
+            required?: boolean | undefined;
+            help?: string | undefined;
+        }>, z.ZodObject<{
+            type: z.ZodLiteral<"boolean">;
+            defaultValue: z.ZodOptional<z.ZodBoolean>;
+            key: z.ZodString;
+            label: z.ZodString;
+            required: z.ZodDefault<z.ZodBoolean>;
+            help: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            type: "boolean";
+            label: string;
+            key: string;
+            required: boolean;
+            defaultValue?: boolean | undefined;
+            help?: string | undefined;
+        }, {
+            type: "boolean";
+            label: string;
+            key: string;
+            defaultValue?: boolean | undefined;
+            required?: boolean | undefined;
+            help?: string | undefined;
+        }>, z.ZodObject<{
+            type: z.ZodLiteral<"select">;
+            options: z.ZodArray<z.ZodObject<{
+                label: z.ZodString;
+                value: z.ZodString;
+            }, "strip", z.ZodTypeAny, {
+                value: string;
+                label: string;
+            }, {
+                value: string;
+                label: string;
+            }>, "many">;
+            defaultValue: z.ZodOptional<z.ZodString>;
+            key: z.ZodString;
+            label: z.ZodString;
+            required: z.ZodDefault<z.ZodBoolean>;
+            help: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            options: {
+                value: string;
+                label: string;
+            }[];
+            type: "select";
+            label: string;
+            key: string;
+            required: boolean;
+            defaultValue?: string | undefined;
+            help?: string | undefined;
+        }, {
+            options: {
+                value: string;
+                label: string;
+            }[];
+            type: "select";
+            label: string;
+            key: string;
+            defaultValue?: string | undefined;
+            required?: boolean | undefined;
+            help?: string | undefined;
+        }>, z.ZodObject<{
+            type: z.ZodLiteral<"multiselect">;
+            options: z.ZodArray<z.ZodObject<{
+                label: z.ZodString;
+                value: z.ZodString;
+            }, "strip", z.ZodTypeAny, {
+                value: string;
+                label: string;
+            }, {
+                value: string;
+                label: string;
+            }>, "many">;
+            defaultValue: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+            key: z.ZodString;
+            label: z.ZodString;
+            required: z.ZodDefault<z.ZodBoolean>;
+            help: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            options: {
+                value: string;
+                label: string;
+            }[];
+            type: "multiselect";
+            label: string;
+            key: string;
+            required: boolean;
+            defaultValue?: string[] | undefined;
+            help?: string | undefined;
+        }, {
+            options: {
+                value: string;
+                label: string;
+            }[];
+            type: "multiselect";
+            label: string;
+            key: string;
+            defaultValue?: string[] | undefined;
+            required?: boolean | undefined;
+            help?: string | undefined;
+        }>, z.ZodObject<{
+            type: z.ZodLiteral<"date">;
+            defaultValue: z.ZodOptional<z.ZodString>;
+            key: z.ZodString;
+            label: z.ZodString;
+            required: z.ZodDefault<z.ZodBoolean>;
+            help: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            type: "date";
+            label: string;
+            key: string;
+            required: boolean;
+            defaultValue?: string | undefined;
+            help?: string | undefined;
+        }, {
+            type: "date";
+            label: string;
+            key: string;
+            defaultValue?: string | undefined;
+            required?: boolean | undefined;
+            help?: string | undefined;
+        }>]>, "many">>;
+        /** 提交/操作按钮；纯通知类可只放一个「知道了」。 */
+        submitLabel: z.ZodDefault<z.ZodString>;
+        cancelLabel: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        title: string;
+        fields: ({
+            type: "text";
+            label: string;
+            key: string;
+            required: boolean;
+            placeholder?: string | undefined;
+            defaultValue?: string | undefined;
+            help?: string | undefined;
+        } | {
+            type: "textarea";
+            label: string;
+            key: string;
+            required: boolean;
+            placeholder?: string | undefined;
+            defaultValue?: string | undefined;
+            help?: string | undefined;
+        } | {
+            type: "number";
+            label: string;
+            key: string;
+            required: boolean;
+            defaultValue?: number | undefined;
+            help?: string | undefined;
+        } | {
+            type: "boolean";
+            label: string;
+            key: string;
+            required: boolean;
+            defaultValue?: boolean | undefined;
+            help?: string | undefined;
+        } | {
+            options: {
+                value: string;
+                label: string;
+            }[];
+            type: "select";
+            label: string;
+            key: string;
+            required: boolean;
+            defaultValue?: string | undefined;
+            help?: string | undefined;
+        } | {
+            options: {
+                value: string;
+                label: string;
+            }[];
+            type: "multiselect";
+            label: string;
+            key: string;
+            required: boolean;
+            defaultValue?: string[] | undefined;
+            help?: string | undefined;
+        } | {
+            type: "date";
+            label: string;
+            key: string;
+            required: boolean;
+            defaultValue?: string | undefined;
+            help?: string | undefined;
+        })[];
+        submitLabel: string;
+        description?: string | undefined;
+        cancelLabel?: string | undefined;
+    }, {
+        title: string;
+        description?: string | undefined;
+        fields?: ({
+            type: "text";
+            label: string;
+            key: string;
+            placeholder?: string | undefined;
+            defaultValue?: string | undefined;
+            required?: boolean | undefined;
+            help?: string | undefined;
+        } | {
+            type: "textarea";
+            label: string;
+            key: string;
+            placeholder?: string | undefined;
+            defaultValue?: string | undefined;
+            required?: boolean | undefined;
+            help?: string | undefined;
+        } | {
+            type: "number";
+            label: string;
+            key: string;
+            defaultValue?: number | undefined;
+            required?: boolean | undefined;
+            help?: string | undefined;
+        } | {
+            type: "boolean";
+            label: string;
+            key: string;
+            defaultValue?: boolean | undefined;
+            required?: boolean | undefined;
+            help?: string | undefined;
+        } | {
+            options: {
+                value: string;
+                label: string;
+            }[];
+            type: "select";
+            label: string;
+            key: string;
+            defaultValue?: string | undefined;
+            required?: boolean | undefined;
+            help?: string | undefined;
+        } | {
+            options: {
+                value: string;
+                label: string;
+            }[];
+            type: "multiselect";
+            label: string;
+            key: string;
+            defaultValue?: string[] | undefined;
+            required?: boolean | undefined;
+            help?: string | undefined;
+        } | {
+            type: "date";
+            label: string;
+            key: string;
+            defaultValue?: string | undefined;
+            required?: boolean | undefined;
+            help?: string | undefined;
+        })[] | undefined;
+        submitLabel?: string | undefined;
+        cancelLabel?: string | undefined;
+    }>;
+    blocking: z.ZodDefault<z.ZodBoolean>;
+    /** 关联 hookId（HITL 场景）。 */
+    hookId: z.ZodOptional<z.ZodString>;
+    /**
+     * 可选超时（秒，P1-5）。超时后 phonon 以 timeout 收尾本次交互，agent 按预设继续。
+     * 0 或缺省 = 不超时（人可能去开会/带娃，长期挂起）。
+     */
+    timeoutSeconds: z.ZodOptional<z.ZodNumber>;
+    at: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    at: string;
+    form: {
+        title: string;
+        fields: ({
+            type: "text";
+            label: string;
+            key: string;
+            required: boolean;
+            placeholder?: string | undefined;
+            defaultValue?: string | undefined;
+            help?: string | undefined;
+        } | {
+            type: "textarea";
+            label: string;
+            key: string;
+            required: boolean;
+            placeholder?: string | undefined;
+            defaultValue?: string | undefined;
+            help?: string | undefined;
+        } | {
+            type: "number";
+            label: string;
+            key: string;
+            required: boolean;
+            defaultValue?: number | undefined;
+            help?: string | undefined;
+        } | {
+            type: "boolean";
+            label: string;
+            key: string;
+            required: boolean;
+            defaultValue?: boolean | undefined;
+            help?: string | undefined;
+        } | {
+            options: {
+                value: string;
+                label: string;
+            }[];
+            type: "select";
+            label: string;
+            key: string;
+            required: boolean;
+            defaultValue?: string | undefined;
+            help?: string | undefined;
+        } | {
+            options: {
+                value: string;
+                label: string;
+            }[];
+            type: "multiselect";
+            label: string;
+            key: string;
+            required: boolean;
+            defaultValue?: string[] | undefined;
+            help?: string | undefined;
+        } | {
+            type: "date";
+            label: string;
+            key: string;
+            required: boolean;
+            defaultValue?: string | undefined;
+            help?: string | undefined;
+        })[];
+        submitLabel: string;
+        description?: string | undefined;
+        cancelLabel?: string | undefined;
+    };
+    blocking: boolean;
+    requestId: string;
+    sessionId?: (string & z.BRAND<"SessionId">) | undefined;
+    turnId?: string | undefined;
+    hookId?: string | undefined;
+    timeoutSeconds?: number | undefined;
+}, {
+    at: string;
+    form: {
+        title: string;
+        description?: string | undefined;
+        fields?: ({
+            type: "text";
+            label: string;
+            key: string;
+            placeholder?: string | undefined;
+            defaultValue?: string | undefined;
+            required?: boolean | undefined;
+            help?: string | undefined;
+        } | {
+            type: "textarea";
+            label: string;
+            key: string;
+            placeholder?: string | undefined;
+            defaultValue?: string | undefined;
+            required?: boolean | undefined;
+            help?: string | undefined;
+        } | {
+            type: "number";
+            label: string;
+            key: string;
+            defaultValue?: number | undefined;
+            required?: boolean | undefined;
+            help?: string | undefined;
+        } | {
+            type: "boolean";
+            label: string;
+            key: string;
+            defaultValue?: boolean | undefined;
+            required?: boolean | undefined;
+            help?: string | undefined;
+        } | {
+            options: {
+                value: string;
+                label: string;
+            }[];
+            type: "select";
+            label: string;
+            key: string;
+            defaultValue?: string | undefined;
+            required?: boolean | undefined;
+            help?: string | undefined;
+        } | {
+            options: {
+                value: string;
+                label: string;
+            }[];
+            type: "multiselect";
+            label: string;
+            key: string;
+            defaultValue?: string[] | undefined;
+            required?: boolean | undefined;
+            help?: string | undefined;
+        } | {
+            type: "date";
+            label: string;
+            key: string;
+            defaultValue?: string | undefined;
+            required?: boolean | undefined;
+            help?: string | undefined;
+        })[] | undefined;
+        submitLabel?: string | undefined;
+        cancelLabel?: string | undefined;
+    };
+    requestId: string;
+    sessionId?: string | undefined;
+    turnId?: string | undefined;
+    hookId?: string | undefined;
+    blocking?: boolean | undefined;
+    timeoutSeconds?: number | undefined;
+}>;
+export type InteractionRequestParams = z.infer<typeof InteractionRequestParams>;
+/** 人机交互的生命周期状态（P1-5）：pending → submitted | cancelled | timeout。 */
+export declare const InteractionStatus: z.ZodEnum<["pending", "submitted", "cancelled", "timeout"]>;
+export type InteractionStatus = z.infer<typeof InteractionStatus>;
+/** 阻塞模式下，request 的最终结果（人填完后服务端回的）。 */
+export declare const InteractionRequestResult: z.ZodObject<{
+    requestId: z.ZodString;
+    /** 结果状态：submit | cancel | timeout。 */
+    action: z.ZodEnum<["submit", "cancel", "timeout"]>;
+    /** 提交时各字段值（key → 值）。 */
+    values: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<[z.ZodString, z.ZodArray<z.ZodString, "many">, z.ZodBoolean, z.ZodNumber]>>>;
+}, "strip", z.ZodTypeAny, {
+    action: "timeout" | "submit" | "cancel";
+    requestId: string;
+    values?: Record<string, string | number | boolean | string[]> | undefined;
+}, {
+    action: "timeout" | "submit" | "cancel";
+    requestId: string;
+    values?: Record<string, string | number | boolean | string[]> | undefined;
+}>;
+export type InteractionRequestResult = z.infer<typeof InteractionRequestResult>;
+export declare const InteractionCancelParams: z.ZodObject<{
+    requestId: z.ZodString;
+    reason: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    requestId: string;
+    reason?: string | undefined;
+}, {
+    requestId: string;
+    reason?: string | undefined;
+}>;
+export type InteractionCancelParams = z.infer<typeof InteractionCancelParams>;
+export declare const InteractionCancelResult: z.ZodObject<{
+    requestId: z.ZodString;
+    cancelled: z.ZodBoolean;
+}, "strip", z.ZodTypeAny, {
+    requestId: string;
+    cancelled: boolean;
+}, {
+    requestId: string;
+    cancelled: boolean;
+}>;
+export type InteractionCancelResult = z.infer<typeof InteractionCancelResult>;
+/**
+ * server → phonon 的回填（非阻塞模式或异步回填走这个 notification；
+ * 阻塞模式可直接用 interaction.request 的 result 返回，二选一，实现可都支持）。
+ */
+export declare const InteractionResponseParams: z.ZodObject<{
+    requestId: z.ZodString;
+    action: z.ZodEnum<["submit", "cancel", "timeout"]>;
+    values: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<[z.ZodString, z.ZodArray<z.ZodString, "many">, z.ZodBoolean, z.ZodNumber]>>>;
+    at: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    at: string;
+    action: "timeout" | "submit" | "cancel";
+    requestId: string;
+    values?: Record<string, string | number | boolean | string[]> | undefined;
+}, {
+    at: string;
+    action: "timeout" | "submit" | "cancel";
+    requestId: string;
+    values?: Record<string, string | number | boolean | string[]> | undefined;
+}>;
+export type InteractionResponseParams = z.infer<typeof InteractionResponseParams>;
+//# sourceMappingURL=interaction.d.ts.map