engineering-behavior-observatory 0.2.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (178) hide show
  1. package/LICENSE +202 -0
  2. package/README.md +151 -0
  3. package/contracts/codex-app-server-0.150.1/manifest.json +25 -0
  4. package/contracts/codex-app-server-0.150.1/schema/InitializeParams.json +84 -0
  5. package/contracts/codex-app-server-0.150.1/schema/JSONRPCMessage.json +137 -0
  6. package/contracts/codex-app-server-0.150.1/schema/v2/ThreadReadParams.json +17 -0
  7. package/contracts/codex-app-server-0.150.1/schema/v2/ThreadTokenUsageUpdatedNotification.json +82 -0
  8. package/contracts/codex-app-server-0.150.1/schema/v2/TurnInterruptParams.json +17 -0
  9. package/contracts/codex-app-server-0.150.1/types/AskForApproval.ts +5 -0
  10. package/contracts/codex-app-server-0.150.1/types/ClientNotification.ts +5 -0
  11. package/contracts/codex-app-server-0.150.1/types/SandboxMode.ts +5 -0
  12. package/contracts/codex-app-server-0.150.1/types/ThreadReadParams.ts +9 -0
  13. package/contracts/codex-app-server-0.150.1/types/TokenUsageBreakdown.ts +5 -0
  14. package/contracts/codex-app-server-0.150.1/types/TurnInterruptParams.ts +5 -0
  15. package/contracts/codex-app-server-0.153.4/manifest.json +27 -0
  16. package/contracts/codex-app-server-0.153.4/schema/JSONRPCMessage.json +137 -0
  17. package/contracts/codex-app-server-0.153.4/schema/v1/InitializeParams.json +84 -0
  18. package/contracts/codex-app-server-0.153.4/schema/v2/ThreadReadParams.json +17 -0
  19. package/contracts/codex-app-server-0.153.4/schema/v2/ThreadStartParams.json +515 -0
  20. package/contracts/codex-app-server-0.153.4/schema/v2/ThreadTokenUsageUpdatedNotification.json +82 -0
  21. package/contracts/codex-app-server-0.153.4/schema/v2/TurnInterruptParams.json +17 -0
  22. package/contracts/codex-app-server-0.153.4/schema/v2/TurnStartParams.json +921 -0
  23. package/contracts/codex-app-server-0.153.4/types/AskForApproval.ts +5 -0
  24. package/contracts/codex-app-server-0.153.4/types/ClientNotification.ts +5 -0
  25. package/contracts/codex-app-server-0.153.4/types/SandboxMode.ts +5 -0
  26. package/contracts/codex-app-server-0.153.4/types/ThreadReadParams.ts +12 -0
  27. package/contracts/codex-app-server-0.153.4/types/TokenUsageBreakdown.ts +5 -0
  28. package/contracts/codex-app-server-0.153.4/types/TurnInterruptParams.ts +5 -0
  29. package/contracts/openhands-agent-server-v1.44.1.json +65 -0
  30. package/contracts/openhands-agent-server-v1.46.0.json +46 -0
  31. package/dist/contracts/codex-app-server-0.153.4/types/AskForApproval.d.ts +9 -0
  32. package/dist/contracts/codex-app-server-0.153.4/types/AskForApproval.js +2 -0
  33. package/dist/contracts/codex-app-server-0.153.4/types/ClientNotification.d.ts +3 -0
  34. package/dist/contracts/codex-app-server-0.153.4/types/ClientNotification.js +2 -0
  35. package/dist/contracts/codex-app-server-0.153.4/types/SandboxMode.d.ts +1 -0
  36. package/dist/contracts/codex-app-server-0.153.4/types/SandboxMode.js +2 -0
  37. package/dist/contracts/codex-app-server-0.153.4/types/ThreadReadParams.d.ts +10 -0
  38. package/dist/contracts/codex-app-server-0.153.4/types/ThreadReadParams.js +2 -0
  39. package/dist/contracts/codex-app-server-0.153.4/types/TokenUsageBreakdown.d.ts +8 -0
  40. package/dist/contracts/codex-app-server-0.153.4/types/TokenUsageBreakdown.js +2 -0
  41. package/dist/contracts/codex-app-server-0.153.4/types/TurnInterruptParams.d.ts +4 -0
  42. package/dist/contracts/codex-app-server-0.153.4/types/TurnInterruptParams.js +2 -0
  43. package/dist/src/agent-sdk-normalizer.d.ts +22 -0
  44. package/dist/src/agent-sdk-normalizer.js +995 -0
  45. package/dist/src/agent-sdk-run.d.ts +31 -0
  46. package/dist/src/agent-sdk-run.js +242 -0
  47. package/dist/src/agent-sdk-runner.d.ts +96 -0
  48. package/dist/src/agent-sdk-runner.js +407 -0
  49. package/dist/src/agent-sdk.d.ts +294 -0
  50. package/dist/src/agent-sdk.js +644 -0
  51. package/dist/src/aggregation.d.ts +183 -0
  52. package/dist/src/aggregation.js +513 -0
  53. package/dist/src/artifacts.d.ts +36 -0
  54. package/dist/src/artifacts.js +1372 -0
  55. package/dist/src/atlas-grafana.d.ts +377 -0
  56. package/dist/src/atlas-grafana.js +47 -0
  57. package/dist/src/atlas-html.d.ts +2 -0
  58. package/dist/src/atlas-html.js +34 -0
  59. package/dist/src/atlas.d.ts +130 -0
  60. package/dist/src/atlas.js +235 -0
  61. package/dist/src/behavior-assertions.d.ts +95 -0
  62. package/dist/src/behavior-assertions.js +154 -0
  63. package/dist/src/cli.d.ts +5 -0
  64. package/dist/src/cli.js +957 -0
  65. package/dist/src/codex-judge.d.ts +44 -0
  66. package/dist/src/codex-judge.js +214 -0
  67. package/dist/src/codex-run.d.ts +114 -0
  68. package/dist/src/codex-run.js +519 -0
  69. package/dist/src/codex.d.ts +187 -0
  70. package/dist/src/codex.js +1028 -0
  71. package/dist/src/contracts.d.ts +155 -0
  72. package/dist/src/contracts.js +866 -0
  73. package/dist/src/corpus.d.ts +67 -0
  74. package/dist/src/corpus.js +540 -0
  75. package/dist/src/cursor-sdk-runner.d.ts +81 -0
  76. package/dist/src/cursor-sdk-runner.js +362 -0
  77. package/dist/src/cursor-sdk.d.ts +81 -0
  78. package/dist/src/cursor-sdk.js +1078 -0
  79. package/dist/src/deepseek-adapter.d.ts +152 -0
  80. package/dist/src/deepseek-adapter.js +777 -0
  81. package/dist/src/exports.d.ts +69 -0
  82. package/dist/src/exports.js +966 -0
  83. package/dist/src/human-calibration.d.ts +167 -0
  84. package/dist/src/human-calibration.js +618 -0
  85. package/dist/src/index.d.ts +71 -0
  86. package/dist/src/index.js +38 -0
  87. package/dist/src/lifecycle.d.ts +196 -0
  88. package/dist/src/lifecycle.js +1889 -0
  89. package/dist/src/normalization-integrity.d.ts +128 -0
  90. package/dist/src/normalization-integrity.js +429 -0
  91. package/dist/src/openhands-run.d.ts +36 -0
  92. package/dist/src/openhands-run.js +415 -0
  93. package/dist/src/openhands.d.ts +130 -0
  94. package/dist/src/openhands.js +859 -0
  95. package/dist/src/pi.d.ts +203 -0
  96. package/dist/src/pi.js +1345 -0
  97. package/dist/src/process-protocol.d.ts +245 -0
  98. package/dist/src/process-protocol.js +1261 -0
  99. package/dist/src/retained-evidence.d.ts +12 -0
  100. package/dist/src/retained-evidence.js +201 -0
  101. package/dist/src/run-bundles.d.ts +193 -0
  102. package/dist/src/run-bundles.js +993 -0
  103. package/dist/src/scheduler.d.ts +109 -0
  104. package/dist/src/scheduler.js +1080 -0
  105. package/dist/src/semantic-judge.d.ts +194 -0
  106. package/dist/src/semantic-judge.js +875 -0
  107. package/dist/src/structural-observations.d.ts +124 -0
  108. package/dist/src/structural-observations.js +671 -0
  109. package/dist/src/task-packets.d.ts +115 -0
  110. package/dist/src/task-packets.js +683 -0
  111. package/dist/src/uniform-events.d.ts +120 -0
  112. package/dist/src/uniform-events.js +158 -0
  113. package/dist/src/verifiers.d.ts +116 -0
  114. package/dist/src/verifiers.js +819 -0
  115. package/dist/src/workspaces.d.ts +56 -0
  116. package/dist/src/workspaces.js +1314 -0
  117. package/docs/README.md +60 -0
  118. package/docs/development/README.md +71 -0
  119. package/docs/development/documentation-sync.md +58 -0
  120. package/docs/development/extension-contracts.md +307 -0
  121. package/docs/evaluation/README.md +48 -0
  122. package/docs/evaluation/aggregation.md +112 -0
  123. package/docs/evaluation/behavior-assertions.md +45 -0
  124. package/docs/evaluation/human-calibration.md +170 -0
  125. package/docs/evaluation/normalization-integrity.md +80 -0
  126. package/docs/evaluation/semantic-judge.md +188 -0
  127. package/docs/evaluation/structural-observations.md +84 -0
  128. package/docs/evaluation/uniform-events.md +131 -0
  129. package/docs/guides/atlas.md +144 -0
  130. package/docs/guides/evidence-and-sharing.md +100 -0
  131. package/docs/guides/operator-guide.md +424 -0
  132. package/docs/guides/quickstart.md +152 -0
  133. package/docs/guides/telemetry.md +66 -0
  134. package/docs/harnesses/README.md +31 -0
  135. package/docs/harnesses/claude-agent-sdk.md +61 -0
  136. package/docs/harnesses/codex-harness.md +174 -0
  137. package/docs/harnesses/cursor-sdk.md +149 -0
  138. package/docs/harnesses/deepseek-harness.md +134 -0
  139. package/docs/harnesses/openhands-agent-server.md +153 -0
  140. package/docs/harnesses/pi-sdk.md +66 -0
  141. package/docs/reference/README.md +19 -0
  142. package/docs/reference/agent-sdk-operational-runner.md +118 -0
  143. package/docs/reference/cli.md +114 -0
  144. package/docs/reference/contracts.md +222 -0
  145. package/docs/reference/run-bundle-contract.md +354 -0
  146. package/docs/reference/run-lifecycle.md +54 -0
  147. package/examples/cursor-sdk/README.md +11 -0
  148. package/examples/cursor-sdk/capture-profile.json +1 -0
  149. package/examples/cursor-sdk/harness.json +1 -0
  150. package/examples/cursor-sdk/model.json +1 -0
  151. package/examples/cursor-sdk/native-limits.json +1 -0
  152. package/examples/cursor-sdk/native-tool-policy.json +1 -0
  153. package/ontology/behavior-categories.v1.json +46 -0
  154. package/package.json +66 -0
  155. package/release/0.1.0/KNOWN_LIMITATIONS.md +35 -0
  156. package/release/0.1.0/README.md +46 -0
  157. package/release/0.1.0/reproducibility.json +61 -0
  158. package/release/0.2.0/KNOWN_LIMITATIONS.md +40 -0
  159. package/release/0.2.0/README.md +42 -0
  160. package/release/0.2.0/reproducibility.json +73 -0
  161. package/release/0.2.1/KNOWN_LIMITATIONS.md +18 -0
  162. package/release/0.2.1/README.md +63 -0
  163. package/release/0.2.1/reproducibility.json +73 -0
  164. package/release/README.md +13 -0
  165. package/schemas/aggregation.v1.json +293 -0
  166. package/schemas/behavior-assertions.v1.json +220 -0
  167. package/schemas/deepseek-runtime-composition.v1.schema.json +122 -0
  168. package/schemas/experiment.v1.schema.json +188 -0
  169. package/schemas/human-calibration.v1.json +336 -0
  170. package/schemas/normalization-integrity.v1.json +302 -0
  171. package/schemas/run-bundles/v1.json +1040 -0
  172. package/schemas/run-queue.v1.schema.json +206 -0
  173. package/schemas/semantic-judge.v1.json +380 -0
  174. package/schemas/structural-observations.v1.json +131 -0
  175. package/schemas/task-packet-freeze.v1.schema.json +106 -0
  176. package/schemas/task-packet.v1.schema.json +234 -0
  177. package/schemas/uniform-events/v1.json +289 -0
  178. package/scripts/atlas-grafana.sh +18 -0
