homaruscc 0.2.0

package/dist/telegram-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"telegram-adapter.d.ts","sourceRoot":"","sources":["../src/telegram-adapter.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,EAAE,aAAa,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAC9G,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAuCtD,MAAM,WAAW,qBAAqB;IACpC,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;CAC3B;AAOD,qBAAa,sBAAuB,SAAQ,cAAc;IACxD,OAAO,CAAC,KAAK,CAAS;IACtB,OAAO,CAAC,WAAW,CAAM;IACzB,OAAO,CAAC,MAAM,CAAK;IACnB,OAAO,CAAC,SAAS,CAA8C;IAC/D,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,YAAY,CAAK;IACzB,OAAO,CAAC,SAAS,CAAmB;IACpC,OAAO,CAAC,eAAe,CAAS;IAChC,OAAO,CAAC,cAAc,CAAc;IACpC,OAAO,CAAC,cAAc,CAAgF;IACtG,OAAO,CAAC,iBAAiB,CAAM;gBAEnB,MAAM,EAAE,qBAAqB,EAAE,MAAM,EAAE,MAAM;IAOzD,MAAM,CAAC,iBAAiB,CAAC,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,MAAM,GAAG,sBAAsB;IAajF,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAaxB,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAU3B,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC;IAsBnE,MAAM,IAAI,YAAY;IAUhB,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAK/C,iBAAiB,CAAC,KAAK,SAAK,GAAG,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC;IAIvG,OAAO,CAAC,YAAY;YAKN,IAAI;IAiClB,OAAO,CAAC,aAAa;IAoCrB,OAAO,CAAC,aAAa;IASrB,OAAO,CAAC,YAAY;YAIN,OAAO;CAgBtB"}

package/dist/telegram-adapter.js

