@miosa/sdk 1.2.4 → 1.2.6

package/src/resources/provider-defaults.ts

@@ -1,89 +0,0 @@
-/**
- * ProviderDefaults — admin LLM provider routing config.
- *
- * Routes:
- *   GET  /admin/provider-defaults
- *   PUT  /admin/provider-defaults
- *   GET  /admin/tenants/:id/provider-config
- *   PUT  /admin/tenants/:id/provider-config
- *   DELETE /admin/tenants/:id/provider-config
- *
- * Requires admin credential (msk_a_* / msk_p_* or admin JWT).
- */
-
-import type { HttpClient } from "../http.js";
-
-function unwrap(data: unknown): Record<string, unknown> {
-  if (data && typeof data === "object") {
-    const d = data as Record<string, unknown>;
-    for (const k of ["data", "defaults", "provider_defaults", "config"]) {
-      if (k in d) return d[k] as Record<string, unknown>;
-    }
-  }
-  return data as Record<string, unknown>;
-}
-
-export class ProviderDefaults {
-  constructor(private readonly http: HttpClient) {}
-
-  /** Get the current fleet-wide provider defaults. */
-  async list(): Promise<Record<string, unknown>> {
-    return unwrap(await this.http.get<unknown>("/admin/provider-defaults"));
-  }
-
-  /** Return the defaults entry for a single provider, or {} if missing. */
-  async get(provider: string): Promise<Record<string, unknown>> {
-    const data = await this.list();
-    const providers =
-      (data.providers as Record<string, unknown> | undefined) ?? data;
-    if (
-      typeof providers === "object" &&
-      providers !== null &&
-      provider in providers
-    ) {
-      return providers[provider] as Record<string, unknown>;
-    }
-    return {};
-  }
-
-  /** Replace the fleet-wide defaults (PUT /admin/provider-defaults). */
-  async update(
-    opts: Record<string, unknown>,
-  ): Promise<Record<string, unknown>> {
-    const body = Object.fromEntries(
-      Object.entries(opts).filter(([, v]) => v !== undefined),
-    );
-    return unwrap(
-      await this.http.put<unknown>("/admin/provider-defaults", body),
-    );
-  }
-
-  // ── Per-tenant overrides ────────────────────────────────────────────────
-
-  async getTenant(tenantId: string): Promise<Record<string, unknown>> {
-    return unwrap(
-      await this.http.get<unknown>(
-        `/admin/tenants/${tenantId}/provider-config`,
-      ),
-    );
-  }
-
-  async setTenant(
-    tenantId: string,
-    opts: Record<string, unknown>,
-  ): Promise<Record<string, unknown>> {
-    const body = Object.fromEntries(
-      Object.entries(opts).filter(([, v]) => v !== undefined),
-    );
-    return unwrap(
-      await this.http.put<unknown>(
-        `/admin/tenants/${tenantId}/provider-config`,
-        body,
-      ),
-    );
-  }
-
-  async resetTenant(tenantId: string): Promise<void> {
-    await this.http.delete(`/admin/tenants/${tenantId}/provider-config`);
-  }
-}

package/src/resources/quotas.ts

