beeai-framework 0.1.10 → 0.1.12

package/dist/agents/experimental/streamlit/prompts.js.map

@@ -1 +1 @@
-{"version":3,"sources":["prompts.ts"],"names":["StreamlitAgentSystemPrompt","PromptTemplate","schema","z","object","passthrough","template"],"mappings":";;;AAmBaA,MAAAA,0BAAAA,GAA6B,IAAIC,cAAe,CAAA;AAC3DC,EAAAA,MAAAA,EAAQC,CAAEC,CAAAA,MAAAA,CAAO,EAAC,EAAGC,WAAW,EAAA;EAChCC,QAAU,EAAA,CAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA4SZ,CAAA","file":"prompts.js","sourcesContent":["/**\n * Copyright 2025 IBM Corp.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport { PromptTemplate } from \"@/template.js\";\nimport { z } from \"zod\";\n\nexport const StreamlitAgentSystemPrompt = new PromptTemplate({\n  schema: z.object({}).passthrough(),\n  template: `# Bee App Builder\n\n## Purpose\n\nYou are Bee App Builder, a friendly and creative assistant designed by IBM to build functional apps based on user requirements. Your primary goal is to make app creation simple and intuitive for users with little to no technical knowledge. Hide all technical complexities and ensure seamless communication with the user.\n\n## Communication Guidelines\n\n- **Clarify Purpose**: Politely correct users if they misunderstand your role, emphasizing that you build apps, not perform calculations or edit files.\n- **Simplify Interactions**: Avoid technical jargon unless explicitly asked. Never mention Streamlit, Python, Markdown, or any other technical details, unless explicitly asked.\n- **Encourage Engagement**: Actively ask questions to clarify user requirements and suggest useful features.\n- The user interface consists of:\n  - A left column for the chat window (user interactions with Bee App Builder).\n  - A right column showing the running app, which updates automatically when the code changes.\n  - A share button in the top-right corner for users to share their app with others.\n- If the user is unsure about what to build or requests an example, create a simple document summarizer. Offer features like summary length selection, keyword extraction, and downloading the summary as a text file.\n- Propose logical features and functionality based on the user's requirements when they are vague.\n- If the user asks for a \"generator\", \"writer\" or similar, assume that they want the app to be LLM powered.\n- If you make an error, apologize and explain that you are still learning. Reiterate your commitment to improving.\n\n## Role\n\n- You are the Bee App Builder assistant.\n- Bee App Builder is an assistant that builds code autonomously. It always performs all of the needed code edits itself and returns a full, runnable code block.\n- Outside of the knowledge of the Bee App Builder assistant, the code is executed using a Pyodide runtime. While the code is part of the message sent to the user, the message is intercepted and the code is rendered into a fully interactive app.\n- The user is not a programmer, and does not know how to code. They don't actually see the code blocks returned by the Bee App Builder assistant -- they only see the rendered app.\n- You must always refer to the code in a passive sense, and prefer the term \"app\". Never attribute the code to the user. For example, do NOT say \"I have edited your code\", instead say \"I have edited the app\".\n- When there's an error in the code, assume that it is the fault of Bee App Builder, not the user. Apologize for the error and perform a fix.\n- Never ask the user to do any work. Do not ask them to fix code, make edits, or to perform any other tasks with the source code.\n- On the other hand, if there is an error in the app, you should ask the user for details. The Bee App Builder assistant is not aware of the current runtime state of the app, as it only sees the source code, not the rendered app. Thus, you should ask the user about specifics when the error cause is not clear.\n\n---\n\n## Properly embedding code in messages\n\nTo write app code in your message, use a block tagged \\`python-app\\`, like this:\n\n\\`\\`\\`python-app\n# ...\n\\`\\`\\`\n\nIf you realize that you have made a mistake or that you can write the app in a better way, you can continue by writing another \\`python-app\\` code block -- the latest one will take effect.\n\n---\n\n## Coding guidelines\n\n### General guidelines\n\n- Write **complete and runnable code** using Streamlit.\n- You may ask clarifying questions, but always write a functional app to your best current understanding.\n- **Never** write unfinished apps with TODOs or placeholders.\n- **Never** add disabled UI elements for non-implemented functionality.\n- **Never** rely on user-supplied files or manual setup; make the app self-contained.\n- **Never** hardcode lists or options; use programmatically generated lists whenever possible.\n- Use \\`st.session_state\\` for all app state values to ensure persistence.\n- Do not write \\`try: ... except: ...\\` blocks -- always let exceptions bubble up so that we can see them and fix them.\n- Write explanatory comments in the code detailing how the app works.\n- Use fully qualified imports: \\`import library\\` instead of \\`from library import something\\`.\n\n### Asynchronous code\n\n- Write asynchronous, non-blocking code wherever possible.\n- The main method is called \\`async def main()\\`. This is the executed entrypoint. The execution environment will run the app by running the \\`main()\\` function. DO NOT attempt to run \\`main()\\` manually, the execution environment will do it!\n- For HTTP requests, use \\`pyodide.http.pyfetch\\`. \\`pyodide.http.pyfetch\\` is asynchronous and has the same interface as JS \\`fetch\\`. Example:\n\\`\\`\\`\nimport streamlit as st\nimport pyodide.http\nimport json\n\nasync def main():\n    response = pyodide.http.pyfetch(\n        \"https://example.com\",\n        method=\"POST\",\n        body=json.dumps({\"query\": query}),\n        headers={\"Content-Type\": \"application/json\"},\n    )\n    st.json(await response.json())\n\\`\\`\\`\n- DO NOT use \\`requests\\`, \\`httpx\\` or other HTTP libraries.\n- Only call \\`fetch\\` using the secure \\`https:\\` schema. Plaintext requests will fail due to security policy.\n\n### User interface\n\n- Always begin with \\`st.title(name, description)\\` and provide a name for the app and a short description.\n- Always use a button for submitting the entered data. The user could get confused if the app is missing a submit button. As a best practice, always add an appropriately labeled \\`st.button\\` (or \\`st.form_submit_button\\` when inside \\`st.form\\`) to ensure that the interface is understandable.\n- Group input elements within \\`st.form\\` for better organization.\n- IMPORTANT: Any input element like \\`st.selectbox\\` that influences other elements in a form must be placed before and outside of the form. This ensures that changes to these elements immediately update the dependent form inputs. For example:\n    - Place a \\`st.selectbox\\` for data source selection outside the form if it dictates what inputs appear in the form.\n    - Similar rules apply for other inputs such as \\`st.radio\\`, \\`st.slider\\`, or any control element that affects form structure or content.\n- Assign unique \\`key\\` values to all Streamlit elements that accept it.\n    - For lists of items, always generate a random id for each item and save it together with the item. Use the id in element keys associated with the item.\n- Make use of \\`st.columns\\`. Put elements and metrics side-by-side to create more visually pleasing UIs.\n    - Do not use higher column ratios than 5:1, to ensure consistent design.\n    - When putting text input and button side-by-side inside \\`st.columns\\`, set \\`label_visibility='collapsed'\\` on the text input to make it aligned. Be aware that this makes the label not visible. **Never** do this outside \\`st.columns\\`.\n- Use built-in Streamlit components for visualizations:\n    - \\`st.area_chart(data=None, *, x=None, y=None, x_label=None, y_label=None, color=None, stack=None, width=None, height=None, use_container_width=True)\\`\n    - \\`st.bar_chart(data=None, *, x=None, y=None, x_label=None, y_label=None, color=None, horizontal=False, stack=None, width=None, height=None, use_container_width=True)\\`\n    - \\`st.map(data=None, *, latitude=None, longitude=None, color=None, size=None, zoom=None, use_container_width=True, width=None, height=None)\\`\n    - \\`st.scatter_chart(data=None, *, x=None, y=None, x_label=None, y_label=None, color=None, size=None, width=None, height=None, use_container_width=True)\\`\n    - \\`st.graphviz_chart(figure_or_dot, use_container_width=False)\n    - \\`st.pyplot(fig=None, clear_figure=None, use_container_width=True, **kwargs)\\`\n- For showing a single number (metric, score, result of calculation, etc.), use \\`st.metric\\`: \\`st.metric(label, value, delta=None, delta_color=\"normal\", help=None, label_visibility=\"visible\")\\`\n\n- Use \\`st.divider()\\` to structure the interface.\n\n### Working with files\n\n- Use \\`st.file_uploader\\` to accept user file uploads. Process the uploaded files programmatically.\n- After a \\`st.file_uploader\\`, always use \\`submitted = st.button(\"...\")\\` to make sure the user confirmed the upload.\n- For non-text file formats (e.g., PDF, DOCX), use libraries like \\`PyPDF2\\` or \\`python-docx\\` to handle content extraction and manipulation.\n\n### LLM functions\n\n- Use \\`@st.llm_function\\` for complex text-based tasks such as summarization, analysis, and keyword extraction.\n- Always define explicit and detailed instructions for the LLM to ensure accurate results.\n- For structured outputs, use a \\`dataclass\\` to define the return type and describe every field in the instructions.\n- For unstructured output, use \\`str\\` as the return type, and the fuction will simply return the raw LLM output as a string.\n- **Never** use multiple LLM functions sequentially with the same input; combine tasks into one function instead.\n- Be verbose and specific in instructions for LLM functions, describing each expected output field in detail.\n\n### Avoid these mistakes\n\n- Avoid deprecated functions like \\`st.cache\\`; use \\`st.cache_data\\` for serializable data and \\`st.cache_resource\\` for persistent resources (e.g., database connections).\n- When querying GitHub API, make sure to parse ISO timestamps from strings like \\`created_at\\`, \\`closed_at\\`, \\`merged_at\\`.\n- When using any external API that returns a JSON reply, always check that the needes fields are present in the response.\n- Do not simultaneously set value of input element using \\`st.session_state.<key>\\` and directly using \\`st.text_input(key=\"<key>\", value=\"...\")\\`. This results in an error.\n- If you need to clear an input field after submitting, use \\`with st.form(\"form_name\", clear_on_submit=True):\\` to wrap the input elements. Do not modify \\`st.session_state.<key>\\` after rendering the element, as that will result in an error.\n- When a button that is **not** part of the form modifies \\`st.session_state\\`, it has to call \\`st.rerun()\\` afterwards to ensure proper UI refresh.\n- Do not call or await \\`main()\\` in your code. \\`main\\` is a special function that will be called by the Pyodide runtime automatically.\n\n---\n\n## Examples\n\n### Document summarizer\n\n\\`\\`\\`python-app\n# The purpose of this app is to summarize input documents, pasted in as text or uploaded as TXT, PDF or DOCX files. The app takes care to correctly extract text from each file format. An LLM function is used to write the summary with configurable length.\n# The user also requested to extract main keywords. This functionality was added to the LLM function.\n# The user further requested for text metrics (characters, words, pages) to be shown for the text being summarized.\n\nimport streamlit as st\nimport PyPDF2\nimport docx\nimport dataclasses\n\n@dataclasses.dataclass\nclass SummaryResult:\n    summary: str\n    keywords: list[str]\n\n@st.llm_function(creative=False)\nasync def summarize_document(document_text: str, num_keywords: int) -> SummaryResult:\n    \"\"\"Summarize the \\`document_text\\` into a concise summary. Write a single paragraph, do not use bullet points. Also extract \\`num_keywords\\` main keywords which represent the content.\"\"\"\n\nasync def main():\n    st.title(\"Document Summarizer\", \"Condense a document into a short summary\")\n\n    # A selectbox is used to determine input method, which influences what form fields are shown.\n    input_source = st.selectbox(\"Input source\", [\"Text box\", \"File upload\"])\n    if input_source == \"Text box\":\n        document_text = st.text_area(\"Paste the text to summarize\")\n    elif input_source == \"File upload\":\n        uploaded_file = st.file_uploader(\"Upload a file to summarize\", type=[\"txt\", \"pdf\", \"docx\"], key=\"file_uploader\")\n    summary_length = st.selectbox(\"Summary length\", [\"Short\", \"Medium\", \"Long\"], key=\"summary_length\")\n    submitted = st.button(\"Generate summary\")\n\n    if submitted:\n        if input_source == \"Text box\" and not document_text:\n            st.error(\"Please enter the text to summarize.\")\n        elif input_source == \"File upload\" and not uploaded_file:\n            st.error(\"Please upload a file to summarize.\")\n        else:\n            if input_source == \"File upload\":\n                if uploaded_file.type == \"application/pdf\":\n                    pdf_reader = PyPDF2.PdfReader(uploaded_file)\n                    document_text = \"\".join([page.extract_text() for page in pdf_reader.pages])\n                elif uploaded_file.type == \"application/vnd.openxmlformats-officedocument.wordprocessingml.document\":\n                    doc = docx.Document(uploaded_file)\n                    document_text = \"\".join([para.text for para in doc.paragraphs])\n                else:\n                    document_text = uploaded_file.read().decode(\"utf-8\")\n            num_keywords = 5 if summary_length == \"Short\" else 10 if summary_length == \"Medium\" else 15\n            result = summarize_document(document_text, num_keywords)\n            st.divider()\n            st.header(\"Summary\")\n            st.write(result.summary)\n            st.header(\"Keywords\")\n            st.write(\"\\\\n\".join(f\"- {keyword}\" for keyword in result.keywords[:num_keywords]))\n            st.divider()\n            num_characters = len(document_text)\n            num_words = len(document_text.split())\n            num_pages = num_characters / 1800\n            # We place the metrics side-by-side so the design is cleaner\n            c1, c2, c3 = st.columns([1, 1, 1])\n            with c1:\n                st.metric(label=\"Characters\", value=num_characters)\n            with c2:\n                st.metric(label=\"Words\", value=num_words)\n            with c3:\n                st.metric(label=\"Pages\", value=f\"{num_pages:.2f}\")\n\\`\\`\\`\n\n### To-Do List\n\n\\`\\`\\`python-app\n# The purpose of this app is to manage a list of tasks (\"todos\"). A clearing form is used to insert a task into a list. Tasks are displayed in bordered containers to improve visual distinction.\n# The user further requested to be able to edit and remove tasks. Since the \"edit\" and \"remove\" buttons are repeating for every task, they are labeled by a single Material icon for a minimalist look and placed inline using columns.\n# The user also requested a button to remove all finished tasks, which was added to the app.\n\nimport streamlit as st\nimport uuid\n\nasync def main():\n    if 'todos' not in st.session_state:\n        st.session_state.todos = []\n\n    st.title(\"To-Do List\", \"Track tasks and their completion\")\n\n    with st.form(\"add_todo_form\", clear_on_submit=True):\n        st.text_input(\"Task description\", key=\"new_todo\")\n        submitted = st.form_submit_button(\"Add\")\n\n    if submitted:\n        st.session_state.todos.append({\n            'id': str(uuid.uuid4()),\n            'text': st.session_state.new_todo,\n            'completed': False,\n            'editing': False,\n        })\n\n    st.divider()\n\n    if not st.session_state.todos:\n        st.write(\"_No todos yet!_\")\n\n    for todo in st.session_state.todos:\n        with st.container(border=True):\n            if todo['editing']:\n                new_text = st.text_input(\"Edit task description\", value=todo['text'], key=f\"edit_input_{todo['id']}\")\n                save_button = st.button(\"Save\", key=f\"save_{todo['id']}\")\n                if save_button:\n                    todo['text'] = new_text\n                    todo['editing'] = False\n                    st.rerun()\n            else:\n                c1, c2, c3 = st.columns([6, 1, 1]) # <- since we use small (icon) buttons, width 1 is enough\n                with c1:\n                    todo['completed'] = st.checkbox(todo['text'], value=todo['completed'], key=f\"checkbox_{todo['id']}\")\n                with c2:\n                    if st.button(\":material/edit:\", key=f\"edit_button_{todo['id']}\"):\n                        todo['editing'] = not todo['editing']\n                        st.rerun()\n                with c3:\n                    if st.button(\":material/delete:\", key=f\"delete_button_{todo['id']}\"):\n                        st.session_state.todos = [t for t in st.session_state.todos if t['id'] != todo['id']]\n                        st.rerun()\n\n    st.divider()\n\n    if st.button(\"Remove finished\"):\n        st.session_state.todos = [todo for todo in st.session_state.todos if not todo['completed']]\n        st.rerun()\n\\`\\`\\`\n\n### LinkedIn post generator\n\n\\`\\`\\`python-app\n# This app's purpose is to prepare a LinkedIn social media post. App user defines a post topic, tone, and length. An LLM function is then used to generate the text of the post. Since Bee App Builder knows that LinkedIn does not use Markdown formatting, the LLM function was instructed to instead use Unicode-based formatting.\n\nimport streamlit as st\n\n@st.llm_function(creative=True)\nasync def generate_post(topic: str, tone: str, length: str) -> str:\n    \"\"\"Write a LinkedIn-style post on the given topic with the specified tone and length. Structure the post to be eye-catching and engaging. DO NOT use Markdown formatting like **this** or __this__ as LinkedIn does not support it. Use emoji in appropriate places to make the post more lively.\"\"\"\n\nasync def main():\n    st.title(\"LinkedIn Post Generator\", \"Write social media posts on a given topic\")\n\n    topic = st.text_input(\"Post topic\", placeholder=\"e.g., industry trends, company news, thought leadership\")\n    tone = st.selectbox(\"Post tone\", [\"Professional\", \"Friendly\", \"Inspirational\", \"Humorous\"])\n    length = st.selectbox(\"Post length\", [\"Short\", \"Medium\", \"Long\"])\n\n    submitted = st.button(\"Generate post\")\n\n    if submitted:\n        if not topic:\n            st.error(\"Please enter the post topic.\")\n        else:\n            result = await generate_post(topic, tone, length)\n            st.divider()\n            st.header(\"Post\")\n            # Since we expect the user to copy and paste the generated post, we use code formatting for it\n            st.code(result, language=None, wrap_lines=True)\n\\`\\`\\`\n\n---\n\nBy adhering to these guidelines and examples, Bee App Builder ensures user-friendly, robust, and feature-rich app creation tailored to the user's needs.`,\n});\n\nexport interface StreamlitAgentTemplates {\n  system: typeof StreamlitAgentSystemPrompt;\n}\n"]}
+{"version":3,"sources":["prompts.ts"],"names":["StreamlitAgentSystemPrompt","PromptTemplate","schema","z","object","passthrough","template"],"mappings":";;;AAmBaA,MAAAA,0BAAAA,GAA6B,IAAIC,cAAe,CAAA;AAC3DC,EAAAA,MAAAA,EAAQC,CAAEC,CAAAA,MAAAA,CAAO,EAAC,EAAGC,WAAW,EAAA;EAChCC,QAAU,EAAA,CAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA4SZ,CAAA","file":"prompts.js","sourcesContent":["/**\n * Copyright 2025 © BeeAI a Series of LF Projects, LLC\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport { PromptTemplate } from \"@/template.js\";\nimport { z } from \"zod\";\n\nexport const StreamlitAgentSystemPrompt = new PromptTemplate({\n  schema: z.object({}).passthrough(),\n  template: `# Bee App Builder\n\n## Purpose\n\nYou are Bee App Builder, a friendly and creative assistant designed by IBM to build functional apps based on user requirements. Your primary goal is to make app creation simple and intuitive for users with little to no technical knowledge. Hide all technical complexities and ensure seamless communication with the user.\n\n## Communication Guidelines\n\n- **Clarify Purpose**: Politely correct users if they misunderstand your role, emphasizing that you build apps, not perform calculations or edit files.\n- **Simplify Interactions**: Avoid technical jargon unless explicitly asked. Never mention Streamlit, Python, Markdown, or any other technical details, unless explicitly asked.\n- **Encourage Engagement**: Actively ask questions to clarify user requirements and suggest useful features.\n- The user interface consists of:\n  - A left column for the chat window (user interactions with Bee App Builder).\n  - A right column showing the running app, which updates automatically when the code changes.\n  - A share button in the top-right corner for users to share their app with others.\n- If the user is unsure about what to build or requests an example, create a simple document summarizer. Offer features like summary length selection, keyword extraction, and downloading the summary as a text file.\n- Propose logical features and functionality based on the user's requirements when they are vague.\n- If the user asks for a \"generator\", \"writer\" or similar, assume that they want the app to be LLM powered.\n- If you make an error, apologize and explain that you are still learning. Reiterate your commitment to improving.\n\n## Role\n\n- You are the Bee App Builder assistant.\n- Bee App Builder is an assistant that builds code autonomously. It always performs all of the needed code edits itself and returns a full, runnable code block.\n- Outside of the knowledge of the Bee App Builder assistant, the code is executed using a Pyodide runtime. While the code is part of the message sent to the user, the message is intercepted and the code is rendered into a fully interactive app.\n- The user is not a programmer, and does not know how to code. They don't actually see the code blocks returned by the Bee App Builder assistant -- they only see the rendered app.\n- You must always refer to the code in a passive sense, and prefer the term \"app\". Never attribute the code to the user. For example, do NOT say \"I have edited your code\", instead say \"I have edited the app\".\n- When there's an error in the code, assume that it is the fault of Bee App Builder, not the user. Apologize for the error and perform a fix.\n- Never ask the user to do any work. Do not ask them to fix code, make edits, or to perform any other tasks with the source code.\n- On the other hand, if there is an error in the app, you should ask the user for details. The Bee App Builder assistant is not aware of the current runtime state of the app, as it only sees the source code, not the rendered app. Thus, you should ask the user about specifics when the error cause is not clear.\n\n---\n\n## Properly embedding code in messages\n\nTo write app code in your message, use a block tagged \\`python-app\\`, like this:\n\n\\`\\`\\`python-app\n# ...\n\\`\\`\\`\n\nIf you realize that you have made a mistake or that you can write the app in a better way, you can continue by writing another \\`python-app\\` code block -- the latest one will take effect.\n\n---\n\n## Coding guidelines\n\n### General guidelines\n\n- Write **complete and runnable code** using Streamlit.\n- You may ask clarifying questions, but always write a functional app to your best current understanding.\n- **Never** write unfinished apps with TODOs or placeholders.\n- **Never** add disabled UI elements for non-implemented functionality.\n- **Never** rely on user-supplied files or manual setup; make the app self-contained.\n- **Never** hardcode lists or options; use programmatically generated lists whenever possible.\n- Use \\`st.session_state\\` for all app state values to ensure persistence.\n- Do not write \\`try: ... except: ...\\` blocks -- always let exceptions bubble up so that we can see them and fix them.\n- Write explanatory comments in the code detailing how the app works.\n- Use fully qualified imports: \\`import library\\` instead of \\`from library import something\\`.\n\n### Asynchronous code\n\n- Write asynchronous, non-blocking code wherever possible.\n- The main method is called \\`async def main()\\`. This is the executed entrypoint. The execution environment will run the app by running the \\`main()\\` function. DO NOT attempt to run \\`main()\\` manually, the execution environment will do it!\n- For HTTP requests, use \\`pyodide.http.pyfetch\\`. \\`pyodide.http.pyfetch\\` is asynchronous and has the same interface as JS \\`fetch\\`. Example:\n\\`\\`\\`\nimport streamlit as st\nimport pyodide.http\nimport json\n\nasync def main():\n    response = pyodide.http.pyfetch(\n        \"https://example.com\",\n        method=\"POST\",\n        body=json.dumps({\"query\": query}),\n        headers={\"Content-Type\": \"application/json\"},\n    )\n    st.json(await response.json())\n\\`\\`\\`\n- DO NOT use \\`requests\\`, \\`httpx\\` or other HTTP libraries.\n- Only call \\`fetch\\` using the secure \\`https:\\` schema. Plaintext requests will fail due to security policy.\n\n### User interface\n\n- Always begin with \\`st.title(name, description)\\` and provide a name for the app and a short description.\n- Always use a button for submitting the entered data. The user could get confused if the app is missing a submit button. As a best practice, always add an appropriately labeled \\`st.button\\` (or \\`st.form_submit_button\\` when inside \\`st.form\\`) to ensure that the interface is understandable.\n- Group input elements within \\`st.form\\` for better organization.\n- IMPORTANT: Any input element like \\`st.selectbox\\` that influences other elements in a form must be placed before and outside of the form. This ensures that changes to these elements immediately update the dependent form inputs. For example:\n    - Place a \\`st.selectbox\\` for data source selection outside the form if it dictates what inputs appear in the form.\n    - Similar rules apply for other inputs such as \\`st.radio\\`, \\`st.slider\\`, or any control element that affects form structure or content.\n- Assign unique \\`key\\` values to all Streamlit elements that accept it.\n    - For lists of items, always generate a random id for each item and save it together with the item. Use the id in element keys associated with the item.\n- Make use of \\`st.columns\\`. Put elements and metrics side-by-side to create more visually pleasing UIs.\n    - Do not use higher column ratios than 5:1, to ensure consistent design.\n    - When putting text input and button side-by-side inside \\`st.columns\\`, set \\`label_visibility='collapsed'\\` on the text input to make it aligned. Be aware that this makes the label not visible. **Never** do this outside \\`st.columns\\`.\n- Use built-in Streamlit components for visualizations:\n    - \\`st.area_chart(data=None, *, x=None, y=None, x_label=None, y_label=None, color=None, stack=None, width=None, height=None, use_container_width=True)\\`\n    - \\`st.bar_chart(data=None, *, x=None, y=None, x_label=None, y_label=None, color=None, horizontal=False, stack=None, width=None, height=None, use_container_width=True)\\`\n    - \\`st.map(data=None, *, latitude=None, longitude=None, color=None, size=None, zoom=None, use_container_width=True, width=None, height=None)\\`\n    - \\`st.scatter_chart(data=None, *, x=None, y=None, x_label=None, y_label=None, color=None, size=None, width=None, height=None, use_container_width=True)\\`\n    - \\`st.graphviz_chart(figure_or_dot, use_container_width=False)\n    - \\`st.pyplot(fig=None, clear_figure=None, use_container_width=True, **kwargs)\\`\n- For showing a single number (metric, score, result of calculation, etc.), use \\`st.metric\\`: \\`st.metric(label, value, delta=None, delta_color=\"normal\", help=None, label_visibility=\"visible\")\\`\n\n- Use \\`st.divider()\\` to structure the interface.\n\n### Working with files\n\n- Use \\`st.file_uploader\\` to accept user file uploads. Process the uploaded files programmatically.\n- After a \\`st.file_uploader\\`, always use \\`submitted = st.button(\"...\")\\` to make sure the user confirmed the upload.\n- For non-text file formats (e.g., PDF, DOCX), use libraries like \\`PyPDF2\\` or \\`python-docx\\` to handle content extraction and manipulation.\n\n### LLM functions\n\n- Use \\`@st.llm_function\\` for complex text-based tasks such as summarization, analysis, and keyword extraction.\n- Always define explicit and detailed instructions for the LLM to ensure accurate results.\n- For structured outputs, use a \\`dataclass\\` to define the return type and describe every field in the instructions.\n- For unstructured output, use \\`str\\` as the return type, and the fuction will simply return the raw LLM output as a string.\n- **Never** use multiple LLM functions sequentially with the same input; combine tasks into one function instead.\n- Be verbose and specific in instructions for LLM functions, describing each expected output field in detail.\n\n### Avoid these mistakes\n\n- Avoid deprecated functions like \\`st.cache\\`; use \\`st.cache_data\\` for serializable data and \\`st.cache_resource\\` for persistent resources (e.g., database connections).\n- When querying GitHub API, make sure to parse ISO timestamps from strings like \\`created_at\\`, \\`closed_at\\`, \\`merged_at\\`.\n- When using any external API that returns a JSON reply, always check that the needes fields are present in the response.\n- Do not simultaneously set value of input element using \\`st.session_state.<key>\\` and directly using \\`st.text_input(key=\"<key>\", value=\"...\")\\`. This results in an error.\n- If you need to clear an input field after submitting, use \\`with st.form(\"form_name\", clear_on_submit=True):\\` to wrap the input elements. Do not modify \\`st.session_state.<key>\\` after rendering the element, as that will result in an error.\n- When a button that is **not** part of the form modifies \\`st.session_state\\`, it has to call \\`st.rerun()\\` afterwards to ensure proper UI refresh.\n- Do not call or await \\`main()\\` in your code. \\`main\\` is a special function that will be called by the Pyodide runtime automatically.\n\n---\n\n## Examples\n\n### Document summarizer\n\n\\`\\`\\`python-app\n# The purpose of this app is to summarize input documents, pasted in as text or uploaded as TXT, PDF or DOCX files. The app takes care to correctly extract text from each file format. An LLM function is used to write the summary with configurable length.\n# The user also requested to extract main keywords. This functionality was added to the LLM function.\n# The user further requested for text metrics (characters, words, pages) to be shown for the text being summarized.\n\nimport streamlit as st\nimport PyPDF2\nimport docx\nimport dataclasses\n\n@dataclasses.dataclass\nclass SummaryResult:\n    summary: str\n    keywords: list[str]\n\n@st.llm_function(creative=False)\nasync def summarize_document(document_text: str, num_keywords: int) -> SummaryResult:\n    \"\"\"Summarize the \\`document_text\\` into a concise summary. Write a single paragraph, do not use bullet points. Also extract \\`num_keywords\\` main keywords which represent the content.\"\"\"\n\nasync def main():\n    st.title(\"Document Summarizer\", \"Condense a document into a short summary\")\n\n    # A selectbox is used to determine input method, which influences what form fields are shown.\n    input_source = st.selectbox(\"Input source\", [\"Text box\", \"File upload\"])\n    if input_source == \"Text box\":\n        document_text = st.text_area(\"Paste the text to summarize\")\n    elif input_source == \"File upload\":\n        uploaded_file = st.file_uploader(\"Upload a file to summarize\", type=[\"txt\", \"pdf\", \"docx\"], key=\"file_uploader\")\n    summary_length = st.selectbox(\"Summary length\", [\"Short\", \"Medium\", \"Long\"], key=\"summary_length\")\n    submitted = st.button(\"Generate summary\")\n\n    if submitted:\n        if input_source == \"Text box\" and not document_text:\n            st.error(\"Please enter the text to summarize.\")\n        elif input_source == \"File upload\" and not uploaded_file:\n            st.error(\"Please upload a file to summarize.\")\n        else:\n            if input_source == \"File upload\":\n                if uploaded_file.type == \"application/pdf\":\n                    pdf_reader = PyPDF2.PdfReader(uploaded_file)\n                    document_text = \"\".join([page.extract_text() for page in pdf_reader.pages])\n                elif uploaded_file.type == \"application/vnd.openxmlformats-officedocument.wordprocessingml.document\":\n                    doc = docx.Document(uploaded_file)\n                    document_text = \"\".join([para.text for para in doc.paragraphs])\n                else:\n                    document_text = uploaded_file.read().decode(\"utf-8\")\n            num_keywords = 5 if summary_length == \"Short\" else 10 if summary_length == \"Medium\" else 15\n            result = summarize_document(document_text, num_keywords)\n            st.divider()\n            st.header(\"Summary\")\n            st.write(result.summary)\n            st.header(\"Keywords\")\n            st.write(\"\\\\n\".join(f\"- {keyword}\" for keyword in result.keywords[:num_keywords]))\n            st.divider()\n            num_characters = len(document_text)\n            num_words = len(document_text.split())\n            num_pages = num_characters / 1800\n            # We place the metrics side-by-side so the design is cleaner\n            c1, c2, c3 = st.columns([1, 1, 1])\n            with c1:\n                st.metric(label=\"Characters\", value=num_characters)\n            with c2:\n                st.metric(label=\"Words\", value=num_words)\n            with c3:\n                st.metric(label=\"Pages\", value=f\"{num_pages:.2f}\")\n\\`\\`\\`\n\n### To-Do List\n\n\\`\\`\\`python-app\n# The purpose of this app is to manage a list of tasks (\"todos\"). A clearing form is used to insert a task into a list. Tasks are displayed in bordered containers to improve visual distinction.\n# The user further requested to be able to edit and remove tasks. Since the \"edit\" and \"remove\" buttons are repeating for every task, they are labeled by a single Material icon for a minimalist look and placed inline using columns.\n# The user also requested a button to remove all finished tasks, which was added to the app.\n\nimport streamlit as st\nimport uuid\n\nasync def main():\n    if 'todos' not in st.session_state:\n        st.session_state.todos = []\n\n    st.title(\"To-Do List\", \"Track tasks and their completion\")\n\n    with st.form(\"add_todo_form\", clear_on_submit=True):\n        st.text_input(\"Task description\", key=\"new_todo\")\n        submitted = st.form_submit_button(\"Add\")\n\n    if submitted:\n        st.session_state.todos.append({\n            'id': str(uuid.uuid4()),\n            'text': st.session_state.new_todo,\n            'completed': False,\n            'editing': False,\n        })\n\n    st.divider()\n\n    if not st.session_state.todos:\n        st.write(\"_No todos yet!_\")\n\n    for todo in st.session_state.todos:\n        with st.container(border=True):\n            if todo['editing']:\n                new_text = st.text_input(\"Edit task description\", value=todo['text'], key=f\"edit_input_{todo['id']}\")\n                save_button = st.button(\"Save\", key=f\"save_{todo['id']}\")\n                if save_button:\n                    todo['text'] = new_text\n                    todo['editing'] = False\n                    st.rerun()\n            else:\n                c1, c2, c3 = st.columns([6, 1, 1]) # <- since we use small (icon) buttons, width 1 is enough\n                with c1:\n                    todo['completed'] = st.checkbox(todo['text'], value=todo['completed'], key=f\"checkbox_{todo['id']}\")\n                with c2:\n                    if st.button(\":material/edit:\", key=f\"edit_button_{todo['id']}\"):\n                        todo['editing'] = not todo['editing']\n                        st.rerun()\n                with c3:\n                    if st.button(\":material/delete:\", key=f\"delete_button_{todo['id']}\"):\n                        st.session_state.todos = [t for t in st.session_state.todos if t['id'] != todo['id']]\n                        st.rerun()\n\n    st.divider()\n\n    if st.button(\"Remove finished\"):\n        st.session_state.todos = [todo for todo in st.session_state.todos if not todo['completed']]\n        st.rerun()\n\\`\\`\\`\n\n### LinkedIn post generator\n\n\\`\\`\\`python-app\n# This app's purpose is to prepare a LinkedIn social media post. App user defines a post topic, tone, and length. An LLM function is then used to generate the text of the post. Since Bee App Builder knows that LinkedIn does not use Markdown formatting, the LLM function was instructed to instead use Unicode-based formatting.\n\nimport streamlit as st\n\n@st.llm_function(creative=True)\nasync def generate_post(topic: str, tone: str, length: str) -> str:\n    \"\"\"Write a LinkedIn-style post on the given topic with the specified tone and length. Structure the post to be eye-catching and engaging. DO NOT use Markdown formatting like **this** or __this__ as LinkedIn does not support it. Use emoji in appropriate places to make the post more lively.\"\"\"\n\nasync def main():\n    st.title(\"LinkedIn Post Generator\", \"Write social media posts on a given topic\")\n\n    topic = st.text_input(\"Post topic\", placeholder=\"e.g., industry trends, company news, thought leadership\")\n    tone = st.selectbox(\"Post tone\", [\"Professional\", \"Friendly\", \"Inspirational\", \"Humorous\"])\n    length = st.selectbox(\"Post length\", [\"Short\", \"Medium\", \"Long\"])\n\n    submitted = st.button(\"Generate post\")\n\n    if submitted:\n        if not topic:\n            st.error(\"Please enter the post topic.\")\n        else:\n            result = await generate_post(topic, tone, length)\n            st.divider()\n            st.header(\"Post\")\n            # Since we expect the user to copy and paste the generated post, we use code formatting for it\n            st.code(result, language=None, wrap_lines=True)\n\\`\\`\\`\n\n---\n\nBy adhering to these guidelines and examples, Bee App Builder ensures user-friendly, robust, and feature-rich app creation tailored to the user's needs.`,\n});\n\nexport interface StreamlitAgentTemplates {\n  system: typeof StreamlitAgentSystemPrompt;\n}\n"]}

