docagent-cli 0.0.35__py3-none-any.whl

docagent_cli/widgets/welcome.py

@@ -0,0 +1,339 @@
+"""Welcome banner widget for docagent-cli."""
+
+from __future__ import annotations
+
+import asyncio
+import random
+from typing import TYPE_CHECKING, Any
+
+from textual.color import Color as TColor
+from textual.content import Content
+from textual.style import Style as TStyle
+from textual.widgets import Static
+
+if TYPE_CHECKING:
+    from textual.events import Click
+
+from docagent_cli import theme
+from docagent_cli._version import __version__
+from docagent_cli.config import (
+    _get_editable_install_path,
+    _is_editable_install,
+    fetch_langsmith_project_url,
+    get_banner,
+    get_glyphs,
+    get_langsmith_project_name,
+)
+from docagent_cli.widgets._links import open_style_link
+
+_TIPS: list[str] = [
+    "Use @ to reference files and / for commands",
+    "Try /threads to resume a previous conversation",
+    "Use /offload when your conversation gets long",
+    "Use /mcp to see your loaded tools and servers",
+    "Use /remember to save learnings from this conversation",
+    "Use /model to switch models mid-conversation",
+    "Press ctrl+x to compose prompts in your external editor",
+    "Press ctrl+u to delete to the start of the line in the chat input",
+    "Use /skill:<name> to invoke a skill directly",
+    "Type /update to check for and install updates",
+    "Use /theme to customize the CLI colors and style",
+    "Use /skill-creator to build reusable agent skills",
+    "Use /auto-update to toggle automatic CLI updates",
+]
+"""Rotating tips shown in the welcome footer.
+
+One is picked per session.
+"""
+
+
+class WelcomeBanner(Static):
+    """Welcome banner displayed at startup."""
+
+    # Disable Textual's auto_links to prevent a flicker cycle: Style.__add__
+    # calls .copy() for linked styles, generating a fresh random _link_id on
+    # each render. This means highlight_link_id never stabilizes, causing an
+    # infinite hover-refresh loop.
+    auto_links = False
+
+    DEFAULT_CSS = """
+    WelcomeBanner {
+        height: auto;
+        padding: 1;
+        margin-bottom: 1;
+    }
+    """
+
+    def __init__(
+        self,
+        thread_id: str | None = None,
+        mcp_tool_count: int = 0,
+        *,
+        connecting: bool = False,
+        resuming: bool = False,
+        local_server: bool = False,
+        **kwargs: Any,
+    ) -> None:
+        """Initialize the welcome banner.
+
+        Args:
+            thread_id: Optional thread ID to display in the banner.
+            mcp_tool_count: Number of MCP tools loaded at startup.
+            connecting: When `True`, show a "Connecting..." footer instead of
+                the normal ready prompt. Call `set_connected` to transition.
+            resuming: When `True`, the connecting footer says "Resuming..."
+                instead of any `'Connecting...'` variant.
+            local_server: When `True`, the connecting footer qualifies the
+                server as "local" (i.e. a server process managed by the
+                CLI).
+
+                Ignored when `resuming` is `True`.
+            **kwargs: Additional arguments passed to parent.
+        """
+        # Avoid collision with Widget._thread_id (Textual internal int)
+        self._cli_thread_id: str | None = thread_id
+        self._mcp_tool_count = mcp_tool_count
+        self._connecting = connecting
+        self._resuming = resuming
+        self._local_server = local_server
+        self._failed = False
+        self._failure_error: str = ""
+        self._project_name: str | None = get_langsmith_project_name()
+        self._project_url: str | None = None
+        self._tip: str = random.choice(_TIPS)  # noqa: S311
+
+        super().__init__(self._build_banner(), **kwargs)
+
+    def on_mount(self) -> None:
+        """Kick off background fetch for LangSmith project URL."""
+        self.watch(self.app, "theme", self._on_theme_change, init=False)
+        if self._project_name:
+            self.run_worker(self._fetch_and_update, exclusive=True)
+
+    def _on_theme_change(self) -> None:
+        """Re-render the banner when the app theme changes."""
+        self.update(self._build_banner(self._project_url))
+
+    async def _fetch_and_update(self) -> None:
+        """Fetch the LangSmith URL in a thread and update the banner."""
+        if not self._project_name:
+            return
+        try:
+            project_url = await asyncio.wait_for(
+                asyncio.to_thread(fetch_langsmith_project_url, self._project_name),
+                timeout=2.0,
+            )
+        except (TimeoutError, OSError):
+            project_url = None
+        if project_url:
+            self._project_url = project_url
+            self.update(self._build_banner(project_url))
+
+    def update_thread_id(self, thread_id: str) -> None:
+        """Update the displayed thread ID and re-render the banner.
+
+        Args:
+            thread_id: The new thread ID to display.
+        """
+        self._cli_thread_id = thread_id
+        self.update(self._build_banner(self._project_url))
+
+    def set_connected(self, mcp_tool_count: int = 0) -> None:
+        """Transition from "connecting" to "ready" state.
+
+        Args:
+            mcp_tool_count: Number of MCP tools loaded during connection.
+        """
+        self._connecting = False
+        self._failed = False
+        self._mcp_tool_count = mcp_tool_count
+        self.update(self._build_banner(self._project_url))
+
+    def set_failed(self, error: str) -> None:
+        """Transition from "connecting" to a persistent failure state.
+
+        Args:
+            error: Error message describing the server startup failure.
+        """
+        self._connecting = False
+        self._failed = True
+        self._failure_error = error
+        self.update(self._build_banner(self._project_url))
+
+    def on_click(self, event: Click) -> None:  # noqa: PLR6301  # Textual event handler
+        """Open style-embedded hyperlinks on single click."""
+        open_style_link(event)
+
+    def _build_banner(self, project_url: str | None = None) -> Content:
+        """Build the banner content.
+
+        When a `project_url` is provided and a thread ID is set, the thread ID
+        is rendered as a clickable hyperlink to the LangSmith thread view.
+
+        Args:
+            project_url: LangSmith project URL used for linking the project
+                name and thread ID. When `None`, text is rendered without links.
+
+        Returns:
+            Content object containing the formatted banner.
+        """
+        parts: list[str | tuple[str, str | TStyle] | Content] = []
+        colors = theme.get_theme_colors(self)
+        ansi = self.app.theme == "textual-ansi"
+
+        banner = get_banner()
+        primary_style: str | TStyle = (
+            "bold"
+            if ansi
+            else TStyle(foreground=TColor.parse(colors.primary), bold=True)
+        )
+
+        if not ansi and _is_editable_install():
+            # Highlight local-install version tag with tool accent; art stays primary.
+            dev_style = TStyle(foreground=TColor.parse(colors.tool), bold=True)
+            version_tag = f"v{__version__} (local)"
+            idx = banner.rfind(version_tag)
+            if idx >= 0:
+                parts.extend(
+                    [
+                        (banner[:idx], primary_style),
+                        (version_tag, dev_style),
+                        (banner[idx + len(version_tag) :] + "\n", primary_style),
+                    ]
+                )
+            else:
+                parts.append((banner + "\n", primary_style))
+        else:
+            parts.append((banner + "\n", primary_style))
+
+        # For ANSI theme, use "bold" (terminal foreground) instead of hex
+        accent: str | TStyle = "bold" if ansi else colors.primary
+        success_color: str = "bold green" if ansi else colors.success
+
+        editable_path = _get_editable_install_path()
+        if editable_path:
+            parts.extend([("Installed from: ", "dim"), (editable_path, "dim"), "\n"])
+
+        if self._project_name:
+            parts.extend(
+                [
+                    (f"{get_glyphs().checkmark} ", success_color),
+                    "LangSmith tracing: ",
+                ]
+            )
+            if project_url:
+                link_style: str | TStyle
+                if ansi:
+                    url = f"{project_url}?utm_source=docagent-cli"
+                    link_style = TStyle(bold=True, link=url)
+                else:
+                    link_style = TStyle(
+                        foreground=TColor.parse(colors.primary),
+                        link=f"{project_url}?utm_source=docagent-cli",
+                    )
+                parts.append((f"'{self._project_name}'", link_style))
+            else:
+                parts.append((f"'{self._project_name}'", accent))
+            parts.append("\n")
+
+        if self._cli_thread_id:
+            if project_url:
+                thread_url = (
+                    f"{project_url.rstrip('/')}/t/{self._cli_thread_id}"
+                    "?utm_source=docagent-cli"
+                )
+                parts.extend(
+                    [
+                        ("Thread: ", "dim"),
+                        (self._cli_thread_id, TStyle(dim=True, link=thread_url)),
+                        ("\n", "dim"),
+                    ]
+                )
+            else:
+                parts.append((f"Thread: {self._cli_thread_id}\n", "dim"))
+
+        if self._mcp_tool_count > 0:
+            parts.append((f"{get_glyphs().checkmark} ", success_color))
+            label = "MCP tool" if self._mcp_tool_count == 1 else "MCP tools"
+            parts.append(f"Loaded {self._mcp_tool_count} {label}\n")
+
+        if self._failed:
+            parts.append(build_failure_footer(self._failure_error))
+        elif self._connecting:
+            parts.append(
+                build_connecting_footer(
+                    resuming=self._resuming,
+                    local_server=self._local_server,
+                )
+            )
+        else:
+            ready_color = "bold" if ansi else colors.primary
+            parts.append(build_welcome_footer(primary_color=ready_color, tip=self._tip))
+        return Content.assemble(*parts)
+
+
+def build_failure_footer(error: str) -> Content:
+    """Build a footer shown when the server failed to start.
+
+    Args:
+        error: Error message describing the failure.
+
+    Returns:
+        Content with a persistent failure message.
+    """
+    colors = theme.get_theme_colors()
+    return Content.assemble(
+        ("\nServer failed to start: ", f"bold {colors.error}"),
+        (error, colors.error),
+        ("\n", colors.error),
+    )
+
+
+def build_connecting_footer(
+    *, resuming: bool = False, local_server: bool = False
+) -> Content:
+    """Build a footer shown while waiting for the server to connect.
+
+    Args:
+        resuming: Show `'Resuming...'` instead of any `'Connecting...'` variant.
+        local_server: Qualify the server as "local" in the connecting message.
+
+            Ignored when `resuming` is `True`.
+
+    Returns:
+        Content with a connecting status message.
+    """
+    if resuming:
+        text = "\nResuming...\n"
+    elif local_server:
+        text = "\nConnecting to local server...\n"
+    else:
+        text = "\nConnecting to server...\n"
+    return Content.styled(text, "dim")
+
+
+def build_welcome_footer(
+    *, primary_color: str = theme.PRIMARY, tip: str | None = None
+) -> Content:
+    """Build the footer shown at the bottom of the welcome banner.
+
+    Includes a tip to help users discover features.
+
+    Args:
+        primary_color: Color string for the ready prompt.
+
+            Defaults to the module-level ANSI `PRIMARY` constant; widget callers
+            should pass the active theme's hex value.
+        tip: Tip text to display. When `None`, a random tip is selected.
+
+            Pass an explicit value to keep the tip stable across re-renders.
+
+    Returns:
+        Content with the ready prompt and a tip.
+    """
+    if tip is None:
+        tip = random.choice(_TIPS)  # noqa: S311
+    return Content.assemble(
+        ("\nReady to code! What would you like to build?\n", primary_color),
+        (f"Tip: {tip}", "dim italic"),
+    )

