agent-orcha 0.0.5 → 0.0.8

package/dist/lib/sandbox/page-readiness.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"page-readiness.js","sourceRoot":"","sources":["../../../lib/sandbox/page-readiness.ts"],"names":[],"mappings":"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"}

package/dist/lib/sandbox/sandbox-browser.d.ts

@@ -0,0 +1,4 @@
+import type { StructuredTool } from '../types/llm-types.ts';
+import type { SandboxConfig } from './types.ts';
+export declare function createBrowserTools(config: SandboxConfig): StructuredTool[];
+//# sourceMappingURL=sandbox-browser.d.ts.map

package/dist/lib/sandbox/sandbox-browser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sandbox-browser.d.ts","sourceRoot":"","sources":["../../../lib/sandbox/sandbox-browser.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,cAAc,EAAe,MAAM,uBAAuB,CAAC;AACzE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAKhD,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,aAAa,GAAG,cAAc,EAAE,CAsX1E"}

package/dist/lib/sandbox/sandbox-browser.js

@@ -0,0 +1,316 @@
+import { z } from 'zod';
+import { tool } from "../types/tool-factory.js";
+import { htmlToMarkdown } from "./html-to-markdown.js";
+import { CDPClient } from "./cdp-client.js";
+import { PageReadiness } from "./page-readiness.js";
+/** Hard cap on content() output to prevent 50K+ char dumps blowing up context. */
+const CONTENT_MAX_CHARS = 15_000;
+export function createBrowserTools(config) {
+    const cdpUrl = config.browserCdpUrl;
+    let client = null;
+    let readiness = null;
+    async function getReady() {
+        if (client?.connected && readiness) {
+            return { cdp: client, ready: readiness };
+        }
+        // Clean up old instances before reconnecting
+        if (readiness) {
+            readiness.detach();
+            readiness = null;
+        }
+        if (client) {
+            await client.close();
+            client = null;
+        }
+        client = new CDPClient();
+        await client.connect(cdpUrl);
+        readiness = new PageReadiness(client);
+        await readiness.attach();
+        return { cdp: client, ready: readiness };
+    }
+    function errorResult(error) {
+        const msg = error instanceof Error ? error.message : String(error);
+        return JSON.stringify({ error: msg });
+    }
+    // -- observe: cheap text snapshot of the page (primary verification tool) --
+    const observe = tool(async () => {
+        try {
+            const { ready } = await getReady();
+            const snapshot = await ready.observe();
+            return JSON.stringify(snapshot);
+        }
+        catch (e) {
+            return errorResult(e);
+        }
+    }, {
+        name: 'sandbox_browser_observe',
+        description: 'Text snapshot of current page: URL, title, headings, textExcerpt (first 2000 chars of visible text), interactive elements with refs. Check textExcerpt first — it often has what you need.',
+        schema: z.object({}),
+    });
+    // -- navigate: go to URL, wait for readiness, return observe snapshot --
+    const navigate = tool(async ({ url }) => {
+        try {
+            const { cdp, ready } = await getReady();
+            ready.resetForNavigation();
+            const navResult = await cdp.send('Page.navigate', { url });
+            // Check for navigation-level errors (invalid URL, network failures, etc.)
+            if (navResult?.errorText) {
+                return JSON.stringify({ error: `Navigation failed: ${navResult.errorText}`, url });
+            }
+            await ready.waitForReady(config.commandTimeout);
+            const snapshot = await ready.observe();
+            return JSON.stringify(snapshot);
+        }
+        catch (e) {
+            return errorResult(e);
+        }
+    }, {
+        name: 'sandbox_browser_navigate',
+        description: 'Navigate to URL. Waits for load+idle. Returns text snapshot with textExcerpt and interactive elements.',
+        schema: z.object({
+            url: z.string().describe('The URL to navigate to'),
+        }),
+    });
+    // -- screenshot: expensive visual capture, use only when text observation is insufficient --
+    const screenshot = tool(async () => {
+        try {
+            const { cdp } = await getReady();
+            const result = await cdp.send('Page.captureScreenshot', { format: 'jpeg', quality: 75 });
+            const data = result.data;
+            return [
+                { type: 'image', data, mediaType: 'image/jpeg' },
+                { type: 'text', text: 'Screenshot captured.' },
+            ];
+        }
+        catch (e) {
+            return errorResult(e);
+        }
+    }, {
+        name: 'sandbox_browser_screenshot',
+        description: 'JPEG screenshot. Expensive — only when observe/content insufficient (CAPTCHAs, charts).',
+        schema: z.object({}),
+    });
+    // -- content: full page or element as markdown --
+    const content = tool(async ({ selector }) => {
+        try {
+            const { cdp } = await getReady();
+            const expression = selector
+                ? `(() => { const el = document.querySelector(${JSON.stringify(selector)}); return el ? el.outerHTML : null; })()`
+                : 'document.documentElement.outerHTML';
+            const result = await cdp.send('Runtime.evaluate', { expression });
+            const html = result.result?.value;
+            if (!html) {
+                return JSON.stringify({ error: selector ? `Element not found: ${selector}` : 'No content' });
+            }
+            const markdown = htmlToMarkdown(html, { includeNavigation: !!selector, includeInteractiveElements: true, includeImages: true });
+            const maxChars = Math.min(CONTENT_MAX_CHARS, config.maxOutputChars);
+            let output = JSON.stringify({ content: markdown, selector: selector ?? null });
+            if (output.length > maxChars) {
+                const truncated = markdown.substring(0, maxChars);
+                output = JSON.stringify({ content: truncated, truncated: true, selector: selector ?? null });
+            }
+            return output;
+        }
+        catch (e) {
+            return errorResult(e);
+        }
+    }, {
+        name: 'sandbox_browser_content',
+        description: 'Page content as markdown (capped at 15K chars). Use a CSS selector to target a specific section instead of fetching the full page.',
+        schema: z.object({
+            selector: z
+                .string()
+                .optional()
+                .describe('CSS selector to extract a specific element (optional, defaults to full page)'),
+        }),
+    });
+    // -- evaluate: run arbitrary JS, report side effects --
+    const evaluate = tool(async ({ expression }) => {
+        try {
+            const { cdp, ready } = await getReady();
+            const preUrl = await cdp.send('Runtime.evaluate', {
+                expression: 'location.href',
+                returnByValue: true,
+            });
+            const preUrlValue = preUrl.result?.value;
+            ready.resetNetworkFlag();
+            const result = await cdp.send('Runtime.evaluate', {
+                expression,
+                returnByValue: true,
+                awaitPromise: true,
+            });
+            const val = result.result;
+            if (val?.subtype === 'error' || result.exceptionDetails) {
+                const errMsg = result.exceptionDetails?.exception?.description ??
+                    val?.description ??
+                    'Evaluation error';
+                return JSON.stringify({ error: errMsg });
+            }
+            await ready.waitForSettle(300);
+            const postUrl = await cdp.send('Runtime.evaluate', {
+                expression: 'location.href',
+                returnByValue: true,
+            });
+            const postUrlValue = postUrl.result?.value;
+            const sideEffects = {};
+            if (preUrlValue !== postUrlValue) {
+                sideEffects.urlChanged = { from: preUrlValue, to: postUrlValue };
+            }
+            if (ready.hadNetworkActivity()) {
+                sideEffects.networkTriggered = true;
+            }
+            return JSON.stringify({
+                result: val?.value ?? null,
+                type: val?.type ?? 'undefined',
+                ...(Object.keys(sideEffects).length > 0 ? { sideEffects } : {}),
+            });
+        }
+        catch (e) {
+            return errorResult(e);
+        }
+    }, {
+        name: 'sandbox_browser_evaluate',
+        description: 'Run JavaScript in browser. Returns result + side effects. Prefer click/type for interactions.',
+        schema: z.object({
+            expression: z.string().describe('JavaScript expression to evaluate in the page'),
+        }),
+    });
+    // -- click: find element, scroll, click, return lightweight result --
+    const click = tool(async ({ ref, text }) => {
+        try {
+            const { cdp, ready } = await getReady();
+            // Resolve ref (e.g. "e3") to CSS selector
+            const selector = ref ? ready.resolveRef(ref) : undefined;
+            const findExpr = selector
+                ? `(() => {
+              const el = document.querySelector(${JSON.stringify(selector)});
+              if (!el) return { error: 'Element not found: ' + ${JSON.stringify(ref)} };
+              return { found: true, tag: el.tagName.toLowerCase(), text: (el.textContent||'').trim().substring(0,40) };
+            })()`
+                : `(() => {
+              const searchText = ${JSON.stringify(text ?? '')};
+              const clickable = document.querySelectorAll('a, button, [role="button"], input[type="submit"], input[type="button"], [onclick], [tabindex]');
+              for (const el of clickable) {
+                if (el.offsetParent === null) continue;
+                if (el.textContent && el.textContent.trim().toLowerCase().includes(searchText.toLowerCase())) {
+                  return { found: true, tag: el.tagName.toLowerCase(), text: (el.textContent||'').trim().substring(0,40) };
+                }
+              }
+              return { error: 'No clickable element found containing text: ' + searchText };
+            })()`;
+            const findResult = await cdp.send('Runtime.evaluate', {
+                expression: findExpr,
+                returnByValue: true,
+            });
+            const found = findResult.result?.value;
+            if (found?.error)
+                return JSON.stringify(found);
+            const preUrl = await cdp.send('Runtime.evaluate', {
+                expression: 'location.href',
+                returnByValue: true,
+            });
+            const clickExpr = selector
+                ? `(() => {
+              const el = document.querySelector(${JSON.stringify(selector)});
+              el.scrollIntoView({ block: 'center', behavior: 'instant' });
+              el.click();
+              return true;
+            })()`
+                : `(() => {
+              const searchText = ${JSON.stringify(text ?? '')};
+              const clickable = document.querySelectorAll('a, button, [role="button"], input[type="submit"], input[type="button"], [onclick], [tabindex]');
+              for (const el of clickable) {
+                if (el.offsetParent === null) continue;
+                if (el.textContent && el.textContent.trim().toLowerCase().includes(searchText.toLowerCase())) {
+                  el.scrollIntoView({ block: 'center', behavior: 'instant' });
+                  el.click();
+                  return true;
+                }
+              }
+              return false;
+            })()`;
+            ready.resetNetworkFlag();
+            await cdp.send('Runtime.evaluate', {
+                expression: clickExpr,
+                returnByValue: true,
+                awaitPromise: true,
+            });
+            await ready.waitForSettle(500);
+            const postUrl = await cdp.send('Runtime.evaluate', {
+                expression: 'location.href',
+                returnByValue: true,
+            });
+            const preUrlVal = preUrl.result?.value;
+            const postUrlVal = postUrl.result?.value;
+            const navigated = preUrlVal !== postUrlVal;
+            if (navigated) {
+                ready.resetForNavigation();
+                await ready.waitForReady(config.commandTimeout);
+            }
+            const titleResult = await cdp.send('Runtime.evaluate', {
+                expression: 'document.title',
+                returnByValue: true,
+            });
+            return JSON.stringify({
+                clicked: found,
+                navigated,
+                url: postUrlVal,
+                title: titleResult.result?.value ?? '',
+            });
+        }
+        catch (e) {
+            return errorResult(e);
+        }
+    }, {
+        name: 'sandbox_browser_click',
+        description: 'Click an element by ref from observe output (e.g. "e3") or visible text. Scrolls into view, clicks, waits for effects.',
+        schema: z.object({
+            ref: z.string().optional().describe('Element ref from observe output (e.g. "e3")'),
+            text: z.string().optional().describe('Visible text to find and click'),
+        }),
+    });
+    // -- type: fill an input field --
+    const type_ = tool(async ({ ref, text, clear }) => {
+        try {
+            const { cdp, ready } = await getReady();
+            const selector = ready.resolveRef(ref);
+            const expr = `(() => {
+          const el = document.querySelector(${JSON.stringify(selector)});
+          if (!el) return { error: 'Element not found: ' + ${JSON.stringify(ref)} };
+          if (!('value' in el)) return { error: 'Element is not an input: ' + el.tagName };
+
+          el.scrollIntoView({ block: 'center', behavior: 'instant' });
+          el.focus();
+          ${clear !== false ? "el.value = '';" : ''}
+          el.value = ${JSON.stringify(text)};
+          el.dispatchEvent(new Event('input', { bubbles: true }));
+          el.dispatchEvent(new Event('change', { bubbles: true }));
+
+          return { typed: true, value: el.value };
+        })()`;
+            const result = await cdp.send('Runtime.evaluate', {
+                expression: expr,
+                returnByValue: true,
+                awaitPromise: true,
+            });
+            const val = result.result?.value;
+            if (val?.error)
+                return JSON.stringify(val);
+            await ready.waitForSettle(300);
+            return JSON.stringify(val);
+        }
+        catch (e) {
+            return errorResult(e);
+        }
+    }, {
+        name: 'sandbox_browser_type',
+        description: 'Type text into an input/textarea by ref from observe output (e.g. "e5"). Handles focus and input/change events.',
+        schema: z.object({
+            ref: z.string().describe('Element ref from observe output (e.g. "e5")'),
+            text: z.string().describe('Text to type'),
+            clear: z.boolean().optional().describe('Clear first (default: true)'),
+        }),
+    });
+    return [observe, navigate, screenshot, content, evaluate, click, type_];
+}
+//# sourceMappingURL=sandbox-browser.js.map

