@fastpaca/cria 0.0.1 → 1.0.1

package/dist/components/index.d.ts

@@ -0,0 +1,148 @@
+import type { Child } from "../jsx-runtime";
+import type { PromptElement, PromptRole, Strategy } from "../types";
+interface RegionProps {
+    /** Lower number = higher importance. Default: 0 (highest priority) */
+    priority?: number;
+    /** Optional strategy to apply when this region needs to shrink */
+    strategy?: Strategy;
+    /** Stable identifier for caching/debugging */
+    id?: string;
+    /** Content of this region */
+    children?: Child;
+}
+/**
+ * The fundamental building block of Cria prompts—think of it as `<div>`.
+ *
+ * Regions define sections of your prompt with a priority level. During fitting,
+ * regions with higher priority numbers (less important) are reduced first.
+ *
+ * @example
+ * ```tsx
+ * <Region priority={0}>You are a helpful assistant.</Region>
+ * <Region priority={2}>{documents}</Region>
+ * <Region priority={1}>{userMessage}</Region>
+ * ```
+ */
+export declare function Region({ priority, strategy, id, children, }: RegionProps): PromptElement;
+interface SemanticRegionProps {
+    /** Lower number = higher importance. Default: 0 (highest priority) */
+    priority?: number;
+    /** Optional strategy to apply when this region needs to shrink */
+    strategy?: Strategy;
+    /** Stable identifier for caching/debugging */
+    id?: string;
+}
+interface MessageProps extends SemanticRegionProps {
+    /** The message role (user, assistant, system, etc.) */
+    messageRole: PromptRole;
+    children?: Child;
+}
+export declare function Message({ messageRole, priority, strategy, id, children, }: MessageProps): PromptElement;
+interface ReasoningProps extends SemanticRegionProps {
+    text: string;
+}
+export declare function Reasoning({ text, priority, strategy, id, }: ReasoningProps): PromptElement;
+interface ToolCallProps extends SemanticRegionProps {
+    toolCallId: string;
+    toolName: string;
+    input: unknown;
+}
+export declare function ToolCall({ toolCallId, toolName, input, priority, strategy, id, }: ToolCallProps): PromptElement;
+interface ToolResultProps extends SemanticRegionProps {
+    toolCallId: string;
+    toolName: string;
+    output: unknown;
+}
+export declare function ToolResult({ toolCallId, toolName, output, priority, strategy, id, }: ToolResultProps): PromptElement;
+interface TruncateProps {
+    /** Maximum token count for this region's content */
+    budget: number;
+    /** Which end to truncate from. Default: "start" */
+    from?: "start" | "end";
+    /** Lower number = higher importance. Default: 0 */
+    priority?: number;
+    /** Stable identifier for caching/debugging */
+    id?: string;
+    /** Content to truncate */
+    children?: Child;
+}
+/**
+ * A region that truncates its content to fit within a token budget.
+ *
+ * When the overall prompt exceeds budget, Truncate regions progressively
+ * remove content from the specified direction until they meet their budget.
+ *
+ * @example
+ * ```tsx
+ * <Truncate budget={20000} priority={2}>
+ *   {conversationHistory}
+ * </Truncate>
+ * ```
+ */
+export declare function Truncate({ budget, from, priority, id, children, }: TruncateProps): PromptElement;
+interface OmitProps {
+    /** Lower number = higher importance. Default: 0 */
+    priority?: number;
+    /** Stable identifier for caching/debugging */
+    id?: string;
+    /** Content that may be omitted */
+    children?: Child;
+}
+/**
+ * A region that is entirely removed when the prompt needs to shrink.
+ *
+ * Use Omit for "nice to have" content that can be dropped entirely if needed.
+ * When the prompt exceeds budget, Omit regions are removed (lowest priority first).
+ *
+ * @example
+ * ```tsx
+ * <Omit priority={3}>
+ *   {optionalExamples}
+ * </Omit>
+ * ```
+ */
+export declare function Omit({ priority, id, children, }: OmitProps): PromptElement;
+interface LastProps {
+    /** Number of children to keep */
+    N: number;
+    /** Priority for this region. Default: 0 */
+    priority?: number;
+    /** Children to filter */
+    children?: Child;
+}
+/**
+ * Keeps only the last N children.
+ *
+ * @example
+ * ```tsx
+ * <Last N={50}>{messages}</Last>
+ * ```
+ */
+export declare function Last({ N, priority, children, }: LastProps): PromptElement;
+export type { StoredSummary, Summarizer, SummarizerContext } from "./summary";
+export { Summary } from "./summary";
+export type { ResultFormatter } from "./vector-search";
+export { VectorSearch } from "./vector-search";
+interface SeparatorProps {
+    value?: string;
+    priority?: number;
+    id?: string;
+    children?: Child;
+}
+export declare function Separator({ value, priority, id, children, }: SeparatorProps): PromptElement;
+interface ExamplesProps {
+    title?: string;
+    separator?: string;
+    priority?: number;
+    id?: string;
+    children?: Child;
+}
+export declare function Examples({ title, separator, priority, id, children, }: ExamplesProps): PromptElement;
+interface CodeBlockProps {
+    code: string;
+    language?: string;
+    priority?: number;
+    id?: string;
+}
+export declare function CodeBlock({ code, language, priority, id, }: CodeBlockProps): PromptElement;
+//# sourceMappingURL=index.d.ts.map

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

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

