@agencer/reverie-loop 0.1.0-alpha.0 → 0.1.0

package/dist/reverie-loop.js

@@ -0,0 +1,216 @@
+// @agencer/reverie-loop reverie-loop module.
+//
+// Leg G-4a: extracted from packages/server/src/services/reverie-loop.ts
+// (350 LOC). The post-session self-reflection orchestrator.
+//
+// Two execution paths share this module:
+//
+//   1. Real path: production. When deps.forceMock is false/undefined,
+//      executeReverie composes executeReflection (opus-client) +
+//      splitResultByCategory + appendReverieResult / appendSafetyFlag
+//      (pair-sink) for the triple-discriminated jsonl audit trail.
+//      Records cost via deps.meter (Law 16). Returns ReverieResultReal
+//      (the new pairs[] schema).
+//
+//   2. Legacy mock path: test scaffolding. When deps.forceMock is true,
+//      executeReverie generates a ReverieResultLegacy (the old
+//      observations[] schema) and writes to deps.legacyReverieLogPath.
+//      Retained ONLY for pre-existing test scaffolding; production
+//      callers always pass forceMock: false (or omit it).
+//
+// Sacred constraint (Law 8, declared in README): No process.env or
+// os.homedir() reads inside this module. The agencer-ox composition
+// root (and the compatibility shim until G-6) reads
+// process.env["MOCK_REVERIE"] and threads it as deps.forceMock; same
+// pattern for the three jsonl paths.
+//
+// CRITICAL: All public functions NEVER throw. Reverie is
+// observability + training-corpus infrastructure; it cannot block
+// the user-facing teardown path.
+import fs from "node:fs";
+import path from "node:path";
+import { executeReflection, } from "./opus-client.js";
+import { splitResultByCategory, appendReverieResult, appendSafetyFlag, } from "./pair-sink.js";
+// ── Module state ──────────────────────────────────────────────────
+const _pendingTimers = new Map();
+let _lastReverie = null;
+let _lastReverieReal = null;
+const DEBOUNCE_MS = 10_000; // 10 seconds (Leg 1b contract)
+// ── Public API ────────────────────────────────────────────────────
+/**
+ * Trigger a reverie for a session. Debounced by 10 seconds to avoid
+ * firing on quick reconnects.
+ *
+ * Always takes a `deps` argument (forceMock toggles the path). The
+ * pre-Leg-G no-deps overload is preserved on the agencer-ox
+ * compatibility shim only.
+ */
+export function triggerReverie(sessionId, getHistory, deps) {
+    try {
+        const existing = _pendingTimers.get(sessionId);
+        if (existing)
+            clearTimeout(existing);
+        const timer = setTimeout(() => {
+            _pendingTimers.delete(sessionId);
+            void executeReverie(sessionId, getHistory(), deps);
+        }, DEBOUNCE_MS);
+        _pendingTimers.set(sessionId, timer);
+    }
+    catch {
+        // NEVER throw
+    }
+}
+/**
+ * Execute reverie immediately.
+ *
+ * Real path when deps.forceMock is false/undefined; legacy mock path
+ * when deps.forceMock is true. Return type is the union; consumers
+ * with specific knowledge can narrow via the forceMock flag or by
+ * runtime shape check (`"pairs" in result` discriminates real vs
+ * legacy).
+ */
+export async function executeReverie(sessionId, history, deps) {
+    // Real path: forceMock not set.
+    if (!deps.forceMock) {
+        return executeRealReverie(sessionId, history, deps);
+    }
+    // Legacy path: mock observations[] schema, writes
+    // deps.legacyReverieLogPath.
+    return executeLegacyMockReverie(sessionId, history, deps.legacyReverieLogPath);
+}
+/**
+ * Most recent reverie result (legacy shape; test scaffolding).
+ */
+export function getLastReverie() {
+    return _lastReverie;
+}
+/**
+ * Most recent real-path reverie result. Used by tests of the real
+ * path; production callers should consume the jsonl audit logs.
+ */
+export function getLastReverieReal() {
+    return _lastReverieReal;
+}
+/**
+ * Cancel all pending reverie timers (shutdown / test teardown).
+ */
+export function cancelAllReveries() {
+    for (const timer of _pendingTimers.values()) {
+        clearTimeout(timer);
+    }
+    _pendingTimers.clear();
+}
+// ── Real path ─────────────────────────────────────────────────────
+async function executeRealReverie(cohortId, history, deps) {
+    try {
+        const result = await executeReflection({
+            cohortId,
+            userContext: deps.userContext,
+            history,
+            inferenceProvider: deps.inferenceProvider,
+            meter: deps.meter,
+            costCalculator: deps.costCalculator,
+            logger: deps.logger,
+        });
+        // Split for triple-discriminated routing. Always emit at least
+        // one record (audit trail per Anthropic call).
+        const split = splitResultByCategory(result, deps.reveriePairsPath);
+        if (split.behavioral) {
+            await appendReverieResult(deps.reveriePairsPath, split.behavioral, deps.logger);
+        }
+        if (split.safety) {
+            await appendSafetyFlag(deps.reverieSafetyFlagsPath, split.safety, deps.logger);
+        }
+        if (split.behavioral) {
+            deps.logger.info({
+                cohortId,
+                pairs_total: result.pairs.length,
+                pairs_behavioral: split.behavioral.pairs.length,
+                pairs_safety: split.safety?.pairs.length ?? 0,
+                cost_usd: result.cost_usd,
+                model: result.model,
+                error_kind: result.error_kind,
+                validation_error: result.validation_error,
+            }, "reverie-loop.executeRealReverie complete");
+        }
+        else {
+            deps.logger.info({
+                cohortId,
+                pairs_safety: split.safety?.pairs.length ?? 0,
+                cost_usd: result.cost_usd,
+                model: result.model,
+            }, "reverie-loop.executeRealReverie complete (pure safety cohort)");
+        }
+        _lastReverieReal = result;
+        return result;
+    }
+    catch (err) {
+        // executeReflection is contract-bound to never throw; if it does,
+        // log + swallow per the always-resolves contract.
+        deps.logger.warn({ err: err instanceof Error ? err.message : String(err), cohortId }, "reverie-loop.executeRealReverie unexpected throw (executeReflection contract violation)");
+        return null;
+    }
+}
+// ── Legacy mock path (test scaffolding only) ──────────────────────
+async function executeLegacyMockReverie(sessionId, history, legacyReverieLogPath) {
+    try {
+        const exchanges = pairExchanges(history);
+        if (exchanges.length === 0)
+            return null;
+        const result = generateMockReverie(sessionId, exchanges.length);
+        _lastReverie = result;
+        writeLegacyReverieLog(result, legacyReverieLogPath);
+        return result;
+    }
+    catch {
+        return null;
+    }
+}
+function pairExchanges(history) {
+    const pairs = [];
+    for (let i = 0; i < history.length - 1; i++) {
+        const current = history[i];
+        const next = history[i + 1];
+        if (current && next && current.role === "user" && next.role === "assistant") {
+            pairs.push({ user: current.content, assistant: next.content });
+        }
+    }
+    return pairs;
+}
+function generateMockReverie(sessionId, exchangeCount) {
+    const observations = [];
+    for (let i = 0; i < exchangeCount; i++) {
+        const isLast = i === exchangeCount - 1 && exchangeCount > 1;
+        observations.push({
+            exchange_index: i,
+            helpfulness: isLast ? 5 : 8 + Math.floor(Math.random() * 2),
+            in_character: isLast ? 4 : 8 + Math.floor(Math.random() * 2),
+            user_corrected: isLast,
+            correction: isLast ? "User corrected a factual claim" : null,
+            lesson: isLast
+                ? "Next time I should verify facts before stating them confidently"
+                : "Continue responding in this style",
+        });
+    }
+    return {
+        sessionId,
+        timestamp: new Date().toISOString(),
+        observations,
+        summary: `Reviewed ${exchangeCount} exchanges. ${exchangeCount - 1} were well-received, 1 needed correction.`,
+    };
+}
+function writeLegacyReverieLog(result, legacyReverieLogPath) {
+    // Legacy mock writes to reverie-log.jsonl (the OLD file, schema
+    // ReverieResultLegacy). The real path (executeRealReverie) writes
+    // to reverie-pairs.jsonl + reverie-safety-flags.jsonl instead.
+    // This legacy file remains an orphan artifact for test scaffolding;
+    // ox-data-factory consumes only reverie-pairs.jsonl going forward.
+    try {
+        fs.mkdirSync(path.dirname(legacyReverieLogPath), { recursive: true });
+        fs.appendFileSync(legacyReverieLogPath, JSON.stringify(result) + "\n");
+    }
+    catch {
+        // NEVER let logging break anything
+    }
+}
+//# sourceMappingURL=reverie-loop.js.map

