homaruscc 0.2.0

package/dist/tools/index.d.ts

@@ -0,0 +1,6 @@
+import type { ToolRegistry } from "../tool-registry.js";
+import type { MemoryIndex } from "../memory-index.js";
+import type { BrowserService } from "../browser-service.js";
+import type { Logger } from "../types.js";
+export declare function registerBuiltinTools(registry: ToolRegistry, memoryIndex: MemoryIndex, logger: Logger, browserService?: BrowserService): void;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAa1C,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,YAAY,EACtB,WAAW,EAAE,WAAW,EACxB,MAAM,EAAE,MAAM,EACd,cAAc,CAAC,EAAE,cAAc,GAC9B,IAAI,CAuCN"}

package/dist/tools/index.js

@@ -0,0 +1,46 @@
+import { bashTool } from "./bash.js";
+import { readTool } from "./read.js";
+import { writeTool } from "./write.js";
+import { editTool } from "./edit.js";
+import { globTool } from "./glob.js";
+import { grepTool } from "./grep.js";
+import { gitTool } from "./git.js";
+import { webFetchTool } from "./web-fetch.js";
+import { webSearchTool } from "./web-search.js";
+import { createMemoryTools } from "./memory.js";
+import { createBrowserTools } from "./browser.js";
+export function registerBuiltinTools(registry, memoryIndex, logger, browserService) {
+    // group:fs
+    registry.register(readTool);
+    registry.register(writeTool);
+    registry.register(editTool);
+    registry.register(globTool);
+    registry.register(grepTool);
+    // group:runtime
+    registry.register(bashTool);
+    registry.register(gitTool);
+    // group:web
+    registry.register(webFetchTool);
+    registry.register(webSearchTool);
+    // group:memory
+    for (const tool of createMemoryTools(memoryIndex)) {
+        registry.register(tool);
+    }
+    // group:browser
+    if (browserService) {
+        for (const tool of createBrowserTools(browserService)) {
+            registry.register(tool);
+        }
+    }
+    const tools = [
+        readTool.name, writeTool.name, editTool.name, globTool.name, grepTool.name,
+        bashTool.name, gitTool.name,
+        webFetchTool.name, webSearchTool.name,
+        "memory_search", "memory_get", "memory_store",
+    ];
+    if (browserService) {
+        tools.push("browser_navigate", "browser_snapshot", "browser_screenshot", "browser_click", "browser_type", "browser_evaluate", "browser_content");
+    }
+    logger.info("Built-in tools registered", { count: tools.length, tools });
+}
+//# sourceMappingURL=index.js.map

package/dist/tools/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AACrC,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AACrC,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AACvC,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AACrC,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AACrC,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AACrC,OAAO,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AACnC,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAElD,MAAM,UAAU,oBAAoB,CAClC,QAAsB,EACtB,WAAwB,EACxB,MAAc,EACd,cAA+B;IAE/B,WAAW;IACX,QAAQ,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;IAC5B,QAAQ,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;IAC7B,QAAQ,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;IAC5B,QAAQ,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;IAC5B,QAAQ,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;IAE5B,gBAAgB;IAChB,QAAQ,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;IAC5B,QAAQ,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;IAE3B,YAAY;IACZ,QAAQ,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC;IAChC,QAAQ,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAC;IAEjC,eAAe;IACf,KAAK,MAAM,IAAI,IAAI,iBAAiB,CAAC,WAAW,CAAC,EAAE,CAAC;QAClD,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;IAED,gBAAgB;IAChB,IAAI,cAAc,EAAE,CAAC;QACnB,KAAK,MAAM,IAAI,IAAI,kBAAkB,CAAC,cAAc,CAAC,EAAE,CAAC;YACtD,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;QAC1B,CAAC;IACH,CAAC;IAED,MAAM,KAAK,GAAG;QACZ,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC,IAAI,EAAE,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC,IAAI;QAC1E,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC,IAAI;QAC3B,YAAY,CAAC,IAAI,EAAE,aAAa,CAAC,IAAI;QACrC,eAAe,EAAE,YAAY,EAAE,cAAc;KAC9C,CAAC;IACF,IAAI,cAAc,EAAE,CAAC;QACnB,KAAK,CAAC,IAAI,CAAC,kBAAkB,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,eAAe,EAAE,cAAc,EAAE,kBAAkB,EAAE,iBAAiB,CAAC,CAAC;IACnJ,CAAC;IAED,MAAM,CAAC,IAAI,CAAC,2BAA2B,EAAE,EAAE,KAAK,EAAE,KAAK,CAAC,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC;AAC3E,CAAC"}

