@fastpaca/cria 0.0.1 → 1.0.1

package/dist/instrumentation/otel.test.js

@@ -0,0 +1,116 @@
+import { jsx as _jsx, jsxs as _jsxs } from "@fastpaca/cria/jsx-runtime";
+import { describe, expect, test } from "vitest";
+import { Omit, Region, render } from "../index";
+import { createOtelRenderHooks } from "./otel";
+class StubSpan {
+    name;
+    attributes = {};
+    ended = false;
+    status = null;
+    exceptions = [];
+    constructor(name) {
+        this.name = name;
+    }
+    spanContext() {
+        return { traceId: "trace", spanId: "span", traceFlags: 1 };
+    }
+    setAttribute(key, value) {
+        this.attributes[key] = value;
+        return this;
+    }
+    setAttributes(attrs) {
+        Object.assign(this.attributes, attrs);
+        return this;
+    }
+    addEvent() {
+        return this;
+    }
+    addLink() {
+        return this;
+    }
+    addLinks() {
+        return this;
+    }
+    setStatus(status) {
+        this.status = status;
+        return this;
+    }
+    updateName() {
+        return this;
+    }
+    end() {
+        this.ended = true;
+    }
+    isRecording() {
+        return true;
+    }
+    recordException(exception) {
+        this.exceptions.push(exception);
+        return this;
+    }
+}
+class StubTracer {
+    spans = [];
+    startSpan(name) {
+        const span = new StubSpan(name);
+        this.spans.push(span);
+        return span;
+    }
+    startActiveSpan(name, fn) {
+        const span = this.startSpan(name);
+        try {
+            return fn(span);
+        }
+        finally {
+            span.end();
+        }
+    }
+}
+const tokenizer = (text) => text.length;
+const FIT_ERROR = /Cannot fit prompt/;
+describe("createOtelRenderHooks", () => {
+    test("emits spans for fit lifecycle", async () => {
+        const tracer = new StubTracer();
+        const hooks = createOtelRenderHooks({ tracer });
+        const element = (_jsxs(Region, { priority: 0, children: ["A", _jsx(Omit, { priority: 1, children: "BBBB" })] }));
+        await render(element, { tokenizer, budget: 1, hooks });
+        const names = tracer.spans.map((span) => span.name);
+        expect(names).toEqual([
+            "cria.fit",
+            "cria.fit.iteration",
+            "cria.fit.strategy",
+        ]);
+        const rootSpan = tracer.spans[0];
+        expect(rootSpan).toBeDefined();
+        expect(rootSpan?.attributes["cria.budget"]).toBe(1);
+        expect(typeof rootSpan?.attributes["cria.total_tokens"]).toBe("number");
+    });
+    test("records errors on fit failure", async () => {
+        const tracer = new StubTracer();
+        const hooks = createOtelRenderHooks({ tracer });
+        const element = _jsx(Region, { priority: 0, children: "Too long" });
+        await expect(render(element, {
+            tokenizer,
+            budget: 1,
+            hooks,
+        })).rejects.toThrow(FIT_ERROR);
+        const errorSpan = tracer.spans.at(-1);
+        expect(errorSpan.status?.code).toBeDefined();
+        expect(errorSpan.exceptions).toHaveLength(1);
+    });
+    test("propagates tracer errors", async () => {
+        const tracer = {
+            startSpan: () => {
+                throw new Error("boom");
+            },
+        };
+        const hooks = createOtelRenderHooks({ tracer });
+        const element = _jsx(Region, { priority: 0, children: "Hello" });
+        await expect(render(element, {
+            tokenizer,
+            budget: 1,
+            hooks,
+        })).rejects.toThrow("boom");
+    });
+});
+//# sourceMappingURL=otel.test.js.map

package/dist/instrumentation/otel.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"otel.test.js","sourceRoot":"","sources":["../../src/instrumentation/otel.test.tsx"],"names":[],"mappings":"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"}

package/dist/jsx-dev-runtime.d.ts

@@ -0,0 +1,2 @@
+export { Fragment, type JSX, jsx, jsx as jsxDEV, jsxs } from "./jsx-runtime";
+//# sourceMappingURL=jsx-dev-runtime.d.ts.map

