aiagent-runner 0.1.1__tar.gz

aiagent_runner-0.1.1/.gitignore

@@ -0,0 +1,47 @@
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[cod]
+*$py.class
+
+# C extensions
+*.so
+
+# Distribution / packaging
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+
+# Virtual environments
+.venv/
+venv/
+ENV/
+
+# Testing
+.coverage
+.pytest_cache/
+htmlcov/
+.tox/
+.nox/
+
+# IDE
+.idea/
+.vscode/
+*.swp
+*.swo
+
+# Logs
+logs/
+*.log

aiagent_runner-0.1.1/PKG-INFO

@@ -0,0 +1,148 @@
+Metadata-Version: 2.4
+Name: aiagent-runner
+Version: 0.1.1
+Summary: Runner for AI Agent PM - executes tasks via MCP and CLI
+Author: AI Agent PM Team
+License-Expression: MIT
+Keywords: agent,ai,automation,mcp,orchestration,task-management
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.9
+Requires-Dist: pyyaml>=6.0
+Provides-Extra: dev
+Requires-Dist: pytest-asyncio>=0.23; extra == 'dev'
+Requires-Dist: pytest-cov>=4.1; extra == 'dev'
+Requires-Dist: pytest>=8.0; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# AI Agent PM Coordinator
+
+全エージェントのタスク実行を統合管理するオーケストレーションデーモン。
+
+---
+
+## クイックスタート
+
+```bash
+cd runner
+pip install -e .
+
+# デフォルト設定で起動（config/coordinator_default.yaml を使用）
+python -m aiagent_runner --coordinator
+```
+
+---
+
+## Coordinatorモード（推奨）
+
+単一のCoordinatorが全ての(agent_id, project_id)ペアを管理します。
+
+### 基本起動
+
+```bash
+# デフォルト設定で起動
+python -m aiagent_runner --coordinator
+
+# 詳細ログ出力
+python -m aiagent_runner --coordinator -v
+```
+
+### カスタム設定ファイル
+
+```bash
+python -m aiagent_runner --coordinator -c /path/to/config.yaml
+```
+
+### 設定ファイル例
+
+```yaml
+# config/coordinator_default.yaml がデフォルトで読み込まれます
+# カスタム設定で上書き可能
+
+polling_interval: 10
+max_concurrent: 3
+
+# MCP server configuration (Agent Instance用)
+mcp_server_command: /path/to/mcp-server-pm
+mcp_database_path: /path/to/database.db
+
+# AI providers
+ai_providers:
+  claude:
+    cli_command: claude
+    cli_args:
+      - "--dangerously-skip-permissions"
+      - "--max-turns"
+      - "50"
+
+# Agents (passkeyのみ - ai_type等はMCPから取得)
+agents:
+  agt_developer:
+    passkey: secret123
+  agt_reviewer:
+    passkey: ${REVIEWER_PASSKEY}  # 環境変数展開対応
+
+log_directory: /tmp/coordinator_logs
+```
+
+### バックグラウンド実行
+
+```bash
+nohup python -m aiagent_runner --coordinator -v > coordinator.log 2>&1 &
+```
+
+---
+
+## 設定の優先順位
+
+1. **コマンドライン引数** (`--polling-interval` 等)
+2. **指定した設定ファイル** (`-c /path/to/config.yaml`)
+3. **デフォルト設定** (`runner/config/coordinator_default.yaml`)
+4. **組み込みデフォルト値**
+
+---
+
+## 動作フロー
+
+1. MCPサーバーに接続（Unixソケット）
+2. `list_active_projects_with_agents()` で全プロジェクト・エージェントを取得
+3. 各(agent_id, project_id)ペアに対して `should_start()` を呼び出し
+4. 作業が必要な場合、Agent Instance（Claude CLI等）をスポーン
+5. Agent Instanceが `authenticate` → `get_my_task` → 実行 → `report_completed`
+6. 待機して2に戻る
+
+---
+
+## 前提条件
+
+- MCPサーバーが起動していること
+- エージェントがアプリで登録済みで、passkeyが設定されていること
+- 該当エージェントがプロジェクトに割り当てられていること
+- タスクが `in_progress` ステータスであること
+
+---
+
+## Legacy Runnerモード（非推奨）
+
+1エージェント = 1デーモン の旧アーキテクチャ。
+
+```bash
+# 非推奨: Coordinatorモードを使用してください
+aiagent-runner --agent-id <AGENT_ID> --passkey <PASSKEY> --project-id <PROJECT_ID>
+```
+
+---
+
+## 開発
+
+```bash
+pip install -e ".[dev]"
+pytest
+```

