@remnic/core 9.69.33 → 9.69.35

package/dist/maintenance/rebuild-memory-lifecycle-ledger.js

@@ -2,36 +2,37 @@ import {
   backupExistingLedger,
   boundLifecycleEventsToByteCap,
   rebuildMemoryLifecycleLedger
-} from "../chunk-KCB7F4J7.js";
+} from "../chunk-QURNMKME.js";
 import "../chunk-KJTKLXTH.js";
-import "../chunk-HV7OY4DM.js";
-import "../chunk-UHVXE24Y.js";
+import "../chunk-5VAF4ID4.js";
 import "../chunk-46WM6JX2.js";
+import "../chunk-UHVXE24Y.js";
 import "../chunk-D5F7TKMH.js";
-import "../chunk-J7HFPA6O.js";
-import "../chunk-TCUKRAMK.js";
+import "../chunk-Y63ZFP4X.js";
+import "../chunk-JRWW7GM6.js";
+import "../chunk-CYEPCZN5.js";
+import "../chunk-TNSCIPBQ.js";
 import "../chunk-YQNNHLCG.js";
 import "../chunk-6KTXE6A3.js";
 import "../chunk-BD7JTBYP.js";
 import "../chunk-OB3XMWX5.js";
-import "../chunk-CYEPCZN5.js";
-import "../chunk-TNSCIPBQ.js";
 import "../chunk-4O6WRBGE.js";
 import "../chunk-GUMZC2BO.js";
-import "../chunk-227UFSEQ.js";
-import "../chunk-ET356KSB.js";
+import "../chunk-TFA6HPOA.js";
+import "../chunk-F4TWWUMP.js";
 import "../chunk-72A4L5JJ.js";
 import "../chunk-A7Q43EUZ.js";
 import "../chunk-S2V7RUCL.js";
-import "../chunk-SO7SV523.js";
+import "../chunk-PCEYGOSL.js";
+import "../chunk-4MDKNUV4.js";
+import "../chunk-S2HLHAZ4.js";
 import "../chunk-SCU65EZI.js";
 import "../chunk-MRPOZBJC.js";
-import "../chunk-S2HLHAZ4.js";
 import "../chunk-DM2T26WE.js";
 import "../chunk-LDXUBPMO.js";
-import "../chunk-DCJ3YFIC.js";
+import "../chunk-S2ULTQZR.js";
 import "../chunk-AAD2ZS6P.js";
-import "../chunk-H272ZPQ3.js";
+import "../chunk-SHEHQBCG.js";
 import "../chunk-3ONXXHQO.js";
 import "../chunk-YXZG5TVN.js";
 import "../chunk-5GINB5LC.js";
@@ -43,24 +44,21 @@ import "../chunk-RBOJCG4T.js";
 import "../chunk-R7QY5ZVB.js";
 import "../chunk-5WITETWU.js";
 import "../chunk-6CIAGZ6X.js";
-import "../chunk-DBQWVT2H.js";
+import "../chunk-3CBI2ZSA.js";
 import "../chunk-JXN77SGO.js";
 import "../chunk-ZLQ37WJX.js";
 import "../chunk-IUM3VSHI.js";
-import "../chunk-3QQTXYZ6.js";
-import "../chunk-BT7NVCML.js";
 import "../chunk-C64XATK7.js";
 import "../chunk-42JKGUFJ.js";
-import "../chunk-TLPZ6MKZ.js";
+import "../chunk-YEN4TREG.js";
 import "../chunk-I55KAVET.js";
 import "../chunk-L2EXJQJP.js";
 import "../chunk-45GF7Y3V.js";
-import "../chunk-RGMVMVMF.js";
-import "../chunk-N7RWREIQ.js";
+import "../chunk-65RENJGB.js";
 import "../chunk-353KGBKY.js";
 import "../chunk-ZIKENA2C.js";
-import "../chunk-VYCOJKSX.js";
 import "../chunk-6Q3ZTEF6.js";
+import "../chunk-RGMVMVMF.js";
 import "../chunk-W5BIQOAJ.js";
 import "../chunk-Z7L72ZHL.js";
 import "../chunk-4O4TKIXQ.js";
