@claude-studio/shared 0.1.0

package/dist/__tests__/protocol.test.d.ts

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

package/dist/__tests__/protocol.test.d.ts.map

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

package/dist/__tests__/protocol.test.js

@@ -0,0 +1,70 @@
+import { describe, it, expect } from "vitest";
+import { parseClientMessage, serializeServerMessage } from "../protocol.js";
+describe("parseClientMessage", () => {
+    it("parses a ping message", () => {
+        const msg = parseClientMessage('{"type":"ping"}');
+        expect(msg).toEqual({ type: "ping" });
+    });
+    it("parses a prompt message with element data", () => {
+        const raw = JSON.stringify({
+            type: "prompt",
+            route: "/about",
+            element: {
+                tagName: "h1", id: "", classList: ["title"], cssSelector: "h1.title",
+                textContent: "About Us", outerHTML: '<h1 class="title">About Us</h1>',
+                attributes: {}, boundingRect: { top: 100, left: 50, width: 400, height: 40 },
+                computedStyles: { color: "black", backgroundColor: "white", fontSize: "32px", fontFamily: "sans-serif", padding: "0px", margin: "0px" },
+                parentChain: ["body", "main"], siblingCount: 2, childCount: 0
+            },
+            prompt: "Make this red",
+        });
+        const msg = parseClientMessage(raw);
+        expect(msg.type).toBe("prompt");
+    });
+    it("parses a raw_prompt message", () => {
+        const msg = parseClientMessage('{"type":"raw_prompt","prompt":"hello"}');
+        expect(msg).toEqual({ type: "raw_prompt", prompt: "hello" });
+    });
+    it("parses a reset_session message", () => {
+        const msg = parseClientMessage('{"type":"reset_session"}');
+        expect(msg).toEqual({ type: "reset_session" });
+    });
+    it("throws on invalid JSON", () => {
+        expect(() => parseClientMessage("not json")).toThrow();
+    });
+    it("throws on missing type field", () => {
+        expect(() => parseClientMessage('{"data":"hello"}')).toThrow("missing type");
+    });
+    it("throws on non-object message", () => {
+        expect(() => parseClientMessage('"just a string"')).toThrow("missing type");
+    });
+});
+describe("serializeServerMessage", () => {
+    it("serializes a connected message", () => {
+        const json = serializeServerMessage({ type: "connected", clientId: "abc-123" });
+        const parsed = JSON.parse(json);
+        expect(parsed.type).toBe("connected");
+        expect(parsed.clientId).toBe("abc-123");
+    });
+    it("serializes a streaming message", () => {
+        const json = serializeServerMessage({ type: "ai_streaming", chunk: "Hello " });
+        expect(JSON.parse(json).chunk).toBe("Hello ");
+    });
+    it("serializes a pong message", () => {
+        const json = serializeServerMessage({ type: "pong" });
+        expect(JSON.parse(json).type).toBe("pong");
+    });
+    it("serializes an ai_complete message", () => {
+        const json = serializeServerMessage({
+            type: "ai_complete", result: "Done", sessionId: "s1", cost: 0.05, turns: 3
+        });
+        const parsed = JSON.parse(json);
+        expect(parsed.sessionId).toBe("s1");
+        expect(parsed.cost).toBe(0.05);
+    });
+    it("serializes an ai_error message", () => {
+        const json = serializeServerMessage({ type: "ai_error", error: "something broke" });
+        expect(JSON.parse(json).error).toBe("something broke");
+    });
+});
+//# sourceMappingURL=protocol.test.js.map

