@fastpaca/cria 1.4.0 → 1.6.0

package/dist/dsl/index.js

@@ -0,0 +1,92 @@
+/**
+ * Fluent DSL for building prompts.
+ *
+ * @example
+ * ```typescript
+ * import { cria } from "@fastpaca/cria";
+ *
+ * const prompt = await cria
+ *   .prompt(provider)
+ *   .system("You are a helpful assistant.")
+ *   .user("What is the capital of France?")
+ *   .render({ budget: 4000 });
+ * ```
+ *
+ * @packageDocumentation
+ */
+// biome-ignore lint/performance/noBarrelFile: dsl/index.ts is the primary DSL module entry point, not a barrel file
+export { BuilderBase, MessageBuilder, PromptBuilder, } from "./builder";
+export { c } from "./templating";
+import { PromptBuilder } from "./builder";
+import { createMessage, createScope } from "./strategies";
+// Import for namespace
+import { normalizeTextInput, c as templateC, } from "./templating";
+/** Create a standalone message node */
+function message(role, content) {
+    return createMessage(role, normalizeTextInput(content));
+}
+/** Create a standalone scope node */
+function scope(children, opts) {
+    return createScope(children, opts);
+}
+function input(value) {
+    return { kind: "input", value };
+}
+function inputLayout(value) {
+    return { kind: "input-layout", value };
+}
+function createPrompt(provider) {
+    if (provider === undefined) {
+        return PromptBuilder.create();
+    }
+    return PromptBuilder.create(provider);
+}
+/**
+ * Namespace for building prompts as code.
+ *
+ * @example
+ * ```typescript
+ * import { cria } from "@fastpaca/cria";
+ *
+ * // Full prompt builder
+ * const prompt = cria
+ *   .prompt()
+ *   .system("You are helpful.")
+ *   .user("Hello!")
+ *   .build();
+ *
+ * // Standalone nodes
+ * const msg = cria.user("Hello!");
+ * const root = cria.scope([msg]);
+ * ```
+ */
+export const cria = {
+    prompt: createPrompt,
+    c: templateC,
+    merge: (...builders) => {
+        const [first, ...rest] = builders;
+        if (!first) {
+            return PromptBuilder.create();
+        }
+        return first.merge(...rest);
+    },
+    // Standalone node creators
+    message,
+    scope,
+    user: (content) => message("user", content),
+    system: (content) => message("system", content),
+    developer: (content) => message("developer", content),
+    assistant: (content) => message("assistant", content),
+    input,
+    inputLayout,
+};
+/**
+ * Standalone function to create a new prompt builder.
+ */
+export const prompt = createPrompt;
+/**
+ * Merge multiple builders into one (zod-like merge).
+ */
+export const merge = (...builders) => cria.merge(...builders);
+export { input, inputLayout };
+//# sourceMappingURL=index.js.map