package/dist/agents/react/agent.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["agent.ts"],"names":["ReActAgent","BaseAgent","emitter","runner","constructor","input","Emitter","root","child","namespace","creator","duplicate","tools","find","a","i","arr","b","j","name","toUpperCase","ValueError","modelId","llm","toLowerCase","tag","GraniteRunner","DeepThinkRunner","includes","DefaultRunner","register","memory","meta","slice","description","length","extraDescription","map","tool","join","_run","options","run","execution","maxRetriesPerStep","totalMaxRetries","maxIterations","init","finalMessage","state","signal","createIteration","tool_name","tool_input","output","success","add","AssistantMessage","templates","assistant","render","thought","filter","R","isTruthy","toolName","toolInput","call","JSON","stringify","toolOutput","finalAnswer","final_answer","assign","tool_output","key","emit","data","update","value","parsedValue","createdAt","Date","iterations","prompt","UserMessage","result","createSnapshot"],"mappings":"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","file":"agent.cjs","sourcesContent":["/**\n * Copyright 2025 IBM Corp.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport { BaseAgent } from \"@/agents/base.js\";\nimport { AnyTool } from \"@/tools/base.js\";\nimport { BaseMemory } from \"@/memory/base.js\";\nimport { AssistantMessage, Message, UserMessage } from \"@/backend/message.js\";\nimport { AgentMeta } from \"@/agents/types.js\";\nimport { Emitter } from \"@/emitter/emitter.js\";\nimport {\n  ReActAgentExecutionConfig,\n  ReActAgentTemplates,\n  ReActAgentCallbacks,\n  ReActAgentRunInput,\n  ReActAgentRunOptions,\n  ReActAgentRunOutput,\n} from \"@/agents/react/types.js\";\nimport { GetRunContext } from \"@/context.js\";\nimport { assign } from \"@/internals/helpers/object.js\";\nimport * as R from \"remeda\";\nimport { BaseRunner } from \"@/agents/react/runners/base.js\";\nimport { GraniteRunner } from \"@/agents/react/runners/granite/runner.js\";\nimport { DeepThinkRunner } from \"@/agents/react/runners/deep-think/runner.js\";\nimport { ValueError } from \"@/errors.js\";\nimport { DefaultRunner } from \"@/agents/react/runners/default/runner.js\";\nimport { ChatModel } from \"@/backend/chat.js\";\n\nexport type ReActAgentTemplateFactory<K extends keyof ReActAgentTemplates> = (\n  template: ReActAgentTemplates[K],\n) => ReActAgentTemplates[K];\n\nexport interface ReActAgentInput {\n  llm: ChatModel;\n  tools: AnyTool[];\n  memory: BaseMemory;\n  meta?: Omit<AgentMeta, \"tools\">;\n  templates?: Partial<{\n    [K in keyof ReActAgentTemplates]: ReActAgentTemplates[K] | ReActAgentTemplateFactory<K>;\n  }>;\n  execution?: ReActAgentExecutionConfig;\n  stream?: boolean;\n}\n\nexport class ReActAgent extends BaseAgent<\n  ReActAgentRunInput,\n  ReActAgentRunOutput,\n  ReActAgentRunOptions\n> {\n  public readonly emitter = Emitter.root.child<ReActAgentCallbacks>({\n    namespace: [\"agent\", \"react\"],\n    creator: this,\n  });\n\n  protected runner: new (...args: ConstructorParameters<typeof BaseRunner>) => BaseRunner;\n\n  constructor(protected readonly input: ReActAgentInput) {\n    super();\n\n    const duplicate = input.tools.find((a, i, arr) =>\n      arr.find((b, j) => i !== j && a.name.toUpperCase() === b.name.toUpperCase()),\n    );\n    if (duplicate) {\n      throw new ValueError(\n        `Agent's tools must all have different names. Conflicting tool: ${duplicate.name}.`,\n      );\n    }\n\n    const modelId = this.input.llm.modelId.toLowerCase();\n    this.runner =\n      [\n        { tag: \"granite\", runner: GraniteRunner },\n        { tag: \"deepseek-r1\", runner: DeepThinkRunner },\n      ].find(({ tag }) => modelId.includes(tag))?.runner ?? DefaultRunner;\n  }\n\n  static {\n    this.register();\n  }\n\n  set memory(memory: BaseMemory) {\n    this.input.memory = memory;\n  }\n\n  get memory() {\n    return this.input.memory;\n  }\n\n  get meta(): AgentMeta {\n    const tools = this.input.tools.slice();\n\n    if (this.input.meta) {\n      return { ...this.input.meta, tools };\n    }\n\n    return {\n      name: \"ReAct\",\n      tools,\n      description:\n        \"The Bee framework demonstrates its ability to auto-correct and adapt in real-time, improving the overall reliability and resilience of the system.\",\n      ...(tools.length > 0 && {\n        extraDescription: [\n          `Tools that I can use to accomplish given task.`,\n          ...tools.map((tool) => `Tool '${tool.name}': ${tool.description}.`),\n        ].join(\"\\n\"),\n      }),\n    };\n  }\n\n  protected async _run(\n    input: ReActAgentRunInput,\n    options: ReActAgentRunOptions = {},\n    run: GetRunContext<typeof this>,\n  ): Promise<ReActAgentRunOutput> {\n    const runner = new this.runner(\n      this.input,\n      {\n        ...options,\n        execution: this.input.execution ??\n          options?.execution ?? {\n            maxRetriesPerStep: 3,\n            totalMaxRetries: 20,\n            maxIterations: 10,\n          },\n      },\n      run,\n    );\n    await runner.init(input);\n\n    let finalMessage: Message | undefined;\n    while (!finalMessage) {\n      const { state, meta, emitter, signal } = await runner.createIteration();\n\n      if (state.tool_name && state.tool_input) {\n        const { output, success } = await runner.tool({\n          state,\n          emitter,\n          meta,\n          signal,\n        });\n        await runner.memory.add(\n          new AssistantMessage(\n            runner.templates.assistant.render({\n              thought: [state.thought].filter(R.isTruthy),\n              toolName: [state.tool_name].filter(R.isTruthy),\n              toolInput: [state.tool_input].filter(R.isTruthy).map((call) => JSON.stringify(call)),\n              toolOutput: [output],\n              finalAnswer: [state.final_answer].filter(R.isTruthy),\n            }),\n            { success },\n          ),\n        );\n        assign(state, { tool_output: output });\n\n        for (const key of [\"partialUpdate\", \"update\"] as const) {\n          await emitter.emit(key, {\n            data: state,\n            update: { key: \"tool_output\", value: output, parsedValue: output },\n            meta: { success, ...meta },\n            memory: runner.memory,\n          });\n        }\n      }\n      if (state.final_answer) {\n        finalMessage = new AssistantMessage(state.final_answer, {\n          createdAt: new Date(),\n        });\n        await runner.memory.add(finalMessage);\n        await emitter.emit(\"success\", {\n          data: finalMessage,\n          iterations: runner.iterations,\n          memory: runner.memory,\n          meta,\n        });\n      }\n    }\n\n    if (input.prompt !== null) {\n      await this.input.memory.add(\n        new UserMessage(input.prompt, {\n          createdAt: run.createdAt,\n        }),\n      );\n    }\n\n    await this.input.memory.add(finalMessage);\n    return { result: finalMessage, iterations: runner.iterations, memory: runner.memory };\n  }\n\n  createSnapshot() {\n    return {\n      ...super.createSnapshot(),\n      input: this.input,\n      emitter: this.emitter,\n      runner: this.runner,\n    };\n  }\n}\n"]}
+{"version":3,"sources":["agent.ts"],"names":["ReActAgent","BaseAgent","emitter","runner","constructor","input","Emitter","root","child","namespace","creator","duplicate","tools","find","a","i","arr","b","j","name","toUpperCase","ValueError","modelId","llm","toLowerCase","tag","GraniteRunner","DeepThinkRunner","includes","DefaultRunner","register","memory","meta","slice","description","length","extraDescription","map","tool","join","_run","options","run","execution","maxRetriesPerStep","totalMaxRetries","maxIterations","init","finalMessage","state","signal","createIteration","tool_name","tool_input","output","success","add","AssistantMessage","templates","assistant","render","thought","filter","R","isTruthy","toolName","toolInput","call","JSON","stringify","toolOutput","finalAnswer","final_answer","assign","tool_output","key","emit","data","update","value","parsedValue","createdAt","Date","iterations","prompt","UserMessage","result","createSnapshot"],"mappings":"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","file":"agent.cjs","sourcesContent":["/**\n * Copyright 2025 © BeeAI a Series of LF Projects, LLC\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport { BaseAgent } from \"@/agents/base.js\";\nimport { AnyTool } from \"@/tools/base.js\";\nimport { BaseMemory } from \"@/memory/base.js\";\nimport { AssistantMessage, Message, UserMessage } from \"@/backend/message.js\";\nimport { AgentMeta } from \"@/agents/types.js\";\nimport { Emitter } from \"@/emitter/emitter.js\";\nimport {\n  ReActAgentExecutionConfig,\n  ReActAgentTemplates,\n  ReActAgentCallbacks,\n  ReActAgentRunInput,\n  ReActAgentRunOptions,\n  ReActAgentRunOutput,\n} from \"@/agents/react/types.js\";\nimport { GetRunContext } from \"@/context.js\";\nimport { assign } from \"@/internals/helpers/object.js\";\nimport * as R from \"remeda\";\nimport { BaseRunner } from \"@/agents/react/runners/base.js\";\nimport { GraniteRunner } from \"@/agents/react/runners/granite/runner.js\";\nimport { DeepThinkRunner } from \"@/agents/react/runners/deep-think/runner.js\";\nimport { ValueError } from \"@/errors.js\";\nimport { DefaultRunner } from \"@/agents/react/runners/default/runner.js\";\nimport { ChatModel } from \"@/backend/chat.js\";\n\nexport type ReActAgentTemplateFactory<K extends keyof ReActAgentTemplates> = (\n  template: ReActAgentTemplates[K],\n) => ReActAgentTemplates[K];\n\nexport interface ReActAgentInput {\n  llm: ChatModel;\n  tools: AnyTool[];\n  memory: BaseMemory;\n  meta?: Omit<AgentMeta, \"tools\">;\n  templates?: Partial<{\n    [K in keyof ReActAgentTemplates]: ReActAgentTemplates[K] | ReActAgentTemplateFactory<K>;\n  }>;\n  execution?: ReActAgentExecutionConfig;\n  stream?: boolean;\n}\n\nexport class ReActAgent extends BaseAgent<\n  ReActAgentRunInput,\n  ReActAgentRunOutput,\n  ReActAgentRunOptions\n> {\n  public readonly emitter = Emitter.root.child<ReActAgentCallbacks>({\n    namespace: [\"agent\", \"react\"],\n    creator: this,\n  });\n\n  protected runner: new (...args: ConstructorParameters<typeof BaseRunner>) => BaseRunner;\n\n  constructor(protected readonly input: ReActAgentInput) {\n    super();\n\n    const duplicate = input.tools.find((a, i, arr) =>\n      arr.find((b, j) => i !== j && a.name.toUpperCase() === b.name.toUpperCase()),\n    );\n    if (duplicate) {\n      throw new ValueError(\n        `Agent's tools must all have different names. Conflicting tool: ${duplicate.name}.`,\n      );\n    }\n\n    const modelId = this.input.llm.modelId.toLowerCase();\n    this.runner =\n      [\n        { tag: \"granite\", runner: GraniteRunner },\n        { tag: \"deepseek-r1\", runner: DeepThinkRunner },\n      ].find(({ tag }) => modelId.includes(tag))?.runner ?? DefaultRunner;\n  }\n\n  static {\n    this.register();\n  }\n\n  set memory(memory: BaseMemory) {\n    this.input.memory = memory;\n  }\n\n  get memory() {\n    return this.input.memory;\n  }\n\n  get meta(): AgentMeta {\n    const tools = this.input.tools.slice();\n\n    if (this.input.meta) {\n      return { ...this.input.meta, tools };\n    }\n\n    return {\n      name: \"ReAct\",\n      tools,\n      description:\n        \"The Bee framework demonstrates its ability to auto-correct and adapt in real-time, improving the overall reliability and resilience of the system.\",\n      ...(tools.length > 0 && {\n        extraDescription: [\n          `Tools that I can use to accomplish given task.`,\n          ...tools.map((tool) => `Tool '${tool.name}': ${tool.description}.`),\n        ].join(\"\\n\"),\n      }),\n    };\n  }\n\n  protected async _run(\n    input: ReActAgentRunInput,\n    options: ReActAgentRunOptions = {},\n    run: GetRunContext<typeof this>,\n  ): Promise<ReActAgentRunOutput> {\n    const runner = new this.runner(\n      this.input,\n      {\n        ...options,\n        execution: this.input.execution ??\n          options?.execution ?? {\n            maxRetriesPerStep: 3,\n            totalMaxRetries: 20,\n            maxIterations: 10,\n          },\n      },\n      run,\n    );\n    await runner.init(input);\n\n    let finalMessage: Message | undefined;\n    while (!finalMessage) {\n      const { state, meta, emitter, signal } = await runner.createIteration();\n\n      if (state.tool_name && state.tool_input) {\n        const { output, success } = await runner.tool({\n          state,\n          emitter,\n          meta,\n          signal,\n        });\n        await runner.memory.add(\n          new AssistantMessage(\n            runner.templates.assistant.render({\n              thought: [state.thought].filter(R.isTruthy),\n              toolName: [state.tool_name].filter(R.isTruthy),\n              toolInput: [state.tool_input].filter(R.isTruthy).map((call) => JSON.stringify(call)),\n              toolOutput: [output],\n              finalAnswer: [state.final_answer].filter(R.isTruthy),\n            }),\n            { success },\n          ),\n        );\n        assign(state, { tool_output: output });\n\n        for (const key of [\"partialUpdate\", \"update\"] as const) {\n          await emitter.emit(key, {\n            data: state,\n            update: { key: \"tool_output\", value: output, parsedValue: output },\n            meta: { success, ...meta },\n            memory: runner.memory,\n          });\n        }\n      }\n      if (state.final_answer) {\n        finalMessage = new AssistantMessage(state.final_answer, {\n          createdAt: new Date(),\n        });\n        await runner.memory.add(finalMessage);\n        await emitter.emit(\"success\", {\n          data: finalMessage,\n          iterations: runner.iterations,\n          memory: runner.memory,\n          meta,\n        });\n      }\n    }\n\n    if (input.prompt !== null) {\n      await this.input.memory.add(\n        new UserMessage(input.prompt, {\n          createdAt: run.createdAt,\n        }),\n      );\n    }\n\n    await this.input.memory.add(finalMessage);\n    return { result: finalMessage, iterations: runner.iterations, memory: runner.memory };\n  }\n\n  createSnapshot() {\n    return {\n      ...super.createSnapshot(),\n      input: this.input,\n      emitter: this.emitter,\n      runner: this.runner,\n    };\n  }\n}\n"]}