@@ -0,0 +1,188 @@
+import { ChannelAdapter } from "./channel-adapter.js";
+const BASE_URL = "https://api.telegram.org/bot";
+const POLL_TIMEOUT = 30;
+const MAX_BACKOFF = 30_000;
+const INITIAL_BACKOFF = 1_000;
+export class TelegramChannelAdapter extends ChannelAdapter {
+    token;
+    botUsername = "";
+    offset = 0;
+    pollTimer = null;
+    stopping = false;
+    lastPollOk = false;
+    lastPollTime = 0;
+    backoffMs = INITIAL_BACKOFF;
+    pollingInterval;
+    allowedChatIds;
+    recentMessages = [];
+    maxRecentMessages = 50;
+    constructor(config, logger) {
+        super("telegram", logger, config.dmPolicy ?? "open", config.groupPolicy ?? "mention_required");
+        this.token = config.token;
+        this.pollingInterval = config.pollingInterval ?? 1000;
+        this.allowedChatIds = new Set(config.allowedChatIds ?? []);
+    }
+    static fromChannelConfig(config, logger) {
+        if (!config.token || typeof config.token !== "string") {
+            throw new Error("Telegram adapter requires a 'token' in channel config");
+        }
+        return new TelegramChannelAdapter({
+            token: config.token,
+            dmPolicy: config.dmPolicy,
+            groupPolicy: config.groupPolicy,
+            pollingInterval: config.pollingInterval,
+            allowedChatIds: config.allowedChatIds,
+        }, logger);
+    }
+    async connect() {
+        this.state = "connecting";
+        this.stopping = false;
+        const me = await this.apiCall("getMe");
+        this.botUsername = me.username ?? "";
+        this.logger.info("Telegram connected", { username: this.botUsername });
+        this.state = "connected";
+        this.backoffMs = INITIAL_BACKOFF;
+        this.schedulePoll();
+    }
+    async disconnect() {
+        this.stopping = true;
+        if (this.pollTimer) {
+            clearTimeout(this.pollTimer);
+            this.pollTimer = null;
+        }
+        this.state = "disconnected";
+        this.logger.info("Telegram disconnected");
+    }
+    async send(target, message) {
+        const body = {
+            chat_id: target,
+            text: message.text,
+            parse_mode: "Markdown",
+        };
+        if (message.replyTo) {
+            body.reply_to_message_id = Number(message.replyTo);
+        }
+        try {
+            await this.apiCall("sendMessage", body);
+        }
+        catch (err) {
+            // Markdown parse failures are common — retry without parse_mode
+            if (String(err).includes("can't parse entities")) {
+                delete body.parse_mode;
+                await this.apiCall("sendMessage", body);
+            }
+            else {
+                throw err;
+            }
+        }
+    }
+    health() {
+        return {
+            healthy: this.state === "connected" && this.lastPollOk,
+            message: this.state === "connected"
+                ? (this.lastPollOk ? "polling" : "poll error, retrying")
+                : this.state,
+            lastCheck: this.lastPollTime || Date.now(),
+        };
+    }
+    async sendTyping(chatId) {
+        await this.apiCall("sendChatAction", { chat_id: chatId, action: "typing" });
+    }
+    // homaruscc addition: get recent messages for MCP tool
+    getRecentMessages(limit = 20) {
+        return this.recentMessages.slice(-limit);
+    }
+    schedulePoll() {
+        if (this.stopping)
+            return;
+        this.pollTimer = setTimeout(() => this.poll(), this.pollingInterval);
+    }
+    async poll() {
+        if (this.stopping)
+            return;
+        try {
+            const updates = await this.apiCall("getUpdates", {
+                offset: this.offset,
+                timeout: POLL_TIMEOUT,
+            });
+            this.lastPollOk = true;
+            this.lastPollTime = Date.now();
+            this.backoffMs = INITIAL_BACKOFF;
+            for (const update of updates) {
+                this.offset = update.update_id + 1;
+                if (update.message) {
+                    this.handleMessage(update.message);
+                }
+            }
+            this.schedulePoll();
+        }
+        catch (err) {
+            this.lastPollOk = false;
+            this.lastPollTime = Date.now();
+            this.logger.error("Telegram poll error", { error: String(err), backoffMs: this.backoffMs });
+            if (!this.stopping) {
+                this.pollTimer = setTimeout(() => this.poll(), this.backoffMs);
+                this.backoffMs = Math.min(this.backoffMs * 2, MAX_BACKOFF);
+            }
+        }
+    }
+    handleMessage(msg) {
+        if (!msg.text)
+            return;
+        if (this.allowedChatIds.size > 0 && !this.allowedChatIds.has(msg.chat.id)) {
+            this.logger.debug("Message from non-whitelisted chat, ignoring", { chatId: msg.chat.id });
+            return;
+        }
+        const isGroup = msg.chat.type === "group" || msg.chat.type === "supergroup";
+        const isMention = this.detectMention(msg);
+        // Store for MCP read tool
+        this.recentMessages.push({
+            from: msg.from?.username ?? String(msg.from?.id ?? "unknown"),
+            text: isMention ? this.stripMention(msg.text) : msg.text,
+            chatId: String(msg.chat.id),
+            timestamp: Date.now(),
+        });
+        if (this.recentMessages.length > this.maxRecentMessages) {
+            this.recentMessages.shift();
+        }
+        // Send typing indicator immediately so user sees we're processing
+        this.sendTyping(String(msg.chat.id)).catch(() => { });
+        this.deliverWithTarget({
+            from: msg.from?.username ?? String(msg.from?.id ?? "unknown"),
+            channel: "telegram",
+            text: isMention ? this.stripMention(msg.text) : msg.text,
+            isGroup,
+            isMention,
+            replyTo: String(msg.message_id),
+            raw: msg,
+        }, String(msg.chat.id));
+    }
+    detectMention(msg) {
+        if (!this.botUsername || !msg.entities)
+            return false;
+        return msg.entities.some((e) => {
+            if (e.type !== "mention")
+                return false;
+            const mentionText = msg.text.substring(e.offset, e.offset + e.length);
+            return mentionText.toLowerCase() === `@${this.botUsername.toLowerCase()}`;
+        });
+    }
+    stripMention(text) {
+        return text.replace(new RegExp(`@${this.botUsername}\\b`, "gi"), "").trim();
+    }
+    async apiCall(method, body) {
+        const url = `${BASE_URL}${this.token}/${method}`;
+        const opts = {
+            method: "POST",
+            headers: { "Content-Type": "application/json" },
+            body: body ? JSON.stringify(body) : undefined,
+        };
+        const res = await fetch(url, opts);
+        const json = (await res.json());
+        if (!json.ok) {
+            throw new Error(`Telegram API error (${method}): ${json.description ?? "unknown"}`);
+        }
+        return json.result;
+    }
+}
+//# sourceMappingURL=telegram-adapter.js.map

