@seanhogg/builderforce-memory 2026.6.19 → 2026.6.27

package/dist/cognition/EvermindCognition.d.ts

@@ -0,0 +1,61 @@
+/**
+ * Evermind — Write-Through Cognition engine.
+ *
+ * `commit()` is the model-knowledge analogue of a write-through cache write with
+ * a conflict resolver: Canonicalize (stable subject key) → Recall incumbent →
+ * Evaluate evidence → Reconcile (augment | confirm | supersede | reject) →
+ * write-through. `recall()` is the read side, served through a version-token
+ * cache that invalidates for free whenever knowledge changes.
+ *
+ * This is the layer the append-only knowledge loop skipped: it derives a STABLE
+ * subject key (not a per-run id) and replaces-on-write, so beliefs never drift
+ * into a manual reconciliation step.
+ */
+import type { Claim, CognitionFactStore, CommitResult, EvidenceGatherer } from './types.js';
+export interface EvermindCognitionOptions {
+    store: CognitionFactStore;
+    /** Default evidence gatherer used when `commit()` is not given one. */
+    gather?: EvidenceGatherer;
+    /**
+     * Optional embedding-capable runtime (e.g. SSMRuntime) forwarded to the
+     * store's `recallSimilar` so recall sharpens as the model adapts.
+     */
+    runtime?: unknown;
+}
+export declare class EvermindCognition {
+    private readonly _store;
+    private readonly _defaultGather?;
+    private readonly _runtime?;
+    /**
+     * Knowledge-generation token. Bumped on every change to the fact set
+     * (augment / supersede). Doubles as the recall-cache namespace so a write
+     * invalidates cached reads for free — the "invalidate on write" rule applied
+     * to model knowledge.
+     */
+    private _version;
+    /**
+     * L1 recall cache, namespaced by `_version`. After any knowledge change the
+     * version moves, so prior-generation entries are never read again (and are
+     * cleared to bound growth) — not an ad-hoc TTL map; a version-token cache.
+     */
+    private readonly _recallCache;
+    constructor(opts: EvermindCognitionOptions);
+    /** Current knowledge-generation token. */
+    get version(): number;
+    /**
+     * Commit a candidate fact write-through. Evidence decides conflicts; a
+     * supersede replaces the incumbent under the same stable key and invalidates
+     * recall. Never appends a competing belief for the same subject.
+     */
+    commit(claim: Claim, gather?: EvidenceGatherer | undefined): Promise<CommitResult>;
+    /**
+     * Write-through recall: the top-K most relevant facts for `query`, served
+     * from a version-namespaced cache that invalidates on the next knowledge
+     * change. Falls back to an empty set when the store can't rank similarity.
+     */
+    recall(query: string, topK?: number): Promise<string[]>;
+    private _write;
+    private _bumpVersion;
+    private _result;
+}
+//# sourceMappingURL=EvermindCognition.d.ts.map

package/dist/cognition/EvermindCognition.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"EvermindCognition.d.ts","sourceRoot":"","sources":["../../src/cognition/EvermindCognition.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EACR,KAAK,EACL,kBAAkB,EAClB,YAAY,EACZ,gBAAgB,EAGnB,MAAM,YAAY,CAAC;AAEpB,MAAM,WAAW,wBAAwB;IACrC,KAAK,EAAE,kBAAkB,CAAC;IAC1B,uEAAuE;IACvE,MAAM,CAAC,EAAE,gBAAgB,CAAC;IAC1B;;;OAGG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;CACrB;AAWD,qBAAa,iBAAiB;IAC1B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAqB;IAC5C,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAC,CAAmB;IACnD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAU;IAEpC;;;;;OAKG;IACH,OAAO,CAAC,QAAQ,CAAK;IAErB;;;;OAIG;IACH,OAAO,CAAC,QAAQ,CAAC,YAAY,CAA+B;gBAEhD,IAAI,EAAE,wBAAwB;IAM1C,0CAA0C;IAC1C,IAAI,OAAO,IAAI,MAAM,CAEpB;IAED;;;;OAIG;IACG,MAAM,CAAC,KAAK,EAAE,KAAK,EAAE,MAAM,GAAE,gBAAgB,GAAG,SAA+B,GAAG,OAAO,CAAC,YAAY,CAAC;IAsC7G;;;;OAIG;IACG,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,SAAI,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;YAe1C,MAAM;IAIpB,OAAO,CAAC,YAAY;IAKpB,OAAO,CAAC,OAAO;CASlB"}

package/dist/cognition/EvermindCognition.js

