@snoai/memory 1.2.9 → 1.2.11

package/README.md

@@ -1,6 +1,6 @@
 # @snoai/memory
 
-The memory engine behind Sno Station: encrypted, local, shared by every agent you run.
+The memory engine behind Sno Station: encrypted, local, used by every agent you run.
 
 It stores what your coding agents learn, finds it again when it matters, and corrects it
 without losing history. Claude Code, Codex, OpenClaw and Hermes Agent all talk to this one
@@ -13,14 +13,14 @@ engine, so what one agent learns is there for the next.
 - **Encrypted from first use.** The store is a SQLite database encrypted with a key made once
   on your machine (`@snoai/sqlite-crypto`). Sno never receives your database or your key.
 - **No account, no API key to start.** Local First mode runs fully on your machine; Agent
-  Native and REM Enhanced let a model help with the memory work.
+  Native and REM Enhanced let a model help with the memory work. REM is how your agents dream: overnight they strengthen their memory and settle what they learned. In REM Enhanced your memory text and lessons go to your own space in Sno's cloud, which works like your own cloud drive: a Sno program processes it for you alone, and you can delete it at any time.
 - **Eight languages.** English, Chinese (Simplified and Traditional), Japanese, Korean,
   German, French, Spanish and Russian, with each memory stored with its language.
 - **No daemon.** The engine runs as a local service on `127.0.0.1` that the agent plugins
   start when they need it.
 
 Who it is for: you do not use this package directly. Follow the
