@vellumai/plugin-api 0.10.11-dev.202607241836.91be689 → 0.10.11-dev.202607242023.78fd032

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 (2) hide show
  1. package/index.d.ts +1420 -2006
  2. package/package.json +1 -1
package/index.d.ts CHANGED
@@ -1,82 +1,6 @@
1
1
  /// <reference path="./app.d.ts" />
2
2
  import { z } from 'zod';
3
3
 
4
- declare type _AcpServerMessages = AcpSessionSpawnedEvent | AcpSessionUpdateEvent | AcpSessionCompletedEvent | AcpSessionErrorEvent | AcpSessionUsageEvent;
5
-
6
- declare type AcpSessionCompletedEvent = z.infer<typeof AcpSessionCompletedEventSchema>;
7
-
8
- declare const AcpSessionCompletedEventSchema: z.ZodObject<{
9
- type: z.ZodLiteral<"acp_session_completed">;
10
- acpSessionId: z.ZodString;
11
- stopReason: z.ZodEnum<{
12
- cancelled: "cancelled";
13
- end_turn: "end_turn";
14
- max_tokens: "max_tokens";
15
- max_turn_requests: "max_turn_requests";
16
- refusal: "refusal";
17
- }>;
18
- }, z.core.$strict>;
19
-
20
- declare type AcpSessionErrorEvent = z.infer<typeof AcpSessionErrorEventSchema>;
21
-
22
- declare const AcpSessionErrorEventSchema: z.ZodObject<{
23
- type: z.ZodLiteral<"acp_session_error">;
24
- acpSessionId: z.ZodString;
25
- error: z.ZodString;
26
- }, z.core.$strict>;
27
-
28
- declare type AcpSessionSpawnedEvent = z.infer<typeof AcpSessionSpawnedEventSchema>;
29
-
30
- declare const AcpSessionSpawnedEventSchema: z.ZodObject<{
31
- type: z.ZodLiteral<"acp_session_spawned">;
32
- acpSessionId: z.ZodString;
33
- agent: z.ZodString;
34
- parentConversationId: z.ZodString;
35
- parentToolUseId: z.ZodOptional<z.ZodString>;
36
- task: z.ZodOptional<z.ZodString>;
37
- }, z.core.$strict>;
38
-
39
- declare type AcpSessionUpdateEvent = z.infer<typeof AcpSessionUpdateEventSchema>;
40
-
41
- declare const AcpSessionUpdateEventSchema: z.ZodObject<{
42
- type: z.ZodLiteral<"acp_session_update">;
43
- acpSessionId: z.ZodString;
44
- updateType: z.ZodEnum<{
45
- agent_message_chunk: "agent_message_chunk";
46
- agent_thought_chunk: "agent_thought_chunk";
47
- user_message_chunk: "user_message_chunk";
48
- tool_call: "tool_call";
49
- tool_call_update: "tool_call_update";
50
- plan: "plan";
51
- }>;
52
- content: z.ZodOptional<z.ZodString>;
53
- toolCallId: z.ZodOptional<z.ZodString>;
54
- toolTitle: z.ZodOptional<z.ZodString>;
55
- toolKind: z.ZodOptional<z.ZodString>;
56
- toolStatus: z.ZodOptional<z.ZodString>;
57
- rawInput: z.ZodOptional<z.ZodUnknown>;
58
- rawOutput: z.ZodOptional<z.ZodUnknown>;
59
- locations: z.ZodOptional<z.ZodArray<z.ZodObject<{
60
- path: z.ZodString;
61
- line: z.ZodOptional<z.ZodNumber>;
62
- }, z.core.$strip>>>;
63
- messageId: z.ZodOptional<z.ZodString>;
64
- seq: z.ZodOptional<z.ZodNumber>;
65
- }, z.core.$strict>;
66
-
67
- declare type AcpSessionUsageEvent = z.infer<typeof AcpSessionUsageEventSchema>;
68
-
69
- declare const AcpSessionUsageEventSchema: z.ZodObject<{
70
- type: z.ZodLiteral<"acp_session_usage">;
71
- acpSessionId: z.ZodString;
72
- usedTokens: z.ZodNumber;
73
- contextSize: z.ZodNumber;
74
- inputTokens: z.ZodOptional<z.ZodNumber>;
75
- outputTokens: z.ZodOptional<z.ZodNumber>;
76
- costAmount: z.ZodOptional<z.ZodNumber>;
77
- costCurrency: z.ZodOptional<z.ZodString>;
78
- }, z.core.$strict>;
79
-
80
4
  /**
81
5
  * Append a message to a conversation. This is the low-level insert: it
82
6
  * persists and indexes the row only — it does not project the message into
@@ -152,15 +76,6 @@ export declare type AgentLoopExitReason =
152
76
  /** An unhandled error ended the turn. */
153
77
  | "error";
154
78
 
155
- declare type AppFilesChangedEvent = z.infer<typeof AppFilesChangedEventSchema>;
156
-
157
- declare const AppFilesChangedEventSchema: z.ZodObject<{
158
- type: z.ZodLiteral<"app_files_changed">;
159
- appId: z.ZodString;
160
- }, z.core.$strip>;
161
-
162
- declare type _AppsServerMessages = AppFilesChangedEvent;
163
-
164
79
  /**
165
80
  * How {@link listConversations} (and friends) treats archived rows.
166
81
  *
@@ -174,52 +89,12 @@ declare type _AppsServerMessages = AppFilesChangedEvent;
174
89
  */
175
90
  declare type ArchiveStatusFilter = "active" | "archived" | "all";
176
91
 
177
- declare type AssistantActivityStateEvent = z.infer<typeof AssistantActivityStateEventSchema>;
178
-
179
- declare const AssistantActivityStateEventSchema: z.ZodObject<{
180
- type: z.ZodLiteral<"assistant_activity_state">;
181
- conversationId: z.ZodString;
182
- activityVersion: z.ZodNumber;
183
- phase: z.ZodEnum<{
184
- thinking: "thinking";
185
- idle: "idle";
186
- streaming: "streaming";
187
- tool_running: "tool_running";
188
- awaiting_confirmation: "awaiting_confirmation";
189
- }>;
190
- anchor: z.ZodEnum<{
191
- assistant_turn: "assistant_turn";
192
- user_turn: "user_turn";
193
- global: "global";
194
- }>;
195
- reason: z.ZodEnum<{
196
- thinking_delta: "thinking_delta";
197
- generation_cancelled: "generation_cancelled";
198
- message_dequeued: "message_dequeued";
199
- first_text_delta: "first_text_delta";
200
- tool_use_start: "tool_use_start";
201
- preview_start: "preview_start";
202
- tool_result_received: "tool_result_received";
203
- confirmation_requested: "confirmation_requested";
204
- confirmation_resolved: "confirmation_resolved";
205
- context_compacting: "context_compacting";
206
- message_complete: "message_complete";
207
- error_terminal: "error_terminal";
208
- }>;
209
- requestId: z.ZodOptional<z.ZodString>;
210
- statusText: z.ZodOptional<z.ZodString>;
211
- }, z.core.$strip>;
212
-
213
92
  declare type AssistantConfig = z.infer<typeof AssistantConfigSchema>;
214
93
 
