synapse-a2a 0.2.15__tar.gz → 0.2.19__tar.gz

{synapse_a2a-0.2.15/synapse_a2a.egg-info → synapse_a2a-0.2.19}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: synapse-a2a
-Version: 0.2.15
+Version: 0.2.19
 Summary: Agent-to-Agent communication protocol for CLI agents
 Author: Synapse A2A Team
 License: MIT
@@ -11,6 +11,7 @@ Requires-Dist: uvicorn>=0.23.0
 Requires-Dist: pyyaml>=6.0
 Requires-Dist: requests>=2.31.0
 Requires-Dist: httpx>=0.24.0
+Requires-Dist: questionary>=2.0.0
 
 # Synapse A2A
 
@@ -464,6 +465,8 @@ synapse claude -- --resume
 | `synapse file-safety record`      | 変更を手動記録         |
 | `synapse file-safety cleanup`     | 古いデータ削除         |
 | `synapse file-safety debug`       | デバッグ情報表示       |
+| `synapse config`                  | 設定管理（インタラクティブTUI） |
+| `synapse config show`             | 現在の設定表示         |
 
 ### コンテキストの再開 (Resume Mode)
 
@@ -664,32 +667,49 @@ synapse history cleanup --days 30 --dry-run
 エージェント間通信には `synapse send` コマンドを使用してください。サンドボックス環境でも動作します。
 
 ```bash
-synapse send <target> "<message>" [--from <sender>] [--priority <1-5>] [--response | --no-response]
+synapse send <target> "<message>" [--from <sender>] [--priority <1-5>] [--response | --no-response] [--reply-to <task_id>]
 ```
 
+**ターゲット指定方法:**
+
+| 形式 | 例 | 説明 |
+|-----|---|------|
+| エージェントタイプ | `claude` | 単一インスタンスの場合のみ有効 |
+| タイプ-ポート | `claude-8100` | 同タイプが複数ある場合の指定 |
+| フルID | `synapse-claude-8100` | 完全なエージェントID |
+
+同じタイプのエージェントが複数起動している場合、タイプのみの指定（例: `claude`）はエラーになります。`claude-8100` や `synapse-claude-8100` のように特定のインスタンスを指定してください。
+
 **オプション:**
 
 | オプション | 短縮形 | 説明 |
 |-----------|--------|------|
 | `--from` | `-f` | 送信元エージェントID（返信識別用） |
 | `--priority` | `-p` | 優先度 1-4: 通常、5: 緊急停止（SIGINT送信） |
-| `--response` | - | レスポンスを待つ |
-| `--no-response` | - | レスポンスを待たない（デフォルト） |
+| `--response` | - | Roundtrip - 送信側が待機、受信側は `--reply-to` で返信必須 |
+| `--no-response` | - | Oneway - 送りっぱなし、返信不要（デフォルト） |
+| `--reply-to` | - | 特定タスクIDへの返信（`--response` への返信時に使用） |
 
 **例:**
 
 ```bash
-# メッセージ送信
+# メッセージ送信（単一インスタンス）
 synapse send claude "Hello" --priority 1 --from codex
 
+# 特定インスタンスへ送信（同タイプが複数の場合）
+synapse send claude-8100 "Hello" --from synapse-claude-8101
+
 # 緊急停止
 synapse send claude "Stop!" --priority 5 --from codex
 
-# レスポンスを待つ
+# レスポンスを待つ（roundtrip）
 synapse send gemini "分析して" --response --from claude
+
+# --response への返信（task_idは [A2A:task_id:sender] から取得）
+synapse send claude "分析結果です..." --reply-to abc123 --from gemini
 ```
 
-**重要:** `--from` オプションで送信元を指定してください。受信側が返信先を特定できます。
+**重要:** `--from` オプションで送信元を指定してください。`--response` への返信時は `--reply-to <task_id>` を使用して返信を紐付けます。
 
 ### 低レベル A2A ツール
 
@@ -1136,6 +1156,27 @@ synapse init
 
 # デフォルトに戻す
 synapse reset
+
+# 設定をインタラクティブに編集（TUI）
+synapse config
+
+# ? Which settings file do you want to edit?
+#   ❯ User settings (~/.synapse/settings.json)
+#     Project settings (./.synapse/settings.json)
+#
+# ? Select a category to configure:
+#   ❯ Environment Variables
+#     Instructions
+#     A2A Protocol
+#     Delegation
+#     Resume Flags
+#     ──────────────
+#     Save and exit
+#     Exit without saving
+
+# 現在の設定を表示（読み取り専用）
+synapse config show
+synapse config show --scope user
 ```
 
 `synapse init` は以下のファイルを `.synapse/` ディレクトリにコピーします：

synapse_a2a-0.2.15/PKG-INFO → synapse_a2a-0.2.19/README.md

@@ -1,17 +1,3 @@
-Metadata-Version: 2.4
-Name: synapse-a2a
-Version: 0.2.15
-Summary: Agent-to-Agent communication protocol for CLI agents
-Author: Synapse A2A Team
-License: MIT
-Requires-Python: >=3.10
-Description-Content-Type: text/markdown
-Requires-Dist: fastapi>=0.100.0
-Requires-Dist: uvicorn>=0.23.0
-Requires-Dist: pyyaml>=6.0
-Requires-Dist: requests>=2.31.0
-Requires-Dist: httpx>=0.24.0
-
 # Synapse A2A
 
 > **各エージェントの挙動を変えることなく、エージェント同士を協力させてタスクを実行する**
@@ -464,6 +450,8 @@ synapse claude -- --resume
 | `synapse file-safety record`      | 変更を手動記録         |
 | `synapse file-safety cleanup`     | 古いデータ削除         |
 | `synapse file-safety debug`       | デバッグ情報表示       |
+| `synapse config`                  | 設定管理（インタラクティブTUI） |
+| `synapse config show`             | 現在の設定表示         |
 
 ### コンテキストの再開 (Resume Mode)
 
@@ -664,32 +652,49 @@ synapse history cleanup --days 30 --dry-run
 エージェント間通信には `synapse send` コマンドを使用してください。サンドボックス環境でも動作します。
 
 ```bash
