daemora 1.0.0-alpha.0

package/dist/watchers/PollWatcher.d.ts

@@ -0,0 +1,54 @@
+/**
+ * PollWatcher — periodic HTTP fetch + diff. Fires when the response
+ * body changes.
+ *
+ * Config (stored in the watcher's `pattern` JSON blob):
+ *   __url          URL to fetch (required)
+ *   __intervalMs   poll cadence (default 5 min; minimum 10 s)
+ *   __method       HTTP method (default "GET")
+ *   __headers      optional headers object
+ *   __diffField    optional JSONPath-lite into the body to isolate the
+ *                  "did anything change" signal. Example: "items[0].id".
+ *                  When omitted, we hash the entire body.
+ *
+ * Diff strategy:
+ *   - Fetch → read body → if __diffField set, project it → hash
+ *   - First poll always seeds state and does NOT fire (avoids a trigger
+ *     storm on startup). Every subsequent differing hash fires.
+ *   - HTTP 4xx/5xx does not fire. It logs + retries next interval.
+ *   - Last-state is in-memory only; restart re-seeds on first poll.
+ *
+ * This is deliberately the minimum viable poll. RSS / websub / feed
+ * diffing are out of scope — users can write a crew for specialised
+ * diff logic and trigger it via a simpler poll.
+ */
+export interface PollWatcherConfig {
+    readonly url: string;
+    readonly intervalMs?: number;
+    readonly method?: string;
+    readonly headers?: Record<string, string>;
+    readonly diffField?: string;
+}
+export interface PollWatcherFireEvent {
+    readonly url: string;
+    readonly status: number;
+    readonly body: string;
+    readonly hash: string;
+    readonly previousHash: string | null;
+}
+export type PollWatcherCallback = (ev: PollWatcherFireEvent) => void;
+export declare class PollWatcher {
+    private readonly config;
+    private readonly onFire;
+    private timer;
+    private lastHash;
+    private polling;
+    private readonly intervalMs;
+    constructor(config: PollWatcherConfig, onFire: PollWatcherCallback);
+    start(): void;
+    stop(): void;
+    /** Exposed for manual trigger + tests. */
+    poll(): Promise<void>;
+    private hashFor;
+}
+//# sourceMappingURL=PollWatcher.d.ts.map

package/dist/watchers/PollWatcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PollWatcher.d.ts","sourceRoot":"","sources":["../../src/watchers/PollWatcher.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAWH,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC1C,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;CACtC;AAED,MAAM,MAAM,mBAAmB,GAAG,CAAC,EAAE,EAAE,oBAAoB,KAAK,IAAI,CAAC;AAErE,qBAAa,WAAW;IAOpB,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,MAAM;IAPzB,OAAO,CAAC,KAAK,CAA+C;IAC5D,OAAO,CAAC,QAAQ,CAAuB;IACvC,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;gBAGjB,MAAM,EAAE,iBAAiB,EACzB,MAAM,EAAE,mBAAmB;IAM9C,KAAK,IAAI,IAAI;IASb,IAAI,IAAI,IAAI;IAOZ,0CAA0C;IACpC,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAoC3B,OAAO,CAAC,OAAO;CAgBhB"}

package/dist/watchers/PollWatcher.js