215
94
  declare const AssistantConfigSchema: z.ZodObject<{
216
95
  services: z.ZodDefault<z.ZodObject<{
217
96
  inference: z.ZodDefault<z.ZodObject<{}, z.core.$strip>>;
218
97
  "image-generation": z.ZodDefault<z.ZodObject<{
219
- mode: z.ZodDefault<z.ZodEnum<{
220
- managed: "managed";
221
- "your-own": "your-own";
222
- }>>;
223
98
  provider: z.ZodDefault<z.ZodEnum<{
224
99
  openai: "openai";
225
100
  gemini: "gemini";
@@ -1252,310 +1127,1420 @@ declare const AssistantConfigSchema: z.ZodObject<{
1252
1127
  maxStepsPerSession: z.ZodDefault<z.ZodNumber>;
1253
1128
  }, z.core.$strip>;
1254
1129
 
1255
- /** Daemon-side specialization of the generic event envelope. */
1256
- export declare type AssistantEvent = BaseAssistantEvent<ServerMessage>;
1257
-
1258
- export declare type AssistantEventCallback = (event: AssistantEvent) => void | Promise<void>;
1259
-
1260
- /** Filter that determines which events a subscriber receives. */
1261
- export declare type AssistantEventFilter = {
1262
- /** When set, restrict delivery to events for this conversation. */
1263
- conversationId?: string;
1264
- };
1265
-
1266
1130
  /**
1267
- * Lightweight pub/sub hub for `AssistantEvent` messages.
1268
- *
1269
- * Filtering is applied at subscription level:
1270
- * - `conversationId`: scoped events match subscribers with same conversationId
1271
- * or no conversationId filter (broadcast to all).
1272
- * - `targetCapability` (on publish): targeted events only reach subscribers
1273
- * whose capabilities include the target. Untargeted events fan out to all.
1274
- *
1275
- * Client connections register as subscribers with metadata and are queryable
1276
- * via `listClients()`, `getMostRecentClientByCapability()`, etc.
1131
+ * Daemon-side event envelope: the canonical `AssistantEventEnvelope` wrapping
1132
+ * an `AssistantEvent` message payload.
1277
1133
  */
1278
- export declare class AssistantEventHub {
1279
- private readonly subscribers;
1280
- private readonly maxSubscribers;
1281
- /** Monotonic source for per-connection ids, scoped to this hub. */
1282
- private connectionCounter;
1283
- constructor(options?: {
1284
- maxSubscribers?: number;
1285
- });
1286
- /**
1287
- * Register a subscriber that will be called for each matching event.
1288
- *
1289
- * **Client deduplication:** When a client subscriber is registered with a
1290
- * `clientId` that already exists, all stale entries for that clientId are
1291
- * disposed first. This prevents subscriber stacking when clients reconnect
1292
- * (e.g. Chrome extension reload, SSE token refresh) before the old
1293
- * connection's abort signal fires.
1294
- *
1295
- * When the subscriber cap (`maxSubscribers`) has been reached, the **oldest**
1296
- * subscriber is evicted to make room: its `onEvict` callback is invoked (so
1297
- * it can close its SSE stream) and its entry is removed from the hub.
1298
- */
1299
- subscribe(subscriber: SubscriberInput): AssistantEventSubscription;
1300
- /**
1301
- * Publish an event to all matching subscribers.
1302
- *
1303
- * Matching rules:
1304
- * - if `excludeClientId` is set, the subscriber with that clientId is
1305
- * skipped regardless of every other rule (self-echo suppression — the
1306
- * client that originated the mutation does not receive its own
1307
- * invalidation back through the hub).
1308
- * - if `targetClientId` is set, deliver only to the subscriber with that
1309
- * clientId, bypassing the conversation-id filter entirely (the web-origin
1310
- * event's conversationId differs from the macOS client's subscribed
1311
- * conversation).
1312
- * - if `filter.conversationId` is set (and `targetClientId` is not), the
1313
- * `event.conversationId` must equal it
1314
- * - if `targetCapability` is set, only subscribers whose capabilities include
1315
- * it receive the event; untargeted events go to all
1316
- * - if `targetInterfaceId` is set, only client subscribers whose
1317
- * `interfaceId` matches receive the event; process subscribers and
1318
- * non-matching clients are skipped. Used to narrow legacy
1319
- * broadcasts (e.g. `conversation_list_invalidated`) to a specific
1320
- * client surface during a migration window.
1321
- *
1322
- * Fanout is isolated: a throwing or rejecting subscriber does not abort
1323
- * delivery to remaining subscribers.
1324
- */
1325
- publish(event: AssistantEvent, options?: {
1326
- targetCapability?: HostProxyCapability;
1327
- targetClientId?: string;
1328
- targetInterfaceId?: InterfaceId;
1329
- /**
1330
- * Skip the subscriber with this `clientId`. Used for self-echo
1331
- * suppression on `sync_changed`: the route handler echoes the
1332
- * originating tab's `X-Vellum-Client-Id` back on the event, and the
1333
- * hub uses it here to avoid re-delivering the invalidation to the
1334
- * tab that already mutated its own optimistic state.
1335
- */
1336
- excludeClientId?: string;
1337
- }): Promise<void>;
1338
- /**
1339
- * Return the active client subscriber with the given clientId, or
1340
- * `undefined` if no such subscriber exists.
1341
- */
1342
- getClientById(clientId: string): ClientEntry | undefined;
1343
- /**
1344
- * Return the verified actor principal id captured at SSE subscription time
1345
- * for the given client, or `undefined` if the client is unknown or
1346
- * connected without a principal (e.g. legacy/service tokens).
1347
- *
1348
- * Used by host proxies to bind cross-client targeted execution to the same
1349
- * authenticated user identity that opened the target client's SSE stream.
1350
- */
1351
- getActorPrincipalIdForClient(clientId: string): string | undefined;
1352
- /**
1353
- * Returns true when at least one active subscriber would receive the given
1354
- * event based on the same conversation matching rules as publish().
1355
- */
1356
- hasSubscribersForEvent(event: Pick<AssistantEvent, "conversationId">): boolean;
1357
- private clientEntries;
1358
- /**
1359
- * Return all active client subscribers, sorted by `lastActiveAt` descending.
1360
- */
1361
- listClients(): ClientEntry[];
1362
- /**
1363
- * Return all client subscribers that support the given capability,
1364
- * sorted by `lastActiveAt` descending.
1365
- */
1366
- listClientsByCapability(capability: HostProxyCapability): ClientEntry[];
1367
- /**
1368
- * Return the most recently active client that supports the given
1369
- * capability, or `undefined` if none exists.
1370
- */
1371
- getMostRecentClientByCapability(capability: HostProxyCapability): ClientEntry | undefined;
1372
- /**
1373
- * Return all client subscribers with the given interface type,
1374
- * sorted by `lastActiveAt` descending.
1375
- */
1376
- listClientsByInterface(interfaceId: InterfaceId): ClientEntry[];
1377
- /**
1378
- * Touch a client subscriber — update `lastActiveAt`. Used by heartbeat.
1379
- */
1380
- touchClient(clientId: string): void;
1381
- /**
1382
- * Force-disconnect a client by disposing all subscribers for the given
1383
- * `clientId`. Returns the number of disposed entries.
1384
- *
1385
- * Used by `assistant clients disconnect <clientId>` to forcibly remove
1386
- * stale or unwanted client connections.
1387
- */
1388
- disposeClient(clientId: string): number;
1389
- /** Number of currently active subscribers (useful for tests and caps). */
1390
- subscriberCount(): number;
1391
- /** Returns true if the hub can accept a subscriber without evicting anyone. */
1392
- hasCapacity(): boolean;
1393
- }
1394
-
1395
- /** The plugin-facing event hub. See module docs. */
1396
- export declare const assistantEventHub: PluginEventHub;
1397
-
1398
- /** Opaque handle returned by `subscribe`. Call `dispose()` to remove the subscription. */
1399
- export declare interface AssistantEventSubscription {
1400
- dispose(): void;
1401
- /** True until `dispose()` has been called. */
1402
- readonly active: boolean;
1403
- /**
1404
- * Per-connection identifier, unique within the hub instance. Distinguishes
1405
- * connections that share a `clientId` (e.g. an old connection and the new
1406
- * one that replaced it on reconnect) so subscribe / dispose / shed log
1407
- * lines can be attributed to a specific connection.
1408
- */
1409
- readonly connectionId: string;
1410
- }
1411
-
1412
- declare type AssistantStatusEvent = z.infer<typeof AssistantStatusEventSchema>;
1413
-
1414
- declare const AssistantStatusEventSchema: z.ZodObject<{
1415
- type: z.ZodLiteral<"assistant_status">;
1416
- version: z.ZodOptional<z.ZodString>;
1417
- keyFingerprint: z.ZodOptional<z.ZodString>;
1418
- }, z.core.$strip>;
1419
-
1420
- declare type AssistantTextDeltaEvent = z.infer<typeof AssistantTextDeltaEventSchema>;
1421
-
1422
- declare const AssistantTextDeltaEventSchema: z.ZodObject<{
1423
- type: z.ZodLiteral<"assistant_text_delta">;
1424
- text: z.ZodString;
1425
- messageId: z.ZodOptional<z.ZodString>;
1426
- conversationId: z.ZodOptional<z.ZodString>;
1427
- }, z.core.$strip>;
1428
-
1429
- declare type AssistantThinkingDeltaEvent = z.infer<typeof AssistantThinkingDeltaEventSchema>;
1430
-
1431
- declare const AssistantThinkingDeltaEventSchema: z.ZodObject<{
1432
- type: z.ZodLiteral<"assistant_thinking_delta">;
1433
- thinking: z.ZodString;
1434
- messageId: z.ZodOptional<z.ZodString>;
1435
- conversationId: z.ZodOptional<z.ZodString>;
1436
- timestampMs: z.ZodOptional<z.ZodNumber>;
1437
- }, z.core.$strip>;
1438
-
1439
- declare type AssistantTurnStartEvent = z.infer<typeof AssistantTurnStartEventSchema>;
1440
-
1441
- declare const AssistantTurnStartEventSchema: z.ZodObject<{
1442
- type: z.ZodLiteral<"assistant_turn_start">;
1443
- messageId: z.ZodString;
1444
- conversationId: z.ZodOptional<z.ZodString>;
1445
- }, z.core.$strip>;
1446
-
1447
- declare interface AudioEmbeddingInput {
1448
- type: "audio";
1449
- data: Buffer;
1450
- mimeType: string;
1451
- }
1452
-
1453
- declare type AvatarUpdatedEvent = z.infer<typeof AvatarUpdatedEventSchema>;
1454
-
1455
- declare const AvatarUpdatedEventSchema: z.ZodObject<{
1456
- type: z.ZodLiteral<"avatar_updated">;
1457
- avatarPath: z.ZodString;
1458
- }, z.core.$strip>;
1459
-
1460
- declare type BackgroundToolCompletedEvent = z.infer<typeof BackgroundToolCompletedEventSchema>;
1461
-
1462
- declare const BackgroundToolCompletedEventSchema: z.ZodObject<{
1463
- type: z.ZodLiteral<"background_tool_completed">;
1464
- id: z.ZodString;
1465
- conversationId: z.ZodString;
1466
- status: z.ZodEnum<{
1467
- cancelled: "cancelled";
1468
- completed: "completed";
1469
- failed: "failed";
1470
- }>;
1471
- exitCode: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
1472
- output: z.ZodOptional<z.ZodString>;
1473
- completedAt: z.ZodNumber;
1474
- }, z.core.$strip>;
1475
-
1476
- declare type _BackgroundToolsServerMessages = BackgroundToolStartedEvent | BackgroundToolCompletedEvent;
1477
-
1478
- declare type BackgroundToolStartedEvent = z.infer<typeof BackgroundToolStartedEventSchema>;
1479
-
1480
- declare const BackgroundToolStartedEventSchema: z.ZodObject<{
1481
- type: z.ZodLiteral<"background_tool_started">;
1482
- id: z.ZodString;
1483
- toolName: z.ZodString;
1484
- conversationId: z.ZodString;
1485
- command: z.ZodString;
1486
- startedAt: z.ZodNumber;
1487
- }, z.core.$strip>;
1134
+ export declare type AssistantEvent = AssistantEventEnvelope;
1488
1135
 
1489
- /**
1490
- * Media payload for an image or file content block. One unified type covers
1491
- * both blocks and both storage forms:
1492
- *
1493
- * - `base64` — the bytes travel inline with the block. This is the runtime
1494
- * shape the provider transforms consume and the shape produced for a live
1495
- * (in-flight) turn.
1496
- * - `workspace_ref` — the bytes live somewhere in the workspace, not inline.
1497
- * This is the shape PERSISTED into `messages.content`, keeping large blobs
1498
- * out of the DB row and the lexical index. It is resolved back to inline
1499
- * bytes at the provider send boundary (`providers/media-resolve.ts`); any
1500
- * consumer that needs the raw bytes from stored content resolves it with
1501
- * `resolveMediaSourceData(source)`.
1502
- *
1503
- * `filename` is optional on both arms (present for file blocks and for
1504
- * generated-media references). For references, `sizeBytes` (and, for images,
1505
- * `width`/`height`) are captured at persist time so size-only consumers — the
1506
- * per-turn token estimator especially — can cost the block without reading the
1507
- * file back off disk.
1508
- */
1509
- declare interface Base64MediaSource {
1510
- type: "base64";
1511
- media_type: string;
1512
- data: string;
1513
- filename?: string;
1514
- }
1136
+ export declare type AssistantEventCallback = (event: AssistantEvent) => void | Promise<void>;
1515
1137
 
1516
- /**
1517
- * A single assistant event wrapping an outbound message payload.
1518
- *
1519
- * Generic over the payload type. The `TMessage` default of `unknown` keeps
1520
- * the envelope nameable without a type argument when the caller does not
1521
- * care about message narrowing.
1522
- */
1523
- declare interface BaseAssistantEvent<TMessage = unknown> {
1524
- /** Globally unique event identifier (UUID). */
1525
- id: string;
1526
- /** Resolved conversation id when available. */
1527
- conversationId?: string;
1528
- /**
1529
- * Monotonic per-conversation sequence number. Assigned by the daemon at
1530
- * publish time for conversation-scoped events; absent for unscoped
1531
- * broadcasts. Clients track the highest observed `seq` per conversation
1532
- * and pass it back on reconnect to request replay of missed events.
1533
- */
1534
- seq?: number;
1535
- /** ISO-8601 timestamp of when the event was emitted. */
1536
- emittedAt: string;
1537
- /** Outbound message payload. */
1538
- message: TMessage;
1539
- }
1138
+ declare type AssistantEventEnvelope = z.infer<typeof AssistantEventEnvelopeSchema>;
1540
1139
 
1541
1140
  /**
1542
- * Capabilities shared by every chain-hook context (`user-prompt-submit`,
1543
- * `post-compact`, `post-tool-use`, `stop`, `pre-model-call`,
1544
- * `post-model-call`).
1141
+ * SSE wire envelope wrapping every outbound event from the daemon.
1545
1142
  *
1546
- * Both are stamped onto each hook's draft by the pipeline (`runHook`) before
1547
- * the hook runs, bound to that hook's identity — dispatching call sites
1548
- * construct the `XInputContext` shapes and never supply these.
1143
+ * Transport-level metadata (`id`, `seq`, `emittedAt`, `conversationId`)
1144
+ * surrounds the semantic event payload in `message`.
1549
1145
  */
1550
- declare interface BaseHookContext {
1551
- /**
1552
- * Logger bound to the emitting hook — pre-tagged with the hook name and
1553
- * owning plugin (plus `conversationId` / `requestId` when the dispatching
1554
- * context carries them), so hook log lines are attributed without manual
1555
- * tagging.
1556
- */
1557
- readonly logger: PluginLogger;
1558
- /**
1146
+ declare const AssistantEventEnvelopeSchema: z.ZodObject<{
1147
+ id: z.ZodString;
1148
+ conversationId: z.ZodOptional<z.ZodString>;
1149
+ seq: z.ZodOptional<z.ZodNumber>;
1150
+ emittedAt: z.ZodString;
1151
+ message: z.ZodDiscriminatedUnion<[z.ZodObject<{
1152
+ type: z.ZodLiteral<"acp_session_completed">;
1153
+ acpSessionId: z.ZodString;
1154
+ stopReason: z.ZodEnum<{
1155
+ cancelled: "cancelled";
1156
+ end_turn: "end_turn";
1157
+ max_tokens: "max_tokens";
1158
+ max_turn_requests: "max_turn_requests";
1159
+ refusal: "refusal";
1160
+ }>;
1161
+ }, z.core.$strict>, z.ZodObject<{
1162
+ type: z.ZodLiteral<"acp_session_error">;
1163
+ acpSessionId: z.ZodString;
1164
+ error: z.ZodString;
1165
+ }, z.core.$strict>, z.ZodObject<{
1166
+ type: z.ZodLiteral<"acp_session_spawned">;
1167
+ acpSessionId: z.ZodString;
1168
+ agent: z.ZodString;
1169
+ parentConversationId: z.ZodString;
1170
+ parentToolUseId: z.ZodOptional<z.ZodString>;
1171
+ task: z.ZodOptional<z.ZodString>;
1172
+ }, z.core.$strict>, z.ZodObject<{
1173
+ type: z.ZodLiteral<"acp_session_update">;
1174
+ acpSessionId: z.ZodString;
1175
+ updateType: z.ZodEnum<{
1176
+ agent_message_chunk: "agent_message_chunk";
1177
+ agent_thought_chunk: "agent_thought_chunk";
1178
+ user_message_chunk: "user_message_chunk";
1179
+ tool_call: "tool_call";
1180
+ tool_call_update: "tool_call_update";
1181
+ plan: "plan";
1182
+ }>;
1183
+ content: z.ZodOptional<z.ZodString>;
1184
+ toolCallId: z.ZodOptional<z.ZodString>;
1185
+ toolTitle: z.ZodOptional<z.ZodString>;
1186
+ toolKind: z.ZodOptional<z.ZodString>;
1187
+ toolStatus: z.ZodOptional<z.ZodString>;
1188
+ rawInput: z.ZodOptional<z.ZodUnknown>;
1189
+ rawOutput: z.ZodOptional<z.ZodUnknown>;
1190
+ locations: z.ZodOptional<z.ZodArray<z.ZodObject<{
1191
+ path: z.ZodString;
1192
+ line: z.ZodOptional<z.ZodNumber>;
1193
+ }, z.core.$strip>>>;
1194
+ messageId: z.ZodOptional<z.ZodString>;
1195
+ seq: z.ZodOptional<z.ZodNumber>;
1196
+ }, z.core.$strict>, z.ZodObject<{
1197
+ type: z.ZodLiteral<"acp_session_usage">;
1198
+ acpSessionId: z.ZodString;
1199
+ usedTokens: z.ZodNumber;
1200
+ contextSize: z.ZodNumber;
1201
+ inputTokens: z.ZodOptional<z.ZodNumber>;
1202
+ outputTokens: z.ZodOptional<z.ZodNumber>;
1203
+ costAmount: z.ZodOptional<z.ZodNumber>;
1204
+ costCurrency: z.ZodOptional<z.ZodString>;
1205
+ }, z.core.$strict>, z.ZodObject<{
1206
+ type: z.ZodLiteral<"app_files_changed">;
1207
+ appId: z.ZodString;
1208
+ }, z.core.$strip>, z.ZodObject<{
1209
+ type: z.ZodLiteral<"assistant_activity_state">;
1210
+ conversationId: z.ZodString;
1211
+ activityVersion: z.ZodNumber;
1212
+ phase: z.ZodEnum<{
1213
+ thinking: "thinking";
1214
+ idle: "idle";
1215
+ streaming: "streaming";
1216
+ tool_running: "tool_running";
1217
+ awaiting_confirmation: "awaiting_confirmation";
1218
+ }>;
1219
+ anchor: z.ZodEnum<{
1220
+ assistant_turn: "assistant_turn";
1221
+ user_turn: "user_turn";
1222
+ global: "global";
1223
+ }>;
1224
+ reason: z.ZodEnum<{
1225
+ thinking_delta: "thinking_delta";
1226
+ message_dequeued: "message_dequeued";
1227
+ first_text_delta: "first_text_delta";
1228
+ tool_use_start: "tool_use_start";
1229
+ preview_start: "preview_start";
1230
+ tool_result_received: "tool_result_received";
1231
+ confirmation_requested: "confirmation_requested";
1232
+ confirmation_resolved: "confirmation_resolved";
1233
+ context_compacting: "context_compacting";
1234
+ message_complete: "message_complete";
1235
+ generation_cancelled: "generation_cancelled";
1236
+ error_terminal: "error_terminal";
1237
+ }>;
1238
+ requestId: z.ZodOptional<z.ZodString>;
1239
+ statusText: z.ZodOptional<z.ZodString>;
1240
+ }, z.core.$strip>, z.ZodObject<{
1241
+ type: z.ZodLiteral<"assistant_status">;
1242
+ version: z.ZodOptional<z.ZodString>;
1243
+ keyFingerprint: z.ZodOptional<z.ZodString>;
1244
+ }, z.core.$strip>, z.ZodObject<{
1245
+ type: z.ZodLiteral<"assistant_text_delta">;
1246
+ text: z.ZodString;
1247
+ messageId: z.ZodOptional<z.ZodString>;
1248
+ conversationId: z.ZodOptional<z.ZodString>;
1249
+ }, z.core.$strip>, z.ZodObject<{
1250
+ type: z.ZodLiteral<"assistant_thinking_delta">;
1251
+ thinking: z.ZodString;
1252
+ messageId: z.ZodOptional<z.ZodString>;
1253
+ conversationId: z.ZodOptional<z.ZodString>;
1254
+ timestampMs: z.ZodOptional<z.ZodNumber>;
1255
+ }, z.core.$strip>, z.ZodObject<{
1256
+ type: z.ZodLiteral<"assistant_turn_start">;
1257
+ messageId: z.ZodString;
1258
+ conversationId: z.ZodOptional<z.ZodString>;
1259
+ }, z.core.$strip>, z.ZodObject<{
1260
+ type: z.ZodLiteral<"avatar_updated">;
1261
+ avatarPath: z.ZodString;
1262
+ }, z.core.$strip>, z.ZodObject<{
1263
+ type: z.ZodLiteral<"background_tool_completed">;
1264
+ id: z.ZodString;
1265
+ conversationId: z.ZodString;
1266
+ status: z.ZodEnum<{
1267
+ cancelled: "cancelled";
1268
+ completed: "completed";
1269
+ failed: "failed";
1270
+ }>;
1271
+ exitCode: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
1272
+ output: z.ZodOptional<z.ZodString>;
1273
+ completedAt: z.ZodNumber;
1274
+ }, z.core.$strip>, z.ZodObject<{
1275
+ type: z.ZodLiteral<"background_tool_started">;
1276
+ id: z.ZodString;
1277
+ toolName: z.ZodString;
1278
+ conversationId: z.ZodString;
1279
+ command: z.ZodString;
1280
+ startedAt: z.ZodNumber;
1281
+ }, z.core.$strip>, z.ZodObject<{
1282
+ type: z.ZodLiteral<"bookmark.created">;
1283
+ bookmark: z.ZodObject<{
1284
+ id: z.ZodString;
1285
+ messageId: z.ZodString;
1286
+ conversationId: z.ZodString;
1287
+ conversationTitle: z.ZodNullable<z.ZodString>;
1288
+ messagePreview: z.ZodString;
1289
+ messageRole: z.ZodString;
1290
+ messageCreatedAt: z.ZodNumber;
1291
+ createdAt: z.ZodNumber;
1292
+ }, z.core.$strip>;
1293
+ }, z.core.$strip>, z.ZodObject<{
1294
+ type: z.ZodLiteral<"bookmark.deleted">;
1295
+ messageId: z.ZodString;
1296
+ }, z.core.$strip>, z.ZodObject<{
1297
+ type: z.ZodLiteral<"client_settings_update">;
1298
+ key: z.ZodString;
1299
+ value: z.ZodString;
1300
+ }, z.core.$strip>, z.ZodObject<{
1301
+ type: z.ZodLiteral<"compaction_circuit_closed">;
1302
+ conversationId: z.ZodString;
1303
+ }, z.core.$strip>, z.ZodObject<{
1304
+ type: z.ZodLiteral<"compaction_circuit_open">;
1305
+ conversationId: z.ZodString;
1306
+ reason: z.ZodLiteral<"3_consecutive_failures">;
1307
+ openUntil: z.ZodNumber;
1308
+ }, z.core.$strip>, z.ZodObject<{
1309
+ type: z.ZodLiteral<"config_changed">;
1310
+ }, z.core.$strip>, z.ZodObject<{
1311
+ type: z.ZodLiteral<"confirmation_request">;
1312
+ requestId: z.ZodString;
1313
+ toolName: z.ZodString;
1314
+ input: z.ZodRecord<z.ZodString, z.ZodUnknown>;
1315
+ riskLevel: z.ZodString;
1316
+ riskReason: z.ZodOptional<z.ZodString>;
1317
+ isContainerized: z.ZodOptional<z.ZodBoolean>;
1318
+ executionTarget: z.ZodOptional<z.ZodEnum<{
1319
+ sandbox: "sandbox";
1320
+ host: "host";
1321
+ }>>;
1322
+ allowlistOptions: z.ZodArray<z.ZodObject<{
1323
+ label: z.ZodString;
1324
+ description: z.ZodString;
1325
+ pattern: z.ZodString;
1326
+ }, z.core.$strip>>;
1327
+ scopeOptions: z.ZodArray<z.ZodObject<{
1328
+ label: z.ZodString;
1329
+ scope: z.ZodString;
1330
+ }, z.core.$strip>>;
1331
+ directoryScopeOptions: z.ZodOptional<z.ZodArray<z.ZodObject<{
1332
+ label: z.ZodString;
1333
+ scope: z.ZodString;
1334
+ }, z.core.$strip>>>;
1335
+ diff: z.ZodOptional<z.ZodObject<{
1336
+ filePath: z.ZodString;
1337
+ oldContent: z.ZodString;
1338
+ newContent: z.ZodString;
1339
+ isNewFile: z.ZodBoolean;
1340
+ }, z.core.$strip>>;
1341
+ conversationId: z.ZodOptional<z.ZodString>;
1342
+ persistentDecisionsAllowed: z.ZodOptional<z.ZodBoolean>;
1343
+ toolUseId: z.ZodOptional<z.ZodString>;
1344
+ acpToolKind: z.ZodOptional<z.ZodString>;
1345
+ acpOptions: z.ZodOptional<z.ZodArray<z.ZodObject<{
1346
+ optionId: z.ZodString;
1347
+ name: z.ZodString;
1348
+ kind: z.ZodEnum<{
1349
+ allow_once: "allow_once";
1350
+ allow_always: "allow_always";
1351
+ reject_once: "reject_once";
1352
+ reject_always: "reject_always";
1353
+ }>;
1354
+ }, z.core.$strip>>>;
1355
+ }, z.core.$strip>, z.ZodObject<{
1356
+ type: z.ZodLiteral<"confirmation_state_changed">;
1357
+ conversationId: z.ZodString;
1358
+ requestId: z.ZodString;
1359
+ state: z.ZodEnum<{
1360
+ timed_out: "timed_out";
1361
+ pending: "pending";
1362
+ approved: "approved";
1363
+ denied: "denied";
1364
+ resolved_stale: "resolved_stale";
1365
+ }>;
1366
+ source: z.ZodEnum<{
1367
+ button: "button";
1368
+ inline_nl: "inline_nl";
1369
+ auto_deny: "auto_deny";
1370
+ timeout: "timeout";
1371
+ system: "system";
1372
+ }>;
1373
+ causedByRequestId: z.ZodOptional<z.ZodString>;
1374
+ decisionText: z.ZodOptional<z.ZodString>;
1375
+ toolUseId: z.ZodOptional<z.ZodString>;
1376
+ }, z.core.$strip>, z.ZodObject<{
1377
+ type: z.ZodLiteral<"contact_request">;
1378
+ requestId: z.ZodString;
1379
+ channel: z.ZodOptional<z.ZodString>;
1380
+ placeholder: z.ZodOptional<z.ZodString>;
1381
+ label: z.ZodOptional<z.ZodString>;
1382
+ description: z.ZodOptional<z.ZodString>;
1383
+ role: z.ZodOptional<z.ZodString>;
1384
+ }, z.core.$strip>, z.ZodObject<{
1385
+ type: z.ZodLiteral<"contacts_changed">;
1386
+ }, z.core.$strip>, z.ZodObject<{
1387
+ type: z.ZodLiteral<"context_compacted">;
1388
+ conversationId: z.ZodString;
1389
+ previousEstimatedInputTokens: z.ZodNumber;
1390
+ estimatedInputTokens: z.ZodNumber;
1391
+ maxInputTokens: z.ZodNumber;
1392
+ thresholdTokens: z.ZodNumber;
1393
+ compactedMessages: z.ZodNumber;
1394
+ summaryCalls: z.ZodNumber;
1395
+ summaryInputTokens: z.ZodNumber;
1396
+ summaryOutputTokens: z.ZodNumber;
1397
+ summaryModel: z.ZodString;
1398
+ summaryCharCount: z.ZodOptional<z.ZodNumber>;
1399
+ summaryHeaderCount: z.ZodOptional<z.ZodNumber>;
1400
+ summaryHadMemoryEcho: z.ZodOptional<z.ZodBoolean>;
1401
+ }, z.core.$strip>, z.ZodObject<{
1402
+ type: z.ZodLiteral<"conversation_error">;
1403
+ conversationId: z.ZodString;
1404
+ code: z.ZodEnum<{
1405
+ PROVIDER_NETWORK: "PROVIDER_NETWORK";
1406
+ PROVIDER_RATE_LIMIT: "PROVIDER_RATE_LIMIT";
1407
+ MANAGED_USAGE_LIMIT: "MANAGED_USAGE_LIMIT";
1408
+ PROVIDER_OVERLOADED: "PROVIDER_OVERLOADED";
1409
+ PROVIDER_API: "PROVIDER_API";
1410
+ IMAGE_TOO_LARGE: "IMAGE_TOO_LARGE";
1411
+ PROVIDER_BILLING: "PROVIDER_BILLING";
1412
+ PROVIDER_ORDERING: "PROVIDER_ORDERING";
1413
+ PROVIDER_WEB_SEARCH: "PROVIDER_WEB_SEARCH";
1414
+ PROVIDER_NOT_CONFIGURED: "PROVIDER_NOT_CONFIGURED";
1415
+ PROVIDER_INVALID_KEY: "PROVIDER_INVALID_KEY";
1416
+ MANAGED_KEY_INVALID: "MANAGED_KEY_INVALID";
1417
+ CONTEXT_TOO_LARGE: "CONTEXT_TOO_LARGE";
1418
+ BUDGET_YIELD_UNRECOVERED: "BUDGET_YIELD_UNRECOVERED";
1419
+ MAX_TOKENS_REACHED: "MAX_TOKENS_REACHED";
1420
+ CONVERSATION_ABORTED: "CONVERSATION_ABORTED";
1421
+ CONVERSATION_PROCESSING_FAILED: "CONVERSATION_PROCESSING_FAILED";
1422
+ DISK_SPACE_CRITICAL: "DISK_SPACE_CRITICAL";
1423
+ UNKNOWN: "UNKNOWN";
1424
+ }>;
1425
+ userMessage: z.ZodString;
1426
+ retryable: z.ZodBoolean;
1427
+ debugDetails: z.ZodOptional<z.ZodString>;
1428
+ errorCategory: z.ZodOptional<z.ZodString>;
1429
+ connectionName: z.ZodOptional<z.ZodString>;
1430
+ profileName: z.ZodOptional<z.ZodString>;
1431
+ }, z.core.$strip>, z.ZodObject<{
1432
+ type: z.ZodLiteral<"conversation_inference_profile_updated">;
1433
+ conversationId: z.ZodString;
1434
+ profile: z.ZodNullable<z.ZodString>;
1435
+ sessionId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
1436
+ expiresAt: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
1437
+ }, z.core.$strip>, z.ZodObject<{
1438
+ type: z.ZodLiteral<"conversation_list_invalidated">;
1439
+ reason: z.ZodEnum<{
1440
+ created: "created";
1441
+ renamed: "renamed";
1442
+ deleted: "deleted";
1443
+ reordered: "reordered";
1444
+ seen_changed: "seen_changed";
1445
+ }>;
1446
+ }, z.core.$strip>, z.ZodObject<{
1447
+ type: z.ZodLiteral<"conversation_notice">;
1448
+ conversationId: z.ZodString;
1449
+ source: z.ZodEnum<{
1450
+ memory_v3: "memory_v3";
1451
+ }>;
1452
+ code: z.ZodEnum<{
1453
+ PROVIDER_NETWORK: "PROVIDER_NETWORK";
1454
+ PROVIDER_RATE_LIMIT: "PROVIDER_RATE_LIMIT";
1455
+ MANAGED_USAGE_LIMIT: "MANAGED_USAGE_LIMIT";
1456
+ PROVIDER_OVERLOADED: "PROVIDER_OVERLOADED";
1457
+ PROVIDER_API: "PROVIDER_API";
1458
+ IMAGE_TOO_LARGE: "IMAGE_TOO_LARGE";
1459
+ PROVIDER_BILLING: "PROVIDER_BILLING";
1460
+ PROVIDER_ORDERING: "PROVIDER_ORDERING";
1461
+ PROVIDER_WEB_SEARCH: "PROVIDER_WEB_SEARCH";
1462
+ PROVIDER_NOT_CONFIGURED: "PROVIDER_NOT_CONFIGURED";
1463
+ PROVIDER_INVALID_KEY: "PROVIDER_INVALID_KEY";
1464
+ MANAGED_KEY_INVALID: "MANAGED_KEY_INVALID";
1465
+ CONTEXT_TOO_LARGE: "CONTEXT_TOO_LARGE";
1466
+ BUDGET_YIELD_UNRECOVERED: "BUDGET_YIELD_UNRECOVERED";
1467
+ MAX_TOKENS_REACHED: "MAX_TOKENS_REACHED";
1468
+ CONVERSATION_ABORTED: "CONVERSATION_ABORTED";
1469
+ CONVERSATION_PROCESSING_FAILED: "CONVERSATION_PROCESSING_FAILED";
1470
+ DISK_SPACE_CRITICAL: "DISK_SPACE_CRITICAL";
1471
+ UNKNOWN: "UNKNOWN";
1472
+ }>;
1473
+ userMessage: z.ZodString;
1474
+ errorCategory: z.ZodOptional<z.ZodString>;
1475
+ }, z.core.$strip>, z.ZodObject<{
1476
+ type: z.ZodLiteral<"conversation_title_updated">;
1477
+ conversationId: z.ZodString;
1478
+ title: z.ZodString;
1479
+ }, z.core.$strip>, z.ZodObject<{
1480
+ type: z.ZodLiteral<"disk_pressure_status_changed">;
1481
+ status: z.ZodObject<{
1482
+ enabled: z.ZodBoolean;
1483
+ state: z.ZodEnum<{
1484
+ unknown: "unknown";
1485
+ disabled: "disabled";
1486
+ critical: "critical";
1487
+ ok: "ok";
1488
+ warning: "warning";
1489
+ }>;
1490
+ locked: z.ZodBoolean;
1491
+ acknowledged: z.ZodBoolean;
1492
+ overrideActive: z.ZodBoolean;
1493
+ effectivelyLocked: z.ZodBoolean;
1494
+ lockId: z.ZodNullable<z.ZodString>;
1495
+ usagePercent: z.ZodNullable<z.ZodNumber>;
1496
+ thresholdPercent: z.ZodNumber;
1497
+ path: z.ZodNullable<z.ZodString>;
1498
+ lastCheckedAt: z.ZodNullable<z.ZodString>;
1499
+ blockedCapabilities: z.ZodArray<z.ZodEnum<{
1500
+ "agent-turns": "agent-turns";
1501
+ "background-work": "background-work";
1502
+ "remote-ingress": "remote-ingress";
1503
+ }>>;
1504
+ error: z.ZodNullable<z.ZodString>;
1505
+ }, z.core.$strip>;
1506
+ }, z.core.$strip>, z.ZodObject<{
1507
+ type: z.ZodLiteral<"document_comment_created">;
1508
+ conversationId: z.ZodString;
1509
+ surfaceId: z.ZodString;
1510
+ comment: z.ZodObject<{
1511
+ id: z.ZodString;
1512
+ surfaceId: z.ZodString;
1513
+ author: z.ZodString;
1514
+ content: z.ZodString;
1515
+ anchorStart: z.ZodOptional<z.ZodNumber>;
1516
+ anchorEnd: z.ZodOptional<z.ZodNumber>;
1517
+ anchorText: z.ZodOptional<z.ZodString>;
1518
+ parentCommentId: z.ZodOptional<z.ZodString>;
1519
+ status: z.ZodString;
1520
+ createdAt: z.ZodNumber;
1521
+ updatedAt: z.ZodNumber;
1522
+ }, z.core.$strip>;
1523
+ }, z.core.$strip>, z.ZodObject<{
1524
+ type: z.ZodLiteral<"document_comment_deleted">;
1525
+ conversationId: z.ZodString;
1526
+ surfaceId: z.ZodString;
1527
+ commentId: z.ZodString;
1528
+ }, z.core.$strip>, z.ZodObject<{
1529
+ type: z.ZodLiteral<"document_comment_reopened">;
1530
+ conversationId: z.ZodString;
1531
+ surfaceId: z.ZodString;
1532
+ commentId: z.ZodString;
1533
+ }, z.core.$strip>, z.ZodObject<{
1534
+ type: z.ZodLiteral<"document_comment_resolved">;
1535
+ conversationId: z.ZodString;
1536
+ surfaceId: z.ZodString;
1537
+ commentId: z.ZodString;
1538
+ resolvedBy: z.ZodString;
1539
+ }, z.core.$strip>, z.ZodObject<{
1540
+ type: z.ZodLiteral<"document_editor_show">;
1541
+ conversationId: z.ZodString;
1542
+ surfaceId: z.ZodString;
1543
+ title: z.ZodString;
1544
+ initialContent: z.ZodString;
1545
+ }, z.core.$strip>, z.ZodObject<{
1546
+ type: z.ZodLiteral<"document_editor_update">;
1547
+ conversationId: z.ZodString;
1548
+ surfaceId: z.ZodString;
1549
+ markdown: z.ZodString;
1550
+ mode: z.ZodString;
1551
+ }, z.core.$strip>, z.ZodObject<{
1552
+ type: z.ZodLiteral<"error">;
1553
+ message: z.ZodString;
1554
+ code: z.ZodOptional<z.ZodString>;
1555
+ category: z.ZodOptional<z.ZodString>;
1556
+ errorCategory: z.ZodOptional<z.ZodString>;
1557
+ requestId: z.ZodOptional<z.ZodString>;
1558
+ conversationId: z.ZodOptional<z.ZodString>;
1559
+ }, z.core.$strip>, z.ZodObject<{
1560
+ type: z.ZodLiteral<"generation_cancelled">;
1561
+ conversationId: z.ZodOptional<z.ZodString>;
1562
+ }, z.core.$strip>, z.ZodObject<{
1563
+ type: z.ZodLiteral<"generation_handoff">;
1564
+ conversationId: z.ZodOptional<z.ZodString>;
1565
+ requestId: z.ZodOptional<z.ZodString>;
1566
+ queuedCount: z.ZodNumber;
1567
+ messageId: z.ZodOptional<z.ZodString>;
1568
+ attachments: z.ZodOptional<z.ZodArray<z.ZodObject<{
1569
+ id: z.ZodOptional<z.ZodString>;
1570
+ filename: z.ZodString;
1571
+ mimeType: z.ZodString;
1572
+ data: z.ZodString;
1573
+ sourceType: z.ZodOptional<z.ZodEnum<{
1574
+ host_file: "host_file";
1575
+ sandbox_file: "sandbox_file";
1576
+ tool_block: "tool_block";
1577
+ }>>;
1578
+ sizeBytes: z.ZodOptional<z.ZodNumber>;
1579
+ thumbnailData: z.ZodOptional<z.ZodString>;
1580
+ fileBacked: z.ZodOptional<z.ZodBoolean>;
1581
+ filePath: z.ZodOptional<z.ZodString>;
1582
+ }, z.core.$strip>>>;
1583
+ attachmentWarnings: z.ZodOptional<z.ZodArray<z.ZodString>>;
1584
+ }, z.core.$strip>, z.ZodObject<{
1585
+ type: z.ZodLiteral<"heartbeat_alert">;
1586
+ title: z.ZodString;
1587
+ body: z.ZodString;
1588
+ }, z.core.$strip>, z.ZodObject<{
1589
+ type: z.ZodLiteral<"heartbeat_conversation_created">;
1590
+ conversationId: z.ZodString;
1591
+ title: z.ZodString;
1592
+ }, z.core.$strip>, z.ZodObject<{
1593
+ type: z.ZodLiteral<"home_feed_updated">;
1594
+ updatedAt: z.ZodString;
1595
+ newItemCount: z.ZodNumber;
1596
+ }, z.core.$strip>, z.ZodObject<{
1597
+ type: z.ZodLiteral<"hook_event">;
1598
+ conversationId: z.ZodOptional<z.ZodString>;
1599
+ hookName: z.ZodString;
1600
+ owner: z.ZodObject<{
1601
+ kind: z.ZodEnum<{
1602
+ plugin: "plugin";
1603
+ workspace: "workspace";
1604
+ }>;
1605
+ id: z.ZodString;
1606
+ }, z.core.$strip>;
1607
+ detail: z.ZodRecord<z.ZodString, z.ZodUnknown>;
1608
+ }, z.core.$strip>, z.ZodObject<{
1609
+ type: z.ZodLiteral<"host_app_control_cancel">;
1610
+ requestId: z.ZodString;
1611
+ conversationId: z.ZodString;
1612
+ }, z.core.$strip>, z.ZodObject<{
1613
+ type: z.ZodLiteral<"host_app_control_request">;
1614
+ requestId: z.ZodString;
1615
+ conversationId: z.ZodString;
1616
+ toolName: z.ZodString;
1617
+ input: z.ZodDiscriminatedUnion<[z.ZodObject<{
1618
+ tool: z.ZodLiteral<"start">;
1619
+ app: z.ZodString;
1620
+ args: z.ZodOptional<z.ZodArray<z.ZodString>>;
1621
+ }, z.core.$strip>, z.ZodObject<{
1622
+ tool: z.ZodLiteral<"observe">;
1623
+ app: z.ZodString;
1624
+ settle_ms: z.ZodOptional<z.ZodNumber>;
1625
+ }, z.core.$strip>, z.ZodObject<{
1626
+ tool: z.ZodLiteral<"press">;
1627
+ app: z.ZodString;
1628
+ key: z.ZodString;
1629
+ modifiers: z.ZodOptional<z.ZodArray<z.ZodString>>;
1630
+ duration_ms: z.ZodOptional<z.ZodNumber>;
1631
+ }, z.core.$strip>, z.ZodObject<{
1632
+ tool: z.ZodLiteral<"combo">;
1633
+ app: z.ZodString;
1634
+ keys: z.ZodArray<z.ZodString>;
1635
+ duration_ms: z.ZodOptional<z.ZodNumber>;
1636
+ }, z.core.$strip>, z.ZodObject<{
1637
+ tool: z.ZodLiteral<"sequence">;
1638
+ app: z.ZodString;
1639
+ steps: z.ZodArray<z.ZodObject<{
1640
+ key: z.ZodString;
1641
+ modifiers: z.ZodOptional<z.ZodArray<z.ZodString>>;
1642
+ duration_ms: z.ZodOptional<z.ZodNumber>;
1643
+ gap_ms: z.ZodOptional<z.ZodNumber>;
1644
+ }, z.core.$strip>>;
1645
+ }, z.core.$strip>, z.ZodObject<{
1646
+ tool: z.ZodLiteral<"type">;
1647
+ app: z.ZodString;
1648
+ text: z.ZodString;
1649
+ }, z.core.$strip>, z.ZodObject<{
1650
+ tool: z.ZodLiteral<"click">;
1651
+ app: z.ZodString;
1652
+ x: z.ZodNumber;
1653
+ y: z.ZodNumber;
1654
+ button: z.ZodOptional<z.ZodEnum<{
1655
+ left: "left";
1656
+ right: "right";
1657
+ middle: "middle";
1658
+ }>>;
1659
+ double: z.ZodOptional<z.ZodBoolean>;
1660
+ }, z.core.$strip>, z.ZodObject<{
1661
+ tool: z.ZodLiteral<"drag">;
1662
+ app: z.ZodString;
1663
+ from_x: z.ZodNumber;
1664
+ from_y: z.ZodNumber;
1665
+ to_x: z.ZodNumber;
1666
+ to_y: z.ZodNumber;
1667
+ button: z.ZodOptional<z.ZodEnum<{
1668
+ left: "left";
1669
+ right: "right";
1670
+ middle: "middle";
1671
+ }>>;
1672
+ }, z.core.$strip>, z.ZodObject<{
1673
+ tool: z.ZodLiteral<"stop">;
1674
+ app: z.ZodOptional<z.ZodString>;
1675
+ reason: z.ZodOptional<z.ZodString>;
1676
+ }, z.core.$strip>], "tool">;
1677
+ }, z.core.$strip>, z.ZodObject<{
1678
+ type: z.ZodLiteral<"host_bash_cancel">;
1679
+ requestId: z.ZodString;
1680
+ conversationId: z.ZodString;
1681
+ targetClientId: z.ZodOptional<z.ZodString>;
1682
+ }, z.core.$strip>, z.ZodObject<{
1683
+ type: z.ZodLiteral<"host_bash_request">;
1684
+ requestId: z.ZodString;
1685
+ conversationId: z.ZodString;
1686
+ command: z.ZodString;
1687
+ working_dir: z.ZodOptional<z.ZodString>;
1688
+ timeout_seconds: z.ZodOptional<z.ZodNumber>;
1689
+ env: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
1690
+ targetClientId: z.ZodOptional<z.ZodString>;
1691
+ }, z.core.$strip>, z.ZodObject<{
1692
+ type: z.ZodLiteral<"host_browser_cancel">;
1693
+ requestId: z.ZodString;
1694
+ }, z.core.$strip>, z.ZodObject<{
1695
+ type: z.ZodLiteral<"host_browser_request">;
1696
+ requestId: z.ZodString;
1697
+ conversationId: z.ZodString;
1698
+ cdpMethod: z.ZodString;
1699
+ cdpParams: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
1700
+ cdpSessionId: z.ZodOptional<z.ZodString>;
1701
+ timeout_seconds: z.ZodOptional<z.ZodNumber>;
1702
+ }, z.core.$strip>, z.ZodObject<{
1703
+ type: z.ZodLiteral<"host_cu_cancel">;
1704
+ requestId: z.ZodString;
1705
+ conversationId: z.ZodString;
1706
+ targetClientId: z.ZodOptional<z.ZodString>;
1707
+ }, z.core.$strip>, z.ZodObject<{
1708
+ type: z.ZodLiteral<"host_cu_request">;
1709
+ requestId: z.ZodString;
1710
+ conversationId: z.ZodString;
1711
+ targetClientId: z.ZodOptional<z.ZodString>;
1712
+ toolName: z.ZodString;
1713
+ input: z.ZodRecord<z.ZodString, z.ZodUnknown>;
1714
+ stepNumber: z.ZodNumber;
1715
+ reasoning: z.ZodOptional<z.ZodString>;
1716
+ }, z.core.$strip>, z.ZodObject<{
1717
+ type: z.ZodLiteral<"host_file_cancel">;
1718
+ requestId: z.ZodString;
1719
+ conversationId: z.ZodString;
1720
+ targetClientId: z.ZodOptional<z.ZodString>;
1721
+ }, z.core.$strip>, z.ZodDiscriminatedUnion<[z.ZodObject<{
1722
+ type: z.ZodLiteral<"host_file_request">;
1723
+ requestId: z.ZodString;
1724
+ conversationId: z.ZodString;
1725
+ targetClientId: z.ZodOptional<z.ZodString>;
1726
+ operation: z.ZodLiteral<"read">;
1727
+ path: z.ZodString;
1728
+ offset: z.ZodOptional<z.ZodNumber>;
1729
+ limit: z.ZodOptional<z.ZodNumber>;
1730
+ }, z.core.$strip>, z.ZodObject<{
1731
+ type: z.ZodLiteral<"host_file_request">;
1732
+ requestId: z.ZodString;
1733
+ conversationId: z.ZodString;
1734
+ targetClientId: z.ZodOptional<z.ZodString>;
1735
+ operation: z.ZodLiteral<"write">;
1736
+ path: z.ZodString;
1737
+ content: z.ZodString;
1738
+ }, z.core.$strip>, z.ZodObject<{
1739
+ type: z.ZodLiteral<"host_file_request">;
1740
+ requestId: z.ZodString;
1741
+ conversationId: z.ZodString;
1742
+ targetClientId: z.ZodOptional<z.ZodString>;
1743
+ operation: z.ZodLiteral<"edit">;
1744
+ path: z.ZodString;
1745
+ old_string: z.ZodString;
1746
+ new_string: z.ZodString;
1747
+ replace_all: z.ZodOptional<z.ZodBoolean>;
1748
+ }, z.core.$strip>], "operation">, z.ZodObject<{
1749
+ type: z.ZodLiteral<"host_transfer_cancel">;
1750
+ requestId: z.ZodString;
1751
+ conversationId: z.ZodString;
1752
+ targetClientId: z.ZodOptional<z.ZodString>;
1753
+ }, z.core.$strip>, z.ZodDiscriminatedUnion<[z.ZodObject<{
1754
+ type: z.ZodLiteral<"host_transfer_request">;
1755
+ requestId: z.ZodString;
1756
+ conversationId: z.ZodString;
1757
+ targetClientId: z.ZodOptional<z.ZodString>;
1758
+ direction: z.ZodLiteral<"to_host">;
1759
+ transferId: z.ZodString;
1760
+ destPath: z.ZodString;
1761
+ sizeBytes: z.ZodNumber;
1762
+ sha256: z.ZodString;
1763
+ overwrite: z.ZodBoolean;
1764
+ }, z.core.$strip>, z.ZodObject<{
1765
+ type: z.ZodLiteral<"host_transfer_request">;
1766
+ requestId: z.ZodString;
1767
+ conversationId: z.ZodString;
1768
+ targetClientId: z.ZodOptional<z.ZodString>;
1769
+ direction: z.ZodLiteral<"to_sandbox">;
1770
+ transferId: z.ZodString;
1771
+ sourcePath: z.ZodString;
1772
+ }, z.core.$strip>], "direction">, z.ZodObject<{
1773
+ type: z.ZodLiteral<"host_ui_snapshot_cancel">;
1774
+ requestId: z.ZodString;
1775
+ }, z.core.$strip>, z.ZodObject<{
1776
+ type: z.ZodLiteral<"host_ui_snapshot_request">;
1777
+ requestId: z.ZodString;
1778
+ view: z.ZodEnum<{
1779
+ sampler: "sampler";
1780
+ chat: "chat";
1781
+ }>;
1782
+ tokens: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
1783
+ }, z.core.$strip>, z.ZodObject<{
1784
+ type: z.ZodLiteral<"identity_changed">;
1785
+ name: z.ZodString;
1786
+ role: z.ZodString;
1787
+ personality: z.ZodString;
1788
+ emoji: z.ZodString;
1789
+ home: z.ZodString;
1790
+ }, z.core.$strip>, z.ZodObject<{
1791
+ type: z.ZodLiteral<"interaction_resolved">;
1792
+ requestId: z.ZodString;
1793
+ conversationId: z.ZodString;
1794
+ state: z.ZodEnum<{
1795
+ cancelled: "cancelled";
1796
+ superseded: "superseded";
1797
+ approved: "approved";
1798
+ rejected: "rejected";
1799
+ answered: "answered";
1800
+ }>;
1801
+ kind: z.ZodString;
1802
+ }, z.core.$strip>, z.ZodObject<{
1803
+ type: z.ZodLiteral<"memory_recalled">;
1804
+ provider: z.ZodString;
1805
+ model: z.ZodString;
1806
+ degradation: z.ZodOptional<z.ZodObject<{
1807
+ semanticUnavailable: z.ZodBoolean;
1808
+ reason: z.ZodString;
1809
+ fallbackSources: z.ZodArray<z.ZodString>;
1810
+ }, z.core.$strip>>;
1811
+ semanticHits: z.ZodNumber;
1812
+ tier1Count: z.ZodNumber;
1813
+ tier2Count: z.ZodNumber;
1814
+ hybridSearchLatencyMs: z.ZodNumber;
1815
+ sparseVectorUsed: z.ZodBoolean;
1816
+ mergedCount: z.ZodNumber;
1817
+ selectedCount: z.ZodNumber;
1818
+ injectedTokens: z.ZodNumber;
1819
+ latencyMs: z.ZodNumber;
1820
+ topCandidates: z.ZodArray<z.ZodObject<{
1821
+ key: z.ZodString;
1822
+ type: z.ZodString;
1823
+ kind: z.ZodString;
1824
+ finalScore: z.ZodNumber;
1825
+ semantic: z.ZodNumber;
1826
+ recency: z.ZodNumber;
1827
+ }, z.core.$strip>>;
1828
+ }, z.core.$strip>, z.ZodObject<{
1829
+ type: z.ZodLiteral<"memory_status">;
1830
+ enabled: z.ZodBoolean;
1831
+ degraded: z.ZodBoolean;
1832
+ degradation: z.ZodOptional<z.ZodObject<{
1833
+ semanticUnavailable: z.ZodBoolean;
1834
+ reason: z.ZodString;
1835
+ fallbackSources: z.ZodArray<z.ZodString>;
1836
+ }, z.core.$strip>>;
1837
+ reason: z.ZodOptional<z.ZodString>;
1838
+ provider: z.ZodOptional<z.ZodString>;
1839
+ model: z.ZodOptional<z.ZodString>;
1840
+ }, z.core.$strip>, z.ZodObject<{
1841
+ type: z.ZodLiteral<"message_complete">;
1842
+ messageId: z.ZodOptional<z.ZodString>;
1843
+ conversationId: z.ZodOptional<z.ZodString>;
1844
+ source: z.ZodOptional<z.ZodEnum<{
1845
+ main: "main";
1846
+ aux: "aux";
1847
+ }>>;
1848
+ attachments: z.ZodOptional<z.ZodArray<z.ZodObject<{
1849
+ id: z.ZodOptional<z.ZodString>;
1850
+ filename: z.ZodString;
1851
+ mimeType: z.ZodString;
1852
+ data: z.ZodString;
1853
+ sourceType: z.ZodOptional<z.ZodEnum<{
1854
+ host_file: "host_file";
1855
+ sandbox_file: "sandbox_file";
1856
+ tool_block: "tool_block";
1857
+ }>>;
1858
+ sizeBytes: z.ZodOptional<z.ZodNumber>;
1859
+ thumbnailData: z.ZodOptional<z.ZodString>;
1860
+ fileBacked: z.ZodOptional<z.ZodBoolean>;
1861
+ filePath: z.ZodOptional<z.ZodString>;
1862
+ }, z.core.$strip>>>;
1863
+ attachmentWarnings: z.ZodOptional<z.ZodArray<z.ZodString>>;
1864
+ }, z.core.$strip>, z.ZodObject<{
1865
+ type: z.ZodLiteral<"message_dequeued">;
1866
+ conversationId: z.ZodString;
1867
+ requestId: z.ZodString;
1868
+ }, z.core.$strip>, z.ZodObject<{
1869
+ type: z.ZodLiteral<"message_queued">;
1870
+ conversationId: z.ZodString;
1871
+ requestId: z.ZodString;
1872
+ position: z.ZodNumber;
1873
+ }, z.core.$strip>, z.ZodObject<{
1874
+ type: z.ZodLiteral<"message_queued_deleted">;
1875
+ conversationId: z.ZodString;
1876
+ requestId: z.ZodString;
1877
+ }, z.core.$strip>, z.ZodObject<{
1878
+ type: z.ZodLiteral<"message_request_complete">;
1879
+ conversationId: z.ZodString;
1880
+ requestId: z.ZodString;
1881
+ runStillActive: z.ZodOptional<z.ZodBoolean>;
1882
+ }, z.core.$strip>, z.ZodObject<{
1883
+ type: z.ZodLiteral<"message_steered">;
1884
+ conversationId: z.ZodString;
1885
+ requestId: z.ZodString;
1886
+ }, z.core.$strip>, z.ZodObject<{
1887
+ type: z.ZodLiteral<"model_info">;
1888
+ conversationId: z.ZodOptional<z.ZodString>;
1889
+ model: z.ZodString;
1890
+ provider: z.ZodString;
1891
+ configuredProviders: z.ZodOptional<z.ZodArray<z.ZodString>>;
1892
+ availableModels: z.ZodOptional<z.ZodArray<z.ZodObject<{
1893
+ id: z.ZodString;
1894
+ displayName: z.ZodString;
1895
+ }, z.core.$strip>>>;
1896
+ allProviders: z.ZodOptional<z.ZodArray<z.ZodObject<{
1897
+ id: z.ZodString;
1898
+ displayName: z.ZodString;
1899
+ models: z.ZodArray<z.ZodObject<{
1900
+ id: z.ZodString;
1901
+ displayName: z.ZodString;
1902
+ }, z.core.$strip>>;
1903
+ defaultModel: z.ZodString;
1904
+ apiKeyUrl: z.ZodOptional<z.ZodString>;
1905
+ apiKeyPlaceholder: z.ZodOptional<z.ZodString>;
1906
+ }, z.core.$strip>>>;
1907
+ }, z.core.$strip>, z.ZodObject<{
1908
+ type: z.ZodLiteral<"navigate_settings">;
1909
+ tab: z.ZodString;
1910
+ }, z.core.$strip>, z.ZodObject<{
1911
+ type: z.ZodLiteral<"notification_conversation_created">;
1912
+ conversationId: z.ZodString;
1913
+ title: z.ZodString;
1914
+ sourceEventName: z.ZodString;
1915
+ targetGuardianPrincipalId: z.ZodOptional<z.ZodString>;
1916
+ groupId: z.ZodOptional<z.ZodString>;
1917
+ source: z.ZodOptional<z.ZodString>;
1918
+ silent: z.ZodOptional<z.ZodBoolean>;
1919
+ }, z.core.$strip>, z.ZodObject<{
1920
+ type: z.ZodLiteral<"notification_intent">;
1921
+ sourceEventName: z.ZodString;
1922
+ title: z.ZodString;
1923
+ body: z.ZodString;
1924
+ deliveryId: z.ZodOptional<z.ZodString>;
1925
+ deepLinkMetadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
1926
+ targetGuardianPrincipalId: z.ZodOptional<z.ZodString>;
1927
+ silent: z.ZodOptional<z.ZodBoolean>;
1928
+ }, z.core.$strip>, z.ZodObject<{
1929
+ type: z.ZodLiteral<"oauth_connect_result">;
1930
+ success: z.ZodBoolean;
1931
+ service: z.ZodOptional<z.ZodString>;
1932
+ grantedScopes: z.ZodOptional<z.ZodArray<z.ZodString>>;
1933
+ accountInfo: z.ZodOptional<z.ZodString>;
1934
+ error: z.ZodOptional<z.ZodString>;
1935
+ }, z.core.$strip>, z.ZodObject<{
1936
+ type: z.ZodLiteral<"open_conversation">;
1937
+ conversationId: z.ZodString;
1938
+ title: z.ZodOptional<z.ZodString>;
1939
+ anchorMessageId: z.ZodOptional<z.ZodString>;
1940
+ focus: z.ZodOptional<z.ZodBoolean>;
1941
+ }, z.core.$strip>, z.ZodObject<{
1942
+ type: z.ZodLiteral<"open_panel">;
1943
+ panelType: z.ZodString;
1944
+ data: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
1945
+ conversationId: z.ZodOptional<z.ZodString>;
1946
+ surfaceId: z.ZodOptional<z.ZodString>;
1947
+ }, z.core.$strip>, z.ZodObject<{
1948
+ type: z.ZodLiteral<"open_url">;
1949
+ url: z.ZodString;
1950
+ title: z.ZodOptional<z.ZodString>;
1951
+ conversationId: z.ZodOptional<z.ZodString>;
1952
+ }, z.core.$strip>, z.ZodObject<{
1953
+ type: z.ZodLiteral<"platform_disconnected">;
1954
+ }, z.core.$strip>, z.ZodObject<{
1955
+ type: z.ZodLiteral<"question_request">;
1956
+ requestId: z.ZodString;
1957
+ questions: z.ZodArray<z.ZodObject<{
1958
+ id: z.ZodString;
1959
+ question: z.ZodString;
1960
+ description: z.ZodOptional<z.ZodString>;
1961
+ options: z.ZodArray<z.ZodObject<{
1962
+ id: z.ZodString;
1963
+ label: z.ZodString;
1964
+ description: z.ZodOptional<z.ZodString>;
1965
+ }, z.core.$strip>>;
1966
+ freeTextPlaceholder: z.ZodOptional<z.ZodString>;
1967
+ }, z.core.$strip>>;
1968
+ question: z.ZodString;
1969
+ description: z.ZodOptional<z.ZodString>;
1970
+ options: z.ZodArray<z.ZodObject<{
1971
+ id: z.ZodString;
1972
+ label: z.ZodString;
1973
+ description: z.ZodOptional<z.ZodString>;
1974
+ }, z.core.$strip>>;
1975
+ freeTextPlaceholder: z.ZodOptional<z.ZodString>;
1976
+ conversationId: z.ZodOptional<z.ZodString>;
1977
+ toolUseId: z.ZodOptional<z.ZodString>;
1978
+ }, z.core.$strip>, z.ZodObject<{
1979
+ type: z.ZodLiteral<"recording_pause">;
1980
+ recordingId: z.ZodString;
1981
+ }, z.core.$strip>, z.ZodObject<{
1982
+ type: z.ZodLiteral<"recording_resume">;
1983
+ recordingId: z.ZodString;
1984
+ }, z.core.$strip>, z.ZodObject<{
1985
+ type: z.ZodLiteral<"recording_start">;
1986
+ recordingId: z.ZodString;
1987
+ attachToConversationId: z.ZodOptional<z.ZodString>;
1988
+ options: z.ZodOptional<z.ZodObject<{
1989
+ captureScope: z.ZodOptional<z.ZodEnum<{
1990
+ display: "display";
1991
+ window: "window";
1992
+ }>>;
1993
+ displayId: z.ZodOptional<z.ZodString>;
1994
+ windowId: z.ZodOptional<z.ZodNumber>;
1995
+ includeAudio: z.ZodOptional<z.ZodBoolean>;
1996
+ includeMicrophone: z.ZodOptional<z.ZodBoolean>;
1997
+ promptForSource: z.ZodOptional<z.ZodBoolean>;
1998
+ }, z.core.$strip>>;
1999
+ operationToken: z.ZodOptional<z.ZodString>;
2000
+ }, z.core.$strip>, z.ZodObject<{
2001
+ type: z.ZodLiteral<"recording_stop">;
2002
+ recordingId: z.ZodString;
2003
+ }, z.core.$strip>, z.ZodObject<{
2004
+ type: z.ZodLiteral<"relationship_state_updated">;
2005
+ updatedAt: z.ZodString;
2006
+ }, z.core.$strip>, z.ZodObject<{
2007
+ type: z.ZodLiteral<"schedule_conversation_created">;
2008
+ conversationId: z.ZodString;
2009
+ scheduleJobId: z.ZodString;
2010
+ title: z.ZodString;
2011
+ }, z.core.$strip>, z.ZodObject<{
2012
+ type: z.ZodLiteral<"secret_request">;
2013
+ requestId: z.ZodString;
2014
+ service: z.ZodString;
2015
+ field: z.ZodString;
2016
+ label: z.ZodString;
2017
+ description: z.ZodOptional<z.ZodString>;
2018
+ placeholder: z.ZodOptional<z.ZodString>;
2019
+ conversationId: z.ZodOptional<z.ZodString>;
2020
+ purpose: z.ZodOptional<z.ZodString>;
2021
+ allowedTools: z.ZodOptional<z.ZodArray<z.ZodString>>;
2022
+ allowedDomains: z.ZodOptional<z.ZodArray<z.ZodString>>;
2023
+ allowOneTimeSend: z.ZodOptional<z.ZodBoolean>;
2024
+ }, z.core.$strip>, z.ZodObject<{
2025
+ type: z.ZodLiteral<"service_group_update_complete">;
2026
+ installedVersion: z.ZodString;
2027
+ success: z.ZodBoolean;
2028
+ rolledBackToVersion: z.ZodOptional<z.ZodString>;
2029
+ }, z.core.$strip>, z.ZodObject<{
2030
+ type: z.ZodLiteral<"service_group_update_progress">;
2031
+ statusMessage: z.ZodString;
2032
+ }, z.core.$strip>, z.ZodObject<{
2033
+ type: z.ZodLiteral<"service_group_update_starting">;
2034
+ targetVersion: z.ZodString;
2035
+ expectedDowntimeSeconds: z.ZodNumber;
2036
+ }, z.core.$strip>, z.ZodObject<{
2037
+ type: z.ZodLiteral<"show_platform_login">;
2038
+ }, z.core.$strip>, z.ZodObject<{
2039
+ type: z.ZodLiteral<"skills_state_changed">;
2040
+ name: z.ZodString;
2041
+ state: z.ZodEnum<{
2042
+ enabled: "enabled";
2043
+ disabled: "disabled";
2044
+ installed: "installed";
2045
+ uninstalled: "uninstalled";
2046
+ }>;
2047
+ }, z.core.$strip>, z.ZodObject<{
2048
+ type: z.ZodLiteral<"sounds_config_updated">;
2049
+ }, z.core.$strip>, z.ZodObject<{
2050
+ type: z.ZodLiteral<"subagent_event">;
2051
+ conversationId: z.ZodString;
2052
+ subagentId: z.ZodString;
2053
+ event: z.ZodObject<{
2054
+ type: z.ZodString;
2055
+ content: z.ZodOptional<z.ZodString>;
2056
+ text: z.ZodOptional<z.ZodString>;
2057
+ result: z.ZodOptional<z.ZodString>;
2058
+ input: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
2059
+ toolName: z.ZodOptional<z.ZodString>;
2060
+ isError: z.ZodOptional<z.ZodBoolean>;
2061
+ toolUseId: z.ZodOptional<z.ZodString>;
2062
+ }, z.core.$loose>;
2063
+ }, z.core.$strict>, z.ZodObject<{
2064
+ type: z.ZodLiteral<"subagent_spawned">;
2065
+ subagentId: z.ZodString;
2066
+ parentConversationId: z.ZodString;
2067
+ label: z.ZodString;
2068
+ objective: z.ZodString;
2069
+ isFork: z.ZodOptional<z.ZodBoolean>;
2070
+ parentToolUseId: z.ZodOptional<z.ZodString>;
2071
+ }, z.core.$strict>, z.ZodObject<{
2072
+ type: z.ZodLiteral<"subagent_status_changed">;
2073
+ subagentId: z.ZodString;
2074
+ status: z.ZodEnum<{
2075
+ completed: "completed";
2076
+ failed: "failed";
2077
+ pending: "pending";
2078
+ running: "running";
2079
+ awaiting_input: "awaiting_input";
2080
+ aborted: "aborted";
2081
+ interrupted: "interrupted";
2082
+ }>;
2083
+ error: z.ZodOptional<z.ZodString>;
2084
+ usage: z.ZodOptional<z.ZodObject<{
2085
+ inputTokens: z.ZodNumber;
2086
+ outputTokens: z.ZodNumber;
2087
+ estimatedCost: z.ZodNumber;
2088
+ }, z.core.$strict>>;
2089
+ }, z.core.$strict>, z.ZodObject<{
2090
+ type: z.ZodLiteral<"sync_changed">;
2091
+ tags: z.ZodArray<z.ZodString>;
2092
+ originClientId: z.ZodOptional<z.ZodString>;
2093
+ }, z.core.$strip>, z.ZodObject<{
2094
+ type: z.ZodLiteral<"tool_input_delta">;
2095
+ toolName: z.ZodString;
2096
+ content: z.ZodString;
2097
+ conversationId: z.ZodOptional<z.ZodString>;
2098
+ toolUseId: z.ZodOptional<z.ZodString>;
2099
+ messageId: z.ZodOptional<z.ZodString>;
2100
+ }, z.core.$strip>, z.ZodObject<{
2101
+ type: z.ZodLiteral<"tool_output_chunk">;
2102
+ chunk: z.ZodString;
2103
+ conversationId: z.ZodOptional<z.ZodString>;
2104
+ toolUseId: z.ZodOptional<z.ZodString>;
2105
+ subType: z.ZodOptional<z.ZodEnum<{
2106
+ status: "status";
2107
+ tool_start: "tool_start";
2108
+ tool_complete: "tool_complete";
2109
+ }>>;
2110
+ subToolName: z.ZodOptional<z.ZodString>;
2111
+ subToolInput: z.ZodOptional<z.ZodString>;
2112
+ subToolIsError: z.ZodOptional<z.ZodBoolean>;
2113
+ subToolId: z.ZodOptional<z.ZodString>;
2114
+ messageId: z.ZodOptional<z.ZodString>;
2115
+ }, z.core.$strip>, z.ZodObject<{
2116
+ type: z.ZodLiteral<"tool_result">;
2117
+ toolName: z.ZodString;
2118
+ result: z.ZodString;
2119
+ isError: z.ZodOptional<z.ZodBoolean>;
2120
+ diff: z.ZodOptional<z.ZodObject<{
2121
+ filePath: z.ZodString;
2122
+ oldContent: z.ZodString;
2123
+ newContent: z.ZodString;
2124
+ isNewFile: z.ZodBoolean;
2125
+ }, z.core.$strip>>;
2126
+ status: z.ZodOptional<z.ZodString>;
2127
+ conversationId: z.ZodOptional<z.ZodString>;
2128
+ imageData: z.ZodOptional<z.ZodString>;
2129
+ imageDataList: z.ZodOptional<z.ZodArray<z.ZodString>>;
2130
+ toolUseId: z.ZodOptional<z.ZodString>;
2131
+ messageId: z.ZodOptional<z.ZodString>;
2132
+ riskLevel: z.ZodOptional<z.ZodString>;
2133
+ riskReason: z.ZodOptional<z.ZodString>;
2134
+ matchedTrustRuleId: z.ZodOptional<z.ZodString>;
2135
+ isContainerized: z.ZodOptional<z.ZodBoolean>;
2136
+ riskScopeOptions: z.ZodOptional<z.ZodArray<z.ZodObject<{
2137
+ pattern: z.ZodString;
2138
+ label: z.ZodString;
2139
+ }, z.core.$strip>>>;
2140
+ riskAllowlistOptions: z.ZodOptional<z.ZodArray<z.ZodObject<{
2141
+ label: z.ZodString;
2142
+ description: z.ZodString;
2143
+ pattern: z.ZodString;
2144
+ }, z.core.$strip>>>;
2145
+ riskDirectoryScopeOptions: z.ZodOptional<z.ZodArray<z.ZodObject<{
2146
+ label: z.ZodString;
2147
+ scope: z.ZodString;
2148
+ }, z.core.$strip>>>;
2149
+ approvalMode: z.ZodOptional<z.ZodString>;
2150
+ approvalReason: z.ZodOptional<z.ZodString>;
2151
+ riskThreshold: z.ZodOptional<z.ZodString>;
2152
+ activityMetadata: z.ZodOptional<z.ZodObject<{
2153
+ webSearch: z.ZodOptional<z.ZodObject<{
2154
+ query: z.ZodString;
2155
+ provider: z.ZodEnum<{
2156
+ "anthropic-native": "anthropic-native";
2157
+ brave: "brave";
2158
+ perplexity: "perplexity";
2159
+ tavily: "tavily";
2160
+ firecrawl: "firecrawl";
2161
+ }>;
2162
+ resultCount: z.ZodNumber;
2163
+ durationMs: z.ZodNumber;
2164
+ results: z.ZodArray<z.ZodObject<{
2165
+ rank: z.ZodNumber;
2166
+ title: z.ZodString;
2167
+ url: z.ZodString;
2168
+ domain: z.ZodString;
2169
+ faviconUrl: z.ZodOptional<z.ZodString>;
2170
+ snippet: z.ZodOptional<z.ZodString>;
2171
+ age: z.ZodOptional<z.ZodString>;
2172
+ score: z.ZodOptional<z.ZodNumber>;
2173
+ }, z.core.$strip>>;
2174
+ errorMessage: z.ZodOptional<z.ZodString>;
2175
+ }, z.core.$strip>>;
2176
+ webFetch: z.ZodOptional<z.ZodObject<{
2177
+ url: z.ZodString;
2178
+ finalUrl: z.ZodString;
2179
+ provider: z.ZodOptional<z.ZodEnum<{
2180
+ default: "default";
2181
+ firecrawl: "firecrawl";
2182
+ }>>;
2183
+ status: z.ZodNumber;
2184
+ contentType: z.ZodOptional<z.ZodString>;
2185
+ byteCount: z.ZodNumber;
2186
+ charCount: z.ZodNumber;
2187
+ truncated: z.ZodBoolean;
2188
+ title: z.ZodOptional<z.ZodString>;
2189
+ domain: z.ZodString;
2190
+ faviconUrl: z.ZodOptional<z.ZodString>;
2191
+ redirectCount: z.ZodNumber;
2192
+ durationMs: z.ZodNumber;
2193
+ errorMessage: z.ZodOptional<z.ZodString>;
2194
+ mayRequireJavaScript: z.ZodOptional<z.ZodBoolean>;
2195
+ }, z.core.$strip>>;
2196
+ }, z.core.$strip>>;
2197
+ errorCode: z.ZodOptional<z.ZodString>;
2198
+ completedAt: z.ZodOptional<z.ZodNumber>;
2199
+ }, z.core.$strip>, z.ZodObject<{
2200
+ type: z.ZodLiteral<"tool_use_preview_start">;
2201
+ toolUseId: z.ZodString;
2202
+ toolName: z.ZodString;
2203
+ conversationId: z.ZodOptional<z.ZodString>;
2204
+ messageId: z.ZodOptional<z.ZodString>;
2205
+ previewStartedAt: z.ZodOptional<z.ZodNumber>;
2206
+ }, z.core.$strip>, z.ZodObject<{
2207
+ type: z.ZodLiteral<"tool_use_start">;
2208
+ toolName: z.ZodString;
2209
+ input: z.ZodRecord<z.ZodString, z.ZodUnknown>;
2210
+ toolUseId: z.ZodOptional<z.ZodString>;
2211
+ messageId: z.ZodOptional<z.ZodString>;
2212
+ conversationId: z.ZodOptional<z.ZodString>;
2213
+ startedAt: z.ZodOptional<z.ZodNumber>;
2214
+ previewStartedAt: z.ZodOptional<z.ZodNumber>;
2215
+ }, z.core.$strip>, z.ZodObject<{
2216
+ type: z.ZodLiteral<"ui_surface_complete">;
2217
+ conversationId: z.ZodString;
2218
+ surfaceId: z.ZodString;
2219
+ summary: z.ZodString;
2220
+ submittedData: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
2221
+ }, z.core.$strip>, z.ZodObject<{
2222
+ type: z.ZodLiteral<"ui_surface_dismiss">;
2223
+ conversationId: z.ZodString;
2224
+ surfaceId: z.ZodString;
2225
+ }, z.core.$strip>, z.ZodObject<{
2226
+ type: z.ZodLiteral<"ui_surface_show">;
2227
+ conversationId: z.ZodString;
2228
+ surfaceId: z.ZodString;
2229
+ surfaceType: z.ZodString;
2230
+ title: z.ZodOptional<z.ZodString>;
2231
+ data: z.ZodRecord<z.ZodString, z.ZodUnknown>;
2232
+ actions: z.ZodOptional<z.ZodArray<z.ZodObject<{
2233
+ id: z.ZodString;
2234
+ label: z.ZodString;
2235
+ style: z.ZodOptional<z.ZodEnum<{
2236
+ primary: "primary";
2237
+ secondary: "secondary";
2238
+ destructive: "destructive";
2239
+ }>>;
2240
+ data: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
2241
+ }, z.core.$strip>>>;
2242
+ display: z.ZodOptional<z.ZodEnum<{
2243
+ inline: "inline";
2244
+ panel: "panel";
2245
+ }>>;
2246
+ messageId: z.ZodOptional<z.ZodString>;
2247
+ persistent: z.ZodOptional<z.ZodBoolean>;
2248
+ toolCallId: z.ZodOptional<z.ZodString>;
2249
+ }, z.core.$strip>, z.ZodObject<{
2250
+ type: z.ZodLiteral<"ui_surface_undo_result">;
2251
+ conversationId: z.ZodString;
2252
+ surfaceId: z.ZodString;
2253
+ success: z.ZodBoolean;
2254
+ remainingUndos: z.ZodNumber;
2255
+ }, z.core.$strip>, z.ZodObject<{
2256
+ type: z.ZodLiteral<"ui_surface_update">;
2257
+ conversationId: z.ZodString;
2258
+ surfaceId: z.ZodString;
2259
+ data: z.ZodRecord<z.ZodString, z.ZodUnknown>;
2260
+ }, z.core.$strip>, z.ZodObject<{
2261
+ type: z.ZodLiteral<"usage_progress">;
2262
+ conversationId: z.ZodString;
2263
+ inputTokens: z.ZodNumber;
2264
+ outputTokens: z.ZodNumber;
2265
+ estimatedCost: z.ZodNumber;
2266
+ model: z.ZodString;
2267
+ }, z.core.$strip>, z.ZodObject<{
2268
+ type: z.ZodLiteral<"usage_update">;
2269
+ conversationId: z.ZodString;
2270
+ inputTokens: z.ZodNumber;
2271
+ outputTokens: z.ZodNumber;
2272
+ cacheCreationInputTokens: z.ZodOptional<z.ZodNumber>;
2273
+ cacheReadInputTokens: z.ZodOptional<z.ZodNumber>;
2274
+ totalInputTokens: z.ZodNumber;
2275
+ totalOutputTokens: z.ZodNumber;
2276
+ estimatedCost: z.ZodNumber;
2277
+ model: z.ZodString;
2278
+ contextWindowTokens: z.ZodOptional<z.ZodNumber>;
2279
+ contextWindowMaxTokens: z.ZodOptional<z.ZodNumber>;
2280
+ }, z.core.$strip>, z.ZodObject<{
2281
+ type: z.ZodLiteral<"user_message_echo">;
2282
+ text: z.ZodString;
2283
+ conversationId: z.ZodOptional<z.ZodString>;
2284
+ messageId: z.ZodOptional<z.ZodString>;
2285
+ requestId: z.ZodOptional<z.ZodString>;
2286
+ clientMessageId: z.ZodOptional<z.ZodString>;
2287
+ }, z.core.$strict>, z.ZodObject<{
2288
+ type: z.ZodLiteral<"workflow_completed">;
2289
+ runId: z.ZodString;
2290
+ conversationId: z.ZodOptional<z.ZodString>;
2291
+ status: z.ZodEnum<{
2292
+ completed: "completed";
2293
+ failed: "failed";
2294
+ running: "running";
2295
+ aborted: "aborted";
2296
+ interrupted: "interrupted";
2297
+ cap_exceeded: "cap_exceeded";
2298
+ }>;
2299
+ agentsSpawned: z.ZodNumber;
2300
+ inputTokens: z.ZodNumber;
2301
+ outputTokens: z.ZodNumber;
2302
+ summary: z.ZodOptional<z.ZodString>;
2303
+ }, z.core.$strict>, z.ZodObject<{
2304
+ type: z.ZodLiteral<"workflow_leaf_finished">;
2305
+ runId: z.ZodString;
2306
+ conversationId: z.ZodString;
2307
+ seq: z.ZodNumber;
2308
+ status: z.ZodEnum<{
2309
+ completed: "completed";
2310
+ failed: "failed";
2311
+ }>;
2312
+ label: z.ZodOptional<z.ZodString>;
2313
+ inputTokens: z.ZodOptional<z.ZodNumber>;
2314
+ outputTokens: z.ZodOptional<z.ZodNumber>;
2315
+ resultSummary: z.ZodOptional<z.ZodString>;
2316
+ }, z.core.$strict>, z.ZodObject<{
2317
+ type: z.ZodLiteral<"workflow_leaf_started">;
2318
+ runId: z.ZodString;
2319
+ conversationId: z.ZodString;
2320
+ seq: z.ZodNumber;
2321
+ label: z.ZodOptional<z.ZodString>;
2322
+ phase: z.ZodOptional<z.ZodString>;
2323
+ promptSummary: z.ZodOptional<z.ZodString>;
2324
+ }, z.core.$strict>, z.ZodObject<{
2325
+ type: z.ZodLiteral<"workflow_progress">;
2326
+ runId: z.ZodString;
2327
+ conversationId: z.ZodOptional<z.ZodString>;
2328
+ agentsSpawned: z.ZodNumber;
2329
+ phase: z.ZodOptional<z.ZodString>;
2330
+ label: z.ZodOptional<z.ZodString>;
2331
+ message: z.ZodOptional<z.ZodString>;
2332
+ }, z.core.$strict>, z.ZodObject<{
2333
+ type: z.ZodLiteral<"workflow_started">;
2334
+ runId: z.ZodString;
2335
+ conversationId: z.ZodString;
2336
+ toolUseId: z.ZodOptional<z.ZodString>;
2337
+ label: z.ZodOptional<z.ZodString>;
2338
+ }, z.core.$strict>], "type">;
2339
+ }, z.core.$strip>;
2340
+
2341
+ /** Filter that determines which events a subscriber receives. */
2342
+ export declare type AssistantEventFilter = {
2343
+ /** When set, restrict delivery to events for this conversation. */
2344
+ conversationId?: string;
2345
+ };
2346
+
2347
+ /**
2348
+ * Lightweight pub/sub hub for `AssistantEvent` messages.
2349
+ *
2350
+ * Filtering is applied at subscription level:
2351
+ * - `conversationId`: scoped events match subscribers with same conversationId
2352
+ * or no conversationId filter (broadcast to all).
2353
+ * - `targetCapability` (on publish): targeted events only reach subscribers
2354
+ * whose capabilities include the target. Untargeted events fan out to all.
2355
+ *
2356
+ * Client connections register as subscribers with metadata and are queryable
2357
+ * via `listClients()`, `getMostRecentClientByCapability()`, etc.
2358
+ */
2359
+ export declare class AssistantEventHub {
2360
+ private readonly subscribers;
2361
+ private readonly maxSubscribers;
2362
+ /** Monotonic source for per-connection ids, scoped to this hub. */
2363
+ private connectionCounter;
2364
+ constructor(options?: {
2365
+ maxSubscribers?: number;
2366
+ });
2367
+ /**
2368
+ * Register a subscriber that will be called for each matching event.
2369
+ *
2370
+ * **Client deduplication:** When a client subscriber is registered with a
2371
+ * `clientId` that already exists, all stale entries for that clientId are
2372
+ * disposed first. This prevents subscriber stacking when clients reconnect
2373
+ * (e.g. Chrome extension reload, SSE token refresh) before the old
2374
+ * connection's abort signal fires.
2375
+ *
2376
+ * When the subscriber cap (`maxSubscribers`) has been reached, the **oldest**
2377
+ * subscriber is evicted to make room: its `onEvict` callback is invoked (so
2378
+ * it can close its SSE stream) and its entry is removed from the hub.
2379
+ */
2380
+ subscribe(subscriber: SubscriberInput): AssistantEventSubscription;
2381
+ /**
2382
+ * Publish an event to all matching subscribers.
2383
+ *
2384
+ * Matching rules:
2385
+ * - if `excludeClientId` is set, the subscriber with that clientId is
2386
+ * skipped regardless of every other rule (self-echo suppression — the
2387
+ * client that originated the mutation does not receive its own
2388
+ * invalidation back through the hub).
2389
+ * - if `targetClientId` is set, deliver only to the subscriber with that
2390
+ * clientId, bypassing the conversation-id filter entirely (the web-origin
2391
+ * event's conversationId differs from the macOS client's subscribed
2392
+ * conversation).
2393
+ * - if `filter.conversationId` is set (and `targetClientId` is not), the
2394
+ * `event.conversationId` must equal it
2395
+ * - if `targetCapability` is set, only subscribers whose capabilities include
2396
+ * it receive the event; untargeted events go to all
2397
+ * - if `targetInterfaceId` is set, only client subscribers whose
2398
+ * `interfaceId` matches receive the event; process subscribers and
2399
+ * non-matching clients are skipped. Used to narrow legacy
2400
+ * broadcasts (e.g. `conversation_list_invalidated`) to a specific
2401
+ * client surface during a migration window.
2402
+ *
2403
+ * Fanout is isolated: a throwing or rejecting subscriber does not abort
2404
+ * delivery to remaining subscribers.
2405
+ */
2406
+ publish(event: AssistantEvent, options?: {
2407
+ targetCapability?: HostProxyCapability;
2408
+ targetClientId?: string;
2409
+ targetInterfaceId?: InterfaceId;
2410
+ /**
2411
+ * Skip the subscriber with this `clientId`. Used for self-echo
2412
+ * suppression on `sync_changed`: the route handler echoes the
2413
+ * originating tab's `X-Vellum-Client-Id` back on the event, and the
2414
+ * hub uses it here to avoid re-delivering the invalidation to the
2415
+ * tab that already mutated its own optimistic state.
2416
+ */
2417
+ excludeClientId?: string;
2418
+ }): Promise<void>;
2419
+ /**
2420
+ * Return the active client subscriber with the given clientId, or
2421
+ * `undefined` if no such subscriber exists.
2422
+ */
2423
+ getClientById(clientId: string): ClientEntry | undefined;
2424
+ /**
2425
+ * Return the verified actor principal id captured at SSE subscription time
2426
+ * for the given client, or `undefined` if the client is unknown or
2427
+ * connected without a principal (e.g. legacy/service tokens).
2428
+ *
2429
+ * Used by host proxies to bind cross-client targeted execution to the same
2430
+ * authenticated user identity that opened the target client's SSE stream.
2431
+ */
2432
+ getActorPrincipalIdForClient(clientId: string): string | undefined;
2433
+ /**
2434
+ * Returns true when at least one active subscriber would receive the given
2435
+ * event based on the same conversation matching rules as publish().
2436
+ */
2437
+ hasSubscribersForEvent(event: Pick<AssistantEvent, "conversationId">): boolean;
2438
+ private clientEntries;
2439
+ /**
2440
+ * Return all active client subscribers, sorted by `lastActiveAt` descending.
2441
+ */
2442
+ listClients(): ClientEntry[];
2443
+ /**
2444
+ * Return all client subscribers that support the given capability,
2445
+ * sorted by `lastActiveAt` descending.
2446
+ */
2447
+ listClientsByCapability(capability: HostProxyCapability): ClientEntry[];
2448
+ /**
2449
+ * Return the most recently active client that supports the given
2450
+ * capability, or `undefined` if none exists.
2451
+ */
2452
+ getMostRecentClientByCapability(capability: HostProxyCapability): ClientEntry | undefined;
2453
+ /**
2454
+ * Return all client subscribers with the given interface type,
2455
+ * sorted by `lastActiveAt` descending.
2456
+ */
2457
+ listClientsByInterface(interfaceId: InterfaceId): ClientEntry[];
2458
+ /**
2459
+ * Touch a client subscriber — update `lastActiveAt`. Used by heartbeat.
2460
+ */
2461
+ touchClient(clientId: string): void;
2462
+ /**
2463
+ * Force-disconnect a client by disposing all subscribers for the given
2464
+ * `clientId`. Returns the number of disposed entries.
2465
+ *
2466
+ * Used by `assistant clients disconnect <clientId>` to forcibly remove
2467
+ * stale or unwanted client connections.
2468
+ */
2469
+ disposeClient(clientId: string): number;
2470
+ /** Number of currently active subscribers (useful for tests and caps). */
2471
+ subscriberCount(): number;
2472
+ /** Returns true if the hub can accept a subscriber without evicting anyone. */
2473
+ hasCapacity(): boolean;
2474
+ }
2475
+
2476
+ /** The plugin-facing event hub. See module docs. */
2477
+ export declare const assistantEventHub: PluginEventHub;
2478
+
2479
+ /** Opaque handle returned by `subscribe`. Call `dispose()` to remove the subscription. */
2480
+ export declare interface AssistantEventSubscription {
2481
+ dispose(): void;
2482
+ /** True until `dispose()` has been called. */
2483
+ readonly active: boolean;
2484
+ /**
2485
+ * Per-connection identifier, unique within the hub instance. Distinguishes
2486
+ * connections that share a `clientId` (e.g. an old connection and the new
2487
+ * one that replaced it on reconnect) so subscribe / dispose / shed log
2488
+ * lines can be attributed to a specific connection.
2489
+ */
2490
+ readonly connectionId: string;
2491
+ }
2492
+
2493
+ declare interface AudioEmbeddingInput {
2494
+ type: "audio";
2495
+ data: Buffer;
2496
+ mimeType: string;
2497
+ }
2498
+
2499
+ /**
2500
+ * Media payload for an image or file content block. One unified type covers
2501
+ * both blocks and both storage forms:
2502
+ *
2503
+ * - `base64` — the bytes travel inline with the block. This is the runtime
2504
+ * shape the provider transforms consume and the shape produced for a live
2505
+ * (in-flight) turn.
2506
+ * - `workspace_ref` — the bytes live somewhere in the workspace, not inline.
2507
+ * This is the shape PERSISTED into `messages.content`, keeping large blobs
2508
+ * out of the DB row and the lexical index. It is resolved back to inline
2509
+ * bytes at the provider send boundary (`providers/media-resolve.ts`); any
2510
+ * consumer that needs the raw bytes from stored content resolves it with
2511
+ * `resolveMediaSourceData(source)`.
2512
+ *
2513
+ * `filename` is optional on both arms (present for file blocks and for
2514
+ * generated-media references). For references, `sizeBytes` (and, for images,
2515
+ * `width`/`height`) are captured at persist time so size-only consumers — the
2516
+ * per-turn token estimator especially — can cost the block without reading the
2517
+ * file back off disk.
2518
+ */
2519
+ declare interface Base64MediaSource {
2520
+ type: "base64";
2521
+ media_type: string;
2522
+ data: string;
2523
+ filename?: string;
2524
+ }
2525
+
2526
+ /**
2527
+ * Capabilities shared by every chain-hook context (`user-prompt-submit`,
2528
+ * `post-compact`, `post-tool-use`, `stop`, `pre-model-call`,
2529
+ * `post-model-call`).
2530
+ *
2531
+ * Both are stamped onto each hook's draft by the pipeline (`runHook`) before
2532
+ * the hook runs, bound to that hook's identity — dispatching call sites
2533
+ * construct the `XInputContext` shapes and never supply these.
2534
+ */
2535
+ declare interface BaseHookContext {
2536
+ /**
2537
+ * Logger bound to the emitting hook — pre-tagged with the hook name and
2538
+ * owning plugin (plus `conversationId` / `requestId` when the dispatching
2539
+ * context carries them), so hook log lines are attributed without manual
2540
+ * tagging.
2541
+ */
2542
+ readonly logger: PluginLogger;
2543
+ /**
1559
2544
  * Per-hook `hook_event` emitter, bound to this hook's owner — see
1560
2545
  * {@link HookBroadcast}.
1561
2546
  */
@@ -1578,31 +2563,6 @@ declare interface BaseSubscriberEntry {
1578
2563
  connectionId: string;
1579
2564
  }
1580
2565
 
1581
- declare type BookmarkCreatedEvent = z.infer<typeof BookmarkCreatedEventSchema>;
1582
-
1583
- declare const BookmarkCreatedEventSchema: z.ZodObject<{
1584
- type: z.ZodLiteral<"bookmark.created">;
1585
- bookmark: z.ZodObject<{
1586
- id: z.ZodString;
1587
- messageId: z.ZodString;
1588
- conversationId: z.ZodString;
1589
- conversationTitle: z.ZodNullable<z.ZodString>;
1590
- messagePreview: z.ZodString;
1591
- messageRole: z.ZodString;
1592
- messageCreatedAt: z.ZodNumber;
1593
- createdAt: z.ZodNumber;
1594
- }, z.core.$strip>;
1595
- }, z.core.$strip>;
1596
-
1597
- declare type BookmarkDeletedEvent = z.infer<typeof BookmarkDeletedEventSchema>;
1598
-
1599
- declare const BookmarkDeletedEventSchema: z.ZodObject<{
1600
- type: z.ZodLiteral<"bookmark.deleted">;
1601
- messageId: z.ZodString;
1602
- }, z.core.$strip>;
1603
-
1604
- declare type _BookmarksServerMessages = BookmarkCreatedEvent | BookmarkDeletedEvent;
1605
-
1606
2566
  /**
1607
2567
  * Build a model-facing excerpt of stored message content around a query,
1608
2568
  * preserving external-content envelopes so third-party boundaries stay
@@ -1610,68 +2570,6 @@ declare type _BookmarksServerMessages = BookmarkCreatedEvent | BookmarkDeletedEv
1610
2570
  */
1611
2571
  export declare function buildMessageExcerpt(rawContent: string, query: string): Promise<string>;
1612
2572
 
1613
- /**
1614
- * Canonical channel-id vocabulary shared between the assistant daemon and the
1615
- * gateway.
1616
- *
1617
- * A "channel" is an external messaging surface an actor can reach the
1618
- * assistant through (Slack, Telegram, WhatsApp, phone, …) plus a couple of
1619
- * internal ids (`vellum` for native app conversations, `platform` for the
1620
- * internal control plane). This is the single source of truth for that set:
1621
- * the assistant adopts it wholesale as its `ChannelId`, and the gateway
1622
- * asserts its own (narrower) inbound list is a subset of it so the two sides
1623
- * cannot silently drift.
1624
- *
1625
- * Both packages depend on `@vellumai/service-contracts`, so hoisting the set
1626
- * here (rather than maintaining a copy on each side) means adding or renaming
1627
- * a channel happens in exactly one place.
1628
- *
1629
- * Note that a consumer may legitimately handle only a *subset* of these — the
1630
- * gateway, for example, never ingresses `platform`. Use a local list guarded
1631
- * by `satisfies readonly ChannelId[]` for those cases rather than redefining
1632
- * the union.
1633
- */
1634
- declare const CHANNEL_IDS: readonly ["telegram", "phone", "vellum", "whatsapp", "slack", "email", "platform", "a2a"];
1635
-
1636
- declare type ChannelId = (typeof CHANNEL_IDS)[number];
1637
-
1638
- declare interface ChannelVerificationSessionResponse {
1639
- type: "channel_verification_session_response";
1640
- success: boolean;
1641
- secret?: string;
1642
- instruction?: string;
1643
- /** Present when action is 'status'. */
1644
- bound?: boolean;
1645
- guardianExternalUserId?: string;
1646
- /** The channel this status pertains to (e.g. "telegram", "phone"). Present when action is 'status'. */
1647
- channel?: ChannelId;
1648
- /** The assistant ID scoped to this status. Present when action is 'status'. */
1649
- assistantId?: string;
1650
- /** The delivery chat ID for the guardian (e.g. Telegram chat ID). Present when action is 'status' and bound is true. */
1651
- guardianDeliveryChatId?: string;
1652
- /** Optional channel username/handle for the bound guardian (for UI display). */
1653
- guardianUsername?: string;
1654
- /** Optional display name for the bound guardian (for UI display). */
1655
- guardianDisplayName?: string;
1656
- /** Whether a pending verification challenge exists for this (assistantId, channel). Used by relay setup to detect active voice verification sessions. */
1657
- hasPendingChallenge?: boolean;
1658
- error?: string;
1659
- /** Human-readable error detail (e.g. for already_bound failures). */
1660
- message?: string;
1661
- /** Conversation ID for outbound verification flows. */
1662
- verificationSessionId?: string;
1663
- /** Epoch ms when the verification session expires. */
1664
- expiresAt?: number;
1665
- /** Epoch ms after which a resend is allowed. */
1666
- nextResendAt?: number;
1667
- /** Number of sends for this session. */
1668
- sendCount?: number;
1669
- /** Telegram deep-link URL for bootstrap (M3 placeholder). */
1670
- telegramBootstrapUrl?: string;
1671
- /** True when the outbound session is still in pending_bootstrap state (Telegram handle flow). Prevents the client from clearing the bootstrap URL during status polling. */
1672
- pendingBootstrap?: boolean;
1673
- }
1674
-
1675
2573
  export declare const CLI_COMMAND_HELP: readonly CliCommandHelp[];
1676
2574
 
1677
2575
  declare interface CliArgumentHelp {
@@ -1729,14 +2627,6 @@ declare interface ClientEntry extends BaseSubscriberEntry {
1729
2627
  actorPrincipalId?: string;
1730
2628
  }
1731
2629
 
1732
- declare type ClientSettingsUpdateEvent = z.infer<typeof ClientSettingsUpdateEventSchema>;
1733
-
1734
- declare const ClientSettingsUpdateEventSchema: z.ZodObject<{
1735
- type: z.ZodLiteral<"client_settings_update">;
1736
- key: z.ZodString;
1737
- value: z.ZodString;
1738
- }, z.core.$strip>;
1739
-
1740
2630
  declare interface CliOptionHelp {
1741
2631
  /** Commander flag spec, e.g. `"--path <file>"` or `"-l, --limit <n>"`. */
1742
2632
  flags: string;
@@ -1770,147 +2660,10 @@ declare interface CliSubcommandHelp {
1770
2660
  subcommands?: CliSubcommandHelp[];
1771
2661
  }
1772
2662
 
1773
- declare type CompactionCircuitClosedEvent = z.infer<typeof CompactionCircuitClosedEventSchema>;
1774
-
1775
- declare const CompactionCircuitClosedEventSchema: z.ZodObject<{
1776
- type: z.ZodLiteral<"compaction_circuit_closed">;
1777
- conversationId: z.ZodString;
1778
- }, z.core.$strip>;
1779
-
1780
- declare type CompactionCircuitOpenEvent = z.infer<typeof CompactionCircuitOpenEventSchema>;
1781
-
1782
- declare const CompactionCircuitOpenEventSchema: z.ZodObject<{
1783
- type: z.ZodLiteral<"compaction_circuit_open">;
1784
- conversationId: z.ZodString;
1785
- reason: z.ZodLiteral<"3_consecutive_failures">;
1786
- openUntil: z.ZodNumber;
1787
- }, z.core.$strip>;
1788
-
1789
- declare type _ComputerUseServerMessages = RecordingStartEvent | RecordingStopEvent | RecordingPauseEvent | RecordingResumeEvent;
1790
-
1791
- declare type ConfigChangedEvent = z.infer<typeof ConfigChangedEventSchema>;
1792
-
1793
- declare const ConfigChangedEventSchema: z.ZodObject<{
1794
- type: z.ZodLiteral<"config_changed">;
1795
- }, z.core.$strip>;
1796
-
1797
2663
  declare type ConfiguredProviderOptions = Pick<ResolveCallSiteOpts, "overrideProfile" | "forceOverrideProfile" | "selectionSeed">;
1798
2664
 
1799
- declare type ConfirmationRequestEvent = z.infer<typeof ConfirmationRequestEventSchema>;
1800
-
1801
- declare const ConfirmationRequestEventSchema: z.ZodObject<{
1802
- type: z.ZodLiteral<"confirmation_request">;
1803
- requestId: z.ZodString;
1804
- toolName: z.ZodString;
1805
- input: z.ZodRecord<z.ZodString, z.ZodUnknown>;
1806
- riskLevel: z.ZodString;
1807
- riskReason: z.ZodOptional<z.ZodString>;
1808
- isContainerized: z.ZodOptional<z.ZodBoolean>;
1809
- executionTarget: z.ZodOptional<z.ZodEnum<{
1810
- sandbox: "sandbox";
1811
- host: "host";
1812
- }>>;
1813
- allowlistOptions: z.ZodArray<z.ZodObject<{
1814
- label: z.ZodString;
1815
- description: z.ZodString;
1816
- pattern: z.ZodString;
1817
- }, z.core.$strip>>;
1818
- scopeOptions: z.ZodArray<z.ZodObject<{
1819
- label: z.ZodString;
1820
- scope: z.ZodString;
1821
- }, z.core.$strip>>;
1822
- directoryScopeOptions: z.ZodOptional<z.ZodArray<z.ZodObject<{
1823
- label: z.ZodString;
1824
- scope: z.ZodString;
1825
- }, z.core.$strip>>>;
1826
- diff: z.ZodOptional<z.ZodObject<{
1827
- filePath: z.ZodString;
1828
- oldContent: z.ZodString;
1829
- newContent: z.ZodString;
1830
- isNewFile: z.ZodBoolean;
1831
- }, z.core.$strip>>;
1832
- conversationId: z.ZodOptional<z.ZodString>;
1833
- persistentDecisionsAllowed: z.ZodOptional<z.ZodBoolean>;
1834
- toolUseId: z.ZodOptional<z.ZodString>;
1835
- acpToolKind: z.ZodOptional<z.ZodString>;
1836
- acpOptions: z.ZodOptional<z.ZodArray<z.ZodObject<{
1837
- optionId: z.ZodString;
1838
- name: z.ZodString;
1839
- kind: z.ZodEnum<{
1840
- allow_once: "allow_once";
1841
- allow_always: "allow_always";
1842
- reject_once: "reject_once";
1843
- reject_always: "reject_always";
1844
- }>;
1845
- }, z.core.$strip>>>;
1846
- }, z.core.$strip>;
1847
-
1848
- declare type ConfirmationStateChangedEvent = z.infer<typeof ConfirmationStateChangedEventSchema>;
1849
-
1850
- declare const ConfirmationStateChangedEventSchema: z.ZodObject<{
1851
- type: z.ZodLiteral<"confirmation_state_changed">;
1852
- conversationId: z.ZodString;
1853
- requestId: z.ZodString;
1854
- state: z.ZodEnum<{
1855
- timed_out: "timed_out";
1856
- pending: "pending";
1857
- approved: "approved";
1858
- denied: "denied";
1859
- resolved_stale: "resolved_stale";
1860
- }>;
1861
- source: z.ZodEnum<{
1862
- button: "button";
1863
- inline_nl: "inline_nl";
1864
- auto_deny: "auto_deny";
1865
- timeout: "timeout";
1866
- system: "system";
1867
- }>;
1868
- causedByRequestId: z.ZodOptional<z.ZodString>;
1869
- decisionText: z.ZodOptional<z.ZodString>;
1870
- toolUseId: z.ZodOptional<z.ZodString>;
1871
- }, z.core.$strip>;
1872
-
1873
- declare type ContactRequestEvent = z.infer<typeof ContactRequestEventSchema>;
1874
-
1875
- declare const ContactRequestEventSchema: z.ZodObject<{
1876
- type: z.ZodLiteral<"contact_request">;
1877
- requestId: z.ZodString;
1878
- channel: z.ZodOptional<z.ZodString>;
1879
- placeholder: z.ZodOptional<z.ZodString>;
1880
- label: z.ZodOptional<z.ZodString>;
1881
- description: z.ZodOptional<z.ZodString>;
1882
- role: z.ZodOptional<z.ZodString>;
1883
- }, z.core.$strip>;
1884
-
1885
- declare type ContactsChangedEvent = z.infer<typeof ContactsChangedEventSchema>;
1886
-
1887
- declare const ContactsChangedEventSchema: z.ZodObject<{
1888
- type: z.ZodLiteral<"contacts_changed">;
1889
- }, z.core.$strip>;
1890
-
1891
- declare type _ContactsServerMessages = ContactsChangedEvent | ContactRequestEvent;
1892
-
1893
2665
  export declare type ContentBlock = TextContent | ThinkingContent | RedactedThinkingContent | ImageContent | FileContent | ToolUseContent | ToolResultContent | ServerToolUseContent | WebSearchToolResultContent;
1894
2666
 
1895
- declare type ContextCompactedEvent = z.infer<typeof ContextCompactedEventSchema>;
1896
-
1897
- declare const ContextCompactedEventSchema: z.ZodObject<{
1898
- type: z.ZodLiteral<"context_compacted">;
1899
- conversationId: z.ZodString;
1900
- previousEstimatedInputTokens: z.ZodNumber;
1901
- estimatedInputTokens: z.ZodNumber;
1902
- maxInputTokens: z.ZodNumber;
1903
- thresholdTokens: z.ZodNumber;
1904
- compactedMessages: z.ZodNumber;
1905
- summaryCalls: z.ZodNumber;
1906
- summaryInputTokens: z.ZodNumber;
1907
- summaryOutputTokens: z.ZodNumber;
1908
- summaryModel: z.ZodString;
1909
- summaryCharCount: z.ZodOptional<z.ZodNumber>;
1910
- summaryHeaderCount: z.ZodOptional<z.ZodNumber>;
1911
- summaryHadMemoryEcho: z.ZodOptional<z.ZodBoolean>;
1912
- }, z.core.$strip>;
1913
-
1914
2667
  /** How a conversation was created / its execution mode. */
1915
2668
  declare type ConversationCreateType = "standard" | "background" | "scheduled";
1916
2669
 
@@ -1941,96 +2694,6 @@ declare interface ConversationDeletedInputContext {
1941
2694
  readonly conversationId: string;
1942
2695
  }
1943
2696
 
1944
- declare type ConversationErrorEvent = z.infer<typeof ConversationErrorEventSchema>;
1945
-
1946
- declare const ConversationErrorEventSchema: z.ZodObject<{
1947
- type: z.ZodLiteral<"conversation_error">;
1948
- conversationId: z.ZodString;
1949
- code: z.ZodEnum<{
1950
- PROVIDER_NETWORK: "PROVIDER_NETWORK";
1951
- PROVIDER_RATE_LIMIT: "PROVIDER_RATE_LIMIT";
1952
- MANAGED_USAGE_LIMIT: "MANAGED_USAGE_LIMIT";
1953
- PROVIDER_OVERLOADED: "PROVIDER_OVERLOADED";
1954
- PROVIDER_API: "PROVIDER_API";
1955
- IMAGE_TOO_LARGE: "IMAGE_TOO_LARGE";
1956
- PROVIDER_BILLING: "PROVIDER_BILLING";
1957
- PROVIDER_ORDERING: "PROVIDER_ORDERING";
1958
- PROVIDER_WEB_SEARCH: "PROVIDER_WEB_SEARCH";
1959
- PROVIDER_NOT_CONFIGURED: "PROVIDER_NOT_CONFIGURED";
1960
- PROVIDER_INVALID_KEY: "PROVIDER_INVALID_KEY";
1961
- MANAGED_KEY_INVALID: "MANAGED_KEY_INVALID";
1962
- CONTEXT_TOO_LARGE: "CONTEXT_TOO_LARGE";
1963
- BUDGET_YIELD_UNRECOVERED: "BUDGET_YIELD_UNRECOVERED";
1964
- MAX_TOKENS_REACHED: "MAX_TOKENS_REACHED";
1965
- CONVERSATION_ABORTED: "CONVERSATION_ABORTED";
1966
- CONVERSATION_PROCESSING_FAILED: "CONVERSATION_PROCESSING_FAILED";
1967
- DISK_SPACE_CRITICAL: "DISK_SPACE_CRITICAL";
1968
- UNKNOWN: "UNKNOWN";
1969
- }>;
1970
- userMessage: z.ZodString;
1971
- retryable: z.ZodBoolean;
1972
- debugDetails: z.ZodOptional<z.ZodString>;
1973
- errorCategory: z.ZodOptional<z.ZodString>;
1974
- connectionName: z.ZodOptional<z.ZodString>;
1975
- profileName: z.ZodOptional<z.ZodString>;
1976
- }, z.core.$strip>;
1977
-
1978
- declare type ConversationInferenceProfileUpdatedEvent = z.infer<typeof ConversationInferenceProfileUpdatedEventSchema>;
1979
-
1980
- declare const ConversationInferenceProfileUpdatedEventSchema: z.ZodObject<{
1981
- type: z.ZodLiteral<"conversation_inference_profile_updated">;
1982
- conversationId: z.ZodString;
1983
- profile: z.ZodNullable<z.ZodString>;
1984
- sessionId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
1985
- expiresAt: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
1986
- }, z.core.$strip>;
1987
-
1988
- declare type ConversationListInvalidatedEvent = z.infer<typeof ConversationListInvalidatedEventSchema>;
1989
-
1990
- declare const ConversationListInvalidatedEventSchema: z.ZodObject<{
1991
- type: z.ZodLiteral<"conversation_list_invalidated">;
1992
- reason: z.ZodEnum<{
1993
- created: "created";
1994
- renamed: "renamed";
1995
- deleted: "deleted";
1996
- reordered: "reordered";
1997
- seen_changed: "seen_changed";
1998
- }>;
1999
- }, z.core.$strip>;
2000
-
2001
- declare type ConversationNoticeEvent = z.infer<typeof ConversationNoticeEventSchema>;
2002
-
2003
- declare const ConversationNoticeEventSchema: z.ZodObject<{
2004
- type: z.ZodLiteral<"conversation_notice">;
2005
- conversationId: z.ZodString;
2006
- source: z.ZodEnum<{
2007
- memory_v3: "memory_v3";
2008
- }>;
2009
- code: z.ZodEnum<{
2010
- PROVIDER_NETWORK: "PROVIDER_NETWORK";
2011
- PROVIDER_RATE_LIMIT: "PROVIDER_RATE_LIMIT";
2012
- MANAGED_USAGE_LIMIT: "MANAGED_USAGE_LIMIT";
2013
- PROVIDER_OVERLOADED: "PROVIDER_OVERLOADED";
2014
- PROVIDER_API: "PROVIDER_API";
2015
- IMAGE_TOO_LARGE: "IMAGE_TOO_LARGE";
2016
- PROVIDER_BILLING: "PROVIDER_BILLING";
2017
- PROVIDER_ORDERING: "PROVIDER_ORDERING";
2018
- PROVIDER_WEB_SEARCH: "PROVIDER_WEB_SEARCH";
2019
- PROVIDER_NOT_CONFIGURED: "PROVIDER_NOT_CONFIGURED";
2020
- PROVIDER_INVALID_KEY: "PROVIDER_INVALID_KEY";
2021
- MANAGED_KEY_INVALID: "MANAGED_KEY_INVALID";
2022
- CONTEXT_TOO_LARGE: "CONTEXT_TOO_LARGE";
2023
- BUDGET_YIELD_UNRECOVERED: "BUDGET_YIELD_UNRECOVERED";
2024
- MAX_TOKENS_REACHED: "MAX_TOKENS_REACHED";
2025
- CONVERSATION_ABORTED: "CONVERSATION_ABORTED";
2026
- CONVERSATION_PROCESSING_FAILED: "CONVERSATION_PROCESSING_FAILED";
2027
- DISK_SPACE_CRITICAL: "DISK_SPACE_CRITICAL";
2028
- UNKNOWN: "UNKNOWN";
2029
- }>;
2030
- userMessage: z.ZodString;
2031
- errorCategory: z.ZodOptional<z.ZodString>;
2032
- }, z.core.$strip>;
2033
-
2034
2697
  export declare interface ConversationRow {
2035
2698
  id: string;
2036
2699
  title: string | null;
@@ -2075,16 +2738,6 @@ export declare interface ConversationRow {
2075
2738
  */
2076
2739
  export declare type ConversationsClearedContext = BaseHookContext;
2077
2740
 
2078
- declare type _ConversationsServerMessages = AssistantStatusEvent | GenerationCancelledEvent | GenerationHandoffEvent | ModelInfoEvent | UsageUpdateEvent | UsageProgressEvent | ContextCompactedEvent | CompactionCircuitOpenEvent | CompactionCircuitClosedEvent | ConversationErrorEvent | ConversationNoticeEvent | ConversationTitleUpdatedEvent | ConversationListInvalidatedEvent | ScheduleConversationCreatedEvent | OpenConversationEvent;
2079
-
2080
- declare type ConversationTitleUpdatedEvent = z.infer<typeof ConversationTitleUpdatedEventSchema>;
2081
-
2082
- declare const ConversationTitleUpdatedEventSchema: z.ZodObject<{
2083
- type: z.ZodLiteral<"conversation_title_updated">;
2084
- conversationId: z.ZodString;
2085
- title: z.ZodString;
2086
- }, z.core.$strip>;
2087
-
2088
2741
  /** Read-side alias of {@link ConversationCreateType}. */
2089
2742
  declare type ConversationType = ConversationCreateType;
2090
2743
 
@@ -2137,113 +2790,9 @@ declare interface DiffInfo {
2137
2790
  isNewFile: boolean;
2138
2791
  }
2139
2792
 
2140
- declare type DiskPressureStatusChangedEvent = z.infer<typeof DiskPressureStatusChangedEventSchema>;
2141
-
2142
- declare const DiskPressureStatusChangedEventSchema: z.ZodObject<{
2143
- type: z.ZodLiteral<"disk_pressure_status_changed">;
2144
- status: z.ZodObject<{
2145
- enabled: z.ZodBoolean;
2146
- state: z.ZodEnum<{
2147
- unknown: "unknown";
2148
- disabled: "disabled";
2149
- critical: "critical";
2150
- warning: "warning";
2151
- ok: "ok";
2152
- }>;
2153
- locked: z.ZodBoolean;
2154
- acknowledged: z.ZodBoolean;
2155
- overrideActive: z.ZodBoolean;
2156
- effectivelyLocked: z.ZodBoolean;
2157
- lockId: z.ZodNullable<z.ZodString>;
2158
- usagePercent: z.ZodNullable<z.ZodNumber>;
2159
- thresholdPercent: z.ZodNumber;
2160
- path: z.ZodNullable<z.ZodString>;
2161
- lastCheckedAt: z.ZodNullable<z.ZodString>;
2162
- blockedCapabilities: z.ZodArray<z.ZodEnum<{
2163
- "agent-turns": "agent-turns";
2164
- "background-work": "background-work";
2165
- "remote-ingress": "remote-ingress";
2166
- }>>;
2167
- error: z.ZodNullable<z.ZodString>;
2168
- }, z.core.$strip>;
2169
- }, z.core.$strip>;
2170
-
2171
2793
  /** Distributive Omit that preserves union discrimination. */
2172
2794
  declare type DistributiveOmit<T, K extends PropertyKey> = T extends unknown ? Omit<T, K> : never;
2173
2795
 
2174
- declare type DocumentCommentCreatedEvent = z.infer<typeof DocumentCommentCreatedEventSchema>;
2175
-
2176
- declare const DocumentCommentCreatedEventSchema: z.ZodObject<{
2177
- type: z.ZodLiteral<"document_comment_created">;
2178
- conversationId: z.ZodString;
2179
- surfaceId: z.ZodString;
2180
- comment: z.ZodObject<{
2181
- id: z.ZodString;
2182
- surfaceId: z.ZodString;
2183
- author: z.ZodString;
2184
- content: z.ZodString;
2185
- anchorStart: z.ZodOptional<z.ZodNumber>;
2186
- anchorEnd: z.ZodOptional<z.ZodNumber>;
2187
- anchorText: z.ZodOptional<z.ZodString>;
2188
- parentCommentId: z.ZodOptional<z.ZodString>;
2189
- status: z.ZodString;
2190
- createdAt: z.ZodNumber;
2191
- updatedAt: z.ZodNumber;
2192
- }, z.core.$strip>;
2193
- }, z.core.$strip>;
2194
-
2195
- declare type DocumentCommentDeletedEvent = z.infer<typeof DocumentCommentDeletedEventSchema>;
2196
-
2197
- declare const DocumentCommentDeletedEventSchema: z.ZodObject<{
2198
- type: z.ZodLiteral<"document_comment_deleted">;
2199
- conversationId: z.ZodString;
2200
- surfaceId: z.ZodString;
2201
- commentId: z.ZodString;
2202
- }, z.core.$strip>;
2203
-
2204
- declare type DocumentCommentReopenedEvent = z.infer<typeof DocumentCommentReopenedEventSchema>;
2205
-
2206
- declare const DocumentCommentReopenedEventSchema: z.ZodObject<{
2207
- type: z.ZodLiteral<"document_comment_reopened">;
2208
- conversationId: z.ZodString;
2209
- surfaceId: z.ZodString;
2210
- commentId: z.ZodString;
2211
- }, z.core.$strip>;
2212
-
2213
- declare type DocumentCommentResolvedEvent = z.infer<typeof DocumentCommentResolvedEventSchema>;
2214
-
2215
- declare const DocumentCommentResolvedEventSchema: z.ZodObject<{
2216
- type: z.ZodLiteral<"document_comment_resolved">;
2217
- conversationId: z.ZodString;
2218
- surfaceId: z.ZodString;
2219
- commentId: z.ZodString;
2220
- resolvedBy: z.ZodString;
2221
- }, z.core.$strip>;
2222
-
2223
- declare type _DocumentCommentsServerMessages = DocumentCommentCreatedEvent | DocumentCommentResolvedEvent | DocumentCommentReopenedEvent | DocumentCommentDeletedEvent;
2224
-
2225
- declare type DocumentEditorShowEvent = z.infer<typeof DocumentEditorShowEventSchema>;
2226
-
2227
- declare const DocumentEditorShowEventSchema: z.ZodObject<{
2228
- type: z.ZodLiteral<"document_editor_show">;
2229
- conversationId: z.ZodString;
2230
- surfaceId: z.ZodString;
2231
- title: z.ZodString;
2232
- initialContent: z.ZodString;
2233
- }, z.core.$strip>;
2234
-
2235
- declare type DocumentEditorUpdateEvent = z.infer<typeof DocumentEditorUpdateEventSchema>;
2236
-
2237
- declare const DocumentEditorUpdateEventSchema: z.ZodObject<{
2238
- type: z.ZodLiteral<"document_editor_update">;
2239
- conversationId: z.ZodString;
2240
- surfaceId: z.ZodString;
2241
- markdown: z.ZodString;
2242
- mode: z.ZodString;
2243
- }, z.core.$strip>;
2244
-
2245
- declare type _DocumentsServerMessages = DocumentEditorShowEvent | DocumentEditorUpdateEvent;
2246
-
2247
2796
  /**
2248
2797
  * Whether the given model or profile can process image input.
2249
2798
  *
@@ -2275,18 +2824,6 @@ declare type EmbeddingInput = string | MultimodalEmbeddingInput;
2275
2824
  */
2276
2825
  declare type EmbeddingTargetType = Parameters<embedAndUpsert_2>[1];
2277
2826
 
2278
- declare type ErrorEvent_2 = z.infer<typeof ErrorEventSchema>;
2279
-
2280
- declare const ErrorEventSchema: z.ZodObject<{
2281
- type: z.ZodLiteral<"error">;
2282
- message: z.ZodString;
2283
- code: z.ZodOptional<z.ZodString>;
2284
- category: z.ZodOptional<z.ZodString>;
2285
- errorCategory: z.ZodOptional<z.ZodString>;
2286
- requestId: z.ZodOptional<z.ZodString>;
2287
- conversationId: z.ZodOptional<z.ZodString>;
2288
- }, z.core.$strip>;
2289
-
2290
2827
  export declare function extractTextFromStoredMessageContent(raw: string | ContentBlock[]): string;
2291
2828
 
2292
2829
  export declare interface FileContent {
@@ -2304,39 +2841,6 @@ export declare interface FileContent {
2304
2841
  _attachmentId?: string;
2305
2842
  }
2306
2843
 
2307
- declare type GenerationCancelledEvent = z.infer<typeof GenerationCancelledEventSchema>;
2308
-
2309
- declare const GenerationCancelledEventSchema: z.ZodObject<{
2310
- type: z.ZodLiteral<"generation_cancelled">;
2311
- conversationId: z.ZodOptional<z.ZodString>;
2312
- }, z.core.$strip>;
2313
-
2314
- declare type GenerationHandoffEvent = z.infer<typeof GenerationHandoffEventSchema>;
2315
-
2316
- declare const GenerationHandoffEventSchema: z.ZodObject<{
2317
- type: z.ZodLiteral<"generation_handoff">;
2318
- conversationId: z.ZodOptional<z.ZodString>;
2319
- requestId: z.ZodOptional<z.ZodString>;
2320
- queuedCount: z.ZodNumber;
2321
- messageId: z.ZodOptional<z.ZodString>;
2322
- attachments: z.ZodOptional<z.ZodArray<z.ZodObject<{
2323
- id: z.ZodOptional<z.ZodString>;
2324
- filename: z.ZodString;
2325
- mimeType: z.ZodString;
2326
- data: z.ZodString;
2327
- sourceType: z.ZodOptional<z.ZodEnum<{
2328
- host_file: "host_file";
2329
- sandbox_file: "sandbox_file";
2330
- tool_block: "tool_block";
2331
- }>>;
2332
- sizeBytes: z.ZodOptional<z.ZodNumber>;
2333
- thumbnailData: z.ZodOptional<z.ZodString>;
2334
- fileBacked: z.ZodOptional<z.ZodBoolean>;
2335
- filePath: z.ZodOptional<z.ZodString>;
2336
- }, z.core.$strip>>>;
2337
- attachmentWarnings: z.ZodOptional<z.ZodArray<z.ZodString>>;
2338
- }, z.core.$strip>;
2339
-
2340
2844
  /** Read the assistant's name from IDENTITY.md for personalized responses. */
2341
2845
  export declare function getAssistantName(): string | null;
2342
2846
 
@@ -2408,32 +2912,6 @@ declare interface GraphNodeSweepResult {
2408
2912
  /** Whether the text tokenizes to at least one lexical search token. */
2409
2913
  export declare function hasLexicalTokens(text: string): Promise<boolean>;
2410
2914
 
2411
- declare type HeartbeatAlertEvent = z.infer<typeof HeartbeatAlertEventSchema>;
2412
-
2413
- declare const HeartbeatAlertEventSchema: z.ZodObject<{
2414
- type: z.ZodLiteral<"heartbeat_alert">;
2415
- title: z.ZodString;
2416
- body: z.ZodString;
2417
- }, z.core.$strip>;
2418
-
2419
- declare type HeartbeatConversationCreatedEvent = z.infer<typeof HeartbeatConversationCreatedEventSchema>;
2420
-
2421
- declare const HeartbeatConversationCreatedEventSchema: z.ZodObject<{
2422
- type: z.ZodLiteral<"heartbeat_conversation_created">;
2423
- conversationId: z.ZodString;
2424
- title: z.ZodString;
2425
- }, z.core.$strip>;
2426
-
2427
- declare type HomeFeedUpdatedEvent = z.infer<typeof HomeFeedUpdatedEventSchema>;
2428
-
2429
- declare const HomeFeedUpdatedEventSchema: z.ZodObject<{
2430
- type: z.ZodLiteral<"home_feed_updated">;
2431
- updatedAt: z.ZodString;
2432
- newItemCount: z.ZodNumber;
2433
- }, z.core.$strip>;
2434
-
2435
- declare type _HomeServerMessages = RelationshipStateUpdatedEvent | HomeFeedUpdatedEvent;
2436
-
2437
2915
  /**
2438
2916
  * Emit a `hook_event` to any UI watching the conversation the hook runs in —
2439
2917
  * e.g. progress while the hook does work the user can feel (memory
@@ -2448,22 +2926,6 @@ declare type _HomeServerMessages = RelationshipStateUpdatedEvent | HomeFeedUpdat
2448
2926
  */
2449
2927
  export declare type HookBroadcast = (detail: Record<string, unknown>) => void;
2450
2928
 
2451
- declare type HookEvent = z.infer<typeof HookEventSchema>;
2452
-
2453
- declare const HookEventSchema: z.ZodObject<{
2454
- type: z.ZodLiteral<"hook_event">;
2455
- conversationId: z.ZodOptional<z.ZodString>;
2456
- hookName: z.ZodString;
2457
- owner: z.ZodObject<{
2458
- kind: z.ZodEnum<{
2459
- plugin: "plugin";
2460
- workspace: "workspace";
2461
- }>;
2462
- id: z.ZodString;
2463
- }, z.core.$strip>;
2464
- detail: z.ZodRecord<z.ZodString, z.ZodUnknown>;
2465
- }, z.core.$strip>;
2466
-
2467
2929
  /**
2468
2930
  * A plugin lifecycle hook. Receives a per-lifecycle context shape and may
2469
2931
  * either mutate `ctx` in place (returning `void`) or return a *partial*
@@ -2524,280 +2986,24 @@ export declare const HOOKS: {
2524
2986
  /** Fires once per run when the loop has committed to ending — the definitive terminal hook for teardown. Cannot continue the loop; reports how the turn ended via `exitReason`. */
2525
2987
  readonly STOP: "stop";
2526
2988
  /** Fires at every model-call outcome (finalized reply or provider rejection), before the message is persisted/streamed-final. A hook may transform the content and owns the continue/retry decision. */
2527
- readonly POST_MODEL_CALL: "post-model-call";
2528
- /** Fires after the loop successfully compacts a conversation mid-turn. */
2529
- readonly POST_COMPACT: "post-compact";
2530
- /** Fires once per deleted conversation, after its rows are removed. Fire-and-forget cleanup signal — hooks run async with no ordering guarantee relative to the caller. */
2531
- readonly CONVERSATION_DELETED: "conversation-deleted";
2532
- /** Fires once when every conversation is wiped at once (the clear-all reset), after the main tables are cleared. Carries no `conversationId`; cleanup hooks wipe their own per-conversation state wholesale. */
2533
- readonly CONVERSATIONS_CLEARED: "conversations-cleared";
2534
- };
2535
-
2536
- /**
2537
- * Host proxy capabilities that an interface can support. The macOS client
2538
- * supports all of them; the chrome-extension interface only supports
2539
- * host_browser (via the Chrome DevTools Protocol proxy).
2540
- */
2541
- declare const HOST_PROXY_CAPABILITIES: readonly ["host_bash", "host_file", "host_cu", "host_browser", "host_app_control", "host_ui_snapshot"];
2542
-
2543
- declare type HostAppControlCancelEvent = z.infer<typeof HostAppControlCancelEventSchema>;
2544
-
2545
- declare const HostAppControlCancelEventSchema: z.ZodObject<{
2546
- type: z.ZodLiteral<"host_app_control_cancel">;
2547
- requestId: z.ZodString;
2548
- conversationId: z.ZodString;
2549
- }, z.core.$strip>;
2550
-
2551
- declare type HostAppControlRequestEvent = z.infer<typeof HostAppControlRequestEventSchema>;
2552
-
2553
- declare const HostAppControlRequestEventSchema: z.ZodObject<{
2554
- type: z.ZodLiteral<"host_app_control_request">;
2555
- requestId: z.ZodString;
2556
- conversationId: z.ZodString;
2557
- toolName: z.ZodString;
2558
- input: z.ZodDiscriminatedUnion<[z.ZodObject<{
2559
- tool: z.ZodLiteral<"start">;
2560
- app: z.ZodString;
2561
- args: z.ZodOptional<z.ZodArray<z.ZodString>>;
2562
- }, z.core.$strip>, z.ZodObject<{
2563
- tool: z.ZodLiteral<"observe">;
2564
- app: z.ZodString;
2565
- settle_ms: z.ZodOptional<z.ZodNumber>;
2566
- }, z.core.$strip>, z.ZodObject<{
2567
- tool: z.ZodLiteral<"press">;
2568
- app: z.ZodString;
2569
- key: z.ZodString;
2570
- modifiers: z.ZodOptional<z.ZodArray<z.ZodString>>;
2571
- duration_ms: z.ZodOptional<z.ZodNumber>;
2572
- }, z.core.$strip>, z.ZodObject<{
2573
- tool: z.ZodLiteral<"combo">;
2574
- app: z.ZodString;
2575
- keys: z.ZodArray<z.ZodString>;
2576
- duration_ms: z.ZodOptional<z.ZodNumber>;
2577
- }, z.core.$strip>, z.ZodObject<{
2578
- tool: z.ZodLiteral<"sequence">;
2579
- app: z.ZodString;
2580
- steps: z.ZodArray<z.ZodObject<{
2581
- key: z.ZodString;
2582
- modifiers: z.ZodOptional<z.ZodArray<z.ZodString>>;
2583
- duration_ms: z.ZodOptional<z.ZodNumber>;
2584
- gap_ms: z.ZodOptional<z.ZodNumber>;
2585
- }, z.core.$strip>>;
2586
- }, z.core.$strip>, z.ZodObject<{
2587
- tool: z.ZodLiteral<"type">;
2588
- app: z.ZodString;
2589
- text: z.ZodString;
2590
- }, z.core.$strip>, z.ZodObject<{
2591
- tool: z.ZodLiteral<"click">;
2592
- app: z.ZodString;
2593
- x: z.ZodNumber;
2594
- y: z.ZodNumber;
2595
- button: z.ZodOptional<z.ZodEnum<{
2596
- left: "left";
2597
- right: "right";
2598
- middle: "middle";
2599
- }>>;
2600
- double: z.ZodOptional<z.ZodBoolean>;
2601
- }, z.core.$strip>, z.ZodObject<{
2602
- tool: z.ZodLiteral<"drag">;
2603
- app: z.ZodString;
2604
- from_x: z.ZodNumber;
2605
- from_y: z.ZodNumber;
2606
- to_x: z.ZodNumber;
2607
- to_y: z.ZodNumber;
2608
- button: z.ZodOptional<z.ZodEnum<{
2609
- left: "left";
2610
- right: "right";
2611
- middle: "middle";
2612
- }>>;
2613
- }, z.core.$strip>, z.ZodObject<{
2614
- tool: z.ZodLiteral<"stop">;
2615
- app: z.ZodOptional<z.ZodString>;
2616
- reason: z.ZodOptional<z.ZodString>;
2617
- }, z.core.$strip>], "tool">;
2618
- }, z.core.$strip>;
2619
-
2620
- declare type _HostAppControlServerMessages = HostAppControlRequestEvent | HostAppControlCancelEvent;
2621
-
2622
- declare type HostBashCancelEvent = z.infer<typeof HostBashCancelEventSchema>;
2623
-
2624
- declare const HostBashCancelEventSchema: z.ZodObject<{
2625
- type: z.ZodLiteral<"host_bash_cancel">;
2626
- requestId: z.ZodString;
2627
- conversationId: z.ZodString;
2628
- targetClientId: z.ZodOptional<z.ZodString>;
2629
- }, z.core.$strip>;
2630
-
2631
- declare type HostBashRequestEvent = z.infer<typeof HostBashRequestEventSchema>;
2632
-
2633
- declare const HostBashRequestEventSchema: z.ZodObject<{
2634
- type: z.ZodLiteral<"host_bash_request">;
2635
- requestId: z.ZodString;
2636
- conversationId: z.ZodString;
2637
- command: z.ZodString;
2638
- working_dir: z.ZodOptional<z.ZodString>;
2639
- timeout_seconds: z.ZodOptional<z.ZodNumber>;
2640
- env: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
2641
- targetClientId: z.ZodOptional<z.ZodString>;
2642
- }, z.core.$strip>;
2643
-
2644
- declare type _HostBashServerMessages = HostBashRequestEvent | HostBashCancelEvent;
2645
-
2646
- declare type HostBrowserCancelEvent = z.infer<typeof HostBrowserCancelEventSchema>;
2647
-
2648
- declare const HostBrowserCancelEventSchema: z.ZodObject<{
2649
- type: z.ZodLiteral<"host_browser_cancel">;
2650
- requestId: z.ZodString;
2651
- }, z.core.$strip>;
2652
-
2653
- declare type HostBrowserRequestEvent = z.infer<typeof HostBrowserRequestEventSchema>;
2654
-
2655
- declare const HostBrowserRequestEventSchema: z.ZodObject<{
2656
- type: z.ZodLiteral<"host_browser_request">;
2657
- requestId: z.ZodString;
2658
- conversationId: z.ZodString;
2659
- cdpMethod: z.ZodString;
2660
- cdpParams: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
2661
- cdpSessionId: z.ZodOptional<z.ZodString>;
2662
- timeout_seconds: z.ZodOptional<z.ZodNumber>;
2663
- }, z.core.$strip>;
2664
-
2665
- declare type _HostBrowserServerMessages = HostBrowserRequestEvent | HostBrowserCancelEvent;
2666
-
2667
- declare type HostCuCancelEvent = z.infer<typeof HostCuCancelEventSchema>;
2668
-
2669
- declare const HostCuCancelEventSchema: z.ZodObject<{
2670
- type: z.ZodLiteral<"host_cu_cancel">;
2671
- requestId: z.ZodString;
2672
- conversationId: z.ZodString;
2673
- targetClientId: z.ZodOptional<z.ZodString>;
2674
- }, z.core.$strip>;
2675
-
2676
- declare type HostCuRequestEvent = z.infer<typeof HostCuRequestEventSchema>;
2677
-
2678
- declare const HostCuRequestEventSchema: z.ZodObject<{
2679
- type: z.ZodLiteral<"host_cu_request">;
2680
- requestId: z.ZodString;
2681
- conversationId: z.ZodString;
2682
- targetClientId: z.ZodOptional<z.ZodString>;
2683
- toolName: z.ZodString;
2684
- input: z.ZodRecord<z.ZodString, z.ZodUnknown>;
2685
- stepNumber: z.ZodNumber;
2686
- reasoning: z.ZodOptional<z.ZodString>;
2687
- }, z.core.$strip>;
2688
-
2689
- declare type _HostCuServerMessages = HostCuRequestEvent | HostCuCancelEvent;
2690
-
2691
- declare type HostFileCancelEvent = z.infer<typeof HostFileCancelEventSchema>;
2692
-
2693
- declare const HostFileCancelEventSchema: z.ZodObject<{
2694
- type: z.ZodLiteral<"host_file_cancel">;
2695
- requestId: z.ZodString;
2696
- conversationId: z.ZodString;
2697
- targetClientId: z.ZodOptional<z.ZodString>;
2698
- }, z.core.$strip>;
2989
+ readonly POST_MODEL_CALL: "post-model-call";
2990
+ /** Fires after the loop successfully compacts a conversation mid-turn. */
2991
+ readonly POST_COMPACT: "post-compact";
2992
+ /** Fires once per deleted conversation, after its rows are removed. Fire-and-forget cleanup signal — hooks run async with no ordering guarantee relative to the caller. */
2993
+ readonly CONVERSATION_DELETED: "conversation-deleted";
2994
+ /** Fires once when every conversation is wiped at once (the clear-all reset), after the main tables are cleared. Carries no `conversationId`; cleanup hooks wipe their own per-conversation state wholesale. */
2995
+ readonly CONVERSATIONS_CLEARED: "conversations-cleared";
2996
+ };
2699
2997
 
2700
- declare type HostFileRequestEvent = z.infer<typeof HostFileRequestEventSchema>;
2701
-
2702
- declare const HostFileRequestEventSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
2703
- type: z.ZodLiteral<"host_file_request">;
2704
- requestId: z.ZodString;
2705
- conversationId: z.ZodString;
2706
- targetClientId: z.ZodOptional<z.ZodString>;
2707
- operation: z.ZodLiteral<"read">;
2708
- path: z.ZodString;
2709
- offset: z.ZodOptional<z.ZodNumber>;
2710
- limit: z.ZodOptional<z.ZodNumber>;
2711
- }, z.core.$strip>, z.ZodObject<{
2712
- type: z.ZodLiteral<"host_file_request">;
2713
- requestId: z.ZodString;
2714
- conversationId: z.ZodString;
2715
- targetClientId: z.ZodOptional<z.ZodString>;
2716
- operation: z.ZodLiteral<"write">;
2717
- path: z.ZodString;
2718
- content: z.ZodString;
2719
- }, z.core.$strip>, z.ZodObject<{
2720
- type: z.ZodLiteral<"host_file_request">;
2721
- requestId: z.ZodString;
2722
- conversationId: z.ZodString;
2723
- targetClientId: z.ZodOptional<z.ZodString>;
2724
- operation: z.ZodLiteral<"edit">;
2725
- path: z.ZodString;
2726
- old_string: z.ZodString;
2727
- new_string: z.ZodString;
2728
- replace_all: z.ZodOptional<z.ZodBoolean>;
2729
- }, z.core.$strip>], "operation">;
2730
-
2731
- declare type _HostFileServerMessages = HostFileRequestEvent | HostFileCancelEvent;
2998
+ /**
2999
+ * Host proxy capabilities that an interface can support. The macOS client
3000
+ * supports all of them; the chrome-extension interface only supports
3001
+ * host_browser (via the Chrome DevTools Protocol proxy).
3002
+ */
3003
+ declare const HOST_PROXY_CAPABILITIES: readonly ["host_bash", "host_file", "host_cu", "host_browser", "host_app_control", "host_ui_snapshot"];
2732
3004
 
2733
3005
  declare type HostProxyCapability = (typeof HOST_PROXY_CAPABILITIES)[number];
2734
3006
 
2735
- declare type HostTransferCancelEvent = z.infer<typeof HostTransferCancelEventSchema>;
2736
-
2737
- declare const HostTransferCancelEventSchema: z.ZodObject<{
2738
- type: z.ZodLiteral<"host_transfer_cancel">;
2739
- requestId: z.ZodString;
2740
- conversationId: z.ZodString;
2741
- targetClientId: z.ZodOptional<z.ZodString>;
2742
- }, z.core.$strip>;
2743
-
2744
- declare type HostTransferRequestEvent = z.infer<typeof HostTransferRequestEventSchema>;
2745
-
2746
- declare const HostTransferRequestEventSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
2747
- type: z.ZodLiteral<"host_transfer_request">;
2748
- requestId: z.ZodString;
2749
- conversationId: z.ZodString;
2750
- targetClientId: z.ZodOptional<z.ZodString>;
2751
- direction: z.ZodLiteral<"to_host">;
2752
- transferId: z.ZodString;
2753
- destPath: z.ZodString;
2754
- sizeBytes: z.ZodNumber;
2755
- sha256: z.ZodString;
2756
- overwrite: z.ZodBoolean;
2757
- }, z.core.$strip>, z.ZodObject<{
2758
- type: z.ZodLiteral<"host_transfer_request">;
2759
- requestId: z.ZodString;
2760
- conversationId: z.ZodString;
2761
- targetClientId: z.ZodOptional<z.ZodString>;
2762
- direction: z.ZodLiteral<"to_sandbox">;
2763
- transferId: z.ZodString;
2764
- sourcePath: z.ZodString;
2765
- }, z.core.$strip>], "direction">;
2766
-
2767
- declare type _HostTransferServerMessages = HostTransferRequestEvent | HostTransferCancelEvent;
2768
-
2769
- declare type HostUiSnapshotCancelEvent = z.infer<typeof HostUiSnapshotCancelEventSchema>;
2770
-
2771
- declare const HostUiSnapshotCancelEventSchema: z.ZodObject<{
2772
- type: z.ZodLiteral<"host_ui_snapshot_cancel">;
2773
- requestId: z.ZodString;
2774
- }, z.core.$strip>;
2775
-
2776
- declare type HostUiSnapshotRequestEvent = z.infer<typeof HostUiSnapshotRequestEventSchema>;
2777
-
2778
- declare const HostUiSnapshotRequestEventSchema: z.ZodObject<{
2779
- type: z.ZodLiteral<"host_ui_snapshot_request">;
2780
- requestId: z.ZodString;
2781
- view: z.ZodEnum<{
2782
- sampler: "sampler";
2783
- chat: "chat";
2784
- }>;
2785
- tokens: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
2786
- }, z.core.$strip>;
2787
-
2788
- declare type _HostUiSnapshotServerMessages = HostUiSnapshotRequestEvent | HostUiSnapshotCancelEvent;
2789
-
2790
- declare type IdentityChangedEvent = z.infer<typeof IdentityChangedEventSchema>;
2791
-
2792
- declare const IdentityChangedEventSchema: z.ZodObject<{
2793
- type: z.ZodLiteral<"identity_changed">;
2794
- name: z.ZodString;
2795
- role: z.ZodString;
2796
- personality: z.ZodString;
2797
- emoji: z.ZodString;
2798
- home: z.ZodString;
2799
- }, z.core.$strip>;
2800
-
2801
3007
  export declare interface ImageContent {
2802
3008
  type: "image";
2803
3009
  source: MediaSource_2;
@@ -2852,24 +3058,6 @@ declare interface InsertedMessage {
2852
3058
  deduplicated: boolean;
2853
3059
  }
2854
3060
 
2855
- declare type _IntegrationsServerMessages = ChannelVerificationSessionResponse | OAuthConnectResultEvent | OpenUrlEvent | OpenPanelEvent | NavigateSettingsEvent | ShowPlatformLoginEvent | PlatformDisconnectedEvent;
2856
-
2857
- declare type InteractionResolvedEvent = z.infer<typeof InteractionResolvedEventSchema>;
2858
-
2859
- declare const InteractionResolvedEventSchema: z.ZodObject<{
2860
- type: z.ZodLiteral<"interaction_resolved">;
2861
- requestId: z.ZodString;
2862
- conversationId: z.ZodString;
2863
- state: z.ZodEnum<{
2864
- cancelled: "cancelled";
2865
- superseded: "superseded";
2866
- approved: "approved";
2867
- rejected: "rejected";
2868
- answered: "answered";
2869
- }>;
2870
- kind: z.ZodString;
2871
- }, z.core.$strip>;
2872
-
2873
3061
  declare const INTERFACE_IDS: readonly ["macos", "ios", "cli", "telegram", "phone", "web", "whatsapp", "slack", "email", "chrome-extension", "a2a", "route"];
2874
3062
 
2875
3063
  declare type InterfaceId = (typeof INTERFACE_IDS)[number];
@@ -3219,95 +3407,11 @@ declare const LLMCallSiteEnum: z.ZodEnum<{
3219
3407
 
3220
3408
  declare type MediaSource_2 = Base64MediaSource | WorkspaceRefMediaSource;
3221
3409
 
3222
- declare type MemoryRecalledEvent = z.infer<typeof MemoryRecalledEventSchema>;
3223
-
3224
- declare const MemoryRecalledEventSchema: z.ZodObject<{
3225
- type: z.ZodLiteral<"memory_recalled">;
3226
- provider: z.ZodString;
3227
- model: z.ZodString;
3228
- degradation: z.ZodOptional<z.ZodObject<{
3229
- semanticUnavailable: z.ZodBoolean;
3230
- reason: z.ZodString;
3231
- fallbackSources: z.ZodArray<z.ZodString>;
3232
- }, z.core.$strip>>;
3233
- semanticHits: z.ZodNumber;
3234
- tier1Count: z.ZodNumber;
3235
- tier2Count: z.ZodNumber;
3236
- hybridSearchLatencyMs: z.ZodNumber;
3237
- sparseVectorUsed: z.ZodBoolean;
3238
- mergedCount: z.ZodNumber;
3239
- selectedCount: z.ZodNumber;
3240
- injectedTokens: z.ZodNumber;
3241
- latencyMs: z.ZodNumber;
3242
- topCandidates: z.ZodArray<z.ZodObject<{
3243
- key: z.ZodString;
3244
- type: z.ZodString;
3245
- kind: z.ZodString;
3246
- finalScore: z.ZodNumber;
3247
- semantic: z.ZodNumber;
3248
- recency: z.ZodNumber;
3249
- }, z.core.$strip>>;
3250
- }, z.core.$strip>;
3251
-
3252
- declare type _MemoryServerMessages = MemoryRecalledEvent | MemoryStatusEvent;
3253
-
3254
- declare type MemoryStatusEvent = z.infer<typeof MemoryStatusEventSchema>;
3255
-
3256
- declare const MemoryStatusEventSchema: z.ZodObject<{
3257
- type: z.ZodLiteral<"memory_status">;
3258
- enabled: z.ZodBoolean;
3259
- degraded: z.ZodBoolean;
3260
- degradation: z.ZodOptional<z.ZodObject<{
3261
- semanticUnavailable: z.ZodBoolean;
3262
- reason: z.ZodString;
3263
- fallbackSources: z.ZodArray<z.ZodString>;
3264
- }, z.core.$strip>>;
3265
- reason: z.ZodOptional<z.ZodString>;
3266
- provider: z.ZodOptional<z.ZodString>;
3267
- model: z.ZodOptional<z.ZodString>;
3268
- }, z.core.$strip>;
3269
-
3270
3410
  export declare interface Message {
3271
3411
  role: "user" | "assistant";
3272
3412
  content: ContentBlock[];
3273
3413
  }
3274
3414
 
3275
- declare type MessageCompleteEvent = z.infer<typeof MessageCompleteEventSchema>;
3276
-
3277
- declare const MessageCompleteEventSchema: z.ZodObject<{
3278
- type: z.ZodLiteral<"message_complete">;
3279
- messageId: z.ZodOptional<z.ZodString>;
3280
- conversationId: z.ZodOptional<z.ZodString>;
3281
- source: z.ZodOptional<z.ZodEnum<{
3282
- main: "main";
3283
- aux: "aux";
3284
- }>>;
3285
- attachments: z.ZodOptional<z.ZodArray<z.ZodObject<{
3286
- id: z.ZodOptional<z.ZodString>;
3287
- filename: z.ZodString;
3288
- mimeType: z.ZodString;
3289
- data: z.ZodString;
3290
- sourceType: z.ZodOptional<z.ZodEnum<{
3291
- host_file: "host_file";
3292
- sandbox_file: "sandbox_file";
3293
- tool_block: "tool_block";
3294
- }>>;
3295
- sizeBytes: z.ZodOptional<z.ZodNumber>;
3296
- thumbnailData: z.ZodOptional<z.ZodString>;
3297
- fileBacked: z.ZodOptional<z.ZodBoolean>;
3298
- filePath: z.ZodOptional<z.ZodString>;
3299
- }, z.core.$strip>>>;
3300
- attachmentWarnings: z.ZodOptional<z.ZodArray<z.ZodString>>;
3301
- }, z.core.$strip>;
3302
-
3303
- declare type MessageDequeuedEvent = z.infer<typeof MessageDequeuedEventSchema>;
3304
-
3305
- declare const MessageDequeuedEventSchema: z.ZodObject<{
3306
- type: z.ZodLiteral<"message_dequeued">;
3307
- conversationId: z.ZodString;
3308
- requestId: z.ZodString;
3309
- }, z.core.$strip>;
3310
-
3311
3415
  declare type MessageLexicalSearchResult = Awaited<ReturnType<searchMessageIdsLexical_2>>[number];
3312
3416
 
3313
3417
  declare interface MessageLexicalSearchResult_2 {
@@ -3428,32 +3532,6 @@ declare const messageMetadataSchema: z.ZodObject<{
3428
3532
  nonInteractiveContextBlock: z.ZodOptional<z.ZodString>;
3429
3533
  }, z.core.$loose>;
3430
3534
 
3431
- declare type MessageQueuedDeletedEvent = z.infer<typeof MessageQueuedDeletedEventSchema>;
3432
-
3433
- declare const MessageQueuedDeletedEventSchema: z.ZodObject<{
3434
- type: z.ZodLiteral<"message_queued_deleted">;
3435
- conversationId: z.ZodString;
3436
- requestId: z.ZodString;
3437
- }, z.core.$strip>;
3438
-
3439
- declare type MessageQueuedEvent = z.infer<typeof MessageQueuedEventSchema>;
3440
-
3441
- declare const MessageQueuedEventSchema: z.ZodObject<{
3442
- type: z.ZodLiteral<"message_queued">;
3443
- conversationId: z.ZodString;
3444
- requestId: z.ZodString;
3445
- position: z.ZodNumber;
3446
- }, z.core.$strip>;
3447
-
3448
- declare type MessageRequestCompleteEvent = z.infer<typeof MessageRequestCompleteEventSchema>;
3449
-
3450
- declare const MessageRequestCompleteEventSchema: z.ZodObject<{
3451
- type: z.ZodLiteral<"message_request_complete">;
3452
- conversationId: z.ZodString;
3453
- requestId: z.ZodString;
3454
- runStillActive: z.ZodOptional<z.ZodBoolean>;
3455
- }, z.core.$strip>;
3456
-
3457
3535
  /** Allowed values for the `role` column on `messages`. */
3458
3536
  declare type MessageRole = "user" | "assistant" | "system";
3459
3537
 
@@ -3475,41 +3553,6 @@ declare interface MessageRow {
3475
3553
  finalized: number;
3476
3554
  }
3477
3555
 
3478
- declare type _MessagesServerMessages = UserMessageEchoEvent | AssistantTurnStartEvent | AssistantTextDeltaEvent | AssistantThinkingDeltaEvent | ToolUseStartEvent | ToolUsePreviewStartEvent | ToolOutputChunkEvent | ToolInputDeltaEvent | ToolResultEvent | ConfirmationRequestEvent | SecretRequestEvent | QuestionRequestEvent | MessageCompleteEvent | ErrorEvent_2 | MessageQueuedEvent | MessageDequeuedEvent | MessageRequestCompleteEvent | MessageQueuedDeletedEvent | MessageSteeredEvent | ConfirmationStateChangedEvent | AssistantActivityStateEvent | ConversationInferenceProfileUpdatedEvent | InteractionResolvedEvent;
3479
-
3480
- declare type MessageSteeredEvent = z.infer<typeof MessageSteeredEventSchema>;
3481
-
3482
- declare const MessageSteeredEventSchema: z.ZodObject<{
3483
- type: z.ZodLiteral<"message_steered">;
3484
- conversationId: z.ZodString;
3485
- requestId: z.ZodString;
3486
- }, z.core.$strip>;
3487
-
3488
- declare type ModelInfoEvent = z.infer<typeof ModelInfoEventSchema>;
3489
-
3490
- declare const ModelInfoEventSchema: z.ZodObject<{
3491
- type: z.ZodLiteral<"model_info">;
3492
- conversationId: z.ZodOptional<z.ZodString>;
3493
- model: z.ZodString;
3494
- provider: z.ZodString;
3495
- configuredProviders: z.ZodOptional<z.ZodArray<z.ZodString>>;
3496
- availableModels: z.ZodOptional<z.ZodArray<z.ZodObject<{
3497
- id: z.ZodString;
3498
- displayName: z.ZodString;
3499
- }, z.core.$strip>>>;
3500
- allProviders: z.ZodOptional<z.ZodArray<z.ZodObject<{
3501
- id: z.ZodString;
3502
- displayName: z.ZodString;
3503
- models: z.ZodArray<z.ZodObject<{
3504
- id: z.ZodString;
3505
- displayName: z.ZodString;
3506
- }, z.core.$strip>>;
3507
- defaultModel: z.ZodString;
3508
- apiKeyUrl: z.ZodOptional<z.ZodString>;
3509
- apiKeyPlaceholder: z.ZodOptional<z.ZodString>;
3510
- }, z.core.$strip>>>;
3511
- }, z.core.$strip>;
3512
-
3513
3556
  /**
3514
3557
  * A workspace inference profile a plugin can route to. Returned by
3515
3558
  * {@link getModelProfiles}; {@link key} is the value a `pre-model-call` hook
@@ -3539,72 +3582,6 @@ export declare interface ModelProfileInfo {
3539
3582
 
3540
3583
  declare type MultimodalEmbeddingInput = TextEmbeddingInput | ImageEmbeddingInput | AudioEmbeddingInput | VideoEmbeddingInput;
3541
3584
 
3542
- declare type NavigateSettingsEvent = z.infer<typeof NavigateSettingsEventSchema>;
3543
-
3544
- declare const NavigateSettingsEventSchema: z.ZodObject<{
3545
- type: z.ZodLiteral<"navigate_settings">;
3546
- tab: z.ZodString;
3547
- }, z.core.$strip>;
3548
-
3549
- declare type NotificationConversationCreatedEvent = z.infer<typeof NotificationConversationCreatedEventSchema>;
3550
-
3551
- declare const NotificationConversationCreatedEventSchema: z.ZodObject<{
3552
- type: z.ZodLiteral<"notification_conversation_created">;
3553
- conversationId: z.ZodString;
3554
- title: z.ZodString;
3555
- sourceEventName: z.ZodString;
3556
- targetGuardianPrincipalId: z.ZodOptional<z.ZodString>;
3557
- groupId: z.ZodOptional<z.ZodString>;
3558
- source: z.ZodOptional<z.ZodString>;
3559
- silent: z.ZodOptional<z.ZodBoolean>;
3560
- }, z.core.$strip>;
3561
-
3562
- declare type NotificationIntentEvent = z.infer<typeof NotificationIntentEventSchema>;
3563
-
3564
- declare const NotificationIntentEventSchema: z.ZodObject<{
3565
- type: z.ZodLiteral<"notification_intent">;
3566
- sourceEventName: z.ZodString;
3567
- title: z.ZodString;
3568
- body: z.ZodString;
3569
- deliveryId: z.ZodOptional<z.ZodString>;
3570
- deepLinkMetadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
3571
- targetGuardianPrincipalId: z.ZodOptional<z.ZodString>;
3572
- silent: z.ZodOptional<z.ZodBoolean>;
3573
- }, z.core.$strip>;
3574
-
3575
- declare type _NotificationsServerMessages = NotificationIntentEvent | NotificationConversationCreatedEvent;
3576
-
3577
- declare type OAuthConnectResultEvent = z.infer<typeof OAuthConnectResultEventSchema>;
3578
-
3579
- declare const OAuthConnectResultEventSchema: z.ZodObject<{
3580
- type: z.ZodLiteral<"oauth_connect_result">;
3581
- success: z.ZodBoolean;
3582
- service: z.ZodOptional<z.ZodString>;
3583
- grantedScopes: z.ZodOptional<z.ZodArray<z.ZodString>>;
3584
- accountInfo: z.ZodOptional<z.ZodString>;
3585
- error: z.ZodOptional<z.ZodString>;
3586
- }, z.core.$strip>;
3587
-
3588
- declare type OpenConversationEvent = z.infer<typeof OpenConversationEventSchema>;
3589
-
3590
- declare const OpenConversationEventSchema: z.ZodObject<{
3591
- type: z.ZodLiteral<"open_conversation">;
3592
- conversationId: z.ZodString;
3593
- title: z.ZodOptional<z.ZodString>;
3594
- anchorMessageId: z.ZodOptional<z.ZodString>;
3595
- focus: z.ZodOptional<z.ZodBoolean>;
3596
- }, z.core.$strip>;
3597
-
3598
- declare type OpenPanelEvent = z.infer<typeof OpenPanelEventSchema>;
3599
-
3600
- declare const OpenPanelEventSchema: z.ZodObject<{
3601
- type: z.ZodLiteral<"open_panel">;
3602
- panelType: z.ZodString;
3603
- data: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
3604
- conversationId: z.ZodOptional<z.ZodString>;
3605
- surfaceId: z.ZodOptional<z.ZodString>;
3606
- }, z.core.$strip>;
3607
-
3608
3585
  /**
3609
3586
  * Open a streaming transcription session against the configured STT provider
3610
3587
  * (`services.stt.provider`).
@@ -3626,15 +3603,6 @@ declare const OpenPanelEventSchema: z.ZodObject<{
3626
3603
  */
3627
3604
  export declare function openTranscriptionSession(): Promise<StreamingTranscriber | null>;
3628
3605
 
3629
- declare type OpenUrlEvent = z.infer<typeof OpenUrlEventSchema>;
3630
-
3631
- declare const OpenUrlEventSchema: z.ZodObject<{
3632
- type: z.ZodLiteral<"open_url">;
3633
- url: z.ZodString;
3634
- title: z.ZodOptional<z.ZodString>;
3635
- conversationId: z.ZodOptional<z.ZodString>;
3636
- }, z.core.$strip>;
3637
-
3638
3606
  /** Parse a stored message-metadata JSON string; undefined when absent/invalid. */
3639
3607
  export declare function parseMessageMetadata(metadataJson: string | null): Promise<MessageMetadata>;
3640
3608
 
@@ -3648,12 +3616,6 @@ export declare function parseMessageMetadata(metadataJson: string | null): Promi
3648
3616
  */
3649
3617
  declare function parseMessageMetadata_2(metadataJson: string | null): MessageMetadata_2 | undefined;
3650
3618
 
3651
- declare type PlatformDisconnectedEvent = z.infer<typeof PlatformDisconnectedEventSchema>;
3652
-
3653
- declare const PlatformDisconnectedEventSchema: z.ZodObject<{
3654
- type: z.ZodLiteral<"platform_disconnected">;
3655
- }, z.core.$strip>;
3656
-
3657
3619
  /**
3658
3620
  * The subset of {@link AssistantEventHub} workspace plugins may use. Picking
3659
3621
  * method signatures off the class keeps the facade in sync with the hub while
@@ -4166,75 +4128,6 @@ export declare function quarantineRefusedExchanges(messages: Message[]): {
4166
4128
  droppedExchanges: number;
4167
4129
  };
4168
4130
 
4169
- declare type QuestionRequestEvent = z.infer<typeof QuestionRequestEventSchema>;
4170
-
4171
- declare const QuestionRequestEventSchema: z.ZodObject<{
4172
- type: z.ZodLiteral<"question_request">;
4173
- requestId: z.ZodString;
4174
- questions: z.ZodArray<z.ZodObject<{
4175
- id: z.ZodString;
4176
- question: z.ZodString;
4177
- description: z.ZodOptional<z.ZodString>;
4178
- options: z.ZodArray<z.ZodObject<{
4179
- id: z.ZodString;
4180
- label: z.ZodString;
4181
- description: z.ZodOptional<z.ZodString>;
4182
- }, z.core.$strip>>;
4183
- freeTextPlaceholder: z.ZodOptional<z.ZodString>;
4184
- }, z.core.$strip>>;
4185
- question: z.ZodString;
4186
- description: z.ZodOptional<z.ZodString>;
4187
- options: z.ZodArray<z.ZodObject<{
4188
- id: z.ZodString;
4189
- label: z.ZodString;
4190
- description: z.ZodOptional<z.ZodString>;
4191
- }, z.core.$strip>>;
4192
- freeTextPlaceholder: z.ZodOptional<z.ZodString>;
4193
- conversationId: z.ZodOptional<z.ZodString>;
4194
- toolUseId: z.ZodOptional<z.ZodString>;
4195
- }, z.core.$strip>;
4196
-
4197
- declare type RecordingPauseEvent = z.infer<typeof RecordingPauseEventSchema>;
4198
-
4199
- declare const RecordingPauseEventSchema: z.ZodObject<{
4200
- type: z.ZodLiteral<"recording_pause">;
4201
- recordingId: z.ZodString;
4202
- }, z.core.$strip>;
4203
-
4204
- declare type RecordingResumeEvent = z.infer<typeof RecordingResumeEventSchema>;
4205
-
4206
- declare const RecordingResumeEventSchema: z.ZodObject<{
4207
- type: z.ZodLiteral<"recording_resume">;
4208
- recordingId: z.ZodString;
4209
- }, z.core.$strip>;
4210
-
4211
- declare type RecordingStartEvent = z.infer<typeof RecordingStartEventSchema>;
4212
-
4213
- declare const RecordingStartEventSchema: z.ZodObject<{
4214
- type: z.ZodLiteral<"recording_start">;
4215
- recordingId: z.ZodString;
4216
- attachToConversationId: z.ZodOptional<z.ZodString>;
4217
- options: z.ZodOptional<z.ZodObject<{
4218
- captureScope: z.ZodOptional<z.ZodEnum<{
4219
- display: "display";
4220
- window: "window";
4221
- }>>;
4222
- displayId: z.ZodOptional<z.ZodString>;
4223
- windowId: z.ZodOptional<z.ZodNumber>;
4224
- includeAudio: z.ZodOptional<z.ZodBoolean>;
4225
- includeMicrophone: z.ZodOptional<z.ZodBoolean>;
4226
- promptForSource: z.ZodOptional<z.ZodBoolean>;
4227
- }, z.core.$strip>>;
4228
- operationToken: z.ZodOptional<z.ZodString>;
4229
- }, z.core.$strip>;
4230
-
4231
- declare type RecordingStopEvent = z.infer<typeof RecordingStopEventSchema>;
4232
-
4233
- declare const RecordingStopEventSchema: z.ZodObject<{
4234
- type: z.ZodLiteral<"recording_stop">;
4235
- recordingId: z.ZodString;
4236
- }, z.core.$strip>;
4237
-
4238
4131
  export declare interface RedactedThinkingContent {
4239
4132
  type: "redacted_thinking";
4240
4133
  data: string;
@@ -4253,13 +4146,6 @@ export declare interface RedactedThinkingContent {
4253
4146
  */
4254
4147
  export declare const REFUSAL_FALLBACK_TEXT = "Sorry \u2014 I wasn't able to generate a response to that. Please try rephrasing or asking in a different way.";
4255
4148
 
4256
- declare type RelationshipStateUpdatedEvent = z.infer<typeof RelationshipStateUpdatedEventSchema>;
4257
-
4258
- declare const RelationshipStateUpdatedEventSchema: z.ZodObject<{
4259
- type: z.ZodLiteral<"relationship_state_updated">;
4260
- updatedAt: z.ZodString;
4261
- }, z.core.$strip>;
4262
-
4263
4149
  declare type ResolutionFallbackReason = "missing" | "disabled" | "incomplete";
4264
4150
 
4265
4151
  /**
@@ -4499,17 +4385,6 @@ export declare interface RunConversationTurnResult {
4499
4385
  queued?: boolean;
4500
4386
  }
4501
4387
 
4502
- declare type ScheduleConversationCreatedEvent = z.infer<typeof ScheduleConversationCreatedEventSchema>;
4503
-
4504
- declare const ScheduleConversationCreatedEventSchema: z.ZodObject<{
4505
- type: z.ZodLiteral<"schedule_conversation_created">;
4506
- conversationId: z.ZodString;
4507
- scheduleJobId: z.ZodString;
4508
- title: z.ZodString;
4509
- }, z.core.$strip>;
4510
-
4511
- declare type _SchedulesServerMessages = HeartbeatAlertEvent | HeartbeatConversationCreatedEvent;
4512
-
4513
4388
  /** Sparse lexical search over stored message text; ranked message-id hits. */
4514
4389
  export declare function searchMessageIdsLexical(query: string, limit: number, opts?: {
4515
4390
  conversationId?: string;
@@ -4574,23 +4449,6 @@ declare interface SecretPromptResult {
4574
4449
  collectionExpiresAt?: number;
4575
4450
  }
4576
4451
 
4577
- declare type SecretRequestEvent = z.infer<typeof SecretRequestEventSchema>;
4578
-
4579
- declare const SecretRequestEventSchema: z.ZodObject<{
4580
- type: z.ZodLiteral<"secret_request">;
4581
- requestId: z.ZodString;
4582
- service: z.ZodString;
4583
- field: z.ZodString;
4584
- label: z.ZodString;
4585
- description: z.ZodOptional<z.ZodString>;
4586
- placeholder: z.ZodOptional<z.ZodString>;
4587
- conversationId: z.ZodOptional<z.ZodString>;
4588
- purpose: z.ZodOptional<z.ZodString>;
4589
- allowedTools: z.ZodOptional<z.ZodArray<z.ZodString>>;
4590
- allowedDomains: z.ZodOptional<z.ZodArray<z.ZodString>>;
4591
- allowOneTimeSend: z.ZodOptional<z.ZodBoolean>;
4592
- }, z.core.$strip>;
4593
-
4594
4452
  /** Whether the active embedding backend handles multimodal inputs. */
4595
4453
  export declare function selectedBackendSupportsMultimodal(): Promise<boolean>;
4596
4454
 
@@ -4712,8 +4570,6 @@ declare interface SensitiveOutputBinding {
4712
4570
 
4713
4571
  declare type SensitiveOutputKind = "invite_code";
4714
4572
 
4715
- declare type ServerMessage = _ConversationsServerMessages | _MessagesServerMessages | _SurfacesServerMessages | _SkillsServerMessages | _AppsServerMessages | _IntegrationsServerMessages | _ComputerUseServerMessages | _ContactsServerMessages | _SubagentsServerMessages | _DocumentsServerMessages | _DocumentCommentsServerMessages | _SyncInvalidationServerMessages | _HomeServerMessages | _HostAppControlServerMessages | _HostBashServerMessages | _HostBrowserServerMessages | _HostCuServerMessages | _HostFileServerMessages | _HostTransferServerMessages | _HostUiSnapshotServerMessages | _MemoryServerMessages | _WorkspaceServerMessages | _SchedulesServerMessages | _SettingsServerMessages | _NotificationsServerMessages | _UpgradesServerMessages | _AcpServerMessages | _BackgroundToolsServerMessages | _BookmarksServerMessages | _WorkflowsServerMessages | DiskPressureStatusChangedEvent | HookEvent | SubagentEventEvent;
4716
-
4717
4573
  export declare interface ServerToolUseContent {
4718
4574
  type: "server_tool_use";
4719
4575
  id: string;
@@ -4721,38 +4577,6 @@ export declare interface ServerToolUseContent {
4721
4577
  input: Record<string, unknown>;
4722
4578
  }
4723
4579
 
4724
- declare type ServiceGroupUpdateCompleteEvent = z.infer<typeof ServiceGroupUpdateCompleteEventSchema>;
4725
-
4726
- declare const ServiceGroupUpdateCompleteEventSchema: z.ZodObject<{
4727
- type: z.ZodLiteral<"service_group_update_complete">;
4728
- installedVersion: z.ZodString;
4729
- success: z.ZodBoolean;
4730
- rolledBackToVersion: z.ZodOptional<z.ZodString>;
4731
- }, z.core.$strip>;
4732
-
4733
- declare type ServiceGroupUpdateProgressEvent = z.infer<typeof ServiceGroupUpdateProgressEventSchema>;
4734
-
4735
- declare const ServiceGroupUpdateProgressEventSchema: z.ZodObject<{
4736
- type: z.ZodLiteral<"service_group_update_progress">;
4737
- statusMessage: z.ZodString;
4738
- }, z.core.$strip>;
4739
-
4740
- declare type ServiceGroupUpdateStartingEvent = z.infer<typeof ServiceGroupUpdateStartingEventSchema>;
4741
-
4742
- declare const ServiceGroupUpdateStartingEventSchema: z.ZodObject<{
4743
- type: z.ZodLiteral<"service_group_update_starting">;
4744
- targetVersion: z.ZodString;
4745
- expectedDowntimeSeconds: z.ZodNumber;
4746
- }, z.core.$strip>;
4747
-
4748
- declare type _SettingsServerMessages = ClientSettingsUpdateEvent | AvatarUpdatedEvent | ConfigChangedEvent | SoundsConfigUpdatedEvent;
4749
-
4750
- declare type ShowPlatformLoginEvent = z.infer<typeof ShowPlatformLoginEventSchema>;
4751
-
4752
- declare const ShowPlatformLoginEventSchema: z.ZodObject<{
4753
- type: z.ZodLiteral<"show_platform_login">;
4754
- }, z.core.$strip>;
4755
-
4756
4580
  /**
4757
4581
  * Context passed to the `shutdown` hook. Kept intentionally narrower than
4758
4582
  * {@link InitContext} — teardown paths only need to know which assistant
@@ -4823,27 +4647,6 @@ declare interface SkillInstallMeta {
4823
4647
  */
4824
4648
  declare type SkillSource = "bundled" | "managed" | "workspace" | "extra" | "plugin";
4825
4649
 
4826
- declare type _SkillsServerMessages = SkillStateChangedEvent;
4827
-
4828
- declare type SkillStateChangedEvent = z.infer<typeof SkillStateChangedEventSchema>;
4829
-
4830
- declare const SkillStateChangedEventSchema: z.ZodObject<{
4831
- type: z.ZodLiteral<"skills_state_changed">;
4832
- name: z.ZodString;
4833
- state: z.ZodEnum<{
4834
- enabled: "enabled";
4835
- disabled: "disabled";
4836
- installed: "installed";
4837
- uninstalled: "uninstalled";
4838
- }>;
4839
- }, z.core.$strip>;
4840
-
4841
- declare type SoundsConfigUpdatedEvent = z.infer<typeof SoundsConfigUpdatedEventSchema>;
4842
-
4843
- declare const SoundsConfigUpdatedEventSchema: z.ZodObject<{
4844
- type: z.ZodLiteral<"sounds_config_updated">;
4845
- }, z.core.$strip>;
4846
-
4847
4650
  /**
4848
4651
  * The full `stop` context a hook receives — the dispatching call site's
4849
4652
  * {@link StopInputContext} plus the pipeline-stamped {@link BaseHookContext}
@@ -5075,60 +4878,6 @@ export declare interface SttStreamServerPartialEvent {
5075
4878
  readonly confidence?: number;
5076
4879
  }
5077
4880
 
5078
- declare type SubagentEventEvent = z.infer<typeof SubagentEventEventSchema>;
5079
-
5080
- declare const SubagentEventEventSchema: z.ZodObject<{
5081
- type: z.ZodLiteral<"subagent_event">;
5082
- conversationId: z.ZodString;
5083
- subagentId: z.ZodString;
5084
- event: z.ZodObject<{
5085
- type: z.ZodString;
5086
- content: z.ZodOptional<z.ZodString>;
5087
- text: z.ZodOptional<z.ZodString>;
5088
- result: z.ZodOptional<z.ZodString>;
5089
- input: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
5090
- toolName: z.ZodOptional<z.ZodString>;
5091
- isError: z.ZodOptional<z.ZodBoolean>;
5092
- toolUseId: z.ZodOptional<z.ZodString>;
5093
- }, z.core.$loose>;
5094
- }, z.core.$strict>;
5095
-
5096
- declare type SubagentSpawnedEvent = z.infer<typeof SubagentSpawnedEventSchema>;
5097
-
5098
- declare const SubagentSpawnedEventSchema: z.ZodObject<{
5099
- type: z.ZodLiteral<"subagent_spawned">;
5100
- subagentId: z.ZodString;
5101
- parentConversationId: z.ZodString;
5102
- label: z.ZodString;
5103
- objective: z.ZodString;
5104
- isFork: z.ZodOptional<z.ZodBoolean>;
5105
- parentToolUseId: z.ZodOptional<z.ZodString>;
5106
- }, z.core.$strict>;
5107
-
5108
- declare type _SubagentsServerMessages = SubagentSpawnedEvent | SubagentStatusChangedEvent;
5109
-
5110
- declare type SubagentStatusChangedEvent = z.infer<typeof SubagentStatusChangedEventSchema>;
5111
-
5112
- declare const SubagentStatusChangedEventSchema: z.ZodObject<{
5113
- type: z.ZodLiteral<"subagent_status_changed">;
5114
- subagentId: z.ZodString;
5115
- status: z.ZodEnum<{
5116
- completed: "completed";
5117
- failed: "failed";
5118
- running: "running";
5119
- pending: "pending";
5120
- awaiting_input: "awaiting_input";
5121
- aborted: "aborted";
5122
- interrupted: "interrupted";
5123
- }>;
5124
- error: z.ZodOptional<z.ZodString>;
5125
- usage: z.ZodOptional<z.ZodObject<{
5126
- inputTokens: z.ZodNumber;
5127
- outputTokens: z.ZodNumber;
5128
- estimatedCost: z.ZodNumber;
5129
- }, z.core.$strict>>;
5130
- }, z.core.$strict>;
5131
-
5132
4881
  declare type SubscriberEntry = ClientEntry | ProcessEntry;
5133
4882
 
5134
4883
  /** Input shape for `subscribe()` — hub fills `active`, `connectedAt`, `lastActiveAt`, `connectionId` and defaults `filter`/`onEvict`. */
@@ -5137,8 +4886,6 @@ declare type SubscriberInput = DistributiveOmit<SubscriberEntry, "active" | "con
5137
4886
  onEvict?: () => void;
5138
4887
  };
5139
4888
 
5140
- declare type _SurfacesServerMessages = UISurfaceShowEvent | UISurfaceUpdateEvent | UISurfaceDismissEvent | UISurfaceCompleteEvent | UISurfaceUndoResultEvent;
5141
-
5142
4889
  /**
5143
4890
  * Delete `graph_node` Qdrant points whose backing `memory_graph_nodes` row no
5144
4891
  * longer exists.
@@ -5167,16 +4914,6 @@ declare type _SurfacesServerMessages = UISurfaceShowEvent | UISurfaceUpdateEvent
5167
4914
  */
5168
4915
  export declare function sweepOrphanedGraphNodePoints(qdrant: GraphNodeSweepClient): Promise<GraphNodeSweepResult>;
5169
4916
 
5170
- declare type SyncChangedEvent = z.infer<typeof SyncChangedEventSchema>;
5171
-
5172
- declare const SyncChangedEventSchema: z.ZodObject<{
5173
- type: z.ZodLiteral<"sync_changed">;
5174
- tags: z.ZodArray<z.ZodString>;
5175
- originClientId: z.ZodOptional<z.ZodString>;
5176
- }, z.core.$strip>;
5177
-
5178
- declare type _SyncInvalidationServerMessages = SyncChangedEvent;
5179
-
5180
4917
  /** Re-sync one persisted message into the conversation's disk view. */
5181
4918
  export declare function syncMessageToDisk(conversationId: string, messageId: string, createdAtMs: number): Promise<void>;
5182
4919
 
@@ -5650,36 +5387,6 @@ export declare interface ToolExecutionResult {
5650
5387
  activityMetadata?: ToolActivityMetadata;
5651
5388
  }
5652
5389
 
5653
- declare type ToolInputDeltaEvent = z.infer<typeof ToolInputDeltaEventSchema>;
5654
-
5655
- declare const ToolInputDeltaEventSchema: z.ZodObject<{
5656
- type: z.ZodLiteral<"tool_input_delta">;
5657
- toolName: z.ZodString;
5658
- content: z.ZodString;
5659
- conversationId: z.ZodOptional<z.ZodString>;
5660
- toolUseId: z.ZodOptional<z.ZodString>;
5661
- messageId: z.ZodOptional<z.ZodString>;
5662
- }, z.core.$strip>;
5663
-
5664
- declare type ToolOutputChunkEvent = z.infer<typeof ToolOutputChunkEventSchema>;
5665
-
5666
- declare const ToolOutputChunkEventSchema: z.ZodObject<{
5667
- type: z.ZodLiteral<"tool_output_chunk">;
5668
- chunk: z.ZodString;
5669
- conversationId: z.ZodOptional<z.ZodString>;
5670
- toolUseId: z.ZodOptional<z.ZodString>;
5671
- subType: z.ZodOptional<z.ZodEnum<{
5672
- status: "status";
5673
- tool_start: "tool_start";
5674
- tool_complete: "tool_complete";
5675
- }>>;
5676
- subToolName: z.ZodOptional<z.ZodString>;
5677
- subToolInput: z.ZodOptional<z.ZodString>;
5678
- subToolIsError: z.ZodOptional<z.ZodBoolean>;
5679
- subToolId: z.ZodOptional<z.ZodString>;
5680
- messageId: z.ZodOptional<z.ZodString>;
5681
- }, z.core.$strip>;
5682
-
5683
5390
  export declare interface ToolResultContent {
5684
5391
  type: "tool_result";
5685
5392
  tool_use_id: string;
@@ -5689,94 +5396,6 @@ export declare interface ToolResultContent {
5689
5396
  contentBlocks?: ContentBlock[];
5690
5397
  }
5691
5398
 
5692
- declare type ToolResultEvent = z.infer<typeof ToolResultEventSchema>;
5693
-
5694
- declare const ToolResultEventSchema: z.ZodObject<{
5695
- type: z.ZodLiteral<"tool_result">;
5696
- toolName: z.ZodString;
5697
- result: z.ZodString;
5698
- isError: z.ZodOptional<z.ZodBoolean>;
5699
- diff: z.ZodOptional<z.ZodObject<{
5700
- filePath: z.ZodString;
5701
- oldContent: z.ZodString;
5702
- newContent: z.ZodString;
5703
- isNewFile: z.ZodBoolean;
5704
- }, z.core.$strip>>;
5705
- status: z.ZodOptional<z.ZodString>;
5706
- conversationId: z.ZodOptional<z.ZodString>;
5707
- imageData: z.ZodOptional<z.ZodString>;
5708
- imageDataList: z.ZodOptional<z.ZodArray<z.ZodString>>;
5709
- toolUseId: z.ZodOptional<z.ZodString>;
5710
- messageId: z.ZodOptional<z.ZodString>;
5711
- riskLevel: z.ZodOptional<z.ZodString>;
5712
- riskReason: z.ZodOptional<z.ZodString>;
5713
- matchedTrustRuleId: z.ZodOptional<z.ZodString>;
5714
- isContainerized: z.ZodOptional<z.ZodBoolean>;
5715
- riskScopeOptions: z.ZodOptional<z.ZodArray<z.ZodObject<{
5716
- pattern: z.ZodString;
5717
- label: z.ZodString;
5718
- }, z.core.$strip>>>;
5719
- riskAllowlistOptions: z.ZodOptional<z.ZodArray<z.ZodObject<{
5720
- label: z.ZodString;
5721
- description: z.ZodString;
5722
- pattern: z.ZodString;
5723
- }, z.core.$strip>>>;
5724
- riskDirectoryScopeOptions: z.ZodOptional<z.ZodArray<z.ZodObject<{
5725
- label: z.ZodString;
5726
- scope: z.ZodString;
5727
- }, z.core.$strip>>>;
5728
- approvalMode: z.ZodOptional<z.ZodString>;
5729
- approvalReason: z.ZodOptional<z.ZodString>;
5730
- riskThreshold: z.ZodOptional<z.ZodString>;
5731
- activityMetadata: z.ZodOptional<z.ZodObject<{
5732
- webSearch: z.ZodOptional<z.ZodObject<{
5733
- query: z.ZodString;
5734
- provider: z.ZodEnum<{
5735
- "anthropic-native": "anthropic-native";
5736
- brave: "brave";
5737
- perplexity: "perplexity";
5738
- tavily: "tavily";
5739
- firecrawl: "firecrawl";
5740
- }>;
5741
- resultCount: z.ZodNumber;
5742
- durationMs: z.ZodNumber;
5743
- results: z.ZodArray<z.ZodObject<{
5744
- rank: z.ZodNumber;
5745
- title: z.ZodString;
5746
- url: z.ZodString;
5747
- domain: z.ZodString;
5748
- faviconUrl: z.ZodOptional<z.ZodString>;
5749
- snippet: z.ZodOptional<z.ZodString>;
5750
- age: z.ZodOptional<z.ZodString>;
5751
- score: z.ZodOptional<z.ZodNumber>;
5752
- }, z.core.$strip>>;
5753
- errorMessage: z.ZodOptional<z.ZodString>;
5754
- }, z.core.$strip>>;
5755
- webFetch: z.ZodOptional<z.ZodObject<{
5756
- url: z.ZodString;
5757
- finalUrl: z.ZodString;
5758
- provider: z.ZodOptional<z.ZodEnum<{
5759
- default: "default";
5760
- firecrawl: "firecrawl";
5761
- }>>;
5762
- status: z.ZodNumber;
5763
- contentType: z.ZodOptional<z.ZodString>;
5764
- byteCount: z.ZodNumber;
5765
- charCount: z.ZodNumber;
5766
- truncated: z.ZodBoolean;
5767
- title: z.ZodOptional<z.ZodString>;
5768
- domain: z.ZodString;
5769
- faviconUrl: z.ZodOptional<z.ZodString>;
5770
- redirectCount: z.ZodNumber;
5771
- durationMs: z.ZodNumber;
5772
- errorMessage: z.ZodOptional<z.ZodString>;
5773
- mayRequireJavaScript: z.ZodOptional<z.ZodBoolean>;
5774
- }, z.core.$strip>>;
5775
- }, z.core.$strip>>;
5776
- errorCode: z.ZodOptional<z.ZodString>;
5777
- completedAt: z.ZodOptional<z.ZodNumber>;
5778
- }, z.core.$strip>;
5779
-
5780
5399
  export declare interface ToolUseContent {
5781
5400
  type: "tool_use";
5782
5401
  id: string;
@@ -5789,30 +5408,6 @@ export declare interface ToolUseContent {
5789
5408
  };
5790
5409
  }
5791
5410
 
5792
- declare type ToolUsePreviewStartEvent = z.infer<typeof ToolUsePreviewStartEventSchema>;
5793
-
5794
- declare const ToolUsePreviewStartEventSchema: z.ZodObject<{
5795
- type: z.ZodLiteral<"tool_use_preview_start">;
5796
- toolUseId: z.ZodString;
5797
- toolName: z.ZodString;
5798
- conversationId: z.ZodOptional<z.ZodString>;
5799
- messageId: z.ZodOptional<z.ZodString>;
5800
- previewStartedAt: z.ZodOptional<z.ZodNumber>;
5801
- }, z.core.$strip>;
5802
-
5803
- declare type ToolUseStartEvent = z.infer<typeof ToolUseStartEventSchema>;
5804
-
5805
- declare const ToolUseStartEventSchema: z.ZodObject<{
5806
- type: z.ZodLiteral<"tool_use_start">;
5807
- toolName: z.ZodString;
5808
- input: z.ZodRecord<z.ZodString, z.ZodUnknown>;
5809
- toolUseId: z.ZodOptional<z.ZodString>;
5810
- messageId: z.ZodOptional<z.ZodString>;
5811
- conversationId: z.ZodOptional<z.ZodString>;
5812
- startedAt: z.ZodOptional<z.ZodNumber>;
5813
- previewStartedAt: z.ZodOptional<z.ZodNumber>;
5814
- }, z.core.$strip>;
5815
-
5816
5411
  declare type TrustClass = z.infer<typeof trustClassSchema>;
5817
5412
 
5818
5413
  declare const trustClassSchema: z.ZodEnum<{
@@ -5847,76 +5442,9 @@ declare type TtsUseCase =
5847
5442
  /** In-app message playback — buffer-oriented, higher quality acceptable. */
5848
5443
  | "message-playback";
5849
5444
 
5850
- declare type UISurfaceCompleteEvent = z.infer<typeof UISurfaceCompleteEventSchema>;
5851
-
5852
- declare const UISurfaceCompleteEventSchema: z.ZodObject<{
5853
- type: z.ZodLiteral<"ui_surface_complete">;
5854
- conversationId: z.ZodString;
5855
- surfaceId: z.ZodString;
5856
- summary: z.ZodString;
5857
- submittedData: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
5858
- }, z.core.$strip>;
5859
-
5860
- declare type UISurfaceDismissEvent = z.infer<typeof UISurfaceDismissEventSchema>;
5861
-
5862
- declare const UISurfaceDismissEventSchema: z.ZodObject<{
5863
- type: z.ZodLiteral<"ui_surface_dismiss">;
5864
- conversationId: z.ZodString;
5865
- surfaceId: z.ZodString;
5866
- }, z.core.$strip>;
5867
-
5868
- declare type UISurfaceShowEvent = z.infer<typeof UISurfaceShowEventSchema>;
5869
-
5870
- declare const UISurfaceShowEventSchema: z.ZodObject<{
5871
- type: z.ZodLiteral<"ui_surface_show">;
5872
- conversationId: z.ZodString;
5873
- surfaceId: z.ZodString;
5874
- surfaceType: z.ZodString;
5875
- title: z.ZodOptional<z.ZodString>;
5876
- data: z.ZodRecord<z.ZodString, z.ZodUnknown>;
5877
- actions: z.ZodOptional<z.ZodArray<z.ZodObject<{
5878
- id: z.ZodString;
5879
- label: z.ZodString;
5880
- style: z.ZodOptional<z.ZodEnum<{
5881
- primary: "primary";
5882
- secondary: "secondary";
5883
- destructive: "destructive";
5884
- }>>;
5885
- data: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
5886
- }, z.core.$strip>>>;
5887
- display: z.ZodOptional<z.ZodEnum<{
5888
- inline: "inline";
5889
- panel: "panel";
5890
- }>>;
5891
- messageId: z.ZodOptional<z.ZodString>;
5892
- persistent: z.ZodOptional<z.ZodBoolean>;
5893
- toolCallId: z.ZodOptional<z.ZodString>;
5894
- }, z.core.$strip>;
5895
-
5896
- declare type UISurfaceUndoResultEvent = z.infer<typeof UISurfaceUndoResultEventSchema>;
5897
-
5898
- declare const UISurfaceUndoResultEventSchema: z.ZodObject<{
5899
- type: z.ZodLiteral<"ui_surface_undo_result">;
5900
- conversationId: z.ZodString;
5901
- surfaceId: z.ZodString;
5902
- success: z.ZodBoolean;
5903
- remainingUndos: z.ZodNumber;
5904
- }, z.core.$strip>;
5905
-
5906
- declare type UISurfaceUpdateEvent = z.infer<typeof UISurfaceUpdateEventSchema>;
5907
-
5908
- declare const UISurfaceUpdateEventSchema: z.ZodObject<{
5909
- type: z.ZodLiteral<"ui_surface_update">;
5910
- conversationId: z.ZodString;
5911
- surfaceId: z.ZodString;
5912
- data: z.ZodRecord<z.ZodString, z.ZodUnknown>;
5913
- }, z.core.$strip>;
5914
-
5915
5445
  /** Merge the given keys into a message's metadata JSON. */
5916
5446
  export declare function updateMessageMetadata(messageId: string, updates: Record<string, unknown>): Promise<void>;
5917
5447
 
5918
- declare type _UpgradesServerMessages = ServiceGroupUpdateStartingEvent | ServiceGroupUpdateProgressEvent | ServiceGroupUpdateCompleteEvent;
5919
-
5920
5448
  declare type UsageAttributionProfileSource = "call_site" | "conversation" | "active" | "default" | "unknown";
5921
5449
 
5922
5450
  declare interface UsageAttributionSnapshot {
@@ -5936,45 +5464,6 @@ declare interface UsageAttributionSnapshot {
5936
5464
  resolvedMixArm: string | null;
5937
5465
  }
5938
5466
 
5939
- declare type UsageProgressEvent = z.infer<typeof UsageProgressEventSchema>;
5940
-
5941
- declare const UsageProgressEventSchema: z.ZodObject<{
5942
- type: z.ZodLiteral<"usage_progress">;
5943
- conversationId: z.ZodString;
5944
- inputTokens: z.ZodNumber;
5945
- outputTokens: z.ZodNumber;
5946
- estimatedCost: z.ZodNumber;
5947
- model: z.ZodString;
5948
- }, z.core.$strip>;
5949
-
5950
- declare type UsageUpdateEvent = z.infer<typeof UsageUpdateEventSchema>;
5951
-
5952
- declare const UsageUpdateEventSchema: z.ZodObject<{
5953
- type: z.ZodLiteral<"usage_update">;
5954
- conversationId: z.ZodString;
5955
- inputTokens: z.ZodNumber;
5956
- outputTokens: z.ZodNumber;
5957
- cacheCreationInputTokens: z.ZodOptional<z.ZodNumber>;
5958
- cacheReadInputTokens: z.ZodOptional<z.ZodNumber>;
5959
- totalInputTokens: z.ZodNumber;
5960
- totalOutputTokens: z.ZodNumber;
5961
- estimatedCost: z.ZodNumber;
5962
- model: z.ZodString;
5963
- contextWindowTokens: z.ZodOptional<z.ZodNumber>;
5964
- contextWindowMaxTokens: z.ZodOptional<z.ZodNumber>;
5965
- }, z.core.$strip>;
5966
-
5967
- declare type UserMessageEchoEvent = z.infer<typeof UserMessageEchoEventSchema>;
5968
-
5969
- declare const UserMessageEchoEventSchema: z.ZodObject<{
5970
- type: z.ZodLiteral<"user_message_echo">;
5971
- text: z.ZodString;
5972
- conversationId: z.ZodOptional<z.ZodString>;
5973
- messageId: z.ZodOptional<z.ZodString>;
5974
- requestId: z.ZodOptional<z.ZodString>;
5975
- clientMessageId: z.ZodOptional<z.ZodString>;
5976
- }, z.core.$strict>;
5977
-
5978
5467
  /**
5979
5468
  * The full `user-prompt-submit` context a hook receives — the dispatching
5980
5469
  * call site's {@link UserPromptSubmitInputContext} plus the pipeline-stamped
@@ -6139,79 +5628,6 @@ export declare interface WebSearchToolResultContent {
6139
5628
  content: unknown;
6140
5629
  }
6141
5630
 
6142
- declare type WorkflowCompletedEvent = z.infer<typeof WorkflowCompletedEventSchema>;
6143
-
6144
- declare const WorkflowCompletedEventSchema: z.ZodObject<{
6145
- type: z.ZodLiteral<"workflow_completed">;
6146
- runId: z.ZodString;
6147
- conversationId: z.ZodOptional<z.ZodString>;
6148
- status: z.ZodEnum<{
6149
- completed: "completed";
6150
- failed: "failed";
6151
- running: "running";
6152
- aborted: "aborted";
6153
- interrupted: "interrupted";
6154
- cap_exceeded: "cap_exceeded";
6155
- }>;
6156
- agentsSpawned: z.ZodNumber;
6157
- inputTokens: z.ZodNumber;
6158
- outputTokens: z.ZodNumber;
6159
- summary: z.ZodOptional<z.ZodString>;
6160
- }, z.core.$strict>;
6161
-
6162
- declare type WorkflowLeafFinishedEvent = z.infer<typeof WorkflowLeafFinishedEventSchema>;
6163
-
6164
- declare const WorkflowLeafFinishedEventSchema: z.ZodObject<{
6165
- type: z.ZodLiteral<"workflow_leaf_finished">;
6166
- runId: z.ZodString;
6167
- conversationId: z.ZodString;
6168
- seq: z.ZodNumber;
6169
- status: z.ZodEnum<{
6170
- completed: "completed";
6171
- failed: "failed";
6172
- }>;
6173
- label: z.ZodOptional<z.ZodString>;
6174
- inputTokens: z.ZodOptional<z.ZodNumber>;
6175
- outputTokens: z.ZodOptional<z.ZodNumber>;
6176
- resultSummary: z.ZodOptional<z.ZodString>;
6177
- }, z.core.$strict>;
6178
-
6179
- declare type WorkflowLeafStartedEvent = z.infer<typeof WorkflowLeafStartedEventSchema>;
6180
-
6181
- declare const WorkflowLeafStartedEventSchema: z.ZodObject<{
6182
- type: z.ZodLiteral<"workflow_leaf_started">;
6183
- runId: z.ZodString;
6184
- conversationId: z.ZodString;
6185
- seq: z.ZodNumber;
6186
- label: z.ZodOptional<z.ZodString>;
6187
- phase: z.ZodOptional<z.ZodString>;
6188
- promptSummary: z.ZodOptional<z.ZodString>;
6189
- }, z.core.$strict>;
6190
-
6191
- declare type WorkflowProgressEvent = z.infer<typeof WorkflowProgressEventSchema>;
6192
-
6193
- declare const WorkflowProgressEventSchema: z.ZodObject<{
6194
- type: z.ZodLiteral<"workflow_progress">;
6195
- runId: z.ZodString;
6196
- conversationId: z.ZodOptional<z.ZodString>;
6197
- agentsSpawned: z.ZodNumber;
6198
- phase: z.ZodOptional<z.ZodString>;
6199
- label: z.ZodOptional<z.ZodString>;
6200
- message: z.ZodOptional<z.ZodString>;
6201
- }, z.core.$strict>;
6202
-
6203
- declare type _WorkflowsServerMessages = WorkflowProgressEvent | WorkflowCompletedEvent | WorkflowStartedEvent | WorkflowLeafStartedEvent | WorkflowLeafFinishedEvent;
6204
-
6205
- declare type WorkflowStartedEvent = z.infer<typeof WorkflowStartedEventSchema>;
6206
-
6207
- declare const WorkflowStartedEventSchema: z.ZodObject<{
6208
- type: z.ZodLiteral<"workflow_started">;
6209
- runId: z.ZodString;
6210
- conversationId: z.ZodString;
6211
- toolUseId: z.ZodOptional<z.ZodString>;
6212
- label: z.ZodOptional<z.ZodString>;
6213
- }, z.core.$strict>;
6214
-
6215
5631
  /**
6216
5632
  * A reference to bytes stored in the workspace rather than inlined. The bytes
6217
5633
  * live in the workspace attachment store, addressed by `attachmentId`, and are
@@ -6237,6 +5653,4 @@ declare interface WorkspaceRefMediaSource {
6237
5653
  height?: number;
6238
5654
  }
6239
5655
 
6240
- declare type _WorkspaceServerMessages = IdentityChangedEvent;
6241
-
6242
5656
  export { }