abmind 0.0.1 → 0.1.1

package/dist/src/emotion-arc.js

@@ -0,0 +1,62 @@
+/**
+ * emotion-arc.ts — Track emotional trajectory per topic over time.
+ * Built during sleep from emotion_tags on recent memories.
+ */
+const VALENCE = {
+    joy: 1, love: 1, gratitude: 1, pride: 1, excitement: 1, hope: 1, relief: 1,
+    trust: 0.5, peace: 0.5, humor: 0.5, tenderness: 0.5, curiosity: 0.3,
+    conviction: 0.5, determination: 0.3, surprise: 0,
+    doubt: -0.3, confusion: -0.3, vulnerability: -0.3,
+    fear: -0.5, anxiety: -0.5, frustration: -0.5, exhaustion: -0.5,
+    anger: -1, grief: -1, raw_honesty: -0.2,
+};
+function tagValence(tag) {
+    return VALENCE[tag] ?? 0;
+}
+/** Build emotional arc from a sequence of memories (ordered by time). */
+export function buildArc(memories) {
+    if (memories.length === 0)
+        return { tags: [], direction: "stable", symbol: "—" };
+    const allTags = [];
+    const valences = [];
+    for (const m of memories) {
+        const tags = m.emotion_tags.split(",").map(t => t.trim()).filter(Boolean);
+        for (const t of tags)
+            if (!allTags.includes(t))
+                allTags.push(t);
+        const avg = tags.length > 0 ? tags.reduce((s, t) => s + tagValence(t), 0) / tags.length : 0;
+        valences.push(avg);
+    }
+    if (valences.length < 2)
+        return { tags: allTags, direction: "stable", symbol: "—" };
+    // Compute direction from trend
+    const first = valences.slice(0, Math.ceil(valences.length / 2));
+    const second = valences.slice(Math.ceil(valences.length / 2));
+    const avgFirst = first.reduce((a, b) => a + b, 0) / first.length;
+    const avgSecond = second.reduce((a, b) => a + b, 0) / second.length;
+    const diff = avgSecond - avgFirst;
+    // Check volatility (standard deviation)
+    const mean = valences.reduce((a, b) => a + b, 0) / valences.length;
+    const variance = valences.reduce((s, v) => s + (v - mean) ** 2, 0) / valences.length;
+    const stddev = Math.sqrt(variance);
+    let direction;
+    let symbol;
+    if (stddev > 0.8) {
+        direction = "volatile";
+        symbol = "↕";
+    }
+    else if (diff > 0.2) {
+        direction = "rising";
+        symbol = "↑";
+    }
+    else if (diff < -0.2) {
+        direction = "falling";
+        symbol = "↓";
+    }
+    else {
+        direction = "stable";
+        symbol = "→";
+    }
+    return { tags: allTags, direction, symbol };
+}
+//# sourceMappingURL=emotion-arc.js.map

package/dist/src/emotion-arc.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"emotion-arc.js","sourceRoot":"","sources":["../../src/emotion-arc.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAYH,MAAM,OAAO,GAA2B;IACtC,GAAG,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,UAAU,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1E,KAAK,EAAE,GAAG,EAAE,KAAK,EAAE,GAAG,EAAE,KAAK,EAAE,GAAG,EAAE,UAAU,EAAE,GAAG,EAAE,SAAS,EAAE,GAAG;IACnE,UAAU,EAAE,GAAG,EAAE,aAAa,EAAE,GAAG,EAAE,QAAQ,EAAE,CAAC;IAChD,KAAK,EAAE,CAAC,GAAG,EAAE,SAAS,EAAE,CAAC,GAAG,EAAE,aAAa,EAAE,CAAC,GAAG;IACjD,IAAI,EAAE,CAAC,GAAG,EAAE,OAAO,EAAE,CAAC,GAAG,EAAE,WAAW,EAAE,CAAC,GAAG,EAAE,UAAU,EAAE,CAAC,GAAG;IAC9D,KAAK,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,EAAE,WAAW,EAAE,CAAC,GAAG;CACxC,CAAC;AAEF,SAAS,UAAU,CAAC,GAAW;IAC7B,OAAO,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;AAC3B,CAAC;AAED,yEAAyE;AACzE,MAAM,UAAU,QAAQ,CAAC,QAAqE;IAC5F,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,IAAI,EAAE,EAAE,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC;IAEjF,MAAM,OAAO,GAAiB,EAAE,CAAC;IACjC,MAAM,QAAQ,GAAa,EAAE,CAAC;IAE9B,KAAK,MAAM,CAAC,IAAI,QAAQ,EAAE,CAAC;QACzB,MAAM,IAAI,GAAG,CAAC,CAAC,YAAY,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,OAAO,CAAiB,CAAC;QAC1F,KAAK,MAAM,CAAC,IAAI,IAAI;YAAE,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC;gBAAE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAChE,MAAM,GAAG,GAAG,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,UAAU,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;QAC5F,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACrB,CAAC;IAED,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC;IAEpF,+BAA+B;IAC/B,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC;IAChE,MAAM,MAAM,GAAG,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC;IAC9D,MAAM,QAAQ,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,GAAG,KAAK,CAAC,MAAM,CAAC;IACjE,MAAM,SAAS,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC;IACpE,MAAM,IAAI,GAAG,SAAS,GAAG,QAAQ,CAAC;IAElC,wCAAwC;IACxC,MAAM,IAAI,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,GAAG,QAAQ,CAAC,MAAM,CAAC;IACnE,MAAM,QAAQ,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,GAAG,QAAQ,CAAC,MAAM,CAAC;IACrF,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAEnC,IAAI,SAAuB,CAAC;IAC5B,IAAI,MAAc,CAAC;IAEnB,IAAI,MAAM,GAAG,GAAG,EAAE,CAAC;QAAC,SAAS,GAAG,UAAU,CAAC;QAAC,MAAM,GAAG,GAAG,CAAC;IAAC,CAAC;SACtD,IAAI,IAAI,GAAG,GAAG,EAAE,CAAC;QAAC,SAAS,GAAG,QAAQ,CAAC;QAAC,MAAM,GAAG,GAAG,CAAC;IAAC,CAAC;SACvD,IAAI,IAAI,GAAG,CAAC,GAAG,EAAE,CAAC;QAAC,SAAS,GAAG,SAAS,CAAC;QAAC,MAAM,GAAG,GAAG,CAAC;IAAC,CAAC;SACzD,CAAC;QAAC,SAAS,GAAG,QAAQ,CAAC;QAAC,MAAM,GAAG,GAAG,CAAC;IAAC,CAAC;IAE5C,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,CAAC;AAC9C,CAAC"}

