azerclaw 1.0.0

package/dist/src/skills/loader.js

@@ -0,0 +1,165 @@
+"use strict";
+/**
+ * 🐟 AZERCLAW Skills System
+ * Load and execute SKILL.md files compatible with the OpenClaw ecosystem.
+ */
+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.loadAllSkills = loadAllSkills;
+exports.formatSkillsForPrompt = formatSkillsForPrompt;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const os = __importStar(require("os"));
+// ─── Skill Discovery Paths (priority order) ────────────────────
+function getSkillPaths(workspaceDir) {
+    const paths = [];
+    if (workspaceDir) {
+        paths.push({ path: path.join(workspaceDir, 'skills'), source: 'workspace' });
+        paths.push({ path: path.join(workspaceDir, '.agents', 'skills'), source: 'project' });
+    }
+    paths.push({ path: path.join(os.homedir(), '.agents', 'skills'), source: 'personal' });
+    paths.push({ path: path.join(os.homedir(), '.azerclaw', 'skills'), source: 'managed' });
+    paths.push({ path: path.join(__dirname, '..', '..', 'skills'), source: 'bundled' });
+    return paths;
+}
+// ─── SKILL.md Parser ────────────────────────────────────────────
+function parseSkillFile(filePath, source) {
+    try {
+        const content = fs.readFileSync(filePath, 'utf-8');
+        // Parse YAML frontmatter
+        const frontmatterMatch = content.match(/^---\n([\s\S]*?)\n---\n([\s\S]*)$/);
+        let metadata;
+        let instructions;
+        if (frontmatterMatch) {
+            metadata = parseYamlFrontmatter(frontmatterMatch[1]);
+            instructions = frontmatterMatch[2].trim();
+        }
+        else {
+            // No frontmatter — use filename as name
+            const name = path.basename(path.dirname(filePath));
+            metadata = { name, description: `Skill: ${name}` };
+            instructions = content.trim();
+        }
+        return { metadata, instructions, filePath, source };
+    }
+    catch {
+        return null;
+    }
+}
+function parseYamlFrontmatter(yaml) {
+    const metadata = { name: '', description: '' };
+    for (const line of yaml.split('\n')) {
+        const colonIdx = line.indexOf(':');
+        if (colonIdx === -1)
+            continue;
+        const key = line.slice(0, colonIdx).trim().toLowerCase();
+        const value = line.slice(colonIdx + 1).trim();
+        switch (key) {
+            case 'name':
+                metadata.name = value;
+                break;
+            case 'description':
+                metadata.description = value;
+                break;
+            case 'version':
+                metadata.version = value;
+                break;
+            case 'author':
+                metadata.author = value;
+                break;
+            case 'tags':
+                metadata.tags = value.split(',').map(t => t.trim());
+                break;
+            case 'os':
+                metadata.os = value.split(',').map(t => t.trim());
+                break;
+            case 'requires':
+                metadata.requires = value.split(',').map(t => t.trim());
+                break;
+        }
+    }
+    return metadata;
+}
+// ─── Skill Loader ───────────────────────────────────────────────
+function loadAllSkills(workspaceDir) {
+    const skills = [];
+    const seen = new Set();
+    for (const { path: skillDir, source } of getSkillPaths(workspaceDir)) {
+        if (!fs.existsSync(skillDir))
+            continue;
+        try {
+            const entries = fs.readdirSync(skillDir, { withFileTypes: true });
+            for (const entry of entries) {
+                if (!entry.isDirectory())
+                    continue;
+                const skillFile = path.join(skillDir, entry.name, 'SKILL.md');
+                if (!fs.existsSync(skillFile))
+                    continue;
+                // Higher-priority sources override lower-priority
+                if (seen.has(entry.name))
+                    continue;
+                const skill = parseSkillFile(skillFile, source);
+                if (skill) {
+                    // Check OS compatibility
+                    if (skill.metadata.os && !skill.metadata.os.includes(process.platform)) {
+                        continue;
+                    }
+                    skills.push(skill);
+                    seen.add(entry.name);
+                }
+            }
+        }
+        catch {
+            // Skip inaccessible directories
+        }
+    }
+    return skills;
+}
+/**
+ * Format skills as context for the agent system prompt.
+ */
+function formatSkillsForPrompt(skills) {
+    if (skills.length === 0)
+        return '';
+    let context = '\n\n## Available Skills\n\n';
+    for (const skill of skills) {
+        context += `### ${skill.metadata.name}\n`;
+        context += `${skill.metadata.description}\n`;
+        context += `Source: ${skill.source}\n\n`;
+        context += `Instructions:\n${skill.instructions}\n\n---\n\n`;
+    }
+    return context;
+}
+//# sourceMappingURL=loader.js.map

