@timmeck/brain-core 2.2.0 → 2.4.0

package/dist/index.js

@@ -45,4 +45,16 @@ export { CrossBrainSubscriptionManager } from './cross-brain/subscription.js';
 export { CrossBrainCorrelator } from './cross-brain/correlator.js';
 // ── Ecosystem ──────────────────────────────────────────────
 export { EcosystemService } from './ecosystem/service.js';
+// ── Webhooks ──────────────────────────────────────────────
+export { WebhookService, runWebhookMigration } from './webhooks/service.js';
+// ── Export ────────────────────────────────────────────────
+export { ExportService } from './export/service.js';
+// ── Backup ────────────────────────────────────────────────
+export { BackupService } from './backup/service.js';
+// ── Meta-Learning ────────────────────────────────────────
+export { MetaLearningEngine, runMetaLearningMigration } from './meta-learning/engine.js';
+// ── Causal Inference ─────────────────────────────────────
+export { CausalGraph, runCausalMigration } from './causal/engine.js';
+// ── Hypothesis Engine ────────────────────────────────────
+export { HypothesisEngine, runHypothesisMigration } from './hypothesis/engine.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAGA,8DAA8D;AAC9D,OAAO,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AACzC,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAEzE,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC1E,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAElD,8DAA8D;AAC9D,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAEtD,8DAA8D;AAC9D,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAClE,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAE5C,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAErE,OAAO,EAAE,QAAQ,EAAE,eAAe,EAAE,aAAa,EAAE,YAAY,EAAE,uBAAuB,EAAE,MAAM,iBAAiB,CAAC;AAElH,8DAA8D;AAC9D,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAEjD,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAGrD,8DAA8D;AAC9D,OAAO,EAAE,CAAC,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,WAAW,EAAE,WAAW,EAAE,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAEtH,8DAA8D;AAC9D,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAEhD,OAAO,EAAE,WAAW,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAG3F,8DAA8D;AAC9D,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AACrD,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAEvD,8DAA8D;AAC9D,OAAO,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAQ/D,OAAO,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAC/C,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAC/D,OAAO,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AACpD,OAAO,EAAE,kBAAkB,EAAE,MAAM,+BAA+B,CAAC;AAEnE,6DAA6D;AAC7D,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAE/D,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAG/D,2DAA2D;AAC3D,OAAO,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAU7D,OAAO,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAC;AAElE,4DAA4D;AAC5D,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAExD,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAG/D,8DAA8D;AAC9D,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAE3D,OAAO,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAC;AAEpE,OAAO,EAAE,6BAA6B,EAAE,MAAM,+BAA+B,CAAC;AAE9E,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AAGnE,8DAA8D;AAC9D,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/meta-learning/engine.d.ts

