makea-cli 0.2.0__tar.gz → 0.2.2__tar.gz

{makea_cli-0.2.0 → makea_cli-0.2.2}/CHANGELOG.md

@@ -1,5 +1,49 @@
 # Changelog
 
+## 0.2.2
+
+Order lifecycle, exposed in tiers rather than all at once.
+
+- `ask` (an agent must put it in front of a person): `designer submit
+  sampling-order` (confirm a sample order), `designer submit production-order`,
+  `designer update production-order --complete|--links-file`, `designer update
+  shipping-order --confirm-receive`.
+- `never` (an agent must not run it at all): `designer update sampling-order
+  --cancel`, `designer delete sampling-order` (DRAFT only, the backend enforces
+  that), `designer delete shipping-order` — the endpoint is named cancel but it
+  unlinks every production order and removes the shipment.
+
+Cancel and delete are separate commands rather than flags on an `ask` one. The
+grade is per command, so putting them on a milder command would launder a
+destructive action through the wrong grade.
+
+**The grade is advice to a harness, not a gate in the CLI.** A person in a
+terminal runs any of these; `never` means an agent may not decide to.
+
+Payments, bank transfers and subscriptions stay out of the CLI. The endpoints
+exist, and a `--dry-run` would even make them look safe, but giving them a
+command puts a charge one step away from an agent and no approval grade makes
+that a good trade. A test asserts no write command reaches them.
+
+## 0.2.1
+
+Each persona can now clear its own queue. `list task` and `list action` could show
+you the work; nothing could close it.
+
+- **designer**: `list action`, `update task --complete|--dismiss`,
+  `update action --acknowledge|--snooze DAYS|--dismiss`,
+  `update note --accept|--reject` (a task the assistant proposed),
+  `update proposal --note N` (apply one proposed spec change),
+  `update suggested-action -a note:action` (accept several at once, one write).
+- **supplier**: `list task`, `list quote-edit-request`, `update task`, `update action`,
+  `update quote <rfq> <link> --file` (revise a quote already sent), and
+  `update rfq --status|--archive|--accept-terms` — a factory could submit a quote
+  but had no way to correct it or answer the invitation.
+
+Acknowledging an action does not close it: an action is closed by the fact it asks
+for. The help text says so, because the opposite assumption is easy to make and
+produces a dashboard that lies.
+
 ## 0.2.0
 
 **The command names changed.** Every command is now `makea-cli <persona> <verb> <noun>`:

