niahere 0.2.83 → 0.2.84

package/README.md

@@ -43,8 +43,8 @@ nia start               # starts daemon + registers OS service
 - **Skills** — loads skills from multiple directories, invokable as slash commands
 - **Cross-platform service** — launchd (macOS), systemd (Linux), service-aware restart
 - **MCP tools** — 20 tools for job management, messaging, memory, rules, and channel control
-- **Background memory consolidation** — extracts memories from conversations and job runs automatically
-- **Session summaries** — handoff notes between sessions for continuity
+- **Background memory consolidation** — stages memory candidates from conversations automatically
+- **Session summaries** — optional handoff notes between sessions for continuity
 - **Backups** — `nia backup` with auto-backup before updates
 - **Optional integrations** — add Gmail, Discord, and more via skills
 
@@ -119,6 +119,17 @@ All config and data lives in `~/.niahere/`:
     nia.pid, daemon.log, cron-state.json, cron-audit.jsonl
 ```
 
+Post-session background LLM work can be disabled in `config.yaml`:
+
+```yaml
+session_finalization:
+  enabled: true
+  memory_consolidation: true
+  summaries: true
+```
+
+Use `nia config set session_finalization.memory_consolidation false` to stop memory staging, `nia config set session_finalization.summaries false` to stop session summaries, or `nia config set session_finalization.enabled false` to disable both.
+
 ## Contributing
 
 **Don't add features. Add skills.**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "niahere",
-  "version": "0.2.83",
+  "version": "0.2.84",
   "description": "A personal AI assistant daemon — chat, scheduled jobs, persona system, extensible via skills.",
   "type": "module",
   "scripts": {

package/src/commands/validate.ts

@@ -85,6 +85,29 @@ export function validateConfig(): Result {
     messages.push(`${PASS} runner: ${runner}`);
   }
 
+  // Session finalization
+  const sf = raw.session_finalization as Record<string, unknown> | undefined;
+  if (sf) {
+    let sessionFinalizationOk = true;
+    for (const key of ["enabled", "memory_consolidation", "summaries"]) {
+      const val = sf[key];
+      if (val !== undefined && typeof val !== "boolean") {
+        messages.push(`${FAIL} session_finalization.${key} must be true or false`);
+        ok = false;
+        sessionFinalizationOk = false;
+      }
+    }
+    if (sessionFinalizationOk) {
+      const enabled = sf.enabled !== false;
+      const memoryConsolidation = sf.memory_consolidation !== false;
+      const summaries = sf.summaries !== false;
+      messages.push(
+        `${PASS} session_finalization: ${enabled ? "enabled" : "disabled"} ` +
+          `(memory_consolidation=${memoryConsolidation}, summaries=${summaries})`,
+      );
+    }
+  }
+
   // Channels
   const ch = raw.channels as Record<string, unknown> | undefined;
   if (ch) {

package/src/core/finalizer.ts

@@ -10,10 +10,25 @@
 import { getSql } from "../db/connection";
 import { consolidateSession } from "./consolidator";
 import { summarizeSession } from "./summarizer";
+import { loadConfig } from "../utils/config";
 import { log } from "../utils/log";
 
+type FinalizationTask = "consolidate" | "summarize";
+
+function getEnabledTasks(): FinalizationTask[] {
+  const { sessionFinalization } = loadConfig();
+  if (!sessionFinalization.enabled) return [];
+
+  const tasks: FinalizationTask[] = [];
+  if (sessionFinalization.memoryConsolidation) tasks.push("consolidate");
+  if (sessionFinalization.summaries) tasks.push("summarize");
+  return tasks;
+}
+
 /** Enqueue a session for finalization. Always returns immediately. */
 export async function finalizeSession(sessionId: string, room: string): Promise<void> {
+  if (getEnabledTasks().length === 0) return;
+
   const sql = getSql();
 
   // Get current message count for idempotency
@@ -77,19 +92,30 @@ async function processOne(sessionId: string, room: string, messageCount: number)
   if (claimed.length === 0) return; // Already claimed or cancelled
 
   const requestId = claimed[0].id;
+  const tasks = getEnabledTasks();
+  if (tasks.length === 0) {
+    await sql`
+      UPDATE finalization_requests
+      SET status = 'done', updated_at = NOW()
+      WHERE id = ${requestId}
+    `;
+    log.info({ sessionId, room, messageCount }, "finalizer: skipped because all tasks are disabled");
+    return;
+  }
 
   try {
-    const [consolidateResult, summarizeResult] = await Promise.allSettled([
-      consolidateSession(sessionId, room),
-      summarizeSession(sessionId, room),
-    ]);
+    const results = await Promise.allSettled(
+      tasks.map((task) =>
+        task === "consolidate" ? consolidateSession(sessionId, room) : summarizeSession(sessionId, room),
+      ),
+    );
 
     const errors: string[] = [];
-    if (consolidateResult.status === "rejected") {
-      errors.push(`consolidate: ${formatRejection(consolidateResult.reason)}`);
-    }
-    if (summarizeResult.status === "rejected") {
-      errors.push(`summarize: ${formatRejection(summarizeResult.reason)}`);
+    for (let i = 0; i < results.length; i++) {
+      const result = results[i];
+      if (result.status === "rejected") {
+        errors.push(`${tasks[i]}: ${formatRejection(result.reason)}`);
+      }
     }
 
     const finalStatus = errors.length === 0 ? "done" : "failed";

package/src/types/config.ts

@@ -35,6 +35,12 @@ export interface ChannelsConfig {
   slack: SlackConfig;
 }
 
+export interface SessionFinalizationConfig {
+  enabled: boolean;
+  memoryConsolidation: boolean;
+  summaries: boolean;
+}
+
 export interface Config {
   model: string;
   runner: "claude" | "codex";
@@ -43,5 +49,6 @@ export interface Config {
   database_url: string;
   log_level: string;
   gemini_api_key: string | null;
+  sessionFinalization: SessionFinalizationConfig;
   channels: ChannelsConfig;
 }

package/src/utils/config.ts

@@ -16,6 +16,11 @@ const DEFAULTS: Config = {
   database_url: DEFAULT_DATABASE_URL,
   log_level: "info",
   gemini_api_key: null,
+  sessionFinalization: {
+    enabled: true,
+    memoryConsolidation: true,
+    summaries: true,
+  },
   channels: {
     enabled: true,
     default: "telegram",
@@ -100,6 +105,14 @@ export function loadConfig(): Config {
   const gemini_api_key =
     process.env.GEMINI_API_KEY || (typeof raw.gemini_api_key === "string" ? raw.gemini_api_key : null);
 
+  // Session finalization — controls post-session background LLM work.
+  const sf = (raw.session_finalization || {}) as Record<string, unknown>;
+  const sessionFinalization = {
+    enabled: sf.enabled !== false,
+    memoryConsolidation: sf.memory_consolidation !== false,
+    summaries: sf.summaries !== false,
+  };
+
   // --- Channels (nested under `channels:` in yaml) ---
   const ch = (raw.channels || {}) as Record<string, unknown>;
   const chTg = (ch.telegram || {}) as Record<string, unknown>;
@@ -159,6 +172,7 @@ export function loadConfig(): Config {
     database_url,
     log_level,
     gemini_api_key,
+    sessionFinalization,
     channels: {
       enabled: channelsEnabled,
       default: defaultChannel,