@dsh-enhanced/assistant-dreaming 0.0.0-stage → 0.1.70

package/lib/store.js

@@ -0,0 +1,367 @@
+import { createHash } from 'node:crypto';
+import { lstatSync, mkdirSync } from 'node:fs';
+import { dirname, isAbsolute } from 'node:path';
+import { types as utilTypes } from 'node:util';
+import { DatabaseSync } from 'node:sqlite';
+/**
+ * Private idea ledger. Fail-closed, lane-scoped and side-effect free: it only
+ * records dreaming runs, submitted ideas and per-day counters. Nothing in this
+ * module adopts, notifies or promotes anything.
+ */
+const SCHEMA_VERSION = 2;
+export function assertLedgerPath(path) {
+    if (!isAbsolute(path) || dirname(path) === path)
+        throw new Error('dream store: databasePath must be an absolute file path');
+    mkdirSync(dirname(path), { recursive: true });
+    const parent = lstatSync(dirname(path));
+    // Fail closed on shared or world-writable ancestors, mirroring DSH state
+    // privacy: the ledger holds owner-derived freeform text.
+    if ((parent.mode & 0o022) !== 0 || parent.uid !== process.getuid?.()) {
+        throw new Error('dream store: database directory must be private to the service owner');
+    }
+}
+function assertMutable(closed) {
+    if (closed)
+        throw new Error('dream store: database is closed');
+}
+/** New idea data must be exact own data: no accessors, proxies or cycles. */
+export function ownData(input) {
+    const seen = new Set();
+    let nodes = 0;
+    const visit = (value, depth) => {
+        if (++nodes > 16_384 || depth > 32)
+            throw new Error('dream data exceeds bounds');
+        if (value === null || typeof value === 'boolean' || typeof value === 'number' && Number.isSafeInteger(value))
+            return;
+        if (typeof value === 'string') {
+            if (!value.isWellFormed() || Buffer.byteLength(value) > 65_536)
+                throw new Error('dream text exceeds bounds');
+            return;
+        }
+        if (typeof value !== 'object' || utilTypes.isProxy(value) || seen.has(value)
+            || ![Object.prototype, null, Array.prototype].includes(Object.getPrototypeOf(value))) {
+            throw new Error('invalid dream data');
+        }
+        seen.add(value);
+        const descriptors = Object.getOwnPropertyDescriptors(value);
+        if (Array.isArray(value))
+            delete descriptors.length;
+        if (Reflect.ownKeys(descriptors).some(key => typeof key !== 'string')
+            || Object.values(descriptors).some(field => !field.enumerable || !('value' in field))) {
+            throw new Error('invalid dream own data');
+        }
+        for (const field of Object.values(descriptors))
+            visit(field.value, depth + 1);
+        seen.delete(value);
+    };
+    visit(input, 0);
+    return JSON.parse(JSON.stringify(input));
+}
+export class DreamStore {
+    db;
+    lane;
+    closed = false;
+    constructor(databasePath, lane) {
+        if (!lane || lane.length > 128 || !/^[\w:-]+$/u.test(lane))
+            throw new Error('dream store: invalid lane');
+        assertLedgerPath(databasePath);
+        this.lane = lane;
+        this.db = new DatabaseSync(databasePath);
+        this.db.exec('PRAGMA journal_mode = WAL');
+        this.db.exec('PRAGMA foreign_keys = ON');
+        this.db.exec(`PRAGMA busy_timeout = 5000`);
+        this.migrate();
+    }
+    migrate() {
+        const version = Number(this.db.prepare('PRAGMA user_version').get().user_version);
+        if (version > SCHEMA_VERSION)
+            throw new Error('dream store: database schema is newer than this build');
+        if (version === SCHEMA_VERSION)
+            return;
+        if (version === 0) {
+            this.db.exec(`
+        CREATE TABLE IF NOT EXISTS dream_runs (
+          id TEXT PRIMARY KEY,
+          lane TEXT NOT NULL,
+          occurrence INTEGER NOT NULL,
+          day_key TEXT NOT NULL,
+          started_at INTEGER NOT NULL,
+          ended_at INTEGER,
+          outcome TEXT NOT NULL CHECK (outcome IN ('running','completed','interrupted')),
+          draw_digest TEXT NOT NULL,
+          idea_count INTEGER NOT NULL DEFAULT 0,
+          UNIQUE (lane, occurrence)
+        );
+        CREATE TABLE IF NOT EXISTS dream_ideas (
+          id TEXT PRIMARY KEY,
+          lane TEXT NOT NULL,
+          run_id TEXT NOT NULL REFERENCES dream_runs(id),
+          created_at INTEGER NOT NULL,
+          day_key TEXT NOT NULL,
+          state TEXT NOT NULL CHECK (state IN ('recorded','withdrawn','owner-acknowledged','validated','rejected')),
+          summary TEXT NOT NULL,
+          detail TEXT NOT NULL,
+          evidence_refs TEXT NOT NULL,
+          summary_digest TEXT NOT NULL,
+          UNIQUE (lane, summary_digest, day_key)
+        );
+        CREATE TABLE IF NOT EXISTS dream_idea_events (
+          seq INTEGER PRIMARY KEY AUTOINCREMENT,
+          idea_id TEXT NOT NULL REFERENCES dream_ideas(id),
+          state TEXT NOT NULL,
+          actor TEXT NOT NULL CHECK (actor IN ('owner','host')),
+          at INTEGER NOT NULL,
+          note TEXT
+        );
+        CREATE TABLE IF NOT EXISTS dream_counters (
+          lane TEXT NOT NULL,
+          day_key TEXT NOT NULL,
+          dreams INTEGER NOT NULL DEFAULT 0,
+          notifications INTEGER NOT NULL DEFAULT 0,
+          last_notification_at INTEGER,
+          PRIMARY KEY (lane, day_key)
+        );
+      `);
+            this.db.exec(`PRAGMA user_version = 1`);
+        }
+        // Schema 2: per-subject lottery tickets plus an audit of every recall hit.
+        if (version < 2) {
+            this.db.exec(`
+        CREATE TABLE IF NOT EXISTS dream_tickets (
+          subject_kind TEXT NOT NULL CHECK(subject_kind IN ('task-projection','goal','skill','recorded-idea')),
+          subject_key TEXT NOT NULL CHECK(length(subject_key) > 0 AND length(subject_key) <= 500),
+          ticket_value INTEGER NOT NULL CHECK(ticket_value >= 0 AND ticket_value < 1000000),
+          ticket_digest TEXT NOT NULL CHECK(length(ticket_digest) = 64 AND ticket_digest NOT GLOB '*[^a-f0-9]*'),
+          created_at INTEGER NOT NULL CHECK(created_at > 0),
+          PRIMARY KEY (subject_kind, subject_key)
+        ) STRICT, WITHOUT ROWID;
+        CREATE TABLE IF NOT EXISTS dream_recalls (
+          seq INTEGER PRIMARY KEY AUTOINCREMENT,
+          lane TEXT NOT NULL,
+          occurrence INTEGER NOT NULL,
+          draw_digest TEXT NOT NULL CHECK(length(draw_digest) = 64 AND draw_digest NOT GLOB '*[^a-f0-9]*'),
+          draw_value INTEGER NOT NULL CHECK(draw_value >= 0 AND draw_value < 1000000),
+          subject_kind TEXT NOT NULL,
+          subject_key TEXT NOT NULL,
+          ticket_value INTEGER NOT NULL,
+          distance INTEGER NOT NULL CHECK(distance >= 0),
+          at INTEGER NOT NULL CHECK(at > 0),
+          UNIQUE (lane, occurrence, subject_kind, subject_key)
+        ) STRICT;
+      `);
+            this.db.exec(`PRAGMA user_version = ${SCHEMA_VERSION}`);
+        }
+    }
+    get isClosed() {
+        return this.closed;
+    }
+    close() {
+        if (!this.closed) {
+            this.db.close();
+            this.closed = true;
+        }
+    }
+    beginDream(id, occurrence, dayKey, startedAt, drawDigest) {
+        assertMutable(this.closed);
+        ownData({ id, occurrence, dayKey, startedAt, drawDigest });
+        this.db.prepare(`INSERT INTO dream_runs (id, lane, occurrence, day_key, started_at, outcome, draw_digest)
+      VALUES (?, ?, ?, ?, ?, 'running', ?)`).run(id, this.lane, occurrence, dayKey, startedAt, drawDigest);
+        this.db.prepare(`INSERT INTO dream_counters (lane, day_key, dreams) VALUES (?, ?, 1)
+      ON CONFLICT(lane, day_key) DO UPDATE SET dreams = dreams + 1`).run(this.lane, dayKey);
+        return this.run(id);
+    }
+    completeDream(id, endedAt, ideaCount) {
+        assertMutable(this.closed);
+        const result = this.db.prepare(`UPDATE dream_runs SET outcome='completed', ended_at=?, idea_count=?
+      WHERE id=? AND lane=? AND outcome='running'`).run(endedAt, ideaCount, id, this.lane);
+        if (result.changes !== 1)
+            throw new Error('dream store: running dream not found');
+    }
+    markInterrupted(id, endedAt) {
+        assertMutable(this.closed);
+        this.db.prepare(`UPDATE dream_runs SET outcome='interrupted', ended_at=? WHERE id=? AND lane=? AND outcome='running'`)
+            .run(endedAt, id, this.lane);
+    }
+    run(id) {
+        const row = this.db.prepare('SELECT * FROM dream_runs WHERE id=? AND lane=?').get(id, this.lane);
+        if (row === undefined)
+            return undefined;
+        return {
+            id: row.id, lane: row.lane, occurrence: row.occurrence,
+            dayKey: row.day_key, startedAt: row.started_at,
+            endedAt: row.ended_at, outcome: row.outcome,
+            drawDigest: row.draw_digest, ideaCount: row.idea_count,
+        };
+    }
+    countDreams(dayKey) {
+        const row = this.db.prepare('SELECT dreams FROM dream_counters WHERE lane=? AND day_key=?').get(this.lane, dayKey);
+        return row?.dreams ?? 0;
+    }
+    /** L1 notification accounting over the existing per-day counters row. */
+    countNotifications(dayKey) {
+        const row = this.db.prepare('SELECT notifications FROM dream_counters WHERE lane=? AND day_key=?')
+            .get(this.lane, dayKey);
+        return row?.notifications ?? 0;
+    }
+    incrementNotifications(dayKey, at) {
+        assertMutable(this.closed);
+        this.db.prepare(`INSERT INTO dream_counters (lane, day_key, dreams, notifications, last_notification_at)
+      VALUES (?, ?, 0, 1, ?)
+      ON CONFLICT(lane, day_key) DO UPDATE SET notifications = notifications + 1, last_notification_at = ?`)
+            .run(this.lane, dayKey, at, at);
+        return this.countNotifications(dayKey);
+    }
+    /** Timestamp of the most recent notification, or null when none was sent. */
+    lastNotificationAt() {
+        const row = this.db.prepare('SELECT MAX(last_notification_at) AS at FROM dream_counters WHERE lane=?')
+            .get(this.lane);
+        return row?.at ?? null;
+    }
+    /**
+     * Register one subject's lottery ticket. The value is derived by the caller
+     * from the plugin seed, so the store never invents randomness; re-registering
+     * the same subject keeps its original ticket.
+     */
+    upsertTicket(ticket) {
+        assertMutable(this.closed);
+        if (!['task-projection', 'goal', 'skill', 'recorded-idea'].includes(ticket.subjectKind)
+            || typeof ticket.subjectKey !== 'string' || !ticket.subjectKey || ticket.subjectKey.length > 500
+            || !Number.isSafeInteger(ticket.value) || ticket.value < 0 || ticket.value >= 1_000_000
+            || !/^[a-f0-9]{64}$/u.test(ticket.digest) || !Number.isSafeInteger(ticket.now) || ticket.now < 1) {
+            throw new Error('dream store: invalid lottery ticket');
+        }
+        this.db.prepare(`INSERT INTO dream_tickets (subject_kind, subject_key, ticket_value, ticket_digest, created_at)
+      VALUES (?, ?, ?, ?, ?) ON CONFLICT(subject_kind, subject_key) DO NOTHING`)
+            .run(ticket.subjectKind, ticket.subjectKey, ticket.value, ticket.digest, ticket.now);
+    }
+    /** All unsolved lottery tickets for this lane, oldest first. */
+    listTickets() {
+        return this.db.prepare(`SELECT subject_kind, subject_key, ticket_value, ticket_digest FROM dream_tickets
+      WHERE subject_kind IN ('task-projection','goal','skill','recorded-idea') ORDER BY created_at, subject_key`)
+            .all()
+            .map(row => ({ subjectKind: row.subject_kind, subjectKey: row.subject_key, value: row.ticket_value, digest: row.ticket_digest }));
+    }
+    /** Record one recall hit; the unique key makes a replayed slot a no-op. */
+    recordRecall(input) {
+        assertMutable(this.closed);
+        const result = this.db.prepare(`INSERT OR IGNORE INTO dream_recalls
+      (lane, occurrence, draw_digest, draw_value, subject_kind, subject_key, ticket_value, distance, at)
+      VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?)`)
+            .run(this.lane, input.occurrence, input.drawDigest, input.drawValue, input.subjectKind, input.subjectKey, input.ticketValue, input.distance, input.at);
+        return Number(result.changes) === 1;
+    }
+    /**
+     * Drop tickets held by recorded ideas that left the `recorded` state
+     * (validated/rejected/withdrawn): a resolved idea must stop being recalled.
+     */
+    pruneResolvedIdeaTickets() {
+        assertMutable(this.closed);
+        return Number(this.db.prepare(`DELETE FROM dream_tickets
+      WHERE subject_kind='recorded-idea' AND NOT EXISTS (
+        SELECT 1 FROM dream_ideas WHERE dream_ideas.lane=? AND dream_ideas.state='recorded'
+          AND dream_ideas.id=dream_tickets.subject_key)`).run(this.lane).changes);
+    }
+    lastRecall() {
+        const row = this.db.prepare(`SELECT occurrence, subject_kind, subject_key, at FROM dream_recalls
+      WHERE lane=? ORDER BY seq DESC LIMIT 1`).get(this.lane);
+        return row === undefined ? undefined
+            : { occurrence: row.occurrence, subjectKind: row.subject_kind, subjectKey: row.subject_key, at: row.at };
+    }
+    recordIdea(idea) {
+        assertMutable(this.closed);
+        const refs = ownData(idea.evidenceRefs);
+        if (!Array.isArray(refs) || refs.length === 0 || refs.some(ref => typeof ref !== 'string' || !/^[a-f0-9]{64}$/u.test(ref))) {
+            throw new Error('dream store: evidence refs must be hex digests');
+        }
+        const value = ownData(idea);
+        if (Buffer.byteLength(value.summary) > 512 || Buffer.byteLength(value.detail) > 4_096) {
+            throw new Error('dream store: idea text exceeds bounds');
+        }
+        const summaryDigest = createHashSafe(`${value.summary}\0${value.dayKey}`);
+        this.db.prepare(`INSERT INTO dream_ideas (id, lane, run_id, created_at, day_key, state, summary, detail, evidence_refs, summary_digest)
+      VALUES (?, ?, ?, ?, ?, 'recorded', ?, ?, ?, ?)`)
+            .run(value.id, this.lane, value.runId, value.createdAt, value.dayKey, value.summary, value.detail, JSON.stringify(refs), summaryDigest);
+        this.db.prepare('UPDATE dream_runs SET idea_count = idea_count + 1 WHERE id=? AND lane=?').run(value.runId, this.lane);
+        return this.idea(value.id);
+    }
+    idea(id) {
+        const row = this.db.prepare('SELECT * FROM dream_ideas WHERE id=? AND lane=?').get(id, this.lane);
+        if (row === undefined)
+            return undefined;
+        return {
+            id: row.id, lane: row.lane, runId: row.run_id,
+            createdAt: row.created_at, dayKey: row.day_key,
+            state: row.state, summary: row.summary, detail: row.detail,
+            evidenceRefs: JSON.parse(row.evidence_refs),
+        };
+    }
+    transitionIdea(id, state, actor, at, note) {
+        assertMutable(this.closed);
+        this.db.exec('BEGIN IMMEDIATE');
+        try {
+            const current = this.idea(id);
+            if (current === undefined)
+                throw new Error('dream store: idea not found');
+            const allowed = {
+                recorded: ['withdrawn', 'owner-acknowledged', 'validated', 'rejected'],
+                withdrawn: [],
+                'owner-acknowledged': ['validated', 'rejected'],
+                validated: [],
+                rejected: [],
+            };
+            if (!allowed[current.state].includes(state))
+                throw new Error(`dream store: transition ${current.state} -> ${state} is not allowed`);
+            this.db.prepare('UPDATE dream_ideas SET state=? WHERE id=? AND lane=?').run(state, id, this.lane);
+            this.db.prepare('INSERT INTO dream_idea_events (idea_id, state, actor, at, note) VALUES (?, ?, ?, ?, ?)')
+                .run(id, state, actor, at, note ?? null);
+            this.db.exec('COMMIT');
+        }
+        catch (error) {
+            this.db.exec('ROLLBACK');
+            throw error;
+        }
+    }
+    listIdeas(limit = 50) {
+        const rows = this.db.prepare('SELECT id FROM dream_ideas WHERE lane=? ORDER BY created_at DESC LIMIT ?').all(this.lane, limit);
+        return rows.map(row => this.idea(row.id));
+    }
+    counts() {
+        const runs = Number(this.db.prepare('SELECT COUNT(*) AS n FROM dream_runs WHERE lane=?').get(this.lane)['n']);
+        const ideas = Number(this.db.prepare('SELECT COUNT(*) AS n FROM dream_ideas WHERE lane=?').get(this.lane).n);
+        const recorded = Number(this.db.prepare(`SELECT COUNT(*) AS n FROM dream_ideas WHERE lane=? AND state='recorded'`).get(this.lane).n);
+        return { runs, ideas, recorded };
+    }
+    /**
+     * Hard-delete expired ideas per retention policy; runs keep audit digests
+     * only. Events are removed first in the same transaction because
+     * `dream_idea_events.idea_id` is a foreign key without ON DELETE CASCADE:
+     * a single event row would otherwise abort the whole prune with
+     * FOREIGN KEY constraint failed and silently disable retention.
+     */
+    prune(now, retentionDays) {
+        assertMutable(this.closed);
+        const cutoff = now - retentionDays * 86_400_000;
+        this.db.exec('BEGIN IMMEDIATE');
+        try {
+            this.db.prepare(`DELETE FROM dream_idea_events WHERE idea_id IN (
+        SELECT id FROM dream_ideas WHERE lane=? AND created_at < ?)`).run(this.lane, cutoff);
+            const removed = Number(this.db.prepare('DELETE FROM dream_ideas WHERE lane=? AND created_at < ?')
+                .run(this.lane, cutoff).changes);
+            this.db.exec('COMMIT');
+            return removed;
+        }
+        catch (error) {
+            this.db.exec('ROLLBACK');
+            throw error;
+        }
+    }
+    interrupt() {
+        assertMutable(this.closed);
+        this.db.prepare(`UPDATE dream_runs SET outcome='interrupted', ended_at=? WHERE lane=? AND outcome='running'`)
+            .run(Date.now(), this.lane);
+    }
+}
+function createHashSafe(value) {
+    return createHash('sha256').update(value, 'utf8').digest('hex');
+}
+//# sourceMappingURL=store.js.map