@@ -0,0 +1,82 @@
1
+ {
2
+ "$schema": "http://json-schema.org/draft-07/schema#",
3
+ "definitions": {
4
+ "ThreadTokenUsage": {
5
+ "properties": {
6
+ "last": {
7
+ "$ref": "#/definitions/TokenUsageBreakdown"
8
+ },
9
+ "modelContextWindow": {
10
+ "format": "int64",
11
+ "type": [
12
+ "integer",
13
+ "null"
14
+ ]
15
+ },
16
+ "total": {
17
+ "$ref": "#/definitions/TokenUsageBreakdown"
18
+ }
19
+ },
20
+ "required": [
21
+ "last",
22
+ "total"
23
+ ],
24
+ "type": "object"
25
+ },
26
+ "TokenUsageBreakdown": {
27
+ "properties": {
28
+ "cacheWriteInputTokens": {
29
+ "default": 0,
30
+ "format": "int64",
31
+ "type": "integer"
32
+ },
33
+ "cachedInputTokens": {
34
+ "format": "int64",
35
+ "type": "integer"
36
+ },
37
+ "inputTokens": {
38
+ "format": "int64",
39
+ "type": "integer"
40
+ },
41
+ "outputTokens": {
42
+ "format": "int64",
43
+ "type": "integer"
44
+ },
45
+ "reasoningOutputTokens": {
46
+ "format": "int64",
47
+ "type": "integer"
48
+ },
49
+ "totalTokens": {
50
+ "format": "int64",
51
+ "type": "integer"
52
+ }
53
+ },
54
+ "required": [
55
+ "cachedInputTokens",
56
+ "inputTokens",
57
+ "outputTokens",
58
+ "reasoningOutputTokens",
59
+ "totalTokens"
60
+ ],
61
+ "type": "object"
62
+ }
63
+ },
64
+ "properties": {
65
+ "threadId": {
66
+ "type": "string"
67
+ },
68
+ "tokenUsage": {
69
+ "$ref": "#/definitions/ThreadTokenUsage"
70
+ },
71
+ "turnId": {
72
+ "type": "string"
73
+ }
74
+ },
75
+ "required": [
76
+ "threadId",
77
+ "tokenUsage",
78
+ "turnId"
79
+ ],
80
+ "title": "ThreadTokenUsageUpdatedNotification",
81
+ "type": "object"
82
+ }
@@ -0,0 +1,17 @@
1
+ {
2
+ "$schema": "http://json-schema.org/draft-07/schema#",
3
+ "properties": {
4
+ "threadId": {
5
+ "type": "string"
6
+ },
7
+ "turnId": {
8
+ "type": "string"
9
+ }
10
+ },
11
+ "required": [
12
+ "threadId",
13
+ "turnId"
14
+ ],
15
+ "title": "TurnInterruptParams",
16
+ "type": "object"
17
+ }
@@ -0,0 +1,5 @@
1
+ // GENERATED CODE! DO NOT MODIFY BY HAND!
2
+
3
+ // This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
4
+
5
+ export type AskForApproval = "untrusted" | "on-request" | { "granular": { sandbox_approval: boolean, rules: boolean, skill_approval: boolean, request_permissions: boolean, mcp_elicitations: boolean, } } | "never";
@@ -0,0 +1,5 @@
1
+ // GENERATED CODE! DO NOT MODIFY BY HAND!
2
+
3
+ // This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
4
+
5
+ export type ClientNotification = { "method": "initialized" };
@@ -0,0 +1,5 @@
1
+ // GENERATED CODE! DO NOT MODIFY BY HAND!
2
+
3
+ // This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
4
+
5
+ export type SandboxMode = "read-only" | "workspace-write" | "danger-full-access";
@@ -0,0 +1,9 @@
1
+ // GENERATED CODE! DO NOT MODIFY BY HAND!
2
+
3
+ // This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
4
+
5
+ export type ThreadReadParams = { threadId: string,
6
+ /**
7
+ * When true, include turns and their items from rollout history.
8
+ */
9
+ includeTurns?: boolean, };
@@ -0,0 +1,5 @@
1
+ // GENERATED CODE! DO NOT MODIFY BY HAND!
2
+
3
+ // This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
4
+
5
+ export type TokenUsageBreakdown = { totalTokens: number, inputTokens: number, cachedInputTokens: number, cacheWriteInputTokens: number, outputTokens: number, reasoningOutputTokens: number, };
@@ -0,0 +1,5 @@
1
+ // GENERATED CODE! DO NOT MODIFY BY HAND!
2
+
3
+ // This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
4
+
5
+ export type TurnInterruptParams = { threadId: string, turnId: string, };
@@ -0,0 +1,27 @@
1
+ {
2
+ "schemaVersion": "ebo.codex-app-server-contract/v1",
3
+ "codexCliVersion": "0.153.4",
4
+ "generation": {
5
+ "typescript": "codex app-server generate-ts --experimental --out <temporary-directory>",
6
+ "jsonSchema": "codex app-server generate-json-schema --experimental --out <temporary-directory>"
7
+ },
8
+ "generatedRoots": {
9
+ "typescriptIndexSha256": "961025fd206a86242769a08b9ca582712fef947dff7a1a0d8e140355d2785a77",
10
+ "v2SchemaBundleSha256": "e5f798fd1343c539f01fedea0e8a84a43c080fcca4615c80eb04a5edab4f7d0a"
11
+ },
12
+ "files": {
13
+ "schema/v1/InitializeParams.json": "6f0094be9a65242ec779a40794cbd4fdfa32fca1e45084a16adfb50501d33ea2",
14
+ "schema/JSONRPCMessage.json": "6da4cc373a7ccd01f5608ad4496eeb4d44b6a9b0d3158e85ed66b59f3c0b5114",
15
+ "schema/v2/ThreadReadParams.json": "dfe040c6ac71d30795b8be3f3ff232e66f362a37f883b491e5d1ea367f470db4",
16
+ "schema/v2/ThreadTokenUsageUpdatedNotification.json": "aba4f6c7e4a19b2b842c08ee793b57000c07dafd57b922ad0d8e7c76609108c2",
17
+ "schema/v2/TurnInterruptParams.json": "6dff382dae73d1dbc58406ed045605f647e7a49660e2540fbd2c6c24d60c5f2b",
18
+ "schema/v2/ThreadStartParams.json": "25f490368ec6df52a2a3b82a5469d2413307eb93439121b309f415b5648eee7a",
19
+ "schema/v2/TurnStartParams.json": "b36fb37326b1cf69f75c8b306f1f886d53a57c4b1b985e08e298e2407ea2ad02",
20
+ "types/AskForApproval.ts": "81dd17defd9a7fd4785346d3ce54c14243353b43174c7417827210cbd3ef3c52",
21
+ "types/ClientNotification.ts": "96692c191ff9ac32c2688b46a0a04f23d15646937adc352f2adcc8211c6d17a0",
22
+ "types/SandboxMode.ts": "8a59381e04efa84f9001e5c24444ee26fccf8f9e10bcfb02d2f6a24e85898843",
23
+ "types/ThreadReadParams.ts": "c24743cb5655b4c71a853a2a290412d78e1a27e0278f2a0cde9bd9d9b78118a8",
24
+ "types/TokenUsageBreakdown.ts": "e983f21175fdfdf1a239e26cd8916e1cb765bc0cb7904e2bd9cc83ffe325c8a7",
25
+ "types/TurnInterruptParams.ts": "643034c3d25c23c7700236d4d1ff16286565786d48148e85b0c4761fe46d3804"
26
+ }
27
+ }
@@ -0,0 +1,137 @@
1
+ {
2
+ "$schema": "http://json-schema.org/draft-07/schema#",
3
+ "anyOf": [
4
+ {
5
+ "$ref": "#/definitions/JSONRPCRequest"
6
+ },
7
+ {
8
+ "$ref": "#/definitions/JSONRPCNotification"
9
+ },
10
+ {
11
+ "$ref": "#/definitions/JSONRPCResponse"
12
+ },
13
+ {
14
+ "$ref": "#/definitions/JSONRPCError"
15
+ }
16
+ ],
17
+ "definitions": {
18
+ "JSONRPCError": {
19
+ "description": "A response to a request that indicates an error occurred.",
20
+ "properties": {
21
+ "error": {
22
+ "$ref": "#/definitions/JSONRPCErrorError"
23
+ },
24
+ "id": {
25
+ "$ref": "#/definitions/RequestId"
26
+ }
27
+ },
28
+ "required": [
29
+ "error",
30
+ "id"
31
+ ],
32
+ "type": "object"
33
+ },
34
+ "JSONRPCErrorError": {
35
+ "properties": {
36
+ "code": {
37
+ "format": "int64",
38
+ "type": "integer"
39
+ },
40
+ "data": true,
41
+ "message": {
42
+ "type": "string"
43
+ }
44
+ },
45
+ "required": [
46
+ "code",
47
+ "message"
48
+ ],
49
+ "type": "object"
50
+ },
51
+ "JSONRPCNotification": {
52
+ "description": "A notification which does not expect a response.",
53
+ "properties": {
54
+ "method": {
55
+ "type": "string"
56
+ },
57
+ "params": true
58
+ },
59
+ "required": [
60
+ "method"
61
+ ],
62
+ "type": "object"
63
+ },
64
+ "JSONRPCRequest": {
65
+ "description": "A request that expects a response.",
66
+ "properties": {
67
+ "id": {
68
+ "$ref": "#/definitions/RequestId"
69
+ },
70
+ "method": {
71
+ "type": "string"
72
+ },
73
+ "params": true,
74
+ "trace": {
75
+ "anyOf": [
76
+ {
77
+ "$ref": "#/definitions/W3cTraceContext"
78
+ },
79
+ {
80
+ "type": "null"
81
+ }
82
+ ],
83
+ "description": "Optional W3C Trace Context for distributed tracing."
84
+ }
85
+ },
86
+ "required": [
87
+ "id",
88
+ "method"
89
+ ],
90
+ "type": "object"
91
+ },
92
+ "JSONRPCResponse": {
93
+ "description": "A successful (non-error) response to a request.",
94
+ "properties": {
95
+ "id": {
96
+ "$ref": "#/definitions/RequestId"
97
+ },
98
+ "result": true
99
+ },
100
+ "required": [
101
+ "id",
102
+ "result"
103
+ ],
104
+ "type": "object"
105
+ },
106
+ "RequestId": {
107
+ "anyOf": [
108
+ {
109
+ "type": "string"
110
+ },
111
+ {
112
+ "format": "int64",
113
+ "type": "integer"
114
+ }
115
+ ]
116
+ },
117
+ "W3cTraceContext": {
118
+ "properties": {
119
+ "traceparent": {
120
+ "type": [
121
+ "string",
122
+ "null"
123
+ ]
124
+ },
125
+ "tracestate": {
126
+ "type": [
127
+ "string",
128
+ "null"
129
+ ]
130
+ }
131
+ },
132
+ "type": "object"
133
+ }
134
+ },
135
+ "description": "Refers to any valid JSON-RPC object that can be decoded off the wire, or encoded to be sent.",
136
+ "title": "JSONRPCMessage"
137
+ }
@@ -0,0 +1,84 @@
1
+ {
2
+ "$schema": "http://json-schema.org/draft-07/schema#",
3
+ "definitions": {
4
+ "ClientInfo": {
5
+ "properties": {
6
+ "name": {
7
+ "type": "string"
8
+ },
9
+ "title": {
10
+ "type": [
11
+ "string",
12
+ "null"
13
+ ]
14
+ },
15
+ "version": {
16
+ "type": "string"
17
+ }
18
+ },
19
+ "required": [
20
+ "name",
21
+ "version"
22
+ ],
23
+ "type": "object"
24
+ },
25
+ "InitializeCapabilities": {
26
+ "description": "Client-declared capabilities negotiated during initialize.",
27
+ "properties": {
28
+ "experimentalApi": {
29
+ "default": false,
30
+ "description": "Opt into receiving experimental API methods and fields.",
31
+ "type": "boolean"
32
+ },
33
+ "extensions": {
34
+ "additionalProperties": true,
35
+ "description": "MCP extension settings declared by the app-server client.",
36
+ "type": [
37
+ "object",
38
+ "null"
39
+ ]
40
+ },
41
+ "mcpServerOpenaiFormElicitation": {
42
+ "description": "Legacy opt-in for the `openai/form` MCP extension.\n\nNew clients should declare `openai/form` in [`Self::extensions`].",
43
+ "type": "boolean"
44
+ },
45
+ "optOutNotificationMethods": {
46
+ "description": "Exact notification method names that should be suppressed for this connection (for example `thread/started`).",
47
+ "items": {
48
+ "type": "string"
49
+ },
50
+ "type": [
51
+ "array",
52
+ "null"
53
+ ]
54
+ },
55
+ "requestAttestation": {
56
+ "default": false,
57
+ "description": "Opt into `attestation/generate` requests for upstream `x-oai-attestation`.",
58
+ "type": "boolean"
59
+ }
60
+ },
61
+ "type": "object"
62
+ }
63
+ },
64
+ "properties": {
65
+ "capabilities": {
66
+ "anyOf": [
67
+ {
68
+ "$ref": "#/definitions/InitializeCapabilities"
69
+ },
70
+ {
71
+ "type": "null"
72
+ }
73
+ ]
74
+ },
75
+ "clientInfo": {
76
+ "$ref": "#/definitions/ClientInfo"
77
+ }
78
+ },
79
+ "required": [
80
+ "clientInfo"
81
+ ],
82
+ "title": "InitializeParams",
83
+ "type": "object"
84
+ }
@@ -0,0 +1,17 @@
1
+ {
2
+ "$schema": "http://json-schema.org/draft-07/schema#",
3
+ "properties": {
4
+ "includeTurns": {
5
+ "description": "When true, include turns and their items from rollout history. Full-history hydration is deprecated for paginated threads; prefer a metadata-only read and page with `thread/turns/list` and `thread/items/list`.",
6
+ "type": "boolean"
7
+ },
8
+ "threadId": {
9
+ "type": "string"
10
+ }
11
+ },
12
+ "required": [
13
+ "threadId"
14
+ ],
15
+ "title": "ThreadReadParams",
16
+ "type": "object"
17
+ }