@psiclawops/hypermem 0.5.5 → 0.6.2

package/dist/profiles.js

@@ -24,6 +24,14 @@ const BASE_EMBEDDING = {
     timeout: 10000,
     batchSize: 32,
 };
+/** Gemini embedding preset — use with mergeProfile() when switching fleet to Gemini. */
+export const GEMINI_EMBEDDING = {
+    provider: 'gemini',
+    model: 'gemini-embedding-2-preview',
+    dimensions: 3072,
+    timeout: 15000,
+    batchSize: 100,
+};
 // ---------------------------------------------------------------------------
 // light — 64k context window, single agent, constrained resources
 //
@@ -32,28 +40,37 @@ const BASE_EMBEDDING = {
 //   - Single agent — no cross-session context needed
 //   - Minimal ACA stack — no dreaming, no background indexing overhead
 //   - Low Redis churn — longer flush intervals, shorter history window
-//   - outputProfile: 'light' — ~100 token standalone directives, no fleet concepts
+//   - hyperformProfile: 'light' — ~100 token standalone directives, no fleet concepts
 //   - No parallel operations — sequential fact extraction only
 // ---------------------------------------------------------------------------
 const LIGHT_COMPOSITOR = {
-    defaultTokenBudget: 40000, // leaves ~24k for model output at 64k window
-    maxHistoryMessages: 200, // keep window tight — small models lose coherence past ~150 msgs
-    maxFacts: 15, // surface top facts only, don't swamp the window
-    maxCrossSessionContext: 0, // single agent — no cross-session
-    maxRecentToolPairs: 2, // minimal tool history
+    // ── Primary budget controls ──
+    budgetFraction: 0.625, // 40k effective at 64k window
+    reserveFraction: 0.35, // generous — small systems do heavy tool work
+    historyFraction: 0.35, // ~14k tokens of conversation history
+    memoryFraction: 0.30, // ~12k tokens for facts/wiki/semantic
+    // ── Absolute fallback ──
+    defaultTokenBudget: 40000,
+    // ── History internals ──
+    maxHistoryMessages: 200,
+    warmHistoryBudgetFraction: 0.35,
+    keystoneHistoryFraction: 0.1,
+    keystoneMaxMessages: 5,
+    keystoneMinSignificance: 0.7,
+    // ── Memory internals ──
+    maxFacts: 15,
+    maxCrossSessionContext: 0,
+    maxTotalTriggerTokens: 1500,
+    wikiTokenCap: 300,
+    // ── Tool gradient (internal — safe floor enforced automatically) ──
+    maxRecentToolPairs: 2,
     maxProseToolPairs: 4,
-    warmHistoryBudgetFraction: 0.35, // slightly less history, more room for context
-    contextWindowReserve: 0.35, // generous reserve — small models need output headroom
+    // ── Dynamic reserve ──
     dynamicReserveEnabled: true,
-    dynamicReserveTurnHorizon: 3, // shorter horizon — small sessions
+    dynamicReserveTurnHorizon: 3,
     dynamicReserveMax: 0.50,
-    keystoneHistoryFraction: 0.1, // light keystone — history window is already small
-    keystoneMaxMessages: 5,
-    keystoneMinSignificance: 0.7, // higher bar — only high-signal keystone messages
-    targetBudgetFraction: 0.50, // Anvil spec: 0.50 for light
-    maxTotalTriggerTokens: 1500, // tight trigger ceiling
-    outputProfile: 'light', // standalone density directives only, no fleet concepts
-    wikiTokenCap: 300, // Anvil spec: 300 for light
+    // ── HyperForm ──
+    hyperformProfile: 'light',
 };
 const LIGHT_INDEXER = {
     enabled: true,
@@ -87,27 +104,36 @@ export const lightProfile = {
 //   - Mid-range models (Sonnet, GPT-5-mini, Gemini Flash) at 128k
 //   - Small multi-agent setups or single power-user agents
 //   - Full ACA stack — dreaming optional, background indexing on
-//   - outputProfile: 'standard' — full FOS, no MOD
+//   - hyperformProfile: 'standard' — full FOS, no MOD
 // ---------------------------------------------------------------------------
 const STANDARD_COMPOSITOR = {
+    // ── Primary budget controls ──
+    budgetFraction: 0.703, // 90k effective at 128k window
+    reserveFraction: 0.25, // balanced — leaves room for large tool results
+    historyFraction: 0.40, // ~27k tokens of conversation history
+    memoryFraction: 0.40, // ~27k tokens for facts/wiki/semantic
+    // ── Absolute fallback ──
     defaultTokenBudget: 90000,
+    // ── History internals ──
     maxHistoryMessages: 500,
+    warmHistoryBudgetFraction: 0.40,
+    keystoneHistoryFraction: 0.20,
+    keystoneMaxMessages: 15,
+    keystoneMinSignificance: 0.5,
+    // ── Memory internals ──
     maxFacts: 30,
     maxCrossSessionContext: 4000,
+    maxTotalTriggerTokens: 4000,
+    wikiTokenCap: 600,
+    // ── Tool gradient (internal — safe floor enforced automatically) ──
     maxRecentToolPairs: 3,
     maxProseToolPairs: 10,
-    warmHistoryBudgetFraction: 0.40,
-    contextWindowReserve: 0.25,
+    // ── Dynamic reserve ──
     dynamicReserveEnabled: true,
     dynamicReserveTurnHorizon: 5,
     dynamicReserveMax: 0.50,
-    keystoneHistoryFraction: 0.20,
-    keystoneMaxMessages: 15,
-    keystoneMinSignificance: 0.5,
-    targetBudgetFraction: 0.65, // Anvil spec: 0.65 for standard
-    maxTotalTriggerTokens: 4000,
-    outputProfile: 'standard', // full FOS, MOD suppressed
-    wikiTokenCap: 600, // Anvil spec: 600 for standard
+    // ── HyperForm ──
+    hyperformProfile: 'standard',
 };
 const STANDARD_INDEXER = {
     enabled: true,
@@ -135,28 +161,37 @@ export const standardProfile = {
 //   - Large context models (Opus, GPT-5.4, Gemini Pro) at 200k+
 //   - Council / multi-agent fleet deployments
 //   - Full ACA stack including dreaming, background indexing, cross-session
-//   - outputProfile: 'full' — FOS + MOD, full spec
+//   - hyperformProfile: 'full' — FOS + MOD, full spec
 //   - Higher keystone threshold — more historical context worth surfacing
 // ---------------------------------------------------------------------------
 const EXTENDED_COMPOSITOR = {
+    // ── Primary budget controls ──
+    budgetFraction: 0.588, // 160k effective at 272k window
+    reserveFraction: 0.20, // tighter — large windows have natural headroom
+    historyFraction: 0.45, // ~72k tokens of conversation history
+    memoryFraction: 0.40, // ~64k tokens for facts/wiki/semantic
+    // ── Absolute fallback ──
     defaultTokenBudget: 160000,
+    // ── History internals ──
     maxHistoryMessages: 1000,
+    warmHistoryBudgetFraction: 0.45,
+    keystoneHistoryFraction: 0.25,
+    keystoneMaxMessages: 30,
+    keystoneMinSignificance: 0.4,
+    // ── Memory internals ──
     maxFacts: 60,
     maxCrossSessionContext: 12000,
+    maxTotalTriggerTokens: 10000,
+    wikiTokenCap: 800,
+    // ── Tool gradient (internal — safe floor enforced automatically) ──
     maxRecentToolPairs: 5,
     maxProseToolPairs: 15,
-    warmHistoryBudgetFraction: 0.45,
-    contextWindowReserve: 0.20,
+    // ── Dynamic reserve ──
     dynamicReserveEnabled: true,
     dynamicReserveTurnHorizon: 7,
     dynamicReserveMax: 0.45,
-    keystoneHistoryFraction: 0.25,
-    keystoneMaxMessages: 30,
-    keystoneMinSignificance: 0.4,
-    targetBudgetFraction: 0.55, // Anvil spec: 0.55 for extended (history is huge, budget carefully)
-    maxTotalTriggerTokens: 10000,
-    outputProfile: 'full', // FOS + MOD — full fleet spec
-    wikiTokenCap: 800, // Anvil spec: 800 for extended
+    // ── HyperForm ──
+    hyperformProfile: 'full',
 };
 const EXTENDED_INDEXER = {
     enabled: true,
@@ -210,7 +245,7 @@ export function getProfile(name) {
  * @example
  * const config = mergeProfile('light', {
  *   cache: { keyPrefix: 'myapp:' },
- *   compositor: { outputProfile: 'standard' },  // upgrade tier
+ *   compositor: { hyperformProfile: 'standard', memoryFraction: 0.50 },  // upgrade tier + more memory
  * });
  */
 export function mergeProfile(name, overrides) {

package/dist/repair-tool-pairs.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"repair-tool-pairs.d.ts","sourceRoot":"","sources":["../src/repair-tool-pairs.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,KAAK,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAE1C;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,UAAU,EAAE,GAAG,UAAU,EAAE,CAmHpE"}
+{"version":3,"file":"repair-tool-pairs.d.ts","sourceRoot":"","sources":["../src/repair-tool-pairs.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,KAAK,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAE1C;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,UAAU,EAAE,GAAG,UAAU,EAAE,CA0LpE"}

package/dist/repair-tool-pairs.js

@@ -129,9 +129,80 @@ export function repairToolPairs(messages) {
         }
         result.push(msg);
     }
+    // ── Pass 4: Intra-message content block integrity ─────────────────────────
+    // Anthropic requires that every tool_result content block in a user message
+    // references a tool_use_id that exists in the IMMEDIATELY PRECEDING assistant
+    // message's content blocks. Pass 3 only checks global existence. This pass
+    // enforces adjacency.
+    let intraBlockDropped = 0;
+    for (let i = 0; i < result.length; i++) {
+        const msg = result[i];
+        if (msg.role !== 'user' || !Array.isArray(msg.content))
+            continue;
+        const content = msg.content;
+        const hasToolResultBlocks = content.some(b => b.type === 'tool_result');
+        if (!hasToolResultBlocks)
+            continue;
+        // Find the immediately preceding assistant message
+        let precedingAssistant = null;
+        for (let j = i - 1; j >= 0; j--) {
+            if (result[j].role === 'assistant') {
+                precedingAssistant = result[j];
+                break;
+            }
+        }
+        // Collect tool_use IDs from the preceding assistant message only
+        const adjacentCallIds = new Set();
+        if (precedingAssistant) {
+            // Content array format
+            if (Array.isArray(precedingAssistant.content)) {
+                for (const block of precedingAssistant.content) {
+                    if ((block.type === 'toolCall' || block.type === 'tool_use') &&
+                        typeof block.id === 'string' && block.id) {
+                        adjacentCallIds.add(block.id);
+                    }
+                }
+            }
+            // NeutralMessage format
+            if (Array.isArray(precedingAssistant.toolCalls)) {
+                for (const tc of precedingAssistant.toolCalls) {
+                    if (typeof tc.id === 'string' && tc.id)
+                        adjacentCallIds.add(tc.id);
+                }
+            }
+        }
+        // Also check pi-agent ToolResultMessages that reference the preceding assistant
+        // (these are message-level, not content-block level — skip for adjacency check)
+        // Filter: keep tool_result blocks only if their tool_use_id is in the
+        // immediately preceding assistant message
+        const filteredContent = content.filter(block => {
+            if (block.type !== 'tool_result')
+                return true;
+            const toolUseId = typeof block.tool_use_id === 'string' ? block.tool_use_id : '';
+            if (!toolUseId)
+                return false; // malformed, drop
+            if (adjacentCallIds.has(toolUseId))
+                return true;
+            intraBlockDropped++;
+            return false;
+        });
+        if (filteredContent.length === 0) {
+            // All content blocks were orphaned — remove the message entirely
+            result.splice(i, 1);
+            i--; // re-check this index
+        }
+        else if (filteredContent.length !== content.length) {
+            result[i] = { ...msg, content: filteredContent };
+        }
+    }
     const dropped = messages.length - result.length;
-    if (dropped > 0) {
-        console.log(`[hypermem] repairToolPairs: dropped ${dropped} orphaned message(s) (${messages.length} → ${result.length})`);
+    if (dropped > 0 || intraBlockDropped > 0) {
+        const parts = [];
+        if (dropped > 0)
+            parts.push(`${dropped} orphaned message(s)`);
+        if (intraBlockDropped > 0)
+            parts.push(`${intraBlockDropped} intra-message orphaned content block(s)`);
+        console.log(`[hypermem] repairToolPairs: dropped ${parts.join(' + ')} (${messages.length} → ${result.length})`);
     }
     return result;
 }

package/dist/schema.d.ts

@@ -6,7 +6,7 @@
  * Contains ONLY conversation data — structured knowledge lives in library.db.
  */
 import type { DatabaseSync } from 'node:sqlite';
-export declare const LATEST_SCHEMA_VERSION = 6;
+export declare const LATEST_SCHEMA_VERSION = 8;
 /**
  * Run migrations on an agent message database.
  */

package/dist/schema.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../src/schema.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEhD,eAAO,MAAM,qBAAqB,IAAI,CAAC;AAgJvC;;GAEG;AACH,wBAAgB,OAAO,CAAC,EAAE,EAAE,YAAY,GAAG,IAAI,CA4F9C;AAED,OAAO,EAAE,qBAAqB,IAAI,cAAc,EAAE,CAAC"}
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../src/schema.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEhD,eAAO,MAAM,qBAAqB,IAAI,CAAC;AAgJvC;;GAEG;AACH,wBAAgB,OAAO,CAAC,EAAE,EAAE,YAAY,GAAG,IAAI,CA0H9C;AAED,OAAO,EAAE,qBAAqB,IAAI,cAAc,EAAE,CAAC"}

package/dist/schema.js

@@ -5,7 +5,7 @@
  * Write-heavy, temporal, rotatable.
  * Contains ONLY conversation data — structured knowledge lives in library.db.
  */
-export const LATEST_SCHEMA_VERSION = 6;
+export const LATEST_SCHEMA_VERSION = 8;
 function nowIso() {
     return new Date().toISOString();
 }
@@ -224,6 +224,32 @@ export function migrate(db) {
         db.prepare('INSERT OR IGNORE INTO schema_version (version, applied_at) VALUES (?, ?)')
             .run(6, nowIso());
     }
+    // v6 → v7: Turn DAG Phase 2 — add parent_id and depth to messages
+    if (currentVersion < 7) {
+        const msgCols = db.prepare('PRAGMA table_info(messages)').all()
+            .map(r => r.name);
+        if (!msgCols.includes('parent_id')) {
+            db.exec('ALTER TABLE messages ADD COLUMN parent_id INTEGER REFERENCES messages(id)');
+        }
+        if (!msgCols.includes('depth')) {
+            db.exec('ALTER TABLE messages ADD COLUMN depth INTEGER NOT NULL DEFAULT 0');
+        }
+        db.exec('CREATE INDEX IF NOT EXISTS idx_messages_parent_id ON messages(parent_id)');
+        db.prepare('INSERT OR IGNORE INTO schema_version (version, applied_at) VALUES (?, ?)')
+            .run(7, nowIso());
+    }
+    // v7 → v8: Turn DAG Phase 3 — add context_id index for DAG-native reads
+    // Also ensures context_id column exists (idempotent with ensureContextSchema)
+    if (currentVersion < 8) {
+        const msgCols8 = db.prepare('PRAGMA table_info(messages)').all()
+            .map(r => r.name);
+        if (!msgCols8.includes('context_id')) {
+            db.exec('ALTER TABLE messages ADD COLUMN context_id INTEGER');
+        }
+        db.exec('CREATE INDEX IF NOT EXISTS idx_messages_context_id ON messages(context_id)');
+        db.prepare('INSERT OR IGNORE INTO schema_version (version, applied_at) VALUES (?, ?)')
+            .run(8, nowIso());
+    }
 }
 export { LATEST_SCHEMA_VERSION as SCHEMA_VERSION };
 //# sourceMappingURL=schema.js.map

package/dist/seed.d.ts

@@ -6,7 +6,7 @@
  *
  * Usage:
  *   const seeder = new WorkspaceSeeder(hypermem);
- *   const result = await seeder.seedWorkspace('/path/to/workspace', { agentId: 'forge' });
+ *   const result = await seeder.seedWorkspace('/path/to/workspace', { agentId: 'agent1' });
  *
  * Idempotent: skips files whose source hash hasn't changed since last index.
  * Atomic: each file's chunks are swapped in a single transaction.

package/dist/seed.js

@@ -6,7 +6,7 @@
  *
  * Usage:
  *   const seeder = new WorkspaceSeeder(hypermem);
- *   const result = await seeder.seedWorkspace('/path/to/workspace', { agentId: 'forge' });
+ *   const result = await seeder.seedWorkspace('/path/to/workspace', { agentId: 'agent1' });
  *
  * Idempotent: skips files whose source hash hasn't changed since last index.
  * Atomic: each file's chunks are swapped in a single transaction.

package/dist/session-flusher.d.ts

@@ -33,8 +33,8 @@ export interface FlushSessionResult {
  * from those stores naturally.
  *
  * @param cache   Connected CacheLayer instance
- * @param agentId Agent identifier (e.g. "forge")
- * @param sessionKey  Full session key (e.g. "agent:forge:webchat:scratchpad")
+ * @param agentId Agent identifier (e.g. "agent1")
+ * @param sessionKey  Full session key (e.g. "agent:agent1:webchat:scratchpad")
  * @param opts    Optional flags
  */
 export declare function flushSession(cache: CacheLayer, agentId: string, sessionKey: string, opts?: FlushSessionOptions): Promise<FlushSessionResult>;

package/dist/session-flusher.js

@@ -18,8 +18,8 @@
  * from those stores naturally.
  *
  * @param cache   Connected CacheLayer instance
- * @param agentId Agent identifier (e.g. "forge")
- * @param sessionKey  Full session key (e.g. "agent:forge:webchat:scratchpad")
+ * @param agentId Agent identifier (e.g. "agent1")
+ * @param sessionKey  Full session key (e.g. "agent:agent1:webchat:scratchpad")
  * @param opts    Optional flags
  */
 export async function flushSession(cache, agentId, sessionKey, opts = {}) {

package/dist/spawn-context.d.ts

@@ -6,7 +6,7 @@
  *
  * Usage:
  *   const ctx = await buildSpawnContext(messageStore, docChunkStore, agentId, {
- *     parentSessionKey: 'agent:forge:webchat:main',
+ *     parentSessionKey: 'agent:agent1:webchat:main',
  *     workingSnapshot: 10,
  *     documents: ['/path/to/spec.md'],
  *   });

package/dist/spawn-context.js

@@ -6,7 +6,7 @@
  *
  * Usage:
  *   const ctx = await buildSpawnContext(messageStore, docChunkStore, agentId, {
- *     parentSessionKey: 'agent:forge:webchat:main',
+ *     parentSessionKey: 'agent:agent1:webchat:main',
  *     workingSnapshot: 10,
  *     documents: ['/path/to/spec.md'],
  *   });

package/dist/topic-synthesizer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"topic-synthesizer.d.ts","sourceRoot":"","sources":["../src/topic-synthesizer.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAMhD,QAAA,MAAM,uBAAuB,KAAK,CAAC;AACnC,QAAA,MAAM,sBAAsB,IAAI,CAAC;AACjC,QAAA,MAAM,4BAA4B,IAAI,CAAC;AACvC,QAAA,MAAM,2BAA2B,MAAM,CAAC;AACxC,QAAA,MAAM,uBAAuB,KAAK,CAAC;AACnC,QAAA,MAAM,uBAAuB,IAAI,CAAC;AAClC,QAAA,MAAM,cAAc,KAAK,CAAC;AAC1B,QAAA,MAAM,eAAe,IAAI,CAAC;AAG1B,OAAO,EACL,uBAAuB,EACvB,sBAAsB,EACtB,4BAA4B,EAC5B,2BAA2B,EAC3B,uBAAuB,EACvB,uBAAuB,EACvB,cAAc,EACd,eAAe,GAChB,CAAC;AAIF,MAAM,WAAW,eAAe;IAC9B,uBAAuB,EAAE,MAAM,CAAC;IAChC,sBAAsB,EAAE,MAAM,CAAC;IAC/B,4BAA4B,EAAE,MAAM,CAAC;IACrC,2BAA2B,EAAE,MAAM,CAAC;IACpC,uBAAuB,EAAE,MAAM,CAAC;IAChC,uBAAuB,EAAE,MAAM,CAAC;IAChC,cAAc,EAAE,MAAM,CAAC;IACvB,eAAe,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,eAAe;IAC9B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,aAAa,EAAE,MAAM,CAAC;IACtB,uBAAuB,EAAE,MAAM,CAAC;CACjC;AA6HD,qBAAa,gBAAgB;IAIzB,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,YAAY;IAC7B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC;IAL1B,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAkB;gBAG/B,SAAS,EAAE,YAAY,EACvB,YAAY,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,YAAY,GAAG,IAAI,EACtD,MAAM,CAAC,EAAE,OAAO,CAAC,eAAe,CAAC,YAAA;IAcpD;;;OAGG;IACH,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,eAAe;IAkFtC;;OAEG;IACH,OAAO,CAAC,eAAe;CA+GxB"}
+{"version":3,"file":"topic-synthesizer.d.ts","sourceRoot":"","sources":["../src/topic-synthesizer.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAMhD,QAAA,MAAM,uBAAuB,KAAK,CAAC;AACnC,QAAA,MAAM,sBAAsB,IAAI,CAAC;AACjC,QAAA,MAAM,4BAA4B,IAAI,CAAC;AACvC,QAAA,MAAM,2BAA2B,MAAM,CAAC;AACxC,QAAA,MAAM,uBAAuB,KAAK,CAAC;AACnC,QAAA,MAAM,uBAAuB,IAAI,CAAC;AAClC,QAAA,MAAM,cAAc,KAAK,CAAC;AAC1B,QAAA,MAAM,eAAe,IAAI,CAAC;AAG1B,OAAO,EACL,uBAAuB,EACvB,sBAAsB,EACtB,4BAA4B,EAC5B,2BAA2B,EAC3B,uBAAuB,EACvB,uBAAuB,EACvB,cAAc,EACd,eAAe,GAChB,CAAC;AAIF,MAAM,WAAW,eAAe;IAC9B,uBAAuB,EAAE,MAAM,CAAC;IAChC,sBAAsB,EAAE,MAAM,CAAC;IAC/B,4BAA4B,EAAE,MAAM,CAAC;IACrC,2BAA2B,EAAE,MAAM,CAAC;IACpC,uBAAuB,EAAE,MAAM,CAAC;IAChC,uBAAuB,EAAE,MAAM,CAAC;IAChC,cAAc,EAAE,MAAM,CAAC;IACvB,eAAe,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,eAAe;IAC9B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,aAAa,EAAE,MAAM,CAAC;IACtB,uBAAuB,EAAE,MAAM,CAAC;CACjC;AA6HD,qBAAa,gBAAgB;IAIzB,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,YAAY;IAC7B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC;IAL1B,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAkB;gBAG/B,SAAS,EAAE,YAAY,EACvB,YAAY,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,YAAY,GAAG,IAAI,EACtD,MAAM,CAAC,EAAE,OAAO,CAAC,eAAe,CAAC,YAAA;IAcpD;;;OAGG;IACH,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,eAAe;IAmFtC;;OAEG;IACH,OAAO,CAAC,eAAe;CA+GxB"}

package/dist/topic-synthesizer.js

@@ -35,7 +35,7 @@ function keystoneScore(msg) {
     const backtickMatches = text.match(/`[^`]+`/g) || [];
     score += backtickMatches.length * 0.2;
     // Agent mentions (known patterns)
-    const agentMentions = text.match(/\b(forge|compass|clarity|sentinel|vanguard|anvil|pylon|vigil|bastion|relay|crucible)\b/gi) || [];
+    const agentMentions = text.match(/\b(agent1|agent2|agent4|agent3|agent5|agent6|director1|director2|director7|specialist2|specialist1)\b/gi) || [];
     score += agentMentions.length * 0.25;
     // Quoted content
     const quotedMatches = text.match(/"[^"]{10,}"/g) || [];
@@ -155,9 +155,10 @@ export class TopicSynthesizer {
         SELECT * FROM topics
         WHERE agent_id = ?
           AND message_count >= ?
-          AND updated_at < datetime('now', '-${staleThresholdMinutes} minutes')
+          AND updated_at < datetime('now', '-' || ? || ' minutes')
+          -- safe: staleThresholdMinutes is a validated integer
         ORDER BY updated_at ASC
-      `).all(agentId, cfg.SYNTHESIS_MIN_MESSAGES);
+      `).all(agentId, cfg.SYNTHESIS_MIN_MESSAGES, Math.floor(staleThresholdMinutes));
         }
         catch {
             return result;

package/dist/trigger-registry.d.ts

@@ -39,7 +39,7 @@ export interface CollectionTrigger {
 export declare const TRIGGER_REGISTRY_VERSION = "1.0.0";
 /**
  * Default trigger registry for standard ACA collections.
- * Covers the core ACA offload use case from Anvil's spec.
+ * Covers the core ACA offload use case from agent6's spec.
  */
 export declare const TRIGGER_REGISTRY: CollectionTrigger[];
 /** Backward-compat alias — same reference as TRIGGER_REGISTRY */

package/dist/trigger-registry.js

@@ -13,7 +13,7 @@ import { createHash } from 'node:crypto';
 export const TRIGGER_REGISTRY_VERSION = '1.0.0';
 /**
  * Default trigger registry for standard ACA collections.
- * Covers the core ACA offload use case from Anvil's spec.
+ * Covers the core ACA offload use case from agent6's spec.
  */
 export const TRIGGER_REGISTRY = [
     {
@@ -61,7 +61,7 @@ export const TRIGGER_REGISTRY = [
         ],
         maxTokens: 800,
         maxChunks: 2,
-        owner: 'forge',
+        owner: 'agent1',
         category: 'operations',
         description: 'Agent operational procedures: boot sequence, heartbeat, work queue, session startup',
     },
@@ -98,7 +98,7 @@ export const TRIGGER_REGISTRY = [
         ],
         maxTokens: 1500,
         maxChunks: 4,
-        owner: 'forge',
+        owner: 'agent1',
         category: 'memory',
         description: 'Decision history: past choices, previously agreed approaches, recalled context',
     },
@@ -124,7 +124,7 @@ export const TRIGGER_REGISTRY = [
         ],
         maxTokens: 1200,
         maxChunks: 3,
-        owner: 'forge',
+        owner: 'agent1',
         category: 'operations',
         description: 'Agent tooling reference: CLI commands, config paths, deployment procedures, quick reference',
     },

package/dist/types.d.ts

@@ -70,7 +70,7 @@ export type FactScope = 'agent' | 'session' | 'user';
 /**
  * Memory visibility levels:
  * - private:  Only the owning agent can read. Identity, SOUL, personal reflections.
- * - org:      Agents in the same org (e.g., Forge's directors: Pylon, Vigil, Plane).
+ * - org:      Agents in the same org (e.g., agent1's directors: Pylon, Vigil, Plane).
  * - council:  All council seats can read.
  * - fleet:    Any agent in the fleet can read.
  */
@@ -218,6 +218,12 @@ export interface ComposeRequest {
      * P3.4: topic-aware compositor.
      */
     topicId?: string;
+    /**
+     * When true, skip the C4 window cache fast-exit even if the cursor is fresh.
+     * Use this when external L4 state changed between turns, for example facts,
+     * wiki pages, or other library-backed context updated out of band.
+     */
+    skipWindowCache?: boolean;
 }
 export interface SlotTokenCounts {
     system: number;
@@ -262,6 +268,12 @@ export interface ComposeDiagnostics {
     dynamicReserveActive?: boolean;
     /** True if dynamic reserve was clamped at dynamicReserveMax and SESSION_PRESSURE_HIGH emitted */
     sessionPressureHigh?: boolean;
+    /** Number of items filtered across all dedup paths (temporal, open-domain, semantic, cross-session) */
+    fingerprintDedups?: number;
+    /** Number of duplicate-prefix matches where the full normalized content differed */
+    fingerprintCollisions?: number;
+    /** True when the window cache fast-exit fired and full compose was skipped */
+    windowCacheHit?: boolean;
 }
 export interface ComposeResult {
     messages: ProviderMessage[];
@@ -297,7 +309,7 @@ export interface ProviderMessage {
  * to identify high-signal unprocessed messages.
  *
  * Stored in Redis (hm:{a}:s:{s}:cursor) with dual-write to SQLite for
- * durability across Redis eviction (Compass Gate 2).
+ * durability across Redis eviction (agent2 Gate 2).
  */
 export interface SessionCursor {
     /** StoredMessage.id of the newest message included in the last window */
@@ -356,13 +368,21 @@ export interface EmbeddingProviderConfig {
      * - 'ollama': local Ollama (nomic-embed-text or any pulled model)
      * - 'openai': OpenAI Embeddings API (text-embedding-3-small / 3-large)
      */
-    provider?: 'ollama' | 'openai';
+    provider?: 'ollama' | 'openai' | 'gemini';
     /** Ollama base URL. Default: http://localhost:11434 */
     ollamaUrl: string;
     /** OpenAI API key. Required when provider is 'openai'. */
     openaiApiKey?: string;
     /** OpenAI base URL. Default: https://api.openai.com/v1 */
     openaiBaseUrl?: string;
+    /** Gemini API key. Alternative to OAuth — passed as ?key= query param. */
+    geminiApiKey?: string;
+    /** Gemini API base URL. Default: https://generativelanguage.googleapis.com */
+    geminiBaseUrl?: string;
+    /** Gemini task type for indexing. Default: RETRIEVAL_DOCUMENT */
+    geminiIndexTaskType?: string;
+    /** Gemini task type for queries. Default: RETRIEVAL_QUERY */
+    geminiQueryTaskType?: string;
     /**
      * Embedding model name.
      * - ollama default: nomic-embed-text (768d)
@@ -390,17 +410,51 @@ export interface CacheConfig {
 /** @deprecated Use CacheConfig */
 export type RedisConfig = CacheConfig;
 export interface CompositorConfig {
+    /**
+     * Fraction of the detected context window to use as the input token budget.
+     * The effective budget is: detectedContextWindow × budgetFraction.
+     * reserveFraction is then subtracted for output/tool-call headroom.
+     *
+     * Range: 0.3–0.85. Default: 0.70
+     */
+    budgetFraction?: number;
+    /**
+     * Fraction of the total token budget to reserve for model output and tool
+     * call responses. Higher = more headroom for large tool results.
+     *
+     * Range: 0.10–0.50. Default: 0.25
+     */
+    reserveFraction?: number;
+    /**
+     * Fraction of the effective token budget (post-reserve) allocated to
+     * conversation history. History fills up to this cap before context slots run.
+     *
+     * Range: 0.20–0.60. Default: 0.40
+     */
+    historyFraction?: number;
+    /**
+     * Fraction of the effective token budget (post-reserve) allocated to the
+     * memory pool: facts, wiki, semantic recall, cross-session context, and
+     * trigger-fired doc chunks all draw from this shared pool.
+     *
+     * Range: 0.20–0.70. Default: 0.45
+     * Note: historyFraction + memoryFraction should be ≤ 0.90 to leave room
+     * for fixed-cost slots (system, identity, HyperForm: typically 3–8k tokens).
+     */
+    memoryFraction?: number;
+    /**
+     * @deprecated Use budgetFraction instead. Absolute token fallback used when
+     * model detection fails and budgetFraction is not set.
+     */
     defaultTokenBudget: number;
     maxHistoryMessages: number;
+    /** @advanced Replaced by memoryFraction for primary tuning. Hard per-fetch fact count cap. */
     maxFacts: number;
     maxCrossSessionContext: number;
     /**
-     * Aggregate token ceiling across all trigger-fired doc chunk collections in a
-     * single compose pass. When unset, hypermem uses a dynamic ceiling of 40% of
-     * the remaining budget at the start of trigger retrieval.
-     *
-     * This prevents pathological prompts from firing many trigger collections at
-     * once and starving the rest of the prompt budget.
+     * @advanced Aggregate token ceiling across all trigger-fired doc chunk
+     * collections in a single compose pass. When unset, draws from the memoryFraction
+     * pool. Rarely needs manual tuning.
      */
     maxTotalTriggerTokens?: number;
     /**
@@ -423,15 +477,9 @@ export interface CompositorConfig {
      */
     warmHistoryBudgetFraction: number;
     /**
-     * Fraction of the model context window to reserve for output tokens and
-     * hypermem operational overhead. The compositor's effective input budget is
-     * (contextWindow × (1 - contextWindowReserve)).
-     *
-     * Higher values = more headroom for large operations, fewer turns before
-     * session break. Lower values = more context available, higher saturation risk.
-     *
-     * Default: 0.25 (25% reserve — leaves 75% for input context)
-     * Previous default was 0.10 (10% reserve).
+     * @advanced Use reserveFraction instead.
+     * Fraction of the model context window to reserve for output tokens.
+     * Falls back to reserveFraction when set. Default: 0.25
      */
     contextWindowReserve?: number;
     /**
@@ -470,16 +518,10 @@ export interface CompositorConfig {
      */
     keystoneMinSignificance?: number;
     /**
-     * Fraction of the effective token budget to target for context assembly.
-     * The compositor fills slots until this fraction is consumed, leaving the
-     * remainder for conversation history and response headroom.
-     *
-     * Lower values = lighter context, faster turns, less memory surfaced.
-     * Higher values = richer context, more memory, higher saturation risk.
-     *
+     * @advanced Use memoryFraction instead.
+     * Fraction of the effective budget to target for context assembly.
+     * Honored as a fallback when memoryFraction is not set.
      * Range: 0.3–0.85. Default: 0.65
-     * Typical lightweight config: 0.45
-     * Typical fleet/multi-agent config: 0.65
      */
     targetBudgetFraction?: number;
     /**
@@ -498,19 +540,19 @@ export interface CompositorConfig {
      */
     enableMOD?: boolean;
     /**
-     * Output profile tier. Controls what FOS content is injected.
+     * HyperForm output shaping profile. Controls what FOS/MOD content is injected.
      *
      * 'light'    — ~100 token standalone directives. No MOD, no fleet concepts.
-     *             Works on any single-agent 64k setup. No DB required.
-     * 'standard' — Full FOS: density targets, format rules, compression ratios,
-     *              task-context scoping. No MOD.
+     * 'standard' — Full FOS: density targets, format rules, compression ratios.
      * 'full'     — FOS + MOD. Cross-agent coordination, full spec.
      *
      * Backward compat: 'starter' maps to 'light', 'fleet' maps to 'full'.
      * Default: 'full' (backward-compatible). New install default: 'light'.
      */
+    hyperformProfile?: 'light' | 'standard' | 'full' | 'starter' | 'fleet';
+    /** @deprecated Use hyperformProfile */
     outputProfile?: 'light' | 'standard' | 'full' | 'starter' | 'fleet';
-    /** @deprecated Use outputProfile */
+    /** @deprecated Use hyperformProfile */
     outputStandard?: 'light' | 'standard' | 'full' | 'starter' | 'fleet';
     /**
      * Hard token ceiling for wiki page injection per compose pass.