Skip to content

Commit f026432

Browse files
benbrandtbenbrandt
authored
feat: Update to 0.10 of the schema (#31)
1 parent 775992a commit f026432

File tree

8 files changed

+594
-262
lines changed

8 files changed

+594
-262
lines changed

‎package-lock.json‎

Lines changed: 244 additions & 251 deletions
Some generated files are not rendered by default. Learn more about customizing how changed files appear on GitHub.

‎package.json‎

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -47,20 +47,20 @@
4747
"zod": "^3.25.0 || ^4.0.0"
4848
},
4949
"devDependencies": {
50-
"@hey-api/openapi-ts": "^0.88.0",
50+
"@hey-api/openapi-ts": "^0.88.1",
5151
"@types/node": "^24.10.1",
52-
"@typescript-eslint/eslint-plugin": "^8.48.0",
53-
"@typescript-eslint/parser": "^8.48.0",
52+
"@typescript-eslint/eslint-plugin": "^8.48.1",
53+
"@typescript-eslint/parser": "^8.48.1",
5454
"concurrently": "^9.2.1",
5555
"eslint": "^9.39.1",
5656
"eslint-config-prettier": "^10.1.8",
5757
"http-server": "^14.1.1",
58-
"prettier": "^3.7.3",
58+
"prettier": "^3.7.4",
5959
"tsx": "^4.21.0",
6060
"typedoc": "^0.28.15",
6161
"typedoc-github-theme": "^0.3.1",
6262
"typescript": "^5.9.3",
63-
"vitest": "^4.0.14",
63+
"vitest": "^4.0.15",
6464
"zod": "^3.25.0 || ^4.0.0"
6565
}
6666
}

‎schema/meta.json‎

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -3,6 +3,7 @@
33
"authenticate": "authenticate",
44
"initialize": "initialize",
55
"session_cancel": "session/cancel",
6+
"session_fork": "session/fork",
67
"session_list": "session/list",
78
"session_load": "session/load",
89
"session_new": "session/new",

‎schema/schema.json‎

