src/vs/platform/agentHost/common/state/sessionProtocol.ts
148 LOC · 148 covered · 0 uncovered · 9 ranges · 3999 concepts · 5 introducers · 1921 tests
File neighbourhood
The centred file is linked to every concept that introduces one of its ranges, every test that runs code from the file, and the gray connector concepts standing between those tests and the file's own introducer concepts. Undirected links join concepts to every file where they introduce source and concepts to the tests they introduce; arrows show specialization between the displayed concepts and bridge only concepts omitted from this view. Concept colors match the source ranges below; connector concepts have no source color and are shown in gray.
Focused file, its introducer and connector concepts, their introduced files, and tests that run code from the file
In the embedded map, ordinary wheel input scrolls the page; use the visible controls to zoom and drag to pan. Open the full-screen map for canvas navigation: wheel pans, Ctrl/Command plus wheel zooms, and arrow keys pan when this region is focused. On touch screens, open the full-screen map to pan or pinch. If JavaScript or WebGL is unavailable, use the related-file, concept, and source links on this page.
Graph controls are ready.
Interactive rendering requires JavaScript and WebGL. Use the related-file, concept, and source links on this page while the interactive map is unavailable.
1
>
/*---------------------------------------------------------------------------------------------
sessionProtocol.ts ×5
2
>
* Copyright (c) Microsoft Corporation. All rights reserved.
3
>
* Licensed under the MIT License. See License.txt in the project root for license information.
4
>
*--------------------------------------------------------------------------------------------*/
5
>
6
>
// Protocol messages using JSON-RPC 2.0 framing for the sessions process.
7
>
// See protocol.md for the full design.
8
>
//
9
>
// Most types are re-exported from the auto-generated protocol layer.
10
>
// This file adds VS Code-specific additions (ISetAuthTokenParams, ProtocolError)
11
>
// and backward-compatible aliases.
12
>
13
>
// ---- Re-exports from protocol -----------------------------------------------
14
>
15
>
// JSON-RPC base types
16
>
export type {
17
>
JsonRpcErrorResponse,
18
>
JsonRpcNotification,
19
>
JsonRpcParseErrorResponse,
20
>
JsonRpcRequest,
21
>
JsonRpcResponse,
22
>
JsonRpcSuccessResponse,
23
>
} from './protocol/messages.js';
24
>
25
>
// Typed message unions
26
>
export type {
27
>
AhpClientNotification,
28
>
AhpNotification,
29
>
AhpRequest,
30
>
AhpResponse,
31
>
AhpServerNotification,
32
>
AhpSuccessResponse,
33
>
CommandMap,
34
>
ClientNotificationMap,
35
>
ProtocolMessage,
36
>
ServerNotificationMap,
37
>
} from './protocol/messages.js';
38
>
39
>
// Command params and results
40
>
export type {
41
>
CreateSessionParams,
42
>
DirectoryEntry,
43
>
DispatchActionParams,
44
>
DisposeSessionParams,
45
>
FetchTurnsParams,
46
>
FetchTurnsResult,
47
>
InitializeParams,
48
>
InitializeResult,
49
>
ListSessionsParams,
50
>
ListSessionsResult,
51
>
ReconnectParams,
52
>
ReconnectReplayResult,
53
>
ReconnectResult,
54
>
ReconnectSnapshotResult,
55
>
ResourceCopyParams,
56
>
ResourceCopyResult,
57
>
ResourceDeleteParams,
58
>
ResourceDeleteResult,
59
>
ResourceListParams,
60
>
ResourceListResult,
61
>
ResourceMkdirParams,
62
>
ResourceMkdirResult,
63
>
ResourceMoveParams,
64
>
ResourceMoveResult,
65
>
ResourceReadParams,
66
>
ResourceReadResult,
67
>
ResourceResolveParams,
68
>
ResourceResolveResult,
69
>
ResourceWriteParams,
70
>
ResourceWriteResult,
71
>
SubscribeParams,
72
>
SubscribeResult,
73
>
UnsubscribeParams,
74
>
} from './protocol/commands.js';
75
>
76
>
export type {
77
>
CreateResourceWatchParams,
78
>
CreateResourceWatchResult,
79
>
} from './protocol/channels-resource-watch/commands.js';
80
>
81
>
export { ContentEncoding, ReconnectResultType, ResourceType, ResourceWriteMode } from './protocol/commands.js';
82
>
export { ResourceChangeType } from './protocol/channels-resource-watch/state.js';
83
>
export type { ResourceChange, ResourceWatchState } from './protocol/channels-resource-watch/state.js';
84
>
85
>
// Error codes
86
>
export { AhpErrorCodes, JsonRpcErrorCodes } from './protocol/errors.js';
87
>
export type { AhpErrorCode, JsonRpcErrorCode } from './protocol/errors.js';
88
>
89
>
// Snapshot type (re-exported from state). The generated `Snapshot.state`
90
>
// union now includes `ChatState`, so per-chat snapshots type-check directly.
91
>
import type { Snapshot as ProtocolSnapshot } from './protocol/state.js';
92
>
export type IStateSnapshot = ProtocolSnapshot;
93
>
94
>
// ---- Backward-compatible error code aliases ---------------------------------
95
>
96
>
export const JSON_RPC_PARSE_ERROR = -32700 as const;
97
>
export const JSON_RPC_INTERNAL_ERROR = -32603 as const;
98
>
export const AHP_SESSION_NOT_FOUND = -32001 as const;
99
>
export const AHP_PROVIDER_NOT_FOUND = -32002 as const;
100
>
export const AHP_SESSION_ALREADY_EXISTS = -32003 as const;
101
>
export const AHP_TURN_IN_PROGRESS = -32004 as const;
102
>
export const AHP_UNSUPPORTED_PROTOCOL_VERSION = -32005 as const;
103
>
export const AHP_CONTENT_NOT_FOUND = -32006 as const;
104
>
export const AHP_AUTH_REQUIRED = -32007 as const;
105
>
106
>
// ---- Type guards -----------------------------------------------------------
107
>
108
>
import type { AhpRequest, AhpNotification, AhpSuccessResponse, ProtocolMessage, JsonRpcErrorResponse } from './protocol/messages.js';
109
>
110
>
export function isJsonRpcRequest(msg: ProtocolMessage): msg is AhpRequest {
112
>
}
114
>
export function isJsonRpcNotification(msg: ProtocolMessage): msg is AhpNotification {
116
>
}
118
>
export function isJsonRpcResponse(msg: ProtocolMessage): msg is AhpSuccessResponse | JsonRpcErrorResponse {
120
>
}
122
>
// ---- VS Code-specific types ------------------------------------------------
123
>
124
>
/**
125
>
* Error with a JSON-RPC error code for protocol-level failures.
126
>
* Optionally carries a `data` payload for structured error details.
127
>
*/
128
>
export class ProtocolError extends Error {
129
>
constructor(readonly code: number, message: string, readonly data?: unknown) {
131
>
}
133
>
134
>
/**
135
>
* VS Code-specific extension: set the auth token on the server.
136
>
* Not yet part of the official protocol.
137
>
*/
138
>
export interface ISetAuthTokenParams {
139
>
readonly token: string;
140
>
}
141
>
142
>
// ---- Server → Client notification param aliases (backward compat) -----------
143
>
144
>
import type { INotification } from './sessionActions.js';
145
>
146
>
export interface INotificationBroadcastParams {
147
>
readonly notification: INotification;
148
>
}