@remnic/core 1.0.0

package/dist/commitment-ledger.d.ts

@@ -0,0 +1,83 @@
+type CommitmentLedgerSource = "tool_result" | "cli" | "system" | "manual";
+type CommitmentLedgerKind = "promise" | "follow_up" | "deadline" | "deliverable";
+type CommitmentLedgerState = "open" | "fulfilled" | "cancelled" | "expired";
+interface CommitmentLedgerEntry {
+    schemaVersion: 1;
+    entryId: string;
+    recordedAt: string;
+    sessionKey: string;
+    source: CommitmentLedgerSource;
+    kind: CommitmentLedgerKind;
+    state: CommitmentLedgerState;
+    scope: string;
+    summary: string;
+    dueAt?: string;
+    entityRefs?: string[];
+    workProductEntryRefs?: string[];
+    objectiveStateSnapshotRefs?: string[];
+    tags?: string[];
+    metadata?: Record<string, string>;
+    stateChangedAt?: string;
+    resolvedAt?: string;
+}
+interface CommitmentLedgerStatus {
+    enabled: boolean;
+    rootDir: string;
+    entriesDir: string;
+    entries: {
+        total: number;
+        valid: number;
+        invalid: number;
+        byKind: Partial<Record<CommitmentLedgerKind, number>>;
+        byState: Partial<Record<CommitmentLedgerState, number>>;
+        latestEntryId?: string;
+        latestRecordedAt?: string;
+        latestSessionKey?: string;
+    };
+    latestEntry?: CommitmentLedgerEntry;
+    invalidEntries: Array<{
+        path: string;
+        error: string;
+    }>;
+    lifecycle?: {
+        staleOpen: number;
+        overdueOpen: number;
+        decayEligibleResolved: number;
+    };
+}
+interface CommitmentLedgerLifecycleResult {
+    transitionedToExpired: CommitmentLedgerEntry[];
+    deletedResolved: CommitmentLedgerEntry[];
+}
+declare function resolveCommitmentLedgerDir(memoryDir: string, overrideDir?: string): string;
+declare function validateCommitmentLedgerEntry(raw: unknown): CommitmentLedgerEntry;
+declare function recordCommitmentLedgerEntry(options: {
+    memoryDir: string;
+    commitmentLedgerDir?: string;
+    entry: CommitmentLedgerEntry;
+}): Promise<string>;
+declare function transitionCommitmentLedgerEntryState(options: {
+    memoryDir: string;
+    commitmentLedgerDir?: string;
+    entryId: string;
+    nextState: CommitmentLedgerState;
+    changedAt: string;
+}): Promise<CommitmentLedgerEntry>;
+declare function applyCommitmentLedgerLifecycle(options: {
+    memoryDir: string;
+    commitmentLedgerDir?: string;
+    enabled: boolean;
+    decayDays: number;
+    now?: string;
+}): Promise<CommitmentLedgerLifecycleResult>;
+declare function getCommitmentLedgerStatus(options: {
+    memoryDir: string;
+    commitmentLedgerDir?: string;
+    enabled: boolean;
+    lifecycleEnabled?: boolean;
+    staleDays?: number;
+    decayDays?: number;
+    now?: string;
+}): Promise<CommitmentLedgerStatus>;
+
+export { type CommitmentLedgerEntry, type CommitmentLedgerKind, type CommitmentLedgerLifecycleResult, type CommitmentLedgerSource, type CommitmentLedgerState, type CommitmentLedgerStatus, applyCommitmentLedgerLifecycle, getCommitmentLedgerStatus, recordCommitmentLedgerEntry, resolveCommitmentLedgerDir, transitionCommitmentLedgerEntryState, validateCommitmentLedgerEntry };

package/dist/commitment-ledger.js

