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.

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.

pom

Get a PromptObjectModel snapshot of the builder’s sections.

reset

Clear all sections and start over.

Examples

Building a structured prompt

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

Incremental construction

import { PomBuilder } from '@signalwire/sdk';
const pom = new PomBuilder();
// Start with a basic section
pom.addSection('Capabilities', { body: 'You can help with the following:' });
// Add bullets incrementally as skills are loaded
pom.addToSection('Capabilities', { bullet: 'Weather lookups' });
pom.addToSection('Capabilities', { bullet: 'Calendar scheduling' });
pom.addToSection('Capabilities', { bullets: [
  'Order tracking',
  'Account management',
] });
// Add a subsection
pom.addSubsection('Capabilities', 'Limitations', {
  body: 'You cannot process payments directly.',
});
console.log(pom.renderMarkdown());