/**
* Writer Tool Definitions - MCP tool schemas for Writer's Aid
*/
export const writerToolDefinitions = [
// Content Discovery Tools (5)
{
name: "search_content",
description: "Semantic search across all manuscript content",
inputSchema: {
type: "object",
properties: {
project_path: { type: "string", description: "Path to manuscript directory (defaults to current directory)" },
query: { type: "string", description: "Search query" },
scope: { type: "string", description: "File scope pattern (e.g., 'chapters/*.md')" },
limit: { type: "number", description: "Maximum results", default: 10 },
},
required: ["query"],
},
},
{
name: "find_related_sections",
description: "Find content semantically similar to given text",
inputSchema: {
type: "object",
properties: {
project_path: { type: "string", description: "Path to manuscript directory (defaults to current directory)" },
reference_text: { type: "string", description: "Text to find related content for" },
limit: { type: "number", description: "Maximum results", default: 5 },
exclude_file: { type: "string", description: "File to exclude from results" },
},
required: ["reference_text"],
},
},
{
name: "extract_themes",
description: "Cluster content into main themes/topics",
inputSchema: {
type: "object",
properties: {
project_path: { type: "string", description: "Path to manuscript directory (defaults to current directory)" },
scope: { type: "string", description: "File scope pattern" },
num_themes: { type: "number", description: "Number of themes to extract", default: 5 },
},
},
},
{
name: "track_concept_evolution",
description: "Show how concept is discussed across documents",
inputSchema: {
type: "object",
properties: {
project_path: { type: "string", description: "Path to manuscript directory (defaults to current directory)" },
concept: { type: "string", description: "Concept to track" },
chronological: { type: "boolean", description: "Sort chronologically", default: true },
},
required: ["concept"],
},
},
{
name: "find_gaps",
description: "Find terms mentioned but not explained",
inputSchema: {
type: "object",
properties: {
project_path: { type: "string", description: "Path to manuscript directory (defaults to current directory)" },
scope: { type: "string", description: "File scope pattern" },
},
},
},
// Structure Tools (4)
{
name: "generate_outline",
description: "Create hierarchical outline from content",
inputSchema: {
type: "object",
properties: {
project_path: { type: "string", description: "Path to manuscript directory (defaults to current directory)" },
scope: { type: "string", description: "File scope pattern" },
depth: { type: "number", description: "Outline depth", default: 3 },
include_word_counts: { type: "boolean", description: "Include word counts", default: false },
},
},
},
{
name: "suggest_reorganization",
description: "Suggest better content organization",
inputSchema: {
type: "object",
properties: {
project_path: { type: "string", description: "Path to manuscript directory (defaults to current directory)" },
current_structure: { type: "string", description: "Description of current structure" },
optimization: {
type: "string",
enum: ["coherence", "flow", "complexity"],
description: "Optimization goal",
},
},
},
},
{
name: "find_orphaned_sections",
description: "Find sections with no incoming links",
inputSchema: {
type: "object",
properties: {
project_path: { type: "string", description: "Path to manuscript directory (defaults to current directory)" },
scope: { type: "string", description: "File scope pattern" },
},
},
},
{
name: "validate_structure",
description: "Check heading hierarchy and section balance",
inputSchema: {
type: "object",
properties: {
project_path: { type: "string", description: "Path to manuscript directory (defaults to current directory)" },
file_path: { type: "string", description: "Specific file to validate" },
checks: {
type: "array",
items: { type: "string" },
description: "Checks to run (heading-levels, duplicates, balance, deep-nesting)",
},
},
},
},
// Link Tools (4)
{
name: "analyze_link_graph",
description: "Visualize connections between documents",
inputSchema: {
type: "object",
properties: {
project_path: { type: "string", description: "Path to manuscript directory (defaults to current directory)" },
scope: { type: "string", description: "File scope pattern" },
format: {
type: "string",
enum: ["mermaid", "json", "dot"],
description: "Output format",
default: "mermaid",
},
},
},
},
{
name: "find_broken_links",
description: "Detect broken internal and external links",
inputSchema: {
type: "object",
properties: {
project_path: { type: "string", description: "Path to manuscript directory (defaults to current directory)" },
check_external: { type: "boolean", description: "Check external links", default: false },
scope: { type: "string", description: "File scope pattern" },
},
},
},
{
name: "suggest_cross_references",
description: "Suggest where to add links between sections",
inputSchema: {
type: "object",
properties: {
project_path: { type: "string", description: "Path to manuscript directory (defaults to current directory)" },
min_similarity: {
type: "number",
description: "Minimum similarity threshold",
default: 0.7,
},
exclude_existing_links: {
type: "boolean",
description: "Exclude existing links",
default: true,
},
},
},
},
{
name: "trace_reference_chain",
description: "Follow concept through linked documents",
inputSchema: {
type: "object",
properties: {
project_path: { type: "string", description: "Path to manuscript directory (defaults to current directory)" },
start_file: { type: "string", description: "Starting file" },
end_file: { type: "string", description: "Target file" },
concept: { type: "string", description: "Concept to track" },
},
required: ["start_file", "end_file"],
},
},
// Quality Tools (4)
{
name: "check_terminology",
description: "Find inconsistent term usage",
inputSchema: {
type: "object",
properties: {
project_path: { type: "string", description: "Path to manuscript directory (defaults to current directory)" },
scope: { type: "string", description: "File scope pattern" },
auto_detect: { type: "boolean", description: "Auto-detect variants", default: true },
terms: {
type: "array",
items: { type: "string" },
description: "Specific terms to check",
},
},
},
},
{
name: "find_todos",
description: "Extract all TODO/FIXME/DRAFT markers",
inputSchema: {
type: "object",
properties: {
project_path: { type: "string", description: "Path to manuscript directory (defaults to current directory)" },
scope: { type: "string", description: "File scope pattern" },
markers: {
type: "array",
items: { type: "string" },
description: "Markers to search for",
},
group_by: {
type: "string",
enum: ["file", "priority", "marker"],
description: "Grouping method",
},
},
},
},
{
name: "check_readability",
description: "Analyze readability metrics",
inputSchema: {
type: "object",
properties: {
project_path: { type: "string", description: "Path to manuscript directory (defaults to current directory)" },
file_path: { type: "string", description: "Specific file to analyze" },
metrics: {
type: "array",
items: { type: "string" },
description: "Metrics to calculate",
},
},
},
},
{
name: "find_duplicates",
description: "Find near-duplicate content",
inputSchema: {
type: "object",
properties: {
project_path: { type: "string", description: "Path to manuscript directory (defaults to current directory)" },
scope: { type: "string", description: "File scope pattern" },
similarity_threshold: {
type: "number",
description: "Similarity threshold (0-1)",
default: 0.8,
},
min_length: { type: "number", description: "Minimum content length", default: 50 },
},
},
},
// Progress Tools (3)
{
name: "get_writing_stats",
description: "Overall project statistics",
inputSchema: {
type: "object",
properties: {
project_path: { type: "string", description: "Path to manuscript directory (defaults to current directory)" },
scope: { type: "string", description: "File scope pattern" },
breakdown_by: {
type: "string",
enum: ["chapter", "date", "tag"],
description: "Breakdown method",
},
},
},
},
{
name: "track_changes",
description: "Show what changed since timestamp",
inputSchema: {
type: "object",
properties: {
project_path: { type: "string", description: "Path to manuscript directory (defaults to current directory)" },
since: { type: "string", description: "Timestamp or relative time" },
scope: { type: "string", description: "File scope pattern" },
summary_level: {
type: "string",
enum: ["section", "file", "line"],
description: "Summary detail level",
default: "file",
},
},
},
},
{
name: "generate_progress_report",
description: "Create progress dashboard",
inputSchema: {
type: "object",
properties: {
project_path: { type: "string", description: "Path to manuscript directory (defaults to current directory)" },
target_word_count: { type: "number", description: "Target word count goal" },
scope: { type: "string", description: "File scope pattern" },
include_todos: { type: "boolean", description: "Include TODO count", default: true },
},
},
},
];