package/dist/lib/sandbox/sandbox-browser.js.map

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

package/dist/lib/sandbox/sandbox-container.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Manages the standalone sandbox Docker container.
+ * Pulls the published sandbox image and runs it via `docker run`.
+ * Works both in development and when installed via npm.
+ */
+export declare class SandboxContainer {
+    private dockerPath;
+    private running;
+    /**
+     * Detect if Docker (or compatible runtime) is available.
+     */
+    detectDocker(): boolean;
+    /**
+     * Check if the sandbox container is already running.
+     */
+    isContainerRunning(): boolean;
+    /**
+     * Start the sandbox container by pulling and running the published image.
+     */
+    start(): Promise<boolean>;
+    /**
+     * Stop and remove the sandbox container.
+     */
+    stop(): Promise<void>;
+    /**
+     * Execute a shell command inside the sandbox container.
+     */
+    exec(command: string, timeout: number): Promise<{
+        stdout: string;
+        stderr: string;
+        exitCode: number;
+        error?: string;
+    }>;
+    get isRunning(): boolean;
+    get docker(): string | null;
+    private pullImage;
+    private waitForCDP;
+}
+//# sourceMappingURL=sandbox-container.d.ts.map

package/dist/lib/sandbox/sandbox-container.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sandbox-container.d.ts","sourceRoot":"","sources":["../../../lib/sandbox/sandbox-container.ts"],"names":[],"mappings":"AAMA;;;;GAIG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,UAAU,CAAuB;IACzC,OAAO,CAAC,OAAO,CAAS;IAExB;;OAEG;IACH,YAAY,IAAI,OAAO;IAgBvB;;OAEG;IACH,kBAAkB,IAAI,OAAO;IAa7B;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,OAAO,CAAC;IAqD/B;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAkB3B;;OAEG;IACH,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IA4BrH,IAAI,SAAS,IAAI,OAAO,CAEvB;IAED,IAAI,MAAM,IAAI,MAAM,GAAG,IAAI,CAE1B;IAED,OAAO,CAAC,SAAS;YAQH,UAAU;CAazB"}