Lines changed: 151 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -208,6 +208,9 @@
208208
{
209209
"$ref": "#/$defs/ListSessionsResponse"
210210
},
211+
{
212+
"$ref": "#/$defs/ForkSessionResponse"
213+
},
211214
{
212215
"$ref": "#/$defs/SetSessionModeResponse"
213216
},
@@ -573,6 +576,14 @@
573576
],
574577
"description": "**UNSTABLE**\n\nThis capability is not part of the spec yet, and may be removed or changed at any point.\n\nLists existing sessions known to the agent.\n\nThis method is only available if the agent advertises the `listSessions` capability.\n\nThe agent should return metadata about sessions with optional filtering and pagination support."
575578
},
579+
{
580+
"allOf": [
581+
{
582+
"$ref": "#/$defs/ForkSessionRequest"
583+
}
584+
],
585+
"description": "**UNSTABLE**\n\nThis capability is not part of the spec yet, and may be removed or changed at any point.\n\nForks an existing session to create a new independent session.\n\nThis method is only available if the agent advertises the `session.fork` capability.\n\nThe agent should create a new session with the same conversation context as the\noriginal, allowing operations like generating summaries without affecting the\noriginal session's history."
586+
},
576587
{
577588
"allOf": [
578589
{
@@ -976,9 +987,12 @@
976987
"description": "JSON-RPC error object.\n\nRepresents an error that occurred during method execution, following the\nJSON-RPC 2.0 error object specification with optional additional data.\n\nSee protocol docs: [JSON-RPC Error Object](https://www.jsonrpc.org/specification#error_object)",
977988
"properties": {
978989
"code": {
979-
"description": "A number indicating the error type that occurred.\nThis must be an integer as defined in the JSON-RPC specification.",
980-
"format": "int32",
981-
"type": "integer"
990+
"allOf": [
991+
{
992+
"$ref": "#/$defs/ErrorCode"
993+
}
994+
],
995+
"description": "A number indicating the error type that occurred.\nThis must be an integer as defined in the JSON-RPC specification."
982996
},
983997
"data": {
984998
"description": "Optional primitive or structured value that contains additional information about the error.\nThis may include debugging information or context-specific details."
@@ -991,6 +1005,58 @@
9911005
"required": ["code", "message"],
9921006
"type": "object"
9931007
},
1008+
"ErrorCode": {
1009+
"anyOf": [
1010+
{
1011+
"const": -32700,
1012+
"description": "**Parse error**: Invalid JSON was received by the server.\nAn error occurred on the server while parsing the JSON text.",
1013+
"format": "int32",
1014+
"type": "integer"
1015+
},
1016+
{
1017+
"const": -32600,
1018+
"description": "**Invalid request**: The JSON sent is not a valid Request object.",
1019+
"format": "int32",
1020+
"type": "integer"
1021+
},
1022+
{
1023+
"const": -32601,
1024+
"description": "**Method not found**: The method does not exist or is not available.",
1025+
"format": "int32",
1026+
"type": "integer"
1027+
},
1028+
{
1029+
"const": -32602,
1030+
"description": "**Invalid params**: Invalid method parameter(s).",
1031+
"format": "int32",
1032+
"type": "integer"
1033+
},
1034+
{
1035+
"const": -32603,
1036+
"description": "**Internal error**: Internal JSON-RPC error.\nReserved for implementation-defined server errors.",
1037+
"format": "int32",
1038+
"type": "integer"
1039+
},
1040+
{
1041+
"const": -32000,
1042+
"description": "**Authentication required**: Authentication is required before this operation can be performed.",
1043+
"format": "int32",
1044+
"type": "integer"
1045+
},
1046+
{
1047+
"const": -32002,
1048+
"description": "**Resource not found**: A given resource, such as a file, was not found.",
1049+
"format": "int32",
1050+
"type": "integer"
1051+
},
1052+
{
1053+
"description": "Other undefined error code.",
1054+
"format": "int32",
1055+
"type": "integer"
1056+
}
1057+
],
1058+
"description": "Predefined error codes for common JSON-RPC and ACP-specific errors.\n\nThese codes follow the JSON-RPC 2.0 specification for standard errors\nand use the reserved range (-32000 to -32099) for protocol-specific errors."
1059+
},
9941060
"ExtNotification": {
9951061
"description": "Allows the Agent to send an arbitrary notification that is not part of the ACP spec.\nExtension notifications provide a way to send one-way messages for custom functionality\nwhile maintaining protocol compatibility.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)"
9961062
},
@@ -1021,6 +1087,68 @@
10211087
},
10221088
"type": "object"
10231089
},
1090+
"ForkSessionRequest": {
1091+
"description": "**UNSTABLE**\n\nThis capability is not part of the spec yet, and may be removed or changed at any point.\n\nRequest parameters for forking an existing session.\n\nCreates a new session based on the context of an existing one, allowing\noperations like generating summaries without affecting the original session's history.\n\nOnly available if the Agent supports the `session.fork` capability.",
1092+
"properties": {
1093+
"_meta": {
1094+
"description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)"
1095+
},
1096+
"sessionId": {
1097+
"allOf": [
1098+
{
1099+
"$ref": "#/$defs/SessionId"
1100+
}
1101+
],
1102+
"description": "The ID of the session to fork."
1103+
}
1104+
},
1105+
"required": ["sessionId"],
1106+
"type": "object",
1107+
"x-method": "session/fork",
1108+
"x-side": "agent"
1109+
},
1110+
"ForkSessionResponse": {
1111+
"description": "**UNSTABLE**\n\nThis capability is not part of the spec yet, and may be removed or changed at any point.\n\nResponse from forking an existing session.",
1112+
"properties": {
1113+
"_meta": {
1114+
"description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)"
1115+
},
1116+
"models": {
1117+
"anyOf": [
1118+
{
1119+
"$ref": "#/$defs/SessionModelState"
1120+
},
1121+
{
1122+
"type": "null"
1123+
}
1124+
],
1125+
"description": "**UNSTABLE**\n\nThis capability is not part of the spec yet, and may be removed or changed at any point.\n\nInitial model state if supported by the Agent"
1126+
},
1127+
"modes": {
1128+
"anyOf": [
1129+
{
1130+
"$ref": "#/$defs/SessionModeState"
1131+
},
1132+
{
1133+
"type": "null"
1134+
}
1135+
],
1136+
"description": "Initial mode state if supported by the Agent\n\nSee protocol docs: [Session Modes](https://agentclientprotocol.com/protocol/session-modes)"
1137+
},
1138+
"sessionId": {
1139+
"allOf": [
1140+
{
1141+
"$ref": "#/$defs/SessionId"
1142+
}
1143+
],
1144+
"description": "Unique identifier for the newly created forked session."
1145+
}
1146+
},
1147+
"required": ["sessionId"],
1148+
"type": "object",
1149+
"x-method": "session/fork",
1150+
"x-side": "agent"
1151+
},
10241152
"HttpHeader": {
10251153
"description": "An HTTP header to set when making requests to the MCP server.",
10261154
"properties": {
@@ -2127,6 +2255,17 @@
21272255
"description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)",
21282256
"type": ["object", "null"]
21292257
},
2258+
"fork": {
2259+
"anyOf": [
2260+
{
2261+
"$ref": "#/$defs/SessionForkCapabilities"
2262+
},
2263+
{
2264+
"type": "null"
2265+
}
2266+
],
2267+
"description": "**UNSTABLE**\n\nThis capability is not part of the spec yet, and may be removed or changed at any point.\n\nWhether the agent supports `session/fork`."
2268+
},
21302269
"list": {
21312270
"anyOf": [
21322271
{
@@ -2141,6 +2280,15 @@
21412280
},
21422281
"type": "object"
21432282
},
2283+
"SessionForkCapabilities": {
2284+
"description": "**UNSTABLE**\n\nThis capability is not part of the spec yet, and may be removed or changed at any point.\n\nCapabilities for the `session/fork` method.\n\nBy supplying `{}` it means that the agent supports forking of sessions.",
2285+
"properties": {
2286+
"_meta": {
2287+
"description": "The _meta property is reserved by ACP to allow clients and agents to attach additional\nmetadata to their interactions. Implementations MUST NOT make assumptions about values at\nthese keys.\n\nSee protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)"
2288+
}
2289+
},
2290+
"type": "object"
2291+
},
21442292
"SessionId": {
21452293
"description": "A unique identifier for a conversation session between a client and agent.\n\nSessions maintain their own context, conversation history, and state,\nallowing multiple independent interactions with the same agent.\n\nSee protocol docs: [Session ID](https://agentclientprotocol.com/protocol/session-setup#session-id)",
21462294
"type": "string"

‎scripts/generate.js‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,7 @@ import * as fs from "fs/promises";
55
import { dirname } from "path";
66
import * as prettier from "prettier";
77

8-
const CURRENT_SCHEMA_RELEASE = "v0.9.1";
8+
const CURRENT_SCHEMA_RELEASE = "v0.10.0";
99

1010
await main();
1111

‎src/schema/index.ts‎

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -6,6 +6,7 @@ export const AGENT_METHODS = {
66
authenticate: "authenticate",
77
initialize: "initialize",
88
session_cancel: "session/cancel",
9+
session_fork: "session/fork",
910
session_list: "session/list",
1011
session_load: "session/load",
1112
session_new: "session/new",

0 commit comments

Comments
 (0)