@fastpaca/cria 1.4.0 → 1.5.0

package/dist/dsl/strategies.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"strategies.d.ts","sourceRoot":"","sources":["../../src/dsl/strategies.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EACV,eAAe,EACf,iBAAiB,EACjB,UAAU,EACV,UAAU,EACV,WAAW,EACX,cAAc,EACd,aAAa,EACb,QAAQ,EACT,MAAM,UAAU,CAAC;AAElB;;GAEG;AACH,wBAAgB,WAAW,CAAC,OAAO,SAAS,cAAc,EACxD,QAAQ,EAAE,aAAa,CAAC,OAAO,CAAC,EAChC,IAAI,CAAC,EAAE;IAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,QAAQ,CAAC;IAAC,EAAE,CAAC,EAAE,MAAM,CAAA;CAAE,GAC7D,WAAW,CAAC,OAAO,CAAC,CAStB;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,OAAO,SAAS,cAAc,EAC1D,IAAI,EAAE,UAAU,EAChB,QAAQ,EAAE,eAAe,CAAC,OAAO,CAAC,EAClC,EAAE,CAAC,EAAE,MAAM,GACV,iBAAiB,CAAC,OAAO,CAAC,CAQ5B;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,OAAO,GAAG,KAAK,GACpB,QAAQ,CAsBV;AAED;;GAEG;AACH,wBAAgB,kBAAkB,IAAI,QAAQ,CAE7C;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,OAAO,SAAS,cAAc,EAC3D,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,SAAS,MAAM,EAAE,EACxB,SAAS,SAAS,GACjB,UAAU,CAAC,OAAO,CAAC,CAIrB"}

package/dist/dsl/strategies.js

@@ -0,0 +1,62 @@
+/**
+ * Strategy factories and component helpers for the DSL module.
+ */
+/**
+ * Create a scope node with optional priority, strategy, and id.
+ */
+export function createScope(children, opts) {
+    // Thin helper that preserves tool IO types without coercion.
+    return {
+        kind: "scope",
+        priority: opts?.priority ?? 0,
+        children,
+        ...(opts?.strategy && { strategy: opts.strategy }),
+        ...(opts?.id && { id: opts.id }),
+    };
+}
+/**
+ * Create a message node with role and children.
+ */
+export function createMessage(role, children, id) {
+    // Message nodes only carry already-normalized parts; no conversion happens here.
+    return {
+        kind: "message",
+        role,
+        children,
+        ...(id && { id }),
+    };
+}
+/**
+ * Create a truncate strategy that removes children from one end.
+ */
+export function createTruncateStrategy(budget, from) {
+    return (input) => {
+        const { children: currentChildren } = input.target;
+        if (currentChildren.length === 0) {
+            return null;
+        }
+        const dropCount = Math.max(1, Math.floor(input.totalTokens / budget));
+        const nextChildren = from === "start"
+            ? currentChildren.slice(dropCount)
+            : currentChildren.slice(0, Math.max(0, currentChildren.length - dropCount));
+        if (nextChildren.length === 0) {
+            return null;
+        }
+        return { ...input.target, children: nextChildren };
+    };
+}
+/**
+ * Create an omit strategy that removes the entire scope.
+ */
+export function createOmitStrategy() {
+    return () => null;
+}
+/**
+ * Format examples into a text prompt part.
+ */
+export function formatExamples(title, items, separator = "\n\n") {
+    const body = items.length === 0 ? "" : items.join(separator);
+    const text = title ? `${title}\n${body}` : body;
+    return { type: "text", text };
+}
+//# sourceMappingURL=strategies.js.map

package/dist/dsl/strategies.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"strategies.js","sourceRoot":"","sources":["../../src/dsl/strategies.ts"],"names":[],"mappings":"AAAA;;GAEG;AAaH;;GAEG;AACH,MAAM,UAAU,WAAW,CACzB,QAAgC,EAChC,IAA8D;IAE9D,6DAA6D;IAC7D,OAAO;QACL,IAAI,EAAE,OAAO;QACb,QAAQ,EAAE,IAAI,EAAE,QAAQ,IAAI,CAAC;QAC7B,QAAQ;QACR,GAAG,CAAC,IAAI,EAAE,QAAQ,IAAI,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,CAAC;QAClD,GAAG,CAAC,IAAI,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,IAAI,CAAC,EAAE,EAAE,CAAC;KACjC,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,aAAa,CAC3B,IAAgB,EAChB,QAAkC,EAClC,EAAW;IAEX,iFAAiF;IACjF,OAAO;QACL,IAAI,EAAE,SAAS;QACf,IAAI;QACJ,QAAQ;QACR,GAAG,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC;KAClB,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,sBAAsB,CACpC,MAAc,EACd,IAAqB;IAErB,OAAO,CAAC,KAAK,EAAE,EAAE;QACf,MAAM,EAAE,QAAQ,EAAE,eAAe,EAAE,GAAG,KAAK,CAAC,MAAM,CAAC;QACnD,IAAI,eAAe,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACjC,OAAO,IAAI,CAAC;QACd,CAAC;QAED,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,WAAW,GAAG,MAAM,CAAC,CAAC,CAAC;QACtE,MAAM,YAAY,GAChB,IAAI,KAAK,OAAO;YACd,CAAC,CAAC,eAAe,CAAC,KAAK,CAAC,SAAS,CAAC;YAClC,CAAC,CAAC,eAAe,CAAC,KAAK,CACnB,CAAC,EACD,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,eAAe,CAAC,MAAM,GAAG,SAAS,CAAC,CAChD,CAAC;QAER,IAAI,YAAY,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC9B,OAAO,IAAI,CAAC;QACd,CAAC;QAED,OAAO,EAAE,GAAG,KAAK,CAAC,MAAM,EAAE,QAAQ,EAAE,YAAY,EAAE,CAAC;IACrD,CAAC,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,kBAAkB;IAChC,OAAO,GAAG,EAAE,CAAC,IAAI,CAAC;AACpB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,cAAc,CAC5B,KAAa,EACb,KAAwB,EACxB,SAAS,GAAG,MAAM;IAElB,MAAM,IAAI,GAAG,KAAK,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IAC7D,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,GAAG,KAAK,KAAK,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;IAChD,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;AAChC,CAAC"}

