dsh-plugin-sessiongraph-sessions 0.1.16 → 0.1.17

package/lib/index.d.ts

@@ -103,6 +103,15 @@ export interface Config {
      * yet this builds the first one; with one already present it refreshes incrementally.
      */
     autoIndex?: boolean;
+    /**
+     * Shortest gap between two automatic refreshes of one index root, in milliseconds (default 60000).
+     *
+     * The window exists to absorb a burst of session creations into one run — opening five sessions at
+     * once must not queue five index jobs. Past it, the next session refreshes, which is what keeps the
+     * index current while the desktop stays up: an incremental run against a warm index takes tens of
+     * milliseconds and does not block the UI.
+     */
+    autoIndexMinIntervalMs?: number;
     /**
      * Build the very first index automatically in the background when a session starts (default
      * true). The first build reads every log on the machine and can take seconds to minutes, so it

package/lib/index.js

@@ -90,6 +90,7 @@ export const Config = z.object({
     toolCallChars: z.number().default(DEFAULT_TOOL_CALL_CHARS),
     maxFileBytes: z.number().default(DEFAULT_MAX_FILE_BYTES),
     autoIndex: z.boolean().default(true),
+    autoIndexMinIntervalMs: z.number().default(60_000),
     autoBuild: z.boolean().default(true),
     indexLockStaleMs: z.number().default(300_000),
     backgroundIndexThreshold: z.number().default(DEFAULT_BACKGROUND_INDEX_THRESHOLD),
@@ -112,16 +113,18 @@ export function apply(ctx, config) {
         throw new Error('sessiongraph-sessions: indexRoot must be a non-empty directory path');
     }
     const indexer = createIndexer(ctx, resolved);
-    // Process-local, private to this plugin instance: a root is auto-refreshed at most once per
-    // process, so a burst of session creations cannot queue a burst of index runs.
-    const autoIndexed = new Set();
+    // Process-local, private to this plugin instance: when this root last had an automatic refresh.
+    // A time window rather than "once per process": the whole point of the index is that what was just
+    // said is findable, and "once until restart" stopped being enough the moment the desktop stayed up
+    // for days. The window still absorbs a burst of session creations into one run.
+    const autoIndexRuns = new Map();
     // `agent/created` is typed by the host's agent service; this package reads only the two fields it
     // needs through a structural face rather than depending on that package.
     const agentEvents = ctx;
     ctx.effect(function* () {
         if (resolved.autoIndex) {
             yield agentEvents.on('agent/created', payload => {
-                scheduleAutoIndex(ctx, resolved, autoIndexed, payload);
+                scheduleAutoIndex(ctx, resolved, autoIndexRuns, payload);
             });
         }
         yield ctx.sessiongraph.registerIndexer(indexer);
@@ -172,10 +175,10 @@ export function isBackgroundIndexReport(report) {
  * only decides whether a refresh is warranted and hands one to the host's job registry.
  * @param ctx - the plugin context, consulted for the optional job registry.
  * @param config - the resolved plugin configuration.
- * @param autoIndexed - index roots this process has already scheduled a refresh for.
+ * @param autoIndexRuns - when each root last had an automatic refresh, in epoch milliseconds.
  * @param payload - the `agent/created` dispatch payload.
  */
-function scheduleAutoIndex(ctx, config, autoIndexed, payload) {
+function scheduleAutoIndex(ctx, config, autoIndexRuns, payload) {
     try {
         const agent = payload.agent;
         const workspace = agent?.session?.header?.cwd;
@@ -183,8 +186,12 @@ function scheduleAutoIndex(ctx, config, autoIndexed, payload) {
         if (agent === undefined || workspace === undefined || workspace === '')
             return;
         const indexRoot = expandHome(config.indexRoot);
-        // Once per root per process: a burst of session creations must not queue a burst of index runs.
-        if (autoIndexed.has(indexRoot))
+        const now = Date.now();
+        // Within the window, a burst of session creations must not queue a burst of index runs. Past it,
+        // the next session refreshes: sessions written since the last run are exactly what an incremental
+        // index exists to pick up, and it costs tens of milliseconds against a warm cache.
+        const previous = autoIndexRuns.get(indexRoot);
+        if (previous !== undefined && now - previous < config.autoIndexMinIntervalMs)
             return;
         // A first build reads every log on the machine and can take a while, so it stays a background
         // job like the incremental refresh. `autoBuild: false` restores the stricter behaviour where
@@ -208,7 +215,7 @@ function scheduleAutoIndex(ctx, config, autoIndexed, payload) {
         });
         // Marked only after the registry accepted the job, so a refusal leaves the root eligible for
         // the next session that opens.
-        autoIndexed.add(indexRoot);
+        autoIndexRuns.set(indexRoot, now);
     }
     catch (error) {
         // A throwing listener would veto publication of the agent. Losing a refresh is a degradation,
@@ -442,7 +449,7 @@ async function runNativeEngine(native, indexPath, options, config, inScope, ctx,
     let nativeReport;
     try {
         signal?.throwIfAborted();
-        nativeReport = native.indexSessions({
+        nativeReport = await native.indexSessions({
             sessionsRoot: config.sessionsRoot,
             indexPath,
             ...(options.force === undefined ? {} : { force: options.force }),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-plugin-sessiongraph-sessions",
-  "version": "0.1.16",
+  "version": "0.1.17",
   "description": "Session-log indexer for DeepSeek Harness — scans ~/.dsh/sessions, decompresses the multi-frame zstd JSONL logs and writes the sessiongraph SQLite index the store reads",
   "keywords": [
     "dsh",
@@ -49,8 +49,8 @@
   },
   "dependencies": {
     "@deepseek-ai/schemastery": "^3.18.1",
-    "dsh-plugin-sessiongraph-service": "^0.1.16",
-    "dsh-plugin-sessiongraph-native": "^0.1.16"
+    "dsh-plugin-sessiongraph-service": "^0.1.17",
+    "dsh-plugin-sessiongraph-native": "^0.1.17"
   },
   "peerDependencies": {
     "@deepseek-ai/cordis": ">=4.0.1",