@hoststack.dev/mcp 0.12.0 → 0.13.1

package/dist/index.js

@@ -1974,7 +1974,7 @@ defineTool({
 
 // src/tools/projects.ts
 import { z as z12 } from "zod";
-var REGION_IDS = ["eu-central-1", "eu-central-2", "eu-west-1", "us-east-1"];
+var AVAILABLE_REGION_IDS = ["eu-central-1"];
 defineTool({
   name: "list_projects",
   category: "projects",
@@ -2007,7 +2007,7 @@ defineTool({
     "Inputs:",
     "  - name: human-readable project name (1\u201360 chars).",
     "  - description (optional): short blurb shown in the dashboard.",
-    '  - region (optional): "eu-central-1" (Falkenstein) | "eu-central-2" (Nuremberg) | "eu-west-1" (Helsinki) | "us-east-1" (Ashburn). Defaults to eu-central-2.',
+    '  - region (optional): "eu-central-1" (Falkenstein). Currently the only region with available capacity; defaults to eu-central-1.',
     "",
     "Returns: { project: Project } \u2014 includes the new id and publicId.",
     "",
@@ -2016,7 +2016,7 @@ defineTool({
   input: {
     name: z12.string().min(1).max(60).describe("Project name (1\u201360 chars)."),
     description: z12.string().max(500).optional().describe("Short description (\u2264500 chars)."),
-    region: z12.enum(REGION_IDS).optional().describe("Region: eu-central-1 | eu-central-2 | eu-west-1 | us-east-1.")
+    region: z12.enum(AVAILABLE_REGION_IDS).optional().describe("Region: eu-central-1 (Falkenstein) \u2014 currently the only available region.")
   },
   handler: async (args, ctx) => {
     const teamId = await ctx.resolveTeamId();
@@ -2263,7 +2263,7 @@ defineTool({
     "Inputs:",
     '  - project_id: numeric id or publicId ("prj_\u2026") of the target project.',
     '  - name (optional): service name (default "dev-environment").',
-    '  - plan (optional): service size (default "micro").',
+    '  - plan (optional): service size (default "standard" \u2014 2 GB, the smallest that fits a coding agent + build).',
     "  - disk_gb (optional): /workspace volume size in GB (default 10, 1\u2013100).",
     "  - hoststack_api_key (optional): sets HOSTSTACK_API_KEY so the hoststack MCP works inside the container.",
     "  - poststack_api_key (optional): sets POSTSTACK_API_KEY so the poststack MCP works inside the container.",
@@ -2276,7 +2276,9 @@ defineTool({
   input: {
     project_id: z13.union([z13.number().int().positive(), z13.string()]).describe("Target project \u2014 numeric id or publicId."),
     name: z13.string().min(1).max(100).optional().describe('Service name (default "dev-environment").'),
-    plan: z13.enum(SERVICE_PLANS).optional().describe('Service size (default "micro").'),
+    plan: z13.enum(SERVICE_PLANS).optional().describe(
+      'Service size (default "standard" \u2014 2 GB; smallest that fits a coding agent).'
+    ),
     disk_gb: z13.number().int().min(1).max(100).optional().describe("/workspace volume size in GB (default 10)."),
     hoststack_api_key: z13.string().optional().describe("Value for HOSTSTACK_API_KEY (enables the hoststack MCP in-container)."),
     poststack_api_key: z13.string().optional().describe("Value for POSTSTACK_API_KEY (enables the poststack MCP in-container)."),
@@ -2424,6 +2426,164 @@ defineTool({
     });
   }
 });
+defineTool({
+  name: "resize_dev_environment",
+  category: "services",
+  description: [
+    "Resize a dev box (or any service) to a different size tier \u2014 the supported way to give it more memory/CPU/disk headroom (e.g. when ESLint/tsc OOMs).",
+    "",
+    "When to use: a dev box OOM-killed (see exitReason/recommendedSize from list_dev_environments), or you just want more headroom. This changes the SIZE TIER \u2014 unlike per-config memory/CPU overrides, which are clamped to the current tier and so cannot grow a box past it.",
+    "",
+    "How it applies: the new tier's memory + CPU take effect LIVE on the running container (no recreate, no dropped shell sessions); a larger disk takes effect on the next recreate (suspend\u2192resume). Dev boxes are floored to the OOM-safe minimum size server-side.",
+    "",
+    "Inputs:",
+    "  - service_id: the box to resize \u2014 numeric id or publicId.",
+    '  - size: target tier (e.g. "standard", "large", "xlarge").',
+    "",
+    "Returns: { service } with the new plan.",
+    "",
+    'Example: resize_dev_environment({ service_id: "svc_skyskraber_dev", size: "large" }) \u2192 bumps the box to the large tier, applied live.'
+  ].join("\n"),
+  input: {
+    service_id: z13.union([z13.number().int().positive(), z13.string()]).describe("The box to resize \u2014 numeric id or publicId."),
+    size: z13.string().min(1).describe('Target size tier, e.g. "standard", "large", "xlarge".')
+  },
+  handler: async (args, ctx) => {
+    const teamId = await ctx.resolveTeamId();
+    const serviceId = await ctx.hoststack.resolveId(args.service_id, {
+      kind: "service",
+      teamId
+    });
+    const { service } = await ctx.hoststack.services.resize(teamId, serviceId, args.size);
+    return respond({
+      summary: `Resized to ${service.plan} \u2014 memory/CPU applied live; disk grows on next recreate.`,
+      data: { service: shapeService(service) }
+    });
+  }
+});
+defineTool({
+  name: "list_dev_environments",
+  category: "services",
+  description: [
+    `List the team's dev environments (the dashboard "Development" section), each annotated with the companion services attached to it.`,
+    "",
+    `When to use: "show my dev environments", before opening/tearing one down, to find a box's id.`,
+    "",
+    'Returns: { items: [{ ...service, devUrl, databases, exitReason, recommendedSize }] } where `databases` lists the companion engines wired into the box (e.g. ["postgres","redis"]). `exitReason` is "oom_killed" / "crashed" / null for the box\'s last container exit; when it is "oom_killed", `recommendedSize` is the next tier up to rescale to (use resize_dev_environment).',
+    "",
+    "Example: list_dev_environments() \u2192 every dev box for the active team."
+  ].join("\n"),
+  input: {},
+  handler: async (_args, ctx) => {
+    const teamId = await ctx.resolveTeamId();
+    const { environments } = await ctx.hoststack.services.listDevEnvironments(teamId);
+    const oomCount = environments.filter((e) => e.exitReason === "oom_killed").length;
+    return respond({
+      summary: `${environments.length} dev environment${environments.length === 1 ? "" : "s"}.` + (oomCount > 0 ? ` ${oomCount} recently OOM-killed \u2014 consider resize_dev_environment.` : ""),
+      data: {
+        items: environments.map((env) => ({
+          ...shapeService(env),
+          devUrl: env.devUrl ?? null,
+          databases: env.databases ?? [],
+          exitReason: env.exitReason ?? null,
+          recommendedSize: env.recommendedSize ?? null
+        }))
+      }
+    });
+  }
+});
+defineTool({
+  name: "create_standalone_dev_environment",
+  category: "services",
+  description: [
+    "Create a STANDALONE dev environment in one call: a cloud box (Claude Code + Codex + OpenCode + MCPs) on a persistent /workspace, from a connected GitHub repo, an arbitrary clone URL, or blank \u2014 with optional companion Postgres / Redis / Meilisearch wired into its env (mirrors a local `make db-up`). The box lives in the team's hidden Development home, NOT under a project.",
+    "",
+    'When to use: "create a dev environment for <repo>", "spin me up a cloud dev box with a Postgres". Distinct from spin_up_dev_environment (which clones an EXISTING service) and create_dev_environment (a bare box in a chosen project).',
+    "",
+    "Inputs:",
+    "  - name: the dev box name.",
+    '  - source_kind: "github_repo" (clone a connected repo \u2014 needs github_repo_id), "url" (clone any http(s) git URL \u2014 needs clone_url), or "blank" (empty box).',
+    "  - github_repo_id (for github_repo): numeric id of a connected GitHub repo.",
+    "  - clone_url (for url): an http(s) git clone URL.",
+    "  - branch (optional): branch to clone.",
+    '  - databases (optional): companion services to attach \u2014 any of "postgres", "redis", "meilisearch".',
+    '  - plan (optional): box size (default "micro").',
+    "  - agent_accounts (optional): bind specific saved agent logins by account id per provider. OMIT to auto-inherit the box owner's default logins (claude/codex/opencode), so `claude` is already authenticated on first boot \u2014 no manual login.",
+    "",
+    "Returns: { service, devUrl, deployId } \u2014 deploying. Once live: open the Terminal tab, run `claude`, start the dev server on $PORT, view at https://<devUrl>. Tear down with delete_dev_environment.",
+    "",
+    'Example: create_standalone_dev_environment({ name: "app-dev", source_kind: "github_repo", github_repo_id: 42, databases: ["postgres","redis"] })'
+  ].join("\n"),
+  input: {
+    name: z13.string().min(1).max(100).describe("Dev box name."),
+    source_kind: z13.enum(["github_repo", "url", "blank"]).describe("Where the code comes from."),
+    github_repo_id: z13.number().int().positive().optional().describe('Connected GitHub repo id (required when source_kind="github_repo").'),
+    clone_url: z13.string().url().optional().describe('http(s) git clone URL (required when source_kind="url").'),
+    branch: z13.string().min(1).max(255).optional().describe("Branch to clone."),
+    databases: z13.array(z13.enum(["postgres", "redis", "meilisearch"])).optional().describe("Companion services to attach (fresh + empty)."),
+    plan: z13.enum(SERVICE_PLANS).optional().describe('Box size (default "micro").'),
+    agent_accounts: z13.array(
+      z13.object({
+        provider: z13.enum(["claude", "codex", "opencode"]),
+        account_id: z13.number().int().positive()
+      })
+    ).max(3).optional().describe(
+      "Bind saved agent logins by account id per provider. Omit to inherit the box owner's default logins automatically."
+    )
+  },
+  handler: async (args, ctx) => {
+    const teamId = await ctx.resolveTeamId();
+    let source;
+    if (args.source_kind === "github_repo") {
+      if (!args.github_repo_id) {
+        return respond({
+          summary: 'github_repo_id is required when source_kind is "github_repo".',
+          data: { ok: false }
+        });
+      }
+      source = {
+        kind: "github_repo",
+        githubRepoId: args.github_repo_id,
+        ...args.branch ? { branch: args.branch } : {}
+      };
+    } else if (args.source_kind === "url") {
+      if (!args.clone_url) {
+        return respond({
+          summary: 'clone_url is required when source_kind is "url".',
+          data: { ok: false }
+        });
+      }
+      source = {
+        kind: "url",
+        cloneUrl: args.clone_url,
+        ...args.branch ? { branch: args.branch } : {}
+      };
+    } else {
+      source = { kind: "blank" };
+    }
+    const input = {
+      name: args.name,
+      source,
+      ...args.databases ? { databases: args.databases } : {},
+      ...args.plan ? { plan: args.plan } : {},
+      ...args.agent_accounts && args.agent_accounts.length > 0 ? {
+        agentAccounts: args.agent_accounts.map((a) => ({
+          provider: a.provider,
+          accountId: a.account_id
+        }))
+      } : {}
+    };
+    const result = await ctx.hoststack.services.createDevEnvironment(teamId, input);
+    return respond({
+      summary: `Created dev environment "${result.service.name}" (${result.service.publicId}) \u2014 deploying. Once live: open the Terminal tab, run \`claude\`, start the dev server on $PORT, and view it at https://${result.devUrl}.`,
+      data: {
+        service: shapeService(result.service),
+        devUrl: result.devUrl,
+        deployId: result.deployId
+      }
+    });
+  }
+});
 defineTool({
   name: "get_service",
   category: "services",