sf-builder-agent 0.7.0

package/src/pairing.ts

@@ -0,0 +1,32 @@
+/**
+ * Pairing — exchange a one-time code for a persistent auth token.
+ */
+
+export async function pair(
+  baseUrl: string,
+  sessionId: string,
+  code: string
+): Promise<{ token: string; sessionId: string }> {
+  const url = `${baseUrl}/api/sessions/${sessionId}/agent/pair`;
+
+  const res = await fetch(url, {
+    method: "POST",
+    headers: { "Content-Type": "application/json" },
+    body: JSON.stringify({ code }),
+  });
+
+  if (!res.ok) {
+    const body = await res.text().catch(() => "");
+    throw new Error(
+      `Pairing failed (${res.status}): ${body || res.statusText}`
+    );
+  }
+
+  const data = (await res.json()) as { token?: string; sessionId?: string };
+
+  if (!data.token) {
+    throw new Error("Pairing response did not include a token");
+  }
+
+  return { token: data.token, sessionId: data.sessionId ?? sessionId };
+}

package/src/reporter.ts

@@ -0,0 +1,35 @@
+/**
+ * Reporter — POST command results back to the web app.
+ */
+
+export async function reportResult(
+  baseUrl: string,
+  sessionId: string,
+  token: string,
+  commandId: string,
+  status: "success" | "error",
+  result?: Record<string, unknown>
+): Promise<void> {
+  const url = `${baseUrl}/api/sessions/${sessionId}/agent/result`;
+
+  try {
+    const res = await fetch(url, {
+      method: "POST",
+      headers: {
+        Authorization: `Bearer ${token}`,
+        "Content-Type": "application/json",
+      },
+      body: JSON.stringify({ commandId, status, result }),
+    });
+
+    if (!res.ok) {
+      const body = await res.text().catch(() => "");
+      console.error(`\u274C Report failed (${res.status}): ${body || res.statusText}`);
+    }
+  } catch (err) {
+    console.error(
+      `\u274C Report error:`,
+      err instanceof Error ? err.message : err
+    );
+  }
+}

package/src/sse-client.ts

@@ -0,0 +1,87 @@
+/**
+ * SSE client — listens for browser-automation commands from the server.
+ */
+
+import { EventSource } from "eventsource";
+
+interface IncomingCommand {
+  id: string;
+  commandType: string;
+  stepKey: string | null;
+  payload: Record<string, unknown>;
+}
+
+export function connectSSE(
+  baseUrl: string,
+  sessionId: string,
+  token: string,
+  onCommand: (command: IncomingCommand) => void,
+  onError: (error: Error) => void
+): { close: () => void } {
+  const url = `${baseUrl}/api/sessions/${sessionId}/agent/commands?token=${encodeURIComponent(token)}`;
+
+  let es: EventSource | null = null;
+  let closed = false;
+  let retryDelay = 1_000;
+  const MAX_RETRY = 30_000;
+
+  function connect() {
+    if (closed) return;
+
+    es = new EventSource(url);
+
+    es.addEventListener("command", (evt: MessageEvent) => {
+      try {
+        const data = JSON.parse(evt.data) as IncomingCommand;
+        onCommand(data);
+        // Reset backoff on successful message
+        retryDelay = 1_000;
+      } catch (err) {
+        console.error(
+          "\u274C Failed to parse command:",
+          err instanceof Error ? err.message : err
+        );
+      }
+    });
+
+    es.addEventListener("ping", () => {
+      // Keep-alive — nothing to do
+    });
+
+    es.addEventListener("open", () => {
+      console.log("\u2705 Connected to command stream");
+      retryDelay = 1_000;
+    });
+
+    es.onerror = (err: Event) => {
+      if (closed) return;
+
+      const message =
+        err && typeof err === "object" && "message" in err
+          ? (err as unknown as { message: string }).message
+          : "SSE connection error";
+
+      console.error(`\u274C SSE error: ${message}  — reconnecting in ${retryDelay / 1_000}s`);
+      onError(new Error(message));
+
+      // Close the broken connection and schedule reconnect
+      es?.close();
+      es = null;
+
+      setTimeout(() => {
+        retryDelay = Math.min(retryDelay * 2, MAX_RETRY);
+        connect();
+      }, retryDelay);
+    };
+  }
+
+  connect();
+
+  return {
+    close() {
+      closed = true;
+      es?.close();
+      es = null;
+    },
+  };
+}

package/tsconfig.json

@@ -0,0 +1,16 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "ES2022",
+    "moduleResolution": "bundler",
+    "outDir": "dist",
+    "rootDir": "src",
+    "strict": true,
+    "esModuleInterop": true,
+    "declaration": true,
+    "sourceMap": true,
+    "resolveJsonModule": true,
+    "skipLibCheck": true
+  },
+  "include": ["src"]
+}