@@ -0,0 +1,108 @@
+import type Database from 'better-sqlite3';
+export interface HyperParameter {
+    name: string;
+    value: number;
+    min: number;
+    max: number;
+    step: number;
+}
+export interface LearningSnapshot {
+    id?: number;
+    cycle: number;
+    params: Record<string, number>;
+    metrics: Record<string, number>;
+    score: number;
+    created_at?: string;
+}
+export interface ParameterRecommendation {
+    name: string;
+    currentValue: number;
+    recommendedValue: number;
+    expectedImprovement: number;
+    confidence: number;
+    evidence: number;
+}
+export interface MetaLearningStatus {
+    totalSnapshots: number;
+    totalOptimizations: number;
+    bestScore: number;
+    worstScore: number;
+    currentScore: number;
+    trend: 'improving' | 'stable' | 'declining';
+    recommendations: ParameterRecommendation[];
+}
+export declare function runMetaLearningMigration(db: Database.Database): void;
+/**
+ * Meta-Learning Engine: observes learning cycle outcomes over time
+ * and auto-tunes hyperparameters using gradient-free optimization.
+ *
+ * Research approach: Bayesian-inspired parameter search.
+ * - After each learning cycle, record a snapshot (params + metrics + effectiveness score)
+ * - Periodically analyze: which parameter configurations produced the best scores?
+ * - Use perturbation: try small changes to parameters, measure improvement, keep what works
+ * - Implements "explore vs exploit": 80% exploit best known, 20% explore new configurations
+ */
+export declare class MetaLearningEngine {
+    private db;
+    private params;
+    private logger;
+    private cycleCount;
+    private analyzeInterval;
+    private explorationRate;
+    constructor(db: Database.Database, params: HyperParameter[], config?: {
+        analyzeInterval?: number;
+        explorationRate?: number;
+    });
+    /**
+     * Record a learning cycle's outcome. Called after each learning cycle.
+     * @param metrics - the raw metrics from the cycle (e.g. newPatterns, updatedRules, prunedRules)
+     * @param score - a composite effectiveness score (higher = better)
+     */
+    recordSnapshot(metrics: Record<string, number>, score: number): LearningSnapshot;
+    /**
+     * Analyze snapshots and recommend parameter changes.
+     * Uses a simplified approach inspired by Bayesian optimization:
+     * - Group snapshots by parameter ranges
+     * - Find which ranges produced the best average scores
+     * - Recommend moving towards those ranges
+     */
+    analyze(): ParameterRecommendation[];
+    /**
+     * Apply recommendations: perturb parameters towards better configurations.
+     * Returns the parameters that were changed.
+     */
+    optimize(): ParameterRecommendation[];
+    /**
+     * Run analysis + optimization if it's time. Call this after every learning cycle.
+     */
+    step(metrics: Record<string, number>, score: number): {
+        snapshot: LearningSnapshot;
+        optimized: ParameterRecommendation[];
+    };
+    /** Get current parameter values. */
+    getParams(): Record<string, number>;
+    /** Update a parameter value externally (e.g. user override). */
+    setParam(name: string, value: number): boolean;
+    /** Get learning effectiveness status. */
+    getStatus(): MetaLearningStatus;
+    /** Get optimization history. */
+    getHistory(limit?: number): Array<{
+        param_name: string;
+        old_value: number;
+        new_value: number;
+        reason: string;
+        improvement: number | null;
+        created_at: string;
+    }>;
+    private getSnapshots;
+    /**
+     * Analyze a single parameter's effect on learning effectiveness.
+     *
+     * Algorithm:
+     * 1. Divide the parameter's range into bins
+     * 2. For each bin, calculate the average score of snapshots in that bin
+     * 3. Find the bin with the highest average score
+     * 4. Recommend moving towards the center of that bin
+     */
+    private analyzeParameter;
+}

package/dist/meta-learning/engine.js

