@hotmeshio/long-tail 0.4.22 → 0.4.24

package/build/services/overview/index.d.ts

@@ -0,0 +1,78 @@
+/**
+ * System overview — one call, complete picture.
+ *
+ * Composes triage, throughput, trends, infrastructure, and process
+ * metrics from lt_* tables. All queries run in parallel. No HotMesh
+ * schema dependencies — safe regardless of engine initialization state.
+ */
+export interface SystemOverview {
+    period: string;
+    triage: {
+        pending: number;
+        claimed: number;
+        unclaimed: number;
+        aging_30m: number;
+        aging_1h: number;
+        aging_24h: number;
+        oldest_unclaimed_minutes: number;
+        created_period: number;
+        resolved_period: number;
+        resolution_rate_pct: number;
+        by_role: Array<{
+            role: string;
+            pending: number;
+            claimed: number;
+        }>;
+    };
+    throughput: {
+        tasks_pending: number;
+        tasks_in_progress: number;
+        tasks_failed: number;
+        tasks_created_1h: number;
+        tasks_completed_1h: number;
+        tasks_created_period: number;
+        tasks_completed_period: number;
+        tasks_failed_1h: number;
+    };
+    trends: {
+        escalation_creation: Array<{
+            hour: string;
+            created: number;
+        }>;
+        task_completion: Array<{
+            hour: string;
+            completed: number;
+        }>;
+        resolution_velocity: Array<{
+            hour: string;
+            created: number;
+            resolved: number;
+        }>;
+    };
+    infrastructure: {
+        mcp_servers: {
+            total: number;
+            connected: number;
+            total_tools: number;
+        };
+        compiled_workflows: {
+            total: number;
+            active: number;
+        };
+        agents: {
+            total: number;
+            active: number;
+            paused: number;
+            error: number;
+            stale: number;
+        };
+        workflow_configs: number;
+    };
+    processes: {
+        total: number;
+        active: number;
+        completed: number;
+        escalated: number;
+    };
+}
+export declare function getSystemOverview(period?: string): Promise<SystemOverview>;

package/build/services/overview/index.js

