lingtai 0.1.0__tar.gz

lingtai-0.1.0/PKG-INFO

@@ -0,0 +1,28 @@
+Metadata-Version: 2.4
+Name: lingtai
+Version: 0.1.0
+Summary: Generic research agent with intrinsic tools and MCP-compatible extension interface
+License-Expression: MIT
+Requires-Python: >=3.11
+Requires-Dist: lingtai-kernel>=0.1.0
+Requires-Dist: httpx>=0.27
+Provides-Extra: minimax
+Requires-Dist: openai>=1.0; extra == "minimax"
+Provides-Extra: gemini
+Requires-Dist: google-genai>=1.0; extra == "gemini"
+Provides-Extra: openai
+Requires-Dist: openai>=1.0; extra == "openai"
+Provides-Extra: anthropic
+Requires-Dist: anthropic>=0.40; extra == "anthropic"
+Provides-Extra: mcp
+Requires-Dist: mcp>=1.0; extra == "mcp"
+Provides-Extra: search
+Requires-Dist: ddgs>=7.0; extra == "search"
+Requires-Dist: trafilatura>=2.0; extra == "search"
+Provides-Extra: all
+Requires-Dist: google-genai>=1.0; extra == "all"
+Requires-Dist: openai>=1.0; extra == "all"
+Requires-Dist: anthropic>=0.40; extra == "all"
+Requires-Dist: mcp>=1.0; extra == "all"
+Requires-Dist: ddgs>=7.0; extra == "all"
+Requires-Dist: trafilatura>=2.0; extra == "all"

lingtai-0.1.0/pyproject.toml

