email-cli-tool 0.3.0__tar.gz → 0.3.1__tar.gz

{email_cli_tool-0.3.0 → email_cli_tool-0.3.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: email-cli-tool
-Version: 0.3.0
+Version: 0.3.1
 Summary: A simple CLI tool for sending emails with plain text, HTML, and file attachments
 Project-URL: Homepage, https://github.com/ClaymanTwinkle/email-cli-tool
 Project-URL: Repository, https://github.com/ClaymanTwinkle/email-cli-tool
@@ -158,7 +158,7 @@ Display current configuration (password is masked).
 
 ### `emailcli skill install`
 
-Install the `send-email` agent skill so Claude Code or Codex can send mail for you.
+Install the `send-email` and `wait-email` agent skills so Claude Code or Codex can send and receive mail for you.
 
 ```bash
 # Install for both Claude Code and Codex (default)
@@ -169,7 +169,7 @@ emailcli skill install --target claude
 emailcli skill install --target codex
 ```
 
-Writes `SKILL.md` to `~/.claude/skills/send-email/` and/or `~/.codex/skills/send-email/`.
+Writes each skill's `SKILL.md` under `~/.claude/skills/` and/or `~/.codex/skills/`.
 
 ## Configuration
 

{email_cli_tool-0.3.0 → email_cli_tool-0.3.1}/README.md

@@ -132,7 +132,7 @@ Display current configuration (password is masked).
 
 ### `emailcli skill install`
 
-Install the `send-email` agent skill so Claude Code or Codex can send mail for you.
+Install the `send-email` and `wait-email` agent skills so Claude Code or Codex can send and receive mail for you.
 
 ```bash
 # Install for both Claude Code and Codex (default)
@@ -143,7 +143,7 @@ emailcli skill install --target claude
 emailcli skill install --target codex
 ```
 
-Writes `SKILL.md` to `~/.claude/skills/send-email/` and/or `~/.codex/skills/send-email/`.
+Writes each skill's `SKILL.md` under `~/.claude/skills/` and/or `~/.codex/skills/`.
 
 ## Configuration
 

{email_cli_tool-0.3.0 → email_cli_tool-0.3.1}/README_CN.md

@@ -132,7 +132,7 @@ emailcli watch --timeout 300 --save-attachments ./downloads
 
 ### `emailcli skill install`
 
-安装 `send-email` 技能，让 Claude Code 或 Codex 可以直接帮你发邮件。
+安装 `send-email` 和 `wait-email` 技能，让 Claude Code 或 Codex 可以直接帮你收发邮件。
 
 ```bash
 # 默认同时安装到 Claude Code 和 Codex
@@ -143,7 +143,7 @@ emailcli skill install --target claude
 emailcli skill install --target codex
 ```
 
-会把 `SKILL.md` 写入 `~/.claude/skills/send-email/` 和/或 `~/.codex/skills/send-email/`。
+会把各技能的 `SKILL.md` 写入 `~/.claude/skills/` 和/或 `~/.codex/skills/` 下的同名目录。
 
 ## 配置文件
 

{email_cli_tool-0.3.0 → email_cli_tool-0.3.1}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "email-cli-tool"
-version = "0.3.0"
+version = "0.3.1"
 description = "A simple CLI tool for sending emails with plain text, HTML, and file attachments"
 readme = "README.md"
 license = "MIT"

{email_cli_tool-0.3.0 → email_cli_tool-0.3.1}/src/emailcli/cli.py

@@ -252,7 +252,7 @@ def skill_group():
 )
 @click.option("--home", default=None, type=click.Path(), hidden=True, help="Home directory (for testing).")
 def install(target, home):
-    """Install the send-email skill into Claude Code and/or Codex."""
+    """Install the emailcli agent skills into Claude Code and/or Codex."""
     home_dir = Path(home) if home else Path.home()
     targets = ["claude", "codex"] if target == "all" else [target]
 

