@codingame/monaco-vscode-chat-service-override 28.4.1 → 29.0.0

package/index.js

@@ -82,14 +82,7 @@ import { ChatEditingExplanationModelManager } from './vscode/src/vs/workbench/co
 import { ChatToolOutputStateCache } from './vscode/src/vs/workbench/contrib/chat/browser/widget/chatContentParts/toolInvocationParts/chatToolOutputStateCache.js';
 import { ITerminalSandboxService } from '@codingame/monaco-vscode-api/vscode/vs/workbench/contrib/terminalContrib/chatAgentTools/common/terminalSandboxService.service';
 import { TerminalSandboxService } from './vscode/src/vs/workbench/contrib/terminalContrib/chatAgentTools/common/terminalSandboxService.js';
-import { IAgentFeedbackService } from '@codingame/monaco-vscode-api/vscode/vs/sessions/contrib/agentFeedback/browser/agentFeedbackService.service';
-import { AgentFeedbackService } from './vscode/src/vs/sessions/contrib/agentFeedback/browser/agentFeedbackService.js';
-import { ISessionsConfigurationService } from '@codingame/monaco-vscode-api/vscode/vs/sessions/contrib/chat/browser/sessionsConfigurationService.service';
-import { SessionsConfigurationService } from './vscode/src/vs/sessions/contrib/chat/browser/sessionsConfigurationService.js';
 import { IAICustomizationWorkspaceService } from '@codingame/monaco-vscode-api/vscode/vs/workbench/contrib/chat/common/aiCustomizationWorkspaceService.service';
-import { SessionsAICustomizationWorkspaceService } from './vscode/src/vs/sessions/contrib/chat/browser/aiCustomizationWorkspaceService.js';
-import { ISessionsManagementService } from '@codingame/monaco-vscode-api/vscode/vs/sessions/contrib/sessions/browser/sessionsManagementService.service';
-import { SessionsManagementService } from './vscode/src/vs/sessions/contrib/sessions/browser/sessionsManagementService.js';
 import { IAgentPluginService } from '@codingame/monaco-vscode-api/vscode/vs/workbench/contrib/chat/common/plugins/agentPluginService.service';
 import { AgentPluginService } from './vscode/src/vs/workbench/contrib/chat/common/plugins/agentPluginServiceImpl.js';
 import { PluginMarketplaceService } from './vscode/src/vs/workbench/contrib/chat/common/plugins/pluginMarketplaceService.js';
@@ -106,6 +99,17 @@ import { IChatResponseResourceFileSystemProvider } from '@codingame/monaco-vscod
 import { ChatResponseResourceFileSystemProvider } from './vscode/src/vs/workbench/contrib/chat/common/widget/chatResponseResourceFileSystemProvider.js';
 import { Event } from '@codingame/monaco-vscode-api/vscode/vs/base/common/event';
 import { IDefaultAccountService } from '@codingame/monaco-vscode-api/vscode/vs/platform/defaultAccount/common/defaultAccount.service';
