@puukis/core 0.1.0

package/dist/tools/builtin/browser.d.ts

@@ -0,0 +1,27 @@
+import type { Tool } from '../../types.js';
+/**
+ * Navigate to a URL
+ */
+export declare const navigateTool: Tool;
+/**
+ * Take a screenshot
+ */
+export declare const screenshotTool: Tool;
+/**
+ * Click an element
+ */
+export declare const clickTool: Tool;
+/**
+ * Type text into an element
+ */
+export declare const typeTool: Tool;
+/**
+ * Get page content/text
+ */
+export declare const getContentTool: Tool;
+/**
+ * Close the browser
+ */
+export declare function closeBrowser(): Promise<void>;
+export declare const browserTools: Tool[];
+//# sourceMappingURL=browser.d.ts.map

package/dist/tools/builtin/browser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser.d.ts","sourceRoot":"","sources":["../../../src/tools/builtin/browser.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,IAAI,EAAc,MAAM,gBAAgB,CAAC;AAqBvD;;GAEG;AACH,eAAO,MAAM,YAAY,EAAE,IA8B1B,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,cAAc,EAAE,IAmC5B,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,SAAS,EAAE,IA6BvB,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,QAAQ,EAAE,IAkCtB,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,cAAc,EAAE,IAmC5B,CAAC;AAEF;;GAEG;AACH,wBAAsB,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC,CAMlD;AAED,eAAO,MAAM,YAAY,EAAE,IAAI,EAM9B,CAAC"}

package/dist/tools/builtin/browser.js