@@ -75,20 +73,23 @@ import "../chunk-RL6NEVXT.js";
 import "../chunk-AW4QUFQF.js";
 import "../chunk-C7HJ3NEI.js";
 import "../chunk-7RJUVTVF.js";
+import "../chunk-PWPIERBM.js";
+import "../chunk-BJMBJZ2Y.js";
+import "../chunk-UKJAGEXH.js";
+import "../chunk-FP2373TW.js";
+import "../chunk-LSLCFCCQ.js";
+import "../chunk-BT7NVCML.js";
+import "../chunk-VYCOJKSX.js";
 import "../chunk-NB3LRY4T.js";
 import "../chunk-5FVVY2EB.js";
 import "../chunk-FFAZ2XFU.js";
-import "../chunk-EEOUMG3J.js";
 import "../chunk-JDSVLVCG.js";
 import "../chunk-5GKPFL3S.js";
 import "../chunk-JAKIDQB2.js";
-import "../chunk-BJMBJZ2Y.js";
-import "../chunk-UKJAGEXH.js";
-import "../chunk-FP2373TW.js";
 import "../chunk-P7FMDTKL.js";
 import "../chunk-VUFL7X3H.js";
 import "../chunk-JUOZ62Y7.js";
-import "../chunk-O75CRYGF.js";
+import "../chunk-ZEFVK7XC.js";
 import "../chunk-6KH5NLQS.js";
 import "../chunk-P2QRMMVQ.js";
 import "../chunk-BTTPKDIL.js";

package/dist/maintenance/rebuild-memory-projection.d.ts

@@ -1,15 +1,17 @@
-import { S as StorageManager } from '../storage-BBLLuVTF.js';
-import '../types-igV4-sbB.js';
+import { S as StorageManager } from '../storage-Ca0MbTfm.js';
+import '../types-yDgWDkrJ.js';
 import '../message-parts/index.js';
 import '../bounded-jsonl-state.js';
 import '../operator-doctor-types.js';
 import '../external-wiki-config.js';
+import '../recall-state-view.js';
 import '../contradiction-config.js';
 import '../graph-path-scoring-config.js';
 import '../deep-recall-config.js';
 import '../causal-trajectory.js';
 import '../objective-state.js';
 import '../active-context-config.js';
+import '../local-llm-config.js';
 import '../semantic-merge-config.js';
 import '../types-continuity.js';
 import '../corpus-read-cancellation.js';

package/dist/maintenance/rebuild-memory-projection.js

@@ -3,38 +3,39 @@ import {
   rebuildMemoryProjection,
   repairMemoryProjection,
   verifyMemoryProjection
-} from "../chunk-NB5BCFUY.js";
+} from "../chunk-WHHEPAO3.js";
 import "../chunk-KJTKLXTH.js";
 import "../chunk-2DQ2XREU.js";
-import "../chunk-EQHDH4C2.js";
-import "../chunk-HV7OY4DM.js";
-import "../chunk-UHVXE24Y.js";
+import "../chunk-HUT2JR6I.js";
+import "../chunk-5VAF4ID4.js";
 import "../chunk-46WM6JX2.js";
+import "../chunk-UHVXE24Y.js";
 import "../chunk-D5F7TKMH.js";
-import "../chunk-J7HFPA6O.js";
-import "../chunk-TCUKRAMK.js";
+import "../chunk-Y63ZFP4X.js";
+import "../chunk-JRWW7GM6.js";
+import "../chunk-CYEPCZN5.js";
+import "../chunk-TNSCIPBQ.js";
 import "../chunk-YQNNHLCG.js";
 import "../chunk-6KTXE6A3.js";
 import "../chunk-BD7JTBYP.js";
 import "../chunk-OB3XMWX5.js";
-import "../chunk-CYEPCZN5.js";
-import "../chunk-TNSCIPBQ.js";
 import "../chunk-4O6WRBGE.js";
 import "../chunk-GUMZC2BO.js";