package/dist/lib/sandbox/sandbox-container.js

@@ -0,0 +1,176 @@
+import { execFile, execFileSync } from 'node:child_process';
+import { logger } from "../logger.js";
+const CONTAINER_NAME = 'orcha-sandbox';
+const SANDBOX_IMAGE = 'ddalcu/agent-orcha-sandbox:latest';
+/**
+ * Manages the standalone sandbox Docker container.
+ * Pulls the published sandbox image and runs it via `docker run`.
+ * Works both in development and when installed via npm.
+ */
+export class SandboxContainer {
+    dockerPath = null;
+    running = false;
+    /**
+     * Detect if Docker (or compatible runtime) is available.
+     */
+    detectDocker() {
+        const candidates = ['/usr/local/bin/docker', '/usr/bin/docker', 'docker'];
+        for (const candidate of candidates) {
+            try {
+                execFileSync(candidate, ['version'], { stdio: 'pipe', timeout: 5000 });
+                this.dockerPath = candidate;
+                return true;
+            }
+            catch {
+                // Not found or not working
+            }
+        }
+        return false;
+    }
+    /**
+     * Check if the sandbox container is already running.
+     */
+    isContainerRunning() {
+        if (!this.dockerPath)
+            return false;
+        try {
+            const output = execFileSync(this.dockerPath, [
+                'container', 'inspect', '-f', '{{.State.Running}}', CONTAINER_NAME,
+            ], { stdio: 'pipe', timeout: 5000 }).toString().trim();
+            return output === 'true';
+        }
+        catch {
+            return false;
+        }
+    }
+    /**
+     * Start the sandbox container by pulling and running the published image.
+     */
+    async start() {
+        if (!this.dockerPath) {
+            logger.warn('[Sandbox] Docker not detected — sandbox container not available');
+            return false;
+        }
+        if (this.isContainerRunning()) {
+            logger.info('[Sandbox] Container already running');
+            this.running = true;
+            return true;
+        }
+        logger.info(`[Sandbox] Pulling ${SANDBOX_IMAGE}...`);
+        const pulled = await this.pullImage(SANDBOX_IMAGE);
+        if (!pulled) {
+            logger.error('[Sandbox] Failed to pull sandbox image');
+            return false;
+        }
+        logger.info('[Sandbox] Starting sandbox container...');
+        return new Promise((resolve) => {
+            execFile(this.dockerPath, [
+                'run', '-d',
+                '--name', CONTAINER_NAME,
+                '-p', '9222:9223',
+                '-p', '6080:6080',
+                '--shm-size', '2g',
+                '--cap-add', 'SYS_ADMIN',
+                '--restart', 'unless-stopped',
+                SANDBOX_IMAGE,
+            ], { timeout: 30_000 }, (error, _stdout, stderr) => {
+                if (error) {
+                    logger.error(`[Sandbox] Failed to start container: ${error.message}`);
+                    if (stderr)
+                        logger.error(`[Sandbox] ${stderr}`);
+                    resolve(false);
+                    return;
+                }
+                this.waitForCDP().then((ready) => {
+                    if (ready) {
+                        logger.info('[Sandbox] Container ready (CDP: localhost:9222, VNC: localhost:6080)');
+                        this.running = true;
+                    }
+                    else {
+                        logger.warn('[Sandbox] Container started but CDP not responding');
+                    }
+                    resolve(ready);
+                });
+            });
+        });
+    }
+    /**
+     * Stop and remove the sandbox container.
+     */
+    async stop() {
+        if (!this.dockerPath || !this.running)
+            return;
+        return new Promise((resolve) => {
+            execFile(this.dockerPath, [
+                'rm', '-f', CONTAINER_NAME,
+            ], { timeout: 30_000 }, (error) => {
+                if (error) {
+                    logger.warn(`[Sandbox] Failed to stop container: ${error.message}`);
+                }
+                else {
+                    logger.info('[Sandbox] Container stopped');
+                }
+                this.running = false;
+                resolve();
+            });
+        });
+    }
+    /**
+     * Execute a shell command inside the sandbox container.
+     */
+    exec(command, timeout) {
+        return new Promise((resolve) => {
+            if (!this.dockerPath || !this.running) {
+                resolve({ stdout: '', stderr: '', exitCode: -1, error: 'Sandbox container not running' });
+                return;
+            }
+            execFile(this.dockerPath, [
+                'exec', CONTAINER_NAME,
+                'su', '-s', '/bin/sh', 'sandbox', '-c', command,
+            ], { timeout, maxBuffer: 10 * 1024 * 1024 }, (error, stdout, stderr) => {
+                let exitCode = 0;
+                if (error && 'code' in error && typeof error.code === 'number') {
+                    exitCode = error.code;
+                }
+                else if (error) {
+                    exitCode = 1;
+                }
+                resolve({
+                    stdout: stdout ?? '',
+                    stderr: stderr ?? '',
+                    exitCode,
+                    ...(error && typeof error.code !== 'number' ? { error: error.message } : {}),
+                });
+            });
+        });
+    }
+    get isRunning() {
+        return this.running;
+    }
+    get docker() {
+        return this.dockerPath;
+    }
+    pullImage(image) {
+        return new Promise((resolve) => {
+            execFile(this.dockerPath, ['pull', image], { timeout: 120_000 }, (error) => {
+                resolve(!error);
+            });
+        });
+    }
+    async waitForCDP(maxWait = 15_000) {
+        const start = Date.now();
+        while (Date.now() - start < maxWait) {
+            try {
+                const response = await fetch('http://localhost:9222/json/version');
+                if (response.ok)
+                    return true;
+            }
+            catch {
+                // Not ready yet
+            }
+            await new Promise((r) => setTimeout(r, 500));
+        }
+        return false;
+    }
+}
+//# sourceMappingURL=sandbox-container.js.map

package/dist/lib/sandbox/sandbox-container.js.map

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

package/dist/lib/sandbox/sandbox-file.d.ts

@@ -0,0 +1,4 @@
+import type { StructuredTool } from '../types/llm-types.ts';
+import type { SandboxConfig } from './types.ts';
+export declare function createFileTools(config: SandboxConfig): StructuredTool[];
+//# sourceMappingURL=sandbox-file.d.ts.map

package/dist/lib/sandbox/sandbox-file.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sandbox-file.d.ts","sourceRoot":"","sources":["../../../lib/sandbox/sandbox-file.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AA0BhD,wBAAgB,eAAe,CAAC,MAAM,EAAE,aAAa,GAAG,cAAc,EAAE,CAyKvE"}