@anythingai/teleprompt 0.1.0 → 0.2.0

package/README.md

@@ -1,8 +1,8 @@
 # teleprompt
 
-Compose LLM system prompts from discrete sections instead of monolithic template literals.
+Composable, section-based LLM system prompts.
 
-Conditional logic, variants, and prompt changes stay co-located with their content. Adding a new flag is one section in one file, not a boolean threaded through 15 function signatures.
+Each section owns its content and conditional logic. Sections can be reused across prompt variants, conditionally included, and rendered as plain text or XML.
 
 ```bash
 pnpm add @anythingai/teleprompt
@@ -11,35 +11,30 @@ pnpm add @anythingai/teleprompt
 ## Quick Start
 
 ```ts
-import { PromptBuilder, type PromptContext, type PromptSection } from '@anythingai/teleprompt';
+import { PromptBuilder, section, type PromptContext } from '@anythingai/teleprompt';
 
 // Define your context shape
 type MyFlags = { webSearchEnabled: boolean };
 type MyVars = { assistantName: string };
 type MyContext = PromptContext<MyFlags, MyVars>;
 
-// Sections are objects with an id and a render function
-const identity: PromptSection<MyContext> = {
-  id: 'identity',
-  render: (ctx) => `You are ${ctx.vars.assistantName}, a helpful AI assistant.`,
-};
-
-// This is a static section with no context dependencies
-const guidelines: PromptSection<MyContext> = {
-  id: 'guidelines',
-  render: () => `# Guidelines
+// Static section — no context needed, no type parameter
+const guidelines = section('guidelines', () => `# Guidelines
 - Be concise and direct.
 - Cite sources when making factual claims.
-- Ask for clarification when a request is ambiguous.`,
-};
+- Ask for clarification when a request is ambiguous.`);
 
-// Conditional logic lives in the section, not threaded through function signatures
-const webSearch: PromptSection<MyContext> = {
-  id: 'web-search',
-  when: (ctx) => ctx.flags.webSearchEnabled,
-  render: () => `You have access to web search. Use it when the user asks about
-current events or information that may have changed after your training cutoff.`,
-};
+// Dynamic section — uses context
+const identity = section('identity', (ctx: MyContext) =>
+  `You are ${ctx.vars.assistantName}, a helpful AI assistant.`
+);
+
+// Conditional section — return null to exclude
+const webSearch = section('web-search', (ctx: MyContext) => {
+  if (!ctx.flags.webSearchEnabled) return null;
+  return `You have access to web search. Use it when the user asks about
+current events or information that may have changed after your training cutoff.`;
+});
 
 // Compose and build
 const prompt = new PromptBuilder<MyContext>()
@@ -54,21 +49,60 @@ const prompt = new PromptBuilder<MyContext>()
 
 ## Sections
 
-A section has an `id`, a `render` function, and optionally a `when` guard:
+`section(id, render)` takes an id and a render function. Return a string to include, `null` to exclude:
 
 ```ts
-const citation: PromptSection<MyContext> = {
-  id: 'citation',
-  when: (ctx) => ctx.flags.citationEnabled,   // excluded when false
-  render: () => 'Always include citations with links when referencing external sources.',
-};
+// Always included
+const rules = section('rules', () => 'Be helpful and concise.');
+
+// Conditional — null means excluded
+const citation = section('citation', (ctx: MyContext) => {
+  if (!ctx.flags.citationEnabled) return null;
+  return 'Always include citations with links when referencing external sources.';
+});
 ```
 
 Sections render in the order you call `.use()`. To reorder, change the call order.
 
+Static sections (no type parameter) work in any builder:
+
+```ts
+const disclaimer = section('disclaimer', () => 'Responses are not legal advice.');
+
+// Works in any builder regardless of context type
+new PromptBuilder<MyContext>().use(disclaimer)
+new PromptBuilder<OtherContext>().use(disclaimer)
+```
+
+## Context
+
+Sections receive a typed context with boolean flags and arbitrary variables:
+
+```ts
+type MyFlags = {
+  webSearchEnabled: boolean;
+  citationEnabled: boolean;
+};
+
+type MyVars = {
+  assistantName: string;
+  language: string;
+};
+
+type MyContext = PromptContext<MyFlags, MyVars>;
+```
+
+`PromptContext` and `PromptBuilder` have defaults, so the type parameter is optional:
+
+```ts
+const builder = new PromptBuilder();
+```
+
+Build the context once and pass it to `.build(ctx)`. Every section receives the same object.
+
 ## Forking
 
-Create variants without duplicating prompt code:
+Create variants from a shared base:
 
 ```ts
 const base = new PromptBuilder<MyContext>()
@@ -91,50 +125,96 @@ const codeAssistant = base.fork()
 
 Each fork is independent. Modifying one doesn't affect the others.
 
-## Context
+## XML Format
 
-Sections receive a typed context with boolean flags and arbitrary variables:
+Both Claude and Gemini recommend structuring prompts with XML tags. Pass `{ format: 'xml' }` to `.build()` to wrap each section in `<id>` tags:
 
 ```ts
-type MyFlags = {
-  webSearchEnabled: boolean;
-  citationEnabled: boolean;
-};
+builder.build(ctx, { format: 'xml' })
+```
 
-type MyVars = {
-  assistantName: string;
-  language: string;
-};
+The section id becomes the tag name. Content is left as-is inside the tags.
 
-type MyContext = PromptContext<MyFlags, MyVars>;
+## Groups
+
+Group related sections together. In text mode, groups are transparent. In XML mode, they wrap children in tags:
+
+```ts
+const prompt = new PromptBuilder<MyContext>()
+  .use(identity)
+  .group('tools', b => b
+    .use(webSearch)
+    .use(calculator)
+  )
+  .use(guidelines)
+  .build(ctx, { format: 'xml' });
 ```
 
-You build the context once and pass it to `.build(ctx)`. Every section receives the same object — no threading booleans through function signatures.
+```xml
+<identity>
+You are Daniel, a helpful AI assistant.
+</identity>
+
+<tools>
+<web-search>
+You have access to web search...
+</web-search>
+
+<calculator>
+You can evaluate math expressions...
+</calculator>
+</tools>
+
+<guidelines>
+# Guidelines
+...
+</guidelines>
+```
 
-## Builder API
+Groups can be nested:
 
 ```ts
-new PromptBuilder<MyContext>()
-  // append a section (replaces if same id exists)
-  .use(section)
+builder.group('capabilities', b => b
+  .group('tools', b => b
+    .use(webSearch)
+    .use(calculator)
+  )
+  .group('integrations', b => b
+    .use(slack)
+    .use(linear)
+  )
+)
+```
 
-  // remove by section object or string id
-  .without(section)
+## Mutually Exclusive Sections
 
-  // check existence by section object or string id
-  .has(section)
+Use `.useOneOf()` when exactly one of several sections should render. The first candidate that returns a non-empty string wins:
 
-  // list all section ids
-  .ids()
+```ts
+const hasTasks = section('has-tasks', (ctx: MyContext) => {
+  if (ctx.vars.tasks.length === 0) return null;
+  return `## Active Tasks\n\n${ctx.vars.tasks.map(t => `- ${t.title}`).join('\n')}`;
+});
 
-  // independent copy
-  .fork()
+const noTasks = section('no-tasks', () => '## Active Tasks\n\nNo tasks currently running.');
 
