@nodetool-ai/websocket 0.7.0-rc.23 → 0.8.2

package/dist/triggers/dispatcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dispatcher.d.ts","sourceRoot":"","sources":["../../src/triggers/dispatcher.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwEG;AAGH,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,KAAK,EAAgB,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAO3E,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAC1D,OAAO,EAEL,KAAK,iBAAiB,EACtB,KAAK,uBAAuB,EAC7B,MAAM,2BAA2B,CAAC;AAyBnC;;;;GAIG;AACH,MAAM,MAAM,iBAAiB,GAAG,UAAU,GAAG,OAAO,GAAG,MAAM,CAAC;AAE9D,4DAA4D;AAC5D,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,iBAAiB,CAAC;IAC3B,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACvB;AAED,0DAA0D;AAC1D,MAAM,MAAM,eAAe,GAAG,CAC5B,OAAO,EAAE,uBAAuB,KAC7B,OAAO,CAAC,aAAa,CAAC,CAAC;AAE5B;;;;;GAKG;AACH,MAAM,MAAM,gBAAgB,GAAG,CAAC,KAAK,CAAC,EAAE;IACtC,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,KAAK,IAAI,CAAC;AAEX,UAAU,wBAAwB;IAChC,8EAA8E;IAC9E,KAAK,EAAE,iBAAiB,CAAC;IACzB,QAAQ,CAAC,EAAE,eAAe,CAAC;IAC3B,wEAAwE;IACxE,QAAQ,CAAC,EAAE,YAAY,CAAC;IACxB,qEAAqE;IACrE,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,UAAU,sBAAuB,SAAQ,wBAAwB;IAC/D,gEAAgE;IAChE,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,iDAAiD;AACjD,MAAM,MAAM,eAAe,GACvB;IAAE,MAAM,EAAE,YAAY,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GACvC;IAAE,MAAM,EAAE,SAAS,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAE1C,kFAAkF;AAClF,MAAM,WAAW,gBAAgB;IAC/B,IAAI,IAAI,CAAC;IACT,MAAM,EAAE,gBAAgB,CAAC;IACzB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACvB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAC5D;AA2ED;;;;GAIG;AACH,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAoB;IAC1C,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAkB;IAC3C,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAe;IACzC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IAEnC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAwC;IAC/D,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA+B;IACxD,iFAAiF;IACjF,OAAO,CAAC,QAAQ,CAAC,WAAW,CAA+B;IAE3D,OAAO,CAAC,IAAI,CAA8B;IAC1C,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,OAAO,CAAS;IAExB,YAAY,OAAO,EAAE,wBAAwB,EAK5C;IAED;;;;;;OAMG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAmB7B;IAED,oEAAoE;IACpE,MAAM,EAAE,gBAAgB,CAOtB;IAEF;;;;OAIG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAO3B;IAED,IAAI,IAAI,IAAI,CAEX;IAED;;;;;;OAMG;IACG,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAS/D;YAEa,mBAAmB;IAiBjC;;;;OAIG;YACW,SAAS;YAcT,SAAS;IAcvB,OAAO,CAAC,QAAQ;IAShB;;;OAGG;IACH,OAAO,CAAC,OAAO;YA0ED,WAAW;IAwFzB,6EAA6E;YAC/D,YAAY;IA2B1B;;;;;;;OAOG;YACW,MAAM;CAuBrB;AAED,iFAAiF;AACjF,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,wBAAwB,GAChC,iBAAiB,CAEnB;AAUD;;;;GAIG;AACH,wBAAgB,uBAAuB,IAAI,oBAAoB,CAK9D;AAED,uEAAuE;AACvE,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,oBAAoB,GAAG,IAAI,GACnC,IAAI,CAEN;AAED,6EAA6E;AAC7E,wBAAgB,mBAAmB,IAAI,iBAAiB,GAAG,IAAI,CAE9D;AAED;;;;;;;GAOG;AACH,wBAAsB,aAAa,CACjC,OAAO,EAAE,MAAM,GACd,OAAO,CAAC;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC,CAK5B;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAC7B,OAAO,EAAE,sBAAsB,GAC9B,gBAAgB,CA4BlB"}

