@fastpaca/cria 1.2.0 → 1.4.0

package/README.md

@@ -11,7 +11,6 @@
 <p align="center">
   <a href="https://github.com/fastpaca/cria/actions/workflows/ci.yml"><img src="https://github.com/fastpaca/cria/actions/workflows/ci.yml/badge.svg" alt="CI"></a>
   <a href="https://www.npmjs.com/package/@fastpaca/cria"><img src="https://img.shields.io/npm/v/@fastpaca/cria?logo=npm&logoColor=white" alt="npm"></a>
-  <a href="https://www.npmjs.com/package/@fastpaca/cria"><img src="https://img.shields.io/npm/dm/@fastpaca/cria" alt="Downloads"></a>
   <a href="https://opensource.org/license/mit"><img src="https://img.shields.io/badge/license-MIT-blue" alt="License"></a>
 </p>
 
@@ -28,15 +27,14 @@ const messages = await cria
   .prompt()
   .system("You are a research assistant.")
   .vectorSearch({ store, query: question, limit: 10 })
-  .provider(openai("gpt-5-nano"), p => p
-    .summary(conversation, { store: memory })
-    .last(conversation, { N: 20 })
+  .provider(provider, (p) =>
+    p.summary(conversation, { store: memory }).last(conversation, { N: 20 })
   )
   .user(question)
   .render({ budget: 200_000, renderer });
 ```
 
-See all **[-> Documentation](docs/README.md)** for more comprehensive overviews.
+Start with **[Quickstart](docs/quickstart.md)**, then use **[Docs](docs/README.md)** to jump to the right how-to.
 
 ## Use Cria when you need...
 
@@ -120,6 +118,30 @@ const { text } = await generateText({ model, messages });
 ```
 </details>
 
+## Evaluation (LLM-as-a-judge)
+
+Use the `@fastpaca/cria/eval` entrypoint for judge-style evaluation helpers.
+
+```ts
+import { c, cria } from "@fastpaca/cria";
+import { createProvider } from "@fastpaca/cria/ai-sdk";
+import { createJudge } from "@fastpaca/cria/eval";
+import { openai } from "@ai-sdk/openai";
+
+const judge = createJudge({
+  target: createProvider(openai("gpt-4o")),
+  evaluator: createProvider(openai("gpt-4o-mini")),
+});
+
+const prompt = await cria
+  .prompt()
+  .system("You are a helpful customer support agent.")
+  .user("How do I update my payment method?")
+  .build();
+
+await judge(prompt).toPass(c`Helpfulness in addressing the user's question`);
+```
+
 ## Roadmap
 
 **Done**
@@ -131,13 +153,13 @@ const { text } = await generateText({ model, messages });
 - [x] Memory: InMemoryStore, Redis, Postgres, Chroma, Qdrant
 - [x] Observability: render hooks, validation schemas, snapshots, OpenTelemetry
 - [x] Tokenizer helpers
+- [x] Prompt eval / testing functionality
 
 **Planned**
 
 - [ ] Next.js adapter
 - [ ] GenAI semantic conventions for OpenTelemetry
 - [ ] Visualization tool
-- [ ] Prompt eval / testing functionality
 
 ## Contributing
 
@@ -154,7 +176,7 @@ const { text } = await generateText({ model, messages });
 ## FAQ
 
 - **Does this replace my LLM SDK?** No - Cria builds prompt structures. You still use your SDK to call the model.
-- **How do I tune token budgets?** Pass `budget` to `render()` and set priorities on regions. Providers include tiktoken defaults; see [docs/tokenization.md](docs/tokenization.md) to bring your own.
+- **How do I tune token budgets?** Pass `budget` to `render()` and set priorities on regions; see [docs/how-to/fit-and-compaction.md](docs/how-to/fit-and-compaction.md).
 - **Is this production-ready?** Not yet! It is a work in progress and you should test it out before you run this in production.
 
 ## License

package/dist/components/summary.d.ts

@@ -45,7 +45,7 @@ interface SummaryProps {
  * replaces the original content.
  *
  * If no `summarize` function is provided, the component will use the
- * `ModelProvider` from an ancestor provider component with a default
+ * `ModelProvider` from an ancestor provider scope with a default
  * summarization prompt.
  *
  * @example Using a custom summarizer
@@ -66,23 +66,22 @@ interface SummaryProps {
  * </Summary>
  * ```
  *
- * @example Using a provider component
- * ```tsx
- * import { InMemoryStore, Summary, type StoredSummary, render } from "@fastpaca/cria";
- * import { AISDKProvider } from "@fastpaca/cria/ai-sdk";
+ * @example Using a provider scope (DSL)
+ * ```ts
+ * import { cria, InMemoryStore, type StoredSummary } from "@fastpaca/cria";
+ * import { createProvider } from "@fastpaca/cria/ai-sdk";
  * import { openai } from "@ai-sdk/openai";
  *
  * const store = new InMemoryStore<StoredSummary>();
+ * const provider = createProvider(openai("gpt-4o"));
  *
- * const prompt = (
- *   <AISDKProvider model={openai("gpt-4o")}>
- *     <Summary id="conv-history" store={store} priority={2}>
- *       {conversationHistory}
- *     </Summary>
- *   </AISDKProvider>
- * );
+ * const prompt = cria
+ *   .prompt()
+ *   .provider(provider, (p) =>
+ *     p.summary(conversationHistory, { id: "conv-history", store, priority: 2 })
+ *   );
  *
- * const result = await render(prompt, { tokenizer, budget: 4000 });
+ * const result = await prompt.render({ tokenizer, budget: 4000 });
  * ```
  */
 export declare function Summary({ id, store, summarize, priority, children, }: SummaryProps): PromptElement;

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

@@ -1 +1 @@
-{"version":3,"file":"summary.d.ts","sourceRoot":"","sources":["../../src/components/summary.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,KAAK,EACV,YAAY,EAEZ,cAAc,EACd,aAAa,EAGd,MAAM,UAAU,CAAC;AAElB;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,+BAA+B;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,iCAAiC;IACjC,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,oDAAoD;IACpD,OAAO,EAAE,MAAM,CAAC;IAChB,6DAA6D;IAC7D,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;CAChC;AAED;;GAEG;AACH,MAAM,MAAM,UAAU,GAAG,CAAC,GAAG,EAAE,iBAAiB,KAAK,YAAY,CAAC,MAAM,CAAC,CAAC;AAwF1E,UAAU,YAAY;IACpB,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,2EAA2E;IAC3E,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,uCAAuC;IACvC,QAAQ,CAAC,EAAE,cAAc,CAAC;CAC3B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+CG;AACH,wBAAgB,OAAO,CAAC,EACtB,EAAE,EACF,KAAK,EACL,SAAS,EACT,QAAY,EACZ,QAAa,GACd,EAAE,YAAY,GAAG,aAAa,CAM9B"}
+{"version":3,"file":"summary.d.ts","sourceRoot":"","sources":["../../src/components/summary.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,KAAK,EACV,YAAY,EAEZ,cAAc,EACd,aAAa,EAGd,MAAM,UAAU,CAAC;AAElB;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,+BAA+B;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,iCAAiC;IACjC,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,oDAAoD;IACpD,OAAO,EAAE,MAAM,CAAC;IAChB,6DAA6D;IAC7D,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;CAChC;AAED;;GAEG;AACH,MAAM,MAAM,UAAU,GAAG,CAAC,GAAG,EAAE,iBAAiB,KAAK,YAAY,CAAC,MAAM,CAAC,CAAC;AAyF1E,UAAU,YAAY;IACpB,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,2EAA2E;IAC3E,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,uCAAuC;IACvC,QAAQ,CAAC,EAAE,cAAc,CAAC;CAC3B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8CG;AACH,wBAAgB,OAAO,CAAC,EACtB,EAAE,EACF,KAAK,EACL,SAAS,EACT,QAAY,EACZ,QAAa,GACd,EAAE,YAAY,GAAG,aAAa,CAM9B"}

package/dist/components/summary.js

@@ -1,12 +1,12 @@
+import { cria } from "../dsl";
 /**
  * Default summarizer that uses a ModelProvider.
  * This is used when no custom summarize function is provided.
  */
 async function defaultSummarizer(ctx, provider) {
     const systemPrompt = "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.";
-    let userPrompt;
-    if (ctx.existingSummary) {
-        userPrompt = `Here is the existing summary of the conversation so far:
+    const userPrompt = ctx.existingSummary
+        ? `Here is the existing summary of the conversation so far:
 
 ${ctx.existingSummary}
 
@@ -14,18 +14,19 @@ Here is new conversation content to incorporate into the summary:
 
 ${ctx.content}
 
-Please provide an updated summary that incorporates both the existing summary and the new content.`;
-    }
-    else {
-        userPrompt = `Please summarize the following conversation:
+Please provide an updated summary that incorporates both the existing summary and the new content.`
+        : `Please summarize the following conversation:
 
 ${ctx.content}`;
-    }
-    const result = await provider.completion({
-        system: systemPrompt,
-        messages: [{ role: "user", content: userPrompt }],
+    const rendered = await cria
+        .prompt()
+        .system(systemPrompt)
+        .user(userPrompt)
+        .render({
+        renderer: provider.renderer,
+        ...(provider.tokenizer ? { tokenizer: provider.tokenizer } : {}),
     });
-    return result.text;
+    return provider.completion(rendered);
 }
 function createSummaryStrategy({ id, store, summarize, }) {
     return async (input) => {
@@ -44,7 +45,7 @@ function createSummaryStrategy({ id, store, summarize, }) {
             newSummary = await defaultSummarizer(summarizerContext, context.provider);
         }
         else {
-            throw new Error(`Summary "${id}" requires either a 'summarize' function or a provider scope. DSL: wrap in cria.provider(new Provider(), (p) => p.summary(...)). JSX: wrap with <AISDKProvider>...</AISDKProvider>.`);
+            throw new Error(`Summary "${id}" requires either a 'summarize' function or a provider scope. Use cria.provider(modelProvider, (p) => p.summary(...)) to supply one.`);
         }
         const newTokenCount = tokenizer(newSummary);
         await store.set(id, {
@@ -68,7 +69,7 @@ function createSummaryStrategy({ id, store, summarize, }) {
  * replaces the original content.
  *
  * If no `summarize` function is provided, the component will use the
- * `ModelProvider` from an ancestor provider component with a default
+ * `ModelProvider` from an ancestor provider scope with a default
  * summarization prompt.
  *
  * @example Using a custom summarizer
@@ -89,23 +90,22 @@ function createSummaryStrategy({ id, store, summarize, }) {
  * </Summary>
  * ```
  *
- * @example Using a provider component
- * ```tsx
- * import { InMemoryStore, Summary, type StoredSummary, render } from "@fastpaca/cria";
- * import { AISDKProvider } from "@fastpaca/cria/ai-sdk";
+ * @example Using a provider scope (DSL)
+ * ```ts
+ * import { cria, InMemoryStore, type StoredSummary } from "@fastpaca/cria";
+ * import { createProvider } from "@fastpaca/cria/ai-sdk";
  * import { openai } from "@ai-sdk/openai";
  *
  * const store = new InMemoryStore<StoredSummary>();
+ * const provider = createProvider(openai("gpt-4o"));
  *
- * const prompt = (
- *   <AISDKProvider model={openai("gpt-4o")}>
- *     <Summary id="conv-history" store={store} priority={2}>
- *       {conversationHistory}
- *     </Summary>
- *   </AISDKProvider>
- * );
+ * const prompt = cria
+ *   .prompt()
+ *   .provider(provider, (p) =>
+ *     p.summary(conversationHistory, { id: "conv-history", store, priority: 2 })
+ *   );
  *
- * const result = await render(prompt, { tokenizer, budget: 4000 });
+ * const result = await prompt.render({ tokenizer, budget: 4000 });
  * ```
  */
 export function Summary({ id, store, summarize, priority = 0, children = [], }) {

package/dist/components/summary.js.map

@@ -1 +1 @@
-{"version":3,"file":"summary.js","sourceRoot":"","sources":["../../src/components/summary.ts"],"names":[],"mappings":"AAmCA;;;GAGG;AACH,KAAK,UAAU,iBAAiB,CAC9B,GAAsB,EACtB,QAAuB;IAEvB,MAAM,YAAY,GAChB,wLAAwL,CAAC;IAE3L,IAAI,UAAkB,CAAC;IACvB,IAAI,GAAG,CAAC,eAAe,EAAE,CAAC;QACxB,UAAU,GAAG;;EAEf,GAAG,CAAC,eAAe;;;;EAInB,GAAG,CAAC,OAAO;;mGAEsF,CAAC;IAClG,CAAC;SAAM,CAAC;QACN,UAAU,GAAG;;EAEf,GAAG,CAAC,OAAO,EAAE,CAAC;IACd,CAAC;IAED,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,UAAU,CAAC;QACvC,MAAM,EAAE,YAAY;QACpB,QAAQ,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,UAAU,EAAE,CAAC;KAClD,CAAC,CAAC;IAEH,OAAO,MAAM,CAAC,IAAI,CAAC;AACrB,CAAC;AAQD,SAAS,qBAAqB,CAAC,EAC7B,EAAE,EACF,KAAK,EACL,SAAS,GACc;IACvB,OAAO,KAAK,EAAE,KAAoB,EAAE,EAAE;QACpC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,WAAW,EAAE,OAAO,EAAE,GAAG,KAAK,CAAC;QAE1D,MAAM,OAAO,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC;QACpC,MAAM,aAAa,GAAG,MAAM,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAE1C,MAAM,iBAAiB,GAAsB;YAC3C,OAAO;YACP,eAAe,EAAE,aAAa,EAAE,IAAI,CAAC,OAAO,IAAI,IAAI;SACrD,CAAC;QAEF,IAAI,UAAkB,CAAC;QACvB,IAAI,SAAS,EAAE,CAAC;YACd,UAAU,GAAG,MAAM,SAAS,CAAC,iBAAiB,CAAC,CAAC;QAClD,CAAC;aAAM,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;YAC5B,UAAU,GAAG,MAAM,iBAAiB,CAAC,iBAAiB,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC;QAC5E,CAAC;aAAM,CAAC;YACN,MAAM,IAAI,KAAK,CACb,YAAY,EAAE,qLAAqL,CACpM,CAAC;QACJ,CAAC;QAED,MAAM,aAAa,GAAG,SAAS,CAAC,UAAU,CAAC,CAAC;QAE5C,MAAM,KAAK,CAAC,GAAG,CAAC,EAAE,EAAE;YAClB,OAAO,EAAE,UAAU;YACnB,UAAU,EAAE,aAAa;SAC1B,CAAC,CAAC;QAEH,wDAAwD;QACxD,OAAO;YACL,IAAI,EAAE,SAAS;YACf,IAAI,EAAE,WAAW;YACjB,QAAQ,EAAE,MAAM,CAAC,QAAQ;YACzB,QAAQ,EAAE,CAAC,sCAAsC,UAAU,EAAE,CAAC;SAC/D,CAAC;IACJ,CAAC,CAAC;AACJ,CAAC;AAkBD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+CG;AACH,MAAM,UAAU,OAAO,CAAC,EACtB,EAAE,EACF,KAAK,EACL,SAAS,EACT,QAAQ,GAAG,CAAC,EACZ,QAAQ,GAAG,EAAE,GACA;IACb,OAAO;QACL,QAAQ;QACR,QAAQ,EAAE,qBAAqB,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC;QACzD,QAAQ;KACT,CAAC;AACJ,CAAC"}
+{"version":3,"file":"summary.js","sourceRoot":"","sources":["../../src/components/summary.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAoC9B;;;GAGG;AACH,KAAK,UAAU,iBAAiB,CAC9B,GAAsB,EACtB,QAAgC;IAEhC,MAAM,YAAY,GAChB,wLAAwL,CAAC;IAE3L,MAAM,UAAU,GAAG,GAAG,CAAC,eAAe;QACpC,CAAC,CAAC;;EAEJ,GAAG,CAAC,eAAe;;;;EAInB,GAAG,CAAC,OAAO;;mGAEsF;QAC/F,CAAC,CAAC;;EAEJ,GAAG,CAAC,OAAO,EAAE,CAAC;IAEd,MAAM,QAAQ,GAAG,MAAM,IAAI;SACxB,MAAM,EAAE;SACR,MAAM,CAAC,YAAY,CAAC;SACpB,IAAI,CAAC,UAAU,CAAC;SAChB,MAAM,CAAC;QACN,QAAQ,EAAE,QAAQ,CAAC,QAAQ;QAC3B,GAAG,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,QAAQ,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACjE,CAAC,CAAC;IAEL,OAAO,QAAQ,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;AACvC,CAAC;AAQD,SAAS,qBAAqB,CAAC,EAC7B,EAAE,EACF,KAAK,EACL,SAAS,GACc;IACvB,OAAO,KAAK,EAAE,KAAoB,EAAE,EAAE;QACpC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,WAAW,EAAE,OAAO,EAAE,GAAG,KAAK,CAAC;QAE1D,MAAM,OAAO,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC;QACpC,MAAM,aAAa,GAAG,MAAM,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAE1C,MAAM,iBAAiB,GAAsB;YAC3C,OAAO;YACP,eAAe,EAAE,aAAa,EAAE,IAAI,CAAC,OAAO,IAAI,IAAI;SACrD,CAAC;QAEF,IAAI,UAAkB,CAAC;QACvB,IAAI,SAAS,EAAE,CAAC;YACd,UAAU,GAAG,MAAM,SAAS,CAAC,iBAAiB,CAAC,CAAC;QAClD,CAAC;aAAM,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;YAC5B,UAAU,GAAG,MAAM,iBAAiB,CAAC,iBAAiB,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC;QAC5E,CAAC;aAAM,CAAC;YACN,MAAM,IAAI,KAAK,CACb,YAAY,EAAE,sIAAsI,CACrJ,CAAC;QACJ,CAAC;QAED,MAAM,aAAa,GAAG,SAAS,CAAC,UAAU,CAAC,CAAC;QAE5C,MAAM,KAAK,CAAC,GAAG,CAAC,EAAE,EAAE;YAClB,OAAO,EAAE,UAAU;YACnB,UAAU,EAAE,aAAa;SAC1B,CAAC,CAAC;QAEH,wDAAwD;QACxD,OAAO;YACL,IAAI,EAAE,SAAS;YACf,IAAI,EAAE,WAAW;YACjB,QAAQ,EAAE,MAAM,CAAC,QAAQ;YACzB,QAAQ,EAAE,CAAC,sCAAsC,UAAU,EAAE,CAAC;SAC/D,CAAC;IACJ,CAAC,CAAC;AACJ,CAAC;AAkBD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8CG;AACH,MAAM,UAAU,OAAO,CAAC,EACtB,EAAE,EACF,KAAK,EACL,SAAS,EACT,QAAQ,GAAG,CAAC,EACZ,QAAQ,GAAG,EAAE,GACA;IACb,OAAO;QACL,QAAQ;QACR,QAAQ,EAAE,qBAAqB,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC;QACzD,QAAQ;KACT,CAAC;AACJ,CAAC"}

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

@@ -1,12 +1,17 @@
 import type { VectorMemory, VectorSearchResult } from "../memory";
-import type { CompletionMessage, PromptChildren, PromptElement } from "../types";
+import type { PromptChildren, PromptElement } from "../types";
+/** Simple message shape for query extraction. */
+interface Message {
+    role: string;
+    content: string;
+}
 /**
  * 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;
+type QueryExtractor = (messages: Message[]) => string | null | undefined;
 interface VectorSearchProps<T = unknown> {
     /** Vector memory store to search */
     store: VectorMemory<T>;
@@ -18,7 +23,7 @@ interface VectorSearchProps<T = unknown> {
     /**
      * Optional messages to derive a query from (uses last user message by default).
      */
-    messages?: CompletionMessage[];
+    messages?: Message[];
     /** Custom query extractor (overrides the default last-user-message behavior). */
     extractQuery?: QueryExtractor;
     /** Maximum number of results to return. Default: 5 */

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

@@ -1 +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"}
+{"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,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAE9D,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,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,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,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.map

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

package/dist/dsl.d.ts

@@ -17,52 +17,30 @@
 import type { ResultFormatter, StoredSummary, Summarizer } from "./components";
 import type { KVMemory, VectorMemory } from "./memory";
 import type { RenderOptions } from "./render";
-import type { ModelProvider, PromptElement, PromptRenderer, PromptRole } from "./types";
+import type { CriaContext, ModelProvider, PromptChild, PromptChildren, PromptElement, PromptRenderer, PromptRole } from "./types";
+type TextValue = PromptChild | boolean | number | null | undefined;
+export type TextInput = TextValue | readonly TextInput[];
+export type ScopeContent = TextInput | PromptBuilder | Promise<PromptElement> | Promise<string>;
+/**
+ * Children can include promises (async components like VectorSearch).
+ * These are resolved when `.build()` resolves the tree.
+ */
+export type BuilderChild = PromptElement | PromptBuilder | string | Promise<PromptElement> | Promise<string>;
 type RenderResult<TOptions extends RenderOptions> = TOptions extends {
     renderer: PromptRenderer<infer TOutput>;
 } ? TOutput : string;
 /**
- * Fluent builder for constructing prompt trees without JSX.
- *
- * Every method returns a new immutable builder instance.
- * Call `.build()` to get the final `PromptElement`.
+ * Shared fluent API for prompt-level and message-level builders.
+ * Keeps component helpers available inside nested scopes.
  */
-export declare class PromptBuilder {
-    private readonly children;
-    private readonly context;
-    private constructor();
-    /**
-     * Create a new empty prompt builder.
-     */
-    static create(): PromptBuilder;
-    /**
-     * Add a system message.
-     */
-    system(text: string, opts?: {
-        priority?: number;
-        id?: string;
-    }): PromptBuilder;
-    /**
-     * Add a user message.
-     */
-    user(text: string, opts?: {
-        priority?: number;
-        id?: string;
-    }): PromptBuilder;
-    /**
-     * Add an assistant message.
-     */
-    assistant(text: string, opts?: {
-        priority?: number;
+export declare abstract class BuilderBase<TBuilder extends BuilderBase<TBuilder>> {
+    protected readonly children: BuilderChild[];
+    protected readonly context: CriaContext | undefined;
+    protected constructor(children?: BuilderChild[], context?: CriaContext | undefined);
+    protected abstract create(children: BuilderChild[], context: CriaContext | undefined): TBuilder;
+    scope(fn: (builder: TBuilder) => TBuilder, opts?: {
         id?: string;
-    }): PromptBuilder;
-    /**
-     * Add a message with a custom role.
-     */
-    message(role: PromptRole, text: string, opts?: {
-        priority?: number;
-        id?: string;
-    }): PromptBuilder;
+    }): TBuilder;
     /**
      * Add content that will be truncated when over budget.
      */
@@ -71,63 +49,35 @@ export declare class PromptBuilder {
         from?: "start" | "end";
         priority?: number;
         id?: string;
-    }): PromptBuilder;
+    }): TBuilder;
     /**
      * Add content that will be entirely removed when over budget.
      */
     omit(content: string | PromptElement | PromptBuilder, opts?: {
         priority?: number;
         id?: string;
-    }): PromptBuilder;
-    /**
-     * Create a nested section.
-     *
-     * @example Anonymous section
-     * ```typescript
-     * .section((s) => s.truncate(content, { budget: 1000 }))
-     * ```
-     *
-     * @example Named section
-     * ```typescript
-     * .section("context", (s) => s.truncate(content, { budget: 1000 }))
-     * ```
-     */
-    region(fn: (builder: PromptBuilder) => PromptBuilder): PromptBuilder;
-    region(name: string, fn: (builder: PromptBuilder) => PromptBuilder): PromptBuilder;
-    /**
-     * Create a nested section/region.
-     *
-     * @example Anonymous section
-     * ```typescript
-     * .section((s) => s.truncate(content, { budget: 1000 }))
-     * ```
-     *
-     * @example Named section
-     * ```typescript
-     * .section("context", (s) => s.truncate(content, { budget: 1000 }))
-     * ```
-     */
-    section(fn: (builder: PromptBuilder) => PromptBuilder): PromptBuilder;
-    section(name: string, fn: (builder: PromptBuilder) => PromptBuilder): PromptBuilder;
+    }): TBuilder;
     /**
      * Merge another builder's contents into this one (zod-like merge).
      * Contexts must be compatible (either identical or undefined).
      */
-    merge(...builders: PromptBuilder[]): PromptBuilder;
+    merge(...builders: TBuilder[]): TBuilder;
     /**
      * Create a provider scope for AI-powered operations like Summary.
      *
      * @example
      * ```typescript
-     * import { Provider } from "@fastpaca/cria/ai-sdk";
+     * import { createProvider } from "@fastpaca/cria/ai-sdk";
+     * import { openai } from "@ai-sdk/openai";
      *
-     * const provider = new Provider(openai("gpt-4o"));
-     * .provider(provider, (p) =>
-     *   p.summary(content, { id: "conv", store })
-     * )
+     * const provider = createProvider(openai("gpt-4o"));
+     * cria.prompt()
+     *   .provider(provider, (p) =>
+     *     p.summary(content, { id: "conv", store })
+     *   )
      * ```
      */
-    provider(modelProvider: ModelProvider, fn: (builder: PromptBuilder) => PromptBuilder): PromptBuilder;
+    provider(modelProvider: ModelProvider<unknown>, fn: (builder: TBuilder) => TBuilder): TBuilder;
     /**
      * Add vector search results (async, resolved at render time).
      */
@@ -139,7 +89,7 @@ export declare class PromptBuilder {
         formatter?: ResultFormatter<T>;
         priority?: number;
         id?: string;
-    }): PromptBuilder;
+    }): TBuilder;
     /**
      * Add content that will be summarized when over budget.
      */
@@ -148,18 +98,69 @@ export declare class PromptBuilder {
         store: KVMemory<StoredSummary>;
         summarize?: Summarizer;
         priority?: number;
-    }): PromptBuilder;
+    }): TBuilder;
     /**
      * Add a formatted list of examples.
      */
     examples(title: string, items: (string | PromptElement)[], opts?: {
         priority?: number;
         id?: string;
-    }): PromptBuilder;
+    }): TBuilder;
     /**
      * Add a raw PromptElement (escape hatch for advanced usage).
      */
