whale-code 6.5.6 → 6.5.8

package/dist/server/local-agent-gateway-messages.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"local-agent-gateway-messages.js","names":["portalSessions","pendingRequests","pickAgent","pickAgentById","send","truncate","handlePortalRequest","ws","msg","agent","targetAgent","storeId","undefined","target_node_id","type","session_id","reason","capabilities","requester_node_id","nodeId","requester_hostname","hostname","requester_role","set","sessionId","initiatorAgentId","agentId","targetAgentId","startedAt","Date","bytesRelayed","console","log","handlePortalAccept","session","get","initiator","handlePortalReject","delete","handlePortalClose","otherAgentId","other","handleResult","pending","request_id","clearTimeout","timer","result","success","stdout","stderr","exit_code","data","error","killed","cwd","duration_ms","resolve"],"sources":["../../src/server/local-agent-gateway-messages.ts"],"sourcesContent":["// local-agent-gateway-messages.ts — Message routing handlers for portal and result messages\nimport { WebSocket } from \"ws\";\nimport {\n  type LocalAgent, type AgentResult,\n  portalSessions, pendingRequests,\n  pickAgent, pickAgentById, send, truncate,\n} from \"./local-agent-gateway-types.js\";\n\n/** Handle portal_request from an agent wanting to connect to a target node. */\nexport function handlePortalRequest(ws: WebSocket, msg: any, agent: LocalAgent): void {\n  const targetAgent = pickAgent(agent.storeId, undefined, msg.target_node_id);\n  if (!targetAgent) {\n    send(ws, { type: \"portal_reject\", session_id: msg.session_id, reason: \"Target node not online\" });\n    return;\n  }\n  // Forward request to target agent\n  send(targetAgent.ws, {\n    type: \"portal_request\",\n    session_id: msg.session_id,\n    capabilities: msg.capabilities,\n    requester_node_id: agent.nodeId,\n    requester_hostname: agent.hostname,\n    requester_role: msg.requester_role || \"admin\",\n  });\n  // Pre-register session so binary routing works once accepted\n  portalSessions.set(msg.session_id, {\n    sessionId: msg.session_id,\n    initiatorAgentId: agent.agentId,\n    targetAgentId: targetAgent.agentId,\n    storeId: agent.storeId,\n    capabilities: msg.capabilities || [],\n    startedAt: new Date(),\n    bytesRelayed: 0,\n  });\n  console.log(`[portal] Session ${msg.session_id}: ${agent.hostname} -> ${targetAgent.hostname}`);\n}\n\n/** Handle portal_accept from target agent. */\nexport function handlePortalAccept(msg: any, agent: LocalAgent): void {\n  const session = portalSessions.get(msg.session_id);\n  if (session) {\n    const initiator = pickAgentById(session.initiatorAgentId);\n    if (initiator) {\n      send(initiator.ws, { type: \"portal_accept\", session_id: msg.session_id, hostname: agent.hostname });\n    }\n  }\n}\n\n/** Handle portal_reject from target agent. */\nexport function handlePortalReject(msg: any, agent: LocalAgent): void {\n  const session = portalSessions.get(msg.session_id);\n  if (session) {\n    const initiator = pickAgentById(session.initiatorAgentId);\n    if (initiator) {\n      send(initiator.ws, { type: \"portal_reject\", session_id: msg.session_id, reason: msg.reason });\n    }\n    portalSessions.delete(msg.session_id);\n  }\n}\n\n/** Handle portal_close from either side. */\nexport function handlePortalClose(msg: any, agent: LocalAgent): void {\n  const session = portalSessions.get(msg.session_id);\n  if (session) {\n    const otherAgentId = agent.agentId === session.initiatorAgentId\n      ? session.targetAgentId : session.initiatorAgentId;\n    const other = pickAgentById(otherAgentId);\n    if (other) {\n      send(other.ws, { type: \"portal_close\", session_id: msg.session_id });\n    }\n    portalSessions.delete(msg.session_id);\n    console.log(`[portal] Session ${msg.session_id} closed (${session.bytesRelayed} bytes relayed)`);\n  }\n}\n\n/** Handle tool result from agent. */\nexport function handleResult(msg: any): void {\n  const pending = pendingRequests.get(msg.request_id);\n  if (!pending) return; // Already timed out or cancelled\n\n  clearTimeout(pending.timer);\n  pendingRequests.delete(msg.request_id);\n\n  // Truncate large outputs\n  const result: AgentResult = {\n    success: msg.success,\n    stdout: truncate(msg.stdout),\n    stderr: truncate(msg.stderr),\n    exit_code: msg.exit_code,\n    data: msg.data,\n    error: msg.error,\n    killed: msg.killed,\n    cwd: msg.cwd,\n    duration_ms: msg.duration_ms,\n  };\n\n  pending.resolve(result);\n}\n"],"mappings":"AAAA;;AAEA,SAEEA,cAAc,EAAEC,eAAe,EAC/BC,SAAS,EAAEC,aAAa,EAAEC,IAAI,EAAEC,QAAQ,QACnC,gCAAgC;;AAEvC;AACA,OAAO,SAASC,mBAAmBA,CAACC,EAAa,EAAEC,GAAQ,EAAEC,KAAiB,EAAQ;EACpF,MAAMC,WAAW,GAAGR,SAAS,CAACO,KAAK,CAACE,OAAO,EAAEC,SAAS,EAAEJ,GAAG,CAACK,cAAc,CAAC;EAC3E,IAAI,CAACH,WAAW,EAAE;IAChBN,IAAI,CAACG,EAAE,EAAE;MAAEO,IAAI,EAAE,eAAe;MAAEC,UAAU,EAAEP,GAAG,CAACO,UAAU;MAAEC,MAAM,EAAE;IAAyB,CAAC,CAAC;IACjG;EACF;EACA;EACAZ,IAAI,CAACM,WAAW,CAACH,EAAE,EAAE;IACnBO,IAAI,EAAE,gBAAgB;IACtBC,UAAU,EAAEP,GAAG,CAACO,UAAU;IAC1BE,YAAY,EAAET,GAAG,CAACS,YAAY;IAC9BC,iBAAiB,EAAET,KAAK,CAACU,MAAM;IAC/BC,kBAAkB,EAAEX,KAAK,CAACY,QAAQ;IAClCC,cAAc,EAAEd,GAAG,CAACc,cAAc,IAAI;EACxC,CAAC,CAAC;EACF;EACAtB,cAAc,CAACuB,GAAG,CAACf,GAAG,CAACO,UAAU,EAAE;IACjCS,SAAS,EAAEhB,GAAG,CAACO,UAAU;IACzBU,gBAAgB,EAAEhB,KAAK,CAACiB,OAAO;IAC/BC,aAAa,EAAEjB,WAAW,CAACgB,OAAO;IAClCf,OAAO,EAAEF,KAAK,CAACE,OAAO;IACtBM,YAAY,EAAET,GAAG,CAACS,YAAY,IAAI,EAAE;IACpCW,SAAS,EAAE,IAAIC,IAAI,CAAC,CAAC;IACrBC,YAAY,EAAE;EAChB,CAAC,CAAC;EACFC,OAAO,CAACC,GAAG,CAAC,oBAAoBxB,GAAG,CAACO,UAAU,KAAKN,KAAK,CAACY,QAAQ,OAAOX,WAAW,CAACW,QAAQ,EAAE,CAAC;AACjG;;AAEA;AACA,OAAO,SAASY,kBAAkBA,CAACzB,GAAQ,EAAEC,KAAiB,EAAQ;EACpE,MAAMyB,OAAO,GAAGlC,cAAc,CAACmC,GAAG,CAAC3B,GAAG,CAACO,UAAU,CAAC;EAClD,IAAImB,OAAO,EAAE;IACX,MAAME,SAAS,GAAGjC,aAAa,CAAC+B,OAAO,CAACT,gBAAgB,CAAC;IACzD,IAAIW,SAAS,EAAE;MACbhC,IAAI,CAACgC,SAAS,CAAC7B,EAAE,EAAE;QAAEO,IAAI,EAAE,eAAe;QAAEC,UAAU,EAAEP,GAAG,CAACO,UAAU;QAAEM,QAAQ,EAAEZ,KAAK,CAACY;MAAS,CAAC,CAAC;IACrG;EACF;AACF;;AAEA;AACA,OAAO,SAASgB,kBAAkBA,CAAC7B,GAAQ,EAAEC,KAAiB,EAAQ;EACpE,MAAMyB,OAAO,GAAGlC,cAAc,CAACmC,GAAG,CAAC3B,GAAG,CAACO,UAAU,CAAC;EAClD,IAAImB,OAAO,EAAE;IACX,MAAME,SAAS,GAAGjC,aAAa,CAAC+B,OAAO,CAACT,gBAAgB,CAAC;IACzD,IAAIW,SAAS,EAAE;MACbhC,IAAI,CAACgC,SAAS,CAAC7B,EAAE,EAAE;QAAEO,IAAI,EAAE,eAAe;QAAEC,UAAU,EAAEP,GAAG,CAACO,UAAU;QAAEC,MAAM,EAAER,GAAG,CAACQ;MAAO,CAAC,CAAC;IAC/F;IACAhB,cAAc,CAACsC,MAAM,CAAC9B,GAAG,CAACO,UAAU,CAAC;EACvC;AACF;;AAEA;AACA,OAAO,SAASwB,iBAAiBA,CAAC/B,GAAQ,EAAEC,KAAiB,EAAQ;EACnE,MAAMyB,OAAO,GAAGlC,cAAc,CAACmC,GAAG,CAAC3B,GAAG,CAACO,UAAU,CAAC;EAClD,IAAImB,OAAO,EAAE;IACX,MAAMM,YAAY,GAAG/B,KAAK,CAACiB,OAAO,KAAKQ,OAAO,CAACT,gBAAgB,GAC3DS,OAAO,CAACP,aAAa,GAAGO,OAAO,CAACT,gBAAgB;IACpD,MAAMgB,KAAK,GAAGtC,aAAa,CAACqC,YAAY,CAAC;IACzC,IAAIC,KAAK,EAAE;MACTrC,IAAI,CAACqC,KAAK,CAAClC,EAAE,EAAE;QAAEO,IAAI,EAAE,cAAc;QAAEC,UAAU,EAAEP,GAAG,CAACO;MAAW,CAAC,CAAC;IACtE;IACAf,cAAc,CAACsC,MAAM,CAAC9B,GAAG,CAACO,UAAU,CAAC;IACrCgB,OAAO,CAACC,GAAG,CAAC,oBAAoBxB,GAAG,CAACO,UAAU,YAAYmB,OAAO,CAACJ,YAAY,iBAAiB,CAAC;EAClG;AACF;;AAEA;AACA,OAAO,SAASY,YAAYA,CAAClC,GAAQ,EAAQ;EAC3C,MAAMmC,OAAO,GAAG1C,eAAe,CAACkC,GAAG,CAAC3B,GAAG,CAACoC,UAAU,CAAC;EACnD,IAAI,CAACD,OAAO,EAAE,OAAO,CAAC;;EAEtBE,YAAY,CAACF,OAAO,CAACG,KAAK,CAAC;EAC3B7C,eAAe,CAACqC,MAAM,CAAC9B,GAAG,CAACoC,UAAU,CAAC;;EAEtC;EACA,MAAMG,MAAmB,GAAG;IAC1BC,OAAO,EAAExC,GAAG,CAACwC,OAAO;IACpBC,MAAM,EAAE5C,QAAQ,CAACG,GAAG,CAACyC,MAAM,CAAC;IAC5BC,MAAM,EAAE7C,QAAQ,CAACG,GAAG,CAAC0C,MAAM,CAAC;IAC5BC,SAAS,EAAE3C,GAAG,CAAC2C,SAAS;IACxBC,IAAI,EAAE5C,GAAG,CAAC4C,IAAI;IACdC,KAAK,EAAE7C,GAAG,CAAC6C,KAAK;IAChBC,MAAM,EAAE9C,GAAG,CAAC8C,MAAM;IAClBC,GAAG,EAAE/C,GAAG,CAAC+C,GAAG;IACZC,WAAW,EAAEhD,GAAG,CAACgD;EACnB,CAAC;EAEDb,OAAO,CAACc,OAAO,CAACV,MAAM,CAAC;AACzB","ignoreList":[]}