{makea_cli-0.2.0 → makea_cli-0.2.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: makea-cli
-Version: 0.2.0
+Version: 0.2.2
 Summary: Makea admin CLI (browser login + Makea admin HTTP API)
 Requires-Python: >=3.10
 Requires-Dist: click<9,>=8.1
@@ -79,6 +79,8 @@ makea-cli auth --logout
 
 每条命令都有的开关：`--describe` 打印它的机器可读定义（flags、副作用、审批档位）；`--json` 强制纯 JSON（stdout 不是终端时默认就是）。读命令还有 `--fields a,b,c` 只保留这些字段；`list` 命令还有 `--limit N`（后端自己分页的就透传，不分页的在本地截断并在结果里写明 `truncated` / `returned` / `omitted`）；写命令还有 `--dry-run`（打印将要发出的请求，不发）和 `--idempotency-key <k>`。`makea-cli --describe --json` 打印全量 manifest。
 
+写命令的**审批档位**（manifest 的 `approval`）是给 harness 的建议，不是 CLI 的门：`auto` 可以自动跑；`ask` 必须先让人确认；`never` agent 不许自己决定（人在终端照常能跑）。动钱的端点（payments / bank transfer / subscription）**故意不进 CLI**。
+
 exit code：`0` 成功 · `2` 用法错 · `3` 未登录或身份与 persona 不匹配 · `4` 后端拒绝（4xx，错误 JSON 在 stderr）· `5` 没跑完（5xx / 网络 / 超时）——读命令直接重试即可；**写命令可能已经生效了，重试前先读一遍状态**。
 
 0.1 的平铺命令名（`list-users`、`submit-supplier-quote` …）仍可用，作为隐藏的过渡别名转发到新命令并在 stderr 打一行提示；**下一个 minor 版本删除**。完整的改名对照表在 [CHANGELOG.md](CHANGELOG.md)。
@@ -147,6 +149,8 @@ exit code：`0` 成功 · `2` 用法错 · `3` 未登录或身份与 persona 不
 | `makea-cli designer create product` | write（ask） | `POST /designer/product/create_or_update_product` | payload must match manufacture/specifications (all frontend fields; categories/subcategories + collection_id in --hel… | `designer-upsert-product` |
 | `makea-cli designer create rfq` | write（ask） | `POST /designer/product/send_rfq` | ask the chosen suppliers to quote on a product. --supplier repeats; --makea-sourcing also asks Makea to source. | — |
 | `makea-cli designer create sampling-order` | write（ask） | `POST /designer/sampling_orders` | order samples. --file is the full order payload (product_order_id, items, fees …); run --dry-run first and read the b… | — |
+| `makea-cli designer delete sampling-order` | write（never） | `DELETE /designer/sampling_orders/{sampling_order_id}` | delete a DRAFT sample order. The backend refuses any other status. Graded `never`. | — |
+| `makea-cli designer delete shipping-order` | write（never） | `POST /designer/shipping_orders/{shipping_order_id}/cancel` | the endpoint is called cancel but it unlinks every production order and removes the shipment, so it is a delete here.… | — |
 | `makea-cli designer download document` | read | `GET /designer/document/download` | save bytes for user_id + document_id (designer-authenticated; same query contract as admin document download). | `designer-download-document` |
 | `makea-cli designer get collection` | read | `GET /designer/collections/{collection_id}/overview` | one collection with its products, orders and lifecycle in a single read. | — |
 | `makea-cli designer get lifecycle` | read | `GET /designer/product_orders/{product_order_id}/lifecycle` | which stage this product is in. | — |
@@ -154,6 +158,7 @@ exit code：`0` 成功 · `2` 用法错 · `3` 未登录或身份与 persona 不
 | `makea-cli designer get quote-advice` | read | `GET /designer/product/quote_advice` | which quote to award and why, from cache. Reading never spends a model call; the web app is what asks for a fresh one. | — |
 | `makea-cli designer get tech-pack` | read | `GET /designer/products/{product_id}/technical-specifications` | the product's tech pack. | — |
 | `makea-cli designer get tech-pack-history` | read | `GET /designer/products/{product_id}/specification-change-history` | who changed which spec field, when, and from what. | — |
+| `makea-cli designer list action` | read | `GET /designer/actions` | the pending actions on you, optionally for one product. An action is closed by the fact it asks for, not by acknowled… | — |
 | `makea-cli designer list channel` | read | `GET /designer/products/{product_id}/channels` | the product's conversation channels. | — |
 | `makea-cli designer list collection` | read | `GET /designer/collections` | the brand's collections. | — |
 | `makea-cli designer list library-element` | read | `GET /designer/library_components` | the brand's own shelf (fabrics, trims, colours, artwork); --section narrows to one kind. | — |
@@ -166,7 +171,17 @@ exit code：`0` 成功 · `2` 用法错 · `3` 未登录或身份与 persona 不
 | `makea-cli designer list task` | read | `GET /designer/tasks` | what the platform is waiting on you for. | — |
 | `makea-cli designer search note` | read | `GET /designer/products/{product_id}/channel_search` | full-text search across a product's conversation; --channel narrows to one channel key. | — |
 | `makea-cli designer set product-collection` | write（auto） | `POST /designer/products/{id}/link-to-collection` | assign product to a collection. | `designer-link-product-to-collection` |
+| `makea-cli designer submit production-order` | write（ask） | `POST /designer/production_orders/{production_order_id}/submit` | submit a 大货 order. This is the commitment, so --dry-run and confirm with the user first. | — |
+| `makea-cli designer submit sampling-order` | write（ask） | `POST /designer/sampling_orders/{sampling_order_id}/confirm` | confirm a sample order so the supplier starts. Run --dry-run first and read it back to the user. | — |
+| `makea-cli designer update action` | write（auto） | `POST /designer/actions/{action_id}/{acknowledge\|snooze\|dismiss}` | respond to one of the pending actions from `designer list action`. An action is closed by the fact it asks for, not b… | — |
+| `makea-cli designer update note` | write（ask） | `POST /designer/products/{product_id}/notes/{note_id}/{accept\|reject}` | decide on a task the assistant proposed on a product. | — |
 | `makea-cli designer update product` | write（auto） | `POST /designer/product/update_basic_info` | patch fields on a product. --cover-image / --back-image take a document id and are what the assistant's set_product_i… | — |
+| `makea-cli designer update production-order` | write（ask） | `POST /designer/production_orders/{production_order_id}/complete` | POST /designer/production_orders/{id}/complete, or PUT the order to re-pick which supplier links it covers (--links-f… | — |
+| `makea-cli designer update proposal` | write（ask） | `POST /designer/beeboo_proposals/approve` | apply one spec change the assistant proposed. This edits the pack, so read the proposal first. | — |
+| `makea-cli designer update sampling-order` | write（never） | `POST /designer/sampling_orders/{sampling_order_id}/cancel` | cancel a sample order. Graded `never`: an agent must not do this on its own, a person runs it. | — |
+| `makea-cli designer update shipping-order` | write（ask） | `POST /designer/shipping_orders/{shipping_order_id}/confirm_receive` | say the goods arrived. The backend accepts this only while the shipment is IN_TRANSIT. | — |
+| `makea-cli designer update suggested-action` | write（ask） | `POST /designer/channels/{channel_id}/suggested_actions/bulk_accept` | accept several of a channel's suggested actions in one write. --action takes note_id:action_id and repeats. | — |
+| `makea-cli designer update task` | write（auto） | `POST /designer/tasks/{complete\|dismiss}` | close one of the tasks from `designer list task`. Complete means you did it; dismiss means it does not apply. | — |
 | `makea-cli designer upload document` | write（auto） | `POST /designer/document/upload` | upload a file for the current designer token; optional product_id (omit to start a new draft id server-side). | `designer-upload-document` |
 
 ### `supplier`
@@ -183,8 +198,14 @@ exit code：`0` 成功 · `2` 用法错 · `3` 未登录或身份与 persona 不
 | `makea-cli supplier list channel` | read | `GET /supplier/products/{product_id}/channels` | the channels you are part of on a product. | — |
 | `makea-cli supplier list note` | read | `GET /supplier/products/{product_id}/channels/{channel_key}/notes` | the conversation in one channel. | — |
 | `makea-cli supplier list production-order` | read | `GET /supplier/production_orders` | your production orders, optionally for one RFQ. | — |
+| `makea-cli supplier list quote-edit-request` | read | `GET /supplier/quote_requests/{quote_request_id}/quote_edit_requests` | changes the brand has asked you to make to a quote you already sent. | — |
 | `makea-cli supplier list rfq` | read | `GET /supplier/quote_requests` | the RFQs (quote requests) sent to you. | — |
+| `makea-cli supplier list task` | read | `GET /supplier/tasks` | your onboarding and per-order to-dos. | — |
 | `makea-cli supplier submit quote` | write（ask） | `POST /supplier/quote_requests/{id}/submit_quote` | submit your quote for an RFQ. --file is the supplier link payload as JSON (same shape the web form posts); run with -… | — |
+| `makea-cli supplier update action` | write（auto） | `POST /supplier/actions/{action_id}/{acknowledge\|snooze}` | respond to a pending action. Acknowledging says you have seen it; the action still closes on the fact it asks for. | — |
+| `makea-cli supplier update quote` | write（ask） | `POST /supplier/quote_requests/{quote_request_id}/links/{link_id}/edit` | revise a quote you already sent. --file is the same payload shape as submit; --dry-run first. | — |
+| `makea-cli supplier update rfq` | write（ask） | `POST /supplier/quote_requests/{quote_request_id}/{status\|archive\|accept_terms}` | answer an RFQ. --status accepts or declines the invitation; --archive takes it off your board; --accept-terms accepts… | — |
+| `makea-cli supplier update task` | write（auto） | `POST /supplier/tasks/{complete\|dismiss}` | close one of the tasks from `supplier list task`. | — |
 
 其它：`makea-cli auth [--logout]` 登录/登出；`makea-cli version` 版本号。
 

{makea_cli-0.2.0 → makea_cli-0.2.2}/README.md

@@ -67,6 +67,8 @@ makea-cli auth --logout
 
 每条命令都有的开关：`--describe` 打印它的机器可读定义（flags、副作用、审批档位）；`--json` 强制纯 JSON（stdout 不是终端时默认就是）。读命令还有 `--fields a,b,c` 只保留这些字段；`list` 命令还有 `--limit N`（后端自己分页的就透传，不分页的在本地截断并在结果里写明 `truncated` / `returned` / `omitted`）；写命令还有 `--dry-run`（打印将要发出的请求，不发）和 `--idempotency-key <k>`。`makea-cli --describe --json` 打印全量 manifest。
 
+写命令的**审批档位**（manifest 的 `approval`）是给 harness 的建议，不是 CLI 的门：`auto` 可以自动跑；`ask` 必须先让人确认；`never` agent 不许自己决定（人在终端照常能跑）。动钱的端点（payments / bank transfer / subscription）**故意不进 CLI**。
+
 exit code：`0` 成功 · `2` 用法错 · `3` 未登录或身份与 persona 不匹配 · `4` 后端拒绝（4xx，错误 JSON 在 stderr）· `5` 没跑完（5xx / 网络 / 超时）——读命令直接重试即可；**写命令可能已经生效了，重试前先读一遍状态**。
 
 0.1 的平铺命令名（`list-users`、`submit-supplier-quote` …）仍可用，作为隐藏的过渡别名转发到新命令并在 stderr 打一行提示；**下一个 minor 版本删除**。完整的改名对照表在 [CHANGELOG.md](CHANGELOG.md)。
@@ -135,6 +137,8 @@ exit code：`0` 成功 · `2` 用法错 · `3` 未登录或身份与 persona 不
 | `makea-cli designer create product` | write（ask） | `POST /designer/product/create_or_update_product` | payload must match manufacture/specifications (all frontend fields; categories/subcategories + collection_id in --hel… | `designer-upsert-product` |
 | `makea-cli designer create rfq` | write（ask） | `POST /designer/product/send_rfq` | ask the chosen suppliers to quote on a product. --supplier repeats; --makea-sourcing also asks Makea to source. | — |
 | `makea-cli designer create sampling-order` | write（ask） | `POST /designer/sampling_orders` | order samples. --file is the full order payload (product_order_id, items, fees …); run --dry-run first and read the b… | — |
+| `makea-cli designer delete sampling-order` | write（never） | `DELETE /designer/sampling_orders/{sampling_order_id}` | delete a DRAFT sample order. The backend refuses any other status. Graded `never`. | — |
+| `makea-cli designer delete shipping-order` | write（never） | `POST /designer/shipping_orders/{shipping_order_id}/cancel` | the endpoint is called cancel but it unlinks every production order and removes the shipment, so it is a delete here.… | — |
 | `makea-cli designer download document` | read | `GET /designer/document/download` | save bytes for user_id + document_id (designer-authenticated; same query contract as admin document download). | `designer-download-document` |
 | `makea-cli designer get collection` | read | `GET /designer/collections/{collection_id}/overview` | one collection with its products, orders and lifecycle in a single read. | — |
 | `makea-cli designer get lifecycle` | read | `GET /designer/product_orders/{product_order_id}/lifecycle` | which stage this product is in. | — |
@@ -142,6 +146,7 @@ exit code：`0` 成功 · `2` 用法错 · `3` 未登录或身份与 persona 不
 | `makea-cli designer get quote-advice` | read | `GET /designer/product/quote_advice` | which quote to award and why, from cache. Reading never spends a model call; the web app is what asks for a fresh one. | — |
 | `makea-cli designer get tech-pack` | read | `GET /designer/products/{product_id}/technical-specifications` | the product's tech pack. | — |
 | `makea-cli designer get tech-pack-history` | read | `GET /designer/products/{product_id}/specification-change-history` | who changed which spec field, when, and from what. | — |
+| `makea-cli designer list action` | read | `GET /designer/actions` | the pending actions on you, optionally for one product. An action is closed by the fact it asks for, not by acknowled… | — |
 | `makea-cli designer list channel` | read | `GET /designer/products/{product_id}/channels` | the product's conversation channels. | — |
 | `makea-cli designer list collection` | read | `GET /designer/collections` | the brand's collections. | — |
 | `makea-cli designer list library-element` | read | `GET /designer/library_components` | the brand's own shelf (fabrics, trims, colours, artwork); --section narrows to one kind. | — |
@@ -154,7 +159,17 @@ exit code：`0` 成功 · `2` 用法错 · `3` 未登录或身份与 persona 不
 | `makea-cli designer list task` | read | `GET /designer/tasks` | what the platform is waiting on you for. | — |
 | `makea-cli designer search note` | read | `GET /designer/products/{product_id}/channel_search` | full-text search across a product's conversation; --channel narrows to one channel key. | — |
 | `makea-cli designer set product-collection` | write（auto） | `POST /designer/products/{id}/link-to-collection` | assign product to a collection. | `designer-link-product-to-collection` |
+| `makea-cli designer submit production-order` | write（ask） | `POST /designer/production_orders/{production_order_id}/submit` | submit a 大货 order. This is the commitment, so --dry-run and confirm with the user first. | — |
+| `makea-cli designer submit sampling-order` | write（ask） | `POST /designer/sampling_orders/{sampling_order_id}/confirm` | confirm a sample order so the supplier starts. Run --dry-run first and read it back to the user. | — |
+| `makea-cli designer update action` | write（auto） | `POST /designer/actions/{action_id}/{acknowledge\|snooze\|dismiss}` | respond to one of the pending actions from `designer list action`. An action is closed by the fact it asks for, not b… | — |
+| `makea-cli designer update note` | write（ask） | `POST /designer/products/{product_id}/notes/{note_id}/{accept\|reject}` | decide on a task the assistant proposed on a product. | — |
 | `makea-cli designer update product` | write（auto） | `POST /designer/product/update_basic_info` | patch fields on a product. --cover-image / --back-image take a document id and are what the assistant's set_product_i… | — |
+| `makea-cli designer update production-order` | write（ask） | `POST /designer/production_orders/{production_order_id}/complete` | POST /designer/production_orders/{id}/complete, or PUT the order to re-pick which supplier links it covers (--links-f… | — |
+| `makea-cli designer update proposal` | write（ask） | `POST /designer/beeboo_proposals/approve` | apply one spec change the assistant proposed. This edits the pack, so read the proposal first. | — |
+| `makea-cli designer update sampling-order` | write（never） | `POST /designer/sampling_orders/{sampling_order_id}/cancel` | cancel a sample order. Graded `never`: an agent must not do this on its own, a person runs it. | — |
+| `makea-cli designer update shipping-order` | write（ask） | `POST /designer/shipping_orders/{shipping_order_id}/confirm_receive` | say the goods arrived. The backend accepts this only while the shipment is IN_TRANSIT. | — |
+| `makea-cli designer update suggested-action` | write（ask） | `POST /designer/channels/{channel_id}/suggested_actions/bulk_accept` | accept several of a channel's suggested actions in one write. --action takes note_id:action_id and repeats. | — |
+| `makea-cli designer update task` | write（auto） | `POST /designer/tasks/{complete\|dismiss}` | close one of the tasks from `designer list task`. Complete means you did it; dismiss means it does not apply. | — |
 | `makea-cli designer upload document` | write（auto） | `POST /designer/document/upload` | upload a file for the current designer token; optional product_id (omit to start a new draft id server-side). | `designer-upload-document` |
 
 ### `supplier`
@@ -171,8 +186,14 @@ exit code：`0` 成功 · `2` 用法错 · `3` 未登录或身份与 persona 不
 | `makea-cli supplier list channel` | read | `GET /supplier/products/{product_id}/channels` | the channels you are part of on a product. | — |
 | `makea-cli supplier list note` | read | `GET /supplier/products/{product_id}/channels/{channel_key}/notes` | the conversation in one channel. | — |
 | `makea-cli supplier list production-order` | read | `GET /supplier/production_orders` | your production orders, optionally for one RFQ. | — |
+| `makea-cli supplier list quote-edit-request` | read | `GET /supplier/quote_requests/{quote_request_id}/quote_edit_requests` | changes the brand has asked you to make to a quote you already sent. | — |
 | `makea-cli supplier list rfq` | read | `GET /supplier/quote_requests` | the RFQs (quote requests) sent to you. | — |
+| `makea-cli supplier list task` | read | `GET /supplier/tasks` | your onboarding and per-order to-dos. | — |
 | `makea-cli supplier submit quote` | write（ask） | `POST /supplier/quote_requests/{id}/submit_quote` | submit your quote for an RFQ. --file is the supplier link payload as JSON (same shape the web form posts); run with -… | — |
+| `makea-cli supplier update action` | write（auto） | `POST /supplier/actions/{action_id}/{acknowledge\|snooze}` | respond to a pending action. Acknowledging says you have seen it; the action still closes on the fact it asks for. | — |
+| `makea-cli supplier update quote` | write（ask） | `POST /supplier/quote_requests/{quote_request_id}/links/{link_id}/edit` | revise a quote you already sent. --file is the same payload shape as submit; --dry-run first. | — |
+| `makea-cli supplier update rfq` | write（ask） | `POST /supplier/quote_requests/{quote_request_id}/{status\|archive\|accept_terms}` | answer an RFQ. --status accepts or declines the invitation; --archive takes it off your board; --accept-terms accepts… | — |
+| `makea-cli supplier update task` | write（auto） | `POST /supplier/tasks/{complete\|dismiss}` | close one of the tasks from `supplier list task`. | — |
 
 其它：`makea-cli auth [--logout]` 登录/登出；`makea-cli version` 版本号。
 

makea_cli-0.2.2/makea_cli/__init__.py

@@ -0,0 +1 @@
+__version__ = "0.2.2"

{makea_cli-0.2.0 → makea_cli-0.2.2}/makea_cli/api_client.py

@@ -1220,3 +1220,141 @@ def supplier_download_document(
 ) -> tuple[bytes, str | None]:
     """GET /supplier/document/download — a document this factory may read."""
     return _download("/supplier/document/download", {"document_id": document_id}, timeout=timeout)
+
+
+# --- clearing the queue: tasks, actions, and the assistant's proposals ----------
+
+
+def designer_task_action(action: str, task_id: str) -> Any:
+    """POST /designer/tasks/{dismiss|complete} — body ``{"task_id": "<type>#<key>"}``."""
+    return post_json(f"/designer/tasks/{action}", {"task_id": task_id})
+
+
+def designer_action_state(action_id: str, state: str, *, days: int | None = None) -> Any:
+    """POST /designer/actions/{id}/{acknowledge|snooze|dismiss}."""
+    body: dict[str, Any] = {}
+    if state == "snooze" and days is not None:
+        body["days"] = days
+    return post_json(f"/designer/actions/{action_id}/{state}", body)
+
+
+def designer_note_decision(product_id: str, note_id: str, decision: str) -> Any:
+    """POST /designer/products/{id}/notes/{note_id}/{accept|reject} — a task candidate."""
+    return post_json(f"/designer/products/{product_id}/notes/{note_id}/{decision}", {})
+
+
+def designer_approve_proposal(note_id: str, proposal_id: str) -> Any:
+    """POST /designer/beeboo_proposals/approve — apply one of the assistant's spec proposals."""
+    return post_json(
+        "/designer/beeboo_proposals/approve", {"note_id": note_id, "proposal_id": proposal_id}
+    )
+
+
+def designer_bulk_accept_actions(channel_id: str, actions: list[dict[str, str]]) -> Any:
+    """POST /designer/channels/{id}/suggested_actions/bulk_accept — accept several at once."""
+    return post_json(
+        f"/designer/channels/{channel_id}/suggested_actions/bulk_accept", {"actions": actions}
+    )
+
+
+def supplier_task_action(action: str, task_id: str) -> Any:
+    """POST /supplier/tasks/{dismiss|complete} — body ``{"task_id": "<type>#<key>"}``."""
+    return post_json(f"/supplier/tasks/{action}", {"task_id": task_id})
+
+
+def supplier_action_state(action_id: str, state: str, *, days: int | None = None) -> Any:
+    """POST /supplier/actions/{id}/{acknowledge|snooze}."""
+    body: dict[str, Any] = {}
+    if state == "snooze" and days is not None:
+        body["days"] = days
+    return post_json(f"/supplier/actions/{action_id}/{state}", body)
+
+
+# --- the factory's quote lifecycle ----------------------------------------------
+
+
+def supplier_edit_quote(quote_request_id: str, link_id: str, body: dict[str, Any]) -> Any:
+    """POST /supplier/quote_requests/{id}/links/{link_id}/edit — revise a quote already sent."""
+    return post_json(
+        f"/supplier/quote_requests/{quote_request_id}/links/{link_id}/edit", body, timeout=120.0
+    )
+
+
+def supplier_set_rfq_status(quote_request_id: str, status: str) -> Any:
+    """POST /supplier/quote_requests/{id}/status — accept or decline the invitation."""
+    return post_json(f"/supplier/quote_requests/{quote_request_id}/status", {"status": status})
+
+
+def supplier_archive_rfq(quote_request_id: str) -> Any:
+    """POST /supplier/quote_requests/{id}/archive — take it off your board."""
+    return post_json(f"/supplier/quote_requests/{quote_request_id}/archive", {})
+
+
+def supplier_accept_terms(quote_request_id: str, agreement_keys: list[str]) -> Any:
+    """POST /supplier/quote_requests/{id}/accept_terms — accept the named agreements."""
+    return post_json(
+        f"/supplier/quote_requests/{quote_request_id}/accept_terms",
+        {"agreement_keys": agreement_keys},
+    )
+
+
+def supplier_list_quote_edit_requests(quote_request_id: str) -> Any:
+    """GET /supplier/quote_requests/{id}/quote_edit_requests — the brand's change requests."""
+    return get_json(f"/supplier/quote_requests/{quote_request_id}/quote_edit_requests")
+
+
+def designer_list_actions(*, product_id: str | None = None) -> Any:
+    """GET /designer/actions — the brand's pending actions, optionally for one product."""
+    params = {"product_id": product_id} if product_id else None
+    return get_json("/designer/actions", params=params)
+
+
+def supplier_list_tasks() -> Any:
+    """GET /supplier/tasks — the factory's onboarding and per-order to-dos."""
+    return get_json("/supplier/tasks")
+
+
+# --- order lifecycle (designer). Tiered on purpose: see the commands' approval
+# --- grades -- submit/confirm ask a person, cancel/delete are never automatic,
+# --- and nothing here moves money. Payments and subscriptions are deliberately
+# --- absent from the CLI: an agent should not have a path to a charge.
+
+
+def designer_confirm_sampling_order(sampling_order_id: str) -> Any:
+    """POST /designer/sampling_orders/{id}/confirm — the brand confirms the sample order."""
+    return post_json(f"/designer/sampling_orders/{sampling_order_id}/confirm", {})
+
+
+def designer_cancel_sampling_order(sampling_order_id: str) -> Any:
+    """POST /designer/sampling_orders/{id}/cancel — cancel it."""
+    return post_json(f"/designer/sampling_orders/{sampling_order_id}/cancel", {})
+
+
+def designer_delete_sampling_order(sampling_order_id: str) -> Any:
+    """DELETE /designer/sampling_orders/{id} — DRAFT only; the backend refuses anything else."""
+    return delete_json(f"/designer/sampling_orders/{sampling_order_id}")
+
+
+def designer_submit_production_order(production_order_id: str) -> Any:
+    """POST /designer/production_orders/{id}/submit — hand the bulk order to the supplier."""
+    return post_json(f"/designer/production_orders/{production_order_id}/submit", {})
+
+
+def designer_complete_production_order(production_order_id: str) -> Any:
+    """POST /designer/production_orders/{id}/complete — the brand marks the bulk order done."""
+    return post_json(f"/designer/production_orders/{production_order_id}/complete", {})
+
+
+def designer_update_production_order(production_order_id: str, body: dict[str, Any]) -> Any:
+    """PUT /designer/production_orders/{id} — re-pick which supplier links the order covers."""
+    return put_json(f"/designer/production_orders/{production_order_id}", body, timeout=120.0)
+
+
+def designer_confirm_receive_shipping_order(shipping_order_id: str) -> Any:
+    """POST /designer/shipping_orders/{id}/confirm_receive — IN_TRANSIT only."""
+    return post_json(f"/designer/shipping_orders/{shipping_order_id}/confirm_receive", {})
+
+
+def designer_cancel_shipping_order(shipping_order_id: str) -> Any:
+    """POST /designer/shipping_orders/{id}/cancel — unlinks every production order, then deletes it."""
+    return post_json(f"/designer/shipping_orders/{shipping_order_id}/cancel", {})