agent-toolbelt 0.2.3 → 0.2.4

package/dist/index.d.mts

@@ -185,6 +185,53 @@ interface BrandKitResult {
         googleFontsUrl?: string;
     };
 }
+interface DocumentComparatorResult {
+    mode: string;
+    summary: string;
+    overallAssessment: "minor" | "moderate" | "major";
+    analysis?: string;
+    additions?: Array<{
+        description: string;
+        content: string;
+        significance: "high" | "medium" | "low";
+    }>;
+    deletions?: Array<{
+        description: string;
+        content: string;
+        significance: "high" | "medium" | "low";
+    }>;
+    modifications?: Array<{
+        description: string;
+        before: string;
+        after: string;
+        significance: "high" | "medium" | "low";
+    }>;
+    stats: {
+        additions: number;
+        deletions: number;
+        modifications: number;
+    };
+}
+interface ContractClauseResult {
+    found: boolean;
+    summary?: string;
+    excerpt?: string | null;
+    details?: Record<string, unknown>;
+}
+interface ContractRiskFlag {
+    clause: string;
+    issue: string;
+    severity: "high" | "medium" | "low";
+    excerpt: string;
+}
+interface ContractClauseExtractorResult {
+    contractType: string;
+    clausesRequested: number;
+    clausesFound: number;
+    clauses: Record<string, ContractClauseResult>;
+    riskFlags?: ContractRiskFlag[];
+    riskSummary?: string;
+}
 interface PromptOptimizerResult {
     mode: "improve" | "analyze" | "both";
     model: string;
@@ -314,6 +361,19 @@ declare class AgentToolbelt {
         format?: "hex" | "rgb" | "hsl" | "all";
         includeShades?: boolean;
     }): Promise<ColorPaletteResult>;
+    /** Compare two document versions and produce a semantic diff */
+    documentComparator(input: {
+        original: string;
+        revised: string;
+        mode?: "summary" | "detailed" | "structured";
+        context?: string;
+    }): Promise<DocumentComparatorResult>;
+    /** Extract and analyze key clauses from a contract or legal document */
+    contractClauseExtractor(input: {
+        contract: string;
+        clauses?: Array<"parties" | "dates" | "payment_terms" | "termination" | "liability" | "ip_ownership" | "confidentiality" | "governing_law" | "penalties" | "renewal" | "warranties" | "dispute_resolution">;
+        flagRisks?: boolean;
+    }): Promise<ContractClauseExtractorResult>;
     /** Analyze and improve an LLM prompt — scores clarity, specificity, structure, and completeness */
     promptOptimizer(input: {
         prompt: string;
@@ -343,4 +403,4 @@ declare class AgentToolbelt {
     }): Promise<BrandKitResult>;
 }
 
-export { type AddressNormalizerResult, AgentToolbelt, type AgentToolbeltOptions, type BrandKitResult, type ColorPaletteResult, type CronBuilderResult, type CsvToJsonResult, type ImageMetadataStripperResult, type MarkdownConverterResult, type MeetingActionItem, type MeetingActionItemsResult, type PromptOptimizerResult, type RegexBuilderResult, type SchemaGeneratorResult, type TextExtractorResult, type TokenCountResult, type UrlMetadataResult };
+export { type AddressNormalizerResult, AgentToolbelt, type AgentToolbeltOptions, type BrandKitResult, type ColorPaletteResult, type ContractClauseExtractorResult, type ContractClauseResult, type ContractRiskFlag, type CronBuilderResult, type CsvToJsonResult, type DocumentComparatorResult, type ImageMetadataStripperResult, type MarkdownConverterResult, type MeetingActionItem, type MeetingActionItemsResult, type PromptOptimizerResult, type RegexBuilderResult, type SchemaGeneratorResult, type TextExtractorResult, type TokenCountResult, type UrlMetadataResult };

package/dist/index.d.ts

@@ -185,6 +185,53 @@ interface BrandKitResult {
         googleFontsUrl?: string;
     };
 }
+interface DocumentComparatorResult {
+    mode: string;
+    summary: string;
+    overallAssessment: "minor" | "moderate" | "major";
+    analysis?: string;
+    additions?: Array<{
+        description: string;
+        content: string;
+        significance: "high" | "medium" | "low";
+    }>;
+    deletions?: Array<{
+        description: string;
+        content: string;
+        significance: "high" | "medium" | "low";
+    }>;
+    modifications?: Array<{
+        description: string;
+        before: string;
+        after: string;
+        significance: "high" | "medium" | "low";
+    }>;
+    stats: {
+        additions: number;
+        deletions: number;
+        modifications: number;
+    };
+}
+interface ContractClauseResult {
+    found: boolean;
+    summary?: string;
+    excerpt?: string | null;
+    details?: Record<string, unknown>;
+}
+interface ContractRiskFlag {
+    clause: string;
+    issue: string;
+    severity: "high" | "medium" | "low";
+    excerpt: string;
+}
+interface ContractClauseExtractorResult {
+    contractType: string;
+    clausesRequested: number;
+    clausesFound: number;
+    clauses: Record<string, ContractClauseResult>;
+    riskFlags?: ContractRiskFlag[];
+    riskSummary?: string;
+}
 interface PromptOptimizerResult {
     mode: "improve" | "analyze" | "both";
     model: string;
@@ -314,6 +361,19 @@ declare class AgentToolbelt {
         format?: "hex" | "rgb" | "hsl" | "all";
         includeShades?: boolean;
     }): Promise<ColorPaletteResult>;