@@ -0,0 +1,275 @@
+import { getLogger } from '../utils/logger.js';
+// ── Migration ───────────────────────────────────────────
+export function runMetaLearningMigration(db) {
+    db.exec(`
+    CREATE TABLE IF NOT EXISTS meta_learning_snapshots (
+      id INTEGER PRIMARY KEY AUTOINCREMENT,
+      cycle INTEGER NOT NULL,
+      params TEXT NOT NULL,
+      metrics TEXT NOT NULL,
+      score REAL NOT NULL,
+      created_at TEXT NOT NULL DEFAULT (datetime('now'))
+    );
+
+    CREATE TABLE IF NOT EXISTS meta_learning_optimizations (
+      id INTEGER PRIMARY KEY AUTOINCREMENT,
+      param_name TEXT NOT NULL,
+      old_value REAL NOT NULL,
+      new_value REAL NOT NULL,
+      reason TEXT NOT NULL,
+      improvement REAL,
+      created_at TEXT NOT NULL DEFAULT (datetime('now'))
+    );
+
+    CREATE INDEX IF NOT EXISTS idx_meta_snapshots_score ON meta_learning_snapshots(score);
+    CREATE INDEX IF NOT EXISTS idx_meta_snapshots_cycle ON meta_learning_snapshots(cycle);
+  `);
+}
+// ── Engine ───────────────────────────────────────────────
+/**
+ * Meta-Learning Engine: observes learning cycle outcomes over time
+ * and auto-tunes hyperparameters using gradient-free optimization.
+ *
+ * Research approach: Bayesian-inspired parameter search.
+ * - After each learning cycle, record a snapshot (params + metrics + effectiveness score)
+ * - Periodically analyze: which parameter configurations produced the best scores?
+ * - Use perturbation: try small changes to parameters, measure improvement, keep what works
+ * - Implements "explore vs exploit": 80% exploit best known, 20% explore new configurations
+ */
+export class MetaLearningEngine {
+    db;
+    params;
+    logger = getLogger();
+    cycleCount = 0;
+    analyzeInterval; // analyze every N cycles
+    explorationRate; // % of cycles spent exploring (0-1)
+    constructor(db, params, config) {
+        this.db = db;
+        this.params = params;
+        runMetaLearningMigration(db);
+        this.analyzeInterval = config?.analyzeInterval ?? 5;
+        this.explorationRate = config?.explorationRate ?? 0.2;
+    }
+    /**
+     * Record a learning cycle's outcome. Called after each learning cycle.
+     * @param metrics - the raw metrics from the cycle (e.g. newPatterns, updatedRules, prunedRules)
+     * @param score - a composite effectiveness score (higher = better)
+     */
+    recordSnapshot(metrics, score) {
+        this.cycleCount++;
+        const currentParams = {};
+        for (const p of this.params) {
+            currentParams[p.name] = p.value;
+        }
+        this.db.prepare(`
+      INSERT INTO meta_learning_snapshots (cycle, params, metrics, score)
+      VALUES (?, ?, ?, ?)
+    `).run(this.cycleCount, JSON.stringify(currentParams), JSON.stringify(metrics), score);
+        const snapshot = {
+            cycle: this.cycleCount,
+            params: currentParams,
+            metrics,
+            score,
+        };
+        this.logger.debug(`Meta-learning snapshot #${this.cycleCount}: score=${score.toFixed(3)}`);
+        return snapshot;
+    }
+    /**
+     * Analyze snapshots and recommend parameter changes.
+     * Uses a simplified approach inspired by Bayesian optimization:
+     * - Group snapshots by parameter ranges
+     * - Find which ranges produced the best average scores
+     * - Recommend moving towards those ranges
+     */
+    analyze() {
+        const snapshots = this.getSnapshots(50); // last 50 cycles
+        if (snapshots.length < 5)
+            return []; // need minimum data
+        const recommendations = [];
+        for (const param of this.params) {
+            const rec = this.analyzeParameter(param, snapshots);
+            if (rec)
+                recommendations.push(rec);
+        }
+        return recommendations;
+    }
+    /**
+     * Apply recommendations: perturb parameters towards better configurations.
+     * Returns the parameters that were changed.
+     */
+    optimize() {
+        const recommendations = this.analyze();
+        const applied = [];
+        for (const rec of recommendations) {
+            if (rec.confidence < 0.3)
+                continue; // skip low-confidence recommendations
+            if (Math.abs(rec.expectedImprovement) < 0.01)
+                continue; // skip negligible improvements
+            const param = this.params.find(p => p.name === rec.name);
+            if (!param)
+                continue;
+            // Explore vs exploit: sometimes try random perturbations
+            const exploring = Math.random() < this.explorationRate;
+            let newValue;
+            if (exploring) {
+                // Random perturbation within bounds
+                const range = param.max - param.min;
+                newValue = param.value + (Math.random() - 0.5) * range * 0.2;
+            }
+            else {
+                // Move towards recommended value
+                newValue = rec.recommendedValue;
+            }
+            // Clamp to bounds
+            newValue = Math.max(param.min, Math.min(param.max, newValue));
+            // Record optimization
+            this.db.prepare(`
+        INSERT INTO meta_learning_optimizations (param_name, old_value, new_value, reason, improvement)
+        VALUES (?, ?, ?, ?, ?)
+      `).run(param.name, param.value, newValue, exploring ? 'exploration' : 'exploitation', rec.expectedImprovement);
+            this.logger.info(`Meta-learning: ${param.name} ${param.value.toFixed(4)} → ${newValue.toFixed(4)} (${exploring ? 'explore' : 'exploit'}, expected +${(rec.expectedImprovement * 100).toFixed(1)}%)`);
+            param.value = newValue;
+            rec.recommendedValue = newValue;
+            applied.push(rec);
+        }
+        return applied;
+    }
+    /**
+     * Run analysis + optimization if it's time. Call this after every learning cycle.
+     */
+    step(metrics, score) {
+        const snapshot = this.recordSnapshot(metrics, score);
+        let optimized = [];
+        if (this.cycleCount > 0 && this.cycleCount % this.analyzeInterval === 0) {
+            optimized = this.optimize();
+        }
+        return { snapshot, optimized };
+    }
+    /** Get current parameter values. */
+    getParams() {
+        const result = {};
+        for (const p of this.params) {
+            result[p.name] = p.value;
+        }
+        return result;
+    }
+    /** Update a parameter value externally (e.g. user override). */
+    setParam(name, value) {
+        const param = this.params.find(p => p.name === name);
+        if (!param)
+            return false;
+        param.value = Math.max(param.min, Math.min(param.max, value));
+        return true;
+    }
+    /** Get learning effectiveness status. */
+    getStatus() {
+        const snapshots = this.getSnapshots(100);
+        const optimizations = this.db.prepare('SELECT COUNT(*) as count FROM meta_learning_optimizations').get();
+        const scores = snapshots.map(s => s.score);
+        const currentScore = scores.length > 0 ? scores[0] : 0;
+        const bestScore = scores.length > 0 ? Math.max(...scores) : 0;
+        const worstScore = scores.length > 0 ? Math.min(...scores) : 0;
+        // Trend detection: compare average of last 5 vs previous 5
+        let trend = 'stable';
+        if (scores.length >= 10) {
+            const recent = scores.slice(0, 5).reduce((a, b) => a + b, 0) / 5;
+            const previous = scores.slice(5, 10).reduce((a, b) => a + b, 0) / 5;
+            const delta = recent - previous;
+            if (delta > 0.05)
+                trend = 'improving';
+            else if (delta < -0.05)
+                trend = 'declining';
+        }
+        return {
+            totalSnapshots: snapshots.length,
+            totalOptimizations: optimizations.count,
+            bestScore,
+            worstScore,
+            currentScore,
+            trend,
+            recommendations: this.analyze(),
+        };
+    }
+    /** Get optimization history. */
+    getHistory(limit = 20) {
+        return this.db.prepare('SELECT * FROM meta_learning_optimizations ORDER BY created_at DESC LIMIT ?').all(limit);
+    }
+    // ── Private ─────────────────────────────────────────
+    getSnapshots(limit) {
+        const rows = this.db.prepare('SELECT * FROM meta_learning_snapshots ORDER BY cycle DESC LIMIT ?').all(limit);
+        return rows.map(r => ({
+            id: r.id,
+            cycle: r.cycle,
+            params: JSON.parse(r.params),
+            metrics: JSON.parse(r.metrics),
+            score: r.score,
+            created_at: r.created_at,
+        }));
+    }
+    /**
+     * Analyze a single parameter's effect on learning effectiveness.
+     *
+     * Algorithm:
+     * 1. Divide the parameter's range into bins
+     * 2. For each bin, calculate the average score of snapshots in that bin
+     * 3. Find the bin with the highest average score
+     * 4. Recommend moving towards the center of that bin
+     */
+    analyzeParameter(param, snapshots) {
+        const numBins = 5;
+        const range = param.max - param.min;
+        if (range <= 0)
+            return null;
+        const binSize = range / numBins;
+        // Accumulate scores per bin
+        const bins = Array.from({ length: numBins }, () => ({ sum: 0, count: 0 }));
+        for (const snap of snapshots) {
+            const val = snap.params[param.name];
+            if (val === undefined)
+                continue;
+            const binIdx = Math.min(numBins - 1, Math.floor((val - param.min) / binSize));
+            bins[binIdx].sum += snap.score;
+            bins[binIdx].count++;
+        }
+        // Find best bin (minimum 2 samples)
+        let bestBin = -1;
+        let bestAvg = -Infinity;
+        let totalSamples = 0;
+        for (let i = 0; i < numBins; i++) {
+            if (bins[i].count < 2)
+                continue;
+            const avg = bins[i].sum / bins[i].count;
+            totalSamples += bins[i].count;
+            if (avg > bestAvg) {
+                bestAvg = avg;
+                bestBin = i;
+            }
+        }
+        if (bestBin === -1)
+            return null; // not enough data
+        // Calculate recommended value (center of best bin)
+        const recommended = param.min + (bestBin + 0.5) * binSize;
+        // Skip if current value is already in or near the best bin
+        const currentBin = Math.min(numBins - 1, Math.floor((param.value - param.min) / binSize));
+        if (currentBin === bestBin)
+            return null;
+        // Estimate improvement
+        const currentBinAvg = bins[currentBin].count > 0
+            ? bins[currentBin].sum / bins[currentBin].count
+            : 0;
+        const expectedImprovement = currentBinAvg > 0
+            ? (bestAvg - currentBinAvg) / currentBinAvg
+            : 0;
+        // Confidence: based on sample count in best bin
+        const confidence = Math.min(1, bins[bestBin].count / 10);
+        return {
+            name: param.name,
+            currentValue: param.value,
+            recommendedValue: recommended,
+            expectedImprovement,
+            confidence,
+            evidence: totalSamples,
+        };
+    }
+}
+//# sourceMappingURL=engine.js.map

