@miosa/sdk 1.2.4 → 1.2.6

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

@@ -1,115 +0,0 @@
-import { HttpClient } from "../../http.js";
-import type {
-  HostId,
-  SecretCreateParams,
-  SecretData,
-  SecretId,
-  SecretUpdateParams,
-} from "./types.js";
-
-/**
- * Secrets resource — manage encrypted per-host (and per-tenant) env vars.
- *
- * Secrets are injected into exec sessions and PTY sessions on the host.
- * The value is encrypted at rest; `reveal()` decrypts it for one-time display.
- *
- * ```ts
- * // Tenant-wide secret (shared across all hosts)
- * await client.openComputers.secrets.createForTenant({ name: "OPENAI_KEY", value: "sk-..." });
- *
- * // Host-specific secret
- * const secret = await client.openComputers.secrets.createForHost(hostId, {
- *   name: "DB_PASSWORD", value: "hunter2",
- * });
- * ```
- */
-export class Secrets {
-  private readonly http: HttpClient;
-
-  constructor(http: HttpClient) {
-    this.http = http;
-  }
-
-  // ── Tenant-scoped secrets ────────────────────────────────────────────────────
-
-  /**
-   * List all tenant-scoped secrets.
-   */
-  async listForTenant(): Promise<SecretData[]> {
-    const result = await this.http.get<{ data: SecretData[] }>(
-      "/opencomputers/secrets",
-    );
-    return result.data;
-  }
-
-  /**
-   * Create a tenant-scoped secret (available to all hosts).
-   */
-  async createForTenant(params: SecretCreateParams): Promise<SecretData> {
-    return this.http.post<SecretData>("/opencomputers/secrets", params);
-  }
-
-  // ── Host-scoped secrets ──────────────────────────────────────────────────────
-
-  /**
-   * List secrets scoped to a specific host.
-   */
-  async listForHost(hostId: HostId | string): Promise<SecretData[]> {
-    const result = await this.http.get<{ data: SecretData[] }>(
-      `/opencomputers/hosts/${hostId}/secrets`,
-    );
-    return result.data;
-  }
-
-  /**
-   * Create a secret scoped to a specific host.
-   */
-  async createForHost(
-    hostId: HostId | string,
-    params: SecretCreateParams,
-  ): Promise<SecretData> {
-    return this.http.post<SecretData>(
-      `/opencomputers/hosts/${hostId}/secrets`,
-      params,
-    );
-  }
-
-  /**
-   * Update a host-scoped secret (rotate value or update description).
-   */
-  async updateForHost(
-    hostId: HostId | string,
-    secretId: SecretId | string,
-    params: SecretUpdateParams,
-  ): Promise<SecretData> {
-    return this.http.patch<SecretData>(
-      `/opencomputers/hosts/${hostId}/secrets/${secretId}`,
-      params,
-    );
-  }
-
-  /**
-   * Delete a host-scoped secret.
-   */
-  async deleteForHost(
-    hostId: HostId | string,
-    secretId: SecretId | string,
-  ): Promise<void> {
-    return this.http.delete<void>(
-      `/opencomputers/hosts/${hostId}/secrets/${secretId}`,
-    );
-  }
-
-  /**
-   * Reveal (decrypt and return) the plaintext value of a secret.
-   * Use sparingly — each call is audit-logged.
-   */
-  async reveal(
-    hostId: HostId | string,
-    secretId: SecretId | string,
-  ): Promise<{ value: string }> {
-    return this.http.post<{ value: string }>(
-      `/opencomputers/hosts/${hostId}/secrets/${secretId}/reveal`,
-    );
-  }
-}

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

