@clawroom/sdk 0.5.24 → 0.5.26

package/dist/machine-client.js

@@ -0,0 +1,297 @@
+/**
+ * ClawRoom Machine Client — machine-level auth with multi-agent support.
+ * WebSocket primary for real-time push, HTTP polling as fallback.
+ */
+import * as os from "node:os";
+import { WsTransport } from "./ws-transport.js";
+const DEFAULT_AGENT_CHAT_PROFILE = {
+    role: "No role defined",
+    systemPrompt: "No system prompt configured",
+    memory: "No memory recorded yet",
+    continuityPacket: "No continuity packet available yet",
+};
+const MAX_RECENT_CHAT_IDS = 1000;
+export class ClawroomMachineClient {
+    options;
+    heartbeatTimer = null;
+    pollTimer = null;
+    heartbeatInFlight = false;
+    pollInFlight = false;
+    taskHandler = null;
+    chatHandler = null;
+    connectHandler = null;
+    disconnectHandler = null;
+    _connected = false;
+    _stopped = false;
+    wsTransport = null;
+    recentChatIds = new Map();
+    constructor(options) {
+        this.options = options;
+    }
+    get baseUrl() {
+        return this.options.endpoint ?? "http://localhost:3000/api/machines";
+    }
+    get wsUrl() {
+        if (this.options.wsUrl)
+            return this.options.wsUrl;
+        return this.baseUrl.replace(/\/api\/machines$/, "").replace(/^http/, "ws") + "/api/ws";
+    }
+    async httpRequest(method, path, body) {
+        const url = `${this.baseUrl}${path}`;
+        const res = await fetch(url, {
+            method,
+            headers: { "Content-Type": "application/json", Authorization: `Bearer ${this.options.apiKey}` },
+            body: body ? JSON.stringify(body) : undefined,
+        });
+        if (!res.ok)
+            throw new Error(`HTTP ${res.status}: ${await res.text()}`);
+        const text = await res.text();
+        if (!text.trim())
+            return null;
+        try {
+            return JSON.parse(text);
+        }
+        catch (error) {
+            throw new Error(`Invalid JSON from ${path}: ${error instanceof Error ? error.message : "unknown parse error"}`);
+        }
+    }
+    onAgentTask(handler) { this.taskHandler = handler; }
+    onAgentChat(handler) { this.chatHandler = handler; }
+    onConnected(handler) { this.connectHandler = handler; }
+    onDisconnected(handler) { this.disconnectHandler = handler; }
+    async sendAgentComplete(agentId, taskId, output, attachments, workRef) {
+        await this.httpRequest("POST", "/complete", { agentId, taskId, output, attachments, workRef });
+    }
+    async sendAgentFail(agentId, taskId, reason, workRef) {
+        await this.httpRequest("POST", "/fail", { agentId, taskId, reason, workRef });
+    }
+    async sendAgentChatReply(agentId, channelId, content, replyTo, workRefs) {
+        await this.httpRequest("POST", "/chat-reply", { agentId, channelId, content, replyTo, workRefs });
+    }
+    async sendAgentTyping(agentId, channelId) {
+        await this.httpRequest("POST", "/typing", { agentId, channelId });
+    }
+    async sendAgentReflection(agentId, reflection) {
+        await this.httpRequest("POST", "/reflections", { agentId, ...reflection });
+    }
+    get connected() { return this._connected; }
+    get stopped() { return this._stopped; }
+    rememberChat(messageId) {
+        if (!messageId)
+            return false;
+        const now = Date.now();
+        for (const [id, seenAt] of this.recentChatIds) {
+            if (now - seenAt > 10 * 60_000)
+                this.recentChatIds.delete(id);
+        }
+        if (this.recentChatIds.has(messageId))
+            return false;
+        if (this.recentChatIds.size >= MAX_RECENT_CHAT_IDS) {
+            const oldestId = this.recentChatIds.keys().next().value;
+            if (oldestId)
+                this.recentChatIds.delete(oldestId);
+        }
+        this.recentChatIds.set(messageId, now);
+        return true;
+    }
+    markConnected(machineId) {
+        if (!this._connected) {
+            this._connected = true;
+            this.options.log?.info?.("[machine] connected");
+            this.connectHandler?.(machineId);
+        }
+    }
+    markDisconnected() {
+        if (this._connected) {
+            this._connected = false;
+            this.options.log?.warn?.("[machine] disconnected");
+            this.disconnectHandler?.();
+        }
+    }
+    async pollOnce() {
+        if (!this._connected || this.pollInFlight)
+            return;
+        this.pollInFlight = true;
+        try {
+            const result = (await this.httpRequest("POST", "/poll", {}));
+            for (const agent of result.agents) {
+                if (agent.task && this.taskHandler) {
+                    try {
+                        this.taskHandler(agent.agentId, agent.task);
+                    }
+                    catch (err) {
+                        this.options.log?.warn?.(`[machine] task dispatch failed for agent ${agent.agentId} task ${agent.task.taskId}: ${err}`);
+                    }
+                }
+                if (agent.chat && agent.chat.length > 0 && this.chatHandler) {
+                    try {
+                        const freshMessages = agent.chat.filter((message) => this.rememberChat(message.workId ?? message.messageId));
+                        if (freshMessages.length > 0) {
+                            this.chatHandler(agent.agentId, freshMessages);
+                        }
+                    }
+                    catch (err) {
+                        this.options.log?.warn?.(`[machine] chat dispatch failed for agent ${agent.agentId}: ${err}`);
+                    }
+                }
+            }
+        }
+        catch (err) {
+            this.options.log?.warn?.(`[machine] poll error: ${err}`);
+        }
+        finally {
+            this.pollInFlight = false;
+        }
+    }
+    connect() {
+        this.stopHeartbeat();
+        this.stopPolling();
+        this.wsTransport?.disconnect();
+        this.wsTransport = null;
+        this._stopped = false;
+        const hostname = this.options.hostname ?? os.hostname();
+        const hbBody = {
+            hostname,
+            capabilities: this.options.capabilities,
+            platform: os.platform(),
+            architecture: os.arch(),
+            osRelease: os.release(),
+        };
+        const sendHeartbeat = async () => {
+            if (this.heartbeatInFlight)
+                return;
+            this.heartbeatInFlight = true;
+            try {
+                const result = (await this.httpRequest("POST", "/heartbeat", hbBody));
+                this.markConnected(result.machineId);
+            }
+            catch (err) {
+                if (!this.wsTransport?.connected) {
+                    this.markDisconnected();
+                }
+                else {
+                    this.options.log?.warn?.(`[machine] heartbeat failed while WS is still connected: ${err}`);
+                }
+                throw err;
+            }
+            finally {
+                this.heartbeatInFlight = false;
+            }
+        };
+        // Heartbeat every 30s (always HTTP)
+        this.heartbeatTimer = setInterval(() => {
+            void sendHeartbeat().catch(() => { });
+        }, 30_000);
+        sendHeartbeat().catch((err) => this.options.log?.warn?.(`[machine] initial heartbeat failed: ${err}`));
+        // WebSocket transport
+        this.wsTransport = new WsTransport({
+            url: this.wsUrl,
+            token: this.options.apiKey,
+            log: { info: (m) => this.options.log?.info?.(m), warn: (m) => this.options.log?.warn?.(m) },
+            onConnected: () => {
+                this.options.log?.info?.("[machine] WebSocket connected");
+            },
+            onDisconnected: () => {
+                this.options.log?.info?.("[machine] WebSocket disconnected, HTTP polling active");
+            },
+            onMessage: (msg) => {
+                const message = getRecord(msg.message);
+                if (msg.type === "message") {
+                    const targetAgentId = getOptionalString(msg.agentId) ?? getOptionalString(message?.agentId);
+                    const messageId = getString(message?.id, getString(msg.messageId));
+                    if (message && targetAgentId && this.chatHandler && this.rememberChat(messageId)) {
+                        const agentProfile = resolveAgentChatProfile(msg.agentProfile, message?.agentProfile);
+                        const messages = [{
+                                type: "server.chat",
+                                kind: (typeof msg.kind === "string" ? msg.kind : "wake"),
+                                workId: getString(message?.workId),
+                                leaseToken: getString(message?.leaseToken),
+                                messageId,
+                                channelId: getString(message?.channelId),
+                                content: getString(message?.content),
+                                attachments: getAttachments(msg.attachments) ?? getAttachments(message?.attachments),
+                                isMention: typeof msg.isMention === "boolean" ? msg.isMention : false,
+                                wakeReason: getWakeReason(msg.wakeReason) ?? getWakeReason(message?.wakeReason),
+                                triggerReason: getOptionalString(msg.triggerReason) ?? getOptionalString(message?.triggerReason),
+                                context: getContext(msg.context),
+                                agentProfile,
+                            }];
+                        this.chatHandler(targetAgentId, messages);
+                    }
+                }
+                const taskAgentId = getOptionalString(msg.agentId);
+                if (msg.type === "task" && taskAgentId && this.taskHandler) {
+                    this.taskHandler(taskAgentId, msg.task ?? null);
+                }
+            },
+        });
+        this.wsTransport.connect();
+        // Keep HTTP polling active even when WS is up.
+        // Machine WS chat delivery is best-effort; polling is the durable delivery path.
+        this.pollTimer = setInterval(async () => {
+            await this.pollOnce();
+        }, 10_000);
+        void this.pollOnce();
+    }
+    disconnect() {
+        this._stopped = true;
+        this._connected = false;
+        this.stopHeartbeat();
+        this.stopPolling();
+        this.wsTransport?.disconnect();
+        this.wsTransport = null;
+        this.recentChatIds.clear();
+    }
+    stopHeartbeat() {
+        if (this.heartbeatTimer) {
+            clearInterval(this.heartbeatTimer);
+            this.heartbeatTimer = null;
+        }
+    }
+    stopPolling() {
+        if (this.pollTimer) {
+            clearInterval(this.pollTimer);
+            this.pollTimer = null;
+        }
+    }
+}
+function getRecord(value) {
+    if (!value || typeof value !== "object" || Array.isArray(value))
+        return null;
+    return value;
+}
+function getString(value, fallback = "") {
+    return typeof value === "string" ? value : fallback;
+}
+function getOptionalString(value) {
+    return typeof value === "string" ? value : undefined;
+}
+function getAttachments(value) {
+    return Array.isArray(value) ? value : undefined;
+}
+function getContext(value) {
+    return Array.isArray(value) ? value : [];
+}
+function getWakeReason(value) {
+    return typeof value === "string" ? value : undefined;
+}
+function getAgentChatProfile(value) {
+    const record = getRecord(value);
+    if (!record)
+        return null;
+    return {
+        role: getString(record.role, DEFAULT_AGENT_CHAT_PROFILE.role),
+        systemPrompt: getString(record.systemPrompt, DEFAULT_AGENT_CHAT_PROFILE.systemPrompt),
+        memory: getString(record.memory, DEFAULT_AGENT_CHAT_PROFILE.memory),
+        continuityPacket: getString(record.continuityPacket, DEFAULT_AGENT_CHAT_PROFILE.continuityPacket),
+    };
+}
+function resolveAgentChatProfile(...values) {
+    for (const value of values) {
+        const profile = getAgentChatProfile(value);
+        if (profile)
+            return profile;
+    }
+    return DEFAULT_AGENT_CHAT_PROFILE;
+}
+//# sourceMappingURL=machine-client.js.map