-synapse send <target> "<message>" [--from <sender>] [--priority <1-5>] [--response | --no-response]
+synapse send <target> "<message>" [--from <sender>] [--priority <1-5>] [--response | --no-response] [--reply-to <task_id>]
 ```
 
+**ターゲット指定方法:**
+
+| 形式 | 例 | 説明 |
+|-----|---|------|
+| エージェントタイプ | `claude` | 単一インスタンスの場合のみ有効 |
+| タイプ-ポート | `claude-8100` | 同タイプが複数ある場合の指定 |
+| フルID | `synapse-claude-8100` | 完全なエージェントID |
+
+同じタイプのエージェントが複数起動している場合、タイプのみの指定（例: `claude`）はエラーになります。`claude-8100` や `synapse-claude-8100` のように特定のインスタンスを指定してください。
+
 **オプション:**
 
 | オプション | 短縮形 | 説明 |
 |-----------|--------|------|
 | `--from` | `-f` | 送信元エージェントID（返信識別用） |
 | `--priority` | `-p` | 優先度 1-4: 通常、5: 緊急停止（SIGINT送信） |
-| `--response` | - | レスポンスを待つ |
-| `--no-response` | - | レスポンスを待たない（デフォルト） |
+| `--response` | - | Roundtrip - 送信側が待機、受信側は `--reply-to` で返信必須 |
+| `--no-response` | - | Oneway - 送りっぱなし、返信不要（デフォルト） |
+| `--reply-to` | - | 特定タスクIDへの返信（`--response` への返信時に使用） |
 
 **例:**
 
 ```bash
-# メッセージ送信
+# メッセージ送信（単一インスタンス）
 synapse send claude "Hello" --priority 1 --from codex
 
+# 特定インスタンスへ送信（同タイプが複数の場合）
+synapse send claude-8100 "Hello" --from synapse-claude-8101
+
 # 緊急停止
 synapse send claude "Stop!" --priority 5 --from codex
 
-# レスポンスを待つ
+# レスポンスを待つ（roundtrip）
 synapse send gemini "分析して" --response --from claude
+
+# --response への返信（task_idは [A2A:task_id:sender] から取得）
+synapse send claude "分析結果です..." --reply-to abc123 --from gemini
 ```
 
-**重要:** `--from` オプションで送信元を指定してください。受信側が返信先を特定できます。
+**重要:** `--from` オプションで送信元を指定してください。`--response` への返信時は `--reply-to <task_id>` を使用して返信を紐付けます。
 
 ### 低レベル A2A ツール
 
@@ -1136,6 +1141,27 @@ synapse init
 
 # デフォルトに戻す
 synapse reset
+
+# 設定をインタラクティブに編集（TUI）
+synapse config
+
+# ? Which settings file do you want to edit?
+#   ❯ User settings (~/.synapse/settings.json)
+#     Project settings (./.synapse/settings.json)
+#
+# ? Select a category to configure:
+#   ❯ Environment Variables
+#     Instructions
+#     A2A Protocol
+#     Delegation
+#     Resume Flags
+#     ──────────────
+#     Save and exit
+#     Exit without saving
+
+# 現在の設定を表示（読み取り専用）
+synapse config show
+synapse config show --scope user
 ```
 
 `synapse init` は以下のファイルを `.synapse/` ディレクトリにコピーします：

{synapse_a2a-0.2.15 → synapse_a2a-0.2.19}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "synapse-a2a"
-version = "0.2.15"
+version = "0.2.19"
 description = "Agent-to-Agent communication protocol for CLI agents"
 readme = "README.md"
 requires-python = ">=3.10"
@@ -18,6 +18,7 @@ dependencies = [
     "pyyaml>=6.0",
     "requests>=2.31.0",
     "httpx>=0.24.0",
+    "questionary>=2.0.0",
 ]
 
 [dependency-groups]

{synapse_a2a-0.2.15 → synapse_a2a-0.2.19}/synapse/cli.py

@@ -680,10 +680,53 @@ def cmd_file_safety_locks(args: argparse.Namespace) -> None:
         print("Run 'synapse file-safety cleanup-locks' to clean them up.")
 
 