-import "../chunk-227UFSEQ.js";
-import "../chunk-ET356KSB.js";
+import "../chunk-TFA6HPOA.js";
+import "../chunk-F4TWWUMP.js";
 import "../chunk-72A4L5JJ.js";
 import "../chunk-A7Q43EUZ.js";
 import "../chunk-S2V7RUCL.js";
-import "../chunk-SO7SV523.js";
+import "../chunk-PCEYGOSL.js";
+import "../chunk-4MDKNUV4.js";
+import "../chunk-S2HLHAZ4.js";
 import "../chunk-SCU65EZI.js";
 import "../chunk-MRPOZBJC.js";
-import "../chunk-S2HLHAZ4.js";
 import "../chunk-DM2T26WE.js";
 import "../chunk-LDXUBPMO.js";
-import "../chunk-DCJ3YFIC.js";
+import "../chunk-S2ULTQZR.js";
 import "../chunk-AAD2ZS6P.js";
-import "../chunk-H272ZPQ3.js";
+import "../chunk-SHEHQBCG.js";
 import "../chunk-3ONXXHQO.js";
 import "../chunk-YXZG5TVN.js";
 import "../chunk-5GINB5LC.js";
@@ -46,24 +47,21 @@ import "../chunk-RBOJCG4T.js";
 import "../chunk-R7QY5ZVB.js";
 import "../chunk-5WITETWU.js";
 import "../chunk-6CIAGZ6X.js";
-import "../chunk-DBQWVT2H.js";
+import "../chunk-3CBI2ZSA.js";
 import "../chunk-JXN77SGO.js";
 import "../chunk-ZLQ37WJX.js";
 import "../chunk-IUM3VSHI.js";
-import "../chunk-3QQTXYZ6.js";
-import "../chunk-BT7NVCML.js";
 import "../chunk-C64XATK7.js";
 import "../chunk-42JKGUFJ.js";
-import "../chunk-TLPZ6MKZ.js";
+import "../chunk-YEN4TREG.js";
 import "../chunk-I55KAVET.js";
 import "../chunk-L2EXJQJP.js";
 import "../chunk-45GF7Y3V.js";
-import "../chunk-RGMVMVMF.js";
-import "../chunk-N7RWREIQ.js";
+import "../chunk-65RENJGB.js";
 import "../chunk-353KGBKY.js";
 import "../chunk-ZIKENA2C.js";
-import "../chunk-VYCOJKSX.js";
 import "../chunk-6Q3ZTEF6.js";
+import "../chunk-RGMVMVMF.js";
 import "../chunk-W5BIQOAJ.js";
 import "../chunk-Z7L72ZHL.js";
 import "../chunk-4O4TKIXQ.js";
@@ -79,20 +77,23 @@ import "../chunk-RL6NEVXT.js";
 import "../chunk-AW4QUFQF.js";
 import "../chunk-C7HJ3NEI.js";
 import "../chunk-7RJUVTVF.js";
+import "../chunk-PWPIERBM.js";
+import "../chunk-BJMBJZ2Y.js";
+import "../chunk-UKJAGEXH.js";
+import "../chunk-FP2373TW.js";
+import "../chunk-LSLCFCCQ.js";
+import "../chunk-BT7NVCML.js";
+import "../chunk-VYCOJKSX.js";
 import "../chunk-NB3LRY4T.js";
 import "../chunk-5FVVY2EB.js";
 import "../chunk-FFAZ2XFU.js";
-import "../chunk-EEOUMG3J.js";
 import "../chunk-JDSVLVCG.js";
 import "../chunk-5GKPFL3S.js";
 import "../chunk-JAKIDQB2.js";
-import "../chunk-BJMBJZ2Y.js";
-import "../chunk-UKJAGEXH.js";
-import "../chunk-FP2373TW.js";
 import "../chunk-P7FMDTKL.js";
 import "../chunk-VUFL7X3H.js";
 import "../chunk-JUOZ62Y7.js";
-import "../chunk-O75CRYGF.js";
+import "../chunk-ZEFVK7XC.js";
 import "../chunk-6KH5NLQS.js";
 import "../chunk-P2QRMMVQ.js";
 import "../chunk-BTTPKDIL.js";