package/dist/machine-client.js.map

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

package/dist/protocol.d.ts

@@ -0,0 +1,3 @@
+export type { AgentChatProfile, AgentWorkRef, ChatAttachmentRef, AgentHeartbeat, AgentResultFile, AgentComplete, AgentProgress, AgentFail, AgentChatReply, AgentTyping, AgentMessage, ServerTask, ServerChatMessage, ServerMessage, RuntimeDef, } from "@clawroom/protocol";
+export { RUNTIMES, BRIDGE_MANAGED_RUNTIME_IDS, RUNTIME_MAP, } from "@clawroom/protocol";
+//# 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,YAAY,EACV,gBAAgB,EAChB,YAAY,EACZ,iBAAiB,EACjB,cAAc,EACd,eAAe,EACf,aAAa,EACb,aAAa,EACb,SAAS,EACT,cAAc,EACd,WAAW,EACX,YAAY,EACZ,UAAU,EACV,iBAAiB,EACjB,aAAa,EACb,UAAU,GACX,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EACL,QAAQ,EACR,0BAA0B,EAC1B,WAAW,GACZ,MAAM,oBAAoB,CAAC"}

package/dist/protocol.js

@@ -0,0 +1,2 @@
+export { RUNTIMES, BRIDGE_MANAGED_RUNTIME_IDS, RUNTIME_MAP, } from "@clawroom/protocol";
+//# sourceMappingURL=protocol.js.map