package/dist/components/index.js

@@ -0,0 +1,184 @@
+/**
+ * The fundamental building block of Cria prompts—think of it as `<div>`.
+ *
+ * Regions define sections of your prompt with a priority level. During fitting,
+ * regions with higher priority numbers (less important) are reduced first.
+ *
+ * @example
+ * ```tsx
+ * <Region priority={0}>You are a helpful assistant.</Region>
+ * <Region priority={2}>{documents}</Region>
+ * <Region priority={1}>{userMessage}</Region>
+ * ```
+ */
+export function Region({ priority = 0, strategy, id, children = [], }) {
+    return {
+        priority,
+        children: children,
+        ...(strategy && { strategy }),
+        ...(id && { id }),
+    };
+}
+export function Message({ messageRole, priority = 0, strategy, id, children = [], }) {
+    return {
+        kind: "message",
+        role: messageRole,
+        priority,
+        children: children,
+        ...(strategy && { strategy }),
+        ...(id && { id }),
+    };
+}
+export function Reasoning({ text, priority = 0, strategy, id, }) {
+    return {
+        kind: "reasoning",
+        text,
+        priority,
+        children: [],
+        ...(strategy && { strategy }),
+        ...(id && { id }),
+    };
+}
+export function ToolCall({ toolCallId, toolName, input, priority = 0, strategy, id, }) {
+    return {
+        kind: "tool-call",
+        toolCallId,
+        toolName,
+        input,
+        priority,
+        children: [],
+        ...(strategy && { strategy }),
+        ...(id && { id }),
+    };
+}
+export function ToolResult({ toolCallId, toolName, output, priority = 0, strategy, id, }) {
+    return {
+        kind: "tool-result",
+        toolCallId,
+        toolName,
+        output,
+        priority,
+        children: [],
+        ...(strategy && { strategy }),
+        ...(id && { id }),
+    };
+}
+/**
+ * A region that truncates its content to fit within a token budget.
+ *
+ * When the overall prompt exceeds budget, Truncate regions progressively
+ * remove content from the specified direction until they meet their budget.
+ *
+ * @example
+ * ```tsx
+ * <Truncate budget={20000} priority={2}>
+ *   {conversationHistory}
+ * </Truncate>
+ * ```
+ */
+export function Truncate({ budget, from = "start", priority = 0, id, children = [], }) {
+    const strategy = (input) => {
+        const content = input.tokenString(input.target);
+        let tokens = input.tokenizer(content);
+        if (tokens <= budget) {
+            return input.target;
+        }
+        let truncated = content;
+        while (tokens > budget && truncated.length > 0) {
+            const charsToRemove = Math.max(1, Math.floor(truncated.length * 0.1));
+            truncated =
+                from === "start"
+                    ? truncated.slice(charsToRemove)
+                    : truncated.slice(0, -charsToRemove);
+            tokens = input.tokenizer(truncated);
+        }
+        if (truncated.length === 0) {
+            return null;
+        }
+        return { ...input.target, children: [truncated] };
+    };
+    return {
+        priority,
+        children: children,
+        strategy,
+        ...(id && { id }),
+    };
+}
+/**
+ * A region that is entirely removed when the prompt needs to shrink.
+ *
+ * Use Omit for "nice to have" content that can be dropped entirely if needed.
+ * When the prompt exceeds budget, Omit regions are removed (lowest priority first).
+ *
+ * @example
+ * ```tsx
+ * <Omit priority={3}>
+ *   {optionalExamples}
+ * </Omit>
+ * ```
+ */
+export function Omit({ priority = 0, id, children = [], }) {
+    const strategy = () => null;
+    return {
+        priority,
+        children: children,
+        strategy,
+        ...(id && { id }),
+    };
+}
+/**
+ * Keeps only the last N children.
+ *
+ * @example
+ * ```tsx
+ * <Last N={50}>{messages}</Last>
+ * ```
+ */
+export function Last({ N, priority = 0, children = [], }) {
+    const normalizedChildren = children;
+    const lastN = normalizedChildren.slice(-N);
+    return {
+        priority,
+        children: lastN,
+    };
+}
+export { Summary } from "./summary";
+export { VectorSearch } from "./vector-search";
+/**
+ * Intersperse a separator between elements of an array.
+ */
+function intersperse(items, separator) {
+    if (items.length === 0) {
+        return [];
+    }
+    return items.flatMap((item, i) => (i === 0 ? [item] : [separator, item]));
+}
+export function Separator({ value = "\n", priority = 0, id, children = [], }) {
+    const normalized = children;
+    return {
+        priority,
+        children: intersperse(normalized, value),
+        ...(id && { id }),
+    };
+}
+export function Examples({ title = "Examples:", separator = "\n\n", priority = 2, id, children = [], }) {
+    const normalized = children;
+    const withSeparators = intersperse(normalized, separator);
+    const prefixed = title
+        ? [`${title}\n`, ...withSeparators]
+        : withSeparators;
+    return {
+        priority,
+        children: prefixed,
+        ...(id && { id }),
+    };
+}
+export function CodeBlock({ code, language, priority = 0, id, }) {
+    const fenced = `\`\`\`${language ?? ""}\n${code}\n\`\`\`\n`;
+    return {
+        priority,
+        children: [fenced],
+        ...(id && { id }),
+    };
+}
+//# sourceMappingURL=index.js.map