package/dist/agents/react/agent.d.cts

@@ -1,11 +1,11 @@
 import '../../context.cjs';
-import '../../base-Csr9guq2.cjs';
+import '../../base-BPsHNV2O.cjs';
 import '../../tools/base.cjs';
 import '../../memory/base.cjs';
-import '../../emitter-BWtGHYn0.cjs';
+import '../../emitter-BTr99H7I.cjs';
 import './types.cjs';
-export { a as ReActAgent, R as ReActAgentInput, d as ReActAgentTemplateFactory } from '../../agent-COg8SPbf.cjs';
-import '../../backend/chat.cjs';
+export { c as ReActAgent, b as ReActAgentInput, d as ReActAgentTemplateFactory } from '../../agent-2C0Z9iYa.cjs';
+import '../../chat-BvyMdWFo.cjs';
 import '../../internals/serializable.cjs';
 import '../../internals/types.cjs';
 import '../../internals/helpers/guards.cjs';
@@ -26,7 +26,7 @@ import '../../parsers/field.cjs';
 import '@streamparser/json';
 import 'jsonrepair/stream';
 import '../../parsers/errors.cjs';
-import '../../backend/utils.cjs';
 import '../../backend/constants.cjs';
-import '@ai-sdk/provider';
+import '../../logger/logger.cjs';
+import 'pino';
 import '../../internals/helpers/counter.cjs';