@@ -0,0 +1,135 @@
+/**
+ * PollWatcher — periodic HTTP fetch + diff. Fires when the response
+ * body changes.
+ *
+ * Config (stored in the watcher's `pattern` JSON blob):
+ *   __url          URL to fetch (required)
+ *   __intervalMs   poll cadence (default 5 min; minimum 10 s)
+ *   __method       HTTP method (default "GET")
+ *   __headers      optional headers object
+ *   __diffField    optional JSONPath-lite into the body to isolate the
+ *                  "did anything change" signal. Example: "items[0].id".
+ *                  When omitted, we hash the entire body.
+ *
+ * Diff strategy:
+ *   - Fetch → read body → if __diffField set, project it → hash
+ *   - First poll always seeds state and does NOT fire (avoids a trigger
+ *     storm on startup). Every subsequent differing hash fires.
+ *   - HTTP 4xx/5xx does not fire. It logs + retries next interval.
+ *   - Last-state is in-memory only; restart re-seeds on first poll.
+ *
+ * This is deliberately the minimum viable poll. RSS / websub / feed
+ * diffing are out of scope — users can write a crew for specialised
+ * diff logic and trigger it via a simpler poll.
+ */
+import { createHash } from "node:crypto";
+import { createLogger } from "../util/logger.js";
+const log = createLogger("poll-watcher");
+const DEFAULT_INTERVAL_MS = 5 * 60_000;
+const MIN_INTERVAL_MS = 10_000;
+export class PollWatcher {
+    config;
+    onFire;
+    timer = null;
+    lastHash = null;
+    polling = false;
+    intervalMs;
+    constructor(config, onFire) {
+        this.config = config;
+        this.onFire = onFire;
+        const requested = config.intervalMs ?? DEFAULT_INTERVAL_MS;
+        this.intervalMs = Math.max(MIN_INTERVAL_MS, requested);
+    }
+    start() {
+        if (this.timer)
+            return;
+        // First poll on a microtask so start() can return synchronously.
+        void this.poll();
+        this.timer = setInterval(() => void this.poll(), this.intervalMs);
+        this.timer.unref?.();
+        log.info({ url: this.config.url, intervalMs: this.intervalMs }, "poll watcher started");
+    }
+    stop() {
+        if (this.timer) {
+            clearInterval(this.timer);
+            this.timer = null;
+        }
+    }
+    /** Exposed for manual trigger + tests. */
+    async poll() {
+        if (this.polling)
+            return;
+        this.polling = true;
+        try {
+            const res = await fetch(this.config.url, {
+                method: this.config.method ?? "GET",
+                ...(this.config.headers ? { headers: this.config.headers } : {}),
+            });
+            if (!res.ok) {
+                log.warn({ url: this.config.url, status: res.status }, "poll returned non-2xx");
+                return;
+            }
+            const body = await res.text();
+            const hash = this.hashFor(body);
+            if (this.lastHash === null) {
+                // Seed state — first poll never fires, so a newly-created
+                // watcher doesn't dump the current state as a "change".
+                this.lastHash = hash;
+                log.debug({ url: this.config.url, hash }, "poll seeded");
+                return;
+            }
+            if (hash === this.lastHash)
+                return;
+            const previousHash = this.lastHash;
+            this.lastHash = hash;
+            try {
+                this.onFire({ url: this.config.url, status: res.status, body, hash, previousHash });
+            }
+            catch (e) {
+                log.error({ err: e.message }, "poll callback threw");
+            }
+        }
+        catch (e) {
+            log.warn({ url: this.config.url, err: e.message }, "poll fetch failed");
+        }
+        finally {
+            this.polling = false;
+        }
+    }
+    hashFor(body) {
+        let payload;
+        if (this.config.diffField) {
+            try {
+                const parsed = JSON.parse(body);
+                const projected = project(parsed, this.config.diffField);
+                payload = JSON.stringify(projected);
+            }
+            catch {
+                // diffField was configured but body isn't JSON — fall back to full body.
+                payload = body;
+            }
+        }
+        else {
+            payload = body;
+        }
+        return createHash("sha256").update(payload).digest("hex");
+    }
+}
+/**
+ * Very small JSONPath-lite: dotted keys + `[N]` array indexing.
+ * Example: `items[0].id` against `{ items: [{ id: 42 }] }` → 42.
+ * Anything unresolvable returns undefined.
+ */
+function project(obj, path) {
+    const parts = path.replace(/\[(\d+)\]/g, ".$1").split(".").filter(Boolean);
+    let cur = obj;
+    for (const key of parts) {
+        if (cur === null || cur === undefined)
+            return undefined;
+        if (typeof cur !== "object")
+            return undefined;
+        cur = cur[key];
+    }
+    return cur;
+}
+//# sourceMappingURL=PollWatcher.js.map

package/dist/watchers/PollWatcher.js.map

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

package/dist/watchers/WatcherRunner.d.ts

@@ -0,0 +1,49 @@
+/**
+ * WatcherRunner — supervises file + poll watchers defined in WatcherStore.
+ *
+ * Webhook watchers are driven by incoming HTTP (see WebhookHandler).
+ * File and poll watchers run in-process; this class owns their lifecycle.
+ *
+ * On start(): spawn a FileWatcher or PollWatcher per enabled row.
+ * On reload(): diff the current set against the store and add/remove
+ *              watchers whose enabled/triggerType/config changed.
+ * On stop():  tear everything down cleanly.
+ *
+ * When a watcher fires, we respect its `__cooldownSeconds` (same as the
+ * webhook path) and enqueue a task via the TaskRunner with the watcher's
+ * action prompt and a payload describing what changed.
+ */
+import type { TaskRunner } from "../core/TaskRunner.js";
+import type { IntegrationManager } from "../integrations/IntegrationManager.js";
+import type { WatcherStore } from "./WatcherStore.js";
+interface WatcherRunnerDeps {
+    readonly store: WatcherStore;
+    /** Required for integration watchers; optional so the runner still
+     *  boots when no integrations are configured. */
+    readonly integrations?: IntegrationManager;
+    readonly runner: TaskRunner;
+}
+export declare class WatcherRunner {
+    private readonly deps;
+    private readonly active;
+    private started;
+    constructor(deps: WatcherRunnerDeps);
+    start(): void;
+    stop(): void;
+    /**
+     * Sync active watchers with the store. Adds newly-enabled rows,
+     * removes newly-disabled ones, restarts any whose config signature
+     * changed (url, path, interval, etc.).
+     */
+    reload(): void;
+    get activeCount(): number;
+    private spawn;
+    private fire;
+    /**
+     * Any change to enabled/triggerType/pattern should trigger a restart.
+     * We deliberately do NOT include lastTriggeredAt/triggerCount.
+     */
+    private signatureFor;
+}
+export {};
+//# sourceMappingURL=WatcherRunner.d.ts.map