@@ -0,0 +1,19 @@
+import {
+  applyCommitmentLedgerLifecycle,
+  getCommitmentLedgerStatus,
+  recordCommitmentLedgerEntry,
+  resolveCommitmentLedgerDir,
+  transitionCommitmentLedgerEntryState,
+  validateCommitmentLedgerEntry
+} from "./chunk-FYIYMQ5N.js";
+import "./chunk-DGXUHMOV.js";
+import "./chunk-LPSF4OQH.js";
+export {
+  applyCommitmentLedgerLifecycle,
+  getCommitmentLedgerStatus,
+  recordCommitmentLedgerEntry,
+  resolveCommitmentLedgerDir,
+  transitionCommitmentLedgerEntryState,
+  validateCommitmentLedgerEntry
+};
+//# sourceMappingURL=commitment-ledger.js.map

package/dist/commitment-ledger.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/compression-optimizer.d.ts

@@ -0,0 +1,37 @@
+import { CompressionGuidelineOptimizerEventCounts, CompressionGuidelineOptimizerActionSummary, CompressionGuidelineOptimizerRuleUpdate, MemoryActionType, MemoryActionEvent, CompressionGuidelineOptimizerState } from './types.js';
+
+interface CompressionGuidelineCandidate {
+    generatedAt: string;
+    sourceWindow: {
+        from: string;
+        to: string;
+    };
+    eventCounts: CompressionGuidelineOptimizerEventCounts;
+    actionSummaries: CompressionGuidelineOptimizerActionSummary[];
+    ruleUpdates: CompressionGuidelineOptimizerRuleUpdate[];
+    guidelineVersion: number;
+    optimizerVersion: number;
+}
+interface CompressionSemanticRuleRefinement {
+    action: MemoryActionType;
+    delta?: number;
+    confidence?: "low" | "medium" | "high";
+    note?: string;
+}
+interface CompressionSemanticRefinementResult {
+    updates: CompressionSemanticRuleRefinement[];
+}
+interface CompressionSemanticRefinementOptions {
+    enabled: boolean;
+    timeoutMs: number;
+    runRefinement?: (candidate: CompressionGuidelineCandidate) => Promise<CompressionSemanticRefinementResult | null>;
+}
+declare function computeCompressionGuidelineCandidate(events: MemoryActionEvent[], options?: {
+    generatedAtIso?: string;
+    previousState?: CompressionGuidelineOptimizerState | null;
+}): CompressionGuidelineCandidate;
+declare function refineCompressionGuidelineCandidateSemantically(baseline: CompressionGuidelineCandidate, options: CompressionSemanticRefinementOptions): Promise<CompressionGuidelineCandidate>;
+declare function renderCompressionGuidelinesMarkdown(candidate: CompressionGuidelineCandidate): string;
+declare function buildCompressionGuidelinesMarkdown(events: MemoryActionEvent[], generatedAtIso?: string, previousState?: CompressionGuidelineOptimizerState | null): string;
+
+export { type CompressionGuidelineCandidate, type CompressionSemanticRefinementOptions, type CompressionSemanticRefinementResult, type CompressionSemanticRuleRefinement, buildCompressionGuidelinesMarkdown, computeCompressionGuidelineCandidate, refineCompressionGuidelineCandidateSemantically, renderCompressionGuidelinesMarkdown };

package/dist/compression-optimizer.js

@@ -0,0 +1,13 @@
+import {
+  buildCompressionGuidelinesMarkdown,
+  computeCompressionGuidelineCandidate,
+  refineCompressionGuidelineCandidateSemantically,
+  renderCompressionGuidelinesMarkdown
+} from "./chunk-2NMMFZ5T.js";
+export {
+  buildCompressionGuidelinesMarkdown,
+  computeCompressionGuidelineCandidate,
+  refineCompressionGuidelineCandidateSemantically,
+  renderCompressionGuidelinesMarkdown
+};
+//# sourceMappingURL=compression-optimizer.js.map

package/dist/compression-optimizer.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/config.d.ts

@@ -0,0 +1,6 @@
+import { PluginConfig } from './types.js';
+
+declare const VALID_MEMORY_CATEGORIES: Set<string>;
+declare function parseConfig(raw: unknown): PluginConfig;
+
+export { VALID_MEMORY_CATEGORIES, parseConfig };

