@hoststack.dev/mcp 0.6.0 → 0.6.1

package/dist/index.js

@@ -2008,24 +2008,30 @@ defineTool({
   name: "get_service",
   category: "services",
   description: [
-    "Fetch a single service by ID, including its current status and configuration summary.",
+    "Fetch a single service by ID with its current status AND its service_config row (resources, health-check tuning, scaling, restart policy).",
     "",
-    "When to use: drilling into a service after list_services, checking deploy/runtime status, or grabbing the repo+branch before triggering a deploy.",
+    "When to use: drilling into a service after list_services, checking deploy/runtime status, grabbing the repo+branch before triggering a deploy, or inspecting the health-check / autoscale knobs before tweaking them via update_service_config.",
     "",
     "Inputs:",
     '  - service_id: publicId of the service (e.g. "svc_abc123").',
     "",
-    "Returns: { service: Service } \u2014 type, status, runtime, repoUrl, branch, autoDeploy, region, plan, createdAt, updatedAt.",
+    "Returns: { service: Service, config: ServiceConfig } \u2014 service has type/status/runtime/repoUrl/branch/autoDeploy/region/plan/timestamps; config has memoryMb, cpuShares, diskSizeGb, port, protocol, healthCheckEnabled, healthCheckInterval, healthCheckTimeout, healthCheckGracePeriodSec, restartPolicy, preDeployCommand, min/maxInstances, scale thresholds.",
     "",
-    'Example: get_service({ service_id: "svc_abc" }) \u2192 { service: { type: "web", status: "running", \u2026 } }'
+    'Example: get_service({ service_id: "svc_abc" }) \u2192 { service: { type: "web", status: "running", \u2026 }, config: { healthCheckGracePeriodSec: 120, \u2026 } }'
   ].join("\n"),
   input: {
     service_id: z13.string().describe("Service publicId (e.g. svc_abc123).")
   },
   handler: async (args, ctx) => {
     const teamId = await ctx.resolveTeamId();
-    const response = await ctx.hoststack.services.get(teamId, args.service_id);
-    const data = { service: shapeService(response.service) };
+    const [serviceResponse, configResponse] = await Promise.all([
+      ctx.hoststack.services.get(teamId, args.service_id),
+      ctx.hoststack.services.getConfig(teamId, args.service_id)
+    ]);
+    const data = {
+      service: shapeService(serviceResponse.service),
+      config: shape(configResponse.config)
+    };
     const status = data.service && "status" in data.service ? data.service.status : "unknown";
     return respond({ summary: `Service ${args.service_id} is ${status}.`, data });
   }
@@ -2137,9 +2143,9 @@ defineTool({
   name: "update_service_config",
   category: "services",
   description: [
-    "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.",
+    "Update build/runtime configuration for a service. 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. 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.",
+    "When to use: the user wants to tweak how a service builds, runs, scales, or health-checks. 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, resource and health-check changes rescale or rewire without a redeploy.",
     "",
     "Inputs:",
     "  - service_id: publicId of the service.",
@@ -2148,12 +2154,26 @@ defineTool({
     "  - 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 pin both min and max instances to this value.",
+    '  - health_check_path (optional): HTTP path the platform GETs to verify liveness (e.g. "/health"). Pass null for TCP-only check.',
+    "  - health_check_enabled (optional): boolean \u2014 toggle health checking on/off.",
+    "  - health_check_interval (optional): integer 5\u2013300 seconds \u2014 how often the check runs.",
+    "  - health_check_timeout (optional): integer 1\u201360 seconds \u2014 single-attempt timeout.",
+    '  - health_check_grace_period_sec (optional): integer 1\u20131800 seconds \u2014 startup tolerance before failures count. RAISE THIS (e.g. 180) when the agent reports "Health check timed out" on a cold-boot app (Bun + Vite SSR typically need 90\u2013180s).',
+    "  - memory_mb (optional): integer 128\u201316384 \u2014 container memory cap.",
+    "  - cpu_shares (optional): integer 128\u20134096 \u2014 relative CPU weight.",
+    "  - disk_size_gb (optional): integer 1\u2013100 \u2014 ephemeral disk cap.",
+    "  - port (optional): integer 1\u201365535 \u2014 container port the platform forwards traffic to.",
+    '  - protocol (optional): "http" | "tcp".',
+    '  - restart_policy (optional): "always" | "on-failure" | "no".',
+    "  - pre_deploy_command (optional): shell command run before the new release accepts traffic (typical use: migrations).",
+    "  - instance_count (optional): integer 1\u201350 \u2014 pin both min and max instances to this value.",
+    "  - min_instances, max_instances (optional): integers \u2014 autoscale bounds. Use instead of instance_count when you want a range.",
+    "  - scale_cpu_threshold, scale_memory_threshold (optional): integer 10\u2013100 \u2014 autoscale trigger percentage.",
     '  - log_filter_rules (optional): list of { pattern, action } rules applied to runtime logs at query time. Pattern matches the message by case-insensitive substring; action is "drop" (filter out) or "downgrade" (flip stderr \u2192 stdout so it stops looking like an error). Pass [] to clear all rules. Capped at 50 rules.',
     "",
     "Returns: { service?: Service, config?: ServiceConfig } \u2014 whichever rows were touched.",
     "",
-    '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 } }'
+    'Example: update_service_config({ service_id: "svc_abc", health_check_grace_period_sec: 180 }) \u2192 { config: { healthCheckGracePeriodSec: 180, \u2026 } }'
   ].join("\n"),
   input: {
     service_id: z13.string().describe("Service publicId."),
@@ -2164,7 +2184,25 @@ defineTool({
     root_directory: z13.string().optional().describe("Build context root."),
     dockerfile_path: z13.string().nullable().optional().describe("Path to Dockerfile relative to root. Null clears."),
     auto_deploy: z13.boolean().optional().describe("Auto-deploy on push."),
+    health_check_path: z13.string().nullable().optional().describe('HTTP health-check path (e.g. "/health"). Null = TCP-only check.'),
+    health_check_enabled: z13.boolean().optional().describe("Toggle health checking on/off."),
+    health_check_interval: z13.number().int().min(5).max(300).optional().describe("How often the check runs, in seconds (5\u2013300)."),
+    health_check_timeout: z13.number().int().min(1).max(60).optional().describe("Single-attempt timeout in seconds (1\u201360)."),
+    health_check_grace_period_sec: z13.number().int().min(1).max(1800).optional().describe(
+      "Startup grace period in seconds (1\u20131800). Raise this if the app needs more time to boot before health checks start counting failures."
+    ),
+    memory_mb: z13.number().int().min(128).max(16384).optional().describe("Container memory cap in MB (128\u201316384)."),
+    cpu_shares: z13.number().int().min(128).max(4096).optional().describe("Relative CPU weight (128\u20134096)."),
+    disk_size_gb: z13.number().int().min(1).max(100).optional().describe("Ephemeral disk size in GB (1\u2013100)."),
+    port: z13.number().int().min(1).max(65535).optional().describe("Container port the platform forwards traffic to."),
+    protocol: z13.enum(["http", "tcp"]).optional().describe("Traffic protocol."),
+    restart_policy: z13.enum(["always", "on-failure", "no"]).optional().describe("Docker restart policy."),
+    pre_deploy_command: z13.string().optional().describe("Shell command run before the new release accepts traffic."),
     instance_count: z13.number().int().positive().max(50).optional().describe("Pin min and max instances to this value (1\u201350)."),
+    min_instances: z13.number().int().min(0).max(50).optional().describe("Autoscale lower bound. Use with max_instances for a range."),
+    max_instances: z13.number().int().min(1).max(50).optional().describe("Autoscale upper bound. Use with min_instances for a range."),
+    scale_cpu_threshold: z13.number().int().min(10).max(100).optional().describe("Autoscale CPU trigger percentage (10\u2013100)."),
+    scale_memory_threshold: z13.number().int().min(10).max(100).optional().describe("Autoscale memory trigger percentage (10\u2013100)."),
     log_filter_rules: z13.array(
       z13.object({
         pattern: z13.string().min(1).max(200),
@@ -2186,11 +2224,35 @@ defineTool({
     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;
+    if (args.health_check_path !== void 0)
+      serviceUpdate["healthCheckPath"] = args.health_check_path;
     const configUpdate = {};
+    if (args.health_check_enabled !== void 0)
+      configUpdate["healthCheckEnabled"] = args.health_check_enabled;
+    if (args.health_check_interval !== void 0)
+      configUpdate["healthCheckInterval"] = args.health_check_interval;
+    if (args.health_check_timeout !== void 0)
+      configUpdate["healthCheckTimeout"] = args.health_check_timeout;
+    if (args.health_check_grace_period_sec !== void 0)
+      configUpdate["healthCheckGracePeriodSec"] = args.health_check_grace_period_sec;
+    if (args.memory_mb !== void 0) configUpdate["memoryMb"] = args.memory_mb;
+    if (args.cpu_shares !== void 0) configUpdate["cpuShares"] = args.cpu_shares;
+    if (args.disk_size_gb !== void 0) configUpdate["diskSizeGb"] = args.disk_size_gb;
+    if (args.port !== void 0) configUpdate["port"] = args.port;
+    if (args.protocol !== void 0) configUpdate["protocol"] = args.protocol;
+    if (args.restart_policy !== void 0) configUpdate["restartPolicy"] = args.restart_policy;
+    if (args.pre_deploy_command !== void 0)
+      configUpdate["preDeployCommand"] = args.pre_deploy_command;
     if (args.instance_count !== void 0) {
       configUpdate["minInstances"] = args.instance_count;
       configUpdate["maxInstances"] = args.instance_count;
     }
+    if (args.min_instances !== void 0) configUpdate["minInstances"] = args.min_instances;
+    if (args.max_instances !== void 0) configUpdate["maxInstances"] = args.max_instances;
+    if (args.scale_cpu_threshold !== void 0)
+      configUpdate["scaleCpuThreshold"] = args.scale_cpu_threshold;
+    if (args.scale_memory_threshold !== void 0)
+      configUpdate["scaleMemoryThreshold"] = args.scale_memory_threshold;
     if (args.log_filter_rules !== void 0) {
       configUpdate["logFilterRules"] = args.log_filter_rules;
     }