@@ -0,0 +1,222 @@
+import { chromium } from 'playwright';
+// Singleton browser instance
+let browser = null;
+let currentPage = null;
+async function getBrowser() {
+    if (!browser) {
+        browser = await chromium.launch({ headless: true });
+    }
+    return browser;
+}
+async function getPage() {
+    if (!currentPage || currentPage.isClosed()) {
+        const b = await getBrowser();
+        currentPage = await b.newPage();
+    }
+    return currentPage;
+}
+/**
+ * Navigate to a URL
+ */
+export const navigateTool = {
+    name: 'browser_navigate',
+    description: 'Navigate the browser to a URL',
+    parameters: {
+        type: 'object',
+        properties: {
+            url: {
+                type: 'string',
+                description: 'The URL to navigate to',
+            },
+        },
+        required: ['url'],
+    },
+    requiresConfirmation: false,
+    type: 'browser',
+    handler: async (args) => {
+        const url = args['url'];
+        try {
+            const page = await getPage();
+            await page.goto(url, { waitUntil: 'domcontentloaded', timeout: 30000 });
+            const title = await page.title();
+            return { success: true, output: `Navigated to: ${title} (${url})` };
+        }
+        catch (error) {
+            return {
+                success: false,
+                output: '',
+                error: error instanceof Error ? error.message : 'Navigation failed',
+            };
+        }
+    },
+};
+/**
+ * Take a screenshot
+ */
+export const screenshotTool = {
+    name: 'browser_screenshot',
+    description: 'Take a screenshot of the current page',
+    parameters: {
+        type: 'object',
+        properties: {
+            path: {
+                type: 'string',
+                description: 'Path to save the screenshot (optional, defaults to temp file)',
+            },
+            fullPage: {
+                type: 'boolean',
+                description: 'Whether to take a full page screenshot (default: false)',
+            },
+        },
+        required: [],
+    },
+    requiresConfirmation: false,
+    type: 'browser',
+    handler: async (args) => {
+        try {
+            const page = await getPage();
+            const outputPath = args['path'] || `/tmp/screenshot-${Date.now()}.png`;
+            const fullPage = args['fullPage'] ?? false;
+            await page.screenshot({ path: outputPath, fullPage });
+            return { success: true, output: `Screenshot saved to: ${outputPath}` };
+        }
+        catch (error) {
+            return {
+                success: false,
+                output: '',
+                error: error instanceof Error ? error.message : 'Screenshot failed',
+            };
+        }
+    },
+};
+/**
+ * Click an element
+ */
+export const clickTool = {
+    name: 'browser_click',
+    description: 'Click an element on the page using a CSS selector',
+    parameters: {
+        type: 'object',
+        properties: {
+            selector: {
+                type: 'string',
+                description: 'CSS selector for the element to click',
+            },
+        },
+        required: ['selector'],
+    },
+    requiresConfirmation: true,
+    type: 'browser',
+    handler: async (args) => {
+        const selector = args['selector'];
+        try {
+            const page = await getPage();
+            await page.click(selector, { timeout: 10000 });
+            return { success: true, output: `Clicked element: ${selector}` };
+        }
+        catch (error) {
+            return {
+                success: false,
+                output: '',
+                error: error instanceof Error ? error.message : 'Click failed',
+            };
+        }
+    },
+};
+/**
+ * Type text into an element
+ */
+export const typeTool = {
+    name: 'browser_type',
+    description: 'Type text into an input element',
+    parameters: {
+        type: 'object',
+        properties: {
+            selector: {
+                type: 'string',
+                description: 'CSS selector for the input element',
+            },
+            text: {
+                type: 'string',
+                description: 'Text to type',
+            },
+        },
+        required: ['selector', 'text'],
+    },
+    requiresConfirmation: true,
+    type: 'browser',
+    handler: async (args) => {
+        const selector = args['selector'];
+        const text = args['text'];
+        try {
+            const page = await getPage();
+            await page.fill(selector, text);
+            return { success: true, output: `Typed "${text}" into ${selector}` };
+        }
+        catch (error) {
+            return {
+                success: false,
+                output: '',
+                error: error instanceof Error ? error.message : 'Type failed',
+            };
+        }
+    },
+};
+/**
+ * Get page content/text
+ */
+export const getContentTool = {
+    name: 'browser_get_content',
+    description: 'Get the text content of the current page or a specific element',
+    parameters: {
+        type: 'object',
+        properties: {
+            selector: {
+                type: 'string',
+                description: 'CSS selector for a specific element (optional, defaults to body)',
+            },
+        },
+        required: [],
+    },
+    requiresConfirmation: false,
+    type: 'browser',
+    handler: async (args) => {
+        const selector = args['selector'] || 'body';
+        try {
+            const page = await getPage();
+            const element = await page.$(selector);
+            if (!element) {
+                return { success: false, output: '', error: `Element not found: ${selector}` };
+            }
+            const text = await element.innerText();
+            // Truncate very long content
+            const truncated = text.length > 5000 ? text.slice(0, 5000) + '...(truncated)' : text;
+            return { success: true, output: truncated };
+        }
+        catch (error) {
+            return {
+                success: false,
+                output: '',
+                error: error instanceof Error ? error.message : 'Failed to get content',
+            };
+        }
+    },
+};
+/**
+ * Close the browser
+ */
+export async function closeBrowser() {
+    if (browser) {
+        await browser.close();
+        browser = null;
+        currentPage = null;
+    }
+}
+export const browserTools = [
+    navigateTool,
+    screenshotTool,
+    clickTool,
+    typeTool,
+    getContentTool,
+];
+//# sourceMappingURL=browser.js.map

package/dist/tools/builtin/browser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser.js","sourceRoot":"","sources":["../../../src/tools/builtin/browser.ts"],"names":[],"mappings":"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"}

package/dist/tools/builtin/filesystem.d.ts

@@ -0,0 +1,22 @@
+import type { Tool } from '../../types.js';
+/**
+ * Read file contents
+ */
+export declare const readFileTool: Tool;
+/**
+ * Write content to a file
+ */
+export declare const writeFileTool: Tool;
+/**
+ * List directory contents
+ */
+export declare const listDirectoryTool: Tool;
+/**
+ * Delete a file
+ */
+export declare const deleteFileTool: Tool;
+/**
+ * All filesystem tools
+ */
+export declare const filesystemTools: Tool[];
+//# sourceMappingURL=filesystem.d.ts.map

