@hoststack.dev/sdk 0.11.0 → 0.11.1

package/dist/index.d.cts

@@ -39,6 +39,8 @@ interface Service {
     status: ServiceStatus;
     internalUrl?: string | null;
     projectId: number;
+    /** Size tier (memory/CPU/disk bracket), e.g. "standard" / "large". Change via `services.resize`. */
+    plan?: string;
     createdAt: string;
     updatedAt: string;
 }
@@ -109,6 +111,19 @@ interface DevEnvironment extends Service {
     devUrl?: string | null;
     /** Companion engines attached to the box (e.g. `['postgres','redis']`). */
     databases?: string[];
+    /**
+     * Why the box's container last exited recently, if at all. `'oom_killed'`
+     * means it ran out of memory (the DB status stays `active` because the
+     * health monitor auto-restarts it) — pair with `recommendedSize` to offer
+     * a rescale. `null` when it exited cleanly / hasn't exited.
+     */
+    exitReason?: 'oom_killed' | 'crashed' | null;
+    /**
+     * Suggested next size tier to rescale to, set when the box recently
+     * OOM-killed. `null` when no rescale is recommended (or already at the
+     * largest tier).
+     */
+    recommendedSize?: string | null;
 }
 /**
  * Fields that live on the `services` row — write via PATCH /services/:tid/:sid.
@@ -127,6 +142,14 @@ interface UpdateServiceInput {
     cronSchedule?: string | null;
     publishPath?: string | null;
     runtime?: string;
+    /**
+     * Resize the service's size tier (memory/CPU/disk bracket). The supported
+     * way to scale a box past its current tier's resource ceiling — per-config
+     * overrides are clamped to the tier, so growing beyond it needs a tier move.
+     * Dev boxes are floored to the OOM-safe minimum. Applies live to the running
+     * container (memory/CPU) where possible; disk grows on the next recreate.
+     */
+    plan?: string;
 }
 interface ServiceConfig {
     memoryMb?: number;
@@ -930,6 +953,17 @@ declare class ServicesResource {
     }>;
     /** Delete a service. */
     delete(teamId: IdInput, serviceId: IdInput): Promise<void>;
+    /**
+     * Resize a service (incl. dev boxes) to a different size tier. This is the
+     * supported way to scale past the current tier's memory/CPU/disk ceiling —
+     * per-config overrides are clamped to the tier, so growing beyond it
+     * requires moving the tier. The new tier's memory/CPU apply LIVE to the
+     * running container (no recreate); disk grows on the next recreate. Dev
+     * boxes are floored to the OOM-safe minimum size server-side.
+     */
+    resize(teamId: IdInput, serviceId: IdInput, plan: string): Promise<{
+        service: Service;
+    }>;
     /**
      * List the team's dev environments (the Development section), each annotated
      * with the companion services attached to it (`databases`).

package/dist/index.d.ts

@@ -39,6 +39,8 @@ interface Service {
     status: ServiceStatus;
     internalUrl?: string | null;
     projectId: number;
+    /** Size tier (memory/CPU/disk bracket), e.g. "standard" / "large". Change via `services.resize`. */
+    plan?: string;
     createdAt: string;
     updatedAt: string;
 }
@@ -109,6 +111,19 @@ interface DevEnvironment extends Service {
     devUrl?: string | null;
     /** Companion engines attached to the box (e.g. `['postgres','redis']`). */
     databases?: string[];
+    /**
+     * Why the box's container last exited recently, if at all. `'oom_killed'`
+     * means it ran out of memory (the DB status stays `active` because the
+     * health monitor auto-restarts it) — pair with `recommendedSize` to offer
+     * a rescale. `null` when it exited cleanly / hasn't exited.
+     */
+    exitReason?: 'oom_killed' | 'crashed' | null;
+    /**
+     * Suggested next size tier to rescale to, set when the box recently
+     * OOM-killed. `null` when no rescale is recommended (or already at the
+     * largest tier).
+     */
+    recommendedSize?: string | null;
 }
 /**
  * Fields that live on the `services` row — write via PATCH /services/:tid/:sid.
@@ -127,6 +142,14 @@ interface UpdateServiceInput {
     cronSchedule?: string | null;
     publishPath?: string | null;
     runtime?: string;
+    /**
+     * Resize the service's size tier (memory/CPU/disk bracket). The supported
+     * way to scale a box past its current tier's resource ceiling — per-config
+     * overrides are clamped to the tier, so growing beyond it needs a tier move.
+     * Dev boxes are floored to the OOM-safe minimum. Applies live to the running
+     * container (memory/CPU) where possible; disk grows on the next recreate.
+     */
+    plan?: string;
 }
 interface ServiceConfig {
     memoryMb?: number;
@@ -930,6 +953,17 @@ declare class ServicesResource {
     }>;
     /** Delete a service. */
     delete(teamId: IdInput, serviceId: IdInput): Promise<void>;
+    /**
+     * Resize a service (incl. dev boxes) to a different size tier. This is the
+     * supported way to scale past the current tier's memory/CPU/disk ceiling —
+     * per-config overrides are clamped to the tier, so growing beyond it
+     * requires moving the tier. The new tier's memory/CPU apply LIVE to the
+     * running container (no recreate); disk grows on the next recreate. Dev
+     * boxes are floored to the OOM-safe minimum size server-side.
+     */
+    resize(teamId: IdInput, serviceId: IdInput, plan: string): Promise<{
+        service: Service;
+    }>;
     /**
      * List the team's dev environments (the Development section), each annotated
      * with the companion services attached to it (`databases`).

package/dist/index.js

@@ -641,6 +641,19 @@ var ServicesResource = class {
     const sid = await this.client.resolveId(serviceId, { kind: "service", teamId: tid });
     return this.client.request("DELETE", `/api/services/${tid}/${sid}`);
   }
+  /**
+   * Resize a service (incl. dev boxes) to a different size tier. This is the
+   * supported way to scale past the current tier's memory/CPU/disk ceiling —
+   * per-config overrides are clamped to the tier, so growing beyond it
+   * requires moving the tier. The new tier's memory/CPU apply LIVE to the
+   * running container (no recreate); disk grows on the next recreate. Dev
+   * boxes are floored to the OOM-safe minimum size server-side.
+   */
+  async resize(teamId, serviceId, plan) {
+    const tid = await this.client.resolveId(teamId, { kind: "team" });
+    const sid = await this.client.resolveId(serviceId, { kind: "service", teamId: tid });
+    return this.client.request("PATCH", `/api/services/${tid}/${sid}`, { plan });
+  }
   /**
    * List the team's dev environments (the Development section), each annotated
    * with the companion services attached to it (`databases`).
@@ -991,7 +1004,14 @@ var HostStack = class {
     const cached = this.idCache.get(cacheKey);
     if (cached !== void 0) return cached;
     const items = await this.fetchForResolution(scope);
-    const match = items.find((it) => it.publicId === input);
+    let match = items.find((it) => it.publicId === input);
+    if (!match && scope.kind === "service") {
+      try {
+        const d = await this.request("GET", `/api/dev-environments/${scope.teamId}`);
+        match = (d.environments ?? []).find((it) => it.publicId === input);
+      } catch {
+      }
+    }
     if (!match) {
       throw new NotFoundError(`${scope.kind} ${input} not found`);
     }