@ktkid/kmh-codex-cli 0.0.0-stage → 0.1.2

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 (89) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +296 -2
  3. package/bin/README.md +25 -0
  4. package/bin/codex +36 -0
  5. package/bin/runtime-receipt.json +9 -0
  6. package/bin/version +1 -0
  7. package/cordis.patch.yml +7 -0
  8. package/lib/browser-types/src/account-status.d.ts +9 -0
  9. package/lib/browser-types/src/client/ComposerQuota.d.ts +10 -0
  10. package/lib/browser-types/src/client/DetailCard.d.ts +12 -0
  11. package/lib/browser-types/src/client/LiveBall.d.ts +19 -0
  12. package/lib/browser-types/src/client/QuotaCard.d.ts +20 -0
  13. package/lib/browser-types/src/client/QuotaDisplaySettings.d.ts +6 -0
  14. package/lib/browser-types/src/client/index.d.ts +18 -0
  15. package/lib/browser-types/src/client/locales.d.ts +54 -0
  16. package/lib/browser-types/src/client/quota-store.d.ts +56 -0
  17. package/lib/browser-types/src/live-state.d.ts +31 -0
  18. package/lib/browser-types/src/quota-protocol.d.ts +135 -0
  19. package/lib/browser-types/src/quota-rules.d.ts +18 -0
  20. package/lib/browser-types/src/tool-switches.d.ts +63 -0
  21. package/lib/client.js +16193 -0
  22. package/lib/src/account-status.d.ts +9 -0
  23. package/lib/src/account-status.js +1 -0
  24. package/lib/src/account.d.ts +35 -0
  25. package/lib/src/account.js +173 -0
  26. package/lib/src/adapter.d.ts +22 -0
  27. package/lib/src/adapter.js +222 -0
  28. package/lib/src/approval.d.ts +48 -0
  29. package/lib/src/approval.js +235 -0
  30. package/lib/src/capabilities.d.ts +40 -0
  31. package/lib/src/capabilities.js +85 -0
  32. package/lib/src/config.d.ts +69 -0
  33. package/lib/src/config.js +75 -0
  34. package/lib/src/connection.d.ts +65 -0
  35. package/lib/src/connection.js +178 -0
  36. package/lib/src/cursor.d.ts +61 -0
  37. package/lib/src/cursor.js +339 -0
  38. package/lib/src/image-delivery.d.ts +36 -0
  39. package/lib/src/image-delivery.js +65 -0
  40. package/lib/src/imagegen.d.ts +21 -0
  41. package/lib/src/imagegen.js +132 -0
  42. package/lib/src/index.d.ts +146 -0
  43. package/lib/src/index.js +551 -0
  44. package/lib/src/isolation.d.ts +61 -0
  45. package/lib/src/isolation.js +298 -0
  46. package/lib/src/live-state.d.ts +31 -0
  47. package/lib/src/live-state.js +14 -0
  48. package/lib/src/models.d.ts +24 -0
  49. package/lib/src/models.js +98 -0
  50. package/lib/src/native-items.d.ts +59 -0
  51. package/lib/src/native-items.js +122 -0
  52. package/lib/src/native-tools/catalog.d.ts +29 -0
  53. package/lib/src/native-tools/catalog.js +197 -0
  54. package/lib/src/probe.d.ts +17 -0
  55. package/lib/src/probe.js +54 -0
  56. package/lib/src/protocol.d.ts +508 -0
  57. package/lib/src/protocol.js +511 -0
  58. package/lib/src/quota-protocol.d.ts +135 -0
  59. package/lib/src/quota-protocol.js +97 -0
  60. package/lib/src/quota-rules.d.ts +18 -0
  61. package/lib/src/quota-rules.js +49 -0
  62. package/lib/src/quota.d.ts +32 -0
  63. package/lib/src/quota.js +227 -0
  64. package/lib/src/session-history.d.ts +18 -0
  65. package/lib/src/session-history.js +113 -0
  66. package/lib/src/session-store.d.ts +592 -0
  67. package/lib/src/session-store.js +275 -0
  68. package/lib/src/status.d.ts +19 -0
  69. package/lib/src/status.js +69 -0
  70. package/lib/src/tool-policy.d.ts +47 -0
  71. package/lib/src/tool-policy.js +454 -0
  72. package/lib/src/tool-registry.d.ts +42 -0
  73. package/lib/src/tool-registry.js +70 -0
  74. package/lib/src/tool-selection.d.ts +88 -0
  75. package/lib/src/tool-selection.js +60 -0
  76. package/lib/src/tool-switches-service.d.ts +24 -0
  77. package/lib/src/tool-switches-service.js +129 -0
  78. package/lib/src/tool-switches.d.ts +63 -0
  79. package/lib/src/tool-switches.js +43 -0
  80. package/lib/src/turn.d.ts +200 -0
  81. package/lib/src/turn.js +1012 -0
  82. package/lib/src/web.d.ts +9 -0
  83. package/lib/src/web.js +143 -0
  84. package/package.json +172 -4
  85. package/vendor/codex/LICENSE +201 -0
  86. package/vendor/codex/NOTICE +4 -0
  87. package/vendor/codex/models.json +1613 -0
  88. package/vendor/native-tools/0.162.0-alpha.17.2.json +143 -0
  89. package/vendor/native-tools/0.163.0-alpha.10.2.json +128 -0
