@miosa/sdk 1.2.4 → 1.2.6

package/src/resources/open-computers/files.ts

@@ -1,97 +0,0 @@
-import { HttpClient } from "../../http.js";
-import type { FsEntry, FsListResponse, FsStat, HostId } from "./types.js";
-
-/**
- * Files resource — direct file-system access on a remote OpenComputers host.
- *
- * Operations are proxied through the OSA daemon running on the host.
- *
- * ```ts
- * const entries = await client.openComputers.files.list(hostId, "/home/user");
- * const bytes = await client.openComputers.files.download(hostId, "/home/user/report.pdf");
- * await client.openComputers.files.upload(hostId, "/tmp/data.json", new TextEncoder().encode("{}"));
- * ```
- */
-export class OcFiles {
-  private readonly http: HttpClient;
-
-  constructor(http: HttpClient) {
-    this.http = http;
-  }
-
-  private base(hostId: string): string {
-    return `/opencomputers/hosts/${hostId}/fs`;
-  }
-
-  /**
-   * List directory entries at `path`.
-   */
-  async list(hostId: HostId | string, path: string): Promise<FsListResponse> {
-    return this.http.get<FsListResponse>(this.base(hostId), { path });
-  }
-
-  /**
-   * Stat a path (does not follow symlinks).
-   */
-  async stat(hostId: HostId | string, path: string): Promise<FsStat> {
-    return this.http.get<FsStat>(`${this.base(hostId)}/stat`, { path });
-  }
-
-  /**
-   * Download a file from the host. Returns raw bytes.
-   */
-  async download(hostId: HostId | string, path: string): Promise<Uint8Array> {
-    const url = `${this.base(hostId)}/download?path=${encodeURIComponent(path)}`;
-    return this.http.getBinary(url);
-  }
-
-  /**
-   * Upload content to `remotePath` on the host.
-   *
-   * @param content    - `Blob`, `Uint8Array`, or UTF-8 string.
-   * @param remotePath - Absolute destination path on the host.
-   * @param filename   - Optional filename hint; defaults to `remotePath` basename.
-   */
-  async upload(
-    hostId: HostId | string,
-    remotePath: string,
-    content: Blob | Uint8Array | string,
-    filename?: string,
-  ): Promise<FsEntry> {
-    const fd = new FormData();
-    const name = filename ?? remotePath.split("/").pop() ?? "file";
-
-    if (typeof content === "string") {
-      fd.append("file", new Blob([content]), name);
-    } else if (content instanceof Uint8Array) {
-      fd.append("file", new Blob([content.buffer as ArrayBuffer]), name);
-    } else {
-      fd.append("file", content, name);
-    }
-    fd.append("path", remotePath);
-
-    return this.http.postFormData<FsEntry>(`${this.base(hostId)}/upload`, fd);
-  }
-
-  /**
-   * Delete a file or directory.
-   *
-   * @param recursive - When `true`, delete non-empty directories recursively.
-   */
-  async delete(
-    hostId: HostId | string,
-    path: string,
-    recursive = false,
-  ): Promise<void> {
-    return this.http.delete<void>(
-      `${this.base(hostId)}?path=${encodeURIComponent(path)}&recursive=${recursive}`,
-    );
-  }
-
-  /**
-   * Create a directory (and any missing parents).
-   */
-  async mkdir(hostId: HostId | string, path: string): Promise<void> {
-    return this.http.post<void>(`${this.base(hostId)}/mkdir`, { path });
-  }
-}

package/src/resources/open-computers/hosts.ts

