@hotmeshio/long-tail 0.1.5 → 0.1.7

package/build/routes/insight.js

@@ -1,7 +1,40 @@
 "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 insight_1 = require("../services/insight");
+const api = __importStar(require("../api/insight"));
 const router = (0, express_1.Router)();
 /**
  * POST /api/insight/mcp-query
@@ -9,33 +42,30 @@ const router = (0, express_1.Router)();
  * Body: { prompt: string, tags?: string[], wait?: boolean, direct?: boolean }
  */
 router.post('/mcp-query', async (req, res) => {
-    try {
-        const { prompt, tags, wait, direct, context } = req.body;
-        if (!prompt || typeof prompt !== 'string') {
-            res.status(400).json({ error: 'prompt is required' });
-            return;
-        }
-        if (!process.env.OPENAI_API_KEY && !process.env.ANTHROPIC_API_KEY) {
-            res.status(503).json({ error: 'MCP queries require an LLM API key (OPENAI_API_KEY or ANTHROPIC_API_KEY)' });
-            return;
-        }
-        const result = await (0, insight_1.startMcpQuery)({
-            prompt,
-            tags,
-            wait,
-            direct,
-            context,
-            userId: req.auth?.userId,
-        });
-        res.json(result);
-    }
-    catch (err) {
-        if (err.message?.includes('timeout') || err.message?.includes('TIMEOUT')) {
-            res.status(504).json({ error: 'MCP query timed out. Try a simpler prompt.' });
-            return;
-        }
-        res.status(500).json({ error: err.message });
-    }
+    const { prompt, tags, wait, direct, context } = req.body;
+    const result = await api.mcpQuery({ prompt, tags, wait, direct, context }, req.auth ? { userId: req.auth.userId } : undefined);
+    res.status(result.status).json(result.data ?? { error: result.error });
+});
+/**
+ * POST /api/insight/build-workflow
+ * Build a HotMesh YAML DAG directly from a natural language description.
+ * The LLM reasons about tool schemas and constructs the YAML declaratively.
+ * Body: { prompt: string, tags?: string[], wait?: boolean, feedback?: string, prior_yaml?: string }
+ */
+router.post('/build-workflow', async (req, res) => {
+    const { prompt, tags, wait, feedback, prior_yaml, answers, prior_questions } = req.body;
+    const result = await api.buildWorkflow({ prompt, tags, wait, feedback, prior_yaml, answers, prior_questions }, req.auth ? { userId: req.auth.userId } : undefined);
+    res.status(result.status).json(result.data ?? { error: result.error });
+});
+/**
+ * POST /api/insight/build-workflow/refine
+ * Refine a previously built workflow using execution feedback.
+ * Body: { prompt: string, prior_yaml: string, feedback: string, tags?: string[], wait?: boolean }
+ */
+router.post('/build-workflow/refine', async (req, res) => {
+    const { prompt, prior_yaml, feedback, tags, wait } = req.body;
+    const result = await api.refineWorkflow({ prompt, prior_yaml, feedback, tags, wait }, req.auth ? { userId: req.auth.userId } : undefined);
+    res.status(result.status).json(result.data ?? { error: result.error });
 });
 /**
  * POST /api/insight/mcp-query/describe
@@ -43,17 +73,8 @@ router.post('/mcp-query', async (req, res) => {
  * Body: { prompt: string, result_title?: string, result_summary?: string }
  */
 router.post('/mcp-query/describe', async (req, res) => {
-    try {
-        const { prompt, result_title, result_summary } = req.body;
-        if (!prompt) {
-            res.status(400).json({ error: 'prompt is required' });
-            return;
-        }
-        const result = await (0, insight_1.describeWorkflow)({ prompt, result_title, result_summary });
-        res.json(result);
-    }
-    catch {
-        res.json({ description: req.body.prompt || '', tags: [] });
-    }
+    const { prompt, result_title, result_summary } = req.body;
+    const result = await api.describeWorkflow({ prompt, result_title, result_summary });
+    res.status(result.status).json(result.data ?? { error: result.error });
 });
 exports.default = router;

