@remnic/core 9.3.705 → 9.3.706

package/dist/direct-answer-wiring.d.ts

@@ -1,4 +1,4 @@
-import { g as MemoryFile, P as PluginConfig } from './types-CJrvHJjx.js';
+import { g as MemoryFile, P as PluginConfig } from './types-Couvz-L3.js';
 import { TrustZoneName } from './trust-zones.js';
 import { T as Taxonomy } from './types-DJhqDJUV.js';
 import { DirectAnswerResult } from './direct-answer.js';

package/dist/direct-answer.d.ts

@@ -1,5 +1,5 @@
 import { TrustZoneName } from './trust-zones.js';
-import { g as MemoryFile } from './types-CJrvHJjx.js';
+import { g as MemoryFile } from './types-Couvz-L3.js';
 import './types-gb_SNtjR.js';
 import './message-parts/index.js';
 

package/dist/embedding-fallback.d.ts

@@ -1,4 +1,4 @@
-import { P as PluginConfig } from './types-CJrvHJjx.js';
+import { P as PluginConfig } from './types-Couvz-L3.js';
 import './types-gb_SNtjR.js';
 import './message-parts/index.js';
 

package/dist/enrichment/index.d.ts

@@ -1,4 +1,4 @@
-import { M as MemoryCategory, y as ImportanceLevel } from '../types-CJrvHJjx.js';
+import { M as MemoryCategory, y as ImportanceLevel } from '../types-Couvz-L3.js';
 import { LoggerBackend } from '../logger.js';
 import '../types-gb_SNtjR.js';
 import '../message-parts/index.js';

package/dist/entity-retrieval.d.ts

@@ -1,5 +1,5 @@
 import { StorageManager } from './storage.js';
-import { P as PluginConfig, T as TranscriptEntry } from './types-CJrvHJjx.js';
+import { P as PluginConfig, T as TranscriptEntry } from './types-Couvz-L3.js';
 import './page-versioning.js';
 import './consolidation-operator.js';
 import './memory-projection-store.js';

package/dist/entity-retrieval.js

@@ -3,19 +3,19 @@ import {
   entityIndexVersion,
   entityRecentTranscriptLookbackHours,
   readRecentEntityTranscriptEntries
-} from "./chunk-KZMMAVR2.js";
+} from "./chunk-HIV5E57C.js";
 import "./chunk-ZCWIH4LH.js";
-import "./chunk-C2EHWNP2.js";
+import "./chunk-2VQYHHWB.js";
 import "./chunk-M7XQSUBB.js";
 import "./chunk-3JJWNZTT.js";
 import "./chunk-5UZXUTVO.js";
 import "./chunk-5GPPACXK.js";
-import "./chunk-OMNTQPZO.js";
-import "./chunk-IREVVFTM.js";
+import "./chunk-TKZ3AL5V.js";
+import "./chunk-6CIAGZ6X.js";
 import "./chunk-SVOZFLIQ.js";
 import "./chunk-LTJAMRGI.js";
 import "./chunk-J6A3CX5N.js";
-import "./chunk-IX3UQT4H.js";
+import "./chunk-MLLTU5FX.js";
 import "./chunk-RULE4VG5.js";
 import "./chunk-SCU65EZI.js";
 import "./chunk-MB5RSUW6.js";

package/dist/entity-schema.d.ts

@@ -1,4 +1,4 @@
-import { Z as EntitySchemaDefinition, _ as EntitySchemaSectionDefinition, $ as EntityStructuredSection } from './types-CJrvHJjx.js';
+import { Z as EntitySchemaDefinition, _ as EntitySchemaSectionDefinition, $ as EntityStructuredSection } from './types-Couvz-L3.js';
 import './types-gb_SNtjR.js';
 import './message-parts/index.js';
 

package/dist/event-time.d.ts

@@ -31,5 +31,39 @@ interface ResolvedEventTime {
  * @param anchorIso  the source turn's ISO timestamp — the resolution anchor
  */
 declare function resolveEventTime(expression: string | undefined | null, anchorIso: string): ResolvedEventTime;
+/**
+ * Resolved bi-temporal fields for a single extracted fact (issue #1578 PR2).
+ *
+ * - `validFrom` / `validUntil` — the event-time `[from, until)` interval.
+ *   When `eventTimeSource === "assumed"`, `validFrom` is copied from
+ *   `observedAt` (the ingestion anchor) so every bi-temporal-on fact carries
+ *   at least a start bound.
+ * - `observedAt` — always the ingestion anchor (the source turn timestamp).
+ * - `eventTimeSource` — `"extracted"` when the expression resolved to a real
+ *   event-time interval; `"assumed"` when the expression was absent or
+ *   unresolvable.
+ *
+ * This is the single write-time helper every extraction entry path calls
+ * (rule 39). It is pure: (expression, anchor) in, interval out. Resolution
+ * never touches `Date.now()` — replay/import of old transcripts resolves
+ * against the old anchor.
+ */
+interface FactEventTime {
+    validFrom?: string;
+    validUntil?: string;
+    observedAt: string;
+    eventTimeSource: "extracted" | "assumed";
+}
+/**
+ * Resolve a single fact's event-time expression against the ingestion anchor.
+ *
+ * Returns the bi-temporal interval to persist alongside the fact. When the
+ * expression is absent, empty, or unresolvable, falls back to
+ * `eventTimeSource: "assumed"` with `validFrom = observedAt` — per the
+ * #1578 frontmatter contract. When the expression resolves but only pins one
+ * bound ("since 2024" → validFrom only; "until 2025-06" → validUntil only),
+ * only the resolved bound is returned.
+ */
+declare function resolveFactEventTime(expression: string | undefined | null, anchorIso: string): FactEventTime;
 
-export { type ResolvedEventTime, resolveEventTime };
+export { type FactEventTime, type ResolvedEventTime, resolveEventTime, resolveFactEventTime };

package/dist/event-time.js

@@ -1,325 +1,11 @@
 import {
-  parseFlexibleIsoTimestamp
-} from "./chunk-P7FMDTKL.js";
+  resolveEventTime,
+  resolveFactEventTime
+} from "./chunk-M7R5R6OJ.js";
+import "./chunk-P7FMDTKL.js";
 import "./chunk-PZ5AY32C.js";
