@remnic/core 1.1.30 → 9.3.515

package/dist/index.d.ts

@@ -1,8 +1,7 @@
-export { LEGACY_PLUGIN_ID, PLUGIN_ID, resolveRemnicPluginEntry } from './plugin-id.js';
+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';
-import { d as BulkImportSourceAdapter, I as ImportTurn } from './orchestrator-DuWl9Hwx.js';
-export { e as BulkImportError, a as BulkImportOptions, b as BulkImportResult, B as BulkImportSource, f as ImportSourceRole, g as ImportTurnValidationIssue, O as Orchestrator, h as defaultWorkspaceDir, i as isImportRole, p as parseIsoTimestamp, s as sanitizeSessionKeyForFilename, v as validateImportTurn } from './orchestrator-DuWl9Hwx.js';
+export { O as Orchestrator, d as defaultWorkspaceDir, s as sanitizeSessionKeyForFilename } from './orchestrator-Co9nxRLF.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';
@@ -23,8 +22,7 @@ import { PluginConfig, CodingContext, CodingModeConfig, MemoryCategory } from '.
 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';
 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';
-import { P as PeerInteractionLogEntry, b as Peer, c as PeerProfile } from './access-service-B5hgZPCN.js';
-export { d as EngramAccessInputError, E as EngramAccessService, e as PEER_ID_MAX_LENGTH, f as PEER_ID_PATTERN, g as PeerKind, h as PeerProfileFieldProvenance, i as ProcedureStatsConfigSnapshot, j as ProcedureStatsRecent, k as ProcedureStatsReport, l as ProcedureStatusCounts, m as computeProcedureStats, n as formatProcedureStatsText } from './access-service-B5hgZPCN.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-qrrIrC-0.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';
@@ -57,14 +55,14 @@ 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-VwGI14Ok.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, normalizeOfflineSyncChangeset, normalizeOfflineSyncSnapshot, offlineSyncStateFromSnapshot, readOfflineSyncFileContentChunk, readOfflineSyncState, shouldPreferIncomingOfflineRuntimeFile, summarizeOfflineSyncChangeset, summarizeOfflineSyncPendingChanges, summarizeOfflineSyncPendingFiles, writeOfflineSyncState } from './offline-sync.js';
+export { b as SemanticDedupDecision, S as SemanticDedupHit, a as SemanticDedupLookup, c as SemanticDedupOptions, d as decideSemanticDedup } from './semantic-SLAa_prH.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';
 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-CyHYDcri.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 } from './framework-CyHYDcri.js';
-export { b as CONNECTORS_OUTPUT_FORMATS, c as ConnectorRow, C as ConnectorRunResult, d as ConnectorState, e as ConnectorSyncStatus, a as ConnectorsOutputFormat, P as ParsedConnectorsListOptions, f as ParsedConnectorsStatusOptions, R as RunConnectorPollOnceArgs, l as listConnectorStates, p as parseConnectorsFormat, g as parseConnectorsListOptions, h as parseConnectorsRunName, i as parseConnectorsStatusOptions, r as readConnectorState, j as renderConnectorsList, k as renderConnectorsRunResult, m as runConnectorPollOnce, w as writeConnectorState } from './connectors-cli-CwbyjGR7.js';
+export { b as CONNECTORS_OUTPUT_FORMATS, c as ConnectorRow, C as ConnectorRunResult, d as ConnectorState, e as ConnectorSyncStatus, a as ConnectorsOutputFormat, P as ParsedConnectorsListOptions, f as ParsedConnectorsStatusOptions, R as RunConnectorPollOnceArgs, l as listConnectorStates, p as parseConnectorsFormat, g as parseConnectorsListOptions, h as parseConnectorsRunName, i as parseConnectorsStatusOptions, r as readConnectorState, j as renderConnectorsList, k as renderConnectorsRunResult, m as runConnectorPollOnce, w as writeConnectorState } from './connectors-cli-DbTPNj2H.js';
 export { LiveConnectorDefinition, LiveConnectorRunItem, LiveConnectorSkipReason, LiveConnectorsRunSummary, builtInLiveConnectorDefinitions, hasEnabledLiveConnector, runLiveConnectorsOnce } from './live-connectors-runner.js';
 import { TokenEntry } from './tokens.js';
 export { TokenStore, generateToken, getAllValidTokens, getAllValidTokensCached, listTokens, loadTokenStore, resolveConnectorFromToken, revokeToken, saveTokenStore } from './tokens.js';
