dulus 0.2.60__tar.gz → 3.4.0__tar.gz

{dulus-0.2.60 → dulus-3.4.0}/MANIFEST.in

@@ -1,4 +1,7 @@
+include pyproject.toml
 recursive-include docs *
 recursive-include data *
 recursive-include sandbox/dist *
 recursive-include webbridge *
+global-exclude __pycache__/*
+global-exclude *.pyc

dulus-3.4.0/PKG-INFO

@@ -0,0 +1,167 @@
+Metadata-Version: 2.4
+Name: dulus
+Version: 3.4.0
+Summary: Use IA as an agent without an API key. $0. Harvest your browser session for Gemini (guest, no login), Claude.ai, Claude Code, Kimi.com, Qwen, DeepSeek — drive them like an API, no per-token billing. Plus LiteLLM (100+ paid providers), local models via Ollama, /lang in 34 languages, Mesa Redonda, voice, OCR, MemPalace, embedded sandbox OS.
+Author: KevRojo
+License: GPL-3.0
+Project-URL: Homepage, https://github.com/KevRojo/Dulus
+Project-URL: Repository, https://github.com/KevRojo/Dulus
+Project-URL: Issues, https://github.com/KevRojo/Dulus/issues
+Keywords: ai,cli,llm,claude,gemini,nvidia,openai,kimi,deepseek,qwen,ollama,agent,tts,voice
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: GNU General Public License v3 (GPLv3)
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Classifier: Topic :: Terminals
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+License-File: LICENSE
+License-File: license_manager.py
+Requires-Dist: anthropic>=0.40.0
+Requires-Dist: openai>=1.30.0
+Requires-Dist: httpx>=0.27.0
+Requires-Dist: requests>=2.31.0
+Requires-Dist: rich>=13.0.0
+Requires-Dist: prompt_toolkit>=3.0.0
+Requires-Dist: Flask>=3.1.3
+Requires-Dist: bubblewrap-cli>=1.0.0
+Requires-Dist: customtkinter>=5.2.0
+Requires-Dist: Pillow>=10.0.0
+Requires-Dist: typing-extensions>=4.10.0
+Requires-Dist: composio>=1.0.0rc2
+Requires-Dist: beautifulsoup4>=4.12.0
+Requires-Dist: sentry-sdk>=2.0.0
+Requires-Dist: pytesseract>=0.3.10
+Provides-Extra: memory
+Requires-Dist: mempalace>=3.3.4; extra == "memory"
+Provides-Extra: voice
+Requires-Dist: sounddevice; extra == "voice"
+Requires-Dist: elevenlabs>=1.0.0; extra == "voice"
+Provides-Extra: webbridge
+Requires-Dist: playwright>=1.40.0; extra == "webbridge"
+Provides-Extra: litellm
+Requires-Dist: litellm>=1.50.0; extra == "litellm"
+Provides-Extra: ocr
+Requires-Dist: pytesseract>=0.3.10; extra == "ocr"
+Requires-Dist: Pillow>=10.0.0; extra == "ocr"
+Provides-Extra: ocr-deep
+Requires-Dist: pytesseract>=0.3.10; extra == "ocr-deep"
+Requires-Dist: Pillow>=10.0.0; extra == "ocr-deep"
+Requires-Dist: easyocr>=1.7.0; extra == "ocr-deep"
+Provides-Extra: full
+Requires-Dist: mempalace>=3.3.4; extra == "full"
+Requires-Dist: sounddevice; extra == "full"
+Requires-Dist: elevenlabs>=1.0.0; extra == "full"
+Requires-Dist: playwright>=1.40.0; extra == "full"
+Requires-Dist: litellm>=1.50.0; extra == "full"
+Requires-Dist: pytesseract>=0.3.10; extra == "full"
+Dynamic: license-file
+
+# ▲ DULUS
+>
+> `pip install dulus` → press Enter → working IA in 30 seconds. Try it.
+
+SET /sticky_input ON since the first run for the best experience!
+
+<p align="center">
+  
+  <img width="700" height="665" alt="mascot-hero" src="https://github.com/user-attachments/assets/8b122834-552c-4bd4-b46d-3e17deb74ab5" />
+
+</p>
+
+<p align="center"><i>The Dulus (Cigua Palmera) — Dominican national bird. Named after the bird, not the rocket.</i></p>
+
+<p align="center">
+  <a href="#quick-start"><b>Quick Start</b></a> ·
+  <a href="#models"><b>Models</b></a> ·
+  <a href="#features"><b>Features</b></a> ·
+  <a href="#permissions"><b>Permissions</b></a> ·
+  <a href="#mcp"><b>MCP</b></a> ·
+  <a href="#plugins"><b>Plugins</b></a>
+</p>
+
+<p align="center">
+  <a href="https://pypi.org/project/dulus/"><img src="https://img.shields.io/pypi/v/dulus.svg?style=flat-square&color=ff6b1f&labelColor=07070a&label=pypi" alt="pypi"/></a>
+  <a href="https://pypi.org/project/dulus/"><img src="https://static.pepy.tech/badge/dulus?style=flat-square" alt="downloads"/></a>
+  <img src="https://img.shields.io/badge/python-3.11+-ff6b1f?style=flat-square&labelColor=07070a" alt="python"/>
+  <img src="https://img.shields.io/badge/license-GPLv3-ff6b1f?style=flat-square&labelColor=07070a" alt="license"/>
+  <img src="https://img.shields.io/badge/version-v3.3.3-ff6b1f?style=flat-square&labelColor=07070a" alt="version"/>
+  <img src="https://img.shields.io/badge/providers-100%2B%20via%20LiteLLM-ff6b1f?style=flat-square&labelColor=07070a" alt="providers"/>
+  <img src="https://img.shields.io/badge/tools-30%2B-ff6b1f?style=flat-square&labelColor=07070a" alt="tools"/>
+  <img src="https://img.shields.io/badge/tests-263+-ff6b1f?style=flat-square&labelColor=07070a" alt="tests"/>
+  <a href="https://x.com/KevRojo"><img src="https://img.shields.io/badge/x-%40KevRojo-ff6b1f?style=flat-square&labelColor=07070a&logo=x" alt="x"/></a>
+</p>
+
+<p align="center">
+  🌐 <b>Multilingual</b> ·
+  <a href="docs/README_EN.md">English</a> ·
+  <a href="docs/README_ES.md">Español</a> ·
+  <a href="docs/README_FR.md">Français</a> ·
+  <a href="docs/README_ZH.md">中文</a> ·
+  <a href="docs/README_JA.md">日本語</a> ·
+  <a href="docs/README_KO.md">한국어</a> ·
+  <a href="docs/README_PT.md">Português</a> ·
+  <a href="docs/README_RU.md">Русский</a> ·
+  <a href="docs/README_AR.md">العربية</a>
+</p>
+
+> **Official X / creator handle:** [@KevRojo](https://x.com/KevRojo) — that's me, the only contributor to this repo. Any other account claiming to be Dulus is a copycat.
+>
+> **$DULUS AI token  Solana):** [`9R8rrjXxcfQPmLTCLhmVpjr2uesjjkcgkinE6Lwdpump`](https://dexscreener.com/solana/9R8rrjXxcfQPmLTCLhmVpjr2uesjjkcgkinE6Lwdpump)
+
+-----
+<p align="center">
+  <code>pip install dulus</code>
+</p>
+
+<p align="center"><img src="https://raw.githubusercontent.com/KevRojo/Dulus/main/docs/divider.svg" alt="" width="100%"></p>
+
+<p align="center">
+  <a href="https://dulus.ai/"><b>🌐 Visit the Dulus website →</b></a><br>
+  <sub>The site covers features, demos, and details not documented in this README.</sub>
+</p>
+
+<p align="center"><img src="https://raw.githubusercontent.com/KevRojo/Dulus/main/docs/divider.svg" alt="" width="100%"></p>
+
+## 🔥 What's new
+
+> Full changelog: [`docs/news.md`](docs/news.md)  ·  Inside the REPL: `/news`
+
+- **Dulus Agent — Telegram communities.** Dulus evolved from a CLI tool into a live AI agent inside Telegram groups. The first fully autonomous AI moderating and conversing in real communities — not a bot, not a filter, a real agent. Groups pay in $DULUS to activate him. We host Dulus for them — that's the business model. The CLI stays free forever. This is the paid layer. 🦅🇩🇴
+
+- **v0.2.93 — IA WITHOUT AN API KEY, FIRST-RUN.** 🦅 The welcome wizard now offers, by default, to open Gemini in a browser and capture its **guest session** — no Google login, no API key, no credit card. From `pip install` to working IA in 30 seconds. Same flow works for Claude.ai / Kimi.com / Qwen / DeepSeek if you have those accounts. This was Dulus's ace under the sleeve. Now it's the front door.
+- **v0.2.92** — **`/lang` command.** 34 ISO codes + free-form descriptors. `/lang zh`, `/lang ja`, `/lang pt-br`, `/lang "speak as my gym tutor"`, `/lang "tigre de calle dominicano"`, `/lang "Yoda"`. The model role-plays the voice across the whole session. Triggered after Doubao (China's biggest IA assistant) started referring traffic to the repo.
+- **v0.2.91** — **CORS on the daemon.** The Android Sandbox APK now connects every app live — same daemon, finally cross-origin reachable.
+- **v0.2.89** — **Sandbox embedded INSIDE the desktop GUI.** Click `🦅 Sandbox` in the GUI Web tab → the Dulus OS renders inside the content frame via pywebview subprocess + Win32 `SetParent` reparent. Not a popup. Inside the frame.
+- **v0.2.89** — **Local OCR shipped first-class.** `/ocr` + `ExtractTextFromImage` tool, `WebBridgeScreenshot` auto-OCRs, `/img` sends image + verbatim OCR text together. Zero vision-model tokens for receipts / code screenshots / error stacks.
+- **v0.2.89** — **`kepano/obsidian-skills` bundled.** Dulus writes Obsidian-flavored markdown by default. Open `~/.dulus/memory/` as an Obsidian vault → instant graph view.
+- **v0.2.88** — **LiteLLM gateway: one provider entry, 100+ backends.** OpenRouter, Groq, Together, Bedrock, Vertex, Cohere, Perplexity, xAI, Mistral, Fireworks, Anyscale, Replicate, Azure, DeepInfra — the welcome wizard auto-installs the package and asks for the right per-backend key.
+- **v0.2.85** — **Slim wheel 11.4 MB → 2.5 MB.** Smaller than the original baseline.
+
+<p align="center"><img src="https://raw.githubusercontent.com/KevRojo/Dulus/main/docs/divider.svg" alt="" width="100%"></p>
+
+## What is this
+
+Dulus Reduce your IA costs by 60% parsing webchats and claude-code directly. Write poetry while Anthropic only see text.
+Use claude-code as an API without the new 'extra-usage' wall <3
+
+
+Another reminder of a Dulus magic spell: 
+Wanna get stock prices, history , etc? 
+
+/plugin install yfinance@https://github.com/ranaroussi/yfinance
+
+them:
+/plugin reload
+
+dulus get the prices of NVDA, TSLA, SP500:
+
+Be creative!!! 
+
+Dulus adapt any python repository <3

dulus-3.4.0/README.md

@@ -0,0 +1,102 @@
+# ▲ DULUS
+>
+> `pip install dulus` → press Enter → working IA in 30 seconds. Try it.
+
+SET /sticky_input ON since the first run for the best experience!
+
+<p align="center">
+  
+  <img width="700" height="665" alt="mascot-hero" src="https://github.com/user-attachments/assets/8b122834-552c-4bd4-b46d-3e17deb74ab5" />
+
+</p>
+
+<p align="center"><i>The Dulus (Cigua Palmera) — Dominican national bird. Named after the bird, not the rocket.</i></p>
+
+<p align="center">
+  <a href="#quick-start"><b>Quick Start</b></a> ·
+  <a href="#models"><b>Models</b></a> ·
+  <a href="#features"><b>Features</b></a> ·
+  <a href="#permissions"><b>Permissions</b></a> ·
+  <a href="#mcp"><b>MCP</b></a> ·
+  <a href="#plugins"><b>Plugins</b></a>
+</p>
+
+<p align="center">
+  <a href="https://pypi.org/project/dulus/"><img src="https://img.shields.io/pypi/v/dulus.svg?style=flat-square&color=ff6b1f&labelColor=07070a&label=pypi" alt="pypi"/></a>
+  <a href="https://pypi.org/project/dulus/"><img src="https://static.pepy.tech/badge/dulus?style=flat-square" alt="downloads"/></a>
+  <img src="https://img.shields.io/badge/python-3.11+-ff6b1f?style=flat-square&labelColor=07070a" alt="python"/>
+  <img src="https://img.shields.io/badge/license-GPLv3-ff6b1f?style=flat-square&labelColor=07070a" alt="license"/>
+  <img src="https://img.shields.io/badge/version-v3.3.3-ff6b1f?style=flat-square&labelColor=07070a" alt="version"/>
+  <img src="https://img.shields.io/badge/providers-100%2B%20via%20LiteLLM-ff6b1f?style=flat-square&labelColor=07070a" alt="providers"/>
+  <img src="https://img.shields.io/badge/tools-30%2B-ff6b1f?style=flat-square&labelColor=07070a" alt="tools"/>
+  <img src="https://img.shields.io/badge/tests-263+-ff6b1f?style=flat-square&labelColor=07070a" alt="tests"/>
+  <a href="https://x.com/KevRojo"><img src="https://img.shields.io/badge/x-%40KevRojo-ff6b1f?style=flat-square&labelColor=07070a&logo=x" alt="x"/></a>
+</p>
+
+<p align="center">
+  🌐 <b>Multilingual</b> ·
+  <a href="docs/README_EN.md">English</a> ·
+  <a href="docs/README_ES.md">Español</a> ·
+  <a href="docs/README_FR.md">Français</a> ·
+  <a href="docs/README_ZH.md">中文</a> ·
+  <a href="docs/README_JA.md">日本語</a> ·
+  <a href="docs/README_KO.md">한국어</a> ·
+  <a href="docs/README_PT.md">Português</a> ·
+  <a href="docs/README_RU.md">Русский</a> ·
+  <a href="docs/README_AR.md">العربية</a>
+</p>
+
+> **Official X / creator handle:** [@KevRojo](https://x.com/KevRojo) — that's me, the only contributor to this repo. Any other account claiming to be Dulus is a copycat.
+>
+> **$DULUS AI token  Solana):** [`9R8rrjXxcfQPmLTCLhmVpjr2uesjjkcgkinE6Lwdpump`](https://dexscreener.com/solana/9R8rrjXxcfQPmLTCLhmVpjr2uesjjkcgkinE6Lwdpump)
+
+-----
+<p align="center">
+  <code>pip install dulus</code>
+</p>
+
+<p align="center"><img src="https://raw.githubusercontent.com/KevRojo/Dulus/main/docs/divider.svg" alt="" width="100%"></p>
+
+<p align="center">
+  <a href="https://dulus.ai/"><b>🌐 Visit the Dulus website →</b></a><br>
+  <sub>The site covers features, demos, and details not documented in this README.</sub>
+</p>
+
+<p align="center"><img src="https://raw.githubusercontent.com/KevRojo/Dulus/main/docs/divider.svg" alt="" width="100%"></p>
+
+## 🔥 What's new
+
+> Full changelog: [`docs/news.md`](docs/news.md)  ·  Inside the REPL: `/news`
+
+- **Dulus Agent — Telegram communities.** Dulus evolved from a CLI tool into a live AI agent inside Telegram groups. The first fully autonomous AI moderating and conversing in real communities — not a bot, not a filter, a real agent. Groups pay in $DULUS to activate him. We host Dulus for them — that's the business model. The CLI stays free forever. This is the paid layer. 🦅🇩🇴
+
+- **v0.2.93 — IA WITHOUT AN API KEY, FIRST-RUN.** 🦅 The welcome wizard now offers, by default, to open Gemini in a browser and capture its **guest session** — no Google login, no API key, no credit card. From `pip install` to working IA in 30 seconds. Same flow works for Claude.ai / Kimi.com / Qwen / DeepSeek if you have those accounts. This was Dulus's ace under the sleeve. Now it's the front door.
+- **v0.2.92** — **`/lang` command.** 34 ISO codes + free-form descriptors. `/lang zh`, `/lang ja`, `/lang pt-br`, `/lang "speak as my gym tutor"`, `/lang "tigre de calle dominicano"`, `/lang "Yoda"`. The model role-plays the voice across the whole session. Triggered after Doubao (China's biggest IA assistant) started referring traffic to the repo.
+- **v0.2.91** — **CORS on the daemon.** The Android Sandbox APK now connects every app live — same daemon, finally cross-origin reachable.
+- **v0.2.89** — **Sandbox embedded INSIDE the desktop GUI.** Click `🦅 Sandbox` in the GUI Web tab → the Dulus OS renders inside the content frame via pywebview subprocess + Win32 `SetParent` reparent. Not a popup. Inside the frame.
+- **v0.2.89** — **Local OCR shipped first-class.** `/ocr` + `ExtractTextFromImage` tool, `WebBridgeScreenshot` auto-OCRs, `/img` sends image + verbatim OCR text together. Zero vision-model tokens for receipts / code screenshots / error stacks.
+- **v0.2.89** — **`kepano/obsidian-skills` bundled.** Dulus writes Obsidian-flavored markdown by default. Open `~/.dulus/memory/` as an Obsidian vault → instant graph view.
+- **v0.2.88** — **LiteLLM gateway: one provider entry, 100+ backends.** OpenRouter, Groq, Together, Bedrock, Vertex, Cohere, Perplexity, xAI, Mistral, Fireworks, Anyscale, Replicate, Azure, DeepInfra — the welcome wizard auto-installs the package and asks for the right per-backend key.
+- **v0.2.85** — **Slim wheel 11.4 MB → 2.5 MB.** Smaller than the original baseline.
+
+<p align="center"><img src="https://raw.githubusercontent.com/KevRojo/Dulus/main/docs/divider.svg" alt="" width="100%"></p>
+
+## What is this
+
+Dulus Reduce your IA costs by 60% parsing webchats and claude-code directly. Write poetry while Anthropic only see text.
+Use claude-code as an API without the new 'extra-usage' wall <3
+
+
+Another reminder of a Dulus magic spell: 
+Wanna get stock prices, history , etc? 
+
+/plugin install yfinance@https://github.com/ranaroussi/yfinance
+
+them:
+/plugin reload
+
+dulus get the prices of NVDA, TSLA, SP500:
+
+Be creative!!! 
+
+Dulus adapt any python repository <3

{dulus-0.2.60 → dulus-3.4.0}/agent.py

@@ -15,6 +15,7 @@ from tools import execute_tool
 import tools as _tools_init  # ensure built-in tools are registered on import
 from providers import stream, AssistantTurn, TextChunk, ThinkingChunk, detect_provider
 from compaction import maybe_compact
+import governance
 
 _SENTINEL = object()
 
@@ -116,6 +117,12 @@ def run(
     pending_img = config.pop("_pending_image", None)
     if pending_img:
         user_msg["images"] = [pending_img]
+    # Attach pending video from /video command (Kimi K2.5/K2.6 only — the
+    # provider layer drops it for non-multimodal models). Item may be a bare
+    # base64 string or {"data": b64, "mime": "video/mp4"}.
+    pending_vid = config.pop("_pending_video", None)
+    if pending_vid:
+        user_msg["videos"] = [pending_vid]
     
     initial_msg_count = len(state.messages)
     state.messages.append(user_msg)
@@ -123,6 +130,12 @@ def run(
     # Inject runtime metadata into config so tools (e.g. Agent) can access it
     config.update({"_depth": depth, "_system_prompt": system_prompt})
 
+    # Governance layer (opt-in via config["governance"]). Built once per session
+    # and cached so the budget/ledger persists across turns. None when disabled.
+    if "_governance_obj" not in config:
+        config["_governance_obj"] = governance.from_config(config)
+    _gov = config["_governance_obj"]
+
     while True:
         if cancel_check and cancel_check():
             return
@@ -184,6 +197,21 @@ def run(
             cache_creation_tokens=c_create,
         )
 
+        # Charge the token budget. On warn → notify; on first hard breach →
+        # fire on_breach and stop the loop gracefully (protects the wallet).
+        if _gov is not None and _gov.ledger is not None:
+            cr = _gov.ledger.charge("tokens", assistant_turn.in_tokens + assistant_turn.out_tokens)
+            if cr.warned and _gov.hooks:
+                _gov.hooks.fire("on_breach", kind="warn", dim=cr.dim, used=cr.used, granted=cr.granted)
+            if cr.first_breach:
+                if _gov.hooks:
+                    _gov.hooks.fire("on_breach", kind="hard", dim=cr.dim, used=cr.used, granted=cr.granted)
+                yield TextChunk(
+                    f"\n[governance] token budget reached ({cr.used}/{cr.granted}). "
+                    "Stopping this run.\n"
+                )
+                break
+
         if not assistant_turn.tool_calls:
             break   # No tools → conversation turn complete
 
@@ -191,6 +219,30 @@ def run(
         for tc in assistant_turn.tool_calls:
             yield ToolStart(tc["name"], tc["input"])
 
+            # ── Governance gate (capabilities + pre_tool hook) ───────────────
+            # Runs BEFORE the normal permission gate. A capability denial or a
+            # vetoing pre_tool hook short-circuits the tool with a recorded
+            # denial, so the model sees why and can adapt.
+            if _gov is not None:
+                _gov_deny = None
+                if _gov.capabilities is not None and not _gov.capabilities.allows_tool(tc["name"]):
+                    _gov_deny = f"tool '{tc['name']}' not permitted by capability policy"
+                if _gov_deny is None and _gov.hooks is not None:
+                    _ok, _why = _gov.hooks.fire(
+                        "pre_tool", name=tc["name"], inputs=tc["input"], depth=depth)
+                    if not _ok:
+                        _gov_deny = _why
+                if _gov_deny is not None:
+                    result = f"Denied by governance: {_gov_deny}"
+                    if _gov.ledger is not None:
+                        _gov.ledger.charge("tool_calls", 1)
+                    yield ToolEnd(tc["name"], result, False)
+                    state.messages.append({
+                        "role": "tool", "tool_call_id": tc["id"],
+                        "name": tc["name"], "content": result,
+                    })
+                    continue
+
             # Permission gate
             permitted = _check_permission(tc, config)
             if not permitted:
@@ -223,6 +275,15 @@ def run(
 
             yield ToolEnd(tc["name"], result, permitted)
 
+            # Governance: charge the tool-call budget + fire post_tool hook
+            # (observational — audit, notify, metrics). Never blocks here.
+            if _gov is not None:
+                if _gov.ledger is not None:
+                    _gov.ledger.charge("tool_calls", 1)
+                if _gov.hooks is not None:
+                    _gov.hooks.fire("post_tool", name=tc["name"], inputs=tc["input"],
+                                    result=result, permitted=permitted, depth=depth)
+
             # Determine what the USER actually saw rendered, based on tool type +
             # auto_show + verbose. Inject a SYSTEM HINT when user saw nothing useful,
             # so the model can decide whether to PrintToConsole the content.

{dulus-0.2.60 → dulus-3.4.0}/backend/agents_bridge.py

@@ -1,7 +1,12 @@
 """Agent info bridge — transforms personas / sub-agent tasks into AgentInfo format."""
 from __future__ import annotations
 
-from backend.context import build_context
+# We deliberately AVOID importing backend.context.build_context here —
+# it walks the entire source tree with rglob() and tries to git/write into
+# the package directory, both of which break when Dulus is pip-installed
+# (the package lives in read-only site-packages, not a git repo). Calling
+# the lighter get_personas_for_context directly gives the AgentMonitor app
+# what it needs without the rglob/git crash.
 
 
 def build_agent_info_list() -> list[dict]:
@@ -40,8 +45,8 @@ def build_agent_info_list() -> list[dict]:
 
     # 2. Fallback / supplement with personas so the UI isn't empty
     try:
-        ctx = build_context()
-        persona_agents = ctx.get("agents", [])
+        from backend.personas import get_personas_for_context
+        persona_agents = get_personas_for_context()
         existing_ids = {a["id"] for a in agents}
         for p in persona_agents:
             pid = p.get("name", "unknown").lower().replace(" ", "-")

{dulus-0.2.60 → dulus-3.4.0}/backend/compressor.py

@@ -244,7 +244,7 @@ def summarize_memory(name: str, body: str) -> str:
 if __name__ == "__main__":
     sample = (
         "[DULUS CONTEXT]\n"
-        "Session: proactive | Agent: Dulus | User: KevRojo\n"
+        "Session: proactive | Agent: Dulus | User: <user>\n"  # demo sample only
         "Project: Dulus Command Center | Files: 11 | Lines: 2014\n"
         "Active Tasks:\n"
         "  • T-002 [in_progress] Smart Context Manager (#23) (Dulus, Core)\n"

{dulus-0.2.60 → dulus-3.4.0}/batch_api.py

@@ -171,6 +171,171 @@ class BatchManager:
 KimiBatchManager = BatchManager  # old name still works
 
 
+# ── Anthropic Batch Manager ──────────────────────────────────────────────────
+#
+# Anthropic batch API is conceptually identical to OpenAI's but the wire format
+# differs:
+#   - Requests are sent INLINE in a single create() call (no JSONL upload step).
+#   - The key under each item is "params" (not "body").
+#   - Status is "processing_status" with values: in_progress | canceling | ended.
+#   - Results stream as individual JSONL records, accessible via .results(id).
+#
+# 50% discount on both input and output tokens. Up to 24h SLA (usually <1h).
+
+class AnthropicBatchManager:
+    """Manager for Anthropic's native batch API (claude messages).
+
+    Same surface as BatchManager (prepare / create / retrieve / results /
+    cancel) so the rest of dulus can treat it interchangeably.
+    """
+
+    DEFAULT_MODEL = "claude-haiku-4-5"
+
+    def __init__(self, api_key: str):
+        try:
+            import anthropic  # noqa: F401
+        except ImportError as e:
+            raise RuntimeError(
+                "anthropic SDK not installed (pip install anthropic)"
+            ) from e
+        import anthropic as _ant
+        self.api_key = api_key
+        self.client  = _ant.Anthropic(api_key=api_key)
+
+    def prepare_requests(
+        self,
+        prompts: List[str],
+        model: str = None,
+        system_prompt: str = None,
+        max_tokens: int = 1024,
+    ) -> List[Dict[str, Any]]:
+        """Build the requests array for batches.create()."""
+        if model is None:
+            model = self.DEFAULT_MODEL
+        if system_prompt is None:
+            system_prompt = BATCH_SYSTEM_PROMPT
+
+        ts = int(time.time())
+        out: List[Dict[str, Any]] = []
+        for i, prompt in enumerate(prompts):
+            params: Dict[str, Any] = {
+                "model":      model,
+                "max_tokens": max_tokens,
+                "messages":   [{"role": "user", "content": prompt}],
+            }
+            if system_prompt:
+                params["system"] = system_prompt
+            out.append({
+                "custom_id": f"req_{ts}_{i}",
+                "params":    params,
+            })
+        return out
+
+    def create_batch(self, requests: List[Dict[str, Any]]) -> str:
+        """Create a batch inline. Returns batch_id."""
+        batch = self.client.messages.batches.create(requests=requests)
+        return batch.id
+
+    def retrieve_batch(self, batch_id: str) -> Dict[str, Any]:
+        """Get batch status. Normalizes field names to match BatchManager."""
+        b = self.client.messages.batches.retrieve(batch_id)
+        proc = getattr(b, "processing_status", None)
+        status = {
+            "in_progress": "in_progress",
+            "canceling":   "cancelling",
+            "ended":       "completed",
+        }.get(proc, proc or "unknown")
+
+        counts_raw = getattr(b, "request_counts", None)
+        counts: Dict[str, int] = {}
+        if counts_raw is not None:
+            for k in ("processing", "succeeded", "errored",
+                      "canceled", "expired"):
+                v = getattr(counts_raw, k, 0)
+                if v:
+                    counts[k] = v
+            counts["completed"] = counts.get("succeeded", 0)
+            counts["total"]     = sum([
+                counts.get("processing", 0),
+                counts.get("succeeded",  0),
+                counts.get("errored",    0),
+                counts.get("canceled",   0),
+                counts.get("expired",    0),
+            ])
+
+        if status == "completed" and counts:
+            if counts.get("errored", 0) and not counts.get("succeeded", 0):
+                status = "failed"
+            elif counts.get("expired", 0) and not counts.get("succeeded", 0):
+                status = "expired"
+
+        return {
+            "id":             b.id,
+            "status":         status,
+            "processing_status": proc,
+            "request_counts": counts,
+            "output_file_id": None,
+            "results_url":    getattr(b, "results_url", None),
+            "created_at":     str(getattr(b, "created_at", "")),
+            "ended_at":       str(getattr(b, "ended_at", "") or ""),
+            "expires_at":     str(getattr(b, "expires_at", "") or ""),
+            "completed_at":   str(getattr(b, "ended_at", "") or ""),
+        }
+
+    def cancel_batch(self, batch_id: str) -> Dict[str, Any]:
+        """Cancel a running batch."""
+        b = self.client.messages.batches.cancel(batch_id)
+        return {"id": b.id, "status": getattr(b, "processing_status", "unknown")}
+
+    def results(self, batch_id: str) -> List[Dict[str, Any]]:
+        """Fetch all results for a completed batch.
+
+        Returns: [{custom_id, type, text, error?, usage}]
+          where type in {succeeded, errored, canceled, expired}
+        """
+        out: List[Dict[str, Any]] = []
+        for r in self.client.messages.batches.results(batch_id):
+            entry: Dict[str, Any] = {
+                "custom_id": getattr(r, "custom_id", None),
+                "type":      None,
+                "text":      "",
+                "error":     None,
+                "usage":     None,
+            }
+            res = getattr(r, "result", None)
+            if res is None:
+                out.append(entry); continue
+            t = getattr(res, "type", None)
+            entry["type"] = t
+            if t == "succeeded":
+                msg = getattr(res, "message", None)
+                if msg:
+                    parts = []
+                    for block in getattr(msg, "content", []) or []:
+                        if getattr(block, "type", None) == "text":
+                            parts.append(getattr(block, "text", "") or "")
+                    entry["text"] = "\n".join(parts).strip()
+                    u = getattr(msg, "usage", None)
+                    if u:
+                        entry["usage"] = {
+                            "input_tokens":  getattr(u, "input_tokens", 0),
+                            "output_tokens": getattr(u, "output_tokens", 0),
+                            "cache_read_input_tokens":
+                                getattr(u, "cache_read_input_tokens", 0),
+                            "cache_creation_input_tokens":
+                                getattr(u, "cache_creation_input_tokens", 0),
+                        }
+            elif t == "errored":
+                err_obj = getattr(res, "error", None)
+                entry["error"] = (
+                    {"type": getattr(err_obj, "type", None),
+                     "message": getattr(err_obj, "message", None)}
+                    if err_obj else "unknown_error"
+                )
+            out.append(entry)
+        return out
+
+
 # ── Local job persistence ────────────────────────────────────────────────────
 
 _JOBS_DIR = os.path.join(os.path.expanduser("~"), ".dulus", "jobs")