@tyvm/knowhow 0.0.88 → 0.0.90

package/autodoc/plugins/notion.mdx

@@ -1,38 +0,0 @@
-# Notion Plugin Executive Summary
-
-## Overview
-
-The Notion Plugin is designed to enhance chat interactions by integrating Notion content directly into conversations. It detects Notion URLs within user inputs, retrieves the corresponding Notion pages and their child blocks, and generates embeddings that can be used to provide additional context in chats. This plugin is particularly useful for users who frequently reference Notion documents and wish to seamlessly incorporate their content into discussions.
-
-## Key Features
-
-### Input Detection and Resolution
-
-- **URL Extraction**: The plugin scans user inputs for Notion URLs using a regular expression pattern. It identifies and extracts URLs that point to Notion pages.
-- **Page Retrieval**: For each detected URL, the plugin retrieves the corresponding Notion page and its child blocks. This includes handling nested blocks up to a specified depth.
-
-### Contextual Enhancements
-
-- **Content Embedding**: The plugin generates embeddings from the retrieved Notion pages and their child blocks. These embeddings include the text content and metadata, which can be used to enrich chat interactions with relevant information from Notion.
-- **Hierarchical Data Handling**: The plugin processes hierarchical data structures within Notion pages, ensuring that nested blocks and child pages are included in the embeddings.
-
-### Embedding Generation
-
-- **Minimal Embeddings**: The plugin creates minimal embeddings that encapsulate the essential content and metadata of Notion pages and blocks. These embeddings are structured to facilitate easy integration into chat systems.
-- **Comprehensive Data**: The embeddings include text content extracted from various block types within Notion, ensuring a comprehensive representation of the page's information.
-
-## Environment Variables
-
-To function correctly, the Notion Plugin requires the following environment variable to be set:
-
-- **NOTION_TOKEN**: This token is used to authenticate requests to the Notion API. It must be set in the environment where the plugin is running.
-
-## Usage
-
-The Notion Plugin can be used in various scenarios where integrating Notion content into chat interactions is beneficial. For example:
-
-- **Customer Support**: Support agents can quickly reference and share relevant Notion documentation with customers during chat sessions.
-- **Team Collaboration**: Team members can embed and discuss specific Notion pages within chat platforms, facilitating more informed and context-rich conversations.
-- **Knowledge Management**: Users can pull in detailed information from Notion pages to answer questions or provide explanations in chat environments.
-
-By leveraging the Notion Plugin, users can enhance their chat interactions with rich, contextual information from their Notion workspace, improving communication efficiency and effectiveness.

package/autodoc/plugins/plugins.mdx