package/dist/server/local-agent-gateway-stats.d.ts

@@ -0,0 +1,53 @@
+import { type AgentResult } from "./local-agent-gateway-types.js";
+/**
+ * Get gateway statistics.
+ */
+export declare function getGatewayStats(): {
+    total_agents: number;
+    total_stores: number;
+    pending_requests: number;
+    agents_by_store: Record<string, number>;
+};
+/**
+ * Get active remote desktop sessions.
+ */
+export declare function getRemoteDesktopSessions(): Array<{
+    session_id: string;
+    store_id: string;
+    user_id: string;
+    agent_id: string;
+    started_at: string;
+    frames_relayed: number;
+    bytes_relayed: number;
+}>;
+/**
+ * Get active portal sessions.
+ */
+export declare function getPortalSessions(): Array<{
+    session_id: string;
+    store_id: string;
+    initiator_agent_id: string;
+    target_agent_id: string;
+    capabilities: string[];
+    started_at: string;
+    bytes_relayed: number;
+}>;
+export interface ClusterCommandArgs {
+    action: string;
+    task?: string;
+    max_cells?: number;
+    working_directory?: string;
+    cluster_id?: string;
+    channel_id?: string;
+    conversation_id?: string;
+}
+/**
+ * Execute a cluster command on the connected whale-node.
+ * Sends via WebSocket and waits for the result.
+ */
+export declare function executeClusterCommand(storeId: string, args: ClusterCommandArgs, options?: {
+    timeout?: number;
+    agent_id?: string;
+    node_id?: string;
+}): Promise<AgentResult>;
+export declare function shutdownGateway(): void;