package/dist/src/skills/loader.js.map

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

package/dist/src/tools/advanced.d.ts

@@ -0,0 +1,15 @@
+/**
+ * 🐟 AZERCLAW Sub-Agent Tool
+ * Allows the main agent to spawn sub-agents for parallel task execution.
+ */
+import { Tool } from './registry';
+export declare const spawnSubAgentTool: Tool;
+/**
+ * Web search tool for information retrieval
+ */
+export declare const webSearchTool: Tool;
+/**
+ * Code analysis tool
+ */
+export declare const codeAnalysisTool: Tool;
+//# sourceMappingURL=advanced.d.ts.map

package/dist/src/tools/advanced.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"advanced.d.ts","sourceRoot":"","sources":["../../../src/tools/advanced.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,IAAI,EAAc,MAAM,YAAY,CAAC;AAE9C,eAAO,MAAM,iBAAiB,EAAE,IA8B/B,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,aAAa,EAAE,IAyB3B,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,gBAAgB,EAAE,IA+B9B,CAAC"}

package/dist/src/tools/advanced.js

@@ -0,0 +1,102 @@
+"use strict";
+/**
+ * 🐟 AZERCLAW Sub-Agent Tool
+ * Allows the main agent to spawn sub-agents for parallel task execution.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.codeAnalysisTool = exports.webSearchTool = exports.spawnSubAgentTool = void 0;
+exports.spawnSubAgentTool = {
+    name: 'spawn_sub_agent',
+    description: `Spawn a sub-agent to handle a specific subtask in parallel. Use this for:
+- Breaking large tasks into parallel workstreams
+- Delegating research while you continue coding
+- Running independent analyses simultaneously
+- Code review while implementing changes
+The sub-agent has full access to all tools.`,
+    parameters: {
+        type: 'object',
+        properties: {
+            task: {
+                type: 'string',
+                description: 'Clear, detailed description of the task for the sub-agent',
+            },
+            systemPrompt: {
+                type: 'string',
+                description: 'Optional custom system prompt for the sub-agent',
+            },
+            maxIterations: {
+                type: 'number',
+                description: 'Max iterations for the sub-agent (default: 10)',
+            },
+        },
+        required: ['task'],
+    },
+    // execute is handled specially by the runtime
+    async execute() {
+        return { success: false, output: '', error: 'Sub-agent tool must be handled by runtime' };
+    },
+};
+/**
+ * Web search tool for information retrieval
+ */
+exports.webSearchTool = {
+    name: 'web_search',
+    description: 'Search the web for information. Returns relevant results.',
+    parameters: {
+        type: 'object',
+        properties: {
+            query: { type: 'string', description: 'Search query' },
+            maxResults: { type: 'number', description: 'Max results to return (default: 5)' },
+        },
+        required: ['query'],
+    },
+    async execute(args) {
+        // Uses DuckDuckGo HTML search (no API key needed)
+        const query = encodeURIComponent(args.query);
+        try {
+            const { execSync } = require('child_process');
+            const result = execSync(`curl -sL "https://html.duckduckgo.com/html/?q=${query}" | grep -oP '<a rel="nofollow" class="result__a" href="[^"]*">[^<]*</a>' | head -${args.maxResults || 5} | sed 's/<[^>]*>//g'`, { encoding: 'utf-8', timeout: 10000 });
+            return { success: true, output: result.trim() || 'No results found' };
+        }
+        catch {
+            return { success: true, output: 'Web search unavailable in current environment' };
+        }
+    },
+};
+/**
+ * Code analysis tool
+ */
+exports.codeAnalysisTool = {
+    name: 'analyze_code',
+    description: 'Analyze a codebase directory — count files, detect languages, find entry points.',
+    parameters: {
+        type: 'object',
+        properties: {
+            path: { type: 'string', description: 'Directory to analyze' },
+        },
+        required: ['path'],
+    },
+    async execute(args) {
+        const { execSync } = require('child_process');
+        const dir = args.path;
+        try {
+            const analysis = execSync(`
+        echo "=== Directory: ${dir} ==="
+        echo ""
+        echo "--- File counts by extension ---"
+        find "${dir}" -type f -not -path '*/node_modules/*' -not -path '*/.git/*' | sed 's/.*\\.//' | sort | uniq -c | sort -rn | head -20
+        echo ""
+        echo "--- Total files ---"
+        find "${dir}" -type f -not -path '*/node_modules/*' -not -path '*/.git/*' | wc -l
+        echo ""
+        echo "--- Package files ---"
+        find "${dir}" -maxdepth 2 -name "package.json" -o -name "Cargo.toml" -o -name "go.mod" -o -name "requirements.txt" -o -name "Gemfile" 2>/dev/null | head -10
+      `, { encoding: 'utf-8', timeout: 15000, cwd: dir });
+            return { success: true, output: analysis.trim() };
+        }
+        catch (e) {
+            return { success: false, output: '', error: e.message };
+        }
+    },
+};
+//# sourceMappingURL=advanced.js.map

