@enclave-vm/types 2.11.1 → 2.13.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/index.js CHANGED
@@ -28,10 +28,14 @@ __export(index_exports, {
28
28
  CallIdSchema: () => CallIdSchema,
29
29
  CancelMessageSchema: () => CancelMessageSchema,
30
30
  CancelPayloadSchema: () => CancelPayloadSchema,
31
+ CatalogChangedEventSchema: () => CatalogChangedEventSchema,
32
+ CatalogChangedPayloadSchema: () => CatalogChangedPayloadSchema,
31
33
  ClientHelloSchema: () => ClientHelloSchema,
32
34
  CreateSessionRequestSchema: () => CreateSessionRequestSchema,
33
35
  DEFAULT_ALWAYS_ALLOW: () => DEFAULT_ALWAYS_ALLOW,
34
36
  DEFAULT_SESSION_LIMITS: () => DEFAULT_SESSION_LIMITS,
37
+ DeadlineExceededEventSchema: () => DeadlineExceededEventSchema,
38
+ DeadlineExceededPayloadSchema: () => DeadlineExceededPayloadSchema,
35
39
  EncryptedEnvelopePayloadSchema: () => EncryptedEnvelopePayloadSchema,
36
40
  EncryptedEnvelopeSchema: () => EncryptedEnvelopeSchema,
37
41
  EncryptionAlgorithm: () => EncryptionAlgorithm,
@@ -41,9 +45,11 @@ __export(index_exports, {
41
45
  EncryptionMode: () => EncryptionMode,
42
46
  EncryptionModeSchema: () => EncryptionModeSchema,
43
47
  EncryptionRequestSchema: () => EncryptionRequestSchema,
48
+ ErrorDetailSchema: () => ErrorDetailSchema,
44
49
  ErrorEventPayloadSchema: () => ErrorEventPayloadSchema,
45
50
  ErrorEventSchema: () => ErrorEventSchema,
46
51
  ErrorInfoSchema: () => ErrorInfoSchema,
52
+ ErrorPayloadSchema: () => ErrorPayloadSchema,
47
53
  EventType: () => EventType,
48
54
  FilterMode: () => FilterMode,
49
55
  FinalEventSchema: () => FinalEventSchema,
@@ -59,6 +65,9 @@ __export(index_exports, {
59
65
  LogPayloadSchema: () => LogPayloadSchema,
60
66
  MAX_MESSAGES_PER_KEY: () => MAX_MESSAGES_PER_KEY,
61
67
  PROTOCOL_VERSION: () => PROTOCOL_VERSION,
68
+ PROTOCOL_VERSION_V1: () => PROTOCOL_VERSION_V1,
69
+ PartialResultEventSchema: () => PartialResultEventSchema,
70
+ PartialResultPayloadSchema: () => PartialResultPayloadSchema,
62
71
  PatternType: () => PatternType,
63
72
  ProtocolVersionSchema: () => ProtocolVersionSchema,
64
73
  REF_ID_PREFIX: () => REF_ID_PREFIX,
@@ -83,6 +92,9 @@ __export(index_exports, {
83
92
  ToolCallEventSchema: () => ToolCallEventSchema,
84
93
  ToolCallPayloadSchema: () => ToolCallPayloadSchema,
85
94
  ToolConfigSchema: () => ToolConfigSchema,
95
+ ToolProgressEventSchema: () => ToolProgressEventSchema,
96
+ ToolProgressPayloadSchema: () => ToolProgressPayloadSchema,
97
+ ToolProgressPhaseSchema: () => ToolProgressPhaseSchema,
86
98
  ToolResultAppliedEventSchema: () => ToolResultAppliedEventSchema,
87
99
  ToolResultAppliedPayloadSchema: () => ToolResultAppliedPayloadSchema,
88
100
  ToolResultSubmitMessageSchema: () => ToolResultSubmitMessageSchema,
@@ -93,17 +105,21 @@ __export(index_exports, {
93
105
  generateSessionId: () => generateSessionId,
94
106
  getEventType: () => getEventType,
95
107
  isCallId: () => isCallId,
108
+ isCatalogChangedEvent: () => isCatalogChangedEvent,
109
+ isDeadlineExceededEvent: () => isDeadlineExceededEvent,
96
110
  isEncryptedEnvelope: () => isEncryptedEnvelope,
97
111
  isErrorEvent: () => isErrorEvent,
98
112
  isFinalEvent: () => isFinalEvent,
99
113
  isHeartbeatEvent: () => isHeartbeatEvent,
100
114
  isLogEvent: () => isLogEvent,
115
+ isPartialResultEvent: () => isPartialResultEvent,
101
116
  isRefId: () => isRefId,
102
117
  isRefToken: () => isRefToken,
103
118
  isSessionId: () => isSessionId,
104
119
  isSessionInitEvent: () => isSessionInitEvent,
105
120
  isStdoutEvent: () => isStdoutEvent,
106
121
  isToolCallEvent: () => isToolCallEvent,
122
+ isToolProgressEvent: () => isToolProgressEvent,
107
123
  isToolResultAppliedEvent: () => isToolResultAppliedEvent,
108
124
  parseCreateSessionRequest: () => parseCreateSessionRequest,
109
125
  parseEncryptedEnvelope: () => parseEncryptedEnvelope,
@@ -114,7 +130,8 @@ __export(index_exports, {
114
130
  module.exports = __toCommonJS(index_exports);
115
131
 
116
132
  // libs/types/src/protocol.ts
117
- var PROTOCOL_VERSION = 1;
133
+ var PROTOCOL_VERSION = 2;
134
+ var PROTOCOL_VERSION_V1 = 1;
118
135
  var SESSION_ID_PREFIX = "s_";
119
136
  var CALL_ID_PREFIX = "c_";
120
137
  var REF_ID_PREFIX = "ref_";
@@ -142,7 +159,10 @@ var DEFAULT_SESSION_LIMITS = {
142
159
  maxStdoutBytes: 262144,
143
160
  maxToolResultBytes: 5242880,
144
161
  toolTimeoutMs: 3e4,
145
- heartbeatIntervalMs: 15e3
162
+ heartbeatIntervalMs: 15e3,
163
+ deadlineMs: 0,
164
+ perToolDeadlineMs: 3e4,
165
+ cancelOnFirstError: false
146
166
  };
147
167
  var SessionState = {
148
168
  /** Session is starting up */
@@ -190,7 +210,15 @@ var EventType = {
190
210
  /** Error event */
191
211
  Error: "error",
192
212
  /** Encrypted envelope (wraps other events) */
193
- Encrypted: "enc"
213
+ Encrypted: "enc",
214
+ /** Partial result (GraphQL-inspired, data+errors coexist) */
215
+ PartialResult: "partial_result",
216
+ /** Tool execution progress */
217
+ ToolProgress: "tool_progress",
218
+ /** Deadline exceeded for execution */
219
+ DeadlineExceeded: "deadline_exceeded",
220
+ /** Action catalog changed (for long-lived connections) */
221
+ CatalogChanged: "catalog_changed"
194
222
  };
195
223
  function getEventType(event) {
196
224
  return event.type;
@@ -219,6 +247,18 @@ function isHeartbeatEvent(event) {
219
247
  function isErrorEvent(event) {
220
248
  return event.type === EventType.Error;
221
249
  }
250
+ function isPartialResultEvent(event) {
251
+ return event.type === EventType.PartialResult;
252
+ }
253
+ function isToolProgressEvent(event) {
254
+ return event.type === EventType.ToolProgress;
255
+ }
256
+ function isDeadlineExceededEvent(event) {
257
+ return event.type === EventType.DeadlineExceeded;
258
+ }
259
+ function isCatalogChangedEvent(event) {
260
+ return event.type === EventType.CatalogChanged;
261
+ }
222
262
  var RuntimeChannelMessageType = {
223
263
  /** Tool result submission from broker to runtime */
224
264
  ToolResultSubmit: "tool_result_submit",
@@ -280,7 +320,7 @@ var MAX_MESSAGES_PER_KEY = 1073741824n;
280
320
 
281
321
  // libs/types/src/schemas.ts
282
322
  var import_zod = require("zod");
283
- var ProtocolVersionSchema = import_zod.z.literal(PROTOCOL_VERSION);
323
+ var ProtocolVersionSchema = import_zod.z.union([import_zod.z.literal(PROTOCOL_VERSION), import_zod.z.literal(1)]);
284
324
  var SessionIdSchema = import_zod.z.string().startsWith(SESSION_ID_PREFIX).min(SESSION_ID_PREFIX.length + 1);
285
325
  var CallIdSchema = import_zod.z.string().startsWith(CALL_ID_PREFIX).min(CALL_ID_PREFIX.length + 1);
286
326
  var RefIdSchema = import_zod.z.string().startsWith(REF_ID_PREFIX).min(REF_ID_PREFIX.length + 1);
@@ -309,7 +349,10 @@ var SessionLimitsSchema = import_zod.z.object({
309
349
  maxStdoutBytes: import_zod.z.number().int().positive().optional(),
310
350
  maxToolResultBytes: import_zod.z.number().int().positive().optional(),
311
351
  toolTimeoutMs: import_zod.z.number().int().positive().optional(),
312
- heartbeatIntervalMs: import_zod.z.number().int().positive().optional()
352
+ heartbeatIntervalMs: import_zod.z.number().int().positive().optional(),
353
+ deadlineMs: import_zod.z.number().int().nonnegative().optional(),
354
+ perToolDeadlineMs: import_zod.z.number().int().positive().optional(),
355
+ cancelOnFirstError: import_zod.z.boolean().optional()
313
356
  });
314
357
  var ToolConfigSchema = import_zod.z.object({
315
358
  timeout: import_zod.z.number().int().positive().optional(),
@@ -353,10 +396,23 @@ var SessionStatsSchema = import_zod.z.object({
353
396
  toolCallCount: import_zod.z.number().int().nonnegative(),
354
397
  stdoutBytes: import_zod.z.number().int().nonnegative()
355
398
  });
399
+ var ErrorDetailSchema = import_zod.z.discriminatedUnion("type", [
400
+ import_zod.z.object({ type: import_zod.z.literal("retry_info"), retryDelayMs: import_zod.z.number().nonnegative() }),
401
+ import_zod.z.object({ type: import_zod.z.literal("upstream_info"), statusCode: import_zod.z.number().int(), url: import_zod.z.string() }),
402
+ import_zod.z.object({ type: import_zod.z.literal("validation_info"), field: import_zod.z.string(), reason: import_zod.z.string() }),
403
+ import_zod.z.object({ type: import_zod.z.literal("quota_info"), limit: import_zod.z.number().nonnegative(), used: import_zod.z.number().nonnegative() })
404
+ ]);
405
+ var ErrorPayloadSchema = import_zod.z.object({
406
+ code: import_zod.z.string(),
407
+ message: import_zod.z.string(),
408
+ path: import_zod.z.array(import_zod.z.string()).optional(),
409
+ details: import_zod.z.array(ErrorDetailSchema).optional()
410
+ });
356
411
  var FinalPayloadSchema = import_zod.z.object({
357
412
  ok: import_zod.z.boolean(),
358
413
  result: import_zod.z.unknown().optional(),
359
414
  error: ErrorInfoSchema.optional(),
415
+ errors: import_zod.z.array(ErrorPayloadSchema).optional(),
360
416
  stats: SessionStatsSchema.optional()
361
417
  });
362
418
  var HeartbeatPayloadSchema = import_zod.z.object({
@@ -399,6 +455,45 @@ var ErrorEventSchema = BaseEventSchema.extend({
399
455
  type: import_zod.z.literal(EventType.Error),
400
456
  payload: ErrorEventPayloadSchema
401
457
  });
458
+ var PartialResultPayloadSchema = import_zod.z.object({
459
+ path: import_zod.z.array(import_zod.z.string()),
460
+ data: import_zod.z.unknown().optional(),
461
+ error: ErrorPayloadSchema.optional(),
462
+ hasNext: import_zod.z.boolean()
463
+ });
464
+ var PartialResultEventSchema = BaseEventSchema.extend({
465
+ type: import_zod.z.literal(EventType.PartialResult),
466
+ payload: PartialResultPayloadSchema
467
+ });
468
+ var ToolProgressPhaseSchema = import_zod.z.enum(["connecting", "sending", "receiving", "processing"]);
469
+ var ToolProgressPayloadSchema = import_zod.z.object({
470
+ callId: CallIdSchema,
471
+ phase: ToolProgressPhaseSchema,
472
+ bytesReceived: import_zod.z.number().int().nonnegative().optional(),
473
+ totalBytes: import_zod.z.number().int().nonnegative().optional(),
474
+ elapsedMs: import_zod.z.number().nonnegative()
475
+ });
476
+ var ToolProgressEventSchema = BaseEventSchema.extend({
477
+ type: import_zod.z.literal(EventType.ToolProgress),
478
+ payload: ToolProgressPayloadSchema
479
+ });
480
+ var DeadlineExceededPayloadSchema = import_zod.z.object({
481
+ elapsedMs: import_zod.z.number().nonnegative(),
482
+ budgetMs: import_zod.z.number().positive()
483
+ });
484
+ var DeadlineExceededEventSchema = BaseEventSchema.extend({
485
+ type: import_zod.z.literal(EventType.DeadlineExceeded),
486
+ payload: DeadlineExceededPayloadSchema
487
+ });
488
+ var CatalogChangedPayloadSchema = import_zod.z.object({
489
+ version: import_zod.z.string().min(1),
490
+ addedActions: import_zod.z.array(import_zod.z.string()),
491
+ removedActions: import_zod.z.array(import_zod.z.string())
492
+ });
493
+ var CatalogChangedEventSchema = BaseEventSchema.extend({
494
+ type: import_zod.z.literal(EventType.CatalogChanged),
495
+ payload: CatalogChangedPayloadSchema
496
+ });
402
497
  var StreamEventSchema = import_zod.z.discriminatedUnion("type", [
403
498
  SessionInitEventSchema,
404
499
  StdoutEventSchema,
@@ -407,7 +502,11 @@ var StreamEventSchema = import_zod.z.discriminatedUnion("type", [
407
502
  ToolResultAppliedEventSchema,
408
503
  FinalEventSchema,
409
504
  HeartbeatEventSchema,
410
- ErrorEventSchema
505
+ ErrorEventSchema,
506
+ PartialResultEventSchema,
507
+ ToolProgressEventSchema,
508
+ DeadlineExceededEventSchema,
509
+ CatalogChangedEventSchema
411
510
  ]);
412
511
  var SupportedCurveSchema = import_zod.z.enum([SupportedCurve.P256]);
413
512
  var EncryptionAlgorithmSchema = import_zod.z.enum([EncryptionAlgorithm.AES_GCM_256]);
@@ -523,10 +622,14 @@ var DEFAULT_ALWAYS_ALLOW = ["session_init", "final"];
523
622
  CallIdSchema,
524
623
  CancelMessageSchema,
525
624
  CancelPayloadSchema,
625
+ CatalogChangedEventSchema,
626
+ CatalogChangedPayloadSchema,
526
627
  ClientHelloSchema,
527
628
  CreateSessionRequestSchema,
528
629
  DEFAULT_ALWAYS_ALLOW,
529
630
  DEFAULT_SESSION_LIMITS,
631
+ DeadlineExceededEventSchema,
632
+ DeadlineExceededPayloadSchema,
530
633
  EncryptedEnvelopePayloadSchema,
531
634
  EncryptedEnvelopeSchema,
532
635
  EncryptionAlgorithm,
@@ -536,9 +639,11 @@ var DEFAULT_ALWAYS_ALLOW = ["session_init", "final"];
536
639
  EncryptionMode,
537
640
  EncryptionModeSchema,
538
641
  EncryptionRequestSchema,
642
+ ErrorDetailSchema,
539
643
  ErrorEventPayloadSchema,
540
644
  ErrorEventSchema,
541
645
  ErrorInfoSchema,
646
+ ErrorPayloadSchema,
542
647
  EventType,
543
648
  FilterMode,
544
649
  FinalEventSchema,
@@ -554,6 +659,9 @@ var DEFAULT_ALWAYS_ALLOW = ["session_init", "final"];
554
659
  LogPayloadSchema,
555
660
  MAX_MESSAGES_PER_KEY,
556
661
  PROTOCOL_VERSION,
662
+ PROTOCOL_VERSION_V1,
663
+ PartialResultEventSchema,
664
+ PartialResultPayloadSchema,
557
665
  PatternType,
558
666
  ProtocolVersionSchema,
559
667
  REF_ID_PREFIX,
@@ -578,6 +686,9 @@ var DEFAULT_ALWAYS_ALLOW = ["session_init", "final"];
578
686
  ToolCallEventSchema,
579
687
  ToolCallPayloadSchema,
580
688
  ToolConfigSchema,
689
+ ToolProgressEventSchema,
690
+ ToolProgressPayloadSchema,
691
+ ToolProgressPhaseSchema,
581
692
  ToolResultAppliedEventSchema,
582
693
  ToolResultAppliedPayloadSchema,
583
694
  ToolResultSubmitMessageSchema,
@@ -588,17 +699,21 @@ var DEFAULT_ALWAYS_ALLOW = ["session_init", "final"];
588
699
  generateSessionId,
589
700
  getEventType,
590
701
  isCallId,
702
+ isCatalogChangedEvent,
703
+ isDeadlineExceededEvent,
591
704
  isEncryptedEnvelope,
592
705
  isErrorEvent,
593
706
  isFinalEvent,
594
707
  isHeartbeatEvent,
595
708
  isLogEvent,
709
+ isPartialResultEvent,
596
710
  isRefId,
597
711
  isRefToken,
598
712
  isSessionId,
599
713
  isSessionInitEvent,
600
714
  isStdoutEvent,
601
715
  isToolCallEvent,
716
+ isToolProgressEvent,
602
717
  isToolResultAppliedEvent,
603
718
  parseCreateSessionRequest,
604
719
  parseEncryptedEnvelope,
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@enclave-vm/types",
3
- "version": "2.11.1",
3
+ "version": "2.13.0",
4
4
  "description": "Type definitions and Zod schemas for the EnclaveJS streaming runtime protocol",
5
5
  "author": "AgentFront <info@agentfront.dev>",
6
6
  "homepage": "https://github.com/agentfront/enclave",
package/protocol.d.ts CHANGED
@@ -5,13 +5,18 @@
5
5
  */
6
6
  /**
7
7
  * Current protocol version.
8
- * Increment when making breaking changes to the wire format.
8
+ * v2: Added partial_result, tool_progress, deadline_exceeded, catalog_changed events,
9
+ * ErrorPayload/ErrorDetail types, deadline/cancellation session config.
9
10
  */
10
- export declare const PROTOCOL_VERSION: 1;
11
+ export declare const PROTOCOL_VERSION: 2;
12
+ /**
13
+ * Previous protocol version for backward compatibility.
14
+ */
15
+ export declare const PROTOCOL_VERSION_V1: 1;
11
16
  /**
12
17
  * Protocol version type for type-safe versioning.
13
18
  */
14
- export type ProtocolVersion = typeof PROTOCOL_VERSION;
19
+ export type ProtocolVersion = typeof PROTOCOL_VERSION | typeof PROTOCOL_VERSION_V1;
15
20
  /**
16
21
  * Session ID prefix for identification and debugging.
17
22
  */
@@ -94,6 +99,24 @@ export interface SessionLimits {
94
99
  * @default 15000 (15 seconds)
95
100
  */
96
101
  heartbeatIntervalMs?: number;
102
+ /**
103
+ * Absolute deadline for entire execution in milliseconds.
104
+ * When exceeded, a deadline_exceeded event is emitted and execution is cancelled.
105
+ * @default undefined (no deadline)
106
+ */
107
+ deadlineMs?: number;
108
+ /**
109
+ * Default per-tool timeout in milliseconds (overridable per tool via ToolConfig).
110
+ * Inherits the remaining execution budget when deadlineMs is set.
111
+ * @default 30000 (30 seconds)
112
+ */
113
+ perToolDeadlineMs?: number;
114
+ /**
115
+ * Whether to abort remaining tool calls on first failure.
116
+ * When true, the session cancels all pending tool calls on the first error.
117
+ * @default false
118
+ */
119
+ cancelOnFirstError?: boolean;
97
120
  }
98
121
  /**
99
122
  * Default session limits.