package/dist/server/local-agent-gateway-stats.js

@@ -0,0 +1,129 @@
+// local-agent-gateway-stats.ts — Stats, sessions, cluster commands, and shutdown
+
+import { WebSocket } from "ws";
+import { randomUUID } from "node:crypto";
+import { agentPool, pendingRequests, rdSessions, portalSessions, pickAgent, send } from "./local-agent-gateway-types.js";
+import { clearHeartbeat, closeWss } from "./local-agent-gateway-init.js";
+
+/**
+ * Get gateway statistics.
+ */
+export function getGatewayStats() {
+  const agentsByStore = {};
+  let totalAgents = 0;
+  for (const [storeId, agents] of agentPool) {
+    const active = agents.filter(a => a.ws.readyState === WebSocket.OPEN).length;
+    if (active > 0) {
+      agentsByStore[storeId] = active;
+      totalAgents += active;
+    }
+  }
+  return {
+    total_agents: totalAgents,
+    total_stores: Object.keys(agentsByStore).length,
+    pending_requests: pendingRequests.size,
+    agents_by_store: agentsByStore
+  };
+}
+
+/**
+ * Get active remote desktop sessions.
+ */
+export function getRemoteDesktopSessions() {
+  return Array.from(rdSessions.values()).map(s => ({
+    session_id: s.sessionId,
+    store_id: s.storeId,
+    user_id: s.userId,
+    agent_id: s.agentId,
+    started_at: s.startedAt.toISOString(),
+    frames_relayed: s.framesRelayed,
+    bytes_relayed: s.bytesRelayed
+  }));
+}
+
+/**
+ * Get active portal sessions.
+ */
+export function getPortalSessions() {
+  return Array.from(portalSessions.values()).map(s => ({
+    session_id: s.sessionId,
+    store_id: s.storeId,
+    initiator_agent_id: s.initiatorAgentId,
+    target_agent_id: s.targetAgentId,
+    capabilities: s.capabilities,
+    started_at: s.startedAt.toISOString(),
+    bytes_relayed: s.bytesRelayed
+  }));
+}
+
+// ============================================================================
+// CLUSTER COMMANDS — routes cluster operations to whale-node
+// ============================================================================
+
+/**
+ * Execute a cluster command on the connected whale-node.
+ * Sends via WebSocket and waits for the result.
+ */
+export async function executeClusterCommand(storeId, args, options = {}) {
+  const agent = pickAgent(storeId, options.agent_id, options.node_id);
+  if (!agent) {
+    return {
+      success: false,
+      error: "No local agent connected for cluster commands."
+    };
+  }
+  const requestId = randomUUID();
+  const timeout = Math.min(options.timeout || 60000, 600000);
+  const sent = send(agent.ws, {
+    type: "cluster_command",
+    request_id: requestId,
+    args
+  });
+  if (!sent) return {
+    success: false,
+    error: "Agent connection closed"
+  };
+  return new Promise((resolve, reject) => {
+    const timer = setTimeout(() => {
+      pendingRequests.delete(requestId);
+      resolve({
+        success: false,
+        error: `Cluster command timed out after ${timeout}ms`
+      });
+    }, timeout + 5000);
+    pendingRequests.set(requestId, {
+      resolve,
+      reject,
+      timer,
+      agentId: agent.agentId
+    });
+  });
+}
+export function shutdownGateway() {
+  clearHeartbeat();
+
+  // Close all agent connections
+  for (const [, agents] of agentPool) {
+    for (const agent of agents) {
+      send(agent.ws, {
+        type: "shutdown",
+        message: "Server shutting down"
+      });
+      agent.ws.close(1001, "Server shutdown");
+    }
+  }
+  agentPool.clear();
+
+  // Reject all pending requests
+  for (const [, pending] of pendingRequests) {
+    clearTimeout(pending.timer);
+    pending.resolve({
+      success: false,
+      error: "Gateway shutting down"
+    });
+  }
+  pendingRequests.clear();
+  closeWss();
+  console.log("[local-agent] Gateway shut down");
+}
+//# sourceMappingURL=local-agent-gateway-stats.js.map