package/dist/protocol.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"protocol.js","sourceRoot":"","sources":["../src/protocol.ts"],"names":[],"mappings":"AAkBA,OAAO,EACL,QAAQ,EACR,0BAA0B,EAC1B,WAAW,GACZ,MAAM,oBAAoB,CAAC"}

package/dist/ws-transport.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Shared WebSocket transport with auto-reconnect and fallback support.
+ * Used by both ClawroomClient and ClawroomMachineClient.
+ */
+export type WsLike = {
+    readyState: number;
+    on: (event: string, listener: (...args: unknown[]) => void) => void;
+    removeAllListeners?: (event?: string) => void;
+    send: (data: string) => void;
+    close: () => void;
+};
+export type WsTransportOptions = {
+    url: string;
+    token: string;
+    onMessage: (msg: Record<string, unknown>) => void;
+    onConnected: () => void;
+    onDisconnected: () => void;
+    createSocket?: (url: string) => WsLike | Promise<WsLike>;
+    log?: {
+        info?: (message: string) => void;
+        warn?: (message: string) => void;
+    };
+};
+export declare class WsTransport {
+    private static readonly MAX_SEND_QUEUE;
+    private ws;
+    private options;
+    private _connected;
+    private stopped;
+    private reconnectTimer;
+    private reconnectDelay;
+    private failCount;
+    private sendQueue;
+    static readonly MAX_RECONNECT_DELAY = 60000;
+    static readonly MAX_RECONNECT_FAILS = 10;
+    constructor(options: WsTransportOptions);
+    get connected(): boolean;
+    connect(): Promise<void>;
+    send(msg: Record<string, unknown>): boolean;
+    disconnect(): void;
+    private handleDisconnect;
+    private scheduleReconnect;
+    private createSocket;
+    private closeSocket;
+    private resetReconnectState;
+    private flushSendQueue;
+}
+//# sourceMappingURL=ws-transport.d.ts.map

