azerclaw 1.0.0

package/dist/src/providers/router.js

@@ -0,0 +1,156 @@
+"use strict";
+/**
+ * 🐟 AZERCLAW Multi-Provider LLM Router
+ * Routes requests to the best available provider with automatic fallback.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ProviderRouter = void 0;
+exports.getRouter = getRouter;
+exports.resetRouter = resetRouter;
+const openai_1 = require("./openai");
+const anthropic_1 = require("./anthropic");
+const google_1 = require("./google");
+const ollama_1 = require("./ollama");
+const manager_1 = require("../config/manager");
+class ProviderRouter {
+    providers = new Map();
+    fallbackChain;
+    constructor() {
+        const config = (0, manager_1.getConfigManager)();
+        const aiConfig = config.getAll().ai;
+        this.fallbackChain = aiConfig.fallbackChain;
+        this.initProviders(aiConfig);
+    }
+    initProviders(aiConfig) {
+        const p = aiConfig.providers;
+        if (p.openai.enabled && p.openai.apiKey) {
+            this.providers.set('openai', new openai_1.OpenAIProvider(p.openai));
+        }
+        if (p.anthropic.enabled && p.anthropic.apiKey) {
+            this.providers.set('anthropic', new anthropic_1.AnthropicProvider(p.anthropic));
+        }
+        if (p.google.enabled && p.google.apiKey) {
+            this.providers.set('google', new google_1.GoogleProvider(p.google));
+        }
+        if (p.ollama.enabled) {
+            this.providers.set('ollama', new ollama_1.OllamaProvider(p.ollama));
+        }
+        if (p.groq.enabled && p.groq.apiKey) {
+            // Groq uses OpenAI-compatible API
+            this.providers.set('groq', new openai_1.OpenAIProvider({ apiKey: p.groq.apiKey, baseUrl: p.groq.baseUrl, defaultModel: p.groq.defaultModel }));
+        }
+        if (p.deepseek.enabled && p.deepseek.apiKey) {
+            this.providers.set('deepseek', new openai_1.OpenAIProvider({ apiKey: p.deepseek.apiKey, baseUrl: p.deepseek.baseUrl, defaultModel: p.deepseek.defaultModel }));
+        }
+        if (p.openrouter.enabled && p.openrouter.apiKey) {
+            this.providers.set('openrouter', new openai_1.OpenAIProvider({ apiKey: p.openrouter.apiKey, baseUrl: p.openrouter.baseUrl, defaultModel: p.openrouter.defaultModel }));
+        }
+        if (p.custom.enabled && p.custom.apiKey && p.custom.baseUrl) {
+            this.providers.set('custom', new openai_1.OpenAIProvider({ apiKey: p.custom.apiKey, baseUrl: p.custom.baseUrl, defaultModel: p.custom.defaultModel }));
+        }
+    }
+    getProvider(name) {
+        if (name)
+            return this.providers.get(name);
+        const config = (0, manager_1.getConfigManager)();
+        const defaultProvider = config.getAll().ai.defaultProvider;
+        return this.providers.get(defaultProvider) || this.providers.values().next().value;
+    }
+    async complete(options, preferredProvider) {
+        // Build the resolution order: preferred → default → fallback chain → any available
+        const config = (0, manager_1.getConfigManager)();
+        const defaultProvider = config.getAll().ai.defaultProvider;
+        const tried = new Set();
+        const tryOrder = [];
+        let lastError = '';
+        if (preferredProvider)
+            tryOrder.push(preferredProvider);
+        if (defaultProvider)
+            tryOrder.push(defaultProvider);
+        tryOrder.push(...this.fallbackChain);
+        // Add all registered providers as final fallback
+        for (const name of this.providers.keys())
+            tryOrder.push(name);
+        for (const providerName of tryOrder) {
+            if (tried.has(providerName))
+                continue;
+            tried.add(providerName);
+            const provider = this.providers.get(providerName);
+            if (!provider)
+                continue;
+            // Retry with exponential backoff for transient errors
+            const maxRetries = 3;
+            for (let attempt = 0; attempt < maxRetries; attempt++) {
+                try {
+                    const result = await provider.complete(options);
+                    if (result.finishReason !== 'error')
+                        return result;
+                    // Check if error is retryable (rate limit, server error)
+                    const isRetryable = result.content.includes('429') ||
+                        result.content.includes('500') ||
+                        result.content.includes('502') ||
+                        result.content.includes('503') ||
+                        result.content.includes('rate') ||
+                        result.content.includes('timeout');
+                    if (isRetryable && attempt < maxRetries - 1) {
+                        const delay = Math.pow(2, attempt) * 1000; // 1s, 2s, 4s
+                        await new Promise(r => setTimeout(r, delay));
+                        continue;
+                    }
+                    lastError = result.content || `${providerName} returned error`;
+                    break;
+                }
+                catch (e) {
+                    const isRetryable = e.status === 429 || e.status >= 500 ||
+                        e.code === 'ECONNREFUSED' || e.code === 'ETIMEDOUT' ||
+                        e.code === 'ENOTFOUND';
+                    if (isRetryable && attempt < maxRetries - 1) {
+                        const delay = Math.pow(2, attempt) * 1000;
+                        await new Promise(r => setTimeout(r, delay));
+                        continue;
+                    }
+                    lastError = e.message || `${providerName} threw exception`;
+                    break;
+                }
+            }
+        }
+        const errorMsg = lastError
+            ? `Error: All providers failed. Last error: ${lastError}`
+            : 'Error: No providers available. Run `azerclaw onboard` to configure.';
+        return { content: errorMsg, model: 'none', provider: 'none', finishReason: 'error' };
+    }
+    async *stream(options, preferredProvider) {
+        const provider = preferredProvider ? this.providers.get(preferredProvider) : this.getProvider();
+        if (!provider) {
+            yield { type: 'error', error: 'No provider available' };
+            return;
+        }
+        yield* provider.stream(options);
+    }
+    async listAllModels() {
+        const allModels = [];
+        for (const [, provider] of this.providers) {
+            try {
+                const models = await provider.listModels();
+                allModels.push(...models);
+            }
+            catch { /* skip */ }
+        }
+        return allModels;
+    }
+    getAvailableProviders() {
+        return Array.from(this.providers.keys());
+    }
+    hasAnyProvider() {
+        return this.providers.size > 0;
+    }
+}
+exports.ProviderRouter = ProviderRouter;
+let routerInstance = null;
+function getRouter() {
+    if (!routerInstance)
+        routerInstance = new ProviderRouter();
+    return routerInstance;
+}
+function resetRouter() { routerInstance = null; }
+//# sourceMappingURL=router.js.map