package/dist/reverie-loop.js.map

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

package/dist/reverie-trigger.d.ts

@@ -0,0 +1,67 @@
+import type { CostCalculator, LoggerLike, ReverieInferenceProvider, ReverieUserContext, UsageMeter } from "./contracts.js";
+import { type ConversationExchange } from "./reverie-loop.js";
+export interface ReverieTriggerOptions {
+    meter: UsageMeter;
+    logger: LoggerLike;
+    /** Cost calculator (injected). UsageAccountant's calculateCost
+     *  satisfies the signature byte-for-byte. */
+    costCalculator: CostCalculator;
+    /** Real Anthropic Opus client. When provided, fireForCohort routes
+     *  triggerReverie through the real-Opus + dual-jsonl-sink path.
+     *  When absent (test scaffolding), the legacy mock observations[]
+     *  schema is produced. */
+    inferenceProvider?: ReverieInferenceProvider;
+    /** Absolute path. Behavioral correction-pair JSONL audit log
+     *  written by the real path. */
+    reveriePairsPath: string;
+    /** Absolute path. Safety-concern JSONL audit log written by the
+     *  real path. */
+    reverieSafetyFlagsPath: string;
+    /** Absolute path. Legacy mock JSONL audit log written by the
+     *  legacy mock path (test scaffolding). */
+    legacyReverieLogPath: string;
+    /** Idle window before reverie fires from inactivity. Default 5min. */
+    idleMs?: number;
+    /** Per-user daily reverie cost ceiling. Default $1.00. */
+    dailyBudgetUsd?: number;
+    /** Force legacy mock path even when inferenceProvider is wired
+     *  (composition root reads process.env["MOCK_REVERIE"] and threads
+     *  it). Default false. */
+    forceMock?: boolean;
+}
+export declare class ReverieTrigger {
+    private readonly meter;
+    private readonly logger;
+    private readonly costCalculator;
+    private readonly idleMs;
+    private readonly dailyBudgetUsd;
+    private readonly inferenceProvider;
+    private readonly reveriePairsPath;
+    private readonly reverieSafetyFlagsPath;
+    private readonly legacyReverieLogPath;
+    private readonly forceMockBase;
+    private currentCohort;
+    constructor(opts: ReverieTriggerOptions);
+    /**
+     * Mark the active cohort. Starts a cohort if none exists, refreshes
+     * the userContext + getHistory snapshot if one does, resets the
+     * idle timer either way. Called per turn from brain/route-and-log.ts.
+     */
+    markActive(userContext: ReverieUserContext, getHistory: () => ConversationExchange[]): void;
+    /**
+     * Fire reverie for the active cohort and clear it. Called from
+     * index.ts's onClientDisconnect when wsContext.clients.size === 0.
+     * Detached via setImmediate so the WebSocket teardown call stack
+     * returns immediately.
+     */
+    endCohort(): void;
+    /**
+     * Cancel any in-flight idle timer and clear cohort state. For
+     * server shutdown / test teardown. Does NOT fire reverie.
+     */
+    cancelAll(): void;
+    private fireForCohort;
+    private recordCounter;
+    private dailyReverieCost;
+}
+//# sourceMappingURL=reverie-trigger.d.ts.map

