@remnic/core 9.15.3 → 9.16.0

package/dist/{types-2q_MRFcM.d.ts → types-OUCJALBK.d.ts}

@@ -84,6 +84,102 @@ declare function isImportRole(value: unknown): value is ImportSourceRole;
 declare function parseIsoTimestamp(value: string): number | null;
 declare function validateImportTurn(turn: ImportTurn, index?: number): ImportTurnValidationIssue[];
 
+/**
+ * Screen-activity subsystem — shared types (issue #1899).
+ *
+ * A third ingestion modality alongside wearables (conversations) and live
+ * connectors (documents). Screen text has no speakers and is high-volume, so it
+ * gets its own store and day-digest rather than being forced into the wearable
+ * conversation shape. Capture daemons live in the à-la-carte `@remnic/capture-screen`
+ * package; this core subsystem is host-agnostic and consumes snapshots over a
+ * loopback HTTP client.
+ *
+ * All timestamps are UTC ISO-8601; day bucketing is half-open [start, end).
+ */
+/** One captured on-screen text snapshot (a single window at a single instant). */
+interface ActivitySnapshot {
+    /** Store row id (assigned on insert; absent before persistence). */
+    id?: number;
+    /** Capture-machine label (disambiguates multi-machine stores). */
+    machine: string;
+    /** UTC ISO-8601 capture instant. */
+    capturedAtUtc: string;
+    /** Frontmost application name. */
+    app: string;
+    /** Frontmost window title. */
+    windowTitle: string;
+    /** Browser tab URL, when the frontmost window is a known browser. */
+    browserUrl?: string;
+    /** Extracted visible text (accessibility tree or OCR). */
+    text: string;
+    /** Where the text came from. */
+    textSource: "ax" | "ocr";
+    /** SHA-256 of the normalized snapshot content (idempotency key). */
+    contentHash: string;
+    /** 64-bit SimHash (hex) for near-duplicate detection, when computed. */
+    simhash?: string;
+}
+/** Frontmatter persisted on a rendered day digest. */
+interface ActivityDayMeta {
+    kind: "activity-digest";
+    /** Local day, YYYY-MM-DD. */
+    date: string;
+    /** Machines that contributed snapshots, sorted. */
+    machines: string[];
+    snapshotCount: number;
+    /** SHA-256 of the rendered body (rebuild-idempotency). */
+    contentHash: string;
+    formatVersion: number;
+}
+/** A parsed day digest (frontmatter + rendered body). */
+interface ActivityDayDigest {
+    meta: ActivityDayMeta;
+    body: string;
+}
+/** Result of a capture-daemon auth/health probe. */
+interface ActivitySourceCheck {
+    ok: boolean;
+    detail?: string;
+}
+/** One page of snapshots pulled from a capture daemon. */
+interface ActivitySnapshotPage {
+    snapshots: ActivitySnapshot[];
+    nextCursor: string | null;
+}
+/**
+ * Client contract for a screen-capture daemon (one per capture machine).
+ * Implemented by a later slice (the HTTP source client); defined here so the
+ * store and pipeline can be built and tested against a fixture double first.
+ */
+interface ActivitySourceClient {
+    /** Stable capture-machine label. */
+    machineLabel: string;
+    /** Probe connectivity/auth without mutating anything. */
+    verify(signal?: AbortSignal): Promise<ActivitySourceCheck>;
+    /** Fetch one page of snapshots for a single local day. */
+    fetchSnapshots(opts: {
+        date: string;
+        timezone: string;
+        cursor?: string | null;
+        signal?: AbortSignal;
+    }): Promise<ActivitySnapshotPage>;
+}
+/** One trusted capture daemon that feeds this memory directory. */
+interface ActivitySourceConfig {
+    machineLabel: string;
+    baseUrl: string;
+    token?: string;
+}
+/** Opt-in activity synchronization settings. */
+interface ActivityConfig {
+    enabled: boolean;
+    timezone: string;
+    syncDays: number;
+    /** Periodic auto-sync cadence in minutes (default 15). */
+    autoSyncIntervalMinutes: number;
+    sources: ActivitySourceConfig[];
+}
+
 /**
  * Wearable transcript subsystem — shared types (issue: wearable connectors).
  *
@@ -1606,6 +1702,7 @@ interface PluginConfig extends BoundedJsonlStateConfig {
      * Disabled by default; see docs/wearables.md.
      */
     wearables: WearablesConfig;
