tpmjs/packages/tools/official/diff-text-unified/README.md
Ajax Davis 5d2096fb5d feat: add 100+ official TPMJS tools
Implements a comprehensive suite of AI SDK v6 tools across multiple categories:

- Research (5): page-brief, compare-pages, source-credibility, claim-checklist, timeline-from-text
- Web (10): fetch-text, links-catalog, extract-meta, extract-json-ld, redirect-trace, sitemap-read, rss-read, table-extract, robots-policy, url-normalize
- Data (15): csv-parse, csv-stringify, json-repair, json-schema-validate, yaml-parse, yaml-stringify, text-chunk, normalize-whitespace, dedupe-by-key, pivot, rows-filter, rows-sort, rows-group-aggregate, rows-join, schema-infer
- Doc (12): toc-generate, glossary-build, faq-from-text, executive-brief, decision-record-adr, prd-outline, acceptance-criteria, style-rewrite
- Eng (12): diff-text-unified, env-var-docs-generate, dependency-audit-lite, conventional-commit-suggest, markdown-lint-basic, test-case-generate, stacktrace-parse, release-notes, changelog-entry, release-checklist
- Security (7): redact-secrets, secret-scan-text, url-risk-heuristic, csp-compose, hardening-checklist-web, access-control-matrix, data-classification-heuristic
- Stats (9): effect-size-suite, bootstrap-ci, permutation-test, multiple-testing-adjust, linear-regression-ols, logistic-regression, time-series-decompose-lite, anomaly-detect-mad
- Ops (7): slo-draft, runbook-draft, postmortem-draft, postmortem-action-extractor, error-log-triage, coverage-tracker, monitoring-gap-analysis
- Agent (15): prompt-to-workflow-skeleton, workflow-validate-io, workflow-explain, workflow-cost-estimate, tool-call-accuracy-score, eval-fixture-build, guardrail-policy-draft, workflow-auto-repair, tool-selection-plan, novelty-score-workflow, workflow-variant-generate, config-normalize, recipe-*
- Utility (8): base64-encode, base64-decode, hash-text, regex-extract, template-render, date-parse, json-path-query, url-parse
- HTML (3): html-sanitize, html-to-markdown, markdown-to-html

All tools follow AI SDK v6 pattern with tool() and jsonSchema<T>().

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
2025-12-31 22:55:56 +10:00

1.7 KiB

@tpmjs/tools-diff-text-unified

Creates unified diff between two text strings with context lines.

Installation

npm install @tpmjs/tools-diff-text-unified

Usage

import { diffTextUnified } from '@tpmjs/tools-diff-text-unified';
import { generateText } from 'ai';

const result = await generateText({
  model: yourModel,
  tools: {
    diffTextUnified,
  },
  prompt: 'Compare these two versions and show me what changed',
});

Tool Details

diffTextUnified

Creates a unified diff between two text strings, showing additions, deletions, and context lines.

Parameters:

  • original (string, required) - The original text to compare from
  • modified (string, required) - The modified text to compare to
  • contextLines (number, optional) - Number of context lines to show around changes (default: 3)

Returns:

{
  diff: string;          // The unified diff string
  additions: number;     // Number of lines added
  deletions: number;     // Number of lines deleted
  changes: number;       // Total changes (additions + deletions)
  hasChanges: boolean;   // Whether any changes were detected
  summary: string;       // Human-readable summary
}

Example Output

{
  diff: `--- original
+++ modified
@@ -1,3 +1,3 @@
 function hello() {
-  console.log('Hello');
+  console.log('Hello, World!');
 }`,
  additions: 1,
  deletions: 1,
  changes: 2,
  hasChanges: true,
  summary: "1 addition, 1 deletion"
}

Features

  • Creates standard unified diff format
  • Configurable context lines
  • Counts additions and deletions
  • Provides human-readable summary
  • Works with any text content (code, documents, etc.)

License

MIT