@fastpaca/cria 0.0.1 → 1.0.1

package/dist/components/summary.test.js.map

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

package/dist/components/vector-search.d.ts

@@ -0,0 +1,70 @@
+import type { VectorMemory, VectorSearchResult } from "../memory";
+import type { CompletionMessage, PromptChildren, PromptElement } from "../types";
+/**
+ * Function that formats search results into prompt content.
+ *
+ * @template T - The type of data stored in the vector memory
+ */
+export type ResultFormatter<T = unknown> = (results: VectorSearchResult<T>[]) => string;
+type QueryExtractor = (messages: CompletionMessage[]) => string | null | undefined;
+interface VectorSearchProps<T = unknown> {
+    /** Vector memory store to search */
+    store: VectorMemory<T>;
+    /**
+     * Query string. If omitted, the component will try to derive the query from
+     * children, then from `messages` (defaulting to the last user message).
+     */
+    query?: string | undefined;
+    /**
+     * Optional messages to derive a query from (uses last user message by default).
+     */
+    messages?: CompletionMessage[];
+    /** Custom query extractor (overrides the default last-user-message behavior). */
+    extractQuery?: QueryExtractor;
+    /** Maximum number of results to return. Default: 5 */
+    limit?: number;
+    /** Minimum similarity threshold (0-1). Results below this are excluded. */
+    threshold?: number;
+    /** Custom formatter for search results. Default: numbered list format */
+    formatResults?: ResultFormatter<T>;
+    /** Priority for this region (higher number = reduced first). Default: 0 */
+    priority?: number;
+    /** Stable identifier for caching/debugging */
+    id?: string;
+    /** Query text provided as children (preferred over `query` when present). */
+    children?: PromptChildren;
+}
+/**
+ * Renders vector search results into the prompt.
+ *
+ * The query is resolved at render time. No pre-fetching needed. Query sources, in
+ * order of precedence:
+ * 1) Children text: `<VectorSearch store={store}>find docs about RAG</VectorSearch>`
+ * 2) `query` prop: `<VectorSearch store={store} query="find docs about RAG" />`
+ * 3) Messages: `<VectorSearch store={store} messages={messages} />`
+ *    - Defaults to the last user message, or use `extractQuery` to customize.
+ *
+ * @example
+ * ```tsx
+ * <VectorSearch store={store} limit={5}>
+ *   my query: {topic}
+ * </VectorSearch>
+ * ```
+ *
+ * @example Using messages as the query source
+ * ```tsx
+ * <VectorSearch store={store} messages={messages} />
+ * ```
+ *
+ * @example Custom extractor
+ * ```tsx
+ * <VectorSearch
+ *   store={store}
+ *   messages={messages}
+ *   extractQuery={(msgs) => msgs.at(-1)?.content}
+ * />
+ * ```
+ */
+export declare function VectorSearch<T = unknown>({ store, query, messages, extractQuery, limit, threshold, formatResults, priority, id, children, }: VectorSearchProps<T>): Promise<PromptElement>;
+export {};
+//# sourceMappingURL=vector-search.d.ts.map

package/dist/components/vector-search.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vector-search.d.ts","sourceRoot":"","sources":["../../src/components/vector-search.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,YAAY,EAEZ,kBAAkB,EACnB,MAAM,WAAW,CAAC;AACnB,OAAO,KAAK,EACV,iBAAiB,EACjB,cAAc,EACd,aAAa,EACd,MAAM,UAAU,CAAC;AAElB;;;;GAIG;AACH,MAAM,MAAM,eAAe,CAAC,CAAC,GAAG,OAAO,IAAI,CACzC,OAAO,EAAE,kBAAkB,CAAC,CAAC,CAAC,EAAE,KAC7B,MAAM,CAAC;AAsBZ,KAAK,cAAc,GAAG,CACpB,QAAQ,EAAE,iBAAiB,EAAE,KAC1B,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;AAE/B,UAAU,iBAAiB,CAAC,CAAC,GAAG,OAAO;IACrC,oCAAoC;IACpC,KAAK,EAAE,YAAY,CAAC,CAAC,CAAC,CAAC;IACvB;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B;;OAEG;IACH,QAAQ,CAAC,EAAE,iBAAiB,EAAE,CAAC;IAC/B,iFAAiF;IACjF,YAAY,CAAC,EAAE,cAAc,CAAC;IAC9B,sDAAsD;IACtD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,2EAA2E;IAC3E,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,yEAAyE;IACzE,aAAa,CAAC,EAAE,eAAe,CAAC,CAAC,CAAC,CAAC;IACnC,2EAA2E;IAC3E,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,8CAA8C;IAC9C,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,6EAA6E;IAC7E,QAAQ,CAAC,EAAE,cAAc,CAAC;CAC3B;AA0DD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,wBAAsB,YAAY,CAAC,CAAC,GAAG,OAAO,EAAE,EAC9C,KAAK,EACL,KAAK,EACL,QAAQ,EACR,YAAY,EACZ,KAAS,EACT,SAAS,EACT,aAAgC,EAChC,QAAY,EACZ,EAAE,EACF,QAAQ,GACT,EAAE,iBAAiB,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,aAAa,CAAC,CA2B/C"}

