@0xmaxma/claude-gateway 1.7.9 → 1.8.0

package/dist/agent/knowledge/shared-staleness.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Shared-KB staleness GC (issue #392 part D) — the shared-vault twin of
+ * `dreaming/staleness.ts`'s nightly per-agent GC, extending the SAME
+ * `kb_entry_lifecycle` soft-invalidate model to the shared KB, which had none
+ * at all (the shared vault's `kb_entry_lifecycle` table existed but was never
+ * populated — `indexer.ts` only computed entry blocks for `source: 'memory'`).
+ *
+ * The unit of identity here is the WHOLE NOTE (`wholeNoteEntryBlock`), not a
+ * bullet, so "moving a block" means moving the whole note. A stale note's
+ * content is written byte-identical (so its entry_hash — and thus the
+ * promote-back feedback loop — survives the move) to a `stale__<name>`
+ * sibling note, then the original file is deleted; a note retrieved AFTER
+ * being staled is moved back to its original name. This mirrors the personal
+ * archive's "decluttering by physical relocation" without merging multiple
+ * notes' content together (which would break entry-hash stability).
+ *
+ * Explicit `supersedes #N`-by-reference detection stays personal-only (issue
+ * #392 scope note): shared notes have no visible numeric id, and round 1's
+ * write-time merge/near-dup already provides de-facto content supersession.
+ * Only TTL/retrieval-based soft-invalidation applies here.
+ */
+import { ArchiveDB } from './archive-db';
+import type { ResolvedKnowledgeSharedCfg } from './types';
+import type { ResolvedStalenessCfg } from '../dreaming/types';
+/** Prefix a staled note's file is moved under (issue #392 part D). */
+export declare const STALE_NOTE_PREFIX = "stale__";
+export interface SharedStalenessResult {
+    invalidated: number;
+    promoted: number;
+    skippedMoves: number;
+    foldedLogRows: number;
+}
+/**
+ * Retire a live note: write its content byte-identical (after `comment`, which
+ * `wholeNoteEntryBlock` skips when hashing) to `stale__<name>`, then delete the
+ * original. Exported so both the TTL-based GC below and the reflection pass
+ * (issue #392 part C, merging a note into a cluster's canonical note) share one
+ * "move a note out of the active set" primitive. Returns false if the note is
+ * missing/empty.
+ */
+export declare function retireSharedNote(cfg: ResolvedKnowledgeSharedCfg, name: string, comment: string): boolean;
+/**
+ * Run the shared-KB staleness GC. Never throws; on any error the vault is left
+ * as-is. Deterministic given `opts.now`. Mirrors `runStalenessGc`'s shape.
+ */
+export declare function runSharedStalenessGc(cfg: ResolvedKnowledgeSharedCfg, staleCfg: ResolvedStalenessCfg, opts?: {
+    now?: number;
+    reindex?: (cfg: ResolvedKnowledgeSharedCfg) => void;
+    openDb?: (cfg: ResolvedKnowledgeSharedCfg) => ArchiveDB;
+}): SharedStalenessResult;
+//# sourceMappingURL=shared-staleness.d.ts.map

package/dist/agent/knowledge/shared-staleness.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared-staleness.d.ts","sourceRoot":"","sources":["../../../src/agent/knowledge/shared-staleness.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,EAAE,SAAS,EAAqB,MAAM,cAAc,CAAC;AAM5D,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,SAAS,CAAC;AAC1D,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAE9D,sEAAsE;AACtE,eAAO,MAAM,iBAAiB,YAAY,CAAC;AAE3C,MAAM,WAAW,qBAAqB;IACpC,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;CACvB;AASD;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,0BAA0B,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAaxG;AAmCD;;;GAGG;AACH,wBAAgB,oBAAoB,CAClC,GAAG,EAAE,0BAA0B,EAC/B,QAAQ,EAAE,oBAAoB,EAC9B,IAAI,CAAC,EAAE;IACL,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,0BAA0B,KAAK,IAAI,CAAC;IACpD,MAAM,CAAC,EAAE,CAAC,GAAG,EAAE,0BAA0B,KAAK,SAAS,CAAC;CACzD,GACA,qBAAqB,CA2CvB"}

package/dist/agent/knowledge/shared-staleness.js

@@ -0,0 +1,149 @@
+"use strict";
+/**
+ * Shared-KB staleness GC (issue #392 part D) — the shared-vault twin of
+ * `dreaming/staleness.ts`'s nightly per-agent GC, extending the SAME
+ * `kb_entry_lifecycle` soft-invalidate model to the shared KB, which had none
+ * at all (the shared vault's `kb_entry_lifecycle` table existed but was never
+ * populated — `indexer.ts` only computed entry blocks for `source: 'memory'`).
+ *
+ * The unit of identity here is the WHOLE NOTE (`wholeNoteEntryBlock`), not a
+ * bullet, so "moving a block" means moving the whole note. A stale note's
+ * content is written byte-identical (so its entry_hash — and thus the
+ * promote-back feedback loop — survives the move) to a `stale__<name>`
+ * sibling note, then the original file is deleted; a note retrieved AFTER
+ * being staled is moved back to its original name. This mirrors the personal
+ * archive's "decluttering by physical relocation" without merging multiple
+ * notes' content together (which would break entry-hash stability).
+ *
+ * Explicit `supersedes #N`-by-reference detection stays personal-only (issue
+ * #392 scope note): shared notes have no visible numeric id, and round 1's
+ * write-time merge/near-dup already provides de-facto content supersession.
+ * Only TTL/retrieval-based soft-invalidation applies here.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.STALE_NOTE_PREFIX = void 0;
+exports.retireSharedNote = retireSharedNote;
+exports.runSharedStalenessGc = runSharedStalenessGc;
+const archive_db_1 = require("./archive-db");
+const staleness_1 = require("../dreaming/staleness");
+const indexer_1 = require("./indexer");
+const lifecycle_1 = require("./lifecycle");
+const shared_writer_1 = require("./shared-writer");
+const config_1 = require("./config");
+/** Prefix a staled note's file is moved under (issue #392 part D). */
+exports.STALE_NOTE_PREFIX = 'stale__';
+const ZERO = { invalidated: 0, promoted: 0, skippedMoves: 0, foldedLogRows: 0 };
+/** The note "name" (pre-slug) a lifecycle row's stored path corresponds to. */
+function nameFromPath(relPath) {
+    return relPath.replace(/\.md$/i, '');
+}
+/**
+ * Retire a live note: write its content byte-identical (after `comment`, which
+ * `wholeNoteEntryBlock` skips when hashing) to `stale__<name>`, then delete the
+ * original. Exported so both the TTL-based GC below and the reflection pass
+ * (issue #392 part C, merging a note into a cluster's canonical note) share one
+ * "move a note out of the active set" primitive. Returns false if the note is
+ * missing/empty.
+ */
+function retireSharedNote(cfg, name, comment) {
+    const content = (0, shared_writer_1.readSharedNote)(cfg, name);
+    if (!content || !content.trim())
+        return false;
+    const block = (0, lifecycle_1.wholeNoteEntryBlock)(content)[0];
+    if (!block)
+        return false;
+    const staleName = `${exports.STALE_NOTE_PREFIX}${name}`;
+    (0, shared_writer_1.writeSharedNote)(cfg, staleName, `${comment}\n${block.text}`);
+    if ((0, shared_writer_1.deleteSharedNoteFile)(cfg, name))
+        return true;
+    // A failed delete must not leave a new stale duplicate behind or let callers
+    // stamp this active note invalid. Best-effort rollback preserves the invariant
+    // that a successful retirement has exactly one physical representation.
+    (0, shared_writer_1.deleteSharedNoteFile)(cfg, staleName);
+    return false;
+}
+/**
+ * Move a live note to `stale__<name>`, preserving its content byte-identical
+ * (after a leading `<!-- staled ... -->` marker line, which `wholeNoteEntryBlock`
+ * skips when hashing) so the entry_hash — and therefore the promote-back
+ * feedback loop — survives the move. Returns false (skip, don't stamp invalid)
+ * if the note is missing/empty or the content no longer matches the block that
+ * was scored (moved/edited concurrently).
+ */
+function moveNoteToStale(cfg, r, comment) {
+    const name = nameFromPath(r.path);
+    const content = (0, shared_writer_1.readSharedNote)(cfg, name);
+    if (!content)
+        return false;
+    const block = (0, lifecycle_1.wholeNoteEntryBlock)(content)[0];
+    if (!block || block.entryHash !== r.entryHash)
+        return false; // content changed since scoring
+    return retireSharedNote(cfg, name, comment);
+}
+/** Move a staled note back to its original name (issue #392 promote-back). */
+function moveNoteFromStale(cfg, r, comment) {
+    const staleName = nameFromPath(r.path); // r.path is the stale__<name> source path
+    const content = (0, shared_writer_1.readSharedNote)(cfg, staleName);
+    if (!content)
+        return false;
+    const block = (0, lifecycle_1.wholeNoteEntryBlock)(content)[0];
+    if (!block || block.entryHash !== r.entryHash)
+        return false;
+    const originalName = staleName.startsWith(exports.STALE_NOTE_PREFIX) ? staleName.slice(exports.STALE_NOTE_PREFIX.length) : staleName;
+    // Don't clobber a brand-new note that was created at the original name while
+    // this one sat staled — leave it staled rather than lose the newer note.
+    if ((0, shared_writer_1.sharedNoteExists)(cfg, originalName))
+        return false;
+    (0, shared_writer_1.writeSharedNote)(cfg, originalName, `${comment}\n${block.text}`);
+    (0, shared_writer_1.deleteSharedNoteFile)(cfg, staleName);
+    return true;
+}
+/**
+ * Run the shared-KB staleness GC. Never throws; on any error the vault is left
+ * as-is. Deterministic given `opts.now`. Mirrors `runStalenessGc`'s shape.
+ */
+function runSharedStalenessGc(cfg, staleCfg, opts) {
+    if (!staleCfg.enabled)
+        return { ...ZERO };
+    const now = opts?.now ?? Date.now();
+    const reindex = opts?.reindex ?? ((c) => void (0, indexer_1.indexSharedArchive)(c));
+    const openDb = opts?.openDb ?? ((c) => archive_db_1.ArchiveDB.forPath((0, config_1.sharedDbPath)(c)));
+    const result = { ...ZERO };
+    try {
+        // Ensure lifecycle rows exist for the current notes (first_seen etc).
+        reindex(cfg);
+        const db = openDb(cfg);
+        if (staleCfg.recordRetrievals)
+            result.foldedLogRows = db.aggregateRetrievalLog();
+        // Every shared note is lifecycle-eligible (no evergreen/pinned distinction).
+        const { invalidate, promote } = (0, staleness_1.decideStaleness)(db.listLifecycle(), staleCfg, now, () => true);
+        const date = new Date(now).toISOString().slice(0, 10);
+        for (const r of invalidate) {
+            const comment = `<!-- staled ${date} (aged out, ${r.retrievalCount} retrievals) -->`;
+            if (moveNoteToStale(cfg, r, comment)) {
+                db.stampInvalid(r.entryHash, now);
+                result.invalidated++;
+            }
+            else {
+                result.skippedMoves++;
+            }
+        }
+        for (const r of promote) {
+            const comment = `<!-- restored ${date} (retrieved after invalidation) -->`;
+            if (moveNoteFromStale(cfg, r, comment)) {
+                db.stampInvalid(r.entryHash, null);
+                result.promoted++;
+            }
+            else {
+                result.skippedMoves++;
+            }
+        }
+        if (result.invalidated + result.promoted > 0)
+            reindex(cfg);
+    }
+    catch {
+        /* best-effort — leave the vault untouched on any error */
+    }
+    return result;
+}
+//# sourceMappingURL=shared-staleness.js.map

package/dist/agent/knowledge/shared-staleness.js.map

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

package/dist/agent/knowledge/shared-writer.d.ts

@@ -14,6 +14,25 @@
  * escape the notes dir.
  */
 import type { ResolvedKnowledgeSharedCfg } from './types';
+/**
+ * Same cap the Bun-side MCP tools enforce on `memory_shared_create`/`_update`
+ * (`MAX_SHARED_NOTE_SIZE` in `mcp/tools/memory/module.ts`) — kept as an
+ * independent constant here since the two processes don't share imports
+ * (see the cross-runtime note in `shared-dedup.ts`). Keep both values in sync.
+ */
+export declare const MAX_SHARED_NOTE_SIZE: number;
+/** Whether a note already exists at this name (post-`sharedNoteFilename` slugification). */
+export declare function sharedNoteExists(cfg: ResolvedKnowledgeSharedCfg, name: string): boolean;
+/** Full content of a shared note, or null if it does not exist / is unreadable. */
+export declare function readSharedNote(cfg: ResolvedKnowledgeSharedCfg, name: string): string | null;
+/**
+ * Delete a shared note's file (issue #392 part D — the staleness GC moves a
+ * note's content elsewhere, then removes the original). Returns true if a file
+ * was actually removed, false if it didn't exist. Best-effort: any other error
+ * (permissions, race) is swallowed and reported as false, mirroring the rest of
+ * this module's "never throws into the caller's control flow" stance.
+ */
+export declare function deleteSharedNoteFile(cfg: ResolvedKnowledgeSharedCfg, name: string): boolean;
 /** Reduce an arbitrary name to one safe `*.md` path segment (no traversal). */
 export declare function sharedNoteFilename(name: string): string;
 /**

package/dist/agent/knowledge/shared-writer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"shared-writer.d.ts","sourceRoot":"","sources":["../../../src/agent/knowledge/shared-writer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAKH,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,SAAS,CAAC;AAM1D,+EAA+E;AAC/E,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAQvD;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,0BAA0B,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAqBtG"}
+{"version":3,"file":"shared-writer.d.ts","sourceRoot":"","sources":["../../../src/agent/knowledge/shared-writer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAKH,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,SAAS,CAAC;AAE1D;;;;;GAKG;AACH,eAAO,MAAM,oBAAoB,QAAa,CAAC;AAE/C,4FAA4F;AAC5F,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,0BAA0B,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAEvF;AAED,mFAAmF;AACnF,wBAAgB,cAAc,CAAC,GAAG,EAAE,0BAA0B,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAO3F;AAED;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,0BAA0B,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAQ3F;AAMD,+EAA+E;AAC/E,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAQvD;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,0BAA0B,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAqBtG"}

package/dist/agent/knowledge/shared-writer.js

@@ -48,11 +48,53 @@ var __importStar = (this && this.__importStar) || (function () {
     };
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.MAX_SHARED_NOTE_SIZE = void 0;
+exports.sharedNoteExists = sharedNoteExists;
+exports.readSharedNote = readSharedNote;
+exports.deleteSharedNoteFile = deleteSharedNoteFile;
 exports.sharedNoteFilename = sharedNoteFilename;
 exports.writeSharedNote = writeSharedNote;
 const fs = __importStar(require("fs"));
 const path = __importStar(require("path"));
 const config_1 = require("./config");
+/**
+ * Same cap the Bun-side MCP tools enforce on `memory_shared_create`/`_update`
+ * (`MAX_SHARED_NOTE_SIZE` in `mcp/tools/memory/module.ts`) — kept as an
+ * independent constant here since the two processes don't share imports
+ * (see the cross-runtime note in `shared-dedup.ts`). Keep both values in sync.
+ */
+exports.MAX_SHARED_NOTE_SIZE = 100 * 1024;
+/** Whether a note already exists at this name (post-`sharedNoteFilename` slugification). */
+function sharedNoteExists(cfg, name) {
+    return fs.existsSync(path.join((0, config_1.sharedNotesDir)(cfg), sharedNoteFilename(name)));
+}
+/** Full content of a shared note, or null if it does not exist / is unreadable. */
+function readSharedNote(cfg, name) {
+    const target = path.join((0, config_1.sharedNotesDir)(cfg), sharedNoteFilename(name));
+    try {
+        return fs.readFileSync(target, 'utf8');
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Delete a shared note's file (issue #392 part D — the staleness GC moves a
+ * note's content elsewhere, then removes the original). Returns true if a file
+ * was actually removed, false if it didn't exist. Best-effort: any other error
+ * (permissions, race) is swallowed and reported as false, mirroring the rest of
+ * this module's "never throws into the caller's control flow" stance.
+ */
+function deleteSharedNoteFile(cfg, name) {
+    const target = path.join((0, config_1.sharedNotesDir)(cfg), sharedNoteFilename(name));
+    try {
+        fs.unlinkSync(target);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
 // Monotonic per-process counter so concurrent writes within one process still get
 // distinct temp names (combined with pid for cross-process uniqueness).
 let tmpCounter = 0;

package/dist/agent/knowledge/shared-writer.js.map

@@ -1 +1 @@
-{"version":3,"file":"shared-writer.js","sourceRoot":"","sources":["../../../src/agent/knowledge/shared-writer.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;GAcG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAYH,gDAQC;AAMD,0CAqBC;AA7CD,uCAAyB;AACzB,2CAA6B;AAC7B,qCAA0C;AAG1C,kFAAkF;AAClF,wEAAwE;AACxE,IAAI,UAAU,GAAG,CAAC,CAAC;AAEnB,+EAA+E;AAC/E,SAAgB,kBAAkB,CAAC,IAAY;IAC7C,MAAM,IAAI,GAAG,IAAI;SACd,WAAW,EAAE;SACb,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC;SACrB,OAAO,CAAC,gBAAgB,EAAE,GAAG,CAAC;SAC9B,OAAO,CAAC,gBAAgB,EAAE,EAAE,CAAC;SAC7B,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IACjB,OAAO,GAAG,IAAI,IAAI,MAAM,KAAK,CAAC;AAChC,CAAC;AAED;;;GAGG;AACH,SAAgB,eAAe,CAAC,GAA+B,EAAE,IAAY,EAAE,OAAe;IAC5F,MAAM,GAAG,GAAG,IAAA,uBAAc,EAAC,GAAG,CAAC,CAAC;IAChC,EAAE,CAAC,SAAS,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACvC,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,kBAAkB,CAAC,IAAI,CAAC,CAAC,CAAC;IACxD,6EAA6E;IAC7E,gFAAgF;IAChF,iFAAiF;IACjF,8EAA8E;IAC9E,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,QAAQ,OAAO,CAAC,GAAG,IAAI,CAAC,UAAU,IAAI,CAAC,CAAC,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,OAAO,CAAC,CAAC;IACpH,IAAI,CAAC;QACH,EAAE,CAAC,aAAa,CAAC,GAAG,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;QACvC,EAAE,CAAC,UAAU,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC,CAAC,iBAAiB;IAC/C,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,IAAI,CAAC;YACH,EAAE,CAAC,MAAM,CAAC,GAAG,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QAClC,CAAC;QAAC,MAAM,CAAC;YACP,yBAAyB;QAC3B,CAAC;QACD,MAAM,GAAG,CAAC;IACZ,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC"}
+{"version":3,"file":"shared-writer.js","sourceRoot":"","sources":["../../../src/agent/knowledge/shared-writer.ts"],"names":[],"mappings":"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"}

package/dist/agent/knowledge/types.d.ts

@@ -7,6 +7,7 @@
  * K2 core-shrink, K4 applier) read from it. Nothing here touches the injected
  * prompt or spawns tools.
  */
+import type { StalenessConfig, ResolvedStalenessCfg } from '../dreaming/types';
 /** Trust class of an indexed chunk. Fail-closed: unclassified ⇒ `untrusted`. */
 export type OriginClass = 'owner' | 'agent' | 'untrusted' | 'system';
 /** Session context a chunk was observed in (reserved for later promotion gating). */
@@ -32,6 +33,8 @@ export interface KnowledgeSharedConfig {
     root?: string;
     mode?: 'propose' | 'auto';
     graph?: boolean;
+    /** issue #392 part D: shared-KB staleness GC (reuses the dreaming shape). */
+    staleness?: StalenessConfig;
 }
 /** Resolved, sanitized shared-KB config (all fields present). */
 export interface ResolvedKnowledgeSharedCfg {
@@ -40,6 +43,27 @@ export interface ResolvedKnowledgeSharedCfg {
     root: string;
     mode: 'propose' | 'auto';
     graph: boolean;
+    staleness: ResolvedStalenessCfg;
+}
+/** Raw config shape under `gateway.knowledge.reflection` (issue #392 part C). */
+export interface KnowledgeReflectionConfig {
+    enabled?: boolean;
+    dayOfWeek?: number;
+    hour?: number;
+    minute?: number;
+    timezone?: string;
+    maxClustersPerRun?: number;
+    reviewModel?: string;
+}
+/** Resolved, sanitized reflection config (all fields present). */
+export interface ResolvedKnowledgeReflectionCfg {
+    enabled: boolean;
+    dayOfWeek: number;
+    hour: number;
+    minute: number;
+    timezone: string;
+    maxClustersPerRun: number;
+    reviewModel: string;
 }
 /** One indexed source file. */
 export interface ArchiveSourceRow {

package/dist/agent/knowledge/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/agent/knowledge/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,gFAAgF;AAChF,MAAM,MAAM,WAAW,GAAG,OAAO,GAAG,OAAO,GAAG,WAAW,GAAG,QAAQ,CAAC;AAErE,qFAAqF;AACrF,MAAM,MAAM,WAAW,GAAG,aAAa,GAAG,MAAM,GAAG,WAAW,GAAG,UAAU,GAAG,SAAS,CAAC;AAExF,wFAAwF;AACxF,MAAM,WAAW,sBAAsB;IACrC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,+DAA+D;AAC/D,MAAM,WAAW,2BAA2B;IAC1C,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,6EAA6E;AAC7E,MAAM,WAAW,qBAAqB;IACpC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,SAAS,GAAG,MAAM,CAAC;IAC1B,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,iEAAiE;AACjE,MAAM,WAAW,0BAA0B;IACzC,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,SAAS,GAAG,MAAM,CAAC;IACzB,KAAK,EAAE,OAAO,CAAC;CAChB;AAED,+BAA+B;AAC/B,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,yBAAyB;AACzB,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,yEAAyE;AACzE,MAAM,WAAW,gBAAgB;IAC/B,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B;AAED,6CAA6C;AAC7C,MAAM,WAAW,oBAAoB;IACnC,WAAW,EAAE,WAAW,CAAC;IACzB,WAAW,EAAE,WAAW,CAAC;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;CAC9B;AAED,6DAA6D;AAC7D,MAAM,WAAW,WAAW;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;CACvB"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/agent/knowledge/types.ts"],"names":[],"mappings":"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"}

package/dist/agent/model-catalog.d.ts

@@ -0,0 +1,62 @@
+/**
+ * Live chat-model catalog (issue #409).
+ *
+ * The gateway's model list used to come only from `gateway.models` in
+ * config.json, written once at provisioning and never touched again — so a
+ * catalog that changed upstream could never reach the `/models` picker or
+ * `GET /api/v1/models`. This fetches the catalog from the same endpoint the
+ * session already talks to, and falls back to the static list.
+ *
+ * Provider-agnostic by construction: the base URL and token come from env /
+ * `~/.claude/settings.json`, never from a hardcoded vendor host. That mirrors
+ * the image tool's catalog fetch (`mcp/tools/image/module.ts`), which solved
+ * this same problem for image models. The URL-safety check below is a second
+ * implementation of that module's `baseUrlIsSecure` rather than a shared one:
+ * `tsconfig.json` pins `rootDir` to `src/`, so nothing here can import from
+ * `mcp/`. Keep the two in step.
+ */
+import type { ModelConfig } from '../types';
+/** Fallback context window for a model no catalog — live or static — describes. */
+export declare const DEFAULT_CONTEXT_WINDOW = 200000;
+/** Reset module state. Tests only — each case needs a clean cache. */
+export declare function resetModelCatalogCache(): void;
+/** Tests only — the settings file is read once per process otherwise. */
+export declare function resetSettingsEnvCache(): void;
+/**
+ * Where to fetch the catalog from. `MODELS_BASE_URL` lets a deployment point
+ * the catalog at a different host than the messages endpoint; otherwise it is
+ * the same `ANTHROPIC_BASE_URL` the session process already uses. Empty means
+ * "not configured", which is the signal to stay on the static list.
+ */
+export declare function catalogBaseUrl(): string;
+/**
+ * https is required for a public catalog host — the bearer token rides every
+ * call. http is tolerated only for a local/internal hop, where cleartext never
+ * leaves the machine or network.
+ */
+export declare function baseUrlIsSecure(raw: string): boolean;
+/**
+ * Turn a catalog response into `ModelConfig[]`, or null when it carries no
+ * usable model.
+ *
+ * Two response shapes are accepted because two are in the wild: Anthropic's
+ * `{ data: [{ id, display_name }] }` and the `{ models: [{ id, label }] }`
+ * shape this gateway's own endpoints emit. A proxy may front either.
+ *
+ * `alias`, `contextWindow` and `multiplier` are not part of any catalog
+ * response, so they are carried over from the static entry with the same id.
+ * That matters beyond cosmetics: `/session` reports context use as a
+ * percentage of `contextWindow`, and `/compact` sizes its window from it — a
+ * live model that lost those fields would silently report against 200k.
+ */
+export declare function parseModelCatalog(body: unknown, fallback: ModelConfig[]): ModelConfig[] | null;
+/**
+ * Fetch the live catalog, or return null to mean "use the static list".
+ *
+ * Never throws and never rejects: every caller is a picker or a list endpoint
+ * whose correct behaviour on any failure is to show the static list. A cached
+ * result is reused for {@link CATALOG_TTL_MS}; concurrent callers share one
+ * request.
+ */
+export declare function fetchModelCatalog(fallback: ModelConfig[], now?: number): Promise<ModelConfig[] | null>;
+//# sourceMappingURL=model-catalog.d.ts.map

package/dist/agent/model-catalog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-catalog.d.ts","sourceRoot":"","sources":["../../src/agent/model-catalog.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAKH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AA4B5C,mFAAmF;AACnF,eAAO,MAAM,sBAAsB,SAAU,CAAC;AAY9C,sEAAsE;AACtE,wBAAgB,sBAAsB,IAAI,IAAI,CAI7C;AAsBD,yEAAyE;AACzE,wBAAgB,qBAAqB,IAAI,IAAI,CAE5C;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,IAAI,MAAM,CAMvC;AAWD;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CA0BpD;AAID;;;;;;;;;;;;;GAaG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,GAAG,WAAW,EAAE,GAAG,IAAI,CA+C9F;AAID;;;;;;;GAOG;AACH,wBAAsB,iBAAiB,CACrC,QAAQ,EAAE,WAAW,EAAE,EACvB,GAAG,GAAE,MAAmB,GACvB,OAAO,CAAC,WAAW,EAAE,GAAG,IAAI,CAAC,CA8C/B"}