package/dist/dsl/summary.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Summary strategy for progressively summarizing conversation history.
+ */
+import type { KVMemory } from "../memory";
+import type { MaybePromise, ModelProvider, PromptRole, PromptScope, ProviderToolIO, ScopeChildren } from "../types";
+/**
+ * Stored summary data persisted across renders.
+ */
+export interface StoredSummary {
+    /** The summary text content */
+    content: string;
+}
+/**
+ * Context passed to the summarizer function.
+ */
+export interface SummarizerContext {
+    /** The subtree being summarized */
+    target: PromptScope<ProviderToolIO>;
+    /** Previous summary to build upon (null if first summary) */
+    existingSummary: string | null;
+    /** Provider in scope, if any */
+    provider?: ModelProvider<unknown, ProviderToolIO>;
+}
+/**
+ * Function that generates summaries.
+ */
+export type Summarizer = (ctx: SummarizerContext) => MaybePromise<string>;
+interface SummaryProps<TToolIO extends ProviderToolIO = ProviderToolIO> {
+    /** Unique identifier for this summary in the store */
+    id: string;
+    /** Storage adapter for persisting summaries */
+    store: KVMemory<StoredSummary>;
+    /**
+     * Function that generates summaries.
+     * If omitted, uses the ModelProvider from render options with a default prompt.
+     */
+    summarize?: Summarizer;
+    /** Priority for this scope (higher number = reduced first). Default: 0 */
+    priority?: number;
+    /** Role for the summary message. Default: "system" */
+    role?: PromptRole;
+    /** Content to potentially summarize */
+    children?: ScopeChildren<TToolIO>;
+}
+/**
+ * A scope that summarizes its content when the prompt needs to shrink.
+ */
+export declare function Summary<TToolIO extends ProviderToolIO>({ id, store, summarize, priority, role, children, }: SummaryProps<TToolIO>): PromptScope<TToolIO>;
+export {};
+//# sourceMappingURL=summary.d.ts.map

package/dist/dsl/summary.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"summary.d.ts","sourceRoot":"","sources":["../../src/dsl/summary.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAE1C,OAAO,KAAK,EACV,YAAY,EACZ,aAAa,EACb,UAAU,EACV,WAAW,EACX,cAAc,EACd,aAAa,EAEd,MAAM,UAAU,CAAC;AAIlB;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,+BAA+B;IAC/B,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,mCAAmC;IACnC,MAAM,EAAE,WAAW,CAAC,cAAc,CAAC,CAAC;IACpC,6DAA6D;IAC7D,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,gCAAgC;IAChC,QAAQ,CAAC,EAAE,aAAa,CAAC,OAAO,EAAE,cAAc,CAAC,CAAC;CACnD;AAED;;GAEG;AACH,MAAM,MAAM,UAAU,GAAG,CAAC,GAAG,EAAE,iBAAiB,KAAK,YAAY,CAAC,MAAM,CAAC,CAAC;AAgC1E,UAAU,YAAY,CAAC,OAAO,SAAS,cAAc,GAAG,cAAc;IACpE,sDAAsD;IACtD,EAAE,EAAE,MAAM,CAAC;IACX,+CAA+C;IAC/C,KAAK,EAAE,QAAQ,CAAC,aAAa,CAAC,CAAC;IAC/B;;;OAGG;IACH,SAAS,CAAC,EAAE,UAAU,CAAC;IACvB,0EAA0E;IAC1E,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,sDAAsD;IACtD,IAAI,CAAC,EAAE,UAAU,CAAC;IAClB,uCAAuC;IACvC,QAAQ,CAAC,EAAE,aAAa,CAAC,OAAO,CAAC,CAAC;CACnC;AAED;;GAEG;AACH,wBAAgB,OAAO,CAAC,OAAO,SAAS,cAAc,EAAE,EACtD,EAAE,EACF,KAAK,EACL,SAAS,EACT,QAAY,EACZ,IAAe,EACf,QAAa,GACd,EAAE,YAAY,CAAC,OAAO,CAAC,GAAG,WAAW,CAAC,OAAO,CAAC,CAqC9C"}

package/dist/dsl/summary.js