package/dist/telegram-adapter.js.map

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

package/dist/timer-service.d.ts

@@ -0,0 +1,30 @@
+import type { Event, Logger } from "./types.js";
+export interface TimerConfig {
+    id?: string;
+    name: string;
+    type: "cron" | "interval" | "once";
+    schedule: string;
+    prompt: string;
+    timezone?: string;
+}
+export declare class TimerService {
+    private timers;
+    private storePath;
+    private logger;
+    private emitFn;
+    constructor(logger: Logger, storePath: string);
+    setEmitter(fn: (event: Event) => void): void;
+    loadTimers(): void;
+    saveTimers(): void;
+    add(config: TimerConfig): string;
+    remove(timerIdOrName: string): void;
+    get(timerId: string): TimerConfig | undefined;
+    getAll(): TimerConfig[];
+    registerDefaults(defaults: TimerConfig[]): void;
+    start(): void;
+    stop(): void;
+    private onFire;
+    private startTimer;
+    private stopTimer;
+}
+//# sourceMappingURL=timer-service.d.ts.map

package/dist/timer-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"timer-service.d.ts","sourceRoot":"","sources":["../src/timer-service.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AAEhD,MAAM,WAAW,WAAW;IAC1B,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,GAAG,UAAU,GAAG,MAAM,CAAC;IACnC,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAQD,qBAAa,YAAY;IACvB,OAAO,CAAC,MAAM,CAAiC;IAC/C,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,MAAM,CAAyC;gBAE3C,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM;IAK7C,UAAU,CAAC,EAAE,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,GAAG,IAAI;IAI5C,UAAU,IAAI,IAAI;IAwBlB,UAAU,IAAI,IAAI;IAOlB,GAAG,CAAC,MAAM,EAAE,WAAW,GAAG,MAAM;IAkBhC,MAAM,CAAC,aAAa,EAAE,MAAM,GAAG,IAAI;IAmBnC,GAAG,CAAC,OAAO,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS;IAI7C,MAAM,IAAI,WAAW,EAAE;IAIvB,gBAAgB,CAAC,QAAQ,EAAE,WAAW,EAAE,GAAG,IAAI;IAc/C,KAAK,IAAI,IAAI;IAOb,IAAI,IAAI,IAAI;IAQZ,OAAO,CAAC,MAAM;IAyBd,OAAO,CAAC,UAAU;IAsBlB,OAAO,CAAC,SAAS;CAWlB"}

package/dist/timer-service.js