package/dist/triggers/dispatcher.js

@@ -0,0 +1,525 @@
+/**
+ * Trigger dispatcher — turns durable `trigger_inputs` into runs.
+ *
+ * Ingestion adapters (webhook route, scheduler, file watcher) only *store*
+ * events. This is the single consumer: for every enabled `trigger_registrations`
+ * row it drains the unprocessed inputs addressed to that registration's
+ * (workflow, node) and starts one headless run per input, handing the payload
+ * to the trigger node as the run's `trigger_event`.
+ *
+ * Two paths feed it, following the `startReaper` shape
+ * (`@nodetool-ai/compute`): a coarse poll timer, and an in-process `notify()`
+ * that adapters call right after appending. `notify()` is what makes a
+ * same-process event dispatch immediately; the poll is only the
+ * crash-recovery path (a server that died mid-dispatch, or an input written by
+ * another process).
+ *
+ * ## Delivered vs. failed
+ *
+ * `startJob` **rejecting** means the run was never accepted (workflow missing,
+ * DB/infra hiccup): the input stays unprocessed so the next tick redelivers it,
+ * and the reason lands in `registration.last_error`.
+ *
+ * `startJob` **resolving with `status: "failed"`** is a different thing — the
+ * run was accepted and executed, and the *graph* failed. That is a delivered
+ * event: the input is marked processed (retrying a deterministic graph failure
+ * would loop forever) and the run error is still written to
+ * `registration.last_error` so the UI shows the last outcome.
+ *
+ * ## Acceptance vs. completion
+ *
+ * `startJob` resolves on *terminal* status — it does not come back until the
+ * workflow has finished. A pass that awaited that would hold every other
+ * registration behind the slowest run in flight: a webhook arriving one second
+ * into a ten-minute triggered run waited ten minutes for its own dispatch.
+ *
+ * So a pass awaits **acceptance**, not completion. `startHeadlessJob` reports
+ * acceptance through `onAccepted` the moment the workflow resolves and the
+ * `Job` row exists; the run itself settles later, on its own. `drain()` is what
+ * awaits the runs, for shutdown and for tests.
+ *
+ * A `startJob` that never calls `onAccepted` (the test fakes, any other job
+ * starter) still works: acceptance then resolves when the job promise does,
+ * which is exactly the old behaviour.
+ *
+ * ## Idempotency and the crash window
+ *
+ * An input is marked processed **when the run is accepted**, never before. In
+ * process, `inflight` (keyed by `inputId`) makes overlapping passes and
+ * concurrent `dispatchInput` calls join the same dispatch instead of starting a
+ * second run.
+ *
+ * The uncovered window is a crash *between* run acceptance and
+ * `markProcessed`: the input is still unprocessed on restart, so it is
+ * redelivered and the run happens twice. This is deliberate — at-least-once
+ * delivery. Dropping an event is worse than repeating one, and marking first
+ * would turn any crash before acceptance into a silently lost event.
+ *
+ * A run that was never accepted (`startJob` rejected) leaves `last_fired_at`
+ * alone: nothing fired, and stamping it made the editor report a delivery that
+ * never happened.
+ *
+ * ## Who writes `last_fired_at`
+ *
+ * A kind whose ingestion adapter runs in this process stamps the column when
+ * it delivers the event: `schedule` (where the column doubles as the
+ * scheduler's due-computation cursor, so moving it again here would shift the
+ * schedule) and `file_watch`. The dispatcher leaves those rows alone.
+ *
+ * `webhook` and `manual` arrive from outside and have no such owner, and
+ * leaving the column untouched made a webhook that had been delivering all
+ * week still report "Never" in the editor. For those the dispatcher stamps it
+ * on a delivered dispatch — the same write that records the run's outcome.
+ */
+import { createLogger } from "@nodetool-ai/config";
+import { TriggerWakeupService } from "@nodetool-ai/kernel";
+import { getPortableDb, RunEvent, TriggerInput as TriggerInputModel, TriggerRegistration } from "@nodetool-ai/models";
+import { startHeadlessJob } from "../headless-job-runner.js";
+import { SCHEDULE_KIND } from "./schedule-timing.js";
+import { checkTriggerBounds, disableTrigger, settleTriggerOutcome, triggerRunParams } from "./settle.js";
+import { isFunctionValue } from "../lib/wire-values.js";
+// Stryker disable next-line StringLiteral: logger name is a diagnostic label, not a behavioural contract
+const log = createLogger("nodetool.websocket.triggers.dispatcher");
+const DEFAULT_POLL_INTERVAL_MS = 15_000;
+const DEFAULT_BATCH_SIZE = 100;
+/**
+ * Kinds whose in-process ingestion adapter already stamps `last_fired_at` at
+ * delivery time (see the module docs). The dispatcher stamps every other kind.
+ */
+const ADAPTER_STAMPS_FIRED_AT = new Set([
+    SCHEDULE_KIND,
+    "file_watch"
+]);
+function deferred() {
+    let resolve;
+    let reject;
+    const promise = new Promise((res, rej) => {
+        resolve = res;
+        reject = rej;
+    });
+    const d = {
+        promise,
+        settled: false,
+        resolve: () => {
+            if (d.settled)
+                return;
+            d.settled = true;
+            resolve();
+        },
+        reject: (reason) => {
+            if (d.settled)
+                return;
+            d.settled = true;
+            reject(reason);
+        }
+    };
+    return d;
+}
+function readPolicy(registration) {
+    const raw = registration.config_json?.concurrency;
+    if (raw === "queue" || raw === "skip" || raw === "parallel")
+        return raw;
+    return "parallel";
+}
+async function listEnabledRegistrations() {
+    const rows = await getPortableDb().query.triggerRegistrations.findMany({
+        where: (t, { eq }) => eq(t.enabled, 1),
+        orderBy: (t, { asc }) => asc(t.created_at)
+    });
+    return rows.map((r) => new TriggerRegistration(r));
+}
+/**
+ * The registration an input belongs to. Adapters address inputs by
+ * `(workflow_id, node_id)` — the input's `runId` *is* the workflow id — so the
+ * lookup is a workflow scan plus a node-id match.
+ */
+async function findRegistrationForInput(input) {
+    const registrations = await TriggerRegistration.findByWorkflow(input.runId);
+    return registrations.find((r) => r.node_id === input.nodeId) ?? null;
+}
+/**
+ * Consumes stored trigger inputs. One instance owns the per-registration
+ * concurrency state and the per-input in-flight map, so both survive across
+ * passes.
+ */
+export class TriggerDispatcher {
+    store;
+    startJob;
+    registry;
+    batchSize;
+    states = new Map();
+    inflight = new Map();
+    /** Runs a pass handed off but that have not finished. `drain()` awaits these. */
+    outstanding = new Set();
+    pass = null;
+    pending = false;
+    stopped = false;
+    constructor(options) {
+        this.store = options.store;
+        this.startJob = options.startJob ?? startHeadlessJob;
+        this.registry = options.registry;
+        this.batchSize = options.batchSize ?? DEFAULT_BATCH_SIZE;
+    }
+    /**
+     * Drain every enabled registration's unprocessed inputs once. Resolves when
+     * every input this pass picked up has been *accepted* — not when its run has
+     * finished, so one slow workflow cannot hold up the next pass (see the
+     * acceptance-vs-completion note above). Use `drain()` to await the runs. A
+     * single input's failure does not abort the pass.
+     */
+    async runOnce() {
+        const registrations = await listEnabledRegistrations();
+        const accepted = [];
+        for (const registration of registrations) {
+            const inputs = await this.store.findUnprocessed(registration.workflow_id, registration.node_id, this.batchSize);
+            for (const input of inputs) {
+                // Swallow here only: each dispatch already records its own error.
+                accepted.push(this.enqueue(input, registration).accepted.catch(() => undefined));
+            }
+        }
+        await Promise.all(accepted);
+    }
+    /** Adapter hint: run a pass now, coalescing concurrent notifies. */
+    notify = () => {
+        if (this.stopped)
+            return;
+        this.pending = true;
+        if (this.pass)
+            return;
+        this.pass = this.runPasses().finally(() => {
+            this.pass = null;
+        });
+    };
+    /**
+     * Await the currently running pass (and any pass it coalesced) *and* every
+     * run those passes handed off. A settling run can enqueue nothing new, but a
+     * pass can, so both are re-checked until the two are quiet together.
+     */
+    async drain() {
+        while (this.pass || this.outstanding.size > 0) {
+            if (this.pass)
+                await this.pass;
+            await Promise.all([...this.outstanding].map((p) => p.catch(() => undefined)));
+        }
+    }
+    stop() {
+        this.stopped = true;
+    }
+    /**
+     * Deliver one already-stored input immediately. The synchronous-dispatch
+     * contract used by the manual-fire API: resolves with the started job id,
+     * rejects with an `Error` whose message starts with `"input not found"` or
+     * `"registration disabled"` for those two cases. A concurrent call for the
+     * same input joins the in-flight dispatch rather than starting a second run.
+     */
+    async dispatchInput(inputId) {
+        const existing = this.inflight.get(inputId);
+        const settled = existing
+            ? await existing.done
+            : await this.dispatchStoredInput(inputId);
+        if (settled.status !== "dispatched") {
+            throw new Error(`dispatch skipped: ${settled.reason}`);
+        }
+        return { jobId: settled.jobId };
+    }
+    async dispatchStoredInput(inputId) {
+        const input = await this.findInput(inputId);
+        if (!input) {
+            throw new Error(`input not found: ${inputId}`);
+        }
+        const registration = await findRegistrationForInput(input);
+        if (!registration) {
+            throw new Error(`input not found: no trigger registration for input ${inputId}`);
+        }
+        if (registration.enabled !== 1) {
+            throw new Error(`registration disabled: ${registration.id}`);
+        }
+        return this.enqueue(input, registration).done;
+    }
+    /**
+     * Look an input up by id. The `TriggerInputStore` interface addresses inputs
+     * by (run, node) only, so the by-id read goes through the model — the same
+     * table the Drizzle store writes.
+     */
+    async findInput(inputId) {
+        const row = await TriggerInputModel.findByInputId(inputId);
+        if (!row || row.processed !== 0)
+            return null;
+        return {
+            runId: row.run_id,
+            nodeId: row.node_id,
+            inputId: row.input_id,
+            payload: row.payload_json,
+            cursor: row.cursor ?? undefined,
+            processed: false,
+            createdAt: new Date(row.created_at)
+        };
+    }
+    async runPasses() {
+        while (this.pending && !this.stopped) {
+            this.pending = false;
+            try {
+                await this.runOnce();
+            }
+            catch (err) {
+                log.warn("Trigger dispatch pass failed", err instanceof Error ? err : new Error(String(err)));
+            }
+        }
+    }
+    stateFor(registrationId) {
+        let state = this.states.get(registrationId);
+        if (!state) {
+            state = { running: 0, chain: Promise.resolve() };
+            this.states.set(registrationId, state);
+        }
+        return state;
+    }
+    /**
+     * Start (or join) the dispatch of one input under its registration's
+     * concurrency policy.
+     */
+    enqueue(input, registration) {
+        const existing = this.inflight.get(input.inputId);
+        if (existing)
+            return existing;
+        const policy = readPolicy(registration);
+        const state = this.stateFor(registration.id);
+        const acceptance = deferred();
+        /**
+         * The handoff point: the input is marked processed and the pass that
+         * picked it up is released. Idempotent, because a `startJob` that reports
+         * acceptance early also resolves when it finishes.
+         */
+        const accept = async () => {
+            if (acceptance.settled)
+                return;
+            await this.store.markProcessed(input.inputId);
+            acceptance.resolve();
+        };
+        // The synchronous prefix of `run` (the `running` bump) executes as soon as
+        // `run()` is called, so a second input enqueued in the same tick sees it.
+        const run = async () => {
+            if (policy === "skip" && state.running > 0) {
+                await this.emitReceived(input, registration, policy, false);
+                await accept();
+                log.debug("Trigger input skipped (run already in flight)", {
+                    inputId: input.inputId,
+                    registrationId: registration.id
+                });
+                return {
+                    status: "skipped",
+                    reason: `a run is already in flight for input ${input.inputId}`
+                };
+            }
+            state.running += 1;
+            try {
+                return await this.dispatchOne(input, registration, policy, accept);
+            }
+            finally {
+                state.running -= 1;
+            }
+        };
+        let done;
+        if (policy === "queue") {
+            // Both handlers run the dispatch: a failed predecessor must not cancel
+            // its successors.
+            done = state.chain.then(run, run);
+            state.chain = done.catch(() => undefined);
+        }
+        else {
+            done = run();
+        }
+        const dispatch = { accepted: acceptance.promise, done };
+        this.inflight.set(input.inputId, dispatch);
+        this.outstanding.add(done);
+        const forget = (err) => {
+            this.inflight.delete(input.inputId);
+            this.outstanding.delete(done);
+            // A dispatch that failed before it was ever accepted must not leave the
+            // pass awaiting an acceptance that will never come.
+            acceptance.reject(err);
+        };
+        void done.then(() => forget(), forget);
+        // The pass attaches its own handler, but `dispatchInput` callers only take
+        // `done` — keep a rejected acceptance from surfacing as unhandled.
+        void acceptance.promise.catch(() => undefined);
+        return dispatch;
+    }
+    async dispatchOne(input, registration, policy, accept) {
+        const nowMs = Date.now();
+        const gate = checkTriggerBounds(registration, nowMs);
+        if (!gate.allowed) {
+            // Exhausted: drop the event rather than leave it to redeliver forever,
+            // and disarm so the next one never gets this far.
+            await this.emitReceived(input, registration, policy, false);
+            await accept();
+            disableTrigger(registration, gate.reason);
+            await registration.save();
+            log.info("Trigger registration disabled before dispatch", {
+                registrationId: registration.id,
+                reason: gate.reason
+            });
+            return { status: "skipped", reason: `registration ${gate.reason}` };
+        }
+        await this.emitReceived(input, registration, policy, true);
+        let job;
+        try {
+            const jobRequest = {
+                workflowId: registration.workflow_id,
+                userId: registration.user_id,
+                params: triggerRunParams(registration, nowMs),
+                // Per-registration opt-in, off unless the row says otherwise.
+                supervise: registration.supervise === 1,
+                triggerEvent: {
+                    node_id: input.nodeId,
+                    payload: input.payload,
+                    input_id: input.inputId
+                },
+                // Release the pass as soon as the run is taken on, so a long workflow
+                // doesn't hold up every other registration's dispatch.
+                onAccepted: () => {
+                    void accept();
+                }
+            };
+            if (this.registry) {
+                jobRequest.registry = this.registry;
+            }
+            job = await this.startJob(jobRequest);
+        }
+        catch (err) {
+            // The run was never accepted: leave the input unprocessed so the next
+            // tick redelivers it. It still counts as a failure — a registration
+            // whose workflow has gone missing redelivers forever otherwise. Nothing
+            // fired, so `last_fired_at` is left alone.
+            const error = err instanceof Error ? err : new Error(String(err));
+            await this.settle(registration, `dispatch failed: ${error.message}`, nowMs, { fired: false });
+            log.warn(`Trigger dispatch failed for input ${input.inputId} (registration ${registration.id})`, error);
+            throw error;
+        }
+        // Accepted — mark processed only now (see the crash-window note above).
+        // A no-op when `onAccepted` already fired mid-run.
+        await accept();
+        await this.settle(registration, job.status === "failed"
+            ? `run failed: ${job.error ?? "unknown error"}`
+            : null, nowMs);
+        log.info("Trigger input dispatched", {
+            inputId: input.inputId,
+            registrationId: registration.id,
+            jobId: job.jobId,
+            status: job.status ?? "unknown"
+        });
+        return { status: "dispatched", jobId: job.jobId };
+    }
+    /** Append the audit event. Never lets a logging failure block a dispatch. */
+    async emitReceived(input, registration, policy, dispatched) {
+        try {
+            await RunEvent.appendEvent(input.runId, "TriggerInputReceived", {
+                input_id: input.inputId,
+                registration_id: registration.id,
+                kind: registration.kind,
+                concurrency: policy,
+                dispatched
+            }, input.nodeId);
+        }
+        catch (err) {
+            log.warn("Failed to append TriggerInputReceived event", err instanceof Error ? err : new Error(String(err)));
+        }
+    }
+    /**
+     * Record what the run did to the registration: its outcome, the failure
+     * counters, and — for the kinds no ingestion adapter stamps — the fire time
+     * the editor shows as "Last fired".
+     *
+     * `fired: false` marks an outcome where no run ever started, so there is no
+     * fire time to record however the kind is owned.
+     */
+    async settle(registration, error, nowMs, opts = { fired: true }) {
+        const stampFiredAt = opts.fired && !ADAPTER_STAMPS_FIRED_AT.has(registration.kind);
+        const disabled = settleTriggerOutcome(registration, {
+            error,
+            stampFiredAt,
+            firedAt: new Date(nowMs).toISOString()
+        });
+        await registration.save();
+        if (disabled) {
+            log.info("Trigger registration disabled", {
+                registrationId: registration.id,
+                reason: disabled,
+                error
+            });
+        }
+    }
+}
+/** Construct a dispatcher without starting its poll timer (tests, boot code). */
+export function createTriggerDispatcher(options) {
+    return new TriggerDispatcher(options);
+}
+// ── Process-wide handles ──────────────────────────────────────────────
+//
+// The manual-fire API (`trpc/routers/triggers.ts`) reaches the running
+// dispatcher and wakeup service by module function, not by injection.
+let activeDispatcher = null;
+let wakeupService = null;
+/**
+ * The process's `TriggerWakeupService`. Boot wiring installs the DB-backed
+ * instance via `setTriggerWakeupService`; until then a default (memory inbox)
+ * instance is created lazily so callers always get a usable service.
+ */
+export function getTriggerWakeupService() {
+    if (!wakeupService) {
+        wakeupService = new TriggerWakeupService();
+    }
+    return wakeupService;
+}
+/** Install (or clear, with `null`) the process-wide wakeup service. */
+export function setTriggerWakeupService(service) {
+    wakeupService = service;
+}
+/** The running dispatcher, or `null` before boot wiring / after shutdown. */
+export function getActiveDispatcher() {
+    return activeDispatcher;
+}
+/**
+ * Deliver one already-stored input immediately through the running dispatcher.
+ * Resolves with the started job id; rejects with an `Error` whose message
+ * starts with `"input not found"` or `"registration disabled"` for those cases.
+ *
+ * Note that the promise settles when the run *finishes*, because the headless
+ * runner resolves on terminal status.
+ */
+export async function dispatchInput(inputId) {
+    if (!activeDispatcher) {
+        throw new Error("trigger dispatcher not started");
+    }
+    return activeDispatcher.dispatchInput(inputId);
+}
+/**
+ * Start the dispatcher: one unref'd poll timer for crash recovery plus an
+ * immediate backlog pass. The returned handle stops the timer and also exposes
+ * `notify` (for adapters) and `drain`/`dispatchInput`.
+ */
+export function startDispatcher(options) {
+    const dispatcher = new TriggerDispatcher(options);
+    const intervalMs = options.intervalMs ?? DEFAULT_POLL_INTERVAL_MS;
+    activeDispatcher = dispatcher;
+    const timer = setInterval(() => {
+        dispatcher.notify();
+    }, intervalMs);
+    if (isFunctionValue(timer.unref)) {
+        timer.unref();
+    }
+    // Any input left unprocessed by a previous process life goes out now.
+    dispatcher.notify();
+    const handle = () => {
+        clearInterval(timer);
+        dispatcher.stop();
+        if (activeDispatcher === dispatcher) {
+            activeDispatcher = null;
+        }
+    };
+    handle.notify = dispatcher.notify;
+    handle.drain = () => dispatcher.drain();
+    handle.dispatchInput = (inputId) => dispatcher.dispatchInput(inputId);
+    return handle;
+}
+//# sourceMappingURL=dispatcher.js.map

