@remnic/core 1.0.0

package/dist/types.js

@@ -0,0 +1,9 @@
+import {
+  SPECULATIVE_TTL_DAYS,
+  confidenceTier
+} from "./chunk-U4PV25RD.js";
+export {
+  SPECULATIVE_TTL_DAYS,
+  confidenceTier
+};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

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

package/dist/utility-learner.d.ts

@@ -0,0 +1,59 @@
+import { UtilityTelemetryTarget, UtilityTelemetryDecision, UtilityTelemetryOutcome } from './utility-telemetry.js';
+
+interface UtilityLearningWeight {
+    target: UtilityTelemetryTarget;
+    decision: UtilityTelemetryDecision;
+    eventCount: number;
+    learnedWeight: number;
+    averageUtilityScore: number;
+    confidence: number;
+    outcomeCounts: Partial<Record<UtilityTelemetryOutcome, number>>;
+    updatedAt: string;
+}
+interface UtilityLearningSnapshot {
+    version: 1;
+    updatedAt: string;
+    windowDays: number;
+    minEventCount: number;
+    maxWeightMagnitude: number;
+    weights: UtilityLearningWeight[];
+}
+interface UtilityLearningStatus {
+    enabled: boolean;
+    promotionByOutcomeEnabled: boolean;
+    rootDir: string;
+    statePath: string;
+    snapshot: UtilityLearningSnapshot | null;
+    weights: {
+        total: number;
+        positive: number;
+        negative: number;
+        zero: number;
+        latestUpdatedAt?: string;
+    };
+}
+interface UtilityLearningResult {
+    applied: boolean;
+    reason: "disabled" | "insufficient_events" | "learned";
+    statePath: string;
+    snapshot: UtilityLearningSnapshot | null;
+}
+declare function resolveUtilityLearningStatePath(memoryDir: string, utilityTelemetryDir?: string): string;
+declare function readUtilityLearningSnapshot(memoryDir: string, utilityTelemetryDir?: string): Promise<UtilityLearningSnapshot | null>;
+declare function learnUtilityPromotionWeights(options: {
+    memoryDir: string;
+    utilityTelemetryDir?: string;
+    enabled: boolean;
+    now?: Date;
+    learningWindowDays: number;
+    minEventCount: number;
+    maxWeightMagnitude: number;
+}): Promise<UtilityLearningResult>;
+declare function getUtilityLearningStatus(options: {
+    memoryDir: string;
+    utilityTelemetryDir?: string;
+    enabled: boolean;
+    promotionByOutcomeEnabled?: boolean;
+}): Promise<UtilityLearningStatus>;
+
+export { type UtilityLearningResult, type UtilityLearningSnapshot, type UtilityLearningStatus, type UtilityLearningWeight, getUtilityLearningStatus, learnUtilityPromotionWeights, readUtilityLearningSnapshot, resolveUtilityLearningStatePath };

package/dist/utility-learner.js

@@ -0,0 +1,17 @@
+import {
+  getUtilityLearningStatus,
+  learnUtilityPromotionWeights,
+  readUtilityLearningSnapshot,
+  resolveUtilityLearningStatePath
+} from "./chunk-OTAVQCSF.js";
+import "./chunk-3QKK7QOS.js";
+import "./chunk-DGXUHMOV.js";
+import "./chunk-LPSF4OQH.js";
+import "./chunk-QCCCQT3O.js";
+export {
+  getUtilityLearningStatus,
+  learnUtilityPromotionWeights,
+  readUtilityLearningSnapshot,
+  resolveUtilityLearningStatePath
+};
+//# sourceMappingURL=utility-learner.js.map

package/dist/utility-learner.js.map

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

package/dist/utility-runtime.d.ts