package/dist/tools/builtin/filesystem.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"filesystem.d.ts","sourceRoot":"","sources":["../../../src/tools/builtin/filesystem.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,IAAI,EAAc,MAAM,gBAAgB,CAAC;AAEvD;;GAEG;AACH,eAAO,MAAM,YAAY,EAAE,IA4B1B,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,aAAa,EAAE,IAkC3B,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,iBAAiB,EAAE,IA+B/B,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,cAAc,EAAE,IA4B5B,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,eAAe,EAAE,IAAI,EAKjC,CAAC"}

package/dist/tools/builtin/filesystem.js

@@ -0,0 +1,151 @@
+import * as fs from 'node:fs/promises';
+import * as path from 'node:path';
+/**
+ * Read file contents
+ */
+export const readFileTool = {
+    name: 'read_file',
+    description: 'Read the contents of a file',
+    parameters: {
+        type: 'object',
+        properties: {
+            path: {
+                type: 'string',
+                description: 'The path to the file to read',
+            },
+        },
+        required: ['path'],
+    },
+    requiresConfirmation: false,
+    type: 'filesystem',
+    handler: async (args) => {
+        const filePath = args['path'];
+        try {
+            const content = await fs.readFile(filePath, 'utf-8');
+            return { success: true, output: content };
+        }
+        catch (error) {
+            return {
+                success: false,
+                output: '',
+                error: error instanceof Error ? error.message : 'Failed to read file',
+            };
+        }
+    },
+};
+/**
+ * Write content to a file
+ */
+export const writeFileTool = {
+    name: 'write_file',
+    description: 'Write content to a file. Creates the file and parent directories if they do not exist.',
+    parameters: {
+        type: 'object',
+        properties: {
+            path: {
+                type: 'string',
+                description: 'The path to the file to write',
+            },
+            content: {
+                type: 'string',
+                description: 'The content to write to the file',
+            },
+        },
+        required: ['path', 'content'],
+    },
+    requiresConfirmation: true,
+    type: 'filesystem',
+    handler: async (args) => {
+        const filePath = args['path'];
+        const content = args['content'];
+        try {
+            await fs.mkdir(path.dirname(filePath), { recursive: true });
+            await fs.writeFile(filePath, content, 'utf-8');
+            return { success: true, output: `File written: ${filePath}` };
+        }
+        catch (error) {
+            return {
+                success: false,
+                output: '',
+                error: error instanceof Error ? error.message : 'Failed to write file',
+            };
+        }
+    },
+};
+/**
+ * List directory contents
+ */
+export const listDirectoryTool = {
+    name: 'list_directory',
+    description: 'List the contents of a directory',
+    parameters: {
+        type: 'object',
+        properties: {
+            path: {
+                type: 'string',
+                description: 'The path to the directory to list',
+            },
+        },
+        required: ['path'],
+    },
+    requiresConfirmation: false,
+    type: 'filesystem',
+    handler: async (args) => {
+        const dirPath = args['path'];
+        try {
+            const entries = await fs.readdir(dirPath, { withFileTypes: true });
+            const formatted = entries.map(e => `${e.isDirectory() ? '📁' : '📄'} ${e.name}`).join('\n');
+            return { success: true, output: formatted || '(empty directory)' };
+        }
+        catch (error) {
+            return {
+                success: false,
+                output: '',
+                error: error instanceof Error ? error.message : 'Failed to list directory',
+            };
+        }
+    },
+};
+/**
+ * Delete a file
+ */
+export const deleteFileTool = {
+    name: 'delete_file',
+    description: 'Delete a file',
+    parameters: {
+        type: 'object',
+        properties: {
+            path: {
+                type: 'string',
+                description: 'The path to the file to delete',
+            },
+        },
+        required: ['path'],
+    },
+    requiresConfirmation: true,
+    type: 'filesystem',
+    handler: async (args) => {
+        const filePath = args['path'];
+        try {
+            await fs.unlink(filePath);
+            return { success: true, output: `File deleted: ${filePath}` };
+        }
+        catch (error) {
+            return {
+                success: false,
+                output: '',
+                error: error instanceof Error ? error.message : 'Failed to delete file',
+            };
+        }
+    },
+};
+/**
+ * All filesystem tools
+ */
+export const filesystemTools = [
+    readFileTool,
+    writeFileTool,
+    listDirectoryTool,
+    deleteFileTool,
+];
+//# sourceMappingURL=filesystem.js.map

