seclaw-agent 0.1.0

package/dist/agent/tools/shell.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Shell execution tool
+ */
+import { Tool } from "./base";
+import type { DockerSandbox } from "../docker_sandbox";
+export declare class ExecTool extends Tool {
+    private timeout;
+    private workingDir;
+    private denyPatterns;
+    private allowPatterns;
+    private restrictToWorkspace;
+    private dockerSandbox;
+    constructor(opts?: {
+        timeout?: number;
+        workingDir?: string | null;
+        denyPatterns?: RegExp[] | null;
+        allowPatterns?: RegExp[] | null;
+        restrictToWorkspace?: boolean;
+        dockerSandbox?: DockerSandbox | null;
+    });
+    get name(): string;
+    get description(): string;
+    get parameters(): {
+        type: "object";
+        properties: {
+            command: {
+                type: "string";
+                description: string;
+            };
+            working_dir: {
+                type: "string";
+                description: string;
+            };
+        };
+        required: string[];
+    };
+    execute(params: Record<string, unknown>): Promise<string>;
+    private _guardCommand;
+}
+//# sourceMappingURL=shell.d.ts.map

package/dist/agent/tools/shell.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shell.d.ts","sourceRoot":"","sources":["../../../src/agent/tools/shell.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,OAAO,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAC9B,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAqBvD,qBAAa,QAAS,SAAQ,IAAI;IAChC,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,UAAU,CAAgB;IAClC,OAAO,CAAC,YAAY,CAAW;IAC/B,OAAO,CAAC,aAAa,CAAW;IAChC,OAAO,CAAC,mBAAmB,CAAU;IACrC,OAAO,CAAC,aAAa,CAAuB;gBAEhC,IAAI,GAAE;QAChB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QAC3B,YAAY,CAAC,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;QAC/B,aAAa,CAAC,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;QAChC,mBAAmB,CAAC,EAAE,OAAO,CAAC;QAC9B,aAAa,CAAC,EAAE,aAAa,GAAG,IAAI,CAAC;KACjC;IAYN,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,IAAI,WAAW,IAAI,MAAM,CAExB;IAED,IAAI,UAAU;;;;;;;;;;;;;MAYb;IAEK,OAAO,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC;IAqD/D,OAAO,CAAC,aAAa;CAuBtB"}

package/dist/agent/tools/shell.js