aiagent_runner-0.1.1/PyPI-Recovery-Codes-asato99-2026-01-09T01_18_40.124422.txt

@@ -0,0 +1,8 @@
+451f1656bb31ff63
+b54f42bd24f0408c
+a04e46d8c63c69e4
+77583aa829569de1
+a981dae769dc06b6
+7de76ea4637fa972
+c12dd9e50e39392d
+c33e519d5d61d312

aiagent_runner-0.1.1/README.md

@@ -0,0 +1,124 @@
+# AI Agent PM Coordinator
+
+全エージェントのタスク実行を統合管理するオーケストレーションデーモン。
+
+---
+
+## クイックスタート
+
+```bash
+cd runner
+pip install -e .
+
+# デフォルト設定で起動（config/coordinator_default.yaml を使用）
+python -m aiagent_runner --coordinator
+```
+
+---
+
+## Coordinatorモード（推奨）
+
+単一のCoordinatorが全ての(agent_id, project_id)ペアを管理します。
+
+### 基本起動
+
+```bash
+# デフォルト設定で起動
+python -m aiagent_runner --coordinator
+
+# 詳細ログ出力
+python -m aiagent_runner --coordinator -v
+```
+
+### カスタム設定ファイル
+
+```bash
+python -m aiagent_runner --coordinator -c /path/to/config.yaml
+```
+
+### 設定ファイル例
+
+```yaml
+# config/coordinator_default.yaml がデフォルトで読み込まれます
+# カスタム設定で上書き可能
+
+polling_interval: 10
+max_concurrent: 3
+
+# MCP server configuration (Agent Instance用)
+mcp_server_command: /path/to/mcp-server-pm
+mcp_database_path: /path/to/database.db
+
+# AI providers
+ai_providers:
+  claude:
+    cli_command: claude
+    cli_args:
+      - "--dangerously-skip-permissions"
+      - "--max-turns"
+      - "50"
+
+# Agents (passkeyのみ - ai_type等はMCPから取得)
+agents:
+  agt_developer:
+    passkey: secret123
+  agt_reviewer:
+    passkey: ${REVIEWER_PASSKEY}  # 環境変数展開対応
+
+log_directory: /tmp/coordinator_logs
+```
+
+### バックグラウンド実行
+
+```bash
+nohup python -m aiagent_runner --coordinator -v > coordinator.log 2>&1 &
+```
+
+---
+
+## 設定の優先順位
+
+1. **コマンドライン引数** (`--polling-interval` 等)
+2. **指定した設定ファイル** (`-c /path/to/config.yaml`)
+3. **デフォルト設定** (`runner/config/coordinator_default.yaml`)
+4. **組み込みデフォルト値**
+
+---
+
+## 動作フロー
+
+1. MCPサーバーに接続（Unixソケット）
+2. `list_active_projects_with_agents()` で全プロジェクト・エージェントを取得
+3. 各(agent_id, project_id)ペアに対して `should_start()` を呼び出し
+4. 作業が必要な場合、Agent Instance（Claude CLI等）をスポーン
+5. Agent Instanceが `authenticate` → `get_my_task` → 実行 → `report_completed`
+6. 待機して2に戻る
+
+---
+
+## 前提条件
+
+- MCPサーバーが起動していること
+- エージェントがアプリで登録済みで、passkeyが設定されていること
+- 該当エージェントがプロジェクトに割り当てられていること
+- タスクが `in_progress` ステータスであること
+
+---
+
+## Legacy Runnerモード（非推奨）
+
+1エージェント = 1デーモン の旧アーキテクチャ。
+
+```bash
+# 非推奨: Coordinatorモードを使用してください
+aiagent-runner --agent-id <AGENT_ID> --passkey <PASSKEY> --project-id <PROJECT_ID>
+```
+
+---
+
+## 開発
+
+```bash
+pip install -e ".[dev]"
+pytest
+```

