@psiclawops/hypermem 0.1.0 → 0.5.1

package/dist/content-type-classifier.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Content Type Classifier
+ *
+ * Classifies message content by signal type: decision, spec, preference,
+ * skill, attribute, discussion, ack, or noise. Used by:
+ *   - Keystone history slot (P2.1) for decisional weight scoring
+ *   - Background indexer for extraction priority
+ *   - Compaction for retention decisions
+ *
+ * Ported from ClawText content-type-classifier.ts — adapted for
+ * hypermem's NeutralMessage interface.
+ *
+ * No LLM dependency. Pure pattern matching + heuristics.
+ */
+export type ContentType = 'decision' | 'spec' | 'preference' | 'skill' | 'attribute' | 'discussion' | 'ack' | 'noise';
+export interface ContentTypeResult {
+    type: ContentType;
+    confidence: number;
+    /** Approximate half-life in days. Infinity = never decays. 0 = discard immediately. */
+    halfLifeDays: number;
+}
+/** Signal value weight for context assembly prioritization (0–1). */
+export declare const SIGNAL_WEIGHT: Record<ContentType, number>;
+/**
+ * Classify a message's content by signal type.
+ *
+ * @param content - Raw text content of the message
+ * @returns Classification with type, confidence, and decay half-life
+ */
+export declare function classifyContentType(content: string): ContentTypeResult;
+/**
+ * Convenience: classify and return the signal weight (0–1).
+ * Higher = more valuable for context retention.
+ */
+export declare function signalWeight(content: string): number;
+/**
+ * Convenience: is this message worth keeping in context?
+ * Returns false for ack and noise.
+ */
+export declare function isSignalBearing(content: string): boolean;
+//# sourceMappingURL=content-type-classifier.d.ts.map

package/dist/content-type-classifier.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"content-type-classifier.d.ts","sourceRoot":"","sources":["../src/content-type-classifier.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAIH,MAAM,MAAM,WAAW,GACnB,UAAU,GACV,MAAM,GACN,YAAY,GACZ,OAAO,GACP,WAAW,GACX,YAAY,GACZ,KAAK,GACL,OAAO,CAAC;AAEZ,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,WAAW,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,uFAAuF;IACvF,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,qEAAqE;AACrE,eAAO,MAAM,aAAa,EAAE,MAAM,CAAC,WAAW,EAAE,MAAM,CASrD,CAAC;AAwGF;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,iBAAiB,CAmDtE;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAGpD;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAGxD"}

package/dist/content-type-classifier.js