@@ -0,0 +1,109 @@
+/**
+ * Evermind — Write-Through Cognition engine.
+ *
+ * `commit()` is the model-knowledge analogue of a write-through cache write with
+ * a conflict resolver: Canonicalize (stable subject key) → Recall incumbent →
+ * Evaluate evidence → Reconcile (augment | confirm | supersede | reject) →
+ * write-through. `recall()` is the read side, served through a version-token
+ * cache that invalidates for free whenever knowledge changes.
+ *
+ * This is the layer the append-only knowledge loop skipped: it derives a STABLE
+ * subject key (not a per-run id) and replaces-on-write, so beliefs never drift
+ * into a manual reconciliation step.
+ */
+function hasRecallSimilar(store) {
+    return typeof store.recallSimilar === 'function';
+}
+export class EvermindCognition {
+    _store;
+    _defaultGather;
+    _runtime;
+    /**
+     * Knowledge-generation token. Bumped on every change to the fact set
+     * (augment / supersede). Doubles as the recall-cache namespace so a write
+     * invalidates cached reads for free — the "invalidate on write" rule applied
+     * to model knowledge.
+     */
+    _version = 0;
+    /**
+     * L1 recall cache, namespaced by `_version`. After any knowledge change the
+     * version moves, so prior-generation entries are never read again (and are
+     * cleared to bound growth) — not an ad-hoc TTL map; a version-token cache.
+     */
+    _recallCache = new Map();
+    constructor(opts) {
+        this._store = opts.store;
+        this._defaultGather = opts.gather;
+        this._runtime = opts.runtime;
+    }
+    /** Current knowledge-generation token. */
+    get version() {
+        return this._version;
+    }
+    /**
+     * Commit a candidate fact write-through. Evidence decides conflicts; a
+     * supersede replaces the incumbent under the same stable key and invalidates
+     * recall. Never appends a competing belief for the same subject.
+     */
+    async commit(claim, gather = this._defaultGather) {
+        const incumbent = await this._store.recall(claim.subjectKey);
+        const audit = [];
+        // ── Brand-new subject ────────────────────────────────────────────────
+        if (!incumbent) {
+            if (gather && claim.requireEvidence) {
+                const e = await gather({ claim });
+                audit.push(...e.notes);
+                if (!e.supportsNew) {
+                    return this._result('reject', claim.subjectKey, claim.content, undefined, audit);
+                }
+            }
+            await this._write(claim, claim.importance ?? 0.6);
+            this._bumpVersion();
+            return this._result('augment', claim.subjectKey, claim.content, undefined, audit);
+        }
+        // ── Identical incumbent — confirm (refresh confidence, no replace) ────
+        if (incumbent.content === claim.content) {
+            await this._write(claim, Math.min(1, (claim.importance ?? 0.6) + 0.1));
+            return this._result('confirm', claim.subjectKey, claim.content, undefined, audit);
+        }
+        // ── Conflict — evidence decides ──────────────────────────────────────
+        const e = gather
+            ? await gather({ claim, incumbent: incumbent.content })
+            : { supportsNew: true, notes: ['no evidence gatherer supplied; trusting newer observation'] };
+        audit.push(...e.notes);
+        if (e.supportsNew) {
+            await this._write(claim, Math.max(claim.importance ?? 0.6, 0.9));
+            this._bumpVersion();
+            return this._result('supersede', claim.subjectKey, claim.content, incumbent.content, audit);
+        }
+        return this._result('reject', claim.subjectKey, incumbent.content, undefined, audit);
+    }
+    /**
+     * Write-through recall: the top-K most relevant facts for `query`, served
+     * from a version-namespaced cache that invalidates on the next knowledge
+     * change. Falls back to an empty set when the store can't rank similarity.
+     */
+    async recall(query, topK = 5) {
+        const cacheKey = `${this._version}:${topK}:${query}`;
+        const cached = this._recallCache.get(cacheKey);
+        if (cached)
+            return cached;
+        const facts = hasRecallSimilar(this._store)
+            ? (await this._store.recallSimilar(query, topK, this._runtime)).map((e) => e.content)
+            : [];
+        this._recallCache.set(cacheKey, facts);
+        return facts;
+    }
+    // ── internals ────────────────────────────────────────────────────────────
+    async _write(claim, importance) {
+        await this._store.remember(claim.subjectKey, claim.content, { tags: claim.tags, importance });
+    }
+    _bumpVersion() {
+        this._version++;
+        this._recallCache.clear();
+    }
+    _result(verdict, subjectKey, content, superseded, evidence) {
+        return { verdict, subjectKey, content, superseded, evidence, version: this._version };
+    }
+}
+//# sourceMappingURL=EvermindCognition.js.map

package/dist/cognition/EvermindCognition.js.map

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

package/dist/cognition/gatherers.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Evermind — reusable evidence gatherers.
+ *
+ * Concrete, surface-agnostic evidence rules. The presence rule is the one the
+ * IDE self-correction loop uses (ground a claim by listing the workspace), kept
+ * here so the IDE, the proof harness, and tests share one implementation.
+ */
+import type { EvidenceGatherer } from './types.js';
+export interface WorkspacePresenceRule {
+    /** Lists the workspace (e.g. the IDE `list_files('.')` control tool). */
+    list: () => Promise<string[]>;
+    /** Entries that MUST be present for the new claim to hold. */
+    mustExist?: string[];
+    /** Entries that MUST be absent for the new claim to hold. */
+    mustBeAbsent?: string[];
+}
+/**
+ * Evidence rule: the new claim is supported iff every `mustExist` entry is
+ * present and every `mustBeAbsent` entry is gone from the listing.
+ */
+export declare function workspacePresenceGatherer(rule: WorkspacePresenceRule): EvidenceGatherer;
+//# sourceMappingURL=gatherers.d.ts.map