@@ -0,0 +1,56 @@
+/**
+ * Summary strategy for progressively summarizing conversation history.
+ */
+import { render } from "../render";
+import { PromptBuilder } from "./builder";
+import { createScope } from "./strategies";
+/**
+ * Default summarizer that uses a ModelProvider.
+ * This is used when no custom summarize function is provided.
+ */
+async function defaultSummarizer(ctx, provider) {
+    const summaryPrompt = await PromptBuilder.create()
+        .system("You are a conversation summarizer. Create a concise summary that captures the key points and context needed to continue the conversation. Be brief but preserve essential information.")
+        .when(ctx.existingSummary !== null, (p) => p.assistant(`Current summary:\n${ctx.existingSummary}`))
+        .merge(ctx.target.children)
+        .when(ctx.existingSummary !== null, (p) => p.user("Update the summary based on the previous summary and the conversation above."))
+        .when(ctx.existingSummary === null, (p) => p.user("Summarize the conversation above."))
+        .build();
+    const rendered = await render(summaryPrompt, { provider });
+    return provider.completion(rendered);
+}
+/**
+ * A scope that summarizes its content when the prompt needs to shrink.
+ */
+export function Summary({ id, store, summarize, priority = 0, role = "system", children = [], }) {
+    return createScope(children, {
+        priority,
+        strategy: async (input) => {
+            const { target, context } = input;
+            const existingEntry = await store.get(id);
+            const summarizerContext = {
+                target,
+                existingSummary: existingEntry?.data.content ?? null,
+                ...(context.provider ? { provider: context.provider } : {}),
+            };
+            let newSummary;
+            if (summarize) {
+                newSummary = await summarize(summarizerContext);
+            }
+            else if (context.provider) {
+                newSummary = await defaultSummarizer(summarizerContext, context.provider);
+            }
+            else {
+                throw new Error(`Summary "${id}" requires either a 'summarize' function or a provider. Pass a provider to render(), bind one with cria.prompt(provider) or cria.prompt().provider(provider), or wrap the summary in cria.prompt().providerScope(provider, (p) => p.summary(...)).`);
+            }
+            await store.set(id, {
+                content: newSummary,
+            });
+            const tree = await PromptBuilder.create()
+                .message(role, newSummary)
+                .build();
+            return { ...tree, priority: target.priority };
+        },
+    });
+}
+//# sourceMappingURL=summary.js.map

package/dist/dsl/summary.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"summary.js","sourceRoot":"","sources":["../../src/dsl/summary.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AAUnC,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AA2B3C;;;GAGG;AACH,KAAK,UAAU,iBAAiB,CAC9B,GAAsB,EACtB,QAAgD;IAEhD,MAAM,aAAa,GAAG,MAAM,aAAa,CAAC,MAAM,EAAE;SAC/C,MAAM,CACL,wLAAwL,CACzL;SACA,IAAI,CAAC,GAAG,CAAC,eAAe,KAAK,IAAI,EAAE,CAAC,CAAC,EAAE,EAAE,CACxC,CAAC,CAAC,SAAS,CAAC,qBAAqB,GAAG,CAAC,eAAe,EAAE,CAAC,CACxD;SACA,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC;SAC1B,IAAI,CAAC,GAAG,CAAC,eAAe,KAAK,IAAI,EAAE,CAAC,CAAC,EAAE,EAAE,CACxC,CAAC,CAAC,IAAI,CACJ,8EAA8E,CAC/E,CACF;SACA,IAAI,CAAC,GAAG,CAAC,eAAe,KAAK,IAAI,EAAE,CAAC,CAAC,EAAE,EAAE,CACxC,CAAC,CAAC,IAAI,CAAC,mCAAmC,CAAC,CAC5C;SACA,KAAK,EAAE,CAAC;IAEX,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,aAAa,EAAE,EAAE,QAAQ,EAAE,CAAC,CAAC;IAC3D,OAAO,QAAQ,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;AACvC,CAAC;AAoBD;;GAEG;AACH,MAAM,UAAU,OAAO,CAAiC,EACtD,EAAE,EACF,KAAK,EACL,SAAS,EACT,QAAQ,GAAG,CAAC,EACZ,IAAI,GAAG,QAAQ,EACf,QAAQ,GAAG,EAAE,GACS;IACtB,OAAO,WAAW,CAAC,QAAQ,EAAE;QAC3B,QAAQ;QACR,QAAQ,EAAE,KAAK,EAAE,KAAoB,EAAE,EAAE;YACvC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,KAAK,CAAC;YAClC,MAAM,aAAa,GAAG,MAAM,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YAE1C,MAAM,iBAAiB,GAAsB;gBAC3C,MAAM;gBACN,eAAe,EAAE,aAAa,EAAE,IAAI,CAAC,OAAO,IAAI,IAAI;gBACpD,GAAG,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aAC5D,CAAC;YAEF,IAAI,UAAkB,CAAC;YACvB,IAAI,SAAS,EAAE,CAAC;gBACd,UAAU,GAAG,MAAM,SAAS,CAAC,iBAAiB,CAAC,CAAC;YAClD,CAAC;iBAAM,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;gBAC5B,UAAU,GAAG,MAAM,iBAAiB,CAClC,iBAAiB,EACjB,OAAO,CAAC,QAAQ,CACjB,CAAC;YACJ,CAAC;iBAAM,CAAC;gBACN,MAAM,IAAI,KAAK,CACb,YAAY,EAAE,oPAAoP,CACnQ,CAAC;YACJ,CAAC;YAED,MAAM,KAAK,CAAC,GAAG,CAAC,EAAE,EAAE;gBAClB,OAAO,EAAE,UAAU;aACpB,CAAC,CAAC;YAEH,MAAM,IAAI,GAAG,MAAM,aAAa,CAAC,MAAM,EAAE;iBACtC,OAAO,CAAC,IAAI,EAAE,UAAU,CAAC;iBACzB,KAAK,EAAE,CAAC;YACX,OAAO,EAAE,GAAG,IAAI,EAAE,QAAQ,EAAE,MAAM,CAAC,QAAQ,EAAE,CAAC;QAChD,CAAC;KACF,CAAC,CAAC;AACL,CAAC"}