package/lib/store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.js","sourceRoot":"","sources":["../src/store.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AACxC,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,SAAS,CAAA;AAC9C,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAA;AAC/C,OAAO,EAAE,KAAK,IAAI,SAAS,EAAE,MAAM,WAAW,CAAA;AAC9C,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAE1C;;;;GAIG;AAEH,MAAM,cAAc,GAAG,CAAC,CAAA;AAqCxB,MAAM,UAAU,gBAAgB,CAAC,IAAY;IAC3C,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,KAAK,IAAI;QAAE,MAAM,IAAI,KAAK,CAAC,yDAAyD,CAAC,CAAA;IAC3H,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAA;IAC7C,MAAM,MAAM,GAAG,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAA;IACvC,yEAAyE;IACzE,yDAAyD;IACzD,IAAI,CAAC,MAAM,CAAC,IAAI,GAAG,KAAK,CAAC,KAAK,CAAC,IAAI,MAAM,CAAC,GAAG,KAAK,OAAO,CAAC,MAAM,EAAE,EAAE,EAAE,CAAC;QACrE,MAAM,IAAI,KAAK,CAAC,sEAAsE,CAAC,CAAA;IACzF,CAAC;AACH,CAAC;AAED,SAAS,aAAa,CAAC,MAAe;IACpC,IAAI,MAAM;QAAE,MAAM,IAAI,KAAK,CAAC,iCAAiC,CAAC,CAAA;AAChE,CAAC;AAED,6EAA6E;AAC7E,MAAM,UAAU,OAAO,CAAI,KAAQ;IACjC,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAA;IAC9B,IAAI,KAAK,GAAG,CAAC,CAAA;IACb,MAAM,KAAK,GAAG,CAAC,KAAc,EAAE,KAAa,EAAQ,EAAE;QACpD,IAAI,EAAE,KAAK,GAAG,MAAM,IAAI,KAAK,GAAG,EAAE;YAAE,MAAM,IAAI,KAAK,CAAC,2BAA2B,CAAC,CAAA;QAChF,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,SAAS,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,MAAM,CAAC,aAAa,CAAC,KAAK,CAAC;YAAE,OAAM;QACpH,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;YAC9B,IAAI,CAAC,KAAK,CAAC,YAAY,EAAE,IAAI,MAAM,CAAC,UAAU,CAAC,KAAK,CAAC,GAAG,MAAM;gBAAE,MAAM,IAAI,KAAK,CAAC,2BAA2B,CAAC,CAAA;YAC5G,OAAM;QACR,CAAC;QACD,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,SAAS,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC;eACvE,CAAC,CAAC,MAAM,CAAC,SAAS,EAAE,IAAI,EAAE,KAAK,CAAC,SAAS,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC;YACvF,MAAM,IAAI,KAAK,CAAC,oBAAoB,CAAC,CAAA;QACvC,CAAC;QACD,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAA;QACf,MAAM,WAAW,GAAG,MAAM,CAAC,yBAAyB,CAAC,KAAK,CAAC,CAAA;QAC3D,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;YAAE,OAAO,WAAW,CAAC,MAAM,CAAA;QACnD,IAAI,OAAO,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,OAAO,GAAG,KAAK,QAAQ,CAAC;eAChE,MAAM,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,UAAU,IAAI,CAAC,CAAC,OAAO,IAAI,KAAK,CAAC,CAAC,EAAE,CAAC;YACxF,MAAM,IAAI,KAAK,CAAC,wBAAwB,CAAC,CAAA;QAC3C,CAAC;QACD,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,MAAM,CAAC,WAAW,CAAC;YAAE,KAAK,CAAC,KAAK,CAAC,KAAK,EAAE,KAAK,GAAG,CAAC,CAAC,CAAA;QAC7E,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;IACpB,CAAC,CAAA;IACD,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC,CAAA;IACf,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAM,CAAA;AAC/C,CAAC;AAED,MAAM,OAAO,UAAU;IACJ,EAAE,CAAc;IAChB,IAAI,CAAQ;IACrB,MAAM,GAAG,KAAK,CAAA;IAEtB,YAAY,YAAoB,EAAE,IAAY;QAC5C,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,MAAM,GAAG,GAAG,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,2BAA2B,CAAC,CAAA;QACxG,gBAAgB,CAAC,YAAY,CAAC,CAAA;QAC9B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAA;QAChB,IAAI,CAAC,EAAE,GAAG,IAAI,YAAY,CAAC,YAAY,CAAC,CAAA;QACxC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,2BAA2B,CAAC,CAAA;QACzC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,0BAA0B,CAAC,CAAA;QACxC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,4BAA4B,CAAC,CAAA;QAC1C,IAAI,CAAC,OAAO,EAAE,CAAA;IAChB,CAAC;IAEO,OAAO;QACb,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,CAAC,qBAAqB,CAAC,CAAC,GAAG,EAAG,CAAC,YAAY,CAAC,CAAA;QAClF,IAAI,OAAO,GAAG,cAAc;YAAE,MAAM,IAAI,KAAK,CAAC,uDAAuD,CAAC,CAAA;QACtG,IAAI,OAAO,KAAK,cAAc;YAAE,OAAM;QACtC,IAAI,OAAO,KAAK,CAAC,EAAE,CAAC;YAClB,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA0CZ,CAAC,CAAA;YACF,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,yBAAyB,CAAC,CAAA;QACzC,CAAC;QACD,2EAA2E;QAC3E,IAAI,OAAO,GAAG,CAAC,EAAE,CAAC;YAChB,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC;;;;;;;;;;;;;;;;;;;;;;OAsBZ,CAAC,CAAA;YACF,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,yBAAyB,cAAc,EAAE,CAAC,CAAA;QACzD,CAAC;IACH,CAAC;IAED,IAAI,QAAQ;QACV,OAAO,IAAI,CAAC,MAAM,CAAA;IACpB,CAAC;IAED,KAAK;QACH,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;YAAC,IAAI,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC;YAAC,IAAI,CAAC,MAAM,GAAG,IAAI,CAAA;QAAC,CAAC;IAC3D,CAAC;IAED,UAAU,CAAC,EAAU,EAAE,UAAkB,EAAE,MAAc,EAAE,SAAiB,EAAE,UAAkB;QAC9F,aAAa,CAAC,IAAI,CAAC,MAAM,CAAC,CAAA;QAC1B,OAAO,CAAC,EAAE,EAAE,EAAE,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,UAAU,EAAE,CAAC,CAAA;QAC1D,IAAI,CAAC,EAAE,CAAC,OAAO,CAAC;2CACuB,CAAC,CAAC,GAAG,CAAC,EAAE,EAAE,IAAI,CAAC,IAAI,EAAE,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,UAAU,CAAC,CAAA;QACtG,IAAI,CAAC,EAAE,CAAC,OAAO,CAAC;mEAC+C,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC,CAAA;QACvF,OAAO,IAAI,CAAC,GAAG,CAAC,EAAE,CAAE,CAAA;IACtB,CAAC;IAED,aAAa,CAAC,EAAU,EAAE,OAAe,EAAE,SAAiB;QAC1D,aAAa,CAAC,IAAI,CAAC,MAAM,CAAC,CAAA;QAC1B,MAAM,MAAM,GAAG,IAAI,CAAC,EAAE,CAAC,OAAO,CAAC;kDACe,CAAC,CAAC,GAAG,CAAC,OAAO,EAAE,SAAS,EAAE,EAAE,EAAE,IAAI,CAAC,IAAI,CAAC,CAAA;QACtF,IAAI,MAAM,CAAC,OAAO,KAAK,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,sCAAsC,CAAC,CAAA;IACnF,CAAC;IAED,eAAe,CAAC,EAAU,EAAE,OAAe;QACzC,aAAa,CAAC,IAAI,CAAC,MAAM,CAAC,CAAA;QAC1B,IAAI,CAAC,EAAE,CAAC,OAAO,CAAC,qGAAqG,CAAC;aACnH,GAAG,CAAC,OAAO,EAAE,EAAE,EAAE,IAAI,CAAC,IAAI,CAAC,CAAA;IAChC,CAAC;IAED,GAAG,CAAC,EAAU;QACZ,MAAM,GAAG,GAAG,IAAI,CAAC,EAAE,CAAC,OAAO,CAAC,gDAAgD,CAAC,CAAC,GAAG,CAAC,EAAE,EAAE,IAAI,CAAC,IAAI,CAAwC,CAAA;QACvI,IAAI,GAAG,KAAK,SAAS;YAAE,OAAO,SAAS,CAAA;QACvC,OAAO;YACL,EAAE,EAAE,GAAG,CAAC,EAAY,EAAE,IAAI,EAAE,GAAG,CAAC,IAAc,EAAE,UAAU,EAAE,GAAG,CAAC,UAAoB;YACpF,MAAM,EAAE,GAAG,CAAC,OAAiB,EAAE,SAAS,EAAE,GAAG,CAAC,UAAoB;YAClE,OAAO,EAAE,GAAG,CAAC,QAAyB,EAAE,OAAO,EAAE,GAAG,CAAC,OAAoC;YACzF,UAAU,EAAE,GAAG,CAAC,WAAqB,EAAE,SAAS,EAAE,GAAG,CAAC,UAAoB;SAC3E,CAAA;IACH,CAAC;IAED,WAAW,CAAC,MAAc;QACxB,MAAM,GAAG,GAAG,IAAI,CAAC,EAAE,CAAC,OAAO,CAAC,8DAA8D,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,CAAmC,CAAA;QACpJ,OAAO,GAAG,EAAE,MAAM,IAAI,CAAC,CAAA;IACzB,CAAC;IAED,yEAAyE;IACzE,kBAAkB,CAAC,MAAc;QAC/B,MAAM,GAAG,GAAG,IAAI,CAAC,EAAE,CAAC,OAAO,CAAC,qEAAqE,CAAC;aAC/F,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,CAA0C,CAAA;QAClE,OAAO,GAAG,EAAE,aAAa,IAAI,CAAC,CAAA;IAChC,CAAC;IAED,sBAAsB,CAAC,MAAc,EAAE,EAAU;QAC/C,aAAa,CAAC,IAAI,CAAC,MAAM,CAAC,CAAA;QAC1B,IAAI,CAAC,EAAE,CAAC,OAAO,CAAC;;2GAEuF,CAAC;aACrG,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,CAAC,CAAA;QACjC,OAAO,IAAI,CAAC,kBAAkB,CAAC,MAAM,CAAC,CAAA;IACxC,CAAC;IAED,6EAA6E;IAC7E,kBAAkB;QAChB,MAAM,GAAG,GAAG,IAAI,CAAC,EAAE,CAAC,OAAO,CAAC,yEAAyE,CAAC;aACnG,GAAG,CAAC,IAAI,CAAC,IAAI,CAAsC,CAAA;QACtD,OAAO,GAAG,EAAE,EAAE,IAAI,IAAI,CAAA;IACxB,CAAC;IAED;;;;OAIG;IACH,YAAY,CAAC,MAA+F;QAC1G,aAAa,CAAC,IAAI,CAAC,MAAM,CAAC,CAAA;QAC1B,IAAI,CAAC,CAAC,iBAAiB,EAAE,MAAM,EAAE,OAAO,EAAE,eAAe,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,WAAW,CAAC;eAClF,OAAO,MAAM,CAAC,UAAU,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,UAAU,IAAI,MAAM,CAAC,UAAU,CAAC,MAAM,GAAG,GAAG;eAC7F,CAAC,MAAM,CAAC,aAAa,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,MAAM,CAAC,KAAK,GAAG,CAAC,IAAI,MAAM,CAAC,KAAK,IAAI,SAAS;eACpF,CAAC,iBAAiB,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,MAAM,CAAC,GAAG,GAAG,CAAC,EAAE,CAAC;YACnG,MAAM,IAAI,KAAK,CAAC,qCAAqC,CAAC,CAAA;QACxD,CAAC;QACD,IAAI,CAAC,EAAE,CAAC,OAAO,CAAC;+EAC2D,CAAC;aACzE,GAAG,CAAC,MAAM,CAAC,WAAW,EAAE,MAAM,CAAC,UAAU,EAAE,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,CAAC,CAAA;IACxF,CAAC;IAED,gEAAgE;IAChE,WAAW;QACT,OAAQ,IAAI,CAAC,EAAE,CAAC,OAAO,CAAC;gHACoF,CAAC;aAC1G,GAAG,EAAwG;aAC3G,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,EAAE,WAAW,EAAE,GAAG,CAAC,YAAY,EAAE,UAAU,EAAE,GAAG,CAAC,WAAW,EAAE,KAAK,EAAE,GAAG,CAAC,YAAY,EAAE,MAAM,EAAE,GAAG,CAAC,aAAa,EAAE,CAAC,CAAC,CAAA;IACrI,CAAC;IAED,2EAA2E;IAC3E,YAAY,CAAC,KAC4D;QACvE,aAAa,CAAC,IAAI,CAAC,MAAM,CAAC,CAAA;QAC1B,MAAM,MAAM,GAAG,IAAI,CAAC,EAAE,CAAC,OAAO,CAAC;;yCAEM,CAAC;aACnC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,CAAC,UAAU,EAAE,KAAK,CAAC,UAAU,EAAE,KAAK,CAAC,SAAS,EAAE,KAAK,CAAC,WAAW,EACpF,KAAK,CAAC,UAAU,EAAE,KAAK,CAAC,WAAW,EAAE,KAAK,CAAC,QAAQ,EAAE,KAAK,CAAC,EAAE,CAAC,CAAA;QAClE,OAAO,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAA;IACrC,CAAC;IAED;;;OAGG;IACH,wBAAwB;QACtB,aAAa,CAAC,IAAI,CAAC,MAAM,CAAC,CAAA;QAC1B,OAAO,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,CAAC;;;wDAGsB,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,CAAA;IAC/E,CAAC;IAED,UAAU;QACR,MAAM,GAAG,GAAG,IAAI,CAAC,EAAE,CAAC,OAAO,CAAC;6CACa,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CACmC,CAAA;QAC3F,OAAO,GAAG,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS;YAClC,CAAC,CAAC,EAAE,UAAU,EAAE,GAAG,CAAC,UAAU,EAAE,WAAW,EAAE,GAAG,CAAC,YAAY,EAAE,UAAU,EAAE,GAAG,CAAC,WAAW,EAAE,EAAE,EAAE,GAAG,CAAC,EAAE,EAAE,CAAA;IAC5G,CAAC;IAED,UAAU,CAAC,IAAuC;QAChD,aAAa,CAAC,IAAI,CAAC,MAAM,CAAC,CAAA;QAC1B,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,YAAY,CAAC,CAAA;QACvC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,OAAO,GAAG,KAAK,QAAQ,IAAI,CAAC,iBAAiB,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC;YAC3H,MAAM,IAAI,KAAK,CAAC,gDAAgD,CAAC,CAAA;QACnE,CAAC;QACD,MAAM,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;QAC3B,IAAI,MAAM,CAAC,UAAU,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,GAAG,IAAI,MAAM,CAAC,UAAU,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,KAAK,EAAE,CAAC;YACtF,MAAM,IAAI,KAAK,CAAC,uCAAuC,CAAC,CAAA;QAC1D,CAAC;QACD,MAAM,aAAa,GAAG,cAAc,CAAC,GAAG,KAAK,CAAC,OAAO,KAAK,KAAK,CAAC,MAAM,EAAE,CAAC,CAAA;QACzE,IAAI,CAAC,EAAE,CAAC,OAAO,CAAC;qDACiC,CAAC;aAC/C,GAAG,CAAC,KAAK,CAAC,EAAE,EAAE,IAAI,CAAC,IAAI,EAAE,KAAK,CAAC,KAAK,EAAE,KAAK,CAAC,SAAS,EAAE,KAAK,CAAC,MAAM,EAAE,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC,MAAM,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,aAAa,CAAC,CAAA;QACzI,IAAI,CAAC,EAAE,CAAC,OAAO,CAAC,yEAAyE,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,EAAE,IAAI,CAAC,IAAI,CAAC,CAAA;QACtH,OAAO,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAE,CAAA;IAC7B,CAAC;IAED,IAAI,CAAC,EAAU;QACb,MAAM,GAAG,GAAG,IAAI,CAAC,EAAE,CAAC,OAAO,CAAC,iDAAiD,CAAC,CAAC,GAAG,CAAC,EAAE,EAAE,IAAI,CAAC,IAAI,CAAwC,CAAA;QACxI,IAAI,GAAG,KAAK,SAAS;YAAE,OAAO,SAAS,CAAA;QACvC,OAAO;YACL,EAAE,EAAE,GAAG,CAAC,EAAY,EAAE,IAAI,EAAE,GAAG,CAAC,IAAc,EAAE,KAAK,EAAE,GAAG,CAAC,MAAgB;YAC3E,SAAS,EAAE,GAAG,CAAC,UAAoB,EAAE,MAAM,EAAE,GAAG,CAAC,OAAiB;YAClE,KAAK,EAAE,GAAG,CAAC,KAAkB,EAAE,OAAO,EAAE,GAAG,CAAC,OAAiB,EAAE,MAAM,EAAE,GAAG,CAAC,MAAgB;YAC3F,YAAY,EAAE,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,aAAuB,CAAa;SAClE,CAAA;IACH,CAAC;IAED,cAAc,CAAC,EAAU,EAAE,KAAqC,EAAE,KAAuB,EAAE,EAAU,EAAE,IAAa;QAClH,aAAa,CAAC,IAAI,CAAC,MAAM,CAAC,CAAA;QAC1B,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAA;QAC/B,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;YAC7B,IAAI,OAAO,KAAK,SAAS;gBAAE,MAAM,IAAI,KAAK,CAAC,6BAA6B,CAAC,CAAA;YACzE,MAAM,OAAO,GAAsD;gBACjE,QAAQ,EAAE,CAAC,WAAW,EAAE,oBAAoB,EAAE,WAAW,EAAE,UAAU,CAAC;gBACtE,SAAS,EAAE,EAAE;gBACb,oBAAoB,EAAE,CAAC,WAAW,EAAE,UAAU,CAAC;gBAC/C,SAAS,EAAE,EAAE;gBACb,QAAQ,EAAE,EAAE;aACb,CAAA;YACD,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC;gBAAE,MAAM,IAAI,KAAK,CAAC,2BAA2B,OAAO,CAAC,KAAK,OAAO,KAAK,iBAAiB,CAAC,CAAA;YACnI,IAAI,CAAC,EAAE,CAAC,OAAO,CAAC,sDAAsD,CAAC,CAAC,GAAG,CAAC,KAAK,EAAE,EAAE,EAAE,IAAI,CAAC,IAAI,CAAC,CAAA;YACjG,IAAI,CAAC,EAAE,CAAC,OAAO,CAAC,wFAAwF,CAAC;iBACtG,GAAG,CAAC,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE,EAAE,IAAI,IAAI,IAAI,CAAC,CAAA;YAC1C,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAA;QACxB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;YAAC,MAAM,KAAK,CAAA;QAAC,CAAC;IAC3D,CAAC;IAED,SAAS,CAAC,KAAK,GAAG,EAAE;QAClB,MAAM,IAAI,GAAG,IAAI,CAAC,EAAE,CAAC,OAAO,CAAC,0EAA0E,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,CAA0B,CAAA;QACvJ,OAAO,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAE,CAAC,CAAA;IAC5C,CAAC;IAED,MAAM;QACJ,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,CAAC,mDAAmD,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAE,CAAC,GAAG,CAAC,CAAC,CAAA;QAC9G,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,CAAC,oDAAoD,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAE,CAAC,CAAC,CAAC,CAAA;QAC7G,MAAM,QAAQ,GAAG,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,CAAC,yEAAyE,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAE,CAAC,CAAC,CAAC,CAAA;QACrI,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAA;IAClC,CAAC;IAED;;;;;;OAMG;IACH,KAAK,CAAC,GAAW,EAAE,aAAqB;QACtC,aAAa,CAAC,IAAI,CAAC,MAAM,CAAC,CAAA;QAC1B,MAAM,MAAM,GAAG,GAAG,GAAG,aAAa,GAAG,UAAU,CAAA;QAC/C,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAA;QAC/B,IAAI,CAAC;YACH,IAAI,CAAC,EAAE,CAAC,OAAO,CAAC;oEAC8C,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC,CAAA;YACtF,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,CAAC,yDAAyD,CAAC;iBAC9F,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,OAAO,CAAC,CAAA;YAClC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAA;YACtB,OAAO,OAAO,CAAA;QAChB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,CAAA;YACxB,MAAM,KAAK,CAAA;QACb,CAAC;IACH,CAAC;IAED,SAAS;QACP,aAAa,CAAC,IAAI,CAAC,MAAM,CAAC,CAAA;QAC1B,IAAI,CAAC,EAAE,CAAC,OAAO,CAAC,4FAA4F,CAAC;aAC1G,GAAG,CAAC,IAAI,CAAC,GAAG,EAAE,EAAE,IAAI,CAAC,IAAI,CAAC,CAAA;IAC/B,CAAC;CACF;AAED,SAAS,cAAc,CAAC,KAAa;IACnC,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;AACjE,CAAC"}