email_cli_tool-0.3.1/src/emailcli/skill_install.py

@@ -0,0 +1,71 @@
+from dataclasses import dataclass
+from importlib.resources import files
+from pathlib import Path
+from typing import Literal
+
+SKILL_NAMES = ["send-email", "wait-email"]
+
+# target name -> home subdirectory that holds the agent's skills
+TARGET_HOME_DIRS = {
+    "claude": ".claude",
+    "codex": ".codex",
+}
+
+# human-facing label per target
+TARGET_LABELS = {
+    "claude": "Claude",
+    "codex": "Codex",
+}
+
+
+def load_skill_content(skill_name: str) -> str:
+    """Read a bundled SKILL.md shipped as package data."""
+    return (
+        files("emailcli")
+        .joinpath(f"skills/{skill_name}/SKILL.md")
+        .read_text(encoding="utf-8")
+    )
+
+
+def skill_dest(home: Path, target: str, skill_name: str) -> Path:
+    """Destination SKILL.md path for a target under the given home dir."""
+    return home / TARGET_HOME_DIRS[target] / "skills" / skill_name / "SKILL.md"
+
+
+@dataclass
+class InstallResult:
+    target: str
+    skill: str
+    path: Path
+    status: Literal["created", "updated", "failed"]
+    error: str | None = None
+
+
+def install_skill(home: Path, targets: list[str]) -> list[InstallResult]:
+    """Write the bundled skills into each target's user-level skills dir.
+
+    Each (target, skill) pair is handled independently; a write failure on
+    one does not stop the others.
+    """
+    unknown = [t for t in targets if t not in TARGET_HOME_DIRS]
+    if unknown:
+        raise ValueError(f"Unknown target(s): {', '.join(unknown)}")
+    contents = {name: load_skill_content(name) for name in SKILL_NAMES}
+    results: list[InstallResult] = []
+    for target in targets:
+        for skill_name in SKILL_NAMES:
+            dest = skill_dest(home, target, skill_name)
+            try:
+                existed = dest.exists()
+                dest.parent.mkdir(parents=True, exist_ok=True)
+                dest.write_text(contents[skill_name], encoding="utf-8")
+                results.append(
+                    InstallResult(
+                        target, skill_name, dest, "updated" if existed else "created"
+                    )
+                )
+            except OSError as exc:
+                results.append(
+                    InstallResult(target, skill_name, dest, "failed", str(exc))
+                )
+    return results

email_cli_tool-0.3.1/src/emailcli/skills/wait-email/SKILL.md

@@ -0,0 +1,60 @@
+---
+name: wait-email
+description: "Wait for the next incoming email via emailcli. Prints sender/subject/body and downloads attachments. Use when the user wants to wait for, receive, or read an incoming email."
+---
+
+# Wait for Email
+
+Wait for the next incoming email from Claude Code using the `emailcli watch` command.
+
+## Usage
+
+Invoke with `/wait-email` followed by natural language describing what to wait for:
+
+```
+/wait-email 等下一封新邮件
+/wait-email 等 5 分钟，附件存到 ./downloads
+/wait-email 等一封验证码邮件，把验证码读出来
+```
+
+## Workflow
+
+### 1. Parse user intent
+
+Extract from the user's message:
+- **Timeout** (`--timeout`): seconds to wait. Default to 300 if the user gives no limit; use 0 (wait forever) only if the user explicitly asks to wait indefinitely.
+- **Attachment directory** (`--save-attachments`): where to save attachments, if the user mentions them.
+- **Mailbox** (`--mailbox`): defaults to INBOX.
+
+### 2. Run the command
+
+```bash
+emailcli watch --timeout 300 --save-attachments ./downloads
+```
+
+- The command blocks until an email arrives, so set the Bash tool timeout comfortably larger than `--timeout` (or run it in the background for long waits).
+- Headers and body go to stdout; progress messages and saved-attachment paths go to stderr.
+- Only emails arriving **after** the command starts are matched; existing unread mail is ignored.
+
+### 3. Report result
+
+By exit code:
+- **0** — email received: report From / Subject / Date, the body (or the specific detail the user asked for, e.g. a verification code), and any saved attachment paths.
+- **2** — timed out with no new email: tell the user.
+- **1** — error: show the message. If it says IMAP settings are missing, tell the user to re-run `emailcli init` or add an `imap:` section to `~/.emailcli/config.yaml`.
+
+## Command Reference
+
+```bash
+emailcli watch \
+  [--timeout SECONDS]        # 0 = wait forever
+  [--poll-interval SECONDS]  # default: 10
+  [--save-attachments DIR] \
+  [--mailbox NAME]           # default: INBOX
+```
+
+## Important
+
+- Requires email-cli-tool **0.3.0+** with IMAP configured (`emailcli init`).
+- The received email is marked as read on the server.
+- Do NOT ask for confirmation — start waiting once inputs are clear, and tell the user you are waiting.