package/dist/__tests__/protocol.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"protocol.test.js","sourceRoot":"","sources":["../../src/__tests__/protocol.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAA;AAC7C,OAAO,EAAE,kBAAkB,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAA;AAE3E,QAAQ,CAAC,oBAAoB,EAAE,GAAG,EAAE;IAClC,EAAE,CAAC,uBAAuB,EAAE,GAAG,EAAE;QAC/B,MAAM,GAAG,GAAG,kBAAkB,CAAC,iBAAiB,CAAC,CAAA;QACjD,MAAM,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAA;IACvC,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,2CAA2C,EAAE,GAAG,EAAE;QACnD,MAAM,GAAG,GAAG,IAAI,CAAC,SAAS,CAAC;YACzB,IAAI,EAAE,QAAQ;YACd,KAAK,EAAE,QAAQ;YACf,OAAO,EAAE;gBACP,OAAO,EAAE,IAAI,EAAE,EAAE,EAAE,EAAE,EAAE,SAAS,EAAE,CAAC,OAAO,CAAC,EAAE,WAAW,EAAE,UAAU;gBACpE,WAAW,EAAE,UAAU,EAAE,SAAS,EAAE,iCAAiC;gBACrE,UAAU,EAAE,EAAE,EAAE,YAAY,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,EAAE,EAAE;gBAC5E,cAAc,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,eAAe,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,YAAY,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE;gBACvI,WAAW,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,YAAY,EAAE,CAAC,EAAE,UAAU,EAAE,CAAC;aAC9D;YACD,MAAM,EAAE,eAAe;SACxB,CAAC,CAAA;QACF,MAAM,GAAG,GAAG,kBAAkB,CAAC,GAAG,CAAC,CAAA;QACnC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAA;IACjC,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,6BAA6B,EAAE,GAAG,EAAE;QACrC,MAAM,GAAG,GAAG,kBAAkB,CAAC,wCAAwC,CAAC,CAAA;QACxE,MAAM,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,YAAY,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,CAAA;IAC9D,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,gCAAgC,EAAE,GAAG,EAAE;QACxC,MAAM,GAAG,GAAG,kBAAkB,CAAC,0BAA0B,CAAC,CAAA;QAC1D,MAAM,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,eAAe,EAAE,CAAC,CAAA;IAChD,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,wBAAwB,EAAE,GAAG,EAAE;QAChC,MAAM,CAAC,GAAG,EAAE,CAAC,kBAAkB,CAAC,UAAU,CAAC,CAAC,CAAC,OAAO,EAAE,CAAA;IACxD,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,8BAA8B,EAAE,GAAG,EAAE;QACtC,MAAM,CAAC,GAAG,EAAE,CAAC,kBAAkB,CAAC,kBAAkB,CAAC,CAAC,CAAC,OAAO,CAAC,cAAc,CAAC,CAAA;IAC9E,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,8BAA8B,EAAE,GAAG,EAAE;QACtC,MAAM,CAAC,GAAG,EAAE,CAAC,kBAAkB,CAAC,iBAAiB,CAAC,CAAC,CAAC,OAAO,CAAC,cAAc,CAAC,CAAA;IAC7E,CAAC,CAAC,CAAA;AACJ,CAAC,CAAC,CAAA;AAEF,QAAQ,CAAC,wBAAwB,EAAE,GAAG,EAAE;IACtC,EAAE,CAAC,gCAAgC,EAAE,GAAG,EAAE;QACxC,MAAM,IAAI,GAAG,sBAAsB,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,QAAQ,EAAE,SAAS,EAAE,CAAC,CAAA;QAC/E,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;QAC/B,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,CAAA;QACrC,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAA;IACzC,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,gCAAgC,EAAE,GAAG,EAAE;QACxC,MAAM,IAAI,GAAG,sBAAsB,CAAC,EAAE,IAAI,EAAE,cAAc,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAA;QAC9E,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAA;IAC/C,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,2BAA2B,EAAE,GAAG,EAAE;QACnC,MAAM,IAAI,GAAG,sBAAsB,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAA;QACrD,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAA;IAC5C,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,mCAAmC,EAAE,GAAG,EAAE;QAC3C,MAAM,IAAI,GAAG,sBAAsB,CAAC;YAClC,IAAI,EAAE,aAAa,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC;SAC3E,CAAC,CAAA;QACF,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;QAC/B,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QACnC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IAChC,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,gCAAgC,EAAE,GAAG,EAAE;QACxC,MAAM,IAAI,GAAG,sBAAsB,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,iBAAiB,EAAE,CAAC,CAAA;QACnF,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAA;IACxD,CAAC,CAAC,CAAA;AACJ,CAAC,CAAC,CAAA"}

