@geminixiang/mikan 1.0.0-beta.21 → 1.0.0-beta.23

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (199) hide show
  1. package/CHANGELOG.md +55 -0
  2. package/README.md +12 -8
  3. package/dist/adapters/discord/bot.d.ts.map +1 -1
  4. package/dist/adapters/discord/bot.js +13 -14
  5. package/dist/adapters/discord/bot.js.map +1 -1
  6. package/dist/adapters/intake.d.ts.map +1 -1
  7. package/dist/adapters/intake.js +5 -0
  8. package/dist/adapters/intake.js.map +1 -1
  9. package/dist/adapters/slack/bot.d.ts.map +1 -1
  10. package/dist/adapters/slack/bot.js +13 -2
  11. package/dist/adapters/slack/bot.js.map +1 -1
  12. package/dist/adapters/slack/types.d.ts +2 -0
  13. package/dist/adapters/slack/types.d.ts.map +1 -1
  14. package/dist/adapters/slack/types.js.map +1 -1
  15. package/dist/agent.d.ts.map +1 -1
  16. package/dist/agent.js +34 -24
  17. package/dist/agent.js.map +1 -1
  18. package/dist/cli/boot.d.ts +1 -1
  19. package/dist/cli/boot.d.ts.map +1 -1
  20. package/dist/cli/boot.js +7 -15
  21. package/dist/cli/boot.js.map +1 -1
  22. package/dist/commands/login.js +2 -2
  23. package/dist/commands/login.js.map +1 -1
  24. package/dist/commands/sandbox.d.ts.map +1 -1
  25. package/dist/commands/sandbox.js +4 -7
  26. package/dist/commands/sandbox.js.map +1 -1
  27. package/dist/commands/text.js +1 -1
  28. package/dist/commands/text.js.map +1 -1
  29. package/dist/config.d.ts.map +1 -1
  30. package/dist/config.js +12 -39
  31. package/dist/config.js.map +1 -1
  32. package/dist/execution-resolver.d.ts +6 -8
  33. package/dist/execution-resolver.d.ts.map +1 -1
  34. package/dist/execution-resolver.js +73 -107
  35. package/dist/execution-resolver.js.map +1 -1
  36. package/dist/harness/index.d.ts +1 -1
  37. package/dist/harness/index.d.ts.map +1 -1
  38. package/dist/harness/index.js.map +1 -1
  39. package/dist/harness/runner.d.ts +9 -6
  40. package/dist/harness/runner.d.ts.map +1 -1
  41. package/dist/harness/runner.js +42 -20
  42. package/dist/harness/runner.js.map +1 -1
  43. package/dist/harness/subagent-runner.d.ts +14 -13
  44. package/dist/harness/subagent-runner.d.ts.map +1 -1
  45. package/dist/harness/subagent-runner.js +116 -24
  46. package/dist/harness/subagent-runner.js.map +1 -1
  47. package/dist/harness/types.d.ts +14 -0
  48. package/dist/harness/types.d.ts.map +1 -1
  49. package/dist/harness/types.js.map +1 -1
  50. package/dist/harness/usage.d.ts +6 -0
  51. package/dist/harness/usage.d.ts.map +1 -0
  52. package/dist/harness/usage.js +32 -0
  53. package/dist/harness/usage.js.map +1 -0
  54. package/dist/index.d.ts +3 -2
  55. package/dist/index.d.ts.map +1 -1
  56. package/dist/index.js +1 -1
  57. package/dist/index.js.map +1 -1
  58. package/dist/main.js +19 -87
  59. package/dist/main.js.map +1 -1
  60. package/dist/runtime/conversation-runtime.d.ts.map +1 -1
  61. package/dist/runtime/conversation-runtime.js +23 -79
  62. package/dist/runtime/conversation-runtime.js.map +1 -1
  63. package/dist/runtime/session-lifecycle.d.ts +19 -0
  64. package/dist/runtime/session-lifecycle.d.ts.map +1 -0
  65. package/dist/runtime/session-lifecycle.js +76 -0
  66. package/dist/runtime/session-lifecycle.js.map +1 -0
  67. package/dist/runtime/types.d.ts +5 -0
  68. package/dist/runtime/types.d.ts.map +1 -1
  69. package/dist/runtime/types.js.map +1 -1
  70. package/dist/sandbox/agent-sandbox.d.ts +18 -0
  71. package/dist/sandbox/agent-sandbox.d.ts.map +1 -0
  72. package/dist/sandbox/agent-sandbox.js +234 -0
  73. package/dist/sandbox/agent-sandbox.js.map +1 -0
  74. package/dist/sandbox/cloudflare.d.ts.map +1 -1
  75. package/dist/sandbox/cloudflare.js +1 -0
  76. package/dist/sandbox/cloudflare.js.map +1 -1
  77. package/dist/sandbox/container.d.ts.map +1 -1
  78. package/dist/sandbox/container.js +1 -0
  79. package/dist/sandbox/container.js.map +1 -1
  80. package/dist/sandbox/host.d.ts.map +1 -1
  81. package/dist/sandbox/host.js +1 -0
  82. package/dist/sandbox/host.js.map +1 -1
  83. package/dist/sandbox/identity.d.ts +11 -16
  84. package/dist/sandbox/identity.d.ts.map +1 -1
  85. package/dist/sandbox/identity.js +32 -26
  86. package/dist/sandbox/identity.js.map +1 -1
  87. package/dist/sandbox/image.d.ts.map +1 -1
  88. package/dist/sandbox/image.js +1 -0
  89. package/dist/sandbox/image.js.map +1 -1
  90. package/dist/sandbox/index.d.ts +7 -7
  91. package/dist/sandbox/index.d.ts.map +1 -1
  92. package/dist/sandbox/index.js +13 -9
  93. package/dist/sandbox/index.js.map +1 -1
  94. package/dist/sandbox/types.d.ts +17 -16
  95. package/dist/sandbox/types.d.ts.map +1 -1
  96. package/dist/sandbox/types.js.map +1 -1
  97. package/dist/sessions/session-key.d.ts +9 -0
  98. package/dist/sessions/session-key.d.ts.map +1 -1
  99. package/dist/sessions/session-key.js +50 -2
  100. package/dist/sessions/session-key.js.map +1 -1
  101. package/dist/sessions/store.d.ts.map +1 -1
  102. package/dist/sessions/store.js +36 -8
  103. package/dist/sessions/store.js.map +1 -1
  104. package/dist/tools/sandbox.d.ts.map +1 -1
  105. package/dist/tools/sandbox.js +4 -5
  106. package/dist/tools/sandbox.js.map +1 -1
  107. package/dist/tools/subagent-slots.d.ts +3 -3
  108. package/dist/tools/subagent-slots.d.ts.map +1 -1
  109. package/dist/tools/subagent-slots.js +25 -10
  110. package/dist/tools/subagent-slots.js.map +1 -1
  111. package/dist/tools/subagent.d.ts +13 -2
  112. package/dist/tools/subagent.d.ts.map +1 -1
  113. package/dist/tools/subagent.js +16 -16
  114. package/dist/tools/subagent.js.map +1 -1
  115. package/dist/types.d.ts +14 -63
  116. package/dist/types.d.ts.map +1 -1
  117. package/dist/types.js.map +1 -1
  118. package/dist/vault/injection.d.ts +4 -14
  119. package/dist/vault/injection.d.ts.map +1 -1
  120. package/dist/vault/injection.js +5 -2
  121. package/dist/vault/injection.js.map +1 -1
  122. package/dist/vault/policy.d.ts +3 -3
  123. package/dist/vault/policy.d.ts.map +1 -1
  124. package/dist/vault/policy.js +6 -4
  125. package/dist/vault/policy.js.map +1 -1
  126. package/dist/vault/types.d.ts +4 -0
  127. package/dist/vault/types.d.ts.map +1 -1
  128. package/dist/vault/types.js.map +1 -1
  129. package/dist/web/admin/portal.js +2 -2
  130. package/dist/web/admin/portal.js.map +1 -1
  131. package/dist/workspace-projection/index.d.ts +5 -0
  132. package/dist/workspace-projection/index.d.ts.map +1 -0
  133. package/dist/workspace-projection/index.js +71 -0
  134. package/dist/workspace-projection/index.js.map +1 -0
  135. package/dist/workspace-projection/types.d.ts +7 -0
  136. package/dist/workspace-projection/types.d.ts.map +1 -0
  137. package/dist/workspace-projection/types.js +2 -0
  138. package/dist/workspace-projection/types.js.map +1 -0
  139. package/package.json +3 -3
  140. package/dist/sandbox/firecracker.d.ts +0 -18
  141. package/dist/sandbox/firecracker.d.ts.map +0 -1
  142. package/dist/sandbox/firecracker.js +0 -221
  143. package/dist/sandbox/firecracker.js.map +0 -1
  144. package/dist/sandbox/gondolin-bootstrap.d.ts +0 -26
  145. package/dist/sandbox/gondolin-bootstrap.d.ts.map +0 -1
  146. package/dist/sandbox/gondolin-bootstrap.js +0 -27
  147. package/dist/sandbox/gondolin-bootstrap.js.map +0 -1
  148. package/dist/sandbox/gondolin-contract.d.ts +0 -125
  149. package/dist/sandbox/gondolin-contract.d.ts.map +0 -1
  150. package/dist/sandbox/gondolin-contract.js +0 -155
  151. package/dist/sandbox/gondolin-contract.js.map +0 -1
  152. package/dist/sandbox/gondolin-fleet.d.ts +0 -104
  153. package/dist/sandbox/gondolin-fleet.d.ts.map +0 -1
  154. package/dist/sandbox/gondolin-fleet.js +0 -330
  155. package/dist/sandbox/gondolin-fleet.js.map +0 -1
  156. package/dist/sandbox/gondolin-gateway.d.ts +0 -86
  157. package/dist/sandbox/gondolin-gateway.d.ts.map +0 -1
  158. package/dist/sandbox/gondolin-gateway.js +0 -407
  159. package/dist/sandbox/gondolin-gateway.js.map +0 -1
  160. package/dist/sandbox/gondolin-inventory.d.ts +0 -75
  161. package/dist/sandbox/gondolin-inventory.d.ts.map +0 -1
  162. package/dist/sandbox/gondolin-inventory.js +0 -257
  163. package/dist/sandbox/gondolin-inventory.js.map +0 -1
  164. package/dist/sandbox/gondolin-join.d.ts +0 -62
  165. package/dist/sandbox/gondolin-join.d.ts.map +0 -1
  166. package/dist/sandbox/gondolin-join.js +0 -261
  167. package/dist/sandbox/gondolin-join.js.map +0 -1
  168. package/dist/sandbox/gondolin-nfs-advisory.d.ts +0 -15
  169. package/dist/sandbox/gondolin-nfs-advisory.d.ts.map +0 -1
  170. package/dist/sandbox/gondolin-nfs-advisory.js +0 -60
  171. package/dist/sandbox/gondolin-nfs-advisory.js.map +0 -1
  172. package/dist/sandbox/gondolin-placement.d.ts +0 -30
  173. package/dist/sandbox/gondolin-placement.d.ts.map +0 -1
  174. package/dist/sandbox/gondolin-placement.js +0 -77
  175. package/dist/sandbox/gondolin-placement.js.map +0 -1
  176. package/dist/sandbox/gondolin-recovery.d.ts +0 -33
  177. package/dist/sandbox/gondolin-recovery.d.ts.map +0 -1
  178. package/dist/sandbox/gondolin-recovery.js +0 -39
  179. package/dist/sandbox/gondolin-recovery.js.map +0 -1
  180. package/dist/sandbox/gondolin-remote.d.ts +0 -70
  181. package/dist/sandbox/gondolin-remote.d.ts.map +0 -1
  182. package/dist/sandbox/gondolin-remote.js +0 -325
  183. package/dist/sandbox/gondolin-remote.js.map +0 -1
  184. package/dist/sandbox/gondolin-worker-client.d.ts +0 -135
  185. package/dist/sandbox/gondolin-worker-client.d.ts.map +0 -1
  186. package/dist/sandbox/gondolin-worker-client.js +0 -323
  187. package/dist/sandbox/gondolin-worker-client.js.map +0 -1
  188. package/dist/sandbox/gondolin-worker-main.d.ts +0 -2
  189. package/dist/sandbox/gondolin-worker-main.d.ts.map +0 -1
  190. package/dist/sandbox/gondolin-worker-main.js +0 -22
  191. package/dist/sandbox/gondolin-worker-main.js.map +0 -1
  192. package/dist/sandbox/gondolin-worker.d.ts +0 -17
  193. package/dist/sandbox/gondolin-worker.d.ts.map +0 -1
  194. package/dist/sandbox/gondolin-worker.js +0 -201
  195. package/dist/sandbox/gondolin-worker.js.map +0 -1
  196. package/dist/sandbox/gondolin.d.ts +0 -53
  197. package/dist/sandbox/gondolin.d.ts.map +0 -1
  198. package/dist/sandbox/gondolin.js +0 -429
  199. package/dist/sandbox/gondolin.js.map +0 -1
