acp-websocket-transport 0.1.1

package/dist/tests/server.test.js

@@ -0,0 +1,173 @@
+import { describe, it, expect, beforeAll, afterAll } from "vitest";
+import WebSocket from "ws";
+import { WebSocketACPServer } from "../src/server.js";
+import { bearerAuth } from "../src/auth.js";
+/** Absolute path to the compiled echo-agent. Built by tsc before tests run. */
+const ECHO_AGENT = new URL("../dist/examples/echo-agent.js", import.meta.url)
+    .pathname;
+// ─── helpers ─────────────────────────────────────────────────────────────────
+function openWs(port, headers) {
+    return new Promise((resolve, reject) => {
+        const ws = new WebSocket(`ws://localhost:${port}`, { headers });
+        ws.once("open", () => resolve(ws));
+        ws.once("error", reject);
+    });
+}
+/**
+ * Collects all messages from a WebSocket into a queue.
+ * Returns a function that pops the next message (waiting if necessary).
+ */
+function messageQueue(ws) {
+    const queue = [];
+    const waiters = [];
+    const errorWaiters = [];
+    ws.on("message", (data) => {
+        const msg = JSON.parse(data.toString());
+        const waiter = waiters.shift();
+        if (waiter) {
+            waiter(msg);
+        }
+        else {
+            queue.push(msg);
+        }
+    });
+    ws.on("error", (err) => {
+        for (const ew of errorWaiters.splice(0))
+            ew(err);
+    });
+    ws.on("close", () => {
+        const err = new Error("WebSocket closed");
+        for (const ew of errorWaiters.splice(0))
+            ew(err);
+        for (const w of waiters.splice(0))
+            w({ jsonrpc: "2.0", method: "_closed" });
+    });
+    return () => new Promise((resolve, reject) => {
+        const queued = queue.shift();
+        if (queued != null) {
+            resolve(queued);
+        }
+        else {
+            waiters.push(resolve);
+            errorWaiters.push(reject);
+        }
+    });
+}
+async function sendAndReceive(nextMsg, ws, msg) {
+    const p = nextMsg();
+    ws.send(JSON.stringify(msg));
+    return p;
+}
+// ─── tests ───────────────────────────────────────────────────────────────────
+describe("WebSocketACPServer (no auth)", () => {
+    let server;
+    let port;
+    beforeAll(async () => {
+        server = new WebSocketACPServer({
+            port: 0,
+            command: "node",
+            args: [ECHO_AGENT],
+        });
+        await server.listening();
+        port = server.address.port;
+    });
+    afterAll(async () => {
+        await server.close().catch(() => { });
+    });
+    it("accepts a connection and reflects an initialize request", async () => {
+        const ws = await openWs(port);
+        const nextMsg = messageQueue(ws);
+        const req = {
+            jsonrpc: "2.0",
+            id: 1,
+            method: "initialize",
+            params: {
+                protocolVersion: 0,
+                clientInfo: { name: "test-client", version: "0.0.1" },
+                clientCapabilities: {},
+            },
+        };
+        const response = await sendAndReceive(nextMsg, ws, req);
+        expect(response.id).toBe(1);
+        expect(response.result
+            ?.agentInfo?.name).toBe("echo-agent");
+        ws.close();
+        await new Promise((r) => setTimeout(r, 200));
+    });
+    it("handles multiple sequential requests", async () => {
+        const ws = await openWs(port);
+        const nextMsg = messageQueue(ws);
+        const initReq = {
+            jsonrpc: "2.0",
+            id: 1,
+            method: "initialize",
+            params: {
+                protocolVersion: 0,
+                clientInfo: { name: "test-client", version: "0.0.1" },
+                clientCapabilities: {},
+            },
+        };
+        await sendAndReceive(nextMsg, ws, initReq);
+        const sessionReq = {
+            jsonrpc: "2.0",
+            id: 2,
+            method: "session/new",
+            params: {
+                cwd: "/tmp",
+                mcpServers: [],
+            },
+        };
+        const sessionResp = await sendAndReceive(nextMsg, ws, sessionReq);
+        const sessionId = sessionResp
+            .result?.sessionId;
+        expect(typeof sessionId).toBe("string");
+        expect(sessionId.length).toBeGreaterThan(0);
+        ws.close();
+        await new Promise((r) => setTimeout(r, 200));
+    });
+    it("closes the WebSocket when the agent process exits", async () => {
+        const ws = await openWs(port);
+        const nextMsg = messageQueue(ws);
+        const initReq = {
+            jsonrpc: "2.0",
+            id: 1,
+            method: "initialize",
+            params: { protocolVersion: 0, clientCapabilities: {} },
+        };
+        await sendAndReceive(nextMsg, ws, initReq);
+        const closePromise = new Promise((resolve) => ws.once("close", (code) => resolve(code)));
+        ws.close(1000);
+        const code = await closePromise;
+        expect(code).toBe(1000);
+    });
+});
+describe("WebSocketACPServer (bearer auth)", () => {
+    let server;
+    let port;
+    beforeAll(async () => {
+        server = new WebSocketACPServer({
+            port: 0,
+            command: "node",
+            args: [ECHO_AGENT],
+            verifyClient: bearerAuth(["valid-token"]),
+        });
+        await server.listening();
+        port = server.address.port;
+    });
+    afterAll(async () => {
+        await server.close().catch(() => { });
+    });
+    it("accepts a connection with a valid bearer token", async () => {
+        const ws = await openWs(port, { Authorization: "Bearer valid-token" });
+        expect(ws.readyState).toBe(WebSocket.OPEN);
+        ws.close();
+        await new Promise((r) => setTimeout(r, 300));
+    });
+    it("rejects a connection with an invalid token (HTTP 401)", async () => {
+        await expect(openWs(port, { Authorization: "Bearer wrong-token" })).rejects.toThrow();
+    });
+    it("rejects a connection with no Authorization header", async () => {
+        await expect(openWs(port)).rejects.toThrow();
+    });
+});
+//# sourceMappingURL=server.test.js.map

