@enclave-vm/client 0.0.1

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/package.json ADDED
@@ -0,0 +1,38 @@
1
+ {
2
+ "name": "@enclave-vm/client",
3
+ "version": "0.0.1",
4
+ "description": "Browser and Node.js client SDK for the EnclaveJS streaming runtime",
5
+ "author": "AgentFront <info@agentfront.dev>",
6
+ "homepage": "https://github.com/agentfront/enclave",
7
+ "license": "Apache-2.0",
8
+ "keywords": [
9
+ "enclavejs",
10
+ "enclave",
11
+ "client",
12
+ "sdk",
13
+ "streaming",
14
+ "runtime"
15
+ ],
16
+ "repository": {
17
+ "type": "git",
18
+ "url": "git+https://github.com/agentfront/enclave.git"
19
+ },
20
+ "bugs": {
21
+ "url": "https://github.com/agentfront/enclave/issues"
22
+ },
23
+ "main": "./src/index.js",
24
+ "types": "./src/index.d.ts",
25
+ "exports": {
26
+ "./package.json": "./package.json",
27
+ ".": {
28
+ "types": "./src/index.d.ts",
29
+ "import": "./src/index.js",
30
+ "default": "./src/index.js"
31
+ }
32
+ },
33
+ "dependencies": {
34
+ "@enclave-vm/types": "0.0.1",
35
+ "@enclave-vm/stream": "0.0.1"
36
+ },
37
+ "type": "commonjs"
38
+ }
@@ -0,0 +1,97 @@
1
+ /**
2
+ * EnclaveClient
3
+ *
4
+ * Browser and Node.js client SDK for connecting to the EnclaveJS streaming runtime.
5
+ *
6
+ * @packageDocumentation
7
+ */
8
+ import type { SessionId } from '@enclave-vm/types';
9
+ import type { EnclaveClientConfig, ExecuteOptions, SessionEventHandlers, SessionResult, SessionHandle, SessionInfo } from './types.js';
10
+ /**
11
+ * EnclaveClient provides a high-level API for executing code in the EnclaveJS runtime.
12
+ *
13
+ * @example
14
+ * ```ts
15
+ * const client = new EnclaveClient({
16
+ * baseUrl: 'https://api.example.com',
17
+ * });
18
+ *
19
+ * const result = await client.execute('return 1 + 1');
20
+ * console.log(result.value); // 2
21
+ * ```
22
+ */
23
+ export declare class EnclaveClient {
24
+ private readonly config;
25
+ private readonly activeSessions;
26
+ /**
27
+ * Create a new EnclaveClient instance.
28
+ */
29
+ constructor(config: EnclaveClientConfig);
30
+ /**
31
+ * Execute code and return the result.
32
+ *
33
+ * @example
34
+ * ```ts
35
+ * const result = await client.execute('return 1 + 1');
36
+ * if (result.success) {
37
+ * console.log(result.value);
38
+ * }
39
+ * ```
40
+ */
41
+ execute(code: string, options?: ExecuteOptions & SessionEventHandlers): Promise<SessionResult>;
42
+ /**
43
+ * Execute code and return a session handle for streaming.
44
+ *
45
+ * @example
46
+ * ```ts
47
+ * const session = client.executeStream('return 1 + 1', {
48
+ * onStdout: (chunk) => console.log(chunk),
49
+ * onToolCall: (callId, name, args) => console.log('Tool:', name),
50
+ * });
51
+ *
52
+ * const result = await session.wait();
53
+ * ```
54
+ */
55
+ executeStream(code: string, options?: ExecuteOptions & SessionEventHandlers): SessionHandle;
56
+ /**
57
+ * Get information about a session.
58
+ */
59
+ getSession(sessionId: SessionId): Promise<SessionInfo | null>;
60
+ /**
61
+ * Cancel a running session.
62
+ */
63
+ cancelSession(sessionId: SessionId, reason?: string): Promise<void>;
64
+ /**
65
+ * Start a session and begin streaming events.
66
+ */
67
+ private startSession;
68
+ /**
69
+ * Stream and parse the NDJSON response.
70
+ */
71
+ private streamResponse;
72
+ /**
73
+ * Handle a received stream event.
74
+ */
75
+ private handleEvent;
76
+ /**
77
+ * Handle the final event and complete the session.
78
+ */
79
+ private handleFinalEvent;
80
+ /**
81
+ * Handle a session error.
82
+ */
83
+ private handleSessionError;
84
+ /**
85
+ * Complete a session and clean up.
86
+ */
87
+ private completeSession;
88
+ /**
89
+ * Attempt to reconnect a session.
90
+ */
91
+ private reconnectSession;
92
+ /**
93
+ * Build request headers.
94
+ */
95
+ private buildHeaders;
96
+ }
97
+ //# sourceMappingURL=client.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/client.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,SAAS,EAA0C,MAAM,mBAAmB,CAAC;AAc3F,OAAO,KAAK,EACV,mBAAmB,EACnB,cAAc,EACd,oBAAoB,EACpB,aAAa,EACb,aAAa,EACb,WAAW,EACZ,MAAM,YAAY,CAAC;AAgCpB;;;;;;;;;;;;GAYG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAErB;IACF,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAuC;IAEtE;;OAEG;gBACS,MAAM,EAAE,mBAAmB;IAevC;;;;;;;;;;OAUG;IACG,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE,cAAc,GAAG,oBAAyB,GAAG,OAAO,CAAC,aAAa,CAAC;IAKxG;;;;;;;;;;;;OAYG;IACH,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE,cAAc,GAAG,oBAAyB,GAAG,aAAa;IAqF/F;;OAEG;IACG,UAAU,CAAC,SAAS,EAAE,SAAS,GAAG,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC;IA4BnE;;OAEG;IACG,aAAa,CAAC,SAAS,EAAE,SAAS,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAwCzE;;OAEG;YACW,YAAY;IAwD1B;;OAEG;YACW,cAAc;IA2B5B;;OAEG;IACH,OAAO,CAAC,WAAW;IAmCnB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IA2BxB;;OAEG;IACH,OAAO,CAAC,kBAAkB;IA6B1B;;OAEG;IACH,OAAO,CAAC,eAAe;IAQvB;;OAEG;YACW,gBAAgB;IA0C9B;;OAEG;IACH,OAAO,CAAC,YAAY;CAKrB"}
package/src/client.js ADDED
@@ -0,0 +1,452 @@
1
+ "use strict";
2
+ /**
3
+ * EnclaveClient
4
+ *
5
+ * Browser and Node.js client SDK for connecting to the EnclaveJS streaming runtime.
6
+ *
7
+ * @packageDocumentation
8
+ */
9
+ Object.defineProperty(exports, "__esModule", { value: true });
10
+ exports.EnclaveClient = void 0;
11
+ const types_1 = require("@enclave-vm/types");
12
+ const stream_1 = require("@enclave-vm/stream");
13
+ const types_js_1 = require("./types.js");
14
+ /**
15
+ * Default configuration values.
16
+ */
17
+ const DEFAULT_CONFIG = {
18
+ timeout: 60000,
19
+ autoReconnect: true,
20
+ maxReconnectAttempts: 3,
21
+ reconnectDelay: 1000,
22
+ heartbeatTimeoutMs: 30000,
23
+ };
24
+ /**
25
+ * EnclaveClient provides a high-level API for executing code in the EnclaveJS runtime.
26
+ *
27
+ * @example
28
+ * ```ts
29
+ * const client = new EnclaveClient({
30
+ * baseUrl: 'https://api.example.com',
31
+ * });
32
+ *
33
+ * const result = await client.execute('return 1 + 1');
34
+ * console.log(result.value); // 2
35
+ * ```
36
+ */
37
+ class EnclaveClient {
38
+ config;
39
+ activeSessions = new Map();
40
+ /**
41
+ * Create a new EnclaveClient instance.
42
+ */
43
+ constructor(config) {
44
+ // Normalize baseUrl (remove trailing slash)
45
+ const baseUrl = config.baseUrl.replace(/\/$/, '');
46
+ this.config = {
47
+ baseUrl,
48
+ headers: config.headers,
49
+ timeout: config.timeout ?? DEFAULT_CONFIG.timeout,
50
+ autoReconnect: config.autoReconnect ?? DEFAULT_CONFIG.autoReconnect,
51
+ maxReconnectAttempts: config.maxReconnectAttempts ?? DEFAULT_CONFIG.maxReconnectAttempts,
52
+ reconnectDelay: config.reconnectDelay ?? DEFAULT_CONFIG.reconnectDelay,
53
+ fetch: config.fetch ?? globalThis.fetch.bind(globalThis),
54
+ };
55
+ }
56
+ /**
57
+ * Execute code and return the result.
58
+ *
59
+ * @example
60
+ * ```ts
61
+ * const result = await client.execute('return 1 + 1');
62
+ * if (result.success) {
63
+ * console.log(result.value);
64
+ * }
65
+ * ```
66
+ */
67
+ async execute(code, options = {}) {
68
+ const handle = this.executeStream(code, options);
69
+ return handle.wait();
70
+ }
71
+ /**
72
+ * Execute code and return a session handle for streaming.
73
+ *
74
+ * @example
75
+ * ```ts
76
+ * const session = client.executeStream('return 1 + 1', {
77
+ * onStdout: (chunk) => console.log(chunk),
78
+ * onToolCall: (callId, name, args) => console.log('Tool:', name),
79
+ * });
80
+ *
81
+ * const result = await session.wait();
82
+ * ```
83
+ */
84
+ executeStream(code, options = {}) {
85
+ const sessionId = options.sessionId ?? (0, types_1.generateSessionId)();
86
+ const abortController = new AbortController();
87
+ // Combine external signal with internal abort controller
88
+ if (options.signal) {
89
+ options.signal.addEventListener('abort', () => {
90
+ abortController.abort(options.signal?.reason);
91
+ });
92
+ }
93
+ // Create promise for result
94
+ let resolveResult;
95
+ let rejectResult;
96
+ const resultPromise = new Promise((resolve, reject) => {
97
+ resolveResult = resolve;
98
+ rejectResult = reject;
99
+ });
100
+ // Create reconnection state machine
101
+ const reconnectState = new stream_1.ReconnectionStateMachine({
102
+ config: {
103
+ maxRetries: this.config.maxReconnectAttempts,
104
+ initialDelayMs: this.config.reconnectDelay,
105
+ },
106
+ onEvent: (event) => {
107
+ if (event.type === 'retry_started') {
108
+ // Attempt reconnection
109
+ this.reconnectSession(sessionId);
110
+ }
111
+ },
112
+ });
113
+ // Create heartbeat monitor
114
+ const heartbeatMonitor = new stream_1.HeartbeatMonitor({
115
+ timeoutMs: DEFAULT_CONFIG.heartbeatTimeoutMs,
116
+ onTimeout: () => {
117
+ // Handle heartbeat timeout - trigger reconnection if enabled
118
+ if (this.config.autoReconnect) {
119
+ const session = this.activeSessions.get(sessionId);
120
+ if (session) {
121
+ reconnectState.onDisconnected('Heartbeat timeout');
122
+ }
123
+ }
124
+ },
125
+ });
126
+ // Store session state
127
+ const session = {
128
+ sessionId,
129
+ events: [],
130
+ abortController,
131
+ resolve: resolveResult,
132
+ reject: rejectResult,
133
+ handlers: options,
134
+ startTime: Date.now(),
135
+ toolCallCount: 0,
136
+ stdoutBytes: 0,
137
+ reconnectState,
138
+ heartbeatMonitor,
139
+ lastSequence: 0,
140
+ };
141
+ this.activeSessions.set(sessionId, session);
142
+ // Start the session
143
+ this.startSession(session, code, options.limits).catch((error) => {
144
+ this.handleSessionError(sessionId, error);
145
+ });
146
+ // Capture reference to events array for getEvents() after completion
147
+ const eventsRef = session.events;
148
+ // Return handle
149
+ return {
150
+ sessionId,
151
+ wait: () => resultPromise,
152
+ cancel: async (reason) => {
153
+ await this.cancelSession(sessionId, reason);
154
+ },
155
+ getEvents: () => [...eventsRef],
156
+ isActive: () => this.activeSessions.has(sessionId),
157
+ };
158
+ }
159
+ /**
160
+ * Get information about a session.
161
+ */
162
+ async getSession(sessionId) {
163
+ const url = `${this.config.baseUrl}/sessions/${sessionId}`;
164
+ try {
165
+ const response = await this.config.fetch(url, {
166
+ method: 'GET',
167
+ headers: this.buildHeaders(),
168
+ });
169
+ if (response.status === 404) {
170
+ return null;
171
+ }
172
+ if (!response.ok) {
173
+ throw new types_js_1.EnclaveClientError('SESSION_ERROR', `Failed to get session: ${response.status}`);
174
+ }
175
+ return (await response.json());
176
+ }
177
+ catch (error) {
178
+ if (error instanceof types_js_1.EnclaveClientError)
179
+ throw error;
180
+ throw new types_js_1.EnclaveClientError('NETWORK_ERROR', 'Failed to get session', error instanceof Error ? error : undefined);
181
+ }
182
+ }
183
+ /**
184
+ * Cancel a running session.
185
+ */
186
+ async cancelSession(sessionId, reason) {
187
+ const session = this.activeSessions.get(sessionId);
188
+ if (!session) {
189
+ return;
190
+ }
191
+ // Stop heartbeat monitoring
192
+ session.heartbeatMonitor.stop();
193
+ session.reconnectState.close();
194
+ // Abort the request
195
+ session.abortController.abort(reason);
196
+ // Send cancel request to server
197
+ const url = `${this.config.baseUrl}/sessions/${sessionId}/cancel`;
198
+ try {
199
+ await this.config.fetch(url, {
200
+ method: 'POST',
201
+ headers: this.buildHeaders(),
202
+ body: JSON.stringify({ reason }),
203
+ });
204
+ }
205
+ catch {
206
+ // Ignore errors - session may already be cancelled
207
+ }
208
+ // Complete the session
209
+ this.completeSession(sessionId, {
210
+ success: false,
211
+ sessionId,
212
+ error: { code: 'CANCELLED', message: reason ?? 'Session cancelled' },
213
+ events: session.events,
214
+ stats: {
215
+ durationMs: Date.now() - session.startTime,
216
+ toolCallCount: session.toolCallCount,
217
+ stdoutBytes: session.stdoutBytes,
218
+ },
219
+ });
220
+ }
221
+ /**
222
+ * Start a session and begin streaming events.
223
+ */
224
+ async startSession(session, code, limits) {
225
+ const url = `${this.config.baseUrl}/sessions`;
226
+ // Build request body
227
+ const body = {
228
+ sessionId: session.sessionId,
229
+ code,
230
+ };
231
+ if (limits) {
232
+ body.config = {
233
+ maxExecutionMs: limits.sessionTtlMs,
234
+ maxToolCalls: limits.maxToolCalls,
235
+ heartbeatIntervalMs: limits.heartbeatIntervalMs,
236
+ };
237
+ }
238
+ try {
239
+ const response = await this.config.fetch(url, {
240
+ method: 'POST',
241
+ headers: {
242
+ ...this.buildHeaders(),
243
+ 'Content-Type': 'application/json',
244
+ Accept: 'application/x-ndjson',
245
+ },
246
+ body: JSON.stringify(body),
247
+ signal: session.abortController.signal,
248
+ });
249
+ if (!response.ok) {
250
+ const errorText = await response.text();
251
+ throw new types_js_1.EnclaveClientError('SESSION_ERROR', `Failed to start session: ${response.status} - ${errorText}`);
252
+ }
253
+ // Mark as connected
254
+ session.reconnectState.onConnected();
255
+ session.heartbeatMonitor.start();
256
+ // Stream the response
257
+ await this.streamResponse(session, response);
258
+ }
259
+ catch (error) {
260
+ if (error instanceof Error && error.name === 'AbortError') {
261
+ // Session was cancelled
262
+ return;
263
+ }
264
+ // Handle connection error
265
+ if (this.config.autoReconnect && session.reconnectState.canReconnect()) {
266
+ session.reconnectState.onDisconnected(error instanceof Error ? error.message : 'Connection lost');
267
+ return;
268
+ }
269
+ throw error;
270
+ }
271
+ }
272
+ /**
273
+ * Stream and parse the NDJSON response.
274
+ */
275
+ async streamResponse(session, response) {
276
+ const body = response.body;
277
+ if (!body) {
278
+ throw new types_js_1.EnclaveClientError('PARSE_ERROR', 'No response body');
279
+ }
280
+ try {
281
+ // Use the async generator to parse NDJSON stream
282
+ for await (const event of (0, stream_1.parseNdjsonStream)(body)) {
283
+ // The generator yields validated events
284
+ this.handleEvent(session, event);
285
+ }
286
+ }
287
+ catch (error) {
288
+ if (error instanceof Error && error.name === 'AbortError') {
289
+ return;
290
+ }
291
+ // Handle stream error
292
+ if (this.config.autoReconnect && session.reconnectState.canReconnect()) {
293
+ session.reconnectState.onDisconnected(error instanceof Error ? error.message : 'Stream error');
294
+ return;
295
+ }
296
+ throw error;
297
+ }
298
+ }
299
+ /**
300
+ * Handle a received stream event.
301
+ */
302
+ handleEvent(session, event) {
303
+ // Track sequence
304
+ if (event.seq !== undefined) {
305
+ session.lastSequence = event.seq;
306
+ }
307
+ // Store event
308
+ session.events.push(event);
309
+ // Call general event handler
310
+ session.handlers.onEvent?.(event);
311
+ // Route to specific handlers
312
+ if ((0, types_1.isSessionInitEvent)(event)) {
313
+ session.handlers.onSessionInit?.(event);
314
+ }
315
+ else if ((0, types_1.isStdoutEvent)(event)) {
316
+ session.stdoutBytes += event.payload.chunk.length;
317
+ session.handlers.onStdout?.(event.payload.chunk);
318
+ }
319
+ else if ((0, types_1.isLogEvent)(event)) {
320
+ session.handlers.onLog?.(event.payload.level, event.payload.message, event.payload.data);
321
+ }
322
+ else if ((0, types_1.isToolCallEvent)(event)) {
323
+ session.toolCallCount++;
324
+ session.handlers.onToolCall?.(event.payload.callId, event.payload.toolName, event.payload.args);
325
+ }
326
+ else if ((0, types_1.isToolResultAppliedEvent)(event)) {
327
+ session.handlers.onToolResultApplied?.(event.payload.callId);
328
+ }
329
+ else if ((0, types_1.isHeartbeatEvent)(event)) {
330
+ session.heartbeatMonitor.onHeartbeat();
331
+ session.handlers.onHeartbeat?.();
332
+ }
333
+ else if ((0, types_1.isErrorEvent)(event)) {
334
+ session.handlers.onError?.(event.payload.code ?? 'UNKNOWN', event.payload.message);
335
+ }
336
+ else if ((0, types_1.isFinalEvent)(event)) {
337
+ this.handleFinalEvent(session, event);
338
+ }
339
+ }
340
+ /**
341
+ * Handle the final event and complete the session.
342
+ */
343
+ handleFinalEvent(session, event) {
344
+ session.heartbeatMonitor.stop();
345
+ session.reconnectState.close();
346
+ const result = {
347
+ success: event.payload.ok,
348
+ sessionId: session.sessionId,
349
+ events: session.events,
350
+ stats: {
351
+ durationMs: Date.now() - session.startTime,
352
+ toolCallCount: session.toolCallCount,
353
+ stdoutBytes: session.stdoutBytes,
354
+ },
355
+ };
356
+ if (event.payload.ok) {
357
+ result.value = event.payload.result;
358
+ }
359
+ else {
360
+ result.error = {
361
+ code: event.payload.error?.code,
362
+ message: event.payload.error?.message ?? 'Unknown error',
363
+ };
364
+ }
365
+ this.completeSession(session.sessionId, result);
366
+ }
367
+ /**
368
+ * Handle a session error.
369
+ */
370
+ handleSessionError(sessionId, error) {
371
+ const session = this.activeSessions.get(sessionId);
372
+ if (!session)
373
+ return;
374
+ session.heartbeatMonitor.stop();
375
+ session.reconnectState.close();
376
+ const clientError = error instanceof types_js_1.EnclaveClientError
377
+ ? error
378
+ : new types_js_1.EnclaveClientError('NETWORK_ERROR', error instanceof Error ? error.message : 'Unknown error', error instanceof Error ? error : undefined);
379
+ this.completeSession(sessionId, {
380
+ success: false,
381
+ sessionId,
382
+ error: { code: clientError.code, message: clientError.message },
383
+ events: session.events,
384
+ stats: {
385
+ durationMs: Date.now() - session.startTime,
386
+ toolCallCount: session.toolCallCount,
387
+ stdoutBytes: session.stdoutBytes,
388
+ },
389
+ });
390
+ }
391
+ /**
392
+ * Complete a session and clean up.
393
+ */
394
+ completeSession(sessionId, result) {
395
+ const session = this.activeSessions.get(sessionId);
396
+ if (!session)
397
+ return;
398
+ this.activeSessions.delete(sessionId);
399
+ session.resolve(result);
400
+ }
401
+ /**
402
+ * Attempt to reconnect a session.
403
+ */
404
+ async reconnectSession(sessionId) {
405
+ const session = this.activeSessions.get(sessionId);
406
+ if (!session)
407
+ return;
408
+ // Request replay from last known sequence
409
+ const url = `${this.config.baseUrl}/sessions/${sessionId}/stream`;
410
+ const params = new URLSearchParams();
411
+ if (session.lastSequence > 0) {
412
+ params.set('from', String(session.lastSequence + 1));
413
+ }
414
+ try {
415
+ const response = await this.config.fetch(`${url}?${params}`, {
416
+ method: 'GET',
417
+ headers: {
418
+ ...this.buildHeaders(),
419
+ Accept: 'application/x-ndjson',
420
+ },
421
+ signal: session.abortController.signal,
422
+ });
423
+ if (!response.ok) {
424
+ throw new types_js_1.EnclaveClientError('RECONNECT_FAILED', `Reconnection failed: ${response.status}`);
425
+ }
426
+ session.reconnectState.onConnected();
427
+ session.heartbeatMonitor.start();
428
+ await this.streamResponse(session, response);
429
+ }
430
+ catch (error) {
431
+ if (error instanceof Error && error.name === 'AbortError') {
432
+ return;
433
+ }
434
+ if (session.reconnectState.canReconnect()) {
435
+ session.reconnectState.onDisconnected(error instanceof Error ? error.message : 'Reconnection failed');
436
+ }
437
+ else {
438
+ this.handleSessionError(sessionId, error);
439
+ }
440
+ }
441
+ }
442
+ /**
443
+ * Build request headers.
444
+ */
445
+ buildHeaders() {
446
+ return {
447
+ ...this.config.headers,
448
+ };
449
+ }
450
+ }
451
+ exports.EnclaveClient = EnclaveClient;
452
+ //# sourceMappingURL=client.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"client.js","sourceRoot":"","sources":["../../src/client.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * EnclaveClient\n *\n * Browser and Node.js client SDK for connecting to the EnclaveJS streaming runtime.\n *\n * @packageDocumentation\n */\n\nimport type { SessionId, SessionLimits, StreamEvent, FinalEvent } from '@enclave-vm/types';\nimport {\n generateSessionId,\n isFinalEvent,\n isSessionInitEvent,\n isStdoutEvent,\n isLogEvent,\n isToolCallEvent,\n isToolResultAppliedEvent,\n isHeartbeatEvent,\n isErrorEvent,\n} from '@enclave-vm/types';\nimport { parseNdjsonStream, ReconnectionStateMachine, HeartbeatMonitor } from '@enclave-vm/stream';\n\nimport type {\n EnclaveClientConfig,\n ExecuteOptions,\n SessionEventHandlers,\n SessionResult,\n SessionHandle,\n SessionInfo,\n} from './types.js';\nimport { EnclaveClientError } from './types.js';\n\n/**\n * Default configuration values.\n */\nconst DEFAULT_CONFIG = {\n timeout: 60000,\n autoReconnect: true,\n maxReconnectAttempts: 3,\n reconnectDelay: 1000,\n heartbeatTimeoutMs: 30000,\n} as const;\n\n/**\n * Internal session state.\n */\ninterface ActiveSession {\n sessionId: SessionId;\n events: StreamEvent[];\n abortController: AbortController;\n resolve: (result: SessionResult) => void;\n reject: (error: Error) => void;\n handlers: SessionEventHandlers;\n startTime: number;\n toolCallCount: number;\n stdoutBytes: number;\n reconnectState: ReconnectionStateMachine;\n heartbeatMonitor: HeartbeatMonitor;\n lastSequence: number;\n}\n\n/**\n * EnclaveClient provides a high-level API for executing code in the EnclaveJS runtime.\n *\n * @example\n * ```ts\n * const client = new EnclaveClient({\n * baseUrl: 'https://api.example.com',\n * });\n *\n * const result = await client.execute('return 1 + 1');\n * console.log(result.value); // 2\n * ```\n */\nexport class EnclaveClient {\n private readonly config: Required<Omit<EnclaveClientConfig, 'headers'>> & {\n headers?: Record<string, string>;\n };\n private readonly activeSessions = new Map<SessionId, ActiveSession>();\n\n /**\n * Create a new EnclaveClient instance.\n */\n constructor(config: EnclaveClientConfig) {\n // Normalize baseUrl (remove trailing slash)\n const baseUrl = config.baseUrl.replace(/\\/$/, '');\n\n this.config = {\n baseUrl,\n headers: config.headers,\n timeout: config.timeout ?? DEFAULT_CONFIG.timeout,\n autoReconnect: config.autoReconnect ?? DEFAULT_CONFIG.autoReconnect,\n maxReconnectAttempts: config.maxReconnectAttempts ?? DEFAULT_CONFIG.maxReconnectAttempts,\n reconnectDelay: config.reconnectDelay ?? DEFAULT_CONFIG.reconnectDelay,\n fetch: config.fetch ?? globalThis.fetch.bind(globalThis),\n };\n }\n\n /**\n * Execute code and return the result.\n *\n * @example\n * ```ts\n * const result = await client.execute('return 1 + 1');\n * if (result.success) {\n * console.log(result.value);\n * }\n * ```\n */\n async execute(code: string, options: ExecuteOptions & SessionEventHandlers = {}): Promise<SessionResult> {\n const handle = this.executeStream(code, options);\n return handle.wait();\n }\n\n /**\n * Execute code and return a session handle for streaming.\n *\n * @example\n * ```ts\n * const session = client.executeStream('return 1 + 1', {\n * onStdout: (chunk) => console.log(chunk),\n * onToolCall: (callId, name, args) => console.log('Tool:', name),\n * });\n *\n * const result = await session.wait();\n * ```\n */\n executeStream(code: string, options: ExecuteOptions & SessionEventHandlers = {}): SessionHandle {\n const sessionId = options.sessionId ?? generateSessionId();\n const abortController = new AbortController();\n\n // Combine external signal with internal abort controller\n if (options.signal) {\n options.signal.addEventListener('abort', () => {\n abortController.abort(options.signal?.reason);\n });\n }\n\n // Create promise for result\n let resolveResult: (result: SessionResult) => void;\n let rejectResult: (error: Error) => void;\n const resultPromise = new Promise<SessionResult>((resolve, reject) => {\n resolveResult = resolve;\n rejectResult = reject;\n });\n\n // Create reconnection state machine\n const reconnectState = new ReconnectionStateMachine({\n config: {\n maxRetries: this.config.maxReconnectAttempts,\n initialDelayMs: this.config.reconnectDelay,\n },\n onEvent: (event) => {\n if (event.type === 'retry_started') {\n // Attempt reconnection\n this.reconnectSession(sessionId);\n }\n },\n });\n\n // Create heartbeat monitor\n const heartbeatMonitor = new HeartbeatMonitor({\n timeoutMs: DEFAULT_CONFIG.heartbeatTimeoutMs,\n onTimeout: () => {\n // Handle heartbeat timeout - trigger reconnection if enabled\n if (this.config.autoReconnect) {\n const session = this.activeSessions.get(sessionId);\n if (session) {\n reconnectState.onDisconnected('Heartbeat timeout');\n }\n }\n },\n });\n\n // Store session state\n const session: ActiveSession = {\n sessionId,\n events: [],\n abortController,\n resolve: resolveResult!,\n reject: rejectResult!,\n handlers: options,\n startTime: Date.now(),\n toolCallCount: 0,\n stdoutBytes: 0,\n reconnectState,\n heartbeatMonitor,\n lastSequence: 0,\n };\n\n this.activeSessions.set(sessionId, session);\n\n // Start the session\n this.startSession(session, code, options.limits).catch((error) => {\n this.handleSessionError(sessionId, error);\n });\n\n // Capture reference to events array for getEvents() after completion\n const eventsRef = session.events;\n\n // Return handle\n return {\n sessionId,\n wait: () => resultPromise,\n cancel: async (reason?: string) => {\n await this.cancelSession(sessionId, reason);\n },\n getEvents: () => [...eventsRef],\n isActive: () => this.activeSessions.has(sessionId),\n };\n }\n\n /**\n * Get information about a session.\n */\n async getSession(sessionId: SessionId): Promise<SessionInfo | null> {\n const url = `${this.config.baseUrl}/sessions/${sessionId}`;\n\n try {\n const response = await this.config.fetch(url, {\n method: 'GET',\n headers: this.buildHeaders(),\n });\n\n if (response.status === 404) {\n return null;\n }\n\n if (!response.ok) {\n throw new EnclaveClientError('SESSION_ERROR', `Failed to get session: ${response.status}`);\n }\n\n return (await response.json()) as SessionInfo;\n } catch (error) {\n if (error instanceof EnclaveClientError) throw error;\n throw new EnclaveClientError(\n 'NETWORK_ERROR',\n 'Failed to get session',\n error instanceof Error ? error : undefined,\n );\n }\n }\n\n /**\n * Cancel a running session.\n */\n async cancelSession(sessionId: SessionId, reason?: string): Promise<void> {\n const session = this.activeSessions.get(sessionId);\n if (!session) {\n return;\n }\n\n // Stop heartbeat monitoring\n session.heartbeatMonitor.stop();\n session.reconnectState.close();\n\n // Abort the request\n session.abortController.abort(reason);\n\n // Send cancel request to server\n const url = `${this.config.baseUrl}/sessions/${sessionId}/cancel`;\n\n try {\n await this.config.fetch(url, {\n method: 'POST',\n headers: this.buildHeaders(),\n body: JSON.stringify({ reason }),\n });\n } catch {\n // Ignore errors - session may already be cancelled\n }\n\n // Complete the session\n this.completeSession(sessionId, {\n success: false,\n sessionId,\n error: { code: 'CANCELLED', message: reason ?? 'Session cancelled' },\n events: session.events,\n stats: {\n durationMs: Date.now() - session.startTime,\n toolCallCount: session.toolCallCount,\n stdoutBytes: session.stdoutBytes,\n },\n });\n }\n\n /**\n * Start a session and begin streaming events.\n */\n private async startSession(session: ActiveSession, code: string, limits?: Partial<SessionLimits>): Promise<void> {\n const url = `${this.config.baseUrl}/sessions`;\n\n // Build request body\n const body: Record<string, unknown> = {\n sessionId: session.sessionId,\n code,\n };\n\n if (limits) {\n body.config = {\n maxExecutionMs: limits.sessionTtlMs,\n maxToolCalls: limits.maxToolCalls,\n heartbeatIntervalMs: limits.heartbeatIntervalMs,\n };\n }\n\n try {\n const response = await this.config.fetch(url, {\n method: 'POST',\n headers: {\n ...this.buildHeaders(),\n 'Content-Type': 'application/json',\n Accept: 'application/x-ndjson',\n },\n body: JSON.stringify(body),\n signal: session.abortController.signal,\n });\n\n if (!response.ok) {\n const errorText = await response.text();\n throw new EnclaveClientError('SESSION_ERROR', `Failed to start session: ${response.status} - ${errorText}`);\n }\n\n // Mark as connected\n session.reconnectState.onConnected();\n session.heartbeatMonitor.start();\n\n // Stream the response\n await this.streamResponse(session, response);\n } catch (error) {\n if (error instanceof Error && error.name === 'AbortError') {\n // Session was cancelled\n return;\n }\n\n // Handle connection error\n if (this.config.autoReconnect && session.reconnectState.canReconnect()) {\n session.reconnectState.onDisconnected(error instanceof Error ? error.message : 'Connection lost');\n return;\n }\n\n throw error;\n }\n }\n\n /**\n * Stream and parse the NDJSON response.\n */\n private async streamResponse(session: ActiveSession, response: Response): Promise<void> {\n const body = response.body;\n if (!body) {\n throw new EnclaveClientError('PARSE_ERROR', 'No response body');\n }\n\n try {\n // Use the async generator to parse NDJSON stream\n for await (const event of parseNdjsonStream(body)) {\n // The generator yields validated events\n this.handleEvent(session, event as StreamEvent);\n }\n } catch (error) {\n if (error instanceof Error && error.name === 'AbortError') {\n return;\n }\n\n // Handle stream error\n if (this.config.autoReconnect && session.reconnectState.canReconnect()) {\n session.reconnectState.onDisconnected(error instanceof Error ? error.message : 'Stream error');\n return;\n }\n\n throw error;\n }\n }\n\n /**\n * Handle a received stream event.\n */\n private handleEvent(session: ActiveSession, event: StreamEvent): void {\n // Track sequence\n if (event.seq !== undefined) {\n session.lastSequence = event.seq;\n }\n\n // Store event\n session.events.push(event);\n\n // Call general event handler\n session.handlers.onEvent?.(event);\n\n // Route to specific handlers\n if (isSessionInitEvent(event)) {\n session.handlers.onSessionInit?.(event);\n } else if (isStdoutEvent(event)) {\n session.stdoutBytes += event.payload.chunk.length;\n session.handlers.onStdout?.(event.payload.chunk);\n } else if (isLogEvent(event)) {\n session.handlers.onLog?.(event.payload.level, event.payload.message, event.payload.data);\n } else if (isToolCallEvent(event)) {\n session.toolCallCount++;\n session.handlers.onToolCall?.(event.payload.callId, event.payload.toolName, event.payload.args);\n } else if (isToolResultAppliedEvent(event)) {\n session.handlers.onToolResultApplied?.(event.payload.callId);\n } else if (isHeartbeatEvent(event)) {\n session.heartbeatMonitor.onHeartbeat();\n session.handlers.onHeartbeat?.();\n } else if (isErrorEvent(event)) {\n session.handlers.onError?.(event.payload.code ?? 'UNKNOWN', event.payload.message);\n } else if (isFinalEvent(event)) {\n this.handleFinalEvent(session, event);\n }\n }\n\n /**\n * Handle the final event and complete the session.\n */\n private handleFinalEvent(session: ActiveSession, event: FinalEvent): void {\n session.heartbeatMonitor.stop();\n session.reconnectState.close();\n\n const result: SessionResult = {\n success: event.payload.ok,\n sessionId: session.sessionId,\n events: session.events,\n stats: {\n durationMs: Date.now() - session.startTime,\n toolCallCount: session.toolCallCount,\n stdoutBytes: session.stdoutBytes,\n },\n };\n\n if (event.payload.ok) {\n result.value = event.payload.result;\n } else {\n result.error = {\n code: event.payload.error?.code,\n message: event.payload.error?.message ?? 'Unknown error',\n };\n }\n\n this.completeSession(session.sessionId, result);\n }\n\n /**\n * Handle a session error.\n */\n private handleSessionError(sessionId: SessionId, error: unknown): void {\n const session = this.activeSessions.get(sessionId);\n if (!session) return;\n\n session.heartbeatMonitor.stop();\n session.reconnectState.close();\n\n const clientError =\n error instanceof EnclaveClientError\n ? error\n : new EnclaveClientError(\n 'NETWORK_ERROR',\n error instanceof Error ? error.message : 'Unknown error',\n error instanceof Error ? error : undefined,\n );\n\n this.completeSession(sessionId, {\n success: false,\n sessionId,\n error: { code: clientError.code, message: clientError.message },\n events: session.events,\n stats: {\n durationMs: Date.now() - session.startTime,\n toolCallCount: session.toolCallCount,\n stdoutBytes: session.stdoutBytes,\n },\n });\n }\n\n /**\n * Complete a session and clean up.\n */\n private completeSession(sessionId: SessionId, result: SessionResult): void {\n const session = this.activeSessions.get(sessionId);\n if (!session) return;\n\n this.activeSessions.delete(sessionId);\n session.resolve(result);\n }\n\n /**\n * Attempt to reconnect a session.\n */\n private async reconnectSession(sessionId: SessionId): Promise<void> {\n const session = this.activeSessions.get(sessionId);\n if (!session) return;\n\n // Request replay from last known sequence\n const url = `${this.config.baseUrl}/sessions/${sessionId}/stream`;\n const params = new URLSearchParams();\n if (session.lastSequence > 0) {\n params.set('from', String(session.lastSequence + 1));\n }\n\n try {\n const response = await this.config.fetch(`${url}?${params}`, {\n method: 'GET',\n headers: {\n ...this.buildHeaders(),\n Accept: 'application/x-ndjson',\n },\n signal: session.abortController.signal,\n });\n\n if (!response.ok) {\n throw new EnclaveClientError('RECONNECT_FAILED', `Reconnection failed: ${response.status}`);\n }\n\n session.reconnectState.onConnected();\n session.heartbeatMonitor.start();\n\n await this.streamResponse(session, response);\n } catch (error) {\n if (error instanceof Error && error.name === 'AbortError') {\n return;\n }\n\n if (session.reconnectState.canReconnect()) {\n session.reconnectState.onDisconnected(error instanceof Error ? error.message : 'Reconnection failed');\n } else {\n this.handleSessionError(sessionId, error);\n }\n }\n }\n\n /**\n * Build request headers.\n */\n private buildHeaders(): Record<string, string> {\n return {\n ...this.config.headers,\n };\n }\n}\n"]}
package/src/index.d.ts ADDED
@@ -0,0 +1,12 @@
1
+ /**
2
+ * @enclave-vm/client
3
+ *
4
+ * Browser and Node.js client SDK for the EnclaveJS streaming runtime.
5
+ *
6
+ * @packageDocumentation
7
+ */
8
+ export { EnclaveClient } from './client.js';
9
+ export { EnclaveClientError, type EnclaveClientConfig, type ExecuteOptions, type EventHandler, type SessionEventHandlers, type SessionResult, type SessionHandle, type SessionInfo, type ClientErrorCode, } from './types.js';
10
+ export type { SessionId, SessionLimits, StreamEvent, SessionInitEvent, StdoutEvent, LogEvent, ToolCallEvent, ToolResultAppliedEvent, FinalEvent, HeartbeatEvent, ErrorEvent, } from '@enclave-vm/types';
11
+ export { ConnectionState } from '@enclave-vm/stream';
12
+ //# sourceMappingURL=index.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAG5C,OAAO,EACL,kBAAkB,EAClB,KAAK,mBAAmB,EACxB,KAAK,cAAc,EACnB,KAAK,YAAY,EACjB,KAAK,oBAAoB,EACzB,KAAK,aAAa,EAClB,KAAK,aAAa,EAClB,KAAK,WAAW,EAChB,KAAK,eAAe,GACrB,MAAM,YAAY,CAAC;AAGpB,YAAY,EACV,SAAS,EACT,aAAa,EACb,WAAW,EACX,gBAAgB,EAChB,WAAW,EACX,QAAQ,EACR,aAAa,EACb,sBAAsB,EACtB,UAAU,EACV,cAAc,EACd,UAAU,GACX,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC"}
package/src/index.js ADDED
@@ -0,0 +1,20 @@
1
+ "use strict";
2
+ /**
3
+ * @enclave-vm/client
4
+ *
5
+ * Browser and Node.js client SDK for the EnclaveJS streaming runtime.
6
+ *
7
+ * @packageDocumentation
8
+ */
9
+ Object.defineProperty(exports, "__esModule", { value: true });
10
+ exports.ConnectionState = exports.EnclaveClientError = exports.EnclaveClient = void 0;
11
+ // Client exports
12
+ var client_js_1 = require("./client.js");
13
+ Object.defineProperty(exports, "EnclaveClient", { enumerable: true, get: function () { return client_js_1.EnclaveClient; } });
14
+ // Type exports
15
+ var types_js_1 = require("./types.js");
16
+ Object.defineProperty(exports, "EnclaveClientError", { enumerable: true, get: function () { return types_js_1.EnclaveClientError; } });
17
+ // Re-export connection state for checking session status
18
+ var stream_1 = require("@enclave-vm/stream");
19
+ Object.defineProperty(exports, "ConnectionState", { enumerable: true, get: function () { return stream_1.ConnectionState; } });
20
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;;AAEH,iBAAiB;AACjB,yCAA4C;AAAnC,0GAAA,aAAa,OAAA;AAEtB,eAAe;AACf,uCAUoB;AATlB,8GAAA,kBAAkB,OAAA;AA0BpB,yDAAyD;AACzD,6CAAqD;AAA5C,yGAAA,eAAe,OAAA","sourcesContent":["/**\n * @enclave-vm/client\n *\n * Browser and Node.js client SDK for the EnclaveJS streaming runtime.\n *\n * @packageDocumentation\n */\n\n// Client exports\nexport { EnclaveClient } from './client.js';\n\n// Type exports\nexport {\n EnclaveClientError,\n type EnclaveClientConfig,\n type ExecuteOptions,\n type EventHandler,\n type SessionEventHandlers,\n type SessionResult,\n type SessionHandle,\n type SessionInfo,\n type ClientErrorCode,\n} from './types.js';\n\n// Re-export commonly used types from @enclave-vm/types\nexport type {\n SessionId,\n SessionLimits,\n StreamEvent,\n SessionInitEvent,\n StdoutEvent,\n LogEvent,\n ToolCallEvent,\n ToolResultAppliedEvent,\n FinalEvent,\n HeartbeatEvent,\n ErrorEvent,\n} from '@enclave-vm/types';\n\n// Re-export connection state for checking session status\nexport { ConnectionState } from '@enclave-vm/stream';\n"]}
package/src/types.d.ts ADDED
@@ -0,0 +1,190 @@
1
+ /**
2
+ * Client Types
3
+ *
4
+ * Types for the EnclaveJS client SDK.
5
+ *
6
+ * @packageDocumentation
7
+ */
8
+ import type { SessionId, StreamEvent, SessionLimits } from '@enclave-vm/types';
9
+ /**
10
+ * Client configuration
11
+ */
12
+ export interface EnclaveClientConfig {
13
+ /**
14
+ * Middleware base URL (e.g., 'https://api.example.com')
15
+ */
16
+ baseUrl: string;
17
+ /**
18
+ * Default headers to include in all requests
19
+ */
20
+ headers?: Record<string, string>;
21
+ /**
22
+ * Request timeout in milliseconds
23
+ * @default 60000
24
+ */
25
+ timeout?: number;
26
+ /**
27
+ * Enable automatic reconnection on disconnect
28
+ * @default true
29
+ */
30
+ autoReconnect?: boolean;
31
+ /**
32
+ * Maximum reconnection attempts
33
+ * @default 3
34
+ */
35
+ maxReconnectAttempts?: number;
36
+ /**
37
+ * Reconnection delay in milliseconds
38
+ * @default 1000
39
+ */
40
+ reconnectDelay?: number;
41
+ /**
42
+ * Custom fetch implementation (for Node.js or testing)
43
+ */
44
+ fetch?: typeof fetch;
45
+ }
46
+ /**
47
+ * Session execution options
48
+ */
49
+ export interface ExecuteOptions {
50
+ /**
51
+ * Optional session ID (generated if not provided)
52
+ */
53
+ sessionId?: SessionId;
54
+ /**
55
+ * Session limits configuration
56
+ */
57
+ limits?: Partial<SessionLimits>;
58
+ /**
59
+ * Abort signal for cancellation
60
+ */
61
+ signal?: AbortSignal;
62
+ }
63
+ /**
64
+ * Event handler types
65
+ */
66
+ export type EventHandler<T extends StreamEvent = StreamEvent> = (event: T) => void;
67
+ /**
68
+ * Session event handlers
69
+ */
70
+ export interface SessionEventHandlers {
71
+ /**
72
+ * Called for every event
73
+ */
74
+ onEvent?: EventHandler;
75
+ /**
76
+ * Called when session initializes
77
+ */
78
+ onSessionInit?: EventHandler;
79
+ /**
80
+ * Called for stdout output
81
+ */
82
+ onStdout?: (chunk: string) => void;
83
+ /**
84
+ * Called for log messages
85
+ */
86
+ onLog?: (level: string, message: string, data?: Record<string, unknown>) => void;
87
+ /**
88
+ * Called when a tool is being called
89
+ */
90
+ onToolCall?: (callId: string, toolName: string, args: unknown) => void;
91
+ /**
92
+ * Called when a tool result is applied
93
+ */
94
+ onToolResultApplied?: (callId: string) => void;
95
+ /**
96
+ * Called on heartbeat
97
+ */
98
+ onHeartbeat?: () => void;
99
+ /**
100
+ * Called on non-fatal error
101
+ */
102
+ onError?: (code: string, message: string) => void;
103
+ }
104
+ /**
105
+ * Session execution result
106
+ */
107
+ export interface SessionResult<T = unknown> {
108
+ /**
109
+ * Whether execution succeeded
110
+ */
111
+ success: boolean;
112
+ /**
113
+ * Session ID
114
+ */
115
+ sessionId: SessionId;
116
+ /**
117
+ * Result value (if success)
118
+ */
119
+ value?: T;
120
+ /**
121
+ * Error information (if failed)
122
+ */
123
+ error?: {
124
+ code?: string;
125
+ message: string;
126
+ };
127
+ /**
128
+ * Execution statistics
129
+ */
130
+ stats?: {
131
+ durationMs: number;
132
+ toolCallCount: number;
133
+ stdoutBytes: number;
134
+ };
135
+ /**
136
+ * All events received during execution
137
+ */
138
+ events: StreamEvent[];
139
+ }
140
+ /**
141
+ * Active session handle
142
+ */
143
+ export interface SessionHandle {
144
+ /**
145
+ * Session ID
146
+ */
147
+ sessionId: SessionId;
148
+ /**
149
+ * Wait for session to complete
150
+ */
151
+ wait(): Promise<SessionResult>;
152
+ /**
153
+ * Cancel the session
154
+ */
155
+ cancel(reason?: string): Promise<void>;
156
+ /**
157
+ * Get events received so far
158
+ */
159
+ getEvents(): StreamEvent[];
160
+ /**
161
+ * Check if session is still active
162
+ */
163
+ isActive(): boolean;
164
+ }
165
+ /**
166
+ * Session info from the API
167
+ */
168
+ export interface SessionInfo {
169
+ sessionId: SessionId;
170
+ state: string;
171
+ createdAt: number;
172
+ expiresAt: number;
173
+ stats: {
174
+ duration: number;
175
+ toolCallCount: number;
176
+ };
177
+ }
178
+ /**
179
+ * Client error types
180
+ */
181
+ export type ClientErrorCode = 'NETWORK_ERROR' | 'TIMEOUT' | 'PARSE_ERROR' | 'SESSION_ERROR' | 'CANCELLED' | 'RECONNECT_FAILED';
182
+ /**
183
+ * Client error
184
+ */
185
+ export declare class EnclaveClientError extends Error {
186
+ readonly code: ClientErrorCode;
187
+ readonly cause?: Error;
188
+ constructor(code: ClientErrorCode, message: string, cause?: Error);
189
+ }
190
+ //# sourceMappingURL=types.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"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"}
package/src/types.js ADDED
@@ -0,0 +1,25 @@
1
+ "use strict";
2
+ /**
3
+ * Client Types
4
+ *
5
+ * Types for the EnclaveJS client SDK.
6
+ *
7
+ * @packageDocumentation
8
+ */
9
+ Object.defineProperty(exports, "__esModule", { value: true });
10
+ exports.EnclaveClientError = void 0;
11
+ /**
12
+ * Client error
13
+ */
14
+ class EnclaveClientError extends Error {
15
+ code;
16
+ cause;
17
+ constructor(code, message, cause) {
18
+ super(message);
19
+ this.name = 'EnclaveClientError';
20
+ this.code = code;
21
+ this.cause = cause;
22
+ }
23
+ }
24
+ exports.EnclaveClientError = EnclaveClientError;
25
+ //# sourceMappingURL=types.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;;AAuNH;;GAEG;AACH,MAAa,kBAAmB,SAAQ,KAAK;IAClC,IAAI,CAAkB;IACtB,KAAK,CAAS;IAEvB,YAAY,IAAqB,EAAE,OAAe,EAAE,KAAa;QAC/D,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAC;QACjC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;IACrB,CAAC;CACF;AAVD,gDAUC","sourcesContent":["/**\n * Client Types\n *\n * Types for the EnclaveJS client SDK.\n *\n * @packageDocumentation\n */\n\nimport type { SessionId, StreamEvent, SessionLimits } from '@enclave-vm/types';\n\n/**\n * Client configuration\n */\nexport interface EnclaveClientConfig {\n /**\n * Middleware base URL (e.g., 'https://api.example.com')\n */\n baseUrl: string;\n\n /**\n * Default headers to include in all requests\n */\n headers?: Record<string, string>;\n\n /**\n * Request timeout in milliseconds\n * @default 60000\n */\n timeout?: number;\n\n /**\n * Enable automatic reconnection on disconnect\n * @default true\n */\n autoReconnect?: boolean;\n\n /**\n * Maximum reconnection attempts\n * @default 3\n */\n maxReconnectAttempts?: number;\n\n /**\n * Reconnection delay in milliseconds\n * @default 1000\n */\n reconnectDelay?: number;\n\n /**\n * Custom fetch implementation (for Node.js or testing)\n */\n fetch?: typeof fetch;\n}\n\n/**\n * Session execution options\n */\nexport interface ExecuteOptions {\n /**\n * Optional session ID (generated if not provided)\n */\n sessionId?: SessionId;\n\n /**\n * Session limits configuration\n */\n limits?: Partial<SessionLimits>;\n\n /**\n * Abort signal for cancellation\n */\n signal?: AbortSignal;\n}\n\n/**\n * Event handler types\n */\nexport type EventHandler<T extends StreamEvent = StreamEvent> = (event: T) => void;\n\n/**\n * Session event handlers\n */\nexport interface SessionEventHandlers {\n /**\n * Called for every event\n */\n onEvent?: EventHandler;\n\n /**\n * Called when session initializes\n */\n onSessionInit?: EventHandler;\n\n /**\n * Called for stdout output\n */\n onStdout?: (chunk: string) => void;\n\n /**\n * Called for log messages\n */\n onLog?: (level: string, message: string, data?: Record<string, unknown>) => void;\n\n /**\n * Called when a tool is being called\n */\n onToolCall?: (callId: string, toolName: string, args: unknown) => void;\n\n /**\n * Called when a tool result is applied\n */\n onToolResultApplied?: (callId: string) => void;\n\n /**\n * Called on heartbeat\n */\n onHeartbeat?: () => void;\n\n /**\n * Called on non-fatal error\n */\n onError?: (code: string, message: string) => void;\n}\n\n/**\n * Session execution result\n */\nexport interface SessionResult<T = unknown> {\n /**\n * Whether execution succeeded\n */\n success: boolean;\n\n /**\n * Session ID\n */\n sessionId: SessionId;\n\n /**\n * Result value (if success)\n */\n value?: T;\n\n /**\n * Error information (if failed)\n */\n error?: {\n code?: string;\n message: string;\n };\n\n /**\n * Execution statistics\n */\n stats?: {\n durationMs: number;\n toolCallCount: number;\n stdoutBytes: number;\n };\n\n /**\n * All events received during execution\n */\n events: StreamEvent[];\n}\n\n/**\n * Active session handle\n */\nexport interface SessionHandle {\n /**\n * Session ID\n */\n sessionId: SessionId;\n\n /**\n * Wait for session to complete\n */\n wait(): Promise<SessionResult>;\n\n /**\n * Cancel the session\n */\n cancel(reason?: string): Promise<void>;\n\n /**\n * Get events received so far\n */\n getEvents(): StreamEvent[];\n\n /**\n * Check if session is still active\n */\n isActive(): boolean;\n}\n\n/**\n * Session info from the API\n */\nexport interface SessionInfo {\n sessionId: SessionId;\n state: string;\n createdAt: number;\n expiresAt: number;\n stats: {\n duration: number;\n toolCallCount: number;\n };\n}\n\n/**\n * Client error types\n */\nexport type ClientErrorCode =\n | 'NETWORK_ERROR'\n | 'TIMEOUT'\n | 'PARSE_ERROR'\n | 'SESSION_ERROR'\n | 'CANCELLED'\n | 'RECONNECT_FAILED';\n\n/**\n * Client error\n */\nexport class EnclaveClientError extends Error {\n readonly code: ClientErrorCode;\n readonly cause?: Error;\n\n constructor(code: ClientErrorCode, message: string, cause?: Error) {\n super(message);\n this.name = 'EnclaveClientError';\n this.code = code;\n this.cause = cause;\n }\n}\n"]}