@codingame/monaco-vscode-chat-service-override 29.1.0 → 30.0.0

package/index.js

@@ -44,7 +44,7 @@ import { ChatAttachmentResolveService } from './vscode/src/vs/workbench/contrib/
 import { IRemoteCodingAgentsService } from '@codingame/monaco-vscode-api/vscode/vs/workbench/contrib/remoteCodingAgents/common/remoteCodingAgentsService.service';
 import { RemoteCodingAgentsService } from './vscode/src/vs/workbench/contrib/remoteCodingAgents/common/remoteCodingAgentsService.js';
 import { IChatSessionsService } from '@codingame/monaco-vscode-api/vscode/vs/workbench/contrib/chat/common/chatSessionsService.service';
-import { ChatSessionsService } from '@codingame/monaco-vscode-katex-common/vscode/vs/workbench/contrib/chat/browser/chatSessions/chatSessions.contribution';
+import { ChatSessionsService } from '@codingame/monaco-vscode-api/vscode/vs/workbench/contrib/chat/browser/chatSessions/chatSessions.contribution';
 import { ChatOutputRendererService } from './vscode/src/vs/workbench/contrib/chat/browser/chatOutputItemRenderer.js';
 import { IChatOutputRendererService } from '@codingame/monaco-vscode-api/vscode/vs/workbench/contrib/chat/browser/chatOutputItemRenderer.service';
 import { IChatTodoListService } from '@codingame/monaco-vscode-api/vscode/vs/workbench/contrib/chat/common/tools/chatTodoListService.service';
@@ -110,6 +110,8 @@ import { IChatImageCarouselService } from '@codingame/monaco-vscode-api/vscode/v
 import { ChatImageCarouselService } from './vscode/src/vs/workbench/contrib/chat/browser/chatImageCarouselService.js';
 import { IInlineChatHistoryService } from '@codingame/monaco-vscode-api/vscode/vs/workbench/contrib/inlineChat/browser/inlineChatHistoryService.service';
 import { InlineChatHistoryService } from './vscode/src/vs/workbench/contrib/inlineChat/browser/inlineChatHistoryService.js';
+import { NullSandboxHelperService } from './vscode/src/vs/platform/sandbox/browser/sandboxHelperService.js';
+import { ISandboxHelperService } from '@codingame/monaco-vscode-api/vscode/vs/platform/sandbox/common/sandboxHelperService.service';
 import './vscode/src/vs/workbench/contrib/chat/browser/chat.contribution.js';
 import './vscode/src/vs/workbench/contrib/terminalContrib/chatAgentTools/browser/terminal.chatAgentTools.contribution.js';
 import './vscode/src/vs/workbench/contrib/terminalContrib/chat/browser/terminal.chat.contribution.js';
