get_import_recipe
Get an import recipe for a source: (a) the target UPG schema slice (entity/edge types in play + fields), (b) the source→UPG mapping, a canonical CURATED table served verbatim when one exists (Notion, Jira, Dovetail, and 30+ more), else a schema-grounded SCAFFOLD, and (c) the write tools to call in order (batch_create_nodes → batch_create_edges). You already hold the source data and the write tools; this returns the mapping guidance, executes nothing. The consistency guarantee: a curated source resolves to ONE mapping, so the same source imported twice yields the same graph. Surfaces every deliberate-only edge (e.g. insight_informs_opportunity) as a warning, never a silent write. Sibling of get_catalog_entry (kind: "template"). Omit source to list curated sources.
Arguments
sourcestringoptionalSource slug or free-text description (e.g. "notion", "Linear issues", "a CSV of feature requests"). Omit to list the curated sources.
Returns
{ source, target_schema, mapping, execution, warnings? }{ available_sources, usage } when source is omitted.mapping.kind serves verbatim adapter tables; a scaffold returns catalogue-grounded heuristics.warnings surfaces every deliberate-only edge (e.g. insight_informs_opportunity) the mapping could produce, so it is never emitted as a silent write.