package/dist/element-selection.d.ts

@@ -0,0 +1,27 @@
+export interface ElementSelection {
+    tagName: string;
+    id: string;
+    classList: string[];
+    cssSelector: string;
+    textContent: string;
+    outerHTML: string;
+    attributes: Record<string, string>;
+    boundingRect: {
+        top: number;
+        left: number;
+        width: number;
+        height: number;
+    };
+    computedStyles: {
+        color: string;
+        backgroundColor: string;
+        fontSize: string;
+        fontFamily: string;
+        padding: string;
+        margin: string;
+    };
+    parentChain: string[];
+    siblingCount: number;
+    childCount: number;
+}
+//# sourceMappingURL=element-selection.d.ts.map

package/dist/element-selection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"element-selection.d.ts","sourceRoot":"","sources":["../src/element-selection.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,MAAM,CAAA;IACf,EAAE,EAAE,MAAM,CAAA;IACV,SAAS,EAAE,MAAM,EAAE,CAAA;IACnB,WAAW,EAAE,MAAM,CAAA;IACnB,WAAW,EAAE,MAAM,CAAA;IACnB,SAAS,EAAE,MAAM,CAAA;IACjB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAClC,YAAY,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAA;IAC1E,cAAc,EAAE;QACd,KAAK,EAAE,MAAM,CAAA;QACb,eAAe,EAAE,MAAM,CAAA;QACvB,QAAQ,EAAE,MAAM,CAAA;QAChB,UAAU,EAAE,MAAM,CAAA;QAClB,OAAO,EAAE,MAAM,CAAA;QACf,MAAM,EAAE,MAAM,CAAA;KACf,CAAA;IACD,WAAW,EAAE,MAAM,EAAE,CAAA;IACrB,YAAY,EAAE,MAAM,CAAA;IACpB,UAAU,EAAE,MAAM,CAAA;CACnB"}

package/dist/element-selection.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=element-selection.js.map

package/dist/element-selection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"element-selection.js","sourceRoot":"","sources":["../src/element-selection.ts"],"names":[],"mappings":""}

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+export * from "./protocol.js";
+export * from "./element-selection.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAA;AAC7B,cAAc,wBAAwB,CAAA"}

package/dist/index.js

@@ -0,0 +1,3 @@
+export * from "./protocol.js";
+export * from "./element-selection.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAA;AAC7B,cAAc,wBAAwB,CAAA"}

package/dist/protocol.d.ts

@@ -0,0 +1,42 @@
+import type { ElementSelection } from "./element-selection.js";
+export type ClientMessage = {
+    type: "ping";
+} | {
+    type: "prompt";
+    route: string;
+    element: ElementSelection;
+    prompt: string;
+} | {
+    type: "raw_prompt";
+    prompt: string;
+} | {
+    type: "reset_session";
+};
+export type ServerMessage = {
+    type: "connected";
+    clientId: string;
+} | {
+    type: "pong";
+} | {
+    type: "ai_streaming";
+    chunk: string;
+} | {
+    type: "tool_use";
+    tool: string;
+    input: Record<string, unknown>;
+} | {
+    type: "ai_complete";
+    result: string;
+    sessionId: string;
+    cost: number;
+    turns: number;
+} | {
+    type: "ai_error";
+    error: string;
+} | {
+    type: "session_reset";
+    newSessionId: string;
+};
+export declare function parseClientMessage(raw: string): ClientMessage;
+export declare function serializeServerMessage(msg: ServerMessage): string;
+//# sourceMappingURL=protocol.d.ts.map

