The best way to control Claude Code, Codex and more from any computer or phone

main
ts 83 lines 2.55 KB
Raw
1 import { RpcSession, type RpcCompatible, type RpcTransport } from "capnweb";
2
3 /**
4 * A platform-agnostic interface for a server-side WebSocket.
5 */
6 export interface ServerWebSocketLike {
7 send: (message: string) => any;
8 close: (code?: number, reason?: string) => void;
9 }
10
11 /**
12 * Represents a websocket RPC session with capnweb.
13 * Use the `dispatch` object to handle messages that are received from the client.
14 */
15 export type ServerRpcSession<T extends RpcCompatible<T>> = ReturnType<
16 typeof makeServerRpcSession<T>
17 >;
18
19 /**
20 * Constructs a ServerRpcSession using capnweb.
21 * @param ws - The WebSocket to use for the session.
22 * @param main - The main object to use for the session.
23 * @returns A ServerRpcSession.
24 */
25 export function makeServerRpcSession<T extends RpcCompatible<T>>(ws: ServerWebSocketLike, main: T) {
26 const { transport, dispatch } = makeWebSocketRpcTransport(ws);
27 const session = new RpcSession(transport, main);
28 return { session, dispatch };
29 }
30
31 function makeWebSocketRpcTransport(ws: ServerWebSocketLike) {
32 let receiveQueue: Array<string> = [];
33 let receiveResolver: ((value: string) => void) | undefined;
34 let receiveRejecter: ((reason: unknown) => void) | undefined;
35 let error: unknown;
36 return {
37 transport: {
38 send: async (message: string) => await ws.send(message),
39 receive: async () => {
40 const next = receiveQueue.shift();
41 if (next) {
42 return next;
43 } else if (error) {
44 throw error;
45 }
46 return new Promise<string>((resolve, reject) => {
47 receiveResolver = resolve;
48 receiveRejecter = reject;
49 });
50 },
51 abort: (reason: unknown) => {
52 const message = reason instanceof Error ? reason.message : String(reason);
53 ws.close(3000, message);
54 error ??= reason;
55 },
56 } satisfies RpcTransport,
57 dispatch: {
58 message: (data: string | Buffer<ArrayBuffer>) => {
59 if (error) {
60 return;
61 }
62 data = typeof data === "string" ? data : data.toString();
63 if (receiveResolver) {
64 receiveResolver(data);
65 receiveResolver = undefined;
66 receiveRejecter = undefined;
67 } else {
68 receiveQueue.push(data);
69 }
70 },
71 close: (code: number, reason: string) => {
72 if (!error) {
73 error = new Error(`WebSocket closed with code ${code}: ${reason}`);
74 if (receiveRejecter) {
75 receiveRejecter(error);
76 receiveRejecter = undefined;
77 receiveResolver = undefined;
78 }
79 }
80 },
81 },
82 };
83 }