@@ -0,0 +1,508 @@
1
+ /** Codex app-server 行协议的帧编码与 v2 方法、通知的输入输出类型。 */
2
+ import { z } from "zod";
3
+ import { Writable, type WritableOptions } from "node:stream";
4
+ /**
5
+ * 官方 CLI 行协议不携带 `jsonrpc` 字段:发送方向经本 bridge 剥除后再写出。
6
+ * @param output - 进程标准输入流。
7
+ * @param options - 透传的 Writable 构造参数。
8
+ * @returns 写入端接 JsonRpcLineTransport 的桥接流。
9
+ */
10
+ export declare function createFrameBridge(output: Writable, options?: WritableOptions): Writable;
11
+ /** 从 unknown 对象安全取一个字段;无该字段或非对象时返回 undefined。 */
12
+ export declare function fieldOf(value: unknown, key: string): unknown;
13
+ /** 浅拷贝 unknown 对象为可写字段表;非对象时抛错。 */
14
+ export declare function shallowCopy(value: unknown, code: string): Record<string, unknown>;
15
+ /** 方法名常量:集中一处,避免字符串散落。 */
16
+ export declare const Method: {
17
+ readonly initialize: "initialize";
18
+ readonly modelList: "model/list";
19
+ readonly threadStart: "thread/start";
20
+ readonly threadResume: "thread/resume";
21
+ readonly turnStart: "turn/start";
22
+ readonly turnInterrupt: "turn/interrupt";
23
+ readonly accountLoginStart: "account/login/start";
24
+ readonly accountLoginCancel: "account/login/cancel";
25
+ readonly accountLogout: "account/logout";
26
+ readonly accountStatus: "account/status";
27
+ readonly accountRead: "account/read";
28
+ readonly accountRateLimitsRead: "account/rateLimits/read";
29
+ };
30
+ /** 官方 0.162 v2 生成协议的本功能消费字段;分区校验使合法周期独立保留。 */
31
+ export declare const QuotaAccountResult: z.ZodObject<{
32
+ account: z.ZodNullable<z.ZodDiscriminatedUnion<[z.ZodObject<{
33
+ type: z.ZodLiteral<"chatgpt">;
34
+ email: z.ZodNullable<z.ZodString>;
35
+ planType: z.ZodString;
36
+ }, z.core.$strip>, z.ZodObject<{
37
+ type: z.ZodLiteral<"apiKey">;
38
+ }, z.core.$strip>, z.ZodObject<{
39
+ type: z.ZodLiteral<"amazonBedrock">;
40
+ usesCodexManagedCredentials: z.ZodBoolean;
41
+ }, z.core.$strip>], "type">>;
42
+ }, z.core.$strip>;
43
+ export declare const NativeQuotaWindow: z.ZodObject<{
44
+ usedPercent: z.ZodNumber;
45
+ windowDurationMins: z.ZodNullable<z.ZodNumber>;
46
+ resetsAt: z.ZodNullable<z.ZodNumber>;
47
+ }, z.core.$strip>;
48
+ export declare const NativeCredits: z.ZodObject<{
49
+ hasCredits: z.ZodBoolean;
50
+ unlimited: z.ZodBoolean;
51
+ balance: z.ZodNullable<z.ZodString>;
52
+ }, z.core.$strip>;
53
+ export declare const NativeSpendLimit: z.ZodObject<{
54
+ limit: z.ZodString;
55
+ used: z.ZodString;
56
+ remainingPercent: z.ZodNumber;
57
+ resetsAt: z.ZodNumber;
58
+ }, z.core.$strip>;
59
+ export declare const NativeResetCredits: z.ZodObject<{
60
+ availableCount: z.ZodNumber;
61
+ credits: z.ZodNullable<z.ZodArray<z.ZodObject<{
62
+ id: z.ZodString;
63
+ title: z.ZodNullable<z.ZodString>;
64
+ description: z.ZodNullable<z.ZodString>;
65
+ resetType: z.ZodString;
66
+ status: z.ZodString;
67
+ grantedAt: z.ZodNumber;
68
+ expiresAt: z.ZodNullable<z.ZodNumber>;
69
+ }, z.core.$strip>>>;
70
+ }, z.core.$strip>;
71
+ export declare const NativeQuotaSnapshot: z.ZodObject<{
72
+ limitId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
73
+ limitName: z.ZodOptional<z.ZodNullable<z.ZodString>>;
74
+ primary: z.ZodOptional<z.ZodUnknown>;
75
+ secondary: z.ZodOptional<z.ZodUnknown>;
76
+ credits: z.ZodOptional<z.ZodUnknown>;
77
+ individualLimit: z.ZodOptional<z.ZodUnknown>;
78
+ }, z.core.$strip>;
79
+ export declare const NativeQuotaResult: z.ZodObject<{
80
+ rateLimits: z.ZodUnknown;
81
+ rateLimitsByLimitId: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
82
+ rateLimitResetCredits: z.ZodOptional<z.ZodUnknown>;
83
+ accountId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
84
+ }, z.core.$strip>;
85
+ /** 服务端请求与通知的方法名。 */
86
+ export declare const Incoming: {
87
+ readonly itemToolCall: "item/tool/call";
88
+ readonly itemDynamicToolCall: "item/dynamicTool/call";
89
+ readonly itemCommandExecutionRequestApproval: "item/commandExecution/requestApproval";
90
+ readonly itemFileChangeRequestApproval: "item/fileChange/requestApproval";
91
+ readonly itemPermissionsRequestApproval: "item/permissions/requestApproval";
92
+ readonly itemToolRequestUserInput: "item/tool/requestUserInput";
93
+ readonly mcpServerElicitationRequest: "mcpServer/elicitation/request";
94
+ readonly turnStarted: "turn/started";
95
+ readonly turnCompleted: "turn/completed";
96
+ readonly itemStarted: "item/started";
97
+ readonly itemCompleted: "item/completed";
98
+ readonly commandExecutionOutputDelta: "item/commandExecution/outputDelta";
99
+ readonly mcpToolCallProgress: "item/mcpToolCall/progress";
100
+ readonly turnDiffUpdated: "turn/diff/updated";
101
+ readonly agentMessageDelta: "item/agentMessage/delta";
102
+ readonly reasoningTextDelta: "item/reasoning/textDelta";
103
+ readonly reasoningSummaryTextDelta: "item/reasoning/summaryTextDelta";
104
+ readonly threadCompacted: "thread/compacted";
105
+ readonly tokenUsageUpdated: "thread/tokenUsage/updated";
106
+ readonly accountUpdated: "account/updated";
107
+ readonly accountLoginCompleted: "account/login/completed";
108
+ readonly error: "error";
109
+ };
110
+ /** initialize 请求参数。 */
111
+ export declare const InitializeParams: z.ZodObject<{
112
+ clientInfo: z.ZodObject<{
113
+ name: z.ZodString;
114
+ title: z.ZodString;
115
+ version: z.ZodString;
116
+ }, z.core.$strip>;
117
+ capabilities: z.ZodObject<{
118
+ experimentalApi: z.ZodBoolean;
119
+ }, z.core.$loose>;
120
+ }, z.core.$strip>;
121
+ /** initialize 响应。 */
122
+ export declare const InitializeResult: z.ZodObject<{
123
+ userAgent: z.ZodOptional<z.ZodString>;
124
+ permissions: z.ZodOptional<z.ZodUnknown>;
125
+ }, z.core.$loose>;
126
+ /** model/list 请求参数。 */
127
+ export declare const ModelListParams: z.ZodObject<{
128
+ includeHidden: z.ZodBoolean;
129
+ }, z.core.$strip>;
130
+ /** 模型目录条目(字段按 0.160.0 验证实测收敛,未知字段容忍)。 */
131
+ export declare const ModelEntry: z.ZodObject<{
132
+ id: z.ZodString;
133
+ displayName: z.ZodOptional<z.ZodString>;
134
+ inputModalities: z.ZodCatch<z.ZodOptional<z.ZodArray<z.ZodString>>>;
135
+ supportedReasoningEfforts: z.ZodOptional<z.ZodArray<z.ZodUnknown>>;
136
+ defaultReasoningEffort: z.ZodOptional<z.ZodString>;
137
+ supportsReasoningSummaries: z.ZodOptional<z.ZodBoolean>;
138
+ }, z.core.$loose>;
139
+ /** model/list 响应。 */
140
+ export declare const ModelListResult: z.ZodObject<{
141
+ data: z.ZodArray<z.ZodObject<{
142
+ id: z.ZodString;
143
+ displayName: z.ZodOptional<z.ZodString>;
144
+ inputModalities: z.ZodCatch<z.ZodOptional<z.ZodArray<z.ZodString>>>;
145
+ supportedReasoningEfforts: z.ZodOptional<z.ZodArray<z.ZodUnknown>>;
146
+ defaultReasoningEffort: z.ZodOptional<z.ZodString>;
147
+ supportsReasoningSummaries: z.ZodOptional<z.ZodBoolean>;
148
+ }, z.core.$loose>>;
149
+ nextPageCursor: z.ZodOptional<z.ZodString>;
150
+ }, z.core.$strip>;
151
+ /** thread/start 的动态工具声明(单函数形态)。 */
152
+ export declare const DynamicToolSpec: z.ZodObject<{
153
+ name: z.ZodString;
154
+ description: z.ZodString;
155
+ inputSchema: z.ZodRecord<z.ZodString, z.ZodUnknown>;
156
+ deferLoading: z.ZodOptional<z.ZodBoolean>;
157
+ }, z.core.$strip>;
158
+ /** KMH 工具的稳定挂载命名空间:thread 重建前后形态不变。 */
159
+ export declare const KMH_TOOL_NAMESPACE = "kmh";
160
+ /** namespace 形态的动态工具声明。 */
161
+ export declare const DynamicNamespaceSpec: z.ZodObject<{
162
+ type: z.ZodLiteral<"namespace">;
163
+ name: z.ZodLiteral<"kmh">;
164
+ description: z.ZodString;
165
+ tools: z.ZodArray<z.ZodObject<{
166
+ name: z.ZodString;
167
+ description: z.ZodString;
168
+ inputSchema: z.ZodRecord<z.ZodString, z.ZodUnknown>;
169
+ deferLoading: z.ZodOptional<z.ZodBoolean>;
170
+ }, z.core.$strip>>;
171
+ }, z.core.$strip>;
172
+ /** thread/start 请求参数。 */
173
+ export declare const ThreadStartParams: z.ZodObject<{
174
+ experimentalRawEvents: z.ZodOptional<z.ZodBoolean>;
175
+ model: z.ZodOptional<z.ZodString>;
176
+ ephemeral: z.ZodOptional<z.ZodBoolean>;
177
+ cwd: z.ZodOptional<z.ZodString>;
178
+ baseInstructions: z.ZodOptional<z.ZodString>;
179
+ developerInstructions: z.ZodOptional<z.ZodString>;
180
+ dynamicTools: z.ZodOptional<z.ZodArray<z.ZodObject<{
181
+ name: z.ZodString;
182
+ description: z.ZodString;
183
+ inputSchema: z.ZodRecord<z.ZodString, z.ZodUnknown>;
184
+ deferLoading: z.ZodOptional<z.ZodBoolean>;
185
+ }, z.core.$strip>>>;
186
+ }, z.core.$strip>;
187
+ /** thread/start 与 thread/resume 的响应。 */
188
+ export declare const ThreadResult: z.ZodType<{
189
+ thread: {
190
+ id: string;
191
+ };
192
+ }>;
193
+ /** turn/start 的用户输入。 */
194
+ export declare const UserTextInput: z.ZodObject<{
195
+ type: z.ZodLiteral<"text">;
196
+ text: z.ZodString;
197
+ }, z.core.$strip>;
198
+ export declare const UserInput: z.ZodDiscriminatedUnion<[z.ZodObject<{
199
+ type: z.ZodLiteral<"text">;
200
+ text: z.ZodString;
201
+ }, z.core.$strip>, z.ZodObject<{
202
+ type: z.ZodLiteral<"image">;
203
+ url: z.ZodString;
204
+ }, z.core.$strip>], "type">;
205
+ /** turn/start 请求参数。 */
206
+ export declare const TurnStartParams: z.ZodObject<{
207
+ threadId: z.ZodString;
208
+ input: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
209
+ type: z.ZodLiteral<"text">;
210
+ text: z.ZodString;
211
+ }, z.core.$strip>, z.ZodObject<{
212
+ type: z.ZodLiteral<"image">;
213
+ url: z.ZodString;
214
+ }, z.core.$strip>], "type">>;
215
+ model: z.ZodOptional<z.ZodString>;
216
+ effort: z.ZodOptional<z.ZodString>;
217
+ summary: z.ZodOptional<z.ZodEnum<{
218
+ auto: "auto";
219
+ concise: "concise";
220
+ detailed: "detailed";
221
+ none: "none";
222
+ }>>;
223
+ }, z.core.$strip>;
224
+ /** turn/start 响应。 */
225
+ export declare const TurnResult: z.ZodType<{
226
+ turn: {
227
+ id: string;
228
+ };
229
+ }>;
230
+ /** turn/steer 在指定的活跃回合中接纳追加输入。 */
231
+ export declare const TurnSteerParams: z.ZodObject<{
232
+ threadId: z.ZodString;
233
+ expectedTurnId: z.ZodString;
234
+ input: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
235
+ type: z.ZodLiteral<"text">;
236
+ text: z.ZodString;
237
+ }, z.core.$strip>, z.ZodObject<{
238
+ type: z.ZodLiteral<"image">;
239
+ url: z.ZodString;
240
+ }, z.core.$strip>], "type">>;
241
+ }, z.core.$strip>;
242
+ export declare const TurnSteerResult: z.ZodObject<{
243
+ turnId: z.ZodString;
244
+ }, z.core.$strip>;
245
+ /** turn/interrupt 请求参数。 */
246
+ export declare const TurnInterruptParams: z.ZodObject<{
247
+ threadId: z.ZodString;
248
+ turnId: z.ZodString;
249
+ }, z.core.$strip>;
250
+ /** item/tool/call 服务端请求参数(动态工具执行请求)。 */
251
+ export declare const DynamicToolCallParams: z.ZodObject<{
252
+ threadId: z.ZodString;
253
+ turnId: z.ZodString;
254
+ callId: z.ZodString;
255
+ namespace: z.ZodOptional<z.ZodNullable<z.ZodString>>;
256
+ tool: z.ZodString;
257
+ arguments: z.ZodUnknown;
258
+ }, z.core.$strip>;
259
+ /** item/tool/call 的回执内容项。 */
260
+ export declare const ToolCallContentItem: z.ZodDiscriminatedUnion<[z.ZodObject<{
261
+ type: z.ZodLiteral<"inputText">;
262
+ text: z.ZodString;
263
+ }, z.core.$strip>, z.ZodObject<{
264
+ type: z.ZodLiteral<"inputImage">;
265
+ imageUrl: z.ZodString;
266
+ }, z.core.$strip>], "type">;
267
+ /** item/tool/call 回执。 */
268
+ export declare const DynamicToolCallResponse: z.ZodObject<{
269
+ success: z.ZodBoolean;
270
+ contentItems: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
271
+ type: z.ZodLiteral<"inputText">;
272
+ text: z.ZodString;
273
+ }, z.core.$strip>, z.ZodObject<{
274
+ type: z.ZodLiteral<"inputImage">;
275
+ imageUrl: z.ZodString;
276
+ }, z.core.$strip>], "type">>;
277
+ }, z.core.$strip>;
278
+ /** turn/completed 通知参数。 */
279
+ export declare const TurnCompletedParams: z.ZodObject<{
280
+ threadId: z.ZodString;
281
+ turn: z.ZodObject<{
282
+ id: z.ZodString;
283
+ status: z.ZodString;
284
+ }, z.core.$loose>;
285
+ }, z.core.$strip>;
286
+ /** item/agentMessage/delta 通知参数。 */
287
+ export declare const AgentMessageDeltaParams: z.ZodObject<{
288
+ threadId: z.ZodString;
289
+ itemId: z.ZodString;
290
+ delta: z.ZodString;
291
+ }, z.core.$loose>;
292
+ /** item/reasoning/textDelta 通知参数。 */
293
+ export declare const ReasoningDeltaParams: z.ZodObject<{
294
+ threadId: z.ZodString;
295
+ itemId: z.ZodString;
296
+ delta: z.ZodString;
297
+ }, z.core.$loose>;
298
+ /** item/completed 的生图项(app-server ThreadItem::ImageGeneration 的 wire 形态)。 */
299
+ export declare const ImageGenerationItemParams: z.ZodObject<{
300
+ type: z.ZodLiteral<"imageGeneration">;
301
+ id: z.ZodString;
302
+ status: z.ZodString;
303
+ revisedPrompt: z.ZodOptional<z.ZodNullable<z.ZodString>>;
304
+ savedPath: z.ZodOptional<z.ZodString>;
305
+ }, z.core.$loose>;
306
+ /** 生图项的可投影产物:项 id、落盘路径与展示名。 */
307
+ export interface ImageProjection {
308
+ id: string;
309
+ path: string;
310
+ name: string | undefined;
311
+ }
312
+ /**
313
+ * 从 item/completed 的生图项提取可投影产物。
314
+ * @param item - ThreadItem::ImageGeneration 的原始对象。
315
+ * @returns 已完成且已落盘时返回 id、路径与展示名;否则 undefined(不构成错误)。
316
+ */
317
+ export declare function imageProjectionOf(item: unknown): ImageProjection | undefined;
318
+ /** app-server ThreadItem::Reasoning 的可见文本;摘要与原始内容均为字符串数组。 */
319
+ export declare const ReasoningItemContent: z.ZodObject<{
320
+ summary: z.ZodDefault<z.ZodArray<z.ZodString>>;
321
+ content: z.ZodDefault<z.ZodArray<z.ZodString>>;
322
+ }, z.core.$strip>;
323
+ /**
324
+ * 从 app-server 完成项提取摘要,摘要为空时读取原始内容。
325
+ * @param item - item/completed 的 reasoning 对象。
326
+ * @returns 非空文本;两个数组皆空时返回 undefined。
327
+ * @throws ZodError 文本数组包含非法元素。
328
+ */
329
+ export declare function reasoningItemText(item: unknown): string | undefined;
330
+ /** item/started、item/completed 通知参数:item 形态留由消费方判别。 */
331
+ export declare const ItemEventParams: z.ZodObject<{
332
+ threadId: z.ZodString;
333
+ turnId: z.ZodOptional<z.ZodString>;
334
+ item: z.ZodUnknown;
335
+ }, z.core.$loose>;
336
+ /** item/commandExecution/outputDelta 通知参数(feat08)。 */
337
+ export declare const CommandExecutionOutputDeltaParams: z.ZodObject<{
338
+ threadId: z.ZodString;
339
+ turnId: z.ZodString;
340
+ itemId: z.ZodString;
341
+ delta: z.ZodString;
342
+ }, z.core.$strip>;
343
+ /** item/mcpToolCall/progress 通知参数。 */
344
+ export declare const McpToolCallProgressParams: z.ZodObject<{
345
+ threadId: z.ZodString;
346
+ turnId: z.ZodString;
347
+ itemId: z.ZodString;
348
+ message: z.ZodString;
349
+ }, z.core.$strip>;
350
+ /** turn/diff/updated 通知参数。 */
351
+ export declare const TurnDiffUpdatedParams: z.ZodObject<{
352
+ threadId: z.ZodString;
353
+ turnId: z.ZodString;
354
+ diff: z.ZodString;
355
+ }, z.core.$strip>;
356
+ /** item/commandExecution/requestApproval 请求参数(0.160.0 生成 schema 收敛)。 */
357
+ export declare const CommandExecutionRequestApprovalParams: z.ZodObject<{
358
+ startedAtMs: z.ZodNumber;
359
+ kind: z.ZodOptional<z.ZodString>;
360
+ approvalId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
361
+ reason: z.ZodOptional<z.ZodNullable<z.ZodString>>;
362
+ command: z.ZodOptional<z.ZodNullable<z.ZodString>>;
363
+ cwd: z.ZodOptional<z.ZodNullable<z.ZodString>>;
364
+ threadId: z.ZodString;
365
+ turnId: z.ZodString;
366
+ itemId: z.ZodString;
367
+ }, z.core.$loose>;
368
+ /** 桥发出的命令审批决定值(枚举全集见 decisions D18,桥只发三种)。 */
369
+ export declare const CommandExecutionRequestApprovalResponse: z.ZodObject<{
370
+ decision: z.ZodEnum<{
371
+ accept: "accept";
372
+ acceptForSession: "acceptForSession";
373
+ decline: "decline";
374
+ cancel: "cancel";
375
+ }>;
376
+ }, z.core.$strip>;
377
+ /** item/fileChange/requestApproval 请求参数。 */
378
+ export declare const FileChangeRequestApprovalParams: z.ZodObject<{
379
+ startedAtMs: z.ZodNumber;
380
+ reason: z.ZodOptional<z.ZodNullable<z.ZodString>>;
381
+ grantRoot: z.ZodOptional<z.ZodNullable<z.ZodString>>;
382
+ threadId: z.ZodString;
383
+ turnId: z.ZodString;
384
+ itemId: z.ZodString;
385
+ }, z.core.$loose>;
386
+ export declare const FileChangeRequestApprovalResponse: z.ZodObject<{
387
+ decision: z.ZodEnum<{
388
+ accept: "accept";
389
+ acceptForSession: "acceptForSession";
390
+ decline: "decline";
391
+ cancel: "cancel";
392
+ }>;
393
+ }, z.core.$strip>;
394
+ /** item/permissions/requestApproval 请求参数(授权范围原样透传给用户审阅)。 */
395
+ export declare const PermissionsRequestApprovalParams: z.ZodObject<{
396
+ startedAtMs: z.ZodNumber;
397
+ cwd: z.ZodString;
398
+ reason: z.ZodOptional<z.ZodNullable<z.ZodString>>;
399
+ permissions: z.ZodUnknown;
400
+ threadId: z.ZodString;
401
+ turnId: z.ZodString;
402
+ itemId: z.ZodString;
403
+ }, z.core.$loose>;
404
+ /** 权限审批回执:批准=请求声明的范围、scope 取 turn;拒绝=空授权。 */
405
+ export declare const PermissionsRequestApprovalResponse: z.ZodObject<{
406
+ permissions: z.ZodRecord<z.ZodString, z.ZodUnknown>;
407
+ scope: z.ZodEnum<{
408
+ turn: "turn";
409
+ session: "session";
410
+ }>;
411
+ }, z.core.$strip>;
412
+ /** item/tool/requestUserInput 请求参数(EXPERIMENTAL)。 */
413
+ export declare const ToolRequestUserInputParams: z.ZodObject<{
414
+ isBlocking: z.ZodOptional<z.ZodBoolean>;
415
+ questions: z.ZodArray<z.ZodObject<{
416
+ id: z.ZodString;
417
+ header: z.ZodString;
418
+ question: z.ZodString;
419
+ isOther: z.ZodOptional<z.ZodBoolean>;
420
+ isSecret: z.ZodOptional<z.ZodBoolean>;
421
+ options: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodObject<{
422
+ label: z.ZodString;
423
+ description: z.ZodOptional<z.ZodString>;
424
+ }, z.core.$strip>>>>;
425
+ }, z.core.$loose>>;
426
+ threadId: z.ZodString;
427
+ turnId: z.ZodString;
428
+ itemId: z.ZodString;
429
+ }, z.core.$loose>;
430
+ /** 用户输入回执:问题 id → 答案串数组。 */
431
+ export declare const ToolRequestUserInputResponse: z.ZodObject<{
432
+ answers: z.ZodRecord<z.ZodString, z.ZodObject<{
433
+ answers: z.ZodArray<z.ZodString>;
434
+ }, z.core.$strip>>;
435
+ }, z.core.$strip>;
436
+ /** mcpServer/elicitation/request 请求参数(request 扁平字段按 mode 判别)。 */
437
+ export declare const McpServerElicitationRequestParams: z.ZodObject<{
438
+ threadId: z.ZodString;
439
+ turnId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
440
+ serverName: z.ZodString;
441
+ mode: z.ZodOptional<z.ZodString>;
442
+ message: z.ZodOptional<z.ZodString>;
443
+ url: z.ZodOptional<z.ZodString>;
444
+ requestedSchema: z.ZodOptional<z.ZodUnknown>;
445
+ }, z.core.$loose>;
446
+ /** elicitation 回执。 */
447
+ export declare const McpServerElicitationRequestResponse: z.ZodObject<{
448
+ action: z.ZodEnum<{
449
+ accept: "accept";
450
+ decline: "decline";
451
+ cancel: "cancel";
452
+ }>;
453
+ content: z.ZodOptional<z.ZodUnknown>;
454
+ }, z.core.$strip>;
455
+ /** thread/compacted 通知参数:压缩后上下文全量回传的载体。 */
456
+ export declare const ThreadCompactedParams: z.ZodObject<{
457
+ threadId: z.ZodString;
458
+ }, z.core.$loose>;
459
+ /** 单次上游响应/累计的用量明细(TokenUsageBreakdown,camelCase)。 */
460
+ export declare const TokenUsageBreakdownParams: z.ZodObject<{
461
+ totalTokens: z.ZodNumber;
462
+ inputTokens: z.ZodNumber;
463
+ cachedInputTokens: z.ZodNumber;
464
+ cacheWriteInputTokens: z.ZodNumber;
465
+ outputTokens: z.ZodNumber;
466
+ reasoningOutputTokens: z.ZodNumber;
467
+ }, z.core.$strip>;
468
+ /** thread/tokenUsage/updated 通知参数(0.162 wire 实测:last=最近一次响应)。 */
469
+ export declare const TokenUsageParams: z.ZodObject<{
470
+ threadId: z.ZodString;
471
+ turnId: z.ZodString;
472
+ tokenUsage: z.ZodObject<{
473
+ total: z.ZodObject<{
474
+ totalTokens: z.ZodNumber;
475
+ inputTokens: z.ZodNumber;
476
+ cachedInputTokens: z.ZodNumber;
477
+ cacheWriteInputTokens: z.ZodNumber;
478
+ outputTokens: z.ZodNumber;
479
+ reasoningOutputTokens: z.ZodNumber;
480
+ }, z.core.$strip>;
481
+ last: z.ZodObject<{
482
+ totalTokens: z.ZodNumber;
483
+ inputTokens: z.ZodNumber;
484
+ cachedInputTokens: z.ZodNumber;
485
+ cacheWriteInputTokens: z.ZodNumber;
486
+ outputTokens: z.ZodNumber;
487
+ reasoningOutputTokens: z.ZodNumber;
488
+ }, z.core.$strip>;
489
+ }, z.core.$strip>;
490
+ }, z.core.$loose>;
491
+ /** account/updated 通知参数。 */
492
+ export declare const AccountUpdatedParams: z.ZodObject<{}, z.core.$loose>;
493
+ /** 顶层 error 通知参数。 */
494
+ export declare const ErrorNotificationParams: z.ZodObject<{
495
+ message: z.ZodOptional<z.ZodString>;
496
+ error: z.ZodOptional<z.ZodObject<{
497
+ message: z.ZodString;
498
+ additionalDetails: z.ZodOptional<z.ZodNullable<z.ZodString>>;
499
+ }, z.core.$loose>>;
500
+ willRetry: z.ZodOptional<z.ZodBoolean>;
501
+ turnId: z.ZodOptional<z.ZodString>;
502
+ }, z.core.$loose>;
503
+ /** 官方 thread/fork 的回合位置;两个切点字段互斥。 */
504
+ export declare const ThreadForkParams: z.ZodObject<{
505
+ threadId: z.ZodString;
506
+ lastTurnId: z.ZodOptional<z.ZodString>;
507
+ beforeTurnId: z.ZodOptional<z.ZodString>;
508
+ }, z.core.$strip>;