-  // render to string
-  .build(ctx)
+builder.useOneOf(hasTasks, noTasks);
+```
 
-  // render + debug info: { included: string[], excluded: string[] }
-  .buildWithMeta(ctx)        
+## Builder API
+
+```ts
+new PromptBuilder<MyContext>()
+  .use(section)                      // append (replaces if same id)
+  .useOneOf(sectionA, sectionB)      // first match wins
+  .group('name', b => b.use(...))    // named group (XML wrapper)
+  .without(section)                  // remove by object or string id
+  .has(section)                      // check existence
+  .ids()                             // list all section ids
+  .fork()                            // independent copy
+  .build(ctx)                        // render to string
+  .build(ctx, { format: 'xml' })     // render with XML tags
+  .buildWithMeta(ctx)                // render + { included, excluded }
 ```
 
 ## Testing

package/dist/index.cjs

@@ -1,6 +1,18 @@
-"use strict";Object.defineProperty(exports, "__esModule", {value: true}); var _class;// src/builder.ts
+"use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _nullishCoalesce(lhs, rhsFn) { if (lhs != null) { return lhs; } else { return rhsFn(); } } function _optionalChain(ops) { let lastAccessLHS = undefined; let value = ops[0]; let i = 1; while (i < ops.length) { const op = ops[i]; const fn = ops[i + 1]; i += 2; if ((op === 'optionalAccess' || op === 'optionalCall') && value == null) { return undefined; } if (op === 'access' || op === 'optionalAccess') { lastAccessLHS = value; value = fn(value); } else if (op === 'call' || op === 'optionalCall') { value = fn((...args) => value.call(lastAccessLHS, ...args)); lastAccessLHS = undefined; } } return value; } var _class;// src/builder.ts
+function assertNever(value) {
+  throw new Error(`Unexpected format: ${value}`);
+}
+function isSection(node) {
+  return "render" in node;
+}
+function isGroup(node) {
+  return "children" in node;
+}
+function isOneOf(node) {
+  return "candidates" in node;
+}
 var PromptBuilder = (_class = class _PromptBuilder {constructor() { _class.prototype.__init.call(this); }
-  __init() {this.sections = []}
+  __init() {this.nodes = []}
   /**
    * Add a section to the prompt.
    *
@@ -8,29 +20,67 @@ var PromptBuilder = (_class = class _PromptBuilder {constructor() { _class.proto
    * This makes `.use()` idempotent — you can safely call it multiple
    * times with the same section without creating duplicates.
    */
-  use(section) {
-    const existingIdx = this.sections.findIndex((s) => s.id === section.id);
-    if (existingIdx >= 0) {
-      this.sections[existingIdx] = section;
+  use(section2) {
+    const idx = this.nodes.findIndex((n) => !isOneOf(n) && n.id === section2.id);
+    if (idx >= 0) {
+      this.nodes[idx] = section2;
     } else {
-      this.sections.push(section);
+      this.nodes.push(section2);
     }
     return this;
   }
-  /** Remove a section. Accepts an id string or a section object. */
+  /**
+   * Add mutually exclusive sections. The first candidate that renders
+   * a non-empty string wins — the rest are excluded.
+   *
+   * @example
+   * ```ts
+   * builder.useOneOf(activeTasks, noActiveTasks)
+   * ```
+   */
+  useOneOf(...candidates) {
+    this.nodes.push({ candidates });
+    return this;
+  }
+  /**
+   * Add a named group of sections. In `xml` format, children are
+   * wrapped in `<id>...</id>`. In `text` format, groups are transparent
+   * and children render as if they were top-level sections.
+   *
+   * @example
+   * ```ts
+   * builder.group('tools', b => b
+   *   .use(bashSection)
+   *   .use(gitSection)
+   * )
+   * ```
+   */
+  group(id, configure) {
+    const inner = new _PromptBuilder();
+    configure(inner);
+    const group = { id, children: inner.nodes };
+    const idx = this.nodes.findIndex((n) => !isOneOf(n) && n.id === id);
+    if (idx >= 0) {
+      this.nodes[idx] = group;
+    } else {
+      this.nodes.push(group);
+    }
+    return this;
+  }
+  /** Remove a section or group. Accepts an id string or an object with `id`. Searches recursively into groups and oneOf candidates. */
   without(ref) {
     const id = typeof ref === "string" ? ref : ref.id;
-    this.sections = this.sections.filter((s) => s.id !== id);
+    this.nodes = this.removeNode(this.nodes, id);
     return this;
   }
-  /** Check if a section exists. Accepts an id string or a section object. */
+  /** Check if a section or group exists. Accepts an id string or an object with `id`. Searches recursively into groups and oneOf candidates. */
   has(ref) {
     const id = typeof ref === "string" ? ref : ref.id;
-    return this.sections.some((s) => s.id === id);
+    return this.hasNode(this.nodes, id);
   }
-  /** Get the ids of all registered sections (in insertion order). */
+  /** Get all ids (sections, groups, and oneOf candidates) in order. */
   ids() {
-    return this.sections.map((s) => s.id);
+    return this.collectIds(this.nodes);
   }
   /**
    * Create an independent copy of this builder.
@@ -46,7 +96,7 @@ var PromptBuilder = (_class = class _PromptBuilder {constructor() { _class.proto
    */
   fork() {
     const forked = new _PromptBuilder();
-    forked.sections = [...this.sections];
+    forked.nodes = this.deepCopy(this.nodes);
     return forked;
   }
   /**
@@ -56,9 +106,11 @@ var PromptBuilder = (_class = class _PromptBuilder {constructor() { _class.proto
    * 2. Renders each section
    * 3. Filters out empty strings
    * 4. Joins with separator and trims
+   *
+   * Pass `{ format: 'xml' }` to wrap each section in `<id>` tags.
    */
-  build(ctx) {
-    return this.buildWithMeta(ctx).prompt;
+  build(ctx, options) {
+    return this.buildWithMeta(ctx, options).prompt;
   }
   /**
    * Build the prompt and return metadata about which sections were
@@ -68,28 +120,156 @@ var PromptBuilder = (_class = class _PromptBuilder {constructor() { _class.proto
    * A section is "included" only if it passes the guard and renders
    * a non-empty string.
    */
-  buildWithMeta(ctx) {
+  buildWithMeta(ctx, options) {
     const included = [];
     const excluded = [];
-    const rendered = this.sections.filter((s) => {
-      if (s.when && !s.when(ctx)) {
-        excluded.push(s.id);
-        return false;
+    const format = _nullishCoalesce(_optionalChain([options, 'optionalAccess', _ => _.format]), () => ( "text"));
+    const parts = this.renderNodes(this.nodes, ctx, format, included, excluded);
+    const prompt = parts.join("\n\n").trim();
+    return { prompt, included, excluded };
+  }
+  // --- Private ---
+  renderNodes(nodes, ctx, format, included, excluded) {
+    const parts = [];
+    for (const node of nodes) {
+      if (isSection(node)) {
+        this.renderSection(node, ctx, format, parts, included, excluded);
+      } else if (isGroup(node)) {
+        const childParts = this.renderNodes(node.children, ctx, format, included, excluded);
+        if (childParts.length > 0) {
+          parts.push(...this.formatGroup(node.id, childParts, format));
+        }
+      } else {
+        this.renderOneOf(node, ctx, format, parts, included, excluded);
       }
+    }
+    return parts;
+  }
+  renderSection(section2, ctx, format, parts, included, excluded) {
+    if (section2.when && !section2.when(ctx)) {
+      excluded.push(section2.id);
+      return false;
+    }
+    const output = section2.render(ctx);
+    if (output) {
+      included.push(section2.id);
+      parts.push(this.formatSection(section2.id, output, format));
       return true;
-    }).map((s) => {
-      const output = s.render(ctx);
-      if (output) {
-        included.push(s.id);
+    }
+    excluded.push(section2.id);
+    return false;
+  }
+  renderOneOf(node, ctx, format, parts, included, excluded) {
+    let found = false;
+    for (const candidate of node.candidates) {
+      if (found) {
+        excluded.push(candidate.id);
+        continue;
+      }
+      if (this.renderSection(candidate, ctx, format, parts, included, excluded)) {
+        found = true;
+      }
+    }
+  }
+  /** Wrap a single section's rendered content according to the output format. */
+  formatSection(id, content, format) {
+    switch (format) {
+      case "text":
+        return content;
+      case "xml":
+        return `<${id}>
+${content}
+</${id}>`;
+      default:
+        return assertNever(format);
+    }
+  }
+  /**
+   * Wrap a group's rendered children according to the output format.
+   * Returns an array — in text mode the children are spread inline,
+   * in xml mode they are joined and wrapped in a single entry.
+   */
+  formatGroup(id, childParts, format) {
+    switch (format) {
+      case "text":
+        return childParts;
+      case "xml":
+        return [`<${id}>
+${childParts.join("\n\n")}
+</${id}>`];
+      default:
+        return assertNever(format);
+    }
+  }
+  hasNode(nodes, id) {
+    for (const node of nodes) {
+      if (isSection(node)) {
+        if (node.id === id) return true;
+      } else if (isGroup(node)) {
+        if (node.id === id) return true;
+        if (this.hasNode(node.children, id)) return true;
       } else {
-        excluded.push(s.id);
+        for (const c of node.candidates) {
+          if (c.id === id) return true;
+        }
       }
-      return output;
-    }).filter(Boolean).join("\n\n").trim();
-    return { prompt: rendered, included, excluded };
+    }
+    return false;
+  }
+  removeNode(nodes, id) {
+    const result = [];
+    for (const n of nodes) {
+      if (isSection(n)) {
+        if (n.id !== id) result.push(n);
+      } else if (isGroup(n)) {
+        if (n.id !== id) {
+          result.push({ ...n, children: this.removeNode(n.children, id) });
+        }
+      } else {
+        const remaining = n.candidates.filter((c) => c.id !== id);
+        if (remaining.length > 0) {
+          result.push({ candidates: remaining });
+        }
+      }
+    }
+    return result;
+  }
+  collectIds(nodes) {
+    const ids = [];
+    for (const node of nodes) {
+      if (isSection(node)) {
+        ids.push(node.id);
+      } else if (isGroup(node)) {
+        ids.push(node.id);
+        ids.push(...this.collectIds(node.children));
+      } else {
+        ids.push(...node.candidates.map((c) => c.id));
+      }
+    }
+    return ids;
+  }
+  deepCopy(nodes) {
+    return nodes.map((n) => {
+      if (isGroup(n)) {
+        return { ...n, children: this.deepCopy(n.children) };
+      }
+      if (isOneOf(n)) {
+        return { candidates: [...n.candidates] };
+      }
+      return n;
+    });
   }
 }, _class);
 
+// src/section.ts
+function section(id, render) {
+  return {
+    id,
+    render: (ctx) => _nullishCoalesce(render(ctx), () => ( ""))
+  };
+}
+
+
 
-exports.PromptBuilder = PromptBuilder;
+exports.PromptBuilder = PromptBuilder; exports.section = section;
 //# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["/Users/asurve/dev/teleprompt/dist/index.cjs","../src/builder.ts"],"names":[],"mappings":"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","file":"/Users/asurve/dev/teleprompt/dist/index.cjs","sourcesContent":[null,"import type { PromptContext, PromptSection } from './types';\n\n/**\n * Declarative, composable prompt builder.\n *\n * Prompts are composed from discrete {@link PromptSection}s that are\n * independently testable pure functions. The builder handles ordering,\n * conditional inclusion, and final assembly.\n *\n * @example\n * ```ts\n * const prompt = new PromptBuilder()\n *   .use(identitySection)\n *   .use(rulesSection)\n *   .use(featureSection)\n *   .build(ctx);\n * ```\n */\nexport class PromptBuilder<\n  TCtx extends PromptContext<Record<string, boolean>, Record<string, unknown>>,\n> {\n  private sections: PromptSection<TCtx>[] = [];\n\n  /**\n   * Add a section to the prompt.\n   *\n   * If a section with the same `id` already exists, it is replaced.\n   * This makes `.use()` idempotent — you can safely call it multiple\n   * times with the same section without creating duplicates.\n   */\n  use(section: PromptSection<TCtx>): this {\n    const existingIdx = this.sections.findIndex((s) => s.id === section.id);\n    if (existingIdx >= 0) {\n      this.sections[existingIdx] = section;\n    } else {\n      this.sections.push(section);\n    }\n    return this;\n  }\n\n  /** Remove a section. Accepts an id string or a section object. */\n  without(ref: string | { id: string }): this {\n    const id = typeof ref === 'string' ? ref : ref.id;\n    this.sections = this.sections.filter((s) => s.id !== id);\n    return this;\n  }\n\n  /** Check if a section exists. Accepts an id string or a section object. */\n  has(ref: string | { id: string }): boolean {\n    const id = typeof ref === 'string' ? ref : ref.id;\n    return this.sections.some((s) => s.id === id);\n  }\n\n  /** Get the ids of all registered sections (in insertion order). */\n  ids(): string[] {\n    return this.sections.map((s) => s.id);\n  }\n\n  /**\n   * Create an independent copy of this builder.\n   *\n   * Use this to create mode-specific or model-specific variants\n   * without mutating the base builder.\n   *\n   * @example\n   * ```ts\n   * const base = new PromptBuilder().use(a).use(b);\n   * const variant = base.fork().use(c); // base is unchanged\n   * ```\n   */\n  fork(): PromptBuilder<TCtx> {\n    const forked = new PromptBuilder<TCtx>();\n    forked.sections = [...this.sections];\n    return forked;\n  }\n\n  /**\n   * Build the final prompt string.\n   *\n   * 1. Filters out sections whose `when` guard returns false\n   * 2. Renders each section\n   * 3. Filters out empty strings\n   * 4. Joins with separator and trims\n   */\n  build(ctx: TCtx): string {\n    return this.buildWithMeta(ctx).prompt;\n  }\n\n  /**\n   * Build the prompt and return metadata about which sections were\n   * included/excluded. Useful for debugging and logging.\n   *\n   * A section is \"excluded\" if its `when` guard returns false.\n   * A section is \"included\" only if it passes the guard and renders\n   * a non-empty string.\n   */\n  buildWithMeta(ctx: TCtx): {\n    prompt: string;\n    included: string[];\n    excluded: string[];\n  } {\n    const included: string[] = [];\n    const excluded: string[] = [];\n\n    const rendered = this.sections\n      .filter((s) => {\n        if (s.when && !s.when(ctx)) {\n          excluded.push(s.id);\n          return false;\n        }\n        return true;\n      })\n      .map((s) => {\n        const output = s.render(ctx);\n        if (output) {\n          included.push(s.id);\n        } else {\n          excluded.push(s.id);\n        }\n        return output;\n      })\n      .filter(Boolean)\n      .join('\\n\\n')\n      .trim();\n\n    return { prompt: rendered, included, excluded };\n  }\n}\n"]}