package/dist/tests/server.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.test.js","sourceRoot":"","sources":["../../tests/server.test.ts"],"names":[],"mappings":"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"}

package/dist/tests/transport.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=transport.test.d.ts.map

package/dist/tests/transport.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport.test.d.ts","sourceRoot":"","sources":["../../tests/transport.test.ts"],"names":[],"mappings":""}

package/dist/tests/transport.test.js

@@ -0,0 +1,137 @@
+import { describe, it, expect, beforeEach, afterEach } from "vitest";
+import WebSocket, { WebSocketServer } from "ws";
+import { wsStream } from "../src/transport.js";
+/** Opens a local WebSocket server and a connected client, returns both sockets. */
+async function createPair() {
+    const wss = new WebSocketServer({ port: 0 });
+    await new Promise((resolve) => wss.once("listening", resolve));
+    const { port } = wss.address();
+    const [serverWs, clientWs] = await new Promise((resolve) => {
+        const client = new WebSocket(`ws://localhost:${port}`);
+        wss.once("connection", (server) => {
+            // Ensure the client open event has also fired
+            if (client.readyState === WebSocket.OPEN) {
+                resolve([server, client]);
+            }
+            else {
+                client.once("open", () => resolve([server, client]));
+            }
+        });
+    });
+    return { wss, serverWs, clientWs };
+}
+describe("wsStream", () => {
+    let wss;
+    let serverWs;
+    let clientWs;
+    beforeEach(async () => {
+        ({ wss, serverWs, clientWs } = await createPair());
+    });
+    afterEach(async () => {
+        // Terminate connections first so wss.close() callback fires promptly
+        serverWs.terminate();
+        clientWs.terminate();
+        await new Promise((resolve) => {
+            wss.close(() => resolve());
+            // Safety timeout in case close callback stalls
+            setTimeout(resolve, 500);
+        });
+    });
+    // ── readable ──────────────────────────────────────────────────────────
+    it("enqueues a parsed AnyMessage when a text frame arrives", async () => {
+        const stream = wsStream(serverWs);
+        const reader = stream.readable.getReader();
+        const msg = {
+            jsonrpc: "2.0",
+            id: 1,
+            method: "ping",
+            params: {},
+        };
+        clientWs.send(JSON.stringify(msg));
+        const { done, value } = await reader.read();
+        expect(done).toBe(false);
+        expect(value).toEqual(msg);
+        reader.releaseLock();
+    });
+    it("ignores binary frames silently", async () => {
+        const stream = wsStream(serverWs);
+        const reader = stream.readable.getReader();
+        // Send a binary frame, then a text frame — only the text one should arrive
+        clientWs.send(Buffer.from([0x01, 0x02, 0x03])); // binary
+        const textMsg = { jsonrpc: "2.0", method: "notify" };
+        clientWs.send(JSON.stringify(textMsg));
+        const { done, value } = await reader.read();
+        expect(done).toBe(false);
+        expect(value).toEqual(textMsg);
+        reader.releaseLock();
+    });
+    it("errors the readable when a malformed JSON frame arrives", async () => {
+        const stream = wsStream(serverWs);
+        const reader = stream.readable.getReader();
+        clientWs.send("not-valid-json{{{");
+        await expect(reader.read()).rejects.toThrow(SyntaxError);
+        reader.releaseLock();
+    });
+    it("closes the readable when the remote WebSocket closes", async () => {
+        const stream = wsStream(serverWs);
+        const reader = stream.readable.getReader();
+        clientWs.close(1000);
+        const { done } = await reader.read();
+        expect(done).toBe(true);
+        reader.releaseLock();
+    });
+    // ── writable ──────────────────────────────────────────────────────────
+    it("sends a JSON text frame when writing to the writable", async () => {
+        const stream = wsStream(clientWs);
+        const writer = stream.writable.getWriter();
+        const received = [];
+        serverWs.on("message", (data) => received.push(data.toString("utf8")));
+        const msg = { jsonrpc: "2.0", method: "notify" };
+        await writer.write(msg);
+        // Wait for the frame to arrive
+        await new Promise((resolve) => {
+            const check = () => received.length > 0 ? resolve() : setTimeout(check, 10);
+            check();
+        });
+        expect(JSON.parse(received[0])).toEqual(msg);
+        writer.releaseLock();
+    });
+    it("serialises multiple writes in order", async () => {
+        const stream = wsStream(clientWs);
+        const writer = stream.writable.getWriter();
+        const received = [];
+        serverWs.on("message", (data) => received.push(JSON.parse(data.toString("utf8"))));
+        const msgs = [
+            { jsonrpc: "2.0", id: 1, method: "first", params: {} },
+            { jsonrpc: "2.0", id: 2, method: "second", params: {} },
+            { jsonrpc: "2.0", id: 3, method: "third", params: {} },
+        ];
+        for (const m of msgs)
+            await writer.write(m);
+        await new Promise((resolve) => {
+            const check = () => received.length >= msgs.length ? resolve() : setTimeout(check, 10);
+            check();
+        });
+        expect(received).toEqual(msgs);
+        writer.releaseLock();
+    });
+    // ── round-trip ────────────────────────────────────────────────────────
+    it("supports a full round-trip through two wsStream instances", async () => {
+        const serverStream = wsStream(serverWs);
+        const clientStream = wsStream(clientWs);
+        const writer = clientStream.writable.getWriter();
+        const reader = serverStream.readable.getReader();
+        const request = {
+            jsonrpc: "2.0",
+            id: 42,
+            method: "session/prompt",
+            params: { sessionId: "s1", text: "hello" },
+        };
+        await writer.write(request);
+        const { value } = await reader.read();
+        expect(value).toEqual(request);
+        writer.releaseLock();
+        reader.releaseLock();
+    });
+});
+//# sourceMappingURL=transport.test.js.map

