@anythingai/teleprompt 0.2.0 → 0.3.0

package/dist/index.cjs

@@ -1,25 +1,7 @@
 "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.nodes = []}
-  /**
-   * Add a section to the prompt.
-   *
-   * If a section with the same `id` already exists, it is replaced.
-   * This makes `.use()` idempotent — you can safely call it multiple
-   * times with the same section without creating duplicates.
-   */
+  /** Replaces an existing section with the same id. */
   use(section2) {
     const idx = this.nodes.findIndex((n) => !isOneOf(n) && n.id === section2.id);
     if (idx >= 0) {
@@ -30,8 +12,7 @@ var PromptBuilder = (_class = class _PromptBuilder {constructor() { _class.proto
     return this;
   }
   /**
-   * Add mutually exclusive sections. The first candidate that renders
-   * a non-empty string wins — the rest are excluded.
+   * First candidate that renders a non-empty string wins.
    *
    * @example
    * ```ts
@@ -43,9 +24,7 @@ var PromptBuilder = (_class = class _PromptBuilder {constructor() { _class.proto
     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.
+   * In `xml` format, wraps children in `<id>` tags. Transparent in `text` format.
    *
    * @example
    * ```ts
@@ -67,199 +46,183 @@ var PromptBuilder = (_class = class _PromptBuilder {constructor() { _class.proto
     }
     return this;
   }
-  /** Remove a section or group. Accepts an id string or an object with `id`. Searches recursively into groups and oneOf candidates. */
+  /** Searches recursively into groups and oneOf candidates. */
   without(ref) {
     const id = typeof ref === "string" ? ref : ref.id;
-    this.nodes = this.removeNode(this.nodes, id);
+    this.nodes = removeNode(this.nodes, id);
     return this;
   }
-  /** Check if a section or group exists. Accepts an id string or an object with `id`. Searches recursively into groups and oneOf candidates. */
+  /** Searches recursively into groups and oneOf candidates. */
   has(ref) {
     const id = typeof ref === "string" ? ref : ref.id;
-    return this.hasNode(this.nodes, id);
+    return hasNode(this.nodes, id);
   }
-  /** Get all ids (sections, groups, and oneOf candidates) in order. */
   ids() {
-    return this.collectIds(this.nodes);
+    return collectIds(this.nodes);
   }
   /**
-   * Create an independent copy of this builder.
-   *
-   * Use this to create mode-specific or model-specific variants
-   * without mutating the base builder.
+   * Creates an independent copy. Modifications to the fork don't affect the original.
    *
    * @example
    * ```ts
    * const base = new PromptBuilder().use(a).use(b);
-   * const variant = base.fork().use(c); // base is unchanged
+   * const variant = base.fork().use(c);
    * ```
    */
   fork() {
     const forked = new _PromptBuilder();
-    forked.nodes = this.deepCopy(this.nodes);
+    forked.nodes = deepCopy(this.nodes);
     return forked;
   }
-  /**
-   * Build the final prompt string.
-   *
-   * 1. Filters out sections whose `when` guard returns false
-   * 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, options) {
     return this.buildWithMeta(ctx, options).prompt;
   }
-  /**
-   * Build the prompt and return metadata about which sections were
-   * included/excluded. Useful for debugging and logging.
-   *
-   * A section is "excluded" if its `when` guard returns false.
-   * A section is "included" only if it passes the guard and renders
-   * a non-empty string.
-   */
+  /** Like `build`, but also returns which section ids were included/excluded. */
   buildWithMeta(ctx, options) {
     const included = [];
     const excluded = [];
     const format = _nullishCoalesce(_optionalChain([options, 'optionalAccess', _ => _.format]), () => ( "text"));
-    const parts = this.renderNodes(this.nodes, ctx, format, included, excluded);
+    const parts = 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;
+}, _class);
+function isSection(node) {
+  return "render" in node;
+}
+function isGroup(node) {
+  return "children" in node;
+}
+function isOneOf(node) {
+  return "candidates" in node;
+}
+function assertNever(value) {
+  throw new Error(`Unexpected format: ${value}`);
+}
+function formatSection(id, content, format) {
+  switch (format) {
+    case "text":
+      return content;
+    case "xml":
+      return `<${id}>
+${content}
+</${id}>`;
+    default:
+      return assertNever(format);
   }
-  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;
-    }
+}
+function formatGroup(id, childParts, format) {
+  switch (format) {
+    case "text":
+      return childParts;
+    case "xml":
+      return [`<${id}>
+${childParts.join("\n\n")}
+</${id}>`];
+    default:
+      return assertNever(format);
+  }
+}
+function renderSection(section2, ctx, format, parts, included, excluded) {
+  if (section2.when && !section2.when(ctx)) {
     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;
-      }
-    }
+  const output = section2.render(ctx);
+  if (output) {
+    included.push(section2.id);
+    parts.push(formatSection(section2.id, output, format));
+    return 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);
+  excluded.push(section2.id);
+  return false;
+}
+function renderOneOf(node, ctx, format, parts, included, excluded) {
+  let found = false;
+  for (const candidate of node.candidates) {
+    if (found) {
+      excluded.push(candidate.id);
+      continue;
     }
-  }
-  /**
-   * 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);
+    if (renderSection(candidate, ctx, format, parts, included, excluded)) {
+      found = true;
     }
   }
-  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 {
-        for (const c of node.candidates) {
-          if (c.id === id) return true;
-        }
+}
+function renderNodes(nodes, ctx, format, included, excluded) {
+  const parts = [];
+  for (const node of nodes) {
+    if (isSection(node)) {
+      renderSection(node, ctx, format, parts, included, excluded);
+    } else if (isGroup(node)) {
+      const childParts = renderNodes(node.children, ctx, format, included, excluded);
+      if (childParts.length > 0) {
+        parts.push(...formatGroup(node.id, childParts, format));
       }
+    } else {
+      renderOneOf(node, ctx, format, parts, 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 parts;
+}
+function 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 (hasNode(node.children, id)) return true;
+    } else {
+      for (const c of node.candidates) {
+        if (c.id === id) return true;
       }
     }
-    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 false;
+}
+function 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: removeNode(n.children, id) });
+      }
+    } else {
+      const remaining = n.candidates.filter((c) => c.id !== id);
+      if (remaining.length > 0) {
+        result.push({ candidates: remaining });
       }
     }
-    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;
-    });
+  return result;
+}
+function 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(...collectIds(node.children));
+    } else {
+      ids.push(...node.candidates.map((c) => c.id));
+    }
   }
-}, _class);
+  return ids;
+}
+function deepCopy(nodes) {
+  return nodes.map((n) => {
+    if (isGroup(n)) {
+      return { ...n, children: deepCopy(n.children) };
+    }
+    if (isOneOf(n)) {
+      return { candidates: [...n.candidates] };
+    }
+    return n;
+  });
+}
 
 // src/section.ts
 function section(id, render) {

package/dist/index.cjs.map

@@ -1 +1 @@
-{"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"]}
+{"version":3,"sources":["/Users/asurve/dev/teleprompt/main/dist/index.cjs","../src/builder.ts","../src/section.ts"],"names":["section"],"mappings":"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","file":"/Users/asurve/dev/teleprompt/main/dist/index.cjs","sourcesContent":[null,"import type { PromptContext, PromptSection } from './types';\n\nexport type PromptFormat = 'text' | 'xml';\n\nexport interface BuildOptions {\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 * @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  /** Replaces an existing section with the same id. */\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   * First candidate that renders a non-empty string wins.\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   * In `xml` format, wraps children in `<id>` tags. Transparent in `text` format.\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  /** 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 = removeNode(this.nodes, id);\n    return this;\n  }\n\n  /** 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 hasNode(this.nodes, id);\n  }\n\n  ids(): string[] {\n    return collectIds(this.nodes);\n  }\n\n  /**\n   * Creates an independent copy. Modifications to the fork don't affect the original.\n   *\n   * @example\n   * ```ts\n   * const base = new PromptBuilder().use(a).use(b);\n   * const variant = base.fork().use(c);\n   * ```\n   */\n  fork(): PromptBuilder<TCtx> {\n    const forked = new PromptBuilder<TCtx>();\n    forked.nodes = deepCopy(this.nodes);\n    return forked;\n  }\n\n  build(ctx: TCtx, options?: BuildOptions): string {\n    return this.buildWithMeta(ctx, options).prompt;\n  }\n\n  /** Like `build`, but also returns which section ids were included/excluded. */\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 = renderNodes(this.nodes, ctx, format, included, excluded);\n    const prompt = parts.join('\\n\\n').trim();\n\n    return { prompt, included, excluded };\n  }\n}\n\ninterface PromptGroup<TCtx extends PromptContext> {\n  id: string;\n  children: PromptNode<TCtx>[];\n}\n\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\nfunction assertNever(value: never): never {\n  throw new Error(`Unexpected format: ${value}`);\n}\n\nfunction 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\nfunction 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\nfunction renderSection<TCtx extends PromptContext>(\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(formatSection(section.id, output, format));\n    return true;\n  }\n  excluded.push(section.id);\n  return false;\n}\n\nfunction renderOneOf<TCtx extends PromptContext>(\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 (renderSection(candidate, ctx, format, parts, included, excluded)) {\n      found = true;\n    }\n  }\n}\n\nfunction renderNodes<TCtx extends PromptContext>(\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      renderSection(node, ctx, format, parts, included, excluded);\n    } else if (isGroup(node)) {\n      const childParts = renderNodes(node.children, ctx, format, included, excluded);\n      if (childParts.length > 0) {\n        parts.push(...formatGroup(node.id, childParts, format));\n      }\n    } else {\n      renderOneOf(node, ctx, format, parts, included, excluded);\n    }\n  }\n\n  return parts;\n}\n\nfunction hasNode<TCtx extends PromptContext>(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 (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\nfunction removeNode<TCtx extends PromptContext>(\n  nodes: PromptNode<TCtx>[],\n  id: string,\n): 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: 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\nfunction collectIds<TCtx extends PromptContext>(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(...collectIds(node.children));\n    } else {\n      ids.push(...node.candidates.map((c) => c.id));\n    }\n  }\n  return ids;\n}\n\nfunction deepCopy<TCtx extends PromptContext>(nodes: PromptNode<TCtx>[]): PromptNode<TCtx>[] {\n  return nodes.map((n) => {\n    if (isGroup(n)) {\n      return { ...n, children: deepCopy(n.children) };\n    }\n    if (isOneOf(n)) {\n      return { candidates: [...n.candidates] };\n    }\n    return 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 * section('identity', () => 'You are Coworker.')\n *\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,12 +1,8 @@
-import { P as PromptContext, a as PromptSection } from './types--sRnfw6Q.cjs';
+import { P as PromptContext, a as PromptSection } from './types-ow-XbrO7.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.
@@ -14,12 +10,6 @@ interface BuildOptions {
     format?: PromptFormat;
 }
 /**
- * Declarative, composable prompt builder.
- *
- * Prompts are composed from discrete {@link PromptSection}s that are
- * independently testable pure functions. The builder handles ordering,
- * conditional inclusion, and final assembly.
- *
  * @example
  * ```ts
  * const prompt = new PromptBuilder()
@@ -31,17 +21,10 @@ interface BuildOptions {
  */
 declare class PromptBuilder<TCtx extends PromptContext = PromptContext> {
     private nodes;
-    /**
-     * Add a section to the prompt.
-     *
-     * If a section with the same `id` already exists, it is replaced.
-     * This makes `.use()` idempotent — you can safely call it multiple
-     * times with the same section without creating duplicates.
-     */
+    /** Replaces an existing section with the same id. */
     use(section: PromptSection<TCtx>): this;
     /**
-     * Add mutually exclusive sections. The first candidate that renders
-     * a non-empty string wins — the rest are excluded.
+     * First candidate that renders a non-empty string wins.
      *
      * @example
      * ```ts
@@ -50,9 +33,7 @@ declare class PromptBuilder<TCtx extends PromptContext = PromptContext> {
      */
     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.
+     * In `xml` format, wraps children in `<id>` tags. Transparent in `text` format.
      *
      * @example
      * ```ts
@@ -63,68 +44,32 @@ declare class PromptBuilder<TCtx extends PromptContext = PromptContext> {
      * ```
      */
     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. */
+    /** Searches recursively into groups and oneOf candidates. */
     without(ref: string | {
         id: string;
     }): this;
-    /** Check if a section or group exists. Accepts an id string or an object with `id`. Searches recursively into groups and oneOf candidates. */
+    /** Searches recursively into groups and oneOf candidates. */
     has(ref: string | {
         id: string;
     }): boolean;
-    /** Get all ids (sections, groups, and oneOf candidates) in order. */
     ids(): string[];
     /**
-     * Create an independent copy of this builder.
-     *
-     * Use this to create mode-specific or model-specific variants
-     * without mutating the base builder.
+     * Creates an independent copy. Modifications to the fork don't affect the original.
      *
      * @example
      * ```ts
      * const base = new PromptBuilder().use(a).use(b);
-     * const variant = base.fork().use(c); // base is unchanged
+     * const variant = base.fork().use(c);
      * ```
      */
     fork(): PromptBuilder<TCtx>;
-    /**
-     * Build the final prompt string.
-     *
-     * 1. Filters out sections whose `when` guard returns false
-     * 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, options?: BuildOptions): string;
-    /**
-     * Build the prompt and return metadata about which sections were
-     * included/excluded. Useful for debugging and logging.
-     *
-     * A section is "excluded" if its `when` guard returns false.
-     * A section is "included" only if it passes the guard and renders
-     * a non-empty string.
-     */
+    /** Like `build`, but also returns which section ids were included/excluded. */
     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;
 }
 
 /**
@@ -132,10 +77,8 @@ declare class PromptBuilder<TCtx extends PromptContext = PromptContext> {
  *
  * @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}`;