@@ -1,77 +0,0 @@
-/**
- * Quotas — per-external_user_id resource limits.
- * Corresponds to: GET/PUT/DELETE /api/v1/quotas/external/{external_user_id}
- */
-
-import type { HttpClient } from "../http.js";
-
-// ── Resource shapes ──────────────────────────────────────────────────────────
-
-export interface QuotaData {
-  external_user_id: string;
-  max_sandboxes?: number | null;
-  max_concurrent?: number | null;
-  max_storage_gb?: number | null;
-  max_credit_cents?: number | null;
-  usage?: {
-    sandbox_count?: number;
-    concurrent_count?: number;
-    storage_gb?: number;
-    credit_cents?: number;
-    [key: string]: unknown;
-  };
-  [key: string]: unknown;
-}
-
-export interface QuotaSetParams {
-  max_sandboxes?: number;
-  max_concurrent?: number;
-  max_storage_gb?: number;
-  max_credit_cents?: number;
-}
-
-// ── Helpers ───────────────────────────────────────────────────────────────────
-
-function unwrap<T>(payload: unknown): T {
-  if (payload && typeof payload === "object" && "data" in (payload as object)) {
-    return (payload as { data: T }).data;
-  }
-  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 Quotas {
-  constructor(private readonly http: HttpClient) {}
-
-  /** GET /api/v1/quotas/external/{external_user_id} — current limits + usage. */
-  async get(externalUserId: string): Promise<QuotaData> {
-    return unwrap(
-      await this.http.get<unknown>(`/quotas/external/${externalUserId}`),
-    );
-  }
-
-  /** PUT /api/v1/quotas/external/{external_user_id} — set per-user limits. */
-  async set(
-    externalUserId: string,
-    params: QuotaSetParams,
-  ): Promise<QuotaData> {
-    const body = stripUndefined(params as Record<string, unknown>);
-    return unwrap(
-      await this.http.put<unknown>(`/quotas/external/${externalUserId}`, body),
-    );
-  }
-
-  /** DELETE /api/v1/quotas/external/{external_user_id} — revert to tenant default. */
-  async delete(externalUserId: string): Promise<void> {
-    await this.http.delete<unknown>(`/quotas/external/${externalUserId}`);
-  }
-}

package/src/resources/regions.ts

@@ -1,94 +0,0 @@
-/**
- * Regions — datacenter availability, sizes, pricing, templates.
- */
-
-import type { HttpClient } from "../http.js";
-
-// ── Resource shapes ──────────────────────────────────────────────────────────
-
-export interface RegionData {
-  id?: string;
-  name?: string;
-  slug?: string;
-  available?: boolean;
-  [key: string]: unknown;
-}
-
-export interface SizeData {
-  id?: string;
-  name?: string;
-  slug?: string;
-  cpu?: number;
-  memory_mb?: number;
-  [key: string]: unknown;
-}
-
-export interface TemplateData {
-  id?: string;
-  name?: string;
-  slug?: string;
-  [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",
-      "regions",
-      "sizes",
-      "pricing",
-      "templates",
-      "items",
-    ]) {
-      if (k in p) return p[k] as T;
-    }
-  }
-  return payload as T;
-}
-
-function listItems<T>(payload: unknown): T[] {
-  const result = unwrap<T[] | unknown>(payload);
-  if (Array.isArray(result)) return result;
-  return [];
-}
-
-// ── Main resource ─────────────────────────────────────────────────────────────
-
-export class Regions {
-  constructor(private readonly http: HttpClient) {}
-
-  /** List datacenter regions. */
-  async listRegions(): Promise<RegionData[]> {
-    const data = await this.http.get<unknown>("/compute/regions");
-    return listItems<RegionData>(data);
-  }
-
-  /** List available compute sizes. */
-  async listSizes(): Promise<SizeData[]> {
-    const data = await this.http.get<unknown>("/compute/sizes");
-    return listItems<SizeData>(data);
-  }
-
-  /** Get static compute pricing data. */
-  async pricing(): Promise<unknown> {
-    const data = await this.http.get<unknown>("/compute/pricing");
-    return unwrap(data);
-  }
-
-  /** List community computer templates. */
-  async listTemplates(): Promise<TemplateData[]> {
-    const data = await this.http.get<unknown>("/compute/templates");
-    return listItems<TemplateData>(data);
-  }
-
-  /** Get a single community template by id. */
-  async getTemplate(templateId: string): Promise<TemplateData> {
-    const data = await this.http.get<unknown>(
-      `/compute/templates/${templateId}`,
-    );
-    return unwrap<TemplateData>(data);
-  }
-}

package/src/resources/sandbox-processes.ts