package/dist/config.js

@@ -0,0 +1,12 @@
+import {
+  VALID_MEMORY_CATEGORIES,
+  parseConfig
+} from "./chunk-ISY75RLM.js";
+import "./chunk-Z5LAYHGJ.js";
+import "./chunk-MARWOCVP.js";
+import "./chunk-KWBU5S5U.js";
+export {
+  VALID_MEMORY_CATEGORIES,
+  parseConfig
+};
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/cue-anchors.d.ts

@@ -0,0 +1,50 @@
+type CueAnchorType = "entity" | "file" | "tool" | "outcome" | "constraint" | "date";
+interface CueAnchor {
+    schemaVersion: 1;
+    anchorId: string;
+    anchorType: CueAnchorType;
+    anchorValue: string;
+    normalizedCue: string;
+    recordedAt: string;
+    sessionKey: string;
+    nodeRefs: string[];
+    tags?: string[];
+    metadata?: Record<string, string>;
+}
+interface CueAnchorStoreStatus {
+    enabled: boolean;
+    anchorsEnabled: boolean;
+    rootDir: string;
+    anchors: {
+        total: number;
+        valid: number;
+        invalid: number;
+        byType: Partial<Record<CueAnchorType, number>>;
+        totalNodeRefs: number;
+        latestAnchorId?: string;
+        latestRecordedAt?: string;
+        latestSessionKey?: string;
+    };
+    latestAnchor?: CueAnchor;
+    invalidAnchors: Array<{
+        path: string;
+        error: string;
+    }>;
+}
+declare function resolveCueAnchorStoreDir(abstractionNodeStoreDir: string, overrideDir?: string): string;
+declare function validateCueAnchor(raw: unknown): CueAnchor;
+declare function recordCueAnchor(options: {
+    memoryDir: string;
+    abstractionNodeStoreDir?: string;
+    cueAnchorStoreDir?: string;
+    anchor: CueAnchor;
+}): Promise<string>;
+declare function getCueAnchorStoreStatus(options: {
+    memoryDir: string;
+    abstractionNodeStoreDir?: string;
+    cueAnchorStoreDir?: string;
+    enabled: boolean;
+    anchorsEnabled: boolean;
+}): Promise<CueAnchorStoreStatus>;
+
+export { type CueAnchor, type CueAnchorStoreStatus, type CueAnchorType, getCueAnchorStoreStatus, recordCueAnchor, resolveCueAnchorStoreDir, validateCueAnchor };

package/dist/cue-anchors.js

@@ -0,0 +1,15 @@
+import {
+  getCueAnchorStoreStatus,
+  recordCueAnchor,
+  resolveCueAnchorStoreDir,
+  validateCueAnchor
+} from "./chunk-C6QPK5GG.js";
+import "./chunk-DGXUHMOV.js";
+import "./chunk-LPSF4OQH.js";
+export {
+  getCueAnchorStoreStatus,
+  recordCueAnchor,
+  resolveCueAnchorStoreDir,
+  validateCueAnchor
+};
+//# sourceMappingURL=cue-anchors.js.map

package/dist/cue-anchors.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/dashboard-runtime.d.ts

@@ -0,0 +1,46 @@
+interface DashboardServerOptions {
+    memoryDir: string;
+    host?: string;
+    port?: number;
+    publicDir?: string;
+    watchDebounceMs?: number;
+}
+interface DashboardStatus {
+    running: boolean;
+    host: string;
+    port: number;
+    watching: boolean;
+    lastUpdatedAt?: string;
+    graphNodeCount: number;
+    graphEdgeCount: number;
+}
+declare class GraphDashboardServer {
+    private readonly memoryDir;
+    private readonly host;
+    private readonly requestedPort;
+    private readonly publicDir;
+    private readonly watchDebounceMs;
+    private server;
+    private watcher;
+    private clients;
+    private graphSnapshot;
+    private debounceTimer;
+    private lastError;
+    private boundPort;
+    constructor(options: DashboardServerOptions);
+    start(): Promise<DashboardStatus>;
+    stop(): Promise<void>;
+    status(): DashboardStatus;
+    private handleHttp;
+    private respondJson;
+    private respondStatic;
+    private handleUpgrade;
+    private isAllowedOrigin;
+    private broadcast;
+    private startWatcher;
+    private scheduleRebuild;
+    private rebuildAndBroadcast;
+    private rebuildSnapshot;
+}
+
+export { type DashboardServerOptions, type DashboardStatus, GraphDashboardServer };

