loom-agent 0.0.3__py3-none-any.whl → 0.0.4__py3-none-any.whl

loom/__init__.py

@@ -25,6 +25,33 @@ from .callbacks.observability import ObservabilityCallback, MetricsAggregator
 from .llm.model_health import ModelHealthChecker, HealthStatus
 from .llm.model_pool_advanced import ModelPoolLLM, ModelConfig, FallbackChain
 
+# Loom 0.0.3 - Unified Coordination & Performance
+from .core.agent_executor import AgentExecutor, TaskHandler
+from .core.unified_coordination import (
+    UnifiedExecutionContext,
+    IntelligentCoordinator,
+    CoordinationConfig
+)
+from .core.events import (
+    AgentEvent,
+    AgentEventType,
+    EventCollector,
+    EventFilter,
+    EventProcessor,
+    ToolCall,
+    ToolResult
+)
+from .core.turn_state import TurnState
+from .core.execution_context import ExecutionContext
+from .core.context_assembly import (
+    ContextAssembler,
+    ComponentPriority,
+    ContextComponent
+)
+
+# Loom 0.0.3 Developer API
+from .api.v0_0_3 import LoomAgent, loom_agent, unified_executor
+
 try:
     from importlib.metadata import version as _pkg_version
 
@@ -73,5 +100,29 @@ __all__ = [
     "ModelPoolLLM",
     "ModelConfig",
     "FallbackChain",
+    # Loom 0.0.3 exports - Core
+    "AgentExecutor",
+    "TaskHandler",
+    "UnifiedExecutionContext",
+    "IntelligentCoordinator",
+    "CoordinationConfig",
+    # Loom 0.0.3 exports - Events
+    "AgentEvent",
+    "AgentEventType",
+    "EventCollector",
+    "EventFilter",
+    "EventProcessor",
+    "ToolCall",
+    "ToolResult",
+    # Loom 0.0.3 exports - Context & State
+    "TurnState",
+    "ExecutionContext",
+    "ContextAssembler",
+    "ComponentPriority",
+    "ContextComponent",
+    # Loom 0.0.3 Developer API
+    "LoomAgent",
+    "loom_agent",
+    "unified_executor",
     "__version__",
 ]

loom/api/v0_0_3.py