@@ -0,0 +1,21 @@
+import { TierRoutingPolicy } from './tier-routing.js';
+import './types.js';
+import './lifecycle.js';
+
+interface UtilityRuntimeValues {
+    rankingBoostMultiplier: number;
+    rankingSuppressMultiplier: number;
+    promoteThresholdDelta: number;
+    demoteThresholdDelta: number;
+    snapshotUpdatedAt: string;
+}
+declare function loadUtilityRuntimeValues(options: {
+    memoryDir: string;
+    utilityTelemetryDir?: string;
+    memoryUtilityLearningEnabled: boolean;
+    promotionByOutcomeEnabled: boolean;
+}): Promise<UtilityRuntimeValues | null>;
+declare function applyUtilityRankingRuntimeDelta(delta: number, runtime: UtilityRuntimeValues | null, mode: "boost" | "suppress"): number;
+declare function applyUtilityPromotionRuntimePolicy(policy: TierRoutingPolicy, runtime: UtilityRuntimeValues | null): TierRoutingPolicy;
+
+export { type UtilityRuntimeValues, applyUtilityPromotionRuntimePolicy, applyUtilityRankingRuntimeDelta, loadUtilityRuntimeValues };

package/dist/utility-runtime.js

@@ -0,0 +1,16 @@
+import {
+  applyUtilityPromotionRuntimePolicy,
+  applyUtilityRankingRuntimeDelta,
+  loadUtilityRuntimeValues
+} from "./chunk-IFFFR3MR.js";
+import "./chunk-OTAVQCSF.js";
+import "./chunk-3QKK7QOS.js";
+import "./chunk-DGXUHMOV.js";
+import "./chunk-LPSF4OQH.js";
+import "./chunk-QCCCQT3O.js";
+export {
+  applyUtilityPromotionRuntimePolicy,
+  applyUtilityRankingRuntimeDelta,
+  loadUtilityRuntimeValues
+};
+//# sourceMappingURL=utility-runtime.js.map

package/dist/utility-runtime.js.map

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

package/dist/utility-telemetry.d.ts

@@ -0,0 +1,68 @@
+type UtilityTelemetrySource = "cli" | "system" | "benchmark" | "tool_result";
+type UtilityTelemetryTarget = "promotion" | "ranking";
+type UtilityTelemetryDecision = "promote" | "demote" | "hold" | "boost" | "suppress";
+type UtilityTelemetryOutcome = "helpful" | "neutral" | "harmful";
+interface UtilityTelemetryEvent {
+    schemaVersion: 1;
+    eventId: string;
+    recordedAt: string;
+    sessionKey: string;
+    source: UtilityTelemetrySource;
+    target: UtilityTelemetryTarget;
+    decision: UtilityTelemetryDecision;
+    outcome: UtilityTelemetryOutcome;
+    utilityScore: number;
+    summary: string;
+    memoryIds?: string[];
+    entityRefs?: string[];
+    tags?: string[];
+    metadata?: Record<string, string>;
+}
+interface UtilityTelemetryStatus {
+    enabled: boolean;
+    promotionByOutcomeEnabled: boolean;
+    rootDir: string;
+    eventsDir: string;
+    events: {
+        total: number;
+        valid: number;
+        invalid: number;
+        byTarget: Partial<Record<UtilityTelemetryTarget, number>>;
+        byDecision: Partial<Record<UtilityTelemetryDecision, number>>;
+        byOutcome: Partial<Record<UtilityTelemetryOutcome, number>>;
+        latestEventId?: string;
+        latestRecordedAt?: string;
+        latestSessionKey?: string;
+    };
+    latestEvent?: UtilityTelemetryEvent;
+    invalidEvents: Array<{
+        path: string;
+        error: string;
+    }>;
+}
+declare function resolveUtilityTelemetryDir(memoryDir: string, overrideDir?: string): string;
+declare function validateUtilityTelemetryEvent(raw: unknown): UtilityTelemetryEvent;
+declare function recordUtilityTelemetryEvent(options: {
+    memoryDir: string;
+    utilityTelemetryDir?: string;
+    event: UtilityTelemetryEvent;
+}): Promise<string>;
+declare function readUtilityTelemetryEvents(options: {
+    memoryDir: string;
+    utilityTelemetryDir?: string;
+}): Promise<{
+    files: string[];
+    events: UtilityTelemetryEvent[];
+    invalidEvents: Array<{
+        path: string;
+        error: string;
+    }>;
+}>;
+declare function getUtilityTelemetryStatus(options: {
+    memoryDir: string;
+    utilityTelemetryDir?: string;
+    enabled: boolean;
+    promotionByOutcomeEnabled?: boolean;
+}): Promise<UtilityTelemetryStatus>;
+
+export { type UtilityTelemetryDecision, type UtilityTelemetryEvent, type UtilityTelemetryOutcome, type UtilityTelemetrySource, type UtilityTelemetryStatus, type UtilityTelemetryTarget, getUtilityTelemetryStatus, readUtilityTelemetryEvents, recordUtilityTelemetryEvent, resolveUtilityTelemetryDir, validateUtilityTelemetryEvent };