package/dist/jsx-dev-runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"jsx-dev-runtime.d.ts","sourceRoot":"","sources":["../src/jsx-dev-runtime.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,KAAK,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,MAAM,EAAE,IAAI,EAAE,MAAM,eAAe,CAAC"}

package/dist/jsx-dev-runtime.js

@@ -0,0 +1,2 @@
+export { Fragment, jsx, jsx as jsxDEV, jsxs } from "./jsx-runtime";
+//# sourceMappingURL=jsx-dev-runtime.js.map

package/dist/jsx-dev-runtime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"jsx-dev-runtime.js","sourceRoot":"","sources":["../src/jsx-dev-runtime.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAY,GAAG,EAAE,GAAG,IAAI,MAAM,EAAE,IAAI,EAAE,MAAM,eAAe,CAAC"}

package/dist/jsx-runtime.d.ts

@@ -1,15 +1,37 @@
-import type { PromptElement } from "./types";
-type ComponentFn = (props: Props) => PromptElement;
-type Child = PromptElement | string | number | boolean | null | undefined | Child[];
+import type { MaybePromise, PromptChildren, PromptElement } from "./types";
+type ComponentFn = (props: Props) => MaybePromise<PromptElement>;
+/**
+ * JSX child input type (pre-normalization).
+ *
+ * Why this exists:
+ * - `PromptElement.children` (the IR) is always stored as canonical `PromptChildren`
+ *   (`PromptElement | string` flattened into an array).
+ * - But JSX syntax allows much more: numbers, booleans, null/undefined, and nested arrays.
+ *   TypeScript will type-check those against the component prop type.
+ *
+ * This type represents what JSX can pass in; `normalizeChildren()` is the only place
+ * we flatten/filter/coerce into the canonical IR representation.
+ *
+ * Keep this type local to the JSX runtime to avoid leaking JSX-specific concerns
+ * into core IR and renderer types.
+ */
+export type Child = PromptElement | Promise<PromptElement> | string | number | boolean | null | undefined | readonly Child[];
 type Props = Record<string, unknown> & {
-    children?: Child | Child[];
+    children?: Child;
 };
 export declare const Fragment: unique symbol;