package/dist/meta-learning/engine.js.map

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

package/dist/webhooks/service.d.ts

@@ -0,0 +1,65 @@
+import type Database from 'better-sqlite3';
+export interface WebhookConfig {
+    id?: number;
+    url: string;
+    events: string[];
+    secret?: string;
+    active?: boolean;
+    name?: string;
+}
+export interface WebhookRecord {
+    id: number;
+    url: string;
+    events: string;
+    secret: string | null;
+    active: number;
+    name: string | null;
+    created_at: string;
+}
+export interface DeliveryRecord {
+    id: number;
+    webhook_id: number;
+    event: string;
+    payload: string;
+    status: number;
+    response: string | null;
+    attempts: number;
+    created_at: string;
+}
+export interface WebhookDeliveryResult {
+    webhookId: number;
+    url: string;
+    status: number;
+    success: boolean;
+    attempts: number;
+}
+export declare function runWebhookMigration(db: Database.Database): void;
+export declare class WebhookService {
+    private db;
+    private logger;
+    private retryDelays;
+    constructor(db: Database.Database);
+    /** Register a new webhook endpoint. */
+    add(config: WebhookConfig): WebhookRecord;
+    /** Remove a webhook by ID. */
+    remove(id: number): boolean;
+    /** Get a single webhook by ID. */
+    get(id: number): WebhookRecord | null;
+    /** List all webhooks. */
+    list(): WebhookRecord[];
+    /** Toggle a webhook active/inactive. */
+    toggle(id: number, active: boolean): boolean;
+    /** Get delivery history for a webhook (most recent first). */
+    history(webhookId?: number, limit?: number): DeliveryRecord[];
+    /**
+     * Fire an event to all matching webhooks.
+     * Returns delivery results (non-blocking — fire and forget with retry).
+     */
+    fire(event: string, data: unknown): Promise<WebhookDeliveryResult[]>;
+    /** Deliver a payload to a single webhook with retries. */
+    private deliver;
+    private recordDelivery;
+    private delay;
+    /** Cleanup old delivery records. */
+    cleanup(olderThanDays?: number): number;
+}

