@fastpaca/cria 1.3.0 → 1.5.0

package/dist/dsl/builder.js

@@ -0,0 +1,458 @@
+/**
+ * Fluent builders for constructing prompts.
+ */
+import { assertValidMessageScope, render as renderPrompt } from "../render";
+import { createMessage, createOmitStrategy, createScope, createTruncateStrategy, formatExamples, } from "./strategies";
+import { Summary } from "./summary";
+import { isPromptPart, normalizeTextInput, textPart, } from "./templating";
+import { VectorSearch } from "./vector-search";
+/**
+ * Shared fluent API for prompt-level and message-level builders.
+ */
+export class BuilderBase {
+    children;
+    context;
+    constructor(children = [], context = undefined) {
+        this.children = children;
+        this.context = context;
+    }
+    /**
+     * Merge another builder's contents into this one (zod-like merge).
+     * Contexts must be compatible (either identical or undefined).
+     */
+    merge(...builders) {
+        const sources = [this, ...builders];
+        let nextContext = this.context;
+        const totalChildren = sources.reduce((sum, builder) => sum + builder.children.length, 0);
+        const mergedChildren = new Array(totalChildren);
+        let writeIndex = 0;
+        for (const builder of sources) {
+            if (builder.context && nextContext && builder.context !== nextContext) {
+                throw new Error("Cannot merge builders with different contexts/providers");
+            }
+            if (!nextContext) {
+                nextContext = builder.context;
+            }
+            for (const child of builder.children) {
+                mergedChildren[writeIndex] = child;
+                writeIndex += 1;
+            }
+        }
+        mergedChildren.length = writeIndex;
+        return this.create(mergedChildren, nextContext);
+    }
+    addChild(child) {
+        return this.create([...this.children, child], this.context);
+    }
+    addChildren(children) {
+        return this.create([...this.children, ...children], this.context);
+    }
+}
+export class MessageBuilder extends BuilderBase {
+    constructor(children = [], context = undefined) {
+        super(children, context);
+    }
+    create(children, context) {
+        return new MessageBuilder(children, context);
+    }
+    append(content) {
+        const normalized = normalizeTextInput(content);
+        return this.addChildren(normalized);
+    }
+    /**
+     * Add vector search results as message content (async, resolved at render time).
+     */
+    vectorSearch(opts) {
+        const asyncPart = VectorSearch({
+            store: opts.store,
+            query: opts.query,
+            ...(opts.limit !== undefined ? { limit: opts.limit } : {}),
+            ...(opts.threshold !== undefined ? { threshold: opts.threshold } : {}),
+            ...(opts.formatter ? { formatResults: opts.formatter } : {}),
+        }).then((scope) => {
+            const message = scope.children[0];
+            if (!message || message.kind !== "message") {
+                throw new Error("VectorSearch did not return a message node.");
+            }
+            const part = message.children[0];
+            if (!part || part.type !== "text") {
+                throw new Error("VectorSearch did not return a text part.");
+            }
+            return part;
+        });
+        return this.addChild(asyncPart);
+    }
+    /**
+     * Add a formatted list of examples.
+     */
+    examples(title, items) {
+        const element = formatExamples(title, items);
+        return this.addChild(element);
+    }
+    async buildChildren() {
+        return await resolveMessageChildren(this.children);
+    }
+}
+/**
+ * Fluent builder for constructing prompt trees.
+ *
+ * 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 `PromptTree`.
+ */
+export class PromptBuilder extends BuilderBase {
+    boundProvider;
+    constructor(children = [], context = undefined, provider = undefined) {
+        const existingProvider = context?.provider;
+        if (provider && existingProvider && provider !== existingProvider) {
+            throw new Error("Cannot create a prompt builder with a mismatched provider.");
+        }
+        const nextContext = provider && (!context || context.provider !== provider)
+            ? { ...(context ?? {}), provider }
+            : context;
+        super(children, nextContext);
+        this.boundProvider = provider;
+    }
+    static create(provider) {
+        if (!provider) {
+            return new PromptBuilder();
+        }
+        return new PromptBuilder([], undefined, provider);
+    }
+    create(children, context) {
+        return new PromptBuilder(children, context, this.boundProvider);
+    }
+    /**
+     * Bind this prompt builder to a provider.
+     * Enables provider-specific rendering without passing a provider at render time.
+     * This also locks tool-call input/output types for the rest of the builder chain.
+     */
+    provider(modelProvider) {
+        if (this.context?.provider && this.context.provider !== modelProvider) {
+            throw new Error("Cannot bind a prompt builder to a different provider.");
+        }
+        return PromptBuilder.create(modelProvider).merge(this);
+    }
+    scope(fn, opts) {
+        if (typeof fn !== "function") {
+            throw new Error(`scope() requires a callback function. Received: ${typeof fn}`);
+        }
+        const inner = fn(this.create([], this.context));
+        const element = inner
+            .buildChildren()
+            .then((children) => createScope(children, opts?.id ? { id: opts.id } : undefined));
+        return this.addChild(element);
+    }
+    /**
+     * Add content that will be truncated when over budget.
+     */
+    truncate(content, opts) {
+        const node = resolveScopeContent(content).then((children) => createScope(children, {
+            ...(opts.priority !== undefined && { priority: opts.priority }),
+            strategy: createTruncateStrategy(opts.budget, opts.from ?? "start"),
+            ...(opts.id && { id: opts.id }),
+        }));
+        return this.addChild(node);
+    }
+    /**
+     * Add content that will be entirely removed when over budget.
+     */
+    omit(content, opts) {
+        const node = resolveScopeContent(content).then((children) => createScope(children, {
+            ...(opts?.priority !== undefined && { priority: opts.priority }),
+            strategy: createOmitStrategy(),
+            ...(opts?.id && { id: opts.id }),
+        }));
+        return this.addChild(node);
+    }
+    /**
+     * Create a provider scope for AI-powered operations like Summary.
+     *
+     * @example
+     * ```typescript
+     * import { createProvider } from "@fastpaca/cria/ai-sdk";
+     * import { openai } from "@ai-sdk/openai";
+     *
+     * const provider = createProvider(openai("gpt-4o"));
+     * cria.prompt()
+     *   .providerScope(provider, (p) =>
+     *     p.summary(content, { id: "conv", store })
+     *   )
+     * ```
+     */
+    providerScope(modelProvider, fn) {
+        const context = { provider: modelProvider };
+        if (this.context?.provider && this.context.provider !== modelProvider) {
+            throw new Error("Cannot bind a prompt builder to a different provider.");
+        }
+        const bound = this.provider(modelProvider);
+        const inner = fn(PromptBuilder.create(modelProvider));
+        const element = inner.buildChildren().then((children) => ({
+            kind: "scope",
+            priority: 0,
+            children,
+            context,
+        }));
+        return bound.addChild(element);
+    }
+    /**
+     * Add vector search results (async, resolved at render time).
+     */
+    vectorSearch(opts) {
+        const asyncElement = VectorSearch({
+            store: opts.store,
+            query: opts.query,
+            ...(opts.limit !== undefined ? { limit: opts.limit } : {}),
+            ...(opts.threshold !== undefined ? { threshold: opts.threshold } : {}),
+            ...(opts.formatter ? { formatResults: opts.formatter } : {}),
+            ...(opts.priority !== undefined ? { priority: opts.priority } : {}),
+            ...(opts.id !== undefined ? { id: opts.id } : {}),
+        });
+        return this.addChild(asyncElement);
+    }
+    /**
+     * Add content that will be summarized when over budget.
+     */
+    summary(content, opts) {
+        const element = resolveScopeContent(content).then((children) => Summary({
+            id: opts.id,
+            store: opts.store,
+            children,
+            ...(opts.summarize ? { summarize: opts.summarize } : {}),
+            ...(opts.priority !== undefined ? { priority: opts.priority } : {}),
+        }));
+        return this.addChild(element);
+    }
+    /**
+     * Add a raw PromptNode (escape hatch for advanced usage).
+     */
+    raw(element) {
+        return this.addChild(element);
+    }
+    /**
+     * Merge builders or raw nodes into this one.
+     * Accepts PromptBuilders, individual PromptNodes, or arrays of PromptNodes.
+     *
+     * @example
+     * ```typescript
+     * // Merge builders
+     * cria.prompt().system("A").merge(otherBuilder)
+     *
+     * // Merge raw nodes
+     * cria.prompt().system("A").merge(...scope.children)
+     * ```
+     */
+    merge(...items) {
+        const newChildren = [...this.children];
+        let nextContext = this.context;
+        for (const item of items) {
+            nextContext = this.mergeItem(item, newChildren, nextContext);
+        }
+        return this.create(newChildren, nextContext);
+    }
+    mergeItem(item, target, currentContext) {
+        if (item instanceof PromptBuilder) {
+            if (item.context && currentContext && item.context !== currentContext) {
+                throw new Error("Cannot merge builders with different contexts/providers");
+            }
+            target.push(...item.children);
+            return item.context ?? currentContext;
+        }
+        if (Array.isArray(item)) {
+            for (const node of item) {
+                target.push(node);
+            }
+            return currentContext;
+        }
+        if (isPromptNode(item)) {
+            target.push(item);
+        }
+        return currentContext;
+    }
+    /**
+     * Conditionally apply a transformation to the builder.
+     *
+     * @example
+     * ```typescript
+     * cria.prompt()
+     *   .system("Hello")
+     *   .when(hasContext, (p) => p.user("Context: ..."))
+     *   .user("Question")
+     * ```
+     */
+    when(condition, fn) {
+        return condition ? fn(this) : this;
+    }
+    /**
+     * Add a system message.
+     */
+    system(content, opts) {
+        return this.addMessage("system", content, opts);
+    }
+    /**
+     * Add a user message.
+     */
+    user(content, opts) {
+        return this.addMessage("user", content, opts);
+    }
+    /**
+     * Add an assistant message.
+     */
+    assistant(content, opts) {
+        return this.addMessage("assistant", content, opts);
+    }
+    /**
+     * Add a tool result message.
+     */
+    tool(result, opts) {
+        if (!this.boundProvider) {
+            throw new Error("Tool results require a bound provider. Bind one with cria.prompt(provider) or cria.prompt().provider(provider).");
+        }
+        const children = Array.isArray(result) ? [...result] : [result];
+        const element = createMessage("tool", children, opts?.id);
+        return this.addChild(element);
+    }
+    /**
+     * Add a message with a custom role.
+     */
+    message(role, content, opts) {
+        return this.addMessage(role, content, opts);
+    }
+    async buildChildren() {
+        return await resolveScopeChildren(this.children);
+    }
+    /**
+     * Build the final PromptTree.
+     */
+    async build() {
+        const element = {
+            kind: "scope",
+            priority: 0,
+            children: await this.buildChildren(),
+            ...(this.context && { context: this.context }),
+        };
+        // Enforce message boundaries at build time so invalid trees fail early.
+        assertValidMessageScope(element);
+        return element;
+    }
+    async render(options) {
+        const element = await this.build();
+        const providerOverride = options?.provider;
+        if (providerOverride) {
+            return await renderPrompt(element, {
+                ...(options ?? {}),
+                provider: providerOverride,
+            });
+        }
+        if (!this.boundProvider) {
+            throw new Error("Rendering requires a provider. Bind one with cria.prompt(provider) or cria.prompt().provider(provider), or pass a provider to render().");
+        }
+        return await renderPrompt(element, {
+            ...(options ?? {}),
+            provider: this.boundProvider,
+        });
+    }
+    addMessage(role, content, opts) {
+        // Normalize text-like inputs into typed parts so tool IO stays provider-bound.
+        const childrenPromise = typeof content === "function"
+            ? content(new MessageBuilder([], this.context)).buildChildren()
+            : Promise.resolve(normalizeTextInput(content));
+        const element = childrenPromise.then((children) => createMessage(role, children, opts?.id));
+        return this.addChild(element);
+    }
+}
+// Resolution functions (colocated with builders).
+// They resolve async children and enforce message/scope boundaries early.
+// This avoids deferred checks and ensures type safety at build time.
+function isPromptNode(value) {
+    return typeof value === "object" && value !== null && "kind" in value;
+}
+async function resolveMessageChildren(children) {
+    const list = Array.isArray(children) ? children : [children];
+    const resolved = await Promise.all(list.map((child) => resolveBuilderChild(child, "message")));
+    return resolved.flat();
+}
+async function resolveScopeChildren(children) {
+    const list = Array.isArray(children) ? children : [children];
+    const resolved = await Promise.all(list.map((child) => resolveBuilderChild(child, "scope")));
+    return resolved.flat();
+}
+async function resolveScopeContent(content) {
+    if (content instanceof PromptBuilder) {
+        const built = await content.build();
+        const nodes = [];
+        // Extract children so strategies operate on individual items, not a wrapper scope
+        for (const child of built.children) {
+            if (!isPromptNode(child)) {
+                throw new Error("Scope content must be prompt nodes.");
+            }
+            nodes.push(child);
+        }
+        return nodes;
+    }
+    if (content instanceof Promise) {
+        const value = await content;
+        return await resolveScopeContent(value);
+    }
+    if (Array.isArray(content)) {
+        const resolved = await Promise.all(content.map((item) => resolveScopeContent(item)));
+        return resolved.flat();
+    }
+    if (isPromptNode(content)) {
+        return [content];
+    }
+    throw new Error("Scope content must be prompt nodes or prompt builders.");
+}
+async function resolveBuilderChild(child, target) {
+    const resolved = await resolveBuilderChildPromise(child);
+    if (target === "message") {
+        return resolveMessageChild(resolved);
+    }
+    return await resolveScopeChild(resolved);
+}
+async function resolveBuilderChildPromise(child) {
+    if (child instanceof Promise) {
+        return await child;
+    }
+    return child;
+}
+function resolveMessageChild(child) {
+    if (child instanceof PromptBuilder) {
+        throw new Error("Prompt builders cannot be nested inside messages.");
+    }
+    if (typeof child === "string") {
+        return [textPart(child)];
+    }
+    if (typeof child === "number" || typeof child === "boolean") {
+        return [textPart(String(child))];
+    }
+    if (isPromptPart(child)) {
+        return [child];
+    }
+    if (isPromptNode(child)) {
+        throw new Error("Prompt nodes are not allowed inside messages.");
+    }
+    throw new Error("Unsupported child type.");
+}
+async function resolveScopeChild(child) {
+    if (child instanceof PromptBuilder) {
+        const built = await child.build();
+        if (!isPromptNode(built)) {
+            throw new Error("Scope content must be prompt nodes.");
+        }
+        return [built];
+    }
+    if (typeof child === "string" ||
+        typeof child === "number" ||
+        typeof child === "boolean") {
+        throw new Error("Text nodes are only allowed inside messages.");
+    }
+    if (isPromptPart(child)) {
+        throw new Error("Message parts are only allowed inside messages.");
+    }
+    if (isPromptNode(child)) {
+        return [child];
+    }
+    throw new Error("Unsupported child type.");
+}
+//# sourceMappingURL=builder.js.map

