@agentica/core 0.43.2 → 0.44.0-dev.20260313

package/LICENSE

@@ -1,21 +1,21 @@
-MIT License
-
-Copyright (c) 2025 Wrtn Technologies
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+MIT License
+
+Copyright (c) 2025 Wrtn Technologies
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,218 +1,218 @@
-# Agentica, AI Function Calling Framework
-
-![Agentica - ReadMe Diagram](https://github.com/user-attachments/assets/ecd06d51-b818-41c8-ab31-f0e40f48034e)
-
-<!-- Github/NPM Badges -->
-<p align="center">
-  <a href="https://github.com/wrtnlabs/agentica/blob/master/LICENSE"><img src="https://img.shields.io/badge/license-MIT-blue.svg" alt="MIT License"/></a>
-  <a href="https://www.npmjs.com/package/@agentica/core"><img src="https://img.shields.io/npm/v/@agentica/core.svg" alt="NPM Version"/></a>
-  <a href="https://www.npmjs.com/package/@agentica/core"><img src="https://img.shields.io/npm/dm/@agentica/core.svg" alt="NPM Downloads"/></a>
-  <a href="https://dormoshe.io/newsletters/373"><img src="https://img.shields.io/badge/DorMoshe%20Newsletter-Top%20%236%20of%201K-orange?style=flat&logo=rss" alt="Newsletter Top #6"/></a>
- <a href="https://github.com/wrtnlabs/agentica/actions?query=workflow%3Abuild"><img src="https://github.com/wrtnlabs/agentica/workflows/build/badge.svg" alt="Build Status"/></a>
-</p>
-
-<!-- Youtube + Discord -->
-<p align="center">
-  <a href="https://www.youtube.com/@wrtnlabs">
-    <img src="https://img.shields.io/badge/YouTube%20Tutorial-0d1117?style=social&logo=youtube" alt="YouTube"/>
-  </a>
-  &nbsp;
-  <a href="https://discord.gg/aMhRmzkqCx">
-    <img src="https://img.shields.io/badge/Discord-0d1117?style=social&logo=discord" alt="Discord"/>
-  </a>
-</p>
-
-<p align="center">
-  <a href="https://www.bloomberg.com/news/videos/2025-03-31/wtrn-on-series-b-funding-growth-strategy-video">
-    <img src="https://wrtnlabs.io/agentica/images/badges/fund-raising-news-202503.svg" />
-  </a>
-  &nbsp;&nbsp;
-  <a href="https://github.com/wrtnlabs">
-    <img src="https://wrtnlabs.io/agentica/images/badges/open-source-mission.svg" />
-  </a>
-</p>
-
-Agentic AI framework specialized in AI Function Calling.
-
-Don't be afraid of AI agent development. Just list functions from three protocols below. This is everything you should do for AI agent development.
-
-- TypeScript Class
-- Swagger/OpenAPI Document
-- MCP (Model Context Protocol) Server
-
-Wanna make an e-commerce agent? Bring in e-commerce functions. Need a newspaper agent? Get API functions from the newspaper company. Just prepare any functions that you need, then it becomes an AI agent.
-
-Are you a TypeScript developer? Then you're already an AI developer. Familiar with backend development? You're already well-versed in AI development. Anyone who can make functions can make AI agents.
-
-<!-- eslint-skip -->
-
-```typescript
-
-import { Agentica, assertHttpController } from "@agentica/core";
-import OpenAI from "openai";
-import typia from "typia";
-
-import { MobileFileSystem } from "./services/MobileFileSystem";
-
-const agent = new Agentica({
-  vendor: {
-    api: new OpenAI({ apiKey: "********" }),
-    model: "gpt-4o-mini",
-  },
-  controllers: [
-    // functions from TypeScript class
-    typia.llm.controller<MobileFileSystem>(
-      "filesystem",
-      new MobileFileSystem(),
-    ),
-    // functions from Swagger/OpenAPI
-    assertHttpController({
-      name: "shopping",
-      model: "chatgpt",
-      document: await fetch(
-        "https://shopping-be.wrtn.ai/editor/swagger.json",
-      ).then(r => r.json()),
-      connection: {
-        host: "https://shopping-be.wrtn.ai",
-        headers: { Authorization: "Bearer ********" },
-      },
-    }),
-  ],
-});
-await agent.conversate("I wanna buy MacBook Pro");
-
-```
-
-## 📦 Setup
-
-```bash
-$ npx agentica start <directory>
-
-----------------------------------------
- Agentica Setup Wizard
-----------------------------------------
-? Package Manager (use arrow keys)
-  > npm
-    pnpm
-    yarn (berry is not supported)
-? Project Type
-    NodeJS Agent Server
-  > NestJS Agent Server
-    React Client Application
-    Standalone Application
-? Embedded Controllers (multi-selectable)
-    (none)
-    Google Calendar
-    Google News
-  > Github
-    Reddit
-    Slack
-    ...
-```
-
-The setup wizard helps you create a new project tailored to your needs.
-
-For reference, when selecting a project type, any option other than "Standalone Application" will implement the [WebSocket Protocol](https://wrtnlabs.io/agentica/docs/websocket/) for client-server communication.
-
-For comprehensive setup instructions, visit our [Getting Started](https://wrtnlabs.io/agentica/docs/) guide.
-
-## 💻 Playground
-
-Experience Agentica firsthand through our [interactive playground](https://wrtnlabs.io/agentica/playground) before installing.
-
-Our demonstrations showcase the power and simplicity of Agentica's function calling capabilities across different integration methods.
-
-- [TypeScript Class](https://wrtnlabs.io/agentica/playground/bbs)
-- [Swagger/OpenAPI Document](https://wrtnlabs.io/agentica/playground/uploader)
-- [Enterprise E-commerce Agent](https://wrtnlabs.io/agentica/playground/shopping)
-
-![E-commerce Agent Demo](https://github.com/user-attachments/assets/fbfa9f93-304c-4728-933e-deb8ecd7a2af)
-
-<!--
-@todo this section would be changed after making tutorial playground
--->
-
-## 📚 Documentation Resources
-
-Find comprehensive resources at our [official website](https://wrtnlabs.io/agentica).
-
-- [Home](https://wrtnlabs.io/agentica)
-- [Guide Documents](https://wrtnlabs.io/agentica/docs)
-  - [Setup](https://wrtnlabs.io/agentica/docs/setup/cli/)
-  - [Concepts](https://wrtnlabs.io/agentica/docs/concepts/function-calling/)
-  - [Core Library](https://wrtnlabs.io/agentica/docs/core/)
-  - [WebSocket Protocol](https://wrtnlabs.io/agentica/docs/websocket/)
-  - [Plugin Modules](https://wrtnlabs.io/agentica/docs/plugins/benchmark/)
-- [Tutorial](https://wrtnlabs.io/agentica/tutorial)
-  - [Productivity](https://wrtnlabs.io/agentica/tutorial/productivity/arxiv/)
-  - [Coding](https://wrtnlabs.io/agentica/tutorial/coding/file-system/)
-  - [React Native](https://wrtnlabs.io/agentica/tutorial/react-native/sms/)
-  - [Enterprise](https://wrtnlabs.io/agentica/tutorial/enterprise/shopping/)
-- [API Documents](https://wrtnlabs.io/agentica/api)
-- [Youtube](https://www.youtube.com/@wrtnlabs)
-- [Paper](https://wrtnlabs.io/agentica/paper)
-
-https://github.com/user-attachments/assets/2f2a4cdc-6cf1-4304-b82d-04a8ed0be0dd
-
-> Tutorial Videos: https://www.youtube.com/@wrtnlabs
-
-## 🌟 Why Agentica?
-
-```mermaid
-flowchart
-  subgraph "JSON Schema Specification"
-    schemav4("JSON Schema v4 ~ v7") --upgrades--> emended[["OpenAPI v3.1 (emended)"]]
-    schema2910("JSON Schema 2019-03") --upgrades--> emended
-    schema2020("JSON Schema 2020-12") --emends--> emended
-  end
-  subgraph "Agentica"
-    emended --"Artificial Intelligence"--> fc{{"AI Function Calling"}}
-    fc --"OpenAI"--> chatgpt("ChatGPT")
-    fc --"Google"--> gemini("Gemini")
-    fc --"Anthropic"--> claude("Claude")
-    fc --"High-Flyer"--> deepseek("DeepSeek")
-    fc --"Meta"--> llama("Llama")
-    chatgpt --"3.1"--> custom(["Custom JSON Schema"])
-    gemini --"3.0"--> custom(["Custom JSON Schema"])
-    claude --"3.1"--> standard(["Standard JSON Schema"])
-    deepseek --"3.1"--> standard
-    llama --"3.1"--> standard
-  end
-```
-
-Agentica enhances AI function calling by the following strategies:
-
-- [**Compiler Driven Development**](https://wrtnlabs.io/agentica/docs/concepts/compiler-driven-development): constructs function calling schema automatically by compiler skills without hand-writing.
-- [**JSON Schema Conversion**](https://wrtnlabs.io/agentica/docs/core/vendor/#schema-specification): automatically handles specification differences between LLM vendors, ensuring seamless integration regardless of your chosen AI model.
-- [**Validation Feedback**](https://wrtnlabs.io/agentica/docs/concepts/function-calling#validation-feedback): detects and corrects AI mistakes in argument composition, dramatically reducing errors and improving reliability.
-- [**Selector Agent**](https://wrtnlabs.io/agentica/docs/concepts/function-calling#orchestration-strategy): filtering candidate functions to minimize context usage, optimize performance, and reduce token consumption.
-
-Thanks to these innovations, Agentica makes AI function calling easier, safer, and more accurate than before. Development becomes more intuitive since you only need to prepare functions relevant to your specific use case, and scaling your agent's capabilities is as simple as adding or removing functions.
-
-In 2023, when OpenAI announced function calling, many predicted that function calling-driven AI development would become the mainstream. However, in reality, due to the difficulty and instability of function calling, the trend in AI development became agent workflow. Agent workflow, which is inflexible and must be created for specific purposes, has conquered the AI agent ecosystem.
-
-By the way, as Agentica has resolved the difficulty and instability problems of function calling, the time has come to embrace function-driven AI development once again.
-
-| Type        | Workflow      | Vanilla Function Calling | Agentica Function Calling |
-| ----------- | ------------- | ------------------------ | ------------------------- |
-| Purpose     | ❌ Specific   | 🟢 General               | 🟢 General                |
-| Difficulty  | ❌ Difficult  | ❌ Difficult             | 🟢 Easy                   |
-| Stability   | 🟢 Stable     | ❌ Unstable              | 🟢 Stable                 |
-| Flexibility | ❌ Inflexible | 🟢 Flexible              | 🟢 Flexible               |
-
-## 💬 Community & Support
-
-For support, questions, or to provide feedback, join our Discord community:
-
-[![Discord](https://dcbadge.limes.pink/api/server/https://discord.gg/aMhRmzkqCx)](https://discord.gg/aMhRmzkqCx)
-
-## ⚖️ License
-
-Agentica is open-source and available under the [MIT License](https://github.com/wrtnlabs/agentica/blob/master/LICENSE).
-
-<p align="center">
-  <img src="https://github.com/user-attachments/assets/ecd0b82e-bfb7-4eb5-ae97-75be0cb22f10" alt="Wrtn Labs Logo" />
-</p>
-<div align="center">
-  Agentica is maintained by <a href="https://wrtnlabs.io">Wrtn Technologies</a> &mdash; Empowering developers to transform TypeScript functions and OpenAPI specs into powerful AI agents.
-</div>
+# Agentica, AI Function Calling Framework
+
+![Agentica - ReadMe Diagram](https://github.com/user-attachments/assets/ecd06d51-b818-41c8-ab31-f0e40f48034e)
+
+<!-- Github/NPM Badges -->
+<p align="center">
+  <a href="https://github.com/wrtnlabs/agentica/blob/master/LICENSE"><img src="https://img.shields.io/badge/license-MIT-blue.svg" alt="MIT License"/></a>
+  <a href="https://www.npmjs.com/package/@agentica/core"><img src="https://img.shields.io/npm/v/@agentica/core.svg" alt="NPM Version"/></a>
+  <a href="https://www.npmjs.com/package/@agentica/core"><img src="https://img.shields.io/npm/dm/@agentica/core.svg" alt="NPM Downloads"/></a>
+  <a href="https://dormoshe.io/newsletters/373"><img src="https://img.shields.io/badge/DorMoshe%20Newsletter-Top%20%236%20of%201K-orange?style=flat&logo=rss" alt="Newsletter Top #6"/></a>
+ <a href="https://github.com/wrtnlabs/agentica/actions?query=workflow%3Abuild"><img src="https://github.com/wrtnlabs/agentica/workflows/build/badge.svg" alt="Build Status"/></a>
+</p>
+
+<!-- Youtube + Discord -->
+<p align="center">
+  <a href="https://www.youtube.com/@wrtnlabs">
+    <img src="https://img.shields.io/badge/YouTube%20Tutorial-0d1117?style=social&logo=youtube" alt="YouTube"/>
+  </a>
+  &nbsp;
+  <a href="https://discord.gg/aMhRmzkqCx">
+    <img src="https://img.shields.io/badge/Discord-0d1117?style=social&logo=discord" alt="Discord"/>
+  </a>
+</p>
+
+<p align="center">
+  <a href="https://www.bloomberg.com/news/videos/2025-03-31/wtrn-on-series-b-funding-growth-strategy-video">
+    <img src="https://wrtnlabs.io/agentica/images/badges/fund-raising-news-202503.svg" />
+  </a>
+  &nbsp;&nbsp;
+  <a href="https://github.com/wrtnlabs">
+    <img src="https://wrtnlabs.io/agentica/images/badges/open-source-mission.svg" />
+  </a>
+</p>
+
+Agentic AI framework specialized in AI Function Calling.
+
+Don't be afraid of AI agent development. Just list functions from three protocols below. This is everything you should do for AI agent development.
+
+- TypeScript Class
+- Swagger/OpenAPI Document
+- MCP (Model Context Protocol) Server
+
+Wanna make an e-commerce agent? Bring in e-commerce functions. Need a newspaper agent? Get API functions from the newspaper company. Just prepare any functions that you need, then it becomes an AI agent.
+
+Are you a TypeScript developer? Then you're already an AI developer. Familiar with backend development? You're already well-versed in AI development. Anyone who can make functions can make AI agents.
+
+<!-- eslint-skip -->
+
+```typescript
+
+import { Agentica, assertHttpController } from "@agentica/core";
+import OpenAI from "openai";
+import typia from "typia";
+
+import { MobileFileSystem } from "./services/MobileFileSystem";
+
+const agent = new Agentica({
+  vendor: {
+    api: new OpenAI({ apiKey: "********" }),
+    model: "gpt-4o-mini",
+  },
+  controllers: [
+    // functions from TypeScript class
+    typia.llm.controller<MobileFileSystem>(
+      "filesystem",
+      new MobileFileSystem(),
+    ),
+    // functions from Swagger/OpenAPI
+    assertHttpController({
+      name: "shopping",
+      model: "chatgpt",
+      document: await fetch(
+        "https://shopping-be.wrtn.ai/editor/swagger.json",
+      ).then(r => r.json()),
+      connection: {
+        host: "https://shopping-be.wrtn.ai",
+        headers: { Authorization: "Bearer ********" },
+      },
+    }),
+  ],
+});
+await agent.conversate("I wanna buy MacBook Pro");
+
+```
+
+## 📦 Setup
+
+```bash
+$ npx agentica start <directory>
+
+----------------------------------------
+ Agentica Setup Wizard
+----------------------------------------
+? Package Manager (use arrow keys)
+  > npm
+    pnpm
+    yarn (berry is not supported)
+? Project Type
+    NodeJS Agent Server
+  > NestJS Agent Server
+    React Client Application
+    Standalone Application
+? Embedded Controllers (multi-selectable)
+    (none)
+    Google Calendar
+    Google News
+  > Github
+    Reddit
+    Slack
+    ...
+```
+
+The setup wizard helps you create a new project tailored to your needs.
+
+For reference, when selecting a project type, any option other than "Standalone Application" will implement the [WebSocket Protocol](https://wrtnlabs.io/agentica/docs/websocket/) for client-server communication.
+
+For comprehensive setup instructions, visit our [Getting Started](https://wrtnlabs.io/agentica/docs/) guide.
+
+## 💻 Playground
+
+Experience Agentica firsthand through our [interactive playground](https://wrtnlabs.io/agentica/playground) before installing.
+
+Our demonstrations showcase the power and simplicity of Agentica's function calling capabilities across different integration methods.
+
+- [TypeScript Class](https://wrtnlabs.io/agentica/playground/bbs)
+- [Swagger/OpenAPI Document](https://wrtnlabs.io/agentica/playground/uploader)
+- [Enterprise E-commerce Agent](https://wrtnlabs.io/agentica/playground/shopping)
+
+![E-commerce Agent Demo](https://github.com/user-attachments/assets/fbfa9f93-304c-4728-933e-deb8ecd7a2af)
+
+<!--
+@todo this section would be changed after making tutorial playground
+-->
+
+## 📚 Documentation Resources
+
+Find comprehensive resources at our [official website](https://wrtnlabs.io/agentica).
+
+- [Home](https://wrtnlabs.io/agentica)
+- [Guide Documents](https://wrtnlabs.io/agentica/docs)
+  - [Setup](https://wrtnlabs.io/agentica/docs/setup/cli/)
+  - [Concepts](https://wrtnlabs.io/agentica/docs/concepts/function-calling/)
+  - [Core Library](https://wrtnlabs.io/agentica/docs/core/)
+  - [WebSocket Protocol](https://wrtnlabs.io/agentica/docs/websocket/)
+  - [Plugin Modules](https://wrtnlabs.io/agentica/docs/plugins/benchmark/)
+- [Tutorial](https://wrtnlabs.io/agentica/tutorial)
+  - [Productivity](https://wrtnlabs.io/agentica/tutorial/productivity/arxiv/)
+  - [Coding](https://wrtnlabs.io/agentica/tutorial/coding/file-system/)
+  - [React Native](https://wrtnlabs.io/agentica/tutorial/react-native/sms/)
+  - [Enterprise](https://wrtnlabs.io/agentica/tutorial/enterprise/shopping/)
+- [API Documents](https://wrtnlabs.io/agentica/api)
+- [Youtube](https://www.youtube.com/@wrtnlabs)
+- [Paper](https://wrtnlabs.io/agentica/paper)
+
+https://github.com/user-attachments/assets/2f2a4cdc-6cf1-4304-b82d-04a8ed0be0dd
+
+> Tutorial Videos: https://www.youtube.com/@wrtnlabs
+
+## 🌟 Why Agentica?
+
+```mermaid
+flowchart
+  subgraph "JSON Schema Specification"
+    schemav4("JSON Schema v4 ~ v7") --upgrades--> emended[["OpenAPI v3.1 (emended)"]]
+    schema2910("JSON Schema 2019-03") --upgrades--> emended
+    schema2020("JSON Schema 2020-12") --emends--> emended
+  end
+  subgraph "Agentica"
+    emended --"Artificial Intelligence"--> fc{{"AI Function Calling"}}
+    fc --"OpenAI"--> chatgpt("ChatGPT")
+    fc --"Google"--> gemini("Gemini")
+    fc --"Anthropic"--> claude("Claude")
+    fc --"High-Flyer"--> deepseek("DeepSeek")
+    fc --"Meta"--> llama("Llama")
+    chatgpt --"3.1"--> custom(["Custom JSON Schema"])
+    gemini --"3.0"--> custom(["Custom JSON Schema"])
+    claude --"3.1"--> standard(["Standard JSON Schema"])
+    deepseek --"3.1"--> standard
+    llama --"3.1"--> standard
+  end
+```
+
+Agentica enhances AI function calling by the following strategies:
+
+- [**Compiler Driven Development**](https://wrtnlabs.io/agentica/docs/concepts/compiler-driven-development): constructs function calling schema automatically by compiler skills without hand-writing.
+- [**JSON Schema Conversion**](https://wrtnlabs.io/agentica/docs/core/vendor/#schema-specification): automatically handles specification differences between LLM vendors, ensuring seamless integration regardless of your chosen AI model.
+- [**Validation Feedback**](https://wrtnlabs.io/agentica/docs/concepts/function-calling#validation-feedback): detects and corrects AI mistakes in argument composition, dramatically reducing errors and improving reliability.
+- [**Selector Agent**](https://wrtnlabs.io/agentica/docs/concepts/function-calling#orchestration-strategy): filtering candidate functions to minimize context usage, optimize performance, and reduce token consumption.
+
+Thanks to these innovations, Agentica makes AI function calling easier, safer, and more accurate than before. Development becomes more intuitive since you only need to prepare functions relevant to your specific use case, and scaling your agent's capabilities is as simple as adding or removing functions.
+
+In 2023, when OpenAI announced function calling, many predicted that function calling-driven AI development would become the mainstream. However, in reality, due to the difficulty and instability of function calling, the trend in AI development became agent workflow. Agent workflow, which is inflexible and must be created for specific purposes, has conquered the AI agent ecosystem.
+
+By the way, as Agentica has resolved the difficulty and instability problems of function calling, the time has come to embrace function-driven AI development once again.
+
+| Type        | Workflow      | Vanilla Function Calling | Agentica Function Calling |
+| ----------- | ------------- | ------------------------ | ------------------------- |
+| Purpose     | ❌ Specific   | 🟢 General               | 🟢 General                |
+| Difficulty  | ❌ Difficult  | ❌ Difficult             | 🟢 Easy                   |
+| Stability   | 🟢 Stable     | ❌ Unstable              | 🟢 Stable                 |
+| Flexibility | ❌ Inflexible | 🟢 Flexible              | 🟢 Flexible               |
+
+## 💬 Community & Support
+
+For support, questions, or to provide feedback, join our Discord community:
+
+[![Discord](https://dcbadge.limes.pink/api/server/https://discord.gg/aMhRmzkqCx)](https://discord.gg/aMhRmzkqCx)
+
+## ⚖️ License
+
+Agentica is open-source and available under the [MIT License](https://github.com/wrtnlabs/agentica/blob/master/LICENSE).
+
+<p align="center">
+  <img src="https://github.com/user-attachments/assets/ecd0b82e-bfb7-4eb5-ae97-75be0cb22f10" alt="Wrtn Labs Logo" />
+</p>
+<div align="center">
+  Agentica is maintained by <a href="https://wrtnlabs.io">Wrtn Technologies</a> &mdash; Empowering developers to transform TypeScript functions and OpenAPI specs into powerful AI agents.
+</div>

package/lib/constants/AgenticaSystemPrompt.js

@@ -8,7 +8,7 @@ exports.AgenticaSystemPrompt = {
     DESCRIBE: "You are a helpful assistant describing return values of function calls.\n\nAbove messages are the list of function call histories. When describing the return values, please do not too much shortly summarize them. Instead, provide detailed descriptions as much as.\n\nAlso, its content format must be markdown. If required, utilize the mermaid syntax for drawing some diagrams. When image contents are, just put them through the markdown image syntax.\n\nAt last, if user's language locale code is different with your description, please translate it to the user's language.",
     EXECUTE: "# AI Function Calling System Prompt\n\nYou are a function calling assistant specialized in precise JSON schema compliance.\n\n## Core Rules\n\n### 1. Schema Compliance\n\n- Follow the provided JSON schema exactly\n- Never deviate from specified data types, formats, or constraints\n- Include all required properties—no exceptions\n- Only use properties that exist in the schema\n\n### 2. Required Properties\n\nEvery property marked as required MUST be included. Zero tolerance for omissions.\n\n### 3. Null vs Undefined\n\nUse explicit `null` values, not property omission.\n```json\n// Schema: { \"optionalField\": { \"type\": [\"string\", \"null\"] } }\n// ❌ Wrong: { }\n// ✅ Correct: { \"optionalField\": null }\n```\n\n### 4. Const/Enum Values\n\nUse ONLY the exact values defined in the schema. No synonyms, no approximations.\n```json\n// Schema: { \"status\": { \"enum\": [\"pending\", \"approved\", \"rejected\"] } }\n// ❌ Wrong: \"waiting\", \"PENDING\", \"approve\"\n// ✅ Correct: \"pending\"\n```\n\n### 5. Property Descriptions\n\nRead property descriptions carefully. They contain:\n- Purpose and business context\n- Format requirements and examples\n- Validation constraints\n- Relationship context\n\nConstruct values that reflect accurate understanding of the description.\n\n### 6. Discriminator Handling\n\nFor union types with discriminators, always include the discriminator property with the exact value from the mapping.\n```json\n// ✅ Correct\n{\n  \"accountType\": \"user\",\n  \"username\": \"john_doe\"\n}\n\n// ❌ Wrong - missing discriminator\n{ \"username\": \"john_doe\" }\n```\n\n### 7. No Property Invention\n\nNever create properties that don't exist in the schema. The schema is the only source of truth.\n```json\n// Schema defines: { \"name\": {...}, \"age\": {...} }\n// ❌ Wrong: { \"name\": \"John\", \"age\": 25, \"email\": \"...\" }\n// ✅ Correct: { \"name\": \"John\", \"age\": 25 }\n```\n\n---\n\n## Validation Feedback\n\nYour function call is validated after each attempt. If the arguments don't satisfy type constraints, you receive an `IValidation.IFailure` containing the errors. You then correct the arguments and retry.\n\nFollow the `expected` field and `description` field from validation errors exactly.\n\nIn some cases, validation may impose constraints stricter than the schema — for example, available options may have narrowed or items may have been exhausted at runtime. When this happens, validation feedback overrides the schema.\n\n---\n\n## Handling Missing Information\n\nWhen information is insufficient:\n\n1. Identify what's missing\n2. Ask concise, clear questions\n3. Explain why the information is needed\n4. Provide examples when helpful\n\nDon't guess parameter values when you lack sufficient information.\n\n---\n\n## Function Execution\n\nWhen you have all required information, execute the function immediately. No permission seeking, no plan explanation, no confirmation requests.\n\n**Exception**: If the function description explicitly requires user confirmation, follow those instructions.\n\n---\n\n## Process\n\n1. **Analyze** - Parse the schema, identify all requirements\n2. **Validate** - Check if conversation provides all required information\n3. **Construct** - Build arguments matching the schema exactly\n4. **Verify** - Confirm all required properties present, all values schema-compliant\n\n---\n\n## Quality Checklist\n\nBefore making the function call:\n\n- [ ] All required properties included\n- [ ] Every property exists in the schema\n- [ ] Explicit `null` used instead of property omission\n- [ ] Discriminator properties included for union types\n- [ ] All const/enum values exact matches\n- [ ] Values reflect property descriptions\n- [ ] Arguments would pass JSON schema validation\n- [ ] If validation feedback was received, corrections follow its `expected` and `description` fields exactly",
     INITIALIZE: "You are a helpful assistant.\n\nUse the supplied tools to assist the user.",
-    JSON_PARSE_ERROR: "# JSON Parsing Error - Function Call Arguments Invalid\n\n## 🚨 Critical Error: Invalid JSON Format\n\nThe `arguments` field in your function call contains invalid JSON syntax and cannot be parsed.\n\n### Error Message\n\nHere is the `Error.message` occurred from the `JSON.parse()` function:\n\n```\n${{ERROR_MESSAGE}}\n```\n\n### Issue Location:\n- Function call `arguments` field contains malformed JSON\n- The JSON string failed `JSON.parse()` validation\n- Function execution cannot proceed\n\n### Required Action:\n- Review the error message above and determine whether the JSON is recoverable\n- If the syntax error is minor (e.g. trailing comma, missing quote), fix it and retry\n- If the JSON is severely malformed or structurally broken, **discard the previous output entirely** and reconstruct the `arguments` from scratch based on the function's parameter schema\n- Do not attempt to patch heavily corrupted JSON — rebuilding from zero is faster and more reliable\n\n### Common JSON Syntax Requirements:\n- Use double quotes for all keys and string values\n- Remove trailing commas\n- Use lowercase `true`/`false` for booleans\n- Use lowercase `null` for null values\n- Properly escape special characters in strings\n\n**Retry the function call immediately with valid JSON.**",
+    JSON_PARSE_ERROR: "# JSON Parse Failure in Function Call Arguments\n\n## Error Report\n\nThe `arguments` field in your function call contains invalid JSON that could not be fully parsed. Below is the `IJsonParseResult.IFailure` object describing what went wrong.\n\n### Failure Details\n\n- `success`: Always `false` — indicates parsing did not fully succeed.\n- `data`: Partially recovered data from the malformed JSON. May be incomplete or `undefined` if nothing could be salvaged.\n- `input`: The original raw JSON string you produced, preserved for reference.\n- `errors`: List of specific issues found during parsing.\n  - `path`: Dot-notation path from root (`$input`) to the error location (e.g. `$input.user.email`).\n  - `expected`: What the parser expected at that position (e.g. `quoted string`, `\":\"`, `JSON value`).\n  - `description`: Human-readable explanation of what was actually found and what went wrong.\n\n```json\n${{FAILURE}}\n```\n\n## Recovery Instructions\n\n- Review each error above and determine whether the JSON is recoverable.\n- If the syntax error is minor (e.g. trailing comma, missing quote), fix it and retry.\n- If the JSON is severely malformed or structurally broken, **discard the previous output entirely** and reconstruct the `arguments` from scratch based on the function's parameter schema.\n- Do not attempt to patch heavily corrupted JSON — rebuilding from zero is faster and more reliable.\n\n## Common JSON Syntax Requirements\n\n- Use double quotes for all keys and string values.\n- Remove trailing commas.\n- Use lowercase `true`/`false` for booleans and `null` for null values.\n- Properly escape special characters in strings.\n\n**Retry the function call immediately with valid JSON.**",
     SELECT: "You are a helpful assistant for selecting functions to call.\n\nUse the supplied tools to select some functions of `getApiFunctions()` returned.\n\nWhen selecting functions to call, pay attention to the relationship between functions. In particular, check the prerequisites between each function.\n\nIf you can't find any proper function to select, just type your own message. By the way, when typing your own message, please consider the user's language locale code. If your message is different with the user's language, please translate it to the user's.",
     VALIDATE: "# AI Function Calling Corrector Agent\n\nYou analyze validation failures and generate corrected function arguments. You receive `IValidation.IFailure` with detailed error information and produce corrected arguments that achieve 100% compliance.\n\nErrors are presented with inline `❌` comments at the exact location:\n\n```json\n{\n  \"user\": {\n    \"email\": \"invalid\" // ❌ [{\"path\":\"$input.user.email\",\"expected\":\"string & Format<'email'>\"}]\n  }\n}\n```\n\n---\n\n## 1. Validation Error Structure\n\n```typescript\ninterface IValidation.IError {\n  path: string;         // Location: \"$input.user.email\"\n  expected: string;     // Values/types actually valid in current runtime state\n  value: unknown;       // Your value that failed\n  description?: string; // Authoritative instructions — follow exactly when present\n}\n```\n\n| Field | Role | Priority |\n|-------|------|----------|\n| `path` | Exact error location in your input | Use to locate what to fix |\n| `expected` | What is **actually valid right now** — may be stricter than schema | **Overrides schema** |\n| `value` | What you provided (rejected) | Reference only |\n| `description` | Binding instructions: available items, banned types, required actions | **Highest — follow exactly** |\n\n---\n\n## 2. Validation Feedback Overrides Schema\n\nThe JSON schema describes the **general** structure. Validation feedback reflects the **actual runtime state** — a strict subset of what the schema allows. Options get consumed, items get exhausted, domain constraints narrow during orchestration.\n\n```\nValidation feedback > JSON schema — no exceptions\n```\n\n| Situation | Action |\n|-----------|--------|\n| Schema says `string`, but `expected` lists 5 specific values | Use only those 5 values |\n| Schema enum has 8 items, but `expected` shows only 2 | Use only those 2 — the rest are consumed |\n| Schema union includes type `\"X\"`, but feedback says `\"X\"` is banned | NEVER retry `\"X\"` — no parameter variation helps |\n| Feedback says items are already loaded | Stop requesting them — they are in your conversation history |\n\nWhen validation feedback and schema conflict, **always obey validation feedback**.\n\n---\n\n## 3. Correction Strategy\n\n### 3.1 Error Coverage\n\nAddress **every** error in `IValidation.IFailure.errors`. No partial fixes.\n\n### 3.2 Think Beyond Error Boundaries\n\nDon't just fix the exact `path`. Analyze surrounding structure:\n\n1. **Direct fix** — Correct the property at `IError.path`\n2. **Sibling analysis** — Check related properties at the same level\n3. **Parent/child** — Ensure proper nesting and hierarchy\n4. **Cross-schema** — Verify all required properties exist at correct locations\n\n### 3.3 Property Placement Verification\n\nAI systems frequently misplace properties. Detect and correct:\n\n**Elevation error** — Property at parent level instead of nested:\n```json\n// ❌ Wrong\n{ \"user\": { \"name\": \"John\" }, \"email\": \"john@email.com\" }\n\n// ✅ Correct\n{ \"user\": { \"name\": \"John\", \"email\": \"john@email.com\" } }\n```\n\n**Depth error** — Property too deep in structure:\n```json\n// ❌ Wrong\n{ \"order\": { \"items\": [{ \"product\": \"Widget\", \"totalAmount\": 100 }] } }\n\n// ✅ Correct\n{ \"order\": { \"totalAmount\": 100, \"items\": [{ \"product\": \"Widget\" }] } }\n```\n\n**Sibling confusion** — Property in wrong sibling object:\n```json\n// ❌ Wrong\n{ \"billing\": { \"address\": \"123 Main St\", \"phone\": \"555-1234\" }, \"contact\": { \"email\": \"user@email.com\" } }\n\n// ✅ Correct\n{ \"billing\": { \"address\": \"123 Main St\" }, \"contact\": { \"email\": \"user@email.com\", \"phone\": \"555-1234\" } }\n```\n\n---\n\n## 4. Critical Rules\n\n1. **Never add properties that don't exist in the schema.** If you think a property \"should exist for completeness\" — stop and verify.\n\n2. **Every property at its schema-defined location.** If you're grouping by intuition instead of schema — stop and verify.\n\n3. **Use exact enum/const values.** No approximations, no synonyms.\n\n4. **When `description` contains instructions, follow them exactly.** The `description` field carries binding directives about what to do next — it is not optional context.\n\n5. **Never retry a value or type that validation has rejected.** If the type itself is banned or exhausted, no parameter change will make it valid. Choose from the alternatives in `expected`, or follow the `description` field's directive.\n\n---\n\n## 5. Pre-Submission Verification\n\nFor every property you write:\n1. Does this property exist in the schema? → If unsure, verify explicitly.\n2. Is it at the correct hierarchical level? → If unsure, check schema structure.\n3. Does the value comply with `expected` from any prior validation error? → If `expected` is stricter than schema, use `expected`.",
     VALIDATE_REPEATED: "# Recursive Error Pattern Analysis\n\n## Historical Error Input\n\nYou have been provided with `IValidation.IError[][]` containing **previous historical error arrays** from multiple failed correction attempts. Each inner array contains the complete error list from one **previous** correction attempt.\n\n**CRITICAL**: Compare the current validation errors (shown in the validation failure message above) with this historical data to identify recurring patterns.\n\n${{HISTORICAL_ERRORS}}\n\n## Critical Response Protocol\n\n**When error paths recur across current + historical attempts:**\n\n🚨 **NEVER apply the same correction strategy that failed before**\n\n🚨 **Think fundamentally deeper - analyze root architectural causes:**\n\n- Why was the wrong approach chosen repeatedly?\n- What business context was misunderstood?\n- Which schema requirements were overlooked?\n- How should the entire structure be redesigned from first principles?\n\n**For recurring errors, perform complete reconstruction instead of incremental fixes:**\n\n- Analyze the complete business scenario requirements\n- Examine the full schema interface definition in detail\n- Redesign the entire AST structure using proper architectural patterns\n- Enhance with comprehensive business context and realistic data\n\n**Success means: the error path never appears in future correction cycles.**",

package/lib/constants/AgenticaSystemPrompt.js.map

@@ -1 +1 @@
-{"version":3,"file":"AgenticaSystemPrompt.js","sourceRoot":"","sources":["../../src/constants/AgenticaSystemPrompt.ts"],"names":[],"mappings":";;;AAAA,gDAAgD;AACnC,QAAA,oBAAoB,GAAG;IAClC,MAAM,EACJ,mQAAmQ;IACrQ,MAAM,EACJ,scAAsc;IACxc,QAAQ,EACN,+jBAA+jB;IACjkB,OAAO,EACL,uzHAAuzH;IACzzH,UAAU,EACR,4EAA4E;IAC9E,gBAAgB,EACd,ywCAAywC;IAC3wC,MAAM,EACJ,+iBAA+iB;IACjjB,QAAQ,EACN,kvJAAkvJ;IACpvJ,iBAAiB,EACf,61CAA61C;CACh2C,CAAC"}
+{"version":3,"file":"AgenticaSystemPrompt.js","sourceRoot":"","sources":["../../src/constants/AgenticaSystemPrompt.ts"],"names":[],"mappings":";;;AAAA,gDAAgD;AACnC,QAAA,oBAAoB,GAAG;IAClC,MAAM,EACJ,mQAAmQ;IACrQ,MAAM,EACJ,scAAsc;IACxc,QAAQ,EACN,+jBAA+jB;IACjkB,OAAO,EACL,uzHAAuzH;IACzzH,UAAU,EACR,4EAA4E;IAC9E,gBAAgB,EACd,4rDAA4rD;IAC9rD,MAAM,EACJ,+iBAA+iB;IACjjB,QAAQ,EACN,kvJAAkvJ;IACpvJ,iBAAiB,EACf,61CAA61C;CACh2C,CAAC"}

package/lib/context/AgenticaOperation.d.ts

@@ -1,4 +1,5 @@
-import type { IHttpLlmFunction, ILlmFunction, IMcpLlmFunction } from "@samchon/openapi";
+import type { IHttpLlmFunction } from "@typia/interface";
+import type { ILlmFunction } from "typia";
 import type { IAgenticaOperationJson } from "../json/IAgenticaOperationJson";
 import type { IAgenticaController } from "../structures/IAgenticaController";
 /**
@@ -20,7 +21,7 @@ export type AgenticaOperation = AgenticaOperation.Class | AgenticaOperation.Http
 export declare namespace AgenticaOperation {
     export type Class = Base<"class", IAgenticaController.IClass, ILlmFunction>;
     export type Http = Base<"http", IAgenticaController.IHttp, IHttpLlmFunction>;
-    export type Mcp = Base<"mcp", IAgenticaController.IMcp, IMcpLlmFunction>;
+    export type Mcp = Base<"mcp", IAgenticaController.IMcp, ILlmFunction>;
     interface Base<Protocol extends "http" | "class" | "mcp", Controller extends object, Function extends object> {
         /**
          * Protocol discriminator.

package/lib/context/internal/AgenticaOperationComposer.js.map

@@ -1 +1 @@
-{"version":3,"file":"AgenticaOperationComposer.js","sourceRoot":"","sources":["../../../src/context/internal/AgenticaOperationComposer.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"AgenticaOperationComposer.js","sourceRoot":"","sources":["../../../src/context/internal/AgenticaOperationComposer.ts"],"names":[],"mappings":"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"}

package/lib/context/internal/AgenticaTokenUsageAggregator.js.map

@@ -1 +1 @@
-{"version":3,"file":"AgenticaTokenUsageAggregator.js","sourceRoot":"","sources":["../../../src/context/internal/AgenticaTokenUsageAggregator.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"AgenticaTokenUsageAggregator.js","sourceRoot":"","sources":["../../../src/context/internal/AgenticaTokenUsageAggregator.ts"],"names":[],"mappings":"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"}

package/lib/context/internal/__IChatInitialApplication.d.ts

@@ -1,4 +1,4 @@
-import type { IHttpLlmFunction } from "@samchon/openapi";
+import type { IHttpLlmFunction } from "@typia/interface";
 export interface __IChatInitialApplication {
     /**
      * Get list of API functions.

package/lib/errors/AgenticaJsonParseError.d.ts

@@ -1,17 +1,14 @@
+import type { IJsonParseResult } from "typia";
 export declare class AgenticaJsonParseError extends Error {
-    readonly arguments: string;
-    readonly reason: string;
-    constructor(props: AgenticaJsonParseError.IProps);
+    readonly failure: IJsonParseResult.IFailure;
+    constructor(failure: IJsonParseResult.IFailure);
     get name(): "AgenticaJsonParseError";
     toJSON(): AgenticaJsonParseError.IJson;
 }
 export declare namespace AgenticaJsonParseError {
-    interface IProps {
-        arguments: string;
-        reason: string;
-    }
-    interface IJson extends IProps {
+    interface IJson {
         name: "AgenticaJsonParseError";
+        failure: IJsonParseResult.IFailure;
         message: string;
     }
 }