@compilr-dev/agents-coding-python 0.1.0

package/dist/tools/index.d.ts

@@ -0,0 +1,55 @@
+/**
+ * Python Analysis Tools
+ *
+ * Tools for analyzing Python source code using Tree-sitter.
+ */
+export { getFileStructureTool, createGetFileStructureTool, } from "./get-file-structure.js";
+export { findSymbolTool, createFindSymbolTool } from "./find-symbol.js";
+export { findReferencesTool, createFindReferencesTool, } from "./find-references.js";
+export { getImportsTool, createGetImportsTool } from "./get-imports.js";
+export { getClassHierarchyTool, createGetClassHierarchyTool, } from "./get-class-hierarchy.js";
+export { getComplexityTool, createGetComplexityTool, } from "./get-complexity.js";
+export { extractDocstringsTool, createExtractDocstringsTool, } from "./extract-docstrings.js";
+export { findDeadCodeTool, createFindDeadCodeTool } from "./find-dead-code.js";
+export { findDuplicatesTool, createFindDuplicatesTool, } from "./find-duplicates.js";
+export { findImplementationsTool, createFindImplementationsTool, } from "./find-implementations.js";
+export { findPatternsTool, createFindPatternsTool } from "./find-patterns.js";
+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 * from "./types.js";
+export type { GetFileStructureInput } from "./get-file-structure.js";
+export type { FindSymbolInput, FindSymbolResult, PythonSymbolDefinition, PythonSymbolKind, PythonSymbolKindFilter, } from "./find-symbol.js";
+export type { FindReferencesInput, FindReferencesResult, FileReferences, ReferenceType, } from "./find-references.js";
+export type { GetImportsInput } from "./get-imports.js";
+export type { GetClassHierarchyInput, HierarchyDirection, } from "./get-class-hierarchy.js";
+export type { GetComplexityInput, GetComplexityResult, } from "./get-complexity.js";
+export type { ExtractDocstringsInput, ExtractDocstringsResult, FileDocumentation, } from "./extract-docstrings.js";
+export type { FindDeadCodeInput, FindDeadCodeResult, DeadCodeItem, } from "./find-dead-code.js";
+export type { FindDuplicatesInput, FindDuplicatesResult, DuplicateGroup, CodeLocation, } from "./find-duplicates.js";
+export type { FindImplementationsInput, FindImplementationsResult, ImplementationInfo, } from "./find-implementations.js";
+export type { FindPatternsInput, FindPatternsResult, CodePattern, PatternMatch, } from "./find-patterns.js";
+export type { GetCallGraphInput, GetCallGraphResult, CallGraphDirection, CallType, FunctionNode, CallInfo, CallGraphNode, CallGraphStats, } from "./get-call-graph.js";
+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 allPythonTools: 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 declare const pythonToolsMap: {
+    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>;
+    readonly findReferences: import("@compilr-dev/agents").Tool<import("./find-references.js").FindReferencesInput>;
+    readonly getImports: import("@compilr-dev/agents").Tool<import("./get-imports.js").GetImportsInput>;
+    readonly getClassHierarchy: import("@compilr-dev/agents").Tool<import("./get-class-hierarchy.js").GetClassHierarchyInput>;
+    readonly getComplexity: import("@compilr-dev/agents").Tool<import("./get-complexity.js").GetComplexityInput>;
+    readonly extractDocstrings: import("@compilr-dev/agents").Tool<import("./extract-docstrings.js").ExtractDocstringsInput>;
+    readonly findDeadCode: import("@compilr-dev/agents").Tool<import("./find-dead-code.js").FindDeadCodeInput>;
+    readonly findDuplicates: import("@compilr-dev/agents").Tool<import("./find-duplicates.js").FindDuplicatesInput>;
+    readonly findImplementations: import("@compilr-dev/agents").Tool<import("./find-implementations.js").FindImplementationsInput>;
+    readonly findPatterns: import("@compilr-dev/agents").Tool<import("./find-patterns.js").FindPatternsInput>;
+    readonly getCallGraph: import("@compilr-dev/agents").Tool<import("./get-call-graph.js").GetCallGraphInput>;
+    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>;
+};
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EACL,oBAAoB,EACpB,0BAA0B,GAC3B,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,cAAc,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AACxE,OAAO,EACL,kBAAkB,EAClB,wBAAwB,GACzB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,cAAc,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AACxE,OAAO,EACL,qBAAqB,EACrB,2BAA2B,GAC5B,MAAM,0BAA0B,CAAC;AAClC,OAAO,EACL,iBAAiB,EACjB,uBAAuB,GACxB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,qBAAqB,EACrB,2BAA2B,GAC5B,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,gBAAgB,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAC/E,OAAO,EACL,kBAAkB,EAClB,wBAAwB,GACzB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACL,uBAAuB,EACvB,6BAA6B,GAC9B,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAAE,gBAAgB,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AAC9E,OAAO,EAAE,gBAAgB,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAC/E,OAAO,EACL,sBAAsB,EACtB,4BAA4B,GAC7B,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAAE,gBAAgB,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AAC9E,OAAO,EAAE,cAAc,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAGxE,cAAc,YAAY,CAAC;AAG3B,YAAY,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AACrE,YAAY,EACV,eAAe,EACf,gBAAgB,EAChB,sBAAsB,EACtB,gBAAgB,EAChB,sBAAsB,GACvB,MAAM,kBAAkB,CAAC;AAC1B,YAAY,EACV,mBAAmB,EACnB,oBAAoB,EACpB,cAAc,EACd,aAAa,GACd,MAAM,sBAAsB,CAAC;AAC9B,YAAY,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACxD,YAAY,EACV,sBAAsB,EACtB,kBAAkB,GACnB,MAAM,0BAA0B,CAAC;AAClC,YAAY,EACV,kBAAkB,EAClB,mBAAmB,GACpB,MAAM,qBAAqB,CAAC;AAC7B,YAAY,EACV,sBAAsB,EACtB,uBAAuB,EACvB,iBAAiB,GAClB,MAAM,yBAAyB,CAAC;AACjC,YAAY,EACV,iBAAiB,EACjB,kBAAkB,EAClB,YAAY,GACb,MAAM,qBAAqB,CAAC;AAC7B,YAAY,EACV,mBAAmB,EACnB,oBAAoB,EACpB,cAAc,EACd,YAAY,GACb,MAAM,sBAAsB,CAAC;AAC9B,YAAY,EACV,wBAAwB,EACxB,yBAAyB,EACzB,kBAAkB,GACnB,MAAM,2BAA2B,CAAC;AACnC,YAAY,EACV,iBAAiB,EACjB,kBAAkB,EAClB,WAAW,EACX,YAAY,GACb,MAAM,oBAAoB,CAAC;AAC5B,YAAY,EACV,iBAAiB,EACjB,kBAAkB,EAClB,kBAAkB,EAClB,QAAQ,EACR,YAAY,EACZ,QAAQ,EACR,aAAa,EACb,cAAc,GACf,MAAM,qBAAqB,CAAC;AAC7B,YAAY,EACV,uBAAuB,EACvB,wBAAwB,EACxB,UAAU,EACV,cAAc,EACd,kBAAkB,EAClB,oBAAoB,GACrB,MAAM,2BAA2B,CAAC;AACnC,YAAY,EACV,iBAAiB,EACjB,kBAAkB,EAClB,eAAe,EACf,gBAAgB,EAChB,eAAe,EACf,aAAa,GACd,MAAM,oBAAoB,CAAC;AAC5B,YAAY,EACV,eAAe,EACf,gBAAgB,EAChB,cAAc,EACd,UAAU,EACV,QAAQ,EACR,WAAW,GACZ,MAAM,kBAAkB,CAAC;AAqB1B,eAAO,MAAM,cAAc,gzCAgBjB,CAAC;AAEX,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;CAgBjB,CAAC"}

