Case Search

const result = await client.legal.find({
  query: 'qualified immunity excessive force police',
  jurisdiction: 'us-federal',
  numResults: 10
});

console.log(`Found ${result.found} candidates`);

for (const candidate of result.candidates) {
  console.log(`${candidate.title}`);
  console.log(`  ${candidate.url}`);
  console.log(`  ${candidate.snippet.slice(0, 100)}...`);
}

const result = await client.legal.similar({
  url: 'https://www.courtlistener.com/opinion/118365/bush-v-gore/',
  numResults: 10
});

console.log(`Found ${result.found} similar sources`);

for (const source of result.similarSources) {
  console.log(`${source.title}`);
  console.log(`  ${source.url}`);
}

const result = await client.legal.research({
  query: 'employment discrimination disparate impact',
  additionalQueries: [
    'Title VII disparate impact theory',
    'Griggs v Duke Power significance',
    'statistical evidence employment discrimination'
  ],
  jurisdiction: 'us-federal',
  numResults: 15
});

console.log(`Deep search found ${result.found} sources`);

for (const candidate of result.candidates) {
  console.log(`${candidate.title}`);
  
  // Deep search includes highlighted passages
  if (candidate.highlights?.length > 0) {
    console.log(`  Key passage: "${candidate.highlights[0]}"`);
  }
}

async function researchTopic(topic: string, jurisdiction?: string) {
  // 1. Deep search with variations
  const research = await client.legal.research({
    query: topic,
    additionalQueries: generateVariations(topic),
    jurisdiction,
    numResults: 20
  });
  
  // 2. Verify top candidates
  const verified = [];
  for (const candidate of research.candidates.slice(0, 10)) {
    const result = await client.legal.verify({ text: candidate.title });
    if (result.summary.verified > 0) {
      verified.push({
        ...candidate,
        verification: result.citations[0]
      });
    }
  }
  
  // 3. Find similar cases to the best result
  if (verified.length > 0) {
    const similar = await client.legal.similar({
      url: verified[0].url,
      numResults: 5
    });
    return { primary: verified, related: similar.similarSources };
  }
  
  return { primary: verified, related: [] };
}

async function buildTimeline(seedCase: string) {
  // Find the seed case
  const search = await client.legal.find({ query: seedCase, numResults: 1 });
  const seedUrl = search.candidates[0].url;
  
  // Find similar cases across time
  const similar = await client.legal.similar({
    url: seedUrl,
    numResults: 25
  });
  
  // Sort by date
  return similar.similarSources
    .filter(s => s.publishedDate)
    .sort((a, b) => new Date(a.publishedDate) - new Date(b.publishedDate));
}

// Research across multiple jurisdictions
async function multiJurisdictionSearch(query: string) {
  const jurisdictions = ['us-federal', 'california', 'new-york', 'texas'];
  
  const results = await Promise.all(
    jurisdictions.map(j => 
      client.legal.find({ query, jurisdiction: j, numResults: 5 })
    )
  );
  
  return jurisdictions.map((j, i) => ({
    jurisdiction: j,
    cases: results[i].candidates
  }));
}