+    /** Compare two document versions and produce a semantic diff */
+    documentComparator(input: {
+        original: string;
+        revised: string;
+        mode?: "summary" | "detailed" | "structured";
+        context?: string;
+    }): Promise<DocumentComparatorResult>;
+    /** Extract and analyze key clauses from a contract or legal document */
+    contractClauseExtractor(input: {
+        contract: string;
+        clauses?: Array<"parties" | "dates" | "payment_terms" | "termination" | "liability" | "ip_ownership" | "confidentiality" | "governing_law" | "penalties" | "renewal" | "warranties" | "dispute_resolution">;
+        flagRisks?: boolean;
+    }): Promise<ContractClauseExtractorResult>;
     /** Analyze and improve an LLM prompt — scores clarity, specificity, structure, and completeness */
     promptOptimizer(input: {
         prompt: string;
@@ -343,4 +403,4 @@ declare class AgentToolbelt {
     }): Promise<BrandKitResult>;
 }
 
-export { type AddressNormalizerResult, AgentToolbelt, type AgentToolbeltOptions, type BrandKitResult, type ColorPaletteResult, type CronBuilderResult, type CsvToJsonResult, type ImageMetadataStripperResult, type MarkdownConverterResult, type MeetingActionItem, type MeetingActionItemsResult, type PromptOptimizerResult, type RegexBuilderResult, type SchemaGeneratorResult, type TextExtractorResult, type TokenCountResult, type UrlMetadataResult };
+export { type AddressNormalizerResult, AgentToolbelt, type AgentToolbeltOptions, type BrandKitResult, type ColorPaletteResult, type ContractClauseExtractorResult, type ContractClauseResult, type ContractRiskFlag, type CronBuilderResult, type CsvToJsonResult, type DocumentComparatorResult, type ImageMetadataStripperResult, type MarkdownConverterResult, type MeetingActionItem, type MeetingActionItemsResult, type PromptOptimizerResult, type RegexBuilderResult, type SchemaGeneratorResult, type TextExtractorResult, type TokenCountResult, type UrlMetadataResult };

package/dist/index.js

