@remnic/core 9.69.40 → 9.69.42

package/dist/support-passport/index.js

@@ -4,7 +4,7 @@ import {
   SUPPORT_PASSPORT_MODEL_RESULT_PATH,
   SupportPassportModelBridge,
   parseSupportPassportModelJob
-} from "../chunk-TEMKBSV6.js";
+} from "../chunk-7PSRCGWT.js";
 import {
   DEFAULT_SUPPORT_PASSPORT_CONFIG,
   parseSupportPassportConfig
@@ -14,8 +14,8 @@ import {
   buildSupportPassportPublicRequestHandler,
   composeSupportPassportExternalRequestHandlers,
   normalizeSupportPassportNetworkAddress
-} from "../chunk-SUEOG2S4.js";
-import "../chunk-K4JKAXMO.js";
+} from "../chunk-ZGXHTV5Y.js";
+import "../chunk-AAX22E4K.js";
 import {
   SUPPORT_PASSPORT_DRAFT_MAX_CONTENT_CHARACTERS,
   SUPPORT_PASSPORT_DRAFT_MAX_MEMORIES,
@@ -56,29 +56,30 @@ import {
   notifySupportPassportCommitted,
   resolveSupportPassportModelRoutePlan,
   syncDirectoryForDurability
-} from "../chunk-SFHLQPBF.js";
+} from "../chunk-IUTYNDFS.js";
 import "../chunk-W4F3C7N7.js";
 import "../chunk-MPC7TYTZ.js";
-import "../chunk-ZHXSOMYH.js";
-import "../chunk-CC37E3QM.js";
-import "../chunk-2J3V5QEO.js";
+import "../chunk-VVX5PZFS.js";
+import "../chunk-IFBSZGW3.js";
+import "../chunk-QKCXRS5A.js";
+import "../chunk-C3QXITIP.js";
 import "../chunk-VQ7B2Q6M.js";
-import "../chunk-RDLPFM7I.js";
+import "../chunk-XJLTQTAO.js";
 import "../chunk-PJSK6OJM.js";
+import "../chunk-ROBHL3GL.js";
 import "../chunk-GNVZQ5JN.js";
 import "../chunk-YN2UN7N3.js";
-import "../chunk-ROBHL3GL.js";
-import "../chunk-AEOOGXMQ.js";
+import "../chunk-J2MGTGKC.js";
 import "../chunk-6DNMUYEE.js";
 import "../chunk-P5FPO2BR.js";
 import "../chunk-S4DDLTPX.js";
 import "../chunk-5UBH37SL.js";
-import "../chunk-NVVZPBKI.js";
+import "../chunk-46FVFU7S.js";
 import "../chunk-H7XKCNR6.js";
-import "../chunk-KOTG3RXE.js";
+import "../chunk-AUSRUOMQ.js";
 import "../chunk-SOBJ6NEY.js";
-import "../chunk-BXIJSPCL.js";
-import "../chunk-LKFVVN7R.js";
+import "../chunk-Q62GA5U2.js";
+import "../chunk-WNPRRBOE.js";
 import "../chunk-CVILPI77.js";
 import "../chunk-6WHJ2EAB.js";
 import "../chunk-AQEJKOKI.js";
@@ -87,62 +88,62 @@ import "../chunk-UD7UNYRD.js";
 import "../chunk-IISBCCWR.js";
 import "../chunk-2YA5N2BY.js";
 import "../chunk-HWLIMQE2.js";
-import "../chunk-IOPIGX7Y.js";
+import "../chunk-OP722LOG.js";
 import "../chunk-EI6V5UXY.js";
 import "../chunk-CEO4DONG.js";
 import "../chunk-SGUDMW2K.js";
 import "../chunk-7IRZK6MM.js";
 import "../chunk-NLE6TSLG.js";
 import "../chunk-WLZYGLJ4.js";
-import "../chunk-G2XZFGYN.js";
-import "../chunk-QM2SPLKQ.js";
+import "../chunk-WGZHSQDV.js";
 import "../chunk-JUXOTY6J.js";
+import "../chunk-QM2SPLKQ.js";
 import "../chunk-LTHVM4XN.js";
-import "../chunk-HIP6DKJJ.js";
+import "../chunk-LQVXSRAJ.js";
 import "../chunk-C37ZRXX7.js";
 import "../chunk-7ZNJN5WZ.js";