-[shared memory setup](https://github.com/sno-ai/sno-station/blob/main/docs/memory-setup.md)
+[memory service setup](https://github.com/sno-ai/sno-station/blob/main/docs/memory-setup.md)
 (it installs this package into `~/.sno`), then add the plugin for your agent:
 [Codex](https://www.npmjs.com/package/@snoai/mem-codex),
 [Claude Code](https://www.npmjs.com/package/@snoai/mem-claude) or
@@ -28,7 +28,7 @@ Who it is for: you do not use this package directly. Follow the
 plugins use to reach the service.
 
 ```bash
-npm install @snoai/memory@1.2.9
+npm install @snoai/memory@1.2.11
 ```
 
 Needs Node.js 22.22.3+, 24.15.0+ or 25.9.0+. Licensed under Apache-2.0.

package/dist/{access-tracker-D1e-2-Bb.d.ts → access-tracker-BOPHSJjf.d.ts}

@@ -1,7 +1,7 @@
-import { v as MemoryMetadata } from "./types-Del9J7UB.js";
-import { sn as RecallLifecycleConfig } from "./index-DL8AVj0Z.js";
-import { C as MemoryStore } from "./memory-store-base-z593oJ4h.js";
-import "./store-DKndKig1.js";
+import { v as MemoryMetadata } from "./types-Ae3a8562.js";
+import { sn as RecallLifecycleConfig } from "./index-Pb9LrHgL.js";
+import { C as MemoryStore } from "./memory-store-base-Bk2dOKED.js";
+import "./store-BDIAl2cc.js";
 //#region src/engine/retrieval/access-tracker.d.ts
 interface AccessMetadata {
   readonly accessCount: number;

package/dist/{adapter-TCrv5P-C.d.ts → adapter-lyb6RaQE.d.ts}

@@ -1,5 +1,5 @@
-import { t as PluginConfig } from "./plugin-config-schema-VBSPGEG3.js";
-import "./types-Del9J7UB.js";
+import { t as PluginConfig } from "./plugin-config-schema-BrhMvnXJ.js";
+import "./types-Ae3a8562.js";
 import { t as ObserveLogger } from "./best-effort-BPZSzKk0.js";
 import { AgentId, EventType, JsonObject } from "@snoai/observability";
 //#region src/engine/observability/cost-aggregator.d.ts

package/dist/{atomic-memory-extraction-C0n0wHzt.d.ts → atomic-memory-extraction-B_XpkhMd.d.ts}

@@ -1,9 +1,9 @@
-import { i as LlmClientConfig, l as ModelCallId, p as LlmRoutingConfig, r as LlmClient } from "./plugin-config-schema-VBSPGEG3.js";
+import { i as LlmClientConfig, l as ModelCallId, p as LlmRoutingConfig, r as LlmClient } from "./plugin-config-schema-BrhMvnXJ.js";
 import { n as Locale } from "./locales-JxGmkG6t.js";
-import { qt as AdapterAMemoryView } from "./index-BO4RU_mc.js";
-import { C as MemoryStore, c as AtomicExtractionRunParameters, f as AtomicExtractionWriteResult, g as BeginAtomicExtractionChunkResult, r as AtomicExtractionLedgerKey, s as AtomicExtractionReprocessReason, x as MemoryRelationPredicate } from "./memory-store-base-z593oJ4h.js";
-import "./store-DKndKig1.js";
-import "./llm-client-RqmOEQkg.js";
+import { qt as AdapterAMemoryView } from "./index-DPfJrOFD.js";
+import { C as MemoryStore, c as AtomicExtractionRunParameters, f as AtomicExtractionWriteResult, g as BeginAtomicExtractionChunkResult, r as AtomicExtractionLedgerKey, s as AtomicExtractionReprocessReason, x as MemoryRelationPredicate } from "./memory-store-base-Bk2dOKED.js";
+import "./store-BDIAl2cc.js";
+import "./llm-client-BTaUVmDe.js";
 import { z } from "zod";
 //#region src/engine/extraction/calendar-instruction.d.ts
 type CalendarPrecision = "year" | "month" | "week" | "day" | "minute";
@@ -296,6 +296,8 @@ interface AtomicExtractPersistResult {
 interface AtomicInsightDistillerConfig {
   defaultScope: string;
   locale?: Locale;
+  scheduleArrivalRetirement?: (task: () => Promise<void>) => void;
+  captureBatch?: boolean;
 }
 interface WindowDiagnostics {
   proposed: number;

package/dist/{atomic-memory-extraction-BG42OXou.js → atomic-memory-extraction-o2v8mp7G.js}

@@ -2,22 +2,22 @@ import { ATOMIC_CAPTURE_OUTPUT_TOKEN_BUDGET, ATOMIC_CAPTURE_TIMEOUT_MS, ATOMIC_E
 import "./internal/engine/i18n/locales.js";
 import { $ as FIXED_MEMORY_SNO_EXTRACT_PROFILE, Q as FIXED_MEMORY_SNO_EXTRACT_CHAT } from "./signed-registry-constants-yq3DlG3B.js";
 import { redactSecrets } from "./internal/engine/security/redact.js";
-import { a as isTerminalLlmFailure, i as createLlmClient, n as LlmClientTerminalError } from "./llm-client-fVrzPcyz.js";
+import { t as appendAuditEntry } from "./runtime-audit-log-DK6xAYxh.js";
+import { a as isTerminalLlmFailure, i as createLlmClient, n as LlmClientTerminalError } from "./llm-client-ConEyQEs.js";
 import { n as readModelReplyJson } from "./model-reply-text-CKopStP2.js";
 import { resolveLlmRoute } from "./internal/model/llm-mode-routing.js";
 import { n as ATOMIC_EXTRACTION_SKILL_HASH, r as atomicExtractionSkillReference, t as ATOMIC_EXTRACTION_SKILL } from "./atomic-extraction-skill-CcXmuCqL.js";
 import { stripEnvelopeMetadata } from "./internal/engine/extraction/extraction-text-sanitizer.js";
 import { a as sessionZoneCarriedBy, t as calculateCalendarTime } from "./calendar-instruction-CzqZbAPG.js";
-import "./memory-temporality-classifier-CeSOL2vq.js";
-import { t as appendAuditEntry } from "./runtime-audit-log-BCeujlEp.js";
+import "./memory-temporality-classifier-MBJyJdvB.js";
 import { a as parseAtomicCaptureReply, c as atomic_extraction_response_schema_default, i as fallbackAtomicCapturedFact, l as excludeProgressRecords, n as ATOMIC_ENRICHMENT_RESPONSE_JSON_SCHEMA, o as parseAtomicEnrichmentReply, r as ATOMIC_EXTRACTION_RESPONSE_JSON_SCHEMA, s as parseAtomicExtractionReply, t as ATOMIC_CAPTURE_RESPONSE_JSON_SCHEMA } from "./atomic-extraction-reply-BJ9XV_9s.js";
 import { adapterAViewFromRecord, isAdapterAVerdictReply, parseAdapterAChatVerdict, renderAdapterAChatPrompt, renderAdapterAPrompt } from "./internal/engine/rem/index.js";
 import { n as state_vocabulary_default, r as attribute_dictionary_default, t as relations } from "./relation-dictionary-Cev1kyLe.js";
-import { g as randomUUID$1 } from "./memory-store-shared-DqpWJXZZ.js";
-import { b as normalizeMemoryRelationPredicate, d as normalizeEntityName, f as recordAtomicEntityIdentityJournal, g as readAtomicArrivalRetirementCandidateSet, h as journalAtomicArrivalRetirementRefusal, m as closeAtomicArrivalRetirementTargets, u as listAtomicMemoryEntityCandidates, v as AtomicExtractionCompletedElsewhere } from "./store-CUk-jEGA.js";
+import { g as randomUUID$1 } from "./memory-store-shared-CURizQIy.js";
+import { b as normalizeMemoryRelationPredicate, d as normalizeEntityName, f as recordAtomicEntityIdentityJournal, g as readAtomicArrivalRetirementCandidateSet, h as journalAtomicArrivalRetirementRefusal, m as closeAtomicArrivalRetirementTargets, u as listAtomicMemoryEntityCandidates, v as AtomicExtractionCompletedElsewhere } from "./store-BQxkgJTX.js";
 import { o as normalizeTopicToSectionName } from "./b-profile-section-dictionary-provider-BHkoNqgk.js";
 import { r as recordTokenCounter } from "./memory-store-write-validation-B_hDG2zf.js";
-import { i as prepareDeterministicTaskLifecycleWrite, t as PROFILE_IDENTITY_SECTION } from "./profile-section-writer-joJEIYhF.js";
+import { i as prepareDeterministicTaskLifecycleWrite, t as PROFILE_IDENTITY_SECTION } from "./profile-section-writer-CmNa95uN.js";
 import { z } from "zod";
 import { countTokens } from "@snoai/chunking";
 import { createLogger, currentLogContext, privateLogReference, withLogContext } from "@snoai/utils/logger";
@@ -909,7 +909,8 @@ function parseBProfileMessages(conversationText) {
 * One logical task: one initial attempt plus at most one retry.
 *
 * The transport collapses "could not reach it" and "it answered with nothing" into a null
-* completion, and both are retryable, as is a reply that fails either validation stage. A reply
+* completion; an empty answer ends the turn at once (asking again gets the same nothing), while
+* a connection failure or a reply that fails either validation stage is retried. A reply
 * that passes is never retried — including one whose candidates all dropped, which is a real
 * answer about that turn and not a failure to get one.
 */
@@ -920,13 +921,14 @@ async function extractOneTurn(prompt, llm, turnIndex, turnText) {
 			raw = await llm.completeText({
 				prompt,
 				callId: "E9",
-				maxTokens: PROFILE_EXTRACTION_MAX_TOKENS
+				maxTokens: PROFILE_EXTRACTION_MAX_TOKENS,
+				emptyReplyAttempts: 1
 			});
 		} catch (error) {
 			if (isRetryableTransportError(error)) continue;
 			throw error;
 		}
-		if (raw === null) continue;
+		if (raw === null) return void 0;
 		const outcome = readReply(raw, turnIndex, turnText);
 		if (outcome) return outcome;
 	}
@@ -1364,12 +1366,22 @@ function buildAtomicGenericExtractionPrompt(turns, sessionDateTime, locale = "en
 }
 function renderAtomicLaneContext(input) {
 	const locale = input.locale ?? "en";
+	const turns = numberAtomicTurns(input.turns);
+	const preceding = [...input.contextTurns ?? []];
+	const following = [...input.followingTurns ?? []];
+	while (countTokens(JSON.stringify({
+		turns,
+		preceding,
+		following
+	})) > input.runParameters.maxInputTokens) if (preceding.length > 0) preceding.shift();
+	else if (following.length > 0) following.pop();
+	else break;
 	return [
 		`session_date_time: ${input.sessionDateTime ?? "unknown"}`,
 		atomicExtractionSkillReference("surrounding-context"),
-		`preceding_context: ${renderAtomicPromptData(input.contextTurns ?? [], locale).value}`,
-		`following_context: ${renderAtomicPromptData(input.followingTurns ?? [], locale).value}`,
-		`transcript:\n${renderAtomicPromptData(numberAtomicTurns(input.turns), locale).value}`
+		`preceding_context: ${renderAtomicPromptData(preceding, locale).value}`,
+		`following_context: ${renderAtomicPromptData(following, locale).value}`,
+		`transcript:\n${renderAtomicPromptData(turns, locale).value}`
 	].join("\n\n");
 }
 function buildAtomicCapturePrompt(input) {
@@ -1856,6 +1868,22 @@ async function splitAtomicCaptureTurn(input, outputTokenBudget, attempts, failed
 	};
 }
 async function captureAtomicWindow(input, outputTokenBudget, attempts) {
+	if (countTokens(JSON.stringify({
+		turns: numberAtomicTurns(input.turns),
+		preceding: [],
+		following: []
+	})) > input.runParameters.maxInputTokens) {
+		if (input.turns.length > 1) return splitAtomicCaptureWindow(input, outputTokenBudget, attempts);
+		if (splitTurnContent(input.turns[0]?.content ?? "") === void 0) {
+			input.store.recordAtomicExtractionCalls(input.ledgerKey, input.nowMs());
+			return {
+				status: "pending",
+				reason: "input-overflow",
+				failedReply: ""
+			};
+		}
+		return splitAtomicCaptureTurn(input, outputTokenBudget, attempts, "");
+	}
 	const sanitizedInput = sanitizeAtomicPromptValue(input.turns, input.locale ?? "en");
 	const prompt = buildAtomicCapturePrompt(input);
 	let lastReply = "";
@@ -2372,6 +2400,7 @@ function countTodoTransitionsWithoutSource(database) {
 */
 const log = createLogger("sno-station-mem:atomic-extraction-windows");
 const windowDiagnosticContext = new AsyncLocalStorage();
+const arrivalRetirementContext = new AsyncLocalStorage();
 function windowDiagnostics() {
 	return {
 		proposed: 0,
@@ -2575,10 +2604,10 @@ function parseAtomicConversationTurns(conversationText) {
 	if (current) turns.push(current);
 	return turns;
 }
-function atomicConversationWindows(turns) {
+function atomicConversationWindows(turns, captureBatch = false) {
 	const userIndexes = turns.flatMap((turn, index) => turn.role === "user" ? [index] : []);
 	if (userIndexes.length === 0) return [];
-	if (userIndexes.length <= 2) return [{
+	if (captureBatch || userIndexes.length <= 2) return [{
 		turns: [...turns],
 		contextTurns: [],
 		followingTurns: [],
@@ -2743,7 +2772,14 @@ function createSignedAtomicMemoryExtractionTransports(config, locale = "en") {
 		retirementVerdict: { judge: (pair) => chat.completeText({
 			prompt: adapterPrompt ? renderAdapterAPrompt(pair.older, pair.newer) : renderAdapterAChatPrompt(pair),
 			hostPrompt: renderAdapterAChatPrompt(pair),
-			callId: "E10"
+			callId: "E10",
+			takeProviderAttempt: () => {
+				const work = arrivalRetirementContext.getStore();
+				if (!work) return true;
+				if (work.providerCallsLeft <= 0) return false;
+				work.providerCallsLeft -= 1;
+				return true;
+			}
 		}) }
 	};
 }
@@ -2757,7 +2793,12 @@ var AtomicInsightDistiller = class {
 		this.config = config;
 	}
 	async extractAndPersist(conversationText, sessionKey, options = {}) {
-		return withLogContext({
+		const retirement = {
+			remaining: 3,
+			providerCallsLeft: 3,
+			...this.config.scheduleArrivalRetirement ? { tasks: [] } : {}
+		};
+		return arrivalRetirementContext.run(retirement, () => withLogContext({
 			operation_id: currentLogContext().operation_id ?? randomUUID(),
 			session_reference: sessionKey
 		}, async () => {
@@ -2766,7 +2807,7 @@ var AtomicInsightDistiller = class {
 			let captureOutcome = "failed";
 			try {
 				if (!sessionKey.trim()) throw new Error("Atomic extraction requires sessionKey");
-				const windows = atomicConversationWindows(parseAtomicConversationTurns(conversationText));
+				const windows = atomicConversationWindows(parseAtomicConversationTurns(conversationText), this.config.captureBatch);
 				if (windows.length === 0) log.warn("atomic extraction found no parseable turn; nothing will be stored", { session_reference: privateLogReference(sessionKey) }, {
 					event_name: "memory.atomic_memory_extraction.diagnostic",
 					file: "packages/memory/src/engine/extraction/atomic-memory-extraction.ts",
@@ -2882,6 +2923,10 @@ var AtomicInsightDistiller = class {
 					...llmFailures > 0 ? { llmFailures } : {}
 				};
 			} finally {
+				const tasks = retirement.tasks;
+				if (tasks && tasks.length > 0) this.config.scheduleArrivalRetirement?.(async () => {
+					for (const task of tasks) await task();
+				});
 				const sum = (field) => diagnostics.reduce((total, row) => total + row[field], 0);
 				log[captureOutcome === "failed" ? "error" : "info"]("Memory capture completed", {
 					outcome: captureOutcome === "failed" && sum("persisted") > 0 ? "partial" : captureOutcome,
@@ -2910,7 +2955,7 @@ var AtomicInsightDistiller = class {
 					site_id: "memory.capture.completed"
 				});
 			}
-		});
+		}));
 	}
 };
 async function resolveSubjects(store, projectId, records, transport, jobId, nowMs) {
@@ -3476,37 +3521,47 @@ async function runAtomicMemoryExtraction(input) {
 		diagnostic.outcome = write.createdCount > 0 ? "success" : "empty_success";
 		publishClaims();
 		const nominatedCards = cards.filter((card) => card.lane === "active");
-		for (const card of nominatedCards) {
-			const stored = input.store.findByExtractionIdempotencyKey(input.projectId, card.idempotencyKey);
-			if (stored === void 0) continue;
-			try {
-				await runAtomicArrivalRetirementJudgment({
-					store: input.store,
-					projectId: input.projectId,
-					jobId: input.ledgerKey.conversationId,
-					nominatedRowId: stored.id,
-					nowMs: atomicFactWrite.nowMs,
-					transport: input.transports.retirementVerdict
-				});
-			} catch (error) {
-				log.error("atomic arrival retirement failed after write; older facts stay current", {
-					nominatedRowId: stored.id,
-					session_reference: privateLogReference(input.ledgerKey.conversationId),
-					error
-				}, {
-					event_name: "memory.atomic_memory_extraction.diagnostic",
-					file: "packages/memory/src/engine/extraction/atomic-memory-extraction.ts",
-					function: "runAtomicMemoryExtraction",
-					site_id: "extraction.atomic-memory-extraction.runAtomicMemoryExtraction.0d9673d494"
-				});
-				journalAtomicArrivalRetirementRefusal(input.store, {
-					jobId: input.ledgerKey.conversationId,
-					nominatedRowId: stored.id,
-					reason: `judgment_failed:${error instanceof Error ? error.message : String(error)}`,
-					candidateSetSize: 0
-				});
+		const retirement = arrivalRetirementContext.getStore() ?? {
+			remaining: 3,
+			providerCallsLeft: 3
+		};
+		const retire = async () => {
+			for (const card of nominatedCards) {
+				if (retirement.remaining <= 0 || retirement.providerCallsLeft <= 0) break;
+				const stored = input.store.findByExtractionIdempotencyKey(input.projectId, card.idempotencyKey);
+				if (stored === void 0) continue;
+				try {
+					await runAtomicArrivalRetirementJudgment({
+						store: input.store,
+						projectId: input.projectId,
+						jobId: input.ledgerKey.conversationId,
+						nominatedRowId: stored.id,
+						nowMs: atomicFactWrite.nowMs,
+						transport: input.transports.retirementVerdict,
+						budget: retirement
+					});
+				} catch (error) {
+					log.error("atomic arrival retirement failed after write; older facts stay current", {
+						nominatedRowId: stored.id,
+						session_reference: privateLogReference(input.ledgerKey.conversationId),
+						error
+					}, {
+						event_name: "memory.atomic_memory_extraction.diagnostic",
+						file: "packages/memory/src/engine/extraction/atomic-memory-extraction.ts",
+						function: "runAtomicMemoryExtraction",
+						site_id: "extraction.atomic-memory-extraction.runAtomicMemoryExtraction.0d9673d494"
+					});
+					journalAtomicArrivalRetirementRefusal(input.store, {
+						jobId: input.ledgerKey.conversationId,
+						nominatedRowId: stored.id,
+						reason: `judgment_failed:${error instanceof Error ? error.message : String(error)}`,
+						candidateSetSize: 0
+					});
+				}
 			}
-		}
+		};
+		if (retirement.tasks) retirement.tasks.push(retire);
+		else await retire();
 		return {
 			status: "complete",
 			records: resolved.records,
@@ -3604,9 +3659,13 @@ async function runAtomicArrivalRetirementJudgment(input) {
 	const candidateSet = await readAtomicArrivalRetirementCandidateSet(input.store, input);
 	if (candidateSet === void 0 || candidateSet.candidateRows.length === 0) return;
 	const replaced = /* @__PURE__ */ new Set();
-	const queue = [...candidateSet.candidateRows];
+	const queue = candidateSet.candidateRows.slice(0, input.budget.remaining);
+	input.budget.remaining -= queue.length;
 	const judgeQueued = async () => {
-		for (let candidate = queue.shift(); candidate !== void 0; candidate = queue.shift()) if (await judgeArrivalRetirementPair(input, candidateSet, candidate) === "replacement") replaced.add(candidate.id);
+		for (let candidate = queue.shift(); candidate !== void 0; candidate = queue.shift()) {
+			if (input.budget.providerCallsLeft <= 0) break;
+			if (await judgeArrivalRetirementPair(input, candidateSet, candidate) === "replacement") replaced.add(candidate.id);
+		}
 	};
 	await Promise.all(Array.from({ length: ARRIVAL_RETIREMENT_PAIRS_IN_FLIGHT }, judgeQueued));
 	await closeAtomicArrivalRetirementTargets(input.store, {

package/dist/{b-profile-section-dictionary-provider-y3DMQ518.d.ts → b-profile-section-dictionary-provider-BK5NBs-y.d.ts}

@@ -1,4 +1,4 @@
-import { g as ProductMode } from "./plugin-config-schema-VBSPGEG3.js";
+import { g as ProductMode } from "./plugin-config-schema-BrhMvnXJ.js";
 import { n as Locale } from "./locales-JxGmkG6t.js";
 import { z } from "zod";
 //#region src/engine/extraction/b-profile-section-registry.d.ts

package/dist/{capture-policy-detector-BY7v5Cq1.d.ts → capture-policy-detector-BvVGmxxX.d.ts}

@@ -1,4 +1,4 @@
-import { h as MemoryCategory } from "./types-Del9J7UB.js";
+import { h as MemoryCategory } from "./types-Ae3a8562.js";
 //#region src/engine/extraction/capture-policy-detector.d.ts
 declare const PROMPT_INJECTION_PATTERNS: RegExp[];
 /** Implements looks like prompt injection as the local memory capture policy operation. */

package/dist/{classifier-DnbbtwTS.d.ts → classifier-CXQxJJPP.d.ts}

@@ -123,7 +123,7 @@ interface RemRepository {
     pairingConfigHash: string;
   }): VerdictGenerationRef | undefined;
   listVerdictPairs(generationId: string): VerdictPairQueueItem[];
-  /** The given pairs already closed with a recorded verdict in any generation. */
+  /** The given pairs already settled or exhausted in any generation. */
   readClosedVerdictPairIds(pairIds: readonly string[]): Set<string>;
   claimNextPair(input: {
     generationId: string;

package/dist/client.d.ts

@@ -1,5 +1,5 @@
 import { Discovery } from "./internal/contract/discovery.js";
-import { B as ScopeCtx, F as JsonValue, H as UsageSignal, I as Message, L as Mutation, M as HostEvent, N as InitRegistration, P as Inspection, R as RecallOptions, V as Turn, et as ContractError, n as MemoryContract, nt as DegradedReason, v as ContractOutputs, z as Registration } from "./index-dQMkc_6y.js";
+import { B as ScopeCtx, F as JsonValue, H as UsageSignal, I as Message, L as Mutation, M as HostEvent, N as InitRegistration, P as Inspection, R as RecallOptions, V as Turn, et as ContractError, n as MemoryContract, nt as DegradedReason, v as ContractOutputs, z as Registration } from "./index-CsPUNkcm.js";
 //#region src/contract/client.d.ts
 export interface ConnectOptions {
   skinId: string;

package/dist/{coding-skin-_Qu3INZD.js → coding-skin-azRXA51Z.js}

@@ -158,6 +158,7 @@ const CODING_SKIN_CHILD_DEADLINE_MS = 11e4;
 const CODING_SKIN_WORKER_LIFETIME_MS = 54e4;
 const CODING_SKIN_RETRY_DELAYS_MS = [2e3, 1e4];
 const CODING_SKIN_MAX_ATTEMPTS = 3;
+const CODING_SKIN_MAX_PENDING_CAPTURES = 1e3;
 const CODING_SKIN_IMPORT_INTERVAL_MS = 2010;
 const CODING_SKIN_CHILD_MAX_BUFFER_BYTES = 8388608;
 const CODING_SKIN_MANUAL_SESSION_ID = "manual";
@@ -255,4 +256,4 @@ function isCodingSkinHookCommand(command, subcommand, harness) {
 	return basename(snoProgramPath(program)) === "sno";
 }
 //#endregion
-export { readNewLines as C, isAgentText as S, shellQuote as _, CODING_SKIN_IMPORT_INTERVAL_MS as a, activityCursorSchema as b, CODING_SKIN_MAX_ATTEMPTS as c, CODING_SKIN_RECALL_SENTENCE_MAX_CHARS as d, CODING_SKIN_RETRY_DELAYS_MS as f, isCodingSkinHookCommand as g, codingSkinHookCommand as h, CODING_SKIN_HOOKS as i, CODING_SKIN_MODEL_COMMANDS as l, CODING_SKIN_WORKER_LIFETIME_MS as m, CODING_SKIN_CHILD_MAX_BUFFER_BYTES as n, CODING_SKIN_LEDGER_MAX_CHARS as o, CODING_SKIN_SESSION_QUERY as p, CODING_SKIN_CURSOR_HOOKS as r, CODING_SKIN_MANUAL_SESSION_ID as s, CODING_SKIN_CHILD_DEADLINE_MS as t, CODING_SKIN_RECALL_ITEM_MAX_CHARS as u, snoProgramPath as v, foldActivity as x, EMPTY_ACTIVITY_CURSOR as y };
+export { isAgentText as C, foldActivity as S, isCodingSkinHookCommand as _, CODING_SKIN_IMPORT_INTERVAL_MS as a, EMPTY_ACTIVITY_CURSOR as b, CODING_SKIN_MAX_ATTEMPTS as c, CODING_SKIN_RECALL_ITEM_MAX_CHARS as d, CODING_SKIN_RECALL_SENTENCE_MAX_CHARS as f, codingSkinHookCommand as g, CODING_SKIN_WORKER_LIFETIME_MS as h, CODING_SKIN_HOOKS as i, CODING_SKIN_MAX_PENDING_CAPTURES as l, CODING_SKIN_SESSION_QUERY as m, CODING_SKIN_CHILD_MAX_BUFFER_BYTES as n, CODING_SKIN_LEDGER_MAX_CHARS as o, CODING_SKIN_RETRY_DELAYS_MS as p, CODING_SKIN_CURSOR_HOOKS as r, CODING_SKIN_MANUAL_SESSION_ID as s, CODING_SKIN_CHILD_DEADLINE_MS as t, CODING_SKIN_MODEL_COMMANDS as u, shellQuote as v, readNewLines as w, activityCursorSchema as x, snoProgramPath as y };

package/dist/coding-skin.d.ts

@@ -61,6 +61,7 @@ export declare const CODING_SKIN_CHILD_DEADLINE_MS = 11e4;
 export declare const CODING_SKIN_WORKER_LIFETIME_MS: number;
 export declare const CODING_SKIN_RETRY_DELAYS_MS: readonly [2_000, 10_000];
 export declare const CODING_SKIN_MAX_ATTEMPTS = 3;
+export declare const CODING_SKIN_MAX_PENDING_CAPTURES = 1e3;
 export declare const CODING_SKIN_IMPORT_INTERVAL_MS = 2010;
 export declare const CODING_SKIN_CHILD_MAX_BUFFER_BYTES: number;
 export declare const CODING_SKIN_MANUAL_SESSION_ID = "manual";

package/dist/coding-skin.js

@@ -1,5 +1,5 @@
 import { appendObserveLedgerRows } from "./internal/engine/telemetry/observe-ledger.js";
 import { SKILL_CATEGORIES, skillVersionFor } from "./internal/config/skill-categories.js";
 import { HOST_MODEL_CALLBACK_HOST, HOST_MODEL_CALLBACK_PATH, HOST_MODEL_DEADLINE_HEADER } from "./internal/config/skin-defaults.js";
-import { C as readNewLines, S as isAgentText, _ as shellQuote, a as CODING_SKIN_IMPORT_INTERVAL_MS, b as activityCursorSchema, c as CODING_SKIN_MAX_ATTEMPTS, d as CODING_SKIN_RECALL_SENTENCE_MAX_CHARS, f as CODING_SKIN_RETRY_DELAYS_MS, g as isCodingSkinHookCommand, h as codingSkinHookCommand, i as CODING_SKIN_HOOKS, l as CODING_SKIN_MODEL_COMMANDS, m as CODING_SKIN_WORKER_LIFETIME_MS, n as CODING_SKIN_CHILD_MAX_BUFFER_BYTES, o as CODING_SKIN_LEDGER_MAX_CHARS, p as CODING_SKIN_SESSION_QUERY, r as CODING_SKIN_CURSOR_HOOKS, s as CODING_SKIN_MANUAL_SESSION_ID, t as CODING_SKIN_CHILD_DEADLINE_MS, u as CODING_SKIN_RECALL_ITEM_MAX_CHARS, v as snoProgramPath, x as foldActivity, y as EMPTY_ACTIVITY_CURSOR } from "./coding-skin-_Qu3INZD.js";
-export { CODING_SKIN_CHILD_DEADLINE_MS, CODING_SKIN_CHILD_MAX_BUFFER_BYTES, CODING_SKIN_CURSOR_HOOKS, CODING_SKIN_HOOKS, CODING_SKIN_IMPORT_INTERVAL_MS, CODING_SKIN_LEDGER_MAX_CHARS, CODING_SKIN_MANUAL_SESSION_ID, CODING_SKIN_MAX_ATTEMPTS, CODING_SKIN_MODEL_COMMANDS, CODING_SKIN_RECALL_ITEM_MAX_CHARS, CODING_SKIN_RECALL_SENTENCE_MAX_CHARS, CODING_SKIN_RETRY_DELAYS_MS, CODING_SKIN_SESSION_QUERY, CODING_SKIN_WORKER_LIFETIME_MS, EMPTY_ACTIVITY_CURSOR, HOST_MODEL_CALLBACK_HOST, HOST_MODEL_CALLBACK_PATH, HOST_MODEL_DEADLINE_HEADER, SKILL_CATEGORIES, activityCursorSchema, appendObserveLedgerRows, codingSkinHookCommand, foldActivity, isAgentText, isCodingSkinHookCommand, readNewLines, shellQuote, skillVersionFor, snoProgramPath };
+import { C as isAgentText, S as foldActivity, _ as isCodingSkinHookCommand, a as CODING_SKIN_IMPORT_INTERVAL_MS, b as EMPTY_ACTIVITY_CURSOR, c as CODING_SKIN_MAX_ATTEMPTS, d as CODING_SKIN_RECALL_ITEM_MAX_CHARS, f as CODING_SKIN_RECALL_SENTENCE_MAX_CHARS, g as codingSkinHookCommand, h as CODING_SKIN_WORKER_LIFETIME_MS, i as CODING_SKIN_HOOKS, l as CODING_SKIN_MAX_PENDING_CAPTURES, m as CODING_SKIN_SESSION_QUERY, n as CODING_SKIN_CHILD_MAX_BUFFER_BYTES, o as CODING_SKIN_LEDGER_MAX_CHARS, p as CODING_SKIN_RETRY_DELAYS_MS, r as CODING_SKIN_CURSOR_HOOKS, s as CODING_SKIN_MANUAL_SESSION_ID, t as CODING_SKIN_CHILD_DEADLINE_MS, u as CODING_SKIN_MODEL_COMMANDS, v as shellQuote, w as readNewLines, x as activityCursorSchema, y as snoProgramPath } from "./coding-skin-azRXA51Z.js";
+export { CODING_SKIN_CHILD_DEADLINE_MS, CODING_SKIN_CHILD_MAX_BUFFER_BYTES, CODING_SKIN_CURSOR_HOOKS, CODING_SKIN_HOOKS, CODING_SKIN_IMPORT_INTERVAL_MS, CODING_SKIN_LEDGER_MAX_CHARS, CODING_SKIN_MANUAL_SESSION_ID, CODING_SKIN_MAX_ATTEMPTS, CODING_SKIN_MAX_PENDING_CAPTURES, CODING_SKIN_MODEL_COMMANDS, CODING_SKIN_RECALL_ITEM_MAX_CHARS, CODING_SKIN_RECALL_SENTENCE_MAX_CHARS, CODING_SKIN_RETRY_DELAYS_MS, CODING_SKIN_SESSION_QUERY, CODING_SKIN_WORKER_LIFETIME_MS, EMPTY_ACTIVITY_CURSOR, HOST_MODEL_CALLBACK_HOST, HOST_MODEL_CALLBACK_PATH, HOST_MODEL_DEADLINE_HEADER, SKILL_CATEGORIES, activityCursorSchema, appendObserveLedgerRows, codingSkinHookCommand, foldActivity, isAgentText, isCodingSkinHookCommand, readNewLines, shellQuote, skillVersionFor, snoProgramPath };

package/dist/{config-BCZRhUvW.js → config-C7LzSWhG.js}

@@ -1571,7 +1571,7 @@ const scopesConfigSchema = z.object({
 	definitions: z.record(z.string(), z.object({
 		description: z.string().optional(),
 		metadata: z.record(z.string(), z.unknown()).optional()
-	})).prefault({ global: { description: "Shared knowledge across all agents" } }),
+	})).prefault({ global: { description: "Knowledge used by all your agents" } }),
 	agentAccess: z.record(z.string(), z.array(z.string())).default({})
 }).prefault({});
 const providerConfigSchema = z.object({ userId: z.string().trim().optional() }).strict().prefault({});
@@ -1669,6 +1669,11 @@ const host = {
 	"agent-native": "host",
 	"rem-enhanced": "host"
 };
+const offByDefault = {
+	"local-first": "off",
+	"agent-native": "off",
+	"rem-enhanced": "off"
+};
 const profile = {
 	"local-first": "host",
 	"agent-native": "host",
@@ -1726,7 +1731,7 @@ const MODEL_CALLS = {
 	E3: {
 		description: "missed figure recovery",
 		occasion: "memoryExtract",
-		destinations: extract,
+		destinations: offByDefault,
 		snoPreset: chat,
 		transport: {
 			host: "agent-host-seam",
@@ -2412,7 +2417,7 @@ function defaultSettings() {
 		},
 		telemetry: {
 			memoryUsage: {
-				enabled: false,
+				enabled: true,
 				key: "",
 				historicKeys: []
 			},
@@ -2423,7 +2428,7 @@ function defaultSettings() {
 			redactionRules: []
 		},
 		logging: {
-			level: "info",
+			level: "debug",
 			file: "",
 			debugContent: false
 		},

package/dist/{connection-C9YD5sgm.js → connection-PQcq3TPO.js}

@@ -1,5 +1,5 @@
 import { StorageError } from "./internal/engine/shared/errors.js";
-import { a as schema_exports, i as migrateLegacyDatabaseNamespace, n as loadSqliteVecExtension, o as applyEntityNameKeyMigration, r as resolveSimpleTokenizerPath, t as migrateUnplacedCandidates } from "./unplaced-candidate-migration-CbQHzcEM.js";
+import { a as schema_exports, i as migrateLegacyDatabaseNamespace, n as loadSqliteVecExtension, o as applyEntityNameKeyMigration, r as resolveSimpleTokenizerPath, t as migrateUnplacedCandidates } from "./unplaced-candidate-migration-BCcdQkcx.js";
 import { SqliteFileMissingError, openSqliteDatabase } from "./internal/store/sqlite-runtime.js";
 import { createLogger } from "@snoai/utils/logger";
 import { dirname, join } from "node:path";

package/dist/{derived-suppression-cache-BLAH0nB9.d.ts → derived-suppression-cache-Ckwjey7I.d.ts}

@@ -1,4 +1,4 @@
-import "./types-Del9J7UB.js";
+import "./types-Ae3a8562.js";
 //#region src/engine/reflection/reflection-line-loader.d.ts
 interface ReflectionLineSource {
   line: string;

package/dist/diagnostic-encoder.js

@@ -1,4 +1,4 @@
-import { n as version, t as logSiteCatalog } from "./log-site-catalog.generated-By86ZBRB.js";
+import { n as version, t as logSiteCatalog } from "./log-site-catalog.generated-Dzgj9o5c.js";
 import { diagnosticProcessInstanceId, encodeDiagnostic as encodeDiagnostic$1, writeEmergencyDiagnostic as writeEmergencyDiagnostic$1 } from "@snoai/utils/log-encoder";
 //#region src/engine/observability/early-diagnostics.ts
 function bindApplication(input) {

package/dist/{index-dQMkc_6y.d.ts → index-CsPUNkcm.d.ts}

@@ -1,5 +1,5 @@
-import { p as LlmRoutingConfig, t as PluginConfig } from "./plugin-config-schema-VBSPGEG3.js";
-import { g as MemoryEntry, h as MemoryCategory, t as AGGREGATION_OPERATIONS, x as RetrievalResult } from "./types-Del9J7UB.js";
+import { p as LlmRoutingConfig, t as PluginConfig } from "./plugin-config-schema-BrhMvnXJ.js";
+import { g as MemoryEntry, h as MemoryCategory, t as AGGREGATION_OPERATIONS, x as RetrievalResult } from "./types-Ae3a8562.js";
 import { r as SnoStationMemMemorySearchResult } from "./provider-runtime-types-DFhtdA6d.js";
 import { z } from "zod";
 //#region src/contract/error.d.ts

package/dist/{index-BO4RU_mc.d.ts → index-DPfJrOFD.d.ts}

@@ -1,5 +1,5 @@
 import { c as RemConfig, d as RemEnableGateArtifact, g as RemOperationType, o as RemBuiltOperationType, u as RemDatabaseLike } from "./types-pVomjzqR.js";
-import { g as JournalEntry } from "./classifier-DnbbtwTS.js";
+import { g as JournalEntry } from "./classifier-CXQxJJPP.js";
 //#region src/engine/rem/adapter-a-conflict-adjudicator.d.ts
 type AdapterAVerdict = "replacement" | "keep" | "uncertain";
 interface AdapterAMemoryView {

package/dist/{index-DL8AVj0Z.d.ts → index-Pb9LrHgL.d.ts}

@@ -73,12 +73,11 @@ declare const MAX_RECALL_TOOL_CANDIDATES = 512;
  */
 declare const ARRIVAL_RETIREMENT_CANDIDATE_CAP = 128;
 /**
- * How many older live profile and state rows of the project, most similar first, a newly
- * written row is judged against at write time, one conflict-adjudication call per pair (PRD 140
- * REQ-2). A measured correction pair was its subject's most similar pair (0.688 against 0.495–0.618
- * for the others, 2026-09-23); a target outside this cap is left to the REM replace wave.
+ * Total arrival conflict-adjudication calls one capture may cause across all written rows and
+ * windows, including provider retries. Candidates are considered most similar first; targets
+ * outside this cap are left to the REM replace wave.
  */
-declare const ARRIVAL_RETIREMENT_JUDGED_CANDIDATE_CAP = 10;
+declare const ARRIVAL_RETIREMENT_JUDGED_CANDIDATE_CAP = 3;
 /**
  * Measurement-only overrides for the block 210 retrieval-breadth experiment.
  *

package/dist/index.d.ts

@@ -1,15 +1,15 @@
-import { b as Settings, t as PluginConfig } from "./plugin-config-schema-VBSPGEG3.js";
-import "./types-Del9J7UB.js";
+import { b as Settings, t as PluginConfig } from "./plugin-config-schema-BrhMvnXJ.js";
+import "./types-Ae3a8562.js";
 import { n as AgentLlmPort } from "./agent-llm-port-DY2290EK.js";
-import { n as PluginObservability } from "./adapter-TCrv5P-C.js";
-import { $ as usageSignalSchema, A as HostContext, B as ScopeCtx, C as inspectDataSchema, D as toolResponseSchema, E as retrievalResultSchema, F as JsonValue, G as inputSchemas, H as UsageSignal, I as Message, J as mutationSchema, K as inspectionSchema, L as Mutation, M as HostEvent, N as InitRegistration, O as AgentModelRegistration, P as Inspection, Q as turnSchema, R as RecallOptions, S as ToolResponse, T as outputSchemas, U as hostEventSchema, V as Turn, W as initRegistrationSchema, X as registrationSchema, Y as recallOptionsSchema, Z as scopeSchema, _ as engineSettingsSchema, a as parseOutput, b as ProjectSummary, c as MEMORY_ERROR_STATUS, d as MEMORY_ROUTES, et as ContractError, f as MEMORY_SKIN_HEADER, g as EngineSettings, h as memoryMethod, i as parseInput, j as HostDecision, k as ContractInputs, l as MEMORY_HEALTH_TIMEOUT_MS, m as REM_SIDECAR_TOKEN_HEADER, n as MemoryContract, nt as DegradedReason, o as MEMORY_BODY_LIMIT_BYTES, p as MEMORY_START_TIMEOUT_MS, q as messageSchema, r as contractJsonSchemas, s as MEMORY_DEFAULT_SKIN_ID, t as ContractMethod, tt as DEGRADED_REASONS, u as MEMORY_RECONNECT_INTERVAL_MS, v as ContractOutputs, w as memoryEntrySchema, x as Result, y as InspectData, z as Registration } from "./index-dQMkc_6y.js";
+import { n as PluginObservability } from "./adapter-lyb6RaQE.js";
+import { $ as usageSignalSchema, A as HostContext, B as ScopeCtx, C as inspectDataSchema, D as toolResponseSchema, E as retrievalResultSchema, F as JsonValue, G as inputSchemas, H as UsageSignal, I as Message, J as mutationSchema, K as inspectionSchema, L as Mutation, M as HostEvent, N as InitRegistration, O as AgentModelRegistration, P as Inspection, Q as turnSchema, R as RecallOptions, S as ToolResponse, T as outputSchemas, U as hostEventSchema, V as Turn, W as initRegistrationSchema, X as registrationSchema, Y as recallOptionsSchema, Z as scopeSchema, _ as engineSettingsSchema, a as parseOutput, b as ProjectSummary, c as MEMORY_ERROR_STATUS, d as MEMORY_ROUTES, et as ContractError, f as MEMORY_SKIN_HEADER, g as EngineSettings, h as memoryMethod, i as parseInput, j as HostDecision, k as ContractInputs, l as MEMORY_HEALTH_TIMEOUT_MS, m as REM_SIDECAR_TOKEN_HEADER, n as MemoryContract, nt as DegradedReason, o as MEMORY_BODY_LIMIT_BYTES, p as MEMORY_START_TIMEOUT_MS, q as messageSchema, r as contractJsonSchemas, s as MEMORY_DEFAULT_SKIN_ID, t as ContractMethod, tt as DEGRADED_REASONS, u as MEMORY_RECONNECT_INTERVAL_MS, v as ContractOutputs, w as memoryEntrySchema, x as Result, y as InspectData, z as Registration } from "./index-CsPUNkcm.js";
 import { t as Embedder } from "./embedding-provider-client-vynZMuit.js";
-import { t as MemoryRetriever } from "./retriever-DQdyGlkr.js";
-import { C as MemoryStore } from "./memory-store-base-z593oJ4h.js";
-import "./store-DKndKig1.js";
-import { n as AccessTracker } from "./access-tracker-D1e-2-Bb.js";
+import { t as MemoryRetriever } from "./retriever-DyxY59Lg.js";
+import { C as MemoryStore } from "./memory-store-base-Bk2dOKED.js";
+import "./store-BDIAl2cc.js";
+import { n as AccessTracker } from "./access-tracker-BOPHSJjf.js";
 import { r as MemoryTelemetryUsageOutbox } from "./memory-telemetry-outbox-ddTdImt7.js";
-import { t as ReflectionCommandParams } from "./reflection-command-hooks-Cl0ShtbF.js";
+import { t as ReflectionCommandParams } from "./reflection-command-hooks-CM2mWb69.js";
 import { createMemoryRuntime } from "./internal/engine/provider/provider-registration.js";
 //#region src/engine/contract-runtime.d.ts
 interface MemoryRuntimeServices {
@@ -30,6 +30,7 @@ export declare class MemoryContractRuntime implements MemoryContract {
   private registration;
   private readonly providers;
   private readonly reflectionStates;
+  private readonly arrivalRetirements;
   private recall;
   constructor(services: MemoryRuntimeServices);
   /** Takes over a replaced runtime's per-session recall turns, so a mid-turn re-registration keeps same-turn omission. */
@@ -54,6 +55,8 @@ export declare class MemoryContractRuntime implements MemoryContract {
   private recordRecalled;
   private clearRecallSession;
   private autoRecall;
+  private recordRecallPreview;
+  private recordReadUsage;
   mutate(op: Mutation, scope: ScopeCtx, signal?: AbortSignal): Promise<ContractOutputs["mutate"]>;
   private correct;
   inspect(op: Inspection, scope: ScopeCtx): Promise<ContractOutputs["inspect"]>;