package/dist/reverie-trigger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reverie-trigger.d.ts","sourceRoot":"","sources":["../src/reverie-trigger.ts"],"names":[],"mappings":"AA4CA,OAAO,KAAK,EACV,cAAc,EACd,UAAU,EACV,wBAAwB,EACxB,kBAAkB,EAClB,UAAU,EACX,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAEL,KAAK,oBAAoB,EAE1B,MAAM,mBAAmB,CAAC;AAc3B,MAAM,WAAW,qBAAqB;IACpC,KAAK,EAAE,UAAU,CAAC;IAClB,MAAM,EAAE,UAAU,CAAC;IACnB;iDAC6C;IAC7C,cAAc,EAAE,cAAc,CAAC;IAC/B;;;8BAG0B;IAC1B,iBAAiB,CAAC,EAAE,wBAAwB,CAAC;IAE7C;oCACgC;IAChC,gBAAgB,EAAE,MAAM,CAAC;IACzB;qBACiB;IACjB,sBAAsB,EAAE,MAAM,CAAC;IAC/B;+CAC2C;IAC3C,oBAAoB,EAAE,MAAM,CAAC;IAE7B,sEAAsE;IACtE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,0DAA0D;IAC1D,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB;;8BAE0B;IAC1B,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAuBD,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAa;IACnC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAa;IACpC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAiB;IAChD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAS;IACxC,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAuC;IACzE,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAS;IAC1C,OAAO,CAAC,QAAQ,CAAC,sBAAsB,CAAS;IAChD,OAAO,CAAC,QAAQ,CAAC,oBAAoB,CAAS;IAC9C,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAU;IACxC,OAAO,CAAC,aAAa,CAA4B;gBAErC,IAAI,EAAE,qBAAqB;IAavC;;;;OAIG;IACH,UAAU,CACR,WAAW,EAAE,kBAAkB,EAC/B,UAAU,EAAE,MAAM,oBAAoB,EAAE,GACvC,IAAI;IAiCP;;;;;OAKG;IACH,SAAS,IAAI,IAAI;IAqBjB;;;OAGG;IACH,SAAS,IAAI,IAAI;IASjB,OAAO,CAAC,aAAa;IAwFrB,OAAO,CAAC,aAAa;IAsBrB,OAAO,CAAC,gBAAgB;CAyBzB"}

package/dist/reverie-trigger.js