package/dist/src/providers/router.js.map

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

package/dist/src/scheduler/heartbeat.d.ts

@@ -0,0 +1,62 @@
+/**
+ * 🐟 AZERCLAW Heartbeat Scheduler
+ * Proactive background task execution on a configurable schedule.
+ * Reads HEARTBEAT.md for task definitions and runs them on cron intervals.
+ */
+export interface HeartbeatTask {
+    name: string;
+    schedule: string;
+    action: string;
+    condition?: string;
+    enabled: boolean;
+    lastRun?: Date;
+    lastResult?: string;
+}
+export interface HeartbeatConfig {
+    intervalMinutes: number;
+    tasks: HeartbeatTask[];
+    suppressIfNoAction: boolean;
+}
+export declare class HeartbeatEngine {
+    private heartbeatPath?;
+    private jobs;
+    private tasks;
+    private running;
+    private eventCallback;
+    constructor(heartbeatPath?: string | undefined);
+    /**
+     * Set callback for heartbeat events (for messenger integration).
+     */
+    onEvent(callback: (event: string, details: string) => void): void;
+    /**
+     * Load tasks from HEARTBEAT.md and start all cron jobs.
+     */
+    start(): void;
+    /**
+     * Stop all cron jobs.
+     */
+    stop(): void;
+    /**
+     * Execute a single heartbeat task.
+     */
+    private executeTask;
+    /**
+     * Check if a condition is met (simple heuristic checks).
+     */
+    private checkCondition;
+    /**
+     * Get status of all tasks.
+     */
+    getStatus(): {
+        name: string;
+        schedule: string;
+        nextRun: string;
+        lastRun: string;
+        enabled: boolean;
+    }[];
+    /**
+     * Manually trigger a task by name.
+     */
+    triggerTask(name: string): Promise<string>;
+}
+//# sourceMappingURL=heartbeat.d.ts.map