package/dist/tools/index.js

@@ -0,0 +1,75 @@
+/**
+ * Python Analysis Tools
+ *
+ * Tools for analyzing Python source code using Tree-sitter.
+ */
+// Tool exports
+export { getFileStructureTool, createGetFileStructureTool, } from "./get-file-structure.js";
+export { findSymbolTool, createFindSymbolTool } from "./find-symbol.js";
+export { findReferencesTool, createFindReferencesTool, } from "./find-references.js";
+export { getImportsTool, createGetImportsTool } from "./get-imports.js";
+export { getClassHierarchyTool, createGetClassHierarchyTool, } from "./get-class-hierarchy.js";
+export { getComplexityTool, createGetComplexityTool, } from "./get-complexity.js";
+export { extractDocstringsTool, createExtractDocstringsTool, } from "./extract-docstrings.js";
+export { findDeadCodeTool, createFindDeadCodeTool } from "./find-dead-code.js";
+export { findDuplicatesTool, createFindDuplicatesTool, } from "./find-duplicates.js";
+export { findImplementationsTool, createFindImplementationsTool, } from "./find-implementations.js";
+export { findPatternsTool, createFindPatternsTool } from "./find-patterns.js";
+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";
+// Type exports
+export * from "./types.js";
+/**
+ * All Python analysis tools
+ */
+import { getFileStructureTool } from "./get-file-structure.js";
+import { findSymbolTool } from "./find-symbol.js";
+import { findReferencesTool } from "./find-references.js";
+import { getImportsTool } from "./get-imports.js";
+import { getClassHierarchyTool } from "./get-class-hierarchy.js";
+import { getComplexityTool } from "./get-complexity.js";
+import { extractDocstringsTool } from "./extract-docstrings.js";
+import { findDeadCodeTool } from "./find-dead-code.js";
+import { findDuplicatesTool } from "./find-duplicates.js";
+import { findImplementationsTool } from "./find-implementations.js";
+import { findPatternsTool } from "./find-patterns.js";
+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";
+export const allPythonTools = [
+    getFileStructureTool,
+    findSymbolTool,
+    findReferencesTool,
+    getImportsTool,
+    getClassHierarchyTool,
+    getComplexityTool,
+    extractDocstringsTool,
+    findDeadCodeTool,
+    findDuplicatesTool,
+    findImplementationsTool,
+    findPatternsTool,
+    getCallGraphTool,
+    getDependencyGraphTool,
+    getSignatureTool,
+    getExportsTool,
+];
+export const pythonToolsMap = {
+    getFileStructure: getFileStructureTool,
+    findSymbol: findSymbolTool,
+    findReferences: findReferencesTool,
+    getImports: getImportsTool,
+    getClassHierarchy: getClassHierarchyTool,
+    getComplexity: getComplexityTool,
+    extractDocstrings: extractDocstringsTool,
+    findDeadCode: findDeadCodeTool,
+    findDuplicates: findDuplicatesTool,
+    findImplementations: findImplementationsTool,
+    findPatterns: findPatternsTool,
+    getCallGraph: getCallGraphTool,
+    getDependencyGraph: getDependencyGraphTool,
+    getSignature: getSignatureTool,
+    getExports: getExportsTool,
+};

