topola-viewer/src/webmcp_definitions.ts

import {ToolDefinition} from './webmcp_types';

export const GET_SELECTED_PERSON: ToolDefinition = {
  name: 'get_selected_person',
  description:
    'Returns the full details (name, events, immediate relatives) of the individual currently selected in the browser viewport.',
  inputSchema: {type: 'object', properties: {}},
};

export const SEARCH_INDI: ToolDefinition = {
  name: 'search_indi',
  description:
    'Searches the genealogy index for individuals by name. Returns up to 10 results starting with the ones that match the best.',
  inputSchema: {
    type: 'object',
    properties: {
      query: {type: 'string', description: 'The name to search for.'},
    },
    required: ['query'],
  },
};

export const INSPECT_INDI: ToolDefinition = {
  name: 'inspect_indi',
  description:
    'Fetches detailed information for a specific individual by ID, including their immediate relatives and life events.',
  inputSchema: {
    type: 'object',
    properties: {
      id: {type: 'string', description: 'The ID of the individual.'},
    },
    required: ['id'],
  },
};

export const FOCUS_INDI: ToolDefinition = {
  name: 'focus_indi',
  description:
    'Instructs the Topola viewer camera view to center on and focus a specific person. Restructures the tree view to show ancestors and descendants of the selected person.',
  inputSchema: {
    type: 'object',
    properties: {
      id: {type: 'string', description: 'The ID to focus.'},
    },
    required: ['id'],
  },
};

export const FIND_RELATIONSHIP_PATH: ToolDefinition = {
  name: 'find_relationship_path',
  description:
    'Finds the shortest path connecting two individuals (e.g., through parents or marriages). Returns an ordered list of connecting individuals.',
  inputSchema: {
    type: 'object',
    properties: {
      source: {type: 'string', description: 'Start individual ID'},
      target: {type: 'string', description: 'End individual ID'},
    },
    required: ['source', 'target'],
  },
};

export const GET_ANCESTORS: ToolDefinition = {
  name: 'get_ancestors',
  description:
    'Returns ancestors of a specific individual up to a maximum depth of 5 generations.',
  inputSchema: {
    type: 'object',
    properties: {
      id: {type: 'string', description: 'Target individual ID'},
      generations: {
        type: 'number',
        description: 'Depth bound limit (1-5). Defaults to 3.',
        minimum: 1,
        maximum: 5,
        default: 3,
      },
    },
    required: ['id'],
  },
};

export const GET_DESCENDANTS: ToolDefinition = {
  name: 'get_descendants',
  description:
    'Returns descendants of a specific individual up to a maximum depth of 5 generations.',
  inputSchema: {
    type: 'object',
    properties: {
      id: {type: 'string', description: 'Target individual ID'},
      generations: {
        type: 'number',
        description: 'Depth bound limit (1-5). Defaults to 3.',
        minimum: 1,
        maximum: 5,
        default: 3,
      },
    },
    required: ['id'],
  },
};