@hoststack.dev/sdk 0.10.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;
 }
@@ -75,6 +77,54 @@ interface CreateServiceInput {
     /** True when this service is a dev environment (agentic dev-env image, or manually flagged). */
     isDevEnvironment?: boolean;
 }
+/** Companion managed services a standalone dev box can stand up alongside itself. */
+type DevEnvCompanion = 'postgres' | 'redis' | 'meilisearch';
+/** Where a standalone dev box's code comes from. */
+type DevEnvSource = {
+    kind: 'github_repo';
+    githubRepoId: number;
+    branch?: string;
+} | {
+    kind: 'url';
+    cloneUrl: string;
+    branch?: string;
+} | {
+    kind: 'blank';
+};
+/**
+ * Create a standalone dev environment — a cloud box (Claude Code / Codex /
+ * OpenCode on a persistent /workspace) created from a connected GitHub repo, an
+ * arbitrary clone URL, or blank, with optional companion Postgres / Redis /
+ * Meilisearch wired into its env. Lives in the team's hidden Development home.
+ */
+interface CreateDevEnvironmentInput {
+    name: string;
+    source: DevEnvSource;
+    /** Companion databases/search to attach (fresh + empty), like local `make db-up`. */
+    databases?: DevEnvCompanion[];
+    /** Compute size for the box. Defaults to `micro`. */
+    plan?: string;
+}
+/** A dev environment as listed for the Development section — a service plus the
+ * companion services attached to it. */
+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.
  * Nullable fields accept `null` to clear; `undefined` leaves the value unchanged.