package/dist/tools/memory.d.ts

@@ -0,0 +1,4 @@
+import type { ToolDefinition } from "../types.js";
+import type { MemoryIndex } from "../memory-index.js";
+export declare function createMemoryTools(memoryIndex: MemoryIndex): ToolDefinition[];
+//# sourceMappingURL=memory.d.ts.map

package/dist/tools/memory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory.d.ts","sourceRoot":"","sources":["../../src/tools/memory.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAc,MAAM,aAAa,CAAC;AAC9D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAgBtD,wBAAgB,iBAAiB,CAAC,WAAW,EAAE,WAAW,GAAG,cAAc,EAAE,CAyE5E"}

package/dist/tools/memory.js

@@ -0,0 +1,64 @@
+export function createMemoryTools(memoryIndex) {
+    const memorySearchTool = {
+        name: "memory_search",
+        description: "Search the memory index using hybrid vector + text search.",
+        parameters: {
+            type: "object",
+            properties: {
+                query: { type: "string", description: "The search query" },
+                limit: { type: "number", description: "Maximum number of results (default 10)" },
+            },
+            required: ["query"],
+        },
+        source: "builtin",
+        async execute(params) {
+            const { query, limit } = params;
+            const results = await memoryIndex.search(query, { limit });
+            if (results.length === 0) {
+                return { output: "No results found." };
+            }
+            const formatted = results.map((r, i) => `[${i + 1}] ${r.path} (score: ${r.score.toFixed(3)})\n${r.content.slice(0, 500)}`).join("\n\n---\n\n");
+            return { output: formatted };
+        },
+    };
+    const memoryGetTool = {
+        name: "memory_get",
+        description: "Retrieve the full content of a specific file from memory.",
+        parameters: {
+            type: "object",
+            properties: {
+                path: { type: "string", description: "The file path to retrieve" },
+            },
+            required: ["path"],
+        },
+        source: "builtin",
+        async execute(params) {
+            const { path } = params;
+            const content = memoryIndex.get(path);
+            if (!content) {
+                return { output: "", error: `File not found: ${path}` };
+            }
+            return { output: content };
+        },
+    };
+    const memoryStoreTool = {
+        name: "memory_store",
+        description: "Store content to a file in memory and index it for future search.",
+        parameters: {
+            type: "object",
+            properties: {
+                content: { type: "string", description: "The content to store" },
+                path: { type: "string", description: "The file path to store at" },
+            },
+            required: ["content", "path"],
+        },
+        source: "builtin",
+        async execute(params) {
+            const { content, path } = params;
+            await memoryIndex.store(content, path);
+            return { output: `Stored and indexed: ${path}` };
+        },
+    };
+    return [memorySearchTool, memoryGetTool, memoryStoreTool];
+}
+//# sourceMappingURL=memory.js.map

package/dist/tools/memory.js.map

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

package/dist/tools/read.d.ts

@@ -0,0 +1,3 @@
+import type { ToolDefinition } from "../types.js";
+export declare const readTool: ToolDefinition;
+//# sourceMappingURL=read.d.ts.map

package/dist/tools/read.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"read.d.ts","sourceRoot":"","sources":["../../src/tools/read.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,cAAc,EAA2B,MAAM,aAAa,CAAC;AAW3E,eAAO,MAAM,QAAQ,EAAE,cAkDtB,CAAC"}

package/dist/tools/read.js