-    raw(element: PromptElement | Promise<PromptElement>): PromptBuilder;
+    raw(element: PromptElement | Promise<PromptElement>): TBuilder;
+    buildChildren(): Promise<PromptChildren>;
+    protected addChild(child: BuilderChild): TBuilder;
+    protected addChildren(children: readonly BuilderChild[]): TBuilder;
+}
+export declare class MessageBuilder extends BuilderBase<MessageBuilder> {
+    constructor(children?: BuilderChild[], context?: CriaContext | undefined);
+    protected create(children: BuilderChild[], context: CriaContext | undefined): MessageBuilder;
+    append(content: ScopeContent): MessageBuilder;
+}
+/**
+ * Fluent builder for constructing prompt trees without JSX.
+ *
+ * Every method returns a new immutable builder instance; large chains will copy
+ * child arrays, so keep prompts reasonably sized.
+ * Call `.build()` to get the final `PromptElement`.
+ */
+export declare class PromptBuilder extends BuilderBase<PromptBuilder> {
+    private constructor();
+    /**
+     * Create a new empty prompt builder.
+     */
+    static create(): PromptBuilder;
+    protected create(children: BuilderChild[], context: CriaContext | undefined): PromptBuilder;
+    /**
+     * Add a system message.
+     */
+    system(content: TextInput | ((builder: MessageBuilder) => MessageBuilder), opts?: {
+        priority?: number;
+        id?: string;
+    }): PromptBuilder;
+    /**
+     * Add a user message.
+     */
+    user(content: TextInput | ((builder: MessageBuilder) => MessageBuilder), opts?: {
+        priority?: number;
+        id?: string;
+    }): PromptBuilder;
+    /**
+     * Add an assistant message.
+     */
+    assistant(content: TextInput | ((builder: MessageBuilder) => MessageBuilder), opts?: {
+        priority?: number;
+        id?: string;
+    }): PromptBuilder;
+    /**
+     * Add a message with a custom role.
+     */
+    message(role: PromptRole, content: TextInput | ((builder: MessageBuilder) => MessageBuilder), opts?: {
+        priority?: number;
+        id?: string;
+    }): PromptBuilder;
     /**
      * Build the final PromptElement tree.
      */
@@ -169,10 +170,11 @@ export declare class PromptBuilder {
      * Equivalent to `render(await builder.build(), options)`.
      */
     render<TOptions extends RenderOptions>(options: TOptions): Promise<RenderResult<TOptions>>;
-    private addChild;
+    private addMessage;
 }
+export type Prompt = PromptBuilder;
 /**
- * Namespace for building prompts without JSX.
+ * Namespace for building prompts as code.
  *
  * @example
  * ```typescript
@@ -187,6 +189,7 @@ export declare class PromptBuilder {
  */
 export declare const cria: {
     readonly prompt: () => PromptBuilder;
+    readonly c: typeof c;
     readonly merge: (...builders: PromptBuilder[]) => PromptBuilder;
 };
 /**
@@ -197,5 +200,34 @@ export declare const prompt: () => PromptBuilder;
  * Merge multiple builders into one (zod-like merge).
  */
 export declare const merge: (...builders: PromptBuilder[]) => PromptBuilder;
+/**
+ * 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, PromptElements, arrays, etc.)
+ * @returns Array of prompt children (strings and PromptElements)
+ *
+ * @example
+ * ```typescript
+ * import { c } from "@fastpaca/cria";
+ *
+ * const children = c`
+ *   System: You are a helpful assistant.
+ *   User: ${userMessage}
+ *   Assistant: ${assistantResponse}
+ * `;
+ * ```
+ *
+ * @example
+ * ```typescript
+ * const name = "Alice";
+ * const age = 30;
+ * const children = c`Name: ${name}, Age: ${age}`;
+ * ```
+ */
+export declare function c(strings: TemplateStringsArray, ...values: readonly TextInput[]): PromptChildren;
 export {};
 //# sourceMappingURL=dsl.d.ts.map

package/dist/dsl.d.ts.map

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