walla-cli 0.1.12__tar.gz → 0.1.14__tar.gz

{walla_cli-0.1.12 → walla_cli-0.1.14}/AGENTS.md

@@ -57,7 +57,9 @@ Ranks: models 10 → exceptions 15 → http 20 → core 30 → search/account/hu
 
 - **Do** keep files <= 250 LOC.
 - **Do** fail closed; typed `error_type`.
-- **Do** require `--yes` for bare say/offer/sell/unsell. `pursue` and `desk` send negotiation chat without a per-message prompt. Never pay.
+- **Do** require `--yes` for bare say/offer/sell/unsell/edit. `pursue` and `desk` send negotiation chat without a per-message prompt. Never pay.
+- **Do** use `walla edit <id> --eur N --yes` to change price/desc (no unsell+republish).
+- **Do** pass leaf id or `motor accesorios` when `--category Accesorios` is ambiguous.
 - **Don't** commit session.json, cookies, or tokens.
 - **Don't** invent wire shapes without a fixture.
 - **Don't** post buyer offers as `{item_id, amount, currency}` (HTTP 400).
@@ -65,3 +67,8 @@ Ranks: models 10 → exceptions 15 → http 20 → core 30 → search/account/hu
 - **Don't** create listings without `Accept: application/vnd.upload-v2+json`
   (HTTP 405). Use `walla sell` / `fixtures/sell_item_request.json`.
 - **Don't** require `.env` credentials; login is cookie paste.
+- **Don't** nag about transcripts on search/desk/pursue. First-use notice once.
+  At 20/40/60 prompts ask yes/no, then A-E (gh/git/browser/hub/manual).
+  If they ask to upload a transcript, run `walla teach` immediately.
+  `walla teach FILE --method a --yes` opens a PR; on failure use
+  https://github.com/berendgort/wallapop-cli/compare and help them finish.

{walla_cli-0.1.12 → walla_cli-0.1.14}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: walla-cli
-Version: 0.1.12
+Version: 0.1.14
 Summary: Wallapop.es CLI - look · offer · talk · sell for humans and agents
 Project-URL: Homepage, https://github.com/berendgort/wallapop-cli
 Project-URL: Repository, https://github.com/berendgort/wallapop-cli
@@ -198,7 +198,8 @@ walla doctor --json
 | `walla negotiate` | Win-win Spanish draft (never sends) |
 | `walla inbox` / `thread` / `say` | Talk (`say` needs `--yes`) |
 | `walla offer` | Formal offer (needs `--yes`) |
-| `walla sell` / `unsell` | Publish or delete a listing (`--yes`) |
+| `walla sell` / `unsell` / `edit` | Publish, edit, or delete (`--yes`) |
+| `walla teach` | Park a redacted agent transcript locally |
 | `walla fav list\|add\|rm` | Favorites |
 | `walla instruct` / `doctor` | Agent recipe + health |
 
@@ -225,6 +226,19 @@ python scripts/check_code_quality.py
 
 Read [`AGENTS.md`](AGENTS.md) before extending.
 
+## Help improve walla
+
+Long agent chats help. After you confirm, pick a PR method:
+
+```bash
+walla teach ./cursor-export.md --method a --yes --json   # A gh  B git  C browser  D hub  E manual
+```
+
+Cookies/tokens are stripped first. If `gh`/`git`/`hub` is missing, open
+https://github.com/berendgort/wallapop-cli/compare and file the PR by hand
+(parked file is in `~/.config/walla/teach/`). Agents ask once on first use,
+then at 20 / 40 / 60 prompts — never on every search.
+
 ## Disclaimer
 
 Unofficial. Not affiliated with Wallapop. Personal / research use.

{walla_cli-0.1.12 → walla_cli-0.1.14}/README.md

@@ -154,7 +154,8 @@ walla doctor --json
 | `walla negotiate` | Win-win Spanish draft (never sends) |
 | `walla inbox` / `thread` / `say` | Talk (`say` needs `--yes`) |
 | `walla offer` | Formal offer (needs `--yes`) |