package/dist/watchers/WatcherRunner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"WatcherRunner.d.ts","sourceRoot":"","sources":["../../src/watchers/WatcherRunner.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,uCAAuC,CAAC;AAGhF,OAAO,KAAK,EAAc,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAYlE,UAAU,iBAAiB;IACzB,QAAQ,CAAC,KAAK,EAAE,YAAY,CAAC;IAC7B;qDACiD;IACjD,QAAQ,CAAC,YAAY,CAAC,EAAE,kBAAkB,CAAC;IAC3C,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC;CAC7B;AAED,qBAAa,aAAa;IAIZ,OAAO,CAAC,QAAQ,CAAC,IAAI;IAHjC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAiC;IACxD,OAAO,CAAC,OAAO,CAAS;gBAEK,IAAI,EAAE,iBAAiB;IAEpD,KAAK,IAAI,IAAI;IAOb,IAAI,IAAI,IAAI;IAOZ;;;;OAIG;IACH,MAAM,IAAI,IAAI;IAkCd,IAAI,WAAW,IAAI,MAAM,CAExB;IAID,OAAO,CAAC,KAAK;IAuFb,OAAO,CAAC,IAAI;IAoBZ;;;OAGG;IACH,OAAO,CAAC,YAAY;CAGrB"}

package/dist/watchers/WatcherRunner.js

@@ -0,0 +1,203 @@
+/**
+ * WatcherRunner — supervises file + poll watchers defined in WatcherStore.
+ *
+ * Webhook watchers are driven by incoming HTTP (see WebhookHandler).
+ * File and poll watchers run in-process; this class owns their lifecycle.
+ *
+ * On start(): spawn a FileWatcher or PollWatcher per enabled row.
+ * On reload(): diff the current set against the store and add/remove
+ *              watchers whose enabled/triggerType/config changed.
+ * On stop():  tear everything down cleanly.
+ *
+ * When a watcher fires, we respect its `__cooldownSeconds` (same as the
+ * webhook path) and enqueue a task via the TaskRunner with the watcher's
+ * action prompt and a payload describing what changed.
+ */
+import { createLogger } from "../util/logger.js";
+import { FileWatcher } from "./FileWatcher.js";
+import { IntegrationWatcher } from "./IntegrationWatcher.js";
+import { PollWatcher } from "./PollWatcher.js";
+const log = createLogger("watcher-runner");
+export class WatcherRunner {
+    deps;
+    active = new Map();
+    started = false;
+    constructor(deps) {
+        this.deps = deps;
+    }
+    start() {
+        if (this.started)
+            return;
+        this.started = true;
+        this.reload();
+        log.info({ count: this.active.size }, "watcher runner started");
+    }
+    stop() {
+        for (const w of this.active.values())
+            w.instance.stop();
+        this.active.clear();
+        this.started = false;
+        log.info("watcher runner stopped");
+    }
+    /**
+     * Sync active watchers with the store. Adds newly-enabled rows,
+     * removes newly-disabled ones, restarts any whose config signature
+     * changed (url, path, interval, etc.).
+     */
+    reload() {
+        const rows = this.deps.store.list().filter((w) => w.enabled && (w.triggerType === "file"
+            || w.triggerType === "poll"
+            || w.triggerType === "integration"));
+        const wantedIds = new Set(rows.map((r) => r.id));
+        // Tear down watchers that are no longer enabled / no longer present.
+        for (const [id, w] of this.active.entries()) {
+            if (!wantedIds.has(id)) {
+                w.instance.stop();
+                this.active.delete(id);
+                log.info({ id }, "watcher stopped (removed/disabled)");
+            }
+        }
+        // Start or restart each active row.
+        for (const row of rows) {
+            try {
+                const signature = this.signatureFor(row);
+                const existing = this.active.get(row.id);
+                if (existing && existing.signature === signature)
+                    continue;
+                if (existing)
+                    existing.instance.stop();
+                const started = this.spawn(row);
+                if (started)
+                    this.active.set(row.id, started);
+            }
+            catch (e) {
+                log.error({ id: row.id, err: e.message }, "watcher start failed");
+            }
+        }
+    }
+    get activeCount() {
+        return this.active.size;
+    }
+    // ── internal ──────────────────────────────────────────────────────
+    spawn(row) {
+        const cfg = parseConfig(row.pattern);
+        if (row.triggerType === "file") {
+            const path = stringFrom(cfg["__path"]);
+            if (!path)
+                throw new Error(`watcher ${row.name}: __path required`);
+            const instance = new FileWatcher({
+                path,
+                ...(typeof cfg["__recursive"] === "boolean" ? { recursive: cfg["__recursive"] } : {}),
+                ...(typeof cfg["__debounceMs"] === "number" ? { debounceMs: cfg["__debounceMs"] } : {}),
+                ...(Array.isArray(cfg["__events"])
+                    ? { events: cfg["__events"].filter(isFileKind) }
+                    : {}),
+            }, (ev) => this.fire(row, { type: "file", ...ev }));
+            instance.start();
+            log.info({ id: row.id, name: row.name, path }, "file watcher armed");
+            return { kind: "file", instance, signature: this.signatureFor(row) };
+        }
+        if (row.triggerType === "poll") {
+            const url = stringFrom(cfg["__url"]);
+            if (!url)
+                throw new Error(`watcher ${row.name}: __url required`);
+            const instance = new PollWatcher({
+                url,
+                ...(typeof cfg["__intervalMs"] === "number" ? { intervalMs: cfg["__intervalMs"] } : {}),
+                ...(typeof cfg["__method"] === "string" ? { method: cfg["__method"] } : {}),
+                ...(isStringRecord(cfg["__headers"]) ? { headers: cfg["__headers"] } : {}),
+                ...(typeof cfg["__diffField"] === "string" ? { diffField: cfg["__diffField"] } : {}),
+            }, (ev) => this.fire(row, {
+                type: "poll",
+                url: ev.url,
+                status: ev.status,
+                previewBody: ev.body.slice(0, 2_000),
+            }));
+            instance.start();
+            log.info({ id: row.id, name: row.name, url }, "poll watcher armed");
+            return { kind: "poll", instance, signature: this.signatureFor(row) };
+        }
+        if (row.triggerType === "integration") {
+            if (!this.deps.integrations) {
+                log.warn({ id: row.id, name: row.name }, "integration watcher requested but IntegrationManager not wired");
+                return null;
+            }
+            const integration = stringFrom(cfg["__integration"]);
+            const event = stringFrom(cfg["__event"]);
+            if (!integration || !event) {
+                throw new Error(`watcher ${row.name}: __integration and __event required`);
+            }
+            const params = {};
+            if (isStringRecord(cfg["__params"])) {
+                for (const [k, v] of Object.entries(cfg["__params"])) {
+                    if (typeof v === "string")
+                        params[k] = v;
+                }
+            }
+            const instance = new IntegrationWatcher(this.deps.integrations, {
+                integration,
+                event,
+                ...(typeof cfg["__intervalMs"] === "number" ? { intervalMs: cfg["__intervalMs"] } : {}),
+                params,
+            }, (ev) => this.fire(row, {
+                type: "integration",
+                integration: ev.integration,
+                event: ev.event,
+                item: ev.item,
+            }));
+            instance.start();
+            log.info({ id: row.id, name: row.name, integration, event }, "integration watcher armed");
+            return { kind: "integration", instance, signature: this.signatureFor(row) };
+        }
+        return null;
+    }
+    fire(row, payload) {
+        const cfg = parseConfig(row.pattern);
+        const cooldown = typeof cfg["__cooldownSeconds"] === "number" ? cfg["__cooldownSeconds"] : 0;
+        if (cooldown > 0 && row.lastTriggeredAt !== null) {
+            const elapsed = (Date.now() - row.lastTriggeredAt) / 1000;
+            if (elapsed < cooldown) {
+                log.debug({ id: row.id, remaining: Math.ceil(cooldown - elapsed) }, "watcher cooldown — skipping");
+                return;
+            }
+        }
+        const input = `[Watcher: ${row.name}] ${row.action}\n\nPayload:\n${JSON.stringify(payload, null, 2)}`;
+        const handle = this.deps.runner.run({
+            input,
+            sessionId: "main",
+            ...(row.channel ? { channel: row.channel } : {}),
+        });
+        this.deps.store.markTriggered(row.id);
+        log.info({ id: row.id, name: row.name, taskId: handle.taskId }, "watcher fired");
+    }
+    /**
+     * Any change to enabled/triggerType/pattern should trigger a restart.
+     * We deliberately do NOT include lastTriggeredAt/triggerCount.
+     */
+    signatureFor(row) {
+        return `${row.triggerType}|${row.enabled ? 1 : 0}|${row.pattern}|${row.channel ?? ""}|${row.action}`;
+    }
+}
+function parseConfig(raw) {
+    if (!raw)
+        return {};
+    try {
+        const obj = JSON.parse(raw);
+        return typeof obj === "object" && obj !== null ? obj : {};
+    }
+    catch {
+        return {};
+    }
+}
+function stringFrom(v) {
+    return typeof v === "string" && v.length > 0 ? v : null;
+}
+function isStringRecord(v) {
+    if (!v || typeof v !== "object")
+        return false;
+    return Object.values(v).every((x) => typeof x === "string");
+}
+function isFileKind(v) {
+    return v === "add" || v === "change" || v === "unlink";
+}
+//# sourceMappingURL=WatcherRunner.js.map