@@ -0,0 +1,50 @@
+// CRC: crc-ToolRegistry.md
+// Built-in tool: read — from HomarUS
+import { readFileSync, existsSync, statSync } from "node:fs";
+import { resolve } from "node:path";
+const MAX_FILE_SIZE = 2 * 1024 * 1024;
+const MAX_LINES = 2000;
+export const readTool = {
+    name: "read",
+    description: "Read the contents of a file. Returns numbered lines.",
+    parameters: {
+        type: "object",
+        properties: {
+            path: { type: "string", description: "Absolute or relative path to the file" },
+            offset: { type: "number", description: "Line number to start reading from (1-based)" },
+            limit: { type: "number", description: "Maximum number of lines to return" },
+        },
+        required: ["path"],
+    },
+    source: "builtin",
+    async execute(params, context) {
+        const { path: filePath, offset, limit } = params;
+        const absPath = resolve(context.workingDir, filePath);
+        if (!existsSync(absPath)) {
+            return { output: "", error: `File not found: ${absPath}` };
+        }
+        const stat = statSync(absPath);
+        if (stat.isDirectory()) {
+            return { output: "", error: `Path is a directory: ${absPath}` };
+        }
+        if (stat.size > MAX_FILE_SIZE) {
+            return { output: "", error: `File too large (${stat.size} bytes). Max: ${MAX_FILE_SIZE}` };
+        }
+        const content = readFileSync(absPath, "utf-8");
+        const allLines = content.split("\n");
+        const startLine = (offset ?? 1) - 1;
+        const maxLines = limit ?? MAX_LINES;
+        const lines = allLines.slice(startLine, startLine + maxLines);
+        const numbered = lines.map((line, i) => {
+            const lineNum = startLine + i + 1;
+            const truncated = line.length > 2000 ? line.slice(0, 2000) + "..." : line;
+            return `${String(lineNum).padStart(6)}\t${truncated}`;
+        });
+        let output = numbered.join("\n");
+        if (startLine + maxLines < allLines.length) {
+            output += `\n... (${allLines.length - startLine - maxLines} more lines)`;
+        }
+        return { output };
+    },
+};
+//# sourceMappingURL=read.js.map

package/dist/tools/read.js.map

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

package/dist/tools/web-fetch.d.ts

@@ -0,0 +1,3 @@
+import type { ToolDefinition } from "../types.js";
+export declare const webFetchTool: ToolDefinition;
+//# sourceMappingURL=web-fetch.d.ts.map

package/dist/tools/web-fetch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"web-fetch.d.ts","sourceRoot":"","sources":["../../src/tools/web-fetch.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAA2B,MAAM,aAAa,CAAC;AAW3E,eAAO,MAAM,YAAY,EAAE,cAuD1B,CAAC"}

package/dist/tools/web-fetch.js

@@ -0,0 +1,51 @@
+const MAX_RESPONSE = 100_000;
+export const webFetchTool = {
+    name: "web_fetch",
+    description: "Fetch content from a URL. Returns the response body as text.",
+    parameters: {
+        type: "object",
+        properties: {
+            url: { type: "string", description: "The URL to fetch" },
+            method: { type: "string", description: "HTTP method (default GET)", enum: ["GET", "POST", "PUT", "DELETE", "PATCH"] },
+            headers: { type: "object", description: "Optional request headers" },
+            body: { type: "string", description: "Optional request body" },
+        },
+        required: ["url"],
+    },
+    source: "builtin",
+    async execute(params, context) {
+        const { url, method = "GET", headers, body } = params;
+        if (context.sandbox) {
+            return { output: "", error: "web_fetch tool is not available in sandbox mode" };
+        }
+        try {
+            const response = await fetch(url, {
+                method,
+                headers: headers ? new Headers(headers) : undefined,
+                body: body ?? undefined,
+                signal: AbortSignal.timeout(30_000),
+            });
+            const contentType = response.headers.get("content-type") ?? "";
+            let text;
+            if (contentType.includes("application/json")) {
+                const json = await response.json();
+                text = JSON.stringify(json, null, 2);
+            }
+            else {
+                text = await response.text();
+            }
+            if (text.length > MAX_RESPONSE) {
+                text = text.slice(0, MAX_RESPONSE) + `\n... (truncated, ${text.length} total chars)`;
+            }
+            const statusLine = `HTTP ${response.status} ${response.statusText}`;
+            if (!response.ok) {
+                return { output: text, error: statusLine };
+            }
+            return { output: `${statusLine}\n\n${text}` };
+        }
+        catch (err) {
+            return { output: "", error: `Fetch failed: ${String(err.message ?? err)}` };
+        }
+    },
+};
+//# sourceMappingURL=web-fetch.js.map