@@ -0,0 +1,166 @@
+"use strict";
+/**
+ * Shell execution tool
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ExecTool = void 0;
+const child_process = __importStar(require("child_process"));
+const base_1 = require("./base");
+const DENY_PATTERNS_SANDBOX = [
+    /\b(format|mkfs|diskpart)\b/i,
+    /\bdd\s+if=/i,
+    />\s*\/dev\/sd/,
+    /\b(shutdown|reboot|poweroff)\b/i,
+    /:\(\)\s*\{.*\};\s*:/,
+];
+const DENY_PATTERNS_HOST = [
+    /\brm\s+-[rf]{1,2}\b/i,
+    /\bdel\s+\/[fq]\b/i,
+    /\brmdir\s+\/s\b/i,
+    /\b(format|mkfs|diskpart)\b/i,
+    /\bdd\s+if=/i,
+    />\s*\/dev\/sd/,
+    /\b(shutdown|reboot|poweroff)\b/i,
+    /:\(\)\s*\{.*\};\s*:/,
+];
+class ExecTool extends base_1.Tool {
+    timeout;
+    workingDir;
+    denyPatterns;
+    allowPatterns;
+    restrictToWorkspace;
+    dockerSandbox;
+    constructor(opts = {}) {
+        super();
+        this.timeout = opts.timeout ?? 60;
+        this.workingDir = opts.workingDir ?? null;
+        this.dockerSandbox = opts.dockerSandbox ?? null;
+        this.denyPatterns =
+            opts.denyPatterns ??
+                (this.dockerSandbox?.isRunning ? DENY_PATTERNS_SANDBOX : DENY_PATTERNS_HOST);
+        this.allowPatterns = opts.allowPatterns ?? [];
+        this.restrictToWorkspace = opts.restrictToWorkspace ?? false;
+    }
+    get name() {
+        return "exec";
+    }
+    get description() {
+        return "Execute a shell command and return its output. Use with caution.";
+    }
+    get parameters() {
+        return {
+            type: "object",
+            properties: {
+                command: { type: "string", description: "The shell command to execute" },
+                working_dir: {
+                    type: "string",
+                    description: "Optional working directory for the command",
+                },
+            },
+            required: ["command"],
+        };
+    }
+    async execute(params) {
+        const command = params["command"];
+        const workingDir = params["working_dir"] ?? this.workingDir ?? process.cwd();
+        const guardError = this._guardCommand(command, workingDir);
+        if (guardError)
+            return guardError;
+        if (this.dockerSandbox?.isRunning) {
+            try {
+                const [stdout, stderr, code] = await this.dockerSandbox.exec(command, workingDir, this.timeout);
+                const parts = [];
+                if (stdout)
+                    parts.push(stdout);
+                if (stderr.trim())
+                    parts.push(`STDERR:\n${stderr}`);
+                if (code !== 0)
+                    parts.push(`\nExit code: ${code}`);
+                const result = parts.join("\n") || "(no output)";
+                return result.length > 10000
+                    ? result.slice(0, 10000) + `\n... (truncated, ${result.length - 10000} more chars)`
+                    : result;
+            }
+            catch (e) {
+                return `Error executing command in sandbox: ${e}`;
+            }
+        }
+        return new Promise((resolve) => {
+            const timer = setTimeout(() => {
+                resolve(`Error: Command timed out after ${this.timeout} seconds`);
+            }, this.timeout * 1000);
+            const proc = child_process.exec(command, { cwd: workingDir, timeout: this.timeout * 1000 }, (error, stdout, stderr) => {
+                clearTimeout(timer);
+                const parts = [];
+                if (stdout)
+                    parts.push(stdout);
+                if (stderr?.trim())
+                    parts.push(`STDERR:\n${stderr}`);
+                if (error?.code)
+                    parts.push(`\nExit code: ${error.code}`);
+                const result = parts.join("\n") || "(no output)";
+                resolve(result.length > 10000
+                    ? result.slice(0, 10000) + `\n... (truncated, ${result.length - 10000} more chars)`
+                    : result);
+            });
+            proc.on("error", (e) => {
+                clearTimeout(timer);
+                resolve(`Error executing command: ${e.message}`);
+            });
+        });
+    }
+    _guardCommand(command, cwd) {
+        const lower = command.toLowerCase();
+        for (const pattern of this.denyPatterns) {
+            if (pattern.test(lower)) {
+                return "Error: Command blocked by safety guard (dangerous pattern detected)";
+            }
+        }
+        if (this.allowPatterns.length > 0) {
+            if (!this.allowPatterns.some((p) => p.test(lower))) {
+                return "Error: Command blocked by safety guard (not in allowlist)";
+            }
+        }
+        if (this.restrictToWorkspace) {
+            if (command.includes("../") || command.includes("..\\")) {
+                return "Error: Command blocked by safety guard (path traversal detected)";
+            }
+        }
+        return null;
+    }
+}
+exports.ExecTool = ExecTool;
+//# sourceMappingURL=shell.js.map

package/dist/agent/tools/shell.js.map

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

package/dist/agent/tools/spawn.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Spawn tool
+ */
+import { Tool } from "./base";
+import type { SubagentManager } from "../subagent";
+export declare class SpawnTool extends Tool {
+    private manager;
+    private originChannel;
+    private originChatId;
+    constructor(manager: SubagentManager);
+    setContext(channel: string, chatId: string): void;
+    get name(): string;
+    get description(): string;
+    get parameters(): {
+        type: "object";
+        properties: {
+            task: {
+                type: "string";
+                description: string;
+            };
+            label: {
+                type: "string";
+                description: string;
+            };
+        };
+        required: string[];
+    };
+    execute(params: Record<string, unknown>): Promise<string>;
+}
+//# sourceMappingURL=spawn.d.ts.map