-
-// src/event-time.ts
-var UNITS = ["day", "week", "month", "quarter", "year"];
-function isRelativeUnit(unit) {
-  return UNITS.includes(unit);
-}
-function toIsoUtc(ms) {
-  if (ms === null || !Number.isFinite(ms)) return void 0;
-  return new Date(ms).toISOString();
-}
-function startOfDayUtc(ms) {
-  const d = new Date(ms);
-  d.setUTCHours(0, 0, 0, 0);
-  return d.getTime();
-}
-function startOfNextDayUtc(ms) {
-  const d = new Date(startOfDayUtc(ms));
-  d.setUTCDate(d.getUTCDate() + 1);
-  return d.getTime();
-}
-var SEASON_TO_MONTH = {
-  winter: 12,
-  // Dec–Feb anchor Dec (Northern Hemisphere convention)
-  spring: 3,
-  summer: 6,
-  fall: 9,
-  autumn: 9
-};
-var MONTH_NAMES = {
-  january: 1,
-  february: 2,
-  march: 3,
-  april: 4,
-  may: 5,
-  june: 6,
-  july: 7,
-  august: 8,
-  september: 9,
-  october: 10,
-  november: 11,
-  december: 12,
-  jan: 1,
-  feb: 2,
-  mar: 3,
-  apr: 4,
-  jun: 6,
-  jul: 7,
-  aug: 8,
-  sep: 9,
-  sept: 9,
-  oct: 10,
-  nov: 11,
-  dec: 12
-};
-var QUARTER_START_MONTH = {
-  1: 1,
-  2: 4,
-  3: 7,
-  4: 10
-};
-function monthIndex(token) {
-  const idx = MONTH_NAMES[token.toLowerCase()];
-  return typeof idx === "number" ? idx : void 0;
-}
-function buildDateMs(year, month1, day) {
-  if (!Number.isInteger(year) || !Number.isInteger(month1) || month1 < 1 || month1 > 12 || !Number.isInteger(day) || day < 1 || day > daysInMonth(year, month1)) {
-    return null;
-  }
-  return Date.UTC(year, month1 - 1, day, 0, 0, 0, 0);
-}
-function daysInMonth(year, month1) {
-  return new Date(Date.UTC(year, month1, 0)).getUTCDate();
-}
-function shiftUnit(anchorMs, unit, count) {
-  const d = new Date(anchorMs);
-  switch (unit) {
-    case "day":
-      d.setUTCDate(d.getUTCDate() + count);
-      return startOfDayUtc(d.getTime());
-    case "week":
-      d.setUTCDate(d.getUTCDate() + count * 7);
-      return startOfDayUtc(d.getTime());
-    case "month":
-      d.setUTCMonth(d.getUTCMonth() + count, 1);
-      return startOfDayUtc(d.getTime());
-    case "quarter":
-      d.setUTCMonth(d.getUTCMonth() + count * 3, 1);
-      return startOfDayUtc(d.getTime());
-    case "year":
-      d.setUTCFullYear(d.getUTCFullYear() + count, 0, 1);
-      return startOfDayUtc(d.getTime());
-  }
-}
-function resolveMonthYear(anchorMs, monthToken, direction) {
-  const lower = monthToken.toLowerCase();
-  const targetMonth = monthIndex(lower);
-  if (typeof targetMonth === "number") {
-    const d = new Date(anchorMs);
-    let year = d.getUTCFullYear();
-    let m = targetMonth;
-    if (direction === -1 && m >= d.getUTCMonth() + 1) year -= 1;
-    else if (direction === 1 && m <= d.getUTCMonth() + 1) year += 1;
-    return buildDateMs(year, m, 1);
-  }
-  return null;
-}
-function resolveExplicitMonthYear(token) {
-  const m = token.trim().toLowerCase().match(/^([a-z]+)\s+(\d{4})$/);
-  if (!m) return null;
-  const year = parseInt(m[2], 10);
-  if (!Number.isInteger(year)) return null;
-  const monthIdx = monthIndex(m[1]);
-  const baseMonth = typeof monthIdx === "number" ? monthIdx : SEASON_TO_MONTH[m[1]];
-  if (typeof baseMonth !== "number") return null;
-  return buildDateMs(year, baseMonth, 1);
-}
-function resolveBareYear(token) {
-  const m = token.trim().match(/^(\d{4})$/);
-  if (!m) return null;
-  return buildDateMs(Number(m[1]), 1, 1);
-}
-function isInSeason(baseMonth, anchorMonth) {
-  for (let i = 0; i < 3; i++) {
-    if ((baseMonth - 1 + i) % 12 + 1 === anchorMonth) return true;
-  }
-  return false;
-}
-function resolveSeasonYear(anchorMs, seasonToken, direction) {
-  const baseMonth = SEASON_TO_MONTH[seasonToken.toLowerCase()];
-  if (typeof baseMonth !== "number") return null;
-  const d = new Date(anchorMs);
-  let year = d.getUTCFullYear();
-  const anchorMonth = d.getUTCMonth() + 1;
-  if (direction === -1) {
-    if (baseMonth > anchorMonth || isInSeason(baseMonth, anchorMonth)) year -= 1;
-    if (baseMonth === 12 && anchorMonth <= 2) year -= 1;
-  } else if (direction === 1) {
-    if (baseMonth === 12 && anchorMonth <= 2) {
-    } else if (baseMonth < anchorMonth || isInSeason(baseMonth, anchorMonth)) {
-      year += 1;
-    }
-  } else if (direction === 0 && baseMonth === 12 && anchorMonth <= 2) {
-    year -= 1;
-  }
-  return buildDateMs(year, baseMonth, 1);
-}
-function resolveQuarter(anchorMs, qNumber, direction) {
-  const startMonth = QUARTER_START_MONTH[qNumber];
-  if (typeof startMonth !== "number") return null;
-  const d = new Date(anchorMs);
-  let year = d.getUTCFullYear();
-  const anchorMonth = d.getUTCMonth() + 1;
-  const anchorQ = Math.floor((anchorMonth - 1) / 3) + 1;
-  if (direction === -1 && (startMonth >= anchorMonth || anchorQ === qNumber))
-    year -= 1;
-  else if (direction === 1 && (startMonth <= anchorMonth || anchorQ === qNumber))
-    year += 1;
-  return buildDateMs(year, startMonth, 1);
-}
-function resolveAbsolute(raw) {
-  const trimmed = raw.trim();
-  const ms = parseFlexibleIsoTimestamp(trimmed);
-  if (ms === null) return null;
-  if (!/[Tt]/.test(trimmed)) return startOfDayUtc(ms);
-  return ms;
-}
-function resolveEventTime(expression, anchorIso) {
-  const fallback = { ok: false };
-  if (typeof expression !== "string") return fallback;
-  const expr = expression.trim();
-  if (expr.length === 0) return fallback;
-  const anchorMs = parseFlexibleIsoTimestamp(anchorIso);
-  if (anchorMs === null || !Number.isFinite(anchorMs)) return fallback;
-  const lower = expr.toLowerCase();
-  const sinceMatch = lower.match(/^since\s+(.+)$/);
-  if (sinceMatch) {
-    const inner = sinceMatch[1].trim();
-    let fromMs = resolveRelativePeriod(anchorMs, inner) ?? resolveExplicitMonthYear(inner) ?? resolveBareYear(inner) ?? resolveAbsolute(inner);
-    if (fromMs !== null && fromMs > anchorMs && !/\d{4}/.test(inner)) {
-      const nd = new Date(fromMs);
-      nd.setUTCFullYear(nd.getUTCFullYear() - 1);
-      fromMs = nd.getTime();
-    }
-    const fromIso = toIsoUtc(fromMs);
-    if (!fromIso) return fallback;
-    return { validFrom: fromIso, ok: true };
-  }
-  const untilMatch = lower.match(/^(?:until|through|till|ending)\s+(.+)$/);
-  if (untilMatch) {
-    const inner = untilMatch[1].trim();
-    const untilMs = resolveEndBound(anchorMs, inner);
-    const untilIso = toIsoUtc(untilMs);
-    if (!untilIso) return fallback;
-    return { validUntil: untilIso, ok: true };
-  }
-  if (lower === "today") {
-    const fromIso = toIsoUtc(startOfDayUtc(anchorMs));
-    return fromIso ? { validFrom: fromIso, ok: true } : fallback;
-  }
-  if (lower === "yesterday") {
-    const fromIso = toIsoUtc(shiftUnit(anchorMs, "day", -1));
-    return fromIso ? { validFrom: fromIso, ok: true } : fallback;
-  }
-  if (lower === "tomorrow") {
-    const fromIso = toIsoUtc(shiftUnit(anchorMs, "day", 1));
-    return fromIso ? { validFrom: fromIso, ok: true } : fallback;
-  }
-  const relMatch = lower.match(/^(last|this|next)\s+(.+)$/);
-  if (relMatch) {
-    const direction = relMatch[1] === "last" ? -1 : relMatch[1] === "next" ? 1 : 0;
-    const period = relMatch[2].trim();
-    const ms = resolveRelativePeriod(anchorMs, period, direction);
-    const fromIso = toIsoUtc(ms);
-    return fromIso ? { validFrom: fromIso, ok: true } : fallback;
-  }
-  const explicitMs = resolveExplicitMonthYear(lower) ?? resolveBareYear(lower);
-  if (explicitMs !== null) {
-    const fromIso = toIsoUtc(explicitMs);
-    if (fromIso) return { validFrom: fromIso, ok: true };
-  }
-  const absMs = resolveAbsolute(expr);
-  if (absMs !== null) {
-    const fromIso = toIsoUtc(absMs);
-    return fromIso ? { validFrom: fromIso, ok: true } : fallback;
-  }
-  return fallback;
-}
-function resolveRelativePeriod(anchorMs, period, direction = 0) {
-  const lower = period.trim().toLowerCase();
-  const qTok = lower.match(/^q(?:uarter)?\s?([1-4])$/);
-  if (qTok) {
-    return resolveQuarter(anchorMs, Number(qTok[1]), direction);
-  }
-  if (lower === "quarter") {
-    const d = new Date(anchorMs);
-    let q = Math.floor(d.getUTCMonth() / 3) + 1;
-    let year = d.getUTCFullYear();
-    if (direction === -1) {
-      q -= 1;
-      if (q < 1) {
-        q = 4;
-        year -= 1;
-      }
-    } else if (direction === 1) {
-      q += 1;
-      if (q > 4) {
-        q = 1;
-        year += 1;
-      }
-    }
-    return buildDateMs(year, QUARTER_START_MONTH[q], 1);
-  }
-  if (isRelativeUnit(lower)) {
-    return shiftUnit(anchorMs, lower, direction);
-  }
-  const monthMs = resolveMonthYear(anchorMs, lower, direction);
-  if (monthMs !== null) return monthMs;
-  const seasonMs = resolveSeasonYear(anchorMs, lower, direction);
-  if (seasonMs !== null) return seasonMs;
-  return null;
-}
-function resolveEndBound(anchorMs, period) {
-  const trimmed = period.trim().replace(/^end\s+of\s+/i, "").trim();
-  if (/^\d{4}$/.test(trimmed)) {
-    return buildDateMs(Number(trimmed) + 1, 1, 1);
-  }
-  const absMs = resolveAbsolute(trimmed);
-  if (absMs !== null) {
-    if (!/[Tt]/.test(trimmed)) return startOfNextDayUtc(absMs);
-    return absMs;
-  }
-  const explicitMs = resolveExplicitMonthYear(trimmed);
-  if (explicitMs !== null) {
-    const nd = new Date(explicitMs);
-    const firstWord = trimmed.toLowerCase().split(/\s+/)[0];
-    const monthAdvance = firstWord in SEASON_TO_MONTH ? 3 : 1;
-    nd.setUTCMonth(nd.getUTCMonth() + monthAdvance);
-    return startOfDayUtc(nd.getTime());
-  }
-  const lower = trimmed.toLowerCase();
-  const monthIdx = monthIndex(lower);
-  if (typeof monthIdx === "number") {
-    const d = new Date(anchorMs);
-    const startMs = buildDateMs(d.getUTCFullYear(), monthIdx, 1);
-    if (startMs === null) return null;
-    const nd = new Date(startMs);
-    nd.setUTCMonth(nd.getUTCMonth() + 1);
-    let endMs = startOfDayUtc(nd.getTime());
-    if (endMs > anchorMs && d.getUTCMonth() + 1 !== monthIdx) {
-      nd.setUTCFullYear(nd.getUTCFullYear() - 1);
-      endMs = startOfDayUtc(nd.getTime());
-    }
-    return endMs;
-  }
-  const seasonMonth = SEASON_TO_MONTH[lower];
-  if (typeof seasonMonth === "number") {
-    const d = new Date(anchorMs);
-    const anchorMonth = d.getUTCMonth() + 1;
-    let year = d.getUTCFullYear();
-    if (seasonMonth === 12 && anchorMonth <= 2) year -= 1;
-    const startMs = buildDateMs(year, seasonMonth, 1);
-    if (startMs === null) return null;
-    const nd = new Date(startMs);
-    nd.setUTCMonth(nd.getUTCMonth() + 3);
-    let endMs = startOfDayUtc(nd.getTime());
-    if (endMs > anchorMs && !isInSeason(seasonMonth, anchorMonth)) {
-      nd.setUTCFullYear(nd.getUTCFullYear() - 1);
-      endMs = startOfDayUtc(nd.getTime());
-    }
-    return endMs;
-  }
-  if (lower === "year") {
-    const d = new Date(anchorMs);
-    return buildDateMs(d.getUTCFullYear() + 1, 1, 1);
-  }
-  return null;
-}
 export {
-  resolveEventTime
+  resolveEventTime,
+  resolveFactEventTime
 };
 //# sourceMappingURL=event-time.js.map