@@ -0,0 +1,271 @@
+// @agencer/reverie-loop reverie-trigger module.
+//
+// Leg G-4b: extracted from packages/server/src/brain/reverie-trigger.ts
+// (350 LOC). Session-end orchestrator that fires reverie-loop reflection
+// on last-WebSocket-disconnect or 5-min idle, with dedup, fire-and-forget
+// detachment, and a per-user daily-cost ceiling.
+//
+// Wiring sites preserved (production caller in agencer-ox composition
+// root rewires at G-5, currently routed via the compatibility shim):
+//   - markActive(userContext, getHistory) called per turn from
+//     brain/route-and-log.ts. Resets the cohort idle timer.
+//   - endCohort() called from index.ts's wsContext.onClientDisconnect
+//     when wsContext.clients.size === 0 (last client gone).
+//
+// Cohort model: OX is local-first / single-user (CLAUDE.md §5).
+// Multiple WebSockets may auth simultaneously (web tab + voice client).
+// They share one "cohort" — a conversation lifetime that starts on
+// first markActive after no-cohort state and ends on last-client
+// disconnect or 5-min idle. Each cohort fires reverie at most once.
+//
+// Sub-meter constants (Law 16 Meter Everything): six observable
+// reverie.* component strings. The pre-Leg-G code branded them as
+// UsageComponentType (from @agencer/usage-accountant); the Lego
+// passes them as plain strings to the injected UsageMeter, which
+// preserves runtime semantics bit-for-bit while removing the
+// @agencer/* type coupling.
+//
+// reverie.opus.reflection is the canonical paid-Opus row written by
+// opus-client's executeReflection. The trigger's daily-cost guard
+// reads only this row's totalCostUsd. The other five are zero-cost
+// counters distinguishing why a cohort fired (or didn't).
+//
+// Sacred constraint (Law 8, declared in README): No process.env or
+// os.homedir() reads inside this module. ReverieTriggerOptions takes
+// explicit path config (reveriePairsPath, reverieSafetyFlagsPath,
+// legacyReverieLogPath) which is threaded through to the Lego's
+// ReverieDeps via reverie-loop.ts. The agencer-ox composition root
+// resolves ~/.operative-x/logs/* and passes the paths in.
+//
+// CRITICAL: All public methods NEVER throw. Reverie is observability
+// infrastructure; it cannot block the user-facing teardown path or
+// any per-turn handler.
+import { randomUUID } from "node:crypto";
+import { triggerReverie, } from "./reverie-loop.js";
+// ── Sub-meter component strings ──────────────────────────────────
+const COMP_REVERIE_OPUS_REFLECTION = "reverie.opus.reflection";
+const COMP_REVERIE_TRIGGER_OPUS_ATTEMPT = "reverie.trigger.opus.attempt";
+const COMP_REVERIE_TRIGGER_DISCONNECT = "reverie.trigger.disconnect";
+const COMP_REVERIE_TRIGGER_IDLE_TIMER = "reverie.trigger.idle_timer";
+const COMP_REVERIE_SKIPPED_BUDGET_EXCEEDED = "reverie.skipped.budget_exceeded";
+const COMP_REVERIE_SKIPPED_DEDUPED = "reverie.skipped.deduped";
+const DEFAULT_IDLE_MS = 5 * 60 * 1000;
+const DEFAULT_DAILY_BUDGET_USD = 1.0;
+// No-op stubs used when inferenceProvider is unset. The legacy mock
+// branch of executeReverie never invokes inferenceProvider, meter, or
+// costCalculator — but ReverieDeps requires them present, so we
+// thread these inert placeholders.
+const stubInferenceProvider = {
+    async messagesCreate() {
+        throw new Error("reverie-trigger: stubInferenceProvider invoked; the legacy mock path should never call it");
+    },
+};
+const stubCostCalculator = () => 0;
+export class ReverieTrigger {
+    meter;
+    logger;
+    costCalculator;
+    idleMs;
+    dailyBudgetUsd;
+    inferenceProvider;
+    reveriePairsPath;
+    reverieSafetyFlagsPath;
+    legacyReverieLogPath;
+    forceMockBase;
+    currentCohort = null;
+    constructor(opts) {
+        this.meter = opts.meter;
+        this.logger = opts.logger;
+        this.costCalculator = opts.costCalculator;
+        this.idleMs = opts.idleMs ?? DEFAULT_IDLE_MS;
+        this.dailyBudgetUsd = opts.dailyBudgetUsd ?? DEFAULT_DAILY_BUDGET_USD;
+        this.inferenceProvider = opts.inferenceProvider;
+        this.reveriePairsPath = opts.reveriePairsPath;
+        this.reverieSafetyFlagsPath = opts.reverieSafetyFlagsPath;
+        this.legacyReverieLogPath = opts.legacyReverieLogPath;
+        this.forceMockBase = opts.forceMock ?? false;
+    }
+    /**
+     * Mark the active cohort. Starts a cohort if none exists, refreshes
+     * the userContext + getHistory snapshot if one does, resets the
+     * idle timer either way. Called per turn from brain/route-and-log.ts.
+     */
+    markActive(userContext, getHistory) {
+        try {
+            if (!this.currentCohort) {
+                this.currentCohort = {
+                    id: randomUUID(),
+                    userContext,
+                    getHistory,
+                    idleTimer: null,
+                    reflected: false,
+                };
+            }
+            else {
+                this.currentCohort.userContext = userContext;
+                this.currentCohort.getHistory = getHistory;
+            }
+            if (this.currentCohort.idleTimer) {
+                clearTimeout(this.currentCohort.idleTimer);
+            }
+            // Capture cohort reference so the timer callback acts on this
+            // specific cohort even if currentCohort is replaced before the
+            // timer fires (race-safe).
+            const cohort = this.currentCohort;
+            const t = setTimeout(() => this.fireForCohort(cohort, "idle_timer"), this.idleMs);
+            // unref so the idle timer doesn't keep node alive on its own.
+            t.unref?.();
+            this.currentCohort.idleTimer = t;
+        }
+        catch (err) {
+            this.logger.warn({ err }, "ReverieTrigger.markActive failed");
+        }
+    }
+    /**
+     * Fire reverie for the active cohort and clear it. Called from
+     * index.ts's onClientDisconnect when wsContext.clients.size === 0.
+     * Detached via setImmediate so the WebSocket teardown call stack
+     * returns immediately.
+     */
+    endCohort() {
+        try {
+            const cohort = this.currentCohort;
+            // Visible at info level so future production smoke surfaces
+            // the orchestrator path without needing log-level overrides.
+            // Fires at most once per cohort lifetime — not per turn.
+            this.logger.info({
+                hasCohort: !!cohort,
+                cohortId: cohort?.id ?? null,
+                reflected: cohort?.reflected ?? null,
+            }, "ReverieTrigger.endCohort invoked");
+            if (!cohort)
+                return;
+            setImmediate(() => this.fireForCohort(cohort, "disconnect"));
+        }
+        catch (err) {
+            this.logger.warn({ err }, "ReverieTrigger.endCohort failed");
+        }
+    }
+    /**
+     * Cancel any in-flight idle timer and clear cohort state. For
+     * server shutdown / test teardown. Does NOT fire reverie.
+     */
+    cancelAll() {
+        if (this.currentCohort?.idleTimer) {
+            clearTimeout(this.currentCohort.idleTimer);
+        }
+        this.currentCohort = null;
+    }
+    // ── Internal ───────────────────────────────────────────────────
+    fireForCohort(cohort, reason) {
+        // Always clear the idle timer for this cohort; this fire claims it.
+        if (cohort.idleTimer) {
+            clearTimeout(cohort.idleTimer);
+            cohort.idleTimer = null;
+        }
+        // Dedup: a cohort fires at most once. Subsequent triggers (e.g.,
+        // disconnect arriving after an idle-timer fire, or two disconnect
+        // events racing) record a counter and exit.
+        if (cohort.reflected) {
+            this.recordCounter(cohort.userContext, COMP_REVERIE_SKIPPED_DEDUPED);
+            return;
+        }
+        cohort.reflected = true;
+        // If this cohort is still the current cohort, clear it so a future
+        // markActive starts a fresh cohort. If currentCohort was already
+        // replaced (e.g., user reconnected during the setImmediate window),
+        // leave it alone.
+        if (this.currentCohort === cohort) {
+            this.currentCohort = null;
+        }
+        // Budget guard. dailyReverieCost filters by reverie.opus.reflection
+        // and sums cost. Real-cost rows are written by opus-client's
+        // executeReflection (single source of truth for billing).
+        if (this.dailyReverieCost(cohort.userContext.userId) >= this.dailyBudgetUsd) {
+            this.recordCounter(cohort.userContext, COMP_REVERIE_SKIPPED_BUDGET_EXCEEDED);
+            return;
+        }
+        const triggerComp = reason === "disconnect"
+            ? COMP_REVERIE_TRIGGER_DISCONNECT
+            : COMP_REVERIE_TRIGGER_IDLE_TIMER;
+        this.recordCounter(cohort.userContext, triggerComp);
+        // Trigger-attempt counter. Records "this cohort fired and intended
+        // to invoke reverie reflection" without overlapping the canonical
+        // reverie.opus.reflection sub-meter owned by opus-client. Distinct
+        // sub-meter restores 1:1 totalCalls rollup against actual paid API
+        // calls. Cost is always 0 here; real cost is recorded inside
+        // executeReflection at the SDK boundary.
+        this.recordCounter(cohort.userContext, COMP_REVERIE_TRIGGER_OPUS_ATTEMPT);
+        try {
+            // Snapshot history synchronously at trigger time. reverie-loop's
+            // triggerReverie schedules a 10s debounce that internally calls
+            // `getHistory()` AT FIRE TIME. Without this snapshot, a quick
+            // reconnect during the 10s window means executeReverie reads the
+            // conversation state 10s LATER — potentially the NEXT cohort's
+            // data — while the sessionId stamped on the reverie-log row is
+            // still THIS cohort's UUID. Cohort UUID and reflected content
+            // must move together.
+            const historySnapshot = [...cohort.getHistory()];
+            // Build deps for the Lego's triggerReverie. forceMock is the
+            // OR of construct-time base (composition root threads from
+            // process.env["MOCK_REVERIE"]) and inferenceProvider absence
+            // (test scaffolding without DI).
+            const noProvider = !this.inferenceProvider;
+            const deps = {
+                inferenceProvider: this.inferenceProvider ?? stubInferenceProvider,
+                meter: this.meter,
+                costCalculator: noProvider ? stubCostCalculator : this.costCalculator,
+                userContext: cohort.userContext,
+                logger: this.logger,
+                reveriePairsPath: this.reveriePairsPath,
+                reverieSafetyFlagsPath: this.reverieSafetyFlagsPath,
+                legacyReverieLogPath: this.legacyReverieLogPath,
+                forceMock: this.forceMockBase || noProvider,
+            };
+            triggerReverie(cohort.id, () => historySnapshot, deps);
+        }
+        catch (err) {
+            this.logger.warn({ err, cohortId: cohort.id }, "ReverieTrigger.fireForCohort: getHistory or triggerReverie threw");
+        }
+    }
+    recordCounter(userContext, component) {
+        try {
+            this.meter.recordCall({
+                userId: userContext.userId,
+                sessionId: userContext.sessionId,
+                component,
+                model: "n/a",
+                inputTokens: 0,
+                outputTokens: 0,
+                latencyMs: 0,
+            });
+        }
+        catch (err) {
+            this.logger.warn({ err, component }, "ReverieTrigger.recordCounter failed");
+        }
+    }
+    dailyReverieCost(userId) {
+        try {
+            // SQLite's datetime('now') stores rows as "YYYY-MM-DD HH:MM:SS"
+            // (space separator). We must compare against the same format
+            // so the lexicographic >= filter actually matches today's rows.
+            // `Date.toISOString().slice(0, 10)` gives "YYYY-MM-DD" in UTC,
+            // which is a prefix-safe lower bound: every row from today is
+            // >= "YYYY-MM-DD" because the row's space-after-date sorts
+            // higher than the empty string after the date portion.
+            const fromUtcDate = new Date().toISOString().slice(0, 10);
+            const breakdown = this.meter.getUserUsage(userId, {
+                from: fromUtcDate,
+                groupBy: "component",
+            });
+            return breakdown
+                .filter((b) => b.component === COMP_REVERIE_OPUS_REFLECTION)
+                .reduce((sum, b) => sum + b.totalCostUsd, 0);
+        }
+        catch (err) {
+            this.logger.warn({ err, userId }, "ReverieTrigger.dailyReverieCost failed");
+            return 0;
+        }
+    }
+}
+//# sourceMappingURL=reverie-trigger.js.map