package/dist/agent/tools/spawn.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spawn.d.ts","sourceRoot":"","sources":["../../../src/agent/tools/spawn.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAC9B,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAEnD,qBAAa,SAAU,SAAQ,IAAI;IACjC,OAAO,CAAC,OAAO,CAAkB;IACjC,OAAO,CAAC,aAAa,CAAS;IAC9B,OAAO,CAAC,YAAY,CAAS;gBAEjB,OAAO,EAAE,eAAe;IAOpC,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI;IAKjD,IAAI,IAAI,IAAI,MAAM,CAAoB;IACtC,IAAI,WAAW,IAAI,MAAM,CAMxB;IACD,IAAI,UAAU;;;;;;;;;;;;;MASb;IAEK,OAAO,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC;CAUhE"}

package/dist/agent/tools/spawn.js

@@ -0,0 +1,50 @@
+"use strict";
+/**
+ * Spawn tool
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SpawnTool = void 0;
+const base_1 = require("./base");
+class SpawnTool extends base_1.Tool {
+    manager;
+    originChannel;
+    originChatId;
+    constructor(manager) {
+        super();
+        this.manager = manager;
+        this.originChannel = "cli";
+        this.originChatId = "direct";
+    }
+    setContext(channel, chatId) {
+        this.originChannel = channel;
+        this.originChatId = chatId;
+    }
+    get name() { return "spawn"; }
+    get description() {
+        return ("Spawn a subagent to handle a task in the background. " +
+            "Use this for complex or time-consuming tasks that can run independently. " +
+            "The subagent will complete the task and report back when done.");
+    }
+    get parameters() {
+        return {
+            type: "object",
+            properties: {
+                task: { type: "string", description: "The task for the subagent to complete" },
+                label: { type: "string", description: "Optional short label for the task (for display)" },
+            },
+            required: ["task"],
+        };
+    }
+    async execute(params) {
+        const task = params["task"];
+        const label = params["label"];
+        return this.manager.spawn({
+            task,
+            label,
+            originChannel: this.originChannel,
+            originChatId: this.originChatId,
+        });
+    }
+}
+exports.SpawnTool = SpawnTool;
+//# sourceMappingURL=spawn.js.map

package/dist/agent/tools/spawn.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"spawn.js","sourceRoot":"","sources":["../../../src/agent/tools/spawn.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AAEH,iCAA8B;AAG9B,MAAa,SAAU,SAAQ,WAAI;IACzB,OAAO,CAAkB;IACzB,aAAa,CAAS;IACtB,YAAY,CAAS;IAE7B,YAAY,OAAwB;QAClC,KAAK,EAAE,CAAC;QACR,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,IAAI,CAAC,aAAa,GAAG,KAAK,CAAC;QAC3B,IAAI,CAAC,YAAY,GAAG,QAAQ,CAAC;IAC/B,CAAC;IAED,UAAU,CAAC,OAAe,EAAE,MAAc;QACxC,IAAI,CAAC,aAAa,GAAG,OAAO,CAAC;QAC7B,IAAI,CAAC,YAAY,GAAG,MAAM,CAAC;IAC7B,CAAC;IAED,IAAI,IAAI,KAAa,OAAO,OAAO,CAAC,CAAC,CAAC;IACtC,IAAI,WAAW;QACb,OAAO,CACL,uDAAuD;YACvD,2EAA2E;YAC3E,gEAAgE,CACjE,CAAC;IACJ,CAAC;IACD,IAAI,UAAU;QACZ,OAAO;YACL,IAAI,EAAE,QAAiB;YACvB,UAAU,EAAE;gBACV,IAAI,EAAE,EAAE,IAAI,EAAE,QAAiB,EAAE,WAAW,EAAE,uCAAuC,EAAE;gBACvF,KAAK,EAAE,EAAE,IAAI,EAAE,QAAiB,EAAE,WAAW,EAAE,iDAAiD,EAAE;aACnG;YACD,QAAQ,EAAE,CAAC,MAAM,CAAC;SACnB,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,MAA+B;QAC3C,MAAM,IAAI,GAAG,MAAM,CAAC,MAAM,CAAW,CAAC;QACtC,MAAM,KAAK,GAAG,MAAM,CAAC,OAAO,CAAuB,CAAC;QACpD,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC;YACxB,IAAI;YACJ,KAAK;YACL,aAAa,EAAE,IAAI,CAAC,aAAa;YACjC,YAAY,EAAE,IAAI,CAAC,YAAY;SAChC,CAAC,CAAC;IACL,CAAC;CACF;AA9CD,8BA8CC"}

package/dist/agent/tools/web.d.ts

@@ -0,0 +1,59 @@
+/**
+ * Web tools
+ */
+import { Tool } from "./base";
+export declare class WebSearchTool extends Tool {
+    private apiKey;
+    private maxResults;
+    constructor(opts?: {
+        apiKey?: string | null;
+        maxResults?: number;
+    });
+    get name(): string;
+    get description(): string;
+    get parameters(): {
+        type: "object";
+        properties: {
+            query: {
+                type: "string";
+                description: string;
+            };
+            count: {
+                type: "integer";
+                description: string;
+                minimum: number;
+                maximum: number;
+            };
+        };
+        required: string[];
+    };
+    execute(params: Record<string, unknown>): Promise<string>;
+}
+export declare class WebFetchTool extends Tool {
+    private maxChars;
+    constructor(maxChars?: number);
+    get name(): string;
+    get description(): string;
+    get parameters(): {
+        type: "object";
+        properties: {
+            url: {
+                type: "string";
+                description: string;
+            };
+            extractMode: {
+                type: "string";
+                enum: string[];
+                description: string;
+            };
+            maxChars: {
+                type: "integer";
+                minimum: number;
+            };
+        };
+        required: string[];
+    };
+    execute(params: Record<string, unknown>): Promise<string>;
+    private _htmlToText;
+}
+//# sourceMappingURL=web.d.ts.map