@@ -0,0 +1,105 @@
+"use strict";
+/**
+ * System overview — one call, complete picture.
+ *
+ * Composes triage, throughput, trends, infrastructure, and process
+ * metrics from lt_* tables. All queries run in parallel. No HotMesh
+ * schema dependencies — safe regardless of engine initialization state.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getSystemOverview = getSystemOverview;
+const db_1 = require("../../lib/db");
+const sql_1 = require("./sql");
+const VALID_PERIODS = {
+    '1h': '1 hour',
+    '24h': '24 hours',
+    '7d': '7 days',
+};
+async function getSystemOverview(period = '24h') {
+    const interval = VALID_PERIODS[period] ?? VALID_PERIODS['24h'];
+    const pool = (0, db_1.getPool)();
+    // Every query is individually guarded — a single table failure
+    // (e.g., during migration) must not crash the entire overview.
+    const empty = { rows: [] };
+    const [escTriage, escByRole, taskThroughput, escTrends, taskTrends, resTrends, mcpInfra, compiledWf, agentHealth, wfConfigs, processSummary,] = await Promise.all([
+        pool.query(sql_1.OVERVIEW_ESCALATION_TRIAGE, [interval]).catch(() => empty),
+        pool.query(sql_1.OVERVIEW_ESCALATION_BY_ROLE).catch(() => empty),
+        pool.query(sql_1.OVERVIEW_TASK_THROUGHPUT, [interval]).catch(() => empty),
+        pool.query(sql_1.OVERVIEW_ESCALATION_TRENDS, [interval]).catch(() => empty),
+        pool.query(sql_1.OVERVIEW_TASK_TRENDS, [interval]).catch(() => empty),
+        pool.query(sql_1.OVERVIEW_RESOLUTION_TRENDS, [interval]).catch(() => empty),
+        pool.query(sql_1.OVERVIEW_MCP_INFRASTRUCTURE).catch(() => empty),
+        pool.query(sql_1.OVERVIEW_COMPILED_WORKFLOWS).catch(() => empty),
+        pool.query(sql_1.OVERVIEW_AGENT_HEALTH).catch(() => empty),
+        pool.query(sql_1.OVERVIEW_WORKFLOW_CONFIGS).catch(() => empty),
+        pool.query(sql_1.OVERVIEW_PROCESS_SUMMARY, [interval]).catch(() => empty),
+    ]);
+    const ZEROS = { pending: 0, claimed: 0, unclaimed: 0, aging_30m: 0, aging_1h: 0, aging_24h: 0, oldest_unclaimed_minutes: 0, created_period: 0, resolved_period: 0, in_progress: 0, failed: 0, created_1h: 0, completed_1h: 0, created_period_t: 0, completed_period: 0, failed_1h: 0, total: 0, connected: 0, total_tools: 0, active: 0, paused: 0, error: 0, stale: 0, completed: 0, escalated: 0 };
+    const esc = escTriage.rows[0] ?? ZEROS;
+    const task = taskThroughput.rows[0] ?? ZEROS;
+    const mcp = mcpInfra.rows[0] ?? ZEROS;
+    const compiled = compiledWf.rows[0] ?? ZEROS;
+    const agents = agentHealth.rows[0] ?? ZEROS;
+    const configs = wfConfigs.rows[0] ?? ZEROS;
+    const procs = processSummary.rows[0] ?? ZEROS;
+    const createdPeriod = esc.created_period || 0;
+    const resolvedPeriod = esc.resolved_period || 0;
+    const resolutionRate = createdPeriod > 0
+        ? Math.round((resolvedPeriod / createdPeriod) * 100)
+        : 0;
+    return {
+        period,
+        triage: {
+            pending: esc.pending,
+            claimed: esc.claimed,
+            unclaimed: esc.unclaimed,
+            aging_30m: esc.aging_30m,
+            aging_1h: esc.aging_1h,
+            aging_24h: esc.aging_24h,
+            oldest_unclaimed_minutes: esc.oldest_unclaimed_minutes,
+            created_period: createdPeriod,
+            resolved_period: resolvedPeriod,
+            resolution_rate_pct: resolutionRate,
+            by_role: escByRole.rows,
+        },
+        throughput: {
+            tasks_pending: task.pending,
+            tasks_in_progress: task.in_progress,
+            tasks_failed: task.failed,
+            tasks_created_1h: task.created_1h,
+            tasks_completed_1h: task.completed_1h,
+            tasks_created_period: task.created_period,
+            tasks_completed_period: task.completed_period,
+            tasks_failed_1h: task.failed_1h,
+        },
+        trends: {
+            escalation_creation: escTrends.rows.map((r) => ({
+                hour: r.hour, created: r.created,
+            })),
+            task_completion: taskTrends.rows.map((r) => ({
+                hour: r.hour, completed: r.completed,
+            })),
+            // Filter out zero-activity hours to keep MCP responses compact
+            resolution_velocity: resTrends.rows
+                .filter((r) => r.created > 0 || r.resolved > 0)
+                .map((r) => ({
+                hour: r.hour, created: r.created, resolved: r.resolved,
+            })),
+        },
+        infrastructure: {
+            mcp_servers: { total: mcp.total, connected: mcp.connected, total_tools: mcp.total_tools },
+            compiled_workflows: { total: compiled.total, active: compiled.active },
+            agents: {
+                total: agents.total, active: agents.active,
+                paused: agents.paused, error: agents.error, stale: agents.stale,
+            },
+            workflow_configs: configs.total,
+        },
+        processes: {
+            total: procs.total,
+            active: procs.active,
+            completed: procs.completed,
+            escalated: procs.escalated,
+        },
+    };
+}

package/build/services/overview/sql.d.ts

@@ -0,0 +1,29 @@
+/**
+ * SQL for the system overview tool.
+ *
+ * All queries are SELECT-only, read-safe, and index-backed.
+ * They target only lt_* tables — no HotMesh schema dependencies.
+ * $1 is always the period interval (e.g., '24 hours').
+ */
+/** Escalation queue pressure — aging buckets, claim status, period counts. */
+export declare const OVERVIEW_ESCALATION_TRIAGE = "\n  SELECT\n    COUNT(*) FILTER (WHERE status = 'pending')::int AS pending,\n    COUNT(*) FILTER (WHERE status = 'pending'\n      AND assigned_to IS NOT NULL AND assigned_until > NOW())::int AS claimed,\n    COUNT(*) FILTER (WHERE status = 'pending'\n      AND (assigned_to IS NULL OR assigned_until <= NOW()))::int AS unclaimed,\n    COUNT(*) FILTER (WHERE status = 'pending'\n      AND created_at < NOW() - INTERVAL '30 minutes')::int AS aging_30m,\n    COUNT(*) FILTER (WHERE status = 'pending'\n      AND created_at < NOW() - INTERVAL '1 hour')::int AS aging_1h,\n    COUNT(*) FILTER (WHERE status = 'pending'\n      AND created_at < NOW() - INTERVAL '24 hours')::int AS aging_24h,\n    COALESCE(\n      EXTRACT(EPOCH FROM (NOW() - MIN(created_at) FILTER (\n        WHERE status = 'pending'\n        AND (assigned_to IS NULL OR assigned_until <= NOW())\n      )))::int / 60, 0\n    ) AS oldest_unclaimed_minutes,\n    COUNT(*) FILTER (WHERE created_at > NOW() - $1::interval)::int AS created_period,\n    COUNT(*) FILTER (WHERE resolved_at > NOW() - $1::interval)::int AS resolved_period\n  FROM lt_escalations";
+/** Escalation breakdown by role (pending only). */
+export declare const OVERVIEW_ESCALATION_BY_ROLE = "\n  SELECT role,\n    COUNT(*)::int AS pending,\n    COUNT(*) FILTER (WHERE assigned_to IS NOT NULL AND assigned_until > NOW())::int AS claimed\n  FROM lt_escalations\n  WHERE status = 'pending'\n  GROUP BY role\n  ORDER BY COUNT(*) DESC\n  LIMIT 10";
+/** Task creation and completion counts for 1h and the configurable period. */
+export declare const OVERVIEW_TASK_THROUGHPUT = "\n  SELECT\n    COUNT(*) FILTER (WHERE status = 'pending')::int AS pending,\n    COUNT(*) FILTER (WHERE status = 'in_progress')::int AS in_progress,\n    COUNT(*) FILTER (WHERE status = 'failed')::int AS failed,\n    COUNT(*) FILTER (WHERE created_at > NOW() - INTERVAL '1 hour')::int AS created_1h,\n    COUNT(*) FILTER (WHERE completed_at > NOW() - INTERVAL '1 hour')::int AS completed_1h,\n    COUNT(*) FILTER (WHERE created_at > NOW() - $1::interval)::int AS created_period,\n    COUNT(*) FILTER (WHERE completed_at > NOW() - $1::interval)::int AS completed_period,\n    COUNT(*) FILTER (WHERE status = 'failed'\n      AND created_at > NOW() - INTERVAL '1 hour')::int AS failed_1h\n  FROM lt_tasks";
+/** Hourly escalation creation within the period. */
+export declare const OVERVIEW_ESCALATION_TRENDS = "\n  SELECT date_trunc('hour', created_at) AS hour, COUNT(*)::int AS created\n  FROM lt_escalations\n  WHERE created_at > NOW() - $1::interval\n  GROUP BY 1 ORDER BY 1";
+/** Hourly task completion within the period. */
+export declare const OVERVIEW_TASK_TRENDS = "\n  SELECT date_trunc('hour', completed_at) AS hour, COUNT(*)::int AS completed\n  FROM lt_tasks\n  WHERE completed_at IS NOT NULL AND completed_at > NOW() - $1::interval\n  GROUP BY 1 ORDER BY 1";
+/** Hourly resolution velocity — created vs resolved. */
+export declare const OVERVIEW_RESOLUTION_TRENDS = "\n  SELECT\n    gs AS hour,\n    COALESCE(c.created, 0)::int AS created,\n    COALESCE(r.resolved, 0)::int AS resolved\n  FROM generate_series(\n    date_trunc('hour', NOW() - $1::interval),\n    date_trunc('hour', NOW()),\n    INTERVAL '1 hour'\n  ) AS gs\n  LEFT JOIN (\n    SELECT date_trunc('hour', created_at) AS h, COUNT(*)::int AS created\n    FROM lt_escalations WHERE created_at > NOW() - $1::interval\n    GROUP BY 1\n  ) c ON c.h = gs\n  LEFT JOIN (\n    SELECT date_trunc('hour', resolved_at) AS h, COUNT(*)::int AS resolved\n    FROM lt_escalations WHERE resolved_at > NOW() - $1::interval\n    GROUP BY 1\n  ) r ON r.h = gs\n  ORDER BY gs";
+/** MCP server and tool counts. */
+export declare const OVERVIEW_MCP_INFRASTRUCTURE = "\n  SELECT\n    COUNT(*)::int AS total,\n    COUNT(*) FILTER (WHERE status = 'connected')::int AS connected,\n    COALESCE(SUM(jsonb_array_length(tool_manifest)) FILTER (WHERE tool_manifest IS NOT NULL), 0)::int AS total_tools\n  FROM lt_mcp_servers";
+/** Compiled workflow counts. */
+export declare const OVERVIEW_COMPILED_WORKFLOWS = "\n  SELECT\n    COUNT(*)::int AS total,\n    COUNT(*) FILTER (WHERE status = 'active')::int AS active\n  FROM lt_yaml_workflows";
+/** Agent health snapshot. */
+export declare const OVERVIEW_AGENT_HEALTH = "\n  SELECT\n    COUNT(*)::int AS total,\n    COUNT(*) FILTER (WHERE status = 'active')::int AS active,\n    COUNT(*) FILTER (WHERE status = 'paused')::int AS paused,\n    COUNT(*) FILTER (WHERE status = 'error')::int AS error,\n    COUNT(*) FILTER (WHERE last_run_at IS NULL\n      OR last_run_at < NOW() - INTERVAL '7 days')::int AS stale\n  FROM lt_agents";
+/** Registered workflow config count. */
+export declare const OVERVIEW_WORKFLOW_CONFIGS = "\n  SELECT COUNT(*)::int AS total FROM lt_config_workflows";
+/** Process summary — grouped by origin_id within the period. */
+export declare const OVERVIEW_PROCESS_SUMMARY = "\n  SELECT\n    COUNT(DISTINCT origin_id)::int AS total,\n    COUNT(DISTINCT origin_id) FILTER (\n      WHERE status IN ('pending', 'in_progress'))::int AS active,\n    COUNT(DISTINCT origin_id) FILTER (\n      WHERE status = 'completed')::int AS completed,\n    COUNT(DISTINCT origin_id) FILTER (\n      WHERE status = 'needs_intervention')::int AS escalated\n  FROM lt_tasks\n  WHERE origin_id IS NOT NULL\n    AND created_at > NOW() - $1::interval";