package/dist/dsl/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/dsl/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAQH,oHAAoH;AACpH,OAAO,EACL,WAAW,EACX,cAAc,EACd,aAAa,GACd,MAAM,WAAW,CAAC;AAOnB,OAAO,EAAE,CAAC,EAAkB,MAAM,cAAc,CAAC;AAcjD,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAC1D,uBAAuB;AACvB,OAAO,EACL,kBAAkB,EAElB,CAAC,IAAI,SAAS,GACf,MAAM,cAAc,CAAC;AAEtB,uCAAuC;AACvC,SAAS,OAAO,CACd,IAAgB,EAChB,OAA2B;IAE3B,OAAO,aAAa,CAAC,IAAI,EAAE,kBAAkB,CAAU,OAAO,CAAC,CAAC,CAAC;AACnE,CAAC;AAED,qCAAqC;AACrC,SAAS,KAAK,CACZ,QAAgC,EAChC,IAAyC;IAEzC,OAAO,WAAW,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;AACrC,CAAC;AAED,SAAS,KAAK,CAAY,KAAgB;IACxC,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;AAClC,CAAC;AAED,SAAS,WAAW,CAClB,KAA4B;IAE5B,OAAO,EAAE,IAAI,EAAE,cAAc,EAAE,KAAK,EAAE,CAAC;AACzC,CAAC;AAMD,SAAS,YAAY,CAAC,QAAiD;IACrE,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;QAC3B,OAAO,aAAa,CAAC,MAAM,EAAE,CAAC;IAChC,CAAC;IACD,OAAO,aAAa,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;AACxC,CAAC;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,CAAC,MAAM,IAAI,GAAG;IAClB,MAAM,EAAE,YAAY;IACpB,CAAC,EAAE,SAAS;IACZ,KAAK,EAAE,CAAC,GAAG,QAAyB,EAAE,EAAE;QACtC,MAAM,CAAC,KAAK,EAAE,GAAG,IAAI,CAAC,GAAG,QAAQ,CAAC;QAClC,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,OAAO,aAAa,CAAC,MAAM,EAAE,CAAC;QAChC,CAAC;QACD,OAAO,KAAK,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,CAAC;IAC9B,CAAC;IACD,2BAA2B;IAC3B,OAAO;IACP,KAAK;IACL,IAAI,EAAE,CAAC,OAAkB,EAAE,EAAE,CAAC,OAAO,CAAC,MAAM,EAAE,OAAO,CAAC;IACtD,MAAM,EAAE,CAAC,OAAkB,EAAE,EAAE,CAAC,OAAO,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC1D,SAAS,EAAE,CAAC,OAAkB,EAAE,EAAE,CAAC,OAAO,CAAC,WAAW,EAAE,OAAO,CAAC;IAChE,SAAS,EAAE,CAAC,OAAkB,EAAE,EAAE,CAAC,OAAO,CAAC,WAAW,EAAE,OAAO,CAAC;IAChE,KAAK;IACL,WAAW;CACH,CAAC;AAEX;;GAEG;AACH,MAAM,CAAC,MAAM,MAAM,GAAG,YAAY,CAAC;AAEnC;;GAEG;AACH,MAAM,CAAC,MAAM,KAAK,GAAG,CAAC,GAAG,QAAyB,EAAiB,EAAE,CACnE,IAAI,CAAC,KAAK,CAAC,GAAG,QAAQ,CAAC,CAAC;AAE1B,OAAO,EAAE,KAAK,EAAE,WAAW,EAAE,CAAC"}

package/dist/dsl/strategies.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Strategy factories and component helpers for the DSL module.
+ */
+import type { MessageChildren, PromptMessageNode, PromptPart, PromptRole, PromptScope, ProviderToolIO, ScopeChildren, Strategy } from "../types";
+/**
+ * Create a scope node with optional priority, strategy, and id.
+ */
+export declare function createScope<TToolIO extends ProviderToolIO>(children: ScopeChildren<TToolIO>, opts?: {
+    priority?: number;
+    strategy?: Strategy;
+    id?: string;
+}): PromptScope<TToolIO>;
+/**
+ * Create a message node with role and children.
+ */
+export declare function createMessage<TToolIO extends ProviderToolIO>(role: PromptRole, children: MessageChildren<TToolIO>, id?: string): PromptMessageNode<TToolIO>;
+/**
+ * Create a truncate strategy that removes children from one end.
+ */
+export declare function createTruncateStrategy(budget: number, from: "start" | "end"): Strategy;
+/**
+ * Create an omit strategy that removes the entire scope.
+ */
+export declare function createOmitStrategy(): Strategy;
+/**
+ * Format examples into a text prompt part.
+ */
+export declare function formatExamples<TToolIO extends ProviderToolIO>(title: string, items: readonly string[], separator?: string): PromptPart<TToolIO>;
+//# sourceMappingURL=strategies.d.ts.map

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,51 @@
+/**
+ * Summary strategy for progressively summarizing conversation history.
+ */
+import type { KVMemory } from "../memory";
+import type { ModelProvider } from "../provider";
+import type { MaybePromise, 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;AAC1C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAEjD,OAAO,KAAK,EACV,YAAY,EACZ,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;AAIH,OAAO,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AASnC,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,22 @@ 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 developer: (content: import("..").TextInput) => import("..").PromptMessageNode<import("..").ProviderToolIO>;
+    readonly assistant: (content: import("..").TextInput) => import("..").PromptMessageNode<import("..").ProviderToolIO>;
+    readonly input: typeof import("..").input;
+    readonly inputLayout: typeof import("..").inputLayout;
 };
 //# 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;;;;;;;;;;gBAC2d,CAAC;UAAY,CAAC;;;;;;;;CAD1b,CAAC"}