@@ -0,0 +1,299 @@
+"""Loom 0.0.3 开发者 API - 简化统一协调使用
+
+提供开发者友好的 API 接口，让开发者能够轻松使用 Loom 0.0.3 的核心能力。
+"""
+
+import asyncio
+import time
+from typing import List, Optional, Dict, Any, AsyncGenerator, Union
+from ..core.agent_executor import AgentExecutor
+from ..core.unified_coordination import (
+    UnifiedExecutionContext,
+    IntelligentCoordinator,
+    CoordinationConfig
+)
+from ..core.events import AgentEvent, AgentEventType
+from ..core.turn_state import TurnState
+from ..core.execution_context import ExecutionContext
+from ..core.types import Message
+from ..interfaces.llm import BaseLLM
+from ..interfaces.tool import BaseTool
+
+
+class LoomAgent:
+    """Loom 0.0.3 统一协调 Agent
+    
+    提供简化的 API 接口，让开发者能够轻松使用统一协调机制。
+    """
+    
+    def __init__(
+        self,
+        llm: BaseLLM,
+        tools: Optional[Dict[str, BaseTool]] = None,
+        config: Optional[CoordinationConfig] = None,
+        execution_id: Optional[str] = None,
+        max_iterations: int = 50,
+        system_instructions: Optional[str] = None,
+        **kwargs
+    ):
+        """初始化 Loom 0.0.3 Agent
+        
+        Args:
+            llm: 语言模型实例
+            tools: 工具字典
+            config: 统一协调配置
+            execution_id: 执行 ID
+            max_iterations: 最大迭代次数
+            system_instructions: 系统指令
+            **kwargs: 其他参数
+        """
+        self.config = config or CoordinationConfig()
+        self.unified_context = UnifiedExecutionContext(
+            execution_id=execution_id or f"loom_agent_{int(time.time())}",
+            config=self.config
+        )
+        
+        self.executor = AgentExecutor(
+            llm=llm,
+            tools=tools or {},
+            unified_context=self.unified_context,
+            enable_unified_coordination=True,
+            max_iterations=max_iterations,
+            system_instructions=system_instructions,
+            **kwargs
+        )
+    
+    async def run(self, input_text: str, correlation_id: Optional[str] = None) -> str:
+        """运行 Agent 并返回最终结果
+        
+        Args:
+            input_text: 用户输入
+            correlation_id: 关联 ID
+            
+        Returns:
+            最终响应文本
+        """
+        turn_state = TurnState.initial(max_iterations=self.executor.max_iterations)
+        context = ExecutionContext.create(
+            correlation_id=correlation_id or f"run_{int(time.time())}"
+        )
+        messages = [Message(role="user", content=input_text)]
+        
+        final_content = ""
+        async for event in self.executor.tt(messages, turn_state, context):
+            if event.type == AgentEventType.AGENT_FINISH:
+                final_content = event.content or ""
+                break
+            elif event.type == AgentEventType.ERROR:
+                raise event.error
+        
+        return final_content
+    
+    async def stream(self, input_text: str, correlation_id: Optional[str] = None) -> AsyncGenerator[AgentEvent, None]:
+        """流式执行 Agent
+        
+        Args:
+            input_text: 用户输入
+            correlation_id: 关联 ID
+            
+        Yields:
+            AgentEvent: 执行事件
+        """
+        turn_state = TurnState.initial(max_iterations=self.executor.max_iterations)
+        context = ExecutionContext.create(
+            correlation_id=correlation_id or f"stream_{int(time.time())}"
+        )
+        messages = [Message(role="user", content=input_text)]
+        
+        async for event in self.executor.tt(messages, turn_state, context):
+            yield event
+    
+    async def execute_with_events(self, input_text: str, correlation_id: Optional[str] = None) -> List[AgentEvent]:
+        """执行并返回所有事件
+        
+        Args:
+            input_text: 用户输入
+            correlation_id: 关联 ID
+            
+        Returns:
+            事件列表
+        """
+        events = []
+        async for event in self.stream(input_text, correlation_id):
+            events.append(event)
+        return events
+    
+    async def run_with_progress(self, input_text: str, progress_callback=None) -> str:
+        """带进度回调的执行
+        
+        Args:
+            input_text: 用户输入
+            progress_callback: 进度回调函数
+            
+        Returns:
+            最终响应文本
+        """
+        final_content = ""
+        
+        async for event in self.stream(input_text):
+            if progress_callback:
+                await progress_callback(event)
+            
+            if event.type == AgentEventType.AGENT_FINISH:
+                final_content = event.content or ""
+                break
+            elif event.type == AgentEventType.ERROR:
+                raise event.error
+        
+        return final_content
+    
+    def get_coordinator(self) -> IntelligentCoordinator:
+        """获取智能协调器实例"""
+        return self.executor.coordinator
+    
+    def get_unified_context(self) -> UnifiedExecutionContext:
+        """获取统一执行上下文"""
+        return self.unified_context
+
+
+def create_loom_agent(
+    llm: BaseLLM,
+    tools: Optional[Dict[str, BaseTool]] = None,
+    config: Optional[CoordinationConfig] = None,
+    **kwargs
+) -> LoomAgent:
+    """创建 Loom 0.0.3 Agent
+    
+    Args:
+        llm: 语言模型实例
+        tools: 工具字典
+        config: 统一协调配置
+        **kwargs: 其他参数
+        
+    Returns:
+        LoomAgent 实例
+    """
+    return LoomAgent(llm=llm, tools=tools, config=config, **kwargs)
+
+
+def create_unified_executor(
+    llm: BaseLLM,
+    tools: Optional[Dict[str, BaseTool]] = None,
+    config: Optional[CoordinationConfig] = None,
+    execution_id: Optional[str] = None,
+    **kwargs
+) -> AgentExecutor:
+    """创建使用统一协调机制的 AgentExecutor
+    
+    Args:
+        llm: 语言模型实例
+        tools: 工具字典
+        config: 统一协调配置
+        execution_id: 执行 ID
+        **kwargs: 其他参数
+        
+    Returns:
+        AgentExecutor 实例
+    """
+    if config is None:
+        config = CoordinationConfig()
+    
+    unified_context = UnifiedExecutionContext(
+        execution_id=execution_id or f"executor_{int(time.time())}",
+        config=config
+    )
+    
+    return AgentExecutor(
+        llm=llm,
+        tools=tools or {},
+        unified_context=unified_context,
+        enable_unified_coordination=True,
+        **kwargs
+    )
+
+
+# 便捷函数
+def loom_agent(
+    llm: BaseLLM,
+    tools: Optional[Dict[str, BaseTool]] = None,
+    config: Optional[CoordinationConfig] = None,
+    **kwargs
+) -> LoomAgent:
+    """创建 Loom 0.0.3 统一协调 Agent
+    
+    这是最推荐的创建方式，提供简化的 API 和完整的功能。
+    
+    Args:
+        llm: 语言模型实例
+        tools: 工具字典
+        config: 统一协调配置
+        **kwargs: 其他参数
+        
+    Returns:
+        LoomAgent 实例
+        
+    Example:
+        ```python
+        import loom
+        from loom.builtin.llms import MockLLM
+        
+        agent = loom.loom_agent(
+            llm=MockLLM(),
+            tools={"calculator": CalculatorTool()}
+        )
+        
+        result = await agent.run("计算 2+2")
+        print(result)
+        ```
+    """
+    return create_loom_agent(llm=llm, tools=tools, config=config, **kwargs)
+
+
+def unified_executor(
+    llm: BaseLLM,
+    tools: Optional[Dict[str, BaseTool]] = None,
+    config: Optional[CoordinationConfig] = None,
+    **kwargs
+) -> AgentExecutor:
+    """创建统一协调 AgentExecutor
+    
+    适用于需要直接控制执行流程的高级用户。
+    
+    Args:
+        llm: 语言模型实例
+        tools: 工具字典
+        config: 统一协调配置
+        **kwargs: 其他参数
+        
+    Returns:
+        AgentExecutor 实例
+        
+    Example:
+        ```python
+        import loom
+        from loom.builtin.llms import MockLLM
+        
+        executor = loom.unified_executor(
+            llm=MockLLM(),
+            tools={"calculator": CalculatorTool()}
+        )
+        
+        turn_state = loom.TurnState.initial(max_iterations=10)
+        context = loom.ExecutionContext.create()
+        messages = [loom.Message(role="user", content="Hello")]
+        
+        async for event in executor.tt(messages, turn_state, context):
+            print(f"Event: {event.type} - {event.content}")
+        ```
+    """
+    return create_unified_executor(llm=llm, tools=tools, config=config, **kwargs)
+
+
+# 导出所有 API
+__all__ = [
+    "LoomAgent",
+    "create_loom_agent", 
+    "create_unified_executor",
+    "loom_agent",
+    "unified_executor",
+]