package/dist/agent/tools/web.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"web.d.ts","sourceRoot":"","sources":["../../../src/agent/tools/web.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AA8B9B,qBAAa,aAAc,SAAQ,IAAI;IACrC,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,UAAU,CAAS;gBAEf,IAAI,GAAE;QAAE,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAA;KAAO;IAMtE,IAAI,IAAI,IAAI,MAAM,CAAyB;IAC3C,IAAI,WAAW,IAAI,MAAM,CAAkE;IAC3F,IAAI,UAAU;;;;;;;;;;;;;;;MASb;IAEK,OAAO,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC;CA2BhE;AAED,qBAAa,YAAa,SAAQ,IAAI;IACpC,OAAO,CAAC,QAAQ,CAAS;gBAEb,QAAQ,SAAQ;IAK5B,IAAI,IAAI,IAAI,MAAM,CAAwB;IAC1C,IAAI,WAAW,IAAI,MAAM,CAAoE;IAC7F,IAAI,UAAU;;;;;;;;;;;;;;;;;;MAUb;IAEK,OAAO,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC;IAkD/D,OAAO,CAAC,WAAW;CAYpB"}

package/dist/agent/tools/web.js

@@ -0,0 +1,167 @@
+"use strict";
+/**
+ * Web tools
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WebFetchTool = exports.WebSearchTool = void 0;
+const axios_1 = __importDefault(require("axios"));
+const base_1 = require("./base");
+const USER_AGENT = "Mozilla/5.0 (Macintosh; Intel Mac OS X 14_7_2) AppleWebKit/537.36";
+function stripTags(text) {
+    text = text.replace(/<script[\s\S]*?<\/script>/gi, "");
+    text = text.replace(/<style[\s\S]*?<\/style>/gi, "");
+    text = text.replace(/<[^>]+>/g, "");
+    return text.replace(/&amp;/g, "&").replace(/&lt;/g, "<").replace(/&gt;/g, ">").replace(/&quot;/g, '"').replace(/&#39;/g, "'").trim();
+}
+function normalize(text) {
+    text = text.replace(/[ \t]+/g, " ");
+    text = text.replace(/\n{3,}/g, "\n\n");
+    return text.trim();
+}
+function validateUrl(url) {
+    try {
+        const p = new URL(url);
+        if (!["http:", "https:"].includes(p.protocol)) {
+            return [false, `Only http/https allowed, got '${p.protocol}'`];
+        }
+        if (!p.hostname)
+            return [false, "Missing domain"];
+        return [true, ""];
+    }
+    catch (e) {
+        return [false, String(e)];
+    }
+}
+class WebSearchTool extends base_1.Tool {
+    apiKey;
+    maxResults;
+    constructor(opts = {}) {
+        super();
+        this.apiKey = opts.apiKey ?? process.env.BRAVE_API_KEY ?? "";
+        this.maxResults = opts.maxResults ?? 5;
+    }
+    get name() { return "web_search"; }
+    get description() { return "Search the web. Returns titles, URLs, and snippets."; }
+    get parameters() {
+        return {
+            type: "object",
+            properties: {
+                query: { type: "string", description: "Search query" },
+                count: { type: "integer", description: "Results (1-10)", minimum: 1, maximum: 10 },
+            },
+            required: ["query"],
+        };
+    }
+    async execute(params) {
+        const query = params["query"];
+        const count = Math.min(Math.max(params["count"] ?? this.maxResults, 1), 10);
+        if (!this.apiKey)
+            return "Error: BRAVE_API_KEY not configured";
+        try {
+            const resp = await axios_1.default.get("https://api.search.brave.com/res/v1/web/search", {
+                params: { q: query, count },
+                headers: { Accept: "application/json", "X-Subscription-Token": this.apiKey },
+                timeout: 10000,
+            });
+            const results = (resp.data?.web?.results ?? []);
+            if (!results.length)
+                return `No results for: ${query}`;
+            const lines = [`Results for: ${query}\n`];
+            for (let i = 0; i < Math.min(results.length, count); i++) {
+                const item = results[i];
+                lines.push(`${i + 1}. ${item["title"] ?? ""}\n   ${item["url"] ?? ""}`);
+                if (item["description"])
+                    lines.push(`   ${item["description"]}`);
+            }
+            return lines.join("\n");
+        }
+        catch (e) {
+            return `Error: ${e}`;
+        }
+    }
+}
+exports.WebSearchTool = WebSearchTool;
+class WebFetchTool extends base_1.Tool {
+    maxChars;
+    constructor(maxChars = 50000) {
+        super();
+        this.maxChars = maxChars;
+    }
+    get name() { return "web_fetch"; }
+    get description() { return "Fetch URL and extract readable content (HTML → text)."; }
+    get parameters() {
+        return {
+            type: "object",
+            properties: {
+                url: { type: "string", description: "URL to fetch" },
+                extractMode: { type: "string", enum: ["markdown", "text"], description: "Extraction mode" },
+                maxChars: { type: "integer", minimum: 100 },
+            },
+            required: ["url"],
+        };
+    }
+    async execute(params) {
+        const url = params["url"];
+        const maxChars = params["maxChars"] ?? this.maxChars;
+        const [valid, errMsg] = validateUrl(url);
+        if (!valid) {
+            return JSON.stringify({ error: `URL validation failed: ${errMsg}`, url });
+        }
+        try {
+            const resp = await axios_1.default.get(url, {
+                headers: { "User-Agent": USER_AGENT },
+                timeout: 30000,
+                maxRedirects: 5,
+                responseType: "text",
+                validateStatus: null,
+            });
+            const contentType = resp.headers["content-type"] ?? "";
+            let text;
+            let extractor;
+            if (contentType.includes("application/json")) {
+                text = JSON.stringify(resp.data, null, 2);
+                extractor = "json";
+            }
+            else if (contentType.includes("text/html") || resp.data.slice(0, 256).toLowerCase().startsWith("<!doctype")) {
+                text = this._htmlToText(resp.data);
+                extractor = "html-strip";
+            }
+            else {
+                text = resp.data;
+                extractor = "raw";
+            }
+            const truncated = text.length > maxChars;
+            if (truncated)
+                text = text.slice(0, maxChars);
+            return JSON.stringify({
+                url,
+                finalUrl: resp.request?.res?.responseUrl ?? url,
+                status: resp.status,
+                extractor,
+                truncated,
+                length: text.length,
+                text,
+            });
+        }
+        catch (e) {
+            return JSON.stringify({ error: String(e), url });
+        }
+    }
+    _htmlToText(html) {
+        // Simple HTML-to-text conversion
+        let text = html;
+        // Remove script and style
+        text = text.replace(/<script[\s\S]*?<\/script>/gi, "");
+        text = text.replace(/<style[\s\S]*?<\/style>/gi, "");
+        // Replace block elements with newlines
+        text = text.replace(/<\/?(p|div|section|article|h[1-6]|li|br|hr)[^>]*>/gi, "\n");
+        // Strip remaining tags
+        text = stripTags(text);
+        return normalize(text);
+    }
+}
+exports.WebFetchTool = WebFetchTool;
+//# sourceMappingURL=web.js.map

package/dist/agent/tools/web.js.map

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

package/dist/bus/events.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Event types for the message bus
+ */
+export interface InboundMessage {
+    /** telegram, discord, slack, whatsapp, etc. */
+    channel: string;
+    /** User identifier */
+    senderId: string;
+    /** Chat/channel identifier */
+    chatId: string;
+    /** Message text */
+    content: string;
+    timestamp: Date;
+    /** Media URLs */
+    media: string[];
+    /** Channel-specific data */
+    metadata: Record<string, unknown>;
+}
+export declare function makeInboundMessage(opts: Omit<InboundMessage, "timestamp" | "media" | "metadata"> & Partial<Pick<InboundMessage, "timestamp" | "media" | "metadata">>): InboundMessage;
+/** Unique key for session identification */
+export declare function sessionKey(msg: InboundMessage): string;
+export interface OutboundMessage {
+    channel: string;
+    chatId: string;
+    content: string;
+    replyTo?: string;
+    media: string[];
+    metadata: Record<string, unknown>;
+}
+export declare function makeOutboundMessage(opts: Omit<OutboundMessage, "media" | "metadata"> & Partial<Pick<OutboundMessage, "media" | "metadata">>): OutboundMessage;
+//# sourceMappingURL=events.d.ts.map

