@github/copilot-sdk 1.0.13-preview.0 → 1.0.13-preview.2

package/dist/generated/session-events.d.ts

@@ -9,7 +9,7 @@ export type JsonValue = null | boolean | number | string | JsonValue[] | {
 /**
  * Union of all session event variants emitted by the Copilot CLI runtime.
  */
-export type SessionEvent = StartEvent | ResumeEvent | RemoteSteerableChangedEvent | ErrorEvent | IdleEvent | TitleChangedEvent | ScheduleCreatedEvent | ScheduleCancelledEvent | ScheduleRearmedEvent | AutopilotObjectiveChangedEvent | InfoEvent | WarningEvent | ModelChangeEvent | ModeChangedEvent | SessionLimitsChangedEvent | PermissionsChangedEvent | PlanChangedEvent | TodosChangedEvent | WorkspaceFileChangedEvent | HandoffEvent | TruncationEvent | SnapshotRewindEvent | ShutdownEvent | UsageCheckpointEvent | ContextChangedEvent | UsageInfoEvent | ContextClearedEvent | CompactionStartEvent | CompactionCompleteEvent | TaskCompleteEvent | UserMessageEvent | PendingMessagesModifiedEvent | AssistantTurnStartEvent | AssistantIntentEvent | AssistantServerToolProgressEvent | AssistantReasoningEvent | AssistantReasoningDeltaEvent | AssistantToolCallDeltaEvent | AssistantStreamingDeltaEvent | AssistantMessageEvent | AssistantMessageStartEvent | AssistantMessageDeltaEvent | AssistantTurnEndEvent | AssistantIdleEvent | AssistantUsageEvent | ModelCallFailureEvent | AbortEvent | ToolUserRequestedEvent | ToolExecutionStartEvent | ToolExecutionPartialResultEvent | ToolExecutionProgressEvent | ToolExecutionCompleteEvent | ToolSearchActivatedEvent | SkillInvokedEvent | SubagentStartedEvent | SubagentCompletedEvent | SubagentFailedEvent | SubagentSelectedEvent | SubagentDeselectedEvent | HookStartEvent | HookEndEvent | HookProgressEvent | BinaryAssetEvent | SystemMessageEvent | SystemNotificationEvent | PermissionRequestedEvent | PermissionCompletedEvent | UserInputRequestedEvent | UserInputCompletedEvent | ElicitationRequestedEvent | ElicitationCompletedEvent | SamplingRequestedEvent | SamplingCompletedEvent | McpOauthRequiredEvent | McpOauthCompletedEvent | McpHeadersRefreshRequiredEvent | McpHeadersRefreshCompletedEvent | CustomNotificationEvent | UIEphemeralQueryEvent | ExternalToolRequestedEvent | ExternalToolCompletedEvent | CommandQueuedEvent | CommandExecuteEvent | CommandCompletedEvent | AutoModeSwitchRequestedEvent | AutoModeSwitchCompletedEvent | SessionLimitsExhaustedRequestedEvent | SessionLimitsExhaustedCompletedEvent | AutoModeResolvedEvent | ManagedSettingsResolvedEvent | ManagedSettingsEnforcedEvent | CommandsChangedEvent | CapabilitiesChangedEvent | ExitPlanModeRequestedEvent | ExitPlanModeCompletedEvent | ToolsUpdatedEvent | BackgroundTasksChangedEvent | FactoryRunUpdatedEvent | FactoryRunStartedEvent | FactoryRunSettledEvent | SkillsLoadedEvent | CustomAgentsUpdatedEvent | McpServersLoadedEvent | McpServerStatusChangedEvent | McpToolsListChangedEvent | McpResourcesListChangedEvent | McpPromptsListChangedEvent | ExtensionsLoadedEvent | CanvasOpenedEvent | CanvasRegistryChangedEvent | CanvasClosedEvent | CanvasUnavailableEvent | CanvasRecordedEvent | CanvasRemovedEvent | ExtensionsAttachmentsPushedEvent | McpAppToolCallCompleteEvent;
+export type SessionEvent = StartEvent | ResumeEvent | RemoteSteerableChangedEvent | ErrorEvent | IdleEvent | TitleChangedEvent | ScheduleCreatedEvent | ScheduleCancelledEvent | ScheduleRearmedEvent | AutopilotObjectiveChangedEvent | InfoEvent | WarningEvent | ModelChangeEvent | ModeChangedEvent | SessionLimitsChangedEvent | PermissionsChangedEvent | PlanChangedEvent | TodosChangedEvent | WorkspaceFileChangedEvent | HandoffEvent | TruncationEvent | SnapshotRewindEvent | ShutdownEvent | UsageCheckpointEvent | ContextChangedEvent | UsageInfoEvent | ContextClearedEvent | CompactionStartEvent | CompactionCompleteEvent | TaskCompleteEvent | FusionRouteStartedEvent | FusionRouteFailedEvent | FusionResolvedEvent | FusionCompletedEvent | UserMessageEvent | PendingMessagesModifiedEvent | AssistantTurnStartEvent | AssistantIntentEvent | AssistantFusionPhaseStartedEvent | AssistantFusionPhaseCompletedEvent | AssistantFusionPhaseFailedEvent | AssistantServerToolProgressEvent | AssistantReasoningEvent | AssistantReasoningDeltaEvent | AssistantToolCallDeltaEvent | AssistantStreamingDeltaEvent | AssistantMessageEvent | AssistantMessageStartEvent | AssistantMessageDeltaEvent | AssistantTurnEndEvent | AssistantIdleEvent | AssistantUsageEvent | ModelCallFailureEvent | ModelCallFinishedEvent | AbortEvent | ToolUserRequestedEvent | ToolExecutionStartEvent | ToolExecutionPartialResultEvent | ToolExecutionProgressEvent | ToolExecutionCompleteEvent | ToolSearchActivatedEvent | SkillInvokedEvent | SubagentStartedEvent | SubagentConfiguredEvent | SubagentCompletedEvent | SubagentFailedEvent | SubagentSelectedEvent | SubagentDeselectedEvent | HookStartEvent | HookEndEvent | HookProgressEvent | BinaryAssetEvent | SystemMessageEvent | SystemNotificationEvent | PermissionRequestedEvent | PermissionCompletedEvent | UserInputRequestedEvent | UserInputCompletedEvent | ElicitationRequestedEvent | ElicitationCompletedEvent | SamplingRequestedEvent | SamplingCompletedEvent | McpOauthRequiredEvent | McpOauthCompletedEvent | McpHeadersRefreshRequiredEvent | McpHeadersRefreshCompletedEvent | CustomNotificationEvent | UIEphemeralQueryEvent | ExternalToolRequestedEvent | ExternalToolCompletedEvent | CommandQueuedEvent | CommandExecuteEvent | CommandCompletedEvent | AutoModeSwitchRequestedEvent | AutoModeSwitchCompletedEvent | SessionLimitsExhaustedRequestedEvent | SessionLimitsExhaustedCompletedEvent | AutoModeResolvedEvent | ManagedSettingsResolvedEvent | ManagedSettingsEnforcedEvent | CommandsChangedEvent | CapabilitiesChangedEvent | ExitPlanModeRequestedEvent | ExitPlanModeCompletedEvent | ToolsUpdatedEvent | BackgroundTasksChangedEvent | FactoryRunUpdatedEvent | FactoryRunStartedEvent | FactoryRunSettledEvent | SkillsLoadedEvent | CustomAgentsUpdatedEvent | McpServersLoadedEvent | McpServerStatusChangedEvent | McpToolsListChangedEvent | McpResourcesListChangedEvent | McpPromptsListChangedEvent | ExtensionsLoadedEvent | CanvasOpenedEvent | CanvasRegistryChangedEvent | CanvasClosedEvent | CanvasUnavailableEvent | CanvasRecordedEvent | CanvasRemovedEvent | ExtensionsAttachmentsPushedEvent | McpAppToolCallCompleteEvent;
 /**
  * Hosting platform type of the repository (github or ado)
  */
@@ -46,6 +46,16 @@ export type Verbosity =
  | "medium"
 /** A more detailed response was requested. */
  | "high";
+/**
+ * The session mode the agent is operating in
+ */
+export type SessionMode = 
+/** The agent is responding interactively to the user. */
+"interactive"
+/** The agent is preparing a plan before making changes. */
+ | "plan"
+/** The agent is working autonomously toward task completion. */
+ | "autopilot";
 /**
  * Who created the schedule: `user` (an explicit user action such as `/every` or `/after`) or `model` (the agent via the `manage_schedule` tool). Gates whether a scheduled skill that opted out of model invocation may fire: only user-created schedules may.
  */
@@ -102,16 +112,6 @@ export type ModelChangeSource =
  | "automatic"
 /** An SDK or RPC caller selected the model. */
  | "sdk";
-/**
- * The session mode the agent is operating in
- */
-export type SessionMode = 
-/** The agent is responding interactively to the user. */
-"interactive"
-/** The agent is preparing a plan before making changes. */
- | "plan"
-/** The agent is working autonomously toward task completion. */
- | "autopilot";
 /**
  * Permission mode for the session.
  */
@@ -181,6 +181,35 @@ export type TaskCompletionOutcome =
  | "continue"
 /** Completion cannot proceed without intervention; the active objective is paused when one is identified. */
  | "blocked";
+/**
+ * Kind of turn for which HydraFusion routing is running.
+ */
+/** @experimental */
+export type FusionTurnKind = 
+/** A user-message turn. */
+"user"
+/** A conversation-compaction turn. */
+ | "compaction";
+/**
+ * Server-recommended routing behavior for a later HydraFusion turn.
+ */
+/** @experimental */
+export type FusionFollowUpAction = 
+/** Reuse the durable primary model without routing. */
+"reuse_primary"
+/** Request a new routing decision. */
+ | "reroute";
+/**
+ * Validated HydraFusion execution pattern.
+ */
+/** @experimental */
+export type FusionPattern = 
+/** Run one primary solver phase. */
+"single"
+/** Run a primary phase, a judge, and an optional repair. */
+ | "cascade"
+/** Run a primary draft, a read-only critique, and a revision. */
+ | "critique";
 /**
  * The agent mode that was active when this message was sent
  */
@@ -225,6 +254,45 @@ export type UserMessageDelivery =
  | "steering"
 /** Enqueued while the agent was busy; processed as its own run afterward. */
  | "queued";
+/**
+ * Conversation scope in which a HydraFusion phase executes.
+ */
+/** @experimental */
+export type FusionConversationScope = 
+/** Canonical root conversation history. */
+"root"
+/** Isolated read-only review history that does not enter the root conversation. */
+ | "review";
+/**
+ * HydraFusion phase kind.
+ */
+/** @experimental */
+export type FusionPhaseKind = 
+/** Primary solver phase. */
+"primary"
+/** Read-only cascade judge phase. */
+ | "judge"
+/** Cascade repair phase. */
+ | "repair"
+/** Initial critique-pattern draft phase. */
+ | "draft"
+/** Read-only critique phase. */
+ | "critic"
+/** Critique-pattern revision phase. */
+ | "revision"
+/** Follow-up phase continuing from the resolved model. */
+ | "follow_up";
+/**
+ * Durable outcome status of a HydraFusion phase.
+ */
+/** @experimental */
+export type FusionPhaseStatus = 
+/** The phase completed successfully. */
+"succeeded"
+/** The phase failed. */
+ | "failed"
+/** The phase was cancelled. */
+ | "cancelled";
 /**
  * Tool call type: "function" for standard tool calls, "custom" for grammar-based tool calls. Defaults to "function" when absent.
  */
@@ -303,6 +371,18 @@ export type ModelCallFailureTransport =
 "http"
 /** WebSocket transport. */
  | "websocket";
+/**
+ * Final outcome of one logical model dispatch after response acceptance processing
+ */
+export type ModelCallFinishedOutcome = 
+/** The provider response was accepted for continued agent processing. */
+"success"
+/** The dispatch ended with a provider or transport error. */
+ | "error"
+/** The dispatch was cancelled before an accepted response was produced. */
+ | "cancelled"
+/** The provider response was rejected during post-response acceptance processing. */
+ | "rejected";
 /**
  * Finite reason code describing why the current turn was aborted
  */
@@ -665,7 +745,9 @@ export type ManagedSettingsEnforcedEscalation =
 /** Unrestricted filesystem access outside the session's allowed directories. */
  | "unrestricted_paths"
 /** Unrestricted URL fetch access. */
- | "unrestricted_urls";
+ | "unrestricted_urls"
+/** A server-wide MCP "Always Allow" (or `--allow-tool <server>`) blanket that would auto-approve every tool from an MCP server. Capped to per-tool approval; each tool still prompts. */
+ | "server_wide_mcp_approval";
 /**
  * Exit plan mode action
  */
@@ -1156,6 +1238,7 @@ export interface IdleData {
      * True when the preceding agentic loop was cancelled via abort signal
      */
     aborted?: boolean;
+    mode?: SessionMode;
 }
 /**
  * Session event "session.title_changed". Session title change payload containing the new display title
@@ -2468,6 +2551,10 @@ export interface CompactionCompleteEvent {
  * Conversation compaction results including success status, metrics, and optional error details
  */
 export interface CompactionCompleteData {
+    /**
+     * Canonical model identifier used for model-specific behavior when replaying compaction
+     */
+    behaviorModelId?: string;
     /**
      * Checkpoint snapshot number created for recovery
      */
@@ -2645,6 +2732,365 @@ export interface TaskCompleteData {
      */
     summary?: string;
 }
+/**
+ * Session event "session.fusion_route_started". Experimental transient signal that HydraFusion routing has started for an eligible turn.
+ */
+/** @experimental */
+export interface FusionRouteStartedEvent {
+    /**
+     * Sub-agent instance identifier. Absent for events from the root/main agent and session-level events.
+     */
+    agentId?: string;
+    data: FusionRouteStartedData;
+    /**
+     * Always true for events that are transient and not persisted to the session event log on disk.
+     */
+    ephemeral: true;
+    /**
+     * Unique event identifier (UUID v4), generated when the event is emitted
+     */
+    id: string;
+    /**
+     * ID of the chronologically preceding event in the session, forming a linked chain. Null for the first event.
+     */
+    parentId: string | null;
+    /**
+     * ISO 8601 timestamp when the event was created
+     */
+    timestamp: string;
+    /**
+     * Type discriminator. Always "session.fusion_route_started".
+     */
+    type: "session.fusion_route_started";
+}
+/**
+ * Experimental transient signal that HydraFusion routing has started for an eligible turn.
+ */
+/** @experimental */
+export interface FusionRouteStartedData {
+    /**
+     * Identifier for this routing attempt before a durable Fusion turn exists.
+     */
+    attemptId: string;
+    /**
+     * HydraFusion routing policy requested for the turn.
+     */
+    policy?: string;
+    /**
+     * Synthetic HydraFusion model selected for the session.
+     */
+    syntheticModel?: string;
+    turnKind: FusionTurnKind;
+}
+/**
+ * Session event "session.fusion_route_failed". Experimental durable HydraFusion routing failure and the deterministic concrete fallback selected for the turn.
+ */
+/** @experimental */
+export interface FusionRouteFailedEvent {
+    /**
+     * Sub-agent instance identifier. Absent for events from the root/main agent and session-level events.
+     */
+    agentId?: string;
+    data: FusionRouteFailedData;
+    /**
+     * When true, the event is transient and not persisted to the session event log on disk
+     */
+    ephemeral?: boolean;
+    /**
+     * Unique event identifier (UUID v4), generated when the event is emitted
+     */
+    id: string;
+    /**
+     * ID of the chronologically preceding event in the session, forming a linked chain. Null for the first event.
+     */
+    parentId: string | null;
+    /**
+     * ISO 8601 timestamp when the event was created
+     */
+    timestamp: string;
+    /**
+     * Type discriminator. Always "session.fusion_route_failed".
+     */
+    type: "session.fusion_route_failed";
+}
+/**
+ * Experimental durable HydraFusion routing failure and the deterministic concrete fallback selected for the turn.
+ */
+/** @experimental */
+export interface FusionRouteFailedData {
+    /**
+     * Identifier of the routing attempt that failed.
+     */
+    attemptId: string;
+    /**
+     * Provider or validation error detail, when available.
+     */
+    errorMessage?: string;
+    /**
+     * Concrete model selected as the deterministic fallback.
+     */
+    fallbackModel: string;
+    /**
+     * HydraFusion routing policy requested for the turn.
+     */
+    policy: string;
+    /**
+     * Stable machine-readable reason for the routing failure.
+     */
+    reason: string;
+    /**
+     * Elapsed routing time in milliseconds before the failure.
+     */
+    routingLatencyMs?: number;
+    /**
+     * Synthetic HydraFusion model selected for the session.
+     */
+    syntheticModel: string;
+}
+/**
+ * Session event "session.fusion_resolved". Experimental durable validated HydraFusion route and turn policy.
+ */
+/** @experimental */
+export interface FusionResolvedEvent {
+    /**
+     * Sub-agent instance identifier. Absent for events from the root/main agent and session-level events.
+     */
+    agentId?: string;
+    data: FusionResolvedData;
+    /**
+     * When true, the event is transient and not persisted to the session event log on disk
+     */
+    ephemeral?: boolean;
+    /**
+     * Unique event identifier (UUID v4), generated when the event is emitted
+     */
+    id: string;
+    /**
+     * ID of the chronologically preceding event in the session, forming a linked chain. Null for the first event.
+     */
+    parentId: string | null;
+    /**
+     * ISO 8601 timestamp when the event was created
+     */
+    timestamp: string;
+    /**
+     * Type discriminator. Always "session.fusion_resolved".
+     */
+    type: "session.fusion_resolved";
+}
+/**
+ * Experimental durable validated HydraFusion route and turn policy.
+ */
+/** @experimental */
+export interface FusionResolvedData {
+    /**
+     * Version of the validated HydraFusion event contract.
+     */
+    contractVersion: number;
+    /**
+     * Concrete model used when the planned primary model cannot execute.
+     */
+    fallbackModel: string;
+    followUp?: FusionFollowUpRecommendation;
+    /**
+     * Concrete model recommended for eligible follow-up turns.
+     */
+    followUpModel: string;
+    /**
+     * Stable identifier for the resolved HydraFusion turn.
+     */
+    fusionId: string;
+    /**
+     * Version of the executable model universe used for selection.
+     */
+    modelUniverseVersion?: string;
+    pattern: FusionPattern;
+    /**
+     * Version of the validated execution-plan format.
+     */
+    planVersion?: string;
+    /**
+     * HydraFusion routing policy used to resolve the plan.
+     */
+    policy: string;
+    /**
+     * Version of the local routing policy.
+     */
+    policyVersion?: string;
+    /**
+     * Concrete model selected for the primary solver phase.
+     */
+    primaryModel: string;
+    /**
+     * Router implementation that supplied the plan.
+     */
+    routeSource?: string;
+    /**
+     * Elapsed time in milliseconds required to resolve and validate the route.
+     */
+    routingLatencyMs?: number;
+    /**
+     * Identifier of the local policy rule that matched.
+     */
+    ruleId?: string;
+    /**
+     * Zero-based index of the local policy rule that matched.
+     */
+    ruleIndex?: number;
+    /**
+     * Human-readable name of the local policy rule that matched.
+     */
+    ruleName?: string;
+    scores?: FusionScores;
+    /**
+     * Concrete model selected for the review or judge phase, when required.
+     */
+    secondaryModel: string | null;
+    /**
+     * Synthetic HydraFusion model selected for the session.
+     */
+    syntheticModel: string;
+    /**
+     * Identifier of the session turn associated with the route.
+     */
+    turnId: string;
+}
+/**
+ * Durable server recommendation for subsequent HydraFusion turns.
+ */
+/** @experimental */
+export interface FusionFollowUpRecommendation {
+    compactionTurn: FusionFollowUpAction;
+    userTurn: FusionFollowUpAction;
+}
+/**
+ * Validated HydraFusion routing capability scores.
+ */
+/** @experimental */
+export interface FusionScores {
+    /**
+     * Code-generation capability score returned by the authenticated router.
+     */
+    codeGen: number;
+    /**
+     * Debugging capability score returned by the authenticated router.
+     */
+    debugging: number;
+    /**
+     * Reasoning capability score returned by the authenticated router.
+     */
+    reasoning: number;
+    /**
+     * Tool-use capability score returned by the authenticated router.
+     */
+    toolUse: number;
+}
+/**
+ * Session event "session.fusion_completed". Experimental durable aggregate outcome of a HydraFusion turn.
+ */
+/** @experimental */
+export interface FusionCompletedEvent {
+    /**
+     * Sub-agent instance identifier. Absent for events from the root/main agent and session-level events.
+     */
+    agentId?: string;
+    data: FusionCompletedData;
+    /**
+     * When true, the event is transient and not persisted to the session event log on disk
+     */
+    ephemeral?: boolean;
+    /**
+     * Unique event identifier (UUID v4), generated when the event is emitted
+     */
+    id: string;
+    /**
+     * ID of the chronologically preceding event in the session, forming a linked chain. Null for the first event.
+     */
+    parentId: string | null;
+    /**
+     * ISO 8601 timestamp when the event was created
+     */
+    timestamp: string;
+    /**
+     * Type discriminator. Always "session.fusion_completed".
+     */
+    type: "session.fusion_completed";
+}
+/**
+ * Experimental durable aggregate outcome of a HydraFusion turn.
+ */
+/** @experimental */
+export interface FusionCompletedData {
+    /**
+     * Total cached input tokens reported across all phases.
+     */
+    cachedTokens: number;
+    /**
+     * Total tokens written to prompt cache across all phases.
+     */
+    cacheWriteTokens?: number;
+    /**
+     * Idempotency identifier for the authoritative final commit.
+     */
+    commitId: string;
+    /**
+     * Reason the turn used a degraded route, when applicable.
+     */
+    degradedReason: string | null;
+    /**
+     * Total elapsed execution time for the HydraFusion turn in milliseconds.
+     */
+    durationMs: number;
+    /**
+     * Concrete model that supplied the authoritative final content.
+     */
+    finalSourceModel: string | null;
+    /**
+     * Phase whose output supplied the authoritative final content.
+     */
+    finalSourcePhaseId: string | null;
+    /**
+     * Concrete model recommended for eligible follow-up turns.
+     */
+    followUpModel: string;
+    /**
+     * Stable identifier for the completed HydraFusion turn.
+     */
+    fusionId: string;
+    /**
+     * Total input tokens consumed across all phases.
+     */
+    inputTokens: number;
+    /**
+     * Stable aggregate outcome of the HydraFusion turn.
+     */
+    outcome: string;
+    /**
+     * Total output tokens produced across all phases.
+     */
+    outputTokens: number;
+    pattern: FusionPattern;
+    /**
+     * Number of concrete phases attempted by the turn.
+     */
+    phaseCount: number;
+    /**
+     * Total concrete model requests made across all phases.
+     */
+    requestCount: number;
+    /**
+     * Synthetic HydraFusion model selected for the session.
+     */
+    syntheticModel: string;
+    /**
+     * Total normalized AI-unit cost reported across all phases, in nano-AIU.
+     */
+    totalNanoAiu: number;
+    /**
+     * Identifier of the session turn associated with the completion.
+     */
+    turnId: string;
+}
 /**
  * Session event "user.message". Payload of `user.message` with displayed and model-transformed content, attachments, source/delivery metadata, mode, and telemetry IDs.
  */
@@ -3186,75 +3632,270 @@ export interface PendingMessagesModifiedEvent {
      */
     timestamp: string;
     /**
-     * Type discriminator. Always "pending_messages.modified".
+     * Type discriminator. Always "pending_messages.modified".
+     */
+    type: "pending_messages.modified";
+}
+/**
+ * Empty payload; the event signals that the pending message queue has changed
+ */
+export interface PendingMessagesModifiedData {
+}
+/**
+ * Session event "assistant.turn_start". Turn initialization metadata including identifier and interaction tracking
+ */
+export interface AssistantTurnStartEvent {
+    /**
+     * Sub-agent instance identifier. Absent for events from the root/main agent and session-level events.
+     */
+    agentId?: string;
+    data: AssistantTurnStartData;
+    /**
+     * When true, the event is transient and not persisted to the session event log on disk
+     */
+    ephemeral?: boolean;
+    /**
+     * Unique event identifier (UUID v4), generated when the event is emitted
+     */
+    id: string;
+    /**
+     * ID of the chronologically preceding event in the session, forming a linked chain. Null for the first event.
+     */
+    parentId: string | null;
+    /**
+     * ISO 8601 timestamp when the event was created
+     */
+    timestamp: string;
+    /**
+     * Type discriminator. Always "assistant.turn_start".
+     */
+    type: "assistant.turn_start";
+}
+/**
+ * Turn initialization metadata including identifier and interaction tracking
+ */
+export interface AssistantTurnStartData {
+    /**
+     * CAPI interaction ID for correlating this turn with upstream telemetry
+     */
+    interactionId?: string;
+    /**
+     * Model identifier used for this turn, when known
+     */
+    model?: string;
+    /**
+     * Identifier for this turn within the agentic loop, typically a stringified turn number
+     */
+    turnId: string;
+}
+/**
+ * Session event "assistant.intent". Agent intent description for current activity or plan
+ */
+export interface AssistantIntentEvent {
+    /**
+     * Sub-agent instance identifier. Absent for events from the root/main agent and session-level events.
+     */
+    agentId?: string;
+    data: AssistantIntentData;
+    /**
+     * Always true for events that are transient and not persisted to the session event log on disk.
+     */
+    ephemeral: true;
+    /**
+     * Unique event identifier (UUID v4), generated when the event is emitted
+     */
+    id: string;
+    /**
+     * ID of the chronologically preceding event in the session, forming a linked chain. Null for the first event.
+     */
+    parentId: string | null;
+    /**
+     * ISO 8601 timestamp when the event was created
+     */
+    timestamp: string;
+    /**
+     * Type discriminator. Always "assistant.intent".
+     */
+    type: "assistant.intent";
+}
+/**
+ * Agent intent description for current activity or plan
+ */
+export interface AssistantIntentData {
+    /**
+     * Short description of what the agent is currently doing or planning to do
+     */
+    intent: string;
+}
+/**
+ * Session event "assistant.fusion_phase_started". Experimental transient HydraFusion phase/model/role signal.
+ */
+/** @experimental */
+export interface AssistantFusionPhaseStartedEvent {
+    /**
+     * Sub-agent instance identifier. Absent for events from the root/main agent and session-level events.
+     */
+    agentId?: string;
+    data: FusionPhaseStartedData;
+    /**
+     * Always true for events that are transient and not persisted to the session event log on disk.
+     */
+    ephemeral: true;
+    /**
+     * Unique event identifier (UUID v4), generated when the event is emitted
+     */
+    id: string;
+    /**
+     * ID of the chronologically preceding event in the session, forming a linked chain. Null for the first event.
+     */
+    parentId: string | null;
+    /**
+     * ISO 8601 timestamp when the event was created
+     */
+    timestamp: string;
+    /**
+     * Type discriminator. Always "assistant.fusion_phase_started".
+     */
+    type: "assistant.fusion_phase_started";
+}
+/**
+ * Experimental transient HydraFusion phase/model/role signal.
+ */
+/** @experimental */
+export interface FusionPhaseStartedData {
+    conversationScope: FusionConversationScope;
+    /**
+     * Identifier of the HydraFusion turn containing the phase.
+     */
+    fusionId: string;
+    /**
+     * Concrete model executing the phase.
+     */
+    model: string;
+    pattern: FusionPattern;
+    /**
+     * Stable identifier for the concrete phase.
+     */
+    phaseId: string;
+    phaseKind: FusionPhaseKind;
+    /**
+     * Semantic role assigned to the phase.
+     */
+    role: string;
+}
+/**
+ * Session event "assistant.fusion_phase_completed". Experimental durable HydraFusion phase output and lossless replay checkpoint.
+ */
+/** @experimental */
+export interface AssistantFusionPhaseCompletedEvent {
+    /**
+     * Sub-agent instance identifier. Absent for events from the root/main agent and session-level events.
+     */
+    agentId?: string;
+    data: FusionPhaseCompletedData;
+    /**
+     * When true, the event is transient and not persisted to the session event log on disk
+     */
+    ephemeral?: boolean;
+    /**
+     * Unique event identifier (UUID v4), generated when the event is emitted
+     */
+    id: string;
+    /**
+     * ID of the chronologically preceding event in the session, forming a linked chain. Null for the first event.
+     */
+    parentId: string | null;
+    /**
+     * ISO 8601 timestamp when the event was created
+     */
+    timestamp: string;
+    /**
+     * Type discriminator. Always "assistant.fusion_phase_completed".
      */
-    type: "pending_messages.modified";
-}
-/**
- * Empty payload; the event signals that the pending message queue has changed
- */
-export interface PendingMessagesModifiedData {
+    type: "assistant.fusion_phase_completed";
 }
 /**
- * Session event "assistant.turn_start". Turn initialization metadata including identifier and interaction tracking
+ * Experimental durable HydraFusion phase output and lossless replay checkpoint.
  */
-export interface AssistantTurnStartEvent {
+/** @experimental */
+export interface FusionPhaseCompletedData {
     /**
-     * Sub-agent instance identifier. Absent for events from the root/main agent and session-level events.
+     * Provider-normalized textual output produced by the phase.
      */
-    agentId?: string;
-    data: AssistantTurnStartData;
+    content: string;
+    conversationScope: FusionConversationScope;
     /**
-     * When true, the event is transient and not persisted to the session event log on disk
+     * Elapsed execution time for the phase in milliseconds.
      */
-    ephemeral?: boolean;
+    durationMs: number;
     /**
-     * Unique event identifier (UUID v4), generated when the event is emitted
+     * Identifier of the HydraFusion turn containing the phase.
      */
-    id: string;
+    fusionId: string;
     /**
-     * ID of the chronologically preceding event in the session, forming a linked chain. Null for the first event.
+     * Concrete model that executed the phase.
      */
-    parentId: string | null;
+    model: string;
     /**
-     * ISO 8601 timestamp when the event was created
+     * Stable identifier for the completed phase.
      */
-    timestamp: string;
+    phaseId: string;
+    phaseKind: FusionPhaseKind;
     /**
-     * Type discriminator. Always "assistant.turn_start".
+     * Semantic role assigned to the completed phase.
      */
-    type: "assistant.turn_start";
+    role: string;
+    status: FusionPhaseStatus;
+    usage: FusionPhaseUsage;
+    /**
+     * Structured judge or critic verdict, when the phase produces one.
+     */
+    verdict: string | null;
 }
 /**
- * Turn initialization metadata including identifier and interaction tracking
+ * Aggregate concrete-model usage for one HydraFusion phase.
  */
-export interface AssistantTurnStartData {
+/** @experimental */
+export interface FusionPhaseUsage {
     /**
-     * CAPI interaction ID for correlating this turn with upstream telemetry
+     * Total cached input tokens reported for the phase.
      */
-    interactionId?: string;
+    cachedTokens: number;
     /**
-     * Model identifier used for this turn, when known
+     * Total tokens written to prompt cache during the phase.
      */
-    model?: string;
+    cacheWriteTokens?: number;
     /**
-     * Identifier for this turn within the agentic loop, typically a stringified turn number
+     * Total input tokens consumed by the phase.
      */
-    turnId: string;
+    inputTokens: number;
+    /**
+     * Total output tokens produced by the phase.
+     */
+    outputTokens: number;
+    /**
+     * Number of concrete model requests made by the phase.
+     */
+    requestCount: number;
+    /**
+     * Total normalized AI-unit cost reported for the phase, in nano-AIU.
+     */
+    totalNanoAiu: number;
 }
 /**
- * Session event "assistant.intent". Agent intent description for current activity or plan
+ * Session event "assistant.fusion_phase_failed". Experimental durable typed HydraFusion phase failure and degradation transition.
  */
-export interface AssistantIntentEvent {
+/** @experimental */
+export interface AssistantFusionPhaseFailedEvent {
     /**
      * Sub-agent instance identifier. Absent for events from the root/main agent and session-level events.
      */
     agentId?: string;
-    data: AssistantIntentData;
+    data: FusionPhaseFailedData;
     /**
-     * Always true for events that are transient and not persisted to the session event log on disk.
+     * When true, the event is transient and not persisted to the session event log on disk
      */
-    ephemeral: true;
+    ephemeral?: boolean;
     /**
      * Unique event identifier (UUID v4), generated when the event is emitted
      */
@@ -3268,18 +3909,51 @@ export interface AssistantIntentEvent {
      */
     timestamp: string;
     /**
-     * Type discriminator. Always "assistant.intent".
+     * Type discriminator. Always "assistant.fusion_phase_failed".
      */
-    type: "assistant.intent";
+    type: "assistant.fusion_phase_failed";
 }
 /**
- * Agent intent description for current activity or plan
+ * Experimental durable typed HydraFusion phase failure and degradation transition.
  */
-export interface AssistantIntentData {
+/** @experimental */
+export interface FusionPhaseFailedData {
+    conversationScope: FusionConversationScope;
     /**
-     * Short description of what the agent is currently doing or planning to do
+     * Identifier of the fallback phase used to continue the turn after degradation.
      */
-    intent: string;
+    degradedToPhaseId?: string;
+    /**
+     * Elapsed execution time before the phase failed, in milliseconds.
+     */
+    durationMs: number;
+    /**
+     * Provider or execution error detail, when available.
+     */
+    errorMessage?: string;
+    /**
+     * Identifier of the HydraFusion turn containing the phase.
+     */
+    fusionId: string;
+    /**
+     * Concrete model that attempted the phase.
+     */
+    model: string;
+    /**
+     * Stable identifier for the failed phase.
+     */
+    phaseId: string;
+    phaseKind: FusionPhaseKind;
+    /**
+     * Stable machine-readable reason for the phase failure.
+     */
+    reason: string;
+    /**
+     * Semantic role assigned to the failed phase.
+     */
+    role: string;
+    status: FusionPhaseStatus;
+    usage: FusionPhaseUsage;
 }
 /**
  * Session event "assistant.server_tool_progress". Live progress signal for a provider-hosted server tool (e.g. hosted web search) while it runs, before the finalized serverTools envelope lands on the terminal assistant.message
@@ -3569,6 +4243,12 @@ export interface AssistantMessageData {
      * Encrypted reasoning content from OpenAI models. Session-bound and stripped on resume.
      */
     encryptedContent?: string;
+    /**
+     * Experimental HydraFusion source attribution for this ordinary authoritative assistant message.
+     *
+     * @experimental
+     */
+    fusion?: FusionAttribution;
     /**
      * CAPI interaction ID for correlating this message with upstream telemetry
      */
@@ -3594,6 +4274,7 @@ export interface AssistantMessageData {
      * Generation phase for phased-output models (e.g., thinking vs. response phases)
      */
     phase?: string;
+    reasoningBlocks?: AssistantMessageReasoningBlocks;
     /**
      * Opaque/encrypted extended thinking data from Anthropic models. Session-bound and stripped on resume.
      */
@@ -3756,6 +4437,70 @@ export interface CitationLocationBlock {
      */
     type: "block";
 }
+/**
+ * Experimental attribution linking an ordinary event to the HydraFusion turn, phase, and concrete source that produced it.
+ */
+/** @experimental */
+export interface FusionAttribution {
+    /**
+     * Idempotency identifier for the authoritative commit, when the event belongs to the selected output.
+     */
+    commitId?: string;
+    /**
+     * Conversation scope in which the concrete phase executed.
+     */
+    conversationScope?: string;
+    /**
+     * Stable identifier for the HydraFusion turn that produced the event.
+     */
+    fusionId: string;
+    /**
+     * HydraFusion orchestration pattern selected for the turn.
+     */
+    pattern: string;
+    /**
+     * Identifier of the concrete phase that produced the event.
+     */
+    phaseId?: string;
+    /**
+     * Kind of concrete phase that produced the event.
+     */
+    phaseKind?: string;
+    /**
+     * HydraFusion routing policy used for the turn.
+     */
+    policy: string;
+    /**
+     * Semantic role assigned to the concrete phase.
+     */
+    role?: string;
+    /**
+     * Concrete model that produced the attributed event.
+     */
+    sourceModel?: string;
+    /**
+     * Phase whose output supplied the authoritative content, when different from the executing phase.
+     */
+    sourcePhaseId?: string;
+    /**
+     * Synthetic HydraFusion model selected for the session.
+     */
+    syntheticModel: string;
+}
+/**
+ * Neutral provider-tagged reasoning content blocks preserved verbatim for round-tripping
+ */
+/** @experimental */
+export interface AssistantMessageReasoningBlocks {
+    /**
+     * Provider-native reasoning content blocks (e.g. Anthropic `thinking` / `redacted_thinking`) preserved verbatim, in order. A single response can carry several, each signed over the content preceding it, so dropping or reordering any of them invalidates the rest.
+     */
+    blocks?: JsonValue[];
+    /**
+     * Model provider that produced these reasoning blocks.
+     */
+    provider: string;
+}
 /**
  * Neutral provider-tagged server-side tool-use payload (tool search, advisor) for verbatim round-tripping
  */
@@ -4065,6 +4810,12 @@ export interface AssistantUsageData {
      * Finish reason reported by the model for this API call (e.g. "stop", "length", "tool_calls", "content_filter"). Normalized to OpenAI vocabulary; for Anthropic models a "refusal" stop reason maps to "content_filter".
      */
     finishReason?: string;
+    /**
+     * Experimental HydraFusion attribution for this concrete model call's usage.
+     *
+     * @experimental
+     */
+    fusion?: FusionAttribution;
     /**
      * What initiated this API call (e.g., "sub-agent", "mcp-sampling"); absent for user-initiated calls
      */
@@ -4105,6 +4856,10 @@ export interface AssistantUsageData {
      * Number of output tokens produced
      */
     outputTokens?: number;
+    /**
+     * Time to first observable model output in milliseconds. Includes text, reasoning, and tool-call output; only available for streaming requests that produce observable output.
+     */
+    outputTtftMs?: number;
     /**
      * @deprecated
      * Parent tool call ID when this usage originates from a sub-agent
@@ -4228,6 +4983,12 @@ export interface ModelCallFailureData {
      */
     errorType?: string;
     failureKind?: ModelCallFailureKind;
+    /**
+     * Experimental HydraFusion attribution for this failed concrete model call.
+     *
+     * @experimental
+     */
+    fusion?: FusionAttribution;
     /**
      * What initiated this API call (e.g., "sub-agent", "mcp-sampling"); absent for user-initiated calls
      */
@@ -4313,6 +5074,62 @@ export interface ModelCallFailureRequestFingerprint {
      */
     toolResultMessageCount: number;
 }
+/**
+ * Session event "model.call_finished". Final lifecycle outcome for one logical model dispatch. A logical dispatch may include internal reconnect or fallback work, so event count is not provider HTTP-request count.
+ */
+export interface ModelCallFinishedEvent {
+    /**
+     * Sub-agent instance identifier. Absent for events from the root/main agent and session-level events.
+     */
+    agentId?: string;
+    data: ModelCallFinishedData;
+    /**
+     * Always true for events that are transient and not persisted to the session event log on disk.
+     */
+    ephemeral: true;
+    /**
+     * Unique event identifier (UUID v4), generated when the event is emitted
+     */
+    id: string;
+    /**
+     * ID of the chronologically preceding event in the session, forming a linked chain. Null for the first event.
+     */
+    parentId: string | null;
+    /**
+     * ISO 8601 timestamp when the event was created
+     */
+    timestamp: string;
+    /**
+     * Type discriminator. Always "model.call_finished".
+     */
+    type: "model.call_finished";
+}
+/**
+ * Final lifecycle outcome for one logical model dispatch. A logical dispatch may include internal reconnect or fallback work, so event count is not provider HTTP-request count.
+ */
+export interface ModelCallFinishedData {
+    /**
+     * Whether an accepted successful response requested the exact name and command semantics of a built-in file edit tool, including an external tool explicitly replacing that built-in name. Absent when the logical dispatch did not produce an accepted response.
+     */
+    containsBuiltInFileEditRequest?: boolean;
+    /**
+     * Monotonic elapsed time spent in the logical model dispatch, including any internal transport reconnect or fallback and excluding orchestrator retry backoff, tool execution, confirmations, and post-response processing
+     */
+    dispatchDurationMs: number;
+    /**
+     * Version of the built-in file-edit semantic classifier used for this event
+     */
+    editClassifierVersion: number;
+    /**
+     * Identifier of the user interaction that owns the model dispatch, matching assistant.turn_start.interactionId when available
+     */
+    interactionId?: string;
+    outcome: ModelCallFinishedOutcome;
+    /**
+     * Agent-loop iteration within the interaction that initiated the model dispatch
+     */
+    turnId: string;
+}
 /**
  * Session event "abort". Turn abort information including the reason for termination
  */
@@ -4438,6 +5255,12 @@ export interface ToolExecutionStartData {
      * When true, the tool output should be displayed expanded (verbatim) in the CLI timeline
      */
     displayVerbatim?: boolean;
+    /**
+     * Experimental HydraFusion attribution for this tool execution.
+     *
+     * @experimental
+     */
+    fusion?: FusionAttribution;
     /**
      * Name of the MCP server hosting this tool, when the tool is an MCP tool
      */
@@ -4647,6 +5470,12 @@ export interface ToolExecutionCompleteEvent {
  */
 export interface ToolExecutionCompleteData {
     error?: ToolExecutionCompleteError;
+    /**
+     * Experimental HydraFusion attribution for this tool completion.
+     *
+     * @experimental
+     */
+    fusion?: FusionAttribution;
     /**
      * CAPI interaction ID for correlating this tool execution with upstream telemetry
      */
@@ -4904,6 +5733,10 @@ export interface ToolExecutionCompleteContentShellExit {
      * Exit code from the completed shell command
      */
     exitCode: number;
+    /**
+     * Path reported in the shell session's filesystem namespace when shell output exceeded the configured large-output threshold.
+     */
+    outputFilePath?: string;
     /**
      * Output associated with this shell command, if available. May be partial, truncated, or a preview; not guaranteed to be full output.
      */
@@ -5341,6 +6174,14 @@ export interface SubagentStartedData {
      * Internal name of the sub-agent
      */
     agentName: string;
+    /**
+     * Type of the sub-agent selected at spawn time.
+     */
+    agentType?: string;
+    /**
+     * Whether the sub-agent runs synchronously or in the background.
+     */
+    executionMode?: string;
     /**
      * Root id of the factory run that spawned this sub-agent, when it was spawned by one.
      */
@@ -5349,11 +6190,70 @@ export interface SubagentStartedData {
      * Model the sub-agent will run with, when known at start.
      */
     model?: string;
+    /**
+     * Task-registry ID of the spawning sub-agent. Absent when the root session spawned this child.
+     */
+    parentId?: string;
+    /**
+     * Whether this sub-agent can be resumed. Currently always false.
+     */
+    resumable?: boolean;
     /**
      * Tool call ID of the parent tool invocation that spawned this sub-agent
      */
     toolCallId: string;
 }
+/**
+ * Session event "subagent.configured". Resolved runtime configuration for a configured sub-agent
+ */
+export interface SubagentConfiguredEvent {
+    /**
+     * Sub-agent instance identifier. Absent for events from the root/main agent and session-level events.
+     */
+    agentId?: string;
+    data: SubagentConfiguredData;
+    /**
+     * When true, the event is transient and not persisted to the session event log on disk
+     */
+    ephemeral?: boolean;
+    /**
+     * Unique event identifier (UUID v4), generated when the event is emitted
+     */
+    id: string;
+    /**
+     * ID of the chronologically preceding event in the session, forming a linked chain. Null for the first event.
+     */
+    parentId: string | null;
+    /**
+     * ISO 8601 timestamp when the event was created
+     */
+    timestamp: string;
+    /**
+     * Type discriminator. Always "subagent.configured".
+     */
+    type: "subagent.configured";
+}
+/**
+ * Resolved runtime configuration for a configured sub-agent
+ */
+export interface SubagentConfiguredData {
+    /**
+     * Resolved context tier, when configured for the model
+     */
+    contextTier?: string;
+    /**
+     * Resolved model the sub-agent will run with
+     */
+    model: string;
+    /**
+     * Whether the sub-agent accepts follow-up turns
+     */
+    multiTurn: boolean;
+    /**
+     * Resolved reasoning effort, when configured for the model
+     */
+    reasoningEffort?: string;
+}
 /**
  * Session event "subagent.completed". Sub-agent completion details for successful execution
  */
@@ -5400,10 +6300,30 @@ export interface SubagentCompletedData {
      * Whether the sub-agent was torn down by cancellation - its own abort, or an ancestor being killed - instead of finishing its work. Cancellation is not a failure, so the run still reports completion; this distinguishes a torn-down sub-agent from one that ran to the end.
      */
     cancelled?: boolean;
+    /**
+     * Whether the first model actually dispatched matched the user's configured preference
+     */
+    configuredModelMatchesActual?: boolean;
+    /**
+     * Concrete model the user configured for this sub-agent via `/subagents`, when present
+     */
+    configuredModelPreference?: string;
     /**
      * Wall-clock duration of the sub-agent execution in milliseconds
      */
     durationMs?: number;
+    /**
+     * Whether the explicit task-call model matched the user's configured preference
+     */
+    explicitModelMatchesPreference?: boolean;
+    /**
+     * Explicit model supplied by the parent agent on the task call, when present
+     */
+    explicitModelOverride?: string;
+    /**
+     * First model for which the sub-agent started an inference request, when one was dispatched
+     */
+    firstDispatchedModel?: string;
     /**
      * Model used by the sub-agent
      */
@@ -5463,6 +6383,14 @@ export interface SubagentFailedData {
      * Internal name of the sub-agent
      */
     agentName: string;
+    /**
+     * Whether the first model actually dispatched matched the user's configured preference
+     */
+    configuredModelMatchesActual?: boolean;
+    /**
+     * Concrete model the user configured for this sub-agent via `/subagents`, when present
+     */
+    configuredModelPreference?: string;
     /**
      * Wall-clock duration of the sub-agent execution in milliseconds
      */
@@ -5471,6 +6399,18 @@ export interface SubagentFailedData {
      * Error message describing why the sub-agent failed
      */
     error: string;
+    /**
+     * Whether the explicit task-call model matched the user's configured preference
+     */
+    explicitModelMatchesPreference?: boolean;
+    /**
+     * Explicit model supplied by the parent agent on the task call, when present
+     */
+    explicitModelOverride?: string;
+    /**
+     * First model for which the sub-agent started an inference request, when one was dispatched
+     */
+    firstDispatchedModel?: string;
     /**
      * Model selected for the sub-agent, when known
      */
@@ -5616,6 +6556,10 @@ export interface HookStartData {
      * Input data passed to the hook
      */
     input?: JsonValue;
+    /**
+     * Tool call ID of the parent tool invocation when this event originates from a sub-agent
+     */
+    parentToolCallId?: string;
 }
 /**
  * Session event "hook.end". Hook invocation completion details including output, success status, and error information
@@ -5664,6 +6608,10 @@ export interface HookEndData {
      * Output data produced by the hook
      */
     output?: JsonValue;
+    /**
+     * Tool call ID of the parent tool invocation when this event originates from a sub-agent
+     */
+    parentToolCallId?: string;
     /**
      * Whether the hook completed successfully
      */
@@ -6784,6 +7732,10 @@ export interface PermissionPromptRequestMcp {
      * @experimental
      */
     assistedApproval?: PermissionAssistedApproval;
+    /**
+     * Whether the host may offer a server-wide "approve all tools from this server" blanket. Absent is treated as true; the runtime sends false when managed policy disables bypass-permissions mode, which forbids the server-wide escalation while still allowing per-tool approval.
+     */
+    canOfferServerWideApproval?: boolean;
     /**
      * Prompt kind discriminator
      */
@@ -8709,6 +9661,10 @@ export interface ManagedSettingsResolvedData {
      * Whether at least two managed sources supplied permission allowlists, so enforcement intersects them and the flattened settings payload omits `permissions.allow`.
      */
     permissionsAllowIntersected?: boolean;
+    /**
+     * Whether the effective sandbox policy forces the sandbox on *only* because managed policy could not be determined, rather than because the policy requires it. Lets clients tell a user whose `--no-sandbox` was overridden that the sandbox stayed on as a fail-closed fallback, instead of attributing it to an administrator who set no such policy.
+     */
+    sandboxEnabledByUndeterminedPolicy?: boolean;
     /**
      * Whether the server (account/org) managed-settings layer was present
      */