@snoai/memory 1.0.1 → 1.2.0

package/README.md

@@ -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.0.1
+npm install @snoai/memory@1.2.0
 ```
 
 Needs Node.js 22.22.3+, 24.15.0+ or 25.9.0+. Licensed under Apache-2.0.

package/dist/{access-tracker-BbEvEocb.d.ts → access-tracker-BNqlgChq.d.ts}

@@ -1,7 +1,7 @@
-import { v as MemoryMetadata } from "./types-CWdhXLxr.js";
+import { v as MemoryMetadata } from "./types-DvQ6nTNC.js";
 import { sn as RecallLifecycleConfig } from "./index-DL8AVj0Z.js";
-import { C as MemoryStore } from "./memory-store-base-CQ_bHlYA.js";
-import "./store-C8sUTssE.js";
+import { C as MemoryStore } from "./memory-store-base-Dx6oSqiv.js";
+import "./store-Dbo7MIzt.js";
 //#region src/engine/retrieval/access-tracker.d.ts
 interface AccessMetadata {
   readonly accessCount: number;

package/dist/{adapter-B7Jox9-6.d.ts → adapter-CeQ7rViY.d.ts}

@@ -1,5 +1,5 @@
-import { t as PluginConfig } from "./plugin-config-schema-C0UUbOmG.js";
-import "./types-CWdhXLxr.js";
+import { t as PluginConfig } from "./plugin-config-schema-CCwv_K7R.js";
+import "./types-DvQ6nTNC.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-d9EG-4ti.d.ts → atomic-memory-extraction-BT8lFE5t.d.ts}

@@ -1,9 +1,9 @@
-import { i as LlmClientConfig, l as ModelCallId, p as LlmRoutingConfig, r as LlmClient } from "./plugin-config-schema-C0UUbOmG.js";
+import { i as LlmClientConfig, l as ModelCallId, p as LlmRoutingConfig, r as LlmClient } from "./plugin-config-schema-CCwv_K7R.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-CQ_bHlYA.js";
-import "./store-C8sUTssE.js";
-import "./llm-client-DOTSGzhe.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-Dx6oSqiv.js";
+import "./store-Dbo7MIzt.js";
+import "./llm-client-PC0yQuCq.js";
 import { z } from "zod";
 //#region src/engine/extraction/calendar-instruction.d.ts
 type CalendarPrecision = "year" | "month" | "week" | "day" | "minute";

package/dist/{atomic-memory-extraction-C5rmogoY.js → atomic-memory-extraction-By0axKHc.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-BSYUAcUb.js";
+import { a as isTerminalLlmFailure, i as createLlmClient, n as LlmClientTerminalError } from "./llm-client-BhkzlTnH.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-BUjXG5o7.js";
+import "./memory-temporality-classifier-AetVby94.js";
 import { t as appendAuditEntry } from "./runtime-audit-log-BCeujlEp.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 { d as normalizeEntityName, f as recordAtomicEntityIdentityJournal, g as readAtomicArrivalRetirementCandidateSet, h as journalAtomicArrivalRetirementRefusal, m as closeAtomicArrivalRetirementTargets, u as listAtomicMemoryEntityCandidates, y as normalizeMemoryRelationPredicate } from "./store-nPql26YM.js";
+import { d as normalizeEntityName, f as recordAtomicEntityIdentityJournal, g as readAtomicArrivalRetirementCandidateSet, h as journalAtomicArrivalRetirementRefusal, m as closeAtomicArrivalRetirementTargets, u as listAtomicMemoryEntityCandidates, y as normalizeMemoryRelationPredicate } from "./store-D3n1P7Xn.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-BhGKPBjw.js";
+import { i as prepareDeterministicTaskLifecycleWrite, t as PROFILE_IDENTITY_SECTION } from "./profile-section-writer-BV605K78.js";
 import { z } from "zod";
 import { countTokens } from "@snoai/chunking";
 import { createLogger, currentLogContext, privateLogReference, withLogContext } from "@snoai/utils/logger";

package/dist/{b-profile-section-dictionary-provider-BxbksLj3.d.ts → b-profile-section-dictionary-provider-DGtF4dB7.d.ts}

@@ -1,4 +1,4 @@
-import { g as ProductMode } from "./plugin-config-schema-C0UUbOmG.js";
+import { g as ProductMode } from "./plugin-config-schema-CCwv_K7R.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-CxbHPkMX.d.ts → capture-policy-detector-CN3vfdNU.d.ts}

@@ -1,4 +1,4 @@
-import { h as MemoryCategory } from "./types-CWdhXLxr.js";
+import { h as MemoryCategory } from "./types-DvQ6nTNC.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/client.d.ts

@@ -1,5 +1,5 @@
 import { Discovery } from "./internal/contract/discovery.js";
-import { $ as ContractError, B as Turn, F as Message, I as Mutation, L as RecallOptions, M as InitRegistration, N as Inspection, P as JsonValue, R as Registration, V as UsageSignal, j as HostEvent, n as MemoryContract, tt as DegradedReason, v as ContractOutputs, z as ScopeCtx } from "./index-0aqS8pVF.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-DtqgCT8u.js";
 //#region src/contract/client.d.ts
 export interface ConnectOptions {
   skinId: string;
@@ -9,7 +9,17 @@ export interface DegradedConnection {
   reason: DegradedReason;
   error?: string;
 }
+export type ReportingInspection = Extract<Inspection, {
+  op: "projects" | "currentProject";
+}> | {
+  op: "stats";
+};
+export type ReportingClient = Pick<MemoryClient, "degraded" | "principal"> & {
+  inspect(op: ReportingInspection, scope: ScopeCtx): Promise<ContractOutputs["inspect"]>;
+};
 export declare function connect(options: ConnectOptions): Promise<MemoryClient | DegradedConnection>;
+/** Connect to an already running service without starting it or registering a skin. */
+export declare function connectReporting(options: ConnectOptions): Promise<ReportingClient | DegradedConnection>;
 export declare class MemoryClient implements MemoryContract {
   #private;
   readonly skinId: string;

package/dist/client.js

@@ -1,5 +1,5 @@
 import { n as DEGRADED_REASONS, t as ContractError } from "./error-D-wb-rZw.js";
-import { r as outputSchemas } from "./results-C3ZLroMb.js";
+import { r as outputSchemas } from "./results-BkMsHy7M.js";
 import { MEMORY_ROUTES, MEMORY_SKIN_HEADER, MEMORY_START_TIMEOUT_MS, REM_SIDECAR_TOKEN_HEADER } from "./internal/contract/routes.js";
 import { getPrincipal, getSettingsPath, getSnoStationMemStateDir, getStartupLogPath } from "./internal/contract/profile.js";
 import { checkDiscovery, processAlive, readDiscovery } from "./internal/contract/discovery.js";
@@ -149,6 +149,22 @@ async function connect(options) {
 		};
 	}
 }
+/** Connect to an already running service without starting it or registering a skin. */
+async function connectReporting(options) {
+	try {
+		const { storePath } = clientSettings();
+		const discovery = await readDiscovery();
+		if (!discovery) throw new ContractError("sidecar-unreachable");
+		await checkDiscovery(discovery);
+		return new MemoryClient(options.skinId, storePath, discovery);
+	} catch (error) {
+		return {
+			degraded: true,
+			reason: failureReason(error),
+			...error instanceof Error && { error: error.message }
+		};
+	}
+}
 var MemoryClient = class {
 	skinId;
 	storePath;
@@ -168,12 +184,15 @@ var MemoryClient = class {
 		const route = MEMORY_ROUTES[method];
 		try {
 			signal?.throwIfAborted();
+			const inspection = method === "inspect" && "op" in input ? input.op : void 0;
+			const reporting = inspection?.op === "projects" || inspection?.op === "currentProject" || inspection?.op === "stats" && !inspection.scope;
 			let discovery = await readDiscovery();
 			if (!discovery || !processAlive(discovery.pid)) {
+				if (reporting) throw new ContractError("sidecar-unreachable");
 				const { memoryPackage } = clientSettings();
 				discovery = await startSidecar(memoryPackage);
 			}
-			if (method !== "init" && this.#registration && this.#registeredPid !== discovery.pid) await this.request("init", this.#registration, signal);
+			if (method !== "init" && !reporting && this.#registration && this.#registeredPid !== discovery.pid) await this.request("init", this.#registration, signal);
 			const response = await postJson(discovery.port, route.path, {
 				"Content-Type": "application/json",
 				[MEMORY_SKIN_HEADER]: this.skinId,
@@ -264,6 +283,16 @@ var MemoryClient = class {
 				op: "get",
 				entry: null
 			};
+			else if (op.op === "projects") result = {
+				op: "projects",
+				projects: []
+			};
+			else if (op.op === "currentProject") result = {
+				op: "currentProject",
+				workspace: op.workspace,
+				status: "unknown",
+				project: null
+			};
 			else result = {
 				op: op.op,
 				project: scope.project,
@@ -303,4 +332,4 @@ var MemoryClient = class {
 	}
 };
 //#endregion
-export { ContractError, MemoryClient, connect };
+export { ContractError, MemoryClient, connect, connectReporting };

package/dist/coding-skin-C7gwOKsc.js

@@ -0,0 +1,223 @@
+import "./internal/engine/telemetry/observe-ledger.js";
+import "./internal/config/skill-categories.js";
+import "./internal/config/skin-defaults.js";
+import { z } from "zod";
+import { basename } from "node:path";
+import { createReadStream } from "node:fs";
+//#region config/session-activity.ts
+/** A gap between two records of at most this long is working time; a longer one ends the run. */
+const ACTIVITY_GAP_MS = 9e5;
+/** A run counts in runs_over_12h once, in the send where it reaches this length, ended or not. */
+const ACTIVITY_LONG_RUN_MS = 432e5;
+/**
+* Text markers of messages the person did not write, seen in real transcripts on the owner's
+* machine (Claude Code 2.1.247 and Codex 0.160, 2026-08 to 2026-10). Heuristics, matched on text.
+*/
+/** Reach's ring and mailbox doorbell, typed into the agent's terminal (apps/reach/lib/reach-ring line 426); recorded as a human prompt by Claude Code and Codex. */
+const REACH_RING_MARKER = "typed by the mail transport, not by the owner";
+/** A heartbeat tick line, "<UTC time> [label] tick=N ..." (apps/heartbeat/bin/heartbeat line 507); Claude Code delivers it inside a Monitor <task-notification>. */
+const HEARTBEAT_TICK = /\d{4}-\d\d-\d\dT\d\d:\d\d:\d\dZ \[[^\]\n]+\] tick=\d+/;
+/** The first prompt Reach gives a seat it starts in a terminal (apps/reach/lib/reach-spawn line 19). */
+const REACH_SEAT_START_MARKER = "No work is assigned by this startup message";
+/** True when the text of a user message came from another agent's tooling: a Reach ring or seat start, or a heartbeat wake. */
+function isAgentText(text) {
+	return text.includes(REACH_RING_MARKER) || text.includes(REACH_SEAT_START_MARKER) || HEARTBEAT_TICK.test(text);
+}
+const activityCursorSchema = z.object({
+	offset: z.number().int().nonnegative(),
+	lastTs: z.number().int().nonnegative(),
+	runStart: z.number().int().nonnegative(),
+	agentDriven: z.boolean(),
+	counted: z.boolean(),
+	path: z.string().min(1).optional()
+});
+const EMPTY_ACTIVITY_CURSOR = {
+	offset: 0,
+	lastTs: 0,
+	runStart: 0,
+	agentDriven: false,
+	counted: false
+};
+/**
+* Folds the records after the cursor into one window. A gap belongs to the window of the record
+* that ends it, so splitting a transcript at any line gives the same sums. A run is counted in
+* runs_over_12h once, in the send where it reaches 12 hours, whether or not it has ended. longest_run_ms
+* is the longest run of any length seen in the window, including the length so far of the run still
+* open. `closeRun` ends the run still open at the last record (the session is over); otherwise it
+* stays open in the cursor.
+*/
+function foldActivity(cursor, records, closeRun) {
+	let { lastTs, runStart, agentDriven, counted } = cursor;
+	let windowStart = runStart > 0 ? lastTs : 0;
+	let active = 0, team = 0, human = 0, runs = 0, longest = 0;
+	const seeRun = (end) => {
+		const length = end - runStart;
+		longest = Math.max(longest, length);
+		if (!counted && length >= ACTIVITY_LONG_RUN_MS) {
+			runs++;
+			counted = true;
+		}
+	};
+	for (const record of records) {
+		if (windowStart === 0) windowStart = record.ts;
+		if (runStart === 0) runStart = record.ts;
+		else if (record.ts > lastTs) {
+			const gap = record.ts - lastTs;
+			if (gap <= ACTIVITY_GAP_MS) {
+				active += gap;
+				if (agentDriven) team += gap;
+			} else {
+				seeRun(lastTs);
+				runStart = record.ts;
+				counted = false;
+			}
+		}
+		lastTs = Math.max(lastTs, record.ts);
+		if (runStart > 0) seeRun(lastTs);
+		if (record.incoming === "human") {
+			human++;
+			agentDriven = false;
+		} else if (record.incoming === "agent") agentDriven = true;
+	}
+	const closing = closeRun && runStart > 0;
+	if (closing) {
+		runStart = 0;
+		counted = false;
+	}
+	const next = {
+		...cursor,
+		lastTs,
+		runStart,
+		agentDriven,
+		counted
+	};
+	if (records.length === 0 && !closing) return {
+		payload: void 0,
+		cursor: next
+	};
+	return {
+		payload: {
+			window_start_ms: windowStart > 0 ? windowStart : lastTs,
+			window_end_ms: lastTs,
+			active_ms: active,
+			team_driven_ms: team,
+			runs_over_12h: runs,
+			longest_run_ms: longest,
+			human_messages: human
+		},
+		cursor: next
+	};
+}
+/**
+* Calls `onLine` for each complete line from `offset` on and returns the offset after the last
+* complete line, and whether the end of the file was reached on a line boundary. Stops reading once `budgetMs` has passed: real transcripts reach 1.65 GB while a
+* hook has seconds, so a long backlog is taken over several sends instead of failing every time.
+*/
+async function readNewLines(path, offset, budgetMs, onLine) {
+	const deadline = Date.now() + budgetMs;
+	const stream = createReadStream(path, { start: offset });
+	let pending = Buffer.alloc(0);
+	let consumed = offset;
+	let done = true;
+	try {
+		for await (const chunk of stream) {
+			pending = pending.length === 0 ? chunk : Buffer.concat([pending, chunk]);
+			let from = 0;
+			for (let end = pending.indexOf(10, from); end !== -1; end = pending.indexOf(10, from)) {
+				if (end > from) onLine(pending.toString("utf8", from, end));
+				from = end + 1;
+			}
+			consumed += from;
+			pending = pending.subarray(from);
+			if (Date.now() > deadline) {
+				done = false;
+				break;
+			}
+		}
+	} finally {
+		stream.destroy();
+	}
+	if (done && pending.length > 0) {
+		const tail = pending.toString("utf8");
+		try {
+			JSON.parse(tail);
+			onLine(tail);
+			consumed += pending.length;
+		} catch {
+			done = false;
+		}
+	}
+	return {
+		offset: consumed,
+		done
+	};
+}
+//#endregion
+//#region config/coding-skin.ts
+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_IMPORT_INTERVAL_MS = 2010;
+const CODING_SKIN_CHILD_MAX_BUFFER_BYTES = 8388608;
+const CODING_SKIN_MANUAL_SESSION_ID = "manual";
+const CODING_SKIN_SESSION_QUERY = "standing decisions, open tasks, conventions and known pitfalls for this repository";
+const CODING_SKIN_LEDGER_MAX_CHARS = 12e3;
+const CODING_SKIN_RECALL_SENTENCE_MAX_CHARS = 200;
+const CODING_SKIN_RECALL_ITEM_MAX_CHARS = 240;
+const CODING_SKIN_HOOKS = {
+	SessionStart: {
+		eventName: "session_start",
+		subcommand: "session-start",
+		timeout: 15
+	},
+	UserPromptSubmit: {
+		eventName: "user_prompt_submit",
+		subcommand: "user-prompt-submit",
+		timeout: 8
+	},
+	Stop: {
+		eventName: "stop",
+		subcommand: "stop",
+		timeout: 5
+	},
+	SessionEnd: {
+		eventName: "session_end",
+		subcommand: "session-end",
+		timeout: 8
+	},
+	PreToolUse: {
+		eventName: "pre_tool_use",
+		subcommand: "pre-tool-use",
+		timeout: 5
+	},
+	PostToolUse: {
+		eventName: "post_tool_use",
+		subcommand: "post-tool-use",
+		timeout: 8
+	}
+};
+const CODING_SKIN_MODEL_COMMANDS = [
+	"recall",
+	"get",
+	"remember",
+	"correct"
+];
+function shellQuote(value) {
+	return `'${value.replaceAll("'", "'\\''")}'`;
+}
+/** The command an agent hook runs: the `sno` binary that ran setup, then `memory hook <event> --harness <name>`. */
+function codingSkinHookCommand(snoPath, subcommand, harness) {
+	return `${shellQuote(snoPath)} memory hook ${subcommand} --harness ${harness}`;
+}
+/** True for a hook command of that shape, whatever the path to `sno` is. */
+function isCodingSkinHookCommand(command, subcommand, harness) {
+	const suffix = ` memory hook ${subcommand} --harness ${harness}`;
+	const trimmed = command.trim();
+	if (!trimmed.endsWith(suffix)) return false;
+	const encoded = trimmed.slice(0, -suffix.length);
+	const program = encoded.startsWith("'") && encoded.endsWith("'") ? encoded.slice(1, -1).replaceAll("'\\''", "'") : encoded;
+	return basename(program) === "sno";
+}
+//#endregion
+export { EMPTY_ACTIVITY_CURSOR as _, CODING_SKIN_LEDGER_MAX_CHARS as a, isAgentText as b, CODING_SKIN_MODEL_COMMANDS as c, CODING_SKIN_RETRY_DELAYS_MS as d, CODING_SKIN_SESSION_QUERY as f, shellQuote as g, isCodingSkinHookCommand as h, CODING_SKIN_IMPORT_INTERVAL_MS as i, CODING_SKIN_RECALL_ITEM_MAX_CHARS as l, codingSkinHookCommand as m, CODING_SKIN_CHILD_MAX_BUFFER_BYTES as n, CODING_SKIN_MANUAL_SESSION_ID as o, CODING_SKIN_WORKER_LIFETIME_MS as p, CODING_SKIN_HOOKS as r, CODING_SKIN_MAX_ATTEMPTS as s, CODING_SKIN_CHILD_DEADLINE_MS as t, CODING_SKIN_RECALL_SENTENCE_MAX_CHARS as u, activityCursorSchema as v, readNewLines as x, foldActivity as y };

package/dist/coding-skin.d.ts

@@ -1,6 +1,61 @@
 import { ObserveLedgerRow, 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 } from "./internal/config/skin-defaults.js";
+import { z } from "zod";
+//#region config/session-activity.d.ts
+/** True when the text of a user message came from another agent's tooling: a Reach ring or seat start, or a heartbeat wake. */
+export declare function isAgentText(text: string): boolean;
+/** One transcript record: its time, and who sent the incoming message it carries, if it carries one. */
+interface ActivityRecord {
+  ts: number;
+  incoming?: "human" | "agent";
+}
+/** Where the previous send stopped: a byte offset into the transcript and the run still open there. */
+interface ActivityCursor {
+  offset: number;
+  lastTs: number;
+  /** Start of the continuous run still open at lastTs; 0 when no run is open. */
+  runStart: number;
+  /** The latest incoming message came from another agent. */
+  agentDriven: boolean;
+  /** The run still open was already counted in runs_over_12h. */
+  counted: boolean;
+  /** Codex only: the rollout file found by its first send. */
+  path?: string;
+}
+export declare const activityCursorSchema: z.ZodType<ActivityCursor>;
+interface SessionActivityPayload {
+  window_start_ms: number;
+  window_end_ms: number;
+  active_ms: number;
+  team_driven_ms: number;
+  runs_over_12h: number;
+  longest_run_ms: number;
+  human_messages: number;
+}
+export declare const EMPTY_ACTIVITY_CURSOR: ActivityCursor;
+/**
+ * Folds the records after the cursor into one window. A gap belongs to the window of the record
+ * that ends it, so splitting a transcript at any line gives the same sums. A run is counted in
+ * runs_over_12h once, in the send where it reaches 12 hours, whether or not it has ended. longest_run_ms
+ * is the longest run of any length seen in the window, including the length so far of the run still
+ * open. `closeRun` ends the run still open at the last record (the session is over); otherwise it
+ * stays open in the cursor.
+ */
+export declare function foldActivity(cursor: ActivityCursor, records: readonly ActivityRecord[], closeRun: boolean): {
+  payload: SessionActivityPayload | undefined;
+  cursor: ActivityCursor;
+};
+/**
+ * Calls `onLine` for each complete line from `offset` on and returns the offset after the last
+ * complete line, and whether the end of the file was reached on a line boundary. Stops reading once `budgetMs` has passed: real transcripts reach 1.65 GB while a
+ * hook has seconds, so a long backlog is taken over several sends instead of failing every time.
+ */
+export declare function readNewLines(path: string, offset: number, budgetMs: number, onLine: (line: string) => void): Promise<{
+  offset: number;
+  done: boolean;
+}>;
+//#endregion
 //#region config/coding-skin.d.ts
 export declare const CODING_SKIN_CHILD_DEADLINE_MS = 11e4;
 export declare const CODING_SKIN_WORKER_LIFETIME_MS: number;
@@ -47,5 +102,11 @@ export declare const CODING_SKIN_HOOKS: {
 };
 export type CodingSkinHookName = keyof typeof CODING_SKIN_HOOKS;
 export declare const CODING_SKIN_MODEL_COMMANDS: readonly ["recall", "get", "remember", "correct"];
+export type CodingSkinHarness = "claude" | "codex";
+export declare function shellQuote(value: string): string;
+/** The command an agent hook runs: the `sno` binary that ran setup, then `memory hook <event> --harness <name>`. */
+export declare function codingSkinHookCommand(snoPath: string, subcommand: string, harness: CodingSkinHarness): string;
+/** True for a hook command of that shape, whatever the path to `sno` is. */
+export declare function isCodingSkinHookCommand(command: string, subcommand: string, harness: CodingSkinHarness): boolean;
 //#endregion
-export { HOST_MODEL_CALLBACK_HOST, HOST_MODEL_CALLBACK_PATH, type ObserveLedgerRow, SKILL_CATEGORIES, appendObserveLedgerRows, skillVersionFor };
+export { type ActivityCursor, type ActivityRecord, HOST_MODEL_CALLBACK_HOST, HOST_MODEL_CALLBACK_PATH, type ObserveLedgerRow, SKILL_CATEGORIES, type SessionActivityPayload, appendObserveLedgerRows, skillVersionFor };

package/dist/coding-skin.js

@@ -1,55 +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 } from "./internal/config/skin-defaults.js";
-//#region config/coding-skin.ts
-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_IMPORT_INTERVAL_MS = 2010;
-const CODING_SKIN_CHILD_MAX_BUFFER_BYTES = 8388608;
-const CODING_SKIN_MANUAL_SESSION_ID = "manual";
-const CODING_SKIN_SESSION_QUERY = "standing decisions, open tasks, conventions and known pitfalls for this repository";
-const CODING_SKIN_LEDGER_MAX_CHARS = 12e3;
-const CODING_SKIN_RECALL_SENTENCE_MAX_CHARS = 200;
-const CODING_SKIN_RECALL_ITEM_MAX_CHARS = 240;
-const CODING_SKIN_HOOKS = {
-	SessionStart: {
-		eventName: "session_start",
-		subcommand: "session-start",
-		timeout: 15
-	},
-	UserPromptSubmit: {
-		eventName: "user_prompt_submit",
-		subcommand: "user-prompt-submit",
-		timeout: 8
-	},
-	Stop: {
-		eventName: "stop",
-		subcommand: "stop",
-		timeout: 5
-	},
-	SessionEnd: {
-		eventName: "session_end",
-		subcommand: "session-end",
-		timeout: 8
-	},
-	PreToolUse: {
-		eventName: "pre_tool_use",
-		subcommand: "pre-tool-use",
-		timeout: 5
-	},
-	PostToolUse: {
-		eventName: "post_tool_use",
-		subcommand: "post-tool-use",
-		timeout: 8
-	}
-};
-const CODING_SKIN_MODEL_COMMANDS = [
-	"recall",
-	"get",
-	"remember",
-	"correct"
-];
-//#endregion
-export { CODING_SKIN_CHILD_DEADLINE_MS, CODING_SKIN_CHILD_MAX_BUFFER_BYTES, 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, HOST_MODEL_CALLBACK_HOST, HOST_MODEL_CALLBACK_PATH, SKILL_CATEGORIES, appendObserveLedgerRows, skillVersionFor };
+import { _ as EMPTY_ACTIVITY_CURSOR, a as CODING_SKIN_LEDGER_MAX_CHARS, b as isAgentText, c as CODING_SKIN_MODEL_COMMANDS, d as CODING_SKIN_RETRY_DELAYS_MS, f as CODING_SKIN_SESSION_QUERY, g as shellQuote, h as isCodingSkinHookCommand, i as CODING_SKIN_IMPORT_INTERVAL_MS, l as CODING_SKIN_RECALL_ITEM_MAX_CHARS, m as codingSkinHookCommand, n as CODING_SKIN_CHILD_MAX_BUFFER_BYTES, o as CODING_SKIN_MANUAL_SESSION_ID, p as CODING_SKIN_WORKER_LIFETIME_MS, r as CODING_SKIN_HOOKS, s as CODING_SKIN_MAX_ATTEMPTS, t as CODING_SKIN_CHILD_DEADLINE_MS, u as CODING_SKIN_RECALL_SENTENCE_MAX_CHARS, v as activityCursorSchema, x as readNewLines, y as foldActivity } from "./coding-skin-C7gwOKsc.js";
+export { CODING_SKIN_CHILD_DEADLINE_MS, CODING_SKIN_CHILD_MAX_BUFFER_BYTES, 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, SKILL_CATEGORIES, activityCursorSchema, appendObserveLedgerRows, codingSkinHookCommand, foldActivity, isAgentText, isCodingSkinHookCommand, readNewLines, shellQuote, skillVersionFor };

package/dist/{config-CL90qYva.js → config-CyH1VuJc.js}

@@ -1149,14 +1149,15 @@ const PRODUCT_MODES = [
 ];
 const DEFAULT_MODEL_MODE = "agent-native";
 const remEnhancedConfigSchema = z.object({ trigger: z.object({ tick: z.boolean().default(true) }).strict().prefault({}) }).strict().prefault({});
+const modelCallsConfigSchema = z.record(z.string(), z.record(z.enum(PRODUCT_MODES), z.enum([
+	"off",
+	"host",
+	"sno-gpu"
+]))).optional();
 const llmRoutingConfigSchema = z.object({
 	mode: z.enum(PRODUCT_MODES),
 	language: z.enum(SUPPORTED_LOCALES).default("en"),
-	modelCalls: z.record(z.string(), z.record(z.enum(PRODUCT_MODES), z.enum([
-		"off",
-		"host",
-		"sno-gpu"
-	]))).optional()
+	modelCalls: modelCallsConfigSchema
 }).strict();
 //#endregion
 //#region config/plugin-config-embedding-schema.ts
@@ -1581,11 +1582,7 @@ const pluginConfigSchema = z.object({
 	* config requires an explicit product mode.
 	*/
 	mode: z.enum(PRODUCT_MODES).default(DEFAULT_MODEL_MODE),
-	modelCalls: z.record(z.string(), z.record(z.enum(PRODUCT_MODES), z.enum([
-		"off",
-		"host",
-		"sno-gpu"
-	]))).optional(),
+	modelCalls: modelCallsConfigSchema,
 	remOperations: z.array(z.enum(REM_OPERATIONS)).min(1).max(2).default([...REM_OPERATIONS]),
 	remEnhanced: remEnhancedConfigSchema,
 	/**
@@ -2013,6 +2010,15 @@ const MODEL_CALLS = {
 			"rem-enhanced": "sno-gpu"
 		}
 	},
+	R5: {
+		description: "generate local lessons and skill reminders nightly",
+		calledBy: "RSI skill",
+		destinations: {
+			"local-first": "host",
+			"agent-native": "off",
+			"rem-enhanced": "off"
+		}
+	},
 	REM1: {
 		description: "replace conflict pair",
 		occasion: "conflictAdjudication",
@@ -2173,7 +2179,7 @@ const destinations = z.strictObject({
 	"agent-native": destination,
 	"rem-enhanced": destination
 });
-const modelCalls = z.strictObject(Object.fromEntries(Object.keys(MODEL_CALLS).map((id) => [id, destinations])));
+const modelCalls = z.strictObject(Object.fromEntries(Object.keys(MODEL_CALLS).map((id) => [id, destinations]))).extend({ R5: destinations.default(MODEL_CALLS.R5.destinations) });
 const settingsSchema = z.strictObject({
 	mode: z.enum(PRODUCT_MODES),
 	modelCalls,

package/dist/{derived-suppression-cache-CI0durYx.d.ts → derived-suppression-cache-BZdBZSdK.d.ts}

@@ -1,4 +1,4 @@
-import "./types-CWdhXLxr.js";
+import "./types-DvQ6nTNC.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-BMKWj-Nx.js";
+import { n as version, t as logSiteCatalog } from "./log-site-catalog.generated-Cc8xXGaC.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) {