Function inspectComposition

packages/sdk/examples/headless-agent.ts:169–189

(html: string)

// Agents need to discover what's in a composition before editing.

export async function inspectComposition(html: string): Promise<{
  elementCount: number;
  textElements: ElementSnapshot[];
  imageElements: ElementSnapshot[];
  ids: string[];
}> {
  const comp = await openComposition(html);

  const all = comp.getElements();
  const textElements = all.filter((el) => ["div", "p", "h1", "h2", "h3", "span"].includes(el.tag));
  const imageElements = all.filter((el) => el.tag === "img");

  comp.dispose();

  return {
    elementCount: all.length,
    textElements,
    imageElements,
    ids: all.map((el) => el.id),
  };
}

// ── Timing normalization agent ────────────────────────────────────────────────