package/dist/reverie-trigger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reverie-trigger.js","sourceRoot":"","sources":["../src/reverie-trigger.ts"],"names":[],"mappings":"AAAA,gDAAgD;AAChD,EAAE;AACF,wEAAwE;AACxE,yEAAyE;AACzE,0EAA0E;AAC1E,iDAAiD;AACjD,EAAE;AACF,sEAAsE;AACtE,qEAAqE;AACrE,+DAA+D;AAC/D,4DAA4D;AAC5D,sEAAsE;AACtE,4DAA4D;AAC5D,EAAE;AACF,gEAAgE;AAChE,wEAAwE;AACxE,mEAAmE;AACnE,iEAAiE;AACjE,oEAAoE;AACpE,EAAE;AACF,gEAAgE;AAChE,kEAAkE;AAClE,gEAAgE;AAChE,iEAAiE;AACjE,6DAA6D;AAC7D,4BAA4B;AAC5B,EAAE;AACF,oEAAoE;AACpE,kEAAkE;AAClE,mEAAmE;AACnE,0DAA0D;AAC1D,EAAE;AACF,mEAAmE;AACnE,qEAAqE;AACrE,kEAAkE;AAClE,gEAAgE;AAChE,mEAAmE;AACnE,0DAA0D;AAC1D,EAAE;AACF,qEAAqE;AACrE,mEAAmE;AACnE,wBAAwB;AAExB,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAQzC,OAAO,EACL,cAAc,GAGf,MAAM,mBAAmB,CAAC;AAE3B,oEAAoE;AAEpE,MAAM,4BAA4B,GAAG,yBAAyB,CAAC;AAC/D,MAAM,iCAAiC,GAAG,8BAA8B,CAAC;AACzE,MAAM,+BAA+B,GAAG,4BAA4B,CAAC;AACrE,MAAM,+BAA+B,GAAG,4BAA4B,CAAC;AACrE,MAAM,oCAAoC,GAAG,iCAAiC,CAAC;AAC/E,MAAM,4BAA4B,GAAG,yBAAyB,CAAC;AAE/D,MAAM,eAAe,GAAG,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC;AACtC,MAAM,wBAAwB,GAAG,GAAG,CAAC;AA0CrC,oEAAoE;AACpE,sEAAsE;AACtE,gEAAgE;AAChE,mCAAmC;AACnC,MAAM,qBAAqB,GAA6B;IACtD,KAAK,CAAC,cAAc;QAClB,MAAM,IAAI,KAAK,CACb,2FAA2F,CAC5F,CAAC;IACJ,CAAC;CACF,CAAC;AACF,MAAM,kBAAkB,GAAmB,GAAG,EAAE,CAAC,CAAC,CAAC;AAEnD,MAAM,OAAO,cAAc;IACR,KAAK,CAAa;IAClB,MAAM,CAAa;IACnB,cAAc,CAAiB;IAC/B,MAAM,CAAS;IACf,cAAc,CAAS;IACvB,iBAAiB,CAAuC;IACxD,gBAAgB,CAAS;IACzB,sBAAsB,CAAS;IAC/B,oBAAoB,CAAS;IAC7B,aAAa,CAAU;IAChC,aAAa,GAAuB,IAAI,CAAC;IAEjD,YAAY,IAA2B;QACrC,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC;QACxB,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;QAC1B,IAAI,CAAC,cAAc,GAAG,IAAI,CAAC,cAAc,CAAC;QAC1C,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,IAAI,eAAe,CAAC;QAC7C,IAAI,CAAC,cAAc,GAAG,IAAI,CAAC,cAAc,IAAI,wBAAwB,CAAC;QACtE,IAAI,CAAC,iBAAiB,GAAG,IAAI,CAAC,iBAAiB,CAAC;QAChD,IAAI,CAAC,gBAAgB,GAAG,IAAI,CAAC,gBAAgB,CAAC;QAC9C,IAAI,CAAC,sBAAsB,GAAG,IAAI,CAAC,sBAAsB,CAAC;QAC1D,IAAI,CAAC,oBAAoB,GAAG,IAAI,CAAC,oBAAoB,CAAC;QACtD,IAAI,CAAC,aAAa,GAAG,IAAI,CAAC,SAAS,IAAI,KAAK,CAAC;IAC/C,CAAC;IAED;;;;OAIG;IACH,UAAU,CACR,WAA+B,EAC/B,UAAwC;QAExC,IAAI,CAAC;YACH,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,CAAC;gBACxB,IAAI,CAAC,aAAa,GAAG;oBACnB,EAAE,EAAE,UAAU,EAAE;oBAChB,WAAW;oBACX,UAAU;oBACV,SAAS,EAAE,IAAI;oBACf,SAAS,EAAE,KAAK;iBACjB,CAAC;YACJ,CAAC;iBAAM,CAAC;gBACN,IAAI,CAAC,aAAa,CAAC,WAAW,GAAG,WAAW,CAAC;gBAC7C,IAAI,CAAC,aAAa,CAAC,UAAU,GAAG,UAAU,CAAC;YAC7C,CAAC;YACD,IAAI,IAAI,CAAC,aAAa,CAAC,SAAS,EAAE,CAAC;gBACjC,YAAY,CAAC,IAAI,CAAC,aAAa,CAAC,SAAS,CAAC,CAAC;YAC7C,CAAC;YACD,8DAA8D;YAC9D,+DAA+D;YAC/D,2BAA2B;YAC3B,MAAM,MAAM,GAAG,IAAI,CAAC,aAAa,CAAC;YAClC,MAAM,CAAC,GAAG,UAAU,CAClB,GAAG,EAAE,CAAC,IAAI,CAAC,aAAa,CAAC,MAAM,EAAE,YAAY,CAAC,EAC9C,IAAI,CAAC,MAAM,CACZ,CAAC;YACF,8DAA8D;YAC9D,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC;YACZ,IAAI,CAAC,aAAa,CAAC,SAAS,GAAG,CAAC,CAAC;QACnC,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,EAAE,kCAAkC,CAAC,CAAC;QAChE,CAAC;IACH,CAAC;IAED;;;;;OAKG;IACH,SAAS;QACP,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,IAAI,CAAC,aAAa,CAAC;YAClC,4DAA4D;YAC5D,6DAA6D;YAC7D,yDAAyD;YACzD,IAAI,CAAC,MAAM,CAAC,IAAI,CACd;gBACE,SAAS,EAAE,CAAC,CAAC,MAAM;gBACnB,QAAQ,EAAE,MAAM,EAAE,EAAE,IAAI,IAAI;gBAC5B,SAAS,EAAE,MAAM,EAAE,SAAS,IAAI,IAAI;aACrC,EACD,kCAAkC,CACnC,CAAC;YACF,IAAI,CAAC,MAAM;gBAAE,OAAO;YACpB,YAAY,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,aAAa,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC,CAAC;QAC/D,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,EAAE,iCAAiC,CAAC,CAAC;QAC/D,CAAC;IACH,CAAC;IAED;;;OAGG;IACH,SAAS;QACP,IAAI,IAAI,CAAC,aAAa,EAAE,SAAS,EAAE,CAAC;YAClC,YAAY,CAAC,IAAI,CAAC,aAAa,CAAC,SAAS,CAAC,CAAC;QAC7C,CAAC;QACD,IAAI,CAAC,aAAa,GAAG,IAAI,CAAC;IAC5B,CAAC;IAED,kEAAkE;IAE1D,aAAa,CACnB,MAAmB,EACnB,MAAmC;QAEnC,oEAAoE;QACpE,IAAI,MAAM,CAAC,SAAS,EAAE,CAAC;YACrB,YAAY,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;YAC/B,MAAM,CAAC,SAAS,GAAG,IAAI,CAAC;QAC1B,CAAC;QAED,iEAAiE;QACjE,kEAAkE;QAClE,4CAA4C;QAC5C,IAAI,MAAM,CAAC,SAAS,EAAE,CAAC;YACrB,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,WAAW,EAAE,4BAA4B,CAAC,CAAC;YACrE,OAAO;QACT,CAAC;QACD,MAAM,CAAC,SAAS,GAAG,IAAI,CAAC;QAExB,mEAAmE;QACnE,iEAAiE;QACjE,oEAAoE;QACpE,kBAAkB;QAClB,IAAI,IAAI,CAAC,aAAa,KAAK,MAAM,EAAE,CAAC;YAClC,IAAI,CAAC,aAAa,GAAG,IAAI,CAAC;QAC5B,CAAC;QAED,oEAAoE;QACpE,6DAA6D;QAC7D,0DAA0D;QAC1D,IAAI,IAAI,CAAC,gBAAgB,CAAC,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,IAAI,IAAI,CAAC,cAAc,EAAE,CAAC;YAC5E,IAAI,CAAC,aAAa,CAChB,MAAM,CAAC,WAAW,EAClB,oCAAoC,CACrC,CAAC;YACF,OAAO;QACT,CAAC;QAED,MAAM,WAAW,GACf,MAAM,KAAK,YAAY;YACrB,CAAC,CAAC,+BAA+B;YACjC,CAAC,CAAC,+BAA+B,CAAC;QACtC,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,WAAW,EAAE,WAAW,CAAC,CAAC;QAEpD,mEAAmE;QACnE,kEAAkE;QAClE,mEAAmE;QACnE,mEAAmE;QACnE,6DAA6D;QAC7D,yCAAyC;QACzC,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,WAAW,EAAE,iCAAiC,CAAC,CAAC;QAE1E,IAAI,CAAC;YACH,iEAAiE;YACjE,gEAAgE;YAChE,8DAA8D;YAC9D,iEAAiE;YACjE,+DAA+D;YAC/D,+DAA+D;YAC/D,8DAA8D;YAC9D,sBAAsB;YACtB,MAAM,eAAe,GAAG,CAAC,GAAG,MAAM,CAAC,UAAU,EAAE,CAAC,CAAC;YAEjD,6DAA6D;YAC7D,2DAA2D;YAC3D,6DAA6D;YAC7D,iCAAiC;YACjC,MAAM,UAAU,GAAG,CAAC,IAAI,CAAC,iBAAiB,CAAC;YAC3C,MAAM,IAAI,GAAgB;gBACxB,iBAAiB,EAAE,IAAI,CAAC,iBAAiB,IAAI,qBAAqB;gBAClE,KAAK,EAAE,IAAI,CAAC,KAAK;gBACjB,cAAc,EAAE,UAAU,CAAC,CAAC,CAAC,kBAAkB,CAAC,CAAC,CAAC,IAAI,CAAC,cAAc;gBACrE,WAAW,EAAE,MAAM,CAAC,WAAW;gBAC/B,MAAM,EAAE,IAAI,CAAC,MAAM;gBACnB,gBAAgB,EAAE,IAAI,CAAC,gBAAgB;gBACvC,sBAAsB,EAAE,IAAI,CAAC,sBAAsB;gBACnD,oBAAoB,EAAE,IAAI,CAAC,oBAAoB;gBAC/C,SAAS,EAAE,IAAI,CAAC,aAAa,IAAI,UAAU;aAC5C,CAAC;YACF,cAAc,CAAC,MAAM,CAAC,EAAE,EAAE,GAAG,EAAE,CAAC,eAAe,EAAE,IAAI,CAAC,CAAC;QACzD,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,IAAI,CAAC,MAAM,CAAC,IAAI,CACd,EAAE,GAAG,EAAE,QAAQ,EAAE,MAAM,CAAC,EAAE,EAAE,EAC5B,kEAAkE,CACnE,CAAC;QACJ,CAAC;IACH,CAAC;IAEO,aAAa,CACnB,WAA+B,EAC/B,SAAiB;QAEjB,IAAI,CAAC;YACH,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC;gBACpB,MAAM,EAAE,WAAW,CAAC,MAAM;gBAC1B,SAAS,EAAE,WAAW,CAAC,SAAS;gBAChC,SAAS;gBACT,KAAK,EAAE,KAAK;gBACZ,WAAW,EAAE,CAAC;gBACd,YAAY,EAAE,CAAC;gBACf,SAAS,EAAE,CAAC;aACb,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,IAAI,CAAC,MAAM,CAAC,IAAI,CACd,EAAE,GAAG,EAAE,SAAS,EAAE,EAClB,qCAAqC,CACtC,CAAC;QACJ,CAAC;IACH,CAAC;IAEO,gBAAgB,CAAC,MAAc;QACrC,IAAI,CAAC;YACH,gEAAgE;YAChE,6DAA6D;YAC7D,gEAAgE;YAChE,+DAA+D;YAC/D,8DAA8D;YAC9D,2DAA2D;YAC3D,uDAAuD;YACvD,MAAM,WAAW,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YAC1D,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,MAAM,EAAE;gBAChD,IAAI,EAAE,WAAW;gBACjB,OAAO,EAAE,WAAW;aACrB,CAAC,CAAC;YACH,OAAO,SAAS;iBACb,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,KAAK,4BAA4B,CAAC;iBAC3D,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,CAAC,YAAY,EAAE,CAAC,CAAC,CAAC;QACjD,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,IAAI,CAAC,MAAM,CAAC,IAAI,CACd,EAAE,GAAG,EAAE,MAAM,EAAE,EACf,wCAAwC,CACzC,CAAC;YACF,OAAO,CAAC,CAAC;QACX,CAAC;IACH,CAAC;CACF"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@agencer/reverie-loop",
-  "version": "0.1.0-alpha.0",
-  "description": "Append-only JSONL writer for reverie training signals (whisper-failure deltas + whisper model outcomes). One of three signal sources for the Agencer Learning Loop (alongside session-logger and whisper-router). Path-configurable, NEVER-throws discipline.",
+  "version": "0.1.0",
+  "description": "Reverie Loop — Strange Loop training-signal capture for AI agents. Post-session Opus reflection produces correction pairs split into behavioral + safety JSONL files for fine-tune corpus generation. Portable Lego with zero @agencer/* runtime dependencies and zero Anthropic-SDK coupling at the public API.",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -14,26 +14,57 @@
   "files": [
     "dist",
     "README.md",
-    "CHANGELOG.md",
-    "LICENSE"
+    "LICENSE",
+    "CHANGELOG.md"
   ],
   "scripts": {
     "build": "tsc",
     "prepack": "tsc",
-    "test": "vitest run --passWithNoTests",
+    "test": "vitest run",
     "typecheck": "tsc --noEmit"
   },
