Sources

register a source ──▶ extract through a shape ──▶ typed entities in the graph
   pb.sources.register      pb.extract                 pb.sources.entities

const source = await pb.sources.register({
  type: "document",
  name: "Acme MSA.pdf",
  // ...source reference or content, per your upload flow
});

const entities = await pb.sources.entities(source.id);
const stats = await pb.sources.entityStats(source.id);

console.log(stats); // counts, including a per-shape breakdown

// 1. Register the material.
const source = await pb.sources.register({ type: "document", name: "Acme MSA.pdf" });

// 2. Coerce it into graph structure through a shape (staged).
//    `source` takes the text to extract from; pass the registered source's
//    id as `external_id` to keep the provenance link.
await pb.extract({
  source: { text: documentText, external_id: source.id },
  shapeId: "shp_contract_terms",
  apply: false,
});

// 3. Read what landed, scoped to the source.
const entities = await pb.sources.entities(source.id);