package/dist/utility-telemetry.js

@@ -0,0 +1,17 @@
+import {
+  getUtilityTelemetryStatus,
+  readUtilityTelemetryEvents,
+  recordUtilityTelemetryEvent,
+  resolveUtilityTelemetryDir,
+  validateUtilityTelemetryEvent
+} from "./chunk-3QKK7QOS.js";
+import "./chunk-DGXUHMOV.js";
+import "./chunk-LPSF4OQH.js";
+export {
+  getUtilityTelemetryStatus,
+  readUtilityTelemetryEvents,
+  recordUtilityTelemetryEvent,
+  resolveUtilityTelemetryDir,
+  validateUtilityTelemetryEvent
+};
+//# sourceMappingURL=utility-telemetry.js.map

package/dist/utility-telemetry.js.map

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

package/dist/verified-recall.d.ts

@@ -0,0 +1,17 @@
+import { BoxFrontmatter } from './boxes.js';
+
+interface VerifiedEpisodeResult {
+    box: BoxFrontmatter;
+    score: number;
+    verifiedEpisodeCount: number;
+    verifiedMemoryIds: string[];
+    matchedFields: string[];
+}
+declare function searchVerifiedEpisodes(options: {
+    memoryDir: string;
+    query: string;
+    maxResults: number;
+    boxRecallDays?: number;
+}): Promise<VerifiedEpisodeResult[]>;
+
+export { type VerifiedEpisodeResult, searchVerifiedEpisodes };

package/dist/verified-recall.js

@@ -0,0 +1,19 @@
+import {
+  searchVerifiedEpisodes
+} from "./chunk-UIYZ5T3I.js";
+import "./chunk-M5KEYE5E.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-DT5TVLJE.js";
+import "./chunk-KWBU5S5U.js";
+export {
+  searchVerifiedEpisodes
+};
+//# sourceMappingURL=verified-recall.js.map

package/dist/verified-recall.js.map

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

package/dist/version-utils.d.ts

@@ -0,0 +1,4 @@
+type VersionTriple = readonly [number, number, number];
+declare function compareVersions(a: VersionTriple, b: VersionTriple): number;
+
+export { type VersionTriple, compareVersions };

package/dist/version-utils.js

@@ -0,0 +1,7 @@
+import {
+  compareVersions
+} from "./chunk-HL4DB7TO.js";
+export {
+  compareVersions
+};
+//# sourceMappingURL=version-utils.js.map

package/dist/version-utils.js.map

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

package/dist/work-product-ledger.d.ts