+{"version":3,"sources":["/Users/asurve/dev/teleprompt/dist/index.cjs","../src/builder.ts","../src/section.ts"],"names":["section"],"mappings":"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","file":"/Users/asurve/dev/teleprompt/dist/index.cjs","sourcesContent":[null,"import type { PromptContext, PromptSection } from './types';\n\nfunction assertNever(value: never): never {\n  throw new Error(`Unexpected format: ${value}`);\n}\n\n/**\n * A named group of prompt nodes, rendered as an XML wrapper\n * in `xml` format and transparently in `text` format.\n */\ninterface PromptGroup<TCtx extends PromptContext> {\n  id: string;\n  children: PromptNode<TCtx>[];\n}\n\n/** Mutually exclusive sections — the first candidate that renders wins. */\ninterface PromptOneOf<TCtx extends PromptContext> {\n  candidates: PromptSection<TCtx>[];\n}\n\ntype PromptNode<TCtx extends PromptContext> =\n  | PromptSection<TCtx>\n  | PromptGroup<TCtx>\n  | PromptOneOf<TCtx>;\n\nfunction isSection<TCtx extends PromptContext>(\n  node: PromptNode<TCtx>,\n): node is PromptSection<TCtx> {\n  return 'render' in node;\n}\n\nfunction isGroup<TCtx extends PromptContext>(node: PromptNode<TCtx>): node is PromptGroup<TCtx> {\n  return 'children' in node;\n}\n\nfunction isOneOf<TCtx extends PromptContext>(node: PromptNode<TCtx>): node is PromptOneOf<TCtx> {\n  return 'candidates' in node;\n}\n\n/** Supported output formats for prompt rendering. */\nexport type PromptFormat = 'text' | 'xml';\n\n/** Options for {@link PromptBuilder.build} and {@link PromptBuilder.buildWithMeta}. */\nexport interface BuildOptions {\n  /**\n   * Output format.\n   *\n   * - `'text'` (default) — sections joined with `\\n\\n`, groups are transparent.\n   * - `'xml'` — each section wrapped in `<id>...</id>` tags, groups\n   *   wrapped in `<id>...</id>` containing their children.\n   */\n  format?: PromptFormat;\n}\n\n/**\n * Declarative, composable prompt builder.\n *\n * Prompts are composed from discrete {@link PromptSection}s that are\n * independently testable pure functions. The builder handles ordering,\n * conditional inclusion, and final assembly.\n *\n * @example\n * ```ts\n * const prompt = new PromptBuilder()\n *   .use(identitySection)\n *   .use(rulesSection)\n *   .use(featureSection)\n *   .build(ctx);\n * ```\n */\nexport class PromptBuilder<TCtx extends PromptContext = PromptContext> {\n  private nodes: PromptNode<TCtx>[] = [];\n\n  /**\n   * Add a section to the prompt.\n   *\n   * If a section with the same `id` already exists, it is replaced.\n   * This makes `.use()` idempotent — you can safely call it multiple\n   * times with the same section without creating duplicates.\n   */\n  use(section: PromptSection<TCtx>): this {\n    const idx = this.nodes.findIndex((n) => !isOneOf(n) && n.id === section.id);\n    if (idx >= 0) {\n      this.nodes[idx] = section;\n    } else {\n      this.nodes.push(section);\n    }\n    return this;\n  }\n\n  /**\n   * Add mutually exclusive sections. The first candidate that renders\n   * a non-empty string wins — the rest are excluded.\n   *\n   * @example\n   * ```ts\n   * builder.useOneOf(activeTasks, noActiveTasks)\n   * ```\n   */\n  useOneOf(...candidates: PromptSection<TCtx>[]): this {\n    this.nodes.push({ candidates });\n    return this;\n  }\n\n  /**\n   * Add a named group of sections. In `xml` format, children are\n   * wrapped in `<id>...</id>`. In `text` format, groups are transparent\n   * and children render as if they were top-level sections.\n   *\n   * @example\n   * ```ts\n   * builder.group('tools', b => b\n   *   .use(bashSection)\n   *   .use(gitSection)\n   * )\n   * ```\n   */\n  group(id: string, configure: (builder: PromptBuilder<TCtx>) => void): this {\n    const inner = new PromptBuilder<TCtx>();\n    configure(inner);\n    const group: PromptGroup<TCtx> = { id, children: inner.nodes };\n    const idx = this.nodes.findIndex((n) => !isOneOf(n) && n.id === id);\n    if (idx >= 0) {\n      this.nodes[idx] = group;\n    } else {\n      this.nodes.push(group);\n    }\n    return this;\n  }\n\n  /** Remove a section or group. Accepts an id string or an object with `id`. Searches recursively into groups and oneOf candidates. */\n  without(ref: string | { id: string }): this {\n    const id = typeof ref === 'string' ? ref : ref.id;\n    this.nodes = this.removeNode(this.nodes, id);\n    return this;\n  }\n\n  /** Check if a section or group exists. Accepts an id string or an object with `id`. Searches recursively into groups and oneOf candidates. */\n  has(ref: string | { id: string }): boolean {\n    const id = typeof ref === 'string' ? ref : ref.id;\n    return this.hasNode(this.nodes, id);\n  }\n\n  /** Get all ids (sections, groups, and oneOf candidates) in order. */\n  ids(): string[] {\n    return this.collectIds(this.nodes);\n  }\n\n  /**\n   * Create an independent copy of this builder.\n   *\n   * Use this to create mode-specific or model-specific variants\n   * without mutating the base builder.\n   *\n   * @example\n   * ```ts\n   * const base = new PromptBuilder().use(a).use(b);\n   * const variant = base.fork().use(c); // base is unchanged\n   * ```\n   */\n  fork(): PromptBuilder<TCtx> {\n    const forked = new PromptBuilder<TCtx>();\n    forked.nodes = this.deepCopy(this.nodes);\n    return forked;\n  }\n\n  /**\n   * Build the final prompt string.\n   *\n   * 1. Filters out sections whose `when` guard returns false\n   * 2. Renders each section\n   * 3. Filters out empty strings\n   * 4. Joins with separator and trims\n   *\n   * Pass `{ format: 'xml' }` to wrap each section in `<id>` tags.\n   */\n  build(ctx: TCtx, options?: BuildOptions): string {\n    return this.buildWithMeta(ctx, options).prompt;\n  }\n\n  /**\n   * Build the prompt and return metadata about which sections were\n   * included/excluded. Useful for debugging and logging.\n   *\n   * A section is \"excluded\" if its `when` guard returns false.\n   * A section is \"included\" only if it passes the guard and renders\n   * a non-empty string.\n   */\n  buildWithMeta(\n    ctx: TCtx,\n    options?: BuildOptions,\n  ): {\n    prompt: string;\n    included: string[];\n    excluded: string[];\n  } {\n    const included: string[] = [];\n    const excluded: string[] = [];\n    const format = options?.format ?? 'text';\n\n    const parts = this.renderNodes(this.nodes, ctx, format, included, excluded);\n    const prompt = parts.join('\\n\\n').trim();\n\n    return { prompt, included, excluded };\n  }\n\n  // --- Private ---\n\n  private renderNodes(\n    nodes: PromptNode<TCtx>[],\n    ctx: TCtx,\n    format: PromptFormat,\n    included: string[],\n    excluded: string[],\n  ): string[] {\n    const parts: string[] = [];\n\n    for (const node of nodes) {\n      if (isSection(node)) {\n        this.renderSection(node, ctx, format, parts, included, excluded);\n      } else if (isGroup(node)) {\n        const childParts = this.renderNodes(node.children, ctx, format, included, excluded);\n        if (childParts.length > 0) {\n          parts.push(...this.formatGroup(node.id, childParts, format));\n        }\n      } else {\n        this.renderOneOf(node, ctx, format, parts, included, excluded);\n      }\n    }\n\n    return parts;\n  }\n\n  private renderSection(\n    section: PromptSection<TCtx>,\n    ctx: TCtx,\n    format: PromptFormat,\n    parts: string[],\n    included: string[],\n    excluded: string[],\n  ): boolean {\n    if (section.when && !section.when(ctx)) {\n      excluded.push(section.id);\n      return false;\n    }\n    const output = section.render(ctx);\n    if (output) {\n      included.push(section.id);\n      parts.push(this.formatSection(section.id, output, format));\n      return true;\n    }\n    excluded.push(section.id);\n    return false;\n  }\n\n  private renderOneOf(\n    node: PromptOneOf<TCtx>,\n    ctx: TCtx,\n    format: PromptFormat,\n    parts: string[],\n    included: string[],\n    excluded: string[],\n  ): void {\n    let found = false;\n    for (const candidate of node.candidates) {\n      if (found) {\n        excluded.push(candidate.id);\n        continue;\n      }\n      if (this.renderSection(candidate, ctx, format, parts, included, excluded)) {\n        found = true;\n      }\n    }\n  }\n\n  /** Wrap a single section's rendered content according to the output format. */\n  private formatSection(id: string, content: string, format: PromptFormat): string {\n    switch (format) {\n      case 'text':\n        return content;\n      case 'xml':\n        return `<${id}>\\n${content}\\n</${id}>`;\n      default:\n        return assertNever(format);\n    }\n  }\n\n  /**\n   * Wrap a group's rendered children according to the output format.\n   * Returns an array — in text mode the children are spread inline,\n   * in xml mode they are joined and wrapped in a single entry.\n   */\n  private formatGroup(id: string, childParts: string[], format: PromptFormat): string[] {\n    switch (format) {\n      case 'text':\n        return childParts;\n      case 'xml':\n        return [`<${id}>\\n${childParts.join('\\n\\n')}\\n</${id}>`];\n      default:\n        return assertNever(format);\n    }\n  }\n\n  private hasNode(nodes: PromptNode<TCtx>[], id: string): boolean {\n    for (const node of nodes) {\n      if (isSection(node)) {\n        if (node.id === id) return true;\n      } else if (isGroup(node)) {\n        if (node.id === id) return true;\n        if (this.hasNode(node.children, id)) return true;\n      } else {\n        for (const c of node.candidates) {\n          if (c.id === id) return true;\n        }\n      }\n    }\n    return false;\n  }\n\n  private removeNode(nodes: PromptNode<TCtx>[], id: string): PromptNode<TCtx>[] {\n    const result: PromptNode<TCtx>[] = [];\n    for (const n of nodes) {\n      if (isSection(n)) {\n        if (n.id !== id) result.push(n);\n      } else if (isGroup(n)) {\n        if (n.id !== id) {\n          result.push({ ...n, children: this.removeNode(n.children, id) });\n        }\n      } else {\n        const remaining = n.candidates.filter((c) => c.id !== id);\n        if (remaining.length > 0) {\n          result.push({ candidates: remaining });\n        }\n      }\n    }\n    return result;\n  }\n\n  private collectIds(nodes: PromptNode<TCtx>[]): string[] {\n    const ids: string[] = [];\n    for (const node of nodes) {\n      if (isSection(node)) {\n        ids.push(node.id);\n      } else if (isGroup(node)) {\n        ids.push(node.id);\n        ids.push(...this.collectIds(node.children));\n      } else {\n        ids.push(...node.candidates.map((c) => c.id));\n      }\n    }\n    return ids;\n  }\n\n  private deepCopy(nodes: PromptNode<TCtx>[]): PromptNode<TCtx>[] {\n    return nodes.map((n) => {\n      if (isGroup(n)) {\n        return { ...n, children: this.deepCopy(n.children) };\n      }\n      if (isOneOf(n)) {\n        return { candidates: [...n.candidates] };\n      }\n      return n;\n    });\n  }\n}\n","import type { PromptContext, PromptSection } from './types';\n\n/**\n * Create a prompt section. Return a string to include, `null` to exclude.\n *\n * @example\n * ```ts\n * // Static\n * section('identity', () => 'You are Coworker.')\n *\n * // Conditional — return null to exclude\n * section('prod', (ctx: SandboxCtx) => {\n *   if (ctx.vars.prodContext == null) return null;\n *   return `## Prod\\n\\n${ctx.vars.prodContext}`;\n * })\n * ```\n */\nexport function section<TCtx extends PromptContext = PromptContext>(\n  id: string,\n  render: (ctx: TCtx) => string | null,\n): PromptSection<TCtx> {\n  return {\n    id,\n    render: (ctx) => render(ctx) ?? '',\n  };\n}\n"]}