package/build/routes/maintenance.js

@@ -1,7 +1,40 @@
 "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 maintenance_1 = require("../services/maintenance");
+const api = __importStar(require("../api/maintenance"));
 const auth_1 = require("../modules/auth");
 const router = (0, express_1.Router)();
 /**
@@ -9,8 +42,8 @@ const router = (0, express_1.Router)();
  * Return the current maintenance configuration.
  */
 router.get('/', (_req, res) => {
-    const config = maintenance_1.maintenanceRegistry.config;
-    res.json({ config, active: maintenance_1.maintenanceRegistry.hasConfig });
+    const result = api.getMaintenanceConfig();
+    res.status(result.status).json(result.data ?? { error: result.error });
 });
 /**
  * PUT /api/config/maintenance
@@ -20,19 +53,10 @@ router.get('/', (_req, res) => {
  * Body: { schedule: string, rules: LTMaintenanceRule[] }
  */
 router.put('/', auth_1.requireAdmin, async (req, res) => {
-    try {
-        const { schedule, rules } = req.body;
-        if (!schedule || !Array.isArray(rules)) {
-            res.status(400).json({ error: 'schedule (string) and rules (array) are required' });
-            return;
-        }
-        await maintenance_1.maintenanceRegistry.disconnect();
-        maintenance_1.maintenanceRegistry.register({ schedule, rules });
-        await maintenance_1.maintenanceRegistry.connect();
-        res.json({ config: maintenance_1.maintenanceRegistry.config, restarted: true });
-    }
-    catch (err) {
-        res.status(500).json({ error: err.message });
-    }
+    const result = await api.updateMaintenanceConfig({
+        schedule: req.body?.schedule,
+        rules: req.body?.rules,
+    });
+    res.status(result.status).json(result.data ?? { error: result.error });
 });
 exports.default = router;

package/build/routes/mcp-runs.js

@@ -1,8 +1,40 @@
 "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 hotmesh_utils_1 = require("../services/hotmesh-utils");
-const mcp_runs_1 = require("../services/mcp-runs");
+const api = __importStar(require("../api/mcp-runs"));
 const router = (0, express_1.Router)();
 // ── Routes ───────────────────────────────────────────────────────────────────
 /**
@@ -11,75 +43,35 @@ const router = (0, express_1.Router)();
  * supplemented with graph_topics from yaml_workflows for this app_id.
  */
 router.get('/entities', async (req, res) => {
-    try {
-        const rawAppId = req.query.app_id;
-        if (!rawAppId) {
-            res.status(400).json({ error: 'app_id query parameter is required' });
-            return;
-        }
-        const entities = await (0, mcp_runs_1.listEntities)(rawAppId);
-        res.json({ entities });
-    }
-    catch (err) {
-        if (err.message?.includes('does not exist')) {
-            res.json({ entities: [] });
-            return;
-        }
-        res.status(500).json({ error: err.message });
-    }
+    const result = await api.listEntities({
+        app_id: req.query.app_id,
+    });
+    res.status(result.status).json(result.data ?? { error: result.error });
 });
 /**
  * GET /api/mcp-runs
  * List jobs from {appId}.jobs for a given app_id.
  */
 router.get('/', async (req, res) => {
-    try {
-        const rawAppId = req.query.app_id;
-        if (!rawAppId) {
-            res.status(400).json({ error: 'app_id query parameter is required' });
-            return;
-        }
-        const result = await (0, mcp_runs_1.listJobs)({
-            rawAppId,
-            limit: parseInt(req.query.limit) || undefined,
-            offset: parseInt(req.query.offset) || undefined,
-            entity: req.query.entity || undefined,
-            search: req.query.search || undefined,
-            status: req.query.status || undefined,
-        });
-        res.json(result);
-    }
-    catch (err) {
-        if (err.message?.includes('does not exist')) {
-            res.json({ jobs: [], total: 0 });
-            return;
-        }
-        res.status(500).json({ error: err.message });
-    }
+    const result = await api.listJobs({
+        app_id: req.query.app_id,
+        limit: parseInt(req.query.limit) || undefined,
+        offset: parseInt(req.query.offset) || undefined,
+        entity: req.query.entity || undefined,
+        search: req.query.search || undefined,
+        status: req.query.status || undefined,
+    });
+    res.status(result.status).json(result.data ?? { error: result.error });
 });
 /**
  * GET /api/mcp-runs/:jobId/execution
  * Export execution details for a specific HotMesh pipeline job.
  */
 router.get('/:jobId/execution', async (req, res) => {
-    try {
-        const rawAppId = req.query.app_id;
-        if (!rawAppId) {
-            res.status(400).json({ error: 'app_id query parameter is required' });
-            return;
-        }
-        const appId = (0, hotmesh_utils_1.sanitizeAppId)(rawAppId);
-        const schema = (0, hotmesh_utils_1.quoteSchema)(appId);
-        const execution = await (0, mcp_runs_1.buildExecution)(req.params.jobId, appId, schema);
-        res.json(execution);
-    }
-    catch (err) {
-        const msg = err.message ?? '';
-        if (err.status === 404 || msg.includes('not found') || msg.includes('does not exist')) {
-            res.status(404).json({ error: msg });
-            return;
-        }
-        res.status(500).json({ error: msg });
-    }
+    const result = await api.getJobExecution({
+        jobId: req.params.jobId,
+        app_id: req.query.app_id,
+    });
+    res.status(result.status).json(result.data ?? { error: result.error });
 });
 exports.default = router;