@@ -1,33 +0,0 @@
-import { HttpClient } from "../../http.js";
-import type { HostId, WsTicket } from "./types.js";
-
-/**
- * Terminal resource — issue WebSocket tickets for interactive PTY sessions on
- * a remote OpenComputers host.
- *
- * The ticket is consumed by a WebSocket upgrade at the URL in `ws_url`. Use
- * xterm.js or any raw WebSocket client to drive the terminal.
- *
- * ```ts
- * const { ws_url } = await client.openComputers.terminal.ticket(hostId);
- * const ws = new WebSocket(ws_url);
- * ```
- */
-export class Terminal {
-  private readonly http: HttpClient;
-
-  constructor(http: HttpClient) {
-    this.http = http;
-  }
-
-  /**
-   * Issue a short-lived WebSocket ticket for a terminal session.
-   *
-   * The ticket expires quickly — open the WebSocket immediately after receiving it.
-   */
-  async ticket(hostId: HostId | string): Promise<WsTicket> {
-    return this.http.post<WsTicket>(
-      `/opencomputers/hosts/${hostId}/terminal/ticket`,
-    );
-  }
-}

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

@@ -1,87 +0,0 @@
-import { HttpClient } from "../../http.js";
-import type {
-  HostId,
-  TunnelCreateParams,
-  TunnelData,
-  TunnelId,
-  TunnelListResponse,
-  TunnelUpdateParams,
-} from "./types.js";
-
-/**
- * Tunnels resource — expose ports on a remote host as publicly reachable URLs.
- *
- * The public proxy is served at `/t/:slug/*path`. The `auth_mode` field on each
- * tunnel controls whether the URL is open to the internet or requires
- * tenant credentials / a password.
- *
- * ```ts
- * const tunnel = await client.openComputers.tunnels.create(hostId, {
- *   target_port: 8080,
- *   auth_mode: "public",
- * });
- * console.log(tunnel.public_url); // https://api.miosa.ai/t/<slug>
- * ```
- */
-export class Tunnels {
-  private readonly http: HttpClient;
-
-  constructor(http: HttpClient) {
-    this.http = http;
-  }
-
-  private base(hostId: string): string {
-    return `/opencomputers/hosts/${hostId}/tunnels`;
-  }
-
-  /**
-   * List all tunnels for a host.
-   */
-  async list(hostId: HostId | string): Promise<TunnelListResponse> {
-    return this.http.get<TunnelListResponse>(this.base(hostId));
-  }
-
-  /**
-   * Create a new tunnel that forwards traffic to `target_port` on the host.
-   */
-  async create(
-    hostId: HostId | string,
-    params: TunnelCreateParams,
-  ): Promise<TunnelData> {
-    return this.http.post<TunnelData>(this.base(hostId), params);
-  }
-
-  /**
-   * Fetch a single tunnel.
-   */
-  async get(
-    hostId: HostId | string,
-    tunnelId: TunnelId | string,
-  ): Promise<TunnelData> {
-    return this.http.get<TunnelData>(`${this.base(hostId)}/${tunnelId}`);
-  }
-
-  /**
-   * Update a tunnel (target port, auth mode, or enabled state).
-   */
-  async update(
-    hostId: HostId | string,
-    tunnelId: TunnelId | string,
-    params: TunnelUpdateParams,
-  ): Promise<TunnelData> {
-    return this.http.patch<TunnelData>(
-      `${this.base(hostId)}/${tunnelId}`,
-      params,
-    );
-  }
-
-  /**
-   * Delete a tunnel. The public URL immediately becomes unreachable.
-   */
-  async delete(
-    hostId: HostId | string,
-    tunnelId: TunnelId | string,
-  ): Promise<void> {
-    return this.http.delete<void>(`${this.base(hostId)}/${tunnelId}`);
-  }
-}

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

