@hoststack.dev/mcp 0.10.2 → 0.12.0

package/dist/index.js

@@ -751,6 +751,36 @@ defineTool({
     });
   }
 });
+defineTool({
+  name: "upgrade_database_version",
+  category: "databases",
+  description: [
+    "Upgrade a standalone managed database (postgres or redis) to a newer engine version in place. The agent dumps the live data, recreates the container at the target version under the same DNS name, and restores \u2014 so connection URLs stay valid and services do NOT need a redeploy. The database is briefly unavailable (seconds) during the cut-over; on any failure the original container is rolled back automatically.",
+    "",
+    "`version` must be a supported, strictly-newer version for the engine (postgres: 18/17/16/15, redis: 8/7/6). Downgrades are rejected. Returns 400 for unsupported engines (mysql/mariadb/mongodb upgrades are not implemented yet), for HA (Patroni) clusters, or if the database is not currently `available`.",
+    "",
+    "When to use: a customer wants to move to a newer Postgres/Redis major version. Check get_database first \u2014 the `version` field shows the current version; compare against the engine latest.",
+    "",
+    "Inputs:",
+    "  - database_id: publicId of the postgres/redis database to upgrade.",
+    '  - version: target engine version (e.g. "18" for postgres, "8" for redis).',
+    "",
+    'Returns: 202 Accepted. The upgrade is async \u2014 poll get_database until `version` matches the target and `status === "available"` to confirm.',
+    "",
+    'Example: upgrade_database_version({ database_id: "db_abc", version: "18" }) \u2192 { ok: true }'
+  ].join("\n"),
+  input: {
+    database_id: z5.string().describe("Database publicId (e.g. db_abc) to upgrade."),
+    version: z5.string().describe('Target engine version, e.g. "18" for postgres or "8" for redis.')
+  },
+  handler: async (args, ctx) => {
+    const teamId = await ctx.resolveTeamId();
+    await ctx.hoststack.databases.upgradeVersion(teamId, args.database_id, args.version);
+    return respond({
+      summary: `Version upgrade to v${args.version} started for ${args.database_id}. Poll get_database until version=${args.version} and status=available to confirm.`
+    });
+  }
+});
 defineTool({
   name: "get_database_cluster",
   category: "databases",
@@ -2068,7 +2098,7 @@ defineTool({
 
 // src/tools/services.ts
 import { z as z13 } from "zod";
-var DEV_ENV_IMAGE = "hoststack/dev-env:claude";
+var DEV_ENV_IMAGE = "hoststack/dev-env:latest";
 var DEV_ENV_VOLUME = { name: "workspace", mountPath: "/workspace", sizeGb: 10 };
 var SERVICE_TYPES = [
   "web_service",
@@ -2237,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.",
     "",
@@ -2248,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();
@@ -2281,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 });
     }
@@ -2302,6 +2350,80 @@ defineTool({
     });
   }
 });
+defineTool({
+  name: "spin_up_dev_environment",
+  category: "services",
+  description: [
+    "Spin up an agentic dev environment FROM an existing service so you can reproduce a bug, fix it, view it, and ship it. Creates a dev box (Claude/Codex/OpenCode + MCPs) that RUNS a clone of the app: the repo is auto-cloned into /workspace, the service env-vars are copied, and its linked database is cloned (so the box never touches the prod DB). The box gets an unguessable public dev URL and seamless `git push`.",
+    "",
+    'When to use: "spin up a dev environment for <service>", "I found a bug on <service>, give me a box to fix it". Distinct from create_dev_environment, which makes a BARE box not tied to any app.',
+    "",
+    "Inputs:",
+    '  - service_id: the source service to debug \u2014 numeric id or publicId ("svc_\u2026").',
+    "  - include_database_clone (optional): clone the linked database so the app runs on a copy of real data (default true).",
+    '  - name (optional): dev box name (default "<source>-dev").',
+    "",
+    "Returns: { service, devUrl, deployId }. Once it is live: open the Terminal tab, run `claude`, start the dev server (it must bind $PORT), and view the app at https://<devUrl>. Tear it all down later with delete_dev_environment.",
+    "",
+    'Example: spin_up_dev_environment({ service_id: "svc_api" }) \u2192 a dev box running a clone of the api service (repo + env-vars + cloned DB) with a public dev URL.'
+  ].join("\n"),
+  input: {
+    service_id: z13.union([z13.number().int().positive(), z13.string()]).describe("Source service to debug \u2014 numeric id or publicId."),
+    include_database_clone: z13.boolean().optional().describe("Clone the linked database so the app runs on copied data (default true)."),
+    name: z13.string().min(1).max(100).optional().describe('Dev box name (default "<source>-dev").')
+  },
+  handler: async (args, ctx) => {
+    const teamId = await ctx.resolveTeamId();
+    const serviceId = await ctx.hoststack.resolveId(args.service_id, {
+      kind: "service",
+      teamId
+    });
+    const opts = {};
+    if (args.include_database_clone !== void 0)
+      opts.includeDatabaseClone = args.include_database_clone;
+    if (args.name !== void 0) opts.name = args.name;
+    const result = await ctx.hoststack.services.spinUpDevEnvironment(teamId, serviceId, opts);
+    return respond({
+      summary: `Spun up 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}. \`git push\` works from inside.`,
+      data: {
+        service: shapeService(result.service),
+        devUrl: result.devUrl,
+        deployId: result.deployId
+      }
+    });
+  }
+});
+defineTool({
+  name: "delete_dev_environment",
+  category: "services",
+  description: [
+    "Tear down an agentic dev environment in one call: removes the dev box AND cascade-deletes its cloned database, its /workspace volume, and the auto-created `development` environment if it is now empty.",
+    "",
+    'When to use: "delete / tear down the dev environment", once you have shipped the fix and no longer need the box.',
+    "",
+    "Inputs:",
+    "  - service_id: the dev box to tear down \u2014 numeric id or publicId.",
+    "",
+    "Returns: { ok: true }. Irreversible \u2014 the cloned database and workspace volume are deleted.",
+    "",
+    'Example: delete_dev_environment({ service_id: "svc_api_dev" }) \u2192 removes the dev box, its cloned database, and the /workspace volume.'
+  ].join("\n"),
+  input: {
+    service_id: z13.union([z13.number().int().positive(), z13.string()]).describe("The dev box to tear down \u2014 numeric id or publicId.")
+  },
+  handler: async (args, ctx) => {
+    const teamId = await ctx.resolveTeamId();
+    const serviceId = await ctx.hoststack.resolveId(args.service_id, {
+      kind: "service",
+      teamId
+    });
+    await ctx.hoststack.services.tearDownDevEnvironment(teamId, serviceId);
+    return respond({
+      summary: "Dev environment torn down \u2014 box, cloned database, /workspace volume, and empty development environment removed.",
+      data: { ok: true }
+    });
+  }
+});
 defineTool({
   name: "get_service",
   category: "services",