package/dist/src/tools/advanced.js.map

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

package/dist/src/tools/filesystem.d.ts

@@ -0,0 +1,10 @@
+/**
+ * 🐟 AZERCLAW Filesystem Tools
+ * Read, write, search, and manage files.
+ */
+import { Tool } from './registry';
+export declare const readFileTool: Tool;
+export declare const writeFileTool: Tool;
+export declare const listDirTool: Tool;
+export declare const searchFilesTool: Tool;
+//# sourceMappingURL=filesystem.d.ts.map

package/dist/src/tools/filesystem.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"filesystem.d.ts","sourceRoot":"","sources":["../../../src/tools/filesystem.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,OAAO,EAAE,IAAI,EAAc,MAAM,YAAY,CAAC;AAE9C,eAAO,MAAM,YAAY,EAAE,IA2B1B,CAAC;AAEF,eAAO,MAAM,aAAa,EAAE,IAwB3B,CAAC;AAEF,eAAO,MAAM,WAAW,EAAE,IAwBzB,CAAC;AAEF,eAAO,MAAM,eAAe,EAAE,IAuB7B,CAAC"}

package/dist/src/tools/filesystem.js

@@ -0,0 +1,160 @@
+"use strict";
+/**
+ * 🐟 AZERCLAW Filesystem Tools
+ * Read, write, search, and manage files.
+ */
+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.searchFilesTool = exports.listDirTool = exports.writeFileTool = exports.readFileTool = void 0;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+exports.readFileTool = {
+    name: 'read_file',
+    description: 'Read the contents of a file from disk.',
+    parameters: {
+        type: 'object',
+        properties: {
+            path: { type: 'string', description: 'Absolute or relative path to the file' },
+            startLine: { type: 'number', description: 'Start line (1-indexed, optional)' },
+            endLine: { type: 'number', description: 'End line (1-indexed, optional)' },
+        },
+        required: ['path'],
+    },
+    async execute(args) {
+        const filePath = args.path;
+        try {
+            const resolved = path.resolve(filePath);
+            if (!fs.existsSync(resolved))
+                return { success: false, output: '', error: `File not found: ${resolved}` };
+            let content = fs.readFileSync(resolved, 'utf-8');
+            if (args.startLine || args.endLine) {
+                const lines = content.split('\n');
+                const start = Math.max(0, (args.startLine || 1) - 1);
+                const end = Math.min(lines.length, args.endLine || lines.length);
+                content = lines.slice(start, end).join('\n');
+            }
+            return { success: true, output: content };
+        }
+        catch (e) {
+            return { success: false, output: '', error: e.message };
+        }
+    },
+};
+exports.writeFileTool = {
+    name: 'write_file',
+    description: 'Write content to a file. Creates parent directories if needed.',
+    parameters: {
+        type: 'object',
+        properties: {
+            path: { type: 'string', description: 'Path to the file' },
+            content: { type: 'string', description: 'Content to write' },
+            append: { type: 'boolean', description: 'Append instead of overwrite (default: false)' },
+        },
+        required: ['path', 'content'],
+    },
+    async execute(args) {
+        const filePath = path.resolve(args.path);
+        try {
+            fs.mkdirSync(path.dirname(filePath), { recursive: true });
+            if (args.append) {
+                fs.appendFileSync(filePath, args.content);
+            }
+            else {
+                fs.writeFileSync(filePath, args.content);
+            }
+            return { success: true, output: `Written to ${filePath}` };
+        }
+        catch (e) {
+            return { success: false, output: '', error: e.message };
+        }
+    },
+};
+exports.listDirTool = {
+    name: 'list_directory',
+    description: 'List files and directories in a given path.',
+    parameters: {
+        type: 'object',
+        properties: {
+            path: { type: 'string', description: 'Directory path' },
+            recursive: { type: 'boolean', description: 'List recursively (default: false)' },
+        },
+        required: ['path'],
+    },
+    async execute(args) {
+        const dirPath = path.resolve(args.path);
+        try {
+            if (!fs.existsSync(dirPath))
+                return { success: false, output: '', error: `Not found: ${dirPath}` };
+            const entries = fs.readdirSync(dirPath, { withFileTypes: true });
+            const listing = entries.map(e => {
+                const type = e.isDirectory() ? '[DIR]' : '[FILE]';
+                const size = e.isFile() ? ` (${fs.statSync(path.join(dirPath, e.name)).size}b)` : '';
+                return `${type} ${e.name}${size}`;
+            }).join('\n');
+            return { success: true, output: listing };
+        }
+        catch (e) {
+            return { success: false, output: '', error: e.message };
+        }
+    },
+};
+exports.searchFilesTool = {
+    name: 'search_files',
+    description: 'Search for a text pattern in files using grep-like functionality.',
+    parameters: {
+        type: 'object',
+        properties: {
+            pattern: { type: 'string', description: 'Text or regex pattern to search for' },
+            path: { type: 'string', description: 'Directory or file to search in' },
+            filePattern: { type: 'string', description: 'Glob pattern for file filtering (e.g. "*.ts")' },
+        },
+        required: ['pattern', 'path'],
+    },
+    async execute(args) {
+        const searchPath = path.resolve(args.path);
+        const pattern = args.pattern;
+        try {
+            const { execSync } = require('child_process');
+            const fileFilter = args.filePattern ? `--include="${args.filePattern}"` : '';
+            const cmd = `grep -rnI ${fileFilter} "${pattern}" "${searchPath}" 2>/dev/null | head -50`;
+            const output = execSync(cmd, { encoding: 'utf-8', timeout: 10000 });
+            return { success: true, output: output.trim() || 'No matches found' };
+        }
+        catch {
+            return { success: true, output: 'No matches found' };
+        }
+    },
+};
+//# sourceMappingURL=filesystem.js.map