@@ -1,343 +0,0 @@
-// ─── OpenComputers shared types ──────────────────────────────────────────────
-
-export type HostId = string & { readonly __brand: "HostId" };
-export type JobId = string & { readonly __brand: "JobId" };
-export type TunnelId = string & { readonly __brand: "TunnelId" };
-export type ClusterId = string & { readonly __brand: "ClusterId" };
-export type WorkspaceId = string & { readonly __brand: "WorkspaceId" };
-export type SecretId = string & { readonly __brand: "SecretId" };
-
-// ─── Hosts ───────────────────────────────────────────────────────────────────
-
-export type HostStatus = "pending" | "online" | "offline" | "error" | "revoked";
-
-export interface HostData {
-  id: HostId;
-  name: string;
-  region: string | null;
-  status: HostStatus;
-  tenant_id: string;
-  labels: Record<string, string>;
-  /** Present only on create response — treat as write-once. */
-  host_key?: string;
-  created_at: string;
-  updated_at: string;
-}
-
-export interface HostCreateParams {
-  name: string;
-  region?: string;
-  labels?: Record<string, string>;
-}
-
-export interface HostUpdateParams {
-  name?: string;
-  labels?: Record<string, string>;
-}
-
-export interface HostListResponse {
-  data: HostData[];
-  meta: { total: number; page: number; per_page: number };
-}
-
-export interface HostEvent {
-  type: "host_connected" | "host_disconnected" | "host_error" | string;
-  host_id: HostId;
-  data: unknown;
-  timestamp: string;
-}
-
-// ─── Jobs (exec on host) ─────────────────────────────────────────────────────
-
-export type JobStatus =
-  | "queued"
-  | "running"
-  | "completed"
-  | "failed"
-  | "cancelled";
-
-export interface JobData {
-  id: JobId;
-  host_id: HostId;
-  status: JobStatus;
-  command: string;
-  args: string[];
-  env: string[];
-  cwd: string | null;
-  exit_code: number | null;
-  stdout: string | null;
-  stderr: string | null;
-  created_at: string;
-  updated_at: string;
-  completed_at: string | null;
-}
-
-export interface JobRunParams {
-  command: string;
-  args?: string[];
-  env?: string[];
-  cwd?: string;
-  timeout?: number;
-}
-
-export interface JobListResponse {
-  data: JobData[];
-  meta: { total: number; page: number; per_page: number };
-}
-
-export type JobEventType =
-  | "stdout"
-  | "stderr"
-  | "exit"
-  | "error"
-  | "started"
-  | "done";
-
-export interface JobEvent {
-  type: JobEventType;
-  job_id: JobId;
-  data: string | number | null;
-  timestamp: string;
-}
-
-// ─── File system ─────────────────────────────────────────────────────────────
-
-export interface FsEntry {
-  name: string;
-  path: string;
-  size: number;
-  is_dir: boolean;
-  modified_at: string;
-}
-
-export interface FsStat {
-  path: string;
-  size: number;
-  mode: number;
-  is_dir: boolean;
-  is_symlink: boolean;
-  symlink_target?: string;
-  modified_at: string;
-}
-
-export interface FsListResponse {
-  entries: FsEntry[];
-  path: string;
-}
-
-// ─── Terminal / Desktop tickets ───────────────────────────────────────────────
-
-export interface WsTicket {
-  /** Short-lived JWT for WS authentication. */
-  ticket: string;
-  /** Fully-qualified WS URL to connect to. */
-  ws_url: string;
-  expires_at: string;
-}
-
-// ─── Tunnels ─────────────────────────────────────────────────────────────────
-
-export type TunnelAuthMode = "public" | "tenant_only" | "password";
-
-export interface TunnelData {
-  id: TunnelId;
-  host_id: HostId;
-  slug: string;
-  target_port: number;
-  auth_mode: TunnelAuthMode;
-  public_url: string;
-  enabled: boolean;
-  created_at: string;
-  updated_at: string;
-}
-
-export interface TunnelCreateParams {
-  target_port: number;
-  auth_mode?: TunnelAuthMode;
-  slug?: string;
-}
-
-export interface TunnelUpdateParams {
-  target_port?: number;
-  auth_mode?: TunnelAuthMode;
-  enabled?: boolean;
-}
-
-export interface TunnelListResponse {
-  data: TunnelData[];
-}
-
-// ─── Agents ──────────────────────────────────────────────────────────────────
-
-export type AgentSessionStatus =
-  | "pending"
-  | "running"
-  | "completed"
-  | "failed"
-  | "cancelled";
-
-export interface OcAgentSessionData {
-  id: string;
-  host_id: HostId;
-  task: string;
-  model_id: string | null;
-  status: AgentSessionStatus;
-  max_turns: number;
-  turns_used: number;
-  created_at: string;
-  updated_at: string;
-  completed_at: string | null;
-  error: string | null;
-}
-
-export interface AgentDispatchParams {
-  task: string;
-  model_id?: string;
-  max_turns?: number;
-  context?: Record<string, unknown>;
-}
-
-export interface AgentSessionListResponse {
-  data: OcAgentSessionData[];
-}
-
-export interface AgentEvent {
-  type: string;
-  session_id: string;
-  data: unknown;
-  timestamp: string;
-}
-
-// ─── Inference Clusters ───────────────────────────────────────────────────────
-
-export type ClusterStatus =
-  | "provisioning"
-  | "active"
-  | "stopped"
-  | "error"
-  | "destroyed";
-
-export interface ClusterData {
-  id: ClusterId;
-  name: string;
-  model: string;
-  slug: string;
-  status: ClusterStatus;
-  host_ids: HostId[];
-  /** OpenAI-compatible endpoint: POST /inference/{slug}/v1/chat/completions */
-  inference_url: string;
-  created_at: string;
-  updated_at: string;
-}
-
-export interface ClusterCreateParams {
-  name: string;
-  model: string;
-  host_ids: string[];
-}
-
-export interface ClusterListResponse {
-  data: ClusterData[];
-}
-
-export interface ClusterEvent {
-  type: string;
-  cluster_id: ClusterId;
-  data: unknown;
-  timestamp: string;
-}
-
-// ─── Apps ────────────────────────────────────────────────────────────────────
-
-export interface AppCatalogEntry {
-  id: string;
-  name: string;
-  description: string;
-  category: string;
-  version: string;
-  icon_url: string | null;
-}
-
-export interface AppInstallData {
-  id: string;
-  host_id: HostId;
-  app_id: string;
-  status: "pending" | "installing" | "installed" | "failed" | "uninstalled";
-  error: string | null;
-  created_at: string;
-  updated_at: string;
-}
-
-export interface AppInstallEvent {
-  type: string;
-  install_id: string;
-  data: unknown;
-  timestamp: string;
-}
-
-// ─── Workspaces ───────────────────────────────────────────────────────────────
-
-export type OcWorkspaceStatus =
-  | "creating"
-  | "ready"
-  | "running"
-  | "stopped"
-  | "error";
-
-export interface OcWorkspaceData {
-  id: WorkspaceId;
-  host_id: HostId;
-  name: string;
-  repo_url: string | null;
-  branch: string | null;
-  status: OcWorkspaceStatus;
-  directory: string;
-  created_at: string;
-  updated_at: string;
-}
-
-export interface OcWorkspaceCreateParams {
-  name: string;
-  repo_url?: string;
-  branch?: string;
-  directory?: string;
-}
-
-export interface OcWorkspaceUpdateParams {
-  name?: string;
-  branch?: string;
-}
-
-export interface OcWorkspaceListResponse {
-  data: OcWorkspaceData[];
-}
-
-export interface OcWorkspaceEvent {
-  type: string;
-  workspace_id: WorkspaceId;
-  data: unknown;
-  timestamp: string;
-}
-
-// ─── Secrets ─────────────────────────────────────────────────────────────────
-
-export interface SecretData {
-  id: SecretId;
-  name: string;
-  description: string | null;
-  host_id: HostId | null;
-  tenant_id: string;
-  created_at: string;
-  updated_at: string;
-}
-
-export interface SecretCreateParams {
-  name: string;
-  value: string;
-  description?: string;
-}
-
-export interface SecretUpdateParams {
-  value?: string;
-  description?: string;
-}

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