package/dist/server/local-agent-gateway-stats.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"local-agent-gateway-stats.js","names":["WebSocket","randomUUID","agentPool","pendingRequests","rdSessions","portalSessions","pickAgent","send","clearHeartbeat","closeWss","getGatewayStats","agentsByStore","totalAgents","storeId","agents","active","filter","a","ws","readyState","OPEN","length","total_agents","total_stores","Object","keys","pending_requests","size","agents_by_store","getRemoteDesktopSessions","Array","from","values","map","s","session_id","sessionId","store_id","user_id","userId","agent_id","agentId","started_at","startedAt","toISOString","frames_relayed","framesRelayed","bytes_relayed","bytesRelayed","getPortalSessions","initiator_agent_id","initiatorAgentId","target_agent_id","targetAgentId","capabilities","executeClusterCommand","args","options","agent","node_id","success","error","requestId","timeout","Math","min","sent","type","request_id","Promise","resolve","reject","timer","setTimeout","delete","set","shutdownGateway","message","close","clear","pending","clearTimeout","console","log"],"sources":["../../src/server/local-agent-gateway-stats.ts"],"sourcesContent":["// local-agent-gateway-stats.ts — Stats, sessions, cluster commands, and shutdown\n\nimport { WebSocket } from \"ws\";\nimport { randomUUID } from \"node:crypto\";\nimport {\n  type AgentResult,\n  agentPool, pendingRequests, rdSessions, portalSessions,\n  pickAgent, send,\n} from \"./local-agent-gateway-types.js\";\nimport { clearHeartbeat, closeWss } from \"./local-agent-gateway-init.js\";\n\n/**\n * Get gateway statistics.\n */\nexport function getGatewayStats(): {\n  total_agents: number;\n  total_stores: number;\n  pending_requests: number;\n  agents_by_store: Record<string, number>;\n} {\n  const agentsByStore: Record<string, number> = {};\n  let totalAgents = 0;\n  for (const [storeId, agents] of agentPool) {\n    const active = agents.filter(a => a.ws.readyState === WebSocket.OPEN).length;\n    if (active > 0) {\n      agentsByStore[storeId] = active;\n      totalAgents += active;\n    }\n  }\n  return {\n    total_agents: totalAgents,\n    total_stores: Object.keys(agentsByStore).length,\n    pending_requests: pendingRequests.size,\n    agents_by_store: agentsByStore,\n  };\n}\n\n/**\n * Get active remote desktop sessions.\n */\nexport function getRemoteDesktopSessions(): Array<{\n  session_id: string;\n  store_id: string;\n  user_id: string;\n  agent_id: string;\n  started_at: string;\n  frames_relayed: number;\n  bytes_relayed: number;\n}> {\n  return Array.from(rdSessions.values()).map(s => ({\n    session_id: s.sessionId,\n    store_id: s.storeId,\n    user_id: s.userId,\n    agent_id: s.agentId,\n    started_at: s.startedAt.toISOString(),\n    frames_relayed: s.framesRelayed,\n    bytes_relayed: s.bytesRelayed,\n  }));\n}\n\n/**\n * Get active portal sessions.\n */\nexport function getPortalSessions(): Array<{\n  session_id: string;\n  store_id: string;\n  initiator_agent_id: string;\n  target_agent_id: string;\n  capabilities: string[];\n  started_at: string;\n  bytes_relayed: number;\n}> {\n  return Array.from(portalSessions.values()).map(s => ({\n    session_id: s.sessionId,\n    store_id: s.storeId,\n    initiator_agent_id: s.initiatorAgentId,\n    target_agent_id: s.targetAgentId,\n    capabilities: s.capabilities,\n    started_at: s.startedAt.toISOString(),\n    bytes_relayed: s.bytesRelayed,\n  }));\n}\n\n// ============================================================================\n// CLUSTER COMMANDS — routes cluster operations to whale-node\n// ============================================================================\n\nexport interface ClusterCommandArgs {\n  action: string;\n  task?: string;\n  max_cells?: number;\n  working_directory?: string;\n  cluster_id?: string;\n  channel_id?: string;\n  conversation_id?: string;\n}\n\n/**\n * Execute a cluster command on the connected whale-node.\n * Sends via WebSocket and waits for the result.\n */\nexport async function executeClusterCommand(\n  storeId: string,\n  args: ClusterCommandArgs,\n  options: { timeout?: number; agent_id?: string; node_id?: string } = {},\n): Promise<AgentResult> {\n  const agent = pickAgent(storeId, options.agent_id, options.node_id);\n  if (!agent) {\n    return {\n      success: false,\n      error: \"No local agent connected for cluster commands.\",\n    };\n  }\n\n  const requestId = randomUUID();\n  const timeout = Math.min(options.timeout || 60000, 600000);\n\n  const sent = send(agent.ws, {\n    type: \"cluster_command\",\n    request_id: requestId,\n    args,\n  });\n  if (!sent) return { success: false, error: \"Agent connection closed\" };\n\n  return new Promise<AgentResult>((resolve, reject) => {\n    const timer = setTimeout(() => {\n      pendingRequests.delete(requestId);\n      resolve({\n        success: false,\n        error: `Cluster command timed out after ${timeout}ms`,\n      });\n    }, timeout + 5000);\n\n    pendingRequests.set(requestId, { resolve, reject, timer, agentId: agent.agentId });\n  });\n}\n\nexport function shutdownGateway(): void {\n  clearHeartbeat();\n\n  // Close all agent connections\n  for (const [, agents] of agentPool) {\n    for (const agent of agents) {\n      send(agent.ws, { type: \"shutdown\", message: \"Server shutting down\" });\n      agent.ws.close(1001, \"Server shutdown\");\n    }\n  }\n  agentPool.clear();\n\n  // Reject all pending requests\n  for (const [, pending] of pendingRequests) {\n    clearTimeout(pending.timer);\n    pending.resolve({ success: false, error: \"Gateway shutting down\" });\n  }\n  pendingRequests.clear();\n\n  closeWss();\n\n  console.log(\"[local-agent] Gateway shut down\");\n}\n"],"mappings":"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","ignoreList":[]}

