@capybara-hq/kernel 0.0.0-stage → 0.1.0-rc.1

package/dist/conversations/events.d.ts

@@ -0,0 +1,856 @@
+import { type ContentBlock, type MediaSource } from "@capybara-hq/plugin-sdk";
+import { z } from "zod";
+/** The longest deny reason (characters): the decision route's limit and `approval_decided.reason`'s. */
+export declare const APPROVAL_DENY_REASON_MAX_CHARS = 500;
+/** 一条 `media_excluded` 事件最多的附件数。 */
+export declare const MEDIA_EXCLUDED_MAX_IDS = 50;
+/** 一份 `skills_catalog` 快照最多的技能数（组织技能引用上限 100，余量给 agent 自己的技能）。 */
+export declare const SKILLS_CATALOG_MAX = 1000;
+/** The longest pinned skill body in a `skills_catalog` snapshot (the pinned total is ≤ 32768 bytes). */
+export declare const PINNED_BODY_MAX_CHARS = 32768;
+/** 产物名（`artifact_created.name`）是否合法：与日志 schema 同一规则（非空、≤255、不含控制字符）。 */
+export declare const isValidArtifactName: (name: string) => boolean;
+/**
+ * 日志里的内容块：plugin-sdk 的 `ContentBlock`，但 image / document 的 `source` 只能是 `ref`
+ * （写入时用这个 schema 校验，带 `base64` 的块被拒绝）。
+ */
+export declare const ContentBlockSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    type: z.ZodLiteral<"text">;
+    text: z.ZodString;
+    opaque: z.ZodOptional<z.ZodObject<{
+        provider: z.ZodString;
+        model: z.ZodString;
+        data: z.ZodUnknown;
+    }, z.core.$strip>>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"thinking">;
+    text: z.ZodString;
+    opaque: z.ZodOptional<z.ZodObject<{
+        provider: z.ZodString;
+        model: z.ZodString;
+        data: z.ZodUnknown;
+    }, z.core.$strip>>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"tool_call">;
+    id: z.ZodString;
+    name: z.ZodString;
+    input: z.ZodUnknown;
+    opaque: z.ZodOptional<z.ZodObject<{
+        provider: z.ZodString;
+        model: z.ZodString;
+        data: z.ZodUnknown;
+    }, z.core.$strip>>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"tool_result">;
+    callId: z.ZodString;
+    content: z.ZodString;
+    isError: z.ZodBoolean;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"image">;
+    mediaType: z.ZodEnum<{
+        "image/gif": "image/gif";
+        "image/jpeg": "image/jpeg";
+        "image/png": "image/png";
+        "image/webp": "image/webp";
+    }>;
+    source: z.ZodObject<{
+        kind: z.ZodLiteral<"ref">;
+        attachmentId: z.ZodString & z.ZodType<string, string, z.core.$ZodTypeInternals<string, string>>;
+    }, z.core.$strip>;
+    name: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"document">;
+    mediaType: z.ZodEnum<{
+        "application/pdf": "application/pdf";
+        "text/csv": "text/csv";
+        "text/markdown": "text/markdown";
+        "text/plain": "text/plain";
+    }>;
+    source: z.ZodObject<{
+        kind: z.ZodLiteral<"ref">;
+        attachmentId: z.ZodString & z.ZodType<string, string, z.core.$ZodTypeInternals<string, string>>;
+    }, z.core.$strip>;
+    name: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>], "type">;
+type MediaBlock = Extract<ContentBlock, {
+    type: "image" | "document";
+}>;
+/**
+ * 日志形状的内容块：与 plugin-sdk 的 `ContentBlock` 相同，只是媒体块的 `source` 收窄为 `ref`。
+ * 它是 `ContentBlock` 的子类型，所以从日志读出的块可直接当 `ContentBlock` 用（请求构建时再解析 ref）。
+ */
+export type LogContentBlock = Exclude<ContentBlock, MediaBlock> | (MediaBlock extends infer B ? B extends MediaBlock ? Omit<B, "source"> & {
+    source: Extract<MediaSource, {
+        kind: "ref";
+    }>;
+} : never : never);
+/**
+ * Structured view of a builtin tool's result (UI refresh B, spec §5.5 / §5.9): display only, like
+ * `display`. `command`: `sandbox_bash` (the model's `description`, the exit code, null when the
+ * command was stopped, and whether it timed out; the web shows "Failed" for a non-zero exit even
+ * though `isError` stays false); `edit`: `sandbox_edit` / `sandbox_write` (a capped line diff);
+ * `read`: `sandbox_read` (the line range shown).
+ */
+export declare const ToolViewSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    kind: z.ZodLiteral<"command">;
+    description: z.ZodOptional<z.ZodString>;
+    exitCode: z.ZodNullable<z.ZodNumber>;
+    timedOut: z.ZodBoolean;
+}, z.core.$strip>, z.ZodObject<{
+    kind: z.ZodLiteral<"edit">;
+    path: z.ZodString;
+    created: z.ZodBoolean;
+    added: z.ZodNumber;
+    removed: z.ZodNumber;
+    truncated: z.ZodBoolean;
+    hunks: z.ZodArray<z.ZodObject<{
+        oldStart: z.ZodNumber;
+        newStart: z.ZodNumber;
+        lines: z.ZodArray<z.ZodObject<{
+            kind: z.ZodEnum<{
+                add: "add";
+                ctx: "ctx";
+                del: "del";
+            }>;
+            text: z.ZodString;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
+}, z.core.$strip>, z.ZodObject<{
+    kind: z.ZodLiteral<"read">;
+    path: z.ZodString;
+    fromLine: z.ZodOptional<z.ZodNumber>;
+    toLine: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>], "kind">;
+export type ToolView = z.infer<typeof ToolViewSchema>;
+/**
+ * 会话事件（`type` + `payload`）的判别联合。事件日志只追加，写入前用它校验 payload；
+ * 读出时按写入时的形状原样返回。
+ */
+export declare const ConversationEventSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    type: z.ZodLiteral<"user_message">;
+    payload: z.ZodObject<{
+        content: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+            type: z.ZodLiteral<"text">;
+            text: z.ZodString;
+            opaque: z.ZodOptional<z.ZodObject<{
+                provider: z.ZodString;
+                model: z.ZodString;
+                data: z.ZodUnknown;
+            }, z.core.$strip>>;
+        }, z.core.$strip>, z.ZodObject<{
+            type: z.ZodLiteral<"thinking">;
+            text: z.ZodString;
+            opaque: z.ZodOptional<z.ZodObject<{
+                provider: z.ZodString;
+                model: z.ZodString;
+                data: z.ZodUnknown;
+            }, z.core.$strip>>;
+        }, z.core.$strip>, z.ZodObject<{
+            type: z.ZodLiteral<"tool_call">;
+            id: z.ZodString;
+            name: z.ZodString;
+            input: z.ZodUnknown;
+            opaque: z.ZodOptional<z.ZodObject<{
+                provider: z.ZodString;
+                model: z.ZodString;
+                data: z.ZodUnknown;
+            }, z.core.$strip>>;
+        }, z.core.$strip>, z.ZodObject<{
+            type: z.ZodLiteral<"tool_result">;
+            callId: z.ZodString;
+            content: z.ZodString;
+            isError: z.ZodBoolean;
+        }, z.core.$strip>, z.ZodObject<{
+            type: z.ZodLiteral<"image">;
+            mediaType: z.ZodEnum<{
+                "image/gif": "image/gif";
+                "image/jpeg": "image/jpeg";
+                "image/png": "image/png";
+                "image/webp": "image/webp";
+            }>;
+            source: z.ZodObject<{
+                kind: z.ZodLiteral<"ref">;
+                attachmentId: z.ZodString & z.ZodType<string, string, z.core.$ZodTypeInternals<string, string>>;
+            }, z.core.$strip>;
+            name: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>, z.ZodObject<{
+            type: z.ZodLiteral<"document">;
+            mediaType: z.ZodEnum<{
+                "application/pdf": "application/pdf";
+                "text/csv": "text/csv";
+                "text/markdown": "text/markdown";
+                "text/plain": "text/plain";
+            }>;
+            source: z.ZodObject<{
+                kind: z.ZodLiteral<"ref">;
+                attachmentId: z.ZodString & z.ZodType<string, string, z.core.$ZodTypeInternals<string, string>>;
+            }, z.core.$strip>;
+            name: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>], "type">>;
+        attachments: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            appId: z.ZodString;
+            appName: z.ZodString;
+            uri: z.ZodString;
+            name: z.ZodString;
+        }, z.core.$strip>>>;
+        authorAccountId: z.ZodString;
+        clientMessageId: z.ZodOptional<z.ZodString>;
+        retryOf: z.ZodOptional<z.ZodNumber>;
+        skill: z.ZodOptional<z.ZodObject<{
+            id: z.ZodString;
+            version: z.ZodNumber;
+            source: z.ZodString;
+            name: z.ZodString;
+            plugin: z.ZodOptional<z.ZodString>;
+            arguments: z.ZodString;
+            mode: z.ZodEnum<{
+                fork: "fork";
+                inline: "inline";
+            }>;
+            agentType: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+        dispatch: z.ZodOptional<z.ZodObject<{
+            parentConversationId: z.ZodString;
+            parentRunId: z.ZodString;
+            callId: z.ZodString;
+            narrowed: z.ZodOptional<z.ZodObject<{
+                tools: z.ZodArray<z.ZodPreprocess<z.ZodDiscriminatedUnion<[z.ZodObject<{
+                    kind: z.ZodLiteral<"builtin">;
+                    name: z.ZodString;
+                }, z.core.$strict>, z.ZodObject<{
+                    kind: z.ZodLiteral<"plugin">;
+                    plugin: z.ZodString;
+                    name: z.ZodString;
+                }, z.core.$strict>, z.ZodObject<{
+                    kind: z.ZodLiteral<"connector">;
+                    connectorId: z.ZodString;
+                    tools: z.ZodUnion<readonly [z.ZodLiteral<"all">, z.ZodArray<z.ZodString>]>;
+                }, z.core.$strict>], "kind">, unknown>>;
+                skills: z.ZodOptional<z.ZodObject<{
+                    orgSkills: z.ZodArray<z.ZodString>;
+                    pinned: z.ZodOptional<z.ZodArray<z.ZodString>>;
+                }, z.core.$strip>>;
+            }, z.core.$strip>>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"model_switched">;
+    payload: z.ZodObject<{
+        model: z.ZodNullable<z.ZodObject<{
+            provider: z.ZodString;
+            model: z.ZodString;
+        }, z.core.$strip>>;
+        effort: z.ZodNullable<z.ZodEnum<{
+            high: "high";
+            low: "low";
+            max: "max";
+            medium: "medium";
+            xhigh: "xhigh";
+        }>>;
+        byAccountId: z.ZodNullable<z.ZodString>;
+        reason: z.ZodEnum<{
+            unavailable: "unavailable";
+            user: "user";
+        }>;
+    }, z.core.$strip>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"run_started">;
+    payload: z.ZodObject<{
+        agentVersion: z.ZodNumber;
+        model: z.ZodObject<{
+            provider: z.ZodString;
+            model: z.ZodString;
+        }, z.core.$strip>;
+        triggerAccountId: z.ZodString;
+    }, z.core.$strip>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"model_call">;
+    payload: z.ZodObject<{
+        step: z.ZodNumber;
+        attempt: z.ZodNumber;
+        provider: z.ZodString;
+        model: z.ZodString;
+        fallback: z.ZodBoolean;
+        request: z.ZodObject<{
+            fromSeq: z.ZodNumber;
+            toSeq: z.ZodNumber;
+            summarySeq: z.ZodNullable<z.ZodNumber>;
+            systemHash: z.ZodString;
+            reminderSeqs: z.ZodArray<z.ZodNumber>;
+            maxOutputTokens: z.ZodOptional<z.ZodNumber>;
+            params: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>>>;
+            droppedParams: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            estimatedInputTokens: z.ZodOptional<z.ZodNumber>;
+            absorbedUpToSeq: z.ZodOptional<z.ZodNumber>;
+            tools: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                key: z.ZodString;
+                specHash: z.ZodString;
+            }, z.core.$strip>>>;
+            catalog: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                key: z.ZodString;
+                specHash: z.ZodString;
+            }, z.core.$strip>>>;
+            toolChoice: z.ZodOptional<z.ZodEnum<{
+                auto: "auto";
+                none: "none";
+            }>>;
+            media: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                attachmentId: z.ZodString & z.ZodType<string, string, z.core.$ZodTypeInternals<string, string>>;
+                outcome: z.ZodEnum<{
+                    bytes: "bytes";
+                    excluded: "excluded";
+                    inline: "inline";
+                    omitted: "omitted";
+                    placeholder_unsupported: "placeholder_unsupported";
+                    too_large: "too_large";
+                    too_many_images: "too_many_images";
+                    too_many_pages: "too_many_pages";
+                    unavailable: "unavailable";
+                }>;
+                etag: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>>>;
+            mediaBudgetBytes: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strip>;
+    }, z.core.$strip>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"assistant_message">;
+    payload: z.ZodObject<{
+        step: z.ZodNumber;
+        content: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+            type: z.ZodLiteral<"text">;
+            text: z.ZodString;
+            opaque: z.ZodOptional<z.ZodObject<{
+                provider: z.ZodString;
+                model: z.ZodString;
+                data: z.ZodUnknown;
+            }, z.core.$strip>>;
+        }, z.core.$strip>, z.ZodObject<{
+            type: z.ZodLiteral<"thinking">;
+            text: z.ZodString;
+            opaque: z.ZodOptional<z.ZodObject<{
+                provider: z.ZodString;
+                model: z.ZodString;
+                data: z.ZodUnknown;
+            }, z.core.$strip>>;
+        }, z.core.$strip>, z.ZodObject<{
+            type: z.ZodLiteral<"tool_call">;
+            id: z.ZodString;
+            name: z.ZodString;
+            input: z.ZodUnknown;
+            opaque: z.ZodOptional<z.ZodObject<{
+                provider: z.ZodString;
+                model: z.ZodString;
+                data: z.ZodUnknown;
+            }, z.core.$strip>>;
+        }, z.core.$strip>, z.ZodObject<{
+            type: z.ZodLiteral<"tool_result">;
+            callId: z.ZodString;
+            content: z.ZodString;
+            isError: z.ZodBoolean;
+        }, z.core.$strip>, z.ZodObject<{
+            type: z.ZodLiteral<"image">;
+            mediaType: z.ZodEnum<{
+                "image/gif": "image/gif";
+                "image/jpeg": "image/jpeg";
+                "image/png": "image/png";
+                "image/webp": "image/webp";
+            }>;
+            source: z.ZodObject<{
+                kind: z.ZodLiteral<"ref">;
+                attachmentId: z.ZodString & z.ZodType<string, string, z.core.$ZodTypeInternals<string, string>>;
+            }, z.core.$strip>;
+            name: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>, z.ZodObject<{
+            type: z.ZodLiteral<"document">;
+            mediaType: z.ZodEnum<{
+                "application/pdf": "application/pdf";
+                "text/csv": "text/csv";
+                "text/markdown": "text/markdown";
+                "text/plain": "text/plain";
+            }>;
+            source: z.ZodObject<{
+                kind: z.ZodLiteral<"ref">;
+                attachmentId: z.ZodString & z.ZodType<string, string, z.core.$ZodTypeInternals<string, string>>;
+            }, z.core.$strip>;
+            name: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>], "type">>;
+        stopReason: z.ZodEnum<{
+            aborted: "aborted";
+            end_turn: "end_turn";
+            max_tokens: "max_tokens";
+            other: "other";
+            refusal: "refusal";
+            tool_use: "tool_use";
+        }>;
+    }, z.core.$strip>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"usage">;
+    payload: z.ZodObject<{
+        inputTokens: z.ZodNumber;
+        outputTokens: z.ZodNumber;
+        cacheReadTokens: z.ZodNumber;
+        cacheWriteTokens: z.ZodNumber;
+        step: z.ZodNumber;
+        provider: z.ZodString;
+        model: z.ZodString;
+        purpose: z.ZodOptional<z.ZodEnum<{
+            compaction: "compaction";
+            title: "title";
+        }>>;
+    }, z.core.$strip>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"reminder">;
+    payload: z.ZodObject<{
+        step: z.ZodNumber;
+        text: z.ZodString;
+    }, z.core.$strip>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"tool_call_started">;
+    payload: z.ZodObject<{
+        step: z.ZodNumber;
+        callId: z.ZodString;
+        toolKey: z.ZodString;
+        specHash: z.ZodString;
+    }, z.core.$strip>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"tool_result">;
+    payload: z.ZodObject<{
+        step: z.ZodNumber;
+        callId: z.ZodString;
+        toolKey: z.ZodString;
+        content: z.ZodString;
+        isError: z.ZodBoolean;
+        outputId: z.ZodOptional<z.ZodString>;
+        contentTypes: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        loadedTools: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        display: z.ZodOptional<z.ZodObject<{
+            summary: z.ZodObject<{
+                zh: z.ZodString;
+                en: z.ZodString;
+            }, z.core.$strip>;
+        }, z.core.$strip>>;
+        view: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
+            kind: z.ZodLiteral<"command">;
+            description: z.ZodOptional<z.ZodString>;
+            exitCode: z.ZodNullable<z.ZodNumber>;
+            timedOut: z.ZodBoolean;
+        }, z.core.$strip>, z.ZodObject<{
+            kind: z.ZodLiteral<"edit">;
+            path: z.ZodString;
+            created: z.ZodBoolean;
+            added: z.ZodNumber;
+            removed: z.ZodNumber;
+            truncated: z.ZodBoolean;
+            hunks: z.ZodArray<z.ZodObject<{
+                oldStart: z.ZodNumber;
+                newStart: z.ZodNumber;
+                lines: z.ZodArray<z.ZodObject<{
+                    kind: z.ZodEnum<{
+                        add: "add";
+                        ctx: "ctx";
+                        del: "del";
+                    }>;
+                    text: z.ZodString;
+                }, z.core.$strip>>;
+            }, z.core.$strip>>;
+        }, z.core.$strip>, z.ZodObject<{
+            kind: z.ZodLiteral<"read">;
+            path: z.ZodString;
+            fromLine: z.ZodOptional<z.ZodNumber>;
+            toLine: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strip>], "kind">>;
+        card: z.ZodOptional<z.ZodObject<{
+            plugin: z.ZodString;
+            view: z.ZodString;
+            key: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"connection_required">;
+    payload: z.ZodObject<{
+        step: z.ZodNumber;
+        callId: z.ZodString;
+        appId: z.ZodString;
+        appName: z.ZodString;
+    }, z.core.$strip>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"approval_requested">;
+    payload: z.ZodObject<{
+        step: z.ZodNumber;
+        callId: z.ZodString;
+        approvalId: z.ZodString;
+        toolKey: z.ZodString;
+        expiresAt: z.ZodString;
+        policy: z.ZodOptional<z.ZodEnum<{
+            agent: "agent";
+            connector: "connector";
+            default: "default";
+            fixed: "fixed";
+            org: "org";
+            role: "role";
+        }>>;
+    }, z.core.$strip>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"approval_decided">;
+    payload: z.ZodObject<{
+        approvalId: z.ZodString;
+        callId: z.ZodString;
+        decision: z.ZodEnum<{
+            approved: "approved";
+            cancelled: "cancelled";
+            denied: "denied";
+            expired: "expired";
+        }>;
+        scope: z.ZodOptional<z.ZodEnum<{
+            always: "always";
+            once: "once";
+            session: "session";
+        }>>;
+        byAccountId: z.ZodNullable<z.ZodString>;
+        reason: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"question_asked">;
+    payload: z.ZodObject<{
+        step: z.ZodNumber;
+        callId: z.ZodString;
+        questionId: z.ZodString;
+        form: z.ZodObject<{
+            title: z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+                zh: z.ZodString;
+                en: z.ZodString;
+            }, z.core.$strip>]>;
+            url: z.ZodOptional<z.ZodString>;
+            fields: z.ZodArray<z.ZodObject<{
+                key: z.ZodString;
+                label: z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+                    zh: z.ZodString;
+                    en: z.ZodString;
+                }, z.core.$strip>]>;
+                description: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+                    zh: z.ZodString;
+                    en: z.ZodString;
+                }, z.core.$strip>]>>;
+                schema: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+                multiSelect: z.ZodOptional<z.ZodBoolean>;
+                allowOther: z.ZodOptional<z.ZodBoolean>;
+                required: z.ZodOptional<z.ZodBoolean>;
+            }, z.core.$strip>>;
+        }, z.core.$strip>;
+        expiresAt: z.ZodString;
+    }, z.core.$strip>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"question_answered">;
+    payload: z.ZodObject<{
+        questionId: z.ZodString;
+        callId: z.ZodString;
+        answer: z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodArray<z.ZodString>]>>>;
+        byAccountId: z.ZodNullable<z.ZodString>;
+        outcome: z.ZodEnum<{
+            answered: "answered";
+            cancelled: "cancelled";
+            expired: "expired";
+        }>;
+    }, z.core.$strip>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"media_excluded">;
+    payload: z.ZodObject<{
+        attachmentIds: z.ZodArray<z.ZodString & z.ZodType<string, string, z.core.$ZodTypeInternals<string, string>>>;
+        reason: z.ZodEnum<{
+            provider_rejected: "provider_rejected";
+        }>;
+    }, z.core.$strip>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"artifact_created">;
+    payload: z.ZodObject<{
+        artifactId: z.ZodUUID;
+        name: z.ZodString;
+        contentType: z.ZodString;
+        size: z.ZodNumber;
+        objectKey: z.ZodString;
+        sourcePath: z.ZodString;
+        callId: z.ZodString;
+    }, z.core.$strip>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"skills_catalog">;
+    payload: z.ZodObject<{
+        skills: z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            name: z.ZodString & z.ZodType<string, string, z.core.$ZodTypeInternals<string, string>>;
+            description: z.ZodString;
+            version: z.ZodNumber;
+            source: z.ZodString;
+            plugin: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+        pinned: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            version: z.ZodNumber;
+            name: z.ZodString & z.ZodType<string, string, z.core.$ZodTypeInternals<string, string>>;
+            source: z.ZodString;
+            body: z.ZodString;
+        }, z.core.$strip>>>;
+        toolMap: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"hook_denied">;
+    payload: z.ZodObject<{
+        mount: z.ZodEnum<{
+            "model.request": "model.request";
+            "tool.preExecute": "tool.preExecute";
+        }>;
+        plugin: z.ZodString;
+        reason: z.ZodString;
+        cause: z.ZodEnum<{
+            deny: "deny";
+            hook_error: "hook_error";
+            timeout: "timeout";
+        }>;
+        step: z.ZodNumber;
+        attempt: z.ZodOptional<z.ZodNumber>;
+        callId: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"subagent_started">;
+    payload: z.ZodObject<{
+        parent: z.ZodObject<{
+            conversationId: z.ZodString;
+            runId: z.ZodString;
+            callId: z.ZodString;
+            step: z.ZodNumber;
+        }, z.core.$strip>;
+        agentType: z.ZodString;
+        template: z.ZodObject<{
+            source: z.ZodEnum<{
+                agent: "agent";
+                general: "general";
+                inline: "inline";
+                plugin: "plugin";
+            }>;
+            id: z.ZodOptional<z.ZodString>;
+            version: z.ZodOptional<z.ZodNumber>;
+            plugin: z.ZodOptional<z.ZodString>;
+            invokedSkill: z.ZodOptional<z.ZodObject<{
+                id: z.ZodString;
+                version: z.ZodNumber;
+                name: z.ZodString;
+            }, z.core.$strip>>;
+        }, z.core.$strip>;
+        definition: z.ZodObject<{
+            name: z.ZodString;
+            avatarUrl: z.ZodDefault<z.ZodNullable<z.ZodURL>>;
+            instructions: z.ZodDefault<z.ZodString>;
+            model: z.ZodObject<{
+                provider: z.ZodString;
+                model: z.ZodString;
+            }, z.core.$strip>;
+            fallback: z.ZodDefault<z.ZodNullable<z.ZodObject<{
+                provider: z.ZodString;
+                model: z.ZodString;
+            }, z.core.$strip>>>;
+            modelParams: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>>>;
+            fallbackParams: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>>>;
+            tools: z.ZodDefault<z.ZodArray<z.ZodPreprocess<z.ZodDiscriminatedUnion<[z.ZodObject<{
+                kind: z.ZodLiteral<"builtin">;
+                name: z.ZodString;
+            }, z.core.$strict>, z.ZodObject<{
+                kind: z.ZodLiteral<"plugin">;
+                plugin: z.ZodString;
+                name: z.ZodString;
+            }, z.core.$strict>, z.ZodObject<{
+                kind: z.ZodLiteral<"connector">;
+                connectorId: z.ZodString;
+                tools: z.ZodUnion<readonly [z.ZodLiteral<"all">, z.ZodArray<z.ZodString>]>;
+            }, z.core.$strict>], "kind">, unknown>>>;
+            toolPolicies: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodEnum<{
+                ask: "ask";
+                deny: "deny";
+            }>>>;
+            skills: z.ZodOptional<z.ZodObject<{
+                orgSkills: z.ZodDefault<z.ZodArray<z.ZodString>>;
+                writePolicy: z.ZodOptional<z.ZodEnum<{
+                    allow: "allow";
+                    ask: "ask";
+                }>>;
+                pinned: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            }, z.core.$strict>>;
+            subagents: z.ZodOptional<z.ZodObject<{
+                general: z.ZodOptional<z.ZodBoolean>;
+                templates: z.ZodOptional<z.ZodArray<z.ZodString>>;
+                inline: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                    name: z.ZodString;
+                    description: z.ZodString;
+                    instructions: z.ZodString;
+                    tools: z.ZodOptional<z.ZodArray<z.ZodString>>;
+                    disallowedTools: z.ZodOptional<z.ZodArray<z.ZodString>>;
+                    toolPolicies: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodEnum<{
+                        ask: "ask";
+                        deny: "deny";
+                    }>>>;
+                    model: z.ZodOptional<z.ZodEnum<{
+                        capable: "capable";
+                        fast: "fast";
+                        inherit: "inherit";
+                        standard: "standard";
+                    }>>;
+                    effort: z.ZodOptional<z.ZodEnum<{
+                        high: "high";
+                        low: "low";
+                        max: "max";
+                        medium: "medium";
+                        xhigh: "xhigh";
+                    }>>;
+                    maxSteps: z.ZodOptional<z.ZodNumber>;
+                    skills: z.ZodOptional<z.ZodArray<z.ZodString>>;
+                }, z.core.$strict>>>;
+                agents: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                    agentId: z.ZodString;
+                    as: z.ZodString;
+                    description: z.ZodString;
+                }, z.core.$strict>>>;
+                dispatchable: z.ZodOptional<z.ZodBoolean>;
+            }, z.core.$strict>>;
+        }, z.core.$strip>;
+        preamble: z.ZodString;
+        maxSteps: z.ZodNumber;
+        warnings: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    }, z.core.$strip>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"subagent_dispatched">;
+    payload: z.ZodObject<{
+        step: z.ZodNumber;
+        callId: z.ZodString;
+        subagentId: z.ZodString;
+        childRunId: z.ZodString;
+        agentType: z.ZodString;
+        description: z.ZodString;
+        resumed: z.ZodBoolean;
+        model: z.ZodObject<{
+            provider: z.ZodString;
+            model: z.ZodString;
+        }, z.core.$strip>;
+        tierFallback: z.ZodOptional<z.ZodBoolean>;
+        invokedSeq: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"subagent_waiting">;
+    payload: z.ZodObject<{
+        subagentId: z.ZodString;
+        childRunId: z.ZodString;
+        kind: z.ZodEnum<{
+            approval: "approval";
+            connect: "connect";
+            input: "input";
+        }>;
+        approvalId: z.ZodOptional<z.ZodString>;
+        questionId: z.ZodOptional<z.ZodString>;
+        toolKey: z.ZodString;
+        expiresAt: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"subagent_finished">;
+    payload: z.ZodObject<{
+        subagentId: z.ZodString;
+        childRunId: z.ZodString;
+        callId: z.ZodString;
+        status: z.ZodEnum<{
+            aborted: "aborted";
+            budget: "budget";
+            completed: "completed";
+            failed: "failed";
+            max_duration: "max_duration";
+            max_steps: "max_steps";
+            timed_out: "timed_out";
+        }>;
+        errorCode: z.ZodOptional<z.ZodString>;
+        toolCalls: z.ZodNumber;
+        durationMs: z.ZodNumber;
+        usage: z.ZodObject<{
+            inputTokens: z.ZodNumber;
+            outputTokens: z.ZodNumber;
+            cacheReadTokens: z.ZodNumber;
+            cacheWriteTokens: z.ZodNumber;
+        }, z.core.$strip>;
+    }, z.core.$strip>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"skill_fork_result">;
+    payload: z.ZodObject<{
+        invokedSeq: z.ZodNumber;
+        subagentId: z.ZodOptional<z.ZodString>;
+        childRunId: z.ZodOptional<z.ZodString>;
+        text: z.ZodString;
+    }, z.core.$strip>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"compaction_summary">;
+    payload: z.ZodObject<{
+        coversUpToSeq: z.ZodNumber;
+        text: z.ZodString;
+    }, z.core.$strip>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"compaction_failed">;
+    payload: z.ZodObject<{
+        attempt: z.ZodNumber;
+        reason: z.ZodString;
+    }, z.core.$strip>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"run_finished">;
+    payload: z.ZodObject<{
+        reason: z.ZodEnum<{
+            budget: "budget";
+            completed: "completed";
+            max_duration: "max_duration";
+            max_steps: "max_steps";
+        }>;
+        consumedUpToSeq: z.ZodNumber;
+    }, z.core.$strip>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"run_failed">;
+    payload: z.ZodObject<{
+        error: z.ZodObject<{
+            code: z.ZodString;
+            message: z.ZodString;
+        }, z.core.$strip>;
+    }, z.core.$strip>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"run_aborted">;
+    payload: z.ZodObject<{
+        byAccountId: z.ZodNullable<z.ZodString>;
+        reason: z.ZodEnum<{
+            eval_stopped: "eval_stopped";
+            shutdown_exhausted: "shutdown_exhausted";
+            user: "user";
+        }>;
+        detail: z.ZodOptional<z.ZodEnum<{
+            cancelled: "cancelled";
+            capped: "capped";
+            claim_lost: "claim_lost";
+            shutdown: "shutdown";
+            too_many_errors: "too_many_errors";
+            wait_timeout: "wait_timeout";
+        }>>;
+    }, z.core.$strip>;
+}, z.core.$strip>], "type">;
+/** 事件体：`{ type, payload }` 的判别联合。 */
+export type ConversationEventBody = z.infer<typeof ConversationEventSchema>;
+export type ConversationEventType = ConversationEventBody["type"];
+/** 已写入日志的事件。 */
+export type ConversationEvent = ConversationEventBody & {
+    conversationId: string;
+    seq: number;
+    runId: string | null;
+    createdAt: Date;
+};
+/**
+ * What the person typed for a skill invocation (phase D): `/<plugin>:<name> <arguments>` (no
+ * plugin: `/<name>`). Titles and eval case titles use it instead of the rendered skill in
+ * `content[0]`.
+ */
+export declare const typedInvocation: (skill: {
+    name: string;
+    plugin?: string | undefined;
+    arguments: string;
+}) => string;
+/** 某类事件的 payload。 */
+export type EventPayload<T extends ConversationEventType> = Extract<ConversationEventBody, {
+    type: T;
+}>["payload"];
+export {};