@compilr-dev/agents-coding-ts 0.1.4 → 0.1.6

package/LICENSE

@@ -1,13 +1,100 @@
-MIT License
+Functional Source License, Version 1.1, MIT Future License
 
-Copyright (c) 2026 scozzola
+Abbreviation: FSL-1.1-MIT
 
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
+Notice
+
+Copyright 2026 Carmelo Scozzola
+
+Terms and Conditions
+
+Licensor ("We")
+
+The party offering the Software under these Terms and Conditions.
+
+The Software
+
+The "Software" is each version of the software that we make available under
+these Terms and Conditions, as indicated by our inclusion of these Terms and
+Conditions with the Software.
+
+License Grant
+
+Subject to your compliance with this License Grant and the Patents,
+Redistribution and Trademark clauses below, we hereby grant you the right to
+use, copy, modify, create derivative works, publicly perform, publicly display
+and redistribute the Software for any Permitted Purpose identified below.
+
+Permitted Purpose
+
+A Permitted Purpose is any purpose other than a Competing Use. A Competing Use
+means making the Software available to others in a commercial product or
+service that:
+
+1. substitutes for the Software;
+
+2. substitutes for any other product or service we offer using the Software
+   that exists as of the date we make the Software available; or
+
+3. offers the same or substantially similar functionality as the Software.
+
+Permitted Purposes specifically include using the Software:
+
+1. for your internal use and access;
+
+2. for non-commercial education;
+
+3. for non-commercial research; and
+
+4. in connection with professional services that you provide to a licensee
+   using the Software in accordance with these Terms and Conditions.
+
+Patents
+
+To the extent your use for a Permitted Purpose would necessarily infringe our
+patents, the license grant above includes a license under our patents. If you
+make a claim against any party that the Software infringes or contributes to
+the infringement of any patent, then your patent license to the Software ends
+immediately.
+
+Redistribution
+
+The Terms and Conditions apply to all copies, modifications and derivatives of
+the Software.
+
+If you redistribute any copies, modifications or derivatives of the Software,
+you must include a copy of or a link to these Terms and Conditions and not
+remove any copyright notices provided in or with the Software.
+
+Disclaimer
+
+THE SOFTWARE IS PROVIDED "AS IS" AND WITHOUT WARRANTIES OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING WITHOUT LIMITATION WARRANTIES OF FITNESS FOR A PARTICULAR
+PURPOSE, MERCHANTABILITY, TITLE OR NON-INFRINGEMENT.
+
+IN NO EVENT WILL WE HAVE ANY LIABILITY TO YOU ARISING OUT OF OR RELATED TO THE
+SOFTWARE, INCLUDING INDIRECT, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES,
+EVEN IF WE HAVE BEEN INFORMED OF THEIR POSSIBILITY IN ADVANCE.
+
+Trademarks
+
+Except for displaying the License Details and identifying us as the origin of
+the Software, you have no right under these Terms and Conditions to use our
+trademarks, trade names, service marks or product names.
+
+Grant of Future License
+
+We hereby irrevocably grant you an additional license to use the Software under
+the MIT license that is effective on the second anniversary of the date we make
+the Software available. On or after that date, you may use the Software under
+the MIT license, in which case the following will apply:
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of
+this software and associated documentation files (the "Software"), to deal in
+the Software without restriction, including without limitation the rights to
+use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies
+of the Software, and to permit persons to whom the Software is furnished to do
+so, subject to the following conditions:
 
 The above copyright notice and this permission notice shall be included in all
 copies or substantial portions of the Software.

package/README.md

@@ -2,6 +2,9 @@
 
 TypeScript/JavaScript analysis tools for AI agents - AST-based code analysis using the TypeScript Compiler API.
 