-import "../chunk-ZRMMXWYI.js";
+import "../chunk-YR5QT4SR.js";
 import "../chunk-RF2SMMPP.js";
-import "../chunk-OEDW4ER7.js";
-import "../chunk-SV4Z2S67.js";
+import "../chunk-AJBWVDRV.js";
+import "../chunk-WUUGE7QC.js";
+import "../chunk-HRATODNO.js";
 import "../chunk-WTWQA7BB.js";
 import "../chunk-VZIAVM72.js";
-import "../chunk-HRATODNO.js";
-import "../chunk-VQWBUPSJ.js";
-import "../chunk-KY236SP5.js";
-import "../chunk-2SNCQHJZ.js";
+import "../chunk-U26LB4WA.js";
+import "../chunk-JMAP6L6Q.js";
+import "../chunk-AHHFBJX7.js";
+import "../chunk-CQ4BTPX6.js";
 import "../chunk-UFGFMWAD.js";
 import "../chunk-BMWN7B3Y.js";
-import "../chunk-2SKMZUOW.js";
+import "../chunk-HK44SV6K.js";
+import "../chunk-3UXOZBHV.js";
+import "../chunk-PIWFNPQT.js";
 import "../chunk-5FAGCOZD.js";
 import "../chunk-EUT2WCWS.js";
 import "../chunk-2LSZVONP.js";
 import "../chunk-DEUNUKTD.js";
 import "../chunk-LXY5VVGM.js";
 import "../chunk-GKCXTSFF.js";
-import "../chunk-IMBQFHRV.js";
-import "../chunk-6P4REYKL.js";
-import "../chunk-K75A5XWU.js";
+import "../chunk-BPXJINHW.js";
+import "../chunk-F6PTJLEM.js";
 import "../chunk-CSAKJVXW.js";
 import "../chunk-K2XUWZBM.js";
 import "../chunk-OD4FM2U7.js";
 import "../chunk-ZY2MNJR6.js";
-import "../chunk-J4WGTN2N.js";
-import "../chunk-3UXOZBHV.js";
-import "../chunk-V6EGNVUT.js";
-import "../chunk-VQYWKCDR.js";
-import "../chunk-MVG3KXON.js";
-import "../chunk-46WM6JX2.js";
+import "../chunk-TBBDFYXW.js";
+import "../chunk-HPMCKAET.js";
+import "../chunk-I65KB36L.js";
 import "../chunk-UHVXE24Y.js";
+import "../chunk-46WM6JX2.js";
 import "../chunk-D5F7TKMH.js";
-import "../chunk-TZ44E732.js";
-import "../chunk-JOP7W24J.js";
+import "../chunk-AIVRD66I.js";
+import "../chunk-PLJ2MQFT.js";
+import "../chunk-KVO2BTA4.js";
 import "../chunk-CYEPCZN5.js";
 import "../chunk-G6NQ3L4T.js";
 import "../chunk-WPGR3RW4.js";
 import "../chunk-6KTXE6A3.js";
 import "../chunk-D7MAYFQP.js";
-import "../chunk-KVO2BTA4.js";
 import "../chunk-4O6WRBGE.js";
 import "../chunk-GUMZC2BO.js";
 import "../chunk-TFA6HPOA.js";
@@ -151,13 +152,13 @@ import "../chunk-72A4L5JJ.js";
 import "../chunk-A7Q43EUZ.js";
 import "../chunk-S2V7RUCL.js";
 import "../chunk-PCEYGOSL.js";
-import "../chunk-MDIEES23.js";
+import "../chunk-WN2OXGGH.js";
 import "../chunk-SCU65EZI.js";
 import "../chunk-MRPOZBJC.js";
 import "../chunk-S2HLHAZ4.js";
 import "../chunk-DM2T26WE.js";
 import "../chunk-LDXUBPMO.js";
-import "../chunk-3XPN7AVY.js";
+import "../chunk-ZYSOT6HD.js";
 import "../chunk-AAD2ZS6P.js";
 import "../chunk-SHEHQBCG.js";
 import "../chunk-3ONXXHQO.js";
@@ -175,35 +176,33 @@ import "../chunk-KG2OOAFF.js";
 import "../chunk-U2VDCFXW.js";
 import "../chunk-ZLQ37WJX.js";
 import "../chunk-IUM3VSHI.js";