-| `walla sell` / `unsell` | Publish or delete a listing (`--yes`) |
+| `walla sell` / `unsell` / `edit` | Publish, edit, or delete (`--yes`) |
+| `walla teach` | Park a redacted agent transcript locally |
 | `walla fav list\|add\|rm` | Favorites |
 | `walla instruct` / `doctor` | Agent recipe + health |
 
@@ -181,6 +182,19 @@ python scripts/check_code_quality.py
 
 Read [`AGENTS.md`](AGENTS.md) before extending.
 
+## Help improve walla
+
+Long agent chats help. After you confirm, pick a PR method:
+
+```bash
+walla teach ./cursor-export.md --method a --yes --json   # A gh  B git  C browser  D hub  E manual
+```
+
+Cookies/tokens are stripped first. If `gh`/`git`/`hub` is missing, open
+https://github.com/berendgort/wallapop-cli/compare and file the PR by hand
+(parked file is in `~/.config/walla/teach/`). Agents ask once on first use,
+then at 20 / 40 / 60 prompts — never on every search.
+
 ## Disclaimer
 
 Unofficial. Not affiliated with Wallapop. Personal / research use.

{walla_cli-0.1.12 → walla_cli-0.1.14}/docs/WIRE.md

@@ -81,14 +81,25 @@ Browser: `https://es.wallapop.com/app/catalog/upload/consumer-goods`.
 8. Create: `POST /api/v3/items` multipart `image` + `item` (JSON string).
    Header **`Accept: application/vnd.upload-v2+json`** (without it → HTTP 405).
    Extra photos: `POST /api/v3/items/{id}/picture2` multipart `image` + `order`.
-9. Delete: `DELETE /api/v3/items/{id}` → 204.
+9. Edit owned item: `PUT /api/v3/items/{id}` JSON body (same attribute shape as
+   create, plus `pictures: [{id, order}]`). Headers: Bearer,
+   **`Accept: application/vnd.upload-v2+json`**, **`X-Signature`** +
+   **`Timestamp`** (HMAC of `PUT|{absolute_url}|{ts_ms}|`). HTTP **204**.
+   Fixture: `fixtures/edit_item_request.json` / `walla.account.sell_edit_wire`.
+   CLI: `walla edit <id> --eur N --desc '…' --yes`.
+10. Delete: `DELETE /api/v3/items/{id}` → 204.
 
 Fixture: `fixtures/sell_item_request.json` / `walla.account.sell_wire.build_item_body`.
+HEIC/HEIF sell photos are converted to JPEG via ImageMagick (`magick`/`convert`)
+in `walla.account.sell_photos` before upload.
 
 Every CLI call (method, path, auth, body) is listed in `fixtures/wire_contracts.json`.
 `scripts/check_code_quality.py` fails if `walla/account`, `walla/search`, or `walla/http`
 grows a `/api/` or `/bff/` literal that the catalog does not list.
 CLI: `walla sell photo.jpg … --yes` (draft without `--yes`).
+Bare `Accesorios` is ambiguous across Motor / Cocina — pass leaf id or
+`motor accesorios`. Sticky `must_match` that empties a shortlist triggers a soft
+fallback + `mandate_note` (`walla setup --must ''` to clear).
 
 Writes that fail closed as `error_type: unsupported` until fixtures exist.
 

{walla_cli-0.1.12 → walla_cli-0.1.14}/docs/data_engineering_standards.md