package/dist/components/vector-search.js

@@ -0,0 +1,110 @@
+/**
+ * Default formatter that renders results as a numbered list.
+ * Throws if no results found - provide a custom formatter to handle empty results differently.
+ */
+function defaultFormatter(results) {
+    if (results.length === 0) {
+        throw new Error("VectorSearch: no results found");
+    }
+    return results
+        .map((result, index) => {
+        const data = typeof result.entry.data === "string"
+            ? result.entry.data
+            : JSON.stringify(result.entry.data, null, 2);
+        return `[${index + 1}] (score: ${result.score.toFixed(3)})\n${data}`;
+    })
+        .join("\n\n");
+}
+function queryFromChildren(children) {
+    if (!children || children.length === 0) {
+        return null;
+    }
+    let buffer = "";
+    for (const child of children) {
+        if (typeof child !== "string") {
+            throw new Error("VectorSearch children must be plain text. Wrap complex content in a formatter before passing it as a query.");
+        }
+        buffer += child;
+    }
+    const trimmed = buffer.trim();
+    return trimmed === "" ? null : trimmed;
+}
+function defaultExtractQuery(messages) {
+    const lastUser = [...messages].reverse().find((m) => m.role === "user");
+    const content = lastUser?.content.trim() ?? "";
+    return content === "" ? null : content;
+}
+function deriveQuery(props) {
+    const childQuery = queryFromChildren(props.children);
+    if (childQuery) {
+        return childQuery;
+    }
+    const directQuery = props.query?.trim();
+    if (directQuery) {
+        return directQuery;
+    }
+    if (props.messages && props.messages.length > 0) {
+        const extracted = props.extractQuery
+            ? props.extractQuery(props.messages)
+            : defaultExtractQuery(props.messages);
+        const trimmed = extracted?.trim() ?? "";
+        if (trimmed) {
+            return trimmed;
+        }
+    }
+    return null;
+}
+/**
+ * Renders vector search results into the prompt.
+ *
+ * The query is resolved at render time. No pre-fetching needed. Query sources, in
+ * order of precedence:
+ * 1) Children text: `<VectorSearch store={store}>find docs about RAG</VectorSearch>`
+ * 2) `query` prop: `<VectorSearch store={store} query="find docs about RAG" />`
+ * 3) Messages: `<VectorSearch store={store} messages={messages} />`
+ *    - Defaults to the last user message, or use `extractQuery` to customize.
+ *
+ * @example
+ * ```tsx
+ * <VectorSearch store={store} limit={5}>
+ *   my query: {topic}
+ * </VectorSearch>
+ * ```
+ *
+ * @example Using messages as the query source
+ * ```tsx
+ * <VectorSearch store={store} messages={messages} />
+ * ```
+ *
+ * @example Custom extractor
+ * ```tsx
+ * <VectorSearch
+ *   store={store}
+ *   messages={messages}
+ *   extractQuery={(msgs) => msgs.at(-1)?.content}
+ * />
+ * ```
+ */
+export async function VectorSearch({ store, query, messages, extractQuery, limit = 5, threshold, formatResults = defaultFormatter, priority = 0, id, children, }) {
+    const finalQuery = deriveQuery({
+        query,
+        messages,
+        extractQuery,
+        children,
+    });
+    if (!finalQuery) {
+        throw new Error("VectorSearch: no query provided. Pass a query via children, the query prop, or messages.");
+    }
+    const searchOptions = {
+        limit,
+        ...(threshold !== undefined && { threshold }),
+    };
+    const results = await store.search(finalQuery, searchOptions);
+    const content = formatResults(results);
+    return {
+        priority,
+        children: [content],
+        ...(id && { id }),
+    };
+}
+//# sourceMappingURL=vector-search.js.map

