@rolealpha/n8n-nodes-rolealpha 0.0.0-stage → 0.5.0

package/dist/lib/waits.d.ts

@@ -0,0 +1,142 @@
+/**
+ * Waiting within a step. Parts of one step can depend on each other: an agent whose part
+ * needs the result of another role does what it can, records a wait and ends. When a run
+ * of another role of the same step ends with a result, the waiting agents are started again.
+ *
+ * The rows live in a store of the workflow (e.g. an n8n data table); these functions only
+ * decide, so the same rules hold wherever the rows are kept.
+ *
+ *   state "waiting":   agent_uuid waits on step_uuid for the roles in waits_for (empty = any other role)
+ *   state "done":      a run of agent_uuid with the roles in roles ended with a result at "at"
+ *   state "running":   lease of a run that is in progress; one live lease per agent, step and records
+ *   state "queued":    a start that arrived while the agent was busy; runs when the busy run ends
+ *   state "escalated": a wait that reached the attempt limit and was reported to a person
+ *
+ * Safety rules:
+ * - Every wake-up names one row (claimId). The workflow deletes that row first and wakes only
+ *   if the delete really removed it, so two runs that plan at once never wake the same agent twice.
+ * - Attempts are counted per wait; at the limit the wait is escalated, never woken again by itself.
+ * - Text that one agent left for another (reason, event) is cut to fixed sizes and passed as data.
+ */
+export interface WaitRow {
+    id?: number | string;
+    state: string;
+    step_uuid: string;
+    step_custom_id?: string | null;
+    agent_uuid: string;
+    agent_name?: string | null;
+    roles?: string | null;
+    waits_for?: string | null;
+    reason?: string | null;
+    record_keys?: string | null;
+    event?: string | null;
+    run_id?: string | null;
+    attempts?: number | string | null;
+    progress?: boolean | string | null;
+    at?: string | null;
+    createdAt?: string | null;
+}
+export interface FinishedRun {
+    runId: string;
+    stepUuid: string;
+    stepCustomId?: string | null;
+    agentUuid: string;
+    agentName?: string | null;
+    roleUuids: string[];
+    recordKeys?: unknown;
+    startedAt: string;
+    event?: unknown;
+    /** 0 for a first run, n for the n-th wake-up. */
+    attempt?: number;
+}
+export interface WakeUp {
+    /** Row to delete before waking; wake only if that delete removed it. */
+    claimId: number | string | null;
+    agentUuid: string;
+    agentName: string;
+    stepUuid: string;
+    stepCustomId: string;
+    recordKeys: string;
+    attempt: number;
+    event: Record<string, unknown>;
+}
+export interface AfterRunPlan {
+    /** The agent recorded a wait in this run. */
+    waited: boolean;
+    /** The run produced a result (no wait, or a wait after progress); only then are others woken. */
+    produced: boolean;
+    /** Row to add for this run, or null. */
+    doneRow: WaitRow | null;
+    wake: WakeUp[];
+    /** Row ids to delete: older duplicates of woken waits, replaced or expired done rows, this run's lease. */
+    remove: Array<number | string>;
+    /** Waits that reached the attempt limit; the scheduler escalates them. */
+    stuck: WaitRow[];
+}
+export interface Limits {
+    maxAttempts?: number;
+    keepDoneHours?: number;
+    maxWaitMinutes?: number;
+    runTimeoutMinutes?: number;
+}
+export interface WaitOptions extends Limits {
+    now?: Date;
+    /** Limits per agent and step (e.g. from Runner Settings); they win over the plain options. */
+    limitsFor?: (target: {
+        agentUuid: string;
+        stepUuid: string;
+        stepCustomId: string;
+    }) => Limits;
+}
+export declare const MAX_REASON_CHARS = 500;
+export declare const MAX_EVENT_CHARS = 20000;
+export declare function uuidSet(value: unknown): string[];
+/** Record keys of an event as one stable text, e.g. "12,7" → "12,7" sorted. */
+export declare function recordKey(keys: unknown): string;
+/** Two runs concern the same records when both have none or they share one. */
+export declare function sameRecords(a: unknown, b: unknown): boolean;
+/** Cuts text to a fixed size, so one agent cannot flood the next one's prompt. */
+export declare function clip(value: unknown, max: number): string;
+export declare function parseEvent(value: unknown): Record<string, unknown>;
+/**
+ * Decides what happens after a run of one agent on one step.
+ * rows: the stored rows of this step (other steps are ignored).
+ */
+export declare function planAfterRun(rows: WaitRow[], run: FinishedRun, opts?: WaitOptions): AfterRunPlan;
+export interface StartCheck {
+    /** Whether this run may go on. */
+    start: boolean;
+    reason: string;
+    /** The live lease of another run that blocks this one. */
+    blockedBy: string | null;
+    /** Rows to delete: this run's own lease when it may not start, and dead leases. */
+    remove: Array<number | string>;
+    /** When blocked: a row to add so the start runs after the busy run (state "queued"). */
+    queueRow: WaitRow | null;
+}
+/**
+ * Duplicate-run guard. The workflow first adds a lease row for this run (state "running",
+ * run_id), then reads the leases of the step and asks here. Of the live leases of the same
+ * agent and records the oldest wins; a later one does not start and is queued instead, so
+ * nothing is lost and nothing runs twice. Leases older than the run timeout count as dead.
+ */
+export declare function checkStart(rows: WaitRow[], run: Omit<FinishedRun, 'roleUuids' | 'startedAt'> & {
+    roleUuids?: string[];
+    startedAt?: string;
+}, opts?: WaitOptions): StartCheck;
+export interface StaleResult {
+    wake: WakeUp[];
+    remove: Array<number | string>;
+    /** Waits at the attempt limit (already escalated ones excluded). */
+    stuck: WaitRow[];
+    /** Row ids to set to state "escalated" once the report went out. */
+    escalate: Array<number | string>;
+}
+/**
+ * For a scheduler: waits nobody answered within maxWaitMinutes (e.g. because a person fills
+ * the awaited role), queued starts whose busy run died, dead leases and expired rows.
+ * Waits at the attempt limit are returned once for escalation, never woken again by themselves.
+ */
+export declare function findStaleWaits(rows: WaitRow[], opts?: WaitOptions & {
+    olderThanMinutes?: number;
+}): StaleResult;