-export declare function jsx(type: ComponentFn | typeof Fragment, props: Props): PromptElement;
-export declare function jsxs(type: ComponentFn | typeof Fragment, props: Props): PromptElement;
+export declare function jsx(type: ComponentFn | typeof Fragment, props: Props): Promise<PromptElement>;
+export declare function jsxs(type: ComponentFn | typeof Fragment, props: Props): Promise<PromptElement>;
 export declare namespace JSX {
-    type Element = PromptElement;
-    type IntrinsicElements = {};
+    type Element = MaybePromise<PromptElement>;
+    type LibraryManagedAttributes<_C, P> = P extends {
+        children?: PromptChildren;
+    } ? Omit<P, "children"> & {
+        children?: Child;
+    } : P;
+    interface IntrinsicElements {
+        [key: string]: never;
+    }
     interface ElementChildrenAttribute {
         children: unknown;
     }

package/dist/jsx-runtime.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"jsx-runtime.d.ts","sourceRoot":"","sources":["../src/jsx-runtime.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAE7C,KAAK,WAAW,GAAG,CAAC,KAAK,EAAE,KAAK,KAAK,aAAa,CAAC;AACnD,KAAK,KAAK,GACN,aAAa,GACb,MAAM,GACN,MAAM,GACN,OAAO,GACP,IAAI,GACJ,SAAS,GACT,KAAK,EAAE,CAAC;AACZ,KAAK,KAAK,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG;IAAE,QAAQ,CAAC,EAAE,KAAK,GAAG,KAAK,EAAE,CAAA;CAAE,CAAC;AAgCtE,eAAO,MAAM,QAAQ,eAA8B,CAAC;AAGpD,wBAAgB,GAAG,CACjB,IAAI,EAAE,WAAW,GAAG,OAAO,QAAQ,EACnC,KAAK,EAAE,KAAK,GACX,aAAa,CASf;AAGD,wBAAgB,IAAI,CAClB,IAAI,EAAE,WAAW,GAAG,OAAO,QAAQ,EACnC,KAAK,EAAE,KAAK,GACX,aAAa,CAEf;AAGD,yBAAiB,GAAG,CAAC;IACnB,KAAY,OAAO,GAAG,aAAa,CAAC;IAEpC,KAAY,iBAAiB,GAAG,EAAE,CAAC;IACnC,UAAiB,wBAAwB;QACvC,QAAQ,EAAE,OAAO,CAAC;KACnB;CACF"}
+{"version":3,"file":"jsx-runtime.d.ts","sourceRoot":"","sources":["../src/jsx-runtime.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAE3E,KAAK,WAAW,GAAG,CAAC,KAAK,EAAE,KAAK,KAAK,YAAY,CAAC,aAAa,CAAC,CAAC;AAEjE;;;;;;;;;;;;;;GAcG;AACH,MAAM,MAAM,KAAK,GACb,aAAa,GACb,OAAO,CAAC,aAAa,CAAC,GACtB,MAAM,GACN,MAAM,GACN,OAAO,GACP,IAAI,GACJ,SAAS,GACT,SAAS,KAAK,EAAE,CAAC;AAErB,KAAK,KAAK,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG;IAAE,QAAQ,CAAC,EAAE,KAAK,CAAA;CAAE,CAAC;AAoC5D,eAAO,MAAM,QAAQ,eAA8B,CAAC;AAGpD,wBAAsB,GAAG,CACvB,IAAI,EAAE,WAAW,GAAG,OAAO,QAAQ,EACnC,KAAK,EAAE,KAAK,GACX,OAAO,CAAC,aAAa,CAAC,CASxB;AAGD,wBAAsB,IAAI,CACxB,IAAI,EAAE,WAAW,GAAG,OAAO,QAAQ,EACnC,KAAK,EAAE,KAAK,GACX,OAAO,CAAC,aAAa,CAAC,CAExB;AAED,yBAAiB,GAAG,CAAC;IACnB,KAAY,OAAO,GAAG,YAAY,CAAC,aAAa,CAAC,CAAC;IAElD,KAAY,wBAAwB,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,SAAS;QACtD,QAAQ,CAAC,EAAE,cAAc,CAAC;KAC3B,GACG,IAAI,CAAC,CAAC,EAAE,UAAU,CAAC,GAAG;QAAE,QAAQ,CAAC,EAAE,KAAK,CAAA;KAAE,GAC1C,CAAC,CAAC;IACN,UAAiB,iBAAiB;QAChC,CAAC,GAAG,EAAE,MAAM,GAAG,KAAK,CAAC;KACtB;IACD,UAAiB,wBAAwB;QACvC,QAAQ,EAAE,OAAO,CAAC;KACnB;CACF"}

package/dist/jsx-runtime.js

@@ -1,5 +1,5 @@
 // Normalize children: flatten arrays, filter nullish, coerce numbers to strings
-function normalizeChildren(children) {
+async function normalizeChildren(children) {
     if (children === undefined || children === null) {
         return [];
     }
@@ -12,29 +12,32 @@ function normalizeChildren(children) {
     if (typeof children === "number") {
         return [String(children)];
     }
-    if (Array.isArray(children)) {
+    if (isChildrenArray(children)) {
         const result = [];
         for (const child of children) {
-            result.push(...normalizeChildren(child));
+            result.push(...(await normalizeChildren(child)));
         }
         return result;
     }
-    // It's a PromptElement
-    return [children];
+    // It's a PromptElement (or a promise for one)
+    return [await children];
+}
+function isChildrenArray(value) {
+    return Array.isArray(value);
 }
 // Fragment: just returns children (inlined into parent)
 export const Fragment = Symbol.for("cria.fragment");
 // jsx: called by TypeScript for single child
-export function jsx(type, props) {
-    const children = normalizeChildren(props.children);
+export async function jsx(type, props) {
+    const children = await normalizeChildren(props.children);
     if (type === Fragment) {
         // Fragment returns a wrapper element that just holds children
         return { priority: 0, children };
     }
-    return type({ ...props, children });
+    return await type({ ...props, children });
 }
 // jsxs: called by TypeScript for multiple children (same behavior)
-export function jsxs(type, props) {
-    return jsx(type, props);
+export async function jsxs(type, props) {
+    return await jsx(type, props);
 }
 //# sourceMappingURL=jsx-runtime.js.map

package/dist/jsx-runtime.js.map

@@ -1 +1 @@
-{"version":3,"file":"jsx-runtime.js","sourceRoot":"","sources":["../src/jsx-runtime.ts"],"names":[],"mappings":"AAaA,gFAAgF;AAChF,SAAS,iBAAiB,CACxB,QAAqC;IAErC,IAAI,QAAQ,KAAK,SAAS,IAAI,QAAQ,KAAK,IAAI,EAAE,CAAC;QAChD,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,IAAI,OAAO,QAAQ,KAAK,SAAS,EAAE,CAAC;QAClC,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,IAAI,OAAO,QAAQ,KAAK,QAAQ,EAAE,CAAC;QACjC,OAAO,CAAC,QAAQ,CAAC,CAAC;IACpB,CAAC;IACD,IAAI,OAAO,QAAQ,KAAK,QAAQ,EAAE,CAAC;QACjC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC;IAC5B,CAAC;IAED,IAAI,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC5B,MAAM,MAAM,GAA+B,EAAE,CAAC;QAC9C,KAAK,MAAM,KAAK,IAAI,QAAQ,EAAE,CAAC;YAC7B,MAAM,CAAC,IAAI,CAAC,GAAG,iBAAiB,CAAC,KAAK,CAAC,CAAC,CAAC;QAC3C,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,uBAAuB;IACvB,OAAO,CAAC,QAAQ,CAAC,CAAC;AACpB,CAAC;AAED,wDAAwD;AACxD,MAAM,CAAC,MAAM,QAAQ,GAAG,MAAM,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC;AAEpD,6CAA6C;AAC7C,MAAM,UAAU,GAAG,CACjB,IAAmC,EACnC,KAAY;IAEZ,MAAM,QAAQ,GAAG,iBAAiB,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;IAEnD,IAAI,IAAI,KAAK,QAAQ,EAAE,CAAC;QACtB,8DAA8D;QAC9D,OAAO,EAAE,QAAQ,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC;IACnC,CAAC;IAED,OAAO,IAAI,CAAC,EAAE,GAAG,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC;AACtC,CAAC;AAED,mEAAmE;AACnE,MAAM,UAAU,IAAI,CAClB,IAAmC,EACnC,KAAY;IAEZ,OAAO,GAAG,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;AAC1B,CAAC"}
+{"version":3,"file":"jsx-runtime.js","sourceRoot":"","sources":["../src/jsx-runtime.ts"],"names":[],"mappings":"AA+BA,gFAAgF;AAChF,KAAK,UAAU,iBAAiB,CAC9B,QAA2B;IAE3B,IAAI,QAAQ,KAAK,SAAS,IAAI,QAAQ,KAAK,IAAI,EAAE,CAAC;QAChD,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,IAAI,OAAO,QAAQ,KAAK,SAAS,EAAE,CAAC;QAClC,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,IAAI,OAAO,QAAQ,KAAK,QAAQ,EAAE,CAAC;QACjC,OAAO,CAAC,QAAQ,CAAC,CAAC;IACpB,CAAC;IACD,IAAI,OAAO,QAAQ,KAAK,QAAQ,EAAE,CAAC;QACjC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC;IAC5B,CAAC;IAED,IAAI,eAAe,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC9B,MAAM,MAAM,GAAmB,EAAE,CAAC;QAClC,KAAK,MAAM,KAAK,IAAI,QAAQ,EAAE,CAAC;YAC7B,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,iBAAiB,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QACnD,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,8CAA8C;IAC9C,OAAO,CAAC,MAAM,QAAQ,CAAC,CAAC;AAC1B,CAAC;AAED,SAAS,eAAe,CAAC,KAAY;IACnC,OAAO,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAC9B,CAAC;AAED,wDAAwD;AACxD,MAAM,CAAC,MAAM,QAAQ,GAAG,MAAM,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC;AAEpD,6CAA6C;AAC7C,MAAM,CAAC,KAAK,UAAU,GAAG,CACvB,IAAmC,EACnC,KAAY;IAEZ,MAAM,QAAQ,GAAG,MAAM,iBAAiB,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;IAEzD,IAAI,IAAI,KAAK,QAAQ,EAAE,CAAC;QACtB,8DAA8D;QAC9D,OAAO,EAAE,QAAQ,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC;IACnC,CAAC;IAED,OAAO,MAAM,IAAI,CAAC,EAAE,GAAG,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC;AAC5C,CAAC;AAED,mEAAmE;AACnE,MAAM,CAAC,KAAK,UAAU,IAAI,CACxB,IAAmC,EACnC,KAAY;IAEZ,OAAO,MAAM,GAAG,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;AAChC,CAAC"}

package/dist/memory/chroma/index.d.ts

@@ -0,0 +1,59 @@
+import { type Collection } from "chromadb";
+import type { MemoryEntry } from "../key-value";
+import type { VectorMemory, VectorSearchOptions, VectorSearchResult } from "../vector";
+/**
+ * Function to generate embeddings for text.
+ */
+export type EmbeddingFunction = (text: string) => Promise<number[]>;
+/**
+ * Options for creating a ChromaStore.
+ */
+export interface ChromaStoreOptions {
+    /** The Chroma collection to use */
+    collection: Collection;
+    /** Function to generate embeddings from text */
+    embed: EmbeddingFunction;
+}
+/**
+ * VectorMemory implementation backed by ChromaDB.
+ *
+ * This adapter wraps a Chroma collection and implements the VectorMemory interface,
+ * allowing you to use ChromaDB for RAG workflows with Cria's VectorSearch component.
+ *
+ * @template T - The type of data stored in the collection
+ *
+ * @example
+ * ```typescript
+ * import { ChromaClient } from "chromadb";
+ * import { ChromaStore } from "@fastpaca/cria/memory/chroma";
+ * import { VectorSearch } from "@fastpaca/cria";
+ *
+ * const client = new ChromaClient({ path: "http://localhost:8000" });
+ * const collection = await client.getOrCreateCollection({ name: "my-docs" });
+ *
+ * const store = new ChromaStore({
+ *   collection,
+ *   embed: async (text) => {
+ *     // Use your embedding model (OpenAI, Cohere, etc.)
+ *     return await getEmbedding(text);
+ *   },
+ * });
+ *
+ * // Use with VectorSearch
+ * <VectorSearch store={store} limit={5}>
+ *   What is RAG?
+ * </VectorSearch>
+ * ```
+ */
+export declare class ChromaStore<T = unknown> implements VectorMemory<T> {
+    private readonly collection;
+    private readonly embedFn;
+    constructor(options: ChromaStoreOptions);
+    private embed;
+    get(key: string): Promise<MemoryEntry<T> | null>;
+    set(key: string, data: T, metadata?: Record<string, unknown>): Promise<void>;
+    delete(key: string): Promise<boolean>;
+    search(query: string, options?: VectorSearchOptions): Promise<VectorSearchResult<T>[]>;
+    private buildSearchResults;
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/memory/chroma/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/memory/chroma/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,UAAU,EAA8B,MAAM,UAAU,CAAC;AACvE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAChD,OAAO,KAAK,EACV,YAAY,EACZ,mBAAmB,EACnB,kBAAkB,EACnB,MAAM,WAAW,CAAC;AAEnB;;GAEG;AACH,MAAM,MAAM,iBAAiB,GAAG,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;AAEpE;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,mCAAmC;IACnC,UAAU,EAAE,UAAU,CAAC;IACvB,gDAAgD;IAChD,KAAK,EAAE,iBAAiB,CAAC;CAC1B;AAsCD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,qBAAa,WAAW,CAAC,CAAC,GAAG,OAAO,CAAE,YAAW,YAAY,CAAC,CAAC,CAAC;IAC9D,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAa;IACxC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAoB;gBAEhC,OAAO,EAAE,kBAAkB;YAKzB,KAAK;IAUb,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;IAqBhD,GAAG,CACP,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,CAAC,EACP,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACjC,OAAO,CAAC,IAAI,CAAC;IA0BV,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IASrC,MAAM,CACV,KAAK,EAAE,MAAM,EACb,OAAO,CAAC,EAAE,mBAAmB,GAC5B,OAAO,CAAC,kBAAkB,CAAC,CAAC,CAAC,EAAE,CAAC;IA8BnC,OAAO,CAAC,kBAAkB;CAsC3B"}

package/dist/memory/chroma/index.js

@@ -0,0 +1,172 @@
+import { IncludeEnum } from "chromadb";
+/**
+ * Parse a document string. Tries JSON.parse first, returns raw string on failure.
+ * Throws if document is missing.
+ */
+function parseDocument(document) {
+    if (!document) {
+        throw new Error("ChromaStore: document is missing from entry");
+    }
+    try {
+        return JSON.parse(document);
+    }
+    catch {
+        // Document was stored as a raw string (T is string)
+        return document;
+    }
+}
+/**
+ * Convert L2 distance to a similarity score (0-1).
+ * Lower distance = higher similarity.
+ */
+function distanceToScore(distance) {
+    return 1 / (1 + distance);
+}
+/**
+ * Extract timestamp from Chroma metadata field.
+ */
+function extractTimestamp(metadata, field) {
+    const value = metadata?.[field];
+    return typeof value === "number" ? value : 0;
+}
+/**
+ * VectorMemory implementation backed by ChromaDB.
+ *
+ * This adapter wraps a Chroma collection and implements the VectorMemory interface,
+ * allowing you to use ChromaDB for RAG workflows with Cria's VectorSearch component.
+ *
+ * @template T - The type of data stored in the collection
+ *
+ * @example
+ * ```typescript
+ * import { ChromaClient } from "chromadb";
+ * import { ChromaStore } from "@fastpaca/cria/memory/chroma";
+ * import { VectorSearch } from "@fastpaca/cria";
+ *
+ * const client = new ChromaClient({ path: "http://localhost:8000" });
+ * const collection = await client.getOrCreateCollection({ name: "my-docs" });
+ *
+ * const store = new ChromaStore({
+ *   collection,
+ *   embed: async (text) => {
+ *     // Use your embedding model (OpenAI, Cohere, etc.)
+ *     return await getEmbedding(text);
+ *   },
+ * });
+ *
+ * // Use with VectorSearch
+ * <VectorSearch store={store} limit={5}>
+ *   What is RAG?
+ * </VectorSearch>
+ * ```
+ */
+export class ChromaStore {
+    collection;
+    embedFn;
+    constructor(options) {
+        this.collection = options.collection;
+        this.embedFn = options.embed;
+    }
+    async embed(text, context) {
+        try {
+            return await this.embedFn(text);
+        }
+        catch (error) {
+            throw new Error(`ChromaStore: embedding failed during ${context}`, {
+                cause: error,
+            });
+        }
+    }
+    async get(key) {
+        const response = await this.collection.get({
+            ids: [key],
+            include: [IncludeEnum.Documents, IncludeEnum.Metadatas],
+        });
+        if (!response.ids.length) {
+            return null;
+        }
+        const document = response.documents?.[0];
+        const metadata = response.metadatas?.[0];
+        return {
+            data: parseDocument(document),
+            createdAt: extractTimestamp(metadata, "_createdAt"),
+            updatedAt: extractTimestamp(metadata, "_updatedAt"),
+            ...(metadata && { metadata: metadata }),
+        };
+    }
+    async set(key, data, metadata) {
+        const now = Date.now();
+        // Check if entry exists to preserve createdAt
+        const existing = await this.get(key);
+        const createdAt = existing?.createdAt ?? now;
+        // Convert data to text for embedding and storage
+        const document = typeof data === "string" ? data : JSON.stringify(data);
+        const vector = await this.embed(document, `set("${key}")`);
+        // Merge user metadata with timestamps
+        const chromaMetadata = {
+            ...metadata,
+            _createdAt: createdAt,
+            _updatedAt: now,
+        };
+        await this.collection.upsert({
+            ids: [key],
+            embeddings: [vector],
+            documents: [document],
+            metadatas: [chromaMetadata],
+        });
+    }
+    async delete(key) {
+        const existing = await this.get(key);
+        if (!existing) {
+            return false;
+        }
+        await this.collection.delete({ ids: [key] });
+        return true;
+    }
+    async search(query, options) {
+        const limit = options?.limit ?? 10;
+        const threshold = options?.threshold;
+        const queryVector = await this.embed(query, "search");
+        const response = await this.collection.query({
+            queryEmbeddings: [queryVector],
+            nResults: limit,
+            include: [
+                IncludeEnum.Documents,
+                IncludeEnum.Metadatas,
+                IncludeEnum.Distances,
+            ],
+        });
+        const ids = response.ids[0] ?? [];
+        const documents = response.documents?.[0] ?? [];
+        const metadatas = response.metadatas?.[0] ?? [];
+        const distances = response.distances?.[0] ?? [];
+        return this.buildSearchResults(ids, documents, metadatas, distances, threshold);
+    }
+    buildSearchResults(ids, documents, metadatas, distances, threshold) {
+        const results = [];
+        for (let i = 0; i < ids.length; i++) {
+            const id = ids[i];
+            if (id === undefined) {
+                continue;
+            }
+            const distance = distances[i] ?? 0;
+            const score = distanceToScore(distance);
+            if (threshold !== undefined && score < threshold) {
+                continue;
+            }
+            const metadata = metadatas[i];
+            results.push({
+                key: id,
+                score,
+                entry: {
+                    data: parseDocument(documents[i]),
+                    createdAt: extractTimestamp(metadata, "_createdAt"),
+                    updatedAt: extractTimestamp(metadata, "_updatedAt"),
+                    ...(metadata && { metadata: metadata }),
+                },
+            });
+        }
+        return results;
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/memory/chroma/index.js.map

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

package/dist/memory/index.d.ts

@@ -0,0 +1,4 @@
+export type { KVMemory, MemoryEntry } from "./key-value";
+export { InMemoryStore } from "./key-value";
+export type { VectorMemory, VectorSearchOptions, VectorSearchResult, } from "./vector";
+//# sourceMappingURL=index.d.ts.map

package/dist/memory/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/memory/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AACzD,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,YAAY,EACV,YAAY,EACZ,mBAAmB,EACnB,kBAAkB,GACnB,MAAM,UAAU,CAAC"}

package/dist/memory/index.js

@@ -0,0 +1,2 @@
+export { InMemoryStore } from "./key-value";
+//# sourceMappingURL=index.js.map

package/dist/memory/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/memory/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC"}

package/dist/memory/key-value.d.ts

@@ -0,0 +1,71 @@
+import type { MaybePromise } from "../types";
+/**
+ * A stored memory entry with metadata.
+ *
+ * @template T - The type of data stored in the entry
+ */
+export interface MemoryEntry<T = unknown> {
+    /** The stored data */
+    data: T;
+    /** When the entry was created (epoch ms) */
+    createdAt: number;
+    /** When the entry was last updated (epoch ms) */
+    updatedAt: number;
+    /** Optional metadata for the entry */
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Key-value memory interface for LLM-related storage.
+ *
+ * @template T - The type of data stored in the memory
+ *
+ * @example
+ * ```typescript
+ * import { InMemoryStore } from "@fastpaca/cria";
+ *
+ * const store = new InMemoryStore<{ content: string }>();
+ *
+ * await store.set("key-1", { content: "Hello" });
+ * const entry = await store.get("key-1");
+ * ```
+ */
+export interface KVMemory<T = unknown> {
+    /**
+     * Retrieve an entry by its key.
+     * @returns The entry if found, null otherwise
+     */
+    get(key: string): MaybePromise<MemoryEntry<T> | null>;
+    /**
+     * Store or update an entry.
+     * @param key - The unique key for this entry
+     * @param data - The data to store
+     * @param metadata - Optional metadata to attach
+     */
+    set(key: string, data: T, metadata?: Record<string, unknown>): MaybePromise<void>;
+    /**
+     * Delete an entry by its key.
+     * @returns true if the entry existed and was deleted, false otherwise
+     */
+    delete(key: string): MaybePromise<boolean>;
+}
+/**
+ * In-memory implementation of KVMemory.
+ *
+ * @template T - The type of data to store
+ *
+ * @example
+ * ```typescript
+ * import { InMemoryStore, Summary, type StoredSummary } from "@fastpaca/cria";
+ *
+ * const store = new InMemoryStore<StoredSummary>();
+ *
+ * <Summary store={store} ... />
+ * ```
+ */
+export declare class InMemoryStore<T = unknown> implements KVMemory<T> {
+    private readonly store;
+    get(key: string): MemoryEntry<T> | null;
+    set(key: string, data: T, metadata?: Record<string, unknown>): void;
+    delete(key: string): boolean;
+}
+//# sourceMappingURL=key-value.d.ts.map

package/dist/memory/key-value.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"key-value.d.ts","sourceRoot":"","sources":["../../src/memory/key-value.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAE7C;;;;GAIG;AACH,MAAM,WAAW,WAAW,CAAC,CAAC,GAAG,OAAO;IACtC,sBAAsB;IACtB,IAAI,EAAE,CAAC,CAAC;IACR,4CAA4C;IAC5C,SAAS,EAAE,MAAM,CAAC;IAClB,iDAAiD;IACjD,SAAS,EAAE,MAAM,CAAC;IAClB,sCAAsC;IACtC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED;;;;;;;;;;;;;;GAcG;AACH,MAAM,WAAW,QAAQ,CAAC,CAAC,GAAG,OAAO;IACnC;;;OAGG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,YAAY,CAAC,WAAW,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;IAEtD;;;;;OAKG;IACH,GAAG,CACD,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,CAAC,EACP,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACjC,YAAY,CAAC,IAAI,CAAC,CAAC;IAEtB;;;OAGG;IACH,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,YAAY,CAAC,OAAO,CAAC,CAAC;CAC5C;AAED;;;;;;;;;;;;;GAaG;AACH,qBAAa,aAAa,CAAC,CAAC,GAAG,OAAO,CAAE,YAAW,QAAQ,CAAC,CAAC,CAAC;IAC5D,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAqC;IAE3D,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,WAAW,CAAC,CAAC,CAAC,GAAG,IAAI;IAIvC,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,EAAE,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAYnE,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;CAG7B"}

package/dist/memory/key-value.js

@@ -0,0 +1,34 @@
+/**
+ * In-memory implementation of KVMemory.
+ *
+ * @template T - The type of data to store
+ *
+ * @example
+ * ```typescript
+ * import { InMemoryStore, Summary, type StoredSummary } from "@fastpaca/cria";
+ *
+ * const store = new InMemoryStore<StoredSummary>();
+ *
+ * <Summary store={store} ... />
+ * ```
+ */
+export class InMemoryStore {
+    store = new Map();
+    get(key) {
+        return this.store.get(key) ?? null;
+    }
+    set(key, data, metadata) {
+        const now = Date.now();
+        const existing = this.store.get(key);
+        this.store.set(key, {
+            data,
+            createdAt: existing?.createdAt ?? now,
+            updatedAt: now,
+            ...(metadata && { metadata }),
+        });
+    }
+    delete(key) {
+        return this.store.delete(key);
+    }
+}
+//# sourceMappingURL=key-value.js.map

package/dist/memory/key-value.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"key-value.js","sourceRoot":"","sources":["../../src/memory/key-value.ts"],"names":[],"mappings":"AA2DA;;;;;;;;;;;;;GAaG;AACH,MAAM,OAAO,aAAa;IACP,KAAK,GAAG,IAAI,GAAG,EAA0B,CAAC;IAE3D,GAAG,CAAC,GAAW;QACb,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,IAAI,CAAC;IACrC,CAAC;IAED,GAAG,CAAC,GAAW,EAAE,IAAO,EAAE,QAAkC;QAC1D,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACvB,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAErC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE;YAClB,IAAI;YACJ,SAAS,EAAE,QAAQ,EAAE,SAAS,IAAI,GAAG;YACrC,SAAS,EAAE,GAAG;YACd,GAAG,CAAC,QAAQ,IAAI,EAAE,QAAQ,EAAE,CAAC;SAC9B,CAAC,CAAC;IACL,CAAC;IAED,MAAM,CAAC,GAAW;QAChB,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IAChC,CAAC;CACF"}