@@ -177,6 +179,7 @@ function getServiceOverride({ defaultAccount } = {}) {
         [IChatEditingExplanationModelManager.toString()]: new SyncDescriptor(ChatEditingExplanationModelManager, [], true),
         [IChatToolOutputStateCache.toString()]: new SyncDescriptor(ChatToolOutputStateCache, [], true),
         [ITerminalSandboxService.toString()]: new SyncDescriptor(TerminalSandboxService, [], true),
+        [ISandboxHelperService.toString()]: new SyncDescriptor(NullSandboxHelperService, [], true),
         [IAICustomizationWorkspaceService.toString()]: new SyncDescriptor(AICustomizationWorkspaceService, [], true),
         [IAgentPluginService.toString()]: new SyncDescriptor(AgentPluginService, [], true),
         [IPluginMarketplaceService.toString()]: new SyncDescriptor(PluginMarketplaceService, [], true),
@@ -186,7 +189,7 @@ function getServiceOverride({ defaultAccount } = {}) {
         [IChatDebugService.toString()]: new SyncDescriptor(ChatDebugServiceImpl, [], true),
         [IChatResponseResourceFileSystemProvider.toString()]: new SyncDescriptor(ChatResponseResourceFileSystemProvider, [], true),
         [IDefaultAccountService.toString()]: new SyncDescriptor(DefaultAccountService, [defaultAccount], true),
-        [ICustomizationHarnessService.toString()]: new SyncDescriptor(CustomizationHarnessService, [defaultAccount], true),
+        [ICustomizationHarnessService.toString()]: new SyncDescriptor(CustomizationHarnessService, [], true),
         [IChatArtifactsService.toString()]: new SyncDescriptor(ChatArtifactsService, [], true),
         [IWorkspacePluginSettingsService.toString()]: new SyncDescriptor(WorkspacePluginSettingsService, [], true),
         [IChatImageCarouselService.toString()]: new SyncDescriptor(ChatImageCarouselService, [], true),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@codingame/monaco-vscode-chat-service-override",
-  "version": "29.1.0",
+  "version": "30.0.0",
   "private": false,
   "description": "VSCode public API plugged on the monaco editor - chat service-override",
   "keywords": [],
@@ -15,10 +15,10 @@
   },
   "type": "module",
   "dependencies": {
-    "@codingame/monaco-vscode-api": "29.1.0",
-    "@codingame/monaco-vscode-katex-common": "29.1.0",
-    "@codingame/monaco-vscode-xterm-addons-common": "29.1.0",
-    "@codingame/monaco-vscode-xterm-common": "29.1.0"
+    "@codingame/monaco-vscode-api": "30.0.0",
+    "@codingame/monaco-vscode-katex-common": "30.0.0",
+    "@codingame/monaco-vscode-xterm-addons-common": "30.0.0",
+    "@codingame/monaco-vscode-xterm-common": "30.0.0"
   },
   "main": "index.js",
   "module": "index.js",

package/vscode/src/vs/platform/agentHost/common/agentService.d.ts

@@ -2,21 +2,25 @@ import { Event } from "@codingame/monaco-vscode-api/vscode/vs/base/common/event"
 import { IAuthorizationProtectedResourceMetadata } from "@codingame/monaco-vscode-api/vscode/vs/base/common/oauth";
 import { URI } from "@codingame/monaco-vscode-api/vscode/vs/base/common/uri";
 import { IAgentService } from "./agentService.service.js";
-import { AttachmentType, PermissionKind, type PolicyState } from "./state/sessionState.js";
+import { AttachmentType, type IPendingMessage, type IToolCallResult, type PolicyState, type StringOrMarkdown } from "./state/sessionState.js";
 export declare enum AgentHostIpcChannels {
     /** Channel for the agent host service on the main-process side */
     AgentHost = "agentHost",
     /** Channel for log forwarding from the agent host process */
-    Logger = "agentHostLogger"
+    Logger = "agentHostLogger",
+    /** Channel for WebSocket client connection count (server process management only) */
+    ConnectionTracker = "agentHostConnectionTracker"
 }
 /** Configuration key that controls whether the agent host process is spawned. */
 export declare const AgentHostEnabledSettingId = "chat.agentHost.enabled";
+/** Configuration key that controls whether per-host IPC traffic output channels are created. */
+export declare const AgentHostIpcLoggingSettingId = "chat.agentHost.ipcLoggingEnabled";
 export interface IAgentSessionMetadata {
     readonly session: URI;
     readonly startTime: number;
     readonly modifiedTime: number;
     readonly summary?: string;
-    readonly workingDirectory?: string;
+    readonly workingDirectory?: URI;
 }
 export type AgentProvider = string;
 /** Metadata describing an agent backend, discovered over IPC. */
@@ -70,7 +74,7 @@ export interface IAgentCreateSessionConfig {
     readonly provider?: AgentProvider;
     readonly model?: string;
     readonly session?: URI;
-    readonly workingDirectory?: string;
+    readonly workingDirectory?: URI;
 }
 /** Serializable attachment passed alongside a message to the agent host. */
 export interface IAgentAttachment {
@@ -161,20 +165,9 @@ export interface IAgentToolStartEvent extends IAgentProgressEventBase {
 export interface IAgentToolCompleteEvent extends IAgentProgressEventBase {
     readonly type: "tool_complete";
     readonly toolCallId: string;
-    readonly success: boolean;
-    /** Message describing the completed tool invocation (e.g., "Ran `echo hello`"). */
-    readonly pastTenseMessage: string;
-    /** Tool output content for display in the UI. */
-    readonly toolOutput?: string;
+    /** Tool execution result, matching the protocol {@link IToolCallResult} shape. */
+    readonly result: IToolCallResult;
     readonly isUserRequested?: boolean;
-    readonly result?: {
-        readonly content: string;
-        readonly detailedContent?: string;
-    };
-    readonly error?: {
-        readonly message: string;
-        readonly code?: string;
-    };
     /** Serialized JSON of tool-specific telemetry data. */
     readonly toolTelemetry?: string;
     readonly parentToolCallId?: string;
@@ -199,34 +192,30 @@ export interface IAgentUsageEvent extends IAgentProgressEventBase {
     readonly model?: string;
     readonly cacheReadTokens?: number;
 }
-/** A tool permission request from the SDK requiring a renderer-side decision. */
-export interface IAgentPermissionRequestEvent extends IAgentProgressEventBase {
-    readonly type: "permission_request";
-    /** Unique ID for correlating the response. */
-    readonly requestId: string;
-    /** The kind of permission being requested. */
-    readonly permissionKind: PermissionKind;
-    /** The tool call ID that triggered this permission request. */
-    readonly toolCallId?: string;
-    /** File path involved (for read/write). */
-    readonly path?: string;
-    /** For shell: the full command text. */
-    readonly fullCommandText?: string;
-    /** For shell: the intention description. */
-    readonly intention?: string;
-    /** For MCP: the server name. */
-    readonly serverName?: string;
-    /** For MCP: the tool name. */
-    readonly toolName?: string;
-    /** Serialized JSON of the full permission request for fallback display. */
-    readonly rawRequest: string;
+/**
+ * A running tool requires re-confirmation (e.g. a mid-execution permission check).
+ * Maps to `SessionToolCallReady` without `confirmed` to transition Running → PendingConfirmation.
+ */
+export interface IAgentToolReadyEvent extends IAgentProgressEventBase {
+    readonly type: "tool_ready";
+    readonly toolCallId: string;
+    /** Message describing what confirmation is needed. */
+    readonly invocationMessage: StringOrMarkdown;
+    /** Raw tool input to display. */
+    readonly toolInput?: string;
+    /** Short title for the confirmation prompt. */
+    readonly confirmationTitle?: StringOrMarkdown;
+    /** Kind of permission being requested (e.g. `'write'`, `'read'`). */
+    readonly permissionKind?: string;
+    /** File path associated with the permission request. */
+    readonly permissionPath?: string;
 }
 /** Streaming reasoning/thinking content from the assistant. */
 export interface IAgentReasoningEvent extends IAgentProgressEventBase {
     readonly type: "reasoning";
     readonly content: string;
 }
-export type IAgentProgressEvent = IAgentDeltaEvent | IAgentMessageEvent | IAgentIdleEvent | IAgentToolStartEvent | IAgentToolCompleteEvent | IAgentTitleChangedEvent | IAgentErrorEvent | IAgentUsageEvent | IAgentPermissionRequestEvent | IAgentReasoningEvent;
+export type IAgentProgressEvent = IAgentDeltaEvent | IAgentMessageEvent | IAgentIdleEvent | IAgentToolStartEvent | IAgentToolReadyEvent | IAgentToolCompleteEvent | IAgentTitleChangedEvent | IAgentErrorEvent | IAgentUsageEvent | IAgentReasoningEvent;
 export declare namespace AgentSession {
     /**
      * Creates a session URI from a provider name and raw session ID.
@@ -258,6 +247,15 @@ export interface IAgent {
     createSession(config?: IAgentCreateSessionConfig): Promise<URI>;
     /** Send a user message into an existing session. */
     sendMessage(session: URI, prompt: string, attachments?: IAgentAttachment[]): Promise<void>;
+    /**
+     * Called when the session's pending (steering) message changes.
+     * The agent harness decides how to react — e.g. inject steering
+     * mid-turn via `mode: 'immediate'`.
+     *
+     * Queued messages are consumed on the server side and are not
+     * forwarded to the agent; `queuedMessages` will always be empty.
+     */
+    setPendingMessages?(session: URI, steeringMessage: IPendingMessage | undefined, queuedMessages: readonly IPendingMessage[]): void;
     /** Retrieve all session events/messages for reconstruction. */
     getSessionMessages(session: URI): Promise<(IAgentMessageEvent | IAgentToolStartEvent | IAgentToolCompleteEvent)[]>;
     /** Dispose a session, freeing resources. */

package/vscode/src/vs/platform/agentHost/common/agentService.js

@@ -5,8 +5,10 @@ var AgentHostIpcChannels;
 (function(AgentHostIpcChannels) {
     AgentHostIpcChannels["AgentHost"] = "agentHost";
     AgentHostIpcChannels["Logger"] = "agentHostLogger";
+    AgentHostIpcChannels["ConnectionTracker"] = "agentHostConnectionTracker";
 })(AgentHostIpcChannels || (AgentHostIpcChannels = {}));
 const AgentHostEnabledSettingId = "chat.agentHost.enabled";
+const AgentHostIpcLoggingSettingId = "chat.agentHost.ipcLoggingEnabled";
 var AgentSession;
 (function(AgentSession) {
     function uri(provider, rawSessionId) {
@@ -28,4 +30,4 @@ var AgentSession;
     AgentSession.provider = provider;
 })(AgentSession || (AgentSession = {}));
 
-export { AgentHostEnabledSettingId, AgentHostIpcChannels, AgentSession };
+export { AgentHostEnabledSettingId, AgentHostIpcChannels, AgentHostIpcLoggingSettingId, AgentSession };

package/vscode/src/vs/platform/agentHost/common/agentService.service.d.ts

@@ -2,7 +2,7 @@ import { Event } from "@codingame/monaco-vscode-api/vscode/vs/base/common/event"
 import { URI } from "@codingame/monaco-vscode-api/vscode/vs/base/common/uri";
 import { IAgentDescriptor, IResourceMetadata, IAuthenticateParams, IAuthenticateResult, IAgentSessionMetadata, IAgentCreateSessionConfig, type IAgentConnection } from "./agentService.js";
 import { IActionEnvelope, INotification, ISessionAction } from "./state/sessionActions.js";
-import { IBrowseDirectoryResult } from "./state/sessionProtocol.js";
+import { IBrowseDirectoryResult, IFetchContentResult, IWriteFileParams, IWriteFileResult } from "./state/sessionProtocol.js";
 import { ISnapshot as IStateSnapshot } from "./state/sessionState.js";
 export declare const IAgentService: import("@codingame/monaco-vscode-api/vscode/vs/platform/instantiation/common/instantiation").ServiceIdentifier<IAgentService>;
 /**
@@ -71,6 +71,16 @@ export interface IAgentService {
     * Used by the client to drive a remote folder picker before session creation.
     */
     browseDirectory(uri: URI): Promise<IBrowseDirectoryResult>;
+    /**
+    * Fetch stored content by URI from the agent host (e.g. file edit snapshots,
+    * or reading files from the remote filesystem).
+    */
+    fetchContent(uri: URI): Promise<IFetchContentResult>;
+    /**
+    * Write content to a file on the agent host's filesystem.
+    * Used for undo/redo operations on file edits.
+    */
+    writeFile(params: IWriteFileParams): Promise<IWriteFileResult>;
 }
 export declare const IAgentHostService: import("@codingame/monaco-vscode-api/vscode/vs/platform/instantiation/common/instantiation").ServiceIdentifier<IAgentHostService>;
 /**

package/vscode/src/vs/platform/agentHost/common/state/protocol/action-origin.generated.d.ts

@@ -1,12 +1,12 @@
-import { type IStateAction, type IRootAgentsChangedAction, type IRootActiveSessionsChangedAction, type ISessionReadyAction, type ISessionCreationFailedAction, type ISessionTurnStartedAction, type ISessionDeltaAction, type ISessionResponsePartAction, type ISessionToolCallStartAction, type ISessionToolCallDeltaAction, type ISessionToolCallReadyAction, type ISessionToolCallConfirmedAction, type ISessionToolCallCompleteAction, type ISessionToolCallResultConfirmedAction, type ISessionPermissionRequestAction, type ISessionPermissionResolvedAction, type ISessionTurnCompleteAction, type ISessionTurnCancelledAction, type ISessionErrorAction, type ISessionTitleChangedAction, type ISessionUsageAction, type ISessionReasoningAction, type ISessionModelChangedAction, type ISessionServerToolsChangedAction, type ISessionActiveClientChangedAction, type ISessionActiveClientToolsChangedAction } from "./actions.js";
+import { type IStateAction, type IRootAgentsChangedAction, type IRootActiveSessionsChangedAction, type ISessionReadyAction, type ISessionCreationFailedAction, type ISessionTurnStartedAction, type ISessionDeltaAction, type ISessionResponsePartAction, type ISessionToolCallStartAction, type ISessionToolCallDeltaAction, type ISessionToolCallReadyAction, type ISessionToolCallConfirmedAction, type ISessionToolCallCompleteAction, type ISessionToolCallResultConfirmedAction, type ISessionTurnCompleteAction, type ISessionTurnCancelledAction, type ISessionErrorAction, type ISessionTitleChangedAction, type ISessionUsageAction, type ISessionReasoningAction, type ISessionModelChangedAction, type ISessionServerToolsChangedAction, type ISessionActiveClientChangedAction, type ISessionActiveClientToolsChangedAction, type ISessionPendingMessageSetAction, type ISessionPendingMessageRemovedAction, type ISessionQueuedMessagesReorderedAction, type ISessionCustomizationsChangedAction, type ISessionCustomizationToggledAction } from "./actions.js";
 /** Union of all root-scoped actions. */
 export type IRootAction = IRootAgentsChangedAction | IRootActiveSessionsChangedAction;
 /** Union of all session-scoped actions. */
-export type ISessionAction = ISessionReadyAction | ISessionCreationFailedAction | ISessionTurnStartedAction | ISessionDeltaAction | ISessionResponsePartAction | ISessionToolCallStartAction | ISessionToolCallDeltaAction | ISessionToolCallReadyAction | ISessionToolCallConfirmedAction | ISessionToolCallCompleteAction | ISessionToolCallResultConfirmedAction | ISessionPermissionRequestAction | ISessionPermissionResolvedAction | ISessionTurnCompleteAction | ISessionTurnCancelledAction | ISessionErrorAction | ISessionTitleChangedAction | ISessionUsageAction | ISessionReasoningAction | ISessionModelChangedAction | ISessionServerToolsChangedAction | ISessionActiveClientChangedAction | ISessionActiveClientToolsChangedAction;
+export type ISessionAction = ISessionReadyAction | ISessionCreationFailedAction | ISessionTurnStartedAction | ISessionDeltaAction | ISessionResponsePartAction | ISessionToolCallStartAction | ISessionToolCallDeltaAction | ISessionToolCallReadyAction | ISessionToolCallConfirmedAction | ISessionToolCallCompleteAction | ISessionToolCallResultConfirmedAction | ISessionTurnCompleteAction | ISessionTurnCancelledAction | ISessionErrorAction | ISessionTitleChangedAction | ISessionUsageAction | ISessionReasoningAction | ISessionModelChangedAction | ISessionServerToolsChangedAction | ISessionActiveClientChangedAction | ISessionActiveClientToolsChangedAction | ISessionPendingMessageSetAction | ISessionPendingMessageRemovedAction | ISessionQueuedMessagesReorderedAction | ISessionCustomizationsChangedAction | ISessionCustomizationToggledAction;
 /** Union of session actions that clients may dispatch. */
-export type IClientSessionAction = ISessionTurnStartedAction | ISessionToolCallConfirmedAction | ISessionToolCallCompleteAction | ISessionToolCallResultConfirmedAction | ISessionPermissionResolvedAction | ISessionTurnCancelledAction | ISessionModelChangedAction | ISessionActiveClientChangedAction | ISessionActiveClientToolsChangedAction;
+export type IClientSessionAction = ISessionTurnStartedAction | ISessionToolCallConfirmedAction | ISessionToolCallCompleteAction | ISessionToolCallResultConfirmedAction | ISessionTurnCancelledAction | ISessionModelChangedAction | ISessionActiveClientChangedAction | ISessionActiveClientToolsChangedAction | ISessionPendingMessageSetAction | ISessionPendingMessageRemovedAction | ISessionQueuedMessagesReorderedAction | ISessionCustomizationToggledAction;
 /** Union of session actions that only the server may produce. */
-export type IServerSessionAction = ISessionReadyAction | ISessionCreationFailedAction | ISessionDeltaAction | ISessionResponsePartAction | ISessionToolCallStartAction | ISessionToolCallDeltaAction | ISessionToolCallReadyAction | ISessionPermissionRequestAction | ISessionTurnCompleteAction | ISessionErrorAction | ISessionTitleChangedAction | ISessionUsageAction | ISessionReasoningAction | ISessionServerToolsChangedAction;
+export type IServerSessionAction = ISessionReadyAction | ISessionCreationFailedAction | ISessionDeltaAction | ISessionResponsePartAction | ISessionToolCallStartAction | ISessionToolCallDeltaAction | ISessionToolCallReadyAction | ISessionTurnCompleteAction | ISessionErrorAction | ISessionTitleChangedAction | ISessionUsageAction | ISessionReasoningAction | ISessionServerToolsChangedAction | ISessionCustomizationsChangedAction;
 /**
  * Exhaustive map indicating which action types may be dispatched by clients.
  * Adding a new action to IStateAction without adding it here is a compile error.

package/vscode/src/vs/platform/agentHost/common/state/protocol/actions.d.ts

@@ -1,4 +1,4 @@
-import { ToolCallConfirmationReason, ToolCallCancellationReason, type URI, type StringOrMarkdown, type IAgentInfo, type IErrorInfo, type IUserMessage, type IResponsePart, type IToolCallResult, type IToolDefinition, type ISessionActiveClient, type IUsageInfo, type IPermissionRequest } from "./state.js";
+import { ToolCallConfirmationReason, ToolCallCancellationReason, PendingMessageKind, type URI, type StringOrMarkdown, type IAgentInfo, type IErrorInfo, type IUserMessage, type IResponsePart, type IToolCallResult, type IToolDefinition, type ISessionActiveClient, type IUsageInfo, type ISessionCustomization } from "./state.js";
 /**
  * Discriminant values for all state actions.
  *
@@ -18,8 +18,6 @@ export declare enum ActionType {
     SessionToolCallConfirmed = "session/toolCallConfirmed",
     SessionToolCallComplete = "session/toolCallComplete",
     SessionToolCallResultConfirmed = "session/toolCallResultConfirmed",
-    SessionPermissionRequest = "session/permissionRequest",
-    SessionPermissionResolved = "session/permissionResolved",
     SessionTurnComplete = "session/turnComplete",
     SessionTurnCancelled = "session/turnCancelled",
     SessionError = "session/error",
@@ -29,7 +27,12 @@ export declare enum ActionType {
     SessionModelChanged = "session/modelChanged",
     SessionServerToolsChanged = "session/serverToolsChanged",
     SessionActiveClientChanged = "session/activeClientChanged",
-    SessionActiveClientToolsChanged = "session/activeClientToolsChanged"
+    SessionActiveClientToolsChanged = "session/activeClientToolsChanged",
+    SessionPendingMessageSet = "session/pendingMessageSet",
+    SessionPendingMessageRemoved = "session/pendingMessageRemoved",
+    SessionQueuedMessagesReordered = "session/queuedMessagesReordered",
+    SessionCustomizationsChanged = "session/customizationsChanged",
+    SessionCustomizationToggled = "session/customizationToggled"
 }
 /**
  * Identifies the client that originally dispatched an action.
@@ -131,9 +134,14 @@ export interface ISessionTurnStartedAction {
     turnId: string;
     /** User's message */
     userMessage: IUserMessage;
+    /** If this turn was auto-started from a queued message, the ID of that message */
+    queuedMessageId?: string;
 }
 /**
- * Streaming text chunk from the assistant.
+ * Streaming text chunk from the assistant, appended to a specific response part.
+ *
+ * The server MUST first emit a `session/responsePart` to create the target
+ * part (markdown or reasoning), then use this action to append text to it.
  *
  * @category Session Actions
  * @version 1
@@ -144,6 +152,8 @@ export interface ISessionDeltaAction {
     session: URI;
     /** Turn identifier */
     turnId: string;
+    /** Identifier of the response part to append to */
+    partId: string;
     /** Text chunk */
     content: string;
 }
@@ -198,9 +208,16 @@ export interface ISessionToolCallDeltaAction extends IToolCallActionBase {
     invocationMessage?: StringOrMarkdown;
 }
 /**
- * Tool call parameters are complete. Transitions to `pending-confirmation`
+ * Tool call parameters are complete, or a running tool requires re-confirmation.
+ *
+ * When dispatched for a `streaming` tool call, transitions to `pending-confirmation`
  * or directly to `running` if `confirmed` is set.
  *
+ * When dispatched for a `running` tool call (e.g. mid-execution permission needed),
+ * transitions back to `pending-confirmation`. The `invocationMessage` and `_meta`
+ * SHOULD be updated to describe the specific confirmation needed. Clients use the
+ * standard `session/toolCallConfirmed` flow to approve or deny.
+ *
  * For client-provided tools, the server typically sets `confirmed` to
  * `'not-needed'` so the tool transitions directly to `running`, where the
  * owning client can begin execution immediately.
@@ -210,10 +227,12 @@ export interface ISessionToolCallDeltaAction extends IToolCallActionBase {
  */
 export interface ISessionToolCallReadyAction extends IToolCallActionBase {
     type: ActionType.SessionToolCallReady;
-    /** Message describing what the tool will do */
+    /** Message describing what the tool will do or what confirmation is needed */
     invocationMessage: StringOrMarkdown;
     /** Raw tool input */
     toolInput?: string;
+    /** Short title for the confirmation prompt (e.g. `"Run in terminal"`, `"Write file"`) */
+    confirmationTitle?: StringOrMarkdown;
     /** If set, the tool was auto-confirmed and transitions directly to `running` */
     confirmed?: ToolCallConfirmationReason;
 }
@@ -297,39 +316,6 @@ export interface ISessionToolCallResultConfirmedAction extends IToolCallActionBa
     /** Whether the result was approved */
     approved: boolean;
 }
-/**
- * Permission needed from the user to proceed.
- *
- * @category Session Actions
- * @version 1
- */
-export interface ISessionPermissionRequestAction {
-    type: ActionType.SessionPermissionRequest;
-    /** Session URI */
-    session: URI;
-    /** Turn identifier */
-    turnId: string;
-    /** Permission request details */
-    request: IPermissionRequest;
-}
-/**
- * Permission granted or denied.
- *
- * @category Session Actions
- * @version 1
- * @clientDispatchable
- */
-export interface ISessionPermissionResolvedAction {
-    type: ActionType.SessionPermissionResolved;
-    /** Session URI */
-    session: URI;
-    /** Turn identifier */
-    turnId: string;
-    /** Permission request ID */
-    requestId: string;
-    /** Whether permission was granted */
-    approved: boolean;
-}
 /**
  * Turn finished — the assistant is idle.
  *
@@ -401,7 +387,10 @@ export interface ISessionUsageAction {
     usage: IUsageInfo;
 }
 /**
- * Reasoning/thinking text from the model.
+ * Reasoning/thinking text from the model, appended to a specific reasoning response part.
+ *
+ * The server MUST first emit a `session/responsePart` to create the target
+ * reasoning part, then use this action to append text to it.
  *
  * @category Session Actions
  * @version 1
@@ -412,6 +401,8 @@ export interface ISessionReasoningAction {
     session: URI;
     /** Turn identifier */
     turnId: string;
+    /** Identifier of the reasoning response part to append to */
+    partId: string;
     /** Reasoning text chunk */
     content: string;
 }
@@ -481,8 +472,107 @@ export interface ISessionActiveClientToolsChangedAction {
     /** Updated client tools list (full replacement) */
     tools: IToolDefinition[];
 }
+/**
+ * The session's customizations have changed.
+ *
+ * Full-replacement semantics: the `customizations` array replaces the
+ * previous `customizations` entirely.
+ *
+ * @category Session Actions
+ * @version 1
+ */
+export interface ISessionCustomizationsChangedAction {
+    type: ActionType.SessionCustomizationsChanged;
+    /** Session URI */
+    session: URI;
+    /** Updated customization list (full replacement) */
+    customizations: ISessionCustomization[];
+}
+/**
+ * A client toggled a customization on or off.
+ *
+ * The server locates the customization by `uri` in the session's
+ * customization list and sets its `enabled` flag.
+ *
+ * @category Session Actions
+ * @version 1
+ * @clientDispatchable
+ */
+export interface ISessionCustomizationToggledAction {
+    type: ActionType.SessionCustomizationToggled;
+    /** Session URI */
+    session: URI;
+    /** The URI of the customization to toggle */
+    uri: URI;
+    /** Whether to enable or disable the customization */
+    enabled: boolean;
+}
+/**
+ * A pending message was set (upsert semantics: creates or replaces).
+ *
+ * For steering messages, this always replaces the single steering message.
+ * For queued messages, if a message with the given `id` already exists it is
+ * updated in place; otherwise it is appended to the queue. If the session is
+ * idle when a queued message is set, the server SHOULD immediately consume it
+ * and start a new turn.
+ *
+ * @category Session Actions
+ * @version 1
+ * @clientDispatchable
+ */
+export interface ISessionPendingMessageSetAction {
+    type: ActionType.SessionPendingMessageSet;
+    /** Session URI */
+    session: URI;
+    /** Whether this is a steering or queued message */
+    kind: PendingMessageKind;
+    /** Unique identifier for this pending message */
+    id: string;
+    /** The message content */
+    userMessage: IUserMessage;
+}
+/**
+ * A pending message was removed (steering or queued).
+ *
+ * Dispatched by clients to cancel a pending message, or by the server when
+ * it consumes a message (e.g. starting a turn from a queued message or
+ * injecting a steering message into the current turn).
+ *
+ * @category Session Actions
+ * @version 1
+ * @clientDispatchable
+ */
+export interface ISessionPendingMessageRemovedAction {
+    type: ActionType.SessionPendingMessageRemoved;
+    /** Session URI */
+    session: URI;
+    /** Whether this is a steering or queued message */
+    kind: PendingMessageKind;
+    /** Identifier of the pending message to remove */
+    id: string;
+}
+/**
+ * Reorder the queued messages.
+ *
+ * The `order` array contains the IDs of queued messages in their new
+ * desired order. IDs not present in the current queue are ignored.
+ * Queued messages whose IDs are absent from `order` are appended at
+ * the end in their original relative order (so a client with a stale
+ * view of the queue never silently drops messages).
+ *
+ * @category Session Actions
+ * @version 1
+ * @clientDispatchable
+ */
+export interface ISessionQueuedMessagesReorderedAction {
+    type: ActionType.SessionQueuedMessagesReordered;
+    /** Session URI */
+    session: URI;
+    /** Queued message IDs in the desired order */
+    order: string[];
+}
 /**
  * Discriminated union of all state actions.
  */
-export type IStateAction = IRootAgentsChangedAction | IRootActiveSessionsChangedAction | ISessionReadyAction | ISessionCreationFailedAction | ISessionTurnStartedAction | ISessionDeltaAction | ISessionResponsePartAction | ISessionToolCallStartAction | ISessionToolCallDeltaAction | ISessionToolCallReadyAction | ISessionToolCallConfirmedAction | ISessionToolCallCompleteAction | ISessionToolCallResultConfirmedAction | ISessionPermissionRequestAction | ISessionPermissionResolvedAction | ISessionTurnCompleteAction | ISessionTurnCancelledAction | ISessionErrorAction | ISessionTitleChangedAction | ISessionUsageAction | ISessionReasoningAction | ISessionModelChangedAction | ISessionServerToolsChangedAction | ISessionActiveClientChangedAction | ISessionActiveClientToolsChangedAction;
+export type IStateAction = IRootAgentsChangedAction | IRootActiveSessionsChangedAction | ISessionReadyAction | ISessionCreationFailedAction | ISessionTurnStartedAction | ISessionDeltaAction | ISessionResponsePartAction | ISessionToolCallStartAction | ISessionToolCallDeltaAction | ISessionToolCallReadyAction | ISessionToolCallConfirmedAction | ISessionToolCallCompleteAction | ISessionToolCallResultConfirmedAction | ISessionTurnCompleteAction | ISessionTurnCancelledAction | ISessionErrorAction | ISessionTitleChangedAction | ISessionUsageAction | ISessionReasoningAction | ISessionModelChangedAction | ISessionServerToolsChangedAction | ISessionActiveClientChangedAction | ISessionActiveClientToolsChangedAction | ISessionPendingMessageSetAction | ISessionPendingMessageRemovedAction | ISessionQueuedMessagesReorderedAction | ISessionCustomizationsChangedAction | ISessionCustomizationToggledAction;
 export {};

package/vscode/src/vs/platform/agentHost/common/state/protocol/commands.d.ts

@@ -207,6 +207,8 @@ export declare enum ContentEncoding {
  * @direction Client → Server
  * @messageType Request
  * @version 1
+ * @throws `NotFound` (`-32008`) if the URI does not exist.
+ * @throws `PermissionDenied` (`-32009`) if the client is not permitted to read the URI.
  * @example
  * ```jsonc
  * // Client → Server
@@ -242,6 +244,56 @@ export interface IFetchContentResult {
     /** Content type (e.g. `"image/png"`, `"text/plain"`) */
     contentType?: string;
 }
+/**
+ * Writes content to a file on the server's filesystem.
+ *
+ * Binary content (images, etc.) MUST use `base64` encoding. Text content MAY
+ * use `utf-8` encoding.
+ *
+ * If the file does not exist, it is created. If the file already exists, it is
+ * overwritten unless `createOnly` is set.
+ *
+ * @category Commands
+ * @method writeFile
+ * @direction Client → Server
+ * @messageType Request
+ * @version 1
+ * @throws `NotFound` (`-32008`) if the parent directory does not exist.
+ * @throws `PermissionDenied` (`-32009`) if the client is not permitted to write to the path.
+ * @throws `AlreadyExists` (`-32010`) if `createOnly` is set and the file already exists.
+ * @example
+ * ```jsonc
+ * // Client → Server
+ * { "jsonrpc": "2.0", "id": 11, "method": "writeFile",
+ *   "params": { "uri": "file:///workspace/hello.txt", "data": "SGVsbG8=",
+ *              "encoding": "base64", "contentType": "text/plain" } }
+ *
+ * // Server → Client
+ * { "jsonrpc": "2.0", "id": 11, "result": {} }
+ * ```
+ */
+export interface IWriteFileParams {
+    /** Target file URI on the server filesystem */
+    uri: URI;
+    /** Content encoded as a string */
+    data: string;
+    /** How `data` is encoded */
+    encoding: ContentEncoding;
+    /** Content type (e.g. `"text/plain"`, `"image/png"`) */
+    contentType?: string;
+    /**
+     * If `true`, the server MUST fail if the file already exists instead of
+     * overwriting it. Useful for safe creation of new files.
+     */
+    createOnly?: boolean;
+}
+/**
+ * Result of the `writeFile` command.
+ *
+ * An empty object on success.
+ */
+export interface IWriteFileResult {
+}
 /**
  * Lists directory entries at a file URI on the server's filesystem.
  *
@@ -257,6 +309,8 @@ export interface IFetchContentResult {
  * @direction Client → Server
  * @messageType Request
  * @version 1
+ * @throws `NotFound` (`-32008`) if the directory does not exist.
+ * @throws `PermissionDenied` (`-32009`) if the client is not permitted to browse the directory.
  */
 export interface IBrowseDirectoryParams {
     /** Directory URI on the server filesystem */

package/vscode/src/vs/platform/agentHost/common/state/protocol/errors.d.ts

@@ -43,6 +43,21 @@ export declare const AhpErrorCodes: {
      * @see {@link /specification/authentication | Authentication}
      */
     readonly AuthRequired: -32007;
+    /** The requested file, folder, or URI does not exist */
+    readonly NotFound: -32008;
+    /**
+     * The client is not permitted to access the requested resource.
+     *
+     * Servers SHOULD return this when a client attempts to read or browse
+     * a path outside the allowed set (e.g. outside the session's working
+     * directory or workspace roots).
+     */
+    readonly PermissionDenied: -32009;
+    /**
+     * The target resource already exists and the operation does not allow
+     * overwriting (e.g. `writeFile` with `createOnly: true`).
+     */
+    readonly AlreadyExists: -32010;
 };
 /** Union type of all AHP application error codes. */
 export type AhpErrorCode = (typeof AhpErrorCodes)[keyof typeof AhpErrorCodes];

package/vscode/src/vs/platform/agentHost/common/state/protocol/messages.d.ts

@@ -1,4 +1,4 @@
-import type { IInitializeParams, IInitializeResult, IReconnectParams, IReconnectResult, ISubscribeParams, ISubscribeResult, ICreateSessionParams, IDisposeSessionParams, IListSessionsParams, IListSessionsResult, IFetchContentParams, IFetchContentResult, IBrowseDirectoryParams, IBrowseDirectoryResult, IFetchTurnsParams, IFetchTurnsResult, IUnsubscribeParams, IDispatchActionParams, IAuthenticateParams, IAuthenticateResult } from "./commands.js";
+import type { IInitializeParams, IInitializeResult, IReconnectParams, IReconnectResult, ISubscribeParams, ISubscribeResult, ICreateSessionParams, IDisposeSessionParams, IListSessionsParams, IListSessionsResult, IFetchContentParams, IFetchContentResult, IWriteFileParams, IWriteFileResult, IBrowseDirectoryParams, IBrowseDirectoryResult, IFetchTurnsParams, IFetchTurnsResult, IUnsubscribeParams, IDispatchActionParams, IAuthenticateParams, IAuthenticateResult } from "./commands.js";
 import type { IActionEnvelope } from "./actions.js";
 import type { IProtocolNotification } from "./notifications.js";
 /** A JSON-RPC request: has both `method` and `id`. */
@@ -66,6 +66,10 @@ export interface ICommandMap {
         params: IFetchContentParams;
         result: IFetchContentResult;
     };
+    "writeFile": {
+        params: IWriteFileParams;
+        result: IWriteFileResult;
+    };
     "browseDirectory": {
         params: IBrowseDirectoryParams;
         result: IBrowseDirectoryResult;