package/dist/tools/web-fetch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"web-fetch.js","sourceRoot":"","sources":["../../src/tools/web-fetch.ts"],"names":[],"mappings":"AAIA,MAAM,YAAY,GAAG,OAAO,CAAC;AAS7B,MAAM,CAAC,MAAM,YAAY,GAAmB;IAC1C,IAAI,EAAE,WAAW;IACjB,WAAW,EAAE,8DAA8D;IAC3E,UAAU,EAAE;QACV,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,GAAG,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,kBAAkB,EAAE;YACxD,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,2BAA2B,EAAE,IAAI,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,OAAO,CAAC,EAAE;YACrH,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,0BAA0B,EAAE;YACpE,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,uBAAuB,EAAE;SAC/D;QACD,QAAQ,EAAE,CAAC,KAAK,CAAC;KAClB;IACD,MAAM,EAAE,SAAS;IAEjB,KAAK,CAAC,OAAO,CAAC,MAAe,EAAE,OAAoB;QACjD,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,GAAG,MAAwB,CAAC;QAExE,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;YACpB,OAAO,EAAE,MAAM,EAAE,EAAE,EAAE,KAAK,EAAE,iDAAiD,EAAE,CAAC;QAClF,CAAC;QAED,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE;gBAChC,MAAM;gBACN,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,SAAS;gBACnD,IAAI,EAAE,IAAI,IAAI,SAAS;gBACvB,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,MAAM,CAAC;aACpC,CAAC,CAAC;YAEH,MAAM,WAAW,GAAG,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,IAAI,EAAE,CAAC;YAC/D,IAAI,IAAY,CAAC;YAEjB,IAAI,WAAW,CAAC,QAAQ,CAAC,kBAAkB,CAAC,EAAE,CAAC;gBAC7C,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;gBACnC,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;YACvC,CAAC;iBAAM,CAAC;gBACN,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;YAC/B,CAAC;YAED,IAAI,IAAI,CAAC,MAAM,GAAG,YAAY,EAAE,CAAC;gBAC/B,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,YAAY,CAAC,GAAG,qBAAqB,IAAI,CAAC,MAAM,eAAe,CAAC;YACvF,CAAC;YAED,MAAM,UAAU,GAAG,QAAQ,QAAQ,CAAC,MAAM,IAAI,QAAQ,CAAC,UAAU,EAAE,CAAC;YAEpE,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;gBACjB,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,UAAU,EAAE,CAAC;YAC7C,CAAC;YAED,OAAO,EAAE,MAAM,EAAE,GAAG,UAAU,OAAO,IAAI,EAAE,EAAE,CAAC;QAChD,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,EAAE,MAAM,EAAE,EAAE,EAAE,KAAK,EAAE,iBAAiB,MAAM,CAAE,GAAa,CAAC,OAAO,IAAI,GAAG,CAAC,EAAE,EAAE,CAAC;QACzF,CAAC;IACH,CAAC;CACF,CAAC"}

package/dist/tools/web-search.d.ts

@@ -0,0 +1,3 @@
+import type { ToolDefinition } from "../types.js";
+export declare const webSearchTool: ToolDefinition;
+//# sourceMappingURL=web-search.d.ts.map

package/dist/tools/web-search.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"web-search.d.ts","sourceRoot":"","sources":["../../src/tools/web-search.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAA2B,MAAM,aAAa,CAAC;AA0D3E,eAAO,MAAM,aAAa,EAAE,cAoC3B,CAAC"}