@@ -1,112 +0,0 @@
-/**
- * SandboxProcesses — long-running process management inside a sandbox.
- * Corresponds to: POST/GET/DELETE /api/v1/sandboxes/{id}/processes
- */
-
-import type { HttpClient } from "../http.js";
-
-// ── Resource shapes ──────────────────────────────────────────────────────────
-
-export interface SandboxProcessData {
-  pid: number;
-  name?: string;
-  command: string;
-  status: "running" | "stopped" | "failed" | string;
-  started_at?: string;
-  exit_code?: number | null;
-  [key: string]: unknown;
-}
-
-export interface SandboxProcessStartParams {
-  command: string;
-  env?: Record<string, string>;
-  name?: string;
-}
-
-export interface SandboxProcessStreamEvent {
-  stream: "stdout" | "stderr";
-  line: string;
-}
-
-// ── Helpers ───────────────────────────────────────────────────────────────────
-
-function unwrap<T>(payload: unknown): T {
-  if (payload && typeof payload === "object" && "data" in (payload as object)) {
-    return (payload as { data: T }).data;
-  }
-  return payload as T;
-}
-
-function listItems<T>(payload: unknown): T[] {
-  if (Array.isArray(payload)) return payload;
-  if (!payload || typeof payload !== "object") return [];
-  const p = payload as Record<string, unknown>;
-  for (const k of ["data", "processes", "items"]) {
-    if (Array.isArray(p[k])) return p[k] as T[];
-  }
-  return [];
-}
-
-function stripUndefined(
-  input: Record<string, unknown>,
-): Record<string, unknown> {
-  return Object.fromEntries(
-    Object.entries(input).filter(([, v]) => v !== undefined),
-  );
-}
-
-// ── Main resource ─────────────────────────────────────────────────────────────
-
-export class SandboxProcesses {
-  constructor(
-    private readonly http: HttpClient,
-    private readonly sandboxId: string,
-  ) {}
-
-  private base(): string {
-    return `/sandboxes/${this.sandboxId}/processes`;
-  }
-
-  /** POST /api/v1/sandboxes/{id}/processes — start a long-running process. */
-  async start(params: SandboxProcessStartParams): Promise<SandboxProcessData> {
-    const body = stripUndefined({
-      command: params.command,
-      env: params.env,
-      name: params.name,
-    });
-    return unwrap(await this.http.post<unknown>(this.base(), body));
-  }
-
-  /** GET /api/v1/sandboxes/{id}/processes — list all processes. */
-  async list(): Promise<SandboxProcessData[]> {
-    const data = await this.http.get<unknown>(this.base());
-    return listItems<SandboxProcessData>(data);
-  }
-
-  /** GET /api/v1/sandboxes/{id}/processes/{pid} — get a single process. */
-  async get(pid: number): Promise<SandboxProcessData> {
-    return unwrap(await this.http.get<unknown>(`${this.base()}/${pid}`));
-  }
-
-  /** DELETE /api/v1/sandboxes/{id}/processes/{pid} — SIGTERM then SIGKILL after 5s. */
-  async stop(pid: number): Promise<void> {
-    await this.http.delete<unknown>(`${this.base()}/${pid}`);
-  }
-
-  /** GET /api/v1/sandboxes/{id}/processes/{pid}/logs?tail=N — tail log text. */
-  async logs(pid: number, tail = 200): Promise<string> {
-    const data = await this.http.get<unknown>(`${this.base()}/${pid}/logs`, {
-      tail,
-    });
-    if (typeof data === "string") return data;
-    const d = data as Record<string, unknown>;
-    return String(d.logs ?? d.output ?? d.data ?? "");
-  }
-
-  /** GET /api/v1/sandboxes/{id}/processes/{pid}/stream (SSE) — live output. */
-  stream(pid: number): AsyncIterableIterator<SandboxProcessStreamEvent> {
-    return this.http.stream<SandboxProcessStreamEvent>(
-      `${this.base()}/${pid}/stream`,
-    );
-  }
-}

package/src/resources/sandbox-shares.ts

