@codingame/monaco-vscode-api 37.6.0 → 38.0.0

package/vscode/src/vs/workbench/contrib/chat/browser/agentSessions/agentHost/stateToProgressAdapter.d.ts

@@ -1,11 +1,13 @@
+import { type IAgentContextUsage } from "../../../../../../platform/agentHost/common/meta/agentUsageMeta.js";
 import { IMarkdownString, MarkdownString } from "../../../../../../base/common/htmlContent.js";
 import { URI } from "../../../../../../base/common/uri.js";
 import { ToolCallStatus, ChatInputResponseKind, type ActiveTurn, type ChatInputAnswer, type ChatInputRequest, type ICompletedToolCall, type InputRequestResponsePart, type Message, type ToolCallPendingConfirmationState, type ToolCallState, type Turn, FileEditKind, ToolResultContentType, type ToolResultContent, type UsageInfo } from "../../../../../../platform/agentHost/common/state/sessionState.js";
 import type { IAgentHostPlanReview } from "../../../../../../platform/agentHost/common/agentHostPlanReview.js";
+import { type IAgentToolOutputChunk } from "../../../../../../platform/agentHost/common/meta/agentToolCallMeta.js";
 import { IChatErrorContext } from "../../../common/chatErrorMessages.js";
 import { type IAgentHostResourceUriMapper } from "../../../../../../platform/agentHost/common/agentHostUri.js";
-import { type MessageAttachment, type StringOrMarkdown } from "../../../../../../platform/agentHost/common/state/protocol/state.js";
-import { type IChatAutoModeResolutionPart, type IChatMcpAuthenticationRequiredServer, type IChatPlanReviewResult, type IChatProgress, type IChatQuestionAnswers, type IChatResponseErrorDetails, type IChatToolInvocationSerialized, type IChatUsage } from "../../../common/chatService/chatService.js";
+import { type MessageAttachment, type ResponsePart, type StringOrMarkdown } from "../../../../../../platform/agentHost/common/state/protocol/state.js";
+import { type IChatAutoModeResolutionPart, type IChatExternalEdit, type IChatMcpAuthenticationRequiredServer, type IChatPlanReviewResult, type IChatProgress, type IChatQuestionAnswers, type IChatResponseErrorDetails, type IChatSubagentToolInvocationData, type IChatToolInvocationSerialized, type IChatUsage } from "../../../common/chatService/chatService.js";
 import { type IChatSessionHistoryItem } from "../../../common/chatSessionsService.js";
 import { type IQuotaSnapshot, type IRateLimitSnapshot } from "../../../../../services/chat/common/chatEntitlementService.js";
 import { ChatToolInvocation } from "../../../common/model/chatProgressTypes/chatToolInvocation.js";