package/dist/cognition/gatherers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gatherers.d.ts","sourceRoot":"","sources":["../../src/cognition/gatherers.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAEnD,MAAM,WAAW,qBAAqB;IAClC,yEAAyE;IACzE,IAAI,EAAE,MAAM,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IAC9B,8DAA8D;IAC9D,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,6DAA6D;IAC7D,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;CAC3B;AAED;;;GAGG;AACH,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,qBAAqB,GAAG,gBAAgB,CAgBvF"}

package/dist/cognition/gatherers.js

@@ -0,0 +1,29 @@
+/**
+ * Evermind — reusable evidence gatherers.
+ *
+ * Concrete, surface-agnostic evidence rules. The presence rule is the one the
+ * IDE self-correction loop uses (ground a claim by listing the workspace), kept
+ * here so the IDE, the proof harness, and tests share one implementation.
+ */
+/**
+ * Evidence rule: the new claim is supported iff every `mustExist` entry is
+ * present and every `mustBeAbsent` entry is gone from the listing.
+ */
+export function workspacePresenceGatherer(rule) {
+    const mustExist = rule.mustExist ?? [];
+    const mustBeAbsent = rule.mustBeAbsent ?? [];
+    return async () => {
+        const listing = await rule.list();
+        const present = mustExist.filter((d) => listing.includes(d));
+        const absent = mustBeAbsent.filter((d) => !listing.includes(d));
+        const supportsNew = present.length === mustExist.length && absent.length === mustBeAbsent.length;
+        return {
+            supportsNew,
+            notes: [
+                `present: ${present.join(', ') || '—'}`,
+                `absent (as expected): ${absent.join(', ') || '—'}`,
+            ],
+        };
+    };
+}
+//# sourceMappingURL=gatherers.js.map

package/dist/cognition/gatherers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gatherers.js","sourceRoot":"","sources":["../../src/cognition/gatherers.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAaH;;;GAGG;AACH,MAAM,UAAU,yBAAyB,CAAC,IAA2B;IACjE,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,IAAI,EAAE,CAAC;IACvC,MAAM,YAAY,GAAG,IAAI,CAAC,YAAY,IAAI,EAAE,CAAC;IAC7C,OAAO,KAAK,IAAI,EAAE;QACd,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,IAAI,EAAE,CAAC;QAClC,MAAM,OAAO,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;QAC7D,MAAM,MAAM,GAAG,YAAY,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;QAChE,MAAM,WAAW,GAAG,OAAO,CAAC,MAAM,KAAK,SAAS,CAAC,MAAM,IAAI,MAAM,CAAC,MAAM,KAAK,YAAY,CAAC,MAAM,CAAC;QACjG,OAAO;YACH,WAAW;YACX,KAAK,EAAE;gBACH,YAAY,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,GAAG,EAAE;gBACvC,yBAAyB,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,GAAG,EAAE;aACtD;SACJ,CAAC;IACN,CAAC,CAAC;AACN,CAAC"}

package/dist/cognition/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Evermind — Write-Through Cognition.
+ *
+ * The layer that keeps model knowledge current without a reconciliation step:
+ * stable-subject-key beliefs, evidence-gated conflict resolution, replace-on-write.
+ */
+export { EvermindCognition } from './EvermindCognition.js';
+export type { EvermindCognitionOptions } from './EvermindCognition.js';
+export { workspacePresenceGatherer } from './gatherers.js';
+export type { WorkspacePresenceRule } from './gatherers.js';
+export type { Claim, CognitionFactStore, CommitResult, EvidenceContext, EvidenceGatherer, EvidenceResult, Verdict, } from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/cognition/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cognition/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,YAAY,EAAE,wBAAwB,EAAE,MAAM,wBAAwB,CAAC;AACvE,OAAO,EAAE,yBAAyB,EAAE,MAAM,gBAAgB,CAAC;AAC3D,YAAY,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AAC5D,YAAY,EACR,KAAK,EACL,kBAAkB,EAClB,YAAY,EACZ,eAAe,EACf,gBAAgB,EAChB,cAAc,EACd,OAAO,GACV,MAAM,YAAY,CAAC"}

package/dist/cognition/index.js

@@ -0,0 +1,9 @@
+/**
+ * Evermind — Write-Through Cognition.
+ *
+ * The layer that keeps model knowledge current without a reconciliation step:
+ * stable-subject-key beliefs, evidence-gated conflict resolution, replace-on-write.
+ */
+export { EvermindCognition } from './EvermindCognition.js';
+export { workspacePresenceGatherer } from './gatherers.js';
+//# sourceMappingURL=index.js.map

package/dist/cognition/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/cognition/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAE3D,OAAO,EAAE,yBAAyB,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/cognition/types.d.ts