package/dist/server/local-agent-gateway-types.d.ts

@@ -0,0 +1,94 @@
+import { WebSocket } from "ws";
+export interface LocalAgent {
+    ws: WebSocket;
+    storeId: string;
+    userId: string | null;
+    nodeId: string | null;
+    capabilities: string[];
+    connectedAt: Date;
+    lastPong: number;
+    agentId: string;
+    platform: string;
+    hostname: string;
+}
+interface AgentRequest {
+    resolve: (result: AgentResult) => void;
+    reject: (err: Error) => void;
+    timer: ReturnType<typeof setTimeout>;
+    agentId: string;
+}
+export interface AgentResult {
+    success: boolean;
+    stdout?: string;
+    stderr?: string;
+    exit_code?: number;
+    data?: unknown;
+    error?: string;
+    killed?: boolean;
+    cwd?: string;
+    duration_ms?: number;
+    tools?: string[];
+}
+export interface AgentAuthMessage {
+    type: "auth";
+    api_key: string;
+    capabilities?: string[];
+    platform?: string;
+    hostname?: string;
+    version?: string;
+}
+export interface RemoteDesktopSession {
+    sessionId: string;
+    viewerWs: WebSocket;
+    agentId: string;
+    storeId: string;
+    userId: string;
+    startedAt: Date;
+    framesRelayed: number;
+    bytesRelayed: number;
+}
+export interface ViewerAuthMessage {
+    type: "auth";
+    role: "viewer";
+    token: string;
+    store_id: string;
+    target_node_id?: string;
+}
+interface PortalRelaySession {
+    sessionId: string;
+    initiatorAgentId: string;
+    targetAgentId: string;
+    storeId: string;
+    capabilities: string[];
+    startedAt: Date;
+    bytesRelayed: number;
+}
+/** Map<storeId, LocalAgent[]> — multiple agents per store */
+export declare const agentPool: Map<string, LocalAgent[]>;
+/** Map<requestId, pending request> */
+export declare const pendingRequests: Map<string, AgentRequest>;
+/** Map<sessionId, RemoteDesktopSession> — active remote desktop relay sessions */
+export declare const rdSessions: Map<string, RemoteDesktopSession>;
+/** Map<sessionId, PortalRelaySession> — active portal sessions */
+export declare const portalSessions: Map<string, PortalRelaySession>;
+export declare const PORTAL_MARKER = 1;
+export declare const MAX_AGENTS_PER_STORE = 25;
+export declare const HEARTBEAT_INTERVAL_MS = 30000;
+export declare const PONG_TIMEOUT_MS = 45000;
+export declare const MAX_OUTPUT_CHARS: number;
+export declare function pickAgent(storeId: string, agentId?: string, nodeId?: string): LocalAgent | null;
+export declare function pickAgentById(agentId: string): LocalAgent | null;
+export declare function isJsonString(data: any): boolean;
+export declare function send(ws: WebSocket, data: unknown): boolean;
+export declare function failPendingRequestsForAgent(agentId: string, reason: string): void;
+export declare function truncate(text?: string): string | undefined;
+export interface ClusterCommandArgs {
+    action: string;
+    task?: string;
+    max_cells?: number;
+    working_directory?: string;
+    cluster_id?: string;
+    channel_id?: string;
+    conversation_id?: string;
+}
+export {};

