@hotmeshio/long-tail 0.1.4 → 0.1.5

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

@@ -0,0 +1,45 @@
+"use strict";
+// ── Admin tool manifests ─────────────────────────────────────────────────────
+// Each entry mirrors the exact tool registered in system/mcp-servers/admin/
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ADMIN_TOOLS = void 0;
+exports.ADMIN_TOOLS = [
+    // ── tasks.ts ────────────────────────────────────────────────────────────
+    { name: 'find_tasks', description: 'Search tasks with optional filters. Returns task records with workflow_id, status, workflow_type, and timestamps.', inputSchema: { type: 'object', properties: { status: { type: 'string' }, workflow_type: { type: 'string' }, workflow_id: { type: 'string' }, origin_id: { type: 'string' }, limit: { type: 'integer' }, offset: { type: 'integer' } } } },
+    { name: 'get_process_detail', description: 'Get all tasks and escalations for a process (origin_id).', inputSchema: { type: 'object', properties: { origin_id: { type: 'string' } }, required: ['origin_id'] } },
+    // ── escalations.ts ──────────────────────────────────────────────────────
+    { name: 'find_escalations', description: 'Search escalations with optional filters by status, role, type, priority.', inputSchema: { type: 'object', properties: { status: { type: 'string', enum: ['pending', 'resolved'] }, role: { type: 'string' }, type: { type: 'string' }, priority: { type: 'integer' }, limit: { type: 'integer' }, offset: { type: 'integer' } } } },
+    { name: 'get_escalation_stats', description: 'Aggregated escalation statistics: pending, claimed, created, resolved counts with breakdown by role.', inputSchema: { type: 'object', properties: { period: { type: 'string' } } } },
+    { name: 'claim_escalation', description: 'Claim an escalation for a time-boxed lock.', inputSchema: { type: 'object', properties: { id: { type: 'string' }, duration_minutes: { type: 'integer' } }, required: ['id'] } },
+    { name: 'release_expired_claims', description: 'Release all escalation claims that exceeded their lock duration.', inputSchema: { type: 'object', properties: {} } },
+    { name: 'bulk_triage', description: 'Resolve escalations for triage and start mcpTriage workflows.', inputSchema: { type: 'object', properties: { ids: { type: 'array', items: { type: 'string' } }, hint: { type: 'string' } }, required: ['ids'] } },
+    // ── workflow-config.ts ──────────────────────────────────────────────────
+    { name: 'list_workflow_configs', description: 'List all certified workflow configurations with roles and settings.', inputSchema: { type: 'object', properties: {} } },
+    { name: 'upsert_workflow_config', description: 'Create or replace a workflow configuration (certify). Activates the interceptor for task tracking and escalation chains.', inputSchema: { type: 'object', properties: { workflow_type: { type: 'string' }, invocable: { type: 'boolean' }, task_queue: { type: 'string' }, default_role: { type: 'string' }, description: { type: 'string' }, execute_as: { type: 'string' }, roles: { type: 'array', items: { type: 'string' } }, invocation_roles: { type: 'array', items: { type: 'string' } }, consumes: { type: 'array', items: { type: 'string' } }, tool_tags: { type: 'array', items: { type: 'string' } }, cron_schedule: { type: 'string' } }, required: ['workflow_type'] } },
+    { name: 'delete_workflow_config', description: 'De-certify a workflow by removing its config entry.', inputSchema: { type: 'object', properties: { workflow_type: { type: 'string' } }, required: ['workflow_type'] } },
+    // ── workflows.ts ────────────────────────────────────────────────────────
+    { name: 'list_discovered_workflows', description: 'Unified list of all known workflows: active workers, historical entities, and registered configs.', inputSchema: { type: 'object', properties: { include_system: { type: 'boolean' } } } },
+    { name: 'invoke_workflow', description: 'Start a certified workflow by type. Returns workflow ID immediately.', inputSchema: { type: 'object', properties: { workflow_type: { type: 'string' }, data: { type: 'object' }, metadata: { type: 'object' }, execute_as: { type: 'string' } }, required: ['workflow_type', 'data'] } },
+    { name: 'get_workflow_status', description: 'Check workflow status and result. Returns status (0=complete, positive=running) and result if complete.', inputSchema: { type: 'object', properties: { workflow_id: { type: 'string' } }, required: ['workflow_id'] } },
+    // ── mcp-servers.ts ──────────────────────────────────────────────────────
+    { name: 'list_mcp_servers', description: 'List registered MCP servers with optional filters by status, tags, or search.', inputSchema: { type: 'object', properties: { status: { type: 'string' }, tags: { type: 'string' }, search: { type: 'string' }, limit: { type: 'integer' }, offset: { type: 'integer' } } } },
+    { name: 'update_mcp_server', description: 'Update an MCP server registration (tags, description, auto_connect).', inputSchema: { type: 'object', properties: { id: { type: 'string' }, name: { type: 'string' }, description: { type: 'string' }, tags: { type: 'array', items: { type: 'string' } }, auto_connect: { type: 'boolean' } }, required: ['id'] } },
+    { name: 'connect_mcp_server', description: 'Connect to a registered MCP server.', inputSchema: { type: 'object', properties: { id: { type: 'string' } }, required: ['id'] } },
+    { name: 'disconnect_mcp_server', description: 'Disconnect from an MCP server.', inputSchema: { type: 'object', properties: { id: { type: 'string' } }, required: ['id'] } },
+    // ── yaml-workflows.ts ───────────────────────────────────────────────────
+    { name: 'list_yaml_workflows', description: 'List compiled YAML workflows with optional status, namespace, or search filter.', inputSchema: { type: 'object', properties: { status: { type: 'string' }, app_id: { type: 'string' }, search: { type: 'string' }, source_workflow_id: { type: 'string' }, limit: { type: 'integer' }, offset: { type: 'integer' } } } },
+    { name: 'get_yaml_workflow', description: 'Inspect a compiled workflow by ID. Returns activity manifest, schemas, and YAML content.', inputSchema: { type: 'object', properties: { id: { type: 'string' } }, required: ['id'] } },
+    { name: 'create_yaml_workflow', description: 'Compile a completed execution into a deterministic YAML workflow. Stored as a draft.', inputSchema: { type: 'object', properties: { workflow_id: { type: 'string' }, task_queue: { type: 'string' }, workflow_name: { type: 'string' }, name: { type: 'string' }, description: { type: 'string' }, app_id: { type: 'string' }, tags: { type: 'array', items: { type: 'string' } }, compilation_feedback: { type: 'string' } }, required: ['workflow_id', 'task_queue', 'workflow_name', 'name'] } },
+    { name: 'deploy_yaml_workflow', description: 'Deploy a compiled YAML workflow, activate it, and register workers.', inputSchema: { type: 'object', properties: { id: { type: 'string' } }, required: ['id'] } },
+    { name: 'invoke_yaml_workflow', description: 'Run a compiled YAML workflow. Deterministic — no LLM. Set sync=true to wait.', inputSchema: { type: 'object', properties: { id: { type: 'string' }, data: { type: 'object' }, sync: { type: 'boolean' }, timeout: { type: 'integer' } }, required: ['id'] } },
+    // ── users.ts (users + roles) ────────────────────────────────────────────
+    { name: 'list_users', description: 'List user accounts with optional role and status filters.', inputSchema: { type: 'object', properties: { role: { type: 'string' }, status: { type: 'string' }, limit: { type: 'integer' }, offset: { type: 'integer' } } } },
+    { name: 'create_user', description: 'Create a new user account with optional roles.', inputSchema: { type: 'object', properties: { external_id: { type: 'string' }, display_name: { type: 'string' }, email: { type: 'string' }, roles: { type: 'array', items: { type: 'object', properties: { role: { type: 'string' }, type: { type: 'string', enum: ['superadmin', 'admin', 'member'] } }, required: ['role', 'type'] } } }, required: ['external_id'] } },
+    { name: 'add_user_role', description: 'Assign a role to a user.', inputSchema: { type: 'object', properties: { user_id: { type: 'string' }, role: { type: 'string' }, type: { type: 'string', enum: ['superadmin', 'admin', 'member'] } }, required: ['user_id', 'role', 'type'] } },
+    { name: 'remove_user_role', description: 'Remove a role from a user.', inputSchema: { type: 'object', properties: { user_id: { type: 'string' }, role: { type: 'string' } }, required: ['user_id', 'role'] } },
+    { name: 'list_roles', description: 'List all distinct roles known to the system.', inputSchema: { type: 'object', properties: {} } },
+    { name: 'create_role', description: 'Create a new role. Lowercase alphanumeric with hyphens/underscores.', inputSchema: { type: 'object', properties: { role: { type: 'string' } }, required: ['role'] } },
+    { name: 'add_escalation_chain', description: 'Define an escalation path from one role to another.', inputSchema: { type: 'object', properties: { source_role: { type: 'string' }, target_role: { type: 'string' } }, required: ['source_role', 'target_role'] } },
+    // ── maintenance.ts ──────────────────────────────────────────────────────
+    { name: 'prune', description: 'Prune expired jobs, streams, and execution artifacts from the database.', inputSchema: { type: 'object', properties: { expire: { type: 'string' }, jobs: { type: 'boolean' }, streams: { type: 'boolean' }, entities: { type: 'array', items: { type: 'string' } }, prune_transient: { type: 'boolean' } } } },
+];

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