package/dist/{maintenance-DCvQGTzL.d.ts → maintenance-ag1gYztC.d.ts}

@@ -1,7 +1,7 @@
-import { a8 as ActivitySnapshot, aQ as ActivityConfig, aR as ActivitySourceConfig, aS as ActivitySourceClient, P as PluginConfig } from './types-igV4-sbB.js';
+import { a8 as ActivitySnapshot, aQ as ActivityTimelineAnalysisConfig, P as PluginConfig, aR as ActivityConfig, aS as ActivitySourceConfig, aT as ActivitySourceClient } from './types-yDgWDkrJ.js';
 import { SearchBackend } from './search/port.js';
-import { S as StorageManager } from './storage-BBLLuVTF.js';
-import { a as NamespaceCatalog } from './catalog-8O9KY9eA.js';
+import { S as StorageManager } from './storage-Ca0MbTfm.js';
+import { a as NamespaceCatalog } from './catalog-Bq1AxZwF.js';
 import { NamespaceSearchRouter } from './namespaces/search.js';
 import { BetterSqlite3Database } from './runtime/better-sqlite.js';
 
@@ -46,9 +46,379 @@ declare class ActivityStore {
     searchSnapshots(query: string, limit: number): ActivitySnapshot[];
     /** Retention: drop snapshots captured strictly before `cutoffUtc`. */
     pruneOlderThan(cutoffUtc: string): number;
+    /**
+     * First and last stored capture instants (canonical UTC strings), or null
+     * when no snapshots exist. Backs the unbounded timeline search window.
+     */
+    snapshotCaptureExtent(): {
+        firstUtc: string;
+        lastUtc: string;
+    } | null;
     close(): void;
 }
 
