agenr 2.0.1 → 3.0.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agenr",
-  "version": "2.0.1",
+  "version": "3.0.0",
   "description": "Agent memory - local-first knowledge infrastructure for AI agents",
   "type": "module",
   "bin": {
@@ -15,8 +15,8 @@
   "dependencies": {
     "@clack/prompts": "^1.1.0",
     "@libsql/client": "^0.17.2",
-    "@mariozechner/pi-agent-core": "^0.63.1",
-    "@mariozechner/pi-ai": "^0.63.2",
+    "@earendil-works/pi-agent-core": "^0.78.0",
+    "@earendil-works/pi-ai": "^0.78.0",
     "@sinclair/typebox": "^0.34.0",
     "chalk": "^5.6.2",
     "commander": "^14.0.3",
@@ -26,6 +26,8 @@
   "devDependencies": {
     "@eslint/js": "^10.0.1",
     "@types/node": "^25.5.0",
+    "skeln": "file:../skeln",
+    "typebox": "^1.1.38",
     "eslint": "^10.1.0",
     "eslint-plugin-jsdoc": "^62.8.1",
     "globals": "^17.4.0",
@@ -42,12 +44,13 @@
   "scripts": {
     "build": "pnpm run build:root && pnpm run build:plugin",
     "build:root": "tsup",
-    "build:plugin": "pnpm --filter @agenr/agenr-plugin build",
+    "build:plugin": "pnpm --filter @agenr/agenr-plugin build && pnpm --filter @agenr/skeln-plugin build",
     "build:debug": "pnpm run build:root:debug && pnpm run build:plugin:debug",
     "build:root:debug": "tsup --sourcemap",
-    "build:plugin:debug": "pnpm --filter @agenr/agenr-plugin build:debug",
+    "build:plugin:debug": "pnpm --filter @agenr/agenr-plugin build:debug && pnpm --filter @agenr/skeln-plugin build:debug",
     "dev": "tsup --watch",
-    "internal:recall-eval-server": "pnpm run build:root && node dist/internal-recall-eval-server.js",
+    "internal:eval-server": "pnpm run build:root && node dist/internal-eval-server.js",
+    "internal:recall-eval-server": "pnpm run internal:eval-server",
     "check": "pnpm format:check && pnpm lint && pnpm typecheck && pnpm test",
     "typecheck": "tsc --noEmit",
     "typecheck:tests": "tsc --noEmit -p tsconfig.tests.json",

package/dist/ports-D2NOK2gR.d.ts

@@ -1,256 +0,0 @@
-/**
- * Core domain types for agenr.
- * These types have zero infrastructure dependencies.
- */
-/** Ordered list of supported durable knowledge entry categories. */
-declare const ENTRY_TYPES: readonly ["fact", "decision", "preference", "lesson", "relationship", "milestone"];
-/**
- * Union of all supported knowledge entry categories.
- */
-type EntryType = (typeof ENTRY_TYPES)[number];
-/** Ordered list of supported recall durability levels. */
-declare const EXPIRY_LEVELS: readonly ["core", "permanent", "temporary"];
-/** Ordered list of supported claim-key lifecycle statuses. */
-declare const CLAIM_KEY_STATUSES: readonly ["trusted", "tentative", "unresolved"];
-/** Ordered list of supported claim-key provenance sources. */
-declare const CLAIM_KEY_SOURCES: readonly ["manual", "model", "json_retry", "deterministic_repair", "surgeon_metadata_rewrite", "surgeon_family_reuse", "surgeon_compaction"];
-/** Ordered list of supported claim-support provenance modes. */
-declare const CLAIM_SUPPORT_MODES: readonly ["explicit", "normalized", "inferred"];
-
-/**
- * Union of all supported recall durability levels.
- */
-type Expiry = (typeof EXPIRY_LEVELS)[number];
-/**
- * Union of all supported claim-key lifecycle statuses.
- */
-type ClaimKeyStatus = (typeof CLAIM_KEY_STATUSES)[number];
-/**
- * Union of all supported claim-key provenance sources.
- */
-type ClaimKeySource = (typeof CLAIM_KEY_SOURCES)[number];
-/**
- * Union of all supported claim-support provenance modes.
- */
-type ClaimSupportMode = (typeof CLAIM_SUPPORT_MODES)[number];
-/**
- * Explicit lifecycle and provenance metadata attached to a stored claim key.
- */
-interface ClaimKeyLifecycleMetadata {
-    claim_key_raw?: string;
-    claim_key_status?: ClaimKeyStatus;
-    claim_key_source?: ClaimKeySource;
-    claim_key_confidence?: number;
-    claim_key_rationale?: string;
-    claim_support_source_kind?: string;
-    claim_support_locator?: string;
-    claim_support_observed_at?: string;
-    claim_support_mode?: ClaimSupportMode;
-}
-/**
- * Canonical stored knowledge record.
- */
-interface Entry extends ClaimKeyLifecycleMetadata {
-    id: string;
-    type: EntryType;
-    subject: string;
-    content: string;
-    importance: number;
-    expiry: Expiry;
-    tags: string[];
-    source_file?: string;
-    source_context?: string;
-    embedding?: number[];
-    content_hash?: string;
-    norm_content_hash?: string;
-    quality_score: number;
-    recall_count: number;
-    last_recalled_at?: string;
-    superseded_by?: string;
-    valid_from?: string;
-    valid_to?: string;
-    claim_key?: string;
-    supersession_kind?: string;
-    supersession_reason?: string;
-    cluster_id?: string;
-    user_id?: string;
-    project?: string;
-    retired: boolean;
-    retired_at?: string;
-    retired_reason?: string;
-    created_at: string;
-    updated_at: string;
-}
-/**
- * Normalized transcript message emitted by transcript adapters.
- */
-interface TranscriptMessage {
-    index: number;
-    role: "user" | "assistant";
-    text: string;
-    timestamp?: string;
-}
-/**
- * Session-level metadata derived while parsing a transcript file.
- */
-interface SessionTranscriptMetadata {
-    sessionId?: string;
-    startedAt?: string;
-    endedAt?: string;
-    messageCount: number;
-    transcriptHash: string;
-}
-/**
- * Parsed transcript metadata exposed to transcript consumers.
- */
-interface ParsedTranscriptMetadata extends SessionTranscriptMetadata {
-    sessionLabel?: string;
-    modelsUsed?: string[];
-    /** Best-effort surface reconstructed from transcript content. */
-    reconstructedSurface?: string | null;
-    /** Provenance for the reconstructed surface value. */
-    surfaceReconstructionSource?: "reconstructed" | "none";
-    /** Stable source identity derived by the transcript adapter when available. */
-    sourceIdentity?: string;
-    /** Adapter-specific kind describing the stable source identity. */
-    sourceIdentityKind?: string;
-    /** Best-effort working-directory or workspace path for the session. */
-    workingDirectory?: string;
-    /** Explicit user identifier carried by the transcript source when available. */
-    userId?: string;
-    /** Explicit project identifier carried by the transcript source when available. */
-    project?: string;
-}
-/**
- * Parsed transcript with normalized messages and source metadata.
- */
-interface ParsedTranscript {
-    messages: TranscriptMessage[];
-    metadata: ParsedTranscriptMetadata;
-    warnings: string[];
-}
-
-/**
- * Internal ranking profiles that adjust recall scoring for specific query intents.
- */
-type RecallRankingProfile = "historical_state";
-/**
- * Input payload for historical-state predecessor expansion.
- *
- * The params object can grow over time with additional lineage signals such as
- * claim keys without changing the recall port signature.
- */
-interface HistoricalPredecessorLookupParams {
-    activeEntryIds: string[];
-}
-/**
- * Input to the v1 recall pipeline.
- */
-interface RecallInput {
-    text: string;
-    limit?: number;
-    threshold?: number;
-    budget?: number;
-    types?: EntryType[];
-    tags?: string[];
-    since?: string;
-    until?: string;
-    around?: string;
-    aroundRadius?: number;
-    asOf?: string;
-    sessionKey?: string;
-    rankingProfile?: RecallRankingProfile;
-}
-/**
- * A single scored recall result with signal breakdown metadata.
- */
-interface RecallOutput {
-    entry: Entry;
-    score: number;
-    scores: {
-        relevance: number;
-        vector: number;
-        lexical: number;
-        recency: number;
-        importance: number;
-        historicalLineage: number;
-        claimKeyTrustPenalty: number;
-        claimKeyRedundancyPenalty: number;
-    };
-}
-/**
- * Minimal entry fields needed during recall scoring before final hydration.
- */
-type RecallCandidateEntry = Pick<Entry, "id" | "subject" | "content" | "importance" | "expiry" | "created_at" | "embedding" | "superseded_by" | "claim_key" | "claim_key_status" | "claim_support_observed_at" | "valid_from" | "valid_to" | "retired">;
-/**
- * A candidate returned from vector search with ranking-time entry data.
- */
-interface VectorCandidate {
-    entry: RecallCandidateEntry;
-    vectorSim: number;
-}
-/**
- * A candidate returned from lexical FTS search with ranking-time entry data.
- *
- * BM25 rank is used for admission only and is not part of the final score.
- */
-interface FtsCandidate {
-    entry: RecallCandidateEntry;
-    rank: number;
-    tier: "exact" | "all_tokens" | "any_tokens";
-}
-/**
- * Filters that the core recall pipeline can push down into adapter queries.
- */
-interface EntryFilters {
-    types?: EntryType[];
-    tags?: string[];
-    since?: Date;
-    until?: Date;
-}
-
-/**
- * Query-time retrieval contract used by the v1 recall pipeline.
- */
-interface RecallPorts {
-    /** Compute a single embedding for a recall query string. */
-    embed(text: string): Promise<number[]>;
-    /** Search vector candidates with adapter-level filtering applied. */
-    vectorSearch(params: {
-        embedding: number[];
-        limit: number;
-        filters?: EntryFilters;
-    }): Promise<VectorCandidate[]>;
-    /** Search FTS candidates with adapter-level filtering applied. */
-    ftsSearch(params: {
-        text: string;
-        limit: number;
-        filters?: EntryFilters;
-    }): Promise<FtsCandidate[]>;
-    /**
-     * Fetch inactive lineage-linked candidates for historical-state expansion.
-     *
-     * The adapter should keep this scoped to the provided active entry IDs and
-     * only return historical candidates that are plausibly about the same slot.
-     */
-    fetchPredecessors?(params: HistoricalPredecessorLookupParams): Promise<RecallCandidateEntry[]>;
-    /** Hydrate fully populated entries for the final ranked result set. */
-    hydrateEntries(ids: string[]): Promise<Entry[]>;
-    /** Persist recall events for the returned entry set. */
-    recordRecallEvents(params: {
-        entryIds: string[];
-        query: string;
-        sessionKey?: string;
-    }): Promise<void>;
-}
-/**
- * Transcript source contract for parsing external session files into core types.
- */
-interface TranscriptPort {
-    /** Parse a raw session file into a structured transcript. */
-    parseFile(filePath: string, options?: {
-        verbose?: boolean;
-    }): Promise<ParsedTranscript>;
-}
-
-export type { Expiry as E, FtsCandidate as F, HistoricalPredecessorLookupParams as H, ParsedTranscript as P, RecallInput as R, TranscriptPort as T, VectorCandidate as V, EntryType as a, RecallPorts as b, RecallOutput as c, EntryFilters as d, RecallCandidateEntry as e, RecallRankingProfile as f };