@xopcai/xopcbot 0.1.0

package/dist/config/rules.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Configuration reload rules
+ *
+ * Defines how different config paths are handled:
+ * - hot: Apply changes immediately without restart
+ * - restart: Require gateway restart
+ * - none: Ignore changes (no action needed)
+ */
+export type ReloadKind = 'hot' | 'restart' | 'none';
+export interface ReloadRule {
+    prefix: string;
+    kind: ReloadKind;
+    description?: string;
+}
+export interface ReloadPlan {
+    changedPaths: string[];
+    hotPaths: string[];
+    restartPaths: string[];
+    noopPaths: string[];
+    requiresRestart: boolean;
+    requiresHotReload: boolean;
+}
+/**
+ * Base reload rules for config paths
+ */
+export declare const BASE_RELOAD_RULES: ReloadRule[];
+/**
+ * Find matching rule for a config path
+ */
+export declare function matchReloadRule(path: string): ReloadRule | null;
+/**
+ * Build reload plan from changed paths
+ */
+export declare function buildReloadPlan(changedPaths: string[]): ReloadPlan;
+/**
+ * Get all hot-reloadable config paths
+ */
+export declare function getHotReloadablePaths(): string[];
+/**
+ * Get config paths that require restart
+ */
+export declare function getRestartRequiredPaths(): string[];

package/dist/config/rules.js

@@ -0,0 +1,114 @@
+/**
+ * Configuration reload rules
+ *
+ * Defines how different config paths are handled:
+ * - hot: Apply changes immediately without restart
+ * - restart: Require gateway restart
+ * - none: Ignore changes (no action needed)
+ */
+/**
+ * Base reload rules for config paths
+ */
+export const BASE_RELOAD_RULES = [
+    // Providers - hot reload
+    { prefix: 'providers', kind: 'hot', description: 'Provider API keys, base URLs' },
+    // Agent defaults - hot reload
+    { prefix: 'agents.defaults.model', kind: 'hot', description: 'Model configuration' },
+    { prefix: 'agents.defaults.maxTokens', kind: 'hot', description: 'Max tokens' },
+    { prefix: 'agents.defaults.temperature', kind: 'hot', description: 'Temperature' },
+    { prefix: 'agents.defaults.maxToolIterations', kind: 'hot', description: 'Max tool iterations' },
+    { prefix: 'agents.defaults.compaction', kind: 'hot', description: 'Compaction settings' },
+    { prefix: 'agents.defaults.pruning', kind: 'hot', description: 'Pruning settings' },
+    { prefix: 'agents.defaults.workspace', kind: 'none', description: 'Workspace path - no runtime effect' },
+    // Gateway - restart required
+    { prefix: 'gateway.host', kind: 'restart', description: 'Host address' },
+    { prefix: 'gateway.port', kind: 'restart', description: 'Port number' },
+    { prefix: 'gateway.auth', kind: 'restart', description: 'Authentication settings' },
+    { prefix: 'gateway.cors', kind: 'restart', description: 'CORS settings' },
+    { prefix: 'gateway.enableHotReload', kind: 'hot', description: 'Hot reload toggle' },
+    // Channels - hot reload
+    { prefix: 'channels.telegram', kind: 'hot', description: 'Telegram settings' },
+    { prefix: 'channels.whatsapp', kind: 'hot', description: 'WhatsApp settings' },
+    // Cron - hot reload
+    { prefix: 'cron', kind: 'hot', description: 'Scheduled tasks' },
+    // Heartbeat - hot reload
+    { prefix: 'heartbeat', kind: 'hot', description: 'Heartbeat settings' },
+    // Web search - hot reload
+    { prefix: 'webSearch', kind: 'hot', description: 'Web search settings' },
+    { prefix: 'webTools', kind: 'hot', description: 'Web tools settings' },
+    // Plugins - restart required
+    { prefix: 'plugins', kind: 'restart', description: 'Plugin configuration' },
+    // Tools - hot reload (for tool-specific settings)
+    { prefix: 'tools', kind: 'hot', description: 'Tools configuration' },
+];
+// Map for O(1) prefix lookup
+const rulesMap = new Map(BASE_RELOAD_RULES.map(r => [r.prefix, r]));
+/**
+ * Find matching rule for a config path
+ */
+export function matchReloadRule(path) {
+    // Check exact match first
+    if (rulesMap.has(path)) {
+        return rulesMap.get(path);
+    }
+    // Then check prefix match
+    for (const [prefix, rule] of rulesMap) {
+        if (path.startsWith(`${prefix}.`)) {
+            return rule;
+        }
+    }
+    return null;
+}
+/**
+ * Build reload plan from changed paths
+ */
+export function buildReloadPlan(changedPaths) {
+    const plan = {
+        changedPaths,
+        hotPaths: [],
+        restartPaths: [],
+        noopPaths: [],
+        requiresRestart: false,
+        requiresHotReload: false,
+    };
+    for (const path of changedPaths) {
+        const rule = matchReloadRule(path);
+        if (!rule) {
+            // No rule matched - default to restart for safety
+            plan.restartPaths.push(path);
+            plan.requiresRestart = true;
+            continue;
+        }
+        switch (rule.kind) {
+            case 'hot':
+                plan.hotPaths.push(path);
+                plan.requiresHotReload = true;
+                break;
+            case 'restart':
+                plan.restartPaths.push(path);
+                plan.requiresRestart = true;
+                break;
+            case 'none':
+                plan.noopPaths.push(path);
+                break;
+        }
+    }
+    return plan;
+}
+/**
+ * Get all hot-reloadable config paths
+ */
+export function getHotReloadablePaths() {
+    return BASE_RELOAD_RULES
+        .filter(r => r.kind === 'hot')
+        .map(r => r.prefix);
+}
+/**
+ * Get config paths that require restart
+ */
+export function getRestartRequiredPaths() {
+    return BASE_RELOAD_RULES
+        .filter(r => r.kind === 'restart')
+        .map(r => r.prefix);
+}
+//# sourceMappingURL=rules.js.map

package/dist/config/rules.js.map

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