@@ -0,0 +1,84 @@
+/**
+ * Evermind — Write-Through Cognition types.
+ *
+ * The cognition layer is what lets the model's KNOWLEDGE stay current without a
+ * reconciliation step: every incoming fact is evaluated against EVIDENCE and the
+ * incumbent belief, then committed write-through (replace-on-write by a STABLE
+ * subject key) instead of being appended under a fresh per-run key. These types
+ * are intentionally store- and surface-agnostic so the same logic runs in the
+ * IDE, on-prem, cloud, and the browser.
+ */
+/** Outcome of evaluating a candidate fact against its incumbent + evidence. */
+export type Verdict = 
+/** No incumbent on this subject — stored as a new belief. */
+'augment'
+/** Incumbent identical — recency/confidence refreshed, nothing replaced. */
+ | 'confirm'
+/** Incumbent conflicted and evidence favoured the new fact — replaced. */
+ | 'supersede'
+/** Incumbent conflicted but evidence did NOT favour the new fact — dropped. */
+ | 'reject';
+/**
+ * Minimal write-through fact store the cognition layer needs. `MemoryStore`
+ * satisfies this structurally (no adapter required) — kept narrow so cloud
+ * (Postgres) / browser (IndexedDB) backends can satisfy it too.
+ */
+export interface CognitionFactStore {
+    remember(key: string, content: string, opts?: {
+        tags?: string[];
+        importance?: number;
+        ttlMs?: number;
+    }): Promise<void>;
+    recall(key: string): Promise<{
+        content: string;
+    } | undefined>;
+    forget(key: string): Promise<void>;
+}
+/** A fact asserted about a subject, keyed by a STABLE canonical key. */
+export interface Claim {
+    /**
+     * STABLE canonical key naming the SUBJECT of the fact (e.g. `pkg:ssm-stack`).
+     * This is the anti-drift fix: logically-superseding facts collide on this key
+     * and replace, instead of accumulating under per-run keys.
+     */
+    subjectKey: string;
+    /** The asserted fact content. */
+    content: string;
+    tags?: string[];
+    importance?: number;
+    /**
+     * When true, a brand-new subject is only stored if the gatherer's evidence
+     * supports it (guards against recording unverified first-observations).
+     */
+    requireEvidence?: boolean;
+}
+/** The verdict of an evidence probe: does ground truth favour the new claim? */
+export interface EvidenceResult {
+    supportsNew: boolean;
+    /** Audit-readable lines describing what was checked and found. */
+    notes: string[];
+}
+export interface EvidenceContext {
+    claim: Claim;
+    /** Incumbent belief content for this subject, when one exists. */
+    incumbent?: string;
+}
+/**
+ * Gathers ground-truth evidence for a claim. Injected by the caller because the
+ * evidence source is surface-specific (IDE file tools, cloud DB, HTTP probe…).
+ */
+export type EvidenceGatherer = (ctx: EvidenceContext) => Promise<EvidenceResult>;
+/** Result of committing a claim through the cognition pipeline. */
+export interface CommitResult {
+    verdict: Verdict;
+    subjectKey: string;
+    /** The belief now held for this subject (incumbent's content on reject). */
+    content: string;
+    /** Prior content, present only when `verdict === 'supersede'`. */
+    superseded?: string;
+    /** Evidence audit trail. */
+    evidence: string[];
+    /** Knowledge-generation token after this commit (bumps on augment/supersede). */
+    version: number;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/cognition/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/cognition/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,+EAA+E;AAC/E,MAAM,MAAM,OAAO;AACf,6DAA6D;AAC3D,SAAS;AACX,4EAA4E;GAC1E,SAAS;AACX,0EAA0E;GACxE,WAAW;AACb,+EAA+E;GAC7E,QAAQ,CAAC;AAEf;;;;GAIG;AACH,MAAM,WAAW,kBAAkB;IAC/B,QAAQ,CACJ,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,MAAM,EACf,IAAI,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,GAChE,OAAO,CAAC,IAAI,CAAC,CAAC;IACjB,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE,GAAG,SAAS,CAAC,CAAC;IAC9D,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACtC;AAED,wEAAwE;AACxE,MAAM,WAAW,KAAK;IAClB;;;;OAIG;IACH,UAAU,EAAE,MAAM,CAAC;IACnB,iCAAiC;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;;OAGG;IACH,eAAe,CAAC,EAAE,OAAO,CAAC;CAC7B;AAED,gFAAgF;AAChF,MAAM,WAAW,cAAc;IAC3B,WAAW,EAAE,OAAO,CAAC;IACrB,kEAAkE;IAClE,KAAK,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,MAAM,WAAW,eAAe;IAC5B,KAAK,EAAE,KAAK,CAAC;IACb,kEAAkE;IAClE,SAAS,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;;GAGG;AACH,MAAM,MAAM,gBAAgB,GAAG,CAAC,GAAG,EAAE,eAAe,KAAK,OAAO,CAAC,cAAc,CAAC,CAAC;AAEjF,mEAAmE;AACnE,MAAM,WAAW,YAAY;IACzB,OAAO,EAAE,OAAO,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,4EAA4E;IAC5E,OAAO,EAAE,MAAM,CAAC;IAChB,kEAAkE;IAClE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,4BAA4B;IAC5B,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,iFAAiF;IACjF,OAAO,EAAE,MAAM,CAAC;CACnB"}

package/dist/cognition/types.js

@@ -0,0 +1,12 @@
+/**
+ * Evermind — Write-Through Cognition types.
+ *
+ * The cognition layer is what lets the model's KNOWLEDGE stay current without a
+ * reconciliation step: every incoming fact is evaluated against EVIDENCE and the
+ * incumbent belief, then committed write-through (replace-on-write by a STABLE
+ * subject key) instead of being appended under a fresh per-run key. These types
+ * are intentionally store- and surface-agnostic so the same logic runs in the
+ * IDE, on-prem, cloud, and the browser.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/cognition/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/cognition/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG"}

package/dist/index.d.ts

@@ -22,6 +22,10 @@ export { MODEL_PRESETS, resolveLayerSchedule, resolveModelConfig } from './sessi
 export type { SessionErrorCode } from './session/index.js';
 export type { LayerSchedulePreset } from './session/index.js';
 export type { MambaSessionOptions, CompleteOptions, AdaptOptions, AdaptResult, SaveOptions, LoadOptions, StorageTarget, CreateProgressEvent, CreateStage, CreateCallbacks, SessionInternals, GpuMode, Tokenizer, } from './session/index.js';
+export { LimbicSession } from './limbic/LimbicSession.js';
+export type { LimbicSessionOptions, LimbicGpuMode } from './limbic/LimbicSession.js';
+export { LimbicModel, LimbicTrainer, LIMBIC_DIM, LIMBIC_DIM_NAMES, LIMBIC_STATE_DIM, LIMBIC_BOUNDS, NEUTRAL_STATE, REGION, clampState, neutralState, stateToRecord, recordToState, } from '@seanhogg/builderforce-memory-engine';
+export type { LimbicModelConfig, LimbicForward, LimbicSample, LimbicTrainOptions, LimbicDimName, Region, } from '@seanhogg/builderforce-memory-engine';
 export { SSMRuntime } from './runtime/SSMRuntime.js';
 export type { SSMRuntimeOptions, GenerateOptions } from './runtime/SSMRuntime.js';
 export type { TransformerBridge, BridgeGenerateOptions } from './bridges/TransformerBridge.js';
@@ -45,6 +49,8 @@ export { InferenceRouter } from './router/InferenceRouter.js';
 export type { RoutingStrategy, RoutingDecision, RouterContext, InferenceRouterOptions, RoutingAuditEntry, } from './router/InferenceRouter.js';
 export { MemoryStore } from './memory/MemoryStore.js';
 export type { MemoryEntry, MemoryStoreOptions, RememberOptions, FactType, } from './memory/MemoryStore.js';
+export { EvermindCognition, workspacePresenceGatherer } from './cognition/index.js';
+export type { EvermindCognitionOptions, WorkspacePresenceRule, Claim, CognitionFactStore, CommitResult, EvidenceContext, EvidenceGatherer, EvidenceResult, Verdict, } from './cognition/index.js';
 export { DistillationEngine } from './distillation/DistillationEngine.js';
 export type { DistillOptions, DistillResult, DistillBatchResult, DistillationLog, QualityGate, } from './distillation/DistillationEngine.js';
 export { SSMAgent } from './agent/SSMAgent.js';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAGH,OAAO,EAAE,YAAY,EAAE,MAAmB,oBAAoB,CAAC;AAC/D,OAAO,EAAE,YAAY,EAAE,MAAmB,oBAAoB,CAAC;AAC/D,OAAO,EAAE,aAAa,EAAE,oBAAoB,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAE7F,YAAY,EAAE,gBAAgB,EAAE,MAAU,oBAAoB,CAAC;AAC/D,YAAY,EAAE,mBAAmB,EAAE,MAAO,oBAAoB,CAAC;AAC/D,YAAY,EACR,mBAAmB,EACnB,eAAe,EACf,YAAY,EACZ,WAAW,EACX,WAAW,EACX,WAAW,EACX,aAAa,EACb,mBAAmB,EACnB,WAAW,EACX,eAAe,EACf,gBAAgB,EAChB,OAAO,EACP,SAAS,GACZ,MAAM,oBAAoB,CAAC;AAG5B,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAC1D,YAAY,EAAE,oBAAoB,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAGrF,OAAO,EACH,WAAW,EACX,aAAa,EACb,UAAU,EACV,gBAAgB,EAChB,gBAAgB,EAChB,aAAa,EACb,aAAa,EACb,MAAM,EACN,UAAU,EACV,YAAY,EACZ,aAAa,EACb,aAAa,GAChB,MAAM,sCAAsC,CAAC;AAC9C,YAAY,EACR,iBAAiB,EACjB,aAAa,EACb,YAAY,EACZ,kBAAkB,EAClB,aAAa,EACb,MAAM,GACT,MAAM,sCAAsC,CAAC;AAG9C,OAAO,EAAE,UAAU,EAAE,MAAS,yBAAyB,CAAC;AACxD,YAAY,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAGlF,YAAY,EAAE,iBAAiB,EAAE,qBAAqB,EAAE,MAAM,gCAAgC,CAAC;AAC/F,OAAO,EAAE,YAAY,EAAE,MAAS,2BAA2B,CAAC;AAC5D,OAAO,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAC/D,OAAO,EAAE,WAAW,EAAE,MAAU,0BAA0B,CAAC;AAC3D,OAAO,EAAE,aAAa,EAAE,MAAQ,4BAA4B,CAAC;AAC7D,OAAO,EAAE,qBAAqB,EAAE,MAAM,oCAAoC,CAAC;AAC3E,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAC1E,YAAY,EAAE,mBAAmB,EAAE,MAAS,2BAA2B,CAAC;AACxE,YAAY,EAAE,sBAAsB,EAAE,MAAM,8BAA8B,CAAC;AAC3E,YAAY,EAAE,kBAAkB,EAAE,MAAU,0BAA0B,CAAC;AACvE,YAAY,EAAE,oBAAoB,EAAE,MAAQ,4BAA4B,CAAC;AACzE,YAAY,EAAE,4BAA4B,EAAE,MAAM,oCAAoC,CAAC;AACvF,YAAY,EAAE,oBAAoB,EAAE,MAAQ,4BAA4B,CAAC;AAGzE,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AACzD,OAAO,EAAE,yBAAyB,EAAE,MAAM,sCAAsC,CAAC;AACjF,YAAY,EACR,QAAQ,EACR,oBAAoB,EACpB,gBAAgB,EAChB,oBAAoB,EACpB,gCAAgC,GACnC,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAGtF,OAAO,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAC9D,YAAY,EACR,eAAe,EACf,eAAe,EACf,aAAa,EACb,sBAAsB,EACtB,iBAAiB,GACpB,MAAM,6BAA6B,CAAC;AAGrC,OAAO,EAAE,WAAW,EAAE,MAAO,yBAAyB,CAAC;AACvD,YAAY,EACR,WAAW,EACX,kBAAkB,EAClB,eAAe,EACf,QAAQ,GACX,MAAM,yBAAyB,CAAC;AAGjC,OAAO,EAAE,iBAAiB,EAAE,yBAAyB,EAAE,MAAM,sBAAsB,CAAC;AACpF,YAAY,EACR,wBAAwB,EACxB,qBAAqB,EACrB,KAAK,EACL,kBAAkB,EAClB,YAAY,EACZ,eAAe,EACf,gBAAgB,EAChB,cAAc,EACd,OAAO,GACV,MAAM,sBAAsB,CAAC;AAG9B,OAAO,EAAE,kBAAkB,EAAE,MAAM,sCAAsC,CAAC;AAC1E,YAAY,EACR,cAAc,EACd,aAAa,EACb,kBAAkB,EAClB,eAAe,EACf,WAAW,GACd,MAAM,sCAAsC,CAAC;AAG9C,OAAO,EAAE,QAAQ,EAAE,MAAO,qBAAqB,CAAC;AAChD,YAAY,EAAE,eAAe,EAAE,YAAY,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAGpG,OAAO,EAAE,QAAQ,EAAE,MAAO,sBAAsB,CAAC;AACjD,YAAY,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAMzD,OAAO,EAAE,UAAU,EAAE,MAAe,yBAAyB,CAAC;AAC9D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAEjE,eAAO,MAAM,GAAG;IACZ;;;;;OAKG;4BACY,iBAAiB;CAC1B,CAAC"}

package/dist/index.js

@@ -20,6 +20,11 @@
 export { MambaSession } from './session/index.js';
 export { SessionError } from './session/index.js';
 export { MODEL_PRESETS, resolveLayerSchedule, resolveModelConfig } from './session/index.js';
+// ── Limbic system (trainable affective dynamics) ──────────────────────────────
+export { LimbicSession } from './limbic/LimbicSession.js';
+// Re-export the limbic engine primitives so consumers can use the model/trainer
+// and the region schema directly from @seanhogg/builderforce-memory.
+export { LimbicModel, LimbicTrainer, LIMBIC_DIM, LIMBIC_DIM_NAMES, LIMBIC_STATE_DIM, LIMBIC_BOUNDS, NEUTRAL_STATE, REGION, clampState, neutralState, stateToRecord, recordToState, } from '@seanhogg/builderforce-memory-engine';
 // ── Runtime ───────────────────────────────────────────────────────────────────
 export { SSMRuntime } from './runtime/SSMRuntime.js';
 export { OpenAIBridge } from './bridges/OpenAIBridge.js';
@@ -37,6 +42,8 @@ export { cosineSimilarity, jaccardSimilarity, tokenize } from './similarity/inde
 export { InferenceRouter } from './router/InferenceRouter.js';
 // ── Memory ────────────────────────────────────────────────────────────────────
 export { MemoryStore } from './memory/MemoryStore.js';
+// ── Cognition (Evermind — Write-Through Cognition) ────────────────────────────
+export { EvermindCognition, workspacePresenceGatherer } from './cognition/index.js';
 // ── Distillation ──────────────────────────────────────────────────────────────
 export { DistillationEngine } from './distillation/DistillationEngine.js';
 // ── Agent ─────────────────────────────────────────────────────────────────────

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,iFAAiF;AACjF,OAAO,EAAE,YAAY,EAAE,MAAmB,oBAAoB,CAAC;AAC/D,OAAO,EAAE,YAAY,EAAE,MAAmB,oBAAoB,CAAC;AAC/D,OAAO,EAAE,aAAa,EAAE,oBAAoB,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAoB7F,iFAAiF;AACjF,OAAO,EAAE,UAAU,EAAE,MAAS,yBAAyB,CAAC;AAKxD,OAAO,EAAE,YAAY,EAAE,MAAS,2BAA2B,CAAC;AAC5D,OAAO,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAC/D,OAAO,EAAE,WAAW,EAAE,MAAU,0BAA0B,CAAC;AAC3D,OAAO,EAAE,aAAa,EAAE,MAAQ,4BAA4B,CAAC;AAC7D,OAAO,EAAE,qBAAqB,EAAE,MAAM,oCAAoC,CAAC;AAC3E,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAQ1E,kFAAkF;AAClF,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AACzD,OAAO,EAAE,yBAAyB,EAAE,MAAM,sCAAsC,CAAC;AASjF,kFAAkF;AAClF,OAAO,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAEtF,iFAAiF;AACjF,OAAO,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAS9D,iFAAiF;AACjF,OAAO,EAAE,WAAW,EAAE,MAAO,yBAAyB,CAAC;AAQvD,iFAAiF;AACjF,OAAO,EAAE,kBAAkB,EAAE,MAAM,sCAAsC,CAAC;AAS1E,iFAAiF;AACjF,OAAO,EAAE,QAAQ,EAAE,MAAO,qBAAqB,CAAC;AAGhD,iFAAiF;AACjF,OAAO,EAAE,QAAQ,EAAE,MAAO,sBAAsB,CAAC;AAGjD,iFAAiF;AACjF,mDAAmD;AACnD,qEAAqE;AAErE,OAAO,EAAE,UAAU,EAAE,MAAe,yBAAyB,CAAC;AAG9D,MAAM,CAAC,MAAM,GAAG,GAAG;IACf;;;;;OAKG;IACH,MAAM,EAAE,CAAC,IAAuB,EAAE,EAAE,CAAC,UAAU,CAAC,MAAM,CAAC,IAAI,CAAC;CACtD,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,iFAAiF;AACjF,OAAO,EAAE,YAAY,EAAE,MAAmB,oBAAoB,CAAC;AAC/D,OAAO,EAAE,YAAY,EAAE,MAAmB,oBAAoB,CAAC;AAC/D,OAAO,EAAE,aAAa,EAAE,oBAAoB,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAoB7F,iFAAiF;AACjF,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAE1D,gFAAgF;AAChF,qEAAqE;AACrE,OAAO,EACH,WAAW,EACX,aAAa,EACb,UAAU,EACV,gBAAgB,EAChB,gBAAgB,EAChB,aAAa,EACb,aAAa,EACb,MAAM,EACN,UAAU,EACV,YAAY,EACZ,aAAa,EACb,aAAa,GAChB,MAAM,sCAAsC,CAAC;AAU9C,iFAAiF;AACjF,OAAO,EAAE,UAAU,EAAE,MAAS,yBAAyB,CAAC;AAKxD,OAAO,EAAE,YAAY,EAAE,MAAS,2BAA2B,CAAC;AAC5D,OAAO,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAC/D,OAAO,EAAE,WAAW,EAAE,MAAU,0BAA0B,CAAC;AAC3D,OAAO,EAAE,aAAa,EAAE,MAAQ,4BAA4B,CAAC;AAC7D,OAAO,EAAE,qBAAqB,EAAE,MAAM,oCAAoC,CAAC;AAC3E,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAQ1E,kFAAkF;AAClF,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AACzD,OAAO,EAAE,yBAAyB,EAAE,MAAM,sCAAsC,CAAC;AASjF,kFAAkF;AAClF,OAAO,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAEtF,iFAAiF;AACjF,OAAO,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAS9D,iFAAiF;AACjF,OAAO,EAAE,WAAW,EAAE,MAAO,yBAAyB,CAAC;AAQvD,iFAAiF;AACjF,OAAO,EAAE,iBAAiB,EAAE,yBAAyB,EAAE,MAAM,sBAAsB,CAAC;AAapF,iFAAiF;AACjF,OAAO,EAAE,kBAAkB,EAAE,MAAM,sCAAsC,CAAC;AAS1E,iFAAiF;AACjF,OAAO,EAAE,QAAQ,EAAE,MAAO,qBAAqB,CAAC;AAGhD,iFAAiF;AACjF,OAAO,EAAE,QAAQ,EAAE,MAAO,sBAAsB,CAAC;AAGjD,iFAAiF;AACjF,mDAAmD;AACnD,qEAAqE;AAErE,OAAO,EAAE,UAAU,EAAE,MAAe,yBAAyB,CAAC;AAG9D,MAAM,CAAC,MAAM,GAAG,GAAG;IACf;;;;;OAKG;IACH,MAAM,EAAE,CAAC,IAAuB,EAAE,EAAE,CAAC,UAAU,CAAC,MAAM,CAAC,IAAI,CAAC;CACtD,CAAC"}

package/dist/limbic/LimbicSession.d.ts

@@ -0,0 +1,63 @@
+/**
+ * LimbicSession.ts – high-level facade over the limbic affect model.
+ *
+ * Mirrors {@link MambaSession}: collapses GPU acquisition, model construction,
+ * checkpoint load, and the trainer into a single `LimbicSession.create()` call,
+ * with the same WebGPU-or-CPU-fallback contract. The agent runtime consumes
+ * this through `@seanhogg/builderforce-memory` to run the limbic system on a
+ * self-hosted node (GPU via @webgpu/node when present, CPU otherwise).
+ *
+ *   const limbic = await LimbicSession.create({ gpuAdapter, checkpointBuffer });
+ *   const { delta, reward } = await limbic.step(experienceEmbedding, state);
+ *   await limbic.train(samples, { epochs: 30 });
+ *   const bin = limbic.exportWeights({ fp16: true });
+ */
+import { LimbicModel, LimbicTrainer, type LimbicModelConfig, type LimbicForward, type LimbicSample, type LimbicTrainOptions } from "@seanhogg/builderforce-memory-engine";
+export type LimbicGpuMode = "webgpu" | "cpu-fallback" | "cpu";
+export interface LimbicSessionOptions {
+    /** Pre-created GPUAdapter (e.g. from @webgpu/node). When set, navigator.gpu is not used. */
+    gpuAdapter?: GPUAdapter;
+    /** Attempt a software (CPU) WebGPU adapter when no GPU is available. Default false. */
+    allowCpuFallback?: boolean;
+    /** Pre-read checkpoint bytes (Node: read the .bin with fs and pass the ArrayBuffer). */
+    checkpointBuffer?: ArrayBuffer;
+    /** IndexedDB key for save()/load(). Default 'limbic-default'. */
+    name?: string;
+    /** Injected IDBFactory (e.g. fake-indexeddb in Node). */
+    idbFactory?: IDBFactory;
+    /** Model configuration overrides. */
+    modelConfig?: Partial<LimbicModelConfig>;
+    /** Deterministic init seed. */
+    seed?: number;
+}
+export declare class LimbicSession {
+    readonly model: LimbicModel;
+    readonly trainer: LimbicTrainer;
+    readonly device: GPUDevice | null;
+    readonly gpuMode: LimbicGpuMode;
+    private readonly _name;
+    private readonly _idbFactory;
+    private _pipeline;
+    private _dimsBuf;
+    private _paramBufs;
+    private _paramsDirty;
+    private constructor();
+    static create(options?: LimbicSessionOptions): Promise<LimbicSession>;
+    /** One affect step. Uses the GPU kernel when a device is available, else CPU. */
+    step(input: ArrayLike<number>, state: ArrayLike<number>, hidden?: ArrayLike<number>): Promise<LimbicForward>;
+    private _ensureGpuStep;
+    private _stepGpu;
+    /** Train the affect model on observed experiences. Marks GPU step buffers dirty. */
+    train(samples: LimbicSample[], opts?: LimbicTrainOptions): Promise<number[]>;
+    evaluate(samples: LimbicSample[]): number;
+    exportWeights(opts?: {
+        fp16?: boolean;
+    }): ArrayBuffer;
+    /** Persist weights to IndexedDB under the session name. */
+    save(): Promise<void>;
+    /** Load weights from IndexedDB; returns true if a checkpoint was found. */
+    load(): Promise<boolean>;
+    private _destroyParamBufs;
+    destroy(): void;
+}
+//# sourceMappingURL=LimbicSession.d.ts.map

package/dist/limbic/LimbicSession.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"LimbicSession.d.ts","sourceRoot":"","sources":["../../src/limbic/LimbicSession.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EACL,WAAW,EACX,aAAa,EASb,KAAK,iBAAiB,EACtB,KAAK,aAAa,EAClB,KAAK,YAAY,EACjB,KAAK,kBAAkB,EACxB,MAAM,sCAAsC,CAAC;AAI9C,MAAM,MAAM,aAAa,GAAG,QAAQ,GAAG,cAAc,GAAG,KAAK,CAAC;AAE9D,MAAM,WAAW,oBAAoB;IACnC,4FAA4F;IAC5F,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,uFAAuF;IACvF,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,wFAAwF;IACxF,gBAAgB,CAAC,EAAE,WAAW,CAAC;IAC/B,iEAAiE;IACjE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,yDAAyD;IACzD,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,qCAAqC;IACrC,WAAW,CAAC,EAAE,OAAO,CAAC,iBAAiB,CAAC,CAAC;IACzC,+BAA+B;IAC/B,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAUD,qBAAa,aAAa;IACxB,QAAQ,CAAC,KAAK,EAAE,WAAW,CAAC;IAC5B,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAC;IAChC,QAAQ,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAAC;IAClC,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAC;IAChC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAC/B,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAyB;IAGrD,OAAO,CAAC,SAAS,CAAmC;IACpD,OAAO,CAAC,QAAQ,CAA0B;IAC1C,OAAO,CAAC,UAAU,CAA4B;IAC9C,OAAO,CAAC,YAAY,CAAQ;IAE5B,OAAO;WAgBM,MAAM,CAAC,OAAO,GAAE,oBAAyB,GAAG,OAAO,CAAC,aAAa,CAAC;IA2C/E,iFAAiF;IAC3E,IAAI,CAAC,KAAK,EAAE,SAAS,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,SAAS,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,EAAE,SAAS,CAAC,MAAM,CAAC,GAAG,OAAO,CAAC,aAAa,CAAC;IAMlH,OAAO,CAAC,cAAc;YAuBR,QAAQ;IA0CtB,oFAAoF;IAC9E,KAAK,CAAC,OAAO,EAAE,YAAY,EAAE,EAAE,IAAI,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAMlF,QAAQ,CAAC,OAAO,EAAE,YAAY,EAAE,GAAG,MAAM;IAIzC,aAAa,CAAC,IAAI,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,WAAW;IAIrD,2DAA2D;IACrD,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAI3B,2EAA2E;IACrE,IAAI,IAAI,OAAO,CAAC,OAAO,CAAC;IAQ9B,OAAO,CAAC,iBAAiB;IAWzB,OAAO,IAAI,IAAI;CAMhB"}