package/dist/tools/types.d.ts

@@ -0,0 +1,378 @@
+/**
+ * Shared types for Python analysis tools
+ */
+import type { ClassInfo, FunctionInfo, VariableInfo, ImportInfo, ParameterInfo, DecoratorInfo } from "../parser/node-types.js";
+export type { ClassInfo, FunctionInfo, VariableInfo, ImportInfo, ParameterInfo, DecoratorInfo, };
+/**
+ * Common tool input with path
+ */
+export interface BaseInput {
+    path: string;
+}
+/**
+ * File structure result
+ */
+export interface FileStructureResult {
+    path: string;
+    classes: ClassInfo[];
+    functions: FunctionInfo[];
+    variables: VariableInfo[];
+    imports: ImportInfo[];
+    docstring?: string;
+    stats: {
+        totalClasses: number;
+        totalFunctions: number;
+        totalVariables: number;
+        totalImports: number;
+        totalLines: number;
+    };
+}
+/**
+ * Symbol location
+ */
+export interface SymbolLocation {
+    path: string;
+    line: number;
+    column: number;
+    endLine: number;
+    type: "class" | "function" | "method" | "variable" | "parameter" | "import";
+    name: string;
+    parent?: string;
+    signature?: string;
+}
+/**
+ * Symbol reference
+ */
+export interface SymbolReference {
+    path: string;
+    line: number;
+    column: number;
+    context: string;
+    type: "read" | "write" | "call" | "import" | "definition" | "attribute";
+}
+/**
+ * Complexity metrics
+ */
+export interface ComplexityMetrics {
+    cyclomatic: number;
+    cognitive: number;
+    linesOfCode: number;
+    parameters: number;
+    nestingDepth: number;
+}
+/**
+ * Function complexity result
+ */
+export interface FunctionComplexity {
+    name: string;
+    path: string;
+    line: number;
+    metrics: ComplexityMetrics;
+    isComplex: boolean;
+}
+/**
+ * File complexity result
+ */
+export interface FileComplexityResult {
+    path: string;
+    functions: FunctionComplexity[];
+    averageComplexity: number;
+    maxComplexity: number;
+    stats: {
+        totalFunctions: number;
+        complexFunctions: number;
+        simpleAverage: number;
+    };
+}
+/**
+ * Import category
+ */
+export type ImportCategory = "stdlib" | "third_party" | "local";
+/**
+ * Extended import info with category
+ */
+export interface CategorizedImport extends ImportInfo {
+    category: ImportCategory;
+}
+/**
+ * Imports result
+ */
+export interface ImportsResult {
+    path: string;
+    imports: CategorizedImport[];
+    stats: {
+        total: number;
+        stdlib: number;
+        thirdParty: number;
+        local: number;
+    };
+}
+/**
+ * Export info
+ */
+export interface ExportInfo {
+    name: string;
+    type: "class" | "function" | "variable" | "constant";
+    line: number;
+    isPublic: boolean;
+    inAll: boolean;
+}
+/**
+ * Exports result
+ */
+export interface ExportsResult {
+    path: string;
+    exports: ExportInfo[];
+    hasAll: boolean;
+    allList: string[];
+}
+/**
+ * Call graph node
+ */
+export interface CallNode {
+    id: string;
+    name: string;
+    path: string;
+    line: number;
+    type: "function" | "method" | "builtin" | "external";
+}
+/**
+ * Call graph edge
+ */
+export interface CallEdge {
+    caller: string;
+    callee: string;
+    line: number;
+    isConditional: boolean;
+    inLoop: boolean;
+}
+/**
+ * Call graph result
+ */
+export interface CallGraphResult {
+    path: string;
+    nodes: CallNode[];
+    edges: CallEdge[];
+    stats: {
+        totalNodes: number;
+        totalEdges: number;
+        maxDepth: number;
+    };
+}
+/**
+ * Dependency graph node
+ */
+export interface ModuleNode {
+    id: string;
+    path: string;
+    name: string;
+    isExternal: boolean;
+    package?: string;
+}
+/**
+ * Dependency graph edge
+ */
+export interface DependencyEdge {
+    from: string;
+    to: string;
+    imports: string[];
+}
+/**
+ * Dependency graph result
+ */
+export interface DependencyGraphResult {
+    path: string;
+    nodes: ModuleNode[];
+    edges: DependencyEdge[];
+    cycles: string[][];
+}
+/**
+ * Type hierarchy parent
+ */
+export interface ParentClass {
+    name: string;
+    path?: string;
+    isExternal: boolean;
+}
+/**
+ * Type hierarchy result
+ */
+export interface TypeHierarchyResult {
+    className: string;
+    path: string;
+    line: number;
+    parents: ParentClass[];
+    children: Array<{
+        name: string;
+        path: string;
+        line: number;
+    }>;
+    mro: string[];
+}
+/**
+ * Implementation info
+ */
+export interface ImplementationInfo {
+    className: string;
+    path: string;
+    line: number;
+    baseClass: string;
+    implementedMethods: string[];
+    missingMethods: string[];
+    isComplete: boolean;
+}
+/**
+ * Dead code info
+ */
+export interface DeadCodeInfo {
+    name: string;
+    type: "function" | "class" | "variable" | "import";
+    path: string;
+    line: number;
+    reason: string;
+}
+/**
+ * Dead code result
+ */
+export interface DeadCodeResult {
+    path: string;
+    unused: DeadCodeInfo[];
+    stats: {
+        total: number;
+        functions: number;
+        classes: number;
+        variables: number;
+        imports: number;
+    };
+}
+/**
+ * Code clone instance
+ */
+export interface CloneInstance {
+    path: string;
+    startLine: number;
+    endLine: number;
+    content: string;
+}
+/**
+ * Code clone
+ */
+export interface CodeClone {
+    id: string;
+    instances: CloneInstance[];
+    lines: number;
+    similarity: number;
+}
+/**
+ * Duplicates result
+ */
+export interface DuplicatesResult {
+    path: string;
+    clones: CodeClone[];
+    stats: {
+        totalClones: number;
+        duplicatedLines: number;
+        percentDuplicated: number;
+    };
+}
+/**
+ * Pattern type
+ */
+export type PatternType = "bare_except" | "mutable_default" | "global_usage" | "star_import" | "nested_function" | "long_function" | "god_class" | "unused_variable" | "shadowing" | "magic_number";
+/**
+ * Pattern match
+ */
+export interface PatternMatch {
+    type: PatternType;
+    path: string;
+    line: number;
+    column: number;
+    message: string;
+    severity: "info" | "warning" | "error";
+    suggestion?: string;
+}
+/**
+ * Patterns result
+ */
+export interface PatternsResult {
+    path: string;
+    patterns: PatternMatch[];
+    stats: {
+        total: number;
+        byType: Partial<Record<PatternType, number>>;
+        bySeverity: {
+            info: number;
+            warning: number;
+            error: number;
+        };
+    };
+}
+/**
+ * Parsed docstring parameter
+ */
+export interface DocParam {
+    name: string;
+    type?: string;
+    description: string;
+    optional: boolean;
+    default?: string;
+}
+/**
+ * Parsed docstring return
+ */
+export interface DocReturn {
+    type?: string;
+    description: string;
+}
+/**
+ * Parsed docstring exception
+ */
+export interface DocRaise {
+    type: string;
+    description: string;
+}
+/**
+ * Docstring format
+ */
+export type DocstringFormat = "google" | "numpy" | "sphinx" | "epytext" | "unknown";
+/**
+ * Parsed docstring
+ */
+export interface ParsedDocstring {
+    summary: string;
+    description?: string;
+    parameters: DocParam[];
+    returns?: DocReturn;
+    raises: DocRaise[];
+    examples: string[];
+    notes?: string;
+    format: DocstringFormat;
+}
+/**
+ * Documentation result
+ */
+export interface DocumentationResult {
+    name: string;
+    path: string;
+    line: number;
+    docstring?: string;
+    parsed?: ParsedDocstring;
+}
+/**
+ * Signature result
+ */
+export interface SignatureResult {
+    name: string;
+    path: string;
+    line: number;
+    signature: string;
+    parameters: ParameterInfo[];
+    returnType?: string;
+    decorators: DecoratorInfo[];
+    isAsync: boolean;
+    isGenerator: boolean;
+    isClassMethod: boolean;
+    isStaticMethod: boolean;
+    isProperty: boolean;
+}
+//# sourceMappingURL=types.d.ts.map

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

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