@@ -0,0 +1,176 @@
+// CRC: crc-TimerService.md | Seq: seq-timer-fire.md
+// Timer service — from HomarUS
+import { readFileSync, writeFileSync, existsSync, mkdirSync } from "node:fs";
+import { dirname } from "node:path";
+import { v4 as uuid } from "uuid";
+import { Cron } from "croner";
+export class TimerService {
+    timers = new Map();
+    storePath;
+    logger;
+    emitFn = null;
+    constructor(logger, storePath) {
+        this.logger = logger;
+        this.storePath = storePath;
+    }
+    setEmitter(fn) {
+        this.emitFn = fn;
+    }
+    loadTimers() {
+        if (!existsSync(this.storePath))
+            return;
+        try {
+            const data = JSON.parse(readFileSync(this.storePath, "utf-8"));
+            // Dedup by name on load — last entry wins
+            const byName = new Map();
+            for (const config of data) {
+                config.id = config.id ?? uuid();
+                byName.set(config.name, config);
+            }
+            for (const config of byName.values()) {
+                this.timers.set(config.id, { config });
+            }
+            // Save deduped version back
+            if (byName.size < data.length) {
+                this.saveTimers();
+                this.logger.info("Deduped timers on load", { before: data.length, after: byName.size });
+            }
+            this.logger.info("Loaded timers", { count: this.timers.size });
+        }
+        catch (err) {
+            this.logger.error("Failed to load timers", { error: String(err) });
+        }
+    }
+    saveTimers() {
+        const data = [...this.timers.values()].map((e) => e.config);
+        const dir = dirname(this.storePath);
+        if (!existsSync(dir))
+            mkdirSync(dir, { recursive: true });
+        writeFileSync(this.storePath, JSON.stringify(data, null, 2));
+    }
+    add(config) {
+        // Dedup: if a timer with the same name exists, remove it first
+        for (const [existingId, entry] of this.timers) {
+            if (entry.config.name === config.name) {
+                this.stopTimer(entry);
+                this.timers.delete(existingId);
+                this.logger.info("Replaced existing timer", { id: existingId, name: config.name });
+            }
+        }
+        const id = config.id ?? uuid();
+        config.id = id;
+        this.timers.set(id, { config });
+        this.startTimer(id);
+        this.saveTimers();
+        this.logger.info("Timer added", { id, name: config.name, type: config.type });
+        return id;
+    }
+    remove(timerIdOrName) {
+        // Try by ID first, then by name
+        let id = timerIdOrName;
+        if (!this.timers.has(id)) {
+            for (const [existingId, entry] of this.timers) {
+                if (entry.config.name === timerIdOrName) {
+                    id = existingId;
+                    break;
+                }
+            }
+        }
+        const entry = this.timers.get(id);
+        if (!entry)
+            return;
+        this.stopTimer(entry);
+        this.timers.delete(id);
+        this.saveTimers();
+        this.logger.info("Timer removed", { id, name: entry.config.name });
+    }
+    get(timerId) {
+        return this.timers.get(timerId)?.config;
+    }
+    getAll() {
+        return [...this.timers.values()].map((e) => e.config);
+    }
+    registerDefaults(defaults) {
+        const existingNames = new Set([...this.timers.values()].map(e => e.config.name));
+        let added = 0;
+        for (const config of defaults) {
+            if (existingNames.has(config.name))
+                continue;
+            const id = config.id ?? uuid();
+            config.id = id;
+            this.timers.set(id, { config });
+            added++;
+            this.logger.info("Registered default timer", { name: config.name });
+        }
+        if (added > 0)
+            this.saveTimers();
+    }
+    start() {
+        for (const [id] of this.timers) {
+            this.startTimer(id);
+        }
+        this.logger.info("Timer service started", { count: this.timers.size });
+    }
+    stop() {
+        for (const entry of this.timers.values()) {
+            this.stopTimer(entry);
+        }
+        this.saveTimers();
+        this.logger.info("Timer service stopped");
+    }
+    onFire(timerId) {
+        const entry = this.timers.get(timerId);
+        if (!entry || !this.emitFn)
+            return;
+        const event = {
+            id: uuid(),
+            type: "timer_fired",
+            source: `timer:${timerId}`,
+            timestamp: Date.now(),
+            payload: {
+                timerId,
+                name: entry.config.name,
+                prompt: entry.config.prompt,
+            },
+        };
+        this.logger.info("Timer fired", { id: timerId, name: entry.config.name });
+        this.emitFn(event);
+        if (entry.config.type === "once") {
+            this.timers.delete(timerId);
+            this.saveTimers();
+        }
+    }
+    startTimer(id) {
+        const entry = this.timers.get(id);
+        if (!entry)
+            return;
+        this.stopTimer(entry);
+        const { config } = entry;
+        switch (config.type) {
+            case "cron":
+                entry.job = new Cron(config.schedule, { timezone: config.timezone }, () => this.onFire(id));
+                break;
+            case "interval":
+                entry.timeout = setInterval(() => this.onFire(id), parseInt(config.schedule, 10));
+                break;
+            case "once": {
+                const fireAt = new Date(config.schedule).getTime();
+                const delay = Math.max(0, fireAt - Date.now());
+                entry.timeout = setTimeout(() => this.onFire(id), delay);
+                break;
+            }
+        }
+    }
+    stopTimer(entry) {
+        if (entry.job) {
+            entry.job.stop();
+            entry.job = undefined;
+        }
+        if (entry.timeout) {
+            clearTimeout(entry.timeout);
+            clearInterval(entry.timeout);
+            entry.timeout = undefined;
+        }
+    }
+}
+//# sourceMappingURL=timer-service.js.map

package/dist/timer-service.js.map

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

package/dist/tool-registry.d.ts