@@ -1,85 +0,0 @@
-import { HttpClient } from "../../http.js";
-import type {
-  HostCreateParams,
-  HostData,
-  HostEvent,
-  HostId,
-  HostListResponse,
-  HostUpdateParams,
-} from "./types.js";
-
-/**
- * Hosts resource — manage BYOC (Bring Your Own Computer) hosts registered
- * under your tenant.
- *
- * ```ts
- * const host = await client.openComputers.hosts.create({ name: "my-mac" });
- * console.log(host.host_key); // store this — shown only once
- * ```
- */
-export class Hosts {
-  private readonly http: HttpClient;
-
-  constructor(http: HttpClient) {
-    this.http = http;
-  }
-
-  private base(): string {
-    return "/opencomputers/hosts";
-  }
-
-  /**
-   * List all hosts registered for the tenant.
-   */
-  async list(): Promise<HostListResponse> {
-    return this.http.get<HostListResponse>(this.base());
-  }
-
-  /**
-   * Register a new host. The returned `host_key` is shown **once** — store it
-   * immediately and install it on the target machine.
-   */
-  async create(params: HostCreateParams): Promise<HostData> {
-    return this.http.post<HostData>(this.base(), params);
-  }
-
-  /**
-   * Fetch a single host by ID.
-   */
-  async get(id: HostId | string): Promise<HostData> {
-    return this.http.get<HostData>(`${this.base()}/${id}`);
-  }
-
-  /**
-   * Update host metadata (name / labels).
-   */
-  async update(
-    id: HostId | string,
-    params: HostUpdateParams,
-  ): Promise<HostData> {
-    return this.http.patch<HostData>(`${this.base()}/${id}`, params);
-  }
-
-  /**
-   * Revoke a host. Permanently removes the registration; the host key is
-   * invalidated and the host will disconnect on next heartbeat.
-   */
-  async revoke(id: HostId | string): Promise<void> {
-    return this.http.delete<void>(`${this.base()}/${id}`);
-  }
-
-  /**
-   * Stream host state-change events (connect / disconnect / error) as an
-   * `AsyncIterable`.
-   *
-   * ```ts
-   * for await (const event of client.openComputers.hosts.events()) {
-   *   console.log(event.type, event.host_id);
-   *   if (shouldStop) break;
-   * }
-   * ```
-   */
-  events(): AsyncIterableIterator<HostEvent> {
-    return this.http.stream<HostEvent>("/opencomputers/hosts/events");
-  }
-}

package/src/resources/open-computers/index.ts

