whale-code 6.5.6 → 6.5.8

package/dist/node/portal/portal-target.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"portal-target.js","names":["PortalSession","handleShell","handleFilePush","handleFilePull","handleForward","handleScreen","handleClipboard","checkPermission","handlePortalRequest","request","config","sessions","sendBinary","sendJson","size","maxSessions","type","session_id","reason","accepted","nodeConfig","store_id","autoAcceptAdmins","os","session","sessionId","isInitiator","targetNodeId","requester_node_id","targetHostname","requester_hostname","set","on","stream","meta","handleIncomingStream","accept","hostname","delete","console","log","slice","channel","catch","err","error","message","direction","receiveDir","screenCapture","destroy","Error"],"sources":["../../../src/node/portal/portal-target.ts"],"sourcesContent":["// portal-target.ts — Target-side portal request handling and stream routing\n// Extracted from portal/index.ts for modularity.\n\nimport type { SupabaseClient } from \"@supabase/supabase-js\";\nimport type { ScreenCaptureService } from \"../remote-desktop/index.js\";\nimport type { NodeConfig } from \"../config.js\";\nimport { PortalSession } from \"./session.js\";\nimport { handleShell } from \"./shell.js\";\nimport { handleFilePush, handleFilePull } from \"./transfer.js\";\nimport { handleForward } from \"./forward.js\";\nimport { handleScreen } from \"./screen.js\";\nimport { handleClipboard } from \"./clipboard.js\";\nimport { checkPermission } from \"./permissions.js\";\nimport type { PortalStream } from \"./stream.js\";\nimport type { SynPayload, PortalRequest } from \"./protocol.js\";\n\nexport interface TargetConfig {\n  nodeConfig: NodeConfig;\n  autoAcceptAdmins: boolean;\n  maxSessions: number;\n  receiveDir?: string;\n  screenCapture?: ScreenCaptureService | null;\n}\n\n/** Handle an incoming portal request on the target side */\nexport async function handlePortalRequest(\n  request: PortalRequest,\n  config: TargetConfig,\n  sessions: Map<string, PortalSession>,\n  sendBinary: (data: Buffer) => void,\n  sendJson: (msg: Record<string, unknown>) => void,\n): Promise<void> {\n  if (sessions.size >= config.maxSessions) {\n    sendJson({\n      type: \"portal_reject\",\n      session_id: request.session_id,\n      reason: `Max sessions reached (${config.maxSessions})`,\n    });\n    return;\n  }\n\n  // Check permissions\n  const { accepted, reason } = await checkPermission(\n    request,\n    config.nodeConfig.store_id,\n    config.autoAcceptAdmins,\n  );\n\n  if (!accepted) {\n    sendJson({\n      type: \"portal_reject\",\n      session_id: request.session_id,\n      reason: reason || \"Permission denied\",\n    });\n    return;\n  }\n\n  // Create session (responder side)\n  const os = await import(\"node:os\");\n  const session = new PortalSession({\n    sessionId: request.session_id,\n    isInitiator: false,\n    targetNodeId: request.requester_node_id,\n    targetHostname: request.requester_hostname,\n    sendBinary,\n    sendJson,\n  });\n\n  sessions.set(request.session_id, session);\n\n  // Handle incoming streams (shell, file, etc.)\n  session.on(\"stream\", (stream: PortalStream, meta: SynPayload) => {\n    handleIncomingStream(stream, meta, config);\n  });\n\n  // Accept\n  session.accept();\n  sendJson({\n    type: \"portal_accept\",\n    session_id: request.session_id,\n    hostname: os.hostname(),\n  });\n\n  // Cleanup on close\n  session.on(\"close\", () => {\n    sessions.delete(request.session_id);\n  });\n\n  console.log(`[portal] Accepted session ${request.session_id.slice(0, 8)} from ${request.requester_hostname}`);\n}\n\n/** Route an incoming stream to the appropriate handler */\nexport function handleIncomingStream(\n  stream: PortalStream,\n  meta: SynPayload,\n  config: TargetConfig,\n): void {\n  switch (meta.channel) {\n    case \"shell\":\n      handleShell(stream, meta).catch(err => {\n        console.error(\"[portal:shell]\", err.message);\n      });\n      break;\n\n    case \"file\":\n      if (\"direction\" in meta) {\n        if (meta.direction === \"push\") {\n          handleFilePush(stream, meta, config.receiveDir).catch(err => {\n            console.error(\"[portal:file:push]\", err.message);\n          });\n        } else {\n          handleFilePull(stream, meta).catch(err => {\n            console.error(\"[portal:file:pull]\", err.message);\n          });\n        }\n      }\n      break;\n\n    case \"forward\":\n      handleForward(stream, meta);\n      break;\n\n    case \"screen\":\n      handleScreen(stream, meta, config.screenCapture || null);\n      break;\n\n    case \"clipboard\":\n      handleClipboard(stream, meta);\n      break;\n\n    default:\n      stream.destroy(new Error(`Unknown channel type: ${(meta as any).channel}`));\n  }\n}\n"],"mappings":"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","ignoreList":[]}

package/dist/node/portal/protocol-frames.d.ts