package/dist/index.d.cts

@@ -1,5 +1,18 @@
-import { P as PromptContext, a as PromptSection } from './types-DXgCksVT.cjs';
+import { P as PromptContext, a as PromptSection } from './types--sRnfw6Q.cjs';
 
+/** Supported output formats for prompt rendering. */
+type PromptFormat = 'text' | 'xml';
+/** Options for {@link PromptBuilder.build} and {@link PromptBuilder.buildWithMeta}. */
+interface BuildOptions {
+    /**
+     * Output format.
+     *
+     * - `'text'` (default) — sections joined with `\n\n`, groups are transparent.
+     * - `'xml'` — each section wrapped in `<id>...</id>` tags, groups
+     *   wrapped in `<id>...</id>` containing their children.
+     */
+    format?: PromptFormat;
+}
 /**
  * Declarative, composable prompt builder.
  *
@@ -16,8 +29,8 @@ import { P as PromptContext, a as PromptSection } from './types-DXgCksVT.cjs';
  *   .build(ctx);
  * ```
  */
-declare class PromptBuilder<TCtx extends PromptContext<Record<string, boolean>, Record<string, unknown>>> {
-    private sections;
+declare class PromptBuilder<TCtx extends PromptContext = PromptContext> {
+    private nodes;
     /**
      * Add a section to the prompt.
      *
@@ -26,15 +39,39 @@ declare class PromptBuilder<TCtx extends PromptContext<Record<string, boolean>,
      * times with the same section without creating duplicates.
      */
     use(section: PromptSection<TCtx>): this;
-    /** Remove a section. Accepts an id string or a section object. */
+    /**
+     * Add mutually exclusive sections. The first candidate that renders
+     * a non-empty string wins — the rest are excluded.
+     *
+     * @example
+     * ```ts
+     * builder.useOneOf(activeTasks, noActiveTasks)
+     * ```
+     */
+    useOneOf(...candidates: PromptSection<TCtx>[]): this;
+    /**
+     * Add a named group of sections. In `xml` format, children are
+     * wrapped in `<id>...</id>`. In `text` format, groups are transparent
+     * and children render as if they were top-level sections.
+     *
+     * @example
+     * ```ts
+     * builder.group('tools', b => b
+     *   .use(bashSection)
+     *   .use(gitSection)
+     * )
+     * ```
+     */
+    group(id: string, configure: (builder: PromptBuilder<TCtx>) => void): this;
+    /** Remove a section or group. Accepts an id string or an object with `id`. Searches recursively into groups and oneOf candidates. */
     without(ref: string | {
         id: string;
     }): this;
-    /** Check if a section exists. Accepts an id string or a section object. */
+    /** Check if a section or group exists. Accepts an id string or an object with `id`. Searches recursively into groups and oneOf candidates. */
     has(ref: string | {
         id: string;
     }): boolean;
-    /** Get the ids of all registered sections (in insertion order). */
+    /** Get all ids (sections, groups, and oneOf candidates) in order. */
     ids(): string[];
     /**
      * Create an independent copy of this builder.
@@ -56,8 +93,10 @@ declare class PromptBuilder<TCtx extends PromptContext<Record<string, boolean>,
      * 2. Renders each section
      * 3. Filters out empty strings
      * 4. Joins with separator and trims
+     *
+     * Pass `{ format: 'xml' }` to wrap each section in `<id>` tags.
      */
-    build(ctx: TCtx): string;
+    build(ctx: TCtx, options?: BuildOptions): string;
     /**
      * Build the prompt and return metadata about which sections were
      * included/excluded. Useful for debugging and logging.
@@ -66,11 +105,43 @@ declare class PromptBuilder<TCtx extends PromptContext<Record<string, boolean>,
      * A section is "included" only if it passes the guard and renders
      * a non-empty string.
      */
-    buildWithMeta(ctx: TCtx): {
+    buildWithMeta(ctx: TCtx, options?: BuildOptions): {
         prompt: string;
         included: string[];
         excluded: string[];
     };
+    private renderNodes;
+    private renderSection;
+    private renderOneOf;
+    /** Wrap a single section's rendered content according to the output format. */
+    private formatSection;
+    /**
+     * Wrap a group's rendered children according to the output format.
+     * Returns an array — in text mode the children are spread inline,
+     * in xml mode they are joined and wrapped in a single entry.
+     */
+    private formatGroup;
+    private hasNode;
+    private removeNode;
+    private collectIds;
+    private deepCopy;
 }
 
-export { PromptBuilder, PromptContext, PromptSection };
+/**
+ * Create a prompt section. Return a string to include, `null` to exclude.
+ *
+ * @example
+ * ```ts
+ * // Static
+ * section('identity', () => 'You are Coworker.')
+ *
+ * // Conditional — return null to exclude
+ * section('prod', (ctx: SandboxCtx) => {
+ *   if (ctx.vars.prodContext == null) return null;
+ *   return `## Prod\n\n${ctx.vars.prodContext}`;
+ * })
+ * ```
+ */
+declare function section<TCtx extends PromptContext = PromptContext>(id: string, render: (ctx: TCtx) => string | null): PromptSection<TCtx>;
+
+export { type BuildOptions, PromptBuilder, PromptContext, type PromptFormat, PromptSection, section };

package/dist/index.d.ts

@@ -1,5 +1,18 @@
-import { P as PromptContext, a as PromptSection } from './types-DXgCksVT.js';
+import { P as PromptContext, a as PromptSection } from './types--sRnfw6Q.js';
 
+/** Supported output formats for prompt rendering. */
+type PromptFormat = 'text' | 'xml';
+/** Options for {@link PromptBuilder.build} and {@link PromptBuilder.buildWithMeta}. */
+interface BuildOptions {
+    /**
+     * Output format.
+     *
+     * - `'text'` (default) — sections joined with `\n\n`, groups are transparent.
+     * - `'xml'` — each section wrapped in `<id>...</id>` tags, groups
+     *   wrapped in `<id>...</id>` containing their children.
+     */
+    format?: PromptFormat;
+}
 /**
  * Declarative, composable prompt builder.
  *
@@ -16,8 +29,8 @@ import { P as PromptContext, a as PromptSection } from './types-DXgCksVT.js';
  *   .build(ctx);
  * ```
  */
-declare class PromptBuilder<TCtx extends PromptContext<Record<string, boolean>, Record<string, unknown>>> {
-    private sections;
+declare class PromptBuilder<TCtx extends PromptContext = PromptContext> {
+    private nodes;
     /**
      * Add a section to the prompt.
      *
@@ -26,15 +39,39 @@ declare class PromptBuilder<TCtx extends PromptContext<Record<string, boolean>,
      * times with the same section without creating duplicates.
      */
     use(section: PromptSection<TCtx>): this;
-    /** Remove a section. Accepts an id string or a section object. */
+    /**
+     * Add mutually exclusive sections. The first candidate that renders
+     * a non-empty string wins — the rest are excluded.
+     *
+     * @example
+     * ```ts
+     * builder.useOneOf(activeTasks, noActiveTasks)
+     * ```
+     */
+    useOneOf(...candidates: PromptSection<TCtx>[]): this;
+    /**
+     * Add a named group of sections. In `xml` format, children are
+     * wrapped in `<id>...</id>`. In `text` format, groups are transparent
+     * and children render as if they were top-level sections.
+     *
+     * @example
+     * ```ts
+     * builder.group('tools', b => b
+     *   .use(bashSection)
+     *   .use(gitSection)
+     * )
+     * ```
+     */
+    group(id: string, configure: (builder: PromptBuilder<TCtx>) => void): this;
+    /** Remove a section or group. Accepts an id string or an object with `id`. Searches recursively into groups and oneOf candidates. */
     without(ref: string | {
         id: string;
     }): this;
-    /** Check if a section exists. Accepts an id string or a section object. */
+    /** Check if a section or group exists. Accepts an id string or an object with `id`. Searches recursively into groups and oneOf candidates. */
     has(ref: string | {
         id: string;
     }): boolean;
-    /** Get the ids of all registered sections (in insertion order). */
+    /** Get all ids (sections, groups, and oneOf candidates) in order. */
     ids(): string[];
     /**
      * Create an independent copy of this builder.
@@ -56,8 +93,10 @@ declare class PromptBuilder<TCtx extends PromptContext<Record<string, boolean>,
      * 2. Renders each section
      * 3. Filters out empty strings
      * 4. Joins with separator and trims
+     *
+     * Pass `{ format: 'xml' }` to wrap each section in `<id>` tags.
      */
-    build(ctx: TCtx): string;
+    build(ctx: TCtx, options?: BuildOptions): string;
     /**
      * Build the prompt and return metadata about which sections were
      * included/excluded. Useful for debugging and logging.
@@ -66,11 +105,43 @@ declare class PromptBuilder<TCtx extends PromptContext<Record<string, boolean>,
      * A section is "included" only if it passes the guard and renders
      * a non-empty string.
      */
-    buildWithMeta(ctx: TCtx): {
+    buildWithMeta(ctx: TCtx, options?: BuildOptions): {
         prompt: string;
         included: string[];
         excluded: string[];
     };
+    private renderNodes;
+    private renderSection;
+    private renderOneOf;
+    /** Wrap a single section's rendered content according to the output format. */
+    private formatSection;
+    /**
+     * Wrap a group's rendered children according to the output format.
+     * Returns an array — in text mode the children are spread inline,
+     * in xml mode they are joined and wrapped in a single entry.
+     */
+    private formatGroup;
+    private hasNode;
+    private removeNode;
+    private collectIds;
+    private deepCopy;
 }
 
-export { PromptBuilder, PromptContext, PromptSection };
+/**
+ * Create a prompt section. Return a string to include, `null` to exclude.
+ *
+ * @example
+ * ```ts
+ * // Static
+ * section('identity', () => 'You are Coworker.')
+ *
+ * // Conditional — return null to exclude
+ * section('prod', (ctx: SandboxCtx) => {
+ *   if (ctx.vars.prodContext == null) return null;
+ *   return `## Prod\n\n${ctx.vars.prodContext}`;
+ * })
+ * ```
+ */
+declare function section<TCtx extends PromptContext = PromptContext>(id: string, render: (ctx: TCtx) => string | null): PromptSection<TCtx>;
+
+export { type BuildOptions, PromptBuilder, PromptContext, type PromptFormat, PromptSection, section };

package/dist/index.js

@@ -1,6 +1,18 @@
 // src/builder.ts
+function assertNever(value) {
+  throw new Error(`Unexpected format: ${value}`);
+}
+function isSection(node) {
+  return "render" in node;
+}
+function isGroup(node) {
+  return "children" in node;
+}
+function isOneOf(node) {
+  return "candidates" in node;
+}
 var PromptBuilder = class _PromptBuilder {
-  sections = [];
+  nodes = [];
   /**
    * Add a section to the prompt.
    *
@@ -8,29 +20,67 @@ var PromptBuilder = class _PromptBuilder {
    * This makes `.use()` idempotent — you can safely call it multiple
    * times with the same section without creating duplicates.
    */
-  use(section) {
-    const existingIdx = this.sections.findIndex((s) => s.id === section.id);
-    if (existingIdx >= 0) {
-      this.sections[existingIdx] = section;
+  use(section2) {
+    const idx = this.nodes.findIndex((n) => !isOneOf(n) && n.id === section2.id);
+    if (idx >= 0) {
+      this.nodes[idx] = section2;
     } else {
-      this.sections.push(section);
+      this.nodes.push(section2);
     }
     return this;
   }
-  /** Remove a section. Accepts an id string or a section object. */
+  /**
+   * Add mutually exclusive sections. The first candidate that renders
+   * a non-empty string wins — the rest are excluded.
+   *
+   * @example
+   * ```ts
+   * builder.useOneOf(activeTasks, noActiveTasks)
+   * ```
+   */
+  useOneOf(...candidates) {
+    this.nodes.push({ candidates });
+    return this;
+  }
+  /**
+   * Add a named group of sections. In `xml` format, children are
+   * wrapped in `<id>...</id>`. In `text` format, groups are transparent
+   * and children render as if they were top-level sections.
+   *
+   * @example
+   * ```ts
+   * builder.group('tools', b => b
+   *   .use(bashSection)
+   *   .use(gitSection)
+   * )
+   * ```
+   */
+  group(id, configure) {
+    const inner = new _PromptBuilder();
+    configure(inner);
+    const group = { id, children: inner.nodes };
+    const idx = this.nodes.findIndex((n) => !isOneOf(n) && n.id === id);
+    if (idx >= 0) {
+      this.nodes[idx] = group;
+    } else {
+      this.nodes.push(group);
+    }
+    return this;
+  }
+  /** Remove a section or group. Accepts an id string or an object with `id`. Searches recursively into groups and oneOf candidates. */
   without(ref) {
     const id = typeof ref === "string" ? ref : ref.id;
-    this.sections = this.sections.filter((s) => s.id !== id);
+    this.nodes = this.removeNode(this.nodes, id);
     return this;
   }
-  /** Check if a section exists. Accepts an id string or a section object. */
+  /** Check if a section or group exists. Accepts an id string or an object with `id`. Searches recursively into groups and oneOf candidates. */
   has(ref) {
     const id = typeof ref === "string" ? ref : ref.id;
-    return this.sections.some((s) => s.id === id);
+    return this.hasNode(this.nodes, id);
   }
-  /** Get the ids of all registered sections (in insertion order). */
+  /** Get all ids (sections, groups, and oneOf candidates) in order. */
   ids() {
-    return this.sections.map((s) => s.id);
+    return this.collectIds(this.nodes);
   }
   /**
    * Create an independent copy of this builder.
@@ -46,7 +96,7 @@ var PromptBuilder = class _PromptBuilder {
    */
   fork() {
     const forked = new _PromptBuilder();
-    forked.sections = [...this.sections];
+    forked.nodes = this.deepCopy(this.nodes);
     return forked;
   }
   /**
@@ -56,9 +106,11 @@ var PromptBuilder = class _PromptBuilder {
    * 2. Renders each section
    * 3. Filters out empty strings
    * 4. Joins with separator and trims
+   *
+   * Pass `{ format: 'xml' }` to wrap each section in `<id>` tags.
    */
-  build(ctx) {
-    return this.buildWithMeta(ctx).prompt;
+  build(ctx, options) {
+    return this.buildWithMeta(ctx, options).prompt;
   }
   /**
    * Build the prompt and return metadata about which sections were
@@ -68,28 +120,156 @@ var PromptBuilder = class _PromptBuilder {
    * A section is "included" only if it passes the guard and renders
    * a non-empty string.
    */
-  buildWithMeta(ctx) {
+  buildWithMeta(ctx, options) {
     const included = [];
     const excluded = [];
-    const rendered = this.sections.filter((s) => {
-      if (s.when && !s.when(ctx)) {
-        excluded.push(s.id);
-        return false;
+    const format = options?.format ?? "text";
+    const parts = this.renderNodes(this.nodes, ctx, format, included, excluded);
+    const prompt = parts.join("\n\n").trim();
+    return { prompt, included, excluded };
+  }
+  // --- Private ---
+  renderNodes(nodes, ctx, format, included, excluded) {
+    const parts = [];
+    for (const node of nodes) {
+      if (isSection(node)) {
+        this.renderSection(node, ctx, format, parts, included, excluded);
+      } else if (isGroup(node)) {
+        const childParts = this.renderNodes(node.children, ctx, format, included, excluded);
+        if (childParts.length > 0) {
+          parts.push(...this.formatGroup(node.id, childParts, format));
+        }
+      } else {
+        this.renderOneOf(node, ctx, format, parts, included, excluded);
       }
+    }
+    return parts;
+  }
+  renderSection(section2, ctx, format, parts, included, excluded) {
+    if (section2.when && !section2.when(ctx)) {
+      excluded.push(section2.id);
+      return false;
+    }
+    const output = section2.render(ctx);
+    if (output) {
+      included.push(section2.id);
+      parts.push(this.formatSection(section2.id, output, format));
       return true;
-    }).map((s) => {
-      const output = s.render(ctx);
-      if (output) {
-        included.push(s.id);
+    }
+    excluded.push(section2.id);
+    return false;
+  }
+  renderOneOf(node, ctx, format, parts, included, excluded) {
+    let found = false;
+    for (const candidate of node.candidates) {
+      if (found) {
+        excluded.push(candidate.id);
+        continue;
+      }
+      if (this.renderSection(candidate, ctx, format, parts, included, excluded)) {
+        found = true;
+      }
+    }
+  }
+  /** Wrap a single section's rendered content according to the output format. */
+  formatSection(id, content, format) {
+    switch (format) {
+      case "text":
+        return content;
+      case "xml":
+        return `<${id}>
+${content}
+</${id}>`;
+      default:
+        return assertNever(format);
+    }
+  }
+  /**
+   * Wrap a group's rendered children according to the output format.
+   * Returns an array — in text mode the children are spread inline,
+   * in xml mode they are joined and wrapped in a single entry.
+   */
+  formatGroup(id, childParts, format) {
+    switch (format) {
+      case "text":
+        return childParts;
+      case "xml":
+        return [`<${id}>
+${childParts.join("\n\n")}
+</${id}>`];
+      default:
+        return assertNever(format);
+    }
+  }
+  hasNode(nodes, id) {
+    for (const node of nodes) {
+      if (isSection(node)) {
+        if (node.id === id) return true;
+      } else if (isGroup(node)) {
+        if (node.id === id) return true;
+        if (this.hasNode(node.children, id)) return true;
       } else {
-        excluded.push(s.id);
+        for (const c of node.candidates) {
+          if (c.id === id) return true;
+        }
+      }
+    }
+    return false;
+  }
+  removeNode(nodes, id) {
+    const result = [];
+    for (const n of nodes) {
+      if (isSection(n)) {
+        if (n.id !== id) result.push(n);
+      } else if (isGroup(n)) {
+        if (n.id !== id) {
+          result.push({ ...n, children: this.removeNode(n.children, id) });
+        }
+      } else {
+        const remaining = n.candidates.filter((c) => c.id !== id);
+        if (remaining.length > 0) {
+          result.push({ candidates: remaining });
+        }
+      }
+    }
+    return result;
+  }
+  collectIds(nodes) {
+    const ids = [];
+    for (const node of nodes) {
+      if (isSection(node)) {
+        ids.push(node.id);
+      } else if (isGroup(node)) {
+        ids.push(node.id);
+        ids.push(...this.collectIds(node.children));
+      } else {
+        ids.push(...node.candidates.map((c) => c.id));
+      }
+    }
+    return ids;
+  }
+  deepCopy(nodes) {
+    return nodes.map((n) => {
+      if (isGroup(n)) {
+        return { ...n, children: this.deepCopy(n.children) };
+      }
+      if (isOneOf(n)) {
+        return { candidates: [...n.candidates] };
       }
-      return output;
-    }).filter(Boolean).join("\n\n").trim();
-    return { prompt: rendered, included, excluded };
+      return n;
+    });
   }
 };
+
+// src/section.ts
+function section(id, render) {
+  return {
+    id,
+    render: (ctx) => render(ctx) ?? ""
+  };
+}
 export {
-  PromptBuilder
+  PromptBuilder,
+  section
 };
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/builder.ts"],"sourcesContent":["import type { PromptContext, PromptSection } from './types';\n\n/**\n * Declarative, composable prompt builder.\n *\n * Prompts are composed from discrete {@link PromptSection}s that are\n * independently testable pure functions. The builder handles ordering,\n * conditional inclusion, and final assembly.\n *\n * @example\n * ```ts\n * const prompt = new PromptBuilder()\n *   .use(identitySection)\n *   .use(rulesSection)\n *   .use(featureSection)\n *   .build(ctx);\n * ```\n */\nexport class PromptBuilder<\n  TCtx extends PromptContext<Record<string, boolean>, Record<string, unknown>>,\n> {\n  private sections: PromptSection<TCtx>[] = [];\n\n  /**\n   * Add a section to the prompt.\n   *\n   * If a section with the same `id` already exists, it is replaced.\n   * This makes `.use()` idempotent — you can safely call it multiple\n   * times with the same section without creating duplicates.\n   */\n  use(section: PromptSection<TCtx>): this {\n    const existingIdx = this.sections.findIndex((s) => s.id === section.id);\n    if (existingIdx >= 0) {\n      this.sections[existingIdx] = section;\n    } else {\n      this.sections.push(section);\n    }\n    return this;\n  }\n\n  /** Remove a section. Accepts an id string or a section object. */\n  without(ref: string | { id: string }): this {\n    const id = typeof ref === 'string' ? ref : ref.id;\n    this.sections = this.sections.filter((s) => s.id !== id);\n    return this;\n  }\n\n  /** Check if a section exists. Accepts an id string or a section object. */\n  has(ref: string | { id: string }): boolean {\n    const id = typeof ref === 'string' ? ref : ref.id;\n    return this.sections.some((s) => s.id === id);\n  }\n\n  /** Get the ids of all registered sections (in insertion order). */\n  ids(): string[] {\n    return this.sections.map((s) => s.id);\n  }\n\n  /**\n   * Create an independent copy of this builder.\n   *\n   * Use this to create mode-specific or model-specific variants\n   * without mutating the base builder.\n   *\n   * @example\n   * ```ts\n   * const base = new PromptBuilder().use(a).use(b);\n   * const variant = base.fork().use(c); // base is unchanged\n   * ```\n   */\n  fork(): PromptBuilder<TCtx> {\n    const forked = new PromptBuilder<TCtx>();\n    forked.sections = [...this.sections];\n    return forked;\n  }\n\n  /**\n   * Build the final prompt string.\n   *\n   * 1. Filters out sections whose `when` guard returns false\n   * 2. Renders each section\n   * 3. Filters out empty strings\n   * 4. Joins with separator and trims\n   */\n  build(ctx: TCtx): string {\n    return this.buildWithMeta(ctx).prompt;\n  }\n\n  /**\n   * Build the prompt and return metadata about which sections were\n   * included/excluded. Useful for debugging and logging.\n   *\n   * A section is \"excluded\" if its `when` guard returns false.\n   * A section is \"included\" only if it passes the guard and renders\n   * a non-empty string.\n   */\n  buildWithMeta(ctx: TCtx): {\n    prompt: string;\n    included: string[];\n    excluded: string[];\n  } {\n    const included: string[] = [];\n    const excluded: string[] = [];\n\n    const rendered = this.sections\n      .filter((s) => {\n        if (s.when && !s.when(ctx)) {\n          excluded.push(s.id);\n          return false;\n        }\n        return true;\n      })\n      .map((s) => {\n        const output = s.render(ctx);\n        if (output) {\n          included.push(s.id);\n        } else {\n          excluded.push(s.id);\n        }\n        return output;\n      })\n      .filter(Boolean)\n      .join('\\n\\n')\n      .trim();\n\n    return { prompt: rendered, included, excluded };\n  }\n}\n"],"mappings":";AAkBO,IAAM,gBAAN,MAAM,eAEX;AAAA,EACQ,WAAkC,CAAC;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAS3C,IAAI,SAAoC;AACtC,UAAM,cAAc,KAAK,SAAS,UAAU,CAAC,MAAM,EAAE,OAAO,QAAQ,EAAE;AACtE,QAAI,eAAe,GAAG;AACpB,WAAK,SAAS,WAAW,IAAI;AAAA,IAC/B,OAAO;AACL,WAAK,SAAS,KAAK,OAAO;AAAA,IAC5B;AACA,WAAO;AAAA,EACT;AAAA;AAAA,EAGA,QAAQ,KAAoC;AAC1C,UAAM,KAAK,OAAO,QAAQ,WAAW,MAAM,IAAI;AAC/C,SAAK,WAAW,KAAK,SAAS,OAAO,CAAC,MAAM,EAAE,OAAO,EAAE;AACvD,WAAO;AAAA,EACT;AAAA;AAAA,EAGA,IAAI,KAAuC;AACzC,UAAM,KAAK,OAAO,QAAQ,WAAW,MAAM,IAAI;AAC/C,WAAO,KAAK,SAAS,KAAK,CAAC,MAAM,EAAE,OAAO,EAAE;AAAA,EAC9C;AAAA;AAAA,EAGA,MAAgB;AACd,WAAO,KAAK,SAAS,IAAI,CAAC,MAAM,EAAE,EAAE;AAAA,EACtC;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAcA,OAA4B;AAC1B,UAAM,SAAS,IAAI,eAAoB;AACvC,WAAO,WAAW,CAAC,GAAG,KAAK,QAAQ;AACnC,WAAO;AAAA,EACT;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAUA,MAAM,KAAmB;AACvB,WAAO,KAAK,cAAc,GAAG,EAAE;AAAA,EACjC;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAUA,cAAc,KAIZ;AACA,UAAM,WAAqB,CAAC;AAC5B,UAAM,WAAqB,CAAC;AAE5B,UAAM,WAAW,KAAK,SACnB,OAAO,CAAC,MAAM;AACb,UAAI,EAAE,QAAQ,CAAC,EAAE,KAAK,GAAG,GAAG;AAC1B,iBAAS,KAAK,EAAE,EAAE;AAClB,eAAO;AAAA,MACT;AACA,aAAO;AAAA,IACT,CAAC,EACA,IAAI,CAAC,MAAM;AACV,YAAM,SAAS,EAAE,OAAO,GAAG;AAC3B,UAAI,QAAQ;AACV,iBAAS,KAAK,EAAE,EAAE;AAAA,MACpB,OAAO;AACL,iBAAS,KAAK,EAAE,EAAE;AAAA,MACpB;AACA,aAAO;AAAA,IACT,CAAC,EACA,OAAO,OAAO,EACd,KAAK,MAAM,EACX,KAAK;AAER,WAAO,EAAE,QAAQ,UAAU,UAAU,SAAS;AAAA,EAChD;AACF;","names":[]}
+{"version":3,"sources":["../src/builder.ts","../src/section.ts"],"sourcesContent":["import type { PromptContext, PromptSection } from './types';\n\nfunction assertNever(value: never): never {\n  throw new Error(`Unexpected format: ${value}`);\n}\n\n/**\n * A named group of prompt nodes, rendered as an XML wrapper\n * in `xml` format and transparently in `text` format.\n */\ninterface PromptGroup<TCtx extends PromptContext> {\n  id: string;\n  children: PromptNode<TCtx>[];\n}\n\n/** Mutually exclusive sections — the first candidate that renders wins. */\ninterface PromptOneOf<TCtx extends PromptContext> {\n  candidates: PromptSection<TCtx>[];\n}\n\ntype PromptNode<TCtx extends PromptContext> =\n  | PromptSection<TCtx>\n  | PromptGroup<TCtx>\n  | PromptOneOf<TCtx>;\n\nfunction isSection<TCtx extends PromptContext>(\n  node: PromptNode<TCtx>,\n): node is PromptSection<TCtx> {\n  return 'render' in node;\n}\n\nfunction isGroup<TCtx extends PromptContext>(node: PromptNode<TCtx>): node is PromptGroup<TCtx> {\n  return 'children' in node;\n}\n\nfunction isOneOf<TCtx extends PromptContext>(node: PromptNode<TCtx>): node is PromptOneOf<TCtx> {\n  return 'candidates' in node;\n}\n\n/** Supported output formats for prompt rendering. */\nexport type PromptFormat = 'text' | 'xml';\n\n/** Options for {@link PromptBuilder.build} and {@link PromptBuilder.buildWithMeta}. */\nexport interface BuildOptions {\n  /**\n   * Output format.\n   *\n   * - `'text'` (default) — sections joined with `\\n\\n`, groups are transparent.\n   * - `'xml'` — each section wrapped in `<id>...</id>` tags, groups\n   *   wrapped in `<id>...</id>` containing their children.\n   */\n  format?: PromptFormat;\n}\n\n/**\n * Declarative, composable prompt builder.\n *\n * Prompts are composed from discrete {@link PromptSection}s that are\n * independently testable pure functions. The builder handles ordering,\n * conditional inclusion, and final assembly.\n *\n * @example\n * ```ts\n * const prompt = new PromptBuilder()\n *   .use(identitySection)\n *   .use(rulesSection)\n *   .use(featureSection)\n *   .build(ctx);\n * ```\n */\nexport class PromptBuilder<TCtx extends PromptContext = PromptContext> {\n  private nodes: PromptNode<TCtx>[] = [];\n\n  /**\n   * Add a section to the prompt.\n   *\n   * If a section with the same `id` already exists, it is replaced.\n   * This makes `.use()` idempotent — you can safely call it multiple\n   * times with the same section without creating duplicates.\n   */\n  use(section: PromptSection<TCtx>): this {\n    const idx = this.nodes.findIndex((n) => !isOneOf(n) && n.id === section.id);\n    if (idx >= 0) {\n      this.nodes[idx] = section;\n    } else {\n      this.nodes.push(section);\n    }\n    return this;\n  }\n\n  /**\n   * Add mutually exclusive sections. The first candidate that renders\n   * a non-empty string wins — the rest are excluded.\n   *\n   * @example\n   * ```ts\n   * builder.useOneOf(activeTasks, noActiveTasks)\n   * ```\n   */\n  useOneOf(...candidates: PromptSection<TCtx>[]): this {\n    this.nodes.push({ candidates });\n    return this;\n  }\n\n  /**\n   * Add a named group of sections. In `xml` format, children are\n   * wrapped in `<id>...</id>`. In `text` format, groups are transparent\n   * and children render as if they were top-level sections.\n   *\n   * @example\n   * ```ts\n   * builder.group('tools', b => b\n   *   .use(bashSection)\n   *   .use(gitSection)\n   * )\n   * ```\n   */\n  group(id: string, configure: (builder: PromptBuilder<TCtx>) => void): this {\n    const inner = new PromptBuilder<TCtx>();\n    configure(inner);\n    const group: PromptGroup<TCtx> = { id, children: inner.nodes };\n    const idx = this.nodes.findIndex((n) => !isOneOf(n) && n.id === id);\n    if (idx >= 0) {\n      this.nodes[idx] = group;\n    } else {\n      this.nodes.push(group);\n    }\n    return this;\n  }\n\n  /** Remove a section or group. Accepts an id string or an object with `id`. Searches recursively into groups and oneOf candidates. */\n  without(ref: string | { id: string }): this {\n    const id = typeof ref === 'string' ? ref : ref.id;\n    this.nodes = this.removeNode(this.nodes, id);\n    return this;\n  }\n\n  /** Check if a section or group exists. Accepts an id string or an object with `id`. Searches recursively into groups and oneOf candidates. */\n  has(ref: string | { id: string }): boolean {\n    const id = typeof ref === 'string' ? ref : ref.id;\n    return this.hasNode(this.nodes, id);\n  }\n\n  /** Get all ids (sections, groups, and oneOf candidates) in order. */\n  ids(): string[] {\n    return this.collectIds(this.nodes);\n  }\n\n  /**\n   * Create an independent copy of this builder.\n   *\n   * Use this to create mode-specific or model-specific variants\n   * without mutating the base builder.\n   *\n   * @example\n   * ```ts\n   * const base = new PromptBuilder().use(a).use(b);\n   * const variant = base.fork().use(c); // base is unchanged\n   * ```\n   */\n  fork(): PromptBuilder<TCtx> {\n    const forked = new PromptBuilder<TCtx>();\n    forked.nodes = this.deepCopy(this.nodes);\n    return forked;\n  }\n\n  /**\n   * Build the final prompt string.\n   *\n   * 1. Filters out sections whose `when` guard returns false\n   * 2. Renders each section\n   * 3. Filters out empty strings\n   * 4. Joins with separator and trims\n   *\n   * Pass `{ format: 'xml' }` to wrap each section in `<id>` tags.\n   */\n  build(ctx: TCtx, options?: BuildOptions): string {\n    return this.buildWithMeta(ctx, options).prompt;\n  }\n\n  /**\n   * Build the prompt and return metadata about which sections were\n   * included/excluded. Useful for debugging and logging.\n   *\n   * A section is \"excluded\" if its `when` guard returns false.\n   * A section is \"included\" only if it passes the guard and renders\n   * a non-empty string.\n   */\n  buildWithMeta(\n    ctx: TCtx,\n    options?: BuildOptions,\n  ): {\n    prompt: string;\n    included: string[];\n    excluded: string[];\n  } {\n    const included: string[] = [];\n    const excluded: string[] = [];\n    const format = options?.format ?? 'text';\n\n    const parts = this.renderNodes(this.nodes, ctx, format, included, excluded);\n    const prompt = parts.join('\\n\\n').trim();\n\n    return { prompt, included, excluded };\n  }\n\n  // --- Private ---\n\n  private renderNodes(\n    nodes: PromptNode<TCtx>[],\n    ctx: TCtx,\n    format: PromptFormat,\n    included: string[],\n    excluded: string[],\n  ): string[] {\n    const parts: string[] = [];\n\n    for (const node of nodes) {\n      if (isSection(node)) {\n        this.renderSection(node, ctx, format, parts, included, excluded);\n      } else if (isGroup(node)) {\n        const childParts = this.renderNodes(node.children, ctx, format, included, excluded);\n        if (childParts.length > 0) {\n          parts.push(...this.formatGroup(node.id, childParts, format));\n        }\n      } else {\n        this.renderOneOf(node, ctx, format, parts, included, excluded);\n      }\n    }\n\n    return parts;\n  }\n\n  private renderSection(\n    section: PromptSection<TCtx>,\n    ctx: TCtx,\n    format: PromptFormat,\n    parts: string[],\n    included: string[],\n    excluded: string[],\n  ): boolean {\n    if (section.when && !section.when(ctx)) {\n      excluded.push(section.id);\n      return false;\n    }\n    const output = section.render(ctx);\n    if (output) {\n      included.push(section.id);\n      parts.push(this.formatSection(section.id, output, format));\n      return true;\n    }\n    excluded.push(section.id);\n    return false;\n  }\n\n  private renderOneOf(\n    node: PromptOneOf<TCtx>,\n    ctx: TCtx,\n    format: PromptFormat,\n    parts: string[],\n    included: string[],\n    excluded: string[],\n  ): void {\n    let found = false;\n    for (const candidate of node.candidates) {\n      if (found) {\n        excluded.push(candidate.id);\n        continue;\n      }\n      if (this.renderSection(candidate, ctx, format, parts, included, excluded)) {\n        found = true;\n      }\n    }\n  }\n\n  /** Wrap a single section's rendered content according to the output format. */\n  private formatSection(id: string, content: string, format: PromptFormat): string {\n    switch (format) {\n      case 'text':\n        return content;\n      case 'xml':\n        return `<${id}>\\n${content}\\n</${id}>`;\n      default:\n        return assertNever(format);\n    }\n  }\n\n  /**\n   * Wrap a group's rendered children according to the output format.\n   * Returns an array — in text mode the children are spread inline,\n   * in xml mode they are joined and wrapped in a single entry.\n   */\n  private formatGroup(id: string, childParts: string[], format: PromptFormat): string[] {\n    switch (format) {\n      case 'text':\n        return childParts;\n      case 'xml':\n        return [`<${id}>\\n${childParts.join('\\n\\n')}\\n</${id}>`];\n      default:\n        return assertNever(format);\n    }\n  }\n\n  private hasNode(nodes: PromptNode<TCtx>[], id: string): boolean {\n    for (const node of nodes) {\n      if (isSection(node)) {\n        if (node.id === id) return true;\n      } else if (isGroup(node)) {\n        if (node.id === id) return true;\n        if (this.hasNode(node.children, id)) return true;\n      } else {\n        for (const c of node.candidates) {\n          if (c.id === id) return true;\n        }\n      }\n    }\n    return false;\n  }\n\n  private removeNode(nodes: PromptNode<TCtx>[], id: string): PromptNode<TCtx>[] {\n    const result: PromptNode<TCtx>[] = [];\n    for (const n of nodes) {\n      if (isSection(n)) {\n        if (n.id !== id) result.push(n);\n      } else if (isGroup(n)) {\n        if (n.id !== id) {\n          result.push({ ...n, children: this.removeNode(n.children, id) });\n        }\n      } else {\n        const remaining = n.candidates.filter((c) => c.id !== id);\n        if (remaining.length > 0) {\n          result.push({ candidates: remaining });\n        }\n      }\n    }\n    return result;\n  }\n\n  private collectIds(nodes: PromptNode<TCtx>[]): string[] {\n    const ids: string[] = [];\n    for (const node of nodes) {\n      if (isSection(node)) {\n        ids.push(node.id);\n      } else if (isGroup(node)) {\n        ids.push(node.id);\n        ids.push(...this.collectIds(node.children));\n      } else {\n        ids.push(...node.candidates.map((c) => c.id));\n      }\n    }\n    return ids;\n  }\n\n  private deepCopy(nodes: PromptNode<TCtx>[]): PromptNode<TCtx>[] {\n    return nodes.map((n) => {\n      if (isGroup(n)) {\n        return { ...n, children: this.deepCopy(n.children) };\n      }\n      if (isOneOf(n)) {\n        return { candidates: [...n.candidates] };\n      }\n      return n;\n    });\n  }\n}\n","import type { PromptContext, PromptSection } from './types';\n\n/**\n * Create a prompt section. Return a string to include, `null` to exclude.\n *\n * @example\n * ```ts\n * // Static\n * section('identity', () => 'You are Coworker.')\n *\n * // Conditional — return null to exclude\n * section('prod', (ctx: SandboxCtx) => {\n *   if (ctx.vars.prodContext == null) return null;\n *   return `## Prod\\n\\n${ctx.vars.prodContext}`;\n * })\n * ```\n */\nexport function section<TCtx extends PromptContext = PromptContext>(\n  id: string,\n  render: (ctx: TCtx) => string | null,\n): PromptSection<TCtx> {\n  return {\n    id,\n    render: (ctx) => render(ctx) ?? '',\n  };\n}\n"],"mappings":"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","names":["section"]}

package/dist/testing.d.cts

@@ -1,4 +1,4 @@
-import { P as PromptContext, a as PromptSection } from './types-DXgCksVT.cjs';
+import { P as PromptContext, a as PromptSection } from './types--sRnfw6Q.cjs';
 
 /**
  * Create a minimal PromptContext for testing.

package/dist/testing.d.ts

@@ -1,4 +1,4 @@
-import { P as PromptContext, a as PromptSection } from './types-DXgCksVT.js';
+import { P as PromptContext, a as PromptSection } from './types--sRnfw6Q.js';
 
 /**
  * Create a minimal PromptContext for testing.

package/dist/{types-DXgCksVT.d.cts → types--sRnfw6Q.d.cts}

@@ -4,7 +4,7 @@
  * @typeParam TFlags - Shape of the boolean flags object
  * @typeParam TVars - Shape of the runtime variables object
  */
-interface PromptContext<TFlags extends Record<string, boolean>, TVars extends Record<string, unknown>> {
+interface PromptContext<TFlags extends Record<string, boolean> = Record<string, boolean>, TVars extends Record<string, unknown> = Record<string, unknown>> {
     /** Boolean flags that control which sections are included and how they render */
     flags: TFlags;
     /** Runtime data sections can read from (model, mode, integrations, etc.) */
@@ -15,7 +15,7 @@ interface PromptContext<TFlags extends Record<string, boolean>, TVars extends Re
  *
  * @typeParam TCtx - The prompt context type this section operates on
  */
-interface PromptSection<TCtx extends PromptContext<Record<string, boolean>, Record<string, unknown>>> {
+interface PromptSection<TCtx extends PromptContext = PromptContext> {
     /** Unique identifier. Used by `use()`, `without()`, and `buildWithMeta()`. */
     id: string;
     /**

package/dist/{types-DXgCksVT.d.ts → types--sRnfw6Q.d.ts}

@@ -4,7 +4,7 @@
  * @typeParam TFlags - Shape of the boolean flags object
  * @typeParam TVars - Shape of the runtime variables object
  */
-interface PromptContext<TFlags extends Record<string, boolean>, TVars extends Record<string, unknown>> {
+interface PromptContext<TFlags extends Record<string, boolean> = Record<string, boolean>, TVars extends Record<string, unknown> = Record<string, unknown>> {
     /** Boolean flags that control which sections are included and how they render */
     flags: TFlags;
     /** Runtime data sections can read from (model, mode, integrations, etc.) */
@@ -15,7 +15,7 @@ interface PromptContext<TFlags extends Record<string, boolean>, TVars extends Re
  *
  * @typeParam TCtx - The prompt context type this section operates on
  */
-interface PromptSection<TCtx extends PromptContext<Record<string, boolean>, Record<string, unknown>>> {
+interface PromptSection<TCtx extends PromptContext = PromptContext> {
     /** Unique identifier. Used by `use()`, `without()`, and `buildWithMeta()`. */
     id: string;
     /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@anythingai/teleprompt",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "Composable, declarative prompt builder for LLM system prompts",
   "type": "module",
   "main": "./dist/index.cjs",
@@ -29,11 +29,19 @@
       }
     }
   },
-  "files": [
-    "dist",
-    "README.md",
-    "LICENSE"
-  ],
+  "files": ["dist", "README.md", "LICENSE"],
+  "scripts": {
+    "build": "tsup",
+    "check": "pnpm lint && pnpm typecheck && pnpm test && pnpm publint && pnpm attw",
+    "lint": "biome check .",
+    "lint:fix": "biome check --write .",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "publint": "publint",
+    "attw": "attw --pack . --profile node16",
+    "prepublishOnly": "pnpm check && pnpm build"
+  },
   "keywords": [
     "prompt",
     "llm",
@@ -48,9 +56,13 @@
     "type": "git",
     "url": "https://github.com/Create-Inc/teleprompt.git"
   },
+  "packageManager": "pnpm@10.30.0+sha512.2b5753de015d480eeb88f5b5b61e0051f05b4301808a82ec8b840c9d2adf7748eb352c83f5c1593ca703ff1017295bc3fdd3119abb9686efc96b9fcb18200937",
   "engines": {
     "node": ">=20"
   },
+  "pnpm": {
+    "onlyBuiltDependencies": ["@biomejs/biome", "esbuild"]
+  },
   "devDependencies": {
     "@arethetypeswrong/cli": "^0.17.0",
     "@biomejs/biome": "^1.9.0",
@@ -59,16 +71,5 @@
     "tsx": "^4.21.0",
     "typescript": "^5.7.0",
     "vitest": "^3.0.0"
-  },
-  "scripts": {
-    "build": "tsup",
-    "check": "pnpm lint && pnpm typecheck && pnpm test && pnpm publint && pnpm attw",
-    "lint": "biome check .",
-    "lint:fix": "biome check --write .",
-    "typecheck": "tsc --noEmit",
-    "test": "vitest run",
-    "test:watch": "vitest",
-    "publint": "publint",
-    "attw": "attw --pack . --profile node16"
   }
-}
+}