+> [!WARNING]
+> This package is in beta. APIs may change between minor versions.
+
 ## Installation
 
 ```bash
@@ -46,4 +49,4 @@ agent.registerSkills(tsSkills);
 
 ## License
 
-MIT
+[FSL-1.1-MIT](https://fsl.software/) - See [LICENSE](LICENSE) for details. Converts to MIT after 2 years per version.

package/dist/tools/find-dead-code.js

@@ -9,10 +9,9 @@ import * as path from "node:path";
 import * as ts from "typescript";
 import { defineTool, createSuccessResult, createErrorResult, } from "@compilr-dev/agents";
 import { detectLanguage, isLanguageSupported, } from "../parser/typescript-parser.js";
+// Original: 'Find potentially unused exports, functions, and variables.\nAnalyzes the codebase to identify code that may be dead (never used).\nUseful for cleanup and reducing bundle size.'
 // Tool description
-const TOOL_DESCRIPTION = `Find potentially unused exports, functions, and variables.
-Analyzes the codebase to identify code that may be dead (never used).
-Useful for cleanup and reducing bundle size.`;
+const TOOL_DESCRIPTION = "Find potentially unused exports, functions, and variables in the codebase.";
 // Tool input schema
 const TOOL_INPUT_SCHEMA = {
     type: "object",

package/dist/tools/find-duplicates.js

@@ -8,10 +8,9 @@ import * as fs from "node:fs/promises";
 import * as path from "node:path";
 import * as crypto from "node:crypto";
 import { defineTool, createSuccessResult, createErrorResult, } from "@compilr-dev/agents";
+// Original: 'Detect duplicate code blocks across the codebase.\nUses content hashing to find similar code patterns.\nUseful for identifying refactoring opportunities and reducing code duplication.'
 // Tool description
-const TOOL_DESCRIPTION = `Detect duplicate code blocks across the codebase.
-Uses content hashing to find similar code patterns.
-Useful for identifying refactoring opportunities and reducing code duplication.`;
+const TOOL_DESCRIPTION = "Detect duplicate code blocks across the codebase using content hashing.";
 // Tool input schema
 const TOOL_INPUT_SCHEMA = {
     type: "object",

package/dist/tools/find-implementations.js

@@ -9,10 +9,9 @@ import * as path from "node:path";
 import * as ts from "typescript";
 import { defineTool, createSuccessResult, createErrorResult, } from "@compilr-dev/agents";
 import { detectLanguage, isLanguageSupported, } from "../parser/typescript-parser.js";
+// Original: 'Find classes that implement an interface or extend an abstract class.\nReturns information about each implementation including which methods are implemented.\nUseful for understanding how interfaces are used across the codebase.'
 // Tool description
-const TOOL_DESCRIPTION = `Find classes that implement an interface or extend an abstract class.
-Returns information about each implementation including which methods are implemented.
-Useful for understanding how interfaces are used across the codebase.`;
+const TOOL_DESCRIPTION = "Find classes that implement an interface or extend an abstract class.";
 // Tool input schema
 const TOOL_INPUT_SCHEMA = {
     type: "object",

package/dist/tools/find-patterns.js

@@ -9,10 +9,9 @@ import * as path from "node:path";
 import * as ts from "typescript";
 import { defineTool, createSuccessResult, createErrorResult, } from "@compilr-dev/agents";
 import { detectLanguage, isLanguageSupported, } from "../parser/typescript-parser.js";
+// Original: 'Find code patterns, anti-patterns, and code smells.\nSearches for common issues like security vulnerabilities, performance problems, and maintainability concerns.\nSupports built-in patterns or custom pattern definitions.'
 // Tool description
-const TOOL_DESCRIPTION = `Find code patterns, anti-patterns, and code smells.
-Searches for common issues like security vulnerabilities, performance problems, and maintainability concerns.
-Supports built-in patterns or custom pattern definitions.`;
+const TOOL_DESCRIPTION = "Find code patterns, anti-patterns, and code smells in the codebase.";
 // Tool input schema
 const TOOL_INPUT_SCHEMA = {
     type: "object",

package/dist/tools/find-references.js

@@ -24,10 +24,9 @@ const SUPPORTED_EXTENSIONS = new Set([
 function hasModifierKind(modifiers, kind) {
     return modifiers?.some((m) => m.kind === kind) ?? false;
 }
+// Original: 'Find all usages of a symbol across the codebase.\nReturns structured JSON with file paths, line numbers, and reference types.\nUse this to understand how a function, class, or variable is used throughout the project.'
 // Tool description
-const TOOL_DESCRIPTION = `Find all usages of a symbol across the codebase.
-Returns structured JSON with file paths, line numbers, and reference types.
-Use this to understand how a function, class, or variable is used throughout the project.`;
+const TOOL_DESCRIPTION = "Find all usages of a symbol across the codebase with file paths and line numbers.";
 // Tool input schema
 const TOOL_INPUT_SCHEMA = {
     type: "object",

package/dist/tools/find-symbol.js

@@ -24,10 +24,9 @@ const SUPPORTED_EXTENSIONS = new Set([
 function hasModifierKind(modifiers, kind) {
     return modifiers?.some((m) => m.kind === kind) ?? false;
 }
+// Original: 'Find the definition location of a symbol by name across the codebase.\nReturns structured JSON with file path, line number, symbol kind, and other metadata.\nUse this to locate where functions, classes, variables, types, etc. are defined.'
 // Tool description
-const TOOL_DESCRIPTION = `Find the definition location of a symbol by name across the codebase.
-Returns structured JSON with file path, line number, symbol kind, and other metadata.
-Use this to locate where functions, classes, variables, types, etc. are defined.`;
+const TOOL_DESCRIPTION = "Find the definition location of a symbol by name across the codebase.";
 // Tool input schema
 const TOOL_INPUT_SCHEMA = {
     type: "object",

package/dist/tools/get-call-graph.js

@@ -9,10 +9,9 @@ import * as path from "node:path";
 import * as ts from "typescript";
 import { defineTool, createSuccessResult, createErrorResult, } from "@compilr-dev/agents";
 import { detectLanguage, isLanguageSupported, } from "../parser/typescript-parser.js";
+// Original: 'Analyze function call relationships in source code.\nReturns a call graph showing which functions call which other functions.\nUse this to understand code flow, dependencies, and refactoring impact.'
 // Tool description
-const TOOL_DESCRIPTION = `Analyze function call relationships in source code.
-Returns a call graph showing which functions call which other functions.
-Use this to understand code flow, dependencies, and refactoring impact.`;
+const TOOL_DESCRIPTION = "Analyze function call relationships and build a call graph.";
 // Tool input schema
 const TOOL_INPUT_SCHEMA = {
     type: "object",

package/dist/tools/get-complexity.js

@@ -9,10 +9,9 @@ import * as path from "node:path";
 import * as ts from "typescript";
 import { defineTool, createSuccessResult, createErrorResult, } from "@compilr-dev/agents";
 import { detectLanguage, isLanguageSupported, } from "../parser/typescript-parser.js";
+// Original: 'Calculate code complexity metrics for files or directories.\nReturns cyclomatic complexity, cognitive complexity, nesting depth, and identifies hotspots.\nUseful for finding functions that may need refactoring.'
 // Tool description
-const TOOL_DESCRIPTION = `Calculate code complexity metrics for files or directories.
-Returns cyclomatic complexity, cognitive complexity, nesting depth, and identifies hotspots.
-Useful for finding functions that may need refactoring.`;
+const TOOL_DESCRIPTION = "Calculate code complexity metrics (cyclomatic, cognitive, nesting depth).";
 // Tool input schema
 const TOOL_INPUT_SCHEMA = {
     type: "object",

package/dist/tools/get-dependency-graph.js

@@ -10,10 +10,9 @@ import * as path from "node:path";
 import * as ts from "typescript";
 import { defineTool, createSuccessResult, createErrorResult, } from "@compilr-dev/agents";
 import { detectLanguage, isLanguageSupported, } from "../parser/typescript-parser.js";
+// Original: 'Analyze module-level dependencies across a directory.\nReturns a dependency graph showing which modules import which other modules.\nDetects circular dependencies and provides dependency statistics.'
 // Tool description
-const TOOL_DESCRIPTION = `Analyze module-level dependencies across a directory.
-Returns a dependency graph showing which modules import which other modules.
-Detects circular dependencies and provides dependency statistics.`;
+const TOOL_DESCRIPTION = "Analyze module-level dependencies and detect circular imports.";
 // Tool input schema
 const TOOL_INPUT_SCHEMA = {
     type: "object",

package/dist/tools/get-documentation.js

@@ -9,11 +9,9 @@ import * as path from "node:path";
 import * as ts from "typescript";
 import { defineTool, createSuccessResult, createErrorResult, } from "@compilr-dev/agents";
 import { detectLanguage, isLanguageSupported, } from "../parser/typescript-parser.js";
+// Original: 'Extract JSDoc/TSDoc documentation from source files.\nReturns documented symbols with their signatures and documentation content.\nCalculates documentation coverage metrics and identifies undocumented exports.\nUseful for generating API documentation and measuring doc coverage.'
 // Tool description
-const TOOL_DESCRIPTION = `Extract JSDoc/TSDoc documentation from source files.
-Returns documented symbols with their signatures and documentation content.
-Calculates documentation coverage metrics and identifies undocumented exports.
-Useful for generating API documentation and measuring doc coverage.`;
+const TOOL_DESCRIPTION = "Extract JSDoc/TSDoc documentation from source files with coverage metrics.";
 // Tool input schema
 const TOOL_INPUT_SCHEMA = {
     type: "object",

package/dist/tools/get-exports.js

@@ -9,10 +9,9 @@ import * as path from "node:path";
 import * as ts from "typescript";
 import { defineTool, createSuccessResult, createErrorResult, } from "@compilr-dev/agents";
 import { detectLanguage, isLanguageSupported, } from "../parser/typescript-parser.js";
+// Original: 'Get all exports from a module.\nReturns structured JSON with default export, named exports, and re-exports.\nUse this to understand what a module exposes to other modules.'
 // Tool description
-const TOOL_DESCRIPTION = `Get all exports from a module.
-Returns structured JSON with default export, named exports, and re-exports.
-Use this to understand what a module exposes to other modules.`;
+const TOOL_DESCRIPTION = "Get all exports from a module including default, named, and re-exports.";
 // Tool input schema
 const TOOL_INPUT_SCHEMA = {
     type: "object",

package/dist/tools/get-file-structure.js

@@ -14,10 +14,9 @@ import * as fs from "node:fs/promises";
 import * as path from "node:path";
 import { defineTool, createSuccessResult, createErrorResult, } from "@compilr-dev/agents";
 import { parseTypeScript, detectLanguage, isLanguageSupported, } from "../parser/typescript-parser.js";
+// Original: 'Analyze a source file and return its structural overview including imports, exports, classes, functions, and types.\nUse this instead of reading the full file when you need to understand what a file contains.\nReturns structured JSON that\'s much more compact than raw source code.'
 // Tool description (shared between tool and factory)
-const TOOL_DESCRIPTION = `Analyze a source file and return its structural overview including imports, exports, classes, functions, and types.
-Use this instead of reading the full file when you need to understand what a file contains.
-Returns structured JSON that's much more compact than raw source code.`;
+const TOOL_DESCRIPTION = "Analyze a source file and return its structural overview (imports, exports, classes, functions, types).";
 // Tool input schema (shared between tool and factory)
 const TOOL_INPUT_SCHEMA = {
     type: "object",

package/dist/tools/get-imports.js

@@ -20,10 +20,9 @@ const SUPPORTED_EXTENSIONS = new Set([
     ".cts",
     ".cjs",
 ]);
+// Original: 'Get detailed import information for a file or module.\nReturns structured JSON with import sources, symbols, and whether imports are external or internal.\nUse this to understand a file\'s dependencies and what it imports from other modules.'
 // Tool description
-const TOOL_DESCRIPTION = `Get detailed import information for a file or module.
-Returns structured JSON with import sources, symbols, and whether imports are external or internal.
-Use this to understand a file's dependencies and what it imports from other modules.`;
+const TOOL_DESCRIPTION = "Get detailed import information for a file or module with sources and symbols.";
 // Tool input schema
 const TOOL_INPUT_SCHEMA = {
     type: "object",

package/dist/tools/get-signature.js

@@ -9,10 +9,9 @@ import * as path from "node:path";
 import * as ts from "typescript";
 import { defineTool, createSuccessResult, createErrorResult, } from "@compilr-dev/agents";
 import { detectLanguage, isLanguageSupported, } from "../parser/typescript-parser.js";
+// Original: 'Get detailed signature information for a function, method, class, interface, or type.\nReturns parameters with types, return type, generics, and extracted documentation (JSDoc/TSDoc).\nUseful for understanding API contracts without reading full source code.'
 // Tool description
-const TOOL_DESCRIPTION = `Get detailed signature information for a function, method, class, interface, or type.
-Returns parameters with types, return type, generics, and extracted documentation (JSDoc/TSDoc).
-Useful for understanding API contracts without reading full source code.`;
+const TOOL_DESCRIPTION = "Get function/class signature with parameters, return type, generics, and docs.";
 // Tool input schema
 const TOOL_INPUT_SCHEMA = {
     type: "object",

package/dist/tools/get-type-hierarchy.js

@@ -9,10 +9,9 @@ import * as path from "node:path";
 import * as ts from "typescript";
 import { defineTool, createSuccessResult, createErrorResult, } from "@compilr-dev/agents";
 import { detectLanguage, isLanguageSupported, } from "../parser/typescript-parser.js";
+// Original: 'Analyze the inheritance hierarchy of a class or interface.\nReturns the type\'s ancestors (what it extends/implements) and descendants (what extends/implements it).\nUseful for understanding class hierarchies and interface relationships.'
 // Tool description
-const TOOL_DESCRIPTION = `Analyze the inheritance hierarchy of a class or interface.
-Returns the type's ancestors (what it extends/implements) and descendants (what extends/implements it).
-Useful for understanding class hierarchies and interface relationships.`;
+const TOOL_DESCRIPTION = "Analyze inheritance hierarchy of a class or interface showing ancestors and descendants.";
 // Tool input schema
 const TOOL_INPUT_SCHEMA = {
     type: "object",

package/dist/tools/read-symbol.js

@@ -194,11 +194,10 @@ async function executeReadFunction(input) {
         return createErrorResult(`Failed to read function: ${error instanceof Error ? error.message : String(error)}`);
     }
 }
+// Original: 'Read a specific function or method by name. Returns the exact source code without guessing line numbers. Use this instead of read_file when you need to see a specific function. For methods, specify the className parameter.'
 export const readFunctionTool = defineTool({
     name: "read_function",
-    description: "Read a specific function or method by name. Returns the exact source code without guessing line numbers. " +
-        "Use this instead of read_file when you need to see a specific function. " +
-        "For methods, specify the className parameter.",
+    description: "Read a specific function or method by name. Returns exact source code.",
     inputSchema: {
         type: "object",
         properties: {
@@ -318,10 +317,10 @@ async function executeReadClass(input) {
         return createErrorResult(`Failed to read class: ${error instanceof Error ? error.message : String(error)}`);
     }
 }
+// Original: 'Read a specific class by name. Returns the exact source code without guessing line numbers. Use the include parameter to get: full class, signature only, methods only, or properties only.'
 export const readClassTool = defineTool({
     name: "read_class",
-    description: "Read a specific class by name. Returns the exact source code without guessing line numbers. " +
-        "Use the include parameter to get: full class, signature only, methods only, or properties only.",
+    description: "Read a specific class by name. Returns exact source code.",
     inputSchema: {
         type: "object",
         properties: {
@@ -426,10 +425,10 @@ async function executeReadType(input) {
         return createErrorResult(`Failed to read type: ${error instanceof Error ? error.message : String(error)}`);
     }
 }
+// Original: 'Read a specific type, interface, or enum by name. Returns the exact source code without guessing line numbers. Works for TypeScript interfaces, type aliases, and enums.'
 export const readTypeTool = defineTool({
     name: "read_type",
-    description: "Read a specific type, interface, or enum by name. Returns the exact source code without guessing line numbers. " +
-        "Works for TypeScript interfaces, type aliases, and enums.",
+    description: "Read a specific type, interface, or enum by name. Returns exact source code.",
     inputSchema: {
         type: "object",
         properties: {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@compilr-dev/agents-coding-ts",
-  "version": "0.1.4",
+  "version": "0.1.6",
   "description": "TypeScript/JavaScript analysis tools for AI agents - AST-based code analysis, complexity metrics, and type hierarchy",
   "type": "module",
   "main": "dist/index.js",
@@ -56,13 +56,13 @@
     "tools"
   ],
   "author": "Carmelo Scozzola",
-  "license": "MIT",
+  "license": "FSL-1.1-MIT",
   "bugs": {
     "url": "https://github.com/compilr-dev/agents-coding/issues"
   },
   "homepage": "https://github.com/compilr-dev/agents-coding#readme",
   "engines": {
-    "node": ">=18.0.0"
+    "node": ">=20.0.0"
   },
   "peerDependencies": {
     "@compilr-dev/agents": "^0.3.1"
@@ -71,14 +71,14 @@
     "typescript": "^5.3.0"
   },
   "devDependencies": {
-    "@anthropic-ai/sdk": "^0.30.1",
-    "@compilr-dev/agents": "^0.3.1",
+    "@anthropic-ai/sdk": "^0.74.0",
+    "@compilr-dev/agents": "^0.3.11",
     "@eslint/js": "^9.39.1",
-    "@types/node": "^24.10.1",
-    "@vitest/coverage-v8": "^3.2.4",
+    "@types/node": "^25.2.3",
+    "@vitest/coverage-v8": "^4.0.18",
     "eslint": "^9.39.1",
     "prettier": "^3.7.1",
     "typescript-eslint": "^8.48.0",
-    "vitest": "^3.2.4"
+    "vitest": "^4.0.18"
   }
 }