Output & Tone

​

withOutput

withOutput(format: string): this

​

Examples

builder.withOutput("Respond in this format:\n1. Summary\n2. Details\n3. Next steps");

builder.withOutput(`
  Use the following structure:
  - Brief overview (2-3 sentences)
  - Bullet points for key information
  - Code examples when relevant
  - Concluding recommendation
`);

​

withTone

withTone(tone: string): this

​

Examples

builder.withTone("Be friendly, enthusiastic, and encouraging. Use a conversational tone.");

builder.withTone("Maintain a professional and formal tone. Be precise and avoid casual language.");

builder.withTone("Be patient and educational. Explain concepts clearly without being condescending.");

​

withFormat

• markdown: Standard markdown format with headers and formatting (default). Most human-readable, good for debugging and documentation.
• toon: TOON format (Token-Oriented Object Notation). Optimized for token efficiency, reducing token usage by 30-60% compared to markdown. Uses indentation-based structure and eliminates redundant syntax.
• compact: Minimal whitespace variant of markdown. Removes excessive whitespace while maintaining markdown structure.

• Start with markdown while authoring or debugging prompts so teammates can read and diff the content easily.
• Promote to compact in QA/staging when you still want Markdown semantics but need to trim 10–20% of token usage.
• Switch to toon for production workloads with high traffic or large guardrails/examples where 30–60% token savings meaningfully lower cost.

withFormat(format: PromptFormat): this

​

Examples

// Use TOON format for token efficiency (30-60% reduction)
const builder = createPromptBuilder()
  .withIdentity("You are a helpful assistant")
  .withCapabilities(["Answer questions", "Provide help"])
  .withFormat('toon');

const prompt = builder.build(); // Generated in TOON format

// Use compact format for moderate token savings
builder.withFormat('compact');

// Use default markdown for readability
builder.withFormat('markdown');