package/dist/dashboard-runtime.js

@@ -0,0 +1,10 @@
+import {
+  GraphDashboardServer
+} from "./chunk-ZPKBYX2F.js";
+import "./chunk-3SLRNYNG.js";
+import "./chunk-LIRZNNUP.js";
+import "./chunk-Y4Z4I6WK.js";
+export {
+  GraphDashboardServer
+};
+//# sourceMappingURL=dashboard-runtime.js.map

package/dist/dashboard-runtime.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/day-summary.d.ts

@@ -0,0 +1,6 @@
+import { MemoryFile } from './types.js';
+
+declare function loadDaySummaryPrompt(): Promise<string>;
+declare function formatDaySummaryMemories(memories: string | MemoryFile[]): string;
+
+export { formatDaySummaryMemories, loadDaySummaryPrompt };

package/dist/day-summary.js

@@ -0,0 +1,10 @@
+import {
+  formatDaySummaryMemories,
+  loadDaySummaryPrompt
+} from "./chunk-2PO5ZRKV.js";
+import "./chunk-KWBU5S5U.js";
+export {
+  formatDaySummaryMemories,
+  loadDaySummaryPrompt
+};
+//# sourceMappingURL=day-summary.js.map

package/dist/day-summary.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/delinearize.d.ts

@@ -0,0 +1,34 @@
+import { EntityMention } from './types.js';
+
+/**
+ * De-linearization transform (SimpleMem-inspired).
+ *
+ * Converts extracted memories from context-dependent to context-independent
+ * by resolving coreferences and anchoring temporal expressions.
+ */
+
+/**
+ * Replace pronouns with entity names when there's exactly one
+ * matching entity of the right type (unambiguous resolution).
+ *
+ * Possessive pronouns (his/her/its/their) become "entity's".
+ * No verb agreement is attempted — it's too fragile with adverbs/modals.
+ *
+ * Guards against:
+ * - Multiple pronouns of the same entity type → skip all (ambiguous referent)
+ * - Entity names containing pronoun substrings → placeholder-based two-pass
+ * - Entity names containing $ → escaped before replacement
+ */
+declare function resolveCoReferences(fact: string, entities: EntityMention[]): string;
+/**
+ * Replace relative temporal expressions with absolute ISO-8601 dates.
+ */
+declare function anchorTemporalExpressions(fact: string, now: Date): string;
+/**
+ * Full de-linearization pipeline: temporal anchoring first, then coreference.
+ * Order matters: entity names may contain temporal words (e.g., "project-tomorrow")
+ * which would be corrupted if temporal anchoring ran after coreference insertion.
+ */
+declare function delinearize(factContent: string, entities: EntityMention[], timestamp: Date): string;
+
+export { anchorTemporalExpressions, delinearize, resolveCoReferences };

package/dist/delinearize.js

@@ -0,0 +1,11 @@
+import {
+  anchorTemporalExpressions,
+  delinearize,
+  resolveCoReferences
+} from "./chunk-VEWZZM3H.js";
+export {
+  anchorTemporalExpressions,
+  delinearize,
+  resolveCoReferences
+};
+//# sourceMappingURL=delinearize.js.map

package/dist/delinearize.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/embedding-fallback.d.ts

