pygpt-net 2.4.36__py3-none-any.whl → 2.4.37__py3-none-any.whl

CHANGELOG.md

@@ -1,5 +1,13 @@
 # CHANGELOG
 
+## 2.4.37 (2024-11-30)
+
+- The `Query only` mode in `Uploaded` tab has been renamed to `RAG`.
+- New options have been added under `Settings -> Files and Attachments`: 
+  - `Use history in RAG query`: When enabled, the content of the entire conversation will be used when preparing a query if the mode is set to RAG or Summary.
+  - `RAG limit`: This option is applicable only if 'Use history in RAG query' is enabled. It specifies the limit on how many recent entries in the conversation will be used when generating a query for RAG. A value of 0 indicates no limit.
+- Cache: dynamic parts of the system prompt (from plugins) have been moved to the very end of the prompt stack to enable the use of prompt cache mechanisms in OpenAI.
+
 ## 2.4.36 (2024-11-28)
 
 - Added a new command-line argument: --workdir="/path/to/workdir" to explicitly set the current working directory.
@@ -33,7 +41,7 @@
 
 - Added an option checkbox `Auto-index on upload` in the `Attachments` tab: 
 
-**Tip:** To use the `Query only` mode, the file must be indexed in the vector database. This occurs automatically at the time of upload if the `Auto-index on upload` option in the `Attachments` tab is enabled. When uploading large files, such indexing might take a while - therefore, if you are using the `Full context` option, which does not use the index, you can disable the `Auto-index` option to speed up the upload of the attachment. In this case, it will only be indexed when the `Query only` option is called for the first time, and until then, attachment will be available in the form of `Full context` and `Summary`.
+**Tip:** To use the `RAG` mode, the file must be indexed in the vector database. This occurs automatically at the time of upload if the `Auto-index on upload` option in the `Attachments` tab is enabled. When uploading large files, such indexing might take a while - therefore, if you are using the `Full context` option, which does not use the index, you can disable the `Auto-index` option to speed up the upload of the attachment. In this case, it will only be indexed when the `RAG` option is called for the first time, and until then, attachment will be available in the form of `Full context` and `Summary`.
 
 - Added context menu options in `Uploaded attachments` tab: `Open`, `Open Source directory` and `Open Storage directory`.
 

README.md