package/dist/src/tools/filesystem.js.map

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

package/dist/src/tools/registry.d.ts

@@ -0,0 +1,26 @@
+/**
+ * 🐟 AZERCLAW Tool Registry
+ * Manages all available tools that the agent can use.
+ */
+export interface ToolResult {
+    success: boolean;
+    output: string;
+    error?: string;
+}
+export interface Tool {
+    name: string;
+    description: string;
+    parameters: Record<string, unknown>;
+    execute(args: Record<string, unknown>): Promise<ToolResult>;
+}
+declare class ToolRegistry {
+    private tools;
+    register(tool: Tool): void;
+    get(name: string): Tool | undefined;
+    getAll(): Tool[];
+    getDefinitions(): any[];
+    execute(name: string, args: Record<string, unknown>): Promise<ToolResult>;
+}
+export declare function getToolRegistry(): ToolRegistry;
+export { ToolRegistry };
+//# sourceMappingURL=registry.d.ts.map

package/dist/src/tools/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../../src/tools/registry.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,IAAI;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACpC,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;CAC7D;AAED,cAAM,YAAY;IAChB,OAAO,CAAC,KAAK,CAAgC;IAE7C,QAAQ,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI;IAI1B,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS;IAInC,MAAM,IAAI,IAAI,EAAE;IAIhB,cAAc,IAAI,GAAG,EAAE;IAWjB,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,UAAU,CAAC;CAShF;AAGD,wBAAgB,eAAe,IAAI,YAAY,CAG9C;AACD,OAAO,EAAE,YAAY,EAAE,CAAC"}

