@hoststack.dev/mcp 0.2.1 → 0.3.0

package/dist/index.d.ts

@@ -20,7 +20,7 @@ declare class ApiClient {
     private handle;
 }
 
-type ToolCategory = 'projects' | 'services' | 'deploys' | 'databases' | 'domains' | 'env-vars' | 'cron' | 'logs' | 'activity-log' | 'meta';
+type ToolCategory = 'projects' | 'services' | 'deploys' | 'databases' | 'domains' | 'volumes' | 'env-vars' | 'cron' | 'logs' | 'activity-log' | 'meta';
 interface ToolContext {
     hoststack: HostStack;
     api: ApiClient;

package/dist/index.js

@@ -324,6 +324,9 @@ function shapeUser(value) {
 function shapeTeam(value) {
   return isObject(value) ? dropNullsAndInternals(value) : {};
 }
+function shapeVolume(value) {
+  return isObject(value) ? dropNullsAndInternals(value) : {};
+}
 
 // src/resources/hoststack-resources.ts
 defineResource({
@@ -1410,6 +1413,146 @@ defineTool({
   }
 });
 
+// src/tools/volumes.ts
+import { z as z10 } from "zod";
+defineTool({
+  name: "list_volumes",
+  category: "volumes",
+  description: [
+    "List persistent disks attached to a service. Volumes mount writable storage into the container at the path you choose, surviving redeploys and restarts.",
+    "",
+    "When to use: auditing what disks are attached, checking sizes before adding more, or confirming a volume took effect after creation. Note: storage is metered for billing \u2014 use this to spot oversized disks.",
+    "",
+    "Inputs:",
+    "  - service_id: publicId of the service.",
+    "",
+    "Returns: { items: Volume[] } \u2014 each entry has id, publicId, name, mountPath, sizeGb, status (pending|active|deleting), createdAt, updatedAt.",
+    "",
+    'Example: list_volumes({ service_id: "svc_abc" }) \u2192 { items: [{ name: "data", mountPath: "/var/data", sizeGb: 10, status: "active" }] }'
+  ].join("\n"),
+  input: {
+    service_id: z10.string().describe("Service publicId (e.g. svc_abc123).")
+  },
+  handler: async (args, ctx) => {
+    const teamId = await ctx.resolveTeamId();
+    const response = await ctx.hoststack.volumes.list(teamId, args.service_id);
+    const data = shapeList(response, "volumes", shapeVolume);
+    const summary = data.items.length === 0 ? `No volumes attached to service ${args.service_id}.` : `Found ${data.items.length} volume${data.items.length === 1 ? "" : "s"} on service ${args.service_id}.`;
+    return respond({ summary, data });
+  }
+});
+defineTool({
+  name: "create_volume",
+  category: "volumes",
+  description: [
+    "Attach a new persistent disk to a service. The disk gets provisioned on the host and bind-mounted into the container at `mount_path` on the next deploy. Use this when an app needs writable persistent storage \u2014 uploads, caches, SQLite databases, anything that must survive container restarts.",
+    "",
+    "When to use: the user mentions storing files, uploads, or any data that needs to outlive a container restart. For purely ephemeral scratch space, point the app at /tmp instead (already tmpfs-mounted, free, no provisioning needed) \u2014 see HOSTSTACK_TMP_DIR.",
+    "",
+    "Inputs:",
+    "  - service_id: publicId of the service to attach to.",
+    "  - name: lowercase alphanumeric + hyphens, \u226464 chars (used as the docker volume identifier \u2014 change with care once data is written).",
+    '  - mount_path: in-container absolute path (e.g. "/var/data").',
+    "  - size_gb: optional, 1\u2013100, default 1. Counts against your plan storage quota and is metered for billing.",
+    "",
+    "Returns: { volume: Volume } \u2014 the created record.",
+    "",
+    'Example: create_volume({ service_id: "svc_abc", name: "data", mount_path: "/var/data", size_gb: 10 }) \u2192 { volume: { name: "data", mountPath: "/var/data", sizeGb: 10, status: "active" } }'
+  ].join("\n"),
+  input: {
+    service_id: z10.string().describe("Service publicId."),
+    name: z10.string().min(1).max(64).regex(/^[a-z0-9-]+$/).describe("Volume name (lowercase alphanumeric + hyphens)."),
+    mount_path: z10.string().startsWith("/").max(500).describe("In-container mount path (absolute)."),
+    size_gb: z10.number().int().min(1).max(100).optional().describe("Disk size in GB (default 1, max 100).")
+  },
+  handler: async (args, ctx) => {
+    const teamId = await ctx.resolveTeamId();
+    const input = {
+      name: args.name,
+      mountPath: args.mount_path
+    };
+    if (args.size_gb !== void 0) input.sizeGb = args.size_gb;
+    const response = await ctx.hoststack.volumes.create(teamId, args.service_id, input);
+    const data = { volume: shape(response.volume) };
+    return respond({
+      summary: `Attached volume "${args.name}" (${args.size_gb ?? 1}GB) at ${args.mount_path} on service ${args.service_id}.`,
+      data
+    });
+  }
+});
+defineTool({
+  name: "update_volume",
+  category: "volumes",
+  description: [
+    "Update a volume's mountPath or sizeGb. Resizes take effect on the next deploy; shrinking is rejected at the storage layer (filesystems can't safely shrink under live data).",
+    "",
+    "When to use: the user wants to grow the disk for an existing volume, or move where it mounts inside the container.",
+    "",
+    "Inputs:",
+    "  - service_id: publicId of the service.",
+    "  - volume_id: publicId of the volume to update.",
+    "  - mount_path (optional): new in-container mount path.",
+    "  - size_gb (optional): new size in GB (must be \u2265 current).",
+    "",
+    "Returns: { volume: Volume } \u2014 the updated record.",
+    "",
+    'Example: update_volume({ service_id: "svc_abc", volume_id: "vol_xyz", size_gb: 20 }) \u2192 { volume: { sizeGb: 20, \u2026 } }'
+  ].join("\n"),
+  input: {
+    service_id: z10.string().describe("Service publicId."),
+    volume_id: z10.string().describe("Volume publicId (e.g. vol_\u2026)."),
+    mount_path: z10.string().startsWith("/").max(500).optional().describe("New mount path."),
+    size_gb: z10.number().int().min(1).max(100).optional().describe("New size in GB.")
+  },
+  handler: async (args, ctx) => {
+    const teamId = await ctx.resolveTeamId();
+    const input = {};
+    if (args.mount_path !== void 0) input.mountPath = args.mount_path;
+    if (args.size_gb !== void 0) input.sizeGb = args.size_gb;
+    if (Object.keys(input).length === 0) {
+      return respond({ summary: "No fields to update.", data: {} });
+    }
+    const response = await ctx.hoststack.volumes.update(
+      teamId,
+      args.service_id,
+      args.volume_id,
+      input
+    );
+    const data = { volume: shape(response.volume) };
+    const fields = Object.keys(input).join(", ");
+    return respond({ summary: `Updated ${fields} on volume ${args.volume_id}.`, data });
+  }
+});
+defineTool({
+  name: "delete_volume",
+  category: "volumes",
+  description: [
+    "Detach and deprovision a volume. The underlying disk is destroyed \u2014 back up any data first. Async: marks the row deleting, the host agent finalises removal once it acks. A periodic reaper retries if the agent was offline at delete time.",
+    "",
+    "When to use: the user explicitly says to remove a volume, or you're cleaning up after retiring a service. Confirm before calling on production data.",
+    "",
+    "Inputs:",
+    "  - service_id: publicId of the service.",
+    "  - volume_id: publicId of the volume.",
+    "",
+    "Returns: { ok: true }.",
+    "",
+    'Example: delete_volume({ service_id: "svc_abc", volume_id: "vol_xyz" }) \u2192 { ok: true }'
+  ].join("\n"),
+  input: {
+    service_id: z10.string().describe("Service publicId."),
+    volume_id: z10.string().describe("Volume publicId.")
+  },
+  handler: async (args, ctx) => {
+    const teamId = await ctx.resolveTeamId();
+    await ctx.hoststack.volumes.delete(teamId, args.service_id, args.volume_id);
+    return respond({
+      summary: `Detached volume ${args.volume_id} from service ${args.service_id} (deprovisioning).`,
+      data: { ok: true }
+    });
+  }
+});
+
 // src/server-factory.ts
 var PACKAGE_NAME = "hoststack";
 var PACKAGE_VERSION = "0.1.2";