kweaver-dolphin 0.1.0__py3-none-any.whl

DolphinLanguageSDK/__init__.py

@@ -0,0 +1,58 @@
+"""
+DolphinLanguageSDK - Compatibility Layer
+
+This package is deprecated. Please migrate to the new module structure:
+- dolphin.core
+- dolphin.sdk
+- dolphin.cli
+
+Notes:
+- Keep this module intentionally thin to reduce maintenance cost.
+- Exposed names are best-effort for backward compatibility.
+"""
+
+from __future__ import annotations
+
+import warnings
+from typing import Any
+
+warnings.warn(
+    "DolphinLanguageSDK is deprecated. Please migrate to dolphin.core/dolphin.sdk.",
+    DeprecationWarning,
+    stacklevel=2,
+)
+
+
+def __getattr__(name: str) -> Any:
+    """
+    Lazily resolve legacy exports.
+
+    This avoids importing a large graph at module import time while keeping
+    backward compatibility for common entry points.
+    """
+    if name == "Context":
+        from dolphin.core import Context as _Context
+
+        return _Context
+    if name == "Env":
+        from dolphin.sdk import Env as _Env
+
+        return _Env
+    if name == "DolphinAgent":
+        from dolphin.sdk import DolphinAgent as _DolphinAgent
+
+        return _DolphinAgent
+    if name == "flags":
+        from dolphin.core import flags as _flags
+
+        return _flags
+
+    raise AttributeError(
+        f"module 'DolphinLanguageSDK' has no attribute '{name}'. "
+        "This compatibility layer only exposes a small subset of legacy APIs. "
+        "Please migrate to dolphin.core/dolphin.sdk."
+    )
+
+
+__all__ = ["Context", "Env", "DolphinAgent", "flags"]
+

dolphin/__init__.py

@@ -0,0 +1,62 @@
+# -*- coding: utf-8 -*-
+"""
+Dolphin Language - An intelligent agent framework
+
+模块结构：
+- dolphin.core: 核心运行时引擎（内核态）
+- dolphin.lib: 标准库和工具集（用户态）
+- dolphin.sdk: 开发者 SDK（开发框架）
+- dolphin.cli: 命令行工具（应用层）
+
+依赖关系：
+  cli → sdk → lib → core
+"""
+
+__version__ = "0.1.0"
+
+from typing import TYPE_CHECKING
+
+if TYPE_CHECKING:
+    from dolphin.core import (
+        Context,
+        BaseAgent,
+        AgentState,
+        Skillset,
+        Skillkit,
+        SkillFunction,
+        RuntimeInstance,
+        RuntimeGraph,
+    )
+    from dolphin.sdk import (
+        DolphinAgent,
+        Env,
+        GlobalSkills,
+    )
+
+_module_lookup = {
+    # Core
+    "Context": "dolphin.core",
+    "BaseAgent": "dolphin.core",
+    "AgentState": "dolphin.core",
+    "Skillset": "dolphin.core",
+    "Skillkit": "dolphin.core",
+    "SkillFunction": "dolphin.core",
+    "RuntimeInstance": "dolphin.core",
+    "RuntimeGraph": "dolphin.core",
+    # SDK
+    "DolphinAgent": "dolphin.sdk",
+    "Env": "dolphin.sdk",
+    "GlobalSkills": "dolphin.sdk",
+}
+
+def __getattr__(name):
+    if name in _module_lookup:
+        import importlib
+        module = importlib.import_module(_module_lookup[name])
+        return getattr(module, name)
+    raise AttributeError(f"module {__name__!r} has no attribute {name!r}")
+
+__all__ = [
+    "__version__",
+    *list(_module_lookup.keys()),
+]

dolphin/cli/__init__.py

@@ -0,0 +1,20 @@
+# -*- coding: utf-8 -*-
+"""
+Dolphin CLI - 命令行工具（应用层）
+
+职责：
+- CLI 入口
+- 命令实现（run、chat、debug）
+- 用户界面（控制台 UI、布局、流式渲染）
+- 运行器
+- 中断处理
+
+依赖规则：
+- dolphin.cli → 依赖 dolphin.sdk, dolphin.lib, dolphin.core
+"""
+
+from dolphin.cli.main import main
+
+__all__ = [
+    "main",
+]

dolphin/cli/args/__init__.py

@@ -0,0 +1,9 @@
+# -*- coding: utf-8 -*-
+"""Args 模块 - 参数解析"""
+
+from dolphin.cli.args.parser import Args, parseArgs
+
+__all__ = [
+    "Args",
+    "parseArgs",
+]