@@ -1,98 +0,0 @@
-import { HttpClient } from "../../http.js";
-import { Agents } from "./agents.js";
-import { Apps } from "./apps.js";
-import { Clusters } from "./clusters.js";
-import { Desktop } from "./desktop.js";
-import { OcFiles } from "./files.js";
-import { Hosts } from "./hosts.js";
-import { Jobs } from "./jobs.js";
-import { Secrets } from "./secrets.js";
-import { Terminal } from "./terminal.js";
-import { Tunnels } from "./tunnels.js";
-import { OcWorkspaces } from "./workspaces.js";
-
-export * from "./types.js";
-export { Agents } from "./agents.js";
-export { Apps } from "./apps.js";
-export { Clusters } from "./clusters.js";
-export { Desktop } from "./desktop.js";
-export { OcFiles } from "./files.js";
-export { Hosts } from "./hosts.js";
-export { Jobs } from "./jobs.js";
-export { Secrets } from "./secrets.js";
-export { Terminal } from "./terminal.js";
-export { Tunnels } from "./tunnels.js";
-export { OcWorkspaces } from "./workspaces.js";
-
-/**
- * OpenComputers namespace — BYOC (Bring Your Own Computer) host management.
- *
- * Register your own machines (Mac, Linux, Windows) with MIOSA and use them
- * just like cloud computers: run jobs, manage files, open terminals, expose
- * ports, dispatch AI agents, and run LLM inference clusters.
- *
- * Access via `client.openComputers`:
- *
- * ```ts
- * const miosa = new Miosa({ apiKey: "msk_u_..." });
- *
- * // Register a host — save host_key immediately, shown only once
- * const host = await miosa.openComputers.hosts.create({ name: "my-mac" });
- *
- * // Run a command
- * const job = await miosa.openComputers.jobs.run(host.id, { command: "npm test" });
- *
- * // Stream output
- * for await (const event of miosa.openComputers.jobs.stream(host.id, job.id)) {
- *   process.stdout.write(String(event.data ?? ""));
- *   if (event.type === "done") break;
- * }
- *
- * // Expose a port
- * const tunnel = await miosa.openComputers.tunnels.create(host.id, { target_port: 3000 });
- * console.log(tunnel.public_url);
- *
- * // Dispatch an AI agent
- * const session = await miosa.openComputers.agents.dispatch(host.id, {
- *   task: "Run tests and fix failing ones",
- * });
- * ```
- */
-export class OpenComputers {
-  /** Host registration and lifecycle. */
-  readonly hosts: Hosts;
-  /** Command execution on remote hosts. */
-  readonly jobs: Jobs;
-  /** File system access on remote hosts. */
-  readonly files: OcFiles;
-  /** Interactive terminal session tickets. */
-  readonly terminal: Terminal;
-  /** Desktop streaming session tickets. */
-  readonly desktop: Desktop;
-  /** HTTP tunnel management (expose host ports publicly). */
-  readonly tunnels: Tunnels;
-  /** AI agent dispatch and session management. */
-  readonly agents: Agents;
-  /** Multi-host LLM inference clusters. */
-  readonly clusters: Clusters;
-  /** App library — one-click installs on hosts. */
-  readonly apps: Apps;
-  /** Git-backed workspace environments. */
-  readonly workspaces: OcWorkspaces;
-  /** Encrypted per-host / per-tenant secrets. */
-  readonly secrets: Secrets;
-
-  constructor(http: HttpClient) {
-    this.hosts = new Hosts(http);
-    this.jobs = new Jobs(http);
-    this.files = new OcFiles(http);
-    this.terminal = new Terminal(http);
-    this.desktop = new Desktop(http);
-    this.tunnels = new Tunnels(http);
-    this.agents = new Agents(http);
-    this.clusters = new Clusters(http);
-    this.apps = new Apps(http);
-    this.workspaces = new OcWorkspaces(http);
-    this.secrets = new Secrets(http);
-  }
-}

package/src/resources/open-computers/jobs.ts

@@ -1,75 +0,0 @@
-import { HttpClient } from "../../http.js";
-import type {
-  HostId,
-  JobData,
-  JobEvent,
-  JobId,
-  JobListResponse,
-  JobRunParams,
-} from "./types.js";
-
-/**
- * Jobs resource — run commands on a remote OpenComputers host and stream output.
- *
- * ```ts
- * const job = await client.openComputers.jobs.run(hostId, { command: "npm test" });
- * for await (const event of client.openComputers.jobs.stream(hostId, job.id)) {
- *   process.stdout.write(String(event.data ?? ""));
- *   if (event.type === "done") break;
- * }
- * ```
- */
-export class Jobs {
-  private readonly http: HttpClient;
-
-  constructor(http: HttpClient) {
-    this.http = http;
-  }
-
-  private base(hostId: string): string {
-    return `/opencomputers/hosts/${hostId}`;
-  }
-
-  /**
-   * Dispatch a command to run on the remote host.
-   */
-  async run(hostId: HostId | string, params: JobRunParams): Promise<JobData> {
-    return this.http.post<JobData>(`${this.base(hostId)}/exec`, params);
-  }
-
-  /**
-   * List all jobs for a host.
-   */
-  async list(hostId: HostId | string): Promise<JobListResponse> {
-    return this.http.get<JobListResponse>(`${this.base(hostId)}/exec`);
-  }
-
-  /**
-   * Fetch the current state of a job.
-   */
-  async get(hostId: HostId | string, jobId: JobId | string): Promise<JobData> {
-    return this.http.get<JobData>(`${this.base(hostId)}/exec/${jobId}`);
-  }
-
-  /**
-   * Stream live output from a running job.
-   *
-   * Yields `JobEvent` objects with `type` of `stdout`, `stderr`, `exit`, or
-   * `done`. Break the loop when you receive `done` or `exit`.
-   */
-  stream(
-    hostId: HostId | string,
-    jobId: JobId | string,
-  ): AsyncIterableIterator<JobEvent> {
-    return this.http.stream<JobEvent>(
-      `${this.base(hostId)}/exec/${jobId}/stream`,
-    );
-  }
-
-  /**
-   * Cancel a running or queued job.
-   */
-  async cancel(hostId: HostId | string, jobId: JobId | string): Promise<void> {
-    return this.http.delete<void>(`${this.base(hostId)}/exec/${jobId}`);
-  }
-}