package/dist/components/vector-search.js.map

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

package/dist/components/vector-search.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=vector-search.test.d.ts.map

package/dist/components/vector-search.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vector-search.test.d.ts","sourceRoot":"","sources":["../../src/components/vector-search.test.tsx"],"names":[],"mappings":""}

package/dist/components/vector-search.test.js

@@ -0,0 +1,113 @@
+import { describe, expect, it } from "vitest";
+import { VectorSearch } from "./vector-search";
+const mockResults = [
+    {
+        key: "doc-1",
+        score: 0.95,
+        entry: {
+            data: { title: "First Document", content: "This is the first document." },
+            createdAt: 1_700_000_000_000,
+            updatedAt: 1_700_000_000_000,
+        },
+    },
+    {
+        key: "doc-2",
+        score: 0.82,
+        entry: {
+            data: {
+                title: "Second Document",
+                content: "This is the second document.",
+            },
+            createdAt: 1_700_000_001_000,
+            updatedAt: 1_700_000_001_000,
+        },
+    },
+];
+function createMockStore(results) {
+    let lastQuery;
+    let lastOptions;
+    const store = {
+        get: () => null,
+        set: () => {
+            /* no-op */
+        },
+        delete: () => false,
+        search: (query, options) => {
+            lastQuery = query;
+            lastOptions = options;
+            return results;
+        },
+    };
+    return {
+        store,
+        getLastQuery: () => lastQuery,
+        getLastOptions: () => lastOptions,
+    };
+}
+const PLAIN_TEXT_REGEX = /plain text/;
+describe("VectorSearch", () => {
+    it("uses children as the query and renders results", async () => {
+        const { store, getLastQuery, getLastOptions } = createMockStore(mockResults);
+        const element = await VectorSearch({
+            store,
+            limit: 2,
+            children: ["Find docs about RAG"],
+        });
+        expect(getLastQuery()).toBe("Find docs about RAG");
+        expect(getLastOptions()).toEqual({ limit: 2 });
+        expect(element.children[0]).toContain("First Document");
+    });
+    it("derives query from the last user message by default", async () => {
+        const { store, getLastQuery } = createMockStore(mockResults);
+        const messages = [
+            { role: "assistant", content: "Previous answer" },
+            { role: "user", content: "What is RAG?" },
+        ];
+        const element = await VectorSearch({ store, messages });
+        expect(getLastQuery()).toBe("What is RAG?");
+        expect(element.children[0]).toContain("First Document");
+    });
+    it("uses a custom extractor when provided", async () => {
+        const { store, getLastQuery } = createMockStore(mockResults);
+        const messages = [
+            { role: "user", content: "ignore me" },
+            { role: "assistant", content: "assistant reply" },
+        ];
+        const element = await VectorSearch({
+            store,
+            messages,
+            extractQuery: () => "custom-query",
+        });
+        expect(getLastQuery()).toBe("custom-query");
+        expect(element.children[0]).toContain("First Document");
+    });
+    it("throws when no results found", async () => {
+        const { store } = createMockStore([]);
+        await expect(VectorSearch({
+            store,
+            query: "nothing here",
+        })).rejects.toThrow("no results found");
+    });
+    it("throws when no query is available", async () => {
+        const { store } = createMockStore([]);
+        await expect(VectorSearch({ store })).rejects.toThrow("no query provided");
+    });
+    it("uses custom formatter", async () => {
+        const { store } = createMockStore(mockResults);
+        const element = await VectorSearch({
+            store,
+            query: "test",
+            formatResults: (results) => `Found ${results.length} results`,
+        });
+        expect(element.children[0]).toBe("Found 2 results");
+    });
+    it("rejects non-text children", async () => {
+        const { store } = createMockStore(mockResults);
+        const badChild = { priority: 0, children: [] };
+        await expect(VectorSearch({
+            store,
+            children: [badChild],
+        })).rejects.toThrow(PLAIN_TEXT_REGEX);
+    });
+});
+//# sourceMappingURL=vector-search.test.js.map

