@miosa/sdk 0.3.0

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

@@ -0,0 +1,343 @@
+// ─── 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

@@ -0,0 +1,135 @@
+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`,
+    );
+  }
+}

package/src/resources/project-auth.ts

@@ -0,0 +1,142 @@
+/**
+ * Project auth — built-in auth for sandboxes and deployments.
+ */
+
+import type { HttpClient } from "../http.js";
+
+// ── Resource shapes ──────────────────────────────────────────────────────────
+
+export interface ProjectAuthStatus {
+  enabled?: boolean;
+  state?: string;
+  database_id?: string | null;
+  config?: Record<string, unknown>;
+  [key: string]: unknown;
+}
+
+// ── Request payloads ─────────────────────────────────────────────────────────
+
+export type ProjectAuthResourceType = "sandbox" | "deployment";
+
+export interface ProjectAuthResourceParams {
+  resourceType?: ProjectAuthResourceType;
+  resource_type?: ProjectAuthResourceType;
+  resourceId?: string;
+  resource_id?: string;
+}
+
+export interface ProjectAuthEnableParams extends ProjectAuthResourceParams {
+  signupEnabled?: boolean;
+  signup_enabled?: boolean;
+  emailConfirmRequired?: boolean;
+  email_confirm_required?: boolean;
+  tokenExpirySec?: number;
+  token_expiry_sec?: number;
+  config?: Record<string, unknown>;
+  [key: string]: unknown;
+}
+
+export interface ProjectAuthUpdateParams extends ProjectAuthEnableParams {}
+
+export interface ProjectAuthDisableParams extends ProjectAuthResourceParams {
+  [key: string]: unknown;
+}
+
+export interface ProjectAuthStatusParams extends ProjectAuthResourceParams {
+  [key: string]: unknown;
+}
+
+function resourcePayload(params: ProjectAuthResourceParams): {
+  resource_type: ProjectAuthResourceType;
+  resource_id: string;
+} {
+  const resource_type = params.resource_type ?? params.resourceType;
+  const resource_id = params.resource_id ?? params.resourceId;
+
+  if (!resource_type || !resource_id) {
+    throw new Error("project auth requires resourceType/resourceId");
+  }
+
+  return { resource_type, resource_id };
+}
+
+function authConfig(params: ProjectAuthEnableParams): Record<string, unknown> {
+  return stripUndefined({
+    ...(params.config ?? {}),
+    signup_enabled: params.signup_enabled ?? params.signupEnabled,
+    email_confirm_required:
+      params.email_confirm_required ?? params.emailConfirmRequired,
+    token_expiry_sec: params.token_expiry_sec ?? params.tokenExpirySec,
+  });
+}
+
+function requestBody(params: ProjectAuthEnableParams): Record<string, unknown> {
+  return stripUndefined({
+    ...resourcePayload(params),
+    config: authConfig(params),
+  });
+}
+
+export interface ProjectAuthLegacyParams {
+  provider?: string;
+  config?: Record<string, unknown>;
+  [key: string]: unknown;
+}
+
+// ── Helpers ───────────────────────────────────────────────────────────────────
+
+function unwrap<T>(payload: unknown): T {
+  if (payload && typeof payload === "object") {
+    const p = payload as Record<string, unknown>;
+    for (const k of ["data", "project_auth", "config", "items"]) {
+      if (k in p) return p[k] as T;
+    }
+  }
+  return payload as T;
+}
+
+function stripUndefined(
+  input: Record<string, unknown>,
+): Record<string, unknown> {
+  return Object.fromEntries(
+    Object.entries(input).filter(([, v]) => v !== undefined),
+  );
+}
+
+// ── Main resource ─────────────────────────────────────────────────────────────
+
+export class ProjectAuth {
+  constructor(private readonly http: HttpClient) {}
+
+  /** Get the current project-auth status and config. */
+  async status(params: ProjectAuthStatusParams): Promise<ProjectAuthStatus> {
+    const data = await this.http.get<unknown>(
+      "/project-auth/status",
+      resourcePayload(params),
+    );
+    return unwrap<ProjectAuthStatus>(data);
+  }
+
+  /** Enable project auth. */
+  async enable(params: ProjectAuthEnableParams): Promise<ProjectAuthStatus> {
+    const body = requestBody(params);
+    const data = await this.http.post<unknown>("/project-auth/enable", body);
+    return unwrap<ProjectAuthStatus>(data);
+  }
+
+  /** Disable project auth. */
+  async disable(params: ProjectAuthDisableParams): Promise<ProjectAuthStatus> {
+    const data = await this.http.post<unknown>(
+      "/project-auth/disable",
+      resourcePayload(params),
+    );
+    return unwrap<ProjectAuthStatus>(data);
+  }
+
+  /** Update project-auth configuration. */
+  async update(params: ProjectAuthUpdateParams): Promise<ProjectAuthStatus> {
+    const body = requestBody(params);
+    const data = await this.http.patch<unknown>("/project-auth/config", body);
+    return unwrap<ProjectAuthStatus>(data);
+  }
+}