Person API

curl -X GET https://api.jarvis.local/api/person/person_abc123xyz

{
  "_id": "j2k3l4m5n6o7p8q9",
  "person_id": "person_abc123xyz",
  "name": "Jane Doe",
  "photoUrl": "https://example.com/faces/jane.jpg",
  "confidence": 0.94,
  "status": "enriched",
  "summary": "Senior Software Engineer at TechCorp with 8 years of experience in distributed systems and cloud infrastructure.",
  "occupation": "Senior Software Engineer",
  "organization": "TechCorp",
  "dossier": {
    "summary": "Jane Doe is a highly accomplished software engineer specializing in distributed systems, cloud infrastructure, and DevOps practices. She has led multiple high-impact projects and is recognized in the tech community for her contributions to open-source.",
    "title": "Senior Software Engineer",
    "company": "TechCorp",
    "work_history": [
      {
        "role": "Senior Software Engineer",
        "company": "TechCorp",
        "period": "2020-Present"
      },
      {
        "role": "Software Engineer",
        "company": "StartupXYZ",
        "period": "2017-2020"
      },
      {
        "role": "Junior Developer",
        "company": "WebDev Inc",
        "period": "2015-2017"
      }
    ],
    "education": [
      {
        "school": "MIT",
        "degree": "BS Computer Science"
      }
    ],
    "social_profiles": {
      "linkedin": "https://linkedin.com/in/janedoe",
      "twitter": "https://twitter.com/janedoe_dev",
      "github": "https://github.com/janedoe",
      "website": "https://janedoe.dev"
    },
    "notable_activity": [
      "Keynote speaker at CloudConf 2023",
      "Contributor to Kubernetes project (500+ commits)",
      "Author of 'Building Scalable Systems' blog series (100k+ views)",
      "Organizer of Women in Tech meetup (500+ members)"
    ],
    "conversation_hooks": [
      "Ask about her experience scaling TechCorp's infrastructure to 10M+ users",
      "Discuss open-source contributions to Kubernetes",
      "Talk about the future of serverless computing",
      "Inquire about her Women in Tech community work"
    ],
    "risk_flags": []
  },
  "createdAt": 1709654400000,
  "updatedAt": 1709654850000,
  "boardPosition": {
    "x": 320,
    "y": 180
  }
}

const waitForEnrichment = async (personId, maxWaitMs = 60000) => {
  const startTime = Date.now();
  
  while (Date.now() - startTime < maxWaitMs) {
    const response = await fetch(`https://api.jarvis.local/api/person/${personId}`);
    const person = await response.json();
    
    if (person.status === 'enriched') {
      return person;
    } else if (person.status === 'failed') {
      throw new Error('Enrichment failed');
    }
    
    // Wait 2 seconds before next poll
    await new Promise(resolve => setTimeout(resolve, 2000));
  }
  
  throw new Error('Enrichment timeout');
};

import { useQuery } from 'convex/react';
import { api } from '@/convex/_generated/api';

function PersonView({ personId }: { personId: string }) {
  const person = useQuery(api.persons.getById, { id: personId });
  
  if (!person) return <div>Loading...</div>;
  if (person.status === 'researching') return <div>Researching {person.name}...</div>;
  if (person.status === 'enriched') return <DossierView person={person} />;
  
  return <div>Status: {person.status}</div>;
}