package/build/services/overview/sql.js

@@ -0,0 +1,134 @@
+"use strict";
+/**
+ * SQL for the system overview tool.
+ *
+ * All queries are SELECT-only, read-safe, and index-backed.
+ * They target only lt_* tables — no HotMesh schema dependencies.
+ * $1 is always the period interval (e.g., '24 hours').
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OVERVIEW_PROCESS_SUMMARY = exports.OVERVIEW_WORKFLOW_CONFIGS = exports.OVERVIEW_AGENT_HEALTH = exports.OVERVIEW_COMPILED_WORKFLOWS = exports.OVERVIEW_MCP_INFRASTRUCTURE = exports.OVERVIEW_RESOLUTION_TRENDS = exports.OVERVIEW_TASK_TRENDS = exports.OVERVIEW_ESCALATION_TRENDS = exports.OVERVIEW_TASK_THROUGHPUT = exports.OVERVIEW_ESCALATION_BY_ROLE = exports.OVERVIEW_ESCALATION_TRIAGE = void 0;
+// ── Triage ──────────────────────────────────────────────────────────────────
+/** Escalation queue pressure — aging buckets, claim status, period counts. */
+exports.OVERVIEW_ESCALATION_TRIAGE = `
+  SELECT
+    COUNT(*) FILTER (WHERE status = 'pending')::int AS pending,
+    COUNT(*) FILTER (WHERE status = 'pending'
+      AND assigned_to IS NOT NULL AND assigned_until > NOW())::int AS claimed,
+    COUNT(*) FILTER (WHERE status = 'pending'
+      AND (assigned_to IS NULL OR assigned_until <= NOW()))::int AS unclaimed,
+    COUNT(*) FILTER (WHERE status = 'pending'
+      AND created_at < NOW() - INTERVAL '30 minutes')::int AS aging_30m,
+    COUNT(*) FILTER (WHERE status = 'pending'
+      AND created_at < NOW() - INTERVAL '1 hour')::int AS aging_1h,
+    COUNT(*) FILTER (WHERE status = 'pending'
+      AND created_at < NOW() - INTERVAL '24 hours')::int AS aging_24h,
+    COALESCE(
+      EXTRACT(EPOCH FROM (NOW() - MIN(created_at) FILTER (
+        WHERE status = 'pending'
+        AND (assigned_to IS NULL OR assigned_until <= NOW())
+      )))::int / 60, 0
+    ) AS oldest_unclaimed_minutes,
+    COUNT(*) FILTER (WHERE created_at > NOW() - $1::interval)::int AS created_period,
+    COUNT(*) FILTER (WHERE resolved_at > NOW() - $1::interval)::int AS resolved_period
+  FROM lt_escalations`;
+/** Escalation breakdown by role (pending only). */
+exports.OVERVIEW_ESCALATION_BY_ROLE = `
+  SELECT role,
+    COUNT(*)::int AS pending,
+    COUNT(*) FILTER (WHERE assigned_to IS NOT NULL AND assigned_until > NOW())::int AS claimed
+  FROM lt_escalations
+  WHERE status = 'pending'
+  GROUP BY role
+  ORDER BY COUNT(*) DESC
+  LIMIT 10`;
+// ── Throughput ───────────────────────────────────────────────────────────────
+/** Task creation and completion counts for 1h and the configurable period. */
+exports.OVERVIEW_TASK_THROUGHPUT = `
+  SELECT
+    COUNT(*) FILTER (WHERE status = 'pending')::int AS pending,
+    COUNT(*) FILTER (WHERE status = 'in_progress')::int AS in_progress,
+    COUNT(*) FILTER (WHERE status = 'failed')::int AS failed,
+    COUNT(*) FILTER (WHERE created_at > NOW() - INTERVAL '1 hour')::int AS created_1h,
+    COUNT(*) FILTER (WHERE completed_at > NOW() - INTERVAL '1 hour')::int AS completed_1h,
+    COUNT(*) FILTER (WHERE created_at > NOW() - $1::interval)::int AS created_period,
+    COUNT(*) FILTER (WHERE completed_at > NOW() - $1::interval)::int AS completed_period,
+    COUNT(*) FILTER (WHERE status = 'failed'
+      AND created_at > NOW() - INTERVAL '1 hour')::int AS failed_1h
+  FROM lt_tasks`;
+// ── Trends ──────────────────────────────────────────────────────────────────
+/** Hourly escalation creation within the period. */
+exports.OVERVIEW_ESCALATION_TRENDS = `
+  SELECT date_trunc('hour', created_at) AS hour, COUNT(*)::int AS created
+  FROM lt_escalations
+  WHERE created_at > NOW() - $1::interval
+  GROUP BY 1 ORDER BY 1`;
+/** Hourly task completion within the period. */
+exports.OVERVIEW_TASK_TRENDS = `
+  SELECT date_trunc('hour', completed_at) AS hour, COUNT(*)::int AS completed
+  FROM lt_tasks
+  WHERE completed_at IS NOT NULL AND completed_at > NOW() - $1::interval
+  GROUP BY 1 ORDER BY 1`;
+/** Hourly resolution velocity — created vs resolved. */
+exports.OVERVIEW_RESOLUTION_TRENDS = `
+  SELECT
+    gs AS hour,
+    COALESCE(c.created, 0)::int AS created,
+    COALESCE(r.resolved, 0)::int AS resolved
+  FROM generate_series(
+    date_trunc('hour', NOW() - $1::interval),
+    date_trunc('hour', NOW()),
+    INTERVAL '1 hour'
+  ) AS gs
+  LEFT JOIN (
+    SELECT date_trunc('hour', created_at) AS h, COUNT(*)::int AS created
+    FROM lt_escalations WHERE created_at > NOW() - $1::interval
+    GROUP BY 1
+  ) c ON c.h = gs
+  LEFT JOIN (
+    SELECT date_trunc('hour', resolved_at) AS h, COUNT(*)::int AS resolved
+    FROM lt_escalations WHERE resolved_at > NOW() - $1::interval
+    GROUP BY 1
+  ) r ON r.h = gs
+  ORDER BY gs`;
+// ── Infrastructure ──────────────────────────────────────────────────────────
+/** MCP server and tool counts. */
+exports.OVERVIEW_MCP_INFRASTRUCTURE = `
+  SELECT
+    COUNT(*)::int AS total,
+    COUNT(*) FILTER (WHERE status = 'connected')::int AS connected,
+    COALESCE(SUM(jsonb_array_length(tool_manifest)) FILTER (WHERE tool_manifest IS NOT NULL), 0)::int AS total_tools
+  FROM lt_mcp_servers`;
+/** Compiled workflow counts. */
+exports.OVERVIEW_COMPILED_WORKFLOWS = `
+  SELECT
+    COUNT(*)::int AS total,
+    COUNT(*) FILTER (WHERE status = 'active')::int AS active
+  FROM lt_yaml_workflows`;
+/** Agent health snapshot. */
+exports.OVERVIEW_AGENT_HEALTH = `
+  SELECT
+    COUNT(*)::int AS total,
+    COUNT(*) FILTER (WHERE status = 'active')::int AS active,
+    COUNT(*) FILTER (WHERE status = 'paused')::int AS paused,
+    COUNT(*) FILTER (WHERE status = 'error')::int AS error,
+    COUNT(*) FILTER (WHERE last_run_at IS NULL
+      OR last_run_at < NOW() - INTERVAL '7 days')::int AS stale
+  FROM lt_agents`;
+/** Registered workflow config count. */
+exports.OVERVIEW_WORKFLOW_CONFIGS = `
+  SELECT COUNT(*)::int AS total FROM lt_config_workflows`;
+// ── Processes ───────────────────────────────────────────────────────────────
+/** Process summary — grouped by origin_id within the period. */
+exports.OVERVIEW_PROCESS_SUMMARY = `
+  SELECT
+    COUNT(DISTINCT origin_id)::int AS total,
+    COUNT(DISTINCT origin_id) FILTER (
+      WHERE status IN ('pending', 'in_progress'))::int AS active,
+    COUNT(DISTINCT origin_id) FILTER (
+      WHERE status = 'completed')::int AS completed,
+    COUNT(DISTINCT origin_id) FILTER (
+      WHERE status = 'needs_intervention')::int AS escalated
+  FROM lt_tasks
+  WHERE origin_id IS NOT NULL
+    AND created_at > NOW() - $1::interval`;