-  "publishConfig": {
-    "registry": "https://registry.npmjs.org"
+  "dependencies": {},
+  "peerDependencies": {
+    "pino": ">=8.0.0",
+    "@agencer/usage-accountant": "0.1.0"
+  },
+  "peerDependenciesMeta": {
+    "@agencer/usage-accountant": {
+      "optional": true
+    }
   },
   "devDependencies": {
-    "@types/node": "^20.0.0",
-    "typescript": "^5.5.0",
-    "vitest": "^1.4.0"
+    "@agencer/usage-accountant": "0.1.0",
+    "@anthropic-ai/sdk": "^0.30.0",
+    "@types/better-sqlite3": "^7.6.0",
+    "@types/node": "^22.0.0",
+    "better-sqlite3": "^12.8.0",
+    "pino": "^9.6.0",
+    "typescript": "^5.7.0",
+    "vitest": "^3.0.0"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org"
   },
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/Agencer-Inc/operative-shared.git"
+    "url": "https://github.com/Agencer-Inc/agencer-ox.git",
+    "directory": "packages/reverie-loop"
   },
-  "license": "Apache-2.0"
+  "homepage": "https://github.com/Agencer-Inc/agencer-ox/tree/main/packages/reverie-loop#readme",
+  "bugs": {
+    "url": "https://github.com/Agencer-Inc/agencer-ox/issues"
+  },
+  "author": "Agencer, Inc.",
+  "keywords": [
+    "reverie-loop",
+    "strange-loop",
+    "training-signal",
+    "self-reflection",
+    "fine-tune-corpus",
+    "correction-pairs",
+    "agencer"
+  ],
+  "license": "SEE LICENSE IN LICENSE"
 }