{loom_agent-0.0.3.dist-info → loom_agent-0.0.4.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: loom-agent
-Version: 0.0.3
+Version: 0.0.4
 Summary: Production-ready Python Agent framework with enterprise-grade reliability and observability
 License: MIT
 License-File: LICENSE

{loom_agent-0.0.3.dist-info → loom_agent-0.0.4.dist-info}/RECORD

@@ -1,8 +1,9 @@
-loom/__init__.py,sha256=WApvvCliqijQ7ZIalUsn23ihzHZCl7n-Cj9R8P0Suzs,2123
+loom/__init__.py,sha256=sFwLBvtRfdYceK_zHoSIS9grLb8e5Cy-Z5ma2WSCSSo,3374
 loom/agent.py,sha256=3xz-oqmj5PgeM7V4ICLXDbuWZy4ZEysJ_8d8SVI_X-E,7820
 loom/agents/__init__.py,sha256=bIb5frc5EzhKGZ7yRx2Q45LXNSHWcpf7RCe9cAfn26E,223
 loom/agents/refs.py,sha256=_B2p56OqIao-bRLAXpVRzrfUz3TW2gItsUxkhz12UIE,504
 loom/agents/registry.py,sha256=YlRyL79Xo1B8grakZPanWkH0HTI1lSCeJF5T4V2LDOw,1253
+loom/api/v0_0_3.py,sha256=Lz0sXUAKy8_gVKEPejGDbElyjVKwD93g1NqXhP1YSJY,8777
 loom/builtin/compression/__init__.py,sha256=vir2tAiuKWfHpAW6GxlfO0yNWGdA3PFEl29wYNI_ONo,122
 loom/builtin/compression/structured.py,sha256=sut1JktbYnZn7rvBIA1Vd7gDMDm9QUBe3zehlGjKp4s,2831
 loom/builtin/embeddings/__init__.py,sha256=wSKsnycbpsbO5D_DdzYEGTLek1cC16UMZf5xh8P5bl0,329
@@ -102,7 +103,7 @@ loom/tasks/sql_placeholder.py,sha256=I3lYI8ZnBDTCekFneq_AhlcisYopVI1y4HVQnYSt_38
 loom/tooling.py,sha256=sLAnjArQCU3oWuUTUDzNioZXZG33jYe3tGaIUpR22e4,2495
 loom/utils/agent_loader.py,sha256=ngtD-mVNcHhs9xzx8rVHuWNFktdgH3zfy1ZkAzEBX-4,7034
 loom/utils/token_counter.py,sha256=H0JY7HH8R0LhpWVamvx3Uuds9tphJar-c0hOrvJzYJU,462
-loom_agent-0.0.3.dist-info/METADATA,sha256=uTF28IfM7WfPZCAF4kjSsmCbNCOO57whIjWbuR65QNU,9032
-loom_agent-0.0.3.dist-info/WHEEL,sha256=zp0Cn7JsFoX2ATtOhtaFYIiE2rmFAD4OcMhtUki8W3U,88
-loom_agent-0.0.3.dist-info/licenses/LICENSE,sha256=2Fc25AXQ9WYE1SNVk4OYhze80Jq2yZvQnquS-2_Ytm4,1065
-loom_agent-0.0.3.dist-info/RECORD,,
+loom_agent-0.0.4.dist-info/METADATA,sha256=majUpnVyYL6-wjO1OWuwQvuDK3AD9jTyC5lpYcdBwQQ,9032
+loom_agent-0.0.4.dist-info/WHEEL,sha256=zp0Cn7JsFoX2ATtOhtaFYIiE2rmFAD4OcMhtUki8W3U,88
+loom_agent-0.0.4.dist-info/licenses/LICENSE,sha256=2Fc25AXQ9WYE1SNVk4OYhze80Jq2yZvQnquS-2_Ytm4,1065
+loom_agent-0.0.4.dist-info/RECORD,,