+import { ICustomizationHarnessService } from '@codingame/monaco-vscode-api/vscode/vs/workbench/contrib/chat/common/customizationHarnessService.service';
+import { CustomizationHarnessService } from './vscode/src/vs/workbench/contrib/chat/browser/aiCustomization/customizationHarnessService.js';
+import { AICustomizationWorkspaceService } from './vscode/src/vs/workbench/contrib/chat/browser/aiCustomization/aiCustomizationWorkspaceService.js';
+import { IChatArtifactsService } from '@codingame/monaco-vscode-api/vscode/vs/workbench/contrib/chat/common/tools/chatArtifactsService.service';
+import { ChatArtifactsService } from './vscode/src/vs/workbench/contrib/chat/common/tools/chatArtifactsService.js';
+import { IWorkspacePluginSettingsService } from '@codingame/monaco-vscode-api/vscode/vs/workbench/contrib/chat/common/plugins/workspacePluginSettingsService.service';
+import { WorkspacePluginSettingsService } from './vscode/src/vs/workbench/contrib/chat/common/plugins/workspacePluginSettingsService.js';
+import { IChatImageCarouselService } from '@codingame/monaco-vscode-api/vscode/vs/workbench/contrib/chat/browser/chatImageCarouselService.service';
+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 './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';
@@ -173,10 +177,7 @@ function getServiceOverride({ defaultAccount } = {}) {
         [IChatEditingExplanationModelManager.toString()]: new SyncDescriptor(ChatEditingExplanationModelManager, [], true),
         [IChatToolOutputStateCache.toString()]: new SyncDescriptor(ChatToolOutputStateCache, [], true),
         [ITerminalSandboxService.toString()]: new SyncDescriptor(TerminalSandboxService, [], true),
-        [IAgentFeedbackService.toString()]: new SyncDescriptor(AgentFeedbackService, [], true),
-        [ISessionsConfigurationService.toString()]: new SyncDescriptor(SessionsConfigurationService, [], true),
-        [IAICustomizationWorkspaceService.toString()]: new SyncDescriptor(SessionsAICustomizationWorkspaceService, [], true),
-        [ISessionsManagementService.toString()]: new SyncDescriptor(SessionsManagementService, [], true),
+        [IAICustomizationWorkspaceService.toString()]: new SyncDescriptor(AICustomizationWorkspaceService, [], true),
         [IAgentPluginService.toString()]: new SyncDescriptor(AgentPluginService, [], true),
         [IPluginMarketplaceService.toString()]: new SyncDescriptor(PluginMarketplaceService, [], true),
         [IAgentPluginRepositoryService.toString()]: new SyncDescriptor(AgentPluginRepositoryService, [], true),
@@ -184,7 +185,12 @@ function getServiceOverride({ defaultAccount } = {}) {
         [IChatAttachmentWidgetRegistry.toString()]: new SyncDescriptor(ChatAttachmentWidgetRegistry, [], true),
         [IChatDebugService.toString()]: new SyncDescriptor(ChatDebugServiceImpl, [], true),
         [IChatResponseResourceFileSystemProvider.toString()]: new SyncDescriptor(ChatResponseResourceFileSystemProvider, [], true),
-        [IDefaultAccountService.toString()]: new SyncDescriptor(DefaultAccountService, [defaultAccount], true)
+        [IDefaultAccountService.toString()]: new SyncDescriptor(DefaultAccountService, [defaultAccount], true),
+        [ICustomizationHarnessService.toString()]: new SyncDescriptor(CustomizationHarnessService, [defaultAccount], true),
+        [IChatArtifactsService.toString()]: new SyncDescriptor(ChatArtifactsService, [], true),
+        [IWorkspacePluginSettingsService.toString()]: new SyncDescriptor(WorkspacePluginSettingsService, [], true),
+        [IChatImageCarouselService.toString()]: new SyncDescriptor(ChatImageCarouselService, [], true),
+        [IInlineChatHistoryService.toString()]: new SyncDescriptor(InlineChatHistoryService, [], true)
     };
 }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@codingame/monaco-vscode-chat-service-override",
-  "version": "28.4.1",
+  "version": "29.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": "28.4.1",
-    "@codingame/monaco-vscode-katex-common": "28.4.1",
-    "@codingame/monaco-vscode-xterm-addons-common": "28.4.1",
-    "@codingame/monaco-vscode-xterm-common": "28.4.1"
+    "@codingame/monaco-vscode-api": "29.0.0",
+    "@codingame/monaco-vscode-katex-common": "29.0.0",
+    "@codingame/monaco-vscode-xterm-addons-common": "29.0.0",
+    "@codingame/monaco-vscode-xterm-common": "29.0.0"
   },
   "main": "index.js",
   "module": "index.js",

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