-import "../chunk-GDYU6VF4.js";
-import "../chunk-BT7NVCML.js";
 import "../chunk-C64XATK7.js";
 import "../chunk-42JKGUFJ.js";
-import "../chunk-THTF2W7M.js";
+import "../chunk-TRTLWUDD.js";
 import "../chunk-I55KAVET.js";
 import "../chunk-L2EXJQJP.js";
 import "../chunk-45GF7Y3V.js";
-import "../chunk-KTOXQMW3.js";
+import "../chunk-UHSOPTNB.js";
 import "../chunk-E2AWJ7KQ.js";
 import "../chunk-6JMQR72P.js";
+import "../chunk-TOTT6S2V.js";
 import "../chunk-QLK3SL7Q.js";
 import "../chunk-FEHIOYML.js";
 import "../chunk-P32IDSHD.js";
-import "../chunk-NETQXOPY.js";
+import "../chunk-EH3HNCAM.js";
 import "../chunk-WNIUPHWV.js";
 import "../chunk-IJ6WHMFB.js";
 import "../chunk-3SG4FGDV.js";
 import "../chunk-JV3C2MNQ.js";
 import "../chunk-ADXCCZL2.js";
-import "../chunk-353C5UNV.js";
 import "../chunk-236PXYG7.js";
 import "../chunk-ZCUTSMR2.js";
 import "../chunk-QDW3E4RD.js";
 import "../chunk-L63GFNKL.js";
 import "../chunk-RW4QNB4J.js";
 import "../chunk-ZIKENA2C.js";
-import "../chunk-VYCOJKSX.js";
 import "../chunk-6Q3ZTEF6.js";
+import "../chunk-YCVB7X56.js";
 import "../chunk-PJKTFXE2.js";
 import "../chunk-W5BIQOAJ.js";
 import "../chunk-Z7L72ZHL.js";
@@ -211,25 +210,37 @@ import "../chunk-4O4TKIXQ.js";
 import "../chunk-C5C7IJ4Q.js";
 import "../chunk-2QG4SLZI.js";
 import "../chunk-RGMVMVMF.js";
-import "../chunk-TBBDFYXW.js";
-import "../chunk-YCVB7X56.js";
 import "../chunk-3QL24R5Y.js";
 import "../chunk-SYOIVK7K.js";
-import "../chunk-TOTT6S2V.js";
 import "../chunk-PQVCH2AE.js";
-import "../chunk-23HFXQ5J.js";
-import "../chunk-5U7K4W6K.js";
-import "../chunk-62D2PAAM.js";
-import "../chunk-XVDZFTN5.js";
+import "../chunk-RSSLDMFX.js";
+import "../chunk-UDAUULK2.js";
+import "../chunk-GDYU6VF4.js";
+import "../chunk-BT7NVCML.js";
+import "../chunk-353C5UNV.js";
+import "../chunk-VYCOJKSX.js";
+import "../chunk-ZOGKZ2XT.js";
+import "../chunk-VDX2J7OX.js";
+import "../chunk-WEHSQBFR.js";
+import "../chunk-DQEMWVMT.js";
+import "../chunk-J4EB7DNW.js";
+import "../chunk-BJMBJZ2Y.js";
+import "../chunk-UKJAGEXH.js";
+import "../chunk-FP2373TW.js";
+import "../chunk-Z2YFLXHU.js";
+import "../chunk-I4WBNM3M.js";
+import "../chunk-SOAU2OE2.js";
+import "../chunk-6EGIQEKC.js";
+import "../chunk-JDOBQPJY.js";
+import "../chunk-PAAJWQH5.js";
+import "../chunk-RFIJH2OE.js";
 import "../chunk-OQQXGYMX.js";
 import "../chunk-MNIPH6LD.js";
-import "../chunk-AW4QUFQF.js";
-import "../chunk-TG3FAM2S.js";
-import "../chunk-TBXAY2SS.js";
+import "../chunk-JL4TQYM5.js";
+import "../chunk-SGHGCFVV.js";
 import "../chunk-ZA53AZND.js";
 import "../chunk-AL3UYZ5N.js";
 import "../chunk-RL6NEVXT.js";
