feat: add provider-backed microservices

scripts/src/remote.ts

@@ -1,6 +1,7 @@
 import { spawn } from "node:child_process";
 import { type UniDeskConfig } from "./config";
 import { type DebugDispatchCommand, isDebugDispatchCommand } from "./debug";
+import { summarizeMicroserviceProxyResponse } from "./microservices";
 import { parseSshArgs } from "./ssh";
 
 export interface RemoteCliOptions {
@@ -354,6 +355,29 @@ async function remoteDebugTask(session: FrontendSession, args: string[]): Promis
   return { transport: "frontend", tasksResponse, taskId, task: task ?? null };
 }
 
+async function remoteMicroservice(session: FrontendSession, args: string[]): Promise<unknown> {
+  const action = args[1] ?? "list";
+  const id = args[2];
+  const path = args[3];
+  if (action === "list") {
+    return { transport: "frontend", response: await frontendJson(session, "/api/microservices", undefined, 12_000) };
+  }
+  if ((action === "status" || action === "health") && id !== undefined) {
+    return {
+      transport: "frontend",
+      response: await frontendJson(session, `/api/microservices/${encodeURIComponent(id)}/${action}`, undefined, 18_000),
+    };
+  }
+  if (action === "proxy" && id !== undefined && path !== undefined && path.startsWith("/")) {
+    const response = await frontendJson(session, `/api/microservices/${encodeURIComponent(id)}/proxy${path}`, undefined, 24_000);
+    return {
+      transport: "frontend",
+      response: summarizeMicroserviceProxyResponse(response, args),
+    };
+  }
+  throw new Error("remote microservice command must be: microservice list | status <id> | health <id> | proxy <id> <path>");
+}
+
 async function runRemoteSshOverFrontend(session: FrontendSession, providerId: string | undefined, args: string[]): Promise<number> {
   if (!providerId) throw new Error("remote ssh requires provider id, for example: bun scripts/cli.ts --main-server-ip 74.48.78.17 ssh D601 hostname");
   const parsed = parseSshArgs(args);
@@ -399,7 +423,7 @@ async function runRemoteCliOverFrontend(options: RemoteCliOptions, config: UniDe
       emitRemoteJson(name, {
         transport: "frontend",
         baseUrl: session.baseUrl,
-        commands: ["debug health", "debug dispatch", "debug task", "ssh <providerId> <command>"],
+        commands: ["debug health", "debug dispatch", "debug task", "ssh <providerId> <command>", "microservice list", "microservice status <id>", "microservice health <id>", "microservice proxy <id> <path>"],
       });
       return 0;
     }
@@ -415,6 +439,10 @@ async function runRemoteCliOverFrontend(options: RemoteCliOptions, config: UniDe
       emitRemoteJson(name, await remoteDebugTask(session, args));
       return 0;
     }
+    if (top === "microservice") {
+      emitRemoteJson(name, await remoteMicroservice(session, args));
+      return 0;
+    }
     if (top === "ssh") {
       return await runRemoteSshOverFrontend(session, sub, args.slice(2));
     }