@@ -0,0 +1,181 @@
+/**
+ * Content Type Classifier
+ *
+ * Classifies message content by signal type: decision, spec, preference,
+ * skill, attribute, discussion, ack, or noise. Used by:
+ *   - Keystone history slot (P2.1) for decisional weight scoring
+ *   - Background indexer for extraction priority
+ *   - Compaction for retention decisions
+ *
+ * Ported from ClawText content-type-classifier.ts — adapted for
+ * hypermem's NeutralMessage interface.
+ *
+ * No LLM dependency. Pure pattern matching + heuristics.
+ */
+/** Signal value weight for context assembly prioritization (0–1). */
+export const SIGNAL_WEIGHT = {
+    decision: 1.0,
+    spec: 0.85,
+    preference: 0.8,
+    skill: 0.6,
+    attribute: 0.5,
+    discussion: 0.4,
+    ack: 0.0,
+    noise: 0.0,
+};
+// ─── Patterns ───────────────────────────────────────────────────
+const DECISION_PATTERNS = [
+    /\bdecided\b/i,
+    /\bthe approach is\b/i,
+    /\bwe(?:'|')ll go with\b/i,
+    /\bthe plan is\b/i,
+    /\bapproved\b/i,
+    /\bconfirmed\b/i,
+    /\bshipped\b/i,
+    /\bmerged\b/i,
+    /\bdeployed\b/i,
+    /\b(?:decision|verdict|ruling|conclusion)\s*:/i,
+    /🟢\s*GREEN/,
+    /🔴\s*RED/,
+    /🟡\s*YELLOW/,
+];
+const SPEC_PATTERNS = [
+    /```[\s\S]*?```/m,
+    /\binterface\s+[A-Za-z0-9_]+/,
+    /\btype\s+[A-Za-z0-9_]+\s*=/,
+    /\barchitecture\b/i,
+    /\bapi\b/i,
+    /\bcontract\b/i,
+    /\bschema\b/i,
+    /\bmigration\b/i,
+    /\bspec\b/i,
+];
+const PREFERENCE_PATTERNS = [
+    /\b(?:i|we)\s+(?:prefer|like|love|favor)\b/i,
+    /\bmy\s+preferred\b/i,
+    /\bpreference\b/i,
+    /\bi(?:'|')d\s+rather\b/i,
+    /\bdefault\s+to\b/i,
+    /\b(?:always|usually)\s+use\b/i,
+];
+const SKILL_PATTERNS = [
+    /\b(?:i|we)\s+(?:know|understand|can|able to)\b/i,
+    /\b(?:experienced|proficient|expert)\s+with\b/i,
+    /\b(?:skill|strength|competenc(?:y|ies))\b/i,
+    /\b(?:familiar|comfortable)\s+with\b/i,
+];
+const ATTRIBUTE_PATTERNS = [
+    /\b(?:i|we)\s+(?:am|are)\b/i,
+    /\bmy\s+(?:role|timezone|location|name|pronouns|schedule|availability)\b/i,
+    /\b(?:timezone|pronouns|role|availability|schedule)\s*:/i,
+    /\b(?:working\s+hours|hard\s+stop|deadline)\b/i,
+];
+const NOISE_PATTERNS = [
+    /\bheartbeat\b/i,
+    /\braw log\b/i,
+    /^\[[A-Z_]+\]/m,
+    /\b(system|daemon|telemetry)\s+message\b/i,
+    /\btraceback\b/i,
+    /\bstdout\b/i,
+    /\bstderr\b/i,
+    /^NO_REPLY$/,
+    /^HEARTBEAT_OK$/,
+];
+const ACK_PHRASES = new Set([
+    'ok',
+    'okay',
+    'yes',
+    'sounds good',
+    'lets do it',
+    "let's do it",
+    'perfect',
+    'nice',
+    'got it',
+    'acknowledged',
+    'roger',
+    'done',
+    'thanks',
+    'thank you',
+    'ty',
+    'lgtm',
+    '👍',
+]);
+const HALF_LIFE = {
+    decision: Number.POSITIVE_INFINITY,
+    spec: 180,
+    preference: 180,
+    skill: 120,
+    attribute: 30,
+    discussion: 60,
+    ack: 0,
+    noise: 0,
+};
+// ─── Classifier ─────────────────────────────────────────────────
+function normalized(content) {
+    return content.trim().toLowerCase().replace(/[.!?]+$/g, '');
+}
+/**
+ * Classify a message's content by signal type.
+ *
+ * @param content - Raw text content of the message
+ * @returns Classification with type, confidence, and decay half-life
+ */
+export function classifyContentType(content) {
+    const raw = String(content ?? '');
+    const body = raw.trim();
+    const lc = normalized(body);
+    if (!body) {
+        return { type: 'noise', confidence: 0.95, halfLifeDays: HALF_LIFE.noise };
+    }
+    // Noise first — fast path for system/control messages
+    if (NOISE_PATTERNS.some((rx) => rx.test(body))) {
+        return { type: 'noise', confidence: 0.85, halfLifeDays: HALF_LIFE.noise };
+    }
+    // Short acks — "ok", "sounds good", etc.
+    if (body.length < 40 && ACK_PHRASES.has(lc)) {
+        return { type: 'ack', confidence: 0.95, halfLifeDays: HALF_LIFE.ack };
+    }
+    // Decisions — highest value signal
+    if (DECISION_PATTERNS.some((rx) => rx.test(body))) {
+        return { type: 'decision', confidence: 0.9, halfLifeDays: HALF_LIFE.decision };
+    }
+    // Specs — code blocks, type definitions, architecture
+    if (SPEC_PATTERNS.some((rx) => rx.test(body))) {
+        return { type: 'spec', confidence: 0.82, halfLifeDays: HALF_LIFE.spec };
+    }
+    // Preferences — user likes, defaults
+    if (PREFERENCE_PATTERNS.some((rx) => rx.test(body))) {
+        return { type: 'preference', confidence: 0.8, halfLifeDays: HALF_LIFE.preference };
+    }
+    // Skills — capabilities, knowledge
+    if (SKILL_PATTERNS.some((rx) => rx.test(body))) {
+        return { type: 'skill', confidence: 0.78, halfLifeDays: HALF_LIFE.skill };
+    }
+    // Attributes — identity, schedule, role
+    if (ATTRIBUTE_PATTERNS.some((rx) => rx.test(body))) {
+        return { type: 'attribute', confidence: 0.72, halfLifeDays: HALF_LIFE.attribute };
+    }
+    // Questions and exploratory discussion
+    if (/\?$/.test(body) || /\b(why|how|maybe|could|should|explore|question)\b/i.test(body)) {
+        return { type: 'discussion', confidence: 0.75, halfLifeDays: HALF_LIFE.discussion };
+    }
+    // Default: generic discussion
+    return { type: 'discussion', confidence: 0.6, halfLifeDays: HALF_LIFE.discussion };
+}
+/**
+ * Convenience: classify and return the signal weight (0–1).
+ * Higher = more valuable for context retention.
+ */
+export function signalWeight(content) {
+    const { type } = classifyContentType(content);
+    return SIGNAL_WEIGHT[type];
+}
+/**
+ * Convenience: is this message worth keeping in context?
+ * Returns false for ack and noise.
+ */
+export function isSignalBearing(content) {
+    const { type } = classifyContentType(content);
+    return type !== 'ack' && type !== 'noise';
+}
+//# sourceMappingURL=content-type-classifier.js.map