package/dist/src/emotion-tagger.d.ts

@@ -0,0 +1,8 @@
+/**
+ * emotion-tagger.ts — Pattern-based emotion detection.
+ * Pure function, no LLM, ~1ms per call.
+ */
+export type EmotionTag = "joy" | "trust" | "hope" | "fear" | "grief" | "anger" | "doubt" | "relief" | "pride" | "curiosity" | "frustration" | "surprise" | "determination" | "exhaustion" | "anxiety" | "gratitude" | "love" | "humor" | "vulnerability" | "conviction" | "peace" | "confusion" | "excitement" | "tenderness" | "raw_honesty";
+/** Detect emotions from text via keyword patterns. Returns deduplicated tags. */
+export declare function detectEmotions(text: string): EmotionTag[];
+//# sourceMappingURL=emotion-tagger.d.ts.map

package/dist/src/emotion-tagger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"emotion-tagger.d.ts","sourceRoot":"","sources":["../../src/emotion-tagger.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,MAAM,UAAU,GAClB,KAAK,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,OAAO,GACrD,OAAO,GAAG,QAAQ,GAAG,OAAO,GAAG,WAAW,GAAG,aAAa,GAC1D,UAAU,GAAG,eAAe,GAAG,YAAY,GAAG,SAAS,GACvD,WAAW,GAAG,MAAM,GAAG,OAAO,GAAG,eAAe,GAAG,YAAY,GAC/D,OAAO,GAAG,WAAW,GAAG,YAAY,GAAG,YAAY,GAAG,aAAa,CAAC;AAqCxE,iFAAiF;AACjF,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,EAAE,CAMzD"}

package/dist/src/emotion-tagger.js

