walla-cli 0.1.0__tar.gz → 0.1.2__tar.gz

{walla_cli-0.1.0 → walla_cli-0.1.2}/AGENTS.md

@@ -21,7 +21,7 @@ pytest -q -m "not live"
 ## Calling walla from an agent
 
 ```bash
-pipx install 'walla-cli[mcp]'
+pipx install 'walla-cli[mcp]'   # PyPI preferred
 walla instruct --json
 walla setup --lat 41.39 --lon 2.17 --km 30 --label Barcelona --json
 walla login --cookie '<session-token>' --json

{walla_cli-0.1.0 → walla_cli-0.1.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: walla-cli
-Version: 0.1.0
+Version: 0.1.2
 Summary: Wallapop.es CLI - look · offer · talk for humans and agents
 Project-URL: Homepage, https://github.com/berendgort/wallapop-cli
 Project-URL: Repository, https://github.com/berendgort/wallapop-cli
@@ -106,11 +106,11 @@ Link listings as `https://es.wallapop.com/item/<web_slug>`. Verdicts:
 
 ### Bootstrap
 
-1. Install from this clone:
+1. Install from **PyPI** (preferred):
    ```bash
-pipx install 'walla-cli[mcp]'
-# from clone: pipx install -e '.[mcp]'
-```
+   pipx install 'walla-cli[mcp]'
+   ```
+   From a clone only when hacking: `pipx install -e '.[mcp]'`.
 2. `walla doctor --json` — read `auth.session` and `network.reachable`.
    **Never** print tokens or cookies.
 3. If no session: ask the human to run `walla login` and paste
@@ -151,9 +151,7 @@ Rules:
 ## Install
 
 ```bash
-git clone git@github.com:berendgort/wallapop-cli.git
-cd wallapop-cli
-pipx install 'walla-cli[mcp]'   # or: pipx install -e '.[mcp]'
+pipx install 'walla-cli[mcp]'   # PyPI: https://pypi.org/project/walla-cli/
 walla setup --lat 41.39 --lon 2.17 --km 30 --label Barcelona --json
 walla login          # paste __Secure-next-auth.session-token
 walla doctor --json

{walla_cli-0.1.0 → walla_cli-0.1.2}/README.md

@@ -62,11 +62,11 @@ Link listings as `https://es.wallapop.com/item/<web_slug>`. Verdicts:
 
 ### Bootstrap
 
-1. Install from this clone:
+1. Install from **PyPI** (preferred):
    ```bash
-pipx install 'walla-cli[mcp]'
-# from clone: pipx install -e '.[mcp]'
-```
+   pipx install 'walla-cli[mcp]'
+   ```
+   From a clone only when hacking: `pipx install -e '.[mcp]'`.
 2. `walla doctor --json` — read `auth.session` and `network.reachable`.
    **Never** print tokens or cookies.
 3. If no session: ask the human to run `walla login` and paste
@@ -107,9 +107,7 @@ Rules:
 ## Install
 
 ```bash
-git clone git@github.com:berendgort/wallapop-cli.git
-cd wallapop-cli
-pipx install 'walla-cli[mcp]'   # or: pipx install -e '.[mcp]'
+pipx install 'walla-cli[mcp]'   # PyPI: https://pypi.org/project/walla-cli/
 walla setup --lat 41.39 --lon 2.17 --km 30 --label Barcelona --json
 walla login          # paste __Secure-next-auth.session-token
 walla doctor --json

{walla_cli-0.1.0 → walla_cli-0.1.2}/docs/mcp.md

@@ -3,7 +3,7 @@
 Optional FastMCP adapter over the same core as the CLI.
 
 ```bash
-pipx install -e '.[mcp]'
+pipx install 'walla-cli[mcp]'
 walla-mcp          # STDIO
 walla-mcp-http     # http://127.0.0.1:8000/mcp/
 ```

{walla_cli-0.1.0 → walla_cli-0.1.2}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "walla-cli"
-version = "0.1.0"
+version = "0.1.2"
 description = "Wallapop.es CLI - look · offer · talk for humans and agents"
 authors = [{ name = "Dr. Berend Gort", email = "berend.gort@gmail.com" }]
 readme = "README.md"

{walla_cli-0.1.0 → walla_cli-0.1.2}/skills/walla/SKILL.md