package/dist/bus/events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../../src/bus/events.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,WAAW,cAAc;IAC7B,+CAA+C;IAC/C,OAAO,EAAE,MAAM,CAAC;IAChB,sBAAsB;IACtB,QAAQ,EAAE,MAAM,CAAC;IACjB,8BAA8B;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,mBAAmB;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,IAAI,CAAC;IAChB,iBAAiB;IACjB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,4BAA4B;IAC5B,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC;AAED,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,IAAI,CAAC,cAAc,EAAE,WAAW,GAAG,OAAO,GAAG,UAAU,CAAC,GAC5D,OAAO,CAAC,IAAI,CAAC,cAAc,EAAE,WAAW,GAAG,OAAO,GAAG,UAAU,CAAC,CAAC,GAClE,cAAc,CAOhB;AAED,4CAA4C;AAC5C,wBAAgB,UAAU,CAAC,GAAG,EAAE,cAAc,GAAG,MAAM,CAEtD;AAED,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC;AAED,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,IAAI,CAAC,eAAe,EAAE,OAAO,GAAG,UAAU,CAAC,GAC/C,OAAO,CAAC,IAAI,CAAC,eAAe,EAAE,OAAO,GAAG,UAAU,CAAC,CAAC,GACrD,eAAe,CAMjB"}