package/dist/tools/builtin/filesystem.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"filesystem.js","sourceRoot":"","sources":["../../../src/tools/builtin/filesystem.ts"],"names":[],"mappings":"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"}

package/dist/tools/builtin/index.d.ts

@@ -0,0 +1,10 @@
+export { filesystemTools } from './filesystem.js';
+export { shellTools } from './shell.js';
+export { sandboxTools } from './sandbox.js';
+export { searchTools } from './search.js';
+export { browserTools, closeBrowser } from './browser.js';
+/**
+ * All built-in tools combined
+ */
+export declare const allBuiltinTools: import("../../types.js").Tool[];
+//# sourceMappingURL=index.d.ts.map

package/dist/tools/builtin/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/tools/builtin/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACxC,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAQ1D;;GAEG;AACH,eAAO,MAAM,eAAe,iCAM3B,CAAC"}

package/dist/tools/builtin/index.js

@@ -0,0 +1,21 @@
+export { filesystemTools } from './filesystem.js';
+export { shellTools } from './shell.js';
+export { sandboxTools } from './sandbox.js';
+export { searchTools } from './search.js';
+export { browserTools, closeBrowser } from './browser.js';
+import { filesystemTools } from './filesystem.js';
+import { shellTools } from './shell.js';
+import { sandboxTools } from './sandbox.js';
+import { searchTools } from './search.js';
+import { browserTools } from './browser.js';
+/**
+ * All built-in tools combined
+ */
+export const allBuiltinTools = [
+    ...filesystemTools,
+    ...shellTools,
+    ...sandboxTools,
+    ...searchTools,
+    ...browserTools,
+];
+//# sourceMappingURL=index.js.map

package/dist/tools/builtin/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/tools/builtin/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACxC,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAE1D,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACxC,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAE5C;;GAEG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,GAAG,eAAe;IAClB,GAAG,UAAU;IACb,GAAG,YAAY;IACf,GAAG,WAAW;IACd,GAAG,YAAY;CAChB,CAAC"}

package/dist/tools/builtin/sandbox.d.ts

@@ -0,0 +1,11 @@
+import type { Tool } from '../../types.js';
+/**
+ * Execute JavaScript code in isolation using Node's subprocess
+ */
+export declare const runJavaScriptTool: Tool;
+/**
+ * Execute Python code in isolation
+ */
+export declare const runPythonTool: Tool;
+export declare const sandboxTools: Tool[];
+//# sourceMappingURL=sandbox.d.ts.map

package/dist/tools/builtin/sandbox.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sandbox.d.ts","sourceRoot":"","sources":["../../../src/tools/builtin/sandbox.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,IAAI,EAAc,MAAM,gBAAgB,CAAC;AAEvD;;GAEG;AACH,eAAO,MAAM,iBAAiB,EAAE,IA2F/B,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,aAAa,EAAE,IA4E3B,CAAC;AAEF,eAAO,MAAM,YAAY,EAAE,IAAI,EAAuC,CAAC"}

package/dist/tools/builtin/sandbox.js