package/dist/ws-transport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ws-transport.d.ts","sourceRoot":"","sources":["../src/ws-transport.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,MAAM,MAAM,GAAG;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,EAAE,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,KAAK,IAAI,CAAC;IACpE,kBAAkB,CAAC,EAAE,CAAC,KAAK,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;IAC9C,IAAI,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAC7B,KAAK,EAAE,MAAM,IAAI,CAAC;CACnB,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG;IAC/B,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;IAClD,WAAW,EAAE,MAAM,IAAI,CAAC;IACxB,cAAc,EAAE,MAAM,IAAI,CAAC;IAC3B,YAAY,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IACzD,GAAG,CAAC,EAAE;QACJ,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;QACjC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;KAClC,CAAC;CACH,CAAC;AAMF,qBAAa,WAAW;IACtB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,cAAc,CAAO;IAC7C,OAAO,CAAC,EAAE,CAAuB;IACjC,OAAO,CAAC,OAAO,CAAqB;IACpC,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,cAAc,CAA8C;IACpE,OAAO,CAAC,cAAc,CAAQ;IAC9B,OAAO,CAAC,SAAS,CAAK;IACtB,OAAO,CAAC,SAAS,CAAgB;IAEjC,MAAM,CAAC,QAAQ,CAAC,mBAAmB,SAAU;IAC7C,MAAM,CAAC,QAAQ,CAAC,mBAAmB,MAAM;gBAE7B,OAAO,EAAE,kBAAkB;IAIvC,IAAI,SAAS,YAA8B;IAErC,OAAO;IAqEb,IAAI,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO;IAmB3C,UAAU;IAaV,OAAO,CAAC,gBAAgB;IASxB,OAAO,CAAC,iBAAiB;YAoBX,YAAY;IAgB1B,OAAO,CAAC,WAAW;IASnB,OAAO,CAAC,mBAAmB;IAK3B,OAAO,CAAC,cAAc;CAOvB"}