package/dist/bus/events.js

@@ -0,0 +1,28 @@
+"use strict";
+/**
+ * Event types for the message bus
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.makeInboundMessage = makeInboundMessage;
+exports.sessionKey = sessionKey;
+exports.makeOutboundMessage = makeOutboundMessage;
+function makeInboundMessage(opts) {
+    return {
+        timestamp: new Date(),
+        media: [],
+        metadata: {},
+        ...opts,
+    };
+}
+/** Unique key for session identification */
+function sessionKey(msg) {
+    return `${msg.channel}:${msg.chatId}`;
+}
+function makeOutboundMessage(opts) {
+    return {
+        media: [],
+        metadata: {},
+        ...opts,
+    };
+}
+//# sourceMappingURL=events.js.map

package/dist/bus/events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.js","sourceRoot":"","sources":["../../src/bus/events.ts"],"names":[],"mappings":";AAAA;;GAEG;;AAkBH,gDAUC;AAGD,gCAEC;AAWD,kDASC;AAnCD,SAAgB,kBAAkB,CAChC,IACmE;IAEnE,OAAO;QACL,SAAS,EAAE,IAAI,IAAI,EAAE;QACrB,KAAK,EAAE,EAAE;QACT,QAAQ,EAAE,EAAE;QACZ,GAAG,IAAI;KACR,CAAC;AACJ,CAAC;AAED,4CAA4C;AAC5C,SAAgB,UAAU,CAAC,GAAmB;IAC5C,OAAO,GAAG,GAAG,CAAC,OAAO,IAAI,GAAG,CAAC,MAAM,EAAE,CAAC;AACxC,CAAC;AAWD,SAAgB,mBAAmB,CACjC,IACsD;IAEtD,OAAO;QACL,KAAK,EAAE,EAAE;QACT,QAAQ,EAAE,EAAE;QACZ,GAAG,IAAI;KACR,CAAC;AACJ,CAAC"}

