@0xmaxma/claude-gateway 1.0.0

package/dist/config/migrator.js

@@ -0,0 +1,343 @@
+"use strict";
+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.loadCleanTemplate = loadCleanTemplate;
+exports.stripIgnoredPaths = stripIgnoredPaths;
+exports.detectMigration = detectMigration;
+exports.applyMigration = applyMigration;
+exports.migrateConfig = migrateConfig;
+exports.compareSemver = compareSemver;
+exports.deepMerge = deepMerge;
+exports.migrateModels = migrateModels;
+exports.pruneAgentPaths = pruneAgentPaths;
+const fs = __importStar(require("fs"));
+/**
+ * Deep-merge template into target, adding missing keys only.
+ * Never overwrites existing values. Returns list of added field paths.
+ * Keys whose full path is in ignorePaths are skipped entirely.
+ */
+function deepMerge(target, template, prefix, added, ignorePaths) {
+    for (const key of Object.keys(template)) {
+        const fullPath = prefix ? `${prefix}.${key}` : key;
+        // Skip paths that are in the ignorePaths set
+        if (ignorePaths && ignorePaths.has(fullPath)) {
+            continue;
+        }
+        if (!(key in target)) {
+            target[key] = structuredClone(template[key]);
+            added.push(fullPath);
+        }
+        else if (typeof target[key] === 'object' &&
+            target[key] !== null &&
+            !Array.isArray(target[key]) &&
+            typeof template[key] === 'object' &&
+            template[key] !== null &&
+            !Array.isArray(template[key])) {
+            deepMerge(target[key], template[key], fullPath, added, ignorePaths);
+        }
+    }
+}
+/**
+ * Merge missing fields from template agent into each user agent.
+ * Uses the first agent in the template as the schema source.
+ */
+function mergeAgentArrays(userAgents, templateAgents, added, ignorePaths) {
+    if (templateAgents.length === 0)
+        return;
+    const schema = templateAgents[0];
+    for (let i = 0; i < userAgents.length; i++) {
+        deepMerge(userAgents[i], schema, `agents[${i}]`, added, ignorePaths);
+    }
+}
+/**
+ * Remove dot-path keys from each agent entry. Returns paths actually removed.
+ * Paths are relative to each agent object (e.g. "telegram.allowedUsers").
+ */
+function pruneAgentPaths(agents, removePaths) {
+    const removed = [];
+    for (let i = 0; i < agents.length; i++) {
+        const agent = agents[i];
+        for (const dotPath of removePaths) {
+            const parts = dotPath.split('.');
+            let obj = agent;
+            let valid = true;
+            for (let j = 0; j < parts.length - 1; j++) {
+                if (typeof obj[parts[j]] !== 'object' || obj[parts[j]] === null) {
+                    valid = false;
+                    break;
+                }
+                obj = obj[parts[j]];
+            }
+            const leaf = parts[parts.length - 1];
+            if (valid && leaf in obj) {
+                delete obj[leaf];
+                const fullPath = `agents[${i}].${dotPath}`;
+                if (!removed.includes(fullPath))
+                    removed.push(fullPath);
+            }
+        }
+    }
+    return removed;
+}
+/**
+ * Compare two semver strings. Returns:
+ *  -1 if a < b, 0 if equal, 1 if a > b
+ */
+function compareSemver(a, b) {
+    const pa = a.split('.').map(Number);
+    const pb = b.split('.').map(Number);
+    for (let i = 0; i < 3; i++) {
+        const va = pa[i] ?? 0;
+        const vb = pb[i] ?? 0;
+        if (va < vb)
+            return -1;
+        if (va > vb)
+            return 1;
+    }
+    return 0;
+}
+/**
+ * Load a template file, extract the _migration metadata, strip it,
+ * and return the clean template along with the ignorePaths set.
+ */
+function loadCleanTemplate(templatePath) {
+    if (!fs.existsSync(templatePath)) {
+        throw new Error(`Config template not found at "${templatePath}". Cannot load.`);
+    }
+    const templateRaw = fs.readFileSync(templatePath, 'utf-8');
+    const template = JSON.parse(templateRaw);
+    // Extract ignorePaths and removePaths from _migration metadata
+    let ignorePaths = new Set();
+    let removePaths = [];
+    if (template._migration &&
+        typeof template._migration === 'object' &&
+        !Array.isArray(template._migration)) {
+        const migration = template._migration;
+        if (Array.isArray(migration.ignorePaths)) {
+            ignorePaths = new Set(migration.ignorePaths.filter((p) => typeof p === 'string'));
+        }
+        if (Array.isArray(migration.removePaths)) {
+            removePaths = migration.removePaths.filter((p) => typeof p === 'string');
+        }
+    }
+    // Strip _migration from the template
+    delete template._migration;
+    return { template, ignorePaths, removePaths };
+}
+/**
+ * Recursively delete keys from obj whose full dotted path matches any entry
+ * in ignorePaths. The prefix parameter tracks the current path during recursion.
+ */
+function stripIgnoredPaths(obj, ignorePaths, prefix = '') {
+    for (const key of Object.keys(obj)) {
+        const fullPath = prefix ? `${prefix}.${key}` : key;
+        if (ignorePaths.has(fullPath)) {
+            delete obj[key];
+        }
+        else if (typeof obj[key] === 'object' &&
+            obj[key] !== null &&
+            !Array.isArray(obj[key])) {
+            stripIgnoredPaths(obj[key], ignorePaths, fullPath);
+        }
+    }
+}
+/**
+ * Detect whether a config migration is needed (dry-run, no writes).
+ * Returns migration metadata including the fields that would be added.
+ */
+function detectMigration(configPath, templatePath, templateVersion) {
+    const noMigration = (config, template, fromVersion) => ({
+        needed: false,
+        fromVersion,
+        toVersion: templateVersion,
+        addedFields: [],
+        removedFields: [],
+        config,
+        template,
+    });
+    // Config file missing = first run, create-agent handles it
+    if (!fs.existsSync(configPath)) {
+        return noMigration({}, {}, '0.0.0');
+    }
+    // Template must exist — load and strip _migration
+    const { template, ignorePaths, removePaths } = loadCleanTemplate(templatePath);
+    // Read and parse config
+    let configRaw;
+    try {
+        configRaw = fs.readFileSync(configPath, 'utf-8');
+    }
+    catch (err) {
+        throw new Error(`Cannot read config file: ${err.message}`);
+    }
+    let config;
+    try {
+        config = JSON.parse(configRaw);
+    }
+    catch (err) {
+        throw new Error(`Config file is not valid JSON: ${err.message}`);
+    }
+    // Version check
+    const configVersion = config.configVersion ?? '0.0.0';
+    if (compareSemver(configVersion, templateVersion) >= 0) {
+        return noMigration(config, template, configVersion);
+    }
+    // Dry-run merge on a clone to detect what would be added/removed
+    const configClone = structuredClone(config);
+    const added = [];
+    // Deep-merge top-level keys (except agents which need special handling)
+    const templateWithoutAgents = { ...template };
+    delete templateWithoutAgents.agents;
+    deepMerge(configClone, templateWithoutAgents, '', added, ignorePaths);
+    // Migrate models array by ID
+    migrateModels(configClone, template, added);
+    // Merge agent arrays
+    if (Array.isArray(configClone.agents) && Array.isArray(template.agents)) {
+        mergeAgentArrays(configClone.agents, template.agents, added, ignorePaths);
+    }
+    // Prune removed paths from agent entries
+    const removed = [];
+    if (removePaths.length > 0 && Array.isArray(configClone.agents)) {
+        removed.push(...pruneAgentPaths(configClone.agents, removePaths));
+    }
+    // configVersion will always be updated
+    if (!added.includes('configVersion')) {
+        added.push('configVersion');
+    }
+    return {
+        needed: true,
+        fromVersion: configVersion,
+        toVersion: templateVersion,
+        addedFields: added,
+        removedFields: removed,
+        config,
+        template,
+    };
+}
+/**
+ * Apply a config migration: deep-merge missing fields, update version,
+ * create backup, and write the updated config.
+ */
+function applyMigration(configPath, config, template, templateVersion, ignorePaths, removePaths) {
+    const added = [];
+    // Deep-merge top-level keys (except agents)
+    const templateWithoutAgents = { ...template };
+    delete templateWithoutAgents.agents;
+    deepMerge(config, templateWithoutAgents, '', added, ignorePaths);
+    // Migrate models array by ID
+    migrateModels(config, template, added);
+    // Merge agent arrays
+    if (Array.isArray(config.agents) && Array.isArray(template.agents)) {
+        mergeAgentArrays(config.agents, template.agents, added, ignorePaths);
+    }
+    // Prune removed paths from agent entries
+    const removed = [];
+    if (removePaths && removePaths.length > 0 && Array.isArray(config.agents)) {
+        removed.push(...pruneAgentPaths(config.agents, removePaths));
+    }
+    // Update configVersion
+    config.configVersion = templateVersion;
+    if (!added.includes('configVersion')) {
+        added.push('configVersion');
+    }
+    // Backup before writing
+    const backupPath = configPath + '.bak';
+    fs.copyFileSync(configPath, backupPath);
+    // Write atomically via temp file
+    const tmpPath = configPath + '.tmp';
+    fs.writeFileSync(tmpPath, JSON.stringify(config, null, 2) + '\n', 'utf-8');
+    fs.renameSync(tmpPath, configPath);
+    return { migrated: true, addedFields: added, removedFields: removed };
+}
+/**
+ * Migrate config.json by adding missing fields from the template.
+ * - Never overwrites existing values
+ * - Creates a .bak backup before writing
+ * - Skips migration if config file does not exist (first run)
+ */
+function migrateConfig(configPath, templatePath, templateVersion) {
+    const detection = detectMigration(configPath, templatePath, templateVersion);
+    if (!detection.needed) {
+        return { migrated: false, addedFields: [], removedFields: [] };
+    }
+    // Load ignorePaths and removePaths again for the actual merge
+    let ignorePaths;
+    let removePaths;
+    try {
+        const clean = loadCleanTemplate(templatePath);
+        ignorePaths = clean.ignorePaths;
+        removePaths = clean.removePaths;
+    }
+    catch {
+        // If template can't be loaded again, proceed without ignorePaths/removePaths
+    }
+    return applyMigration(configPath, detection.config, detection.template, templateVersion, ignorePaths, removePaths);
+}
+/**
+ * Merge models from template into user config by ID.
+ * Adds new models, updates alias/label/contextWindow of existing ones.
+ * Preserves user models not in template.
+ */
+function migrateModels(config, template, added) {
+    const gw = config.gateway;
+    const tgw = template.gateway;
+    if (!gw || !tgw)
+        return;
+    const templateModels = tgw.models;
+    if (!templateModels || templateModels.length === 0)
+        return;
+    const userModels = (gw.models ?? []);
+    const userMap = new Map(userModels.map((m) => [m.id, m]));
+    const merged = [];
+    for (const tm of templateModels) {
+        const existing = userMap.get(tm.id);
+        if (existing) {
+            existing.alias = tm.alias;
+            existing.label = tm.label;
+            existing.contextWindow = tm.contextWindow;
+            merged.push(existing);
+        }
+        else {
+            merged.push(structuredClone(tm));
+            added.push(`gateway.models[${tm.id}]`);
+        }
+    }
+    for (const um of userModels) {
+        if (!templateModels.some((tm) => tm.id === um.id)) {
+            merged.push(um);
+        }
+    }
+    gw.models = merged;
+}
+//# sourceMappingURL=migrator.js.map