package/dist/server/local-agent-gateway-types.js

@@ -0,0 +1,78 @@
+// local-agent-gateway-types.ts — Types, constants, state maps, and internal helpers
+import { WebSocket } from "ws";
+
+// Messages: server → agent
+
+// Messages: agent → server
+
+// ============================================================================
+// CONNECTION POOL
+// ============================================================================
+
+// ============================================================================
+// PORTAL TYPES
+// ============================================================================
+
+/** Map<storeId, LocalAgent[]> — multiple agents per store */
+export const agentPool = new Map();
+
+/** Map<requestId, pending request> */
+export const pendingRequests = new Map();
+
+/** Map<sessionId, RemoteDesktopSession> — active remote desktop relay sessions */
+export const rdSessions = new Map();
+
+/** Map<sessionId, PortalRelaySession> — active portal sessions */
+export const portalSessions = new Map();
+export const PORTAL_MARKER = 0x01;
+export const MAX_AGENTS_PER_STORE = 25;
+export const HEARTBEAT_INTERVAL_MS = 30_000;
+export const PONG_TIMEOUT_MS = 45_000;
+export const MAX_OUTPUT_CHARS = 500 * 1024;
+export function pickAgent(storeId, agentId, nodeId) {
+  const agents = agentPool.get(storeId.toLowerCase());
+  if (!agents?.length) return null;
+  const open = agents.filter(a => a.ws.readyState === WebSocket.OPEN);
+  if (open.length === 0) return null;
+  if (agentId) return open.find(a => a.agentId === agentId) || null;
+  if (nodeId) return open.find(a => a.nodeId === nodeId) || null;
+  return open.reduce((best, a) => a.lastPong > best.lastPong ? a : best);
+}
+export function pickAgentById(agentId) {
+  for (const [, agents] of agentPool) {
+    const found = agents.find(a => a.agentId === agentId && a.ws.readyState === WebSocket.OPEN);
+    if (found) return found;
+  }
+  return null;
+}
+export function isJsonString(data) {
+  if (typeof data === "string") return true;
+  if (Buffer.isBuffer(data)) {
+    return data.length > 0 && (data[0] === 0x7b || data[0] === 0x5b);
+  }
+  return false;
+}
+export function send(ws, data) {
+  if (ws.readyState === WebSocket.OPEN) {
+    ws.send(JSON.stringify(data));
+    return true;
+  }
+  return false;
+}
+export function failPendingRequestsForAgent(agentId, reason) {
+  for (const [requestId, pending] of pendingRequests) {
+    if (pending.agentId === agentId) {
+      clearTimeout(pending.timer);
+      pendingRequests.delete(requestId);
+      pending.resolve({
+        success: false,
+        error: reason
+      });
+    }
+  }
+}
+export function truncate(text) {
+  if (!text || text.length <= MAX_OUTPUT_CHARS) return text;
+  return text.substring(0, MAX_OUTPUT_CHARS) + `\n...[truncated, ${text.length} total chars]`;
+}
+//# sourceMappingURL=local-agent-gateway-types.js.map