package/dist/dsl/templating.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Template literal utilities for building prompt content.
+ *
+ * @packageDocumentation
+ */
+import type { PromptPart, ProviderToolIO } from "../types";
+/**
+ * Text input types for message builders.
+ * These accept raw text and pre-built PromptParts, so tool parts can pass through
+ * without conversion while keeping provider-bound tool IO types intact.
+ */
+export type TextValue<TToolIO extends ProviderToolIO = ProviderToolIO> = PromptPart<TToolIO> | boolean | number | string | null | undefined;
+export type TextInput<TToolIO extends ProviderToolIO = ProviderToolIO> = TextValue<TToolIO> | readonly TextInput<TToolIO>[];
+/**
+ * Tagged template literal function for building prompt children with automatic indentation normalization.
+ *
+ * Interpolates values into template strings and normalizes indentation by stripping
+ * common leading whitespace. Useful for writing multi-line prompt content with clean formatting.
+ *
+ * @param strings - Template string segments
+ * @param values - Interpolated values (strings, numbers, booleans, PromptParts, arrays, etc.)
+ * @returns Array of message parts
+ *
+ * This function allows you to use prompt parts naturally inside template strings.
+ */
+export declare function c(strings: TemplateStringsArray, ...values: readonly TextInput[]): readonly PromptPart[];
+export declare function c<TToolIO extends ProviderToolIO>(strings: TemplateStringsArray, ...values: readonly TextInput<TToolIO>[]): readonly PromptPart<TToolIO>[];
+export declare function textPart<TToolIO extends ProviderToolIO = ProviderToolIO>(value: string): PromptPart<TToolIO>;
+export declare function isPromptPart<TToolIO extends ProviderToolIO = ProviderToolIO>(value: unknown): value is PromptPart<TToolIO>;
+export declare function normalizeTextInput<TToolIO extends ProviderToolIO>(content?: TextInput<TToolIO>): PromptPart<TToolIO>[];
+//# sourceMappingURL=templating.d.ts.map

package/dist/dsl/templating.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"templating.d.ts","sourceRoot":"","sources":["../../src/dsl/templating.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAE3D;;;;GAIG;AACH,MAAM,MAAM,SAAS,CAAC,OAAO,SAAS,cAAc,GAAG,cAAc,IACjE,UAAU,CAAC,OAAO,CAAC,GACnB,OAAO,GACP,MAAM,GACN,MAAM,GACN,IAAI,GACJ,SAAS,CAAC;AACd,MAAM,MAAM,SAAS,CAAC,OAAO,SAAS,cAAc,GAAG,cAAc,IACjE,SAAS,CAAC,OAAO,CAAC,GAClB,SAAS,SAAS,CAAC,OAAO,CAAC,EAAE,CAAC;AAIlC;;;;;;;;;;;GAWG;AACH,wBAAgB,CAAC,CACf,OAAO,EAAE,oBAAoB,EAC7B,GAAG,MAAM,EAAE,SAAS,SAAS,EAAE,GAC9B,SAAS,UAAU,EAAE,CAAC;AACzB,wBAAgB,CAAC,CAAC,OAAO,SAAS,cAAc,EAC9C,OAAO,EAAE,oBAAoB,EAC7B,GAAG,MAAM,EAAE,SAAS,SAAS,CAAC,OAAO,CAAC,EAAE,GACvC,SAAS,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;AAyBlC,wBAAgB,QAAQ,CAAC,OAAO,SAAS,cAAc,GAAG,cAAc,EACtE,KAAK,EAAE,MAAM,GACZ,UAAU,CAAC,OAAO,CAAC,CAErB;AAED,wBAAgB,YAAY,CAAC,OAAO,SAAS,cAAc,GAAG,cAAc,EAC1E,KAAK,EAAE,OAAO,GACb,KAAK,IAAI,UAAU,CAAC,OAAO,CAAC,CAE9B;AAGD,wBAAgB,kBAAkB,CAAC,OAAO,SAAS,cAAc,EAC/D,OAAO,CAAC,EAAE,SAAS,CAAC,OAAO,CAAC,GAC3B,UAAU,CAAC,OAAO,CAAC,EAAE,CA0BvB"}

package/dist/dsl/templating.js