package/dist/config/migrator.js.map

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

package/dist/config/watcher.d.ts

@@ -0,0 +1,30 @@
+import { EventEmitter } from 'events';
+import { AgentConfig, GatewayConfig, Logger } from '../types';
+declare const HOT_RELOADABLE_AGENT_FIELDS: string[];
+export interface ConfigChange {
+    agentId: string;
+    field: string;
+    oldValue: unknown;
+    newValue: unknown;
+    hotReloadable: boolean;
+}
+export declare class ConfigWatcher extends EventEmitter {
+    private readonly configPath;
+    private readonly logger;
+    on(event: 'changes', listener: (changes: ConfigChange[], newCfg: GatewayConfig, oldCfg: GatewayConfig) => void): this;
+    on(event: 'agent.added', listener: (agent: AgentConfig) => void): this;
+    on(event: 'channel.added', listener: (agentId: string, channel: string) => void): this;
+    private watchHandle;
+    private currentConfig;
+    constructor(configPath: string, initialConfig: GatewayConfig, logger: Logger);
+    start(): void;
+    stop(): void;
+    /** Get current config snapshot */
+    getConfig(): GatewayConfig;
+    reload(): void;
+    private diffConfig;
+}
+/** Simple deep equality check for primitives, arrays, and plain objects */
+declare function deepEqual(a: unknown, b: unknown): boolean;
+export { deepEqual as _deepEqual, HOT_RELOADABLE_AGENT_FIELDS };
+//# sourceMappingURL=watcher.d.ts.map