@@ -15,8 +15,9 @@ Code shape: [`code_quality.md`](code_quality.md). Wire truth: [`WIRE.md`](WIRE.m
 
 | Mode | What | Mutability | Clock |
 |---|---|---|---|
-| Working | `profile.json`, `watches.json`, `session.json` | mutable | user lifetime |
+| Working | `profile.json`, `watches.json`, `session.json`, `teach.json` | mutable | user lifetime |
 | Archive | redacted fixtures under `fixtures/` | append on capture | repo life |
+| Teach drop | `~/.config/walla/teach/*.md` | append | user opt-in |
 | Live | `api.wallapop.com` responses | read | request |
 
 There is no database in v1. Do not stand up Postgres, Redis, or a second
@@ -37,6 +38,7 @@ file for the same fields is a defect.
 - Profile: one home point, one search radius, one pickup radius.
 - Watch: one keyword query + optional filters; seen listing ids are a set.
 - Session: tokens / cookie fields only. Never the password.
+- Teach: `teach.json` (first-notice clock) and one redacted file per `walla teach`.
 - Fixture: one captured response shape, secrets redacted, `schema_version` in
   the companion parser module docstring.
 

{walla_cli-0.1.12 → walla_cli-0.1.14}/fixtures/categories.json

@@ -35,6 +35,42 @@
               ]
             }
           ]
+        },
+        {
+          "id": 12484,
+          "name": "Cocina",
+          "parent_id": 12467,
+          "subcategories": [
+            {
+              "id": 24235,
+              "name": "Accesorios",
+              "parent_id": 12484,
+              "subcategories": []
+            }
+          ]
+        }
+      ],
+      "category_leaf_selection_mandatory": false
+    },
+    {
+      "id": 12800,
+      "name": "Motor y accesorios",
+      "path": "",
+      "vertical_id": "consumer_goods",
+      "icon": "engine",
+      "subcategories": [
+        {
+          "id": 10167,
+          "name": "Recambios de coches y furgonetas",
+          "parent_id": 12800,
+          "subcategories": [
+            {
+              "id": 10328,
+              "name": "Accesorios",
+              "parent_id": 10167,
+              "subcategories": []
+            }
+          ]
         }
       ],
       "category_leaf_selection_mandatory": false

walla_cli-0.1.14/fixtures/edit_item_request.json

@@ -0,0 +1,49 @@
+{
+  "endpoint": "PUT /api/v3/items/{id}",
+  "accept": "application/vnd.upload-v2+json",
+  "auth": "Bearer + X-Signature + Timestamp",
+  "signature": {
+    "message": "PUT|{absolute_url}|{timestamp_ms}|",
+    "note": "HMAC-SHA256 with Wallapop consumer key; required for edit"
+  },
+  "required_keys": [
+    "attributes",
+    "category_leaf_id",
+    "apply_discount",
+    "delivery",
+    "location",
+    "pictures"
+  ],
+  "attribute_required_keys": [
+    "title",
+    "description",
+    "price_amount",
+    "condition"
+  ],
+  "example": {
+    "attributes": {
+      "title": "TEST walla CLI edit - borrar",
+      "description": "Anuncio de prueba edit. NO COMPRAR.",
+      "price_amount": 9,
+      "condition": "good"
+    },
+    "category_leaf_id": "10105",
+    "apply_discount": false,
+    "delivery": {
+      "allowed_by_user": false,
+      "max_weight_kg": null,
+      "cost_configuration_id": null
+    },
+    "location": {
+      "latitude": 41.3874,
+      "longitude": 2.1686,
+      "approximated": true
+    },
+    "pictures": [
+      {
+        "id": 0,
+        "order": 0
+      }
+    ]
+  }
+}

{walla_cli-0.1.12 → walla_cli-0.1.14}/fixtures/wire_contracts.json

@@ -197,6 +197,19 @@
       "multipart": ["image", "order"],
       "ok_status": [200, 201, 204]
     },
