@miosa/sdk 1.2.4 → 1.2.5

package/package.json

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

package/src/client.ts

@@ -15,7 +15,7 @@ import { CronJobs } from "./resources/cron-jobs.js";
 import { Dashboard } from "./resources/dashboard.js";
 import { Databases } from "./resources/databases.js";
 import { Deployments } from "./resources/deployments.js";
-import { DockerDeploy } from "./resources/docker-deploy.js";
+import { Devices } from "./resources/devices.js";
 import { EgressAudit } from "./resources/egressAudit.js";
 import { EgressNetwork } from "./resources/egressNetwork.js";
 import { EgressSecrets } from "./resources/egressSecrets.js";
@@ -125,15 +125,15 @@ export class Miosa {
   /** Sandboxes — native code-execution environments under `/sandboxes`. */
   readonly sandboxes: Sandboxes;
 
+  /** Agent device facade — route work across Sandboxes, Computers, and deploy hosts. */
+  readonly devices: Devices;
+
   /**
    * Deployments — publish from a sandbox to a stable production URL.
    * Versions, releases, rollback, custom domains.
    */
   readonly deployments: Deployments;
 
-  /** Docker Deploy appliance hosts — one always-on workspace host, many apps. */
-  readonly dockerDeploy: DockerDeploy;
-
   /** Credit balance and usage. */
   readonly credits: Credits;
 
@@ -260,8 +260,8 @@ export class Miosa {
     this.mcp = new Mcp(this.http);
     this.computers = new Computers(this.http);
     this.sandboxes = new Sandboxes(this.http);
+    this.devices = new Devices(this.http);
     this.deployments = new Deployments(this.http);
-    this.dockerDeploy = new DockerDeploy(this.http);
     this.credits = new Credits(this.http);
     this.admin = new Admin(this.http);
     this.openComputers = new OpenComputers(this.http);

package/src/index.ts

@@ -67,6 +67,16 @@ export type {
 // Resource classes (useful for isinstance checks and extension)
 export { Computer, ScopedFs } from "./resources/computer.js";
 export { Computers } from "./resources/computers.js";
+export { Devices } from "./resources/devices.js";
+export type {
+  DeviceCatalogEntry,
+  DeviceKind,
+  DeviceListError,
+  DeviceListParams,
+  DeviceListResponse,
+  DeviceRecord,
+  DeviceSource,
+} from "./resources/devices.js";
 export { Desktop } from "./resources/desktop.js";
 export { Exec } from "./resources/exec.js";
 export { Files } from "./resources/files.js";
@@ -135,11 +145,17 @@ export type {
   DeploymentVersionId,
   DeploymentVersionKind,
   DeploymentVersionState,
+  DockerDeployDesignReferencePreset,
   DockerDeployCreateParams,
   DockerDeployDoctorCheck,
   DockerDeployDoctorParams,
   DockerDeployDoctorProbe,
   DockerDeployDoctorResult,
+  DockerDeployTemplateData,
+  DockerDeployTemplateListParams,
+  DockerDeployHostData,
+  DockerDeployHostEnsureParams,
+  DockerDeployHostListParams,
   ExternalAttribution,
   PublishFromSandboxParams,
   PublishParams,
@@ -151,17 +167,6 @@ export type {
   RuntimeLogsResult,
   VersionListParams,
 } from "./resources/deployments.js";
-export { DockerDeploy } from "./resources/docker-deploy.js";
-export type {
-  DockerDeployApplianceStatus,
-  DockerDeployHostData,
-  DockerDeployHostEnsureParams,
-  DockerDeployHostId,
-  DockerDeployHostListParams,
-  DockerDeployHostListResponse,
-  DockerDeployHostResponse,
-  DockerDeployHostStatus,
-} from "./resources/docker-deploy.js";
 export type {
   SnapshotData,
   SnapshotStatus,

package/src/resources/admin.ts

@@ -345,15 +345,4 @@ export class Admin {
       model_id: modelId,
     });
   }
-
-  /** POST /api/v1/admin/impersonate — returns {token, expires_at}. */
-  impersonate(
-    externalUserId: string,
-    options: { ttlSec?: number } = {},
-  ): Promise<{ token: string; expires_at: string }> {
-    return this.http.post("/admin/impersonate", {
-      external_user_id: externalUserId,
-      ttl_sec: options.ttlSec ?? 3600,
-    });
-  }
 }

package/src/resources/api-keys.ts

@@ -113,22 +113,6 @@ export class ApiKeys {
     return unwrap<ApiKeyCreateResult>(data);
   }
 
-  /** POST /api/v1/api-keys/scoped — L2 delegation token bound to one external user. */
-  async createScoped(params: {
-    externalUserId: string;
-    scopes: string[];
-    expiresAt?: string;
-  }): Promise<ApiKeyCreateResult> {
-    const body = stripUndefined({
-      external_user_id: params.externalUserId,
-      scopes: params.scopes,
-      expires_at: params.expiresAt,
-    });
-    return unwrap<ApiKeyCreateResult>(
-      await this.http.post<unknown>("/api-keys/scoped", body),
-    );
-  }
-
   async delete(keyId: string): Promise<void> {
     await this.http.delete<unknown>(`/api-keys/${keyId}`);
   }

package/src/resources/custom_domains.ts

@@ -41,7 +41,7 @@ export interface CustomDomainRegisterParams {
  * // 1. Register the domain
  * const domain = await computer.domains.register("app.example.com");
  * console.log(domain.instructions);
- * // => "Add a CNAME record: app.example.com → <slug>.sandbox.miosa.ai"
+ * // => "Add a CNAME record: app.example.com → <slug>.sandbox.<tenant-domain>"
  *
  * // 2. Add the CNAME in your DNS registrar, then...
  *

package/src/resources/deployments.test.ts

@@ -14,7 +14,6 @@ function makeHttp(): HttpClient {
 
 beforeEach(() => {
   vi.clearAllMocks();
-  vi.unstubAllGlobals();
 });
 
 describe("Deployments", () => {
@@ -56,139 +55,143 @@ describe("Deployments", () => {
     expect(deployment.docker_deploy_host_id).toBe("ddh_123");
   });
 
-  it("doctorDockerDeploy verifies host, route metadata, and public URL", 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: 23906 },
-              docker_deploy: {
-                app_id: "miosa-clinic-intake",
-                container_id: "container_123",
-                status: "running",
-                url: "http://127.0.0.1:23906",
+  it("lists Docker Deploy templates", async () => {
+    mockGet.mockResolvedValue({
+      data: {
+        templates: [
+          {
+            id: "nextjs-app",
+            name: "Next.js App",
+            runtime: "node",
+            framework: "nextjs",
+            design_md: "# Design",
+            design_reference_presets: [
+              {
+                id: "fintech-control",
+                name: "Fintech Control",
+                summary: "Metrics-heavy finance app.",
+                best_for: ["billing portals"],
               },
-            },
+            ],
           },
-        };
-      }
-
-      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",
-          },
-        };
-      }
+        ],
+      },
+    });
+
+    const templates = await new Deployments(
+      makeHttp(),
+    ).listDockerDeployTemplates({
+      framework: "nextjs",
+      includePreview: true,
+    });
 
-      throw new Error(`unexpected path ${path}`);
+    expect(mockGet).toHaveBeenCalledWith("/docker-deploy/templates", {
+      framework: "nextjs",
+      include_preview: true,
     });
-    vi.stubGlobal(
-      "fetch",
-      vi.fn().mockResolvedValue({ ok: true, status: 200 }),
+    expect(templates[0]?.id).toBe("nextjs-app");
+    expect(templates[0]?.design_reference_presets?.[0]?.id).toBe(
+      "fintech-control",
     );
+  });
 
-    const result = await new Deployments(makeHttp()).doctorDockerDeploy(
-      "dep_123",
-      { probePath: "/health" },
+  it("gets one Docker Deploy template", async () => {
+    mockGet.mockResolvedValue({
+      data: {
+        id: "compose-full-stack",
+        name: "Compose Full Stack",
+        runtime: "docker-compose",
+      },
+    });
+
+    const template = await new Deployments(makeHttp()).getDockerDeployTemplate(
+      "compose-full-stack",
     );
 
-    expect(result.ok).toBe(true);
-    expect(mockGet).toHaveBeenCalledWith("/deployments/dep_123");
-    expect(mockGet).toHaveBeenCalledWith("/docker-deploy/hosts/ddh_123");
-    expect(fetch).toHaveBeenCalledWith(
-      "https://clinic-intake.osa.miosa.app/health",
-      expect.objectContaining({ method: "GET" }),
+    expect(mockGet).toHaveBeenCalledWith(
+      "/docker-deploy/templates/compose-full-stack",
     );
-    expect(result.checks.map((check) => check.name)).toEqual([
-      "deployment_product",
-      "docker_deploy_host_id",
-      "docker_deploy_host_health",
-      "docker_deploy_app",
-      "runtime_route",
-      "public_url_probe",
-    ]);
+    expect(template.runtime).toBe("docker-compose");
   });
 
-  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",
+  it("doctorDockerDeploy() proves appliance metadata and public URL", async () => {
+    mockGet
+      .mockResolvedValueOnce({
+        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.osa.miosa.app",
+          metadata: {
             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",
-              },
-            },
+            runtime: { ip: "172.16.74.246", port: 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}`);
+        },
+      })
+      .mockResolvedValueOnce({
+        data: {
+          id: "ddh_123",
+          status: "active",
+          appliance_status: "healthy",
+        },
+      });
+    const fetchImpl = vi.fn().mockResolvedValue({
+      ok: true,
+      status: 200,
+      text: async () => JSON.stringify({ ok: true, product: "clinic" }),
     });
-    vi.stubGlobal(
-      "fetch",
-      vi.fn().mockResolvedValue({ ok: true, status: 200 }),
+
+    const result = await new Deployments(makeHttp()).doctorDockerDeploy(
+      "dep_123",
+      { probePath: "/health", fetchImpl },
     );
 
+    expect(mockGet).toHaveBeenNthCalledWith(1, "/deployments/dep_123");
+    expect(mockGet).toHaveBeenNthCalledWith(2, "/docker-deploy/hosts/ddh_123");
+    expect(fetchImpl).toHaveBeenCalledWith(
+      "https://clinic.osa.miosa.app/health",
+      expect.objectContaining({ headers: { Accept: "*/*" } }),
+    );
+    expect(result.ok).toBe(true);
+    expect(result.host?.id).toBe("ddh_123");
+    expect(result.probe?.status).toBe(200);
+  });
+
+  it("doctorDockerDeploy() flags gateway JSON as not the user app", async () => {
+    mockGet
+      .mockResolvedValueOnce({
+        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.osa.miosa.app",
+          metadata: { runtime: { ip: "172.16.74.246", port: 23906 } },
+        },
+      })
+      .mockResolvedValueOnce({ data: { id: "ddh_123", status: "active" } });
+    const fetchImpl = vi.fn().mockResolvedValue({
+      ok: true,
+      status: 200,
+      text: async () => JSON.stringify({ ok: true, run_id: "ciq-123" }),
+    });
+
     const result = await new Deployments(makeHttp()).doctorDockerDeploy(
       "dep_123",
-      { probePath: "/health" },
+      { fetchImpl },
     );
 
     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.",
-        }),
-      ]),
-    );
+    expect(result.probe?.gatewayJson).toBe(true);
+    expect(
+      result.checks.find((check) => check.name === "public_url_probe")?.message,
+    ).toContain("gateway JSON");
   });
 });