loop-agent-cli 0.1.0__tar.gz

loop_agent_cli-0.1.0/MANIFEST.in

@@ -0,0 +1,13 @@
+include LICENSE
+include README.md
+include pyproject.toml
+
+recursive-include loop_agent_cli *.py
+recursive-include app *.py
+
+global-exclude __pycache__
+global-exclude *.py[cod]
+global-exclude *.so
+global-exclude .pytest_cache/*
+global-exclude venv/*
+global-exclude frontend/*

loop_agent_cli-0.1.0/PKG-INFO

@@ -0,0 +1,202 @@
+Metadata-Version: 2.4
+Name: loop-agent-cli
+Version: 0.1.0
+Summary: Typer + Rich CLI for recruit-loop-agent — run recruiting loops from the terminal
+Author-email: Chandler Song <275737875@qq.com>
+License: MIT
+Project-URL: Homepage, https://github.com/Chandler-Song/recruit-loop-agent
+Project-URL: Repository, https://github.com/Chandler-Song/recruit-loop-agent
+Project-URL: Issues, https://github.com/Chandler-Song/recruit-loop-agent/issues
+Keywords: recruiting,agent,cli,typer,langgraph
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development :: Libraries :: Application Frameworks
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+Requires-Dist: typer>=0.9.0
+Requires-Dist: rich>=13.0.0
+Requires-Dist: fastapi>=0.104.0
+Requires-Dist: sqlalchemy[asyncio]>=2.0.23
+Requires-Dist: aiosqlite>=0.19.0
+Requires-Dist: pydantic>=2.5.0
+Requires-Dist: pydantic-settings>=2.1.0
+Requires-Dist: httpx>=0.25.0
+Requires-Dist: langgraph>=0.0.40
+Requires-Dist: apscheduler>=3.10.0
+Requires-Dist: python-dotenv>=1.0.0
+Requires-Dist: cryptography>=41.0.0
+
+# loop-agent-cli
+
+> Typer + Rich CLI for [recruit-loop-agent](https://github.com/Chandler-Song/recruit-loop-agent) — 在终端中完成招聘循环的全部操作，无需启动 FastAPI Web 服务。
+
+## 功能特性
+
+- **零服务依赖**：不启动 uvicorn，直接在进程内调用核心引擎
+- **完整功能覆盖**：职位管理、候选人查看、管道操作、循环执行、调度控制、仪表盘
+- **终端友好**：Rich 彩色表格/面板，结构化输出
+
+## 安装
+
+```bash
+# 从 PyPI 安装（正式发布后）
+pip install loop-agent-cli
+
+# 开发模式安装（从项目根目录）
+cd recruit-loop-agent
+pip install -e .
+```
+
+## 前置条件
+
+- Python >= 3.11
+- `.env` 文件需存在于项目根目录（配置 `GITHUB_TOKEN`、`SMTP_*` 等）
+- 项目根目录需包含 `app/` 核心引擎包
+
+## 使用示例
+
+### 查看帮助
+
+```bash
+loop-agent --help
+```
+
+### 职位管理
+
+```bash
+# 列出所有职位
+loop-agent position list
+
+# 创建新职位
+loop-agent position create -t "Senior Backend Engineer" -c "Tech Corp" \
+  -s "Python,FastAPI,PostgreSQL" -k "backend,python,remote"
+
+# 查看职位详情
+loop-agent position show <position_id>
+
+# 关闭职位
+loop-agent position close <position_id>
+```
+
+### 执行招聘循环
+
+```bash
+# 对已有职位执行一次循环
+loop-agent run position <position_id>
+
+# 创建职位并立即执行循环
+loop-agent run create-and-run -t "Python Developer" -c "Startup Inc" \
+  -s "Python,Django" -i 30
+```
+
+### 候选人管理
+
+```bash
+# 列出候选人（默认 20 条）
+loop-agent candidate list -n 10
+
+# 查看候选人详情
+loop-agent candidate show <candidate_id>
+```
+
+### 管道管理
+
+```bash
+# 列出所有管道
+loop-agent pipeline list
+
+# 按职位过滤
+loop-agent pipeline list -p <position_id>
+
+# 更新管道状态
+loop-agent pipeline update-status <pipeline_id> contacted
+```
+
+### 调度管理
+
+```bash
+# 启动后台调度器（Ctrl+C 退出）
+loop-agent schedule start
+
+# 列出调度任务
+loop-agent schedule list
+```
+
+### 仪表盘
+
+```bash
+# 查看仪表盘摘要
+loop-agent dashboard
+```
+
+### 其他
+
+```bash
+# 显示 LangGraph 图结构
+loop-agent graph
+
+# 显示版本信息
+loop-agent version
+```
+
+### 全局选项
+
+```bash
+# 覆盖数据库路径
+loop-agent --db sqlite+aiosqlite:///./custom.db position list
+```
+
+## 命令树
+
+```
+loop-agent
+├── run                          执行招聘循环
+│   ├── position <position_id>   对已有职位执行一次循环
+│   └── create-and-run           创建职位并立即执行循环
+├── position                     职位管理
+│   ├── list                     列出所有职位
+│   ├── create                   创建新职位
+│   ├── show <position_id>       查看职位详情
+│   └── close <position_id>      关闭职位
+├── candidate                    候选人管理
+│   ├── list                     列出候选人
+│   └── show <candidate_id>      查看候选人详情
+├── pipeline                     招聘管道管理
+│   ├── list                     列出管道
+│   └── update-status            更新管道状态
+├── schedule                     调度管理
+│   ├── start                    启动后台调度器
+│   └── list                     列出调度任务
+├── dashboard                    查看仪表盘摘要
+├── graph                        显示 LangGraph 图结构
+└── version                      显示版本信息
+```
+
+## 开发
+
+```bash
+# 克隆项目
+git clone git@github.com:Chandler-Song/recruit-loop-agent.git
+cd recruit-loop-agent
+
+# 创建虚拟环境
+python -m venv venv
+source venv/bin/activate
+
+# 安装依赖
+pip install -e .
+
+# 运行测试
+pytest app/tests/ -v
+```
+
+## 许可证
+
+MIT License

loop_agent_cli-0.1.0/README.md

@@ -0,0 +1,167 @@
+# loop-agent-cli
+
+> Typer + Rich CLI for [recruit-loop-agent](https://github.com/Chandler-Song/recruit-loop-agent) — 在终端中完成招聘循环的全部操作，无需启动 FastAPI Web 服务。
+
+## 功能特性
+
+- **零服务依赖**：不启动 uvicorn，直接在进程内调用核心引擎
+- **完整功能覆盖**：职位管理、候选人查看、管道操作、循环执行、调度控制、仪表盘
+- **终端友好**：Rich 彩色表格/面板，结构化输出
+
+## 安装
+
+```bash
+# 从 PyPI 安装（正式发布后）
+pip install loop-agent-cli
+
+# 开发模式安装（从项目根目录）
+cd recruit-loop-agent
+pip install -e .
+```
+
+## 前置条件
+
+- Python >= 3.11
+- `.env` 文件需存在于项目根目录（配置 `GITHUB_TOKEN`、`SMTP_*` 等）
+- 项目根目录需包含 `app/` 核心引擎包
+
+## 使用示例
+
+### 查看帮助
+
+```bash
+loop-agent --help
+```
+
+### 职位管理
+
+```bash
+# 列出所有职位
+loop-agent position list
+
+# 创建新职位
+loop-agent position create -t "Senior Backend Engineer" -c "Tech Corp" \
+  -s "Python,FastAPI,PostgreSQL" -k "backend,python,remote"
+
+# 查看职位详情
+loop-agent position show <position_id>
+
+# 关闭职位
+loop-agent position close <position_id>
+```
+
+### 执行招聘循环
+
+```bash
+# 对已有职位执行一次循环
+loop-agent run position <position_id>
+
+# 创建职位并立即执行循环
+loop-agent run create-and-run -t "Python Developer" -c "Startup Inc" \
+  -s "Python,Django" -i 30
+```
+
+### 候选人管理
+
+```bash
+# 列出候选人（默认 20 条）
+loop-agent candidate list -n 10
+
+# 查看候选人详情
+loop-agent candidate show <candidate_id>
+```
+
+### 管道管理
+
+```bash
+# 列出所有管道
+loop-agent pipeline list
+
+# 按职位过滤
+loop-agent pipeline list -p <position_id>
+
+# 更新管道状态
+loop-agent pipeline update-status <pipeline_id> contacted
+```
+
+### 调度管理
+
+```bash
+# 启动后台调度器（Ctrl+C 退出）
+loop-agent schedule start
+
+# 列出调度任务
+loop-agent schedule list
+```
+
+### 仪表盘
+
+```bash
+# 查看仪表盘摘要
+loop-agent dashboard
+```
+
+### 其他
+
+```bash
+# 显示 LangGraph 图结构
+loop-agent graph
+
+# 显示版本信息
+loop-agent version
+```
+
+### 全局选项
+
+```bash
+# 覆盖数据库路径
+loop-agent --db sqlite+aiosqlite:///./custom.db position list
+```
+
+## 命令树
+
+```
+loop-agent
+├── run                          执行招聘循环
+│   ├── position <position_id>   对已有职位执行一次循环
+│   └── create-and-run           创建职位并立即执行循环
+├── position                     职位管理
+│   ├── list                     列出所有职位
+│   ├── create                   创建新职位
+│   ├── show <position_id>       查看职位详情
+│   └── close <position_id>      关闭职位
+├── candidate                    候选人管理
+│   ├── list                     列出候选人
+│   └── show <candidate_id>      查看候选人详情
+├── pipeline                     招聘管道管理
+│   ├── list                     列出管道
+│   └── update-status            更新管道状态
+├── schedule                     调度管理
+│   ├── start                    启动后台调度器
+│   └── list                     列出调度任务
+├── dashboard                    查看仪表盘摘要
+├── graph                        显示 LangGraph 图结构
+└── version                      显示版本信息
+```
+
+## 开发
+
+```bash
+# 克隆项目
+git clone git@github.com:Chandler-Song/recruit-loop-agent.git
+cd recruit-loop-agent
+
+# 创建虚拟环境
+python -m venv venv
+source venv/bin/activate
+
+# 安装依赖
+pip install -e .
+
+# 运行测试
+pytest app/tests/ -v
+```
+
+## 许可证
+
+MIT License

loop_agent_cli-0.1.0/app/agents/graph.py

@@ -0,0 +1,40 @@
+from langgraph.graph import StateGraph
+from app.agents.state import RecruitingState
+from app.agents.nodes import search_node, dedup_node, score_node, pipeline_node, outreach_node, evaluate_node
+
+
+def create_recruiting_graph():
+    """
+    Create the recruiting loop agent graph
+    """
+    workflow = StateGraph(RecruitingState)
+    
+    # Add nodes to the graph
+    workflow.add_node("search", search_node)
+    workflow.add_node("dedup", dedup_node)
+    workflow.add_node("score", score_node)
+    workflow.add_node("pipeline", pipeline_node)
+    workflow.add_node("outreach", outreach_node)
+    workflow.add_node("evaluate", evaluate_node)
+    
+    # Define the flow
+    workflow.set_entry_point("search")
+    workflow.add_edge("search", "dedup")
+    workflow.add_edge("dedup", "score")
+    workflow.add_edge("score", "pipeline")
+    workflow.add_edge("pipeline", "outreach")
+    workflow.add_edge("outreach", "evaluate")
+    
+    # The evaluate node decides whether to finish or loop back
+    # For now, we'll have it finish, but in a real implementation
+    # it might loop back to search based on conditions
+    workflow.add_conditional_edges(
+        "evaluate",
+        lambda x: "continue" if x.get("continue_loop", False) else "finish",
+        {
+            "continue": "search",  # Would loop back to search in a real implementation
+            "finish": "__end__"
+        }
+    )
+    
+    return workflow.compile()

loop_agent_cli-0.1.0/app/agents/nodes.py

@@ -0,0 +1,245 @@
+from typing import Dict, Any, List
+from app.agents.state import RecruitingState
+from app.services.search import SearchService
+from app.services.score import ScoreService
+from app.services.pipeline import PipelineService
+from app.services.email import EmailService
+from app.repositories.candidate import CandidateRepository
+from app.repositories.position import PositionRepository
+from app.repositories.pipeline import PipelineRepository
+from app.repositories.outreach_log import OutreachLogRepository
+from app.repositories.agent_run import AgentRunRepository
+from app.repositories.node_log import NodeLogRepository
+from app.models.candidate import Candidate
+from app.models.position import Position
+from app.models.pipeline import Pipeline
+import asyncio
+
+
+async def search_node(state: RecruitingState) -> Dict[str, Any]:
+    """
+    Search node: Perform candidate search based on position requirements
+    """
+    try:
+        # This would integrate with the SearchService
+        position = state["position"]
+        
+        # Generate search keywords based on position requirements
+        keywords = [position.title] + (position.required_skills or []) + (position.search_keywords or [])
+        
+        # Simulate search (in real implementation, this would call SearchService)
+        # For now, return empty results as the actual search happens in RunnerService
+        search_results = {
+            "keywords": keywords,
+            "candidates": state.get("candidates", []),
+            "found_count": len(state.get("candidates", []))
+        }
+        
+        # Update metrics
+        metrics = state.get("metrics", {})
+        metrics["search_count"] = metrics.get("search_count", 0) + 1
+        
+        return {
+            **state,
+            "keywords": keywords,
+            "candidates": state.get("candidates", []),
+            "metrics": metrics
+        }
+    except Exception as e:
+        errors = state.get("errors", [])
+        errors.append(f"Search node error: {str(e)}")
+        
+        return {
+            **state,
+            "errors": errors
+        }
+
+
+async def dedup_node(state: RecruitingState) -> Dict[str, Any]:
+    """
+    Deduplication node: Remove duplicate candidates
+    """
+    try:
+        candidates = state.get("candidates", [])
+        
+        # In a real implementation, this would use CandidateService's deduplication methods
+        # For now, simulate deduplication by keeping unique candidates based on source_id
+        seen_ids = set()
+        unique_candidates = []
+        
+        for candidate in candidates:
+            # Extract source and source_id from candidate data
+            source_id = candidate.get("source_id") or (candidate.get("id") if hasattr(candidate, "id") else None)
+            if source_id not in seen_ids:
+                seen_ids.add(source_id)
+                unique_candidates.append(candidate)
+        
+        dedup_result = {
+            "original_count": len(candidates),
+            "unique_count": len(unique_candidates),
+            "duplicates_removed": len(candidates) - len(unique_candidates)
+        }
+        
+        # Update metrics
+        metrics = state.get("metrics", {})
+        metrics["candidates_deduped"] = len(unique_candidates)
+        
+        return {
+            **state,
+            "dedup_result": [unique_candidates],
+            "candidates": unique_candidates,
+            "metrics": metrics
+        }
+    except Exception as e:
+        errors = state.get("errors", [])
+        errors.append(f"Dedup node error: {str(e)}")
+        
+        return {
+            **state,
+            "errors": errors
+        }
+
+
+async def score_node(state: RecruitingState) -> Dict[str, Any]:
+    """
+    Scoring node: Score candidates based on position requirements
+    """
+    try:
+        candidates = state.get("candidates", [])
+        position = state["position"]
+        
+        # In a real implementation, this would use ScoreService
+        # For now, simulate scoring
+        scored_candidates = []
+        for candidate in candidates:
+            # Just add a dummy score for now - in real implementation, use ScoreService
+            candidate_with_score = {**candidate, "score": 75.0}  # Default score
+            scored_candidates.append(candidate_with_score)
+        
+        # Update metrics
+        metrics = state.get("metrics", {})
+        metrics["candidates_scored"] = len(scored_candidates)
+        
+        return {
+            **state,
+            "candidates": scored_candidates,
+            "metrics": metrics
+        }
+    except Exception as e:
+        errors = state.get("errors", [])
+        errors.append(f"Score node error: {str(e)}")
+        
+        return {
+            **state,
+            "errors": errors
+        }
+
+
+async def pipeline_node(state: RecruitingState) -> Dict[str, Any]:
+    """
+    Pipeline node: Update pipeline with scored candidates
+    """
+    try:
+        candidates = state.get("candidates", [])
+        position = state["position"]
+        
+        # In a real implementation, this would use PipelineService
+        # For now, simulate pipeline updates
+        pipeline_updates = []
+        for candidate in candidates:
+            # Create a simulated pipeline update
+            pipeline_update = {
+                "candidate_id": candidate.get("id", "unknown"),
+                "position_id": position.id,
+                "status": "discovered",
+                "score": candidate.get("score", 0)
+            }
+            pipeline_updates.append(pipeline_update)
+        
+        # Update metrics
+        metrics = state.get("metrics", {})
+        metrics["pipeline_updates"] = len(pipeline_updates)
+        
+        return {
+            **state,
+            "pipeline_updates": pipeline_updates,
+            "metrics": metrics
+        }
+    except Exception as e:
+        errors = state.get("errors", [])
+        errors.append(f"Pipeline node error: {str(e)}")
+        
+        return {
+            **state,
+            "errors": errors
+        }
+
+
+async def outreach_node(state: RecruitingState) -> Dict[str, Any]:
+    """
+    Outreach node: Send communications to candidates
+    """
+    try:
+        candidates = state.get("candidates", [])
+        position = state["position"]
+        
+        # In a real implementation, this would use EmailService
+        # For now, simulate outreach
+        outreach_results = []
+        for candidate in candidates[:5]:  # Only outreach to first 5 candidates
+            # Simulate email sending
+            outreach_result = {
+                "candidate_id": candidate.get("id", "unknown"),
+                "status": "sent",  # or "failed"
+                "type": "email"
+            }
+            outreach_results.append(outreach_result)
+        
+        # Update metrics
+        metrics = state.get("metrics", {})
+        metrics["outreach_attempts"] = len(outreach_results)
+        metrics["emails_sent"] = len(outreach_results)  # Assuming all attempts were successful
+        
+        return {
+            **state,
+            "metrics": metrics
+        }
+    except Exception as e:
+        errors = state.get("errors", [])
+        errors.append(f"Outreach node error: {str(e)}")
+        
+        return {
+            **state,
+            "errors": errors
+        }
+
+
+async def evaluate_node(state: RecruitingState) -> Dict[str, Any]:
+    """
+    Evaluation node: Decide whether to continue the loop
+    """
+    try:
+        position = state["position"]
+        
+        # Determine if the position is still open
+        # In a real implementation, this would check the position status
+        continue_loop = position.status == "active"
+        
+        # Update metrics
+        metrics = state.get("metrics", {})
+        metrics["evaluation_completed"] = True
+        
+        return {
+            **state,
+            "continue_loop": continue_loop,
+            "metrics": metrics
+        }
+    except Exception as e:
+        errors = state.get("errors", [])
+        errors.append(f"Evaluate node error: {str(e)}")
+        
+        return {
+            **state,
+            "errors": errors,
+            "continue_loop": False  # On error, stop the loop
+        }

loop_agent_cli-0.1.0/app/agents/state.py

@@ -0,0 +1,19 @@
+from typing import TypedDict, List, Dict, Any, Optional
+from app.models.candidate import Candidate
+from app.models.position import Position
+import uuid
+
+
+class RecruitingState(TypedDict):
+    """
+    State for the recruiting loop agent
+    """
+    position: Position
+    keywords: List[str]
+    candidates: List[Dict[str, Any]]
+    dedup_result: List[Dict[str, Any]]
+    pipeline_updates: List[Dict[str, Any]]
+    metrics: Dict[str, int]
+    errors: List[str]
+    continue_loop: bool
+    run_id: Optional[uuid.UUID]