-import "../chunk-C7HJ3NEI.js";
 import {
   SUPPORT_PASSPORT_ATTRIBUTE_KEYS,
   SUPPORT_PASSPORT_AUDIT_TAG,
@@ -261,35 +272,18 @@ import {
   isSupportPassportPrivateMemory,
   projectSupportPassportCard,
   supportPassportStatIdentity
-} from "../chunk-37CAEC7E.js";
+} from "../chunk-PWPIERBM.js";
 import "../chunk-6MINUTGJ.js";
 import "../chunk-7RJUVTVF.js";
+import "../chunk-MZWSOLMT.js";
+import "../chunk-AW4QUFQF.js";
+import "../chunk-C7HJ3NEI.js";
 import "../chunk-NB3LRY4T.js";
 import "../chunk-5FVVY2EB.js";
 import "../chunk-FFAZ2XFU.js";
 import "../chunk-JDSVLVCG.js";
 import "../chunk-5GKPFL3S.js";
 import "../chunk-JAKIDQB2.js";
-import "../chunk-MZWSOLMT.js";
-import "../chunk-ZN7SMKAK.js";
-import "../chunk-MRV7VSQK.js";
-import "../chunk-PCXDUHQH.js";
-import "../chunk-VUFL7X3H.js";
-import "../chunk-JUOZ62Y7.js";
-import "../chunk-LNEWDF2A.js";
-import "../chunk-T2JSUEH6.js";
-import "../chunk-ZZCR2QYL.js";
-import "../chunk-ZX3AYNNV.js";
-import "../chunk-KQAFEZQX.js";
-import "../chunk-WEHSQBFR.js";
-import "../chunk-X7Y7WX73.js";
-import "../chunk-J4EB7DNW.js";
-import "../chunk-BJMBJZ2Y.js";
-import "../chunk-UKJAGEXH.js";
-import "../chunk-FP2373TW.js";
-import "../chunk-Z2YFLXHU.js";
-import "../chunk-I4WBNM3M.js";
-import "../chunk-SOAU2OE2.js";
 import "../chunk-WQZZDN5M.js";
 import "../chunk-UI3NYK34.js";
 import "../chunk-GCGJW34D.js";
@@ -297,6 +291,13 @@ import "../chunk-AREGMX2J.js";
 import "../chunk-3BTFBQLO.js";
 import "../chunk-LQWOFU6L.js";
 import "../chunk-P7FMDTKL.js";
+import "../chunk-ZN7SMKAK.js";
+import "../chunk-MRV7VSQK.js";
+import "../chunk-PCXDUHQH.js";
+import "../chunk-VUFL7X3H.js";
+import "../chunk-JUOZ62Y7.js";
+import "../chunk-LNEWDF2A.js";
+import "../chunk-T2JSUEH6.js";
 import "../chunk-VFUEZZBS.js";
 import "../chunk-YVGXH72Y.js";
 import "../chunk-3Q3N35W7.js";
@@ -309,9 +310,9 @@ import "../chunk-46EST7JO.js";
 import "../chunk-G73MCJKL.js";
 import "../chunk-A2IYSXDQ.js";
 import "../chunk-B6O2YLUR.js";
-import "../chunk-TVVEYCNW.js";
-import "../chunk-RFYAYKTD.js";
+import "../chunk-7K5Q6COX.js";
 import "../chunk-LBLXEFWK.js";
+import "../chunk-RFYAYKTD.js";
 import "../chunk-YRLHEEQT.js";
 import "../chunk-FF4KLI5W.js";
 import "../chunk-JN72EPOE.js";

package/dist/tagging-CwK6um2q.d.ts