@@ -92,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;
@@ -895,6 +953,37 @@ 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`).
+     */
+    listDevEnvironments(teamId: IdInput): Promise<{
+        environments: DevEnvironment[];
+    }>;
+    /**
+     * Create a STANDALONE dev environment — a cloud box (Claude Code / Codex /
+     * OpenCode on a persistent /workspace) from a connected GitHub repo, an
+     * arbitrary clone URL, or blank, with optional companion Postgres / Redis /
+     * Meilisearch. Unlike `spinUpDevEnvironment`, there's no source service — the
+     * box lives in the team's hidden Development home. Returns the box, its dev
+     * URL, and the first deploy id. Tear it down with `tearDownDevEnvironment`.
+     */
+    createDevEnvironment(teamId: IdInput, data: CreateDevEnvironmentInput): Promise<{
+        service: Service;
+        devUrl: string;
+        deployId: number | null;
+    }>;
     /**
      * Spin up an agentic dev environment FROM this service: a dev box that runs
      * a clone of the app (repo auto-cloned into /workspace, env-vars copied, and
@@ -1218,4 +1307,4 @@ interface PaginatedResponse<T> {
  */
 declare function buildPaginationQuery(params?: PaginationParams): string;
 
-export { type ActivityLogEntry, type AddDomainInput, AuthenticationError, type BulkSetEnvVarsInput, ConflictError, type CreateDatabaseInput, type CreateEnvVarInput, type CreateEnvironmentInput, type CreateProjectInput, type CreateServiceInput, type CreateVolumeInput, type CronExecution, type CronExecutionStatus, type CronExecutionTrigger, type Database, type DatabaseCredentials, type DatabaseEngine, type DatabasePlan, type DatabaseStatus, type Deploy, type DeployListResponse, type DeployLogEntry, type DeployStatus, type DeployTrigger, type Domain, type DomainStatus, type EnvVar, type EnvVarTarget, type Environment, ForbiddenError, HostStack, HostStackError, type HostStackOptions, type IdInput, type LogEntry$1 as LogEntry, type MeResponse, NotFoundError, type NotificationChannel, type NotificationChannelEvent, type NotificationChannelType, type PaginatedResponse, type PaginationParams, type Project, RateLimitError, type RegionId, type Service, type ServiceConfig, type ServiceMetricsPoint, type ServiceMetricsSnapshot, type ServicePlan, type ServiceStatus, type ServiceType, type StreamLogsOptions, type Team, type TeamRole, type TriggerDeployInput, type UpdateDatabaseInput, type UpdateDomainInput, type UpdateEnvVarInput, type UpdateEnvironmentInput, type UpdateProjectInput, type UpdateServiceConfigInput, type UpdateServiceInput, type UpdateVolumeInput, type User, type Volume, buildPaginationQuery };
+export { type ActivityLogEntry, type AddDomainInput, AuthenticationError, type BulkSetEnvVarsInput, ConflictError, type CreateDatabaseInput, type CreateDevEnvironmentInput, type CreateEnvVarInput, type CreateEnvironmentInput, type CreateProjectInput, type CreateServiceInput, type CreateVolumeInput, type CronExecution, type CronExecutionStatus, type CronExecutionTrigger, type Database, type DatabaseCredentials, type DatabaseEngine, type DatabasePlan, type DatabaseStatus, type Deploy, type DeployListResponse, type DeployLogEntry, type DeployStatus, type DeployTrigger, type DevEnvCompanion, type DevEnvSource, type DevEnvironment, type Domain, type DomainStatus, type EnvVar, type EnvVarTarget, type Environment, ForbiddenError, HostStack, HostStackError, type HostStackOptions, type IdInput, type LogEntry$1 as LogEntry, type MeResponse, NotFoundError, type NotificationChannel, type NotificationChannelEvent, type NotificationChannelType, type PaginatedResponse, type PaginationParams, type Project, RateLimitError, type RegionId, type Service, type ServiceConfig, type ServiceMetricsPoint, type ServiceMetricsSnapshot, type ServicePlan, type ServiceStatus, type ServiceType, type StreamLogsOptions, type Team, type TeamRole, type TriggerDeployInput, type UpdateDatabaseInput, type UpdateDomainInput, type UpdateEnvVarInput, type UpdateEnvironmentInput, type UpdateProjectInput, type UpdateServiceConfigInput, type UpdateServiceInput, type UpdateVolumeInput, type User, type Volume, buildPaginationQuery };

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;
 }
@@ -75,6 +77,54 @@ interface CreateServiceInput {
     /** True when this service is a dev environment (agentic dev-env image, or manually flagged). */
     isDevEnvironment?: boolean;
 }
+/** Companion managed services a standalone dev box can stand up alongside itself. */
+type DevEnvCompanion = 'postgres' | 'redis' | 'meilisearch';
+/** Where a standalone dev box's code comes from. */
+type DevEnvSource = {
+    kind: 'github_repo';
+    githubRepoId: number;
+    branch?: string;
+} | {
+    kind: 'url';
+    cloneUrl: string;
+    branch?: string;
+} | {
+    kind: 'blank';
+};
+/**
+ * Create a standalone dev environment — a cloud box (Claude Code / Codex /
+ * OpenCode on a persistent /workspace) created from a connected GitHub repo, an
+ * arbitrary clone URL, or blank, with optional companion Postgres / Redis /
+ * Meilisearch wired into its env. Lives in the team's hidden Development home.
+ */
+interface CreateDevEnvironmentInput {
+    name: string;
+    source: DevEnvSource;
+    /** Companion databases/search to attach (fresh + empty), like local `make db-up`. */
+    databases?: DevEnvCompanion[];
+    /** Compute size for the box. Defaults to `micro`. */
+    plan?: string;
+}
+/** A dev environment as listed for the Development section — a service plus the
+ * companion services attached to it. */
+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.
  * Nullable fields accept `null` to clear; `undefined` leaves the value unchanged.
@@ -92,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;
@@ -895,6 +953,37 @@ 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`).
+     */
+    listDevEnvironments(teamId: IdInput): Promise<{
+        environments: DevEnvironment[];
+    }>;
+    /**
+     * Create a STANDALONE dev environment — a cloud box (Claude Code / Codex /
+     * OpenCode on a persistent /workspace) from a connected GitHub repo, an
+     * arbitrary clone URL, or blank, with optional companion Postgres / Redis /
+     * Meilisearch. Unlike `spinUpDevEnvironment`, there's no source service — the
+     * box lives in the team's hidden Development home. Returns the box, its dev
+     * URL, and the first deploy id. Tear it down with `tearDownDevEnvironment`.
+     */
+    createDevEnvironment(teamId: IdInput, data: CreateDevEnvironmentInput): Promise<{
+        service: Service;
+        devUrl: string;
+        deployId: number | null;
+    }>;
     /**
      * Spin up an agentic dev environment FROM this service: a dev box that runs
      * a clone of the app (repo auto-cloned into /workspace, env-vars copied, and
@@ -1218,4 +1307,4 @@ interface PaginatedResponse<T> {
  */
 declare function buildPaginationQuery(params?: PaginationParams): string;
 