+    {
+      "id": "sell_edit",
+      "cli": "edit",
+      "method": "PUT",
+      "path": "/api/v3/items/{id}",
+      "needle": "/api/v3/items/",
+      "auth": true,
+      "accept": "application/vnd.upload-v2+json",
+      "signed": true,
+      "ok_status": [200, 201, 204],
+      "fixture": "edit_item_request.json",
+      "known_bad": [{"status": 404, "cause": "missing X-Signature / upload-v2 Accept"}]
+    },
     {
       "id": "unsell",
       "cli": "unsell",

walla_cli-0.1.14/incoming/teach/README.md

@@ -0,0 +1,3 @@
+# Incoming teach drops
+
+Redacted agent transcripts from `walla teach --method`. One markdown file per PR.

{walla_cli-0.1.12 → walla_cli-0.1.14}/pyproject.toml

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

{walla_cli-0.1.12 → walla_cli-0.1.14}/tests/test_categories_find.py

@@ -48,6 +48,17 @@ def test_pick_by_name_and_id() -> None:
     assert forced.root_id == "12579"
 
 
+def test_accesorios_ambiguous_unless_disambiguated() -> None:
+    roots = _roots()
+    with pytest.raises(ValueError, match="ambiguous"):
+        pick_sell_category(roots, category="Accesorios")
+    motor = pick_sell_category(roots, category="motor accesorios")
+    assert motor.leaf_id == "10328"
+    assert motor.root_id == "12800"
+    by_id = pick_sell_category(roots, category="10328")
+    assert by_id.leaf_id == "10328"
+
+
 def test_find_empty_and_unknown() -> None:
     with pytest.raises(ValueError, match="empty"):
         find_categories(_roots(), "   ")

{walla_cli-0.1.12 → walla_cli-0.1.14}/tests/test_cli_json.py

@@ -40,12 +40,16 @@ def test_rate_limit_fields() -> None:
     assert p["retry_after_s"] == 2.0
 
 
-def test_instruct_json() -> None:
+def test_instruct_json(tmp_path: Path, monkeypatch: pytest.MonkeyPatch) -> None:
+    monkeypatch.setenv("WALLA_CONFIG_DIR", str(tmp_path))
     result = runner.invoke(app, ["instruct", "--json"])
     assert result.exit_code == 0
     data = json.loads(result.stdout)
     assert data["ok"] is True
     assert data["data"]["name"] == "walla"
+    assert data["data"]["teach"]["first_notice"]
+    again = runner.invoke(app, ["instruct", "--json"])
+    assert json.loads(again.stdout)["data"]["teach"]["first_notice"] is None
 
 
 def test_doctor_never_echoes_secrets(monkeypatch: pytest.MonkeyPatch) -> None:

{walla_cli-0.1.12 → walla_cli-0.1.14}/tests/test_core.py

@@ -14,7 +14,7 @@ from walla.core.exceptions import (
     WallaParseError,
     WallaUnsupportedError,
 )
-from walla.core.path import config_dir, profile_path
+from walla.core.path import config_dir, profile_path, teach_dir
 from walla.http.polite import reset_polite
 from walla.hunter.profile_store import parse_intake
 
@@ -32,6 +32,7 @@ def test_paths(monkeypatch: pytest.MonkeyPatch, tmp_path: Path) -> None:
     monkeypatch.setenv("WALLA_CONFIG_DIR", str(tmp_path))
     assert config_dir() == tmp_path
     assert profile_path() == tmp_path / "profile.json"
+    assert teach_dir() == tmp_path / "teach"
 
 
 def test_parse_intake(tmp_path: Path, monkeypatch: pytest.MonkeyPatch) -> None:

walla_cli-0.1.14/tests/test_edit.py

@@ -0,0 +1,94 @@
+"""Edit-item fixture + soft shortlist / HEIC prep."""
+
+from __future__ import annotations
+
+import json
+from pathlib import Path
+from unittest.mock import MagicMock, patch
+
+import pytest
+
+from walla.account.sell_edit_wire import assert_edit_body, build_edit_body
+from walla.account.sell_photos import prepare_sell_photos
+from walla.http.sign import sign_request
+from walla.hunter.shortlist import soft_shortlist
+
+ROOT = Path(__file__).resolve().parents[1]
+FIX = ROOT / "fixtures" / "edit_item_request.json"
+
+
+def test_edit_fixture_matches_builder() -> None:
+    meta = json.loads(FIX.read_text(encoding="utf-8"))
+    example = meta["example"]
+    assert_edit_body(example)
+    body = build_edit_body(
+        title=example["attributes"]["title"],
+        description=example["attributes"]["description"],
+        price_eur=float(example["attributes"]["price_amount"]),
+        category_leaf_id=str(example["category_leaf_id"]),
+        condition=example["attributes"]["condition"],
+        lat=float(example["location"]["latitude"]),
+        lon=float(example["location"]["longitude"]),
+        pictures=list(example["pictures"]),
+        shipping=False,
+    )
+    for key in meta["required_keys"]:
+        assert key in body
+    assert body["pictures"][0]["order"] == 0
+
+
+def test_sign_request_stable() -> None:
+    sig = sign_request(
+        method="PUT",
+        url="https://api.wallapop.com/api/v3/items/abc",
+        timestamp_ms="1700000000000",
+    )
+    assert isinstance(sig, str) and len(sig) > 20
+
+
+def test_soft_shortlist_mandate_fallback() -> None:
+    rows = [
+        {
+            "id": "a",
+            "title": "ski jacket",
+            "verdict": "PASS",
+            "price": {"amount": 50},
+            "url": "https://es.wallapop.com/item/a",
+        },
+        {
+            "id": "b",
+            "title": "other",
+            "verdict": "PASS",
+            "price": {"amount": 40},
+            "url": "https://es.wallapop.com/item/b",
+        },
+    ]
+    hard, note = soft_shortlist(rows, must_match=["north", "reach"])
+    assert hard
+    assert note is not None
+    assert note["mandate_emptied"] is True
+    assert [r["id"] for r in hard] == ["b", "a"]
+
+
+def test_prepare_rejects_unknown(tmp_path: Path) -> None:
+    bad = tmp_path / "x.gif"
+    bad.write_bytes(b"GIF")
+    with pytest.raises(ValueError, match="unsupported"):
+        prepare_sell_photos([bad])
+
+
+def test_prepare_heic_uses_convert(tmp_path: Path) -> None:
+    src = tmp_path / "shot.HEIC"
+    src.write_bytes(b"heic")
+    dest = tmp_path / "shot.jpg"
+
+    def _fake_run(cmd: list[str], **_: object) -> MagicMock:
+        dest.write_bytes(b"\xff\xd8\xff\xd9")
+        return MagicMock(returncode=0, stderr="", stdout="")
+
+    with (
+        patch("walla.account.sell_photos.shutil.which", return_value="convert"),
+        patch("walla.account.sell_photos.subprocess.run", side_effect=_fake_run),
+    ):
+        out = prepare_sell_photos([src])
+    assert out == [dest]

walla_cli-0.1.14/tests/test_teach.py

@@ -0,0 +1,73 @@
+"""Local transcript parking (no Wallapop wire)."""
+
+from __future__ import annotations
+
+from pathlib import Path
+
+import pytest
+from pytest import MonkeyPatch
+
+from walla.core.teach import (
+    FIRST_NOTICE,
+    park_transcript,
+    redact_secrets,
+    should_ask_feedback,
+    teach_payload,
+)
+from walla.core.teach_pr import MANUAL_PR, plan_pr, ship_pr
+
+
+def test_redact_jwt_and_cookie() -> None:
+    blob, n = redact_secrets(
+        "cookie __Secure-next-auth.session-token=abc.def\n"
+        "Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.aaa.bbb"
+    )
+    assert n == 2
+    assert "[redacted]" in blob
+    assert "session-token=abc" not in blob
+
+
+def test_park_and_first_notice(tmp_path: Path, monkeypatch: MonkeyPatch) -> None:
+    monkeypatch.setenv("WALLA_CONFIG_DIR", str(tmp_path))
+    first = teach_payload()
+    assert first["first_notice"] == FIRST_NOTICE
+    second = teach_payload()
+    assert second["first_notice"] is None
+    parked = park_transcript(
+        "hello Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.aaa.bbb",
+        name="hunt",
+    )
+    path = Path(str(parked["path"]))
+    assert path.is_file()
+    assert path.parent == tmp_path / "teach"
+    assert parked["redacted"] >= 1
+    assert "eyJhbGci" not in path.read_text(encoding="utf-8")
+
+
+def test_should_ask_every_twenty() -> None:
+    assert should_ask_feedback(19) is False
+    assert should_ask_feedback(20) is True
+    assert should_ask_feedback(21, last_asked_band=20) is False
+    assert should_ask_feedback(40, last_asked_band=20) is True
+    assert should_ask_feedback(40, last_asked_band=40) is False
+    assert should_ask_feedback(60, last_asked_band=40) is True
+
+
+def test_pr_menu_and_draft(tmp_path: Path, monkeypatch: MonkeyPatch) -> None:
+    monkeypatch.setenv("WALLA_CONFIG_DIR", str(tmp_path))
+    payload = teach_payload()
+    ids = [m["id"] for m in payload["methods"]]
+    assert ids == ["A", "B", "C", "D", "E"]
+    assert payload["manual_pr"] == MANUAL_PR
+    draft = plan_pr("a")
+    assert draft["method"] == "a"
+    assert "github.com" in draft["manual_pr"]
+    parked = park_transcript("hello kite hunt", name="x")
+    pr = ship_pr(Path(str(parked["path"])), method="e", yes=False)
+    assert pr["status"] == "draft"
+    assert pr["manual_pr"] == MANUAL_PR
+    manual = ship_pr(Path(str(parked["path"])), method="E", yes=True)
+    assert manual["status"] == "manual"
+    assert manual["open"] == MANUAL_PR
+    with pytest.raises(ValueError, match="method"):
+        plan_pr("z")

{walla_cli-0.1.12 → walla_cli-0.1.14}/tests/test_wire_contracts.py

@@ -17,6 +17,7 @@ from walla.account.inbox import list_conversations_raw
 from walla.account.login import login_password, mint_access_token, refresh_session, whoami
 from walla.account.offer_wire import assert_offer_body
 from walla.account.sell import delete_listing, publish_listing
+from walla.account.sell_edit import edit_listing
 from walla.account.sell_wire import assert_item_body, build_item_body
 from walla.core.exceptions import WallaAuthError, WallaHTTPError, WallaUnsupportedError
 from walla.http.client import HttpClient
@@ -244,6 +245,20 @@ def test_every_contract_is_sent(
     monkeypatch.setattr("walla.account.sell.requests.Session", lambda: _Sess())
     monkeypatch.setattr("walla.account.sell.CurlMime.addpart", _addpart)
     monkeypatch.setattr("walla.account.sell.CurlMime.close", lambda _s: None)
+    monkeypatch.setattr("walla.account.sell_edit.requests.request", _Sess().request)
+    monkeypatch.setattr(
+        "walla.account.sell_edit.fetch_owned_item",
+        lambda _id: {
+            "title": {"original": "Cofre test"},
+            "description": {"original": "desc"},
+            "price": {"cash": {"amount": 79.0}},
+            "type_attributes": {"condition": {"value": "good"}},
+            "taxonomy": [{"id": 10328}],
+            "location": {"latitude": 41.39, "longitude": 2.17},
+            "shipping": {"user_allows_shipping": False},
+            "images": [{"id": 1}],
+        },
+    )
     sess = SessionData(
         access_token="tok",
         device_id="dev-contract",
@@ -302,6 +317,9 @@ def test_every_contract_is_sent(
         lon=2.17,
     )
     assert created["id"] == "item123"
+    edited = edit_listing("item123", price_eur=49.0)
+    assert edited["edited"] is True
+    assert edited["price_eur"] == 49.0
     delete_listing("item123", client=rec)
 
     item_parts = [

{walla_cli-0.1.12 → walla_cli-0.1.14}/walla/__init__.py

@@ -4,4 +4,4 @@ from __future__ import annotations
 
 __all__ = ("__version__",)
 
-__version__ = "0.1.12"
+__version__ = "0.1.14"

walla_cli-0.1.14/walla/account/sell_edit.py

@@ -0,0 +1,106 @@
+"""Edit an owned listing (PUT /api/v3/items/{id} + X-Signature)."""
+
+from __future__ import annotations
+
+import json
+from typing import Any
+
+from curl_cffi import requests
+
+from walla.account.sell_edit_wire import build_edit_body
+from walla.account.sell_steps import auth_client, auth_headers
+from walla.core.exceptions import WallaHTTPError, WallaUnsupportedError
+from walla.http.headers import API_BASE
+from walla.http.polite import wait_turn
+from walla.http.sign import signed_headers
+
+__all__ = ("edit_listing", "fetch_owned_item")
+
+
+def fetch_owned_item(item_id: str) -> dict[str, Any]:
+    """GET /api/v3/items/{id} with auth (seller detail shape)."""
+    raw = auth_client().get(f"/api/v3/items/{item_id}", auth=True)
+    if not isinstance(raw, dict):
+        raise WallaUnsupportedError("item detail returned non-object")
+    return raw
+
+
+def edit_listing(
+    item_id: str,
+    *,
+    title: str | None = None,
+    description: str | None = None,
+    price_eur: float | None = None,
+    shipping: bool | None = None,
+    weight_kg: float | None = None,
+) -> dict[str, Any]:
+    """Patch title/description/price/shipping on an owned item. Needs --yes."""
+    item = fetch_owned_item(item_id)
+    cur_title = _orig(item.get("title"))
+    cur_desc = _orig(item.get("description"))
+    price_block = item.get("price") or {}
+    cash = price_block.get("cash") if isinstance(price_block, dict) else None
+    cur_price = float((cash or {}).get("amount") or 0)
+    cond = ((item.get("type_attributes") or {}).get("condition") or {}).get("value")
+    if not cond:
+        raise WallaUnsupportedError("item missing type_attributes.condition")
+    tax = item.get("taxonomy") or []
+    if not tax:
+        raise WallaUnsupportedError("item missing taxonomy leaf")
+    leaf = str(tax[-1]["id"])
+    loc = item.get("location") or {}
+    ship = item.get("shipping") or {}
+    allowed = bool(ship.get("user_allows_shipping"))
+    pics = [
+        {"id": img["id"], "order": i}
+        for i, img in enumerate(item.get("images") or [])
+        if isinstance(img, dict) and "id" in img
+    ]
+    body = build_edit_body(
+        title=title if title is not None else cur_title,
+        description=description if description is not None else cur_desc,
+        price_eur=float(price_eur) if price_eur is not None else cur_price,
+        category_leaf_id=leaf,
+        condition=str(cond),
+        lat=float(loc["latitude"]),
+        lon=float(loc["longitude"]),
+        pictures=pics,
+        shipping=allowed if shipping is None else bool(shipping),
+        max_weight_kg=weight_kg,
+    )
+    _put_edit(item_id, body)
+    return {
+        "id": item_id,
+        "edited": True,
+        "title": body["attributes"]["title"],
+        "price_eur": body["attributes"]["price_amount"],
+        "shipping": body["delivery"]["allowed_by_user"],
+    }
+
+
+def _orig(block: Any) -> str:
+    if isinstance(block, dict):
+        return str(block.get("original") or "")
+    return str(block or "")
+
+
+def _put_edit(item_id: str, body: dict[str, Any]) -> None:
+    url = f"{API_BASE}/api/v3/items/{item_id}"
+    headers = {k: v for k, v in auth_headers().items() if k.lower() != "content-type"}
+    headers["Accept"] = "application/vnd.upload-v2+json"
+    headers["Content-Type"] = "application/json"
+    headers = signed_headers(method="PUT", url=url, base=headers)
+    wait_turn()
+    resp: Any = requests.request(
+        "PUT",
+        url,
+        headers=headers,
+        data=json.dumps(body).encode(),
+        impersonate="chrome",
+        timeout=30,
+    )
+    if resp.status_code not in (200, 201, 204):
+        raise WallaHTTPError(
+            f"edit item HTTP {resp.status_code}: {(resp.text or '')[:200]}",
+            status_code=resp.status_code,
+        )