@fgv/ts-agent-memory 5.1.0-39 → 5.1.0-41

package/etc/ts-agent-memory.api.md

@@ -96,6 +96,12 @@ export function defaultMemoryScopeEncoding(scope: MemoryScopeKey): Result<string
 // @public
 export const edgeConverter: Converter<IEdge>;
 
+// @public
+export const edgeTargetConverter: Converter<IEdgeTarget>;
+
+// @public
+export function edgeTargetKey(target: IEdgeTarget): string;
+
 // @public
 export type EntityId = Brand<string, 'EntityId'>;
 
@@ -107,11 +113,13 @@ export const envelopeYamlConverter: Converter<IMemoryEnvelope>;
 
 // @public
 export class FileTreeMemoryStore implements IMemoryStore {
+    asRecordSource(): IMemoryRecordSource;
     static create(params: IFileTreeMemoryStoreCreateParams): Result<FileTreeMemoryStore>;
     delete(kind: Kind, entityId: EntityId): Promise<Result<MemoryId>>;
     get(kind: Kind, entityId: EntityId): Promise<Result<IMemoryRecord<unknown> | undefined>>;
     getById(scope: MemoryScopeKey, id: MemoryId): Promise<Result<IMemoryRecord<unknown> | undefined>>;
     list(filter?: IMemoryStoreListFilter): Promise<Result<ReadonlyArray<IMemoryRecord<unknown>>>>;
+    listScoped(): Promise<Result<ReadonlyArray<IScopedMemoryRecord>>>;
     put(record: IMemoryRecord<unknown>): Promise<Result<IMemoryRecord<unknown>>>;
 }
 