@@ -0,0 +1,166 @@
+import { spawn } from 'node:child_process';
+import * as fs from 'node:fs/promises';
+import * as path from 'node:path';
+import * as os from 'node:os';
+/**
+ * Execute JavaScript code in isolation using Node's subprocess
+ */
+export const runJavaScriptTool = {
+    name: 'run_javascript',
+    description: 'Execute JavaScript code in an isolated subprocess and return the result',
+    parameters: {
+        type: 'object',
+        properties: {
+            code: {
+                type: 'string',
+                description: 'The JavaScript code to execute',
+            },
+        },
+        required: ['code'],
+    },
+    requiresConfirmation: true,
+    type: 'sandbox',
+    handler: async (args) => {
+        const code = args['code'];
+        // Create a temp file for the code
+        const tmpDir = await fs.mkdtemp(path.join(os.tmpdir(), 'keygate-js-'));
+        const tmpFile = path.join(tmpDir, 'script.mjs');
+        // Wrap code to capture output
+        const wrappedCode = `
+const __result = (async () => {
+  ${code}
+})();
+__result.then(r => {
+  if (r !== undefined) console.log(JSON.stringify(r, null, 2));
+}).catch(e => {
+  console.error(e.message);
+  process.exit(1);
+});
+`;
+        try {
+            await fs.writeFile(tmpFile, wrappedCode, 'utf-8');
+            return new Promise((resolve) => {
+                const proc = spawn('node', [tmpFile], {
+                    timeout: 30000, // 30 second timeout
+                    cwd: tmpDir,
+                });
+                let stdout = '';
+                let stderr = '';
+                proc.stdout.on('data', (data) => {
+                    stdout += data.toString();
+                });
+                proc.stderr.on('data', (data) => {
+                    stderr += data.toString();
+                });
+                proc.on('close', async (code) => {
+                    // Cleanup
+                    await fs.rm(tmpDir, { recursive: true, force: true });
+                    if (code === 0) {
+                        resolve({
+                            success: true,
+                            output: stdout.trim() || '(no output)',
+                        });
+                    }
+                    else {
+                        resolve({
+                            success: false,
+                            output: stdout,
+                            error: stderr || `Script exited with code ${code}`,
+                        });
+                    }
+                });
+                proc.on('error', async (error) => {
+                    await fs.rm(tmpDir, { recursive: true, force: true });
+                    resolve({
+                        success: false,
+                        output: '',
+                        error: error.message,
+                    });
+                });
+            });
+        }
+        catch (error) {
+            await fs.rm(tmpDir, { recursive: true, force: true }).catch(() => { });
+            return {
+                success: false,
+                output: '',
+                error: error instanceof Error ? error.message : 'Failed to execute JavaScript',
+            };
+        }
+    },
+};
+/**
+ * Execute Python code in isolation
+ */
+export const runPythonTool = {
+    name: 'run_python',
+    description: 'Execute Python code in an isolated subprocess and return the result',
+    parameters: {
+        type: 'object',
+        properties: {
+            code: {
+                type: 'string',
+                description: 'The Python code to execute',
+            },
+        },
+        required: ['code'],
+    },
+    requiresConfirmation: true,
+    type: 'sandbox',
+    handler: async (args) => {
+        const code = args['code'];
+        const tmpDir = await fs.mkdtemp(path.join(os.tmpdir(), 'keygate-py-'));
+        const tmpFile = path.join(tmpDir, 'script.py');
+        try {
+            await fs.writeFile(tmpFile, code, 'utf-8');
+            return new Promise((resolve) => {
+                const proc = spawn('python3', [tmpFile], {
+                    timeout: 30000,
+                    cwd: tmpDir,
+                });
+                let stdout = '';
+                let stderr = '';
+                proc.stdout.on('data', (data) => {
+                    stdout += data.toString();
+                });
+                proc.stderr.on('data', (data) => {
+                    stderr += data.toString();
+                });
+                proc.on('close', async (code) => {
+                    await fs.rm(tmpDir, { recursive: true, force: true });
+                    if (code === 0) {
+                        resolve({
+                            success: true,
+                            output: stdout.trim() || '(no output)',
+                        });
+                    }
+                    else {
+                        resolve({
+                            success: false,
+                            output: stdout,
+                            error: stderr || `Script exited with code ${code}`,
+                        });
+                    }
+                });
+                proc.on('error', async (error) => {
+                    await fs.rm(tmpDir, { recursive: true, force: true });
+                    resolve({
+                        success: false,
+                        output: '',
+                        error: error.message,
+                    });
+                });
+            });
+        }
+        catch (error) {
+            await fs.rm(tmpDir, { recursive: true, force: true }).catch(() => { });
+            return {
+                success: false,
+                output: '',
+                error: error instanceof Error ? error.message : 'Failed to execute Python',
+            };
+        }
+    },
+};
+export const sandboxTools = [runJavaScriptTool, runPythonTool];
+//# sourceMappingURL=sandbox.js.map