+    activity: ActivityConfig;
     /**
      * At-rest encryption configuration (issue #690 PR 3/4).
      *
@@ -3930,4 +4027,4 @@ interface HourlySummary {
     generatedAt: string;
 }
 
-export { type BehaviorSignalEvent as $, type ActiveRecallChatType as A, type BriefingSections as B, type CalendarSource as C, type DreamsPhase as D, type EntityFile as E, type FaithfulnessFrontmatter as F, type GatewayConfig as G, type HourlySummary as H, type IdentityInjectionMode as I, type ExtractionResult as J, type ConsolidationResult as K, type LiveConnectorsConfig as L, type MemoryFile as M, type DaySummaryResult as N, type ExtractionFailureClass as O, type PluginConfig as P, type QmdSearchResult as Q, type RecallPlanMode as R, type SessionObserverBandConfig as S, type TranscriptEntry as T, type ProvenanceSource as U, type TrustWeights as V, type ConversationThread as W, type LifecycleState as X, type VerificationState as Y, type PolicyClass as Z, type ImportanceLevel as _, type DreamsRunResult as a, type BulkImportError as a$, type BufferSurpriseEvent as a0, type ImportTurn as a1, type BulkImportOptions as a2, type BulkImportSource as a3, type BulkImportResult as a4, type SecretRef as a5, type AgentAccessAuthToken as a6, type CompressionGuidelineOptimizerEventCounts as a7, type CompressionGuidelineOptimizerActionSummary as a8, type CompressionGuidelineOptimizerRuleUpdate as a9, type EntityActivityEntry as aA, type AccessTrackingEntry as aB, type MemorySummary as aC, type CodingContext as aD, type DreamsStatusResult as aE, type WearableConversation as aF, type WearableSourceSettings as aG, type WearableNativeMemory as aH, type WearableMemoryMode as aI, type WearableSourceConnector as aJ, type WearablesConfig as aK, type WearableSyncSummary as aL, type WearableSourceStatus as aM, type WearableDayTranscript as aN, type WearableCorrectionRule as aO, type RecallSectionConfig as aP, type BootstrapOptions as aQ, type BootstrapResult as aR, type ConsolidationObservation as aS, type CodingModeConfig as aT, type CodingKnowledgeConfig as aU, type WearableCleanupSettings as aV, type WearableFusionConfig as aW, type WearableDayTranscriptMeta as aX, type BriefingConfig as aY, type BriefingOpenCommitment as aZ, type BriefingWindow as a_, type MemoryActionType as aa, type MemoryActionEvent as ab, type CompressionGuidelineOptimizerState as ac, type EntityMention as ad, type EntitySchemaDefinition as ae, type EntitySchemaSectionDefinition as af, type EntityStructuredSection as ag, type ImportanceScore as ah, type MemoryIntent as ai, type MemoryActionEligibilityContext as aj, type MemoryActionPolicyResult as ak, type MemoryLifecycleEventType as al, type MemoryLifecycleStateSummary as am, type ModelProviderConfig as an, type NativeKnowledgeConfig as ao, type ProvenanceConfig as ap, type RetrievalTier as aq, type SignalScanResult as ar, type TopicScore as as, type QmdSearchExplain as at, type EntityTimelineEntry as au, type MemoryLink as av, type BufferState as aw, type MetaState as ax, type FileHygieneConfig as ay, type EntityRelationship as az, type RecallDisclosure as b, type MemoryActionPolicyDecision as b$, type BulkImportSourceAdapter as b0, type CodexCompatConfig as b1, DEFAULT_RECALL_DISCLOSURE as b2, type ExtractedFact as b3, type ImportSourceRole as b4, type ImportTurnValidationIssue as b5, type MemoryActionEligibilitySource as b6, type MemoryObservation as b7, type MemoryScope as b8, RECALL_DISCLOSURE_LEVELS as b9, type ConsolidationAction as bA, type ConsolidationItem as bB, type ContradictionScanConfig as bC, type CronConversationRecallMode as bD, type CronRecallMode as bE, type DreamingConfig as bF, type DreamingNarrativePromptStyle as bG, type DreamsDeepSleepConfig as bH, type DreamsLightSleepConfig as bI, type DreamsPhaseStatus as bJ, type DreamsPhasesConfig as bK, type DreamsRemConfig as bL, type EngramTraceEvent as bM, type ExtractedProcedureStep as bN, type ExtractedQuestion as bO, type ExtractedReasoningTrace as bP, type ExtractedReasoningTraceStep as bQ, type ExtractedRelationship as bR, type ExtractionPassSource as bS, type GitHubLiveConnectorConfig as bT, type GmailLiveConnectorConfig as bU, type GoogleDriveLiveConnectorConfig as bV, type HeartbeatConfig as bW, type HeartbeatDetectionMode as bX, type LlmTraceCallback as bY, type LlmTraceEvent as bZ, type MemoryActionOutcome as b_, type WearableAuthCheck as ba, type WearableFetchOptions as bb, type WearableFetchPage as bc, type WearableNativeMemoryPage as bd, type WearableTranscriptSegment as be, isImportRole as bf, isRecallDisclosure as bg, parseIsoTimestamp as bh, validateImportTurn as bi, type AgentAccessHttpConfig as bj, type AgentDefaultsConfig as bk, type AgentPersona as bl, type BehaviorLoopAdjustment as bm, type BehaviorSignalDirection as bn, type BehaviorSignalType as bo, type BriefingCalendarSourceError as bp, type BufferEntryState as bq, type CaptureMode as br, type ChatConfig as bs, type CodexCliReasoningEffort as bt, type CodexCompactionFlushMode as bu, type CodexConnectorConfig as bv, type CodingGraphLspConfig as bw, type CompressionGuidelineActivationState as bx, type CompressionGuidelineOptimizerSourceWindow as by, type ConfidenceTier as bz, type ActiveRecallQueryMode as c, type MemoryActionStatus as c0, type MemoryLinkType as c1, type MemoryOsPresetName as c2, type ModelApi as c3, type ModelDefinitionConfig as c4, type ModelProviderAuthMode as c5, type NamespacePolicy as c6, type NativeKnowledgeFolderRuleConfig as c7, type NativeKnowledgeObsidianVaultConfig as c8, type NativeKnowledgeOpenClawWorkspaceConfig as c9, type NotionLiveConnectorConfig as ca, type PrincipalFromSessionKeyMode as cb, type PrincipalRule as cc, type ProceduralConfig as cd, type QuestionEntry as ce, type ReasoningEffort as cf, type RecallPipelineConfig as cg, type RecallTraceEvent as ch, type RelevanceFeedback as ci, SPECULATIVE_TTL_DAYS as cj, type ScopeProfileAutoPromoteConfig as ck, type ScopeProfileTeamProjectConfig as cl, type ScopeTeamConfig as cm, type ScoredEntity as cn, type SemanticChunkingConfigShape as co, type SignalLevel as cp, type SlotBehaviorConfig as cq, type SlotMismatchMode as cr, type TriggerMode as cs, confidenceTier as ct, type ActiveRecallPromptStyle as d, type ActiveRecallThinking as e, type ActiveRecallModelFallbackPolicy as f, type RecallTierExplain as g, type BriefingFollowup as h, type BriefingFocus as i, type CalendarEvent as j, type BriefingActiveThread as k, type BriefingResult as l, type BriefingRecentEntity as m, type BufferTurn as n, type MemoryFrontmatter as o, type Checkpoint as p, type AgentPersonaModelConfig as q, type SourceConnectorProvenance as r, type ScopeProfileConfig as s, type ScopeProfileLayerId as t, type ScopeProfilePromotionTarget as u, type BehaviorLoopPolicyState as v, type MemoryCategory as w, type MemoryStatus as x, type MemoryProjectionCurrentState as y, type MemoryLifecycleEvent as z };
+export { type BehaviorSignalEvent as $, type ActiveRecallChatType as A, type BriefingSections as B, type CalendarSource as C, type DreamsPhase as D, type EntityFile as E, type FaithfulnessFrontmatter as F, type GatewayConfig as G, type HourlySummary as H, type IdentityInjectionMode as I, type ExtractionResult as J, type ConsolidationResult as K, type LiveConnectorsConfig as L, type MemoryFile as M, type DaySummaryResult as N, type ExtractionFailureClass as O, type PluginConfig as P, type QmdSearchResult as Q, type RecallPlanMode as R, type SessionObserverBandConfig as S, type TranscriptEntry as T, type ProvenanceSource as U, type TrustWeights as V, type ConversationThread as W, type LifecycleState as X, type VerificationState as Y, type PolicyClass as Z, type ImportanceLevel as _, type DreamsRunResult as a, type ActivitySourceClient as a$, type BufferSurpriseEvent as a0, type ImportTurn as a1, type BulkImportOptions as a2, type BulkImportSource as a3, type BulkImportResult as a4, type SecretRef as a5, type AgentAccessAuthToken as a6, type CompressionGuidelineOptimizerEventCounts as a7, type CompressionGuidelineOptimizerActionSummary as a8, type CompressionGuidelineOptimizerRuleUpdate as a9, type EntityActivityEntry as aA, type AccessTrackingEntry as aB, type MemorySummary as aC, type CodingContext as aD, type DreamsStatusResult as aE, type WearableConversation as aF, type WearableSourceSettings as aG, type WearableNativeMemory as aH, type WearableMemoryMode as aI, type WearableSourceConnector as aJ, type WearablesConfig as aK, type WearableSyncSummary as aL, type WearableSourceStatus as aM, type WearableDayTranscript as aN, type WearableCorrectionRule as aO, type RecallSectionConfig as aP, type BootstrapOptions as aQ, type BootstrapResult as aR, type ConsolidationObservation as aS, type CodingModeConfig as aT, type CodingKnowledgeConfig as aU, type WearableCleanupSettings as aV, type WearableFusionConfig as aW, type WearableDayTranscriptMeta as aX, type ActivitySnapshot as aY, type ActivityDayMeta as aZ, type ActivityDayDigest as a_, type MemoryActionType as aa, type MemoryActionEvent as ab, type CompressionGuidelineOptimizerState as ac, type EntityMention as ad, type EntitySchemaDefinition as ae, type EntitySchemaSectionDefinition as af, type EntityStructuredSection as ag, type ImportanceScore as ah, type MemoryIntent as ai, type MemoryActionEligibilityContext as aj, type MemoryActionPolicyResult as ak, type MemoryLifecycleEventType as al, type MemoryLifecycleStateSummary as am, type ModelProviderConfig as an, type NativeKnowledgeConfig as ao, type ProvenanceConfig as ap, type RetrievalTier as aq, type SignalScanResult as ar, type TopicScore as as, type QmdSearchExplain as at, type EntityTimelineEntry as au, type MemoryLink as av, type BufferState as aw, type MetaState as ax, type FileHygieneConfig as ay, type EntityRelationship as az, type RecallDisclosure as b, type GitHubLiveConnectorConfig as b$, type ActivitySourceCheck as b0, type ActivitySnapshotPage as b1, type ActivityConfig as b2, type ActivitySourceConfig as b3, type BriefingConfig as b4, type BriefingOpenCommitment as b5, type BriefingWindow as b6, type BulkImportError as b7, type BulkImportSourceAdapter as b8, type CodexCompatConfig as b9, type ChatConfig as bA, type CodexCliReasoningEffort as bB, type CodexCompactionFlushMode as bC, type CodexConnectorConfig as bD, type CodingGraphLspConfig as bE, type CompressionGuidelineActivationState as bF, type CompressionGuidelineOptimizerSourceWindow as bG, type ConfidenceTier as bH, type ConsolidationAction as bI, type ConsolidationItem as bJ, type ContradictionScanConfig as bK, type CronConversationRecallMode as bL, type CronRecallMode as bM, type DreamingConfig as bN, type DreamingNarrativePromptStyle as bO, type DreamsDeepSleepConfig as bP, type DreamsLightSleepConfig as bQ, type DreamsPhaseStatus as bR, type DreamsPhasesConfig as bS, type DreamsRemConfig as bT, type EngramTraceEvent as bU, type ExtractedProcedureStep as bV, type ExtractedQuestion as bW, type ExtractedReasoningTrace as bX, type ExtractedReasoningTraceStep as bY, type ExtractedRelationship as bZ, type ExtractionPassSource as b_, DEFAULT_RECALL_DISCLOSURE as ba, type ExtractedFact as bb, type ImportSourceRole as bc, type ImportTurnValidationIssue as bd, type MemoryActionEligibilitySource as be, type MemoryObservation as bf, type MemoryScope as bg, RECALL_DISCLOSURE_LEVELS as bh, type WearableAuthCheck as bi, type WearableFetchOptions as bj, type WearableFetchPage as bk, type WearableNativeMemoryPage as bl, type WearableTranscriptSegment as bm, isImportRole as bn, isRecallDisclosure as bo, parseIsoTimestamp as bp, validateImportTurn as bq, type AgentAccessHttpConfig as br, type AgentDefaultsConfig as bs, type AgentPersona as bt, type BehaviorLoopAdjustment as bu, type BehaviorSignalDirection as bv, type BehaviorSignalType as bw, type BriefingCalendarSourceError as bx, type BufferEntryState as by, type CaptureMode as bz, type ActiveRecallQueryMode as c, type GmailLiveConnectorConfig as c0, type GoogleDriveLiveConnectorConfig as c1, type HeartbeatConfig as c2, type HeartbeatDetectionMode as c3, type LlmTraceCallback as c4, type LlmTraceEvent as c5, type MemoryActionOutcome as c6, type MemoryActionPolicyDecision as c7, type MemoryActionStatus as c8, type MemoryLinkType as c9, type TriggerMode as cA, confidenceTier as cB, type MemoryOsPresetName as ca, type ModelApi as cb, type ModelDefinitionConfig as cc, type ModelProviderAuthMode as cd, type NamespacePolicy as ce, type NativeKnowledgeFolderRuleConfig as cf, type NativeKnowledgeObsidianVaultConfig as cg, type NativeKnowledgeOpenClawWorkspaceConfig as ch, type NotionLiveConnectorConfig as ci, type PrincipalFromSessionKeyMode as cj, type PrincipalRule as ck, type ProceduralConfig as cl, type QuestionEntry as cm, type ReasoningEffort as cn, type RecallPipelineConfig as co, type RecallTraceEvent as cp, type RelevanceFeedback as cq, SPECULATIVE_TTL_DAYS as cr, type ScopeProfileAutoPromoteConfig as cs, type ScopeProfileTeamProjectConfig as ct, type ScopeTeamConfig as cu, type ScoredEntity as cv, type SemanticChunkingConfigShape as cw, type SignalLevel as cx, type SlotBehaviorConfig as cy, type SlotMismatchMode as cz, type ActiveRecallPromptStyle as d, type ActiveRecallThinking as e, type ActiveRecallModelFallbackPolicy as f, type RecallTierExplain as g, type BriefingFollowup as h, type BriefingFocus as i, type CalendarEvent as j, type BriefingActiveThread as k, type BriefingResult as l, type BriefingRecentEntity as m, type BufferTurn as n, type MemoryFrontmatter as o, type Checkpoint as p, type AgentPersonaModelConfig as q, type SourceConnectorProvenance as r, type ScopeProfileConfig as s, type ScopeProfileLayerId as t, type ScopeProfilePromotionTarget as u, type BehaviorLoopPolicyState as v, type MemoryCategory as w, type MemoryStatus as x, type MemoryProjectionCurrentState as y, type MemoryLifecycleEvent as z };

package/dist/types.d.ts

@@ -1,4 +1,4 @@
-export { aB as AccessTrackingEntry, A as ActiveRecallChatType, f as ActiveRecallModelFallbackPolicy, d as ActiveRecallPromptStyle, c as ActiveRecallQueryMode, e as ActiveRecallThinking, a6 as AgentAccessAuthToken, bj as AgentAccessHttpConfig, bk as AgentDefaultsConfig, bl as AgentPersona, q as AgentPersonaModelConfig, bm as BehaviorLoopAdjustment, v as BehaviorLoopPolicyState, bn as BehaviorSignalDirection, $ as BehaviorSignalEvent, bo as BehaviorSignalType, aQ as BootstrapOptions, aR as BootstrapResult, k as BriefingActiveThread, bp as BriefingCalendarSourceError, aY as BriefingConfig, i as BriefingFocus, h as BriefingFollowup, aZ as BriefingOpenCommitment, m as BriefingRecentEntity, l as BriefingResult, B as BriefingSections, a_ as BriefingWindow, bq as BufferEntryState, aw as BufferState, a0 as BufferSurpriseEvent, n as BufferTurn, j as CalendarEvent, C as CalendarSource, br as CaptureMode, bs as ChatConfig, p as Checkpoint, bt as CodexCliReasoningEffort, bu as CodexCompactionFlushMode, b1 as CodexCompatConfig, bv as CodexConnectorConfig, aD as CodingContext, bw as CodingGraphLspConfig, aU as CodingKnowledgeConfig, aT as CodingModeConfig, bx as CompressionGuidelineActivationState, a8 as CompressionGuidelineOptimizerActionSummary, a7 as CompressionGuidelineOptimizerEventCounts, a9 as CompressionGuidelineOptimizerRuleUpdate, by as CompressionGuidelineOptimizerSourceWindow, ac as CompressionGuidelineOptimizerState, bz as ConfidenceTier, bA as ConsolidationAction, bB as ConsolidationItem, aS as ConsolidationObservation, K as ConsolidationResult, bC as ContradictionScanConfig, W as ConversationThread, bD as CronConversationRecallMode, bE as CronRecallMode, b2 as DEFAULT_RECALL_DISCLOSURE, N as DaySummaryResult, bF as DreamingConfig, bG as DreamingNarrativePromptStyle, bH as DreamsDeepSleepConfig, bI as DreamsLightSleepConfig, D as DreamsPhase, bJ as DreamsPhaseStatus, bK as DreamsPhasesConfig, bL as DreamsRemConfig, a as DreamsRunResult, aE as DreamsStatusResult, bM as EngramTraceEvent, aA as EntityActivityEntry, E as EntityFile, ad as EntityMention, az as EntityRelationship, ae as EntitySchemaDefinition, af as EntitySchemaSectionDefinition, ag as EntityStructuredSection, au as EntityTimelineEntry, b3 as ExtractedFact, bN as ExtractedProcedureStep, bO as ExtractedQuestion, bP as ExtractedReasoningTrace, bQ as ExtractedReasoningTraceStep, bR as ExtractedRelationship, O as ExtractionFailureClass, bS as ExtractionPassSource, J as ExtractionResult, F as FaithfulnessFrontmatter, ay as FileHygieneConfig, G as GatewayConfig, bT as GitHubLiveConnectorConfig, bU as GmailLiveConnectorConfig, bV as GoogleDriveLiveConnectorConfig, bW as HeartbeatConfig, bX as HeartbeatDetectionMode, H as HourlySummary, I as IdentityInjectionMode, _ as ImportanceLevel, ah as ImportanceScore, X as LifecycleState, L as LiveConnectorsConfig, bY as LlmTraceCallback, bZ as LlmTraceEvent, aj as MemoryActionEligibilityContext, b6 as MemoryActionEligibilitySource, ab as MemoryActionEvent, b_ as MemoryActionOutcome, b$ as MemoryActionPolicyDecision, ak as MemoryActionPolicyResult, c0 as MemoryActionStatus, aa as MemoryActionType, w as MemoryCategory, M as MemoryFile, o as MemoryFrontmatter, ai as MemoryIntent, z as MemoryLifecycleEvent, al as MemoryLifecycleEventType, am as MemoryLifecycleStateSummary, av as MemoryLink, c1 as MemoryLinkType, b7 as MemoryObservation, c2 as MemoryOsPresetName, y as MemoryProjectionCurrentState, b8 as MemoryScope, x as MemoryStatus, aC as MemorySummary, ax as MetaState, c3 as ModelApi, c4 as ModelDefinitionConfig, c5 as ModelProviderAuthMode, an as ModelProviderConfig, c6 as NamespacePolicy, ao as NativeKnowledgeConfig, c7 as NativeKnowledgeFolderRuleConfig, c8 as NativeKnowledgeObsidianVaultConfig, c9 as NativeKnowledgeOpenClawWorkspaceConfig, ca as NotionLiveConnectorConfig, P as PluginConfig, Z as PolicyClass, cb as PrincipalFromSessionKeyMode, cc as PrincipalRule, cd as ProceduralConfig, ap as ProvenanceConfig, U as ProvenanceSource, at as QmdSearchExplain, Q as QmdSearchResult, ce as QuestionEntry, b9 as RECALL_DISCLOSURE_LEVELS, cf as ReasoningEffort, b as RecallDisclosure, cg as RecallPipelineConfig, R as RecallPlanMode, aP as RecallSectionConfig, g as RecallTierExplain, ch as RecallTraceEvent, ci as RelevanceFeedback, aq as RetrievalTier, cj as SPECULATIVE_TTL_DAYS, ck as ScopeProfileAutoPromoteConfig, s as ScopeProfileConfig, t as ScopeProfileLayerId, u as ScopeProfilePromotionTarget, cl as ScopeProfileTeamProjectConfig, cm as ScopeTeamConfig, cn as ScoredEntity, a5 as SecretRef, co as SemanticChunkingConfigShape, S as SessionObserverBandConfig, cp as SignalLevel, ar as SignalScanResult, cq as SlotBehaviorConfig, cr as SlotMismatchMode, r as SourceConnectorProvenance, as as TopicScore, T as TranscriptEntry, cs as TriggerMode, V as TrustWeights, Y as VerificationState, ct as confidenceTier, bg as isRecallDisclosure } from './types-2q_MRFcM.js';
+export { aB as AccessTrackingEntry, A as ActiveRecallChatType, f as ActiveRecallModelFallbackPolicy, d as ActiveRecallPromptStyle, c as ActiveRecallQueryMode, e as ActiveRecallThinking, a6 as AgentAccessAuthToken, br as AgentAccessHttpConfig, bs as AgentDefaultsConfig, bt as AgentPersona, q as AgentPersonaModelConfig, bu as BehaviorLoopAdjustment, v as BehaviorLoopPolicyState, bv as BehaviorSignalDirection, $ as BehaviorSignalEvent, bw as BehaviorSignalType, aQ as BootstrapOptions, aR as BootstrapResult, k as BriefingActiveThread, bx as BriefingCalendarSourceError, b4 as BriefingConfig, i as BriefingFocus, h as BriefingFollowup, b5 as BriefingOpenCommitment, m as BriefingRecentEntity, l as BriefingResult, B as BriefingSections, b6 as BriefingWindow, by as BufferEntryState, aw as BufferState, a0 as BufferSurpriseEvent, n as BufferTurn, j as CalendarEvent, C as CalendarSource, bz as CaptureMode, bA as ChatConfig, p as Checkpoint, bB as CodexCliReasoningEffort, bC as CodexCompactionFlushMode, b9 as CodexCompatConfig, bD as CodexConnectorConfig, aD as CodingContext, bE as CodingGraphLspConfig, aU as CodingKnowledgeConfig, aT as CodingModeConfig, bF as CompressionGuidelineActivationState, a8 as CompressionGuidelineOptimizerActionSummary, a7 as CompressionGuidelineOptimizerEventCounts, a9 as CompressionGuidelineOptimizerRuleUpdate, bG as CompressionGuidelineOptimizerSourceWindow, ac as CompressionGuidelineOptimizerState, bH as ConfidenceTier, bI as ConsolidationAction, bJ as ConsolidationItem, aS as ConsolidationObservation, K as ConsolidationResult, bK as ContradictionScanConfig, W as ConversationThread, bL as CronConversationRecallMode, bM as CronRecallMode, ba as DEFAULT_RECALL_DISCLOSURE, N as DaySummaryResult, bN as DreamingConfig, bO as DreamingNarrativePromptStyle, bP as DreamsDeepSleepConfig, bQ as DreamsLightSleepConfig, D as DreamsPhase, bR as DreamsPhaseStatus, bS as DreamsPhasesConfig, bT as DreamsRemConfig, a as DreamsRunResult, aE as DreamsStatusResult, bU as EngramTraceEvent, aA as EntityActivityEntry, E as EntityFile, ad as EntityMention, az as EntityRelationship, ae as EntitySchemaDefinition, af as EntitySchemaSectionDefinition, ag as EntityStructuredSection, au as EntityTimelineEntry, bb as ExtractedFact, bV as ExtractedProcedureStep, bW as ExtractedQuestion, bX as ExtractedReasoningTrace, bY as ExtractedReasoningTraceStep, bZ as ExtractedRelationship, O as ExtractionFailureClass, b_ as ExtractionPassSource, J as ExtractionResult, F as FaithfulnessFrontmatter, ay as FileHygieneConfig, G as GatewayConfig, b$ as GitHubLiveConnectorConfig, c0 as GmailLiveConnectorConfig, c1 as GoogleDriveLiveConnectorConfig, c2 as HeartbeatConfig, c3 as HeartbeatDetectionMode, H as HourlySummary, I as IdentityInjectionMode, _ as ImportanceLevel, ah as ImportanceScore, X as LifecycleState, L as LiveConnectorsConfig, c4 as LlmTraceCallback, c5 as LlmTraceEvent, aj as MemoryActionEligibilityContext, be as MemoryActionEligibilitySource, ab as MemoryActionEvent, c6 as MemoryActionOutcome, c7 as MemoryActionPolicyDecision, ak as MemoryActionPolicyResult, c8 as MemoryActionStatus, aa as MemoryActionType, w as MemoryCategory, M as MemoryFile, o as MemoryFrontmatter, ai as MemoryIntent, z as MemoryLifecycleEvent, al as MemoryLifecycleEventType, am as MemoryLifecycleStateSummary, av as MemoryLink, c9 as MemoryLinkType, bf as MemoryObservation, ca as MemoryOsPresetName, y as MemoryProjectionCurrentState, bg as MemoryScope, x as MemoryStatus, aC as MemorySummary, ax as MetaState, cb as ModelApi, cc as ModelDefinitionConfig, cd as ModelProviderAuthMode, an as ModelProviderConfig, ce as NamespacePolicy, ao as NativeKnowledgeConfig, cf as NativeKnowledgeFolderRuleConfig, cg as NativeKnowledgeObsidianVaultConfig, ch as NativeKnowledgeOpenClawWorkspaceConfig, ci as NotionLiveConnectorConfig, P as PluginConfig, Z as PolicyClass, cj as PrincipalFromSessionKeyMode, ck as PrincipalRule, cl as ProceduralConfig, ap as ProvenanceConfig, U as ProvenanceSource, at as QmdSearchExplain, Q as QmdSearchResult, cm as QuestionEntry, bh as RECALL_DISCLOSURE_LEVELS, cn as ReasoningEffort, b as RecallDisclosure, co as RecallPipelineConfig, R as RecallPlanMode, aP as RecallSectionConfig, g as RecallTierExplain, cp as RecallTraceEvent, cq as RelevanceFeedback, aq as RetrievalTier, cr as SPECULATIVE_TTL_DAYS, cs as ScopeProfileAutoPromoteConfig, s as ScopeProfileConfig, t as ScopeProfileLayerId, u as ScopeProfilePromotionTarget, ct as ScopeProfileTeamProjectConfig, cu as ScopeTeamConfig, cv as ScoredEntity, a5 as SecretRef, cw as SemanticChunkingConfigShape, S as SessionObserverBandConfig, cx as SignalLevel, ar as SignalScanResult, cy as SlotBehaviorConfig, cz as SlotMismatchMode, r as SourceConnectorProvenance, as as TopicScore, T as TranscriptEntry, cA as TriggerMode, V as TrustWeights, Y as VerificationState, cB as confidenceTier, bo as isRecallDisclosure } from './types-OUCJALBK.js';
 import './message-parts/index.js';
 import './bounded-jsonl-state.js';
 export { ContinuityImprovementLoop, ContinuityIncidentCloseInput, ContinuityIncidentOpenInput, ContinuityIncidentRecord, ContinuityIncidentState, ContinuityLoopCadence, ContinuityLoopReviewInput, ContinuityLoopStatus, ContinuityLoopUpsertInput } from './types-continuity.js';

package/dist/types.js

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

package/dist/utility-runtime.d.ts

@@ -1,5 +1,5 @@
 import { TierRoutingPolicy } from './tier-routing.js';
-import './types-2q_MRFcM.js';
+import './types-OUCJALBK.js';
 import './message-parts/index.js';
 import './bounded-jsonl-state.js';
 import './types-continuity.js';

package/dist/verified-recall.js

@@ -1,9 +1,9 @@
 import {
   compareVerifiedEpisodeResults,
   searchVerifiedEpisodes
-} from "./chunk-6EJL2O3G.js";
+} from "./chunk-AFH7PIFU.js";
 import "./chunk-B7RWBZXW.js";
-import "./chunk-O7ACJAHR.js";
+import "./chunk-7YJLCNPF.js";
 import "./chunk-B3ABVQ36.js";
 import "./chunk-2QMKMVHH.js";
 import "./chunk-DEBHXHJR.js";
@@ -11,7 +11,7 @@ import "./chunk-DNHVPZOD.js";
 import "./chunk-6CIAGZ6X.js";
 import "./chunk-J6A3CX5N.js";
 import "./chunk-V57NLO5P.js";
-import "./chunk-FJ5IQ3SI.js";
+import "./chunk-N7DK67GZ.js";
 import "./chunk-XKGPIWGI.js";
 import "./chunk-EGGE52UU.js";
 import "./chunk-GCASGYIO.js";

package/dist/write-envelope.d.ts

@@ -1,4 +1,4 @@
-import { w as MemoryCategory } from './types-2q_MRFcM.js';
+import { w as MemoryCategory } from './types-OUCJALBK.js';
 import './message-parts/index.js';
 import './bounded-jsonl-state.js';
 import './types-continuity.js';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@remnic/core",
-  "version": "9.15.3",
+  "version": "9.16.0",
   "description": "Framework-agnostic Remnic memory engine — orchestrator, storage, extraction, search, trust zones",
   "type": "module",
   "main": "dist/index.js",
@@ -3045,7 +3045,7 @@
     "core"
   ],
   "peerDependencies": {
-    "@remnic/coding-graph": "^9.15.3"
+    "@remnic/coding-graph": "^9.16.0"
   },
   "peerDependenciesMeta": {
     "@remnic/coding-graph": {

package/src/activity/config.test.ts

@@ -0,0 +1,113 @@
+import assert from "node:assert/strict";
+import test from "node:test";
+
+import { parseActivityConfig } from "./config.js";
+
+test("parseActivityConfig defaults to an inert configuration", () => {
+  assert.deepEqual(parseActivityConfig(undefined), {
+    enabled: false,
+    timezone: "UTC",
+    syncDays: 1,
+    autoSyncIntervalMinutes: 15,
+    sources: [],
+  });
+});
+
+test("parseActivityConfig treats a string false gate as disabled", () => {
+  assert.equal(parseActivityConfig({ enabled: "false" }).enabled, false);
+});
+
+test("parseActivityConfig preserves explicit source settings", () => {
+  assert.deepEqual(
+    parseActivityConfig({
+      enabled: true,
+      timezone: "America/Chicago",
+      syncDays: 3,
+      sources: [{ machineLabel: "fixture-machine", baseUrl: "http://127.0.0.1:4319", token: "fixture-token" }],
+    }),
+    {
+      enabled: true,
+      timezone: "America/Chicago",
+      syncDays: 3,
+      autoSyncIntervalMinutes: 15,
+      sources: [{ machineLabel: "fixture-machine", baseUrl: "http://127.0.0.1:4319", token: "fixture-token" }],
+    },
+  );
+});
+
+test("parseActivityConfig rejects enabled configurations without valid source definitions", () => {
+  assert.throws(() => parseActivityConfig({ enabled: true, sources: [] }), /at least one source/);
+  assert.throws(
+    () => parseActivityConfig({ enabled: true, sources: [{ machineLabel: "fixture", baseUrl: "ftp://example.test" }] }),
+    /HTTP or HTTPS/,
+  );
+  assert.throws(() => parseActivityConfig({ syncDays: 0 }), /syncDays/);
+});
+
+test("parseActivityConfig enforces both ends of the syncDays range", () => {
+  assert.equal(parseActivityConfig({ syncDays: 90 }).syncDays, 90);
+  assert.equal(parseActivityConfig({ syncDays: 1 }).syncDays, 1);
+  assert.throws(() => parseActivityConfig({ syncDays: 91 }), /syncDays must be an integer from 1 to 90/);
+  assert.throws(() => parseActivityConfig({ syncDays: 0 }), /syncDays must be an integer from 1 to 90/);
+});
+
+test("parseActivityConfig rejects an invalid IANA timezone at parse time", () => {
+  assert.throws(() => parseActivityConfig({ timezone: "Not/AZone" }), /Invalid IANA timezone/);
+});
+
+test("parseActivityConfig rejects a whitespace-only machineLabel before any sync", () => {
+  assert.throws(
+    () => parseActivityConfig({ enabled: true, sources: [{ machineLabel: "   ", baseUrl: "http://127.0.0.1:4319" }] }),
+    /machineLabel must not be blank/,
+  );
+});
+
+test("parseActivityConfig rejects duplicate machine labels that would share a cursor", () => {
+  assert.throws(
+    () =>
+      parseActivityConfig({
+        enabled: true,
+        sources: [
+          { machineLabel: "dup", baseUrl: "http://127.0.0.1:4319" },
+          { machineLabel: "dup", baseUrl: "http://127.0.0.1:4320" },
+        ],
+      }),
+    /machineLabel must be unique/,
+  );
+});
+
+test("parseActivityConfig reports a malformed baseUrl with a prefixed validation error", () => {
+  assert.throws(
+    () => parseActivityConfig({ enabled: true, sources: [{ machineLabel: "fixture", baseUrl: "not a url" }] }),
+    /activity source baseUrl must be a valid URL/,
+  );
+});
+
+test("parseActivityConfig rejects a non-loopback baseUrl that could exfiltrate the token", () => {
+  assert.throws(
+    () => parseActivityConfig({ enabled: true, sources: [{ machineLabel: "fixture", baseUrl: "https://example.test" }] }),
+    /must target a loopback host/,
+  );
+});
+
+test("parseActivityConfig accepts localhost and 127.x loopback hosts", () => {
+  assert.equal(
+    parseActivityConfig({ enabled: true, sources: [{ machineLabel: "a", baseUrl: "http://localhost:4319" }] }).sources
+      .length,
+    1,
+  );
+  assert.equal(
+    parseActivityConfig({ enabled: true, sources: [{ machineLabel: "b", baseUrl: "http://127.0.0.5:4319" }] }).sources
+      .length,
+    1,
+  );
+});
+
+test("parseActivityConfig parses and bounds autoSyncIntervalMinutes", () => {
+  assert.equal(parseActivityConfig(undefined).autoSyncIntervalMinutes, 15);
+  assert.equal(parseActivityConfig({ autoSyncIntervalMinutes: "30" }).autoSyncIntervalMinutes, 30);
+  assert.equal(parseActivityConfig({ autoSyncIntervalMinutes: 1 }).autoSyncIntervalMinutes, 1);
+  assert.equal(parseActivityConfig({ autoSyncIntervalMinutes: 1440 }).autoSyncIntervalMinutes, 1440);
+  assert.throws(() => parseActivityConfig({ autoSyncIntervalMinutes: 0 }), /autoSyncIntervalMinutes must be an integer from 1 to 1440/);
+  assert.throws(() => parseActivityConfig({ autoSyncIntervalMinutes: 1441 }), /autoSyncIntervalMinutes must be an integer from 1 to 1440/);
+});

package/src/activity/config.ts

@@ -0,0 +1,111 @@
+import { coerceBooleanLike, coerceNumber } from "../connectors/coerce.js";
+import { assertValidTimezone } from "./digest.js";
+import type { ActivityConfig, ActivitySourceConfig } from "./types.js";
+
+function asRecord(value: unknown, name: string): Record<string, unknown> {
+  if (typeof value !== "object" || value === null || Array.isArray(value)) {
+    throw new TypeError(`${name} must be an object`);
+  }
+  return value as Record<string, unknown>;
+}
+
+function optionalString(value: unknown, name: string): string | undefined {
+  if (value === undefined) return undefined;
+  if (typeof value !== "string" || value.length === 0) throw new TypeError(`${name} must be a non-empty string`);
+  return value;
+}
+
+const LOOPBACK_HOSTS: Record<string, true> = { localhost: true, "127.0.0.1": true, "::1": true };
+
+/**
+ * Parse, protocol-check, and confine an activity source base URL to a local
+ * loopback host. Shared with ActivityHttpSourceClient so config-load and client
+ * construction reject the exact same shapes with the same prefixed message (a
+ * bare `new URL()` throws an opaque TypeError on malformed input). The bearer
+ * token travels in an Authorization header, so a non-loopback baseUrl would
+ * exfiltrate it; the subsystem contract is local capture daemons only.
+ */
+export function validateActivityBaseUrl(baseUrl: string): URL {
+  let parsed: URL;
+  try {
+    parsed = new URL(baseUrl);
+  } catch {
+    throw new RangeError(`activity source baseUrl must be a valid URL: ${baseUrl}`);
+  }
+  if (parsed.protocol !== "http:" && parsed.protocol !== "https:") {
+    throw new RangeError("activity source baseUrl must use HTTP or HTTPS");
+  }
+  // URL keeps IPv6 hosts bracketed (e.g. "[::1]"); normalize before the lookup.
+  const host = parsed.hostname.replace(/^\[|\]$/g, "");
+  if (LOOPBACK_HOSTS[host] !== true && !/^127\.\d{1,3}\.\d{1,3}\.\d{1,3}$/.test(host)) {
+    throw new RangeError(`activity source baseUrl must target a loopback host (got ${parsed.hostname})`);
+  }
+  return parsed;
+}
+
+function parseSource(value: unknown): ActivitySourceConfig {
+  const raw = asRecord(value, "activity source");
+  const machineLabel = optionalString(raw.machineLabel, "activity source machineLabel");
+  const baseUrl = optionalString(raw.baseUrl, "activity source baseUrl");
+  if (machineLabel === undefined || baseUrl === undefined) {
+    throw new TypeError("activity source requires machineLabel and baseUrl");
+  }
+  // Reject whitespace-only labels here so config-load fails loudly rather than
+  // parsing clean and then failing on the first sync (the client and pipeline
+  // both reject a blank label via trim()).
+  if (machineLabel.trim().length === 0) {
+    throw new RangeError("activity source machineLabel must not be blank");
+  }
+  validateActivityBaseUrl(baseUrl);
+  const token = optionalString(raw.token, "activity source token");
+  return { machineLabel, baseUrl, ...(token === undefined ? {} : { token }) };
+}
+
+export function parseActivityConfig(raw: unknown): ActivityConfig {
+  if (raw === undefined || raw === null) {
+    return { enabled: false, timezone: "UTC", syncDays: 1, autoSyncIntervalMinutes: 15, sources: [] };
+  }
+  const config = asRecord(raw, "activity");
+  const enabledValue = coerceBooleanLike(config.enabled, "activity.enabled");
+  if (config.enabled !== undefined && enabledValue === undefined) {
+    throw new TypeError("activity.enabled must be a boolean");
+  }
+  const timezone = optionalString(config.timezone, "activity.timezone") ?? "UTC";
+  // Validate the IANA zone at parse so a typo fails before any daemon is
+  // contacted; otherwise activityDayWindow() throws mid-sync after snapshot
+  // pages may already be persisted, and every retry replays the same window.
+  assertValidTimezone(timezone);
+  const syncDaysValue = coerceNumber(config.syncDays, "activity.syncDays");
+  if (config.syncDays !== undefined && syncDaysValue === undefined) {
+    throw new TypeError("activity.syncDays must be a finite number");
+  }
+  const syncDays = syncDaysValue ?? 1;
+  if (!Number.isInteger(syncDays) || syncDays < 1 || syncDays > 90) {
+    throw new RangeError("activity.syncDays must be an integer from 1 to 90");
+  }
+  const intervalValue = coerceNumber(config.autoSyncIntervalMinutes, "activity.autoSyncIntervalMinutes");
+  if (config.autoSyncIntervalMinutes !== undefined && intervalValue === undefined) {
+    throw new TypeError("activity.autoSyncIntervalMinutes must be a finite number");
+  }
+  const autoSyncIntervalMinutes = intervalValue ?? 15;
+  if (!Number.isInteger(autoSyncIntervalMinutes) || autoSyncIntervalMinutes < 1 || autoSyncIntervalMinutes > 1440) {
+    throw new RangeError("activity.autoSyncIntervalMinutes must be an integer from 1 to 1440");
+  }
+  if (config.sources !== undefined && !Array.isArray(config.sources)) {
+    throw new TypeError("activity.sources must be an array");
+  }
+  const sources = (config.sources ?? []).map(parseSource);
+  // Cursors and row dedup are keyed on machineLabel alone; two sources sharing
+  // a label would share a cursor and dedup namespace, silently skipping or
+  // conflating snapshots. Reject the collision at parse.
+  const labels = new Set<string>();
+  for (const source of sources) {
+    if (labels.has(source.machineLabel)) {
+      throw new RangeError(`activity source machineLabel must be unique: ${source.machineLabel}`);
+    }
+    labels.add(source.machineLabel);
+  }
+  const enabled = enabledValue ?? false;
+  if (enabled && sources.length === 0) throw new RangeError("activity.enabled requires at least one source");
+  return { enabled, timezone, syncDays, autoSyncIntervalMinutes, sources };
+}

package/src/activity/digest.ts

@@ -55,11 +55,11 @@ function timezoneOffsetIso(instant: Date, timezone: string): string {
   return match?.[1] ?? "+00:00";
 }
 
-function assertValidTimezone(timezone: string): void {
+export function assertValidTimezone(timezone: string): void {
   try {
     new Intl.DateTimeFormat("en-US", { timeZone: timezone });
   } catch {
-    throw new RangeError(`Invalid IANA timezone "${timezone}" for the activity digest.`);
+    throw new RangeError(`Invalid IANA timezone "${timezone}".`);
   }
 }
 

package/src/activity/index.ts

@@ -7,3 +7,9 @@
 export * from "./types.js";
 export * from "./store.js";
 export * from "./digest.js";
+export * from "./pipeline.js";
+export * from "./source-client.js";
+export * from "./runner.js";
+export * from "./scheduler.js";
+export * from "./config.js";
+export * from "./reindex.js";