@agenr/skeln-plugin 2026.6.2 → 2026.6.3

package/dist/{chunk-Q5UTJXHZ.js → chunk-IBPS64W3.js}

@@ -1,6 +1,6 @@
 import {
   formatTargetSelectorFromParams
-} from "./chunk-LDJN7CVU.js";
+} from "./chunk-U74RE3L7.js";
 
 // src/adapters/openclaw/transcript/parser.ts
 import { createHash } from "crypto";

package/dist/{chunk-NBS62ES5.js → chunk-SIY3JA7T.js}

@@ -28,7 +28,7 @@ import {
   parseExpiry,
   parseRecallMode,
   storeDurablesDetailed
-} from "./chunk-LDJN7CVU.js";
+} from "./chunk-U74RE3L7.js";
 import {
   containsAgenrMemoryContext,
   createSessionStartRepository,
@@ -768,6 +768,17 @@ function buildSessionEndSourceRef(source) {
   return `${SESSION_END_SOURCE_REF_PREFIX}${source.trim()}`;
 }
 
+// src/adapters/shared/light-dream-trigger-deps.ts
+function buildLightDreamTriggerDeps(services) {
+  return {
+    port: services.dreaming,
+    dbPath: services.config.dbPath,
+    config: services.agenrConfig,
+    embedding: services.embedding,
+    ...services.claimExtraction ? { createClaimExtractionLlm: () => services.claimExtraction.llm } : {}
+  };
+}
+
 // src/app/dreaming/background-triggers.ts
 var MINUTE_MS = 60 * 1e3;
 async function maybeRunLightDream(input, deps) {
@@ -852,6 +863,36 @@ function hasEvidence(scan) {
   return scan.episodesSinceLastRun > 0 || scan.ingestFilesSinceLastRun > 0 || scan.durablesCreatedSinceLastRun > 0;
 }
 
+// src/adapters/shared/post-session-light-dream.ts
+async function runPostSessionLightDream(params) {
+  const contextSuffix = params.sessionContext ? ` for ${params.sessionContext}` : "";
+  try {
+    const result = await maybeRunLightDream({ trigger: "post_session" }, params.deps);
+    if (result.status === "ran") {
+      params.logger.info(`[agenr] ${params.scope} light dream completed${contextSuffix} run=${result.result.runId}`);
+      return;
+    }
+    if (result.reason === "run_in_progress" || result.reason === "episode_write_in_progress") {
+      params.logger.info(`[agenr] ${params.scope} light dream skipped${contextSuffix} reason=${result.reason}`);
+      return;
+    }
+    params.logger.debug?.(`[agenr] ${params.scope} light dream skipped${contextSuffix} reason=${result.reason}`);
+  } catch (error) {
+    params.logger.warn(`[agenr] ${params.scope} light dream failed${contextSuffix}: ${formatErrorMessage(error)}`);
+  }
+}
+
+// src/adapters/shared/guarded-post-session-episode-capture.ts
+async function runGuardedPostSessionEpisodeCapture(params) {
+  await withEpisodeWriteGuard({ port: params.services.dreaming, dbPath: params.services.config.dbPath }, params.writeEpisode);
+  await runPostSessionLightDream({
+    deps: buildLightDreamTriggerDeps(params.services),
+    logger: params.logger,
+    scope: params.scope,
+    sessionContext: params.sessionContext
+  });
+}
+
 // src/adapters/plugin-runtime/claim-extraction.ts
 async function buildClaimExtractionRuntime(config, resolveLlm) {
   const claimExtractionConfig = resolveClaimExtractionConfig(config);
@@ -2042,6 +2083,12 @@ async function createHostMemoryServices(featureFlags, options = {}) {
   };
 }
 
+// src/adapters/shared/shutdown-episode-threshold.ts
+var HOST_SHUTDOWN_EPISODE_ACTIVITY_THRESHOLD = {
+  minMaterialTurns: 8,
+  minDurationMs: 20 * 60 * 1e3
+};
+
 // src/adapters/shared/bounded-episode-embedding.ts
 var EPISODE_EMBEDDING_RACE_TIMEOUT = /* @__PURE__ */ Symbol("episode-embedding-race-timeout");
 var EPISODE_EMBEDDING_MIN_HEADROOM_MS = 5e3;
@@ -2982,6 +3029,7 @@ export {
   isPluginEpisodeWriteEnabled,
   resolveAgenrFeatureFlags,
   resolveCompactionPromptContext,
+  HOST_SHUTDOWN_EPISODE_ACTIVITY_THRESHOLD,
   embedEpisodeSummaryWithinBudget,
   EPISODE_SUMMARY_TIMEOUT_MS,
   writeBoundedSingleTranscriptEpisode,
@@ -2989,7 +3037,9 @@ export {
   buildSessionFileSourceRef,
   buildCompactionSourceRef,
   buildSessionEndSourceRef,
+  buildLightDreamTriggerDeps,
   maybeRunLightDream,
+  runGuardedPostSessionEpisodeCapture,
   buildClaimExtractionRuntime,
   createClaimExtractionFromAgenrConfig,
   createEmbedQuery,

package/dist/{chunk-LDJN7CVU.js → chunk-U74RE3L7.js}

@@ -343,64 +343,6 @@ function sanitizeFetchToolParams(params) {
   };
 }
 
-// src/app/episode-ingest/activity-threshold.ts
-function resolveEpisodeActivityEligibility(materialTurns, startedAt, endedAt, threshold) {
-  const durationMs = resolveTranscriptDurationMs(startedAt, endedAt);
-  if (materialTurns >= threshold.minMaterialTurns || durationMs >= threshold.minDurationMs) {
-    return {
-      eligible: true,
-      materialTurns,
-      durationMs
-    };
-  }
-  return {
-    eligible: false,
-    reason: "below_activity_threshold",
-    materialTurns,
-    durationMs
-  };
-}
-function resolveTranscriptDurationMs(startedAt, endedAt) {
-  if (!startedAt || !endedAt) {
-    return 0;
-  }
-  const started = Date.parse(startedAt);
-  const ended = Date.parse(endedAt);
-  return Number.isFinite(started) && Number.isFinite(ended) && ended > started ? ended - started : 0;
-}
-
-// src/core/episode/transcript-render.ts
-var MIN_EPISODE_MESSAGES = 4;
-var MAX_EPISODE_TRANSCRIPT_CHARS = 14e3;
-function countMaterialTranscriptTurns(messages) {
-  return messages.filter((message) => message.text.trim().length > 0).length;
-}
-function renderTranscript(messages) {
-  return messages.map((message) => `${message.role === "user" ? "User" : "Assistant"}: ${message.text.trim()}`).join("\n");
-}
-function capEpisodeTranscript(transcript, maxChars) {
-  if (transcript.length <= maxChars) {
-    return transcript;
-  }
-  const omissionMarker = "\n\n[Earlier middle transcript omitted for brevity]\n\n";
-  const headBudget = Math.max(0, Math.floor((maxChars - omissionMarker.length) * 0.35));
-  const tailBudget = Math.max(0, maxChars - omissionMarker.length - headBudget);
-  const head = trimToBoundary(transcript.slice(0, headBudget), false);
-  const tail = trimToBoundary(transcript.slice(-tailBudget), true);
-  return `${head}${omissionMarker}${tail}`.trim();
-}
-function trimToBoundary(value, fromStart) {
-  if (value.length === 0) {
-    return value;
-  }
-  if (fromStart) {
-    const boundary = value.search(/\s/u);
-    return boundary >= 0 ? value.slice(boundary).trimStart() : value.trim();
-  }
-  const reversedBoundary = value.trimEnd().search(/\s\S*$/u);
-  return reversedBoundary >= 0 ? value.slice(0, reversedBoundary).trimEnd() : value.trim();
-}
-
 // src/app/episode-ingest/single-transcript.ts
 function createSingleTranscriptDiscoveryPort(filePath) {
   return {
@@ -693,6 +635,66 @@ async function generateEpisodeSummary(transcript, llm) {
 
 // src/app/episode-ingest/service/preflight.ts
 import path from "path";
+
+// src/app/episode-ingest/activity-threshold.ts
+function resolveEpisodeActivityEligibility(materialTurns, startedAt, endedAt, threshold) {
+  const durationMs = resolveTranscriptDurationMs(startedAt, endedAt);
+  if (materialTurns >= threshold.minMaterialTurns || durationMs >= threshold.minDurationMs) {
+    return {
+      eligible: true,
+      materialTurns,
+      durationMs
+    };
+  }
+  return {
+    eligible: false,
+    reason: "below_activity_threshold",
+    materialTurns,
+    durationMs
+  };
+}
+function resolveTranscriptDurationMs(startedAt, endedAt) {
+  if (!startedAt || !endedAt) {
+    return 0;
+  }
+  const started = Date.parse(startedAt);
+  const ended = Date.parse(endedAt);
+  return Number.isFinite(started) && Number.isFinite(ended) && ended > started ? ended - started : 0;
+}
+
+// src/core/episode/transcript-render.ts
+var MIN_EPISODE_MESSAGES = 4;
+var MAX_EPISODE_TRANSCRIPT_CHARS = 14e3;
+function countMaterialTranscriptTurns(messages) {
+  return messages.filter((message) => message.text.trim().length > 0).length;
+}
+function renderTranscript(messages) {
+  return messages.map((message) => `${message.role === "user" ? "User" : "Assistant"}: ${message.text.trim()}`).join("\n");
+}
+function capEpisodeTranscript(transcript, maxChars) {
+  if (transcript.length <= maxChars) {
+    return transcript;
+  }
+  const omissionMarker = "\n\n[Earlier middle transcript omitted for brevity]\n\n";
+  const headBudget = Math.max(0, Math.floor((maxChars - omissionMarker.length) * 0.35));
+  const tailBudget = Math.max(0, maxChars - omissionMarker.length - headBudget);
+  const head = trimToBoundary(transcript.slice(0, headBudget), false);
+  const tail = trimToBoundary(transcript.slice(-tailBudget), true);
+  return `${head}${omissionMarker}${tail}`.trim();
+}
+function trimToBoundary(value, fromStart) {
+  if (value.length === 0) {
+    return value;
+  }
+  if (fromStart) {
+    const boundary = value.search(/\s/u);
+    return boundary >= 0 ? value.slice(boundary).trimStart() : value.trim();
+  }
+  const reversedBoundary = value.trimEnd().search(/\s\S*$/u);
+  return reversedBoundary >= 0 ? value.slice(0, reversedBoundary).trimEnd() : value.trim();
+}
+
+// src/app/episode-ingest/service/preflight.ts
 var ACTIVE_SESSION_WINDOW_MS = 5 * 60 * 1e3;
 async function prepareEpisodeIngest(targetPath, ports, options = {}) {
   const files = await ports.files.discoverFiles(targetPath);

package/dist/index.js

@@ -6,10 +6,12 @@ import {
 import {
   EPISODE_SUMMARY_TIMEOUT_MS,
   FETCH_TOOL_PARAMETERS,
+  HOST_SHUTDOWN_EPISODE_ACTIVITY_THRESHOLD,
   RECALL_TOOL_PARAMETERS,
   STORE_TOOL_PARAMETERS,
   UPDATE_TOOL_PARAMETERS,
   buildCompactionSourceRef,
+  buildLightDreamTriggerDeps,
   buildRecallToolServices,
   buildSessionFileSourceRef,
   composeHostPluginServices,
@@ -42,12 +44,13 @@ import {
   resolveWorkingContextGate,
   routeSessionMemoryTriggerSafely,
   runFetchMemoryTool,
+  runGuardedPostSessionEpisodeCapture,
   runRecallMemoryTool,
   runStoreMemoryTool,
   runUpdateMemoryTool,
   scheduleGuardedEpisodeWrite,
   writeBoundedSingleTranscriptEpisode
-} from "./chunk-NBS62ES5.js";
+} from "./chunk-SIY3JA7T.js";
 import "./chunk-OJSIZDZD.js";
 import {
   WORKING_CANDIDATE_PROMOTION_STATUSES,
@@ -68,7 +71,7 @@ import {
   formatTargetSelector,
   sanitizeFetchToolParams,
   sanitizeUpdateToolParams
-} from "./chunk-LDJN7CVU.js";
+} from "./chunk-U74RE3L7.js";
 import {
   formatAgenrBeforeTurnRecall,
   runBeforeTurn,
@@ -81,9 +84,7 @@ import {
   resolveModel
 } from "./chunk-5TIP2EPP.js";
 import "./chunk-GAERET5Q.js";
-import {
-  withEpisodeWriteGuard
-} from "./chunk-SOQW7356.js";
+import "./chunk-SOQW7356.js";
 import {
   isRecord,
   readOptionalFiniteNumber,
@@ -614,10 +615,6 @@ function resolveSessionFile(context) {
 
 // src/adapters/skeln/episode/episode-writer.ts
 var SKELN_EPISODE_GENERATOR_VERSION = "skeln-episodic-summary-v1";
-var SKELN_PHASE4_SHUTDOWN_EPISODE_ACTIVITY_THRESHOLD = {
-  minMaterialTurns: 8,
-  minDurationMs: 20 * 60 * 1e3
-};
 async function writeSkelnShutdownEpisode(params) {
   await writeSkelnBoundedSessionEpisode({
     target: params.target,
@@ -625,7 +622,7 @@ async function writeSkelnShutdownEpisode(params) {
     logger: params.logger,
     actionLabel: "skeln shutdown episode write",
     genVersion: SKELN_EPISODE_GENERATOR_VERSION,
-    activityThreshold: SKELN_PHASE4_SHUTDOWN_EPISODE_ACTIVITY_THRESHOLD,
+    activityThreshold: HOST_SHUTDOWN_EPISODE_ACTIVITY_THRESHOLD,
     buildSourceRef: (sessionFile) => sessionFile,
     logContext: `session=${params.target.sessionId} key=skeln:${params.target.sessionId}`,
     skipDetails: `session=${params.target.sessionId}`
@@ -1114,7 +1111,7 @@ function buildSkelnSessionShutdownEpisodeWork(params) {
 }
 function scheduleSkelnSessionShutdownEpisodeWrite(params) {
   const work = buildSkelnSessionShutdownEpisodeWork(params);
-  if (params.event.reason === "quit" && params.event.deferWork) {
+  if (params.event.deferWork) {
     params.event.deferWork(work);
     return Promise.resolve();
   }
@@ -1140,30 +1137,12 @@ async function writeScopedSkelnShutdownEpisode(servicesPromise, target, logger)
   if (!isPluginEpisodeWriteEnabled(services.skelnConfig.memoryPolicy)) {
     return;
   }
-  await withEpisodeWriteGuard({ port: services.dreaming, dbPath: services.config.dbPath }, async () => writeSkelnShutdownEpisode({ target, services, logger }));
-  await runSkelnPostSessionLightDream(services, logger);
-}
-async function runSkelnPostSessionLightDream(services, logger) {
-  const log = logger ?? console;
-  try {
-    const result = await maybeRunLightDream(
-      { trigger: "post_session" },
-      {
-        port: services.dreaming,
-        dbPath: services.config.dbPath,
-        config: services.agenrConfig,
-        embedding: services.embedding,
-        ...services.claimExtraction ? { createClaimExtractionLlm: () => services.claimExtraction.llm } : {}
-      }
-    );
-    if (result.status === "ran") {
-      log.info(`[agenr] skeln shutdown light dream completed run=${result.result.runId}`);
-    } else if (result.reason === "run_in_progress" || result.reason === "episode_write_in_progress") {
-      log.info(`[agenr] skeln shutdown light dream skipped reason=${result.reason}`);
-    }
-  } catch (error) {
-    log.warn(`[agenr] skeln shutdown light dream failed: ${formatErrorMessage(error)}`);
-  }
+  await runGuardedPostSessionEpisodeCapture({
+    services,
+    writeEpisode: () => writeSkelnShutdownEpisode({ target, services, logger }),
+    logger: logger ?? console,
+    scope: "skeln shutdown"
+  });
 }
 
 // src/app/features/capabilities.ts
@@ -1644,16 +1623,7 @@ function triggerSkelnImportanceLightDream(services, status) {
   if (status !== "stored") {
     return;
   }
-  void maybeRunLightDream(
-    { trigger: "importance" },
-    {
-      port: services.dreaming,
-      dbPath: services.config.dbPath,
-      config: services.agenrConfig,
-      embedding: services.embedding,
-      ...services.claimExtraction ? { createClaimExtractionLlm: () => services.claimExtraction.llm } : {}
-    }
-  ).then((result) => {
+  void maybeRunLightDream({ trigger: "importance" }, buildLightDreamTriggerDeps(services)).then((result) => {
     if (result.status === "ran") {
       console.info(`[agenr] skeln importance light dream completed run=${result.result.runId}`);
     } else if (result.reason === "run_in_progress" || result.reason === "episode_write_in_progress") {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agenr/skeln-plugin",
-  "version": "2026.6.2",
+  "version": "2026.6.3",
   "description": "agenr memory plugin for Skeln",
   "type": "module",
   "types": "./dist/index.d.ts",