@@ -325,7 +325,7 @@ export declare const PLAYWRIGHT_CLI_TOOLS: ({
             };
             screenshot_path: {
                 type: string;
-                description?: undefined;
+                description: string;
             };
             page_id: {
                 type: string;

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

@@ -65,12 +65,12 @@ exports.PLAYWRIGHT_CLI_TOOLS = [
     },
     {
         name: 'capture_page',
-        description: 'Navigate to a URL and capture a full-page screenshot in one call. Optionally waits for a selector or fixed delay before capture. Pass page_id to reuse an existing authenticated session from login_and_capture.',
+        description: 'Navigate to a URL, capture a screenshot, and save it to persistent file storage in one call. The returned `path` and `storage_ref` are the storage reference — no separate write_file call is needed. Optionally waits for a selector or fixed delay before capture. Pass page_id to reuse an existing authenticated session from login_and_capture.',
         inputSchema: {
             type: 'object',
             properties: {
                 url: { type: 'string' },
-                screenshot_path: { type: 'string' },
+                screenshot_path: { type: 'string', description: 'Storage path for the screenshot PNG (persisted to file storage). Auto-derived from URL if omitted. No separate write_file call needed.' },
                 page_id: { type: 'string', description: 'Reuse an existing page to preserve session' },
                 full_page: { type: 'boolean' },
                 wait_for_selector: { type: 'string' },
@@ -78,7 +78,7 @@ exports.PLAYWRIGHT_CLI_TOOLS = [
                 wait_until: { type: 'string' },
                 timeout: { type: 'number' },
             },
-            required: ['url', 'screenshot_path'],
+            required: ['url'],
         },
     },
     {

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

@@ -1,37 +1,40 @@
-export declare const VISION_TOOLS: ({
+export declare const TRANSLATION_TOOLS: {
     name: string;
     description: string;
     inputSchema: {
         type: string;
         properties: {
-            image_ref?: undefined;
-            degrees?: undefined;
-            replace_original?: undefined;
-            content?: undefined;
-            target_language?: undefined;
+            content: {
+                type: string;
+                description: string;
+            };
+            target_language: {
+                type: string;
+                description: string;
+            };
+            source_language: {
+                type: string;
+                description: string;
+            };
         };
-        required?: undefined;
+        required: string[];
     };
-} | {
+}[];
+export declare const VISION_ANALYSIS_TOOLS: ({
     name: string;
     description: string;
     inputSchema: {
         type: string;
         properties: {
-            image_ref: {
+            image: {
                 type: string;
                 description: string;
             };
-            degrees: {
+            prompt: {
                 type: string;
                 description: string;
             };
-            replace_original: {
-                type: string;
-                description: string;
-            };
-            content?: undefined;
-            target_language?: undefined;
+            context?: undefined;
         };
         required: string[];
     };
@@ -41,17 +44,15 @@ export declare const VISION_TOOLS: ({
     inputSchema: {
         type: string;
         properties: {
-            content: {
+            image: {
                 type: string;
                 description: string;
             };
-            target_language: {
+            context: {
                 type: string;
                 description: string;
             };
-            image_ref?: undefined;
-            degrees?: undefined;
-            replace_original?: undefined;
+            prompt?: undefined;
         };
         required: string[];
     };
@@ -283,6 +284,46 @@ export declare const HTTP_FETCH_TOOLS: ({
         required: string[];
     };
 })[];
+export declare const DOCS_TOOLS: ({
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            query?: undefined;
+            path?: undefined;
+        };
+        required?: undefined;
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            query: {
+                type: string;
+                description: string;
+            };
+            path?: undefined;
+        };
+        required: string[];
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            path: {
+                type: string;
+                description: string;
+            };
+            query?: undefined;
+        };
+        required: string[];
+    };
+})[];
 export declare const OAUTH_TOOLS: ({
     name: string;
     description: string;

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

@@ -1,36 +1,45 @@
 "use strict";
 // ── Data, storage, HTTP, and OAuth tool manifests ───────────────────────────
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.OAUTH_TOOLS = exports.HTTP_FETCH_TOOLS = exports.FILE_STORAGE_TOOLS = exports.DB_QUERY_TOOLS = exports.VISION_TOOLS = void 0;
-exports.VISION_TOOLS = [
+exports.OAUTH_TOOLS = exports.DOCS_TOOLS = exports.HTTP_FETCH_TOOLS = exports.FILE_STORAGE_TOOLS = exports.DB_QUERY_TOOLS = exports.VISION_ANALYSIS_TOOLS = exports.TRANSLATION_TOOLS = void 0;
+exports.TRANSLATION_TOOLS = [
     {
-        name: 'list_document_pages',
-        description: 'List available document page images from storage. Returns an array of image references.',
-        inputSchema: { type: 'object', properties: {} },
+        name: 'translate_content',
+        description: 'Translate content text to the target language. Returns the translated content and detected source language.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                content: { type: 'string', description: 'The content text to translate' },
+                target_language: { type: 'string', description: 'Target language code (e.g. "en", "es")' },
+                source_language: { type: 'string', description: 'Source language code (auto-detected if omitted)' },
+            },
+            required: ['content', 'target_language'],
+        },
     },
+];
+exports.VISION_ANALYSIS_TOOLS = [
     {
-        name: 'rotate_page',
-        description: 'Rotate a document page image by the given degrees. Deletes the original by default and returns the new image reference. Use the exact rotated_ref in correctedData.',
+        name: 'analyze_image',
+        description: 'Analyze an image and extract structured data: description, text content, and notable objects. Accepts storage paths directly (e.g., "google_homepage.png" from capture_page) — no need to read_file first.',
         inputSchema: {
             type: 'object',
             properties: {
-                image_ref: { type: 'string', description: 'Storage reference to the image to rotate' },
-                degrees: { type: 'integer', description: 'Rotation degrees (90, 180, 270)' },
-                replace_original: { type: 'boolean', description: 'Delete the original file after rotation (default: true)' },
+                image: { type: 'string', description: 'Image source: a storage path (e.g., "screenshot.png" from capture_page), a data URI, or an https:// URL. Storage paths are read automatically.' },
+                prompt: { type: 'string', description: 'Optional analysis prompt to guide the model' },
             },
-            required: ['image_ref', 'degrees'],
+            required: ['image'],
         },
     },
     {
-        name: 'translate_content',
-        description: 'Translate content text to the target language. Returns the translated content and detected source language.',
+        name: 'describe_image',
+        description: 'Generate a detailed description of an image. Accepts storage paths directly (e.g., "screenshot.png" from capture_page) — no need to read_file first.',
         inputSchema: {
             type: 'object',
             properties: {
-                content: { type: 'string', description: 'The content text to translate' },
-                target_language: { type: 'string', description: 'Target language code (e.g. "en", "es")' },
+                image: { type: 'string', description: 'Image source: a storage path (e.g., "screenshot.png" from capture_page), a data URI, or an https:// URL. Storage paths are read automatically.' },
+                context: { type: 'string', description: 'Optional context about the image' },
             },
-            required: ['content', 'target_language'],
+            required: ['image'],
         },
     },
 ];
@@ -40,7 +49,7 @@ exports.DB_QUERY_TOOLS = [
     { name: 'get_process_summary', description: 'List business processes grouped by origin_id. Each process shows task count, completed/escalated counts, workflow types involved, and time range.', inputSchema: { type: 'object', properties: { workflow_type: { type: 'string' }, limit: { type: 'integer', default: 25 } } } },
     { name: 'get_escalation_stats', description: 'Real-time escalation statistics: pending/claimed counts, created/resolved in last 1h and 24h, breakdown by role.', inputSchema: { type: 'object', properties: {} } },
     { name: 'get_workflow_types', description: 'List all registered workflow configurations with task queue, roles, invocable flag, and description.', inputSchema: { type: 'object', properties: {} } },
-    { name: 'get_system_health', description: 'Overall system health snapshot: task counts by status, escalation counts by status, active workflow types, and recent activity window.', inputSchema: { type: 'object', properties: {} } },
+    { name: 'get_system_health', description: 'Full system overview: durable workflow execution counts by type (active/completed), task counts by status, escalation counts by status, recent activity window, MCP servers (with tool counts and tags), compiled workflow totals, and workflow configurations.', inputSchema: { type: 'object', properties: {} } },
 ];
 exports.FILE_STORAGE_TOOLS = [
     {
@@ -132,6 +141,35 @@ exports.HTTP_FETCH_TOOLS = [
         },
     },
 ];
+exports.DOCS_TOOLS = [
+    {
+        name: 'list_docs',
+        description: 'List all available documentation files with their titles.',
+        inputSchema: { type: 'object', properties: {} },
+    },
+    {
+        name: 'search_docs',
+        description: 'Search across all documentation for a keyword or phrase. Returns matching files with line context.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                query: { type: 'string', description: 'Search term or phrase to find in documentation' },
+            },
+            required: ['query'],
+        },
+    },
+    {
+        name: 'read_doc',
+        description: 'Read the full content of a documentation file.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                path: { type: 'string', description: 'Document path relative to docs/ (e.g. "mcp.md" or "api/tasks.md")' },
+            },
+            required: ['path'],
+        },
+    },
+];
 exports.OAUTH_TOOLS = [
     {
         name: 'get_access_token',

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

@@ -0,0 +1,171 @@
+export declare const KNOWLEDGE_TOOLS: ({
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            domain: {
+                type: string;
+                description: string;
+            };
+            key: {
+                type: string;
+                description: string;
+            };
+            data: {
+                type: string;
+                description: string;
+            };
+            tags: {
+                type: string;
+                items: {
+                    type: string;
+                };
+                description: string;
+            };
+            query?: undefined;
+            limit?: undefined;
+            offset?: undefined;
+            path?: undefined;
+            value?: undefined;
+        };
+        required: string[];
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            domain: {
+                type: string;
+                description: string;
+            };
+            key: {
+                type: string;
+                description: string;
+            };
+            data?: undefined;
+            tags?: undefined;
+            query?: undefined;
+            limit?: undefined;
+            offset?: undefined;
+            path?: undefined;
+            value?: undefined;
+        };
+        required: string[];
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            domain: {
+                type: string;
+                description: string;
+            };
+            query: {
+                type: string;
+                description: string;
+            };
+            tags: {
+                type: string;
+                items: {
+                    type: string;
+                };
+                description: string;
+            };
+            limit: {
+                type: string;
+                description: string;
+            };
+            key?: undefined;
+            data?: undefined;
+            offset?: undefined;
+            path?: undefined;
+            value?: undefined;
+        };
+        required: string[];
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            domain: {
+                type: string;
+                description: string;
+            };
+            tags: {
+                type: string;
+                items: {
+                    type: string;
+                };
+                description: string;
+            };
+            limit: {
+                type: string;
+                description: string;
+            };
+            offset: {
+                type: string;
+                description: string;
+            };
+            key?: undefined;
+            data?: undefined;
+            query?: undefined;
+            path?: undefined;
+            value?: undefined;
+        };
+        required: string[];
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            domain?: undefined;
+            key?: undefined;
+            data?: undefined;
+            tags?: undefined;
+            query?: undefined;
+            limit?: undefined;
+            offset?: undefined;
+            path?: undefined;
+            value?: undefined;
+        };
+        required?: undefined;
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            domain: {
+                type: string;
+                description: string;
+            };
+            key: {
+                type: string;
+                description: string;
+            };
+            path: {
+                type: string;
+                description: string;
+            };
+            value: {
+                description: string;
+            };
+            data?: undefined;
+            tags?: undefined;
+            query?: undefined;
+            limit?: undefined;
+            offset?: undefined;
+        };
+        required: string[];
+    };
+})[];

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

@@ -0,0 +1,94 @@
+"use strict";
+// ── Knowledge store tool manifests ───────────────────────────────────────────
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.KNOWLEDGE_TOOLS = void 0;
+exports.KNOWLEDGE_TOOLS = [
+    {
+        name: 'store_knowledge',
+        description: 'Store or update a knowledge entry. Upserts by domain+key: merges data and unions tags if the entry already exists.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                domain: { type: 'string', description: 'Knowledge domain (namespace)' },
+                key: { type: 'string', description: 'Unique key within domain' },
+                data: { type: 'object', description: 'JSONB payload to store' },
+                tags: { type: 'array', items: { type: 'string' }, description: 'Categorization tags' },
+            },
+            required: ['domain', 'key', 'data'],
+        },
+    },
+    {
+        name: 'get_knowledge',
+        description: 'Retrieve a single knowledge entry by domain and key.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                domain: { type: 'string', description: 'Knowledge domain' },
+                key: { type: 'string', description: 'Document key' },
+            },
+            required: ['domain', 'key'],
+        },
+    },
+    {
+        name: 'search_knowledge',
+        description: 'Search knowledge entries using JSONB containment queries. The query object matches entries whose data contains the specified key-value pairs.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                domain: { type: 'string', description: 'Knowledge domain to search' },
+                query: { type: 'object', description: 'JSONB containment query' },
+                tags: { type: 'array', items: { type: 'string' }, description: 'Filter by tags' },
+                limit: { type: 'number', description: 'Max results (default 50)' },
+            },
+            required: ['domain', 'query'],
+        },
+    },
+    {
+        name: 'list_knowledge',
+        description: 'List knowledge entries in a domain, optionally filtered by tags. Returns most recently updated first.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                domain: { type: 'string', description: 'Knowledge domain' },
+                tags: { type: 'array', items: { type: 'string' }, description: 'Filter by tags' },
+                limit: { type: 'number', description: 'Max results (default 50)' },
+                offset: { type: 'number', description: 'Pagination offset' },
+            },
+            required: ['domain'],
+        },
+    },
+    {
+        name: 'delete_knowledge',
+        description: 'Delete a knowledge entry by domain and key.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                domain: { type: 'string', description: 'Knowledge domain' },
+                key: { type: 'string', description: 'Document key to delete' },
+            },
+            required: ['domain', 'key'],
+        },
+    },
+    {
+        name: 'list_domains',
+        description: 'List all knowledge domains with entry counts and last-updated timestamps.',
+        inputSchema: {
+            type: 'object',
+            properties: {},
+        },
+    },
+    {
+        name: 'append_knowledge',
+        description: 'Append a value to an array field within a knowledge entry. Creates the entry and array if they do not exist.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                domain: { type: 'string', description: 'Knowledge domain' },
+                key: { type: 'string', description: 'Document key' },
+                path: { type: 'string', description: 'JSONB path to array field' },
+                value: { description: 'Value to append to the array' },
+            },
+            required: ['domain', 'key', 'path', 'value'],
+        },
+    },
+];