@@ -1,135 +0,0 @@
-import { HttpClient } from "../../http.js";
-import type {
-  HostId,
-  OcWorkspaceCreateParams,
-  OcWorkspaceData,
-  OcWorkspaceEvent,
-  OcWorkspaceListResponse,
-  OcWorkspaceUpdateParams,
-  WorkspaceId,
-  WsTicket,
-} from "./types.js";
-
-/**
- * Workspaces resource — git-backed development environments on a remote host.
- *
- * A workspace clones a repository, installs dependencies, and gives you a
- * ready-to-use terminal scoped to the project root.
- *
- * ```ts
- * const ws = await client.openComputers.workspaces.create(hostId, {
- *   name: "my-project",
- *   repo_url: "https://github.com/acme/backend",
- *   branch: "main",
- * });
- * const { ws_url } = await client.openComputers.workspaces.openTerminal(hostId, ws.id);
- * ```
- */
-export class OcWorkspaces {
-  private readonly http: HttpClient;
-
-  constructor(http: HttpClient) {
-    this.http = http;
-  }
-
-  private base(hostId: string): string {
-    return `/opencomputers/hosts/${hostId}/workspaces`;
-  }
-
-  /**
-   * List all workspaces across all hosts for the tenant.
-   */
-  async listAll(): Promise<OcWorkspaceListResponse> {
-    return this.http.get<OcWorkspaceListResponse>("/opencomputers/workspaces");
-  }
-
-  /**
-   * List workspaces on a specific host.
-   */
-  async list(hostId: HostId | string): Promise<OcWorkspaceListResponse> {
-    return this.http.get<OcWorkspaceListResponse>(this.base(hostId));
-  }
-
-  /**
-   * Create a new workspace on a host.
-   */
-  async create(
-    hostId: HostId | string,
-    params: OcWorkspaceCreateParams,
-  ): Promise<OcWorkspaceData> {
-    return this.http.post<OcWorkspaceData>(this.base(hostId), params);
-  }
-
-  /**
-   * Fetch a single workspace.
-   */
-  async get(
-    hostId: HostId | string,
-    workspaceId: WorkspaceId | string,
-  ): Promise<OcWorkspaceData> {
-    return this.http.get<OcWorkspaceData>(
-      `${this.base(hostId)}/${workspaceId}`,
-    );
-  }
-
-  /**
-   * Update workspace metadata (name, branch).
-   */
-  async update(
-    hostId: HostId | string,
-    workspaceId: WorkspaceId | string,
-    params: OcWorkspaceUpdateParams,
-  ): Promise<OcWorkspaceData> {
-    return this.http.patch<OcWorkspaceData>(
-      `${this.base(hostId)}/${workspaceId}`,
-      params,
-    );
-  }
-
-  /**
-   * Delete a workspace.
-   */
-  async delete(
-    hostId: HostId | string,
-    workspaceId: WorkspaceId | string,
-  ): Promise<void> {
-    return this.http.delete<void>(`${this.base(hostId)}/${workspaceId}`);
-  }
-
-  /**
-   * Pull the latest changes from the remote repository.
-   */
-  async pull(
-    hostId: HostId | string,
-    workspaceId: WorkspaceId | string,
-  ): Promise<OcWorkspaceData> {
-    return this.http.post<OcWorkspaceData>(
-      `${this.base(hostId)}/${workspaceId}/pull`,
-    );
-  }
-
-  /**
-   * Open a terminal session scoped to the workspace root directory.
-   * Returns a short-lived WebSocket ticket.
-   */
-  async openTerminal(
-    hostId: HostId | string,
-    workspaceId: WorkspaceId | string,
-  ): Promise<WsTicket> {
-    return this.http.post<WsTicket>(
-      `${this.base(hostId)}/${workspaceId}/open-terminal`,
-    );
-  }
-
-  /**
-   * Stream workspace setup / clone / install events.
-   */
-  events(
-    hostId: HostId | string,
-    workspaceId: WorkspaceId | string,
-  ): AsyncIterableIterator<OcWorkspaceEvent> {
-    return this.http.stream<OcWorkspaceEvent>(
-      `${this.base(hostId)}/${workspaceId}/events`,
-    );
-  }
-}