@@ -0,0 +1,33 @@
+import { type Frame, type SynPayload } from "./protocol.js";
+export declare function encodeFrame(frame: Frame): Buffer;
+export declare function encodeRelayEnvelope(sessionUuid: Buffer, innerFrame: Buffer): Buffer;
+export interface DecodeResult {
+    frame: Frame;
+    bytesConsumed: number;
+}
+/**
+ * Try to decode a frame from the buffer. Returns null if not enough data.
+ */
+export declare function decodeFrame(buf: Buffer, offset?: number): DecodeResult | null;
+/**
+ * Parse a relay envelope. Returns session UUID and inner frame buffer.
+ */
+export declare function decodeRelayEnvelope(buf: Buffer): {
+    sessionUuid: Buffer;
+    innerFrame: Buffer;
+} | null;
+/**
+ * Convert a UUID string (with dashes) to a 16-byte buffer.
+ */
+export declare function uuidToBuffer(uuid: string): Buffer;
+/**
+ * Convert a 16-byte buffer to a UUID string (with dashes).
+ */
+export declare function bufferToUuid(buf: Buffer): string;
+export declare function makeDataFrame(streamId: number, data: Buffer): Buffer;
+export declare function makeSynFrame(streamId: number, payload: SynPayload): Buffer;
+export declare function makeAckFrame(streamId: number): Buffer;
+export declare function makeFinFrame(streamId: number): Buffer;
+export declare function makeRstFrame(streamId: number, reason?: string): Buffer;
+export declare function makePingFrame(): Buffer;
+export declare function makePongFrame(): Buffer;

package/dist/node/portal/protocol-frames.js

@@ -0,0 +1,170 @@
+// protocol-frames.ts — Frame encoding/decoding and helper constructors
+// Extracted from protocol.ts for modularity.
+
+import { PROTOCOL_VERSION, HEADER_SIZE, MAX_PAYLOAD_SIZE, PORTAL_MARKER, SESSION_UUID_SIZE, RELAY_HEADER_SIZE, FrameType, FrameFlag } from "./protocol.js";
+
+// ============================================================================
+// ENCODING
+// ============================================================================
+
+export function encodeFrame(frame) {
+  const payloadLen = frame.payload.length;
+  if (payloadLen > MAX_PAYLOAD_SIZE) {
+    throw new Error(`Payload too large: ${payloadLen} > ${MAX_PAYLOAD_SIZE}`);
+  }
+  const buf = Buffer.allocUnsafe(HEADER_SIZE + payloadLen);
+  buf[0] = frame.version;
+  buf[1] = frame.type;
+  buf.writeUInt16BE(frame.flags, 2);
+  buf.writeUInt32BE(frame.streamId, 4);
+  buf.writeUInt32BE(payloadLen, 8);
+  if (payloadLen > 0) {
+    frame.payload.copy(buf, HEADER_SIZE);
+  }
+  return buf;
+}
+export function encodeRelayEnvelope(sessionUuid, innerFrame) {
+  const buf = Buffer.allocUnsafe(RELAY_HEADER_SIZE + innerFrame.length);
+  buf[0] = PORTAL_MARKER;
+  sessionUuid.copy(buf, 1);
+  innerFrame.copy(buf, RELAY_HEADER_SIZE);
+  return buf;
+}
+
+// ============================================================================
+// DECODING
+// ============================================================================
+
+/**
+ * Try to decode a frame from the buffer. Returns null if not enough data.
+ */
+export function decodeFrame(buf, offset = 0) {
+  const remaining = buf.length - offset;
+  if (remaining < HEADER_SIZE) return null;
+  const version = buf[offset];
+  const type = buf[offset + 1];
+  const flags = buf.readUInt16BE(offset + 2);
+  const streamId = buf.readUInt32BE(offset + 4);
+  const payloadLen = buf.readUInt32BE(offset + 8);
+  if (payloadLen > MAX_PAYLOAD_SIZE) {
+    throw new Error(`Invalid payload length: ${payloadLen}`);
+  }
+  const totalLen = HEADER_SIZE + payloadLen;
+  if (remaining < totalLen) return null;
+  const payload = Buffer.allocUnsafe(payloadLen);
+  buf.copy(payload, 0, offset + HEADER_SIZE, offset + totalLen);
+  return {
+    frame: {
+      version,
+      type,
+      flags,
+      streamId,
+      payload
+    },
+    bytesConsumed: totalLen
+  };
+}
+
+/**
+ * Parse a relay envelope. Returns session UUID and inner frame buffer.
+ */
+export function decodeRelayEnvelope(buf) {
+  if (buf.length < RELAY_HEADER_SIZE) return null;
+  if (buf[0] !== PORTAL_MARKER) return null;
+  const sessionUuid = Buffer.allocUnsafe(SESSION_UUID_SIZE);
+  buf.copy(sessionUuid, 0, 1, 1 + SESSION_UUID_SIZE);
+  const innerFrame = Buffer.allocUnsafe(buf.length - RELAY_HEADER_SIZE);
+  buf.copy(innerFrame, 0, RELAY_HEADER_SIZE);
+  return {
+    sessionUuid,
+    innerFrame
+  };
+}
+
+// ============================================================================
+// UUID HELPERS
+// ============================================================================
+
+/**
+ * Convert a UUID string (with dashes) to a 16-byte buffer.
+ */
+export function uuidToBuffer(uuid) {
+  return Buffer.from(uuid.replace(/-/g, ""), "hex");
+}
+
+/**
+ * Convert a 16-byte buffer to a UUID string (with dashes).
+ */
+export function bufferToUuid(buf) {
+  const hex = buf.toString("hex");
+  return `${hex.slice(0, 8)}-${hex.slice(8, 12)}-${hex.slice(12, 16)}-${hex.slice(16, 20)}-${hex.slice(20)}`;
+}
+
+// ============================================================================
+// FRAME CONSTRUCTORS
+// ============================================================================
+
+export function makeDataFrame(streamId, data) {
+  return encodeFrame({
+    version: PROTOCOL_VERSION,
+    type: FrameType.DATA,
+    flags: 0,
+    streamId,
+    payload: data
+  });
+}
+export function makeSynFrame(streamId, payload) {
+  return encodeFrame({
+    version: PROTOCOL_VERSION,
+    type: FrameType.SYN,
+    flags: FrameFlag.SYN,
+    streamId,
+    payload: Buffer.from(JSON.stringify(payload))
+  });
+}
+export function makeAckFrame(streamId) {
+  return encodeFrame({
+    version: PROTOCOL_VERSION,
+    type: FrameType.ACK,
+    flags: FrameFlag.ACK,
+    streamId,
+    payload: Buffer.alloc(0)
+  });
+}
+export function makeFinFrame(streamId) {
+  return encodeFrame({
+    version: PROTOCOL_VERSION,
+    type: FrameType.FIN,
+    flags: FrameFlag.FIN,
+    streamId,
+    payload: Buffer.alloc(0)
+  });
+}
+export function makeRstFrame(streamId, reason = "") {
+  return encodeFrame({
+    version: PROTOCOL_VERSION,
+    type: FrameType.RST,
+    flags: 0,
+    streamId,
+    payload: reason ? Buffer.from(reason) : Buffer.alloc(0)
+  });
+}
+export function makePingFrame() {
+  return encodeFrame({
+    version: PROTOCOL_VERSION,
+    type: FrameType.PING,
+    flags: 0,
+    streamId: 0,
+    payload: Buffer.alloc(0)
+  });
+}
+export function makePongFrame() {
+  return encodeFrame({
+    version: PROTOCOL_VERSION,
+    type: FrameType.PONG,
+    flags: 0,
+    streamId: 0,
+    payload: Buffer.alloc(0)
+  });
+}
+//# sourceMappingURL=protocol-frames.js.map