package/dist/cross-agent.d.ts

@@ -49,6 +49,11 @@ export declare function visibilityFilter(requester: AgentIdentity, targetAgentId
  * in the hardcoded registry (not yet seeded to the DB) are preserved as fallback.
  */
 export declare function buildOrgRegistryFromDb(libraryDb: DatabaseSync): OrgRegistry;
+/**
+ * Alias for buildOrgRegistryFromDb — preferred name per P1.4 spec.
+ * Both names are exported for backward compatibility.
+ */
+export declare const loadOrgRegistryFromDb: typeof buildOrgRegistryFromDb;
 /**
  * Query another agent's memory with visibility-scoped access.
  * All queries go to the central library DB — no per-agent DB needed.

package/dist/cross-agent.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cross-agent.d.ts","sourceRoot":"","sources":["../src/cross-agent.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,KAAK,EACV,gBAAgB,EAChB,eAAe,EACf,aAAa,EACd,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAK1C,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;IAC/B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;CACvC;AAED;;GAEG;AACH,wBAAgB,kBAAkB,IAAI,WAAW,CA2BhD;AAID,wBAAgB,SAAS,CACvB,SAAS,EAAE,aAAa,EACxB,MAAM,EAAE,aAAa,EACrB,UAAU,EAAE,gBAAgB,EAC5B,QAAQ,EAAE,WAAW,GACpB,OAAO,CAaT;AASD,wBAAgB,gBAAgB,CAC9B,SAAS,EAAE,aAAa,EACxB,aAAa,EAAE,MAAM,EACrB,QAAQ,EAAE,WAAW,GACpB;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,cAAc,EAAE,OAAO,CAAC;IAAC,UAAU,EAAE,OAAO,CAAC;IAAC,cAAc,EAAE,OAAO,CAAA;CAAE,CA6B3F;AAID;;;;;;;;;;;;;GAaG;AACH,wBAAgB,sBAAsB,CAAC,SAAS,EAAE,YAAY,GAAG,WAAW,CAgD3E;AAID;;;GAGG;AACH,wBAAgB,eAAe,CAC7B,SAAS,EAAE,eAAe,EAC1B,KAAK,EAAE,eAAe,EACtB,QAAQ,EAAE,WAAW,GACpB,OAAO,EAAE,CAgCX"}
+{"version":3,"file":"cross-agent.d.ts","sourceRoot":"","sources":["../src/cross-agent.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,KAAK,EACV,gBAAgB,EAChB,eAAe,EACf,aAAa,EACd,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAK1C,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;IAC/B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;CACvC;AAED;;GAEG;AACH,wBAAgB,kBAAkB,IAAI,WAAW,CA2BhD;AAID,wBAAgB,SAAS,CACvB,SAAS,EAAE,aAAa,EACxB,MAAM,EAAE,aAAa,EACrB,UAAU,EAAE,gBAAgB,EAC5B,QAAQ,EAAE,WAAW,GACpB,OAAO,CAaT;AASD,wBAAgB,gBAAgB,CAC9B,SAAS,EAAE,aAAa,EACxB,aAAa,EAAE,MAAM,EACrB,QAAQ,EAAE,WAAW,GACpB;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,cAAc,EAAE,OAAO,CAAC;IAAC,UAAU,EAAE,OAAO,CAAC;IAAC,cAAc,EAAE,OAAO,CAAA;CAAE,CA6B3F;AAID;;;;;;;;;;;;;GAaG;AACH,wBAAgB,sBAAsB,CAAC,SAAS,EAAE,YAAY,GAAG,WAAW,CAgD3E;AAED;;;GAGG;AACH,eAAO,MAAM,qBAAqB,+BAAyB,CAAC;AAI5D;;;GAGG;AACH,wBAAgB,eAAe,CAC7B,SAAS,EAAE,eAAe,EAC1B,KAAK,EAAE,eAAe,EACtB,QAAQ,EAAE,WAAW,GACpB,OAAO,EAAE,CAgCX"}

package/dist/cross-agent.js

@@ -156,6 +156,11 @@ export function buildOrgRegistryFromDb(libraryDb) {
         return fallback;
     }
 }
+/**
+ * Alias for buildOrgRegistryFromDb — preferred name per P1.4 spec.
+ * Both names are exported for backward compatibility.
+ */
+export const loadOrgRegistryFromDb = buildOrgRegistryFromDb;
 // ─── Cross-Agent Query Engine ────────────────────────────────────
 /**
  * Query another agent's memory with visibility-scoped access.

package/dist/db.d.ts

@@ -1,5 +1,5 @@
 /**
- * HyperMem Database Manager
+ * hypermem Database Manager
  *
  * Three-file architecture per agent:
  *   agents/{agentId}/messages.db  — write-heavy conversation log (rotatable)

package/dist/db.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"db.d.ts","sourceRoot":"","sources":["../src/db.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAoC3C,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,MAAM,CAAC;CACjB;AAQD;;;GAGG;AACH,iBAAS,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAI9C;AAED;;;GAGG;AACH,iBAAS,uBAAuB,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAIvD;AAmBD,OAAO,EAAE,eAAe,EAAE,uBAAuB,EAAE,CAAC;AAEpD,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAmC;IAC9D,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAmC;IAC7D,OAAO,CAAC,SAAS,CAA6B;IAC9C,OAAO,CAAC,aAAa,CAAwB;IAE7C,6EAA6E;IAC7E,IAAI,YAAY,IAAI,OAAO,CAE1B;gBAEW,MAAM,CAAC,EAAE,OAAO,CAAC,qBAAqB,CAAC;IAKnD;;;OAGG;IACH,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,YAAY;IAiB3C;;;;OAIG;IACH,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,YAAY,GAAG,IAAI;IA0BjD;;;;;;OAMG;IACH,iBAAiB,IAAI,YAAY,GAAG,IAAI;IAsBxC;;;OAGG;IACH,YAAY,IAAI,YAAY;IAa5B;;;OAGG;IACH,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,YAAY;IAIzC;;OAEG;IACH,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE;QAClC,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,GAAG,CAAC,EAAE,MAAM,CAAC;KACd,GAAG,IAAI;IA2BR;;OAEG;IACH,OAAO,CAAC,gBAAgB;IA+BxB;;OAEG;IACH,UAAU,IAAI,MAAM,EAAE;IAStB;;OAEG;IACH,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM;IAKpC;;OAEG;IACH,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE;IAQzC;;OAEG;IACH,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM;IAWzC;;;;;;;;;;;;OAYG;IACH,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IA8C/C;;;;;;;OAOG;IACH,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE;QACnC,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,UAAU,CAAC,EAAE,MAAM,CAAC;KACrB,GAAG;QAAE,MAAM,EAAE,MAAM,GAAG,KAAK,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI;IA4BzE;;OAEG;IACH,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,YAAY;IAc9D;;OAEG;IACH,KAAK,IAAI,IAAI;CAgBd"}
+{"version":3,"file":"db.d.ts","sourceRoot":"","sources":["../src/db.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAqC3C,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,MAAM,CAAC;CACjB;AAQD;;;GAGG;AACH,iBAAS,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAI9C;AAED;;;GAGG;AACH,iBAAS,uBAAuB,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAIvD;AAmBD,OAAO,EAAE,eAAe,EAAE,uBAAuB,EAAE,CAAC;AAEpD,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAmC;IAC9D,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAmC;IAC7D,OAAO,CAAC,SAAS,CAA6B;IAC9C,OAAO,CAAC,aAAa,CAAwB;IAE7C,6EAA6E;IAC7E,IAAI,YAAY,IAAI,OAAO,CAE1B;gBAEW,MAAM,CAAC,EAAE,OAAO,CAAC,qBAAqB,CAAC;IAKnD;;;OAGG;IACH,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,YAAY;IAiB3C;;;;OAIG;IACH,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,YAAY,GAAG,IAAI;IA0BjD;;;;;;OAMG;IACH,iBAAiB,IAAI,YAAY,GAAG,IAAI;IAsBxC;;;OAGG;IACH,YAAY,IAAI,YAAY;IAa5B;;;OAGG;IACH,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,YAAY;IAIzC;;OAEG;IACH,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE;QAClC,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,GAAG,CAAC,EAAE,MAAM,CAAC;KACd,GAAG,IAAI;IA2BR;;OAEG;IACH,OAAO,CAAC,gBAAgB;IA+BxB;;OAEG;IACH,UAAU,IAAI,MAAM,EAAE;IAWtB;;OAEG;IACH,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM;IAKpC;;OAEG;IACH,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE;IAQzC;;OAEG;IACH,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM;IAWzC;;;;;;;;;;;;OAYG;IACH,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IA8C/C;;;;;;;OAOG;IACH,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE;QACnC,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,UAAU,CAAC,EAAE,MAAM,CAAC;KACrB,GAAG;QAAE,MAAM,EAAE,MAAM,GAAG,KAAK,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI;IA4BzE;;OAEG;IACH,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,YAAY;IAc9D;;OAEG;IACH,KAAK,IAAI,IAAI;CAgBd"}

package/dist/db.js

@@ -1,5 +1,5 @@
 /**
- * HyperMem Database Manager
+ * hypermem Database Manager
  *
  * Three-file architecture per agent:
  *   agents/{agentId}/messages.db  — write-heavy conversation log (rotatable)
@@ -14,6 +14,7 @@ import os from 'node:os';
 import path from 'node:path';
 import { migrate } from './schema.js';
 import { migrateLibrary } from './library-schema.js';
+import { ENGINE_VERSION } from './version.js';
 // sqlite-vec extension loading — optional dependency
 import { createRequire } from 'node:module';
 let sqliteVecAvailable = null;
@@ -174,7 +175,7 @@ export class DatabaseManager {
         const dbPath = path.join(this.dataDir, 'library.db');
         this.libraryDb = new DatabaseSync(dbPath);
         applyPragmas(this.libraryDb);
-        migrateLibrary(this.libraryDb);
+        migrateLibrary(this.libraryDb, ENGINE_VERSION);
         return this.libraryDb;
     }
     // ── Legacy compatibility ──────────────────────────────────────
@@ -232,7 +233,10 @@ export class DatabaseManager {
         const agentsDir = path.join(this.dataDir, 'agents');
         if (!fs.existsSync(agentsDir))
             return [];
+        const VALID_AGENT_ID = /^[a-z0-9][a-z0-9-]*$/;
         return fs.readdirSync(agentsDir).filter(f => {
+            if (!VALID_AGENT_ID.test(f))
+                return false;
             const stat = fs.statSync(path.join(agentsDir, f));
             return stat.isDirectory();
         });

package/dist/desired-state-store.d.ts

@@ -1,5 +1,5 @@
 /**
- * HyperMem Agent Desired State Store
+ * hypermem Agent Desired State Store
  *
  * Stores intended configuration for each agent and tracks drift.
  * Enables fleet-wide config visibility and enforcement.

package/dist/desired-state-store.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"desired-state-store.d.ts","sourceRoot":"","sources":["../src/desired-state-store.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAMhD,MAAM,MAAM,WAAW,GAAG,IAAI,GAAG,SAAS,GAAG,SAAS,GAAG,OAAO,CAAC;AAEjE,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,OAAO,CAAC;IACtB,WAAW,EAAE,OAAO,GAAG,IAAI,CAAC;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,WAAW,EAAE,WAAW,CAAC;IACzB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CACtB;AAED,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,OAAO,GAAG,IAAI,CAAC;IACzB,QAAQ,EAAE,OAAO,GAAG,IAAI,CAAC;IACzB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,SAAS,EAAE,MAAM,CAAC;CACnB;AA+BD,qBAAa,iBAAiB;IAChB,OAAO,CAAC,QAAQ,CAAC,EAAE;gBAAF,EAAE,EAAE,YAAY;IAE7C;;OAEG;IACH,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,YAAY,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE;QAC3E,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,GAAG,iBAAiB;IA8DrB;;;OAGG;IACH,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,WAAW,EAAE,OAAO,GAAG,WAAW;IA6BnF;;OAEG;IACH,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC;IAQhG;;OAEG;IACH,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,iBAAiB,GAAG,IAAI;IAQtE;;OAEG;IACH,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,iBAAiB,EAAE;IAQnD;;OAEG;IACH,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IASxD;;OAEG;IACH,UAAU,IAAI,iBAAiB,EAAE;IAQjC;;OAEG;IACH,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,iBAAiB,EAAE;IAQtD;;OAEG;IACH,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,EAAE,KAAK,GAAE,MAAW,GAAG,WAAW,EAAE;IAgBlF;;OAEG;IACH,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI;IAgB3E;;OAEG;IACH,eAAe,IAAI;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE;CAelG"}
+{"version":3,"file":"desired-state-store.d.ts","sourceRoot":"","sources":["../src/desired-state-store.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAMhD,MAAM,MAAM,WAAW,GAAG,IAAI,GAAG,SAAS,GAAG,SAAS,GAAG,OAAO,CAAC;AAEjE,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,OAAO,CAAC;IACtB,WAAW,EAAE,OAAO,GAAG,IAAI,CAAC;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,WAAW,EAAE,WAAW,CAAC;IACzB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CACtB;AAED,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,OAAO,GAAG,IAAI,CAAC;IACzB,QAAQ,EAAE,OAAO,GAAG,IAAI,CAAC;IACzB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,SAAS,EAAE,MAAM,CAAC;CACnB;AAyCD,qBAAa,iBAAiB;IAChB,OAAO,CAAC,QAAQ,CAAC,EAAE;gBAAF,EAAE,EAAE,YAAY;IAE7C;;OAEG;IACH,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,YAAY,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE;QAC3E,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,GAAG,iBAAiB;IA8DrB;;;OAGG;IACH,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,WAAW,EAAE,OAAO,GAAG,WAAW;IA6BnF;;OAEG;IACH,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC;IAQhG;;OAEG;IACH,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,iBAAiB,GAAG,IAAI;IAQtE;;OAEG;IACH,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,iBAAiB,EAAE;IAQnD;;OAEG;IACH,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IASxD;;OAEG;IACH,UAAU,IAAI,iBAAiB,EAAE;IAQjC;;OAEG;IACH,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,iBAAiB,EAAE;IAQtD;;OAEG;IACH,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,EAAE,KAAK,GAAE,MAAW,GAAG,WAAW,EAAE;IAgBlF;;OAEG;IACH,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI;IAgB3E;;OAEG;IACH,eAAe,IAAI;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE;CAelG"}

package/dist/desired-state-store.js

@@ -1,5 +1,5 @@
 /**
- * HyperMem Agent Desired State Store
+ * hypermem Agent Desired State Store
  *
  * Stores intended configuration for each agent and tracks drift.
  * Enables fleet-wide config visibility and enforcement.
@@ -16,12 +16,22 @@
 function nowIso() {
     return new Date().toISOString();
 }
+function tryParseJson(val) {
+    try {
+        return JSON.parse(val);
+    }
+    catch {
+        // Value is a bare string (e.g. model names like "copilot-local/claude-sonnet-4.6")
+        // stored without JSON quoting — return as-is.
+        return val;
+    }
+}
 function parseEntry(row) {
     return {
         agentId: row.agent_id,
         configKey: row.config_key,
-        desiredValue: row.desired_value ? JSON.parse(row.desired_value) : null,
-        actualValue: row.actual_value ? JSON.parse(row.actual_value) : null,
+        desiredValue: row.desired_value ? tryParseJson(row.desired_value) : null,
+        actualValue: row.actual_value ? tryParseJson(row.actual_value) : null,
         source: row.source,
         setBy: row.set_by || null,
         driftStatus: row.drift_status || 'unknown',
@@ -37,8 +47,8 @@ function parseEvent(row) {
         agentId: row.agent_id,
         configKey: row.config_key,
         eventType: row.event_type,
-        oldValue: row.old_value ? JSON.parse(row.old_value) : null,
-        newValue: row.new_value ? JSON.parse(row.new_value) : null,
+        oldValue: row.old_value ? tryParseJson(row.old_value) : null,
+        newValue: row.new_value ? tryParseJson(row.new_value) : null,
         changedBy: row.changed_by || null,
         createdAt: row.created_at,
     };

package/dist/doc-chunk-store.d.ts

@@ -1,5 +1,5 @@
 /**
- * HyperMem Document Chunk Store
+ * hypermem Document Chunk Store
  *
  * Manages doc_chunks in library.db:
  * - Atomic re-indexing by source hash (no stale/fresh coexistence)
@@ -101,6 +101,31 @@ export declare class DocChunkStore {
      * Delete all chunks for a specific source file.
      */
     deleteSource(sourcePath: string, collection: string): number;
+    /**
+     * Index simple string chunks with an optional session key (for ephemeral spawn context).
+     *
+     * Unlike indexChunks() which works with DocChunk objects and hash-based dedup,
+     * this method is designed for ad-hoc session-scoped content: it always inserts fresh
+     * rows tagged with the sessionKey, without hash-based skip logic.
+     *
+     * Chunks stored with a sessionKey are ephemeral — use clearSessionChunks() to remove them.
+     */
+    indexDocChunks(agentId: string, source: string, chunks: string[], options?: {
+        sessionKey?: string;
+    }): void;
+    /**
+     * Query doc chunks by agentId+query string, with optional session key scoping.
+     * When sessionKey is provided, only chunks tagged with that session key are returned.
+     */
+    queryDocChunks(agentId: string, query: string, options?: {
+        sessionKey?: string;
+        limit?: number;
+    }): DocChunkRow[];
+    /**
+     * Delete all doc chunks associated with a specific session key.
+     * Call this when a spawn session is complete to release ephemeral storage.
+     */
+    clearSessionChunks(sessionKey: string): number;
     /**
      * Get chunk stats: count per collection.
      */

package/dist/doc-chunk-store.d.ts.map

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

package/dist/doc-chunk-store.js

@@ -1,5 +1,5 @@
 /**
- * HyperMem Document Chunk Store
+ * hypermem Document Chunk Store
  *
  * Manages doc_chunks in library.db:
  * - Atomic re-indexing by source hash (no stale/fresh coexistence)
@@ -236,6 +236,119 @@ export class DocChunkStore {
             throw err;
         }
     }
+    /**
+     * Index simple string chunks with an optional session key (for ephemeral spawn context).
+     *
+     * Unlike indexChunks() which works with DocChunk objects and hash-based dedup,
+     * this method is designed for ad-hoc session-scoped content: it always inserts fresh
+     * rows tagged with the sessionKey, without hash-based skip logic.
+     *
+     * Chunks stored with a sessionKey are ephemeral — use clearSessionChunks() to remove them.
+     */
+    indexDocChunks(agentId, source, chunks, options) {
+        if (chunks.length === 0)
+            return;
+        const now = new Date().toISOString();
+        const sessionKey = options?.sessionKey ?? null;
+        // Use a stable collection name derived from source path
+        const collection = `spawn/${agentId}`;
+        try {
+            this.db.exec('BEGIN');
+            const insert = this.db.prepare(`
+        INSERT INTO doc_chunks
+          (id, collection, section_path, depth, content, token_estimate,
+           source_hash, source_path, scope, tier, agent_id, parent_path,
+           session_key, created_at, updated_at)
+        VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
+      `);
+            chunks.forEach((chunkContent, idx) => {
+                const id = `spawn:${agentId}:${sessionKey ?? 'none'}:${source}:${idx}:${Date.now()}`;
+                const tokenEstimate = Math.ceil(chunkContent.length / 4);
+                insert.run(id, collection, `${source}#chunk-${idx}`, 2, chunkContent, tokenEstimate, `spawn-${Date.now()}-${idx}`, // non-deduped hash
+                source, 'per-agent', null, agentId, null, sessionKey, now, now);
+            });
+            this.db.exec('COMMIT');
+        }
+        catch (err) {
+            try {
+                this.db.exec('ROLLBACK');
+            }
+            catch { /* ignore */ }
+            console.warn('[hypermem:doc-chunk-store] indexDocChunks failed:', err.message);
+        }
+    }
+    /**
+     * Query doc chunks by agentId+query string, with optional session key scoping.
+     * When sessionKey is provided, only chunks tagged with that session key are returned.
+     */
+    queryDocChunks(agentId, query, options) {
+        const limit = options?.limit ?? 10;
+        const sessionKey = options?.sessionKey;
+        const collection = `spawn/${agentId}`;
+        try {
+            if (query.trim() && query.trim().length >= 3) {
+                // FTS5 keyword search
+                let sql = `
+          SELECT c.id, c.collection, c.section_path, c.depth, c.content, c.token_estimate,
+                 c.source_hash, c.source_path, c.scope, c.tier, c.agent_id, c.parent_path,
+                 c.created_at, c.updated_at
+          FROM (
+            SELECT rowid, rank FROM doc_chunks_fts WHERE doc_chunks_fts MATCH ? ORDER BY rank LIMIT ?
+          ) sub
+          JOIN doc_chunks c ON c.rowid = sub.rowid
+          WHERE c.collection = ?
+        `;
+                const params = [query, limit * 3, collection];
+                if (sessionKey !== undefined) {
+                    sql += ' AND c.session_key = ?';
+                    params.push(sessionKey);
+                }
+                sql += ' ORDER BY sub.rank LIMIT ?';
+                params.push(limit);
+                const rows = this.db.prepare(sql).all(...params);
+                return rows.map(this.mapRow);
+            }
+            else {
+                // Fallback: return most recent chunks for this session
+                let sql = `
+          SELECT id, collection, section_path, depth, content, token_estimate,
+                 source_hash, source_path, scope, tier, agent_id, parent_path,
+                 created_at, updated_at
+          FROM doc_chunks
+          WHERE collection = ?
+        `;
+                const params = [collection];
+                if (sessionKey !== undefined) {
+                    sql += ' AND session_key = ?';
+                    params.push(sessionKey);
+                }
+                sql += ' ORDER BY created_at DESC LIMIT ?';
+                params.push(limit);
+                const rows = this.db.prepare(sql).all(...params);
+                return rows.map(this.mapRow);
+            }
+        }
+        catch (err) {
+            console.warn('[hypermem:doc-chunk-store] queryDocChunks failed:', err.message);
+            return [];
+        }
+    }
+    /**
+     * Delete all doc chunks associated with a specific session key.
+     * Call this when a spawn session is complete to release ephemeral storage.
+     */
+    clearSessionChunks(sessionKey) {
+        try {
+            const result = this.db
+                .prepare('DELETE FROM doc_chunks WHERE session_key = ?')
+                .run(sessionKey);
+            return result.changes;
+        }
+        catch (err) {
+            console.warn('[hypermem:doc-chunk-store] clearSessionChunks failed:', err.message);
+            return 0;
+        }
+    }
     /**
      * Get chunk stats: count per collection.
      */

package/dist/doc-chunker.d.ts

@@ -1,5 +1,5 @@
 /**
- * HyperMem Document Chunker
+ * hypermem Document Chunker
  *
  * Splits markdown documents into semantically coherent chunks for L3 indexing.
  *

package/dist/doc-chunker.js

@@ -1,5 +1,5 @@
 /**
- * HyperMem Document Chunker
+ * hypermem Document Chunker
  *
  * Splits markdown documents into semantically coherent chunks for L3 indexing.
  *

package/dist/dreaming-promoter.d.ts

@@ -0,0 +1,86 @@
+/**
+ * dreaming-promoter.ts
+ *
+ * hypermem-native dreaming promotion pass.
+ *
+ * Unlike the stock memory-core dreaming feature (which appends raw content to
+ * MEMORY.md), this promoter generates pointer-format entries that match the
+ * council's MEMORY.md convention:
+ *
+ *   - **{domain} — {title}:** {summary}
+ *     → `memory_search("{query}")`
+ *
+ * Scoring uses confidence, decay, recency, and domain cluster weight.
+ * Dedup prevents re-promoting topics already covered by existing pointers.
+ *
+ * Dry-run mode returns what would be written without modifying any files.
+ */
+import type { DatabaseSync } from 'node:sqlite';
+export interface DreamerConfig {
+    /** Enable the promotion pass. Default: false */
+    enabled: boolean;
+    /** Minimum composite score for promotion. Default: 0.70 */
+    minScore: number;
+    /** Minimum confidence threshold (pre-scoring). Default: 0.70 */
+    minConfidence: number;
+    /** Max new pointer entries to write per agent per run. Default: 5 */
+    maxPromotionsPerRun: number;
+    /** How often to run: every N indexer ticks. Default: 12 (~1hr at 5min interval) */
+    tickInterval: number;
+    /** Preview what would be promoted without writing. Default: false */
+    dryRun: boolean;
+    /** Recency half-life in days (score decays to 0.5 at this age). Default: 14 */
+    recencyHalfLifeDays: number;
+    /** Max age in days to consider a fact. Default: 90 */
+    maxAgeDays: number;
+}
+export declare const DEFAULT_DREAMER_CONFIG: DreamerConfig;
+export interface FactCandidate {
+    id: number;
+    agentId: string;
+    domain: string;
+    content: string;
+    confidence: number;
+    decayScore: number;
+    ageDays: number;
+    score: number;
+}
+export interface PromotionEntry {
+    factId: number;
+    domain: string;
+    pointer: string;
+    title: string;
+    summary: string;
+    query: string;
+    score: number;
+    dryRun: boolean;
+}
+export interface DreamerResult {
+    agentId: string;
+    candidates: number;
+    promoted: number;
+    skippedDuplicate: number;
+    skippedThreshold: number;
+    entries: PromotionEntry[];
+    memoryPath: string | null;
+    dryRun: boolean;
+}
+/**
+ * Resolve the workspace directory for an agent.
+ * Council agents live at ~/.openclaw/workspace-council/{agentId}/
+ * Other agents at ~/.openclaw/workspace/{agentId}/
+ */
+export declare function resolveAgentWorkspacePath(agentId: string): Promise<string | null>;
+/**
+ * Run the dreaming promotion pass for a single agent.
+ *
+ * Reads qualified facts from library.db, scores them, deduplicates against
+ * existing MEMORY.md pointers, and writes new pointer entries.
+ */
+export declare function runDreamingPromoter(agentId: string, libraryDb: DatabaseSync, config?: Partial<DreamerConfig>): Promise<DreamerResult>;
+/**
+ * Run the dreaming promotion pass for all agents in a fleet.
+ * Called from the BackgroundIndexer on every N ticks.
+ */
+export declare function runDreamingPassForFleet(agentIds: string[], libraryDb: DatabaseSync, config?: Partial<DreamerConfig>): Promise<DreamerResult[]>;
+//# sourceMappingURL=dreaming-promoter.d.ts.map

package/dist/dreaming-promoter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dreaming-promoter.d.ts","sourceRoot":"","sources":["../src/dreaming-promoter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAKH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAIhD,MAAM,WAAW,aAAa;IAC5B,gDAAgD;IAChD,OAAO,EAAE,OAAO,CAAC;IACjB,2DAA2D;IAC3D,QAAQ,EAAE,MAAM,CAAC;IACjB,gEAAgE;IAChE,aAAa,EAAE,MAAM,CAAC;IACtB,qEAAqE;IACrE,mBAAmB,EAAE,MAAM,CAAC;IAC5B,mFAAmF;IACnF,YAAY,EAAE,MAAM,CAAC;IACrB,qEAAqE;IACrE,MAAM,EAAE,OAAO,CAAC;IAChB,+EAA+E;IAC/E,mBAAmB,EAAE,MAAM,CAAC;IAC5B,sDAAsD;IACtD,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,eAAO,MAAM,sBAAsB,EAAE,aASpC,CAAC;AAIF,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,gBAAgB,EAAE,MAAM,CAAC;IACzB,gBAAgB,EAAE,MAAM,CAAC;IACzB,OAAO,EAAE,cAAc,EAAE,CAAC;IAC1B,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,MAAM,EAAE,OAAO,CAAC;CACjB;AAID;;;;GAIG;AACH,wBAAsB,yBAAyB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAgBvF;AA2ND;;;;;GAKG;AACH,wBAAsB,mBAAmB,CACvC,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,YAAY,EACvB,MAAM,GAAE,OAAO,CAAC,aAAa,CAAM,GAClC,OAAO,CAAC,aAAa,CAAC,CAgJxB;AAED;;;GAGG;AACH,wBAAsB,uBAAuB,CAC3C,QAAQ,EAAE,MAAM,EAAE,EAClB,SAAS,EAAE,YAAY,EACvB,MAAM,GAAE,OAAO,CAAC,aAAa,CAAM,GAClC,OAAO,CAAC,aAAa,EAAE,CAAC,CAa1B"}