package/lib/trigger.d.ts

@@ -0,0 +1,134 @@
+import type { DreamingActiveHours } from './config.js';
+/**
+ * Deterministic dreaming trigger. Randomness is an auditable HMAC draw keyed
+ * by an owner seed and a stable occurrence identity, so the same inputs always
+ * produce the same decision in tests and after restart. The module never calls
+ * Math.random and never schedules anything itself.
+ */
+export declare const MILLION = 1000000;
+declare const MINUTES_PER_DAY = 1440;
+export interface DrawInput {
+    seedDigest: string;
+    lane: string;
+    /** Stable monotonic occurrence number of the scheduler slot. */
+    occurrence: number;
+    /** Probability of dreaming, in parts per million (0..1_000_000). */
+    probabilityPpm: number;
+}
+export interface DrawResult {
+    drawDigest: string;
+    /** Uniform value in [0, 1_000_000) derived from the HMAC. */
+    value: number;
+    selected: boolean;
+}
+/**
+ * Returns the auditable draw for one slot. Determinism makes the decision
+ * replayable; the digest alone is persisted, never the seed.
+ */
+export declare function evaluateDraw(input: DrawInput): DrawResult;
+/**
+ * Local-day key in UTC minutes. The scheduler uses this for per-day caps; a
+ * timezone-aware activeHours check happens separately.
+ */
+export declare function localDayKey(now: number, timezone: string): string;
+export declare function isWithinActiveHours(now: number, activeHours: DreamingActiveHours | null): boolean;
+/**
+ * Conservative idle gate based on the latest trusted activity timestamp. The
+ * caller supplies activity measured through Host projections (never model
+ * prose); a missing marker means "not idle" so the first run fails closed.
+ */
+export declare function isIdle(now: number, latestActivityAt: number | null, idleMinMs: number): boolean;
+export type SkipReason = 'outside-active-hours' | 'not-idle' | 'daily-cap' | 'draw-not-selected';
+export interface TriggerInput {
+    now: number;
+    occurrence: number;
+    lane: string;
+    seedDigest: string;
+    probabilityPpm: number;
+    activeHours: DreamingActiveHours | null;
+    latestActivityAt: number | null;
+    idleMinMs: number;
+    dreamsToday: number;
+    maxDreamsPerDay: number;
+}
+export type TriggerDecision = {
+    fire: true;
+    drawDigest: string;
+    drawValue: number;
+    dayKey: string;
+} | {
+    fire: false;
+    reason: SkipReason;
+    dayKey: string;
+};
+/**
+ * Pure decision combining every gate in fail-closed order: active window,
+ * idle window, daily cap, deterministic draw. No side effects.
+ */
+export declare function decideTrigger(input: TriggerInput): TriggerDecision;
+/** Current slot occurrence derived from the base interval since epoch. */
+export declare function slotOccurrence(now: number, baseIntervalMs: number): number;
+/**
+ * Per-subject lottery tickets ("无事找事"): every recallable thing — a task,
+ * a goal, a skill, or a previously recorded idea — holds one ticket with a
+ * stable ticket value. Each wake slot rolls one bounded random number from the
+ * HMAC seed; a subject whose ticket value lands inside the rolling window is
+ * recalled for focused thought. This is code-driven (the draw and match run
+ * without any model call) — the model is invoked only after a hit.
+ *
+ * Values live in a widened range rather than [0,1) so a configurable window
+ * can be made wider without touching the deterministic draw.
+ */
+export declare const TICKET_MODULUS = 1000000;
+/** Default rolling window around the draw value in each direction. */
+export declare const DEFAULT_TICKET_WINDOW = 5000;
+export type LotterySubjectKind = 'task-projection' | 'goal' | 'skill' | 'recorded-idea';
+export interface LotterySubject {
+    kind: LotterySubjectKind;
+    /** Stable subject key (inbox id, goal id, skill name, or idea id). */
+    key: string;
+}
+export interface Ticket {
+    subject: LotterySubject;
+    /** Stable value in [0, TICKET_MODULUS) derived from the ticket seed. */
+    value: number;
+    digest: string;
+}
+/** One subject's stable ticket. The seed is only used as HMAC material. */
+export declare function assignTicket(input: {
+    seedDigest: string;
+    lane: string;
+    subject: LotterySubject;
+}): Ticket;
+export interface LotteryDrawInput {
+    seedDigest: string;
+    lane: string;
+    occurrence: number;
+}
+export interface LotteryDraw {
+    drawDigest: string;
+    /** Rolled value in [0, TICKET_MODULUS). */
+    value: number;
+}
+/** The wake's single rolling number, derived deterministically from the seed. */
+export declare function rollLottery(input: LotteryDrawInput): LotteryDraw;
+export interface LotteryMatchInput {
+    draw: LotteryDraw;
+    tickets: readonly Ticket[];
+    /** Half-width of the circular window; default keeps roughly 1% of tickets. */
+    window?: number;
+}
+export interface LotteryHit {
+    subject: LotterySubject;
+    ticketDigest: string;
+    ticketValue: number;
+    distance: number;
+}
+/**
+ * Returns the tickets whose value is within `window` of the draw on the
+ * circular modulus. Deterministic and side-effect free; an empty result means
+ * nothing is recalled this slot, which is the normal "no thought" outcome.
+ */
+export declare function matchTickets(input: LotteryMatchInput): readonly LotteryHit[];
+export { MINUTES_PER_DAY };
+//# sourceMappingURL=trigger.d.ts.map

package/lib/trigger.d.ts.map

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