package/dist/tools/web-search.js

@@ -0,0 +1,65 @@
+async function duckduckgoSearch(query, limit) {
+    const encoded = encodeURIComponent(query);
+    const url = `https://html.duckduckgo.com/html/?q=${encoded}`;
+    const response = await fetch(url, {
+        headers: { "User-Agent": "Mozilla/5.0 (compatible; HomarUScc/1.0)" },
+        signal: AbortSignal.timeout(15_000),
+    });
+    if (!response.ok) {
+        throw new Error(`Search failed: HTTP ${response.status}`);
+    }
+    const html = await response.text();
+    const results = [];
+    const resultBlocks = html.split("class=\"result__body\"");
+    for (let i = 1; i < resultBlocks.length && results.length < limit; i++) {
+        const block = resultBlocks[i];
+        const linkMatch = block.match(/class="result__a"[^>]*href="([^"]*)"[^>]*>([\s\S]*?)<\/a>/);
+        if (!linkMatch)
+            continue;
+        let resultUrl = linkMatch[1];
+        const uddgMatch = resultUrl.match(/uddg=([^&]*)/);
+        if (uddgMatch) {
+            resultUrl = decodeURIComponent(uddgMatch[1]);
+        }
+        const title = linkMatch[2].replace(/<[^>]+>/g, "").trim();
+        const snippetMatch = block.match(/class="result__snippet"[^>]*>([\s\S]*?)<\/a>/);
+        const snippet = snippetMatch
+            ? snippetMatch[1].replace(/<[^>]+>/g, "").trim()
+            : "";
+        if (title && resultUrl) {
+            results.push({ title, url: resultUrl, snippet });
+        }
+    }
+    return results;
+}
+export const webSearchTool = {
+    name: "web_search",
+    description: "Search the web and return results with titles, URLs, and snippets.",
+    parameters: {
+        type: "object",
+        properties: {
+            query: { type: "string", description: "The search query" },
+            limit: { type: "number", description: "Maximum number of results (default 10)" },
+        },
+        required: ["query"],
+    },
+    source: "builtin",
+    async execute(params, context) {
+        if (context.sandbox) {
+            return { output: "", error: "web_search tool is not available in sandbox mode" };
+        }
+        const { query, limit = 10 } = params;
+        try {
+            const results = await duckduckgoSearch(query, limit);
+            if (results.length === 0) {
+                return { output: "No results found." };
+            }
+            const formatted = results.map((r, i) => `[${i + 1}] ${r.title}\n    ${r.url}\n    ${r.snippet}`).join("\n\n");
+            return { output: formatted };
+        }
+        catch (err) {
+            return { output: "", error: `Search failed: ${String(err.message ?? err)}` };
+        }
+    },
+};
+//# sourceMappingURL=web-search.js.map

package/dist/tools/web-search.js.map

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

package/dist/tools/write.d.ts

@@ -0,0 +1,3 @@
+import type { ToolDefinition } from "../types.js";
+export declare const writeTool: ToolDefinition;
+//# sourceMappingURL=write.d.ts.map

package/dist/tools/write.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"write.d.ts","sourceRoot":"","sources":["../../src/tools/write.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,cAAc,EAA2B,MAAM,aAAa,CAAC;AAO3E,eAAO,MAAM,SAAS,EAAE,cA8BvB,CAAC"}

package/dist/tools/write.js