package/dist/watchers/WatcherRunner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"WatcherRunner.js","sourceRoot":"","sources":["../../src/watchers/WatcherRunner.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAKH,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEjD,OAAO,EAAE,WAAW,EAAsB,MAAM,kBAAkB,CAAC;AACnE,OAAO,EAAE,kBAAkB,EAAyB,MAAM,yBAAyB,CAAC;AACpF,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAE/C,MAAM,GAAG,GAAG,YAAY,CAAC,gBAAgB,CAAC,CAAC;AAe3C,MAAM,OAAO,aAAa;IAIK;IAHZ,MAAM,GAAG,IAAI,GAAG,EAAsB,CAAC;IAChD,OAAO,GAAG,KAAK,CAAC;IAExB,YAA6B,IAAuB;QAAvB,SAAI,GAAJ,IAAI,CAAmB;IAAG,CAAC;IAExD,KAAK;QACH,IAAI,IAAI,CAAC,OAAO;YAAE,OAAO;QACzB,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC;QACpB,IAAI,CAAC,MAAM,EAAE,CAAC;QACd,GAAG,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,EAAE,wBAAwB,CAAC,CAAC;IAClE,CAAC;IAED,IAAI;QACF,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE;YAAE,CAAC,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;QACxD,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;QACpB,IAAI,CAAC,OAAO,GAAG,KAAK,CAAC;QACrB,GAAG,CAAC,IAAI,CAAC,wBAAwB,CAAC,CAAC;IACrC,CAAC;IAED;;;;OAIG;IACH,MAAM;QACJ,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,MAAM,CACxC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,IAAI,CAClB,CAAC,CAAC,WAAW,KAAK,MAAM;eACrB,CAAC,CAAC,WAAW,KAAK,MAAM;eACxB,CAAC,CAAC,WAAW,KAAK,aAAa,CACnC,CACF,CAAC;QACF,MAAM,SAAS,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;QAEjD,qEAAqE;QACrE,KAAK,MAAM,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,EAAE,CAAC;YAC5C,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC;gBACvB,CAAC,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;gBAClB,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;gBACvB,GAAG,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,EAAE,oCAAoC,CAAC,CAAC;YACzD,CAAC;QACH,CAAC;QAED,oCAAoC;QACpC,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;YACvB,IAAI,CAAC;gBACH,MAAM,SAAS,GAAG,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC;gBACzC,MAAM,QAAQ,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;gBACzC,IAAI,QAAQ,IAAI,QAAQ,CAAC,SAAS,KAAK,SAAS;oBAAE,SAAS;gBAC3D,IAAI,QAAQ;oBAAE,QAAQ,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;gBACvC,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;gBAChC,IAAI,OAAO;oBAAE,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,EAAE,OAAO,CAAC,CAAC;YAChD,CAAC;YAAC,OAAO,CAAC,EAAE,CAAC;gBACX,GAAG,CAAC,KAAK,CAAC,EAAE,EAAE,EAAE,GAAG,CAAC,EAAE,EAAE,GAAG,EAAG,CAAW,CAAC,OAAO,EAAE,EAAE,sBAAsB,CAAC,CAAC;YAC/E,CAAC;QACH,CAAC;IACH,CAAC;IAED,IAAI,WAAW;QACb,OAAO,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC;IAC1B,CAAC;IAED,qEAAqE;IAE7D,KAAK,CAAC,GAAe;QAC3B,MAAM,GAAG,GAAG,WAAW,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QAErC,IAAI,GAAG,CAAC,WAAW,KAAK,MAAM,EAAE,CAAC;YAC/B,MAAM,IAAI,GAAG,UAAU,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC;YACvC,IAAI,CAAC,IAAI;gBAAE,MAAM,IAAI,KAAK,CAAC,WAAW,GAAG,CAAC,IAAI,mBAAmB,CAAC,CAAC;YACnE,MAAM,QAAQ,GAAG,IAAI,WAAW,CAC9B;gBACE,IAAI;gBACJ,GAAG,CAAC,OAAO,GAAG,CAAC,aAAa,CAAC,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,GAAG,CAAC,aAAa,CAAY,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBAChG,GAAG,CAAC,OAAO,GAAG,CAAC,cAAc,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,GAAG,CAAC,cAAc,CAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBACjG,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;oBAChC,CAAC,CAAC,EAAE,MAAM,EAAG,GAAG,CAAC,UAAU,CAAc,CAAC,MAAM,CAAC,UAAU,CAAC,EAAE;oBAC9D,CAAC,CAAC,EAAE,CAAC;aACR,EACD,CAAC,EAAE,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,EAAE,CAAC,CAChD,CAAC;YACF,QAAQ,CAAC,KAAK,EAAE,CAAC;YACjB,GAAG,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,GAAG,CAAC,EAAE,EAAE,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE,IAAI,EAAE,EAAE,oBAAoB,CAAC,CAAC;YACrE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,SAAS,EAAE,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,EAAE,CAAC;QACvE,CAAC;QAED,IAAI,GAAG,CAAC,WAAW,KAAK,MAAM,EAAE,CAAC;YAC/B,MAAM,GAAG,GAAG,UAAU,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC;YACrC,IAAI,CAAC,GAAG;gBAAE,MAAM,IAAI,KAAK,CAAC,WAAW,GAAG,CAAC,IAAI,kBAAkB,CAAC,CAAC;YACjE,MAAM,QAAQ,GAAG,IAAI,WAAW,CAC9B;gBACE,GAAG;gBACH,GAAG,CAAC,OAAO,GAAG,CAAC,cAAc,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,GAAG,CAAC,cAAc,CAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBACjG,GAAG,CAAC,OAAO,GAAG,CAAC,UAAU,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,GAAG,CAAC,UAAU,CAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBACrF,GAAG,CAAC,cAAc,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,GAAG,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBAC1E,GAAG,CAAC,OAAO,GAAG,CAAC,aAAa,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,GAAG,CAAC,aAAa,CAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aAC/F,EACD,CAAC,EAAE,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE;gBACrB,IAAI,EAAE,MAAM;gBACZ,GAAG,EAAE,EAAE,CAAC,GAAG;gBACX,MAAM,EAAE,EAAE,CAAC,MAAM;gBACjB,WAAW,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC;aACrC,CAAC,CACH,CAAC;YACF,QAAQ,CAAC,KAAK,EAAE,CAAC;YACjB,GAAG,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,GAAG,CAAC,EAAE,EAAE,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE,GAAG,EAAE,EAAE,oBAAoB,CAAC,CAAC;YACpE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,SAAS,EAAE,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,EAAE,CAAC;QACvE,CAAC;QAED,IAAI,GAAG,CAAC,WAAW,KAAK,aAAa,EAAE,CAAC;YACtC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,CAAC;gBAC5B,GAAG,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,GAAG,CAAC,EAAE,EAAE,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE,EAAE,gEAAgE,CAAC,CAAC;gBAC3G,OAAO,IAAI,CAAC;YACd,CAAC;YACD,MAAM,WAAW,GAAG,UAAU,CAAC,GAAG,CAAC,eAAe,CAAC,CAAuB,CAAC;YAC3E,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,CAAC,SAAS,CAAC,CAA0B,CAAC;YAClE,IAAI,CAAC,WAAW,IAAI,CAAC,KAAK,EAAE,CAAC;gBAC3B,MAAM,IAAI,KAAK,CAAC,WAAW,GAAG,CAAC,IAAI,sCAAsC,CAAC,CAAC;YAC7E,CAAC;YACD,MAAM,MAAM,GAA2B,EAAE,CAAC;YAC1C,IAAI,cAAc,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,EAAE,CAAC;gBACpC,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,EAAE,CAAC;oBACrD,IAAI,OAAO,CAAC,KAAK,QAAQ;wBAAE,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;gBAC3C,CAAC;YACH,CAAC;YACD,MAAM,QAAQ,GAAG,IAAI,kBAAkB,CACrC,IAAI,CAAC,IAAI,CAAC,YAAY,EACtB;gBACE,WAAW;gBACX,KAAK;gBACL,GAAG,CAAC,OAAO,GAAG,CAAC,cAAc,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,GAAG,CAAC,cAAc,CAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBACjG,MAAM;aACP,EACD,CAAC,EAAE,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE;gBACrB,IAAI,EAAE,aAAa;gBACnB,WAAW,EAAE,EAAE,CAAC,WAAW;gBAC3B,KAAK,EAAE,EAAE,CAAC,KAAK;gBACf,IAAI,EAAE,EAAE,CAAC,IAAI;aACd,CAAC,CACH,CAAC;YACF,QAAQ,CAAC,KAAK,EAAE,CAAC;YACjB,GAAG,CAAC,IAAI,CACN,EAAE,EAAE,EAAE,GAAG,CAAC,EAAE,EAAE,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE,WAAW,EAAE,KAAK,EAAE,EAClD,2BAA2B,CAC5B,CAAC;YACF,OAAO,EAAE,IAAI,EAAE,aAAa,EAAE,QAAQ,EAAE,SAAS,EAAE,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,EAAE,CAAC;QAC9E,CAAC;QAED,OAAO,IAAI,CAAC;IACd,CAAC;IAEO,IAAI,CAAC,GAAe,EAAE,OAAgC;QAC5D,MAAM,GAAG,GAAG,WAAW,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QACrC,MAAM,QAAQ,GAAG,OAAO,GAAG,CAAC,mBAAmB,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAE,GAAG,CAAC,mBAAmB,CAAY,CAAC,CAAC,CAAC,CAAC,CAAC;QACzG,IAAI,QAAQ,GAAG,CAAC,IAAI,GAAG,CAAC,eAAe,KAAK,IAAI,EAAE,CAAC;YACjD,MAAM,OAAO,GAAG,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,GAAG,CAAC,eAAe,CAAC,GAAG,IAAI,CAAC;YAC1D,IAAI,OAAO,GAAG,QAAQ,EAAE,CAAC;gBACvB,GAAG,CAAC,KAAK,CAAC,EAAE,EAAE,EAAE,GAAG,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,CAAC,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC,EAAE,EAAE,6BAA6B,CAAC,CAAC;gBACnG,OAAO;YACT,CAAC;QACH,CAAC;QACD,MAAM,KAAK,GAAG,aAAa,GAAG,CAAC,IAAI,KAAK,GAAG,CAAC,MAAM,iBAAiB,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;QACtG,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC;YAClC,KAAK;YACL,SAAS,EAAE,MAAM;YACjB,GAAG,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SACjD,CAAC,CAAC;QACH,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,aAAa,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACtC,GAAG,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,GAAG,CAAC,EAAE,EAAE,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,EAAE,eAAe,CAAC,CAAC;IACnF,CAAC;IAED;;;OAGG;IACK,YAAY,CAAC,GAAe;QAClC,OAAO,GAAG,GAAG,CAAC,WAAW,IAAI,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,OAAO,IAAI,GAAG,CAAC,OAAO,IAAI,EAAE,IAAI,GAAG,CAAC,MAAM,EAAE,CAAC;IACvG,CAAC;CACF;AAED,SAAS,WAAW,CAAC,GAAW;IAC9B,IAAI,CAAC,GAAG;QAAE,OAAO,EAAE,CAAC;IACpB,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAC5B,OAAO,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG,KAAK,IAAI,CAAC,CAAC,CAAE,GAA+B,CAAC,CAAC,CAAC,EAAE,CAAC;IACzF,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC;AAED,SAAS,UAAU,CAAC,CAAU;IAC5B,OAAO,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;AAC1D,CAAC;AAED,SAAS,cAAc,CAAC,CAAU;IAChC,IAAI,CAAC,CAAC,IAAI,OAAO,CAAC,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IAC9C,OAAO,MAAM,CAAC,MAAM,CAAC,CAAW,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC;AACxE,CAAC;AAED,SAAS,UAAU,CAAC,CAAS;IAC3B,OAAO,CAAC,KAAK,KAAK,IAAI,CAAC,KAAK,QAAQ,IAAI,CAAC,KAAK,QAAQ,CAAC;AACzD,CAAC"}