package/dist/agents/react/agent.d.ts

@@ -1,11 +1,11 @@
 import '../../context.js';
-import '../../base-DHhpWHQm.js';
+import '../../base-ZnwDK6ZB.js';
 import '../../tools/base.js';
 import '../../memory/base.js';
-import '../../emitter-l0W9gC1A.js';
+import '../../emitter-DiGmS_5O.js';
 import './types.js';
-export { a as ReActAgent, R as ReActAgentInput, d as ReActAgentTemplateFactory } from '../../agent-Dv5YSk8H.js';
-import '../../backend/chat.js';
+export { c as ReActAgent, b as ReActAgentInput, d as ReActAgentTemplateFactory } from '../../agent-DN_52QhH.js';
+import '../../chat-diSK3Sui.js';
 import '../../internals/serializable.js';
 import '../../internals/types.js';
 import '../../internals/helpers/guards.js';
@@ -26,7 +26,7 @@ import '../../parsers/field.js';
 import '@streamparser/json';
 import 'jsonrepair/stream';
 import '../../parsers/errors.js';
-import '../../backend/utils.js';
 import '../../backend/constants.js';
-import '@ai-sdk/provider';
+import '../../logger/logger.js';
+import 'pino';
 import '../../internals/helpers/counter.js';

package/dist/agents/react/agent.js.map

@@ -1 +1 @@
-{"version":3,"sources":["agent.ts"],"names":["ReActAgent","BaseAgent","emitter","runner","constructor","input","Emitter","root","child","namespace","creator","duplicate","tools","find","a","i","arr","b","j","name","toUpperCase","ValueError","modelId","llm","toLowerCase","tag","GraniteRunner","DeepThinkRunner","includes","DefaultRunner","register","memory","meta","slice","description","length","extraDescription","map","tool","join","_run","options","run","execution","maxRetriesPerStep","totalMaxRetries","maxIterations","init","finalMessage","state","signal","createIteration","tool_name","tool_input","output","success","add","AssistantMessage","templates","assistant","render","thought","filter","R","isTruthy","toolName","toolInput","call","JSON","stringify","toolOutput","finalAnswer","final_answer","assign","tool_output","key","emit","data","update","value","parsedValue","createdAt","Date","iterations","prompt","UserMessage","result","createSnapshot"],"mappings":"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","file":"agent.js","sourcesContent":["/**\n * Copyright 2025 IBM Corp.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport { BaseAgent } from \"@/agents/base.js\";\nimport { AnyTool } from \"@/tools/base.js\";\nimport { BaseMemory } from \"@/memory/base.js\";\nimport { AssistantMessage, Message, UserMessage } from \"@/backend/message.js\";\nimport { AgentMeta } from \"@/agents/types.js\";\nimport { Emitter } from \"@/emitter/emitter.js\";\nimport {\n  ReActAgentExecutionConfig,\n  ReActAgentTemplates,\n  ReActAgentCallbacks,\n  ReActAgentRunInput,\n  ReActAgentRunOptions,\n  ReActAgentRunOutput,\n} from \"@/agents/react/types.js\";\nimport { GetRunContext } from \"@/context.js\";\nimport { assign } from \"@/internals/helpers/object.js\";\nimport * as R from \"remeda\";\nimport { BaseRunner } from \"@/agents/react/runners/base.js\";\nimport { GraniteRunner } from \"@/agents/react/runners/granite/runner.js\";\nimport { DeepThinkRunner } from \"@/agents/react/runners/deep-think/runner.js\";\nimport { ValueError } from \"@/errors.js\";\nimport { DefaultRunner } from \"@/agents/react/runners/default/runner.js\";\nimport { ChatModel } from \"@/backend/chat.js\";\n\nexport type ReActAgentTemplateFactory<K extends keyof ReActAgentTemplates> = (\n  template: ReActAgentTemplates[K],\n) => ReActAgentTemplates[K];\n\nexport interface ReActAgentInput {\n  llm: ChatModel;\n  tools: AnyTool[];\n  memory: BaseMemory;\n  meta?: Omit<AgentMeta, \"tools\">;\n  templates?: Partial<{\n    [K in keyof ReActAgentTemplates]: ReActAgentTemplates[K] | ReActAgentTemplateFactory<K>;\n  }>;\n  execution?: ReActAgentExecutionConfig;\n  stream?: boolean;\n}\n\nexport class ReActAgent extends BaseAgent<\n  ReActAgentRunInput,\n  ReActAgentRunOutput,\n  ReActAgentRunOptions\n> {\n  public readonly emitter = Emitter.root.child<ReActAgentCallbacks>({\n    namespace: [\"agent\", \"react\"],\n    creator: this,\n  });\n\n  protected runner: new (...args: ConstructorParameters<typeof BaseRunner>) => BaseRunner;\n\n  constructor(protected readonly input: ReActAgentInput) {\n    super();\n\n    const duplicate = input.tools.find((a, i, arr) =>\n      arr.find((b, j) => i !== j && a.name.toUpperCase() === b.name.toUpperCase()),\n    );\n    if (duplicate) {\n      throw new ValueError(\n        `Agent's tools must all have different names. Conflicting tool: ${duplicate.name}.`,\n      );\n    }\n\n    const modelId = this.input.llm.modelId.toLowerCase();\n    this.runner =\n      [\n        { tag: \"granite\", runner: GraniteRunner },\n        { tag: \"deepseek-r1\", runner: DeepThinkRunner },\n      ].find(({ tag }) => modelId.includes(tag))?.runner ?? DefaultRunner;\n  }\n\n  static {\n    this.register();\n  }\n\n  set memory(memory: BaseMemory) {\n    this.input.memory = memory;\n  }\n\n  get memory() {\n    return this.input.memory;\n  }\n\n  get meta(): AgentMeta {\n    const tools = this.input.tools.slice();\n\n    if (this.input.meta) {\n      return { ...this.input.meta, tools };\n    }\n\n    return {\n      name: \"ReAct\",\n      tools,\n      description:\n        \"The Bee framework demonstrates its ability to auto-correct and adapt in real-time, improving the overall reliability and resilience of the system.\",\n      ...(tools.length > 0 && {\n        extraDescription: [\n          `Tools that I can use to accomplish given task.`,\n          ...tools.map((tool) => `Tool '${tool.name}': ${tool.description}.`),\n        ].join(\"\\n\"),\n      }),\n    };\n  }\n\n  protected async _run(\n    input: ReActAgentRunInput,\n    options: ReActAgentRunOptions = {},\n    run: GetRunContext<typeof this>,\n  ): Promise<ReActAgentRunOutput> {\n    const runner = new this.runner(\n      this.input,\n      {\n        ...options,\n        execution: this.input.execution ??\n          options?.execution ?? {\n            maxRetriesPerStep: 3,\n            totalMaxRetries: 20,\n            maxIterations: 10,\n          },\n      },\n      run,\n    );\n    await runner.init(input);\n\n    let finalMessage: Message | undefined;\n    while (!finalMessage) {\n      const { state, meta, emitter, signal } = await runner.createIteration();\n\n      if (state.tool_name && state.tool_input) {\n        const { output, success } = await runner.tool({\n          state,\n          emitter,\n          meta,\n          signal,\n        });\n        await runner.memory.add(\n          new AssistantMessage(\n            runner.templates.assistant.render({\n              thought: [state.thought].filter(R.isTruthy),\n              toolName: [state.tool_name].filter(R.isTruthy),\n              toolInput: [state.tool_input].filter(R.isTruthy).map((call) => JSON.stringify(call)),\n              toolOutput: [output],\n              finalAnswer: [state.final_answer].filter(R.isTruthy),\n            }),\n            { success },\n          ),\n        );\n        assign(state, { tool_output: output });\n\n        for (const key of [\"partialUpdate\", \"update\"] as const) {\n          await emitter.emit(key, {\n            data: state,\n            update: { key: \"tool_output\", value: output, parsedValue: output },\n            meta: { success, ...meta },\n            memory: runner.memory,\n          });\n        }\n      }\n      if (state.final_answer) {\n        finalMessage = new AssistantMessage(state.final_answer, {\n          createdAt: new Date(),\n        });\n        await runner.memory.add(finalMessage);\n        await emitter.emit(\"success\", {\n          data: finalMessage,\n          iterations: runner.iterations,\n          memory: runner.memory,\n          meta,\n        });\n      }\n    }\n\n    if (input.prompt !== null) {\n      await this.input.memory.add(\n        new UserMessage(input.prompt, {\n          createdAt: run.createdAt,\n        }),\n      );\n    }\n\n    await this.input.memory.add(finalMessage);\n    return { result: finalMessage, iterations: runner.iterations, memory: runner.memory };\n  }\n\n  createSnapshot() {\n    return {\n      ...super.createSnapshot(),\n      input: this.input,\n      emitter: this.emitter,\n      runner: this.runner,\n    };\n  }\n}\n"]}
+{"version":3,"sources":["agent.ts"],"names":["ReActAgent","BaseAgent","emitter","runner","constructor","input","Emitter","root","child","namespace","creator","duplicate","tools","find","a","i","arr","b","j","name","toUpperCase","ValueError","modelId","llm","toLowerCase","tag","GraniteRunner","DeepThinkRunner","includes","DefaultRunner","register","memory","meta","slice","description","length","extraDescription","map","tool","join","_run","options","run","execution","maxRetriesPerStep","totalMaxRetries","maxIterations","init","finalMessage","state","signal","createIteration","tool_name","tool_input","output","success","add","AssistantMessage","templates","assistant","render","thought","filter","R","isTruthy","toolName","toolInput","call","JSON","stringify","toolOutput","finalAnswer","final_answer","assign","tool_output","key","emit","data","update","value","parsedValue","createdAt","Date","iterations","prompt","UserMessage","result","createSnapshot"],"mappings":"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","file":"agent.js","sourcesContent":["/**\n * Copyright 2025 © BeeAI a Series of LF Projects, LLC\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport { BaseAgent } from \"@/agents/base.js\";\nimport { AnyTool } from \"@/tools/base.js\";\nimport { BaseMemory } from \"@/memory/base.js\";\nimport { AssistantMessage, Message, UserMessage } from \"@/backend/message.js\";\nimport { AgentMeta } from \"@/agents/types.js\";\nimport { Emitter } from \"@/emitter/emitter.js\";\nimport {\n  ReActAgentExecutionConfig,\n  ReActAgentTemplates,\n  ReActAgentCallbacks,\n  ReActAgentRunInput,\n  ReActAgentRunOptions,\n  ReActAgentRunOutput,\n} from \"@/agents/react/types.js\";\nimport { GetRunContext } from \"@/context.js\";\nimport { assign } from \"@/internals/helpers/object.js\";\nimport * as R from \"remeda\";\nimport { BaseRunner } from \"@/agents/react/runners/base.js\";\nimport { GraniteRunner } from \"@/agents/react/runners/granite/runner.js\";\nimport { DeepThinkRunner } from \"@/agents/react/runners/deep-think/runner.js\";\nimport { ValueError } from \"@/errors.js\";\nimport { DefaultRunner } from \"@/agents/react/runners/default/runner.js\";\nimport { ChatModel } from \"@/backend/chat.js\";\n\nexport type ReActAgentTemplateFactory<K extends keyof ReActAgentTemplates> = (\n  template: ReActAgentTemplates[K],\n) => ReActAgentTemplates[K];\n\nexport interface ReActAgentInput {\n  llm: ChatModel;\n  tools: AnyTool[];\n  memory: BaseMemory;\n  meta?: Omit<AgentMeta, \"tools\">;\n  templates?: Partial<{\n    [K in keyof ReActAgentTemplates]: ReActAgentTemplates[K] | ReActAgentTemplateFactory<K>;\n  }>;\n  execution?: ReActAgentExecutionConfig;\n  stream?: boolean;\n}\n\nexport class ReActAgent extends BaseAgent<\n  ReActAgentRunInput,\n  ReActAgentRunOutput,\n  ReActAgentRunOptions\n> {\n  public readonly emitter = Emitter.root.child<ReActAgentCallbacks>({\n    namespace: [\"agent\", \"react\"],\n    creator: this,\n  });\n\n  protected runner: new (...args: ConstructorParameters<typeof BaseRunner>) => BaseRunner;\n\n  constructor(protected readonly input: ReActAgentInput) {\n    super();\n\n    const duplicate = input.tools.find((a, i, arr) =>\n      arr.find((b, j) => i !== j && a.name.toUpperCase() === b.name.toUpperCase()),\n    );\n    if (duplicate) {\n      throw new ValueError(\n        `Agent's tools must all have different names. Conflicting tool: ${duplicate.name}.`,\n      );\n    }\n\n    const modelId = this.input.llm.modelId.toLowerCase();\n    this.runner =\n      [\n        { tag: \"granite\", runner: GraniteRunner },\n        { tag: \"deepseek-r1\", runner: DeepThinkRunner },\n      ].find(({ tag }) => modelId.includes(tag))?.runner ?? DefaultRunner;\n  }\n\n  static {\n    this.register();\n  }\n\n  set memory(memory: BaseMemory) {\n    this.input.memory = memory;\n  }\n\n  get memory() {\n    return this.input.memory;\n  }\n\n  get meta(): AgentMeta {\n    const tools = this.input.tools.slice();\n\n    if (this.input.meta) {\n      return { ...this.input.meta, tools };\n    }\n\n    return {\n      name: \"ReAct\",\n      tools,\n      description:\n        \"The Bee framework demonstrates its ability to auto-correct and adapt in real-time, improving the overall reliability and resilience of the system.\",\n      ...(tools.length > 0 && {\n        extraDescription: [\n          `Tools that I can use to accomplish given task.`,\n          ...tools.map((tool) => `Tool '${tool.name}': ${tool.description}.`),\n        ].join(\"\\n\"),\n      }),\n    };\n  }\n\n  protected async _run(\n    input: ReActAgentRunInput,\n    options: ReActAgentRunOptions = {},\n    run: GetRunContext<typeof this>,\n  ): Promise<ReActAgentRunOutput> {\n    const runner = new this.runner(\n      this.input,\n      {\n        ...options,\n        execution: this.input.execution ??\n          options?.execution ?? {\n            maxRetriesPerStep: 3,\n            totalMaxRetries: 20,\n            maxIterations: 10,\n          },\n      },\n      run,\n    );\n    await runner.init(input);\n\n    let finalMessage: Message | undefined;\n    while (!finalMessage) {\n      const { state, meta, emitter, signal } = await runner.createIteration();\n\n      if (state.tool_name && state.tool_input) {\n        const { output, success } = await runner.tool({\n          state,\n          emitter,\n          meta,\n          signal,\n        });\n        await runner.memory.add(\n          new AssistantMessage(\n            runner.templates.assistant.render({\n              thought: [state.thought].filter(R.isTruthy),\n              toolName: [state.tool_name].filter(R.isTruthy),\n              toolInput: [state.tool_input].filter(R.isTruthy).map((call) => JSON.stringify(call)),\n              toolOutput: [output],\n              finalAnswer: [state.final_answer].filter(R.isTruthy),\n            }),\n            { success },\n          ),\n        );\n        assign(state, { tool_output: output });\n\n        for (const key of [\"partialUpdate\", \"update\"] as const) {\n          await emitter.emit(key, {\n            data: state,\n            update: { key: \"tool_output\", value: output, parsedValue: output },\n            meta: { success, ...meta },\n            memory: runner.memory,\n          });\n        }\n      }\n      if (state.final_answer) {\n        finalMessage = new AssistantMessage(state.final_answer, {\n          createdAt: new Date(),\n        });\n        await runner.memory.add(finalMessage);\n        await emitter.emit(\"success\", {\n          data: finalMessage,\n          iterations: runner.iterations,\n          memory: runner.memory,\n          meta,\n        });\n      }\n    }\n\n    if (input.prompt !== null) {\n      await this.input.memory.add(\n        new UserMessage(input.prompt, {\n          createdAt: run.createdAt,\n        }),\n      );\n    }\n\n    await this.input.memory.add(finalMessage);\n    return { result: finalMessage, iterations: runner.iterations, memory: runner.memory };\n  }\n\n  createSnapshot() {\n    return {\n      ...super.createSnapshot(),\n      input: this.input,\n      emitter: this.emitter,\n      runner: this.runner,\n    };\n  }\n}\n"]}

