ContextWindow.fit_prompt()

Fit a PromptBuilder’s output into the token budget.

Usage

Source

ContextWindow.fit_prompt(builder)

If the full prompt fits, returns it unchanged. Otherwise, drops lowest-priority sections until it fits.

Parameters

builder: PromptBuilder

A ~talk_box.prompt_builder.PromptBuilder instance.

Returns

PromptFitResult

The fitted prompt text and metadata.

Examples

import talk_box as tb

builder = (
    tb.PromptBuilder()
    .persona("analyst", "data science")
    .task_context("Analyze sales data")
    .constraint("Be concise")
    .example("Q: Revenue?", "A: $1.2M")
)
ctx = tb.ContextWindow(max_tokens=2048)
result = ctx.fit_prompt(builder)
print(f"Prompt uses {result.tokens_used} tokens")