plugin.json

{
  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
  "name": "kinroll",
  "version": "1.0.0",
  "description": "A family tree builder in ChatGPT. Share photos of birth, marriage and death certificates, type what you know, or bring a GEDCOM file: ChatGPT reads the documents and Kinroll builds one family tree in which every fact keeps its source. Living relatives' details stay out of exports, posters and printed books. Export GEDCOM, download a family tree poster, or print the tree as a hardcover family book.",
  "author": {
    "name": "The Open Apps, Inc.",
    "email": "support@theopenapps.com",
    "url": "https://kinroll.ambientapp.ai"
  },
  "homepage": "https://kinroll.ambientapp.ai",
  "keywords": [
    "family tree",
    "genealogy",
    "ancestry",
    "GEDCOM",
    "birth certificate",
    "family history",
    "pedigree chart",
    "family tree poster"
  ],
  "extensions": {
    "com.openai": {
      "interface": {
        "displayName": "Kinroll Family Tree",
        "shortDescription": "Family tree from old records",
        "longDescription": "Kinroll builds your family tree from what you already have.\n\nAttach a photo of a birth, marriage or death certificate, a baptism record, a census page, a passenger list, an obituary or an old letter. ChatGPT reads it, and Kinroll adds the people, dates, places and relationships it states, with the transcription kept as the source of every fact. You can also type what you know (\"My grandfather Giovanni Rossi was born in Lucca in 1921\") or import a GEDCOM file from the genealogy program you use today.\n\nEvery fact keeps its source. When two records disagree, both dates stay side by side so you can decide. When a new person may already be in the tree, Kinroll asks before merging.\n\nLiving relatives stay private. Anyone born within the last 100 years without a death record counts as living: exports, posters and books show only their name, or \"Private\". Social Security, national ID and passport numbers are removed before anything is saved, and Kinroll never receives the photos themselves, only ChatGPT's transcription.\n\nUse your tree anywhere:\n- Export it as a GEDCOM 5.5.1 file for Ancestry, FamilySearch, MyHeritage, Gramps or a backup.\n- Download a 36 x 24 inch ancestor or descendant chart as a PDF to print at any print shop.\n- Lay it out as an 8.5 x 11 inch hardcover family book: pedigree charts, a page for each family on your direct lines, the sources behind every fact and an index of names. Books are printed and shipped by Lulu to the United States and Canada; checkout is on Kinroll's website.\n\nLimits:\n- Kinroll works with the documents and information you bring; it doesn't search archives or record collections.\n- Up to 5,000 people per tree and GEDCOM files up to 10 MB.\n- Your trees belong to your ChatGPT account and are shared with no one. Say \"Delete my family tree\" to delete one at once.\n- Not affiliated with any genealogy company or government office.",
        "developerName": "The Open Apps, Inc.",
        "category": "Education & Research",
        "capabilities": [
          "Build a family tree from certificate photos",
          "Import and export GEDCOM files",
          "Keep a source for every fact",
          "Print a family tree poster or book"
        ],
        "websiteURL": "https://kinroll.ambientapp.ai",
        "supportURL": "https://kinroll.ambientapp.ai/support",
        "privacyPolicyURL": "https://kinroll.ambientapp.ai/privacy",
        "termsOfServiceURL": "https://kinroll.ambientapp.ai/terms",
        "defaultPrompt": [
          "Start a family tree for my family",
          "Add this birth certificate to my family tree",
          "Import my GEDCOM family tree"
        ],
        "brandColor": "#6B4A2E",
        "brandColorDark": "#E0BB93",
        "composerIcon": "./assets/composerIcon.png",
        "logo": "./assets/logo.png"
      },
      "review": {
        "test_cases": {
          "positive": [
            {
              "description": "Start a tree from what the user types. Run this first, in a new chat, with Kinroll picked: type @Kinroll, choose Kinroll Family Tree, then type the prompt (Try in chat on the plugin's page does the same). Without it ChatGPT may answer on its own instead of using Kinroll; if a later case gets the reply that Kinroll isn't available, pick it again the same way. There is nothing to sign in to: each ChatGPT user has their own trees. If this ChatGPT account already has a tree called The Rossi Family (for example on a rerun), first say \"Delete my family tree The Rossi Family\" and allow it. ChatGPT may call list_family_trees first and may show 'Allow ChatGPT to use Kinroll?' before saving; choose Allow. The case passes with or without either.",
              "prompt": "Start a family tree for the Rossi family. My grandfather Giovanni Rossi was born in Lucca, Italy in 1921 and died in Chicago in 1990. He married Maria Neri in 1946. Their son Marco Rossi was born in Chicago in 1958.",
              "tools_triggered": "create_family_tree, add_family_members",
              "expected_behavior": "The card shows The Rossi Family with 3 people: Marco Rossi with his parents Giovanni Rossi (1921-1990) and Maria Neri. The reply says who was added and adds no people, dates or places the prompt didn't give. Marco and Maria count as living (no death record), and Giovanni does not."
            },
            {
              "description": "Add a certificate from a photo. Run after case 1 in the same chat. Download the attached image (a synthetic Italian birth certificate marked SPECIMEN) and attach it to the message. ChatGPT reads the image itself; Kinroll receives only its transcription and the facts it states. ChatGPT may show 'Allow ChatGPT to use Kinroll?'; choose Allow.",
              "prompt": "Add this birth certificate to my family tree.",
              "tools_triggered": "add_document",
              "file_attachment_urls": [
                "https://kinroll.ambientapp.ai/review/birth-certificate-giovanni-rossi.png"
              ],
              "expected_behavior": "Giovanni Rossi's birth becomes 12 March 1921 in Lucca, and his parents Pietro Rossi and Assunta Lenzi join the tree, all cited to the birth certificate. Giovanni is not added a second time. The reply mentions the certificate. The certificate's codice fiscale (an ID number) is not saved: the card's Sources tab shows the transcription without it (ChatGPT leaves it out, or Kinroll puts [ID number removed] in its place)."
            },
            {
              "description": "See each fact with its source. Run after case 2 in the same chat. In the card, Open the tree and tap Giovanni Rossi to see the same facts with their source numbers; tapping a number opens the Sources tab.",
              "prompt": "What does my tree say about Giovanni Rossi, and where does each fact come from?",
              "tools_triggered": "show_family_tree",
              "expected_behavior": "The card focuses on Giovanni Rossi: born 12 Mar 1921 in Lucca (two sources: typed in chat and the birth certificate), died 1990 in Chicago, married to Maria Neri, parents Pietro Rossi and Assunta Lenzi, son Marco Rossi. The reply names the sources and adds nothing that isn't in the tree."
            },
            {
              "description": "Import a GEDCOM file. Download the attached .ged file (a synthetic family) and attach it to the message. It contains a Social Security number and a Turkish ID number on purpose. ChatGPT may show 'Allow ChatGPT to use Kinroll?'; choose Allow.",
              "prompt": "Import this GEDCOM file as a new family tree.",
              "tools_triggered": "import_gedcom",
              "file_attachment_urls": [
                "https://kinroll.ambientapp.ai/review/bianchi-family.ged"
              ],
              "expected_behavior": "A new Bianchi family tree with 9 people in 3 families, starting from Sofia Bianchi. The reply says 2 ID numbers were left out. The card shows Sofia with her parents Luca Bianchi and Giulia Esposito and her grandparents Antonio Bianchi (1924-1999) and Teresa Colombo."
            },
            {
              "description": "Preview the family book and order it. Run after case 4 in the same chat (it uses the Bianchi family tree). Ordering creates an order awaiting payment and charges nothing; the checkout page on kinroll.ambientapp.ai takes payment. To finish checkout, open the link, use any US address, click Add code in the payment form and enter the review code KINROLL-51A45AB4 (for reviewers: 100% off, at most 50 uses). The order then costs nothing, no card is needed, and it goes to our printer's test system, so nothing is printed, shipped or charged. ChatGPT may show 'Allow ChatGPT to use Kinroll?' before the preview or the order; choose Allow.",
              "prompt": "Show me what the Bianchi family book would look like, then get it ready to order one copy.",
              "tools_triggered": "preview_family_book, order_family_book",
              "expected_behavior": "Kinroll lays out the book (24 pages: pedigree charts, a page for each family, the sources and an index) and prices the first copy. ChatGPT may show only the turn's last card, the order card; its See the book's pages button opens the pages. Living people (Sofia, her parents) appear by name only, without dates or places. The order step returns a link to the secure checkout on kinroll.ambientapp.ai, which the card opens with Continue to secure checkout; payment and the shipping address happen there, never in the chat. With the review code the total is $0, and back in ChatGPT the order card reads Paid with a review code."
            }
          ],
          "negative": [
            {
              "description": "General history. Kinroll builds the user's own tree; it is not an encyclopedia of famous people.",
              "prompt": "Who was Giuseppe Garibaldi's father?",
              "expected_behavior": "No Kinroll tool is called. ChatGPT answers itself."
            },
            {
              "description": "Searching record collections. Kinroll doesn't search archives or censuses.",
              "prompt": "Search the 1940 US census for anyone named Rossi living in Chicago.",
              "expected_behavior": "No Kinroll tool is called. ChatGPT answers with its own knowledge or search, or explains where census records can be searched."
            },
            {
              "description": "Writing that isn't a family tree. Kinroll is not needed to write a toast.",
              "prompt": "Write a short toast for my grandparents' 60th wedding anniversary.",
              "expected_behavior": "No Kinroll tool is called. ChatGPT writes the toast itself."
            }
          ]
        },
        "commerce": true,
        "commerce_description": "Sells one physical product: a printed hardcover family history book, printed and shipped by Lulu to the United States and Canada. Checkout happens on our own site (kinroll.ambientapp.ai) with Stripe; the plugin only gives the user the checkout link (the card opens it with openExternal) and never collects payment or address data. Building the tree, the GEDCOM export and the poster PDF are not sold.",
        "demo_recording_url": "https://kinroll.ambientapp.ai/demo.mp4"
      },
      "publication": {
        "countries": [],
        "release_notes": "First release: build a sourced family tree from certificate photos, typed lists or GEDCOM files; living relatives kept private; GEDCOM export; family tree posters; and a printed family history book."
      },
      "apps": "./.app.json"
    }
  }
}