@fastpaca/cria 1.6.0 → 1.7.0

package/dist/dsl/index.d.ts

@@ -18,7 +18,6 @@ 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 { InputLayout, ModelProvider, PromptInput } from "../provider";
 import type { PromptLayout, PromptMessageNode, PromptRole, PromptScope, ProviderToolIO, ScopeChildren } from "../types";
 import { PromptBuilder } from "./builder";
@@ -32,8 +31,8 @@ declare function scope<TToolIO extends ProviderToolIO>(children: ScopeChildren<T
 }): PromptScope<TToolIO>;
 declare function input<TRendered>(value: TRendered): PromptInput<TRendered>;
 declare function inputLayout<TToolIO extends ProviderToolIO>(value: PromptLayout<TToolIO>): InputLayout<TToolIO>;
-declare function createPrompt(): PromptBuilder<unknown>;
-declare function createPrompt<TProvider extends ModelProvider<unknown, ProviderToolIO>>(provider: TProvider): PromptBuilder<TProvider>;
+declare function createPrompt(): PromptBuilder<unknown, "unpinned">;
+declare function createPrompt<TProvider extends ModelProvider<unknown, ProviderToolIO>>(provider: TProvider): PromptBuilder<TProvider, "unpinned">;
 /**
  * Namespace for building prompts as code.
  *
@@ -56,7 +55,7 @@ declare function createPrompt<TProvider extends ModelProvider<unknown, ProviderT
 export declare const cria: {
     readonly prompt: typeof createPrompt;
     readonly c: typeof templateC;
-    readonly merge: (...builders: PromptBuilder[]) => PromptBuilder<unknown>;
+    readonly merge: (...builders: PromptBuilder<unknown, "unpinned" | "pinned">[]) => PromptBuilder<unknown, "unpinned">;
     readonly message: typeof message;
     readonly scope: typeof scope;
     readonly user: (content: TextInput) => PromptMessageNode<ProviderToolIO>;
@@ -73,6 +72,6 @@ export declare const prompt: typeof createPrompt;
 /**
  * Merge multiple builders into one (zod-like merge).
  */
-export declare const merge: (...builders: PromptBuilder[]) => PromptBuilder;
+export declare const merge: (...builders: PromptBuilder<unknown, "unpinned" | "pinned">[]) => PromptBuilder<unknown, "unpinned" | "pinned">;
 export { input, inputLayout };
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +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,EAAE,WAAW,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC3E,OAAO,KAAK,EACV,YAAY,EACZ,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,KAAK,CAAC,SAAS,EAAE,KAAK,EAAE,SAAS,GAAG,WAAW,CAAC,SAAS,CAAC,CAElE;AAED,iBAAS,WAAW,CAAC,OAAO,SAAS,cAAc,EACjD,KAAK,EAAE,YAAY,CAAC,OAAO,CAAC,GAC3B,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;kCACT,SAAS;;;CAGtB,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,MAAM,qBAAe,CAAC;AAEnC;;GAEG;AACH,eAAO,MAAM,KAAK,GAAI,GAAG,UAAU,aAAa,EAAE,KAAG,aAC5B,CAAC;AAE1B,OAAO,EAAE,KAAK,EAAE,WAAW,EAAE,CAAC"}
+{"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;AAEjD,OAAO,KAAK,EAAE,WAAW,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC3E,OAAO,KAAK,EACV,YAAY,EACZ,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,KAAK,CAAC,SAAS,EAAE,KAAK,EAAE,SAAS,GAAG,WAAW,CAAC,SAAS,CAAC,CAElE;AAED,iBAAS,WAAW,CAAC,OAAO,SAAS,cAAc,EACjD,KAAK,EAAE,YAAY,CAAC,OAAO,CAAC,GAC3B,WAAW,CAAC,OAAO,CAAC,CAEtB;AAED,iBAAS,YAAY,IAAI,aAAa,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC;AAC5D,iBAAS,YAAY,CAAC,SAAS,SAAS,aAAa,CAAC,OAAO,EAAE,cAAc,CAAC,EAC5E,QAAQ,EAAE,SAAS,GAClB,aAAa,CAAC,SAAS,EAAE,UAAU,CAAC,CAAC;AAQxC;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,IAAI;;;kCAGM,aAAa,CAAC,OAAO,EAAE,UAAU,GAAG,QAAQ,CAAC,EAAE;;;6BAUpD,SAAS;+BACP,SAAS;kCACN,SAAS;kCACT,SAAS;;;CAGtB,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,MAAM,qBAAe,CAAC;AAEnC;;GAEG;AACH,eAAO,MAAM,KAAK,GAChB,GAAG,UAAU,aAAa,CAAC,OAAO,EAAE,UAAU,GAAG,QAAQ,CAAC,EAAE,KAC3D,aAAa,CAAC,OAAO,EAAE,UAAU,GAAG,QAAQ,CAA4B,CAAC;AAE5E,OAAO,EAAE,KAAK,EAAE,WAAW,EAAE,CAAC"}