package/build/system/workflows/mcp-deterministic/index.js

@@ -38,7 +38,7 @@ const hotmesh_1 = require("@hotmeshio/hotmesh");
 const activities = __importStar(require("./activities"));
 const { invokeCompiledWorkflow } = hotmesh_1.Durable.workflow.proxyActivities({
     activities,
-    retryPolicy: {
+    retry: {
         maximumAttempts: 3,
         backoffCoefficient: 2,
         maximumInterval: '10 seconds',

package/build/system/workflows/mcp-query/activities/discovery.d.ts

@@ -1,31 +1,13 @@
+import { extractWorkflowInputs } from '../../shared/discovery';
 import type { WorkflowCandidate } from '../../../../types/discovery';
-/**
- * Phase 1: Ranked discovery of compiled YAML workflows.
- *
- * Uses PostgreSQL full-text search (tsvector) + tag overlap for
- * multi-signal ranked matching. Returns candidates for the LLM judge.
- */
 export declare function findCompiledWorkflows(prompt: string): Promise<{
     inventory: string;
     toolIds: string[];
     candidates: WorkflowCandidate[];
 }>;
-/**
- * Phase 2: LLM-as-judge evaluates whether any discovered workflow
- * matches the user's intent. One cheap call (mini model, ~200 tokens)
- * to potentially skip the entire agentic loop.
- */
 export declare function evaluateWorkflowMatch(prompt: string, candidates: WorkflowCandidate[]): Promise<{
     matched: boolean;
     workflowName: string | null;
     confidence: number;
 }>;
-/**
- * Phase 2b: Extract structured inputs from the user's prompt using the
- * matched workflow's input_schema. Acts as a second confirmation gate —
- * if the LLM can't map the prompt to the schema, the match is rejected.
- */
-export declare function extractWorkflowInputs(prompt: string, inputSchema: Record<string, unknown>, workflowName: string): Promise<{
-    inputs: Record<string, any> | null;
-    extracted: boolean;
-}>;
+export { extractWorkflowInputs };