package/dist/webhooks/service.js

@@ -0,0 +1,157 @@
+import crypto from 'node:crypto';
+import { getLogger } from '../utils/logger.js';
+// ── Migration ───────────────────────────────────────────
+export function runWebhookMigration(db) {
+    db.exec(`
+    CREATE TABLE IF NOT EXISTS webhooks (
+      id INTEGER PRIMARY KEY AUTOINCREMENT,
+      url TEXT NOT NULL,
+      events TEXT NOT NULL DEFAULT '[]',
+      secret TEXT,
+      active INTEGER NOT NULL DEFAULT 1,
+      name TEXT,
+      created_at TEXT NOT NULL DEFAULT (datetime('now'))
+    );
+
+    CREATE TABLE IF NOT EXISTS webhook_deliveries (
+      id INTEGER PRIMARY KEY AUTOINCREMENT,
+      webhook_id INTEGER NOT NULL REFERENCES webhooks(id) ON DELETE CASCADE,
+      event TEXT NOT NULL,
+      payload TEXT NOT NULL,
+      status INTEGER NOT NULL DEFAULT 0,
+      response TEXT,
+      attempts INTEGER NOT NULL DEFAULT 0,
+      created_at TEXT NOT NULL DEFAULT (datetime('now'))
+    );
+
+    CREATE INDEX IF NOT EXISTS idx_webhook_deliveries_webhook_id ON webhook_deliveries(webhook_id);
+    CREATE INDEX IF NOT EXISTS idx_webhook_deliveries_created_at ON webhook_deliveries(created_at);
+  `);
+}
+// ── Service ─────────────────────────────────────────────
+export class WebhookService {
+    db;
+    logger = getLogger();
+    retryDelays = [1000, 3000, 10000]; // 1s, 3s, 10s
+    constructor(db) {
+        this.db = db;
+        runWebhookMigration(db);
+    }
+    /** Register a new webhook endpoint. */
+    add(config) {
+        const stmt = this.db.prepare(`
+      INSERT INTO webhooks (url, events, secret, active, name)
+      VALUES (?, ?, ?, ?, ?)
+    `);
+        const info = stmt.run(config.url, JSON.stringify(config.events), config.secret ?? null, config.active !== false ? 1 : 0, config.name ?? null);
+        this.logger.info(`Webhook #${info.lastInsertRowid} registered: ${config.url}`);
+        return this.get(Number(info.lastInsertRowid));
+    }
+    /** Remove a webhook by ID. */
+    remove(id) {
+        const info = this.db.prepare('DELETE FROM webhooks WHERE id = ?').run(id);
+        return info.changes > 0;
+    }
+    /** Get a single webhook by ID. */
+    get(id) {
+        return this.db.prepare('SELECT * FROM webhooks WHERE id = ?').get(id);
+    }
+    /** List all webhooks. */
+    list() {
+        return this.db.prepare('SELECT * FROM webhooks ORDER BY created_at DESC').all();
+    }
+    /** Toggle a webhook active/inactive. */
+    toggle(id, active) {
+        const info = this.db.prepare('UPDATE webhooks SET active = ? WHERE id = ?').run(active ? 1 : 0, id);
+        return info.changes > 0;
+    }
+    /** Get delivery history for a webhook (most recent first). */
+    history(webhookId, limit = 50) {
+        if (webhookId) {
+            return this.db.prepare('SELECT * FROM webhook_deliveries WHERE webhook_id = ? ORDER BY created_at DESC LIMIT ?').all(webhookId, limit);
+        }
+        return this.db.prepare('SELECT * FROM webhook_deliveries ORDER BY created_at DESC LIMIT ?').all(limit);
+    }
+    /**
+     * Fire an event to all matching webhooks.
+     * Returns delivery results (non-blocking — fire and forget with retry).
+     */
+    async fire(event, data) {
+        const webhooks = this.db.prepare('SELECT * FROM webhooks WHERE active = 1').all();
+        const matching = webhooks.filter(wh => {
+            const events = JSON.parse(wh.events);
+            return events.includes('*') || events.includes(event);
+        });
+        if (matching.length === 0)
+            return [];
+        const payload = JSON.stringify({ event, data, timestamp: new Date().toISOString() });
+        const results = [];
+        await Promise.all(matching.map(async (wh) => {
+            const result = await this.deliver(wh, event, payload);
+            results.push(result);
+        }));
+        return results;
+    }
+    /** Deliver a payload to a single webhook with retries. */
+    async deliver(wh, event, payload) {
+        let lastStatus = 0;
+        let lastResponse = null;
+        let attempts = 0;
+        for (let i = 0; i <= this.retryDelays.length; i++) {
+            attempts++;
+            try {
+                const headers = {
+                    'Content-Type': 'application/json',
+                    'X-Webhook-Event': event,
+                };
+                // HMAC signing
+                if (wh.secret) {
+                    const signature = crypto
+                        .createHmac('sha256', wh.secret)
+                        .update(payload)
+                        .digest('hex');
+                    headers['X-Webhook-Signature'] = `sha256=${signature}`;
+                }
+                const response = await fetch(wh.url, {
+                    method: 'POST',
+                    headers,
+                    body: payload,
+                    signal: AbortSignal.timeout(10_000),
+                });
+                lastStatus = response.status;
+                lastResponse = await response.text().catch(() => null);
+                if (response.ok) {
+                    this.recordDelivery(wh.id, event, payload, lastStatus, lastResponse, attempts);
+                    return { webhookId: wh.id, url: wh.url, status: lastStatus, success: true, attempts };
+                }
+            }
+            catch (err) {
+                lastStatus = 0;
+                lastResponse = err instanceof Error ? err.message : String(err);
+            }
+            // Retry delay (don't delay after last attempt)
+            if (i < this.retryDelays.length) {
+                await this.delay(this.retryDelays[i]);
+            }
+        }
+        // All retries exhausted
+        this.recordDelivery(wh.id, event, payload, lastStatus, lastResponse, attempts);
+        this.logger.warn(`Webhook #${wh.id} delivery failed after ${attempts} attempts: ${wh.url}`);
+        return { webhookId: wh.id, url: wh.url, status: lastStatus, success: false, attempts };
+    }
+    recordDelivery(webhookId, event, payload, status, response, attempts) {
+        this.db.prepare(`
+      INSERT INTO webhook_deliveries (webhook_id, event, payload, status, response, attempts)
+      VALUES (?, ?, ?, ?, ?, ?)
+    `).run(webhookId, event, payload, status, response, attempts);
+    }
+    delay(ms) {
+        return new Promise(resolve => setTimeout(resolve, ms));
+    }
+    /** Cleanup old delivery records. */
+    cleanup(olderThanDays = 30) {
+        const info = this.db.prepare(`DELETE FROM webhook_deliveries WHERE created_at < datetime('now', '-' || ? || ' days')`).run(olderThanDays);
+        return info.changes;
+    }
+}
+//# sourceMappingURL=service.js.map

package/dist/webhooks/service.js.map

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