@hotmeshio/long-tail 0.1.0

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

@@ -0,0 +1,158 @@
+"use strict";
+// ── Browser automation tool manifests ────────────────────────────────────────
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PLAYWRIGHT_CLI_TOOLS = exports.PLAYWRIGHT_TOOLS = void 0;
+exports.PLAYWRIGHT_TOOLS = [
+    { name: 'navigate', description: 'Open a URL in a browser page. Returns a page_id handle for subsequent tool calls.', inputSchema: { type: 'object', properties: { url: { type: 'string' }, wait_until: { type: 'string', description: 'load | domcontentloaded | networkidle' } }, required: ['url'] } },
+    { name: 'screenshot', description: 'Capture a screenshot and save as PNG. Pass url for a self-contained navigate+screenshot, or page_id to screenshot an existing page.', inputSchema: { type: 'object', properties: { url: { type: 'string' }, wait_until: { type: 'string' }, path: { type: 'string' }, page_id: { type: 'string' }, full_page: { type: 'boolean' }, selector: { type: 'string' } }, required: ['path'] } },
+    { name: 'click', description: 'Click an element by CSS selector. Waits 500ms after click for SPA transitions.', inputSchema: { type: 'object', properties: { selector: { type: 'string' }, page_id: { type: 'string' } }, required: ['selector'] } },
+    { name: 'fill', description: 'Type a value into an input field by CSS selector.', inputSchema: { type: 'object', properties: { selector: { type: 'string' }, value: { type: 'string' }, page_id: { type: 'string' } }, required: ['selector', 'value'] } },
+    { name: 'wait_for', description: 'Wait for a CSS selector to appear on the page. For URL-based waiting, use run_script with wait_for_url action instead.', inputSchema: { type: 'object', properties: { selector: { type: 'string' }, page_id: { type: 'string' }, timeout: { type: 'number' } }, required: ['selector'] } },
+    { name: 'evaluate', description: 'Evaluate JavaScript in the page context. Returns the expression result.', inputSchema: { type: 'object', properties: { script: { type: 'string' }, page_id: { type: 'string' } }, required: ['script'] } },
+    {
+        name: 'run_script',
+        description: 'Execute a multi-step browser script in a single call. All steps share one page. Actions: navigate (go to URL), screenshot (save PNG), click (CSS selector), fill (input value), wait_for (CSS selector appears), wait_for_url (URL matches/not-matches pattern), wait (fixed delay in ms), evaluate (run JS). Use wait_for_url with not=true after login clicks to wait for SPA navigation.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                steps: {
+                    type: 'array',
+                    description: 'Ordered list of browser actions to execute sequentially on a single page',
+                    items: {
+                        type: 'object',
+                        properties: {
+                            action: { type: 'string', enum: ['navigate', 'screenshot', 'click', 'fill', 'wait_for', 'wait_for_url', 'wait', 'evaluate'] },
+                            url: { type: 'string', description: 'URL for navigate, or URL pattern for wait_for_url' },
+                            wait_until: { type: 'string' },
+                            path: { type: 'string' },
+                            full_page: { type: 'boolean' },
+                            selector: { type: 'string' },
+                            value: { type: 'string' },
+                            script: { type: 'string' },
+                            timeout: { type: 'number', description: 'Timeout in ms for wait_for/wait_for_url, or delay for wait' },
+                            not: { type: 'boolean', description: 'For wait_for_url: wait until URL does NOT match (default: false)' },
+                        },
+                        required: ['action'],
+                    },
+                },
+            },
+            required: ['steps'],
+        },
+    },
+    { name: 'list_pages', description: 'List all open browser pages.', inputSchema: { type: 'object', properties: {} } },
+    { name: 'close_page', description: 'Close a browser page by ID.', inputSchema: { type: 'object', properties: { page_id: { type: 'string' } }, required: ['page_id'] } },
+];
+exports.PLAYWRIGHT_CLI_TOOLS = [
+    {
+        name: 'login_and_capture',
+        description: 'Log into a website and capture a screenshot of the authenticated page. Handles navigation, credential entry, form submission, and post-login waiting in one call.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                url: { type: 'string', description: 'Login page URL' },
+                username_selector: { type: 'string', description: 'CSS selector for username input' },
+                password_selector: { type: 'string', description: 'CSS selector for password input' },
+                username: { type: 'string', description: 'Username value' },
+                password: { type: 'string', description: 'Password value' },
+                submit_selector: { type: 'string', description: 'CSS selector for submit button' },
+                wait_after_login: { type: 'string', description: 'CSS selector or URL pattern to wait for after login' },
+                screenshot_path: { type: 'string', description: 'Path for post-login screenshot' },
+                full_page: { type: 'boolean' },
+                timeout: { type: 'number', description: 'Max wait time in ms (default: 15000)' },
+            },
+            required: ['url', 'username_selector', 'password_selector', 'username', 'password', 'submit_selector'],
+        },
+    },
+    {
+        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.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                url: { type: 'string' },
+                screenshot_path: { type: 'string' },
+                page_id: { type: 'string', description: 'Reuse an existing page to preserve session' },
+                full_page: { type: 'boolean' },
+                wait_for_selector: { type: 'string' },
+                wait_ms: { type: 'number', description: 'Fixed delay in ms before capture (default: 2000)' },
+                wait_until: { type: 'string' },
+                timeout: { type: 'number' },
+            },
+            required: ['url', 'screenshot_path'],
+        },
+    },
+    {
+        name: 'capture_authenticated_pages',
+        description: 'Log in once, then navigate to multiple URLs capturing a screenshot of each. Reuses the authenticated session across all pages. Ideal for generating documentation screenshots.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                login: {
+                    type: 'object',
+                    description: 'Login parameters',
+                    properties: {
+                        url: { type: 'string', description: 'Login page URL' },
+                        username_selector: { type: 'string', description: 'CSS selector for username input' },
+                        password_selector: { type: 'string', description: 'CSS selector for password input' },
+                        username: { type: 'string' },
+                        password: { type: 'string' },
+                        submit_selector: { type: 'string', description: 'CSS selector for submit button' },
+                        wait_after_login: { type: 'string', description: 'CSS selector or URL pattern to wait for after login' },
+                        timeout: { type: 'number' },
+                    },
+                    required: ['url', 'username_selector', 'password_selector', 'username', 'password', 'submit_selector'],
+                },
+                pages: {
+                    type: 'array',
+                    description: 'Pages to capture after login',
+                    items: {
+                        type: 'object',
+                        properties: {
+                            url: { type: 'string', description: 'URL to navigate to' },
+                            screenshot_path: { type: 'string', description: 'Path to save screenshot' },
+                            wait_for_selector: { type: 'string', description: 'Wait for this selector before capture' },
+                            wait_ms: { type: 'number', description: 'Fixed delay before capture (default: 3000)' },
+                            full_page: { type: 'boolean' },
+                        },
+                        required: ['url', 'screenshot_path'],
+                    },
+                },
+            },
+            required: ['login', 'pages'],
+        },
+    },
+    {
+        name: 'extract_content',
+        description: 'Extract structured content (text, links, metadata) from a page. Navigate to a URL or pass page_id to extract from an existing authenticated session. Returns page text by default, with optional link and meta tag extraction.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                url: { type: 'string', description: 'URL to navigate to. Omit to extract from existing page_id.' },
+                page_id: { type: 'string', description: 'Reuse an existing page (from login_and_capture)' },
+                selector: { type: 'string', description: 'CSS selector to extract text from' },
+                script: { type: 'string', description: 'Custom JS to evaluate' },
+                extract_links: { type: 'boolean' },
+                extract_metadata: { type: 'boolean' },
+                wait_for_selector: { type: 'string' },
+                wait_ms: { type: 'number' },
+            },
+        },
+    },
+    {
+        name: 'submit_form',
+        description: 'Navigate to a form page, fill multiple fields, submit, and capture the result. Handles the full form lifecycle in one call.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                url: { type: 'string' },
+                fields: { type: 'array', description: 'Fields to fill', items: { type: 'object', properties: { selector: { type: 'string' }, value: { type: 'string' } }, required: ['selector', 'value'] } },
+                submit_selector: { type: 'string' },
+                wait_after_submit: { type: 'string', description: 'CSS selector or URL pattern to wait for' },
+                screenshot_path: { type: 'string' },
+                full_page: { type: 'boolean' },
+                timeout: { type: 'number' },
+            },
+            required: ['url', 'fields', 'submit_selector'],
+        },
+    },
+];

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