@@ -0,0 +1,83 @@
+/**
+ * Template literal utilities for building prompt content.
+ *
+ * @packageDocumentation
+ */
+const TEMPLATE_INDENT_RE = /^[ \t]*/;
+export function c(strings, ...values) {
+    const normalizedStrings = normalizeTemplateStrings(strings);
+    const children = [];
+    for (let index = 0; index < normalizedStrings.length; index += 1) {
+        const segment = normalizedStrings[index];
+        if (segment !== undefined && segment.length > 0) {
+            children.push({ type: "text", text: segment });
+        }
+        if (index < values.length) {
+            const normalized = normalizeTextInput(values[index]);
+            if (normalized.length > 0) {
+                children.push(...normalized);
+            }
+        }
+    }
+    return children;
+}
+export function textPart(value) {
+    return { type: "text", text: value };
+}
+export function isPromptPart(value) {
+    return typeof value === "object" && value !== null && "type" in value;
+}
+// Normalize text-like inputs into prompt parts while preserving existing parts.
+export function normalizeTextInput(content) {
+    if (content === null || content === undefined) {
+        return [];
+    }
+    if (Array.isArray(content)) {
+        const flattened = [];
+        for (const item of content) {
+            flattened.push(...normalizeTextInput(item));
+        }
+        return flattened;
+    }
+    if (typeof content === "string") {
+        return [textPart(content)];
+    }
+    if (typeof content === "number" || typeof content === "boolean") {
+        return [textPart(String(content))];
+    }
+    if (isPromptPart(content)) {
+        return [content];
+    }
+    throw new Error("Message content must be text or message parts.");
+}
+function normalizeTemplateStrings(strings) {
+    if (strings.length === 0) {
+        return strings;
+    }
+    const normalized = [...strings];
+    if (normalized[0]?.startsWith("\n")) {
+        normalized[0] = normalized[0].slice(1);
+    }
+    const lastIndex = normalized.length - 1;
+    if (normalized[lastIndex]?.endsWith("\n")) {
+        normalized[lastIndex] = normalized[lastIndex].slice(0, -1);
+    }
+    const lines = normalized.flatMap((segment) => segment.split("\n"));
+    const indents = lines
+        .filter((line) => line.trim().length > 0)
+        .map((line) => line.match(TEMPLATE_INDENT_RE)?.[0].length ?? 0);
+    const minIndent = indents.length > 0 ? Math.min(...indents) : 0;
+    if (minIndent === 0) {
+        return normalized;
+    }
+    return normalized.map((segment) => segment
+        .split("\n")
+        .map((line) => {
+        if (line.trim().length === 0) {
+            return "";
+        }
+        return line.slice(Math.min(minIndent, line.length));
+    })
+        .join("\n"));
+}
+//# sourceMappingURL=templating.js.map

package/dist/dsl/templating.js.map

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

package/dist/{components → dsl}/vector-search.d.ts

@@ -1,5 +1,8 @@
+/**
+ * VectorSearch async component for RAG-style retrieval.
+ */
 import type { VectorMemory, VectorSearchResult } from "../memory";
