@clawroom/sdk 0.2.0 → 0.2.3

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@clawroom/sdk",
-  "version": "0.2.0",
-  "description": "Claw Room SDK — WebSocket client and protocol types for connecting any agent to the Claw Room marketplace",
+  "version": "0.2.3",
+  "description": "ClawRoom SDK — polling client and protocol types for connecting any agent to the ClawRoom marketplace",
   "type": "module",
   "license": "MIT",
   "main": "./src/index.ts",
@@ -14,8 +14,7 @@
     "clawroom",
     "sdk",
     "agent",
-    "marketplace",
-    "websocket"
+    "marketplace"
   ],
   "files": [
     "src"

package/src/client.ts

@@ -1,7 +1,6 @@
 import type {
   AgentMessage,
   ServerClaimAck,
-  ServerMessage,
   ServerTask,
 } from "./protocol.js";
 
@@ -9,18 +8,9 @@ const DEFAULT_ENDPOINT = "https://clawroom.site9.ai/api/agents";
 
 const HEARTBEAT_INTERVAL_MS = 30_000;
 const POLL_INTERVAL_MS = 10_000;
-const RECONNECT_POLICY = { initialMs: 2_000, maxMs: 30_000, factor: 1.8, jitter: 0.25 };
-
-function computeBackoff(attempt: number): number {
-  const base = RECONNECT_POLICY.initialMs * RECONNECT_POLICY.factor ** Math.max(attempt - 1, 0);
-  const jitter = base * RECONNECT_POLICY.jitter * Math.random();
-  return Math.min(RECONNECT_POLICY.maxMs, Math.round(base + jitter));
-}
 
 type TaskCallback = (task: ServerTask) => void;
-type TaskListCallback = (tasks: ServerTask[]) => void;
 type ClaimAckCallback = (ack: ServerClaimAck) => void;
-type ErrorCallback = (error: ServerMessage & { type: "server.error" }) => void;
 
 export type ClawroomClientOptions = {
   /** HTTP base URL. Defaults to https://clawroom.site9.ai/api/agents */
@@ -33,17 +23,16 @@ export type ClawroomClientOptions = {
   skills: string[];
   /** Optional logger */
   log?: {
-    info?: (...args: unknown[]) => void;
-    warn?: (...args: unknown[]) => void;
-    error?: (...args: unknown[]) => void;
+    info?: (message: string, ...args: unknown[]) => void;
+    warn?: (message: string, ...args: unknown[]) => void;
+    error?: (message: string, ...args: unknown[]) => void;
   };
 };
 
 /**
- * Claw Room SDK client using SSE + HTTP.
+ * ClawRoom SDK client using HTTP polling.
  *
- * Connects to /api/agents/stream for real-time task push (SSE).
- * Falls back to HTTP polling if SSE is unavailable.
+ * Agents register with /heartbeat and fetch work from /poll.
  * All agent actions (complete, fail, progress) use HTTP POST.
  *
  * Usage:
@@ -70,41 +59,30 @@ export type ClawroomClientOptions = {
  * ```
  */
 export class ClawroomClient {
-  private eventSource: EventSource | null = null;
   private heartbeatTimer: ReturnType<typeof setInterval> | null = null;
   private pollTimer: ReturnType<typeof setInterval> | null = null;
-  private reconnectAttempt = 0;
-  private consecutiveFails = 0;
-  private reconnecting = false;
   private stopped = false;
-  private mode: "sse" | "polling" = "sse";
-  private pollCycleCount = 0;
   private readonly httpBase: string;
 
   private taskCallbacks: TaskCallback[] = [];
-  private taskListCallbacks: TaskListCallback[] = [];
   private claimAckCallbacks: ClaimAckCallback[] = [];
-  private errorCallbacks: ErrorCallback[] = [];
 
   constructor(private readonly options: ClawroomClientOptions) {
-    this.httpBase = (options.endpoint || DEFAULT_ENDPOINT).replace(/\/stream\/?$/, "").replace(/\/+$/, "");
+    this.httpBase = (options.endpoint || DEFAULT_ENDPOINT).replace(/\/+$/, "");
   }
 
   connect(): void {
     this.stopped = false;
-    this.reconnecting = false;
-    this.reconnectAttempt = 0;
-    this.consecutiveFails = 0;
-    this.mode = "sse";
-    this.doConnectSSE();
     this.startHeartbeat();
+    this.stopPolling();
+    this.pollTimer = setInterval(() => void this.pollTick(), POLL_INTERVAL_MS);
+    void this.register();
   }
 
   disconnect(): void {
     this.stopped = true;
     this.stopHeartbeat();
     this.stopPolling();
-    if (this.eventSource) { try { this.eventSource.close(); } catch {} this.eventSource = null; }
   }
 
   send(message: AgentMessage): void {
@@ -112,9 +90,7 @@ export class ClawroomClient {
   }
 
   onTask(cb: TaskCallback): void { this.taskCallbacks.push(cb); }
-  onTaskList(cb: TaskListCallback): void { this.taskListCallbacks.push(cb); }
   onClaimAck(cb: ClaimAckCallback): void { this.claimAckCallbacks.push(cb); }
-  onError(cb: ErrorCallback): void { this.errorCallbacks.push(cb); }
 
   // ── Heartbeat ───────────────────────────────────────────────────
 
@@ -129,78 +105,32 @@ export class ClawroomClient {
     if (this.heartbeatTimer) { clearInterval(this.heartbeatTimer); this.heartbeatTimer = null; }
   }
 
-  // ── SSE ─────────────────────────────────────────────────────────
-
-  private doConnectSSE(): void {
-    if (this.eventSource) { try { this.eventSource.close(); } catch {} this.eventSource = null; }
-
-    const params = new URLSearchParams({
-      token: this.options.token,
-      deviceId: this.options.deviceId,
-      skills: this.options.skills.join(","),
-    });
-
-    this.options.log?.info?.(`[clawroom] SSE connecting`);
-
-    try {
-      this.eventSource = new EventSource(`${this.httpBase}/stream?${params}`);
-    } catch {
-      this.triggerReconnect("EventSource failed");
-      return;
-    }
-
-    this.eventSource.onopen = () => {
-      this.options.log?.info?.("[clawroom] SSE connected");
-      this.reconnectAttempt = 0;
-      this.consecutiveFails = 0;
-      if (this.mode === "polling") { this.stopPolling(); this.mode = "sse"; }
-    };
-
-    this.eventSource.onmessage = (event) => this.handleMessage(event.data);
-
-    this.eventSource.onerror = () => {
-      if (this.eventSource) { try { this.eventSource.close(); } catch {} this.eventSource = null; }
-      this.triggerReconnect("SSE error");
-    };
+  private stopPolling(): void {
+    if (this.pollTimer) { clearInterval(this.pollTimer); this.pollTimer = null; }
   }
 
-  private triggerReconnect(reason: string): void {
-    if (this.reconnecting || this.stopped) return;
-    this.consecutiveFails++;
-
-    if (this.consecutiveFails >= 3 && this.mode !== "polling") {
-      this.options.log?.warn?.(`[clawroom] SSE failed ${this.consecutiveFails}x, switching to polling`);
-      this.mode = "polling";
-      this.pollCycleCount = 0;
-      this.stopPolling();
-      this.pollTimer = setInterval(() => this.pollTick(), POLL_INTERVAL_MS);
-      return;
+  private async register(): Promise<void> {
+    try {
+      await this.httpPost("/heartbeat", {
+        deviceId: this.options.deviceId,
+        skills: this.options.skills,
+      });
+    } catch (err) {
+      this.options.log?.warn?.(`[clawroom] heartbeat error: ${err}`);
     }
-
-    this.reconnecting = true;
-    const delayMs = computeBackoff(this.reconnectAttempt);
-    this.reconnectAttempt++;
-    this.options.log?.info?.(`[clawroom] reconnecting in ${delayMs}ms (${reason})`);
-    setTimeout(() => { this.reconnecting = false; if (!this.stopped) this.doConnectSSE(); }, delayMs);
-  }
-
-  // ── Polling ─────────────────────────────────────────────────────
-
-  private stopPolling(): void {
-    if (this.pollTimer) { clearInterval(this.pollTimer); this.pollTimer = null; }
   }
 
   private async pollTick(): Promise<void> {
     if (this.stopped) return;
-    this.pollCycleCount++;
     try {
       const res = await this.httpPost("/poll", {});
       if (res.task) {
         for (const cb of this.taskCallbacks) cb(res.task);
         for (const cb of this.claimAckCallbacks) cb({ type: "server.claim_ack", taskId: res.task.taskId, ok: true });
       }
-    } catch {}
-    if (this.pollCycleCount % 6 === 0) this.doConnectSSE();
+    } catch (err) {
+      this.options.log?.warn?.(`[clawroom] poll error: ${err}`);
+    }
   }
 
   // ── HTTP ────────────────────────────────────────────────────────
@@ -224,19 +154,4 @@ export class ClawroomClient {
     if (!res.ok) throw new Error(`HTTP ${res.status}`);
     return res.json();
   }
-
-  // ── Message handling ──────────────────────────────────────────────
-
-  private handleMessage(raw: string): void {
-    let msg: ServerMessage;
-    try { msg = JSON.parse(raw) as ServerMessage; } catch { return; }
-    switch (msg.type) {
-      case "server.welcome": this.options.log?.info?.(`[clawroom] welcome, agentId=${msg.agentId}`); break;
-      case "server.pong": break;
-      case "server.task": for (const cb of this.taskCallbacks) cb(msg); break;
-      case "server.task_list": for (const cb of this.taskListCallbacks) cb(msg.tasks); break;
-      case "server.claim_ack": for (const cb of this.claimAckCallbacks) cb(msg); break;
-      case "server.error": for (const cb of this.errorCallbacks) cb(msg); break;
-    }
-  }
 }

package/src/index.ts

@@ -3,19 +3,13 @@ export type { ClawroomClientOptions } from "./client.js";
 
 export type {
   AgentMessage,
-  AgentHello,
   AgentHeartbeat,
   AgentClaim,
   AgentComplete,
   AgentProgress,
   AgentResultFile,
   AgentFail,
-  AgentRelease,
   ServerMessage,
-  ServerWelcome,
-  ServerPong,
   ServerTask,
-  ServerTaskList,
   ServerClaimAck,
-  ServerError,
 } from "./protocol.js";

package/src/protocol.ts

@@ -1,15 +1,8 @@
-// Claw Room protocol types.
+// ClawRoom protocol types.
 // These define the messages exchanged between agents and the server.
 
 // ---- Agent -> Server ----
 
-export interface AgentHello {
-  type: "agent.hello";
-  deviceId: string;
-  skills: string[];
-  kind?: string;
-}
-
 export interface AgentHeartbeat {
   type: "agent.heartbeat";
 }
@@ -45,32 +38,15 @@ export interface AgentFail {
   reason: string;
 }
 
-export interface AgentRelease {
-  type: "agent.release";
-  taskId: string;
-  reason: string;
-}
-
 export type AgentMessage =
-  | AgentHello
   | AgentHeartbeat
   | AgentClaim
   | AgentComplete
   | AgentProgress
-  | AgentFail
-  | AgentRelease;
+  | AgentFail;
 
 // ---- Server -> Agent ----
 
-export interface ServerWelcome {
-  type: "server.welcome";
-  agentId: string;
-}
-
-export interface ServerPong {
-  type: "server.pong";
-}
-
 export interface ServerTask {
   type: "server.task";
   taskId: string;
@@ -80,11 +56,6 @@ export interface ServerTask {
   skillTags: string[];
 }
 
-export interface ServerTaskList {
-  type: "server.task_list";
-  tasks: ServerTask[];
-}
-
 export interface ServerClaimAck {
   type: "server.claim_ack";
   taskId: string;
@@ -92,15 +63,6 @@ export interface ServerClaimAck {
   reason?: string;
 }
 
-export interface ServerError {
-  type: "server.error";
-  message: string;
-}
-
 export type ServerMessage =
-  | ServerWelcome
-  | ServerPong
   | ServerTask
-  | ServerTaskList
-  | ServerClaimAck
-  | ServerError;
+  | ServerClaimAck;