agent-toolbelt 0.2.2 → 0.2.4

package/README.md

@@ -2,7 +2,7 @@
 
 Official SDK for [Agent Toolbelt](https://agent-toolbelt-production.up.railway.app) — a suite of focused API tools for AI agents and developers.
 
-**Typed client + LangChain tool wrappers** for schema generation, text extraction, token counting, CSV conversion, Markdown conversion, URL metadata, regex building, cron expressions, address normalization, color palette generation, and brand kit creation.
+**Typed client + LangChain tool wrappers** for schema generation, text extraction, token counting, CSV conversion, Markdown conversion, URL metadata, regex building, cron expressions, address normalization, color palette generation, brand kit creation, meeting action item extraction, and prompt optimization.
 
 ## Install
 
@@ -121,6 +121,12 @@ await client.colorPalette({ description: "calm fintech blue", count: 5 });
 
 // Generate a full brand kit — colors, typography, CSS/Tailwind tokens
 await client.brandKit({ name: "Solaris Health", industry: "healthcare", vibe: ["modern", "trustworthy"], format: "full" });
+
+// Extract action items, decisions, and summary from meeting notes
+await client.meetingActionItems({ notes: transcript, format: "full", participants: ["Sarah", "John"] });
+
+// Analyze and improve an LLM prompt
+await client.promptOptimizer({ prompt: "Summarize this and tell me the main points.", model: "gpt-4o", mode: "both" });
 ```
 
 ---
@@ -163,6 +169,9 @@ const result = await agent.invoke({
 | `normalize_address` | Normalize US addresses to USPS format |
 | `generate_color_palette` | Generate color palettes with WCAG scores and CSS variables |
 | `generate_brand_kit` | Generate full brand kit — colors, typography, CSS/Tailwind tokens |
+| `strip_image_metadata` | Strip EXIF/GPS/IPTC/XMP metadata from images for privacy |
+| `extract_meeting_action_items` | Extract action items, decisions, and summary from meeting notes |
+| `optimize_prompt` | Analyze and improve LLM prompts with scores and rewrite |
 
 ---
 
@@ -181,6 +190,9 @@ const result = await agent.invoke({
 | `address-normalizer` | $0.0005 / call |
 | `color-palette` | $0.0005 / call |
 | `brand-kit` | $0.001 / call |
+| `image-metadata-stripper` | $0.001 / call |
+| `meeting-action-items` | $0.05 / call |
+| `prompt-optimizer` | $0.05 / call |
 
 ## License
 

package/dist/index.d.mts

@@ -185,6 +185,73 @@ 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;
+    scores?: {
+        clarity: number;
+        specificity: number;
+        structure: number;
+        completeness: number;
+        overall: number;
+    };
+    issues?: string[];
+    suggestions?: string[];
+    improvedPrompt?: string;
+    changesSummary?: string[];
+    tokenStats: {
+        original: number;
+        improved?: number;
+        delta?: number;
+    };
+}
 interface MeetingActionItem {
     id: number;
     owner: string;
@@ -294,6 +361,26 @@ 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;
+        model?: string;
+        task?: string;
+        mode?: "improve" | "analyze" | "both";
+    }): Promise<PromptOptimizerResult>;
     /** Extract action items, decisions, and summary from meeting notes or transcripts */
     meetingActionItems(input: {
         notes: string;
@@ -316,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 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,73 @@ 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;
+    scores?: {
+        clarity: number;
+        specificity: number;
+        structure: number;
+        completeness: number;
+        overall: number;
+    };
+    issues?: string[];
+    suggestions?: string[];
+    improvedPrompt?: string;
+    changesSummary?: string[];
+    tokenStats: {
+        original: number;
+        improved?: number;
+        delta?: number;
+    };
+}
 interface MeetingActionItem {
     id: number;
     owner: string;
@@ -294,6 +361,26 @@ 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;
+        model?: string;
+        task?: string;
+        mode?: "improve" | "analyze" | "both";
+    }): Promise<PromptOptimizerResult>;
     /** Extract action items, decisions, and summary from meeting notes or transcripts */
     meetingActionItems(input: {
         notes: string;
@@ -316,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 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,18 @@ 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);
+  }
   /** Extract action items, decisions, and summary from meeting notes or transcripts */
   meetingActionItems(input) {
     return this.call("meeting-action-items", input);

package/dist/index.mjs

@@ -64,6 +64,18 @@ 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);
+  }
   /** Extract action items, decisions, and summary from meeting notes or transcripts */
   meetingActionItems(input) {
     return this.call("meeting-action-items", input);

package/dist/langchain.js

@@ -165,6 +165,50 @@ 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",
+      description: "Analyze and improve an LLM prompt for clarity, specificity, structure, and completeness. Use this when a prompt isn't performing well, to prepare prompts before deploying them, or to learn what makes a good prompt for a specific model. Returns scores (1-10) for each quality dimension, a list of issues found, an improved rewrite, and a summary of what changed and why. Supports targeting specific models: gpt-4o, claude-3-5-sonnet, gpt-3.5-turbo, etc.",
+      schema: import_zod.z.object({
+        prompt: import_zod.z.string().describe("The LLM prompt to analyze and/or improve"),
+        model: import_zod.z.string().default("gpt-4o").describe("Target model to optimize for"),
+        task: import_zod.z.string().optional().describe("What this prompt is trying to accomplish (helps generate targeted suggestions)"),
+        mode: import_zod.z.enum(["improve", "analyze", "both"]).default("both").describe("'both' returns analysis + improved prompt; 'analyze' scores only; 'improve' rewrites only")
+      }),
+      func: async ({ prompt, model, task, mode }) => {
+        const result = await client.promptOptimizer({ prompt, model, task, mode });
+        return JSON.stringify(result);
+      }
+    }),
     // ---- Meeting Action Items ----
     new import_tools.DynamicStructuredTool({
       name: "extract_meeting_action_items",

package/dist/langchain.mjs

@@ -141,6 +141,50 @@ 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",
+      description: "Analyze and improve an LLM prompt for clarity, specificity, structure, and completeness. Use this when a prompt isn't performing well, to prepare prompts before deploying them, or to learn what makes a good prompt for a specific model. Returns scores (1-10) for each quality dimension, a list of issues found, an improved rewrite, and a summary of what changed and why. Supports targeting specific models: gpt-4o, claude-3-5-sonnet, gpt-3.5-turbo, etc.",
+      schema: z.object({
+        prompt: z.string().describe("The LLM prompt to analyze and/or improve"),
+        model: z.string().default("gpt-4o").describe("Target model to optimize for"),
+        task: z.string().optional().describe("What this prompt is trying to accomplish (helps generate targeted suggestions)"),
+        mode: z.enum(["improve", "analyze", "both"]).default("both").describe("'both' returns analysis + improved prompt; 'analyze' scores only; 'improve' rewrites only")
+      }),
+      func: async ({ prompt, model, task, mode }) => {
+        const result = await client.promptOptimizer({ prompt, model, task, mode });
+        return JSON.stringify(result);
+      }
+    }),
     // ---- Meeting Action Items ----
     new DynamicStructuredTool({
       name: "extract_meeting_action_items",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agent-toolbelt",
-  "version": "0.2.2",
+  "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",