package/dist/components/index.js.map

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

package/dist/components/summary.d.ts

@@ -0,0 +1,91 @@
+import type { Child } from "../jsx-runtime";
+import type { KVMemory } from "../memory";
+import type { MaybePromise, PromptElement } from "../types";
+/**
+ * Stored summary data persisted across renders.
+ */
+export interface StoredSummary {
+    /** The summary text content */
+    content: string;
+    /** Token count of the summary */
+    tokenCount: number;
+}
+/**
+ * Context passed to the summarizer function.
+ */
+export interface SummarizerContext {
+    /** The content to summarize (as rendered string) */
+    content: string;
+    /** Previous summary to build upon (null if first summary) */
+    existingSummary: string | null;
+}
+/**
+ * Function that generates summaries.
+ */
+export type Summarizer = (ctx: SummarizerContext) => MaybePromise<string>;
+interface SummaryProps {
+    /** 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 region (higher number = reduced first). Default: 0 */
+    priority?: number;
+    /** Content to potentially summarize */
+    children?: Child;
+}
+/**
+ * A region that summarizes its content when the prompt needs to shrink.
+ *
+ * When the overall prompt exceeds budget and this region is selected for
+ * reduction (based on priority), the summarizer is called and the result
+ * replaces the original content.
+ *
+ * If no `summarize` function is provided, the component will use the
+ * `ModelProvider` from an ancestor provider component with a default
+ * summarization prompt.
+ *
+ * @example Using a custom summarizer
+ * ```tsx
+ * import { InMemoryStore, Summary, type StoredSummary } from "@fastpaca/cria";
+ *
+ * const store = new InMemoryStore<StoredSummary>();
+ *
+ * <Summary
+ *   id="conv-history"
+ *   store={store}
+ *   summarize={async ({ content, existingSummary }) => {
+ *     return callAI(`Summarize, building on: ${existingSummary}\n\n${content}`);
+ *   }}
+ *   priority={2}
+ * >
+ *   {conversationHistory}
+ * </Summary>
+ * ```
+ *
+ * @example Using a provider component
+ * ```tsx
+ * import { InMemoryStore, Summary, type StoredSummary, render } from "@fastpaca/cria";
+ * import { AISDKProvider } from "@fastpaca/cria/ai-sdk";
+ * import { openai } from "@ai-sdk/openai";
+ *
+ * const store = new InMemoryStore<StoredSummary>();
+ *
+ * const prompt = (
+ *   <AISDKProvider model={openai("gpt-4o")}>
+ *     <Summary id="conv-history" store={store} priority={2}>
+ *       {conversationHistory}
+ *     </Summary>
+ *   </AISDKProvider>
+ * );
+ *
+ * const result = await render(prompt, { tokenizer, budget: 4000 });
+ * ```
+ */
+export declare function Summary({ id, store, summarize, priority, children, }: SummaryProps): PromptElement;
+export {};
+//# sourceMappingURL=summary.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"summary.d.ts","sourceRoot":"","sources":["../../src/components/summary.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AAC5C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,KAAK,EACV,YAAY,EAGZ,aAAa,EAGd,MAAM,UAAU,CAAC;AAElB;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,+BAA+B;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,iCAAiC;IACjC,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,oDAAoD;IACpD,OAAO,EAAE,MAAM,CAAC;IAChB,6DAA6D;IAC7D,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;CAChC;AAED;;GAEG;AACH,MAAM,MAAM,UAAU,GAAG,CAAC,GAAG,EAAE,iBAAiB,KAAK,YAAY,CAAC,MAAM,CAAC,CAAC;AAwF1E,UAAU,YAAY;IACpB,sDAAsD;IACtD,EAAE,EAAE,MAAM,CAAC;IACX,+CAA+C;IAC/C,KAAK,EAAE,QAAQ,CAAC,aAAa,CAAC,CAAC;IAC/B;;;OAGG;IACH,SAAS,CAAC,EAAE,UAAU,CAAC;IACvB,2EAA2E;IAC3E,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,uCAAuC;IACvC,QAAQ,CAAC,EAAE,KAAK,CAAC;CAClB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+CG;AACH,wBAAgB,OAAO,CAAC,EACtB,EAAE,EACF,KAAK,EACL,SAAS,EACT,QAAY,EACZ,QAAa,GACd,EAAE,YAAY,GAAG,aAAa,CAM9B"}