package/dist/event-time.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/event-time.ts"],"sourcesContent":["/**\n * Event-time resolver (issue #1578).\n *\n * Extraction can carry an optional per-fact `eventTime` expression — an ISO\n * date or a relative phrase verbatim from the source turn (\"last March\",\n * \"yesterday\", \"since 2024\").  This module resolves such expressions into a\n * `[validFrom, validUntil)` event-time interval, **anchored to the source\n * turn's timestamp** — never to `Date.now()`.\n *\n * Why anchor (not wall-clock): replay/import of old transcripts must resolve\n * \"yesterday\" against the *old* turn's yesterday, not today.  A relative\n * expression is meaningless without its anchor; resolving it against the\n * current time would silently rewrite history (AGENTS.md §39 — byte-identical\n * when the feature is off; rule 35 — half-open intervals; rule 51 — never\n * silently default invalid input).\n *\n * Resolution is **write-time-only**.  The on-disk frontmatter stores absolute\n * ISO timestamps strings (`valid_at` / `invalid_at`); readers never call back\n * into this module.  Anything unresolvable yields `ok: false` and the caller\n * records `eventTimeSource: \"assumed\"` with `valid_at` copied from the\n * ingestion anchor (`observedAt`).\n *\n * Interval semantics are `[validFrom, validUntil)` — inclusive start,\n * exclusive end (AGENTS.md §23).  A date-only expression resolving an *end*\n * bound converts to start-of-next-day so the end date itself is excluded.\n */\nimport { parseFlexibleIsoTimestamp } from \"./utils/iso-timestamp.js\";\n\n/**\n * Resolved event-time interval.  All timestamps are UTC ISO strings.\n *\n * - `validFrom` / `validUntil` carry the half-open `[from, until)` event\n *   interval.  Either may be absent when the expression only pinned one side\n *   (\"since 2024\" → validFrom only).\n * - `ok` is false when the expression could not be resolved.  The caller then\n *   falls back to `eventTimeSource: \"assumed\"`.\n */\nexport interface ResolvedEventTime {\n  validFrom?: string;\n  validUntil?: string;\n  ok: boolean;\n}\n\nconst UNITS = [\"day\", \"week\", \"month\", \"quarter\", \"year\"] as const;\ntype RelativeUnit = (typeof UNITS)[number];\n\nfunction isRelativeUnit(unit: string): unit is RelativeUnit {\n  return (UNITS as readonly string[]).includes(unit);\n}\n\n/**\n * Format a `Date` as a UTC ISO string with millisecond precision, matching the\n * canonical frontmatter form.  Returns `undefined` when the input is not\n * finite (the resolver treats that as unresolvable rather than emitting\n * `Invalid Date`).\n */\nfunction toIsoUtc(ms: number | null): string | undefined {\n  if (ms === null || !Number.isFinite(ms)) return undefined;\n  return new Date(ms).toISOString();\n}\n\n/**\n * Compute the start of the day (UTC) for the given ms, used when a date-only\n * expression resolves a *start* bound — the fact holds from midnight UTC.\n */\nfunction startOfDayUtc(ms: number): number {\n  const d = new Date(ms);\n  d.setUTCHours(0, 0, 0, 0);\n  return d.getTime();\n}\n\n/**\n * Compute the start of the *next* day (UTC) for the given ms, used when a\n * date-only expression resolves an *end* bound — the exclusive `validUntil`\n * must land on the following midnight so the end date itself is excluded\n * (AGENTS.md §23: date-only ends convert to start-of-next-day).\n */\nfunction startOfNextDayUtc(ms: number): number {\n  const d = new Date(startOfDayUtc(ms));\n  d.setUTCDate(d.getUTCDate() + 1);\n  return d.getTime();\n}\n\nconst SEASON_TO_MONTH: Record<string, number> = {\n  winter: 12, // Dec–Feb anchor Dec (Northern Hemisphere convention)\n  spring: 3,\n  summer: 6,\n  fall: 9,\n  autumn: 9,\n};\n\nconst MONTH_NAMES: Record<string, number> = {\n  january: 1, february: 2, march: 3, april: 4, may: 5, june: 6,\n  july: 7, august: 8, september: 9, october: 10, november: 11, december: 12,\n  jan: 1, feb: 2, mar: 3, apr: 4, jun: 6, jul: 7, aug: 8, sep: 9, sept: 9,\n  oct: 10, nov: 11, dec: 12,\n};\n\nconst QUARTER_START_MONTH: Record<number, number> = {\n  1: 1, 2: 4, 3: 7, 4: 10,\n};\n\nfunction monthIndex(token: string): number | undefined {\n  const idx = MONTH_NAMES[token.toLowerCase()];\n  return typeof idx === \"number\" ? idx : undefined;\n}\n\n/**\n * Construct a UTC timestamp from year/month(1-12)/day with overflow validation.\n * Returns `null` when the components do not form a real calendar date (e.g.\n * Feb 30) rather than letting `Date` silently roll over.\n */\nfunction buildDateMs(year: number, month1: number, day: number): number | null {\n  if (\n    !Number.isInteger(year) ||\n    !Number.isInteger(month1) ||\n    month1 < 1 ||\n    month1 > 12 ||\n    !Number.isInteger(day) ||\n    day < 1 ||\n    day > daysInMonth(year, month1)\n  ) {\n    return null;\n  }\n  return Date.UTC(year, month1 - 1, day, 0, 0, 0, 0);\n}\n\nfunction daysInMonth(year: number, month1: number): number {\n  return new Date(Date.UTC(year, month1, 0)).getUTCDate();\n}\n\n/**\n * Add `count` units to a UTC ms timestamp, returning the start-of-period for\n * the resulting date.  Used by \"last/this/next <unit>\" resolution.\n */\nfunction shiftUnit(anchorMs: number, unit: RelativeUnit, count: number): number {\n  const d = new Date(anchorMs);\n  switch (unit) {\n    case \"day\":\n      d.setUTCDate(d.getUTCDate() + count);\n      return startOfDayUtc(d.getTime());\n    case \"week\":\n      d.setUTCDate(d.getUTCDate() + count * 7);\n      return startOfDayUtc(d.getTime());\n    case \"month\":\n      d.setUTCMonth(d.getUTCMonth() + count, 1);\n      return startOfDayUtc(d.getTime());\n    case \"quarter\":\n      d.setUTCMonth(d.getUTCMonth() + count * 3, 1);\n      return startOfDayUtc(d.getTime());\n    case \"year\":\n      d.setUTCFullYear(d.getUTCFullYear() + count, 0, 1);\n      return startOfDayUtc(d.getTime());\n  }\n}\n\n/**\n * Resolve \"last December\" / \"this March\" / \"next Q2\" against the anchor.\n * `direction` is -1 (last), 0 (this), +1 (next).  Returns the start-of-period\n * ms for the referenced month/season/quarter, or `null` if it cannot be\n * placed (e.g. month token not recognized).\n */\nfunction resolveMonthYear(\n  anchorMs: number,\n  monthToken: string,\n  direction: number,\n): number | null {\n  const lower = monthToken.toLowerCase();\n  const targetMonth = monthIndex(lower);\n  if (typeof targetMonth === \"number\") {\n    const d = new Date(anchorMs);\n    let year = d.getUTCFullYear();\n    let m = targetMonth;\n    if (direction === -1 && m >= d.getUTCMonth() + 1) year -= 1;\n    else if (direction === +1 && m <= d.getUTCMonth() + 1) year += 1;\n    return buildDateMs(year, m, 1);\n  }\n  return null;\n}\n/**\n * Resolve an explicit \"<month|season> <year>\" token (e.g. \"march 2025\",\n * \"dec 2024\", \"spring 2025\") to a start-of-month ms.  The explicit year is\n * authoritative — it is never derived from the anchor.  Returns null when\n * the token is not in that shape or does not name a real month/season.\n * Shared by the bare phrase path, \"since <month> <year>\", and the end bound\n * so all three resolve identically (review: month-year phrases after since).\n */\nfunction resolveExplicitMonthYear(token: string): number | null {\n  const m = token.trim().toLowerCase().match(/^([a-z]+)\\s+(\\d{4})$/);\n  if (!m) return null;\n  const year = parseInt(m[2], 10);\n  if (!Number.isInteger(year)) return null;\n  const monthIdx = monthIndex(m[1]);\n  const baseMonth = typeof monthIdx === \"number\" ? monthIdx : SEASON_TO_MONTH[m[1]];\n  if (typeof baseMonth !== \"number\") return null;\n  return buildDateMs(year, baseMonth, 1);\n}\n\n\n/**\n * Resolve a bare four-digit year token (e.g. \"2024\") to January 1 of that\n * year.  Used by \"since 2024\" and bare year expressions.  Review #1578 r2:\n * previously these fell through to ok:false, stamping the fact at ingestion\n * time instead of the documented year start.\n */\nfunction resolveBareYear(token: string): number | null {\n  const m = token.trim().match(/^(\\d{4})$/);\n  if (!m) return null;\n  return buildDateMs(Number(m[1]), 1, 1);\n}\n\n\n/**\n * Check whether the anchor month falls inside a season's 3-month span.\n * Seasons start at `baseMonth` and span 3 months (e.g. summer = Jun–Aug).\n * Winter (Dec=12) wraps: Dec, Jan, Feb.\n */\nfunction isInSeason(baseMonth: number, anchorMonth: number): boolean {\n  for (let i = 0; i < 3; i++) {\n    if (((baseMonth - 1 + i) % 12) + 1 === anchorMonth) return true;\n  }\n  return false;\n}\n\nfunction resolveSeasonYear(\n  anchorMs: number,\n  seasonToken: string,\n  direction: number,\n): number | null {\n  const baseMonth = SEASON_TO_MONTH[seasonToken.toLowerCase()];\n  if (typeof baseMonth !== \"number\") return null;\n  const d = new Date(anchorMs);\n  let year = d.getUTCFullYear();\n  const anchorMonth = d.getUTCMonth() + 1;\n\n  if (direction === -1) {\n    // \"last <season>\": go to the previous occurrence.\n    // If the season hasn't started yet this year (baseMonth > anchorMonth)\n    // or the anchor is currently INSIDE the season, roll back a year.\n    if (baseMonth > anchorMonth || isInSeason(baseMonth, anchorMonth)) year -= 1;\n    // Winter tail (Jan/Feb): current winter started prev Dec, so \"last\"\n    // needs one more year back.\n    if (baseMonth === 12 && anchorMonth <= 2) year -= 1;\n  } else if (direction === +1) {\n    // \"next <season>\": go to the next occurrence.\n    // Winter from Jan/Feb: current winter started prev Dec; next is this Dec.\n    if (baseMonth === 12 && anchorMonth <= 2) {\n      // no year change — next winter is December of the anchor year\n    } else if (baseMonth < anchorMonth || isInSeason(baseMonth, anchorMonth)) {\n      year += 1;\n    }\n  } else if (direction === 0 && baseMonth === 12 && anchorMonth <= 2) {\n    // \"this winter\" from Jan/Feb: winter started in the previous December.\n    year -= 1;\n  }\n  return buildDateMs(year, baseMonth, 1);\n}\n\nfunction resolveQuarter(\n  anchorMs: number,\n  qNumber: number,\n  direction: number,\n): number | null {\n  const startMonth = QUARTER_START_MONTH[qNumber];\n  if (typeof startMonth !== \"number\") return null;\n  const d = new Date(anchorMs);\n  let year = d.getUTCFullYear();\n  const anchorMonth = d.getUTCMonth() + 1;\n  const anchorQ = Math.floor((anchorMonth - 1) / 3) + 1;\n  // Roll back/forward when the target quarter hasn't started yet this year\n  // (startMonth past the anchor month) OR when the anchor is currently\n  // INSIDE the target quarter (review r2: \"last Q2\" from May returned 2026\n  // instead of 2025 because the quarter start month had already passed but\n  // the quarter was still ongoing).\n  if (direction === -1 && (startMonth >= anchorMonth || anchorQ === qNumber))\n    year -= 1;\n  else if (direction === +1 && (startMonth <= anchorMonth || anchorQ === qNumber))\n    year += 1;\n  return buildDateMs(year, startMonth, 1);\n}\n\n/**\n * Resolve an absolute ISO date/datetime to ms.  A date-only value yields\n * start-of-day (UTC).  Returns `null` when the string is not a well-formed,\n * non-overflowed ISO timestamp.\n */\nfunction resolveAbsolute(raw: string): number | null {\n  const trimmed = raw.trim();\n  const ms = parseFlexibleIsoTimestamp(trimmed);\n  if (ms === null) return null;\n  // Date-only inputs (no T) anchor to start-of-day UTC.\n  if (!/[Tt]/.test(trimmed)) return startOfDayUtc(ms);\n  return ms;\n}\n\n/**\n * Resolve a relative event-time expression against an anchor ISO timestamp.\n *\n * Supported shapes (case-insensitive, trimmed):\n *   - absolute ISO date / datetime: `\"2026-03-01\"`, `\"2026-03-01T00:00:00Z\"`\n *   - `\"since <date|monthyear>\"` → validFrom only\n *   - `\"until <date|monthyear>\"` / `\"through ...\"` / `\"until end of ...\"` → validUntil only\n *   - `\"last <month|season|Qn|unit>\"` → validFrom = start of referenced period\n *   - `\"this <month|season|Qn|unit>\"` → validFrom = start of current period\n *   - `\"next <month|season|Qn|unit>\"` → validFrom = start of referenced period\n *   - `\"yesterday\"` / `\"today\"` / `\"tomorrow\"` → validFrom = start of that day\n *\n * Anything else returns `{ ok: false }`.  The caller then records\n * `eventTimeSource: \"assumed\"`.\n *\n * @param expression the raw per-fact event-time phrase (may be empty/garbage)\n * @param anchorIso  the source turn's ISO timestamp — the resolution anchor\n */\nexport function resolveEventTime(\n  expression: string | undefined | null,\n  anchorIso: string,\n): ResolvedEventTime {\n  const fallback: ResolvedEventTime = { ok: false };\n  if (typeof expression !== \"string\") return fallback;\n  const expr = expression.trim();\n  if (expr.length === 0) return fallback;\n\n  const anchorMs = parseFlexibleIsoTimestamp(anchorIso);\n  if (anchorMs === null || !Number.isFinite(anchorMs)) return fallback;\n\n  const lower = expr.toLowerCase();\n\n  // ── \"since <x>\" / \"until <x>\" / \"through <x>\" ──────────────────────────\n  const sinceMatch = lower.match(/^since\\s+(.+)$/);\n  if (sinceMatch) {\n    const inner = sinceMatch[1].trim();\n    let fromMs =\n      resolveRelativePeriod(anchorMs, inner) ??\n      resolveExplicitMonthYear(inner) ??\n      resolveBareYear(inner) ??\n      resolveAbsolute(inner);\n    // \"since <bare month/season>\": if the resolved start is future and the\n    // expression carries no explicit 4-digit year, the fact meant the most\n    // recent PAST occurrence of that period (codex review r2: \"since March\"\n    // from January produced a future validFrom).\n    if (\n      fromMs !== null &&\n      fromMs > anchorMs &&\n      !/\\d{4}/.test(inner)\n    ) {\n      const nd = new Date(fromMs);\n      nd.setUTCFullYear(nd.getUTCFullYear() - 1);\n      fromMs = nd.getTime();\n    }\n    const fromIso = toIsoUtc(fromMs);\n    if (!fromIso) return fallback;\n    return { validFrom: fromIso, ok: true };\n  }\n  const untilMatch = lower.match(/^(?:until|through|till|ending)\\s+(.+)$/);\n  if (untilMatch) {\n    const inner = untilMatch[1].trim();\n    const untilMs = resolveEndBound(anchorMs, inner);\n    const untilIso = toIsoUtc(untilMs);\n    if (!untilIso) return fallback;\n    return { validUntil: untilIso, ok: true };\n  }\n\n  // ── \"yesterday\" / \"today\" / \"tomorrow\" ─────────────────────────────────\n  if (lower === \"today\") {\n    const fromIso = toIsoUtc(startOfDayUtc(anchorMs));\n    return fromIso ? { validFrom: fromIso, ok: true } : fallback;\n  }\n  if (lower === \"yesterday\") {\n    const fromIso = toIsoUtc(shiftUnit(anchorMs, \"day\", -1));\n    return fromIso ? { validFrom: fromIso, ok: true } : fallback;\n  }\n  if (lower === \"tomorrow\") {\n    const fromIso = toIsoUtc(shiftUnit(anchorMs, \"day\", +1));\n    return fromIso ? { validFrom: fromIso, ok: true } : fallback;\n  }\n\n  // ── \"last/this/next <period>\" ──────────────────────────────────────────\n  const relMatch = lower.match(/^(last|this|next)\\s+(.+)$/);\n  if (relMatch) {\n    const direction = relMatch[1] === \"last\" ? -1 : relMatch[1] === \"next\" ? +1 : 0;\n    const period = relMatch[2].trim();\n    const ms = resolveRelativePeriod(anchorMs, period, direction);\n    const fromIso = toIsoUtc(ms);\n    return fromIso ? { validFrom: fromIso, ok: true } : fallback;\n  }\n\n  // ── bare month+year (\"March 2025\", \"Dec 2024\", \"spring 2025\") or\n  // bare four-digit year (\"2024\") ────────────────────────────────────────\n  // Explicit year is authoritative (never derived from the anchor). Shares\n  // resolveExplicitMonthYear / resolveBareYear with the since/until paths.\n  const explicitMs = resolveExplicitMonthYear(lower) ?? resolveBareYear(lower);\n  if (explicitMs !== null) {\n    const fromIso = toIsoUtc(explicitMs);\n    if (fromIso) return { validFrom: fromIso, ok: true };\n  }\n\n  // ── absolute ISO date / datetime ───────────────────────────────────────\n  const absMs = resolveAbsolute(expr);\n  if (absMs !== null) {\n    const fromIso = toIsoUtc(absMs);\n    return fromIso ? { validFrom: fromIso, ok: true } : fallback;\n  }\n\n  return fallback;\n}\n\n/**\n * Resolve a period token (with optional direction) to a start-of-period ms.\n * Handles month/season names, quarter tokens (`q1`..`q4`), and relative units\n * (`day/week/month/quarter/year`) used by \"last week\", \"this month\", etc.\n */\nfunction resolveRelativePeriod(\n  anchorMs: number,\n  period: string,\n  direction: number = 0,\n): number | null {\n  const lower = period.trim().toLowerCase();\n\n  // Quarter token: \"q1\", \"Q2\", \"quarter 3\"\n  const qTok = lower.match(/^q(?:uarter)?\\s?([1-4])$/);\n  if (qTok) {\n    return resolveQuarter(anchorMs, Number(qTok[1]), direction);\n  }\n  if (lower === \"quarter\") {\n    // \"last quarter\" / \"next quarter\" move the quarter INDEX (with year\n    // wraparound), not just the year — resolveQuarter only nudges the year\n    // for an explicit quarter number, so routing \"last quarter\" through it\n    // returned the current quarter's start (review: bare last/next quarter).\n    const d = new Date(anchorMs);\n    let q = Math.floor(d.getUTCMonth() / 3) + 1;\n    let year = d.getUTCFullYear();\n    if (direction === -1) {\n      q -= 1;\n      if (q < 1) { q = 4; year -= 1; }\n    } else if (direction === +1) {\n      q += 1;\n      if (q > 4) { q = 1; year += 1; }\n    }\n    return buildDateMs(year, QUARTER_START_MONTH[q], 1);\n  }\n\n  // Relative unit: \"week\", \"month\", \"year\", \"day\"\n  if (isRelativeUnit(lower)) {\n    return shiftUnit(anchorMs, lower, direction);\n  }\n\n  // Month or season name\n  const monthMs = resolveMonthYear(anchorMs, lower, direction);\n  if (monthMs !== null) return monthMs;\n  const seasonMs = resolveSeasonYear(anchorMs, lower, direction);\n  if (seasonMs !== null) return seasonMs;\n\n  return null;\n}\n\n/**\n * Resolve an end-bound period to an *exclusive* upper bound ms.  Date-only\n * values convert to start-of-next-day (AGENTS.md §23); period names resolve to\n * the start of the *following* period.\n */\nfunction resolveEndBound(anchorMs: number, period: string): number | null {\n  // Strip an optional \"end of \" prefix so \"until end of March\" resolves the\n  // same as \"until March\".  Review #1578 r2: previously the prefix was passed\n  // unchanged and resolveEndBound returned null for the full phrase.\n  const trimmed = period.trim().replace(/^end\\s+of\\s+/i, \"\").trim();\n\n  // Bare four-digit year: exclusive end = January 1 of the FOLLOWING year.\n  if (/^\\d{4}$/.test(trimmed)) {\n    return buildDateMs(Number(trimmed) + 1, 1, 1);\n  }\n\n  // Absolute date/datetime end bound.\n  const absMs = resolveAbsolute(trimmed);\n  if (absMs !== null) {\n    // Date-only → start of next day (exclusive end).  Datetime → use as-is.\n    if (!/[Tt]/.test(trimmed)) return startOfNextDayUtc(absMs);\n    return absMs;\n  }\n  // Explicit \"<month|season> <year>\" end bound (e.g. \"until March 2025\",\n  // \"through spring 2025\"). The explicit year is authoritative, so the\n  // exclusive end = start of the FOLLOWING month (for a single month) or the\n  // start of the month AFTER the season ends (for a 3-month season).\n  // Review r2: seasons previously advanced only 1 month, cutting off the\n  // last 2 months of the season.\n  const explicitMs = resolveExplicitMonthYear(trimmed);\n  if (explicitMs !== null) {\n    const nd = new Date(explicitMs);\n    const firstWord = trimmed.toLowerCase().split(/\\s+/)[0];\n    const monthAdvance = firstWord in SEASON_TO_MONTH ? 3 : 1;\n    nd.setUTCMonth(nd.getUTCMonth() + monthAdvance);\n    return startOfDayUtc(nd.getTime());\n  }\n\n  // Period-name end bound: month → exclusive end at start of the FOLLOWING\n  // month. \"until <month>\" is backwards-looking (the fact already stopped\n  // being true), so prefer the most recent PAST boundary: build it in the\n  // anchor year and roll back a year if that boundary is still future.\n  const lower = trimmed.toLowerCase();\n  const monthIdx = monthIndex(lower);\n  if (typeof monthIdx === \"number\") {\n    const d = new Date(anchorMs);\n    const startMs = buildDateMs(d.getUTCFullYear(), monthIdx, 1);\n    if (startMs === null) return null;\n    // Exclusive end = start of the month AFTER the named month.\n    const nd = new Date(startMs);\n    nd.setUTCMonth(nd.getUTCMonth() + 1);\n    let endMs = startOfDayUtc(nd.getTime());\n    // Only roll back when the named month boundary is genuinely future\n    // relative to the anchor cycle.  When the anchor IS in the named month,\n    // the end of the current month is the right boundary — do not roll back\n    // (cursor review r2: \"until March\" from mid-March returned the prior year).\n    if (endMs > anchorMs && d.getUTCMonth() + 1 !== monthIdx) {\n      nd.setUTCFullYear(nd.getUTCFullYear() - 1);\n      endMs = startOfDayUtc(nd.getTime());\n    }\n    return endMs;\n  }\n  // Season end bound: advance by the full 3-month season.  Same\n  // backwards-looking rollback logic as month names, but do not roll back\n  // when the anchor is currently inside the season (codex review r2: bare\n  // season end bounds like \"until spring\" / \"through summer\" returned null).\n  const seasonMonth = SEASON_TO_MONTH[lower];\n  if (typeof seasonMonth === \"number\") {\n    const d = new Date(anchorMs);\n    const anchorMonth = d.getUTCMonth() + 1;\n    let year = d.getUTCFullYear();\n    // Winter (Dec) from Jan/Feb: the current winter started in prev Dec,\n    // so build the season start from the previous year (codex review r2:\n    // bare winter end bounds used the anchor year's December, producing\n    // an exclusive end one year too far forward).\n    if (seasonMonth === 12 && anchorMonth <= 2) year -= 1;\n    const startMs = buildDateMs(year, seasonMonth, 1);\n    if (startMs === null) return null;\n    const nd = new Date(startMs);\n    nd.setUTCMonth(nd.getUTCMonth() + 3);\n    let endMs = startOfDayUtc(nd.getTime());\n    if (endMs > anchorMs && !isInSeason(seasonMonth, anchorMonth)) {\n      nd.setUTCFullYear(nd.getUTCFullYear() - 1);\n      endMs = startOfDayUtc(nd.getTime());\n    }\n    return endMs;\n  }\n  if (lower === \"year\") {\n    const d = new Date(anchorMs);\n    return buildDateMs(d.getUTCFullYear() + 1, 1, 1);\n  }\n  return null;\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/explicit-capture.d.ts