package/dist/src/scheduler/heartbeat.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"heartbeat.d.ts","sourceRoot":"","sources":["../../../src/scheduler/heartbeat.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAYH,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,IAAI,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,eAAe;IAC9B,eAAe,EAAE,MAAM,CAAC;IACxB,KAAK,EAAE,aAAa,EAAE,CAAC;IACvB,kBAAkB,EAAE,OAAO,CAAC;CAC7B;AAoFD,qBAAa,eAAe;IAMd,OAAO,CAAC,aAAa,CAAC;IALlC,OAAO,CAAC,IAAI,CAAgC;IAC5C,OAAO,CAAC,KAAK,CAAuB;IACpC,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,aAAa,CAA2D;gBAE5D,aAAa,CAAC,EAAE,MAAM,YAAA;IAK1C;;OAEG;IACH,OAAO,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,KAAK,IAAI,GAAG,IAAI;IAIjE;;OAEG;IACH,KAAK,IAAI,IAAI;IAgCb;;OAEG;IACH,IAAI,IAAI,IAAI;IASZ;;OAEG;YACW,WAAW;IAuCzB;;OAEG;YACW,cAAc;IAgB5B;;OAEG;IACH,SAAS,IAAI;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,OAAO,CAAA;KAAE,EAAE;IAarG;;OAEG;IACG,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;CAMjD"}

package/dist/src/scheduler/heartbeat.js