@@ -0,0 +1,30 @@
+import type { ToolDefinition, ToolResult, ToolContext, Logger } from "./types.js";
+export interface ToolPolicy {
+    name: string;
+    allow?: string[];
+    deny?: string[];
+}
+export declare class ToolRegistry {
+    private tools;
+    private policies;
+    private groups;
+    private logger;
+    constructor(logger: Logger);
+    register(tool: ToolDefinition): void;
+    unregister(name: string): void;
+    get(name: string): ToolDefinition | undefined;
+    getAll(): ToolDefinition[];
+    getForAgent(allowedTools?: string[]): ToolDefinition[];
+    execute(name: string, params: unknown, context: ToolContext): Promise<ToolResult>;
+    registerGroup(name: string, toolNames: string[]): void;
+    resolveGroup(groupName: string): string[];
+    addPolicy(policy: ToolPolicy): void;
+    checkPolicy(toolName: string, _context: ToolContext): boolean;
+    private resolveNames;
+    toSchemas(): Array<{
+        name: string;
+        description: string;
+        parameters: Record<string, unknown>;
+    }>;
+}
+//# sourceMappingURL=tool-registry.d.ts.map

package/dist/tool-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-registry.d.ts","sourceRoot":"","sources":["../src/tool-registry.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AAElF,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;CACjB;AAUD,qBAAa,YAAY;IACvB,OAAO,CAAC,KAAK,CAAqC;IAClD,OAAO,CAAC,QAAQ,CAAoB;IACpC,OAAO,CAAC,MAAM,CAA6D;IAC3E,OAAO,CAAC,MAAM,CAAS;gBAEX,MAAM,EAAE,MAAM;IAI1B,QAAQ,CAAC,IAAI,EAAE,cAAc,GAAG,IAAI;IAKpC,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAI9B,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS;IAI7C,MAAM,IAAI,cAAc,EAAE;IAI1B,WAAW,CAAC,YAAY,CAAC,EAAE,MAAM,EAAE,GAAG,cAAc,EAAE;IAiBhD,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC;IAyBvF,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,IAAI;IAItD,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,EAAE;IAIzC,SAAS,CAAC,MAAM,EAAE,UAAU,GAAG,IAAI;IAInC,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,WAAW,GAAG,OAAO;IAY7D,OAAO,CAAC,YAAY;IAUpB,SAAS,IAAI,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,CAAC;CAO/F"}

package/dist/tool-registry.js

@@ -0,0 +1,108 @@
+const BUILTIN_GROUPS = {
+    "group:fs": ["read", "write", "edit", "glob", "grep"],
+    "group:runtime": ["bash", "git"],
+    "group:web": ["web_fetch", "web_search", "browser"],
+    "group:code": ["lsp"],
+    "group:memory": ["memory_search", "memory_get", "memory_store"],
+};
+export class ToolRegistry {
+    tools = new Map();
+    policies = [];
+    groups = new Map(Object.entries(BUILTIN_GROUPS));
+    logger;
+    constructor(logger) {
+        this.logger = logger;
+    }
+    register(tool) {
+        this.tools.set(tool.name, tool);
+        this.logger.debug("Registered tool", { name: tool.name, source: tool.source });
+    }
+    unregister(name) {
+        this.tools.delete(name);
+    }
+    get(name) {
+        return this.tools.get(name);
+    }
+    getAll() {
+        return [...this.tools.values()];
+    }
+    getForAgent(allowedTools) {
+        const all = this.getAll();
+        if (!allowedTools)
+            return all;
+        const resolved = new Set();
+        for (const name of allowedTools) {
+            const group = this.groups.get(name);
+            if (group) {
+                group.forEach((t) => resolved.add(t));
+            }
+            else {
+                resolved.add(name);
+            }
+        }
+        return all.filter((t) => resolved.has(t.name));
+    }
+    async execute(name, params, context) {
+        const tool = this.tools.get(name);
+        if (!tool) {
+            return { output: "", error: `Unknown tool: ${name}` };
+        }
+        if (!this.checkPolicy(name, context)) {
+            return { output: "", error: `Tool ${name} denied by policy` };
+        }
+        if (params == null || typeof params !== "object" || Array.isArray(params)) {
+            return { output: "", error: `Tool ${name} requires an object parameter, got ${typeof params}` };
+        }
+        const start = Date.now();
+        try {
+            const result = await tool.execute(params, context);
+            this.logger.debug("Tool executed", { name, durationMs: Date.now() - start });
+            return result;
+        }
+        catch (err) {
+            this.logger.error("Tool execution failed", { name, error: String(err) });
+            return { output: "", error: String(err) };
+        }
+    }
+    registerGroup(name, toolNames) {
+        this.groups.set(name, toolNames);
+    }
+    resolveGroup(groupName) {
+        return this.groups.get(groupName) ?? [];
+    }
+    addPolicy(policy) {
+        this.policies.push(policy);
+    }
+    checkPolicy(toolName, _context) {
+        for (const policy of this.policies) {
+            const denied = this.resolveNames(policy.deny ?? []);
+            if (denied.has(toolName))
+                return false;
+            if (policy.allow) {
+                const allowed = this.resolveNames(policy.allow);
+                if (!allowed.has(toolName))
+                    return false;
+            }
+        }
+        return true;
+    }
+    resolveNames(names) {
+        const resolved = new Set();
+        for (const name of names) {
+            const group = this.groups.get(name);
+            if (group)
+                group.forEach((t) => resolved.add(t));
+            else
+                resolved.add(name);
+        }
+        return resolved;
+    }
+    toSchemas() {
+        return this.getAll().map((t) => ({
+            name: t.name,
+            description: t.description,
+            parameters: t.parameters,
+        }));
+    }
+}
+//# sourceMappingURL=tool-registry.js.map