package/dist/dsl/builder.js.map

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

package/dist/dsl/index.d.ts

@@ -0,0 +1,71 @@
+/**
+ * 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
+ */
+export type { BuilderChild, Prompt, ScopeContent, } from "./builder";
+export { BuilderBase, MessageBuilder, PromptBuilder, } from "./builder";
+export type { StoredSummary, Summarizer, SummarizerContext, } from "./summary";
+export { c, type TextInput } from "./templating";
+export type { ResultFormatter } from "./vector-search";
+import type { ModelProvider, PromptMessageNode, PromptRole, PromptScope, ProviderToolIO, ScopeChildren } from "../types";
+import { PromptBuilder } from "./builder";
+import { type TextInput, c as templateC } from "./templating";
+/** Create a standalone message node */
+declare function message<TToolIO extends ProviderToolIO>(role: PromptRole, content: TextInput<TToolIO>): PromptMessageNode<TToolIO>;
+/** Create a standalone scope node */
+declare function scope<TToolIO extends ProviderToolIO>(children: ScopeChildren<TToolIO>, opts?: {
+    priority?: number;
+    id?: string;
+}): PromptScope<TToolIO>;
+declare function createPrompt(): PromptBuilder<unknown>;
+declare function createPrompt<TProvider extends ModelProvider<unknown, ProviderToolIO>>(provider: TProvider): PromptBuilder<TProvider>;
+/**
+ * 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 declare const cria: {
+    readonly prompt: typeof createPrompt;
+    readonly c: typeof templateC;
+    readonly merge: (...builders: PromptBuilder[]) => PromptBuilder<unknown>;
+    readonly message: typeof message;
+    readonly scope: typeof scope;
+    readonly user: (content: TextInput) => PromptMessageNode<ProviderToolIO>;
+    readonly system: (content: TextInput) => PromptMessageNode<ProviderToolIO>;
+    readonly assistant: (content: TextInput) => PromptMessageNode<ProviderToolIO>;
+};
+/**
+ * Standalone function to create a new prompt builder.
+ */
+export declare const prompt: typeof createPrompt;
+/**
+ * Merge multiple builders into one (zod-like merge).
+ */
+export declare const merge: (...builders: PromptBuilder[]) => PromptBuilder;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/dsl/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAGH,YAAY,EACV,YAAY,EACZ,MAAM,EACN,YAAY,GACb,MAAM,WAAW,CAAC;AAEnB,OAAO,EACL,WAAW,EACX,cAAc,EACd,aAAa,GACd,MAAM,WAAW,CAAC;AAEnB,YAAY,EACV,aAAa,EACb,UAAU,EACV,iBAAiB,GAClB,MAAM,WAAW,CAAC;AACnB,OAAO,EAAE,CAAC,EAAE,KAAK,SAAS,EAAE,MAAM,cAAc,CAAC;AAGjD,YAAY,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAEvD,OAAO,KAAK,EACV,aAAa,EACb,iBAAiB,EACjB,UAAU,EACV,WAAW,EACX,cAAc,EACd,aAAa,EACd,MAAM,UAAU,CAAC;AAClB,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAG1C,OAAO,EAEL,KAAK,SAAS,EACd,CAAC,IAAI,SAAS,EACf,MAAM,cAAc,CAAC;AAEtB,uCAAuC;AACvC,iBAAS,OAAO,CAAC,OAAO,SAAS,cAAc,EAC7C,IAAI,EAAE,UAAU,EAChB,OAAO,EAAE,SAAS,CAAC,OAAO,CAAC,GAC1B,iBAAiB,CAAC,OAAO,CAAC,CAE5B;AAED,qCAAqC;AACrC,iBAAS,KAAK,CAAC,OAAO,SAAS,cAAc,EAC3C,QAAQ,EAAE,aAAa,CAAC,OAAO,CAAC,EAChC,IAAI,CAAC,EAAE;IAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,EAAE,CAAC,EAAE,MAAM,CAAA;CAAE,GACxC,WAAW,CAAC,OAAO,CAAC,CAEtB;AAED,iBAAS,YAAY,IAAI,aAAa,CAAC,OAAO,CAAC,CAAC;AAChD,iBAAS,YAAY,CAAC,SAAS,SAAS,aAAa,CAAC,OAAO,EAAE,cAAc,CAAC,EAC5E,QAAQ,EAAE,SAAS,GAClB,aAAa,CAAC,SAAS,CAAC,CAAC;AAQ5B;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,IAAI;;;kCAGM,aAAa,EAAE;;;6BAUpB,SAAS;+BACP,SAAS;kCACN,SAAS;CACtB,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,MAAM,qBAAe,CAAC;AAEnC;;GAEG;AACH,eAAO,MAAM,KAAK,GAAI,GAAG,UAAU,aAAa,EAAE,KAAG,aAC5B,CAAC"}

package/dist/dsl/index.js

@@ -0,0 +1,82 @@
+/**
+ * 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 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),
+    assistant: (content) => message("assistant", content),
+};
+/**
+ * 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);
+//# 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;AAajD,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;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;CACxD,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"}

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