@tyvm/knowhow 0.0.158 → 0.0.160

package/src/agents/tools/list.ts

@@ -1,739 +0,0 @@
-import { Tool } from "../../clients/types";
-import { ChatCompletionTool } from "openai/resources/chat";
-
-import { services } from "../../services";
-import * as ycmd from "./ycmd/definitions";
-import * as language from "./language/definitions";
-import * as mcp from "./mcp/definitions";
-import { googleSearchDefinition } from "./googleSearch";
-import { startAgentTaskDefinition } from "./startAgentTask";
-import { replyToParentDefinition } from "./replyToParent";
-import { runGenerateDefinition } from "./runGenerate";
-import { sendAgentMessageDefinition } from "./sendAgentMessage";
-import {
-  connectAgentDefinition,
-  stopConnectionsDefinition,
-} from "./connectAgent";
-import { waitForAgentCompletedDefinition } from "./waitForAgentCompleted";
-import {
-  observeDefinition,
-  stopObservingDefinition,
-} from "./observe";
-import { skillsToolDefinitions } from "./skills";
-import { loadImageAsBase64Definition } from "./loadImageAsBase64";
-
-function getPluginNames(): string {
-  try {
-    const { Plugins } = services();
-    return Plugins.listPlugins().join(", ");
-  } catch {
-    return "";
-  }
-}
-
-export const includedTools = [
-  /*
-   * This doesn't use messageProcessors etc, needs rewrite
-   *{
-   *  type: "function",
-   *  function: {
-   *    name: "agentCall",
-   *    description:
-   *      "Run another registered agent in-process as a blocking call and get its final answer back as a string. Unlike a plain llm() call, the target agent can use tools, loop, and maintain its own context. Useful as a graph node that delegates to a specialized agent (e.g. Researcher, Patcher). For long-running / parallel / detached work prefer startAgentTask.",
-   *    parameters: {
-   *      type: "object",
-   *      positional: true,
-   *      properties: {
-   *        agentName: {
-   *          type: "string",
-   *          description:
-   *            "The name of the agent to call (e.g. Researcher, Developer, Patcher).",
-   *        },
-   *        query: {
-   *          type: "string",
-   *          description: "The query / task to send to the agent.",
-   *        },
-   *      },
-   *      required: ["agentName", "query"],
-   *    },
-   *    returns: {
-   *      type: "string",
-   *      description: "The agent's final answer text.",
-   *    },
-   *  },
-   *},
-   */
-  {
-    type: "function",
-    function: {
-      name: "embeddingSearch",
-      description:
-        "Fuzzy search with cosine similarity for files related to the user's goal. Uses embeddings. Use textSearch for exact matches. Use fileSearch for file paths.",
-      parameters: {
-        type: "object",
-        positional: true,
-        properties: {
-          keyword: {
-            type: "string",
-            description:
-              "The code, keyword or phrase to search for via embedding search",
-          },
-        },
-        required: ["keyword"],
-      },
-      returns: {
-        type: "string",
-        description: "A string containing a JSON of all the matched files",
-      },
-    },
-  },
-  {
-    type: "function",
-    function: {
-      name: "execCommand",
-      description:
-        "Execute a command as a durable managed process. Use this to run tests and terminal tasks. Use timeout: -1 to wait indefinitely. Commands ending with '&' or with continueInBackground=true survive the calling agent and return a process ID plus a .knowhow/processes/<process-id>/ directory containing status, stdin, and output logs. Use `knowhow processes` to list, inspect, send input, attach, or stop them.",
-      parameters: {
-        type: "object",
-        positional: true,
-        properties: {
-          command: {
-            type: "string",
-            description: "The command to execute. 4000 tokens or less",
-          },
-          timeout: {
-            type: "number",
-            description:
-              "Timeout in milliseconds (optional). If not provided, defaults to 5000ms. Use -1 to wait indefinitely for command completion.",
-          },
-          continueInBackground: {
-            type: "boolean",
-            description:
-              "Whether to let command continue in background on timeout (default: false). If false, command is killed on timeout.",
-          },
-          logFileName: {
-            type: "string",
-            description:
-              "Optional preferred managed process ID (sanitized for use as a directory name). If it already exists, a timestamp suffix is added.",
-          },
-        },
-        required: ["command"],
-      },
-      returns: {
-        type: "string",
-        description:
-          "The result of the command execution, including any output and errors. May include timeout status information.",
-      },
-    },
-  },
-  {
-    type: "function",
-    function: {
-      name: "finalAnswer",
-      description:
-        "Finalize the AI's task and return the answer to the user. You are required to call this at the end to send the response to the user",
-      parameters: {
-        type: "object",
-        positional: true,
-        properties: {
-          answer: {
-            type: "string",
-            description:
-              "The AI's answer to be displayed to the user as the full explanation of the task and what was done",
-          },
-        },
-        required: ["answer"],
-      },
-      returns: {
-        type: "string",
-        description:
-          "The final answer string that will be displayed to the user",
-      },
-    },
-  },
-  {
-    type: "function",
-    function: {
-      name: "callPlugin",
-      description: `Call a specified plugin with given input. Plugins provide additional context from supported URLs or words. This is a read-only operation. Currently available plugins: ${getPluginNames()}`,
-      parameters: {
-        type: "object",
-        positional: true,
-        properties: {
-          pluginName: {
-            type: "string",
-            description: "The name of the plugin to be called",
-          },
-          userInput: {
-            type: "string",
-            description: "The input to pass to the plugin",
-          },
-        },
-        required: ["pluginName", "userInput"],
-      },
-      returns: {
-        type: "string",
-        description: "The result of the plugin call",
-      },
-    },
-  },
-  {
-    type: "function",
-    function: {
-      name: "visionTool",
-      description: "Ask the vision API a question about an image url",
-      parameters: {
-        type: "object",
-        positional: true,
-        properties: {
-          imageUrl: {
-            type: "string",
-            description: "The url of the image to load",
-          },
-          question: {
-            type: "string",
-            description: "The prompt related to the image",
-          },
-          provider: {
-            type: "string",
-            description: "The AI provider to use (default: 'openai')",
-            default: "openai",
-          },
-          model: {
-            type: "string",
-            description: "The model to use (default: 'gpt-5.4-nano')",
-            default: "gpt-5.4-nano",
-          },
-        },
-        required: ["imageUrl", "question"],
-      },
-      returns: {
-        type: "string",
-        description:
-          "The results of the vision API call as an answer to the prompt question",
-      },
-    },
-  },
-  {
-    type: "function",
-    function: {
-      name: "readFile",
-      description:
-        "Read the contents of a file as plain text. Optionally pass fromLine/toLine (1-based, inclusive) to read just a range of lines; ranged reads are prefixed with real source line numbers.",
-      parameters: {
-        type: "object",
-        positional: true,
-        properties: {
-          filePath: {
-            type: "string",
-            description: "The path to the file to be read",
-          },
-          fromLine: {
-            type: "number",
-            description:
-              "Optional 1-based start line (inclusive). When provided, only lines from this point are returned, prefixed with real source line numbers.",
-          },
-          toLine: {
-            type: "number",
-            description:
-              "Optional 1-based end line (inclusive). Defaults to the end of the file when omitted.",
-          },
-        },
-        required: ["filePath"],
-      },
-      returns: {
-        type: "string",
-        description:
-          "The file contents as plain text. When a line range is requested, each line is prefixed with its real source line number.",
-      },
-    },
-  },
-  {
-    type: "function",
-    function: {
-      name: "readBlocks",
-      description:
-        "Read specific blocks from a file based on block numbers. Blocks are numbered blocks of text, containing a few lines of content ~500 characters",
-      parameters: {
-        type: "object",
-        positional: true,
-        properties: {
-          filePath: {
-            type: "string",
-            description:
-              "The path to the file from which blocks are to be read",
-          },
-          blockNumbers: {
-            type: "array",
-            items: {
-              type: "number",
-            },
-            description: "An array of block numbers to be read from the file",
-          },
-        },
-        required: ["filePath", "blockNumbers"],
-      },
-      returns: {
-        type: "array",
-        description:
-          "An array of file blocks corresponding to the specified block numbers",
-      },
-    },
-  },
-  {
-    type: "function",
-    function: {
-      name: "patchFile",
-      description:
-        "Modify file with patch. Can also create new files. Use GNU diffutils syntax with - in front of removals and + in front of additions. Always check your work after applying a patch to ensure the patch did what you expected. Think step by step while constructing the patch, of which lines your will add and remove. Make sure that your patch is maintaining proper syntax. Do not modify lines unrelated to the goal. Patches should contain 3 to 6 lines of context before and after changes. No omissions of lines for removals are allowed. Use multiple small patches over one large patch that affects multiple places in the file.",
-      parameters: {
-        type: "object",
-        positional: true,
-        properties: {
-          filePath: {
-            type: "string",
-            description: "The path to the file to be patched",
-          },
-          patch: {
-            type: "string",
-            description: "The patch to apply in unified diff format",
-          },
-        },
-        required: ["filePath", "patch"],
-      },
-    },
-  },
-
-  {
-    type: "function",
-    function: {
-      name: "lintFile",
-      description:
-        "Lint a file based on the file extension using predefined linting commands from the configuration.",
-      parameters: {
-        type: "object",
-        positional: true,
-        properties: {
-          filePath: {
-            type: "string",
-            description: "The path to the file to be linted.",
-          },
-        },
-        required: ["filePath"],
-      },
-      returns: {
-        type: "string",
-        description:
-          "The result of the linting process or an empty string if no lint command is configured for the file extension.",
-      },
-    },
-  },
-  {
-    type: "function",
-    function: {
-      name: "textSearch",
-      description:
-        "Exact Search. Search for exact matches of text across files. Use embeddingSearch for fuzzy search. Use fileSearch for file paths",
-      parameters: {
-        type: "object",
-        positional: true,
-        properties: {
-          searchTerm: {
-            type: "string",
-            description: "The text string to search for across files",
-          },
-        },
-        required: ["searchTerm"],
-      },
-      returns: {
-        type: "string",
-        description: "The result of the text search, including any matches",
-      },
-    },
-  },
-  {
-    type: "function",
-    function: {
-      name: "fileSearch",
-      description: "Search for files where the filepath includes a searchTerm",
-      parameters: {
-        type: "object",
-        positional: true,
-        properties: {
-          searchTerm: {
-            type: "string",
-            description: "a string to search for in file paths",
-          },
-        },
-        required: ["searchTerm"],
-      },
-      returns: {
-        type: "string",
-        description: "The result of the file search, including any matches",
-      },
-    },
-  },
-  {
-    type: "function",
-    function: {
-      name: "askHuman",
-      description: "Ask a human a question and get a response.",
-      parameters: {
-        type: "object",
-        positional: true,
-        properties: {
-          question: {
-            type: "string",
-            description: "The question to ask the human. Can be in markdown",
-          },
-        },
-        required: ["question"],
-      },
-      returns: {
-        type: "string",
-        description: "The response from the human.",
-      },
-    },
-  },
-
-  {
-    type: "function",
-    function: {
-      name: "writeFileChunk",
-      description:
-        "Update or create files by writing in small chunks of text. Suitable for larger files, this tool allows incremental writing by calling it multiple times. Write chunks of around 4000 tokens",
-      parameters: {
-        type: "object",
-        positional: true,
-        properties: {
-          filePath: {
-            type: "string",
-            description:
-              "The path to the file where the content will be written",
-          },
-          content: {
-            type: "string",
-            description: "The chunk of content to write to the file. 4000 tokens or less",
-          },
-          isContinuing: {
-            type: "boolean",
-            description:
-              "Flag indicating whether to append the content to an existing file (`true`) or start a new file (`false`)",
-          },
-          isDone: {
-            type: "boolean",
-            description:
-              "Flag indicating whether this is the final chunk of content",
-          },
-        },
-        required: ["filePath", "content", "isContinuing", "isDone"],
-      },
-      returns: {
-        type: "string",
-        description:
-          "A message indicating the status of the file writing process",
-      },
-    },
-  },
-
-  {
-    type: "function",
-    function: {
-      name: "createAiCompletion",
-      description: "Create a completion using the knowhow AI client",
-      parameters: {
-        type: "object",
-        properties: {
-          provider: {
-            type: "string",
-            description:
-              "The AI provider to use (e.g., 'openai', 'anthropic'). Use listAllModels to discover providers.",
-          },
-          options: {
-            type: "object",
-            description: "Provider-specific completion options",
-            properties: {
-              model: { type: "string", description: "The model to use" },
-              messages: {
-                type: "array",
-                description: "The chat history for the completion",
-                items: {
-                  type: "object",
-                  properties: {
-                    role: {
-                      type: "string",
-                      enum: ["system", "user", "assistant", "tool"],
-                      description: "The role of the message sender",
-                    },
-                    content: {
-                      type: "string",
-                      description: "The content of the message",
-                    },
-                  },
-                  required: ["role", "content"],
-                },
-                minItems: 1,
-              },
-              max_tokens: {
-                type: "number",
-                description: "Maximum number of tokens to generate",
-              },
-              tools: {
-                type: "array",
-                description:
-                  "Tool definitions the model may call (non-recursive subset)",
-                items: {
-                  type: "object",
-                  properties: {
-                    type: {
-                      type: "string",
-                      enum: ["function"],
-                      description: "The type of tool",
-                    },
-                    function: {
-                      type: "object",
-                      properties: {
-                        name: { type: "string", description: "Function name" },
-                        description: {
-                          type: "string",
-                          description: "Function description",
-                        },
-                        parameters: {
-                          type: "object",
-                          description: "Function parameters schema",
-                        },
-                      },
-                      required: ["name", "parameters"],
-                    },
-                  },
-                  required: ["type", "function"],
-                },
-              },
-            },
-            required: ["model", "messages"],
-          },
-        },
-        required: ["provider"],
-        positional: true,
-      },
-      returns: {
-        type: "object",
-        description: "The completion response from the AI provider",
-      },
-    },
-  },
-  {
-    type: "function",
-    function: {
-      name: "listAllCompletionModels",
-      description:
-        "List all available completion models using the knowhow ai client",
-      parameters: {
-        type: "object",
-        properties: {},
-        required: [],
-      },
-      returns: {
-        type: "object",
-        description:
-          "A dictionary of all available completion models for each provider",
-      },
-    },
-  },
-
-  {
-    type: "function",
-    function: {
-      name: "listAllEmbeddingModels",
-      description:
-        "List all available embedding models using the knowhow ai client",
-      parameters: {
-        type: "object",
-        properties: {},
-        required: [],
-      },
-      returns: {
-        type: "object",
-        description:
-          "A dictionary of all available embedding models for each provider",
-      },
-    },
-  },
-
-  {
-    type: "function",
-    function: {
-      name: "listAllImageModels",
-      description:
-        "List all available image generation models using the knowhow ai client. Use this to discover which providers and models support image generation.",
-      parameters: {
-        type: "object",
-        properties: {},
-        required: [],
-      },
-      returns: {
-        type: "object",
-        description:
-          "A dictionary of all available image generation models for each provider",
-      },
-    },
-  },
-
-  {
-    type: "function",
-    function: {
-      name: "listAllAudioModels",
-      description:
-        "List all available audio generation models (TTS/transcription) using the knowhow ai client. Use this to discover which providers and models support audio generation.",
-      parameters: {
-        type: "object",
-        properties: {},
-        required: [],
-      },
-      returns: {
-        type: "object",
-        description:
-          "A dictionary of all available audio generation models for each provider",
-      },
-    },
-  },
-
-  {
-    type: "function",
-    function: {
-      name: "listAllVideoModels",
-      description:
-        "List all available video generation models using the knowhow ai client. Use this to discover which providers and models support video generation.",
-      parameters: {
-        type: "object",
-        properties: {},
-        required: [],
-      },
-      returns: {
-        type: "object",
-        description:
-          "A dictionary of all available video generation models for each provider",
-      },
-    },
-  },
-
-  {
-    type: "function",
-    function: {
-      name: "listAllModels",
-      description: "List all available models using the knowhow ai client",
-      parameters: {
-        type: "object",
-        properties: {},
-        required: [],
-      },
-      returns: {
-        type: "object",
-        description: "A dictionary of all available models for each provider",
-      },
-    },
-  },
-
-  {
-    type: "function",
-    function: {
-      name: "listAllProviders",
-      description: "List all available providers using the knowhow ai client",
-      parameters: {
-        type: "object",
-        properties: {},
-        required: [],
-      },
-      returns: {
-        type: "array",
-        description: "An array of all available providers",
-      },
-    },
-  },
-
-  {
-    type: "function",
-    function: {
-      name: "createEmbedding",
-      description: "Create an embedding using the knowhow ai client",
-      parameters: {
-        type: "object",
-        positional: true,
-        properties: {
-          provider: {
-            type: "string",
-            description:
-              "The AI provider to use (e.g., 'openai', 'anthropic'). Use listAllModels to figure out which provider to use if you don't know",
-          },
-          options: {
-            type: "object",
-            description: "The embedding options",
-            properties: {
-              input: { type: "string", description: "The text to embed" },
-              model: {
-                type: "string",
-                description: "The model to use (optional)",
-              },
-            },
-            required: ["input"],
-          },
-        },
-        required: ["provider", "options"],
-      },
-      returns: {
-        type: "object",
-        description: "The embedding response from the AI provider",
-      },
-    },
-  },
-  {
-    type: "function",
-    function: {
-      name: "stringReplace",
-      description:
-        "Replace exact string matches in multiple files. Performs global replacement of all occurrences of the find string with the replace string.",
-      parameters: {
-        type: "object",
-        positional: true,
-        properties: {
-          findString: {
-            type: "string",
-            description: "The exact string to find and replace",
-          },
-          replaceString: {
-            type: "string",
-            description: "The string to replace the found string with",
-          },
-          filePaths: {
-            type: "array",
-            items: {
-              type: "string",
-            },
-            description:
-              "Array of file paths where the replacement should be performed",
-          },
-        },
-        required: ["findString", "replaceString", "filePaths"],
-      },
-      returns: {
-        type: "string",
-        description: "A summary of the replacement results for each file",
-      },
-    },
-  },
-  loadImageAsBase64Definition,
-  googleSearchDefinition,
-  startAgentTaskDefinition,
-  replyToParentDefinition,
-  runGenerateDefinition,
-  sendAgentMessageDefinition,
-  connectAgentDefinition,
-  stopConnectionsDefinition,
-  waitForAgentCompletedDefinition,
-  observeDefinition,
-  stopObservingDefinition,
-  ...ycmd.definitions,
-  ...language.definitions,
-  ...mcp.definitions,
-  ...skillsToolDefinitions,
-] as Tool[];