@@ -0,0 +1,32 @@
+// CRC: crc-ToolRegistry.md
+// Built-in tool: write — from HomarUS
+import { writeFileSync, mkdirSync, existsSync } from "node:fs";
+import { resolve, dirname } from "node:path";
+export const writeTool = {
+    name: "write",
+    description: "Write content to a file, creating it if it doesn't exist.",
+    parameters: {
+        type: "object",
+        properties: {
+            path: { type: "string", description: "Absolute or relative path to the file" },
+            content: { type: "string", description: "The content to write" },
+        },
+        required: ["path", "content"],
+    },
+    source: "builtin",
+    async execute(params, context) {
+        const { path: filePath, content } = params;
+        const absPath = resolve(context.workingDir, filePath);
+        if (context.sandbox) {
+            return { output: "", error: "write tool is not available in sandbox mode" };
+        }
+        const dir = dirname(absPath);
+        if (!existsSync(dir)) {
+            mkdirSync(dir, { recursive: true });
+        }
+        writeFileSync(absPath, content);
+        const lines = content.split("\n").length;
+        return { output: `Wrote ${lines} lines to ${absPath}` };
+    },
+};
+//# sourceMappingURL=write.js.map

package/dist/tools/write.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"write.js","sourceRoot":"","sources":["../../src/tools/write.ts"],"names":[],"mappings":"AAAA,2BAA2B;AAC3B,sCAAsC;AACtC,OAAO,EAAE,aAAa,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAC/D,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAQ7C,MAAM,CAAC,MAAM,SAAS,GAAmB;IACvC,IAAI,EAAE,OAAO;IACb,WAAW,EAAE,2DAA2D;IACxE,UAAU,EAAE;QACV,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,uCAAuC,EAAE;YAC9E,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,sBAAsB,EAAE;SACjE;QACD,QAAQ,EAAE,CAAC,MAAM,EAAE,SAAS,CAAC;KAC9B;IACD,MAAM,EAAE,SAAS;IAEjB,KAAK,CAAC,OAAO,CAAC,MAAe,EAAE,OAAoB;QACjD,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,GAAG,MAAqB,CAAC;QAC1D,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;QAEtD,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;YACpB,OAAO,EAAE,MAAM,EAAE,EAAE,EAAE,KAAK,EAAE,6CAA6C,EAAE,CAAC;QAC9E,CAAC;QAED,MAAM,GAAG,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;QAC7B,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;YACrB,SAAS,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACtC,CAAC;QAED,aAAa,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QAChC,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC;QACzC,OAAO,EAAE,MAAM,EAAE,SAAS,KAAK,aAAa,OAAO,EAAE,EAAE,CAAC;IAC1D,CAAC;CACF,CAAC"}

package/dist/transcript-logger.d.ts

@@ -0,0 +1,23 @@
+import type { Logger, Event } from "./types.js";
+import type { MemoryIndex } from "./memory-index.js";
+export declare class TranscriptLogger {
+    private buffer;
+    private transcriptDir;
+    private flushIntervalMs;
+    private flushTimer;
+    private enabled;
+    private memoryIndex;
+    private logger;
+    constructor(logger: Logger, memoryIndex: MemoryIndex, options?: {
+        enabled?: boolean;
+        directory?: string;
+        flushIntervalMs?: number;
+    });
+    start(): void;
+    stop(): Promise<void>;
+    logInbound(event: Event): void;
+    logOutbound(channel: string, text: string): void;
+    flush(): Promise<void>;
+    getBufferSize(): number;
+}
+//# sourceMappingURL=transcript-logger.d.ts.map

package/dist/transcript-logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transcript-logger.d.ts","sourceRoot":"","sources":["../src/transcript-logger.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,MAAM,EAAE,KAAK,EAAkB,MAAM,YAAY,CAAC;AAChE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAUrD,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,MAAM,CAAwB;IACtC,OAAO,CAAC,aAAa,CAAS;IAC9B,OAAO,CAAC,eAAe,CAAS;IAChC,OAAO,CAAC,UAAU,CAA+C;IACjE,OAAO,CAAC,OAAO,CAAU;IACzB,OAAO,CAAC,WAAW,CAAc;IACjC,OAAO,CAAC,MAAM,CAAS;gBAEX,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,WAAW,EAAE,OAAO,CAAC,EAAE;QAC9D,OAAO,CAAC,EAAE,OAAO,CAAC;QAClB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,eAAe,CAAC,EAAE,MAAM,CAAC;KAC1B;IASD,KAAK,IAAI,IAAI;IAiBP,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAU3B,UAAU,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI;IAa9B,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI;IAW1C,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAkC5B,aAAa,IAAI,MAAM;CAGxB"}