package/dist/dsl/index.js.map

@@ -1 +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"}
+{"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;AAWjD,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,QAAyD,EAAE,EAAE;QACtE,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,CACnB,GAAG,QAAyD,EACb,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,QAAQ,CAAC,CAAC;AAE5E,OAAO,EAAE,KAAK,EAAE,WAAW,EAAE,CAAC"}

package/dist/dsl/strategies.d.ts

@@ -1,7 +1,7 @@
 /**
  * Strategy factories and component helpers for the DSL module.
  */
-import type { MessageChildren, PromptMessageNode, PromptPart, PromptRole, PromptScope, ProviderToolIO, ScopeChildren, Strategy } from "../types";
+import type { CacheHint, MessageChildren, PromptMessageNode, PromptPart, PromptRole, PromptScope, ProviderToolIO, ScopeChildren, Strategy } from "../types";
 /**
  * Create a scope node with optional priority, strategy, and id.
  */
@@ -9,6 +9,7 @@ export declare function createScope<TToolIO extends ProviderToolIO>(children: Sc
     priority?: number;
     strategy?: Strategy;
     id?: string;
+    cache?: CacheHint;
 }): PromptScope<TToolIO>;
 /**
  * Create a message node with role and children.

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

@@ -1 +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"}
+{"version":3,"file":"strategies.d.ts","sourceRoot":"","sources":["../../src/dsl/strategies.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EACV,SAAS,EACT,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;IACL,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,KAAK,CAAC,EAAE,SAAS,CAAC;CACnB,GACA,WAAW,CAAC,OAAO,CAAC,CAUtB;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,CAmBV;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

@@ -12,6 +12,7 @@ export function createScope(children, opts) {
         children,
         ...(opts?.strategy && { strategy: opts.strategy }),
         ...(opts?.id && { id: opts.id }),
+        ...(opts?.cache && { cache: opts.cache }),
     };
 }
 /**
@@ -31,14 +32,14 @@ export function createMessage(role, children, id) {
  */
 export function createTruncateStrategy(budget, from) {
     return (input) => {
-        const { children: currentChildren } = input.target;
-        if (currentChildren.length === 0) {
+        const { children } = input.target;
+        if (children.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));
+            ? children.slice(dropCount)
+            : children.slice(0, Math.max(0, children.length - dropCount));
         if (nextChildren.length === 0) {
             return null;
         }

package/dist/dsl/strategies.js.map

@@ -1 +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"}
+{"version":3,"file":"strategies.js","sourceRoot":"","sources":["../../src/dsl/strategies.ts"],"names":[],"mappings":"AAAA;;GAEG;AAcH;;GAEG;AACH,MAAM,UAAU,WAAW,CACzB,QAAgC,EAChC,IAKC;IAED,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;QAChC,GAAG,CAAC,IAAI,EAAE,KAAK,IAAI,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,CAAC;KAC1C,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,GAAG,KAAK,CAAC,MAAM,CAAC;QAClC,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC1B,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,QAAQ,CAAC,KAAK,CAAC,SAAS,CAAC;YAC3B,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,QAAQ,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC,CAAC;QAElE,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/vector-search.d.ts

@@ -1,52 +1,19 @@
 /**
  * VectorSearch async component for RAG-style retrieval.
  */
-import type { VectorMemory, VectorSearchResult } from "../memory";
-import type { PromptPart, PromptRole, PromptScope, ProviderToolIO } 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: Message[]) => string | null | undefined;
-interface VectorSearchProps<T = unknown, TToolIO extends ProviderToolIO = ProviderToolIO> {
+import type { VectorMemory } from "../memory";
+import type { PromptScope, ProviderToolIO } from "../types";
+interface VectorSearchProps<T = unknown> {
     /** Vector memory store to search */
     store: VectorMemory<T>;
-    /**
-     * Query string. If omitted, the component will try to derive the query from
-     * children, then from `messages` (defaulting to the last user message).
-     */
-    query?: string | undefined;
-    /**
-     * Optional messages to derive a query from (uses last user message by default).
-     */
-    messages?: Message[];
-    /** Custom query extractor (overrides the default last-user-message behavior). */
-    extractQuery?: QueryExtractor;
-    /** Maximum number of results to return. Default: 5 */
-    limit?: number;
-    /** Minimum similarity threshold (0-1). Results below this are excluded. */
-    threshold?: number;
-    /** Custom formatter for search results. Default: numbered list format */
-    formatResults?: ResultFormatter<T>;
-    /** Priority for this 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?: readonly PromptPart<TToolIO>[];
+    /** Query string */
+    query: string;
+    /** Maximum number of results to return */
+    limit: number;
 }
 /**
  * Renders vector search results into a scoped message.
  */
-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 declare function VectorSearch<T = unknown, TToolIO extends ProviderToolIO = ProviderToolIO>({ store, query, limit, }: VectorSearchProps<T>): Promise<PromptScope<TToolIO>>;
 export {};
 //# sourceMappingURL=vector-search.d.ts.map

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

@@ -1 +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"}
+{"version":3,"file":"vector-search.d.ts","sourceRoot":"","sources":["../../src/dsl/vector-search.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAsB,MAAM,WAAW,CAAC;AAClE,OAAO,KAAK,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAwB5D,UAAU,iBAAiB,CAAC,CAAC,GAAG,OAAO;IACrC,oCAAoC;IACpC,KAAK,EAAE,YAAY,CAAC,CAAC,CAAC,CAAC;IACvB,mBAAmB;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,0CAA0C;IAC1C,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,wBAAsB,YAAY,CAChC,CAAC,GAAG,OAAO,EACX,OAAO,SAAS,cAAc,GAAG,cAAc,EAC/C,EACA,KAAK,EACL,KAAK,EACL,KAAK,GACN,EAAE,iBAAiB,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC,CAWtD"}

package/dist/dsl/vector-search.js

@@ -1,7 +1,8 @@
 /**
  * VectorSearch async component for RAG-style retrieval.
  */
-import { PromptBuilder } from "./builder";
+import { createMessage, createScope } from "./strategies";
+import { textPart } from "./templating";
 /**
  * Default formatter that renders results as a numbered list.
  * Returns a placeholder string when no results are found so prompts can degrade gracefully.
@@ -19,70 +20,17 @@ function defaultFormatter(results) {
     })
         .join("\n\n");
 }
-function queryFromChildren(children) {
-    if (!children || children.length === 0) {
-        return null;
-    }
-    let buffer = "";
-    for (const child of children) {
-        if (child.type !== "text") {
-            throw new Error("VectorSearch children must be text parts. Use a formatter to build complex queries.");
-        }
-        buffer += child.text;
-    }
-    const trimmed = buffer.trim();
-    return trimmed === "" ? null : trimmed;
-}
-function defaultExtractQuery(messages) {
-    const lastUser = [...messages].reverse().find((m) => m.role === "user");
-    const content = lastUser?.content.trim() ?? "";
-    return content === "" ? null : content;
-}
-function deriveQuery(props) {
-    const childQuery = queryFromChildren(props.children);
-    if (childQuery) {
-        return childQuery;
-    }
-    const directQuery = props.query?.trim();
-    if (directQuery) {
-        return directQuery;
-    }
-    if (props.messages && props.messages.length > 0) {
-        const extracted = props.extractQuery
-            ? props.extractQuery(props.messages)
-            : defaultExtractQuery(props.messages);
-        const trimmed = extracted?.trim() ?? "";
-        if (trimmed) {
-            return trimmed;
-        }
-    }
-    return null;
-}
 /**
  * Renders vector search results into a scoped message.
  */
-export async function VectorSearch({ store, query, messages, extractQuery, limit = 5, threshold, formatResults = defaultFormatter, priority = 0, id, role = "user", children, }) {
-    const finalQuery = deriveQuery({
-        query,
-        messages,
-        extractQuery,
-        children,
-    });
-    if (!finalQuery) {
-        throw new Error("VectorSearch: no query provided. Pass a query via children, the query prop, or messages.");
+export async function VectorSearch({ store, query, limit, }) {
+    const finalQuery = query.trim();
+    if (finalQuery.length === 0) {
+        throw new Error("VectorSearch: query must be a non-empty string.");
     }
-    const searchOptions = {
-        limit,
-        ...(threshold !== undefined && { threshold }),
-    };
-    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,
-        ...(id && { id }),
-    };
+    const results = await store.search(finalQuery, { limit });
+    const content = defaultFormatter(results);
+    const message = createMessage("user", [textPart(content)]);
+    return createScope([message]);
 }
 //# sourceMappingURL=vector-search.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"vector-search.js","sourceRoot":"","sources":["../../src/dsl/vector-search.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"vector-search.js","sourceRoot":"","sources":["../../src/dsl/vector-search.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAC1D,OAAO,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAExC;;;GAGG;AACH,SAAS,gBAAgB,CAAI,OAAgC;IAC3D,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,oCAAoC,CAAC;IAC9C,CAAC;IAED,OAAO,OAAO;SACX,GAAG,CAAC,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE;QACrB,MAAM,IAAI,GACR,OAAO,MAAM,CAAC,KAAK,CAAC,IAAI,KAAK,QAAQ;YACnC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI;YACnB,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;QACjD,OAAO,IAAI,KAAK,GAAG,CAAC,aAAa,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,IAAI,EAAE,CAAC;IACvE,CAAC,CAAC;SACD,IAAI,CAAC,MAAM,CAAC,CAAC;AAClB,CAAC;AAWD;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAGhC,EACA,KAAK,EACL,KAAK,EACL,KAAK,GACgB;IACrB,MAAM,UAAU,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;IAChC,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC5B,MAAM,IAAI,KAAK,CAAC,iDAAiD,CAAC,CAAC;IACrE,CAAC;IAED,MAAM,OAAO,GAAG,MAAM,KAAK,CAAC,MAAM,CAAC,UAAU,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;IAC1D,MAAM,OAAO,GAAG,gBAAgB,CAAC,OAAO,CAAC,CAAC;IAE1C,MAAM,OAAO,GAAG,aAAa,CAAU,MAAM,EAAE,CAAC,QAAQ,CAAU,OAAO,CAAC,CAAC,CAAC,CAAC;IAC7E,OAAO,WAAW,CAAU,CAAC,OAAO,CAAC,CAAC,CAAC;AACzC,CAAC"}

package/dist/eval/index.d.ts

@@ -32,11 +32,11 @@ export { createJudge } from "./judge";
 export declare const cria: {
     readonly judge: typeof createJudge;
     readonly prompt: {
-        (): import("..").PromptBuilder<unknown>;
-        <TProvider extends import("..").ModelProvider<unknown, import("..").ProviderToolIO>>(provider: TProvider): import("..").PromptBuilder<TProvider>;
+        (): import("..").PromptBuilder<unknown, "unpinned">;
+        <TProvider extends import("..").ModelProvider<unknown, import("..").ProviderToolIO>>(provider: TProvider): import("..").PromptBuilder<TProvider, "unpinned">;
     };
     readonly c: typeof import("..").c;
-    readonly merge: (...builders: import("..").PromptBuilder[]) => import("..").PromptBuilder<unknown>;
+    readonly merge: (...builders: import("..").PromptBuilder<unknown, "unpinned" | "pinned">[]) => import("..").PromptBuilder<unknown, "unpinned">;
     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;

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;;;;;;;;;;gBAC2d,CAAC;UAAY,CAAC;;;;;;;;CAD1b,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;;;;;;;;;;gBACiY,CAAC;UAAY,CAAC;;;;;;;;CADhW,CAAC"}

package/dist/index.d.ts

@@ -15,7 +15,7 @@
  *
  * @packageDocumentation
  */
-export type { BuilderChild, Prompt, ResultFormatter, ScopeContent, StoredSummary, Summarizer, SummarizerContext, TextInput, } from "./dsl";
+export type { BuilderChild, Prompt, ScopeContent, StoredSummary, Summarizer, SummarizerContext, TextInput, } from "./dsl";
 export { BuilderBase, c, cria, input, inputLayout, MessageBuilder, merge, PromptBuilder, prompt, } from "./dsl";
 export { createOtelRenderHooks } from "./instrumentation/otel";
 export type { KVMemory, MemoryEntry, VectorMemory, VectorSearchOptions, VectorSearchResult, } from "./memory";
@@ -27,6 +27,6 @@ export { ResponsesProtocol } from "./protocols/responses";
 export { CompositeCodec, type InputLayout, ListMessageCodec, MessageCodec, ModelProvider, type PromptInput, ProtocolProvider, type ProviderAdapter, } from "./provider";
 export type { FitCompleteEvent, FitErrorEvent, FitIterationEvent, FitStartEvent, RenderHooks, RenderOptions, StrategyAppliedEvent, } from "./render";
 export { render } from "./render";
-export type { CriaContext, MaybePromise, MessageChildren, PromptLayout, PromptMessage, PromptMessageNode, PromptNode, PromptPart, PromptRole, PromptScope, PromptTree, ProviderToolIO, ReasoningPart, ScopeChildren, Strategy, StrategyInput, StrategyResult, TextPart, ToolCallPart, ToolIOForProvider, ToolResultPart, } from "./types";
+export type { CacheDescriptor, CacheHint, CriaContext, MaybePromise, MessageChildren, PromptLayout, PromptMessage, PromptMessageNode, PromptNode, PromptPart, PromptRole, PromptScope, PromptTree, ProviderToolIO, ReasoningPart, ScopeChildren, Strategy, StrategyInput, StrategyResult, TextPart, ToolCallPart, ToolIOForProvider, ToolResultPart, } from "./types";
 export { FitError } from "./types";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAGH,YAAY,EACV,YAAY,EACZ,MAAM,EACN,eAAe,EACf,YAAY,EACZ,aAAa,EACb,UAAU,EACV,iBAAiB,EACjB,SAAS,GACV,MAAM,OAAO,CAAC;AACf,OAAO,EACL,WAAW,EACX,CAAC,EACD,IAAI,EACJ,KAAK,EACL,WAAW,EACX,cAAc,EACd,KAAK,EACL,aAAa,EACb,MAAM,GACP,MAAM,OAAO,CAAC;AACf,OAAO,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AAC/D,YAAY,EACV,QAAQ,EACR,WAAW,EACX,YAAY,EACZ,mBAAmB,EACnB,kBAAkB,GACnB,MAAM,UAAU,CAAC;AAElB,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,YAAY,EACV,oBAAoB,EACpB,WAAW,EACX,QAAQ,GACT,MAAM,8BAA8B,CAAC;AACtC,OAAO,EAAE,uBAAuB,EAAE,MAAM,8BAA8B,CAAC;AACvE,YAAY,EACV,oBAAoB,EACpB,yBAAyB,EACzB,+BAA+B,EAC/B,cAAc,EACd,aAAa,EACb,oBAAoB,EACpB,sBAAsB,EACtB,aAAa,EACb,eAAe,GAChB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC1D,OAAO,EACL,cAAc,EACd,KAAK,WAAW,EAChB,gBAAgB,EAChB,YAAY,EACZ,aAAa,EACb,KAAK,WAAW,EAChB,gBAAgB,EAChB,KAAK,eAAe,GACrB,MAAM,YAAY,CAAC;AACpB,YAAY,EACV,gBAAgB,EAChB,aAAa,EACb,iBAAiB,EACjB,aAAa,EACb,WAAW,EACX,aAAa,EACb,oBAAoB,GACrB,MAAM,UAAU,CAAC;AAClB,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAClC,YAAY,EACV,WAAW,EACX,YAAY,EACZ,eAAe,EACf,YAAY,EACZ,aAAa,EACb,iBAAiB,EACjB,UAAU,EACV,UAAU,EACV,UAAU,EACV,WAAW,EACX,UAAU,EACV,cAAc,EACd,aAAa,EACb,aAAa,EACb,QAAQ,EACR,aAAa,EACb,cAAc,EACd,QAAQ,EACR,YAAY,EACZ,iBAAiB,EACjB,cAAc,GACf,MAAM,SAAS,CAAC;AACjB,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAGH,YAAY,EACV,YAAY,EACZ,MAAM,EACN,YAAY,EACZ,aAAa,EACb,UAAU,EACV,iBAAiB,EACjB,SAAS,GACV,MAAM,OAAO,CAAC;AACf,OAAO,EACL,WAAW,EACX,CAAC,EACD,IAAI,EACJ,KAAK,EACL,WAAW,EACX,cAAc,EACd,KAAK,EACL,aAAa,EACb,MAAM,GACP,MAAM,OAAO,CAAC;AACf,OAAO,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AAC/D,YAAY,EACV,QAAQ,EACR,WAAW,EACX,YAAY,EACZ,mBAAmB,EACnB,kBAAkB,GACnB,MAAM,UAAU,CAAC;AAElB,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,YAAY,EACV,oBAAoB,EACpB,WAAW,EACX,QAAQ,GACT,MAAM,8BAA8B,CAAC;AACtC,OAAO,EAAE,uBAAuB,EAAE,MAAM,8BAA8B,CAAC;AACvE,YAAY,EACV,oBAAoB,EACpB,yBAAyB,EACzB,+BAA+B,EAC/B,cAAc,EACd,aAAa,EACb,oBAAoB,EACpB,sBAAsB,EACtB,aAAa,EACb,eAAe,GAChB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC1D,OAAO,EACL,cAAc,EACd,KAAK,WAAW,EAChB,gBAAgB,EAChB,YAAY,EACZ,aAAa,EACb,KAAK,WAAW,EAChB,gBAAgB,EAChB,KAAK,eAAe,GACrB,MAAM,YAAY,CAAC;AACpB,YAAY,EACV,gBAAgB,EAChB,aAAa,EACb,iBAAiB,EACjB,aAAa,EACb,WAAW,EACX,aAAa,EACb,oBAAoB,GACrB,MAAM,UAAU,CAAC;AAClB,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAClC,YAAY,EACV,eAAe,EACf,SAAS,EACT,WAAW,EACX,YAAY,EACZ,eAAe,EACf,YAAY,EACZ,aAAa,EACb,iBAAiB,EACjB,UAAU,EACV,UAAU,EACV,UAAU,EACV,WAAW,EACX,UAAU,EACV,cAAc,EACd,aAAa,EACb,aAAa,EACb,QAAQ,EACR,aAAa,EACb,cAAc,EACd,QAAQ,EACR,YAAY,EACZ,iBAAiB,EACjB,cAAc,GACf,MAAM,SAAS,CAAC;AACjB,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC"}

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAaH,OAAO,EACL,WAAW,EACX,CAAC,EACD,IAAI,EACJ,KAAK,EACL,WAAW,EACX,cAAc,EACd,KAAK,EACL,aAAa,EACb,MAAM,GACP,MAAM,OAAO,CAAC;AACf,OAAO,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AAQ/D,aAAa;AACb,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAMzC,OAAO,EAAE,uBAAuB,EAAE,MAAM,8BAA8B,CAAC;AAYvE,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC1D,OAAO,EACL,cAAc,EAEd,gBAAgB,EAChB,YAAY,EACZ,aAAa,EAEb,gBAAgB,GAEjB,MAAM,YAAY,CAAC;AAUpB,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAwBlC,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAYH,OAAO,EACL,WAAW,EACX,CAAC,EACD,IAAI,EACJ,KAAK,EACL,WAAW,EACX,cAAc,EACd,KAAK,EACL,aAAa,EACb,MAAM,GACP,MAAM,OAAO,CAAC;AACf,OAAO,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AAQ/D,aAAa;AACb,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAMzC,OAAO,EAAE,uBAAuB,EAAE,MAAM,8BAA8B,CAAC;AAYvE,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC1D,OAAO,EACL,cAAc,EAEd,gBAAgB,EAChB,YAAY,EACZ,aAAa,EAEb,gBAAgB,GAEjB,MAAM,YAAY,CAAC;AAUpB,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AA0BlC,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC"}

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

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

package/dist/instrumentation/otel.js

@@ -10,9 +10,6 @@ export function createOtelRenderHooks({ tracer, spanName = "cria.fit", attribute
     let fitSpan = null;
     const startChildSpan = (name, attrs) => {
         const span = tracer.startSpan(name, undefined, context.active());
-        if (fitSpan) {
-            span.setAttribute("cria.fit.trace_id", fitSpan.spanContext().traceId);
-        }
         setAttributes(span, { ...attributes, ...attrs });
         return span;
     };
@@ -25,6 +22,7 @@ export function createOtelRenderHooks({ tracer, spanName = "cria.fit", attribute
                 "cria.total_tokens": event.totalTokens,
             });
             setElementAttributes(fitSpan, event.element);
+            emitPromptStructureSpans(tracer, context.active(), `${spanName}.prompt.message`, attributes, event.element, "before");
         },
         onFitIteration: (event) => {
             const span = startChildSpan(`${spanName}.iteration`, {
@@ -51,23 +49,33 @@ export function createOtelRenderHooks({ tracer, spanName = "cria.fit", attribute
                 "cria.iterations": event.iterations,
                 "cria.total_tokens": event.totalTokens,
             });
+            if (event.result) {
+                emitPromptStructureSpans(tracer, context.active(), `${spanName}.prompt.message`, attributes, event.result, "after");
+            }
             fitSpan.end();
             fitSpan = null;
         },
         onFitError: (event) => {
-            const span = fitSpan ?? tracer.startSpan(spanName, undefined, context.active());
-            setAttributes(span, {
+            if (!fitSpan) {
+                fitSpan = tracer.startSpan(spanName, undefined, context.active());
+                setAttributes(fitSpan, {
+                    ...attributes,
+                    "cria.budget": event.error.budget,
+                    "cria.total_tokens": event.totalTokens,
+                });
+            }
+            setAttributes(fitSpan, {
                 ...attributes,
                 "cria.iteration": event.iteration,
                 "cria.priority": event.priority,
                 "cria.total_tokens": event.totalTokens,
             });
-            span.setStatus({
+            fitSpan.setStatus({
                 code: SpanStatusCode.ERROR,
                 message: event.error.message,
             });
-            span.recordException(event.error);
-            span.end();
+            fitSpan.recordException(event.error);
+            fitSpan.end();
             fitSpan = null;
         },
     };
@@ -79,15 +87,120 @@ function setElementAttributes(span, element) {
     }
     if (element.kind === "scope") {
         span.setAttribute("cria.node.priority", element.priority);
+        span.setAttribute("cria.scope.priority", element.priority);
+        setOptionalAttribute(span, "cria.scope.id", element.id);
+        const stats = countScopeStats(element);
+        span.setAttribute("cria.scope.child_count", element.children.length);
+        span.setAttribute("cria.scope.message_count", stats.messageCount);
+        span.setAttribute("cria.scope.scope_count", stats.scopeCount);
+        span.setAttribute("cria.scope.has_strategy", Boolean(element.strategy));
         return;
     }
     span.setAttribute("cria.node.role", element.role);
+    span.setAttribute("cria.message.role", element.role);
+    setOptionalAttribute(span, "cria.message.id", element.id);
+}
+function countScopeStats(scope) {
+    return scope.children.reduce((acc, child) => {
+        if (child.kind === "message") {
+            acc.messageCount += 1;
+            return acc;
+        }
+        acc.scopeCount += 1;
+        const nested = countScopeStats(child);
+        acc.messageCount += nested.messageCount;
+        acc.scopeCount += nested.scopeCount;
+        return acc;
+    }, { messageCount: 0, scopeCount: 0 });
+}
+function emitPromptStructureSpans(tracer, activeContext, spanName, baseAttributes, root, phase) {
+    let index = 0;
+    const walkMessages = (scope, path) => {
+        const nextPath = [...path, formatScopeSegment(scope)];
+        for (const child of scope.children) {
+            if (child.kind === "message") {
+                const span = tracer.startSpan(spanName, undefined, activeContext);
+                setAttributes(span, {
+                    ...baseAttributes,
+                    "cria.prompt.phase": phase,
+                    "cria.message.index": index,
+                    "cria.message.role": child.role,
+                    "cria.message.scope_path": nextPath.join("/"),
+                    ...renderMessageParts(child.children),
+                });
+                setOptionalAttribute(span, "cria.message.id", child.id);
+                span.end();
+                index += 1;
+                continue;
+            }
+            walkMessages(child, nextPath);
+        }
+    };
+    walkMessages(root, []);
+}
+function renderMessageParts(parts) {
+    let text = "";
+    let reasoning = "";
+    const toolCalls = [];
+    const toolResults = [];
+    for (const part of parts) {
+        if (part.type === "text") {
+            text += part.text;
+            continue;
+        }
+        if (part.type === "reasoning") {
+            reasoning += part.text;
+            continue;
+        }
+        if (part.type === "tool-call") {
+            toolCalls.push({
+                toolCallId: part.toolCallId,
+                toolName: part.toolName,
+                input: part.input,
+            });
+            continue;
+        }
+        toolResults.push({
+            toolCallId: part.toolCallId,
+            toolName: part.toolName,
+            output: part.output,
+        });
+    }
+    const attrs = {};
+    if (text) {
+        attrs["cria.message.text"] = text;
+    }
+    if (reasoning) {
+        attrs["cria.message.reasoning"] = reasoning;
+    }
+    if (toolCalls.length > 0) {
+        attrs["cria.message.tool_calls"] = safeStringify(toolCalls);
+    }
+    if (toolResults.length > 0) {
+        attrs["cria.message.tool_results"] = safeStringify(toolResults);
+    }
+    return attrs;
+}
+function safeStringify(value) {
+    try {
+        return JSON.stringify(value);
+    }
+    catch {
+        return "[unserializable]";
+    }
+}
+function formatScopeSegment(scope) {
+    return scope.id ? `p${scope.priority}:${scope.id}` : `p${scope.priority}`;
+}
+function setOptionalAttribute(span, key, value) {
+    if (value === undefined) {
+        return;
+    }
+    span.setAttribute(key, value);
 }
 function setAttributes(span, attrs) {
     for (const [key, value] of Object.entries(attrs)) {
-        if (value !== undefined) {
-            span.setAttribute(key, value);
-        }
+        setOptionalAttribute(span, key, value);
     }
 }
 //# sourceMappingURL=otel.js.map

package/dist/instrumentation/otel.js.map

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

package/dist/provider.d.ts

@@ -1,5 +1,15 @@
 import type { z } from "zod";
-import type { MaybePromise, PromptLayout, PromptMessage, ProviderToolIO } from "./types";
+import type { CacheDescriptor, MaybePromise, PromptLayout, PromptMessage, ProviderToolIO } from "./types";
+/**
+ * Context passed into codec rendering.
+ *
+ * This is derived from the fitted prompt tree and allows providers/adapters to
+ * map provider-agnostic hints (like cache pinning) to provider-native features
+ * during render.
+ */
+export interface ProviderRenderContext {
+    cache?: CacheDescriptor | undefined;
+}
 /**
  * Bidirectional codec between PromptLayout (IR) and provider-native input.
  */
@@ -12,7 +22,10 @@ export declare abstract class MessageCodec<TRendered, TToolIO extends ProviderTo
  * Providers with non-standard structures can override render/parse directly.
  */
 export declare abstract class ListMessageCodec<TProviderMessage, TToolIO extends ProviderToolIO> extends MessageCodec<readonly TProviderMessage[], TToolIO> {
-    protected abstract toProviderMessage(message: PromptMessage<TToolIO>): readonly TProviderMessage[];
+    protected abstract toProviderMessage(args: {
+        message: PromptMessage<TToolIO>;
+        index: number;
+    }): readonly TProviderMessage[];
     protected abstract fromProviderMessage(message: TProviderMessage): readonly PromptMessage<TToolIO>[];
     render(layout: PromptLayout<TToolIO>): readonly TProviderMessage[];
     parse(rendered: readonly TProviderMessage[]): PromptLayout<TToolIO>;
@@ -67,7 +80,7 @@ export interface InputLayout<TToolIO extends ProviderToolIO = ProviderToolIO> {
  */
 export interface ProviderAdapter<TProtocolInput, TProviderInput> {
     /** Convert protocol input into the provider-native input shape. */
-    to(input: TProtocolInput): TProviderInput;
+    to(input: TProtocolInput, context?: ProviderRenderContext): TProviderInput;
     /** Convert provider-native input into the protocol input shape. */
     from(input: TProviderInput): TProtocolInput;
 }

package/dist/provider.d.ts.map

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