@@ -0,0 +1,42 @@
+[build-system]
+requires = ["setuptools>=68.0"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "lingtai"
+version = "0.1.0"
+description = "Generic research agent with intrinsic tools and MCP-compatible extension interface"
+requires-python = ">=3.11"
+license = "MIT"
+dependencies = [
+    "lingtai-kernel>=0.1.0",
+    "httpx>=0.27",
+]
+
+[project.optional-dependencies]
+minimax = ["openai>=1.0"]
+gemini = ["google-genai>=1.0"]
+openai = ["openai>=1.0"]
+anthropic = ["anthropic>=0.40"]
+mcp = ["mcp>=1.0"]
+search = ["ddgs>=7.0", "trafilatura>=2.0"]
+all = [
+    "google-genai>=1.0",
+    "openai>=1.0",
+    "anthropic>=0.40",
+    "mcp>=1.0",
+    "ddgs>=7.0",
+    "trafilatura>=2.0",
+]
+
+[project.scripts]
+lingtai = "lingtai.cli:main"
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[tool.setuptools.package-data]
+lingtai = ["i18n/*.json", "capabilities/*.json", "addons/*/*.json"]
+
+[tool.pytest.ini_options]
+pythonpath = ["src"]

lingtai-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

lingtai-0.1.0/src/lingtai/__init__.py

@@ -0,0 +1,64 @@
+"""lingtai — generic AI agent framework with intrinsic tools, composable capabilities, and pluggable services."""
+
+from lingtai_kernel.types import UnknownToolError
+from lingtai_kernel.config import AgentConfig
+from lingtai_kernel.base_agent import BaseAgent
+from .agent import Agent
+from lingtai_kernel.state import AgentState
+from lingtai_kernel.message import Message, MSG_REQUEST, MSG_USER_INPUT
+
+# Capabilities
+from .capabilities import setup_capability
+from .capabilities.bash import BashManager
+from .capabilities.avatar import AvatarManager
+from .capabilities.email import EmailManager
+
+# Services
+from .services.file_io import FileIOService, LocalFileIOService, GrepMatch
+from lingtai_kernel.services.mail import MailService, FilesystemMailService
+from lingtai_kernel.services.logging import LoggingService, JSONLLoggingService
+from .services.vision import VisionService, create_vision_service
+from .services.websearch import SearchService, SearchResult, create_search_service
+from .services.tts import TTSService, create_tts_service
+from .services.image_gen import ImageGenService, create_image_gen_service
+from .services.transcription import TranscriptionService, TranscriptionResult, create_transcription_service
+from .services.music_gen import MusicGenService, create_music_gen_service
+
+__all__ = [
+    # Core
+    "BaseAgent",
+    "Agent",
+    "Message",
+    "AgentState",
+    "MSG_REQUEST",
+    "MSG_USER_INPUT",
+    "AgentConfig",
+    "UnknownToolError",
+    # Capabilities
+    "setup_capability",
+    "BashManager",
+    "AvatarManager",
+    "EmailManager",
+    # Services
+    "FileIOService",
+    "LocalFileIOService",
+    "GrepMatch",
+    "MailService",
+    "FilesystemMailService",
+    "LoggingService",
+    "JSONLLoggingService",
+    "VisionService",
+    "create_vision_service",
+    "SearchService",
+    "SearchResult",
+    "create_search_service",
+    "TTSService",
+    "create_tts_service",
+    "ImageGenService",
+    "create_image_gen_service",
+    "TranscriptionService",
+    "TranscriptionResult",
+    "create_transcription_service",
+    "MusicGenService",
+    "create_music_gen_service",
+]

lingtai-0.1.0/src/lingtai/__main__.py

@@ -0,0 +1,4 @@
+"""Allow ``python -m lingtai`` to work like the ``lingtai`` console script."""
+from lingtai.cli import main
+
+main()

lingtai-0.1.0/src/lingtai/addons/__init__.py

@@ -0,0 +1,48 @@
+"""Add-ons --- optional extensions that may depend on capabilities.
+
+Add-ons are set up after capabilities. They use the same
+setup(agent, **kwargs) interface but live separately to signal
+they are optional and may have external dependencies.
+
+Addon managers can implement start() and stop() methods for
+lifecycle hooks --- called by Agent.start() and Agent.stop().
+
+Usage:
+    agent = Agent(
+        capabilities=["email", "file"],
+        addons={"imap": {"email_address": "...", "email_password": "..."}},
+    )
+"""
+from __future__ import annotations
+
+import importlib
+from typing import TYPE_CHECKING, Any
+
+if TYPE_CHECKING:
+    from lingtai_kernel.base_agent import BaseAgent
+
+_BUILTIN: dict[str, str] = {
+    "imap": ".imap",
+    "telegram": ".telegram",
+}
+
+
+def setup_addon(agent: "BaseAgent", name: str, **kwargs: Any) -> Any:
+    """Look up an addon by name and call its setup(agent, **kwargs).
+
+    Returns whatever the addon's setup function returns (typically a manager).
+    Raises ValueError if the name is unknown.
+    """
+    module_path = _BUILTIN.get(name)
+    if module_path is None:
+        raise ValueError(
+            f"Unknown addon: {name!r}. "
+            f"Available: {', '.join(sorted(_BUILTIN))}"
+        )
+    mod = importlib.import_module(module_path, package=__package__)
+    setup_fn = getattr(mod, "setup", None)
+    if setup_fn is None:
+        raise ValueError(
+            f"Addon module {name!r} does not export a setup() function"
+        )
+    return setup_fn(agent, **kwargs)

lingtai-0.1.0/src/lingtai/addons/imap/__init__.py

@@ -0,0 +1,161 @@
+"""IMAP addon — real email via IMAP/SMTP.
+
+Adds an `imap` tool with its own mailbox (working_dir/imap/).
+An internal TCP bridge port lets other agents relay messages outward.
+
+Usage (config file — recommended):
+    agent = Agent(
+        addons={"imap": {"config": "imap.json"}},
+    )
+
+Usage (inline, single account):
+    agent = Agent(
+        addons={"imap": {
+            "email_address": "agent@example.com",
+            "email_password": "xxxx xxxx xxxx xxxx",
+            "imap_host": "imap.gmail.com",
+            "smtp_host": "smtp.gmail.com",
+        }},
+    )
+
+Usage (inline, multi-account):
+    agent = Agent(
+        addons={"imap": {
+            "accounts": [
+                {"email_address": "a@gmail.com", "email_password": "xxxx"},
+                {"email_address": "b@outlook.com", "email_password": "yyyy",
+                 "imap_host": "imap.outlook.com", "smtp_host": "smtp.outlook.com"},
+            ],
+        }},
+    )
+"""
+from __future__ import annotations
+
+import json
+import logging
+from pathlib import Path
+from typing import TYPE_CHECKING
+
+from lingtai_kernel.services.mail import FilesystemMailService
+from .manager import IMAPMailManager, SCHEMA, DESCRIPTION
+from .service import IMAPMailService
+
+if TYPE_CHECKING:
+    from lingtai_kernel.base_agent import BaseAgent
+
+log = logging.getLogger(__name__)
+
+
+def setup(
+    agent: "BaseAgent",
+    *,
+    # Config file
+    config: str | Path | None = None,
+    # Single-account shorthand
+    email_address: str | None = None,
+    email_password: str | None = None,
+    imap_host: str = "imap.gmail.com",
+    imap_port: int = 993,
+    smtp_host: str = "smtp.gmail.com",
+    smtp_port: int = 587,
+    allowed_senders: list[str] | None = None,
+    poll_interval: int = 30,
+    # Multi-account
+    accounts: list[dict] | None = None,
+    # Addon-level
+    bridge_port: int = 8399,
+) -> IMAPMailManager:
+    """Set up IMAP addon — registers imap tool, creates services.
+
+    Args:
+        config: Path to a JSON config file. Keys are the same as the kwargs.
+                Inline kwargs override config file values.
+
+    Accepts either a flat single-account config or a list of account dicts.
+
+    Listeners are NOT started here — they start in IMAPMailManager.start(),
+    which is called by Agent.start() via the addon lifecycle.
+    """
+    # Load config file if provided — inline kwargs override file values
+    if config is not None:
+        config_path = Path(config)
+        if not config_path.is_file():
+            raise FileNotFoundError(f"IMAP config not found: {config_path}")
+        from lingtai.config_resolve import load_jsonc
+        file_cfg = load_jsonc(config_path)
+        if accounts is None:
+            accounts = file_cfg.get("accounts")
+        if email_address is None:
+            email_address = file_cfg.get("email_address")
+        if email_password is None:
+            email_password = file_cfg.get("email_password")
+        if imap_host == "imap.gmail.com" and "imap_host" in file_cfg:
+            imap_host = file_cfg["imap_host"]
+        if imap_port == 993 and "imap_port" in file_cfg:
+            imap_port = file_cfg["imap_port"]
+        if smtp_host == "smtp.gmail.com" and "smtp_host" in file_cfg:
+            smtp_host = file_cfg["smtp_host"]
+        if smtp_port == 587 and "smtp_port" in file_cfg:
+            smtp_port = file_cfg["smtp_port"]
+        if allowed_senders is None:
+            allowed_senders = file_cfg.get("allowed_senders")
+        if poll_interval == 30 and "poll_interval" in file_cfg:
+            poll_interval = file_cfg["poll_interval"]
+        if bridge_port == 8399 and "bridge_port" in file_cfg:
+            bridge_port = file_cfg["bridge_port"]
+
+    if accounts is not None:
+        account_list = accounts
+    elif email_address is not None:
+        account_list = [{
+            "email_address": email_address,
+            "email_password": email_password,
+            "imap_host": imap_host,
+            "imap_port": imap_port,
+            "smtp_host": smtp_host,
+            "smtp_port": smtp_port,
+            "allowed_senders": allowed_senders,
+            "poll_interval": poll_interval,
+        }]
+    else:
+        raise ValueError(
+            "imap addon requires 'config', 'accounts', or 'email_address'"
+        )
+
+    working_dir = Path(agent._working_dir)
+    bridge_dir = working_dir / "imap_bridge"
+    bridge_dir.mkdir(parents=True, exist_ok=True)
+
+    imap_svc = IMAPMailService(
+        accounts=account_list,
+        working_dir=working_dir,
+    )
+
+    bridge = FilesystemMailService(working_dir=bridge_dir)
+
+    mgr = IMAPMailManager(agent, service=imap_svc, tcp_alias=str(bridge_dir))
+    mgr._bridge = bridge
+
+    # Build system prompt listing all configured accounts
+    addr_lines = "\n".join(
+        f"  - {acct['email_address']}"
+        for acct in account_list
+    )
+    system_prompt = (
+        f"IMAP email accounts:\n{addr_lines}\n"
+        f"Internal bridge: {bridge_dir} "
+        f"(other agents can send to this address to relay via IMAP/SMTP)\n"
+        f"Use imap(action=...) for external email. "
+        f"Use email(action=...) for inter-agent communication."
+    )
+
+    agent.add_tool(
+        "imap", schema=SCHEMA, handler=mgr.handle, description=DESCRIPTION,
+        system_prompt=system_prompt,
+    )
+
+    log.info(
+        "IMAP addon configured: %d account(s) (bridge: %s)",
+        len(account_list), bridge_dir,
+    )
+    return mgr