@@ -1,5 +1,5 @@
-import { O as Orchestrator } from './orchestrator-m_PnhyHj.js';
-import { M as MemoryCategory, P as PluginConfig } from './types-CJrvHJjx.js';
+import { O as Orchestrator } from './orchestrator-D4ovYV3x.js';
+import { M as MemoryCategory, P as PluginConfig } from './types-Couvz-L3.js';
 import './briefing.js';
 import './storage.js';
 import './page-versioning.js';
@@ -21,7 +21,7 @@ import './session-integrity.js';
 import './summarizer.js';
 import './orchestration/maintenance.js';
 import './namespaces/search.js';
-import './catalog-CAeU0e1C.js';
+import './catalog-CKxilpzS.js';
 import './live-connectors-runner.js';
 import './framework-CNDn2164.js';
 import './relevance.js';
@@ -43,7 +43,7 @@ import './lcm/archive.js';
 import './lcm/summarizer.js';
 import './lcm/dag.js';
 import './lcm/queue.js';
-import './semantic-consolidation-DVBbq6Wr.js';
+import './semantic-consolidation-DyMUCsfN.js';
 import './connectors/codex-materialize.js';
 import './logger.js';
 import './conversation-index/backend.js';

package/dist/extraction-faithfulness.d.ts

@@ -1,4 +1,4 @@
-import { F as FaithfulnessFrontmatter, P as PluginConfig, k as MemoryFrontmatter } from './types-CJrvHJjx.js';
+import { F as FaithfulnessFrontmatter, P as PluginConfig, k as MemoryFrontmatter } from './types-Couvz-L3.js';
 import { LocalLlmClient } from './local-llm.js';
 import { FallbackLlmClient } from './fallback-llm.js';
 import './types-gb_SNtjR.js';