package/dist/watchers/WatcherStore.d.ts

@@ -0,0 +1,43 @@
+/**
+ * WatcherStore — event-driven triggers (webhooks, file watchers, polling).
+ *
+ * A watcher monitors a source and fires an action when a condition is met.
+ * Execution is handled by the WatcherRunner (separate from storage).
+ */
+import type Database from "better-sqlite3";
+export interface WatcherRow {
+    readonly id: string;
+    readonly name: string;
+    readonly triggerType: "webhook" | "poll" | "file" | "cron" | "integration";
+    readonly pattern: string;
+    readonly action: string;
+    readonly channel: string | null;
+    readonly enabled: boolean;
+    readonly lastTriggeredAt: number | null;
+    readonly triggerCount: number;
+    readonly createdAt: number;
+    readonly updatedAt: number;
+}
+export declare class WatcherStore {
+    private readonly db;
+    private readonly insert;
+    private readonly selectAll;
+    private readonly selectOne;
+    private readonly updateStmt;
+    private readonly deleteStmt;
+    private readonly recordTrigger;
+    constructor(db: Database.Database);
+    create(opts: {
+        name: string;
+        triggerType?: WatcherRow["triggerType"];
+        pattern?: string;
+        action?: string;
+        channel?: string;
+    }): WatcherRow;
+    list(): readonly WatcherRow[];
+    get(id: string): WatcherRow | null;
+    update(id: string, opts: Partial<Pick<WatcherRow, "name" | "triggerType" | "pattern" | "action" | "channel" | "enabled">>): boolean;
+    delete(id: string): boolean;
+    markTriggered(id: string): void;
+}
+//# sourceMappingURL=WatcherStore.d.ts.map