package/dist/src/tools/registry.js

@@ -0,0 +1,49 @@
+"use strict";
+/**
+ * 🐟 AZERCLAW Tool Registry
+ * Manages all available tools that the agent can use.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ToolRegistry = void 0;
+exports.getToolRegistry = getToolRegistry;
+class ToolRegistry {
+    tools = new Map();
+    register(tool) {
+        this.tools.set(tool.name, tool);
+    }
+    get(name) {
+        return this.tools.get(name);
+    }
+    getAll() {
+        return Array.from(this.tools.values());
+    }
+    getDefinitions() {
+        return this.getAll().map(tool => ({
+            type: 'function',
+            function: {
+                name: tool.name,
+                description: tool.description,
+                parameters: tool.parameters,
+            },
+        }));
+    }
+    async execute(name, args) {
+        const tool = this.tools.get(name);
+        if (!tool)
+            return { success: false, output: '', error: `Unknown tool: ${name}` };
+        try {
+            return await tool.execute(args);
+        }
+        catch (error) {
+            return { success: false, output: '', error: error.message || 'Tool execution failed' };
+        }
+    }
+}
+exports.ToolRegistry = ToolRegistry;
+let instance = null;
+function getToolRegistry() {
+    if (!instance)
+        instance = new ToolRegistry();
+    return instance;
+}
+//# sourceMappingURL=registry.js.map

package/dist/src/tools/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../../src/tools/registry.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;AAqDH,0CAGC;AAzCD,MAAM,YAAY;IACR,KAAK,GAAsB,IAAI,GAAG,EAAE,CAAC;IAE7C,QAAQ,CAAC,IAAU;QACjB,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IAClC,CAAC;IAED,GAAG,CAAC,IAAY;QACd,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAC9B,CAAC;IAED,MAAM;QACJ,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC;IACzC,CAAC;IAED,cAAc;QACZ,OAAO,IAAI,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YAChC,IAAI,EAAE,UAAU;YAChB,QAAQ,EAAE;gBACR,IAAI,EAAE,IAAI,CAAC,IAAI;gBACf,WAAW,EAAE,IAAI,CAAC,WAAW;gBAC7B,UAAU,EAAE,IAAI,CAAC,UAAU;aAC5B;SACF,CAAC,CAAC,CAAC;IACN,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,IAAY,EAAE,IAA6B;QACvD,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAClC,IAAI,CAAC,IAAI;YAAE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE,KAAK,EAAE,iBAAiB,IAAI,EAAE,EAAE,CAAC;QACjF,IAAI,CAAC;YACH,OAAO,MAAM,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QAClC,CAAC;QAAC,OAAO,KAAU,EAAE,CAAC;YACpB,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,CAAC,OAAO,IAAI,uBAAuB,EAAE,CAAC;QACzF,CAAC;IACH,CAAC;CACF;AAOQ,oCAAY;AALrB,IAAI,QAAQ,GAAwB,IAAI,CAAC;AACzC,SAAgB,eAAe;IAC7B,IAAI,CAAC,QAAQ;QAAE,QAAQ,GAAG,IAAI,YAAY,EAAE,CAAC;IAC7C,OAAO,QAAQ,CAAC;AAClB,CAAC"}

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

@@ -0,0 +1,7 @@
+/**
+ * 🐟 AZERCLAW Shell Tool
+ * Execute shell commands with safety checks.
+ */
+import { Tool } from './registry';
+export declare const shellTool: Tool;
+//# sourceMappingURL=shell.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"shell.d.ts","sourceRoot":"","sources":["../../../src/tools/shell.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,IAAI,EAAc,MAAM,YAAY,CAAC;AAE9C,eAAO,MAAM,SAAS,EAAE,IAoCvB,CAAC"}