package/dist/triggers/dispatcher.js.map

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

package/dist/triggers/file-watch.d.ts

@@ -0,0 +1,90 @@
+/**
+ * File-watch adapter — the host-owned ingestion adapter for `file_watch`
+ * registrations (compiled from `FileWatchTriggerNode`s, see
+ * `registration-sync.ts`).
+ *
+ * File events arrive live through `fs.watch`, unlike the scheduler's poll
+ * sweep — so the sweep timer here only reconciles *which* registrations are
+ * watched: it opens a watcher for every enabled `file_watch` registration
+ * that isn't already watched with the current config (skipping — and
+ * recording `last_error` for — paths that don't exist), and closes the
+ * watcher for any registration that is no longer enabled, no longer exists,
+ * or whose watched path/recursion setting changed. Pattern/ignore-pattern
+ * matching and debounce reuse `FileWatchTriggerNode`'s own logic via the
+ * shared `@nodetool-ai/automation-nodes` helper, so the adapter and the
+ * in-editor live-test path can never drift apart.
+ *
+ * Follows `scheduler.ts`'s shape: a pure-ish sweep function callers can drive
+ * directly in tests, a thin `setInterval` wrapper for production, and a stop
+ * handle. The one difference is unavoidable statefulness — `fs.watch` handles
+ * must persist across sweeps — so the sweep function takes an explicit state
+ * map instead of being fully pure.
+ */
+import * as fs from "node:fs";
+import { TriggerRegistration } from "@nodetool-ai/models";
+import type { TriggerWakeupService } from "@nodetool-ai/kernel";
+import { type FileWatchFilter } from "@nodetool-ai/automation-nodes";
+/** Fired once per registration each time a watcher delivers a new event. */
+interface FileWatchNotifyEvent {
+    registrationId: string;
+    inputId: string;
+}
+interface RunFileWatchSweepOptions {
+    wakeupService: TriggerWakeupService;
+    /** Same-process dispatch hint — called after a new event is delivered. */
+    notify?: (event: FileWatchNotifyEvent) => void;
+    /** Injectable clock for deterministic tests. Defaults to `Date.now`. */
+    now?: () => number;
+    /** Injectable watcher boundary for deterministic tests. */
+    watch?: (watchPath: string, options: {
+        recursive: boolean;
+        persistent: boolean;
+    }, listener: (eventType: "rename" | "change", filename: string | Buffer | null) => void) => fs.FSWatcher;
+}
+interface StartFileWatchOptions extends RunFileWatchSweepOptions {
+    /** Reconciliation sweep period — how often new/disabled/changed
+     * registrations are picked up. Defaults to 5s; live events do not wait for
+     * this timer, only registration churn does. */
+    intervalMs?: number;
+}
+/** Cancels a running `startFileWatch` timer and closes every open watcher,
+ * persisting catch-up snapshots along the way — see `stopFileWatch`. */
+export type FileWatchHandle = () => Promise<void>;
+interface WatchedRegistration {
+    watcher: fs.FSWatcher;
+    /** Identifies the watched path + recursion setting; a change here forces a
+     * watcher restart on the next sweep. */
+    configSnapshot: string;
+    /** Kept so `stopFileWatch` can capture a catch-up snapshot without a DB
+     * round trip and without re-deriving path/recursion/filter from config. */
+    registration: TriggerRegistration;
+    watchPath: string;
+    recursive: boolean;
+    filter: FileWatchFilter;
+    catchUp: boolean;
+}
+/** One `startFileWatch`/`runFileWatchSweepOnce` instance's set of currently
+ * open watchers, keyed by registration id. Exported so tests can drive
+ * `runFileWatchSweepOnce` deterministically without a real timer. */
+export type FileWatchState = Map<string, WatchedRegistration>;
+export declare function createFileWatchState(): FileWatchState;
+/**
+ * Run one reconciliation sweep against the current set of enabled
+ * `file_watch` registrations: closes watchers for registrations that are no
+ * longer enabled/present/unchanged, and opens watchers for the rest. Skips —
+ * and records `last_error` for — a registration whose path does not exist.
+ */
+export declare function runFileWatchSweepOnce(state: FileWatchState, opts: RunFileWatchSweepOptions): Promise<void>;
+/** Close every watcher tracked by `state`, persisting a catch-up snapshot
+ * for each catch-up-enabled registration, and clear the state. */
+export declare function stopFileWatch(state: FileWatchState): Promise<void>;
+/**
+ * Start the file-watch adapter: an immediate sweep plus a periodic
+ * reconciliation timer (`startReaper`/`startScheduler` shape). File events
+ * themselves are not polled — they arrive live through each registration's
+ * `fs.watch` handle; only registration churn (new/disabled/changed) waits for
+ * the sweep.
+ */
+export declare function startFileWatch(opts: StartFileWatchOptions): FileWatchHandle;
+export {};
+//# sourceMappingURL=file-watch.d.ts.map