@@ -1,59 +0,0 @@
-# Plugin Service Executive Summary
-
-## Overview
-
-The Plugin Service is a comprehensive system designed to enhance chat interactions by detecting and resolving various types of inputs, adding contextual information, and generating embeddings. This service integrates multiple specialized plugins, each contributing unique functionalities to improve user experience and productivity.
-
-## Input Detection and Resolution
-
-The Plugin Service is capable of detecting and resolving a wide range of inputs through its diverse set of plugins. Each plugin is tailored to handle specific types of data and interactions:
-
-- **VimPlugin**: Enhances text editing capabilities with Vim-like commands.
-- **GitHubPlugin**: Manages GitHub repositories, issues, and pull requests.
-- **AsanaPlugin**: Integrates with Asana for task and project management.
-- **LinearPlugin**: Connects with Linear for issue tracking and project management.
-- **JiraPlugin**: Interfaces with Jira for comprehensive project tracking.
-- **NotionPlugin**: Syncs with Notion for note-taking and project organization.
-- **DownloaderPlugin**: Facilitates downloading of files and resources.
-- **FigmaPlugin**: Integrates with Figma for design collaboration.
-- **LanguagePlugin**: Provides language processing capabilities.
-- **EmbeddingPlugin**: Generates embeddings for various types of data.
-
-## Contextual Enhancements
-
-The Plugin Service adds valuable context to chat interactions by leveraging the capabilities of its integrated plugins. For example:
-
-- **GitHubPlugin** can provide context about recent commits, open issues, and pull requests.
-- **AsanaPlugin** and **LinearPlugin** can offer insights into task statuses and project timelines.
-- **JiraPlugin** can deliver updates on project progress and issue resolutions.
-- **NotionPlugin** can share notes and project documentation.
-- **FigmaPlugin** can present design updates and feedback.
-
-These contextual enhancements ensure that users have access to relevant information directly within their chat environment, streamlining workflows and improving decision-making.
-
-## Embedding Generation
-
-The Plugin Service supports the generation of embeddings through the **EmbeddingPlugin**. Embeddings are vector representations of data that can be used for various purposes, such as:
-
-- **Text Embeddings**: Representing textual data in a numerical format for natural language processing tasks.
-- **Image Embeddings**: Converting visual data into vectors for image recognition and analysis.
-- **Custom Embeddings**: Generating embeddings for domain-specific data to enhance search and recommendation systems.
-
-These embeddings enable advanced data processing and machine learning applications, making the Plugin Service a powerful tool for data-driven tasks.
-
-## Environment Variables
-
-To ensure the proper functioning of the Plugin Service, certain environment variables need to be set. These variables are used to configure the plugins and provide necessary credentials and settings. The required environment variables include:
-
-- **GITHUB_TOKEN**: Required for the **GitHubPlugin** to authenticate and interact with GitHub APIs.
-- **ASANA_TOKEN**: Required for the **AsanaPlugin** to access Asana's API.
-- **LINEAR_API_KEY**: Required for the **LinearPlugin** to connect with Linear's services.
-- **JIRA_API_TOKEN**: Required for the **JiraPlugin** to authenticate with Jira.
-- **NOTION_API_KEY**: Required for the **NotionPlugin** to interact with Notion's API.
-- **FIGMA_API_KEY**: Required for the **FigmaPlugin** to access Figma's API.
-
-These environment variables should be set in the system where the Plugin Service is deployed to ensure seamless integration and functionality.
-
-## Conclusion
-
-The Plugin Service is a versatile and powerful system that enhances chat interactions by detecting and resolving various inputs, adding contextual information, and generating embeddings. By integrating with multiple specialized plugins, it provides a comprehensive solution for improving productivity and user experience in chat environments. Proper configuration of environment variables is essential for the optimal performance of the service.

package/autodoc/plugins/types.mdx

@@ -1,51 +0,0 @@
-# Executive Summary: Chat Enhancement Plugin
-
-## Overview
-
-The Chat Enhancement Plugin is designed to augment chat interactions by detecting and resolving specific types of user inputs, adding valuable context to conversations, and generating various types of embeddings. This plugin is particularly useful for applications that require advanced text processing, contextual understanding, and semantic embedding capabilities.
-
-## Key Features
-
-### Input Detection and Resolution
-
-The plugin is capable of detecting and resolving a wide range of user inputs. This includes, but is not limited to:
-
-- **Natural Language Queries:** The plugin can interpret and respond to user questions and commands.
-- **Contextual Prompts:** It can understand and provide relevant information based on the context of the conversation.
-- **Data Extraction:** The plugin can identify and extract key pieces of information from user inputs.
-
-### Contextual Enhancements
-
-One of the standout features of this plugin is its ability to add extra context to chats. This includes:
-
-- **Contextual Responses:** The plugin can generate responses that are contextually relevant to the ongoing conversation.
-- **Information Augmentation:** It can provide additional information that enhances the user's understanding of the topic being discussed.
-- **Dynamic Context Updates:** The plugin can dynamically update the context as the conversation progresses, ensuring that responses remain relevant.
-
-### Embedding Generation
-
-The plugin supports the generation of various types of embeddings, which are essential for tasks such as semantic search, recommendation systems, and more. The types of embeddings it can generate include:
-
-- **Minimal Embeddings:** These are lightweight embeddings that capture the essential semantics of the user input.
-- **Contextual Embeddings:** These embeddings take into account the context of the conversation, providing a richer representation of the input.
-
-## Environment Variables
-
-To ensure the plugin functions correctly, certain environment variables need to be set. These variables are used to configure the plugin and provide necessary credentials or settings. The required environment variables include:
-
-- **API_KEY:** This variable should be set to the API key provided by the service the plugin interacts with. It is essential for authenticating requests.
-- **ENVIRONMENT:** This variable specifies the environment in which the plugin is running (e.g., 'development', 'production') and can affect how the plugin behaves.
-
-## Usage
-
-The Chat Enhancement Plugin can be integrated into various applications to improve user interactions. It is particularly useful for:
-
-- **Customer Support Systems:** Enhancing automated responses and providing relevant information to customer queries.
-- **Virtual Assistants:** Improving the contextual understanding and response generation of virtual assistants.
-- **Content Recommendation:** Generating embeddings that can be used to recommend relevant content based on user inputs.
-
-By leveraging this plugin, developers can create more intelligent and responsive chat systems that provide a better user experience.
-
----
-
-This executive summary provides a high-level overview of the Chat Enhancement Plugin, focusing on its key features, required environment variables, and potential use cases. For detailed implementation and integration instructions, please refer to the full documentation.