package/dist/agents/react/prompts.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["prompts.ts"],"names":["ReActAgentSystemPrompt","PromptTemplate","schema","z","object","instructions","string","default","tools","array","name","min","description","passthrough","createdAt","datetime","nullish","template","ReActAgentAssistantPrompt","thought","toolName","toolInput","toolOutput","finalAnswer","partial","ReActAgentUserPrompt","input","meta","optional","functions","formatMeta","parts","filter","Boolean","join","ReActAgentUserEmptyPrompt","ReActAgentToolErrorPrompt","reason","ReActAgentToolInputErrorPrompt","ReActAgentToolNoResultsPrompt","record","any","ReActAgentToolNotFoundPrompt","ReActAgentSchemaErrorPrompt"],"mappings":"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","file":"prompts.cjs","sourcesContent":["/**\n * Copyright 2025 IBM Corp.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport { PromptTemplate } from \"@/template.js\";\nimport { z } from \"zod\";\nimport { MessageMeta } from \"@/backend/message.js\";\n\nexport const ReActAgentSystemPrompt = new PromptTemplate({\n  schema: z.object({\n    instructions: z.string().default(\"You are a helpful assistant.\"),\n    tools: z.array(\n      z\n        .object({\n          name: z.string().min(1),\n          description: z.string().min(1),\n          schema: z.string().min(1),\n        })\n        .passthrough(),\n    ),\n    createdAt: z.string().datetime().nullish(),\n  }),\n  template: `# Available functions\n{{#tools.length}}\nYou can only use the following functions. Always use all required parameters.\n\n{{#tools}}\nFunction Name: {{name}}\nDescription: {{description}}\nParameters: {{schema}}\n\n{{/tools}}\n{{/tools.length}}\n{{^tools.length}}\nNo functions are available.\n\n{{/tools.length}}\n# Communication structure\nYou communicate only in instruction lines. The format is: \"Instruction: expected output\\n\". You must only use these instruction lines and must not enter empty lines between them. Each instruction must start on a new line.\n{{#tools.length}}\nYou must skip the instruction lines Function Name, Function Input and Function Output if no function calling is required.\n{{/tools.length}}\n\nMessage: User's message. You never use this instruction line.\n{{^tools.length}}\nThought: A single-line plan of how to answer the user's message, including an explanation of the reasoning behind it. It must be immediately followed by Final Answer.\n{{/tools.length}}\n{{#tools.length}}\nThought: A single-line step-by-step plan of how to answer the user's message, including an explanation of the reasoning behind it. You can use the available functions defined above. This instruction line must be immediately followed by Function Name if one of the available functions defined above needs to be called, or by Final Answer. Do not provide the answer here.\nFunction Name: Name of the function. This instruction line must be immediately followed by Function Input.\nFunction Input: Function parameters. Empty object is a valid parameter.\nFunction Output: Output of the function in JSON format.\nThought: Continue your thinking process.\n{{/tools.length}}\nFinal Answer: Answer the user or ask for more information or clarification. It must always be preceded by Thought.\n\n## Examples\nMessage: Can you translate \"How are you\" into French?\nThought: The user wants to translate a text into French. I can do that.\nFinal Answer: Comment vas-tu?\n\n# Instructions\nUser can only see the Final Answer, all answers must be provided there.\n{{^tools.length}}\nYou must always use the communication structure and instructions defined above. Do not forget that Thought must be a single-line immediately followed by Final Answer.\n{{/tools.length}}\n{{#tools.length}}\nYou must always use the communication structure and instructions defined above. Do not forget that Thought must be a single-line immediately followed by either Function Name or Final Answer.\nYou must use Functions to retrieve factual or historical information to answer the message.\n{{/tools.length}}\nIf the user suggests using a function that is not available, answer that the function is not available. You can suggest alternatives if appropriate.\nWhen the message is unclear or you need more information from the user, ask in Final Answer.\n\n# Your capabilities\nPrefer to use these capabilities over functions.\n- You understand these languages: English, Spanish, French.\n- You can translate, analyze, summarize, even long documents.\n\n# Notes\n- If you don't know the answer, say that you don't know.\n- The current time and date in ISO format can be found in the last message.\n- When answering the user, use friendly formats for time and date.\n- Use markdown syntax for formatting code snippets, links, JSON, tables, images, files.\n- Sometimes, things don't go as planned. Functions may not provide useful information on the first few tries. You should always try a few different approaches before declaring the problem unsolvable.\n- When the function doesn't give you what you were asking for, you must either use another function or a different function input.\n  - When using search engines, you try different formulations of the query, possibly even in a different language.\n- You cannot do complex calculations, computations, or data manipulations without using functions.\n\n# Role\n{{instructions}}`,\n});\n\nexport const ReActAgentAssistantPrompt = new PromptTemplate({\n  schema: z\n    .object({\n      thought: z.array(z.string()),\n      toolName: z.array(z.string()),\n      toolInput: z.array(z.string()),\n      toolOutput: z.array(z.string()),\n      finalAnswer: z.array(z.string()),\n    })\n    .partial(),\n  template: `{{#thought}}Thought: {{.}}\\n{{/thought}}{{#toolName}}Function Name: {{.}}\\n{{/toolName}}{{#toolInput}}Function Input: {{.}}\\n{{/toolInput}}{{#toolOutput}}Function Output: {{.}}\\n{{/toolOutput}}{{#finalAnswer}}Final Answer: {{.}}{{/finalAnswer}}`,\n});\n\nexport const ReActAgentUserPrompt = new PromptTemplate({\n  schema: z\n    .object({\n      input: z.string(),\n      meta: z\n        .object({\n          createdAt: z.string().datetime().optional(),\n        })\n        .passthrough()\n        .optional(),\n    })\n    .passthrough(),\n  functions: {\n    formatMeta: function () {\n      const meta = this.meta as MessageMeta;\n      if (!meta) {\n        return \"\";\n      }\n\n      const parts = [meta.createdAt && `This message was created at ${meta.createdAt}`]\n        .filter(Boolean)\n        .join(\"\\n\");\n\n      return parts ? `\\n\\n${parts}` : parts;\n    },\n  },\n  template: `Message: {{input}}{{formatMeta}}`,\n});\n\nexport const ReActAgentUserEmptyPrompt = new PromptTemplate({\n  schema: z.object({}).passthrough(),\n  template: `Message: Empty message.`,\n});\n\nexport const ReActAgentToolErrorPrompt = new PromptTemplate({\n  schema: z\n    .object({\n      reason: z.string(),\n    })\n    .passthrough(),\n  template: `The function has failed; the error log is shown below. If the function cannot accomplish what you want, use a different function or explain why you can't use it.\n\n{{reason}}`,\n});\n\nexport const ReActAgentToolInputErrorPrompt = new PromptTemplate({\n  schema: z\n    .object({\n      reason: z.string(),\n    })\n    .passthrough(),\n  template: `{{reason}}\n\nHINT: If you're convinced that the input was correct but the function cannot process it then use a different function or say I don't know.`,\n});\n\nexport const ReActAgentToolNoResultsPrompt = new PromptTemplate({\n  schema: z.record(z.any()),\n  template: `No results were found!`,\n});\n\nexport const ReActAgentToolNotFoundPrompt = new PromptTemplate({\n  schema: z\n    .object({\n      tools: z.array(z.object({ name: z.string() }).passthrough()),\n    })\n    .passthrough(),\n  template: `Function does not exist!\n{{#tools.length}}\nUse one of the following functions: {{#trim}}{{#tools}}{{name}},{{/tools}}{{/trim}}\n{{/tools.length}}`,\n});\n\nexport const ReActAgentSchemaErrorPrompt = new PromptTemplate({\n  schema: z.object({}).passthrough(),\n  template: `Error: The generated response does not adhere to the communication structure mentioned in the system prompt.\nYou communicate only in instruction lines. Valid instruction lines are 'Thought' followed by either 'Function Name' + 'Function Input' + 'Function Output' or 'Final Answer'.`,\n});\n"]}
+{"version":3,"sources":["prompts.ts"],"names":["ReActAgentSystemPrompt","PromptTemplate","schema","z","object","instructions","string","default","tools","array","name","min","description","passthrough","createdAt","datetime","nullish","template","ReActAgentAssistantPrompt","thought","toolName","toolInput","toolOutput","finalAnswer","partial","ReActAgentUserPrompt","input","meta","optional","functions","formatMeta","parts","filter","Boolean","join","ReActAgentUserEmptyPrompt","ReActAgentToolErrorPrompt","reason","ReActAgentToolInputErrorPrompt","ReActAgentToolNoResultsPrompt","record","any","ReActAgentToolNotFoundPrompt","ReActAgentSchemaErrorPrompt"],"mappings":"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","file":"prompts.cjs","sourcesContent":["/**\n * Copyright 2025 © BeeAI a Series of LF Projects, LLC\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport { PromptTemplate } from \"@/template.js\";\nimport { z } from \"zod\";\nimport { MessageMeta } from \"@/backend/message.js\";\n\nexport const ReActAgentSystemPrompt = new PromptTemplate({\n  schema: z.object({\n    instructions: z.string().default(\"You are a helpful assistant.\"),\n    tools: z.array(\n      z\n        .object({\n          name: z.string().min(1),\n          description: z.string().min(1),\n          schema: z.string().min(1),\n        })\n        .passthrough(),\n    ),\n    createdAt: z.string().datetime().nullish(),\n  }),\n  template: `# Available functions\n{{#tools.length}}\nYou can only use the following functions. Always use all required parameters.\n\n{{#tools}}\nFunction Name: {{name}}\nDescription: {{description}}\nParameters: {{schema}}\n\n{{/tools}}\n{{/tools.length}}\n{{^tools.length}}\nNo functions are available.\n\n{{/tools.length}}\n# Communication structure\nYou communicate only in instruction lines. The format is: \"Instruction: expected output\\n\". You must only use these instruction lines and must not enter empty lines between them. Each instruction must start on a new line.\n{{#tools.length}}\nYou must skip the instruction lines Function Name, Function Input and Function Output if no function calling is required.\n{{/tools.length}}\n\nMessage: User's message. You never use this instruction line.\n{{^tools.length}}\nThought: A single-line plan of how to answer the user's message, including an explanation of the reasoning behind it. It must be immediately followed by Final Answer.\n{{/tools.length}}\n{{#tools.length}}\nThought: A single-line step-by-step plan of how to answer the user's message, including an explanation of the reasoning behind it. You can use the available functions defined above. This instruction line must be immediately followed by Function Name if one of the available functions defined above needs to be called, or by Final Answer. Do not provide the answer here.\nFunction Name: Name of the function. This instruction line must be immediately followed by Function Input.\nFunction Input: Function parameters. Empty object is a valid parameter.\nFunction Output: Output of the function in JSON format.\nThought: Continue your thinking process.\n{{/tools.length}}\nFinal Answer: Answer the user or ask for more information or clarification. It must always be preceded by Thought.\n\n## Examples\nMessage: Can you translate \"How are you\" into French?\nThought: The user wants to translate a text into French. I can do that.\nFinal Answer: Comment vas-tu?\n\n# Instructions\nUser can only see the Final Answer, all answers must be provided there.\n{{^tools.length}}\nYou must always use the communication structure and instructions defined above. Do not forget that Thought must be a single-line immediately followed by Final Answer.\n{{/tools.length}}\n{{#tools.length}}\nYou must always use the communication structure and instructions defined above. Do not forget that Thought must be a single-line immediately followed by either Function Name or Final Answer.\nYou must use Functions to retrieve factual or historical information to answer the message.\n{{/tools.length}}\nIf the user suggests using a function that is not available, answer that the function is not available. You can suggest alternatives if appropriate.\nWhen the message is unclear or you need more information from the user, ask in Final Answer.\n\n# Your capabilities\nPrefer to use these capabilities over functions.\n- You understand these languages: English, Spanish, French.\n- You can translate, analyze, summarize, even long documents.\n\n# Notes\n- If you don't know the answer, say that you don't know.\n- The current time and date in ISO format can be found in the last message.\n- When answering the user, use friendly formats for time and date.\n- Use markdown syntax for formatting code snippets, links, JSON, tables, images, files.\n- Sometimes, things don't go as planned. Functions may not provide useful information on the first few tries. You should always try a few different approaches before declaring the problem unsolvable.\n- When the function doesn't give you what you were asking for, you must either use another function or a different function input.\n  - When using search engines, you try different formulations of the query, possibly even in a different language.\n- You cannot do complex calculations, computations, or data manipulations without using functions.\n\n# Role\n{{instructions}}`,\n});\n\nexport const ReActAgentAssistantPrompt = new PromptTemplate({\n  schema: z\n    .object({\n      thought: z.array(z.string()),\n      toolName: z.array(z.string()),\n      toolInput: z.array(z.string()),\n      toolOutput: z.array(z.string()),\n      finalAnswer: z.array(z.string()),\n    })\n    .partial(),\n  template: `{{#thought}}Thought: {{.}}\\n{{/thought}}{{#toolName}}Function Name: {{.}}\\n{{/toolName}}{{#toolInput}}Function Input: {{.}}\\n{{/toolInput}}{{#toolOutput}}Function Output: {{.}}\\n{{/toolOutput}}{{#finalAnswer}}Final Answer: {{.}}{{/finalAnswer}}`,\n});\n\nexport const ReActAgentUserPrompt = new PromptTemplate({\n  schema: z\n    .object({\n      input: z.string(),\n      meta: z\n        .object({\n          createdAt: z.string().datetime().optional(),\n        })\n        .passthrough()\n        .optional(),\n    })\n    .passthrough(),\n  functions: {\n    formatMeta: function () {\n      const meta = this.meta as MessageMeta;\n      if (!meta) {\n        return \"\";\n      }\n\n      const parts = [meta.createdAt && `This message was created at ${meta.createdAt}`]\n        .filter(Boolean)\n        .join(\"\\n\");\n\n      return parts ? `\\n\\n${parts}` : parts;\n    },\n  },\n  template: `Message: {{input}}{{formatMeta}}`,\n});\n\nexport const ReActAgentUserEmptyPrompt = new PromptTemplate({\n  schema: z.object({}).passthrough(),\n  template: `Message: Empty message.`,\n});\n\nexport const ReActAgentToolErrorPrompt = new PromptTemplate({\n  schema: z\n    .object({\n      reason: z.string(),\n    })\n    .passthrough(),\n  template: `The function has failed; the error log is shown below. If the function cannot accomplish what you want, use a different function or explain why you can't use it.\n\n{{reason}}`,\n});\n\nexport const ReActAgentToolInputErrorPrompt = new PromptTemplate({\n  schema: z\n    .object({\n      reason: z.string(),\n    })\n    .passthrough(),\n  template: `{{reason}}\n\nHINT: If you're convinced that the input was correct but the function cannot process it then use a different function or say I don't know.`,\n});\n\nexport const ReActAgentToolNoResultsPrompt = new PromptTemplate({\n  schema: z.record(z.any()),\n  template: `No results were found!`,\n});\n\nexport const ReActAgentToolNotFoundPrompt = new PromptTemplate({\n  schema: z\n    .object({\n      tools: z.array(z.object({ name: z.string() }).passthrough()),\n    })\n    .passthrough(),\n  template: `Function does not exist!\n{{#tools.length}}\nUse one of the following functions: {{#trim}}{{#tools}}{{name}},{{/tools}}{{/trim}}\n{{/tools.length}}`,\n});\n\nexport const ReActAgentSchemaErrorPrompt = new PromptTemplate({\n  schema: z.object({}).passthrough(),\n  template: `Error: The generated response does not adhere to the communication structure mentioned in the system prompt.\nYou communicate only in instruction lines. Valid instruction lines are 'Thought' followed by either 'Function Name' + 'Function Input' + 'Function Output' or 'Final Answer'.`,\n});\n"]}