@@ -0,0 +1,65 @@
+type WorkProductLedgerSource = "tool_result" | "cli" | "system" | "manual";
+type WorkProductLedgerKind = "artifact" | "file" | "record" | "report" | "workspace";
+type WorkProductLedgerAction = "created" | "updated" | "deleted" | "referenced" | "published";
+interface WorkProductLedgerEntry {
+    schemaVersion: 1;
+    entryId: string;
+    recordedAt: string;
+    sessionKey: string;
+    source: WorkProductLedgerSource;
+    kind: WorkProductLedgerKind;
+    action: WorkProductLedgerAction;
+    scope: string;
+    summary: string;
+    artifactPath?: string;
+    objectiveStateSnapshotRefs?: string[];
+    entityRefs?: string[];
+    tags?: string[];
+    metadata?: Record<string, string>;
+}
+interface WorkProductLedgerStatus {
+    enabled: boolean;
+    rootDir: string;
+    entriesDir: string;
+    entries: {
+        total: number;
+        valid: number;
+        invalid: number;
+        byKind: Partial<Record<WorkProductLedgerKind, number>>;
+        byAction: Partial<Record<WorkProductLedgerAction, number>>;
+        latestEntryId?: string;
+        latestRecordedAt?: string;
+        latestSessionKey?: string;
+    };
+    latestEntry?: WorkProductLedgerEntry;
+    invalidEntries: Array<{
+        path: string;
+        error: string;
+    }>;
+}
+interface WorkProductLedgerSearchResult {
+    entry: WorkProductLedgerEntry;
+    score: number;
+    matchedFields: string[];
+}
+declare function resolveWorkProductLedgerDir(memoryDir: string, overrideDir?: string): string;
+declare function validateWorkProductLedgerEntry(raw: unknown): WorkProductLedgerEntry;
+declare function recordWorkProductLedgerEntry(options: {
+    memoryDir: string;
+    workProductLedgerDir?: string;
+    entry: WorkProductLedgerEntry;
+}): Promise<string>;
+declare function searchWorkProductLedgerEntries(options: {
+    memoryDir: string;
+    workProductLedgerDir?: string;
+    query: string;
+    maxResults: number;
+    sessionKey?: string;
+}): Promise<WorkProductLedgerSearchResult[]>;
+declare function getWorkProductLedgerStatus(options: {
+    memoryDir: string;
+    workProductLedgerDir?: string;
+    enabled: boolean;
+}): Promise<WorkProductLedgerStatus>;
+
+export { type WorkProductLedgerAction, type WorkProductLedgerEntry, type WorkProductLedgerKind, type WorkProductLedgerSearchResult, type WorkProductLedgerSource, type WorkProductLedgerStatus, getWorkProductLedgerStatus, recordWorkProductLedgerEntry, resolveWorkProductLedgerDir, searchWorkProductLedgerEntries, validateWorkProductLedgerEntry };

package/dist/work-product-ledger.js

@@ -0,0 +1,18 @@
+import {
+  getWorkProductLedgerStatus,
+  recordWorkProductLedgerEntry,
+  resolveWorkProductLedgerDir,
+  searchWorkProductLedgerEntries,
+  validateWorkProductLedgerEntry
+} from "./chunk-CULXMQJH.js";
+import "./chunk-DT5TVLJE.js";
+import "./chunk-DGXUHMOV.js";
+import "./chunk-LPSF4OQH.js";
+export {
+  getWorkProductLedgerStatus,
+  recordWorkProductLedgerEntry,
+  resolveWorkProductLedgerDir,
+  searchWorkProductLedgerEntries,
+  validateWorkProductLedgerEntry
+};
+//# sourceMappingURL=work-product-ledger.js.map

package/dist/work-product-ledger.js.map

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

package/package.json

@@ -0,0 +1,58 @@
+{
+  "name": "@remnic/core",
+  "version": "1.0.0",
+  "description": "Framework-agnostic Remnic memory engine — orchestrator, storage, extraction, search, trust zones",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    },
+    "./access-cli": {
+      "import": "./dist/access-cli.js",
+      "types": "./dist/access-cli.d.ts"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
+  },
+  "scripts": {
+    "build": "tsup",
+    "check-types": "tsc --noEmit",
+    "prepublishOnly": "npm run build"
+  },
+  "dependencies": {
+    "@honcho-ai/sdk": "^2.0.0",
+    "@lancedb/lancedb": "^0.26.2",
+    "@orama/orama": "^3.0.0",
+    "@orama/plugin-data-persistence": "^3.0.0",
+    "@sinclair/typebox": "^0.34.0",
+    "better-sqlite3": "^12.6.2",
+    "meilisearch": "^0.46.0",
+    "openai": "^6.0.0",
+    "zod": "^3.24.0"
+  },
+  "optionalDependencies": {
+    "@lancedb/lancedb-darwin-arm64": "^0.26.2",
+    "@lancedb/lancedb-linux-arm64-gnu": "^0.26.2",
+    "@lancedb/lancedb-linux-x64-gnu": "^0.26.2"
+  },
+  "devDependencies": {
+    "@types/better-sqlite3": "^7.6.13",
+    "tsup": "^8.5.1",
+    "typescript": "^5.9.3"
+  },
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/joshuaswarren/remnic.git",
+    "directory": "packages/remnic-core"
+  },
+  "keywords": ["remnic", "memory", "ai", "agent", "core"]
+}