@github/copilot-sdk 1.0.13-preview.1 → 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 | ModelCallFinishedEvent | 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.
  */
@@ -1170,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
@@ -2482,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
      */
@@ -2660,18 +2733,19 @@ export interface TaskCompleteData {
     summary?: string;
 }
 /**
- * Session event "user.message". Payload of `user.message` with displayed and model-transformed content, attachments, source/delivery metadata, mode, and telemetry IDs.
+ * Session event "session.fusion_route_started". Experimental transient signal that HydraFusion routing has started for an eligible turn.
  */
-export interface UserMessageEvent {
+/** @experimental */
+export interface FusionRouteStartedEvent {
     /**
      * Sub-agent instance identifier. Absent for events from the root/main agent and session-level events.
      */
     agentId?: string;
-    data: UserMessageData;
+    data: FusionRouteStartedData;
     /**
-     * When true, the event is transient and not persisted to the session event log on disk
+     * Always true for events that are transient and not persisted to the session event log on disk.
      */
-    ephemeral?: boolean;
+    ephemeral: true;
     /**
      * Unique event identifier (UUID v4), generated when the event is emitted
      */
@@ -2685,287 +2759,645 @@ export interface UserMessageEvent {
      */
     timestamp: string;
     /**
-     * Type discriminator. Always "user.message".
+     * Type discriminator. Always "session.fusion_route_started".
      */
-    type: "user.message";
+    type: "session.fusion_route_started";
 }
 /**
- * Payload of `user.message` with displayed and model-transformed content, attachments, source/delivery metadata, mode, and telemetry IDs.
+ * Experimental transient signal that HydraFusion routing has started for an eligible turn.
  */
-export interface UserMessageData {
-    agentMode?: UserMessageAgentMode;
-    /**
-     * Files, selections, or GitHub references attached to the message
-     */
-    attachments?: Attachment[];
+/** @experimental */
+export interface FusionRouteStartedData {
     /**
-     * The user's message text as displayed in the timeline
+     * Identifier for this routing attempt before a durable Fusion turn exists.
      */
-    content: string;
-    delivery?: UserMessageDelivery;
+    attemptId: string;
     /**
-     * CAPI interaction ID for correlating this user message with its turn
+     * HydraFusion routing policy requested for the turn.
      */
-    interactionId?: string;
+    policy?: string;
     /**
-     * True when this user message was auto-injected by autopilot's continuation loop rather than typed by the user; used to distinguish autopilot-driven turns in telemetry.
+     * Synthetic HydraFusion model selected for the session.
      */
-    isAutopilotContinuation?: boolean;
+    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 {
     /**
-     * Path-backed native document attachments that stayed on the tagged_files path flow because native upload could not read them or would exceed the request size limit
+     * Sub-agent instance identifier. Absent for events from the root/main agent and session-level events.
      */
-    nativeDocumentPathFallbackPaths?: string[];
+    agentId?: string;
+    data: FusionRouteFailedData;
     /**
-     * Parent agent task ID for background telemetry correlated to this user turn
+     * When true, the event is transient and not persisted to the session event log on disk
      */
-    parentAgentTaskId?: string;
+    ephemeral?: boolean;
     /**
-     * Origin of this message, used for timeline filtering and attribution (e.g., `skill-pdf` for hidden skill injection or `agent-<agent-id>` for an inter-agent prompt)
+     * Unique event identifier (UUID v4), generated when the event is emitted
      */
-    source?: string;
+    id: string;
     /**
-     * Normalized document MIME types that were sent natively instead of through tagged_files XML
+     * ID of the chronologically preceding event in the session, forming a linked chain. Null for the first event.
      */
-    supportedNativeDocumentMimeTypes?: string[];
+    parentId: string | null;
     /**
-     * Transformed version of the message sent to the model, with XML wrapping, timestamps, and other augmentations for prompt caching
+     * ISO 8601 timestamp when the event was created
      */
-    transformedContent?: string;
+    timestamp: string;
     /**
-     * The agent-loop turn ID that consumed this message; absent when no agent-loop turn consumed it
+     * Type discriminator. Always "session.fusion_route_failed".
      */
-    turnId?: string;
+    type: "session.fusion_route_failed";
 }
 /**
- * File attachment
+ * Experimental durable HydraFusion routing failure and the deterministic concrete fallback selected for the turn.
  */
-export interface AttachmentFile {
+/** @experimental */
+export interface FusionRouteFailedData {
     /**
-     * Internal: content-addressed id of the session.binary_asset event holding this attachment's model-facing bytes (e.g. "sha256:..."). Absent externally.
+     * Identifier of the routing attempt that failed.
      */
-    assetId?: string;
+    attemptId: string;
     /**
-     * Internal: decoded byte length of the attachment's model-facing bytes. Absent externally.
+     * Provider or validation error detail, when available.
      */
-    byteLength?: number;
+    errorMessage?: string;
     /**
-     * User-facing display name for the attachment
+     * Concrete model selected as the deterministic fallback.
      */
-    displayName: string;
-    lineRange?: AttachmentFileLineRange;
+    fallbackModel: string;
     /**
-     * Internal: MIME type of the file's model-facing bytes (post-resize for images). Set when the file's bytes are interned to an asset. Absent externally.
+     * HydraFusion routing policy requested for the turn.
      */
-    mimeType?: string;
-    omittedReason?: OmittedBinaryOmittedReason;
+    policy: string;
     /**
-     * Absolute file path
+     * Stable machine-readable reason for the routing failure.
      */
-    path: string;
+    reason: string;
     /**
-     * Frozen rendered line this attachment contributed to the <tagged_files> prompt block (e.g. "* /path (123 lines)"). Captured at send time so resumed history reproduces the exact text the model saw, independent of later filesystem changes. Present only for attachments routed to <tagged_files> (mutually exclusive with assetId, which marks bytes sent natively).
+     * Elapsed routing time in milliseconds before the failure.
      */
-    taggedFilesEntry?: string;
+    routingLatencyMs?: number;
     /**
-     * Attachment type discriminator
+     * Synthetic HydraFusion model selected for the session.
      */
-    type: "file";
+    syntheticModel: string;
 }
 /**
- * Optional line range to scope the attachment to a specific section of the file
+ * Session event "session.fusion_resolved". Experimental durable validated HydraFusion route and turn policy.
  */
-export interface AttachmentFileLineRange {
+/** @experimental */
+export interface FusionResolvedEvent {
     /**
-     * End line number (1-based, inclusive)
+     * Sub-agent instance identifier. Absent for events from the root/main agent and session-level events.
      */
-    end: number;
+    agentId?: string;
+    data: FusionResolvedData;
     /**
-     * Start line number (1-based)
+     * When true, the event is transient and not persisted to the session event log on disk
      */
-    start: number;
-}
-/**
- * Directory attachment
- */
-export interface AttachmentDirectory {
+    ephemeral?: boolean;
     /**
-     * User-facing display name for the attachment
+     * Unique event identifier (UUID v4), generated when the event is emitted
      */
-    displayName: string;
+    id: string;
     /**
-     * Absolute directory path
+     * ID of the chronologically preceding event in the session, forming a linked chain. Null for the first event.
      */
-    path: string;
+    parentId: string | null;
     /**
-     * Frozen rendered line this attachment contributed to the <tagged_files> prompt block (e.g. "* /path (12 items)"). Captured at send time so resumed history reproduces the exact text the model saw, independent of later filesystem changes.
+     * ISO 8601 timestamp when the event was created
      */
-    taggedFilesEntry?: string;
+    timestamp: string;
     /**
-     * Attachment type discriminator
+     * Type discriminator. Always "session.fusion_resolved".
      */
-    type: "directory";
+    type: "session.fusion_resolved";
 }
 /**
- * Code selection attachment from an editor
+ * Experimental durable validated HydraFusion route and turn policy.
  */
-export interface AttachmentSelection {
+/** @experimental */
+export interface FusionResolvedData {
     /**
-     * User-facing display name for the selection
+     * Version of the validated HydraFusion event contract.
      */
-    displayName: string;
+    contractVersion: number;
     /**
-     * Absolute path to the file containing the selection
+     * Concrete model used when the planned primary model cannot execute.
      */
-    filePath: string;
-    selection: AttachmentSelectionDetails;
+    fallbackModel: string;
+    followUp?: FusionFollowUpRecommendation;
     /**
-     * The selected text content
+     * Concrete model recommended for eligible follow-up turns.
      */
-    text: string;
+    followUpModel: string;
     /**
-     * Attachment type discriminator
+     * Stable identifier for the resolved HydraFusion turn.
      */
-    type: "selection";
-}
-/**
- * Position range of the selection within the file
- */
-export interface AttachmentSelectionDetails {
-    end: AttachmentSelectionDetailsEnd;
-    start: AttachmentSelectionDetailsStart;
-}
-/**
- * End position of the selection
- */
-export interface AttachmentSelectionDetailsEnd {
+    fusionId: string;
     /**
-     * End character offset within the line (0-based)
+     * Version of the executable model universe used for selection.
      */
-    character: number;
+    modelUniverseVersion?: string;
+    pattern: FusionPattern;
     /**
-     * End line number (0-based)
+     * Version of the validated execution-plan format.
      */
-    line: number;
-}
-/**
- * Start position of the selection
- */
-export interface AttachmentSelectionDetailsStart {
+    planVersion?: string;
     /**
-     * Start character offset within the line (0-based)
+     * HydraFusion routing policy used to resolve the plan.
      */
-    character: number;
+    policy: string;
     /**
-     * Start line number (0-based)
+     * Version of the local routing policy.
      */
-    line: number;
-}
-/**
- * GitHub issue, pull request, or discussion reference
- */
-export interface AttachmentGitHubReference {
+    policyVersion?: string;
     /**
-     * Issue, pull request, or discussion number
+     * Concrete model selected for the primary solver phase.
      */
-    number: number;
-    referenceType: AttachmentGitHubReferenceType;
+    primaryModel: string;
     /**
-     * Current state of the referenced item (e.g., open, closed, merged)
+     * Router implementation that supplied the plan.
      */
-    state: string;
+    routeSource?: string;
     /**
-     * Title of the referenced item
+     * Elapsed time in milliseconds required to resolve and validate the route.
      */
-    title: string;
+    routingLatencyMs?: number;
     /**
-     * Attachment type discriminator
+     * Identifier of the local policy rule that matched.
      */
-    type: "github_reference";
+    ruleId?: string;
     /**
-     * URL to the referenced item on GitHub
+     * Zero-based index of the local policy rule that matched.
      */
-    url: string;
-}
-/**
- * Pointer to a GitHub commit.
- */
-export interface AttachmentGitHubCommit {
+    ruleIndex?: number;
     /**
-     * First line of the commit message
+     * Human-readable name of the local policy rule that matched.
      */
-    message: string;
+    ruleName?: string;
+    scores?: FusionScores;
     /**
-     * Full commit SHA
+     * Concrete model selected for the review or judge phase, when required.
      */
-    oid: string;
-    repo: GitHubRepoRef;
+    secondaryModel: string | null;
     /**
-     * Attachment type discriminator
+     * Synthetic HydraFusion model selected for the session.
      */
-    type: "github_commit";
+    syntheticModel: string;
     /**
-     * URL to the commit on GitHub
+     * Identifier of the session turn associated with the route.
      */
-    url: string;
+    turnId: string;
 }
 /**
- * Pointer to a GitHub repository.
+ * Durable server recommendation for subsequent HydraFusion turns.
  */
-export interface GitHubRepoRef {
-    /**
-     * Numeric GitHub repository id
-     */
-    id?: number;
-    /**
-     * Repository name (without owner)
-     */
-    name: string;
-    /**
-     * Repository owner login (user or organization)
-     */
-    owner: string;
+/** @experimental */
+export interface FusionFollowUpRecommendation {
+    compactionTurn: FusionFollowUpAction;
+    userTurn: FusionFollowUpAction;
 }
 /**
- * Pointer to a GitHub release.
+ * Validated HydraFusion routing capability scores.
  */
-export interface AttachmentGitHubRelease {
+/** @experimental */
+export interface FusionScores {
     /**
-     * Human-readable release name
+     * Code-generation capability score returned by the authenticated router.
      */
-    name: string;
-    repo: GitHubRepoRef;
+    codeGen: number;
     /**
-     * Git tag the release is anchored to
+     * Debugging capability score returned by the authenticated router.
      */
-    tagName: string;
+    debugging: number;
     /**
-     * Attachment type discriminator
+     * Reasoning capability score returned by the authenticated router.
      */
-    type: "github_release";
+    reasoning: number;
     /**
-     * URL to the release on GitHub
+     * Tool-use capability score returned by the authenticated router.
      */
-    url: string;
+    toolUse: number;
 }
 /**
- * Pointer to a GitHub Actions job.
+ * Session event "session.fusion_completed". Experimental durable aggregate outcome of a HydraFusion turn.
  */
-export interface AttachmentGitHubActionsJob {
+/** @experimental */
+export interface FusionCompletedEvent {
     /**
-     * Terminal conclusion of the job when finished (e.g., success, failure, cancelled). Absent for in-progress jobs.
+     * Sub-agent instance identifier. Absent for events from the root/main agent and session-level events.
      */
-    conclusion?: string;
+    agentId?: string;
+    data: FusionCompletedData;
     /**
-     * Job id within the workflow run
+     * When true, the event is transient and not persisted to the session event log on disk
      */
-    jobId: number;
+    ephemeral?: boolean;
     /**
-     * Display name of the job
+     * Unique event identifier (UUID v4), generated when the event is emitted
      */
-    jobName: string;
-    repo: GitHubRepoRef;
+    id: string;
     /**
-     * Attachment type discriminator
+     * 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.
+ */
+export interface UserMessageEvent {
+    /**
+     * Sub-agent instance identifier. Absent for events from the root/main agent and session-level events.
+     */
+    agentId?: string;
+    data: UserMessageData;
+    /**
+     * 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 "user.message".
+     */
+    type: "user.message";
+}
+/**
+ * Payload of `user.message` with displayed and model-transformed content, attachments, source/delivery metadata, mode, and telemetry IDs.
+ */
+export interface UserMessageData {
+    agentMode?: UserMessageAgentMode;
+    /**
+     * Files, selections, or GitHub references attached to the message
+     */
+    attachments?: Attachment[];
+    /**
+     * The user's message text as displayed in the timeline
+     */
+    content: string;
+    delivery?: UserMessageDelivery;
+    /**
+     * CAPI interaction ID for correlating this user message with its turn
+     */
+    interactionId?: string;
+    /**
+     * True when this user message was auto-injected by autopilot's continuation loop rather than typed by the user; used to distinguish autopilot-driven turns in telemetry.
+     */
+    isAutopilotContinuation?: boolean;
+    /**
+     * Path-backed native document attachments that stayed on the tagged_files path flow because native upload could not read them or would exceed the request size limit
+     */
+    nativeDocumentPathFallbackPaths?: string[];
+    /**
+     * Parent agent task ID for background telemetry correlated to this user turn
+     */
+    parentAgentTaskId?: string;
+    /**
+     * Origin of this message, used for timeline filtering and attribution (e.g., `skill-pdf` for hidden skill injection or `agent-<agent-id>` for an inter-agent prompt)
+     */
+    source?: string;
+    /**
+     * Normalized document MIME types that were sent natively instead of through tagged_files XML
+     */
+    supportedNativeDocumentMimeTypes?: string[];
+    /**
+     * Transformed version of the message sent to the model, with XML wrapping, timestamps, and other augmentations for prompt caching
+     */
+    transformedContent?: string;
+    /**
+     * The agent-loop turn ID that consumed this message; absent when no agent-loop turn consumed it
+     */
+    turnId?: string;
+}
+/**
+ * File attachment
+ */
+export interface AttachmentFile {
+    /**
+     * Internal: content-addressed id of the session.binary_asset event holding this attachment's model-facing bytes (e.g. "sha256:..."). Absent externally.
+     */
+    assetId?: string;
+    /**
+     * Internal: decoded byte length of the attachment's model-facing bytes. Absent externally.
+     */
+    byteLength?: number;
+    /**
+     * User-facing display name for the attachment
+     */
+    displayName: string;
+    lineRange?: AttachmentFileLineRange;
+    /**
+     * Internal: MIME type of the file's model-facing bytes (post-resize for images). Set when the file's bytes are interned to an asset. Absent externally.
+     */
+    mimeType?: string;
+    omittedReason?: OmittedBinaryOmittedReason;
+    /**
+     * Absolute file path
+     */
+    path: string;
+    /**
+     * Frozen rendered line this attachment contributed to the <tagged_files> prompt block (e.g. "* /path (123 lines)"). Captured at send time so resumed history reproduces the exact text the model saw, independent of later filesystem changes. Present only for attachments routed to <tagged_files> (mutually exclusive with assetId, which marks bytes sent natively).
+     */
+    taggedFilesEntry?: string;
+    /**
+     * Attachment type discriminator
+     */
+    type: "file";
+}
+/**
+ * Optional line range to scope the attachment to a specific section of the file
+ */
+export interface AttachmentFileLineRange {
+    /**
+     * End line number (1-based, inclusive)
+     */
+    end: number;
+    /**
+     * Start line number (1-based)
+     */
+    start: number;
+}
+/**
+ * Directory attachment
+ */
+export interface AttachmentDirectory {
+    /**
+     * User-facing display name for the attachment
+     */
+    displayName: string;
+    /**
+     * Absolute directory path
+     */
+    path: string;
+    /**
+     * Frozen rendered line this attachment contributed to the <tagged_files> prompt block (e.g. "* /path (12 items)"). Captured at send time so resumed history reproduces the exact text the model saw, independent of later filesystem changes.
+     */
+    taggedFilesEntry?: string;
+    /**
+     * Attachment type discriminator
+     */
+    type: "directory";
+}
+/**
+ * Code selection attachment from an editor
+ */
+export interface AttachmentSelection {
+    /**
+     * User-facing display name for the selection
+     */
+    displayName: string;
+    /**
+     * Absolute path to the file containing the selection
+     */
+    filePath: string;
+    selection: AttachmentSelectionDetails;
+    /**
+     * The selected text content
+     */
+    text: string;
+    /**
+     * Attachment type discriminator
+     */
+    type: "selection";
+}
+/**
+ * Position range of the selection within the file
+ */
+export interface AttachmentSelectionDetails {
+    end: AttachmentSelectionDetailsEnd;
+    start: AttachmentSelectionDetailsStart;
+}
+/**
+ * End position of the selection
+ */
+export interface AttachmentSelectionDetailsEnd {
+    /**
+     * End character offset within the line (0-based)
+     */
+    character: number;
+    /**
+     * End line number (0-based)
+     */
+    line: number;
+}
+/**
+ * Start position of the selection
+ */
+export interface AttachmentSelectionDetailsStart {
+    /**
+     * Start character offset within the line (0-based)
+     */
+    character: number;
+    /**
+     * Start line number (0-based)
+     */
+    line: number;
+}
+/**
+ * GitHub issue, pull request, or discussion reference
+ */
+export interface AttachmentGitHubReference {
+    /**
+     * Issue, pull request, or discussion number
+     */
+    number: number;
+    referenceType: AttachmentGitHubReferenceType;
+    /**
+     * Current state of the referenced item (e.g., open, closed, merged)
+     */
+    state: string;
+    /**
+     * Title of the referenced item
+     */
+    title: string;
+    /**
+     * Attachment type discriminator
+     */
+    type: "github_reference";
+    /**
+     * URL to the referenced item on GitHub
+     */
+    url: string;
+}
+/**
+ * Pointer to a GitHub commit.
+ */
+export interface AttachmentGitHubCommit {
+    /**
+     * First line of the commit message
+     */
+    message: string;
+    /**
+     * Full commit SHA
+     */
+    oid: string;
+    repo: GitHubRepoRef;
+    /**
+     * Attachment type discriminator
+     */
+    type: "github_commit";
+    /**
+     * URL to the commit on GitHub
+     */
+    url: string;
+}
+/**
+ * Pointer to a GitHub repository.
+ */
+export interface GitHubRepoRef {
+    /**
+     * Numeric GitHub repository id
+     */
+    id?: number;
+    /**
+     * Repository name (without owner)
+     */
+    name: string;
+    /**
+     * Repository owner login (user or organization)
+     */
+    owner: string;
+}
+/**
+ * Pointer to a GitHub release.
+ */
+export interface AttachmentGitHubRelease {
+    /**
+     * Human-readable release name
+     */
+    name: string;
+    repo: GitHubRepoRef;
+    /**
+     * Git tag the release is anchored to
+     */
+    tagName: string;
+    /**
+     * Attachment type discriminator
+     */
+    type: "github_release";
+    /**
+     * URL to the release on GitHub
+     */
+    url: string;
+}
+/**
+ * Pointer to a GitHub Actions job.
+ */
+export interface AttachmentGitHubActionsJob {
+    /**
+     * Terminal conclusion of the job when finished (e.g., success, failure, cancelled). Absent for in-progress jobs.
+     */
+    conclusion?: string;
+    /**
+     * Job id within the workflow run
+     */
+    jobId: number;
+    /**
+     * Display name of the job
+     */
+    jobName: string;
+    repo: GitHubRepoRef;
+    /**
+     * Attachment type discriminator
      */
     type: "github_actions_job";
     /**
@@ -3126,63 +3558,185 @@ export interface AttachmentBlob {
     /**
      * Base64-encoded content. Present on input and for external consumers; replaced by an internal `assetId` reference in persisted events when interned to a content-addressed asset.
      */
-    data?: string;
+    data?: string;
+    /**
+     * User-facing display name for the attachment
+     */
+    displayName?: string;
+    /**
+     * MIME type of the inline data
+     */
+    mimeType: string;
+    omittedReason?: OmittedBinaryOmittedReason;
+    /**
+     * Attachment type discriminator
+     */
+    type: "blob";
+}
+/**
+ * Structured context contributed by an extension. Composer pills displayed in the host are forwarded back through session.send.attachments, then rendered into the model prompt as an <extension_context> XML block.
+ */
+export interface AttachmentExtensionContext {
+    /**
+     * Provider-local canvas identifier when the push was bound to a canvas instance
+     */
+    canvasId?: string;
+    /**
+     * ISO 8601 timestamp captured by the runtime when the push was accepted
+     */
+    capturedAt: string;
+    /**
+     * Owning extension identifier. Runtime-derived from the caller's connection when produced via session.extensions.sendAttachmentsToMessage; preserved verbatim on subsequent transports.
+     */
+    extensionId: string;
+    /**
+     * Open canvas instance identifier when the push was bound to a canvas instance
+     */
+    instanceId?: string;
+    /**
+     * Caller-supplied JSON payload
+     */
+    payload?: JsonValue;
+    /**
+     * Human-readable composer pill label
+     */
+    title: string;
+    /**
+     * Attachment type discriminator
+     */
+    type: "extension_context";
+}
+/**
+ * Session event "pending_messages.modified". Empty payload; the event signals that the pending message queue has changed
+ */
+export interface PendingMessagesModifiedEvent {
+    /**
+     * Sub-agent instance identifier. Absent for events from the root/main agent and session-level events.
+     */
+    agentId?: string;
+    data: PendingMessagesModifiedData;
+    /**
+     * 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 "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 {
     /**
-     * User-facing display name for the attachment
+     * CAPI interaction ID for correlating this turn with upstream telemetry
      */
-    displayName?: string;
+    interactionId?: string;
     /**
-     * MIME type of the inline data
+     * Model identifier used for this turn, when known
      */
-    mimeType: string;
-    omittedReason?: OmittedBinaryOmittedReason;
+    model?: string;
     /**
-     * Attachment type discriminator
+     * Identifier for this turn within the agentic loop, typically a stringified turn number
      */
-    type: "blob";
+    turnId: string;
 }
 /**
- * Structured context contributed by an extension. Composer pills displayed in the host are forwarded back through session.send.attachments, then rendered into the model prompt as an <extension_context> XML block.
+ * Session event "assistant.intent". Agent intent description for current activity or plan
  */
-export interface AttachmentExtensionContext {
+export interface AssistantIntentEvent {
     /**
-     * Provider-local canvas identifier when the push was bound to a canvas instance
+     * Sub-agent instance identifier. Absent for events from the root/main agent and session-level events.
      */
-    canvasId?: string;
+    agentId?: string;
+    data: AssistantIntentData;
     /**
-     * ISO 8601 timestamp captured by the runtime when the push was accepted
+     * Always true for events that are transient and not persisted to the session event log on disk.
      */
-    capturedAt: string;
+    ephemeral: true;
     /**
-     * Owning extension identifier. Runtime-derived from the caller's connection when produced via session.extensions.sendAttachmentsToMessage; preserved verbatim on subsequent transports.
+     * Unique event identifier (UUID v4), generated when the event is emitted
      */
-    extensionId: string;
+    id: string;
     /**
-     * Open canvas instance identifier when the push was bound to a canvas instance
+     * ID of the chronologically preceding event in the session, forming a linked chain. Null for the first event.
      */
-    instanceId?: string;
+    parentId: string | null;
     /**
-     * Caller-supplied JSON payload
+     * ISO 8601 timestamp when the event was created
      */
-    payload?: JsonValue;
+    timestamp: string;
     /**
-     * Human-readable composer pill label
+     * Type discriminator. Always "assistant.intent".
      */
-    title: string;
+    type: "assistant.intent";
+}
+/**
+ * Agent intent description for current activity or plan
+ */
+export interface AssistantIntentData {
     /**
-     * Attachment type discriminator
+     * Short description of what the agent is currently doing or planning to do
      */
-    type: "extension_context";
+    intent: string;
 }
 /**
- * Session event "pending_messages.modified". Empty payload; the event signals that the pending message queue has changed
+ * Session event "assistant.fusion_phase_started". Experimental transient HydraFusion phase/model/role signal.
  */
-export interface PendingMessagesModifiedEvent {
+/** @experimental */
+export interface AssistantFusionPhaseStartedEvent {
     /**
      * Sub-agent instance identifier. Absent for events from the root/main agent and session-level events.
      */
     agentId?: string;
-    data: PendingMessagesModifiedData;
+    data: FusionPhaseStartedData;
     /**
      * Always true for events that are transient and not persisted to the session event log on disk.
      */
@@ -3200,24 +3754,45 @@ export interface PendingMessagesModifiedEvent {
      */
     timestamp: string;
     /**
-     * Type discriminator. Always "pending_messages.modified".
+     * Type discriminator. Always "assistant.fusion_phase_started".
      */
-    type: "pending_messages.modified";
+    type: "assistant.fusion_phase_started";
 }
 /**
- * Empty payload; the event signals that the pending message queue has changed
+ * Experimental transient HydraFusion phase/model/role signal.
  */
-export interface PendingMessagesModifiedData {
+/** @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.turn_start". Turn initialization metadata including identifier and interaction tracking
+ * Session event "assistant.fusion_phase_completed". Experimental durable HydraFusion phase output and lossless replay checkpoint.
  */
-export interface AssistantTurnStartEvent {
+/** @experimental */
+export interface AssistantFusionPhaseCompletedEvent {
     /**
      * Sub-agent instance identifier. Absent for events from the root/main agent and session-level events.
      */
     agentId?: string;
-    data: AssistantTurnStartData;
+    data: FusionPhaseCompletedData;
     /**
      * When true, the event is transient and not persisted to the session event log on disk
      */
@@ -3235,40 +3810,92 @@ export interface AssistantTurnStartEvent {
      */
     timestamp: string;
     /**
-     * Type discriminator. Always "assistant.turn_start".
+     * Type discriminator. Always "assistant.fusion_phase_completed".
      */
-    type: "assistant.turn_start";
+    type: "assistant.fusion_phase_completed";
 }
 /**
- * Turn initialization metadata including identifier and interaction tracking
+ * Experimental durable HydraFusion phase output and lossless replay checkpoint.
  */
-export interface AssistantTurnStartData {
+/** @experimental */
+export interface FusionPhaseCompletedData {
     /**
-     * CAPI interaction ID for correlating this turn with upstream telemetry
+     * Provider-normalized textual output produced by the phase.
      */
-    interactionId?: string;
+    content: string;
+    conversationScope: FusionConversationScope;
     /**
-     * Model identifier used for this turn, when known
+     * Elapsed execution time for the phase in milliseconds.
      */
-    model?: string;
+    durationMs: number;
     /**
-     * Identifier for this turn within the agentic loop, typically a stringified turn number
+     * Identifier of the HydraFusion turn containing the phase.
      */
-    turnId: string;
+    fusionId: string;
+    /**
+     * Concrete model that executed the phase.
+     */
+    model: string;
+    /**
+     * Stable identifier for the completed phase.
+     */
+    phaseId: string;
+    phaseKind: FusionPhaseKind;
+    /**
+     * Semantic role assigned to the completed phase.
+     */
+    role: string;
+    status: FusionPhaseStatus;
+    usage: FusionPhaseUsage;
+    /**
+     * Structured judge or critic verdict, when the phase produces one.
+     */
+    verdict: string | null;
 }
 /**
- * Session event "assistant.intent". Agent intent description for current activity or plan
+ * Aggregate concrete-model usage for one HydraFusion phase.
  */
-export interface AssistantIntentEvent {
+/** @experimental */
+export interface FusionPhaseUsage {
+    /**
+     * Total cached input tokens reported for the phase.
+     */
+    cachedTokens: number;
+    /**
+     * Total tokens written to prompt cache during the phase.
+     */
+    cacheWriteTokens?: number;
+    /**
+     * Total input tokens consumed by the phase.
+     */
+    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.fusion_phase_failed". Experimental durable typed HydraFusion phase failure and degradation transition.
+ */
+/** @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
      */
@@ -3282,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
@@ -3583,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
      */
@@ -3771,6 +4437,56 @@ 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
  */
@@ -4094,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
      */
@@ -4261,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
      */
@@ -4527,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
      */
@@ -4736,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
      */
@@ -4993,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.
      */
@@ -5430,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.
      */
@@ -5438,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
  */
@@ -5745,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
@@ -5793,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
      */