@@ -0,0 +1,300 @@
+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";
+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"
+}
+/** Configuration key that controls whether the agent host process is spawned. */
+export declare const AgentHostEnabledSettingId = "chat.agentHost.enabled";
+export interface IAgentSessionMetadata {
+    readonly session: URI;
+    readonly startTime: number;
+    readonly modifiedTime: number;
+    readonly summary?: string;
+    readonly workingDirectory?: string;
+}
+export type AgentProvider = string;
+/** Metadata describing an agent backend, discovered over IPC. */
+export interface IAgentDescriptor {
+    readonly provider: AgentProvider;
+    readonly displayName: string;
+    readonly description: string;
+    /**
+     * Whether the renderer should push a GitHub auth token for this agent.
+     * @deprecated Use {@link IResourceMetadata.resources} from {@link IAgentService.getResourceMetadata} instead.
+     */
+    readonly requiresAuth: boolean;
+}
+/**
+ * Describes the agent host as an OAuth 2.0 protected resource.
+ * Uses {@link IAuthorizationProtectedResourceMetadata} from RFC 9728
+ * to describe auth requirements, enabling clients to resolve tokens
+ * using the standard VS Code authentication service.
+ *
+ * Returned from the server via {@link IAgentService.getResourceMetadata}.
+ */
+export interface IResourceMetadata {
+    /**
+     * Protected resources the agent host requires authentication for.
+     * Each entry uses the standard RFC 9728 shape so clients can resolve
+     * tokens via {@link IAuthenticationService.getOrActivateProviderIdForServer}.
+     */
+    readonly resources: readonly IAuthorizationProtectedResourceMetadata[];
+}
+/**
+ * Parameters for the `authenticate` command.
+ * Analogous to sending `Authorization: Bearer <token>` (RFC 6750 section 2.1).
+ */
+export interface IAuthenticateParams {
+    /**
+     * The `resource` identifier from the server's
+     * {@link IAuthorizationProtectedResourceMetadata} that this token targets.
+     */
+    readonly resource: string;
+    /** The bearer token value (RFC 6750). */
+    readonly token: string;
+}
+/**
+ * Result of the `authenticate` command.
+ */
+export interface IAuthenticateResult {
+    /** Whether the token was accepted. */
+    readonly authenticated: boolean;
+}
+export interface IAgentCreateSessionConfig {
+    readonly provider?: AgentProvider;
+    readonly model?: string;
+    readonly session?: URI;
+    readonly workingDirectory?: string;
+}
+/** Serializable attachment passed alongside a message to the agent host. */
+export interface IAgentAttachment {
+    readonly type: AttachmentType;
+    readonly path: string;
+    readonly displayName?: string;
+    /** For selections: the selected text. */
+    readonly text?: string;
+    /** For selections: line/character range. */
+    readonly selection?: {
+        readonly start: {
+            readonly line: number;
+            readonly character: number;
+        };
+        readonly end: {
+            readonly line: number;
+            readonly character: number;
+        };
+    };
+}
+/** Serializable model information from the agent host. */
+export interface IAgentModelInfo {
+    readonly provider: AgentProvider;
+    readonly id: string;
+    readonly name: string;
+    readonly maxContextWindow: number;
+    readonly supportsVision: boolean;
+    readonly supportsReasoningEffort: boolean;
+    readonly supportedReasoningEfforts?: readonly string[];
+    readonly defaultReasoningEffort?: string;
+    readonly policyState?: PolicyState;
+    readonly billingMultiplier?: number;
+}
+interface IAgentProgressEventBase {
+    readonly session: URI;
+}
+/** Streaming text delta from the assistant (`assistant.message_delta`). */
+export interface IAgentDeltaEvent extends IAgentProgressEventBase {
+    readonly type: "delta";
+    readonly messageId: string;
+    readonly content: string;
+    readonly parentToolCallId?: string;
+}
+/** A complete assistant message (`assistant.message`), used for history reconstruction. */
+export interface IAgentMessageEvent extends IAgentProgressEventBase {
+    readonly type: "message";
+    readonly role: "user" | "assistant";
+    readonly messageId: string;
+    readonly content: string;
+    readonly toolRequests?: readonly {
+        readonly toolCallId: string;
+        readonly name: string;
+        /** Serialized JSON of arguments, if available. */
+        readonly arguments?: string;
+        readonly type?: "function" | "custom";
+    }[];
+    readonly reasoningOpaque?: string;
+    readonly reasoningText?: string;
+    readonly encryptedContent?: string;
+    readonly parentToolCallId?: string;
+}
+/** The session has finished processing and is waiting for input (`session.idle`). */
+export interface IAgentIdleEvent extends IAgentProgressEventBase {
+    readonly type: "idle";
+}
+/** A tool has started executing (`tool.execution_start`). */
+export interface IAgentToolStartEvent extends IAgentProgressEventBase {
+    readonly type: "tool_start";
+    readonly toolCallId: string;
+    readonly toolName: string;
+    /** Human-readable display name for this tool. */
+    readonly displayName: string;
+    /** Message describing the tool invocation in progress (e.g., "Running `echo hello`"). */
+    readonly invocationMessage: string;
+    /** A representative input string for display in the UI (e.g., the shell command). */
+    readonly toolInput?: string;
+    /** Hint for the renderer about how to display this tool (e.g., 'terminal' for shell commands). */
+    readonly toolKind?: "terminal";
+    /** Language identifier for syntax highlighting (e.g., 'shellscript', 'powershell'). Used with toolKind 'terminal'. */
+    readonly language?: string;
+    /** Serialized JSON of the tool arguments, if available. */
+    readonly toolArguments?: string;
+    readonly mcpServerName?: string;
+    readonly mcpToolName?: string;
+    readonly parentToolCallId?: string;
+}
+/** A tool has finished executing (`tool.execution_complete`). */
+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;
+    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;
+}
+/** The session title has been updated. */
+export interface IAgentTitleChangedEvent extends IAgentProgressEventBase {
+    readonly type: "title_changed";
+    readonly title: string;
+}
+/** An error occurred during session processing. */
+export interface IAgentErrorEvent extends IAgentProgressEventBase {
+    readonly type: "error";
+    readonly errorType: string;
+    readonly message: string;
+    readonly stack?: string;
+}
+/** Token usage information for a request. */
+export interface IAgentUsageEvent extends IAgentProgressEventBase {
+    readonly type: "usage";
+    readonly inputTokens?: number;
+    readonly outputTokens?: number;
+    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;
+}
+/** 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 declare namespace AgentSession {
+    /**
+     * Creates a session URI from a provider name and raw session ID.
+     * The URI scheme is the provider name (e.g., `copilot:/<rawId>`).
+     */
+    function uri(provider: AgentProvider, rawSessionId: string): URI;
+    /**
+     * Extracts the raw session ID from a session URI (the path without leading slash).
+     * Accepts both a URI object and a URI string.
+     */
+    function id(session: URI | string): string;
+    /**
+     * Extracts the provider name from a session URI scheme.
+     * Accepts both a URI object and a URI string.
+     */
+    function provider(session: URI | string): AgentProvider | undefined;
+}
+/**
+ * Implemented by each agent backend (e.g. Copilot SDK).
+ * The {@link IAgentService} dispatches to the appropriate agent based on
+ * the agent id.
+ */
+export interface IAgent {
+    /** Unique identifier for this provider (e.g. `'copilot'`). */
+    readonly id: AgentProvider;
+    /** Fires when the provider streams progress for a session. */
+    readonly onDidSessionProgress: Event<IAgentProgressEvent>;
+    /** Create a new session. Returns the session URI. */
+    createSession(config?: IAgentCreateSessionConfig): Promise<URI>;
+    /** Send a user message into an existing session. */
+    sendMessage(session: URI, prompt: string, attachments?: IAgentAttachment[]): Promise<void>;
+    /** Retrieve all session events/messages for reconstruction. */
+    getSessionMessages(session: URI): Promise<(IAgentMessageEvent | IAgentToolStartEvent | IAgentToolCompleteEvent)[]>;
+    /** Dispose a session, freeing resources. */
+    disposeSession(session: URI): Promise<void>;
+    /** Abort the current turn, stopping any in-flight processing. */
+    abortSession(session: URI): Promise<void>;
+    /** Change the model for an existing session. */
+    changeModel(session: URI, model: string): Promise<void>;
+    /** Respond to a pending permission request from the SDK. */
+    respondToPermissionRequest(requestId: string, approved: boolean): void;
+    /** Return the descriptor for this agent. */
+    getDescriptor(): IAgentDescriptor;
+    /** List available models from this provider. */
+    listModels(): Promise<IAgentModelInfo[]>;
+    /** List persisted sessions from this provider. */
+    listSessions(): Promise<IAgentSessionMetadata[]>;
+    /** Declare protected resources this agent requires auth for (RFC 9728). */
+    getProtectedResources(): IAuthorizationProtectedResourceMetadata[];
+    /**
+     * Authenticate for a specific resource. Returns true if accepted.
+     * The `resource` matches {@link IAuthorizationProtectedResourceMetadata.resource}.
+     */
+    authenticate(resource: string, token: string): Promise<boolean>;
+    /** Gracefully shut down all sessions. */
+    shutdown(): Promise<void>;
+    /** Dispose this provider and all its resources. */
+    dispose(): void;
+}
+/**
+ * A concrete connection to an agent host - local utility process or remote
+ * WebSocket. Extends the core protocol surface with a `clientId` used for
+ * write-ahead reconciliation. Both {@link IAgentHostService} (local) and
+ * per-connection objects from {@link IRemoteAgentHostService} (remote)
+ * satisfy this contract.
+ */
+export interface IAgentConnection extends IAgentService {
+    /** Unique identifier for this client connection, used as the origin in action envelopes. */
+    readonly clientId: string;
+}
+export {};

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

