PomBuilder

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.

renderXml

Render the POM as an XML document.

toDict

Convert the POM to a list of section objects.

toJson

Serialize all sections to a JSON string.

fromSections

Create a new PomBuilder from section data (static).

addPomAsSubsection

Append another PomBuilder’s sections as subsections.

reset

Clear all sections and start over.

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());

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);

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());