@hoststack.dev/mcp 0.6.1 → 0.8.0

package/dist/index.js

@@ -487,21 +487,31 @@ defineTool({
     "",
     'By default events are AGGREGATED by (action, resourceId) so flapping events collapse to one row with a fire count + first/last timestamps \u2014 e.g. "service.auto_restarted on service 31, 8 times in the last hour, last at 14:22". Pass aggregate=false to see every raw row.',
     "",
+    'ACTIVE vs HISTORICAL (v89): each aggregated entry now has an `active` boolean and a `lastResolvedAt` timestamp. `active=true` means the most recent occurrence has NOT been resolved \u2014 the alert is still on fire. The default `active=true` filter hides resolved/historical alerts so triage starts with "what is broken right now". Pass `active=false` to include resolved entries too (useful for post-mortems). Resolution is automatic for some alert kinds \u2014 e.g. `deploy.failed_consecutive` is cleared when the next deploy of the same service goes live.',
+    "",
+    'Database backup_failed entries (v89) include `containerStatus` / `containerHealth` / `containerExitCode` in lastMetadata when the agent could resolve the container at failure time, so you can tell "Redis is overloaded" apart from "Redis is restarting" without a second tool call.',
+    "",
+    "Deploy.failed_consecutive entries (v89) carry the offending `commitHash` in lastMetadata, and the streak now dedupes per (service, commitHash) \u2014 one critical per bad commit, not one every 6 retries.",
+    "",
     "Inputs (all optional):",
     '  - since: ISO-8601 timestamp OR relative offset like "-1h" / "-2d". Default: -24h.',
     "  - until: ISO-8601 upper bound (ignored when aggregating \u2014 aggregated view always extends to now).",
     "  - limit: max rows (default 100, hard cap 500).",
     "  - aggregate: true (default) collapses by (action, resourceId); false returns raw rows.",
+    "  - active: true (default) shows only alerts that are still on fire (resolved_at IS NULL on the most recent row). false includes resolved historical alerts.",
     "",
-    "Returns: { alerts: Array, aggregated: boolean }. Each aggregated entry includes action, resourceType, resourceId, severity, count, firstFiredAt, lastFiredAt, lastMetadata. Each raw entry includes id, action, resourceType, resourceId, severity, metadata, createdAt.",
+    "Returns: { alerts: Array, aggregated: boolean, activeOnly: boolean }. Each aggregated entry includes action, resourceType, resourceId, severity, count, firstFiredAt, lastFiredAt, lastResolvedAt (nullable), active (boolean), lastMetadata. Each raw entry adds resolvedAt (nullable).",
     "",
-    "Example: list_alerts({ since: '-1h' }) \u2192 { alerts: [{ action: 'deploy.failed', resourceId: 31, severity: 'error', count: 3, lastFiredAt: '\u2026', \u2026 }] }."
+    "Example: list_alerts({ since: '-1h' }) \u2192 { alerts: [{ action: 'deploy.failed_consecutive', resourceId: 31, severity: 'critical', active: true, count: 3, lastFiredAt: '\u2026', lastResolvedAt: null, lastMetadata: { commitHash: 'abc1234' }, \u2026 }] }."
   ].join("\n"),
   input: {
     since: z3.string().optional().describe('ISO-8601 timestamp or relative offset (e.g. "-1h", "-2d"). Default: -24h.'),
     until: z3.string().optional().describe("ISO-8601 upper bound. Only honored when aggregate=false."),
     limit: z3.number().int().positive().max(500).optional().describe("Max rows (default 100, hard cap 500)."),
-    aggregate: z3.boolean().optional().describe("Collapse by (action, resourceId). Default true.")
+    aggregate: z3.boolean().optional().describe("Collapse by (action, resourceId). Default true."),
+    active: z3.boolean().optional().describe(
+      "Only return alerts still on fire (resolved_at IS NULL on the most recent row). Default true. Pass false to include resolved historical alerts."
+    )
   },
   handler: async (args, ctx) => {
     const teamId = await ctx.resolveTeamId();
@@ -510,11 +520,13 @@ defineTool({
     if (args.until !== void 0) params["until"] = args.until;
     if (args.limit !== void 0) params["limit"] = String(args.limit);
     if (args.aggregate === false) params["aggregate"] = "0";
+    if (args.active === false) params["active"] = "0";
     const response = await ctx.api.get(`/api/alerts/${teamId}`, params);
     const items = Array.isArray(response.alerts) ? response.alerts.map(shape) : [];
     const aggregated = Boolean(response.aggregated);
-    const summary = items.length === 0 ? "No alerts in the requested window \u2014 everything is operating normally." : aggregated ? `Returned ${items.length} alert group${items.length === 1 ? "" : "s"} (flapping events collapsed).` : `Returned ${items.length} raw alert event${items.length === 1 ? "" : "s"}.`;
-    return respond({ summary, data: { alerts: items, aggregated } });
+    const activeOnly = args.active !== false;
+    const summary = items.length === 0 ? activeOnly ? "No active alerts in the requested window \u2014 everything is operating normally." : "No alerts in the requested window (active or resolved)." : aggregated ? `Returned ${items.length} alert group${items.length === 1 ? "" : "s"}${activeOnly ? " (active only \u2014 pass active=false for resolved history)" : ""} (flapping events collapsed).` : `Returned ${items.length} raw alert event${items.length === 1 ? "" : "s"}.`;
+    return respond({ summary, data: { alerts: items, aggregated, activeOnly } });
   }
 });
 
@@ -617,7 +629,7 @@ defineTool({
     "Inputs:",
     '  - database_id: publicId of the database (e.g. "db_\u2026").',
     "  - name (optional): new database name.",
-    '  - plan (optional): "free" | "starter" | "standard" | "pro" \u2014 changes memory tier.',
+    '  - plan (optional): "free" | "micro" | "starter" | "standard" | "pro" \u2014 changes memory tier.',
     "  - disk_size_gb (optional): new disk size in GB (must be \u2265 current).",
     "",
     "Returns: { database: Database } \u2014 the updated record.",
@@ -627,7 +639,7 @@ defineTool({
   input: {
     database_id: z5.string().describe("Database publicId (e.g. db_xyz)."),
     name: z5.string().min(1).max(100).optional().describe("New database name."),
-    plan: z5.enum(["free", "starter", "standard", "pro"]).optional().describe("Plan tier (memory/CPU)."),
+    plan: z5.enum(["free", "micro", "starter", "standard", "pro"]).optional().describe("Plan tier (memory/CPU)."),
     disk_size_gb: z5.number().int().min(1).max(1024).optional().describe("New disk size in GB. Must be \u2265 current.")
   },
   handler: async (args, ctx) => {
@@ -672,6 +684,45 @@ defineTool({
     return respond({ summary: `Database ${args.database_id} (${type}) is ${status}.`, data });
   }
 });
+defineTool({
+  name: "query_database",
+  category: "databases",
+  description: [
+    "Run a single READ-ONLY SQL statement against a managed Postgres database.",
+    "",
+    "When to use: ad-hoc data inspection \u2014 checking row counts, sampling rows, debugging a constraint. For schema changes or seed data, ship a Drizzle migration instead.",
+    "",
+    "Safety model (server-side, not bypassable):",
+    '  - Wrapped in `BEGIN TRANSACTION READ ONLY` \u2014 INSERT/UPDATE/DELETE/DDL fail with a clear "cannot execute \u2026 in a read-only transaction" error.',
+    "  - 30s statement_timeout \u2014 runaway queries are killed.",
+    "  - 1000-row cap; result CSV is also size-capped at 1 MiB. Both surface via `truncated: true`.",
+    "  - Postgres engine only (v1). Other engines return a 400.",
+    "  - Single statement only; no embedded `;` and no psql meta-commands (`\\\u2026`).",
+    '  - Every call is audit-logged (success or failure) as `database.query` so an admin can answer "who queried this DB, when, with what SQL".',
+    "",
+    "Inputs:",
+    `  - database_id: publicId of the postgres database (e.g. "db_\u2026"). Resolved via the SDK's publicId helper.`,
+    "  - sql: a single SELECT/WITH/SHOW/EXPLAIN statement, no trailing `;`. Max 16 KiB.",
+    "",
+    "Returns: { columns: string[], rows: string[][], rowCount: number, truncated: boolean, durationMs: number }. Values come back as strings (psql --csv); cast on the caller side when needed.",
+    "",
+    "Examples:",
+    '  - query_database({ database_id: "db_abc", sql: "SELECT count(*) FROM users" }) \u2192 { columns: ["count"], rows: [["1234"]], \u2026 }',
+    `  - query_database({ database_id: "db_abc", sql: "SELECT id, email FROM users WHERE created_at > now() - interval '1 day' LIMIT 50" })`
+  ].join("\n"),
+  input: {
+    database_id: z5.string().describe("Database publicId (e.g. db_abc)."),
+    sql: z5.string().min(1).max(16384).describe(
+      "A single READ-ONLY SQL statement. No trailing `;`, no embedded `;`, no psql meta-commands."
+    )
+  },
+  handler: async (args, ctx) => {
+    const teamId = await ctx.resolveTeamId();
+    const result = await ctx.hoststack.databases.query(teamId, args.database_id, args.sql);
+    const summary = result.truncated ? `Query returned ${result.rowCount} row${result.rowCount === 1 ? "" : "s"} (truncated; raise LIMIT if needed) in ${result.durationMs}ms.` : `Query returned ${result.rowCount} row${result.rowCount === 1 ? "" : "s"} in ${result.durationMs}ms.`;
+    return respond({ summary, data: result });
+  }
+});
 
 // src/tools/deploys.ts
 import { z as z6 } from "zod";
@@ -686,7 +737,7 @@ defineTool({
     "Inputs:",
     '  - service_id: publicId of the service (e.g. "svc_abc123"). Use list_services to find it.',
     "",
-    "Returns: { items: Deploy[] } \u2014 each deploy includes id, publicId, status (pending|building|deploying|live|failed|cancelled), commitSha, commitMessage, branch, triggeredBy, startedAt, finishedAt, buildDurationMs (just the docker build / image-pull step), totalDurationMs (full deploy wall-clock = finishedAt \u2212 startedAt).",
+    'Returns: { items: Deploy[] } \u2014 each deploy includes id, publicId, status (pending|building|deploying|live|failed|cancelled), commitSha, commitMessage, branch, triggeredBy, startedAt, finishedAt, imageBuildMs (docker build / image-pull only; null on skip-build redeploys \u2014 v89), containerBootMs (deploying \u2192 live wall-clock; null on builds that failed before container start \u2014 v89), buildDurationMs (legacy alias of imageBuildMs kept for back-compat), totalDurationMs (full deploy wall-clock = finishedAt \u2212 startedAt). Use imageBuildMs + containerBootMs together to tell "build is slow" apart from "boot is slow".',
     "",
     'Example: list_deploys({ service_id: "svc_abc" }) \u2192 { items: [{ publicId: "dpl_\u2026", status: "live", commitMessage: "Fix login", \u2026 }, \u2026] }'
   ].join("\n"),
@@ -713,7 +764,7 @@ defineTool({
     "  - service_id: publicId of the service.",
     '  - deploy_id: publicId of the deploy (e.g. "dpl_\u2026").',
     "",
-    "Returns: { deploy: Deploy } \u2014 full deploy record (status, commitSha, commitMessage, branch, buildDurationMs, totalDurationMs, finishedAt, etc).",
+    "Returns: { deploy: Deploy } \u2014 full deploy record (status, commitSha, commitMessage, branch, imageBuildMs + containerBootMs (v89 split timings; legacy buildDurationMs preserved as alias), totalDurationMs, finishedAt, etc).",
     "",
     'Example: get_deploy({ service_id: "svc_abc", deploy_id: "dpl_xyz" }) \u2192 { deploy: { status: "live", \u2026 } }'
   ].join("\n"),
@@ -1707,7 +1758,9 @@ defineTool({
     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.")
+    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();