@capybara-hq/kernel 0.1.0-rc.2 → 0.1.0-rc.21

package/dist/conversations/events.d.ts

@@ -86,10 +86,10 @@ export type LogContentBlock = Exclude<ContentBlock, MediaBlock> | (MediaBlock ex
 } : 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
+ * `display`. `command`: `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).
+ * though `isError` stays false); `edit`: `Edit` / `Write` (a capped line diff);
+ * `read`: `Read` (the line range shown).
  */
 export declare const ToolViewSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     kind: z.ZodLiteral<"command">;
@@ -103,6 +103,11 @@ export declare const ToolViewSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     added: z.ZodNumber;
     removed: z.ZodNumber;
     truncated: z.ZodBoolean;
+    file: z.ZodOptional<z.ZodObject<{
+        path: z.ZodString;
+        size: z.ZodNumber;
+        sha256: z.ZodString;
+    }, z.core.$strip>>;
     hunks: z.ZodArray<z.ZodObject<{
         oldStart: z.ZodNumber;
         newStart: z.ZodNumber;
@@ -120,8 +125,59 @@ export declare const ToolViewSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     path: z.ZodString;
     fromLine: z.ZodOptional<z.ZodNumber>;
     toLine: z.ZodOptional<z.ZodNumber>;
+    file: z.ZodOptional<z.ZodObject<{
+        path: z.ZodString;
+        size: z.ZodNumber;
+        sha256: z.ZodString;
+    }, z.core.$strip>>;
 }, z.core.$strip>], "kind">;
 export type ToolView = z.infer<typeof ToolViewSchema>;
+/**
+ * How a sub-agent's run ended (`subagent_finished`, a `subagent_delivery` finish). `timed_out`:
+ * stopped by the parent's sub-agents wait timeout (`run_aborted.detail`).
+ */
+export declare const SubagentFinishStatusSchema: z.ZodEnum<{
+    aborted: "aborted";
+    budget: "budget";
+    completed: "completed";
+    failed: "failed";
+    max_duration: "max_duration";
+    max_steps: "max_steps";
+    timed_out: "timed_out";
+}>;
+/** The languages a run context names (the org `locale` values). */
+export declare const RUN_CONTEXT_LOCALES: readonly ["zh", "en"];
+/** `user_message.sender` (run context spec §3.2). */
+export declare const MessageSenderSchema: z.ZodObject<{
+    name: z.ZodString;
+    role: z.ZodOptional<z.ZodEnum<{
+        admin: "admin";
+        guest: "guest";
+        member: "member";
+        owner: "owner";
+    }>>;
+    anonymous: z.ZodOptional<z.ZodLiteral<true>>;
+}, z.core.$strip>;
+/** `run_context` (run context spec §3.1): every field optional, a later event holds changes only. */
+export declare const RunContextSchema: z.ZodObject<{
+    agent: z.ZodOptional<z.ZodObject<{
+        name: z.ZodString;
+        description: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    org: z.ZodOptional<z.ZodObject<{
+        name: z.ZodString;
+    }, z.core.$strip>>;
+    date: z.ZodOptional<z.ZodString>;
+    timeZone: z.ZodOptional<z.ZodString>;
+    locale: z.ZodOptional<z.ZodEnum<{
+        en: "en";
+        zh: "zh";
+    }>>;
+    dispatchedBy: z.ZodOptional<z.ZodObject<{
+        agent: z.ZodString;
+        person: z.ZodString;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
 /**
  * 会话事件（`type` + `payload`）的判别联合。事件日志只追加，写入前用它校验 payload；
  * 读出时按写入时的形状原样返回。
@@ -194,6 +250,21 @@ export declare const ConversationEventSchema: z.ZodDiscriminatedUnion<[z.ZodObje
             name: z.ZodString;
         }, z.core.$strip>>>;
         authorAccountId: z.ZodString;
+        sender: z.ZodOptional<z.ZodObject<{
+            name: z.ZodString;
+            role: z.ZodOptional<z.ZodEnum<{
+                admin: "admin";
+                guest: "guest";
+                member: "member";
+                owner: "owner";
+            }>>;
+            anonymous: z.ZodOptional<z.ZodLiteral<true>>;
+        }, z.core.$strip>>;
+        timeZone: z.ZodOptional<z.ZodString>;
+        locale: z.ZodOptional<z.ZodEnum<{
+            en: "en";
+            zh: "zh";
+        }>>;
         clientMessageId: z.ZodOptional<z.ZodString>;
         retryOf: z.ZodOptional<z.ZodNumber>;
         skill: z.ZodOptional<z.ZodObject<{
@@ -213,19 +284,23 @@ export declare const ConversationEventSchema: z.ZodDiscriminatedUnion<[z.ZodObje
             parentConversationId: z.ZodString;
             parentRunId: z.ZodString;
             callId: z.ZodString;
+            kind: z.ZodOptional<z.ZodEnum<{
+                message: "message";
+                task: "task";
+            }>>;
             narrowed: z.ZodOptional<z.ZodObject<{
-                tools: z.ZodArray<z.ZodPreprocess<z.ZodDiscriminatedUnion<[z.ZodObject<{
+                disabledTools: z.ZodOptional<z.ZodArray<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;
+                    tools: z.ZodUnion<readonly [z.ZodLiteral<"all">, z.ZodArray<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>>;
+                }, z.core.$strict>], "kind">>>;
                 skills: z.ZodOptional<z.ZodObject<{
                     orgSkills: z.ZodArray<z.ZodString>;
                     pinned: z.ZodOptional<z.ZodArray<z.ZodString>>;
@@ -262,6 +337,12 @@ export declare const ConversationEventSchema: z.ZodDiscriminatedUnion<[z.ZodObje
             model: z.ZodString;
         }, z.core.$strip>;
         triggerAccountId: z.ZodString;
+        trigger: z.ZodOptional<z.ZodEnum<{
+            background_task: "background_task";
+            message: "message";
+            subagent: "subagent";
+        }>>;
+        triggerSeq: z.ZodOptional<z.ZodNumber>;
     }, z.core.$strip>;
 }, z.core.$strip>, z.ZodObject<{
     type: z.ZodLiteral<"model_call">;
@@ -396,7 +477,9 @@ export declare const ConversationEventSchema: z.ZodDiscriminatedUnion<[z.ZodObje
         purpose: z.ZodOptional<z.ZodEnum<{
             compaction: "compaction";
             title: "title";
+            web_fetch: "web_fetch";
         }>>;
+        callId: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>;
 }, z.core.$strip>, z.ZodObject<{
     type: z.ZodLiteral<"reminder">;
@@ -404,6 +487,43 @@ export declare const ConversationEventSchema: z.ZodDiscriminatedUnion<[z.ZodObje
         step: z.ZodNumber;
         text: z.ZodString;
     }, z.core.$strip>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"run_context">;
+    payload: z.ZodObject<{
+        agent: z.ZodOptional<z.ZodObject<{
+            name: z.ZodString;
+            description: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+        org: z.ZodOptional<z.ZodObject<{
+            name: z.ZodString;
+        }, z.core.$strip>>;
+        date: z.ZodOptional<z.ZodString>;
+        timeZone: z.ZodOptional<z.ZodString>;
+        locale: z.ZodOptional<z.ZodEnum<{
+            en: "en";
+            zh: "zh";
+        }>>;
+        dispatchedBy: z.ZodOptional<z.ZodObject<{
+            agent: z.ZodString;
+            person: z.ZodString;
+        }, z.core.$strip>>;
+    }, z.core.$strip>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"tools_changed">;
+    payload: z.ZodObject<{
+        step: z.ZodNumber;
+        added: z.ZodArray<z.ZodString>;
+        removed: z.ZodArray<z.ZodString>;
+    }, z.core.$strip>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"device_paths">;
+    payload: z.ZodObject<{
+        roots: z.ZodObject<{
+            workspace: z.ZodString;
+            skills: z.ZodString;
+            tmp: z.ZodString;
+        }, z.core.$strip>;
+    }, z.core.$strip>;
 }, z.core.$strip>, z.ZodObject<{
     type: z.ZodLiteral<"tool_call_started">;
     payload: z.ZodObject<{
@@ -441,6 +561,11 @@ export declare const ConversationEventSchema: z.ZodDiscriminatedUnion<[z.ZodObje
             added: z.ZodNumber;
             removed: z.ZodNumber;
             truncated: z.ZodBoolean;
+            file: z.ZodOptional<z.ZodObject<{
+                path: z.ZodString;
+                size: z.ZodNumber;
+                sha256: z.ZodString;
+            }, z.core.$strip>>;
             hunks: z.ZodArray<z.ZodObject<{
                 oldStart: z.ZodNumber;
                 newStart: z.ZodNumber;
@@ -458,6 +583,11 @@ export declare const ConversationEventSchema: z.ZodDiscriminatedUnion<[z.ZodObje
             path: z.ZodString;
             fromLine: z.ZodOptional<z.ZodNumber>;
             toLine: z.ZodOptional<z.ZodNumber>;
+            file: z.ZodOptional<z.ZodObject<{
+                path: z.ZodString;
+                size: z.ZodNumber;
+                sha256: z.ZodString;
+            }, z.core.$strip>>;
         }, z.core.$strip>], "kind">>;
         card: z.ZodOptional<z.ZodObject<{
             plugin: z.ZodString;
@@ -476,6 +606,13 @@ export declare const ConversationEventSchema: z.ZodDiscriminatedUnion<[z.ZodObje
 }, z.core.$strip>, z.ZodObject<{
     type: z.ZodLiteral<"approval_requested">;
     payload: z.ZodObject<{
+        requestedFor: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        approverRole: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
+            admin: "admin";
+            guest: "guest";
+            member: "member";
+            owner: "owner";
+        }>>>;
         step: z.ZodNumber;
         callId: z.ZodString;
         approvalId: z.ZodString;
@@ -550,7 +687,9 @@ export declare const ConversationEventSchema: z.ZodDiscriminatedUnion<[z.ZodObje
             answered: "answered";
             cancelled: "cancelled";
             expired: "expired";
+            skipped: "skipped";
         }>;
+        skippedBySeq: z.ZodOptional<z.ZodNumber>;
     }, z.core.$strip>;
 }, z.core.$strip>, z.ZodObject<{
     type: z.ZodLiteral<"media_excluded">;
@@ -629,6 +768,7 @@ export declare const ConversationEventSchema: z.ZodDiscriminatedUnion<[z.ZodObje
             id: z.ZodOptional<z.ZodString>;
             version: z.ZodOptional<z.ZodNumber>;
             plugin: z.ZodOptional<z.ZodString>;
+            platformTemplateId: z.ZodOptional<z.ZodString>;
             invokedSkill: z.ZodOptional<z.ZodObject<{
                 id: z.ZodString;
                 version: z.ZodNumber;
@@ -637,8 +777,13 @@ export declare const ConversationEventSchema: z.ZodDiscriminatedUnion<[z.ZodObje
         }, z.core.$strip>;
         definition: z.ZodObject<{
             name: z.ZodString;
+            description: z.ZodOptional<z.ZodString>;
             avatarUrl: z.ZodDefault<z.ZodNullable<z.ZodURL>>;
             instructions: z.ZodDefault<z.ZodString>;
+            instructionFiles: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                name: z.ZodString;
+                content: z.ZodString;
+            }, z.core.$strict>>>;
             model: z.ZodObject<{
                 provider: z.ZodString;
                 model: z.ZodString;
@@ -649,19 +794,24 @@ export declare const ConversationEventSchema: z.ZodDiscriminatedUnion<[z.ZodObje
             }, 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<{
+            disabledTools: z.ZodDefault<z.ZodArray<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;
+                tools: z.ZodUnion<readonly [z.ZodLiteral<"all">, z.ZodArray<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>>>;
+            }, z.core.$strict>], "kind">>>;
+            subagentTools: z.ZodOptional<z.ZodObject<{
+                allow: z.ZodOptional<z.ZodArray<z.ZodString>>;
+                deny: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            }, z.core.$strict>>;
             toolPolicies: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodEnum<{
+                allow: "allow";
                 ask: "ask";
                 deny: "deny";
             }>>>;
@@ -709,6 +859,28 @@ export declare const ConversationEventSchema: z.ZodDiscriminatedUnion<[z.ZodObje
                 }, z.core.$strict>>>;
                 dispatchable: z.ZodOptional<z.ZodBoolean>;
             }, z.core.$strict>>;
+            pendingConnectors: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                key: z.ZodString;
+                label: z.ZodString;
+                source: z.ZodUnion<readonly [z.ZodObject<{
+                    template: z.ZodString;
+                }, z.core.$strict>, z.ZodObject<{
+                    needs: z.ZodObject<{
+                        protocol: z.ZodEnum<{
+                            mcp: "mcp";
+                            openapi: "openapi";
+                        }>;
+                        endpoint: z.ZodString;
+                        tools: z.ZodArray<z.ZodString>;
+                        label: z.ZodString;
+                    }, z.core.$strict>;
+                }, z.core.$strict>]>;
+                tools: z.ZodOptional<z.ZodArray<z.ZodString>>;
+                policies: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodEnum<{
+                    ask: "ask";
+                    deny: "deny";
+                }>>>;
+            }, z.core.$strict>>>;
         }, z.core.$strip>;
         preamble: z.ZodString;
         maxSteps: z.ZodNumber;
@@ -734,8 +906,16 @@ export declare const ConversationEventSchema: z.ZodDiscriminatedUnion<[z.ZodObje
 }, z.core.$strip>, z.ZodObject<{
     type: z.ZodLiteral<"subagent_waiting">;
     payload: z.ZodObject<{
+        requestedFor: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        approverRole: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
+            admin: "admin";
+            guest: "guest";
+            member: "member";
+            owner: "owner";
+        }>>>;
         subagentId: z.ZodString;
         childRunId: z.ZodString;
+        path: z.ZodArray<z.ZodString>;
         kind: z.ZodEnum<{
             approval: "approval";
             connect: "connect";
@@ -771,6 +951,35 @@ export declare const ConversationEventSchema: z.ZodDiscriminatedUnion<[z.ZodObje
             cacheWriteTokens: z.ZodNumber;
         }, z.core.$strip>;
     }, z.core.$strip>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"subagent_delivery">;
+    payload: z.ZodObject<{
+        subagentId: z.ZodString;
+        childRunId: z.ZodString;
+        description: z.ZodString;
+        kind: z.ZodEnum<{
+            finished: "finished";
+            note: "note";
+            report: "report";
+        }>;
+        text: z.ZodString;
+        status: z.ZodOptional<z.ZodEnum<{
+            aborted: "aborted";
+            budget: "budget";
+            completed: "completed";
+            failed: "failed";
+            max_duration: "max_duration";
+            max_steps: "max_steps";
+            timed_out: "timed_out";
+        }>>;
+        handedBack: z.ZodOptional<z.ZodBoolean>;
+        errorCode: z.ZodOptional<z.ZodString>;
+        abortedBy: z.ZodOptional<z.ZodEnum<{
+            parent: "parent";
+            user: "user";
+        }>>;
+        triggerAccountId: z.ZodString;
+    }, z.core.$strip>;
 }, z.core.$strip>, z.ZodObject<{
     type: z.ZodLiteral<"skill_fork_result">;
     payload: z.ZodObject<{
@@ -779,6 +988,30 @@ export declare const ConversationEventSchema: z.ZodDiscriminatedUnion<[z.ZodObje
         childRunId: z.ZodOptional<z.ZodString>;
         text: z.ZodString;
     }, z.core.$strip>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"background_task_finished">;
+    payload: z.ZodObject<{
+        taskId: z.ZodString;
+        description: z.ZodString;
+        status: z.ZodEnum<{
+            completed: "completed";
+            failed: "failed";
+            lost: "lost";
+            stopped: "stopped";
+            timed_out: "timed_out";
+        }>;
+        exitCode: z.ZodNullable<z.ZodNumber>;
+        elapsedMs: z.ZodNumber;
+        lastLines: z.ZodString;
+        outputPath: z.ZodString;
+        reported: z.ZodBoolean;
+        lostReason: z.ZodOptional<z.ZodString>;
+        stoppedBy: z.ZodOptional<z.ZodEnum<{
+            deletion: "deletion";
+            person: "person";
+            subagent_end: "subagent_end";
+        }>>;
+    }, z.core.$strip>;
 }, z.core.$strip>, z.ZodObject<{
     type: z.ZodLiteral<"compaction_summary">;
     payload: z.ZodObject<{
@@ -839,6 +1072,19 @@ export type ConversationEvent = ConversationEventBody & {
     runId: string | null;
     createdAt: Date;
 };
+/**
+ * An event a run absorbs at a step boundary: a person's message, a finished background task or a
+ * sub-agent's delivery.
+ */
+export type AbsorbableEvent = Extract<ConversationEvent, {
+    type: "user_message" | "background_task_finished" | "subagent_delivery";
+}>;
+/**
+ * Whether `e` is absorbed like an interjection (spec 2026-11-05-background-bash-design §2.4): the
+ * loop takes it at its next step boundary, `consumed_seq` moves past it, and request building
+ * places it where the model call that absorbed it was built.
+ */
+export declare const isAbsorbable: (e: ConversationEvent) => e is AbsorbableEvent;
 /**
  * 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