@fgv/ts-agent-memory 5.1.0-47 → 5.1.0-49

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

@@ -1,940 +0,0 @@
-## API Report File for "@fgv/ts-agent-memory"
-
-> Do not edit this file. It is a report generated by [API Extractor](https://api-extractor.com/).
-
-```ts
-
-import { AiAssist } from '@fgv/ts-extras';
-import { Brand } from '@fgv/ts-utils';
-import { Converter } from '@fgv/ts-utils';
-import { FileTree } from '@fgv/ts-json-base';
-import { JsonSchema } from '@fgv/ts-json-base';
-import { Logging } from '@fgv/ts-utils';
-import { Result } from '@fgv/ts-utils';
-
-// @public
-export type AdmissionDecision = {
-    readonly decision: 'accept';
-} | {
-    readonly decision: 'reject';
-    readonly reason: string;
-} | {
-    readonly decision: 'cull-oldest';
-    readonly evict: ReadonlyArray<MemoryId>;
-};
-
-// @public
-export class AsOfRetriever implements IMemoryRetriever {
-    get capabilities(): IMemoryRetrieverCapabilities;
-    static create(index: IMemoryIndex): Result<AsOfRetriever>;
-    retrieve(query: IMemoryQuery): Promise<Result<ReadonlyArray<IMemoryRecord<unknown>>>>;
-}
-
-// @public
-export function assertNoCycles(existing: ReadonlyArray<ICycleGuardEdge>, proposed: ReadonlyArray<ICycleGuardEdge>): Result<true>;
-
-// @public
-export function assertPortableFilenameStem(stem: string): Result<string>;
-
-// @public
-export class BodyConverterRegistry implements IBodyConverterRegistry {
-    convert(kind: Kind, body: unknown): Result<unknown>;
-    static create(): Result<BodyConverterRegistry>;
-    getConverter(kind: Kind): Result<Converter<unknown>>;
-    has(kind: Kind): boolean;
-    register<T>(kind: Kind, converter: Converter<T>): void;
-    registerSchema<T>(kind: Kind, schema: JsonSchema.ISchemaValidator<T>): void;
-}
-
-// @public
-export function buildCycleKey(edge: ICycleGuardEdge): Result<string>;
-
-// @public
-export const CONTRADICTS_LINK_TYPE: LinkType;
-
-// @public
-export const Convert: {
-    readonly memoryId: Converter<MemoryId>;
-    readonly entityId: Converter<EntityId>;
-    readonly kind: Converter<Kind>;
-    readonly tag: Converter<Tag>;
-    readonly scopeKey: Converter<MemoryScopeKey>;
-    readonly linkType: Converter<LinkType>;
-};
-
-// @public
-export function createMemoryTools(params: ICreateMemoryToolsParams): ReadonlyArray<AiAssist.IAiClientTool>;
-
-// @public
-export class CurrentValidRetriever implements IMemoryRetriever {
-    get capabilities(): IMemoryRetrieverCapabilities;
-    static create(index: IMemoryIndex): Result<CurrentValidRetriever>;
-    retrieve(query: IMemoryQuery): Promise<Result<ReadonlyArray<IMemoryRecord<unknown>>>>;
-}
-
-// @public
-export type CycleGuardMode = 'reject' | 'off';
-
-// @public
-export type DedupScope = 'content' | 'entity';
-
-// @public
-export const DEFAULT_DEDUP_SCOPE: DedupScope;
-
-// @public
-export const DEFAULT_MEMORY_TOOLS: ReadonlyArray<MemoryToolName>;
-
-// @public
-export const DEFAULT_SIMILARITY_THRESHOLD: number;
-
-// @public
-export const DEFAULT_SIMILARITY_TOP_K: number;
-
-// @public
-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 const embeddedFragmentConverter: Converter<IEmbeddedFragment>;
-
-// @public
-export type EntityId = Brand<string, 'EntityId'>;
-
-// @public
-export const envelopeConverter: Converter<IMemoryEnvelope>;
-
-// @public
-export const envelopeYamlConverter: Converter<IMemoryEnvelope>;
-
-// @public
-export class FileTreeMemoryStore implements IMemoryStore {
-    asRecordSource(): IMemoryRecordSource;
-    static create(params: IFileTreeMemoryStoreCreateParams): Result<FileTreeMemoryStore>;
-    dedupScopeFor(kind: Kind): DedupScope;
-    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>>>;
-    get skippedRecords(): ReadonlyArray<ISkippedRecord>;
-}
-
-// @public
-export const FRAGMENT_SEMANTIC_UNWIRED_MESSAGE: string;
-
-// @public
-export type FragmentEmbedder = (record: IMemoryRecord<unknown>) => Promise<Result<ReadonlyArray<IEmbeddedFragment>>>;
-
-// @public
-export const fragmentLocatorConverter: Converter<IFragmentLocator>;
-
-// @public
-export class FragmentSemanticRetriever {
-    get capabilities(): IFragmentRetrieverCapabilities;
-    static create(params: {
-        readonly backend?: IFragmentSemanticBackend;
-    }): Result<FragmentSemanticRetriever>;
-    retrieve(query: IFragmentQuery): Promise<Result<ReadonlyArray<IVectorQueryHit>>>;
-}
-
-// @public
-export function guardRetrieverCapabilities(query: IMemoryQuery, capabilities: IMemoryRetrieverCapabilities): Result<true>;
-
-// @public
-export class HistoryRetriever implements IMemoryRetriever {
-    get capabilities(): IMemoryRetrieverCapabilities;
-    static create(index: IMemoryIndex): Result<HistoryRetriever>;
-    retrieve(query: IMemoryQuery): Promise<Result<ReadonlyArray<IMemoryRecord<unknown>>>>;
-}
-
-// @public
-export const HOST_INGEST_PROVENANCE_SOURCE: string;
-
-// @public
-export class HybridRetriever implements IMemoryRetriever {
-    get capabilities(): IMemoryRetrieverCapabilities;
-    static create(retrievers: ReadonlyArray<IMemoryRetriever>, mergeStrategy: IMergeStrategy): Result<HybridRetriever>;
-    retrieve(query: IMemoryQuery): Promise<Result<ReadonlyArray<IMemoryRecord<unknown>>>>;
-}
-
-// @public
-export interface IBodyConverterRegistry {
-    convert(kind: Kind, body: unknown): Result<unknown>;
-    getConverter(kind: Kind): Result<Converter<unknown>>;
-    has(kind: Kind): boolean;
-    register<T>(kind: Kind, converter: Converter<T>): void;
-    registerSchema<T>(kind: Kind, schema: JsonSchema.ISchemaValidator<T>): void;
-}
-
-// @public
-export interface ICandidateEdge {
-    readonly edge: IEdge;
-    readonly source: IEdgeTarget;
-}
-
-// @public
-export interface ICandidateRecord {
-    readonly body: unknown;
-    readonly envelope: Omit<IMemoryEnvelope, StoreStampedEnvelopeField>;
-}
-
-// @public
-export interface ICreateMemoryToolsParams {
-    readonly codecs?: ReadonlyMap<Kind, IIdentityCodec>;
-    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;
-    readonly tools?: ReadonlyArray<MemoryToolName>;
-}
-
-// @public
-export interface ICycleGuardEdge {
-    // (undocumented)
-    readonly source: IEdgeTarget;
-    // (undocumented)
-    readonly target: IEdgeTarget;
-    // (undocumented)
-    readonly type: LinkType;
-}
-
-// @public
-export interface IEdge {
-    readonly confidence?: number;
-    readonly invalid_at?: number | null;
-    readonly provenance?: IProvenance;
-    readonly target: IEdgeTarget;
-    readonly type: LinkType;
-    readonly valid_at?: number;
-}
-
-// @public
-export interface IEdgeTarget {
-    readonly id: MemoryId;
-    readonly scope: MemoryScopeKey;
-}
-
-// @public
-export interface IEmbeddedFragment {
-    readonly fragmentId?: string;
-    readonly locator?: IFragmentLocator;
-    readonly vector: Float32Array;
-}
-
-// @public
-export interface IEntityResolutionCandidate {
-    readonly record: IMemoryRecord<unknown>;
-    readonly score: number;
-    readonly target: IEdgeTarget;
-}
-
-// @public
-export interface IEntityResolver {
-    resolve(candidate: ICandidateRecord, similar: ReadonlyArray<IEntityResolutionCandidate>): Promise<Result<ResolutionVerdict>>;
-}
-
-// @public
-export interface IFactExtractor {
-    extract(item: IIngestItem, classification: IMemoryClassification): Promise<Result<ReadonlyArray<ICandidateRecord>>>;
-}
-
-// @public
-export interface IFileTreeMemoryStoreCreateParams {
-    readonly clock?: () => number;
-    readonly codecs?: ReadonlyMap<Kind, IIdentityCodec>;
-    readonly defaultCodec?: IIdentityCodec;
-    readonly embed?: MemoryEmbedder;
-    readonly fragmentEmbedder?: FragmentEmbedder;
-    readonly fragmentIndex?: IFragmentVectorIndex;
-    readonly index?: IMemoryIndex;
-    readonly logger?: Logging.ILogger;
-    readonly observers?: ReadonlyArray<IMemoryObserver>;
-    readonly onRecordError?: MemoryRecordErrorMode;
-    readonly rankProjectors?: ReadonlyMap<Kind, RankProjector>;
-    readonly registry: IBodyConverterRegistry;
-    readonly root: FileTree.IMutableFileTreeDirectoryItem;
-    readonly scopeEncoding?: (scope: MemoryScopeKey) => Result<string>;
-    readonly vectorIndex?: IVectorIndex;
-    readonly writePolicies?: ReadonlyMap<Kind, IWritePolicy>;
-}
-
-// @public
-export interface IFragmentLocator {
-    readonly end: number;
-    readonly start: number;
-}
-
-// @public
-export interface IFragmentQuery {
-    readonly maxPerRecord?: number;
-    readonly semantic: string;
-    readonly topK?: number;
-}
-
-// @public
-export interface IFragmentRetrieverCapabilities {
-    readonly supportsFragmentRecall: boolean;
-}
-
-// @public
-export interface IFragmentSemanticBackend {
-    readonly embedQuery: QueryEmbedder;
-    readonly fragmentIndex: IFragmentVectorIndex;
-}
-
-// @public
-export interface IFragmentVectorIndex {
-    addFragments(target: IEdgeTarget, fragments: ReadonlyArray<IEmbeddedFragment>): Promise<Result<number>>;
-    query(vector: Float32Array, topK: number, maxPerRecord?: number): Promise<Result<ReadonlyArray<IVectorQueryHit>>>;
-    remove(target: IEdgeTarget): Promise<Result<IEdgeTarget>>;
-}
-
-// @public
-export interface IIdentityCodec {
-    decode(scope: MemoryScopeKey, encodedStem: string): Result<EntityId>;
-    encode(entityId: EntityId): Result<IIdentityCodecResult>;
-    verifyRoundTrip(scope: MemoryScopeKey, stem: string): Result<true>;
-}
-
-// @public
-export interface IIdentityCodecResult {
-    readonly idStem: string;
-    readonly isVersioned: boolean;
-    readonly scope: MemoryScopeKey;
-}
-
-// @public
-export interface IIndexedMemoryRecord {
-    readonly record: IMemoryRecord<unknown>;
-    readonly scope: MemoryScopeKey;
-}
-
-// @public
-export interface IIngestedRecordResult {
-    readonly candidate: ICandidateRecord;
-    readonly disposition: IngestDisposition;
-    readonly edges: ReadonlyArray<ICandidateEdge>;
-    readonly id: MemoryId;
-    readonly interlock?: 'temporal-versioned';
-    readonly record?: IMemoryRecord<unknown>;
-    readonly resolution: ResolutionVerdict;
-}
-
-// @public
-export interface IIngestItem {
-    readonly content: unknown;
-    readonly id: string;
-    readonly metadata?: Record<string, unknown>;
-    readonly sourceId?: IEdgeTarget;
-}
-
-// @public
-export interface IIngestItemResult {
-    readonly item: IIngestItem;
-    readonly records: ReadonlyArray<IIngestedRecordResult>;
-}
-
-// @public
-export interface IMemoryCapCullPolicyParams {
-    readonly maxRecords?: number;
-    readonly mutableFields: ReadonlyArray<string>;
-}
-
-// @public
-export interface IMemoryClassification {
-    readonly [key: string]: unknown;
-    readonly confidence?: number;
-    readonly kind: Kind;
-    readonly tags?: ReadonlyArray<Tag>;
-}
-
-// @public
-export interface IMemoryClassifier {
-    classify(item: IIngestItem): Promise<Result<IMemoryClassification>>;
-}
-
-// @public
-export interface IMemoryEnvelope {
-    readonly contentHash: string;
-    readonly created: number;
-    readonly embeddingRef?: string | null;
-    readonly entityId: EntityId;
-    readonly id: MemoryId;
-    readonly kind: Kind;
-    readonly links: ReadonlyArray<IEdge>;
-    readonly provenance: IProvenance;
-    readonly rank?: number;
-    readonly seq: number;
-    readonly tags: ReadonlyArray<Tag>;
-    readonly temporal?: ITemporalBlock;
-    readonly updated: number;
-}
-
-// @public
-export interface IMemoryFileParts {
-    readonly body: string;
-    readonly frontmatter: string;
-}
-
-// @public
-export interface IMemoryIndex {
-    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>;
-    patch(op: MemoryIndexPatchOp, entry: IIndexedMemoryRecord): Result<IIndexedMemoryRecord>;
-    rebuild(entries: ReadonlyArray<IIndexedMemoryRecord>): Result<number>;
-}
-
-// @public
-export interface IMemoryIngestOrchestrator {
-    ingestBatch(items: ReadonlyArray<IIngestItem>): Promise<Result<ReadonlyArray<IIngestItemResult>>>;
-    ingestItem(item: IIngestItem): Promise<Result<IIngestItemResult>>;
-}
-
-// @public
-export interface IMemoryIngestOrchestratorCreateParams {
-    readonly classifier: IMemoryClassifier;
-    readonly codecs?: ReadonlyMap<Kind, IIdentityCodec>;
-    readonly cycleGuard?: CycleGuardMode;
-    readonly defaultCodec?: IIdentityCodec;
-    readonly embed?: MemoryEmbedder;
-    readonly entityResolver?: IEntityResolver;
-    readonly extractor: IFactExtractor;
-    readonly logger?: Logging.ILogger;
-    readonly registry: IBodyConverterRegistry;
-    readonly relationExtractor: IRelationExtractor;
-    readonly similarityThreshold?: number;
-    readonly similarityTopK?: number;
-    readonly store: IMemoryStore;
-    readonly vectorIndex?: IVectorIndex;
-}
-
-// @public
-export interface IMemoryObservationQuery {
-    readonly kind?: Kind;
-    readonly limit?: number;
-    readonly outcome?: MemoryObservationOutcome;
-    readonly phase?: MemoryObservationPhase;
-    readonly scope?: MemoryScopeKey;
-    readonly since?: number;
-    readonly sinceSeq?: number;
-    readonly until?: number;
-}
-
-// @public
-export interface IMemoryObservationRecord {
-    readonly error?: string;
-    readonly id?: MemoryId;
-    readonly kind?: Kind;
-    readonly outcome: MemoryObservationOutcome;
-    readonly phase: MemoryObservationPhase;
-    readonly provenance?: IProvenance;
-    readonly querySnapshot?: Readonly<Record<string, unknown>>;
-    readonly scope?: MemoryScopeKey;
-    readonly seq: number;
-    readonly timestamp: number;
-}
-
-// @public
-export interface IMemoryObservationStoreCreateParams {
-    readonly maxRecords?: number;
-}
-
-// @public
-export interface IMemoryObserver {
-    readonly fireAndForget?: boolean;
-    observe(record: IMemoryObservationRecord): Promise<Result<unknown>>;
-}
-
-// @public
-export interface IMemoryQuery {
-    readonly asOf?: number;
-    readonly filter?: (record: IMemoryRecord<unknown>) => boolean;
-    readonly hops?: number;
-    readonly kind?: Kind;
-    readonly kinds?: ReadonlyArray<Kind>;
-    readonly limit?: number;
-    readonly linkedFrom?: IEdgeTarget;
-    readonly linkedTo?: IEdgeTarget;
-    readonly offset?: number;
-    readonly orderBy?: 'recency' | 'rank';
-    readonly scope?: MemoryScopeKey;
-    readonly semantic?: string;
-    readonly tag?: Tag;
-    readonly topK?: number;
-}
-
-// @public
-export interface IMemoryRecord<TBody = unknown> {
-    readonly body: TBody;
-    readonly envelope: IMemoryEnvelope;
-}
-
-// @public
-export interface IMemoryRecordSource {
-    list(): Promise<Result<ReadonlyArray<IScopedMemoryRecord>>>;
-}
-
-// @public
-export interface IMemoryRetriever {
-    readonly capabilities: IMemoryRetrieverCapabilities;
-    retrieve(query: IMemoryQuery): Promise<Result<ReadonlyArray<IMemoryRecord<unknown>>>>;
-}
-
-// @public
-export interface IMemoryRetrieverCapabilities {
-    readonly supportsLinkTraversal: boolean;
-    readonly supportsSemanticRecall: boolean;
-    readonly supportsTemporalQuery: boolean;
-}
-
-// @public
-export interface IMemoryStore {
-    asRecordSource(): IMemoryRecordSource;
-    dedupScopeFor(kind: Kind): DedupScope;
-    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>>>;
-}
-
-// @public
-export interface IMemoryStoreListFilter {
-    readonly asOf?: number;
-    readonly kind?: Kind;
-    readonly scope?: MemoryScopeKey;
-    readonly tag?: Tag;
-}
-
-// @public
-export interface IMemoryToolResultItem {
-    readonly body: unknown;
-    readonly entityId: EntityId;
-    readonly handle: string;
-    readonly kind: Kind;
-    readonly tags: ReadonlyArray<string>;
-}
-
-// @public
-export interface IMemoryWriteResult {
-    readonly entityId: EntityId;
-    readonly id: MemoryId;
-    readonly kind: Kind;
-    readonly outcome: MemoryWriteOutcome;
-}
-
-// @public
-export interface IMergeStrategy {
-    merge(resultSets: ReadonlyArray<ReadonlyArray<IMemoryRecord<unknown>>>): Result<ReadonlyArray<IMemoryRecord<unknown>>>;
-}
-
-// @public
-export function indexedRecordMatchesQuery(entry: IIndexedMemoryRecord, query: IMemoryQuery): boolean;
-
-// @public
-export type IngestDisposition = 'written' | 'deduped' | 'merged';
-
-// @public
-export class InMemoryCosineIndex implements IVectorIndex {
-    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(target: IEdgeTarget): Promise<Result<IEdgeTarget>>;
-    get size(): number;
-}
-
-// @public
-export class InMemoryFragmentCosineIndex implements IFragmentVectorIndex {
-    addFragments(target: IEdgeTarget, fragments: ReadonlyArray<IEmbeddedFragment>): Promise<Result<number>>;
-    static create(): Result<InMemoryFragmentCosineIndex>;
-    get fragmentCount(): number;
-    query(vector: Float32Array, topK: number, maxPerRecord?: number): Promise<Result<ReadonlyArray<IVectorQueryHit>>>;
-    rebuild(source: IMemoryRecordSource, embed: FragmentEmbedder): Promise<Result<number>>;
-    get recordCount(): number;
-    remove(target: IEdgeTarget): Promise<Result<IEdgeTarget>>;
-}
-
-// @public
-export interface IProvenance {
-    readonly [key: string]: unknown;
-    readonly by?: string;
-    readonly confidence?: number;
-    readonly derivedFrom?: IEdgeTarget;
-    readonly model?: string;
-    readonly source: ProvenanceSource;
-}
-
-// @public
-export interface IRelationCandidate {
-    readonly candidate: ICandidateRecord;
-    readonly id: IEdgeTarget;
-}
-
-// @public
-export interface IRelationContext {
-    readonly candidates: ReadonlyArray<IRelationCandidate>;
-    readonly item: IIngestItem;
-}
-
-// @public
-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;
-    readonly vectorIndex: IVectorIndex;
-}
-
-// @public
-export interface ISemanticRetrieverCreateParams {
-    readonly backend?: ISemanticBackend;
-    readonly index: IMemoryIndex;
-}
-
-// @public
-export interface ISkippedRecord {
-    readonly error: string;
-    readonly path: string;
-    readonly scope: MemoryScopeKey;
-}
-
-// @public
-export function isTemporalIdentityCodec(codec: IIdentityCodec): codec is ITemporalIdentityCodec;
-
-// @public
-export function isTemporalRecord(record: IMemoryRecord<unknown>): boolean;
-
-// @public
-export function isVersionCurrent(record: IMemoryRecord<unknown>): boolean;
-
-// @public
-export function isVersionValidAt(record: IMemoryRecord<unknown>, asOf: number): boolean;
-
-// @public
-export interface ITemporalBlock {
-    readonly invalid_at?: number | null;
-    readonly valid_at?: number;
-}
-
-// @public
-export interface ITemporalIdentityCodec extends IIdentityCodec {
-    decodeVersion(scope: MemoryScopeKey, stem: string): Result<ITemporalVersionAddress>;
-    encodeVersion(entityId: EntityId, seq: number): Result<string>;
-}
-
-// @public
-export interface ITemporalVersionAddress {
-    readonly entityId: EntityId;
-    readonly seq: number;
-}
-
-// @public
-export interface IVectorIndex {
-    add(target: IEdgeTarget, vector: Float32Array): Promise<Result<string>>;
-    query(vector: Float32Array, topK: number): Promise<Result<ReadonlyArray<IVectorQueryHit>>>;
-    remove(target: IEdgeTarget): Promise<Result<IEdgeTarget>>;
-}
-
-// @public
-export interface IVectorQueryHit {
-    readonly fragmentId?: string;
-    readonly locator?: IFragmentLocator;
-    readonly score: number;
-    readonly target: IEdgeTarget;
-}
-
-// @public
-export interface IWritePolicy {
-    admit(incoming: IMemoryRecord<unknown>, existing: ReadonlyArray<IMemoryRecord<unknown>>): Result<AdmissionDecision>;
-    applyUpdate(existing: IMemoryRecord<unknown>, patch: Record<string, unknown>): Result<IMemoryRecord<unknown>>;
-    readonly dedupScope?: DedupScope;
-    readonly mutableFields: ReadonlyArray<string>;
-}
-
-// @public
-export function joinFrontmatter(frontmatter: string, body: string): string;
-
-// @public
-export type Kind = Brand<string, 'Kind'>;
-
-// @public
-export class KnowledgeIdentityCodec implements IIdentityCodec {
-    decode(scope: MemoryScopeKey, encodedStem: string): Result<EntityId>;
-    encode(entityId: EntityId): Result<IIdentityCodecResult>;
-    static readonly scope: MemoryScopeKey;
-    verifyRoundTrip(scope: MemoryScopeKey, stem: string): Result<true>;
-}
-
-// @public
-export class KnowledgeLwwPolicy implements IWritePolicy {
-    admit(__incoming: IMemoryRecord<unknown>, __existing: ReadonlyArray<IMemoryRecord<unknown>>): Result<AdmissionDecision>;
-    applyUpdate(existing: IMemoryRecord<unknown>, patch: Record<string, unknown>): Result<IMemoryRecord<unknown>>;
-    static create(): Result<KnowledgeLwwPolicy>;
-    readonly dedupScope: DedupScope;
-    readonly mutableFields: ReadonlyArray<string>;
-}
-
-// @public
-export function limitRecords(records: ReadonlyArray<IMemoryRecord<unknown>>, limit?: number, offset?: number): ReadonlyArray<IMemoryRecord<unknown>>;
-
-// @public
-export const LINK_TRAVERSAL_NO_SEED_MESSAGE: string;
-
-// @public
-export const LINK_TRAVERSAL_UNWIRED_MESSAGE: string;
-
-// @public
-export class LinkTraversalRetriever implements IMemoryRetriever {
-    get capabilities(): IMemoryRetrieverCapabilities;
-    static create(index: IMemoryIndex): Result<LinkTraversalRetriever>;
-    retrieve(query: IMemoryQuery): Promise<Result<ReadonlyArray<IMemoryRecord<unknown>>>>;
-}
-
-// @public
-export type LinkType = Brand<string, 'LinkType'>;
-
-// @public
-export class LtmIdentityCodec implements IIdentityCodec {
-    decode(scope: MemoryScopeKey, encodedStem: string): Result<EntityId>;
-    encode(entityId: EntityId): Result<IIdentityCodecResult>;
-    static readonly scope: MemoryScopeKey;
-    verifyRoundTrip(scope: MemoryScopeKey, stem: string): Result<true>;
-}
-
-// @public
-export class MemoryCapCullPolicy implements IWritePolicy {
-    admit(__incoming: IMemoryRecord<unknown>, existing: ReadonlyArray<IMemoryRecord<unknown>>): Result<AdmissionDecision>;
-    applyUpdate(existing: IMemoryRecord<unknown>, patch: Record<string, unknown>): Result<IMemoryRecord<unknown>>;
-    static create(params: IMemoryCapCullPolicyParams): Result<MemoryCapCullPolicy>;
-    readonly dedupScope: DedupScope;
-    readonly mutableFields: ReadonlyArray<string>;
-}
-
-// @public
-export type MemoryDetailTier = 'gist' | 'full';
-
-// @public
-export type MemoryEmbedder = (record: IMemoryRecord<unknown>) => Promise<Result<Float32Array>>;
-
-// @public
-export type MemoryId = Brand<string, 'MemoryId'>;
-
-// @public
-export class MemoryIndex implements IMemoryIndex {
-    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>;
-    entries(): ReadonlyArray<IIndexedMemoryRecord>;
-    patch(op: MemoryIndexPatchOp, entry: IIndexedMemoryRecord): Result<IIndexedMemoryRecord>;
-    rebuild(entries: ReadonlyArray<IIndexedMemoryRecord>): Result<number>;
-}
-
-// @public
-export type MemoryIndexPatchOp = 'put' | 'delete';
-
-// @public
-export class MemoryIngestOrchestrator implements IMemoryIngestOrchestrator {
-    static create(params: IMemoryIngestOrchestratorCreateParams): Result<MemoryIngestOrchestrator>;
-    ingestBatch(items: ReadonlyArray<IIngestItem>): Promise<Result<ReadonlyArray<IIngestItemResult>>>;
-    ingestItem(item: IIngestItem): Promise<Result<IIngestItemResult>>;
-}
-
-// @public
-export type MemoryObservationOutcome = 'success' | 'failure';
-
-// @public
-export type MemoryObservationPhase = 'read' | 'write' | 'delete' | 'retrieve';
-
-// @public
-export class MemoryObservationStore implements IMemoryObserver {
-    clear(): void;
-    static create(params?: IMemoryObservationStoreCreateParams): Result<MemoryObservationStore>;
-    get lastSeq(): number;
-    observe(record: IMemoryObservationRecord): Promise<Result<unknown>>;
-    query(criteria?: IMemoryObservationQuery): ReadonlyArray<IMemoryObservationRecord>;
-    get size(): number;
-}
-
-// @public
-export type MemoryRecordErrorMode = 'skip' | 'fail';
-
-// @public
-export type MemoryScopeKey = Brand<string, 'MemoryScopeKey'>;
-
-// @public
-export type MemoryToolName = 'memory_write' | 'memory_read' | 'memory_search' | 'memory_context' | 'memory_delete';
-
-// @public
-export type MemoryWriteOutcome = 'written' | 'deduped';
-
-// @public
-export class MtmIdentityCodec implements IIdentityCodec {
-    decode(scope: MemoryScopeKey, encodedStem: string): Result<EntityId>;
-    encode(entityId: EntityId): Result<IIdentityCodecResult>;
-    static readonly rootScopeSegment: string;
-    static readonly turnStemPrefix: string;
-    verifyRoundTrip(scope: MemoryScopeKey, stem: string): Result<true>;
-}
-
-// @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>>;
-
-// @public
-export const provenanceConverter: Converter<IProvenance>;
-
-// @public
-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;
-
-// @public
-export class RecencyRetriever implements IMemoryRetriever {
-    get capabilities(): IMemoryRetrieverCapabilities;
-    static create(index: IMemoryIndex): Result<RecencyRetriever>;
-    retrieve(query: IMemoryQuery): Promise<Result<ReadonlyArray<IMemoryRecord<unknown>>>>;
-}
-
-// @public
-export type ResolutionVerdict = {
-    readonly verdict: 'new';
-} | {
-    readonly verdict: 'duplicate-of';
-    readonly target: IEdgeTarget;
-} | {
-    readonly verdict: 'supersede';
-    readonly target: IEdgeTarget;
-} | {
-    readonly verdict: 'merge-into';
-    readonly target: IEdgeTarget;
-};
-
-// @public
-export class ScoreUnionMergeStrategy implements IMergeStrategy {
-    static create(): Result<ScoreUnionMergeStrategy>;
-    merge(resultSets: ReadonlyArray<ReadonlyArray<IMemoryRecord<unknown>>>): Result<ReadonlyArray<IMemoryRecord<unknown>>>;
-}
-
-// @public
-export function selectByQuery(entries: ReadonlyArray<IIndexedMemoryRecord>, query: IMemoryQuery): IMemoryRecord<unknown>[];
-
-// @public
-export function selectCurrentVersion(versions: ReadonlyArray<IMemoryRecord<unknown>>): IMemoryRecord<unknown> | undefined;
-
-// @public
-export function selectVersionAsOf(versions: ReadonlyArray<IMemoryRecord<unknown>>, asOf: number): IMemoryRecord<unknown> | undefined;
-
-// @public
-export const SEMANTIC_UNWIRED_MESSAGE: string;
-
-// @public
-export class SemanticRetriever implements IMemoryRetriever {
-    get capabilities(): IMemoryRetrieverCapabilities;
-    static create(params: ISemanticRetrieverCreateParams): Result<SemanticRetriever>;
-    retrieve(query: IMemoryQuery): Promise<Result<ReadonlyArray<IMemoryRecord<unknown>>>>;
-}
-
-// @public
-export function serializeMemoryFile(envelope: IMemoryEnvelope, body: string): Result<string>;
-
-// @public
-export function splitFrontmatter(raw: string): Result<IMemoryFileParts>;
-
-// @public
-export type StoreStampedEnvelopeField = 'id' | 'seq' | 'contentHash' | 'created' | 'updated';
-
-// @public
-export class StructuredFilterRetriever implements IMemoryRetriever {
-    get capabilities(): IMemoryRetrieverCapabilities;
-    static create(index: IMemoryIndex): Result<StructuredFilterRetriever>;
-    retrieve(query: IMemoryQuery): Promise<Result<ReadonlyArray<IMemoryRecord<unknown>>>>;
-}
-
-// @public
-export type Tag = Brand<string, 'Tag'>;
-
-// @public
-export class TagRetriever implements IMemoryRetriever {
-    get capabilities(): IMemoryRetrieverCapabilities;
-    static create(index: IMemoryIndex): Result<TagRetriever>;
-    retrieve(query: IMemoryQuery): Promise<Result<ReadonlyArray<IMemoryRecord<unknown>>>>;
-}
-
-// @public
-export const TEMPORAL_CAPABILITIES: IMemoryRetrieverCapabilities;
-
-// @public
-export const temporalConverter: Converter<ITemporalBlock>;
-
-// @public
-export class TemporalIdentityCodec implements ITemporalIdentityCodec {
-    readonly baseScope: string;
-    static create(baseScope: string): Result<TemporalIdentityCodec>;
-    decode(scope: MemoryScopeKey, encodedStem: string): Result<EntityId>;
-    decodeVersion(scope: MemoryScopeKey, stem: string): Result<ITemporalVersionAddress>;
-    encode(entityId: EntityId): Result<IIdentityCodecResult>;
-    encodeVersion(entityId: EntityId, seq: number): Result<string>;
-    static readonly entitiesSegment: string;
-    verifyRoundTrip(scope: MemoryScopeKey, stem: string): Result<true>;
-    static readonly versionInfix: string;
-}
-
-// @public
-export function temporalUnwiredMessage(kind?: Kind): string;
-
-// @public
-export class TemporalVersionedPolicy implements IWritePolicy {
-    admit(__incoming: IMemoryRecord<unknown>, __existing: ReadonlyArray<IMemoryRecord<unknown>>): Result<AdmissionDecision>;
-    applyUpdate(existing: IMemoryRecord<unknown>, patch: Record<string, unknown>): Result<IMemoryRecord<unknown>>;
-    static create(): Result<TemporalVersionedPolicy>;
-    readonly dedupScope: DedupScope;
-    readonly mutableFields: ReadonlyArray<string>;
-}
-
-// (No @packageDocumentation comment for this package)
-
-```