@@ -0,0 +1,240 @@
+import { aO as LocationSegment, aP as LocationPlace, aQ as LocationConfig, M as MemoryFile, aR as WearableConversation } from './types-B65IoepH.js';
+import { S as StorageManager } from './storage-BDKQdsmB.js';
+
+/**
+ * Core location matcher (issue #2046) — the ONE place that decides whether a
+ * memory or wearable conversation gets provider location context.
+ *
+ * Pure and deterministic: no IO, no clocks, no randomness. Inputs are UTC
+ * ISO-8601 instants and half-open [start, end) intervals everywhere.
+ *
+ * Rules (issue #2046 / umbrella #2043 decision D):
+ * 1. A valid memory interval is required — derived ONLY from the memory's own
+ *   bi-temporal frontmatter (`valid_at` / `observedAt` / `invalid_at`), never
+ *   from wall-clock time or message order. Untimed memories stay untagged.
+ * 2. Intervals longer than 24h describe long-lived facts, not events at a
+ *   place; they stay untagged.
+ * 3. A place is tagged only when it is DOMINANT (strictly the longest overlap
+ *   among candidate places; ties are conflicts and leave the memory untagged)
+ *   and meets `minimumOverlapSeconds` and `minimumConfidence`.
+ * 4. Only resolved named places participate (`kind` home/work/poi): transit
+ *   legs and unnamed visits never tag a memory.
+ * 5. No address is ever inferred from text, coordinates, IP, or proximity —
+ *   only provider-supplied place metadata is echoed, and coordinates only
+ *   when `retainCoordinates` is enabled.
+ *
+ * Provider-owned metadata contract: the tag is `location:<stable-place-slug>`
+ * and the opaque provider place id lives in structured attributes. Every
+ * field the matcher writes is provider-owned; a memory that carries
+ * location-ish metadata WITHOUT the `locationSource` marker is treated as
+ * manual/user-authored and is never touched.
+ */
+
+/** Maximum memory span eligible for location tagging. */
+declare const LOCATION_MATCH_MAX_MEMORY_SPAN_MS: number;
+/** Prefix of provider-owned location tags. */
+declare const LOCATION_TAG_PREFIX = "location:";
+/** Structured-attribute keys owned by the tagging pipeline (never manual). */
+declare const LOCATION_ATTRIBUTE_KEYS: readonly ["locationSource", "locationPlaceId", "locationPlace", "locationConfidence", "locationVisitStart", "locationVisitEnd", "locationLatitude", "locationLongitude"];
+interface LocationTagPolicy {
+    minimumOverlapSeconds: number;
+    minimumConfidence: number;
+    retainCoordinates: boolean;
+}
+/** The memory side of a match: a half-open interval, or a single instant. */
+type MemoryLocationWindow = {
+    kind: "interval";
+    startUtc: string;
+    endUtc: string;
+} | {
+    kind: "instant";
+    atUtc: string;
+};
+/** Why a window was rejected before matching. */
+type WindowRejectReason = "untimed" | "span-too-long";
+interface WindowResult {
+    window?: MemoryLocationWindow;
+    /** Local days (YYYY-MM-DD in the tag policy timezone) the window touches. */
+    days?: string[];
+    rejected?: WindowRejectReason;
+}
+/**
+ * Derive the match window from a memory's own frontmatter. `validAt` (the
+ * event start; assumed copies carry the ingestion anchor) opens the window;
+ * `invalid_at` closes it. An end-only memory (no start bound) is untimed.
+ */
+declare function memoryLocationWindow(frontmatter: {
+    valid_at?: string;
+    observedAt?: string;
+    invalid_at?: string;
+}, localDay: (instantUtc: string) => string): WindowResult;
+/** One source's segments for a day, keyed by the configured source id. */
+interface LocationSourceSegments {
+    sourceId: string;
+    segments: LocationSegment[];
+}
+interface LocationMatch {
+    sourceId: string;
+    place: LocationPlace;
+    /** Overlap (ms) with the window — interval mode; see `visitMs` otherwise. */
+    overlapMs: number;
+    /** Total dwell (ms) of the dominant place inside the window's day(s). */
+    visitMs: number;
+    /** Minimum contributing segment confidence, when any source reported one. */
+    confidence?: number;
+    /** Envelope [start, end) of the segments that produced the match. */
+    visitStartUtc: string;
+    visitEndUtc: string;
+}
+type MatchOutcome = {
+    status: "matched";
+    match: LocationMatch;
+} | {
+    status: "unmatched";
+    reason: "no-overlap" | "ambiguous" | "below-minimum-overlap" | "below-minimum-confidence";
+};
+/**
+ * The dominant qualifying place for a window, across every source's
+ * segments. Deterministic: strict overlap comparison, ties (conflicts) are
+ * rejected, and equal-place contributions merge across sources.
+ */
+declare function matchDominantPlace(window: MemoryLocationWindow, sources: readonly LocationSourceSegments[], policy: LocationTagPolicy): MatchOutcome;
+/** Deterministic tag slug for a provider place id (`reitti:place:7` → `reitti-place-7`). */
+declare function locationTagSlug(placeId: string): string;
+/** The provider-owned tag for a matched place. */
+declare function locationTagForPlace(placeId: string): string;
+/** Provider-owned structured attributes describing a match. */
+declare function locationAttributesForMatch(match: LocationMatch, policy: LocationTagPolicy): Record<string, string>;
+interface LocationUpdatePlan {
+    /** Patch for `writeMemoryFrontmatter`; absent when nothing changes. */
+    patch?: {
+        tags: string[];
+        structuredAttributes: Record<string, string>;
+    };
+    /** Outcome for reporting. */
+    outcome: "tagged" | "updated" | "removed" | "unchanged" | "manual-metadata" | "unmatched" | "untimed" | "span-too-long";
+}
+/**
+ * Plan the provider-owned update for one memory: a match adds/replaces ONLY
+ * provider-owned fields; a lost match removes them (corrected observations);
+ * manual location metadata (no `locationSource` marker) always wins and is
+ * never touched. Unrelated tags and attributes survive every path.
+ */
+declare function planLocationUpdate(frontmatter: {
+    tags?: string[];
+    structuredAttributes?: Record<string, string>;
+}, outcome: MatchOutcome, policy: LocationTagPolicy): LocationUpdatePlan;
+
+/**
+ * Location tagging service (issue #2046) — the IO half around the pure
+ * matcher in `matching.ts`. Three consumers share it so the policy can never
+ * fork:
+ *
+ *  1. Write-time enrichment: after an extraction batch has cleared the
+ *     trust/importance/content-hash gates and persisted, the caller tags the
+ *     new memories (post-write, best-effort, never fails the extraction).
+ *  2. Historical backfill (`location/backfill.ts`): the same plan/apply core
+ *     over a bounded date range, idempotent by construction.
+ *  3. Wearable conversation fill: `WearableConversation.location` is filled
+ *     ONLY when the source did not provide one and the match passes policy.
+ *
+ * Segment data comes from the machine-global location sync state
+ * (`state/locations/sync.json`, ≤ 90 tracked days — matching the bounded
+ * backfill range). Reads are plain file loads; every memory mutation goes
+ * through `StorageManager.writeMemoryFrontmatter`, the atomic frontmatter
+ * chokepoint that preserves content (and therefore the content hash),
+ * lifecycle, and versioning invariants.
+ */
+
+/** Segments for one local day, per source id, from the sync state. */
+type DaySegmentIndex = Map<string, LocationSourceSegments[]>;
+/** Load every tracked day's per-source segments (one file read). */
+declare function loadDaySegmentIndex(memoryDir: string): Promise<DaySegmentIndex>;
+declare function locationTagPolicy(config: LocationConfig): LocationTagPolicy;
+/** Every tagging path is off unless BOTH gates are on. */
+declare function locationTaggingEnabled(config: LocationConfig): boolean;
+/**
+ * Write-time post-persist hook (issue #2046): tag the memories an extraction
+ * batch just made durable. Best-effort by contract — gated on both location
+ * gates, and a location failure must never fail the extraction that already
+ * persisted.
+ */
+declare function tagPersistedMemories(storage: StorageManager, memoryIds: string[], config: {
+    memoryDir: string;
+    location?: LocationConfig;
+}): Promise<void>;
+interface LocationEnrichmentCounts {
+    tagged: number;
+    updated: number;
+    removed: number;
+    unchanged: number;
+    unmatched: number;
+    manual: number;
+    untimed: number;
+    spanTooLong: number;
+    failed: number;
+}
+declare function emptyEnrichmentCounts(): LocationEnrichmentCounts;
+interface EnrichMemoriesOptions {
+    storage: Pick<StorageManager, "getMemoryById" | "writeMemoryFrontmatter">;
+    memoryDir: string;
+    config: LocationConfig;
+    /** Enrich exactly these memory ids (write-time path). */
+    memoryIds?: string[];
+    /** Pre-loaded memories (backfill path — one readAllMemories per run). */
+    memories?: MemoryFile[];
+    /** Reuse a caller-loaded segment index (backfill). */
+    index?: DaySegmentIndex;
+    /** Skip every mutation and only report (dry-run). */
+    dryRun?: boolean;
+}
+/**
+ * Apply the matcher to a set of memories and patch provider-owned location
+ * metadata. A failure on ONE memory is counted and skipped — it never blocks
+ * the others (failure isolation, issue #2046).
+ */
+declare function enrichMemoriesWithLocation(options: EnrichMemoriesOptions): Promise<LocationEnrichmentCounts>;
+/**
+ * Fill `WearableConversation.location` for conversations whose source did not
+ * provide one. Missing-only and source-aware: a provider-supplied value is
+ * never overwritten, and a failing conversation never blocks the others.
+ */
+declare function fillWearableConversationLocations(conversations: WearableConversation[], deps: {
+    memoryDir: string;
+    config: LocationConfig;
+}): Promise<void>;
+/** Render an opt-in, labels-only location context section for a day summary. */
+declare function renderDayLocationContext(memoryDir: string, date: string, config: LocationConfig): Promise<string | null>;
+/**
+ * Location context for a briefing (issue #2925): the place names of the
+ * local day containing the briefing window's start, bucketed in the
+ * location config's own timezone (the store's bucketing zone). Opt-in and
+ * labels-only — the caller decides whether to include it.
+ */
+declare function briefingLocationSection(memoryDir: string, windowStartUtc: string, config: LocationConfig): Promise<string | null>;
+declare function applyBriefingLocationContext<T extends {
+    markdown: string;
+    json: Record<string, unknown>;
+}>(result: T, includeLocation: boolean | undefined, memoryDir: string, windowStartUtc: string, location: LocationConfig): Promise<T>;
+/**
+ * Opt-in matched-place-name context (issue #2925), shared by the access
+ * request surfaces (day summary and briefing). Absent or false keeps the
+ * output byte-identical.
+ */
+interface LocationContextRequestOptions {
+    /** Opt-in matched-place-name context appended to the summary or briefing output. */
+    includeLocation?: boolean;
+}
+/**
+ * Auto-gather options for the day summary (issue #2925): the caller's
+ * timezone plus the strictly-opt-in location flag. Only the literal
+ * `true` opts in, matching the transport schemas' boolean contract.
+ */
+declare function daySummaryAutoOptions(request: LocationContextRequestOptions & {
+    timeZone?: string;
+}): {
+    timeZone?: string;
+    includeLocation: boolean;
+};
+
+export { tagPersistedMemories as A, type DaySegmentIndex as D, type EnrichMemoriesOptions as E, type LocationEnrichmentCounts as L, type MatchOutcome as M, type WindowRejectReason as W, applyBriefingLocationContext as a, LOCATION_ATTRIBUTE_KEYS as b, LOCATION_MATCH_MAX_MEMORY_SPAN_MS as c, LOCATION_TAG_PREFIX as d, type LocationContextRequestOptions as e, type LocationMatch as f, type LocationSourceSegments as g, type LocationTagPolicy as h, type LocationUpdatePlan as i, type MemoryLocationWindow as j, type WindowResult as k, briefingLocationSection as l, daySummaryAutoOptions as m, emptyEnrichmentCounts as n, enrichMemoriesWithLocation as o, fillWearableConversationLocations as p, loadDaySegmentIndex as q, locationAttributesForMatch as r, locationTagForPlace as s, locationTagPolicy as t, locationTagSlug as u, locationTaggingEnabled as v, matchDominantPlace as w, memoryLocationWindow as x, planLocationUpdate as y, renderDayLocationContext as z };