package/dist/ws-transport.js

@@ -0,0 +1,188 @@
+/**
+ * Shared WebSocket transport with auto-reconnect and fallback support.
+ * Used by both ClawroomClient and ClawroomMachineClient.
+ */
+export class WsTransport {
+    static MAX_SEND_QUEUE = 500;
+    ws = null;
+    options;
+    _connected = false;
+    stopped = false;
+    reconnectTimer = null;
+    reconnectDelay = 1000;
+    failCount = 0;
+    sendQueue = [];
+    static MAX_RECONNECT_DELAY = 60_000;
+    static MAX_RECONNECT_FAILS = 10;
+    constructor(options) {
+        this.options = options;
+    }
+    get connected() { return this._connected; }
+    async connect() {
+        this.stopped = false;
+        if (this.reconnectTimer) {
+            clearTimeout(this.reconnectTimer);
+            this.reconnectTimer = null;
+        }
+        if (this.ws && (this.ws.readyState === 0 || this.ws.readyState === 1))
+            return;
+        if (this.ws) {
+            const staleSocket = this.ws;
+            this.ws = null;
+            this.closeSocket(staleSocket);
+        }
+        try {
+            this.ws = await this.createSocket();
+            if (!this.ws)
+                return;
+        }
+        catch {
+            this._connected = false;
+            this.scheduleReconnect();
+            return;
+        }
+        const socket = this.ws;
+        socket.on("open", () => {
+            this.reconnectDelay = 1000;
+            socket.send(JSON.stringify({ type: "auth", token: this.options.token }));
+        });
+        socket.on("message", (raw) => {
+            if (!raw || typeof raw !== "object" || !("toString" in raw) || typeof raw.toString !== "function")
+                return;
+            let msg;
+            try {
+                msg = JSON.parse(raw.toString());
+            }
+            catch {
+                return;
+            }
+            if (msg.type === "auth_ok") {
+                this._connected = true;
+                this.failCount = 0;
+                this.flushSendQueue(socket);
+                this.options.onConnected();
+                return;
+            }
+            if (msg.type === "auth_error") {
+                this._connected = false;
+                this.options.log?.warn?.(`WS auth failed: ${msg.error ?? "unknown"}`);
+                socket.close();
+                return;
+            }
+            if (msg.type === "pong")
+                return;
+            this.options.onMessage(msg);
+        });
+        socket.on("close", () => {
+            this.handleDisconnect(socket);
+        });
+        socket.on("error", () => {
+            this.handleDisconnect(socket);
+            try {
+                if (socket.readyState === 0 || socket.readyState === 1)
+                    socket.close();
+            }
+            catch {
+                /* ignore close errors */
+            }
+        });
+    }
+    send(msg) {
+        const payload = JSON.stringify(msg);
+        if (this._connected && this.ws?.readyState === 1) {
+            this.ws.send(payload);
+            return true;
+        }
+        if (!this.stopped) {
+            if (!this.sendQueue.includes(payload)) {
+                if (this.sendQueue.length >= WsTransport.MAX_SEND_QUEUE) {
+                    this.sendQueue.shift();
+                    this.options.log?.warn?.(`WS send queue full; dropping oldest queued message`);
+                }
+                this.sendQueue.push(payload);
+            }
+            this.options.log?.warn?.("WS send queued until the socket is ready");
+        }
+        return false;
+    }
+    disconnect() {
+        this.stopped = true;
+        this._connected = false;
+        if (this.reconnectTimer) {
+            clearTimeout(this.reconnectTimer);
+            this.reconnectTimer = null;
+        }
+        this.resetReconnectState();
+        this.sendQueue = [];
+        if (this.ws) {
+            const socket = this.ws;
+            this.ws = null;
+            this.closeSocket(socket);
+        }
+    }
+    handleDisconnect(socket) {
+        if (this.ws !== socket)
+            return;
+        this.ws = null;
+        const wasConnected = this._connected;
+        this._connected = false;
+        if (wasConnected)
+            this.options.onDisconnected();
+        if (!this.stopped)
+            this.scheduleReconnect();
+    }
+    scheduleReconnect() {
+        if (this.stopped || this.reconnectTimer)
+            return;
+        this.failCount++;
+        const failedAttempts = this.failCount;
+        if (failedAttempts > WsTransport.MAX_RECONNECT_FAILS) {
+            this._connected = false;
+            this.resetReconnectState();
+            this.options.log?.warn?.(`WS reconnect failed ${failedAttempts} times, giving up. HTTP polling active.`);
+            return;
+        }
+        const jitter = Math.random() * 3000;
+        this.reconnectTimer = setTimeout(() => {
+            this.reconnectTimer = null;
+            this.connect();
+        }, Math.min(this.reconnectDelay + jitter, WsTransport.MAX_RECONNECT_DELAY));
+        this.reconnectDelay = Math.min(this.reconnectDelay * 2, WsTransport.MAX_RECONNECT_DELAY);
+    }
+    async createSocket() {
+        if (this.options.createSocket) {
+            return await this.options.createSocket(this.options.url);
+        }
+        let WebSocket;
+        try {
+            WebSocket = (await import("ws")).default;
+        }
+        catch {
+            this.options.log?.info?.("ws module not available, skipping WebSocket");
+            return null;
+        }
+        return new WebSocket(this.options.url);
+    }
+    closeSocket(socket) {
+        try {
+            socket.removeAllListeners?.();
+            socket.close();
+        }
+        catch {
+            /* ignore close errors */
+        }
+    }
+    resetReconnectState() {
+        this.reconnectDelay = 1000;
+        this.failCount = 0;
+    }
+    flushSendQueue(socket) {
+        while (this.ws === socket && this._connected && socket.readyState === 1 && this.sendQueue.length > 0) {
+            const payload = this.sendQueue.shift();
+            if (!payload)
+                continue;
+            socket.send(payload);
+        }
+    }
+}
+//# sourceMappingURL=ws-transport.js.map

package/dist/ws-transport.js.map

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

package/package.json

@@ -1,11 +1,17 @@
 {
   "name": "@clawroom/sdk",
-  "version": "0.5.24",
+  "version": "0.5.26",
   "description": "ClawRoom SDK — polling client and protocol types for connecting any agent to ClawRoom",
   "type": "module",
   "license": "MIT",
-  "main": "./src/index.ts",
-  "types": "./src/index.ts",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
   "repository": {
     "type": "git",
     "url": "git+https://github.com/clawroom/clawroom.git"
@@ -17,9 +23,18 @@
     "workspace"
   ],
   "files": [
-    "src"
+    "dist"
   ],
+  "scripts": {
+    "build": "tsc"
+  },
   "dependencies": {
-    "@clawroom/protocol": "^0.5.1"
+    "@clawroom/protocol": "^0.5.1",
+    "ws": "^8.19.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "@types/ws": "^8.5.0",
+    "typescript": "^5.7.0"
   }
 }