@remnic/core 9.3.624 → 9.3.625

package/dist/index.d.ts

@@ -1,7 +1,8 @@
 export { PluginEntryResolverOptions, resolvePluginEntry } from './plugin-entry-resolver.js';
 export { isOpenaiApiKeyDisabled, parseConfig, resolveEnvVars } from './config.js';
 export { MigrationOptions, MigrationResult, RollbackResult, migrateFromEngram, rollbackFromEngramMigration } from './migrate/from-engram.js';
-export { O as Orchestrator, d as defaultWorkspaceDir, s as sanitizeSessionKeyForFilename } from './orchestrator-CqWOjfgl.js';
+import { S as SpeakerRegistry, W as WearablesService } from './orchestrator-CEycaY3M.js';
+export { D as DEFAULT_SELF_NAME, O as Orchestrator, R as ResolvedSpeaker, a as SpeakerOverride, b as WEARABLE_SOURCE_PREFIX, c as WearableDayTranscriptView, d as WearableMemoryGenDeps, e as WearableMemoryGenResult, f as WearableMemorySearchResult, g as WearableMemoryWriter, h as WearableSearchBackend, i as WearableStorageIo, j as WearableSyncDeps, k as WearableSyncOptions, l as WearableTranscriptSearchResult, m as WearablesServiceDeps, n as buildExtractionTurns, o as dateInTimezone, p as defaultTimezone, q as defaultWorkspaceDir, r as distinctSpeakerLabels, s as emptySpeakerRegistry, t as generateWearableMemories, u as importNativeMemories, v as loadSpeakerRegistry, w as locateTranscriptPath, x as memoryStatusForMode, y as resolveSpeaker, z as resolveSyncDates, A as sanitizeSessionKeyForFilename, B as saveSpeakerRegistry, C as speakerRegistryKey, E as speakersFilePath, F as syncWearableSource, H as wearableDayTag, J as wearableSourceLabel, K as writeDailyDigestMemory } from './orchestrator-CEycaY3M.js';
 export { normalizeProjectionPreview, normalizeProjectionTags } from './memory-projection-format.js';
 export { ModelCapabilities, ModelRegistry } from './model-registry.js';
 export { ACTIVE_STATUSES, ContradictionFilter, ContradictionJudgeBatchResult, ContradictionJudgeInput, ContradictionJudgeResult, ContradictionListResult, ContradictionVerdict, ResolutionResult, ResolutionVerb, ScanDependencies, ScanResult, computePairId, executeResolution, isCoolingDown, isValidResolutionVerb, judgeContradictionPairs, listPairs, readPair, resolvePair, runContradictionScan, writePair, writePairs } from './contradiction/index.js';