package/dist/temporal-supersession.d.ts

@@ -1,5 +1,5 @@
-import { M as MemoryFile, m as MemoryFrontmatter, K as MemoryLifecycleEvent } from './types-nJV23pa3.js';
-import { D as DependencyPropagationDeliveryPort } from './dependency-propagation-delivery-ueZlKTQB.js';
+import { M as MemoryFile, m as MemoryFrontmatter, K as MemoryLifecycleEvent } from './types-B65IoepH.js';
+import { D as DependencyPropagationDeliveryPort } from './dependency-propagation-delivery-C2QFQ97b.js';
 import './message-parts/index.js';
 import './bounded-jsonl-state.js';
 import './operator-doctor-types.js';

package/dist/temporal-timeline-recall.d.ts

@@ -1,4 +1,4 @@
-import { M as MemoryFile } from './types-nJV23pa3.js';
+import { M as MemoryFile } from './types-B65IoepH.js';
 import './message-parts/index.js';
 import './bounded-jsonl-state.js';
 import './operator-doctor-types.js';

package/dist/temporal-validity.d.ts

@@ -1,4 +1,4 @@
-import { m as MemoryFrontmatter } from './types-nJV23pa3.js';
+import { m as MemoryFrontmatter } from './types-B65IoepH.js';
 import './message-parts/index.js';
 import './bounded-jsonl-state.js';
 import './operator-doctor-types.js';