package/dist/server/local-agent-gateway-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"local-agent-gateway-types.js","names":["WebSocket","agentPool","Map","pendingRequests","rdSessions","portalSessions","PORTAL_MARKER","MAX_AGENTS_PER_STORE","HEARTBEAT_INTERVAL_MS","PONG_TIMEOUT_MS","MAX_OUTPUT_CHARS","pickAgent","storeId","agentId","nodeId","agents","get","toLowerCase","length","open","filter","a","ws","readyState","OPEN","find","reduce","best","lastPong","pickAgentById","found","isJsonString","data","Buffer","isBuffer","send","JSON","stringify","failPendingRequestsForAgent","reason","requestId","pending","clearTimeout","timer","delete","resolve","success","error","truncate","text","substring"],"sources":["../../src/server/local-agent-gateway-types.ts"],"sourcesContent":["// local-agent-gateway-types.ts — Types, constants, state maps, and internal helpers\nimport { WebSocket } from \"ws\";\nimport { randomUUID } from \"node:crypto\";\n\nexport interface LocalAgent {\n  ws: WebSocket;\n  storeId: string;\n  userId: string | null;\n  nodeId: string | null;\n  capabilities: string[];       // discovered local tools\n  connectedAt: Date;\n  lastPong: number;\n  agentId: string;              // unique per connection\n  platform: string;             // darwin, linux, win32\n  hostname: string;\n}\n\ninterface AgentRequest {\n  resolve: (result: AgentResult) => void;\n  reject: (err: Error) => void;\n  timer: ReturnType<typeof setTimeout>;\n  agentId: string;\n}\n\nexport interface AgentResult {\n  success: boolean;\n  stdout?: string;\n  stderr?: string;\n  exit_code?: number;\n  data?: unknown;\n  error?: string;\n  killed?: boolean;\n  cwd?: string;\n  duration_ms?: number;\n  tools?: string[];\n}\n\n// Messages: server → agent\ninterface ServerExecMessage {\n  type: \"exec\";\n  request_id: string;\n  command: string;\n  session_id?: string;\n  timeout?: number;\n}\n\ninterface ServerToolMessage {\n  type: \"tool_exec\";\n  request_id: string;\n  tool: string;\n  args: Record<string, unknown>;\n  timeout?: number;\n}\n\n// Messages: agent → server\nexport interface AgentAuthMessage {\n  type: \"auth\";\n  api_key: string;\n  capabilities?: string[];\n  platform?: string;\n  hostname?: string;\n  version?: string;\n}\n\ninterface AgentResultMessage {\n  type: \"result\";\n  request_id: string;\n  success: boolean;\n  stdout?: string;\n  stderr?: string;\n  exit_code?: number;\n  data?: unknown;\n  error?: string;\n  killed?: boolean;\n  cwd?: string;\n  duration_ms?: number;\n}\n\ninterface AgentToolsMessage {\n  type: \"tools\";\n  tools: string[];\n}\n\ninterface AgentPongMessage {\n  type: \"pong\";\n}\n\ntype AgentMessage = AgentAuthMessage | AgentResultMessage | AgentToolsMessage | AgentPongMessage;\n\n\nexport interface RemoteDesktopSession {\n  sessionId: string;\n  viewerWs: WebSocket;\n  agentId: string;\n  storeId: string;\n  userId: string;\n  startedAt: Date;\n  framesRelayed: number;\n  bytesRelayed: number;\n}\n\nexport interface ViewerAuthMessage {\n  type: \"auth\";\n  role: \"viewer\";\n  token: string;          // Supabase JWT\n  store_id: string;\n  target_node_id?: string;\n}\n\n// ============================================================================\n// CONNECTION POOL\n// ============================================================================\n\n// ============================================================================\n// PORTAL TYPES\n// ============================================================================\n\ninterface PortalRelaySession {\n  sessionId: string;\n  initiatorAgentId: string;\n  targetAgentId: string;\n  storeId: string;\n  capabilities: string[];\n  startedAt: Date;\n  bytesRelayed: number;\n}\n\n/** Map<storeId, LocalAgent[]> — multiple agents per store */\nexport const agentPool = new Map<string, LocalAgent[]>();\n\n/** Map<requestId, pending request> */\nexport const pendingRequests = new Map<string, AgentRequest>();\n\n/** Map<sessionId, RemoteDesktopSession> — active remote desktop relay sessions */\nexport const rdSessions = new Map<string, RemoteDesktopSession>();\n\n/** Map<sessionId, PortalRelaySession> — active portal sessions */\nexport const portalSessions = new Map<string, PortalRelaySession>();\n\nexport const PORTAL_MARKER = 0x01;\nexport const MAX_AGENTS_PER_STORE = 25;\nexport const HEARTBEAT_INTERVAL_MS = 30_000;\nexport const PONG_TIMEOUT_MS = 45_000;\nexport const MAX_OUTPUT_CHARS = 500 * 1024;\n\nexport function pickAgent(storeId: string, agentId?: string, nodeId?: string): LocalAgent | null {\n  const agents = agentPool.get(storeId.toLowerCase());\n  if (!agents?.length) return null;\n  const open = agents.filter(a => a.ws.readyState === WebSocket.OPEN);\n  if (open.length === 0) return null;\n  if (agentId) return open.find(a => a.agentId === agentId) || null;\n  if (nodeId) return open.find(a => a.nodeId === nodeId) || null;\n  return open.reduce((best, a) => a.lastPong > best.lastPong ? a : best);\n}\n\nexport function pickAgentById(agentId: string): LocalAgent | null {\n  for (const [, agents] of agentPool) {\n    const found = agents.find(a => a.agentId === agentId && a.ws.readyState === WebSocket.OPEN);\n    if (found) return found;\n  }\n  return null;\n}\n\nexport function isJsonString(data: any): boolean {\n  if (typeof data === \"string\") return true;\n  if (Buffer.isBuffer(data)) {\n    return data.length > 0 && (data[0] === 0x7b || data[0] === 0x5b);\n  }\n  return false;\n}\n\nexport function send(ws: WebSocket, data: unknown): boolean {\n  if (ws.readyState === WebSocket.OPEN) {\n    ws.send(JSON.stringify(data));\n    return true;\n  }\n  return false;\n}\n\nexport function failPendingRequestsForAgent(agentId: string, reason: string): void {\n  for (const [requestId, pending] of pendingRequests) {\n    if (pending.agentId === agentId) {\n      clearTimeout(pending.timer);\n      pendingRequests.delete(requestId);\n      pending.resolve({ success: false, error: reason });\n    }\n  }\n}\n\nexport function truncate(text?: string): string | undefined {\n  if (!text || text.length <= MAX_OUTPUT_CHARS) return text;\n  return text.substring(0, MAX_OUTPUT_CHARS) + `\\n...[truncated, ${text.length} total chars]`;\n}\n\nexport interface ClusterCommandArgs {\n  action: string;\n  task?: string;\n  max_cells?: number;\n  working_directory?: string;\n  cluster_id?: string;\n  channel_id?: string;\n  conversation_id?: string;\n}\n"],"mappings":"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","ignoreList":[]}