@@ -19,11 +20,11 @@ export { CodexCliFallbackConfig, CodexCliFallbackMessage, CodexCliFallbackOption
 export { BufferSurpriseProbe, SmartBuffer, TriggerDecision } from './buffer.js';
 export { ComputeSurpriseOptions, DEFAULT_SURPRISE_K, RecentMemoryLike, computeSurprise } from './buffer-surprise.js';
 export { BufferSurpriseDistribution, BufferSurpriseReader, BufferSurpriseReportOptions, reportBufferSurpriseDistribution } from './buffer-surprise-report.js';
-import { PluginConfig, CodingContext, CodingModeConfig, MemoryCategory } from './types.js';
-export { AgentAccessAuthToken, BriefingActiveThread, BriefingConfig, BriefingFocus, BriefingFollowup, BriefingOpenCommitment, BriefingRecentEntity, BriefingResult, BriefingSections, BriefingWindow, BufferSurpriseEvent, CalendarEvent, CalendarSource, CodexCompatConfig, ConsolidationObservation, ContinuityImprovementLoop, DEFAULT_RECALL_DISCLOSURE, EntityFile, EntityStructuredSection, ExtractedFact, GatewayConfig, MemoryActionEligibilityContext, MemoryActionEligibilitySource, MemoryActionType, MemoryFile, MemoryFrontmatter, MemoryObservation, MemoryScope, RECALL_DISCLOSURE_LEVELS, RecallDisclosure, SecretRef, isRecallDisclosure } from './types.js';
+import { P as PluginConfig, aG as CodingContext, aL as CodingModeConfig, M as MemoryCategory, aM as WearableCleanupSettings, ax as WearableSourceSettings, aB as WearablesConfig, aA as WearableSourceConnector, aw as WearableConversation, aF as WearableCorrectionRule, aN as WearableDayTranscriptMeta, aE as WearableDayTranscript } from './types-D5VRAI04.js';
+export { a6 as AgentAccessAuthToken, a2 as BriefingActiveThread, aO as BriefingConfig, $ as BriefingFocus, _ as BriefingFollowup, aP as BriefingOpenCommitment, a4 as BriefingRecentEntity, a3 as BriefingResult, Z as BriefingSections, aQ as BriefingWindow, o as BufferSurpriseEvent, a1 as CalendarEvent, a0 as CalendarSource, aR as CodexCompatConfig, aJ as ConsolidationObservation, s as ContinuityImprovementLoop, aS as DEFAULT_RECALL_DISCLOSURE, x as EntityFile, E as EntityStructuredSection, aT as ExtractedFact, G as GatewayConfig, ak as MemoryActionEligibilityContext, aU as MemoryActionEligibilitySource, aa as MemoryActionType, g as MemoryFile, i as MemoryFrontmatter, aV as MemoryObservation, aW as MemoryScope, aX as RECALL_DISCLOSURE_LEVELS, K as RecallDisclosure, a5 as SecretRef, aY as WearableAuthCheck, aZ as WearableFetchOptions, a_ as WearableFetchPage, az as WearableMemoryMode, ay as WearableNativeMemory, a$ as WearableNativeMemoryPage, aD as WearableSourceStatus, aC as WearableSyncSummary, b0 as WearableTranscriptSegment, b1 as isRecallDisclosure } from './types-D5VRAI04.js';
 export { JudgeBatchResult, JudgeCandidate, JudgeVerdict, JudgeVerdictKind, clearVerdictCache, createVerdictCache, getVerdictKind, isDurableVerdict, isValidCachedVerdict, judgeFactDurability, normalizeCachedVerdict, verdictCacheSize } from './extraction-judge.js';
 export { hasBroadGraphIntent, inferIntentFromText, intentCompatibilityScore, isTaskInitiationIntent, planRecallMode } from './intent.js';
-export { b as EngramAccessInputError, E as EngramAccessService, P as ProcedureStatsConfigSnapshot, c as ProcedureStatsRecent, d as ProcedureStatsReport, e as ProcedureStatusCounts, f as computeProcedureStats, g as formatProcedureStatsText } from './access-service-CBNEKjzN.js';
+export { b as EngramAccessInputError, E as EngramAccessService, P as ProcedureStatsConfigSnapshot, c as ProcedureStatsRecent, d as ProcedureStatsReport, e as ProcedureStatusCounts, f as computeProcedureStats, g as formatProcedureStatsText } from './access-service-C_sfOHsX.js';
 export { FILTER_LABELS as DIRECT_ANSWER_FILTER_LABELS, DirectAnswerCandidate, DirectAnswerConfig, DirectAnswerInput, DirectAnswerReason, DirectAnswerResult, isDirectAnswerEligible } from './direct-answer.js';
 export { MemoryTier, TierRoutingPolicy, TierTransitionDecision, computeTierValueScore, decideTierTransition } from './tier-routing.js';
 export { ApplyReasoningTraceBoostOptions, BoostableResult, DEFAULT_REASONING_TRACE_BOOST, applyReasoningTraceBoost, isReasoningTracePath, looksLikeProblemSolvingQuery } from './reasoning-trace-recall.js';
@@ -56,10 +57,10 @@ export { CODEX_THREAD_KEY_PREFIX } from './codex-thread-key.js';
 export { PageVersion, VersionHistory, VersionTrigger, VersioningConfig, VersioningLogger, createVersion, diffVersions, getVersion, listVersions, revertToVersion } from './page-versioning.js';
 export { CitationBlock, CitationEntry, CitationMetadata, buildCitationGuidance, formatOaiMemCitation, parseOaiMemCitation, sanitizeNoteForCitation } from './citations.js';
 export { initLogger, log } from './logger.js';
-export { b as SemanticDedupDecision, S as SemanticDedupHit, a as SemanticDedupLookup, c as SemanticDedupOptions, d as decideSemanticDedup } from './semantic-SLAa_prH.js';
+export { b as SemanticDedupDecision, a as SemanticDedupHit, S as SemanticDedupLookup, c as SemanticDedupOptions, d as decideSemanticDedup } from './semantic-DJR8_DMQ.js';
 export { OFFLINE_SYNC_APPLY_MAX_BODY_BYTES, OFFLINE_SYNC_CHANGESET_FORMAT, OFFLINE_SYNC_FILE_CONTENT_MAX_CHUNK_BYTES, OFFLINE_SYNC_FILE_CONTENT_TRANSFER_CHUNK_BYTES, OFFLINE_SYNC_SNAPSHOT_BASE_MAX_BODY_BYTES, OFFLINE_SYNC_SNAPSHOT_FORMAT, OFFLINE_SYNC_STATE_VERSION, OfflineSyncApplyChangesetResult, OfflineSyncApplyFileContentChunkResult, OfflineSyncApplySnapshotResult, OfflineSyncChange, OfflineSyncChangeset, OfflineSyncConflict, OfflineSyncFileContentChunk, OfflineSyncFileDigest, OfflineSyncFileRecord, OfflineSyncFileState, OfflineSyncFileTarget, OfflineSyncFileWriteTarget, OfflineSyncSnapshot, OfflineSyncState, applyOfflineSyncChangeset, applyOfflineSyncFileContentChunk, applyOfflineSyncSnapshot, buildOfflineSyncChangeset, buildOfflineSyncChangesetFromSnapshot, buildOfflineSyncSnapshot, buildOfflineSyncSnapshotForPaths, buildOfflineSyncSnapshotFromBase, defaultOfflineSyncStatePath, fileStatesFromSnapshot, iterateOfflineSyncSnapshotFileRecords, normalizeOfflineSyncChangeset, normalizeOfflineSyncSnapshot, offlineSyncStateFromSnapshot, readOfflineSyncFileContentChunk, readOfflineSyncState, shouldPreferIncomingOfflineRuntimeFile, summarizeOfflineSyncChangeset, summarizeOfflineSyncPendingChanges, summarizeOfflineSyncPendingFiles, writeOfflineSyncState } from './offline-sync.js';
-import { D as DiscoveredExtension } from './semantic-consolidation-4HkHWgeI.js';
-export { E as ExtensionSchema, R as REMNIC_EXTENSIONS_TOTAL_TOKEN_LIMIT, b as buildExtensionsBlockForConsolidation, d as discoverMemoryExtensions, r as resolveExtensionsRoot } from './semantic-consolidation-4HkHWgeI.js';
+import { D as DiscoveredExtension } from './semantic-consolidation-FbhPeJjB.js';
+export { E as ExtensionSchema, R as REMNIC_EXTENSIONS_TOTAL_TOKEN_LIMIT, b as buildExtensionsBlockForConsolidation, d as discoverMemoryExtensions, r as resolveExtensionsRoot } from './semantic-consolidation-FbhPeJjB.js';
 export { ConnectorCapability, ConnectorInstance, ConnectorManifest, ConnectorRegistry, DoctorCheck, DoctorResult, InstallOptions, InstallResult, MARKETPLACE_MANIFEST_FILENAME, MARKETPLACE_SCHEMA_VERSION, MarketplaceConfig, MarketplaceEntry, MarketplaceInstallResult, MarketplaceInstallType, MarketplaceLogger, MarketplaceManifest, MarketplaceValidation, RemoveResult, checkMarketplaceManifest, coerceInstallExtension, doctorConnector, generateMarketplaceManifest, getConnectorToken, installConnector, installFromMarketplace, listConnectors, loadRegistry, removeConnector, saveRegistry, validateMarketplaceManifest, writeMarketplaceManifest } from './connectors/index.js';
 import { L as LiveConnector, S as SyncIncrementalResult } from './framework-CNDn2164.js';
 export { c as CONNECTOR_ID_PATTERN, C as ConnectorConfig, b as ConnectorCursor, a as ConnectorDocument, d as ConnectorDocumentSource, e as SyncIncrementalArgs, i as isValidConnectorId, p as persistableConnectorConfig, r as redactConnectorConfigSecrets } from './framework-CNDn2164.js';
@@ -75,7 +76,7 @@ export { EnrichmentAuditEntry, EnrichmentCandidate, EnrichmentCostTier, Enrichme
 export { d as BulkImportError, B as BulkImportOptions, b as BulkImportResult, a as BulkImportSource, e as BulkImportSourceAdapter, f as ImportSourceRole, I as ImportTurn, g as ImportTurnValidationIssue, i as isImportRole, p as parseIsoTimestamp, v as validateImportTurn } from './types-BliCnURB.js';
 export { clearBulkImportSources, getBulkImportSource, listBulkImportSources, registerBulkImportSource } from './bulk-import/index.js';
 export { a as ProcessBatchContext, P as ProcessBatchFn, b as ProcessBatchResult, f as formatBatchTranscript, r as resolveBulkImportContext, c as runBulkImportPipeline, v as validateBatchSize } from './pipeline-D18UAKlN.js';
-export { B as BulkImportCliCommandOptions, p as parseStrictCliDate, r as runBulkImportCliCommand } from './cli-Cw729yLf.js';
+export { B as BulkImportCliCommandOptions, p as parseStrictCliDate, r as runBulkImportCliCommand } from './cli-EZv6YE6_.js';
 export { DEFAULT_IMPORT_BATCH_SIZE, ImportProgress, ImportedMemory, ImporterAdapter, ImporterParseOptions, ImporterTransformOptions, ImporterWriteResult, ImporterWriteTarget, RunImportOptions, RunImporterResult, defaultWriteMemoriesToOrchestrator, importedMemoryToTurn, runImporter, validateImportBatchSize, validateImportRateLimit } from './importers/index.js';
 export { FallbackLlmClient, FallbackLlmOptions, FallbackLlmResponse, FallbackLlmRuntimeContext } from './fallback-llm.js';
 export { ComputeMemoryWorthInput, MemoryWorthResult, computeMemoryWorth } from './memory-worth.js';
@@ -1959,6 +1960,303 @@ declare function getTaxonomyDir(memoryDir: string): string;
  */
 declare function getTaxonomyFilePath(memoryDir: string): string;
 
+/**
+ * Error thrown by wearables surfaces for caller-correctable problems:
+ * invalid parameters, unknown sources, disabled subsystem, missing
+ * connector packages. Transport layers map this to 400-class responses;
+ * anything else is a backend fault and bubbles to the 500 handler.
+ */
+declare class WearablesInputError extends Error {
+    constructor(message: string);
+}
+/**
+ * Render a caught error for operator-facing sync warnings and auth
+ * details. Warnings travel back through CLI/MCP/HTTP responses, so
+ * foreign error text never passes through — delegation to the
+ * project-standard `displayErrorDetail` exposes only the error class
+ * and Node errno code. Wearables' own input errors (authored messages,
+ * no foreign text) pass through verbatim.
+ */
+declare function describeErrorForOperator(err: unknown): string;
+
+/**
+ * Wearables config parsing — strict, loud, and default-safe.
+ *
+ * Mirrors the `procedural` block conventions in config.ts: shape
+ * violations and unparseable values throw with actionable messages
+ * (CLAUDE.md rule 51); boolean-ish strings coerce via the shared
+ * helpers (rule 36); every numeric knob is bounds-checked; the
+ * memory-creation default is the least-privileged mode (rule 48).
+ */
+
+declare const KNOWN_WEARABLE_SOURCE_IDS: readonly ["limitless", "bee", "omi"];
+declare function defaultWearableCleanupSettings(): WearableCleanupSettings;
+declare function defaultWearableSourceSettings(): WearableSourceSettings;
+declare function defaultWearablesConfig(): WearablesConfig;
+/**
+ * Parse the `wearables` config block. `undefined` yields the disabled
+ * default config; any present-but-malformed value throws.
+ */
+declare function parseWearablesConfig(value: unknown): WearablesConfig;
+
+/**
+ * Wearable connector registry.
+ *
+ * Concrete connectors live in optional à-la-carte packages and register
+ * a factory here (directly, or via the built-in loader below which
+ * dynamic-imports the known packages with computed specifiers so
+ * bundlers and the dts resolver never require them at build time).
+ */
+
+interface WearableConnectorFactoryOptions {
+    settings: WearableSourceSettings;
+    /** IANA timezone transcripts are bucketed in. */
+    timezone: string;
+}
+type WearableConnectorFactory = (options: WearableConnectorFactoryOptions) => WearableSourceConnector;
+interface WearableConnectorRegistration {
+    id: string;
+    displayName: string;
+    factory: WearableConnectorFactory;
+}
+declare function registerWearableConnector(registration: WearableConnectorRegistration): void;
+declare function getWearableConnector(id: string): WearableConnectorRegistration | undefined;
+declare function listWearableConnectors(): string[];
+/** Test-only: reset the registry between cases. */
+declare function clearWearableConnectors(): void;
+declare function ensureBuiltInWearableConnectors(): Promise<void>;
+
+/**
+ * Wearable transcript cleanup — deterministic, zero-LLM normalization.
+ *
+ * ASR output from always-on wearables is noisy: fragmented utterances,
+ * filler tokens, stuttered repeats, and occasional pure garbage. This
+ * module cleans a conversation in place-order without changing meaning:
+ * everything here is conservative and reversible by re-syncing.
+ */
+
+interface CleanupResult {
+    conversation: WearableConversation;
+    /** Segments removed by the low-quality heuristic. */
+    droppedSegments: number;
+    /** Segments merged into a predecessor. */
+    mergedSegments: number;
+}
+/** Apply configured cleanup passes to one conversation. */
+declare function cleanConversation(conversation: WearableConversation, settings: WearableCleanupSettings): CleanupResult;
+declare function stripFillerTokens(text: string): string;
+/**
+ * Collapse immediate word/phrase stutters: "I I I think" -> "I think",
+ * "we should we should go" -> "we should go". Only collapses *adjacent*
+ * repeats (up to 4-word phrases) so intentional repetition across a
+ * sentence is preserved.
+ */
+declare function collapseImmediateRepeats(text: string): string;
+/**
+ * Heuristic ASR-garbage detector. Intentionally conservative: it only
+ * drops segments that carry no plausible information.
+ */
+declare function isLowQualitySegment(text: string): boolean;
+
+/**
+ * Wearable transcript redaction — privacy guard applied before any
+ * transcript text is persisted or fed to extraction.
+ *
+ * Always-on recorders capture things nobody intended to store: card
+ * numbers read aloud, SSNs dictated to a pharmacy line. Built-in
+ * patterns cover the unambiguous, high-sensitivity cases; users can add
+ * their own regexes via `wearables.redactionPatterns` (validated at
+ * config parse — invalid patterns are rejected loudly, never ignored).
+ *
+ * All built-in patterns are simple linear scans (no nested quantifiers)
+ * to stay safely outside polynomial-ReDoS territory.
+ */
+
+declare const REDACTION_PLACEHOLDER = "[redacted]";
+interface RedactionResult {
+    text: string;
+    redactions: number;
+}
+declare function redactText(text: string, userPatterns: RegExp[]): RedactionResult;
+/**
+ * Compile user-supplied redaction patterns. Throws with a descriptive
+ * message on the first invalid pattern — config parsing surfaces this
+ * to the operator instead of silently skipping the rule.
+ */
+declare function compileRedactionPatterns(patterns: string[]): RegExp[];
+interface OffTheRecordResult {
+    conversation: WearableConversation;
+    droppedSegments: number;
+}
+/**
+ * Drop segments between a spoken "off the record" marker and the next
+ * "(back) on the record" marker (or conversation end). The marker
+ * segments themselves are kept, with the off-record span replaced by a
+ * visible placeholder so the transcript shows that content was elided
+ * by request rather than lost.
+ */
+declare function applyOffTheRecord(conversation: WearableConversation): OffTheRecordResult;
+
+/**
+ * Wearable transcript corrections — user-specific replacement rules.
+ *
+ * ASR engines consistently mishear the same proper nouns for the same
+ * person ("remnick" for "Remnic", a colleague's name, product jargon).
+ * Rules come from two places, merged at sync time:
+ *
+ *  1. `wearables.corrections` in plugin config (declarative, versioned
+ *     with the operator's config).
+ *  2. A CLI-managed rules file at `state/wearables/corrections.json`
+ *     (added interactively via `remnic wearables corrections add`).
+ *
+ * Literal rules are regex-escaped before compilation and replacements
+ * are applied via a function (never a replacement string) so `$` in
+ * either side can't corrupt output.
+ */
+
+interface CompiledCorrectionRule {
+    rule: WearableCorrectionRule;
+    pattern: RegExp;
+}
+interface CorrectionApplication {
+    text: string;
+    applied: number;
+}
+/**
+ * Validate and compile a correction rule. Throws a descriptive error on
+ * invalid input (empty match, regex that doesn't compile, regex that
+ * matches the empty string) — callers surface this at config parse or
+ * CLI time rather than skipping the rule silently.
+ */
+declare function compileCorrectionRule(rule: WearableCorrectionRule, label: string): CompiledCorrectionRule;
+/** Compile a rule list, labeling errors with their index. */
+declare function compileCorrectionRules(rules: WearableCorrectionRule[], labelPrefix: string): CompiledCorrectionRule[];
+/** Apply every applicable rule to a piece of transcript text. */
+declare function applyCorrections(text: string, rules: CompiledCorrectionRule[], sourceId: string): CorrectionApplication;
+declare function correctionsFilePath(memoryDir: string): string;
+/**
+ * Load CLI-managed correction rules. A missing file means no rules; a
+ * malformed file throws (operators should know their corrections are
+ * not being applied rather than silently losing them).
+ */
+declare function loadCorrectionsFile(memoryDir: string): Promise<WearableCorrectionRule[]>;
+/** Persist CLI-managed rules atomically (temp file + rename). */
+declare function saveCorrectionsFile(memoryDir: string, rules: WearableCorrectionRule[]): Promise<void>;
+
+/**
+ * Wearable day-transcript composition and parsing.
+ *
+ * One markdown file per source per day, stored under
+ * `<memoryDir>/wearables/<source>/<YYYY-MM-DD>.md` with YAML
+ * frontmatter. The location is deliberate:
+ *
+ *  - it is OUTSIDE the memory scan roots (facts/, procedures/,
+ *    reasoning-traces/, corrections/), so transcripts never appear as
+ *    memories in recall or governance passes;
+ *  - it is INSIDE the QMD collection root (the memory dir), so day
+ *    transcripts are full-text searchable after the next index update.
+ *
+ * Files are rebuilt idempotently from provider data on every sync; the
+ * body hash in frontmatter lets the pipeline skip rewriting (and
+ * re-extracting) unchanged days.
+ *
+ * This module is pure composition/parsing — file IO lives in
+ * `StorageManager` so encrypted-at-rest deployments and atomic write
+ * semantics are inherited from the same code paths memories use.
+ */
+
+declare const WEARABLES_DIR_NAME = "wearables";
+declare function isValidTranscriptDate(date: string): boolean;
+declare function hashTranscriptBody(body: string): string;
+/** Compose the markdown body (no frontmatter) for one source/day. */
+declare function composeDayTranscriptBody(sourceId: string, date: string, timezone: string, conversations: WearableConversation[], registry: SpeakerRegistry): string;
+declare function composeDayTranscriptMeta(sourceId: string, date: string, timezone: string, conversations: WearableConversation[], registry: SpeakerRegistry, body: string, syncedAt: string): WearableDayTranscriptMeta;
+/** Serialize meta + body into the persisted file format. */
+declare function serializeDayTranscript(meta: WearableDayTranscriptMeta, body: string): string;
+/**
+ * Parse a persisted day-transcript file. Returns null when the content
+ * does not look like a wearable transcript (wrong kind, missing
+ * frontmatter) so callers can distinguish "not a transcript" from a
+ * read error.
+ */
+declare function parseDayTranscript(raw: string): WearableDayTranscript | null;
+
+/**
+ * Wearable sync-state ledger — per-source bookkeeping for incremental
+ * syncs, stored at `state/wearables/sync.json`.
+ *
+ * State is written only AFTER a source's transcripts (and any memories)
+ * were persisted successfully, so a failed sync never advances the
+ * watermark past data that didn't land.
+ */
+interface WearableSourceSyncState {
+    /** ISO timestamp of the last successful sync run. */
+    lastSyncAt: string;
+    /** Most recent day (YYYY-MM-DD) that was synced. */
+    lastDateSynced: string;
+    /** Body hashes of the last-written day files, keyed by date. */
+    dayHashes: Record<string, string>;
+    /**
+     * Body hashes of days whose memory-extraction pass completed without
+     * warnings, keyed by date. A day whose entry is missing or stale
+     * re-extracts on the next sync even when its transcript is unchanged
+     * — this is how a memory pass that failed mid-run (transcript stored,
+     * memories incomplete) self-heals. Absent on records written before
+     * this field existed.
+     */
+    memoryDayHashes?: Record<string, string>;
+    /** Native-memory ids already imported (bounded, newest kept). */
+    importedNativeMemoryIds: string[];
+}
+interface WearableSyncStateFile {
+    version: 1;
+    sources: Record<string, WearableSourceSyncState>;
+}
+declare function syncStateFilePath(memoryDir: string): string;
+declare function emptySyncState(): WearableSyncStateFile;
+declare function loadSyncState(memoryDir: string): Promise<WearableSyncStateFile>;
+declare function saveSyncState(memoryDir: string, state: WearableSyncStateFile): Promise<void>;
+/** Merge a completed source sync into the state file shape. */
+declare function updateSourceSyncState(state: WearableSyncStateFile, sourceId: string, update: {
+    syncedAt: string;
+    days: string[];
+    dayHashes: Record<string, string>;
+    /** Days whose memory pass completed cleanly this run. */
+    memoryDayHashes?: Record<string, string>;
+    /**
+     * Days whose memory pass ran this sync but did NOT complete
+     * cleanly. Their previous completion records are removed so a
+     * stale hash from an earlier clean pass can never mask the
+     * failure on the next sync.
+     */
+    clearMemoryDays?: string[];
+    importedNativeMemoryIds?: string[];
+}): WearableSyncStateFile;
+
+/**
+ * Wearables CLI runner — one implementation shared by every CLI host
+ * (`remnic wearables ...` and `openclaw engram wearables ...`), so the
+ * surfaces never fork (same rule as the recall-explain renderers).
+ *
+ * Flag validation is strict: every value-taking flag requires a value,
+ * unknown flags error with the valid list, and invalid values reject
+ * loudly (CLAUDE.md rules 14 + 51).
+ */
+
+interface WearablesCliIo {
+    stdout: {
+        write(chunk: string): unknown;
+    };
+    stderr: {
+        write(chunk: string): unknown;
+    };
+}
+/**
+ * Run a wearables CLI command. Returns a process exit code; all output
+ * goes through `io`.
+ */
+declare function runWearablesCliCommand(service: WearablesService, args: string[], io: WearablesCliIo): Promise<number>;
+
 /**
  * Training-data export types.
  *
@@ -2148,4 +2446,4 @@ declare function forkCapsule(opts: ForkCapsuleOptions): Promise<ForkCapsuleResul
  */
 declare function readForkLineage(targetRoot: string, forkId: string): Promise<ForkLineage | null>;
 
-export { type AuditEntry, type BinaryAssetRecord, type BinaryAssetStatus, type BinaryLifecycleConfig, type BinaryLifecycleManifest, type BinaryStorageBackend, type BinaryStorageBackendConfig, ClaudeCodeMemoryExtensionPublisher, CodexMemoryExtensionPublisher, type CodingNamespaceOverlay, type CodingScopeDescription, type ConflictEntry, type ContradictionOptions, type ContradictionPair, type ContradictionResult$1 as CurateContradictionResult, type DuplicateResult as CurateDuplicateResult, type CurateOptions, type CurateResult, type CuratedStatement, DEFAULT_GRACE_PERIOD_DAYS, DEFAULT_MAX_BINARY_SIZE_BYTES, DEFAULT_SCAN_PATTERNS, DEFAULT_TAXONOMY, type DedupOptions, type DedupResult, DiscoveredExtension, type DocFile, type DriveChange, type DriveChangesPage, type DriveFileMetadata, type DuplicatePair, type FileChange, FilesystemBackend, type ForkCapsuleOptions, type ForkCapsuleResult, type ForkLineage, GOOGLE_DRIVE_CONNECTOR_ID, GOOGLE_DRIVE_CURSOR_KIND, DEFAULT_POLL_INTERVAL_MS as GOOGLE_DRIVE_DEFAULT_POLL_INTERVAL_MS, type GenerateOptions, type GenerateResult, type GitContext, type GitInvoker, type GoogleDriveClient, type GoogleDriveClientFactory, type GoogleDriveConnectorConfig, type GoogleDriveSyncResult, HermesMemoryExtensionPublisher, type IngestionPlan, type LanguageInfo, LiveConnector, LiveConnectorRegistry, LiveConnectorRegistryError, MemoryCategory, type MemoryEntry, type MemoryExtensionPublisher, type MergeResult, NOTION_CONNECTOR_ID, NOTION_CURSOR_KIND, NOTION_DEFAULT_POLL_INTERVAL_MS, NoneBackend, type NotionConnectorConfig, type OnboardOptions, type OnboardResult, PUBLISHERS, type PipelineResult, PluginConfig, type ProjectShape, type ProvenanceEntry, type PublishContext, type PublishResult, type PublisherCapabilities, REMNIC_CITATION_FORMAT, REMNIC_MCP_TOOL_INVENTORY, REMNIC_RECALL_DECISION_RULES, REMNIC_SEMANTIC_OVERVIEW, ResolverDecision, type ReviewAction, type ReviewCandidate, type ReviewContext, type ReviewItem, type ReviewListResult, type ReviewOptions, type ReviewResult, type Space, type SpaceKind, type SpaceManifest, type SpacePromoteResult, type SpacePullResult, type SpacePushResult, type SpaceShareResult, type SpaceSwitchResult, type StatementProvenance, StorageManager, SyncIncrementalResult, type SyncOptions, type SyncResult, type SyncState, Taxonomy, TokenEntry, type TrainingExportAdapter, type TrainingExportOptions, type TrainingExportRecord, type TreeNode, branchNamespaceName, buildProcedureMarkdownBody, buildProcedureRecallSection, clearTrainingExportAdapters, convertMemoriesToRecords, createBackend, createGoogleDriveConnector, createNotionConnector, createSpace, curate, defaultGoogleDriveClientFactory, deleteSpace, describeCodingScope, emptyManifest, expandTildePath, findContradictions, findDuplicates, forkCapsule, generateContextTree, generateResolverDocument, getActiveSpace, getAuditLog, getManifestPath, getSpacesDir, getTaxonomyDir, getTaxonomyFilePath, getTrainingExportAdapter, hostIdForConnector, isReviewPrompt, listReviewItems, listSpaces, listTrainingExportAdapters, loadManifest, loadTaxonomy, manifestDir, manifestPath, matchesPatterns, mergeSpaces, normalizeOriginUrl, onboard, packReviewContext, parseFlexibleIsoTimestamp, parseIsoOffsetTimestamp, parseIsoUtcTimestamp, parseProcedureStepsFromBody, parseTouchedFiles, performReview, projectNamespaceName, promoteSpace, publisherFor, publisherForConnector, pullFromSpace, pushToSpace, rankReviewCandidates, readForkLineage, readManifest, registerPublisher, registerTrainingExportAdapter, renderExtensionsBlock, renderExtensionsFooter, resolveCategory, resolveCodingNamespaceOverlay, resolveGitContext, runBinaryLifecyclePipeline, saveManifest, saveTaxonomy, scanForBinaries, shareSpace, stableHash, switchSpace, syncChanges, validateGoogleDriveConfig, validateNotionConfig, validateSlug, validateTaxonomy, watchForChanges, writeManifest };
+export { type AuditEntry, type BinaryAssetRecord, type BinaryAssetStatus, type BinaryLifecycleConfig, type BinaryLifecycleManifest, type BinaryStorageBackend, type BinaryStorageBackendConfig, ClaudeCodeMemoryExtensionPublisher, type CleanupResult, CodexMemoryExtensionPublisher, type CodingNamespaceOverlay, type CodingScopeDescription, type CompiledCorrectionRule, type ConflictEntry, type ContradictionOptions, type ContradictionPair, type ContradictionResult$1 as CurateContradictionResult, type DuplicateResult as CurateDuplicateResult, type CurateOptions, type CurateResult, type CuratedStatement, DEFAULT_GRACE_PERIOD_DAYS, DEFAULT_MAX_BINARY_SIZE_BYTES, DEFAULT_SCAN_PATTERNS, DEFAULT_TAXONOMY, type DedupOptions, type DedupResult, DiscoveredExtension, type DocFile, type DriveChange, type DriveChangesPage, type DriveFileMetadata, type DuplicatePair, type FileChange, FilesystemBackend, type ForkCapsuleOptions, type ForkCapsuleResult, type ForkLineage, GOOGLE_DRIVE_CONNECTOR_ID, GOOGLE_DRIVE_CURSOR_KIND, DEFAULT_POLL_INTERVAL_MS as GOOGLE_DRIVE_DEFAULT_POLL_INTERVAL_MS, type GenerateOptions, type GenerateResult, type GitContext, type GitInvoker, type GoogleDriveClient, type GoogleDriveClientFactory, type GoogleDriveConnectorConfig, type GoogleDriveSyncResult, HermesMemoryExtensionPublisher, type IngestionPlan, KNOWN_WEARABLE_SOURCE_IDS, type LanguageInfo, LiveConnector, LiveConnectorRegistry, LiveConnectorRegistryError, MemoryCategory, type MemoryEntry, type MemoryExtensionPublisher, type MergeResult, NOTION_CONNECTOR_ID, NOTION_CURSOR_KIND, NOTION_DEFAULT_POLL_INTERVAL_MS, NoneBackend, type NotionConnectorConfig, type OnboardOptions, type OnboardResult, PUBLISHERS, type PipelineResult, PluginConfig, type ProjectShape, type ProvenanceEntry, type PublishContext, type PublishResult, type PublisherCapabilities, REDACTION_PLACEHOLDER, REMNIC_CITATION_FORMAT, REMNIC_MCP_TOOL_INVENTORY, REMNIC_RECALL_DECISION_RULES, REMNIC_SEMANTIC_OVERVIEW, ResolverDecision, type ReviewAction, type ReviewCandidate, type ReviewContext, type ReviewItem, type ReviewListResult, type ReviewOptions, type ReviewResult, type Space, type SpaceKind, type SpaceManifest, type SpacePromoteResult, type SpacePullResult, type SpacePushResult, type SpaceShareResult, type SpaceSwitchResult, SpeakerRegistry, type StatementProvenance, StorageManager, SyncIncrementalResult, type SyncOptions, type SyncResult, type SyncState, Taxonomy, TokenEntry, type TrainingExportAdapter, type TrainingExportOptions, type TrainingExportRecord, type TreeNode, WEARABLES_DIR_NAME, WearableCleanupSettings, type WearableConnectorFactory, type WearableConnectorFactoryOptions, type WearableConnectorRegistration, WearableConversation, WearableCorrectionRule, WearableDayTranscript, WearableDayTranscriptMeta, WearableSourceConnector, WearableSourceSettings, type WearableSourceSyncState, type WearableSyncStateFile, type WearablesCliIo, WearablesConfig, WearablesInputError, WearablesService, applyCorrections, applyOffTheRecord, branchNamespaceName, buildProcedureMarkdownBody, buildProcedureRecallSection, cleanConversation, clearTrainingExportAdapters, clearWearableConnectors, collapseImmediateRepeats, compileCorrectionRule, compileCorrectionRules, compileRedactionPatterns, composeDayTranscriptBody, composeDayTranscriptMeta, convertMemoriesToRecords, correctionsFilePath, createBackend, createGoogleDriveConnector, createNotionConnector, createSpace, curate, defaultGoogleDriveClientFactory, defaultWearableCleanupSettings, defaultWearableSourceSettings, defaultWearablesConfig, deleteSpace, describeCodingScope, describeErrorForOperator, emptyManifest, emptySyncState, ensureBuiltInWearableConnectors, expandTildePath, findContradictions, findDuplicates, forkCapsule, generateContextTree, generateResolverDocument, getActiveSpace, getAuditLog, getManifestPath, getSpacesDir, getTaxonomyDir, getTaxonomyFilePath, getTrainingExportAdapter, getWearableConnector, hashTranscriptBody, hostIdForConnector, isLowQualitySegment, isReviewPrompt, isValidTranscriptDate, listReviewItems, listSpaces, listTrainingExportAdapters, listWearableConnectors, loadCorrectionsFile, loadManifest, loadSyncState, loadTaxonomy, manifestDir, manifestPath, matchesPatterns, mergeSpaces, normalizeOriginUrl, onboard, packReviewContext, parseDayTranscript, parseFlexibleIsoTimestamp, parseIsoOffsetTimestamp, parseIsoUtcTimestamp, parseProcedureStepsFromBody, parseTouchedFiles, parseWearablesConfig, performReview, projectNamespaceName, promoteSpace, publisherFor, publisherForConnector, pullFromSpace, pushToSpace, rankReviewCandidates, readForkLineage, readManifest, redactText, registerPublisher, registerTrainingExportAdapter, registerWearableConnector, renderExtensionsBlock, renderExtensionsFooter, resolveCategory, resolveCodingNamespaceOverlay, resolveGitContext, runBinaryLifecyclePipeline, runWearablesCliCommand, saveCorrectionsFile, saveManifest, saveSyncState, saveTaxonomy, scanForBinaries, serializeDayTranscript, shareSpace, stableHash, stripFillerTokens, switchSpace, syncChanges, syncStateFilePath, updateSourceSyncState, validateGoogleDriveConfig, validateNotionConfig, validateSlug, validateTaxonomy, watchForChanges, writeManifest };