package/dist/threading.d.ts

@@ -1,4 +1,4 @@
-import { k as BufferTurn, W as ConversationThread } from './types-nJV23pa3.js';
+import { k as BufferTurn, W as ConversationThread } from './types-B65IoepH.js';
 import './message-parts/index.js';
 import './bounded-jsonl-state.js';
 import './operator-doctor-types.js';

package/dist/tier-migration.d.ts

@@ -1,5 +1,5 @@
-import { M as MemoryFile } from './types-nJV23pa3.js';
-import { S as StorageManager } from './storage-BprAGBG0.js';
+import { M as MemoryFile } from './types-B65IoepH.js';
+import { S as StorageManager } from './storage-BDKQdsmB.js';
 import { MemoryTier } from './tier-routing.js';
 import { SearchBackend } from './search/port.js';
 import './message-parts/index.js';

package/dist/tier-routing.d.ts

@@ -1,5 +1,5 @@
 import { LifecycleSignals } from './lifecycle.js';
-import { M as MemoryFile } from './types-nJV23pa3.js';
+import { M as MemoryFile } from './types-B65IoepH.js';
 import './message-parts/index.js';
 import './bounded-jsonl-state.js';
 import './operator-doctor-types.js';

package/dist/tier-routing.js

@@ -1,14 +1,14 @@
 import {
   computeTierValueScore,
   decideTierTransition
-} from "./chunk-ZMWSYUUL.js";
+} from "./chunk-GCBIXUPT.js";
 import "./chunk-TBBDFYXW.js";