package/dist/transcript-logger.js

@@ -0,0 +1,101 @@
+// CRC: crc-TranscriptLogger.md | Seq: seq-transcript-capture.md
+// Session transcript capture and indexing
+import { existsSync, mkdirSync, appendFileSync } from "node:fs";
+import { join } from "node:path";
+export class TranscriptLogger {
+    buffer = [];
+    transcriptDir;
+    flushIntervalMs;
+    flushTimer = null;
+    enabled;
+    memoryIndex;
+    logger;
+    constructor(logger, memoryIndex, options) {
+        this.logger = logger;
+        this.memoryIndex = memoryIndex;
+        this.enabled = options?.enabled ?? true;
+        this.transcriptDir = options?.directory ?? `${process.env.HOME ?? "."}/.homaruscc/transcripts`;
+        this.flushIntervalMs = options?.flushIntervalMs ?? 300_000;
+    }
+    // CRC: crc-TranscriptLogger.md | R98, R102
+    start() {
+        if (!this.enabled)
+            return;
+        // R106: Ensure directory exists once at startup
+        if (!existsSync(this.transcriptDir)) {
+            mkdirSync(this.transcriptDir, { recursive: true });
+        }
+        this.flushTimer = setInterval(() => {
+            this.flush().catch((err) => this.logger.warn("Transcript flush failed", { error: String(err) }));
+        }, this.flushIntervalMs);
+        this.logger.info("TranscriptLogger started", { dir: this.transcriptDir, intervalMs: this.flushIntervalMs });
+    }
+    // CRC: crc-TranscriptLogger.md | R103
+    async stop() {
+        if (this.flushTimer) {
+            clearInterval(this.flushTimer);
+            this.flushTimer = null;
+        }
+        await this.flush();
+        this.logger.info("TranscriptLogger stopped");
+    }
+    // CRC: crc-TranscriptLogger.md | R98
+    logInbound(event) {
+        if (!this.enabled)
+            return;
+        const payload = event.payload;
+        this.buffer.push({
+            timestamp: event.timestamp,
+            channel: payload.channel ?? event.source,
+            direction: "in",
+            sender: payload.from,
+            text: payload.text,
+        });
+    }
+    // CRC: crc-TranscriptLogger.md | R99
+    logOutbound(channel, text) {
+        if (!this.enabled)
+            return;
+        this.buffer.push({
+            timestamp: Date.now(),
+            channel,
+            direction: "out",
+            text,
+        });
+    }
+    // CRC: crc-TranscriptLogger.md | R100, R101, R104, R107
+    async flush() {
+        if (this.buffer.length === 0)
+            return;
+        const turns = this.buffer.splice(0);
+        const date = new Date().toISOString().slice(0, 10);
+        const filePath = join(this.transcriptDir, `${date}.md`);
+        const isNewFile = !existsSync(filePath);
+        const lines = [];
+        if (isNewFile) {
+            lines.push(`# Transcript: ${date}`, "");
+        }
+        for (const turn of turns) {
+            const time = new Date(turn.timestamp).toTimeString().slice(0, 8);
+            const label = `${turn.channel}:${turn.direction}`;
+            const header = turn.sender
+                ? `## ${time} [${label}] ${turn.sender}`
+                : `## ${time} [${label}]`;
+            lines.push(header, "", turn.text, "");
+        }
+        try {
+            appendFileSync(filePath, lines.join("\n"));
+            await this.memoryIndex.indexFile(filePath);
+            this.logger.debug("Transcript flushed", { file: filePath, turns: turns.length });
+        }
+        catch (err) {
+            // R107: Retain buffer on failure
+            this.buffer.unshift(...turns);
+            this.logger.warn("Transcript flush failed, retained buffer", { error: String(err) });
+        }
+    }
+    getBufferSize() {
+        return this.buffer.length;
+    }
+}
+//# sourceMappingURL=transcript-logger.js.map

package/dist/transcript-logger.js.map

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