@hotmeshio/long-tail 0.4.23 → 0.5.0

package/build/api/overview.d.ts

@@ -0,0 +1,4 @@
+import type { LTApiResult } from '../types/sdk';
+export declare function overview(input: {
+    period?: string;
+}): Promise<LTApiResult>;

package/build/api/overview.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.overview = overview;
+const overview_1 = require("../services/overview");
+async function overview(input) {
+    try {
+        const data = await (0, overview_1.getSystemOverview)(input.period);
+        return { status: 200, data };
+    }
+    catch (err) {
+        return { status: 500, error: err.message };
+    }
+}

package/build/lib/db/schemas/011_escalation_index_audit.sql

@@ -0,0 +1,50 @@
+-- ─── lt_escalations index audit ────────────────────────────────────────────
+--
+-- Motivation (hotmesh 0.20.0, PR perf/claim-path-hotspots):
+--   Each stream/queue row pays index maintenance on every INSERT and on every
+--   non-HOT UPDATE that touches an indexed column. The HITL claim path is
+--   UPDATE-heavy (claim/resolve/release touch status, assigned_to,
+--   assigned_until, claimed_at, priority, metadata, role — nearly all indexed),
+--   so every claim is a non-HOT update that maintains all 18 btree indexes plus
+--   the metadata GIN. 0.20.0 cut redundant stream-table indexes for exactly this
+--   reason; this migration applies the same discipline to lt_escalations.
+--
+-- Scope: only drop indexes that are PROVABLY redundant — a strict leading-prefix
+--   subset of another index whose partial predicate is no stricter. Anything that
+--   merely "looks" duplicative is left in place and flagged below for EXPLAIN-driven
+--   review against production data, not dropped speculatively.
+
+-- 1. idx_lt_escalations_role_type (role, status, type, created_at DESC)
+--    is an exact leading prefix of
+--    idx_lt_escalations_role_subtype (role, status, type, subtype, created_at DESC).
+--    Every query the former can serve (equality/range on role,status,type and the
+--    created_at ordering) is served by the latter scanning the same prefix.
+DROP INDEX IF EXISTS idx_lt_escalations_role_type;
+
+-- 2. idx_lt_escalations_origin_id (origin_id) WHERE origin_id IS NOT NULL
+--    is fully covered by idx_lt_escalations_origin (origin_id, created_at DESC):
+--    `origin_id = $1` implies `origin_id IS NOT NULL`, origin_id leads the composite,
+--    and the composite additionally serves the `ORDER BY created_at DESC` used by
+--    GET_ESCALATIONS_BY_ORIGIN_ID. The partial index adds no reachable plan.
+DROP INDEX IF EXISTS idx_lt_escalations_origin_id;
+
+-- ── Review candidates (NOT dropped — verify with EXPLAIN on production volume) ──
+--
+-- These overlap but are not provably redundant. Confirm with EXPLAIN (ANALYZE,
+-- BUFFERS) on representative data before removing any of them:
+--
+--   idx_lt_escalations_available (status, role, assigned_until, created_at DESC)
+--     vs idx_lt_escalations_available_v2 (role, priority, created_at DESC)
+--        WHERE status = 'pending'
+--     The "_v2" naming implies intent to supersede v1, but v1 is full-table and
+--     v1 alone positions assigned_until for the available-pool predicate. Confirm
+--     which (if either) the listAvailableEscalations plan actually uses.
+--
+--   idx_lt_escalations_status (status, created_at DESC)
+--     Partially overlaps status-leading composites, but is the only index that
+--     serves `status = $1 ORDER BY created_at DESC` index-ordered for non-pending
+--     statuses. Keep unless EXPLAIN shows it unused.
+--
+--   idx_lt_escalations_priority_desc (priority DESC, created_at DESC)
+--     Backs the user-selectable `sort_by=priority` dashboard sort (SORTABLE_COLUMNS).
+--     Keep while that sort is exposed.

package/build/routes/index.js

@@ -68,4 +68,6 @@ router.use('/knowledge', knowledge_1.default);
 router.use('/agents', agents_1.default);
 router.use('/capabilities', capabilities_1.default);
 router.use('/topics', topics_1.default);
+const overview_1 = __importDefault(require("./overview"));
+router.use('/overview', overview_1.default);
 exports.default = router;

package/build/routes/overview.d.ts

@@ -0,0 +1,2 @@
+declare const router: import("express-serve-static-core").Router;
+export default router;

package/build/routes/overview.js

@@ -0,0 +1,50 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+const express_1 = require("express");
+const api = __importStar(require("../api/overview"));
+const router = (0, express_1.Router)();
+/**
+ * GET /api/overview?period=24h
+ * System overview — triage, throughput, trends, infrastructure, processes.
+ * Any authenticated user can call this.
+ */
+router.get('/', async (req, res) => {
+    const result = await api.overview({
+        period: req.query.period || undefined,
+    });
+    res.status(result.status).json(result.data ?? { error: result.error });
+});
+exports.default = router;

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

@@ -26,7 +26,7 @@ export declare const FIND_BY_METADATA = "SELECT *, COUNT(*) OVER() AS _total\nFR
  * $1 = metadata filter (jsonb), $2 = userId, $3 = durationMinutes,
  * $4 = metadata patch (jsonb, nullable), $5 = allowed roles (text[], null = no filter)
  */
-export declare const CLAIM_BY_METADATA_GUARDED = "WITH target AS (\n  SELECT id, assigned_to\n  FROM lt_escalations\n  WHERE metadata @> $1::jsonb\n    AND status = 'pending'\n    AND (assigned_to IS NULL OR assigned_until <= NOW() OR assigned_to = $2)\n    AND ($5::text[] IS NULL OR role = ANY($5))\n  ORDER BY priority ASC, created_at ASC\n  LIMIT 1\n  FOR UPDATE SKIP LOCKED\n),\nupdated AS (\n  UPDATE lt_escalations e\n  SET assigned_to = $2,\n      claimed_at = NOW(),\n      assigned_until = NOW() + INTERVAL '1 minute' * $3,\n      metadata = CASE WHEN $4::jsonb IS NOT NULL\n        THEN COALESCE(e.metadata, '{}'::jsonb) || $4::jsonb\n        ELSE e.metadata END,\n      updated_at = NOW()\n  FROM target t\n  WHERE e.id = t.id\n  RETURNING e.*, t.assigned_to AS prev_assigned_to\n)\nSELECT *,\n  (SELECT COUNT(*) FROM lt_escalations WHERE metadata @> $1::jsonb AND status = 'pending') AS candidates_exist\nFROM updated";
+export declare const CLAIM_BY_METADATA_GUARDED = "WITH target AS MATERIALIZED (\n  SELECT id, assigned_to\n  FROM lt_escalations\n  WHERE metadata @> $1::jsonb\n    AND status = 'pending'\n    AND (assigned_to IS NULL OR assigned_until <= NOW() OR assigned_to = $2)\n    AND ($5::text[] IS NULL OR role = ANY($5))\n  ORDER BY priority ASC, created_at ASC\n  LIMIT 1\n  FOR UPDATE SKIP LOCKED\n),\nupdated AS (\n  UPDATE lt_escalations e\n  SET assigned_to = $2,\n      claimed_at = NOW(),\n      assigned_until = NOW() + INTERVAL '1 minute' * $3,\n      metadata = CASE WHEN $4::jsonb IS NOT NULL\n        THEN COALESCE(e.metadata, '{}'::jsonb) || $4::jsonb\n        ELSE e.metadata END,\n      updated_at = NOW()\n  FROM target t\n  WHERE e.id = t.id\n  RETURNING e.*, t.assigned_to AS prev_assigned_to\n)\nSELECT *,\n  (SELECT COUNT(*) FROM lt_escalations WHERE metadata @> $1::jsonb AND status = 'pending') AS candidates_exist\nFROM updated";
 /**
  * Atomic resolve by metadata with signal guard.
  *
@@ -39,4 +39,4 @@ export declare const CLAIM_BY_METADATA_GUARDED = "WITH target AS (\n  SELECT id,
  * $1 = metadata filter (jsonb), $2 = userId, $3 = resolver_payload (jsonb),
  * $4 = metadata patch (jsonb, nullable), $5 = allowed roles (text[], null = no filter)
  */