package/dist/watchers/WatcherStore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"WatcherStore.d.ts","sourceRoot":"","sources":["../../src/watchers/WatcherStore.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAC;AAM3C,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,WAAW,EAAE,SAAS,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,aAAa,CAAC;IAC3E,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IACxC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B;AAkBD,qBAAa,YAAY;IAQX,OAAO,CAAC,QAAQ,CAAC,EAAE;IAP/B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAqB;IAC5C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAqB;IAC/C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAqB;IAC/C,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAqB;IAChD,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAqB;IAChD,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAqB;gBAEtB,EAAE,EAAE,QAAQ,CAAC,QAAQ;IA4BlD,MAAM,CAAC,IAAI,EAAE;QACX,IAAI,EAAE,MAAM,CAAC;QACb,WAAW,CAAC,EAAE,UAAU,CAAC,aAAa,CAAC,CAAC;QACxC,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB,GAAG,UAAU;IAQd,IAAI,IAAI,SAAS,UAAU,EAAE;IAI7B,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI;IAIlC,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,CAAC,UAAU,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS,GAAG,QAAQ,GAAG,SAAS,GAAG,SAAS,CAAC,CAAC,GAAG,OAAO;IAgBnI,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IAI3B,aAAa,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;CAIhC"}

package/dist/watchers/WatcherStore.js