package/build/services/pipelines/queries.js

@@ -65,9 +65,12 @@ async function listJobs(params) {
     const where = conditions.length > 0 ? `WHERE ${conditions.join(' AND ')}` : '';
     const keyPrefix = `hmsh:${appId}:j:`;
     const orderBy = buildOrderBy(params.sort_by, params.order);
+    // Graceful degradation: HotMesh schema may not exist yet if no
+    // engine/worker has initialized. Return empty results, not 500.
+    const empty = { rows: [{ count: '0' }] };
     const [countResult, dataResult] = await Promise.all([
-        pool.query((0, sql_1.COUNT_JOBS)(schema, where), values),
-        pool.query((0, sql_1.LIST_JOBS)(schema, appId, where, idx++, idx++, orderBy), [...values, limit, offset]),
+        pool.query((0, sql_1.COUNT_JOBS)(schema, where), values).catch(() => empty),
+        pool.query((0, sql_1.LIST_JOBS)(schema, appId, where, idx++, idx++, orderBy), [...values, limit, offset]).catch(() => ({ rows: [] })),
     ]);
     const jobs = dataResult.rows.map((row) => ({
         workflow_id: row.key.startsWith(keyPrefix) ? row.key.slice(keyPrefix.length) : row.key,

package/build/services/pipelines/sql.d.ts

@@ -1,4 +1,3 @@
-export declare const DISTINCT_ENTITIES_DURABLE = "\n  SELECT DISTINCT entity FROM durable.jobs WHERE entity IS NOT NULL AND entity != '' ORDER BY entity";
 export declare const DISTINCT_ENTITIES: (schema: string) => string;
 export declare const ACTIVE_GRAPH_TOPICS = "SELECT DISTINCT graph_topic FROM lt_yaml_workflows WHERE app_id = $1 AND status IN ('active', 'deployed')";
 export declare const COUNT_JOBS: (schema: string, where: string) => string;

package/build/services/pipelines/sql.js

@@ -3,9 +3,7 @@
 // Schema placeholders (${schema}) are interpolated at call time
 // because Postgres does not support parameterized schema names.
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.LIST_JOBS = exports.GET_JOB_ATTRIBUTES = exports.GET_JOB = exports.COUNT_JOBS = exports.ACTIVE_GRAPH_TOPICS = exports.DISTINCT_ENTITIES = exports.DISTINCT_ENTITIES_DURABLE = void 0;
-exports.DISTINCT_ENTITIES_DURABLE = `
-  SELECT DISTINCT entity FROM durable.jobs WHERE entity IS NOT NULL AND entity != '' ORDER BY entity`;
+exports.LIST_JOBS = exports.GET_JOB_ATTRIBUTES = exports.GET_JOB = exports.COUNT_JOBS = exports.ACTIVE_GRAPH_TOPICS = exports.DISTINCT_ENTITIES = void 0;
 const DISTINCT_ENTITIES = (schema) => `SELECT DISTINCT entity FROM ${schema}.jobs WHERE entity IS NOT NULL AND entity != '' ORDER BY entity`;
 exports.DISTINCT_ENTITIES = DISTINCT_ENTITIES;
 exports.ACTIVE_GRAPH_TOPICS = `SELECT DISTINCT graph_topic FROM lt_yaml_workflows WHERE app_id = $1 AND status IN ('active', 'deployed')`;

package/build/system/mcp-servers/admin/controlplane.js

@@ -57,7 +57,7 @@ function registerControlPlaneTools(server) {
         inputSchema: schemas_1.rollCallSchema,
     }, async (args) => {
         const result = await api.rollCall({
-            appId: args.app_id || 'durable',
+            appId: args.app_id,
             delay: args.delay,
         });
         if (result.error) {

package/build/system/mcp-servers/admin/index.js

@@ -53,7 +53,8 @@ const pipelines_1 = require("./pipelines");
 const topics_1 = require("./topics");
 const settings_1 = require("./settings");
 const exports_1 = require("./exports");
-const TOOL_COUNT = 71;
+const overview_1 = require("./overview");
+const TOOL_COUNT = 72;
 let server = null;
 async function createAdminServer(options) {
     if (server && !options?.fresh)
@@ -79,7 +80,8 @@ async function createAdminServer(options) {
     (0, topics_1.registerTopicTools)(instance); //  5 tools
     (0, settings_1.registerSettingsTools)(instance); //  1 tool
     (0, exports_1.registerExportTools)(instance); //  4 tools
-    // Total: 71 (actual count may vary slightly)
+    (0, overview_1.registerOverviewTools)(instance); //  1 tool
+    // Total: 72
     logger_1.loggerRegistry.info(`[lt-mcp:admin] ${name} ready (${TOOL_COUNT} tools registered)`);
     return instance;
 }

package/build/system/mcp-servers/admin/maintenance.js

@@ -45,6 +45,7 @@ function registerMaintenanceTools(server) {
         inputSchema: schemas_1.pruneSchema,
     }, async (args) => {
         const result = await dbaService.prune({
+            appId: args.app_id,
             expire: args.expire,
             jobs: args.jobs,
             streams: args.streams,

package/build/system/mcp-servers/admin/overview.d.ts

@@ -0,0 +1,13 @@
+/**
+ * System overview tool — one call, complete picture.
+ */
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { z } from 'zod';
+export declare const systemOverviewSchema: z.ZodObject<{
+    period: z.ZodDefault<z.ZodOptional<z.ZodEnum<["1h", "24h", "7d"]>>>;
+}, "strip", z.ZodTypeAny, {
+    period: "24h" | "1h" | "7d";
+}, {
+    period?: "24h" | "1h" | "7d" | undefined;
+}>;
+export declare function registerOverviewTools(server: McpServer): void;

package/build/system/mcp-servers/admin/overview.js

@@ -0,0 +1,34 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.systemOverviewSchema = void 0;
+exports.registerOverviewTools = registerOverviewTools;
+const zod_1 = require("zod");
+const overview_1 = require("../../../services/overview");
+exports.systemOverviewSchema = zod_1.z.object({
+    period: zod_1.z.enum(['1h', '24h', '7d']).optional().default('24h')
+        .describe('Time window for trends and throughput metrics'),
+});
+function registerOverviewTools(server) {
+    server.registerTool('get_system_overview', {
+        title: 'Get System Overview',
+        description: 'Triage-ready system dashboard in one call. Returns escalation queue pressure ' +
+            '(aging, unclaimed, by role), task throughput (created/completed/failed), ' +
+            'hourly trends (escalation creation, task completion, resolution velocity), ' +
+            'infrastructure status (MCP servers, agents, compiled workflows), and ' +
+            'business process summary. Use this as the first call to understand system state.',
+        inputSchema: exports.systemOverviewSchema,
+    }, async (args) => {
+        try {
+            const overview = await (0, overview_1.getSystemOverview)(args.period);
+            return {
+                content: [{ type: 'text', text: JSON.stringify(overview) }],
+            };
+        }
+        catch (err) {
+            return {
+                content: [{ type: 'text', text: JSON.stringify({ error: err.message }) }],
+                isError: true,
+            };
+        }
+    });
+}

package/build/system/mcp-servers/admin/pipelines.js

@@ -44,7 +44,7 @@ function registerPipelineTools(server) {
             'with graph topics from compiled YAML workflows.',
         inputSchema: schemas_1.listPipelineEntitiesSchema,
     }, async (args) => {
-        const result = await api.listEntities({ app_id: args.app_id || 'durable' });
+        const result = await api.listEntities({ app_id: args.app_id });
         if (result.error) {
             return { content: [{ type: 'text', text: JSON.stringify({ error: result.error }) }], isError: true };
         }
@@ -56,7 +56,7 @@ function registerPipelineTools(server) {
         description: 'List pipeline jobs with optional entity, search, and status filters.',
         inputSchema: schemas_1.listPipelineJobsSchema,
     }, async (args) => {
-        const result = await api.listJobs({ ...args, app_id: args.app_id || 'durable' });
+        const result = await api.listJobs({ ...args, app_id: args.app_id });
         if (result.error) {
             return { content: [{ type: 'text', text: JSON.stringify({ error: result.error }) }], isError: true };
         }
@@ -70,7 +70,7 @@ function registerPipelineTools(server) {
     }, async (args) => {
         const result = await api.getJobExecution({
             jobId: args.job_id,
-            app_id: args.app_id || 'durable',
+            app_id: args.app_id,
         });
         if (result.error) {
             return { content: [{ type: 'text', text: JSON.stringify({ error: result.error }) }], isError: true };
@@ -86,7 +86,7 @@ function registerPipelineTools(server) {
         const result = await api.interruptJob({
             jobId: args.job_id,
             topic: args.topic,
-            app_id: args.app_id || 'durable',
+            app_id: args.app_id,
         });
         if (result.error) {
             return { content: [{ type: 'text', text: JSON.stringify({ error: result.error }) }], isError: true };