@@ -44,45 +46,56 @@ export declare function getUrlInputRequestPresentation(inputReq: ChatInputReques
 export declare function inputRequestResponsePartToProgress(part: InputRequestResponsePart, connectionAuthority: string, resourceUris?: IAgentHostResourceUriMapper): IChatProgress;
 export declare function isSubagentToolName(toolName: string): boolean;
 export declare function systemNotificationToChatPart(content: StringOrMarkdown | undefined, connectionAuthority: string, _meta?: Record<string, unknown>): IChatProgress | undefined;
+/** Keep live phase activity visible after its own milestones, but not after answer/tool content. */
+export declare function getAgentHostActivityProgressId(parts: readonly ResponsePart[]): string | undefined;
 /**
  * Returns true if this tool call spawns a subagent session, either because
  * the server reported `_meta.toolKind === 'subagent'` or because the tool
  * name is in the known fallback set (older snapshots without `_meta`).
  */
 export declare function isSubagentTool(tc: ToolCallState): boolean;
+/** Returns whether the tool call can own a child chat: a subagent launch, a Fusion phase, or a call carrying discovery content. */
+export declare function canOwnSubagentChat(tc: ToolCallState): boolean;
 /** Returns whether the tool call can have a child chat worth observing. */
 export declare function shouldObserveSubagentChat(tc: ToolCallState, hasCatalogChild?: boolean): boolean;
 export declare function getTerminalContent(content: ToolResultContent[] | undefined): Extract<ToolResultContent, {
     type: ToolResultContentType.Terminal;
 }> | undefined;
 /**
- * Resolves a raw per-turn model id (as it appears on `UsageInfo.model`) into
- * the chat layer's namespaced language-model id and a human-readable display
- * details. Both halves are independent: the id flows onto request history
- * items (so the input picker shows the model that ran), while the details
- * flow onto response history items (so the response footer shows the model
- * and any usage metadata).
+ * Resolves selected and actual model identifiers independently, along with response display details.
  */
 export interface TurnModelLookup {
     /** Returns the chat-layer namespaced model id for a raw AHP model id. */
     toLanguageModelId(rawModelId: string | undefined): string | undefined;
+    /** Resolves the actual model's registered id when available, without falling back to the selected model. */
+    toActualModelId(rawModelId: string | undefined): string | undefined;
     /** Returns the registered display name for a raw AHP model id. */
     toModelDisplayName?(rawModelId: string): string | undefined;
-    /** Returns the human-readable response details, or undefined if unknown. */
-    toResponseDetails(rawModelId: string | undefined, usage: UsageInfo | undefined): string | undefined;
+    /** Resolves response details, optionally naming an orchestration model without rewriting billed usage. */
+    toResponseDetails(rawModelId: string | undefined, usage: UsageInfo | undefined, responseModelId?: string): string | undefined;
+    /** Whether a raw AHP model id names this provider's fusion routing model. */
+    isFusionModel?(rawModelId: string | undefined): boolean;
     /** Returns the Auto model routing part carried by this usage report, if any. */
     toAutoModeResolution?(usage: UsageInfo | undefined): IChatAutoModeResolutionPart | undefined;
     /**
-     * Returns the display name of the model a turn bills to, reading Auto's pick
+     * Returns the identity and display name of the model a turn bills to, reading Auto's pick
      * when it routed and folding back to "Auto" while explainability is hidden.
      */
-    toBilledModelDisplayName?(usage: UsageInfo | undefined): string | undefined;
+    toBilledModelInfo?(usage: UsageInfo | undefined): ITurnModelInfo | undefined;
+}
+export interface ITurnModelInfo {
+    readonly modelId: string;
+    readonly modelName: string;
+    readonly modelConfiguration?: Record<string, unknown>;
+    readonly runtimeModelConfiguration?: IChatSubagentToolInvocationData["runtimeModelConfiguration"];
 }
 /** Minimal model metadata needed to render a turn's response footer (kept small for unit testing). */
 export interface ITurnResponseModel {
     readonly name: string;
     readonly pricing?: string;
 }
+/** Fusion is the response-level model; constituent models remain in phase pills and usage. */
+export declare function turnToResponseDetails(turn: Turn | ActiveTurn | undefined, lookup?: TurnModelLookup): string | undefined;
 /**
  * Formats a turn's response footer: the model display name plus usage metadata (credits or pricing).
  * `model` is the resolved model; `billedModelId` is the turn's `usage.model` when it didn't resolve to a
@@ -92,7 +105,7 @@ export interface ITurnResponseModel {
 export declare function formatTurnResponseDetails(model: ITurnResponseModel | undefined, billedModelId: string | undefined, usage: UsageInfo | undefined): string | undefined;
 /** Converts an agent-host Auto routing result into the shared chat UI part. */
 export declare function usageInfoToAutoModeResolution(usage: UsageInfo | undefined, resolvedModelName: string | undefined): IChatAutoModeResolutionPart | undefined;
-export declare function usageInfoToChatUsage(usage: UsageInfo | undefined, modelDisplayNameResolver?: (rawModelId: string) => string | undefined): IChatUsage | undefined;
+export declare function usageInfoToChatUsage(usage: UsageInfo | undefined, modelDisplayNameResolver?: (rawModelId: string) => string | undefined, contextUsage?: IAgentContextUsage): IChatUsage | undefined;
 /**
  * A partial quota update derived from a usage report's `_meta.quotaSnapshots`. Structurally a
  * subset of the entitlement service's quota state, so callers merge it onto the existing quotas.
@@ -118,15 +131,13 @@ export declare function usageInfoToQuotas(usage: UsageInfo | undefined): IAgentH
 /**
  * Converts completed turns from the protocol state into session history items.
  *
- * Per turn, prefers `turn.usage?.model` so each request/response pair shows
- * the model that actually ran, even if the user changed models mid-session.
- * The `lookup` callback is responsible for any session-level fallback (e.g.
- * `summary.model?.id` when usage hasn't reported a model yet).
+ * Requests preserve the selected model. Response details use the actual model, except for Fusion's workflow label.
+ * The `lookup` callback supplies the session-level fallback for missing model metadata.
  */
-export declare function turnsToHistory(backendSession: URI, turns: readonly Turn[], participantId: string, connectionAuthority: string, lookup?: TurnModelLookup, errorContext?: IChatErrorContext, terminalCommandPrefix?: string, resourceUris?: IAgentHostResourceUriMapper, logicalSessionScheme?: string, errorDetailsProvider?: (turn: Turn) => IChatResponseErrorDetails | undefined): IChatSessionHistoryItem[];
+export declare function turnsToHistory(backendSession: URI, turns: readonly Turn[], participantId: string, connectionAuthority: string, lookup?: TurnModelLookup, errorContext?: IChatErrorContext, terminalCommandPrefix?: string, resourceUris?: IAgentHostResourceUriMapper, errorDetailsProvider?: (turn: Turn) => IChatResponseErrorDetails | undefined, contextUsage?: IAgentContextUsage): IChatSessionHistoryItem[];
 /** Maps explicit host metadata to a chat request source. */
 export declare function messageToRequestSource(message: Message): ChatRequestSource | undefined;
-export declare function messageToRequestOrigin(backendSession: URI, message: Message, participantId: string, logicalSessionScheme?: string): IChatRequestOrigin | undefined;
+export declare function messageToRequestOrigin(backendSession: URI, message: Message, participantId: string, connectionAuthority?: string): IChatRequestOrigin | undefined;
 /**
  * Converts a turn's persisted {@link Message} into the chat-layer
  * {@link IChatRequestVariableData} shape so attachments survive a
@@ -145,24 +156,17 @@ export declare function messageAttachmentsToVariableData(attachments: readonly M
  * objects for running tool calls and pending confirmations.
  */
 export declare function activeTurnToProgress(sessionResource: URI, activeTurn: ActiveTurn, connectionAuthority: string, mcpServerAuthority?: string, toolInvocationOptions?: IAgentHostToolInvocationOptions, lookup?: TurnModelLookup, resourceUris?: IAgentHostResourceUriMapper, subagentToolCallIds?: ReadonlySet<string>): IChatProgress[];
+export declare function appendToolOutput(invocation: ChatToolInvocation, call: ToolCallState, chunk: IAgentToolOutputChunk): void;
 /**
  * Converts a completed tool call from the protocol state into a serialized
  * tool invocation suitable for history replay.
  */
 export declare function completedToolCallToSerialized(tc: ICompletedToolCall, subAgentInvocationId: string | undefined, sessionResource: URI, connectionAuthority: string, resourceUris?: IAgentHostResourceUriMapper): IChatToolInvocationSerialized;
 /**
- * Builds {@link IChatExternalEdit} progress parts for a completed tool call
- * that produced file edits. Returns an empty array if the tool call has no
- * edits. Each emitted part carries the URI, edit kind, before/after content
- * URIs, and the diff stats already known from the agent host protocol —
- * downstream rendering can produce a static "edit pill" without re-deriving
- * any of this from an editing session.
- *
- * `connectionAuthority` is required so all emitted URIs are wrapped via
- * {@link toAgentHostUri}; otherwise the chat session would receive raw
- * remote URIs that its file system providers cannot resolve.
+ * Builds per-file edit pills with protocol diff metadata and connection-scoped resource URIs.
+ * An optional root subagent id keeps child edits out of the parent's own content flow.
  */
-export declare function completedToolCallToEditParts(tc: ICompletedToolCall, connectionAuthority: string): IChatProgress[];
+export declare function completedToolCallToEditParts(tc: ICompletedToolCall, connectionAuthority: string, subAgentInvocationId?: string): IChatExternalEdit[];
 /**
  * Rewrites inline markdown link URIs so that non-external schemes are wrapped
  * in the `vscode-agent-host://` scheme, mirroring {@link toAgentHostUri}.
@@ -203,11 +207,11 @@ export declare function stringOrMarkdownToString(value: StringOrMarkdown | undef
  *   wrapping remote file URIs into `vscode-agent-host:` URIs. Omit to skip
  *   URI wrapping (e.g. in tests that don't exercise the confirmation UI).
  */
-export declare function toolCallStateToInvocation(tc: ToolCallState, subAgentInvocationId: string | undefined, sessionResource: URI, connectionAuthority: string, mcpServerAuthority?: string, options?: IAgentHostToolInvocationOptions, resourceUris?: IAgentHostResourceUriMapper): ChatToolInvocation;
+export declare function toolCallStateToInvocation(tc: ToolCallState, subAgentInvocationId: string | undefined, sessionResource: URI, connectionAuthority: string, mcpServerAuthority?: string, options?: IAgentHostToolInvocationOptions, resourceUris?: IAgentHostResourceUriMapper, mcpServerName?: string): ChatToolInvocation;
 export declare function toolCallConfirmationMessages(tc: ToolCallPendingConfirmationState, connectionAuthority: string): IToolConfirmationMessages;
 export declare function toolCallAuthenticationServer(tc: ToolCallState & {
     status: ToolCallStatus.AuthRequired;
-}, sessionAuthority: string): IChatMcpAuthenticationRequiredServer;
+}, sessionAuthority: string, name?: string): IChatMcpAuthenticationRequiredServer;
 /**
  * Creates a {@link ChatToolInvocation} in the native streaming state for a
  * tool call that is still streaming its arguments (AHP