@compilr-dev/agents-coding-go 0.1.3 → 0.1.4

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 @@
 
 Go analysis tools for AI agents - AST-based code analysis using Tree-sitter.
 
+> [!WARNING]
+> This package is in beta. APIs may change between minor versions.
+
 ## Installation
 
 ```bash
@@ -45,4 +48,4 @@ agent.registerSkills(goSkills);
 
 ## License
 
-MIT
+[FSL-1.1-MIT](https://fsl.software/) - See [LICENSE](LICENSE) for details. Converts to MIT after 2 years per version.

package/dist/index.d.ts

@@ -28,6 +28,9 @@ export declare const goTools: {
     readonly getDependencyGraph: import("@compilr-dev/agents").Tool<import("./tools/get-dependency-graph.js").GetDependencyGraphInput>;
     readonly getSignature: import("@compilr-dev/agents").Tool<import("./tools/get-signature.js").GetSignatureInput>;
     readonly getExports: import("@compilr-dev/agents").Tool<import("./tools/get-exports.js").GetExportsInput>;
+    readonly readFunction: import("@compilr-dev/agents").Tool<import("./tools/read-symbol.js").ReadFunctionInput>;
+    readonly readStruct: import("@compilr-dev/agents").Tool<import("./tools/read-symbol.js").ReadStructInput>;
+    readonly readType: import("@compilr-dev/agents").Tool<import("./tools/read-symbol.js").ReadTypeInput>;
 };
 /**
  * Array of all Go tools

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,cAAc,mBAAmB,CAAC;AAGlC,cAAc,kBAAkB,CAAC;AAGjC,cAAc,mBAAmB,CAAC;AAGlC,OAAO,EAAE,UAAU,EAAc,MAAM,kBAAkB,CAAC;AAC1D,OAAO,EACL,QAAQ,EACR,WAAW,EACX,oBAAoB,EACpB,iBAAiB,EACjB,oBAAoB,EACpB,sBAAsB,EACtB,qBAAqB,EACtB,MAAM,mBAAmB,CAAC;AAE3B;;GAEG;AACH,eAAO,MAAM,OAAO;;;;;;;;;;;;;;;;CAAa,CAAC;AAElC;;GAEG;AACH,OAAO,EAAE,UAAU,EAAE,CAAC;AAEtB;;GAEG;AACH,OAAO,EACL,QAAQ,EACR,WAAW,EACX,oBAAoB,EACpB,iBAAiB,EACjB,oBAAoB,EACpB,sBAAsB,EACtB,qBAAqB,GACtB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,cAAc,mBAAmB,CAAC;AAGlC,cAAc,kBAAkB,CAAC;AAGjC,cAAc,mBAAmB,CAAC;AAGlC,OAAO,EAAE,UAAU,EAAc,MAAM,kBAAkB,CAAC;AAC1D,OAAO,EACL,QAAQ,EACR,WAAW,EACX,oBAAoB,EACpB,iBAAiB,EACjB,oBAAoB,EACpB,sBAAsB,EACtB,qBAAqB,EACtB,MAAM,mBAAmB,CAAC;AAE3B;;GAEG;AACH,eAAO,MAAM,OAAO;;;;;;;;;;;;;;;;;;;CAAa,CAAC;AAElC;;GAEG;AACH,OAAO,EAAE,UAAU,EAAE,CAAC;AAEtB;;GAEG;AACH,OAAO,EACL,QAAQ,EACR,WAAW,EACX,oBAAoB,EACpB,iBAAiB,EACjB,oBAAoB,EACpB,sBAAsB,EACtB,qBAAqB,GACtB,CAAC"}

package/dist/tools/index.d.ts

@@ -18,6 +18,7 @@ export { getCallGraphTool, createGetCallGraphTool } from "./get-call-graph.js";
 export { getDependencyGraphTool, createGetDependencyGraphTool, } from "./get-dependency-graph.js";
 export { getSignatureTool, createGetSignatureTool } from "./get-signature.js";
 export { getExportsTool, createGetExportsTool } from "./get-exports.js";
+export { readFunctionTool, createReadFunctionTool, readStructTool, createReadStructTool, readTypeTool, createReadTypeTool, } from "./read-symbol.js";
 export * from "./types.js";
 export type { GetFileStructureInput } from "./get-file-structure.js";
 export type { FindSymbolInput, FindSymbolResult, GoSymbolDefinition, GoSymbolKind, GoSymbolKindFilter, } from "./find-symbol.js";
@@ -34,7 +35,8 @@ export type { GetCallGraphInput, GetCallGraphResult, CallGraphDirection, CallTyp
 export type { GetDependencyGraphInput, GetDependencyGraphResult, ModuleNode, DependencyEdge, CircularDependency, DependencyGraphStats, } from "./get-dependency-graph.js";
 export type { GetSignatureInput, GetSignatureResult, ParameterDetail, ReturnTypeDetail, MemberSignature, Documentation, } from "./get-signature.js";
 export type { GetExportsInput, GetExportsResult, ExportedSymbol, ExportKind, ReExport, ExportStats, } from "./get-exports.js";
-export declare const allGoTools: readonly [import("@compilr-dev/agents").Tool<import("./get-file-structure.js").GetFileStructureInput>, import("@compilr-dev/agents").Tool<import("./find-symbol.js").FindSymbolInput>, import("@compilr-dev/agents").Tool<import("./find-references.js").FindReferencesInput>, import("@compilr-dev/agents").Tool<import("./get-imports.js").GetImportsInput>, import("@compilr-dev/agents").Tool<import("./get-class-hierarchy.js").GetClassHierarchyInput>, import("@compilr-dev/agents").Tool<import("./get-complexity.js").GetComplexityInput>, import("@compilr-dev/agents").Tool<import("./extract-docstrings.js").ExtractDocstringsInput>, import("@compilr-dev/agents").Tool<import("./find-dead-code.js").FindDeadCodeInput>, import("@compilr-dev/agents").Tool<import("./find-duplicates.js").FindDuplicatesInput>, import("@compilr-dev/agents").Tool<import("./find-implementations.js").FindImplementationsInput>, import("@compilr-dev/agents").Tool<import("./find-patterns.js").FindPatternsInput>, import("@compilr-dev/agents").Tool<import("./get-call-graph.js").GetCallGraphInput>, import("@compilr-dev/agents").Tool<import("./get-dependency-graph.js").GetDependencyGraphInput>, import("@compilr-dev/agents").Tool<import("./get-signature.js").GetSignatureInput>, import("@compilr-dev/agents").Tool<import("./get-exports.js").GetExportsInput>];
+export type { ReadFunctionInput, ReadStructInput, ReadTypeInput, ReadSymbolResult, } from "./read-symbol.js";
+export declare const allGoTools: readonly [import("@compilr-dev/agents").Tool<import("./get-file-structure.js").GetFileStructureInput>, import("@compilr-dev/agents").Tool<import("./find-symbol.js").FindSymbolInput>, import("@compilr-dev/agents").Tool<import("./find-references.js").FindReferencesInput>, import("@compilr-dev/agents").Tool<import("./get-imports.js").GetImportsInput>, import("@compilr-dev/agents").Tool<import("./get-class-hierarchy.js").GetClassHierarchyInput>, import("@compilr-dev/agents").Tool<import("./get-complexity.js").GetComplexityInput>, import("@compilr-dev/agents").Tool<import("./extract-docstrings.js").ExtractDocstringsInput>, import("@compilr-dev/agents").Tool<import("./find-dead-code.js").FindDeadCodeInput>, import("@compilr-dev/agents").Tool<import("./find-duplicates.js").FindDuplicatesInput>, import("@compilr-dev/agents").Tool<import("./find-implementations.js").FindImplementationsInput>, import("@compilr-dev/agents").Tool<import("./find-patterns.js").FindPatternsInput>, import("@compilr-dev/agents").Tool<import("./get-call-graph.js").GetCallGraphInput>, import("@compilr-dev/agents").Tool<import("./get-dependency-graph.js").GetDependencyGraphInput>, import("@compilr-dev/agents").Tool<import("./get-signature.js").GetSignatureInput>, import("@compilr-dev/agents").Tool<import("./get-exports.js").GetExportsInput>, import("@compilr-dev/agents").Tool<import("./read-symbol.js").ReadFunctionInput>, import("@compilr-dev/agents").Tool<import("./read-symbol.js").ReadStructInput>, import("@compilr-dev/agents").Tool<import("./read-symbol.js").ReadTypeInput>];
 export declare const goToolsMap: {
     readonly getFileStructure: import("@compilr-dev/agents").Tool<import("./get-file-structure.js").GetFileStructureInput>;
     readonly findSymbol: import("@compilr-dev/agents").Tool<import("./find-symbol.js").FindSymbolInput>;
@@ -51,5 +53,8 @@ export declare const goToolsMap: {
     readonly getDependencyGraph: import("@compilr-dev/agents").Tool<import("./get-dependency-graph.js").GetDependencyGraphInput>;
     readonly getSignature: import("@compilr-dev/agents").Tool<import("./get-signature.js").GetSignatureInput>;
     readonly getExports: import("@compilr-dev/agents").Tool<import("./get-exports.js").GetExportsInput>;
+    readonly readFunction: import("@compilr-dev/agents").Tool<import("./read-symbol.js").ReadFunctionInput>;
+    readonly readStruct: import("@compilr-dev/agents").Tool<import("./read-symbol.js").ReadStructInput>;
+    readonly readType: import("@compilr-dev/agents").Tool<import("./read-symbol.js").ReadTypeInput>;
 };
 //# sourceMappingURL=index.d.ts.map

package/dist/tools/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"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"}

package/dist/tools/index.js

@@ -19,6 +19,7 @@ export { getCallGraphTool, createGetCallGraphTool } from "./get-call-graph.js";
 export { getDependencyGraphTool, createGetDependencyGraphTool, } from "./get-dependency-graph.js";
 export { getSignatureTool, createGetSignatureTool } from "./get-signature.js";
 export { getExportsTool, createGetExportsTool } from "./get-exports.js";
+export { readFunctionTool, createReadFunctionTool, readStructTool, createReadStructTool, readTypeTool, createReadTypeTool, } from "./read-symbol.js";
 // Type exports
 export * from "./types.js";
 /**
@@ -39,6 +40,7 @@ import { getCallGraphTool } from "./get-call-graph.js";
 import { getDependencyGraphTool } from "./get-dependency-graph.js";
 import { getSignatureTool } from "./get-signature.js";
 import { getExportsTool } from "./get-exports.js";
+import { readFunctionTool, readStructTool, readTypeTool, } from "./read-symbol.js";
 export const allGoTools = [
     getFileStructureTool,
     findSymbolTool,
@@ -55,6 +57,9 @@ export const allGoTools = [
     getDependencyGraphTool,
     getSignatureTool,
     getExportsTool,
+    readFunctionTool,
+    readStructTool,
+    readTypeTool,
 ];
 export const goToolsMap = {
     getFileStructure: getFileStructureTool,
@@ -72,4 +77,7 @@ export const goToolsMap = {
     getDependencyGraph: getDependencyGraphTool,
     getSignature: getSignatureTool,
     getExports: getExportsTool,
+    readFunction: readFunctionTool,
+    readStruct: readStructTool,
+    readType: readTypeTool,
 };

package/dist/tools/read-symbol.d.ts

@@ -0,0 +1,63 @@
+/**
+ * Smart File Reading Tools for Go
+ *
+ * AST-aware tools that extract specific code elements by name,
+ * returning exact source code without guessing line numbers.
+ *
+ * Tools:
+ * - read_function: Read a function/method by name
+ * - read_struct: Read a struct by name
+ * - read_type: Read a type definition by name
+ */
+import type { Tool } from "@compilr-dev/agents";
+export interface ReadFunctionInput {
+    /** Absolute path to the file */
+    path: string;
+    /** Function or method name to read */
+    name: string;
+    /** Receiver type if reading a method (e.g., "*Server" or "Handler") */
+    receiverType?: string;
+    /** Include doc comment (default: true) */
+    includeDoc?: boolean;
+}
+export interface ReadStructInput {
+    /** Absolute path to the file */
+    path: string;
+    /** Struct name to read */
+    name: string;
+    /** What to include: 'full' | 'signature' | 'fields-only' */
+    include?: "full" | "signature" | "fields-only";
+    /** Include doc comment (default: true) */
+    includeDoc?: boolean;
+}
+export interface ReadTypeInput {
+    /** Absolute path to the file */
+    path: string;
+    /** Type name to read (struct, interface, type alias) */
+    name: string;
+    /** Include doc comment (default: true) */
+    includeDoc?: boolean;
+}
+export interface ReadSymbolResult {
+    /** Symbol name */
+    name: string;
+    /** Symbol kind */
+    kind: "function" | "method" | "struct" | "interface" | "type";
+    /** Start line (1-based) */
+    startLine: number;
+    /** End line (1-based) */
+    endLine: number;
+    /** Source code content */
+    content: string;
+    /** Signature (for functions/methods/structs) */
+    signature?: string;
+    /** Receiver type (for methods) */
+    receiver?: string;
+}
+export declare const readFunctionTool: Tool<ReadFunctionInput>;
+export declare const readStructTool: Tool<ReadStructInput>;
+export declare const readTypeTool: Tool<ReadTypeInput>;
+export declare function createReadFunctionTool(): Tool<ReadFunctionInput>;
+export declare function createReadStructTool(): Tool<ReadStructInput>;
+export declare function createReadTypeTool(): Tool<ReadTypeInput>;
+//# sourceMappingURL=read-symbol.d.ts.map

package/dist/tools/read-symbol.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"read-symbol.d.ts","sourceRoot":"","sources":["../../src/tools/read-symbol.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AASH,OAAO,KAAK,EAAE,IAAI,EAAuB,MAAM,qBAAqB,CAAC;AAYrE,MAAM,WAAW,iBAAiB;IAChC,gCAAgC;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,sCAAsC;IACtC,IAAI,EAAE,MAAM,CAAC;IACb,uEAAuE;IACvE,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,0CAA0C;IAC1C,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED,MAAM,WAAW,eAAe;IAC9B,gCAAgC;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,0BAA0B;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,4DAA4D;IAC5D,OAAO,CAAC,EAAE,MAAM,GAAG,WAAW,GAAG,aAAa,CAAC;IAC/C,0CAA0C;IAC1C,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED,MAAM,WAAW,aAAa;IAC5B,gCAAgC;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,wDAAwD;IACxD,IAAI,EAAE,MAAM,CAAC;IACb,0CAA0C;IAC1C,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED,MAAM,WAAW,gBAAgB;IAC/B,kBAAkB;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,kBAAkB;IAClB,IAAI,EAAE,UAAU,GAAG,QAAQ,GAAG,QAAQ,GAAG,WAAW,GAAG,MAAM,CAAC;IAC9D,2BAA2B;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,yBAAyB;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,0BAA0B;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,gDAAgD;IAChD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,kCAAkC;IAClC,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AA+TD,eAAO,MAAM,gBAAgB,yBA8B3B,CAAC;AAiFH,eAAO,MAAM,cAAc,uBA6BzB,CAAC;AAwEH,eAAO,MAAM,YAAY,qBAwBvB,CAAC;AAMH,wBAAgB,sBAAsB,IAAI,IAAI,CAAC,iBAAiB,CAAC,CAEhE;AAED,wBAAgB,oBAAoB,IAAI,IAAI,CAAC,eAAe,CAAC,CAE5D;AAED,wBAAgB,kBAAkB,IAAI,IAAI,CAAC,aAAa,CAAC,CAExD"}

package/dist/tools/read-symbol.js

@@ -0,0 +1,476 @@
+/**
+ * Smart File Reading Tools for Go
+ *
+ * AST-aware tools that extract specific code elements by name,
+ * returning exact source code without guessing line numbers.
+ *
+ * Tools:
+ * - read_function: Read a function/method by name
+ * - read_struct: Read a struct by name
+ * - read_type: Read a type definition by name
+ */
+import * as fs from "node:fs/promises";
+import { defineTool, createSuccessResult, createErrorResult, } from "@compilr-dev/agents";
+import { parseFile, getNodeText, extractDocComment, walkTree, } from "../parser/go-parser.js";
+// =============================================================================
+// Helper Functions
+// =============================================================================
+/**
+ * Check if a file is a Go file
+ */
+function isGoFile(filePath) {
+    const ext = filePath.toLowerCase().split(".").pop();
+    return ext === "go";
+}
+/**
+ * Get doc comment source as lines
+ */
+function getDocCommentSource(node, source) {
+    // Look for comment nodes immediately before this node
+    const parent = node.parent;
+    if (!parent)
+        return undefined;
+    const nodeIndex = parent.children.indexOf(node);
+    if (nodeIndex <= 0)
+        return undefined;
+    // Check for consecutive comments before the node
+    const commentNodes = [];
+    for (let i = nodeIndex - 1; i >= 0; i--) {
+        const sibling = parent.children[i];
+        if (sibling.type === "comment") {
+            commentNodes.unshift(sibling);
+        }
+        else {
+            break;
+        }
+    }
+    if (commentNodes.length === 0)
+        return undefined;
+    // Get the full source from first comment to the node start
+    const startPos = commentNodes[0].startIndex;
+    const endPos = node.startIndex;
+    return source.slice(startPos, endPos);
+}
+/**
+ * Extract function signature (func line without body)
+ */
+function extractFunctionSignature(node, source) {
+    const text = getNodeText(node, source);
+    // Find the first { and take everything before it
+    const braceIndex = text.indexOf("{");
+    if (braceIndex !== -1) {
+        return text.slice(0, braceIndex).trim();
+    }
+    // Fallback to first line
+    const firstLine = text.split("\n")[0];
+    return firstLine?.trim() ?? "";
+}
+/**
+ * Extract struct/interface signature
+ */
+function extractTypeSignature(node, source, kind) {
+    const text = getNodeText(node, source);
+    // Find "type Name struct {" or "type Name interface {"
+    const match = text.match(new RegExp(`^type\\s+\\w+\\s+${kind}\\s*\\{`, "m"));
+    if (match) {
+        return match[0].replace("{", "{ ... }");
+    }
+    const firstLine = text.split("\n")[0];
+    return (firstLine?.trim() ?? "") + " { ... }";
+}
+/**
+ * Get receiver type from a method declaration
+ */
+function getReceiverType(node, source) {
+    const receiverNode = node.childForFieldName("receiver");
+    if (!receiverNode)
+        return undefined;
+    for (const child of receiverNode.children) {
+        if (child.type === "parameter_declaration") {
+            const typeNode = child.children.find((c) => c.type === "pointer_type" ||
+                c.type === "type_identifier" ||
+                c.type === "qualified_type");
+            if (typeNode) {
+                return getNodeText(typeNode, source);
+            }
+        }
+    }
+    return undefined;
+}
+/**
+ * Normalize receiver type for comparison
+ * Handles both "*Server" and "Server" matching
+ */
+function normalizeReceiverType(receiverType) {
+    return receiverType.replace(/^\*/, "");
+}
+/**
+ * Find a function or method declaration by name
+ */
+function findFunctionNode(rootNode, name, source, receiverType) {
+    // Look for function_declaration or method_declaration
+    for (const node of walkTree(rootNode, [
+        "function_declaration",
+        "method_declaration",
+    ])) {
+        const nameNode = node.childForFieldName("name");
+        if (!nameNode || getNodeText(nameNode, source) !== name) {
+            continue;
+        }
+        // Check if this is a method (has receiver)
+        const receiver = getReceiverType(node, source);
+        if (receiverType) {
+            // Looking for a specific method
+            if (receiver &&
+                normalizeReceiverType(receiver) === normalizeReceiverType(receiverType)) {
+                return { node, receiver };
+            }
+        }
+        else if (!receiver) {
+            // Looking for a function (no receiver)
+            return { node };
+        }
+    }
+    // If looking for a method, also try to find by just the base type
+    if (receiverType) {
+        const normalizedTarget = normalizeReceiverType(receiverType);
+        for (const node of walkTree(rootNode, ["method_declaration"])) {
+            const nameNode = node.childForFieldName("name");
+            if (!nameNode || getNodeText(nameNode, source) !== name) {
+                continue;
+            }
+            const receiver = getReceiverType(node, source);
+            if (receiver && normalizeReceiverType(receiver) === normalizedTarget) {
+                return { node, receiver };
+            }
+        }
+    }
+    return undefined;
+}
+/**
+ * Find a type declaration by name
+ */
+function findTypeNode(rootNode, name, source) {
+    for (const node of walkTree(rootNode, ["type_declaration"])) {
+        // Check for type_spec (regular type definition: type Name Type)
+        const typeSpec = node.children.find((c) => c.type === "type_spec");
+        if (typeSpec) {
+            const nameNode = typeSpec.childForFieldName("name");
+            if (nameNode && getNodeText(nameNode, source) === name) {
+                const typeNode = typeSpec.childForFieldName("type");
+                if (!typeNode) {
+                    return { node, kind: "type" };
+                }
+                if (typeNode.type === "struct_type") {
+                    return { node, kind: "struct" };
+                }
+                if (typeNode.type === "interface_type") {
+                    return { node, kind: "interface" };
+                }
+                // Type definition (e.g., type ID int)
+                return { node, kind: "type" };
+            }
+        }
+        // Check for type_alias (type alias: type Name = Type)
+        const typeAlias = node.children.find((c) => c.type === "type_alias");
+        if (typeAlias) {
+            // type_alias has structure: type_identifier, =, type_identifier
+            const nameNode = typeAlias.children.find((c) => c.type === "type_identifier");
+            if (nameNode && getNodeText(nameNode, source) === name) {
+                return { node, kind: "type" };
+            }
+        }
+    }
+    return undefined;
+}
+/**
+ * Extract only struct fields from a type declaration
+ */
+function extractStructFields(node, source) {
+    const typeSpec = node.children.find((c) => c.type === "type_spec");
+    if (!typeSpec)
+        return "";
+    const typeNode = typeSpec.childForFieldName("type");
+    if (!typeNode || typeNode.type !== "struct_type")
+        return "";
+    const fieldList = typeNode.children.find((c) => c.type === "field_declaration_list");
+    if (!fieldList)
+        return "";
+    const fields = [];
+    for (const field of fieldList.children) {
+        if (field.type === "field_declaration") {
+            fields.push(getNodeText(field, source));
+        }
+    }
+    return fields.join("\n");
+}
+// =============================================================================
+// read_function Tool
+// =============================================================================
+async function executeReadFunction(input) {
+    const { path: filePath, name, receiverType, includeDoc = true } = input;
+    if (!filePath || !name) {
+        return createErrorResult("Both path and name are required");
+    }
+    if (!isGoFile(filePath)) {
+        return createErrorResult(`Not a Go file: ${filePath}`);
+    }
+    try {
+        await fs.access(filePath);
+    }
+    catch {
+        return createErrorResult(`File not found: ${filePath}`);
+    }
+    try {
+        const parseResult = await parseFile(filePath);
+        const { tree, source } = parseResult;
+        const found = findFunctionNode(tree.rootNode, name, source, receiverType);
+        if (!found) {
+            const searchDesc = receiverType
+                ? `method ${name} with receiver ${receiverType}`
+                : `function ${name}`;
+            return createErrorResult(`Function not found: ${searchDesc}`);
+        }
+        const { node, receiver } = found;
+        // Get content with optional doc comment
+        let startIndex = node.startIndex;
+        if (includeDoc) {
+            const docSource = getDocCommentSource(node, source);
+            if (docSource) {
+                startIndex = node.startIndex - docSource.length;
+            }
+        }
+        const content = source.slice(startIndex, node.endIndex);
+        const startLine = node.startPosition.row +
+            1 -
+            (includeDoc
+                ? content.split("\n").length -
+                    getNodeText(node, source).split("\n").length
+                : 0);
+        const endLine = node.endPosition.row + 1;
+        const result = {
+            name,
+            kind: receiver ? "method" : "function",
+            startLine: includeDoc ? startLine : node.startPosition.row + 1,
+            endLine,
+            content,
+            signature: extractFunctionSignature(node, source),
+            receiver,
+        };
+        return createSuccessResult(result);
+    }
+    catch (error) {
+        return createErrorResult(`Failed to read function: ${error instanceof Error ? error.message : String(error)}`);
+    }
+}
+export const readFunctionTool = defineTool({
+    name: "read_function_go",
+    description: "Read a specific Go 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 receiverType parameter (e.g., "*Server" or "Handler").',
+    inputSchema: {
+        type: "object",
+        properties: {
+            path: {
+                type: "string",
+                description: "Absolute path to the Go file",
+            },
+            name: {
+                type: "string",
+                description: "Function or method name to read",
+            },
+            receiverType: {
+                type: "string",
+                description: 'Receiver type if reading a method (e.g., "*Server" or "Handler")',
+            },
+            includeDoc: {
+                type: "boolean",
+                description: "Include doc comment (default: true)",
+            },
+        },
+        required: ["path", "name"],
+    },
+    execute: executeReadFunction,
+});
+// =============================================================================
+// read_struct Tool
+// =============================================================================
+async function executeReadStruct(input) {
+    const { path: filePath, name, include = "full", includeDoc = true } = input;
+    if (!filePath || !name) {
+        return createErrorResult("Both path and name are required");
+    }
+    if (!isGoFile(filePath)) {
+        return createErrorResult(`Not a Go file: ${filePath}`);
+    }
+    try {
+        await fs.access(filePath);
+    }
+    catch {
+        return createErrorResult(`File not found: ${filePath}`);
+    }
+    try {
+        const parseResult = await parseFile(filePath);
+        const { tree, source } = parseResult;
+        const found = findTypeNode(tree.rootNode, name, source);
+        if (!found || found.kind !== "struct") {
+            return createErrorResult(`Struct not found: ${name}`);
+        }
+        const { node } = found;
+        let content;
+        if (include === "full") {
+            let startIndex = node.startIndex;
+            if (includeDoc) {
+                const docSource = getDocCommentSource(node, source);
+                if (docSource) {
+                    startIndex = node.startIndex - docSource.length;
+                }
+            }
+            content = source.slice(startIndex, node.endIndex);
+        }
+        else if (include === "signature") {
+            content = extractTypeSignature(node, source, "struct");
+            if (includeDoc) {
+                const doc = extractDocComment(node, source);
+                if (doc) {
+                    content = `// ${doc.split("\n").join("\n// ")}\n${content}`;
+                }
+            }
+        }
+        else {
+            // include === 'fields-only'
+            content = extractStructFields(node, source);
+        }
+        const startLine = node.startPosition.row + 1;
+        const endLine = node.endPosition.row + 1;
+        const result = {
+            name,
+            kind: "struct",
+            startLine,
+            endLine,
+            content,
+            signature: extractTypeSignature(node, source, "struct"),
+        };
+        return createSuccessResult(result);
+    }
+    catch (error) {
+        return createErrorResult(`Failed to read struct: ${error instanceof Error ? error.message : String(error)}`);
+    }
+}
+export const readStructTool = defineTool({
+    name: "read_struct_go",
+    description: "Read a specific Go struct by name. Returns the exact source code without guessing line numbers. " +
+        "Use the include parameter to get: full struct, signature only, or fields only.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            path: {
+                type: "string",
+                description: "Absolute path to the Go file",
+            },
+            name: {
+                type: "string",
+                description: "Struct name to read",
+            },
+            include: {
+                type: "string",
+                enum: ["full", "signature", "fields-only"],
+                description: "What to include (default: full)",
+            },
+            includeDoc: {
+                type: "boolean",
+                description: "Include doc comment (default: true)",
+            },
+        },
+        required: ["path", "name"],
+    },
+    execute: executeReadStruct,
+});
+// =============================================================================
+// read_type Tool
+// =============================================================================
+async function executeReadType(input) {
+    const { path: filePath, name, includeDoc = true } = input;
+    if (!filePath || !name) {
+        return createErrorResult("Both path and name are required");
+    }
+    if (!isGoFile(filePath)) {
+        return createErrorResult(`Not a Go file: ${filePath}`);
+    }
+    try {
+        await fs.access(filePath);
+    }
+    catch {
+        return createErrorResult(`File not found: ${filePath}`);
+    }
+    try {
+        const parseResult = await parseFile(filePath);
+        const { tree, source } = parseResult;
+        const found = findTypeNode(tree.rootNode, name, source);
+        if (!found) {
+            return createErrorResult(`Type not found: ${name}. Supported types: struct, interface, type alias`);
+        }
+        const { node, kind } = found;
+        // Get content with optional doc comment
+        let startIndex = node.startIndex;
+        if (includeDoc) {
+            const docSource = getDocCommentSource(node, source);
+            if (docSource) {
+                startIndex = node.startIndex - docSource.length;
+            }
+        }
+        const content = source.slice(startIndex, node.endIndex);
+        const startLine = node.startPosition.row + 1;
+        const endLine = node.endPosition.row + 1;
+        const result = {
+            name,
+            kind,
+            startLine,
+            endLine,
+            content,
+            signature: kind === "struct" || kind === "interface"
+                ? extractTypeSignature(node, source, kind)
+                : undefined,
+        };
+        return createSuccessResult(result);
+    }
+    catch (error) {
+        return createErrorResult(`Failed to read type: ${error instanceof Error ? error.message : String(error)}`);
+    }
+}
+export const readTypeTool = defineTool({
+    name: "read_type_go",
+    description: "Read a specific Go type definition by name. Returns the exact source code without guessing line numbers. " +
+        "Works for: struct, interface, and type aliases.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            path: {
+                type: "string",
+                description: "Absolute path to the Go file",
+            },
+            name: {
+                type: "string",
+                description: "Type name to read (struct, interface, or type alias)",
+            },
+            includeDoc: {
+                type: "boolean",
+                description: "Include doc comment (default: true)",
+            },
+        },
+        required: ["path", "name"],
+    },
+    execute: executeReadType,
+});
+// =============================================================================
+// Factory Functions
+// =============================================================================
+export function createReadFunctionTool() {
+    return readFunctionTool;
+}
+export function createReadStructTool() {
+    return readStructTool;
+}
+export function createReadTypeTool() {
+    return readTypeTool;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@compilr-dev/agents-coding-go",
-  "version": "0.1.3",
+  "version": "0.1.4",
   "description": "Go analysis tools for AI agents - AST-based code analysis using Tree-sitter",
   "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"
@@ -72,15 +72,15 @@
     "tree-sitter-go": "^0.25.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",
     "typescript": "^5.8.3",
-    "vitest": "^3.2.4"
+    "typescript-eslint": "^8.48.0",
+    "vitest": "^4.0.18"
   }
 }