-export { type ActivityLogEntry, type AddDomainInput, AuthenticationError, type BulkSetEnvVarsInput, ConflictError, type CreateDatabaseInput, type CreateEnvVarInput, type CreateEnvironmentInput, type CreateProjectInput, type CreateServiceInput, type CreateVolumeInput, type CronExecution, type CronExecutionStatus, type CronExecutionTrigger, type Database, type DatabaseCredentials, type DatabaseEngine, type DatabasePlan, type DatabaseStatus, type Deploy, type DeployListResponse, type DeployLogEntry, type DeployStatus, type DeployTrigger, type Domain, type DomainStatus, type EnvVar, type EnvVarTarget, type Environment, ForbiddenError, HostStack, HostStackError, type HostStackOptions, type IdInput, type LogEntry$1 as LogEntry, type MeResponse, NotFoundError, type NotificationChannel, type NotificationChannelEvent, type NotificationChannelType, type PaginatedResponse, type PaginationParams, type Project, RateLimitError, type RegionId, type Service, type ServiceConfig, type ServiceMetricsPoint, type ServiceMetricsSnapshot, type ServicePlan, type ServiceStatus, type ServiceType, type StreamLogsOptions, type Team, type TeamRole, type TriggerDeployInput, type UpdateDatabaseInput, type UpdateDomainInput, type UpdateEnvVarInput, type UpdateEnvironmentInput, type UpdateProjectInput, type UpdateServiceConfigInput, type UpdateServiceInput, type UpdateVolumeInput, type User, type Volume, buildPaginationQuery };
+export { type ActivityLogEntry, type AddDomainInput, AuthenticationError, type BulkSetEnvVarsInput, ConflictError, type CreateDatabaseInput, type CreateDevEnvironmentInput, type CreateEnvVarInput, type CreateEnvironmentInput, type CreateProjectInput, type CreateServiceInput, type CreateVolumeInput, type CronExecution, type CronExecutionStatus, type CronExecutionTrigger, type Database, type DatabaseCredentials, type DatabaseEngine, type DatabasePlan, type DatabaseStatus, type Deploy, type DeployListResponse, type DeployLogEntry, type DeployStatus, type DeployTrigger, type DevEnvCompanion, type DevEnvSource, type DevEnvironment, type Domain, type DomainStatus, type EnvVar, type EnvVarTarget, type Environment, ForbiddenError, HostStack, HostStackError, type HostStackOptions, type IdInput, type LogEntry$1 as LogEntry, type MeResponse, NotFoundError, type NotificationChannel, type NotificationChannelEvent, type NotificationChannelType, type PaginatedResponse, type PaginationParams, type Project, RateLimitError, type RegionId, type Service, type ServiceConfig, type ServiceMetricsPoint, type ServiceMetricsSnapshot, type ServicePlan, type ServiceStatus, type ServiceType, type StreamLogsOptions, type Team, type TeamRole, type TriggerDeployInput, type UpdateDatabaseInput, type UpdateDomainInput, type UpdateEnvVarInput, type UpdateEnvironmentInput, type UpdateProjectInput, type UpdateServiceConfigInput, type UpdateServiceInput, type UpdateVolumeInput, type User, type Volume, buildPaginationQuery };

package/dist/index.js

@@ -641,6 +641,39 @@ 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`).
+   */
+  async listDevEnvironments(teamId) {
+    const tid = await this.client.resolveId(teamId, { kind: "team" });
+    return this.client.request("GET", `/api/dev-environments/${tid}`);
+  }
+  /**
+   * Create a STANDALONE dev environment — a cloud box (Claude Code / Codex /
+   * OpenCode on a persistent /workspace) from a connected GitHub repo, an
+   * arbitrary clone URL, or blank, with optional companion Postgres / Redis /
+   * Meilisearch. Unlike `spinUpDevEnvironment`, there's no source service — the
+   * box lives in the team's hidden Development home. Returns the box, its dev
+   * URL, and the first deploy id. Tear it down with `tearDownDevEnvironment`.
+   */
+  async createDevEnvironment(teamId, data) {
+    const tid = await this.client.resolveId(teamId, { kind: "team" });
+    return this.client.request("POST", `/api/dev-environments/${tid}`, data);
+  }
   /**
    * Spin up an agentic dev environment FROM this service: a dev box that runs
    * a clone of the app (repo auto-cloned into /workspace, env-vars copied, and
@@ -971,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`);
     }