+def _resolve_agent_info(
+    agent_name: str,
+) -> tuple[str, str | None, int | None]:
+    """Resolve agent name to (agent_id, agent_type, pid).
+
+    Lookup order:
+    1. Exact match by agent_id in registry
+    2. Match by agent_type (short name like "claude") in live agents
+    3. Parse agent_type from agent_id format "synapse-{type}-{port}"
+
+    Returns:
+        Tuple of (agent_id, agent_type, pid). agent_type and pid may be None.
+    """
+    from synapse.registry import AgentRegistry
+
+    agent_id = agent_name
+    agent_type = None
+    pid = None
+
+    with contextlib.suppress(Exception):
+        registry = AgentRegistry()
+        agent_info = registry.get_agent(agent_id)
+
+        # Try to find by agent_type if exact match fails
+        if not agent_info:
+            for aid, info in registry.get_live_agents().items():
+                if info.get("agent_type") == agent_id:
+                    agent_info = info
+                    agent_id = aid
+                    break
+
+        if agent_info:
+            pid = agent_info.get("pid")
+            agent_type = agent_info.get("agent_type")
+
+    # Fallback: extract agent_type from agent_id format "synapse-{type}-{port}"
+    if not agent_type and agent_id.startswith("synapse-"):
+        parts = agent_id.split("-")
+        if len(parts) >= 3:
+            agent_type = parts[1]
+
+    return agent_id, agent_type, pid
+
+
 def cmd_file_safety_lock(args: argparse.Namespace) -> None:
     """Acquire a lock on a file."""
     from synapse.file_safety import FileSafetyManager, LockStatus
-    from synapse.registry import AgentRegistry
 
     manager = FileSafetyManager.from_env()
 
@@ -691,18 +734,12 @@ def cmd_file_safety_lock(args: argparse.Namespace) -> None:
         print("File safety is disabled. Enable with: SYNAPSE_FILE_SAFETY_ENABLED=true")
         return
 
-    pid = None
-    try:
-        registry = AgentRegistry()
-        agent_info = registry.get_agent(args.agent)
-        if agent_info:
-            pid = agent_info.get("pid")
-    except Exception:
-        pid = None
+    agent_id, agent_type, pid = _resolve_agent_info(args.agent)
 
     result = manager.acquire_lock(
         file_path=args.file,
-        agent_name=args.agent,
+        agent_id=agent_id,
+        agent_type=agent_type,
         task_id=args.task_id if hasattr(args, "task_id") else None,
         duration_seconds=args.duration if hasattr(args, "duration") else None,
         intent=args.intent if hasattr(args, "intent") else None,
@@ -1435,6 +1472,25 @@ def cmd_reset(args: argparse.Namespace) -> None:
             print(f"✔ Re-copied skill to {installed_path}")
 
 
+def cmd_config(args: argparse.Namespace) -> None:
+    """Interactive configuration management."""
+    from synapse.commands.config import ConfigCommand
+
+    cmd = ConfigCommand()
+    scope = getattr(args, "scope", None)
+
+    cmd.run(scope=scope)
+
+
+def cmd_config_show(args: argparse.Namespace) -> None:
+    """Show current settings."""
+    from synapse.commands.config import ConfigCommand
+
+    cmd = ConfigCommand()
+    scope = getattr(args, "scope", None)
+    cmd.show(scope=scope)
+
+
 def cmd_auth_setup(args: argparse.Namespace) -> None:
     """Generate API keys and show setup instructions."""
     api_key = generate_api_key()
@@ -2205,6 +2261,45 @@ Also re-copies skills from .claude to .codex.""",
     )
     p_reset.set_defaults(func=cmd_reset)
 
+    # config - Interactive settings management
+    p_config = subparsers.add_parser(
+        "config",
+        help="Interactive settings management",
+        description="""Interactively configure Synapse settings using a TUI.
+
+Opens an interactive menu to browse and modify settings in .synapse/settings.json.""",
+        formatter_class=argparse.RawDescriptionHelpFormatter,
+        epilog="""Examples:
+  synapse config                  Interactive mode (prompts for scope)
+  synapse config --scope user     Edit user settings directly
+  synapse config --scope project  Edit project settings directly
+  synapse config show             Show merged settings (read-only)
+  synapse config show --scope user  Show user settings only""",
+    )
+    p_config.add_argument(
+        "--scope",
+        choices=["user", "project"],
+        help="Settings scope to edit (user or project)",
+    )
+    p_config.set_defaults(func=cmd_config)
+
+    # config subcommands
+    config_subparsers = p_config.add_subparsers(
+        dest="config_command", metavar="SUBCOMMAND"
+    )
+
+    # config show
+    p_config_show = config_subparsers.add_parser(
+        "show", help="Show current settings (read-only)"
+    )
+    p_config_show.add_argument(
+        "--scope",
+        choices=["user", "project", "merged"],
+        default="merged",
+        help="Settings scope to display (default: merged)",
+    )
+    p_config_show.set_defaults(func=cmd_config_show)
+
     # file-safety - File locking and modification tracking
     p_file_safety = subparsers.add_parser(
         "file-safety",