package/dist/lib/waits.js

@@ -0,0 +1,339 @@
+"use strict";
+/**
+ * Waiting within a step. Parts of one step can depend on each other: an agent whose part
+ * needs the result of another role does what it can, records a wait and ends. When a run
+ * of another role of the same step ends with a result, the waiting agents are started again.
+ *
+ * The rows live in a store of the workflow (e.g. an n8n data table); these functions only
+ * decide, so the same rules hold wherever the rows are kept.
+ *
+ *   state "waiting":   agent_uuid waits on step_uuid for the roles in waits_for (empty = any other role)
+ *   state "done":      a run of agent_uuid with the roles in roles ended with a result at "at"
+ *   state "running":   lease of a run that is in progress; one live lease per agent, step and records
+ *   state "queued":    a start that arrived while the agent was busy; runs when the busy run ends
+ *   state "escalated": a wait that reached the attempt limit and was reported to a person
+ *
+ * Safety rules:
+ * - Every wake-up names one row (claimId). The workflow deletes that row first and wakes only
+ *   if the delete really removed it, so two runs that plan at once never wake the same agent twice.
+ * - Attempts are counted per wait; at the limit the wait is escalated, never woken again by itself.
+ * - Text that one agent left for another (reason, event) is cut to fixed sizes and passed as data.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MAX_EVENT_CHARS = exports.MAX_REASON_CHARS = void 0;
+exports.uuidSet = uuidSet;
+exports.recordKey = recordKey;
+exports.sameRecords = sameRecords;
+exports.clip = clip;
+exports.parseEvent = parseEvent;
+exports.planAfterRun = planAfterRun;
+exports.checkStart = checkStart;
+exports.findStaleWaits = findStaleWaits;
+exports.MAX_REASON_CHARS = 500;
+exports.MAX_EVENT_CHARS = 20_000;
+const lower = (v) => String(v ?? '').trim().toLowerCase();
+function uuidSet(value) {
+    const raw = Array.isArray(value) ? value : String(value ?? '').split(',');
+    return Array.from(new Set(raw.map(lower).filter(Boolean)));
+}
+/** Record keys of an event as one stable text, e.g. "12,7" → "12,7" sorted. */
+function recordKey(keys) {
+    const raw = Array.isArray(keys) ? keys : keys === undefined || keys === null || keys === '' ? [] : String(keys).split(',');
+    return Array.from(new Set(raw.map((k) => String(k).trim()).filter(Boolean))).sort().join(',');
+}
+/** Two runs concern the same records when both have none or they share one. */
+function sameRecords(a, b) {
+    const ka = recordKey(a);
+    const kb = recordKey(b);
+    if (ka === '' || kb === '')
+        return ka === kb;
+    const set = new Set(ka.split(','));
+    return kb.split(',').some((k) => set.has(k));
+}
+/** Cuts text to a fixed size, so one agent cannot flood the next one's prompt. */
+function clip(value, max) {
+    const s = String(value ?? '');
+    return s.length > max ? `${s.slice(0, max)} …[cut]` : s;
+}
+function truthy(v) {
+    return v === true || lower(v) === 'true' || v === 1 || v === '1';
+}
+function attemptsOf(row) {
+    const n = Number(row.attempts);
+    return Number.isFinite(n) && n > 0 ? Math.floor(n) : 0;
+}
+function timeOf(row) {
+    const t = Date.parse(String(row.at ?? row.createdAt ?? ''));
+    return Number.isFinite(t) ? t : 0;
+}
+function idOrder(a, b) {
+    const na = Number(a.id);
+    const nb = Number(b.id);
+    if (Number.isFinite(na) && Number.isFinite(nb))
+        return na - nb;
+    return String(a.id ?? '').localeCompare(String(b.id ?? ''));
+}
+function parseEvent(value) {
+    if (value && typeof value === 'object' && !Array.isArray(value)) {
+        const json = JSON.stringify(value);
+        return json.length > exports.MAX_EVENT_CHARS ? { text: clip(json, exports.MAX_EVENT_CHARS) } : { ...value };
+    }
+    if (typeof value === 'string' && value.trim()) {
+        if (value.length <= exports.MAX_EVENT_CHARS) {
+            try {
+                const parsed = JSON.parse(value);
+                if (parsed && typeof parsed === 'object' && !Array.isArray(parsed))
+                    return parsed;
+            }
+            catch {
+                /* keep as text */
+            }
+        }
+        return { text: clip(value, exports.MAX_EVENT_CHARS) };
+    }
+    return {};
+}
+function waitsOn(row, roleUuids) {
+    const wanted = uuidSet(row.waits_for);
+    return wanted.length === 0 || wanted.some((r) => roleUuids.includes(r));
+}
+function wakeFor(row, by, claimId) {
+    const attempt = attemptsOf(row) + 1;
+    const event = parseEvent(row.event);
+    delete event.wake;
+    event.wake = { attempt, wokenBy: clip(by.agentName, 200), wokenByRoles: by.roles, waitedFor: clip(row.reason, exports.MAX_REASON_CHARS) };
+    return {
+        claimId,
+        agentUuid: lower(row.agent_uuid),
+        agentName: clip(row.agent_name, 200),
+        stepUuid: lower(row.step_uuid),
+        stepCustomId: String(row.step_custom_id ?? ''),
+        recordKeys: recordKey(row.record_keys),
+        attempt,
+        event,
+    };
+}
+/** The newest row per agent and records; the others are removed with it. */
+function groupWaits(rows) {
+    const groups = new Map();
+    for (const row of rows) {
+        const key = `${lower(row.agent_uuid)}|${recordKey(row.record_keys)}`;
+        const g = groups.get(key);
+        if (!g)
+            groups.set(key, { row, ids: row.id !== undefined ? [row.id] : [] });
+        else {
+            if (row.id !== undefined)
+                g.ids.push(row.id);
+            if (timeOf(row) > timeOf(g.row) || (timeOf(row) === timeOf(g.row) && attemptsOf(row) > attemptsOf(g.row)))
+                g.row = row;
+        }
+    }
+    return Array.from(groups.values());
+}
+function limitsOf(opts, row) {
+    const own = opts.limitsFor?.({ agentUuid: lower(row.agent_uuid), stepUuid: lower(row.step_uuid), stepCustomId: String(row.step_custom_id ?? '') }) ?? {};
+    return {
+        maxAttempts: own.maxAttempts ?? opts.maxAttempts ?? 5,
+        keepDoneHours: own.keepDoneHours ?? opts.keepDoneHours ?? 168,
+        maxWaitMinutes: own.maxWaitMinutes ?? opts.maxWaitMinutes ?? 60,
+        runTimeoutMinutes: own.runTimeoutMinutes ?? opts.runTimeoutMinutes ?? 15,
+    };
+}
+/** Adds a group as a wake-up with a claim, or as stuck at the attempt limit. */
+function wakeOrStick(g, by, maxAttempts, out) {
+    if (attemptsOf(g.row) >= maxAttempts) {
+        out.stuck.push(g.row);
+        return;
+    }
+    const claimId = g.row.id ?? null;
+    out.remove.push(...g.ids.filter((id) => id !== claimId));
+    out.wake.push(wakeFor(g.row, by, claimId));
+}
+/**
+ * Decides what happens after a run of one agent on one step.
+ * rows: the stored rows of this step (other steps are ignored).
+ */
+function planAfterRun(rows, run, opts = {}) {
+    const now = opts.now ?? new Date();
+    const stepUuid = lower(run.stepUuid);
+    const agentUuid = lower(run.agentUuid);
+    const roles = uuidSet(run.roleUuids);
+    const keys = recordKey(run.recordKeys ?? parseEvent(run.event).keys);
+    const started = Date.parse(run.startedAt);
+    const onStep = rows.filter((r) => lower(r.step_uuid) === stepUuid);
+    const state = (s) => onStep.filter((r) => lower(r.state) === s);
+    const waiting = state('waiting');
+    const done = state('done');
+    const own = limitsOf(opts, { agent_uuid: agentUuid, step_uuid: stepUuid, step_custom_id: run.stepCustomId });
+    const myWaits = waiting.filter((r) => lower(r.agent_uuid) === agentUuid && String(r.run_id ?? '') === String(run.runId));
+    const waited = myWaits.length > 0;
+    const produced = !waited || myWaits.some((r) => truthy(r.progress));
+    const out = { wake: [], remove: [], stuck: [] };
+    const by = { agentName: String(run.agentName ?? ''), roles };
+    // This run's lease ends with it.
+    for (const r of state('running'))
+        if (r.id !== undefined && String(r.run_id ?? '') === String(run.runId))
+            out.remove.push(r.id);
+    // Done and escalated rows: one done row per agent and records; expired ones go.
+    for (const r of [...done, ...state('escalated')]) {
+        if (r.id === undefined)
+            continue;
+        const keepMs = limitsOf(opts, r).keepDoneHours * 3600_000;
+        const replaced = lower(r.state) === 'done' && produced && lower(r.agent_uuid) === agentUuid && recordKey(r.record_keys) === keys;
+        if (replaced || now.getTime() - timeOf(r) > keepMs)
+            out.remove.push(r.id);
+    }
+    const doneRow = produced
+        ? {
+            state: 'done',
+            step_uuid: stepUuid,
+            step_custom_id: run.stepCustomId ?? '',
+            agent_uuid: agentUuid,
+            agent_name: clip(run.agentName, 200),
+            roles: roles.join(','),
+            waits_for: '',
+            reason: '',
+            record_keys: keys,
+            event: '',
+            run_id: String(run.runId),
+            attempts: run.attempt ?? 0,
+            progress: true,
+            at: now.toISOString(),
+        }
+        : null;
+    // Wake the agents of this step that wait on one of the roles of this run.
+    if (produced) {
+        const candidates = waiting.filter((r) => lower(r.agent_uuid) !== agentUuid && sameRecords(r.record_keys, keys) && waitsOn(r, roles));
+        for (const g of groupWaits(candidates))
+            wakeOrStick(g, by, limitsOf(opts, g.row).maxAttempts, out);
+    }
+    // A result of an awaited role may have arrived while this agent was still checking: then go again now.
+    if (waited) {
+        const mine = groupWaits(myWaits)[0];
+        const arrived = done.some((d) => lower(d.agent_uuid) !== agentUuid &&
+            sameRecords(d.record_keys, keys) &&
+            timeOf(d) >= (Number.isFinite(started) ? started : 0) &&
+            waitsOn(mine.row, uuidSet(d.roles)));
+        if (arrived)
+            wakeOrStick(mine, { agentName: 'arrived while waiting', roles: [] }, own.maxAttempts, out);
+    }
+    // Starts that came in while this run was busy run now, newest event first.
+    const queued = state('queued').filter((r) => lower(r.agent_uuid) === agentUuid && sameRecords(r.record_keys, keys));
+    for (const g of groupWaits(queued))
+        wakeOrStick(g, { agentName: 'queued while running', roles: [] }, own.maxAttempts, out);
+    return { waited, produced, doneRow, wake: out.wake, remove: Array.from(new Set(out.remove)), stuck: out.stuck };
+}
+/**
+ * Duplicate-run guard. The workflow first adds a lease row for this run (state "running",
+ * run_id), then reads the leases of the step and asks here. Of the live leases of the same
+ * agent and records the oldest wins; a later one does not start and is queued instead, so
+ * nothing is lost and nothing runs twice. Leases older than the run timeout count as dead.
+ */
+function checkStart(rows, run, opts = {}) {
+    const now = (opts.now ?? new Date()).getTime();
+    const agentUuid = lower(run.agentUuid);
+    const stepUuid = lower(run.stepUuid);
+    const keys = recordKey(run.recordKeys ?? parseEvent(run.event).keys);
+    const timeoutMs = limitsOf(opts, { agent_uuid: agentUuid, step_uuid: stepUuid, step_custom_id: run.stepCustomId }).runTimeoutMinutes * 60_000;
+    const leases = rows.filter((r) => lower(r.state) === 'running' && lower(r.step_uuid) === stepUuid && lower(r.agent_uuid) === agentUuid);
+    const remove = [];
+    const live = [];
+    for (const r of leases) {
+        if (now - timeOf(r) > timeoutMs) {
+            if (r.id !== undefined)
+                remove.push(r.id);
+        }
+        else if (sameRecords(r.record_keys, keys))
+            live.push(r);
+    }
+    const mine = live.filter((r) => String(r.run_id ?? '') === String(run.runId));
+    if (mine.length === 0) {
+        return { start: false, reason: 'No lease of this run was found; refusing to start', blockedBy: null, remove, queueRow: null };
+    }
+    live.sort((a, b) => timeOf(a) - timeOf(b) || idOrder(a, b));
+    const winner = live[0];
+    if (String(winner.run_id ?? '') === String(run.runId)) {
+        // Own extra lease rows (e.g. a retried insert) go as well.
+        remove.push(...mine.filter((r) => r !== winner && r.id !== undefined).map((r) => r.id));
+        return { start: true, reason: 'No other run of this agent is busy with these records', blockedBy: null, remove, queueRow: null };
+    }
+    remove.push(...mine.filter((r) => r.id !== undefined).map((r) => r.id));
+    const event = parseEvent(run.event);
+    return {
+        start: false,
+        reason: `Agent is busy with the same records in run ${winner.run_id}; this start is queued`,
+        blockedBy: String(winner.run_id ?? ''),
+        remove,
+        queueRow: {
+            state: 'queued',
+            step_uuid: stepUuid,
+            step_custom_id: run.stepCustomId ?? '',
+            agent_uuid: agentUuid,
+            agent_name: clip(run.agentName, 200),
+            roles: '',
+            waits_for: '',
+            reason: 'Started while the agent was busy with the same records',
+            record_keys: keys,
+            event: JSON.stringify(event),
+            run_id: String(winner.run_id ?? ''),
+            attempts: Math.max(0, Math.floor(Number(run.attempt) || 0)),
+            progress: '',
+            at: new Date(now).toISOString(),
+        },
+    };
+}
+/**
+ * For a scheduler: waits nobody answered within maxWaitMinutes (e.g. because a person fills
+ * the awaited role), queued starts whose busy run died, dead leases and expired rows.
+ * Waits at the attempt limit are returned once for escalation, never woken again by themselves.
+ */
+function findStaleWaits(rows, opts = {}) {
+    const now = (opts.now ?? new Date()).getTime();
+    const base = { ...opts, maxWaitMinutes: opts.olderThanMinutes ?? opts.maxWaitMinutes };
+    const out = { wake: [], remove: [], stuck: [] };
+    const escalate = [];
+    const liveLeases = [];
+    for (const r of rows) {
+        const s = lower(r.state);
+        const lim = limitsOf(base, r);
+        if (s === 'running') {
+            if (now - timeOf(r) > lim.runTimeoutMinutes * 60_000) {
+                if (r.id !== undefined)
+                    out.remove.push(r.id);
+            }
+            else
+                liveLeases.push(r);
+        }
+        else if ((s === 'done' || s === 'escalated') && r.id !== undefined && now - timeOf(r) > lim.keepDoneHours * 3600_000) {
+            out.remove.push(r.id);
+        }
+    }
+    const busy = (r) => liveLeases.some((l) => lower(l.agent_uuid) === lower(r.agent_uuid) && lower(l.step_uuid) === lower(r.step_uuid) && sameRecords(l.record_keys, r.record_keys));
+    const byStep = new Map();
+    for (const r of rows) {
+        const s = lower(r.state);
+        if (s !== 'waiting' && s !== 'queued')
+            continue;
+        const key = `${s}|${lower(r.step_uuid)}`;
+        byStep.set(key, [...(byStep.get(key) ?? []), r]);
+    }
+    for (const [key, stepRows] of byStep) {
+        const queued = key.startsWith('queued|');
+        for (const g of groupWaits(stepRows)) {
+            const lim = limitsOf(base, g.row);
+            // A queued start waits for its busy run; only when that run is gone does the scheduler start it.
+            if (queued ? busy(g.row) : now - timeOf(g.row) < lim.maxWaitMinutes * 60_000)
+                continue;
+            if (!queued && busy(g.row))
+                continue;
+            const before = out.stuck.length;
+            wakeOrStick(g, { agentName: 'scheduler', roles: [] }, lim.maxAttempts, out);
+            if (out.stuck.length > before && g.row.id !== undefined) {
+                escalate.push(g.row.id);
+                out.remove.push(...g.ids.filter((id) => id !== g.row.id));
+            }
+        }
+    }
+    return { wake: out.wake, remove: Array.from(new Set(out.remove)), stuck: out.stuck, escalate };
+}
+//# sourceMappingURL=waits.js.map

