@sokdak/happy-wire 0.1.0-main.5

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/dist/index.cjs ADDED
@@ -0,0 +1,473 @@
1
+ 'use strict';
2
+
3
+ var z = require('zod');
4
+ var cuid2 = require('@paralleldrive/cuid2');
5
+
6
+ function _interopNamespaceDefault(e) {
7
+ var n = Object.create(null);
8
+ if (e) {
9
+ Object.keys(e).forEach(function (k) {
10
+ if (k !== 'default') {
11
+ var d = Object.getOwnPropertyDescriptor(e, k);
12
+ Object.defineProperty(n, k, d.get ? d : {
13
+ enumerable: true,
14
+ get: function () { return e[k]; }
15
+ });
16
+ }
17
+ });
18
+ }
19
+ n.default = e;
20
+ return Object.freeze(n);
21
+ }
22
+
23
+ var z__namespace = /*#__PURE__*/_interopNamespaceDefault(z);
24
+
25
+ const sessionRoleSchema = z__namespace.enum(["user", "agent"]);
26
+ const sessionTextEventSchema = z__namespace.object({
27
+ t: z__namespace.literal("text"),
28
+ text: z__namespace.string(),
29
+ thinking: z__namespace.boolean().optional()
30
+ });
31
+ const sessionUsageSchema = z__namespace.object({
32
+ input_tokens: z__namespace.number().int().nonnegative(),
33
+ cache_creation_input_tokens: z__namespace.number().int().nonnegative().optional(),
34
+ cache_read_input_tokens: z__namespace.number().int().nonnegative().optional(),
35
+ output_tokens: z__namespace.number().int().nonnegative(),
36
+ context_window: z__namespace.number().int().positive().optional(),
37
+ service_tier: z__namespace.string().optional()
38
+ }).passthrough();
39
+ const sessionServiceMessageEventSchema = z__namespace.object({
40
+ t: z__namespace.literal("service"),
41
+ text: z__namespace.string()
42
+ });
43
+ const sessionToolCallStartEventSchema = z__namespace.object({
44
+ t: z__namespace.literal("tool-call-start"),
45
+ call: z__namespace.string(),
46
+ name: z__namespace.string(),
47
+ title: z__namespace.string(),
48
+ description: z__namespace.string(),
49
+ args: z__namespace.record(z__namespace.string(), z__namespace.unknown())
50
+ });
51
+ const sessionToolCallEndEventSchema = z__namespace.object({
52
+ t: z__namespace.literal("tool-call-end"),
53
+ call: z__namespace.string()
54
+ });
55
+ const sessionFileEventSchema = z__namespace.object({
56
+ t: z__namespace.literal("file"),
57
+ ref: z__namespace.string(),
58
+ name: z__namespace.string(),
59
+ size: z__namespace.number(),
60
+ mimeType: z__namespace.string().optional(),
61
+ image: z__namespace.object({
62
+ width: z__namespace.number(),
63
+ height: z__namespace.number(),
64
+ thumbhash: z__namespace.string()
65
+ }).optional()
66
+ });
67
+ const sessionTurnStartEventSchema = z__namespace.object({
68
+ t: z__namespace.literal("turn-start")
69
+ });
70
+ const sessionStartEventSchema = z__namespace.object({
71
+ t: z__namespace.literal("start"),
72
+ title: z__namespace.string().optional()
73
+ });
74
+ const sessionTurnEndStatusSchema = z__namespace.enum(["completed", "failed", "cancelled"]);
75
+ const sessionTurnEndEventSchema = z__namespace.object({
76
+ t: z__namespace.literal("turn-end"),
77
+ status: sessionTurnEndStatusSchema
78
+ });
79
+ const sessionStopEventSchema = z__namespace.object({
80
+ t: z__namespace.literal("stop")
81
+ });
82
+ const sessionEventSchema = z__namespace.discriminatedUnion("t", [
83
+ sessionTextEventSchema,
84
+ sessionServiceMessageEventSchema,
85
+ sessionToolCallStartEventSchema,
86
+ sessionToolCallEndEventSchema,
87
+ sessionFileEventSchema,
88
+ sessionTurnStartEventSchema,
89
+ sessionStartEventSchema,
90
+ sessionTurnEndEventSchema,
91
+ sessionStopEventSchema
92
+ ]);
93
+ const sessionEnvelopeSchema = z__namespace.object({
94
+ id: z__namespace.string(),
95
+ time: z__namespace.number(),
96
+ role: sessionRoleSchema,
97
+ turn: z__namespace.string().optional(),
98
+ subagent: z__namespace.string().refine((value) => cuid2.isCuid(value), {
99
+ message: "subagent must be a cuid2 value"
100
+ }).optional(),
101
+ // Underlying agent-protocol message id (e.g. Claude's `uuid` in the
102
+ // session JSONL). Set on text-bearing envelopes so the app can let
103
+ // users pick a precise rewind point for session fork / duplicate.
104
+ claudeUuid: z__namespace.string().min(1).optional(),
105
+ // Codex app-server item id for this envelope. Used as the precise
106
+ // rollback point for Codex thread duplicate/fork-from-message.
107
+ codexItemId: z__namespace.string().min(1).optional(),
108
+ // Optional model usage carried by the source agent message. Consumers use
109
+ // this to update session context meters without rendering a separate row.
110
+ usage: sessionUsageSchema.optional(),
111
+ ev: sessionEventSchema
112
+ }).superRefine((envelope, ctx) => {
113
+ if (envelope.ev.t === "service" && envelope.role !== "agent") {
114
+ ctx.addIssue({
115
+ code: z__namespace.ZodIssueCode.custom,
116
+ message: 'service events must use role "agent"',
117
+ path: ["role"]
118
+ });
119
+ }
120
+ if ((envelope.ev.t === "start" || envelope.ev.t === "stop") && envelope.role !== "agent") {
121
+ ctx.addIssue({
122
+ code: z__namespace.ZodIssueCode.custom,
123
+ message: `${envelope.ev.t} events must use role "agent"`,
124
+ path: ["role"]
125
+ });
126
+ }
127
+ });
128
+ function createEnvelope(role, ev, opts = {}) {
129
+ return sessionEnvelopeSchema.parse({
130
+ id: opts.id ?? cuid2.createId(),
131
+ time: opts.time ?? Date.now(),
132
+ role,
133
+ ...opts.turn ? { turn: opts.turn } : {},
134
+ ...opts.subagent ? { subagent: opts.subagent } : {},
135
+ ...opts.claudeUuid ? { claudeUuid: opts.claudeUuid } : {},
136
+ ...opts.codexItemId ? { codexItemId: opts.codexItemId } : {},
137
+ ...opts.usage ? { usage: opts.usage } : {},
138
+ ev
139
+ });
140
+ }
141
+
142
+ const MessageMetaSchema = z__namespace.object({
143
+ sentFrom: z__namespace.string().optional(),
144
+ // Native clients may publish their own mode codes (for example Rig's
145
+ // auto/workspace_write/read_only/full_access), so this stays open-ended.
146
+ permissionMode: z__namespace.string().optional(),
147
+ model: z__namespace.string().nullable().optional(),
148
+ modelProviderId: z__namespace.string().optional(),
149
+ fallbackModel: z__namespace.string().nullable().optional(),
150
+ customSystemPrompt: z__namespace.string().nullable().optional(),
151
+ appendSystemPrompt: z__namespace.string().nullable().optional(),
152
+ allowedTools: z__namespace.array(z__namespace.string()).nullable().optional(),
153
+ disallowedTools: z__namespace.array(z__namespace.string()).nullable().optional(),
154
+ effort: z__namespace.string().nullable().optional(),
155
+ displayText: z__namespace.string().optional()
156
+ });
157
+
158
+ const UserMessageSchema = z__namespace.object({
159
+ role: z__namespace.literal("user"),
160
+ content: z__namespace.object({
161
+ type: z__namespace.literal("text"),
162
+ text: z__namespace.string()
163
+ }),
164
+ localKey: z__namespace.string().optional(),
165
+ meta: MessageMetaSchema.optional()
166
+ });
167
+ const AgentMessageSchema = z__namespace.object({
168
+ role: z__namespace.literal("agent"),
169
+ content: z__namespace.object({
170
+ type: z__namespace.string()
171
+ }).passthrough(),
172
+ meta: MessageMetaSchema.optional()
173
+ });
174
+ const LegacyMessageContentSchema = z__namespace.discriminatedUnion("role", [UserMessageSchema, AgentMessageSchema]);
175
+
176
+ const SessionMessageContentSchema = z__namespace.object({
177
+ c: z__namespace.string(),
178
+ t: z__namespace.literal("encrypted")
179
+ });
180
+ const SessionMessageSchema = z__namespace.object({
181
+ id: z__namespace.string(),
182
+ seq: z__namespace.number(),
183
+ localId: z__namespace.string().nullish(),
184
+ content: SessionMessageContentSchema,
185
+ createdAt: z__namespace.number(),
186
+ updatedAt: z__namespace.number()
187
+ });
188
+ const SessionProtocolMessageSchema = z__namespace.object({
189
+ role: z__namespace.literal("session"),
190
+ content: sessionEnvelopeSchema,
191
+ meta: MessageMetaSchema.optional()
192
+ });
193
+ const MessageContentSchema = z__namespace.discriminatedUnion("role", [
194
+ UserMessageSchema,
195
+ AgentMessageSchema,
196
+ SessionProtocolMessageSchema
197
+ ]);
198
+ const VersionedEncryptedValueSchema = z__namespace.object({
199
+ version: z__namespace.number(),
200
+ value: z__namespace.string()
201
+ });
202
+ const VersionedNullableEncryptedValueSchema = z__namespace.object({
203
+ version: z__namespace.number(),
204
+ value: z__namespace.string().nullable()
205
+ });
206
+ const UpdateNewMessageBodySchema = z__namespace.object({
207
+ t: z__namespace.literal("new-message"),
208
+ sid: z__namespace.string(),
209
+ message: SessionMessageSchema
210
+ });
211
+ const UpdateSessionBodySchema = z__namespace.object({
212
+ t: z__namespace.literal("update-session"),
213
+ id: z__namespace.string(),
214
+ metadata: VersionedEncryptedValueSchema.nullish(),
215
+ agentState: VersionedNullableEncryptedValueSchema.nullish()
216
+ });
217
+ const VersionedMachineEncryptedValueSchema = z__namespace.object({
218
+ version: z__namespace.number(),
219
+ value: z__namespace.string()
220
+ });
221
+ const UpdateMachineBodySchema = z__namespace.object({
222
+ t: z__namespace.literal("update-machine"),
223
+ machineId: z__namespace.string(),
224
+ metadata: VersionedMachineEncryptedValueSchema.nullish(),
225
+ daemonState: VersionedMachineEncryptedValueSchema.nullish(),
226
+ active: z__namespace.boolean().optional(),
227
+ activeAt: z__namespace.number().optional()
228
+ });
229
+ const CoreUpdateBodySchema = z__namespace.discriminatedUnion("t", [
230
+ UpdateNewMessageBodySchema,
231
+ UpdateSessionBodySchema,
232
+ UpdateMachineBodySchema
233
+ ]);
234
+ const CoreUpdateContainerSchema = z__namespace.object({
235
+ id: z__namespace.string(),
236
+ seq: z__namespace.number(),
237
+ body: CoreUpdateBodySchema,
238
+ createdAt: z__namespace.number()
239
+ });
240
+ const ApiMessageSchema = SessionMessageSchema;
241
+ const ApiUpdateNewMessageSchema = UpdateNewMessageBodySchema;
242
+ const ApiUpdateSessionStateSchema = UpdateSessionBodySchema;
243
+ const ApiUpdateMachineStateSchema = UpdateMachineBodySchema;
244
+ const UpdateBodySchema = UpdateNewMessageBodySchema;
245
+ const UpdateSchema = CoreUpdateContainerSchema;
246
+
247
+ const TASK_NOTIFICATION_OPEN = "<task-notification>";
248
+ const TASK_NOTIFICATION_CLOSE = "</task-notification>";
249
+ function leadingTaskNotificationEnd(text) {
250
+ if (!text.startsWith(TASK_NOTIFICATION_OPEN)) {
251
+ return null;
252
+ }
253
+ let depth = 1;
254
+ let cursor = TASK_NOTIFICATION_OPEN.length;
255
+ while (depth > 0) {
256
+ const nextOpen = text.indexOf(TASK_NOTIFICATION_OPEN, cursor);
257
+ const nextClose = text.indexOf(TASK_NOTIFICATION_CLOSE, cursor);
258
+ if (nextClose === -1) {
259
+ return null;
260
+ }
261
+ if (nextOpen !== -1 && nextOpen < nextClose) {
262
+ depth += 1;
263
+ cursor = nextOpen + TASK_NOTIFICATION_OPEN.length;
264
+ continue;
265
+ }
266
+ depth -= 1;
267
+ cursor = nextClose + TASK_NOTIFICATION_CLOSE.length;
268
+ }
269
+ return cursor;
270
+ }
271
+ function stripLeadingTaskNotificationWrappers(text) {
272
+ let remainder = text.trimStart();
273
+ let stripped = false;
274
+ while (remainder.startsWith(TASK_NOTIFICATION_OPEN)) {
275
+ const wrapperEnd = leadingTaskNotificationEnd(remainder);
276
+ if (wrapperEnd === null) {
277
+ break;
278
+ }
279
+ stripped = true;
280
+ remainder = remainder.slice(wrapperEnd).trimStart();
281
+ }
282
+ return stripped ? remainder : text;
283
+ }
284
+
285
+ const VoiceConversationGrantedSchema = z__namespace.object({
286
+ allowed: z__namespace.literal(true),
287
+ conversationToken: z__namespace.string(),
288
+ conversationId: z__namespace.string(),
289
+ agentId: z__namespace.string(),
290
+ elevenUserId: z__namespace.string(),
291
+ usedSeconds: z__namespace.number(),
292
+ limitSeconds: z__namespace.number()
293
+ });
294
+ const VoiceConversationDeniedSchema = z__namespace.object({
295
+ allowed: z__namespace.literal(false),
296
+ reason: z__namespace.enum(["voice_hard_limit_reached", "subscription_required", "voice_conversation_limit_reached"]),
297
+ usedSeconds: z__namespace.number(),
298
+ limitSeconds: z__namespace.number(),
299
+ agentId: z__namespace.string()
300
+ });
301
+ const VoiceConversationResponseSchema = z__namespace.discriminatedUnion("allowed", [
302
+ VoiceConversationGrantedSchema,
303
+ VoiceConversationDeniedSchema
304
+ ]);
305
+ const VoiceUsageResponseSchema = z__namespace.object({
306
+ usedSeconds: z__namespace.number(),
307
+ limitSeconds: z__namespace.number(),
308
+ conversationCount: z__namespace.number(),
309
+ conversationLimit: z__namespace.number(),
310
+ elevenUserId: z__namespace.string()
311
+ });
312
+
313
+ const RigProviderSchema = z__namespace.object({
314
+ id: z__namespace.string(),
315
+ kind: z__namespace.string(),
316
+ name: z__namespace.string()
317
+ }).passthrough();
318
+ const RigModelSchema = z__namespace.object({
319
+ id: z__namespace.string(),
320
+ code: z__namespace.string(),
321
+ name: z__namespace.string(),
322
+ value: z__namespace.string(),
323
+ providerId: z__namespace.string(),
324
+ providerKind: z__namespace.string(),
325
+ providerName: z__namespace.string(),
326
+ provider: RigProviderSchema,
327
+ contextWindow: z__namespace.number().optional(),
328
+ serviceTiers: z__namespace.array(z__namespace.string()),
329
+ thinkingLevels: z__namespace.array(z__namespace.string()),
330
+ defaultThinkingLevel: z__namespace.string()
331
+ }).passthrough();
332
+ const RigOperatingModeKindSchema = z__namespace.string();
333
+ const RigOperatingModeSchema = z__namespace.object({
334
+ code: z__namespace.string(),
335
+ value: z__namespace.string(),
336
+ description: z__namespace.string(),
337
+ kind: RigOperatingModeKindSchema
338
+ }).passthrough();
339
+ const RigCapabilitiesSchema = z__namespace.object({
340
+ abort: z__namespace.boolean(),
341
+ attachments: z__namespace.object({
342
+ enabled: z__namespace.boolean(),
343
+ maxBytes: z__namespace.number(),
344
+ mediaTypes: z__namespace.array(z__namespace.string())
345
+ }).passthrough(),
346
+ files: z__namespace.object({
347
+ browse: z__namespace.boolean(),
348
+ read: z__namespace.boolean(),
349
+ search: z__namespace.boolean(),
350
+ write: z__namespace.boolean()
351
+ }).passthrough(),
352
+ modelSelection: z__namespace.boolean(),
353
+ reasoningSelection: z__namespace.boolean(),
354
+ permissionModeSelection: z__namespace.boolean(),
355
+ resume: z__namespace.boolean(),
356
+ rpcMethods: z__namespace.array(z__namespace.string()),
357
+ shell: z__namespace.boolean(),
358
+ steering: z__namespace.boolean()
359
+ }).passthrough();
360
+ const RigActivitySchema = z__namespace.object({
361
+ subagents: z__namespace.object({
362
+ running: z__namespace.number(),
363
+ queued: z__namespace.number(),
364
+ total: z__namespace.number()
365
+ }).passthrough(),
366
+ workflows: z__namespace.object({
367
+ running: z__namespace.number(),
368
+ total: z__namespace.number()
369
+ }).passthrough(),
370
+ processes: z__namespace.object({
371
+ running: z__namespace.number()
372
+ }).passthrough(),
373
+ tasks: z__namespace.object({
374
+ pending: z__namespace.number(),
375
+ inProgress: z__namespace.number(),
376
+ completed: z__namespace.number(),
377
+ total: z__namespace.number()
378
+ }).passthrough()
379
+ }).passthrough();
380
+ const RigMetadataV1Schema = z__namespace.object({
381
+ // Parse later additive revisions with the v1-compatible fields we know.
382
+ rigMetadataVersion: z__namespace.number().int().min(1),
383
+ client: z__namespace.object({
384
+ id: z__namespace.literal("rig"),
385
+ name: z__namespace.string(),
386
+ version: z__namespace.string()
387
+ }).passthrough(),
388
+ provider: RigProviderSchema,
389
+ providers: z__namespace.array(RigProviderSchema),
390
+ model: z__namespace.object({
391
+ providerId: z__namespace.string(),
392
+ id: z__namespace.string()
393
+ }).passthrough(),
394
+ models: z__namespace.array(RigModelSchema),
395
+ currentModelProviderId: z__namespace.string(),
396
+ currentModelCode: z__namespace.string(),
397
+ permissionMode: z__namespace.string(),
398
+ currentOperatingModeCode: z__namespace.string(),
399
+ operatingModes: z__namespace.array(RigOperatingModeSchema),
400
+ reasoning: z__namespace.object({
401
+ current: z__namespace.string().nullable(),
402
+ levels: z__namespace.array(z__namespace.string())
403
+ }).passthrough(),
404
+ currentThoughtLevelCode: z__namespace.string().optional(),
405
+ thoughtLevels: z__namespace.array(z__namespace.object({
406
+ code: z__namespace.string(),
407
+ value: z__namespace.string()
408
+ }).passthrough()),
409
+ session: z__namespace.object({
410
+ status: z__namespace.string(),
411
+ permissionMode: z__namespace.string(),
412
+ modelLocked: z__namespace.boolean(),
413
+ serviceTier: z__namespace.string().optional()
414
+ }).passthrough(),
415
+ capabilities: RigCapabilitiesSchema,
416
+ activity: RigActivitySchema,
417
+ mcpServers: z__namespace.array(z__namespace.object({
418
+ name: z__namespace.string(),
419
+ status: z__namespace.string()
420
+ }).passthrough()),
421
+ tools: z__namespace.array(z__namespace.string()),
422
+ skills: z__namespace.array(z__namespace.string())
423
+ }).passthrough();
424
+
425
+ exports.AgentMessageSchema = AgentMessageSchema;
426
+ exports.ApiMessageSchema = ApiMessageSchema;
427
+ exports.ApiUpdateMachineStateSchema = ApiUpdateMachineStateSchema;
428
+ exports.ApiUpdateNewMessageSchema = ApiUpdateNewMessageSchema;
429
+ exports.ApiUpdateSessionStateSchema = ApiUpdateSessionStateSchema;
430
+ exports.CoreUpdateBodySchema = CoreUpdateBodySchema;
431
+ exports.CoreUpdateContainerSchema = CoreUpdateContainerSchema;
432
+ exports.LegacyMessageContentSchema = LegacyMessageContentSchema;
433
+ exports.MessageContentSchema = MessageContentSchema;
434
+ exports.MessageMetaSchema = MessageMetaSchema;
435
+ exports.RigActivitySchema = RigActivitySchema;
436
+ exports.RigCapabilitiesSchema = RigCapabilitiesSchema;
437
+ exports.RigMetadataV1Schema = RigMetadataV1Schema;
438
+ exports.RigModelSchema = RigModelSchema;
439
+ exports.RigOperatingModeKindSchema = RigOperatingModeKindSchema;
440
+ exports.RigOperatingModeSchema = RigOperatingModeSchema;
441
+ exports.RigProviderSchema = RigProviderSchema;
442
+ exports.SessionMessageContentSchema = SessionMessageContentSchema;
443
+ exports.SessionMessageSchema = SessionMessageSchema;
444
+ exports.SessionProtocolMessageSchema = SessionProtocolMessageSchema;
445
+ exports.UpdateBodySchema = UpdateBodySchema;
446
+ exports.UpdateMachineBodySchema = UpdateMachineBodySchema;
447
+ exports.UpdateNewMessageBodySchema = UpdateNewMessageBodySchema;
448
+ exports.UpdateSchema = UpdateSchema;
449
+ exports.UpdateSessionBodySchema = UpdateSessionBodySchema;
450
+ exports.UserMessageSchema = UserMessageSchema;
451
+ exports.VersionedEncryptedValueSchema = VersionedEncryptedValueSchema;
452
+ exports.VersionedMachineEncryptedValueSchema = VersionedMachineEncryptedValueSchema;
453
+ exports.VersionedNullableEncryptedValueSchema = VersionedNullableEncryptedValueSchema;
454
+ exports.VoiceConversationDeniedSchema = VoiceConversationDeniedSchema;
455
+ exports.VoiceConversationGrantedSchema = VoiceConversationGrantedSchema;
456
+ exports.VoiceConversationResponseSchema = VoiceConversationResponseSchema;
457
+ exports.VoiceUsageResponseSchema = VoiceUsageResponseSchema;
458
+ exports.createEnvelope = createEnvelope;
459
+ exports.sessionEnvelopeSchema = sessionEnvelopeSchema;
460
+ exports.sessionEventSchema = sessionEventSchema;
461
+ exports.sessionFileEventSchema = sessionFileEventSchema;
462
+ exports.sessionRoleSchema = sessionRoleSchema;
463
+ exports.sessionServiceMessageEventSchema = sessionServiceMessageEventSchema;
464
+ exports.sessionStartEventSchema = sessionStartEventSchema;
465
+ exports.sessionStopEventSchema = sessionStopEventSchema;
466
+ exports.sessionTextEventSchema = sessionTextEventSchema;
467
+ exports.sessionToolCallEndEventSchema = sessionToolCallEndEventSchema;
468
+ exports.sessionToolCallStartEventSchema = sessionToolCallStartEventSchema;
469
+ exports.sessionTurnEndEventSchema = sessionTurnEndEventSchema;
470
+ exports.sessionTurnEndStatusSchema = sessionTurnEndStatusSchema;
471
+ exports.sessionTurnStartEventSchema = sessionTurnStartEventSchema;
472
+ exports.sessionUsageSchema = sessionUsageSchema;
473
+ exports.stripLeadingTaskNotificationWrappers = stripLeadingTaskNotificationWrappers;