package/dist/protocol.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"protocol.d.ts","sourceRoot":"","sources":["../src/protocol.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAA;AAG9D,MAAM,MAAM,aAAa,GACrB;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAChB;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,gBAAgB,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAC5E;IAAE,IAAI,EAAE,YAAY,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GACtC;IAAE,IAAI,EAAE,eAAe,CAAA;CAAE,CAAA;AAG7B,MAAM,MAAM,aAAa,GACrB;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GACvC;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAChB;IAAE,IAAI,EAAE,cAAc,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GACvC;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE,GAClE;IAAE,IAAI,EAAE,aAAa,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GACvF;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GACnC;IAAE,IAAI,EAAE,eAAe,CAAC;IAAC,YAAY,EAAE,MAAM,CAAA;CAAE,CAAA;AAEnD,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,aAAa,CAM7D;AAED,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,aAAa,GAAG,MAAM,CAEjE"}

package/dist/protocol.js

@@ -0,0 +1,11 @@
+export function parseClientMessage(raw) {
+    const msg = JSON.parse(raw);
+    if (!msg || typeof msg.type !== "string") {
+        throw new Error("Invalid message: missing type field");
+    }
+    return msg;
+}
+export function serializeServerMessage(msg) {
+    return JSON.stringify(msg);
+}
+//# sourceMappingURL=protocol.js.map

package/dist/protocol.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"protocol.js","sourceRoot":"","sources":["../src/protocol.ts"],"names":[],"mappings":"AAmBA,MAAM,UAAU,kBAAkB,CAAC,GAAW;IAC5C,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAA;IAC3B,IAAI,CAAC,GAAG,IAAI,OAAO,GAAG,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;QACzC,MAAM,IAAI,KAAK,CAAC,qCAAqC,CAAC,CAAA;IACxD,CAAC;IACD,OAAO,GAAoB,CAAA;AAC7B,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,GAAkB;IACvD,OAAO,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,CAAA;AAC5B,CAAC"}

package/package.json

@@ -0,0 +1,20 @@
+{
+  "name": "@claude-studio/shared",
+  "version": "0.1.0",
+  "type": "module",
+  "publishConfig": {
+    "access": "public"
+  },
+  "main": "dist/index.js",
+  "exports": {
+    ".": "./dist/index.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "test": "vitest run"
+  },
+  "devDependencies": {
+    "typescript": "^5.0.0",
+    "vitest": "^3.0.0"
+  }
+}

package/src/__tests__/protocol.test.ts

@@ -0,0 +1,81 @@
+import { describe, it, expect } from "vitest"
+import { parseClientMessage, serializeServerMessage } from "../protocol.js"
+
+describe("parseClientMessage", () => {
+  it("parses a ping message", () => {
+    const msg = parseClientMessage('{"type":"ping"}')
+    expect(msg).toEqual({ type: "ping" })
+  })
+
+  it("parses a prompt message with element data", () => {
+    const raw = JSON.stringify({
+      type: "prompt",
+      route: "/about",
+      element: {
+        tagName: "h1", id: "", classList: ["title"], cssSelector: "h1.title",
+        textContent: "About Us", outerHTML: '<h1 class="title">About Us</h1>',
+        attributes: {}, boundingRect: { top: 100, left: 50, width: 400, height: 40 },
+        computedStyles: { color: "black", backgroundColor: "white", fontSize: "32px", fontFamily: "sans-serif", padding: "0px", margin: "0px" },
+        parentChain: ["body", "main"], siblingCount: 2, childCount: 0
+      },
+      prompt: "Make this red",
+    })
+    const msg = parseClientMessage(raw)
+    expect(msg.type).toBe("prompt")
+  })
+
+  it("parses a raw_prompt message", () => {
+    const msg = parseClientMessage('{"type":"raw_prompt","prompt":"hello"}')
+    expect(msg).toEqual({ type: "raw_prompt", prompt: "hello" })
+  })
+
+  it("parses a reset_session message", () => {
+    const msg = parseClientMessage('{"type":"reset_session"}')
+    expect(msg).toEqual({ type: "reset_session" })
+  })
+
+  it("throws on invalid JSON", () => {
+    expect(() => parseClientMessage("not json")).toThrow()
+  })
+
+  it("throws on missing type field", () => {
+    expect(() => parseClientMessage('{"data":"hello"}')).toThrow("missing type")
+  })
+
+  it("throws on non-object message", () => {
+    expect(() => parseClientMessage('"just a string"')).toThrow("missing type")
+  })
+})
+
+describe("serializeServerMessage", () => {
+  it("serializes a connected message", () => {
+    const json = serializeServerMessage({ type: "connected", clientId: "abc-123" })
+    const parsed = JSON.parse(json)
+    expect(parsed.type).toBe("connected")
+    expect(parsed.clientId).toBe("abc-123")
+  })
+
+  it("serializes a streaming message", () => {
+    const json = serializeServerMessage({ type: "ai_streaming", chunk: "Hello " })
+    expect(JSON.parse(json).chunk).toBe("Hello ")
+  })
+
+  it("serializes a pong message", () => {
+    const json = serializeServerMessage({ type: "pong" })
+    expect(JSON.parse(json).type).toBe("pong")
+  })
+
+  it("serializes an ai_complete message", () => {
+    const json = serializeServerMessage({
+      type: "ai_complete", result: "Done", sessionId: "s1", cost: 0.05, turns: 3
+    })
+    const parsed = JSON.parse(json)
+    expect(parsed.sessionId).toBe("s1")
+    expect(parsed.cost).toBe(0.05)
+  })
+
+  it("serializes an ai_error message", () => {
+    const json = serializeServerMessage({ type: "ai_error", error: "something broke" })
+    expect(JSON.parse(json).error).toBe("something broke")
+  })
+})