+/**
+ * Typed failure classification for timeline analysis (issue #2050).
+ *
+ * Unknown kinds fail closed with a TypeError. Pure: no I/O, no clock, no randomness.
+ */
+declare const ANALYSIS_FAILURE_KINDS: readonly ["provider_unavailable", "timeout", "aborted", "rate_limited", "malformed_json", "invalid_schema", "partial_output", "invalid_config"];
+type AnalysisFailureKind = (typeof ANALYSIS_FAILURE_KINDS)[number];
+interface AnalysisFailure {
+    kind: AnalysisFailureKind;
+    /** True only when retrying the same request could plausibly succeed. */
+    retryable: boolean;
+    /** True when the deterministic cards must be preserved unchanged. */
+    preservesDeterministic: true;
+}
+/** True when the value is one of the known failure kinds. */
+declare function isAnalysisFailureKind(value: unknown): value is AnalysisFailureKind;
+/** Classify a failure kind. Unknown kinds throw; there is no permissive default. */
+declare function classifyAnalysisFailure(kind: string): AnalysisFailure;
+
+/**
+ * Timeline-card layer over the #1899 activity store (issue #2049).
+ *
+ * A card is a deterministic, replayable *derived view*: it references snapshot
+ * evidence by store row id and content identity, never copying or re-storing
+ * it. All intervals are half-open [start, end) UTC; day bucketing reuses the
+ * DST-aware `activityDayWindow` from the digest layer, so timeline days and
+ * digests always agree on day bounds.
+ */
+/** Reference to one stored observation (subset of ActivitySnapshot; no text). */
+interface TimelineObservation {
+    /** Store row id of the referenced snapshot. */
+    id: number;
+    machine: string;
+    /** UTC ISO-8601 capture instant. */
+    capturedAtUtc: string;
+    app: string;
+    windowTitle: string;
+    /** Browser tab URL, when the frontmost window is a known browser. */
+    browserUrl?: string;
+    /** Content hash of the referenced snapshot (identity, not re-stored text). */
+    contentHash: string;
+}
+/** User-declared pause, half-open [startUtc, endUtc) in UTC. Not idle. */
+interface TimelinePause {
+    startUtc: string;
+    endUtc: string;
+    /** Free-form reason, kept verbatim on the derived pause card. */
+    reason?: string;
+}
+/** One category definition in the registry. */
+interface TimelineCategory {
+    /** Stable ID (`system.*` is the reserved namespace). */
+    id: string;
+    name: string;
+    /** Hex color, `#RRGGBB`. */
+    color: string;
+    description: string;
+    /** Presentation order; equal orders tie-break by id. */
+    order: number;
+    /** Reserved system category (idle / pause / unknown). */
+    system?: boolean;
+    /** Marks the reserved idle category. */
+    idle?: boolean;
+}
+type TimelineCardKind = "activity" | "idle" | "pause";
+/** Provenance stamped on a card when a manual correction was applied. */
+interface TimelineManualEdit {
+    categoryId?: string;
+    title?: string;
+    editedAtUtc: string;
+}
+/** A persisted manual correction; keyed by stable card id, survives rebuilds. */
+interface TimelineCorrection {
+    cardId: string;
+    categoryId?: string;
+    title?: string;
+    editedAtUtc: string;
+}
+/** Stable first/last evidence identity keys bracketing a card's sources. */
+interface TimelineEvidenceRange {
+    firstKey: string;
+    lastKey: string;
+}
+interface TimelineCard {
+    /** Stable content-derived id (never array position or wall-clock). */
+    id: string;
+    kind: TimelineCardKind;
+    title: string;
+    summary: string;
+    categoryId: string;
+    /** Classification confidence; manual corrections set it to 1. */
+    confidence: number;
+    /** Half-open [startUtc, endUtc) UTC bounds. */
+    startUtc: string;
+    endUtc: string;
+    /** Local day key (YYYY-MM-DD) this card belongs to. */
+    dayKey: string;
+    timezone: string;
+    /** Track the card was built on; null for machine-less pause cards. */
+    machine: string | null;
+    /** Store row ids of the source snapshots (empty for idle/pause). */
+    evidenceIds: number[];
+    /** First/last evidence identity keys (null for idle/pause). */
+    evidenceRange: TimelineEvidenceRange | null;
+    /** Present only when a manual correction was applied. */
+    manualEdit?: TimelineManualEdit;
+}
+/** One replayable local day of cards. */
+interface TimelineDay {
+    formatVersion: number;
+    date: string;
+    timezone: string;
+    startUtc: string;
+    endUtc: string;
+    cards: TimelineCard[];
+}
+
+/**
+ * Optional evidence-bound AI analysis over deterministic timeline cards
+ * (issue #2050). Provider calls arrive through the injected `complete`
+ * function; hosts build it from the local/remote seams in analysis-provider.js
+ * and the parsed `activity.timeline.analysis` config. Failures leave the
+ * cards unchanged and carry a typed failure kind. Disabled makes zero
+ * provider calls.
+ */
+
+declare const TIMELINE_ANALYSIS_PROMPT_VERSION = 1;
+declare const TIMELINE_ANALYSIS_BATCH_SIZE = 40;
+declare const TIMELINE_ANALYSIS_BATCH_OVERLAP = 2;
+declare const TIMELINE_ANALYSIS_DEFAULT_TIMEOUT_MS = 15000;
+declare class TimelineAnalysisConfigError extends Error {
+    readonly name = "TimelineAnalysisConfigError";
+    readonly code: "invalid_config";
+    constructor(message: string);
+}
+type TimelineAnalysisStatus = "ok" | "disabled" | "provider_failed" | "invalid_output";
+interface TimelineAnalysisCompleteInput {
+    prompt: string;
+    provider: string;
+    model: string;
+    signal: AbortSignal;
+}
+type TimelineAnalysisComplete = (input: TimelineAnalysisCompleteInput) => Promise<string>;
+interface TimelineAnalysisInput {
+    enabled: boolean;
+    cards: readonly TimelineCard[];
+    observations: readonly TimelineObservation[];
+    provider?: string;
+    model?: string;
+    complete?: TimelineAnalysisComplete;
+    timeoutMs?: number;
+    date?: string;
+    timezone?: string;
+    categories?: readonly TimelineCategory[];
+    preferences?: readonly string[];
+    priorEdits?: readonly TimelineCorrection[];
+    signal?: AbortSignal;
+}
+interface TimelineAnalysisResult {
+    status: TimelineAnalysisStatus;
+    cards: TimelineCard[];
+    provider?: string;
+    model?: string;
+    promptVersion?: number;
+    /** Typed failure detail; present only when status is a failure. */
+    failure?: AnalysisFailure;
+}
+declare function buildTimelineAnalysisPrompt(input: {
+    date?: string;
+    timezone?: string;
+    cards: readonly TimelineCard[];
+    observations: readonly TimelineObservation[];
+    categories: readonly TimelineCategory[];
+    preferences?: readonly string[];
+    priorEdits?: readonly TimelineCorrection[];
+}): string;
+/** Analyze one day of cards. Failures return the input cards unchanged. */
+declare function analyzeTimelineCards(input: TimelineAnalysisInput): Promise<TimelineAnalysisResult>;
+
+/**
+ * Provider-neutral completion adapter for timeline analysis (issue #2050).
+ *
+ * Routes the analysis prompt through the existing LLM contracts — the local
+ * client (`provider: "local"`) or the gateway fallback client pinned to the
+ * ONE explicitly configured remote provider/model. An invalid or missing
+ * explicit provider surfaces as a typed failure; there is no chain fallback,
+ * so a bad config can never silently answer from a different provider.
+ *
+ * Structural seams (not concrete classes) so hosts and tests inject fakes.
+ * Never logs prompt or response content.
+ */
+
+/** Structural slice of LocalLlmClient.chatCompletion (local seam). */
+interface TimelineAnalysisLocalLlm {
+    chatCompletion(messages: Array<{
+        role: "system" | "user";
+        content: string;
+    }>, options: {
+        temperature?: number;
+        maxTokens?: number;
+        responseFormat?: {
+            type: string;
+        };
+        signal?: AbortSignal;
+        operation?: string;
+        redactProviderErrors?: boolean;
+        model?: string;
+    }): Promise<{
+        content: string;
+    } | null>;
+}
+/** Structural slice of FallbackLlmClient.chatCompletion (remote seam). */
+interface TimelineAnalysisRemoteLlm {
+    chatCompletion(messages: Array<{
+        role: "system" | "user" | "assistant";
+        content: string;
+    }>, options: {
+        temperature?: number;
+        maxTokens?: number;
+        signal?: AbortSignal;
+        modelChain?: {
+            primary?: string;
+            fallbacks?: string[];
+        };
+        includeDefaultModelFallback?: boolean;
+        redactProviderErrors?: boolean;
+    }): Promise<{
+        content: string;
+    } | null>;
+}
+/** Marker base for provider errors the analysis run classifies by kind. */
+declare class TimelineAnalysisProviderError extends Error {
+    readonly kind: AnalysisFailureKind;
+    readonly name = "TimelineAnalysisProviderError";
+    constructor(kind: AnalysisFailureKind, message: string);
+}
+/** The provider id that routes to the local LLM client. */
+declare const TIMELINE_ANALYSIS_LOCAL_PROVIDER_ID = "local";
+/**
+ * Map a thrown provider error onto the typed failure kinds. Name- and
+ * status-based only: the message is matched, never logged, so provider error
+ * text cannot become a log line.
+ */
+declare function classifyAnalysisProviderError(error: unknown): AnalysisFailureKind;
+/**
+ * Build the `complete` function `analyzeTimelineCards` calls, from the local
+ * and remote client seams. Selection is by the explicit provider id carried
+ * on each call: `"local"` uses the local client; anything else is a remote
+ * provider id pinned as the single-model chain (no default-chain fallback is
+ * ever appended).
+ */
+declare function timelineAnalysisCompleteFromClients(input: {
+    localLlm: TimelineAnalysisLocalLlm | null;
+    remoteLlm: TimelineAnalysisRemoteLlm | null;
+}): TimelineAnalysisComplete;
+
+/**
+ * Analysis run metadata (issue #2050).
+ *
+ * Pure builder for the provider/model/prompt-version record attached to
+ * stored analysis results and telemetry.
+ *
+ * The no-content guarantee is enforced by SHAPE, not by length: each field
+ * must match an identifier/version syntax, so prose cannot be stored as a
+ * "model name". A 200-character single-line string is happily prose
+ * ("Summarize this user\u0027s activity"), which is why a length cap alone was
+ * not the boundary this record needs. Errors never echo a rejected value,
+ * so a mis-passed prompt cannot reach logs through the failure path either.
+ */
+interface AnalysisRunMetadata {
+    provider: string;
+    model: string;
+    promptVersion: string;
+    /** Observation ids the run consumed, for evidence tracing. */
+    observationCount: number;
+}
+declare const ANALYSIS_METADATA_MAX_FIELD_LENGTH = 120;
+/** True when value is an identifier-safe provider/model/promptVersion string. */
+declare const isAnalysisIdentifier: (value: string) => boolean;
+declare function buildAnalysisRunMetadata(input: {
+    provider: string;
+    model: string;
+    promptVersion: string;
+    observationCount: number;
+}): AnalysisRunMetadata;
+
+declare const TIMELINE_DAY_FORMAT_VERSION = 1;
+declare const TIMELINE_DAY_DIR: string;
+interface TimelineAnalysisClients {
+    localLlm?: TimelineAnalysisLocalLlm | null;
+    remoteLlm?: TimelineAnalysisRemoteLlm | null;
+}
+interface RegenerateTimelineDayInput {
+    date: string;
+    timezone: string;
+    memoryDir: string;
+    store: {
+        listSnapshotsForDay: (machine: string | null, startUtc: string, endUtc: string) => ActivitySnapshot[];
+    };
+    timelineEnabled: boolean;
+    analysis: ActivityTimelineAnalysisConfig;
+    deps?: TimelineAnalysisClients;
+    pluginConfig?: PluginConfig;
+    signal?: AbortSignal;
+    corrections?: readonly TimelineCorrection[];
+}
+/**
+ * Persisted day status. "pending" is the prewrite marker for an enabled run
+ * whose analysis has not completed: a crash after the deterministic prewrite
+ * must not read as terminal on the next run.
+ */
+type PersistedTimelineDayStatus = TimelineAnalysisStatus | "pending" | "timeline_disabled";
+interface PersistedTimelineDay {
+    formatVersion: number;
+    date: string;
+    timezone: string;
+    sourceHash: string;
+    status: PersistedTimelineDayStatus;
+    cards: TimelineCard[];
+    metadata?: AnalysisRunMetadata;
+    failure?: AnalysisFailure;
+}
+interface RegenerateTimelineDayResult {
+    status: PersistedTimelineDayStatus;
+    cards: TimelineCard[];
+    path: string;
+    written: boolean;
+    analyzed: boolean;
+    metadata?: AnalysisRunMetadata;
+    failure?: AnalysisFailure;
+}
+declare function timelineDayPath(memoryDir: string, date: string): string;
+declare function snapshotToObservation(snapshot: ActivitySnapshot): TimelineObservation | null;
+/** Local calendar days covering [fromMs, toMs), oldest first. Capped at 3660 days. */
+declare function localDatesForUtcRange(fromMs: number, toMs: number, timezone: string): string[];
+/** Persisted local days already on disk (YYYY-MM-DD), regardless of store state. */
+declare function listPersistedTimelineDates(memoryDir: string): string[];
+/**
+ * Local days a CLI window must load. Bounded windows keep the explicit
+ * from/to span. An unbounded search loads every day the snapshot store or a
+ * persisted day file covers (plus today), so historical cards enter the
+ * search pool instead of only the current day.
+ */
+declare function resolveTimelineLoadDates(input: {
+    window: {
+        from?: string;
+        to?: string;
+    };
+    timezone: string;
+    today: string;
+    store: {
+        snapshotCaptureExtent(): {
+            firstUtc: string;
+            lastUtc: string;
+        } | null;
+    };
+    persistedDates: readonly string[];
+}): string[];
+declare function timelineAnalysisClientsFromConfig(config: PluginConfig): TimelineAnalysisClients;
+/** Build, optionally analyze once, and persist one local day of timeline cards. */
+declare function regenerateTimelineDay(input: RegenerateTimelineDayInput): Promise<RegenerateTimelineDayResult>;
+
 /**
  * Host-agnostic activity sync runner (issue #1900).
  *
@@ -127,6 +497,10 @@ interface ActivitySyncRunOptions {
      * Host wires the core index seam (SearchBackend.update); best-effort.
      */
     reindexSearch?: (signal?: AbortSignal) => Promise<void>;