package/dist/extraction-judge-telemetry.d.ts

@@ -1,5 +1,5 @@
 import { JudgeVerdictKind } from './extraction-judge.js';
-import './types-CJrvHJjx.js';
+import './types-Couvz-L3.js';
 import './types-gb_SNtjR.js';
 import './message-parts/index.js';
 import './local-llm.js';

package/dist/extraction-judge-training.d.ts

@@ -1,5 +1,5 @@
 import { JudgeVerdictKind } from './extraction-judge.js';
-import './types-CJrvHJjx.js';
+import './types-Couvz-L3.js';
 import './types-gb_SNtjR.js';
 import './message-parts/index.js';
 import './local-llm.js';

package/dist/extraction-judge.d.ts

@@ -1,4 +1,4 @@
-import { y as ImportanceLevel, P as PluginConfig } from './types-CJrvHJjx.js';
+import { y as ImportanceLevel, P as PluginConfig } from './types-Couvz-L3.js';
 import { LocalLlmClient } from './local-llm.js';
 import { FallbackLlmClient } from './fallback-llm.js';
 import './types-gb_SNtjR.js';

package/dist/extraction.d.ts

@@ -1,6 +1,6 @@
 import { LocalLlmClient } from './local-llm.js';
 import { ContradictionVerificationResult, SuggestedLinks, MemorySummaryResult } from './schemas.js';