@@ -147,7 +155,7 @@ export interface IBodyConverterRegistry {
 // @public
 export interface ICandidateEdge {
     readonly edge: IEdge;
-    readonly source: MemoryId;
+    readonly source: IEdgeTarget;
 }
 
 // @public
@@ -162,6 +170,7 @@ export interface ICreateMemoryToolsParams {
     readonly defaultCodec?: IIdentityCodec;
     readonly handleFor?: (record: IMemoryRecord<unknown>) => string;
     readonly kinds?: ReadonlyArray<Kind>;
+    readonly projectItem?: (record: IMemoryRecord<unknown>, detail: MemoryDetailTier) => IMemoryToolResultItem;
     readonly registry: IBodyConverterRegistry;
     readonly retriever: IMemoryRetriever;
     readonly store: IMemoryStore;
@@ -171,9 +180,9 @@ export interface ICreateMemoryToolsParams {
 // @public
 export interface ICycleGuardEdge {
     // (undocumented)
-    readonly source: MemoryId;
+    readonly source: IEdgeTarget;
     // (undocumented)
-    readonly target: MemoryId;
+    readonly target: IEdgeTarget;
     // (undocumented)
     readonly type: LinkType;
 }
@@ -183,16 +192,22 @@ export interface IEdge {
     readonly confidence?: number;
     readonly invalid_at?: number | null;
     readonly provenance?: IProvenance;
-    readonly target: MemoryId;
+    readonly target: IEdgeTarget;
     readonly type: LinkType;
     readonly valid_at?: number;
 }
 
 // @public
-export interface IEntityResolutionCandidate {
+export interface IEdgeTarget {
     readonly id: MemoryId;
+    readonly scope: MemoryScopeKey;
+}
+
+// @public
+export interface IEntityResolutionCandidate {
     readonly record: IMemoryRecord<unknown>;
     readonly score: number;
+    readonly target: IEdgeTarget;
 }
 
 // @public
@@ -213,6 +228,7 @@ export interface IFileTreeMemoryStoreCreateParams {
     readonly embed?: MemoryEmbedder;
     readonly logger?: Logging.ILogger;
     readonly observers?: ReadonlyArray<IMemoryObserver>;
+    readonly rankProjectors?: ReadonlyMap<Kind, RankProjector>;
     readonly registry: IBodyConverterRegistry;
     readonly root: FileTree.IMutableFileTreeDirectoryItem;
     readonly scopeEncoding?: (scope: MemoryScopeKey) => Result<string>;
@@ -256,7 +272,7 @@ export interface IIngestItem {
     readonly content: unknown;
     readonly id: string;
     readonly metadata?: Record<string, unknown>;
-    readonly sourceId?: MemoryId;
+    readonly sourceId?: IEdgeTarget;
 }
 
 // @public
@@ -294,6 +310,7 @@ export interface IMemoryEnvelope {
     readonly kind: Kind;
     readonly links: ReadonlyArray<IEdge>;
     readonly provenance: IProvenance;
+    readonly rank?: number;
     readonly seq: number;
     readonly tags: ReadonlyArray<Tag>;
     readonly temporal?: ITemporalBlock;
@@ -308,8 +325,9 @@ export interface IMemoryFileParts {
 
 // @public
 export interface IMemoryIndex {
-    backlinks(target: MemoryId): ReadonlyArray<MemoryId>;
+    backlinks(target: IEdgeTarget): ReadonlyArray<IEdgeTarget>;
     byKind(kind: Kind): ReadonlyArray<IMemoryRecord<unknown>>;
+    byRank(): ReadonlyArray<IMemoryRecord<unknown>>;
     byRecency(): ReadonlyArray<IMemoryRecord<unknown>>;
     byTag(tag: Tag): ReadonlyArray<IMemoryRecord<unknown>>;
     entries(): ReadonlyArray<IIndexedMemoryRecord>;
@@ -384,9 +402,12 @@ export interface IMemoryQuery {
     readonly filter?: (record: IMemoryRecord<unknown>) => boolean;
     readonly hops?: number;
     readonly kind?: Kind;
+    readonly kinds?: ReadonlyArray<Kind>;
     readonly limit?: number;
-    readonly linkedFrom?: MemoryId;
-    readonly linkedTo?: MemoryId;
+    readonly linkedFrom?: IEdgeTarget;
+    readonly linkedTo?: IEdgeTarget;
+    readonly offset?: number;
+    readonly orderBy?: 'recency' | 'rank';
     readonly scope?: MemoryScopeKey;
     readonly semantic?: string;
     readonly tag?: Tag;
@@ -401,7 +422,7 @@ export interface IMemoryRecord<TBody = unknown> {
 
 // @public
 export interface IMemoryRecordSource {
-    list(): Promise<Result<ReadonlyArray<IMemoryRecord<unknown>>>>;
+    list(): Promise<Result<ReadonlyArray<IScopedMemoryRecord>>>;
 }
 
 // @public
@@ -419,10 +440,12 @@ export interface IMemoryRetrieverCapabilities {
 
 // @public
 export interface IMemoryStore {
+    asRecordSource(): IMemoryRecordSource;
     delete(kind: Kind, entityId: EntityId): Promise<Result<MemoryId>>;
     get(kind: Kind, entityId: EntityId): Promise<Result<IMemoryRecord<unknown> | undefined>>;
     getById(scope: MemoryScopeKey, id: MemoryId): Promise<Result<IMemoryRecord<unknown> | undefined>>;
     list(filter?: IMemoryStoreListFilter): Promise<Result<ReadonlyArray<IMemoryRecord<unknown>>>>;
+    listScoped(): Promise<Result<ReadonlyArray<IScopedMemoryRecord>>>;
     put(record: IMemoryRecord<unknown>): Promise<Result<IMemoryRecord<unknown>>>;
 }
 
@@ -464,11 +487,11 @@ export type IngestDisposition = 'written' | 'deduped' | 'merged';
 
 // @public
 export class InMemoryCosineIndex implements IVectorIndex {
-    add(id: MemoryId, vector: Float32Array): Promise<Result<string>>;
+    add(target: IEdgeTarget, vector: Float32Array): Promise<Result<string>>;
     static create(): Result<InMemoryCosineIndex>;
     query(vector: Float32Array, topK: number): Promise<Result<ReadonlyArray<IVectorQueryHit>>>;
     rebuild(source: IMemoryRecordSource, embed: MemoryEmbedder): Promise<Result<number>>;
-    remove(id: MemoryId): Promise<Result<MemoryId>>;
+    remove(target: IEdgeTarget): Promise<Result<IEdgeTarget>>;
     get size(): number;
 }
 
@@ -477,7 +500,7 @@ export interface IProvenance {
     readonly [key: string]: unknown;
     readonly by?: string;
     readonly confidence?: number;
-    readonly derivedFrom?: MemoryId;
+    readonly derivedFrom?: IEdgeTarget;
     readonly model?: string;
     readonly source: ProvenanceSource;
 }
@@ -485,7 +508,7 @@ export interface IProvenance {
 // @public
 export interface IRelationCandidate {
     readonly candidate: ICandidateRecord;
-    readonly id: MemoryId;
+    readonly id: IEdgeTarget;
 }
 
 // @public
@@ -499,6 +522,12 @@ export interface IRelationExtractor {
     relate(context: IRelationContext): Promise<Result<ReadonlyArray<ICandidateEdge>>>;
 }
 
+// @public
+export interface IScopedMemoryRecord {
+    readonly record: IMemoryRecord<unknown>;
+    readonly target: IEdgeTarget;
+}
+
 // @public
 export interface ISemanticBackend {
     readonly embedQuery: QueryEmbedder;
@@ -543,15 +572,15 @@ export interface ITemporalVersionAddress {
 
 // @public
 export interface IVectorIndex {
-    add(id: MemoryId, vector: Float32Array): Promise<Result<string>>;
+    add(target: IEdgeTarget, vector: Float32Array): Promise<Result<string>>;
     query(vector: Float32Array, topK: number): Promise<Result<ReadonlyArray<IVectorQueryHit>>>;
-    remove(id: MemoryId): Promise<Result<MemoryId>>;
+    remove(target: IEdgeTarget): Promise<Result<IEdgeTarget>>;
 }
 
 // @public
 export interface IVectorQueryHit {
-    readonly id: MemoryId;
     readonly score: number;
+    readonly target: IEdgeTarget;
 }
 
 // @public
@@ -586,7 +615,7 @@ export class KnowledgeLwwPolicy implements IWritePolicy {
 }
 
 // @public
-export function limitRecords(records: ReadonlyArray<IMemoryRecord<unknown>>, limit?: number): ReadonlyArray<IMemoryRecord<unknown>>;
+export function limitRecords(records: ReadonlyArray<IMemoryRecord<unknown>>, limit?: number, offset?: number): ReadonlyArray<IMemoryRecord<unknown>>;
 
 // @public
 export const LINK_TRAVERSAL_NO_SEED_MESSAGE: string;
@@ -621,6 +650,9 @@ export class MemoryCapCullPolicy implements IWritePolicy {
     readonly mutableFields: ReadonlyArray<string>;
 }
 
+// @public
+export type MemoryDetailTier = 'gist' | 'full';
+
 // @public
 export type MemoryEmbedder = (record: IMemoryRecord<unknown>) => Promise<Result<Float32Array>>;
 
@@ -629,8 +661,9 @@ export type MemoryId = Brand<string, 'MemoryId'>;
 
 // @public
 export class MemoryIndex implements IMemoryIndex {
-    backlinks(target: MemoryId): ReadonlyArray<MemoryId>;
+    backlinks(target: IEdgeTarget): ReadonlyArray<IEdgeTarget>;
     byKind(kind: Kind): ReadonlyArray<IMemoryRecord<unknown>>;
+    byRank(): ReadonlyArray<IMemoryRecord<unknown>>;
     byRecency(): ReadonlyArray<IMemoryRecord<unknown>>;
     byTag(tag: Tag): ReadonlyArray<IMemoryRecord<unknown>>;
     static create(): Result<MemoryIndex>;
@@ -686,6 +719,9 @@ export class MtmIdentityCodec implements IIdentityCodec {
 // @public
 export const NON_SEMANTIC_CAPABILITIES: IMemoryRetrieverCapabilities;
 
+// @public
+export function orderingCompare(orderBy?: IMemoryQuery['orderBy']): (a: IMemoryRecord<unknown>, b: IMemoryRecord<unknown>) => number;
+
 // @public
 export function parseMemoryFile(raw: string, registry: IBodyConverterRegistry): Result<IMemoryRecord<unknown>>;
 
@@ -698,6 +734,12 @@ export type ProvenanceSource = 'agent' | 'host-ingest' | 'human' | (string & {})
 // @public
 export type QueryEmbedder = (text: string) => Promise<Result<Float32Array>>;
 
+// @public
+export function rankCompare(a: IMemoryRecord<unknown>, b: IMemoryRecord<unknown>): number;
+
+// @public
+export type RankProjector = (record: IMemoryRecord<unknown>) => number;
+
 // @public
 export function recencyCompare(a: IMemoryRecord<unknown>, b: IMemoryRecord<unknown>): number;
 
@@ -713,13 +755,13 @@ export type ResolutionVerdict = {
     readonly verdict: 'new';
 } | {
     readonly verdict: 'duplicate-of';
-    readonly target: MemoryId;
+    readonly target: IEdgeTarget;
 } | {
     readonly verdict: 'supersede';
-    readonly target: MemoryId;
+    readonly target: IEdgeTarget;
 } | {
     readonly verdict: 'merge-into';
-    readonly target: MemoryId;
+    readonly target: IEdgeTarget;
 };
 
 // @public

package/lib/packlets/converters/envelopeConverter.d.ts

@@ -1,6 +1,13 @@
 import { Converter, Result } from '@fgv/ts-utils';
-import { IEdge, IMemoryEnvelope, IMemoryRecord, IProvenance, ITemporalBlock } from '../types';
+import { IEdge, IEdgeTarget, IMemoryEnvelope, IMemoryRecord, IProvenance, ITemporalBlock } from '../types';
 import { IBodyConverterRegistry } from './bodyConverterRegistry';
+/**
+ * Converter for a scope-qualified {@link IEdgeTarget}. Both `scope` and `id`
+ * are required — the whole point of the scoped target is that a bare id is
+ * ambiguous across scopes.
+ * @public
+ */
+export declare const edgeTargetConverter: Converter<IEdgeTarget>;
 /**
  * Converter for {@link IProvenance}. Validates the known fields and preserves
  * any extension keys verbatim (the `[key: string]: unknown` opaque payload),

package/lib/packlets/converters/envelopeConverter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"envelopeConverter.d.ts","sourceRoot":"","sources":["../../../src/packlets/converters/envelopeConverter.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,SAAS,EAAc,MAAM,EAAiB,MAAM,eAAe,CAAC;AAE7E,OAAO,EAAW,KAAK,EAAE,eAAe,EAAE,aAAa,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AACvG,OAAO,EAAE,sBAAsB,EAAE,MAAM,yBAAyB,CAAC;AAqCjE;;;;;GAKG;AACH,eAAO,MAAM,mBAAmB,EAAE,SAAS,CAAC,WAAW,CAUtD,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,aAAa,EAAE,SAAS,CAAC,KAAK,CAU1C,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,iBAAiB,EAAE,SAAS,CAAC,cAAc,CAMvD,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,EAAE,SAAS,CAAC,eAAe,CAgBxD,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,qBAAqB,EAAE,SAAS,CAAC,eAAe,CAAyC,CAAC;AAKvG;;;;GAIG;AACH,MAAM,WAAW,gBAAgB;IAC/B,sDAAsD;IACtD,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,yDAAyD;IACzD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAC,gBAAgB,CAAC,CAuBtE;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,WAAW,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAGzE;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAC7B,GAAG,EAAE,MAAM,EACX,QAAQ,EAAE,sBAAsB,GAC/B,MAAM,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC,CAYhC;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,eAAe,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,CAI3F"}
+{"version":3,"file":"envelopeConverter.d.ts","sourceRoot":"","sources":["../../../src/packlets/converters/envelopeConverter.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,SAAS,EAAc,MAAM,EAAiB,MAAM,eAAe,CAAC;AAE7E,OAAO,EAEL,KAAK,EACL,WAAW,EACX,eAAe,EACf,aAAa,EACb,WAAW,EACX,cAAc,EACf,MAAM,UAAU,CAAC;AAClB,OAAO,EAAE,sBAAsB,EAAE,MAAM,yBAAyB,CAAC;AAsBjE;;;;;GAKG;AACH,eAAO,MAAM,mBAAmB,EAAE,SAAS,CAAC,WAAW,CAGrD,CAAC;AAoBH;;;;;GAKG;AACH,eAAO,MAAM,mBAAmB,EAAE,SAAS,CAAC,WAAW,CAUtD,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,aAAa,EAAE,SAAS,CAAC,KAAK,CAU1C,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,iBAAiB,EAAE,SAAS,CAAC,cAAc,CAMvD,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,EAAE,SAAS,CAAC,eAAe,CAiBxD,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,qBAAqB,EAAE,SAAS,CAAC,eAAe,CAAyC,CAAC;AAKvG;;;;GAIG;AACH,MAAM,WAAW,gBAAgB;IAC/B,sDAAsD;IACtD,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,yDAAyD;IACzD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAC,gBAAgB,CAAC,CAuBtE;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,WAAW,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAGzE;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAC7B,GAAG,EAAE,MAAM,EACX,QAAQ,EAAE,sBAAsB,GAC/B,MAAM,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC,CAYhC;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,eAAe,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,CAI3F"}

package/lib/packlets/converters/envelopeConverter.js

@@ -4,7 +4,7 @@
  * SPDX-License-Identifier: MIT
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.envelopeYamlConverter = exports.envelopeConverter = exports.temporalConverter = exports.edgeConverter = exports.provenanceConverter = void 0;
+exports.envelopeYamlConverter = exports.envelopeConverter = exports.temporalConverter = exports.edgeConverter = exports.provenanceConverter = exports.edgeTargetConverter = void 0;
 exports.splitFrontmatter = splitFrontmatter;
 exports.joinFrontmatter = joinFrontmatter;
 exports.parseMemoryFile = parseMemoryFile;
@@ -27,16 +27,29 @@ const stringOrNull = ts_utils_1.Converters.oneOf([
     ts_utils_1.Converters.string,
     nullConverter
 ]);
+/**
+ * Converter for a scope-qualified {@link IEdgeTarget}. Both `scope` and `id`
+ * are required — the whole point of the scoped target is that a bare id is
+ * ambiguous across scopes.
+ * @public
+ */
+exports.edgeTargetConverter = ts_utils_1.Converters.object({
+    scope: types_1.Convert.scopeKey,
+    id: types_1.Convert.memoryId
+});
 /**
  * Converter for the known {@link IProvenance} fields. The full
  * {@link provenanceConverter} layers extension-key preservation on top.
+ * `derivedFrom` is serialized as the nested `{ scope, id }` object (mirroring
+ * {@link edgeConverter | edge}'s scope-qualified `target`) so the provenance
+ * back-reference is unambiguous across scopes.
  */
 const knownProvenanceConverter = ts_utils_1.Converters.object({
     source: ts_utils_1.Converters.string,
     by: ts_utils_1.Converters.string.optional(),
     model: ts_utils_1.Converters.string.optional(),
     confidence: ts_utils_1.Converters.number.optional(),
-    derivedFrom: types_1.Convert.memoryId.optional()
+    derivedFrom: exports.edgeTargetConverter.optional()
 }, { optionalFields: ['by', 'model', 'confidence', 'derivedFrom'] });
 /**
  * Converter for {@link IProvenance}. Validates the known fields and preserves
@@ -58,7 +71,7 @@ exports.provenanceConverter = ts_utils_1.Converters.generic((from) => knownProve
  */
 exports.edgeConverter = ts_utils_1.Converters.object({
     type: types_1.Convert.linkType,
-    target: types_1.Convert.memoryId,
+    target: exports.edgeTargetConverter,
     confidence: ts_utils_1.Converters.number.optional(),
     provenance: exports.provenanceConverter.optional(),
     valid_at: ts_utils_1.Converters.number.optional(),
@@ -87,10 +100,11 @@ exports.envelopeConverter = ts_utils_1.Converters.object({
     updated: ts_utils_1.Converters.number,
     seq: ts_utils_1.Converters.number,
     contentHash: ts_utils_1.Converters.string,
+    rank: ts_utils_1.Converters.number.optional(),
     provenance: exports.provenanceConverter,
     temporal: exports.temporalConverter.optional(),
     embeddingRef: stringOrNull.optional()
-}, { optionalFields: ['temporal', 'embeddingRef'] });
+}, { optionalFields: ['rank', 'temporal', 'embeddingRef'] });
 /**
  * Converter that parses a YAML frontmatter string into an
  * {@link IMemoryEnvelope}.

package/lib/packlets/converters/envelopeConverter.js.map

@@ -1 +1 @@
-{"version":3,"file":"envelopeConverter.js","sourceRoot":"","sources":["../../../src/packlets/converters/envelopeConverter.ts"],"names":[],"mappings":"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","sourcesContent":["/*\n * Copyright (c) 2026 Erik Fortune\n * SPDX-License-Identifier: MIT\n */\n\nimport { Converter, Converters, Result, fail, succeed } from '@fgv/ts-utils';\nimport { Yaml } from '@fgv/ts-extras';\nimport { Convert, IEdge, IMemoryEnvelope, IMemoryRecord, IProvenance, ITemporalBlock } from '../types';\nimport { IBodyConverterRegistry } from './bodyConverterRegistry';\n\n/** Matches exactly the JSON `null` literal. */\n// eslint-disable-next-line @rushstack/no-new-null -- the envelope nullable fields (invalid_at, embeddingRef) carry meaningful null; design-lock §2.3-2.5\nconst nullConverter: Converter<null> = Converters.generic<null>((from: unknown) =>\n  from === null ? succeed(null) : fail('expected null')\n);\n\n/** A nullable epoch-ms value (`number | null`). */\n// eslint-disable-next-line @rushstack/no-new-null -- meaningful null for IEdge/ITemporalBlock.invalid_at; design-lock §2.3-2.4\nconst numberOrNull: Converter<number | null> = Converters.oneOf<number | null>([\n  Converters.number,\n  nullConverter\n]);\n\n/** A nullable string value (`string | null`). */\n// eslint-disable-next-line @rushstack/no-new-null -- meaningful null for IMemoryEnvelope.embeddingRef; design-lock §2.5\nconst stringOrNull: Converter<string | null> = Converters.oneOf<string | null>([\n  Converters.string,\n  nullConverter\n]);\n\n/**\n * Converter for the known {@link IProvenance} fields. The full\n * {@link provenanceConverter} layers extension-key preservation on top.\n */\nconst knownProvenanceConverter: Converter<IProvenance> = Converters.object<IProvenance>(\n  {\n    source: Converters.string,\n    by: Converters.string.optional(),\n    model: Converters.string.optional(),\n    confidence: Converters.number.optional(),\n    derivedFrom: Convert.memoryId.optional()\n  },\n  { optionalFields: ['by', 'model', 'confidence', 'derivedFrom'] }\n);\n\n/**\n * Converter for {@link IProvenance}. Validates the known fields and preserves\n * any extension keys verbatim (the `[key: string]: unknown` opaque payload),\n * so a round-trip never drops consumer-attached data.\n * @public\n */\nexport const provenanceConverter: Converter<IProvenance> = Converters.generic<IProvenance>(\n  (from: unknown): Result<IProvenance> =>\n    knownProvenanceConverter.convert(from).onSuccess((known) => {\n      // `from` is guaranteed to be a non-null object here — the known-field\n      // converter only succeeds on objects. Spread the original keys first,\n      // then the validated/normalized known fields on top, so extension keys\n      // survive while the known fields carry their converted values.\n      const merged: IProvenance = { ...(from as Record<string, unknown>), ...known };\n      return succeed(merged);\n    })\n);\n\n/**\n * Converter for an attributed {@link IEdge}.\n * @public\n */\nexport const edgeConverter: Converter<IEdge> = Converters.object<IEdge>(\n  {\n    type: Convert.linkType,\n    target: Convert.memoryId,\n    confidence: Converters.number.optional(),\n    provenance: provenanceConverter.optional(),\n    valid_at: Converters.number.optional(),\n    invalid_at: numberOrNull.optional()\n  },\n  { optionalFields: ['confidence', 'provenance', 'valid_at', 'invalid_at'] }\n);\n\n/**\n * Converter for the optional {@link ITemporalBlock}.\n * @public\n */\nexport const temporalConverter: Converter<ITemporalBlock> = Converters.object<ITemporalBlock>(\n  {\n    valid_at: Converters.number.optional(),\n    invalid_at: numberOrNull.optional()\n  },\n  { optionalFields: ['valid_at', 'invalid_at'] }\n);\n\n/**\n * Converter for the invariant {@link IMemoryEnvelope}. Validates a plain\n * object (e.g. parsed YAML frontmatter) into a typed envelope.\n * @public\n */\nexport const envelopeConverter: Converter<IMemoryEnvelope> = Converters.object<IMemoryEnvelope>(\n  {\n    id: Convert.memoryId,\n    entityId: Convert.entityId,\n    kind: Convert.kind,\n    tags: Converters.arrayOf(Convert.tag),\n    links: Converters.arrayOf(edgeConverter),\n    created: Converters.number,\n    updated: Converters.number,\n    seq: Converters.number,\n    contentHash: Converters.string,\n    provenance: provenanceConverter,\n    temporal: temporalConverter.optional(),\n    embeddingRef: stringOrNull.optional()\n  },\n  { optionalFields: ['temporal', 'embeddingRef'] }\n);\n\n/**\n * Converter that parses a YAML frontmatter string into an\n * {@link IMemoryEnvelope}.\n * @public\n */\nexport const envelopeYamlConverter: Converter<IMemoryEnvelope> = Yaml.yamlConverter(envelopeConverter);\n\n/** The frontmatter delimiter line. */\nconst FRONTMATTER_DELIMITER: string = '---';\n\n/**\n * The two parts of a memory file: the YAML frontmatter (between the `---`\n * delimiters) and the markdown body (everything after the closing delimiter).\n * @public\n */\nexport interface IMemoryFileParts {\n  /** The raw YAML frontmatter (delimiters stripped). */\n  readonly frontmatter: string;\n  /** The raw body text following the closing delimiter. */\n  readonly body: string;\n}\n\n/**\n * Split a `---\\n<yaml>\\n---\\n<body>` memory file into its frontmatter and\n * body parts. Pure string handling — no external dependency.\n * @public\n */\nexport function splitFrontmatter(raw: string): Result<IMemoryFileParts> {\n  // Split on '\\n' and strip a trailing '\\r' per line so CRLF-authored files\n  // parse identically to LF — otherwise the '\\r' would ride along into the\n  // returned frontmatter (perturbing YAML parsing) and body (corrupting\n  // round-trip fidelity).\n  const lines: string[] = raw.split('\\n').map((line) => (line.endsWith('\\r') ? line.slice(0, -1) : line));\n  if (lines[0].trim() !== FRONTMATTER_DELIMITER) {\n    return fail(\"memory file: missing opening frontmatter delimiter '---'\");\n  }\n  let closeIndex: number = -1;\n  for (let i = 1; i < lines.length; i++) {\n    if (lines[i].trim() === FRONTMATTER_DELIMITER) {\n      closeIndex = i;\n      break;\n    }\n  }\n  if (closeIndex === -1) {\n    return fail(\"memory file: missing closing frontmatter delimiter '---'\");\n  }\n  return succeed({\n    frontmatter: lines.slice(1, closeIndex).join('\\n'),\n    body: lines.slice(closeIndex + 1).join('\\n')\n  });\n}\n\n/**\n * Join a YAML frontmatter string and a body into the canonical\n * `---\\n<yaml>\\n---\\n<body>` memory-file format.\n * @public\n */\nexport function joinFrontmatter(frontmatter: string, body: string): string {\n  const normalized: string = frontmatter.endsWith('\\n') ? frontmatter : `${frontmatter}\\n`;\n  return `${FRONTMATTER_DELIMITER}\\n${normalized}${FRONTMATTER_DELIMITER}\\n${body}`;\n}\n\n/**\n * Parse a complete memory file into a typed {@link IMemoryRecord}. Splits the\n * frontmatter, validates the envelope, and dispatches the body through the\n * registered Converter for the envelope's kind.\n * @public\n */\nexport function parseMemoryFile(\n  raw: string,\n  registry: IBodyConverterRegistry\n): Result<IMemoryRecord<unknown>> {\n  return splitFrontmatter(raw).onSuccess((parts) =>\n    envelopeYamlConverter\n      .convert(parts.frontmatter)\n      .withErrorFormat((msg) => `memory file: invalid envelope: ${msg}`)\n      .onSuccess((envelope) =>\n        registry\n          .convert(envelope.kind, parts.body)\n          .withErrorFormat((msg) => `memory file '${envelope.id}': invalid body: ${msg}`)\n          .onSuccess((body) => succeed({ envelope, body }))\n      )\n  );\n}\n\n/**\n * Serialize an envelope and its rendered body text into a memory file. The\n * envelope is emitted as YAML frontmatter; the body is written verbatim after\n * the closing delimiter.\n * @public\n */\nexport function serializeMemoryFile(envelope: IMemoryEnvelope, body: string): Result<string> {\n  return Yaml.yamlStringify(envelope)\n    .withErrorFormat((msg) => `memory file '${envelope.id}': failed to serialize envelope: ${msg}`)\n    .onSuccess((frontmatter) => succeed(joinFrontmatter(frontmatter, body)));\n}\n"]}
+{"version":3,"file":"envelopeConverter.js","sourceRoot":"","sources":["../../../src/packlets/converters/envelopeConverter.ts"],"names":[],"mappings":"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","sourcesContent":["/*\n * Copyright (c) 2026 Erik Fortune\n * SPDX-License-Identifier: MIT\n */\n\nimport { Converter, Converters, Result, fail, succeed } from '@fgv/ts-utils';\nimport { Yaml } from '@fgv/ts-extras';\nimport {\n  Convert,\n  IEdge,\n  IEdgeTarget,\n  IMemoryEnvelope,\n  IMemoryRecord,\n  IProvenance,\n  ITemporalBlock\n} from '../types';\nimport { IBodyConverterRegistry } from './bodyConverterRegistry';\n\n/** Matches exactly the JSON `null` literal. */\n// eslint-disable-next-line @rushstack/no-new-null -- the envelope nullable fields (invalid_at, embeddingRef) carry meaningful null; design-lock §2.3-2.5\nconst nullConverter: Converter<null> = Converters.generic<null>((from: unknown) =>\n  from === null ? succeed(null) : fail('expected null')\n);\n\n/** A nullable epoch-ms value (`number | null`). */\n// eslint-disable-next-line @rushstack/no-new-null -- meaningful null for IEdge/ITemporalBlock.invalid_at; design-lock §2.3-2.4\nconst numberOrNull: Converter<number | null> = Converters.oneOf<number | null>([\n  Converters.number,\n  nullConverter\n]);\n\n/** A nullable string value (`string | null`). */\n// eslint-disable-next-line @rushstack/no-new-null -- meaningful null for IMemoryEnvelope.embeddingRef; design-lock §2.5\nconst stringOrNull: Converter<string | null> = Converters.oneOf<string | null>([\n  Converters.string,\n  nullConverter\n]);\n\n/**\n * Converter for a scope-qualified {@link IEdgeTarget}. Both `scope` and `id`\n * are required — the whole point of the scoped target is that a bare id is\n * ambiguous across scopes.\n * @public\n */\nexport const edgeTargetConverter: Converter<IEdgeTarget> = Converters.object<IEdgeTarget>({\n  scope: Convert.scopeKey,\n  id: Convert.memoryId\n});\n\n/**\n * Converter for the known {@link IProvenance} fields. The full\n * {@link provenanceConverter} layers extension-key preservation on top.\n * `derivedFrom` is serialized as the nested `{ scope, id }` object (mirroring\n * {@link edgeConverter | edge}'s scope-qualified `target`) so the provenance\n * back-reference is unambiguous across scopes.\n */\nconst knownProvenanceConverter: Converter<IProvenance> = Converters.object<IProvenance>(\n  {\n    source: Converters.string,\n    by: Converters.string.optional(),\n    model: Converters.string.optional(),\n    confidence: Converters.number.optional(),\n    derivedFrom: edgeTargetConverter.optional()\n  },\n  { optionalFields: ['by', 'model', 'confidence', 'derivedFrom'] }\n);\n\n/**\n * Converter for {@link IProvenance}. Validates the known fields and preserves\n * any extension keys verbatim (the `[key: string]: unknown` opaque payload),\n * so a round-trip never drops consumer-attached data.\n * @public\n */\nexport const provenanceConverter: Converter<IProvenance> = Converters.generic<IProvenance>(\n  (from: unknown): Result<IProvenance> =>\n    knownProvenanceConverter.convert(from).onSuccess((known) => {\n      // `from` is guaranteed to be a non-null object here — the known-field\n      // converter only succeeds on objects. Spread the original keys first,\n      // then the validated/normalized known fields on top, so extension keys\n      // survive while the known fields carry their converted values.\n      const merged: IProvenance = { ...(from as Record<string, unknown>), ...known };\n      return succeed(merged);\n    })\n);\n\n/**\n * Converter for an attributed {@link IEdge}.\n * @public\n */\nexport const edgeConverter: Converter<IEdge> = Converters.object<IEdge>(\n  {\n    type: Convert.linkType,\n    target: edgeTargetConverter,\n    confidence: Converters.number.optional(),\n    provenance: provenanceConverter.optional(),\n    valid_at: Converters.number.optional(),\n    invalid_at: numberOrNull.optional()\n  },\n  { optionalFields: ['confidence', 'provenance', 'valid_at', 'invalid_at'] }\n);\n\n/**\n * Converter for the optional {@link ITemporalBlock}.\n * @public\n */\nexport const temporalConverter: Converter<ITemporalBlock> = Converters.object<ITemporalBlock>(\n  {\n    valid_at: Converters.number.optional(),\n    invalid_at: numberOrNull.optional()\n  },\n  { optionalFields: ['valid_at', 'invalid_at'] }\n);\n\n/**\n * Converter for the invariant {@link IMemoryEnvelope}. Validates a plain\n * object (e.g. parsed YAML frontmatter) into a typed envelope.\n * @public\n */\nexport const envelopeConverter: Converter<IMemoryEnvelope> = Converters.object<IMemoryEnvelope>(\n  {\n    id: Convert.memoryId,\n    entityId: Convert.entityId,\n    kind: Convert.kind,\n    tags: Converters.arrayOf(Convert.tag),\n    links: Converters.arrayOf(edgeConverter),\n    created: Converters.number,\n    updated: Converters.number,\n    seq: Converters.number,\n    contentHash: Converters.string,\n    rank: Converters.number.optional(),\n    provenance: provenanceConverter,\n    temporal: temporalConverter.optional(),\n    embeddingRef: stringOrNull.optional()\n  },\n  { optionalFields: ['rank', 'temporal', 'embeddingRef'] }\n);\n\n/**\n * Converter that parses a YAML frontmatter string into an\n * {@link IMemoryEnvelope}.\n * @public\n */\nexport const envelopeYamlConverter: Converter<IMemoryEnvelope> = Yaml.yamlConverter(envelopeConverter);\n\n/** The frontmatter delimiter line. */\nconst FRONTMATTER_DELIMITER: string = '---';\n\n/**\n * The two parts of a memory file: the YAML frontmatter (between the `---`\n * delimiters) and the markdown body (everything after the closing delimiter).\n * @public\n */\nexport interface IMemoryFileParts {\n  /** The raw YAML frontmatter (delimiters stripped). */\n  readonly frontmatter: string;\n  /** The raw body text following the closing delimiter. */\n  readonly body: string;\n}\n\n/**\n * Split a `---\\n<yaml>\\n---\\n<body>` memory file into its frontmatter and\n * body parts. Pure string handling — no external dependency.\n * @public\n */\nexport function splitFrontmatter(raw: string): Result<IMemoryFileParts> {\n  // Split on '\\n' and strip a trailing '\\r' per line so CRLF-authored files\n  // parse identically to LF — otherwise the '\\r' would ride along into the\n  // returned frontmatter (perturbing YAML parsing) and body (corrupting\n  // round-trip fidelity).\n  const lines: string[] = raw.split('\\n').map((line) => (line.endsWith('\\r') ? line.slice(0, -1) : line));\n  if (lines[0].trim() !== FRONTMATTER_DELIMITER) {\n    return fail(\"memory file: missing opening frontmatter delimiter '---'\");\n  }\n  let closeIndex: number = -1;\n  for (let i = 1; i < lines.length; i++) {\n    if (lines[i].trim() === FRONTMATTER_DELIMITER) {\n      closeIndex = i;\n      break;\n    }\n  }\n  if (closeIndex === -1) {\n    return fail(\"memory file: missing closing frontmatter delimiter '---'\");\n  }\n  return succeed({\n    frontmatter: lines.slice(1, closeIndex).join('\\n'),\n    body: lines.slice(closeIndex + 1).join('\\n')\n  });\n}\n\n/**\n * Join a YAML frontmatter string and a body into the canonical\n * `---\\n<yaml>\\n---\\n<body>` memory-file format.\n * @public\n */\nexport function joinFrontmatter(frontmatter: string, body: string): string {\n  const normalized: string = frontmatter.endsWith('\\n') ? frontmatter : `${frontmatter}\\n`;\n  return `${FRONTMATTER_DELIMITER}\\n${normalized}${FRONTMATTER_DELIMITER}\\n${body}`;\n}\n\n/**\n * Parse a complete memory file into a typed {@link IMemoryRecord}. Splits the\n * frontmatter, validates the envelope, and dispatches the body through the\n * registered Converter for the envelope's kind.\n * @public\n */\nexport function parseMemoryFile(\n  raw: string,\n  registry: IBodyConverterRegistry\n): Result<IMemoryRecord<unknown>> {\n  return splitFrontmatter(raw).onSuccess((parts) =>\n    envelopeYamlConverter\n      .convert(parts.frontmatter)\n      .withErrorFormat((msg) => `memory file: invalid envelope: ${msg}`)\n      .onSuccess((envelope) =>\n        registry\n          .convert(envelope.kind, parts.body)\n          .withErrorFormat((msg) => `memory file '${envelope.id}': invalid body: ${msg}`)\n          .onSuccess((body) => succeed({ envelope, body }))\n      )\n  );\n}\n\n/**\n * Serialize an envelope and its rendered body text into a memory file. The\n * envelope is emitted as YAML frontmatter; the body is written verbatim after\n * the closing delimiter.\n * @public\n */\nexport function serializeMemoryFile(envelope: IMemoryEnvelope, body: string): Result<string> {\n  return Yaml.yamlStringify(envelope)\n    .withErrorFormat((msg) => `memory file '${envelope.id}': failed to serialize envelope: ${msg}`)\n    .onSuccess((frontmatter) => succeed(joinFrontmatter(frontmatter, body)));\n}\n"]}

package/lib/packlets/index/memoryIndex.d.ts

@@ -1,5 +1,5 @@
 import { Result } from '@fgv/ts-utils';
-import { IMemoryRecord, Kind, MemoryId, MemoryScopeKey, Tag } from '../types';
+import { IEdgeTarget, IMemoryRecord, Kind, MemoryScopeKey, Tag } from '../types';
 /**
  * The mutation a {@link IMemoryIndex.patch | patch} applies: a record was
  * written (`'put'`) or removed (`'delete'`).
@@ -55,10 +55,20 @@ export interface IMemoryIndex {
     /** All records in recency order (most-recently-updated first). */
     byRecency(): ReadonlyArray<IMemoryRecord<unknown>>;
     /**
-     * The ids of records whose `links` point AT `target` (inbound edges).
-     * The seed map for B2 link-traversal.
+     * All records ordered by store-computed {@link IMemoryEnvelope.rank} descending,
+     * with recency (most-recently-updated, then `seq`) as a tiebreak. Records with
+     * an absent `rank` sort LAST (after every ranked record), then by recency among
+     * themselves. Serves a bounded top-M ({@link IMemoryEnvelope.rank}-ordered) page
+     * from the in-memory index with no full-vault (filesystem) scan.
      */
-    backlinks(target: MemoryId): ReadonlyArray<MemoryId>;
+    byRank(): ReadonlyArray<IMemoryRecord<unknown>>;
+    /**
+     * The scope-qualified sources of records whose `links` point AT `target`
+     * (inbound edges), keyed on the target's `(scope, id)` address. The seed map
+     * for B2 link-traversal; results are {@link IEdgeTarget}s so a caller can feed
+     * them straight back in as further traversal seeds.
+     */
+    backlinks(target: IEdgeTarget): ReadonlyArray<IEdgeTarget>;
 }
 /**
  * Default in-memory {@link IMemoryIndex}. Maintains the derived `byKind` /
@@ -75,10 +85,13 @@ export declare class MemoryIndex implements IMemoryIndex {
     /** tag → set of composite keys. */
     private readonly _byTag;
     /**
-     * link target id → (source composite key → source id). Keyed by the source's
-     * `(scope, id)` composite — NOT its bare id — so two distinct source records
-     * that share an id across scopes (e.g. `turn-0` in different conversations)
-     * are tracked independently and removing one never drops the other's edge.
+     * canonical target key (`edgeTargetKey`) → (source composite key → source
+     * {@link IEdgeTarget}). The OUTER map is keyed on the scope-qualified target's
+     * canonical `(scope, id)` string — NOT the target's bare id — so an edge to
+     * `turn-3` in one conversation is tracked separately from `turn-3` in another.
+     * The INNER map is keyed by the source's `(scope, id)` composite so two distinct
+     * source records that share an id across scopes are tracked independently and
+     * removing one never drops the other's edge.
      */
     private readonly _backlinks;
     private constructor();
@@ -103,19 +116,38 @@ export declare class MemoryIndex implements IMemoryIndex {
     byTag(tag: Tag): ReadonlyArray<IMemoryRecord<unknown>>;
     /** {@inheritDoc IMemoryIndex.byRecency} */
     byRecency(): ReadonlyArray<IMemoryRecord<unknown>>;
+    /** {@inheritDoc IMemoryIndex.byRank} */
+    byRank(): ReadonlyArray<IMemoryRecord<unknown>>;
     /** {@inheritDoc IMemoryIndex.backlinks} */
-    backlinks(target: MemoryId): ReadonlyArray<MemoryId>;
+    backlinks(target: IEdgeTarget): ReadonlyArray<IEdgeTarget>;
     /**
      * Resolve a set of composite keys to their records, ordered
      * most-recently-updated first (with a `seq` tiebreak so equal-`updated`
      * records sort deterministically).
      */
     private _recencyOrdered;
+    /**
+     * Resolve a set of composite keys to their records, ordered by
+     * {@link IMemoryEnvelope.rank} descending with recency (`updated`, then `seq`)
+     * as the tiebreak. Records with an absent `rank` sort LAST, then by recency
+     * among themselves. Computed on call (mirrors {@link MemoryIndex._recencyOrdered}) —
+     * no incremental rank-ordered view is maintained, matching the recency view's
+     * approach; the sort is over the in-memory index, never a filesystem walk.
+     */
+    private _rankOrdered;
+    /**
+     * Rank-descending comparator with an absent-`rank`-last rule and a recency
+     * (`updated`, then `seq`) tiebreak. Duplicated from the retrieve packlet's
+     * `rankCompare` deliberately: the index must not depend on `retrieve` (that
+     * package depends on the index), mirroring how `_recencyOrdered` inlines the
+     * recency ordering rather than importing `recencyCompare`.
+     */
+    private static _compareByRank;
     /** Insert an entry and register all its derived associations. */
     private _add;
     /** Remove the entry at `key` (if present) and all its derived associations. */
     private _remove;
-    /** Register `sourceId` (keyed by its composite `sourceKey`) as linking at `target`. */
+    /** Register `source` (keyed by its composite `sourceKey`) as linking at `target`. */
     private _addBacklink;
     /** Drop the backlink from `sourceKey` to `target`, removing the target map when empty. */
     private _removeBacklink;

package/lib/packlets/index/memoryIndex.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"memoryIndex.d.ts","sourceRoot":"","sources":["../../../src/packlets/index/memoryIndex.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"memoryIndex.d.ts","sourceRoot":"","sources":["../../../src/packlets/index/memoryIndex.ts"],"names":[],"mappings":"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"}