package/dist/node/portal/protocol-frames.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"protocol-frames.js","names":["PROTOCOL_VERSION","HEADER_SIZE","MAX_PAYLOAD_SIZE","PORTAL_MARKER","SESSION_UUID_SIZE","RELAY_HEADER_SIZE","FrameType","FrameFlag","encodeFrame","frame","payloadLen","payload","length","Error","buf","Buffer","allocUnsafe","version","type","writeUInt16BE","flags","writeUInt32BE","streamId","copy","encodeRelayEnvelope","sessionUuid","innerFrame","decodeFrame","offset","remaining","readUInt16BE","readUInt32BE","totalLen","bytesConsumed","decodeRelayEnvelope","uuidToBuffer","uuid","from","replace","bufferToUuid","hex","toString","slice","makeDataFrame","data","DATA","makeSynFrame","SYN","JSON","stringify","makeAckFrame","ACK","alloc","makeFinFrame","FIN","makeRstFrame","reason","RST","makePingFrame","PING","makePongFrame","PONG"],"sources":["../../../src/node/portal/protocol-frames.ts"],"sourcesContent":["// protocol-frames.ts — Frame encoding/decoding and helper constructors\n// Extracted from protocol.ts for modularity.\n\nimport {\n  PROTOCOL_VERSION,\n  HEADER_SIZE,\n  MAX_PAYLOAD_SIZE,\n  PORTAL_MARKER,\n  SESSION_UUID_SIZE,\n  RELAY_HEADER_SIZE,\n  FrameType,\n  FrameFlag,\n  type Frame,\n  type SynPayload,\n} from \"./protocol.js\";\n\n// ============================================================================\n// ENCODING\n// ============================================================================\n\nexport function encodeFrame(frame: Frame): Buffer {\n  const payloadLen = frame.payload.length;\n  if (payloadLen > MAX_PAYLOAD_SIZE) {\n    throw new Error(`Payload too large: ${payloadLen} > ${MAX_PAYLOAD_SIZE}`);\n  }\n\n  const buf = Buffer.allocUnsafe(HEADER_SIZE + payloadLen);\n  buf[0] = frame.version;\n  buf[1] = frame.type;\n  buf.writeUInt16BE(frame.flags, 2);\n  buf.writeUInt32BE(frame.streamId, 4);\n  buf.writeUInt32BE(payloadLen, 8);\n  if (payloadLen > 0) {\n    frame.payload.copy(buf, HEADER_SIZE);\n  }\n  return buf;\n}\n\nexport function encodeRelayEnvelope(sessionUuid: Buffer, innerFrame: Buffer): Buffer {\n  const buf = Buffer.allocUnsafe(RELAY_HEADER_SIZE + innerFrame.length);\n  buf[0] = PORTAL_MARKER;\n  sessionUuid.copy(buf, 1);\n  innerFrame.copy(buf, RELAY_HEADER_SIZE);\n  return buf;\n}\n\n// ============================================================================\n// DECODING\n// ============================================================================\n\nexport interface DecodeResult {\n  frame: Frame;\n  bytesConsumed: number;\n}\n\n/**\n * Try to decode a frame from the buffer. Returns null if not enough data.\n */\nexport function decodeFrame(buf: Buffer, offset = 0): DecodeResult | null {\n  const remaining = buf.length - offset;\n  if (remaining < HEADER_SIZE) return null;\n\n  const version = buf[offset];\n  const type = buf[offset + 1] as FrameType;\n  const flags = buf.readUInt16BE(offset + 2);\n  const streamId = buf.readUInt32BE(offset + 4);\n  const payloadLen = buf.readUInt32BE(offset + 8);\n\n  if (payloadLen > MAX_PAYLOAD_SIZE) {\n    throw new Error(`Invalid payload length: ${payloadLen}`);\n  }\n\n  const totalLen = HEADER_SIZE + payloadLen;\n  if (remaining < totalLen) return null;\n\n  const payload = Buffer.allocUnsafe(payloadLen);\n  buf.copy(payload, 0, offset + HEADER_SIZE, offset + totalLen);\n\n  return {\n    frame: { version, type, flags, streamId, payload },\n    bytesConsumed: totalLen,\n  };\n}\n\n/**\n * Parse a relay envelope. Returns session UUID and inner frame buffer.\n */\nexport function decodeRelayEnvelope(buf: Buffer): { sessionUuid: Buffer; innerFrame: Buffer } | null {\n  if (buf.length < RELAY_HEADER_SIZE) return null;\n  if (buf[0] !== PORTAL_MARKER) return null;\n\n  const sessionUuid = Buffer.allocUnsafe(SESSION_UUID_SIZE);\n  buf.copy(sessionUuid, 0, 1, 1 + SESSION_UUID_SIZE);\n\n  const innerFrame = Buffer.allocUnsafe(buf.length - RELAY_HEADER_SIZE);\n  buf.copy(innerFrame, 0, RELAY_HEADER_SIZE);\n\n  return { sessionUuid, innerFrame };\n}\n\n// ============================================================================\n// UUID HELPERS\n// ============================================================================\n\n/**\n * Convert a UUID string (with dashes) to a 16-byte buffer.\n */\nexport function uuidToBuffer(uuid: string): Buffer {\n  return Buffer.from(uuid.replace(/-/g, \"\"), \"hex\");\n}\n\n/**\n * Convert a 16-byte buffer to a UUID string (with dashes).\n */\nexport function bufferToUuid(buf: Buffer): string {\n  const hex = buf.toString(\"hex\");\n  return `${hex.slice(0, 8)}-${hex.slice(8, 12)}-${hex.slice(12, 16)}-${hex.slice(16, 20)}-${hex.slice(20)}`;\n}\n\n// ============================================================================\n// FRAME CONSTRUCTORS\n// ============================================================================\n\nexport function makeDataFrame(streamId: number, data: Buffer): Buffer {\n  return encodeFrame({\n    version: PROTOCOL_VERSION,\n    type: FrameType.DATA,\n    flags: 0,\n    streamId,\n    payload: data,\n  });\n}\n\nexport function makeSynFrame(streamId: number, payload: SynPayload): Buffer {\n  return encodeFrame({\n    version: PROTOCOL_VERSION,\n    type: FrameType.SYN,\n    flags: FrameFlag.SYN,\n    streamId,\n    payload: Buffer.from(JSON.stringify(payload)),\n  });\n}\n\nexport function makeAckFrame(streamId: number): Buffer {\n  return encodeFrame({\n    version: PROTOCOL_VERSION,\n    type: FrameType.ACK,\n    flags: FrameFlag.ACK,\n    streamId,\n    payload: Buffer.alloc(0),\n  });\n}\n\nexport function makeFinFrame(streamId: number): Buffer {\n  return encodeFrame({\n    version: PROTOCOL_VERSION,\n    type: FrameType.FIN,\n    flags: FrameFlag.FIN,\n    streamId,\n    payload: Buffer.alloc(0),\n  });\n}\n\nexport function makeRstFrame(streamId: number, reason = \"\"): Buffer {\n  return encodeFrame({\n    version: PROTOCOL_VERSION,\n    type: FrameType.RST,\n    flags: 0,\n    streamId,\n    payload: reason ? Buffer.from(reason) : Buffer.alloc(0),\n  });\n}\n\nexport function makePingFrame(): Buffer {\n  return encodeFrame({\n    version: PROTOCOL_VERSION,\n    type: FrameType.PING,\n    flags: 0,\n    streamId: 0,\n    payload: Buffer.alloc(0),\n  });\n}\n\nexport function makePongFrame(): Buffer {\n  return encodeFrame({\n    version: PROTOCOL_VERSION,\n    type: FrameType.PONG,\n    flags: 0,\n    streamId: 0,\n    payload: Buffer.alloc(0),\n  });\n}\n"],"mappings":"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","ignoreList":[]}