@@ -13,7 +13,7 @@ license: MIT
 ## Bootstrap
 
 ```bash
-pipx install 'walla-cli[mcp]'
+pipx install 'walla-cli[mcp]'   # PyPI: https://pypi.org/project/walla-cli/
 walla doctor --json
 # If auth.session is false: ask human to run `walla login` and paste cookie
 # Or: walla login --cookie '<value>' --json

{walla_cli-0.1.0 → walla_cli-0.1.2}/walla/__init__.py

@@ -4,4 +4,4 @@ from __future__ import annotations
 
 __all__ = ("__version__",)
 
-__version__ = "0.1.0"
+__version__ = "0.1.2"

walla_cli-0.1.2/walla/account/prompt.py

@@ -0,0 +1,82 @@
+"""Interactive login helpers (cookie paste primary)."""
+
+from __future__ import annotations
+
+import getpass
+from typing import Any
+
+import typer
+
+from walla.account.cookies import SESSION_COOKIE
+from walla.account.login import login_cookie_text, login_password
+from walla.core.exceptions import WallaAuthError
+from walla.models.account import SessionData
+
+__all__ = ("interactive_login", "session_summary")
+
+_COOKIE_HOWTO = f"""
+How to get your Wallapop session cookie
+=======================================
+
+1. Open Chrome/Firefox and go to:
+     https://es.wallapop.com
+2. Log in with your Wallapop account (until you see your feed).
+3. Copy the cookie named exactly:
+     {SESSION_COOKIE}
+
+   Easiest (extension):
+     - Install "Cookie-Editor" from the Chrome/Firefox store
+     - Click the Cookie-Editor icon on es.wallapop.com
+     - Find {SESSION_COOKIE}
+     - Click Copy on its Value
+
+   Or DevTools (no extension):
+     - Press F12 -> Application (Chrome) or Storage (Firefox)
+     - Cookies -> https://es.wallapop.com
+     - Click {SESSION_COOKIE}
+     - Double-click the Value cell -> Ctrl+C / Cmd+C
+
+4. Paste that long string below (one line), then press Enter.
+   Do NOT paste your password. Do NOT share this cookie in chat.
+
+Optional: save an export as cookies.txt and paste the file path instead.
+""".strip()
+
+
+def interactive_login(*, password: bool = False) -> SessionData:
+    """Prompt for cookie paste, or email/password when ``password`` is True."""
+    if password:
+        return _prompt_password()
+    return _prompt_cookie()
+
+
+def _prompt_cookie() -> SessionData:
+    typer.echo(_COOKIE_HOWTO)
+    typer.echo("")
+    raw = typer.prompt(f"Paste {SESSION_COOKIE} value (or cookies.txt path)").strip()
+    if not raw:
+        raise WallaAuthError("empty paste - copy the cookie Value, not the name")
+    return login_cookie_text(raw)
+
+
+def _prompt_password() -> SessionData:
+    typer.echo(
+        "Password login often fails (MFA). Prefer plain: walla login  (paste cookie)."
+    )
+    email = typer.prompt("email").strip()
+    pw = getpass.getpass("password: ")
+    try:
+        return login_password(username=email, password=pw)
+    except WallaAuthError:
+        typer.echo("Password rejected. Falling back to cookie paste.")
+        return _prompt_cookie()
+
+
+def session_summary(sess: SessionData) -> dict[str, Any]:
+    return {
+        "authenticated": True,
+        "has_access_token": bool(sess.access_token),
+        "has_cookie": bool(sess.session_cookie),
+        "user_id": sess.user_id,
+        "micro_name": sess.micro_name,
+    }

{walla_cli-0.1.0 → walla_cli-0.1.2}/walla/cli/banner.py

@@ -20,6 +20,7 @@ _BANNER_ROWS = (
 _STYLE = "bold #A3E635"
 _TAG = "italic #D9F99D"
 _CREDIT = "#84CC16"
+_HOOK = "#BEF264"
 
 
 def print_banner() -> None:
@@ -31,3 +32,18 @@ def print_banner() -> None:
     console.print(Text("  look · offer · talk", style=_TAG))
     console.print(Text("  Dr. Berend Gort  ·  www.berendgort.dev", style=_CREDIT))
     console.print()
+    console.print(
+        Text(
+            '  Example: "Find a used kite near Barcelona under 400eur,\n'
+            '           message the seller, offer if it is a GRAB."',
+            style=_HOOK,
+        )
+    )
+    console.print(
+        Text(
+            "  Install:  pipx install 'walla-cli[mcp]'   "
+            "https://pypi.org/project/walla-cli/",
+            style=_CREDIT,
+        )
+    )
+    console.print()

{walla_cli-0.1.0 → walla_cli-0.1.2}/walla/cli/main.py

@@ -23,9 +23,11 @@ app = typer.Typer(
     name="walla",
     cls=_WallaGroup,
     help=(
-        "Wallapop.es look · offer · talk for humans and agents. "
-        "Happy path: setup -> search -> login -> inbox / offer. "
-        "Run `walla instruct --json` for the recipe."
+        "Wallapop.es look · offer · talk. "
+        "Example ask: find a used kite near Barcelona under 400eur, "
+        "message seller, offer if GRAB. "
+        "Install: pipx install 'walla-cli[mcp]'. "
+        "Recipe: walla instruct --json."
     ),
     no_args_is_help=True,
     add_completion=False,

walla_cli-0.1.2/walla/core/human_fix.py

@@ -0,0 +1,31 @@
+"""User-visible fix recipes (not system prompts)."""
+
+from __future__ import annotations
+
+from typing import Any
+
+__all__ = (
+    "cookie_export_fix",
+)
+
+_SESSION_COOKIE = "__Secure-next-auth.session-token"
+
+
+def cookie_export_fix() -> dict[str, Any]:
+    return {
+        "title": "Paste Wallapop session cookie",
+        "steps": [
+            "Open https://es.wallapop.com and log in until you see your feed.",
+            f"Copy cookie {_SESSION_COOKIE} (Cookie-Editor extension, or F12 -> "
+            "Application/Storage -> Cookies -> es.wallapop.com -> copy Value).",
+            "Run: walla login",
+            "Paste the cookie Value (the long string), not the cookie name, then Enter.",
+            "Agents: walla login --cookie '<value>' --json",
+            "Never paste the cookie into a chat log.",
+        ],
+        "say_to_user": (
+            f"Run `walla login`, then paste the Value of cookie "
+            f"`{_SESSION_COOKIE}` from https://es.wallapop.com "
+            "(Cookie-Editor, or DevTools -> Application -> Cookies)."
+        ),
+    }

{walla_cli-0.1.0 → walla_cli-0.1.2}/walla/core/instruct.py

@@ -18,7 +18,8 @@ def instruct_recipe() -> dict[str, Any]:
             "-> walla inbox."
         ),
         "protocol": [
-            "Install: pipx install 'walla-cli[mcp]' (or pipx install -e '.[mcp]' in the clone).",
+            "Install from PyPI: pipx install 'walla-cli[mcp]' "
+            "(https://pypi.org/project/walla-cli/). Clone only if hacking.",
             "walla doctor --json - never print tokens or cookies.",
             "If no session: ask the human to run `walla login` and paste "
             "__Secure-next-auth.session-token (or pass --cookie for non-interactive).",

walla_cli-0.1.0/walla/account/prompt.py

@@ -1,56 +0,0 @@
-"""Interactive login helpers (cookie paste primary)."""
-
-from __future__ import annotations
-
-import getpass
-from typing import Any
-
-import typer
-
-from walla.account.cookies import SESSION_COOKIE
-from walla.account.login import login_cookie_text, login_password
-from walla.core.exceptions import WallaAuthError
-from walla.models.account import SessionData
-
-__all__ = ("interactive_login",)
-
-
-def interactive_login(*, password: bool = False) -> SessionData:
-    """Prompt for cookie paste, or email/password when ``password`` is True."""
-    if password:
-        return _prompt_password()
-    return _prompt_cookie()
-
-
-def _prompt_cookie() -> SessionData:
-    typer.echo(
-        f"Paste {SESSION_COOKIE} (or a cookies.txt path), then Enter:\n"
-        "  Tip: log in at es.wallapop.com → Cookie-Editor → copy that cookie."
-    )
-    raw = typer.prompt("cookie").strip()
-    if not raw:
-        raise WallaAuthError("empty paste")
-    return login_cookie_text(raw)
-
-
-def _prompt_password() -> SessionData:
-    typer.echo(
-        "Password login often fails (MFA). Prefer: walla login  (paste cookie)."
-    )
-    email = typer.prompt("email").strip()
-    pw = getpass.getpass("password: ")
-    try:
-        return login_password(username=email, password=pw)
-    except WallaAuthError:
-        typer.echo("Password rejected. Paste the session cookie instead.")
-        return _prompt_cookie()
-
-
-def session_summary(sess: SessionData) -> dict[str, Any]:
-    return {
-        "authenticated": True,
-        "has_access_token": bool(sess.access_token),
-        "has_cookie": bool(sess.session_cookie),
-        "user_id": sess.user_id,
-        "micro_name": sess.micro_name,
-    }

walla_cli-0.1.0/walla/core/human_fix.py

@@ -1,26 +0,0 @@
-"""User-visible fix recipes (not system prompts)."""
-
-from __future__ import annotations
-
-from typing import Any
-
-__all__ = (
-    "cookie_export_fix",
-)
-
-
-def cookie_export_fix() -> dict[str, Any]:
-    return {
-        "title": "Paste Wallapop session cookie",
-        "steps": [
-            "Log in at https://es.wallapop.com in your browser.",
-            "Copy cookie __Secure-next-auth.session-token (Cookie-Editor).",
-            "Run: walla login",
-            "Paste the cookie value when prompted.",
-            "Agents: walla login --cookie '<value>' --json",
-        ],
-        "say_to_user": (
-            "Run `walla login` and paste your "
-            "__Secure-next-auth.session-token cookie from es.wallapop.com."
-        ),
-    }