@@ -0,0 +1,78 @@
+/**
+ * WatcherStore — event-driven triggers (webhooks, file watchers, polling).
+ *
+ * A watcher monitors a source and fires an action when a condition is met.
+ * Execution is handled by the WatcherRunner (separate from storage).
+ */
+import { randomUUID } from "node:crypto";
+import { createLogger } from "../util/logger.js";
+const log = createLogger("watchers");
+const SCHEMA = `
+CREATE TABLE IF NOT EXISTS watchers (
+  id                TEXT PRIMARY KEY,
+  name              TEXT NOT NULL,
+  trigger_type      TEXT NOT NULL DEFAULT 'webhook',
+  pattern           TEXT NOT NULL DEFAULT '',
+  action            TEXT NOT NULL DEFAULT '',
+  channel           TEXT,
+  enabled           INTEGER NOT NULL DEFAULT 1,
+  last_triggered_at INTEGER,
+  trigger_count     INTEGER NOT NULL DEFAULT 0,
+  created_at        INTEGER NOT NULL,
+  updated_at        INTEGER NOT NULL
+);
+`;
+export class WatcherStore {
+    db;
+    insert;
+    selectAll;
+    selectOne;
+    updateStmt;
+    deleteStmt;
+    recordTrigger;
+    constructor(db) {
+        this.db = db;
+        db.exec(SCHEMA);
+        this.insert = db.prepare(`INSERT INTO watchers (id, name, trigger_type, pattern, action, channel, enabled, created_at, updated_at)
+       VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?)`);
+        this.selectAll = db.prepare(`SELECT id, name, trigger_type AS triggerType, pattern, action, channel,
+              enabled, last_triggered_at AS lastTriggeredAt, trigger_count AS triggerCount,
+              created_at AS createdAt, updated_at AS updatedAt
+       FROM watchers ORDER BY created_at DESC`);
+        this.selectOne = db.prepare(`SELECT id, name, trigger_type AS triggerType, pattern, action, channel,
+              enabled, last_triggered_at AS lastTriggeredAt, trigger_count AS triggerCount,
+              created_at AS createdAt, updated_at AS updatedAt
+       FROM watchers WHERE id = ?`);
+        this.updateStmt = db.prepare(`UPDATE watchers SET name=?, trigger_type=?, pattern=?, action=?, channel=?, enabled=?, updated_at=? WHERE id=?`);
+        this.deleteStmt = db.prepare(`DELETE FROM watchers WHERE id = ?`);
+        this.recordTrigger = db.prepare(`UPDATE watchers SET last_triggered_at=?, trigger_count=trigger_count+1, updated_at=? WHERE id=?`);
+    }
+    create(opts) {
+        const id = randomUUID();
+        const now = Date.now();
+        this.insert.run(id, opts.name, opts.triggerType ?? "webhook", opts.pattern ?? "", opts.action ?? "", opts.channel ?? null, 1, now, now);
+        log.info({ id, name: opts.name }, "watcher created");
+        return this.get(id);
+    }
+    list() {
+        return this.selectAll.all();
+    }
+    get(id) {
+        return this.selectOne.get(id) ?? null;
+    }
+    update(id, opts) {
+        const existing = this.get(id);
+        if (!existing)
+            return false;
+        this.updateStmt.run(opts.name ?? existing.name, opts.triggerType ?? existing.triggerType, opts.pattern ?? existing.pattern, opts.action ?? existing.action, opts.channel ?? existing.channel, opts.enabled !== undefined ? (opts.enabled ? 1 : 0) : (existing.enabled ? 1 : 0), Date.now(), id);
+        return true;
+    }
+    delete(id) {
+        return this.deleteStmt.run(id).changes > 0;
+    }
+    markTriggered(id) {
+        const now = Date.now();
+        this.recordTrigger.run(now, now, id);
+    }
+}
+//# sourceMappingURL=WatcherStore.js.map