-import { P as PluginConfig, G as GatewayConfig, u as BufferTurn, a0 as ExtractionResult, g as MemoryFile, a1 as ConsolidationResult, a2 as DaySummaryResult } from './types-CJrvHJjx.js';
+import { P as PluginConfig, G as GatewayConfig, u as BufferTurn, a0 as ExtractionResult, g as MemoryFile, a1 as ConsolidationResult, a2 as DaySummaryResult } from './types-Couvz-L3.js';
 import { ModelRegistry } from './model-registry.js';
 import { ProfilingCollector } from './profiling.js';
 import './types-gb_SNtjR.js';
@@ -83,6 +83,15 @@ declare class ExtractionEngine {
      * Local LLMs sometimes hit token limits mid-JSON. This tries to salvage valid facts.
      */
     private extractPartialFacts;
+    /**
+     * Bi-temporal event-time extraction instruction (#1578 PR2). Emitted on
+     * every extraction entry path when `temporal.biTemporal` is on so the LLM
+     * emits an optional per-fact `eventTime` expression. The expression is
+     * resolved against the source turn timestamp at write time — never
+     * wall-clock — so replay/import of old transcripts anchors correctly.
+     * Returns an empty string when the gate is off (byte-identical prompt).
+     */
+    private eventTimePromptInstruction;
     /**
      * Build extraction instructions shared between local and cloud LLM.
      */

package/dist/extraction.js

@@ -1,8 +1,8 @@
 import {
   ExtractionEngine
-} from "./chunk-IFR23TC5.js";
+} from "./chunk-VYZNWH4J.js";
 import "./chunk-4RA3C3EV.js";
