Open-source Grok Bot alternative for named AI teammates. Local-first desktop, web, and mobile clients with per-bot tools, instructions, and memory. Independent fork of T3 Code.
Introduce v2 provider runtime event schema and validation tests
Julius Marmingef2253269ddf8
diff --git a/EVENTS.md b/EVENTS.mdindex fcd3104c8..fb0383670 100644--- a/EVENTS.md+++ b/EVENTS.md@@ -83,12 +83,6 @@ type CanonicalRuntimeEventType =| "thread.started"| "thread.state.changed"| "thread.metadata.updated"- | "thread.token-usage.updated"- | "thread.realtime.started"- | "thread.realtime.item-added"- | "thread.realtime.audio.delta"- | "thread.realtime.error"- | "thread.realtime.closed"| "turn.started"| "turn.completed"| "turn.aborted"@@ -111,20 +105,8 @@ type CanonicalRuntimeEventType =| "task.started"| "task.progress"| "task.completed"- | "hook.started"- | "hook.progress"- | "hook.completed"| "tool.progress"| "tool.summary"- | "auth.status"- | "account.updated"- | "account.rate-limits.updated"- | "mcp.status.updated"- | "mcp.oauth.completed"- | "model.rerouted"- | "config.warning"- | "deprecation.notice"- | "files.persisted"| "runtime.warning"| "runtime.error";```diff --git a/apps/server/src/main.ts b/apps/server/src/main.tsindex 4f36e7ea1..e9fe97835 100644--- a/apps/server/src/main.ts+++ b/apps/server/src/main.ts@@ -10,6 +10,7 @@ import { Config, Data, Effect, FileSystem, Layer, Option, Path, Schema, ServiceMimport { Command, Flag } from "effect/unstable/cli";import { NetService } from "@t3tools/shared/Net";+// Dummy comment.import {DEFAULT_PORT,resolveStaticDir,diff --git a/packages/contracts/src/baseSchemas.ts b/packages/contracts/src/baseSchemas.tsindex 52fa5d9e6..48a5e4711 100644--- a/packages/contracts/src/baseSchemas.ts+++ b/packages/contracts/src/baseSchemas.ts@@ -36,6 +36,14 @@ export const ProviderTurnId = makeEntityId("ProviderTurnId");export type ProviderTurnId = typeof ProviderTurnId.Type;export const ProviderItemId = makeEntityId("ProviderItemId");export type ProviderItemId = typeof ProviderItemId.Type;+export const RuntimeSessionId = makeEntityId("RuntimeSessionId");+export type RuntimeSessionId = typeof RuntimeSessionId.Type;+export const RuntimeItemId = makeEntityId("RuntimeItemId");+export type RuntimeItemId = typeof RuntimeItemId.Type;+export const RuntimeRequestId = makeEntityId("RuntimeRequestId");+export type RuntimeRequestId = typeof RuntimeRequestId.Type;+export const RuntimeTaskId = makeEntityId("RuntimeTaskId");+export type RuntimeTaskId = typeof RuntimeTaskId.Type;export const ApprovalRequestId = makeEntityId("ApprovalRequestId");export type ApprovalRequestId = typeof ApprovalRequestId.Type;export const CheckpointRef = makeEntityId("CheckpointRef");diff --git a/packages/contracts/src/providerRuntime.test.ts b/packages/contracts/src/providerRuntime.test.tsnew file mode 100644index 000000000..b5c182197--- /dev/null+++ b/packages/contracts/src/providerRuntime.test.ts@@ -0,0 +1,120 @@+import { describe, expect, it } from "vitest";+import { Schema } from "effect";++import { ProviderRuntimeEvent } from "./providerRuntime";++const decodeRuntimeEvent = Schema.decodeUnknownSync(ProviderRuntimeEvent);++describe("ProviderRuntimeEvent", () => {+ it("decodes turn.plan.updated for plan rendering", () => {+ const parsed = decodeRuntimeEvent({+ type: "turn.plan.updated",+ eventId: "event-1",+ provider: "claudeCode",+ sessionId: "runtime-session-1",+ createdAt: "2026-02-28T00:00:00.000Z",+ threadId: "thread-1",+ turnId: "turn-1",+ payload: {+ explanation: "Implement schema updates",+ plan: [+ { step: "Define event union", status: "completed" },+ { step: "Wire adapter mapping", status: "inProgress" },+ ],+ },+ });++ expect(parsed.type).toBe("turn.plan.updated");+ if (parsed.type !== "turn.plan.updated") {+ throw new Error("expected turn.plan.updated");+ }+ expect(parsed.payload.plan).toHaveLength(2);+ expect(parsed.payload.plan[1]?.status).toBe("inProgress");+ });++ it("decodes user-input.requested with structured questions", () => {+ const parsed = decodeRuntimeEvent({+ type: "user-input.requested",+ eventId: "event-2",+ provider: "claudeCode",+ sessionId: "runtime-session-2",+ createdAt: "2026-02-28T00:00:01.000Z",+ requestId: "request-1",+ payload: {+ questions: [+ {+ id: "sandbox_mode",+ header: "Sandbox",+ question: "Which mode should be used?",+ options: [+ {+ label: "workspace-write",+ description: "Allow edits in workspace only",+ },+ {+ label: "danger-full-access",+ description: "Allow unrestricted access",+ },+ ],+ },+ ],+ },+ });++ expect(parsed.type).toBe("user-input.requested");+ if (parsed.type !== "user-input.requested") {+ throw new Error("expected user-input.requested");+ }+ expect(parsed.payload.questions[0]?.id).toBe("sandbox_mode");+ expect(parsed.payload.questions[0]?.options).toHaveLength(2);+ });++ it("decodes user-input.resolved with answer map", () => {+ const parsed = decodeRuntimeEvent({+ type: "user-input.resolved",+ eventId: "event-3",+ provider: "claudeCode",+ sessionId: "runtime-session-2",+ createdAt: "2026-02-28T00:00:02.000Z",+ requestId: "request-1",+ payload: {+ answers: {+ sandbox_mode: "workspace-write",+ },+ },+ });++ expect(parsed.type).toBe("user-input.resolved");+ if (parsed.type !== "user-input.resolved") {+ throw new Error("expected user-input.resolved");+ }+ expect(parsed.payload.answers.sandbox_mode).toBe("workspace-write");+ });++ it("rejects legacy message.delta type", () => {+ expect(() =>+ decodeRuntimeEvent({+ type: "message.delta",+ eventId: "event-4",+ provider: "codex",+ sessionId: "runtime-session-3",+ createdAt: "2026-02-28T00:00:03.000Z",+ payload: { delta: "legacy" },+ }),+ ).toThrow();+ });++ it("rejects empty branded canonical ids", () => {+ expect(() =>+ decodeRuntimeEvent({+ type: "runtime.error",+ eventId: "event-5",+ provider: "codex",+ sessionId: "runtime-session-3",+ createdAt: "2026-02-28T00:00:03.000Z",+ threadId: " ",+ payload: { message: "boom" },+ }),+ ).toThrow();+ });+});diff --git a/packages/contracts/src/providerRuntime.ts b/packages/contracts/src/providerRuntime.tsindex 26910b54b..ebe5b21bd 100644--- a/packages/contracts/src/providerRuntime.ts+++ b/packages/contracts/src/providerRuntime.ts@@ -1,226 +1,438 @@import { Schema } from "effect";-import { TrimmedNonEmptyString } from "./baseSchemas";-import {- ApprovalRequestId,EventId,- NonNegativeInt,+ IsoDateTime,ProviderItemId,ProviderSessionId,ProviderThreadId,ProviderTurnId,- IsoDateTime,+ RuntimeItemId,+ RuntimeRequestId,+ RuntimeSessionId,+ ThreadId,+ TrimmedNonEmptyString,+ TurnId,} from "./baseSchemas";-import { ProviderApprovalDecision, ProviderKind, ProviderRequestKind } from "./orchestration";+import { ProviderKind } from "./orchestration";const TrimmedNonEmptyStringSchema = TrimmedNonEmptyString;+const UnknownRecordSchema = Schema.Record(Schema.String, Schema.Unknown);-export const ProviderRuntimeToolKind = Schema.Union([ProviderRequestKind, Schema.Literal("other")]);-export type ProviderRuntimeToolKind = typeof ProviderRuntimeToolKind.Type;+export const RuntimeEventRawSource = Schema.Literals([+ "codex.app-server.notification",+ "codex.app-server.request",+ "codex.eventmsg",+ "claude.sdk.message",+ "claude.sdk.permission",+ "codex.sdk.thread-event",+]);+export type RuntimeEventRawSource = typeof RuntimeEventRawSource.Type;++export const RuntimeEventRaw = Schema.Struct({+ source: RuntimeEventRawSource,+ method: Schema.optional(TrimmedNonEmptyStringSchema),+ messageType: Schema.optional(TrimmedNonEmptyStringSchema),+ payload: Schema.Unknown,+});+export type RuntimeEventRaw = typeof RuntimeEventRaw.Type;++export const ProviderRequestId = TrimmedNonEmptyStringSchema;+export type ProviderRequestId = typeof ProviderRequestId.Type;-export const ProviderRuntimeTurnStatus = Schema.Literals([+export const ProviderRefs = Schema.Struct({+ providerSessionId: Schema.optional(ProviderSessionId),+ providerThreadId: Schema.optional(ProviderThreadId),+ providerTurnId: Schema.optional(ProviderTurnId),+ providerItemId: Schema.optional(ProviderItemId),+ providerRequestId: Schema.optional(ProviderRequestId),+});+export type ProviderRefs = typeof ProviderRefs.Type;++export const RuntimeTurnState = Schema.Literals(["completed","failed",- "cancelled","interrupted",+ "cancelled",]);-export type ProviderRuntimeTurnStatus = typeof ProviderRuntimeTurnStatus.Type;+export type RuntimeTurnState = typeof RuntimeTurnState.Type;-export const ProviderRuntimeSessionStartedEvent = Schema.Struct({- type: Schema.Literal("session.started"),+export const RuntimePlanStepStatus = Schema.Literals(["pending", "inProgress", "completed"]);+export type RuntimePlanStepStatus = typeof RuntimePlanStepStatus.Type;++export const RuntimeItemStatus = Schema.Literals(["inProgress", "completed", "failed", "declined"]);+export type RuntimeItemStatus = typeof RuntimeItemStatus.Type;++export const RuntimeContentStreamKind = Schema.Literals([+ "assistant_text",+ "reasoning_text",+ "reasoning_summary_text",+ "plan_text",+ "command_output",+ "file_change_output",+ "unknown",+]);+export type RuntimeContentStreamKind = typeof RuntimeContentStreamKind.Type;++export const RuntimeSessionExitKind = Schema.Literals(["graceful", "error"]);+export type RuntimeSessionExitKind = typeof RuntimeSessionExitKind.Type;++export const RuntimeErrorClass = Schema.Literals([+ "provider_error",+ "transport_error",+ "permission_error",+ "validation_error",+ "unknown",+]);+export type RuntimeErrorClass = typeof RuntimeErrorClass.Type;++export const CanonicalItemType = Schema.Literals([+ "user_message",+ "assistant_message",+ "reasoning",+ "plan",+ "command_execution",+ "file_change",+ "mcp_tool_call",+ "dynamic_tool_call",+ "error",+ "unknown",+]);+export type CanonicalItemType = typeof CanonicalItemType.Type;++export const CanonicalRequestType = Schema.Literals([+ "command_execution_approval",+ "file_change_approval",+ "apply_patch_approval",+ "exec_command_approval",+ "tool_user_input",+ "dynamic_tool_call",+ "unknown",+]);+export type CanonicalRequestType = typeof CanonicalRequestType.Type;++export const ProviderRuntimeEventType = Schema.Literals([+ "session.started",+ "session.exited",+ "thread.started",+ "turn.started",+ "turn.completed",+ "turn.plan.updated",+ "item.started",+ "item.updated",+ "item.completed",+ "content.delta",+ "request.opened",+ "request.resolved",+ "user-input.requested",+ "user-input.resolved",+ "runtime.warning",+ "runtime.error",+]);+export type ProviderRuntimeEventType = typeof ProviderRuntimeEventType.Type;++export const SessionStartedType = Schema.Literal("session.started");+export const SessionExitedType = Schema.Literal("session.exited");+export const ThreadStartedType = Schema.Literal("thread.started");+export const TurnStartedType = Schema.Literal("turn.started");+export const TurnCompletedType = Schema.Literal("turn.completed");+export const TurnPlanUpdatedType = Schema.Literal("turn.plan.updated");+export const ItemStartedType = Schema.Literal("item.started");+export const ItemUpdatedType = Schema.Literal("item.updated");+export const ItemCompletedType = Schema.Literal("item.completed");+export const ContentDeltaType = Schema.Literal("content.delta");+export const RequestOpenedType = Schema.Literal("request.opened");+export const RequestResolvedType = Schema.Literal("request.resolved");+export const UserInputRequestedType = Schema.Literal("user-input.requested");+export const UserInputResolvedType = Schema.Literal("user-input.resolved");+export const RuntimeWarningType = Schema.Literal("runtime.warning");+export const RuntimeErrorType = Schema.Literal("runtime.error");++export const ProviderRuntimeEventBase = Schema.Struct({eventId: EventId,provider: ProviderKind,- sessionId: ProviderSessionId,- sessionSequence: Schema.optional(NonNegativeInt),+ sessionId: RuntimeSessionId,createdAt: IsoDateTime,- threadId: Schema.optional(ProviderThreadId),+ threadId: Schema.optional(ThreadId),+ turnId: Schema.optional(TurnId),+ itemId: Schema.optional(RuntimeItemId),+ requestId: Schema.optional(RuntimeRequestId),+ providerRefs: Schema.optional(ProviderRefs),+ raw: Schema.optional(RuntimeEventRaw),+});+export type ProviderRuntimeEventBase = typeof ProviderRuntimeEventBase.Type;++export const SessionStartedPayload = Schema.Struct({message: Schema.optional(TrimmedNonEmptyStringSchema),+ resume: Schema.optional(Schema.Unknown),+});+export type SessionStartedPayload = typeof SessionStartedPayload.Type;++export const SessionExitedPayload = Schema.Struct({+ reason: Schema.optional(TrimmedNonEmptyStringSchema),+ recoverable: Schema.optional(Schema.Boolean),+ exitKind: Schema.optional(RuntimeSessionExitKind),+});+export type SessionExitedPayload = typeof SessionExitedPayload.Type;++export const ThreadStartedPayload = Schema.Struct({+ providerThreadId: Schema.optional(ProviderThreadId),+});+export type ThreadStartedPayload = typeof ThreadStartedPayload.Type;++export const TurnStartedPayload = Schema.Struct({+ model: Schema.optional(TrimmedNonEmptyStringSchema),+ effort: Schema.optional(TrimmedNonEmptyStringSchema),+});+export type TurnStartedPayload = typeof TurnStartedPayload.Type;++export const TurnCompletedPayload = Schema.Struct({+ state: RuntimeTurnState,+ stopReason: Schema.optional(Schema.NullOr(TrimmedNonEmptyStringSchema)),+ usage: Schema.optional(Schema.Unknown),+ modelUsage: Schema.optional(UnknownRecordSchema),+ totalCostUsd: Schema.optional(Schema.Number),+ errorMessage: Schema.optional(TrimmedNonEmptyStringSchema),+});+export type TurnCompletedPayload = typeof TurnCompletedPayload.Type;++export const RuntimePlanStep = Schema.Struct({+ step: TrimmedNonEmptyStringSchema,+ status: RuntimePlanStepStatus,+});+export type RuntimePlanStep = typeof RuntimePlanStep.Type;++export const TurnPlanUpdatedPayload = Schema.Struct({+ explanation: Schema.optional(Schema.NullOr(TrimmedNonEmptyStringSchema)),+ plan: Schema.Array(RuntimePlanStep),+});+export type TurnPlanUpdatedPayload = typeof TurnPlanUpdatedPayload.Type;++export const ItemLifecyclePayload = Schema.Struct({+ itemType: CanonicalItemType,+ status: Schema.optional(RuntimeItemStatus),+ title: Schema.optional(TrimmedNonEmptyStringSchema),+ detail: Schema.optional(TrimmedNonEmptyStringSchema),+ data: Schema.optional(Schema.Unknown),+});+export type ItemLifecyclePayload = typeof ItemLifecyclePayload.Type;++export const ContentDeltaPayload = Schema.Struct({+ streamKind: RuntimeContentStreamKind,+ delta: Schema.String,+ contentIndex: Schema.optional(Schema.Int),+ summaryIndex: Schema.optional(Schema.Int),+});+export type ContentDeltaPayload = typeof ContentDeltaPayload.Type;++export const RequestOpenedPayload = Schema.Struct({+ requestType: CanonicalRequestType,+ detail: Schema.optional(TrimmedNonEmptyStringSchema),+ args: Schema.optional(Schema.Unknown),+});+export type RequestOpenedPayload = typeof RequestOpenedPayload.Type;++export const RequestResolvedPayload = Schema.Struct({+ requestType: CanonicalRequestType,+ decision: Schema.optional(TrimmedNonEmptyStringSchema),+ resolution: Schema.optional(Schema.Unknown),+});+export type RequestResolvedPayload = typeof RequestResolvedPayload.Type;++export const UserInputQuestionOption = Schema.Struct({+ label: TrimmedNonEmptyStringSchema,+ description: TrimmedNonEmptyStringSchema,+});+export type UserInputQuestionOption = typeof UserInputQuestionOption.Type;++export const UserInputQuestion = Schema.Struct({+ id: TrimmedNonEmptyStringSchema,+ header: TrimmedNonEmptyStringSchema,+ question: TrimmedNonEmptyStringSchema,+ options: Schema.Array(UserInputQuestionOption),+});+export type UserInputQuestion = typeof UserInputQuestion.Type;++export const UserInputRequestedPayload = Schema.Struct({+ questions: Schema.Array(UserInputQuestion),+});+export type UserInputRequestedPayload = typeof UserInputRequestedPayload.Type;++export const UserInputResolvedPayload = Schema.Struct({+ answers: UnknownRecordSchema,+});+export type UserInputResolvedPayload = typeof UserInputResolvedPayload.Type;++export const RuntimeWarningPayload = Schema.Struct({+ message: TrimmedNonEmptyStringSchema,+ detail: Schema.optional(Schema.Unknown),+});+export type RuntimeWarningPayload = typeof RuntimeWarningPayload.Type;++export const RuntimeErrorPayload = Schema.Struct({+ message: TrimmedNonEmptyStringSchema,+ class: Schema.optional(RuntimeErrorClass),+ detail: Schema.optional(Schema.Unknown),+});+export type RuntimeErrorPayload = typeof RuntimeErrorPayload.Type;++export const ProviderRuntimeSessionStartedEvent = Schema.Struct({+ ...ProviderRuntimeEventBase.fields,+ type: SessionStartedType,+ payload: SessionStartedPayload,});export type ProviderRuntimeSessionStartedEvent = typeof ProviderRuntimeSessionStartedEvent.Type;export const ProviderRuntimeSessionExitedEvent = Schema.Struct({- type: Schema.Literal("session.exited"),- eventId: EventId,- provider: ProviderKind,- sessionId: ProviderSessionId,- sessionSequence: Schema.optional(NonNegativeInt),- createdAt: IsoDateTime,- threadId: Schema.optional(ProviderThreadId),- message: Schema.optional(TrimmedNonEmptyStringSchema),+ ...ProviderRuntimeEventBase.fields,+ type: SessionExitedType,+ payload: SessionExitedPayload,});export type ProviderRuntimeSessionExitedEvent = typeof ProviderRuntimeSessionExitedEvent.Type;export const ProviderRuntimeThreadStartedEvent = Schema.Struct({- type: Schema.Literal("thread.started"),- eventId: EventId,- provider: ProviderKind,- sessionId: ProviderSessionId,- sessionSequence: Schema.optional(NonNegativeInt),- createdAt: IsoDateTime,- threadId: ProviderThreadId,+ ...ProviderRuntimeEventBase.fields,+ type: ThreadStartedType,+ payload: ThreadStartedPayload,});export type ProviderRuntimeThreadStartedEvent = typeof ProviderRuntimeThreadStartedEvent.Type;export const ProviderRuntimeTurnStartedEvent = Schema.Struct({- type: Schema.Literal("turn.started"),- eventId: EventId,- provider: ProviderKind,- sessionId: ProviderSessionId,- sessionSequence: Schema.optional(NonNegativeInt),- createdAt: IsoDateTime,- threadId: Schema.optional(ProviderThreadId),- turnId: ProviderTurnId,+ ...ProviderRuntimeEventBase.fields,+ type: TurnStartedType,+ payload: TurnStartedPayload,});export type ProviderRuntimeTurnStartedEvent = typeof ProviderRuntimeTurnStartedEvent.Type;export const ProviderRuntimeTurnCompletedEvent = Schema.Struct({- type: Schema.Literal("turn.completed"),- eventId: EventId,- provider: ProviderKind,- sessionId: ProviderSessionId,- sessionSequence: Schema.optional(NonNegativeInt),- createdAt: IsoDateTime,- threadId: Schema.optional(ProviderThreadId),- turnId: Schema.optional(ProviderTurnId),- status: Schema.optional(ProviderRuntimeTurnStatus),- errorMessage: Schema.optional(TrimmedNonEmptyStringSchema),+ ...ProviderRuntimeEventBase.fields,+ type: TurnCompletedType,+ payload: TurnCompletedPayload,});export type ProviderRuntimeTurnCompletedEvent = typeof ProviderRuntimeTurnCompletedEvent.Type;-export const ProviderRuntimeMessageDeltaEvent = Schema.Struct({- type: Schema.Literal("message.delta"),- eventId: EventId,- provider: ProviderKind,- sessionId: ProviderSessionId,- sessionSequence: Schema.optional(NonNegativeInt),- createdAt: IsoDateTime,- threadId: Schema.optional(ProviderThreadId),- turnId: Schema.optional(ProviderTurnId),- itemId: Schema.optional(ProviderItemId),- delta: Schema.String,+export const ProviderRuntimeTurnPlanUpdatedEvent = Schema.Struct({+ ...ProviderRuntimeEventBase.fields,+ type: TurnPlanUpdatedType,+ payload: TurnPlanUpdatedPayload,});-export type ProviderRuntimeMessageDeltaEvent = typeof ProviderRuntimeMessageDeltaEvent.Type;+export type ProviderRuntimeTurnPlanUpdatedEvent = typeof ProviderRuntimeTurnPlanUpdatedEvent.Type;-export const ProviderRuntimeMessageCompletedEvent = Schema.Struct({- type: Schema.Literal("message.completed"),- eventId: EventId,- provider: ProviderKind,- sessionId: ProviderSessionId,- sessionSequence: Schema.optional(NonNegativeInt),- createdAt: IsoDateTime,- itemId: ProviderItemId,- threadId: Schema.optional(ProviderThreadId),- turnId: Schema.optional(ProviderTurnId),+export const ProviderRuntimeItemStartedEvent = Schema.Struct({+ ...ProviderRuntimeEventBase.fields,+ type: ItemStartedType,+ payload: ItemLifecyclePayload,});-export type ProviderRuntimeMessageCompletedEvent = typeof ProviderRuntimeMessageCompletedEvent.Type;+export type ProviderRuntimeItemStartedEvent = typeof ProviderRuntimeItemStartedEvent.Type;-export const ProviderRuntimeToolStartedEvent = Schema.Struct({- type: Schema.Literal("tool.started"),- eventId: EventId,- provider: ProviderKind,- sessionId: ProviderSessionId,- sessionSequence: Schema.optional(NonNegativeInt),- createdAt: IsoDateTime,- threadId: Schema.optional(ProviderThreadId),- turnId: Schema.optional(ProviderTurnId),- itemId: Schema.optional(ProviderItemId),- toolKind: ProviderRuntimeToolKind,- title: TrimmedNonEmptyStringSchema,- detail: Schema.optional(TrimmedNonEmptyStringSchema),+export const ProviderRuntimeItemUpdatedEvent = Schema.Struct({+ ...ProviderRuntimeEventBase.fields,+ type: ItemUpdatedType,+ payload: ItemLifecyclePayload,});-export type ProviderRuntimeToolStartedEvent = typeof ProviderRuntimeToolStartedEvent.Type;+export type ProviderRuntimeItemUpdatedEvent = typeof ProviderRuntimeItemUpdatedEvent.Type;-export const ProviderRuntimeToolCompletedEvent = Schema.Struct({- type: Schema.Literal("tool.completed"),- eventId: EventId,- provider: ProviderKind,- sessionId: ProviderSessionId,- sessionSequence: Schema.optional(NonNegativeInt),- createdAt: IsoDateTime,- threadId: Schema.optional(ProviderThreadId),- turnId: Schema.optional(ProviderTurnId),- itemId: Schema.optional(ProviderItemId),- toolKind: ProviderRuntimeToolKind,- title: TrimmedNonEmptyStringSchema,- detail: Schema.optional(TrimmedNonEmptyStringSchema),+export const ProviderRuntimeItemCompletedEvent = Schema.Struct({+ ...ProviderRuntimeEventBase.fields,+ type: ItemCompletedType,+ payload: ItemLifecyclePayload,});-export type ProviderRuntimeToolCompletedEvent = typeof ProviderRuntimeToolCompletedEvent.Type;+export type ProviderRuntimeItemCompletedEvent = typeof ProviderRuntimeItemCompletedEvent.Type;-export const ProviderRuntimeApprovalRequestedEvent = Schema.Struct({- type: Schema.Literal("approval.requested"),- eventId: EventId,- provider: ProviderKind,- sessionId: ProviderSessionId,- sessionSequence: Schema.optional(NonNegativeInt),- createdAt: IsoDateTime,- threadId: Schema.optional(ProviderThreadId),- turnId: Schema.optional(ProviderTurnId),- itemId: Schema.optional(ProviderItemId),- requestId: ApprovalRequestId,- requestKind: ProviderRequestKind,- detail: Schema.optional(TrimmedNonEmptyStringSchema),+export const ProviderRuntimeContentDeltaEvent = Schema.Struct({+ ...ProviderRuntimeEventBase.fields,+ type: ContentDeltaType,+ payload: ContentDeltaPayload,});-export type ProviderRuntimeApprovalRequestedEvent =- typeof ProviderRuntimeApprovalRequestedEvent.Type;+export type ProviderRuntimeContentDeltaEvent = typeof ProviderRuntimeContentDeltaEvent.Type;-export const ProviderRuntimeApprovalResolvedEvent = Schema.Struct({- type: Schema.Literal("approval.resolved"),- eventId: EventId,- provider: ProviderKind,- sessionId: ProviderSessionId,- sessionSequence: Schema.optional(NonNegativeInt),- createdAt: IsoDateTime,- threadId: Schema.optional(ProviderThreadId),- turnId: Schema.optional(ProviderTurnId),- itemId: Schema.optional(ProviderItemId),- requestId: ApprovalRequestId,- requestKind: Schema.optional(ProviderRequestKind),- decision: Schema.optional(ProviderApprovalDecision),+export const ProviderRuntimeRequestOpenedEvent = Schema.Struct({+ ...ProviderRuntimeEventBase.fields,+ type: RequestOpenedType,+ payload: RequestOpenedPayload,});-export type ProviderRuntimeApprovalResolvedEvent = typeof ProviderRuntimeApprovalResolvedEvent.Type;+export type ProviderRuntimeRequestOpenedEvent = typeof ProviderRuntimeRequestOpenedEvent.Type;-export const ProviderRuntimeCheckpointCapturedEvent = Schema.Struct({- type: Schema.Literal("checkpoint.captured"),- eventId: EventId,- provider: ProviderKind,- sessionId: ProviderSessionId,- sessionSequence: Schema.optional(NonNegativeInt),- createdAt: IsoDateTime,- threadId: ProviderThreadId,- turnId: Schema.optional(ProviderTurnId),- turnCount: NonNegativeInt,- status: Schema.optional(ProviderRuntimeTurnStatus),+export const ProviderRuntimeRequestResolvedEvent = Schema.Struct({+ ...ProviderRuntimeEventBase.fields,+ type: RequestResolvedType,+ payload: RequestResolvedPayload,});-export type ProviderRuntimeCheckpointCapturedEvent =- typeof ProviderRuntimeCheckpointCapturedEvent.Type;+export type ProviderRuntimeRequestResolvedEvent = typeof ProviderRuntimeRequestResolvedEvent.Type;++export const ProviderRuntimeUserInputRequestedEvent = Schema.Struct({+ ...ProviderRuntimeEventBase.fields,+ type: UserInputRequestedType,+ payload: UserInputRequestedPayload,+});+export type ProviderRuntimeUserInputRequestedEvent =+ typeof ProviderRuntimeUserInputRequestedEvent.Type;++export const ProviderRuntimeUserInputResolvedEvent = Schema.Struct({+ ...ProviderRuntimeEventBase.fields,+ type: UserInputResolvedType,+ payload: UserInputResolvedPayload,+});+export type ProviderRuntimeUserInputResolvedEvent =+ typeof ProviderRuntimeUserInputResolvedEvent.Type;++export const ProviderRuntimeWarningEvent = Schema.Struct({+ ...ProviderRuntimeEventBase.fields,+ type: RuntimeWarningType,+ payload: RuntimeWarningPayload,+});+export type ProviderRuntimeWarningEvent = typeof ProviderRuntimeWarningEvent.Type;export const ProviderRuntimeErrorEvent = Schema.Struct({- type: Schema.Literal("runtime.error"),- eventId: EventId,- provider: ProviderKind,- sessionId: ProviderSessionId,- sessionSequence: Schema.optional(NonNegativeInt),- createdAt: IsoDateTime,- threadId: Schema.optional(ProviderThreadId),- turnId: Schema.optional(ProviderTurnId),- itemId: Schema.optional(ProviderItemId),- message: TrimmedNonEmptyStringSchema,+ ...ProviderRuntimeEventBase.fields,+ type: RuntimeErrorType,+ payload: RuntimeErrorPayload,});export type ProviderRuntimeErrorEvent = typeof ProviderRuntimeErrorEvent.Type;-export const ProviderRuntimeEvent = Schema.Union([+export const ProviderRuntimeEventV2 = Schema.Union([ProviderRuntimeSessionStartedEvent,ProviderRuntimeSessionExitedEvent,ProviderRuntimeThreadStartedEvent,ProviderRuntimeTurnStartedEvent,ProviderRuntimeTurnCompletedEvent,- ProviderRuntimeMessageDeltaEvent,- ProviderRuntimeMessageCompletedEvent,- ProviderRuntimeToolStartedEvent,- ProviderRuntimeToolCompletedEvent,- ProviderRuntimeApprovalRequestedEvent,- ProviderRuntimeApprovalResolvedEvent,- ProviderRuntimeCheckpointCapturedEvent,+ ProviderRuntimeTurnPlanUpdatedEvent,+ ProviderRuntimeItemStartedEvent,+ ProviderRuntimeItemUpdatedEvent,+ ProviderRuntimeItemCompletedEvent,+ ProviderRuntimeContentDeltaEvent,+ ProviderRuntimeRequestOpenedEvent,+ ProviderRuntimeRequestResolvedEvent,+ ProviderRuntimeUserInputRequestedEvent,+ ProviderRuntimeUserInputResolvedEvent,+ ProviderRuntimeWarningEvent,ProviderRuntimeErrorEvent,]);-export type ProviderRuntimeEvent = typeof ProviderRuntimeEvent.Type;+export type ProviderRuntimeEventV2 = typeof ProviderRuntimeEventV2.Type;++export const ProviderRuntimeEvent = ProviderRuntimeEventV2;+export type ProviderRuntimeEvent = ProviderRuntimeEventV2;++export const ProviderRuntimeMessageDeltaEvent = ProviderRuntimeContentDeltaEvent;+export type ProviderRuntimeMessageDeltaEvent = ProviderRuntimeContentDeltaEvent;+export const ProviderRuntimeMessageCompletedEvent = ProviderRuntimeItemCompletedEvent;+export type ProviderRuntimeMessageCompletedEvent = ProviderRuntimeItemCompletedEvent;+export const ProviderRuntimeToolStartedEvent = ProviderRuntimeItemStartedEvent;+export type ProviderRuntimeToolStartedEvent = ProviderRuntimeItemStartedEvent;+export const ProviderRuntimeToolCompletedEvent = ProviderRuntimeItemCompletedEvent;+export type ProviderRuntimeToolCompletedEvent = ProviderRuntimeItemCompletedEvent;+export const ProviderRuntimeApprovalRequestedEvent = ProviderRuntimeRequestOpenedEvent;+export type ProviderRuntimeApprovalRequestedEvent = ProviderRuntimeRequestOpenedEvent;+export const ProviderRuntimeApprovalResolvedEvent = ProviderRuntimeRequestResolvedEvent;+export type ProviderRuntimeApprovalResolvedEvent = ProviderRuntimeRequestResolvedEvent;++export const ProviderRuntimeToolKind = Schema.Literals([+ "command_execution",+ "file_change",+ "mcp_tool_call",+ "dynamic_tool_call",+ "other",+]);+export type ProviderRuntimeToolKind = typeof ProviderRuntimeToolKind.Type;++export const ProviderRuntimeTurnStatus = RuntimeTurnState;+export type ProviderRuntimeTurnStatus = RuntimeTurnState;