package/dist/bus/queue.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Async message queue
+ */
+import { InboundMessage, OutboundMessage } from "./events";
+type OutboundHandler = (msg: OutboundMessage) => Promise<void>;
+/**
+ * Async message bus that decouples chat channels from the agent core.
+ *
+ * Channels push messages to the inbound queue, and the agent processes
+ * them and pushes responses to the outbound queue.
+ */
+export declare class MessageBus {
+    private _inbound;
+    private _outbound;
+    private _outboundSubscribers;
+    private _running;
+    publishInbound(msg: InboundMessage): Promise<void>;
+    consumeInbound(): Promise<InboundMessage>;
+    publishOutbound(msg: OutboundMessage): Promise<void>;
+    consumeOutbound(): Promise<OutboundMessage>;
+    subscribeOutbound(channel: string, callback: OutboundHandler): void;
+    /**
+     * Dispatch outbound messages to subscribed channels.
+     * Run this as a background task.
+     */
+    dispatchOutbound(): Promise<void>;
+    stop(): void;
+    get inboundSize(): number;
+    get outboundSize(): number;
+}
+export {};
+//# sourceMappingURL=queue.d.ts.map

package/dist/bus/queue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"queue.d.ts","sourceRoot":"","sources":["../../src/bus/queue.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAG3D,KAAK,eAAe,GAAG,CAAC,GAAG,EAAE,eAAe,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;AA6B/D;;;;;GAKG;AACH,qBAAa,UAAU;IACrB,OAAO,CAAC,QAAQ,CAAoC;IACpD,OAAO,CAAC,SAAS,CAAqC;IACtD,OAAO,CAAC,oBAAoB,CAAwC;IACpE,OAAO,CAAC,QAAQ,CAAS;IAEnB,cAAc,CAAC,GAAG,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IAIlD,cAAc,IAAI,OAAO,CAAC,cAAc,CAAC;IAIzC,eAAe,CAAC,GAAG,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC;IAIpD,eAAe,IAAI,OAAO,CAAC,eAAe,CAAC;IAIjD,iBAAiB,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,eAAe,GAAG,IAAI;IAOnE;;;OAGG;IACG,gBAAgB,IAAI,OAAO,CAAC,IAAI,CAAC;IA2BvC,IAAI,IAAI,IAAI;IAIZ,IAAI,WAAW,IAAI,MAAM,CAExB;IAED,IAAI,YAAY,IAAI,MAAM,CAEzB;CACF"}