aiagent_runner-0.1.1/config/coordinator_default.yaml

@@ -0,0 +1,28 @@
+# AI Agent PM Coordinator - Default Configuration
+# このファイルはデフォルト設定を定義します
+# テスト時は -c オプションで上書き可能
+
+# Polling settings
+polling_interval: 10
+max_concurrent: 3
+
+# MCP connection (default socket path)
+# mcp_socket_path: ~/Library/Application Support/AIAgentPM/mcp.sock
+
+# AI providers - how to launch each AI type
+ai_providers:
+  claude:
+    cli_command: claude
+    cli_args:
+      - "--dangerously-skip-permissions"
+      - "--max-turns"
+      - "50"
+
+# Agents configuration
+# 本番環境では環境変数または別ファイルでpasskeyを管理
+# agents:
+#   agt_example:
+#     passkey: ${AGENT_PASSKEY}
+
+# Logging (optional)
+# log_directory: /tmp/coordinator_logs

aiagent_runner-0.1.1/pyproject.toml

@@ -0,0 +1,46 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "aiagent-runner"
+version = "0.1.1"
+description = "Runner for AI Agent PM - executes tasks via MCP and CLI"
+readme = "README.md"
+requires-python = ">=3.9"
+license = "MIT"
+authors = [
+    { name = "AI Agent PM Team" }
+]
+keywords = ["ai", "agent", "mcp", "automation", "task-management", "orchestration"]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Environment :: Console",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Topic :: Software Development :: Libraries :: Python Modules",
+]
+dependencies = [
+    "pyyaml>=6.0",
+]
+
+[project.optional-dependencies]
+dev = [
+    "pytest>=8.0",
+    "pytest-asyncio>=0.23",
+    "pytest-cov>=4.1",
+]
+
+[project.scripts]
+aiagent-runner = "aiagent_runner.__main__:main"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/aiagent_runner"]
+
+[tool.pytest.ini_options]
+asyncio_mode = "auto"
+testpaths = ["tests"]

aiagent_runner-0.1.1/src/aiagent_runner/__init__.py

@@ -0,0 +1,9 @@
+# aiagent_runner - Runner for AI Agent PM
+# Executes tasks via MCP protocol and CLI tools (claude, gemini, etc.)
+
+__version__ = "0.1.0"
+
+from aiagent_runner.config import RunnerConfig
+from aiagent_runner.runner import Runner, run, run_async
+
+__all__ = ["RunnerConfig", "Runner", "run", "run_async", "__version__"]

aiagent_runner-0.1.1/src/aiagent_runner/__main__.py