@@ -0,0 +1,322 @@
+export declare const VISION_TOOLS: ({
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            image_ref?: undefined;
+            degrees?: undefined;
+            replace_original?: undefined;
+            content?: undefined;
+            target_language?: undefined;
+        };
+        required?: undefined;
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            image_ref: {
+                type: string;
+                description: string;
+            };
+            degrees: {
+                type: string;
+                description: string;
+            };
+            replace_original: {
+                type: string;
+                description: string;
+            };
+            content?: undefined;
+            target_language?: undefined;
+        };
+        required: string[];
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            content: {
+                type: string;
+                description: string;
+            };
+            target_language: {
+                type: string;
+                description: string;
+            };
+            image_ref?: undefined;
+            degrees?: undefined;
+            replace_original?: undefined;
+        };
+        required: string[];
+    };
+})[];
+export declare const DB_QUERY_TOOLS: ({
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            status: {
+                type: string;
+            };
+            workflow_type: {
+                type: string;
+            };
+            workflow_id: {
+                type: string;
+            };
+            origin_id: {
+                type: string;
+            };
+            limit: {
+                type: string;
+                default: number;
+            };
+            role?: undefined;
+            type?: undefined;
+            priority?: undefined;
+        };
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            status: {
+                type: string;
+            };
+            role: {
+                type: string;
+            };
+            type: {
+                type: string;
+            };
+            priority: {
+                type: string;
+            };
+            limit: {
+                type: string;
+                default: number;
+            };
+            workflow_type?: undefined;
+            workflow_id?: undefined;
+            origin_id?: undefined;
+        };
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            workflow_type: {
+                type: string;
+            };
+            limit: {
+                type: string;
+                default: number;
+            };
+            status?: undefined;
+            workflow_id?: undefined;
+            origin_id?: undefined;
+            role?: undefined;
+            type?: undefined;
+            priority?: undefined;
+        };
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            status?: undefined;
+            workflow_type?: undefined;
+            workflow_id?: undefined;
+            origin_id?: undefined;
+            limit?: undefined;
+            role?: undefined;
+            type?: undefined;
+            priority?: undefined;
+        };
+    };
+})[];
+export declare const FILE_STORAGE_TOOLS: ({
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            path: {
+                type: string;
+                description: string;
+            };
+            encoding: {
+                type: string;
+                description: string;
+                default: string;
+            };
+            content?: undefined;
+            directory?: undefined;
+            recursive?: undefined;
+        };
+        required: string[];
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            path: {
+                type: string;
+                description: string;
+            };
+            content: {
+                type: string;
+                description: string;
+            };
+            encoding: {
+                type: string;
+                description: string;
+                default: string;
+            };
+            directory?: undefined;
+            recursive?: undefined;
+        };
+        required: string[];
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            directory: {
+                type: string;
+                description: string;
+                default: string;
+            };
+            recursive: {
+                type: string;
+                description: string;
+                default: boolean;
+            };
+            path?: undefined;
+            encoding?: undefined;
+            content?: undefined;
+        };
+        required?: undefined;
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            path: {
+                type: string;
+                description: string;
+            };
+            encoding?: undefined;
+            content?: undefined;
+            directory?: undefined;
+            recursive?: undefined;
+        };
+        required: string[];
+    };
+})[];
+export declare const HTTP_FETCH_TOOLS: ({
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            url: {
+                type: string;
+                description: string;
+            };
+            method: {
+                type: string;
+                description: string;
+            };
+            headers: {
+                type: string;
+                description: string;
+            };
+            body: {
+                type: string;
+                description: string;
+            };
+            timeout_ms: {
+                type: string;
+                description: string;
+            };
+        };
+        required: string[];
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            url: {
+                type: string;
+                description: string;
+            };
+            headers: {
+                type: string;
+                description: string;
+            };
+            method?: undefined;
+            body?: undefined;
+            timeout_ms?: undefined;
+        };
+        required: string[];
+    };
+})[];
+export declare const OAUTH_TOOLS: ({
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            provider: {
+                type: string;
+                description: string;
+            };
+            user_id: {
+                type: string;
+                description: string;
+            };
+            label: {
+                type: string;
+                description: string;
+            };
+        };
+        required: string[];
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            user_id: {
+                type: string;
+                description: string;
+            };
+            provider?: undefined;
+            label?: undefined;
+        };
+        required: string[];
+    };
+})[];

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