-import type { PromptChildren, PromptElement } from "../types";
+import type { PromptPart, PromptRole, PromptScope, ProviderToolIO } from "../types";
 /** Simple message shape for query extraction. */
 interface Message {
     role: string;
@@ -12,7 +15,7 @@ interface Message {
  */
 export type ResultFormatter<T = unknown> = (results: VectorSearchResult<T>[]) => string;
 type QueryExtractor = (messages: Message[]) => string | null | undefined;
-interface VectorSearchProps<T = unknown> {
+interface VectorSearchProps<T = unknown, TToolIO extends ProviderToolIO = ProviderToolIO> {
     /** Vector memory store to search */
     store: VectorMemory<T>;
     /**
@@ -32,44 +35,18 @@ interface VectorSearchProps<T = unknown> {
     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 for this scope (higher number = reduced first). Default: 0 */
     priority?: number;
     /** Stable identifier for caching/debugging */
     id?: string;
+    /** Role for the emitted message. Default: "user" */
+    role?: PromptRole;
     /** Query text provided as children (preferred over `query` when present). */
-    children?: PromptChildren;
+    children?: readonly PromptPart<TToolIO>[];
 }
 /**
- * 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}
- * />
- * ```
+ * Renders vector search results into a scoped message.
  */
-export declare function VectorSearch<T = unknown>({ store, query, messages, extractQuery, limit, threshold, formatResults, priority, id, children, }: VectorSearchProps<T>): Promise<PromptElement>;
+export declare function VectorSearch<T = unknown, TToolIO extends ProviderToolIO = ProviderToolIO>({ store, query, messages, extractQuery, limit, threshold, formatResults, priority, id, role, children, }: VectorSearchProps<T, TToolIO>): Promise<PromptScope<TToolIO>>;
 export {};
 //# sourceMappingURL=vector-search.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"vector-search.d.ts","sourceRoot":"","sources":["../../src/dsl/vector-search.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EACV,YAAY,EAEZ,kBAAkB,EACnB,MAAM,WAAW,CAAC;AACnB,OAAO,KAAK,EACV,UAAU,EACV,UAAU,EACV,WAAW,EACX,cAAc,EACf,MAAM,UAAU,CAAC;AAGlB,iDAAiD;AACjD,UAAU,OAAO;IACf,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;;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,CAAC,QAAQ,EAAE,OAAO,EAAE,KAAK,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;AAEzE,UAAU,iBAAiB,CACzB,CAAC,GAAG,OAAO,EACX,OAAO,SAAS,cAAc,GAAG,cAAc;IAE/C,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,OAAO,EAAE,CAAC;IACrB,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,0EAA0E;IAC1E,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,8CAA8C;IAC9C,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,oDAAoD;IACpD,IAAI,CAAC,EAAE,UAAU,CAAC;IAClB,6EAA6E;IAC7E,QAAQ,CAAC,EAAE,SAAS,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;CAC3C;AA4DD;;GAEG;AACH,wBAAsB,YAAY,CAChC,CAAC,GAAG,OAAO,EACX,OAAO,SAAS,cAAc,GAAG,cAAc,EAC/C,EACA,KAAK,EACL,KAAK,EACL,QAAQ,EACR,YAAY,EACZ,KAAS,EACT,SAAS,EACT,aAAgC,EAChC,QAAY,EACZ,EAAE,EACF,IAAa,EACb,QAAQ,GACT,EAAE,iBAAiB,CAAC,CAAC,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC,CA8B/D"}

package/dist/{components → dsl}/vector-search.js

@@ -1,3 +1,7 @@
+/**
+ * VectorSearch async component for RAG-style retrieval.
+ */
+import { PromptBuilder } from "./builder";
 /**
  * Default formatter that renders results as a numbered list.
  * Returns a placeholder string when no results are found so prompts can degrade gracefully.
@@ -21,10 +25,10 @@ function queryFromChildren(children) {
     }
     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.");
+        if (child.type !== "text") {
+            throw new Error("VectorSearch children must be text parts. Use a formatter to build complex queries.");
         }
-        buffer += child;
+        buffer += child.text;
     }
     const trimmed = buffer.trim();
     return trimmed === "" ? null : trimmed;
@@ -55,37 +59,9 @@ function deriveQuery(props) {
     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}
- * />
- * ```
+ * Renders vector search results into a scoped message.
  */
-export async function VectorSearch({ store, query, messages, extractQuery, limit = 5, threshold, formatResults = defaultFormatter, priority = 0, id, children, }) {
+export async function VectorSearch({ store, query, messages, extractQuery, limit = 5, threshold, formatResults = defaultFormatter, priority = 0, id, role = "user", children, }) {
     const finalQuery = deriveQuery({
         query,
         messages,
@@ -101,9 +77,11 @@ export async function VectorSearch({ store, query, messages, extractQuery, limit
     };
     const results = await store.search(finalQuery, searchOptions);
     const content = formatResults(results);
+    // Use the DSL to build the result scope
+    const tree = await PromptBuilder.create().message(role, content).build();
     return {
+        ...tree,
         priority,
-        children: [content],
         ...(id && { id }),
     };
 }

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

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

package/dist/eval/index.d.ts

@@ -31,8 +31,19 @@ export type { EvalResult, Judge, JudgeConfig, Judgment } from "./judge";
 export { createJudge } from "./judge";
 export declare const cria: {
     readonly judge: typeof createJudge;
-    readonly prompt: () => import("..").PromptBuilder;
+    readonly prompt: {
+        (): import("..").PromptBuilder<unknown>;
+        <TProvider extends import("..").ModelProvider<unknown, import("..").ProviderToolIO>>(provider: TProvider): import("..").PromptBuilder<TProvider>;
+    };
     readonly c: typeof import("..").c;
-    readonly merge: (...builders: import("..").PromptBuilder[]) => import("..").PromptBuilder;
+    readonly merge: (...builders: import("..").PromptBuilder[]) => import("..").PromptBuilder<unknown>;
+    readonly message: <TToolIO extends import("..").ProviderToolIO>(role: import("..").PromptRole, content: import("..").TextInput<TToolIO>) => import("..").PromptMessageNode<TToolIO>;
+    readonly scope: <TToolIO extends import("..").ProviderToolIO>(children: import("..").ScopeChildren<TToolIO>, opts?: {
+        priority?: number;
+        id?: string;
+    }) => import("..").PromptScope<TToolIO>;
+    readonly user: (content: import("..").TextInput) => import("..").PromptMessageNode<import("..").ProviderToolIO>;
+    readonly system: (content: import("..").TextInput) => import("..").PromptMessageNode<import("..").ProviderToolIO>;
+    readonly assistant: (content: import("..").TextInput) => import("..").PromptMessageNode<import("..").ProviderToolIO>;
 };
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/eval/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAGH,OAAO,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAEtC,YAAY,EAAE,UAAU,EAAE,KAAK,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAExE,OAAO,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAEtC,eAAO,MAAM,IAAI;;;;;CAA+C,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/eval/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAGH,OAAO,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAEtC,YAAY,EAAE,UAAU,EAAE,KAAK,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAExE,OAAO,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAEtC,eAAO,MAAM,IAAI;;;;;;;;;;gBACgZ,CAAC;UAAY,CAAC;;;;;CAD/W,CAAC"}

package/dist/eval/judge.d.ts

@@ -1,8 +1,9 @@
-import type { ModelProvider, PromptChildren, PromptElement } from "../types";
+import type { TextInput } from "../dsl";
+import type { ModelProvider, PromptTree, ProviderToolIO } from "../types";
 export declare const DEFAULT_THRESHOLD = 0.8;
 export interface JudgeConfig {
-    target: ModelProvider<unknown>;
-    evaluator: ModelProvider<unknown>;
+    target: ModelProvider<unknown, ProviderToolIO>;
+    evaluator: ModelProvider<unknown, ProviderToolIO>;
     threshold?: number;
 }
 export interface EvalResult {
@@ -12,8 +13,8 @@ export interface EvalResult {
     response: string;
 }
 export interface Judgment {
-    toPass(criterion: PromptChildren): Promise<void>;
+    toPass(criterion: TextInput): Promise<void>;
 }
-export type Judge = (prompt: PromptElement) => Judgment;
+export type Judge = (prompt: PromptTree) => Judgment;
 export declare function createJudge(config: JudgeConfig): Judge;
 //# sourceMappingURL=judge.d.ts.map

package/dist/eval/judge.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"judge.d.ts","sourceRoot":"","sources":["../../src/eval/judge.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,aAAa,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAE7E,eAAO,MAAM,iBAAiB,MAAM,CAAC;AAErC,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,aAAa,CAAC,OAAO,CAAC,CAAC;IAC/B,SAAS,EAAE,aAAa,CAAC,OAAO,CAAC,CAAC;IAClC,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,OAAO,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,QAAQ;IACvB,MAAM,CAAC,SAAS,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAClD;AAED,MAAM,MAAM,KAAK,GAAG,CAAC,MAAM,EAAE,aAAa,KAAK,QAAQ,CAAC;AAOxD,wBAAgB,WAAW,CAAC,MAAM,EAAE,WAAW,GAAG,KAAK,CA+CtD"}
+{"version":3,"file":"judge.d.ts","sourceRoot":"","sources":["../../src/eval/judge.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAC;AAIxC,OAAO,KAAK,EAAE,aAAa,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAE1E,eAAO,MAAM,iBAAiB,MAAM,CAAC;AAErC,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,aAAa,CAAC,OAAO,EAAE,cAAc,CAAC,CAAC;IAC/C,SAAS,EAAE,aAAa,CAAC,OAAO,EAAE,cAAc,CAAC,CAAC;IAClD,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,OAAO,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,QAAQ;IACvB,MAAM,CAAC,SAAS,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC7C;AAED,MAAM,MAAM,KAAK,GAAG,CAAC,MAAM,EAAE,UAAU,KAAK,QAAQ,CAAC;AAmBrD,wBAAgB,WAAW,CAAC,MAAM,EAAE,WAAW,GAAG,KAAK,CAgDtD"}

package/dist/eval/judge.js

@@ -1,28 +1,41 @@
 import { z } from "zod";
-import { c, cria } from "../dsl";
+import { cria } from "../dsl";
+import { normalizeTextInput } from "../dsl/templating";
 import { render } from "../render";
 export const DEFAULT_THRESHOLD = 0.8;
 const EvalResultSchema = z.object({
     score: z.number().min(0).max(1),
     reasoning: z.string(),
 });
+const formatCriterion = (criterion) => {
+    const parts = normalizeTextInput(criterion);
+    let text = "";
+    for (const part of parts) {
+        if (part.type === "tool-call" || part.type === "tool-result") {
+            throw new Error("Judge criteria cannot include tool calls or results.");
+        }
+        text += part.text;
+    }
+    return text;
+};
 export function createJudge(config) {
     const { target, evaluator, threshold = DEFAULT_THRESHOLD } = config;
     return (prompt) => {
         const evaluate = async (criterion) => {
-            const response = await target.completion(await render(prompt, { renderer: target.renderer }));
+            const response = await target.completion(await render(prompt, { provider: target }));
+            const criteriaText = formatCriterion(criterion);
             const evalPrompt = await cria
                 .prompt()
-                .system(c `You are an evaluator. 
+                .system(`You are an evaluator. 
           Score the response from 0 to 1 based on ALL criteria below.
 
-          Criteria: ${criterion}
+          Criteria: ${criteriaText}
 
           Return JSON: { "score": <0-1>, "reasoning": "<brief explanation>" }
         `)
                 .user(response)
                 .build();
-            const result = await evaluator.object(await render(evalPrompt, { renderer: evaluator.renderer }), EvalResultSchema);
+            const result = await evaluator.object(await render(evalPrompt, { provider: evaluator }), EvalResultSchema);
             return {
                 response,
                 score: result.score,

package/dist/eval/judge.js.map

@@ -1 +1 @@
-{"version":3,"file":"judge.js","sourceRoot":"","sources":["../../src/eval/judge.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AACjC,OAAO,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AAGnC,MAAM,CAAC,MAAM,iBAAiB,GAAG,GAAG,CAAC;AAqBrC,MAAM,gBAAgB,GAAG,CAAC,CAAC,MAAM,CAAC;IAChC,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IAC/B,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;CACtB,CAAC,CAAC;AAEH,MAAM,UAAU,WAAW,CAAC,MAAmB;IAC7C,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,SAAS,GAAG,iBAAiB,EAAE,GAAG,MAAM,CAAC;IAEpE,OAAO,CAAC,MAAqB,EAAY,EAAE;QACzC,MAAM,QAAQ,GAAG,KAAK,EAAE,SAAyB,EAAuB,EAAE;YACxE,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,UAAU,CACtC,MAAM,MAAM,CAAC,MAAM,EAAE,EAAE,QAAQ,EAAE,MAAM,CAAC,QAAQ,EAAE,CAAC,CACpD,CAAC;YACF,MAAM,UAAU,GAAG,MAAM,IAAI;iBAC1B,MAAM,EAAE;iBACR,MAAM,CAAC,CAAC,CAAA;;;sBAGK,SAAS;;;SAGtB,CAAC;iBACD,IAAI,CAAC,QAAQ,CAAC;iBACd,KAAK,EAAE,CAAC;YAEX,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,MAAM,CACnC,MAAM,MAAM,CAAC,UAAU,EAAE,EAAE,QAAQ,EAAE,SAAS,CAAC,QAAQ,EAAE,CAAC,EAC1D,gBAAgB,CACjB,CAAC;YAEF,OAAO;gBACL,QAAQ;gBACR,KAAK,EAAE,MAAM,CAAC,KAAK;gBACnB,SAAS,EAAE,MAAM,CAAC,SAAS;gBAC3B,MAAM,EAAE,MAAM,CAAC,KAAK,IAAI,SAAS;aAClC,CAAC;QACJ,CAAC,CAAC;QAEF,OAAO;YACL,KAAK,CAAC,MAAM,CAAC,SAAS;gBACpB,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,SAAS,CAAC,CAAC;gBACzC,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC;oBACnB,MAAM,IAAI,KAAK,CACb,wCAAwC;wBACtC,UAAU,MAAM,CAAC,KAAK,gBAAgB,SAAS,KAAK;wBACpD,cAAc,MAAM,CAAC,SAAS,MAAM;wBACpC,cAAc,MAAM,CAAC,QAAQ,EAAE,CAClC,CAAC;gBACJ,CAAC;YACH,CAAC;SACF,CAAC;IACJ,CAAC,CAAC;AACJ,CAAC"}
+{"version":3,"file":"judge.js","sourceRoot":"","sources":["../../src/eval/judge.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAC9B,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AAGnC,MAAM,CAAC,MAAM,iBAAiB,GAAG,GAAG,CAAC;AAqBrC,MAAM,gBAAgB,GAAG,CAAC,CAAC,MAAM,CAAC;IAChC,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IAC/B,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;CACtB,CAAC,CAAC;AAEH,MAAM,eAAe,GAAG,CAAC,SAAoB,EAAU,EAAE;IACvD,MAAM,KAAK,GAAG,kBAAkB,CAAiB,SAAS,CAAC,CAAC;IAC5D,IAAI,IAAI,GAAG,EAAE,CAAC;IACd,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,IAAI,CAAC,IAAI,KAAK,WAAW,IAAI,IAAI,CAAC,IAAI,KAAK,aAAa,EAAE,CAAC;YAC7D,MAAM,IAAI,KAAK,CAAC,sDAAsD,CAAC,CAAC;QAC1E,CAAC;QACD,IAAI,IAAI,IAAI,CAAC,IAAI,CAAC;IACpB,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC,CAAC;AAEF,MAAM,UAAU,WAAW,CAAC,MAAmB;IAC7C,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,SAAS,GAAG,iBAAiB,EAAE,GAAG,MAAM,CAAC;IAEpE,OAAO,CAAC,MAAkB,EAAY,EAAE;QACtC,MAAM,QAAQ,GAAG,KAAK,EAAE,SAAoB,EAAuB,EAAE;YACnE,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,UAAU,CACtC,MAAM,MAAM,CAAC,MAAM,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC,CAC3C,CAAC;YACF,MAAM,YAAY,GAAG,eAAe,CAAC,SAAS,CAAC,CAAC;YAChD,MAAM,UAAU,GAAG,MAAM,IAAI;iBAC1B,MAAM,EAAE;iBACR,MAAM,CAAC;;;sBAGM,YAAY;;;SAGzB,CAAC;iBACD,IAAI,CAAC,QAAQ,CAAC;iBACd,KAAK,EAAE,CAAC;YAEX,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,MAAM,CACnC,MAAM,MAAM,CAAC,UAAU,EAAE,EAAE,QAAQ,EAAE,SAAS,EAAE,CAAC,EACjD,gBAAgB,CACjB,CAAC;YAEF,OAAO;gBACL,QAAQ;gBACR,KAAK,EAAE,MAAM,CAAC,KAAK;gBACnB,SAAS,EAAE,MAAM,CAAC,SAAS;gBAC3B,MAAM,EAAE,MAAM,CAAC,KAAK,IAAI,SAAS;aAClC,CAAC;QACJ,CAAC,CAAC;QAEF,OAAO;YACL,KAAK,CAAC,MAAM,CAAC,SAAS;gBACpB,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,SAAS,CAAC,CAAC;gBACzC,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC;oBACnB,MAAM,IAAI,KAAK,CACb,wCAAwC;wBACtC,UAAU,MAAM,CAAC,KAAK,gBAAgB,SAAS,KAAK;wBACpD,cAAc,MAAM,CAAC,SAAS,MAAM;wBACpC,cAAc,MAAM,CAAC,QAAQ,EAAE,CAClC,CAAC;gBACJ,CAAC;YACH,CAAC;SACF,CAAC;IACJ,CAAC,CAAC;AACJ,CAAC"}

package/dist/index.d.ts

@@ -6,26 +6,22 @@
  * import { cria } from "@fastpaca/cria";
  *
  * const result = await cria
- *   .prompt()
+ *   .prompt(provider)
  *   .system("You are a helpful assistant.")
  *   .truncate(conversationHistory, { budget: 20000, from: "start", priority: 2 })
  *   .omit(optionalContext, { priority: 3 })
- *   .render({ tokenizer, budget: 128000 });
+ *   .render({ budget: 128000 });
  * ```
  *
  * @packageDocumentation
  */
-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 type { BuilderChild, Prompt, ScopeContent, TextInput } from "./dsl";
+export type { BuilderChild, Prompt, ResultFormatter, ScopeContent, StoredSummary, Summarizer, SummarizerContext, TextInput, } from "./dsl";
 export { BuilderBase, c, cria, MessageBuilder, merge, PromptBuilder, prompt, } from "./dsl";
 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 { markdownRenderer } from "./renderers/markdown";
-export { createSnapshot, createSnapshotHooks, diffSnapshots, type Snapshot, type SnapshotChild, type SnapshotDiff, type SnapshotElement, } from "./snapshot";
-export type { 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";
+export type { CriaContext, MaybePromise, MessageChildren, PromptLayout, PromptMessage, PromptMessageNode, PromptNode, PromptPart, PromptRole, PromptScope, PromptTree, ProviderToolIO, ReasoningPart, ScopeChildren, Strategy, StrategyInput, StrategyResult, TextPart, ToolCallPart, ToolIOForProvider, ToolResultPart, } from "./types";
+export { FitError, ModelProvider, PromptRenderer } from "./types";
 //# sourceMappingURL=index.d.ts.map