package/dist/lib/waits.js.map

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

package/dist/lib/webhook.d.ts

@@ -0,0 +1,12 @@
+/** Verification of roleALPHA context webhooks (`X-RA-Signature: sha256=<hex>`). */
+export interface ContextChangedEvent {
+    event: 'context.changed';
+    agentUuid: string;
+    contextVersion: string;
+    changedAt: string;
+}
+export declare function signBody(secret: string, rawBody: Buffer | string): string;
+export declare function verifySignature(secrets: string[], rawBody: Buffer | string, signature: unknown): boolean;
+/** Secrets may be one string, a JSON list, or a JSON map agentUuid → secret. */
+export declare function parseSecrets(raw: string, agentUuid?: string): string[];
+export declare function parseEvent(body: unknown): ContextChangedEvent | null;

package/dist/lib/webhook.js

@@ -0,0 +1,50 @@
+"use strict";
+/** Verification of roleALPHA context webhooks (`X-RA-Signature: sha256=<hex>`). */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.signBody = signBody;
+exports.verifySignature = verifySignature;
+exports.parseSecrets = parseSecrets;
+exports.parseEvent = parseEvent;
+const crypto_1 = require("crypto");
+function signBody(secret, rawBody) {
+    return `sha256=${(0, crypto_1.createHmac)('sha256', secret).update(rawBody).digest('hex')}`;
+}
+function verifySignature(secrets, rawBody, signature) {
+    const given = typeof signature === 'string' ? signature.trim().toLowerCase() : '';
+    if (!/^sha256=[0-9a-f]{64}$/.test(given))
+        return false;
+    const actual = Buffer.from(given, 'utf8');
+    return secrets
+        .filter((s) => typeof s === 'string' && s !== '')
+        .some((secret) => {
+        const expected = Buffer.from(signBody(secret, rawBody), 'utf8');
+        return expected.length === actual.length && (0, crypto_1.timingSafeEqual)(expected, actual);
+    });
+}
+/** Secrets may be one string, a JSON list, or a JSON map agentUuid → secret. */
+function parseSecrets(raw, agentUuid) {
+    const text = (raw ?? '').trim();
+    if (text === '')
+        return [];
+    if (!text.startsWith('{') && !text.startsWith('['))
+        return [text];
+    const parsed = JSON.parse(text);
+    if (Array.isArray(parsed))
+        return parsed.filter((s) => typeof s === 'string');
+    const map = parsed;
+    if (agentUuid && typeof map[agentUuid] === 'string')
+        return [map[agentUuid]];
+    return agentUuid ? [] : Object.values(map).filter((s) => typeof s === 'string');
+}
+function parseEvent(body) {
+    const o = (body && typeof body === 'object' ? body : {});
+    if (o.event !== 'context.changed' || typeof o.agentUuid !== 'string')
+        return null;
+    return {
+        event: 'context.changed',
+        agentUuid: o.agentUuid,
+        contextVersion: String(o.contextVersion ?? ''),
+        changedAt: String(o.changedAt ?? ''),
+    };
+}
+//# sourceMappingURL=webhook.js.map

package/dist/lib/webhook.js.map

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

package/dist/nodes/ApprovalSeal/ApprovalSeal.node.d.ts

@@ -0,0 +1,9 @@
+import type { IExecuteFunctions, INodeExecutionData, INodeType, INodeTypeDescription } from 'n8n-workflow';
+/**
+ * Seals the exact version a person approved and checks it again before anything is sent.
+ * The key lives only in the credential; the seal can be stored next to the record.
+ */
+export declare class ApprovalSeal implements INodeType {
+    description: INodeTypeDescription;
+    execute(this: IExecuteFunctions): Promise<INodeExecutionData[][]>;
+}