@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 +38 -0
- package/src/client.d.ts +97 -0
- package/src/client.d.ts.map +1 -0
- package/src/client.js +452 -0
- package/src/client.js.map +1 -0
- package/src/index.d.ts +12 -0
- package/src/index.d.ts.map +1 -0
- package/src/index.js +20 -0
- package/src/index.js.map +1 -0
- package/src/types.d.ts +190 -0
- package/src/types.d.ts.map +1 -0
- package/src/types.js +25 -0
- package/src/types.js.map +1 -0
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
|
+
}
|
package/src/client.d.ts
ADDED
|
@@ -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
|
package/src/index.js.map
ADDED
|
@@ -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
|
package/src/types.js.map
ADDED
|
@@ -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"]}
|