@@ -0,0 +1,31 @@
+
+import { URI } from '@codingame/monaco-vscode-api/vscode/vs/base/common/uri';
+
+var AgentHostIpcChannels;
+(function(AgentHostIpcChannels) {
+    AgentHostIpcChannels["AgentHost"] = "agentHost";
+    AgentHostIpcChannels["Logger"] = "agentHostLogger";
+})(AgentHostIpcChannels || (AgentHostIpcChannels = {}));
+const AgentHostEnabledSettingId = "chat.agentHost.enabled";
+var AgentSession;
+(function(AgentSession) {
+    function uri(provider, rawSessionId) {
+        return ( URI.from({
+            scheme: provider,
+            path: `/${rawSessionId}`
+        }));
+    }
+    AgentSession.uri = uri;
+    function id(session) {
+        const parsed = typeof session === "string" ? ( URI.parse(session)) : session;
+        return parsed.path.substring(1);
+    }
+    AgentSession.id = id;
+    function provider(session) {
+        const parsed = typeof session === "string" ? ( URI.parse(session)) : session;
+        return parsed.scheme || undefined;
+    }
+    AgentSession.provider = provider;
+})(AgentSession || (AgentSession = {}));
+
+export { AgentHostEnabledSettingId, AgentHostIpcChannels, AgentSession };

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