package/dist/config/watcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"watcher.d.ts","sourceRoot":"","sources":["../../src/config/watcher.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AAEtC,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAI9D,QAAA,MAAM,2BAA2B,EAAE,MAAM,EAOxC,CAAC;AAEF,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,OAAO,CAAC;IAClB,QAAQ,EAAE,OAAO,CAAC;IAClB,aAAa,EAAE,OAAO,CAAC;CACxB;AAOD,qBAAa,aAAc,SAAQ,YAAY;IAa3C,OAAO,CAAC,QAAQ,CAAC,UAAU;IAE3B,OAAO,CAAC,QAAQ,CAAC,MAAM;IAdzB,EAAE,CAAC,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,CAAC,OAAO,EAAE,YAAY,EAAE,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,aAAa,KAAK,IAAI,GAAG,IAAI;IACrH,EAAE,CAAC,KAAK,EAAE,aAAa,EAAE,QAAQ,EAAE,CAAC,KAAK,EAAE,WAAW,KAAK,IAAI,GAAG,IAAI;IACtE,EAAE,CAAC,KAAK,EAAE,eAAe,EAAE,QAAQ,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,KAAK,IAAI,GAAG,IAAI;IAMtF,OAAO,CAAC,WAAW,CAA4B;IAC/C,OAAO,CAAC,aAAa,CAAgB;gBAGlB,UAAU,EAAE,MAAM,EACnC,aAAa,EAAE,aAAa,EACX,MAAM,EAAE,MAAM;IAMjC,KAAK,IAAI,IAAI;IASb,IAAI,IAAI,IAAI;IAKZ,kCAAkC;IAClC,SAAS,IAAI,aAAa;IAI1B,MAAM,IAAI,IAAI;IA8Dd,OAAO,CAAC,UAAU;CAoDnB;AAED,2EAA2E;AAC3E,iBAAS,SAAS,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,GAAG,OAAO,CAoBlD;AAGD,OAAO,EAAE,SAAS,IAAI,UAAU,EAAE,2BAA2B,EAAE,CAAC"}