package/dist/tests/transport.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport.test.js","sourceRoot":"","sources":["../../tests/transport.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAC;AACrE,OAAO,SAAS,EAAE,EAAE,eAAe,EAAE,MAAM,IAAI,CAAC;AAEhD,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAG/C,mFAAmF;AACnF,KAAK,UAAU,UAAU;IAKvB,MAAM,GAAG,GAAG,IAAI,eAAe,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC,CAAC;IAC7C,MAAM,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC,CAAC;IACrE,MAAM,EAAE,IAAI,EAAE,GAAG,GAAG,CAAC,OAAO,EAAiB,CAAC;IAE9C,MAAM,CAAC,QAAQ,EAAE,QAAQ,CAAC,GAAG,MAAM,IAAI,OAAO,CAC5C,CAAC,OAAO,EAAE,EAAE;QACV,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC,kBAAkB,IAAI,EAAE,CAAC,CAAC;QACvD,GAAG,CAAC,IAAI,CAAC,YAAY,EAAE,CAAC,MAAM,EAAE,EAAE;YAChC,8CAA8C;YAC9C,IAAI,MAAM,CAAC,UAAU,KAAK,SAAS,CAAC,IAAI,EAAE,CAAC;gBACzC,OAAO,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;YAC5B,CAAC;iBAAM,CAAC;gBACN,MAAM,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC;YACvD,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC,CACF,CAAC;IAEF,OAAO,EAAE,GAAG,EAAE,QAAQ,EAAE,QAAQ,EAAE,CAAC;AACrC,CAAC;AAED,QAAQ,CAAC,UAAU,EAAE,GAAG,EAAE;IACxB,IAAI,GAAoB,CAAC;IACzB,IAAI,QAAmB,CAAC;IACxB,IAAI,QAAmB,CAAC;IAExB,UAAU,CAAC,KAAK,IAAI,EAAE;QACpB,CAAC,EAAE,GAAG,EAAE,QAAQ,EAAE,QAAQ,EAAE,GAAG,MAAM,UAAU,EAAE,CAAC,CAAC;IACrD,CAAC,CAAC,CAAC;IAEH,SAAS,CAAC,KAAK,IAAI,EAAE;QACnB,qEAAqE;QACrE,QAAQ,CAAC,SAAS,EAAE,CAAC;QACrB,QAAQ,CAAC,SAAS,EAAE,CAAC;QACrB,MAAM,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE;YAClC,GAAG,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,OAAO,EAAE,CAAC,CAAC;YAC3B,+CAA+C;YAC/C,UAAU,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;QAC3B,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,yEAAyE;IAEzE,EAAE,CAAC,wDAAwD,EAAE,KAAK,IAAI,EAAE;QACtE,MAAM,MAAM,GAAG,QAAQ,CAAC,QAAQ,CAAC,CAAC;QAClC,MAAM,MAAM,GAAG,MAAM,CAAC,QAAQ,CAAC,SAAS,EAAE,CAAC;QAE3C,MAAM,GAAG,GAAe;YACtB,OAAO,EAAE,KAAK;YACd,EAAE,EAAE,CAAC;YACL,MAAM,EAAE,MAAM;YACd,MAAM,EAAE,EAAE;SACX,CAAC;QACF,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC;QAEnC,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,MAAM,MAAM,CAAC,IAAI,EAAE,CAAC;QAC5C,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACzB,MAAM,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QAC3B,MAAM,CAAC,WAAW,EAAE,CAAC;IACvB,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,gCAAgC,EAAE,KAAK,IAAI,EAAE;QAC9C,MAAM,MAAM,GAAG,QAAQ,CAAC,QAAQ,CAAC,CAAC;QAClC,MAAM,MAAM,GAAG,MAAM,CAAC,QAAQ,CAAC,SAAS,EAAE,CAAC;QAE3C,2EAA2E;QAC3E,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS;QACzD,MAAM,OAAO,GAAe,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC;QACjE,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC;QAEvC,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,MAAM,MAAM,CAAC,IAAI,EAAE,CAAC;QAC5C,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACzB,MAAM,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QAC/B,MAAM,CAAC,WAAW,EAAE,CAAC;IACvB,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,yDAAyD,EAAE,KAAK,IAAI,EAAE;QACvE,MAAM,MAAM,GAAG,QAAQ,CAAC,QAAQ,CAAC,CAAC;QAClC,MAAM,MAAM,GAAG,MAAM,CAAC,QAAQ,CAAC,SAAS,EAAE,CAAC;QAE3C,QAAQ,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC;QAEnC,MAAM,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;QACzD,MAAM,CAAC,WAAW,EAAE,CAAC;IACvB,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,sDAAsD,EAAE,KAAK,IAAI,EAAE;QACpE,MAAM,MAAM,GAAG,QAAQ,CAAC,QAAQ,CAAC,CAAC;QAClC,MAAM,MAAM,GAAG,MAAM,CAAC,QAAQ,CAAC,SAAS,EAAE,CAAC;QAE3C,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAErB,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,MAAM,CAAC,IAAI,EAAE,CAAC;QACrC,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACxB,MAAM,CAAC,WAAW,EAAE,CAAC;IACvB,CAAC,CAAC,CAAC;IAEH,yEAAyE;IAEzE,EAAE,CAAC,sDAAsD,EAAE,KAAK,IAAI,EAAE;QACpE,MAAM,MAAM,GAAG,QAAQ,CAAC,QAAQ,CAAC,CAAC;QAClC,MAAM,MAAM,GAAG,MAAM,CAAC,QAAQ,CAAC,SAAS,EAAE,CAAC;QAE3C,MAAM,QAAQ,GAAa,EAAE,CAAC;QAC9B,QAAQ,CAAC,EAAE,CAAC,SAAS,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;QAEvE,MAAM,GAAG,GAAe,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC;QAC7D,MAAM,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAExB,+BAA+B;QAC/B,MAAM,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE;YAClC,MAAM,KAAK,GAAG,GAAG,EAAE,CACjB,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;YAC1D,KAAK,EAAE,CAAC;QACV,CAAC,CAAC,CAAC;QAEH,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAE,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QAC9C,MAAM,CAAC,WAAW,EAAE,CAAC;IACvB,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,qCAAqC,EAAE,KAAK,IAAI,EAAE;QACnD,MAAM,MAAM,GAAG,QAAQ,CAAC,QAAQ,CAAC,CAAC;QAClC,MAAM,MAAM,GAAG,MAAM,CAAC,QAAQ,CAAC,SAAS,EAAE,CAAC;QAE3C,MAAM,QAAQ,GAAiB,EAAE,CAAC;QAClC,QAAQ,CAAC,EAAE,CAAC,SAAS,EAAE,CAAC,IAAI,EAAE,EAAE,CAC9B,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAe,CAAC,CAC/D,CAAC;QAEF,MAAM,IAAI,GAAiB;YACzB,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,EAAE,EAAE;YACtD,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE;YACvD,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,EAAE,EAAE;SACvD,CAAC;QACF,KAAK,MAAM,CAAC,IAAI,IAAI;YAAE,MAAM,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QAE5C,MAAM,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE;YAClC,MAAM,KAAK,GAAG,GAAG,EAAE,CACjB,QAAQ,CAAC,MAAM,IAAI,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;YACrE,KAAK,EAAE,CAAC;QACV,CAAC,CAAC,CAAC;QAEH,MAAM,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QAC/B,MAAM,CAAC,WAAW,EAAE,CAAC;IACvB,CAAC,CAAC,CAAC;IAEH,yEAAyE;IAEzE,EAAE,CAAC,2DAA2D,EAAE,KAAK,IAAI,EAAE;QACzE,MAAM,YAAY,GAAG,QAAQ,CAAC,QAAQ,CAAC,CAAC;QACxC,MAAM,YAAY,GAAG,QAAQ,CAAC,QAAQ,CAAC,CAAC;QAExC,MAAM,MAAM,GAAG,YAAY,CAAC,QAAQ,CAAC,SAAS,EAAE,CAAC;QACjD,MAAM,MAAM,GAAG,YAAY,CAAC,QAAQ,CAAC,SAAS,EAAE,CAAC;QAEjD,MAAM,OAAO,GAAe;YAC1B,OAAO,EAAE,KAAK;YACd,EAAE,EAAE,EAAE;YACN,MAAM,EAAE,gBAAgB;YACxB,MAAM,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE;SAC3C,CAAC;QACF,MAAM,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QAE5B,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,MAAM,CAAC,IAAI,EAAE,CAAC;QACtC,MAAM,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QAE/B,MAAM,CAAC,WAAW,EAAE,CAAC;QACrB,MAAM,CAAC,WAAW,EAAE,CAAC;IACvB,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/package.json

@@ -0,0 +1,41 @@
+{
+  "name": "acp-websocket-transport",
+  "version": "0.1.1",
+  "description": "WebSocket transport layer for ACP (Agent Client Protocol) — TypeScript client library",
+  "type": "module",
+  "main": "dist/src/index.js",
+  "types": "dist/src/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/src/index.js",
+      "types": "./dist/src/index.d.ts"
+    }
+  },
+  "files": ["dist"],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "typecheck": "tsc --noEmit",
+    "lint": "eslint src tests examples"
+  },
+  "dependencies": {
+    "ws": "^8.20.0"
+  },
+  "peerDependencies": {
+    "@agentclientprotocol/sdk": "^0.18.2",
+    "zod": "^3.25.0 || ^4.0.0"
+  },
+  "devDependencies": {
+    "@agentclientprotocol/sdk": "^0.18.2",
+    "@types/node": "^22.0.0",
+    "@types/ws": "^8.18.1",
+    "typescript": "^5.8.3",
+    "vitest": "^3.1.1",
+    "zod": "^4.0.0"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}