{email_cli_tool-0.3.0 → email_cli_tool-0.3.1}/tests/test_skill_install.py

@@ -5,26 +5,38 @@ import pytest
 from click.testing import CliRunner
 
 from emailcli.cli import cli
-from emailcli.skill_install import InstallResult, install_skill, load_skill_content
+from emailcli.skill_install import (
+    SKILL_NAMES,
+    InstallResult,
+    install_skill,
+    load_skill_content,
+)
 
 
-def test_bundled_skill_md_is_packaged():
+def test_bundled_send_email_skill_is_packaged():
     content = files("emailcli").joinpath("skills/send-email/SKILL.md").read_text(encoding="utf-8")
     assert content.startswith("---")
     assert "name: send-email" in content
     assert "emailcli send" in content
 
 
+def test_bundled_wait_email_skill_is_packaged():
+    content = files("emailcli").joinpath("skills/wait-email/SKILL.md").read_text(encoding="utf-8")
+    assert content.startswith("---")
+    assert "name: wait-email" in content
+    assert "emailcli watch" in content
+
+
 def test_install_all_writes_both_targets(tmp_path):
     results = install_skill(tmp_path, ["claude", "codex"])
 
-    claude_path = tmp_path / ".claude" / "skills" / "send-email" / "SKILL.md"
-    codex_path = tmp_path / ".codex" / "skills" / "send-email" / "SKILL.md"
-    bundled = load_skill_content()
-
-    assert claude_path.read_text(encoding="utf-8") == bundled
-    assert codex_path.read_text(encoding="utf-8") == bundled
-    assert {r.target for r in results} == {"claude", "codex"}
+    for target_dir in (".claude", ".codex"):
+        for skill in SKILL_NAMES:
+            path = tmp_path / target_dir / "skills" / skill / "SKILL.md"
+            assert path.read_text(encoding="utf-8") == load_skill_content(skill)
+    assert {(r.target, r.skill) for r in results} == {
+        (t, s) for t in ("claude", "codex") for s in SKILL_NAMES
+    }
     assert all(r.status == "created" for r in results)
 
 
@@ -32,6 +44,7 @@ def test_install_claude_only(tmp_path):
     install_skill(tmp_path, ["claude"])
 
     assert (tmp_path / ".claude" / "skills" / "send-email" / "SKILL.md").exists()
+    assert (tmp_path / ".claude" / "skills" / "wait-email" / "SKILL.md").exists()
     assert not (tmp_path / ".codex").exists()
 
 
@@ -39,9 +52,9 @@ def test_install_is_idempotent(tmp_path):
     install_skill(tmp_path, ["claude"])
     results = install_skill(tmp_path, ["claude"])
 
-    assert results[0].status == "updated"
+    assert all(r.status == "updated" for r in results)
     path = tmp_path / ".claude" / "skills" / "send-email" / "SKILL.md"
-    assert path.read_text(encoding="utf-8") == load_skill_content()
+    assert path.read_text(encoding="utf-8") == load_skill_content("send-email")
 
 
 def test_install_unknown_target_raises(tmp_path):
