agently 4.0.7.1__py3-none-any.whl → 4.0.7.3__py3-none-any.whl

agently-4.0.7.3.dist-info/METADATA

@@ -0,0 +1,351 @@
+Metadata-Version: 2.4
+Name: agently
+Version: 4.0.7.3
+Summary: 
+License: Apache-2.0
+License-File: LICENSE
+Author: Agently Team
+Author-email: developer@agently.tech
+Requires-Python: >=3.10
+Classifier: License :: OSI Approved :: Apache Software License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Requires-Dist: greenlet (>=3.2.3,<4.0.0)
+Requires-Dist: httpx (>=0.28.1,<0.29.0)
+Requires-Dist: httpx-sse (>=0.4.1,<0.5.0)
+Requires-Dist: json5 (>=0.12.0,<0.13.0)
+Requires-Dist: packaging (>=25.0,<26.0)
+Requires-Dist: pydantic (>=2.11.7,<3.0.0)
+Requires-Dist: pyyaml (>=6.0.2,<7.0.0)
+Requires-Dist: stamina (>=25.1.0,<26.0.0)
+Requires-Dist: toml (>=0.10.2,<0.11.0)
+Description-Content-Type: text/markdown
+
+<img width="640" alt="image" src="https://github.com/user-attachments/assets/c645d031-c8b0-4dba-a515-9d7a4b0a6881" />
+
+# Agently 4 🚀
+
+> **Build production‑grade AI apps faster, with stable outputs and maintainable workflows.**
+
+[English Introduction](https://github.com/AgentEra/Agently/blob/main/README.md) | [中文介绍](https://github.com/AgentEra/Agently/blob/main/README_CN.md)
+
+[![license](https://img.shields.io/badge/license-Apache%202.0-blue.svg)](https://github.com/AgentEra/Agently/blob/main/LICENSE)
+[![PyPI version](https://img.shields.io/pypi/v/agently.svg)](https://pypi.org/project/agently/)
+[![Downloads](https://img.shields.io/pypi/dm/agently.svg)](https://pypistats.org/packages/agently)
+[![GitHub Stars](https://img.shields.io/github/stars/AgentEra/Agently.svg?style=social)](https://github.com/AgentEra/Agently/stargazers)
+[![Twitter Follow](https://img.shields.io/twitter/follow/AgentlyTech?style=social)](https://x.com/AgentlyTech)
+<a href="https://doc.weixin.qq.com/forms/AIoA8gcHAFMAScAhgZQABIlW6tV3l7QQf">
+<img alt="WeChat" src="https://img.shields.io/badge/WeChat%20Group-Join-brightgreen?logo=wechat&style=flat-square">
+</a>
+
+<p align="center">
+  <a href="https://github.com/AgentEra/Agently/discussions"><img src="https://img.shields.io/badge/💬_Community-Join-blueviolet?style=for-the-badge"></a>
+  <a href="https://agently.tech"><img src="https://img.shields.io/badge/🌐_Website-Docs-brightgreen?style=for-the-badge"></a>
+  <a href="https://github.com/AgentEra/Agently/issues"><img src="https://img.shields.io/badge/🐛_Issues-Report-red?style=for-the-badge"></a>
+</p>
+
+---
+
+<p align="center">
+  <b>🔥 <a href="https://agently.tech/docs">Latest Docs</a> | 🚀 <a href="#quickstart">5‑minute Quickstart</a> | 💡 <a href="#-core-features">Core Features</a></b>
+</p>
+
+---
+
+## 📚 Quick Links
+
+- **Docs (EN)**: https://agently.tech/docs
+- **Docs (中文)**: https://agently.cn/docs
+- **Agent Systems Playbook (EN)**: https://agently.tech/docs/en/agent-systems/overview.html
+- **Agent Systems Playbook (中文)**: https://agently.cn/docs/agent-systems/overview.html
+- **Coding Agent Guide (EN)**: https://agently.tech/docs/en/agent-docs.html
+- **Coding Agent Guide (中文)**: https://agently.cn/docs/agent-docs.html
+- **Agent Docs Pack**: https://agently.cn/docs/agent_docs.zip
+
+## 🤔 Why Agently?
+
+Many GenAI POCs fail in production not because models are weak, but because **engineering control is missing**:
+
+| Common challenge | How Agently helps |
+|:--|:--|
+| Output schema drifts, JSON parsing fails | **Contract‑first output control** with `output()` + `ensure_keys` |
+| Workflows get complex and hard to maintain | **TriggerFlow orchestration** with `to` / `if` / `match` / `batch` / `for_each` |
+| Multi‑turn state becomes unstable | **Session & Memo** with memory, summaries, and persistence strategies |
+| Tool calls are hard to audit | **Tool logs** via `extra.tool_logs` |
+| Switching models is expensive | **OpenAICompatible** unified model settings |
+
+**Agently turns LLM uncertainty into a stable, testable, maintainable engineering system.**
+
+## ✨ Core Features
+
+### 1) 📝 Contract‑first Output Control
+Define the structure with `output()`, enforce critical keys with `ensure_keys`.
+
+```python
+result = (
+    agent
+    .input("Analyze user feedback")
+    .output({
+        "sentiment": (str, "positive/neutral/negative"),
+        "key_issues": [(str, "issue summary")],
+        "priority": (int, "1-5, 5 is highest")
+    })
+    .start(ensure_keys=["sentiment", "key_issues[*]"])
+)
+```
+
+### 2) ⚡ Structured Streaming (Instant)
+Consume structured fields as they are generated.
+
+```python
+response = (
+    agent
+    .input("Explain recursion and give 2 tips")
+    .output({"definition": (str, "one sentence"), "tips": [(str, "tip")]})
+    .get_response()
+)
+
+for msg in response.get_generator(type="instant"):
+    if msg.path == "definition" and msg.delta:
+        ui.update_definition(msg.delta)
+    if msg.wildcard_path == "tips[*]" and msg.delta:
+        ui.add_tip(msg.delta)
+```
+
+### 3) 🧩 TriggerFlow Orchestration
+Readable, testable workflows with branching and concurrency.
+
+```python
+(
+    flow.to(handle_request)
+    .if_condition(lambda d: d.value["type"] == "query")
+    .to(handle_query)
+    .elif_condition(lambda d: d.value["type"] == "order")
+    .to(check_inventory)
+    .to(create_order)
+    .end_condition()
+)
+```
+
+### 4) 🧠 Session & Memo (Multi‑turn Memory)
+Quick / Lite / Memo modes with summaries and persistence strategies.
+
+```python
+from agently import Agently
+from agently.core import Session
+
+agent = Agently.create_agent()
+session = Session(agent=agent).configure(
+    mode="memo",
+    limit={"chars": 6000, "messages": 12},
+    every_n_turns=2,
+)
+agent.attach_session(session)
+```
+
+### 5) 🔧 Tool Calls + Logs
+Tool selection and usage are logged in `extra.tool_logs`.
+
+```python
+@agent.tool_func
+def add(a: int, b: int) -> int:
+    return a + b
+
+response = agent.input("12+34=?").use_tool(add).get_response()
+full = response.get_data(type="all")
+print(full["extra"]["tool_logs"])
+```
+
+### 6) 🌐 Unified Model Settings (OpenAICompatible)
+One config for multiple providers and local models.
+
+```python
+from agently import Agently
+
+Agently.set_settings(
+    "OpenAICompatible",
+    {
+        "base_url": "https://api.deepseek.com/v1",
+        "model": "deepseek-chat",
+        "auth": "DEEPSEEK_API_KEY",
+    },
+)
+```
+
+## 🚀 Quickstart
+
+### Install
+
+```bash
+pip install -U agently
+```
+
+*Requirements: Python >= 3.10, recommended Agently >= 4.0.7.2*
+
+### 5‑minute example
+
+**1. Structured output**
+
+```python
+from agently import Agently
+
+agent = Agently.create_agent()
+
+result = (
+    agent.input("Introduce Python in one sentence and list 2 advantages")
+    .output({
+        "introduction": (str, "one sentence"),
+        "advantages": [(str, "advantage")]
+    })
+    .start(ensure_keys=["introduction", "advantages[*]"])
+)
+
+print(result)
+```
+
+**2. Workflow routing**
+
+```python
+from agently import TriggerFlow, TriggerFlowEventData
+
+flow = TriggerFlow()
+
+@flow.chunk
+def classify_intent(data: TriggerFlowEventData):
+    text = data.value
+    if "price" in text:
+        return "price_query"
+    if "feature" in text:
+        return "feature_query"
+    if "buy" in text:
+        return "purchase"
+    return "other"
+
+@flow.chunk
+def handle_price(_: TriggerFlowEventData):
+    return {"response": "Pricing depends on the plan..."}
+
+@flow.chunk
+def handle_feature(_: TriggerFlowEventData):
+    return {"response": "Our product supports..."}
+
+(
+    flow.to(classify_intent)
+    .match()
+    .case("price_query")
+    .to(handle_price)
+    .case("feature_query")
+    .to(handle_feature)
+    .case_else()
+    .to(lambda d: {"response": "What would you like to know?"})
+    .end_match()
+    .end()
+)
+
+print(flow.start("How much does it cost?"))
+```
+
+## ✅ Is Your App Production‑Ready? — Release Readiness Checklist
+
+Based on teams shipping real projects with Agently, this **production readiness checklist** helps reduce common risks before release.
+
+| Area | Check | Recommended Practice |
+| :--- | :--- | :--- |
+| **📝 Output Stability** | Are key interfaces stable? | Define schemas with `output()` and lock critical fields with `ensure_keys`. |
+| **⚡ Real‑time UX** | Need updates while generating? | Consume `type="instant"` structured streaming events. |
+| **🔍 Observability** | Tool calls auditable? | Inspect `extra.tool_logs` for full arguments and results. |
+| **🧩 Workflow Robustness** | Complex flows fully tested? | Unit test each TriggerFlow branch and concurrency limit with expected outputs. |
+| **🧠 Memory & Context** | Multi‑turn experience consistent? | Define Session/Memo summary, trimming, and persistence policies. |
+| **📄 Prompt Management** | Can logic evolve safely? | Version and configure prompts to keep changes traceable. |
+| **🌐 Model Strategy** | Can you switch or downgrade models? | Centralize settings with `OpenAICompatible` for fast provider switching. |
+| **🚀 Performance & Scale** | Can it handle concurrency? | Validate async performance in real web‑service scenarios. |
+| **🧪 Quality Assurance** | Regression tests complete? | Create fixed inputs with expected outputs for core scenarios. |
+
+
+## 📈 Who Uses Agently to Solve Real Problems?
+
+> "Agently helped us turn evaluation rules into executable workflows and keep key scoring accuracy at 75%+, significantly improving bid‑evaluation efficiency." — Project lead at a large energy SOE
+
+> "Agently enabled a closed loop from clarification to query planning to rendering, reaching 90%+ first‑response accuracy and stable production performance." — Data lead at a large energy group
+
+> "Agently’s orchestration and session capabilities let us ship a teaching assistant for course management and Q&A quickly, with continuous iteration." — Project lead at a university teaching‑assistant initiative
+
+**Your project can be next.**  
+📢 [Share your case on GitHub Discussions →](https://github.com/AgentEra/Agently/discussions/categories/show-and-tell)
+## ❓ FAQ
+
+**Q: How is Agently different from LangChain or LlamaIndex?**  
+**A:** Agently is **built for production**. It focuses on stable interfaces (contract‑first outputs), readable/testable orchestration (TriggerFlow), and observable tool calls (`tool_logs`). It’s a better fit for teams that need reliability and maintainability after launch.
+
+**Q: Which models are supported? Is switching expensive?**  
+**A:** With `OpenAICompatible`, you can connect OpenAI, Claude, DeepSeek, Qwen and most OpenAI‑compatible endpoints, plus local models like Llama/Qwen. **The same business code can switch models without rewrites**, reducing vendor lock‑in.
+
+**Q: What’s the learning curve? Where should I start?**  
+**A:** The core API is straightforward—**you can run your first agent in minutes**. Start with [Quickstart](https://agently.tech/docs/en/quickstart.html), then dive into [Output Control](https://agently.tech/docs/en/output-control/overview.html) and [TriggerFlow](https://agently.tech/docs/en/triggerflow/overview.html).
+
+**Q: How do I deploy an Agently‑based service?**  
+**A:** Agently doesn’t lock you into a specific deployment path. It provides async APIs and FastAPI examples. The [FastAPI integration example](https://github.com/AgentEra/Agently/tree/main/examples/step_by_step/13-auto_loop_fastapi) covers SSE, WebSocket, and standard POST.
+
+**Q: Do you offer enterprise support?**  
+**A:** The core framework is open‑source under **Apache 2.0**. For enterprise support, training, or deep collaboration, contact us via the [community](https://doc.weixin.qq.com/forms/AIoA8gcHAFMAScAhgZQABIlW6tV3l7QQf).
+
+
+## 🧭 Docs Guide (Key Paths)
+
+- **Getting Started**
+  - Quickstart: https://agently.tech/docs/en/quickstart.html
+  - Model Settings: https://agently.tech/docs/en/model-settings.html
+  - Coding Agent Guide: https://agently.tech/docs/en/agent-docs.html
+- **Output Control (Structured Output)**
+  - Overview: https://agently.tech/docs/en/output-control/overview.html
+  - Output Format: https://agently.tech/docs/en/output-control/format.html
+  - ensure_keys: https://agently.tech/docs/en/output-control/ensure-keys.html
+  - Instant Streaming: https://agently.tech/docs/en/output-control/instant-streaming.html
+- **Result & Streaming Events**
+  - Result Data: https://agently.tech/docs/en/model-response/result-data.html
+  - Streaming Events: https://agently.tech/docs/en/model-response/streaming.html
+- **Session & Memo**
+  - Overview: https://agently.tech/docs/en/agent-extensions/session-memo/
+  - Quickstart: https://agently.tech/docs/en/agent-extensions/session-memo/quickstart.html
+- **TriggerFlow Orchestration**
+  - Overview: https://agently.tech/docs/en/triggerflow/overview.html
+  - when Branch: https://agently.tech/docs/en/triggerflow/when-branch.html
+  - if / elif / else: https://agently.tech/docs/en/triggerflow/if-branch.html
+  - match / case: https://agently.tech/docs/en/triggerflow/match-branch.html
+  - batch: https://agently.tech/docs/en/triggerflow/batch.html
+  - for_each: https://agently.tech/docs/en/triggerflow/for-each.html
+  - Runtime Stream: https://agently.tech/docs/en/triggerflow/runtime-stream.html
+- **Tools & Extensions**
+  - Tools: https://agently.tech/docs/en/agent-extensions/tools.html
+  - MCP: https://agently.tech/docs/en/agent-extensions/mcp.html
+  - auto_func: https://agently.tech/docs/en/agent-extensions/auto-func.html
+  - KeyWaiter: https://agently.tech/docs/en/agent-extensions/key-waiter.html
+- **Prompt Management**: https://agently.tech/docs/en/prompt-management/overview.html
+- **Async & Settings**: https://agently.tech/docs/en/async-support.html / https://agently.tech/docs/en/settings.html
+- **Playbook**: https://agently.tech/docs/en/agent-systems/overview.html
+
+## 🤝 Community
+
+- Discussions: https://github.com/AgentEra/Agently/discussions
+- Issues: https://github.com/AgentEra/Agently/issues
+- WeChat Group: https://doc.weixin.qq.com/forms/AIoA8gcHAFMAScAhgZQABIlW6tV3l7QQf
+
+## 📄 License
+
+Agently is licensed under [Apache 2.0](LICENSE).
+
+---
+
+<p align="center">
+  <b>Start building your production‑ready AI apps →</b><br>
+  <code>pip install -U agently</code>
+</p>
+
+<p align="center">
+  <sub>Questions? Read the <a href="https://agently.tech/docs">docs</a> or join the <a href="https://doc.weixin.qq.com/forms/AIoA8gcHAFMAScAhgZQABIlW6tV3l7QQf">community</a>.</sub>
+</p>
+

{agently-4.0.7.1.dist-info → agently-4.0.7.3.dist-info}/RECORD

@@ -1,30 +1,34 @@
 agently/__init__.py,sha256=Gf0LL7Czqeuf6hfvHfEGlACLg0d0osQupyMATB0EBlc,884
-agently/_default_init.py,sha256=AhYwzZYOxqDeIoVb8cvPjJ2BjE5V7wxeuH7R-MNZWyg,2057
-agently/_default_settings.yaml,sha256=iyi82glfRk0-7d_n7FvuDjNDxBKGDbeaRA-GfHOW6tE,1387
-agently/base.py,sha256=hc5ayuEQiL8Uus9NVrKFTIjyc73SwRKkdwfLFlNsmKo,5543
+agently/_default_init.py,sha256=3Xjm0qPXgRW9rd7Rz_lo0VxPuI8_qTR7QTizPH8I_4M,2205
+agently/_default_settings.yaml,sha256=D0zVVkC67LfJzK1xGOED_KdOG1iA_4L_4EnYG9919_0,1413
+agently/base.py,sha256=8ZTzwuC9z1tQwh_0a2AMjwIHFg6qyPYPmNdqhXhODdg,5587
 agently/builtins/agent_extensions/AutoFuncExtension.py,sha256=TmwMazwPzb5WXfDqfedY5yZOOMTFIHqaB9Bte29adUc,2433
-agently/builtins/agent_extensions/ChatSessionExtension.py,sha256=Y6mvnsfAY0rykKtfp-tApwJy5O4SS-YEt2-jaWr83uc,12034
+agently/builtins/agent_extensions/ChatSessionExtension.py,sha256=Bbrc9cn3m-uOY0i8EGq1Cvp71nNpEORrrXTiy_JuCCQ,12048
 agently/builtins/agent_extensions/ConfigurePromptExtension.py,sha256=9wy2zHIDVHbUlj5sI0A03SscUWSzZNc9hNJSEdXFXd0,11390
 agently/builtins/agent_extensions/KeyWaiterExtension.py,sha256=Rf8dB8Yt3_9IJifpiE-Rn6lLIXqZjaNp94lnX6Betgw,5555
+agently/builtins/agent_extensions/SessionExtension.py,sha256=WpPyVoM2iwvyjerJuoikilgdI-iH7BBecnzP8UALRDg,12166
 agently/builtins/agent_extensions/ToolExtension.py,sha256=S3jjumHiauEQ-m46Zkh-1I9ih02kKoj8sBEU82woz1E,6886
-agently/builtins/agent_extensions/__init__.py,sha256=IxWRQogF8PCVNXeY7D4qhGukEx3JFvfLlUW2x0FbyfA,852
+agently/builtins/agent_extensions/__init__.py,sha256=rWD8hzJ0ymxxpjxJCdB0x1L5AnhYQnAJUeIAD_MTQ5I,899
 agently/builtins/hookers/ConsoleHooker.py,sha256=aJdDj_nG8CiwyelA505zvtpzBSwD52nFIkBRDJGgq3Y,8099
 agently/builtins/hookers/PureLoggerHooker.py,sha256=fzN0OfhQzgns4KeCNH-qcdm-BdQT0W2kqEmt3Zp2pYI,1906
 agently/builtins/hookers/SystemMessageHooker.py,sha256=1nh1FY70PYyZOAQGfQiGnwIvo4ZF3NSAjeghI3sInn4,7207
 agently/builtins/plugins/ModelRequester/OpenAICompatible.py,sha256=CFTMZHENOi6qsrUfWtgq19P6Ec7H-8vRybVVr4RZfJQ,26773
-agently/builtins/plugins/PromptGenerator/AgentlyPromptGenerator.py,sha256=9iJYOhVh060vpRJrxFF0BkMP3lAmDjgsl_AWM-dRRtE,31583
+agently/builtins/plugins/PromptGenerator/AgentlyPromptGenerator.py,sha256=8zV-c22Wc2s-590u3o2xgL8EVpP-pvUHh6qVIma2gQw,32840
 agently/builtins/plugins/ResponseParser/AgentlyResponseParser.py,sha256=5iF6NLoMjTtEC3hc-DmatFmSWZK2nKkoiyqHK7Q3Yj4,17847
+agently/builtins/plugins/Session/AgentlyMemoSession.py,sha256=2aDTd1unnoOH6urZdcDCjFCirrWaE1ECp-Atoo7yQ6I,25514
 agently/builtins/plugins/ToolManager/AgentlyToolManager.py,sha256=oaqte5LAryZQMD6vuEbKhe6kOLUyZTRZswC1MDFiYxw,9138
 agently/builtins/plugins/__init__.py,sha256=wj4_U9TTekc2CmjppbXKUREDFRXFX1y0ySOW-CxQuok,801
-agently/builtins/tools/Browse.py,sha256=gIePs-gtsqOI_ZTReGqEcoKvhs4FkBzTxow--QS5_ek,3469
-agently/builtins/tools/Search.py,sha256=GtlHppD5RelxMSFDchFD3jdVhaDndh6lZ3Lu9YH0OzM,7393
-agently/builtins/tools/__init__.py,sha256=pFOWgH2C3xRvgQo3UVdkj4yHjF9nNtmoVHmOZfoGsyU,647
-agently/core/Agent.py,sha256=LWkzWG_XXrC4oVkWg4ebnAqAJ81O9UEo1n-qJj7IIrc,10251
+agently/builtins/tools/Browse.py,sha256=HA6XQPiyqMs2ZpvF2Qbex8BDij0GloNzXTbRMtgqbqw,3782
+agently/builtins/tools/Cmd.py,sha256=TkI3r4WdVVcDSkJJnadaPDf7fyQZux3y7vxbAawhPbY,3759
+agently/builtins/tools/Search.py,sha256=JQq3QVkmPOiiWufT6xQNScnjoMB7OhqAy4BP1Fufkbw,8350
+agently/builtins/tools/__init__.py,sha256=YVjJOOGLacn6dhybOlszp2aK2PPc3SRH5L8M8p7t-no,668
+agently/core/Agent.py,sha256=as4AISWRxSNQ4McyK6rZFDz-PkR_eRE0o6ZF3hehjhA,10279
 agently/core/EventCenter.py,sha256=sknU5w9MpGDQgMOF9c5k4PfM4SNT5X_LrpYte2HaFNM,10861
 agently/core/ExtensionHandlers.py,sha256=88iSAW50bgMshB56cTgKg30eOjZQyXiJY1en4w7afWY,2076
-agently/core/ModelRequest.py,sha256=tPuFl_v_P85Mhj669cA5Hi9zAfMNzB5jib8APIXh13s,24630
+agently/core/ModelRequest.py,sha256=hroVb-U-knygXMZ1CCy84pJlP1GHSBNZPI809jEgQak,24350
 agently/core/PluginManager.py,sha256=fwRxvqPMgXYIrclhRHtkaPsyvn6SaeBFqvL7tTzYwck,4410
-agently/core/Prompt.py,sha256=uvGGvbND08b0OhkD-UXY0J65yLedllBt4lMqk4NYl1U,6893
+agently/core/Prompt.py,sha256=vCi_64A-ITiJ-6ZL2PduRdTXoHp8xpKJa2z0ejCJ4uQ,6899
+agently/core/Session.py,sha256=uVofUOVLnDGgMr6Bj6K3dZgap7mLILNcN1fxYTsBx6Y,7063
 agently/core/Tool.py,sha256=PNYf_BwVefr8IOqf5asLaVq2fU7hQaFJwJVj3S4fq84,1871
 agently/core/TriggerFlow/BluePrint.py,sha256=H_TYymWOci-ZvQzqyRxpkHjO77zlzXLukLUUctX4ftM,4887
 agently/core/TriggerFlow/Chunk.py,sha256=xPWr_ofpl-iG4jHIJfB5mPanmn70pq7x8GCcz3G8NPc,1583
@@ -36,29 +40,32 @@ agently/core/TriggerFlow/process/BaseProcess.py,sha256=tBAMCI2Yd8Ylfi5CpkhlSVLH5
 agently/core/TriggerFlow/process/ForEachProcess.py,sha256=DD4frz9mTsKgnPXnHJD53hL6uiiU6h338p7ipud8zMU,4897
 agently/core/TriggerFlow/process/MatchCaseProcess.py,sha256=MKY5Yh66JiMABhCzamRl8UZOBjbD75TFp84Jw6o_t68,7900
 agently/core/TriggerFlow/process/__init__.py,sha256=BP5bAr9LRVVD83KFqXeprgTmXA1iCSOSsD509BtoX_E,753
-agently/core/__init__.py,sha256=CPglSpW5oEEmWpCpdvv9wK4myXmVipjuZm5HtMq6Vxo,1214
-agently/integrations/chromadb.py,sha256=iULT9sK2MIZe5pyqMdL9M1yBkWqQhShwEyLmGnKUuew,10390
+agently/core/__init__.py,sha256=7QJdqGWgmiGvyXVxvRang9eQkbyNAzJu7RissUtzvcw,1243
+agently/integrations/chromadb.py,sha256=oGc-eZRK4pXo5QPbjpC1_RoRzhv2Hqadp80TPEEvw8c,10374
 agently/types/__init__.py,sha256=xb8GMY-ULncO_PY9rfRUsyi12wAQQJx8gAAnoM30uZA,592
-agently/types/data/__init__.py,sha256=qladqSEqcAUW_XzdTDl4cvaraq_DpANy3aZbIPxoygk,1627
+agently/types/data/__init__.py,sha256=ulo2p9SBV-v75zPZWcTczDnAcYO_IlDe3JMGNOZa4vM,1662
 agently/types/data/event.py,sha256=LFQW7MN_QGOis3XV-8K6jNXWsLvT7tYxo4BZbUBCpfI,1790
-agently/types/data/prompt.py,sha256=DiszVM_3OHe66waf-99mBH7bzRr0cpbCHSpDI-2EjPs,5163
+agently/types/data/prompt.py,sha256=QAY7LJcFJKttD79cfp91dEbgstqZNwwer6_8UoTmF4s,5398
 agently/types/data/request.py,sha256=Do-9g5QxZRMYjaoHCZYwHbj28r-t4noAAtOebw764P4,1924
 agently/types/data/response.py,sha256=QYrrZXh_fXsHRltKtd6FKIfmJlgV-stsg6B0AIXueto,3774
 agently/types/data/serializable.py,sha256=v2KlyKNOKp4L6J_Ueupb-gCyrnngvBskFUwNPSJQgnA,844
-agently/types/data/tool.py,sha256=wE8Dda2JtY5cojpHUuQrw7PNeVZ6Zma968bn-pUmS7I,1529
+agently/types/data/tool.py,sha256=KJ1-w3qp_x7uN_wJkIrJWMe_4Y8UopWBRe01QTisRLE,1705
+agently/types/plugins/BuiltInTool.py,sha256=OYBOHTc6VG3YFaYQl_ZlFEUCzoSB5mBIoFN1RaL1JBI,728
 agently/types/plugins/EventHooker.py,sha256=kb80-baVc3fVlrddW5syv9uSD8a2Mcw8Fd3I2HQhY_Y,1030
 agently/types/plugins/ModelRequester.py,sha256=urG1zFX0b4U6ZKSO50IbW5IHK3ydmRgUom7O7Niqk8s,3875
 agently/types/plugins/PromptGenerator.py,sha256=V8kqT0Eeq09AQqfGA-SZ5mNKeit1UrmqlDQCquSMzUU,4752
 agently/types/plugins/ResponseParser.py,sha256=6dCVWz61gaHOxsX9e5sYFqcWRZ5hBnNXAarT0-9uCUY,4566
+agently/types/plugins/Session.py,sha256=WO_V2hW8jWh1bs-cHEIKgLDy6-zj22DjCgFzhdp1VdY,5485
 agently/types/plugins/ToolManager.py,sha256=q1Y3G_tzh1AU3s13H-zTDZIkR4W1mjh9E6AKudFOvyg,2421
-agently/types/plugins/__init__.py,sha256=gz_EpgBQGndIQHY5vJB2YRzAN5yIb3FZZG7pC8lB1lM,848
-agently/types/plugins/base.py,sha256=AoNLwsH5IZBQt7_NZfxMWMhAk6PJSOFHR0IYOXp1imI,1167
+agently/types/plugins/__init__.py,sha256=CtSeuBvC9EiS3uX2FWFLLKBkdP6EAdakO-T7LX9TWII,1361
+agently/types/plugins/base.py,sha256=O3dskXxoc7E1_qd8nTfJr7sP42jbJlPYijXKDX-cM2E,1178
 agently/types/trigger_flow/__init__.py,sha256=Gj31SmWBC4qtrOqQedyGsnCfeSkUf3XvZNFrJ2QbMNw,777
 agently/types/trigger_flow/trigger_flow.py,sha256=6lvhDwizIV5p3h61l1GsmJU_9Tw8v3u-SnHuygkSJdo,3799
-agently/utils/DataFormatter.py,sha256=D45eBlH9CTEs8xNWrDYw9pxUcNnCGVnm0_y97-VyMuU,12346
+agently/utils/AGENT_UTILS_GUIDE.md,sha256=7BKewBgRMOXJKox8u8IE9EjVHWJlAQeVJNuN7cfPzTM,7510
+agently/utils/DataFormatter.py,sha256=hl1VyAiOSKk9nAEa15yCIVD7wWm3c0GQZLtHPFMVlNM,12539
 agently/utils/DataLocator.py,sha256=0TSMONLPYQVvdJftoXcW4BMhwGFl2JrovAGH3LTthn4,8652
 agently/utils/DataPathBuilder.py,sha256=sEzE1i2EWn7NMkCCXDT50gR6_qMzcZ0y0YGkYbXdB3s,10007
-agently/utils/FunctionShifter.py,sha256=quwugTmf-vzHzRR_2wdv14AxLpr0lwxdUtVoX7Jeq48,5839
+agently/utils/FunctionShifter.py,sha256=kf4zBp3dDkb87GaH6YvnL6Smf8p8slPvovfDV4-OQOI,5920
 agently/utils/GeneratorConsumer.py,sha256=EXpz2XGnv6rPdz8bPetJu3LpWIVhMvIi8GLG1Bpe7Ys,7459
 agently/utils/LazyImport.py,sha256=PfXc2iILXb7WVj6UD45_3qInow6z0cvhFlDqxTK-HfY,9120
 agently/utils/Logger.py,sha256=reIj6a7mNtLYDx3brLKEf0I8LbNkhXmL8Yc-DXnnsCU,2967
@@ -70,8 +77,9 @@ agently/utils/Settings.py,sha256=0vWNhVBKZLRKwuIKoXn-tYNZMajMQHLHdqrGhBA2S3Q,585
 agently/utils/Storage.py,sha256=E7QyNJ9T0yOUafPgdP90La698hgLMSGjhJ7qCEHzxxw,9438
 agently/utils/StreamingJSONCompleter.py,sha256=aZ9zuGUTQlP-QKbXHUZCf6EtVuG49MKn8xdhw0VhDEA,4292
 agently/utils/StreamingJSONParser.py,sha256=sPPJOtj5OYvsrukRErcoxRl4yuV1zDuf7pQ_pvw_Zow,21116
-agently/utils/__init__.py,sha256=Uq3uQdk2_OX_m6gF9wAvs4_scC-tsE4EjNTxN_oDagw,1321
-agently-4.0.7.1.dist-info/METADATA,sha256=WY94JMooQ57E-n3mWTDbPcx32-V_NhFI-JyY66gVOpM,7112
-agently-4.0.7.1.dist-info/WHEEL,sha256=zp0Cn7JsFoX2ATtOhtaFYIiE2rmFAD4OcMhtUki8W3U,88
-agently-4.0.7.1.dist-info/licenses/LICENSE,sha256=Y5ZgAdYgMFigPT8dhN18dTLRtBshOSfWhTDRO1t0Cq4,11360
-agently-4.0.7.1.dist-info/RECORD,,
+agently/utils/TimeInfo.py,sha256=lgdeXpTJQOqw0czvrsMcxNeY84wuvCF7kWpY4W8nhDY,750
+agently/utils/__init__.py,sha256=A2EXx-TVU3Ca1s3fMlWM0se0BgI-ZRCXZgl4Hue-lco,1352
+agently-4.0.7.3.dist-info/METADATA,sha256=z3ncC9OPCMAcF9kccQ6pK8rzgVCk4vlJMd-KL4J6AMM,14447
+agently-4.0.7.3.dist-info/WHEEL,sha256=kJCRJT_g0adfAJzTx2GUMmS80rTJIVHRCfG0DQgLq3o,88
+agently-4.0.7.3.dist-info/licenses/LICENSE,sha256=Y5ZgAdYgMFigPT8dhN18dTLRtBshOSfWhTDRO1t0Cq4,11360
+agently-4.0.7.3.dist-info/RECORD,,

{agently-4.0.7.1.dist-info → agently-4.0.7.3.dist-info}/WHEEL

@@ -1,4 +1,4 @@
 Wheel-Version: 1.0
-Generator: poetry-core 2.2.1
+Generator: poetry-core 2.3.1
 Root-Is-Purelib: true
 Tag: py3-none-any

agently-4.0.7.1.dist-info/METADATA

@@ -1,194 +0,0 @@
-Metadata-Version: 2.4
-Name: agently
-Version: 4.0.7.1
-Summary: 
-License: Apache-2.0
-License-File: LICENSE
-Author: Agently Team
-Author-email: developer@agently.tech
-Requires-Python: >=3.10
-Classifier: License :: OSI Approved :: Apache Software License
-Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.10
-Classifier: Programming Language :: Python :: 3.11
-Classifier: Programming Language :: Python :: 3.12
-Classifier: Programming Language :: Python :: 3.13
-Classifier: Programming Language :: Python :: 3.14
-Requires-Dist: greenlet (>=3.2.3,<4.0.0)
-Requires-Dist: httpx (>=0.28.1,<0.29.0)
-Requires-Dist: httpx-sse (>=0.4.1,<0.5.0)
-Requires-Dist: json5 (>=0.12.0,<0.13.0)
-Requires-Dist: packaging (>=25.0,<26.0)
-Requires-Dist: pydantic (>=2.11.7,<3.0.0)
-Requires-Dist: pyyaml (>=6.0.2,<7.0.0)
-Requires-Dist: stamina (>=25.1.0,<26.0.0)
-Requires-Dist: toml (>=0.10.2,<0.11.0)
-Description-Content-Type: text/markdown
-
-<img width="640" alt="image" src="https://github.com/user-attachments/assets/c645d031-c8b0-4dba-a515-9d7a4b0a6881" />
-
-# Agently 4
-
-[English Introduction](https://github.com/AgentEra/Agently/blob/main/README.md) | [中文介绍](https://github.com/AgentEra/Agently/blob/main/README_CN.md)
-
-
-> *Speed Up Your GenAI Application Development*
-
-[![license](https://img.shields.io/badge/license-Apache2.0-blue.svg?style=flat-square)](https://github.com/AgentEra/Agently/blob/main/LICENSE)
-[![PyPI - Downloads](https://img.shields.io/pypi/dm/agently?style=flat-square)](https://pypistats.org/packages/agently)
-[![GitHub star chart](https://img.shields.io/github/stars/agentera/agently?style=flat-square)](https://star-history.com/#agentera/agently)
-[![Twitter](https://img.shields.io/twitter/url/https/twitter.com/AgentlyTech.svg?style=social&label=Follow%20%40AgentlyTech)](https://x.com/AgentlyTech)
-<a href="https://doc.weixin.qq.com/forms/AIoA8gcHAFMAScAhgZQABIlW6tV3l7QQf">
-<img alt="WeChat" src="https://img.shields.io/badge/WeChat%20Group-Apply-brightgreen?logo=wechat&style=flat-square">
-</a>
-
-<p>
-  <a href="https://github.com/AgentEra/Agently/discussions/categories/general">
-    <img alt="Discussions" src="https://img.shields.io/badge/Agently%20General%20Discussions-JOIN-brightgreen.svg?style=for-the-badge" />
-  </a>
-  <a href="https://github.com/AgentEra/Agently/discussions/categories/contribute-to-agently-4">
-    <img alt="Contribute" src="https://img.shields.io/badge/Contribute%20to%20Agently%204%20-Join-blueviolet.svg?style=for-the-badge">
-  </a>
-  <a href="https://github.com/AgentEra/Agently/issues">
-    <img alt="Issues" src="https://img.shields.io/badge/Report%20Issues-Report-red.svg?style=for-the-badge">
-  </a>
-</p>
-
-<hr />
-
-<p align="center">
-    <b><a href = "https://github.com/AgentEra/Agently/discussions">💬 Official Github Discussion Forum</a> - Welcome to Share Anything about Agently with Us</b>
-</p>
-
-<hr />
-
-## Getting Started
-
-Agently is a Python-based framework for building GenAI applications. You can install it via pip and import features using `from agently import Agently`.
-
-Install the latest version via pip:
-
-```shell
-pip install -U agently
-```
-
-> ℹ️ If you're looking for Agently v3's code and documents, please visit branch [`v3-final`](https://github.com/AgentEra/Agently/tree/v3-final)
-
-Clone the repository and install locally:
-
-```shell
-git clone git@github.com:AgentEra/Agently.git
-cd Agently
-pip install -e .
-```
-
-## What is Agently?
-
-Agently aims to provide an intuitive, efficient, and developer-friendly framework for GenAI application development. By deeply understanding the runtime control needs of model outputs, Agently bridges the gap between large language models and real-world applications.
-
-Agently abstracts away the complexities of:
-- Varying model parameters
-- Output formatting
-- Communication between engineering modules and GenAI logic
-
-...while giving developers full control over business logic and integration with existing systems.
-
-We believe GenAI is not a generational replacement for current systems but a powerful extension. Engineers and tools are key to turning GenAI's possibilities into reality.
-
-Our mission is to build the best developer experience (DX) for GenAI application engineers.
-
-## Core Features Overview
-
-### Structured and Streamed Output Control for LLMs
-
-Agently allows you to control and consume model outputs using a developer-centric pattern:
-
-```python
-from agently import Agently
-
-agent = Agently.create_agent()
-
-(
-    agent
-        .input("What time is it now?", always=True)
-        .info({
-            "default_timezone": "",
-            "tool_list": [{
-                "name": "get_current_time",
-                "desc": "Get current time by time zone provided",
-                "kwargs": {
-                    "timezone_str": (str, "time zone string in ZoneInfo()"),
-                },
-            }]
-        })
-        .output({
-            "first_time_response": (str, ),
-            "tool_using_judgement": (bool, ),
-            "tool_using_command": (
-                {
-                    "name": (str, "Decide which tool to use by tool name:{tool_list.[].name}"),
-                    "kwargs": (dict, "According {tool_list.[].args} to output kwargs dictionary"),
-                },
-                "If {tool_using_judgement}==False, just output {}",
-            ),
-        })
-)
-```
-
-Then, consume the model response:
-
-```python
-response = agent.get_response()
-
-# Get raw output
-response_text = response.get_text()
-
-# Get parsed structured result
-response_dict = response.get_result()
-
-# Streamed output
-for delta in response.get_generator(content="delta"):
-    print(delta, end="", flush=True)
-```
-
-Or use the instant parsing mode:
-
-```python
-instant_response_generator = response.get_generator(content="instant")
-
-use_tool = False
-
-for instant_message in instant_response_generator:
-    if instant_message.path == "first_time_response":
-        if instant_message.delta is not None:
-            print(instant_message.delta, end="", flush=True)
-    elif instant_message.path == "tool_using_judgement":
-        use_tool = instant_message.value
-        print()
-        if use_tool:
-            print("[USE TOOL!]")
-        else:
-            print("[NO NEED TO USE TOOL!]")
-    if use_tool:
-        if instant_message.path == "tool_using_command.name" and instant_message.is_complete:
-            print(f"I want to use: '{ instant_message.value }'")
-        elif instant_message.path == "tool_using_command":
-            print(f"call: { instant_message.value }")
-            print(f"kwargs: { instant_message.value }")
-```
-
-```shell
-I can check the current time for you. Please specify a timezone (e.g., 'America/New_York') so I can provide the accurate time.
-[NO NEED TO USE TOOL!]
-```
-
-## [More documentation coming soon...]
-
-## 💬 WeChat Group (Join Us)
-
-> [Click Here to Apply](https://doc.weixin.qq.com/forms/AIoA8gcHAFMAScAhgZQABIlW6tV3l7QQf)
-> or Scan the QR Code Below:
-
-<p align="center">
-  <img width="120" alt="WeChat QR" src="https://github.com/AgentEra/Agently/assets/4413155/7f4bc9bf-a125-4a1e-a0a4-0170b718c1a6">
-</p>