package/dist/components/vector-search.test.js.map

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

package/dist/index.d.ts

@@ -8,7 +8,7 @@
  * const prompt = (
  *   <Region priority={0}>
  *     You are a helpful assistant.
- *     <Truncate budget={20000} direction="start" priority={2}>
+ *     <Truncate budget={20000} from="start" priority={2}>
  *       {conversationHistory}
  *     </Truncate>
  *     <Omit priority={3}>
@@ -17,13 +17,20 @@
  *   </Region>
  * );
  *
- * const result = render(prompt, { tokenizer, budget: 128000 });
+ * const result = await render(prompt, { tokenizer, budget: 128000 });
  * ```
  *
  * @packageDocumentation
  */
-export { Omit, Region, Truncate } from "./components";
+export type { ResultFormatter, StoredSummary, Summarizer, SummarizerContext, } from "./components";
+export { CodeBlock, Examples, Last, Message, Omit, Reasoning, Region, Separator, Summary, ToolCall, ToolResult, Truncate, VectorSearch, } from "./components";
+export { createOtelRenderHooks } from "./instrumentation/otel";
+export type { KVMemory, MemoryEntry, VectorMemory, VectorSearchOptions, VectorSearchResult, } from "./memory";
+export { InMemoryStore } from "./memory";
+export type { FitCompleteEvent, FitErrorEvent, FitIterationEvent, FitStartEvent, RenderHooks, RenderOptions, StrategyAppliedEvent, } from "./render";
 export { render } from "./render";
-export type { PromptChildren, PromptElement, PromptFragment, Strategy, StrategyInput, Tokenizer, } from "./types";
-export { FitError } from "./types";
+export { markdownRenderer } from "./renderers/markdown";
+export { createSnapshot, createSnapshotHooks, diffSnapshots, type Snapshot, type SnapshotChild, type SnapshotDiff, type SnapshotElement, } from "./snapshot";
+export type { CompletionMessage, CompletionRequest, CompletionResult, CriaContext, JsonValue, MaybePromise, ModelProvider, PromptChild, PromptChildren, PromptElement, PromptKind, PromptNodeKind, PromptRenderer, PromptRole, Strategy, StrategyInput, StrategyResult, Tokenizer, } from "./types";
+export { FitError, JsonValueSchema, PromptChildrenSchema, PromptChildSchema, PromptElementSchema, PromptKindSchema, PromptRoleSchema, } from "./types";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAGH,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AACtD,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAClC,YAAY,EACV,cAAc,EACd,aAAa,EACb,cAAc,EACd,QAAQ,EACR,aAAa,EACb,SAAS,GACV,MAAM,SAAS,CAAC;AACjB,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,YAAY,EACV,eAAe,EACf,aAAa,EACb,UAAU,EACV,iBAAiB,GAClB,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,SAAS,EACT,QAAQ,EACR,IAAI,EACJ,OAAO,EACP,IAAI,EACJ,SAAS,EACT,MAAM,EACN,SAAS,EACT,OAAO,EACP,QAAQ,EACR,UAAU,EACV,QAAQ,EACR,YAAY,GACb,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AAC/D,YAAY,EACV,QAAQ,EACR,WAAW,EACX,YAAY,EACZ,mBAAmB,EACnB,kBAAkB,GACnB,MAAM,UAAU,CAAC;AAElB,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,YAAY,EACV,gBAAgB,EAChB,aAAa,EACb,iBAAiB,EACjB,aAAa,EACb,WAAW,EACX,aAAa,EACb,oBAAoB,GACrB,MAAM,UAAU,CAAC;AAClB,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAClC,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AACxD,OAAO,EACL,cAAc,EACd,mBAAmB,EACnB,aAAa,EACb,KAAK,QAAQ,EACb,KAAK,aAAa,EAClB,KAAK,YAAY,EACjB,KAAK,eAAe,GACrB,MAAM,YAAY,CAAC;AACpB,YAAY,EACV,iBAAiB,EACjB,iBAAiB,EACjB,gBAAgB,EAChB,WAAW,EACX,SAAS,EACT,YAAY,EACZ,aAAa,EACb,WAAW,EACX,cAAc,EACd,aAAa,EACb,UAAU,EACV,cAAc,EACd,cAAc,EACd,UAAU,EACV,QAAQ,EACR,aAAa,EACb,cAAc,EACd,SAAS,GACV,MAAM,SAAS,CAAC;AACjB,OAAO,EACL,QAAQ,EACR,eAAe,EACf,oBAAoB,EACpB,iBAAiB,EACjB,mBAAmB,EACnB,gBAAgB,EAChB,gBAAgB,GACjB,MAAM,SAAS,CAAC"}

package/dist/index.js

@@ -8,7 +8,7 @@
  * const prompt = (
  *   <Region priority={0}>
  *     You are a helpful assistant.
- *     <Truncate budget={20000} direction="start" priority={2}>
+ *     <Truncate budget={20000} from="start" priority={2}>
  *       {conversationHistory}
  *     </Truncate>
  *     <Omit priority={3}>
@@ -17,13 +17,17 @@
  *   </Region>
  * );
  *
- * const result = render(prompt, { tokenizer, budget: 128000 });
+ * const result = await render(prompt, { tokenizer, budget: 128000 });
  * ```
  *
  * @packageDocumentation
  */