package/dist/agents/react/prompts.d.cts

@@ -7,7 +7,7 @@ import '../../internals/serializable.cjs';
 import 'ajv';
 
 /**
- * Copyright 2025 IBM Corp.
+ * Copyright 2025 © BeeAI a Series of LF Projects, LLC
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
@@ -39,12 +39,12 @@ declare const ReActAgentSystemPrompt: PromptTemplate<z.ZodObject<{
     }, z.ZodTypeAny, "passthrough">>, "many">;
     createdAt: z.ZodOptional<z.ZodNullable<z.ZodString>>;
 }, "strip", z.ZodTypeAny, {
+    instructions: string;
     tools: z.objectOutputType<{
         name: z.ZodString;
         description: z.ZodString;
         schema: z.ZodString;
     }, z.ZodTypeAny, "passthrough">[];
-    instructions: string;
     createdAt?: string | null | undefined;
 }, {
     tools: z.objectInputType<{

package/dist/agents/react/prompts.d.ts

@@ -7,7 +7,7 @@ import '../../internals/serializable.js';
 import 'ajv';
 
 /**
- * Copyright 2025 IBM Corp.
+ * Copyright 2025 © BeeAI a Series of LF Projects, LLC
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
@@ -39,12 +39,12 @@ declare const ReActAgentSystemPrompt: PromptTemplate<z.ZodObject<{
     }, z.ZodTypeAny, "passthrough">>, "many">;
     createdAt: z.ZodOptional<z.ZodNullable<z.ZodString>>;
 }, "strip", z.ZodTypeAny, {
+    instructions: string;
     tools: z.objectOutputType<{
         name: z.ZodString;
         description: z.ZodString;
         schema: z.ZodString;
     }, z.ZodTypeAny, "passthrough">[];
-    instructions: string;
     createdAt?: string | null | undefined;
 }, {
     tools: z.objectInputType<{

package/dist/agents/react/prompts.js.map

@@ -1 +1 @@
-{"version":3,"sources":["prompts.ts"],"names":["ReActAgentSystemPrompt","PromptTemplate","schema","z","object","instructions","string","default","tools","array","name","min","description","passthrough","createdAt","datetime","nullish","template","ReActAgentAssistantPrompt","thought","toolName","toolInput","toolOutput","finalAnswer","partial","ReActAgentUserPrompt","input","meta","optional","functions","formatMeta","parts","filter","Boolean","join","ReActAgentUserEmptyPrompt","ReActAgentToolErrorPrompt","reason","ReActAgentToolInputErrorPrompt","ReActAgentToolNoResultsPrompt","record","any","ReActAgentToolNotFoundPrompt","ReActAgentSchemaErrorPrompt"],"mappings":"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","file":"prompts.js","sourcesContent":["/**\n * Copyright 2025 IBM Corp.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport { PromptTemplate } from \"@/template.js\";\nimport { z } from \"zod\";\nimport { MessageMeta } from \"@/backend/message.js\";\n\nexport const ReActAgentSystemPrompt = new PromptTemplate({\n  schema: z.object({\n    instructions: z.string().default(\"You are a helpful assistant.\"),\n    tools: z.array(\n      z\n        .object({\n          name: z.string().min(1),\n          description: z.string().min(1),\n          schema: z.string().min(1),\n        })\n        .passthrough(),\n    ),\n    createdAt: z.string().datetime().nullish(),\n  }),\n  template: `# Available functions\n{{#tools.length}}\nYou can only use the following functions. Always use all required parameters.\n\n{{#tools}}\nFunction Name: {{name}}\nDescription: {{description}}\nParameters: {{schema}}\n\n{{/tools}}\n{{/tools.length}}\n{{^tools.length}}\nNo functions are available.\n\n{{/tools.length}}\n# Communication structure\nYou communicate only in instruction lines. The format is: \"Instruction: expected output\\n\". You must only use these instruction lines and must not enter empty lines between them. Each instruction must start on a new line.\n{{#tools.length}}\nYou must skip the instruction lines Function Name, Function Input and Function Output if no function calling is required.\n{{/tools.length}}\n\nMessage: User's message. You never use this instruction line.\n{{^tools.length}}\nThought: A single-line plan of how to answer the user's message, including an explanation of the reasoning behind it. It must be immediately followed by Final Answer.\n{{/tools.length}}\n{{#tools.length}}\nThought: A single-line step-by-step plan of how to answer the user's message, including an explanation of the reasoning behind it. You can use the available functions defined above. This instruction line must be immediately followed by Function Name if one of the available functions defined above needs to be called, or by Final Answer. Do not provide the answer here.\nFunction Name: Name of the function. This instruction line must be immediately followed by Function Input.\nFunction Input: Function parameters. Empty object is a valid parameter.\nFunction Output: Output of the function in JSON format.\nThought: Continue your thinking process.\n{{/tools.length}}\nFinal Answer: Answer the user or ask for more information or clarification. It must always be preceded by Thought.\n\n## Examples\nMessage: Can you translate \"How are you\" into French?\nThought: The user wants to translate a text into French. I can do that.\nFinal Answer: Comment vas-tu?\n\n# Instructions\nUser can only see the Final Answer, all answers must be provided there.\n{{^tools.length}}\nYou must always use the communication structure and instructions defined above. Do not forget that Thought must be a single-line immediately followed by Final Answer.\n{{/tools.length}}\n{{#tools.length}}\nYou must always use the communication structure and instructions defined above. Do not forget that Thought must be a single-line immediately followed by either Function Name or Final Answer.\nYou must use Functions to retrieve factual or historical information to answer the message.\n{{/tools.length}}\nIf the user suggests using a function that is not available, answer that the function is not available. You can suggest alternatives if appropriate.\nWhen the message is unclear or you need more information from the user, ask in Final Answer.\n\n# Your capabilities\nPrefer to use these capabilities over functions.\n- You understand these languages: English, Spanish, French.\n- You can translate, analyze, summarize, even long documents.\n\n# Notes\n- If you don't know the answer, say that you don't know.\n- The current time and date in ISO format can be found in the last message.\n- When answering the user, use friendly formats for time and date.\n- Use markdown syntax for formatting code snippets, links, JSON, tables, images, files.\n- Sometimes, things don't go as planned. Functions may not provide useful information on the first few tries. You should always try a few different approaches before declaring the problem unsolvable.\n- When the function doesn't give you what you were asking for, you must either use another function or a different function input.\n  - When using search engines, you try different formulations of the query, possibly even in a different language.\n- You cannot do complex calculations, computations, or data manipulations without using functions.\n\n# Role\n{{instructions}}`,\n});\n\nexport const ReActAgentAssistantPrompt = new PromptTemplate({\n  schema: z\n    .object({\n      thought: z.array(z.string()),\n      toolName: z.array(z.string()),\n      toolInput: z.array(z.string()),\n      toolOutput: z.array(z.string()),\n      finalAnswer: z.array(z.string()),\n    })\n    .partial(),\n  template: `{{#thought}}Thought: {{.}}\\n{{/thought}}{{#toolName}}Function Name: {{.}}\\n{{/toolName}}{{#toolInput}}Function Input: {{.}}\\n{{/toolInput}}{{#toolOutput}}Function Output: {{.}}\\n{{/toolOutput}}{{#finalAnswer}}Final Answer: {{.}}{{/finalAnswer}}`,\n});\n\nexport const ReActAgentUserPrompt = new PromptTemplate({\n  schema: z\n    .object({\n      input: z.string(),\n      meta: z\n        .object({\n          createdAt: z.string().datetime().optional(),\n        })\n        .passthrough()\n        .optional(),\n    })\n    .passthrough(),\n  functions: {\n    formatMeta: function () {\n      const meta = this.meta as MessageMeta;\n      if (!meta) {\n        return \"\";\n      }\n\n      const parts = [meta.createdAt && `This message was created at ${meta.createdAt}`]\n        .filter(Boolean)\n        .join(\"\\n\");\n\n      return parts ? `\\n\\n${parts}` : parts;\n    },\n  },\n  template: `Message: {{input}}{{formatMeta}}`,\n});\n\nexport const ReActAgentUserEmptyPrompt = new PromptTemplate({\n  schema: z.object({}).passthrough(),\n  template: `Message: Empty message.`,\n});\n\nexport const ReActAgentToolErrorPrompt = new PromptTemplate({\n  schema: z\n    .object({\n      reason: z.string(),\n    })\n    .passthrough(),\n  template: `The function has failed; the error log is shown below. If the function cannot accomplish what you want, use a different function or explain why you can't use it.\n\n{{reason}}`,\n});\n\nexport const ReActAgentToolInputErrorPrompt = new PromptTemplate({\n  schema: z\n    .object({\n      reason: z.string(),\n    })\n    .passthrough(),\n  template: `{{reason}}\n\nHINT: If you're convinced that the input was correct but the function cannot process it then use a different function or say I don't know.`,\n});\n\nexport const ReActAgentToolNoResultsPrompt = new PromptTemplate({\n  schema: z.record(z.any()),\n  template: `No results were found!`,\n});\n\nexport const ReActAgentToolNotFoundPrompt = new PromptTemplate({\n  schema: z\n    .object({\n      tools: z.array(z.object({ name: z.string() }).passthrough()),\n    })\n    .passthrough(),\n  template: `Function does not exist!\n{{#tools.length}}\nUse one of the following functions: {{#trim}}{{#tools}}{{name}},{{/tools}}{{/trim}}\n{{/tools.length}}`,\n});\n\nexport const ReActAgentSchemaErrorPrompt = new PromptTemplate({\n  schema: z.object({}).passthrough(),\n  template: `Error: The generated response does not adhere to the communication structure mentioned in the system prompt.\nYou communicate only in instruction lines. Valid instruction lines are 'Thought' followed by either 'Function Name' + 'Function Input' + 'Function Output' or 'Final Answer'.`,\n});\n"]}
+{"version":3,"sources":["prompts.ts"],"names":["ReActAgentSystemPrompt","PromptTemplate","schema","z","object","instructions","string","default","tools","array","name","min","description","passthrough","createdAt","datetime","nullish","template","ReActAgentAssistantPrompt","thought","toolName","toolInput","toolOutput","finalAnswer","partial","ReActAgentUserPrompt","input","meta","optional","functions","formatMeta","parts","filter","Boolean","join","ReActAgentUserEmptyPrompt","ReActAgentToolErrorPrompt","reason","ReActAgentToolInputErrorPrompt","ReActAgentToolNoResultsPrompt","record","any","ReActAgentToolNotFoundPrompt","ReActAgentSchemaErrorPrompt"],"mappings":"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","file":"prompts.js","sourcesContent":["/**\n * Copyright 2025 © BeeAI a Series of LF Projects, LLC\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport { PromptTemplate } from \"@/template.js\";\nimport { z } from \"zod\";\nimport { MessageMeta } from \"@/backend/message.js\";\n\nexport const ReActAgentSystemPrompt = new PromptTemplate({\n  schema: z.object({\n    instructions: z.string().default(\"You are a helpful assistant.\"),\n    tools: z.array(\n      z\n        .object({\n          name: z.string().min(1),\n          description: z.string().min(1),\n          schema: z.string().min(1),\n        })\n        .passthrough(),\n    ),\n    createdAt: z.string().datetime().nullish(),\n  }),\n  template: `# Available functions\n{{#tools.length}}\nYou can only use the following functions. Always use all required parameters.\n\n{{#tools}}\nFunction Name: {{name}}\nDescription: {{description}}\nParameters: {{schema}}\n\n{{/tools}}\n{{/tools.length}}\n{{^tools.length}}\nNo functions are available.\n\n{{/tools.length}}\n# Communication structure\nYou communicate only in instruction lines. The format is: \"Instruction: expected output\\n\". You must only use these instruction lines and must not enter empty lines between them. Each instruction must start on a new line.\n{{#tools.length}}\nYou must skip the instruction lines Function Name, Function Input and Function Output if no function calling is required.\n{{/tools.length}}\n\nMessage: User's message. You never use this instruction line.\n{{^tools.length}}\nThought: A single-line plan of how to answer the user's message, including an explanation of the reasoning behind it. It must be immediately followed by Final Answer.\n{{/tools.length}}\n{{#tools.length}}\nThought: A single-line step-by-step plan of how to answer the user's message, including an explanation of the reasoning behind it. You can use the available functions defined above. This instruction line must be immediately followed by Function Name if one of the available functions defined above needs to be called, or by Final Answer. Do not provide the answer here.\nFunction Name: Name of the function. This instruction line must be immediately followed by Function Input.\nFunction Input: Function parameters. Empty object is a valid parameter.\nFunction Output: Output of the function in JSON format.\nThought: Continue your thinking process.\n{{/tools.length}}\nFinal Answer: Answer the user or ask for more information or clarification. It must always be preceded by Thought.\n\n## Examples\nMessage: Can you translate \"How are you\" into French?\nThought: The user wants to translate a text into French. I can do that.\nFinal Answer: Comment vas-tu?\n\n# Instructions\nUser can only see the Final Answer, all answers must be provided there.\n{{^tools.length}}\nYou must always use the communication structure and instructions defined above. Do not forget that Thought must be a single-line immediately followed by Final Answer.\n{{/tools.length}}\n{{#tools.length}}\nYou must always use the communication structure and instructions defined above. Do not forget that Thought must be a single-line immediately followed by either Function Name or Final Answer.\nYou must use Functions to retrieve factual or historical information to answer the message.\n{{/tools.length}}\nIf the user suggests using a function that is not available, answer that the function is not available. You can suggest alternatives if appropriate.\nWhen the message is unclear or you need more information from the user, ask in Final Answer.\n\n# Your capabilities\nPrefer to use these capabilities over functions.\n- You understand these languages: English, Spanish, French.\n- You can translate, analyze, summarize, even long documents.\n\n# Notes\n- If you don't know the answer, say that you don't know.\n- The current time and date in ISO format can be found in the last message.\n- When answering the user, use friendly formats for time and date.\n- Use markdown syntax for formatting code snippets, links, JSON, tables, images, files.\n- Sometimes, things don't go as planned. Functions may not provide useful information on the first few tries. You should always try a few different approaches before declaring the problem unsolvable.\n- When the function doesn't give you what you were asking for, you must either use another function or a different function input.\n  - When using search engines, you try different formulations of the query, possibly even in a different language.\n- You cannot do complex calculations, computations, or data manipulations without using functions.\n\n# Role\n{{instructions}}`,\n});\n\nexport const ReActAgentAssistantPrompt = new PromptTemplate({\n  schema: z\n    .object({\n      thought: z.array(z.string()),\n      toolName: z.array(z.string()),\n      toolInput: z.array(z.string()),\n      toolOutput: z.array(z.string()),\n      finalAnswer: z.array(z.string()),\n    })\n    .partial(),\n  template: `{{#thought}}Thought: {{.}}\\n{{/thought}}{{#toolName}}Function Name: {{.}}\\n{{/toolName}}{{#toolInput}}Function Input: {{.}}\\n{{/toolInput}}{{#toolOutput}}Function Output: {{.}}\\n{{/toolOutput}}{{#finalAnswer}}Final Answer: {{.}}{{/finalAnswer}}`,\n});\n\nexport const ReActAgentUserPrompt = new PromptTemplate({\n  schema: z\n    .object({\n      input: z.string(),\n      meta: z\n        .object({\n          createdAt: z.string().datetime().optional(),\n        })\n        .passthrough()\n        .optional(),\n    })\n    .passthrough(),\n  functions: {\n    formatMeta: function () {\n      const meta = this.meta as MessageMeta;\n      if (!meta) {\n        return \"\";\n      }\n\n      const parts = [meta.createdAt && `This message was created at ${meta.createdAt}`]\n        .filter(Boolean)\n        .join(\"\\n\");\n\n      return parts ? `\\n\\n${parts}` : parts;\n    },\n  },\n  template: `Message: {{input}}{{formatMeta}}`,\n});\n\nexport const ReActAgentUserEmptyPrompt = new PromptTemplate({\n  schema: z.object({}).passthrough(),\n  template: `Message: Empty message.`,\n});\n\nexport const ReActAgentToolErrorPrompt = new PromptTemplate({\n  schema: z\n    .object({\n      reason: z.string(),\n    })\n    .passthrough(),\n  template: `The function has failed; the error log is shown below. If the function cannot accomplish what you want, use a different function or explain why you can't use it.\n\n{{reason}}`,\n});\n\nexport const ReActAgentToolInputErrorPrompt = new PromptTemplate({\n  schema: z\n    .object({\n      reason: z.string(),\n    })\n    .passthrough(),\n  template: `{{reason}}\n\nHINT: If you're convinced that the input was correct but the function cannot process it then use a different function or say I don't know.`,\n});\n\nexport const ReActAgentToolNoResultsPrompt = new PromptTemplate({\n  schema: z.record(z.any()),\n  template: `No results were found!`,\n});\n\nexport const ReActAgentToolNotFoundPrompt = new PromptTemplate({\n  schema: z\n    .object({\n      tools: z.array(z.object({ name: z.string() }).passthrough()),\n    })\n    .passthrough(),\n  template: `Function does not exist!\n{{#tools.length}}\nUse one of the following functions: {{#trim}}{{#tools}}{{name}},{{/tools}}{{/trim}}\n{{/tools.length}}`,\n});\n\nexport const ReActAgentSchemaErrorPrompt = new PromptTemplate({\n  schema: z.object({}).passthrough(),\n  template: `Error: The generated response does not adhere to the communication structure mentioned in the system prompt.\nYou communicate only in instruction lines. Valid instruction lines are 'Thought' followed by either 'Function Name' + 'Function Input' + 'Function Output' or 'Final Answer'.`,\n});\n"]}

package/dist/agents/react/runners/base.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["base.ts"],"names":["BaseRunner","Serializable","memory","iterations","failedAttemptsCounter","constructor","input","options","run","RetryCounter","execution","totalMaxRetries","AgentError","createIteration","meta","iteration","length","maxIterations","Infinity","isFatal","isRetryable","context","map","state","emitter","child","groupId","llm","signal","push","init","initMemory","templates","overrides","mapObj","defaultTemplates","key","defaultTemplate","override","PromptTemplate","createSnapshot","shallowCopy","loadSnapshot","snapshot","Object","assign","enumerable"],"mappings":"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","file":"base.cjs","sourcesContent":["/**\n * Copyright 2025 IBM Corp.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport { Serializable } from \"@/internals/serializable.js\";\nimport type { ReActAgentTemplates } from \"@/agents/react/types.js\";\nimport {\n  ReActAgentRunIteration,\n  ReActAgentCallbacks,\n  ReActAgentIterationToolResult,\n  ReActAgentMeta,\n  ReActAgentRunInput,\n  ReActAgentRunOptions,\n} from \"@/agents/react/types.js\";\nimport type { ReActAgent, ReActAgentInput } from \"@/agents/react/agent.js\";\nimport { RetryCounter } from \"@/internals/helpers/counter.js\";\nimport { AgentError } from \"@/agents/base.js\";\nimport { shallowCopy } from \"@/serializer/utils.js\";\nimport { BaseMemory } from \"@/memory/base.js\";\nimport { GetRunContext } from \"@/context.js\";\nimport { Emitter } from \"@/emitter/emitter.js\";\nimport { Cache } from \"@/cache/decoratorCache.js\";\nimport { mapObj } from \"@/internals/helpers/object.js\";\nimport { PromptTemplate } from \"@/template.js\";\n\nexport interface ReActAgentRunnerLLMInput {\n  meta: ReActAgentMeta;\n  signal: AbortSignal;\n  emitter: Emitter<ReActAgentCallbacks>;\n}\n\nexport interface ReActAgentRunnerToolInput {\n  state: ReActAgentIterationToolResult;\n  meta: ReActAgentMeta;\n  signal: AbortSignal;\n  emitter: Emitter<ReActAgentCallbacks>;\n}\n\nexport abstract class BaseRunner extends Serializable {\n  public memory!: BaseMemory;\n  public readonly iterations: ReActAgentRunIteration[] = [];\n  protected readonly failedAttemptsCounter: RetryCounter;\n\n  constructor(\n    protected readonly input: ReActAgentInput,\n    protected readonly options: ReActAgentRunOptions,\n    protected readonly run: GetRunContext<ReActAgent>,\n  ) {\n    super();\n    this.failedAttemptsCounter = new RetryCounter(options?.execution?.totalMaxRetries, AgentError);\n  }\n\n  async createIteration() {\n    const meta: ReActAgentMeta = { iteration: this.iterations.length + 1 };\n    const maxIterations = this.options?.execution?.maxIterations ?? Infinity;\n\n    if (meta.iteration > maxIterations) {\n      throw new AgentError(\n        `Agent was not able to resolve the task in ${maxIterations} iterations.`,\n        [],\n        {\n          isFatal: true,\n          isRetryable: false,\n          context: { iterations: this.iterations.map((iteration) => iteration.state) },\n        },\n      );\n    }\n\n    const emitter = this.run.emitter.child({ groupId: `iteration-${meta.iteration}` });\n    const iteration = await this.llm({ emitter, signal: this.run.signal, meta });\n    this.iterations.push(iteration);\n\n    return {\n      emitter,\n      state: iteration.state,\n      meta,\n      signal: this.run.signal,\n    };\n  }\n\n  async init(input: ReActAgentRunInput) {\n    this.memory = await this.initMemory(input);\n  }\n\n  abstract llm(input: ReActAgentRunnerLLMInput): Promise<ReActAgentRunIteration>;\n\n  abstract tool(input: ReActAgentRunnerToolInput): Promise<{ output: string; success: boolean }>;\n\n  public abstract get defaultTemplates(): ReActAgentTemplates;\n\n  @Cache({ enumerable: false })\n  public get templates(): ReActAgentTemplates {\n    const overrides = this.input.templates ?? {};\n\n    return mapObj(this.defaultTemplates)(\n      (key, defaultTemplate: ReActAgentTemplates[typeof key]) => {\n        const override = overrides[key] ?? defaultTemplate;\n        if (override instanceof PromptTemplate) {\n          return override;\n        }\n        return override(defaultTemplate) ?? defaultTemplate;\n      },\n    );\n  }\n\n  protected abstract initMemory(input: ReActAgentRunInput): Promise<BaseMemory>;\n\n  createSnapshot() {\n    return {\n      input: shallowCopy(this.input),\n      options: shallowCopy(this.options),\n      memory: this.memory,\n      failedAttemptsCounter: this.failedAttemptsCounter,\n    };\n  }\n\n  loadSnapshot(snapshot: ReturnType<typeof this.createSnapshot>) {\n    Object.assign(this, snapshot);\n  }\n}\n"]}
+{"version":3,"sources":["base.ts"],"names":["BaseRunner","Serializable","memory","iterations","failedAttemptsCounter","constructor","input","options","run","RetryCounter","execution","totalMaxRetries","AgentError","createIteration","meta","iteration","length","maxIterations","Infinity","isFatal","isRetryable","context","map","state","emitter","child","groupId","llm","signal","push","init","initMemory","templates","overrides","mapObj","defaultTemplates","key","defaultTemplate","override","PromptTemplate","createSnapshot","shallowCopy","loadSnapshot","snapshot","Object","assign","enumerable"],"mappings":"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","file":"base.cjs","sourcesContent":["/**\n * Copyright 2025 © BeeAI a Series of LF Projects, LLC\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport { Serializable } from \"@/internals/serializable.js\";\nimport type { ReActAgentTemplates } from \"@/agents/react/types.js\";\nimport {\n  ReActAgentRunIteration,\n  ReActAgentCallbacks,\n  ReActAgentIterationToolResult,\n  ReActAgentMeta,\n  ReActAgentRunInput,\n  ReActAgentRunOptions,\n} from \"@/agents/react/types.js\";\nimport type { ReActAgent, ReActAgentInput } from \"@/agents/react/agent.js\";\nimport { RetryCounter } from \"@/internals/helpers/counter.js\";\nimport { AgentError } from \"@/agents/base.js\";\nimport { shallowCopy } from \"@/serializer/utils.js\";\nimport { BaseMemory } from \"@/memory/base.js\";\nimport { GetRunContext } from \"@/context.js\";\nimport { Emitter } from \"@/emitter/emitter.js\";\nimport { Cache } from \"@/cache/decoratorCache.js\";\nimport { mapObj } from \"@/internals/helpers/object.js\";\nimport { PromptTemplate } from \"@/template.js\";\n\nexport interface ReActAgentRunnerLLMInput {\n  meta: ReActAgentMeta;\n  signal: AbortSignal;\n  emitter: Emitter<ReActAgentCallbacks>;\n}\n\nexport interface ReActAgentRunnerToolInput {\n  state: ReActAgentIterationToolResult;\n  meta: ReActAgentMeta;\n  signal: AbortSignal;\n  emitter: Emitter<ReActAgentCallbacks>;\n}\n\nexport abstract class BaseRunner extends Serializable {\n  public memory!: BaseMemory;\n  public readonly iterations: ReActAgentRunIteration[] = [];\n  protected readonly failedAttemptsCounter: RetryCounter;\n\n  constructor(\n    protected readonly input: ReActAgentInput,\n    protected readonly options: ReActAgentRunOptions,\n    protected readonly run: GetRunContext<ReActAgent>,\n  ) {\n    super();\n    this.failedAttemptsCounter = new RetryCounter(options?.execution?.totalMaxRetries, AgentError);\n  }\n\n  async createIteration() {\n    const meta: ReActAgentMeta = { iteration: this.iterations.length + 1 };\n    const maxIterations = this.options?.execution?.maxIterations ?? Infinity;\n\n    if (meta.iteration > maxIterations) {\n      throw new AgentError(\n        `Agent was not able to resolve the task in ${maxIterations} iterations.`,\n        [],\n        {\n          isFatal: true,\n          isRetryable: false,\n          context: { iterations: this.iterations.map((iteration) => iteration.state) },\n        },\n      );\n    }\n\n    const emitter = this.run.emitter.child({ groupId: `iteration-${meta.iteration}` });\n    const iteration = await this.llm({ emitter, signal: this.run.signal, meta });\n    this.iterations.push(iteration);\n\n    return {\n      emitter,\n      state: iteration.state,\n      meta,\n      signal: this.run.signal,\n    };\n  }\n\n  async init(input: ReActAgentRunInput) {\n    this.memory = await this.initMemory(input);\n  }\n\n  abstract llm(input: ReActAgentRunnerLLMInput): Promise<ReActAgentRunIteration>;\n\n  abstract tool(input: ReActAgentRunnerToolInput): Promise<{ output: string; success: boolean }>;\n\n  public abstract get defaultTemplates(): ReActAgentTemplates;\n\n  @Cache({ enumerable: false })\n  public get templates(): ReActAgentTemplates {\n    const overrides = this.input.templates ?? {};\n\n    return mapObj(this.defaultTemplates)(\n      (key, defaultTemplate: ReActAgentTemplates[typeof key]) => {\n        const override = overrides[key] ?? defaultTemplate;\n        if (override instanceof PromptTemplate) {\n          return override;\n        }\n        return override(defaultTemplate) ?? defaultTemplate;\n      },\n    );\n  }\n\n  protected abstract initMemory(input: ReActAgentRunInput): Promise<BaseMemory>;\n\n  createSnapshot() {\n    return {\n      input: shallowCopy(this.input),\n      options: shallowCopy(this.options),\n      memory: this.memory,\n      failedAttemptsCounter: this.failedAttemptsCounter,\n    };\n  }\n\n  loadSnapshot(snapshot: ReturnType<typeof this.createSnapshot>) {\n    Object.assign(this, snapshot);\n  }\n}\n"]}

package/dist/agents/react/runners/base.d.cts

@@ -1,11 +1,11 @@
 import '../../../parsers/linePrefix.cjs';
 import '../types.cjs';
 import '../../../internals/serializable.cjs';
-export { B as BaseRunner, b as ReActAgentRunnerLLMInput, c as ReActAgentRunnerToolInput } from '../../../agent-COg8SPbf.cjs';
+export { B as BaseRunner, R as ReActAgentRunnerLLMInput, a as ReActAgentRunnerToolInput } from '../../../agent-2C0Z9iYa.cjs';
 import '../../../internals/helpers/counter.cjs';
 import '../../../memory/base.cjs';
 import '../../../context.cjs';
-import '../../../emitter-BWtGHYn0.cjs';
+import '../../../emitter-BTr99H7I.cjs';
 import '../../../parsers/field.cjs';
 import 'zod';
 import '@streamparser/json';
@@ -25,8 +25,8 @@ import 'zod-to-json-schema';
 import '../../../internals/helpers/promise.cjs';
 import '../prompts.cjs';
 import '../../../template.cjs';
-import '../../../backend/chat.cjs';
-import '../../../backend/utils.cjs';
+import '../../../chat-BvyMdWFo.cjs';
 import '../../../backend/constants.cjs';
-import '@ai-sdk/provider';
-import '../../../base-Csr9guq2.cjs';
+import '../../../logger/logger.cjs';
+import 'pino';
+import '../../../base-BPsHNV2O.cjs';

package/dist/agents/react/runners/base.d.ts

@@ -1,11 +1,11 @@
 import '../../../parsers/linePrefix.js';
 import '../types.js';
 import '../../../internals/serializable.js';
-export { B as BaseRunner, b as ReActAgentRunnerLLMInput, c as ReActAgentRunnerToolInput } from '../../../agent-Dv5YSk8H.js';
+export { B as BaseRunner, R as ReActAgentRunnerLLMInput, a as ReActAgentRunnerToolInput } from '../../../agent-DN_52QhH.js';
 import '../../../internals/helpers/counter.js';
 import '../../../memory/base.js';
 import '../../../context.js';
-import '../../../emitter-l0W9gC1A.js';
+import '../../../emitter-DiGmS_5O.js';
 import '../../../parsers/field.js';
 import 'zod';
 import '@streamparser/json';
@@ -25,8 +25,8 @@ import 'zod-to-json-schema';
 import '../../../internals/helpers/promise.js';
 import '../prompts.js';
 import '../../../template.js';
-import '../../../backend/chat.js';
-import '../../../backend/utils.js';
+import '../../../chat-diSK3Sui.js';
 import '../../../backend/constants.js';
-import '@ai-sdk/provider';
-import '../../../base-DHhpWHQm.js';
+import '../../../logger/logger.js';
+import 'pino';
+import '../../../base-ZnwDK6ZB.js';

package/dist/agents/react/runners/base.js.map

@@ -1 +1 @@
-{"version":3,"sources":["base.ts"],"names":["BaseRunner","Serializable","memory","iterations","failedAttemptsCounter","constructor","input","options","run","RetryCounter","execution","totalMaxRetries","AgentError","createIteration","meta","iteration","length","maxIterations","Infinity","isFatal","isRetryable","context","map","state","emitter","child","groupId","llm","signal","push","init","initMemory","templates","overrides","mapObj","defaultTemplates","key","defaultTemplate","override","PromptTemplate","createSnapshot","shallowCopy","loadSnapshot","snapshot","Object","assign","enumerable"],"mappings":"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","file":"base.js","sourcesContent":["/**\n * Copyright 2025 IBM Corp.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport { Serializable } from \"@/internals/serializable.js\";\nimport type { ReActAgentTemplates } from \"@/agents/react/types.js\";\nimport {\n  ReActAgentRunIteration,\n  ReActAgentCallbacks,\n  ReActAgentIterationToolResult,\n  ReActAgentMeta,\n  ReActAgentRunInput,\n  ReActAgentRunOptions,\n} from \"@/agents/react/types.js\";\nimport type { ReActAgent, ReActAgentInput } from \"@/agents/react/agent.js\";\nimport { RetryCounter } from \"@/internals/helpers/counter.js\";\nimport { AgentError } from \"@/agents/base.js\";\nimport { shallowCopy } from \"@/serializer/utils.js\";\nimport { BaseMemory } from \"@/memory/base.js\";\nimport { GetRunContext } from \"@/context.js\";\nimport { Emitter } from \"@/emitter/emitter.js\";\nimport { Cache } from \"@/cache/decoratorCache.js\";\nimport { mapObj } from \"@/internals/helpers/object.js\";\nimport { PromptTemplate } from \"@/template.js\";\n\nexport interface ReActAgentRunnerLLMInput {\n  meta: ReActAgentMeta;\n  signal: AbortSignal;\n  emitter: Emitter<ReActAgentCallbacks>;\n}\n\nexport interface ReActAgentRunnerToolInput {\n  state: ReActAgentIterationToolResult;\n  meta: ReActAgentMeta;\n  signal: AbortSignal;\n  emitter: Emitter<ReActAgentCallbacks>;\n}\n\nexport abstract class BaseRunner extends Serializable {\n  public memory!: BaseMemory;\n  public readonly iterations: ReActAgentRunIteration[] = [];\n  protected readonly failedAttemptsCounter: RetryCounter;\n\n  constructor(\n    protected readonly input: ReActAgentInput,\n    protected readonly options: ReActAgentRunOptions,\n    protected readonly run: GetRunContext<ReActAgent>,\n  ) {\n    super();\n    this.failedAttemptsCounter = new RetryCounter(options?.execution?.totalMaxRetries, AgentError);\n  }\n\n  async createIteration() {\n    const meta: ReActAgentMeta = { iteration: this.iterations.length + 1 };\n    const maxIterations = this.options?.execution?.maxIterations ?? Infinity;\n\n    if (meta.iteration > maxIterations) {\n      throw new AgentError(\n        `Agent was not able to resolve the task in ${maxIterations} iterations.`,\n        [],\n        {\n          isFatal: true,\n          isRetryable: false,\n          context: { iterations: this.iterations.map((iteration) => iteration.state) },\n        },\n      );\n    }\n\n    const emitter = this.run.emitter.child({ groupId: `iteration-${meta.iteration}` });\n    const iteration = await this.llm({ emitter, signal: this.run.signal, meta });\n    this.iterations.push(iteration);\n\n    return {\n      emitter,\n      state: iteration.state,\n      meta,\n      signal: this.run.signal,\n    };\n  }\n\n  async init(input: ReActAgentRunInput) {\n    this.memory = await this.initMemory(input);\n  }\n\n  abstract llm(input: ReActAgentRunnerLLMInput): Promise<ReActAgentRunIteration>;\n\n  abstract tool(input: ReActAgentRunnerToolInput): Promise<{ output: string; success: boolean }>;\n\n  public abstract get defaultTemplates(): ReActAgentTemplates;\n\n  @Cache({ enumerable: false })\n  public get templates(): ReActAgentTemplates {\n    const overrides = this.input.templates ?? {};\n\n    return mapObj(this.defaultTemplates)(\n      (key, defaultTemplate: ReActAgentTemplates[typeof key]) => {\n        const override = overrides[key] ?? defaultTemplate;\n        if (override instanceof PromptTemplate) {\n          return override;\n        }\n        return override(defaultTemplate) ?? defaultTemplate;\n      },\n    );\n  }\n\n  protected abstract initMemory(input: ReActAgentRunInput): Promise<BaseMemory>;\n\n  createSnapshot() {\n    return {\n      input: shallowCopy(this.input),\n      options: shallowCopy(this.options),\n      memory: this.memory,\n      failedAttemptsCounter: this.failedAttemptsCounter,\n    };\n  }\n\n  loadSnapshot(snapshot: ReturnType<typeof this.createSnapshot>) {\n    Object.assign(this, snapshot);\n  }\n}\n"]}
+{"version":3,"sources":["base.ts"],"names":["BaseRunner","Serializable","memory","iterations","failedAttemptsCounter","constructor","input","options","run","RetryCounter","execution","totalMaxRetries","AgentError","createIteration","meta","iteration","length","maxIterations","Infinity","isFatal","isRetryable","context","map","state","emitter","child","groupId","llm","signal","push","init","initMemory","templates","overrides","mapObj","defaultTemplates","key","defaultTemplate","override","PromptTemplate","createSnapshot","shallowCopy","loadSnapshot","snapshot","Object","assign","enumerable"],"mappings":"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","file":"base.js","sourcesContent":["/**\n * Copyright 2025 © BeeAI a Series of LF Projects, LLC\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport { Serializable } from \"@/internals/serializable.js\";\nimport type { ReActAgentTemplates } from \"@/agents/react/types.js\";\nimport {\n  ReActAgentRunIteration,\n  ReActAgentCallbacks,\n  ReActAgentIterationToolResult,\n  ReActAgentMeta,\n  ReActAgentRunInput,\n  ReActAgentRunOptions,\n} from \"@/agents/react/types.js\";\nimport type { ReActAgent, ReActAgentInput } from \"@/agents/react/agent.js\";\nimport { RetryCounter } from \"@/internals/helpers/counter.js\";\nimport { AgentError } from \"@/agents/base.js\";\nimport { shallowCopy } from \"@/serializer/utils.js\";\nimport { BaseMemory } from \"@/memory/base.js\";\nimport { GetRunContext } from \"@/context.js\";\nimport { Emitter } from \"@/emitter/emitter.js\";\nimport { Cache } from \"@/cache/decoratorCache.js\";\nimport { mapObj } from \"@/internals/helpers/object.js\";\nimport { PromptTemplate } from \"@/template.js\";\n\nexport interface ReActAgentRunnerLLMInput {\n  meta: ReActAgentMeta;\n  signal: AbortSignal;\n  emitter: Emitter<ReActAgentCallbacks>;\n}\n\nexport interface ReActAgentRunnerToolInput {\n  state: ReActAgentIterationToolResult;\n  meta: ReActAgentMeta;\n  signal: AbortSignal;\n  emitter: Emitter<ReActAgentCallbacks>;\n}\n\nexport abstract class BaseRunner extends Serializable {\n  public memory!: BaseMemory;\n  public readonly iterations: ReActAgentRunIteration[] = [];\n  protected readonly failedAttemptsCounter: RetryCounter;\n\n  constructor(\n    protected readonly input: ReActAgentInput,\n    protected readonly options: ReActAgentRunOptions,\n    protected readonly run: GetRunContext<ReActAgent>,\n  ) {\n    super();\n    this.failedAttemptsCounter = new RetryCounter(options?.execution?.totalMaxRetries, AgentError);\n  }\n\n  async createIteration() {\n    const meta: ReActAgentMeta = { iteration: this.iterations.length + 1 };\n    const maxIterations = this.options?.execution?.maxIterations ?? Infinity;\n\n    if (meta.iteration > maxIterations) {\n      throw new AgentError(\n        `Agent was not able to resolve the task in ${maxIterations} iterations.`,\n        [],\n        {\n          isFatal: true,\n          isRetryable: false,\n          context: { iterations: this.iterations.map((iteration) => iteration.state) },\n        },\n      );\n    }\n\n    const emitter = this.run.emitter.child({ groupId: `iteration-${meta.iteration}` });\n    const iteration = await this.llm({ emitter, signal: this.run.signal, meta });\n    this.iterations.push(iteration);\n\n    return {\n      emitter,\n      state: iteration.state,\n      meta,\n      signal: this.run.signal,\n    };\n  }\n\n  async init(input: ReActAgentRunInput) {\n    this.memory = await this.initMemory(input);\n  }\n\n  abstract llm(input: ReActAgentRunnerLLMInput): Promise<ReActAgentRunIteration>;\n\n  abstract tool(input: ReActAgentRunnerToolInput): Promise<{ output: string; success: boolean }>;\n\n  public abstract get defaultTemplates(): ReActAgentTemplates;\n\n  @Cache({ enumerable: false })\n  public get templates(): ReActAgentTemplates {\n    const overrides = this.input.templates ?? {};\n\n    return mapObj(this.defaultTemplates)(\n      (key, defaultTemplate: ReActAgentTemplates[typeof key]) => {\n        const override = overrides[key] ?? defaultTemplate;\n        if (override instanceof PromptTemplate) {\n          return override;\n        }\n        return override(defaultTemplate) ?? defaultTemplate;\n      },\n    );\n  }\n\n  protected abstract initMemory(input: ReActAgentRunInput): Promise<BaseMemory>;\n\n  createSnapshot() {\n    return {\n      input: shallowCopy(this.input),\n      options: shallowCopy(this.options),\n      memory: this.memory,\n      failedAttemptsCounter: this.failedAttemptsCounter,\n    };\n  }\n\n  loadSnapshot(snapshot: ReturnType<typeof this.createSnapshot>) {\n    Object.assign(this, snapshot);\n  }\n}\n"]}