@hoststack.dev/mcp 0.5.0 → 0.6.0

package/dist/index.js

@@ -41,6 +41,14 @@ var ApiClient = class {
     });
     return this.handle(res);
   }
+  async put(path, body) {
+    const res = await fetch(`${this.baseUrl}${path}`, {
+      method: "PUT",
+      headers: this.headers,
+      body: JSON.stringify(body)
+    });
+    return this.handle(res);
+  }
   async delete(path) {
     const res = await fetch(`${this.baseUrl}${path}`, {
       method: "DELETE",
@@ -906,8 +914,297 @@ defineTool({
   }
 });
 
-// src/tools/domains.ts
+// src/tools/dns-records.ts
 import { z as z7 } from "zod";
+var DNS_RECORD_TYPES = ["A", "AAAA", "CNAME", "MX", "TXT", "NS", "SRV", "CAA", "ALIAS"];
+async function resolveZonePublicId(api, teamId, input) {
+  if (input.zone_id) {
+    const { zones: zones2 } = await api.get(`/api/dns-zones/${teamId}`);
+    const match = zones2.find((z15) => z15.publicId === input.zone_id);
+    if (!match) {
+      throw new Error(`Zone ${input.zone_id} not found on this team.`);
+    }
+    return { publicId: match.publicId, domainName: match.domainName };
+  }
+  if (!input.domain) {
+    throw new Error("Provide either zone_id or domain.");
+  }
+  const { zones } = await api.get(`/api/dns-zones/${teamId}`);
+  const fqdn = input.domain.toLowerCase().replace(/\.$/, "");
+  const labels = fqdn.split(".");
+  for (let i = 0; i < labels.length - 1; i++) {
+    const candidate = labels.slice(i).join(".");
+    const match = zones.find((z15) => z15.domainName.toLowerCase() === candidate);
+    if (match && match.status !== "deleting") {
+      return { publicId: match.publicId, domainName: match.domainName };
+    }
+  }
+  throw new Error(
+    `No hosted zone matches ${input.domain}. Create the zone in the dashboard (Domains \u2192 DNS) first, then retry.`
+  );
+}
+defineTool({
+  name: "list_dns_zones",
+  category: "dns",
+  description: [
+    "List authoritative DNS zones the team owns on HostStack's PowerDNS infrastructure. Each zone is the apex domain (e.g. example.com) under which DNS records live.",
+    "",
+    "When to use: discover which apex domains support record management before calling create_dns_record / list_dns_records. The dashboard equivalent is Domains \u2192 DNS.",
+    "",
+    'Returns: { items: Zone[] } \u2014 each zone exposes publicId, domainName, status ("active" | "syncing" | "failed" | "deleting"), nsRecords (the nameservers the parent registry must delegate to), provider, createdAt.',
+    "",
+    'Example: list_dns_zones() \u2192 { items: [{ publicId: "dnz_abc", domainName: "micci.dk", status: "active", nsRecords: ["ns1.hoststack.dev","ns2.hoststack.dev"] }] }'
+  ].join("\n"),
+  input: {},
+  handler: async (_args, ctx) => {
+    const teamId = await ctx.resolveTeamId();
+    const response = await ctx.api.get(`/api/dns-zones/${teamId}`);
+    const items = Array.isArray(response.zones) ? response.zones.map(shape) : [];
+    const summary = items.length === 0 ? "No DNS zones hosted on this team. Create one in the dashboard (Domains \u2192 DNS)." : `Found ${items.length} hosted DNS zone${items.length === 1 ? "" : "s"}.`;
+    return respond({ summary, data: { items } });
+  }
+});
+defineTool({
+  name: "list_dns_records",
+  category: "dns",
+  description: [
+    "List every active record in a hosted DNS zone. Records are addressed by their type + name + value tuple; PowerDNS gathers records with the same (name, type) into an RRset on the wire.",
+    "",
+    "When to use: audit what is currently published for a zone before editing, verify a recently-created record landed, or read existing TXT verification strings.",
+    "",
+    'Provide EITHER zone_id (the zone publicId, e.g. "dnz_abc") OR domain (an apex or subdomain \u2014 the longest-matching hosted apex wins; "app.example.com" matches a hosted "example.com" zone).',
+    "",
+    'Returns: { zone: { publicId, domainName }, items: Record[] } \u2014 each record includes publicId, type, name ("@" for apex, or label), value, ttl, priority?, status ("active" | "syncing" | "failed"), managedBy ("user" | "hoststack" | "poststack"), createdAt.',
+    "",
+    'Example: list_dns_records({ domain: "micci.dk" }) \u2192 { zone: { domainName: "micci.dk", \u2026 }, items: [{ type: "TXT", name: "@", value: "google-site-verification=\u2026", ttl: 300, \u2026 }] }'
+  ].join("\n"),
+  input: {
+    zone_id: z7.string().optional().describe('Zone publicId (e.g. "dnz_abc").'),
+    domain: z7.string().optional().describe("Apex or subdomain \u2014 resolves to the longest-matching hosted zone.")
+  },
+  handler: async (args, ctx) => {
+    const teamId = await ctx.resolveTeamId();
+    const zoneInput = {};
+    if (args.zone_id !== void 0) zoneInput.zone_id = args.zone_id;
+    if (args.domain !== void 0) zoneInput.domain = args.domain;
+    const zone = await resolveZonePublicId(ctx.api, teamId, zoneInput);
+    const response = await ctx.api.get(
+      `/api/dns-zones/${teamId}/${zone.publicId}/records`
+    );
+    const items = Array.isArray(response.records) ? response.records.map(shape) : [];
+    const summary = items.length === 0 ? `Zone ${zone.domainName} has no records yet.` : `Returned ${items.length} record${items.length === 1 ? "" : "s"} for ${zone.domainName}.`;
+    return respond({
+      summary,
+      data: { zone: { publicId: zone.publicId, domainName: zone.domainName }, items }
+    });
+  }
+});
+defineTool({
+  name: "get_dns_record",
+  category: "dns",
+  description: [
+    'Fetch a single DNS record by its publicId. Useful for confirming the record landed after create_dns_record / update_dns_record (status transitions from "syncing" to "active" once PowerDNS acknowledges).',
+    "",
+    "When to use: verify a record exists, inspect its current ttl/value, or check the sync status of an in-flight write.",
+    "",
+    "Inputs:",
+    '  - record_id: record publicId (e.g. "dnr_abc"). Returned by list_dns_records and create_dns_record.',
+    "",
+    "Returns: { record: Record }. Mirrors the shape returned by list_dns_records.",
+    "",
+    'Example: get_dns_record({ record_id: "dnr_abc" }) \u2192 { record: { type: "TXT", name: "@", value: "\u2026", status: "active", \u2026 } }'
+  ].join("\n"),
+  input: {
+    record_id: z7.string().describe("Record publicId.")
+  },
+  handler: async (args, ctx) => {
+    const teamId = await ctx.resolveTeamId();
+    const { zones } = await ctx.api.get(`/api/dns-zones/${teamId}`);
+    for (const zone of zones) {
+      const { records } = await ctx.api.get(
+        `/api/dns-zones/${teamId}/${zone.publicId}/records`
+      );
+      const match = records.find((r) => r.publicId === args.record_id);
+      if (match) {
+        return respond({
+          summary: `Record ${match.type} ${match.name} on ${zone.domainName}.`,
+          data: {
+            zone: { publicId: zone.publicId, domainName: zone.domainName },
+            record: shape(match)
+          }
+        });
+      }
+    }
+    return respondError(`Record ${args.record_id} not found on any zone owned by this team.`);
+  }
+});
+defineTool({
+  name: "create_dns_record",
+  category: "dns",
+  description: [
+    'Create a DNS record on a hosted zone. Writes to the DB first, then mirrors to PowerDNS \u2014 record returns with status="syncing" until the provider acknowledges, then flips to "active". Re-creating the same (zone, type, name, value) tuple is idempotent and returns the existing row.',
+    "",
+    "When to use: add TXT verification records (Google Search Console, domain ownership challenges, DKIM), A/AAAA records pointing a subdomain at an IP, CNAME aliases, MX records, etc.",
+    "",
+    "Provide EITHER zone_id (zone publicId) OR domain (resolves via longest-suffix match against hosted zones).",
+    "",
+    "Inputs:",
+    '  - type: "A" | "AAAA" | "CNAME" | "MX" | "TXT" | "NS" | "SRV" | "CAA" | "ALIAS".',
+    '  - name: "@" for the zone apex, or a subdomain label ("www", "api", "_acme-challenge").',
+    "  - content: the literal record value. For TXT pass the unquoted string \u2014 the PowerDNS layer handles quoting.",
+    "  - ttl (optional): 60\u201386400 seconds, default 3600.",
+    "  - priority (optional, required for MX and SRV): 0\u201365535.",
+    "",
+    "Returns: { record: Record } \u2014 see get_dns_record for the shape.",
+    "",
+    'Example: create_dns_record({ domain: "micci.dk", type: "TXT", name: "@", content: "google-site-verification=C0V0scK48g2\u2026", ttl: 300 })'
+  ].join("\n"),
+  input: {
+    zone_id: z7.string().optional().describe("Zone publicId."),
+    domain: z7.string().optional().describe("Apex or subdomain to resolve a hosted zone."),
+    type: z7.enum(DNS_RECORD_TYPES).describe("DNS record type."),
+    name: z7.string().min(1).max(253).describe('"@" for apex, or label (no trailing dot).'),
+    content: z7.string().min(1).max(2e3).describe("Record value; TXT values are unquoted."),
+    ttl: z7.number().int().min(60).max(86400).optional().describe("TTL in seconds (default 3600)."),
+    priority: z7.number().int().min(0).max(65535).optional().describe("Required for MX / SRV.")
+  },
+  handler: async (args, ctx) => {
+    if ((args.type === "MX" || args.type === "SRV") && args.priority === void 0) {
+      return respondError(`Priority is required for ${args.type} records (0\u201365535).`);
+    }
+    const teamId = await ctx.resolveTeamId();
+    const zoneInput = {};
+    if (args.zone_id !== void 0) zoneInput.zone_id = args.zone_id;
+    if (args.domain !== void 0) zoneInput.domain = args.domain;
+    const zone = await resolveZonePublicId(ctx.api, teamId, zoneInput);
+    const body = {
+      type: args.type,
+      name: args.name,
+      value: args.content
+    };
+    if (args.ttl !== void 0) body.ttl = args.ttl;
+    if (args.priority !== void 0) body.priority = args.priority;
+    const response = await ctx.api.post(
+      `/api/dns-zones/${teamId}/${zone.publicId}/records`,
+      body
+    );
+    return respond({
+      summary: `Created ${args.type} ${args.name} on ${zone.domainName}.`,
+      data: {
+        zone: { publicId: zone.publicId, domainName: zone.domainName },
+        record: shape(response.record)
+      }
+    });
+  }
+});
+defineTool({
+  name: "update_dns_record",
+  category: "dns",
+  description: [
+    "Update an existing DNS record by its publicId. Use this to change a TTL, swap a value, or move the record to a different (name, type) bucket. Full-record PUT semantics: every mutable field must be provided.",
+    "",
+    "When to use: rotate a DKIM key, repoint an A record at a new IP, bump TTL ahead of a planned change.",
+    "",
+    "Inputs:",
+    "  - record_id: record publicId.",
+    "  - type, name, content: the new values (the route is full-replace, not patch \u2014 fetch with get_dns_record first if you only want to tweak one field).",
+    "  - ttl (optional), priority (optional, required for MX / SRV).",
+    "",
+    "Returns: { record: Record } reflecting the new state.",
+    "",
+    'Example: update_dns_record({ record_id: "dnr_abc", type: "A", name: "api", content: "203.0.113.42", ttl: 300 })'
+  ].join("\n"),
+  input: {
+    record_id: z7.string().describe("Record publicId."),
+    type: z7.enum(DNS_RECORD_TYPES).describe("DNS record type."),
+    name: z7.string().min(1).max(253).describe('"@" for apex, or label.'),
+    content: z7.string().min(1).max(2e3).describe("Record value; TXT unquoted."),
+    ttl: z7.number().int().min(60).max(86400).optional().describe("TTL in seconds (default 3600)."),
+    priority: z7.number().int().min(0).max(65535).optional().describe("Required for MX / SRV.")
+  },
+  handler: async (args, ctx) => {
+    if ((args.type === "MX" || args.type === "SRV") && args.priority === void 0) {
+      return respondError(`Priority is required for ${args.type} records (0\u201365535).`);
+    }
+    const teamId = await ctx.resolveTeamId();
+    const target = await findRecordZone(ctx.api, teamId, args.record_id);
+    if (!target) {
+      return respondError(
+        `Record ${args.record_id} not found on any zone owned by this team.`
+      );
+    }
+    const body = {
+      type: args.type,
+      name: args.name,
+      value: args.content
+    };
+    if (args.ttl !== void 0) body.ttl = args.ttl;
+    if (args.priority !== void 0) body.priority = args.priority;
+    const response = await ctx.api.put(
+      `/api/dns-zones/${teamId}/${target.zone.publicId}/records/${args.record_id}`,
+      body
+    );
+    return respond({
+      summary: `Updated ${args.type} ${args.name} on ${target.zone.domainName}.`,
+      data: {
+        zone: {
+          publicId: target.zone.publicId,
+          domainName: target.zone.domainName
+        },
+        record: shape(response.record)
+      }
+    });
+  }
+});
+defineTool({
+  name: "delete_dns_record",
+  category: "dns",
+  description: [
+    "Soft-delete a DNS record and remove it from PowerDNS. DESTRUCTIVE: resolvers stop returning the value as soon as the change propagates. Same code path as the dashboard delete button \u2014 the row is marked deleted and the RRset is re-pushed without it.",
+    "",
+    "When to use: retire a TXT verification record once the challenge has been confirmed; drop an A record for a decommissioned subdomain.",
+    "",
+    "Inputs:",
+    "  - record_id: record publicId.",
+    "",
+    "Returns: { ok: true }.",
+    "",
+    'Example: delete_dns_record({ record_id: "dnr_abc" }) \u2192 { ok: true }'
+  ].join("\n"),
+  input: {
+    record_id: z7.string().describe("Record publicId.")
+  },
+  handler: async (args, ctx) => {
+    const teamId = await ctx.resolveTeamId();
+    const target = await findRecordZone(ctx.api, teamId, args.record_id);
+    if (!target) {
+      return respondError(
+        `Record ${args.record_id} not found on any zone owned by this team.`
+      );
+    }
+    await ctx.api.delete(
+      `/api/dns-zones/${teamId}/${target.zone.publicId}/records/${args.record_id}`
+    );
+    return respond({
+      summary: `Deleted record ${args.record_id} from ${target.zone.domainName}.`,
+      data: { ok: true }
+    });
+  }
+});
+async function findRecordZone(api, teamId, recordPublicId) {
+  const { zones } = await api.get(`/api/dns-zones/${teamId}`);
+  for (const zone of zones) {
+    const { records } = await api.get(
+      `/api/dns-zones/${teamId}/${zone.publicId}/records`
+    );
+    const match = records.find((r) => r.publicId === recordPublicId);
+    if (match) return { zone, record: match };
+  }
+  return null;
+}
+
+// src/tools/domains.ts
+import { z as z8 } from "zod";
 defineTool({
   name: "list_domains",
   category: "domains",
@@ -946,8 +1243,8 @@ defineTool({
     'Example: add_domain({ hostname: "api.example.com", service_id: "svc_abc" }) \u2192 { domain: { hostname: "api.example.com", dnsTargets: [...], verified: false, \u2026 } }'
   ].join("\n"),
   input: {
-    hostname: z7.string().min(3).max(253).describe("Fully-qualified hostname (e.g. api.example.com)."),
-    service_id: z7.string().optional().describe("Optional service publicId to bind to.")
+    hostname: z8.string().min(3).max(253).describe("Fully-qualified hostname (e.g. api.example.com)."),
+    service_id: z8.string().optional().describe("Optional service publicId to bind to.")
   },
   handler: async (args, ctx) => {
     const teamId = await ctx.resolveTeamId();
@@ -977,7 +1274,7 @@ defineTool({
     'Example: verify_domain({ domain_id: "dom_xyz" }) \u2192 { ok: true }'
   ].join("\n"),
   input: {
-    domain_id: z7.string().describe("Domain publicId.")
+    domain_id: z8.string().describe("Domain publicId.")
   },
   handler: async (args, ctx) => {
     const teamId = await ctx.resolveTeamId();
@@ -1004,7 +1301,7 @@ defineTool({
     'Example: remove_domain({ domain_id: "dom_xyz" }) \u2192 { ok: true }'
   ].join("\n"),
   input: {
-    domain_id: z7.string().describe("Domain publicId.")
+    domain_id: z8.string().describe("Domain publicId.")
   },
   handler: async (args, ctx) => {
     const teamId = await ctx.resolveTeamId();
@@ -1014,7 +1311,7 @@ defineTool({
 });
 
 // src/tools/env-vars.ts
-import { z as z8 } from "zod";
+import { z as z9 } from "zod";
 defineTool({
   name: "list_env_vars",
   category: "env-vars",
@@ -1031,7 +1328,7 @@ defineTool({
     'Example: list_env_vars({ service_id: "svc_abc" }) \u2192 { items: [{ key: "DATABASE_URL", value: "\u2022\u2022\u2022\u2022\u2022\u2022", isSecret: true }, { key: "PORT", value: "3000", isSecret: false }] }'
   ].join("\n"),
   input: {
-    service_id: z8.string().describe("Service publicId.")
+    service_id: z9.string().describe("Service publicId.")
   },
   handler: async (args, ctx) => {
     const teamId = await ctx.resolveTeamId();
@@ -1060,10 +1357,10 @@ defineTool({
     'Example: set_env_var({ service_id: "svc_abc", key: "DATABASE_URL", value: "postgres://\u2026", is_secret: true }) \u2192 { envVar: { key: "DATABASE_URL", value: "\u2022\u2022\u2022\u2022\u2022\u2022", \u2026 }, action: "updated" }'
   ].join("\n"),
   input: {
-    service_id: z8.string().describe("Service publicId."),
-    key: z8.string().min(1).max(128).describe("Env-var key."),
-    value: z8.string().describe("New value."),
-    is_secret: z8.boolean().optional().describe("Mark as secret (encrypted, masked on read). Default true.")
+    service_id: z9.string().describe("Service publicId."),
+    key: z9.string().min(1).max(128).describe("Env-var key."),
+    value: z9.string().describe("New value."),
+    is_secret: z9.boolean().optional().describe("Mark as secret (encrypted, masked on read). Default true.")
   },
   handler: async (args, ctx) => {
     const teamId = await ctx.resolveTeamId();
@@ -1115,8 +1412,8 @@ defineTool({
     'Example: delete_env_var({ service_id: "svc_abc", key: "OLD_FLAG" }) \u2192 { ok: true }'
   ].join("\n"),
   input: {
-    service_id: z8.string().describe("Service publicId."),
-    key: z8.string().min(1).max(128).describe("Env-var key to delete.")
+    service_id: z9.string().describe("Service publicId."),
+    key: z9.string().min(1).max(128).describe("Env-var key to delete.")
   },
   handler: async (args, ctx) => {
     const teamId = await ctx.resolveTeamId();
@@ -1152,12 +1449,12 @@ defineTool({
     'Example: bulk_set_env_vars({ service_id: "svc_abc", env_vars: [{ key: "PORT", value: "3000", is_secret: false }, { key: "DATABASE_URL", value: "\u2026", is_secret: true }] }) \u2192 { ok: true }'
   ].join("\n"),
   input: {
-    service_id: z8.string().describe("Service publicId."),
-    env_vars: z8.array(
-      z8.object({
-        key: z8.string().min(1).max(128),
-        value: z8.string(),
-        is_secret: z8.boolean().optional()
+    service_id: z9.string().describe("Service publicId."),
+    env_vars: z9.array(
+      z9.object({
+        key: z9.string().min(1).max(128),
+        value: z9.string(),
+        is_secret: z9.boolean().optional()
       })
     ).max(500).describe("Array of env-var rows. Hard cap 500.")
   },
@@ -1182,7 +1479,7 @@ defineTool({
 });
 
 // src/tools/environments.ts
-import { z as z9 } from "zod";
+import { z as z10 } from "zod";
 defineTool({
   name: "list_environments",
   category: "environments",
@@ -1199,7 +1496,7 @@ defineTool({
     'Example: list_environments({ project_id: "prj_abc" }) \u2192 { items: [{ name: "Production", type: "production", isDefault: true }, { name: "Staging", type: "staging" }] }'
   ].join("\n"),
   input: {
-    project_id: z9.string().describe("Project publicId.")
+    project_id: z10.string().describe("Project publicId.")
   },
   handler: async (args, ctx) => {
     const teamId = await ctx.resolveTeamId();
@@ -1228,10 +1525,10 @@ defineTool({
     'Example: create_environment({ project_id: "prj_abc", name: "Staging", type: "staging" }) \u2192 { environment: { id: 7, publicId: "environment_\u2026", name: "Staging", type: "staging" } }'
   ].join("\n"),
   input: {
-    project_id: z9.string().describe("Project publicId."),
-    name: z9.string().min(1).max(64).describe("Environment name (1\u201364 chars)."),
-    type: z9.enum(["production", "staging", "development", "preview"]).describe("Environment type \u2014 drives the hostname suffix."),
-    is_protected: z9.boolean().optional().describe("Require admin role for destructive actions. Default false.")
+    project_id: z10.string().describe("Project publicId."),
+    name: z10.string().min(1).max(64).describe("Environment name (1\u201364 chars)."),
+    type: z10.enum(["production", "staging", "development", "preview"]).describe("Environment type \u2014 drives the hostname suffix."),
+    is_protected: z10.boolean().optional().describe("Require admin role for destructive actions. Default false.")
   },
   handler: async (args, ctx) => {
     const teamId = await ctx.resolveTeamId();
@@ -1265,8 +1562,8 @@ defineTool({
     'Example: delete_environment({ project_id: "prj_abc", environment_id: "environment_xyz" }) \u2192 { success: true }'
   ].join("\n"),
   input: {
-    project_id: z9.string().describe("Project publicId."),
-    environment_id: z9.union([z9.string(), z9.number()]).describe("Environment publicId or numeric id.")
+    project_id: z10.string().describe("Project publicId."),
+    environment_id: z10.union([z10.string(), z10.number()]).describe("Environment publicId or numeric id.")
   },
   handler: async (args, ctx) => {
     const teamId = await ctx.resolveTeamId();
@@ -1297,9 +1594,9 @@ defineTool({
     'Example: promote_deploy({ service_id: "svc_staging", deploy_id: "dpl_built", target_environment_id: "environment_prod" }) \u2192 { deploy: { id: 99, status: "pending", trigger: "rollback", dockerImageId: "sha256:\u2026" } }'
   ].join("\n"),
   input: {
-    service_id: z9.string().describe("Source service publicId."),
-    deploy_id: z9.string().describe("Source deploy publicId (must have a built image)."),
-    target_environment_id: z9.union([z9.string(), z9.number()]).describe("Target environment publicId or numeric id.")
+    service_id: z10.string().describe("Source service publicId."),
+    deploy_id: z10.string().describe("Source deploy publicId (must have a built image)."),
+    target_environment_id: z10.union([z10.string(), z10.number()]).describe("Target environment publicId or numeric id.")
   },
   handler: async (args, ctx) => {
     const teamId = await ctx.resolveTeamId();
@@ -1348,7 +1645,7 @@ defineTool({
 });
 
 // src/tools/notifications.ts
-import { z as z10 } from "zod";
+import { z as z11 } from "zod";
 var NOTIFICATION_EVENTS = [
   "deploy.started",
   "deploy.succeeded",
@@ -1407,10 +1704,10 @@ defineTool({
     "Example: create_notification_channel({ type: 'slack', name: 'eng-alerts', webhook_url: 'https://hooks.slack.com/\u2026', events: ['deploy.failed', 'git.auth_failed', 'service.restart_failed'] })"
   ].join("\n"),
   input: {
-    type: z10.enum(["slack", "discord", "email"]).describe("Channel type."),
-    name: z10.string().min(1).max(128).describe("Human-readable label."),
-    webhook_url: z10.string().max(500).describe("Slack/Discord webhook URL or email address (when type=email)."),
-    events: z10.array(z10.enum(NOTIFICATION_EVENTS)).describe("List of events the channel subscribes to. Empty list = subscribe to nothing.")
+    type: z11.enum(["slack", "discord", "email"]).describe("Channel type."),
+    name: z11.string().min(1).max(128).describe("Human-readable label."),
+    webhook_url: z11.string().max(500).describe("Slack/Discord webhook URL or email address (when type=email)."),
+    events: z11.array(z11.enum(NOTIFICATION_EVENTS)).describe("List of events the channel subscribes to. Empty list = subscribe to nothing.")
   },
   handler: async (args, ctx) => {
     const teamId = await ctx.resolveTeamId();
@@ -1446,10 +1743,10 @@ defineTool({
     "Example: update_notification_channel({ channel_id: 3, events: ['deploy.failed', 'service.restart_failed', 'git.auth_failed'] })"
   ].join("\n"),
   input: {
-    channel_id: z10.number().int().positive().describe("Numeric channel id from list_notification_channels."),
-    name: z10.string().min(1).max(128).optional().describe("New label."),
-    active: z10.boolean().optional().describe("false silences without deleting."),
-    events: z10.array(z10.enum(NOTIFICATION_EVENTS)).optional().describe("Replaces the full subscription list.")
+    channel_id: z11.number().int().positive().describe("Numeric channel id from list_notification_channels."),
+    name: z11.string().min(1).max(128).optional().describe("New label."),
+    active: z11.boolean().optional().describe("false silences without deleting."),
+    events: z11.array(z11.enum(NOTIFICATION_EVENTS)).optional().describe("Replaces the full subscription list.")
   },
   handler: async (args, ctx) => {
     const teamId = await ctx.resolveTeamId();
@@ -1488,7 +1785,7 @@ defineTool({
     "Example: delete_notification_channel({ channel_id: 3 }) \u2192 { ok: true }"
   ].join("\n"),
   input: {
-    channel_id: z10.number().int().positive().describe("Numeric channel id.")
+    channel_id: z11.number().int().positive().describe("Numeric channel id.")
   },
   handler: async (args, ctx) => {
     const teamId = await ctx.resolveTeamId();
@@ -1515,7 +1812,7 @@ defineTool({
     "Example: test_notification_channel({ channel_id: 3 }) \u2192 { success: true }"
   ].join("\n"),
   input: {
-    channel_id: z10.number().int().positive().describe("Numeric channel id.")
+    channel_id: z11.number().int().positive().describe("Numeric channel id.")
   },
   handler: async (args, ctx) => {
     const teamId = await ctx.resolveTeamId();
@@ -1530,7 +1827,7 @@ defineTool({
 });
 
 // src/tools/projects.ts
-import { z as z11 } from "zod";
+import { z as z12 } from "zod";
 defineTool({
   name: "list_projects",
   category: "projects",
@@ -1570,9 +1867,9 @@ defineTool({
     'Example: create_project({ name: "billing-api", description: "Stripe webhooks", region: "fsn1" }) \u2192 { project: { id: 12, publicId: "prj_\u2026", \u2026 } }'
   ].join("\n"),
   input: {
-    name: z11.string().min(1).max(60).describe("Project name (1\u201360 chars)."),
-    description: z11.string().max(500).optional().describe("Short description (\u2264500 chars)."),
-    region: z11.enum(["fsn1", "nbg1", "hel1"]).optional().describe("Hetzner region: fsn1 | nbg1 | hel1.")
+    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(["fsn1", "nbg1", "hel1"]).optional().describe("Hetzner region: fsn1 | nbg1 | hel1.")
   },
   handler: async (args, ctx) => {
     const teamId = await ctx.resolveTeamId();
@@ -1603,9 +1900,9 @@ defineTool({
     'Example: update_project({ project_id: "prj_abc", name: "billing-prod" }) \u2192 { project: { name: "billing-prod", \u2026 } }'
   ].join("\n"),
   input: {
-    project_id: z11.string().describe("Project publicId."),
-    name: z11.string().min(1).max(60).optional().describe("New name (1\u201360 chars)."),
-    description: z11.string().max(500).optional().describe("New description (\u2264500 chars).")
+    project_id: z12.string().describe("Project publicId."),
+    name: z12.string().min(1).max(60).optional().describe("New name (1\u201360 chars)."),
+    description: z12.string().max(500).optional().describe("New description (\u2264500 chars).")
   },
   handler: async (args, ctx) => {
     if (args.name === void 0 && args.description === void 0) {
@@ -1639,7 +1936,7 @@ defineTool({
     'Example: get_project({ project_id: "prj_abc" }) \u2192 { project: { id: 12, name: "billing", \u2026 } }'
   ].join("\n"),
   input: {
-    project_id: z11.string().describe("Project publicId (e.g. prj_abc123).")
+    project_id: z12.string().describe("Project publicId (e.g. prj_abc123).")
   },
   handler: async (args, ctx) => {
     const teamId = await ctx.resolveTeamId();
@@ -1651,7 +1948,7 @@ defineTool({
 });
 
 // src/tools/services.ts
-import { z as z12 } from "zod";
+import { z as z13 } from "zod";
 defineTool({
   name: "list_services",
   category: "services",
@@ -1671,10 +1968,10 @@ defineTool({
     'Example: list_services({ status: "failed" }) \u2192 only services that need attention.'
   ].join("\n"),
   input: {
-    project_id: z12.union([z12.number().int().positive(), z12.string()]).optional().describe("Project filter \u2014 numeric id or publicId."),
-    environment_id: z12.union([z12.number().int().positive(), z12.string()]).optional().describe("Environment filter \u2014 numeric id or publicId."),
-    status: z12.enum(["active", "deploying", "suspended", "failed", "not_deployed"]).optional().describe("Filter by current runtime status."),
-    type: z12.enum(["web_service", "private_service", "worker", "cron_job", "static_site"]).optional().describe("Filter by service type.")
+    project_id: z13.union([z13.number().int().positive(), z13.string()]).optional().describe("Project filter \u2014 numeric id or publicId."),
+    environment_id: z13.union([z13.number().int().positive(), z13.string()]).optional().describe("Environment filter \u2014 numeric id or publicId."),
+    status: z13.enum(["active", "deploying", "suspended", "failed", "not_deployed"]).optional().describe("Filter by current runtime status."),
+    type: z13.enum(["web_service", "private_service", "worker", "cron_job", "static_site"]).optional().describe("Filter by service type.")
   },
   handler: async (args, ctx) => {
     const teamId = await ctx.resolveTeamId();
@@ -1723,7 +2020,7 @@ defineTool({
     'Example: get_service({ service_id: "svc_abc" }) \u2192 { service: { type: "web", status: "running", \u2026 } }'
   ].join("\n"),
   input: {
-    service_id: z12.string().describe("Service publicId (e.g. svc_abc123).")
+    service_id: z13.string().describe("Service publicId (e.g. svc_abc123).")
   },
   handler: async (args, ctx) => {
     const teamId = await ctx.resolveTeamId();
@@ -1749,7 +2046,7 @@ defineTool({
     'Example: get_service_metrics({ service_id: "svc_abc" }) \u2192 { metrics: { cpu: 0.42, memory: 0.71, \u2026 } }'
   ].join("\n"),
   input: {
-    service_id: z12.string().describe("Service publicId.")
+    service_id: z13.string().describe("Service publicId.")
   },
   handler: async (args, ctx) => {
     const teamId = await ctx.resolveTeamId();
@@ -1778,9 +2075,9 @@ defineTool({
     'Example: get_service_metrics_history({ service_id: "svc_abc", from: "-1h" }) \u2192 60-ish points for the last hour.'
   ].join("\n"),
   input: {
-    service_id: z12.string().describe("Service publicId."),
-    from: z12.string().optional().describe('ISO-8601 lower bound or relative offset (e.g. "-1h", "-2d").'),
-    to: z12.string().optional().describe("ISO-8601 upper bound; defaults to now.")
+    service_id: z13.string().describe("Service publicId."),
+    from: z13.string().optional().describe('ISO-8601 lower bound or relative offset (e.g. "-1h", "-2d").'),
+    to: z13.string().optional().describe("ISO-8601 upper bound; defaults to now.")
   },
   handler: async (args, ctx) => {
     const teamId = await ctx.resolveTeamId();
@@ -1824,8 +2121,8 @@ defineTool({
     'Example: update_service({ service_id: "svc_abc", name: "api-prod" }) \u2192 { service: { name: "api-prod", \u2026 } }'
   ].join("\n"),
   input: {
-    service_id: z12.string().describe("Service publicId."),
-    name: z12.string().min(1).max(60).describe("New service name (1\u201360 chars).")
+    service_id: z13.string().describe("Service publicId."),
+    name: z13.string().min(1).max(60).describe("New service name (1\u201360 chars).")
   },
   handler: async (args, ctx) => {
     const teamId = await ctx.resolveTeamId();
@@ -1859,19 +2156,19 @@ defineTool({
     '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: z12.string().describe("Service publicId."),
-    install_command: z12.string().nullable().optional().describe("Install shell command. Null clears."),
-    build_command: z12.string().nullable().optional().describe("Build shell command. Null clears."),
-    start_command: z12.string().nullable().optional().describe("Start shell command. Null clears."),
-    branch: z12.string().optional().describe("Git branch to track."),
-    root_directory: z12.string().optional().describe("Build context root."),
-    dockerfile_path: z12.string().nullable().optional().describe("Path to Dockerfile relative to root. Null clears."),
-    auto_deploy: z12.boolean().optional().describe("Auto-deploy on push."),
-    instance_count: z12.number().int().positive().max(50).optional().describe("Pin min and max instances to this value (1\u201350)."),
-    log_filter_rules: z12.array(
-      z12.object({
-        pattern: z12.string().min(1).max(200),
-        action: z12.enum(["drop", "downgrade"])
+    service_id: z13.string().describe("Service publicId."),
+    install_command: z13.string().nullable().optional().describe("Install shell command. Null clears."),
+    build_command: z13.string().nullable().optional().describe("Build shell command. Null clears."),
+    start_command: z13.string().nullable().optional().describe("Start shell command. Null clears."),
+    branch: z13.string().optional().describe("Git branch to track."),
+    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."),
+    instance_count: z13.number().int().positive().max(50).optional().describe("Pin min and max instances to this value (1\u201350)."),
+    log_filter_rules: z13.array(
+      z13.object({
+        pattern: z13.string().min(1).max(200),
+        action: z13.enum(["drop", "downgrade"])
       })
     ).max(50).optional().describe(
       "Runtime-log filter rules. Empty array [] clears all rules. Each pattern is case-insensitive substring match against the message."
@@ -1942,7 +2239,7 @@ defineTool({
     'Example: suspend_service({ service_id: "svc_dev" }) \u2192 { ok: true }'
   ].join("\n"),
   input: {
-    service_id: z12.string().describe("Service publicId.")
+    service_id: z13.string().describe("Service publicId.")
   },
   handler: async (args, ctx) => {
     const teamId = await ctx.resolveTeamId();
@@ -1966,7 +2263,7 @@ defineTool({
     'Example: resume_service({ service_id: "svc_dev" }) \u2192 { ok: true }'
   ].join("\n"),
   input: {
-    service_id: z12.string().describe("Service publicId.")
+    service_id: z13.string().describe("Service publicId.")
   },
   handler: async (args, ctx) => {
     const teamId = await ctx.resolveTeamId();
@@ -2000,16 +2297,16 @@ defineTool({
     '  - Just count error lines without fetching them: get_service_logs({ service_id: "svc_abc", level: "error", since: "-5m", count_only: true }) \u2192 { count: 47 }'
   ].join("\n"),
   input: {
-    service_id: z12.string().describe("Service publicId."),
-    lines: z12.number().int().positive().max(1e3).optional().describe("Tail size; default 200, hard cap 1000."),
-    since: z12.string().optional().describe('ISO-8601 timestamp or relative offset (e.g. "-5m", "-1h").'),
-    until: z12.string().optional().describe("ISO-8601 timestamp or relative offset upper bound."),
-    stream: z12.enum(["stdout", "stderr"]).optional().describe("Restrict to one stream."),
-    level: z12.enum(["stdout", "stderr", "trace", "debug", "info", "warn", "error", "fatal"]).optional().describe(
+    service_id: z13.string().describe("Service publicId."),
+    lines: z13.number().int().positive().max(1e3).optional().describe("Tail size; default 200, hard cap 1000."),
+    since: z13.string().optional().describe('ISO-8601 timestamp or relative offset (e.g. "-5m", "-1h").'),
+    until: z13.string().optional().describe("ISO-8601 timestamp or relative offset upper bound."),
+    stream: z13.enum(["stdout", "stderr"]).optional().describe("Restrict to one stream."),
+    level: z13.enum(["stdout", "stderr", "trace", "debug", "info", "warn", "error", "fatal"]).optional().describe(
       "Filter by structured JSON log level (pino/bunyan/severity). Falls back to a stream-alias hint for plain-text logs (info/debug\u2192stdout, warn/error/fatal\u2192stderr)."
     ),
-    search: z12.string().max(100).optional().describe("Case-insensitive substring filter."),
-    count_only: z12.boolean().optional().describe("When true, return only { count } \u2014 skips the log payload.")
+    search: z13.string().max(100).optional().describe("Case-insensitive substring filter."),
+    count_only: z13.boolean().optional().describe("When true, return only { count } \u2014 skips the log payload.")
   },
   handler: async (args, ctx) => {
     const teamId = await ctx.resolveTeamId();
@@ -2058,14 +2355,14 @@ defineTool({
     'Example: get_service_logs_bulk({ service_ids: ["svc_api", "svc_worker"], level: "error", since: "-15m", count_only: true }) \u2192 { results: { svc_api: { count: 0 }, svc_worker: { count: 12 } } }.'
   ].join("\n"),
   input: {
-    service_ids: z12.array(z12.string()).min(1).max(10).describe("Service publicIds (1\u201310). Hard cap 10 to bound parallel work."),
-    lines_per_service: z12.number().int().positive().max(500).optional().describe("Tail size per service; default 100, hard cap 500."),
-    since: z12.string().optional().describe('ISO-8601 timestamp or relative offset (e.g. "-5m", "-1h").'),
-    until: z12.string().optional().describe("ISO-8601 timestamp or relative offset upper bound."),
-    stream: z12.enum(["stdout", "stderr"]).optional().describe("Restrict to one stream."),
-    level: z12.enum(["stdout", "stderr", "trace", "debug", "info", "warn", "error", "fatal"]).optional().describe("Structured log level filter (same as get_service_logs)."),
-    search: z12.string().max(100).optional().describe("Case-insensitive substring filter."),
-    count_only: z12.boolean().optional().describe("When true, return only counts per service \u2014 skips the log payload.")
+    service_ids: z13.array(z13.string()).min(1).max(10).describe("Service publicIds (1\u201310). Hard cap 10 to bound parallel work."),
+    lines_per_service: z13.number().int().positive().max(500).optional().describe("Tail size per service; default 100, hard cap 500."),
+    since: z13.string().optional().describe('ISO-8601 timestamp or relative offset (e.g. "-5m", "-1h").'),
+    until: z13.string().optional().describe("ISO-8601 timestamp or relative offset upper bound."),
+    stream: z13.enum(["stdout", "stderr"]).optional().describe("Restrict to one stream."),
+    level: z13.enum(["stdout", "stderr", "trace", "debug", "info", "warn", "error", "fatal"]).optional().describe("Structured log level filter (same as get_service_logs)."),
+    search: z13.string().max(100).optional().describe("Case-insensitive substring filter."),
+    count_only: z13.boolean().optional().describe("When true, return only counts per service \u2014 skips the log payload.")
   },
   handler: async (args, ctx) => {
     const teamId = await ctx.resolveTeamId();
@@ -2111,7 +2408,7 @@ defineTool({
 });
 
 // src/tools/volumes.ts
-import { z as z13 } from "zod";
+import { z as z14 } from "zod";
 defineTool({
   name: "list_volumes",
   category: "volumes",
@@ -2128,7 +2425,7 @@ defineTool({
     'Example: list_volumes({ service_id: "svc_abc" }) \u2192 { items: [{ name: "data", mountPath: "/var/data", sizeGb: 10, status: "active" }] }'
   ].join("\n"),
   input: {
-    service_id: z13.string().describe("Service publicId (e.g. svc_abc123).")
+    service_id: z14.string().describe("Service publicId (e.g. svc_abc123).")
   },
   handler: async (args, ctx) => {
     const teamId = await ctx.resolveTeamId();
@@ -2157,10 +2454,10 @@ defineTool({
     '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: z13.string().describe("Service publicId."),
-    name: z13.string().min(1).max(64).regex(/^[a-z0-9-]+$/).describe("Volume name (lowercase alphanumeric + hyphens)."),
-    mount_path: z13.string().startsWith("/").max(500).describe("In-container mount path (absolute)."),
-    size_gb: z13.number().int().min(1).max(100).optional().describe("Disk size in GB (default 1, max 100).")
+    service_id: z14.string().describe("Service publicId."),
+    name: z14.string().min(1).max(64).regex(/^[a-z0-9-]+$/).describe("Volume name (lowercase alphanumeric + hyphens)."),
+    mount_path: z14.string().startsWith("/").max(500).describe("In-container mount path (absolute)."),
+    size_gb: z14.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();
@@ -2196,10 +2493,10 @@ defineTool({
     'Example: update_volume({ service_id: "svc_abc", volume_id: "vol_xyz", size_gb: 20 }) \u2192 { volume: { sizeGb: 20, \u2026 } }'
   ].join("\n"),
   input: {
-    service_id: z13.string().describe("Service publicId."),
-    volume_id: z13.string().describe("Volume publicId (e.g. vol_\u2026)."),
-    mount_path: z13.string().startsWith("/").max(500).optional().describe("New mount path."),
-    size_gb: z13.number().int().min(1).max(100).optional().describe("New size in GB.")
+    service_id: z14.string().describe("Service publicId."),
+    volume_id: z14.string().describe("Volume publicId (e.g. vol_\u2026)."),
+    mount_path: z14.string().startsWith("/").max(500).optional().describe("New mount path."),
+    size_gb: z14.number().int().min(1).max(100).optional().describe("New size in GB.")
   },
   handler: async (args, ctx) => {
     const teamId = await ctx.resolveTeamId();
@@ -2237,8 +2534,8 @@ defineTool({
     'Example: delete_volume({ service_id: "svc_abc", volume_id: "vol_xyz" }) \u2192 { ok: true }'
   ].join("\n"),
   input: {
-    service_id: z13.string().describe("Service publicId."),
-    volume_id: z13.string().describe("Volume publicId.")
+    service_id: z14.string().describe("Service publicId."),
+    volume_id: z14.string().describe("Volume publicId.")
   },
   handler: async (args, ctx) => {
     const teamId = await ctx.resolveTeamId();
@@ -2252,7 +2549,7 @@ defineTool({
 
 // src/server-factory.ts
 var PACKAGE_NAME = "hoststack";
-var PACKAGE_VERSION = "0.1.2";
+var PACKAGE_VERSION = "0.6.0";
 function createMcpServer(options) {
   const baseUrl = (options.baseUrl ?? "https://hoststack.dev").replace(/\/$/, "");
   const hoststack = new HostStack({ apiKey: options.apiKey, baseUrl });