@miosa/sdk 1.2.4 → 1.2.6

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@miosa/sdk",
-  "version": "1.2.4",
+  "version": "1.2.6",
   "description": "TypeScript SDK for the MIOSA API — cloud VM desktop infrastructure for AI agents",
   "license": "MIT",
   "author": "MIOSA <hello@miosa.ai>",
@@ -29,7 +29,6 @@
   },
   "files": [
     "dist",
-    "src",
     "README.md"
   ],
   "scripts": {

package/src/client.ts

@@ -1,293 +0,0 @@
-import { HttpClient } from "./http.js";
-import { Admin } from "./resources/admin.js";
-import { Analytics } from "./resources/analytics.js";
-import { ApiKeys } from "./resources/api-keys.js";
-import { AuditLog } from "./resources/audit-log.js";
-import { Benchmarks } from "./resources/benchmarks.js";
-import { BuilderSessions } from "./resources/builder-sessions.js";
-import { Channels } from "./resources/channels.js";
-import { CommandCenter } from "./resources/command-center.js";
-import { Community } from "./resources/community.js";
-import { Completions } from "./resources/completions.js";
-import { Computers } from "./resources/computers.js";
-import { Credits } from "./resources/credits.js";
-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 { EgressAudit } from "./resources/egressAudit.js";
-import { EgressNetwork } from "./resources/egressNetwork.js";
-import { EgressSecrets } from "./resources/egressSecrets.js";
-import { Email } from "./resources/email.js";
-import { Embeddings } from "./resources/embeddings.js";
-import { ExternalKeys } from "./resources/external-keys.js";
-import { FlatCustomDomains } from "./resources/flat-custom-domains.js";
-import { Functions } from "./resources/functions.js";
-import { HealthChecks } from "./resources/health-checks.js";
-import { Integrations } from "./resources/integrations.js";
-import { Mcp } from "./resources/mcp.js";
-import { Models } from "./resources/models.js";
-import { OpenComputers } from "./resources/open-computers/index.js";
-import { ProjectAuth } from "./resources/project-auth.js";
-import { ProjectIntegrations } from "./resources/project-integrations.js";
-import { ProviderDefaults } from "./resources/provider-defaults.js";
-import { Regions } from "./resources/regions.js";
-import { Sandboxes } from "./resources/sandboxes.js";
-import { SandboxTemplates } from "./resources/sandbox-templates.js";
-import { Settings } from "./resources/settings.js";
-import { SnapshotsStandalone } from "./resources/snapshots-standalone.js";
-import { Storage } from "./resources/storage.js";
-import { OrgInvites } from "./resources/org-invites.js";
-import { Tenant } from "./resources/tenant.js";
-import { Usage } from "./resources/usage.js";
-import { Volumes } from "./resources/volumes.js";
-import { Webhooks } from "./resources/webhooks.js";
-import { WorkspaceInvites } from "./resources/workspace-invites.js";
-import { WorkspaceMembers } from "./resources/workspace-members.js";
-import type { MiosaClientConfig } from "./types.js";
-
-const DEFAULT_BASE_URL = "https://api.miosa.ai/api/v1";
-const DEFAULT_TIMEOUT = 30_000;
-const DEFAULT_MAX_RETRIES = 3;
-
-/**
- * The top-level MIOSA client.
- *
- * @example
- * ```ts
- * import { Miosa } from '@miosa/sdk';
- *
- * const miosa = new Miosa({ apiKey: 'msk_u_...' });
- *
- * const computer = await miosa.computers.create({ name: 'my-agent' });
- * await computer.start();
- * ```
- */
-export class Miosa {
-  /** Per-workspace user roster — list, add, update role, remove. */
-  readonly workspaceMembers: WorkspaceMembers;
-
-  /**
-   * Workspace invite flow — create invite, list, revoke, preview, accept.
-   * Sending to an email already in the org adds the user directly.
-   */
-  readonly workspaceInvites: WorkspaceInvites;
-
-  /**
-   * Org invite flow — create invite, list, revoke, preview, accept.
-   * Requires admin/owner role for write operations.
-   */
-  readonly orgInvites: OrgInvites;
-
-  /** Current tenant plan, limits, and live usage counters. */
-  readonly tenant: Tenant;
-
-  /** Datacenter regions, compute sizes, pricing, community templates. */
-  readonly regions: Regions;
-
-  /** Tenant settings — workspace config, branding, BYOK provider keys. */
-  readonly settings: Settings;
-
-  /** Aggregated platform dashboard and health overview. */
-  readonly dashboard: Dashboard;
-
-  /** Admin-scoped analytics overview and timeseries metrics. */
-  readonly analytics: Analytics;
-
-  /** Admin-scoped audit log event stream. */
-  readonly auditLog: AuditLog;
-
-  /** Current-period usage summary, sessions, and report queries. */
-  readonly usage: Usage;
-
-  /** Notification channels — Slack, Discord, email, etc. */
-  readonly channels: Channels;
-
-  /** OAuth integrations — GitHub, Slack, Linear, Discord. */
-  readonly integrations: Integrations;
-
-  /** Per-project integrations (Stripe, Resend, Twilio, etc.). */
-  readonly projectIntegrations: ProjectIntegrations;
-
-  /** Built-in auth for generated apps inside sandboxes/deployments. */
-  readonly projectAuth: ProjectAuth;
-
-  /** BYOK encrypted per-user provider keys. */
-  readonly externalKeys: ExternalKeys;
-
-  /** Model Context Protocol — JSON-RPC dispatch + streaming channel. */
-  readonly mcp: Mcp;
-
-  /** Computer management — create, list, get, delete. */
-  readonly computers: Computers;
-
-  /** Sandboxes — native code-execution environments under `/sandboxes`. */
-  readonly sandboxes: Sandboxes;
-
-  /**
-   * 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;
-
-  /** Admin surface (`/api/v1/admin/*`) — requires an admin credential. */
-  readonly admin: Admin;
-
-  /**
-   * OpenComputers — BYOC host management: register your own machines and use
-   * them like cloud computers (jobs, files, tunnels, AI agents, clusters).
-   */
-  readonly openComputers: OpenComputers;
-
-  /** Managed Postgres databases — lifecycle, credentials, logs. */
-  readonly databases: Databases;
-
-  /** Managed object storage — buckets, objects, presigned URLs. */
-  readonly storage: Storage;
-
-  /** Persistent block storage volumes. */
-  readonly volumes: Volumes;
-
-  /** Tenant-scoped custom domains across all resources. */
-  readonly customDomains: FlatCustomDomains;
-
-  /** Serverless edge functions — CRUD and invoke. */
-  readonly functions: Functions;
-
-  /** Scheduled cron jobs — CRUD, pause/resume, execution history. */
-  readonly cronJobs: CronJobs;
-
-  /** Uptime health checks. */
-  readonly healthChecks: HealthChecks;
-
-  /** Outgoing tenant webhooks — CRUD, test, delivery history. */
-  readonly webhooks: Webhooks;
-
-  /** Sandbox templates — CRUD, build-spec schema, builds. */
-  readonly sandboxTemplates: SandboxTemplates;
-
-  /** API key management — list, create, delete. */
-  readonly apiKeys: ApiKeys;
-
-  // ── P3 / P4 resources ──────────────────────────────────────────────────────
-
-  /** Available LLM models via the intelligence gateway. */
-  readonly models: Models;
-
-  /** OpenAI-compatible text + chat completions (supports SSE streaming). */
-  readonly completions: Completions;
-
-  /** OpenAI-compatible embedding vectors. */
-  readonly embeddings: Embeddings;
-
-  /** Admin: fleet-wide + per-tenant LLM provider routing defaults. */
-  readonly providerDefaults: ProviderDefaults;
-
-  /** Admin: trigger + inspect platform benchmark runs. */
-  readonly benchmarks: Benchmarks;
-
-  /** Read-only views of the Optimal AI agent fleet. */
-  readonly commandCenter: CommandCenter;
-
-  /** Community template + agent catalog. */
-  readonly community: Community;
-
-  /** Admin email campaigns, templates, and inbox. */
-  readonly email: Email;
-
-  /** Builder UI session metadata. */
-  readonly builderSessions: BuilderSessions;
-
-  /** Admin: fleet-wide snapshot index. */
-  readonly snapshotsStandalone: SnapshotsStandalone;
-
-  // ── Egress (security) namespaces ───────────────────────────────────────────
-
-  /** Encrypted secret + OAuth credential vault (`/egress/secrets`). */
-  readonly secrets: EgressSecrets;
-
-  /** Egress allowlist + policies — host-level firewall (`/egress/policies`). */
-  readonly network: EgressNetwork;
-
-  /** Egress audit log — every outbound request, paginated query + tail. */
-  readonly audit: EgressAudit;
-
-  private readonly http: HttpClient;
-
-  constructor(config: MiosaClientConfig) {
-    if (!config.apiKey) {
-      throw new Error(
-        'Miosa: apiKey is required. Pass { apiKey: "msk_u_..." } or set MIOSA_API_KEY.',
-      );
-    }
-
-    if (!config.apiKey.startsWith("msk_")) {
-      // Soft warning — allow non-standard keys in tests / self-hosted
-      console.warn(
-        '[miosa] Warning: API key does not start with "msk_". Double-check your key.',
-      );
-    }
-
-    this.http = new HttpClient({
-      baseUrl: config.baseUrl ?? DEFAULT_BASE_URL,
-      apiKey: config.apiKey,
-      timeout: config.timeout ?? DEFAULT_TIMEOUT,
-      maxRetries: config.maxRetries ?? DEFAULT_MAX_RETRIES,
-    });
-
-    this.workspaceMembers = new WorkspaceMembers(this.http);
-    this.workspaceInvites = new WorkspaceInvites(this.http);
-    this.orgInvites = new OrgInvites(this.http);
-    this.tenant = new Tenant(this.http);
-    this.regions = new Regions(this.http);
-    this.settings = new Settings(this.http);
-    this.dashboard = new Dashboard(this.http);
-    this.analytics = new Analytics(this.http);
-    this.auditLog = new AuditLog(this.http);
-    this.usage = new Usage(this.http);
-    this.channels = new Channels(this.http);
-    this.integrations = new Integrations(this.http);
-    this.projectIntegrations = new ProjectIntegrations(this.http);
-    this.projectAuth = new ProjectAuth(this.http);
-    this.externalKeys = new ExternalKeys(this.http);
-    this.mcp = new Mcp(this.http);
-    this.computers = new Computers(this.http);
-    this.sandboxes = new Sandboxes(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);
-    this.databases = new Databases(this.http);
-    this.storage = new Storage(this.http);
-    this.volumes = new Volumes(this.http);
-    this.customDomains = new FlatCustomDomains(this.http);
-    this.functions = new Functions(this.http);
-    this.cronJobs = new CronJobs(this.http);
-    this.healthChecks = new HealthChecks(this.http);
-    this.webhooks = new Webhooks(this.http);
-    this.sandboxTemplates = new SandboxTemplates(this.http);
-    this.apiKeys = new ApiKeys(this.http);
-    this.models = new Models(this.http);
-    this.completions = new Completions(this.http);
-    this.embeddings = new Embeddings(this.http);
-    this.providerDefaults = new ProviderDefaults(this.http);
-    this.benchmarks = new Benchmarks(this.http);
-    this.commandCenter = new CommandCenter(this.http);
-    this.community = new Community(this.http);
-    this.email = new Email(this.http);
-    this.builderSessions = new BuilderSessions(this.http);
-    this.snapshotsStandalone = new SnapshotsStandalone(this.http);
-    // Egress (security) namespaces
-    this.secrets = new EgressSecrets(this.http);
-    this.network = new EgressNetwork(this.http);
-    this.audit = new EgressAudit(this.http);
-  }
-}

package/src/errors.ts

@@ -1,136 +0,0 @@
-export interface MiosaErrorBody {
-  error?: {
-    code?: string;
-    message?: string;
-    details?: unknown;
-  };
-  message?: string;
-  code?: string;
-}
-
-export class MiosaError extends Error {
-  readonly status: number;
-  readonly code: string;
-  readonly details: unknown;
-  readonly requestId: string | undefined;
-
-  constructor(
-    message: string,
-    status: number,
-    code: string,
-    details?: unknown,
-    requestId?: string,
-  ) {
-    super(message);
-    this.name = "MiosaError";
-    this.status = status;
-    this.code = code;
-    this.details = details;
-    this.requestId = requestId;
-  }
-
-  static fromResponse(
-    status: number,
-    body: MiosaErrorBody,
-    requestId?: string,
-  ): MiosaError {
-    const message = body.error?.message ?? body.message ?? `HTTP ${status}`;
-    const code = body.error?.code ?? body.code ?? "UNKNOWN_ERROR";
-    const details = body.error?.details;
-
-    if (status === 401 || status === 403) {
-      return new AuthError(message, status, code, details, requestId);
-    }
-    if (status === 404) {
-      return new NotFoundError(message, code, details, requestId);
-    }
-    if (status === 429) {
-      return new RateLimitError(message, details, requestId);
-    }
-    if (status === 402) {
-      return new InsufficientCreditsError(message, details, requestId);
-    }
-    if (status >= 400 && status < 500) {
-      return new ValidationError(message, status, code, details, requestId);
-    }
-
-    return new MiosaError(message, status, code, details, requestId);
-  }
-}
-
-export class AuthError extends MiosaError {
-  constructor(
-    message: string,
-    status: number = 401,
-    code: string = "UNAUTHORIZED",
-    details?: unknown,
-    requestId?: string,
-  ) {
-    super(message, status, code, details, requestId);
-    this.name = "AuthError";
-  }
-}
-
-export class NotFoundError extends MiosaError {
-  constructor(
-    message: string,
-    code: string = "NOT_FOUND",
-    details?: unknown,
-    requestId?: string,
-  ) {
-    super(message, 404, code, details, requestId);
-    this.name = "NotFoundError";
-  }
-}
-
-export class RateLimitError extends MiosaError {
-  readonly retryAfter: number | undefined;
-
-  constructor(
-    message: string,
-    details?: unknown,
-    requestId?: string,
-    retryAfter?: number,
-  ) {
-    super(message, 429, "RATE_LIMITED", details, requestId);
-    this.name = "RateLimitError";
-    this.retryAfter = retryAfter;
-  }
-}
-
-export class InsufficientCreditsError extends MiosaError {
-  constructor(message: string, details?: unknown, requestId?: string) {
-    super(message, 402, "INSUFFICIENT_CREDITS", details, requestId);
-    this.name = "InsufficientCreditsError";
-  }
-}
-
-export class ValidationError extends MiosaError {
-  constructor(
-    message: string,
-    status: number,
-    code: string = "VALIDATION_ERROR",
-    details?: unknown,
-    requestId?: string,
-  ) {
-    super(message, status, code, details, requestId);
-    this.name = "ValidationError";
-  }
-}
-
-export class TimeoutError extends MiosaError {
-  constructor(message: string = "Request timed out") {
-    super(message, 408, "TIMEOUT");
-    this.name = "TimeoutError";
-  }
-}
-
-export class NetworkError extends MiosaError {
-  readonly cause: Error;
-
-  constructor(message: string, cause: Error) {
-    super(message, 0, "NETWORK_ERROR");
-    this.name = "NetworkError";
-    this.cause = cause;
-  }
-}