@niwa-labs/harness-zcode 0.0.0-stage → 0.0.0
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.
- package/LICENSE +21 -0
- package/README.md +8 -2
- package/package.json +20 -4
- package/scripts/gen-zcode.ts +384 -0
- package/src/config.ts +33 -0
- package/src/control.ts +1478 -0
- package/src/dispatch.ts +211 -0
- package/src/fixtures.ts +175 -0
- package/src/format.ts +153 -0
- package/src/index.ts +116 -0
- package/src/paths.ts +21 -0
- package/src/protocol/generated/zcode-protocol.ts +393 -0
- package/src/protocol/index.ts +230 -0
- package/src/reading.ts +506 -0
- package/src/reverse.ts +170 -0
- package/src/skills.ts +6 -0
- package/src/tools.ts +45 -0
- package/test/conformance.test.ts +29 -0
- package/test/control.test.ts +983 -0
- package/test/fixtures/zcode/captured-0.17.3.ndjson +23 -0
- package/test/fixtures/zcode/session-messages-0.17.3.json +241 -0
- package/test/live/control.test.ts +195 -0
- package/test/mode.test.ts +100 -0
- package/test/profile.test.ts +20 -0
- package/test/protocol.test.ts +437 -0
- package/test/reading.test.ts +332 -0
- package/tsconfig.json +8 -0
|
@@ -0,0 +1,393 @@
|
|
|
1
|
+
// GENERATED by scripts/gen-zcode.ts: do not edit. Regenerate with:
|
|
2
|
+
// bun scripts/gen-zcode.ts --zcode <ZCode checkout>
|
|
3
|
+
//
|
|
4
|
+
// Upstream: ZCode 3.18.2 (apps/zcode-cli 0.17.1), commit fec975905a2abd4c07e35c40d51fa097a2258ec9 ("chore: sync ZCode source v3.18.2"),
|
|
5
|
+
// packages/shared/src/zcode-protocol (zod, converted with z.toJSONSchema, then json-schema-to-zod).
|
|
6
|
+
// Objects are not strict (a field a newer ZCode adds is dropped, not a reason to lose the message);
|
|
7
|
+
// What ZCode leaves open (z.unknown()) stays unknown, never any. Refinements and transforms are not carried.
|
|
8
|
+
|
|
9
|
+
import { z } from "zod";
|
|
10
|
+
|
|
11
|
+
export const NotificationSessionEventSessionCreatedSchema = z.object({ "eventId": z.string().min(1), "sessionId": z.string().min(1), "turnId": z.string().min(1).optional(), "seq": z.number().int().gte(0).lte(9007199254740991), "traceId": z.string().min(1).optional(), "timestamp": z.number().int().gte(0).lte(9007199254740991), "deliveryKind": z.enum(["desktop-continuous","web-remote-replayable"]).optional(), "type": z.literal("session.created"), "payload": z.object({ "mode": z.enum(["plan","build","edit","yolo","guarded","auto"]), "contextWindow": z.number().int().gte(0).lte(9007199254740991) }).optional() });
|
|
12
|
+
export type NotificationSessionEventSessionCreated = z.output<typeof NotificationSessionEventSessionCreatedSchema>;
|
|
13
|
+
|
|
14
|
+
export const NotificationSessionEventSessionResumedSchema = z.object({ "eventId": z.string().min(1), "sessionId": z.string().min(1), "turnId": z.string().min(1).optional(), "seq": z.number().int().gte(0).lte(9007199254740991), "traceId": z.string().min(1).optional(), "timestamp": z.number().int().gte(0).lte(9007199254740991), "deliveryKind": z.enum(["desktop-continuous","web-remote-replayable"]).optional(), "type": z.literal("session.resumed"), "payload": z.object({ "directory": z.string().min(1), "interruptedToolCount": z.number().int().gte(0).lte(9007199254740991), "messageCount": z.number().int().gte(0).lte(9007199254740991), "partCount": z.number().int().gte(0).lte(9007199254740991), "recoveredCompactTimelineCount": z.number().int().gte(0).lte(9007199254740991).optional(), "recoveredSteerInputCount": z.number().int().gte(0).lte(9007199254740991).optional(), "resumedTodoCount": z.number().int().gte(0).lte(9007199254740991).optional() }).optional() });
|
|
15
|
+
export type NotificationSessionEventSessionResumed = z.output<typeof NotificationSessionEventSessionResumedSchema>;
|
|
16
|
+
|
|
17
|
+
export const NotificationSessionEventSessionUpdatedSchema = z.object({ "eventId": z.string().min(1), "sessionId": z.string().min(1), "turnId": z.string().min(1).optional(), "seq": z.number().int().gte(0).lte(9007199254740991), "traceId": z.string().min(1).optional(), "timestamp": z.number().int().gte(0).lte(9007199254740991), "deliveryKind": z.enum(["desktop-continuous","web-remote-replayable"]).optional(), "type": z.literal("session.updated"), "payload": z.record(z.string(), z.unknown()).optional() });
|
|
18
|
+
export type NotificationSessionEventSessionUpdated = z.output<typeof NotificationSessionEventSessionUpdatedSchema>;
|
|
19
|
+
|
|
20
|
+
export const NotificationSessionEventSessionTitleUpdatedSchema = z.object({ "eventId": z.string().min(1), "sessionId": z.string().min(1), "turnId": z.string().min(1).optional(), "seq": z.number().int().gte(0).lte(9007199254740991), "traceId": z.string().min(1).optional(), "timestamp": z.number().int().gte(0).lte(9007199254740991), "deliveryKind": z.enum(["desktop-continuous","web-remote-replayable"]).optional(), "type": z.literal("session.titleUpdated"), "payload": z.object({ "messageID": z.string().min(1).optional(), "previousTitle": z.string(), "source": z.enum(["default","first_input","generated","custom"]), "title": z.string() }).optional() });
|
|
21
|
+
export type NotificationSessionEventSessionTitleUpdated = z.output<typeof NotificationSessionEventSessionTitleUpdatedSchema>;
|
|
22
|
+
|
|
23
|
+
export const NotificationSessionEventSessionClosedSchema = z.object({ "eventId": z.string().min(1), "sessionId": z.string().min(1), "turnId": z.string().min(1).optional(), "seq": z.number().int().gte(0).lte(9007199254740991), "traceId": z.string().min(1).optional(), "timestamp": z.number().int().gte(0).lte(9007199254740991), "deliveryKind": z.enum(["desktop-continuous","web-remote-replayable"]).optional(), "type": z.literal("session.closed"), "payload": z.object({ "reason": z.string().optional() }).optional() });
|
|
24
|
+
export type NotificationSessionEventSessionClosed = z.output<typeof NotificationSessionEventSessionClosedSchema>;
|
|
25
|
+
|
|
26
|
+
export const NotificationSessionEventTurnStartedSchema = z.object({ "eventId": z.string().min(1), "sessionId": z.string().min(1), "turnId": z.string().min(1).optional(), "seq": z.number().int().gte(0).lte(9007199254740991), "traceId": z.string().min(1).optional(), "timestamp": z.number().int().gte(0).lte(9007199254740991), "deliveryKind": z.enum(["desktop-continuous","web-remote-replayable"]).optional(), "type": z.literal("turn.started"), "payload": z.object({ "executionStartedAt": z.number().gte(0).optional(), "workflowLaunch": z.object({ "runId": z.string().min(1).max(128), "toolCallId": z.string().min(1).max(128), "name": z.string().min(1).max(200).optional(), "scope": z.enum(["project","global"]).optional(), "path": z.string().min(1).max(1024).optional(), "args": z.record(z.string(), z.unknown()).optional(), "description": z.string().max(500).optional(), "display": z.object({ "kind": z.literal("create_workflow"), "ok": z.boolean(), "errorCount": z.number().int().gte(0).lte(9007199254740991), "diagnostics": z.array(z.object({ "line": z.number().int().gte(0).lte(9007199254740991), "column": z.number().int().gte(0).lte(9007199254740991), "code": z.number().int().gte(0).lte(9007199254740991), "message": z.string().min(1).max(2048) })).max(100), "causalityGraph": z.object({ "steps": z.array(z.object({ "id": z.string().min(1).max(64), "kind": z.enum(["ask","world-read","hole"]), "label": z.string().min(1).max(128), "labelPattern": z.object({ "head": z.string().min(1).max(128).optional(), "tail": z.string().min(1).max(128).optional() }).optional(), "line": z.number().int().gt(0).lte(9007199254740991).optional(), "column": z.number().int().gt(0).lte(9007199254740991).optional(), "lane": z.string().min(1).max(64), "lanes": z.array(z.string().min(1).max(64)).max(32).optional(), "source": z.string().min(1).max(64).optional(), "phase": z.string().min(1).max(64).optional(), "repeat": z.enum(["stack","serial"]).optional(), "fill": z.string().min(1).max(64).optional() })).max(64), "lanes": z.array(z.object({ "id": z.string().min(1).max(64), "name": z.string().min(1).max(128).optional(), "namePattern": z.object({ "head": z.string().min(1).max(128).optional(), "tail": z.string().min(1).max(128).optional() }).optional(), "line": z.number().int().gt(0).lte(9007199254740991).optional(), "column": z.number().int().gt(0).lte(9007199254740991).optional() })).max(32), "participants": z.array(z.object({ "id": z.string().min(1).max(64), "phase": z.string().min(1).max(64), "lane": z.string().min(1).max(64), "steps": z.array(z.string().min(1).max(64)).min(1).max(64), "member": z.object({ "index": z.number().int().gte(0).lte(9007199254740991), "of": z.number().int().gt(0).lte(9007199254740991) }).optional(), "many": z.literal(true).optional() })).max(64), "handoffs": z.array(z.object({ "from": z.string().min(1).max(64), "to": z.string().min(1).max(64), "back": z.literal(true).optional(), "types": z.array(z.string().min(1).max(128)).min(1).max(8).optional() })).max(256), "phases": z.array(z.object({ "id": z.string().min(1).max(64), "name": z.string().min(1).max(128).optional(), "line": z.number().int().gt(0).lte(9007199254740991).optional(), "column": z.number().int().gt(0).lte(9007199254740991).optional(), "alongside": z.array(z.string().min(1).max(64)).min(1).max(32).optional(), "fill": z.string().min(1).max(64).optional() })).max(32).optional(), "phaseEdges": z.array(z.object({ "from": z.string().min(1).max(64), "to": z.string().min(1).max(64), "back": z.literal(true).optional() })).max(128).optional(), "phaseStreams": z.array(z.object({ "from": z.string().min(1).max(64), "to": z.string().min(1).max(64) })).max(128).optional(), "holes": z.array(z.object({ "siteId": z.string().min(1).max(64), "name": z.string().min(1).max(128), "type": z.string().min(1).max(128), "phase": z.string().min(1).max(64).optional(), "tail": z.boolean().optional() })).max(32).optional(), "exits": z.array(z.string().min(1).max(64)).max(32).optional(), "sink": z.array(z.string().min(1).max(64)).max(64).optional(), "truncated": z.boolean().optional() }).optional(), "truncated": z.boolean().optional(), "fill": z.object({ "siteId": z.string().min(1).max(64), "name": z.string().min(1).max(128), "draftPath": z.string().min(1).max(1024).optional(), "line": z.number().int().gt(0).lte(9007199254740991).optional() }).optional() }).optional(), "script": z.string().max(256000).optional(), "amend": z.object({ "predecessorRunId": z.string().min(1).max(128).optional(), "subagentModel": z.object({ "from": z.string().min(1).max(256).optional(), "to": z.string().min(1).max(256).optional() }).optional(), "maxConcurrency": z.object({ "from": z.number().int().gt(0).lte(9007199254740991).optional(), "to": z.number().int().gt(0).lte(9007199254740991).optional() }).optional(), "ceiling": z.number().int().gt(0).lte(9007199254740991).optional() }).optional() }).optional(), "epilogueStart": z.number().int().gte(0).lte(9007199254740991).optional(), "turnNumber": z.number().int().gte(0).lte(9007199254740991), "input": z.string(), "inputId": z.string().min(1).optional(), "queryId": z.string().min(1).optional(), "automationId": z.string().min(1).optional(), "offPeakTaskId": z.string().min(1).optional(), "offPeakRunType": z.enum(["init","resume"]).optional(), "inputSource": z.enum(["agent_listing_delta","background_task","fork","goal_state_change","goal-continuation","plugin_reference","bot_topic_context","rewind","selection_side_chat","subagent","subagent_message","todo_reminder","workflow_launch","shared_context"]).optional(), "inputOrigin": z.enum(["desktop","mobile"]).optional(), "inputVisibility": z.enum(["user-visible","model-only"]).optional(), "executionKind": z.enum(["agent","controlOnly"]).optional(), "targetId": z.string().min(1).optional(), "messageId": z.string().min(1).optional(), "foregroundExecutionId": z.string().min(1).optional(), "intent": z.record(z.string(), z.unknown()).optional(), "originMeta": z.record(z.string(), z.unknown()).optional(), "backgroundSource": z.enum(["bash","subagent"]).optional(), "attachments": z.array(z.record(z.string(), z.unknown())).optional() }).optional() });
|
|
27
|
+
export type NotificationSessionEventTurnStarted = z.output<typeof NotificationSessionEventTurnStartedSchema>;
|
|
28
|
+
|
|
29
|
+
export const NotificationSessionEventTurnSteerQueuedSchema = z.object({ "eventId": z.string().min(1), "sessionId": z.string().min(1), "turnId": z.string().min(1).optional(), "seq": z.number().int().gte(0).lte(9007199254740991), "traceId": z.string().min(1).optional(), "timestamp": z.number().int().gte(0).lte(9007199254740991), "deliveryKind": z.enum(["desktop-continuous","web-remote-replayable"]).optional(), "type": z.literal("turn.steerQueued"), "payload": z.object({ "pendingInputId": z.string().min(1), "inputId": z.string().min(1).optional(), "queryId": z.string().min(1).optional(), "input": z.string(), "inputPreview": z.string(), "inputSize": z.number().int().gte(0).lte(9007199254740991), "commandKind": z.enum(["sendText","sendGoalCommand","compact"]).optional(), "source": z.enum(["plan_approval_feedback","workflow_refine_feedback"]).optional(), "inputPresentation": z.string().min(1).optional(), "automationId": z.string().min(1).optional(), "toolDisallowlist": z.array(z.string().min(1)).optional(), "delivery": z.enum(["queue","guide"]).optional(), "targetTurnId": z.string().min(1), "queueLength": z.number().int().gte(0).lte(9007199254740991), "intent": z.record(z.string(), z.unknown()).optional() }).optional() });
|
|
30
|
+
export type NotificationSessionEventTurnSteerQueued = z.output<typeof NotificationSessionEventTurnSteerQueuedSchema>;
|
|
31
|
+
|
|
32
|
+
export const NotificationSessionEventTurnSteerDrainedSchema = z.object({ "eventId": z.string().min(1), "sessionId": z.string().min(1), "turnId": z.string().min(1).optional(), "seq": z.number().int().gte(0).lte(9007199254740991), "traceId": z.string().min(1).optional(), "timestamp": z.number().int().gte(0).lte(9007199254740991), "deliveryKind": z.enum(["desktop-continuous","web-remote-replayable"]).optional(), "type": z.literal("turn.steerDrained"), "payload": z.object({ "pendingInputIds": z.array(z.string().min(1)), "queryIds": z.array(z.string().min(1)).optional(), "targetTurnId": z.string().min(1), "injectedMessageIds": z.array(z.string().min(1)), "drainedInputs": z.array(z.object({ "pendingInputId": z.string().min(1), "messageId": z.string().min(1), "text": z.string(), "delivery": z.enum(["queue","guide"]).optional(), "intent": z.record(z.string(), z.unknown()).optional(), "toolDisallowlist": z.array(z.string().min(1)).optional() })).optional() }).optional() });
|
|
33
|
+
export type NotificationSessionEventTurnSteerDrained = z.output<typeof NotificationSessionEventTurnSteerDrainedSchema>;
|
|
34
|
+
|
|
35
|
+
export const NotificationSessionEventTurnCompletedSchema = z.object({ "eventId": z.string().min(1), "sessionId": z.string().min(1), "turnId": z.string().min(1).optional(), "seq": z.number().int().gte(0).lte(9007199254740991), "traceId": z.string().min(1).optional(), "timestamp": z.number().int().gte(0).lte(9007199254740991), "deliveryKind": z.enum(["desktop-continuous","web-remote-replayable"]).optional(), "type": z.literal("turn.completed"), "payload": z.object({ "response": z.string(), "tokenCount": z.number().int().gte(0).lte(9007199254740991), "usage": z.unknown().optional(), "toolCallCount": z.number().int().gte(0).lte(9007199254740991), "historyRoundCount": z.number().int().gte(0).lte(9007199254740991).optional(), "duration": z.number().gte(0), "cacheStats": z.object({ "totalMessages": z.number().int().gte(0).lte(9007199254740991), "cachedMessages": z.number().int().gte(0).lte(9007199254740991), "lastCacheHit": z.boolean(), "cacheReadTokens": z.number().int().gte(0).lte(9007199254740991).optional() }).optional(), "inputId": z.string().min(1).optional(), "resultType": z.enum(["success","cancelled","error_max_turns","error_max_budget","error_during_execution","error_max_tool_calls"]), "backgroundSubagentResultConsumed": z.boolean().optional() }).optional() });
|
|
36
|
+
export type NotificationSessionEventTurnCompleted = z.output<typeof NotificationSessionEventTurnCompletedSchema>;
|
|
37
|
+
|
|
38
|
+
export const NotificationSessionEventTurnFailedSchema = z.object({ "eventId": z.string().min(1), "sessionId": z.string().min(1), "turnId": z.string().min(1).optional(), "seq": z.number().int().gte(0).lte(9007199254740991), "traceId": z.string().min(1).optional(), "timestamp": z.number().int().gte(0).lte(9007199254740991), "deliveryKind": z.enum(["desktop-continuous","web-remote-replayable"]).optional(), "type": z.literal("turn.failed"), "payload": z.object({ "error": z.object({ "type": z.string().min(1), "message": z.string().min(1), "stack": z.string().optional(), "code": z.string().optional(), "detail": z.string().optional(), "underlyingErrorMessage": z.string().optional(), "underlyingErrorDetail": z.string().optional(), "attribution": z.object({ "source": z.enum(["provider","runtime","tool","network"]).optional(), "reason": z.string().min(1).max(160).optional(), "errorPhase": z.enum(["prepare","configuration","connect","response","stream","parse","validation","unhandled"]).optional(), "exceptionKind": z.enum(["api_call","generic","protocol","provider_business","transport","type_error","validation"]).optional(), "providerId": z.string().min(1).max(160).optional(), "modelId": z.string().min(1).max(160).optional(), "providerKind": z.string().min(1).max(160).optional(), "transport": z.enum(["http","sse","websocket"]).optional(), "statusCode": z.number().int().gte(100).lte(599).optional(), "providerErrorCode": z.string().min(1).max(160).optional(), "retryable": z.boolean().optional(), "highspeedCardId": z.union([z.string(), z.null()]).optional(), "highspeedFallbackUnavailable": z.boolean().optional() }).optional(), "retryable": z.boolean().optional(), "data": z.unknown().optional() }), "turnPhase": z.string(), "inputId": z.string().min(1).optional(), "backgroundSubagentResultConsumed": z.boolean().optional() }).optional() });
|
|
39
|
+
export type NotificationSessionEventTurnFailed = z.output<typeof NotificationSessionEventTurnFailedSchema>;
|
|
40
|
+
|
|
41
|
+
export const NotificationSessionEventMessageUpsertedSchema = z.object({ "eventId": z.string().min(1), "sessionId": z.string().min(1), "turnId": z.string().min(1).optional(), "seq": z.number().int().gte(0).lte(9007199254740991), "traceId": z.string().min(1).optional(), "timestamp": z.number().int().gte(0).lte(9007199254740991), "deliveryKind": z.enum(["desktop-continuous","web-remote-replayable"]).optional(), "type": z.literal("message.upserted"), "payload": z.object({ "content": z.string(), "attachments": z.array(z.unknown()).optional(), "toolCalls": z.array(z.unknown()).optional(), "type": z.string().optional(), "compactBoundary": z.unknown().optional() }).optional() });
|
|
42
|
+
export type NotificationSessionEventMessageUpserted = z.output<typeof NotificationSessionEventMessageUpsertedSchema>;
|
|
43
|
+
|
|
44
|
+
export const NotificationSessionEventMessageRemovedSchema = z.object({ "eventId": z.string().min(1), "sessionId": z.string().min(1), "turnId": z.string().min(1).optional(), "seq": z.number().int().gte(0).lte(9007199254740991), "traceId": z.string().min(1).optional(), "timestamp": z.number().int().gte(0).lte(9007199254740991), "deliveryKind": z.enum(["desktop-continuous","web-remote-replayable"]).optional(), "type": z.literal("message.removed"), "payload": z.object({ "messageId": z.string().min(1), "reason": z.string().optional() }).optional() });
|
|
45
|
+
export type NotificationSessionEventMessageRemoved = z.output<typeof NotificationSessionEventMessageRemovedSchema>;
|
|
46
|
+
|
|
47
|
+
export const NotificationSessionEventPartStartedSchema = z.object({ "eventId": z.string().min(1), "sessionId": z.string().min(1), "turnId": z.string().min(1).optional(), "seq": z.number().int().gte(0).lte(9007199254740991), "traceId": z.string().min(1).optional(), "timestamp": z.number().int().gte(0).lte(9007199254740991), "deliveryKind": z.enum(["desktop-continuous","web-remote-replayable"]).optional(), "type": z.literal("part.started"), "payload": z.object({ "part": z.union([z.object({ "partId": z.string().min(1), "sessionId": z.string().min(1), "messageId": z.string().min(1), "type": z.literal("text"), "text": z.string(), "synthetic": z.boolean().optional(), "ignored": z.boolean().optional(), "metadata": z.record(z.string(), z.unknown()).optional() }), z.object({ "partId": z.string().min(1), "sessionId": z.string().min(1), "messageId": z.string().min(1), "type": z.literal("reasoning"), "text": z.string(), "metadata": z.record(z.string(), z.unknown()).optional() }), z.object({ "partId": z.string().min(1), "sessionId": z.string().min(1), "messageId": z.string().min(1), "type": z.literal("file"), "mime": z.string().min(1), "filename": z.string().optional(), "url": z.string().min(1), "metadata": z.record(z.string(), z.unknown()).optional() }), z.object({ "partId": z.string().min(1), "sessionId": z.string().min(1), "messageId": z.string().min(1), "type": z.literal("tool"), "callId": z.string().min(1), "tool": z.string().min(1), "state": z.union([z.object({ "status": z.literal("pending"), "input": z.record(z.string(), z.unknown()), "raw": z.string() }), z.object({ "status": z.literal("running"), "input": z.record(z.string(), z.unknown()), "title": z.string().optional(), "metadata": z.record(z.string(), z.unknown()).optional(), "startedAt": z.number().int().gte(0).lte(9007199254740991) }), z.object({ "status": z.literal("completed"), "input": z.record(z.string(), z.unknown()), "output": z.string(), "title": z.string(), "metadata": z.record(z.string(), z.unknown()), "startedAt": z.number().int().gte(0).lte(9007199254740991), "completedAt": z.number().int().gte(0).lte(9007199254740991) }), z.object({ "status": z.literal("error"), "input": z.record(z.string(), z.unknown()), "error": z.string(), "metadata": z.record(z.string(), z.unknown()).optional(), "startedAt": z.number().int().gte(0).lte(9007199254740991), "completedAt": z.number().int().gte(0).lte(9007199254740991) })]), "metadata": z.record(z.string(), z.unknown()).optional() }), z.object({ "partId": z.string().min(1), "sessionId": z.string().min(1), "messageId": z.string().min(1), "type": z.literal("step-start"), "snapshot": z.string().optional() }), z.object({ "partId": z.string().min(1), "sessionId": z.string().min(1), "messageId": z.string().min(1), "type": z.literal("step-finish"), "reason": z.string(), "snapshot": z.string().optional(), "cost": z.number().gte(0), "tokens": z.object({ "total": z.number().int().gte(0).lte(9007199254740991).optional(), "input": z.number().int().gte(0).lte(9007199254740991), "output": z.number().int().gte(0).lte(9007199254740991), "reasoning": z.number().int().gte(0).lte(9007199254740991), "cache": z.object({ "read": z.number().int().gte(0).lte(9007199254740991), "write": z.number().int().gte(0).lte(9007199254740991) }) }) }), z.object({ "partId": z.string().min(1), "sessionId": z.string().min(1), "messageId": z.string().min(1), "type": z.literal("snapshot"), "snapshot": z.string() }), z.object({ "partId": z.string().min(1), "sessionId": z.string().min(1), "messageId": z.string().min(1), "type": z.literal("patch"), "hash": z.string().min(1), "files": z.array(z.string()) }), z.object({ "partId": z.string().min(1), "sessionId": z.string().min(1), "messageId": z.string().min(1), "type": z.literal("compaction"), "auto": z.boolean(), "reason": z.string().optional(), "summaryMessageId": z.string().min(1).optional(), "metadata": z.record(z.string(), z.unknown()).optional() }), z.object({ "partId": z.string().min(1), "sessionId": z.string().min(1), "messageId": z.string().min(1), "type": z.literal("timeline"), "timelineType": z.enum(["context_compaction","goal_verification","session_fork","model_change","worktree_creation"]), "display": z.enum(["separator","worklog"]), "status": z.string().optional(), "anchorMessageId": z.string().min(1).optional(), "anchorTurnId": z.string().min(1).optional(), "time": z.object({ "start": z.number().int().gte(0).lte(9007199254740991).optional(), "end": z.number().int().gte(0).lte(9007199254740991).optional() }).optional(), "operationId": z.string().optional(), "trigger": z.enum(["manual","auto","partial","reactive","session_memory"]).optional(), "phase": z.enum(["standalone_turn","pre_request","mid_turn","reactive"]).optional(), "compactReason": z.string().optional(), "boundaryId": z.string().optional(), "summaryMessageId": z.string().min(1).optional(), "preCompactTokenCount": z.number().int().gte(0).lte(9007199254740991).optional(), "postCompactTokenCount": z.number().int().gte(0).lte(9007199254740991).optional(), "truePostCompactTokenCount": z.number().int().gte(0).lte(9007199254740991).optional(), "attempt": z.number().int().gte(0).lte(9007199254740991).optional(), "maxAttempts": z.number().int().gte(0).lte(9007199254740991).optional(), "reason": z.string().optional(), "targetId": z.string().optional(), "verificationId": z.string().optional(), "goalIteration": z.number().int().gte(0).lte(9007199254740991).optional(), "verification": z.object({ "passed": z.boolean(), "reason": z.string(), "nextAction": z.union([z.string(), z.null()]).optional() }).optional(), "parentSessionId": z.string().min(1).optional(), "targetMessageId": z.string().min(1).optional(), "targetCheckpointId": z.string().optional(), "restoredFileCount": z.number().int().gte(0).lte(9007199254740991).optional(), "fromModel": z.object({ "providerId": z.string().min(1), "modelId": z.string().min(1), "options": z.object({ "reasoningLevel": z.string().min(1).optional() }).optional(), "label": z.string().optional() }).optional(), "toModel": z.object({ "providerId": z.string().min(1), "modelId": z.string().min(1), "options": z.object({ "reasoningLevel": z.string().min(1).optional() }).optional(), "label": z.string().min(1) }).optional(), "worktreeCreation": z.object({ "path": z.string().min(1), "sha": z.string().min(1), "ref": z.union([z.string(), z.null()]), "output": z.string() }).optional() }), z.object({ "partId": z.string().min(1), "sessionId": z.string().min(1), "messageId": z.string().min(1), "type": z.literal("subagent"), "prompt": z.string(), "description": z.string(), "agent": z.string().min(1), "model": z.object({ "providerId": z.string().min(1), "modelId": z.string().min(1), "options": z.object({ "reasoningLevel": z.string().min(1).optional() }).optional() }).optional(), "command": z.string().optional() }), z.object({ "partId": z.string().min(1), "sessionId": z.string().min(1), "messageId": z.string().min(1), "type": z.literal("agent"), "name": z.string().min(1) }), z.object({ "partId": z.string().min(1), "sessionId": z.string().min(1), "messageId": z.string().min(1), "type": z.literal("retry"), "attempt": z.number().int().gte(0).lte(9007199254740991), "error": z.record(z.string(), z.unknown()) })]) }).optional() });
|
|
48
|
+
export type NotificationSessionEventPartStarted = z.output<typeof NotificationSessionEventPartStartedSchema>;
|
|
49
|
+
|
|
50
|
+
export const NotificationSessionEventPartDeltaSchema = z.object({ "eventId": z.string().min(1), "sessionId": z.string().min(1), "turnId": z.string().min(1).optional(), "seq": z.number().int().gte(0).lte(9007199254740991), "traceId": z.string().min(1).optional(), "timestamp": z.number().int().gte(0).lte(9007199254740991), "deliveryKind": z.enum(["desktop-continuous","web-remote-replayable"]).optional(), "type": z.literal("part.delta"), "payload": z.object({ "messageId": z.string().min(1), "partId": z.string().min(1), "field": z.enum(["text","reasoning","input","output"]).optional(), "delta": z.string() }).optional() });
|
|
51
|
+
export type NotificationSessionEventPartDelta = z.output<typeof NotificationSessionEventPartDeltaSchema>;
|
|
52
|
+
|
|
53
|
+
export const NotificationSessionEventPartUpsertedSchema = z.object({ "eventId": z.string().min(1), "sessionId": z.string().min(1), "turnId": z.string().min(1).optional(), "seq": z.number().int().gte(0).lte(9007199254740991), "traceId": z.string().min(1).optional(), "timestamp": z.number().int().gte(0).lte(9007199254740991), "deliveryKind": z.enum(["desktop-continuous","web-remote-replayable"]).optional(), "type": z.literal("part.upserted"), "payload": z.object({ "part": z.union([z.object({ "partId": z.string().min(1), "sessionId": z.string().min(1), "messageId": z.string().min(1), "type": z.literal("text"), "text": z.string(), "synthetic": z.boolean().optional(), "ignored": z.boolean().optional(), "metadata": z.record(z.string(), z.unknown()).optional() }), z.object({ "partId": z.string().min(1), "sessionId": z.string().min(1), "messageId": z.string().min(1), "type": z.literal("reasoning"), "text": z.string(), "metadata": z.record(z.string(), z.unknown()).optional() }), z.object({ "partId": z.string().min(1), "sessionId": z.string().min(1), "messageId": z.string().min(1), "type": z.literal("file"), "mime": z.string().min(1), "filename": z.string().optional(), "url": z.string().min(1), "metadata": z.record(z.string(), z.unknown()).optional() }), z.object({ "partId": z.string().min(1), "sessionId": z.string().min(1), "messageId": z.string().min(1), "type": z.literal("tool"), "callId": z.string().min(1), "tool": z.string().min(1), "state": z.union([z.object({ "status": z.literal("pending"), "input": z.record(z.string(), z.unknown()), "raw": z.string() }), z.object({ "status": z.literal("running"), "input": z.record(z.string(), z.unknown()), "title": z.string().optional(), "metadata": z.record(z.string(), z.unknown()).optional(), "startedAt": z.number().int().gte(0).lte(9007199254740991) }), z.object({ "status": z.literal("completed"), "input": z.record(z.string(), z.unknown()), "output": z.string(), "title": z.string(), "metadata": z.record(z.string(), z.unknown()), "startedAt": z.number().int().gte(0).lte(9007199254740991), "completedAt": z.number().int().gte(0).lte(9007199254740991) }), z.object({ "status": z.literal("error"), "input": z.record(z.string(), z.unknown()), "error": z.string(), "metadata": z.record(z.string(), z.unknown()).optional(), "startedAt": z.number().int().gte(0).lte(9007199254740991), "completedAt": z.number().int().gte(0).lte(9007199254740991) })]), "metadata": z.record(z.string(), z.unknown()).optional() }), z.object({ "partId": z.string().min(1), "sessionId": z.string().min(1), "messageId": z.string().min(1), "type": z.literal("step-start"), "snapshot": z.string().optional() }), z.object({ "partId": z.string().min(1), "sessionId": z.string().min(1), "messageId": z.string().min(1), "type": z.literal("step-finish"), "reason": z.string(), "snapshot": z.string().optional(), "cost": z.number().gte(0), "tokens": z.object({ "total": z.number().int().gte(0).lte(9007199254740991).optional(), "input": z.number().int().gte(0).lte(9007199254740991), "output": z.number().int().gte(0).lte(9007199254740991), "reasoning": z.number().int().gte(0).lte(9007199254740991), "cache": z.object({ "read": z.number().int().gte(0).lte(9007199254740991), "write": z.number().int().gte(0).lte(9007199254740991) }) }) }), z.object({ "partId": z.string().min(1), "sessionId": z.string().min(1), "messageId": z.string().min(1), "type": z.literal("snapshot"), "snapshot": z.string() }), z.object({ "partId": z.string().min(1), "sessionId": z.string().min(1), "messageId": z.string().min(1), "type": z.literal("patch"), "hash": z.string().min(1), "files": z.array(z.string()) }), z.object({ "partId": z.string().min(1), "sessionId": z.string().min(1), "messageId": z.string().min(1), "type": z.literal("compaction"), "auto": z.boolean(), "reason": z.string().optional(), "summaryMessageId": z.string().min(1).optional(), "metadata": z.record(z.string(), z.unknown()).optional() }), z.object({ "partId": z.string().min(1), "sessionId": z.string().min(1), "messageId": z.string().min(1), "type": z.literal("timeline"), "timelineType": z.enum(["context_compaction","goal_verification","session_fork","model_change","worktree_creation"]), "display": z.enum(["separator","worklog"]), "status": z.string().optional(), "anchorMessageId": z.string().min(1).optional(), "anchorTurnId": z.string().min(1).optional(), "time": z.object({ "start": z.number().int().gte(0).lte(9007199254740991).optional(), "end": z.number().int().gte(0).lte(9007199254740991).optional() }).optional(), "operationId": z.string().optional(), "trigger": z.enum(["manual","auto","partial","reactive","session_memory"]).optional(), "phase": z.enum(["standalone_turn","pre_request","mid_turn","reactive"]).optional(), "compactReason": z.string().optional(), "boundaryId": z.string().optional(), "summaryMessageId": z.string().min(1).optional(), "preCompactTokenCount": z.number().int().gte(0).lte(9007199254740991).optional(), "postCompactTokenCount": z.number().int().gte(0).lte(9007199254740991).optional(), "truePostCompactTokenCount": z.number().int().gte(0).lte(9007199254740991).optional(), "attempt": z.number().int().gte(0).lte(9007199254740991).optional(), "maxAttempts": z.number().int().gte(0).lte(9007199254740991).optional(), "reason": z.string().optional(), "targetId": z.string().optional(), "verificationId": z.string().optional(), "goalIteration": z.number().int().gte(0).lte(9007199254740991).optional(), "verification": z.object({ "passed": z.boolean(), "reason": z.string(), "nextAction": z.union([z.string(), z.null()]).optional() }).optional(), "parentSessionId": z.string().min(1).optional(), "targetMessageId": z.string().min(1).optional(), "targetCheckpointId": z.string().optional(), "restoredFileCount": z.number().int().gte(0).lte(9007199254740991).optional(), "fromModel": z.object({ "providerId": z.string().min(1), "modelId": z.string().min(1), "options": z.object({ "reasoningLevel": z.string().min(1).optional() }).optional(), "label": z.string().optional() }).optional(), "toModel": z.object({ "providerId": z.string().min(1), "modelId": z.string().min(1), "options": z.object({ "reasoningLevel": z.string().min(1).optional() }).optional(), "label": z.string().min(1) }).optional(), "worktreeCreation": z.object({ "path": z.string().min(1), "sha": z.string().min(1), "ref": z.union([z.string(), z.null()]), "output": z.string() }).optional() }), z.object({ "partId": z.string().min(1), "sessionId": z.string().min(1), "messageId": z.string().min(1), "type": z.literal("subagent"), "prompt": z.string(), "description": z.string(), "agent": z.string().min(1), "model": z.object({ "providerId": z.string().min(1), "modelId": z.string().min(1), "options": z.object({ "reasoningLevel": z.string().min(1).optional() }).optional() }).optional(), "command": z.string().optional() }), z.object({ "partId": z.string().min(1), "sessionId": z.string().min(1), "messageId": z.string().min(1), "type": z.literal("agent"), "name": z.string().min(1) }), z.object({ "partId": z.string().min(1), "sessionId": z.string().min(1), "messageId": z.string().min(1), "type": z.literal("retry"), "attempt": z.number().int().gte(0).lte(9007199254740991), "error": z.record(z.string(), z.unknown()) })]) }).optional() });
|
|
54
|
+
export type NotificationSessionEventPartUpserted = z.output<typeof NotificationSessionEventPartUpsertedSchema>;
|
|
55
|
+
|
|
56
|
+
export const NotificationSessionEventPartRemovedSchema = z.object({ "eventId": z.string().min(1), "sessionId": z.string().min(1), "turnId": z.string().min(1).optional(), "seq": z.number().int().gte(0).lte(9007199254740991), "traceId": z.string().min(1).optional(), "timestamp": z.number().int().gte(0).lte(9007199254740991), "deliveryKind": z.enum(["desktop-continuous","web-remote-replayable"]).optional(), "type": z.literal("part.removed"), "payload": z.object({ "messageId": z.string().min(1), "partId": z.string().min(1), "reason": z.string().optional() }).optional() });
|
|
57
|
+
export type NotificationSessionEventPartRemoved = z.output<typeof NotificationSessionEventPartRemovedSchema>;
|
|
58
|
+
|
|
59
|
+
export const NotificationSessionEventModelStreamingSchema = z.object({ "eventId": z.string().min(1), "sessionId": z.string().min(1), "turnId": z.string().min(1).optional(), "seq": z.number().int().gte(0).lte(9007199254740991), "traceId": z.string().min(1).optional(), "timestamp": z.number().int().gte(0).lte(9007199254740991), "deliveryKind": z.enum(["desktop-continuous","web-remote-replayable"]).optional(), "type": z.literal("model.streaming"), "payload": z.object({ "assistantMessageId": z.string().optional(), "delta": z.string().optional(), "done": z.boolean().optional(), "input": z.unknown().optional(), "kind": z.enum(["start","finish","error","text_start","text_delta","text_end","reasoning_start","reasoning_delta","reasoning_end","tool_input_start","tool_input_delta","tool_input_end","tool_call"]), "partId": z.string().optional(), "providerExecuted": z.boolean().optional(), "toolCallId": z.string().optional(), "toolName": z.string().optional() }).optional() });
|
|
60
|
+
export type NotificationSessionEventModelStreaming = z.output<typeof NotificationSessionEventModelStreamingSchema>;
|
|
61
|
+
|
|
62
|
+
export const NotificationSessionEventToolUpdatedSchema = z.object({ "eventId": z.string().min(1), "sessionId": z.string().min(1), "turnId": z.string().min(1).optional(), "seq": z.number().int().gte(0).lte(9007199254740991), "traceId": z.string().min(1).optional(), "timestamp": z.number().int().gte(0).lte(9007199254740991), "deliveryKind": z.enum(["desktop-continuous","web-remote-replayable"]).optional(), "type": z.literal("tool.updated"), "payload": z.union([z.object({ "toolCallId": z.string().min(1), "toolName": z.string().min(1), "parentToolCallId": z.string().min(1).optional(), "source": z.literal("subagent").optional(), "agentId": z.string().min(1).optional(), "agentType": z.string().min(1).optional(), "background": z.boolean().optional(), "childSessionId": z.string().min(1).optional(), "childToolCallId": z.string().min(1).optional(), "description": z.string().optional(), "kind": z.literal("scheduled"), "assistantMessageId": z.string().min(1).optional(), "input": z.unknown().optional(), "inputByteLength": z.number().int().gte(0).lte(9007199254740991).optional(), "inputOmitted": z.boolean().optional(), "inputRef": z.literal("model_stream").optional(), "dependencies": z.array(z.string().min(1)).optional(), "parallelGroupIndex": z.number().int().gte(0).lte(9007199254740991).optional(), "canRunParallel": z.boolean().optional(), "schedule": z.record(z.string(), z.unknown()).optional() }), z.object({ "toolCallId": z.string().min(1), "toolName": z.string().optional(), "parentToolCallId": z.string().min(1).optional(), "source": z.literal("subagent").optional(), "agentId": z.string().min(1).optional(), "agentType": z.string().min(1).optional(), "background": z.boolean().optional(), "childSessionId": z.string().min(1).optional(), "childToolCallId": z.string().min(1).optional(), "description": z.string().optional(), "kind": z.literal("started"), "startedAt": z.union([z.number().int().gte(0).lte(9007199254740991), z.string().min(1), z.unknown()]) }), z.object({ "toolCallId": z.string().min(1), "toolName": z.string().optional(), "parentToolCallId": z.string().min(1).optional(), "source": z.literal("subagent").optional(), "agentId": z.string().min(1).optional(), "agentType": z.string().min(1).optional(), "background": z.boolean().optional(), "childSessionId": z.string().min(1).optional(), "childToolCallId": z.string().min(1).optional(), "description": z.string().optional(), "kind": z.literal("progress"), "elapsedMs": z.number().gte(0).optional(), "pid": z.number().int().gte(-9007199254740991).lte(9007199254740991).optional(), "stdoutBytes": z.number().int().gte(0).lte(9007199254740991).optional(), "stderrBytes": z.number().int().gte(0).lte(9007199254740991).optional(), "outputBytes": z.number().int().gte(0).lte(9007199254740991).optional(), "outputPreview": z.object({ "text": z.string().max(4096), "fullText": z.string().max(4096), "totalLines": z.number().int().gte(0).lte(9007199254740991), "totalBytes": z.number().int().gte(0).lte(9007199254740991), "linesEstimated": z.boolean() }).optional(), "stdoutTail": z.string().optional(), "stderrTail": z.string().optional() }), z.object({ "toolCallId": z.string().min(1), "toolName": z.string().optional(), "parentToolCallId": z.string().min(1).optional(), "source": z.literal("subagent").optional(), "agentId": z.string().min(1).optional(), "agentType": z.string().min(1).optional(), "background": z.boolean().optional(), "childSessionId": z.string().min(1).optional(), "childToolCallId": z.string().min(1).optional(), "description": z.string().optional(), "kind": z.literal("result"), "result": z.record(z.string(), z.unknown()), "duration": z.number().gte(0) }), z.object({ "toolCallId": z.string().min(1), "toolName": z.string().optional(), "parentToolCallId": z.string().min(1).optional(), "source": z.literal("subagent").optional(), "agentId": z.string().min(1).optional(), "agentType": z.string().min(1).optional(), "background": z.boolean().optional(), "childSessionId": z.string().min(1).optional(), "childToolCallId": z.string().min(1).optional(), "description": z.string().optional(), "kind": z.literal("error"), "error": z.object({ "type": z.string().min(1), "message": z.string().min(1), "stack": z.string().optional(), "code": z.string().optional(), "detail": z.string().optional(), "underlyingErrorMessage": z.string().optional(), "underlyingErrorDetail": z.string().optional(), "attribution": z.object({ "source": z.enum(["provider","runtime","tool","network"]).optional(), "reason": z.string().min(1).max(160).optional(), "errorPhase": z.enum(["prepare","configuration","connect","response","stream","parse","validation","unhandled"]).optional(), "exceptionKind": z.enum(["api_call","generic","protocol","provider_business","transport","type_error","validation"]).optional(), "providerId": z.string().min(1).max(160).optional(), "modelId": z.string().min(1).max(160).optional(), "providerKind": z.string().min(1).max(160).optional(), "transport": z.enum(["http","sse","websocket"]).optional(), "statusCode": z.number().int().gte(100).lte(599).optional(), "providerErrorCode": z.string().min(1).max(160).optional(), "retryable": z.boolean().optional(), "highspeedCardId": z.union([z.string(), z.null()]).optional(), "highspeedFallbackUnavailable": z.boolean().optional() }).optional(), "retryable": z.boolean().optional(), "data": z.unknown().optional() }) }), z.object({ "kind": z.literal("batch"), "toolCallIds": z.array(z.string().min(1)), "successCount": z.number().int().gte(0).lte(9007199254740991), "errorCount": z.number().int().gte(0).lte(9007199254740991) }), z.object({ "toolCallId": z.string().min(1), "toolName": z.string().optional(), "parentToolCallId": z.string().min(1).optional(), "source": z.literal("subagent").optional(), "agentId": z.string().min(1).optional(), "agentType": z.string().min(1).optional(), "background": z.boolean().optional(), "childSessionId": z.string().min(1).optional(), "childToolCallId": z.string().min(1).optional(), "description": z.string().optional(), "kind": z.literal("raw"), "payload": z.record(z.string(), z.unknown()) })]).optional() });
|
|
63
|
+
export type NotificationSessionEventToolUpdated = z.output<typeof NotificationSessionEventToolUpdatedSchema>;
|
|
64
|
+
|
|
65
|
+
export const NotificationSessionEventPermissionRequestedSchema = z.object({ "eventId": z.string().min(1), "sessionId": z.string().min(1), "turnId": z.string().min(1).optional(), "seq": z.number().int().gte(0).lte(9007199254740991), "traceId": z.string().min(1).optional(), "timestamp": z.number().int().gte(0).lte(9007199254740991), "deliveryKind": z.enum(["desktop-continuous","web-remote-replayable"]).optional(), "type": z.literal("permission.requested"), "payload": z.object({ "requestId": z.string().min(1).optional(), "toolCallId": z.string().min(1), "toolName": z.string().min(1), "riskLevel": z.enum(["low","medium","high","critical"]), "reason": z.string(), "input": z.unknown(), "suggestedPermissionUpdates": z.array(z.object({ "type": z.literal("addRules"), "behavior": z.enum(["allow","deny","ask"]), "rules": z.array(z.object({ "toolName": z.string().min(1), "ruleContent": z.string().optional() })).min(1) })).optional(), "approvalMode": z.literal("user-once").optional(), "origin": z.object({ "kind": z.literal("subagent"), "agentId": z.string().min(1), "agentType": z.string().min(1), "childSessionId": z.string().min(1), "childTurnId": z.string().min(1).optional(), "description": z.string().optional(), "parentSessionId": z.string().min(1), "parentToolCallId": z.string().min(1).optional(), "parentTurnId": z.string().min(1).optional() }).optional(), "options": z.array(z.object({ "optionId": z.string().min(1), "kind": z.string().min(1), "name": z.string().min(1), "description": z.string().optional(), "response": z.object({ "decision": z.enum(["allow","deny","escalate","modify"]), "reason": z.string().optional(), "modifiedInput": z.unknown().optional(), "permissionUpdates": z.array(z.object({ "type": z.literal("addRules"), "behavior": z.enum(["allow","deny","ask"]), "rules": z.array(z.object({ "toolName": z.string().min(1), "ruleContent": z.string().optional() })).min(1) })).optional() }) })).min(1), "childSessionId": z.string().min(1).optional(), "background": z.boolean().optional() }).optional() });
|
|
66
|
+
export type NotificationSessionEventPermissionRequested = z.output<typeof NotificationSessionEventPermissionRequestedSchema>;
|
|
67
|
+
|
|
68
|
+
export const NotificationSessionEventPermissionResolvedSchema = z.object({ "eventId": z.string().min(1), "sessionId": z.string().min(1), "turnId": z.string().min(1).optional(), "seq": z.number().int().gte(0).lte(9007199254740991), "traceId": z.string().min(1).optional(), "timestamp": z.number().int().gte(0).lte(9007199254740991), "deliveryKind": z.enum(["desktop-continuous","web-remote-replayable"]).optional(), "type": z.literal("permission.resolved"), "payload": z.object({ "requestId": z.string().min(1).optional(), "toolCallId": z.string().min(1), "toolName": z.string().min(1).optional(), "decision": z.enum(["allow","deny","escalate","modify"]).optional(), "reason": z.string().optional(), "modifiedInput": z.unknown().optional(), "inputSummary": z.unknown().optional(), "childSessionId": z.string().min(1).optional(), "background": z.boolean().optional() }).optional() });
|
|
69
|
+
export type NotificationSessionEventPermissionResolved = z.output<typeof NotificationSessionEventPermissionResolvedSchema>;
|
|
70
|
+
|
|
71
|
+
export const NotificationSessionEventUserInputRequestedSchema = z.object({ "eventId": z.string().min(1), "sessionId": z.string().min(1), "turnId": z.string().min(1).optional(), "seq": z.number().int().gte(0).lte(9007199254740991), "traceId": z.string().min(1).optional(), "timestamp": z.number().int().gte(0).lte(9007199254740991), "deliveryKind": z.enum(["desktop-continuous","web-remote-replayable"]).optional(), "type": z.literal("userInput.requested"), "payload": z.object({ "requestId": z.string().min(1), "prompt": z.string(), "inputType": z.enum(["text","choice","confirm"]).optional(), "choices": z.array(z.string()).optional() }).optional() });
|
|
72
|
+
export type NotificationSessionEventUserInputRequested = z.output<typeof NotificationSessionEventUserInputRequestedSchema>;
|
|
73
|
+
|
|
74
|
+
export const NotificationSessionEventUserInputResolvedSchema = z.object({ "eventId": z.string().min(1), "sessionId": z.string().min(1), "turnId": z.string().min(1).optional(), "seq": z.number().int().gte(0).lte(9007199254740991), "traceId": z.string().min(1).optional(), "timestamp": z.number().int().gte(0).lte(9007199254740991), "deliveryKind": z.enum(["desktop-continuous","web-remote-replayable"]).optional(), "type": z.literal("userInput.resolved"), "payload": z.object({ "requestId": z.string().min(1), "value": z.unknown().optional(), "cancelled": z.boolean().optional() }).optional() });
|
|
75
|
+
export type NotificationSessionEventUserInputResolved = z.output<typeof NotificationSessionEventUserInputResolvedSchema>;
|
|
76
|
+
|
|
77
|
+
export const NotificationSessionEventCheckpointCreatedSchema = z.object({ "eventId": z.string().min(1), "sessionId": z.string().min(1), "turnId": z.string().min(1).optional(), "seq": z.number().int().gte(0).lte(9007199254740991), "traceId": z.string().min(1).optional(), "timestamp": z.number().int().gte(0).lte(9007199254740991), "deliveryKind": z.enum(["desktop-continuous","web-remote-replayable"]).optional(), "type": z.literal("checkpoint.created"), "payload": z.record(z.string(), z.unknown()).optional() });
|
|
78
|
+
export type NotificationSessionEventCheckpointCreated = z.output<typeof NotificationSessionEventCheckpointCreatedSchema>;
|
|
79
|
+
|
|
80
|
+
export const NotificationSessionEventRewindTriggeredSchema = z.object({ "eventId": z.string().min(1), "sessionId": z.string().min(1), "turnId": z.string().min(1).optional(), "seq": z.number().int().gte(0).lte(9007199254740991), "traceId": z.string().min(1).optional(), "timestamp": z.number().int().gte(0).lte(9007199254740991), "deliveryKind": z.enum(["desktop-continuous","web-remote-replayable"]).optional(), "type": z.literal("rewind.triggered"), "payload": z.record(z.string(), z.unknown()).optional() });
|
|
81
|
+
export type NotificationSessionEventRewindTriggered = z.output<typeof NotificationSessionEventRewindTriggeredSchema>;
|
|
82
|
+
|
|
83
|
+
export const NotificationSessionEventStreamRecoveryUpdatedSchema = z.object({ "eventId": z.string().min(1), "sessionId": z.string().min(1), "turnId": z.string().min(1).optional(), "seq": z.number().int().gte(0).lte(9007199254740991), "traceId": z.string().min(1).optional(), "timestamp": z.number().int().gte(0).lte(9007199254740991), "deliveryKind": z.enum(["desktop-continuous","web-remote-replayable"]).optional(), "type": z.literal("streamRecovery.updated"), "payload": z.record(z.string(), z.unknown()).optional() });
|
|
84
|
+
export type NotificationSessionEventStreamRecoveryUpdated = z.output<typeof NotificationSessionEventStreamRecoveryUpdatedSchema>;
|
|
85
|
+
|
|
86
|
+
export const NotificationSessionEventSchema = z.discriminatedUnion("type", [NotificationSessionEventSessionCreatedSchema, NotificationSessionEventSessionResumedSchema, NotificationSessionEventSessionUpdatedSchema, NotificationSessionEventSessionTitleUpdatedSchema, NotificationSessionEventSessionClosedSchema, NotificationSessionEventTurnStartedSchema, NotificationSessionEventTurnSteerQueuedSchema, NotificationSessionEventTurnSteerDrainedSchema, NotificationSessionEventTurnCompletedSchema, NotificationSessionEventTurnFailedSchema, NotificationSessionEventMessageUpsertedSchema, NotificationSessionEventMessageRemovedSchema, NotificationSessionEventPartStartedSchema, NotificationSessionEventPartDeltaSchema, NotificationSessionEventPartUpsertedSchema, NotificationSessionEventPartRemovedSchema, NotificationSessionEventModelStreamingSchema, NotificationSessionEventToolUpdatedSchema, NotificationSessionEventPermissionRequestedSchema, NotificationSessionEventPermissionResolvedSchema, NotificationSessionEventUserInputRequestedSchema, NotificationSessionEventUserInputResolvedSchema, NotificationSessionEventCheckpointCreatedSchema, NotificationSessionEventRewindTriggeredSchema, NotificationSessionEventStreamRecoveryUpdatedSchema]);
|
|
87
|
+
export type NotificationSessionEvent = z.output<typeof NotificationSessionEventSchema>;
|
|
88
|
+
|
|
89
|
+
export const NotificationStateUpdatedSchema = z.object({ "type": z.literal("state.updated"), "scope": z.enum(["server","workspace","session"]), "workspace": z.object({ "workspacePath": z.string().min(1), "workspaceIdentity": z.string().min(1).optional(), "remoteSessionId": z.string().min(1).optional(), "workspaceKey": z.string().min(1) }).optional(), "sessionId": z.string().min(1).optional(), "revision": z.number().int().gte(0).lte(9007199254740991), "reason": z.string().optional(), "patch": z.unknown() });
|
|
90
|
+
export type NotificationStateUpdated = z.output<typeof NotificationStateUpdatedSchema>;
|
|
91
|
+
|
|
92
|
+
export const NotificationSessionLifecycleChangedSchema = z.object({ "sessionId": z.string().min(1), "state": z.enum(["unloaded","starting","ready","stopping","faulted"]), "generation": z.number().int().gte(0).lte(9007199254740991).default(0), "revision": z.number().int().gte(0).lte(9007199254740991).default(0), "lastError": z.union([z.object({ "operation": z.enum(["ensureReady","stop","restart"]), "code": z.string(), "message": z.string() }), z.null()]) });
|
|
93
|
+
export type NotificationSessionLifecycleChanged = z.output<typeof NotificationSessionLifecycleChangedSchema>;
|
|
94
|
+
|
|
95
|
+
export const NotificationPluginsDegradedSchema = z.object({ "reason": z.literal("timeout") });
|
|
96
|
+
export type NotificationPluginsDegraded = z.output<typeof NotificationPluginsDegradedSchema>;
|
|
97
|
+
|
|
98
|
+
export const NotificationStorageStateSchema = z.object({ "schemaVersion": z.literal(1), "attemptId": z.string().min(1).max(128), "sequence": z.number().int().gt(0).lte(9007199254740991), "databaseId": z.string().min(1).max(128), "databaseKind": z.enum(["session","tasks-index"]), "phase": z.enum(["checking","waiting_for_lock","migrating","committing","ready","failed"]), "migration": z.object({ "kind": z.enum(["none","initialize","upgrade"]), "executedCount": z.number().int().gte(0).lte(9007199254740991), "committedCount": z.number().int().gte(0).lte(9007199254740991), "lastAppliedMigrationId": z.union([z.string().regex(new RegExp("^[a-zA-Z_0-9-]{1,128}$")), z.null()]).optional() }).optional(), "elapsedMs": z.number().gte(0), "completed": z.number().int().gte(0).lte(9007199254740991).optional(), "total": z.number().int().gte(0).lte(9007199254740991).optional(), "errorCode": z.enum(["storage_full","permission_denied","io_error","out_of_memory","corrupt","open_failed","lock_timeout","checksum_mismatch","sql_failed","startup_status_timeout","transport_closed","unsupported_runtime"]).optional(), "sqliteCode": z.number().int().gte(-9007199254740991).lte(9007199254740991).optional(), "systemCode": z.string().max(64).optional(), "migrationId": z.string().max(128).optional() });
|
|
99
|
+
export type NotificationStorageState = z.output<typeof NotificationStorageStateSchema>;
|
|
100
|
+
|
|
101
|
+
export const NotificationProviderRuntimeHeadersCancelledSchema = z.object({ "requestId": z.string().min(1), "sessionId": z.string().min(1), "workspace": z.object({ "workspacePath": z.string().min(1), "workspaceIdentity": z.string().min(1).optional(), "remoteSessionId": z.string().min(1).optional(), "workspaceKey": z.string().min(1) }) });
|
|
102
|
+
export type NotificationProviderRuntimeHeadersCancelled = z.output<typeof NotificationProviderRuntimeHeadersCancelledSchema>;
|
|
103
|
+
|
|
104
|
+
export const NotificationMcpTelemetryProcessStartSchema = z.object({ "arch": z.enum(["arm","arm64","ia32","loong64","mips","mipsel","ppc","ppc64","riscv64","s390","s390x","x64"]), "occurredAt": z.number().int().gte(0).lte(9007199254740991), "platform": z.enum(["aix","android","darwin","freebsd","haiku","linux","netbsd","openbsd","sunos","win32","cygwin"]), "kind": z.literal("process_start"), "mcpId": z.string().regex(new RegExp("^(?:builtin:(?:[A-Za-z0-9._~-]|%[0-9A-F]{2})+(?::(?:[A-Za-z0-9._~-]|%[0-9A-F]{2})+)*|(?:plugin|custom):[a-f0-9]{12})$")), "mcpInstanceId": z.string().min(1), "mcpIsolation": z.enum(["session","workspace"]), "mcpSource": z.enum(["builtin","plugin","custom"]) });
|
|
105
|
+
export type NotificationMcpTelemetryProcessStart = z.output<typeof NotificationMcpTelemetryProcessStartSchema>;
|
|
106
|
+
|
|
107
|
+
export const NotificationMcpTelemetryProcessCrashSchema = z.object({ "arch": z.enum(["arm","arm64","ia32","loong64","mips","mipsel","ppc","ppc64","riscv64","s390","s390x","x64"]), "occurredAt": z.number().int().gte(0).lte(9007199254740991), "platform": z.enum(["aix","android","darwin","freebsd","haiku","linux","netbsd","openbsd","sunos","win32","cygwin"]), "kind": z.literal("process_crash"), "mcpId": z.string().regex(new RegExp("^(?:builtin:(?:[A-Za-z0-9._~-]|%[0-9A-F]{2})+(?::(?:[A-Za-z0-9._~-]|%[0-9A-F]{2})+)*|(?:plugin|custom):[a-f0-9]{12})$")), "mcpInstanceId": z.string().min(1), "mcpIsolation": z.enum(["session","workspace"]), "mcpSource": z.enum(["builtin","plugin","custom"]), "affectedSessionCount": z.number().int().gte(0).lte(10000), "exitCode": z.union([z.number().int().gte(-9007199254740991).lte(9007199254740991), z.null()]), "signal": z.union([z.string().min(1), z.null()]), "uptimeMs": z.number().gte(0).lte(9007199254740991) });
|
|
108
|
+
export type NotificationMcpTelemetryProcessCrash = z.output<typeof NotificationMcpTelemetryProcessCrashSchema>;
|
|
109
|
+
|
|
110
|
+
export const NotificationMcpTelemetrySessionStartupSchema = z.object({ "arch": z.enum(["arm","arm64","ia32","loong64","mips","mipsel","ppc","ppc64","riscv64","s390","s390x","x64"]), "occurredAt": z.number().int().gte(0).lte(9007199254740991), "platform": z.enum(["aix","android","darwin","freebsd","haiku","linux","netbsd","openbsd","sunos","win32","cygwin"]), "kind": z.literal("session_startup"), "configuredCount": z.number().int().gte(0).lte(10000), "connectedCount": z.number().int().gte(0).lte(10000), "failedCount": z.number().int().gte(0).lte(10000), "processCount": z.number().int().gte(0).lte(10000), "sessionId": z.string().min(1) });
|
|
111
|
+
export type NotificationMcpTelemetrySessionStartup = z.output<typeof NotificationMcpTelemetrySessionStartupSchema>;
|
|
112
|
+
|
|
113
|
+
export const NotificationMcpTelemetryMemorySchema = z.object({ "arch": z.enum(["arm","arm64","ia32","loong64","mips","mipsel","ppc","ppc64","riscv64","s390","s390x","x64"]), "occurredAt": z.number().int().gte(0).lte(9007199254740991), "platform": z.enum(["aix","android","darwin","freebsd","haiku","linux","netbsd","openbsd","sunos","win32","cygwin"]), "kind": z.literal("memory"), "mcpId": z.string().regex(new RegExp("^(?:builtin:(?:[A-Za-z0-9._~-]|%[0-9A-F]{2})+(?::(?:[A-Za-z0-9._~-]|%[0-9A-F]{2})+)*|(?:plugin|custom):[a-f0-9]{12})$")), "mcpInstanceId": z.string().min(1), "mcpIsolation": z.enum(["session","workspace"]), "mcpSource": z.enum(["builtin","plugin","custom"]), "memoryKb": z.number().gte(0).lte(9007199254740991), "memoryScope": z.enum(["process_tree","direct_process"]), "orphanSuspected": z.boolean(), "ownerSessionCount": z.number().int().gte(0).lte(10000), "unownedSeconds": z.number().gte(0).lte(9007199254740991) });
|
|
114
|
+
export type NotificationMcpTelemetryMemory = z.output<typeof NotificationMcpTelemetryMemorySchema>;
|
|
115
|
+
|
|
116
|
+
export const NotificationMcpTelemetrySchema = z.discriminatedUnion("kind", [NotificationMcpTelemetryProcessStartSchema, NotificationMcpTelemetryProcessCrashSchema, NotificationMcpTelemetrySessionStartupSchema, NotificationMcpTelemetryMemorySchema]);
|
|
117
|
+
export type NotificationMcpTelemetry = z.output<typeof NotificationMcpTelemetrySchema>;
|
|
118
|
+
|
|
119
|
+
export const NotificationMcpResourceSamplesSchema = z.array(z.object({ "mcpId": z.string().regex(new RegExp("^(?:builtin:(?:[A-Za-z0-9._~-]|%[0-9A-F]{2})+(?::(?:[A-Za-z0-9._~-]|%[0-9A-F]{2})+)*|(?:plugin|custom):[a-f0-9]{12})$")), "instanceToken": z.string().regex(new RegExp("^[A-Za-z0-9_-]{8,64}$")), "sampledAt": z.number().int().gte(0).lte(9007199254740991), "intervalMs": z.number().gt(0), "processCount": z.number().int().gt(0).lte(100000), "rssKbTotal": z.number().gte(0).lte(9007199254740991), "rssKbMaxProcess": z.number().gte(0).lte(9007199254740991), "cpuTimeMsDelta": z.number().gte(0).lte(9007199254740991), "uptimeMinutes": z.number().int().gte(0).lte(9007199254740991), "platform": z.enum(["aix","android","darwin","freebsd","haiku","linux","netbsd","openbsd","sunos","win32","cygwin"]), "arch": z.enum(["arm","arm64","ia32","loong64","mips","mipsel","ppc","ppc64","riscv64","s390","s390x","x64"]), "logicalCpuCount": z.number().int().gt(0).lte(4096), "totalMemoryGb": z.number().int().gte(0).lte(1048576) })).max(1024);
|
|
120
|
+
export type NotificationMcpResourceSamples = z.output<typeof NotificationMcpResourceSamplesSchema>;
|
|
121
|
+
|
|
122
|
+
export const NotificationToolExecResourceSchema = z.object({ "completionToken": z.string().uuid().regex(new RegExp("^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$")).optional(), "platform": z.enum(["aix","android","darwin","freebsd","haiku","linux","netbsd","openbsd","sunos","win32","cygwin"]), "toolName": z.literal("bash"), "durationMs": z.number().gte(15000), "exitKind": z.enum(["completed","timeout","killed","error"]), "treeRssKbPeak": z.number().gte(0).optional(), "treeCpuTimeMs": z.number().gte(0).optional(), "sampleCount": z.number().int().gte(0).lte(20), "cliRssKb": z.number().gte(0), "systemFreeMemoryKb": z.number().gte(0) });
|
|
123
|
+
export type NotificationToolExecResource = z.output<typeof NotificationToolExecResourceSchema>;
|
|
124
|
+
|
|
125
|
+
export const NotificationPluginOperationProgressSchema = z.object({ "operationId": z.string().min(1), "state": z.literal("refreshing") });
|
|
126
|
+
export type NotificationPluginOperationProgress = z.output<typeof NotificationPluginOperationProgressSchema>;
|
|
127
|
+
|
|
128
|
+
export const NotificationProcessResourceSampleSchema = z.object({ "platform": z.enum(["aix","android","darwin","freebsd","haiku","linux","netbsd","openbsd","sunos","win32","cygwin"]), "arch": z.enum(["arm","arm64","ia32","loong64","mips","mipsel","ppc","ppc64","riscv64","s390","s390x","x64"]), "logicalCpuCount": z.number().int().gt(0).lte(4096), "intervalMs": z.number().int().gt(0).lte(604800000), "cpuCores": z.number().gte(0).lte(4096), "cpuPercent": z.number().gte(0).lte(100000), "rssKb": z.number().gte(0).lte(9007199254740991), "heapUsedKb": z.number().gte(0).lte(9007199254740991).optional(), "uptimeMinutes": z.number().int().gte(0).lte(5256000).optional(), "totalMemoryGb": z.number().int().gte(0).lte(1048576).optional(), "instanceToken": z.string().regex(new RegExp("^[A-Za-z0-9_-]{8,64}$")).optional() });
|
|
129
|
+
export type NotificationProcessResourceSample = z.output<typeof NotificationProcessResourceSampleSchema>;
|
|
130
|
+
|
|
131
|
+
export const NotificationNetworkRequestsSchema = z.object({ "captureId": z.string().min(1).max(100), "records": z.array(z.object({ "timestamp": z.number().int().gte(0).lte(9007199254740991), "processType": z.enum(["main","host","renderer","cli"]), "pid": z.number().int().gte(0).lte(9007199254740991), "method": z.string().min(1).max(32), "url": z.string().max(2048) })).max(100), "dropped": z.number().int().gte(0).lte(9007199254740991) });
|
|
132
|
+
export type NotificationNetworkRequests = z.output<typeof NotificationNetworkRequestsSchema>;
|
|
133
|
+
|
|
134
|
+
export const NotificationComputerUseOperationEventTurnStartedSchema = z.object({ "eventId": z.string().min(1), "sequenceNumber": z.number().int().gte(0).lte(9007199254740991), "sessionId": z.string().min(1), "timestamp": z.number().int().gte(0).lte(9007199254740991), "kind": z.literal("turn-started"), "turnId": z.string().min(1) });
|
|
135
|
+
export type NotificationComputerUseOperationEventTurnStarted = z.output<typeof NotificationComputerUseOperationEventTurnStartedSchema>;
|
|
136
|
+
|
|
137
|
+
export const NotificationComputerUseOperationEventTurnCompletedSchema = z.object({ "eventId": z.string().min(1), "sequenceNumber": z.number().int().gte(0).lte(9007199254740991), "sessionId": z.string().min(1), "timestamp": z.number().int().gte(0).lte(9007199254740991), "kind": z.literal("turn-completed"), "turnId": z.string().min(1) });
|
|
138
|
+
export type NotificationComputerUseOperationEventTurnCompleted = z.output<typeof NotificationComputerUseOperationEventTurnCompletedSchema>;
|
|
139
|
+
|
|
140
|
+
export const NotificationComputerUseOperationEventTurnFailedSchema = z.object({ "eventId": z.string().min(1), "sequenceNumber": z.number().int().gte(0).lte(9007199254740991), "sessionId": z.string().min(1), "timestamp": z.number().int().gte(0).lte(9007199254740991), "kind": z.literal("turn-failed"), "turnId": z.string().min(1) });
|
|
141
|
+
export type NotificationComputerUseOperationEventTurnFailed = z.output<typeof NotificationComputerUseOperationEventTurnFailedSchema>;
|
|
142
|
+
|
|
143
|
+
export const NotificationComputerUseOperationEventToolScheduledSchema = z.object({ "eventId": z.string().min(1), "sequenceNumber": z.number().int().gte(0).lte(9007199254740991), "sessionId": z.string().min(1), "timestamp": z.number().int().gte(0).lte(9007199254740991), "kind": z.literal("tool-scheduled"), "turnId": z.string().min(1), "toolCallId": z.string().min(1), "toolName": z.string().min(1), "computerUse": z.literal(true).optional() });
|
|
144
|
+
export type NotificationComputerUseOperationEventToolScheduled = z.output<typeof NotificationComputerUseOperationEventToolScheduledSchema>;
|
|
145
|
+
|
|
146
|
+
export const NotificationComputerUseOperationEventToolStartedSchema = z.object({ "eventId": z.string().min(1), "sequenceNumber": z.number().int().gte(0).lte(9007199254740991), "sessionId": z.string().min(1), "timestamp": z.number().int().gte(0).lte(9007199254740991), "kind": z.literal("tool-started"), "turnId": z.string().min(1).optional(), "toolCallId": z.string().min(1), "toolName": z.string().min(1).optional() });
|
|
147
|
+
export type NotificationComputerUseOperationEventToolStarted = z.output<typeof NotificationComputerUseOperationEventToolStartedSchema>;
|
|
148
|
+
|
|
149
|
+
export const NotificationComputerUseOperationEventSessionClosedSchema = z.object({ "eventId": z.string().min(1), "sequenceNumber": z.number().int().gte(0).lte(9007199254740991), "sessionId": z.string().min(1), "timestamp": z.number().int().gte(0).lte(9007199254740991), "kind": z.literal("session-closed") });
|
|
150
|
+
export type NotificationComputerUseOperationEventSessionClosed = z.output<typeof NotificationComputerUseOperationEventSessionClosedSchema>;
|
|
151
|
+
|
|
152
|
+
export const NotificationComputerUseOperationEventSchema = z.discriminatedUnion("kind", [NotificationComputerUseOperationEventTurnStartedSchema, NotificationComputerUseOperationEventTurnCompletedSchema, NotificationComputerUseOperationEventTurnFailedSchema, NotificationComputerUseOperationEventToolScheduledSchema, NotificationComputerUseOperationEventToolStartedSchema, NotificationComputerUseOperationEventSessionClosedSchema]);
|
|
153
|
+
export type NotificationComputerUseOperationEvent = z.output<typeof NotificationComputerUseOperationEventSchema>;
|
|
154
|
+
|
|
155
|
+
export const RequestRuntimePreferencesParamsSchema = z.object({ "sessionId": z.string().min(1), "scope": z.enum(["runtime-materialization","user-execution"]), "workspace": z.object({ "workspacePath": z.string().min(1), "workspaceIdentity": z.string().min(1).optional(), "remoteSessionId": z.string().min(1).optional(), "workspaceKey": z.string().min(1) }).optional(), "directorySessionId": z.string().min(1).optional() });
|
|
156
|
+
export type RequestRuntimePreferencesParams = z.output<typeof RequestRuntimePreferencesParamsSchema>;
|
|
157
|
+
|
|
158
|
+
export const RequestRuntimePreferencesAnswerSchema = z.object({ "additionalDirectories": z.array(z.string().min(1)).max(256).optional(), "nativeSearchEnhancementsEnabled": z.boolean(), "toolSearchMode": z.enum(["auto","local","off"]).default("off"), "subagentRuntimeConfigEnabled": z.boolean().optional(), "appControlEnabled": z.boolean().optional(), "memoryEnabled": z.boolean().default(false), "askUserQuestionAutoResolutionEnabled": z.boolean().default(true), "integratedTerminalShell": z.union([z.object({ "mode": z.literal("auto") }), z.object({ "mode": z.literal("shell"), "dialect": z.enum(["cmd","git-bash"]), "id": z.string().min(1), "label": z.string().min(1), "path": z.string().min(1) })]).optional(), "modelContextBudgetStrategy": z.enum(["legacy","preflight-v1"]).default("preflight-v1") });
|
|
159
|
+
export type RequestRuntimePreferencesAnswer = z.output<typeof RequestRuntimePreferencesAnswerSchema>;
|
|
160
|
+
|
|
161
|
+
export const RequestPermissionParamsSchema = z.object({ "requestId": z.string().min(1), "sessionId": z.string().min(1), "turnId": z.string().min(1).optional(), "toolCallId": z.string().min(1), "toolName": z.string().min(1), "reason": z.string(), "riskLevel": z.enum(["low","medium","high","critical"]), "input": z.unknown(), "origin": z.object({ "kind": z.literal("subagent"), "agentId": z.string().min(1), "agentType": z.string().min(1), "childSessionId": z.string().min(1), "childTurnId": z.string().min(1).optional(), "description": z.string().optional(), "parentSessionId": z.string().min(1), "parentToolCallId": z.string().min(1).optional(), "parentTurnId": z.string().min(1).optional() }).optional(), "options": z.array(z.object({ "optionId": z.string().min(1), "kind": z.string().min(1), "name": z.string().min(1), "description": z.string().optional(), "response": z.object({ "decision": z.enum(["allow","deny","escalate","modify"]), "reason": z.string().optional(), "modifiedInput": z.unknown().optional(), "permissionUpdates": z.array(z.object({ "type": z.literal("addRules"), "behavior": z.enum(["allow","deny","ask"]), "rules": z.array(z.object({ "toolName": z.string().min(1), "ruleContent": z.string().optional() })).min(1) })).optional() }) })).min(1) });
|
|
162
|
+
export type RequestPermissionParams = z.output<typeof RequestPermissionParamsSchema>;
|
|
163
|
+
|
|
164
|
+
export const RequestPermissionAnswerSchema = z.object({ "decision": z.enum(["allow","deny","escalate","modify"]), "reason": z.string().optional(), "modifiedInput": z.unknown().optional(), "permissionUpdates": z.array(z.object({ "type": z.literal("addRules"), "behavior": z.enum(["allow","deny","ask"]), "rules": z.array(z.object({ "toolName": z.string().min(1), "ruleContent": z.string().optional() })).min(1) })).optional() });
|
|
165
|
+
export type RequestPermissionAnswer = z.output<typeof RequestPermissionAnswerSchema>;
|
|
166
|
+
|
|
167
|
+
export const RequestUserInputParamsSchema = z.object({ "requestId": z.string().min(1), "sessionId": z.string().min(1), "turnId": z.string().min(1).optional(), "toolCallId": z.string().min(1).optional(), "toolName": z.string().min(1).optional(), "prompt": z.string().optional(), "questions": z.array(z.object({ "question": z.string().min(1), "header": z.string().min(1), "options": z.array(z.object({ "value": z.string().min(1), "label": z.string().min(1), "description": z.string().optional(), "preview": z.string().optional() })).min(1), "multiSelect": z.boolean().optional() })).min(1).optional(), "input": z.unknown().optional(), "origin": z.object({ "kind": z.literal("subagent"), "agentId": z.string().min(1), "agentType": z.string().min(1), "childSessionId": z.string().min(1), "childTurnId": z.string().min(1).optional(), "description": z.string().optional(), "parentSessionId": z.string().min(1), "parentToolCallId": z.string().min(1).optional(), "parentTurnId": z.string().min(1).optional() }).optional(), "schema": z.unknown().optional() });
|
|
168
|
+
export type RequestUserInputParams = z.output<typeof RequestUserInputParamsSchema>;
|
|
169
|
+
|
|
170
|
+
export const RequestUserInputAnswerSchema = z.object({ "action": z.enum(["accept","decline","cancel"]), "content": z.record(z.string(), z.unknown()).optional(), "reason": z.string().optional() });
|
|
171
|
+
export type RequestUserInputAnswer = z.output<typeof RequestUserInputAnswerSchema>;
|
|
172
|
+
|
|
173
|
+
export const RequestProviderRuntimeHeadersParamsSchema = z.object({ "requestId": z.string().min(1), "sessionId": z.string().min(1), "turnId": z.string().min(1).optional(), "workspace": z.object({ "workspacePath": z.string().min(1), "workspaceIdentity": z.string().min(1).optional(), "remoteSessionId": z.string().min(1).optional(), "workspaceKey": z.string().min(1) }), "modelSelection": z.object({ "providerId": z.string().min(1), "modelId": z.string().min(1), "options": z.object({ "reasoningLevel": z.string().min(1).optional() }).optional() }), "providerId": z.string().min(1), "accountAccess": z.object({ "type": z.literal("zhipu-account"), "accountType": z.enum(["zai","bigmodel"]), "mode": z.enum(["start-plan","individual-coding-plan","team-coding-plan","off-peak","highspeed"]), "entitled": z.boolean() }).optional(), "expectedAccountScope": z.string().regex(new RegExp("^[a-f0-9]{64}$")).optional(), "rejectedProjectTokenFingerprint": z.string().regex(new RegExp("^[a-f0-9]{64}$")).optional(), "reason": z.literal("model-request") });
|
|
174
|
+
export type RequestProviderRuntimeHeadersParams = z.output<typeof RequestProviderRuntimeHeadersParamsSchema>;
|
|
175
|
+
|
|
176
|
+
export const RequestProviderRuntimeHeadersAnswerSchema = z.union([z.object({ "headersApplied": z.literal(true), "requestAuth": z.object({ "apiKey": z.string().min(1).optional(), "apiKeyId": z.string().min(1).optional(), "accountScope": z.string().regex(new RegExp("^[a-f0-9]{64}$")).optional(), "headers": z.record(z.string(), z.string().min(1)).optional() }), "errorMessage": z.string().min(1).optional() }), z.object({ "headersApplied": z.literal(false), "errorMessage": z.string().min(1).optional() })]);
|
|
177
|
+
export type RequestProviderRuntimeHeadersAnswer = z.output<typeof RequestProviderRuntimeHeadersAnswerSchema>;
|
|
178
|
+
|
|
179
|
+
export const RequestOfficialMcpAuthHeadersParamsSchema = z.object({ "requestId": z.string().min(1), "workspace": z.object({ "workspacePath": z.string().min(1), "workspaceIdentity": z.string().min(1).optional(), "remoteSessionId": z.string().min(1).optional(), "workspaceKey": z.string().min(1) }), "pluginId": z.string().min(1), "consumer": z.enum(["mcp-server","plugin-command"]).optional(), "mcpKey": z.string().min(1).optional(), "targetOrigin": z.string().min(1) });
|
|
180
|
+
export type RequestOfficialMcpAuthHeadersParams = z.output<typeof RequestOfficialMcpAuthHeadersParamsSchema>;
|
|
181
|
+
|
|
182
|
+
export const RequestOfficialMcpAuthHeadersAnswerSchema = z.union([z.object({ "ok": z.literal(true), "headers": z.record(z.string(), z.string()) }), z.object({ "ok": z.literal(false), "reason": z.enum(["official_auth_unavailable","official_auth_plan_required","official_mcp_origin_untrusted"]) })]);
|
|
183
|
+
export type RequestOfficialMcpAuthHeadersAnswer = z.output<typeof RequestOfficialMcpAuthHeadersAnswerSchema>;
|
|
184
|
+
|
|
185
|
+
export const RequestCredentialCipherParamsSchema = z.object({ "requestId": z.string().uuid().regex(new RegExp("^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$")), "operation": z.enum(["encrypt","decrypt"]), "value": z.string().max(1398232) });
|
|
186
|
+
export type RequestCredentialCipherParams = z.output<typeof RequestCredentialCipherParamsSchema>;
|
|
187
|
+
|
|
188
|
+
export const RequestCredentialCipherAnswerSchema = z.object({ "requestId": z.string().uuid().regex(new RegExp("^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$")), "result": z.union([z.object({ "ok": z.literal(true), "value": z.string().max(1398232) }), z.object({ "ok": z.literal(false), "error": z.object({ "code": z.string(), "message": z.string() }) })]) });
|
|
189
|
+
export type RequestCredentialCipherAnswer = z.output<typeof RequestCredentialCipherAnswerSchema>;
|
|
190
|
+
|
|
191
|
+
export const RequestBrowserListParamsSchema = z.object({ "requestId": z.string().min(1), "sessionId": z.string().min(1), "turnId": z.string().min(1).optional(), "workspaceKey": z.string().min(1), "workspacePath": z.string().min(1), "workspaceIdentity": z.string().min(1).optional(), "remoteSessionId": z.string().min(1).optional(), "clientMode": z.enum(["desktop-continuous","web-remote-replayable"]), "sessionContext": z.enum(["live","cached"]) });
|
|
192
|
+
export type RequestBrowserListParams = z.output<typeof RequestBrowserListParamsSchema>;
|
|
193
|
+
|
|
194
|
+
export const RequestBrowserListAnswerSchema = z.object({ "browsers": z.array(z.object({ "id": z.string().min(1), "generation": z.number().int().gte(0).lte(9007199254740991).default(0), "type": z.enum(["iab","extension","cdp"]), "name": z.string().min(1), "capabilities": z.object({ "browser": z.array(z.object({ "id": z.string().min(1), "description": z.string().min(1) })).optional(), "tab": z.array(z.object({ "id": z.string().min(1), "description": z.string().min(1) })).optional() }), "apiSupportOverrides": z.record(z.string(), z.boolean()).optional(), "metadata": z.record(z.string(), z.string()).optional() })) });
|
|
195
|
+
export type RequestBrowserListAnswer = z.output<typeof RequestBrowserListAnswerSchema>;
|
|
196
|
+
|
|
197
|
+
export const RequestBrowserExecuteParamsSchema = z.object({ "controlScopeId": z.string().min(1).optional(), "requestId": z.string().min(1), "sessionId": z.string().min(1), "turnId": z.string().min(1).optional(), "browserId": z.string().min(1).optional(), "browserGeneration": z.number().int().gte(0).lte(9007199254740991).optional(), "workspaceKey": z.string().min(1).optional(), "workspacePath": z.string().min(1).optional(), "workspaceIdentity": z.string().min(1).optional(), "remoteSessionId": z.string().min(1).optional(), "clientMode": z.enum(["desktop-continuous","web-remote-replayable"]).optional(), "sessionContext": z.enum(["live","cached"]).optional(), "command": z.union([z.object({ "method": z.literal("navigate"), "url": z.string().min(1), "tabId": z.string().optional() }), z.object({ "method": z.literal("back"), "tabId": z.string().optional() }), z.object({ "method": z.literal("forward"), "tabId": z.string().optional() }), z.object({ "method": z.literal("reload"), "tabId": z.string().optional() }), z.object({ "method": z.literal("snapshot"), "maxElements": z.number().int().gt(0).lte(9007199254740991).optional(), "includeHidden": z.boolean().optional(), "tabId": z.string().optional() }), z.object({ "method": z.literal("click"), "ref": z.string().min(1).optional(), "x": z.number().optional(), "y": z.number().optional(), "button": z.enum(["left","right","middle"]).optional(), "doubleClick": z.boolean().optional(), "modifiers": z.array(z.enum(["Alt","Control","ControlOrMeta","Meta","Shift"])).optional(), "tabId": z.string().optional() }), z.object({ "method": z.literal("fill"), "ref": z.string().min(1), "value": z.string(), "tabId": z.string().optional() }), z.object({ "method": z.literal("type"), "ref": z.string().min(1).optional(), "text": z.string(), "tabId": z.string().optional() }), z.object({ "method": z.literal("press"), "key": z.string().min(1), "ref": z.string().min(1).optional(), "modifiers": z.array(z.enum(["Alt","Control","ControlOrMeta","Meta","Shift"])).optional(), "tabId": z.string().optional() }), z.object({ "method": z.literal("cuaKeypress"), "keys": z.array(z.string().min(1)).min(1), "tabId": z.string().optional() }), z.object({ "method": z.literal("scroll"), "ref": z.string().min(1).optional(), "x": z.number().optional(), "y": z.number().optional(), "tabId": z.string().optional() }), z.object({ "method": z.literal("cuaScroll"), "x": z.number(), "y": z.number(), "scrollX": z.number(), "scrollY": z.number(), "modifiers": z.array(z.enum(["Alt","Control","ControlOrMeta","Meta","Shift"])).optional(), "tabId": z.string().optional() }), z.object({ "method": z.literal("domCuaScroll"), "nodeId": z.string().min(1).optional(), "scrollX": z.number(), "scrollY": z.number(), "tabId": z.string().optional() }), z.object({ "method": z.literal("screenshot"), "ref": z.string().min(1).optional(), "fullPage": z.boolean().optional(), "clip": z.object({ "x": z.number(), "y": z.number(), "width": z.number().gt(0), "height": z.number().gt(0) }).optional(), "tabId": z.string().optional() }), z.object({ "method": z.literal("getState"), "tabId": z.string().optional() }), z.object({ "method": z.literal("hover"), "ref": z.string().min(1).optional(), "x": z.number().optional(), "y": z.number().optional(), "modifiers": z.array(z.enum(["Alt","Control","ControlOrMeta","Meta","Shift"])).optional(), "tabId": z.string().optional() }), z.object({ "method": z.literal("select"), "ref": z.string().min(1), "values": z.array(z.string()).min(1), "tabId": z.string().optional() }), z.object({ "method": z.literal("check"), "ref": z.string().min(1), "checked": z.boolean().optional(), "tabId": z.string().optional() }), z.object({ "method": z.literal("drag"), "fromRef": z.string().min(1).optional(), "toRef": z.string().min(1).optional(), "from": z.object({ "x": z.number(), "y": z.number() }).optional(), "to": z.object({ "x": z.number(), "y": z.number() }).optional(), "modifiers": z.array(z.enum(["Alt","Control","ControlOrMeta","Meta","Shift"])).optional(), "tabId": z.string().optional() }), z.object({ "method": z.literal("cuaDrag"), "path": z.array(z.object({ "x": z.number(), "y": z.number() })).min(1), "modifiers": z.array(z.enum(["Alt","Control","ControlOrMeta","Meta","Shift"])).optional(), "tabId": z.string().optional() }), z.object({ "method": z.literal("elementInfo"), "x": z.number(), "y": z.number(), "tabId": z.string().optional() }), z.object({ "method": z.literal("evaluate"), "expression": z.string().min(1), "tabId": z.string().optional() }), z.object({ "method": z.literal("getDialog"), "tabId": z.string().optional() }), z.object({ "method": z.literal("handleDialog"), "accept": z.boolean(), "promptText": z.string().optional(), "tabId": z.string().optional() }), z.object({ "method": z.literal("waitFor"), "selector": z.string().min(1).optional(), "text": z.string().min(1).optional(), "textGone": z.string().min(1).optional(), "timeoutMs": z.number().int().gt(0).lte(9007199254740991).optional(), "tabId": z.string().optional() }), z.object({ "method": z.literal("playwrightWaitForTimeout"), "timeoutMs": z.number().int().gte(0).lte(9007199254740991), "tabId": z.string().optional() }), z.object({ "method": z.literal("playwright"), "action": z.union([z.object({ "name": z.literal("domSnapshot") }), z.object({ "name": z.literal("elementInfo"), "x": z.number(), "y": z.number(), "includeNonInteractable": z.boolean().optional() }), z.object({ "name": z.literal("elementScreenshot"), "x": z.number(), "y": z.number(), "includeNonInteractable": z.boolean().optional() }), z.object({ "name": z.literal("evaluate"), "expression": z.string().min(1), "expressionKind": z.enum(["string","function"]), "arg": z.unknown().optional(), "timeoutMs": z.number().int().gt(0).lte(9007199254740991).optional() }), z.object({ "name": z.literal("waitForLoadState"), "state": z.enum(["load","domcontentloaded","networkidle"]).optional(), "timeoutMs": z.number().int().gt(0).lte(9007199254740991).optional() }), z.object({ "name": z.literal("waitForURL"), "url": z.string().min(1), "waitUntil": z.enum(["load","domcontentloaded","networkidle","commit"]).optional(), "timeoutMs": z.number().int().gt(0).lte(9007199254740991).optional() }), z.object({ "name": z.literal("waitForEvent"), "event": z.enum(["download","filechooser"]), "timeoutMs": z.number().int().gt(0).lte(9007199254740991).optional() }), z.object({ "name": z.literal("downloadPath"), "downloadId": z.string().min(1), "timeoutMs": z.number().int().gt(0).lte(9007199254740991).optional() }), z.object({ "name": z.literal("fileChooserSetFiles"), "fileChooserId": z.string().min(1), "files": z.array(z.string()).min(1), "timeoutMs": z.number().int().gt(0).lte(9007199254740991).optional() }), z.object({ "name": z.literal("locator"), "selector": z.string().min(1), "operation": z.enum(["allTextContents","click","count","dblclick","downloadMedia","evaluate","fill","getAttribute","innerText","isEnabled","isVisible","press","selectOption","setChecked","textContent","waitFor"]), "value": z.unknown().optional(), "arg": z.unknown().optional(), "expression": z.string().min(1).optional(), "expressionKind": z.enum(["string","function"]).optional(), "attribute": z.string().min(1).optional(), "checked": z.boolean().optional(), "replace": z.boolean().optional(), "force": z.boolean().optional(), "button": z.enum(["left","right","middle"]).optional(), "modifiers": z.array(z.enum(["Alt","Control","ControlOrMeta","Meta","Shift"])).optional(), "state": z.enum(["attached","detached","visible","hidden"]).optional(), "selections": z.array(z.object({ "value": z.string().optional(), "label": z.string().optional(), "index": z.number().int().gte(0).lte(9007199254740991).optional() })).min(1).optional(), "timeoutMs": z.number().int().gt(0).lte(9007199254740991).optional() })]), "tabId": z.string().optional() }), z.object({ "method": z.literal("capabilities"), "tabId": z.string().optional() }), z.object({ "method": z.literal("browserVisibilityGet") }), z.object({ "method": z.literal("browserVisibilitySet"), "visible": z.boolean() }), z.object({ "width": z.number().int().gte(320).lte(3840), "height": z.number().int().gte(320).lte(2160), "method": z.literal("browserViewportSet"), "tabId": z.string().optional() }), z.object({ "method": z.literal("browserViewportReset"), "tabId": z.string().optional() }), z.object({ "method": z.literal("recordingStart"), "options": z.object({ "viewport": z.object({ "width": z.number().int().gte(320).lte(3840), "height": z.number().int().gte(320).lte(2160) }).optional(), "fps": z.number().int().gte(1).lte(60).optional(), "jpegQuality": z.number().int().gte(1).lte(100).optional(), "maxDurationMs": z.number().int().gte(1000).lte(90000).optional(), "settleMs": z.number().int().gte(0).lte(90000).optional(), "showCursor": z.boolean().optional(), "actions": z.array(z.union([z.object({ "type": z.literal("wait"), "durationMs": z.number().int().gte(0).lte(90000) }), z.object({ "type": z.literal("click"), "selector": z.string().min(1).max(2000).optional(), "x": z.number().optional(), "y": z.number().optional(), "button": z.enum(["left","right","middle"]).optional(), "doubleClick": z.boolean().optional(), "delayAfterMs": z.number().int().gte(0).lte(90000).optional() }), z.object({ "type": z.literal("type"), "selector": z.string().min(1).max(2000), "text": z.string().max(100000), "delayAfterMs": z.number().int().gte(0).lte(90000).optional() }), z.object({ "type": z.literal("hover"), "selector": z.string().min(1).max(2000).optional(), "x": z.number().optional(), "y": z.number().optional(), "durationMs": z.number().int().gte(0).lte(90000).optional(), "delayAfterMs": z.number().int().gte(0).lte(90000).optional() }), z.object({ "type": z.literal("move"), "x": z.number(), "y": z.number(), "durationMs": z.number().int().gte(0).lte(90000).optional(), "delayAfterMs": z.number().int().gte(0).lte(90000).optional() }), z.object({ "type": z.literal("scroll"), "deltaX": z.number().optional(), "deltaY": z.number(), "durationMs": z.number().int().gte(0).lte(90000).optional(), "delayAfterMs": z.number().int().gte(0).lte(90000).optional() }), z.object({ "type": z.literal("scrollTo"), "selector": z.string().min(1).max(2000).optional(), "x": z.number().optional(), "y": z.number().optional(), "durationMs": z.number().int().gte(0).lte(90000).optional(), "delayAfterMs": z.number().int().gte(0).lte(90000).optional() }), z.object({ "type": z.literal("wheel"), "deltaX": z.number().optional(), "deltaY": z.number(), "times": z.number().int().gte(1).lte(100).optional(), "intervalMs": z.number().int().gte(0).lte(90000).optional(), "delayAfterMs": z.number().int().gte(0).lte(90000).optional() }), z.object({ "type": z.literal("drag"), "path": z.array(z.object({ "x": z.number(), "y": z.number() })).min(2).max(200), "durationMs": z.number().int().gte(0).lte(90000).optional(), "delayAfterMs": z.number().int().gte(0).lte(90000).optional() }), z.object({ "type": z.literal("waitFor"), "selector": z.string().min(1).max(2000), "state": z.enum(["attached","detached","visible","hidden"]).optional(), "timeoutMs": z.number().int().gt(0).lte(30000).optional(), "delayAfterMs": z.number().int().gte(0).lte(90000).optional() })])).max(500).optional() }).optional(), "tabId": z.string().optional() }), z.object({ "method": z.literal("recordingStatus"), "recordingId": z.string().min(1), "outputPath": z.string().min(1).max(2000).optional(), "tabId": z.string().optional() }), z.object({ "method": z.literal("recordingCancel"), "recordingId": z.string().min(1), "tabId": z.string().optional() }), z.object({ "method": z.literal("activateTab"), "tabId": z.string().min(1) }), z.object({ "method": z.literal("newTab") }), z.object({ "method": z.literal("listUserTabs") }), z.object({ "method": z.literal("claimTab"), "tabId": z.string().min(1) }), z.object({ "method": z.literal("finalizeTabs"), "keep": z.array(z.object({ "tabId": z.string().min(1), "status": z.enum(["handoff","deliverable"]) })) }), z.object({ "method": z.literal("markDeliverable"), "tabId": z.string().min(1) }), z.object({ "method": z.literal("markHandoff"), "tabId": z.string().min(1) }), z.object({ "method": z.literal("nameSession"), "name": z.string().min(1) }), z.object({ "method": z.literal("finalize"), "tabId": z.string().optional(), "deliverable": z.boolean().optional() }), z.object({ "method": z.literal("openScope") }), z.object({ "method": z.literal("releaseScope"), "closeTabs": z.boolean().optional() }), z.object({ "method": z.literal("turnEnded"), "turnId": z.string().min(1).optional() }), z.object({ "method": z.literal("closeSession"), "closeTabs": z.boolean().optional() }), z.object({ "method": z.literal("cancelRequest"), "requestId": z.string().min(1) }), z.object({ "method": z.literal("close"), "tabId": z.string().optional() }), z.object({ "method": z.literal("list") })]) });
|
|
198
|
+
export type RequestBrowserExecuteParams = z.output<typeof RequestBrowserExecuteParamsSchema>;
|
|
199
|
+
|
|
200
|
+
export const RequestBrowserExecuteAnswerSchema = z.object({ "ok": z.boolean(), "scope": z.object({ "id": z.string().min(1), "state": z.enum(["open","released","absent","rejected"]) }).optional(), "state": z.object({ "url": z.string(), "title": z.string(), "canGoBack": z.boolean(), "canGoForward": z.boolean(), "scrollX": z.number().optional(), "scrollY": z.number().optional(), "viewportWidth": z.number().optional(), "viewportHeight": z.number().optional() }).optional(), "snapshot": z.object({ "url": z.string(), "title": z.string(), "dom": z.array(z.object({ "tag": z.string(), "depth": z.number().int().gte(0).lte(9007199254740991), "inViewport": z.boolean(), "ref": z.string().min(1).optional(), "role": z.string().optional(), "name": z.string().optional(), "text": z.string().optional(), "attributes": z.record(z.string(), z.string()).optional() })).optional(), "domTruncated": z.boolean().optional(), "elements": z.array(z.object({ "ref": z.string().min(1), "tag": z.string(), "role": z.string().optional(), "name": z.string().optional(), "text": z.string().optional(), "value": z.string().optional(), "disabled": z.boolean().optional(), "checked": z.boolean().optional(), "selector": z.string(), "xpath": z.string(), "rect": z.object({ "x": z.number(), "y": z.number(), "width": z.number(), "height": z.number() }), "inViewport": z.boolean(), "parentRef": z.string().optional(), "framePath": z.string().optional(), "attributes": z.record(z.string(), z.string()).optional() })), "truncated": z.boolean() }).optional(), "image": z.object({ "base64": z.string(), "mimeType": z.literal("image/png") }).optional(), "tabs": z.array(z.object({ "tabId": z.string(), "url": z.string(), "title": z.string(), "viewport": z.object({ "width": z.number().int().gt(0).lte(9007199254740991), "height": z.number().int().gt(0).lte(9007199254740991) }), "active": z.boolean().optional(), "lifecycle": z.enum(["active","deliverable","handoff"]).optional() })).optional(), "userTabs": z.array(z.object({ "id": z.string().min(1), "lastOpened": z.string().optional(), "tabGroup": z.string().optional(), "title": z.string().optional(), "url": z.string().optional() })).optional(), "tab": z.object({ "tabId": z.string(), "url": z.string(), "title": z.string(), "viewport": z.object({ "width": z.number().int().gt(0).lte(9007199254740991), "height": z.number().int().gt(0).lte(9007199254740991) }), "active": z.boolean().optional(), "lifecycle": z.enum(["active","deliverable","handoff"]).optional() }).optional(), "value": z.unknown().optional(), "element": z.object({ "ref": z.string().min(1), "tag": z.string(), "role": z.string().optional(), "name": z.string().optional(), "text": z.string().optional(), "value": z.string().optional(), "disabled": z.boolean().optional(), "checked": z.boolean().optional(), "selector": z.string(), "xpath": z.string(), "rect": z.object({ "x": z.number(), "y": z.number(), "width": z.number(), "height": z.number() }), "inViewport": z.boolean(), "parentRef": z.string().optional(), "framePath": z.string().optional(), "attributes": z.record(z.string(), z.string()).optional() }).optional(), "dialog": z.union([z.object({ "type": z.enum(["alert","confirm","prompt","beforeunload"]), "message": z.string(), "defaultPrompt": z.string().optional() }), z.null()]).optional(), "recording": z.object({ "id": z.string().min(1), "status": z.enum(["running","completed","failed","cancelled"]), "phase": z.enum(["preparing","capturing","finalizing","completed","failed","cancelled"]), "progress": z.number().gte(0).lte(1), "startedAt": z.number().gte(0), "updatedAt": z.number().gte(0), "artifact": z.object({ "path": z.string().min(1), "mimeType": z.literal("video/webm"), "width": z.number().int().gt(0).lte(9007199254740991), "height": z.number().int().gt(0).lte(9007199254740991), "fps": z.number().gt(0), "durationMs": z.number().gte(0), "frameCount": z.number().int().gte(0).lte(9007199254740991) }).optional(), "error": z.string().optional() }).optional(), "error": z.object({ "code": z.enum(["backend_unavailable","capability_unsupported","duplicate_request_id","ref_not_found","navigation_blocked","timeout","renderer_unreachable","cancelled","execution_error"]), "message": z.string(), "sideEffect": z.enum(["none","uncertain"]).optional() }).optional(), "meta": z.object({ "browserUse": z.literal(true), "backendType": z.enum(["iab","extension","cdp"]), "browserId": z.string().min(1), "browserGeneration": z.number().int().gte(0).lte(9007199254740991), "openTabIds": z.array(z.string()), "tabId": z.string().optional(), "currentUrl": z.string().optional(), "lifecycle": z.enum(["active","deliverable","handoff","closed"]).optional() }).optional(), "elapsedMs": z.number().gte(0) });
|
|
201
|
+
export type RequestBrowserExecuteAnswer = z.output<typeof RequestBrowserExecuteAnswerSchema>;
|
|
202
|
+
|
|
203
|
+
export const RequestSubagentsRuntimeConfigParamsSchema = z.object({ "sessionId": z.string().min(1), "workspace": z.object({ "workspacePath": z.string().min(1), "workspaceIdentity": z.string().min(1).optional(), "remoteSessionId": z.string().min(1).optional(), "workspaceKey": z.string().min(1) }).optional() });
|
|
204
|
+
export type RequestSubagentsRuntimeConfigParams = z.output<typeof RequestSubagentsRuntimeConfigParamsSchema>;
|
|
205
|
+
|
|
206
|
+
export const RequestSubagentsRuntimeConfigAnswerReadySchema = z.object({ "kind": z.literal("ready"), "profiles": z.array(z.object({ "name": z.string().min(1), "description": z.string(), "source": z.enum(["built-in","project","user"]), "systemPrompt": z.string(), "path": z.string().optional(), "modelSelection": z.object({ "providerId": z.string().min(1), "modelId": z.string().min(1), "options": z.object({ "reasoningLevel": z.string().min(1).optional() }).optional() }).optional(), "background": z.boolean().optional(), "injectAgentsMd": z.boolean().optional(), "color": z.enum(["red","blue","green","yellow","purple","orange","pink","cyan"]).optional(), "permissionMode": z.enum(["acceptEdits","auto","bypassPermissions","default","dontAsk","plan"]).optional(), "memory": z.enum(["user","project","local"]).optional(), "maxTurns": z.number().int().gt(0).lte(9007199254740991).optional(), "tools": z.array(z.string()).readonly().optional(), "disallowedTools": z.array(z.string()).readonly().optional(), "skills": z.array(z.string()).readonly().optional(), "mcpServers": z.array(z.string()).readonly().optional() })), "builtInModelSelectionOverrides": z.object({ "Explore": z.object({ "providerId": z.string().min(1), "modelId": z.string().min(1), "options": z.object({ "reasoningLevel": z.string().min(1).optional() }).optional() }).optional(), "general-purpose": z.object({ "providerId": z.string().min(1), "modelId": z.string().min(1), "options": z.object({ "reasoningLevel": z.string().min(1).optional() }).optional() }).optional() }), "pluginAgentModelSelectionOverrides": z.record(z.string(), z.object({ "providerId": z.string().min(1), "modelId": z.string().min(1), "options": z.object({ "reasoningLevel": z.string().min(1).optional() }).optional() })) });
|
|
207
|
+
export type RequestSubagentsRuntimeConfigAnswerReady = z.output<typeof RequestSubagentsRuntimeConfigAnswerReadySchema>;
|
|
208
|
+
|
|
209
|
+
export const RequestSubagentsRuntimeConfigAnswerBuiltInFallbackSchema = z.object({ "kind": z.literal("built-in-fallback") });
|
|
210
|
+
export type RequestSubagentsRuntimeConfigAnswerBuiltInFallback = z.output<typeof RequestSubagentsRuntimeConfigAnswerBuiltInFallbackSchema>;
|
|
211
|
+
|
|
212
|
+
export const RequestSubagentsRuntimeConfigAnswerSchema = z.discriminatedUnion("kind", [RequestSubagentsRuntimeConfigAnswerReadySchema, RequestSubagentsRuntimeConfigAnswerBuiltInFallbackSchema]);
|
|
213
|
+
export type RequestSubagentsRuntimeConfigAnswer = z.output<typeof RequestSubagentsRuntimeConfigAnswerSchema>;
|
|
214
|
+
|
|
215
|
+
export const RequestChannelReplyParamsSchema = z.object({ "taskId": z.string().min(1), "inputId": z.string().min(1), "authorizationId": z.string().min(1).optional(), "toolCallId": z.string().min(1), "parts": z.array(z.union([z.object({ "type": z.literal("text"), "text": z.string().max(2000) }), z.object({ "type": z.literal("mention"), "refId": z.string().min(1).max(200) }), z.object({ "type": z.literal("mentionName"), "name": z.string().min(1).max(200), "candidateRef": z.string().min(1).max(200).optional() })])).min(1).max(50) });
|
|
216
|
+
export type RequestChannelReplyParams = z.output<typeof RequestChannelReplyParamsSchema>;
|
|
217
|
+
|
|
218
|
+
export const RequestChannelReplyAnswerSchema = z.union([z.object({ "status": z.enum(["sent","failed","unknown","invalidated"]), "deliveryId": z.string(), "providerMessageId": z.string().optional(), "error": z.string().optional() }), z.object({ "status": z.literal("needs_clarification"), "unresolved": z.array(z.object({ "name": z.string().max(200), "reason": z.enum(["ambiguous","not_found","unavailable","selection_expired"]), "candidates": z.array(z.object({ "ref": z.string().max(200), "name": z.string().max(200), "label": z.string().max(250), "kind": z.enum(["user","bot","unknown"]) })).max(10), "truncated": z.boolean() })).min(1).max(50) })]);
|
|
219
|
+
export type RequestChannelReplyAnswer = z.output<typeof RequestChannelReplyAnswerSchema>;
|
|
220
|
+
|
|
221
|
+
export const RequestTopicResourceReadParamsSchema = z.object({ "requestId": z.string().min(1).max(256), "taskId": z.string().min(1).max(256), "inputId": z.string().min(1).max(256), "authorizationId": z.string().min(1).max(256), "messageId": z.string().min(1).max(256), "resourceIndex": z.number().int().gte(0).lte(9007199254740991) });
|
|
222
|
+
export type RequestTopicResourceReadParams = z.output<typeof RequestTopicResourceReadParamsSchema>;
|
|
223
|
+
|
|
224
|
+
export const RequestTopicResourceReadAnswerSchema = z.object({ "ref": z.string().min(1), "fileName": z.string().min(1).max(1024), "mime": z.string().min(1).max(256), "bytes": z.number().int().gte(0).lte(20971520) });
|
|
225
|
+
export type RequestTopicResourceReadAnswer = z.output<typeof RequestTopicResourceReadAnswerSchema>;
|
|
226
|
+
|
|
227
|
+
export const RequestTopicResourceCancelParamsSchema = z.object({ "requestId": z.string().min(1).max(256), "taskId": z.string().min(1).max(256) });
|
|
228
|
+
export type RequestTopicResourceCancelParams = z.output<typeof RequestTopicResourceCancelParamsSchema>;
|
|
229
|
+
|
|
230
|
+
export const RequestTopicResourceCancelAnswerSchema = z.object({ "cancelled": z.boolean() });
|
|
231
|
+
export type RequestTopicResourceCancelAnswer = z.output<typeof RequestTopicResourceCancelAnswerSchema>;
|
|
232
|
+
|
|
233
|
+
export const RequestAppControlListProjectsParamsSchema = z.object({ "callerSessionId": z.string().min(1).max(4096), "callId": z.string().min(1).max(4096), "turnId": z.string().min(1).max(4096).optional(), "input": z.object({ "query": z.string().max(4096).optional() }) });
|
|
234
|
+
export type RequestAppControlListProjectsParams = z.output<typeof RequestAppControlListProjectsParamsSchema>;
|
|
235
|
+
|
|
236
|
+
export const RequestAppControlListProjectsAnswerSchema = z.union([z.object({ "ok": z.literal(true), "result": z.object({ "projects": z.array(z.object({ "project": z.object({ "kind": z.literal("app"), "projectId": z.string().min(1).max(4096), "sourceServerId": z.string().min(1).max(4096).optional() }), "title": z.string() })), "searchScope": z.object({ "scopes": z.array(z.union([z.object({ "kind": z.literal("app"), "scope": z.literal("host"), "sourceServerId": z.string().min(1).max(4096).optional() }), z.object({ "kind": z.literal("app"), "projectId": z.string().min(1).max(4096), "sourceServerId": z.string().min(1).max(4096).optional(), "scope": z.literal("project") }), z.object({ "kind": z.literal("app"), "workspacePath": z.string().min(1).max(4096), "workspaceIdentity": z.string().min(1).max(4096).optional(), "sourceServerId": z.string().min(1).max(4096).optional(), "scope": z.literal("workspace") })])), "unavailableSources": z.array(z.object({ "sourceServerId": z.string().min(1).max(4096), "reason": z.string() })) }) }) }), z.object({ "ok": z.literal(false), "error": z.object({ "code": z.enum(["invalid_input","invalid_output","forbidden","self_wait","unavailable","conflict","cancelled","observation_invalid"]), "message": z.string() }) })]);
|
|
237
|
+
export type RequestAppControlListProjectsAnswer = z.output<typeof RequestAppControlListProjectsAnswerSchema>;
|
|
238
|
+
|
|
239
|
+
export const RequestAppControlListSessionsParamsSchema = z.object({ "callerSessionId": z.string().min(1).max(4096), "callId": z.string().min(1).max(4096), "turnId": z.string().min(1).max(4096).optional(), "input": z.object({ "project": z.object({ "kind": z.literal("app"), "projectId": z.string().min(1).max(4096), "sourceServerId": z.string().min(1).max(4096).optional() }).describe("A project from ListProjects, replayed exactly as that result returned it.").optional(), "archived": z.enum(["exclude","include","only"]).default("exclude"), "query": z.string().max(4096).optional(), "cursor": z.string().min(1).max(4096).describe("The nextCursor from the previous page of this same call. Omit it for the first page.").optional(), "limit": z.number().int().gte(1).lte(200).optional() }) });
|
|
240
|
+
export type RequestAppControlListSessionsParams = z.output<typeof RequestAppControlListSessionsParamsSchema>;
|
|
241
|
+
|
|
242
|
+
export const RequestAppControlListSessionsAnswerSchema = z.union([z.object({ "ok": z.literal(true), "result": z.object({ "sessions": z.array(z.object({ "session": z.object({ "kind": z.literal("app"), "workspacePath": z.string().min(1).max(4096), "workspaceIdentity": z.string().min(1).max(4096).optional(), "sourceServerId": z.string().min(1).max(4096).optional(), "sessionId": z.string().min(1).max(4096), "project": z.object({ "kind": z.literal("app"), "projectId": z.string().min(1).max(4096), "sourceServerId": z.string().min(1).max(4096).optional() }).optional() }), "title": z.string(), "status": z.enum(["unknown","idle","running","needs_attention"]), "availableActions": z.array(z.enum(["listSessions","readSession","createSession","forkSession","sendToSession","waitSessions","interruptSession","renameSession","listProjects","openSession","setSessionArchived","setSessionPinned"])), "updatedAt": z.string().optional(), "executionId": z.string().min(1).max(4096).optional(), "archived": z.boolean().optional(), "pinned": z.boolean().optional() })), "nextCursor": z.string().min(1).max(4096).optional(), "searchScope": z.object({ "scopes": z.array(z.union([z.object({ "kind": z.literal("app"), "scope": z.literal("host"), "sourceServerId": z.string().min(1).max(4096).optional() }), z.object({ "kind": z.literal("app"), "projectId": z.string().min(1).max(4096), "sourceServerId": z.string().min(1).max(4096).optional(), "scope": z.literal("project") }), z.object({ "kind": z.literal("app"), "workspacePath": z.string().min(1).max(4096), "workspaceIdentity": z.string().min(1).max(4096).optional(), "sourceServerId": z.string().min(1).max(4096).optional(), "scope": z.literal("workspace") })])), "unavailableSources": z.array(z.object({ "sourceServerId": z.string().min(1).max(4096), "reason": z.string() })) }) }) }), z.object({ "ok": z.literal(false), "error": z.object({ "code": z.enum(["invalid_input","invalid_output","forbidden","self_wait","unavailable","conflict","cancelled","observation_invalid"]), "message": z.string() }) })]);
|
|
243
|
+
export type RequestAppControlListSessionsAnswer = z.output<typeof RequestAppControlListSessionsAnswerSchema>;
|
|
244
|
+
|
|
245
|
+
export const RequestAppControlReadSessionParamsSchema = z.object({ "callerSessionId": z.string().min(1).max(4096), "callId": z.string().min(1).max(4096), "turnId": z.string().min(1).max(4096).optional(), "input": z.object({ "session": z.object({ "kind": z.literal("app"), "workspacePath": z.string().min(1).max(4096), "workspaceIdentity": z.string().min(1).max(4096).optional(), "sourceServerId": z.string().min(1).max(4096).optional(), "sessionId": z.string().min(1).max(4096), "project": z.object({ "kind": z.literal("app"), "projectId": z.string().min(1).max(4096), "sourceServerId": z.string().min(1).max(4096).optional() }).optional() }).optional(), "sessionId": z.string().regex(new RegExp("^(?:sess|session)_[A-Za-z0-9._-]+$")).min(1).max(4096).optional(), "view": z.enum(["summary","messages"]), "cursor": z.string().min(1).max(4096).describe("The nextCursor from the previous page of this same call. Omit it for the first page.").optional(), "limit": z.number().int().gte(1).lte(200).optional() }) });
|
|
246
|
+
export type RequestAppControlReadSessionParams = z.output<typeof RequestAppControlReadSessionParamsSchema>;
|
|
247
|
+
|
|
248
|
+
export const RequestAppControlReadSessionAnswerSchema = z.union([z.object({ "ok": z.literal(true), "result": z.union([z.object({ "view": z.literal("summary"), "summary": z.object({ "session": z.union([z.object({ "kind": z.literal("cli"), "workspacePath": z.string().min(1).max(4096), "workspaceIdentity": z.string().min(1).max(4096).optional(), "sessionId": z.string().min(1).max(4096) }), z.object({ "kind": z.literal("app"), "workspacePath": z.string().min(1).max(4096), "workspaceIdentity": z.string().min(1).max(4096).optional(), "sourceServerId": z.string().min(1).max(4096).optional(), "sessionId": z.string().min(1).max(4096), "project": z.object({ "kind": z.literal("app"), "projectId": z.string().min(1).max(4096), "sourceServerId": z.string().min(1).max(4096).optional() }).optional() })]), "title": z.string(), "status": z.enum(["unknown","idle","running","needs_attention"]), "availableActions": z.array(z.enum(["listSessions","readSession","createSession","forkSession","sendToSession","waitSessions","interruptSession","renameSession","listProjects","openSession","setSessionArchived","setSessionPinned"])), "updatedAt": z.string().optional(), "executionId": z.string().min(1).max(4096).optional(), "archived": z.boolean().optional(), "pinned": z.boolean().optional() }) }), z.object({ "view": z.literal("messages"), "session": z.union([z.object({ "kind": z.literal("cli"), "workspacePath": z.string().min(1).max(4096), "workspaceIdentity": z.string().min(1).max(4096).optional(), "sessionId": z.string().min(1).max(4096) }), z.object({ "kind": z.literal("app"), "workspacePath": z.string().min(1).max(4096), "workspaceIdentity": z.string().min(1).max(4096).optional(), "sourceServerId": z.string().min(1).max(4096).optional(), "sessionId": z.string().min(1).max(4096), "project": z.object({ "kind": z.literal("app"), "projectId": z.string().min(1).max(4096), "sourceServerId": z.string().min(1).max(4096).optional() }).optional() })]), "messages": z.array(z.object({ "id": z.string().min(1).max(4096), "role": z.enum(["user","assistant","system","tool"]), "text": z.string() })), "nextCursor": z.string().min(1).max(4096).optional() })]) }), z.object({ "ok": z.literal(false), "error": z.object({ "code": z.enum(["invalid_input","invalid_output","forbidden","self_wait","unavailable","conflict","cancelled","observation_invalid"]), "message": z.string() }) })]);
|
|
249
|
+
export type RequestAppControlReadSessionAnswer = z.output<typeof RequestAppControlReadSessionAnswerSchema>;
|
|
250
|
+
|
|
251
|
+
export const RequestAppControlCreateSessionParamsSchema = z.object({ "callerSessionId": z.string().min(1).max(4096), "callId": z.string().min(1).max(4096), "turnId": z.string().min(1).max(4096).optional(), "input": z.object({ "project": z.object({ "kind": z.literal("app"), "projectId": z.string().min(1).max(4096), "sourceServerId": z.string().min(1).max(4096).optional() }).describe("A project from ListProjects, replayed exactly as that result returned it."), "prompt": z.string().min(1).max(1000000), "model": z.string().min(1).max(4096).describe("A model id from ListModels, either `modelId` or `providerId/modelId`. It must match exactly one configured model. Omit it to use the configured default.").optional(), "requestId": z.string().min(1).max(4096), "mode": z.enum(["build","guarded","yolo"]).optional() }) });
|
|
252
|
+
export type RequestAppControlCreateSessionParams = z.output<typeof RequestAppControlCreateSessionParamsSchema>;
|
|
253
|
+
|
|
254
|
+
export const RequestAppControlCreateSessionAnswerSchema = z.union([z.object({ "ok": z.literal(true), "result": z.object({ "requestId": z.string().min(1).max(4096).describe("This request's identity. Pass it as `retryOf` only if you must retry this exact request."), "creation": z.enum(["created","rejected","unknown"]), "firstInput": z.enum(["accepted","rejected","unknown"]), "delivery": z.enum(["start_now","queued","none","unknown"]), "session": z.union([z.object({ "kind": z.literal("cli"), "workspacePath": z.string().min(1).max(4096), "workspaceIdentity": z.string().min(1).max(4096).optional(), "sessionId": z.string().min(1).max(4096) }), z.object({ "kind": z.literal("app"), "workspacePath": z.string().min(1).max(4096), "workspaceIdentity": z.string().min(1).max(4096).optional(), "sourceServerId": z.string().min(1).max(4096).optional(), "sessionId": z.string().min(1).max(4096), "project": z.object({ "kind": z.literal("app"), "projectId": z.string().min(1).max(4096), "sourceServerId": z.string().min(1).max(4096).optional() }).optional() })]).optional(), "operation": z.object({ "session": z.union([z.object({ "kind": z.literal("cli"), "workspacePath": z.string().min(1).max(4096), "workspaceIdentity": z.string().min(1).max(4096).optional(), "sessionId": z.string().min(1).max(4096) }), z.object({ "kind": z.literal("app"), "workspacePath": z.string().min(1).max(4096), "workspaceIdentity": z.string().min(1).max(4096).optional(), "sourceServerId": z.string().min(1).max(4096).optional(), "sessionId": z.string().min(1).max(4096), "project": z.object({ "kind": z.literal("app"), "projectId": z.string().min(1).max(4096), "sourceServerId": z.string().min(1).max(4096).optional() }).optional() })]), "sessionId": z.string().regex(new RegExp("^(?:sess|session)_[A-Za-z0-9._-]+$")).min(1).max(4096).describe("The session this operation belongs to."), "commandId": z.string().min(1).max(4096).describe("Pass this operation straight back as one WaitSessions operation; do not rebuild it.") }).optional(), "reason": z.string().optional() }) }), z.object({ "ok": z.literal(false), "error": z.object({ "code": z.enum(["invalid_input","invalid_output","forbidden","self_wait","unavailable","conflict","cancelled","observation_invalid"]), "message": z.string() }) })]);
|
|
255
|
+
export type RequestAppControlCreateSessionAnswer = z.output<typeof RequestAppControlCreateSessionAnswerSchema>;
|
|
256
|
+
|
|
257
|
+
export const RequestAppControlForkSessionParamsSchema = z.object({ "callerSessionId": z.string().min(1).max(4096), "callId": z.string().min(1).max(4096), "turnId": z.string().min(1).max(4096).optional(), "input": z.object({ "session": z.object({ "kind": z.literal("app"), "workspacePath": z.string().min(1).max(4096), "workspaceIdentity": z.string().min(1).max(4096).optional(), "sourceServerId": z.string().min(1).max(4096).optional(), "sessionId": z.string().min(1).max(4096), "project": z.object({ "kind": z.literal("app"), "projectId": z.string().min(1).max(4096), "sourceServerId": z.string().min(1).max(4096).optional() }).optional() }).optional(), "sessionId": z.string().regex(new RegExp("^(?:sess|session)_[A-Za-z0-9._-]+$")).min(1).max(4096).optional(), "atMessage": z.string().min(1).max(4096).describe("A message id from ReadSession with view=messages — the `id` of the entry to fork at. Never invent one."), "requestId": z.string().min(1).max(4096) }) });
|
|
258
|
+
export type RequestAppControlForkSessionParams = z.output<typeof RequestAppControlForkSessionParamsSchema>;
|
|
259
|
+
|
|
260
|
+
export const RequestAppControlForkSessionAnswerSchema = z.union([z.object({ "ok": z.literal(true), "result": z.object({ "status": z.enum(["created","rejected","unknown"]), "session": z.union([z.object({ "kind": z.literal("cli"), "workspacePath": z.string().min(1).max(4096), "workspaceIdentity": z.string().min(1).max(4096).optional(), "sessionId": z.string().min(1).max(4096) }), z.object({ "kind": z.literal("app"), "workspacePath": z.string().min(1).max(4096), "workspaceIdentity": z.string().min(1).max(4096).optional(), "sourceServerId": z.string().min(1).max(4096).optional(), "sessionId": z.string().min(1).max(4096), "project": z.object({ "kind": z.literal("app"), "projectId": z.string().min(1).max(4096), "sourceServerId": z.string().min(1).max(4096).optional() }).optional() })]).optional(), "requestId": z.string().min(1).max(4096).describe("This request's identity. Pass it as `retryOf` only if you must retry this exact request."), "reason": z.string().optional() }) }), z.object({ "ok": z.literal(false), "error": z.object({ "code": z.enum(["invalid_input","invalid_output","forbidden","self_wait","unavailable","conflict","cancelled","observation_invalid"]), "message": z.string() }) })]);
|
|
261
|
+
export type RequestAppControlForkSessionAnswer = z.output<typeof RequestAppControlForkSessionAnswerSchema>;
|
|
262
|
+
|
|
263
|
+
export const RequestAppControlSendToSessionParamsSchema = z.object({ "callerSessionId": z.string().min(1).max(4096), "callId": z.string().min(1).max(4096), "turnId": z.string().min(1).max(4096).optional(), "input": z.object({ "session": z.object({ "kind": z.literal("app"), "workspacePath": z.string().min(1).max(4096), "workspaceIdentity": z.string().min(1).max(4096).optional(), "sourceServerId": z.string().min(1).max(4096).optional(), "sessionId": z.string().min(1).max(4096), "project": z.object({ "kind": z.literal("app"), "projectId": z.string().min(1).max(4096), "sourceServerId": z.string().min(1).max(4096).optional() }).optional() }).optional(), "sessionId": z.string().regex(new RegExp("^(?:sess|session)_[A-Za-z0-9._-]+$")).min(1).max(4096).optional(), "prompt": z.string().min(1).max(1000000), "requestId": z.string().min(1).max(4096), "model": z.string().min(1).max(4096).describe("A model id from ListModels, either `modelId` or `providerId/modelId`. It must match exactly one configured model. Omit it to use the configured default.").optional() }) });
|
|
264
|
+
export type RequestAppControlSendToSessionParams = z.output<typeof RequestAppControlSendToSessionParamsSchema>;
|
|
265
|
+
|
|
266
|
+
export const RequestAppControlSendToSessionAnswerSchema = z.union([z.object({ "ok": z.literal(true), "result": z.object({ "requestId": z.string().min(1).max(4096).describe("This request's identity. Pass it as `retryOf` only if you must retry this exact request."), "session": z.union([z.object({ "kind": z.literal("cli"), "workspacePath": z.string().min(1).max(4096), "workspaceIdentity": z.string().min(1).max(4096).optional(), "sessionId": z.string().min(1).max(4096) }), z.object({ "kind": z.literal("app"), "workspacePath": z.string().min(1).max(4096), "workspaceIdentity": z.string().min(1).max(4096).optional(), "sourceServerId": z.string().min(1).max(4096).optional(), "sessionId": z.string().min(1).max(4096), "project": z.object({ "kind": z.literal("app"), "projectId": z.string().min(1).max(4096), "sourceServerId": z.string().min(1).max(4096).optional() }).optional() })]), "operation": z.object({ "session": z.union([z.object({ "kind": z.literal("cli"), "workspacePath": z.string().min(1).max(4096), "workspaceIdentity": z.string().min(1).max(4096).optional(), "sessionId": z.string().min(1).max(4096) }), z.object({ "kind": z.literal("app"), "workspacePath": z.string().min(1).max(4096), "workspaceIdentity": z.string().min(1).max(4096).optional(), "sourceServerId": z.string().min(1).max(4096).optional(), "sessionId": z.string().min(1).max(4096), "project": z.object({ "kind": z.literal("app"), "projectId": z.string().min(1).max(4096), "sourceServerId": z.string().min(1).max(4096).optional() }).optional() })]), "sessionId": z.string().regex(new RegExp("^(?:sess|session)_[A-Za-z0-9._-]+$")).min(1).max(4096).describe("The session this operation belongs to."), "commandId": z.string().min(1).max(4096).describe("Pass this operation straight back as one WaitSessions operation; do not rebuild it.") }), "admission": z.enum(["accepted","rejected","unknown"]), "delivery": z.enum(["start_now","queued","none","unknown"]), "reason": z.string().optional() }) }), z.object({ "ok": z.literal(false), "error": z.object({ "code": z.enum(["invalid_input","invalid_output","forbidden","self_wait","unavailable","conflict","cancelled","observation_invalid"]), "message": z.string() }) })]);
|
|
267
|
+
export type RequestAppControlSendToSessionAnswer = z.output<typeof RequestAppControlSendToSessionAnswerSchema>;
|
|
268
|
+
|
|
269
|
+
export const RequestAppControlWaitSessionsParamsSchema = z.object({ "callerSessionId": z.string().min(1).max(4096), "callId": z.string().min(1).max(4096), "turnId": z.string().min(1).max(4096).optional(), "input": z.object({ "operations": z.array(z.object({ "session": z.object({ "kind": z.literal("app"), "workspacePath": z.string().min(1).max(4096), "workspaceIdentity": z.string().min(1).max(4096).optional(), "sourceServerId": z.string().min(1).max(4096).optional(), "sessionId": z.string().min(1).max(4096), "project": z.object({ "kind": z.literal("app"), "projectId": z.string().min(1).max(4096), "sourceServerId": z.string().min(1).max(4096).optional() }).optional() }).optional(), "sessionId": z.string().regex(new RegExp("^(?:sess|session)_[A-Za-z0-9._-]+$")).min(1).max(4096).optional(), "commandId": z.string().min(1).max(4096) })).min(1).max(100), "mode": z.enum(["any","all"]), "timeoutMs": z.number().int().gte(0).lte(300000).default(30000) }) });
|
|
270
|
+
export type RequestAppControlWaitSessionsParams = z.output<typeof RequestAppControlWaitSessionsParamsSchema>;
|
|
271
|
+
|
|
272
|
+
export const RequestAppControlWaitSessionsAnswerSchema = z.union([z.object({ "ok": z.literal(true), "result": z.object({ "status": z.enum(["completed","timed_out","cancelled","unknown"]), "operations": z.array(z.object({ "operation": z.object({ "session": z.union([z.object({ "kind": z.literal("cli"), "workspacePath": z.string().min(1).max(4096), "workspaceIdentity": z.string().min(1).max(4096).optional(), "sessionId": z.string().min(1).max(4096) }), z.object({ "kind": z.literal("app"), "workspacePath": z.string().min(1).max(4096), "workspaceIdentity": z.string().min(1).max(4096).optional(), "sourceServerId": z.string().min(1).max(4096).optional(), "sessionId": z.string().min(1).max(4096), "project": z.object({ "kind": z.literal("app"), "projectId": z.string().min(1).max(4096), "sourceServerId": z.string().min(1).max(4096).optional() }).optional() })]), "sessionId": z.string().regex(new RegExp("^(?:sess|session)_[A-Za-z0-9._-]+$")).min(1).max(4096).describe("The session this operation belongs to."), "commandId": z.string().min(1).max(4096).describe("Pass this operation straight back as one WaitSessions operation; do not rebuild it.") }), "epoch": z.string().min(1).max(4096), "revision": z.number().int().gte(0).lte(9007199254740991), "status": z.enum(["unknown","idle","accepted","queued","running","completed","interrupted","failed","needs_attention"]), "executionId": z.string().min(1).max(4096).optional(), "reason": z.string().optional(), "attention": z.object({ "kind": z.enum(["approval","question"]), "message": z.string().optional(), "url": z.string().url().optional() }).optional() })) }) }), z.object({ "ok": z.literal(false), "error": z.object({ "code": z.enum(["invalid_input","invalid_output","forbidden","self_wait","unavailable","conflict","cancelled","observation_invalid"]), "message": z.string() }) })]);
|
|
273
|
+
export type RequestAppControlWaitSessionsAnswer = z.output<typeof RequestAppControlWaitSessionsAnswerSchema>;
|
|
274
|
+
|
|
275
|
+
export const RequestAppControlInterruptSessionParamsSchema = z.object({ "callerSessionId": z.string().min(1).max(4096), "callId": z.string().min(1).max(4096), "turnId": z.string().min(1).max(4096).optional(), "input": z.object({ "session": z.object({ "kind": z.literal("app"), "workspacePath": z.string().min(1).max(4096), "workspaceIdentity": z.string().min(1).max(4096).optional(), "sourceServerId": z.string().min(1).max(4096).optional(), "sessionId": z.string().min(1).max(4096), "project": z.object({ "kind": z.literal("app"), "projectId": z.string().min(1).max(4096), "sourceServerId": z.string().min(1).max(4096).optional() }).optional() }).optional(), "sessionId": z.string().regex(new RegExp("^(?:sess|session)_[A-Za-z0-9._-]+$")).min(1).max(4096).optional(), "expectedExecutionId": z.string().min(1).max(4096).describe("The executionId reported by ListSessions or WaitSessions for this session. If neither reports one the session is not executing, so there is nothing to interrupt."), "requestId": z.string().min(1).max(4096) }) });
|
|
276
|
+
export type RequestAppControlInterruptSessionParams = z.output<typeof RequestAppControlInterruptSessionParamsSchema>;
|
|
277
|
+
|
|
278
|
+
export const RequestAppControlInterruptSessionAnswerSchema = z.union([z.object({ "ok": z.literal(true), "result": z.object({ "status": z.enum(["applied","rejected","unknown"]), "requestId": z.string().min(1).max(4096).describe("This request's identity. Pass it as `retryOf` only if you must retry this exact request."), "reason": z.string().optional() }) }), z.object({ "ok": z.literal(false), "error": z.object({ "code": z.enum(["invalid_input","invalid_output","forbidden","self_wait","unavailable","conflict","cancelled","observation_invalid"]), "message": z.string() }) })]);
|
|
279
|
+
export type RequestAppControlInterruptSessionAnswer = z.output<typeof RequestAppControlInterruptSessionAnswerSchema>;
|
|
280
|
+
|
|
281
|
+
export const RequestAppControlRenameSessionParamsSchema = z.object({ "callerSessionId": z.string().min(1).max(4096), "callId": z.string().min(1).max(4096), "turnId": z.string().min(1).max(4096).optional(), "input": z.object({ "session": z.object({ "kind": z.literal("app"), "workspacePath": z.string().min(1).max(4096), "workspaceIdentity": z.string().min(1).max(4096).optional(), "sourceServerId": z.string().min(1).max(4096).optional(), "sessionId": z.string().min(1).max(4096), "project": z.object({ "kind": z.literal("app"), "projectId": z.string().min(1).max(4096), "sourceServerId": z.string().min(1).max(4096).optional() }).optional() }).optional(), "sessionId": z.string().regex(new RegExp("^(?:sess|session)_[A-Za-z0-9._-]+$")).min(1).max(4096).optional(), "title": z.string().min(1).max(1024), "requestId": z.string().min(1).max(4096) }) });
|
|
282
|
+
export type RequestAppControlRenameSessionParams = z.output<typeof RequestAppControlRenameSessionParamsSchema>;
|
|
283
|
+
|
|
284
|
+
export const RequestAppControlRenameSessionAnswerSchema = z.union([z.object({ "ok": z.literal(true), "result": z.object({ "status": z.enum(["applied","rejected","unknown"]), "requestId": z.string().min(1).max(4096).describe("This request's identity. Pass it as `retryOf` only if you must retry this exact request."), "reason": z.string().optional() }) }), z.object({ "ok": z.literal(false), "error": z.object({ "code": z.enum(["invalid_input","invalid_output","forbidden","self_wait","unavailable","conflict","cancelled","observation_invalid"]), "message": z.string() }) })]);
|
|
285
|
+
export type RequestAppControlRenameSessionAnswer = z.output<typeof RequestAppControlRenameSessionAnswerSchema>;
|
|
286
|
+
|
|
287
|
+
export const RequestAppControlOpenSessionParamsSchema = z.object({ "callerSessionId": z.string().min(1).max(4096), "callId": z.string().min(1).max(4096), "turnId": z.string().min(1).max(4096).optional(), "input": z.object({ "session": z.object({ "kind": z.literal("app"), "workspacePath": z.string().min(1).max(4096), "workspaceIdentity": z.string().min(1).max(4096).optional(), "sourceServerId": z.string().min(1).max(4096).optional(), "sessionId": z.string().min(1).max(4096), "project": z.object({ "kind": z.literal("app"), "projectId": z.string().min(1).max(4096), "sourceServerId": z.string().min(1).max(4096).optional() }).optional() }).optional(), "sessionId": z.string().regex(new RegExp("^(?:sess|session)_[A-Za-z0-9._-]+$")).min(1).max(4096).optional() }) });
|
|
288
|
+
export type RequestAppControlOpenSessionParams = z.output<typeof RequestAppControlOpenSessionParamsSchema>;
|
|
289
|
+
|
|
290
|
+
export const RequestAppControlOpenSessionAnswerSchema = z.union([z.object({ "ok": z.literal(true), "result": z.object({ "status": z.enum(["opened","unavailable"]), "uiTarget": z.string().min(1).max(4096).optional(), "reason": z.string().optional() }) }), z.object({ "ok": z.literal(false), "error": z.object({ "code": z.enum(["invalid_input","invalid_output","forbidden","self_wait","unavailable","conflict","cancelled","observation_invalid"]), "message": z.string() }) })]);
|
|
291
|
+
export type RequestAppControlOpenSessionAnswer = z.output<typeof RequestAppControlOpenSessionAnswerSchema>;
|
|
292
|
+
|
|
293
|
+
export const RequestAppControlSetSessionArchivedParamsSchema = z.object({ "callerSessionId": z.string().min(1).max(4096), "callId": z.string().min(1).max(4096), "turnId": z.string().min(1).max(4096).optional(), "input": z.object({ "session": z.object({ "kind": z.literal("app"), "workspacePath": z.string().min(1).max(4096), "workspaceIdentity": z.string().min(1).max(4096).optional(), "sourceServerId": z.string().min(1).max(4096).optional(), "sessionId": z.string().min(1).max(4096), "project": z.object({ "kind": z.literal("app"), "projectId": z.string().min(1).max(4096), "sourceServerId": z.string().min(1).max(4096).optional() }).optional() }).optional(), "sessionId": z.string().regex(new RegExp("^(?:sess|session)_[A-Za-z0-9._-]+$")).min(1).max(4096).optional(), "archived": z.boolean(), "requestId": z.string().min(1).max(4096) }) });
|
|
294
|
+
export type RequestAppControlSetSessionArchivedParams = z.output<typeof RequestAppControlSetSessionArchivedParamsSchema>;
|
|
295
|
+
|
|
296
|
+
export const RequestAppControlSetSessionArchivedAnswerSchema = z.union([z.object({ "ok": z.literal(true), "result": z.object({ "status": z.enum(["applied","rejected","unknown"]), "requestId": z.string().min(1).max(4096).describe("This request's identity. Pass it as `retryOf` only if you must retry this exact request."), "reason": z.string().optional() }) }), z.object({ "ok": z.literal(false), "error": z.object({ "code": z.enum(["invalid_input","invalid_output","forbidden","self_wait","unavailable","conflict","cancelled","observation_invalid"]), "message": z.string() }) })]);
|
|
297
|
+
export type RequestAppControlSetSessionArchivedAnswer = z.output<typeof RequestAppControlSetSessionArchivedAnswerSchema>;
|
|
298
|
+
|
|
299
|
+
export const RequestAppControlSetSessionPinnedParamsSchema = z.object({ "callerSessionId": z.string().min(1).max(4096), "callId": z.string().min(1).max(4096), "turnId": z.string().min(1).max(4096).optional(), "input": z.object({ "session": z.object({ "kind": z.literal("app"), "workspacePath": z.string().min(1).max(4096), "workspaceIdentity": z.string().min(1).max(4096).optional(), "sourceServerId": z.string().min(1).max(4096).optional(), "sessionId": z.string().min(1).max(4096), "project": z.object({ "kind": z.literal("app"), "projectId": z.string().min(1).max(4096), "sourceServerId": z.string().min(1).max(4096).optional() }).optional() }).optional(), "sessionId": z.string().regex(new RegExp("^(?:sess|session)_[A-Za-z0-9._-]+$")).min(1).max(4096).optional(), "pinned": z.boolean(), "requestId": z.string().min(1).max(4096) }) });
|
|
300
|
+
export type RequestAppControlSetSessionPinnedParams = z.output<typeof RequestAppControlSetSessionPinnedParamsSchema>;
|
|
301
|
+
|
|
302
|
+
export const RequestAppControlSetSessionPinnedAnswerSchema = z.union([z.object({ "ok": z.literal(true), "result": z.object({ "status": z.enum(["applied","rejected","unknown"]), "requestId": z.string().min(1).max(4096).describe("This request's identity. Pass it as `retryOf` only if you must retry this exact request."), "reason": z.string().optional() }) }), z.object({ "ok": z.literal(false), "error": z.object({ "code": z.enum(["invalid_input","invalid_output","forbidden","self_wait","unavailable","conflict","cancelled","observation_invalid"]), "message": z.string() }) })]);
|
|
303
|
+
export type RequestAppControlSetSessionPinnedAnswer = z.output<typeof RequestAppControlSetSessionPinnedAnswerSchema>;
|
|
304
|
+
|
|
305
|
+
export const RequestAppControlCancelParamsSchema = z.object({ "callerSessionId": z.string().min(1).max(4096), "callId": z.string().min(1).max(4096) });
|
|
306
|
+
export type RequestAppControlCancelParams = z.output<typeof RequestAppControlCancelParamsSchema>;
|
|
307
|
+
|
|
308
|
+
export const RequestAppControlCancelAnswerSchema = z.object({ "cancelled": z.boolean() });
|
|
309
|
+
export type RequestAppControlCancelAnswer = z.output<typeof RequestAppControlCancelAnswerSchema>;
|
|
310
|
+
|
|
311
|
+
export const SessionMessageSchema = z.object({ "info": z.union([z.object({ "messageId": z.string().min(1), "sessionId": z.string().min(1), "role": z.literal("user"), "time": z.object({ "created": z.number().int().gte(0).lte(9007199254740991), "completed": z.number().int().gte(0).lte(9007199254740991).optional() }), "agent": z.string().min(1), "model": z.object({ "providerId": z.string().min(1), "modelId": z.string().min(1), "options": z.object({ "reasoningLevel": z.string().min(1).optional() }).optional() }).optional(), "system": z.string().optional(), "tools": z.record(z.string(), z.boolean()).optional(), "synthetic": z.boolean().optional(), "source": z.enum(["agent_listing_delta","background_task","fork","goal_state_change","goal-continuation","plugin_reference","bot_topic_context","rewind","selection_side_chat","subagent","subagent_message","todo_reminder","workflow_launch","shared_context"]).optional(), "visibility": z.enum(["user-visible","model-only"]).optional(), "semantics": z.object({ "origin": z.enum(["real_user","agent_runtime","system","migration","import"]), "kind": z.enum(["user_prompt","slash_command","system_reminder","background_notification","subagent_notification","todo_reminder","rewind_notice","fork_notice","timeline_event","compact_summary","shared_context","assistant_response"]), "source": z.string().optional(), "commandName": z.string().optional(), "uiVisibility": z.enum(["visible","hidden","debug"]), "providerVisibility": z.enum(["visible","hidden"]), "transcriptVisibility": z.enum(["visible","hidden"]) }).optional(), "metadata": z.record(z.string(), z.unknown()).optional() }), z.object({ "messageId": z.string().min(1), "sessionId": z.string().min(1), "role": z.literal("assistant"), "time": z.object({ "created": z.number().int().gte(0).lte(9007199254740991), "completed": z.number().int().gte(0).lte(9007199254740991).optional() }), "parentMessageId": z.string().min(1), "agent": z.string().min(1), "model": z.object({ "providerId": z.string().min(1), "modelId": z.string().min(1), "options": z.object({ "reasoningLevel": z.string().min(1).optional() }).optional() }).optional(), "path": z.object({ "cwd": z.string().min(1), "root": z.string().min(1) }), "cost": z.number().gte(0), "tokens": z.object({ "total": z.number().int().gte(0).lte(9007199254740991).optional(), "input": z.number().int().gte(0).lte(9007199254740991), "output": z.number().int().gte(0).lte(9007199254740991), "reasoning": z.number().int().gte(0).lte(9007199254740991), "cache": z.object({ "read": z.number().int().gte(0).lte(9007199254740991), "write": z.number().int().gte(0).lte(9007199254740991) }) }), "finish": z.string().optional(), "error": z.record(z.string(), z.unknown()).optional(), "semantics": z.object({ "origin": z.enum(["real_user","agent_runtime","system","migration","import"]), "kind": z.enum(["user_prompt","slash_command","system_reminder","background_notification","subagent_notification","todo_reminder","rewind_notice","fork_notice","timeline_event","compact_summary","shared_context","assistant_response"]), "source": z.string().optional(), "commandName": z.string().optional(), "uiVisibility": z.enum(["visible","hidden","debug"]), "providerVisibility": z.enum(["visible","hidden"]), "transcriptVisibility": z.enum(["visible","hidden"]) }).optional(), "structured": z.unknown().optional() })]), "parts": z.array(z.union([z.object({ "partId": z.string().min(1), "sessionId": z.string().min(1), "messageId": z.string().min(1), "type": z.literal("text"), "text": z.string(), "synthetic": z.boolean().optional(), "ignored": z.boolean().optional(), "metadata": z.record(z.string(), z.unknown()).optional() }), z.object({ "partId": z.string().min(1), "sessionId": z.string().min(1), "messageId": z.string().min(1), "type": z.literal("reasoning"), "text": z.string(), "metadata": z.record(z.string(), z.unknown()).optional() }), z.object({ "partId": z.string().min(1), "sessionId": z.string().min(1), "messageId": z.string().min(1), "type": z.literal("file"), "mime": z.string().min(1), "filename": z.string().optional(), "url": z.string().min(1), "metadata": z.record(z.string(), z.unknown()).optional() }), z.object({ "partId": z.string().min(1), "sessionId": z.string().min(1), "messageId": z.string().min(1), "type": z.literal("tool"), "callId": z.string().min(1), "tool": z.string().min(1), "state": z.union([z.object({ "status": z.literal("pending"), "input": z.record(z.string(), z.unknown()), "raw": z.string() }), z.object({ "status": z.literal("running"), "input": z.record(z.string(), z.unknown()), "title": z.string().optional(), "metadata": z.record(z.string(), z.unknown()).optional(), "startedAt": z.number().int().gte(0).lte(9007199254740991) }), z.object({ "status": z.literal("completed"), "input": z.record(z.string(), z.unknown()), "output": z.string(), "title": z.string(), "metadata": z.record(z.string(), z.unknown()), "startedAt": z.number().int().gte(0).lte(9007199254740991), "completedAt": z.number().int().gte(0).lte(9007199254740991) }), z.object({ "status": z.literal("error"), "input": z.record(z.string(), z.unknown()), "error": z.string(), "metadata": z.record(z.string(), z.unknown()).optional(), "startedAt": z.number().int().gte(0).lte(9007199254740991), "completedAt": z.number().int().gte(0).lte(9007199254740991) })]), "metadata": z.record(z.string(), z.unknown()).optional() }), z.object({ "partId": z.string().min(1), "sessionId": z.string().min(1), "messageId": z.string().min(1), "type": z.literal("step-start"), "snapshot": z.string().optional() }), z.object({ "partId": z.string().min(1), "sessionId": z.string().min(1), "messageId": z.string().min(1), "type": z.literal("step-finish"), "reason": z.string(), "snapshot": z.string().optional(), "cost": z.number().gte(0), "tokens": z.object({ "total": z.number().int().gte(0).lte(9007199254740991).optional(), "input": z.number().int().gte(0).lte(9007199254740991), "output": z.number().int().gte(0).lte(9007199254740991), "reasoning": z.number().int().gte(0).lte(9007199254740991), "cache": z.object({ "read": z.number().int().gte(0).lte(9007199254740991), "write": z.number().int().gte(0).lte(9007199254740991) }) }) }), z.object({ "partId": z.string().min(1), "sessionId": z.string().min(1), "messageId": z.string().min(1), "type": z.literal("snapshot"), "snapshot": z.string() }), z.object({ "partId": z.string().min(1), "sessionId": z.string().min(1), "messageId": z.string().min(1), "type": z.literal("patch"), "hash": z.string().min(1), "files": z.array(z.string()) }), z.object({ "partId": z.string().min(1), "sessionId": z.string().min(1), "messageId": z.string().min(1), "type": z.literal("compaction"), "auto": z.boolean(), "reason": z.string().optional(), "summaryMessageId": z.string().min(1).optional(), "metadata": z.record(z.string(), z.unknown()).optional() }), z.object({ "partId": z.string().min(1), "sessionId": z.string().min(1), "messageId": z.string().min(1), "type": z.literal("timeline"), "timelineType": z.enum(["context_compaction","goal_verification","session_fork","model_change","worktree_creation"]), "display": z.enum(["separator","worklog"]), "status": z.string().optional(), "anchorMessageId": z.string().min(1).optional(), "anchorTurnId": z.string().min(1).optional(), "time": z.object({ "start": z.number().int().gte(0).lte(9007199254740991).optional(), "end": z.number().int().gte(0).lte(9007199254740991).optional() }).optional(), "operationId": z.string().optional(), "trigger": z.enum(["manual","auto","partial","reactive","session_memory"]).optional(), "phase": z.enum(["standalone_turn","pre_request","mid_turn","reactive"]).optional(), "compactReason": z.string().optional(), "boundaryId": z.string().optional(), "summaryMessageId": z.string().min(1).optional(), "preCompactTokenCount": z.number().int().gte(0).lte(9007199254740991).optional(), "postCompactTokenCount": z.number().int().gte(0).lte(9007199254740991).optional(), "truePostCompactTokenCount": z.number().int().gte(0).lte(9007199254740991).optional(), "attempt": z.number().int().gte(0).lte(9007199254740991).optional(), "maxAttempts": z.number().int().gte(0).lte(9007199254740991).optional(), "reason": z.string().optional(), "targetId": z.string().optional(), "verificationId": z.string().optional(), "goalIteration": z.number().int().gte(0).lte(9007199254740991).optional(), "verification": z.object({ "passed": z.boolean(), "reason": z.string(), "nextAction": z.union([z.string(), z.null()]).optional() }).optional(), "parentSessionId": z.string().min(1).optional(), "targetMessageId": z.string().min(1).optional(), "targetCheckpointId": z.string().optional(), "restoredFileCount": z.number().int().gte(0).lte(9007199254740991).optional(), "fromModel": z.object({ "providerId": z.string().min(1), "modelId": z.string().min(1), "options": z.object({ "reasoningLevel": z.string().min(1).optional() }).optional(), "label": z.string().optional() }).optional(), "toModel": z.object({ "providerId": z.string().min(1), "modelId": z.string().min(1), "options": z.object({ "reasoningLevel": z.string().min(1).optional() }).optional(), "label": z.string().min(1) }).optional(), "worktreeCreation": z.object({ "path": z.string().min(1), "sha": z.string().min(1), "ref": z.union([z.string(), z.null()]), "output": z.string() }).optional() }), z.object({ "partId": z.string().min(1), "sessionId": z.string().min(1), "messageId": z.string().min(1), "type": z.literal("subagent"), "prompt": z.string(), "description": z.string(), "agent": z.string().min(1), "model": z.object({ "providerId": z.string().min(1), "modelId": z.string().min(1), "options": z.object({ "reasoningLevel": z.string().min(1).optional() }).optional() }).optional(), "command": z.string().optional() }), z.object({ "partId": z.string().min(1), "sessionId": z.string().min(1), "messageId": z.string().min(1), "type": z.literal("agent"), "name": z.string().min(1) }), z.object({ "partId": z.string().min(1), "sessionId": z.string().min(1), "messageId": z.string().min(1), "type": z.literal("retry"), "attempt": z.number().int().gte(0).lte(9007199254740991), "error": z.record(z.string(), z.unknown()) })])) });
|
|
312
|
+
export type SessionMessage = z.output<typeof SessionMessageSchema>;
|
|
313
|
+
|
|
314
|
+
/** The notifications ZCode sends, by method: the schema of their params. */
|
|
315
|
+
export const NOTIFICATION_SCHEMAS = {
|
|
316
|
+
"session/event": NotificationSessionEventSchema,
|
|
317
|
+
"state.updated": NotificationStateUpdatedSchema,
|
|
318
|
+
"session/lifecycle/changed": NotificationSessionLifecycleChangedSchema,
|
|
319
|
+
"startup/pluginsDegraded": NotificationPluginsDegradedSchema,
|
|
320
|
+
"startup/storageState": NotificationStorageStateSchema,
|
|
321
|
+
"interaction/providerRuntimeHeadersCancelled": NotificationProviderRuntimeHeadersCancelledSchema,
|
|
322
|
+
"process/mcpTelemetry": NotificationMcpTelemetrySchema,
|
|
323
|
+
"process/mcpResourceSamples": NotificationMcpResourceSamplesSchema,
|
|
324
|
+
"process/toolExecResource": NotificationToolExecResourceSchema,
|
|
325
|
+
"plugins/operationProgress": NotificationPluginOperationProgressSchema,
|
|
326
|
+
"process/resourceSample": NotificationProcessResourceSampleSchema,
|
|
327
|
+
"process/networkRequests": NotificationNetworkRequestsSchema,
|
|
328
|
+
"computer-use/operation-event": NotificationComputerUseOperationEventSchema,
|
|
329
|
+
} as const;
|
|
330
|
+
|
|
331
|
+
/** The requests ZCode makes of the client, by method: the schema of their params. */
|
|
332
|
+
export const REQUEST_SCHEMAS = {
|
|
333
|
+
"session/requestRuntimePreferences": RequestRuntimePreferencesParamsSchema,
|
|
334
|
+
"interaction/requestPermission": RequestPermissionParamsSchema,
|
|
335
|
+
"interaction/requestUserInput": RequestUserInputParamsSchema,
|
|
336
|
+
"interaction/requestProviderRuntimeHeaders": RequestProviderRuntimeHeadersParamsSchema,
|
|
337
|
+
"interaction/requestOfficialMcpAuthHeaders": RequestOfficialMcpAuthHeadersParamsSchema,
|
|
338
|
+
"interaction/requestCredentialCipher": RequestCredentialCipherParamsSchema,
|
|
339
|
+
"interaction/browserList": RequestBrowserListParamsSchema,
|
|
340
|
+
"interaction/browserExecute": RequestBrowserExecuteParamsSchema,
|
|
341
|
+
"subagents/readRuntimeConfig": RequestSubagentsRuntimeConfigParamsSchema,
|
|
342
|
+
"bot/channel/reply": RequestChannelReplyParamsSchema,
|
|
343
|
+
"topic/resource/read": RequestTopicResourceReadParamsSchema,
|
|
344
|
+
"topic/resource/cancel": RequestTopicResourceCancelParamsSchema,
|
|
345
|
+
"appControl/listProjects": RequestAppControlListProjectsParamsSchema,
|
|
346
|
+
"appControl/listSessions": RequestAppControlListSessionsParamsSchema,
|
|
347
|
+
"appControl/readSession": RequestAppControlReadSessionParamsSchema,
|
|
348
|
+
"appControl/createSession": RequestAppControlCreateSessionParamsSchema,
|
|
349
|
+
"appControl/forkSession": RequestAppControlForkSessionParamsSchema,
|
|
350
|
+
"appControl/sendToSession": RequestAppControlSendToSessionParamsSchema,
|
|
351
|
+
"appControl/waitSessions": RequestAppControlWaitSessionsParamsSchema,
|
|
352
|
+
"appControl/interruptSession": RequestAppControlInterruptSessionParamsSchema,
|
|
353
|
+
"appControl/renameSession": RequestAppControlRenameSessionParamsSchema,
|
|
354
|
+
"appControl/openSession": RequestAppControlOpenSessionParamsSchema,
|
|
355
|
+
"appControl/setSessionArchived": RequestAppControlSetSessionArchivedParamsSchema,
|
|
356
|
+
"appControl/setSessionPinned": RequestAppControlSetSessionPinnedParamsSchema,
|
|
357
|
+
"appControl/cancel": RequestAppControlCancelParamsSchema,
|
|
358
|
+
} as const;
|
|
359
|
+
|
|
360
|
+
/** The requests ZCode makes of the client, by method: the schema of the answer it takes. */
|
|
361
|
+
export const ANSWER_SCHEMAS = {
|
|
362
|
+
"session/requestRuntimePreferences": RequestRuntimePreferencesAnswerSchema,
|
|
363
|
+
"interaction/requestPermission": RequestPermissionAnswerSchema,
|
|
364
|
+
"interaction/requestUserInput": RequestUserInputAnswerSchema,
|
|
365
|
+
"interaction/requestProviderRuntimeHeaders": RequestProviderRuntimeHeadersAnswerSchema,
|
|
366
|
+
"interaction/requestOfficialMcpAuthHeaders": RequestOfficialMcpAuthHeadersAnswerSchema,
|
|
367
|
+
"interaction/requestCredentialCipher": RequestCredentialCipherAnswerSchema,
|
|
368
|
+
"interaction/browserList": RequestBrowserListAnswerSchema,
|
|
369
|
+
"interaction/browserExecute": RequestBrowserExecuteAnswerSchema,
|
|
370
|
+
"subagents/readRuntimeConfig": RequestSubagentsRuntimeConfigAnswerSchema,
|
|
371
|
+
"bot/channel/reply": RequestChannelReplyAnswerSchema,
|
|
372
|
+
"topic/resource/read": RequestTopicResourceReadAnswerSchema,
|
|
373
|
+
"topic/resource/cancel": RequestTopicResourceCancelAnswerSchema,
|
|
374
|
+
"appControl/listProjects": RequestAppControlListProjectsAnswerSchema,
|
|
375
|
+
"appControl/listSessions": RequestAppControlListSessionsAnswerSchema,
|
|
376
|
+
"appControl/readSession": RequestAppControlReadSessionAnswerSchema,
|
|
377
|
+
"appControl/createSession": RequestAppControlCreateSessionAnswerSchema,
|
|
378
|
+
"appControl/forkSession": RequestAppControlForkSessionAnswerSchema,
|
|
379
|
+
"appControl/sendToSession": RequestAppControlSendToSessionAnswerSchema,
|
|
380
|
+
"appControl/waitSessions": RequestAppControlWaitSessionsAnswerSchema,
|
|
381
|
+
"appControl/interruptSession": RequestAppControlInterruptSessionAnswerSchema,
|
|
382
|
+
"appControl/renameSession": RequestAppControlRenameSessionAnswerSchema,
|
|
383
|
+
"appControl/openSession": RequestAppControlOpenSessionAnswerSchema,
|
|
384
|
+
"appControl/setSessionArchived": RequestAppControlSetSessionArchivedAnswerSchema,
|
|
385
|
+
"appControl/setSessionPinned": RequestAppControlSetSessionPinnedAnswerSchema,
|
|
386
|
+
"appControl/cancel": RequestAppControlCancelAnswerSchema,
|
|
387
|
+
} as const;
|
|
388
|
+
|
|
389
|
+
/** The types of the session event, by the discriminator the snapshot names. */
|
|
390
|
+
export const SESSION_EVENT_TYPES = ["session.created","session.resumed","session.updated","session.titleUpdated","session.closed","turn.started","turn.steerQueued","turn.steerDrained","turn.completed","turn.failed","message.upserted","message.removed","part.started","part.delta","part.upserted","part.removed","model.streaming","tool.updated","permission.requested","permission.resolved","userInput.requested","userInput.resolved","checkpoint.created","rewind.triggered","streamRecovery.updated"] as const;
|
|
391
|
+
|
|
392
|
+
/** The notifications of ZCode's v4 side channel (the conversation view of its own desktop). They have no meaning for a session driver. */
|
|
393
|
+
export const V4_NOTIFICATION_METHODS = ["v4/offPeak/lifecycle","v4/conversation/frame","v4/telemetry/event","v4/telemetry/local-ttft","v4/cua/permission-observation","v4/plugin-ui/tool-result","v4/conversation/contextCompositionChanged","v4/telemetry/model-request-metrics"] as const;
|