seclaw-agent 0.1.0

package/dist/agent/skills.js

@@ -0,0 +1,235 @@
+"use strict";
+/**
+ * Skills loader
+ */
+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.SkillsLoader = void 0;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const child_process_1 = require("child_process");
+// Default builtin skills directory
+const BUILTIN_SKILLS_DIR = path.resolve(__dirname, "../../skills");
+function commandExists(cmd) {
+    try {
+        (0, child_process_1.execSync)(`which ${cmd}`, { stdio: "ignore" });
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+function escapeXml(s) {
+    return s.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;");
+}
+class SkillsLoader {
+    workspace;
+    workspaceSkills;
+    builtinSkills;
+    containerWorkspace;
+    pathTranslator;
+    constructor(opts) {
+        this.workspace = opts.workspace;
+        this.workspaceSkills = path.join(opts.workspace, "skills");
+        this.builtinSkills = opts.builtinSkillsDir ?? BUILTIN_SKILLS_DIR;
+        this.containerWorkspace = opts.containerWorkspace;
+        this.pathTranslator = opts.pathTranslator;
+    }
+    toContainerPath(hostPath) {
+        if (this.pathTranslator)
+            return this.pathTranslator(hostPath);
+        if (!this.containerWorkspace)
+            return hostPath;
+        const hostWs = path.resolve(this.workspace);
+        const resolved = path.resolve(hostPath);
+        if (resolved === hostWs)
+            return this.containerWorkspace;
+        if (resolved.startsWith(hostWs + "/"))
+            return this.containerWorkspace + resolved.slice(hostWs.length);
+        return hostPath;
+    }
+    listSkills(filterUnavailable = true) {
+        const skills = [];
+        if (fs.existsSync(this.workspaceSkills)) {
+            for (const entry of fs.readdirSync(this.workspaceSkills)) {
+                const skillDir = path.join(this.workspaceSkills, entry);
+                const skillFile = path.join(skillDir, "SKILL.md");
+                if (fs.statSync(skillDir).isDirectory() && fs.existsSync(skillFile)) {
+                    skills.push({ name: entry, path: skillFile, source: "workspace" });
+                }
+            }
+        }
+        if (this.builtinSkills && fs.existsSync(this.builtinSkills)) {
+            for (const entry of fs.readdirSync(this.builtinSkills)) {
+                const skillDir = path.join(this.builtinSkills, entry);
+                const skillFile = path.join(skillDir, "SKILL.md");
+                if (fs.statSync(skillDir).isDirectory() &&
+                    fs.existsSync(skillFile) &&
+                    !skills.some((s) => s.name === entry)) {
+                    skills.push({ name: entry, path: skillFile, source: "builtin" });
+                }
+            }
+        }
+        if (filterUnavailable) {
+            return skills.filter((s) => this.checkRequirements(this.getSkillMeta(s.name)));
+        }
+        return skills;
+    }
+    loadSkill(name) {
+        const workspaceSkill = path.join(this.workspaceSkills, name, "SKILL.md");
+        if (fs.existsSync(workspaceSkill))
+            return fs.readFileSync(workspaceSkill, "utf-8");
+        if (this.builtinSkills) {
+            const builtinSkill = path.join(this.builtinSkills, name, "SKILL.md");
+            if (fs.existsSync(builtinSkill))
+                return fs.readFileSync(builtinSkill, "utf-8");
+        }
+        return null;
+    }
+    loadSkillsForContext(skillNames) {
+        const parts = [];
+        for (const name of skillNames) {
+            const content = this.loadSkill(name);
+            if (content) {
+                const stripped = this.stripFrontmatter(content);
+                parts.push(`### Skill: ${name}\n\n${stripped}`);
+            }
+        }
+        return parts.join("\n\n---\n\n");
+    }
+    buildSkillsSummary() {
+        const allSkills = this.listSkills(false);
+        if (allSkills.length === 0)
+            return "";
+        const lines = ["<skills>"];
+        for (const s of allSkills) {
+            const meta = this.getSkillMeta(s.name);
+            const available = this.checkRequirements(meta);
+            const description = escapeXml(this.getSkillDescription(s.name));
+            lines.push(`  <skill available="${available}">`);
+            lines.push(`    <name>${escapeXml(s.name)}</name>`);
+            lines.push(`    <description>${description}</description>`);
+            lines.push(`    <location>${this.toContainerPath(s.path)}</location>`);
+            if (!available) {
+                const missing = this.getMissingRequirements(meta);
+                if (missing)
+                    lines.push(`    <requires>${escapeXml(missing)}</requires>`);
+            }
+            lines.push(`  </skill>`);
+        }
+        lines.push("</skills>");
+        return lines.join("\n");
+    }
+    getAlwaysSkills() {
+        return this.listSkills(true)
+            .filter((s) => {
+            const meta = this.getSkillMetadata(s.name);
+            const skillMeta = this.parseNanobotMetadata(meta?.["metadata"] ?? "");
+            return skillMeta["always"] || meta?.["always"];
+        })
+            .map((s) => s.name);
+    }
+    getSkillMetadata(name) {
+        const content = this.loadSkill(name);
+        if (!content)
+            return null;
+        if (content.startsWith("---")) {
+            const match = content.match(/^---\n([\s\S]*?)\n---/);
+            if (match) {
+                const metadata = {};
+                for (const line of match[1].split("\n")) {
+                    const colon = line.indexOf(":");
+                    if (colon > 0) {
+                        metadata[line.slice(0, colon).trim()] = line.slice(colon + 1).trim().replace(/^['"]|['"]$/g, "");
+                    }
+                }
+                return metadata;
+            }
+        }
+        return null;
+    }
+    getSkillMeta(name) {
+        const meta = this.getSkillMetadata(name) ?? {};
+        return this.parseNanobotMetadata(meta["metadata"] ?? "");
+    }
+    parseNanobotMetadata(raw) {
+        try {
+            const data = JSON.parse(raw);
+            return typeof data === "object" && data !== null ? (data["nanobot"] ?? {}) : {};
+        }
+        catch {
+            return {};
+        }
+    }
+    checkRequirements(skillMeta) {
+        const requires = (skillMeta["requires"] ?? {});
+        for (const bin of requires["bins"] ?? []) {
+            if (!commandExists(bin))
+                return false;
+        }
+        for (const env of requires["env"] ?? []) {
+            if (!process.env[env])
+                return false;
+        }
+        return true;
+    }
+    getMissingRequirements(skillMeta) {
+        const missing = [];
+        const requires = (skillMeta["requires"] ?? {});
+        for (const bin of requires["bins"] ?? []) {
+            if (!commandExists(bin))
+                missing.push(`CLI: ${bin}`);
+        }
+        for (const env of requires["env"] ?? []) {
+            if (!process.env[env])
+                missing.push(`ENV: ${env}`);
+        }
+        return missing.join(", ");
+    }
+    getSkillDescription(name) {
+        const meta = this.getSkillMetadata(name);
+        return meta?.["description"] ?? name;
+    }
+    stripFrontmatter(content) {
+        if (content.startsWith("---")) {
+            const match = content.match(/^---\n[\s\S]*?\n---\n/);
+            if (match)
+                return content.slice(match[0].length).trim();
+        }
+        return content;
+    }
+}
+exports.SkillsLoader = SkillsLoader;
+//# sourceMappingURL=skills.js.map

package/dist/agent/skills.js.map

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

package/dist/agent/subagent.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Subagent manager
+ */
+import { MessageBus } from "../bus/queue";
+import type { LLMProvider } from "../providers/base";
+export interface ExecToolConfig {
+    timeout?: number;
+}
+export interface SpawnOptions {
+    task: string;
+    label?: string;
+    originChannel?: string;
+    originChatId?: string;
+}
+export declare class SubagentManager {
+    private provider;
+    private workspace;
+    private bus;
+    private model;
+    private braveApiKey?;
+    private execConfig;
+    private restrictToWorkspace;
+    private runningTasks;
+    constructor(opts: {
+        provider: LLMProvider;
+        workspace: string;
+        bus: MessageBus;
+        model?: string;
+        braveApiKey?: string;
+        execConfig?: ExecToolConfig;
+        restrictToWorkspace?: boolean;
+    });
+    spawn(opts: SpawnOptions): Promise<string>;
+    private _runSubagent;
+    private _announceResult;
+    private _buildSubagentPrompt;
+    getRunningCount(): number;
+}
+//# sourceMappingURL=subagent.d.ts.map

package/dist/agent/subagent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"subagent.d.ts","sourceRoot":"","sources":["../../src/agent/subagent.ts"],"names":[],"mappings":"AAAA;;GAEG;AAKH,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAE1C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAMrD,MAAM,WAAW,cAAc;IAC7B,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAc;IAC9B,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,GAAG,CAAa;IACxB,OAAO,CAAC,KAAK,CAAS;IACtB,OAAO,CAAC,WAAW,CAAC,CAAS;IAC7B,OAAO,CAAC,UAAU,CAAiB;IACnC,OAAO,CAAC,mBAAmB,CAAU;IACrC,OAAO,CAAC,YAAY,CAAyC;gBAEjD,IAAI,EAAE;QAChB,QAAQ,EAAE,WAAW,CAAC;QACtB,SAAS,EAAE,MAAM,CAAC;QAClB,GAAG,EAAE,UAAU,CAAC;QAChB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,UAAU,CAAC,EAAE,cAAc,CAAC;QAC5B,mBAAmB,CAAC,EAAE,OAAO,CAAC;KAC/B;IAUK,KAAK,CAAC,IAAI,EAAE,YAAY,GAAG,OAAO,CAAC,MAAM,CAAC;YAgBlC,YAAY;YAyEZ,eAAe;IAqB7B,OAAO,CAAC,oBAAoB;IA+B5B,eAAe,IAAI,MAAM;CAG1B"}

package/dist/agent/subagent.js

@@ -0,0 +1,151 @@
+"use strict";
+/**
+ * Subagent manager
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SubagentManager = void 0;
+const uuid_1 = require("uuid");
+const logger_1 = __importDefault(require("../utils/logger"));
+const events_1 = require("../bus/events");
+const registry_1 = require("./tools/registry");
+const filesystem_1 = require("./tools/filesystem");
+const shell_1 = require("./tools/shell");
+const web_1 = require("./tools/web");
+class SubagentManager {
+    provider;
+    workspace;
+    bus;
+    model;
+    braveApiKey;
+    execConfig;
+    restrictToWorkspace;
+    runningTasks = new Map();
+    constructor(opts) {
+        this.provider = opts.provider;
+        this.workspace = opts.workspace;
+        this.bus = opts.bus;
+        this.model = opts.model ?? opts.provider.getDefaultModel();
+        this.braveApiKey = opts.braveApiKey;
+        this.execConfig = opts.execConfig ?? {};
+        this.restrictToWorkspace = opts.restrictToWorkspace ?? false;
+    }
+    async spawn(opts) {
+        const taskId = (0, uuid_1.v4)().slice(0, 8);
+        const { task, label, originChannel = "cli", originChatId = "direct" } = opts;
+        const displayLabel = label ?? (task.length > 30 ? task.slice(0, 30) + "..." : task);
+        const origin = { channel: originChannel, chatId: originChatId };
+        const taskPromise = this._runSubagent(taskId, task, displayLabel, origin).then(() => {
+            this.runningTasks.delete(taskId);
+        });
+        this.runningTasks.set(taskId, taskPromise);
+        logger_1.default.info(`Spawned subagent [${taskId}]: ${displayLabel}`);
+        return `Subagent [${displayLabel}] started (id: ${taskId}). I'll notify you when it completes.`;
+    }
+    async _runSubagent(taskId, task, label, origin) {
+        logger_1.default.info(`Subagent [${taskId}] starting task: ${label}`);
+        try {
+            const tools = new registry_1.ToolRegistry();
+            const allowedDir = this.restrictToWorkspace ? this.workspace : undefined;
+            tools.register(new filesystem_1.ReadFileTool({ allowedDir }));
+            tools.register(new filesystem_1.WriteFileTool({ allowedDir }));
+            tools.register(new filesystem_1.ListDirTool({ allowedDir }));
+            tools.register(new shell_1.ExecTool({
+                workingDir: this.workspace,
+                timeout: this.execConfig.timeout,
+                restrictToWorkspace: this.restrictToWorkspace,
+            }));
+            tools.register(new web_1.WebSearchTool({ apiKey: this.braveApiKey }));
+            tools.register(new web_1.WebFetchTool());
+            const systemPrompt = this._buildSubagentPrompt(task);
+            const messages = [
+                { role: "system", content: systemPrompt },
+                { role: "user", content: task },
+            ];
+            let finalResult = null;
+            const maxIterations = 15;
+            for (let i = 0; i < maxIterations; i++) {
+                const response = await this.provider.chat(messages, { tools: tools.getDefinitions(), model: this.model });
+                if (response.toolCalls.length > 0) {
+                    const toolCallDicts = response.toolCalls.map((tc) => ({
+                        id: tc.id,
+                        type: "function",
+                        function: { name: tc.name, arguments: JSON.stringify(tc.arguments) },
+                    }));
+                    messages.push({
+                        role: "assistant",
+                        content: response.content ?? "",
+                        tool_calls: toolCallDicts,
+                    });
+                    for (const tc of response.toolCalls) {
+                        logger_1.default.debug(`Subagent [${taskId}] executing: ${tc.name}`);
+                        const result = await tools.execute(tc.name, tc.arguments);
+                        messages.push({ role: "tool", tool_call_id: tc.id, name: tc.name, content: result });
+                    }
+                }
+                else {
+                    finalResult = response.content ?? null;
+                    break;
+                }
+            }
+            if (finalResult === null)
+                finalResult = "Task completed but no final response was generated.";
+            logger_1.default.info(`Subagent [${taskId}] completed successfully`);
+            await this._announceResult(taskId, label, task, finalResult, origin, "ok");
+        }
+        catch (e) {
+            const errMsg = `Error: ${String(e)}`;
+            logger_1.default.error(`Subagent [${taskId}] failed: ${e}`);
+            await this._announceResult(taskId, label, task, errMsg, origin, "error");
+        }
+    }
+    async _announceResult(taskId, label, task, result, origin, status) {
+        const statusText = status === "ok" ? "completed successfully" : "failed";
+        const content = `[Subagent '${label}' ${statusText}]\n\nTask: ${task}\n\nResult:\n${result}\n\nSummarize this naturally for the user. Keep it brief (1-2 sentences). Do not mention technical details like "subagent" or task IDs.`;
+        const msg = (0, events_1.makeInboundMessage)({
+            channel: "system",
+            senderId: "subagent",
+            chatId: `${origin.channel}:${origin.chatId}`,
+            content,
+        });
+        await this.bus.publishInbound(msg);
+        logger_1.default.debug(`Subagent [${taskId}] announced result to ${origin.channel}:${origin.chatId}`);
+    }
+    _buildSubagentPrompt(task) {
+        return `# Subagent
+
+You are a subagent spawned by the main agent to complete a specific task.
+
+## Your Task
+${task}
+
+## Rules
+1. Stay focused - complete only the assigned task, nothing else
+2. Your final response will be reported back to the main agent
+3. Do not initiate conversations or take on side tasks
+4. Be concise but informative in your findings
+
+## What You Can Do
+- Read and write files in the workspace
+- Execute shell commands
+- Search the web and fetch web pages
+- Complete the task thoroughly
+
+## What You Cannot Do
+- Send messages directly to users (no message tool available)
+- Spawn other subagents
+- Access the main agent's conversation history
+
+## Workspace
+Your workspace is at: ${this.workspace}
+
+When you have completed the task, provide a clear summary of your findings or actions.`;
+    }
+    getRunningCount() {
+        return this.runningTasks.size;
+    }
+}
+exports.SubagentManager = SubagentManager;
+//# sourceMappingURL=subagent.js.map

package/dist/agent/subagent.js.map

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

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

@@ -0,0 +1,32 @@
+/**
+ * Base class for agent tools
+ */
+export type JSONSchemaType = "string" | "integer" | "number" | "boolean" | "array" | "object";
+export interface JSONSchema {
+    type?: JSONSchemaType;
+    properties?: Record<string, JSONSchema>;
+    required?: string[];
+    items?: JSONSchema;
+    enum?: unknown[];
+    minimum?: number;
+    maximum?: number;
+    minLength?: number;
+    maxLength?: number;
+    description?: string;
+    default?: unknown;
+    [key: string]: unknown;
+}
+/**
+ * Abstract base class for agent tools.
+ */
+export declare abstract class Tool {
+    abstract get name(): string;
+    abstract get description(): string;
+    abstract get parameters(): JSONSchema;
+    abstract execute(params: Record<string, unknown>): Promise<string>;
+    validateParams(params: Record<string, unknown>): string[];
+    private _validate;
+    private _checkType;
+    toSchema(): Record<string, unknown>;
+}
+//# sourceMappingURL=base.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../../src/agent/tools/base.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,MAAM,cAAc,GAAG,QAAQ,GAAG,SAAS,GAAG,QAAQ,GAAG,SAAS,GAAG,OAAO,GAAG,QAAQ,CAAC;AAE9F,MAAM,WAAW,UAAU;IACzB,IAAI,CAAC,EAAE,cAAc,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IACxC,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,KAAK,CAAC,EAAE,UAAU,CAAC;IACnB,IAAI,CAAC,EAAE,OAAO,EAAE,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED;;GAEG;AACH,8BAAsB,IAAI;IACxB,QAAQ,KAAK,IAAI,IAAI,MAAM,CAAC;IAC5B,QAAQ,KAAK,WAAW,IAAI,MAAM,CAAC;IACnC,QAAQ,KAAK,UAAU,IAAI,UAAU,CAAC;IAEtC,QAAQ,CAAC,OAAO,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC;IAElE,cAAc,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,EAAE;IAKzD,OAAO,CAAC,SAAS;IAwDjB,OAAO,CAAC,UAAU;IAiBlB,QAAQ,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAUpC"}

package/dist/agent/tools/base.js

@@ -0,0 +1,91 @@
+"use strict";
+/**
+ * Base class for agent tools
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Tool = void 0;
+/**
+ * Abstract base class for agent tools.
+ */
+class Tool {
+    validateParams(params) {
+        const schema = this.parameters ?? {};
+        return this._validate(params, { ...schema, type: "object" }, "");
+    }
+    _validate(val, schema, path) {
+        const label = path || "parameter";
+        const errors = [];
+        if (schema.type) {
+            const typeOk = this._checkType(val, schema.type);
+            if (!typeOk) {
+                errors.push(`${label} should be ${schema.type}`);
+                return errors;
+            }
+        }
+        if (schema.enum !== undefined && !schema.enum.includes(val)) {
+            errors.push(`${label} must be one of ${JSON.stringify(schema.enum)}`);
+        }
+        if (schema.type === "integer" || schema.type === "number") {
+            const n = val;
+            if (schema.minimum !== undefined && n < schema.minimum)
+                errors.push(`${label} must be >= ${schema.minimum}`);
+            if (schema.maximum !== undefined && n > schema.maximum)
+                errors.push(`${label} must be <= ${schema.maximum}`);
+        }
+        if (schema.type === "string") {
+            const s = val;
+            if (schema.minLength !== undefined && s.length < schema.minLength)
+                errors.push(`${label} must be at least ${schema.minLength} chars`);
+            if (schema.maxLength !== undefined && s.length > schema.maxLength)
+                errors.push(`${label} must be at most ${schema.maxLength} chars`);
+        }
+        if (schema.type === "object" && typeof val === "object" && val !== null) {
+            const obj = val;
+            const props = schema.properties ?? {};
+            for (const k of schema.required ?? []) {
+                if (!(k in obj)) {
+                    errors.push(`missing required ${path ? path + "." + k : k}`);
+                }
+            }
+            for (const [k, v] of Object.entries(obj)) {
+                if (k in props) {
+                    errors.push(...this._validate(v, props[k], path ? `${path}.${k}` : k));
+                }
+            }
+        }
+        if (schema.type === "array" && schema.items && Array.isArray(val)) {
+            for (let i = 0; i < val.length; i++) {
+                errors.push(...this._validate(val[i], schema.items, path ? `${path}[${i}]` : `[${i}]`));
+            }
+        }
+        return errors;
+    }
+    _checkType(val, type) {
+        switch (type) {
+            case "string":
+                return typeof val === "string";
+            case "integer":
+                return typeof val === "number" && Number.isInteger(val);
+            case "number":
+                return typeof val === "number";
+            case "boolean":
+                return typeof val === "boolean";
+            case "array":
+                return Array.isArray(val);
+            case "object":
+                return typeof val === "object" && val !== null && !Array.isArray(val);
+        }
+    }
+    toSchema() {
+        return {
+            type: "function",
+            function: {
+                name: this.name,
+                description: this.description,
+                parameters: this.parameters,
+            },
+        };
+    }
+}
+exports.Tool = Tool;
+//# sourceMappingURL=base.js.map

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

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

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

@@ -0,0 +1,46 @@
+/**
+ * Cron tool
+ */
+import { Tool } from "./base";
+import { CronService } from "../../cron/service";
+export declare class CronTool extends Tool {
+    private cron;
+    private channel;
+    private chatId;
+    constructor(cronService: CronService);
+    setContext(channel: string, chatId: string): void;
+    get name(): string;
+    get description(): string;
+    get parameters(): {
+        type: "object";
+        properties: {
+            action: {
+                type: "string";
+                enum: string[];
+                description: string;
+            };
+            message: {
+                type: "string";
+                description: string;
+            };
+            every_seconds: {
+                type: "integer";
+                description: string;
+            };
+            cron_expr: {
+                type: "string";
+                description: string;
+            };
+            job_id: {
+                type: "string";
+                description: string;
+            };
+        };
+        required: string[];
+    };
+    execute(params: Record<string, unknown>): Promise<string>;
+    private _addJob;
+    private _listJobs;
+    private _removeJob;
+}
+//# sourceMappingURL=cron.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"cron.d.ts","sourceRoot":"","sources":["../../../src/agent/tools/cron.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAC9B,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAGjD,qBAAa,QAAS,SAAQ,IAAI;IAChC,OAAO,CAAC,IAAI,CAAc;IAC1B,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,MAAM,CAAS;gBAEX,WAAW,EAAE,WAAW;IAOpC,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI;IAKjD,IAAI,IAAI,IAAI,MAAM,CAAmB;IACrC,IAAI,WAAW,IAAI,MAAM,CAAkF;IAC3G,IAAI,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;MAgBb;IAEK,OAAO,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC;IAQ/D,OAAO,CAAC,OAAO;IA4Bf,OAAO,CAAC,SAAS;IAOjB,OAAO,CAAC,UAAU;CAKnB"}