-import "./chunk-37CAEC7E.js";
+import "./chunk-PWPIERBM.js";
 import "./chunk-JDSVLVCG.js";
 import "./chunk-5GKPFL3S.js";
 import "./chunk-JAKIDQB2.js";
-import "./chunk-VUFL7X3H.js";
 import "./chunk-P7FMDTKL.js";
+import "./chunk-VUFL7X3H.js";
 import "./chunk-PZ5AY32C.js";
 export {
   computeTierValueScore,

package/dist/{tier-stats-LUSUUNU6.js → tier-stats-VK5PCO2L.js}

@@ -5,22 +5,22 @@ import {
 import {
   computeTierValueScore,
   decideTierTransition
-} from "./chunk-ZMWSYUUL.js";
+} from "./chunk-GCBIXUPT.js";
 import "./chunk-W3K3HITK.js";
 import "./chunk-EBA5DA77.js";
 import {
   computeLifecycleValueInputs
 } from "./chunk-TBBDFYXW.js";
-import "./chunk-37CAEC7E.js";
+import "./chunk-PWPIERBM.js";
 import "./chunk-JDSVLVCG.js";
 import "./chunk-5GKPFL3S.js";
 import "./chunk-JAKIDQB2.js";
+import "./chunk-P7FMDTKL.js";
 import "./chunk-VUFL7X3H.js";
 import {
   resolveQmdCapabilities,
   resolveUtilityLearningCapabilities
 } from "./chunk-JUOZ62Y7.js";
-import "./chunk-P7FMDTKL.js";
 import "./chunk-A2IYSXDQ.js";
 import "./chunk-B6O2YLUR.js";
 import "./chunk-KNA3BXXL.js";
@@ -160,4 +160,4 @@ export {
   formatTierSummaryText,
   summarizeTiers
 };
-//# sourceMappingURL=tier-stats-LUSUUNU6.js.map
+//# sourceMappingURL=tier-stats-VK5PCO2L.js.map

package/dist/topics.d.ts

@@ -1,4 +1,4 @@
-import { M as MemoryFile, aN as TopicScore } from './types-nJV23pa3.js';
+import { M as MemoryFile, aN as TopicScore } from './types-B65IoepH.js';
 import './message-parts/index.js';
 import './bounded-jsonl-state.js';
 import './operator-doctor-types.js';