@@ -54,8 +67,9 @@ def test_cli_skill_install_default_writes_both(tmp_path):
     result = runner.invoke(cli, ["skill", "install", "--home", str(tmp_path)])
 
     assert result.exit_code == 0
-    assert (tmp_path / ".claude" / "skills" / "send-email" / "SKILL.md").exists()
-    assert (tmp_path / ".codex" / "skills" / "send-email" / "SKILL.md").exists()
+    for target_dir in (".claude", ".codex"):
+        for skill in SKILL_NAMES:
+            assert (tmp_path / target_dir / "skills" / skill / "SKILL.md").exists()
     assert "Claude" in result.output
     assert "Codex" in result.output
 
@@ -68,6 +82,7 @@ def test_cli_skill_install_target_codex(tmp_path):
 
     assert result.exit_code == 0
     assert (tmp_path / ".codex" / "skills" / "send-email" / "SKILL.md").exists()
+    assert (tmp_path / ".codex" / "skills" / "wait-email" / "SKILL.md").exists()
     assert not (tmp_path / ".claude").exists()
 
 
@@ -81,7 +96,7 @@ def test_cli_skill_install_invalid_target(tmp_path):
 
 
 def test_cli_skill_install_failure_exit_code(tmp_path):
-    failed = [InstallResult("claude", tmp_path / "SKILL.md", "failed", "boom")]
+    failed = [InstallResult("claude", "send-email", tmp_path / "SKILL.md", "failed", "boom")]
     runner = CliRunner()
     with patch("emailcli.skill_install.install_skill", return_value=failed):
         result = runner.invoke(cli, ["skill", "install", "--home", str(tmp_path)])

email_cli_tool-0.3.0/src/emailcli/skill_install.py

@@ -1,65 +0,0 @@
-from dataclasses import dataclass
-from importlib.resources import files
-from pathlib import Path
-from typing import Literal
-
-SKILL_NAME = "send-email"
-
-# target name -> home subdirectory that holds the agent's skills
-TARGET_HOME_DIRS = {
-    "claude": ".claude",
-    "codex": ".codex",
-}
-
-# human-facing label per target
-TARGET_LABELS = {
-    "claude": "Claude",
-    "codex": "Codex",
-}
-
-
-def load_skill_content() -> str:
-    """Read the bundled SKILL.md shipped as package data."""
-    return (
-        files("emailcli")
-        .joinpath(f"skills/{SKILL_NAME}/SKILL.md")
-        .read_text(encoding="utf-8")
-    )
-
-
-def skill_dest(home: Path, target: str) -> Path:
-    """Destination SKILL.md path for a target under the given home dir."""
-    return home / TARGET_HOME_DIRS[target] / "skills" / SKILL_NAME / "SKILL.md"
-
-
-@dataclass
-class InstallResult:
-    target: str
-    path: Path
-    status: Literal["created", "updated", "failed"]
-    error: str | None = None
-
-
-def install_skill(home: Path, targets: list[str]) -> list[InstallResult]:
-    """Write the bundled skill into each target's user-level skills dir.
-
-    Each target is handled independently; a write failure on one target is
-    recorded and does not stop the others.
-    """
-    unknown = [t for t in targets if t not in TARGET_HOME_DIRS]
-    if unknown:
-        raise ValueError(f"Unknown target(s): {', '.join(unknown)}")
-    content = load_skill_content()
-    results: list[InstallResult] = []
-    for target in targets:
-        dest = skill_dest(home, target)
-        try:
-            existed = dest.exists()
-            dest.parent.mkdir(parents=True, exist_ok=True)
-            dest.write_text(content, encoding="utf-8")
-            results.append(
-                InstallResult(target, dest, "updated" if existed else "created")
-            )
-        except OSError as exc:
-            results.append(InstallResult(target, dest, "failed", str(exc)))
-    return results