package/autodoc/plugins/vim.mdx

@@ -1,39 +0,0 @@
-# Vim Plugin Executive Summary
-
-## Overview
-
-The Vim Plugin is designed to enhance the functionality of chat applications by detecting and resolving Vim swap files. It provides additional context to chats by identifying which files are currently open in Vim and retrieving their contents. This plugin is particularly useful for developers who frequently use Vim as their text editor and need to keep track of their open files within a collaborative environment.
-
-## Key Features
-
-### Input Detection and Resolution
-
-- **Vim Swap Files**: The plugin scans the file system for Vim swap files (`*.swp`). These files are temporary files created by Vim to store changes made to a file that is currently being edited.
-- **Source Path Resolution**: For each detected swap file, the plugin attempts to resolve the original source file path. It checks both the standard file path and the hidden dot file path to ensure accurate resolution.
-
-### Context Addition to Chats
-
-- **File Status**: The plugin provides detailed information about the status of each file, including whether the file exists, if it is a directory, or if it is too large to be processed.
-- **File Contents**: For existing files, the plugin reads and returns the file contents, adding valuable context to chats about what files are currently being edited in Vim.
-
-### Embeddings
-
-- **Empty Embeddings**: Currently, the plugin's `embed` function returns an empty array. This indicates that the plugin does not generate any specific embeddings for the detected files at this time.
-
-## Environment Variables
-
-The following environment variables are required for the plugin to function correctly:
-
-- **None**: The current implementation of the Vim Plugin does not require any environment variables to be set. All necessary configurations and paths are handled internally within the plugin.
-
-## Usage
-
-The Vim Plugin can be integrated into chat applications to provide real-time updates on files being edited in Vim. This can be particularly useful in collaborative development environments where team members need to stay informed about each other's work. By detecting Vim swap files and resolving their source paths, the plugin ensures that users have access to the most up-to-date information about their open files.
-
-### Example Use Cases
-
-- **Collaborative Coding**: Team members can see which files are currently being edited in Vim, helping to avoid conflicts and improve coordination.
-- **Code Reviews**: Reviewers can access the latest changes made to files directly from the chat, streamlining the review process.
-- **Debugging Sessions**: Developers can quickly identify which files are being modified during debugging, making it easier to track changes and resolve issues.
-
-In summary, the Vim Plugin enhances chat applications by providing real-time insights into files being edited in Vim, adding valuable context to collaborative development efforts.

package/autodoc/tools/addInternalTools.mdx

@@ -1 +0,0 @@
-This function allows an AI agent to add new internal tools (functions) to its existing set of tools. It also enables the AI to call multiple tools in parallel by adding a special function (`multi_tool_use.parallel`) that can execute several tools at the same time and return their results together.

package/autodoc/tools/agentCall.mdx

@@ -1 +0,0 @@
-This function allows an AI agent to receive a name and user input, then use a service to process or respond to that input.

package/autodoc/tools/asana/definitions.mdx

@@ -1,10 +0,0 @@
-This function set allows an AI agent to manage tasks in Asana. It can:
-
-1. **Create tasks** in a project.
-2. **Update existing tasks** with new information.
-3. **Search for tasks** using keywords.
-4. **List all projects** in Asana.
-5. **Find specific tasks** by their ID.
-6. **Retrieve tasks assigned to the user** that are not completed.
-7. **Get subtasks** for a specific task.
-8. **Create subtasks** under a parent task.

package/autodoc/tools/asana/index.mdx