@@ -0,0 +1,282 @@
+# src/aiagent_runner/__main__.py
+# Entry point for AI Agent PM Runner/Coordinator
+# Reference: docs/plan/PHASE3_PULL_ARCHITECTURE.md - Phase 3-5 (legacy Runner)
+# Reference: docs/plan/PHASE4_COORDINATOR_ARCHITECTURE.md (Coordinator)
+
+import argparse
+import logging
+import sys
+from pathlib import Path
+
+from aiagent_runner.config import RunnerConfig
+from aiagent_runner.coordinator import run_coordinator
+from aiagent_runner.coordinator_config import CoordinatorConfig
+from aiagent_runner.runner import run
+
+
+def setup_logging(verbose: bool = False) -> None:
+    """Configure logging.
+
+    Args:
+        verbose: If True, enable debug logging
+    """
+    level = logging.DEBUG if verbose else logging.INFO
+    logging.basicConfig(
+        level=level,
+        format="%(asctime)s [%(levelname)s] %(name)s: %(message)s",
+        datefmt="%Y-%m-%d %H:%M:%S"
+    )
+
+
+def parse_args() -> argparse.Namespace:
+    """Parse command line arguments.
+
+    Returns:
+        Parsed arguments
+    """
+    parser = argparse.ArgumentParser(
+        prog="aiagent-runner",
+        description="Runner/Coordinator for AI Agent PM - executes tasks via MCP and CLI"
+    )
+
+    # Mode selection
+    parser.add_argument(
+        "--coordinator",
+        action="store_true",
+        help="Run in Coordinator mode (Phase 4: single orchestrator for all agents)"
+    )
+
+    # Common arguments
+    parser.add_argument(
+        "-c", "--config",
+        type=Path,
+        help="Path to YAML configuration file"
+    )
+    parser.add_argument(
+        "-v", "--verbose",
+        action="store_true",
+        help="Enable verbose (debug) logging"
+    )
+
+    # Legacy Runner arguments (deprecated, use Coordinator mode instead)
+    parser.add_argument(
+        "--agent-id",
+        help="[Legacy Runner] Agent ID (overrides config/env)"
+    )
+    parser.add_argument(
+        "--passkey",
+        help="[Legacy Runner] Agent passkey (overrides config/env)"
+    )
+    parser.add_argument(
+        "--project-id",
+        help="[Legacy Runner] Project ID (Phase 4 required)"
+    )
+    parser.add_argument(
+        "--polling-interval",
+        type=int,
+        help="Polling interval in seconds (default: 5 for Runner, 10 for Coordinator)"
+    )
+    parser.add_argument(
+        "--cli-command",
+        help="[Legacy Runner] CLI command to use (default: claude)"
+    )
+    parser.add_argument(
+        "--working-directory",
+        type=Path,
+        help="[Legacy Runner] Working directory for CLI execution"
+    )
+    parser.add_argument(
+        "--log-directory",
+        type=Path,
+        help="Directory for execution logs"
+    )
+
+    return parser.parse_args()
+
+
+def load_runner_config(args: argparse.Namespace) -> RunnerConfig:
+    """Load configuration for legacy Runner mode.
+
+    Priority (highest to lowest):
+    1. CLI arguments
+    2. Config file
+    3. Environment variables
+
+    Args:
+        args: Parsed CLI arguments
+
+    Returns:
+        RunnerConfig instance
+    """
+    # Start with config file or environment
+    if args.config and args.config.exists():
+        config = RunnerConfig.from_yaml(args.config)
+    else:
+        try:
+            config = RunnerConfig.from_env()
+        except ValueError as e:
+            # If no config file and env vars missing, check CLI args
+            if args.agent_id and args.passkey and args.project_id:
+                config = RunnerConfig(
+                    agent_id=args.agent_id,
+                    passkey=args.passkey,
+                    project_id=args.project_id
+                )
+            else:
+                raise e
+
+    # Override with CLI arguments
+    if args.agent_id:
+        config.agent_id = args.agent_id
+    if args.passkey:
+        config.passkey = args.passkey
+    if args.project_id:
+        config.project_id = args.project_id
+    if args.polling_interval:
+        config.polling_interval = args.polling_interval
+    if args.cli_command:
+        config.cli_command = args.cli_command
+    if args.working_directory:
+        config.working_directory = str(args.working_directory)
+    if args.log_directory:
+        config.log_directory = str(args.log_directory)
+
+    return config
+
+
+def get_default_config_path() -> Path:
+    """Get the default configuration file path.
+
+    The default config is located at:
+    runner/config/coordinator_default.yaml
+
+    Returns:
+        Path to default config file
+    """
+    # Find the runner package root (where config/ directory is)
+    # __file__ is runner/src/aiagent_runner/__main__.py
+    # parent = runner/src/aiagent_runner/
+    # parent.parent = runner/src/
+    # parent.parent.parent = runner/
+    runner_root = Path(__file__).parent.parent.parent
+    return runner_root / "config" / "coordinator_default.yaml"
+
+
+def load_coordinator_config(args: argparse.Namespace) -> CoordinatorConfig:
+    """Load configuration for Coordinator mode.
+
+    Configuration loading priority:
+    1. User-specified config file (-c/--config) - full override
+    2. Default config file (runner/config/coordinator_default.yaml)
+
+    Note: When using default config, agents must be configured via
+    environment variables or a separate config file.
+
+    Args:
+        args: Parsed CLI arguments
+
+    Returns:
+        CoordinatorConfig instance
+    """
+    logger = logging.getLogger(__name__)
+
+    if args.config and args.config.exists():
+        # User specified a config file - use it directly
+        logger.info(f"Loading config from: {args.config}")
+        config = CoordinatorConfig.from_yaml(args.config)
+    else:
+        # Try to load default config
+        default_config_path = get_default_config_path()
+        if default_config_path.exists():
+            logger.info(f"Loading default config from: {default_config_path}")
+            config = CoordinatorConfig.from_yaml(default_config_path)
+        else:
+            # No config available - use built-in defaults
+            logger.warning(
+                "No config file found. Using built-in defaults.\n"
+                f"Expected default config at: {default_config_path}\n"
+                "Note: Agents must be configured to run tasks."
+            )
+            config = CoordinatorConfig()
+
+    # Override with CLI arguments
+    if args.polling_interval:
+        config.polling_interval = args.polling_interval
+    if args.log_directory:
+        config.log_directory = str(args.log_directory)
+
+    return config
+
+
+def main() -> int:
+    """Main entry point.
+
+    Returns:
+        Exit code (0 for success)
+    """
+    args = parse_args()
+    setup_logging(args.verbose)
+
+    logger = logging.getLogger(__name__)
+
+    if args.coordinator:
+        # Phase 4: Coordinator mode
+        logger.info("Running in Coordinator mode (Phase 4)")
+        try:
+            config = load_coordinator_config(args)
+        except ValueError as e:
+            logger.error(f"Configuration error: {e}")
+            print(f"Error: {e}", file=sys.stderr)
+            return 1
+
+        logger.info(f"Configured agents: {list(config.agents.keys())}")
+        logger.info(f"Polling interval: {config.polling_interval}s")
+        logger.info(f"Max concurrent: {config.max_concurrent}")
+
+        try:
+            run_coordinator(config)
+        except KeyboardInterrupt:
+            logger.info("Coordinator stopped by user")
+            return 0
+        except Exception as e:
+            logger.exception(f"Coordinator failed: {e}")
+            return 1
+    else:
+        # Legacy Runner mode (deprecated)
+        logger.warning(
+            "Running in legacy Runner mode. "
+            "Consider using --coordinator mode for Phase 4 architecture."
+        )
+        try:
+            config = load_runner_config(args)
+        except ValueError as e:
+            logger.error(f"Configuration error: {e}")
+            print(f"Error: {e}", file=sys.stderr)
+            print(
+                "\nProvide configuration via:\n"
+                "  1. YAML config file (-c/--config)\n"
+                "  2. Environment variables (AGENT_ID, AGENT_PASSKEY, PROJECT_ID)\n"
+                "  3. CLI arguments (--agent-id, --passkey, --project-id)",
+                file=sys.stderr
+            )
+            return 1
+
+        logger.info(f"Starting runner for agent: {config.agent_id}")
+        logger.info(f"Project: {config.project_id}")
+        logger.info(f"CLI command: {config.cli_command}")
+        logger.info(f"Polling interval: {config.polling_interval}s")
+
+        try:
+            run(config)
+        except KeyboardInterrupt:
+            logger.info("Runner stopped by user")
+            return 0
+        except Exception as e:
+            logger.exception(f"Runner failed: {e}")
+            return 1
+
+    return 0
+
+
+if __name__ == "__main__":
+    sys.exit(main())