1
>
/*---------------------------------------------------------------------------------------------
registry.ts
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
>
// allow-any-unicode-comment-file
7
>
// DO NOT EDIT -- auto-generated by scripts/sync-agent-host-protocol.ts
8
>
9
>
import { ActionType, type StateAction } from '../actions.js';
10
>
import type { ServerNotificationMap } from '../messages.js';
11
>
12
>
// ─── Protocol Version Constants ──────────────────────────────────────────────
13
>
14
>
/**
15
>
* The current protocol version that new code speaks.
16
>
*
17
>
* Formatted as a [SemVer](https://semver.org) `MAJOR.MINOR.PATCH` string.
18
>
*/
19
>
export const PROTOCOL_VERSION = '0.7.0';
20
>
21
>
/**
22
>
* Every protocol version a client built from this source tree is willing
23
>
* to negotiate via the `initialize` handshake. Ordered **most preferred
24
>
* first** so a server picking the first acceptable entry honors the
25
>
* client's preference (see [versioning](../../docs/specification/versioning.md)).
26
>
*
27
>
* The first entry MUST equal {@link PROTOCOL_VERSION} — the version
28
>
* "new code speaks" is by definition the most preferred one. Older
29
>
* versions may be appended if a client retains the ability to fall back
30
>
* to them; today only one version is advertised.
31
>
*
32
>
* Every generated client (Rust, Kotlin, Swift) re-exports this constant
33
>
* verbatim. The TypeScript client consumes it directly. The per-client
34
>
* `release-metadata.json` files are validated against this list by
35
>
* `scripts/verify-release-metadata.ts`.
36
>
*/
37
>
export const SUPPORTED_PROTOCOL_VERSIONS: readonly string[] = Object.freeze([
38
>
'0.7.0',
39
>
'0.6.0',
40
>
'0.5.2',
41
>
'0.5.1',
42
>
]);
43
>
44
>
// ─── SemVer Comparison ───────────────────────────────────────────────────────
45
>
46
>
/**
47
>
* Parses a `MAJOR.MINOR.PATCH` SemVer string into its three numeric
48
>
* components. Pre-release and build metadata are not supported and MUST NOT
49
>
* be present in protocol version strings.
50
>
*
51
>
* Throws if `version` is not a well-formed `MAJOR.MINOR.PATCH` string.
52
>
*/
53
function parseSemver(version: string): readonly [number, number, number] {
54
const match = /^(\d+)\.(\d+)\.(\d+)$/.exec(version);