@@ -1 +0,0 @@
1
- {"version":3,"file":"gondolin-fleet.js","sourceRoot":"","sources":["../../src/sandbox/gondolin-fleet.ts"],"names":[],"mappings":"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","sourcesContent":["import * as log from \"../log.js\";\nimport type { GondolinRemoteSettings, GondolinRemoteWorkerSettings } from \"../types.js\";\nimport { SandboxError } from \"./errors.js\";\nimport { gondolinPlacements, type GondolinPlacementStore } from \"./gondolin-placement.js\";\nimport {\n GondolinRemoteConnection,\n GondolinWorkerUnreachableError,\n type GondolinRemoteOverrides,\n} from \"./gondolin-remote.js\";\nimport { GondolinRuntimeGoneError } from \"./gondolin-recovery.js\";\nimport type {\n GondolinRuntimeHandle,\n GondolinRuntimeSpec,\n GondolinRuntimeTransport,\n} from \"./gondolin-worker-client.js\";\nimport type { ExecResult } from \"./types.js\";\n\nconst LEASE_TTL_SECONDS = 300;\nconst QUEUE_WAIT_SECONDS = 60;\nconst QUEUE_POLL_MS = 2000;\n\n/** The connection surface the fleet needs from each worker. */\nexport interface GondolinWorkerConnection {\n health(): Promise<Record<string, unknown>>;\n ensure(instanceId: string, spec: GondolinRuntimeSpec): Promise<GondolinRuntimeHandle>;\n stop(\n handle: Pick<GondolinRuntimeHandle, \"workerPid\" | \"sessionId\" | \"instanceId\">,\n ): Promise<void>;\n exec(\n handle: GondolinRuntimeHandle,\n command: string,\n options?: { env?: Record<string, string>; signal?: AbortSignal },\n ): Promise<ExecResult>;\n isRuntimeAlive(handle: GondolinRuntimeHandle): Promise<boolean>;\n listRuntimes(): Promise<Array<{ sessionId: string; instanceId: string }>>;\n dispose(): void;\n}\n\ninterface FleetWorker {\n name: string;\n settings: GondolinRemoteWorkerSettings;\n connection: GondolinWorkerConnection;\n /** Non-empty when the worker's shared workspace failed its usability probe. */\n workspaceError?: string;\n}\n\ninterface GondolinFleetOverrides {\n createConnection?: (\n worker: GondolinRemoteWorkerSettings,\n connectionOverrides: GondolinRemoteOverrides,\n ) => GondolinWorkerConnection;\n placements?: GondolinPlacementStore;\n connectionOverrides?: GondolinRemoteOverrides;\n now?: () => number;\n queuePollMs?: number;\n sleep?: (ms: number) => Promise<void>;\n}\n\nfunction normalizeWorkers(settings: GondolinRemoteSettings): GondolinRemoteWorkerSettings[] {\n const inline = settings.workers ?? [{ url: settings.url as string }];\n return inline.map((worker) => ({\n ...worker,\n name: worker.name ?? worker.url,\n caFile: worker.caFile ?? settings.caFile,\n certFile: worker.certFile ?? settings.certFile,\n keyFile: worker.keyFile ?? settings.keyFile,\n workspaceRoot: worker.workspaceRoot ?? settings.workspaceRoot,\n maxRuntimes: worker.maxRuntimes ?? settings.maxRuntimes,\n }));\n}\n\n/**\n * Places each conversation's runtime on one worker of the fleet and keeps it\n * there (sticky placement). Failover to another worker happens only when the\n * placed worker is unreachable AND its lease fencing watermark has passed —\n * the point after which the old worker's janitor has provably stopped the\n * runtime, so shared storage never sees two writers.\n */\nclass GondolinFleetClient implements GondolinRuntimeTransport {\n private settings?: GondolinRemoteSettings;\n private workers = new Map<string, FleetWorker>();\n private connectionOverrides: GondolinRemoteOverrides = {};\n private placements: GondolinPlacementStore = gondolinPlacements;\n private leaseTtlMs = LEASE_TTL_SECONDS * 1000;\n private queueWaitMs = QUEUE_WAIT_SECONDS * 1000;\n private queuePollMs = QUEUE_POLL_MS;\n private now: () => number = Date.now;\n private sleep: (ms: number) => Promise<void> = (ms) =>\n new Promise((resolve) => setTimeout(resolve, ms));\n\n configure(settings?: GondolinRemoteSettings, overrides?: GondolinFleetOverrides): void {\n for (const worker of this.workers.values()) worker.connection.dispose();\n this.workers.clear();\n this.settings = settings;\n this.placements = overrides?.placements ?? gondolinPlacements;\n this.now = overrides?.now ?? Date.now;\n this.sleep = overrides?.sleep ?? ((ms) => new Promise((resolve) => setTimeout(resolve, ms)));\n this.queuePollMs = overrides?.queuePollMs ?? QUEUE_POLL_MS;\n this.connectionOverrides = overrides?.connectionOverrides ?? {};\n this.leaseTtlMs = (overrides?.connectionOverrides?.leaseTtlSeconds ?? LEASE_TTL_SECONDS) * 1000;\n this.queueWaitMs = (settings?.queueWaitSeconds ?? QUEUE_WAIT_SECONDS) * 1000;\n if (!settings) return;\n if (!settings.workers?.length && !settings.url) {\n return; // not configured; validate() reports the actionable error\n }\n const createConnection =\n overrides?.createConnection ??\n ((worker: GondolinRemoteWorkerSettings, connectionOverrides: GondolinRemoteOverrides) =>\n new GondolinRemoteConnection(worker, connectionOverrides));\n for (const worker of normalizeWorkers(settings)) {\n const name = worker.name as string;\n const connection = createConnection(worker, {\n ...overrides?.connectionOverrides,\n onLeaseActivity: (instanceId, expiresAtMs) => {\n if (this.placements.get(instanceId)?.worker === name) {\n this.placements.touch(instanceId, expiresAtMs);\n }\n },\n });\n this.workers.set(name, { name, settings: worker, connection });\n }\n }\n\n isConfigured(): boolean {\n return this.workers.size > 0;\n }\n\n /** Names of statically-configured workers with no workspaceRoot (startup guard). */\n workersMissingWorkspaceRoot(): string[] {\n return Array.from(this.workers.values())\n .filter((worker) => !worker.settings.workspaceRoot)\n .map((worker) => worker.name);\n }\n\n /**\n * Attach a dial-home worker at runtime (the gateway calls this when a\n * worker registers). The factory receives the fleet's connection overrides\n * plus the lease-watermark callback, mirroring configure()'s wiring.\n */\n attachWorker(\n settings: GondolinRemoteWorkerSettings,\n createConnection: (overrides: GondolinRemoteOverrides) => GondolinWorkerConnection,\n ): void {\n const name = settings.name ?? settings.url;\n this.workers.get(name)?.connection.dispose();\n const connection = createConnection({\n ...this.connectionOverrides,\n onLeaseActivity: (instanceId, expiresAtMs) => {\n if (this.placements.get(instanceId)?.worker === name) {\n this.placements.touch(instanceId, expiresAtMs);\n }\n },\n });\n this.workers.set(name, { name, settings: { ...settings, name }, connection });\n }\n\n /**\n * Record a worker's shared-workspace health (the gateway pushes this from\n * register and ping frames). A degraded worker keeps its runtimes and its\n * connection, but new placements skip it and runtime operations fail fast\n * with the probe's diagnosis instead of hanging on a dead mount.\n */\n setWorkspaceHealth(name: string, error?: string): void {\n const worker = this.workers.get(name);\n if (!worker) return;\n worker.workspaceError = error || undefined;\n }\n\n /**\n * Detach a dial-home worker (disconnect). Placements survive: their lease\n * watermarks keep fencing failover until expiry, exactly as for an\n * unreachable static worker.\n */\n detachWorker(name: string): void {\n const worker = this.workers.get(name);\n if (!worker) return;\n worker.connection.dispose();\n this.workers.delete(name);\n }\n\n imageSelector(): string | undefined {\n return this.settings?.imageSelector;\n }\n\n /** At least one worker must answer for the sandbox mode to come up. */\n async health(): Promise<Array<{ worker: string; health?: Record<string, unknown> }>> {\n const report = await Promise.all(\n Array.from(this.workers.values()).map(async (worker) => {\n try {\n return { worker: worker.name, health: await worker.connection.health() };\n } catch {\n return { worker: worker.name };\n }\n }),\n );\n if (report.length > 0 && !report.some((entry) => entry.health)) {\n throw new SandboxError(\"Error: no gondolin remote worker is reachable\");\n }\n return report;\n }\n\n async ensure(instanceId: string, spec: GondolinRuntimeSpec): Promise<GondolinRuntimeHandle> {\n const placed = this.placements.get(instanceId);\n if (placed) {\n const worker = this.workers.get(placed.worker);\n if (worker) {\n try {\n return await this.ensureOn(worker, instanceId, spec);\n } catch (err) {\n if (!(err instanceof GondolinWorkerUnreachableError)) throw err;\n this.assertFailoverAllowed(instanceId, placed.worker, placed.leaseExpiresAt, err);\n }\n } else {\n this.assertFailoverAllowed(\n instanceId,\n placed.worker,\n placed.leaseExpiresAt,\n new GondolinWorkerUnreachableError(\"worker is no longer configured\"),\n );\n }\n log.logWarning(\n `Gondolin worker '${placed.worker}' lost runtime for '${instanceId}'; failing over`,\n );\n }\n const worker = await this.selectWorker();\n return this.ensureOn(worker, instanceId, spec);\n }\n\n async stop(\n handle: Pick<GondolinRuntimeHandle, \"workerPid\" | \"sessionId\" | \"instanceId\" | \"workerName\">,\n ): Promise<void> {\n const worker = this.workerFor(handle.workerName);\n if (!worker) {\n // the worker left the fleet config; its janitor stops the runtime when\n // the lease expires, and the record keeps fencing until then\n return;\n }\n try {\n await worker.connection.stop(handle);\n this.placements.delete(handle.instanceId);\n } catch (err) {\n if (err instanceof GondolinWorkerUnreachableError) {\n // cannot confirm the stop; keep the placement so its watermark still\n // fences any failover, and let the daemon's expiry janitor finish it\n log.logWarning(\n `Gondolin worker '${worker.name}' unreachable while stopping '${handle.instanceId}'; leaving it to lease expiry`,\n );\n return;\n }\n throw err;\n }\n }\n\n async exec(\n handle: GondolinRuntimeHandle,\n command: string,\n options: { env?: Record<string, string>; signal?: AbortSignal } = {},\n ): Promise<ExecResult> {\n const worker = this.workerFor(handle.workerName);\n if (!worker) throw new GondolinRuntimeGoneError(\"worker is no longer configured\");\n this.assertWorkspaceUsable(worker);\n log.logInfo(`Gondolin execution '${handle.instanceId}' routed to worker '${worker.name}'`);\n return worker.connection.exec(handle, command, options);\n }\n\n async isRuntimeAlive(handle: GondolinRuntimeHandle): Promise<boolean> {\n const worker = this.workerFor(handle.workerName);\n if (!worker) return false;\n return worker.connection.isRuntimeAlive(handle);\n }\n\n /**\n * Fleet reconciliation: a runtime whose conversation is placed on a\n * different worker is a stray from a superseded placement — stop it. A\n * runtime with no placement at all (crash between daemon ensure and the\n * placement write) is adopted instead of killed.\n */\n async reconcile(): Promise<void> {\n for (const worker of this.workers.values()) {\n let runtimes: Array<{ sessionId: string; instanceId: string }>;\n try {\n runtimes = await worker.connection.listRuntimes();\n } catch {\n continue; // unreachable workers reconcile on a later sweep\n }\n for (const runtime of runtimes) {\n const record = this.placements.get(runtime.instanceId);\n if (!record) {\n log.logInfo(\n `Adopting unplaced Gondolin runtime '${runtime.instanceId}' on worker '${worker.name}'`,\n );\n this.placements.set(runtime.instanceId, worker.name, this.now() + this.leaseTtlMs);\n continue;\n }\n if (record.worker === worker.name) continue;\n log.logInfo(\n `Stopping stray Gondolin runtime '${runtime.instanceId}' on worker '${worker.name}' (placed on '${record.worker}')`,\n );\n try {\n await worker.connection.stop({\n sessionId: runtime.sessionId,\n instanceId: runtime.instanceId,\n workerPid: 0,\n });\n } catch (err) {\n log.logWarning(\n `Failed to stop stray runtime '${runtime.instanceId}' on '${worker.name}'`,\n err instanceof Error ? err.message : String(err),\n );\n }\n }\n }\n }\n\n private async ensureOn(\n worker: FleetWorker,\n instanceId: string,\n spec: GondolinRuntimeSpec,\n ): Promise<GondolinRuntimeHandle> {\n this.assertWorkspaceUsable(worker);\n const handle = await worker.connection.ensure(instanceId, spec);\n this.placements.set(instanceId, worker.name, this.now() + this.leaseTtlMs);\n return { ...handle, workerName: worker.name };\n }\n\n /**\n * Fail fast — with the probe's diagnosis — instead of dispatching work that\n * would hang on a dead shared-workspace mount. Deliberately NOT a\n * GondolinWorkerUnreachableError: a broken mount must not trigger failover,\n * because the workspace is shared and likely broken for every worker.\n */\n private assertWorkspaceUsable(worker: FleetWorker): void {\n if (!worker.workspaceError) return;\n throw new SandboxError(\n `Error: Gondolin worker '${worker.name}' has an unusable shared workspace: ` +\n `${worker.workspaceError} (fix the mount on the worker; health refreshes with its next heartbeat)`,\n );\n }\n\n private assertFailoverAllowed(\n instanceId: string,\n workerName: string,\n leaseExpiresAt: number,\n cause: Error,\n ): void {\n const remainingMs = leaseExpiresAt - this.now();\n if (remainingMs <= 0) return;\n // Failing over earlier could put a second writable VM on the same shared\n // workspace: the old worker may be alive behind a partition, and its\n // daemon only stops the runtime once the lease expires.\n throw new SandboxError(\n `Error: Gondolin worker '${workerName}' is unreachable (${cause.message}); ` +\n `retrying '${instanceId}' elsewhere in ${Math.ceil(remainingMs / 1000)}s once its lease has expired`,\n );\n }\n\n private async selectWorker(): Promise<FleetWorker> {\n const deadline = this.now() + this.queueWaitMs;\n for (;;) {\n let best: { worker: FleetWorker; load: number } | undefined;\n let reachable = 0;\n let draining = 0;\n let full = 0;\n const degraded: string[] = [];\n for (const worker of this.workers.values()) {\n if (worker.settings.draining) {\n draining += 1;\n continue;\n }\n if (worker.workspaceError) {\n degraded.push(`'${worker.name}': ${worker.workspaceError}`);\n continue;\n }\n let active: number;\n let workspaceError: string | undefined;\n try {\n const health = await worker.connection.health();\n active = typeof health.activeRuntimes === \"number\" ? health.activeRuntimes : 0;\n workspaceError =\n typeof health.workspaceError === \"string\" && health.workspaceError\n ? health.workspaceError\n : undefined;\n } catch {\n continue;\n }\n reachable += 1;\n if (workspaceError) {\n // static workers report probe results via /v1/health only\n degraded.push(`'${worker.name}': ${workspaceError}`);\n continue;\n }\n const cap = worker.settings.maxRuntimes;\n if (cap !== undefined && active >= cap) {\n full += 1;\n continue;\n }\n const load = cap !== undefined ? active / cap : active / Number.MAX_SAFE_INTEGER;\n if (!best || load < best.load) best = { worker, load };\n }\n if (best) return best.worker;\n if (reachable === 0 && draining === 0 && degraded.length === 0) {\n throw new SandboxError(\"Error: no gondolin remote worker is reachable\");\n }\n if (full === 0) {\n const detail = degraded.length > 0 ? ` — degraded: ${degraded.join(\"; \")}` : \"\";\n throw new SandboxError(\n `Error: every gondolin remote worker is draining, degraded, or unreachable${detail}`,\n );\n }\n if (this.now() >= deadline) {\n throw new SandboxError(\n `Error: all gondolin remote workers are at capacity (waited ${Math.round(this.queueWaitMs / 1000)}s)`,\n );\n }\n await this.sleep(this.queuePollMs);\n }\n }\n\n private workerFor(workerName: string | undefined): FleetWorker | undefined {\n if (!workerName) return undefined;\n return this.workers.get(workerName);\n }\n}\n\nexport const gondolinFleet = new GondolinFleetClient();\n"]}
@@ -1,86 +0,0 @@
1
- import type { Server, Socket } from "node:net";
2
- import type { GondolinGatewaySettings } from "../types.js";
3
- /** What a worker announces when it dials home (mirrors the Go register frame). */
4
- interface GondolinWorkerRegistration {
5
- name: string;
6
- os?: string;
7
- arch?: string;
8
- accelerator?: string;
9
- cpus?: number;
10
- memoryBytes?: number;
11
- maxRuntimes?: number;
12
- protocolVersion?: number;
13
- runtimes?: Array<{
14
- sessionId: string;
15
- instanceId: string;
16
- }>;
17
- /** Non-empty when the worker's shared workspace failed its usability probe. */
18
- workspaceError?: string;
19
- }
20
- interface GatewayOverrides {
21
- /** Server factory (tests substitute a plain net.Server). */
22
- createServer?: (onConnection: (socket: Socket) => void) => Server;
23
- /** mTLS verification result for a socket (tests substitute outcomes). */
24
- isAuthorized?: (socket: Socket) => boolean;
25
- leaseTtlSeconds?: number;
26
- rpcTimeoutMs?: number;
27
- tunnelTimeoutMs?: number;
28
- }
29
- /**
30
- * The host side of dial-home workers: one mTLS listener that accepts worker
31
- * control channels (register/ping/RPC responses) and per-command dial-back
32
- * tunnels, keeps the registry of connected workers, and attaches each one to
33
- * the fleet as a regular worker connection. Placement, leases, fencing, and
34
- * failover are unchanged — this only reverses who dials whom.
35
- */
36
- declare class GondolinWorkerGateway {
37
- private settings?;
38
- private overrides;
39
- private server?;
40
- private readonly workers;
41
- private readonly pendingTunnels;
42
- configure(settings?: GondolinGatewaySettings, overrides?: GatewayOverrides): void;
43
- isConfigured(): boolean;
44
- /** Registered workers and their liveness (admin/observability surface). */
45
- list(): Array<{
46
- name: string;
47
- connected: boolean;
48
- activeRuntimes: number;
49
- workspaceError?: string;
50
- info: GondolinWorkerRegistration;
51
- }>;
52
- /**
53
- * Start the listener. Without explicit certificate settings the gateway
54
- * provisions its own: a private worker CA plus a server certificate signed
55
- * by it (required for join's CA pinning to also authenticate the host).
56
- */
57
- start(): Promise<void>;
58
- stop(): void;
59
- /** Routes one inbound connection by its first frame: control or tunnel. */
60
- private handleConnection;
61
- private acceptControlChannel;
62
- private handleControlFrame;
63
- /**
64
- * Track shared-workspace health from register/ping frames and push it into
65
- * the fleet, logging only the transitions. A worker whose NFS mount died
66
- * keeps its control channel alive — this is what turns that silent state
67
- * into refused placements and fail-fast execs.
68
- */
69
- private applyWorkspaceHealth;
70
- /** RPC to a worker over its control channel (the reverse of HTTPS requests). */
71
- private rpc;
72
- private rejectPendingRpc;
73
- /** Ask the worker to dial back a data connection for one session tunnel. */
74
- private openTunnel;
75
- /**
76
- * One-time token → CA-signed client certificate. The only operation an
77
- * unauthenticated connection may perform; the connection closes after the
78
- * response either way.
79
- */
80
- private handleJoin;
81
- private acceptTunnel;
82
- private workerBySocket;
83
- }
84
- export declare const gondolinGateway: GondolinWorkerGateway;
85
- export {};
86
- //# sourceMappingURL=gondolin-gateway.d.ts.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"gondolin-gateway.d.ts","sourceRoot":"","sources":["../../src/sandbox/gondolin-gateway.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAI/C,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAC;AAU3D,kFAAkF;AAClF,UAAU,0BAA0B;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,EAAE,KAAK,CAAC;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC5D,+EAA+E;IAC/E,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAyED,UAAU,gBAAgB;IACxB,4DAA4D;IAC5D,YAAY,CAAC,EAAE,CAAC,YAAY,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,KAAK,MAAM,CAAC;IAClE,yEAAyE;IACzE,YAAY,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC;IAC3C,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAMD;;;;;;GAMG;AACH,cAAM,qBAAqB;IACzB,OAAO,CAAC,QAAQ,CAAC,CAA0B;IAC3C,OAAO,CAAC,SAAS,CAAwB;IACzC,OAAO,CAAC,MAAM,CAAC,CAAS;IACxB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAuC;IAC/D,OAAO,CAAC,QAAQ,CAAC,cAAc,CAG3B;IAEJ,SAAS,CAAC,QAAQ,CAAC,EAAE,uBAAuB,EAAE,SAAS,CAAC,EAAE,gBAAgB,GAAG,IAAI,CAIhF;IAED,YAAY,IAAI,OAAO,CAEtB;IAED,2EAA2E;IAC3E,IAAI,IAAI,KAAK,CAAC;QACZ,IAAI,EAAE,MAAM,CAAC;QACb,SAAS,EAAE,OAAO,CAAC;QACnB,cAAc,EAAE,MAAM,CAAC;QACvB,cAAc,CAAC,EAAE,MAAM,CAAC;QACxB,IAAI,EAAE,0BAA0B,CAAC;KAClC,CAAC,CAQD;IAED;;;;OAIG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CA6C3B;IAED,IAAI,IAAI,IAAI,CAUX;IAED,2EAA2E;IAC3E,OAAO,CAAC,gBAAgB;IA8BxB,OAAO,CAAC,oBAAoB;IAgE5B,OAAO,CAAC,kBAAkB;IAsB1B;;;;;OAKG;IACH,OAAO,CAAC,oBAAoB;IAiB5B,gFAAgF;IAChF,OAAO,CAAC,GAAG;IAqCX,OAAO,CAAC,gBAAgB;IAQxB,4EAA4E;IAC5E,OAAO,CAAC,UAAU;IAyDlB;;;;OAIG;YACW,UAAU;IA0BxB,OAAO,CAAC,YAAY;IAWpB,OAAO,CAAC,cAAc;CAMvB;AAED,eAAO,MAAM,eAAe,uBAA8B,CAAC"}
@@ -1,407 +0,0 @@
1
- import { randomBytes } from "node:crypto";
2
- import { readFileSync } from "node:fs";
3
- import { hostname } from "node:os";
4
- import { TLSSocket, createServer as createTlsServer } from "node:tls";
5
- import * as log from "../log.js";
6
- import { gondolinFleet } from "./gondolin-fleet.js";
7
- import { gondolinJoin } from "./gondolin-join.js";
8
- import { createSessionFrameParser, encodeSessionMessage } from "./gondolin-contract.js";
9
- import { GondolinRemoteConnection, GondolinWorkerUnreachableError } from "./gondolin-remote.js";
10
- const RPC_TIMEOUT_MS = 150_000;
11
- const TUNNEL_TIMEOUT_MS = 15_000;
12
- /**
13
- * Splits a byte stream into u32be-length-prefixed JSON frames, preserving any
14
- * bytes after the point where the consumer stops parsing (a tunnel connection
15
- * switches protocols after its preamble frame).
16
- */
17
- function createControlFrameReader(onFrame) {
18
- let buffer = Buffer.alloc(0);
19
- let stopped = false;
20
- return {
21
- push(chunk) {
22
- if (stopped)
23
- return;
24
- buffer = Buffer.concat([buffer, chunk]);
25
- for (;;) {
26
- // onFrame may call stop() synchronously (a tunnel switching protocols)
27
- if (stopped || buffer.length < 4)
28
- return;
29
- const length = buffer.readUInt32BE(0);
30
- if (buffer.length < 4 + length)
31
- return;
32
- const payload = buffer.subarray(4, 4 + length);
33
- buffer = buffer.subarray(4 + length);
34
- let frame;
35
- try {
36
- frame = JSON.parse(payload.toString("utf8"));
37
- }
38
- catch {
39
- continue; // skip malformed frames
40
- }
41
- onFrame(frame, buffer);
42
- }
43
- },
44
- stop() {
45
- stopped = true;
46
- },
47
- };
48
- }
49
- function encodeControlFrame(frame) {
50
- return encodeSessionMessage(frame);
51
- }
52
- function defaultIsAuthorized(socket) {
53
- return socket instanceof TLSSocket && socket.authorized;
54
- }
55
- /**
56
- * The host side of dial-home workers: one mTLS listener that accepts worker
57
- * control channels (register/ping/RPC responses) and per-command dial-back
58
- * tunnels, keeps the registry of connected workers, and attaches each one to
59
- * the fleet as a regular worker connection. Placement, leases, fencing, and
60
- * failover are unchanged — this only reverses who dials whom.
61
- */
62
- class GondolinWorkerGateway {
63
- constructor() {
64
- this.overrides = {};
65
- this.workers = new Map();
66
- this.pendingTunnels = new Map();
67
- }
68
- configure(settings, overrides) {
69
- this.stop();
70
- this.settings = settings;
71
- this.overrides = overrides ?? {};
72
- }
73
- isConfigured() {
74
- return this.settings !== undefined;
75
- }
76
- /** Registered workers and their liveness (admin/observability surface). */
77
- list() {
78
- return Array.from(this.workers.values()).map((worker) => ({
79
- name: worker.info.name,
80
- connected: !worker.socket.destroyed,
81
- activeRuntimes: worker.activeRuntimes,
82
- workspaceError: worker.workspaceError,
83
- info: worker.info,
84
- }));
85
- }
86
- /**
87
- * Start the listener. Without explicit certificate settings the gateway
88
- * provisions its own: a private worker CA plus a server certificate signed
89
- * by it (required for join's CA pinning to also authenticate the host).
90
- */
91
- async start() {
92
- if (!this.settings || this.server)
93
- return;
94
- const settings = this.settings;
95
- if (!settings.workspaceRoot) {
96
- // dial-home workers inherit workspaceRoot from here; without it every
97
- // runtime is rejected with "escapes the workspace root"
98
- throw new Error("gondolin gateway requires workspaceRoot (the worker-side shared workspace path); " +
99
- "set sandbox.gondolin.remote.gateway.workspaceRoot");
100
- }
101
- let material;
102
- if (settings.certFile && settings.keyFile && settings.clientCaFile) {
103
- material = {
104
- certFile: settings.certFile,
105
- keyFile: settings.keyFile,
106
- clientCaFile: settings.clientCaFile,
107
- };
108
- }
109
- else {
110
- if (!gondolinJoin.isConfigured()) {
111
- throw new Error("gondolin gateway auto-init requires the join service to be configured");
112
- }
113
- const issued = await gondolinJoin.ensureServerCert(settings.hostnames ?? [hostname()]);
114
- material = { ...issued, clientCaFile: gondolinJoin.paths().caFile };
115
- }
116
- const factory = this.overrides.createServer ??
117
- ((onConnection) => createTlsServer({
118
- cert: readFileSync(material.certFile),
119
- key: readFileSync(material.keyFile),
120
- ca: readFileSync(material.clientCaFile),
121
- requestCert: true,
122
- // unauthenticated connections may only send a join frame; the
123
- // per-frame authorization gate enforces that below
124
- rejectUnauthorized: false,
125
- minVersion: "TLSv1.3",
126
- }, onConnection));
127
- this.server = factory((socket) => this.handleConnection(socket));
128
- this.server.listen(this.settings.port, () => {
129
- log.logInfo(`Gondolin worker gateway listening on :${this.settings?.port}`);
130
- });
131
- }
132
- stop() {
133
- for (const worker of this.workers.values()) {
134
- worker.socket.destroy();
135
- this.rejectPendingRpc(worker, "gateway stopped");
136
- }
137
- this.workers.clear();
138
- for (const pending of this.pendingTunnels.values())
139
- clearTimeout(pending.timer);
140
- this.pendingTunnels.clear();
141
- this.server?.close();
142
- this.server = undefined;
143
- }
144
- /** Routes one inbound connection by its first frame: control or tunnel. */
145
- handleConnection(socket) {
146
- socket.setNoDelay(true);
147
- socket.setKeepAlive(true, 30_000);
148
- let routed = false;
149
- const authorized = (this.overrides.isAuthorized ?? defaultIsAuthorized)(socket);
150
- const reader = createControlFrameReader((frame, leftover) => {
151
- if (!routed) {
152
- routed = true;
153
- if (frame.type === "join") {
154
- void this.handleJoin(socket, frame);
155
- }
156
- else if (!authorized) {
157
- // everything except join requires a CA-signed client certificate
158
- socket.destroy();
159
- }
160
- else if (frame.type === "register" && frame.name) {
161
- this.acceptControlChannel(socket, frame, reader);
162
- }
163
- else if (frame.type === "tunnel" && frame.nonce) {
164
- reader.stop();
165
- socket.removeAllListeners("data");
166
- this.acceptTunnel(socket, frame.nonce, leftover);
167
- }
168
- else {
169
- socket.destroy();
170
- }
171
- return;
172
- }
173
- this.handleControlFrame(socket, frame);
174
- });
175
- socket.on("data", (chunk) => reader.push(chunk));
176
- socket.on("error", () => socket.destroy());
177
- }
178
- acceptControlChannel(socket, registration, _reader) {
179
- const name = registration.name;
180
- const previous = this.workers.get(name);
181
- if (previous && !previous.socket.destroyed) {
182
- log.logInfo(`Gondolin worker '${name}' re-registered; superseding previous connection`);
183
- previous.socket.destroy();
184
- }
185
- const worker = {
186
- info: registration,
187
- socket,
188
- connectedAt: Date.now(),
189
- lastSeen: Date.now(),
190
- activeRuntimes: registration.runtimes?.length ?? 0,
191
- pendingRpc: new Map(),
192
- nextRpcId: 1,
193
- };
194
- this.workers.set(name, worker);
195
- const surviving = registration.runtimes?.length ?? 0;
196
- log.logInfo(`Gondolin worker joined: ${name} (${registration.os}/${registration.arch}, ` +
197
- `${registration.accelerator}, ${registration.cpus} cpus, ` +
198
- `cap ${registration.maxRuntimes ?? "∞"}, ${surviving} runtimes surviving)`);
199
- const overrides = this.settings?.workers?.[name];
200
- gondolinFleet.attachWorker({
201
- name,
202
- url: `dialhome://${name}`,
203
- workspaceRoot: this.settings?.workspaceRoot,
204
- maxRuntimes: overrides?.maxRuntimes ?? registration.maxRuntimes,
205
- draining: overrides?.draining,
206
- }, (connectionOverrides) => new GondolinRemoteConnection({ name, url: `dialhome://${name}`, workspaceRoot: this.settings?.workspaceRoot }, {
207
- ...connectionOverrides,
208
- ...(this.overrides.leaseTtlSeconds !== undefined
209
- ? { leaseTtlSeconds: this.overrides.leaseTtlSeconds }
210
- : {}),
211
- request: (method, path, body, headers) => this.rpc(name, method, path, body, headers),
212
- tunnel: (path, headers, callbacks) => this.openTunnel(name, path, headers, callbacks),
213
- }));
214
- this.applyWorkspaceHealth(worker, registration.workspaceError);
215
- // a worker that reconnected may carry runtimes whose placements moved
216
- void gondolinFleet.reconcile();
217
- socket.on("close", () => {
218
- this.rejectPendingRpc(worker, `worker '${name}' disconnected`);
219
- const current = this.workers.get(name);
220
- if (current !== worker)
221
- return; // superseded
222
- log.logWarning(`Gondolin worker disconnected: ${name} (placements fence until lease expiry)`);
223
- gondolinFleet.detachWorker(name);
224
- this.workers.delete(name);
225
- });
226
- }
227
- handleControlFrame(socket, frame) {
228
- const worker = this.workerBySocket(socket);
229
- if (!worker)
230
- return;
231
- worker.lastSeen = Date.now();
232
- if (frame.type === "ping") {
233
- if (typeof frame.activeRuntimes === "number") {
234
- worker.activeRuntimes = frame.activeRuntimes;
235
- }
236
- // omitted on healthy pings (Go omitempty), so absence means recovered
237
- this.applyWorkspaceHealth(worker, frame.workspaceError);
238
- socket.write(encodeControlFrame({ type: "pong" }));
239
- return;
240
- }
241
- if (frame.type === "response" && typeof frame.id === "number") {
242
- const pending = worker.pendingRpc.get(frame.id);
243
- if (!pending)
244
- return;
245
- worker.pendingRpc.delete(frame.id);
246
- clearTimeout(pending.timer);
247
- pending.resolve(frame);
248
- }
249
- }
250
- /**
251
- * Track shared-workspace health from register/ping frames and push it into
252
- * the fleet, logging only the transitions. A worker whose NFS mount died
253
- * keeps its control channel alive — this is what turns that silent state
254
- * into refused placements and fail-fast execs.
255
- */
256
- applyWorkspaceHealth(worker, error) {
257
- const next = error || undefined;
258
- if (next === worker.workspaceError) {
259
- gondolinFleet.setWorkspaceHealth(worker.info.name, next); // attach may have reset it
260
- return;
261
- }
262
- if (next) {
263
- log.logWarning(`Gondolin worker '${worker.info.name}' workspace is unusable: ${next} — new placements disabled until it recovers`);
264
- }
265
- else {
266
- log.logInfo(`Gondolin worker '${worker.info.name}' workspace recovered`);
267
- }
268
- worker.workspaceError = next;
269
- gondolinFleet.setWorkspaceHealth(worker.info.name, next);
270
- }
271
- /** RPC to a worker over its control channel (the reverse of HTTPS requests). */
272
- rpc(name, method, path, body, headers) {
273
- const worker = this.workers.get(name);
274
- if (!worker || worker.socket.destroyed) {
275
- return Promise.reject(new GondolinWorkerUnreachableError(`worker '${name}' is not connected`));
276
- }
277
- const id = worker.nextRpcId++;
278
- return new Promise((resolve, reject) => {
279
- const timer = setTimeout(() => {
280
- worker.pendingRpc.delete(id);
281
- reject(new GondolinWorkerUnreachableError(`RPC to worker '${name}' timed out (${method} ${path})`));
282
- }, this.overrides.rpcTimeoutMs ?? RPC_TIMEOUT_MS);
283
- timer.unref?.();
284
- worker.pendingRpc.set(id, {
285
- timer,
286
- reject,
287
- resolve: (frame) => resolve({
288
- status: frame.status ?? 0,
289
- json: (frame.body ?? {}),
290
- }),
291
- });
292
- worker.socket.write(encodeControlFrame({ type: "request", id, method, path, body, headers }));
293
- });
294
- }
295
- rejectPendingRpc(worker, reason) {
296
- for (const pending of worker.pendingRpc.values()) {
297
- clearTimeout(pending.timer);
298
- pending.reject(new GondolinWorkerUnreachableError(reason));
299
- }
300
- worker.pendingRpc.clear();
301
- }
302
- /** Ask the worker to dial back a data connection for one session tunnel. */
303
- openTunnel(name, path, headers, callbacks) {
304
- const worker = this.workers.get(name);
305
- if (!worker || worker.socket.destroyed) {
306
- const error = new Error(`worker '${name}' is not connected`);
307
- error.code = "ECONNREFUSED"; // nothing executed — safe to recreate
308
- return Promise.reject(error);
309
- }
310
- const sessionId = path.split("/")[3];
311
- const nonce = randomBytes(16).toString("hex");
312
- return new Promise((resolve, reject) => {
313
- const timer = setTimeout(() => {
314
- this.pendingTunnels.delete(nonce);
315
- const error = new Error(`worker '${name}' did not dial back a tunnel`);
316
- error.code = "ECONNREFUSED";
317
- reject(error);
318
- }, this.overrides.tunnelTimeoutMs ?? TUNNEL_TIMEOUT_MS);
319
- timer.unref?.();
320
- this.pendingTunnels.set(nonce, {
321
- timer,
322
- resolve: ({ socket, leftover }) => {
323
- let closed = false;
324
- const parse = createSessionFrameParser(callbacks);
325
- if (leftover.length > 0)
326
- parse(leftover);
327
- socket.on("data", parse);
328
- socket.on("error", (error) => {
329
- if (closed)
330
- return;
331
- closed = true;
332
- callbacks.onClose(error);
333
- });
334
- socket.on("close", () => {
335
- if (closed)
336
- return;
337
- closed = true;
338
- callbacks.onClose();
339
- });
340
- resolve({
341
- send: (message) => {
342
- if (!closed)
343
- socket.write(encodeSessionMessage(message));
344
- },
345
- close: () => {
346
- if (closed)
347
- return;
348
- closed = true;
349
- socket.destroy();
350
- },
351
- });
352
- },
353
- });
354
- worker.socket.write(encodeControlFrame({ type: "open-tunnel", nonce, sessionId, headers }));
355
- });
356
- }
357
- /**
358
- * One-time token → CA-signed client certificate. The only operation an
359
- * unauthenticated connection may perform; the connection closes after the
360
- * response either way.
361
- */
362
- async handleJoin(socket, frame) {
363
- const refuse = (message) => {
364
- log.logWarning(`Gondolin worker join refused: ${message}`);
365
- socket.end(encodeControlFrame({ type: "join-error", message }));
366
- };
367
- if (!gondolinJoin.isConfigured()) {
368
- refuse("join is not enabled on this gateway");
369
- return;
370
- }
371
- if (!frame.token || !frame.csr || !frame.name) {
372
- refuse("join requires token, csr, and name");
373
- return;
374
- }
375
- if (!gondolinJoin.consumeToken(frame.token)) {
376
- refuse(`invalid or expired join token (worker '${frame.name}')`);
377
- return;
378
- }
379
- try {
380
- const signed = await gondolinJoin.signCsr(frame.csr);
381
- log.logInfo(`Gondolin worker '${frame.name}' joined: client certificate issued`);
382
- socket.end(encodeControlFrame({ type: "join-ok", cert: signed.certPem, ca: signed.caPem }));
383
- }
384
- catch (err) {
385
- refuse(`certificate issuance failed: ${err instanceof Error ? err.message : String(err)}`);
386
- }
387
- }
388
- acceptTunnel(socket, nonce, leftover) {
389
- const pending = this.pendingTunnels.get(nonce);
390
- if (!pending) {
391
- socket.destroy();
392
- return;
393
- }
394
- this.pendingTunnels.delete(nonce);
395
- clearTimeout(pending.timer);
396
- pending.resolve({ socket, leftover: Buffer.from(leftover) });
397
- }
398
- workerBySocket(socket) {
399
- for (const worker of this.workers.values()) {
400
- if (worker.socket === socket)
401
- return worker;
402
- }
403
- return undefined;
404
- }
405
- }
406
- export const gondolinGateway = new GondolinWorkerGateway();
407
- //# sourceMappingURL=gondolin-gateway.js.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"gondolin-gateway.js","sourceRoot":"","sources":["../../src/sandbox/gondolin-gateway.ts"],"names":[],"mappings":"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","sourcesContent":["import { randomBytes } from \"node:crypto\";\nimport { readFileSync } from \"node:fs\";\nimport type { Server, Socket } from \"node:net\";\nimport { hostname } from \"node:os\";\nimport { TLSSocket, createServer as createTlsServer } from \"node:tls\";\nimport * as log from \"../log.js\";\nimport type { GondolinGatewaySettings } from \"../types.js\";\nimport { gondolinFleet } from \"./gondolin-fleet.js\";\nimport { gondolinJoin } from \"./gondolin-join.js\";\nimport { createSessionFrameParser, encodeSessionMessage } from \"./gondolin-contract.js\";\nimport { GondolinRemoteConnection, GondolinWorkerUnreachableError } from \"./gondolin-remote.js\";\nimport type { SessionClient, SessionClientCallbacks } from \"./gondolin-worker-client.js\";\n\nconst RPC_TIMEOUT_MS = 150_000;\nconst TUNNEL_TIMEOUT_MS = 15_000;\n\n/** What a worker announces when it dials home (mirrors the Go register frame). */\ninterface GondolinWorkerRegistration {\n name: string;\n os?: string;\n arch?: string;\n accelerator?: string;\n cpus?: number;\n memoryBytes?: number;\n maxRuntimes?: number;\n protocolVersion?: number;\n runtimes?: Array<{ sessionId: string; instanceId: string }>;\n /** Non-empty when the worker's shared workspace failed its usability probe. */\n workspaceError?: string;\n}\n\ninterface ControlFrame extends GondolinWorkerRegistration {\n type: string;\n id?: number;\n status?: number;\n body?: unknown;\n nonce?: string;\n activeRuntimes?: number;\n /** join exchange */\n token?: string;\n csr?: string;\n}\n\ninterface RegisteredWorker {\n info: GondolinWorkerRegistration;\n socket: Socket;\n connectedAt: number;\n lastSeen: number;\n activeRuntimes: number;\n workspaceError?: string;\n pendingRpc: Map<\n number,\n {\n resolve: (frame: ControlFrame) => void;\n reject: (error: Error) => void;\n timer: NodeJS.Timeout;\n }\n >;\n nextRpcId: number;\n}\n\n/**\n * Splits a byte stream into u32be-length-prefixed JSON frames, preserving any\n * bytes after the point where the consumer stops parsing (a tunnel connection\n * switches protocols after its preamble frame).\n */\nfunction createControlFrameReader(onFrame: (frame: ControlFrame, leftover: Buffer) => void): {\n push: (chunk: Buffer) => void;\n stop: () => void;\n} {\n let buffer = Buffer.alloc(0);\n let stopped = false;\n return {\n push(chunk: Buffer) {\n if (stopped) return;\n buffer = Buffer.concat([buffer, chunk]);\n for (;;) {\n // onFrame may call stop() synchronously (a tunnel switching protocols)\n if (stopped || buffer.length < 4) return;\n const length = buffer.readUInt32BE(0);\n if (buffer.length < 4 + length) return;\n const payload = buffer.subarray(4, 4 + length);\n buffer = buffer.subarray(4 + length);\n let frame: ControlFrame;\n try {\n frame = JSON.parse(payload.toString(\"utf8\")) as ControlFrame;\n } catch {\n continue; // skip malformed frames\n }\n onFrame(frame, buffer);\n }\n },\n stop() {\n stopped = true;\n },\n };\n}\n\nfunction encodeControlFrame(frame: object): Buffer {\n return encodeSessionMessage(frame);\n}\n\ninterface GatewayOverrides {\n /** Server factory (tests substitute a plain net.Server). */\n createServer?: (onConnection: (socket: Socket) => void) => Server;\n /** mTLS verification result for a socket (tests substitute outcomes). */\n isAuthorized?: (socket: Socket) => boolean;\n leaseTtlSeconds?: number;\n rpcTimeoutMs?: number;\n tunnelTimeoutMs?: number;\n}\n\nfunction defaultIsAuthorized(socket: Socket): boolean {\n return socket instanceof TLSSocket && socket.authorized;\n}\n\n/**\n * The host side of dial-home workers: one mTLS listener that accepts worker\n * control channels (register/ping/RPC responses) and per-command dial-back\n * tunnels, keeps the registry of connected workers, and attaches each one to\n * the fleet as a regular worker connection. Placement, leases, fencing, and\n * failover are unchanged — this only reverses who dials whom.\n */\nclass GondolinWorkerGateway {\n private settings?: GondolinGatewaySettings;\n private overrides: GatewayOverrides = {};\n private server?: Server;\n private readonly workers = new Map<string, RegisteredWorker>();\n private readonly pendingTunnels = new Map<\n string,\n { resolve: (value: { socket: Socket; leftover: Buffer }) => void; timer: NodeJS.Timeout }\n >();\n\n configure(settings?: GondolinGatewaySettings, overrides?: GatewayOverrides): void {\n this.stop();\n this.settings = settings;\n this.overrides = overrides ?? {};\n }\n\n isConfigured(): boolean {\n return this.settings !== undefined;\n }\n\n /** Registered workers and their liveness (admin/observability surface). */\n list(): Array<{\n name: string;\n connected: boolean;\n activeRuntimes: number;\n workspaceError?: string;\n info: GondolinWorkerRegistration;\n }> {\n return Array.from(this.workers.values()).map((worker) => ({\n name: worker.info.name,\n connected: !worker.socket.destroyed,\n activeRuntimes: worker.activeRuntimes,\n workspaceError: worker.workspaceError,\n info: worker.info,\n }));\n }\n\n /**\n * Start the listener. Without explicit certificate settings the gateway\n * provisions its own: a private worker CA plus a server certificate signed\n * by it (required for join's CA pinning to also authenticate the host).\n */\n async start(): Promise<void> {\n if (!this.settings || this.server) return;\n const settings = this.settings;\n if (!settings.workspaceRoot) {\n // dial-home workers inherit workspaceRoot from here; without it every\n // runtime is rejected with \"escapes the workspace root\"\n throw new Error(\n \"gondolin gateway requires workspaceRoot (the worker-side shared workspace path); \" +\n \"set sandbox.gondolin.remote.gateway.workspaceRoot\",\n );\n }\n let material: { certFile: string; keyFile: string; clientCaFile: string };\n if (settings.certFile && settings.keyFile && settings.clientCaFile) {\n material = {\n certFile: settings.certFile,\n keyFile: settings.keyFile,\n clientCaFile: settings.clientCaFile,\n };\n } else {\n if (!gondolinJoin.isConfigured()) {\n throw new Error(\"gondolin gateway auto-init requires the join service to be configured\");\n }\n const issued = await gondolinJoin.ensureServerCert(settings.hostnames ?? [hostname()]);\n material = { ...issued, clientCaFile: gondolinJoin.paths().caFile };\n }\n const factory =\n this.overrides.createServer ??\n ((onConnection: (socket: Socket) => void) =>\n createTlsServer(\n {\n cert: readFileSync(material.certFile),\n key: readFileSync(material.keyFile),\n ca: readFileSync(material.clientCaFile),\n requestCert: true,\n // unauthenticated connections may only send a join frame; the\n // per-frame authorization gate enforces that below\n rejectUnauthorized: false,\n minVersion: \"TLSv1.3\",\n },\n onConnection,\n ));\n this.server = factory((socket) => this.handleConnection(socket));\n this.server.listen(this.settings.port, () => {\n log.logInfo(`Gondolin worker gateway listening on :${this.settings?.port}`);\n });\n }\n\n stop(): void {\n for (const worker of this.workers.values()) {\n worker.socket.destroy();\n this.rejectPendingRpc(worker, \"gateway stopped\");\n }\n this.workers.clear();\n for (const pending of this.pendingTunnels.values()) clearTimeout(pending.timer);\n this.pendingTunnels.clear();\n this.server?.close();\n this.server = undefined;\n }\n\n /** Routes one inbound connection by its first frame: control or tunnel. */\n private handleConnection(socket: Socket): void {\n socket.setNoDelay(true);\n socket.setKeepAlive(true, 30_000);\n let routed = false;\n const authorized = (this.overrides.isAuthorized ?? defaultIsAuthorized)(socket);\n const reader = createControlFrameReader((frame, leftover) => {\n if (!routed) {\n routed = true;\n if (frame.type === \"join\") {\n void this.handleJoin(socket, frame);\n } else if (!authorized) {\n // everything except join requires a CA-signed client certificate\n socket.destroy();\n } else if (frame.type === \"register\" && frame.name) {\n this.acceptControlChannel(socket, frame, reader);\n } else if (frame.type === \"tunnel\" && frame.nonce) {\n reader.stop();\n socket.removeAllListeners(\"data\");\n this.acceptTunnel(socket, frame.nonce, leftover);\n } else {\n socket.destroy();\n }\n return;\n }\n this.handleControlFrame(socket, frame);\n });\n socket.on(\"data\", (chunk: Buffer) => reader.push(chunk));\n socket.on(\"error\", () => socket.destroy());\n }\n\n private acceptControlChannel(\n socket: Socket,\n registration: ControlFrame,\n _reader: { stop: () => void },\n ): void {\n const name = registration.name as string;\n const previous = this.workers.get(name);\n if (previous && !previous.socket.destroyed) {\n log.logInfo(`Gondolin worker '${name}' re-registered; superseding previous connection`);\n previous.socket.destroy();\n }\n const worker: RegisteredWorker = {\n info: registration,\n socket,\n connectedAt: Date.now(),\n lastSeen: Date.now(),\n activeRuntimes: registration.runtimes?.length ?? 0,\n pendingRpc: new Map(),\n nextRpcId: 1,\n };\n this.workers.set(name, worker);\n const surviving = registration.runtimes?.length ?? 0;\n log.logInfo(\n `Gondolin worker joined: ${name} (${registration.os}/${registration.arch}, ` +\n `${registration.accelerator}, ${registration.cpus} cpus, ` +\n `cap ${registration.maxRuntimes ?? \"∞\"}, ${surviving} runtimes surviving)`,\n );\n\n const overrides = this.settings?.workers?.[name];\n gondolinFleet.attachWorker(\n {\n name,\n url: `dialhome://${name}`,\n workspaceRoot: this.settings?.workspaceRoot,\n maxRuntimes: overrides?.maxRuntimes ?? registration.maxRuntimes,\n draining: overrides?.draining,\n },\n (connectionOverrides) =>\n new GondolinRemoteConnection(\n { name, url: `dialhome://${name}`, workspaceRoot: this.settings?.workspaceRoot },\n {\n ...connectionOverrides,\n ...(this.overrides.leaseTtlSeconds !== undefined\n ? { leaseTtlSeconds: this.overrides.leaseTtlSeconds }\n : {}),\n request: (method, path, body, headers) => this.rpc(name, method, path, body, headers),\n tunnel: (path, headers, callbacks) => this.openTunnel(name, path, headers, callbacks),\n },\n ),\n );\n this.applyWorkspaceHealth(worker, registration.workspaceError);\n // a worker that reconnected may carry runtimes whose placements moved\n void gondolinFleet.reconcile();\n\n socket.on(\"close\", () => {\n this.rejectPendingRpc(worker, `worker '${name}' disconnected`);\n const current = this.workers.get(name);\n if (current !== worker) return; // superseded\n log.logWarning(`Gondolin worker disconnected: ${name} (placements fence until lease expiry)`);\n gondolinFleet.detachWorker(name);\n this.workers.delete(name);\n });\n }\n\n private handleControlFrame(socket: Socket, frame: ControlFrame): void {\n const worker = this.workerBySocket(socket);\n if (!worker) return;\n worker.lastSeen = Date.now();\n if (frame.type === \"ping\") {\n if (typeof frame.activeRuntimes === \"number\") {\n worker.activeRuntimes = frame.activeRuntimes;\n }\n // omitted on healthy pings (Go omitempty), so absence means recovered\n this.applyWorkspaceHealth(worker, frame.workspaceError);\n socket.write(encodeControlFrame({ type: \"pong\" }));\n return;\n }\n if (frame.type === \"response\" && typeof frame.id === \"number\") {\n const pending = worker.pendingRpc.get(frame.id);\n if (!pending) return;\n worker.pendingRpc.delete(frame.id);\n clearTimeout(pending.timer);\n pending.resolve(frame);\n }\n }\n\n /**\n * Track shared-workspace health from register/ping frames and push it into\n * the fleet, logging only the transitions. A worker whose NFS mount died\n * keeps its control channel alive — this is what turns that silent state\n * into refused placements and fail-fast execs.\n */\n private applyWorkspaceHealth(worker: RegisteredWorker, error: string | undefined): void {\n const next = error || undefined;\n if (next === worker.workspaceError) {\n gondolinFleet.setWorkspaceHealth(worker.info.name, next); // attach may have reset it\n return;\n }\n if (next) {\n log.logWarning(\n `Gondolin worker '${worker.info.name}' workspace is unusable: ${next} — new placements disabled until it recovers`,\n );\n } else {\n log.logInfo(`Gondolin worker '${worker.info.name}' workspace recovered`);\n }\n worker.workspaceError = next;\n gondolinFleet.setWorkspaceHealth(worker.info.name, next);\n }\n\n /** RPC to a worker over its control channel (the reverse of HTTPS requests). */\n private rpc(\n name: string,\n method: string,\n path: string,\n body?: object,\n headers?: Record<string, string>,\n ): Promise<{ status: number; json: Record<string, unknown> }> {\n const worker = this.workers.get(name);\n if (!worker || worker.socket.destroyed) {\n return Promise.reject(\n new GondolinWorkerUnreachableError(`worker '${name}' is not connected`),\n );\n }\n const id = worker.nextRpcId++;\n return new Promise((resolve, reject) => {\n const timer = setTimeout(() => {\n worker.pendingRpc.delete(id);\n reject(\n new GondolinWorkerUnreachableError(\n `RPC to worker '${name}' timed out (${method} ${path})`,\n ),\n );\n }, this.overrides.rpcTimeoutMs ?? RPC_TIMEOUT_MS);\n timer.unref?.();\n worker.pendingRpc.set(id, {\n timer,\n reject,\n resolve: (frame) =>\n resolve({\n status: frame.status ?? 0,\n json: (frame.body ?? {}) as Record<string, unknown>,\n }),\n });\n worker.socket.write(encodeControlFrame({ type: \"request\", id, method, path, body, headers }));\n });\n }\n\n private rejectPendingRpc(worker: RegisteredWorker, reason: string): void {\n for (const pending of worker.pendingRpc.values()) {\n clearTimeout(pending.timer);\n pending.reject(new GondolinWorkerUnreachableError(reason));\n }\n worker.pendingRpc.clear();\n }\n\n /** Ask the worker to dial back a data connection for one session tunnel. */\n private openTunnel(\n name: string,\n path: string,\n headers: Record<string, string>,\n callbacks: SessionClientCallbacks,\n ): Promise<SessionClient> {\n const worker = this.workers.get(name);\n if (!worker || worker.socket.destroyed) {\n const error = new Error(`worker '${name}' is not connected`) as NodeJS.ErrnoException;\n error.code = \"ECONNREFUSED\"; // nothing executed — safe to recreate\n return Promise.reject(error);\n }\n const sessionId = path.split(\"/\")[3];\n const nonce = randomBytes(16).toString(\"hex\");\n return new Promise((resolve, reject) => {\n const timer = setTimeout(() => {\n this.pendingTunnels.delete(nonce);\n const error = new Error(\n `worker '${name}' did not dial back a tunnel`,\n ) as NodeJS.ErrnoException;\n error.code = \"ECONNREFUSED\";\n reject(error);\n }, this.overrides.tunnelTimeoutMs ?? TUNNEL_TIMEOUT_MS);\n timer.unref?.();\n this.pendingTunnels.set(nonce, {\n timer,\n resolve: ({ socket, leftover }) => {\n let closed = false;\n const parse = createSessionFrameParser(callbacks);\n if (leftover.length > 0) parse(leftover);\n socket.on(\"data\", parse);\n socket.on(\"error\", (error: Error) => {\n if (closed) return;\n closed = true;\n callbacks.onClose(error);\n });\n socket.on(\"close\", () => {\n if (closed) return;\n closed = true;\n callbacks.onClose();\n });\n resolve({\n send: (message) => {\n if (!closed) socket.write(encodeSessionMessage(message));\n },\n close: () => {\n if (closed) return;\n closed = true;\n socket.destroy();\n },\n });\n },\n });\n worker.socket.write(encodeControlFrame({ type: \"open-tunnel\", nonce, sessionId, headers }));\n });\n }\n\n /**\n * One-time token → CA-signed client certificate. The only operation an\n * unauthenticated connection may perform; the connection closes after the\n * response either way.\n */\n private async handleJoin(socket: Socket, frame: ControlFrame): Promise<void> {\n const refuse = (message: string): void => {\n log.logWarning(`Gondolin worker join refused: ${message}`);\n socket.end(encodeControlFrame({ type: \"join-error\", message }));\n };\n if (!gondolinJoin.isConfigured()) {\n refuse(\"join is not enabled on this gateway\");\n return;\n }\n if (!frame.token || !frame.csr || !frame.name) {\n refuse(\"join requires token, csr, and name\");\n return;\n }\n if (!gondolinJoin.consumeToken(frame.token)) {\n refuse(`invalid or expired join token (worker '${frame.name}')`);\n return;\n }\n try {\n const signed = await gondolinJoin.signCsr(frame.csr);\n log.logInfo(`Gondolin worker '${frame.name}' joined: client certificate issued`);\n socket.end(encodeControlFrame({ type: \"join-ok\", cert: signed.certPem, ca: signed.caPem }));\n } catch (err) {\n refuse(`certificate issuance failed: ${err instanceof Error ? err.message : String(err)}`);\n }\n }\n\n private acceptTunnel(socket: Socket, nonce: string, leftover: Buffer): void {\n const pending = this.pendingTunnels.get(nonce);\n if (!pending) {\n socket.destroy();\n return;\n }\n this.pendingTunnels.delete(nonce);\n clearTimeout(pending.timer);\n pending.resolve({ socket, leftover: Buffer.from(leftover) });\n }\n\n private workerBySocket(socket: Socket): RegisteredWorker | undefined {\n for (const worker of this.workers.values()) {\n if (worker.socket === socket) return worker;\n }\n return undefined;\n }\n}\n\nexport const gondolinGateway = new GondolinWorkerGateway();\n"]}