@@ -0,0 +1,22 @@
+import { PluginConfig } from './types.js';
+
+declare class EmbeddingFallback {
+    private readonly config;
+    private readonly indexPath;
+    private loaded;
+    constructor(config: PluginConfig);
+    isAvailable(): Promise<boolean>;
+    search(query: string, limit: number): Promise<Array<{
+        id: string;
+        score: number;
+        path: string;
+    }>>;
+    indexFile(memoryId: string, content: string, filePath: string): Promise<void>;
+    removeFromIndex(memoryId: string): Promise<void>;
+    private resolveProvider;
+    private embed;
+    private loadIndex;
+    private saveIndex;
+}
+
+export { EmbeddingFallback };

package/dist/embedding-fallback.js

@@ -0,0 +1,8 @@
+import {
+  EmbeddingFallback
+} from "./chunk-QPKFPHOO.js";
+import "./chunk-KWBU5S5U.js";
+export {
+  EmbeddingFallback
+};
+//# sourceMappingURL=embedding-fallback.js.map

package/dist/embedding-fallback.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/engine-P26JFSVY.js

@@ -0,0 +1,19 @@
+import {
+  CompoundingEngine,
+  defaultTierMigrationCycleBudget
+} from "./chunk-TKO4HZCK.js";
+import "./chunk-QWUUMMIK.js";
+import "./chunk-U4PV25RD.js";
+import "./chunk-ESSMF2FR.js";
+import "./chunk-TP4FZJIZ.js";
+import "./chunk-SCU65EZI.js";
+import "./chunk-BOUYNNYD.js";
+import "./chunk-DM2T26WE.js";
+import "./chunk-QSVPYQPG.js";
+import "./chunk-M62O4P4T.js";
+import "./chunk-KWBU5S5U.js";
+export {
+  CompoundingEngine,
+  defaultTierMigrationCycleBudget
+};
+//# sourceMappingURL=engine-P26JFSVY.js.map

package/dist/engine-P26JFSVY.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/entity-retrieval.d.ts

@@ -0,0 +1,23 @@
+import { StorageManager } from './storage.js';
+import { PluginConfig, TranscriptEntry } from './types.js';
+import './memory-projection-store-NxMkbocT.js';
+import 'better-sqlite3';
+
+interface BuildEntityRecallSectionOptions {
+    config: PluginConfig;
+    storage: StorageManager;
+    query: string;
+    recallNamespaces?: string[];
+    recentTurns: number;
+    maxHints: number;
+    maxSupportingFacts: number;
+    maxRelatedEntities: number;
+    maxChars: number;
+    transcriptEntries: TranscriptEntry[];
+}
+declare function buildEntityRecallSection(options: BuildEntityRecallSectionOptions): Promise<string | null>;
+declare function readRecentEntityTranscriptEntries(transcriptEntriesPromise: Promise<TranscriptEntry[]>, recentTurns: number): Promise<TranscriptEntry[]>;
+declare const entityIndexVersion = 1;
+declare const entityRecentTranscriptLookbackHours = 24;
+
+export { type BuildEntityRecallSectionOptions, buildEntityRecallSection, entityIndexVersion, entityRecentTranscriptLookbackHours, readRecentEntityTranscriptEntries };

package/dist/entity-retrieval.js

@@ -0,0 +1,24 @@
+import {
+  buildEntityRecallSection,
+  entityIndexVersion,
+  entityRecentTranscriptLookbackHours,
+  readRecentEntityTranscriptEntries
+} from "./chunk-V4YC4LUK.js";
+import "./chunk-Q6FETXJA.js";
+import "./chunk-QWUUMMIK.js";
+import "./chunk-U4PV25RD.js";
+import "./chunk-ESSMF2FR.js";
+import "./chunk-TP4FZJIZ.js";
+import "./chunk-SCU65EZI.js";
+import "./chunk-BOUYNNYD.js";
+import "./chunk-DM2T26WE.js";
+import "./chunk-QSVPYQPG.js";
+import "./chunk-M62O4P4T.js";
+import "./chunk-KWBU5S5U.js";
+export {
+  buildEntityRecallSection,
+  entityIndexVersion,
+  entityRecentTranscriptLookbackHours,
+  readRecentEntityTranscriptEntries
+};
+//# sourceMappingURL=entity-retrieval.js.map

package/dist/entity-retrieval.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}