@@ -2,7 +2,7 @@
 
 [![pygpt](https://snapcraft.io/pygpt/badge.svg)](https://snapcraft.io/pygpt)
 
-Release: **2.4.36** | build: **2024.11.28** | Python: **>=3.10, <3.12**
+Release: **2.4.37** | build: **2024.11.30** | Python: **>=3.10, <3.12**
 
 > Official website: https://pygpt.net | Documentation: https://pygpt.readthedocs.io
 > 
@@ -97,13 +97,13 @@ Linux version requires `GLIBC` >= `2.35`.
 You can install **PyGPT** directly from Snap Store:
 
 ```commandline
-$ sudo snap install pygpt
+sudo snap install pygpt
 ```
 
 To manage future updates just use:
 
 ```commandline
-$ sudo snap refresh pygpt
+sudo snap refresh pygpt
 ```
 
 [![Get it from the Snap Store](https://snapcraft.io/static/images/badges/en/snap-store-black.svg)](https://snapcraft.io/pygpt)
@@ -111,13 +111,13 @@ $ sudo snap refresh pygpt
 **Using camera:** to use camera in Snap version you must connect the camera with:
 
 ```commandline
-$ sudo snap connect pygpt:camera
+sudo snap connect pygpt:camera
 ```
 
 **Using microphone:** to use microphone in Snap version you must connect the microphone with:
 
 ```commandline
-$ sudo snap connect pygpt:audio-record :audio-record
+sudo snap connect pygpt:audio-record :audio-record
 ```
 
 **Connecting IPython in Docker in Snap version**:
@@ -125,11 +125,11 @@ $ sudo snap connect pygpt:audio-record :audio-record
 To use IPython in the Snap version, you must connect PyGPT to the Docker daemon:
 
 ```commandline
-$ sudo snap connect pygpt:docker-executables docker:docker-executables
+sudo snap connect pygpt:docker-executables docker:docker-executables
 ```
 
 ````commandline
-$ sudo snap connect pygpt:docker docker:docker-daemon
+sudo snap connect pygpt:docker docker:docker-daemon
 ````
 
 ## PyPi (pip)
@@ -139,20 +139,20 @@ The application can also be installed from `PyPi` using `pip install`:
 1. Create virtual environment:
 
 ```commandline
-$ python3 -m venv venv
-$ source venv/bin/activate
+python3 -m venv venv
+source venv/bin/activate
 ```
 
 2. Install from PyPi:
 
 ``` commandline
-$ pip install pygpt-net
+pip install pygpt-net
 ```
 
 3. Once installed run the command to start the application:
 
 ``` commandline
-$ pygpt
+pygpt
 ```
 
 ## Running from GitHub source code
@@ -164,27 +164,27 @@ An alternative method is to download the source code from `GitHub` and execute t
 1. Clone git repository or download .zip file:
 
 ```commandline
-$ git clone https://github.com/szczyglis-dev/py-gpt.git
-$ cd py-gpt
+git clone https://github.com/szczyglis-dev/py-gpt.git
+cd py-gpt
 ```
 
 2. Create a new virtual environment:
 
 ```commandline
-$ python3 -m venv venv
-$ source venv/bin/activate
+python3 -m venv venv
+source venv/bin/activate
 ```
 
 3. Install requirements:
 
 ```commandline
-$ pip install -r requirements.txt
+pip install -r requirements.txt
 ```
 
 4. Run the application:
 
 ```commandline
-$ python3 run.py
+python3 run.py
 ```
 
 ### Install with Poetry
@@ -192,33 +192,33 @@ $ python3 run.py
 1. Clone git repository or download .zip file:
 
 ```commandline
-$ git clone https://github.com/szczyglis-dev/py-gpt.git
-$ cd py-gpt
+git clone https://github.com/szczyglis-dev/py-gpt.git
+cd py-gpt
 ```
 
 2. Install Poetry (if not installed):
 
 ```commandline
-$ pip install poetry
+pip install poetry
 ```
 
 3. Create a new virtual environment that uses Python 3.10:
 
 ```commandline
-$ poetry env use python3.10
-$ poetry shell
+poetry env use python3.10
+poetry shell
 ```
 
 4. Install requirements:
 
 ```commandline
-$ poetry install
+poetry install
 ```
 
 5. Run the application:
 
 ```commandline
-$ poetry run python3 run.py
+poetry run python3 run.py
 ```
 
 **Tip**: you can use `PyInstaller` to create a compiled version of
@@ -237,19 +237,19 @@ Reinstalling the application may fix this problem.
 ...then install `libxcb`:
 
 ```commandline
-$ sudo apt install libxcb-cursor0
+sudo apt install libxcb-cursor0
 ```
 
 If you have a problems with audio on Linux, then try to install `portaudio19-dev` and/or `libasound2`:
 
 ```commandline
-$ sudo apt install portaudio19-dev
+sudo apt install portaudio19-dev
 ```
 
 ```commandline
-$ sudo apt install libasound2
-$ sudo apt install libasound2-data 
-$ sudo apt install libasound2-plugins
+sudo apt install libasound2
+sudo apt install libasound2-data 
+sudo apt install libasound2-plugins
 ```
 
 **Problems with GLIBC on Linux**
@@ -265,7 +265,7 @@ when trying to run the compiled version for Linux, try updating GLIBC to version
 
 
 ```commandline
-$ sudo snap connect pygpt:camera
+sudo snap connect pygpt:camera
 ```
 
 **Access to microphone in Snap version:**
@@ -273,7 +273,7 @@ $ sudo snap connect pygpt:camera
 To use microphone in Snap version you must connect the microphone with:
 
 ```commandline
-$ sudo snap connect pygpt:audio-record :audio-record
+sudo snap connect pygpt:audio-record :audio-record
 ```
 
 **Windows and VC++ Redistributable**
@@ -292,13 +292,13 @@ It may also be necessary to add the path `C:\path\to\venv\Lib\python3.x\site-pac
 If you have a problems with `WebEngine / Chromium` renderer you can force the legacy mode by launching the app with command line arguments:
 
 ``` ini
-$ python3 run.py --legacy=1
+python3 run.py --legacy=1
 ```
 
 and to force disable OpenGL hardware acceleration:
 
 ``` ini
-$ python3 run.py --disable-gpu=1
+python3 run.py --disable-gpu=1
 ```
 
 You can also manualy enable legacy mode by editing config file - open the `%WORKDIR%/config.json` config file in editor and set the following options:
@@ -603,11 +603,11 @@ Built-in file loaders:
 - Webpages (crawling any webpage content)
 - YouTube (transcriptions)
 
-You can configure data loaders in `Settings / LlamaIndex / Data Loaders` by providing list of keyword arguments for specified loaders.
+You can configure data loaders in `Settings / Indexes (LlamaIndex) / Data Loaders` by providing list of keyword arguments for specified loaders.
 You can also develop and provide your own custom loader and register it within the application.
 
 LlamaIndex is also integrated with context database - you can use data from database (your context history) as additional context in discussion. 
-Options for indexing existing context history or enabling real-time indexing new ones (from database) are available in `Settings / LlamaIndex` section.
+Options for indexing existing context history or enabling real-time indexing new ones (from database) are available in `Settings / Indexes (LlamaIndex)` section.
 
 **WARNING:** remember that when indexing content, API calls to the embedding model are used. Each indexing consumes additional tokens. Always control the number of tokens used on the OpenAI page.
 
@@ -669,7 +669,7 @@ You can set the limit of steps in such a loop by going to `Settings -> Agents an
 
 You can change the prompt used for evaluating the response in `Settings -> Prompts -> Agent: evaluation prompt in loop`. Here, you can adjust it to suit your needs, for example, by defining more or less critical feedback for the responses received.
 
-##  Agent (Legacy, Autonomous) 
+##  Agent (Autonomous) 
 
 This is an older version of the Agent mode, still available as legacy. However, it is recommended to use the newer mode: `Agent (LlamaIndex)`.
 
@@ -817,11 +817,13 @@ The content from the uploaded attachments will be used in the current conversati
 
 - `Full context`: Provides best results. This mode attaches the entire content of the read file to the user's prompt. This process happens in the background and may require a large number of tokens if you uploaded extensive content.
 
-- `Query only`: The indexed attachment will only be queried in real-time using LlamaIndex. This operation does not require any additional tokens, but it may not provide access to the full content of the file 1:1.
+- `RAG`: The indexed attachment will only be queried in real-time using LlamaIndex. This operation does not require any additional tokens, but it may not provide access to the full content of the file 1:1.
 
 - `Summary`: When queried, an additional query will be generated in the background and executed by a separate model to summarize the content of the attachment and return the required information to the main model. You can change the model used for summarization in the settings under the `Files and attachments` section.
 
-**Important**: When using `Full context` mode, the entire content of the file is included in the prompt, which can result in high token usage each time. If you want to reduce the number of tokens used, instead use the `Query only` option, which will only query the indexed attachment in the vector database to provide additional context.
+In the `RAG` and `Summary` mode, you can enable an additional setting by going to `Settings -> Files and attachments -> Use history in RAG query`. This allows for better preparation of queries for RAG. When this option is turned on, the entire conversation context is considered, rather than just the user's last query. This allows for better searching of the index for additional context. In the `RAG limit` option, you can set a limit on how many recent entries in a discussion should be considered (`0 = no limit, default: 3`).
+
+**Important**: When using `Full context` mode, the entire content of the file is included in the prompt, which can result in high token usage each time. If you want to reduce the number of tokens used, instead use the `RAG` option, which will only query the indexed attachment in the vector database to provide additional context.
 
 **Images as Additional Context**
 
@@ -829,7 +831,7 @@ Files such as jpg, png, and similar images are a special case. By default, image
 
 **Uploading larger files and auto-index**
 
-To use the `Query only` mode, the file must be indexed in the vector database. This occurs automatically at the time of upload if the `Auto-index on upload` option in the `Attachments` tab is enabled. When uploading large files, such indexing might take a while - therefore, if you are using the `Full context` option, which does not use the index, you can disable the `Auto-index` option to speed up the upload of the attachment. In this case, it will only be indexed when the `Query only` option is called for the first time, and until then, attachment will be available in the form of `Full context` and `Summary`.
+To use the `RAG` mode, the file must be indexed in the vector database. This occurs automatically at the time of upload if the `Auto-index on upload` option in the `Attachments` tab is enabled. When uploading large files, such indexing might take a while - therefore, if you are using the `Full context` option, which does not use the index, you can disable the `Auto-index` option to speed up the upload of the attachment. In this case, it will only be indexed when the `RAG` option is called for the first time, and until then, attachment will be available in the form of `Full context` and `Summary`.
 
 ## Downloading files
 
@@ -946,11 +948,11 @@ How to use locally installed Llama 3 or Mistral models:
 
 For example, on Linux:
 
-```$ curl -fsSL https://ollama.com/install.sh | sh```
+```curl -fsSL https://ollama.com/install.sh | sh```
 
 4) Run the model (e.g. Llama 3) locally on your machine. For example, on Linux:
 
-```$ ollama run llama3.1```
+```ollama run llama3.1```
 
 5) Return to PyGPT and select the correct model from models list to chat with selected model using Ollama running locally.
 
@@ -1467,11 +1469,11 @@ You can find the installation instructions here: https://docs.docker.com/engine/
 To use IPython in the Snap version, you must connect PyGPT to the Docker daemon:
 
 ```commandline
-$ sudo snap connect pygpt:docker-executables docker:docker-executables
+sudo snap connect pygpt:docker-executables docker:docker-executables
 ```
 
 ````commandline
-$ sudo snap connect pygpt:docker docker:docker-daemon
+sudo snap connect pygpt:docker docker:docker-daemon
 ````
 
 
@@ -2710,6 +2712,16 @@ Config -> Settings...
 
 - `Directory for file downloads`: Subdirectory for downloaded files, e.g. in Assistants mode, inside "data". Default: "download"
 
+- `Verbose mode`: Enabled verbose mode when using attachment as additional context.
+
+- `Model for querying index`: Model to use for preparing query and querying the index when the RAG option is selected.
+
+- `Model for attachment content summary`: Model to use when generating a summary for the content of a file when the Summary option is selected.
+
+- `Use history in RAG query`: When enabled, the content of the entire conversation will be used when preparing a query if mode is RAG or Summary.
+
+- `RAG limit`: Only if the option `Use history in RAG query` is enabled. Specify the limit of how many recent entries in the conversation will be used when generating a query for RAG. 0 = no limit.
+
 **Context**
 
 - `Context Threshold`: Sets the number of tokens reserved for the model to respond to the next prompt.
@@ -2961,22 +2973,6 @@ You can manually edit the configuration files in this directory (this is your wo
 
 ## Setting the Working Directory Using Command Line Arguments
 
-If you want to force set current workdir using command-line argument, use:
-
-```
-python3 ./run.py --workdir="/path/to/workdir"
-```
-or:
-
-```
-pygpt.exe --workdir="/path/to/workdir"
-```
-in binary version.
-
-Certainly! Here's the improved version:
-
-## Setting the Working Directory Using Command Line Arguments
-
 To set the current working directory using a command-line argument, use:
 
 ```
@@ -3263,7 +3259,7 @@ If you want to only query index (without chat) you can enable `Query index only
 
 You can create a custom vector store provider or data loader for your data and develop a custom launcher for the application. 
 
-See the section `Extending PyGPT / Adding custom Vector Store provider` for more details.
+See the section `Extending PyGPT / Adding a custom Vector Store provider` for more details.
 
 # Updates
 
@@ -3561,6 +3557,8 @@ Syntax: `event name` - triggered on, `event data` *(data type)*:
 
 - `AI_NAME` - when preparing an AI name, `data['value']` *(string, name of the AI assistant)*
 
+- `AGENT_PROMPT` - on agent prompt in eval mode, `data['value']` *(string, prompt)*
+
 - `AUDIO_INPUT_RECORD_START` - start audio input recording
 
 - `AUDIO_INPUT_RECORD_STOP` -  stop audio input recording
@@ -3619,10 +3617,16 @@ Syntax: `event name` - triggered on, `event data` *(data type)*:
 
 - `POST_PROMPT` - after preparing a system prompt, `data['value']` *(string, system prompt)*
 
+- `POST_PROMPT_ASYNC` - after preparing a system prompt, just before request in async thread, `data['value']` *(string, system prompt)*
+
+- `POST_PROMPT_END` - after preparing a system prompt, just before request in async thread, at the very end `data['value']` *(string, system prompt)*
+
 - `PRE_PROMPT` - before preparing a system prompt, `data['value']` *(string, system prompt)*
 
 - `SYSTEM_PROMPT` - when preparing a system prompt, `data['value']` *(string, system prompt)*
 
+- `TOOL_OUTPUT_RENDER` - when rendering extra content from tools from plugins, `data['content']` *(string, content)*
+
 - `UI_ATTACHMENTS` - when the attachment upload elements are rendered, `data['value']` *(bool, show True/False)*
 
 - `UI_VISION` - when the vision elements are rendered, `data['value']` *(bool, show True/False)*
@@ -3861,6 +3865,14 @@ may consume additional tokens that are not displayed in the main window.
 
 ## Recent changes:
 
+**2.4.37 (2024-11-30)**
+
+- The `Query only` mode in `Uploaded` tab has been renamed to `RAG`.
+- New options have been added under `Settings -> Files and Attachments`: 
+  - `Use history in RAG query`: When enabled, the content of the entire conversation will be used when preparing a query if the mode is set to RAG or Summary.
+  - `RAG limit`: This option is applicable only if 'Use history in RAG query' is enabled. It specifies the limit on how many recent entries in the conversation will be used when generating a query for RAG. A value of 0 indicates no limit.
+- Cache: dynamic parts of the system prompt (from plugins) have been moved to the very end of the prompt stack to enable the use of prompt cache mechanisms in OpenAI.
+
 **2.4.36 (2024-11-28)**
 
 - Added a new command-line argument: --workdir="/path/to/workdir" to explicitly set the current working directory.
@@ -3894,7 +3906,7 @@ may consume additional tokens that are not displayed in the main window.
 
 - Added an option checkbox `Auto-index on upload` in the `Attachments` tab: 
 
-**Tip:** To use the `Query only` mode, the file must be indexed in the vector database. This occurs automatically at the time of upload if the `Auto-index on upload` option in the `Attachments` tab is enabled. When uploading large files, such indexing might take a while - therefore, if you are using the `Full context` option, which does not use the index, you can disable the `Auto-index` option to speed up the upload of the attachment. In this case, it will only be indexed when the `Query only` option is called for the first time, and until then, attachment will be available in the form of `Full context` and `Summary`.
+**Tip:** To use the `RAG` mode, the file must be indexed in the vector database. This occurs automatically at the time of upload if the `Auto-index on upload` option in the `Attachments` tab is enabled. When uploading large files, such indexing might take a while - therefore, if you are using the `Full context` option, which does not use the index, you can disable the `Auto-index` option to speed up the upload of the attachment. In this case, it will only be indexed when the `RAG` option is called for the first time, and until then, attachment will be available in the form of `Full context` and `Summary`.
 
 - Added context menu options in `Uploaded attachments` tab: `Open`, `Open Source directory` and `Open Storage directory`.
 

pygpt_net/CHANGELOG.txt

@@ -1,3 +1,11 @@
+2.4.37 (2024-11-30)
+
+- The `Query only` mode in `Uploaded` tab has been renamed to `RAG`.
+- New options have been added under `Settings -> Files and Attachments`: 
+  - `Use history in RAG query`: When enabled, the content of the entire conversation will be used when preparing a query if the mode is set to RAG or Summary.
+  - `RAG limit`: This option is applicable only if 'Use history in RAG query' is enabled. It specifies the limit on how many recent entries in the conversation will be used when generating a query for RAG. A value of 0 indicates no limit.
+- Cache: dynamic parts of the system prompt (from plugins) have been moved to the very end of the prompt stack to enable the use of prompt cache mechanisms in OpenAI.
+
 2.4.36 (2024-11-28)
 
 - Added a new command-line argument: --workdir="/path/to/workdir" to explicitly set the current working directory.
@@ -31,7 +39,7 @@
 
 - Added an option checkbox `Auto-index on upload` in the `Attachments` tab: 
 
-Tip: To use the `Query only` mode, the file must be indexed in the vector database. This occurs automatically at the time of upload if the `Auto-index on upload` option in the `Attachments` tab is enabled. When uploading large files, such indexing might take a while - therefore, if you are using the `Full context` option, which does not use the index, you can disable the `Auto-index` option to speed up the upload of the attachment. In this case, it will only be indexed when the `Query only` option is called for the first time, and until then, attachment will be available in the form of `Full context` and `Summary`.
+Tip: To use the `RAG` mode, the file must be indexed in the vector database. This occurs automatically at the time of upload if the `Auto-index on upload` option in the `Attachments` tab is enabled. When uploading large files, such indexing might take a while - therefore, if you are using the `Full context` option, which does not use the index, you can disable the `Auto-index` option to speed up the upload of the attachment. In this case, it will only be indexed when the `RAG` option is called for the first time, and until then, attachment will be available in the form of `Full context` and `Summary`.
 
 - Added context menu options in `Uploaded attachments` tab: `Open`, `Open Source directory` and `Open Storage directory`.
 

pygpt_net/__init__.py

@@ -6,15 +6,15 @@
 # GitHub:  https://github.com/szczyglis-dev/py-gpt   #
 # MIT License                                        #
 # Created By  : Marcin Szczygliński                  #
-# Updated Date: 2024.11.28 01:00:00                  #
+# Updated Date: 2024.11.30 01:00:00                  #
 # ================================================== #
 
 __author__ = "Marcin Szczygliński"
 __copyright__ = "Copyright 2024, Marcin Szczygliński"
 __credits__ = ["Marcin Szczygliński"]
 __license__ = "MIT"
-__version__ = "2.4.36"
-__build__ = "2024.11.28"
+__version__ = "2.4.37"
+__build__ = "2024.11.30"
 __maintainer__ = "Marcin Szczygliński"
 __github__ = "https://github.com/szczyglis-dev/py-gpt"
 __website__ = "https://pygpt.net"

pygpt_net/controller/chat/attachment.py

@@ -6,7 +6,7 @@
 # GitHub:  https://github.com/szczyglis-dev/py-gpt   #
 # MIT License                                        #
 # Created By  : Marcin Szczygliński                  #
-# Updated Date: 2024.11.26 04:00:00                  #
+# Updated Date: 2024.11.29 23:00:00                  #
 # ================================================== #
 
 import os
@@ -261,26 +261,22 @@ class Attachment(QObject):
         """
         return self.mode
 
-    def get_context(self, ctx: CtxItem) -> str:
+    def get_context(self, ctx: CtxItem, history: list) -> str:
         """
         Get additional context for attachment
 
         :param ctx: CtxItem instance
+        :param history Context items (history)
         :return: Additional context
         """
-        content = ""
-        meta = ctx.meta
         if self.mode != self.MODE_DISABLED:
             if self.is_verbose():
                 print("\nPreparing additional context...\nContext Mode: {}".format(self.mode))
 
-        self.window.core.attachments.context.reset()
-        if self.mode == self.MODE_FULL_CONTEXT:
-            content = self.get_full_context(ctx)
-        elif self.mode == self.MODE_QUERY_CONTEXT:
-            content = self.get_query_context(meta, str(ctx.input))
-        elif self.mode == self.MODE_QUERY_CONTEXT_SUMMARY:
-            content = self.get_context_summary(ctx)
+        self.window.core.attachments.context.reset()  # reset used files and urls
+
+        # get additional context from attachments
+        content = self.window.core.attachments.context.get_context(self.mode, ctx, history)
 
         # append used files and urls to context
         files = self.window.core.attachments.context.get_used_files()
@@ -296,34 +292,6 @@ class Attachment(QObject):
             return "====================================\nADDITIONAL CONTEXT FROM ATTACHMENT(s): {}".format(content)
         return ""
 
-    def get_full_context(self, ctx: CtxItem) -> str:
-        """
-        Get full context for attachment
-
-        :param ctx: CtxItem instance
-        :return: Full context
-        """
-        return self.window.core.attachments.context.get_context_text(ctx, filename=True)
-
-    def get_query_context(self, meta: CtxMeta, query: str) -> str:
-        """
-        Get query context for attachment
-
-        :param meta: CtxMeta instance
-        :param query: Query string
-        :return: Query context
-        """
-        return self.window.core.attachments.context.query_context(meta, query)
-
-    def get_context_summary(self, ctx: CtxItem) -> str:
-        """
-        Get context summary
-
-        :param ctx: CtxItem instance
-        :return: Context summary
-        """
-        return self.window.core.attachments.context.summary_context(ctx, ctx.input)
-
     def get_uploaded_attachments(self, meta: CtxMeta) -> list:
         """
         Get uploaded attachments for meta