package/src/resources/open-computers/open_computers.test.ts

@@ -1,288 +0,0 @@
-import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
-import { HttpClient } from "../../http.js";
-import { OpenComputers } from "./index.js";
-
-// ── Shared mock setup ────────────────────────────────────────────────────────
-
-const mockGet = vi.fn();
-const mockPost = vi.fn();
-const mockPatch = vi.fn();
-const mockDelete = vi.fn();
-const mockStream = vi.fn();
-
-function makeHttp(): HttpClient {
-  const http = {} as HttpClient;
-  http.get = mockGet;
-  http.post = mockPost;
-  http.patch = mockPatch;
-  http.delete = mockDelete;
-  http.stream = mockStream;
-  http.getBinary = vi.fn();
-  http.postFormData = vi.fn();
-  return http;
-}
-
-beforeEach(() => {
-  vi.clearAllMocks();
-});
-
-afterEach(() => {
-  vi.restoreAllMocks();
-});
-
-// ── Hosts ────────────────────────────────────────────────────────────────────
-
-describe("OpenComputers.hosts", () => {
-  const hostData = {
-    id: "host_abc",
-    name: "my-mac",
-    region: null,
-    status: "online",
-    tenant_id: "t_1",
-    labels: {},
-    created_at: "2026-01-01T00:00:00Z",
-    updated_at: "2026-01-01T00:00:00Z",
-  };
-
-  it("list() calls GET /opencomputers/hosts", async () => {
-    mockGet.mockResolvedValue({
-      data: [hostData],
-      meta: { total: 1, page: 1, per_page: 20 },
-    });
-    const oc = new OpenComputers(makeHttp());
-    const result = await oc.hosts.list();
-    expect(mockGet).toHaveBeenCalledWith("/opencomputers/hosts");
-    expect(result.data).toHaveLength(1);
-  });
-
-  it("create() calls POST /opencomputers/hosts with host_key in response", async () => {
-    const created = { ...hostData, host_key: "hk_secret" };
-    mockPost.mockResolvedValue(created);
-    const oc = new OpenComputers(makeHttp());
-    const result = await oc.hosts.create({ name: "my-mac" });
-    expect(mockPost).toHaveBeenCalledWith("/opencomputers/hosts", {
-      name: "my-mac",
-    });
-    expect(result.host_key).toBe("hk_secret");
-  });
-
-  it("get() calls GET /opencomputers/hosts/:id", async () => {
-    mockGet.mockResolvedValue(hostData);
-    const oc = new OpenComputers(makeHttp());
-    await oc.hosts.get("host_abc");
-    expect(mockGet).toHaveBeenCalledWith("/opencomputers/hosts/host_abc");
-  });
-
-  it("update() calls PATCH /opencomputers/hosts/:id", async () => {
-    mockPatch.mockResolvedValue({ ...hostData, name: "renamed" });
-    const oc = new OpenComputers(makeHttp());
-    await oc.hosts.update("host_abc", { name: "renamed" });
-    expect(mockPatch).toHaveBeenCalledWith("/opencomputers/hosts/host_abc", {
-      name: "renamed",
-    });
-  });
-
-  it("revoke() calls DELETE /opencomputers/hosts/:id", async () => {
-    mockDelete.mockResolvedValue(undefined);
-    const oc = new OpenComputers(makeHttp());
-    await oc.hosts.revoke("host_abc");
-    expect(mockDelete).toHaveBeenCalledWith("/opencomputers/hosts/host_abc");
-  });
-
-  it("events() returns an AsyncIterable from stream()", () => {
-    async function* fakeStream() {
-      yield {
-        type: "host_connected",
-        host_id: "host_abc",
-        data: null,
-        timestamp: "t",
-      };
-    }
-    mockStream.mockReturnValue(fakeStream());
-    const oc = new OpenComputers(makeHttp());
-    const iter = oc.hosts.events();
-    expect(mockStream).toHaveBeenCalledWith("/opencomputers/hosts/events");
-    expect(typeof iter[Symbol.asyncIterator]).toBe("function");
-  });
-});
-
-// ── Jobs ─────────────────────────────────────────────────────────────────────
-
-describe("OpenComputers.jobs", () => {
-  const jobData = {
-    id: "job_1",
-    host_id: "host_abc",
-    status: "completed",
-    command: "npm test",
-    args: [],
-    env: [],
-    cwd: null,
-    exit_code: 0,
-    stdout: "ok",
-    stderr: "",
-    created_at: "2026-01-01T00:00:00Z",
-    updated_at: "2026-01-01T00:00:00Z",
-    completed_at: "2026-01-01T00:00:01Z",
-  };
-
-  it("run() calls POST /opencomputers/hosts/:id/exec", async () => {
-    mockPost.mockResolvedValue(jobData);
-    const oc = new OpenComputers(makeHttp());
-    const result = await oc.jobs.run("host_abc", { command: "npm test" });
-    expect(mockPost).toHaveBeenCalledWith(
-      "/opencomputers/hosts/host_abc/exec",
-      { command: "npm test" },
-    );
-    expect(result.id).toBe("job_1");
-  });
-
-  it("list() calls GET /opencomputers/hosts/:id/exec", async () => {
-    mockGet.mockResolvedValue({
-      data: [jobData],
-      meta: { total: 1, page: 1, per_page: 20 },
-    });
-    const oc = new OpenComputers(makeHttp());
-    await oc.jobs.list("host_abc");
-    expect(mockGet).toHaveBeenCalledWith("/opencomputers/hosts/host_abc/exec");
-  });
-
-  it("get() calls GET /opencomputers/hosts/:id/exec/:job_id", async () => {
-    mockGet.mockResolvedValue(jobData);
-    const oc = new OpenComputers(makeHttp());
-    await oc.jobs.get("host_abc", "job_1");
-    expect(mockGet).toHaveBeenCalledWith(
-      "/opencomputers/hosts/host_abc/exec/job_1",
-    );
-  });
-
-  it("stream() returns an AsyncIterable", () => {
-    async function* fakeStream() {
-      yield { type: "stdout", job_id: "job_1", data: "ok\n", timestamp: "t" };
-      yield { type: "done", job_id: "job_1", data: null, timestamp: "t" };
-    }
-    mockStream.mockReturnValue(fakeStream());
-    const oc = new OpenComputers(makeHttp());
-    const iter = oc.jobs.stream("host_abc", "job_1");
-    expect(mockStream).toHaveBeenCalledWith(
-      "/opencomputers/hosts/host_abc/exec/job_1/stream",
-    );
-    expect(typeof iter[Symbol.asyncIterator]).toBe("function");
-  });
-
-  it("cancel() calls DELETE /opencomputers/hosts/:id/exec/:job_id", async () => {
-    mockDelete.mockResolvedValue(undefined);
-    const oc = new OpenComputers(makeHttp());
-    await oc.jobs.cancel("host_abc", "job_1");
-    expect(mockDelete).toHaveBeenCalledWith(
-      "/opencomputers/hosts/host_abc/exec/job_1",
-    );
-  });
-});
-
-// ── Error paths ───────────────────────────────────────────────────────────────
-
-describe("OpenComputers error paths", () => {
-  it("propagates 401 from hosts.list()", async () => {
-    const { AuthError } = await import("../../errors.js");
-    mockGet.mockRejectedValue(new AuthError("Unauthorized", "UNAUTHORIZED"));
-    const oc = new OpenComputers(makeHttp());
-    await expect(oc.hosts.list()).rejects.toBeInstanceOf(AuthError);
-  });
-
-  it("propagates 404 from hosts.get()", async () => {
-    const { NotFoundError } = await import("../../errors.js");
-    mockGet.mockRejectedValue(new NotFoundError("Host not found", "NOT_FOUND"));
-    const oc = new OpenComputers(makeHttp());
-    await expect(oc.hosts.get("nonexistent")).rejects.toBeInstanceOf(
-      NotFoundError,
-    );
-  });
-
-  it("propagates 402 from jobs.run() when credits exhausted", async () => {
-    const { InsufficientCreditsError } = await import("../../errors.js");
-    mockPost.mockRejectedValue(
-      new InsufficientCreditsError(
-        "Insufficient credits",
-        "INSUFFICIENT_CREDITS",
-      ),
-    );
-    const oc = new OpenComputers(makeHttp());
-    await expect(
-      oc.jobs.run("host_abc", { command: "npm test" }),
-    ).rejects.toBeInstanceOf(InsufficientCreditsError);
-  });
-});
-
-// ── Tunnels ───────────────────────────────────────────────────────────────────
-
-describe("OpenComputers.tunnels", () => {
-  const tunnelData = {
-    id: "tun_1",
-    host_id: "host_abc",
-    slug: "abc123",
-    target_port: 3000,
-    auth_mode: "public",
-    public_url: "https://api.miosa.ai/t/abc123",
-    enabled: true,
-    created_at: "2026-01-01T00:00:00Z",
-    updated_at: "2026-01-01T00:00:00Z",
-  };
-
-  it("create() calls POST /opencomputers/hosts/:id/tunnels", async () => {
-    mockPost.mockResolvedValue(tunnelData);
-    const oc = new OpenComputers(makeHttp());
-    const result = await oc.tunnels.create("host_abc", { target_port: 3000 });
-    expect(mockPost).toHaveBeenCalledWith(
-      "/opencomputers/hosts/host_abc/tunnels",
-      { target_port: 3000 },
-    );
-    expect(result.public_url).toContain("abc123");
-  });
-
-  it("delete() calls DELETE /opencomputers/hosts/:id/tunnels/:tid", async () => {
-    mockDelete.mockResolvedValue(undefined);
-    const oc = new OpenComputers(makeHttp());
-    await oc.tunnels.delete("host_abc", "tun_1");
-    expect(mockDelete).toHaveBeenCalledWith(
-      "/opencomputers/hosts/host_abc/tunnels/tun_1",
-    );
-  });
-});
-
-// ── Agents ────────────────────────────────────────────────────────────────────
-
-describe("OpenComputers.agents", () => {
-  const sessionData = {
-    id: "sess_1",
-    host_id: "host_abc",
-    task: "run tests",
-    model_id: null,
-    status: "pending",
-    max_turns: 20,
-    turns_used: 0,
-    created_at: "2026-01-01T00:00:00Z",
-    updated_at: "2026-01-01T00:00:00Z",
-    completed_at: null,
-    error: null,
-  };
-
-  it("dispatch() calls POST /opencomputers/hosts/:id/agent/dispatch", async () => {
-    mockPost.mockResolvedValue(sessionData);
-    const oc = new OpenComputers(makeHttp());
-    const result = await oc.agents.dispatch("host_abc", { task: "run tests" });
-    expect(mockPost).toHaveBeenCalledWith(
-      "/opencomputers/hosts/host_abc/agent/dispatch",
-      { task: "run tests" },
-    );
-    expect(result.id).toBe("sess_1");
-  });
-
-  it("cancel() calls DELETE /opencomputers/hosts/:id/agent/sessions/:id", async () => {
-    mockDelete.mockResolvedValue(undefined);
-    const oc = new OpenComputers(makeHttp());
-    await oc.agents.cancel("host_abc", "sess_1");
-    expect(mockDelete).toHaveBeenCalledWith(
-      "/opencomputers/hosts/host_abc/agent/sessions/sess_1",
-    );
-  });
-});