@archildata/api-types 0.0.42 → 0.0.44

package/index.d.ts

@@ -4,6 +4,26 @@
  */
 
 export interface paths {
+    "/api/billing/summary": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Get billing summary
+         * @description Returns the selected account's billing state and available actions.
+         */
+        get: operations["getBillingSummary"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/api/activity": {
         parameters: {
             query?: never;
@@ -664,7 +684,8 @@ export interface paths {
          *     was paused, its memory snapshot is consumed and discarded before the
          *     new VM runs; disk state remains. Starting a running sandbox or a pending
          *     cold start is idempotent. A sandbox that is stopping, pausing, or
-         *     pending a resume returns 409.
+         *     pending a resume returns 409. An optional body replaces the sandbox's
+         *     disk mounts for this and later sessions.
          */
         post: operations["startSandbox"];
         delete?: never;
@@ -708,6 +729,78 @@ export interface components {
             /** @description Stable machine-readable error code. */
             code?: string;
         };
+        BillingOwner: {
+            /** @description Selected account ID; linked accounts may share a Stripe customer. */
+            accountId: string;
+            /** @enum {string} */
+            type: "personal" | "organization";
+        };
+        BillingPeriod: {
+            /**
+             * Format: int64
+             * @description Unix timestamp in seconds.
+             */
+            start: number;
+            /**
+             * Format: int64
+             * @description Unix timestamp in seconds.
+             */
+            end: number;
+        };
+        BillingScheduledChange: {
+            /** @enum {string} */
+            type: "schedule_transition" | "plan_change";
+            /**
+             * Format: int64
+             * @description Unix timestamp in seconds.
+             */
+            effectiveAt: number;
+            /** @enum {string} */
+            targetPlan?: "developer" | "team" | "enterprise";
+        };
+        BillingPaymentHealth: {
+            /** @enum {string} */
+            status: "not_applicable" | "invoice_open" | "action_required" | "missing_payment_method" | "healthy";
+            hasDefaultPaymentMethod: boolean;
+            openInvoiceId?: string;
+            /** Format: int64 */
+            amountRemainingCents?: number;
+            openInvoiceCurrency?: string;
+        };
+        BillingSummaryActions: {
+            canStartCheckout: boolean;
+            canManagePaymentMethods: boolean;
+            canUpdateBillingProfile: boolean;
+            canViewInvoices: boolean;
+            canChangePlan: boolean;
+            canCancel: boolean;
+            canKeepSubscription: boolean;
+            canPayOpenInvoice: boolean;
+        };
+        BillingSummary: {
+            billingOwner: components["schemas"]["BillingOwner"];
+            /** @enum {string} */
+            billingMode: "not_setup" | "self_serve" | "managed";
+            /** @enum {string} */
+            plan: "developer" | "team" | "enterprise" | "unknown";
+            /** @description Stripe subscription status, `none`, or `managed`. */
+            subscriptionStatus: string;
+            billingPeriod?: components["schemas"]["BillingPeriod"];
+            /**
+             * Format: int64
+             * @description Unix timestamp in seconds.
+             */
+            scheduledCancellationAt?: number;
+            scheduledChange?: components["schemas"]["BillingScheduledChange"];
+            hasPendingUpdate: boolean;
+            paymentHealth: components["schemas"]["BillingPaymentHealth"];
+            actions: components["schemas"]["BillingSummaryActions"];
+        };
+        ApiResponse_BillingSummary: {
+            /** @example true */
+            success: boolean;
+            data: components["schemas"]["BillingSummary"];
+        };
         ActivityEvent: {
             accountId: string;
             /**
@@ -823,6 +916,7 @@ export interface components {
              * @default false
              */
             enable_service_ingress: boolean;
+            mounts?: components["schemas"]["SandboxMount"][];
             /** Format: date-time */
             created_at: string;
             /** Format: date-time */
@@ -840,6 +934,22 @@ export interface components {
              */
             checkpoint?: string;
         };
+        SandboxMount: {
+            disk_id: string;
+            /** @description Absolute guest directory to mount at. Required when more than one disk is mounted; a sole mount defaults to /mnt/archil. Guest system directories (/usr, /etc, /var, /opt, ...) are reserved, and a disk can be mounted once per sandbox. */
+            path?: string;
+            /** @description Relative subdirectory of the disk to expose instead of its root. */
+            subdirectory?: string;
+            /** @default false */
+            read_only: boolean;
+            /**
+             * @description Send mutating operations directly to the server without a delegation checkout, allowing concurrent writers.
+             * @default false
+             */
+            conditional: boolean;
+            /** @description Milliseconds to wait for the disk's exclusive root delegation before the mount fails. Not allowed with read_only or conditional. */
+            queue_ms?: number;
+        };
         SandboxEndpoint: {
             port: number;
             hostname: string;
@@ -953,6 +1063,8 @@ export interface components {
                 [key: string]: string;
             };
             network?: components["schemas"]["SandboxNetwork"];
+            /** @description Archil disks mounted inside the guest for the first session; `start` can replace them for later sessions. Inherited by forks. A sandbox with mounts must be stopped before it can be forked. */
+            mounts?: components["schemas"]["SandboxMount"][];
             /**
              * @description Lifetime budget applied independently to each powered-on session. Expiry pauses the sandbox, preserving memory and processes for resume.
              * @default 86400
@@ -963,6 +1075,10 @@ export interface components {
             /** @description Maximum number of concurrently attached process sessions. Detached processes and one-shot process controls do not count. */
             max_concurrent_execs?: number;
         };
+        StartSandboxRequest: {
+            /** @description Replace the sandbox's disk mounts for this and later sessions. Omit to keep the current ones. Not accepted by resume, and 409 while the sandbox is running or pending. */
+            mounts?: components["schemas"]["SandboxMount"][];
+        };
         ForkSandboxRequest: {
             /** @description Name for the fork. A random word-list name is generated when omitted. */
             name?: string;
@@ -1863,6 +1979,44 @@ export interface components {
 }
 export type $defs = Record<string, never>;
 export interface operations {
+    getBillingSummary: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Billing summary */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ApiResponse_BillingSummary"];
+                };
+            };
+            /** @description Missing, invalid, or disallowed credential */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "text/plain": string;
+                };
+            };
+            /** @description Billing data could not be loaded */
+            502: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponse"];
+                };
+            };
+        };
+    };
     listActivity: {
         parameters: {
             query?: {
@@ -2515,6 +2669,7 @@ export interface operations {
             };
             400: components["responses"]["ValidationError"];
             401: components["responses"]["Unauthorized"];
+            404: components["responses"]["NotFound"];
             /** @description The requested sandbox name already exists in the account */
             409: {
                 headers: {
@@ -3104,7 +3259,11 @@ export interface operations {
             };
             cookie?: never;
         };
-        requestBody?: never;
+        requestBody?: {
+            content: {
+                "application/json": components["schemas"]["StartSandboxRequest"];
+            };
+        };
         responses: {
             /** @description The sandbox was already running */
             200: {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@archildata/api-types",
-  "version": "0.0.42",
+  "version": "0.0.44",
   "description": "API types for the Archil control plane",
   "type": "module",
   "types": "index.d.ts",