@@ -0,0 +1,173 @@
+"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 = [
+    {
+        name: 'list_document_pages',
+        description: 'List available document page images from storage. Returns an array of image references.',
+        inputSchema: { type: 'object', properties: {} },
+    },
+    {
+        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.',
+        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)' },
+            },
+            required: ['image_ref', 'degrees'],
+        },
+    },
+    {
+        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")' },
+            },
+            required: ['content', 'target_language'],
+        },
+    },
+];
+exports.DB_QUERY_TOOLS = [
+    { name: 'find_tasks', description: 'Search tasks with optional filters. Returns task records with workflow_id, status, workflow_type, milestones, created/completed timestamps, and metadata.', inputSchema: { type: 'object', properties: { status: { type: 'string' }, workflow_type: { type: 'string' }, workflow_id: { type: 'string' }, origin_id: { type: 'string' }, limit: { type: 'integer', default: 25 } } } },
+    { name: 'find_escalations', description: 'Search escalations with optional filters. Returns escalation records with type, role, priority, status, description, and assignment info.', inputSchema: { type: 'object', properties: { status: { type: 'string' }, role: { type: 'string' }, type: { type: 'string' }, priority: { type: 'integer' }, limit: { type: 'integer', default: 25 } } } },
+    { 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: {} } },
+];
+exports.FILE_STORAGE_TOOLS = [
+    {
+        name: 'read_file',
+        description: 'Read file content from managed storage. Returns content, size, and detected MIME type. Supports utf8 (text) or base64 encoding.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                path: { type: 'string', description: 'Relative path to the file in managed storage' },
+                encoding: { type: 'string', description: 'Encoding to use (utf8 or base64)', default: 'utf8' },
+            },
+            required: ['path'],
+        },
+    },
+    {
+        name: 'write_file',
+        description: 'Write content to a file in managed storage. Creates directories as needed. Returns the storage reference and size.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                path: { type: 'string', description: 'Relative path for the file in managed storage' },
+                content: { type: 'string', description: 'File content to write' },
+                encoding: { type: 'string', description: 'Encoding of the content (utf8 or base64)', default: 'utf8' },
+            },
+            required: ['path', 'content'],
+        },
+    },
+    {
+        name: 'list_files',
+        description: 'List files in a storage directory. Returns file paths, sizes, and modification timestamps.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                directory: { type: 'string', description: 'Directory path to list (default: root)', default: '/' },
+                recursive: { type: 'boolean', description: 'Whether to list recursively', default: false },
+            },
+        },
+    },
+    {
+        name: 'delete_file',
+        description: 'Remove a file from managed storage.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                path: { type: 'string', description: 'Relative path to the file to delete' },
+            },
+            required: ['path'],
+        },
+    },
+];
+exports.HTTP_FETCH_TOOLS = [
+    {
+        name: 'http_request',
+        description: 'Make an HTTP request to any URL. Supports all methods, custom headers, and request bodies. Returns status, headers, and body.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                url: { type: 'string', description: 'URL to request' },
+                method: { type: 'string', description: 'HTTP method (default: GET)' },
+                headers: { type: 'object', description: 'Request headers' },
+                body: { type: 'string', description: 'Request body' },
+                timeout_ms: { type: 'number', description: 'Request timeout in milliseconds' },
+            },
+            required: ['url'],
+        },
+    },
+    {
+        name: 'fetch_json',
+        description: 'GET a URL and parse the response as JSON. Convenience wrapper around http_request.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                url: { type: 'string', description: 'URL to fetch JSON from' },
+                headers: { type: 'object', description: 'Request headers' },
+            },
+            required: ['url'],
+        },
+    },
+    {
+        name: 'fetch_text',
+        description: 'GET a URL and return the response as text. Returns content, status, and content type.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                url: { type: 'string', description: 'URL to fetch text from' },
+                headers: { type: 'object', description: 'Request headers' },
+            },
+            required: ['url'],
+        },
+    },
+];
+exports.OAUTH_TOOLS = [
+    {
+        name: 'get_access_token',
+        description: 'Get a fresh OAuth access token for an external service. Automatically refreshes expired tokens.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                provider: { type: 'string', description: 'OAuth provider name (google, github, microsoft, anthropic, etc.)' },
+                user_id: { type: 'string', description: 'User ID to get token for' },
+                label: { type: 'string', description: 'Credential label (default: "default"). Select among multiple credentials for the same provider.' },
+            },
+            required: ['provider', 'user_id'],
+        },
+    },
+    {
+        name: 'list_connections',
+        description: 'List all OAuth providers connected for a user. Returns provider, label, and credential type for each connection.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                user_id: { type: 'string', description: 'User ID to list connections for' },
+            },
+            required: ['user_id'],
+        },
+    },
+    {
+        name: 'revoke_connection',
+        description: 'Disconnect an OAuth provider for a user, removing stored tokens. Use label to target a specific credential.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                provider: { type: 'string', description: 'OAuth provider name to disconnect' },
+                user_id: { type: 'string', description: 'User ID to revoke connection for' },
+                label: { type: 'string', description: 'Credential label to revoke (default: "default")' },
+            },
+            required: ['provider', 'user_id'],
+        },
+    },
+];