@@ -1,83 +0,0 @@
-/**
- * SandboxShares — public read-only share URLs for a sandbox.
- * Corresponds to: POST/GET/DELETE /api/v1/sandboxes/{id}/shares
- */
-
-import type { HttpClient } from "../http.js";
-
-// ── Resource shapes ──────────────────────────────────────────────────────────
-
-export interface SandboxShareData {
-  share_id: string;
-  share_url: string;
-  expires_at?: string | null;
-  scope: string;
-  [key: string]: unknown;
-}
-
-export interface SandboxShareCreateParams {
-  expires_in?: number;
-  scope?: "read";
-}
-
-// ── Helpers ───────────────────────────────────────────────────────────────────
-
-function unwrap<T>(payload: unknown): T {
-  if (payload && typeof payload === "object" && "data" in (payload as object)) {
-    return (payload as { data: T }).data;
-  }
-  return payload as T;
-}
-
-function listItems<T>(payload: unknown): T[] {
-  if (Array.isArray(payload)) return payload;
-  if (!payload || typeof payload !== "object") return [];
-  const p = payload as Record<string, unknown>;
-  for (const k of ["data", "shares", "items"]) {
-    if (Array.isArray(p[k])) return p[k] as T[];
-  }
-  return [];
-}
-
-function stripUndefined(
-  input: Record<string, unknown>,
-): Record<string, unknown> {
-  return Object.fromEntries(
-    Object.entries(input).filter(([, v]) => v !== undefined),
-  );
-}
-
-// ── Main resource ─────────────────────────────────────────────────────────────
-
-export class SandboxShares {
-  constructor(
-    private readonly http: HttpClient,
-    private readonly sandboxId: string,
-  ) {}
-
-  private base(): string {
-    return `/sandboxes/${this.sandboxId}/shares`;
-  }
-
-  /** POST /api/v1/sandboxes/{id}/shares — create a public share URL. */
-  async create(
-    params: SandboxShareCreateParams = {},
-  ): Promise<SandboxShareData> {
-    const body = stripUndefined({
-      expires_in: params.expires_in,
-      scope: params.scope ?? "read",
-    });
-    return unwrap(await this.http.post<unknown>(this.base(), body));
-  }
-
-  /** GET /api/v1/sandboxes/{id}/shares — list all active shares. */
-  async list(): Promise<SandboxShareData[]> {
-    const data = await this.http.get<unknown>(this.base());
-    return listItems<SandboxShareData>(data);
-  }
-
-  /** DELETE /api/v1/sandboxes/{id}/shares/{share_id} — revoke a share. */
-  async revoke(shareId: string): Promise<void> {
-    await this.http.delete<unknown>(`${this.base()}/${shareId}`);
-  }
-}

package/src/resources/sandbox-templates.ts

