StorageAdapter

Interface

StorageAdapter defines trajectory, metadata, and embedding persistence plus vector similarity search.

Required Methods

Init & Trajectories:

init(): Promise<void>
saveTrajectory(trajectory: Trajectory): Promise<void>
getTrajectory(id: string): Promise<Trajectory | null>
getAllTrajectories(): Promise<Trajectory[]>
deleteTrajectory(id: string): Promise<boolean>

Curation Metadata:

saveCurationMetadata(meta: CurationMetadata): Promise<void>
getCurationMetadata(trajectoryId: string): Promise<CurationMetadata | null>
getAllCurationMetadata(): Promise<CurationMetadata[]>
deleteCurationMetadata(trajectoryId: string): Promise<boolean>

Embeddings:

saveEmbedding(embedding: StoredEmbedding): Promise<void>
saveEmbeddings(embeddings: StoredEmbedding[]): Promise<void>
getEmbedding(id: string): Promise<StoredEmbedding | null>
getEmbeddingsByType(type: "trajectory" | "step"): Promise<StoredEmbedding[]>
deleteEmbeddingsForTrajectory(trajectoryId: string): Promise<void>
searchByEmbedding(query: number[], type: "trajectory" | "step", k: number): Promise<EmbeddingSearchResult[]>

Step Examples:

getStepExamplesForTrajectory(trajectoryId: string): Promise<StepExample[]>
getAllStepExamples(): Promise<StepExample[]>

Built-in Implementation

FileSystemAdapter(path: string, options?: FileSystemAdapterOptions) — stores trajectories as JSON on disk with in-memory embedding index

FileSystemAdapterOptions:

normalizeEmbeddings (default: true)

Overview

Python API

TypeScript API

StorageAdapter

Interface

Required Methods

Built-in Implementation

​Interface

​Required Methods

​Built-in Implementation

Interface

Required Methods

Built-in Implementation