Skip to main content

​
Where It Lives

The ConvexAdapter is implemented in:
  • icrl-ts/web-example/src/lib/convex-adapter.ts
It implements the TypeScript StorageAdapter contract from icrl-ts/src/storage.ts.

​
Purpose

ConvexAdapter lets TrajectoryDatabase persist trajectories, embeddings, and curation metadata in Convex rather than local files.

​
Required Option

new ConvexAdapter(client, { databaseId })
databaseId scopes all operations so multiple ICRL datasets can share one Convex project.

​
Methods Covered

The adapter implements all required storage methods, including:
  • trajectory CRUD
  • curation metadata CRUD
  • embeddings save/search/delete
  • derived StepExample access

​
Example Usage

import { ConvexHttpClient } from "convex/browser";
import { TrajectoryDatabase } from "icrl";
import { ConvexAdapter } from "../web-example/src/lib/convex-adapter";

const convex = new ConvexHttpClient(process.env.NEXT_PUBLIC_CONVEX_URL!);
const adapter = new ConvexAdapter(convex as any, { databaseId });
const db = new TrajectoryDatabase(adapter, embedder);
await db.load();

​
End-to-End Demo

Run from icrl-ts/: 
bun run example:web
This uses examples/web-convex-demo.ts and the same adapter implementation as the web app.