@miosa/sdk 1.2.3 → 1.2.4

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@miosa/sdk",
-  "version": "1.2.3",
+  "version": "1.2.4",
   "description": "TypeScript SDK for the MIOSA API — cloud VM desktop infrastructure for AI agents",
   "license": "MIT",
   "author": "MIOSA <hello@miosa.ai>",

package/src/resources/deployments.test.ts

@@ -72,6 +72,12 @@ describe("Deployments", () => {
             metadata: {
               deployment_product: "docker_deploy",
               runtime: { ip: "172.16.74.246", port: 23906 },
+              docker_deploy: {
+                app_id: "miosa-clinic-intake",
+                container_id: "container_123",
+                status: "running",
+                url: "http://127.0.0.1:23906",
+              },
             },
           },
         };
@@ -114,8 +120,75 @@ describe("Deployments", () => {
       "deployment_product",
       "docker_deploy_host_id",
       "docker_deploy_host_health",
+      "docker_deploy_app",
       "runtime_route",
       "public_url_probe",
     ]);
   });
+
+  it("doctorDockerDeploy fails when route metadata does not point at the Docker container port", async () => {
+    mockGet.mockImplementation(async (path: string) => {
+      if (path === "/deployments/dep_123") {
+        return {
+          data: {
+            id: "dep_123",
+            tenant_id: "ten_123",
+            name: "Clinic Intake",
+            slug: "clinic-intake",
+            state: "running",
+            deployment_product: "docker_deploy",
+            docker_deploy_host_id: "ddh_123",
+            public_url: "https://clinic-intake.osa.miosa.app",
+            metadata: {
+              deployment_product: "docker_deploy",
+              runtime: { ip: "172.16.74.246", port: 8080 },
+              docker_deploy: {
+                app_id: "miosa-clinic-intake",
+                container_id: "container_123",
+                status: "running",
+                url: "http://127.0.0.1:23906",
+              },
+            },
+          },
+        };
+      }
+
+      if (path === "/docker-deploy/hosts/ddh_123") {
+        return {
+          data: {
+            id: "ddh_123",
+            tenant_id: "ten_123",
+            workspace_id: "ws_123",
+            status: "active",
+            size: "medium",
+            region: "us",
+            appliance_status: "healthy",
+          },
+        };
+      }
+
+      throw new Error(`unexpected path ${path}`);
+    });
+    vi.stubGlobal(
+      "fetch",
+      vi.fn().mockResolvedValue({ ok: true, status: 200 }),
+    );
+
+    const result = await new Deployments(makeHttp()).doctorDockerDeploy(
+      "dep_123",
+      { probePath: "/health" },
+    );
+
+    expect(result.ok).toBe(false);
+    expect(result.checks).toEqual(
+      expect.arrayContaining([
+        expect.objectContaining({
+          name: "runtime_route",
+          ok: false,
+          message:
+            "Deployment route port 8080 does not match Docker container host port 23906.",
+        }),
+      ]),
+    );
+  });
 });

package/src/resources/deployments.ts

@@ -481,6 +481,25 @@ function dockerDeployHostId(deployment: DeploymentData): string | null {
   );
 }
 
+function dockerDeployApp(deployment: DeploymentData): Record<string, unknown> | null {
+  const app = deployment.metadata?.["docker_deploy"];
+  if (!app || typeof app !== "object" || Array.isArray(app)) return null;
+  return app as Record<string, unknown>;
+}
+
+function dockerDeployAppPort(app: Record<string, unknown> | null): number | null {
+  const url = app?.["url"];
+  if (typeof url !== "string") return null;
+
+  try {
+    const parsed = new URL(url);
+    const port = Number.parseInt(parsed.port, 10);
+    return Number.isInteger(port) ? port : null;
+  } catch {
+    return null;
+  }
+}
+
 function addDoctorCheck(
   checks: DockerDeployDoctorCheck[],
   name: string,
@@ -787,21 +806,55 @@ export class Deployments {
       }
     }
 
+    const app = dockerDeployApp(deployment);
+    const appPort = dockerDeployAppPort(app);
+    const appRunning = app?.["status"] === "running" && appPort !== null;
+    addDoctorCheck(
+      checks,
+      "docker_deploy_app",
+      appRunning,
+      appRunning
+        ? "Docker Deploy app metadata points at a running container."
+        : "Deployment is missing running Docker Deploy app metadata.",
+      app
+        ? {
+            app_id: app["app_id"],
+            container_id: app["container_id"],
+            status: app["status"],
+            url: app["url"],
+            expected_port: appPort,
+          }
+        : undefined,
+    );
+
     const runtime = metadata["runtime"];
     const hasRuntimeRoute =
       typeof runtime === "object" &&
       runtime !== null &&
       typeof (runtime as Record<string, unknown>)["ip"] === "string" &&
       typeof (runtime as Record<string, unknown>)["port"] === "number";
+    const runtimeRecord =
+      hasRuntimeRoute && typeof runtime === "object"
+        ? (runtime as Record<string, unknown>)
+        : undefined;
+    const routeMatchesContainerPort =
+      hasRuntimeRoute &&
+      (appPort === null || runtimeRecord?.["port"] === appPort);
     addDoctorCheck(
       checks,
       "runtime_route",
-      hasRuntimeRoute,
-      hasRuntimeRoute
-        ? "Deployment has appliance runtime route metadata."
+      hasRuntimeRoute && routeMatchesContainerPort,
+      hasRuntimeRoute && routeMatchesContainerPort
+        ? "Deployment route points at the Docker container host port."
+        : hasRuntimeRoute && appPort !== null
+          ? `Deployment route port ${String(runtimeRecord?.["port"])} does not match Docker container host port ${appPort}.`
         : "Deployment is missing appliance runtime route metadata.",
-      typeof runtime === "object" && runtime !== null
-        ? (runtime as Record<string, unknown>)
+      runtimeRecord
+        ? {
+            ...runtimeRecord,
+            expected_port: appPort,
+            docker_deploy_url: app?.["url"],
+          }
         : undefined,
     );