-export declare const RESOLVE_BY_METADATA_ATOMIC = "WITH target AS (\n  SELECT *\n  FROM lt_escalations\n  WHERE metadata @> $1::jsonb\n    AND status = 'pending'\n    AND ($5::text[] IS NULL OR role = ANY($5))\n  ORDER BY priority ASC, created_at ASC\n  LIMIT 1\n  FOR UPDATE\n),\nclaimed AS (\n  UPDATE lt_escalations e\n  SET assigned_to = COALESCE(e.assigned_to, $2),\n      claimed_at = COALESCE(e.claimed_at, NOW()),\n      assigned_until = CASE\n        WHEN e.assigned_to IS NOT NULL AND e.assigned_until > NOW() THEN e.assigned_until\n        ELSE NOW() + INTERVAL '5 minutes' END,\n      metadata = CASE WHEN $4::jsonb IS NOT NULL\n        THEN COALESCE(e.metadata, '{}'::jsonb) || $4::jsonb\n        ELSE e.metadata END\n  FROM target\n  WHERE e.id = target.id\n    AND (target.metadata->>'signal_id') IS NULL\n  RETURNING e.*\n),\nresolved AS (\n  UPDATE lt_escalations e\n  SET status = 'resolved',\n      resolved_at = NOW(),\n      resolver_payload = $3,\n      updated_at = NOW()\n  FROM claimed\n  WHERE e.id = claimed.id\n  RETURNING e.*\n)\nSELECT\n  resolved.*,\n  target.id AS target_id,\n  target.metadata->>'signal_id' AS signal_id,\n  target.workflow_id AS target_workflow_id,\n  target.workflow_type AS target_workflow_type,\n  target.task_queue AS target_task_queue,\n  CASE WHEN resolved.id IS NOT NULL THEN 'resolved' ELSE 'signal_required' END AS outcome\nFROM target\nLEFT JOIN resolved ON resolved.id = target.id";
+export declare const RESOLVE_BY_METADATA_ATOMIC = "WITH target AS MATERIALIZED (\n  SELECT *\n  FROM lt_escalations\n  WHERE metadata @> $1::jsonb\n    AND status = 'pending'\n    AND ($5::text[] IS NULL OR role = ANY($5))\n  ORDER BY priority ASC, created_at ASC\n  LIMIT 1\n  FOR UPDATE\n),\nclaimed AS (\n  UPDATE lt_escalations e\n  SET assigned_to = COALESCE(e.assigned_to, $2),\n      claimed_at = COALESCE(e.claimed_at, NOW()),\n      assigned_until = CASE\n        WHEN e.assigned_to IS NOT NULL AND e.assigned_until > NOW() THEN e.assigned_until\n        ELSE NOW() + INTERVAL '5 minutes' END,\n      metadata = CASE WHEN $4::jsonb IS NOT NULL\n        THEN COALESCE(e.metadata, '{}'::jsonb) || $4::jsonb\n        ELSE e.metadata END\n  FROM target\n  WHERE e.id = target.id\n    AND (target.metadata->>'signal_id') IS NULL\n  RETURNING e.*\n),\nresolved AS (\n  UPDATE lt_escalations e\n  SET status = 'resolved',\n      resolved_at = NOW(),\n      resolver_payload = $3,\n      updated_at = NOW()\n  FROM claimed\n  WHERE e.id = claimed.id\n  RETURNING e.*\n)\nSELECT\n  resolved.*,\n  target.id AS target_id,\n  target.metadata->>'signal_id' AS signal_id,\n  target.workflow_id AS target_workflow_id,\n  target.workflow_type AS target_workflow_type,\n  target.task_queue AS target_task_queue,\n  CASE WHEN resolved.id IS NOT NULL THEN 'resolved' ELSE 'signal_required' END AS outcome\nFROM target\nLEFT JOIN resolved ON resolved.id = target.id";

package/build/services/escalation/sql.js

@@ -148,7 +148,7 @@ LIMIT $3 OFFSET $4`;
  * $4 = metadata patch (jsonb, nullable), $5 = allowed roles (text[], null = no filter)
  */
 exports.CLAIM_BY_METADATA_GUARDED = `\