package/dist/config/watcher.js

@@ -0,0 +1,170 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HOT_RELOADABLE_AGENT_FIELDS = exports.ConfigWatcher = void 0;
+exports._deepEqual = deepEqual;
+const events_1 = require("events");
+const loader_1 = require("./loader");
+const factory_1 = require("../watch/factory");
+// Fields that can be hot-reloaded without restarting the gateway
+const HOT_RELOADABLE_AGENT_FIELDS = [
+    'claude.model',
+    'claude.extraFlags',
+    'claude.dangerouslySkipPermissions',
+    'session.idleTimeoutMinutes',
+    'session.maxConcurrent',
+    'heartbeat.rateLimitMinutes',
+];
+exports.HOT_RELOADABLE_AGENT_FIELDS = HOT_RELOADABLE_AGENT_FIELDS;
+class ConfigWatcher extends events_1.EventEmitter {
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    on(event, listener) {
+        return super.on(event, listener);
+    }
+    constructor(configPath, initialConfig, logger) {
+        super();
+        this.configPath = configPath;
+        this.logger = logger;
+        this.watchHandle = null;
+        this.currentConfig = structuredClone(initialConfig);
+    }
+    start() {
+        this.watchHandle = (0, factory_1.createWatcher)({
+            paths: [this.configPath],
+            debounceMs: 500,
+            chokidarOpts: { awaitWriteFinish: { stabilityThreshold: 300 } },
+            onChange: () => this.reload(),
+        });
+    }
+    stop() {
+        void this.watchHandle?.close();
+        this.watchHandle = null;
+    }
+    /** Get current config snapshot */
+    getConfig() {
+        return this.currentConfig;
+    }
+    reload() {
+        let newConfig;
+        try {
+            newConfig = (0, loader_1.loadConfig)(this.configPath);
+        }
+        catch (err) {
+            this.logger.error('Config reload failed, keeping current config', {
+                error: err.message,
+            });
+            return;
+        }
+        const { fieldChanges, addedAgents } = this.diffConfig(this.currentConfig, newConfig);
+        if (fieldChanges.length === 0 && addedAgents.length === 0) {
+            this.logger.info('Config file changed but no effective differences detected');
+            return;
+        }
+        // Always update currentConfig when there are any changes (including new agents)
+        const oldConfig = this.currentConfig;
+        this.currentConfig = structuredClone(newConfig);
+        // Emit field changes for existing agents
+        if (fieldChanges.length > 0) {
+            const hotChanges = fieldChanges.filter(c => c.hotReloadable);
+            const coldChanges = fieldChanges.filter(c => !c.hotReloadable);
+            if (hotChanges.length > 0) {
+                this.logger.info('Config hot-reloaded', {
+                    fields: hotChanges.map(c => `${c.agentId}.${c.field}`),
+                });
+            }
+            if (coldChanges.length > 0) {
+                this.logger.warn('Config changes require restart to take effect', {
+                    fields: coldChanges.map(c => `${c.agentId}.${c.field}`),
+                });
+            }
+            this.emit('changes', fieldChanges, newConfig, oldConfig);
+            // Emit channel.added when a new channel token is added to an existing agent
+            for (const change of fieldChanges) {
+                if (!change.oldValue && change.newValue) {
+                    if (change.field === 'discord.botToken') {
+                        this.logger.info('Discord channel added to agent', { agentId: change.agentId });
+                        this.emit('channel.added', change.agentId, 'discord');
+                    }
+                    if (change.field === 'telegram.botToken') {
+                        this.logger.info('Telegram channel added to agent', { agentId: change.agentId });
+                        this.emit('channel.added', change.agentId, 'telegram');
+                    }
+                }
+            }
+        }
+        // Emit agent.added for each new agent
+        for (const agent of addedAgents) {
+            this.logger.info('New agent detected in config', { id: agent.id });
+            this.emit('agent.added', agent);
+        }
+    }
+    diffConfig(oldCfg, newCfg) {
+        const fieldChanges = [];
+        const addedAgents = [];
+        // Build agent maps by id for comparison
+        const oldAgents = new Map();
+        for (const agent of oldCfg.agents) {
+            oldAgents.set(agent.id, agent);
+        }
+        const newAgents = new Map();
+        for (const agent of newCfg.agents) {
+            newAgents.set(agent.id, agent);
+        }
+        // Compare agents that exist in both configs; collect new agents separately
+        for (const [id, newAgent] of newAgents) {
+            const oldAgent = oldAgents.get(id);
+            if (!oldAgent) {
+                addedAgents.push(newAgent);
+                continue;
+            }
+            // Check each field path
+            const fieldPairs = [
+                { field: 'claude.model', oldVal: oldAgent.claude.model, newVal: newAgent.claude.model },
+                { field: 'claude.extraFlags', oldVal: oldAgent.claude.extraFlags, newVal: newAgent.claude.extraFlags },
+                { field: 'claude.dangerouslySkipPermissions', oldVal: oldAgent.claude.dangerouslySkipPermissions, newVal: newAgent.claude.dangerouslySkipPermissions },
+                { field: 'session.idleTimeoutMinutes', oldVal: oldAgent.session?.idleTimeoutMinutes, newVal: newAgent.session?.idleTimeoutMinutes },
+                { field: 'session.maxConcurrent', oldVal: oldAgent.session?.maxConcurrent, newVal: newAgent.session?.maxConcurrent },
+                { field: 'heartbeat.rateLimitMinutes', oldVal: oldAgent.heartbeat?.rateLimitMinutes, newVal: newAgent.heartbeat?.rateLimitMinutes },
+                { field: 'workspace', oldVal: oldAgent.workspace, newVal: newAgent.workspace },
+                { field: 'telegram.botToken', oldVal: oldAgent.telegram?.botToken, newVal: newAgent.telegram?.botToken },
+                { field: 'discord.botToken', oldVal: oldAgent.discord?.botToken, newVal: newAgent.discord?.botToken },
+                { field: 'description', oldVal: oldAgent.description, newVal: newAgent.description },
+            ];
+            for (const { field, oldVal, newVal } of fieldPairs) {
+                if (!deepEqual(oldVal, newVal)) {
+                    fieldChanges.push({
+                        agentId: id,
+                        field,
+                        oldValue: oldVal,
+                        newValue: newVal,
+                        hotReloadable: HOT_RELOADABLE_AGENT_FIELDS.includes(field),
+                    });
+                }
+            }
+        }
+        return { fieldChanges, addedAgents };
+    }
+}
+exports.ConfigWatcher = ConfigWatcher;
+/** Simple deep equality check for primitives, arrays, and plain objects */
+function deepEqual(a, b) {
+    if (a === b)
+        return true;
+    if (a === null || b === null)
+        return false;
+    if (typeof a !== typeof b)
+        return false;
+    if (Array.isArray(a) && Array.isArray(b)) {
+        if (a.length !== b.length)
+            return false;
+        return a.every((val, i) => deepEqual(val, b[i]));
+    }
+    if (typeof a === 'object' && typeof b === 'object') {
+        const aKeys = Object.keys(a);
+        const bKeys = Object.keys(b);
+        if (aKeys.length !== bKeys.length)
+            return false;
+        return aKeys.every(key => deepEqual(a[key], b[key]));
+    }
+    return false;
+}
+//# sourceMappingURL=watcher.js.map