@@ -1,12 +0,0 @@
-This function enables an AI agent to interact with Asana, a project management tool. Specifically, it allows the AI to:
-
-1. **Create Tasks**: Add new tasks to a project.
-2. **Update Tasks**: Modify existing tasks.
-3. **Search Tasks**: Find tasks based on a search term.
-4. **Find Specific Tasks**: Retrieve details of a specific task by its ID.
-5. **Get Subtasks**: List subtasks of a given task.
-6. **Create Subtasks**: Add subtasks to an existing task.
-7. **List My Tasks**: Retrieve tasks assigned to the AI's user.
-8. **List Projects**: Get a list of all projects in the workspace.
-
-This makes the AI capable of managing tasks and projects within Asana.

package/autodoc/tools/askHuman.mdx

@@ -1 +0,0 @@
-This function allows an AI agent to ask a human a question. It displays the question in a formatted way and then waits for the human to respond.

package/autodoc/tools/callPlugin.mdx

@@ -1 +0,0 @@
-This function allows an AI agent to use a specific plugin to process user input. It takes the name of the plugin and the user's input, then calls the plugin to get a result.

package/autodoc/tools/embeddingSearch.mdx

@@ -1 +0,0 @@
-This function helps an AI agent find files related to a user's goal by searching for keywords. It uses a plugin to perform the search and returns the results.

package/autodoc/tools/execCommand.mdx

@@ -1 +0,0 @@
-This function allows an AI agent to run commands in the system's command line and get the results.

package/autodoc/tools/fileSearch.mdx

@@ -1 +0,0 @@
-This function helps an AI agent find files on a computer that contain a specific search term in their names. It converts the search term to lowercase, creates a search command, and runs it to locate matching files.

package/autodoc/tools/finalAnswer.mdx

@@ -1 +0,0 @@
-This function allows an AI agent to complete its task and give the final answer back to the user.

package/autodoc/tools/github/definitions.mdx

@@ -1,6 +0,0 @@
-This function allows an AI agent to:
-
-1. **Fetch a pull request** from GitHub using a URL.
-2. **Get build statuses** for a pull request using a URL.
-3. **Retrieve run logs** for a specific GitHub Actions run by providing the run ID, repository owner, and repository name.
-4. **Fetch build failure logs** for a pull request using a URL.

package/autodoc/tools/github/index.mdx

@@ -1,8 +0,0 @@
-This function enables an AI agent to:
-
-1. **Fetch Pull Request Details**: Retrieve information about a specific pull request from a GitHub repository.
-2. **Get Build Statuses**: Obtain the build statuses (e.g., success, failure) for the pull request.
-3. **Retrieve Run Logs**: Fetch the logs of a specific GitHub Actions run.
-4. **Get Failure Logs**: Identify and retrieve logs related to failed build checks for a pull request, highlighting errors and failures.
-
-In short, it helps the AI agent monitor and diagnose issues in pull request builds on GitHub.

package/autodoc/tools/index.mdx

@@ -1,14 +0,0 @@
-This function allows an AI agent to perform a variety of tasks such as:
-
-- Adding internal tools
-- Calling plugins
-- Searching text and embeddings
-- Executing commands
-- Providing final answers
-- Indexing data
-- Linting, modifying, patching, reading, scanning, and writing files
-- Using vision tools
-- Integrating with Asana and GitHub
-- Searching files
-
-In short, it equips the AI with a wide range of capabilities for handling files, executing tasks, and integrating with other tools and platforms.

package/autodoc/tools/lintFile.mdx

@@ -1,7 +0,0 @@
-This function allows an AI agent to check a file for coding errors or style issues (linting) based on the file's extension. It does this by:
-
-1. Getting configuration settings.
-2. Determining the file's extension.
-3. Finding the appropriate linting command for that extension.
-4. Running the linting command on the file.
-5. Returning and logging the results of the linting process.

package/autodoc/tools/list.mdx

@@ -1,16 +0,0 @@
-This function provides an AI agent with a variety of tools to perform different tasks. Here's a simple breakdown of what each tool enables the AI to do:
-
-1. **embeddingSearch**: Find files related to a user's goal using fuzzy search.
-2. **execCommand**: Run commands in the system's terminal.
-3. **finalAnswer**: Send the final response to the user.
-4. **callPlugin**: Use additional plugins for extra context or information.
-5. **visionTool**: Analyze images and answer questions about them.
-6. **readFile**: Read the contents of a file.
-7. **readBlocks**: Read specific parts of a file.
-8. **patchFile**: Modify or create files using patches.
-9. **lintFile**: Check a file for errors based on its type.
-10. **textSearch**: Search for exact text matches in files.
-11. **fileSearch**: Search for files by their paths.
-12. **askHuman**: Ask a human a question and get a response.
-
-Additionally, it includes tools for working with GitHub and Asana.