package/src/element-selection.ts

@@ -0,0 +1,21 @@
+export interface ElementSelection {
+  tagName: string
+  id: string
+  classList: string[]
+  cssSelector: string
+  textContent: string
+  outerHTML: string
+  attributes: Record<string, string>
+  boundingRect: { top: number; left: number; width: number; height: number }
+  computedStyles: {
+    color: string
+    backgroundColor: string
+    fontSize: string
+    fontFamily: string
+    padding: string
+    margin: string
+  }
+  parentChain: string[]
+  siblingCount: number
+  childCount: number
+}

package/src/index.ts

@@ -0,0 +1,2 @@
+export * from "./protocol.js"
+export * from "./element-selection.js"

package/src/protocol.ts

@@ -0,0 +1,30 @@
+import type { ElementSelection } from "./element-selection.js"
+
+// --- Client → Server ---
+export type ClientMessage =
+  | { type: "ping" }
+  | { type: "prompt"; route: string; element: ElementSelection; prompt: string }
+  | { type: "raw_prompt"; prompt: string }
+  | { type: "reset_session" }
+
+// --- Server → Client ---
+export type ServerMessage =
+  | { type: "connected"; clientId: string }
+  | { type: "pong" }
+  | { type: "ai_streaming"; chunk: string }
+  | { type: "tool_use"; tool: string; input: Record<string, unknown> }
+  | { type: "ai_complete"; result: string; sessionId: string; cost: number; turns: number }
+  | { type: "ai_error"; error: string }
+  | { type: "session_reset"; newSessionId: string }
+
+export function parseClientMessage(raw: string): ClientMessage {
+  const msg = JSON.parse(raw)
+  if (!msg || typeof msg.type !== "string") {
+    throw new Error("Invalid message: missing type field")
+  }
+  return msg as ClientMessage
+}
+
+export function serializeServerMessage(msg: ServerMessage): string {
+  return JSON.stringify(msg)
+}

package/tsconfig.json

@@ -0,0 +1,8 @@
+{
+  "extends": "../../tsconfig.base.json",
+  "compilerOptions": {
+    "rootDir": "src",
+    "outDir": "dist"
+  },
+  "include": ["src"]
+}

package/vitest.config.ts

@@ -0,0 +1,7 @@
+import { defineConfig } from "vitest/config"
+
+export default defineConfig({
+  test: {
+    include: ["src/**/*.test.ts"],
+  },
+})