-WITH target AS (
+WITH target AS MATERIALIZED (
   SELECT id, assigned_to
   FROM lt_escalations
   WHERE metadata @> $1::jsonb
@@ -188,7 +188,7 @@ FROM updated`;
  * $4 = metadata patch (jsonb, nullable), $5 = allowed roles (text[], null = no filter)
  */
 exports.RESOLVE_BY_METADATA_ATOMIC = `\
-WITH target AS (
+WITH target AS MATERIALIZED (
   SELECT *
   FROM lt_escalations
   WHERE metadata @> $1::jsonb

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/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/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/schemas.d.ts

@@ -391,7 +391,7 @@ export declare const addEscalationChainSchema: z.ZodObject<{
     target_role: string;
 }>;
 export declare const pruneSchema: z.ZodObject<{
-    app_id: z.ZodString;
+    app_id: z.ZodDefault<z.ZodOptional<z.ZodString>>;
     expire: z.ZodDefault<z.ZodOptional<z.ZodString>>;
     jobs: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
     streams: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
@@ -405,11 +405,11 @@ export declare const pruneSchema: z.ZodObject<{
     prune_transient: boolean;
     entities?: string[] | undefined;
 }, {
-    app_id: string;
     streams?: boolean | undefined;
     jobs?: boolean | undefined;
     expire?: string | undefined;
     entities?: string[] | undefined;
+    app_id?: string | undefined;
     prune_transient?: boolean | undefined;
 }>;
 export declare const listAgentsSchema: z.ZodObject<{
@@ -633,17 +633,17 @@ export declare const revokeBotKeySchema: z.ZodObject<{
 }>;
 export declare const listAppsSchema: z.ZodObject<{}, "strip", z.ZodTypeAny, {}, {}>;
 export declare const rollCallSchema: z.ZodObject<{
-    app_id: z.ZodString;
+    app_id: z.ZodDefault<z.ZodOptional<z.ZodString>>;
     delay: z.ZodOptional<z.ZodNumber>;
 }, "strip", z.ZodTypeAny, {
     app_id: string;
     delay?: number | undefined;
 }, {
-    app_id: string;
+    app_id?: string | undefined;
     delay?: number | undefined;
 }>;
 export declare const applyThrottleSchema: z.ZodObject<{
-    appId: z.ZodString;
+    appId: z.ZodDefault<z.ZodOptional<z.ZodString>>;
     throttle: z.ZodNumber;
     topic: z.ZodOptional<z.ZodString>;
     guid: z.ZodOptional<z.ZodString>;
@@ -655,14 +655,14 @@ export declare const applyThrottleSchema: z.ZodObject<{
     guid?: string | undefined;
     scope?: string | undefined;
 }, {
-    appId: string;
     throttle: number;
+    appId?: string | undefined;
     topic?: string | undefined;
     guid?: string | undefined;
     scope?: string | undefined;
 }>;
 export declare const getStreamStatsSchema: z.ZodObject<{
-    app_id: z.ZodString;
+    app_id: z.ZodDefault<z.ZodOptional<z.ZodString>>;
     duration: z.ZodOptional<z.ZodString>;
     stream: z.ZodOptional<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
@@ -670,12 +670,12 @@ export declare const getStreamStatsSchema: z.ZodObject<{
     duration?: string | undefined;
     stream?: string | undefined;
 }, {
-    app_id: string;
+    app_id?: string | undefined;
     duration?: string | undefined;
     stream?: string | undefined;
 }>;
 export declare const listStreamMessagesSchema: z.ZodObject<{
-    namespace: z.ZodString;
+    namespace: z.ZodDefault<z.ZodOptional<z.ZodString>>;
     source: z.ZodString;
     limit: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
     offset: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
@@ -704,12 +704,12 @@ export declare const listStreamMessagesSchema: z.ZodObject<{
     aid?: string | undefined;
 }, {
     source: string;
-    namespace: string;
     status?: string | undefined;
     limit?: number | undefined;
     offset?: number | undefined;
     workflow_name?: string | undefined;
     topic?: string | undefined;
+    namespace?: string | undefined;
     sort_by?: string | undefined;
     order?: "asc" | "desc" | undefined;
     stream_name?: string | undefined;
@@ -718,14 +718,14 @@ export declare const listStreamMessagesSchema: z.ZodObject<{
     aid?: string | undefined;
 }>;
 export declare const listPipelineEntitiesSchema: z.ZodObject<{
-    app_id: z.ZodString;
+    app_id: z.ZodDefault<z.ZodOptional<z.ZodString>>;
 }, "strip", z.ZodTypeAny, {
     app_id: string;
 }, {
-    app_id: string;
+    app_id?: string | undefined;
 }>;
 export declare const listPipelineJobsSchema: z.ZodObject<{
-    app_id: z.ZodString;
+    app_id: z.ZodDefault<z.ZodOptional<z.ZodString>>;
     limit: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
     offset: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
     entity: z.ZodOptional<z.ZodString>;
@@ -743,8 +743,8 @@ export declare const listPipelineJobsSchema: z.ZodObject<{
     sort_by?: string | undefined;
     order?: "asc" | "desc" | undefined;
 }, {
-    app_id: string;
     status?: string | undefined;
+    app_id?: string | undefined;
     entity?: string | undefined;
     search?: string | undefined;
     limit?: number | undefined;
@@ -754,26 +754,26 @@ export declare const listPipelineJobsSchema: z.ZodObject<{
 }>;
 export declare const getJobExecutionSchema: z.ZodObject<{
     job_id: z.ZodString;
-    app_id: z.ZodString;
+    app_id: z.ZodDefault<z.ZodOptional<z.ZodString>>;
 }, "strip", z.ZodTypeAny, {
     app_id: string;
     job_id: string;
 }, {
-    app_id: string;
     job_id: string;
+    app_id?: string | undefined;
 }>;
 export declare const interruptJobSchema: z.ZodObject<{
     job_id: z.ZodString;
     topic: z.ZodString;
-    app_id: z.ZodString;
+    app_id: z.ZodDefault<z.ZodOptional<z.ZodString>>;
 }, "strip", z.ZodTypeAny, {
     app_id: string;
     job_id: string;
     topic: string;
 }, {
-    app_id: string;
     job_id: string;
     topic: string;
+    app_id?: string | undefined;
 }>;
 export declare const listTopicsSchema: z.ZodObject<{
     category: z.ZodOptional<z.ZodString>;
@@ -951,7 +951,7 @@ export declare const updatePrioritySchema: z.ZodObject<{
 }>;
 export declare const getSettingsSchema: z.ZodObject<{}, "strip", z.ZodTypeAny, {}, {}>;
 export declare const listExportJobsSchema: z.ZodObject<{
-    app_id: z.ZodString;
+    app_id: z.ZodDefault<z.ZodOptional<z.ZodString>>;
     limit: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
     offset: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
     entity: z.ZodOptional<z.ZodString>;
@@ -971,9 +971,9 @@ export declare const listExportJobsSchema: z.ZodObject<{
     sort_by?: string | undefined;
     order?: "asc" | "desc" | undefined;
 }, {
-    app_id: string;
     status?: string | undefined;
     registered?: string | undefined;
+    app_id?: string | undefined;
     entity?: string | undefined;
     search?: string | undefined;
     limit?: number | undefined;

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

@@ -20,7 +20,7 @@ exports.findTasksSchema = zod_1.z.object({
     workflow_type: zod_1.z.string().optional().describe('Filter by workflow type name'),
     workflow_id: zod_1.z.string().optional().describe('Filter by workflow execution ID'),
     origin_id: zod_1.z.string().optional().describe('Filter by origin/process ID'),
-    limit: zod_1.z.number().int().min(1).max(100).optional().default(25),
+    limit: zod_1.z.number().int().min(1).max(100).optional().default(5),
     offset: zod_1.z.number().int().min(0).optional().default(0),
 });
 exports.getProcessDetailSchema = zod_1.z.object({
@@ -32,7 +32,7 @@ exports.findEscalationsSchema = zod_1.z.object({
     role: zod_1.z.string().optional().describe('Filter by target role'),
     type: zod_1.z.string().optional().describe('Filter by escalation type'),
     priority: zod_1.z.number().int().min(1).max(4).optional().describe('Filter by priority (1=critical, 4=low)'),
-    limit: zod_1.z.number().int().min(1).max(100).optional().default(25),
+    limit: zod_1.z.number().int().min(1).max(100).optional().default(5),
     offset: zod_1.z.number().int().min(0).optional().default(0),
 });
 exports.getEscalationStatsSchema = zod_1.z.object({
@@ -170,7 +170,7 @@ exports.addEscalationChainSchema = zod_1.z.object({
 });
 // ── maintenance (routes/dba.ts) ─────────────────────────────────────────────
 exports.pruneSchema = zod_1.z.object({
-    app_id: zod_1.z.string().describe('HotMesh application namespace (required)'),
+    app_id: zod_1.z.string().optional().default('durable').describe('HotMesh application namespace (default: durable)'),
     expire: zod_1.z.string().optional().default('7 days').describe('Retention period (PostgreSQL interval)'),
     jobs: zod_1.z.boolean().optional().default(true).describe('Hard-delete expired jobs'),
     streams: zod_1.z.boolean().optional().default(true).describe('Hard-delete expired streams'),
@@ -181,7 +181,7 @@ exports.pruneSchema = zod_1.z.object({
 exports.listAgentsSchema = zod_1.z.object({
     status: zod_1.z.string().optional().describe('Filter by agent status'),
     knowledge_domain: zod_1.z.string().optional().describe('Filter by knowledge domain'),
-    limit: zod_1.z.number().int().min(1).max(100).optional().default(25),
+    limit: zod_1.z.number().int().min(1).max(100).optional().default(5),
     offset: zod_1.z.number().int().min(0).optional().default(0),
 });
 exports.getAgentSchema = zod_1.z.object({
@@ -264,25 +264,25 @@ exports.revokeBotKeySchema = zod_1.z.object({
 // ── control plane (routes/controlplane.ts) ──────────────────────────────────
 exports.listAppsSchema = zod_1.z.object({});
 exports.rollCallSchema = zod_1.z.object({
-    app_id: zod_1.z.string().describe('HotMesh application namespace (required)'),
+    app_id: zod_1.z.string().optional().default('durable').describe('HotMesh application namespace (default: durable)'),
     delay: zod_1.z.number().int().optional().describe('Delay in ms before roll call'),
 });
 exports.applyThrottleSchema = zod_1.z.object({
-    appId: zod_1.z.string().describe('HotMesh application namespace (required)'),
+    appId: zod_1.z.string().optional().default('durable').describe('HotMesh application namespace (default: durable)'),
     throttle: zod_1.z.number().int().describe('Throttle value (messages per second)'),
     topic: zod_1.z.string().optional().describe('Topic to throttle'),
     guid: zod_1.z.string().optional().describe('Specific GUID to throttle'),
     scope: zod_1.z.string().optional().describe('Throttle scope'),
 });
 exports.getStreamStatsSchema = zod_1.z.object({
-    app_id: zod_1.z.string().describe('HotMesh application namespace (required)'),
+    app_id: zod_1.z.string().optional().default('durable').describe('HotMesh application namespace (default: durable)'),
     duration: zod_1.z.string().optional().describe('Stats duration window'),
     stream: zod_1.z.string().optional().describe('Specific stream name'),
 });
 exports.listStreamMessagesSchema = zod_1.z.object({
-    namespace: zod_1.z.string().describe('App namespace'),
+    namespace: zod_1.z.string().optional().default('durable').describe('App namespace (default: durable)'),
     source: zod_1.z.string().describe('Message source'),
-    limit: zod_1.z.number().int().min(1).max(100).optional().default(25),
+    limit: zod_1.z.number().int().min(1).max(100).optional().default(5),
     offset: zod_1.z.number().int().min(0).optional().default(0),
     sort_by: zod_1.z.string().optional().describe('Sort field'),
     order: zod_1.z.enum(['asc', 'desc']).optional().describe('Sort order'),
@@ -296,11 +296,11 @@ exports.listStreamMessagesSchema = zod_1.z.object({
 });
 // ── pipelines (routes/pipelines.ts) ─────────────────────────────────────────
 exports.listPipelineEntitiesSchema = zod_1.z.object({
-    app_id: zod_1.z.string().describe('HotMesh application namespace (required)'),
+    app_id: zod_1.z.string().optional().default('durable').describe('HotMesh application namespace (default: durable)'),
 });
 exports.listPipelineJobsSchema = zod_1.z.object({
-    app_id: zod_1.z.string().describe('HotMesh application namespace (required)'),
-    limit: zod_1.z.number().int().min(1).max(100).optional().default(25),
+    app_id: zod_1.z.string().optional().default('durable').describe('HotMesh application namespace (default: durable)'),
+    limit: zod_1.z.number().int().min(1).max(100).optional().default(5),
     offset: zod_1.z.number().int().min(0).optional().default(0),
     entity: zod_1.z.string().optional().describe('Filter by entity type'),
     search: zod_1.z.string().optional().describe('Search term'),
@@ -310,12 +310,12 @@ exports.listPipelineJobsSchema = zod_1.z.object({
 });
 exports.getJobExecutionSchema = zod_1.z.object({
     job_id: zod_1.z.string().describe('Job ID to retrieve'),
-    app_id: zod_1.z.string().describe('HotMesh application namespace (required)'),
+    app_id: zod_1.z.string().optional().default('durable').describe('HotMesh application namespace (default: durable)'),
 });
 exports.interruptJobSchema = zod_1.z.object({
     job_id: zod_1.z.string().describe('Job ID to interrupt'),
     topic: zod_1.z.string().describe('Topic of the job'),
-    app_id: zod_1.z.string().describe('HotMesh application namespace (required)'),
+    app_id: zod_1.z.string().optional().default('durable').describe('HotMesh application namespace (default: durable)'),
 });
 // ── topics (routes/topics.ts) ───────────────────────────────────────────────
 exports.listTopicsSchema = zod_1.z.object({
@@ -351,7 +351,7 @@ exports.findByMetadataSchema = zod_1.z.object({
     key: zod_1.z.string().describe('Metadata key to search'),
     value: zod_1.z.string().describe('Metadata value to match'),
     status: zod_1.z.string().optional().describe('Filter by escalation status'),
-    limit: zod_1.z.number().int().min(1).max(100).optional().default(25),
+    limit: zod_1.z.number().int().min(1).max(100).optional().default(5),
     offset: zod_1.z.number().int().min(0).optional().default(0),
 });
 exports.claimByMetadataSchema = zod_1.z.object({
@@ -389,8 +389,8 @@ exports.updatePrioritySchema = zod_1.z.object({
 exports.getSettingsSchema = zod_1.z.object({});
 // ── exports (routes/exports.ts) ─────────────────────────────────────────────
 exports.listExportJobsSchema = zod_1.z.object({
-    app_id: zod_1.z.string().describe('HotMesh application namespace (required)'),
-    limit: zod_1.z.number().int().min(1).max(100).optional().default(25),
+    app_id: zod_1.z.string().optional().default('durable').describe('HotMesh application namespace (default: durable)'),
+    limit: zod_1.z.number().int().min(1).max(100).optional().default(5),
     offset: zod_1.z.number().int().min(0).optional().default(0),
     entity: zod_1.z.string().optional().describe('Filter by entity type'),
     search: zod_1.z.string().optional().describe('Search term'),

package/build/system/seed/tool-manifests-admin.d.ts

@@ -360,6 +360,8 @@ export declare const ADMIN_TOOLS: ({
         properties: {
             period: {
                 type: string;
+                enum?: undefined;
+                description?: undefined;
             };
             status?: undefined;
             workflow_type?: undefined;
@@ -6590,4 +6592,116 @@ export declare const ADMIN_TOOLS: ({
         };
         required: string[];
     };
+} | {
+    name: string;
+    description: string;
+    read_safe: boolean;
+    inputSchema: {
+        type: string;
+        properties: {
+            period: {
+                type: string;
+                enum: string[];
+                description: string;
+            };
+            status?: undefined;
+            workflow_type?: undefined;
+            workflow_id?: undefined;
+            origin_id?: undefined;
+            limit?: undefined;
+            offset?: undefined;
+            role?: undefined;
+            type?: undefined;
+            priority?: undefined;
+            id?: undefined;
+            duration_minutes?: undefined;
+            ids?: undefined;
+            hint?: undefined;
+            key?: undefined;
+            value?: undefined;
+            durationMinutes?: undefined;
+            assignee?: undefined;
+            metadata?: undefined;
+            provisionIfAbsent?: undefined;
+            resolverPayload?: undefined;
+            targetUserId?: undefined;
+            targetRole?: undefined;
+            invocable?: undefined;
+            task_queue?: undefined;
+            default_role?: undefined;
+            description?: undefined;
+            execute_as?: undefined;
+            roles?: undefined;
+            invocation_roles?: undefined;
+            consumes?: undefined;
+            tool_tags?: undefined;
+            cron_schedule?: undefined;
+            include_system?: undefined;
+            data?: undefined;
+            tags?: undefined;
+            search?: undefined;
+            name?: undefined;
+            auto_connect?: undefined;
+            app_id?: undefined;
+            source_workflow_id?: undefined;
+            workflow_name?: undefined;
+            compilation_feedback?: undefined;
+            sync?: undefined;
+            timeout?: undefined;
+            external_id?: undefined;
+            display_name?: undefined;
+            email?: undefined;
+            user_id?: undefined;
+            source_role?: undefined;
+            target_role?: undefined;
+            expire?: undefined;
+            jobs?: undefined;
+            streams?: undefined;
+            entities?: undefined;
+            prune_transient?: undefined;
+            knowledge_domain?: undefined;
+            goals?: undefined;
+            rules?: undefined;
+            schedules?: undefined;
+            subscriptions?: undefined;
+            agent_id?: undefined;
+            topic?: undefined;
+            reaction_type?: undefined;
+            pipeline_id?: undefined;
+            mcp_prompt?: undefined;
+            input_mapping?: undefined;
+            filter?: undefined;
+            scopes?: undefined;
+            expires_at?: undefined;
+            key_id?: undefined;
+            delay?: undefined;
+            appId?: undefined;
+            throttle?: undefined;
+            guid?: undefined;
+            scope?: undefined;
+            duration?: undefined;
+            stream?: undefined;
+            namespace?: undefined;
+            source?: undefined;
+            sort_by?: undefined;
+            order?: undefined;
+            stream_name?: undefined;
+            msg_type?: undefined;
+            jid?: undefined;
+            aid?: undefined;
+            entity?: undefined;
+            job_id?: undefined;
+            category?: undefined;
+            payload_schema?: undefined;
+            example_payload?: undefined;
+            allow?: undefined;
+            block?: undefined;
+            values?: undefined;
+            excludeSystem?: undefined;
+            omitResults?: undefined;
+            mode?: undefined;
+            maxDepth?: undefined;
+        };
+        required?: undefined;
+    };
 })[];

package/build/system/seed/tool-manifests-admin.js

@@ -91,4 +91,6 @@ exports.ADMIN_TOOLS = [
     { name: 'export_workflow_state', description: 'Export the full workflow state using HotMesh durable export.', read_safe: true, inputSchema: { type: 'object', properties: { workflow_id: { type: 'string' }, allow: { type: 'array', items: { type: 'string' } }, block: { type: 'array', items: { type: 'string' } }, values: { type: 'object' } }, required: ['workflow_id'] } },
     { name: 'export_workflow_execution', description: 'Export workflow state as a structured execution event history.', read_safe: true, inputSchema: { type: 'object', properties: { workflow_id: { type: 'string' }, excludeSystem: { type: 'boolean' }, omitResults: { type: 'boolean' }, mode: { type: 'string' }, maxDepth: { type: 'integer' } }, required: ['workflow_id'] } },
     { name: 'get_export_status', description: 'Return the numeric status semaphore for a workflow.', read_safe: true, inputSchema: { type: 'object', properties: { workflow_id: { type: 'string' } }, required: ['workflow_id'] } },
+    // ── overview.ts ─────────────────────────────────────────────────────────
+    { name: 'get_system_overview', description: 'Triage-ready system dashboard: escalation queue pressure, task throughput, hourly trends, infrastructure status, and process summary. One call for complete system state.', read_safe: true, inputSchema: { type: 'object', properties: { period: { type: 'string', enum: ['1h', '24h', '7d'], description: 'Time window (default: 24h)' } } } },
 ];

package/build/tsconfig.tsbuildinfo

@@ -1 +1 @@
-{"root":["../index.ts","../vitest.config.ts","../vitest.integration.config.ts","../adapters/express.ts","../api/agent-subscriptions.ts","../api/agents.ts","../api/auth-sso.ts","../api/auth.ts","../api/bot-accounts.ts","../api/capabilities.ts","../api/controlplane.ts","../api/dba.ts","../api/exports.ts","../api/files.ts","../api/index.ts","../api/insight.ts","../api/knowledge.ts","../api/maintenance.ts","../api/namespaces.ts","../api/pipelines.ts","../api/roles.ts","../api/settings.ts","../api/tasks.ts","../api/topics.ts","../api/users.ts","../api/workflow-sets.ts","../api/escalations/bulk.ts","../api/escalations/claim.ts","../api/escalations/create.ts","../api/escalations/helpers.ts","../api/escalations/index.ts","../api/escalations/list.ts","../api/escalations/metadata.ts","../api/escalations/resolve.ts","../api/escalations/single.ts","../api/mcp/index.ts","../api/mcp/servers.ts","../api/mcp/tools.ts","../api/workflows/config.ts","../api/workflows/discovery.ts","../api/workflows/index.ts","../api/workflows/invocation.ts","../api/yaml-workflows/cron.ts","../api/yaml-workflows/crud.ts","../api/yaml-workflows/deploy.ts","../api/yaml-workflows/helpers.ts","../api/yaml-workflows/index.ts","../api/yaml-workflows/versions.ts","../bin/ltc.ts","../lib/cli/auth.ts","../lib/cli/client.ts","../lib/cli/compile.ts","../lib/cli/format.ts","../lib/cli/init.ts","../lib/cli/output.ts","../lib/cli/scanner.ts","../lib/cli/types.ts","../lib/cli/commands/escalations.ts","../lib/cli/commands/knowledge.ts","../lib/cli/commands/mcp.ts","../lib/cli/commands/pipelines.ts","../lib/cli/commands/status.ts","../lib/cli/commands/streams.ts","../lib/cli/commands/users.ts","../lib/cli/commands/workflows.ts","../lib/db/index.ts","../lib/db/migrate.ts","../lib/events/callback.ts","../lib/events/index.ts","../lib/events/matching.ts","../lib/events/memory.ts","../lib/events/nats-ws-proxy.ts","../lib/events/nats.ts","../lib/events/publish.ts","../lib/events/socketio.ts","../lib/logger/index.ts","../lib/logger/pino.ts","../lib/storage/index.ts","../lib/storage/local.ts","../lib/storage/mime.ts","../lib/storage/s3.ts","../lib/storage/types.ts","../lib/telemetry/honeycomb.ts","../lib/telemetry/index.ts","../modules/auth.ts","../modules/config.ts","../modules/defaults.ts","../modules/ltconfig.ts","../modules/maintenance.ts","../modules/sso.ts","../modules/utils.ts","../routes/agents.ts","../routes/auth-sso.ts","../routes/auth.ts","../routes/bot-accounts.ts","../routes/capabilities.ts","../routes/controlplane.ts","../routes/dba.ts","../routes/delegation.ts","../routes/docs.ts","../routes/exports.ts","../routes/file-browser.ts","../routes/files.ts","../routes/index.ts","../routes/insight.ts","../routes/knowledge.ts","../routes/maintenance.ts","../routes/mcp-endpoint.ts","../routes/mcp.ts","../routes/namespaces.ts","../routes/nats-credentials.ts","../routes/oauth.ts","../routes/pipelines.ts","../routes/roles.ts","../routes/settings.ts","../routes/tasks.ts","../routes/topics.ts","../routes/users.ts","../routes/workflow-sets.ts","../routes/escalations/bulk.ts","../routes/escalations/index.ts","../routes/escalations/list.ts","../routes/escalations/metadata.ts","../routes/escalations/resolve.ts","../routes/escalations/single.ts","../routes/workflows/config.ts","../routes/workflows/discovery.ts","../routes/workflows/index.ts","../routes/workflows/invocation.ts","../routes/yaml-workflows/cron.ts","../routes/yaml-workflows/crud.ts","../routes/yaml-workflows/deployment.ts","../routes/yaml-workflows/index.ts","../routes/yaml-workflows/versions.ts","../scripts/process-helpers.ts","../scripts/process.ts","../scripts/token.ts","../sdk/index.ts","../services/dba.ts","../services/hotmesh-utils.ts","../services/workflow-invocation.ts","../services/agent/index.ts","../services/agent/input-mapper.ts","../services/agent/sql.ts","../services/agent/subscription-sql.ts","../services/agent/subscriptions.ts","../services/agent/trigger-registry.ts","../services/auth/bot-api-key.ts","../services/auth/delegation.ts","../services/auth/index.ts","../services/auth/service-token.ts","../services/auth/sql.ts","../services/config/cache.ts","../services/config/index.ts","../services/config/provider.ts","../services/config/read.ts","../services/config/sql.ts","../services/config/write.ts","../services/controlplane/index.ts","../services/controlplane/quorum-bridge.ts","../services/controlplane/sql.ts","../services/controlplane/stream-messages-sql.ts","../services/controlplane/types.ts","../services/cron/index.ts","../services/escalation/bulk.ts","../services/escalation/crud.ts","../services/escalation/index.ts","../services/escalation/queries.ts","../services/escalation/sql.ts","../services/escalation/types.ts","../services/escalation-strategy/default.ts","../services/escalation-strategy/index.ts","../services/escalation-strategy/mcp.ts","../services/export/client.ts","../services/export/index.ts","../services/export/post-process.ts","../services/export/types.ts","../services/iam/activity.ts","../services/iam/bots.ts","../services/iam/context.ts","../services/iam/credentials.ts","../services/iam/envelope.ts","../services/iam/ephemeral.ts","../services/iam/index.ts","../services/iam/principal.ts","../services/iam/resolve.ts","../services/iam/sql.ts","../services/insight/index.ts","../services/insight/prompts.ts","../services/interceptor/activity-interceptor.ts","../services/interceptor/completion.ts","../services/interceptor/context.ts","../services/interceptor/escalation.ts","../services/interceptor/index.ts","../services/interceptor/lifecycle.ts","../services/interceptor/state.ts","../services/interceptor/types.ts","../services/interceptor/activities/config.ts","../services/interceptor/activities/escalation.ts","../services/interceptor/activities/index.ts","../services/interceptor/activities/task.ts","../services/interceptor/activities/workflow.ts","../services/llm/detect.ts","../services/llm/index.ts","../services/llm/translate.ts","../services/llm/types.ts","../services/llm/providers/anthropic.ts","../services/llm/providers/openai.ts","../services/maintenance/index.ts","../services/mcp/adapter.ts","../services/mcp/db.ts","../services/mcp/exposure.ts","../services/mcp/external-server.ts","../services/mcp/index.ts","../services/mcp/register-tool.ts","../services/mcp/seed-service-account.ts","../services/mcp/server-lifecycle.ts","../services/mcp/server-tools.ts","../services/mcp/server.ts","../services/mcp/sql.ts","../services/mcp/types.ts","../services/mcp/workflow-compiler-server.ts","../services/mcp/workflow-server.ts","../services/mcp/client/connection-dispatch.ts","../services/mcp/client/connection-lifecycle.ts","../services/mcp/client/connection-test.ts","../services/mcp/client/connection.ts","../services/mcp/client/index.ts","../services/mcp/client/tools.ts","../services/mcp/db-server/index.ts","../services/mcp/db-server/schemas.ts","../services/mcp/db-server/tools.ts","../services/mcp/playwright-server/index.ts","../services/mcp/playwright-server/lifecycle.ts","../services/mcp/playwright-server/schemas.ts","../services/mcp/playwright-server/tools.ts","../services/namespace/index.ts","../services/namespace/sql.ts","../services/namespace/types.ts","../services/oauth/crypto.ts","../services/oauth/db.ts","../services/oauth/index.ts","../services/oauth/sql.ts","../services/oauth/state.ts","../services/oauth/providers/anthropic.ts","../services/oauth/providers/github.ts","../services/oauth/providers/google.ts","../services/oauth/providers/index.ts","../services/oauth/providers/microsoft.ts","../services/oauth/providers/mock.ts","../services/oauth/providers/registry.ts","../services/oauth/providers/types.ts","../services/orchestrator/condition.ts","../services/orchestrator/index.ts","../services/orchestrator/types.ts","../services/pipelines/enrichment.ts","../services/pipelines/events.ts","../services/pipelines/execution-builder.ts","../services/pipelines/index.ts","../services/pipelines/queries.ts","../services/pipelines/sql.ts","../services/pipelines/types.ts","../services/role/index.ts","../services/role/sql.ts","../services/role/types.ts","../services/task/crud.ts","../services/task/index.ts","../services/task/process.ts","../services/task/resolve.ts","../services/task/sql.ts","../services/task/types.ts","../services/topics/index.ts","../services/topics/sql.ts","../services/topics/system-topics.ts","../services/user/auth.ts","../services/user/crud.ts","../services/user/index.ts","../services/user/rbac.ts","../services/user/roles.ts","../services/user/seed-admin.ts","../services/user/sql.ts","../services/user/sso-provision.ts","../services/user/types.ts","../services/workers/registry.ts","../services/workflow-sets/db.ts","../services/workflow-sets/index.ts","../services/workflow-sets/sql.ts","../services/yaml-workflow/builder-regenerate.ts","../services/yaml-workflow/db-utils.ts","../services/yaml-workflow/db-versions.ts","../services/yaml-workflow/db.ts","../services/yaml-workflow/deployer-helpers.ts","../services/yaml-workflow/deployer.ts","../services/yaml-workflow/generator.ts","../services/yaml-workflow/index.ts","../services/yaml-workflow/input-analyzer-helpers.ts","../services/yaml-workflow/input-analyzer.ts","../services/yaml-workflow/invoke.ts","../services/yaml-workflow/sql.ts","../services/yaml-workflow/types.ts","../services/yaml-workflow/durable-compiler/index.ts","../services/yaml-workflow/durable-compiler/parser.ts","../services/yaml-workflow/durable-compiler/prompts.ts","../services/yaml-workflow/durable-compiler/types.ts","../services/yaml-workflow/pattern-detector/array-source.ts","../services/yaml-workflow/pattern-detector/collapse.ts","../services/yaml-workflow/pattern-detector/index.ts","../services/yaml-workflow/pattern-detector/run-detection.ts","../services/yaml-workflow/pattern-detector/types.ts","../services/yaml-workflow/pipeline/analyze.ts","../services/yaml-workflow/pipeline/extract-helpers.ts","../services/yaml-workflow/pipeline/extract.ts","../services/yaml-workflow/pipeline/index.ts","../services/yaml-workflow/pipeline/prompt-templates.ts","../services/yaml-workflow/pipeline/prompts.ts","../services/yaml-workflow/pipeline/validate.ts","../services/yaml-workflow/pipeline/build/dag-assembly.ts","../services/yaml-workflow/pipeline/build/dag.ts","../services/yaml-workflow/pipeline/build/index.ts","../services/yaml-workflow/pipeline/build/iteration.ts","../services/yaml-workflow/pipeline/build/metadata.ts","../services/yaml-workflow/pipeline/build/transform.ts","../services/yaml-workflow/pipeline/build/utils.ts","../services/yaml-workflow/pipeline/build/wiring.ts","../services/yaml-workflow/pipeline/compile/index.ts","../services/yaml-workflow/pipeline/compile/llm-call.ts","../services/yaml-workflow/pipeline/compile/parse-plan.ts","../services/yaml-workflow/pipeline/compile/summarize.ts","../services/yaml-workflow/workers/callbacks.ts","../services/yaml-workflow/workers/events.ts","../services/yaml-workflow/workers/index.ts","../services/yaml-workflow/workers/register.ts","../services/yaml-workflow/workers/scope.ts","../start/adapters.ts","../start/config.ts","../start/index.ts","../start/server.ts","../start/socket-auth.ts","../start/workers.ts","../system/index.ts","../system/activities/claude-code.ts","../system/activities/file-storage.ts","../system/activities/http.ts","../system/activities/knowledge.ts","../system/activities/oauth.ts","../system/activities/schema-exchange.ts","../system/activities/sql.ts","../system/activities/triage/cache.ts","../system/activities/triage/context.ts","../system/activities/triage/discovery.ts","../system/activities/triage/index.ts","../system/activities/triage/llm.ts","../system/activities/triage/tools.ts","../system/mcp-servers/claude-code.ts","../system/mcp-servers/docs.ts","../system/mcp-servers/events.ts","../system/mcp-servers/file-storage.ts","../system/mcp-servers/http-fetch.ts","../system/mcp-servers/human-queue-schemas.ts","../system/mcp-servers/human-queue.ts","../system/mcp-servers/knowledge.ts","../system/mcp-servers/oauth.ts","../system/mcp-servers/schema-exchange.ts","../system/mcp-servers/translation.ts","../system/mcp-servers/vision-prompts.ts","../system/mcp-servers/vision.ts","../system/mcp-servers/workflow-compiler.ts","../system/mcp-servers/workflow.ts","../system/mcp-servers/admin/agent-subscriptions.ts","../system/mcp-servers/admin/agents.ts","../system/mcp-servers/admin/bot-accounts.ts","../system/mcp-servers/admin/controlplane.ts","../system/mcp-servers/admin/escalations.ts","../system/mcp-servers/admin/exports.ts","../system/mcp-servers/admin/index.ts","../system/mcp-servers/admin/maintenance.ts","../system/mcp-servers/admin/mcp-servers.ts","../system/mcp-servers/admin/pipelines.ts","../system/mcp-servers/admin/schemas.ts","../system/mcp-servers/admin/settings.ts","../system/mcp-servers/admin/tasks.ts","../system/mcp-servers/admin/topics.ts","../system/mcp-servers/admin/users.ts","../system/mcp-servers/admin/workflow-config.ts","../system/mcp-servers/admin/workflows.ts","../system/mcp-servers/admin/yaml-workflows.ts","../system/mcp-servers/db-query/index.ts","../system/mcp-servers/db-query/schemas.ts","../system/mcp-servers/db-query/tools.ts","../system/seed/index.ts","../system/seed/tool-manifests-admin.ts","../system/seed/tool-manifests-data.ts","../system/seed/tool-manifests-escalation.ts","../system/seed/tool-manifests-events.ts","../system/seed/tool-manifests-knowledge.ts","../system/seed/tool-manifests-workflows.ts","../system/workflows/tool-result-guard.ts","../system/workflows/capability-invoke/activities.ts","../system/workflows/capability-invoke/index.ts","../system/workflows/mcp-deterministic/activities.ts","../system/workflows/mcp-deterministic/index.ts","../system/workflows/mcp-query/index.ts","../system/workflows/mcp-query/prompts.ts","../system/workflows/mcp-query/strategy-advisors.ts","../system/workflows/mcp-query/types.ts","../system/workflows/mcp-query/activities/caches.ts","../system/workflows/mcp-query/activities/discovery.ts","../system/workflows/mcp-query/activities/index.ts","../system/workflows/mcp-query/activities/llm.ts","../system/workflows/mcp-query/activities/tool-executor.ts","../system/workflows/mcp-query/activities/tool-loader.ts","../system/workflows/mcp-query-router/activities.ts","../system/workflows/mcp-query-router/index.ts","../system/workflows/mcp-query-router/prompts.ts","../system/workflows/mcp-triage/activities-proxy.ts","../system/workflows/mcp-triage/index.ts","../system/workflows/mcp-triage/prompts.ts","../system/workflows/mcp-triage/response-builders.ts","../system/workflows/mcp-triage/response.ts","../system/workflows/mcp-triage/types.ts","../system/workflows/mcp-triage-deterministic/activities.ts","../system/workflows/mcp-triage-deterministic/index.ts","../system/workflows/mcp-triage-router/activities.ts","../system/workflows/mcp-triage-router/index.ts","../system/workflows/mcp-workflow-builder/index.ts","../system/workflows/mcp-workflow-builder/prompts.ts","../system/workflows/mcp-workflow-builder/activities/caches.ts","../system/workflows/mcp-workflow-builder/activities/index.ts","../system/workflows/mcp-workflow-builder/activities/llm.ts","../system/workflows/mcp-workflow-builder/activities/tool-loader.ts","../system/workflows/mcp-workflow-planner/index.ts","../system/workflows/mcp-workflow-planner/prompts.ts","../system/workflows/mcp-workflow-planner/activities/analyze.ts","../system/workflows/mcp-workflow-planner/activities/index.ts","../system/workflows/mcp-workflow-planner/activities/persist.ts","../system/workflows/mcp-workflow-planner/activities/plan.ts","../system/workflows/shared/discovery.ts","../system/workflows/shared/index.ts","../system/workflows/shared/llm-caller.ts","../system/workflows/shared/prompts.ts","../system/workflows/shared/strategy-advisors.ts","../system/workflows/shared/tool-executor.ts","../system/workflows/shared/tool-loader.ts","../system/workflows/shared/types.ts","../types/agent.ts","../types/auth.ts","../types/config.ts","../types/delegation.ts","../types/discovery.ts","../types/envelope.ts","../types/escalation-strategy.ts","../types/escalation.ts","../types/events.ts","../types/export.ts","../types/express.d.ts","../types/index.ts","../types/logger.ts","../types/maintenance.ts","../types/mcp.ts","../types/oauth.ts","../types/sdk.ts","../types/startup.ts","../types/task.ts","../types/telemetry.ts","../types/tool-context.ts","../types/user.ts","../types/workflow-set.ts","../types/workflow.ts","../types/yaml-workflow.ts","../workers/index.ts"],"version":"5.9.3"}
+{"root":["../index.ts","../vitest.config.ts","../vitest.integration.config.ts","../adapters/express.ts","../api/agent-subscriptions.ts","../api/agents.ts","../api/auth-sso.ts","../api/auth.ts","../api/bot-accounts.ts","../api/capabilities.ts","../api/controlplane.ts","../api/dba.ts","../api/exports.ts","../api/files.ts","../api/index.ts","../api/insight.ts","../api/knowledge.ts","../api/maintenance.ts","../api/namespaces.ts","../api/overview.ts","../api/pipelines.ts","../api/roles.ts","../api/settings.ts","../api/tasks.ts","../api/topics.ts","../api/users.ts","../api/workflow-sets.ts","../api/escalations/bulk.ts","../api/escalations/claim.ts","../api/escalations/create.ts","../api/escalations/helpers.ts","../api/escalations/index.ts","../api/escalations/list.ts","../api/escalations/metadata.ts","../api/escalations/resolve.ts","../api/escalations/single.ts","../api/mcp/index.ts","../api/mcp/servers.ts","../api/mcp/tools.ts","../api/workflows/config.ts","../api/workflows/discovery.ts","../api/workflows/index.ts","../api/workflows/invocation.ts","../api/yaml-workflows/cron.ts","../api/yaml-workflows/crud.ts","../api/yaml-workflows/deploy.ts","../api/yaml-workflows/helpers.ts","../api/yaml-workflows/index.ts","../api/yaml-workflows/versions.ts","../bin/ltc.ts","../lib/cli/auth.ts","../lib/cli/client.ts","../lib/cli/compile.ts","../lib/cli/format.ts","../lib/cli/init.ts","../lib/cli/output.ts","../lib/cli/scanner.ts","../lib/cli/types.ts","../lib/cli/commands/escalations.ts","../lib/cli/commands/knowledge.ts","../lib/cli/commands/mcp.ts","../lib/cli/commands/pipelines.ts","../lib/cli/commands/status.ts","../lib/cli/commands/streams.ts","../lib/cli/commands/users.ts","../lib/cli/commands/workflows.ts","../lib/db/index.ts","../lib/db/migrate.ts","../lib/events/callback.ts","../lib/events/index.ts","../lib/events/matching.ts","../lib/events/memory.ts","../lib/events/nats-ws-proxy.ts","../lib/events/nats.ts","../lib/events/publish.ts","../lib/events/socketio.ts","../lib/logger/index.ts","../lib/logger/pino.ts","../lib/storage/index.ts","../lib/storage/local.ts","../lib/storage/mime.ts","../lib/storage/s3.ts","../lib/storage/types.ts","../lib/telemetry/honeycomb.ts","../lib/telemetry/index.ts","../modules/auth.ts","../modules/config.ts","../modules/defaults.ts","../modules/ltconfig.ts","../modules/maintenance.ts","../modules/sso.ts","../modules/utils.ts","../routes/agents.ts","../routes/auth-sso.ts","../routes/auth.ts","../routes/bot-accounts.ts","../routes/capabilities.ts","../routes/controlplane.ts","../routes/dba.ts","../routes/delegation.ts","../routes/docs.ts","../routes/exports.ts","../routes/file-browser.ts","../routes/files.ts","../routes/index.ts","../routes/insight.ts","../routes/knowledge.ts","../routes/maintenance.ts","../routes/mcp-endpoint.ts","../routes/mcp.ts","../routes/namespaces.ts","../routes/nats-credentials.ts","../routes/oauth.ts","../routes/overview.ts","../routes/pipelines.ts","../routes/roles.ts","../routes/settings.ts","../routes/tasks.ts","../routes/topics.ts","../routes/users.ts","../routes/workflow-sets.ts","../routes/escalations/bulk.ts","../routes/escalations/index.ts","../routes/escalations/list.ts","../routes/escalations/metadata.ts","../routes/escalations/resolve.ts","../routes/escalations/single.ts","../routes/workflows/config.ts","../routes/workflows/discovery.ts","../routes/workflows/index.ts","../routes/workflows/invocation.ts","../routes/yaml-workflows/cron.ts","../routes/yaml-workflows/crud.ts","../routes/yaml-workflows/deployment.ts","../routes/yaml-workflows/index.ts","../routes/yaml-workflows/versions.ts","../scripts/process-helpers.ts","../scripts/process.ts","../scripts/token.ts","../sdk/index.ts","../services/dba.ts","../services/hotmesh-utils.ts","../services/workflow-invocation.ts","../services/agent/index.ts","../services/agent/input-mapper.ts","../services/agent/sql.ts","../services/agent/subscription-sql.ts","../services/agent/subscriptions.ts","../services/agent/trigger-registry.ts","../services/auth/bot-api-key.ts","../services/auth/delegation.ts","../services/auth/index.ts","../services/auth/service-token.ts","../services/auth/sql.ts","../services/config/cache.ts","../services/config/index.ts","../services/config/provider.ts","../services/config/read.ts","../services/config/sql.ts","../services/config/write.ts","../services/controlplane/index.ts","../services/controlplane/quorum-bridge.ts","../services/controlplane/sql.ts","../services/controlplane/stream-messages-sql.ts","../services/controlplane/types.ts","../services/cron/index.ts","../services/escalation/bulk.ts","../services/escalation/crud.ts","../services/escalation/index.ts","../services/escalation/queries.ts","../services/escalation/sql.ts","../services/escalation/types.ts","../services/escalation-strategy/default.ts","../services/escalation-strategy/index.ts","../services/escalation-strategy/mcp.ts","../services/export/client.ts","../services/export/index.ts","../services/export/post-process.ts","../services/export/types.ts","../services/iam/activity.ts","../services/iam/bots.ts","../services/iam/context.ts","../services/iam/credentials.ts","../services/iam/envelope.ts","../services/iam/ephemeral.ts","../services/iam/index.ts","../services/iam/principal.ts","../services/iam/resolve.ts","../services/iam/sql.ts","../services/insight/index.ts","../services/insight/prompts.ts","../services/interceptor/activity-interceptor.ts","../services/interceptor/completion.ts","../services/interceptor/context.ts","../services/interceptor/escalation.ts","../services/interceptor/index.ts","../services/interceptor/lifecycle.ts","../services/interceptor/state.ts","../services/interceptor/types.ts","../services/interceptor/activities/config.ts","../services/interceptor/activities/escalation.ts","../services/interceptor/activities/index.ts","../services/interceptor/activities/task.ts","../services/interceptor/activities/workflow.ts","../services/llm/detect.ts","../services/llm/index.ts","../services/llm/translate.ts","../services/llm/types.ts","../services/llm/providers/anthropic.ts","../services/llm/providers/openai.ts","../services/maintenance/index.ts","../services/mcp/adapter.ts","../services/mcp/db.ts","../services/mcp/exposure.ts","../services/mcp/external-server.ts","../services/mcp/index.ts","../services/mcp/register-tool.ts","../services/mcp/seed-service-account.ts","../services/mcp/server-lifecycle.ts","../services/mcp/server-tools.ts","../services/mcp/server.ts","../services/mcp/sql.ts","../services/mcp/types.ts","../services/mcp/workflow-compiler-server.ts","../services/mcp/workflow-server.ts","../services/mcp/client/connection-dispatch.ts","../services/mcp/client/connection-lifecycle.ts","../services/mcp/client/connection-test.ts","../services/mcp/client/connection.ts","../services/mcp/client/index.ts","../services/mcp/client/tools.ts","../services/mcp/db-server/index.ts","../services/mcp/db-server/schemas.ts","../services/mcp/db-server/tools.ts","../services/mcp/playwright-server/index.ts","../services/mcp/playwright-server/lifecycle.ts","../services/mcp/playwright-server/schemas.ts","../services/mcp/playwright-server/tools.ts","../services/namespace/index.ts","../services/namespace/sql.ts","../services/namespace/types.ts","../services/oauth/crypto.ts","../services/oauth/db.ts","../services/oauth/index.ts","../services/oauth/sql.ts","../services/oauth/state.ts","../services/oauth/providers/anthropic.ts","../services/oauth/providers/github.ts","../services/oauth/providers/google.ts","../services/oauth/providers/index.ts","../services/oauth/providers/microsoft.ts","../services/oauth/providers/mock.ts","../services/oauth/providers/registry.ts","../services/oauth/providers/types.ts","../services/orchestrator/condition.ts","../services/orchestrator/index.ts","../services/orchestrator/types.ts","../services/overview/index.ts","../services/overview/sql.ts","../services/pipelines/enrichment.ts","../services/pipelines/events.ts","../services/pipelines/execution-builder.ts","../services/pipelines/index.ts","../services/pipelines/queries.ts","../services/pipelines/sql.ts","../services/pipelines/types.ts","../services/role/index.ts","../services/role/sql.ts","../services/role/types.ts","../services/task/crud.ts","../services/task/index.ts","../services/task/process.ts","../services/task/resolve.ts","../services/task/sql.ts","../services/task/types.ts","../services/topics/index.ts","../services/topics/sql.ts","../services/topics/system-topics.ts","../services/user/auth.ts","../services/user/crud.ts","../services/user/index.ts","../services/user/rbac.ts","../services/user/roles.ts","../services/user/seed-admin.ts","../services/user/sql.ts","../services/user/sso-provision.ts","../services/user/types.ts","../services/workers/registry.ts","../services/workflow-sets/db.ts","../services/workflow-sets/index.ts","../services/workflow-sets/sql.ts","../services/yaml-workflow/builder-regenerate.ts","../services/yaml-workflow/db-utils.ts","../services/yaml-workflow/db-versions.ts","../services/yaml-workflow/db.ts","../services/yaml-workflow/deployer-helpers.ts","../services/yaml-workflow/deployer.ts","../services/yaml-workflow/generator.ts","../services/yaml-workflow/index.ts","../services/yaml-workflow/input-analyzer-helpers.ts","../services/yaml-workflow/input-analyzer.ts","../services/yaml-workflow/invoke.ts","../services/yaml-workflow/sql.ts","../services/yaml-workflow/types.ts","../services/yaml-workflow/durable-compiler/index.ts","../services/yaml-workflow/durable-compiler/parser.ts","../services/yaml-workflow/durable-compiler/prompts.ts","../services/yaml-workflow/durable-compiler/types.ts","../services/yaml-workflow/pattern-detector/array-source.ts","../services/yaml-workflow/pattern-detector/collapse.ts","../services/yaml-workflow/pattern-detector/index.ts","../services/yaml-workflow/pattern-detector/run-detection.ts","../services/yaml-workflow/pattern-detector/types.ts","../services/yaml-workflow/pipeline/analyze.ts","../services/yaml-workflow/pipeline/extract-helpers.ts","../services/yaml-workflow/pipeline/extract.ts","../services/yaml-workflow/pipeline/index.ts","../services/yaml-workflow/pipeline/prompt-templates.ts","../services/yaml-workflow/pipeline/prompts.ts","../services/yaml-workflow/pipeline/validate.ts","../services/yaml-workflow/pipeline/build/dag-assembly.ts","../services/yaml-workflow/pipeline/build/dag.ts","../services/yaml-workflow/pipeline/build/index.ts","../services/yaml-workflow/pipeline/build/iteration.ts","../services/yaml-workflow/pipeline/build/metadata.ts","../services/yaml-workflow/pipeline/build/transform.ts","../services/yaml-workflow/pipeline/build/utils.ts","../services/yaml-workflow/pipeline/build/wiring.ts","../services/yaml-workflow/pipeline/compile/index.ts","../services/yaml-workflow/pipeline/compile/llm-call.ts","../services/yaml-workflow/pipeline/compile/parse-plan.ts","../services/yaml-workflow/pipeline/compile/summarize.ts","../services/yaml-workflow/workers/callbacks.ts","../services/yaml-workflow/workers/events.ts","../services/yaml-workflow/workers/index.ts","../services/yaml-workflow/workers/register.ts","../services/yaml-workflow/workers/scope.ts","../start/adapters.ts","../start/config.ts","../start/index.ts","../start/server.ts","../start/socket-auth.ts","../start/workers.ts","../system/index.ts","../system/activities/claude-code.ts","../system/activities/file-storage.ts","../system/activities/http.ts","../system/activities/knowledge.ts","../system/activities/oauth.ts","../system/activities/schema-exchange.ts","../system/activities/sql.ts","../system/activities/triage/cache.ts","../system/activities/triage/context.ts","../system/activities/triage/discovery.ts","../system/activities/triage/index.ts","../system/activities/triage/llm.ts","../system/activities/triage/tools.ts","../system/mcp-servers/claude-code.ts","../system/mcp-servers/docs.ts","../system/mcp-servers/events.ts","../system/mcp-servers/file-storage.ts","../system/mcp-servers/http-fetch.ts","../system/mcp-servers/human-queue-schemas.ts","../system/mcp-servers/human-queue.ts","../system/mcp-servers/knowledge.ts","../system/mcp-servers/oauth.ts","../system/mcp-servers/schema-exchange.ts","../system/mcp-servers/translation.ts","../system/mcp-servers/vision-prompts.ts","../system/mcp-servers/vision.ts","../system/mcp-servers/workflow-compiler.ts","../system/mcp-servers/workflow.ts","../system/mcp-servers/admin/agent-subscriptions.ts","../system/mcp-servers/admin/agents.ts","../system/mcp-servers/admin/bot-accounts.ts","../system/mcp-servers/admin/controlplane.ts","../system/mcp-servers/admin/escalations.ts","../system/mcp-servers/admin/exports.ts","../system/mcp-servers/admin/index.ts","../system/mcp-servers/admin/maintenance.ts","../system/mcp-servers/admin/mcp-servers.ts","../system/mcp-servers/admin/overview.ts","../system/mcp-servers/admin/pipelines.ts","../system/mcp-servers/admin/schemas.ts","../system/mcp-servers/admin/settings.ts","../system/mcp-servers/admin/tasks.ts","../system/mcp-servers/admin/topics.ts","../system/mcp-servers/admin/users.ts","../system/mcp-servers/admin/workflow-config.ts","../system/mcp-servers/admin/workflows.ts","../system/mcp-servers/admin/yaml-workflows.ts","../system/mcp-servers/db-query/index.ts","../system/mcp-servers/db-query/schemas.ts","../system/mcp-servers/db-query/tools.ts","../system/seed/index.ts","../system/seed/tool-manifests-admin.ts","../system/seed/tool-manifests-data.ts","../system/seed/tool-manifests-escalation.ts","../system/seed/tool-manifests-events.ts","../system/seed/tool-manifests-knowledge.ts","../system/seed/tool-manifests-workflows.ts","../system/workflows/tool-result-guard.ts","../system/workflows/capability-invoke/activities.ts","../system/workflows/capability-invoke/index.ts","../system/workflows/mcp-deterministic/activities.ts","../system/workflows/mcp-deterministic/index.ts","../system/workflows/mcp-query/index.ts","../system/workflows/mcp-query/prompts.ts","../system/workflows/mcp-query/strategy-advisors.ts","../system/workflows/mcp-query/types.ts","../system/workflows/mcp-query/activities/caches.ts","../system/workflows/mcp-query/activities/discovery.ts","../system/workflows/mcp-query/activities/index.ts","../system/workflows/mcp-query/activities/llm.ts","../system/workflows/mcp-query/activities/tool-executor.ts","../system/workflows/mcp-query/activities/tool-loader.ts","../system/workflows/mcp-query-router/activities.ts","../system/workflows/mcp-query-router/index.ts","../system/workflows/mcp-query-router/prompts.ts","../system/workflows/mcp-triage/activities-proxy.ts","../system/workflows/mcp-triage/index.ts","../system/workflows/mcp-triage/prompts.ts","../system/workflows/mcp-triage/response-builders.ts","../system/workflows/mcp-triage/response.ts","../system/workflows/mcp-triage/types.ts","../system/workflows/mcp-triage-deterministic/activities.ts","../system/workflows/mcp-triage-deterministic/index.ts","../system/workflows/mcp-triage-router/activities.ts","../system/workflows/mcp-triage-router/index.ts","../system/workflows/mcp-workflow-builder/index.ts","../system/workflows/mcp-workflow-builder/prompts.ts","../system/workflows/mcp-workflow-builder/activities/caches.ts","../system/workflows/mcp-workflow-builder/activities/index.ts","../system/workflows/mcp-workflow-builder/activities/llm.ts","../system/workflows/mcp-workflow-builder/activities/tool-loader.ts","../system/workflows/mcp-workflow-planner/index.ts","../system/workflows/mcp-workflow-planner/prompts.ts","../system/workflows/mcp-workflow-planner/activities/analyze.ts","../system/workflows/mcp-workflow-planner/activities/index.ts","../system/workflows/mcp-workflow-planner/activities/persist.ts","../system/workflows/mcp-workflow-planner/activities/plan.ts","../system/workflows/shared/discovery.ts","../system/workflows/shared/index.ts","../system/workflows/shared/llm-caller.ts","../system/workflows/shared/prompts.ts","../system/workflows/shared/strategy-advisors.ts","../system/workflows/shared/tool-executor.ts","../system/workflows/shared/tool-loader.ts","../system/workflows/shared/types.ts","../types/agent.ts","../types/auth.ts","../types/config.ts","../types/delegation.ts","../types/discovery.ts","../types/envelope.ts","../types/escalation-strategy.ts","../types/escalation.ts","../types/events.ts","../types/export.ts","../types/express.d.ts","../types/index.ts","../types/logger.ts","../types/maintenance.ts","../types/mcp.ts","../types/oauth.ts","../types/sdk.ts","../types/startup.ts","../types/task.ts","../types/telemetry.ts","../types/tool-context.ts","../types/user.ts","../types/workflow-set.ts","../types/workflow.ts","../types/yaml-workflow.ts","../workers/index.ts"],"version":"5.9.3"}

package/docs/api/http/mcp-endpoint.md

@@ -69,6 +69,74 @@ curl -X POST http://localhost:3000/mcp \
   -d '{"jsonrpc":"2.0","method":"tools/call","params":{"name":"get_settings","arguments":{}},"id":3}'
 ```
 
+## Claude Code Integration
+
+Connect Claude Code to your Long Tail instance as an MCP server. Once connected, Claude Code can discover and invoke all 110 tools — query escalations, manage workflows, store knowledge, and more.
+
+### Step 1: Get an API key
+
+Start Long Tail (`docker compose up -d --build`). The startup log shows two seeded API keys:
+
+```
+[seed-mcp] read key: lt_bot_<read-key>
+[seed-mcp] full key: lt_bot_<full-key>
+```
+
+The **read key** exposes 57 read-safe tools (queries, listings). The **full key** exposes all 110 tools.
+
+### Step 2: Configure Claude Code
+
+Copy the example config and add your API key:
+
+```bash
+cp .mcp.example.json .mcp.json
+```
+
+Edit `.mcp.json` and replace `<your-api-key>` with the key from step 1:
+
+```json
+{
+  "mcpServers": {
+    "long-tail": {
+      "type": "http",
+      "url": "http://localhost:3000/mcp",
+      "headers": {
+        "Authorization": "Bearer lt_bot_<your-api-key>"
+      }
+    }
+  }
+}
+```
+
+`.mcp.json` is gitignored (it contains secrets). `.mcp.example.json` is committed as a template — same pattern as `.env` and `.env.example`.
+
+Or use the CLI:
+
+```bash
+claude mcp add --transport http long-tail http://localhost:3000/mcp \
+  --header "Authorization: Bearer lt_bot_<your-key>"
+```
+
+### Step 3: Verify
+
+Restart Claude Code, then try:
+
+> "How's the system doing?"
+
+Claude Code calls `get_system_overview` — one call returns triage, throughput, trends, infrastructure, and process status. Try more:
+
+> "What roles exist in the system?"
+
+> "Show me the most recent worker stream message"
+
+> "List all pending escalations"
+
+> "Store a knowledge entry: domain=notes, key=today, data={message: 'shipped MCP'}"
+
+> "What MCP servers are registered?"
+
+---
+
 ## Authentication
 
 Two token types are supported:

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hotmeshio/long-tail",
-  "version": "0.4.23",
+  "version": "0.5.0",
   "description": "Long Tail Workflows — Durable AI workflows with human-in-the-loop escalation. Powered by PostgreSQL.",
   "main": "./build/index.js",
   "types": "./build/index.d.ts",
@@ -70,7 +70,7 @@
     "@anthropic-ai/sdk": "^0.92.0",
     "@aws-sdk/client-s3": "^3.1017.0",
     "@aws-sdk/s3-request-presigner": "^3.1045.0",
-    "@hotmeshio/hotmesh": "^0.19.5",
+    "@hotmeshio/hotmesh": "^0.20.1",
     "@modelcontextprotocol/sdk": "^1.27.1",
     "@opentelemetry/exporter-trace-otlp-proto": "^0.215.0",
     "@opentelemetry/resources": "^2.5.1",