@easynet/agent-tool-buildin 0.0.13 → 0.0.16

package/dist/core-tools-manifest.json

@@ -1,9 +1,467 @@
 {
   "kind": "core",
   "tools": [
+    {
+      "name": "analyzeLog",
+      "description": "Analyze log text via OpenAI-compatible LLM, identifying errors, root causes, and suggestions.",
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "logText": {
+            "type": "string"
+          },
+          "log": {
+            "type": "string"
+          },
+          "text": {
+            "type": "string"
+          },
+          "chunkSize": {
+            "type": "number"
+          },
+          "chunkOverlap": {
+            "type": "number"
+          },
+          "model": {
+            "type": "string"
+          },
+          "timeoutMs": {
+            "type": "number"
+          }
+        },
+        "required": [
+          "logText"
+        ]
+      },
+      "outputSchema": {
+        "type": "object",
+        "properties": {
+          "result": {
+            "type": "object",
+            "properties": {
+              "analysis": {
+                "type": "string"
+              },
+              "chunksProcessed": {
+                "type": "number"
+              }
+            },
+            "required": [
+              "analysis",
+              "chunksProcessed"
+            ]
+          },
+          "evidence": {
+            "type": "array",
+            "items": {
+              "type": "object",
+              "properties": {
+                "type": {
+                  "type": "string"
+                },
+                "summary": {
+                  "type": "string"
+                },
+                "createdAt": {
+                  "type": "string"
+                }
+              },
+              "required": [
+                "type",
+                "summary",
+                "createdAt"
+              ]
+            }
+          }
+        },
+        "required": [
+          "result",
+          "evidence"
+        ]
+      },
+      "sourcePath": "src/analyze/analyzeLog",
+      "exportName": "analyzeLog",
+      "sideEffect": "none"
+    },
+    {
+      "name": "analyzeProjectRepo",
+      "description": "Build an index for a source-code repository and generate a whole-project understanding summary.",
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "path": {
+            "type": "string"
+          },
+          "repoPath": {
+            "type": "string"
+          },
+          "projectPath": {
+            "type": "string"
+          },
+          "outputIndexPath": {
+            "type": "string"
+          },
+          "includeHidden": {
+            "type": "object",
+            "properties": {}
+          },
+          "maxFiles": {
+            "type": "number"
+          },
+          "maxFileBytes": {
+            "type": "number"
+          },
+          "includeExtensions": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            }
+          },
+          "excludeDirs": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            }
+          },
+          "model": {
+            "type": "string"
+          },
+          "timeoutMs": {
+            "type": "number"
+          }
+        },
+        "required": [
+          "path"
+        ]
+      },
+      "outputSchema": {
+        "type": "object",
+        "properties": {
+          "result": {
+            "type": "object",
+            "properties": {
+              "repoRoot": {
+                "type": "string"
+              },
+              "indexPath": {
+                "type": "string"
+              },
+              "totalIndexedFiles": {
+                "type": "number"
+              },
+              "truncated": {
+                "type": "boolean"
+              },
+              "skippedBinary": {
+                "type": "number"
+              },
+              "indexSplit": {
+                "type": "boolean"
+              },
+              "indexPartPaths": {
+                "type": "array",
+                "items": {
+                  "type": "string"
+                }
+              },
+              "llmUsed": {
+                "type": "boolean"
+              },
+              "partialCount": {
+                "type": "number"
+              },
+              "model": {
+                "type": "string"
+              },
+              "understanding": {
+                "type": "string"
+              }
+            },
+            "required": [
+              "repoRoot",
+              "indexPath",
+              "totalIndexedFiles",
+              "truncated",
+              "skippedBinary",
+              "indexSplit",
+              "indexPartPaths",
+              "llmUsed",
+              "partialCount",
+              "model",
+              "understanding"
+            ]
+          },
+          "evidence": {
+            "type": "array",
+            "items": {
+              "type": "object",
+              "properties": {
+                "type": {
+                  "type": "string"
+                },
+                "summary": {
+                  "type": "string"
+                },
+                "createdAt": {
+                  "type": "string"
+                }
+              },
+              "required": [
+                "type",
+                "summary",
+                "createdAt"
+              ]
+            }
+          }
+        },
+        "required": [
+          "result",
+          "evidence"
+        ]
+      },
+      "sourcePath": "src/analyze/analyzeProjectRepo",
+      "exportName": "analyzeProjectRepo",
+      "sideEffect": "local_write"
+    },
+    {
+      "name": "askProjectRepo",
+      "description": "Ask a concrete question about a repository based on .project-index.json (or split parts).",
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "path": {
+            "type": "string"
+          },
+          "repoPath": {
+            "type": "string"
+          },
+          "projectPath": {
+            "type": "string"
+          },
+          "question": {
+            "type": "string"
+          },
+          "query": {
+            "type": "string"
+          },
+          "q": {
+            "type": "string"
+          },
+          "indexPath": {
+            "type": "string"
+          },
+          "topK": {
+            "type": "number"
+          },
+          "maxSnippetChars": {
+            "type": "number"
+          },
+          "model": {
+            "type": "string"
+          },
+          "timeoutMs": {
+            "type": "number"
+          }
+        },
+        "required": [
+          "path",
+          "question"
+        ]
+      },
+      "outputSchema": {
+        "type": "object",
+        "properties": {
+          "result": {
+            "type": "object",
+            "properties": {
+              "repoRoot": {
+                "type": "string"
+              },
+              "indexPath": {
+                "type": "string"
+              },
+              "question": {
+                "type": "string"
+              },
+              "model": {
+                "type": "string"
+              },
+              "answer": {
+                "type": "string"
+              },
+              "matchedFiles": {
+                "type": "array",
+                "items": {
+                  "type": "object",
+                  "properties": {
+                    "path": {
+                      "type": "string"
+                    },
+                    "score": {
+                      "type": "number"
+                    },
+                    "source": {
+                      "type": "string",
+                      "enum": [
+                        "index",
+                        "live_scan"
+                      ]
+                    }
+                  },
+                  "required": [
+                    "path",
+                    "score",
+                    "source"
+                  ]
+                }
+              },
+              "retrievalMode": {
+                "type": "string"
+              },
+              "deepReadUsed": {
+                "type": "boolean"
+              },
+              "deepReadPaths": {
+                "type": "array",
+                "items": {
+                  "type": "string"
+                }
+              }
+            },
+            "required": [
+              "repoRoot",
+              "indexPath",
+              "question",
+              "model",
+              "answer",
+              "matchedFiles",
+              "retrievalMode",
+              "deepReadUsed",
+              "deepReadPaths"
+            ]
+          },
+          "evidence": {
+            "type": "array",
+            "items": {
+              "type": "object",
+              "properties": {
+                "type": {
+                  "type": "string"
+                },
+                "summary": {
+                  "type": "string"
+                },
+                "createdAt": {
+                  "type": "string"
+                }
+              },
+              "required": [
+                "type",
+                "summary",
+                "createdAt"
+              ]
+            }
+          }
+        },
+        "required": [
+          "result",
+          "evidence"
+        ]
+      },
+      "sourcePath": "src/analyze/askProjectRepo",
+      "exportName": "askProjectRepo",
+      "sideEffect": "none"
+    },
+    {
+      "name": "embedText",
+      "description": "Convert text into embedding vectors via OpenAI-compatible API.",
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "text": {
+            "type": "string"
+          },
+          "texts": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            }
+          },
+          "model": {
+            "type": "string"
+          },
+          "timeoutMs": {
+            "type": "number"
+          }
+        }
+      },
+      "outputSchema": {
+        "type": "object",
+        "properties": {
+          "result": {
+            "type": "object",
+            "properties": {
+              "embeddings": {
+                "type": "array",
+                "items": {
+                  "type": "array",
+                  "items": {
+                    "type": "number"
+                  }
+                }
+              },
+              "model": {
+                "type": "string"
+              },
+              "dimensions": {
+                "type": "number"
+              },
+              "count": {
+                "type": "number"
+              }
+            },
+            "required": [
+              "embeddings",
+              "model",
+              "dimensions",
+              "count"
+            ]
+          },
+          "evidence": {
+            "type": "array",
+            "items": {
+              "type": "object",
+              "properties": {
+                "type": {
+                  "type": "string"
+                },
+                "summary": {
+                  "type": "string"
+                },
+                "createdAt": {
+                  "type": "string"
+                }
+              },
+              "required": [
+                "type",
+                "summary",
+                "createdAt"
+              ]
+            }
+          }
+        },
+        "required": [
+          "result",
+          "evidence"
+        ]
+      },
+      "sourcePath": "src/analyze/embedText",
+      "exportName": "embedText",
+      "sideEffect": "none"
+    },
     {
       "name": "runCommand",
-      "description": "Run a Linux command in the sandbox with an allowlist and timeout.",
+      "description": "Run an allowlisted command in the sandbox via spawn (no shell), with timeout and output limits.",
       "inputSchema": {
         "type": "object",
         "properties": {
@@ -56,16 +514,13 @@
     },
     {
       "name": "deletePath",
-      "description": "Delete a file or directory in the sandbox (dangerous, requires explicit confirmation).",
+      "description": "Delete a file or directory in the sandbox. Requires confirm=true to proceed.",
       "inputSchema": {
         "type": "object",
         "properties": {
           "path": {
             "type": "string"
           },
-          "filePath": {
-            "type": "string"
-          },
           "recursive": {
             "type": "object",
             "properties": {}
@@ -139,22 +594,13 @@
     },
     {
       "name": "listDir",
-      "description": "List directory contents in the sandbox.",
+      "description": "List files and subdirectories in a sandbox directory, optionally recursive with depth limit.",
       "inputSchema": {
         "type": "object",
         "properties": {
           "path": {
             "type": "string"
           },
-          "filePath": {
-            "type": "string"
-          },
-          "dir": {
-            "type": "string"
-          },
-          "directory": {
-            "type": "string"
-          },
           "maxEntries": {
             "type": "number"
           },
@@ -274,9 +720,6 @@
           "path": {
             "type": "string"
           },
-          "filePath": {
-            "type": "string"
-          },
           "maxBytes": {
             "type": "number"
           }
@@ -345,7 +788,7 @@
     },
     {
       "name": "searchText",
-      "description": "Search for text patterns in files within the sandbox.",
+      "description": "Search files in the sandbox by regex pattern, with glob filtering and match limits.",
       "inputSchema": {
         "type": "object",
         "properties": {
@@ -479,9 +922,6 @@
         "properties": {
           "path": {
             "type": "string"
-          },
-          "filePath": {
-            "type": "string"
           }
         },
         "required": [
@@ -548,19 +988,13 @@
     },
     {
       "name": "writeText",
-      "description": "Write UTF-8 text to a file in the sandbox.",
+      "description": "Create or overwrite a UTF-8 text file in the sandbox, with auto mkdir and overwrite protection.",
       "inputSchema": {
         "type": "object",
         "properties": {
           "path": {
             "type": "string"
           },
-          "filePath": {
-            "type": "string"
-          },
-          "text": {
-            "type": "string"
-          },
           "content": {
             "type": "string"
           },
@@ -572,11 +1006,7 @@
             "type": "object",
             "properties": {}
           }
-        },
-        "required": [
-          "path",
-          "text"
-        ]
+        }
       },
       "outputSchema": {
         "type": "object",
@@ -638,7 +1068,7 @@
     },
     {
       "name": "downloadFile",
-      "description": "Download a file from a URL to the sandbox.",
+      "description": "Download a file from a URL and save to the sandbox with size limit and SHA-256 integrity hash.",
       "inputSchema": {
         "type": "object",
         "properties": {
@@ -745,7 +1175,7 @@
     },
     {
       "name": "duckduckgoSearch",
-      "description": "Search DuckDuckGo via the Instant Answer API (no API key).",
+      "description": "Search the web via DuckDuckGo (no API key required), with HTML fallback when no instant answers.",
       "inputSchema": {
         "type": "object",
         "properties": {
@@ -975,7 +1405,7 @@
     },
     {
       "name": "fetchPageMainContent",
-      "description": "Fetch a URL and return only the main content (main/article/body text), not full HTML.",
+      "description": "Fetch a web page and extract its main readable content, stripping navigation, headers, and boilerplate.",
       "inputSchema": {
         "type": "object",
         "properties": {
@@ -1068,7 +1498,7 @@
     },
     {
       "name": "fetchText",
-      "description": "Fetch a URL and return the response as text.",
+      "description": "Fetch a URL and return the response body as text. Supports GET and POST.",
       "inputSchema": {
         "type": "object",
         "properties": {
@@ -1173,7 +1603,7 @@
     },
     {
       "name": "head",
-      "description": "Send a HEAD request to get response headers without body.",
+      "description": "Send an HTTP HEAD request to check URL status and headers without downloading the body.",
       "inputSchema": {
         "type": "object",
         "properties": {
@@ -1256,7 +1686,7 @@
     },
     {
       "name": "yahooFinanceQuote",
-      "description": "Fetch stock quote(s) from Yahoo Finance chart API (no API key).",
+      "description": "Fetch real-time stock quotes (price, change, volume) from Yahoo Finance (no API key required).",
       "inputSchema": {
         "type": "object",
         "properties": {
@@ -1476,7 +1906,7 @@
     },
     {
       "name": "jsonSelect",
-      "description": "Select fields from JSON data using JMESPath expressions.",
+      "description": "Extract values from JSON data using a JMESPath query expression.",
       "inputSchema": {
         "type": "object",
         "properties": {
@@ -1543,7 +1973,7 @@
     },
     {
       "name": "now",
-      "description": "Get the current time in various formats.",
+      "description": "Get the current date and time in ISO, epoch, and formatted forms with timezone support.",
       "inputSchema": {
         "type": "object",
         "properties": {
@@ -1685,7 +2115,7 @@
     },
     {
       "name": "truncate",
-      "description": "Truncate text to a maximum character length with a suffix marker.",
+      "description": "Truncate text to a max length, appending a suffix (default '...') when exceeded.",
       "inputSchema": {
         "type": "object",
         "properties": {

package/dist/src/analyze/analyzeLog.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Analyze log text via OpenAI-compatible LLM, identifying errors, root causes, and suggestions.
+ * Splits large logs into chunks and combines analysis.
+ * Configurable via extension config: openaiBaseUrl, openaiApiKey, model, chunkSize, chunkOverlap, timeoutMs.
+ * openaiApiKey optional when baseUrl is local (e.g. http://localhost:11434/v1 for Ollama).
+ * @tool
+ * @effect none
+ */
+export declare function analyzeLog(args: {
+    /** Raw log text to analyze (e.g. from readText). */
+    logText: string;
+    /** Alias for logText (accepted when agents send "log" or "text"). */
+    log?: string;
+    text?: string;
+    chunkSize?: number;
+    chunkOverlap?: number;
+    model?: string;
+    timeoutMs?: number;
+}): Promise<{
+    result: {
+        analysis: string;
+        chunksProcessed: number;
+    };
+    evidence: {
+        type: string;
+        summary: string;
+        createdAt: string;
+    }[];
+}>;
+//# sourceMappingURL=analyzeLog.d.ts.map

package/dist/src/analyze/analyzeLog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"analyzeLog.d.ts","sourceRoot":"","sources":["../../../src/analyze/analyzeLog.ts"],"names":[],"mappings":"AA2HA;;;;;;;GAOG;AACH,wBAAsB,UAAU,CAAC,IAAI,EAAE;IACrC,oDAAoD;IACpD,OAAO,EAAE,MAAM,CAAC;IAChB,qEAAqE;IACrE,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;;;;;;;;;;GAqFA"}