package/dist/components/summary.js

@@ -0,0 +1,118 @@
+/**
+ * Default summarizer that uses a ModelProvider.
+ * This is used when no custom summarize function is provided.
+ */
+async function defaultSummarizer(ctx, provider) {
+    const systemPrompt = "You are a conversation summarizer. Create a concise summary that captures the key points and context needed to continue the conversation. Be brief but preserve essential information.";
+    let userPrompt;
+    if (ctx.existingSummary) {
+        userPrompt = `Here is the existing summary of the conversation so far:
+
+${ctx.existingSummary}
+
+Here is new conversation content to incorporate into the summary:
+
+${ctx.content}
+
+Please provide an updated summary that incorporates both the existing summary and the new content.`;
+    }
+    else {
+        userPrompt = `Please summarize the following conversation:
+
+${ctx.content}`;
+    }
+    const result = await provider.completion({
+        system: systemPrompt,
+        messages: [{ role: "user", content: userPrompt }],
+    });
+    return result.text;
+}
+function createSummaryStrategy({ id, store, summarize, }) {
+    return async (input) => {
+        const { target, tokenizer, tokenString, context } = input;
+        const content = tokenString(target);
+        const existingEntry = await store.get(id);
+        const summarizerContext = {
+            content,
+            existingSummary: existingEntry?.data.content ?? null,
+        };
+        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 component ancestor (e.g. <AISDKProvider>)`);
+        }
+        const newTokenCount = tokenizer(newSummary);
+        await store.set(id, {
+            content: newSummary,
+            tokenCount: newTokenCount,
+        });
+        // Return as an assistant message so it renders properly
+        return {
+            kind: "message",
+            role: "assistant",
+            priority: target.priority,
+            children: [`[Summary of earlier conversation]\n${newSummary}`],
+        };
+    };
+}
+/**
+ * A region that summarizes its content when the prompt needs to shrink.
+ *
+ * When the overall prompt exceeds budget and this region is selected for
+ * reduction (based on priority), the summarizer is called and the result
+ * replaces the original content.
+ *
+ * If no `summarize` function is provided, the component will use the
+ * `ModelProvider` from an ancestor provider component with a default
+ * summarization prompt.
+ *
+ * @example Using a custom summarizer
+ * ```tsx
+ * import { InMemoryStore, Summary, type StoredSummary } from "@fastpaca/cria";
+ *
+ * const store = new InMemoryStore<StoredSummary>();
+ *
+ * <Summary
+ *   id="conv-history"
+ *   store={store}
+ *   summarize={async ({ content, existingSummary }) => {
+ *     return callAI(`Summarize, building on: ${existingSummary}\n\n${content}`);
+ *   }}
+ *   priority={2}
+ * >
+ *   {conversationHistory}
+ * </Summary>
+ * ```
+ *
+ * @example Using a provider component
+ * ```tsx
+ * import { InMemoryStore, Summary, type StoredSummary, render } from "@fastpaca/cria";
+ * import { AISDKProvider } from "@fastpaca/cria/ai-sdk";
+ * import { openai } from "@ai-sdk/openai";
+ *
+ * const store = new InMemoryStore<StoredSummary>();
+ *
+ * const prompt = (
+ *   <AISDKProvider model={openai("gpt-4o")}>
+ *     <Summary id="conv-history" store={store} priority={2}>
+ *       {conversationHistory}
+ *     </Summary>
+ *   </AISDKProvider>
+ * );
+ *
+ * const result = await render(prompt, { tokenizer, budget: 4000 });
+ * ```
+ */
+export function Summary({ id, store, summarize, priority = 0, children = [], }) {
+    return {
+        priority,
+        strategy: createSummaryStrategy({ id, store, summarize }),
+        children: children,
+    };
+}
+//# sourceMappingURL=summary.js.map

package/dist/components/summary.js.map

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

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

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=summary.test.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"summary.test.d.ts","sourceRoot":"","sources":["../../src/components/summary.test.tsx"],"names":[],"mappings":""}

package/dist/components/summary.test.js

@@ -0,0 +1,101 @@
+import { jsx as _jsx, jsxs as _jsxs } from "@fastpaca/cria/jsx-runtime";
+import { expect, test } from "vitest";
+import { InMemoryStore, Last, Region, render, Summary, } from "../index";
+// Simple tokenizer: 1 token per 4 characters
+const tokenizer = (text) => Math.ceil(text.length / 4);
+test("Summary: triggers summarization when over budget", async () => {
+    const store = new InMemoryStore();
+    let summarizeCalled = false;
+    const summarize = ({ content }) => {
+        summarizeCalled = true;
+        return `Summary of: ${content.slice(0, 20)}...`;
+    };
+    const longContent = "A".repeat(200);
+    const element = (_jsx(Region, { priority: 0, children: _jsx(Summary, { id: "test-1", priority: 1, store: store, summarize: summarize, children: longContent }) }));
+    // Render with small budget to trigger summarization
+    // Budget needs to fit the summary output + "[Summary of earlier conversation]\n" prefix
+    const result = await render(element, { tokenizer, budget: 30 });
+    expect(summarizeCalled).toBe(true);
+    expect(result).toContain("Summary of:");
+    expect(result.length).toBeLessThan(longContent.length);
+});
+test("Summary: stores summary in store", async () => {
+    const store = new InMemoryStore();
+    const summarize = () => "This is the summary";
+    const element = (_jsx(Region, { priority: 0, children: _jsx(Summary, { id: "test-2", priority: 1, store: store, summarize: summarize, children: "Long content ".repeat(50) }) }));
+    await render(element, { tokenizer, budget: 20 });
+    const entry = store.get("test-2");
+    expect(entry).not.toBeNull();
+    expect(entry?.data.content).toBe("This is the summary");
+    expect(entry?.data.tokenCount).toBeGreaterThan(0);
+    expect(entry?.updatedAt).toBeGreaterThan(0);
+});
+test("Summary: passes existing summary to summarizer", async () => {
+    const store = new InMemoryStore();
+    // Pre-populate store
+    store.set("test-3", {
+        content: "Previous summary",
+        tokenCount: 10,
+    });
+    let receivedExisting = null;
+    const summarize = ({ existingSummary, }) => {
+        receivedExisting = existingSummary;
+        return "Updated summary";
+    };
+    const element = (_jsx(Region, { priority: 0, children: _jsx(Summary, { id: "test-3", priority: 1, store: store, summarize: summarize, children: "Content ".repeat(100) }) }));
+    await render(element, { tokenizer, budget: 20 });
+    expect(receivedExisting).toBe("Previous summary");
+});
+test("Summary: does not trigger when under budget", async () => {
+    const store = new InMemoryStore();
+    let summarizeCalled = false;
+    const summarize = () => {
+        summarizeCalled = true;
+        return "Summary";
+    };
+    const element = (_jsx(Region, { priority: 0, children: _jsx(Summary, { id: "test-4", priority: 1, store: store, summarize: summarize, children: "Short" }) }));
+    // Large budget - no need to summarize
+    await render(element, { tokenizer, budget: 1000 });
+    expect(summarizeCalled).toBe(false);
+});
+test("Last: keeps only last N children", async () => {
+    const messages = ["First", "Second", "Third", "Fourth", "Fifth"];
+    const element = (_jsx(Region, { priority: 0, children: _jsx(Last, { N: 2, children: messages }) }));
+    const result = await render(element, { tokenizer, budget: 1000 });
+    expect(result).not.toContain("First");
+    expect(result).not.toContain("Second");
+    expect(result).not.toContain("Third");
+    expect(result).toContain("Fourth");
+    expect(result).toContain("Fifth");
+});
+test("Last: handles N larger than children count", async () => {
+    const messages = ["One", "Two"];
+    const element = (_jsx(Region, { priority: 0, children: _jsx(Last, { N: 10, children: messages }) }));
+    const result = await render(element, { tokenizer, budget: 1000 });
+    expect(result).toContain("One");
+    expect(result).toContain("Two");
+});
+test("Summary + Last: typical usage pattern", async () => {
+    const store = new InMemoryStore();
+    // Summarizer produces a short fixed-length output
+    const summarize = () => "Discussed greetings";
+    // Use longer messages so the summary provides real compression
+    const messages = [
+        "Message 1: Hello there, how are you doing today?",
+        "Message 2: I am doing great, thanks for asking!",
+        "Message 3: That is wonderful to hear from you.",
+        "Message 4: Recent message here",
+        "Message 5: Final message",
+    ];
+    const element = (_jsxs(Region, { priority: 0, children: [_jsx(Summary, { id: "conv", priority: 2, store: store, summarize: summarize, children: messages.slice(0, -2) }), _jsx(Last, { N: 2, children: messages })] }));
+    // Full content: ~180 chars = 45 tokens
+    // Summarized: prefix (34) + summary (19) + last 2 msgs (~50) = ~103 chars = 26 tokens
+    const result = await render(element, { tokenizer, budget: 30 });
+    // Should have summary of older messages (wrapped with prefix)
+    expect(result).toContain("[Summary of earlier conversation]");
+    expect(result).toContain("Discussed greetings");
+    // Should have recent messages in full
+    expect(result).toContain("Message 4: Recent message here");
+    expect(result).toContain("Message 5: Final message");
+});
+//# sourceMappingURL=summary.test.js.map