@@ -0,0 +1,45 @@
+/**
+ * emotion-tagger.ts — Pattern-based emotion detection.
+ * Pure function, no LLM, ~1ms per call.
+ */
+const PATTERNS = [
+    // joy / positive
+    [/\b(happy|glad|delighted|wonderful|amazing|fantastic|brilliant|perfect)\b/i, "joy"],
+    [/\b(love|adore|cherish|devoted)\b/i, "love"],
+    [/\b(grateful|thankful|appreciate|thanks)\b/i, "gratitude"],
+    [/\b(proud|pride|accomplished|nailed it)\b/i, "pride"],
+    [/\b(excited|thrilled|can't wait|pumped)\b/i, "excitement"],
+    [/\b(funny|hilarious|lol|lmao|haha|😂|🤣)\b/i, "humor"],
+    [/\b(peaceful|calm|serene|at ease)\b/i, "peace"],
+    [/\b(tender|gentle|warm|caring)\b/i, "tenderness"],
+    // trust / conviction
+    [/\b(trust|reliable|dependable|count on)\b/i, "trust"],
+    [/\b(decided|committed|convinced|certain|absolutely)\b/i, "conviction"],
+    [/\b(determined|persistent|won't give up|keep going)\b/i, "determination"],
+    // hope / relief
+    [/\b(hope|hopeful|optimistic|looking forward)\b/i, "hope"],
+    [/\b(relief|relieved|finally|phew|thank god)\b/i, "relief"],
+    [/\b(surprised|unexpected|didn't expect|wow|whoa)\b/i, "surprise"],
+    [/\b(curious|wondering|interesting|intrigued|fascinated)\b/i, "curiosity"],
+    // negative
+    [/\b(afraid|scared|terrified|frightened|worried about)\b/i, "fear"],
+    [/\b(anxious|nervous|uneasy|stressed|overwhelmed)\b/i, "anxiety"],
+    [/\b(angry|furious|rage|pissed|infuriated|hate)\b/i, "anger"],
+    [/\b(frustrated|annoying|irritating|ugh|damn)\b/i, "frustration"],
+    [/\b(confused|lost|don't understand|makes no sense|wtf)\b/i, "confusion"],
+    [/\b(sad|grief|mourning|loss|heartbroken|devastated)\b/i, "grief"],
+    [/\b(doubt|uncertain|not sure|skeptical|questionable)\b/i, "doubt"],
+    [/\b(exhausted|burned out|drained|tired of|fed up)\b/i, "exhaustion"],
+    [/\b(vulnerable|exposed|raw|honest truth|admit)\b/i, "vulnerability"],
+    [/\b(brutal honesty|hard truth|real talk|no sugar)\b/i, "raw_honesty"],
+];
+/** Detect emotions from text via keyword patterns. Returns deduplicated tags. */
+export function detectEmotions(text) {
+    const seen = new Set();
+    for (const [pattern, tag] of PATTERNS) {
+        if (pattern.test(text) && !seen.has(tag))
+            seen.add(tag);
+    }
+    return [...seen];
+}
+//# sourceMappingURL=emotion-tagger.js.map

package/dist/src/emotion-tagger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"emotion-tagger.js","sourceRoot":"","sources":["../../src/emotion-tagger.ts"],"names":[],"mappings":"AAAA;;;GAGG;AASH,MAAM,QAAQ,GAAiD;IAC7D,iBAAiB;IACjB,CAAC,2EAA2E,EAAE,KAAK,CAAC;IACpF,CAAC,mCAAmC,EAAE,MAAM,CAAC;IAC7C,CAAC,4CAA4C,EAAE,WAAW,CAAC;IAC3D,CAAC,2CAA2C,EAAE,OAAO,CAAC;IACtD,CAAC,2CAA2C,EAAE,YAAY,CAAC;IAC3D,CAAC,4CAA4C,EAAE,OAAO,CAAC;IACvD,CAAC,qCAAqC,EAAE,OAAO,CAAC;IAChD,CAAC,kCAAkC,EAAE,YAAY,CAAC;IAElD,qBAAqB;IACrB,CAAC,2CAA2C,EAAE,OAAO,CAAC;IACtD,CAAC,uDAAuD,EAAE,YAAY,CAAC;IACvE,CAAC,uDAAuD,EAAE,eAAe,CAAC;IAE1E,gBAAgB;IAChB,CAAC,gDAAgD,EAAE,MAAM,CAAC;IAC1D,CAAC,+CAA+C,EAAE,QAAQ,CAAC;IAC3D,CAAC,oDAAoD,EAAE,UAAU,CAAC;IAClE,CAAC,2DAA2D,EAAE,WAAW,CAAC;IAE1E,WAAW;IACX,CAAC,yDAAyD,EAAE,MAAM,CAAC;IACnE,CAAC,oDAAoD,EAAE,SAAS,CAAC;IACjE,CAAC,kDAAkD,EAAE,OAAO,CAAC;IAC7D,CAAC,gDAAgD,EAAE,aAAa,CAAC;IACjE,CAAC,0DAA0D,EAAE,WAAW,CAAC;IACzE,CAAC,uDAAuD,EAAE,OAAO,CAAC;IAClE,CAAC,wDAAwD,EAAE,OAAO,CAAC;IACnE,CAAC,qDAAqD,EAAE,YAAY,CAAC;IACrE,CAAC,kDAAkD,EAAE,eAAe,CAAC;IACrE,CAAC,qDAAqD,EAAE,aAAa,CAAC;CACvE,CAAC;AAEF,iFAAiF;AACjF,MAAM,UAAU,cAAc,CAAC,IAAY;IACzC,MAAM,IAAI,GAAG,IAAI,GAAG,EAAc,CAAC;IACnC,KAAK,MAAM,CAAC,OAAO,EAAE,GAAG,CAAC,IAAI,QAAQ,EAAE,CAAC;QACtC,IAAI,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC;YAAE,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAC1D,CAAC;IACD,OAAO,CAAC,GAAG,IAAI,CAAC,CAAC;AACnB,CAAC"}

package/dist/src/emotion-utils.d.ts

@@ -0,0 +1,13 @@
+/** Clamp a value to [-5, +5]. Non-integer or missing values default to 0. */
+export declare function clampEmotionScore(value: unknown): number;
+/** Map a reaction emoji to an emotion score [-5, +5]. Unknown emojis default to +1. */
+export declare function emojiToScore(emoji: string): number;
+/** Derive emotion_score from tags using max absolute valence. */
+export declare function scoreFromTags(tags: string): number;
+/** Recency-decayed emotion: recent emotions are vivid, old ones fade. */
+export declare function effectiveEmotion(score: number, daysSinceCreated: number): number;
+/** Map a reaction emoji to an emotion tag. Unknown emojis default to "gratitude". */
+export declare function emojiToTag(emoji: string): string;
+/** Reverse-derive a default tag from a numeric score (for backfill). */
+export declare function tagFromScore(score: number): string;
+//# sourceMappingURL=emotion-utils.d.ts.map

package/dist/src/emotion-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"emotion-utils.d.ts","sourceRoot":"","sources":["../../src/emotion-utils.ts"],"names":[],"mappings":"AAAA,6EAA6E;AAC7E,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAKxD;AASD,uFAAuF;AACvF,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAElD;AAYD,iEAAiE;AACjE,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CASlD;AAED,yEAAyE;AACzE,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,EAAE,gBAAgB,EAAE,MAAM,GAAG,MAAM,CAGhF;AAYD,qFAAqF;AACrF,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEhD;AAED,wEAAwE;AACxE,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAQlD"}

package/dist/src/emotion-utils.js

@@ -0,0 +1,76 @@
+/** Clamp a value to [-5, +5]. Non-integer or missing values default to 0. */
+export function clampEmotionScore(value) {
+    if (value === null || value === undefined)
+        return 0;
+    const n = Number(value);
+    if (!Number.isInteger(n))
+        return 0;
+    return Math.max(-5, Math.min(5, n));
+}
+const EMOJI_SCORES = {
+    "❤️": 4, "🔥": 4, "🎉": 3, "👏": 4, "❤": 4,
+    "👍": 3, "😂": 3, "🤩": 4, "💯": 3, "⚡": 3,
+    "😊": 2, "🙏": 2, "🤔": 1, "😮": 1,
+    "👎": -3, "😢": -3, "😡": -4, "🤮": -4, "💩": -5,
+};
+/** Map a reaction emoji to an emotion score [-5, +5]. Unknown emojis default to +1. */
+export function emojiToScore(emoji) {
+    return EMOJI_SCORES[emoji] ?? 1;
+}
+// ── Tag valence map (positive/negative weight per tag) ──────────────────────
+const TAG_VALENCE = {
+    joy: 4, love: 5, gratitude: 3, pride: 4, excitement: 4, humor: 3,
+    peace: 2, tenderness: 3, trust: 2, conviction: 3, determination: 3,
+    hope: 3, relief: 3, surprise: 2, curiosity: 2,
+    fear: -3, anxiety: -3, anger: -4, frustration: -3, confusion: -2,
+    grief: -5, doubt: -2, exhaustion: -3, vulnerability: -2, raw_honesty: -1,
+};
+/** Derive emotion_score from tags using max absolute valence. */
+export function scoreFromTags(tags) {
+    if (!tags)
+        return 0;
+    let maxAbs = 0;
+    let maxVal = 0;
+    for (const tag of tags.split(",")) {
+        const v = TAG_VALENCE[tag.trim()];
+        if (v !== undefined && Math.abs(v) > maxAbs) {
+            maxAbs = Math.abs(v);
+            maxVal = v;
+        }
+    }
+    return clampEmotionScore(maxVal);
+}
+/** Recency-decayed emotion: recent emotions are vivid, old ones fade. */
+export function effectiveEmotion(score, daysSinceCreated) {
+    const decay = Math.max(0.2, 1 - daysSinceCreated / 180); // 6-month half-life, floor 0.2
+    return Math.round(score * decay * 10) / 10;
+}
+// ── Emoji → tags mapping ────────────────────────────────────────────────────
+const EMOJI_TAGS = {
+    "❤️": "love", "❤": "love", "🔥": "excitement", "🎉": "joy",
+    "👏": "pride", "👍": "gratitude", "😂": "humor", "🤩": "excitement",
+    "💯": "conviction", "⚡": "determination", "😊": "joy", "🙏": "gratitude",
+    "🤔": "curiosity", "😮": "surprise",
+    "👎": "frustration", "😢": "grief", "😡": "anger", "🤮": "anger", "💩": "frustration",
+};
+/** Map a reaction emoji to an emotion tag. Unknown emojis default to "gratitude". */
+export function emojiToTag(emoji) {
+    return EMOJI_TAGS[emoji] ?? "gratitude";
+}
+/** Reverse-derive a default tag from a numeric score (for backfill). */
+export function tagFromScore(score) {
+    if (score >= 4)
+        return "pride";
+    if (score >= 2)
+        return "joy";
+    if (score === 1)
+        return "gratitude";
+    if (score === 0)
+        return "";
+    if (score >= -2)
+        return "doubt";
+    if (score >= -4)
+        return "frustration";
+    return "anger";
+}
+//# sourceMappingURL=emotion-utils.js.map

package/dist/src/emotion-utils.js.map

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

package/dist/src/entity-graph.d.ts

@@ -0,0 +1,33 @@
+/**
+ * entity-graph.ts — Entity relationship store + query for S8 recall layer.
+ */
+import type Database from "better-sqlite3";
+export type EntityEdge = {
+    id: number;
+    entity_a: string;
+    entity_b: string;
+    relation: string;
+    source_memory_id: number | null;
+    created_at: number;
+    last_seen_at: number;
+};
+/** Insert or update an entity relationship edge. */
+export declare function upsertEdge(db: Database.Database, edge: {
+    entity_a: string;
+    entity_b: string;
+    relation: string;
+    source_memory_id?: number;
+}): void;
+/**
+ * S8 recall: find relationships for a given entity.
+ * Respects BLP (classification) — SECRET edges only visible when caller allows.
+ *
+ * Historical note: this used to also filter `credibility <= 3` under the
+ * comment "skip contradicted sources". That was wrong: contradictions never
+ * decrement credibility (only 7-day aging does, 6→3), so the filter silently
+ * hid all fresh edges. Removed in #361.
+ */
+export declare function queryEntityRelationships(db: Database.Database, entity: string, maxClassification: number): EntityEdge[];
+/** Check if an entity exists in the graph. */
+export declare function isKnownEntity(db: Database.Database, entity: string): boolean;
+//# sourceMappingURL=entity-graph.d.ts.map

package/dist/src/entity-graph.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"entity-graph.d.ts","sourceRoot":"","sources":["../../src/entity-graph.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAC;AAE3C,MAAM,MAAM,UAAU,GAAG;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;CACtB,CAAC;AAEF,oDAAoD;AACpD,wBAAgB,UAAU,CACxB,EAAE,EAAE,QAAQ,CAAC,QAAQ,EACrB,IAAI,EAAE;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,gBAAgB,CAAC,EAAE,MAAM,CAAA;CAAE,GACxF,IAAI,CASN;AAED;;;;;;;;GAQG;AACH,wBAAgB,wBAAwB,CACtC,EAAE,EAAE,QAAQ,CAAC,QAAQ,EACrB,MAAM,EAAE,MAAM,EACd,iBAAiB,EAAE,MAAM,GACxB,UAAU,EAAE,CAWd;AAED,8CAA8C;AAC9C,wBAAgB,aAAa,CAAC,EAAE,EAAE,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAM5E"}

package/dist/src/entity-graph.js

@@ -0,0 +1,42 @@
+/**
+ * entity-graph.ts — Entity relationship store + query for S8 recall layer.
+ */
+/** Insert or update an entity relationship edge. */
+export function upsertEdge(db, edge) {
+    const now = Date.now();
+    db.prepare(`
+    INSERT INTO entity_graph (entity_a, entity_b, relation, source_memory_id, created_at, last_seen_at)
+    VALUES (lower(?), lower(?), ?, ?, ?, ?)
+    ON CONFLICT(entity_a, entity_b, relation) DO UPDATE SET
+      last_seen_at = excluded.last_seen_at,
+      source_memory_id = excluded.source_memory_id
+  `).run(edge.entity_a, edge.entity_b, edge.relation, edge.source_memory_id ?? null, now, now);
+}
+/**
+ * S8 recall: find relationships for a given entity.
+ * Respects BLP (classification) — SECRET edges only visible when caller allows.
+ *
+ * Historical note: this used to also filter `credibility <= 3` under the
+ * comment "skip contradicted sources". That was wrong: contradictions never
+ * decrement credibility (only 7-day aging does, 6→3), so the filter silently
+ * hid all fresh edges. Removed in #361.
+ */
+export function queryEntityRelationships(db, entity, maxClassification) {
+    const normalized = entity.toLowerCase();
+    return db.prepare(`
+    SELECT eg.*
+    FROM entity_graph eg
+    LEFT JOIN extracted_memories em ON eg.source_memory_id = em.id
+    WHERE (eg.entity_a = ? OR eg.entity_b = ?)
+      AND (em.id IS NULL OR em.classification <= ?)
+    ORDER BY eg.last_seen_at DESC
+    LIMIT 10
+  `).all(normalized, normalized, maxClassification);
+}
+/** Check if an entity exists in the graph. */
+export function isKnownEntity(db, entity) {
+    const normalized = entity.toLowerCase();
+    const row = db.prepare(`SELECT 1 FROM entity_graph WHERE entity_a = ? OR entity_b = ? LIMIT 1`).get(normalized, normalized);
+    return row !== undefined;
+}
+//# sourceMappingURL=entity-graph.js.map

package/dist/src/entity-graph.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"entity-graph.js","sourceRoot":"","sources":["../../src/entity-graph.ts"],"names":[],"mappings":"AAAA;;GAEG;AAcH,oDAAoD;AACpD,MAAM,UAAU,UAAU,CACxB,EAAqB,EACrB,IAAyF;IAEzF,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IACvB,EAAE,CAAC,OAAO,CAAC;;;;;;GAMV,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,gBAAgB,IAAI,IAAI,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC;AAC/F,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,wBAAwB,CACtC,EAAqB,EACrB,MAAc,EACd,iBAAyB;IAEzB,MAAM,UAAU,GAAG,MAAM,CAAC,WAAW,EAAE,CAAC;IACxC,OAAO,EAAE,CAAC,OAAO,CAAC;;;;;;;;GAQjB,CAAC,CAAC,GAAG,CAAC,UAAU,EAAE,UAAU,EAAE,iBAAiB,CAAiB,CAAC;AACpE,CAAC;AAED,8CAA8C;AAC9C,MAAM,UAAU,aAAa,CAAC,EAAqB,EAAE,MAAc;IACjE,MAAM,UAAU,GAAG,MAAM,CAAC,WAAW,EAAE,CAAC;IACxC,MAAM,GAAG,GAAG,EAAE,CAAC,OAAO,CACpB,uEAAuE,CACxE,CAAC,GAAG,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC;IAC9B,OAAO,GAAG,KAAK,SAAS,CAAC;AAC3B,CAAC"}

package/dist/src/env-schema.d.ts

@@ -0,0 +1,46 @@
+/**
+ * env-schema.ts — Central env var schema for abmind.
+ * Single source of truth. All env access goes through getAbmindEnv().
+ */
+export interface AbmindEnvConfig {
+    readonly abmindHome: string;
+    readonly memoryDir: string;
+    readonly memorySearchMode: string;
+    readonly memoryMaxDbSizeMb: number;
+    readonly memoryOriginalTtlDays: number;
+    readonly memoryEnglishTtlDays: number;
+    readonly memoryAgingEnabled: boolean;
+    readonly memoryIpc: boolean;
+    readonly memoryBackend: string;
+    readonly embeddingEnabled: boolean;
+    readonly embeddingProvider: "ollama" | "openai";
+    readonly embeddingModel: string;
+    readonly embeddingUrl: string;
+    readonly embeddingApiKey: string;
+    readonly embeddingDimensions: number;
+    readonly embeddingSimilarityThreshold: number;
+    readonly signatureBits: number;
+    readonly recallDecayDays: number;
+    readonly recallDecayFloor: number;
+    readonly recallEmotionBoost: number;
+    readonly abmlMinChars: number;
+    readonly abmlVersion: "plain" | "v0" | "v1" | "v2";
+    readonly contextTierEnabled: boolean;
+    readonly contextTierTail: number;
+    readonly contextTierMiddle: number;
+    readonly compactionLlmEnabled: boolean;
+    readonly sleepQuality: string | undefined;
+    readonly sleepTimeoutMin: number;
+    readonly sleepMaxLlmCalls: number;
+    readonly sleepCurationDay: string;
+    readonly sleepModelName: string;
+    readonly sleepCtxWindow: number;
+    readonly keyFile: string;
+}
+/** Get parsed env config. Auto-initializes on first call. */
+export declare function getAbmindEnv(): Readonly<AbmindEnvConfig>;
+/** Initialize env config from process.env. Call once at boot or auto-called by getAbmindEnv(). */
+export declare function initAbmindEnv(): Readonly<AbmindEnvConfig>;
+/** Reset singleton (for tests only). */
+export declare function _resetAbmindEnv(): void;
+//# sourceMappingURL=env-schema.d.ts.map

package/dist/src/env-schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"env-schema.d.ts","sourceRoot":"","sources":["../../src/env-schema.ts"],"names":[],"mappings":"AAAA;;;GAGG;AA2BH,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,qBAAqB,EAAE,MAAM,CAAC;IACvC,QAAQ,CAAC,oBAAoB,EAAE,MAAM,CAAC;IACtC,QAAQ,CAAC,kBAAkB,EAAE,OAAO,CAAC;IACrC,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,gBAAgB,EAAE,OAAO,CAAC;IACnC,QAAQ,CAAC,iBAAiB,EAAE,QAAQ,GAAG,QAAQ,CAAC;IAChD,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,mBAAmB,EAAE,MAAM,CAAC;IACrC,QAAQ,CAAC,4BAA4B,EAAE,MAAM,CAAC;IAC9C,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAC;IACpC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,WAAW,EAAE,OAAO,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;IAEnD,QAAQ,CAAC,kBAAkB,EAAE,OAAO,CAAC;IACrC,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,oBAAoB,EAAE,OAAO,CAAC;IACvC,QAAQ,CAAC,YAAY,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1C,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAMD,6DAA6D;AAC7D,wBAAgB,YAAY,IAAI,QAAQ,CAAC,eAAe,CAAC,CAGxD;AAED,kGAAkG;AAClG,wBAAgB,aAAa,IAAI,QAAQ,CAAC,eAAe,CAAC,CAuDzD;AAED,wCAAwC;AACxC,wBAAgB,eAAe,IAAI,IAAI,CAAiB"}

package/dist/src/env-schema.js

@@ -0,0 +1,93 @@
+/**
+ * env-schema.ts — Central env var schema for abmind.
+ * Single source of truth. All env access goes through getAbmindEnv().
+ */
+import { logInfo, logWarn } from "./mem-logger.js";
+import { homedir } from "node:os";
+import { join } from "node:path";
+// ── Parsing helpers ─────────────────────────────────────────────────────────
+function intSafe(raw, name, fallback) {
+    const n = parseInt(raw, 10);
+    if (isNaN(n)) {
+        logWarn("env", `Invalid ${name}: "${raw}" — using default ${fallback}`);
+        return fallback;
+    }
+    return n;
+}
+function floatSafe(raw, name, fallback) {
+    const n = parseFloat(raw);
+    if (isNaN(n)) {
+        logWarn("env", `Invalid ${name}: "${raw}" — using default ${fallback}`);
+        return fallback;
+    }
+    return n;
+}
+function clamp(val, min, max, name, fallback) {
+    if (val < min || val > max) {
+        logWarn("env", `${name}=${val} out of range [${min},${max}] — using default ${fallback}`);
+        return fallback;
+    }
+    return val;
+}
+// ── Singleton ───────────────────────────────────────────────────────────────
+let _env = null;
+/** Get parsed env config. Auto-initializes on first call. */
+export function getAbmindEnv() {
+    if (!_env)
+        initAbmindEnv();
+    return _env;
+}
+/** Initialize env config from process.env. Call once at boot or auto-called by getAbmindEnv(). */
+export function initAbmindEnv() {
+    const read = (k) => process.env[k]?.trim() || undefined;
+    const readOr = (k, d) => read(k) ?? d;
+    const abmindHome = readOr("ABMIND_HOME", join(homedir(), ".abmind"));
+    const env = {
+        abmindHome,
+        memoryDir: readOr("MEMORY_DIR", join(abmindHome, "memory")),
+        memorySearchMode: readOr("MEMORY_SEARCH_MODE", "hybrid"),
+        memoryMaxDbSizeMb: intSafe(readOr("MEMORY_MAX_DB_SIZE_MB", "4096"), "MEMORY_MAX_DB_SIZE_MB", 4096),
+        memoryOriginalTtlDays: intSafe(readOr("MEMORY_ORIGINAL_TTL_DAYS", "90"), "MEMORY_ORIGINAL_TTL_DAYS", 90),
+        memoryEnglishTtlDays: intSafe(readOr("MEMORY_ENGLISH_TTL_DAYS", "14"), "MEMORY_ENGLISH_TTL_DAYS", 14),
+        memoryAgingEnabled: read("MEMORY_AGING_ENABLED") !== "false",
+        memoryIpc: read("MEMORY_IPC") !== "0",
+        memoryBackend: readOr("MEMORY_BACKEND", "sqlite"),
+        embeddingEnabled: read("EMBEDDING_ENABLED") === "true",
+        embeddingProvider: (() => {
+            const v = readOr("EMBEDDING_PROVIDER", "ollama").toLowerCase();
+            return v === "openai" ? "openai" : "ollama";
+        })(),
+        embeddingModel: readOr("EMBEDDING_MODEL", "nomic-embed-text"),
+        embeddingUrl: readOr("EMBEDDING_URL", "http://localhost:11434"),
+        embeddingApiKey: readOr("EMBEDDING_API_KEY", ""),
+        embeddingDimensions: intSafe(readOr("EMBEDDING_DIMENSIONS", "768"), "EMBEDDING_DIMENSIONS", 768),
+        embeddingSimilarityThreshold: clamp(floatSafe(readOr("EMBEDDING_SIMILARITY_THRESHOLD", "0.5"), "EMBEDDING_SIMILARITY_THRESHOLD", 0.5), 0, 1, "EMBEDDING_SIMILARITY_THRESHOLD", 0.5),
+        signatureBits: intSafe(readOr("SIGNATURE_BITS", "256"), "SIGNATURE_BITS", 256),
+        recallDecayDays: intSafe(readOr("RECALL_DECAY_DAYS", "365"), "RECALL_DECAY_DAYS", 365),
+        recallDecayFloor: clamp(floatSafe(readOr("RECALL_DECAY_FLOOR", "0.3"), "RECALL_DECAY_FLOOR", 0.3), 0, 1, "RECALL_DECAY_FLOOR", 0.3),
+        recallEmotionBoost: floatSafe(readOr("RECALL_EMOTION_BOOST", "0.1"), "RECALL_EMOTION_BOOST", 0.1),
+        abmlMinChars: intSafe(readOr("ABML_MIN_CHARS", "100"), "ABML_MIN_CHARS", 100),
+        abmlVersion: (() => { const v = readOr("ABML_VERSION", "plain"); if (v === "v2")
+            return "v2"; if (v === "v1")
+            return "v1"; if (v === "v0")
+            return "v0"; return "plain"; })(),
+        // #348 — three-tier context assembly
+        contextTierEnabled: readOr("CONTEXT_TIER_ENABLED", "true").toLowerCase() !== "false",
+        contextTierTail: intSafe(readOr("CONTEXT_TIER_TAIL", "20"), "CONTEXT_TIER_TAIL", 20),
+        contextTierMiddle: intSafe(readOr("CONTEXT_TIER_MIDDLE", "50"), "CONTEXT_TIER_MIDDLE", 50),
+        compactionLlmEnabled: readOr("COMPACTION_LLM_ENABLED", "false").toLowerCase() === "true",
+        sleepQuality: read("SLEEP_QUALITY"),
+        sleepTimeoutMin: intSafe(readOr("SLEEP_TIMEOUT_MIN", "55"), "SLEEP_TIMEOUT_MIN", 55),
+        sleepMaxLlmCalls: Math.min(intSafe(readOr("SLEEP_MAX_LLM_CALLS", "15"), "SLEEP_MAX_LLM_CALLS", 15), 50),
+        sleepCurationDay: readOr("SLEEP_CURATION_DAY", "sunday").toLowerCase(),
+        sleepModelName: readOr("SLEEP_MODEL_NAME", "unknown"),
+        sleepCtxWindow: intSafe(readOr("AGENT_SLEEP_CTX_WINDOW", "128000"), "AGENT_SLEEP_CTX_WINDOW", 128000),
+        keyFile: readOr("ABMIND_KEY_FILE", join(abmindHome, "secret", "abmind.key")),
+    };
+    logInfo("env", `${Object.keys(env).length} vars loaded`);
+    _env = Object.freeze(env);
+    return _env;
+}
+/** Reset singleton (for tests only). */
+export function _resetAbmindEnv() { _env = null; }
+//# sourceMappingURL=env-schema.js.map

package/dist/src/env-schema.js.map

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

package/dist/src/hook-helpers.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Shared helpers for Kiro hook subcommands (#344).
+ *
+ * Hook subcommands must NEVER block the user's chat turn. On any unexpected
+ * failure, they write to the error log and exit 0 with empty stdout. The
+ * error log is surfaced via `abmind hook doctor` and `abmind status`.
+ */
+/** Append a timestamped entry to the hook error log. Never throws. */
+export declare function logHookError(hookName: string, err: unknown): void;
+/** Ensure the hooks dir exists. Never throws. */
+export declare function ensureHooksDir(): void;
+/** Read and parse JSON from stdin. Returns null on any error. */
+export declare function readStdinJson<T = unknown>(): Promise<T | null>;
+/** Whether hooks are globally disabled via env var. */
+export declare function hooksDisabled(): boolean;
+//# sourceMappingURL=hook-helpers.d.ts.map

package/dist/src/hook-helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hook-helpers.d.ts","sourceRoot":"","sources":["../../src/hook-helpers.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAMH,sEAAsE;AACtE,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,GAAG,IAAI,CAUjE;AAED,iDAAiD;AACjD,wBAAgB,cAAc,IAAI,IAAI,CAMrC;AAED,iEAAiE;AACjE,wBAAsB,aAAa,CAAC,CAAC,GAAG,OAAO,KAAK,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC,CAgBpE;AAED,uDAAuD;AACvD,wBAAgB,aAAa,IAAI,OAAO,CAGvC"}

package/dist/src/hook-helpers.js

@@ -0,0 +1,64 @@
+/**
+ * Shared helpers for Kiro hook subcommands (#344).
+ *
+ * Hook subcommands must NEVER block the user's chat turn. On any unexpected
+ * failure, they write to the error log and exit 0 with empty stdout. The
+ * error log is surfaced via `abmind hook doctor` and `abmind status`.
+ */
+import { appendFileSync, mkdirSync } from "node:fs";
+import { dirname } from "node:path";
+import { abmindHooksDir, hookErrorLogPath } from "./mem-paths.js";
+/** Append a timestamped entry to the hook error log. Never throws. */
+export function logHookError(hookName, err) {
+    try {
+        const ts = new Date().toISOString();
+        const msg = err instanceof Error ? err.message : String(err);
+        const line = `${ts} [${hookName}] ${msg}\n`;
+        mkdirSync(dirname(hookErrorLogPath()), { recursive: true });
+        appendFileSync(hookErrorLogPath(), line);
+    }
+    catch {
+        // If even the error log write fails, silently give up — don't block the hook.
+    }
+}
+/** Ensure the hooks dir exists. Never throws. */
+export function ensureHooksDir() {
+    try {
+        mkdirSync(abmindHooksDir(), { recursive: true });
+    }
+    catch {
+        // Ignore — individual writers will surface their own errors if needed.
+    }
+}
+/** Read and parse JSON from stdin. Returns null on any error. */
+export async function readStdinJson() {
+    return new Promise((resolve) => {
+        let buf = "";
+        process.stdin.setEncoding("utf-8");
+        process.stdin.on("data", (chunk) => { buf += chunk; });
+        process.stdin.on("end", () => {
+            if (!buf.trim()) {
+                resolve(null);
+                return;
+            }
+            try {
+                resolve(JSON.parse(buf));
+            }
+            catch {
+                resolve(null);
+            }
+        });
+        process.stdin.on("error", () => resolve(null));
+        // If stdin closed already with no data, resolve null after tick
+        setTimeout(() => {
+            if (!buf)
+                resolve(null);
+        }, 100);
+    });
+}
+/** Whether hooks are globally disabled via env var. */
+export function hooksDisabled() {
+    const v = process.env.ABMIND_HOOKS_DISABLED?.toLowerCase().trim();
+    return v === "true" || v === "1" || v === "yes";
+}
+//# sourceMappingURL=hook-helpers.js.map

package/dist/src/hook-helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hook-helpers.js","sourceRoot":"","sources":["../../src/hook-helpers.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AACpD,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAElE,sEAAsE;AACtE,MAAM,UAAU,YAAY,CAAC,QAAgB,EAAE,GAAY;IACzD,IAAI,CAAC;QACH,MAAM,EAAE,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;QACpC,MAAM,GAAG,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QAC7D,MAAM,IAAI,GAAG,GAAG,EAAE,KAAK,QAAQ,KAAK,GAAG,IAAI,CAAC;QAC5C,SAAS,CAAC,OAAO,CAAC,gBAAgB,EAAE,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAC5D,cAAc,CAAC,gBAAgB,EAAE,EAAE,IAAI,CAAC,CAAC;IAC3C,CAAC;IAAC,MAAM,CAAC;QACP,8EAA8E;IAChF,CAAC;AACH,CAAC;AAED,iDAAiD;AACjD,MAAM,UAAU,cAAc;IAC5B,IAAI,CAAC;QACH,SAAS,CAAC,cAAc,EAAE,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACnD,CAAC;IAAC,MAAM,CAAC;QACP,uEAAuE;IACzE,CAAC;AACH,CAAC;AAED,iEAAiE;AACjE,MAAM,CAAC,KAAK,UAAU,aAAa;IACjC,OAAO,IAAI,OAAO,CAAW,CAAC,OAAO,EAAE,EAAE;QACvC,IAAI,GAAG,GAAG,EAAE,CAAC;QACb,OAAO,CAAC,KAAK,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;QACnC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE,EAAE,GAAG,GAAG,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;QACvD,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,EAAE,GAAG,EAAE;YAC3B,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,EAAE,CAAC;gBAAC,OAAO,CAAC,IAAI,CAAC,CAAC;gBAAC,OAAO;YAAC,CAAC;YAC3C,IAAI,CAAC;gBAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAM,CAAC,CAAC;YAAC,CAAC;YACtC,MAAM,CAAC;gBAAC,OAAO,CAAC,IAAI,CAAC,CAAC;YAAC,CAAC;QAC1B,CAAC,CAAC,CAAC;QACH,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;QAC/C,gEAAgE;QAChE,UAAU,CAAC,GAAG,EAAE;YACd,IAAI,CAAC,GAAG;gBAAE,OAAO,CAAC,IAAI,CAAC,CAAC;QAC1B,CAAC,EAAE,GAAG,CAAC,CAAC;IACV,CAAC,CAAC,CAAC;AACL,CAAC;AAED,uDAAuD;AACvD,MAAM,UAAU,aAAa;IAC3B,MAAM,CAAC,GAAG,OAAO,CAAC,GAAG,CAAC,qBAAqB,EAAE,WAAW,EAAE,CAAC,IAAI,EAAE,CAAC;IAClE,OAAO,CAAC,KAAK,MAAM,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,KAAK,CAAC;AAClD,CAAC"}