package/dist/triggers/file-watch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-watch.d.ts","sourceRoot":"","sources":["../../src/triggers/file-watch.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAG9B,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAChE,OAAO,EAKL,KAAK,eAAe,EACrB,MAAM,+BAA+B,CAAC;AAkCvC,4EAA4E;AAC5E,UAAU,oBAAoB;IAC5B,cAAc,EAAE,MAAM,CAAC;IACvB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,UAAU,wBAAwB;IAChC,aAAa,EAAE,oBAAoB,CAAC;IACpC,0EAA0E;IAC1E,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,oBAAoB,KAAK,IAAI,CAAC;IAC/C,wEAAwE;IACxE,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;IACnB,2DAA2D;IAC3D,KAAK,CAAC,EAAE,CACN,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE;QAAE,SAAS,EAAE,OAAO,CAAC;QAAC,UAAU,EAAE,OAAO,CAAA;KAAE,EACpD,QAAQ,EAAE,CACR,SAAS,EAAE,QAAQ,GAAG,QAAQ,EAC9B,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,KAC7B,IAAI,KACN,EAAE,CAAC,SAAS,CAAC;CACnB;AAED,UAAU,qBAAsB,SAAQ,wBAAwB;IAC9D;;mDAE+C;IAC/C,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;wEACwE;AACxE,MAAM,MAAM,eAAe,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;AAElD,UAAU,mBAAmB;IAC3B,OAAO,EAAE,EAAE,CAAC,SAAS,CAAC;IACtB;4CACwC;IACxC,cAAc,EAAE,MAAM,CAAC;IACvB;+EAC2E;IAC3E,YAAY,EAAE,mBAAmB,CAAC;IAClC,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,OAAO,CAAC;IACnB,MAAM,EAAE,eAAe,CAAC;IACxB,OAAO,EAAE,OAAO,CAAC;CAClB;AAED;;qEAEqE;AACrE,MAAM,MAAM,cAAc,GAAG,GAAG,CAAC,MAAM,EAAE,mBAAmB,CAAC,CAAC;AAE9D,wBAAgB,oBAAoB,IAAI,cAAc,CAErD;AA6TD;;;;;GAKG;AACH,wBAAsB,qBAAqB,CACzC,KAAK,EAAE,cAAc,EACrB,IAAI,EAAE,wBAAwB,GAC7B,OAAO,CAAC,IAAI,CAAC,CA8Ef;AAqCD;kEACkE;AAClE,wBAAsB,aAAa,CAAC,KAAK,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAMxE;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,qBAAqB,GAAG,eAAe,CAmC3E"}