+    /** Full plugin config so regenerate can construct local/remote LLM clients. */
+    pluginConfig?: PluginConfig;
+    /** Injected analysis clients; tests and hosts that already own them. */
+    analysisDeps?: TimelineAnalysisClients;
 }
 /**
  * The local-day window to sync, oldest first: today back `syncDays` calendar
@@ -365,4 +739,4 @@ declare class MaintenanceScheduler {
     dispose(): Promise<void>;
 }
 
-export { ActivityStore as A, MaintenanceScheduler as M, type ActivitySyncRunSummary as a, type ActivitySourceRunItem as b, type ActivitySyncRunOptions as c, activityDatabasePath as d, applyActivitySchema as e, ensureActivityStateDir as f, runActivitySyncOnce as g, type MaintenanceSchedulerDeps as h, openActivityDatabase as o, resolveActivitySyncDates as r };
+export { regenerateTimelineDay as $, ActivityStore as A, type TimelineAnalysisComplete as B, type TimelineAnalysisCompleteInput as C, TimelineAnalysisConfigError as D, type TimelineAnalysisInput as E, TimelineAnalysisProviderError as F, type TimelineAnalysisResult as G, type TimelineCardKind as H, type TimelineEvidenceRange as I, type TimelineManualEdit as J, activityDatabasePath as K, analyzeTimelineCards as L, MaintenanceScheduler as M, applyActivitySchema as N, buildAnalysisRunMetadata as O, type PersistedTimelineDay as P, buildTimelineAnalysisPrompt as Q, type RegenerateTimelineDayInput as R, classifyAnalysisFailure as S, type TimelineCategory as T, classifyAnalysisProviderError as U, ensureActivityStateDir as V, isAnalysisFailureKind as W, isAnalysisIdentifier as X, listPersistedTimelineDates as Y, localDatesForUtcRange as Z, openActivityDatabase as _, type ActivitySyncRunSummary as a, resolveActivitySyncDates as a0, resolveTimelineLoadDates as a1, runActivitySyncOnce as a2, snapshotToObservation as a3, timelineAnalysisClientsFromConfig as a4, timelineAnalysisCompleteFromClients as a5, timelineDayPath as a6, type MaintenanceSchedulerDeps as a7, type TimelineObservation as b, type TimelinePause as c, type TimelineDay as d, type TimelineCorrection as e, type TimelineCard as f, type TimelineAnalysisLocalLlm as g, type TimelineAnalysisRemoteLlm as h, type TimelineAnalysisStatus as i, type AnalysisFailure as j, type AnalysisRunMetadata as k, ANALYSIS_FAILURE_KINDS as l, ANALYSIS_METADATA_MAX_FIELD_LENGTH as m, type ActivitySourceRunItem as n, type ActivitySyncRunOptions as o, type AnalysisFailureKind as p, type PersistedTimelineDayStatus as q, type RegenerateTimelineDayResult as r, TIMELINE_ANALYSIS_BATCH_OVERLAP as s, TIMELINE_ANALYSIS_BATCH_SIZE as t, TIMELINE_ANALYSIS_DEFAULT_TIMEOUT_MS as u, TIMELINE_ANALYSIS_LOCAL_PROVIDER_ID as v, TIMELINE_ANALYSIS_PROMPT_VERSION as w, TIMELINE_DAY_DIR as x, TIMELINE_DAY_FORMAT_VERSION as y, type TimelineAnalysisClients as z };