package/dist/node/runtime-network.d.ts

@@ -0,0 +1,25 @@
+import type { BaseAdapter, MessagePayload } from "./adapters/base.js";
+import { type NodeStatus } from "./runtime-utils.js";
+/** Interface for the runtime state that network operations need access to */
+export interface NetworkState {
+    running: boolean;
+    status: NodeStatus;
+    consecutiveServerFailures: number;
+    lastServerContact: Date | null;
+    heartbeatsSent: number;
+    heartbeatsFailed: number;
+    messagesRelayed: number;
+    messagesFailed: number;
+    startedAt: Date | null;
+    config: {
+        node_id: string;
+        server_url: string;
+        api_key: string;
+    };
+    adapters: Map<string, BaseAdapter>;
+}
+export declare function recordServerContact(state: NetworkState, success: boolean): void;
+export declare function fetchWithRetry(state: NetworkState, url: string, options: RequestInit, maxRetries?: number): Promise<Response>;
+export declare function pollOutbound(state: NetworkState, channelId: string, adapter: BaseAdapter): Promise<void>;
+export declare function relayAndDeliver(state: NetworkState, channelId: string, msg: MessagePayload): Promise<void>;
+export declare function sendHeartbeat(state: NetworkState): Promise<boolean>;

package/dist/node/runtime-network.js