-import "./chunk-KKK7YTYN.js";
+import "./chunk-5GSUBCZM.js";
 import "./chunk-54V4BZWP.js";
 import "./chunk-PWFWCGOO.js";
 import "./chunk-24D66MMN.js";

package/dist/fallback-llm.d.ts

@@ -1,4 +1,4 @@
-import { G as GatewayConfig, f as AgentPersonaModelConfig, P as PluginConfig } from './types-CJrvHJjx.js';
+import { G as GatewayConfig, f as AgentPersonaModelConfig, P as PluginConfig } from './types-Couvz-L3.js';
 import { GetRuntimeAuthForModelFn, ResolveApiKeyFn } from './resolve-provider-secret.js';
 import './types-gb_SNtjR.js';
 import './message-parts/index.js';

package/dist/{forget-6SOIPUMQ.js → forget-U66KPDPY.js}

@@ -3,8 +3,8 @@ import {
 } from "./chunk-3JJWNZTT.js";
 import {
   supersessionKeysForFact
-} from "./chunk-OMNTQPZO.js";
-import "./chunk-IREVVFTM.js";
+} from "./chunk-TKZ3AL5V.js";
+import "./chunk-6CIAGZ6X.js";
 import "./chunk-LTJAMRGI.js";
 import "./chunk-NU3CSQ4H.js";
 import "./chunk-PZ5AY32C.js";