-// biome-ignore lint/performance/noBarrelFile: Entry point for package exports
-export { Omit, Region, Truncate } from "./components";
+export { CodeBlock, Examples, Last, Message, Omit, Reasoning, Region, Separator, Summary, ToolCall, ToolResult, Truncate, VectorSearch, } from "./components";
+export { createOtelRenderHooks } from "./instrumentation/otel";
+// LLM Memory
+export { InMemoryStore } from "./memory";
 export { render } from "./render";
-export { FitError } from "./types";
+export { markdownRenderer } from "./renderers/markdown";
+export { createSnapshot, createSnapshotHooks, diffSnapshots, } from "./snapshot";
+export { FitError, JsonValueSchema, PromptChildrenSchema, PromptChildSchema, PromptElementSchema, PromptKindSchema, PromptRoleSchema, } from "./types";
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,8EAA8E;AAC9E,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AACtD,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AASlC,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAQH,OAAO,EACL,SAAS,EACT,QAAQ,EACR,IAAI,EACJ,OAAO,EACP,IAAI,EACJ,SAAS,EACT,MAAM,EACN,SAAS,EACT,OAAO,EACP,QAAQ,EACR,UAAU,EACV,QAAQ,EACR,YAAY,GACb,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AAQ/D,aAAa;AACb,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAUzC,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAClC,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AACxD,OAAO,EACL,cAAc,EACd,mBAAmB,EACnB,aAAa,GAKd,MAAM,YAAY,CAAC;AAqBpB,OAAO,EACL,QAAQ,EACR,eAAe,EACf,oBAAoB,EACpB,iBAAiB,EACjB,mBAAmB,EACnB,gBAAgB,EAChB,gBAAgB,GACjB,MAAM,SAAS,CAAC"}

package/dist/instrumentation/otel.d.ts

@@ -0,0 +1,19 @@
+import { type Attributes, type Tracer } from "@opentelemetry/api";
+import type { RenderHooks } from "../render";
+interface OtelRenderHooksOptions {
+    tracer: Tracer;
+    /** Root span name for a render fit. Default: "cria.fit". */
+    spanName?: string;
+    /** Static attributes applied to all spans. */
+    attributes?: Attributes;
+}
+/**
+ * Creates RenderHooks that emit OpenTelemetry spans for fit lifecycle events.
+ *
+ * - Throws if tracer operations throw.
+ * - Uses the provided tracer; does not create global tracers.
+ * - Uses explicit ids when present for stable node attribution.
+ */
+export declare function createOtelRenderHooks({ tracer, spanName, attributes, }: OtelRenderHooksOptions): RenderHooks;
+export {};
+//# sourceMappingURL=otel.d.ts.map