@@ -0,0 +1,267 @@
+"use strict";
+/**
+ * 🐟 AZERCLAW Heartbeat Scheduler
+ * Proactive background task execution on a configurable schedule.
+ * Reads HEARTBEAT.md for task definitions and runs them on cron intervals.
+ */
+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.HeartbeatEngine = void 0;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const croner_1 = require("croner");
+const runtime_1 = require("../core/runtime");
+const manager_1 = require("../config/manager");
+const security_1 = require("../core/security");
+// ─── Schedule Parsing ───────────────────────────────────────────
+function humanToCron(schedule) {
+    const s = schedule.toLowerCase().trim();
+    // Pre-defined schedules
+    if (s === 'every 30 minutes' || s === 'every 30m')
+        return '*/30 * * * *';
+    if (s === 'every hour' || s === 'every 1h')
+        return '0 * * * *';
+    if (s === 'every 6 hours' || s === 'every 6h')
+        return '0 */6 * * *';
+    if (s === 'every 12 hours' || s === 'every 12h')
+        return '0 */12 * * *';
+    if (s === 'daily' || s === 'every day')
+        return '0 9 * * *';
+    if (s === 'weekly' || s === 'every week')
+        return '0 9 * * 1';
+    if (s.startsWith('daily at ')) {
+        const time = s.replace('daily at ', '');
+        const [h, m] = time.split(':').map(Number);
+        return `${m || 0} ${h} * * *`;
+    }
+    if (s.startsWith('weekly on ')) {
+        const day = s.replace('weekly on ', '').toLowerCase();
+        const dayMap = {
+            sunday: 0, monday: 1, tuesday: 2, wednesday: 3,
+            thursday: 4, friday: 5, saturday: 6,
+        };
+        return `0 9 * * ${dayMap[day] ?? 1}`;
+    }
+    // Match "every N minutes/hours" pattern
+    const everyMatch = s.match(/every (\d+) (minutes?|hours?)/);
+    if (everyMatch) {
+        const n = parseInt(everyMatch[1]);
+        const unit = everyMatch[2];
+        if (unit.startsWith('minute'))
+            return `*/${n} * * * *`;
+        if (unit.startsWith('hour'))
+            return `0 */${n} * * *`;
+    }
+    // Assume it's already a cron expression
+    return schedule;
+}
+// ─── HEARTBEAT.md Parser ────────────────────────────────────────
+function parseHeartbeatFile(filePath) {
+    if (!fs.existsSync(filePath))
+        return [];
+    const content = fs.readFileSync(filePath, 'utf-8');
+    const tasks = [];
+    // Parse markdown sections: ### Task Name
+    const sections = content.split(/^### /m).slice(1);
+    for (const section of sections) {
+        const lines = section.split('\n');
+        const name = lines[0].trim();
+        let schedule = 'every 30 minutes';
+        let action = '';
+        let condition = '';
+        let enabled = true;
+        for (const line of lines) {
+            const trimmed = line.trim();
+            if (trimmed.startsWith('- **Schedule**:')) {
+                schedule = trimmed.replace('- **Schedule**:', '').trim();
+            }
+            else if (trimmed.startsWith('- **Action**:')) {
+                action = trimmed.replace('- **Action**:', '').trim();
+            }
+            else if (trimmed.startsWith('- **Condition**:')) {
+                condition = trimmed.replace('- **Condition**:', '').trim();
+            }
+            else if (trimmed.startsWith('- **Enabled**:')) {
+                enabled = trimmed.replace('- **Enabled**:', '').trim().toLowerCase() !== 'false';
+            }
+        }
+        if (name && action) {
+            tasks.push({ name, schedule, action, condition, enabled });
+        }
+    }
+    return tasks;
+}
+// ─── Heartbeat Engine ───────────────────────────────────────────
+class HeartbeatEngine {
+    heartbeatPath;
+    jobs = new Map();
+    tasks = [];
+    running = false;
+    eventCallback = null;
+    constructor(heartbeatPath) {
+        this.heartbeatPath = heartbeatPath;
+        const configDir = (0, manager_1.getConfigManager)().paths.configDir;
+        this.heartbeatPath = heartbeatPath || path.join(configDir, 'HEARTBEAT.md');
+    }
+    /**
+     * Set callback for heartbeat events (for messenger integration).
+     */
+    onEvent(callback) {
+        this.eventCallback = callback;
+    }
+    /**
+     * Load tasks from HEARTBEAT.md and start all cron jobs.
+     */
+    start() {
+        if (this.running)
+            return;
+        this.running = true;
+        // Copy default HEARTBEAT.md if none exists
+        if (!fs.existsSync(this.heartbeatPath)) {
+            const templatePath = path.join(__dirname, '..', '..', 'templates', 'HEARTBEAT.md');
+            if (fs.existsSync(templatePath)) {
+                fs.copyFileSync(templatePath, this.heartbeatPath);
+            }
+        }
+        this.tasks = parseHeartbeatFile(this.heartbeatPath);
+        for (const task of this.tasks) {
+            if (!task.enabled)
+                continue;
+            const cronExpr = humanToCron(task.schedule);
+            try {
+                const job = new croner_1.Cron(cronExpr, async () => {
+                    await this.executeTask(task);
+                });
+                this.jobs.set(task.name, job);
+                (0, security_1.auditLog)('HEARTBEAT_SCHEDULED', `${task.name} → ${cronExpr}`);
+            }
+            catch (e) {
+                (0, security_1.auditLog)('HEARTBEAT_ERROR', `Failed to schedule ${task.name}: ${e.message}`);
+            }
+        }
+        (0, security_1.auditLog)('HEARTBEAT_STARTED', `${this.jobs.size} tasks scheduled`);
+    }
+    /**
+     * Stop all cron jobs.
+     */
+    stop() {
+        for (const [name, job] of this.jobs) {
+            job.stop();
+        }
+        this.jobs.clear();
+        this.running = false;
+        (0, security_1.auditLog)('HEARTBEAT_STOPPED', 'All tasks stopped');
+    }
+    /**
+     * Execute a single heartbeat task.
+     */
+    async executeTask(task) {
+        (0, security_1.auditLog)('HEARTBEAT_RUN', task.name);
+        // Check condition
+        if (task.condition) {
+            const conditionMet = await this.checkCondition(task.condition);
+            if (!conditionMet) {
+                (0, security_1.auditLog)('HEARTBEAT_SKIP', `${task.name} — condition not met`);
+                return;
+            }
+        }
+        // Run the task via a temporary agent
+        let result = '';
+        const agent = new runtime_1.AgentRuntime({
+            sessionId: `heartbeat_${task.name}_${Date.now()}`,
+            maxIterations: 5,
+            eventHandler: async (event) => {
+                if (event.type === 'response' && event.content) {
+                    result = event.content;
+                }
+            },
+        });
+        try {
+            result = await agent.run(task.action);
+            task.lastRun = new Date();
+            task.lastResult = result.slice(0, 500);
+            if (result && this.eventCallback) {
+                this.eventCallback(`heartbeat:${task.name}`, result);
+            }
+            (0, security_1.auditLog)('HEARTBEAT_DONE', `${task.name} — ${result.slice(0, 100)}`);
+        }
+        catch (e) {
+            (0, security_1.auditLog)('HEARTBEAT_ERROR', `${task.name} — ${e.message}`);
+        }
+    }
+    /**
+     * Check if a condition is met (simple heuristic checks).
+     */
+    async checkCondition(condition) {
+        const c = condition.toLowerCase();
+        if (c.includes('git repo')) {
+            return fs.existsSync(path.join(process.cwd(), '.git'));
+        }
+        if (c.includes('package.json')) {
+            return fs.existsSync(path.join(process.cwd(), 'package.json'));
+        }
+        if (c === 'always') {
+            return true;
+        }
+        return true; // Default: run
+    }
+    /**
+     * Get status of all tasks.
+     */
+    getStatus() {
+        return this.tasks.map(task => {
+            const job = this.jobs.get(task.name);
+            return {
+                name: task.name,
+                schedule: task.schedule,
+                nextRun: job?.nextRun()?.toISOString() || 'not scheduled',
+                lastRun: task.lastRun?.toISOString() || 'never',
+                enabled: task.enabled,
+            };
+        });
+    }
+    /**
+     * Manually trigger a task by name.
+     */
+    async triggerTask(name) {
+        const task = this.tasks.find(t => t.name === name);
+        if (!task)
+            return `Task not found: ${name}`;
+        await this.executeTask(task);
+        return task.lastResult || 'Task completed';
+    }
+}
+exports.HeartbeatEngine = HeartbeatEngine;
+//# sourceMappingURL=heartbeat.js.map

package/dist/src/scheduler/heartbeat.js.map

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

package/dist/src/skills/loader.d.ts

@@ -0,0 +1,25 @@
+/**
+ * 🐟 AZERCLAW Skills System
+ * Load and execute SKILL.md files compatible with the OpenClaw ecosystem.
+ */
+export interface SkillMetadata {
+    name: string;
+    description: string;
+    version?: string;
+    author?: string;
+    tags?: string[];
+    os?: string[];
+    requires?: string[];
+}
+export interface Skill {
+    metadata: SkillMetadata;
+    instructions: string;
+    filePath: string;
+    source: 'workspace' | 'project' | 'personal' | 'managed' | 'bundled';
+}
+export declare function loadAllSkills(workspaceDir?: string): Skill[];
+/**
+ * Format skills as context for the agent system prompt.
+ */
+export declare function formatSkillsForPrompt(skills: Skill[]): string;
+//# sourceMappingURL=loader.d.ts.map

package/dist/src/skills/loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../../src/skills/loader.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAMH,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;CACrB;AAED,MAAM,WAAW,KAAK;IACpB,QAAQ,EAAE,aAAa,CAAC;IACxB,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,WAAW,GAAG,SAAS,GAAG,UAAU,GAAG,SAAS,GAAG,SAAS,CAAC;CACtE;AAyED,wBAAgB,aAAa,CAAC,YAAY,CAAC,EAAE,MAAM,GAAG,KAAK,EAAE,CAoC5D;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,CAW7D"}