@hotmeshio/long-tail 0.1.15 → 0.1.17

package/build/start/workers.js

@@ -132,6 +132,39 @@ async function startWorkers(startConfig, workers, builtinMcpServerFactories) {
             (0, registry_1.registerWorker)(w.workflow.name, w.taskQueue);
         }
         logger_1.loggerRegistry.info(`[long-tail] workers started on queues: ${workers.map((w) => w.taskQueue).join(', ')}`);
+        // Seed workflow configs (insert-if-absent — DB is source of truth)
+        const workersWithConfig = workers.filter((w) => w.config);
+        if (workersWithConfig.length) {
+            const { seedWorkflowConfig } = await Promise.resolve().then(() => __importStar(require('../services/config/write')));
+            const { ltConfig } = await Promise.resolve().then(() => __importStar(require('../modules/ltconfig')));
+            for (const w of workersWithConfig) {
+                const workflowType = w.workflow.name;
+                const c = w.config;
+                try {
+                    const inserted = await seedWorkflowConfig({
+                        workflow_type: workflowType,
+                        task_queue: w.taskQueue,
+                        invocable: c.invocable ?? false,
+                        default_role: c.defaultRole ?? 'reviewer',
+                        description: c.description ?? null,
+                        roles: c.roles ?? [],
+                        invocation_roles: c.invocationRoles ?? [],
+                        consumes: c.consumes ?? [],
+                        tool_tags: c.toolTags ?? [],
+                        envelope_schema: c.envelopeSchema ?? null,
+                        resolver_schema: c.resolverSchema ?? null,
+                        cron_schedule: c.cronSchedule ?? null,
+                        execute_as: c.executeAs ?? null,
+                    });
+                    if (inserted)
+                        logger_1.loggerRegistry.info(`[long-tail] config seeded: ${workflowType}`);
+                }
+                catch (err) {
+                    logger_1.loggerRegistry.warn(`[long-tail] config seed failed for ${workflowType}: ${err.message}`);
+                }
+            }
+            ltConfig.invalidate();
+        }
         // Start maintenance cron
         if (maintenance_1.maintenanceRegistry.hasConfig) {
             await maintenance_1.maintenanceRegistry.connect();
@@ -145,15 +178,45 @@ async function startWorkers(startConfig, workers, builtinMcpServerFactories) {
             logger_1.loggerRegistry.info('[long-tail] MCP adapter connected');
         }
         // Register MCP server factories: built-in (from system/) + user-provided
+        // Both system and user factories can carry inline config for DB seeding.
         const { registerBuiltinServer } = await Promise.resolve().then(() => __importStar(require('../services/mcp/client')));
+        const { seedMcpServer, cleanStaleBuiltinServers } = await Promise.resolve().then(() => __importStar(require('../services/mcp/db')));
+        const userFactories = startConfig.mcp?.serverFactories ?? {};
+        // Resolve user factories — plain function or { factory, config }
+        const resolvedUserFactories = {};
+        for (const [name, entry] of Object.entries(userFactories)) {
+            if (typeof entry === 'function') {
+                resolvedUserFactories[name] = { factory: entry };
+            }
+            else {
+                resolvedUserFactories[name] = entry;
+            }
+        }
+        // Merge system (always have config) + user factories
         const allFactories = {
             ...builtinMcpServerFactories,
-            ...(startConfig.mcp?.serverFactories ?? {}),
+            ...resolvedUserFactories,
         };
-        for (const [name, factory] of Object.entries(allFactories)) {
-            registerBuiltinServer(name, factory);
+        // 1. Register all factories (runtime — always applied)
+        for (const [name, entry] of Object.entries(allFactories)) {
+            registerBuiltinServer(name, entry.factory);
         }
         logger_1.loggerRegistry.info(`[long-tail] ${Object.keys(allFactories).length} MCP server factories registered`);
+        // 2. Seed MCP server configs (insert-if-absent + drift log)
+        for (const [name, entry] of Object.entries(allFactories)) {
+            if (entry.config) {
+                try {
+                    const inserted = await seedMcpServer({ name, ...entry.config });
+                    if (inserted)
+                        logger_1.loggerRegistry.info(`[long-tail] MCP server seeded: ${name}`);
+                }
+                catch (err) {
+                    logger_1.loggerRegistry.warn(`[long-tail] MCP server seed failed for ${name}: ${err.message}`);
+                }
+            }
+        }
+        // 3. Clean stale builtin servers no longer in factory list
+        await cleanStaleBuiltinServers(Object.keys(allFactories));
         // Register workers for active YAML (deterministic) workflows
         await yamlWorkflowWorkers.registerAllActiveWorkers();
     }
@@ -163,9 +226,6 @@ async function startWorkers(startConfig, workers, builtinMcpServerFactories) {
         await events_1.eventRegistry.connect();
         logger_1.loggerRegistry.info('[long-tail] event adapters connected');
     }
-    // Seed system MCP servers (always)
-    const { seedSystemMcpServers } = await Promise.resolve().then(() => __importStar(require('../system/seed')));
-    await seedSystemMcpServers();
     // Ensure system bot account exists for cron/system-initiated workflows
     const { ensureSystemBot } = await Promise.resolve().then(() => __importStar(require('../services/iam/bots')));
     await ensureSystemBot().catch((err) => logger_1.loggerRegistry.warn(`[long-tail] system bot seed error: ${err.message}`));

package/build/system/index.d.ts

@@ -1,16 +1,18 @@
 /**
  * System workers and built-in MCP server factories.
  *
- * All MCP-powered workflows (triage, query, their routers and deterministic
- * counterparts) require an LLM API key. They load conditionally.
+ * All declarations carry inline `config` that seeds the DB on first boot.
+ * DB is the source of truth after seeding — startup never overwrites.
  */
-export declare function getSystemWorkers(): Array<{
+import type { LTWorkerConfig, LTMcpServerConfig } from '../types/startup';
+export type SystemWorkerEntry = {
     taskQueue: string;
     workflow: (...args: any[]) => any;
-}>;
-/**
- * Built-in MCP server factories.
- * Each entry maps a server name to a lazy factory that creates the McpServer instance.
- * Registered via `registerBuiltinServer()` in `services/mcp/client.ts`.
- */
-export declare const builtinMcpServerFactories: Record<string, () => Promise<any>>;
+    config?: LTWorkerConfig;
+};
+export declare function getSystemWorkers(): SystemWorkerEntry[];
+export type McpServerFactoryEntry = {
+    factory: () => Promise<any>;
+    config: LTMcpServerConfig;
+};
+export declare const builtinMcpServerFactories: Record<string, McpServerFactoryEntry>;

package/build/system/index.js

@@ -1,4 +1,10 @@
 "use strict";
+/**
+ * System workers and built-in MCP server factories.
+ *
+ * All declarations carry inline `config` that seeds the DB on first boot.
+ * DB is the source of truth after seeding — startup never overwrites.
+ */
 var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
     if (k2 === undefined) k2 = k;
     var desc = Object.getOwnPropertyDescriptor(m, k);
@@ -35,80 +41,247 @@ var __importStar = (this && this.__importStar) || (function () {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.builtinMcpServerFactories = void 0;
 exports.getSystemWorkers = getSystemWorkers;
-/**
- * System workers and built-in MCP server factories.
- *
- * All MCP-powered workflows (triage, query, their routers and deterministic
- * counterparts) require an LLM API key. They load conditionally.
- */
+// ── Tool manifests (static JSON schema data) ────────────────────────────────
+const tool_manifests_escalation_1 = require("./seed/tool-manifests-escalation");
+const tool_manifests_data_1 = require("./seed/tool-manifests-data");
+const tool_manifests_browser_1 = require("./seed/tool-manifests-browser");
+const tool_manifests_workflows_1 = require("./seed/tool-manifests-workflows");
+const tool_manifests_admin_1 = require("./seed/tool-manifests-admin");
+const tool_manifests_knowledge_1 = require("./seed/tool-manifests-knowledge");
+// Gmail is an example connector — loaded conditionally (not in npm package)
+let GMAIL_TOOLS = [];
+try {
+    GMAIL_TOOLS = require('../examples/seed/tool-manifests-gmail').GMAIL_TOOLS;
+}
+catch { /* not available */ }
+// ── Role constants ──────────────────────────────────────────────────────────
+const SYSTEM_ROLES = ['reviewer', 'engineer', 'admin'];
+const ENGINEER = 'engineer';
+// ── System workflow configs ─────────────────────────────────────────────────
+const SYSTEM_WORKFLOW_BASE = {
+    defaultRole: ENGINEER,
+    roles: SYSTEM_ROLES,
+    invocable: false,
+};
+const systemWorkflowConfigs = {
+    mcpTriageRouter: {
+        ...SYSTEM_WORKFLOW_BASE,
+        description: 'Triage router — discovers compiled workflows for remediation, routes to deterministic or dynamic triage',
+    },
+    mcpTriageDeterministic: {
+        ...SYSTEM_WORKFLOW_BASE,
+        description: 'Deterministic triage — invokes matched compiled workflows for escalation remediation',
+    },
+    mcpTriage: {
+        ...SYSTEM_WORKFLOW_BASE,
+        description: 'Dynamic MCP triage — LLM agentic loop for escalation remediation',
+    },
+    mcpQueryRouter: {
+        ...SYSTEM_WORKFLOW_BASE,
+        description: 'Do anything with tools — browser automation, file operations, HTTP requests, database queries, document processing, and more',
+        envelopeSchema: {
+            data: { prompt: 'Describe what you want to accomplish using available tools...' },
+            metadata: { source: 'dashboard' },
+        },
+    },
+    mcpQuery: {
+        ...SYSTEM_WORKFLOW_BASE,
+        description: 'Dynamic MCP tool orchestration — LLM agentic loop with raw MCP tools',
+    },
+    mcpDeterministic: {
+        ...SYSTEM_WORKFLOW_BASE,
+        description: 'Deterministic execution — invokes matched compiled YAML workflows with extracted inputs',
+    },
+    mcpWorkflowBuilder: {
+        ...SYSTEM_WORKFLOW_BASE,
+        description: 'Direct pipeline builder — LLM constructs DAG from tool schemas',
+    },
+    mcpWorkflowPlanner: {
+        ...SYSTEM_WORKFLOW_BASE,
+        description: 'Plan mode — decomposes specifications into multi-workflow sets',
+    },
+};
 function getSystemWorkers() {
     const workers = [];
     const hasLLM = process.env.OPENAI_API_KEY || process.env.ANTHROPIC_API_KEY;
     if (hasLLM) {
-        // ── Triage pipeline (router → deterministic | dynamic) ──
-        try {
-            const { mcpTriageRouter } = require('./workflows/mcp-triage-router');
-            workers.push({ taskQueue: 'long-tail-system', workflow: mcpTriageRouter });
+        const pairs = [
+            { mod: './workflows/mcp-triage-router', name: 'mcpTriageRouter' },
+            { mod: './workflows/mcp-triage-deterministic', name: 'mcpTriageDeterministic' },
+            { mod: './workflows/mcp-triage', name: 'mcpTriage' },
+            { mod: './workflows/mcp-query-router', name: 'mcpQueryRouter' },
+            { mod: './workflows/mcp-query', name: 'mcpQuery' },
+            { mod: './workflows/mcp-deterministic', name: 'mcpDeterministic' },
+            { mod: './workflows/mcp-workflow-builder', name: 'mcpWorkflowBuilder' },
+            { mod: './workflows/mcp-workflow-planner', name: 'mcpWorkflowPlanner' },
+        ];
+        for (const { mod, name } of pairs) {
+            try {
+                const wf = require(mod)[name];
+                workers.push({
+                    taskQueue: 'long-tail-system',
+                    workflow: wf,
+                    config: systemWorkflowConfigs[name],
+                });
+            }
+            catch { /* module not available */ }
         }
-        catch { /* not available */ }
-        try {
-            const { mcpTriageDeterministic } = require('./workflows/mcp-triage-deterministic');
-            workers.push({ taskQueue: 'long-tail-system', workflow: mcpTriageDeterministic });
-        }
-        catch { /* not available */ }
-        try {
-            const { mcpTriage } = require('./workflows/mcp-triage');
-            workers.push({ taskQueue: 'long-tail-system', workflow: mcpTriage });
-        }
-        catch { /* not available */ }
-        // ── Query pipeline (router → deterministic | dynamic) ──
-        try {
-            const { mcpQueryRouter } = require('./workflows/mcp-query-router');
-            workers.push({ taskQueue: 'long-tail-system', workflow: mcpQueryRouter });
-        }
-        catch { /* not available */ }
-        try {
-            const { mcpQuery } = require('./workflows/mcp-query');
-            workers.push({ taskQueue: 'long-tail-system', workflow: mcpQuery });
-        }
-        catch { /* not available */ }
-        try {
-            const { mcpDeterministic } = require('./workflows/mcp-deterministic');
-            workers.push({ taskQueue: 'long-tail-system', workflow: mcpDeterministic });
-        }
-        catch { /* not available */ }
-        // ── Workflow builder (direct YAML construction) ──
-        try {
-            const { mcpWorkflowBuilder } = require('./workflows/mcp-workflow-builder');
-            workers.push({ taskQueue: 'long-tail-system', workflow: mcpWorkflowBuilder });
-        }
-        catch { /* not available */ }
-        // ── Workflow planner (multi-workflow plan mode) ──
-        try {
-            const { mcpWorkflowPlanner } = require('./workflows/mcp-workflow-planner');
-            workers.push({ taskQueue: 'long-tail-system', workflow: mcpWorkflowPlanner });
-        }
-        catch { /* not available */ }
     }
     return workers;
 }
-/**
- * Built-in MCP server factories.
- * Each entry maps a server name to a lazy factory that creates the McpServer instance.
- * Registered via `registerBuiltinServer()` in `services/mcp/client.ts`.
- */
 exports.builtinMcpServerFactories = {
-    'long-tail-human-queue': () => Promise.resolve().then(() => __importStar(require('./mcp-servers/human-queue'))).then((m) => m.createHumanQueueServer()),
-    'long-tail-translation': () => Promise.resolve().then(() => __importStar(require('./mcp-servers/translation'))).then((m) => m.createTranslationServer()),
-    'long-tail-vision': () => Promise.resolve().then(() => __importStar(require('./mcp-servers/vision'))).then((m) => m.createVisionServer()),
-    'long-tail-playwright': () => Promise.resolve().then(() => __importStar(require('./mcp-servers/playwright'))).then((m) => m.createPlaywrightServer()),
-    'long-tail-playwright-cli': () => Promise.resolve().then(() => __importStar(require('./mcp-servers/playwright-cli'))).then((m) => m.createPlaywrightCliServer()),
-    'long-tail-file-storage': () => Promise.resolve().then(() => __importStar(require('./mcp-servers/file-storage'))).then((m) => m.createFileStorageServer()),
-    'long-tail-http-fetch': () => Promise.resolve().then(() => __importStar(require('./mcp-servers/http-fetch'))).then((m) => m.createHttpFetchServer()),
-    'long-tail-oauth': () => Promise.resolve().then(() => __importStar(require('./mcp-servers/oauth'))).then((m) => m.createOAuthServer()),
-    'long-tail-docs': () => Promise.resolve().then(() => __importStar(require('./mcp-servers/docs'))).then((m) => m.createDocsServer()),
-    'long-tail-claude-code': () => Promise.resolve().then(() => __importStar(require('./mcp-servers/claude-code'))).then((m) => m.createClaudeCodeServer()),
-    'long-tail-admin': () => Promise.resolve().then(() => __importStar(require('./mcp-servers/admin'))).then((m) => m.createAdminServer()),
-    'long-tail-knowledge': () => Promise.resolve().then(() => __importStar(require('./mcp-servers/knowledge'))).then((m) => m.createKnowledgeServer()),
-    'long-tail-schema-exchange': () => Promise.resolve().then(() => __importStar(require('./mcp-servers/schema-exchange'))).then((m) => m.createSchemaExchangeServer()),
+    'long-tail-human-queue': {
+        factory: () => Promise.resolve().then(() => __importStar(require('./mcp-servers/human-queue'))).then((m) => m.createHumanQueueServer()),
+        config: {
+            description: 'Built-in escalation and human queue management. Exposes the escalation API as MCP tools for AI agents and remediation workflows.',
+            tags: ['escalation', 'human-queue', 'routing'],
+            compileHints: [
+                'escalate_and_wait creates a durable pause point.',
+                'The step AFTER escalate_and_wait is always a signal step (kind: "signal") that receives the human response.',
+                'Fields from the signal step output (e.g., password) must be wired via data_flow edges to ALL downstream steps that need them.',
+            ].join(' '),
+            toolManifest: tool_manifests_escalation_1.HUMAN_QUEUE_TOOLS,
+        },
+    },
+    'long-tail-translation': {
+        factory: () => Promise.resolve().then(() => __importStar(require('./mcp-servers/translation'))).then((m) => m.createTranslationServer()),
+        config: {
+            description: 'Text translation using LLM. Translates content between languages with automatic source language detection.',
+            tags: ['translation', 'language', 'text-processing'],
+            credentialProviders: ['anthropic'],
+            toolManifest: tool_manifests_data_1.TRANSLATION_TOOLS,
+        },
+    },
+    'long-tail-vision': {
+        factory: () => Promise.resolve().then(() => __importStar(require('./mcp-servers/vision'))).then((m) => m.createVisionServer()),
+        config: {
+            description: 'Image analysis and description using LLM vision. Analyzes images to extract structured data, text content, and descriptions.',
+            tags: ['vision', 'image-analysis', 'multimodal'],
+            compileHints: [
+                'Vision tools process one image at a time.',
+                'The argument name is `image` (NOT `image_path`). It accepts a storage path, data URI, or https:// URL.',
+                'Vision tools do NOT use browser sessions. Do NOT wire page_id or _handle to vision tools.',
+                'analyze_image output fields: description (string), text_content (string), objects (array).',
+            ].join(' '),
+            credentialProviders: ['anthropic'],
+            toolManifest: tool_manifests_data_1.VISION_ANALYSIS_TOOLS,
+        },
+    },
+    'long-tail-playwright': {
+        factory: () => Promise.resolve().then(() => __importStar(require('./mcp-servers/playwright'))).then((m) => m.createPlaywrightServer()),
+        config: {
+            description: 'Low-level browser automation via Playwright. Fine-grained control: navigate, click, fill, wait_for, evaluate, run_script.',
+            tags: ['browser-automation', 'testing', 'screenshots'],
+            compileHints: [
+                'Session fields (_handle, page_id) MUST be threaded from the step that created them to EVERY subsequent browser step.',
+                'run_script accepts a `steps` array — fixed implementation detail, never a dynamic input.',
+                'run_script exposes `screenshots` (array) and `last_screenshot_path` (string) as output fields.',
+            ].join(' '),
+            toolManifest: tool_manifests_browser_1.PLAYWRIGHT_TOOLS,
+        },
+    },
+    'long-tail-playwright-cli': {
+        factory: () => Promise.resolve().then(() => __importStar(require('./mcp-servers/playwright-cli'))).then((m) => m.createPlaywrightCliServer()),
+        config: {
+            description: 'High-level browser automation. Intent-based tools that handle session management, timing, and error recovery internally.',
+            tags: ['browser-automation', 'screenshots', 'scraping', 'forms'],
+            compileHints: [
+                'Session fields (_handle, page_id) MUST be threaded from producing step to ALL subsequent browser steps.',
+                'extract_content returns `links` (structured array) and `script_result` (raw). Use `links` as the source field.',
+                'capture_page screenshot_path MUST include a file extension (.png).',
+            ].join(' '),
+            toolManifest: tool_manifests_browser_1.PLAYWRIGHT_CLI_TOOLS,
+        },
+    },
+    'long-tail-docs': {
+        factory: () => Promise.resolve().then(() => __importStar(require('./mcp-servers/docs'))).then((m) => m.createDocsServer()),
+        config: {
+            description: 'Product documentation search and retrieval. List, search, and read Long Tail documentation.',
+            tags: ['documentation', 'help', 'reference'],
+            toolManifest: tool_manifests_data_1.DOCS_TOOLS,
+        },
+    },
+    'long-tail-file-storage': {
+        factory: () => Promise.resolve().then(() => __importStar(require('./mcp-servers/file-storage'))).then((m) => m.createFileStorageServer()),
+        config: {
+            description: 'Managed file storage for reading, writing, listing, and deleting files.',
+            tags: ['storage', 'files', 'io'],
+            toolManifest: tool_manifests_data_1.FILE_STORAGE_TOOLS,
+        },
+    },
+    'long-tail-http-fetch': {
+        factory: () => Promise.resolve().then(() => __importStar(require('./mcp-servers/http-fetch'))).then((m) => m.createHttpFetchServer()),
+        config: {
+            description: 'HTTP client tools for making GET, POST, and arbitrary HTTP requests.',
+            tags: ['http', 'api', 'fetch', 'network'],
+            compileHints: 'HTTP response bodies may be large. Prefer specific fields from parsed JSON rather than raw body.',
+            toolManifest: tool_manifests_data_1.HTTP_FETCH_TOOLS,
+        },
+    },
+    'long-tail-oauth': {
+        factory: () => Promise.resolve().then(() => __importStar(require('./mcp-servers/oauth'))).then((m) => m.createOAuthServer()),
+        config: {
+            description: 'OAuth token management. Get fresh access tokens for external services. Handles automatic token refresh.',
+            tags: ['authentication', 'oauth', 'credentials'],
+            compileHints: 'get_access_token returns a short-lived token. Call immediately before authenticated API requests — do not cache across steps.',
+            toolManifest: tool_manifests_data_1.OAUTH_TOOLS,
+        },
+    },
+    'long-tail-claude-code': {
+        factory: () => Promise.resolve().then(() => __importStar(require('./mcp-servers/claude-code'))).then((m) => m.createClaudeCodeServer()),
+        config: {
+            description: 'Agentic coding assistant via Claude Code CLI. Execute development tasks: code generation, refactoring, file analysis, and multi-step workflows.',
+            tags: ['development', 'coding', 'ai-agent', 'terminal', 'code-generation'],
+            compileHints: 'execute_task runs Claude Code as a subprocess. The `prompt` parameter is ALWAYS a dynamic trigger input. ' +
+                'Keep prompts self-contained. For read-only analysis, restrict with allowed_tools: ["Read", "Grep", "Glob"].',
+            credentialProviders: ['anthropic'],
+            toolManifest: tool_manifests_workflows_1.CLAUDE_CODE_TOOLS,
+        },
+    },
+    'long-tail-admin': {
+        factory: () => Promise.resolve().then(() => __importStar(require('./mcp-servers/admin'))).then((m) => m.createAdminServer()),
+        config: {
+            description: 'System administration tools for reflexive self-management. Certify workflows, update server tags, manage roles.',
+            tags: ['admin', 'system', 'configuration'],
+            compileHints: 'Admin tools modify system configuration. certify_workflow and decertify_workflow change interceptor behavior.',
+            toolManifest: tool_manifests_admin_1.ADMIN_TOOLS,
+        },
+    },
+    'long-tail-knowledge': {
+        factory: () => Promise.resolve().then(() => __importStar(require('./mcp-servers/knowledge'))).then((m) => m.createKnowledgeServer()),
+        config: {
+            description: 'Persistent knowledge store for autonomous agents. Store, retrieve, search, and accumulate JSONB documents in isolated domains.',
+            tags: ['knowledge', 'memory', 'state', 'storage'],
+            compileHints: 'store_knowledge: domain (string), key (string), data (object — MUST be JSON object, never string). ' +
+                'Upserts by domain+key. search_knowledge uses JSONB containment (@>). ' +
+                'append_knowledge adds to arrays without replacing. list_domains returns all domains with counts.',
+            toolManifest: tool_manifests_knowledge_1.KNOWLEDGE_TOOLS,
+        },
+    },
+    'long-tail-schema-exchange': {
+        factory: () => Promise.resolve().then(() => __importStar(require('./mcp-servers/schema-exchange'))).then((m) => m.createSchemaExchangeServer()),
+        config: {
+            description: 'Schema-driven data exchange with external service endpoints. Validates requests and responses against JSON Schema.',
+            tags: ['api', 'schema', 'exchange', 'validation', 'fetch'],
+            compileHints: 'Validates requests before sending and responses after receiving. ' +
+                'Embed request_schema and response_schema as STATIC values. ' +
+                'Exchange output: { status, data, headers, elapsed_ms, validated }. API response is in .data field. ' +
+                'For auth, prefer credential_provider over manual token wiring.',
+            toolManifest: tool_manifests_data_1.SCHEMA_EXCHANGE_TOOLS,
+        },
+    },
 };
+// Gmail is an example connector — only register when available (not in npm package)
+if (GMAIL_TOOLS.length > 0) {
+    exports.builtinMcpServerFactories['long-tail-gmail'] = {
+        factory: () => Promise.resolve().then(() => __importStar(require('../examples/mcp-servers/gmail'))).then((m) => m.createGmailServer()),
+        config: {
+            description: 'Gmail tools — search, read, summarize, extract, and draft emails using your connected Google account.',
+            tags: ['gmail', 'email', 'messaging', 'google'],
+            compileHints: 'Requires a connected Google account (OAuth). gmail_search finds messages, gmail_read gets full content, ' +
+                'gmail_summarize for threads, gmail_extract for structured data, gmail_draft for composing.',
+            credentialProviders: ['google'],
+            toolManifest: GMAIL_TOOLS,
+        },
+    };
+}

package/build/system/mcp-servers/playwright/schemas.d.ts

@@ -278,7 +278,7 @@ export declare const runScriptStepSchema: z.ZodObject<{
     not: z.ZodOptional<z.ZodBoolean>;
     describe: z.ZodOptional<z.ZodBoolean>;
 }, "strip", z.ZodTypeAny, {
-    action: "fill" | "navigate" | "screenshot" | "click" | "wait_for" | "wait_for_url" | "wait" | "evaluate";
+    action: "fill" | "navigate" | "screenshot" | "click" | "wait_for" | "evaluate" | "wait_for_url" | "wait";
     value?: string | undefined;
     not?: boolean | undefined;
     url?: string | undefined;
@@ -287,10 +287,10 @@ export declare const runScriptStepSchema: z.ZodObject<{
     wait_until?: "load" | "domcontentloaded" | "networkidle" | undefined;
     timeout?: number | undefined;
     full_page?: boolean | undefined;
-    describe?: boolean | undefined;
     script?: string | undefined;
+    describe?: boolean | undefined;
 }, {
-    action: "fill" | "navigate" | "screenshot" | "click" | "wait_for" | "wait_for_url" | "wait" | "evaluate";
+    action: "fill" | "navigate" | "screenshot" | "click" | "wait_for" | "evaluate" | "wait_for_url" | "wait";
     value?: string | undefined;
     not?: boolean | undefined;
     url?: string | undefined;
@@ -299,8 +299,8 @@ export declare const runScriptStepSchema: z.ZodObject<{
     wait_until?: "load" | "domcontentloaded" | "networkidle" | undefined;
     timeout?: number | undefined;
     full_page?: boolean | undefined;
-    describe?: boolean | undefined;
     script?: string | undefined;
+    describe?: boolean | undefined;
 }>;
 export declare const runScriptSchema: z.ZodObject<{
     _handle: z.ZodOptional<z.ZodObject<{
@@ -329,7 +329,7 @@ export declare const runScriptSchema: z.ZodObject<{
         not: z.ZodOptional<z.ZodBoolean>;
         describe: z.ZodOptional<z.ZodBoolean>;
     }, "strip", z.ZodTypeAny, {
-        action: "fill" | "navigate" | "screenshot" | "click" | "wait_for" | "wait_for_url" | "wait" | "evaluate";
+        action: "fill" | "navigate" | "screenshot" | "click" | "wait_for" | "evaluate" | "wait_for_url" | "wait";
         value?: string | undefined;
         not?: boolean | undefined;
         url?: string | undefined;
@@ -338,10 +338,10 @@ export declare const runScriptSchema: z.ZodObject<{
         wait_until?: "load" | "domcontentloaded" | "networkidle" | undefined;
         timeout?: number | undefined;
         full_page?: boolean | undefined;
-        describe?: boolean | undefined;
         script?: string | undefined;
+        describe?: boolean | undefined;
     }, {
-        action: "fill" | "navigate" | "screenshot" | "click" | "wait_for" | "wait_for_url" | "wait" | "evaluate";
+        action: "fill" | "navigate" | "screenshot" | "click" | "wait_for" | "evaluate" | "wait_for_url" | "wait";
         value?: string | undefined;
         not?: boolean | undefined;
         url?: string | undefined;
@@ -350,12 +350,12 @@ export declare const runScriptSchema: z.ZodObject<{
         wait_until?: "load" | "domcontentloaded" | "networkidle" | undefined;
         timeout?: number | undefined;
         full_page?: boolean | undefined;
-        describe?: boolean | undefined;
         script?: string | undefined;
+        describe?: boolean | undefined;
     }>, "many">;
 }, "strip", z.ZodTypeAny, {
     steps: {
-        action: "fill" | "navigate" | "screenshot" | "click" | "wait_for" | "wait_for_url" | "wait" | "evaluate";
+        action: "fill" | "navigate" | "screenshot" | "click" | "wait_for" | "evaluate" | "wait_for_url" | "wait";
         value?: string | undefined;
         not?: boolean | undefined;
         url?: string | undefined;
@@ -364,8 +364,8 @@ export declare const runScriptSchema: z.ZodObject<{
         wait_until?: "load" | "domcontentloaded" | "networkidle" | undefined;
         timeout?: number | undefined;
         full_page?: boolean | undefined;
-        describe?: boolean | undefined;
         script?: string | undefined;
+        describe?: boolean | undefined;
     }[];
     _handle?: {
         type: "playwright_page";
@@ -374,7 +374,7 @@ export declare const runScriptSchema: z.ZodObject<{
     } | undefined;
 }, {
     steps: {
-        action: "fill" | "navigate" | "screenshot" | "click" | "wait_for" | "wait_for_url" | "wait" | "evaluate";
+        action: "fill" | "navigate" | "screenshot" | "click" | "wait_for" | "evaluate" | "wait_for_url" | "wait";
         value?: string | undefined;
         not?: boolean | undefined;
         url?: string | undefined;
@@ -383,8 +383,8 @@ export declare const runScriptSchema: z.ZodObject<{
         wait_until?: "load" | "domcontentloaded" | "networkidle" | undefined;
         timeout?: number | undefined;
         full_page?: boolean | undefined;
-        describe?: boolean | undefined;
         script?: string | undefined;
+        describe?: boolean | undefined;
     }[];
     _handle?: {
         type: "playwright_page";

package/build/system/seed/index.d.ts

@@ -1,7 +0,0 @@
-import { SEED_MCP_SERVERS } from './server-definitions';
-export { SEED_MCP_SERVERS };
-/**
- * Seed system MCP servers into lt_mcp_servers.
- * Upserts each built-in server with its tool manifest, metadata, and tags.
- */
-export declare function seedSystemMcpServers(): Promise<void>;

package/build/system/seed/index.js

@@ -1,47 +1,6 @@
 "use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.SEED_MCP_SERVERS = void 0;
-exports.seedSystemMcpServers = seedSystemMcpServers;
-const db_1 = require("../../lib/db");
-const logger_1 = require("../../lib/logger");
-const sql_1 = require("../../services/mcp/sql");
-const server_definitions_1 = require("./server-definitions");
-Object.defineProperty(exports, "SEED_MCP_SERVERS", { enumerable: true, get: function () { return server_definitions_1.SEED_MCP_SERVERS; } });
-/**
- * Seed system MCP servers into lt_mcp_servers.
- * Upserts each built-in server with its tool manifest, metadata, and tags.
- */
-async function seedSystemMcpServers() {
-    const pool = (0, db_1.getPool)();
-    for (const srv of server_definitions_1.SEED_MCP_SERVERS) {
-        try {
-            await pool.query(sql_1.SEED_MCP_SERVER, [
-                srv.name,
-                srv.description,
-                srv.transport_type,
-                JSON.stringify(srv.transport_config),
-                JSON.stringify(srv.tool_manifest),
-                JSON.stringify(srv.metadata),
-                srv.tags,
-                srv.compile_hints,
-                srv.credential_providers || [],
-            ]);
-        }
-        catch (err) {
-            logger_1.loggerRegistry.warn(`[system] failed to seed MCP server ${srv.name}: ${err.message}`);
-        }
-    }
-    // Remove stale builtin servers no longer in the seed list
-    const seedNames = server_definitions_1.SEED_MCP_SERVERS.map(s => s.name);
-    try {
-        const { rows } = await pool.query(sql_1.DELETE_STALE_BUILTIN_SERVERS, [seedNames]);
-        for (const row of rows) {
-            logger_1.loggerRegistry.info(`[system] removed stale builtin MCP server: ${row.name}`);
-        }
-    }
-    catch (err) {
-        logger_1.loggerRegistry.warn(`[system] failed to clean stale MCP servers: ${err.message}`);
-    }
-    const totalTools = server_definitions_1.SEED_MCP_SERVERS.reduce((sum, s) => sum + s.tool_manifest.length, 0);
-    logger_1.loggerRegistry.info(`[system] MCP servers seeded (${server_definitions_1.SEED_MCP_SERVERS.length} servers, ${totalTools} tools)`);
-}
+// System seed module.
+// MCP server definitions and workflow configs are now declared inline
+// on their factories/workers in system/index.ts and seeded at startup
+// via insert-if-absent. This module is retained for backward compatibility
+// but no longer performs seeding.