@steventsao/agent-session 0.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -0,0 +1,73 @@
1
+ /**
2
+ * AgentSessionClient - Vanilla JS WebSocket client
3
+ *
4
+ * Framework-agnostic client for connecting to agent-session worker.
5
+ */
6
+ import type { ClientEvent, ServerEvent } from '@steventsao/agent-session-core';
7
+ export type ServerEventHandler<T extends ServerEvent = ServerEvent> = (event: T) => void;
8
+ export interface AgentSessionClientOptions {
9
+ /** WebSocket base URL (e.g., wss://your-worker.workers.dev) */
10
+ url: string;
11
+ /** Session ID to connect to */
12
+ sessionId: string;
13
+ /** User ID for session tracking */
14
+ userId?: string;
15
+ /** Max reconnection attempts (default: 5) */
16
+ maxReconnectAttempts?: number;
17
+ /** Auto-reconnect on disconnect (default: true) */
18
+ autoReconnect?: boolean;
19
+ /** Ping interval in ms (default: 30000) */
20
+ pingInterval?: number;
21
+ /** Auto-connect on instantiation (default: false) */
22
+ autoConnect?: boolean;
23
+ }
24
+ export declare class AgentSessionClient {
25
+ private ws;
26
+ private baseUrl;
27
+ private sessionId;
28
+ private userId;
29
+ private pingIntervalId;
30
+ private reconnectTimeout;
31
+ private reconnectAttempts;
32
+ private socketId;
33
+ private maxReconnectAttempts;
34
+ private autoReconnect;
35
+ private pingInterval;
36
+ private handlers;
37
+ private globalHandlers;
38
+ constructor(options: AgentSessionClientOptions);
39
+ connect(): void;
40
+ disconnect(): void;
41
+ get isConnected(): boolean;
42
+ on<T extends ServerEvent['type']>(eventType: T, handler: ServerEventHandler<Extract<ServerEvent, {
43
+ type: T;
44
+ }>>): () => void;
45
+ onAny(handler: ServerEventHandler): () => void;
46
+ off(eventType: ServerEvent['type']): void;
47
+ offAll(): void;
48
+ private handleMessage;
49
+ private emit;
50
+ send(message: ClientEvent): void;
51
+ init(metadata?: Record<string, unknown>): void;
52
+ startSandbox(template?: string): void;
53
+ stopSandbox(): void;
54
+ exec(cmd: string, cwd?: string): void;
55
+ sendAgentMessage(content: string, model?: {
56
+ id: string;
57
+ provider?: string;
58
+ }, options?: {
59
+ config?: {
60
+ temperature?: number;
61
+ maxTokens?: number;
62
+ };
63
+ systemPrompt?: string;
64
+ agentType?: string;
65
+ }): void;
66
+ stopAgent(): void;
67
+ resetAgent(): void;
68
+ private startPing;
69
+ private stopPing;
70
+ private clearReconnect;
71
+ private maybeReconnect;
72
+ }
73
+ //# sourceMappingURL=client.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,gCAAgC,CAAC;AAE/E,MAAM,MAAM,kBAAkB,CAAC,CAAC,SAAS,WAAW,GAAG,WAAW,IAAI,CAAC,KAAK,EAAE,CAAC,KAAK,IAAI,CAAC;AAEzF,MAAM,WAAW,yBAAyB;IACxC,+DAA+D;IAC/D,GAAG,EAAE,MAAM,CAAC;IACZ,+BAA+B;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,mCAAmC;IACnC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,6CAA6C;IAC7C,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,mDAAmD;IACnD,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,2CAA2C;IAC3C,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,qDAAqD;IACrD,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,EAAE,CAA0B;IACpC,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,MAAM,CAAgB;IAC9B,OAAO,CAAC,cAAc,CAA+C;IACrE,OAAO,CAAC,gBAAgB,CAA8C;IACtE,OAAO,CAAC,iBAAiB,CAAK;IAC9B,OAAO,CAAC,QAAQ,CAAK;IACrB,OAAO,CAAC,oBAAoB,CAAS;IACrC,OAAO,CAAC,aAAa,CAAU;IAC/B,OAAO,CAAC,YAAY,CAAS;IAG7B,OAAO,CAAC,QAAQ,CAAmD;IACnE,OAAO,CAAC,cAAc,CAAsC;gBAEhD,OAAO,EAAE,yBAAyB;IAiB9C,OAAO,IAAI,IAAI;IAiDf,UAAU,IAAI,IAAI;IAQlB,IAAI,WAAW,IAAI,OAAO,CAEzB;IAMD,EAAE,CAAC,CAAC,SAAS,WAAW,CAAC,MAAM,CAAC,EAC9B,SAAS,EAAE,CAAC,EACZ,OAAO,EAAE,kBAAkB,CAAC,OAAO,CAAC,WAAW,EAAE;QAAE,IAAI,EAAE,CAAC,CAAA;KAAE,CAAC,CAAC,GAC7D,MAAM,IAAI;IAQb,KAAK,CAAC,OAAO,EAAE,kBAAkB,GAAG,MAAM,IAAI;IAK9C,GAAG,CAAC,SAAS,EAAE,WAAW,CAAC,MAAM,CAAC,GAAG,IAAI;IAIzC,MAAM,IAAI,IAAI;IAKd,OAAO,CAAC,aAAa;IAqBrB,OAAO,CAAC,IAAI;IAQZ,IAAI,CAAC,OAAO,EAAE,WAAW,GAAG,IAAI;IAQhC,IAAI,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAI9C,YAAY,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI;IAIrC,WAAW,IAAI,IAAI;IAInB,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI;IAIrC,gBAAgB,CACd,OAAO,EAAE,MAAM,EACf,KAAK,CAAC,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,EACzC,OAAO,CAAC,EAAE;QACR,MAAM,CAAC,EAAE;YAAE,WAAW,CAAC,EAAE,MAAM,CAAC;YAAC,SAAS,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC;QACtD,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB,GACA,IAAI;IAWP,SAAS,IAAI,IAAI;IAIjB,UAAU,IAAI,IAAI;IAQlB,OAAO,CAAC,SAAS;IAOjB,OAAO,CAAC,QAAQ;IAOhB,OAAO,CAAC,cAAc;IAOtB,OAAO,CAAC,cAAc;CAevB"}
package/dist/client.js ADDED
@@ -0,0 +1,209 @@
1
+ /**
2
+ * AgentSessionClient - Vanilla JS WebSocket client
3
+ *
4
+ * Framework-agnostic client for connecting to agent-session worker.
5
+ */
6
+ export class AgentSessionClient {
7
+ ws = null;
8
+ baseUrl;
9
+ sessionId;
10
+ userId;
11
+ pingIntervalId = null;
12
+ reconnectTimeout = null;
13
+ reconnectAttempts = 0;
14
+ socketId = 0;
15
+ maxReconnectAttempts;
16
+ autoReconnect;
17
+ pingInterval;
18
+ // Event handlers
19
+ handlers = new Map();
20
+ globalHandlers = new Set();
21
+ constructor(options) {
22
+ this.baseUrl = options.url.replace(/\/$/, '');
23
+ this.sessionId = options.sessionId;
24
+ this.userId = options.userId || null;
25
+ this.maxReconnectAttempts = options.maxReconnectAttempts ?? 5;
26
+ this.autoReconnect = options.autoReconnect ?? true;
27
+ this.pingInterval = options.pingInterval ?? 30000;
28
+ if (options.autoConnect) {
29
+ this.connect();
30
+ }
31
+ }
32
+ // ==========================================================================
33
+ // Connection Management
34
+ // ==========================================================================
35
+ connect() {
36
+ if (this.ws?.readyState === WebSocket.OPEN) {
37
+ return;
38
+ }
39
+ this.reconnectAttempts = 0;
40
+ const thisSocketId = ++this.socketId;
41
+ const params = new URLSearchParams();
42
+ if (this.userId)
43
+ params.set('userId', this.userId);
44
+ const url = `${this.baseUrl}/session/${this.sessionId}/ws?${params}`;
45
+ console.log('[AgentSession] Connecting to:', url);
46
+ this.ws = new WebSocket(url);
47
+ this.ws.onopen = () => {
48
+ if (thisSocketId !== this.socketId)
49
+ return;
50
+ console.log('[AgentSession] Connected');
51
+ this.reconnectAttempts = 0;
52
+ this.startPing();
53
+ };
54
+ this.ws.onmessage = (event) => {
55
+ if (thisSocketId !== this.socketId)
56
+ return;
57
+ try {
58
+ const data = JSON.parse(event.data);
59
+ this.handleMessage(data);
60
+ }
61
+ catch (err) {
62
+ console.error('[AgentSession] Parse error:', err);
63
+ }
64
+ };
65
+ this.ws.onclose = (event) => {
66
+ if (thisSocketId !== this.socketId)
67
+ return;
68
+ console.log('[AgentSession] Disconnected:', event.code);
69
+ this.stopPing();
70
+ this.emit({ type: 'SYSTEM', msg: 'Disconnected' });
71
+ if (this.autoReconnect) {
72
+ this.maybeReconnect();
73
+ }
74
+ };
75
+ this.ws.onerror = (event) => {
76
+ if (thisSocketId !== this.socketId)
77
+ return;
78
+ console.error('[AgentSession] Error:', event);
79
+ };
80
+ }
81
+ disconnect() {
82
+ this.stopPing();
83
+ this.clearReconnect();
84
+ this.socketId++;
85
+ this.ws?.close();
86
+ this.ws = null;
87
+ }
88
+ get isConnected() {
89
+ return this.ws?.readyState === WebSocket.OPEN;
90
+ }
91
+ // ==========================================================================
92
+ // Event Handling
93
+ // ==========================================================================
94
+ on(eventType, handler) {
95
+ if (!this.handlers.has(eventType)) {
96
+ this.handlers.set(eventType, new Set());
97
+ }
98
+ this.handlers.get(eventType).add(handler);
99
+ return () => this.handlers.get(eventType)?.delete(handler);
100
+ }
101
+ onAny(handler) {
102
+ this.globalHandlers.add(handler);
103
+ return () => this.globalHandlers.delete(handler);
104
+ }
105
+ off(eventType) {
106
+ this.handlers.delete(eventType);
107
+ }
108
+ offAll() {
109
+ this.handlers.clear();
110
+ this.globalHandlers.clear();
111
+ }
112
+ handleMessage(event) {
113
+ const handlers = this.handlers.get(event.type);
114
+ if (handlers) {
115
+ for (const handler of handlers) {
116
+ try {
117
+ handler(event);
118
+ }
119
+ catch (err) {
120
+ console.error('[AgentSession] Handler error:', err);
121
+ }
122
+ }
123
+ }
124
+ for (const handler of this.globalHandlers) {
125
+ try {
126
+ handler(event);
127
+ }
128
+ catch (err) {
129
+ console.error('[AgentSession] Global handler error:', err);
130
+ }
131
+ }
132
+ }
133
+ emit(event) {
134
+ this.handleMessage(event);
135
+ }
136
+ // ==========================================================================
137
+ // Client Commands
138
+ // ==========================================================================
139
+ send(message) {
140
+ if (this.ws?.readyState !== WebSocket.OPEN) {
141
+ console.warn('[AgentSession] Not connected');
142
+ return;
143
+ }
144
+ this.ws.send(JSON.stringify(message));
145
+ }
146
+ init(metadata) {
147
+ this.send({ type: 'INIT', metadata });
148
+ }
149
+ startSandbox(template) {
150
+ this.send({ type: 'START_SANDBOX', template });
151
+ }
152
+ stopSandbox() {
153
+ this.send({ type: 'STOP_SANDBOX' });
154
+ }
155
+ exec(cmd, cwd) {
156
+ this.send({ type: 'EXEC', cmd, cwd });
157
+ }
158
+ sendAgentMessage(content, model, options) {
159
+ this.send({
160
+ type: 'AGENT_MESSAGE',
161
+ content,
162
+ model,
163
+ config: options?.config,
164
+ systemPrompt: options?.systemPrompt,
165
+ agentType: options?.agentType,
166
+ });
167
+ }
168
+ stopAgent() {
169
+ this.send({ type: 'AGENT_STOP' });
170
+ }
171
+ resetAgent() {
172
+ this.send({ type: 'AGENT_RESET' });
173
+ }
174
+ // ==========================================================================
175
+ // Private Helpers
176
+ // ==========================================================================
177
+ startPing() {
178
+ this.stopPing();
179
+ this.pingIntervalId = setInterval(() => {
180
+ this.send({ type: 'PING' });
181
+ }, this.pingInterval);
182
+ }
183
+ stopPing() {
184
+ if (this.pingIntervalId) {
185
+ clearInterval(this.pingIntervalId);
186
+ this.pingIntervalId = null;
187
+ }
188
+ }
189
+ clearReconnect() {
190
+ if (this.reconnectTimeout) {
191
+ clearTimeout(this.reconnectTimeout);
192
+ this.reconnectTimeout = null;
193
+ }
194
+ }
195
+ maybeReconnect() {
196
+ if (this.reconnectAttempts >= this.maxReconnectAttempts) {
197
+ console.error('[AgentSession] Max reconnect attempts');
198
+ this.emit({ type: 'ERROR', msg: 'Max reconnect attempts reached' });
199
+ return;
200
+ }
201
+ this.reconnectAttempts++;
202
+ const delay = Math.min(1000 * Math.pow(2, this.reconnectAttempts), 30000);
203
+ console.log(`[AgentSession] Reconnecting in ${delay}ms`);
204
+ this.reconnectTimeout = setTimeout(() => {
205
+ this.connect();
206
+ }, delay);
207
+ }
208
+ }
209
+ //# sourceMappingURL=client.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAuBH,MAAM,OAAO,kBAAkB;IACrB,EAAE,GAAqB,IAAI,CAAC;IAC5B,OAAO,CAAS;IAChB,SAAS,CAAS;IAClB,MAAM,CAAgB;IACtB,cAAc,GAA0C,IAAI,CAAC;IAC7D,gBAAgB,GAAyC,IAAI,CAAC;IAC9D,iBAAiB,GAAG,CAAC,CAAC;IACtB,QAAQ,GAAG,CAAC,CAAC;IACb,oBAAoB,CAAS;IAC7B,aAAa,CAAU;IACvB,YAAY,CAAS;IAE7B,iBAAiB;IACT,QAAQ,GAAyC,IAAI,GAAG,EAAE,CAAC;IAC3D,cAAc,GAA4B,IAAI,GAAG,EAAE,CAAC;IAE5D,YAAY,OAAkC;QAC5C,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;QAC9C,IAAI,CAAC,SAAS,GAAG,OAAO,CAAC,SAAS,CAAC;QACnC,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,IAAI,CAAC;QACrC,IAAI,CAAC,oBAAoB,GAAG,OAAO,CAAC,oBAAoB,IAAI,CAAC,CAAC;QAC9D,IAAI,CAAC,aAAa,GAAG,OAAO,CAAC,aAAa,IAAI,IAAI,CAAC;QACnD,IAAI,CAAC,YAAY,GAAG,OAAO,CAAC,YAAY,IAAI,KAAK,CAAC;QAElD,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;YACxB,IAAI,CAAC,OAAO,EAAE,CAAC;QACjB,CAAC;IACH,CAAC;IAED,6EAA6E;IAC7E,wBAAwB;IACxB,6EAA6E;IAE7E,OAAO;QACL,IAAI,IAAI,CAAC,EAAE,EAAE,UAAU,KAAK,SAAS,CAAC,IAAI,EAAE,CAAC;YAC3C,OAAO;QACT,CAAC;QAED,IAAI,CAAC,iBAAiB,GAAG,CAAC,CAAC;QAC3B,MAAM,YAAY,GAAG,EAAE,IAAI,CAAC,QAAQ,CAAC;QAErC,MAAM,MAAM,GAAG,IAAI,eAAe,EAAE,CAAC;QACrC,IAAI,IAAI,CAAC,MAAM;YAAE,MAAM,CAAC,GAAG,CAAC,QAAQ,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;QAEnD,MAAM,GAAG,GAAG,GAAG,IAAI,CAAC,OAAO,YAAY,IAAI,CAAC,SAAS,OAAO,MAAM,EAAE,CAAC;QACrE,OAAO,CAAC,GAAG,CAAC,+BAA+B,EAAE,GAAG,CAAC,CAAC;QAElD,IAAI,CAAC,EAAE,GAAG,IAAI,SAAS,CAAC,GAAG,CAAC,CAAC;QAE7B,IAAI,CAAC,EAAE,CAAC,MAAM,GAAG,GAAG,EAAE;YACpB,IAAI,YAAY,KAAK,IAAI,CAAC,QAAQ;gBAAE,OAAO;YAC3C,OAAO,CAAC,GAAG,CAAC,0BAA0B,CAAC,CAAC;YACxC,IAAI,CAAC,iBAAiB,GAAG,CAAC,CAAC;YAC3B,IAAI,CAAC,SAAS,EAAE,CAAC;QACnB,CAAC,CAAC;QAEF,IAAI,CAAC,EAAE,CAAC,SAAS,GAAG,CAAC,KAAK,EAAE,EAAE;YAC5B,IAAI,YAAY,KAAK,IAAI,CAAC,QAAQ;gBAAE,OAAO;YAC3C,IAAI,CAAC;gBACH,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAgB,CAAC;gBACnD,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC;YAC3B,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,OAAO,CAAC,KAAK,CAAC,6BAA6B,EAAE,GAAG,CAAC,CAAC;YACpD,CAAC;QACH,CAAC,CAAC;QAEF,IAAI,CAAC,EAAE,CAAC,OAAO,GAAG,CAAC,KAAK,EAAE,EAAE;YAC1B,IAAI,YAAY,KAAK,IAAI,CAAC,QAAQ;gBAAE,OAAO;YAC3C,OAAO,CAAC,GAAG,CAAC,8BAA8B,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;YACxD,IAAI,CAAC,QAAQ,EAAE,CAAC;YAChB,IAAI,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,GAAG,EAAE,cAAc,EAAE,CAAC,CAAC;YACnD,IAAI,IAAI,CAAC,aAAa,EAAE,CAAC;gBACvB,IAAI,CAAC,cAAc,EAAE,CAAC;YACxB,CAAC;QACH,CAAC,CAAC;QAEF,IAAI,CAAC,EAAE,CAAC,OAAO,GAAG,CAAC,KAAK,EAAE,EAAE;YAC1B,IAAI,YAAY,KAAK,IAAI,CAAC,QAAQ;gBAAE,OAAO;YAC3C,OAAO,CAAC,KAAK,CAAC,uBAAuB,EAAE,KAAK,CAAC,CAAC;QAChD,CAAC,CAAC;IACJ,CAAC;IAED,UAAU;QACR,IAAI,CAAC,QAAQ,EAAE,CAAC;QAChB,IAAI,CAAC,cAAc,EAAE,CAAC;QACtB,IAAI,CAAC,QAAQ,EAAE,CAAC;QAChB,IAAI,CAAC,EAAE,EAAE,KAAK,EAAE,CAAC;QACjB,IAAI,CAAC,EAAE,GAAG,IAAI,CAAC;IACjB,CAAC;IAED,IAAI,WAAW;QACb,OAAO,IAAI,CAAC,EAAE,EAAE,UAAU,KAAK,SAAS,CAAC,IAAI,CAAC;IAChD,CAAC;IAED,6EAA6E;IAC7E,iBAAiB;IACjB,6EAA6E;IAE7E,EAAE,CACA,SAAY,EACZ,OAA8D;QAE9D,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,CAAC;YAClC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,SAAS,EAAE,IAAI,GAAG,EAAE,CAAC,CAAC;QAC1C,CAAC;QACD,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAE,CAAC,GAAG,CAAC,OAA6B,CAAC,CAAC;QACjE,OAAO,GAAG,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC,OAA6B,CAAC,CAAC;IACnF,CAAC;IAED,KAAK,CAAC,OAA2B;QAC/B,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QACjC,OAAO,GAAG,EAAE,CAAC,IAAI,CAAC,cAAc,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IACnD,CAAC;IAED,GAAG,CAAC,SAA8B;QAChC,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IAClC,CAAC;IAED,MAAM;QACJ,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC;QACtB,IAAI,CAAC,cAAc,CAAC,KAAK,EAAE,CAAC;IAC9B,CAAC;IAEO,aAAa,CAAC,KAAkB;QACtC,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAC/C,IAAI,QAAQ,EAAE,CAAC;YACb,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;gBAC/B,IAAI,CAAC;oBACH,OAAO,CAAC,KAAK,CAAC,CAAC;gBACjB,CAAC;gBAAC,OAAO,GAAG,EAAE,CAAC;oBACb,OAAO,CAAC,KAAK,CAAC,+BAA+B,EAAE,GAAG,CAAC,CAAC;gBACtD,CAAC;YACH,CAAC;QACH,CAAC;QAED,KAAK,MAAM,OAAO,IAAI,IAAI,CAAC,cAAc,EAAE,CAAC;YAC1C,IAAI,CAAC;gBACH,OAAO,CAAC,KAAK,CAAC,CAAC;YACjB,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,OAAO,CAAC,KAAK,CAAC,sCAAsC,EAAE,GAAG,CAAC,CAAC;YAC7D,CAAC;QACH,CAAC;IACH,CAAC;IAEO,IAAI,CAAC,KAAkB;QAC7B,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC;IAC5B,CAAC;IAED,6EAA6E;IAC7E,kBAAkB;IAClB,6EAA6E;IAE7E,IAAI,CAAC,OAAoB;QACvB,IAAI,IAAI,CAAC,EAAE,EAAE,UAAU,KAAK,SAAS,CAAC,IAAI,EAAE,CAAC;YAC3C,OAAO,CAAC,IAAI,CAAC,8BAA8B,CAAC,CAAC;YAC7C,OAAO;QACT,CAAC;QACD,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC;IACxC,CAAC;IAED,IAAI,CAAC,QAAkC;QACrC,IAAI,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,CAAC;IACxC,CAAC;IAED,YAAY,CAAC,QAAiB;QAC5B,IAAI,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,eAAe,EAAE,QAAQ,EAAE,CAAC,CAAC;IACjD,CAAC;IAED,WAAW;QACT,IAAI,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,cAAc,EAAE,CAAC,CAAC;IACtC,CAAC;IAED,IAAI,CAAC,GAAW,EAAE,GAAY;QAC5B,IAAI,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC,CAAC;IACxC,CAAC;IAED,gBAAgB,CACd,OAAe,EACf,KAAyC,EACzC,OAIC;QAED,IAAI,CAAC,IAAI,CAAC;YACR,IAAI,EAAE,eAAe;YACrB,OAAO;YACP,KAAK;YACL,MAAM,EAAE,OAAO,EAAE,MAAM;YACvB,YAAY,EAAE,OAAO,EAAE,YAAY;YACnC,SAAS,EAAE,OAAO,EAAE,SAAS;SAC9B,CAAC,CAAC;IACL,CAAC;IAED,SAAS;QACP,IAAI,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,YAAY,EAAE,CAAC,CAAC;IACpC,CAAC;IAED,UAAU;QACR,IAAI,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,aAAa,EAAE,CAAC,CAAC;IACrC,CAAC;IAED,6EAA6E;IAC7E,kBAAkB;IAClB,6EAA6E;IAErE,SAAS;QACf,IAAI,CAAC,QAAQ,EAAE,CAAC;QAChB,IAAI,CAAC,cAAc,GAAG,WAAW,CAAC,GAAG,EAAE;YACrC,IAAI,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC;QAC9B,CAAC,EAAE,IAAI,CAAC,YAAY,CAAC,CAAC;IACxB,CAAC;IAEO,QAAQ;QACd,IAAI,IAAI,CAAC,cAAc,EAAE,CAAC;YACxB,aAAa,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;YACnC,IAAI,CAAC,cAAc,GAAG,IAAI,CAAC;QAC7B,CAAC;IACH,CAAC;IAEO,cAAc;QACpB,IAAI,IAAI,CAAC,gBAAgB,EAAE,CAAC;YAC1B,YAAY,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;YACpC,IAAI,CAAC,gBAAgB,GAAG,IAAI,CAAC;QAC/B,CAAC;IACH,CAAC;IAEO,cAAc;QACpB,IAAI,IAAI,CAAC,iBAAiB,IAAI,IAAI,CAAC,oBAAoB,EAAE,CAAC;YACxD,OAAO,CAAC,KAAK,CAAC,uCAAuC,CAAC,CAAC;YACvD,IAAI,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,EAAE,gCAAgC,EAAE,CAAC,CAAC;YACpE,OAAO;QACT,CAAC;QAED,IAAI,CAAC,iBAAiB,EAAE,CAAC;QACzB,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,iBAAiB,CAAC,EAAE,KAAK,CAAC,CAAC;QAC1E,OAAO,CAAC,GAAG,CAAC,kCAAkC,KAAK,IAAI,CAAC,CAAC;QAEzD,IAAI,CAAC,gBAAgB,GAAG,UAAU,CAAC,GAAG,EAAE;YACtC,IAAI,CAAC,OAAO,EAAE,CAAC;QACjB,CAAC,EAAE,KAAK,CAAC,CAAC;IACZ,CAAC;CACF"}
@@ -0,0 +1,27 @@
1
+ /**
2
+ * agent-session client SDK
3
+ *
4
+ * Connect to agent-session Cloudflare Worker via WebSocket.
5
+ *
6
+ * @example
7
+ * ```ts
8
+ * import { AgentSessionClient } from 'agent-session';
9
+ *
10
+ * const client = new AgentSessionClient({
11
+ * url: 'wss://your-agent-session.workers.dev',
12
+ * sessionId: 'doc-123',
13
+ * userId: 'user-456',
14
+ * });
15
+ *
16
+ * client.on('AGENT_MESSAGE', (event) => {
17
+ * console.log('Agent:', event.message);
18
+ * });
19
+ *
20
+ * client.connect();
21
+ * client.sendAgentMessage('Hello!');
22
+ * ```
23
+ */
24
+ export * from '@steventsao/agent-session-core';
25
+ export { AgentSessionClient } from './client';
26
+ export type { AgentSessionClientOptions } from './client';
27
+ //# sourceMappingURL=index.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAGH,cAAc,gCAAgC,CAAC;AAG/C,OAAO,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AAC9C,YAAY,EAAE,yBAAyB,EAAE,MAAM,UAAU,CAAC"}
package/dist/index.js ADDED
@@ -0,0 +1,28 @@
1
+ /**
2
+ * agent-session client SDK
3
+ *
4
+ * Connect to agent-session Cloudflare Worker via WebSocket.
5
+ *
6
+ * @example
7
+ * ```ts
8
+ * import { AgentSessionClient } from 'agent-session';
9
+ *
10
+ * const client = new AgentSessionClient({
11
+ * url: 'wss://your-agent-session.workers.dev',
12
+ * sessionId: 'doc-123',
13
+ * userId: 'user-456',
14
+ * });
15
+ *
16
+ * client.on('AGENT_MESSAGE', (event) => {
17
+ * console.log('Agent:', event.message);
18
+ * });
19
+ *
20
+ * client.connect();
21
+ * client.sendAgentMessage('Hello!');
22
+ * ```
23
+ */
24
+ // Re-export types from core
25
+ export * from '@steventsao/agent-session-core';
26
+ // Export client
27
+ export { AgentSessionClient } from './client';
28
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,4BAA4B;AAC5B,cAAc,gCAAgC,CAAC;AAE/C,gBAAgB;AAChB,OAAO,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC"}
@@ -0,0 +1,26 @@
1
+ /**
2
+ * React bindings for agent-session
3
+ *
4
+ * @example
5
+ * ```tsx
6
+ * import { useAgentSession } from 'agent-session/react';
7
+ *
8
+ * function Chat() {
9
+ * const { messages, sendMessage, isConnected } = useAgentSession({
10
+ * url: 'wss://your-agent-session.workers.dev',
11
+ * sessionId: 'doc-123',
12
+ * });
13
+ *
14
+ * return (
15
+ * <div>
16
+ * {messages.map(m => <p key={m.id}>{m.content}</p>)}
17
+ * <button onClick={() => sendMessage('Hello!')}>Send</button>
18
+ * </div>
19
+ * );
20
+ * }
21
+ * ```
22
+ */
23
+ export { useAgentSession } from './use-agent-session';
24
+ export type { UseAgentSessionOptions, UseAgentSessionReturn, AgentMessage } from './use-agent-session';
25
+ export * from '@steventsao/agent-session-core';
26
+ //# sourceMappingURL=react.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"react.d.ts","sourceRoot":"","sources":["../src/react.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AACtD,YAAY,EAAE,sBAAsB,EAAE,qBAAqB,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAGvG,cAAc,gCAAgC,CAAC"}
package/dist/react.js ADDED
@@ -0,0 +1,26 @@
1
+ /**
2
+ * React bindings for agent-session
3
+ *
4
+ * @example
5
+ * ```tsx
6
+ * import { useAgentSession } from 'agent-session/react';
7
+ *
8
+ * function Chat() {
9
+ * const { messages, sendMessage, isConnected } = useAgentSession({
10
+ * url: 'wss://your-agent-session.workers.dev',
11
+ * sessionId: 'doc-123',
12
+ * });
13
+ *
14
+ * return (
15
+ * <div>
16
+ * {messages.map(m => <p key={m.id}>{m.content}</p>)}
17
+ * <button onClick={() => sendMessage('Hello!')}>Send</button>
18
+ * </div>
19
+ * );
20
+ * }
21
+ * ```
22
+ */
23
+ export { useAgentSession } from './use-agent-session';
24
+ // Re-export core types for convenience
25
+ export * from '@steventsao/agent-session-core';
26
+ //# sourceMappingURL=react.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"react.js","sourceRoot":"","sources":["../src/react.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAGtD,uCAAuC;AACvC,cAAc,gCAAgC,CAAC"}
@@ -0,0 +1,59 @@
1
+ /**
2
+ * React Hook for agent-session
3
+ */
4
+ import type { ServerEvent, SandboxLifecycle, SandboxStatus, ContentBlock } from '@steventsao/agent-session-core';
5
+ export interface AgentMessage {
6
+ id: string;
7
+ role: 'user' | 'assistant';
8
+ content: string | ContentBlock[];
9
+ timestamp: number;
10
+ }
11
+ export interface UseAgentSessionOptions {
12
+ /** WebSocket base URL (e.g., wss://your-worker.workers.dev) */
13
+ url: string;
14
+ /** Session ID to connect to */
15
+ sessionId?: string;
16
+ /** User ID for session tracking */
17
+ userId?: string;
18
+ /** Auto-connect on mount (default: true if sessionId provided) */
19
+ autoConnect?: boolean;
20
+ /** Event callbacks */
21
+ onLifecycle?: (phase: SandboxLifecycle, message?: string) => void;
22
+ onAgentMessage?: (event: ServerEvent) => void;
23
+ onError?: (error: string) => void;
24
+ }
25
+ export interface UseAgentSessionReturn {
26
+ isConnected: boolean;
27
+ clientId: string | null;
28
+ sessionId: string | null;
29
+ sandboxStatus: SandboxStatus;
30
+ sandboxId: string | null;
31
+ sandboxUrl: string | null;
32
+ lifecycle: SandboxLifecycle;
33
+ lifecycleMessage: string | null;
34
+ agentStatus: 'idle' | 'streaming' | 'error';
35
+ agentSessionId: string | null;
36
+ messages: AgentMessage[];
37
+ error: string | null;
38
+ connect: (sessionId: string, userId?: string) => void;
39
+ disconnect: () => void;
40
+ startSandbox: (template?: string) => void;
41
+ stopSandbox: () => void;
42
+ exec: (cmd: string, cwd?: string) => void;
43
+ sendMessage: (content: string, model?: {
44
+ id: string;
45
+ provider?: string;
46
+ }, options?: {
47
+ config?: {
48
+ temperature?: number;
49
+ maxTokens?: number;
50
+ };
51
+ systemPrompt?: string;
52
+ agentType?: string;
53
+ }) => void;
54
+ stopAgent: () => void;
55
+ resetAgent: () => void;
56
+ clearMessages: () => void;
57
+ }
58
+ export declare function useAgentSession(options: UseAgentSessionOptions): UseAgentSessionReturn;
59
+ //# sourceMappingURL=use-agent-session.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"use-agent-session.d.ts","sourceRoot":"","sources":["../src/use-agent-session.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,OAAO,KAAK,EACV,WAAW,EACX,gBAAgB,EAChB,aAAa,EACb,YAAY,EACb,MAAM,gCAAgC,CAAC;AAExC,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,GAAG,WAAW,CAAC;IAC3B,OAAO,EAAE,MAAM,GAAG,YAAY,EAAE,CAAC;IACjC,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,sBAAsB;IACrC,+DAA+D;IAC/D,GAAG,EAAE,MAAM,CAAC;IACZ,+BAA+B;IAC/B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,mCAAmC;IACnC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,kEAAkE;IAClE,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,sBAAsB;IACtB,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE,gBAAgB,EAAE,OAAO,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;IAClE,cAAc,CAAC,EAAE,CAAC,KAAK,EAAE,WAAW,KAAK,IAAI,CAAC;IAC9C,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;CACnC;AAED,MAAM,WAAW,qBAAqB;IAEpC,WAAW,EAAE,OAAO,CAAC;IACrB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IAGzB,aAAa,EAAE,aAAa,CAAC;IAC7B,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,SAAS,EAAE,gBAAgB,CAAC;IAC5B,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IAGhC,WAAW,EAAE,MAAM,GAAG,WAAW,GAAG,OAAO,CAAC;IAC5C,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAG9B,QAAQ,EAAE,YAAY,EAAE,CAAC;IAGzB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAGrB,OAAO,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;IACtD,UAAU,EAAE,MAAM,IAAI,CAAC;IACvB,YAAY,EAAE,CAAC,QAAQ,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;IAC1C,WAAW,EAAE,MAAM,IAAI,CAAC;IACxB,IAAI,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;IAC1C,WAAW,EAAE,CACX,OAAO,EAAE,MAAM,EACf,KAAK,CAAC,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,EACzC,OAAO,CAAC,EAAE;QACR,MAAM,CAAC,EAAE;YAAE,WAAW,CAAC,EAAE,MAAM,CAAC;YAAC,SAAS,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC;QACtD,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB,KACE,IAAI,CAAC;IACV,SAAS,EAAE,MAAM,IAAI,CAAC;IACtB,UAAU,EAAE,MAAM,IAAI,CAAC;IACvB,aAAa,EAAE,MAAM,IAAI,CAAC;CAC3B;AAED,wBAAgB,eAAe,CAAC,OAAO,EAAE,sBAAsB,GAAG,qBAAqB,CAwOtF"}
@@ -0,0 +1,183 @@
1
+ /**
2
+ * React Hook for agent-session
3
+ */
4
+ import { useEffect, useState, useCallback, useRef } from 'react';
5
+ import { AgentSessionClient } from './client';
6
+ export function useAgentSession(options) {
7
+ const { url, sessionId, userId, autoConnect = true, onLifecycle, onAgentMessage, onError } = options;
8
+ const clientRef = useRef(null);
9
+ // Connection state
10
+ const [isConnected, setIsConnected] = useState(false);
11
+ const [clientId, setClientId] = useState(null);
12
+ const [connectedSessionId, setConnectedSessionId] = useState(null);
13
+ // Sandbox state
14
+ const [sandboxStatus, setSandboxStatus] = useState('idle');
15
+ const [sandboxId, setSandboxId] = useState(null);
16
+ const [sandboxUrl, setSandboxUrl] = useState(null);
17
+ const [lifecycle, setLifecycle] = useState('idle');
18
+ const [lifecycleMessage, setLifecycleMessage] = useState(null);
19
+ // Agent state
20
+ const [agentStatus, setAgentStatus] = useState('idle');
21
+ const [agentSessionId, setAgentSessionId] = useState(null);
22
+ const [messages, setMessages] = useState([]);
23
+ // Error state
24
+ const [error, setError] = useState(null);
25
+ // Initialize client when sessionId is available
26
+ useEffect(() => {
27
+ if (!sessionId)
28
+ return;
29
+ const client = new AgentSessionClient({
30
+ url,
31
+ sessionId,
32
+ userId,
33
+ autoConnect: false,
34
+ });
35
+ clientRef.current = client;
36
+ // Set up event handlers
37
+ const unsubscribers = [];
38
+ unsubscribers.push(client.on('CONNECTED', (event) => {
39
+ setIsConnected(true);
40
+ setClientId(event.clientId);
41
+ setConnectedSessionId(event.sessionId);
42
+ setError(null);
43
+ }));
44
+ unsubscribers.push(client.on('READY', (event) => {
45
+ setSandboxId(event.sandboxId);
46
+ setSandboxUrl(event.sandboxUrl);
47
+ }));
48
+ unsubscribers.push(client.on('SANDBOX_STATUS', (event) => {
49
+ setSandboxStatus(event.status);
50
+ if (event.sandboxId)
51
+ setSandboxId(event.sandboxId);
52
+ if (event.sandboxUrl)
53
+ setSandboxUrl(event.sandboxUrl);
54
+ if (event.error)
55
+ setError(event.error);
56
+ }));
57
+ unsubscribers.push(client.on('LIFECYCLE', (event) => {
58
+ setLifecycle(event.phase);
59
+ setLifecycleMessage(event.message || null);
60
+ onLifecycle?.(event.phase, event.message);
61
+ }));
62
+ unsubscribers.push(client.on('AGENT_STARTED', () => {
63
+ setAgentStatus('streaming');
64
+ const id = `msg-${Date.now()}`;
65
+ setMessages((prev) => [
66
+ ...prev,
67
+ { id, role: 'assistant', content: '', timestamp: Date.now() },
68
+ ]);
69
+ }));
70
+ unsubscribers.push(client.on('AGENT_MESSAGE', (event) => {
71
+ onAgentMessage?.(event);
72
+ if (event.message?.content) {
73
+ setMessages((prev) => {
74
+ const lastIdx = prev.length - 1;
75
+ if (lastIdx >= 0 && prev[lastIdx].role === 'assistant') {
76
+ const updated = [...prev];
77
+ updated[lastIdx] = {
78
+ ...updated[lastIdx],
79
+ content: event.message.content,
80
+ };
81
+ return updated;
82
+ }
83
+ return prev;
84
+ });
85
+ }
86
+ }));
87
+ unsubscribers.push(client.on('AGENT_DONE', (event) => {
88
+ setAgentStatus('idle');
89
+ if (event.sessionId)
90
+ setAgentSessionId(event.sessionId);
91
+ }));
92
+ unsubscribers.push(client.on('AGENT_ERROR', (event) => {
93
+ setAgentStatus('error');
94
+ setError(event.error);
95
+ onError?.(event.error);
96
+ }));
97
+ unsubscribers.push(client.on('ERROR', (event) => {
98
+ setError(event.msg);
99
+ onError?.(event.msg);
100
+ }));
101
+ unsubscribers.push(client.on('SYSTEM', (event) => {
102
+ if (event.msg === 'Disconnected') {
103
+ setIsConnected(false);
104
+ }
105
+ }));
106
+ // Auto-connect
107
+ if (autoConnect) {
108
+ client.connect();
109
+ }
110
+ return () => {
111
+ unsubscribers.forEach((unsub) => unsub());
112
+ client.disconnect();
113
+ };
114
+ }, [url, sessionId, userId, autoConnect, onLifecycle, onAgentMessage, onError]);
115
+ // Actions
116
+ const connect = useCallback((sid, uid) => {
117
+ if (clientRef.current) {
118
+ clientRef.current.disconnect();
119
+ }
120
+ const client = new AgentSessionClient({
121
+ url,
122
+ sessionId: sid,
123
+ userId: uid,
124
+ autoConnect: true,
125
+ });
126
+ clientRef.current = client;
127
+ }, [url]);
128
+ const disconnect = useCallback(() => {
129
+ clientRef.current?.disconnect();
130
+ setIsConnected(false);
131
+ setClientId(null);
132
+ setConnectedSessionId(null);
133
+ }, []);
134
+ const startSandbox = useCallback((template) => {
135
+ clientRef.current?.startSandbox(template);
136
+ }, []);
137
+ const stopSandbox = useCallback(() => {
138
+ clientRef.current?.stopSandbox();
139
+ }, []);
140
+ const exec = useCallback((cmd, cwd) => {
141
+ clientRef.current?.exec(cmd, cwd);
142
+ }, []);
143
+ const sendMessage = useCallback((content, model, opts) => {
144
+ const id = `msg-${Date.now()}`;
145
+ setMessages((prev) => [...prev, { id, role: 'user', content, timestamp: Date.now() }]);
146
+ setError(null);
147
+ clientRef.current?.sendAgentMessage(content, model, opts);
148
+ }, []);
149
+ const stopAgent = useCallback(() => {
150
+ clientRef.current?.stopAgent();
151
+ }, []);
152
+ const resetAgent = useCallback(() => {
153
+ clientRef.current?.resetAgent();
154
+ setAgentSessionId(null);
155
+ }, []);
156
+ const clearMessages = useCallback(() => {
157
+ setMessages([]);
158
+ }, []);
159
+ return {
160
+ isConnected,
161
+ clientId,
162
+ sessionId: connectedSessionId,
163
+ sandboxStatus,
164
+ sandboxId,
165
+ sandboxUrl,
166
+ lifecycle,
167
+ lifecycleMessage,
168
+ agentStatus,
169
+ agentSessionId,
170
+ messages,
171
+ error,
172
+ connect,
173
+ disconnect,
174
+ startSandbox,
175
+ stopSandbox,
176
+ exec,
177
+ sendMessage,
178
+ stopAgent,
179
+ resetAgent,
180
+ clearMessages,
181
+ };
182
+ }
183
+ //# sourceMappingURL=use-agent-session.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"use-agent-session.js","sourceRoot":"","sources":["../src/use-agent-session.ts"],"names":[],"mappings":"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"}
package/package.json ADDED
@@ -0,0 +1,49 @@
1
+ {
2
+ "name": "@steventsao/agent-session",
3
+ "version": "0.1.0",
4
+ "description": "Client SDK for agent-session - WebSocket sessions with E2B sandboxes and AI agents",
5
+ "type": "module",
6
+ "main": "dist/index.js",
7
+ "types": "dist/index.d.ts",
8
+ "exports": {
9
+ ".": {
10
+ "types": "./dist/index.d.ts",
11
+ "import": "./dist/index.js"
12
+ },
13
+ "./react": {
14
+ "types": "./dist/react.d.ts",
15
+ "import": "./dist/react.js"
16
+ }
17
+ },
18
+ "files": [
19
+ "dist"
20
+ ],
21
+ "scripts": {
22
+ "build": "tsc",
23
+ "dev": "tsc --watch"
24
+ },
25
+ "dependencies": {
26
+ "@steventsao/agent-session-core": "^0.1.0"
27
+ },
28
+ "devDependencies": {
29
+ "@types/react": "^18.0.0",
30
+ "typescript": "^5.0.0"
31
+ },
32
+ "peerDependencies": {
33
+ "react": ">=18.0.0"
34
+ },
35
+ "peerDependenciesMeta": {
36
+ "react": {
37
+ "optional": true
38
+ }
39
+ },
40
+ "keywords": [
41
+ "websocket",
42
+ "e2b",
43
+ "sandbox",
44
+ "ai-agent",
45
+ "claude",
46
+ "react"
47
+ ],
48
+ "license": "MIT"
49
+ }