@hoststack.dev/mcp 0.2.0 → 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({
@@ -589,8 +592,8 @@ defineTool({
   handler: async (args, ctx) => {
     const teamId = await ctx.resolveTeamId();
     const response = await ctx.hoststack.deploys.list(teamId, args.service_id);
-    const data = shapeList(response, "deploys", shapeDeploy);
-    const summary = data.items.length === 0 ? `No deploys yet for service ${args.service_id}.` : `Found ${data.items.length} deploy${data.items.length === 1 ? "" : "s"} for service ${args.service_id}.`;
+    const data = shapeList(response, "data", shapeDeploy);
+    const summary = data.items.length === 0 ? `No deploys yet for service ${args.service_id}.` : `Found ${data.items.length} deploy${data.items.length === 1 ? "" : "s"} for service ${args.service_id} (page ${response.page} of ${response.totalPages}, ${response.total} total).`;
     return respond({ summary, data });
   }
 });
@@ -696,22 +699,32 @@ defineTool({
     "  - service_id: publicId of the service.",
     "  - deploy_id: publicId of the deploy.",
     "",
-    "Returns: { logs: string } \u2014 full build output as a single string. May be truncated by the API if the deploy is still in progress.",
+    "Returns: { logs: string, lineCount: number, nextAfterId: number | null } \u2014 flattened build output joined with newlines, line count, and a cursor for pagination (pass back as after_id to fetch the next page).",
     "",
-    'Example: get_deploy_logs({ service_id: "svc_abc", deploy_id: "dpl_xyz" }) \u2192 { logs: "Building\u2026\\nStep 1/8\u2026\\n\u2026" }'
+    'Example: get_deploy_logs({ service_id: "svc_abc", deploy_id: "dpl_xyz" }) \u2192 { logs: "Building\u2026\\nStep 1/8\u2026\\n\u2026", lineCount: 42, nextAfterId: 1234 }'
   ].join("\n"),
   input: {
     service_id: z5.string().describe("Service publicId."),
-    deploy_id: z5.string().describe("Deploy publicId.")
+    deploy_id: z5.string().describe("Deploy publicId."),
+    after_id: z5.number().int().optional().describe("Pagination cursor from a previous response\u2019s nextAfterId."),
+    limit: z5.number().int().min(1).max(5e3).optional().describe("Max log entries to fetch (default 500, hard cap 5000).")
   },
   handler: async (args, ctx) => {
     const teamId = await ctx.resolveTeamId();
-    const response = await ctx.hoststack.deploys.getLogs(teamId, args.service_id, args.deploy_id);
-    const logs = typeof response.logs === "string" ? response.logs : "";
-    const lines = logs ? logs.split("\n").length : 0;
+    const response = await ctx.hoststack.deploys.getLogs(
+      teamId,
+      args.service_id,
+      args.deploy_id,
+      {
+        ...args.after_id !== void 0 ? { afterId: args.after_id } : {},
+        ...args.limit !== void 0 ? { limit: args.limit } : {}
+      }
+    );
+    const entries = response.logs;
+    const logs = entries.map((e) => e.message).join("\n");
     return respond({
-      summary: `Fetched ${lines} log line${lines === 1 ? "" : "s"} for deploy ${args.deploy_id}.`,
-      data: { logs }
+      summary: `Fetched ${entries.length} log line${entries.length === 1 ? "" : "s"} for deploy ${args.deploy_id}.`,
+      data: { logs, lineCount: entries.length, nextAfterId: response.nextAfterId }
     });
   }
 });
@@ -1237,52 +1250,79 @@ defineTool({
   name: "update_service_config",
   category: "services",
   description: [
-    "Update build/runtime configuration for a service: build command, start command, branch, root directory, dockerfile path, auto-deploy flag, instance count, plan tier. All fields optional \u2014 pass only what you want to change.",
+    "Update build/runtime configuration for a service: build command, start command, install command, branch, root directory, dockerfile path, auto-deploy flag, instance count. All fields optional \u2014 pass only what you want to change.",
     "",
-    "When to use: the user wants to tweak how a service builds or runs without redeploying manually. Updating any field marked dispatch-eligible (branch, build/start command, plan, root, dockerfile) typically triggers a follow-up deploy automatically; instance count scales without redeploying.",
+    "When to use: the user wants to tweak how a service builds or runs. Build/runtime fields (branch, install/build/start command, root, dockerfile) take effect on the next deploy \u2014 call trigger_deploy after if you need them applied immediately. instance_count rescales without a redeploy.",
     "",
     "Inputs:",
     "  - service_id: publicId of the service.",
-    "  - build_command, start_command (optional): shell commands.",
+    "  - install_command, build_command, start_command (optional): shell commands. Pass null to clear.",
     "  - branch (optional): git branch to track.",
-    "  - root_directory, dockerfile_path (optional): build context overrides.",
+    "  - root_directory (optional): build context root inside the repo.",
+    "  - dockerfile_path (optional): path to Dockerfile relative to root_directory. Pass null to clear.",
     "  - auto_deploy (optional): boolean \u2014 auto-deploy on git push.",
-    "  - instance_count (optional): integer \u22651 \u2014 manual scale.",
-    '  - plan (optional): plan tier slug (e.g. "starter", "standard", "pro").',
+    "  - instance_count (optional): integer \u22651 \u2014 pin both min and max instances to this value.",
     "",
-    "Returns: { config: ServiceConfig } \u2014 the updated config record.",
+    "Returns: { service?: Service, config?: ServiceConfig } \u2014 whichever rows were touched.",
     "",
-    'Example: update_service_config({ service_id: "svc_abc", instance_count: 3 }) \u2192 { config: { instanceCount: 3, \u2026 } }'
+    'Example: update_service_config({ service_id: "svc_abc", start_command: "bun apps/api/src/index.ts" }) \u2192 { service: { startCommand: "bun apps/api/src/index.ts", \u2026 } }'
   ].join("\n"),
   input: {
     service_id: z9.string().describe("Service publicId."),
-    build_command: z9.string().optional().describe("Build shell command."),
-    start_command: z9.string().optional().describe("Start shell command."),
+    install_command: z9.string().nullable().optional().describe("Install shell command. Null clears."),
+    build_command: z9.string().nullable().optional().describe("Build shell command. Null clears."),
+    start_command: z9.string().nullable().optional().describe("Start shell command. Null clears."),
     branch: z9.string().optional().describe("Git branch to track."),
     root_directory: z9.string().optional().describe("Build context root."),
-    dockerfile_path: z9.string().optional().describe("Path to Dockerfile relative to root."),
+    dockerfile_path: z9.string().nullable().optional().describe("Path to Dockerfile relative to root. Null clears."),
     auto_deploy: z9.boolean().optional().describe("Auto-deploy on push."),
-    instance_count: z9.number().int().positive().optional().describe("Manual scale (\u22651)."),
-    plan: z9.string().optional().describe("Plan tier slug.")
+    instance_count: z9.number().int().positive().max(50).optional().describe("Pin min and max instances to this value (1\u201350).")
   },
   handler: async (args, ctx) => {
     const teamId = await ctx.resolveTeamId();
-    const input = {};
-    if (args.build_command !== void 0) input["buildCommand"] = args.build_command;
-    if (args.start_command !== void 0) input["startCommand"] = args.start_command;
-    if (args.branch !== void 0) input["branch"] = args.branch;
-    if (args.root_directory !== void 0) input["rootDirectory"] = args.root_directory;
-    if (args.dockerfile_path !== void 0) input["dockerfilePath"] = args.dockerfile_path;
-    if (args.auto_deploy !== void 0) input["autoDeploy"] = args.auto_deploy;
-    if (args.instance_count !== void 0) input["instanceCount"] = args.instance_count;
-    if (args.plan !== void 0) input["plan"] = args.plan;
-    if (Object.keys(input).length === 0) {
+    const serviceUpdate = {};
+    if (args.install_command !== void 0)
+      serviceUpdate["installCommand"] = args.install_command;
+    if (args.build_command !== void 0) serviceUpdate["buildCommand"] = args.build_command;
+    if (args.start_command !== void 0) serviceUpdate["startCommand"] = args.start_command;
+    if (args.dockerfile_path !== void 0)
+      serviceUpdate["dockerfilePath"] = args.dockerfile_path;
+    if (args.branch !== void 0) serviceUpdate["branch"] = args.branch;
+    if (args.root_directory !== void 0)
+      serviceUpdate["rootDirectory"] = args.root_directory;
+    if (args.auto_deploy !== void 0) serviceUpdate["autoDeploy"] = args.auto_deploy;
+    const configUpdate = {};
+    if (args.instance_count !== void 0) {
+      configUpdate["minInstances"] = args.instance_count;
+      configUpdate["maxInstances"] = args.instance_count;
+    }
+    if (Object.keys(serviceUpdate).length === 0 && Object.keys(configUpdate).length === 0) {
       return respond({ summary: "No fields to update.", data: {} });
     }
-    const response = await ctx.hoststack.services.updateConfig(teamId, args.service_id, input);
-    const data = { config: shape(response.config) };
-    const fields = Object.keys(input).join(", ");
-    return respond({ summary: `Updated ${fields} on service ${args.service_id}.`, data });
+    const data = {};
+    const touchedFields = [];
+    if (Object.keys(serviceUpdate).length > 0) {
+      const serviceResponse = await ctx.hoststack.services.update(
+        teamId,
+        args.service_id,
+        serviceUpdate
+      );
+      data["service"] = shape(serviceResponse.service);
+      touchedFields.push(...Object.keys(serviceUpdate));
+    }
+    if (Object.keys(configUpdate).length > 0) {
+      const configResponse = await ctx.hoststack.services.updateConfig(
+        teamId,
+        args.service_id,
+        configUpdate
+      );
+      data["config"] = shape(configResponse.config);
+      touchedFields.push(...Object.keys(configUpdate));
+    }
+    return respond({
+      summary: `Updated ${touchedFields.join(", ")} on service ${args.service_id}.`,
+      data
+    });
   }
 });
 defineTool({
@@ -1373,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";