package/dist/watchers/WatcherStore.js.map

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

package/dist/webhooks/WebhookHandler.d.ts

@@ -0,0 +1,36 @@
+/**
+ * WebhookHandler — HTTP ingress for external events, with per-watcher
+ * bearer tokens + optional HMAC signature verification.
+ *
+ * Routes (all under `mountPath`, default `/hooks`):
+ *   POST /agent              enqueue a full agent turn     [auth: user session]
+ *   POST /wake               lightweight agent trigger      [auth: user session]
+ *   POST /watch/:id          fire one watcher by id/name    [auth: bearer OR HMAC]
+ *   POST /github/:id         GitHub-shaped HMAC ingress    [auth: X-Hub-Signature-256]
+ *   POST /stripe/:id         Stripe-shaped HMAC ingress     [auth: Stripe-Signature]
+ *   POST /event              fan-out to all matching        [auth: user session]
+ *
+ * /agent, /wake, /event are user-facing — authenticated by the normal
+ * session JWT (requireAuth middleware upstream). Per-watcher endpoints
+ * use the watcher's own tokens so external providers don't need the
+ * user's session.
+ *
+ * Per-watcher auth: caller can present EITHER a valid bearer OR a valid
+ * HMAC signature. Mismatch on both → 401. Missing both → 401.
+ *
+ * Rate limit: per watcher id (60/min). Prevents a compromised bearer
+ * from burning through API quota before the user can rotate.
+ */
+import type { Express } from "express";
+import type { TaskRunner } from "../core/TaskRunner.js";
+import type { AuthStore } from "../auth/AuthStore.js";
+import type { WebhookTokenStore } from "./WebhookTokenStore.js";
+import type { WatcherStore } from "../watchers/WatcherStore.js";
+export interface WebhookDeps {
+    readonly runner: TaskRunner;
+    readonly watchers: WatcherStore;
+    readonly webhookTokens: WebhookTokenStore;
+    readonly authStore: AuthStore;
+}
+export declare function mountWebhookRoutes(app: Express, deps: WebhookDeps, mountPath?: string): void;
+//# sourceMappingURL=WebhookHandler.d.ts.map

package/dist/webhooks/WebhookHandler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"WebhookHandler.d.ts","sourceRoot":"","sources":["../../src/webhooks/WebhookHandler.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAqB,MAAM,SAAS,CAAC;AAE1D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAEtD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAEhE,OAAO,KAAK,EAAc,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAO5E,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC;IAC5B,QAAQ,CAAC,QAAQ,EAAE,YAAY,CAAC;IAChC,QAAQ,CAAC,aAAa,EAAE,iBAAiB,CAAC;IAC1C,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAC;CAC/B;AAED,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,SAAS,SAAW,GAAG,IAAI,CAsH9F"}