package/dist/config/watcher.js.map

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

package/dist/cron/manager.d.ts

@@ -0,0 +1,48 @@
+import { EventEmitter } from 'events';
+import { CronJob, CronJobCreate, CronJobUpdate, CronRunLog, CronManagerConfig, Logger, AgentConfig } from '../types';
+import type { AgentRunner } from '../agent/runner';
+export declare class CronManager extends EventEmitter {
+    private readonly storePath;
+    private readonly runsDir;
+    private readonly logger;
+    private readonly agentRunners;
+    private readonly agentConfigs;
+    private jobs;
+    private scheduledTasks;
+    constructor(config?: CronManagerConfig, agentRunners?: Map<string, AgentRunner>, agentConfigs?: Map<string, AgentConfig>, logger?: Logger);
+    /**
+     * Load persisted jobs from disk and schedule them.
+     */
+    start(): Promise<void>;
+    /**
+     * Stop all scheduled tasks.
+     */
+    stop(): void;
+    create(input: CronJobCreate): Promise<CronJob>;
+    update(id: string, input: CronJobUpdate): Promise<CronJob>;
+    remove(id: string): Promise<void>;
+    get(id: string): CronJob | undefined;
+    list(agentId?: string): CronJob[];
+    run(id: string): Promise<CronRunLog>;
+    getRuns(id: string, limit?: number): Promise<CronRunLog[]>;
+    status(): {
+        totalJobs: number;
+        enabledJobs: number;
+        disabledJobs: number;
+        jobs: CronJob[];
+    };
+    private validateSchedule;
+    private validatePayload;
+    private scheduleJob;
+    private unscheduleJob;
+    private disableOrDeleteJob;
+    private executeJob;
+    private runCommand;
+    private runAgentTurn;
+    private sendTelegram;
+    private sendDiscord;
+    private persist;
+    private appendRunLog;
+    private catchUpMissedJobs;
+}
+//# sourceMappingURL=manager.d.ts.map