@@ -0,0 +1,226 @@
+// node/runtime-network.ts — Network operations for NodeRuntime
+// Extracted from runtime.ts for single-responsibility.
+// Handles: fetchWithRetry, recordServerContact, pollOutbound, relayAndDeliver,
+//           markDelivered, sendHeartbeat
+
+import { captureError } from "../cli/services/error-logger.js";
+import { MAX_RELAY_RETRIES, INITIAL_RETRY_DELAY_MS, MAX_RETRY_DELAY_MS, sleep, getHardwareInfo, getCapabilities, VERSION } from "./runtime-utils.js";
+
+// ============================================================================
+// TYPES
+// ============================================================================
+
+/** Interface for the runtime state that network operations need access to */
+
+// ============================================================================
+// SERVER CONNECTIVITY
+// ============================================================================
+
+export function recordServerContact(state, success) {
+  if (success) {
+    state.consecutiveServerFailures = 0;
+    state.lastServerContact = new Date();
+    if (state.status === "degraded" || state.status === "disconnected") {
+      console.log(`[node] Server connectivity restored`);
+      state.status = "connected";
+    }
+  } else {
+    state.consecutiveServerFailures++;
+    if (state.consecutiveServerFailures >= 3 && state.status === "connected") {
+      console.warn(`[node] Server connectivity degraded (${state.consecutiveServerFailures} consecutive failures)`);
+      state.status = "degraded";
+    }
+    if (state.consecutiveServerFailures >= 10 && state.status !== "disconnected") {
+      console.error(`[node] Server appears unreachable (${state.consecutiveServerFailures} consecutive failures)`);
+      state.status = "disconnected";
+    }
+  }
+}
+
+// ============================================================================
+// FETCH WITH RETRY
+// ============================================================================
+
+export async function fetchWithRetry(state, url, options, maxRetries = MAX_RELAY_RETRIES) {
+  let lastError = null;
+  for (let attempt = 0; attempt <= maxRetries; attempt++) {
+    try {
+      const res = await fetch(url, {
+        ...options,
+        signal: AbortSignal.timeout(30_000)
+      });
+      if (res.status >= 500 && attempt < maxRetries) {
+        const delay = Math.min(INITIAL_RETRY_DELAY_MS * Math.pow(2, attempt), MAX_RETRY_DELAY_MS);
+        console.warn(`[fetch] ${res.status} from ${url}, retrying in ${delay}ms (attempt ${attempt + 1}/${maxRetries})`);
+        await sleep(delay);
+        continue;
+      }
+      recordServerContact(state, res.ok);
+      return res;
+    } catch (err) {
+      lastError = err;
+      if (attempt < maxRetries) {
+        const delay = Math.min(INITIAL_RETRY_DELAY_MS * Math.pow(2, attempt), MAX_RETRY_DELAY_MS);
+        console.warn(`[fetch] Error: ${lastError.message}, retrying in ${delay}ms (attempt ${attempt + 1}/${maxRetries})`);
+        await sleep(delay);
+      }
+    }
+  }
+  recordServerContact(state, false);
+  throw lastError || new Error("Fetch failed after retries");
+}
+
+// ============================================================================
+// MESSAGE POLLING + RELAY
+// ============================================================================
+
+export async function pollOutbound(state, channelId, adapter) {
+  if (!state.running) return;
+  try {
+    const url = `${state.config.server_url}/channels/${channelId}/messages?undelivered=true&limit=10`;
+    const res = await fetchWithRetry(state, url, {
+      method: "GET",
+      headers: {
+        Authorization: `Bearer ${state.config.api_key}`
+      }
+    }, 1);
+    if (!res.ok) return;
+    const data = await res.json();
+    if (!data.success || !data.messages?.length) return;
+    for (const msg of data.messages) {
+      const outMsg = {
+        id: msg.id,
+        content: msg.content || "",
+        sender_id: msg.sender_id || "agent",
+        conversation_id: msg.conversation_id,
+        metadata: msg.metadata
+      };
+      const delivered = await adapter.sendMessage(outMsg);
+      if (delivered) {
+        await markDelivered(state, channelId, msg.id);
+        console.log(`[poll] Delivered queued message ${msg.id}`);
+      }
+    }
+  } catch {/* Silent -- polling errors expected during connectivity blips */}
+}
+export async function relayAndDeliver(state, channelId, msg) {
+  try {
+    const res = await fetchWithRetry(state, `${state.config.server_url}/channels/${channelId}/messages`, {
+      method: "POST",
+      headers: {
+        "Content-Type": "application/json",
+        Authorization: `Bearer ${state.config.api_key}`
+      },
+      body: JSON.stringify({
+        direction: "inbound",
+        ...msg
+      })
+    });
+    const data = await res.json();
+    state.messagesRelayed++;
+    if (data.success && data.agent_response) {
+      const adapter = state.adapters.get(channelId);
+      if (adapter) {
+        const outMsg = {
+          id: data.agent_response.id,
+          content: data.agent_response.content,
+          sender_id: "agent",
+          conversation_id: data.conversation_id || data.agent_response.conversation_id,
+          metadata: msg.metadata
+        };
+        const delivered = await adapter.sendMessage(outMsg);
+        if (delivered) await markDelivered(state, channelId, data.agent_response.id);
+      }
+    }
+  } catch (err) {
+    state.messagesFailed++;
+    console.error(`[relay] Failed after retries:`, err.message);
+    captureError({
+      error: err instanceof Error ? err : new Error(String(err)),
+      severity: "error",
+      tags: {
+        source: "whale-node",
+        operation: "relay",
+        node_id: state.config.node_id,
+        channel_id: channelId
+      }
+    });
+  }
+}
+async function markDelivered(state, channelId, messageId) {
+  try {
+    await fetchWithRetry(state, `${state.config.server_url}/channels/${channelId}/messages/${messageId}/delivered`, {
+      method: "POST",
+      headers: {
+        "Content-Type": "application/json",
+        Authorization: `Bearer ${state.config.api_key}`
+      }
+    }, 1);
+  } catch {/* Best effort */}
+}
+
+// ============================================================================
+// HEARTBEAT
+// ============================================================================
+
+export async function sendHeartbeat(state) {
+  try {
+    const channelStatuses = Array.from(state.adapters.entries()).map(([, adapter]) => {
+      const base = {
+        type: adapter.type,
+        name: adapter.name,
+        status: adapter.isRunning() ? "active" : "error",
+        stats: adapter.getStats()
+      };
+      if (adapter.type === "imessage" && "getLastError" in adapter) {
+        const imsg = adapter;
+        base.last_error = imsg.getLastError();
+        base.restart_attempts = imsg.getRestartAttempts();
+      }
+      return base;
+    });
+    const res = await fetchWithRetry(state, `${state.config.server_url}/nodes/heartbeat`, {
+      method: "POST",
+      headers: {
+        "Content-Type": "application/json",
+        Authorization: `Bearer ${state.config.api_key}`
+      },
+      body: JSON.stringify({
+        hardware: getHardwareInfo(),
+        capabilities: getCapabilities(),
+        version: VERSION,
+        channels: channelStatuses,
+        runtime_stats: {
+          uptime_seconds: state.startedAt ? Math.floor((Date.now() - state.startedAt.getTime()) / 1000) : 0,
+          messages_relayed: state.messagesRelayed,
+          messages_failed: state.messagesFailed,
+          status: state.status
+        }
+      })
+    }, 2);
+    if (res.ok) {
+      state.heartbeatsSent++;
+      return true;
+    }
+    console.warn(`[heartbeat] Server returned ${res.status}`);
+    state.heartbeatsFailed++;
+    return false;
+  } catch (err) {
+    console.warn(`[heartbeat] Failed:`, err.message);
+    state.heartbeatsFailed++;
+    if (state.consecutiveServerFailures >= 3) {
+      captureError({
+        error: err instanceof Error ? err : new Error(String(err)),
+        severity: "warning",
+        tags: {
+          source: "whale-node",
+          operation: "heartbeat",
+          node_id: state.config.node_id,
+          failures: String(state.consecutiveServerFailures)
+        }
+      });
+    }
+    return false;
+  }
+}
+//# sourceMappingURL=runtime-network.js.map