package/dist/instrumentation/otel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"otel.d.ts","sourceRoot":"","sources":["../../src/instrumentation/otel.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,UAAU,EAIf,KAAK,MAAM,EACZ,MAAM,oBAAoB,CAAC;AAC5B,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAG7C,UAAU,sBAAsB;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,4DAA4D;IAC5D,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,8CAA8C;IAC9C,UAAU,CAAC,EAAE,UAAU,CAAC;CACzB;AAED;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CAAC,EACpC,MAAM,EACN,QAAqB,EACrB,UAAe,GAChB,EAAE,sBAAsB,GAAG,WAAW,CAwEtC"}

package/dist/instrumentation/otel.js

@@ -0,0 +1,102 @@
+import { context, SpanStatusCode, } from "@opentelemetry/api";
+/**
+ * Creates RenderHooks that emit OpenTelemetry spans for fit lifecycle events.
+ *
+ * - Throws if tracer operations throw.
+ * - Uses the provided tracer; does not create global tracers.
+ * - Uses explicit ids when present for stable node attribution.
+ */
+export function createOtelRenderHooks({ tracer, spanName = "cria.fit", attributes = {}, }) {
+    let fitSpan = null;
+    const startChildSpan = (name, attrs) => {
+        const span = tracer.startSpan(name, undefined, context.active());
+        if (fitSpan) {
+            span.setAttribute("cria.fit.trace_id", fitSpan.spanContext().traceId);
+        }
+        setAttributes(span, { ...attributes, ...attrs });
+        return span;
+    };
+    return {
+        onFitStart: (event) => {
+            fitSpan = tracer.startSpan(spanName, undefined, context.active());
+            setAttributes(fitSpan, {
+                ...attributes,
+                "cria.budget": event.budget,
+                "cria.total_tokens": event.totalTokens,
+            });
+            setElementAttributes(fitSpan, event.element);
+        },
+        onFitIteration: (event) => {
+            const span = startChildSpan(`${spanName}.iteration`, {
+                "cria.iteration": event.iteration,
+                "cria.priority": event.priority,
+                "cria.total_tokens": event.totalTokens,
+            });
+            span.end();
+        },
+        onStrategyApplied: (event) => {
+            const span = startChildSpan(`${spanName}.strategy`, {
+                "cria.iteration": event.iteration,
+                "cria.priority": event.priority,
+                "cria.strategy.result": event.result ? "node" : "null",
+            });
+            setElementAttributes(span, event.target);
+            span.end();
+        },
+        onFitComplete: (event) => {
+            if (!fitSpan) {
+                return;
+            }
+            setAttributes(fitSpan, {
+                "cria.iterations": event.iterations,
+                "cria.total_tokens": event.totalTokens,
+            });
+            fitSpan.end();
+            fitSpan = null;
+        },
+        onFitError: (event) => {
+            const span = fitSpan ?? tracer.startSpan(spanName, undefined, context.active());
+            setAttributes(span, {
+                ...attributes,
+                "cria.iteration": event.iteration,
+                "cria.priority": event.priority,
+                "cria.total_tokens": event.totalTokens,
+            });
+            span.setStatus({
+                code: SpanStatusCode.ERROR,
+                message: event.error.message,
+            });
+            span.recordException(event.error);
+            span.end();
+            fitSpan = null;
+        },
+    };
+}
+function setElementAttributes(span, element) {
+    span.setAttribute("cria.node.kind", element.kind ?? "region");
+    span.setAttribute("cria.node.priority", element.priority);
+    if (element.id) {
+        span.setAttribute("cria.node.id", element.id);
+    }
+    switch (element.kind) {
+        case "message":
+            span.setAttribute("cria.node.role", element.role);
+            break;
+        case "tool-call":
+        case "tool-result":
+            span.setAttribute("cria.node.tool_call_id", element.toolCallId);
+            span.setAttribute("cria.node.tool_name", element.toolName);
+            break;
+        default:
+            // No additional attributes for other element kinds
+            break;
+    }
+}
+function setAttributes(span, attrs) {
+    for (const [key, value] of Object.entries(attrs)) {
+        if (value !== undefined) {
+            span.setAttribute(key, value);
+        }
+    }
+}
+//# sourceMappingURL=otel.js.map

package/dist/instrumentation/otel.js.map

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

package/dist/instrumentation/otel.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=otel.test.d.ts.map

package/dist/instrumentation/otel.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"otel.test.d.ts","sourceRoot":"","sources":["../../src/instrumentation/otel.test.tsx"],"names":[],"mappings":""}