docagent_cli-0.0.35.data/data/docagent_cli/default_agent_prompt.md

@@ -0,0 +1,12 @@
+# Project Notes
+
+This file is for tracking project-specific context as you work.
+You can update this file to remember decisions, patterns, and context about this project.
+
+## Architecture Notes
+
+(Add notes about project structure, key files, patterns as you discover them)
+
+## Decisions
+
+(Track important decisions and their rationale)

docagent_cli-0.0.35.dist-info/METADATA

@@ -0,0 +1,200 @@
+Metadata-Version: 2.4
+Name: docagent-cli
+Version: 0.0.35
+Summary: Terminal interface for Deep Agents - interactive AI agent with file operations, shell access, and sub-agent capabilities.
+Project-URL: Homepage, https://docs.langchain.com/oss/python/docagent/overview
+Project-URL: Documentation, https://reference.langchain.com/python/docagent/
+Project-URL: Repository, https://github.com/langchain-ai/docagent
+Project-URL: Issues, https://github.com/langchain-ai/docagent/issues
+Project-URL: Changelog, https://github.com/langchain-ai/docagent/blob/main/libs/cli/CHANGELOG.md
+Project-URL: Twitter, https://x.com/LangChain
+Project-URL: Slack, https://www.langchain.com/join-community
+Project-URL: Reddit, https://www.reddit.com/r/LangChain/
+License: MIT
+Keywords: agents,ai,cli,deep-agent,langchain,langgraph,llm,terminal
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Topic :: Terminals
+Requires-Python: <4.0,>=3.11
+Requires-Dist: aiosqlite<1.0.0,>=0.19.0
+Requires-Dist: deepagents-acp>=0.0.4
+Requires-Dist: deepagents==0.4.11
+Requires-Dist: httpx<1.0.0,>=0.28.1
+Requires-Dist: langchain-anthropic<2.0.0,>=1.4.0
+Requires-Dist: langchain-google-genai<5.0.0,>=4.2.1
+Requires-Dist: langchain-mcp-adapters<1.0.0,>=0.2.0
+Requires-Dist: langchain-openai<2.0.0,>=1.1.8
+Requires-Dist: langchain<2.0.0,>=1.2.13
+Requires-Dist: langgraph-checkpoint-sqlite<4.0.0,>=3.0.0
+Requires-Dist: langgraph-cli[inmem]<1.0.0,>=0.4.15
+Requires-Dist: langgraph-sdk<1.0.0,>=0.3.11
+Requires-Dist: langgraph<2.0.0,>=1.1.2
+Requires-Dist: langsmith[sandbox]>=0.7.7
+Requires-Dist: markdownify<2.0.0,>=0.13.0
+Requires-Dist: packaging>=23.0
+Requires-Dist: pillow<13.0.0,>=10.0.0
+Requires-Dist: prompt-toolkit<4.0.0,>=3.0.52
+Requires-Dist: pyperclip<2.0.0,>=1.11.0
+Requires-Dist: python-dotenv<2.0.0,>=1.0.0
+Requires-Dist: pyyaml>=6.0.0
+Requires-Dist: requests<3.0.0,>=2.0.0
+Requires-Dist: rich<15.0.0,>=14.0.0
+Requires-Dist: tavily-python<1.0.0,>=0.7.21
+Requires-Dist: textual-autocomplete<5.0.0,>=3.0.0
+Requires-Dist: textual-speedups<1.0.0,>=0.2.1
+Requires-Dist: textual<9.0.0,>=8.0.0
+Requires-Dist: tomli-w<2.0.0,>=1.0.0
+Requires-Dist: uuid-utils<1.0.0,>=0.10.0
+Provides-Extra: agentcore
+Requires-Dist: langchain-agentcore-codeinterpreter>=0.0.1; extra == 'agentcore'
+Provides-Extra: all-providers
+Requires-Dist: langchain-anthropic<2.0.0,>=1.4.0; extra == 'all-providers'
+Requires-Dist: langchain-aws<2.0.0,>=1.0.0; extra == 'all-providers'
+Requires-Dist: langchain-baseten<1.0.0,>=0.1.9; extra == 'all-providers'
+Requires-Dist: langchain-cohere<1.0.0,>=0.5.0; extra == 'all-providers'
+Requires-Dist: langchain-deepseek<2.0.0,>=1.0.0; extra == 'all-providers'
+Requires-Dist: langchain-fireworks<2.0.0,>=1.0.0; extra == 'all-providers'
+Requires-Dist: langchain-google-genai<5.0.0,>=4.2.1; extra == 'all-providers'
+Requires-Dist: langchain-google-vertexai<4.0.0,>=3.0.0; extra == 'all-providers'
+Requires-Dist: langchain-groq<2.0.0,>=1.0.0; extra == 'all-providers'
+Requires-Dist: langchain-huggingface<2.0.0,>=1.0.0; extra == 'all-providers'
+Requires-Dist: langchain-ibm<2.0.0,>=1.0.0; extra == 'all-providers'
+Requires-Dist: langchain-litellm<2.0.0,>=0.6.1; extra == 'all-providers'
+Requires-Dist: langchain-mistralai<2.0.0,>=1.0.0; extra == 'all-providers'
+Requires-Dist: langchain-nvidia-ai-endpoints<2.0.0,>=1.0.0; extra == 'all-providers'
+Requires-Dist: langchain-ollama<2.0.0,>=1.0.0; extra == 'all-providers'
+Requires-Dist: langchain-openai<2.0.0,>=1.1.8; extra == 'all-providers'
+Requires-Dist: langchain-openrouter<2.0.0,>=0.2.0; extra == 'all-providers'
+Requires-Dist: langchain-perplexity<2.0.0,>=1.0.0; extra == 'all-providers'
+Requires-Dist: langchain-xai<2.0.0,>=1.0.0; extra == 'all-providers'
+Provides-Extra: all-sandboxes
+Requires-Dist: langchain-agentcore-codeinterpreter>=0.0.1; extra == 'all-sandboxes'
+Requires-Dist: langchain-daytona>=0.0.4; extra == 'all-sandboxes'
+Requires-Dist: langchain-modal>=0.0.2; extra == 'all-sandboxes'
+Requires-Dist: langchain-runloop>=0.0.3; extra == 'all-sandboxes'
+Provides-Extra: anthropic
+Requires-Dist: langchain-anthropic<2.0.0,>=1.4.0; extra == 'anthropic'
+Provides-Extra: baseten
+Requires-Dist: langchain-baseten<1.0.0,>=0.1.9; extra == 'baseten'
+Provides-Extra: bedrock
+Requires-Dist: langchain-aws<2.0.0,>=1.0.0; extra == 'bedrock'
+Provides-Extra: cohere
+Requires-Dist: langchain-cohere<1.0.0,>=0.5.0; extra == 'cohere'
+Provides-Extra: daytona
+Requires-Dist: langchain-daytona>=0.0.4; extra == 'daytona'
+Provides-Extra: deepseek
+Requires-Dist: langchain-deepseek<2.0.0,>=1.0.0; extra == 'deepseek'
+Provides-Extra: fireworks
+Requires-Dist: langchain-fireworks<2.0.0,>=1.0.0; extra == 'fireworks'
+Provides-Extra: google-genai
+Requires-Dist: langchain-google-genai<5.0.0,>=4.2.1; extra == 'google-genai'
+Provides-Extra: groq
+Requires-Dist: langchain-groq<2.0.0,>=1.0.0; extra == 'groq'
+Provides-Extra: huggingface
+Requires-Dist: langchain-huggingface<2.0.0,>=1.0.0; extra == 'huggingface'
+Provides-Extra: ibm
+Requires-Dist: langchain-ibm<2.0.0,>=1.0.0; extra == 'ibm'
+Provides-Extra: litellm
+Requires-Dist: langchain-litellm<2.0.0,>=0.6.1; extra == 'litellm'
+Provides-Extra: mistralai
+Requires-Dist: langchain-mistralai<2.0.0,>=1.0.0; extra == 'mistralai'
+Provides-Extra: modal
+Requires-Dist: langchain-modal>=0.0.2; extra == 'modal'
+Provides-Extra: nvidia
+Requires-Dist: langchain-nvidia-ai-endpoints<2.0.0,>=1.0.0; extra == 'nvidia'
+Provides-Extra: ollama
+Requires-Dist: langchain-ollama<2.0.0,>=1.0.0; extra == 'ollama'
+Provides-Extra: openai
+Requires-Dist: langchain-openai<2.0.0,>=1.1.8; extra == 'openai'
+Provides-Extra: openrouter
+Requires-Dist: langchain-openrouter<2.0.0,>=0.2.0; extra == 'openrouter'
+Provides-Extra: perplexity
+Requires-Dist: langchain-perplexity<2.0.0,>=1.0.0; extra == 'perplexity'
+Provides-Extra: runloop
+Requires-Dist: langchain-runloop>=0.0.3; extra == 'runloop'
+Provides-Extra: vertexai
+Requires-Dist: langchain-google-vertexai<4.0.0,>=3.0.0; extra == 'vertexai'
+Provides-Extra: xai
+Requires-Dist: langchain-xai<2.0.0,>=1.0.0; extra == 'xai'
+Description-Content-Type: text/markdown
+
+# 🧠🤖 Deep Agents CLI
+
+[![PyPI - Version](https://img.shields.io/pypi/v/docagent-cli?label=%20)](https://pypi.org/project/docagent-cli/#history)
+[![PyPI - License](https://img.shields.io/pypi/l/docagent-cli)](https://opensource.org/licenses/MIT)
+[![PyPI - Downloads](https://img.shields.io/pepy/dt/docagent-cli)](https://pypistats.org/packages/docagent-cli)
+[![Twitter](https://img.shields.io/twitter/url/https/twitter.com/langchain.svg?style=social&label=Follow%20%40LangChain)](https://x.com/langchain)
+
+<p align="center">
+  <img src="https://raw.githubusercontent.com/langchain-ai/docagent/main/libs/cli/images/cli.png" alt="Deep Agents CLI" width="600"/>
+</p>
+
+## Quick Install
+
+```bash
+curl -LsSf https://raw.githubusercontent.com/langchain-ai/docagent/main/libs/cli/scripts/install.sh | bash
+```
+
+```bash
+# With model provider extras
+# OpenAI, Anthropic, and Gemini are included by default
+DEEPAGENTS_EXTRAS="nvidia,ollama" curl -LsSf https://raw.githubusercontent.com/langchain-ai/docagent/main/libs/cli/scripts/install.sh | bash
+```
+
+Or install directly with `uv`:
+
+```bash
+# Install with chosen model providers
+uv tool install 'docagent-cli[nvidia,ollama]'
+```
+
+Run the CLI:
+
+```bash
+docagent
+```
+
+## 🤔 What is this?
+
+The fastest way to start using Deep Agents. `docagent-cli` is a pre-built coding agent in your terminal — similar to Claude Code or Cursor — powered by any LLM that supports tool calling. One install command and you're up and running, no code required.
+
+**What the CLI adds on top of the SDK:**
+
+- **Interactive TUI** — rich terminal interface with streaming responses
+- **Conversation resume** — pick up where you left off across sessions
+- **Web search** — ground responses in live information
+- **Remote sandboxes** — run code in isolated environments (LangSmith, AgentCore, Daytona, Modal, Runloop, & more)
+- **Persistent memory** — agent remembers context across conversations
+- **Custom skills** — extend the agent with your own slash commands
+- **Headless mode** — run non-interactively for scripting and CI
+- **Human-in-the-loop** — approve or reject tool calls before execution
+
+## 📖 Resources
+
+- **[CLI Documentation](https://docs.langchain.com/oss/python/docagent/cli/overview)**
+- **[Changelog](https://github.com/langchain-ai/docagent/blob/main/libs/cli/CHANGELOG.md)**
+- **[Source code](https://github.com/langchain-ai/docagent/tree/main/libs/cli)**
+- **[Deep Agents SDK](https://github.com/langchain-ai/docagent)** — underlying agent harness
+
+## 📕 Releases & Versioning
+
+See our [Releases](https://docs.langchain.com/oss/python/release-policy) and [Versioning](https://docs.langchain.com/oss/python/versioning) policies.
+
+## 💁 Contributing
+
+As an open-source project in a rapidly developing field, we are extremely open to contributions, whether it be in the form of a new feature, improved infrastructure, or better documentation.
+
+For detailed information on how to contribute, see the [Contributing Guide](https://docs.langchain.com/oss/python/contributing/overview).
+
+## 🤝 Acknowledgements
+
+This project was primarily inspired by Claude Code, and initially was largely an attempt to see what made Claude Code general purpose, and make it even more so.