PomBuilder | SignalWire

PomBuilder provides a fluent interface for creating structured prompts using the Prompt Object Model (POM). POM organizes prompt content into titled sections, subsections, and bullet lists — producing consistent, well-structured prompts that the AI can follow reliably.

Use PomBuilder when you need fine-grained control over prompt structure beyond what setPromptText() and promptAddSection() on AgentBase provide. The builder can render to Markdown format.

Methods

addSection

Add a new top-level section to the POM.

addSubsection

Add a subsection to an existing section.

addToSection

Add content to an existing section.

findSection

Find a section by title for direct manipulation.

getSection

Get a top-level section by title.

hasSection

Check if a section with a given title exists.

renderMarkdown

Render the POM as a Markdown string.

toDict

Convert the POM to a list of section objects.

Examples

Building a structured prompt

1 import { PomBuilder } from '@signalwire/sdk';
2 
3 const pom = new PomBuilder();
4 pom.addSection('Role', { body: 'You are a helpful assistant.' });
5 pom.addSection('Rules', { bullets: ['Be concise', 'Be accurate'] });
6 
7 const markdown = pom.renderMarkdown();
8 console.log(markdown);

Incremental construction

1 import { PomBuilder } from '@signalwire/sdk';
2 
3 const pom = new PomBuilder();
4 
5 // Start with a basic section
6 pom.addSection('Capabilities', { body: 'You can help with the following:' });
7 
8 // Add bullets incrementally as skills are loaded
9 pom.addToSection('Capabilities', { bullet: 'Weather lookups' });
10 pom.addToSection('Capabilities', { bullet: 'Calendar scheduling' });
11 pom.addToSection('Capabilities', { bullets: [
12   'Order tracking',
13   'Account management',
14 ] });
15 
16 // Add a subsection
17 pom.addSubsection('Capabilities', 'Limitations', {
18   body: 'You cannot process payments directly.',
19 });
20 
21 console.log(pom.renderMarkdown());