package/dist/cron/manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manager.d.ts","sourceRoot":"","sources":["../../src/cron/manager.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AAOtC,OAAO,EACL,OAAO,EACP,aAAa,EACb,aAAa,EACb,UAAU,EACV,iBAAiB,EACjB,MAAM,EACN,WAAW,EACZ,MAAM,UAAU,CAAC;AAClB,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAyCnD,qBAAa,WAAY,SAAQ,YAAY;IAC3C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAA2B;IACxD,OAAO,CAAC,QAAQ,CAAC,YAAY,CAA2B;IACxD,OAAO,CAAC,IAAI,CAAmC;IAC/C,OAAO,CAAC,cAAc,CAAmE;gBAGvF,MAAM,CAAC,EAAE,iBAAiB,EAC1B,YAAY,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,WAAW,CAAC,EACvC,YAAY,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,WAAW,CAAC,EACvC,MAAM,CAAC,EAAE,MAAM;IAUjB;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IA4B5B;;OAEG;IACH,IAAI,IAAI,IAAI;IAcN,MAAM,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC,OAAO,CAAC;IA+C9C,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC,OAAO,CAAC;IAkD1D,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAYvC,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS;IAIpC,IAAI,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,EAAE;IAM3B,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;IAMpC,OAAO,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,SAAK,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;IAkB5D,MAAM,IAAI;QACR,SAAS,EAAE,MAAM,CAAC;QAClB,WAAW,EAAE,MAAM,CAAC;QACpB,YAAY,EAAE,MAAM,CAAC;QACrB,IAAI,EAAE,OAAO,EAAE,CAAC;KACjB;IAYD,OAAO,CAAC,gBAAgB;IAcxB,OAAO,CAAC,eAAe;IAYvB,OAAO,CAAC,WAAW;IA0DnB,OAAO,CAAC,aAAa;YAaP,kBAAkB;YAelB,UAAU;IA+DxB,OAAO,CAAC,UAAU;YAiBJ,YAAY;YAYZ,YAAY;YA0BZ,WAAW;YAmCX,OAAO;YAWP,YAAY;YAgBZ,iBAAiB;CAyChC"}