@remnic/core 1.1.10 → 1.1.12

package/dist/storage.d.ts

@@ -2,7 +2,7 @@ import { VersioningConfig } from './page-versioning.js';
 import { ConsolidationOperator } from './consolidation-operator.js';
 import { PluginConfig, MemoryCategory, ImportanceScore, MemoryLink, MemoryFrontmatter, MemoryStatus, MemoryFile, EntityStructuredSection, BufferState, MetaState, MemoryActionEvent, MemoryLifecycleEvent, BufferSurpriseEvent, BehaviorSignalEvent, CompressionGuidelineOptimizerState, ContinuityIncidentOpenInput, ContinuityIncidentRecord, ContinuityIncidentCloseInput, ContinuityImprovementLoop, ContinuityLoopUpsertInput, ContinuityLoopReviewInput, FileHygieneConfig, EntityRelationship, EntityActivityEntry, EntityFile, AccessTrackingEntry, MemoryProjectionCurrentState, MemorySummary, TopicScore } from './types.js';
 import { P as ProjectedMemoryBrowseOptions, a as ProjectedMemoryBrowsePage, b as readProjectedGovernanceRecord } from './memory-projection-store-CY8TU40w.js';
-import './index-1qIcnbG1.js';
+import './index-DJ9QWMw-.js';
 import 'better-sqlite3';
 
 interface ReextractJobRequest {
@@ -289,6 +289,7 @@ declare class StorageManager {
         sourceTurnId?: string;
         memoryKind?: MemoryFrontmatter["memoryKind"];
         expiresAt?: string;
+        validAt?: string;
         structuredAttributes?: Record<string, string>;
         /**
          * When provided, this string is used as the source for the fact-content
@@ -722,6 +723,7 @@ declare class StorageManager {
         intentActionType?: string;
         intentEntityTypes?: string[];
         memoryKind?: MemoryFrontmatter["memoryKind"];
+        validAt?: string;
     }): Promise<string>;
     /**
      * Get all chunks for a given parent memory ID.

package/dist/storage.js

@@ -8,14 +8,14 @@ import {
   normalizeEntityName,
   parseEntityFile,
   serializeEntityFile
-} from "./chunk-MCC6KDQF.js";
+} from "./chunk-3B6KIRBH.js";
 import "./chunk-YNJHCGDT.js";
 import "./chunk-NN2DKE4T.js";
-import "./chunk-VQXK37XA.js";
-import "./chunk-PFV5C235.js";
-import "./chunk-RULE4VG5.js";
+import "./chunk-23ZZK64Y.js";
 import "./chunk-SCU65EZI.js";
 import "./chunk-XJKFSSDW.js";
+import "./chunk-PFV5C235.js";
+import "./chunk-RULE4VG5.js";
 import "./chunk-DM2T26WE.js";
 import "./chunk-QSVPYQPG.js";
 import "./chunk-FVQJYWH7.js";

package/dist/summarizer.d.ts

@@ -1,7 +1,7 @@
 import { ModelRegistry } from './model-registry.js';
 import { PluginConfig, GatewayConfig, TranscriptEntry, HourlySummary } from './types.js';
 import { TranscriptManager } from './transcript.js';
-import './index-1qIcnbG1.js';
+import './index-DJ9QWMw-.js';
 import './session-integrity.js';
 
 declare class HourlySummarizer {

package/dist/summarizer.js

@@ -1,15 +1,15 @@
 import {
   HourlySummarizer
-} from "./chunk-PHNGXFQ6.js";
+} from "./chunk-7V22HTMD.js";
 import "./chunk-ETOW6ACV.js";
 import "./chunk-QR3C7BKQ.js";
-import "./chunk-NN3LPQ5D.js";
-import "./chunk-VX2IUQFE.js";
-import "./chunk-S3IP6R6K.js";
-import "./chunk-L2EXJQJP.js";
+import "./chunk-HELQZFZO.js";
+import "./chunk-AQJNPMOA.js";
+import "./chunk-PH4C2U43.js";
 import "./chunk-7SI52C65.js";
+import "./chunk-L2EXJQJP.js";
 import "./chunk-UZB5KHKX.js";
-import "./chunk-KWBPHZUU.js";
+import "./chunk-RK6F44Y6.js";
 import "./chunk-OR64ZGRZ.js";
 import "./chunk-IXEJRKCZ.js";
 import "./chunk-MARWOCVP.js";

package/dist/summary-snapshot.d.ts

@@ -1,5 +1,5 @@
 import { HourlySummary } from './types.js';
-import './index-1qIcnbG1.js';
+import './index-DJ9QWMw-.js';
 
 declare function summarySnapshotPath(memoryDir: string, sessionKey: string): string;
 declare function readSummarySnapshot(memoryDir: string, sessionKey: string): Promise<HourlySummary[] | null>;

package/dist/targeted-fact-recall.d.ts

@@ -0,0 +1,17 @@
+import { ExplicitCueRecallEngine } from './explicit-cue-recall.js';
+
+interface TargetedFactRecallOptions {
+    engine: ExplicitCueRecallEngine | null | undefined;
+    sessionId?: string;
+    query: string;
+    maxChars: number;
+    maxItemChars?: number;
+    maxSearchResults?: number;
+    maxScanWindowTurns?: number;
+    maxScanWindowTokens?: number;
+    title?: string;
+}
+declare function shouldRecallTargetedFactEvidence(query: string): boolean;
+declare function buildTargetedFactRecallSection(options: TargetedFactRecallOptions): Promise<string>;
+
+export { type TargetedFactRecallOptions, buildTargetedFactRecallSection, shouldRecallTargetedFactEvidence };

package/dist/targeted-fact-recall.js

@@ -0,0 +1,11 @@
+import {
+  buildTargetedFactRecallSection,
+  shouldRecallTargetedFactEvidence
+} from "./chunk-VWT3F4IV.js";
+import "./chunk-PYPOFEMK.js";
+import "./chunk-PZ5AY32C.js";
+export {
+  buildTargetedFactRecallSection,
+  shouldRecallTargetedFactEvidence
+};
+//# sourceMappingURL=targeted-fact-recall.js.map

package/dist/targeted-fact-recall.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/telemetry-transcript.d.ts

@@ -0,0 +1,7 @@
+declare function stripRolePrefix(line: string): string;
+declare function isTelemetryMarkerLine(line: string): boolean;
+declare function isMechanicalTelemetryLine(line: string): boolean;
+declare function hasDurableMemoryCue(conversation: string): boolean;
+declare function looksLikeMechanicalTelemetryTranscript(conversation: string): boolean;
+
+export { hasDurableMemoryCue, isMechanicalTelemetryLine, isTelemetryMarkerLine, looksLikeMechanicalTelemetryTranscript, stripRolePrefix };

package/dist/telemetry-transcript.js

@@ -0,0 +1,16 @@
+import {
+  hasDurableMemoryCue,
+  isMechanicalTelemetryLine,
+  isTelemetryMarkerLine,
+  looksLikeMechanicalTelemetryTranscript,
+  stripRolePrefix
+} from "./chunk-4RA3C3EV.js";
+import "./chunk-PZ5AY32C.js";
+export {
+  hasDurableMemoryCue,
+  isMechanicalTelemetryLine,
+  isTelemetryMarkerLine,
+  looksLikeMechanicalTelemetryTranscript,
+  stripRolePrefix
+};
+//# sourceMappingURL=telemetry-transcript.js.map

package/dist/telemetry-transcript.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/temporal-supersession.d.ts

@@ -1,6 +1,6 @@
 import { MemoryFrontmatter } from './types.js';
 import { StorageManager } from './storage.js';
-import './index-1qIcnbG1.js';
+import './index-DJ9QWMw-.js';
 import './page-versioning.js';
 import './consolidation-operator.js';
 import './memory-projection-store-CY8TU40w.js';

package/dist/temporal-supersession.js

@@ -6,7 +6,8 @@ import {
   shouldFilterSupersededFromRecall,
   shouldSupersedeExisting,
   supersessionKeysForFact
-} from "./chunk-ZTSE2ZJ6.js";
+} from "./chunk-OIGNEXKZ.js";
+import "./chunk-MDYG7VI7.js";
 import "./chunk-2ODBA7MQ.js";
 import "./chunk-PZ5AY32C.js";
 export {

package/dist/temporal-validity.d.ts

@@ -1,5 +1,5 @@
 import { MemoryFrontmatter } from './types.js';
-import './index-1qIcnbG1.js';
+import './index-DJ9QWMw-.js';
 
 /**
  * Temporal validity helpers (issue #680).

package/dist/threading.d.ts

@@ -1,5 +1,5 @@
 import { BufferTurn, ConversationThread } from './types.js';
-import './index-1qIcnbG1.js';
+import './index-DJ9QWMw-.js';
 
 /**
  * Conversation Threading (Phase 3B)

package/dist/tier-migration.d.ts

@@ -2,7 +2,7 @@ import { MemoryFile } from './types.js';
 import { StorageManager } from './storage.js';
 import { MemoryTier } from './tier-routing.js';
 import { S as SearchBackend } from './port-B6VEDIkC.js';
-import './index-1qIcnbG1.js';
+import './index-DJ9QWMw-.js';
 import './page-versioning.js';
 import './consolidation-operator.js';
 import './memory-projection-store-CY8TU40w.js';

package/dist/tier-routing.d.ts

@@ -1,6 +1,6 @@
 import { MemoryFile } from './types.js';
 import { LifecycleSignals } from './lifecycle.js';
-import './index-1qIcnbG1.js';
+import './index-DJ9QWMw-.js';
 
 type MemoryTier = "hot" | "cold";
 interface TierRoutingPolicy {

package/dist/tokens.js

@@ -9,7 +9,7 @@ import {
   resolveConnectorFromToken,
   revokeToken,
   saveTokenStore
-} from "./chunk-VTU2B4VF.js";
+} from "./chunk-HQZVVSVB.js";
 import "./chunk-MARWOCVP.js";
 import "./chunk-PZ5AY32C.js";
 export {

package/dist/topics.d.ts

@@ -1,5 +1,5 @@
 import { MemoryFile, TopicScore } from './types.js';
-import './index-1qIcnbG1.js';
+import './index-DJ9QWMw-.js';
 
 /**
  * Topic Extraction (Phase 4B)

package/dist/transcript.d.ts

@@ -1,6 +1,6 @@
 import { PluginConfig, TranscriptEntry, Checkpoint } from './types.js';
 import { SessionIntegrityReport } from './session-integrity.js';
-import './index-1qIcnbG1.js';
+import './index-DJ9QWMw-.js';
 
 /**
  * Manages conversation transcript storage, checkpointing, and recall formatting.

package/dist/trust-zones.d.ts

@@ -98,12 +98,13 @@ interface TrustZonePromotionReadiness {
     corroborationSourceClasses: TrustZoneSourceClass[];
 }
 interface TrustZoneDemoSeedResult {
-    scenario: string;
+    scenario: TrustZoneDemoScenario;
     dryRun: boolean;
     recordsWritten: number;
     records: TrustZoneRecord[];
     filePaths: string[];
 }
+type TrustZoneDemoScenario = "enterprise-buyer-v1" | "agentic-commerce-v1";
 declare function resolveTrustZoneStoreDir(memoryDir: string, overrideDir?: string): string;
 declare function validateTrustZoneRecord(raw: unknown): TrustZoneRecord;
 declare function recordTrustZoneRecord(options: {
@@ -167,4 +168,4 @@ declare function getTrustZoneStoreStatus(options: {
     poisoningDefenseEnabled: boolean;
 }): Promise<TrustZoneStoreStatus>;
 
-export { type TrustZoneDemoSeedResult, type TrustZoneListResult, type TrustZoneName, type TrustZonePromotionPlan, type TrustZonePromotionReadiness, type TrustZonePromotionResult, type TrustZoneProvenance, type TrustZoneProvenanceScore, type TrustZoneRecord, type TrustZoneRecordEntry, type TrustZoneRecordKind, type TrustZoneScoreBand, type TrustZoneSearchResult, type TrustZoneSourceClass, type TrustZoneStoreStatus, getTrustZoneStoreStatus, isTrustZoneName, listTrustZoneRecords, planTrustZonePromotion, promoteTrustZoneRecord, recordTrustZoneRecord, resolveTrustZoneStoreDir, scoreTrustZoneProvenance, searchTrustZoneRecords, seedTrustZoneDemoDataset, summarizeTrustZonePromotionReadiness, validateTrustZoneRecord };
+export { type TrustZoneDemoScenario, type TrustZoneDemoSeedResult, type TrustZoneListResult, type TrustZoneName, type TrustZonePromotionPlan, type TrustZonePromotionReadiness, type TrustZonePromotionResult, type TrustZoneProvenance, type TrustZoneProvenanceScore, type TrustZoneRecord, type TrustZoneRecordEntry, type TrustZoneRecordKind, type TrustZoneScoreBand, type TrustZoneSearchResult, type TrustZoneSourceClass, type TrustZoneStoreStatus, getTrustZoneStoreStatus, isTrustZoneName, listTrustZoneRecords, planTrustZonePromotion, promoteTrustZoneRecord, recordTrustZoneRecord, resolveTrustZoneStoreDir, scoreTrustZoneProvenance, searchTrustZoneRecords, seedTrustZoneDemoDataset, summarizeTrustZonePromotionReadiness, validateTrustZoneRecord };

package/dist/trust-zones.js

@@ -11,7 +11,7 @@ import {
   seedTrustZoneDemoDataset,
   summarizeTrustZonePromotionReadiness,
   validateTrustZoneRecord
-} from "./chunk-EQINRHYR.js";
+} from "./chunk-QDZ2RLEC.js";
 import "./chunk-DT5TVLJE.js";
 import "./chunk-DGXUHMOV.js";
 import "./chunk-LPSF4OQH.js";

package/dist/types.d.ts

@@ -1,4 +1,4 @@
-import { L as LcmMessagePartInput, M as MessagePartSourceFormat } from './index-1qIcnbG1.js';
+import { L as LcmMessagePartInput, M as MessagePartSourceFormat } from './index-DJ9QWMw-.js';
 
 /**
  * dreams-ledger.ts — per-phase telemetry for the Dreams consolidation pipeline.
@@ -170,6 +170,7 @@ interface RecallSectionConfig {
     timeoutMs?: number;
     maxPatterns?: number;
     maxRubrics?: number;
+    forceGeneric?: boolean;
 }
 interface RecallPipelineConfig {
     recallBudgetChars: number;
@@ -1048,7 +1049,7 @@ interface PluginConfig {
     localLmsCliPath?: string;
     /** Optional bin directory prepended to PATH for LMS CLI execution. */
     localLmsBinDir?: string;
-    /** Hard timeout for local LLM requests (ms). */
+    /** Hard timeout for local LLM and gateway fallback requests (ms). */
     localLlmTimeoutMs: number;
     /** Max context window for local LLM (override auto-detection). Set lower if your LLM server defaults to smaller contexts. */
     localLlmMaxContext?: number;
@@ -1073,6 +1074,19 @@ interface PluginConfig {
     extractionDedupeWindowMs: number;
     extractionMinChars: number;
     extractionMinUserTurns: number;
+    /**
+     * When true, skip semantic memory extraction for mechanical action/state
+     * telemetry transcripts that have no durable-memory cue. Raw transcript
+     * storage/recall still runs; this only prevents expensive low-value fact
+     * extraction over state logs. Default true.
+     */
+    extractionTelemetryPrefilterEnabled: boolean;
+    /**
+     * When true, LCM uses deterministic compression instead of semantic LLM
+     * summarization for mechanical action/state telemetry transcripts with no
+     * durable-memory cue. Raw transcript storage/recall still runs. Default true.
+     */
+    lcmTelemetryPrefilterEnabled: boolean;
     extractionMaxTurnChars: number;
     extractionMaxFactsPerRun: number;
     extractionMaxEntitiesPerRun: number;
@@ -1450,6 +1464,46 @@ interface PluginConfig {
     explicitCueRecallMaxChars: number;
     /** Maximum query-visible cues expanded per recall. */
     explicitCueRecallMaxReferences: number;
+    /** Enable targeted fact evidence recall for direct answer questions. */
+    targetedFactRecallEnabled: boolean;
+    /** Character budget for the targeted fact evidence section. */
+    targetedFactRecallMaxChars: number;
+    /** Maximum recalled items for targeted fact evidence. */
+    targetedFactRecallMaxResults: number;
+    /** Recent-turn scan window for targeted fact evidence. */
+    targetedFactRecallScanWindowTurns: number;
+    /** Recent-token scan window for targeted fact evidence. */
+    targetedFactRecallScanWindowTokens: number;
+    /** Enable focused list evidence recall for count, relation, and recommendation questions. */
+    focusedListRecallEnabled: boolean;
+    /** Character budget for the focused list evidence section. */
+    focusedListRecallMaxChars: number;
+    /** Maximum recalled items for focused list evidence. */
+    focusedListRecallMaxResults: number;
+    /** Recent-turn scan window for focused list evidence. */
+    focusedListRecallScanWindowTurns: number;
+    /** Recent-token scan window for focused list evidence. */
+    focusedListRecallScanWindowTokens: number;
+    /** Enable response guidance recall for user answer-shape preferences. */
+    responseGuidanceRecallEnabled: boolean;
+    /** Character budget for the response guidance recall section. */
+    responseGuidanceRecallMaxChars: number;
+    /** Maximum recalled items for response guidance. */
+    responseGuidanceRecallMaxResults: number;
+    /** Recent-turn scan window for response guidance. */
+    responseGuidanceRecallScanWindowTurns: number;
+    /** Recent-token scan window for response guidance. */
+    responseGuidanceRecallScanWindowTokens: number;
+    /** Enable event-order evidence recall for chronology questions. */
+    eventOrderRecallEnabled: boolean;
+    /** Character budget for the event-order evidence section. */
+    eventOrderRecallMaxChars: number;
+    /** Maximum recalled items for event-order evidence. */
+    eventOrderRecallMaxResults: number;
+    /** Recent-turn scan window for event-order evidence. */
+    eventOrderRecallScanWindowTurns: number;
+    /** Recent-token scan window for event-order evidence. */
+    eventOrderRecallScanWindowTokens: number;
     lcmEnabled: boolean;
     lcmLeafBatchSize: number;
     lcmRollupFanIn: number;
@@ -1458,6 +1512,8 @@ interface PluginConfig {
     lcmRecallBudgetShare: number;
     lcmDeterministicMaxTokens: number;
     lcmArchiveRetentionDays: number;
+    /** Max independent LCM observe jobs to process concurrently. Default 1. */
+    lcmObserveConcurrency: number;
     /** Opt-in structured message-part capture/recall sidecar for LCM. Default false. */
     messagePartsEnabled: boolean;
     /** Max structured file/tool matches injected into recall. */
@@ -1808,11 +1864,13 @@ interface BufferTurn {
     role: "user" | "assistant";
     content: string;
     timestamp: string;
+    sourceValidAt?: string;
     sessionKey?: string;
     logicalSessionKey?: string;
     providerThreadId?: string | null;
     turnFingerprint?: string;
     persistProcessedFingerprint?: boolean;
+    extractionContextOnly?: boolean;
     parts?: LcmMessagePartInput[];
     rawContent?: unknown;
     sourceFormat?: MessagePartSourceFormat;

package/dist/types.js

@@ -4,7 +4,7 @@ import {
   SPECULATIVE_TTL_DAYS,
   confidenceTier,
   isRecallDisclosure
-} from "./chunk-VQXK37XA.js";
+} from "./chunk-23ZZK64Y.js";
 import "./chunk-PZ5AY32C.js";
 export {
   DEFAULT_RECALL_DISCLOSURE,

package/dist/user-model.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Host-agnostic user-model contract for user-aware agents.
+ *
+ * This is intentionally separate from the existing `MemoryScope` type, which
+ * still means extraction routing scope (`project` | `global`). User context
+ * scopes describe where a model facet is safe and useful to apply.
+ */
+declare const USER_MODEL_CORE_QUESTION = "What does the agent need to understand about this user to act well right now?";
+declare const USER_MODEL_DIMENSIONS: readonly ["preferences", "goals", "projects", "constraints", "current_priorities", "communication_style", "risk_tolerance", "people_relationships", "past_decisions", "definitions_of_good", "ask_before_rules", "do_not_use_outside_rules"];
+type UserModelDimension = (typeof USER_MODEL_DIMENSIONS)[number];
+declare const USER_CONTEXT_SCOPES: readonly ["personal", "work", "client", "project", "repo", "tool", "temporary", "private", "do-not-use-outside-this-context"];
+type UserContextScope = (typeof USER_CONTEXT_SCOPES)[number];
+declare const USER_BOUNDARY_SCOPES: readonly ["temporary", "private", "do-not-use-outside-this-context"];
+type UserBoundaryScope = (typeof USER_BOUNDARY_SCOPES)[number];
+interface UserModelFacet {
+    dimension: UserModelDimension;
+    statement: string;
+    scopes: UserContextScope[];
+    appliesTo?: string[];
+    sourceMemoryIds?: string[];
+    confidence?: number;
+    updatedAt?: string;
+}
+interface UserModelCoverage {
+    present: UserModelDimension[];
+    missing: UserModelDimension[];
+    byDimension: Record<UserModelDimension, UserModelFacet[]>;
+}
+declare function isUserModelDimension(value: unknown): value is UserModelDimension;
+declare function normalizeUserModelDimension(value: unknown): UserModelDimension | null;
+declare function isUserContextScope(value: unknown): value is UserContextScope;
+declare function normalizeUserContextScope(value: unknown): UserContextScope | null;
+declare function isUserBoundaryScope(value: unknown): value is UserBoundaryScope;
+declare function facetHasBoundary(facet: Pick<UserModelFacet, "scopes">): boolean;
+declare function summarizeUserModelCoverage(facets: readonly UserModelFacet[], requiredDimensions?: readonly UserModelDimension[]): UserModelCoverage;
+
+export { USER_BOUNDARY_SCOPES, USER_CONTEXT_SCOPES, USER_MODEL_CORE_QUESTION, USER_MODEL_DIMENSIONS, type UserBoundaryScope, type UserContextScope, type UserModelCoverage, type UserModelDimension, type UserModelFacet, facetHasBoundary, isUserBoundaryScope, isUserContextScope, isUserModelDimension, normalizeUserContextScope, normalizeUserModelDimension, summarizeUserModelCoverage };

package/dist/user-model.js

@@ -0,0 +1,28 @@
+import {
+  USER_BOUNDARY_SCOPES,
+  USER_CONTEXT_SCOPES,
+  USER_MODEL_CORE_QUESTION,
+  USER_MODEL_DIMENSIONS,
+  facetHasBoundary,
+  isUserBoundaryScope,
+  isUserContextScope,
+  isUserModelDimension,
+  normalizeUserContextScope,
+  normalizeUserModelDimension,
+  summarizeUserModelCoverage
+} from "./chunk-SOAU2OE2.js";
+import "./chunk-PZ5AY32C.js";
+export {
+  USER_BOUNDARY_SCOPES,
+  USER_CONTEXT_SCOPES,
+  USER_MODEL_CORE_QUESTION,
+  USER_MODEL_DIMENSIONS,
+  facetHasBoundary,
+  isUserBoundaryScope,
+  isUserContextScope,
+  isUserModelDimension,
+  normalizeUserContextScope,
+  normalizeUserModelDimension,
+  summarizeUserModelCoverage
+};
+//# sourceMappingURL=user-model.js.map

package/dist/user-model.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/utility-runtime.d.ts

@@ -1,6 +1,6 @@
 import { TierRoutingPolicy } from './tier-routing.js';
 import './types.js';
-import './index-1qIcnbG1.js';
+import './index-DJ9QWMw-.js';
 import './lifecycle.js';
 
 interface UtilityRuntimeValues {

package/dist/verified-recall.js

@@ -1,22 +1,22 @@
 import {
   searchVerifiedEpisodes
-} from "./chunk-RXTFCYQF.js";
+} from "./chunk-JESOB2HO.js";
 import "./chunk-URB2WSKZ.js";
-import "./chunk-DT5TVLJE.js";
-import "./chunk-MCC6KDQF.js";
+import "./chunk-3B6KIRBH.js";
 import "./chunk-YNJHCGDT.js";
 import "./chunk-NN2DKE4T.js";
-import "./chunk-VQXK37XA.js";
-import "./chunk-PFV5C235.js";
-import "./chunk-RULE4VG5.js";
+import "./chunk-23ZZK64Y.js";
 import "./chunk-SCU65EZI.js";
 import "./chunk-XJKFSSDW.js";
+import "./chunk-PFV5C235.js";
+import "./chunk-RULE4VG5.js";
 import "./chunk-DM2T26WE.js";
 import "./chunk-QSVPYQPG.js";
 import "./chunk-FVQJYWH7.js";
 import "./chunk-4DJQYKMN.js";
 import "./chunk-G7D6GZ5J.js";
 import "./chunk-FAAFWE4G.js";
+import "./chunk-DT5TVLJE.js";
 import "./chunk-2ODBA7MQ.js";
 import "./chunk-A6XUJE5D.js";
 import "./chunk-PZ5AY32C.js";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@remnic/core",
-  "version": "1.1.10",
+  "version": "1.1.12",
   "description": "Framework-agnostic Remnic memory engine — orchestrator, storage, extraction, search, trust zones",
   "type": "module",
   "main": "dist/index.js",

package/dist/chunk-2YMTO4ZJ.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/recall-xray.ts"],"sourcesContent":["/**\n * Recall X-ray snapshot schema (issue #570, PR 1).\n *\n * The X-ray surface is the unified, per-result attribution document that\n * merges the tier that served each memory, its score decomposition, any\n * graph path, an audit entry id, and the exact filter/eligibility ladder\n * that either admitted or rejected each candidate.  This file defines the\n * schema and an in-memory builder + builder-state helper.\n *\n * Scope for PR 1 (this slice):\n *   - Types only + pure builder functions (no IO, no rendering).\n *   - Orchestrator plumbing captures a snapshot when the caller passes\n *     `xrayCapture: true`.  No behavior change when the flag is absent.\n *   - NO new public surfaces here — CLI/HTTP/MCP land in later slices.\n *\n * The shared renderer lands in PR 2 at `recall-xray-renderer.ts`.  Do not\n * fork formatting logic into other surfaces; extend the renderer.\n */\n\nimport { randomUUID } from \"node:crypto\";\n\nimport type { RecallDisclosure, RecallTierExplain } from \"./types.js\";\nimport { isRecallDisclosure } from \"./types.js\";\n\n/**\n * Estimate token cost of a payload at the rough ~4 chars/token English\n * heuristic.  Non-negative integer; returns 0 for empty / null input.\n * Used by recall surfaces to attach `estimatedTokens` to X-ray results\n * (issue #677 PR 3/4).  Identical to the private heuristic in\n * `chunking.ts`; kept self-contained here so X-ray callers don't pull\n * in chunking internals.\n */\nexport function estimateRecallTokens(text: string | null | undefined): number {\n  if (typeof text !== \"string\" || text.length === 0) return 0;\n  return Math.ceil(text.length / 4);\n}\n\n/**\n * Aggregated per-disclosure token spend summary, computed by the\n * renderer from a snapshot's results.  Non-negative integers.\n */\nexport interface RecallXrayDisclosureSummary {\n  chunk: { count: number; estimatedTokens: number };\n  section: { count: number; estimatedTokens: number };\n  raw: { count: number; estimatedTokens: number };\n  /** Number of results without a recorded disclosure level. */\n  unspecified: { count: number; estimatedTokens: number };\n}\n\n/**\n * Which retrieval source produced a given result.  This is the X-ray\n * tier ladder called out in issue #570 and is *distinct* from the\n * `RetrievalTier` enum (which describes issue #518's tier-explain\n * block).  Keeping the sets separate lets the two observability\n * surfaces evolve without conflating their vocabularies:\n *\n *   - `RetrievalTier`     — direct-answer eligibility ladder.\n *   - `RecallXrayServedBy` — which source materialized each result.\n */\nexport type RecallXrayServedBy =\n  | \"direct-answer\"\n  | \"hybrid\"\n  | \"graph\"\n  | \"recent-scan\"\n  | \"procedural\"\n  | \"review-context\"\n  | \"lcm-file-parts\"\n  | \"lcm-tool-parts\";\n\nexport const RECALL_XRAY_SERVED_BY_VALUES: readonly RecallXrayServedBy[] = [\n  \"direct-answer\",\n  \"hybrid\",\n  \"graph\",\n  \"recent-scan\",\n  \"procedural\",\n  \"review-context\",\n  \"lcm-file-parts\",\n  \"lcm-tool-parts\",\n] as const;\n\nexport function isRecallXrayServedBy(\n  value: unknown,\n): value is RecallXrayServedBy {\n  return (\n    typeof value === \"string\" &&\n    (RECALL_XRAY_SERVED_BY_VALUES as readonly string[]).includes(value)\n  );\n}\n\n/**\n * Score decomposition for a single X-ray result.\n *\n * All fields are optional because different tiers populate different\n * terms: `hybrid` reports vector + bm25 + mmr penalty, `direct-answer`\n * reports importance + tier prior, etc.  The only guaranteed field is\n * `final`, which is the post-combination score used for ordering.\n */\nexport interface RecallXrayScoreDecomposition {\n  vector?: number;\n  bm25?: number;\n  importance?: number;\n  mmrPenalty?: number;\n  tierPrior?: number;\n  /** Additive boost from `reinforcement_count` frontmatter (issue #687 PR 3/4). */\n  reinforcementBoost?: number;\n  final: number;\n}\n\n/**\n * Per-result breakdown inside an X-ray snapshot.\n */\nexport interface RecallXrayResult {\n  memoryId: string;\n  path: string;\n  servedBy: RecallXrayServedBy;\n  scoreDecomposition: RecallXrayScoreDecomposition;\n  graphPath?: string[];\n  /**\n   * Issue #681 PR 3/3 — per-edge confidence values aligned with\n   * `graphPath`. When present, `graphEdgeConfidences[i]` is the\n   * confidence of the edge between `graphPath[i]` and `graphPath[i+1]`,\n   * so the array length is one less than `graphPath`. Legacy edges\n   * without a recorded confidence render as `1.0`. Operators use this\n   * to attribute floor-pruning and PageRank ranking decisions back to\n   * specific edges. The renderer drops the line when the array is\n   * empty or absent so legacy snapshots round-trip cleanly.\n   */\n  graphEdgeConfidences?: number[];\n  auditEntryId?: string;\n  /** Human-readable list of filters the candidate *passed*. */\n  admittedBy: string[];\n  /**\n   * First filter that *would have* rejected the candidate, or undefined\n   * when the candidate was admitted without a rejection trace.  When\n   * present, `admittedBy` may still contain filters the candidate passed\n   * before the rejecting gate; consumers should render both.\n   */\n  rejectedBy?: string;\n  /**\n   * Disclosure depth used to render this result's payload (issue #677\n   * PR 3/4).  Mirrors the per-result disclosure already exposed in the\n   * recall response so X-ray consumers can attribute token spend to\n   * the depth that produced it.\n   */\n  disclosure?: RecallDisclosure;\n  /**\n   * Estimated token cost of the rendered payload at the chosen\n   * disclosure depth.  Non-negative integer.  Computed by callers via\n   * `estimateRecallTokens(text)`; the renderer aggregates these into\n   * a per-disclosure summary so operators can see where their budget\n   * went.\n   */\n  estimatedTokens?: number;\n  /**\n   * Free-form tags from the memory's YAML frontmatter (issue #689 PR 3/3).\n   * Populated by the X-ray capture path when the caller passes a `tags`\n   * filter so per-result tags are available alongside the filter trace\n   * in `snapshot.filters`.  Also populated without a filter when the\n   * orchestrator decorates results via `xrayCapture: true` so all X-ray\n   * consumers can inspect memory labels without a separate storage read.\n   * Absent (not `[]`) when the frontmatter has no tags or the memory\n   * could not be read.\n   */\n  tags?: string[];\n}\n\n/**\n * Trace entry for a filter the orchestrator evaluated during recall.\n * Captures the name of the filter, how many candidates it saw, and how\n * many it let through.  Used by X-ray consumers to render the filter\n * ladder above the per-result breakdown.\n */\nexport interface RecallFilterTrace {\n  name: string;\n  considered: number;\n  admitted: number;\n  /** Optional human-readable reason for any rejections. */\n  reason?: string;\n}\n\n/**\n * Peer-profile injection annotation (issue #679 completion).\n *\n * When `peerProfileRecallEnabled` is true and a peer is registered for\n * the session, the orchestrator injects a `## Peer Profile` section into\n * the recall context. This annotation records which peer was injected and\n * how many profile fields were included so operators can correlate\n * retrieval quality with peer-context enrichment.\n *\n * `null` means no peer profile was injected (peer not registered, feature\n * disabled, or peer has no profile fields).\n */\nexport interface RecallXrayPeerProfileInjection {\n  /** The peer id whose profile was injected. */\n  peerId: string;\n  /**\n   * Number of profile fields included after the `peerProfileRecallMaxFields`\n   * cap was applied.  Zero means the profile existed but had no fields.\n   */\n  fieldsInjected: number;\n}\n\n/**\n * The unified X-ray snapshot.  CLI, HTTP, and MCP surfaces all render\n * this same shape through the shared renderer (CLAUDE.md rule 22).\n */\nexport interface RecallXraySnapshot {\n  /** Stable v1 tag so downstream consumers can version-gate their parsers. */\n  schemaVersion: \"1\";\n  query: string;\n  /** UUID minted per capture; unique across snapshots within a process. */\n  snapshotId: string;\n  /** Epoch milliseconds the snapshot was captured. */\n  capturedAt: number;\n  /**\n   * Tier-explain block from issue #518, carried verbatim when present.\n   * `null` means direct-answer tier did not run (disabled, or another\n   * tier served the query).\n   */\n  tierExplain: RecallTierExplain | null;\n  results: RecallXrayResult[];\n  filters: RecallFilterTrace[];\n  /**\n   * Character budget accounting for the final assembled recall payload.\n   * `used` is the rendered-context length; `chars` is the cap.  Both are\n   * non-negative integers in `[0, 2**31)`.\n   */\n  budget: { chars: number; used: number };\n  /** Optional session-scope fields carried for downstream filtering. */\n  sessionKey?: string;\n  namespace?: string;\n  traceId?: string;\n  /**\n   * Peer-profile injection metadata (issue #679 completion).\n   * Non-null when `peerProfileRecallEnabled` is true and a peer profile\n   * was successfully injected into this recall's context. `null` (or\n   * absent) means no peer profile was injected.\n   */\n  peerProfileInjection?: RecallXrayPeerProfileInjection | null;\n}\n\n// ─── Builder ──────────────────────────────────────────────────────────────\n\nexport interface BuildXraySnapshotInput {\n  query: string;\n  tierExplain?: RecallTierExplain | null;\n  results?: RecallXrayResult[];\n  filters?: RecallFilterTrace[];\n  budget?: { chars?: number; used?: number };\n  sessionKey?: string;\n  namespace?: string;\n  traceId?: string;\n  /** Peer-profile injection metadata (issue #679 completion). */\n  peerProfileInjection?: RecallXrayPeerProfileInjection | null;\n  /** Optional injected timestamp for deterministic tests. */\n  now?: () => number;\n  /** Optional injected id generator for deterministic tests. */\n  snapshotIdGenerator?: () => string;\n}\n\n/**\n * Build a `RecallXraySnapshot` from explicit input fields.  Pure\n * function; safe to call from anywhere.  All array/object inputs are\n * shallow-copied so caller mutation after build cannot tear the\n * returned snapshot.\n */\nexport function buildXraySnapshot(\n  input: BuildXraySnapshotInput,\n): RecallXraySnapshot {\n  const now = input.now ?? Date.now;\n  const snapshotIdGenerator = input.snapshotIdGenerator ?? randomUUID;\n\n  const results = Array.isArray(input.results)\n    ? input.results.map(cloneResult)\n    : [];\n  const filters = Array.isArray(input.filters)\n    ? input.filters.map(cloneFilter)\n    : [];\n\n  const budgetChars = nonNegativeInt(input.budget?.chars);\n  const budgetUsed = nonNegativeInt(input.budget?.used);\n\n  const tierExplain =\n    input.tierExplain && typeof input.tierExplain === \"object\"\n      ? cloneTierExplain(input.tierExplain)\n      : null;\n\n  // Peer-profile injection annotation (issue #679 completion).\n  // Deep-copy via structuredClone so the caller can't mutate the snapshot\n  // after build. Accept null explicitly (no injection) or a valid object.\n  let peerProfileInjection: RecallXrayPeerProfileInjection | null | undefined;\n  if (input.peerProfileInjection && typeof input.peerProfileInjection === \"object\") {\n    const raw = input.peerProfileInjection;\n    const peerId = nonEmptyString(raw.peerId);\n    if (peerId !== undefined) {\n      peerProfileInjection = {\n        peerId,\n        fieldsInjected: nonNegativeInt(raw.fieldsInjected),\n      };\n    }\n  } else if (input.peerProfileInjection === null) {\n    peerProfileInjection = null;\n  }\n\n  const out: RecallXraySnapshot = {\n    schemaVersion: \"1\",\n    query: typeof input.query === \"string\" ? input.query : \"\",\n    snapshotId: snapshotIdGenerator(),\n    capturedAt: now(),\n    tierExplain,\n    results,\n    filters,\n    budget: { chars: budgetChars, used: budgetUsed },\n    sessionKey: nonEmptyString(input.sessionKey),\n    namespace: nonEmptyString(input.namespace),\n    traceId: nonEmptyString(input.traceId),\n  };\n  if (peerProfileInjection !== undefined) {\n    out.peerProfileInjection = peerProfileInjection;\n  }\n  return out;\n}\n\n/**\n * Mutable builder used by the orchestrator to accumulate X-ray fields\n * as recall progresses.  Call `build()` to get the finalized\n * immutable-ish snapshot.  All inputs are validated at insert time so\n * a malformed entry cannot poison the snapshot later.\n */\nexport class RecallXrayBuilder {\n  private readonly query: string;\n  private readonly sessionKey: string | undefined;\n  private namespace: string | undefined;\n  private traceId: string | undefined;\n  private tierExplain: RecallTierExplain | null = null;\n  private readonly results: RecallXrayResult[] = [];\n  private readonly filters: RecallFilterTrace[] = [];\n  private budgetChars = 0;\n  private budgetUsed = 0;\n  private peerProfileInjection: RecallXrayPeerProfileInjection | null | undefined;\n\n  constructor(opts: {\n    query: string;\n    sessionKey?: string;\n    namespace?: string;\n    traceId?: string;\n  }) {\n    this.query = typeof opts.query === \"string\" ? opts.query : \"\";\n    this.sessionKey = nonEmptyString(opts.sessionKey);\n    this.namespace = nonEmptyString(opts.namespace);\n    this.traceId = nonEmptyString(opts.traceId);\n  }\n\n  setNamespace(namespace: string | undefined): void {\n    this.namespace = nonEmptyString(namespace);\n  }\n\n  setTraceId(traceId: string | undefined): void {\n    this.traceId = nonEmptyString(traceId);\n  }\n\n  setTierExplain(tierExplain: RecallTierExplain | null | undefined): void {\n    this.tierExplain =\n      tierExplain && typeof tierExplain === \"object\"\n        ? cloneTierExplain(tierExplain)\n        : null;\n  }\n\n  setBudget(budget: { chars?: number; used?: number }): void {\n    this.budgetChars = nonNegativeInt(budget.chars);\n    this.budgetUsed = nonNegativeInt(budget.used);\n  }\n\n  /**\n   * Record peer-profile injection metadata for this recall snapshot\n   * (issue #679 completion). Pass `null` to explicitly record that no\n   * injection happened (feature enabled but no peer / no profile fields).\n   */\n  setPeerProfileInjection(\n    injection: RecallXrayPeerProfileInjection | null,\n  ): void {\n    this.peerProfileInjection = injection;\n  }\n\n  recordResult(result: RecallXrayResult): void {\n    this.results.push(cloneResult(result));\n  }\n\n  recordFilter(filter: RecallFilterTrace): void {\n    this.filters.push(cloneFilter(filter));\n  }\n\n  build(opts: {\n    now?: () => number;\n    snapshotIdGenerator?: () => string;\n  } = {}): RecallXraySnapshot {\n    return buildXraySnapshot({\n      query: this.query,\n      tierExplain: this.tierExplain,\n      results: this.results,\n      filters: this.filters,\n      budget: { chars: this.budgetChars, used: this.budgetUsed },\n      sessionKey: this.sessionKey,\n      namespace: this.namespace,\n      traceId: this.traceId,\n      peerProfileInjection: this.peerProfileInjection,\n      now: opts.now,\n      snapshotIdGenerator: opts.snapshotIdGenerator,\n    });\n  }\n}\n\n// ─── Internals ────────────────────────────────────────────────────────────\n\nfunction cloneResult(result: RecallXrayResult): RecallXrayResult {\n  if (!result || typeof result !== \"object\") {\n    throw new TypeError(\"RecallXrayResult must be an object\");\n  }\n  if (!isRecallXrayServedBy(result.servedBy)) {\n    throw new TypeError(\n      `RecallXrayResult.servedBy must be one of ${RECALL_XRAY_SERVED_BY_VALUES.join(\n        \", \",\n      )}; got ${JSON.stringify(result.servedBy)}`,\n    );\n  }\n  const memoryId = typeof result.memoryId === \"string\" ? result.memoryId : \"\";\n  const path = typeof result.path === \"string\" ? result.path : \"\";\n  const admittedBy = Array.isArray(result.admittedBy)\n    ? result.admittedBy.filter((x): x is string => typeof x === \"string\")\n    : [];\n  const graphPath = Array.isArray(result.graphPath)\n    ? result.graphPath.filter((x): x is string => typeof x === \"string\")\n    : undefined;\n  // Issue #681 PR 3/3 — per-edge confidences alongside graph path.\n  // Each entry is clamped into [0, 1]; the array is rejected wholesale\n  // when alignment cannot be verified so downstream surfaces can rely\n  // on `graphEdgeConfidences[i]` describing the edge between\n  // `graphPath[i]` and `graphPath[i+1]`.\n  //\n  // Cursor review (#735): the input array length MUST match\n  // `graphPath.length - 1` *before* any per-element filtering. The\n  // earlier implementation skipped non-finite entries via `continue`\n  // and then length-checked the cleaned array — that would silently\n  // shift surviving values to earlier positions. Example: input\n  // `[0.5, NaN, 0.7]` for a 3-edge path would collapse to\n  // `[0.5, 0.7]`, length-check would pass against `expected = 2`, and\n  // the renderer would mis-attribute `0.7` to edge B→C when it really\n  // came from edge C→D. Reject on either size mismatch or any\n  // non-finite entry so misalignment is impossible.\n  let graphEdgeConfidences: number[] | undefined;\n  if (Array.isArray(result.graphEdgeConfidences) && graphPath && graphPath.length > 1) {\n    const expected = graphPath.length - 1;\n    const raw = result.graphEdgeConfidences;\n    if (raw.length === expected) {\n      const cleaned: number[] = [];\n      let allFinite = true;\n      for (const value of raw) {\n        if (typeof value !== \"number\" || !Number.isFinite(value)) {\n          allFinite = false;\n          break;\n        }\n        cleaned.push(Math.min(1, Math.max(0, value)));\n      }\n      if (allFinite) {\n        graphEdgeConfidences = cleaned;\n      }\n    }\n  }\n  const auditEntryId = nonEmptyString(result.auditEntryId);\n  const rejectedBy = nonEmptyString(result.rejectedBy);\n  const scoreDecomposition = cloneScoreDecomposition(result.scoreDecomposition);\n  const out: RecallXrayResult = {\n    memoryId,\n    path,\n    servedBy: result.servedBy,\n    scoreDecomposition,\n    admittedBy,\n  };\n  if (graphPath !== undefined) out.graphPath = graphPath;\n  if (graphEdgeConfidences !== undefined) {\n    out.graphEdgeConfidences = graphEdgeConfidences;\n  }\n  if (auditEntryId !== undefined) out.auditEntryId = auditEntryId;\n  if (rejectedBy !== undefined) out.rejectedBy = rejectedBy;\n  // Disclosure + token telemetry (issue #677 PR 3/4).  Only attach when\n  // present and well-formed; unknown disclosure values are dropped so a\n  // bad caller can't poison downstream renderers.  Uses the shared\n  // `isRecallDisclosure` guard so adding a fourth disclosure level\n  // requires touching only `types.ts`.\n  if (isRecallDisclosure(result.disclosure)) {\n    out.disclosure = result.disclosure;\n  }\n  if (\n    typeof result.estimatedTokens === \"number\" &&\n    Number.isFinite(result.estimatedTokens) &&\n    result.estimatedTokens >= 0\n  ) {\n    out.estimatedTokens = Math.floor(result.estimatedTokens);\n  }\n  // Tags from frontmatter (issue #689 PR 3/3).  Normalize identically to\n  // the recall-surface path: trim and drop empty strings so consumers can\n  // compare tags directly without a secondary normalization step.\n  if (Array.isArray(result.tags)) {\n    const cleanedTags = result.tags\n      .filter((t): t is string => typeof t === \"string\")\n      .map((t) => t.trim())\n      .filter((t) => t.length > 0);\n    if (cleanedTags.length > 0) {\n      out.tags = cleanedTags;\n    }\n  }\n  return out;\n}\n\n/**\n * Summarize per-disclosure token spend across an X-ray snapshot's\n * results.  Pure helper — used by the markdown renderer to print a\n * \"per-disclosure token spend\" line and exposed for tests / surfaces.\n */\nexport function summarizeDisclosureTokens(\n  results: ReadonlyArray<RecallXrayResult>,\n): RecallXrayDisclosureSummary {\n  const summary: RecallXrayDisclosureSummary = {\n    chunk: { count: 0, estimatedTokens: 0 },\n    section: { count: 0, estimatedTokens: 0 },\n    raw: { count: 0, estimatedTokens: 0 },\n    unspecified: { count: 0, estimatedTokens: 0 },\n  };\n  for (const result of results) {\n    const tokens =\n      typeof result.estimatedTokens === \"number\" &&\n      Number.isFinite(result.estimatedTokens) &&\n      result.estimatedTokens >= 0\n        ? Math.floor(result.estimatedTokens)\n        : 0;\n    const bucket = isRecallDisclosure(result.disclosure)\n      ? result.disclosure\n      : \"unspecified\";\n    summary[bucket].count += 1;\n    summary[bucket].estimatedTokens += tokens;\n  }\n  return summary;\n}\n\nfunction cloneFilter(filter: RecallFilterTrace): RecallFilterTrace {\n  if (!filter || typeof filter !== \"object\") {\n    throw new TypeError(\"RecallFilterTrace must be an object\");\n  }\n  const out: RecallFilterTrace = {\n    name: typeof filter.name === \"string\" ? filter.name : \"\",\n    considered: nonNegativeInt(filter.considered),\n    admitted: nonNegativeInt(filter.admitted),\n  };\n  const reason = nonEmptyString(filter.reason);\n  if (reason !== undefined) out.reason = reason;\n  return out;\n}\n\nfunction cloneScoreDecomposition(\n  value: RecallXrayScoreDecomposition | undefined,\n): RecallXrayScoreDecomposition {\n  if (!value || typeof value !== \"object\") {\n    return { final: 0 };\n  }\n  const out: RecallXrayScoreDecomposition = {\n    final: finiteNumber(value.final) ?? 0,\n  };\n  const vector = finiteNumber(value.vector);\n  if (vector !== undefined) out.vector = vector;\n  const bm25 = finiteNumber(value.bm25);\n  if (bm25 !== undefined) out.bm25 = bm25;\n  const importance = finiteNumber(value.importance);\n  if (importance !== undefined) out.importance = importance;\n  const mmrPenalty = finiteNumber(value.mmrPenalty);\n  if (mmrPenalty !== undefined) out.mmrPenalty = mmrPenalty;\n  const tierPrior = finiteNumber(value.tierPrior);\n  if (tierPrior !== undefined) out.tierPrior = tierPrior;\n  const reinforcementBoost = finiteNumber(value.reinforcementBoost);\n  if (reinforcementBoost !== undefined && reinforcementBoost > 0) {\n    out.reinforcementBoost = reinforcementBoost;\n  }\n  return out;\n}\n\nfunction cloneTierExplain(tierExplain: RecallTierExplain): RecallTierExplain {\n  // Use structuredClone so future RecallTierExplain additions do not\n  // silently share references through hand-enumerated fields.  The\n  // payload is JSON-shaped.\n  return structuredClone(tierExplain);\n}\n\nfunction nonNegativeInt(value: unknown): number {\n  if (typeof value !== \"number\" || !Number.isFinite(value)) return 0;\n  if (value <= 0) return 0;\n  return Math.floor(value);\n}\n\nfunction finiteNumber(value: unknown): number | undefined {\n  if (typeof value !== \"number\" || !Number.isFinite(value)) return undefined;\n  return value;\n}\n\nfunction nonEmptyString(value: unknown): string | undefined {\n  if (typeof value !== \"string\") return undefined;\n  const trimmed = value.trim();\n  if (trimmed.length === 0) return undefined;\n  return trimmed;\n}\n"],"mappings":"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","names":[]}