@@ -73,7 +71,11 @@ export { MATERIALIZE_VERSION, MaterializeOptions, MaterializeResult, RolloutSumm
 import { T as Taxonomy, R as ResolverDecision } from './types-DJhqDJUV.js';
 export { a as TaxonomyCategory } from './types-DJhqDJUV.js';
 export { EnrichmentAuditEntry, EnrichmentCandidate, EnrichmentCostTier, EnrichmentPipelineConfig, EnrichmentProvider, EnrichmentProviderConfig, EnrichmentProviderRegistry, EnrichmentResult, EntityEnrichmentInput, WebSearchFn, WebSearchProvider, WebSearchProviderOptions, appendAuditEntry, defaultEnrichmentPipelineConfig, readAuditLog, runEnrichmentPipeline } from './enrichment/index.js';
-export { B as BulkImportCliCommandOptions, P as ProcessBatchFn, a as ProcessBatchResult, f as formatBatchTranscript, p as parseStrictCliDate, r as runBulkImportCliCommand, b as runBulkImportPipeline } from './cli-CJKI2JIe.js';
+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-X4NJoqSe.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';
 export { MemoryOutcomeKind, RecordMemoryOutcomeInput, RecordMemoryOutcomeResult, memoryWorthOutcomeEligibleCategories, recordMemoryOutcome } from './memory-worth-outcomes.js';
@@ -83,6 +85,8 @@ export { GraphRecallConfig, GraphRecallOptions, GraphRecallResult, GraphRecallRu
 export { BudgetDecision, BudgetDecisionReason, CrossNamespaceBudget, CrossNamespaceBudgetConfig, DEFAULT_CROSS_NAMESPACE_BUDGET } from './cross-namespace-budget.js';
 export { AnomalyDetectorConfig, AnomalyDetectorInput, AnomalyDetectorResult, AnomalyFlag, AnomalyKind, AnomalySeverity, DEFAULT_ANOMALY_DETECTOR_CONFIG, detectRecallAnomalies, normalizeQueryText } from './recall-audit-anomaly.js';
 export { AccessAuditAdapter, AccessAuditConfig, AccessAuditResult } from './access-audit.js';
+export { c as PEER_ID_MAX_LENGTH, d as PEER_ID_PATTERN, a as Peer, P as PeerInteractionLogEntry, e as PeerKind, b as PeerProfile, f as PeerProfileFieldProvenance } from './types-B1VHaf2w.js';
+export { P as PEERS_DIR_NAME, a as appendInteractionLog, b as assertValidPeerId, l as listPeers, r as readInteractionLogRaw, c as readPeer, g as readPeerProfile, w as writePeer, h as writePeerProfile } from './storage-C4DX8CuG.js';
 import { ImportCapsuleResult } from './transfer/capsule-import.js';
 import { ExportManifestV2, CapsuleParent } from './transfer/types.js';
 import './search/port.js';
@@ -104,7 +108,7 @@ import './lcm/dag.js';
 import './lcm/queue.js';
 import './conversation-index/backend.js';
 import './conversation-index/chunker.js';
-import './faiss-adapter-CzPghc4C.js';
+import './faiss-adapter-BHecI1fF.js';
 import './runtime/child-process.js';
 import './shared-context/manager.js';
 import 'zod';
@@ -116,6 +120,7 @@ import './runtime/better-sqlite.js';
 import './policy-runtime.js';
 import './profiling.js';
 import './schemas.js';
+import './resolve-provider-secret.js';
 import './recall-explain-renderer.js';
 import './explicit-capture.js';
 import './graph-snapshot.js';
@@ -516,28 +521,6 @@ declare function renderExtensionsBlock(extensions: DiscoveredExtension[]): strin
  */
 declare function renderExtensionsFooter(extensions: DiscoveredExtension[]): string;
 
-/**
- * Register a source adapter. Rejects duplicate names and empty names.
- */
-declare function registerBulkImportSource(adapter: BulkImportSourceAdapter): void;
-/**
- * Retrieve a registered adapter by name.
- *
- * Names are trimmed on write (see `registerBulkImportSource`), so we
- * also trim on read to avoid the asymmetric-lookup footgun where a
- * whitespace-padded lookup would never find a registered adapter.
- * Non-string or empty-after-trim inputs return undefined.
- */
-declare function getBulkImportSource(name: string): BulkImportSourceAdapter | undefined;
-/**
- * List all registered adapter names.
- */
-declare function listBulkImportSources(): string[];
-/**
- * Clear all registered adapters (for testing).
- */
-declare function clearBulkImportSources(): void;
-
 /**
  * Strict UTC-only parser — accepts `YYYY-MM-DDTHH:MM:SS[.sss]Z`.
  * Returns milliseconds since epoch, or `null` if invalid.
@@ -998,6 +981,7 @@ declare class FilesystemBackend implements BinaryStorageBackend {
     readonly type = "filesystem";
     private readonly basePath;
     constructor(basePath: string);
+    private resolveRemotePath;
     upload(localPath: string, remotePath: string): Promise<string>;
     exists(remotePath: string): Promise<boolean>;
     delete(remotePath: string): Promise<void>;
@@ -1147,7 +1131,7 @@ declare function generateContextTree(options: GenerateOptions): Promise<Generate
  */
 interface OnboardOptions {
     /** Directory to scan (defaults to cwd) */
-    directory: string;
+    directory?: string;
     /** Max depth to walk (default: 6) */
     maxDepth?: number;
     /** Directories to skip */
@@ -1460,6 +1444,8 @@ interface SyncOptions {
     extensions?: string[];
     /** Directories to exclude */
     excludeDirs?: string[];
+    /** Poll interval for watchForChanges. Default: 5000ms */
+    pollIntervalMs?: number;
     /** Whether to actually write changes (default: true) */
     dryRun?: boolean;
 }
@@ -1506,7 +1492,7 @@ declare function syncChanges(options: SyncOptions): SyncResult;
  * Watch for changes and call callback on file changes.
  * Returns a stop function.
  */
-declare function watchForChanges(options: SyncOptions, onChange: (changes: FileChange[]) => void): {
+declare function watchForChanges(options: SyncOptions, onChange: (changes: FileChange[]) => void | Promise<void>): {
     stop: () => void;
 };
 
@@ -1955,244 +1941,6 @@ declare function getTaxonomyDir(memoryDir: string): string;
  */
 declare function getTaxonomyFilePath(memoryDir: string): string;
 
-/**
- * A single imported memory record with provenance.
- *
- * Every importer MUST attach a truthful `sourceLabel` (e.g. `"chatgpt"`,
- * `"claude"`, `"gemini"`, `"mem0"`) and MAY attach the export's origin path or
- * URL in `importedFromPath`. `importedAt` is always set by `runImporter` so
- * adapters do not need to timestamp records themselves.
- */
-interface ImportedMemory {
-    /**
-     * The user-facing memory content. This is the string that will eventually
-     * land in the memory store (after extraction / orchestrator processing).
-     */
-    content: string;
-    /**
-     * Source-specific identifier for idempotent re-imports. Optional — when
-     * present, adapters SHOULD use the source's stable id (e.g. ChatGPT memory
-     * uuid); when absent, the orchestrator's own content hashing provides dedup.
-     */
-    sourceId?: string;
-    /**
-     * Source-specific timestamp at which the memory was originally created or
-     * last updated. ISO 8601. Optional — adapters fall back to `importedAt`
-     * when the source does not expose a creation timestamp.
-     */
-    sourceTimestamp?: string;
-    /**
-     * Human-readable short label identifying the origin platform
-     * (`"chatgpt"`, `"claude"`, `"gemini"`, `"mem0"`). Required so the
-     * orchestrator can attribute recalled memories correctly.
-     */
-    sourceLabel: string;
-    /**
-     * Path to the export file the memory was parsed from, OR the endpoint URL
-     * for API-based imports. Optional but strongly recommended so users can
-     * trace a memory back to the file they imported.
-     */
-    importedFromPath?: string;
-    /**
-     * ISO 8601 timestamp set by `runImporter` immediately before writeTo().
-     * Adapters MAY populate this themselves; `runImporter` will fill in the
-     * current wall-clock time when absent.
-     */
-    importedAt?: string;
-    /**
-     * Adapter-specific raw metadata preserved for debugging / future rehydration
-     * (e.g. conversation id, thread id, tags). Must be JSON-serializable;
-     * adapters MUST NOT stash functions or circular references here.
-     */
-    metadata?: Record<string, unknown>;
-}
-/**
- * Options threaded through every importer run. Adapters receive this object
- * from `runImporter`; the top-level CLI populates it from `--dry-run`,
- * `--batch-size`, and `--rate-limit` flags.
- */
-interface RunImportOptions {
-    /**
-     * When true, parse + transform but skip writeTo(). `runImporter` prints a
-     * summary of what WOULD have been imported and returns early.
-     */
-    dryRun?: boolean;
-    /**
-     * Target batch size for writeTo(). Adapters that chunk memories into
-     * smaller orchestrator calls should honor this. Defaults to
-     * `DEFAULT_IMPORT_BATCH_SIZE` when undefined. Values outside the valid
-     * range throw from `validateImportBatchSize`.
-     */
-    batchSize?: number;
-    /**
-     * Optional rate limit for API-backed importers (mem0). Expressed as
-     * requests-per-second. Adapters that do not hit an external API may ignore
-     * this. When provided, `validateImportRateLimit` enforces the positive-
-     * finite contract.
-     */
-    rateLimit?: number;
-    /**
-     * Invoked after every chunk of memories is processed. `total` is the full
-     * count of memories produced by `transform`; `processed` counts memories
-     * already ingested (or skipped in dry-run mode). Adapters SHOULD call this
-     * incrementally — `runImporter` itself calls it once per batch.
-     */
-    onProgress?: (progress: ImportProgress) => void;
-}
-interface ImportProgress {
-    processed: number;
-    total: number;
-    /** Current phase for human-readable logging. */
-    phase: "parse" | "transform" | "write" | "dry-run";
-}
-/**
- * Interface every importer package implements.
- *
- * The three-method surface intentionally mirrors the issue #568 spec:
- *
- *   - `parse(input)`: raw payload → intermediate representation.
- *   - `transform(parsed)`: intermediate representation → `ImportedMemory[]`.
- *   - `writeTo(target, memories, options)`: actually commit to the
- *     orchestrator (or whatever target the host provides).
- *
- * Adapters MAY keep `parse` and `transform` separate (e.g. ChatGPT conversions
- * that need to split saved-memories from conversation summaries) or collapse
- * them into a single operation — what matters is that the combined pipeline
- * produces an array of `ImportedMemory` records with correct provenance.
- *
- * `Parsed` is generic so strongly-typed intermediate shapes survive through
- * the adapter's own code without leaking to callers of `runImporter`.
- */
-interface ImporterAdapter<Parsed = unknown> {
-    /** Short stable name used by `remnic import --adapter <name>`. */
-    name: string;
-    /** Human-readable label surfaced in CLI output and source attribution. */
-    sourceLabel: string;
-    /**
-     * Parse a raw payload (file contents, API response, etc.) into the adapter
-     * intermediate representation. Pure — MUST NOT call the orchestrator.
-     */
-    parse(input: unknown, options?: ImporterParseOptions): Parsed | Promise<Parsed>;
-    /**
-     * Flatten parsed input into an array of importable memories. Pure — MUST
-     * NOT call the orchestrator. Provenance fields (`sourceLabel`,
-     * `importedFromPath`) should be populated here.
-     */
-    transform(parsed: Parsed, options?: ImporterTransformOptions): ImportedMemory[] | Promise<ImportedMemory[]>;
-    /**
-     * Commit the transformed memories to the orchestrator (or equivalent
-     * target). `runImporter` only invokes this when dryRun is false.
-     *
-     * Adapters typically call `orchestrator.ingestBulkImportBatch` once per
-     * batch after converting `ImportedMemory` records into `ImportTurn` shapes.
-     */
-    writeTo(target: ImporterWriteTarget, memories: ImportedMemory[], options: RunImportOptions): Promise<ImporterWriteResult>;
-}
-/**
- * Shape of the "target" passed to `writeTo`.
- *
- * This is intentionally narrower than the full `Orchestrator` class: importer
- * adapters only need to push `ImportTurn[]` batches and read the active
- * bulk-import namespace. Narrowing keeps test doubles simple (the slice-1
- * integration test uses a pure in-memory mock) and prevents adapters from
- * reaching into orchestrator internals that would make them harder to move
- * between host environments.
- */
-interface ImporterWriteTarget {
-    ingestBulkImportBatch(turns: ImportTurn[], options?: {
-        deadlineMs?: number;
-    }): Promise<void>;
-    bulkImportWriteNamespace?(): string;
-}
-interface ImporterWriteResult {
-    memoriesIngested: number;
-    /** Optional: adapter-surfaced duplicates or skipped entries. */
-    skipped?: number;
-}
-/** Options forwarded to `parse`. Adapter-specific; additive by design. */
-interface ImporterParseOptions {
-    strict?: boolean;
-    /** Source path passed through for provenance. */
-    filePath?: string;
-    /**
-     * Requests-per-second throttle, forwarded from the top-level
-     * `RunImportOptions.rateLimit`. Only meaningful for API-backed importers
-     * (mem0) — file-based adapters ignore it. `runImporter` copies this
-     * through automatically so CLI users never have to stash it on
-     * `parseOptions` themselves. Cursor review on PR #602.
-     */
-    rateLimit?: number;
-}
-/** Options forwarded to `transform`. */
-interface ImporterTransformOptions {
-    /** When true, adapters that normally skip bulk conversations should include them. */
-    includeConversations?: boolean;
-    /** Maximum number of memories to emit. Primarily for tests. */
-    maxMemories?: number;
-}
-declare const DEFAULT_IMPORT_BATCH_SIZE = 25;
-/**
- * Coerce and validate the caller-supplied batch size. CLAUDE.md rule 14/51:
- * reject invalid CLI input rather than silently defaulting.
- */
-declare function validateImportBatchSize(value: number | undefined): number;
-/**
- * Validate the `--rate-limit` (requests per second) value used by API
- * importers. Zero / negative / non-finite values throw — the CLI must reject
- * them rather than silently import at unlimited speed.
- */
-declare function validateImportRateLimit(value: number | undefined): number | undefined;
-/**
- * Convert an `ImportedMemory` into an `ImportTurn` suitable for
- * `orchestrator.ingestBulkImportBatch`. The resulting turn is always
- * `role="user"` because every downstream source (saved memories, personal
- * context, mem0 entries) represents a first-person statement rather than an
- * assistant response.
- *
- * Keeps provenance on the turn via `participantName` so the extraction
- * pipeline's transcript renderer labels the speaker with the source platform.
- */
-declare function importedMemoryToTurn(memory: ImportedMemory): ImportTurn;
-interface RunImporterResult {
-    adapter: string;
-    sourceLabel: string;
-    /**
-     * Total memories produced by `transform`. In dry-run mode this is the same
-     * as the number of memories that WOULD have been written.
-     */
-    memoriesPlanned: number;
-    /**
-     * Number of memories actually handed to writeTo(). Always zero in dry-run
-     * mode.
-     */
-    memoriesWritten: number;
-    batchesProcessed: number;
-    dryRun: boolean;
-    /** Mirrors the importedAt stamped on every memory. */
-    importedAt: string;
-}
-/**
- * Orchestrate `parse → transform → writeTo` for an adapter. This is the
- * default pipeline used by the CLI; adapters are free to implement their own
- * orchestration when they need per-record rate-limiting or streaming parses
- * that would not fit in the "produce full array before writing" shape.
- *
- * Mutates the supplied memory records by filling in `importedAt` when the
- * adapter did not set it (CLAUDE.md rule 38: records are written in insertion
- * order to keep the provenance log stable).
- */
-declare function runImporter<Parsed>(adapter: ImporterAdapter<Parsed>, input: unknown, target: ImporterWriteTarget, options?: RunImportOptions & {
-    parseOptions?: ImporterParseOptions;
-    transformOptions?: ImporterTransformOptions;
-}): Promise<RunImporterResult>;
-/**
- * Default `writeTo` implementation for importers that want to hand every
- * memory to `orchestrator.ingestBulkImportBatch` without custom routing.
- * Adapters that need per-record rate-limiting or conversation-thread linking
- * are free to implement their own `writeTo`.
- */
-declare function defaultWriteMemoriesToOrchestrator(target: ImporterWriteTarget, memories: ImportedMemory[]): Promise<ImporterWriteResult>;
-
 /**
  * Training-data export types.
  *
@@ -2266,84 +2014,6 @@ declare function clearTrainingExportAdapters(): void;
  */
 declare function convertMemoriesToRecords(options: TrainingExportOptions): Promise<TrainingExportRecord[]>;
 
-/**
- * Peer registry storage primitives — issue #679 PR 1/5.
- *
- * Pure file-I/O helpers for the per-peer kernel files:
- *
- *   peers/{peer-id}/identity.md       — slow, human-edited identity facts
- *   peers/{peer-id}/profile.md        — evolving profile (reasoner-owned)
- *   peers/{peer-id}/interactions.log.md — append-only signal log
- *
- * No reasoner logic, no recall integration, no migration of existing
- * identity-anchor data — those land in PR 2/5 — 5/5.
- *
- * Path safety: `peerId` is validated against PEER_ID_PATTERN before any
- * filesystem operation. Reading a non-existent peer returns null (does not
- * throw). Reading malformed files throws — callers can catch and recover.
- */
-
-/**
- * Validate a peer id. Throws `Error` with a descriptive message on failure.
- * Exported so callers can pre-check user input before constructing a Peer.
- */
-declare function assertValidPeerId(peerId: unknown): asserts peerId is string;
-/** Root directory holding the peer registry, relative to memoryDir. */
-declare const PEERS_DIR_NAME = "peers";
-/**
- * Read a peer's identity kernel.
- *
- * Returns `null` (does not throw) when the peer directory or identity
- * file does not exist. Throws on filesystem errors other than ENOENT and
- * on malformed files.
- */
-declare function readPeer(memoryDir: string, peerId: string): Promise<Peer | null>;
-/**
- * Write (create or overwrite) a peer's identity kernel.
- *
- * Creates `peers/{id}/` if it does not exist. Does not touch the peer's
- * profile or interaction log. Atomic-write semantics are deferred to
- * later PRs — for the schema slice we simply write the file.
- */
-declare function writePeer(memoryDir: string, peer: Peer): Promise<void>;
-/**
- * Enumerate all peers under `memoryDir/peers/`.
- *
- * Returns an empty array if the peers root does not exist. Subdirectories
- * whose name fails `PEER_ID_PATTERN` are skipped (defensive: the user
- * may have hand-edited the directory). Directories that exist but lack
- * `identity.md` are also skipped.
- */
-declare function listPeers(memoryDir: string): Promise<Peer[]>;
-/**
- * Append one entry to a peer's interaction log.
- *
- * Creates `peers/{id}/` and `interactions.log.md` if needed. The file is
- * append-only by contract — this helper never rewrites prior entries.
- * Returns the absolute path of the log file (useful for tests).
- */
-declare function appendInteractionLog(memoryDir: string, peerId: string, entry: PeerInteractionLogEntry): Promise<string>;
-/**
- * Read a peer's profile. Returns null if the profile file does not exist.
- *
- * The PR-1 surface only ships the structured read/write so the reasoner
- * (PR 2/5) and recall integration (PR 3/5) have a stable target. We do
- * not yet expose any field-update helpers.
- */
-declare function readPeerProfile(memoryDir: string, peerId: string): Promise<PeerProfile | null>;
-/**
- * Write (create or overwrite) a peer's profile.
- */
-declare function writePeerProfile(memoryDir: string, profile: PeerProfile): Promise<void>;
-/**
- * Read the raw interaction log for a peer.
- *
- * Returns the empty string if the log does not yet exist. Callers parse
- * the log themselves — this PR does not ship structured log parsing.
- * Exposed primarily so tests can verify monotonic append semantics.
- */
-declare function readInteractionLogRaw(memoryDir: string, peerId: string): Promise<string>;
-
 /**
  * Capsule fork semantics — issue #676 PR 4/6.
  *
@@ -2460,4 +2130,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, BulkImportSourceAdapter, 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_IMPORT_BATCH_SIZE, 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 ImportProgress, ImportTurn, type ImportedMemory, type ImporterAdapter, type ImporterParseOptions, type ImporterTransformOptions, type ImporterWriteResult, type ImporterWriteTarget, 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, PEERS_DIR_NAME, PUBLISHERS, Peer, PeerInteractionLogEntry, PeerProfile, 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 RunImportOptions, type RunImporterResult, 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, appendInteractionLog, assertValidPeerId, branchNamespaceName, buildProcedureMarkdownBody, buildProcedureRecallSection, clearBulkImportSources, clearTrainingExportAdapters, convertMemoriesToRecords, createBackend, createGoogleDriveConnector, createNotionConnector, createSpace, curate, defaultGoogleDriveClientFactory, defaultWriteMemoriesToOrchestrator, deleteSpace, describeCodingScope, emptyManifest, expandTildePath, findContradictions, findDuplicates, forkCapsule, generateContextTree, generateResolverDocument, getActiveSpace, getAuditLog, getBulkImportSource, getManifestPath, getSpacesDir, getTaxonomyDir, getTaxonomyFilePath, getTrainingExportAdapter, hostIdForConnector, importedMemoryToTurn, isReviewPrompt, listBulkImportSources, listPeers, 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, readInteractionLogRaw, readManifest, readPeer, readPeerProfile, registerBulkImportSource, registerPublisher, registerTrainingExportAdapter, renderExtensionsBlock, renderExtensionsFooter, resolveCategory, resolveCodingNamespaceOverlay, resolveGitContext, runBinaryLifecyclePipeline, runImporter, saveManifest, saveTaxonomy, scanForBinaries, shareSpace, stableHash, switchSpace, syncChanges, validateGoogleDriveConfig, validateImportBatchSize, validateImportRateLimit, validateNotionConfig, validateSlug, validateTaxonomy, watchForChanges, writeManifest, writePeer, writePeerProfile };
+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 };