@@ -0,0 +1,84 @@
+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 { ISnapshot as IStateSnapshot } from "./state/sessionState.js";
+export declare const IAgentService: import("@codingame/monaco-vscode-api/vscode/vs/platform/instantiation/common/instantiation").ServiceIdentifier<IAgentService>;
+/**
+* Service contract for communicating with the agent host process. Methods here
+* are proxied across MessagePort via `ProxyChannel`.
+*
+* State is synchronized via the subscribe/unsubscribe/dispatchAction protocol.
+* Clients observe root state (agents, models) and session state via subscriptions,
+* and mutate state by dispatching actions (e.g. session/turnStarted, session/turnCancelled).
+*/
+export interface IAgentService {
+    readonly _serviceBrand: undefined;
+    /** Discover available agent backends from the agent host. */
+    listAgents(): Promise<IAgentDescriptor[]>;
+    /**
+    * Retrieve the resource metadata describing auth requirements.
+    * Modeled on RFC 9728 (OAuth 2.0 Protected Resource Metadata).
+    */
+    getResourceMetadata(): Promise<IResourceMetadata>;
+    /**
+    * Authenticate for a protected resource on the server.
+    * The {@link IAuthenticateParams.resource} must match a resource from
+    * {@link getResourceMetadata}. Analogous to RFC 6750 bearer token delivery.
+    */
+    authenticate(params: IAuthenticateParams): Promise<IAuthenticateResult>;
+    /**
+    * Refresh the model list from all providers, publishing updated
+    * agents (with models) to root state via `root/agentsChanged`.
+    */
+    refreshModels(): Promise<void>;
+    /** List all available sessions from the Copilot CLI. */
+    listSessions(): Promise<IAgentSessionMetadata[]>;
+    /** Create a new session. Returns the session URI. */
+    createSession(config?: IAgentCreateSessionConfig): Promise<URI>;
+    /** Dispose a session in the agent host, freeing SDK resources. */
+    disposeSession(session: URI): Promise<void>;
+    /** Gracefully shut down all sessions and the underlying client. */
+    shutdown(): Promise<void>;
+    /**
+    * Subscribe to state at the given URI. Returns a snapshot of the current
+    * state and the serverSeq at snapshot time. Subsequent actions for this
+    * resource arrive via {@link onDidAction}.
+    */
+    subscribe(resource: URI): Promise<IStateSnapshot>;
+    /** Unsubscribe from state updates for the given URI. */
+    unsubscribe(resource: URI): void;
+    /**
+    * Fires when the server applies an action to subscribable state.
+    * Clients use this alongside {@link subscribe} to keep their local
+    * state in sync.
+    */
+    readonly onDidAction: Event<IActionEnvelope>;
+    /**
+    * Fires when the server broadcasts an ephemeral notification
+    * (e.g. sessionAdded, sessionRemoved).
+    */
+    readonly onDidNotification: Event<INotification>;
+    /**
+    * Dispatch a client-originated action to the server. The server applies
+    * it to state, triggers side effects, and echoes it back via
+    * {@link onDidAction} with the client's origin for reconciliation.
+    */
+    dispatchAction(action: ISessionAction, clientId: string, clientSeq: number): void;
+    /**
+    * List the contents of a directory on the agent host's filesystem.
+    * Used by the client to drive a remote folder picker before session creation.
+    */
+    browseDirectory(uri: URI): Promise<IBrowseDirectoryResult>;
+}
+export declare const IAgentHostService: import("@codingame/monaco-vscode-api/vscode/vs/platform/instantiation/common/instantiation").ServiceIdentifier<IAgentHostService>;
+/**
+* The local wrapper around the agent host process (manages lifecycle, restart,
+* exposes the proxied service). Consumed by the main process and workbench.
+*/
+export interface IAgentHostService extends IAgentConnection {
+    readonly onAgentHostExit: Event<number>;
+    readonly onAgentHostStart: Event<void>;
+    restartAgentHost(): Promise<void>;
+}

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

@@ -0,0 +1,16 @@
+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";
+/** 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;
+/** Union of session actions that clients may dispatch. */
+export type IClientSessionAction = ISessionTurnStartedAction | ISessionToolCallConfirmedAction | ISessionToolCallCompleteAction | ISessionToolCallResultConfirmedAction | ISessionPermissionResolvedAction | ISessionTurnCancelledAction | ISessionModelChangedAction | ISessionActiveClientChangedAction | ISessionActiveClientToolsChangedAction;
+/** 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;
+/**
+ * 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.
+ */
+export declare const IS_CLIENT_DISPATCHABLE: {
+    readonly [K in IStateAction["type"]]: boolean;
+};