package/dist/tools/types.js

@@ -0,0 +1,4 @@
+/**
+ * Shared types for Python analysis tools
+ */
+export {};

package/package.json

@@ -0,0 +1,85 @@
+{
+  "name": "@compilr-dev/agents-coding-python",
+  "version": "0.1.0",
+  "description": "Python analysis tools for AI agents - AST-based code analysis using Tree-sitter",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./parser": {
+      "types": "./dist/parser/index.d.ts",
+      "import": "./dist/parser/index.js"
+    },
+    "./tools": {
+      "types": "./dist/tools/index.d.ts",
+      "import": "./dist/tools/index.js"
+    },
+    "./skills": {
+      "types": "./dist/skills/index.d.ts",
+      "import": "./dist/skills/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "clean": "rm -rf dist",
+    "lint": "eslint src/",
+    "lint:fix": "eslint src/ --fix",
+    "format": "prettier --write \"src/**/*.ts\"",
+    "format:check": "prettier --check \"src/**/*.ts\"",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage",
+    "prepublishOnly": "npm run clean && npm run lint && npm run test && npm run build",
+    "typecheck": "tsc --noEmit"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/compilr-dev/agents-python.git"
+  },
+  "keywords": [
+    "ai",
+    "agents",
+    "llm",
+    "coding",
+    "python",
+    "ast",
+    "analysis",
+    "tree-sitter",
+    "tools"
+  ],
+  "author": "Carmelo Scozzola",
+  "license": "MIT",
+  "bugs": {
+    "url": "https://github.com/compilr-dev/agents-python/issues"
+  },
+  "homepage": "https://github.com/compilr-dev/agents-python#readme",
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "peerDependencies": {
+    "@compilr-dev/agents": "^0.3.0"
+  },
+  "dependencies": {
+    "tree-sitter": "^0.22.4",
+    "tree-sitter-python": "^0.23.6"
+  },
+  "devDependencies": {
+    "@anthropic-ai/sdk": "^0.30.1",
+    "@compilr-dev/agents": "^0.3.0",
+    "@eslint/js": "^9.39.1",
+    "@types/node": "^24.10.1",
+    "@vitest/coverage-v8": "^3.2.4",
+    "eslint": "^9.39.1",
+    "prettier": "^3.7.1",
+    "typescript-eslint": "^8.48.0",
+    "typescript": "^5.8.3",
+    "vitest": "^3.2.4"
+  }
+}