package/dist/tool-registry.js.map

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

package/dist/tools/bash.d.ts

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

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

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

package/dist/tools/bash.js

@@ -0,0 +1,67 @@
+// CRC: crc-ToolRegistry.md
+// Built-in tool: bash — from HomarUS
+import { exec } from "node:child_process";
+const MAX_OUTPUT = 50_000;
+const BLOCKED_PATTERNS = [
+    { pattern: /\brm\s+(-[a-zA-Z]*f|-[a-zA-Z]*r|--force|--recursive).*\//, label: "rm -rf /" },
+    { pattern: /\bsudo\b/, label: "sudo" },
+    { pattern: /\bmkfs\b/, label: "mkfs" },
+    { pattern: /\bdd\s+.*of=\/dev\//, label: "dd to device" },
+    { pattern: />\s*\/dev\/sd/, label: "redirect to disk device" },
+    { pattern: /\bchmod\s+777\b/, label: "chmod 777" },
+    { pattern: /\bcurl\b.*\|\s*(ba)?sh/, label: "curl pipe to shell" },
+    { pattern: /\bwget\b.*\|\s*(ba)?sh/, label: "wget pipe to shell" },
+    { pattern: /\b(shutdown|reboot|halt|poweroff)\b/, label: "system control" },
+    { pattern: /\bkillall\b/, label: "killall" },
+    { pattern: /:\(\)\s*\{\s*:\|:&\s*\}\s*;:/, label: "fork bomb" },
+];
+export const bashTool = {
+    name: "bash",
+    description: "Execute a bash command and return stdout/stderr.",
+    parameters: {
+        type: "object",
+        properties: {
+            command: { type: "string", description: "The bash command to execute" },
+            timeout: { type: "number", description: "Timeout in milliseconds (default 120000)" },
+            workingDir: { type: "string", description: "Working directory for the command" },
+        },
+        required: ["command"],
+    },
+    source: "builtin",
+    async execute(params, context) {
+        const { command, timeout = 120_000, workingDir } = params;
+        for (const { pattern, label } of BLOCKED_PATTERNS) {
+            if (pattern.test(command)) {
+                return { output: "", error: `Blocked: command matches dangerous pattern (${label}).` };
+            }
+        }
+        if (context.sandbox) {
+            return { output: "", error: "bash tool is not available in sandbox mode" };
+        }
+        return new Promise((resolve) => {
+            exec(command, {
+                cwd: workingDir ?? context.workingDir,
+                timeout,
+                maxBuffer: 10 * 1024 * 1024,
+                env: { ...process.env, TERM: "dumb" },
+            }, (error, stdout, stderr) => {
+                let output = stdout;
+                if (stderr)
+                    output += (output ? "\n" : "") + stderr;
+                if (output.length > MAX_OUTPUT) {
+                    output = output.slice(0, MAX_OUTPUT) + `\n... (truncated, ${output.length} total chars)`;
+                }
+                if (error && error.killed) {
+                    resolve({ output, error: `Command timed out after ${timeout}ms` });
+                }
+                else if (error) {
+                    resolve({ output, error: `Exit code ${error.code}: ${error.message}` });
+                }
+                else {
+                    resolve({ output });
+                }
+            });
+        });
+    },
+};
+//# sourceMappingURL=bash.js.map