@@ -90,6 +90,14 @@ var AgentToolbelt = class {
   colorPalette(input) {
     return this.call("color-palette", input);
   }
+  /** Compare two document versions and produce a semantic diff */
+  documentComparator(input) {
+    return this.call("document-comparator", input);
+  }
+  /** Extract and analyze key clauses from a contract or legal document */
+  contractClauseExtractor(input) {
+    return this.call("contract-clause-extractor", input);
+  }
   /** Analyze and improve an LLM prompt — scores clarity, specificity, structure, and completeness */
   promptOptimizer(input) {
     return this.call("prompt-optimizer", input);

package/dist/index.mjs

@@ -64,6 +64,14 @@ var AgentToolbelt = class {
   colorPalette(input) {
     return this.call("color-palette", input);
   }
+  /** Compare two document versions and produce a semantic diff */
+  documentComparator(input) {
+    return this.call("document-comparator", input);
+  }
+  /** Extract and analyze key clauses from a contract or legal document */
+  contractClauseExtractor(input) {
+    return this.call("contract-clause-extractor", input);
+  }
   /** Analyze and improve an LLM prompt — scores clarity, specificity, structure, and completeness */
   promptOptimizer(input) {
     return this.call("prompt-optimizer", input);

package/dist/langchain.js

@@ -165,6 +165,35 @@ function createLangChainTools(client) {
         return JSON.stringify(result);
       }
     }),
+    // ---- Document Comparator ----
+    new import_tools.DynamicStructuredTool({
+      name: "compare_documents",
+      description: "Compare two versions of a document and produce a semantic diff. Use this to understand what changed between drafts, versions, or revisions of any text document \u2014 contracts, READMEs, policies, essays, terms of service, code documentation, etc. Returns additions, deletions, and modifications with significance ratings and an overall change assessment. The 'structured' mode gives a categorized breakdown; 'summary' gives a quick overview; 'detailed' gives full prose analysis.",
+      schema: import_zod.z.object({
+        original: import_zod.z.string().describe("The original version of the document"),
+        revised: import_zod.z.string().describe("The revised version of the document"),
+        mode: import_zod.z.enum(["summary", "detailed", "structured"]).default("structured").describe("Output format: 'structured' (categorized lists), 'detailed' (prose), 'summary' (brief overview)"),
+        context: import_zod.z.string().optional().describe("Document type for more relevant analysis (e.g. 'terms of service', 'employment contract')")
+      }),
+      func: async ({ original, revised, mode, context }) => {
+        const result = await client.documentComparator({ original, revised, mode, context });
+        return JSON.stringify(result);
+      }
+    }),
+    // ---- Contract Clause Extractor ----
+    new import_tools.DynamicStructuredTool({
+      name: "extract_contract_clauses",
+      description: "Extract and analyze key clauses from a contract or legal document. Use this to quickly understand the key terms in any legal agreement \u2014 who the parties are, payment terms, termination conditions, liability caps, IP ownership, confidentiality obligations, and more. Optionally flags risky or one-sided clauses with severity ratings and plain-language explanations. Ideal for contract review, due diligence, or surfacing terms that need negotiation.",
+      schema: import_zod.z.object({
+        contract: import_zod.z.string().describe("The contract or legal document text to analyze"),
+        clauses: import_zod.z.array(import_zod.z.enum(["parties", "dates", "payment_terms", "termination", "liability", "ip_ownership", "confidentiality", "governing_law", "penalties", "renewal", "warranties", "dispute_resolution"])).default(["parties", "dates", "payment_terms", "termination", "liability", "ip_ownership", "confidentiality", "governing_law", "penalties", "renewal", "warranties", "dispute_resolution"]).describe("Which clause types to extract"),
+        flagRisks: import_zod.z.boolean().default(true).describe("Flag clauses that may be unfavorable or risky")
+      }),
+      func: async ({ contract, clauses, flagRisks }) => {
+        const result = await client.contractClauseExtractor({ contract, clauses, flagRisks });
+        return JSON.stringify(result);
+      }
+    }),
     // ---- Prompt Optimizer ----
     new import_tools.DynamicStructuredTool({
       name: "optimize_prompt",

package/dist/langchain.mjs

@@ -141,6 +141,35 @@ function createLangChainTools(client) {
         return JSON.stringify(result);
       }
     }),
+    // ---- Document Comparator ----
+    new DynamicStructuredTool({
+      name: "compare_documents",
+      description: "Compare two versions of a document and produce a semantic diff. Use this to understand what changed between drafts, versions, or revisions of any text document \u2014 contracts, READMEs, policies, essays, terms of service, code documentation, etc. Returns additions, deletions, and modifications with significance ratings and an overall change assessment. The 'structured' mode gives a categorized breakdown; 'summary' gives a quick overview; 'detailed' gives full prose analysis.",
+      schema: z.object({
+        original: z.string().describe("The original version of the document"),
+        revised: z.string().describe("The revised version of the document"),
+        mode: z.enum(["summary", "detailed", "structured"]).default("structured").describe("Output format: 'structured' (categorized lists), 'detailed' (prose), 'summary' (brief overview)"),
+        context: z.string().optional().describe("Document type for more relevant analysis (e.g. 'terms of service', 'employment contract')")
+      }),
+      func: async ({ original, revised, mode, context }) => {
+        const result = await client.documentComparator({ original, revised, mode, context });
+        return JSON.stringify(result);
+      }
+    }),
+    // ---- Contract Clause Extractor ----
+    new DynamicStructuredTool({
+      name: "extract_contract_clauses",
+      description: "Extract and analyze key clauses from a contract or legal document. Use this to quickly understand the key terms in any legal agreement \u2014 who the parties are, payment terms, termination conditions, liability caps, IP ownership, confidentiality obligations, and more. Optionally flags risky or one-sided clauses with severity ratings and plain-language explanations. Ideal for contract review, due diligence, or surfacing terms that need negotiation.",
+      schema: z.object({
+        contract: z.string().describe("The contract or legal document text to analyze"),
+        clauses: z.array(z.enum(["parties", "dates", "payment_terms", "termination", "liability", "ip_ownership", "confidentiality", "governing_law", "penalties", "renewal", "warranties", "dispute_resolution"])).default(["parties", "dates", "payment_terms", "termination", "liability", "ip_ownership", "confidentiality", "governing_law", "penalties", "renewal", "warranties", "dispute_resolution"]).describe("Which clause types to extract"),
+        flagRisks: z.boolean().default(true).describe("Flag clauses that may be unfavorable or risky")
+      }),
+      func: async ({ contract, clauses, flagRisks }) => {
+        const result = await client.contractClauseExtractor({ contract, clauses, flagRisks });
+        return JSON.stringify(result);
+      }
+    }),
     // ---- Prompt Optimizer ----
     new DynamicStructuredTool({
       name: "optimize_prompt",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agent-toolbelt",
-  "version": "0.2.3",
+  "version": "0.2.4",
   "description": "Official SDK for Agent Toolbelt — typed API client and LangChain tool wrappers for schema generation, text extraction, token counting, CSV conversion, and more.",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",