@joshuaswarren/openclaw-engram 8.3.88 → 8.3.89

package/dist/index.js

@@ -136,6 +136,7 @@ function parseConfig(raw) {
   }
   const sharedCrossSignalSemanticEnabled = cfg.sharedCrossSignalSemanticEnabled === true || cfg.crossSignalsSemanticEnabled === true;
   const sharedCrossSignalSemanticTimeoutMs = typeof cfg.sharedCrossSignalSemanticTimeoutMs === "number" ? Math.max(1, Math.floor(cfg.sharedCrossSignalSemanticTimeoutMs)) : typeof cfg.crossSignalsSemanticTimeoutMs === "number" ? Math.max(1, Math.floor(cfg.crossSignalsSemanticTimeoutMs)) : 4e3;
+  const recallPipelineConfig = buildRecallPipelineConfig(cfg);
   return {
     openaiApiKey: apiKey,
     openaiBaseUrl: baseUrl,
@@ -367,6 +368,8 @@ function parseConfig(raw) {
     knowledgeIndexEnabled: cfg.knowledgeIndexEnabled !== false,
     knowledgeIndexMaxEntities: typeof cfg.knowledgeIndexMaxEntities === "number" ? cfg.knowledgeIndexMaxEntities : 40,
     knowledgeIndexMaxChars: typeof cfg.knowledgeIndexMaxChars === "number" ? cfg.knowledgeIndexMaxChars : 4e3,
+    recallBudgetChars: recallPipelineConfig.recallBudgetChars,
+    recallPipeline: recallPipelineConfig.pipeline,
     entityRelationshipsEnabled: cfg.entityRelationshipsEnabled !== false,
     entityActivityLogEnabled: cfg.entityActivityLogEnabled !== false,
     entityActivityLogMaxEntries: typeof cfg.entityActivityLogMaxEntries === "number" ? cfg.entityActivityLogMaxEntries : 20,
@@ -454,6 +457,100 @@ function parseConfig(raw) {
     tmtSummaryMaxTokens: typeof cfg.tmtSummaryMaxTokens === "number" ? cfg.tmtSummaryMaxTokens : 300
   };
 }
+function clampNonNegativeNumber(value) {
+  if (typeof value !== "number" || !Number.isFinite(value)) return void 0;
+  return Math.max(0, Math.floor(value));
+}
+function parseRecallSectionEntry(raw) {
+  const entry = raw && typeof raw === "object" && !Array.isArray(raw) ? raw : {};
+  return {
+    id: typeof entry.id === "string" ? entry.id.trim() : "",
+    enabled: entry.enabled !== false,
+    maxChars: entry.maxChars === null ? null : clampNonNegativeNumber(entry.maxChars),
+    consolidateTriggerLines: clampNonNegativeNumber(entry.consolidateTriggerLines),
+    consolidateTargetLines: clampNonNegativeNumber(entry.consolidateTargetLines),
+    maxEntities: clampNonNegativeNumber(entry.maxEntities),
+    maxResults: clampNonNegativeNumber(entry.maxResults),
+    maxTurns: clampNonNegativeNumber(entry.maxTurns),
+    maxTokens: clampNonNegativeNumber(entry.maxTokens),
+    lookbackHours: clampNonNegativeNumber(entry.lookbackHours),
+    maxCount: clampNonNegativeNumber(entry.maxCount),
+    topK: clampNonNegativeNumber(entry.topK),
+    timeoutMs: clampNonNegativeNumber(entry.timeoutMs),
+    maxPatterns: clampNonNegativeNumber(entry.maxPatterns)
+  };
+}
+function buildDefaultRecallPipeline(cfg) {
+  return [
+    {
+      id: "shared-context",
+      enabled: cfg.sharedContextEnabled === true,
+      maxChars: typeof cfg.sharedContextMaxInjectChars === "number" ? Math.max(0, Math.floor(cfg.sharedContextMaxInjectChars)) : 4e3
+    },
+    {
+      id: "profile",
+      enabled: true,
+      consolidateTriggerLines: 100,
+      consolidateTargetLines: 50
+    },
+    {
+      id: "identity-continuity",
+      enabled: cfg.identityContinuityEnabled === true
+    },
+    {
+      id: "knowledge-index",
+      enabled: cfg.knowledgeIndexEnabled !== false,
+      maxChars: typeof cfg.knowledgeIndexMaxChars === "number" ? Math.max(0, Math.floor(cfg.knowledgeIndexMaxChars)) : 4e3,
+      maxEntities: typeof cfg.knowledgeIndexMaxEntities === "number" ? Math.max(0, Math.floor(cfg.knowledgeIndexMaxEntities)) : 40
+    },
+    { id: "verbatim-artifacts", enabled: cfg.verbatimArtifactsEnabled === true },
+    { id: "memory-boxes", enabled: cfg.memoryBoxesEnabled === true },
+    { id: "temporal-memory-tree", enabled: cfg.temporalMemoryTreeEnabled === true },
+    {
+      id: "memories",
+      enabled: true,
+      maxResults: typeof cfg.qmdMaxResults === "number" ? Math.max(0, Math.floor(cfg.qmdMaxResults)) : 8
+    },
+    {
+      id: "compression-guidelines",
+      enabled: cfg.compressionGuidelineLearningEnabled === true
+    },
+    {
+      id: "transcript",
+      enabled: cfg.transcriptEnabled !== false,
+      maxTurns: typeof cfg.maxTranscriptTurns === "number" ? Math.max(0, Math.floor(cfg.maxTranscriptTurns)) : 50,
+      maxTokens: typeof cfg.maxTranscriptTokens === "number" ? Math.max(0, Math.floor(cfg.maxTranscriptTokens)) : 1e3,
+      lookbackHours: typeof cfg.transcriptRecallHours === "number" ? Math.max(0, Math.floor(cfg.transcriptRecallHours)) : 12
+    },
+    {
+      id: "summaries",
+      enabled: cfg.hourlySummariesEnabled !== false,
+      maxCount: typeof cfg.maxSummaryCount === "number" ? Math.max(0, Math.floor(cfg.maxSummaryCount)) : 6,
+      lookbackHours: typeof cfg.summaryRecallHours === "number" ? Math.max(0, Math.floor(cfg.summaryRecallHours)) : 24
+    },
+    {
+      id: "conversation-recall",
+      enabled: cfg.conversationIndexEnabled === true,
+      topK: typeof cfg.conversationRecallTopK === "number" ? Math.max(0, Math.floor(cfg.conversationRecallTopK)) : 3,
+      maxChars: typeof cfg.conversationRecallMaxChars === "number" ? Math.max(0, Math.floor(cfg.conversationRecallMaxChars)) : 2500,
+      timeoutMs: typeof cfg.conversationRecallTimeoutMs === "number" ? Math.max(0, Math.floor(cfg.conversationRecallTimeoutMs)) : 800
+    },
+    {
+      id: "compounding",
+      enabled: cfg.compoundingEnabled === true && cfg.compoundingInjectEnabled !== false,
+      maxPatterns: 40
+    },
+    { id: "questions", enabled: cfg.injectQuestions === true }
+  ];
+}
+function buildRecallPipelineConfig(cfg) {
+  const maxMemoryTokens = typeof cfg.maxMemoryTokens === "number" ? Math.max(0, Math.floor(cfg.maxMemoryTokens)) : 2e3;
+  const recallBudgetCharsRaw = clampNonNegativeNumber(cfg.recallBudgetChars);
+  const recallBudgetChars = recallBudgetCharsRaw ?? maxMemoryTokens * 4;
+  const rawPipeline = cfg.recallPipeline;
+  const pipeline2 = Array.isArray(rawPipeline) ? rawPipeline.map(parseRecallSectionEntry).filter((entry) => entry.id.length > 0) : buildDefaultRecallPipeline(cfg);
+  return { recallBudgetChars, pipeline: pipeline2 };
+}
 
 // src/orchestrator.ts
 import path28 from "path";
@@ -1713,13 +1810,16 @@ var ConsolidationResultSchema = z.object({
   profileUpdates: z.array(z.string()).describe("New profile statements to add or update"),
   entityUpdates: z.array(EntityMentionSchema).describe("Entity updates from consolidation analysis")
 });
-var ProfileConsolidationResultSchema = z.object({
-  consolidatedProfile: z.string().describe(
-    "The full consolidated profile as markdown. Preserve all ## section headers. Merge duplicate or near-duplicate bullets into single clear statements. Remove stale or superseded information. Keep the most important and durable observations. Target roughly 400 lines."
-  ),
-  removedCount: z.number().describe("Number of bullets removed or merged during consolidation"),
-  summary: z.string().describe("Brief summary of what was consolidated")
-});
+function buildProfileConsolidationResultSchema(targetLines) {
+  return z.object({
+    consolidatedProfile: z.string().describe(
+      `The full consolidated profile as markdown. Preserve all ## section headers. Merge duplicate or near-duplicate bullets into single clear statements. Remove stale or superseded information. Keep the most important and durable observations. Target roughly ${targetLines} lines.`
+    ),
+    removedCount: z.number().describe("Number of bullets removed or merged during consolidation"),
+    summary: z.string().describe("Brief summary of what was consolidated")
+  });
+}
+var ProfileConsolidationResultSchema = buildProfileConsolidationResultSchema(50);
 var IdentityConsolidationResultSchema = z.object({
   learnedPatterns: z.array(z.string()).describe(
     "Consolidated behavioral patterns and lessons learned, each a concise standalone statement"
@@ -2870,13 +2970,13 @@ Respond with valid JSON matching this schema:
    * The LLM merges duplicates, removes stale info, and preserves section structure.
    * Returns the consolidated markdown or null on failure.
    */
-  async consolidateProfile(fullProfileContent) {
+  async consolidateProfile(fullProfileContent, targetLines = 50) {
     const pTraceId = crypto.randomUUID();
     this.emit({ kind: "llm_start", traceId: pTraceId, model: this.config.model, operation: "profile_consolidation", input: fullProfileContent.slice(0, 2e3) });
     const pStartTime = Date.now();
     if (this.config.localLlmEnabled) {
       try {
-        const localResult = await this.consolidateProfileWithLocalLlm(fullProfileContent);
+        const localResult = await this.consolidateProfileWithLocalLlm(fullProfileContent, targetLines);
         if (localResult) {
           const durationMs = Date.now() - pStartTime;
           this.emit({ kind: "llm_end", traceId: pTraceId, model: this.config.localLlmModel, operation: "profile_consolidation", durationMs });
@@ -2900,7 +3000,7 @@ Respond with valid JSON matching this schema:
       pTraceId,
       "profile_consolidation",
       pStartTime,
-      ProfileConsolidationResultSchema,
+      buildProfileConsolidationResultSchema(targetLines),
       [
         {
           role: "system",
@@ -2911,7 +3011,7 @@ Respond with valid JSON matching this schema:
 3. REMOVES stale information that has been superseded by newer bullets
 4. REMOVES trivial or overly specific operational details that won't be useful across sessions
 5. KEEPS the most important, durable observations about the user's preferences, habits, identity, and working style
-6. Target roughly 400 lines \u2014 this is a soft target, prioritize quality over length
+6. Target roughly ${targetLines} lines \u2014 this is a soft target, prioritize quality over length
 7. Write in the same style as the existing profile \u2014 concise bullets, no fluff
 
 The output should be the COMPLETE consolidated profile as valid markdown, starting with "# Behavioral Profile".`
@@ -2942,13 +3042,13 @@ The output should be the COMPLETE consolidated profile as valid markdown, starti
 3. REMOVES stale information that has been superseded by newer bullets
 4. REMOVES trivial or overly specific operational details that won't be useful across sessions
 5. KEEPS the most important, durable observations about the user's preferences, habits, identity, and working style
-6. Target roughly 400 lines \u2014 this is a soft target, prioritize quality over length
+6. Target roughly ${targetLines} lines \u2014 this is a soft target, prioritize quality over length
 7. Write in the same style as the existing profile \u2014 concise bullets, no fluff
 
 The output should be the COMPLETE consolidated profile as valid markdown, starting with "# Behavioral Profile".`,
         input: fullProfileContent,
         text: {
-          format: zodTextFormat(ProfileConsolidationResultSchema, "profile_consolidation_result")
+          format: zodTextFormat(buildProfileConsolidationResultSchema(targetLines), "profile_consolidation_result")
         }
       });
       const pDurationMs = Date.now() - pStartTime;
@@ -2986,7 +3086,7 @@ The output should be the COMPLETE consolidated profile as valid markdown, starti
   /**
    * Consolidate profile using local LLM.
    */
-  async consolidateProfileWithLocalLlm(fullProfileContent) {
+  async consolidateProfileWithLocalLlm(fullProfileContent, targetLines = 50) {
     const contextSizes = this.modelRegistry.calculateContextSizes(
       this.config.localLlmModel,
       this.config.localLlmMaxContext
@@ -2999,7 +3099,7 @@ The output should be the COMPLETE consolidated profile as valid markdown, starti
 3. REMOVES stale information that has been superseded by newer bullets
 4. REMOVES trivial or overly specific operational details that won't be useful across sessions
 5. KEEPS the most important, durable observations about the user's preferences, habits, identity, and working style
-6. Target roughly 400 lines \u2014 this is a soft target, prioritize quality over length
+6. Target roughly ${targetLines} lines \u2014 this is a soft target, prioritize quality over length
 7. Write in the same style as the existing profile \u2014 concise bullets, no fluff
 
 Profile to consolidate:
@@ -5612,11 +5712,12 @@ ${sanitized.text}
     }
   }
   /** Check if profile.md exceeds the max line cap and needs LLM consolidation */
-  async profileNeedsConsolidation() {
+  async profileNeedsConsolidation(triggerLines) {
     const profile = await this.readProfile();
     if (!profile) return false;
     const lineCount = profile.split("\n").length;
-    return lineCount > _StorageManager.PROFILE_MAX_LINES;
+    const threshold = typeof triggerLines === "number" ? Math.max(0, Math.floor(triggerLines)) : _StorageManager.PROFILE_MAX_LINES;
+    return lineCount > threshold;
   }
   async readAllMemories() {
     const memories = [];
@@ -6616,13 +6717,14 @@ ${reflection}
    * Build the Knowledge Index: a compact markdown table of top-scored entities.
    * Respects maxEntities and maxChars limits from config.
    */
-  async buildKnowledgeIndex(config) {
-    if (this.knowledgeIndexCache && Date.now() - this.knowledgeIndexCache.builtAt < _StorageManager.KNOWLEDGE_INDEX_CACHE_TTL_MS) {
+  async buildKnowledgeIndex(config, overrides) {
+    const useDefaultLimits = overrides?.maxEntities === void 0 && overrides?.maxChars === void 0;
+    if (useDefaultLimits && this.knowledgeIndexCache && Date.now() - this.knowledgeIndexCache.builtAt < _StorageManager.KNOWLEDGE_INDEX_CACHE_TTL_MS) {
       return { result: this.knowledgeIndexCache.result, cached: true };
     }
     const entities = await this.readAllEntityFiles();
     if (entities.length === 0) {
-      this.knowledgeIndexCache = { result: "", builtAt: Date.now() };
+      if (useDefaultLimits) this.knowledgeIndexCache = { result: "", builtAt: Date.now() };
       return { result: "", cached: false };
     }
     const now = /* @__PURE__ */ new Date();
@@ -6635,26 +6737,28 @@ ${reflection}
       topRelationships: e.relationships.slice(0, 3).map((r) => r.target)
     }));
     scored.sort((a, b) => b.score - a.score);
-    const topN = scored.slice(0, config.knowledgeIndexMaxEntities);
+    const maxEntities = typeof overrides?.maxEntities === "number" ? Math.max(0, Math.floor(overrides.maxEntities)) : config.knowledgeIndexMaxEntities;
+    const topN = scored.slice(0, maxEntities);
     if (topN.length === 0) {
-      this.knowledgeIndexCache = { result: "", builtAt: Date.now() };
+      if (useDefaultLimits) this.knowledgeIndexCache = { result: "", builtAt: Date.now() };
       return { result: "", cached: false };
     }
     const header = "## Knowledge Index\n\n| Entity | Type | Summary | Connected to |\n|--------|------|---------|-------------|";
     const rows = [];
     let totalChars = header.length;
+    const maxChars = typeof overrides?.maxChars === "number" ? Math.max(0, Math.floor(overrides.maxChars)) : config.knowledgeIndexMaxChars;
     for (const entity of topN) {
       const summary = entity.summary || `${entity.factCount} facts`;
       const connected = entity.topRelationships.length > 0 ? entity.topRelationships.join(", ") : "\u2014";
       const row = `| ${entity.name} | ${entity.type} | ${summary} | ${connected} |`;
-      if (totalChars + row.length + 1 > config.knowledgeIndexMaxChars) break;
+      if (totalChars + row.length + 1 > maxChars) break;
       rows.push(row);
       totalChars += row.length + 1;
     }
     const result = rows.length === 0 ? "" : `${header}
 ${rows.join("\n")}
 `;
-    this.knowledgeIndexCache = { result, builtAt: Date.now() };
+    if (useDefaultLimits) this.knowledgeIndexCache = { result, builtAt: Date.now() };
     return { result, cached: false };
   }
   /** Invalidate the Knowledge Index cache (call after entity mutations). */
@@ -15483,11 +15587,69 @@ ${r.snippet.trim()}
       log.debug(`last graph recall write failed: ${err}`);
     }
   }
+  getRecallSectionEntry(sectionId) {
+    const pipeline2 = Array.isArray(this.config.recallPipeline) ? this.config.recallPipeline : [];
+    return pipeline2.find((entry) => entry.id === sectionId);
+  }
+  isRecallSectionEnabled(sectionId, defaultEnabled = true) {
+    const entry = this.getRecallSectionEntry(sectionId);
+    if (!entry) return defaultEnabled;
+    return entry.enabled !== false;
+  }
+  getRecallSectionMaxChars(sectionId) {
+    const entry = this.getRecallSectionEntry(sectionId);
+    if (!entry) return void 0;
+    if (entry.maxChars === null) return null;
+    if (typeof entry.maxChars !== "number") return void 0;
+    return Math.max(0, Math.floor(entry.maxChars));
+  }
+  getRecallSectionNumber(sectionId, key) {
+    const entry = this.getRecallSectionEntry(sectionId);
+    if (!entry) return void 0;
+    const value = entry[key];
+    if (typeof value !== "number" || !Number.isFinite(value)) return void 0;
+    return Math.max(0, Math.floor(value));
+  }
+  appendRecallSection(sectionBuckets, sectionId, content) {
+    if (!this.isRecallSectionEnabled(sectionId)) return;
+    const trimmed = content.trim();
+    if (trimmed.length === 0) return;
+    const maxChars = this.getRecallSectionMaxChars(sectionId);
+    let finalContent = trimmed;
+    if (maxChars === 0) return;
+    if (typeof maxChars === "number" && finalContent.length > maxChars) {
+      finalContent = `${finalContent.slice(0, maxChars)}
+
+...(trimmed)
+`;
+    }
+    const existing = sectionBuckets.get(sectionId) ?? [];
+    existing.push(finalContent);
+    sectionBuckets.set(sectionId, existing);
+  }
+  assembleRecallSections(sectionBuckets) {
+    const ordered = [];
+    const pipeline2 = Array.isArray(this.config.recallPipeline) ? this.config.recallPipeline : [];
+    const orderedIds = pipeline2.filter((entry) => entry.enabled !== false).map((entry) => entry.id);
+    const seen = /* @__PURE__ */ new Set();
+    for (const id of orderedIds) {
+      const chunks = sectionBuckets.get(id);
+      if (!chunks || chunks.length === 0) continue;
+      ordered.push(chunks.join("\n\n"));
+      seen.add(id);
+    }
+    for (const [id, chunks] of sectionBuckets.entries()) {
+      if (seen.has(id)) continue;
+      if (chunks.length === 0) continue;
+      ordered.push(chunks.join("\n\n"));
+    }
+    return ordered;
+  }
   async recallInternal(prompt, sessionKey) {
     const recallStart = Date.now();
     const timings = {};
     const promptHash = createHash6("sha256").update(prompt).digest("hex");
-    const sections = [];
+    const sectionBuckets = /* @__PURE__ */ new Map();
     const queryPolicy = buildRecallQueryPolicy(prompt, sessionKey, {
       cronRecallPolicyEnabled: this.config.cronRecallPolicyEnabled,
       cronRecallNormalizedQueryMaxChars: this.config.cronRecallNormalizedQueryMaxChars,
@@ -15517,7 +15679,10 @@ ${r.snippet.trim()}
       0,
       Math.min(this.config.qmdMaxResults, this.config.recallPlannerMaxQmdResultsMinimal)
     );
-    const recallResultLimit = recallMode !== "no_recall" && queryPolicy.retrievalBudgetMode === "minimal" ? Math.min(plannerRecallResultLimit, policyMinimalLimit) : plannerRecallResultLimit;
+    const baseRecallResultLimit = recallMode !== "no_recall" && queryPolicy.retrievalBudgetMode === "minimal" ? Math.min(plannerRecallResultLimit, policyMinimalLimit) : plannerRecallResultLimit;
+    const memoriesSectionEnabled = this.isRecallSectionEnabled("memories");
+    const memorySectionMaxResults = this.getRecallSectionNumber("memories", "maxResults");
+    const recallResultLimit = memoriesSectionEnabled ? memorySectionMaxResults !== void 0 ? Math.min(baseRecallResultLimit, memorySectionMaxResults) : baseRecallResultLimit : 0;
     const recallHeadroom = this.config.verbatimArtifactsEnabled ? Math.max(12, this.config.verbatimArtifactsMaxRecall * 4) : 12;
     const computedFetchLimit = recallResultLimit === 0 ? 0 : Math.max(recallResultLimit, Math.min(200, recallResultLimit + recallHeadroom));
     const qmdFetchLimit = computedFetchLimit;
@@ -15561,6 +15726,7 @@ ${r.snippet.trim()}
     const recallNamespaces = recallNamespacesForPrincipal(principal, this.config);
     const profileStorage = await this.storageRouter.storageFor(selfNamespace);
     const sharedContextPromise = (async () => {
+      if (!this.isRecallSectionEnabled("shared-context", this.config.sharedContextEnabled === true)) return null;
       if (!this.sharedContext) return null;
       const t0 = Date.now();
       const [priorities, roundtable] = await Promise.all([
@@ -15579,12 +15745,14 @@ ${r.snippet.trim()}
       return trimmed.trim().length > 0 ? trimmed : null;
     })();
     const profilePromise = (async () => {
+      if (!this.isRecallSectionEnabled("profile")) return null;
       const t0 = Date.now();
       const profile2 = await profileStorage.readProfile();
       timings.profile = `${Date.now() - t0}ms`;
       return profile2 || null;
     })();
     const identityContinuityPromise = (async () => {
+      if (!this.isRecallSectionEnabled("identity-continuity", this.config.identityContinuityEnabled === true)) return null;
       const t0 = Date.now();
       const section = await this.buildIdentityContinuitySection({
         storage: profileStorage,
@@ -15595,10 +15763,14 @@ ${r.snippet.trim()}
       return section;
     })();
     const knowledgeIndexPromise = (async () => {
+      if (!this.isRecallSectionEnabled("knowledge-index", this.config.knowledgeIndexEnabled)) return null;
       if (!this.config.knowledgeIndexEnabled) return null;
       const t0 = Date.now();
       try {
-        const ki = await this.storage.buildKnowledgeIndex(this.config);
+        const ki = await this.storage.buildKnowledgeIndex(this.config, {
+          maxEntities: this.getRecallSectionNumber("knowledge-index", "maxEntities"),
+          maxChars: this.getRecallSectionNumber("knowledge-index", "maxChars")
+        });
         timings.ki = `${Date.now() - t0}ms${ki.cached ? " (cached)" : ""}`;
         return ki.result ? ki : null;
       } catch (err) {
@@ -15608,6 +15780,7 @@ ${r.snippet.trim()}
       }
     })();
     const artifactsPromise = (async () => {
+      if (!this.isRecallSectionEnabled("verbatim-artifacts", this.config.verbatimArtifactsEnabled === true)) return [];
       if (!this.config.verbatimArtifactsEnabled) return [];
       const t0 = Date.now();
       const targetCount = computeArtifactRecallLimit(
@@ -15651,26 +15824,162 @@ ${r.snippet.trim()}
       timings.qmd = `${Date.now() - t0}ms`;
       return { memoryResultsLists: [filteredResults], globalResults: [] };
     })();
-    const [sharedCtx, profile, identityContinuity, kiResult, artifacts, qmdResult] = await Promise.all([
+    const transcriptPromise = (async () => {
+      const t0 = Date.now();
+      if (!this.config.transcriptEnabled || !this.isRecallSectionEnabled("transcript", true)) {
+        timings.transcript = "skip";
+        return null;
+      }
+      const transcriptMaxTokens = this.getRecallSectionNumber("transcript", "maxTokens") ?? this.config.maxTranscriptTokens;
+      const transcriptMaxTurns = this.getRecallSectionNumber("transcript", "maxTurns") ?? this.config.maxTranscriptTurns;
+      const transcriptLookbackHours = this.getRecallSectionNumber("transcript", "lookbackHours") ?? this.config.transcriptRecallHours;
+      if (transcriptMaxTokens === 0 || transcriptMaxTurns === 0 || transcriptLookbackHours === 0) {
+        timings.transcript = "skip(limit=0)";
+        return null;
+      }
+      let section = null;
+      let checkpointInjected = false;
+      if (this.config.checkpointEnabled) {
+        const checkpoint = await this.transcript.loadCheckpoint(sessionKey);
+        log.debug(`recall: checkpoint loaded, turns=${checkpoint?.turns?.length ?? 0}`);
+        if (checkpoint && checkpoint.turns.length > 0) {
+          const formatted = this.transcript.formatForRecall(checkpoint.turns, transcriptMaxTokens);
+          if (formatted) {
+            section = `## Working Context (Recovered)
+
+${formatted}`;
+            checkpointInjected = true;
+            await this.transcript.clearCheckpoint();
+          }
+        }
+      }
+      if (!checkpointInjected) {
+        const entries = await this.transcript.readRecent(transcriptLookbackHours, sessionKey);
+        log.debug(`recall: read ${entries.length} transcript entries for sessionKey=${sessionKey}`);
+        const cappedEntries = entries.slice(-transcriptMaxTurns);
+        if (cappedEntries.length > 0) {
+          log.debug(`recall: injecting ${cappedEntries.length} transcript entries`);
+          const formatted = this.transcript.formatForRecall(cappedEntries, transcriptMaxTokens);
+          if (formatted) section = formatted;
+        }
+      }
+      timings.transcript = `${Date.now() - t0}ms`;
+      return section;
+    })();
+    const summariesPromise = (async () => {
+      const t0 = Date.now();
+      if (!this.config.hourlySummariesEnabled || !sessionKey || !this.isRecallSectionEnabled("summaries", true)) {
+        timings.summaries = "skip";
+        return null;
+      }
+      const summariesLookbackHours = this.getRecallSectionNumber("summaries", "lookbackHours") ?? this.config.summaryRecallHours;
+      const summariesMaxCount = this.getRecallSectionNumber("summaries", "maxCount") ?? this.config.maxSummaryCount;
+      if (summariesLookbackHours <= 0 || summariesMaxCount <= 0) {
+        timings.summaries = "skip(limit=0)";
+        return null;
+      }
+      const summaries = await this.summarizer.readRecent(sessionKey, summariesLookbackHours);
+      const cappedSummaries = summaries.slice(0, summariesMaxCount);
+      const section = cappedSummaries.length > 0 ? this.summarizer.formatForRecall(cappedSummaries, summariesMaxCount) : null;
+      timings.summaries = `${Date.now() - t0}ms`;
+      return section;
+    })();
+    const conversationRecallPromise = (async () => {
+      const t0 = Date.now();
+      if (!this.config.conversationIndexEnabled || queryPolicy.skipConversationRecall || !this.isRecallSectionEnabled("conversation-recall", true)) {
+        timings.convRecall = "skip";
+        return null;
+      }
+      const topKOverride = this.getRecallSectionNumber("conversation-recall", "topK");
+      if (topKOverride === 0) {
+        timings.convRecall = "skip(topK=0)";
+        return null;
+      }
+      const startedAtMs = Date.now();
+      const timeoutMs = Math.max(
+        200,
+        this.getRecallSectionNumber("conversation-recall", "timeoutMs") ?? this.config.conversationRecallTimeoutMs
+      );
+      const topK = Math.max(
+        1,
+        topKOverride ?? this.config.conversationRecallTopK
+      );
+      const maxChars = Math.max(
+        400,
+        this.getRecallSectionNumber("conversation-recall", "maxChars") ?? this.config.conversationRecallMaxChars
+      );
+      const results = await Promise.race([
+        this.searchConversationRecallResults(retrievalQuery, topK),
+        new Promise((resolve) => setTimeout(() => resolve([]), timeoutMs))
+      ]).catch(() => []);
+      const durationMs = Date.now() - startedAtMs;
+      if (durationMs >= timeoutMs) {
+        log.debug(`conversation recall: timed out after ${timeoutMs}ms`);
+      }
+      const section = this.formatConversationRecallSection(results, maxChars);
+      timings.convRecall = `${Date.now() - t0}ms`;
+      return section;
+    })();
+    const compoundingPromise = (async () => {
+      const t0 = Date.now();
+      if (!this.compounding || !this.config.compoundingInjectEnabled || !this.isRecallSectionEnabled("compounding", true)) {
+        timings.compounding = "skip";
+        return null;
+      }
+      const mistakes = await this.compounding.readMistakes();
+      if (!mistakes || !Array.isArray(mistakes.patterns) || mistakes.patterns.length === 0) {
+        timings.compounding = `${Date.now() - t0}ms`;
+        return null;
+      }
+      const maxPatterns = this.getRecallSectionNumber("compounding", "maxPatterns") ?? 40;
+      if (maxPatterns === 0) {
+        timings.compounding = "skip(limit=0)";
+        return null;
+      }
+      const lines = [
+        "## Institutional Learning (Compounded)",
+        "",
+        "Avoid repeating these patterns:",
+        ...mistakes.patterns.slice(0, maxPatterns).map((p) => `- ${p}`)
+      ];
+      timings.compounding = `${Date.now() - t0}ms`;
+      return lines.join("\n");
+    })();
+    const [
+      sharedCtx,
+      profile,
+      identityContinuity,
+      kiResult,
+      artifacts,
+      qmdResult,
+      transcriptSection,
+      summariesSection,
+      conversationRecallSection,
+      compoundingSection
+    ] = await Promise.all([
       sharedContextPromise,
       profilePromise,
       identityContinuityPromise,
       knowledgeIndexPromise,
       artifactsPromise,
-      qmdPromise
+      qmdPromise,
+      transcriptPromise,
+      summariesPromise,
+      conversationRecallPromise,
+      compoundingPromise
     ]);
-    if (sharedCtx) sections.push(sharedCtx);
-    if (profile) sections.push(`## User Profile
+    if (sharedCtx) this.appendRecallSection(sectionBuckets, "shared-context", sharedCtx);
+    if (profile) this.appendRecallSection(sectionBuckets, "profile", `## User Profile
 
 ${profile}`);
     if (identityContinuity) {
-      sections.push(identityContinuity.section);
+      this.appendRecallSection(sectionBuckets, "identity-continuity", identityContinuity.section);
       identityInjectionModeUsed = identityContinuity.mode;
       identityInjectedChars = identityContinuity.injectedChars;
       identityInjectionTruncated = identityContinuity.truncated;
     }
     if (kiResult?.result) {
-      sections.push(kiResult.result);
+      this.appendRecallSection(sectionBuckets, "knowledge-index", kiResult.result);
       log.debug(`Knowledge Index: ${kiResult.result.split("\n").length - 4} entities, ${kiResult.result.length} chars${kiResult.cached ? " (cached)" : ""}`);
     }
     if (artifacts.length > 0) {
@@ -15680,11 +15989,11 @@ ${profile}`);
         const created = createdRaw ? createdRaw.slice(0, 19).replace("T", " ") : "unknown-time";
         return `- [${artifactType}] "${this.truncateArtifactForRecall(a.content)}" (${created})`;
       });
-      sections.push(`## Verbatim Artifacts
+      this.appendRecallSection(sectionBuckets, "verbatim-artifacts", `## Verbatim Artifacts
 
 ${lines.join("\n")}`);
     }
-    if (this.config.memoryBoxesEnabled && this.config.boxRecallDays > 0) {
+    if (this.isRecallSectionEnabled("memory-boxes", this.config.memoryBoxesEnabled === true) && this.config.memoryBoxesEnabled && this.config.boxRecallDays > 0) {
       const recentBoxes = await this.boxBuilderFor(profileStorage).readRecentBoxes(this.config.boxRecallDays).catch(() => []);
       if (recentBoxes.length > 0) {
         const boxLines = recentBoxes.slice(0, 5).map((b) => {
@@ -15692,16 +16001,16 @@ ${lines.join("\n")}`);
           const traceNote = b.traceId ? ` [trace: ${b.traceId.slice(0, 12)}]` : "";
           return `- [${sealedDate}${traceNote}] Topics: ${b.topics.join(", ")} (${b.memoryIds.length} memories)`;
         });
-        sections.push(`## Recent Topic Windows
+        this.appendRecallSection(sectionBuckets, "memory-boxes", `## Recent Topic Windows
 
 ${boxLines.join("\n")}`);
       }
     }
-    if (this.config.temporalMemoryTreeEnabled && recallMode !== "minimal" && recallMode !== "no_recall") {
+    if (this.isRecallSectionEnabled("temporal-memory-tree", this.config.temporalMemoryTreeEnabled === true) && this.config.temporalMemoryTreeEnabled && recallMode !== "minimal" && recallMode !== "no_recall") {
       const tmtNode = await this.tmtBuilder.getMostRelevantNode();
       if (tmtNode) {
         const levelLabel = tmtNode.level.charAt(0).toUpperCase() + tmtNode.level.slice(1);
-        sections.push(`## Memory Timeline (${levelLabel})
+        this.appendRecallSection(sectionBuckets, "temporal-memory-tree", `## Memory Timeline (${levelLabel})
 
 ${tmtNode.summary}`);
       }
@@ -15789,7 +16098,7 @@ ${tmtNode.summary}`);
         this.publishRecallResults({
           title: "Relevant Memories",
           results: memoryResults,
-          sections,
+          sectionBuckets,
           retrievalQuery,
           sessionKey,
           identityInjection: {
@@ -15817,7 +16126,7 @@ ${tmtNode.summary}`);
           this.publishRecallResults({
             title: "Relevant Memories",
             results: scoped,
-            sections,
+            sectionBuckets,
             retrievalQuery,
             sessionKey,
             identityInjection: {
@@ -15840,7 +16149,7 @@ ${tmtNode.summary}`);
             this.publishRecallResults({
               title: "Long-Term Memories (Fallback)",
               results: longTerm,
-              sections,
+              sectionBuckets,
               retrievalQuery,
               sessionKey,
               identityInjection: {
@@ -15854,13 +16163,17 @@ ${tmtNode.summary}`);
         }
       }
       if (globalResults.length > 0) {
-        sections.push(
+        this.appendRecallSection(
+          sectionBuckets,
+          "workspace-context",
           this.formatQmdResults("Workspace Context", globalResults)
         );
       }
       timings.qmdPost = `${Date.now() - t0}ms`;
       if (isDisagreementPrompt(prompt)) {
-        sections.push(
+        this.appendRecallSection(
+          sectionBuckets,
+          "memories",
           [
             "## Retrieval Feedback Helper",
             "",
@@ -15891,7 +16204,7 @@ ${tmtNode.summary}`);
         this.publishRecallResults({
           title: "Relevant Memories",
           results: scoped,
-          sections,
+          sectionBuckets,
           retrievalQuery,
           sessionKey,
           identityInjection: {
@@ -15931,7 +16244,7 @@ ${tmtNode.summary}`);
             this.publishRecallResults({
               title: "Recent Memories",
               results: recent,
-              sections,
+              sectionBuckets,
               retrievalQuery,
               sessionKey,
               identityInjection: {
@@ -15954,7 +16267,7 @@ ${tmtNode.summary}`);
               this.publishRecallResults({
                 title: "Long-Term Memories (Fallback)",
                 results: longTerm,
-                sections,
+                sectionBuckets,
                 retrievalQuery,
                 sessionKey,
                 identityInjection: {
@@ -15979,7 +16292,7 @@ ${tmtNode.summary}`);
             this.publishRecallResults({
               title: "Long-Term Memories (Fallback)",
               results: longTerm,
-              sections,
+              sectionBuckets,
               retrievalQuery,
               sessionKey,
               identityInjection: {
@@ -15993,7 +16306,9 @@ ${tmtNode.summary}`);
         }
       }
       if (isDisagreementPrompt(prompt)) {
-        sections.push(
+        this.appendRecallSection(
+          sectionBuckets,
+          "memories",
           [
             "## Retrieval Feedback Helper",
             "",
@@ -16007,108 +16322,37 @@ ${tmtNode.summary}`);
         );
       }
     }
-    const compressionGuidelineSection = await this.buildCompressionGuidelineRecallSection();
-    if (compressionGuidelineSection) {
-      sections.push(compressionGuidelineSection);
-    }
-    const transcriptT0 = Date.now();
-    log.debug(`recall: transcriptEnabled=${this.config.transcriptEnabled}, sessionKey=${sessionKey}`);
-    if (this.config.transcriptEnabled) {
-      let checkpointInjected = false;
-      if (this.config.checkpointEnabled) {
-        const checkpoint = await this.transcript.loadCheckpoint(sessionKey);
-        log.debug(`recall: checkpoint loaded, turns=${checkpoint?.turns?.length ?? 0}`);
-        if (checkpoint && checkpoint.turns.length > 0) {
-          const formatted = this.transcript.formatForRecall(
-            checkpoint.turns,
-            this.config.maxTranscriptTokens
-          );
-          if (formatted) {
-            sections.push(`## Working Context (Recovered)
-
-${formatted}`);
-            checkpointInjected = true;
-            await this.transcript.clearCheckpoint();
-          }
-        }
-      }
-      if (!checkpointInjected) {
-        const entries = await this.transcript.readRecent(
-          this.config.transcriptRecallHours,
-          sessionKey
-        );
-        log.debug(`recall: read ${entries.length} transcript entries for sessionKey=${sessionKey}`);
-        const cappedEntries = entries.slice(-this.config.maxTranscriptTurns);
-        if (cappedEntries.length > 0) {
-          log.debug(`recall: injecting ${cappedEntries.length} transcript entries`);
-          const formatted = this.transcript.formatForRecall(
-            cappedEntries,
-            this.config.maxTranscriptTokens
-          );
-          if (formatted) {
-            sections.push(formatted);
-          }
-        }
+    if (this.isRecallSectionEnabled("compression-guidelines", this.config.compressionGuidelineLearningEnabled === true)) {
+      const compressionGuidelineSection = await this.buildCompressionGuidelineRecallSection();
+      if (compressionGuidelineSection) {
+        this.appendRecallSection(sectionBuckets, "compression-guidelines", compressionGuidelineSection);
       }
     }
-    timings.transcript = `${Date.now() - transcriptT0}ms`;
-    const summariesT0 = Date.now();
-    if (this.config.hourlySummariesEnabled && sessionKey) {
-      const summaries = await this.summarizer.readRecent(
-        sessionKey,
-        this.config.summaryRecallHours
-      );
-      const cappedSummaries = summaries.slice(0, this.config.maxSummaryCount);
-      if (cappedSummaries.length > 0) {
-        const formatted = this.summarizer.formatForRecall(
-          cappedSummaries,
-          this.config.maxSummaryCount
-        );
-        sections.push(formatted);
-      }
+    if (transcriptSection) {
+      this.appendRecallSection(sectionBuckets, "transcript", transcriptSection);
     }
-    timings.summaries = `${Date.now() - summariesT0}ms`;
-    const convT0 = Date.now();
-    if (this.config.conversationIndexEnabled && !queryPolicy.skipConversationRecall) {
-      const startedAtMs = Date.now();
-      const timeoutMs = Math.max(200, this.config.conversationRecallTimeoutMs);
-      const topK = Math.max(1, this.config.conversationRecallTopK);
-      const maxChars = Math.max(400, this.config.conversationRecallMaxChars);
-      const results = await Promise.race([
-        this.searchConversationRecallResults(retrievalQuery, topK),
-        new Promise((resolve) => setTimeout(() => resolve([]), timeoutMs))
-      ]).catch(() => []);
-      const durationMs = Date.now() - startedAtMs;
-      if (durationMs >= timeoutMs) {
-        log.debug(`conversation recall: timed out after ${timeoutMs}ms`);
-      }
-      const formattedConversationRecall = this.formatConversationRecallSection(results, maxChars);
-      if (formattedConversationRecall) {
-        sections.push(formattedConversationRecall);
-      }
+    if (summariesSection) {
+      this.appendRecallSection(sectionBuckets, "summaries", summariesSection);
     }
-    timings.convRecall = `${Date.now() - convT0}ms`;
-    if (this.compounding && this.config.compoundingInjectEnabled) {
-      const mistakes = await this.compounding.readMistakes();
-      if (mistakes && Array.isArray(mistakes.patterns) && mistakes.patterns.length > 0) {
-        const lines = [
-          "## Institutional Learning (Compounded)",
-          "",
-          "Avoid repeating these patterns:",
-          ...mistakes.patterns.slice(0, 40).map((p) => `- ${p}`)
-        ];
-        sections.push(lines.join("\n"));
-      }
+    if (conversationRecallSection) {
+      this.appendRecallSection(sectionBuckets, "conversation-recall", conversationRecallSection);
     }
-    if (this.config.injectQuestions) {
+    if (compoundingSection) {
+      this.appendRecallSection(sectionBuckets, "compounding", compoundingSection);
+    }
+    if (this.config.injectQuestions && this.isRecallSectionEnabled("questions", true)) {
       const questions = await profileStorage.readQuestions({ unresolvedOnly: true });
       if (questions.length > 0) {
         const topQuestion = questions[0];
-        sections.push(`## Open Question
+        this.appendRecallSection(
+          sectionBuckets,
+          "questions",
+          `## Open Question
 
 Something I've been curious about: ${topQuestion.question}
 
-_Context: ${topQuestion.context}_`);
+_Context: ${topQuestion.context}_`
+        );
       }
     }
     timings.total = `${Date.now() - recallStart}ms`;
@@ -16127,7 +16371,8 @@ _Context: ${topQuestion.context}_`);
         }
       }).catch((err) => log.debug(`last recall record failed: ${err}`));
     }
-    const context = sections.length === 0 ? "" : sections.join("\n\n---\n\n");
+    const orderedSections = this.assembleRecallSections(sectionBuckets);
+    const context = orderedSections.length === 0 ? "" : orderedSections.join("\n\n---\n\n");
     this.emitTrace({
       kind: "recall_summary",
       traceId: createHash6("sha256").update(`${sessionKey ?? "default"}:${Date.now()}:${promptHash}`).digest("hex").slice(0, 16),
@@ -17333,11 +17578,17 @@ _Context: ${topQuestion.context}_`);
     if (this.config.identityEnabled) {
       await this.autoConsolidateIdentity();
     }
-    if (await this.storage.profileNeedsConsolidation()) {
+    const profileSection = this.getRecallSectionEntry("profile");
+    const profileConsolidationTriggerLines = typeof profileSection?.consolidateTriggerLines === "number" ? Math.max(0, Math.floor(profileSection.consolidateTriggerLines)) : void 0;
+    const profileConsolidationTargetLines = typeof profileSection?.consolidateTargetLines === "number" ? Math.max(0, Math.floor(profileSection.consolidateTargetLines)) : 50;
+    if (await this.storage.profileNeedsConsolidation(profileConsolidationTriggerLines)) {
       log.info("profile.md exceeds max lines \u2014 running smart consolidation");
       const currentProfile = await this.storage.readProfile();
       if (currentProfile) {
-        const profileResult = await this.extraction.consolidateProfile(currentProfile);
+        const profileResult = await this.extraction.consolidateProfile(
+          currentProfile,
+          profileConsolidationTargetLines
+        );
         if (profileResult) {
           await this.storage.writeProfile(profileResult.consolidatedProfile);
           log.info(`profile.md consolidated: removed ${profileResult.removedCount} items \u2014 ${profileResult.summary}`);
@@ -17901,7 +18152,11 @@ ${lines.join("\n\n")}`;
         identityInjection: options.identityInjection
       }).catch((err) => log.debug(`last recall record failed: ${err}`));
     }
-    options.sections.push(this.formatQmdResults(options.title, options.results));
+    this.appendRecallSection(
+      options.sectionBuckets,
+      "memories",
+      this.formatQmdResults(options.title, options.results)
+    );
   }
   async searchEmbeddingFallback(query, limit) {
     if (!this.config.embeddingFallbackEnabled) return [];
@@ -25644,7 +25899,8 @@ var index_default = {
           const context = await orchestrator.recall(prompt, sessionKey);
           log.debug(`before_agent_start: recall returned ${context?.length ?? 0} chars`);
           if (!context) return;
-          const maxChars = cfg.maxMemoryTokens * 4;
+          const maxChars = cfg.recallBudgetChars;
+          if (maxChars === 0) return;
           const trimmed = context.length > maxChars ? context.slice(0, maxChars) + "\n\n...(memory context trimmed)" : context;
           log.debug(`before_agent_start: returning system prompt with ${trimmed.length} chars`);
           return {