package/dist/server/local-agent-gateway.d.ts

@@ -123,4 +123,10 @@ export declare function executeClusterCommand(storeId: string, args: ClusterComm
     agent_id?: string;
     node_id?: string;
 }): Promise<AgentResult>;
+import type { TaskAssignment } from "./lib/session-types.js";
+/**
+ * Assign a persistent task to a specific node via WebSocket.
+ * The node will run its own agent loop using the Anthropic SDK directly.
+ */
+export declare function assignTaskToNode(storeId: string, nodeId: string, task: TaskAssignment): Promise<boolean>;
 export declare function shutdownGateway(): void;

package/dist/server/local-agent-gateway.js

@@ -433,6 +433,28 @@ function handleConnection(ws, _req) {
       };
       pending.resolve(result);
     }
+
+    // Handle task progress from nodes (relay to session observers)
+    if (msg.type === "task_progress" && msg.session_id) {
+      broadcastSessionEvent(msg.session_id, msg.event || {
+        type: "progress",
+        text: msg.text
+      });
+      return;
+    }
+
+    // Handle task completion from nodes
+    if (msg.type === "task_result" && msg.session_id) {
+      broadcastSessionEvent(msg.session_id, {
+        type: "complete",
+        success: msg.success,
+        response: msg.response,
+        error: msg.error,
+        tokens: msg.tokens,
+        cost_usd: msg.cost_usd
+      });
+      return;
+    }
   });
   ws.on("close", () => {
     clearTimeout(authTimer);
@@ -884,6 +906,24 @@ export async function executeClusterCommand(storeId, args, options = {}) {
   });
 }
 
+// ============================================================================
+// TASK ASSIGNMENT — persistent agent tasks on nodes
+// ============================================================================
+
+import { broadcastSessionEvent } from "./session-events.js";
+/**
+ * Assign a persistent task to a specific node via WebSocket.
+ * The node will run its own agent loop using the Anthropic SDK directly.
+ */
+export async function assignTaskToNode(storeId, nodeId, task) {
+  const agent = pickAgent(storeId, undefined, nodeId);
+  if (!agent) return false;
+  return send(agent.ws, {
+    type: "assign_task",
+    ...task
+  });
+}
+
 // ============================================================================
 // SHUTDOWN
 // ============================================================================