@hoststack.dev/mcp 0.11.0 → 0.13.0

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();
@@ -2267,6 +2267,7 @@ defineTool({
     "  - 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.",
+    "  - repo_url (optional): clone this git URL into /workspace on first boot (with optional branch).",
     "",
     "Returns: { service: Service, volumeAttached: boolean, deployId: number | null }. Open the Terminal tab on the service (dashboard or phone) once it is running; log in once with `claude /login` inside the container.",
     "",
@@ -2278,7 +2279,11 @@ defineTool({
     plan: z13.enum(SERVICE_PLANS).optional().describe('Service size (default "micro").'),
     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).")
+    poststack_api_key: z13.string().optional().describe("Value for POSTSTACK_API_KEY (enables the poststack MCP in-container)."),
+    repo_url: z13.string().max(500).optional().describe(
+      "Clone this git URL into /workspace on first boot (HTTPS, or SSH once a key is set)."
+    ),
+    branch: z13.string().max(200).optional().describe("Branch to clone (with repo_url).")
   },
   handler: async (args, ctx) => {
     const teamId = await ctx.resolveTeamId();
@@ -2311,6 +2316,19 @@ defineTool({
         value: args.poststack_api_key,
         isSecret: true
       });
+    if (args.repo_url) {
+      envVars.push({
+        key: "HOSTSTACK_DEVENV_REPO_URL",
+        value: args.repo_url,
+        isSecret: false
+      });
+      if (args.branch)
+        envVars.push({
+          key: "HOSTSTACK_DEVENV_BRANCH",
+          value: args.branch,
+          isSecret: false
+        });
+    }
     if (envVars.length > 0) {
       await ctx.hoststack.envVars.bulkSet(teamId, service.id, { vars: envVars });
     }
@@ -2406,6 +2424,111 @@ defineTool({
     });
   }
 });
+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 }] } where `databases` lists the companion engines wired into the box (e.g. ["postgres","redis"]).',
+    "",
+    "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);
+    return respond({
+      summary: `${environments.length} dev environment${environments.length === 1 ? "" : "s"}.`,
+      data: {
+        items: environments.map((env) => ({
+          ...shapeService(env),
+          devUrl: env.devUrl ?? null,
+          databases: env.databases ?? []
+        }))
+      }
+    });
+  }
+});
+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").',
+    "",
+    "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").')
+  },
+  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 } : {}
+    };
+    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",