package/autodoc/tools/modifyFile.mdx

@@ -1,7 +0,0 @@
-This function allows an AI agent to:
-
-1. **Read and Modify Files**: It can read the content of a file and update specific parts of it based on provided instructions (`fileBlocks`).
-2. **Track Changes**: It keeps track of the original content and the new content after modifications.
-3. **Generate Diffs**: It creates a diff (a summary of changes) between the original and modified content.
-4. **Linting**: It checks the modified file for any coding style or syntax issues.
-5. **Provide Feedback**: It returns a summary of changes and linting results, asking for confirmation if the changes are correct.

package/autodoc/tools/patch.mdx

@@ -1,9 +0,0 @@
-This function enables an AI agent to apply a patch to a file, ensuring the patch is correctly formatted and valid. It does the following:
-
-1. **Parse the Patch**: Breaks down the patch into manageable parts (hunks).
-2. **Validate and Fix Hunks**: Ensures each part of the patch is valid and fixes any issues.
-3. **Apply the Patch**: Applies the validated and fixed patch to the original file content.
-4. **Handle Errors**: Saves any errors encountered during the process for debugging.
-5. **Lint the File**: Checks the updated file for any coding standard issues.
-
-In short, it helps the AI agent to safely and correctly update files using patches.

package/autodoc/tools/readBlocks.mdx

@@ -1 +0,0 @@
-This function allows an AI agent to read specific parts (blocks) of a file. It takes a file path and a list of block numbers, reads the file, and returns only the blocks that match the given numbers.

package/autodoc/tools/readFile.mdx

@@ -1 +0,0 @@
-This function allows an AI agent to read a file from the filesystem, break its content into smaller chunks (blocks) of a specified size, and return these chunks as an array. If the file does not exist, it suggests possible related files. This helps the AI handle large files efficiently and manage cases where the file might be missing.

package/autodoc/tools/scanFile.mdx

@@ -1 +0,0 @@
-This function allows an AI agent to read and return a specific range of lines from a text file, including a few lines before and after the specified range for context.

package/autodoc/tools/textSearch.mdx

@@ -1,6 +0,0 @@
-This function allows an AI agent to search for a text term in two ways:
-
-1. **Primary Method**: It uses a command-line tool (`ag`) to search for the term.
-2. **Fallback Method**: If the tool isn't available, it searches through pre-configured text embeddings to find matches.
-
-In simple terms, it helps the AI find information either using a fast tool or a backup method if the tool fails.

package/autodoc/tools/types/fileblock.mdx

@@ -1 +0,0 @@
-This function allows an AI agent to handle parts of a file by breaking it into blocks. Each block has a number, optional starting line, and some content. This helps the AI manage and process large files in smaller, more manageable pieces.

package/autodoc/tools/visionTool.mdx

@@ -1 +0,0 @@
-This function allows an AI agent to analyze an image and answer a question about it.

package/autodoc/tools/writeFile.mdx

@@ -1 +0,0 @@
-This function allows an AI agent to save text to a file on the computer. If successful, it confirms the file was written; if there's an error, it returns the error message.

package/test-comprehensive.ts

@@ -1,31 +0,0 @@
-interface User {
-  id: number;
-  name: string;
-  email: string;
-}
-
-class UserService {
-  private users: User[] = [];
-
-  addUser(user: User): void {
-    this.users.push(user);
-  }
-
-  findUser(id: number): User | undefined {
-    return this.users.find(u => u.id === id);
-  }
-}
-
-const service = new UserService();
-service.addUser({
-  id: 1,
-  name: "John",
-  email: "john@example.com"
-});
-
-// Test completion on service methods
-const result = service.fi; // Should complete to findUser
-
-// Test completion on User interface properties
-const user: User = { id: 1, name: "Test", email: "test@test.com" };
-console.log(user.na); // Should complete to name