@@ -97,4 +97,4 @@ export {
   ForgetMemoryNotFoundError,
   forgetMemory
 };
-//# sourceMappingURL=forget-6SOIPUMQ.js.map
+//# sourceMappingURL=forget-U66KPDPY.js.map

package/dist/identity-continuity.d.ts

@@ -1,4 +1,4 @@
-import { a3 as ContinuityIncidentRecord, a4 as ContinuityIncidentCloseInput, a5 as ContinuityIncidentOpenInput, a6 as ContinuityImprovementLoop, a7 as ContinuityLoopReviewInput, a8 as ContinuityLoopUpsertInput } from './types-CJrvHJjx.js';
+import { a3 as ContinuityIncidentRecord, a4 as ContinuityIncidentCloseInput, a5 as ContinuityIncidentOpenInput, a6 as ContinuityImprovementLoop, a7 as ContinuityLoopReviewInput, a8 as ContinuityLoopUpsertInput } from './types-Couvz-L3.js';
 import './types-gb_SNtjR.js';
 import './message-parts/index.js';
 

package/dist/importance.d.ts

@@ -1,4 +1,4 @@
-import { y as ImportanceLevel, g as MemoryFile, a9 as ImportanceScore, M as MemoryCategory } from './types-CJrvHJjx.js';
+import { y as ImportanceLevel, g as MemoryFile, a9 as ImportanceScore, M as MemoryCategory } from './types-Couvz-L3.js';
 import './types-gb_SNtjR.js';
 import './message-parts/index.js';