@@ -1,195 +0,0 @@
-/**
- * SandboxTemplates resource — tenant sandbox template management.
- */
-
-import { randomUUID } from "node:crypto";
-
-import type { HttpClient } from "../http.js";
-
-// ── Branded IDs ──────────────────────────────────────────────────────────────
-
-export type SandboxTemplateResourceId = string & {
-  readonly __brand: "SandboxTemplateResourceId";
-};
-export type SandboxTemplateBuildResourceId = string & {
-  readonly __brand: "SandboxTemplateBuildResourceId";
-};
-
-// ── Resource shapes ──────────────────────────────────────────────────────────
-
-export interface SandboxTemplateResourceData {
-  id: SandboxTemplateResourceId;
-  tenant_id: string;
-  name: string;
-  state?: string;
-  build_spec?: Record<string, unknown>;
-  aliases?: string[];
-  created_at?: string;
-  updated_at?: string;
-  [key: string]: unknown;
-}
-
-export interface SandboxTemplateBuildResourceData {
-  id: SandboxTemplateBuildResourceId;
-  template_id: SandboxTemplateResourceId;
-  state?: string;
-  started_at?: string | null;
-  finished_at?: string | null;
-  error?: string | null;
-  created_at?: string;
-  [key: string]: unknown;
-}
-
-// ── Request payloads ─────────────────────────────────────────────────────────
-
-export interface SandboxTemplateListParams {
-  include_aliases?: boolean;
-  includeAliases?: boolean;
-}
-
-export interface TemplateCreateParams {
-  name: string;
-  build_spec: Record<string, unknown>;
-  buildSpec?: Record<string, unknown>;
-  idempotencyKey?: string;
-  [key: string]: unknown;
-}
-
-export interface TemplateBuildCreateParams {
-  idempotencyKey?: string;
-  [key: string]: unknown;
-}
-
-// ── Helpers ───────────────────────────────────────────────────────────────────
-
-function unwrap<T>(payload: unknown): T {
-  if (payload && typeof payload === "object" && "data" in (payload as object)) {
-    return (payload as { data: T }).data;
-  }
-  return payload as T;
-}
-
-function listItems<T>(
-  payload: unknown,
-  candidateKeys: string[] = ["data", "templates", "builds", "items"],
-): T[] {
-  if (Array.isArray(payload)) return payload;
-  if (!payload || typeof payload !== "object") return [];
-  const p = payload as Record<string, unknown>;
-  if (Array.isArray(p.data)) return p.data as T[];
-  for (const key of candidateKeys) {
-    if (Array.isArray(p[key])) return p[key] as T[];
-  }
-  return [];
-}
-
-function stripUndefined(
-  input: Record<string, unknown>,
-): Record<string, unknown> {
-  return Object.fromEntries(
-    Object.entries(input).filter(([, v]) => v !== undefined),
-  );
-}
-
-function idempotencyKey(key?: string): string {
-  return key ?? randomUUID();
-}
-
-// ── Main resource ─────────────────────────────────────────────────────────────
-
-export class SandboxTemplates {
-  constructor(private readonly http: HttpClient) {}
-
-  async list(
-    params: SandboxTemplateListParams = {},
-  ): Promise<SandboxTemplateResourceData[]> {
-    const includeAliases =
-      params.includeAliases ?? params.include_aliases ?? false;
-    const query = includeAliases
-      ? ({ include_aliases: true } as Record<
-          string,
-          string | number | boolean | undefined
-        >)
-      : undefined;
-    const data = await this.http.get<unknown>("/sandbox-templates", query);
-    return listItems<SandboxTemplateResourceData>(data, [
-      "data",
-      "templates",
-      "items",
-    ]);
-  }
-
-  async get(templateId: string): Promise<SandboxTemplateResourceData> {
-    const data = await this.http.get<unknown>(
-      `/sandbox-templates/${templateId}`,
-    );
-    return unwrap<SandboxTemplateResourceData>(data);
-  }
-
-  async create(
-    params: TemplateCreateParams,
-  ): Promise<SandboxTemplateResourceData> {
-    const {
-      idempotencyKey: ikey,
-      buildSpec,
-      build_spec,
-      name,
-      ...rest
-    } = params;
-    const body = stripUndefined({
-      name,
-      build_spec: buildSpec ?? build_spec,
-      ...rest,
-    });
-    const data = await this.http.request<unknown>("/sandbox-templates", {
-      method: "POST",
-      body,
-      headers: { "Idempotency-Key": idempotencyKey(ikey) },
-    });
-    return unwrap<SandboxTemplateResourceData>(data);
-  }
-
-  async buildSpecSchema(): Promise<Record<string, unknown>> {
-    const data = await this.http.get<unknown>("/sandbox-templates/build-spec");
-    return (data ?? {}) as Record<string, unknown>;
-  }
-
-  async validate(
-    buildSpec: Record<string, unknown>,
-  ): Promise<Record<string, unknown>> {
-    const data = await this.http.post<unknown>("/sandbox-templates/validate", {
-      build_spec: buildSpec,
-    });
-    return (data ?? {}) as Record<string, unknown>;
-  }
-
-  async listBuilds(
-    templateId: string,
-  ): Promise<SandboxTemplateBuildResourceData[]> {
-    const data = await this.http.get<unknown>(
-      `/sandbox-templates/${templateId}/builds`,
-    );
-    return listItems<SandboxTemplateBuildResourceData>(data, [
-      "data",
-      "builds",
-      "items",
-    ]);
-  }
-
-  async createBuild(
-    templateId: string,
-    params: TemplateBuildCreateParams = {},
-  ): Promise<SandboxTemplateBuildResourceData> {
-    const { idempotencyKey: ikey, ...rest } = params;
-    const body = stripUndefined(rest as Record<string, unknown>);
-    const data = await this.http.request<unknown>(
-      `/sandbox-templates/${templateId}/builds`,
-      {
-        method: "POST",
-        body,
-        headers: { "Idempotency-Key": idempotencyKey(ikey) },
-      },
-    );
-    return unwrap<SandboxTemplateBuildResourceData>(data);
-  }
-}