package/build/routes/mcp.js

@@ -34,8 +34,7 @@ var __importStar = (this && this.__importStar) || (function () {
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
 const express_1 = require("express");
-const mcpDbService = __importStar(require("../services/mcp/db"));
-const mcp_1 = require("../services/mcp");
+const api = __importStar(require("../api/mcp"));
 const router = (0, express_1.Router)();
 // ── Server registration CRUD ──────────────────────────────────────────
 /**
@@ -43,51 +42,45 @@ const router = (0, express_1.Router)();
  * List registered MCP servers.
  */
 router.get('/servers', async (req, res) => {
-    try {
-        const tagsParam = req.query.tags;
-        const result = await mcpDbService.listMcpServers({
-            status: req.query.status,
-            auto_connect: req.query.auto_connect === 'true' ? true :
-                req.query.auto_connect === 'false' ? false : undefined,
-            search: req.query.search,
-            tags: tagsParam ? tagsParam.split(',').map((t) => t.trim()).filter(Boolean) : undefined,
-            limit: req.query.limit ? parseInt(req.query.limit, 10) : undefined,
-            offset: req.query.offset ? parseInt(req.query.offset, 10) : undefined,
-        });
-        res.json(result);
-    }
-    catch (err) {
-        res.status(500).json({ error: err.message });
-    }
+    const tagsParam = req.query.tags;
+    const result = await api.listMcpServers({
+        status: req.query.status,
+        auto_connect: req.query.auto_connect === 'true' ? true :
+            req.query.auto_connect === 'false' ? false : undefined,
+        search: req.query.search,
+        tags: tagsParam ? tagsParam.split(',').map((t) => t.trim()).filter(Boolean) : undefined,
+        limit: req.query.limit ? parseInt(req.query.limit, 10) : undefined,
+        offset: req.query.offset ? parseInt(req.query.offset, 10) : undefined,
+    });
+    res.status(result.status).json(result.data ?? { error: result.error });
 });
 /**
  * POST /api/mcp/servers
  * Register a new MCP server.
  */
 router.post('/servers', async (req, res) => {
-    try {
-        const { name, description, transport_type, transport_config, auto_connect, metadata } = req.body;
-        if (!name || !transport_type || !transport_config) {
-            res.status(400).json({ error: 'name, transport_type, and transport_config are required' });
-            return;
-        }
-        const server = await mcpDbService.createMcpServer({
-            name,
-            description,
-            transport_type,
-            transport_config,
-            auto_connect,
-            metadata,
-        });
-        res.status(201).json(server);
-    }
-    catch (err) {
-        if (err.message?.includes('duplicate key') || err.code === '23505') {
-            res.status(409).json({ error: 'MCP server with that name already exists' });
-            return;
-        }
-        res.status(500).json({ error: err.message });
-    }
+    const { name, description, transport_type, transport_config, auto_connect, metadata, tags, compile_hints, credential_providers } = req.body;
+    const result = await api.createMcpServer({
+        name,
+        description,
+        transport_type,
+        transport_config,
+        auto_connect,
+        metadata,
+        tags,
+        compile_hints,
+        credential_providers,
+    });
+    res.status(result.status).json(result.data ?? { error: result.error });
+});
+/**
+ * POST /api/mcp/servers/test-connection
+ * Test connectivity to an MCP server without persisting it.
+ */
+router.post('/servers/test-connection', async (req, res) => {
+    const { transport_type, transport_config } = req.body;
+    const result = await api.testConnection({ transport_type, transport_config });
+    res.status(result.status).json(result.data ?? { error: result.error });
 });
 // ── Parameterized routes (must come after literal paths) ──────────────
 /**
@@ -95,51 +88,24 @@ router.post('/servers', async (req, res) => {
  * Get a specific MCP server.
  */
 router.get('/servers/:id', async (req, res) => {
-    try {
-        const server = await mcpDbService.getMcpServer(req.params.id);
-        if (!server) {
-            res.status(404).json({ error: 'MCP server not found' });
-            return;
-        }
-        res.json(server);
-    }
-    catch (err) {
-        res.status(500).json({ error: err.message });
-    }
+    const result = await api.getMcpServer({ id: req.params.id });
+    res.status(result.status).json(result.data ?? { error: result.error });
 });
 /**
  * PUT /api/mcp/servers/:id
  * Update an MCP server registration.
  */
 router.put('/servers/:id', async (req, res) => {
-    try {
-        const server = await mcpDbService.updateMcpServer(req.params.id, req.body);
-        if (!server) {
-            res.status(404).json({ error: 'MCP server not found' });
-            return;
-        }
-        res.json(server);
-    }
-    catch (err) {
-        res.status(500).json({ error: err.message });
-    }
+    const result = await api.updateMcpServer({ id: req.params.id, ...req.body });
+    res.status(result.status).json(result.data ?? { error: result.error });
 });
 /**
  * DELETE /api/mcp/servers/:id
  * Delete an MCP server registration.
  */
 router.delete('/servers/:id', async (req, res) => {
-    try {
-        const deleted = await mcpDbService.deleteMcpServer(req.params.id);
-        if (!deleted) {
-            res.status(404).json({ error: 'MCP server not found' });
-            return;
-        }
-        res.json({ deleted: true });
-    }
-    catch (err) {
-        res.status(500).json({ error: err.message });
-    }
+    const result = await api.deleteMcpServer({ id: req.params.id });
+    res.status(result.status).json(result.data ?? { error: result.error });
 });
 // ── Connection management ─────────────────────────────────────────────
 /**
@@ -147,36 +113,16 @@ router.delete('/servers/:id', async (req, res) => {
  * Connect to a registered MCP server.
  */
 router.post('/servers/:id/connect', async (req, res) => {
-    try {
-        const adapter = mcp_1.mcpRegistry.current;
-        if (!adapter) {
-            res.status(400).json({ error: 'MCP adapter not registered' });
-            return;
-        }
-        await adapter.connectClient(req.params.id);
-        res.json({ connected: true, serverId: req.params.id });
-    }
-    catch (err) {
-        res.status(500).json({ error: err.message });
-    }
+    const result = await api.connectMcpServer({ id: req.params.id });
+    res.status(result.status).json(result.data ?? { error: result.error });
 });
 /**
  * POST /api/mcp/servers/:id/disconnect
  * Disconnect from a specific MCP server.
  */
 router.post('/servers/:id/disconnect', async (req, res) => {
-    try {
-        const adapter = mcp_1.mcpRegistry.current;
-        if (!adapter) {
-            res.status(400).json({ error: 'MCP adapter not registered' });
-            return;
-        }
-        await adapter.disconnectClient(req.params.id);
-        res.json({ disconnected: true, serverId: req.params.id });
-    }
-    catch (err) {
-        res.status(500).json({ error: err.message });
-    }
+    const result = await api.disconnectMcpServer({ id: req.params.id });
+    res.status(result.status).json(result.data ?? { error: result.error });
 });
 // ── Credential status ────────────────────────────────────────────────
 /**
@@ -184,33 +130,8 @@ router.post('/servers/:id/disconnect', async (req, res) => {
  * Check which credential providers are required and which the user has.
  */
 router.get('/servers/:id/credential-status', async (req, res) => {
-    try {
-        const server = await mcpDbService.getMcpServer(req.params.id);
-        if (!server) {
-            res.status(404).json({ error: 'MCP server not found' });
-            return;
-        }
-        const required = server.credential_providers ?? [];
-        const registered = [];
-        const missing = [];
-        if (req.auth?.userId && required.length > 0) {
-            const { resolveCredential } = await Promise.resolve().then(() => __importStar(require('../services/iam/credentials')));
-            for (const provider of required) {
-                const cred = await resolveCredential({ id: req.auth.userId, type: 'user', roles: [] }, provider);
-                if (cred)
-                    registered.push(provider);
-                else
-                    missing.push(provider);
-            }
-        }
-        else {
-            missing.push(...required);
-        }
-        res.json({ required, registered, missing });
-    }
-    catch (err) {
-        res.status(500).json({ error: err.message });
-    }
+    const result = await api.getCredentialStatus({ id: req.params.id }, req.auth ? { userId: req.auth.userId } : undefined);
+    res.status(result.status).json(result.data ?? { error: result.error });
 });
 // ── Tool operations ───────────────────────────────────────────────────
 /**
@@ -218,18 +139,8 @@ router.get('/servers/:id/credential-status', async (req, res) => {
  * List tools available on a connected MCP server.
  */
 router.get('/servers/:id/tools', async (req, res) => {
-    try {
-        const adapter = mcp_1.mcpRegistry.current;
-        if (!adapter) {
-            res.status(400).json({ error: 'MCP adapter not registered' });
-            return;
-        }
-        const tools = await adapter.listTools(req.params.id);
-        res.json({ tools });
-    }
-    catch (err) {
-        res.status(500).json({ error: err.message });
-    }
+    const result = await api.listMcpServerTools({ id: req.params.id });
+    res.status(result.status).json(result.data ?? { error: result.error });
 });
 /**
  * POST /api/mcp/servers/:id/tools/:toolName/call
@@ -237,29 +148,12 @@ router.get('/servers/:id/tools', async (req, res) => {
  * Body: { arguments: { ... } }
  */
 router.post('/servers/:id/tools/:toolName/call', async (req, res) => {
-    try {
-        const adapter = mcp_1.mcpRegistry.current;
-        if (!adapter) {
-            res.status(400).json({ error: 'MCP adapter not registered' });
-            return;
-        }
-        const executeAs = req.body.execute_as;
-        const authContext = (executeAs || req.auth?.userId)
-            ? { userId: executeAs || req.auth?.userId }
-            : undefined;
-        const result = await adapter.callTool(req.params.id, req.params.toolName, req.body.arguments || {}, authContext);
-        res.json({ result });
-    }
-    catch (err) {
-        if (err.name === 'MissingCredentialError') {
-            res.status(422).json({
-                error: 'missing_credential',
-                provider: err.provider,
-                message: err.message,
-            });
-            return;
-        }
-        res.status(500).json({ error: err.message });
-    }
+    const result = await api.callMcpTool({
+        id: req.params.id,
+        toolName: req.params.toolName,
+        arguments: req.body.arguments,
+        execute_as: req.body.execute_as,
+    }, req.auth ? { userId: req.auth.userId } : undefined);
+    res.status(result.status).json(result.data ?? { error: result.error });
 });
 exports.default = router;