package/dist/node/runtime-network.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-network.js","names":["captureError","MAX_RELAY_RETRIES","INITIAL_RETRY_DELAY_MS","MAX_RETRY_DELAY_MS","sleep","getHardwareInfo","getCapabilities","VERSION","recordServerContact","state","success","consecutiveServerFailures","lastServerContact","Date","status","console","log","warn","error","fetchWithRetry","url","options","maxRetries","lastError","attempt","res","fetch","signal","AbortSignal","timeout","delay","Math","min","pow","ok","err","message","Error","pollOutbound","channelId","adapter","running","config","server_url","method","headers","Authorization","api_key","data","json","messages","length","msg","outMsg","id","content","sender_id","conversation_id","metadata","delivered","sendMessage","markDelivered","relayAndDeliver","body","JSON","stringify","direction","messagesRelayed","agent_response","adapters","get","messagesFailed","String","severity","tags","source","operation","node_id","channel_id","messageId","sendHeartbeat","channelStatuses","Array","from","entries","map","base","type","name","isRunning","stats","getStats","imsg","last_error","getLastError","restart_attempts","getRestartAttempts","hardware","capabilities","version","channels","runtime_stats","uptime_seconds","startedAt","floor","now","getTime","messages_relayed","messages_failed","heartbeatsSent","heartbeatsFailed","failures"],"sources":["../../src/node/runtime-network.ts"],"sourcesContent":["// node/runtime-network.ts — Network operations for NodeRuntime\n// Extracted from runtime.ts for single-responsibility.\n// Handles: fetchWithRetry, recordServerContact, pollOutbound, relayAndDeliver,\n//           markDelivered, sendHeartbeat\n\nimport type { BaseAdapter, MessagePayload, OutboundMessage } from \"./adapters/base.js\";\nimport type { IMessageAdapter } from \"./adapters/imessage.js\";\nimport { captureError } from \"../cli/services/error-logger.js\";\nimport {\n  MAX_RELAY_RETRIES,\n  INITIAL_RETRY_DELAY_MS,\n  MAX_RETRY_DELAY_MS,\n  type NodeStatus,\n  sleep,\n  getHardwareInfo,\n  getCapabilities,\n  VERSION,\n} from \"./runtime-utils.js\";\n\n// ============================================================================\n// TYPES\n// ============================================================================\n\n/** Interface for the runtime state that network operations need access to */\nexport interface NetworkState {\n  running: boolean;\n  status: NodeStatus;\n  consecutiveServerFailures: number;\n  lastServerContact: Date | null;\n  heartbeatsSent: number;\n  heartbeatsFailed: number;\n  messagesRelayed: number;\n  messagesFailed: number;\n  startedAt: Date | null;\n  config: {\n    node_id: string;\n    server_url: string;\n    api_key: string;\n  };\n  adapters: Map<string, BaseAdapter>;\n}\n\n// ============================================================================\n// SERVER CONNECTIVITY\n// ============================================================================\n\nexport function recordServerContact(state: NetworkState, success: boolean): void {\n  if (success) {\n    state.consecutiveServerFailures = 0;\n    state.lastServerContact = new Date();\n    if (state.status === \"degraded\" || state.status === \"disconnected\") {\n      console.log(`[node] Server connectivity restored`);\n      state.status = \"connected\";\n    }\n  } else {\n    state.consecutiveServerFailures++;\n    if (state.consecutiveServerFailures >= 3 && state.status === \"connected\") {\n      console.warn(`[node] Server connectivity degraded (${state.consecutiveServerFailures} consecutive failures)`);\n      state.status = \"degraded\";\n    }\n    if (state.consecutiveServerFailures >= 10 && state.status !== \"disconnected\") {\n      console.error(`[node] Server appears unreachable (${state.consecutiveServerFailures} consecutive failures)`);\n      state.status = \"disconnected\";\n    }\n  }\n}\n\n// ============================================================================\n// FETCH WITH RETRY\n// ============================================================================\n\nexport async function fetchWithRetry(\n  state: NetworkState,\n  url: string,\n  options: RequestInit,\n  maxRetries = MAX_RELAY_RETRIES,\n): Promise<Response> {\n  let lastError: Error | null = null;\n  for (let attempt = 0; attempt <= maxRetries; attempt++) {\n    try {\n      const res = await fetch(url, { ...options, signal: AbortSignal.timeout(30_000) });\n      if (res.status >= 500 && attempt < maxRetries) {\n        const delay = Math.min(INITIAL_RETRY_DELAY_MS * Math.pow(2, attempt), MAX_RETRY_DELAY_MS);\n        console.warn(`[fetch] ${res.status} from ${url}, retrying in ${delay}ms (attempt ${attempt + 1}/${maxRetries})`);\n        await sleep(delay);\n        continue;\n      }\n      recordServerContact(state, res.ok);\n      return res;\n    } catch (err) {\n      lastError = err as Error;\n      if (attempt < maxRetries) {\n        const delay = Math.min(INITIAL_RETRY_DELAY_MS * Math.pow(2, attempt), MAX_RETRY_DELAY_MS);\n        console.warn(`[fetch] Error: ${lastError.message}, retrying in ${delay}ms (attempt ${attempt + 1}/${maxRetries})`);\n        await sleep(delay);\n      }\n    }\n  }\n  recordServerContact(state, false);\n  throw lastError || new Error(\"Fetch failed after retries\");\n}\n\n// ============================================================================\n// MESSAGE POLLING + RELAY\n// ============================================================================\n\nexport async function pollOutbound(state: NetworkState, channelId: string, adapter: BaseAdapter): Promise<void> {\n  if (!state.running) return;\n  try {\n    const url = `${state.config.server_url}/channels/${channelId}/messages?undelivered=true&limit=10`;\n    const res = await fetchWithRetry(state, url, {\n      method: \"GET\", headers: { Authorization: `Bearer ${state.config.api_key}` },\n    }, 1);\n    if (!res.ok) return;\n    const data = await res.json() as any;\n    if (!data.success || !data.messages?.length) return;\n    for (const msg of data.messages) {\n      const outMsg: OutboundMessage = {\n        id: msg.id, content: msg.content || \"\", sender_id: msg.sender_id || \"agent\",\n        conversation_id: msg.conversation_id, metadata: msg.metadata,\n      };\n      const delivered = await adapter.sendMessage(outMsg);\n      if (delivered) {\n        await markDelivered(state, channelId, msg.id);\n        console.log(`[poll] Delivered queued message ${msg.id}`);\n      }\n    }\n  } catch { /* Silent -- polling errors expected during connectivity blips */ }\n}\n\nexport async function relayAndDeliver(state: NetworkState, channelId: string, msg: MessagePayload): Promise<void> {\n  try {\n    const res = await fetchWithRetry(\n      state,\n      `${state.config.server_url}/channels/${channelId}/messages`,\n      {\n        method: \"POST\",\n        headers: { \"Content-Type\": \"application/json\", Authorization: `Bearer ${state.config.api_key}` },\n        body: JSON.stringify({ direction: \"inbound\", ...msg }),\n      },\n    );\n    const data = await res.json() as any;\n    state.messagesRelayed++;\n    if (data.success && data.agent_response) {\n      const adapter = state.adapters.get(channelId);\n      if (adapter) {\n        const outMsg: OutboundMessage = {\n          id: data.agent_response.id, content: data.agent_response.content, sender_id: \"agent\",\n          conversation_id: data.conversation_id || data.agent_response.conversation_id, metadata: msg.metadata,\n        };\n        const delivered = await adapter.sendMessage(outMsg);\n        if (delivered) await markDelivered(state, channelId, data.agent_response.id);\n      }\n    }\n  } catch (err) {\n    state.messagesFailed++;\n    console.error(`[relay] Failed after retries:`, (err as Error).message);\n    captureError({\n      error: err instanceof Error ? err : new Error(String(err)),\n      severity: \"error\",\n      tags: { source: \"whale-node\", operation: \"relay\", node_id: state.config.node_id, channel_id: channelId },\n    });\n  }\n}\n\nasync function markDelivered(state: NetworkState, channelId: string, messageId: string): Promise<void> {\n  try {\n    await fetchWithRetry(\n      state,\n      `${state.config.server_url}/channels/${channelId}/messages/${messageId}/delivered`,\n      { method: \"POST\", headers: { \"Content-Type\": \"application/json\", Authorization: `Bearer ${state.config.api_key}` } },\n      1,\n    );\n  } catch { /* Best effort */ }\n}\n\n// ============================================================================\n// HEARTBEAT\n// ============================================================================\n\nexport async function sendHeartbeat(state: NetworkState): Promise<boolean> {\n  try {\n    const channelStatuses = Array.from(state.adapters.entries()).map(([, adapter]) => {\n      const base: Record<string, unknown> = {\n        type: adapter.type, name: adapter.name,\n        status: adapter.isRunning() ? \"active\" : \"error\", stats: adapter.getStats(),\n      };\n      if (adapter.type === \"imessage\" && \"getLastError\" in adapter) {\n        const imsg = adapter as unknown as IMessageAdapter;\n        base.last_error = imsg.getLastError();\n        base.restart_attempts = imsg.getRestartAttempts();\n      }\n      return base;\n    });\n\n    const res = await fetchWithRetry(\n      state,\n      `${state.config.server_url}/nodes/heartbeat`,\n      {\n        method: \"POST\",\n        headers: { \"Content-Type\": \"application/json\", Authorization: `Bearer ${state.config.api_key}` },\n        body: JSON.stringify({\n          hardware: getHardwareInfo(), capabilities: getCapabilities(), version: VERSION,\n          channels: channelStatuses,\n          runtime_stats: {\n            uptime_seconds: state.startedAt ? Math.floor((Date.now() - state.startedAt.getTime()) / 1000) : 0,\n            messages_relayed: state.messagesRelayed, messages_failed: state.messagesFailed, status: state.status,\n          },\n        }),\n      },\n      2,\n    );\n\n    if (res.ok) { state.heartbeatsSent++; return true; }\n    console.warn(`[heartbeat] Server returned ${res.status}`);\n    state.heartbeatsFailed++;\n    return false;\n  } catch (err) {\n    console.warn(`[heartbeat] Failed:`, (err as Error).message);\n    state.heartbeatsFailed++;\n    if (state.consecutiveServerFailures >= 3) {\n      captureError({\n        error: err instanceof Error ? err : new Error(String(err)),\n        severity: \"warning\",\n        tags: { source: \"whale-node\", operation: \"heartbeat\", node_id: state.config.node_id, failures: String(state.consecutiveServerFailures) },\n      });\n    }\n    return false;\n  }\n}\n"],"mappings":"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","ignoreList":[]}

package/dist/node/runtime-utils.d.ts

@@ -0,0 +1,27 @@
+export declare const HEARTBEAT_INTERVAL_MS = 60000;
+export declare const POLL_INTERVAL_MS = 2000;
+export declare const VERSION = "1.1.0";
+export declare const MAX_RELAY_RETRIES = 3;
+export declare const INITIAL_RETRY_DELAY_MS = 1000;
+export declare const MAX_RETRY_DELAY_MS = 30000;
+export type NodeStatus = "starting" | "connected" | "degraded" | "disconnected";
+export interface NodeRuntimeStats {
+    status: NodeStatus;
+    uptime_seconds: number;
+    heartbeats_sent: number;
+    heartbeats_failed: number;
+    messages_relayed: number;
+    messages_failed: number;
+    consecutive_server_failures: number;
+    last_server_contact: string | null;
+    adapters: Record<string, {
+        type: string;
+        running: boolean;
+        messages_in: number;
+        messages_out: number;
+        errors: number;
+    }>;
+}
+export declare function sleep(ms: number): Promise<void>;
+export declare function getHardwareInfo(): Record<string, unknown>;
+export declare function getCapabilities(): string[];