@bubblelab/bubble-core 0.1.0

package/dist/bubbles/tool-bubble/virtual-file-editor.tool.d.ts

@@ -0,0 +1,125 @@
+/**
+ * VIRTUAL FILE EDITOR TOOL
+ *
+ * Provides line-based edits on a virtual file represented as an array of lines.
+ * This tool does not touch disk; it returns the updated array and a rendered view.
+ */
+import { z } from 'zod';
+import { ToolBubble } from '../../types/tool-bubble-class.js';
+import type { BubbleContext } from '../../types/bubble.js';
+import { CredentialType } from '@nodex/shared-schemas';
+declare const VirtualFileEditorParamsSchema: z.ZodObject<{
+    edit: z.ZodObject<{
+        op: z.ZodEnum<["insert", "delete", "replace"]>;
+        startLine: z.ZodNumber;
+        endLine: z.ZodOptional<z.ZodNumber>;
+        text: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        op: "insert" | "delete" | "replace";
+        startLine: number;
+        endLine?: number | undefined;
+        text?: string | undefined;
+    }, {
+        op: "insert" | "delete" | "replace";
+        startLine: number;
+        endLine?: number | undefined;
+        text?: string | undefined;
+    }>;
+    credentials: z.ZodOptional<z.ZodRecord<z.ZodNativeEnum<typeof CredentialType>, z.ZodString>>;
+    config: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, "strip", z.ZodTypeAny, {
+    edit: {
+        op: "insert" | "delete" | "replace";
+        startLine: number;
+        endLine?: number | undefined;
+        text?: string | undefined;
+    };
+    credentials?: Partial<Record<CredentialType, string>> | undefined;
+    config?: Record<string, unknown> | undefined;
+}, {
+    edit: {
+        op: "insert" | "delete" | "replace";
+        startLine: number;
+        endLine?: number | undefined;
+        text?: string | undefined;
+    };
+    credentials?: Partial<Record<CredentialType, string>> | undefined;
+    config?: Record<string, unknown> | undefined;
+}>;
+declare const VirtualFileEditorResultSchema: z.ZodObject<{
+    updatedCodeLines: z.ZodArray<z.ZodString, "many">;
+    success: z.ZodBoolean;
+    error: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    updatedCodeLines: string[];
+    success: boolean;
+    error: string;
+}, {
+    updatedCodeLines: string[];
+    success: boolean;
+    error: string;
+}>;
+type VFEParams = z.input<typeof VirtualFileEditorParamsSchema>;
+type VFEResult = z.output<typeof VirtualFileEditorResultSchema>;
+export declare class VirtualFileEditorTool extends ToolBubble<VFEParams, VFEResult> {
+    static readonly type: "tool";
+    static readonly bubbleName = "virtual-file-editor-tool";
+    static readonly schema: z.ZodObject<{
+        edit: z.ZodObject<{
+            op: z.ZodEnum<["insert", "delete", "replace"]>;
+            startLine: z.ZodNumber;
+            endLine: z.ZodOptional<z.ZodNumber>;
+            text: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            op: "insert" | "delete" | "replace";
+            startLine: number;
+            endLine?: number | undefined;
+            text?: string | undefined;
+        }, {
+            op: "insert" | "delete" | "replace";
+            startLine: number;
+            endLine?: number | undefined;
+            text?: string | undefined;
+        }>;
+        credentials: z.ZodOptional<z.ZodRecord<z.ZodNativeEnum<typeof CredentialType>, z.ZodString>>;
+        config: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, "strip", z.ZodTypeAny, {
+        edit: {
+            op: "insert" | "delete" | "replace";
+            startLine: number;
+            endLine?: number | undefined;
+            text?: string | undefined;
+        };
+        credentials?: Partial<Record<CredentialType, string>> | undefined;
+        config?: Record<string, unknown> | undefined;
+    }, {
+        edit: {
+            op: "insert" | "delete" | "replace";
+            startLine: number;
+            endLine?: number | undefined;
+            text?: string | undefined;
+        };
+        credentials?: Partial<Record<CredentialType, string>> | undefined;
+        config?: Record<string, unknown> | undefined;
+    }>;
+    static readonly resultSchema: z.ZodObject<{
+        updatedCodeLines: z.ZodArray<z.ZodString, "many">;
+        success: z.ZodBoolean;
+        error: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        updatedCodeLines: string[];
+        success: boolean;
+        error: string;
+    }, {
+        updatedCodeLines: string[];
+        success: boolean;
+        error: string;
+    }>;
+    static readonly shortDescription = "Edits a virtual file using a single insert/delete/replace operation per call.";
+    static readonly longDescription = "\n    A utility tool for agentic coding loops. Applies a single edit to a virtual file and\n    returns the updated file content and a rendered numbered view for the prompt.\n    The current file content is maintained in the tool's internal state.\n    Only one edit operation is allowed per call.\n\n    OPERATION TYPES:\n    \n    1. INSERT: Adds new lines BEFORE the specified startLine\n       Example: { \"op\": \"insert\", \"startLine\": 5, \"text\": \"const x = 1;\" }\n       - This adds the new line BEFORE line 5, pushing existing line 5 to line 6\n    \n    2. DELETE: Removes lines from startLine to endLine (inclusive)\n       Example: { \"op\": \"delete\", \"startLine\": 3, \"endLine\": 5 }\n       - This removes lines 3, 4, and 5\n       - For single line: { \"op\": \"delete\", \"startLine\": 3 } (endLine defaults to startLine)\n       - DO NOT include 'text' parameter for delete operations\n    \n    3. REPLACE: Replaces lines from startLine to endLine with new text\n       Example: { \"op\": \"replace\", \"startLine\": 2, \"endLine\": 4, \"text\": \"new content\\nline 2\" }\n       - This replaces lines 2, 3, and 4 with the new text\n       - For single line: { \"op\": \"replace\", \"startLine\": 2, \"text\": \"new content\" }\n       - For multi-line replacement, ALWAYS specify both startLine AND endLine\n    \n    CRITICAL RULES:\n    - Line numbers are 1-based (first line is 1, not 0)\n    - For multi-line operations, ALWAYS specify both startLine AND endLine\n    - For delete operations, NEVER include the 'text' parameter\n    - Use \\n in text to create multiple lines\n    - Each call can only perform ONE operation\n  ";
+    static readonly alias = "vfe";
+    constructor(params: VFEParams, context?: BubbleContext);
+    performAction(context?: BubbleContext): Promise<VFEResult>;
+}
+export {};
+//# sourceMappingURL=virtual-file-editor.tool.d.ts.map

package/dist/bubbles/tool-bubble/virtual-file-editor.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"virtual-file-editor.tool.d.ts","sourceRoot":"","sources":["../../../src/bubbles/tool-bubble/virtual-file-editor.tool.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,UAAU,EAAE,MAAM,kCAAkC,CAAC;AAC9D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AA+BvD,QAAA,MAAM,6BAA6B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAMjC,CAAC;AAEH,QAAA,MAAM,6BAA6B;;;;;;;;;;;;EAMjC,CAAC;AAEH,KAAK,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,6BAA6B,CAAC,CAAC;AAC/D,KAAK,SAAS,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,6BAA6B,CAAC,CAAC;AAuDhE,qBAAa,qBAAsB,SAAQ,UAAU,CAAC,SAAS,EAAE,SAAS,CAAC;IACzE,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAG,MAAM,CAAU;IACvC,MAAM,CAAC,QAAQ,CAAC,UAAU,8BAA8B;IACxD,MAAM,CAAC,QAAQ,CAAC,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAAiC;IACvD,MAAM,CAAC,QAAQ,CAAC,YAAY;;;;;;;;;;;;OAAiC;IAC7D,MAAM,CAAC,QAAQ,CAAC,gBAAgB,mFACkD;IAClF,MAAM,CAAC,QAAQ,CAAC,eAAe,koDA8B7B;IACF,MAAM,CAAC,QAAQ,CAAC,KAAK,SAAS;gBAElB,MAAM,EAAE,SAAS,EAAE,OAAO,CAAC,EAAE,aAAa;IAIhD,aAAa,CAAC,OAAO,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,SAAS,CAAC;CAsDjE"}

package/dist/bubbles/tool-bubble/virtual-file-editor.tool.js

@@ -0,0 +1,169 @@
+/**
+ * VIRTUAL FILE EDITOR TOOL
+ *
+ * Provides line-based edits on a virtual file represented as an array of lines.
+ * This tool does not touch disk; it returns the updated array and a rendered view.
+ */
+import { z } from 'zod';
+import { ToolBubble } from '../../types/tool-bubble-class.js';
+import { CredentialType } from '@nodex/shared-schemas';
+const FileEditSchema = z.object({
+    op: z
+        .enum(['insert', 'delete', 'replace'])
+        .describe('Operation type: "insert" adds new lines BEFORE startLine, "delete" removes lines from startLine to endLine (inclusive), "replace" replaces lines from startLine to endLine with new text. For delete operations, do NOT include text parameter.'),
+    startLine: z
+        .number()
+        .int()
+        .min(1)
+        .describe('Line number (1-based). For insert: new lines added BEFORE this line. For delete/replace: first line to modify (inclusive)'),
+    endLine: z
+        .number()
+        .int()
+        .min(1)
+        .optional()
+        .describe('Last line to modify (inclusive). OPTIONAL - defaults to startLine for single-line delete/replace. Specify range for multi-line operations.'),
+    text: z
+        .string()
+        .optional()
+        .describe('Text content for insert or replace operations. Use \\n for multiple lines. DO NOT include this parameter for delete operations.'),
+});
+const VirtualFileEditorParamsSchema = z.object({
+    edit: FileEditSchema.describe('Single edit operation. Examples: Replace line 2: { "op": "replace", "startLine": 2, "text": "new content" }. Insert before line 1: { "op": "insert", "startLine": 1, "text": "new line" }. Delete line 5: { "op": "delete", "startLine": 5 }. Multi-line replace: { "op": "replace", "startLine": 2, "endLine": 4, "text": "new content" }. For delete operations, do NOT include text parameter.'),
+    credentials: z.record(z.nativeEnum(CredentialType), z.string()).optional(),
+    config: z.record(z.string(), z.unknown()).optional(),
+});
+const VirtualFileEditorResultSchema = z.object({
+    updatedCodeLines: z
+        .array(z.string())
+        .describe('Updated file content as array of lines'),
+    success: z.boolean(),
+    error: z.string(),
+});
+function splitLines(text) {
+    return text.replace(/\r\n?/g, '\n').split('\n');
+}
+function applyEdit(codeLines, edit) {
+    const lines = [...codeLines];
+    const startIdx = Math.max(1, edit.startLine) - 1;
+    // Default endLine to startLine for single-line operations if not provided
+    const endIdx = edit.endLine !== undefined
+        ? Math.max(1, edit.endLine) - 1
+        : edit.op === 'delete' || edit.op === 'replace'
+            ? startIdx // Default to single line for delete/replace
+            : undefined;
+    if (edit.op === 'insert') {
+        const insertLines = splitLines(edit.text ?? '');
+        const clampIdx = Math.min(Math.max(0, startIdx), lines.length);
+        lines.splice(clampIdx, 0, ...insertLines);
+        return lines;
+    }
+    // For delete/replace, endIdx should now always be defined (defaulted to startIdx)
+    if (endIdx === undefined) {
+        console.warn('[VirtualFileEditor] Invalid edit: endIdx is undefined for', edit.op);
+        return lines; // Safety fallback
+    }
+    const from = Math.min(Math.max(0, startIdx), lines.length - 1);
+    const to = Math.min(Math.max(from, endIdx), lines.length - 1);
+    const deleteCount = to - from + 1;
+    if (edit.op === 'delete') {
+        lines.splice(from, deleteCount);
+        return lines;
+    }
+    if (edit.op === 'replace') {
+        const replaceLines = splitLines(edit.text ?? '');
+        lines.splice(from, deleteCount, ...replaceLines);
+        return lines;
+    }
+    return lines;
+}
+export class VirtualFileEditorTool extends ToolBubble {
+    static type = 'tool';
+    static bubbleName = 'virtual-file-editor-tool';
+    static schema = VirtualFileEditorParamsSchema;
+    static resultSchema = VirtualFileEditorResultSchema;
+    static shortDescription = 'Edits a virtual file using a single insert/delete/replace operation per call.';
+    static longDescription = `
+    A utility tool for agentic coding loops. Applies a single edit to a virtual file and
+    returns the updated file content and a rendered numbered view for the prompt.
+    The current file content is maintained in the tool's internal state.
+    Only one edit operation is allowed per call.
+
+    OPERATION TYPES:
+    
+    1. INSERT: Adds new lines BEFORE the specified startLine
+       Example: { "op": "insert", "startLine": 5, "text": "const x = 1;" }
+       - This adds the new line BEFORE line 5, pushing existing line 5 to line 6
+    
+    2. DELETE: Removes lines from startLine to endLine (inclusive)
+       Example: { "op": "delete", "startLine": 3, "endLine": 5 }
+       - This removes lines 3, 4, and 5
+       - For single line: { "op": "delete", "startLine": 3 } (endLine defaults to startLine)
+       - DO NOT include 'text' parameter for delete operations
+    
+    3. REPLACE: Replaces lines from startLine to endLine with new text
+       Example: { "op": "replace", "startLine": 2, "endLine": 4, "text": "new content\\nline 2" }
+       - This replaces lines 2, 3, and 4 with the new text
+       - For single line: { "op": "replace", "startLine": 2, "text": "new content" }
+       - For multi-line replacement, ALWAYS specify both startLine AND endLine
+    
+    CRITICAL RULES:
+    - Line numbers are 1-based (first line is 1, not 0)
+    - For multi-line operations, ALWAYS specify both startLine AND endLine
+    - For delete operations, NEVER include the 'text' parameter
+    - Use \\n in text to create multiple lines
+    - Each call can only perform ONE operation
+  `;
+    static alias = 'vfe';
+    constructor(params, context) {
+        super(params, context);
+    }
+    async performAction(context) {
+        void context; // Context available but not currently used
+        try {
+            // Get codeLines from config (injected at runtime)
+            const codeLines = this.params.config?.codeLines || [];
+            console.log('[VirtualFileEditorTool] PARAMS DEBUG:', {
+                'this.params.edit': this.params.edit,
+                'this.params.config': this.params.config
+                    ? {
+                        hasCodeLines: !!this.params.config.codeLines,
+                        codeLinesLength: this.params.config.codeLines
+                            ?.length,
+                        isArray: Array.isArray(this.params.config.codeLines),
+                    }
+                    : 'NO CONFIG',
+            });
+            console.log('[VirtualFileEditorTool] INPUT:', {
+                operation: this.params.edit.op,
+                startLine: this.params.edit.startLine,
+                endLine: this.params.edit.endLine,
+                inputLines: codeLines.length,
+            });
+            // If no codeLines in config, initialize with empty array
+            if (codeLines.length === 0) {
+                console.log('[VirtualFileEditorTool] No existing codeLines in config, starting with empty file');
+            }
+            const updated = applyEdit(codeLines, this.params.edit);
+            console.log('[VirtualFileEditorTool] OUTPUT:', {
+                outputLines: updated.length,
+                changed: updated.length !== codeLines.length,
+            });
+            // Return the updated file - the workflow's afterToolCall will update the shared state
+            return {
+                updatedCodeLines: updated,
+                success: true,
+                error: '',
+            };
+        }
+        catch (e) {
+            // Fallback to empty file on error
+            const fallbackCodeLines = [];
+            return {
+                updatedCodeLines: fallbackCodeLines,
+                success: false,
+                error: e instanceof Error ? e.message : 'Unknown error',
+            };
+        }
+    }
+}
+//# sourceMappingURL=virtual-file-editor.tool.js.map

package/dist/bubbles/tool-bubble/virtual-file-editor.tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"virtual-file-editor.tool.js","sourceRoot":"","sources":["../../../src/bubbles/tool-bubble/virtual-file-editor.tool.ts"],"names":[],"mappings":"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"}

package/dist/bubbles/tool-bubble/web-crawl-tool.d.ts

@@ -0,0 +1,218 @@
+import { z } from 'zod';
+import { ToolBubble } from '../../types/tool-bubble-class.js';
+import type { BubbleContext } from '../../types/bubble.js';
+import { CredentialType, type BubbleName } from '@bubblelab/shared-schemas';
+declare const WebCrawlToolParamsSchema: z.ZodObject<{
+    url: z.ZodString;
+    format: z.ZodDefault<z.ZodEnum<["markdown"]>>;
+    onlyMainContent: z.ZodDefault<z.ZodBoolean>;
+    maxPages: z.ZodOptional<z.ZodDefault<z.ZodNumber>>;
+    crawlDepth: z.ZodOptional<z.ZodDefault<z.ZodNumber>>;
+    includePaths: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    excludePaths: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    waitFor: z.ZodDefault<z.ZodNumber>;
+    credentials: z.ZodOptional<z.ZodRecord<z.ZodNativeEnum<typeof CredentialType>, z.ZodString>>;
+}, "strip", z.ZodTypeAny, {
+    format: "markdown";
+    url: string;
+    onlyMainContent: boolean;
+    waitFor: number;
+    credentials?: Partial<Record<CredentialType, string>> | undefined;
+    maxPages?: number | undefined;
+    crawlDepth?: number | undefined;
+    includePaths?: string[] | undefined;
+    excludePaths?: string[] | undefined;
+}, {
+    url: string;
+    format?: "markdown" | undefined;
+    credentials?: Partial<Record<CredentialType, string>> | undefined;
+    onlyMainContent?: boolean | undefined;
+    maxPages?: number | undefined;
+    crawlDepth?: number | undefined;
+    includePaths?: string[] | undefined;
+    excludePaths?: string[] | undefined;
+    waitFor?: number | undefined;
+}>;
+declare const WebCrawlToolResultSchema: z.ZodObject<{
+    url: z.ZodString;
+    success: z.ZodBoolean;
+    error: z.ZodString;
+    pages: z.ZodArray<z.ZodObject<{
+        url: z.ZodString;
+        title: z.ZodOptional<z.ZodString>;
+        content: z.ZodString;
+        depth: z.ZodOptional<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        content: string;
+        url: string;
+        title?: string | undefined;
+        depth?: number | undefined;
+    }, {
+        content: string;
+        url: string;
+        title?: string | undefined;
+        depth?: number | undefined;
+    }>, "many">;
+    totalPages: z.ZodNumber;
+    metadata: z.ZodOptional<z.ZodObject<{
+        loadTime: z.ZodOptional<z.ZodNumber>;
+        crawlDepth: z.ZodOptional<z.ZodNumber>;
+        maxPagesReached: z.ZodOptional<z.ZodBoolean>;
+    }, "strip", z.ZodTypeAny, {
+        crawlDepth?: number | undefined;
+        loadTime?: number | undefined;
+        maxPagesReached?: boolean | undefined;
+    }, {
+        crawlDepth?: number | undefined;
+        loadTime?: number | undefined;
+        maxPagesReached?: boolean | undefined;
+    }>>;
+}, "strip", z.ZodTypeAny, {
+    success: boolean;
+    error: string;
+    url: string;
+    pages: {
+        content: string;
+        url: string;
+        title?: string | undefined;
+        depth?: number | undefined;
+    }[];
+    totalPages: number;
+    metadata?: {
+        crawlDepth?: number | undefined;
+        loadTime?: number | undefined;
+        maxPagesReached?: boolean | undefined;
+    } | undefined;
+}, {
+    success: boolean;
+    error: string;
+    url: string;
+    pages: {
+        content: string;
+        url: string;
+        title?: string | undefined;
+        depth?: number | undefined;
+    }[];
+    totalPages: number;
+    metadata?: {
+        crawlDepth?: number | undefined;
+        loadTime?: number | undefined;
+        maxPagesReached?: boolean | undefined;
+    } | undefined;
+}>;
+type WebCrawlToolParams = z.input<typeof WebCrawlToolParamsSchema>;
+type WebCrawlToolResult = z.output<typeof WebCrawlToolResultSchema>;
+type WebCrawlToolParamsInput = z.input<typeof WebCrawlToolParamsSchema>;
+export declare class WebCrawlTool extends ToolBubble<WebCrawlToolParams, WebCrawlToolResult> {
+    static readonly bubbleName: BubbleName;
+    static readonly schema: z.ZodObject<{
+        url: z.ZodString;
+        format: z.ZodDefault<z.ZodEnum<["markdown"]>>;
+        onlyMainContent: z.ZodDefault<z.ZodBoolean>;
+        maxPages: z.ZodOptional<z.ZodDefault<z.ZodNumber>>;
+        crawlDepth: z.ZodOptional<z.ZodDefault<z.ZodNumber>>;
+        includePaths: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        excludePaths: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        waitFor: z.ZodDefault<z.ZodNumber>;
+        credentials: z.ZodOptional<z.ZodRecord<z.ZodNativeEnum<typeof CredentialType>, z.ZodString>>;
+    }, "strip", z.ZodTypeAny, {
+        format: "markdown";
+        url: string;
+        onlyMainContent: boolean;
+        waitFor: number;
+        credentials?: Partial<Record<CredentialType, string>> | undefined;
+        maxPages?: number | undefined;
+        crawlDepth?: number | undefined;
+        includePaths?: string[] | undefined;
+        excludePaths?: string[] | undefined;
+    }, {
+        url: string;
+        format?: "markdown" | undefined;
+        credentials?: Partial<Record<CredentialType, string>> | undefined;
+        onlyMainContent?: boolean | undefined;
+        maxPages?: number | undefined;
+        crawlDepth?: number | undefined;
+        includePaths?: string[] | undefined;
+        excludePaths?: string[] | undefined;
+        waitFor?: number | undefined;
+    }>;
+    static readonly resultSchema: z.ZodObject<{
+        url: z.ZodString;
+        success: z.ZodBoolean;
+        error: z.ZodString;
+        pages: z.ZodArray<z.ZodObject<{
+            url: z.ZodString;
+            title: z.ZodOptional<z.ZodString>;
+            content: z.ZodString;
+            depth: z.ZodOptional<z.ZodNumber>;
+        }, "strip", z.ZodTypeAny, {
+            content: string;
+            url: string;
+            title?: string | undefined;
+            depth?: number | undefined;
+        }, {
+            content: string;
+            url: string;
+            title?: string | undefined;
+            depth?: number | undefined;
+        }>, "many">;
+        totalPages: z.ZodNumber;
+        metadata: z.ZodOptional<z.ZodObject<{
+            loadTime: z.ZodOptional<z.ZodNumber>;
+            crawlDepth: z.ZodOptional<z.ZodNumber>;
+            maxPagesReached: z.ZodOptional<z.ZodBoolean>;
+        }, "strip", z.ZodTypeAny, {
+            crawlDepth?: number | undefined;
+            loadTime?: number | undefined;
+            maxPagesReached?: boolean | undefined;
+        }, {
+            crawlDepth?: number | undefined;
+            loadTime?: number | undefined;
+            maxPagesReached?: boolean | undefined;
+        }>>;
+    }, "strip", z.ZodTypeAny, {
+        success: boolean;
+        error: string;
+        url: string;
+        pages: {
+            content: string;
+            url: string;
+            title?: string | undefined;
+            depth?: number | undefined;
+        }[];
+        totalPages: number;
+        metadata?: {
+            crawlDepth?: number | undefined;
+            loadTime?: number | undefined;
+            maxPagesReached?: boolean | undefined;
+        } | undefined;
+    }, {
+        success: boolean;
+        error: string;
+        url: string;
+        pages: {
+            content: string;
+            url: string;
+            title?: string | undefined;
+            depth?: number | undefined;
+        }[];
+        totalPages: number;
+        metadata?: {
+            crawlDepth?: number | undefined;
+            loadTime?: number | undefined;
+            maxPagesReached?: boolean | undefined;
+        } | undefined;
+    }>;
+    static readonly shortDescription = "Multi-page web crawling tool for exploring entire websites and subdomains.";
+    static readonly longDescription = "\n    A powerful web crawling tool that can systematically explore websites and extract content from multiple pages.\n    \n    \uD83D\uDD77\uFE0F CRAWL Features:\n    - Recursively crawl websites and subdomains\n    - Configurable crawl depth and page limits (up to 100 pages)\n    - URL pattern filtering (include/exclude paths)\n    - Multiple format support (markdown, html, links, rawHtml)\n    - Main content focus filtering\n    - Discover and extract content from entire sites\n    \n    Technical Features:\n    - Handles JavaScript-rendered pages and dynamic content\n    - Robust error handling and retry mechanisms\n    - Configurable wait times for dynamic content\n    - Requires FIRECRAWL_API_KEY credential\n    \n    Use Cases:\n    - Site mapping and competitive analysis\n    - Documentation aggregation across multiple pages  \n    - Content analysis and research across domains\n    - SEO analysis and site structure discovery\n    - Building comprehensive datasets from websites\n  ";
+    static readonly alias = "crawl";
+    static readonly type = "tool";
+    constructor(params?: WebCrawlToolParamsInput, context?: BubbleContext);
+    performAction(context?: BubbleContext): Promise<WebCrawlToolResult>;
+    /**
+     * Execute crawl operation - multi-page site exploration
+     */
+    private executeCrawl;
+}
+export {};
+//# sourceMappingURL=web-crawl-tool.d.ts.map

package/dist/bubbles/tool-bubble/web-crawl-tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"web-crawl-tool.d.ts","sourceRoot":"","sources":["../../../src/bubbles/tool-bubble/web-crawl-tool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,UAAU,EAAE,MAAM,kCAAkC,CAAC;AAC9D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAE3D,OAAO,EAAE,cAAc,EAAE,KAAK,UAAU,EAAE,MAAM,2BAA2B,CAAC;AAI5E,QAAA,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAqD5B,CAAC;AAGH,QAAA,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA2B5B,CAAC;AAGH,KAAK,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AACnE,KAAK,kBAAkB,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,wBAAwB,CAAC,CAAC;AACpE,KAAK,uBAAuB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAExE,qBAAa,YAAa,SAAQ,UAAU,CAC1C,kBAAkB,EAClB,kBAAkB,CACnB;IAEC,MAAM,CAAC,QAAQ,CAAC,UAAU,EAAE,UAAU,CAAoB;IAC1D,MAAM,CAAC,QAAQ,CAAC,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAA4B;IAClD,MAAM,CAAC,QAAQ,CAAC,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAA4B;IACxD,MAAM,CAAC,QAAQ,CAAC,gBAAgB,gFAC+C;IAC/E,MAAM,CAAC,QAAQ,CAAC,eAAe,k/BAuB7B;IACF,MAAM,CAAC,QAAQ,CAAC,KAAK,WAAW;IAChC,MAAM,CAAC,QAAQ,CAAC,IAAI,UAAU;gBAG5B,MAAM,GAAE,uBAAqC,EAC7C,OAAO,CAAC,EAAE,aAAa;IAKnB,aAAa,CAAC,OAAO,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAqHzE;;OAEG;YACW,YAAY;CAgF3B"}