package/dist/src/tools/shell.js

@@ -0,0 +1,46 @@
+"use strict";
+/**
+ * 🐟 AZERCLAW Shell Tool
+ * Execute shell commands with safety checks.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.shellTool = void 0;
+const child_process_1 = require("child_process");
+exports.shellTool = {
+    name: 'run_shell',
+    description: 'Execute a shell command on the local system. Use this for running scripts, installing packages, git operations, file manipulation, and system tasks.',
+    parameters: {
+        type: 'object',
+        properties: {
+            command: { type: 'string', description: 'The shell command to execute' },
+            cwd: { type: 'string', description: 'Working directory (optional)' },
+            timeout: { type: 'number', description: 'Timeout in milliseconds (default: 30000)' },
+        },
+        required: ['command'],
+    },
+    async execute(args) {
+        const command = args.command;
+        const cwd = args.cwd || process.cwd();
+        const timeout = args.timeout || 30000;
+        try {
+            const output = (0, child_process_1.execSync)(command, {
+                cwd,
+                timeout,
+                encoding: 'utf-8',
+                maxBuffer: 1024 * 1024 * 10, // 10MB
+                stdio: ['pipe', 'pipe', 'pipe'],
+            });
+            return { success: true, output: output.trim() };
+        }
+        catch (error) {
+            const stderr = error.stderr?.toString() || '';
+            const stdout = error.stdout?.toString() || '';
+            return {
+                success: false,
+                output: stdout,
+                error: stderr || error.message || 'Command failed',
+            };
+        }
+    },
+};
+//# sourceMappingURL=shell.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"shell.js","sourceRoot":"","sources":["../../../src/tools/shell.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;AAEH,iDAAgD;AAGnC,QAAA,SAAS,GAAS;IAC7B,IAAI,EAAE,WAAW;IACjB,WAAW,EAAE,sJAAsJ;IACnK,UAAU,EAAE;QACV,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,8BAA8B,EAAE;YACxE,GAAG,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,8BAA8B,EAAE;YACpE,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,0CAA0C,EAAE;SACrF;QACD,QAAQ,EAAE,CAAC,SAAS,CAAC;KACtB;IACD,KAAK,CAAC,OAAO,CAAC,IAA6B;QACzC,MAAM,OAAO,GAAG,IAAI,CAAC,OAAiB,CAAC;QACvC,MAAM,GAAG,GAAI,IAAI,CAAC,GAAc,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;QAClD,MAAM,OAAO,GAAI,IAAI,CAAC,OAAkB,IAAI,KAAK,CAAC;QAElD,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,IAAA,wBAAQ,EAAC,OAAO,EAAE;gBAC/B,GAAG;gBACH,OAAO;gBACP,QAAQ,EAAE,OAAO;gBACjB,SAAS,EAAE,IAAI,GAAG,IAAI,GAAG,EAAE,EAAE,OAAO;gBACpC,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC;aAChC,CAAC,CAAC;YACH,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,IAAI,EAAE,EAAE,CAAC;QAClD,CAAC;QAAC,OAAO,KAAU,EAAE,CAAC;YACpB,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;YAC9C,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;YAC9C,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,MAAM,EAAE,MAAM;gBACd,KAAK,EAAE,MAAM,IAAI,KAAK,CAAC,OAAO,IAAI,gBAAgB;aACnD,CAAC;QACJ,CAAC;IACH,CAAC;CACF,CAAC"}