shopline-mcp 1.0.0

package/dist/generated/toolSpecs.d.ts

@@ -0,0 +1,4607 @@
+export declare const toolSpecs: readonly [{
+    readonly module: "tools/addon_product_tools.py";
+    readonly name: "list_addon_products";
+    readonly write: false;
+    readonly description: "取得加購商品列表，支援依關鍵字搜尋。\n\n【用途】\n瀏覽或搜尋商店所有加購商品（Addon Products）設定，了解加購商品名稱、\n價格與庫存狀況。若提供搜尋關鍵字則呼叫搜尋端點，否則列出所有加購商品。\n適合分析加購策略與商品搭配情況。\n\n【呼叫的 Shopline API】\n- GET /v1/addon_products（無搜尋條件時）\n- GET /v1/addon_products/search（有搜尋條件時）\n\n【回傳結構】\ndict 含 total_found, returned, items[]。\n每筆包含 id, name, sku, price (TWD), quantity, status, created_at。";
+    readonly params: readonly [{
+        readonly name: "search_keyword";
+        readonly description: "搜尋關鍵字（加購商品名稱）";
+        readonly default: null;
+        readonly hasDefault: true;
+        readonly kind: "string";
+        readonly optional: true;
+    }, {
+        readonly name: "max_results";
+        readonly description: "最多回傳筆數";
+        readonly default: 50;
+        readonly hasDefault: true;
+        readonly kind: "integer";
+        readonly optional: false;
+    }];
+    readonly docEndpoints: readonly [{
+        readonly method: "GET";
+        readonly path: "/v1/addon_products";
+    }, {
+        readonly method: "GET";
+        readonly path: "/v1/addon_products/search";
+    }];
+    readonly operations: readonly [{
+        readonly kind: "api_get";
+        readonly method: "GET";
+        readonly endpointKey: "addon_products_search";
+        readonly params: "params";
+    }, {
+        readonly kind: "fetch_all_pages";
+        readonly method: "GET";
+        readonly endpointKey: "addon_products";
+    }];
+    readonly sourceLocation: {
+        readonly line: 16;
+        readonly endLine: 61;
+    };
+}, {
+    readonly module: "tools/affiliate_tools.py";
+    readonly name: "list_affiliate_campaigns";
+    readonly write: false;
+    readonly description: "取得聯盟行銷活動列表。\n\n【用途】\n瀏覽商店所有聯盟行銷（Affiliate）活動，了解活動名稱、狀態與推廣條件。\n可取得 campaign_id 後進一步呼叫 get_affiliate_campaign_detail 或\nget_affiliate_campaign_usage 查詢詳細資訊與訂單使用統計。\n\n【呼叫的 Shopline API】\n- GET /v1/affiliate_campaigns\n\n【回傳結構】\ndict 含 total_found, returned, items[]。\n每筆包含 id, title, status, commission_type, commission_value, created_at。";
+    readonly params: readonly [{
+        readonly name: "max_results";
+        readonly description: "最多回傳筆數";
+        readonly default: 50;
+        readonly hasDefault: true;
+        readonly kind: "integer";
+        readonly optional: false;
+    }];
+    readonly docEndpoints: readonly [{
+        readonly method: "GET";
+        readonly path: "/v1/affiliate_campaigns";
+    }];
+    readonly operations: readonly [{
+        readonly kind: "fetch_all_pages";
+        readonly method: "GET";
+        readonly endpointKey: "affiliate_campaigns";
+    }];
+    readonly sourceLocation: {
+        readonly line: 16;
+        readonly endLine: 53;
+    };
+}, {
+    readonly module: "tools/affiliate_tools.py";
+    readonly name: "get_affiliate_campaign_detail";
+    readonly write: false;
+    readonly description: "取得單一聯盟行銷活動的完整詳情。\n\n【用途】\n查詢特定聯盟行銷活動的佣金規則、適用範圍與推廣連結等完整資訊。\n適合在已知 campaign_id 的情況下取得所有欄位。\n\n【呼叫的 Shopline API】\n- GET /v1/affiliate_campaigns/{campaign_id}\n\n【回傳結構】\ndict 包含 id, title, status, commission_type, commission_value,\ntracking_code, start_at, end_at, created_at, updated_at 等完整欄位。";
+    readonly params: readonly [{
+        readonly name: "campaign_id";
+        readonly description: "聯盟行銷活動 ID（由 list_affiliate_campaigns 回傳的 id 欄位）";
+        readonly default: null;
+        readonly hasDefault: false;
+        readonly kind: "string";
+        readonly optional: false;
+    }];
+    readonly docEndpoints: readonly [{
+        readonly method: "GET";
+        readonly path: "/v1/affiliate_campaigns/{campaign_id}";
+    }];
+    readonly operations: readonly [{
+        readonly kind: "api_get";
+        readonly method: "GET";
+        readonly endpointKey: "affiliate_campaign_detail";
+        readonly path_params: "{'campaign_id': campaign_id}";
+    }];
+    readonly sourceLocation: {
+        readonly line: 57;
+        readonly endLine: 89;
+    };
+}, {
+    readonly module: "tools/affiliate_tools.py";
+    readonly name: "get_affiliate_campaign_usage";
+    readonly write: false;
+    readonly description: "取得聯盟行銷活動的訂單使用統計。\n\n【用途】\n分析特定聯盟行銷活動帶來的訂單數與銷售額，評估推廣效果。\n回傳訂單使用紀錄，可計算總訂單數、總銷售額、佣金金額等。\n\n【呼叫的 Shopline API】\n- GET /v1/affiliate_campaigns/{campaign_id}/order_usage\n\n【回傳結構】\ndict 含 campaign_id, total_orders, total_revenue (TWD), items[]。\n每筆訂單包含 order_id, order_number, revenue, commission, created_at。";
+    readonly params: readonly [{
+        readonly name: "campaign_id";
+        readonly description: "聯盟行銷活動 ID（由 list_affiliate_campaigns 回傳的 id 欄位）";
+        readonly default: null;
+        readonly hasDefault: false;
+        readonly kind: "string";
+        readonly optional: false;
+    }];
+    readonly docEndpoints: readonly [{
+        readonly method: "GET";
+        readonly path: "/v1/affiliate_campaigns/{campaign_id}/order_usage";
+    }];
+    readonly operations: readonly [{
+        readonly kind: "api_get";
+        readonly method: "GET";
+        readonly endpointKey: "affiliate_campaign_order_usage";
+        readonly path_params: "{'campaign_id': campaign_id}";
+    }];
+    readonly sourceLocation: {
+        readonly line: 93;
+        readonly endLine: 134;
+    };
+}, {
+    readonly module: "tools/agent_tools.py";
+    readonly name: "list_agents";
+    readonly write: false;
+    readonly description: "取得商店的代理人帳號清單。\n\n【用途】\n查看商店目前設定的代理人帳號，代理人通常用於\n客服、業務等特定角色的操作授權。適合確認代理人\n配置或了解有哪些外部帳號有商店操作權限。\n\n【呼叫的 Shopline API】\n- GET /v1/agents\n\n【回傳結構】\ndict 含 total, agents[]。\n每個 agent 包含 id, name, email, role,\nenabled, created_at 等。";
+    readonly params: readonly [];
+    readonly docEndpoints: readonly [{
+        readonly method: "GET";
+        readonly path: "/v1/agents";
+    }];
+    readonly operations: readonly [{
+        readonly kind: "api_get";
+        readonly method: "GET";
+        readonly endpointKey: "agents";
+    }];
+    readonly sourceLocation: {
+        readonly line: 13;
+        readonly endLine: 46;
+    };
+}, {
+    readonly module: "tools/analytics_tools.py";
+    readonly name: "get_rfm_analysis";
+    readonly write: false;
+    readonly description: "根據訂單資料進行 RFM（Recency/Frequency/Monetary）分群分析。注意：僅能分析有下單紀錄的客戶（Customers API 為 403）。";
+    readonly params: readonly [{
+        readonly name: "start_date";
+        readonly description: "分析區間起始 YYYY-MM-DD";
+        readonly default: null;
+        readonly hasDefault: false;
+        readonly kind: "string";
+        readonly optional: false;
+    }, {
+        readonly name: "end_date";
+        readonly description: "分析區間結束 YYYY-MM-DD";
+        readonly default: null;
+        readonly hasDefault: false;
+        readonly kind: "string";
+        readonly optional: false;
+    }, {
+        readonly name: "r_days_threshold";
+        readonly description: "Recency 門檻天數（最近消費 ≤ 此值為高 R）";
+        readonly default: 30;
+        readonly hasDefault: true;
+        readonly kind: "integer";
+        readonly optional: false;
+    }, {
+        readonly name: "f_threshold";
+        readonly description: "Frequency 門檻（消費 ≥ 此值為高 F）";
+        readonly default: 2;
+        readonly hasDefault: true;
+        readonly kind: "integer";
+        readonly optional: false;
+    }, {
+        readonly name: "m_threshold";
+        readonly description: "Monetary 門檻金額（累計 ≥ 此值為高 M）";
+        readonly default: 5000;
+        readonly hasDefault: true;
+        readonly kind: "number";
+        readonly optional: false;
+    }];
+    readonly docEndpoints: readonly [];
+    readonly operations: readonly [{
+        readonly kind: "fetch_all_pages";
+        readonly method: "GET";
+        readonly endpointKey: "orders_search";
+        readonly params: "params";
+    }];
+    readonly sourceLocation: {
+        readonly line: 25;
+        readonly endLine: 112;
+    };
+}, {
+    readonly module: "tools/analytics_tools.py";
+    readonly name: "get_repurchase_analysis";
+    readonly write: false;
+    readonly description: "分析客戶回購率與回購週期。計算新客 vs 舊客比例、回購率、平均回購天數。";
+    readonly params: readonly [{
+        readonly name: "start_date";
+        readonly description: "分析區間起始 YYYY-MM-DD";
+        readonly default: null;
+        readonly hasDefault: false;
+        readonly kind: "string";
+        readonly optional: false;
+    }, {
+        readonly name: "end_date";
+        readonly description: "分析區間結束 YYYY-MM-DD";
+        readonly default: null;
+        readonly hasDefault: false;
+        readonly kind: "string";
+        readonly optional: false;
+    }];
+    readonly docEndpoints: readonly [];
+    readonly operations: readonly [{
+        readonly kind: "fetch_all_pages";
+        readonly method: "GET";
+        readonly endpointKey: "orders_search";
+        readonly params: "params";
+    }];
+    readonly sourceLocation: {
+        readonly line: 119;
+        readonly endLine: 182;
+    };
+}, {
+    readonly module: "tools/analytics_tools.py";
+    readonly name: "get_customer_geo_analysis";
+    readonly write: false;
+    readonly description: "根據訂單的收件地址分析客戶地區分佈（縣市層級）。";
+    readonly params: readonly [{
+        readonly name: "start_date";
+        readonly description: "分析區間起始 YYYY-MM-DD";
+        readonly default: null;
+        readonly hasDefault: false;
+        readonly kind: "string";
+        readonly optional: false;
+    }, {
+        readonly name: "end_date";
+        readonly description: "分析區間結束 YYYY-MM-DD";
+        readonly default: null;
+        readonly hasDefault: false;
+        readonly kind: "string";
+        readonly optional: false;
+    }, {
+        readonly name: "channel";
+        readonly description: "通路篩選";
+        readonly default: "all";
+        readonly hasDefault: true;
+        readonly kind: "enum";
+        readonly optional: false;
+        readonly enum: readonly ["online", "pos", "all"];
+    }];
+    readonly docEndpoints: readonly [];
+    readonly operations: readonly [{
+        readonly kind: "fetch_all_pages";
+        readonly method: "GET";
+        readonly endpointKey: "orders_search";
+        readonly params: "params";
+    }];
+    readonly sourceLocation: {
+        readonly line: 189;
+        readonly endLine: 236;
+    };
+}, {
+    readonly module: "tools/analytics_tools.py";
+    readonly name: "get_inventory_turnover";
+    readonly write: false;
+    readonly description: "計算庫存周轉指標：周轉天數、周轉率。需要商品庫存 + 銷售數據。";
+    readonly params: readonly [{
+        readonly name: "start_date";
+        readonly description: "分析區間起始 YYYY-MM-DD";
+        readonly default: null;
+        readonly hasDefault: false;
+        readonly kind: "string";
+        readonly optional: false;
+    }, {
+        readonly name: "end_date";
+        readonly description: "分析區間結束 YYYY-MM-DD";
+        readonly default: null;
+        readonly hasDefault: false;
+        readonly kind: "string";
+        readonly optional: false;
+    }];
+    readonly docEndpoints: readonly [];
+    readonly operations: readonly [{
+        readonly kind: "fetch_all_pages";
+        readonly method: "GET";
+        readonly endpointKey: "products";
+    }, {
+        readonly kind: "fetch_all_pages";
+        readonly method: "GET";
+        readonly endpointKey: "orders_search";
+        readonly params: "params";
+    }];
+    readonly sourceLocation: {
+        readonly line: 243;
+        readonly endLine: 309;
+    };
+}, {
+    readonly module: "tools/analytics_tools.py";
+    readonly name: "get_category_sales";
+    readonly write: false;
+    readonly description: "依商品分類（Category）彙總銷售數據：各分類的營業額、銷量、商品數。需交叉 Categories API + Products + Orders。";
+    readonly params: readonly [{
+        readonly name: "start_date";
+        readonly description: "起始日期 YYYY-MM-DD";
+        readonly default: null;
+        readonly hasDefault: false;
+        readonly kind: "string";
+        readonly optional: false;
+    }, {
+        readonly name: "end_date";
+        readonly description: "結束日期 YYYY-MM-DD";
+        readonly default: null;
+        readonly hasDefault: false;
+        readonly kind: "string";
+        readonly optional: false;
+    }, {
+        readonly name: "channel";
+        readonly description: "通路篩選";
+        readonly default: "all";
+        readonly hasDefault: true;
+        readonly kind: "enum";
+        readonly optional: false;
+        readonly enum: readonly ["online", "pos", "all"];
+    }];
+    readonly docEndpoints: readonly [];
+    readonly operations: readonly [{
+        readonly kind: "api_get";
+        readonly method: "GET";
+        readonly endpointKey: "categories";
+        readonly params: "{'per_page': 50}";
+    }, {
+        readonly kind: "fetch_all_pages";
+        readonly method: "GET";
+        readonly endpointKey: "products";
+    }, {
+        readonly kind: "fetch_all_pages";
+        readonly method: "GET";
+        readonly endpointKey: "orders_search";
+        readonly params: "params";
+    }];
+    readonly sourceLocation: {
+        readonly line: 316;
+        readonly endLine: 411;
+    };
+}, {
+    readonly module: "tools/analytics_tools.py";
+    readonly name: "get_promotion_analysis";
+    readonly write: false;
+    readonly description: "分析促銷活動效果：各活動的使用次數、折扣類型、狀態分佈。可搭配銷售數據評估促銷 ROI。";
+    readonly params: readonly [{
+        readonly name: "status";
+        readonly description: "活動狀態篩選";
+        readonly default: "all";
+        readonly hasDefault: true;
+        readonly kind: "enum";
+        readonly optional: false;
+        readonly enum: readonly ["active", "inactive", "hidden", "all"];
+    }, {
+        readonly name: "discount_type";
+        readonly description: "折扣類型篩選（amount/percentage/free_shipping/addon）";
+        readonly default: null;
+        readonly hasDefault: true;
+        readonly kind: "string";
+        readonly optional: true;
+    }];
+    readonly docEndpoints: readonly [];
+    readonly operations: readonly [{
+        readonly kind: "fetch_all_pages";
+        readonly method: "GET";
+        readonly endpointKey: "promotions";
+    }];
+    readonly sourceLocation: {
+        readonly line: 418;
+        readonly endLine: 474;
+    };
+}, {
+    readonly module: "tools/analytics_tools.py";
+    readonly name: "get_refund_by_store";
+    readonly write: false;
+    readonly description: "依門市/通路分析退貨退款分佈。\n\n【用途】取得指定時間區間內的退貨單，並依關聯訂單的門市/通路分群，\n計算各門市的退貨筆數、退款金額、最常被退貨的商品，協助評估各通路退貨狀況。\n【呼叫的 Shopline API】\n- GET /v1/return_orders（退貨單列表）\n- GET /v1/orders/{order_id}（取得關聯訂單的通路資訊）\n【回傳結構】dict 含 period、total_return_orders、stores（各門市退貨統計）。";
+    readonly params: readonly [{
+        readonly name: "start_date";
+        readonly description: "起始日期 YYYY-MM-DD";
+        readonly default: null;
+        readonly hasDefault: false;
+        readonly kind: "string";
+        readonly optional: false;
+    }, {
+        readonly name: "end_date";
+        readonly description: "結束日期 YYYY-MM-DD";
+        readonly default: null;
+        readonly hasDefault: false;
+        readonly kind: "string";
+        readonly optional: false;
+    }];
+    readonly docEndpoints: readonly [{
+        readonly method: "GET";
+        readonly path: "/v1/return_orders";
+    }, {
+        readonly method: "GET";
+        readonly path: "/v1/orders/{order_id}";
+    }];
+    readonly operations: readonly [{
+        readonly kind: "fetch_all_pages";
+        readonly method: "GET";
+        readonly endpointKey: "return_orders";
+        readonly params: "params";
+    }, {
+        readonly kind: "api_get";
+        readonly method: "GET";
+        readonly endpointKey: "order_detail";
+        readonly path_params: "{'order_id': oid}";
+    }];
+    readonly sourceLocation: {
+        readonly line: 481;
+        readonly endLine: 563;
+    };
+}, {
+    readonly module: "tools/analytics_tools.py";
+    readonly name: "get_stock_transfer_suggestions";
+    readonly write: false;
+    readonly description: "自動產生跨倉庫庫存調撥建議。\n\n【用途】逐商品查詢各倉庫庫存，若同商品在不同倉庫之間的庫存差距過大\n（差值 >= min_stock_diff），則建議從庫存多的倉庫調撥到庫存少的倉庫。\n僅分析前 30 個商品以避免 API 速率限制。\n【呼叫的 Shopline API】\n- GET /v1/products（商品列表）\n- GET /v1/products/{product_id}/stocks（各倉庫庫存）\n- GET /v1/warehouses（倉庫名稱對照）\n【回傳結構】dict 含 products_analyzed、suggestions_count、suggestions 列表。";
+    readonly params: readonly [{
+        readonly name: "min_stock_diff";
+        readonly description: "倉庫間庫存差距門檻，差距 >= 此值才建議調撥";
+        readonly default: 10;
+        readonly hasDefault: true;
+        readonly kind: "integer";
+        readonly optional: false;
+    }];
+    readonly docEndpoints: readonly [{
+        readonly method: "GET";
+        readonly path: "/v1/products";
+    }, {
+        readonly method: "GET";
+        readonly path: "/v1/products/{product_id}/stocks";
+    }, {
+        readonly method: "GET";
+        readonly path: "/v1/warehouses";
+    }];
+    readonly operations: readonly [{
+        readonly kind: "api_get";
+        readonly method: "GET";
+        readonly endpointKey: "warehouses";
+        readonly params: "{'per_page': 50}";
+    }, {
+        readonly kind: "fetch_all_pages";
+        readonly method: "GET";
+        readonly endpointKey: "products";
+    }, {
+        readonly kind: "api_get";
+        readonly method: "GET";
+        readonly endpointKey: "product_stocks";
+        readonly path_params: "{'product_id': pid}";
+    }];
+    readonly sourceLocation: {
+        readonly line: 570;
+        readonly endLine: 651;
+    };
+}, {
+    readonly module: "tools/analytics_tools.py";
+    readonly name: "get_promotion_roi";
+    readonly write: false;
+    readonly description: "交叉比對促銷活動與銷售數據，計算各活動的 ROI。\n\n【用途】取得指定時間區間內活躍的促銷活動，並比對訂單中的 promotion_items，\n統計每個活動帶來的訂單數、營業額、折扣金額，計算平均每單折扣與折扣占比。\n【呼叫的 Shopline API】\n- GET /v1/promotions（促銷活動列表）\n- GET /v1/orders/search（訂單查詢）\n【回傳結構】dict 含 period、total_promotions、promotions（各活動 ROI 明細）。";
+    readonly params: readonly [{
+        readonly name: "start_date";
+        readonly description: "起始日期 YYYY-MM-DD";
+        readonly default: null;
+        readonly hasDefault: false;
+        readonly kind: "string";
+        readonly optional: false;
+    }, {
+        readonly name: "end_date";
+        readonly description: "結束日期 YYYY-MM-DD";
+        readonly default: null;
+        readonly hasDefault: false;
+        readonly kind: "string";
+        readonly optional: false;
+    }];
+    readonly docEndpoints: readonly [{
+        readonly method: "GET";
+        readonly path: "/v1/promotions";
+    }, {
+        readonly method: "GET";
+        readonly path: "/v1/orders/search";
+    }];
+    readonly operations: readonly [{
+        readonly kind: "fetch_all_pages";
+        readonly method: "GET";
+        readonly endpointKey: "promotions";
+    }, {
+        readonly kind: "fetch_all_pages";
+        readonly method: "GET";
+        readonly endpointKey: "orders_search";
+        readonly params: "params";
+    }];
+    readonly sourceLocation: {
+        readonly line: 658;
+        readonly endLine: 760;
+    };
+}, {
+    readonly module: "tools/analytics_tools.py";
+    readonly name: "get_customer_lifecycle";
+    readonly write: false;
+    readonly description: "比較兩個時間區間的 RFM 分群遷移，分析客戶生命週期變化。\n\n【用途】分別計算兩個時段的客戶 RFM 分群，然後比較客戶在兩期之間的分群遷移，\n找出升級（segment 改善）、流失（segment 退步）、新增、消失的客戶，\n產出分群遷移矩陣，協助制定客戶經營策略。\n【呼叫的 Shopline API】\n- GET /v1/orders/search（兩個時段各查詢一次）\n【回傳結構】dict 含 period1、period2、segment_migration、upgrade_count、churn_count、new_count、lost_count。";
+    readonly params: readonly [{
+        readonly name: "period1_start";
+        readonly description: "第一期起始日期 YYYY-MM-DD";
+        readonly default: null;
+        readonly hasDefault: false;
+        readonly kind: "string";
+        readonly optional: false;
+    }, {
+        readonly name: "period1_end";
+        readonly description: "第一期結束日期 YYYY-MM-DD";
+        readonly default: null;
+        readonly hasDefault: false;
+        readonly kind: "string";
+        readonly optional: false;
+    }, {
+        readonly name: "period2_start";
+        readonly description: "第二期起始日期 YYYY-MM-DD";
+        readonly default: null;
+        readonly hasDefault: false;
+        readonly kind: "string";
+        readonly optional: false;
+    }, {
+        readonly name: "period2_end";
+        readonly description: "第二期結束日期 YYYY-MM-DD";
+        readonly default: null;
+        readonly hasDefault: false;
+        readonly kind: "string";
+        readonly optional: false;
+    }, {
+        readonly name: "r_days";
+        readonly description: "Recency 門檻天數（最近消費 ≤ 此值為高 R）";
+        readonly default: 30;
+        readonly hasDefault: true;
+        readonly kind: "integer";
+        readonly optional: false;
+    }, {
+        readonly name: "f_threshold";
+        readonly description: "Frequency 門檻（消費 ≥ 此值為高 F）";
+        readonly default: 2;
+        readonly hasDefault: true;
+        readonly kind: "integer";
+        readonly optional: false;
+    }, {
+        readonly name: "m_threshold";
+        readonly description: "Monetary 門檻金額（累計 ≥ 此值為高 M）";
+        readonly default: 5000;
+        readonly hasDefault: true;
+        readonly kind: "number";
+        readonly optional: false;
+    }];
+    readonly docEndpoints: readonly [{
+        readonly method: "GET";
+        readonly path: "/v1/orders/search";
+    }];
+    readonly operations: readonly [{
+        readonly kind: "fetch_all_pages";
+        readonly method: "GET";
+        readonly endpointKey: "orders_search";
+        readonly params: "params";
+    }];
+    readonly sourceLocation: {
+        readonly line: 767;
+        readonly endLine: 934;
+    };
+}, {
+    readonly module: "tools/analytics_tools.py";
+    readonly name: "get_slow_movers";
+    readonly write: false;
+    readonly description: "找出庫存高但銷量低的滯銷商品。\n\n【用途】交叉比對商品庫存與銷售數據，計算每個商品的日均銷量與可售天數（days_of_supply），\n標記 days_of_supply 超過門檻或零銷售的商品為滯銷品，協助清倉決策。\n【呼叫的 Shopline API】\n- GET /v1/products（商品列表含庫存）\n- GET /v1/orders/search（銷售數據）\n【回傳結構】dict 含 period、period_days、total_products、slow_movers（滯銷商品列表）。";
+    readonly params: readonly [{
+        readonly name: "start_date";
+        readonly description: "分析區間起始 YYYY-MM-DD";
+        readonly default: null;
+        readonly hasDefault: false;
+        readonly kind: "string";
+        readonly optional: false;
+    }, {
+        readonly name: "end_date";
+        readonly description: "分析區間結束 YYYY-MM-DD";
+        readonly default: null;
+        readonly hasDefault: false;
+        readonly kind: "string";
+        readonly optional: false;
+    }, {
+        readonly name: "days_threshold";
+        readonly description: "可售天數門檻，超過此值視為滯銷";
+        readonly default: 30;
+        readonly hasDefault: true;
+        readonly kind: "integer";
+        readonly optional: false;
+    }];
+    readonly docEndpoints: readonly [{
+        readonly method: "GET";
+        readonly path: "/v1/products";
+    }, {
+        readonly method: "GET";
+        readonly path: "/v1/orders/search";
+    }];
+    readonly operations: readonly [{
+        readonly kind: "fetch_all_pages";
+        readonly method: "GET";
+        readonly endpointKey: "products";
+    }, {
+        readonly kind: "fetch_all_pages";
+        readonly method: "GET";
+        readonly endpointKey: "orders_search";
+        readonly params: "params";
+    }];
+    readonly sourceLocation: {
+        readonly line: 941;
+        readonly endLine: 1036;
+    };
+}, {
+    readonly module: "tools/category_tools.py";
+    readonly name: "get_category_tree";
+    readonly write: false;
+    readonly description: "取得所有商品分類並組成樹狀結構。\n\n【用途】\n瀏覽商店的完整分類層級，了解分類架構與父子關係。\n可用於確認分類 ID、名稱，再搭配 get_category_detail 取得個別分類詳情，\n或搭配商品工具按分類篩選商品。\n\n【呼叫的 Shopline API】\n- GET /v1/categories\n\n【回傳結構】\ndict 含 total, tree[]（樹狀）, flat[]（扁平列表）。\n每個節點包含 id, name, parent_id, children[]（僅在 tree 中）。";
+    readonly params: readonly [];
+    readonly docEndpoints: readonly [{
+        readonly method: "GET";
+        readonly path: "/v1/categories";
+    }];
+    readonly operations: readonly [{
+        readonly kind: "fetch_all_pages";
+        readonly method: "GET";
+        readonly endpointKey: "categories";
+    }];
+    readonly sourceLocation: {
+        readonly line: 16;
+        readonly endLine: 58;
+    };
+}, {
+    readonly module: "tools/category_tools.py";
+    readonly name: "get_category_detail";
+    readonly write: false;
+    readonly description: "取得單一商品分類的完整詳情。\n\n【用途】\n查詢特定分類的名稱、描述、父分類等完整資訊。\n適合在已知分類 ID 的情況下取得詳細欄位。\n\n【呼叫的 Shopline API】\n- GET /v1/categories/{category_id}\n\n【回傳結構】\ndict 包含 id, name, parent_id, description, position, created_at, updated_at。";
+    readonly params: readonly [{
+        readonly name: "category_id";
+        readonly description: "分類 ID（由 get_category_tree 回傳的 id 欄位）";
+        readonly default: null;
+        readonly hasDefault: false;
+        readonly kind: "string";
+        readonly optional: false;
+    }];
+    readonly docEndpoints: readonly [{
+        readonly method: "GET";
+        readonly path: "/v1/categories/{category_id}";
+    }];
+    readonly operations: readonly [{
+        readonly kind: "api_get";
+        readonly method: "GET";
+        readonly endpointKey: "category_detail";
+        readonly path_params: "{'category_id': category_id}";
+    }];
+    readonly sourceLocation: {
+        readonly line: 62;
+        readonly endLine: 89;
+    };
+}, {
+    readonly module: "tools/channel_tools.py";
+    readonly name: "list_channels";
+    readonly write: false;
+    readonly description: "取得商店所有銷售渠道清單。\n\n【用途】\n查看商店目前開啟的銷售渠道，例如線上商店、POS、\nFacebook、Instagram 等。適合了解多渠道銷售佈局，\n或做渠道業績分析前的渠道資料確認。\n\n注意：此端點在部分 token 權限下可能回傳 403 或 422，\n渠道資訊亦可從訂單的 channel.created_by_channel_name\n欄位取得。\n\n【呼叫的 Shopline API】\n- GET /v1/channels\n\n【回傳結構】\ndict 含 total, channels[]。\n每個 channel 包含 id, name, channel_type, enabled,\ncreated_at 等。";
+    readonly params: readonly [];
+    readonly docEndpoints: readonly [{
+        readonly method: "GET";
+        readonly path: "/v1/channels";
+    }];
+    readonly operations: readonly [{
+        readonly kind: "api_get";
+        readonly method: "GET";
+        readonly endpointKey: "channels";
+    }];
+    readonly sourceLocation: {
+        readonly line: 13;
+        readonly endLine: 49;
+    };
+}, {
+    readonly module: "tools/channel_tools.py";
+    readonly name: "get_channel_detail";
+    readonly write: false;
+    readonly description: "取得指定銷售渠道的詳細資訊。\n\n【用途】\n查詢單一銷售渠道的完整設定，包含渠道類型、狀態、\n連結設定等。適合確認特定渠道的詳細配置。\n\n注意：此端點在部分 token 權限下可能回傳 403 或 422。\n\n【呼叫的 Shopline API】\n- GET /v1/channels/{channel_id}\n\n【回傳結構】\ndict 含渠道詳細欄位：id, name, channel_type, enabled,\ncreated_at, updated_at 等。";
+    readonly params: readonly [{
+        readonly name: "channel_id";
+        readonly description: "";
+        readonly default: null;
+        readonly hasDefault: false;
+        readonly kind: "string";
+        readonly optional: false;
+    }];
+    readonly docEndpoints: readonly [{
+        readonly method: "GET";
+        readonly path: "/v1/channels/{channel_id}";
+    }];
+    readonly operations: readonly [{
+        readonly kind: "api_get";
+        readonly method: "GET";
+        readonly endpointKey: "channel_detail";
+        readonly path_params: "{'channel_id': channel_id}";
+    }];
+    readonly sourceLocation: {
+        readonly line: 53;
+        readonly endLine: 79;
+    };
+}, {
+    readonly module: "tools/conversation_tools.py";
+    readonly name: "list_conversations";
+    readonly write: false;
+    readonly description: "取得客服對話列表。\n\n【用途】\n瀏覽所有客服對話的摘要清單，了解目前進行中或歷史的客服溝通狀況。\n可依此清單篩選需要進一步查閱訊息內容的對話，再用 get_conversation_messages\n取得完整聊天記錄。\n\n【呼叫的 Shopline API】\n- GET /v1/conversations\n\n【回傳結構】\ndict 含 total_found, returned, conversations[]。\n每個 conversation 包含 id, platform（通訊平台）, status（對話狀態）,\ncreated_at。";
+    readonly params: readonly [{
+        readonly name: "max_results";
+        readonly description: "最多回傳筆數";
+        readonly default: 50;
+        readonly hasDefault: true;
+        readonly kind: "integer";
+        readonly optional: false;
+    }];
+    readonly docEndpoints: readonly [{
+        readonly method: "GET";
+        readonly path: "/v1/conversations";
+    }];
+    readonly operations: readonly [{
+        readonly kind: "fetch_all_pages";
+        readonly method: "GET";
+        readonly endpointKey: "conversations";
+    }];
+    readonly sourceLocation: {
+        readonly line: 16;
+        readonly endLine: 50;
+    };
+}, {
+    readonly module: "tools/conversation_tools.py";
+    readonly name: "get_conversation_messages";
+    readonly write: false;
+    readonly description: "取得指定對話的完整訊息記錄。\n\n【用途】\n查閱特定客服對話的所有聊天訊息，適用於了解客戶問題脈絡、審核客服回應品質，\n或追蹤訂單相關諮詢的處理進度。對話 ID 從 list_conversations 取得。\n\n【呼叫的 Shopline API】\n- GET /v1/conversations/{conversation_id}/messages\n\n【回傳結構】\ndict 含 conversation_id, total_found, returned, messages[]。\n每個 message 包含 id, sender_type（發送者類型：customer/staff）,\ncontent（訊息內容）, message_type, created_at。";
+    readonly params: readonly [{
+        readonly name: "conversation_id";
+        readonly description: "對話 ID（由 list_conversations 回傳的 id 欄位）";
+        readonly default: null;
+        readonly hasDefault: false;
+        readonly kind: "string";
+        readonly optional: false;
+    }, {
+        readonly name: "max_results";
+        readonly description: "最多回傳訊息筆數";
+        readonly default: 50;
+        readonly hasDefault: true;
+        readonly kind: "integer";
+        readonly optional: false;
+    }];
+    readonly docEndpoints: readonly [{
+        readonly method: "GET";
+        readonly path: "/v1/conversations/{conversation_id}/messages";
+    }];
+    readonly operations: readonly [{
+        readonly kind: "fetch_all_pages";
+        readonly method: "GET";
+        readonly endpointKey: "conversation_messages";
+        readonly path_params: "path_params";
+    }];
+    readonly sourceLocation: {
+        readonly line: 54;
+        readonly endLine: 95;
+    };
+}, {
+    readonly module: "tools/custom_field_tools.py";
+    readonly name: "list_custom_fields";
+    readonly write: false;
+    readonly description: "取得商店定義的客戶自訂欄位清單。\n\n【用途】\n查看商店在客戶資料上設定了哪些額外自訂欄位（如生日、偏好、備註等）。\n用於了解客戶資料結構或分析資料完整度。\n\n【呼叫的 Shopline API】\n- GET /v1/custom_fields\n\n【回傳結構】\ndict 含 total, fields[]。\n每個 field 包含 id, name, type, options 等。";
+    readonly params: readonly [];
+    readonly docEndpoints: readonly [{
+        readonly method: "GET";
+        readonly path: "/v1/custom_fields";
+    }];
+    readonly operations: readonly [{
+        readonly kind: "api_get";
+        readonly method: "GET";
+        readonly endpointKey: "custom_fields";
+    }];
+    readonly sourceLocation: {
+        readonly line: 13;
+        readonly endLine: 44;
+    };
+}, {
+    readonly module: "tools/customer_group_tools.py";
+    readonly name: "list_customer_groups";
+    readonly write: false;
+    readonly description: "取得客戶群組列表，支援依名稱搜尋。\n\n【用途】\n瀏覽或搜尋已建立的客戶群組（分群）。可用於確認客戶標籤分群策略、\n取得群組 ID 後進一步查詢群組成員。\n\n【呼叫的 Shopline API】\n- GET /v1/customer-groups（無搜尋條件時）\n- GET /v1/customer-groups/search（有搜尋條件時）\n\n【回傳結構】\ndict 含 total_found, returned, groups[]。\n每個 group 包含 id, name, customers_count, created_at。";
+    readonly params: readonly [{
+        readonly name: "search_keyword";
+        readonly description: "群組名稱搜尋關鍵字";
+        readonly default: null;
+        readonly hasDefault: true;
+        readonly kind: "string";
+        readonly optional: true;
+    }, {
+        readonly name: "max_results";
+        readonly description: "最多回傳筆數";
+        readonly default: 50;
+        readonly hasDefault: true;
+        readonly kind: "integer";
+        readonly optional: false;
+    }];
+    readonly docEndpoints: readonly [{
+        readonly method: "GET";
+        readonly path: "/v1/customer-groups";
+    }, {
+        readonly method: "GET";
+        readonly path: "/v1/customer-groups/search";
+    }];
+    readonly operations: readonly [{
+        readonly kind: "api_get";
+        readonly method: "GET";
+        readonly endpointKey: "customer_groups_search";
+        readonly params: "params";
+    }, {
+        readonly kind: "fetch_all_pages";
+        readonly method: "GET";
+        readonly endpointKey: "customer_groups";
+    }];
+    readonly sourceLocation: {
+        readonly line: 16;
+        readonly endLine: 56;
+    };
+}, {
+    readonly module: "tools/customer_group_tools.py";
+    readonly name: "get_customer_group_members";
+    readonly write: false;
+    readonly description: "取得指定客戶群組中的所有客戶 ID 列表。\n\n【用途】\n查詢特定群組包含哪些客戶。回傳客戶 ID 列表，可搭配 get_customer_profile 取得個別客戶詳情。\n\n【呼叫的 Shopline API】\n- GET /v1/customer-groups/{group_id}/customers\n\n【回傳結構】\ndict 含 group_id, total_members, customer_ids[]。";
+    readonly params: readonly [{
+        readonly name: "group_id";
+        readonly description: "客戶群組 ID（由 list_customer_groups 回傳）";
+        readonly default: null;
+        readonly hasDefault: false;
+        readonly kind: "string";
+        readonly optional: false;
+    }];
+    readonly docEndpoints: readonly [{
+        readonly method: "GET";
+        readonly path: "/v1/customer-groups/{group_id}/customers";
+    }];
+    readonly operations: readonly [{
+        readonly kind: "api_get";
+        readonly method: "GET";
+        readonly endpointKey: "customer_group_customers";
+        readonly path_params: "{'group_id': group_id}";
+    }];
+    readonly sourceLocation: {
+        readonly line: 60;
+        readonly endLine: 81;
+    };
+}, {
+    readonly module: "tools/customer_tools.py";
+    readonly name: "list_customers";
+    readonly write: false;
+    readonly description: "取得客戶列表，支援依關鍵字搜尋客戶。\n\n【用途】\n查詢特定客戶或瀏覽客戶清單。可用姓名、email、電話搜尋。\n若要取得單一客戶的完整資訊（含儲值金、點數、等級），請改用 get_customer_profile。\n\n【呼叫的 Shopline API】\n- GET /v1/customers（無搜尋條件時）\n- GET /v1/customers/search（有搜尋條件時）\n\n【回傳結構】\ndict 含 total_found, returned, customers[]。\n每個 customer 包含 id, name, email, phone, tags, created_at。";
+    readonly params: readonly [{
+        readonly name: "search_keyword";
+        readonly description: "搜尋關鍵字（姓名、email、電話）";
+        readonly default: null;
+        readonly hasDefault: true;
+        readonly kind: "string";
+        readonly optional: true;
+    }, {
+        readonly name: "max_results";
+        readonly description: "最多回傳筆數";
+        readonly default: 50;
+        readonly hasDefault: true;
+        readonly kind: "integer";
+        readonly optional: false;
+    }];
+    readonly docEndpoints: readonly [{
+        readonly method: "GET";
+        readonly path: "/v1/customers";
+    }, {
+        readonly method: "GET";
+        readonly path: "/v1/customers/search";
+    }];
+    readonly operations: readonly [{
+        readonly kind: "api_get";
+        readonly method: "GET";
+        readonly endpointKey: "customers_search";
+        readonly params: "params";
+    }, {
+        readonly kind: "fetch_all_pages";
+        readonly method: "GET";
+        readonly endpointKey: "customers";
+    }];
+    readonly sourceLocation: {
+        readonly line: 18;
+        readonly endLine: 64;
+    };
+}, {
+    readonly module: "tools/customer_tools.py";
+    readonly name: "get_customer_profile";
+    readonly write: false;
+    readonly description: "取得單一客戶的完整輪廓（基本資料 + 儲值金紀錄 + 會員點數 + 會員等級變動 + 優惠券）。\n\n【用途】\n回答「這位客戶是誰、消費狀況、會員狀態」等完整客戶概況問題。適合客服\n場景或個別會員分析。若要批次分析客戶行為請改用 get_rfm_analysis。\n\n【呼叫的 Shopline API】\n- GET /v1/customers/{customer_id}\n- GET /v1/customers/{customer_id}/store-credit-history\n- GET /v1/customers/{customer_id}/member-points\n- GET /v1/customers/{customer_id}/membership-tier-history\n- GET /v1/customers/{customer_id}/promotions\n\n【回傳結構】\ndict 包含 profile / store_credits / member_points / tier_history / promotions 五大區塊。\n金額皆為 float (TWD)。";
+    readonly params: readonly [{
+        readonly name: "customer_id";
+        readonly description: "客戶內部 ID（由 list_customers 回傳的 id 欄位）";
+        readonly default: null;
+        readonly hasDefault: false;
+        readonly kind: "string";
+        readonly optional: false;
+    }];
+    readonly docEndpoints: readonly [{
+        readonly method: "GET";
+        readonly path: "/v1/customers/{customer_id}";
+    }, {
+        readonly method: "GET";
+        readonly path: "/v1/customers/{customer_id}/store-credit-history";
+    }, {
+        readonly method: "GET";
+        readonly path: "/v1/customers/{customer_id}/member-points";
+    }, {
+        readonly method: "GET";
+        readonly path: "/v1/customers/{customer_id}/membership-tier-history";
+    }, {
+        readonly method: "GET";
+        readonly path: "/v1/customers/{customer_id}/promotions";
+    }];
+    readonly operations: readonly [{
+        readonly kind: "api_get";
+        readonly method: "GET";
+        readonly endpointKey: "customer_detail";
+        readonly path_params: "path_params";
+    }, {
+        readonly kind: "api_get";
+        readonly method: "GET";
+        readonly endpointKey: "customer_store_credit_history";
+        readonly path_params: "path_params";
+    }, {
+        readonly kind: "api_get";
+        readonly method: "GET";
+        readonly endpointKey: "customer_member_points";
+        readonly path_params: "path_params";
+    }, {
+        readonly kind: "api_get";
+        readonly method: "GET";
+        readonly endpointKey: "customer_membership_tier_history";
+        readonly path_params: "path_params";
+    }, {
+        readonly kind: "api_get";
+        readonly method: "GET";
+        readonly endpointKey: "customer_promotions";
+        readonly path_params: "path_params";
+    }];
+    readonly sourceLocation: {
+        readonly line: 68;
+        readonly endLine: 168;
+    };
+}, {
+    readonly module: "tools/delivery_option_tools.py";
+    readonly name: "list_delivery_options";
+    readonly write: false;
+    readonly description: "取得商店啟用的配送方式清單。\n\n【用途】\n查看商店目前設定的所有配送方式，例如宅配、超商取貨、\n門市自取等。適合確認可用配送渠道或分析訂單配送偏好。\n\n【呼叫的 Shopline API】\n- GET /v1/delivery_options\n\n【回傳結構】\ndict 含 total, delivery_options[]。\n每個 delivery_option 包含 id, name, delivery_type,\nenabled, position, price, created_at 等。";
+    readonly params: readonly [];
+    readonly docEndpoints: readonly [{
+        readonly method: "GET";
+        readonly path: "/v1/delivery_options";
+    }];
+    readonly operations: readonly [{
+        readonly kind: "api_get";
+        readonly method: "GET";
+        readonly endpointKey: "delivery_options";
+    }];
+    readonly sourceLocation: {
+        readonly line: 13;
+        readonly endLine: 46;
+    };
+}, {
+    readonly module: "tools/delivery_option_tools.py";
+    readonly name: "get_delivery_option_detail";
+    readonly write: false;
+    readonly description: "取得指定配送方式的詳細資訊。\n\n【用途】\n查詢單一配送方式的完整設定，包含費率規則、地區限制、\n重量限制等。適合確認特定配送方式的詳細條件。\n\n【呼叫的 Shopline API】\n- GET /v1/delivery_options/{delivery_option_id}\n\n【回傳結構】\ndict 含配送方式詳細欄位：id, name, delivery_type,\nenabled, price, weight_limit, regions, created_at 等。";
+    readonly params: readonly [{
+        readonly name: "delivery_option_id";
+        readonly description: "";
+        readonly default: null;
+        readonly hasDefault: false;
+        readonly kind: "string";
+        readonly optional: false;
+    }];
+    readonly docEndpoints: readonly [{
+        readonly method: "GET";
+        readonly path: "/v1/delivery_options/{delivery_option_id}";
+    }];
+    readonly operations: readonly [{
+        readonly kind: "api_get";
+        readonly method: "GET";
+        readonly endpointKey: "delivery_option_detail";
+        readonly path_params: "{'delivery_option_id': delivery_option_id}";
+    }];
+    readonly sourceLocation: {
+        readonly line: 50;
+        readonly endLine: 81;
+    };
+}, {
+    readonly module: "tools/delivery_option_tools.py";
+    readonly name: "get_delivery_time_slots";
+    readonly write: false;
+    readonly description: "取得指定配送方式的可用時段清單。\n\n【用途】\n查詢特定配送方式的預約時段設定，例如到府配送的時間選項。\n適合確認預約配送時段或分析客戶配送時段偏好。\n\n【呼叫的 Shopline API】\n- GET /v1/delivery_options/{delivery_option_id}/time_slots\n\n【回傳結構】\ndict 含 delivery_option_id, total, time_slots[]。\n每個 time_slot 包含 id, day, start_time, end_time, enabled 等。";
+    readonly params: readonly [{
+        readonly name: "delivery_option_id";
+        readonly description: "";
+        readonly default: null;
+        readonly hasDefault: false;
+        readonly kind: "string";
+        readonly optional: false;
+    }];
+    readonly docEndpoints: readonly [{
+        readonly method: "GET";
+        readonly path: "/v1/delivery_options/{delivery_option_id}/time_slots";
+    }];
+    readonly operations: readonly [{
+        readonly kind: "api_get";
+        readonly method: "GET";
+        readonly endpointKey: "delivery_option_time_slots";
+        readonly path_params: "{'delivery_option_id': delivery_option_id}";
+    }];
+    readonly sourceLocation: {
+        readonly line: 85;
+        readonly endLine: 120;
+    };
+}, {
+    readonly module: "tools/flash_price_tools.py";
+    readonly name: "list_flash_price_campaigns";
+    readonly write: false;
+    readonly description: "取得快閃價格活動列表。\n\n【用途】\n瀏覽商店所有快閃特賣（限時特價）活動，了解活動名稱、狀態與時間範圍。\n可取得 campaign_id 後進一步呼叫 get_flash_price_campaign_detail 查詢完整詳情。\n\n【呼叫的 Shopline API】\n- GET /v1/flash_price_campaigns\n\n【回傳結構】\ndict 含 total_found, returned, items[]。\n每筆包含 id, title, status, start_at, end_at, created_at。";
+    readonly params: readonly [{
+        readonly name: "max_results";
+        readonly description: "最多回傳筆數";
+        readonly default: 50;
+        readonly hasDefault: true;
+        readonly kind: "integer";
+        readonly optional: false;
+    }];
+    readonly docEndpoints: readonly [{
+        readonly method: "GET";
+        readonly path: "/v1/flash_price_campaigns";
+    }];
+    readonly operations: readonly [{
+        readonly kind: "fetch_all_pages";
+        readonly method: "GET";
+        readonly endpointKey: "flash_price_campaigns";
+    }];
+    readonly sourceLocation: {
+        readonly line: 16;
+        readonly endLine: 50;
+    };
+}, {
+    readonly module: "tools/flash_price_tools.py";
+    readonly name: "get_flash_price_campaign_detail";
+    readonly write: false;
+    readonly description: "取得單一快閃價格活動的完整詳情。\n\n【用途】\n查詢特定快閃特賣活動的折扣規則、適用商品與時間設定等完整資訊。\n適合在已知 campaign_id 的情況下取得所有欄位。\n\n【呼叫的 Shopline API】\n- GET /v1/flash_price_campaigns/{campaign_id}\n\n【回傳結構】\ndict 包含 id, title, status, discount_type, discount_value,\nproducts, start_at, end_at, created_at, updated_at 等完整欄位。";
+    readonly params: readonly [{
+        readonly name: "campaign_id";
+        readonly description: "快閃價格活動 ID（由 list_flash_price_campaigns 回傳的 id 欄位）";
+        readonly default: null;
+        readonly hasDefault: false;
+        readonly kind: "string";
+        readonly optional: false;
+    }];
+    readonly docEndpoints: readonly [{
+        readonly method: "GET";
+        readonly path: "/v1/flash_price_campaigns/{campaign_id}";
+    }];
+    readonly operations: readonly [{
+        readonly kind: "api_get";
+        readonly method: "GET";
+        readonly endpointKey: "flash_price_campaign_detail";
+        readonly path_params: "{'campaign_id': campaign_id}";
+    }];
+    readonly sourceLocation: {
+        readonly line: 54;
+        readonly endLine: 84;
+    };
+}, {
+    readonly module: "tools/gift_tools.py";
+    readonly name: "list_gifts";
+    readonly write: false;
+    readonly description: "取得贈品列表，支援依關鍵字搜尋。\n\n【用途】\n瀏覽或搜尋商店所有贈品設定，了解贈品名稱、庫存與適用條件。\n若提供搜尋關鍵字則呼叫搜尋端點，否則列出所有贈品。\n\n【呼叫的 Shopline API】\n- GET /v1/gifts（無搜尋條件時）\n- GET /v1/gifts/search（有搜尋條件時）\n\n【回傳結構】\ndict 含 total_found, returned, items[]。\n每筆包含 id, name, sku, quantity, status, created_at。";
+    readonly params: readonly [{
+        readonly name: "search_keyword";
+        readonly description: "搜尋關鍵字（贈品名稱）";
+        readonly default: null;
+        readonly hasDefault: true;
+        readonly kind: "string";
+        readonly optional: true;
+    }, {
+        readonly name: "max_results";
+        readonly description: "最多回傳筆數";
+        readonly default: 50;
+        readonly hasDefault: true;
+        readonly kind: "integer";
+        readonly optional: false;
+    }];
+    readonly docEndpoints: readonly [{
+        readonly method: "GET";
+        readonly path: "/v1/gifts";
+    }, {
+        readonly method: "GET";
+        readonly path: "/v1/gifts/search";
+    }];
+    readonly operations: readonly [{
+        readonly kind: "api_get";
+        readonly method: "GET";
+        readonly endpointKey: "gifts_search";
+        readonly params: "params";
+    }, {
+        readonly kind: "fetch_all_pages";
+        readonly method: "GET";
+        readonly endpointKey: "gifts";
+    }];
+    readonly sourceLocation: {
+        readonly line: 16;
+        readonly endLine: 59;
+    };
+}, {
+    readonly module: "tools/member_point_tools.py";
+    readonly name: "list_member_point_rules";
+    readonly write: false;
+    readonly description: "取得商店的會員點數規則設定。\n\n【用途】\n查看商店設定的點數回饋規則（消費回饋比例、點數到期規則等）。\n用於分析會員忠誠度計畫或對照客戶點數異動。\n\n【呼叫的 Shopline API】\n- GET /v1/member_point_rules\n\n【回傳結構】\ndict 含 total, rules[]。\n每條規則含 id, name, type, value, conditions 等。";
+    readonly params: readonly [];
+    readonly docEndpoints: readonly [{
+        readonly method: "GET";
+        readonly path: "/v1/member_point_rules";
+    }];
+    readonly operations: readonly [{
+        readonly kind: "api_get";
+        readonly method: "GET";
+        readonly endpointKey: "member_point_rules";
+    }];
+    readonly sourceLocation: {
+        readonly line: 13;
+        readonly endLine: 45;
+    };
+}, {
+    readonly module: "tools/membership_tier_tools.py";
+    readonly name: "list_membership_tiers";
+    readonly write: false;
+    readonly description: "取得商店的所有會員等級定義。\n\n【用途】\n查看商店設定了哪些會員等級、升等門檻、各等級權益。\n用於分析會員結構或確認等級設定。\n\n【呼叫的 Shopline API】\n- GET /v1/membership_tiers\n\n【回傳結構】\ndict 含 total, tiers[]。\n每個 tier 包含 id, name, threshold, benefits 等。";
+    readonly params: readonly [];
+    readonly docEndpoints: readonly [{
+        readonly method: "GET";
+        readonly path: "/v1/membership_tiers";
+    }];
+    readonly operations: readonly [{
+        readonly kind: "api_get";
+        readonly method: "GET";
+        readonly endpointKey: "membership_tiers";
+    }];
+    readonly sourceLocation: {
+        readonly line: 15;
+        readonly endLine: 46;
+    };
+}, {
+    readonly module: "tools/membership_tier_tools.py";
+    readonly name: "get_customer_tier_history";
+    readonly write: false;
+    readonly description: "取得指定客戶的會員等級變動歷程。\n\n【用途】\n追蹤客戶會員等級升降紀錄，了解是升等還是降級、原因為何。\n搭配 list_membership_tiers 對照等級名稱。\n\n【呼叫的 Shopline API】\n- GET /v1/customers/{customer_id}/membership-tier-history\n\n【回傳結構】\ndict 含 customer_id, total_changes, history[]。\n每筆含 from_tier, to_tier, reason, created_at。";
+    readonly params: readonly [{
+        readonly name: "customer_id";
+        readonly description: "客戶內部 ID";
+        readonly default: null;
+        readonly hasDefault: false;
+        readonly kind: "string";
+        readonly optional: false;
+    }];
+    readonly docEndpoints: readonly [{
+        readonly method: "GET";
+        readonly path: "/v1/customers/{customer_id}/membership-tier-history";
+    }];
+    readonly operations: readonly [{
+        readonly kind: "api_get";
+        readonly method: "GET";
+        readonly endpointKey: "customer_membership_tier_history";
+        readonly path_params: "{'customer_id': customer_id}";
+    }];
+    readonly sourceLocation: {
+        readonly line: 50;
+        readonly endLine: 83;
+    };
+}, {
+    readonly module: "tools/merchant_tools.py";
+    readonly name: "list_merchants";
+    readonly write: false;
+    readonly description: "取得所有商家清單。\n\n【用途】\n查看此 API token 可存取的商家帳號列表。\n適合多商家環境下確認可操作的商家範圍。\n\n【呼叫的 Shopline API】\n- GET /v1/merchants\n\n【回傳結構】\ndict 含 total, merchants[]。\n每個 merchant 包含 id, name, handle, currency, locale, created_at 等。";
+    readonly params: readonly [];
+    readonly docEndpoints: readonly [{
+        readonly method: "GET";
+        readonly path: "/v1/merchants";
+    }];
+    readonly operations: readonly [{
+        readonly kind: "api_get";
+        readonly method: "GET";
+        readonly endpointKey: "merchants";
+    }];
+    readonly sourceLocation: {
+        readonly line: 13;
+        readonly endLine: 45;
+    };
+}, {
+    readonly module: "tools/merchant_tools.py";
+    readonly name: "get_merchant_detail";
+    readonly write: false;
+    readonly description: "取得指定商家的詳細資訊。\n\n【用途】\n查詢單一商家的完整設定資訊，包含聯絡資訊、幣別、語系等。\n適合確認特定商家設定或做資料核對。\n\n【呼叫的 Shopline API】\n- GET /v1/merchants/{merchant_id}\n\n【回傳結構】\ndict 含商家詳細欄位：id, name, handle, currency, locale,\ncountry, email, phone, address, created_at 等。";
+    readonly params: readonly [{
+        readonly name: "merchant_id";
+        readonly description: "";
+        readonly default: null;
+        readonly hasDefault: false;
+        readonly kind: "string";
+        readonly optional: false;
+    }];
+    readonly docEndpoints: readonly [{
+        readonly method: "GET";
+        readonly path: "/v1/merchants/{merchant_id}";
+    }];
+    readonly operations: readonly [{
+        readonly kind: "api_get";
+        readonly method: "GET";
+        readonly endpointKey: "merchant_detail";
+        readonly path_params: "{'merchant_id': merchant_id}";
+    }];
+    readonly sourceLocation: {
+        readonly line: 49;
+        readonly endLine: 79;
+    };
+}, {
+    readonly module: "tools/order_delivery_tools.py";
+    readonly name: "get_order_delivery";
+    readonly write: false;
+    readonly description: "取得單一配送單的完整資訊，包含物流狀態、追蹤編號及收件地址。\n\n【用途】\n查詢特定出貨單的配送狀態與物流詳情，適用於追蹤包裹、確認收件資料，\n或協助客服處理配送相關問題。配送單 ID 通常來自 get_order_detail 回傳的\n出貨資訊（shipments / deliveries 欄位）。\n\n【呼叫的 Shopline API】\n- GET /v1/order_deliveries/{delivery_id}\n\n【回傳結構】\ndict 包含：\n- id：配送單 ID\n- status：配送狀態（如 pending, shipped, delivered）\n- tracking_number：物流追蹤編號\n- tracking_url：物流追蹤連結\n- carrier：物流商名稱\n- shipping_address：收件地址（含姓名、電話、地址欄位）\n- line_items[]：出貨品項（商品名稱、數量）\n- created_at, updated_at";
+    readonly params: readonly [{
+        readonly name: "delivery_id";
+        readonly description: "配送單 ID（通常由訂單明細中的 delivery_id 欄位取得）";
+        readonly default: null;
+        readonly hasDefault: false;
+        readonly kind: "string";
+        readonly optional: false;
+    }];
+    readonly docEndpoints: readonly [{
+        readonly method: "GET";
+        readonly path: "/v1/order_deliveries/{delivery_id}";
+    }];
+    readonly operations: readonly [{
+        readonly kind: "api_get";
+        readonly method: "GET";
+        readonly endpointKey: "order_delivery_detail";
+        readonly path_params: "path_params";
+    }];
+    readonly sourceLocation: {
+        readonly line: 16;
+        readonly endLine: 76;
+    };
+}, {
+    readonly module: "tools/order_tools.py";
+    readonly name: "query_orders";
+    readonly write: false;
+    readonly description: "依時間區間、訂單狀態、通路來源查詢訂單列表。回傳精簡的訂單摘要。\n\n【呼叫的 Shopline API】\n- GET /v1/orders/search\n- GET /v1/orders";
+    readonly params: readonly [{
+        readonly name: "start_date";
+        readonly description: "起始日期 YYYY-MM-DD";
+        readonly default: null;
+        readonly hasDefault: false;
+        readonly kind: "string";
+        readonly optional: false;
+    }, {
+        readonly name: "end_date";
+        readonly description: "結束日期 YYYY-MM-DD";
+        readonly default: null;
+        readonly hasDefault: false;
+        readonly kind: "string";
+        readonly optional: false;
+    }, {
+        readonly name: "status";
+        readonly description: "訂單狀態篩選";
+        readonly default: null;
+        readonly hasDefault: true;
+        readonly kind: "enum";
+        readonly optional: true;
+        readonly enum: readonly ["pending", "confirmed", "completed", "cancelled"];
+    }, {
+        readonly name: "channel";
+        readonly description: "通路篩選: online=線上官網, pos=實體門市, all=全部";
+        readonly default: "all";
+        readonly hasDefault: true;
+        readonly kind: "enum";
+        readonly optional: false;
+        readonly enum: readonly ["online", "pos", "all"];
+    }, {
+        readonly name: "store_name";
+        readonly description: "門市名稱篩選（如：松菸誠品、新光A11）";
+        readonly default: null;
+        readonly hasDefault: true;
+        readonly kind: "string";
+        readonly optional: true;
+    }, {
+        readonly name: "max_results";
+        readonly description: "最多回傳筆數";
+        readonly default: 100;
+        readonly hasDefault: true;
+        readonly kind: "integer";
+        readonly optional: false;
+    }];
+    readonly docEndpoints: readonly [{
+        readonly method: "GET";
+        readonly path: "/v1/orders/search";
+    }, {
+        readonly method: "GET";
+        readonly path: "/v1/orders";
+    }];
+    readonly operations: readonly [{
+        readonly kind: "fetch_all_pages";
+        readonly method: "GET";
+        readonly endpointKey: "orders_search";
+        readonly params: "params";
+    }];
+    readonly sourceLocation: {
+        readonly line: 28;
+        readonly endLine: 97;
+    };
+}, {
+    readonly module: "tools/order_tools.py";
+    readonly name: "get_sales_summary";
+    readonly write: false;
+    readonly description: "取得指定時間區間的銷售摘要：營業額、訂單數、客單價、件單價、折扣總額等核心指標。支援依通路/門市篩選。";
+    readonly params: readonly [{
+        readonly name: "start_date";
+        readonly description: "起始日期 YYYY-MM-DD";
+        readonly default: null;
+        readonly hasDefault: false;
+        readonly kind: "string";
+        readonly optional: false;
+    }, {
+        readonly name: "end_date";
+        readonly description: "結束日期 YYYY-MM-DD";
+        readonly default: null;
+        readonly hasDefault: false;
+        readonly kind: "string";
+        readonly optional: false;
+    }, {
+        readonly name: "status";
+        readonly description: "訂單狀態";
+        readonly default: "completed";
+        readonly hasDefault: true;
+        readonly kind: "string";
+        readonly optional: false;
+    }, {
+        readonly name: "channel";
+        readonly description: "通路篩選";
+        readonly default: "all";
+        readonly hasDefault: true;
+        readonly kind: "enum";
+        readonly optional: false;
+        readonly enum: readonly ["online", "pos", "all"];
+    }, {
+        readonly name: "store_name";
+        readonly description: "門市名稱篩選";
+        readonly default: null;
+        readonly hasDefault: true;
+        readonly kind: "string";
+        readonly optional: true;
+    }];
+    readonly docEndpoints: readonly [];
+    readonly operations: readonly [{
+        readonly kind: "fetch_all_pages";
+        readonly method: "GET";
+        readonly endpointKey: "orders_search";
+        readonly params: "params";
+    }];
+    readonly sourceLocation: {
+        readonly line: 104;
+        readonly endLine: 198;
+    };
+}, {
+    readonly module: "tools/order_tools.py";
+    readonly name: "get_top_products";
+    readonly write: false;
+    readonly description: "取得指定時間區間的商品銷售排行榜（依銷量或營業額排序），或滯銷商品清單。";
+    readonly params: readonly [{
+        readonly name: "start_date";
+        readonly description: "起始日期 YYYY-MM-DD";
+        readonly default: null;
+        readonly hasDefault: false;
+        readonly kind: "string";
+        readonly optional: false;
+    }, {
+        readonly name: "end_date";
+        readonly description: "結束日期 YYYY-MM-DD";
+        readonly default: null;
+        readonly hasDefault: false;
+        readonly kind: "string";
+        readonly optional: false;
+    }, {
+        readonly name: "top_n";
+        readonly description: "顯示前 N 名";
+        readonly default: 20;
+        readonly hasDefault: true;
+        readonly kind: "integer";
+        readonly optional: false;
+    }, {
+        readonly name: "sort_by";
+        readonly description: "排序依據";
+        readonly default: "revenue";
+        readonly hasDefault: true;
+        readonly kind: "enum";
+        readonly optional: false;
+        readonly enum: readonly ["quantity", "revenue"];
+    }, {
+        readonly name: "channel";
+        readonly description: "通路篩選";
+        readonly default: "all";
+        readonly hasDefault: true;
+        readonly kind: "enum";
+        readonly optional: false;
+        readonly enum: readonly ["online", "pos", "all"];
+    }];
+    readonly docEndpoints: readonly [];
+    readonly operations: readonly [{
+        readonly kind: "fetch_all_pages";
+        readonly method: "GET";
+        readonly endpointKey: "orders_search";
+        readonly params: "params";
+    }];
+    readonly sourceLocation: {
+        readonly line: 205;
+        readonly endLine: 268;
+    };
+}, {
+    readonly module: "tools/order_tools.py";
+    readonly name: "get_sales_trend";
+    readonly write: false;
+    readonly description: "取得銷售趨勢數據，支援每日/每週/每月粒度，可用於繪製趨勢圖。";
+    readonly params: readonly [{
+        readonly name: "start_date";
+        readonly description: "起始日期 YYYY-MM-DD";
+        readonly default: null;
+        readonly hasDefault: false;
+        readonly kind: "string";
+        readonly optional: false;
+    }, {
+        readonly name: "end_date";
+        readonly description: "結束日期 YYYY-MM-DD";
+        readonly default: null;
+        readonly hasDefault: false;
+        readonly kind: "string";
+        readonly optional: false;
+    }, {
+        readonly name: "granularity";
+        readonly description: "時間粒度";
+        readonly default: "daily";
+        readonly hasDefault: true;
+        readonly kind: "enum";
+        readonly optional: false;
+        readonly enum: readonly ["daily", "weekly", "monthly"];
+    }, {
+        readonly name: "channel";
+        readonly description: "通路篩選";
+        readonly default: "all";
+        readonly hasDefault: true;
+        readonly kind: "enum";
+        readonly optional: false;
+        readonly enum: readonly ["online", "pos", "all"];
+    }];
+    readonly docEndpoints: readonly [];
+    readonly operations: readonly [{
+        readonly kind: "fetch_all_pages";
+        readonly method: "GET";
+        readonly endpointKey: "orders_search";
+        readonly params: "params";
+    }];
+    readonly sourceLocation: {
+        readonly line: 275;
+        readonly endLine: 333;
+    };
+}, {
+    readonly module: "tools/order_tools.py";
+    readonly name: "get_channel_comparison";
+    readonly write: false;
+    readonly description: "比較各門市/通路的同期業績：營業額、訂單數、客單價等。支援線上 vs 門市，或門市之間的比較。";
+    readonly params: readonly [{
+        readonly name: "start_date";
+        readonly description: "起始日期 YYYY-MM-DD";
+        readonly default: null;
+        readonly hasDefault: false;
+        readonly kind: "string";
+        readonly optional: false;
+    }, {
+        readonly name: "end_date";
+        readonly description: "結束日期 YYYY-MM-DD";
+        readonly default: null;
+        readonly hasDefault: false;
+        readonly kind: "string";
+        readonly optional: false;
+    }];
+    readonly docEndpoints: readonly [];
+    readonly operations: readonly [{
+        readonly kind: "fetch_all_pages";
+        readonly method: "GET";
+        readonly endpointKey: "orders_search";
+        readonly params: "params";
+    }];
+    readonly sourceLocation: {
+        readonly line: 340;
+        readonly endLine: 391;
+    };
+}, {
+    readonly module: "tools/order_tools.py";
+    readonly name: "get_order_detail";
+    readonly write: false;
+    readonly description: "取得單筆訂單的完整資訊，包含商品明細、付款、物流、折扣等。";
+    readonly params: readonly [{
+        readonly name: "order_id";
+        readonly description: "訂單內部 ID（由 query_orders 回傳的 id 欄位，非 order_number）";
+        readonly default: null;
+        readonly hasDefault: false;
+        readonly kind: "string";
+        readonly optional: false;
+    }];
+    readonly docEndpoints: readonly [];
+    readonly operations: readonly [{
+        readonly kind: "api_get";
+        readonly method: "GET";
+        readonly endpointKey: "order_detail";
+        readonly path_params: "{'order_id': order_id}";
+    }];
+    readonly sourceLocation: {
+        readonly line: 398;
+        readonly endLine: 455;
+    };
+}, {
+    readonly module: "tools/order_tools.py";
+    readonly name: "get_refund_summary";
+    readonly write: false;
+    readonly description: "取得指定時間區間的退貨退款統計：退款金額、退貨筆數、退貨率、退貨商品明細。支援計算淨營收。";
+    readonly params: readonly [{
+        readonly name: "start_date";
+        readonly description: "起始日期 YYYY-MM-DD";
+        readonly default: null;
+        readonly hasDefault: false;
+        readonly kind: "string";
+        readonly optional: false;
+    }, {
+        readonly name: "end_date";
+        readonly description: "結束日期 YYYY-MM-DD";
+        readonly default: null;
+        readonly hasDefault: false;
+        readonly kind: "string";
+        readonly optional: false;
+    }];
+    readonly docEndpoints: readonly [];
+    readonly operations: readonly [{
+        readonly kind: "fetch_all_pages";
+        readonly method: "GET";
+        readonly endpointKey: "return_orders";
+        readonly params: "params";
+    }];
+    readonly sourceLocation: {
+        readonly line: 462;
+        readonly endLine: 513;
+    };
+}, {
+    readonly module: "tools/order_tools.py";
+    readonly name: "get_archived_orders";
+    readonly write: false;
+    readonly description: "【用途】查詢已封存（archived）的歷史訂單列表，適合調閱長期歸檔的舊訂單資料。\n\n【呼叫的 Shopline API】\n- GET /v1/orders/archived\n\n【回傳結構】\n{\n  \"total_found\": int,        # 符合條件的總筆數\n  \"returned\": int,           # 實際回傳筆數\n  \"orders\": [                # 精簡訂單列表\n    {\n      \"id\": str,\n      \"order_number\": str,\n      \"status\": str,\n      \"channel\": str,        # \"POS\" 或 \"線上\"\n      \"store_name\": str,\n      \"total\": float,\n      \"subtotal\": float,\n      \"discount\": float,\n      \"payment_type\": str,\n      \"payment_status\": str,\n      \"delivery_type\": str,\n      \"delivery_status\": str,\n      \"customer_name\": str,\n      \"items_count\": int,\n      \"created_at\": str,\n    }\n  ]\n}";
+    readonly params: readonly [{
+        readonly name: "start_date";
+        readonly description: "起始日期 YYYY-MM-DD";
+        readonly default: null;
+        readonly hasDefault: false;
+        readonly kind: "string";
+        readonly optional: false;
+    }, {
+        readonly name: "end_date";
+        readonly description: "結束日期 YYYY-MM-DD";
+        readonly default: null;
+        readonly hasDefault: false;
+        readonly kind: "string";
+        readonly optional: false;
+    }, {
+        readonly name: "max_results";
+        readonly description: "最多回傳筆數";
+        readonly default: 100;
+        readonly hasDefault: true;
+        readonly kind: "integer";
+        readonly optional: false;
+    }];
+    readonly docEndpoints: readonly [{
+        readonly method: "GET";
+        readonly path: "/v1/orders/archived";
+    }];
+    readonly operations: readonly [{
+        readonly kind: "fetch_all_pages";
+        readonly method: "GET";
+        readonly endpointKey: "orders_archived";
+        readonly params: "params";
+    }];
+    readonly sourceLocation: {
+        readonly line: 520;
+        readonly endLine: 592;
+    };
+}, {
+    readonly module: "tools/order_tools.py";
+    readonly name: "get_order_labels";
+    readonly write: false;
+    readonly description: "【用途】取得指定訂單的配送標籤資訊，可用於列印物流面單或查詢寄件單號。\n\n【呼叫的 Shopline API】\n- GET /v1/orders/{order_id}/labels\n\n【回傳結構】\nAPI 原始回應，通常包含：\n{\n  \"labels\": [\n    {\n      \"tracking_number\": str,  # 物流追蹤號碼\n      \"carrier\": str,          # 物流商名稱\n      \"label_url\": str,        # 標籤列印 URL\n      ...\n    }\n  ]\n}";
+    readonly params: readonly [{
+        readonly name: "order_id";
+        readonly description: "訂單內部 ID（由 query_orders 回傳的 id 欄位，非 order_number）";
+        readonly default: null;
+        readonly hasDefault: false;
+        readonly kind: "string";
+        readonly optional: false;
+    }];
+    readonly docEndpoints: readonly [{
+        readonly method: "GET";
+        readonly path: "/v1/orders/{order_id}/labels";
+    }];
+    readonly operations: readonly [{
+        readonly kind: "api_get";
+        readonly method: "GET";
+        readonly endpointKey: "order_labels";
+        readonly path_params: "{'order_id': order_id}";
+    }];
+    readonly sourceLocation: {
+        readonly line: 599;
+        readonly endLine: 622;
+    };
+}, {
+    readonly module: "tools/order_tools.py";
+    readonly name: "get_order_tags";
+    readonly write: false;
+    readonly description: "【用途】取得指定訂單上附加的所有標籤，可用於分類管理或篩選特殊訂單。\n\n【呼叫的 Shopline API】\n- GET /v1/orders/{order_id}/tags\n\n【回傳結構】\n{\n  \"order_id\": str,   # 查詢的訂單 ID\n  \"tags\": list,      # 標籤列表（字串陣列）\n}";
+    readonly params: readonly [{
+        readonly name: "order_id";
+        readonly description: "訂單內部 ID（由 query_orders 回傳的 id 欄位，非 order_number）";
+        readonly default: null;
+        readonly hasDefault: false;
+        readonly kind: "string";
+        readonly optional: false;
+    }];
+    readonly docEndpoints: readonly [{
+        readonly method: "GET";
+        readonly path: "/v1/orders/{order_id}/tags";
+    }];
+    readonly operations: readonly [{
+        readonly kind: "api_get";
+        readonly method: "GET";
+        readonly endpointKey: "order_tags";
+        readonly path_params: "{'order_id': order_id}";
+    }];
+    readonly sourceLocation: {
+        readonly line: 629;
+        readonly endLine: 651;
+    };
+}, {
+    readonly module: "tools/order_tools.py";
+    readonly name: "get_order_action_logs";
+    readonly write: false;
+    readonly description: "【用途】取得指定訂單的所有操作歷程紀錄，包含狀態變更、人員操作、時間戳記等，適合稽核追蹤。\n\n【呼叫的 Shopline API】\n- GET /v1/orders/{order_id}/action-logs\n\n【回傳結構】\n{\n  \"order_id\": str,    # 查詢的訂單 ID\n  \"total\": int,       # 歷程總筆數\n  \"logs\": [           # 操作歷程列表\n    {\n      \"action\": str,      # 操作類型（如 status_changed, payment_updated）\n      \"operator\": str,    # 操作人員\n      \"created_at\": str,  # 操作時間\n      ...                 # 其他欄位依 API 回應而定\n    }\n  ]\n}";
+    readonly params: readonly [{
+        readonly name: "order_id";
+        readonly description: "訂單內部 ID（由 query_orders 回傳的 id 欄位，非 order_number）";
+        readonly default: null;
+        readonly hasDefault: false;
+        readonly kind: "string";
+        readonly optional: false;
+    }];
+    readonly docEndpoints: readonly [{
+        readonly method: "GET";
+        readonly path: "/v1/orders/{order_id}/action-logs";
+    }];
+    readonly operations: readonly [{
+        readonly kind: "api_get";
+        readonly method: "GET";
+        readonly endpointKey: "order_action_logs";
+        readonly path_params: "{'order_id': order_id}";
+    }];
+    readonly sourceLocation: {
+        readonly line: 658;
+        readonly endLine: 689;
+    };
+}, {
+    readonly module: "tools/order_tools.py";
+    readonly name: "get_order_transactions";
+    readonly write: false;
+    readonly description: "【用途】取得指定訂單的所有付款交易紀錄，包含付款金額、交易狀態、付款方式等，適合對帳與財務核查。\n\n【呼叫的 Shopline API】\n- GET /v1/orders/{order_id}/transactions\n\n【回傳結構】\n{\n  \"order_id\": str,          # 查詢的訂單 ID\n  \"total\": int,             # 交易筆數\n  \"transactions\": [         # 交易列表\n    {\n      \"id\": str,            # 交易 ID\n      \"kind\": str,          # 交易類型（sale, refund, void 等）\n      \"status\": str,        # 交易狀態\n      \"amount\": float,      # 交易金額（TWD）\n      \"gateway\": str,       # 付款閘道\n      \"created_at\": str,    # 交易時間\n      ...                   # 其他欄位依 API 回應而定\n    }\n  ]\n}";
+    readonly params: readonly [{
+        readonly name: "order_id";
+        readonly description: "訂單內部 ID（由 query_orders 回傳的 id 欄位，非 order_number）";
+        readonly default: null;
+        readonly hasDefault: false;
+        readonly kind: "string";
+        readonly optional: false;
+    }];
+    readonly docEndpoints: readonly [{
+        readonly method: "GET";
+        readonly path: "/v1/orders/{order_id}/transactions";
+    }];
+    readonly operations: readonly [{
+        readonly kind: "api_get";
+        readonly method: "GET";
+        readonly endpointKey: "order_transactions";
+        readonly path_params: "{'order_id': order_id}";
+    }];
+    readonly sourceLocation: {
+        readonly line: 696;
+        readonly endLine: 739;
+    };
+}, {
+    readonly module: "tools/payment_tools.py";
+    readonly name: "list_payments";
+    readonly write: false;
+    readonly description: "取得商店啟用的付款方式清單。\n\n【用途】\n查看商店目前設定的付款方式，例如信用卡、ATM 轉帳、\n貨到付款、第三方支付等。適合確認可用付款渠道或做訂單\n付款方式分析的參考。\n\n【呼叫的 Shopline API】\n- GET /v1/payments\n\n【回傳結構】\ndict 含 total, payments[]。\n每個 payment 包含 id, name, payment_type, enabled,\nposition, created_at 等。";
+    readonly params: readonly [];
+    readonly docEndpoints: readonly [{
+        readonly method: "GET";
+        readonly path: "/v1/payments";
+    }];
+    readonly operations: readonly [{
+        readonly kind: "api_get";
+        readonly method: "GET";
+        readonly endpointKey: "payments";
+    }];
+    readonly sourceLocation: {
+        readonly line: 13;
+        readonly endLine: 46;
+    };
+}, {
+    readonly module: "tools/product_tools.py";
+    readonly name: "get_product_list";
+    readonly write: false;
+    readonly description: "取得商品列表，含 SKU 變體、價格、品牌、庫存數量等資訊。\n\n【呼叫的 Shopline API】\n- GET /v1/products\n- GET /v1/products/search";
+    readonly params: readonly [{
+        readonly name: "keyword";
+        readonly description: "商品名稱關鍵字搜尋";
+        readonly default: null;
+        readonly hasDefault: true;
+        readonly kind: "string";
+        readonly optional: true;
+    }, {
+        readonly name: "brand";
+        readonly description: "品牌篩選";
+        readonly default: null;
+        readonly hasDefault: true;
+        readonly kind: "string";
+        readonly optional: true;
+    }, {
+        readonly name: "max_results";
+        readonly description: "最多回傳筆數";
+        readonly default: 50;
+        readonly hasDefault: true;
+        readonly kind: "integer";
+        readonly optional: false;
+    }];
+    readonly docEndpoints: readonly [{
+        readonly method: "GET";
+        readonly path: "/v1/products";
+    }, {
+        readonly method: "GET";
+        readonly path: "/v1/products/search";
+    }];
+    readonly operations: readonly [{
+        readonly kind: "fetch_all_pages";
+        readonly method: "GET";
+        readonly endpointKey: "products";
+    }];
+    readonly sourceLocation: {
+        readonly line: 22;
+        readonly endLine: 82;
+    };
+}, {
+    readonly module: "tools/product_tools.py";
+    readonly name: "get_product_variants";
+    readonly write: false;
+    readonly description: "取得特定商品的所有 SKU 變體明細，含尺寸×顏色的庫存矩陣。\n\n【呼叫的 Shopline API】\n- GET /v1/products/{product_id}";
+    readonly params: readonly [{
+        readonly name: "product_id";
+        readonly description: "商品 ID";
+        readonly default: null;
+        readonly hasDefault: false;
+        readonly kind: "string";
+        readonly optional: false;
+    }];
+    readonly docEndpoints: readonly [{
+        readonly method: "GET";
+        readonly path: "/v1/products/{product_id}";
+    }];
+    readonly operations: readonly [{
+        readonly kind: "fetch_all_pages";
+        readonly method: "GET";
+        readonly endpointKey: "products";
+    }];
+    readonly sourceLocation: {
+        readonly line: 89;
+        readonly endLine: 137;
+    };
+}, {
+    readonly module: "tools/product_tools.py";
+    readonly name: "get_inventory_overview";
+    readonly write: false;
+    readonly description: "取得全商品庫存總覽：總庫存數量、庫存品項數、缺貨品項數等。從商品 variations 的 quantity 欄位計算。";
+    readonly params: readonly [{
+        readonly name: "brand";
+        readonly description: "品牌篩選";
+        readonly default: null;
+        readonly hasDefault: true;
+        readonly kind: "string";
+        readonly optional: true;
+    }];
+    readonly docEndpoints: readonly [];
+    readonly operations: readonly [{
+        readonly kind: "fetch_all_pages";
+        readonly method: "GET";
+        readonly endpointKey: "products";
+    }];
+    readonly sourceLocation: {
+        readonly line: 144;
+        readonly endLine: 223;
+    };
+}, {
+    readonly module: "tools/product_tools.py";
+    readonly name: "get_low_stock_alerts";
+    readonly write: false;
+    readonly description: "取得低庫存或缺貨的 SKU 清單，可自訂庫存門檻值。";
+    readonly params: readonly [{
+        readonly name: "threshold";
+        readonly description: "庫存低於此值即警示";
+        readonly default: 5;
+        readonly hasDefault: true;
+        readonly kind: "integer";
+        readonly optional: false;
+    }];
+    readonly docEndpoints: readonly [];
+    readonly operations: readonly [{
+        readonly kind: "fetch_all_pages";
+        readonly method: "GET";
+        readonly endpointKey: "products";
+    }];
+    readonly sourceLocation: {
+        readonly line: 230;
+        readonly endLine: 261;
+    };
+}, {
+    readonly module: "tools/product_tools.py";
+    readonly name: "get_warehouses";
+    readonly write: false;
+    readonly description: "取得所有倉庫/門市據點列表。";
+    readonly params: readonly [];
+    readonly docEndpoints: readonly [];
+    readonly operations: readonly [{
+        readonly kind: "api_get";
+        readonly method: "GET";
+        readonly endpointKey: "warehouses";
+        readonly params: "{'per_page': 50}";
+    }];
+    readonly sourceLocation: {
+        readonly line: 268;
+        readonly endLine: 283;
+    };
+}, {
+    readonly module: "tools/product_tools.py";
+    readonly name: "get_stock_by_warehouse";
+    readonly write: false;
+    readonly description: "取得商品在各倉庫/門市的庫存分佈矩陣。可查詢單一商品或全部商品的各倉庫庫存。";
+    readonly params: readonly [{
+        readonly name: "product_id";
+        readonly description: "商品 ID（不填則查詢全部商品，但較慢）";
+        readonly default: null;
+        readonly hasDefault: true;
+        readonly kind: "string";
+        readonly optional: true;
+    }, {
+        readonly name: "warehouse_id";
+        readonly description: "倉庫 ID 篩選（僅看特定倉庫）";
+        readonly default: null;
+        readonly hasDefault: true;
+        readonly kind: "string";
+        readonly optional: true;
+    }];
+    readonly docEndpoints: readonly [];
+    readonly operations: readonly [{
+        readonly kind: "api_get";
+        readonly method: "GET";
+        readonly endpointKey: "warehouses";
+        readonly params: "{'per_page': 50}";
+    }, {
+        readonly kind: "api_get";
+        readonly method: "GET";
+        readonly endpointKey: "product_stocks";
+        readonly path_params: "{'product_id': product_id}";
+    }, {
+        readonly kind: "fetch_all_pages";
+        readonly method: "GET";
+        readonly endpointKey: "products";
+    }, {
+        readonly kind: "api_get";
+        readonly method: "GET";
+        readonly endpointKey: "product_stocks";
+        readonly path_params: "{'product_id': p['id']}";
+    }];
+    readonly sourceLocation: {
+        readonly line: 290;
+        readonly endLine: 365;
+    };
+}, {
+    readonly module: "tools/product_tools.py";
+    readonly name: "get_locked_inventory";
+    readonly write: false;
+    readonly description: "【用途】\n取得目前被鎖定（預留）的庫存商品清單，協助分析哪些 SKU 有待出貨的預留數量。\n\n【呼叫的 Shopline API】\n- GET /v1/products/locked-inventory\n\n【回傳結構】\n- total: 鎖定庫存的 SKU 總筆數\n- items: 每筆含 product_title、sku、locked_quantity";
+    readonly params: readonly [];
+    readonly docEndpoints: readonly [{
+        readonly method: "GET";
+        readonly path: "/v1/products/locked-inventory";
+    }];
+    readonly operations: readonly [{
+        readonly kind: "api_get";
+        readonly method: "GET";
+        readonly endpointKey: "products_locked_inventory";
+    }];
+    readonly sourceLocation: {
+        readonly line: 372;
+        readonly endLine: 398;
+    };
+}, {
+    readonly module: "tools/product_tools.py";
+    readonly name: "list_purchase_orders";
+    readonly write: false;
+    readonly description: "【用途】\n取得 POS 採購單列表，用於了解進貨狀況與採購歷史。\n\n【呼叫的 Shopline API】\n- GET /v1/pos/purchase_orders\n\n【回傳結構】\n- total_found: 查詢到的採購單總數\n- returned: 實際回傳筆數\n- purchase_orders: 每筆含 id、status、total、created_at";
+    readonly params: readonly [{
+        readonly name: "max_results";
+        readonly description: "最多回傳筆數";
+        readonly default: 50;
+        readonly hasDefault: true;
+        readonly kind: "integer";
+        readonly optional: false;
+    }];
+    readonly docEndpoints: readonly [{
+        readonly method: "GET";
+        readonly path: "/v1/pos/purchase_orders";
+    }];
+    readonly operations: readonly [{
+        readonly kind: "fetch_all_pages";
+        readonly method: "GET";
+        readonly endpointKey: "purchase_orders";
+    }];
+    readonly sourceLocation: {
+        readonly line: 405;
+        readonly endLine: 436;
+    };
+}, {
+    readonly module: "tools/product_tools.py";
+    readonly name: "get_purchase_order_detail";
+    readonly write: false;
+    readonly description: "【用途】\n取得單一 POS 採購單的完整明細，含採購品項、數量、金額等資訊。\n\n【呼叫的 Shopline API】\n- GET /v1/pos/purchase_orders/{purchase_order_id}\n\n【回傳結構】\n- id、status、created_at、total\n- items: 每筆含 product_title、sku、quantity、unit_cost";
+    readonly params: readonly [{
+        readonly name: "purchase_order_id";
+        readonly description: "採購單 ID";
+        readonly default: null;
+        readonly hasDefault: false;
+        readonly kind: "string";
+        readonly optional: false;
+    }];
+    readonly docEndpoints: readonly [{
+        readonly method: "GET";
+        readonly path: "/v1/pos/purchase_orders/{purchase_order_id}";
+    }];
+    readonly operations: readonly [{
+        readonly kind: "api_get";
+        readonly method: "GET";
+        readonly endpointKey: "purchase_order_detail";
+        readonly path_params: "{'purchase_order_id': purchase_order_id}";
+    }];
+    readonly sourceLocation: {
+        readonly line: 443;
+        readonly endLine: 476;
+    };
+}, {
+    readonly module: "tools/promotion_tools.py";
+    readonly name: "list_promotions";
+    readonly write: false;
+    readonly description: "取得促銷活動列表，支援依狀態篩選。\n\n【用途】\n瀏覽商店目前所有促銷活動，了解進行中、已排程或已結束的促銷。\n可用於分析促銷策略，或取得 promotion_id 後進一步查詢詳情。\n\n【呼叫的 Shopline API】\n- GET /v1/promotions\n\n【回傳結構】\ndict 含 total_found, returned, items[]。\n每筆包含 id, title, status, discount_type, start_at, end_at。";
+    readonly params: readonly [{
+        readonly name: "status";
+        readonly description: "促銷狀態篩選，例如 'active'、'inactive'、'scheduled'";
+        readonly default: null;
+        readonly hasDefault: true;
+        readonly kind: "string";
+        readonly optional: true;
+    }, {
+        readonly name: "max_results";
+        readonly description: "最多回傳筆數";
+        readonly default: 50;
+        readonly hasDefault: true;
+        readonly kind: "integer";
+        readonly optional: false;
+    }];
+    readonly docEndpoints: readonly [{
+        readonly method: "GET";
+        readonly path: "/v1/promotions";
+    }];
+    readonly operations: readonly [{
+        readonly kind: "fetch_all_pages";
+        readonly method: "GET";
+        readonly endpointKey: "promotions";
+        readonly params: "params";
+    }];
+    readonly sourceLocation: {
+        readonly line: 16;
+        readonly endLine: 57;
+    };
+}, {
+    readonly module: "tools/promotion_tools.py";
+    readonly name: "get_promotion_detail";
+    readonly write: false;
+    readonly description: "取得單一促銷活動的完整詳情。\n\n【用途】\n查詢特定促銷活動的折扣規則、適用商品、使用限制等完整資訊。\n適合在已知 promotion_id 的情況下取得所有欄位。\n\n【呼叫的 Shopline API】\n- GET /v1/promotions/{promotion_id}\n\n【回傳結構】\ndict 包含 id, title, status, discount_type, discount_value,\ntarget_type, conditions, start_at, end_at, created_at, updated_at 等完整欄位。";
+    readonly params: readonly [{
+        readonly name: "promotion_id";
+        readonly description: "促銷活動 ID（由 list_promotions 或 search_promotions 回傳的 id 欄位）";
+        readonly default: null;
+        readonly hasDefault: false;
+        readonly kind: "string";
+        readonly optional: false;
+    }];
+    readonly docEndpoints: readonly [{
+        readonly method: "GET";
+        readonly path: "/v1/promotions/{promotion_id}";
+    }];
+    readonly operations: readonly [{
+        readonly kind: "api_get";
+        readonly method: "GET";
+        readonly endpointKey: "promotion_detail";
+        readonly path_params: "{'promotion_id': promotion_id}";
+    }];
+    readonly sourceLocation: {
+        readonly line: 61;
+        readonly endLine: 96;
+    };
+}, {
+    readonly module: "tools/promotion_tools.py";
+    readonly name: "search_promotions";
+    readonly write: false;
+    readonly description: "依關鍵字搜尋促銷活動。\n\n【用途】\n快速找到特定名稱的促銷活動，例如搜尋「週年慶」、「黑五」等。\n搜尋結果含 id 可進一步呼叫 get_promotion_detail 取得完整資訊。\n\n【呼叫的 Shopline API】\n- GET /v1/promotions/search\n\n【回傳結構】\ndict 含 total_found, returned, items[]。\n每筆包含 id, title, status, discount_type, start_at, end_at。";
+    readonly params: readonly [{
+        readonly name: "keyword";
+        readonly description: "搜尋關鍵字（促銷名稱）";
+        readonly default: null;
+        readonly hasDefault: false;
+        readonly kind: "string";
+        readonly optional: false;
+    }, {
+        readonly name: "max_results";
+        readonly description: "最多回傳筆數";
+        readonly default: 50;
+        readonly hasDefault: true;
+        readonly kind: "integer";
+        readonly optional: false;
+    }];
+    readonly docEndpoints: readonly [{
+        readonly method: "GET";
+        readonly path: "/v1/promotions/search";
+    }];
+    readonly operations: readonly [{
+        readonly kind: "api_get";
+        readonly method: "GET";
+        readonly endpointKey: "promotions_search";
+        readonly params: "params";
+    }];
+    readonly sourceLocation: {
+        readonly line: 100;
+        readonly endLine: 137;
+    };
+}, {
+    readonly module: "tools/return_order_tools.py";
+    readonly name: "list_return_orders";
+    readonly write: false;
+    readonly description: "取得退貨單列表，可依建立日期區間篩選。\n\n【用途】\n查詢特定時段內的退貨申請清單，了解退貨狀況與數量。提供退貨單的摘要資訊\n（含狀態、對應原始訂單、退款金額及退貨品項數）。若需取得單一退貨單的完整\n品項明細，請改用 get_return_order_detail。\n\n注意：analytics_tools 中的 get_refund_summary 也使用同一端點，但以彙總分析\n為目的；本工具提供的是原始列表檢視，適合逐筆查閱退貨紀錄。\n\n【呼叫的 Shopline API】\n- GET /v1/return_orders\n\n【回傳結構】\ndict 含 total_found, returned, return_orders[]。\n每個 return_order 包含 id, status, order_id, total（TWD float）,\nitems_count, created_at。";
+    readonly params: readonly [{
+        readonly name: "start_date";
+        readonly description: "查詢起始日期（ISO 8601 格式，如 2024-01-01T00:00:00Z）";
+        readonly default: null;
+        readonly hasDefault: true;
+        readonly kind: "string";
+        readonly optional: true;
+    }, {
+        readonly name: "end_date";
+        readonly description: "查詢結束日期（ISO 8601 格式，如 2024-12-31T23:59:59Z）";
+        readonly default: null;
+        readonly hasDefault: true;
+        readonly kind: "string";
+        readonly optional: true;
+    }, {
+        readonly name: "max_results";
+        readonly description: "最多回傳筆數";
+        readonly default: 100;
+        readonly hasDefault: true;
+        readonly kind: "integer";
+        readonly optional: false;
+    }];
+    readonly docEndpoints: readonly [{
+        readonly method: "GET";
+        readonly path: "/v1/return_orders";
+    }];
+    readonly operations: readonly [{
+        readonly kind: "fetch_all_pages";
+        readonly method: "GET";
+        readonly endpointKey: "return_orders";
+        readonly params: "params";
+    }];
+    readonly sourceLocation: {
+        readonly line: 16;
+        readonly endLine: 66;
+    };
+}, {
+    readonly module: "tools/return_order_tools.py";
+    readonly name: "get_return_order_detail";
+    readonly write: false;
+    readonly description: "取得單一退貨單的完整明細，包含所有退貨品項。\n\n【用途】\n查閱特定退貨申請的完整資訊：退貨原因、每件退貨商品（商品名稱、數量、退款\n金額）、物流狀態及客戶聯絡資料。適合客服處理個案或審核退貨申請時使用。\n\n【呼叫的 Shopline API】\n- GET /v1/return_orders/{return_order_id}\n\n【回傳結構】\ndict 包含退貨單基本資訊（id, status, reason, order_id, created_at）、\n金額摘要（total, refund_amount，皆為 TWD float）及 line_items[]。\n每個 line_item 包含 product_name, variant_title, quantity, price。";
+    readonly params: readonly [{
+        readonly name: "return_order_id";
+        readonly description: "退貨單 ID（由 list_return_orders 回傳的 id 欄位）";
+        readonly default: null;
+        readonly hasDefault: false;
+        readonly kind: "string";
+        readonly optional: false;
+    }];
+    readonly docEndpoints: readonly [{
+        readonly method: "GET";
+        readonly path: "/v1/return_orders/{return_order_id}";
+    }];
+    readonly operations: readonly [{
+        readonly kind: "api_get";
+        readonly method: "GET";
+        readonly endpointKey: "return_order_detail";
+        readonly path_params: "path_params";
+    }];
+    readonly sourceLocation: {
+        readonly line: 70;
+        readonly endLine: 112;
+    };
+}, {
+    readonly module: "tools/review_tools.py";
+    readonly name: "list_product_reviews";
+    readonly write: false;
+    readonly description: "取得商品評價列表。\n\n【用途】\n瀏覽所有商品評價的摘要清單，了解顧客對商品的整體評分與回饋。可用於監控\n評價品質、找出評分偏低的商品，或追蹤近期新增的評論。若需查看單一評價的\n完整內容（含圖片、店家回覆等），請改用 get_product_review_detail。\n\n【呼叫的 Shopline API】\n- GET /v1/product_review_comments\n\n【回傳結構】\ndict 含 total_found, returned, reviews[]。\n每個 review 包含 id, product_id, product_name（多語系翻譯優先取中文）,\nrating（評分，通常 1-5）, content（評價內容摘要）, created_at。";
+    readonly params: readonly [{
+        readonly name: "max_results";
+        readonly description: "最多回傳筆數";
+        readonly default: 50;
+        readonly hasDefault: true;
+        readonly kind: "integer";
+        readonly optional: false;
+    }];
+    readonly docEndpoints: readonly [{
+        readonly method: "GET";
+        readonly path: "/v1/product_review_comments";
+    }];
+    readonly operations: readonly [{
+        readonly kind: "fetch_all_pages";
+        readonly method: "GET";
+        readonly endpointKey: "product_review_comments";
+    }];
+    readonly sourceLocation: {
+        readonly line: 16;
+        readonly endLine: 55;
+    };
+}, {
+    readonly module: "tools/review_tools.py";
+    readonly name: "get_product_review_detail";
+    readonly write: false;
+    readonly description: "取得單一商品評價的完整內容，包含圖片與店家回覆。\n\n【用途】\n查閱特定評價的詳細資料：完整評論文字、評分、附圖、顧客資訊及店家回覆。\n適用於客服處理評價問題、追蹤店家回應進度，或人工審核評價內容。\n\n【呼叫的 Shopline API】\n- GET /v1/product_review_comments/{comment_id}\n\n【回傳結構】\ndict 包含：\n- id：評價 ID\n- product_id / product_name：商品資訊\n- rating：評分（通常 1–5）\n- content：完整評論文字\n- images[]：附圖 URL 列表\n- reviewer_name：評價者姓名\n- status：評價審核狀態（如 published, pending）\n- reply：店家回覆內容（若有）\n- created_at, updated_at";
+    readonly params: readonly [{
+        readonly name: "comment_id";
+        readonly description: "評價 ID（由 list_product_reviews 回傳的 id 欄位）";
+        readonly default: null;
+        readonly hasDefault: false;
+        readonly kind: "string";
+        readonly optional: false;
+    }];
+    readonly docEndpoints: readonly [{
+        readonly method: "GET";
+        readonly path: "/v1/product_review_comments/{comment_id}";
+    }];
+    readonly operations: readonly [{
+        readonly kind: "api_get";
+        readonly method: "GET";
+        readonly endpointKey: "product_review_comment_detail";
+        readonly path_params: "path_params";
+    }];
+    readonly sourceLocation: {
+        readonly line: 59;
+        readonly endLine: 113;
+    };
+}, {
+    readonly module: "tools/settings_tools.py";
+    readonly name: "get_app_settings";
+    readonly write: false;
+    readonly description: "取得商店應用程式設定。\n\n【用途】\n查詢商店層級的應用程式設定，包含功能開關、主題設定等。\n適合確認商店目前的功能啟用狀態。\n\n注意：此端點已被 Shopline 標記為 deprecated（已棄用），\n但仍可使用，涵蓋以求完整性。建議優先使用其他設定端點\n取得最新商店資訊。\n\n【呼叫的 Shopline API】\n- GET /v1/settings/app\n\n【回傳結構】\ndict 含 settings，包含各應用程式層級設定欄位。\n實際欄位依商店設定而定。";
+    readonly params: readonly [];
+    readonly docEndpoints: readonly [{
+        readonly method: "GET";
+        readonly path: "/v1/settings/app";
+    }];
+    readonly operations: readonly [{
+        readonly kind: "api_get";
+        readonly method: "GET";
+        readonly endpointKey: "settings_app";
+    }];
+    readonly sourceLocation: {
+        readonly line: 13;
+        readonly endLine: 36;
+    };
+}, {
+    readonly module: "tools/staff_tools.py";
+    readonly name: "get_staff_permissions";
+    readonly write: false;
+    readonly description: "取得指定員工的權限設定。\n\n【用途】\n查詢特定員工帳號在商店後台的存取權限範圍，\n例如可操作的功能模組及操作層級。適合確認員工\n權限配置或排查存取問題。\n\n【呼叫的 Shopline API】\n- GET /v1/staffs/{staff_id}/permissions\n\n【回傳結構】\ndict 含 staff_id, permissions[]。\n每個 permission 包含 resource, actions 等，\n描述該員工可操作的資源與動作。";
+    readonly params: readonly [{
+        readonly name: "staff_id";
+        readonly description: "";
+        readonly default: null;
+        readonly hasDefault: false;
+        readonly kind: "string";
+        readonly optional: false;
+    }];
+    readonly docEndpoints: readonly [{
+        readonly method: "GET";
+        readonly path: "/v1/staffs/{staff_id}/permissions";
+    }];
+    readonly operations: readonly [{
+        readonly kind: "api_get";
+        readonly method: "GET";
+        readonly endpointKey: "staff_permissions";
+        readonly path_params: "{'staff_id': staff_id}";
+    }];
+    readonly sourceLocation: {
+        readonly line: 13;
+        readonly endLine: 38;
+    };
+}, {
+    readonly module: "tools/store_credit_tools.py";
+    readonly name: "list_store_credits";
+    readonly write: false;
+    readonly description: "取得所有客戶的儲值金餘額列表。\n\n【用途】\n瀏覽客戶儲值金餘額概況，了解儲值金發放與使用狀況。\n可用於計算儲值金負債、找出高餘額客戶。\n\n【呼叫的 Shopline API】\n- GET /v1/user_credits\n\n【回傳結構】\ndict 含 total_found, returned, total_balance, credits[]。\n每個 credit 包含 customer_id, balance (TWD float)。";
+    readonly params: readonly [{
+        readonly name: "max_results";
+        readonly description: "最多回傳筆數";
+        readonly default: 50;
+        readonly hasDefault: true;
+        readonly kind: "integer";
+        readonly optional: false;
+    }];
+    readonly docEndpoints: readonly [{
+        readonly method: "GET";
+        readonly path: "/v1/user_credits";
+    }];
+    readonly operations: readonly [{
+        readonly kind: "fetch_all_pages";
+        readonly method: "GET";
+        readonly endpointKey: "user_credits";
+    }];
+    readonly sourceLocation: {
+        readonly line: 16;
+        readonly endLine: 50;
+    };
+}, {
+    readonly module: "tools/subscription_tools.py";
+    readonly name: "list_product_subscriptions";
+    readonly write: false;
+    readonly description: "取得商品訂閱列表。\n\n【用途】\n瀏覽所有商品訂閱紀錄，了解客戶訂閱哪些商品、訂閱狀態與週期設定。\n可取得 subscription_id 後進一步呼叫 get_product_subscription_detail 查詢完整詳情。\n適合分析訂閱收入與客戶留存率。\n\n【呼叫的 Shopline API】\n- GET /v1/product_subscriptions\n\n【回傳結構】\ndict 含 total_found, returned, items[]。\n每筆包含 id, customer_id, product_id, status, frequency, next_billing_at, created_at。";
+    readonly params: readonly [{
+        readonly name: "max_results";
+        readonly description: "最多回傳筆數";
+        readonly default: 50;
+        readonly hasDefault: true;
+        readonly kind: "integer";
+        readonly optional: false;
+    }];
+    readonly docEndpoints: readonly [{
+        readonly method: "GET";
+        readonly path: "/v1/product_subscriptions";
+    }];
+    readonly operations: readonly [{
+        readonly kind: "fetch_all_pages";
+        readonly method: "GET";
+        readonly endpointKey: "product_subscriptions";
+    }];
+    readonly sourceLocation: {
+        readonly line: 16;
+        readonly endLine: 54;
+    };
+}, {
+    readonly module: "tools/subscription_tools.py";
+    readonly name: "get_product_subscription_detail";
+    readonly write: false;
+    readonly description: "取得單一商品訂閱的完整詳情。\n\n【用途】\n查詢特定訂閱紀錄的完整資訊，包含客戶、商品、付款方式、配送設定與\n訂閱週期等所有欄位。適合客服場景或個別訂閱狀態確認。\n\n【呼叫的 Shopline API】\n- GET /v1/product_subscriptions/{subscription_id}\n\n【回傳結構】\ndict 包含 id, customer_id, product_id, variant_id, status, frequency,\nfrequency_unit, price (TWD), shipping_address, payment_method,\nnext_billing_at, created_at, updated_at 等完整欄位。";
+    readonly params: readonly [{
+        readonly name: "subscription_id";
+        readonly description: "商品訂閱 ID（由 list_product_subscriptions 回傳的 id 欄位）";
+        readonly default: null;
+        readonly hasDefault: false;
+        readonly kind: "string";
+        readonly optional: false;
+    }];
+    readonly docEndpoints: readonly [{
+        readonly method: "GET";
+        readonly path: "/v1/product_subscriptions/{subscription_id}";
+    }];
+    readonly operations: readonly [{
+        readonly kind: "api_get";
+        readonly method: "GET";
+        readonly endpointKey: "product_subscription_detail";
+        readonly path_params: "{'subscription_id': subscription_id}";
+    }];
+    readonly sourceLocation: {
+        readonly line: 58;
+        readonly endLine: 94;
+    };
+}, {
+    readonly module: "tools/tax_tools.py";
+    readonly name: "list_taxes";
+    readonly write: false;
+    readonly description: "取得商店設定的稅率清單。\n\n【用途】\n查看商店目前設定的稅率規則，例如營業稅、消費稅等。\n適合確認稅率設定或在財務分析時核對稅務規則。\n\n【呼叫的 Shopline API】\n- GET /v1/taxes\n\n【回傳結構】\ndict 含 total, taxes[]。\n每個 tax 包含 id, name, rate, included_in_price,\ncountry, region, created_at 等。";
+    readonly params: readonly [];
+    readonly docEndpoints: readonly [{
+        readonly method: "GET";
+        readonly path: "/v1/taxes";
+    }];
+    readonly operations: readonly [{
+        readonly kind: "api_get";
+        readonly method: "GET";
+        readonly endpointKey: "taxes";
+    }];
+    readonly sourceLocation: {
+        readonly line: 13;
+        readonly endLine: 47;
+    };
+}, {
+    readonly module: "tools/token_tools.py";
+    readonly name: "get_token_info";
+    readonly write: false;
+    readonly description: "取得目前 API Token 的資訊與授權範圍。\n\n【用途】\n查詢此 API Token 的詳細資訊，包含所屬商家、\n授權的 scope（權限範圍）以及有效期限等。\n適合排查 API 存取問題、確認 token 是否擁有\n所需的操作權限。\n\n【呼叫的 Shopline API】\n- GET /v1/token/info\n\n【回傳結構】\ndict 含 token_info，包含 merchant_id, scopes[],\nexpires_at, created_at 等欄位。";
+    readonly params: readonly [];
+    readonly docEndpoints: readonly [{
+        readonly method: "GET";
+        readonly path: "/v1/token/info";
+    }];
+    readonly operations: readonly [{
+        readonly kind: "api_get";
+        readonly method: "GET";
+        readonly endpointKey: "token_info";
+    }];
+    readonly sourceLocation: {
+        readonly line: 13;
+        readonly endLine: 34;
+    };
+}, {
+    readonly module: "tools/writes/category_writes.py";
+    readonly name: "create_category";
+    readonly write: true;
+    readonly description: "[WRITE] 建立新商品分類。\n\n【用途】\n在 Shopline 商店中建立新的商品分類，可指定父分類以建立層級結構。\n\n【呼叫的 Shopline API】\n- POST /v1/categories\n\n【回傳結構】\ndict 含 success: bool, resource_id: str, message: str, category: dict。\n\n【副作用】\n- 在商店分類列表中新增一筆分類記錄\n- 若 parent_id 不存在，API 可能回傳錯誤";
+    readonly params: readonly [{
+        readonly name: "category_data";
+        readonly description: "分類資料，例如 {\"name\": \"夏季新品\", \"parent_id\": null}";
+        readonly default: null;
+        readonly hasDefault: false;
+        readonly kind: "object";
+        readonly optional: false;
+    }];
+    readonly docEndpoints: readonly [{
+        readonly method: "POST";
+        readonly path: "/v1/categories";
+    }];
+    readonly operations: readonly [{
+        readonly kind: "api_post";
+        readonly method: "POST";
+        readonly endpointKey: "category_create";
+        readonly json_body: "category_data";
+    }];
+    readonly sourceLocation: {
+        readonly line: 15;
+        readonly endLine: 43;
+    };
+}, {
+    readonly module: "tools/writes/category_writes.py";
+    readonly name: "update_category";
+    readonly write: true;
+    readonly description: "[WRITE] 更新商品分類資料。\n\n【用途】\n修改分類名稱、排序、父分類等屬性。僅傳入要修改的欄位，未傳入的欄位不會被覆蓋。\n\n【呼叫的 Shopline API】\n- PUT /v1/categories/{category_id}\n\n【回傳結構】\ndict 含 success: bool, resource_id: str, message: str。\n\n【副作用】\n- 分類資料變更立即生效，影響前台分類導覽顯示\n- 不可復原，但可再次呼叫此工具覆蓋";
+    readonly params: readonly [{
+        readonly name: "category_id";
+        readonly description: "分類 ID";
+        readonly default: null;
+        readonly hasDefault: false;
+        readonly kind: "string";
+        readonly optional: false;
+    }, {
+        readonly name: "category_data";
+        readonly description: "要更新的分類欄位，例如 {\"name\": \"冬季特賣\"}";
+        readonly default: null;
+        readonly hasDefault: false;
+        readonly kind: "object";
+        readonly optional: false;
+    }];
+    readonly docEndpoints: readonly [{
+        readonly method: "PUT";
+        readonly path: "/v1/categories/{category_id}";
+    }];
+    readonly operations: readonly [{
+        readonly kind: "api_put";
+        readonly method: "PUT";
+        readonly endpointKey: "category_update";
+        readonly json_body: "category_data";
+        readonly path_params: "{'category_id': category_id}";
+    }];
+    readonly sourceLocation: {
+        readonly line: 47;
+        readonly endLine: 72;
+    };
+}, {
+    readonly module: "tools/writes/category_writes.py";
+    readonly name: "delete_category";
+    readonly write: true;
+    readonly description: "[WRITE] 刪除商品分類。\n\n【用途】\n從 Shopline 商店中永久刪除指定分類。適合清除已停用或錯誤建立的分類。\n\n【呼叫的 Shopline API】\n- DELETE /v1/categories/{category_id}\n\n【回傳結構】\ndict 含 success: bool, resource_id: str, message: str。\n\n【副作用】\n- 永久刪除分類記錄，不可復原\n- 原本屬於此分類的商品將解除分類關聯，商品本身不會被刪除\n- 若有子分類，子分類的父分類關聯可能一併受影響（視 Shopline 實作而定）";
+    readonly params: readonly [{
+        readonly name: "category_id";
+        readonly description: "分類 ID";
+        readonly default: null;
+        readonly hasDefault: false;
+        readonly kind: "string";
+        readonly optional: false;
+    }];
+    readonly docEndpoints: readonly [{
+        readonly method: "DELETE";
+        readonly path: "/v1/categories/{category_id}";
+    }];
+    readonly operations: readonly [{
+        readonly kind: "api_delete";
+        readonly method: "DELETE";
+        readonly endpointKey: "category_delete";
+        readonly path_params: "{'category_id': category_id}";
+    }];
+    readonly sourceLocation: {
+        readonly line: 76;
+        readonly endLine: 100;
+    };
+}, {
+    readonly module: "tools/writes/conversation_writes.py";
+    readonly name: "send_order_message";
+    readonly write: true;
+    readonly description: "[WRITE] 發送與特定訂單相關的對話訊息。\n\n【用途】\n針對指定訂單發送訊息給買家，適用於出貨通知、客服回覆、訂單異常說明等場景。\n\n【呼叫的 Shopline API】\n- POST /v1/conversations/order-messages\n\n【回傳結構】\ndict 含 success: bool, resource_id: str, message: str, conversation: dict。\n\n【副作用】\n- 在買家的對話收件匣中新增一則訊息，買家可即時收到通知\n- 訊息送出後無法撤回或修改";
+    readonly params: readonly [{
+        readonly name: "message_data";
+        readonly description: "訊息資料，例如 {\"order_id\": \"ORD123\", \"message\": \"您的訂單已出貨，請注意查收！\", \"sender_type\": \"merchant\"}";
+        readonly default: null;
+        readonly hasDefault: false;
+        readonly kind: "object";
+        readonly optional: false;
+    }];
+    readonly docEndpoints: readonly [{
+        readonly method: "POST";
+        readonly path: "/v1/conversations/order-messages";
+    }];
+    readonly operations: readonly [{
+        readonly kind: "api_post";
+        readonly method: "POST";
+        readonly endpointKey: "conversation_order_message";
+        readonly json_body: "message_data";
+    }];
+    readonly sourceLocation: {
+        readonly line: 15;
+        readonly endLine: 47;
+    };
+}, {
+    readonly module: "tools/writes/conversation_writes.py";
+    readonly name: "send_shop_message";
+    readonly write: true;
+    readonly description: "[WRITE] 發送一般商店對話訊息。\n\n【用途】\n對客戶發送非特定訂單的通用訊息，適用於行銷通知、活動公告、客服主動聯繫等場景。\n\n【呼叫的 Shopline API】\n- POST /v1/conversations/shop-messages\n\n【回傳結構】\ndict 含 success: bool, resource_id: str, message: str, conversation: dict。\n\n【副作用】\n- 在客戶的對話收件匣中新增一則商店訊息，客戶可即時收到通知\n- 訊息送出後無法撤回或修改\n- 大量發送時請注意 Shopline 的訊息頻率限制，以避免觸發反垃圾機制";
+    readonly params: readonly [{
+        readonly name: "message_data";
+        readonly description: "訊息資料，例如 {\"customer_id\": \"CUST456\", \"message\": \"感謝您的支持，本週特惠活動開始囉！\", \"sender_type\": \"merchant\"}";
+        readonly default: null;
+        readonly hasDefault: false;
+        readonly kind: "object";
+        readonly optional: false;
+    }];
+    readonly docEndpoints: readonly [{
+        readonly method: "POST";
+        readonly path: "/v1/conversations/shop-messages";
+    }];
+    readonly operations: readonly [{
+        readonly kind: "api_post";
+        readonly method: "POST";
+        readonly endpointKey: "conversation_shop_message";
+        readonly json_body: "message_data";
+    }];
+    readonly sourceLocation: {
+        readonly line: 51;
+        readonly endLine: 84;
+    };
+}, {
+    readonly module: "tools/writes/customer_writes.py";
+    readonly name: "create_customer";
+    readonly write: true;
+    readonly description: "[WRITE] 建立新客戶。\n\n【用途】\n在 Shopline 商店中建立新的客戶記錄。適合客服手動建檔或批次匯入場景。\n\n【呼叫的 Shopline API】\n- POST /v1/customers\n\n【回傳結構】\ndict 含 success: bool, resource_id: str, message: str, customer: dict。\n\n【副作用】\n- 在商店客戶列表中新增一筆客戶\n- 如果 email 或 phone 已存在，可能會失敗（Shopline 可能不允許重複）";
+    readonly params: readonly [{
+        readonly name: "name";
+        readonly description: "客戶姓名";
+        readonly default: null;
+        readonly hasDefault: false;
+        readonly kind: "string";
+        readonly optional: false;
+    }, {
+        readonly name: "email";
+        readonly description: "Email";
+        readonly default: null;
+        readonly hasDefault: true;
+        readonly kind: "string";
+        readonly optional: true;
+    }, {
+        readonly name: "phone";
+        readonly description: "電話";
+        readonly default: null;
+        readonly hasDefault: true;
+        readonly kind: "string";
+        readonly optional: true;
+    }, {
+        readonly name: "gender";
+        readonly description: "性別 (male/female/other)";
+        readonly default: null;
+        readonly hasDefault: true;
+        readonly kind: "string";
+        readonly optional: true;
+    }, {
+        readonly name: "birthday";
+        readonly description: "生日 YYYY-MM-DD";
+        readonly default: null;
+        readonly hasDefault: true;
+        readonly kind: "string";
+        readonly optional: true;
+    }, {
+        readonly name: "tags";
+        readonly description: "標籤列表";
+        readonly default: null;
+        readonly hasDefault: true;
+        readonly kind: "array";
+        readonly optional: true;
+    }];
+    readonly docEndpoints: readonly [{
+        readonly method: "POST";
+        readonly path: "/v1/customers";
+    }];
+    readonly operations: readonly [{
+        readonly kind: "api_post";
+        readonly method: "POST";
+        readonly endpointKey: "customer_create";
+        readonly json_body: "body";
+    }];
+    readonly sourceLocation: {
+        readonly line: 16;
+        readonly endLine: 62;
+    };
+}, {
+    readonly module: "tools/writes/customer_writes.py";
+    readonly name: "update_customer";
+    readonly write: true;
+    readonly description: "[WRITE] 更新客戶基本資料。\n\n【用途】\n修改客戶姓名、聯絡方式、生日等基本資料。僅傳入要修改的欄位，未傳入的欄位不會被覆蓋。\n\n【呼叫的 Shopline API】\n- PUT /v1/customers/{customer_id}\n\n【回傳結構】\ndict 含 success: bool, resource_id: str, message: str。\n\n【副作用】\n- 修改客戶資料，變更立即生效\n- 不可復原（無版本歷史），但可再次呼叫此工具覆蓋";
+    readonly params: readonly [{
+        readonly name: "customer_id";
+        readonly description: "客戶內部 ID";
+        readonly default: null;
+        readonly hasDefault: false;
+        readonly kind: "string";
+        readonly optional: false;
+    }, {
+        readonly name: "name";
+        readonly description: "新姓名";
+        readonly default: null;
+        readonly hasDefault: true;
+        readonly kind: "string";
+        readonly optional: true;
+    }, {
+        readonly name: "email";
+        readonly description: "新 Email";
+        readonly default: null;
+        readonly hasDefault: true;
+        readonly kind: "string";
+        readonly optional: true;
+    }, {
+        readonly name: "phone";
+        readonly description: "新電話";
+        readonly default: null;
+        readonly hasDefault: true;
+        readonly kind: "string";
+        readonly optional: true;
+    }, {
+        readonly name: "gender";
+        readonly description: "性別 (male/female/other)";
+        readonly default: null;
+        readonly hasDefault: true;
+        readonly kind: "string";
+        readonly optional: true;
+    }, {
+        readonly name: "birthday";
+        readonly description: "生日 YYYY-MM-DD";
+        readonly default: null;
+        readonly hasDefault: true;
+        readonly kind: "string";
+        readonly optional: true;
+    }];
+    readonly docEndpoints: readonly [{
+        readonly method: "PUT";
+        readonly path: "/v1/customers/{customer_id}";
+    }];
+    readonly operations: readonly [{
+        readonly kind: "api_put";
+        readonly method: "PUT";
+        readonly endpointKey: "customer_update";
+        readonly json_body: "body";
+        readonly path_params: "{'customer_id': customer_id}";
+    }];
+    readonly sourceLocation: {
+        readonly line: 66;
+        readonly endLine: 109;
+    };
+}, {
+    readonly module: "tools/writes/customer_writes.py";
+    readonly name: "delete_customer";
+    readonly write: true;
+    readonly description: "[WRITE] 刪除客戶。\n\n【用途】\n從 Shopline 商店中刪除客戶記錄。通常用於清除測試資料或 GDPR 合規需求。\n\n【呼叫的 Shopline API】\n- DELETE /v1/customers/{customer_id}\n\n【回傳結構】\ndict 含 success: bool, resource_id: str, message: str。\n\n【副作用】\n- 永久刪除客戶記錄，不可復原\n- 客戶相關的訂單紀錄可能仍保留（取決於 Shopline 實作）";
+    readonly params: readonly [{
+        readonly name: "customer_id";
+        readonly description: "客戶內部 ID";
+        readonly default: null;
+        readonly hasDefault: false;
+        readonly kind: "string";
+        readonly optional: false;
+    }];
+    readonly docEndpoints: readonly [{
+        readonly method: "DELETE";
+        readonly path: "/v1/customers/{customer_id}";
+    }];
+    readonly operations: readonly [{
+        readonly kind: "api_delete";
+        readonly method: "DELETE";
+        readonly endpointKey: "customer_delete";
+        readonly path_params: "{'customer_id': customer_id}";
+    }];
+    readonly sourceLocation: {
+        readonly line: 113;
+        readonly endLine: 136;
+    };
+}, {
+    readonly module: "tools/writes/customer_writes.py";
+    readonly name: "update_customer_tags";
+    readonly write: true;
+    readonly description: "[WRITE] 設定客戶標籤（覆蓋現有標籤）。\n\n【用途】\n為客戶設定標籤，常用於行銷分群、VIP 標記等。注意：會覆蓋客戶現有的所有標籤。\n\n【呼叫的 Shopline API】\n- PUT /v1/customers/{customer_id}/tags\n- POST /v1/customers/{customer_id}/tags\n\n【回傳結構】\ndict 含 success: bool, resource_id: str, message: str。\n\n【副作用】\n- 覆蓋客戶的所有現有標籤為新的標籤列表\n- 若要新增標籤而非覆蓋，請先用 get_customer_profile 取得現有標籤再合併";
+    readonly params: readonly [{
+        readonly name: "customer_id";
+        readonly description: "客戶內部 ID";
+        readonly default: null;
+        readonly hasDefault: false;
+        readonly kind: "string";
+        readonly optional: false;
+    }, {
+        readonly name: "tags";
+        readonly description: "標籤列表（會取代現有標籤）";
+        readonly default: null;
+        readonly hasDefault: false;
+        readonly kind: "array";
+        readonly optional: false;
+    }];
+    readonly docEndpoints: readonly [{
+        readonly method: "PUT";
+        readonly path: "/v1/customers/{customer_id}/tags";
+    }, {
+        readonly method: "POST";
+        readonly path: "/v1/customers/{customer_id}/tags";
+    }];
+    readonly operations: readonly [{
+        readonly kind: "api_put";
+        readonly method: "PUT";
+        readonly endpointKey: "customer_tags";
+        readonly json_body: "{'tags': tags}";
+        readonly path_params: "{'customer_id': customer_id}";
+    }];
+    readonly sourceLocation: {
+        readonly line: 140;
+        readonly endLine: 166;
+    };
+}, {
+    readonly module: "tools/writes/customer_writes.py";
+    readonly name: "update_customer_store_credits";
+    readonly write: true;
+    readonly description: "[WRITE] 調整客戶儲值金餘額。\n\n【用途】\n增加或扣除客戶儲值金，常用於儲值金充值、退款補償、活動贈送等場景。\n\n【呼叫的 Shopline API】\n- PUT /v1/customers/{customer_id}/store-credits\n\n【回傳結構】\ndict 含 success: bool, resource_id: str, message: str。\n\n【副作用】\n- 客戶儲值金餘額立即變動\n- 異動紀錄會寫入客戶的儲值金歷史（可透過 get_customer_profile 查看）\n- 扣除後如餘額不足，API 可能回傳錯誤";
+    readonly params: readonly [{
+        readonly name: "customer_id";
+        readonly description: "客戶內部 ID";
+        readonly default: null;
+        readonly hasDefault: false;
+        readonly kind: "string";
+        readonly optional: false;
+    }, {
+        readonly name: "amount";
+        readonly description: "調整金額（正數=增加，負數=扣除）";
+        readonly default: null;
+        readonly hasDefault: false;
+        readonly kind: "number";
+        readonly optional: false;
+    }, {
+        readonly name: "note";
+        readonly description: "調整備註/原因";
+        readonly default: null;
+        readonly hasDefault: true;
+        readonly kind: "string";
+        readonly optional: true;
+    }];
+    readonly docEndpoints: readonly [{
+        readonly method: "PUT";
+        readonly path: "/v1/customers/{customer_id}/store-credits";
+    }];
+    readonly operations: readonly [{
+        readonly kind: "api_put";
+        readonly method: "PUT";
+        readonly endpointKey: "customer_store_credits_update";
+        readonly json_body: "body";
+        readonly path_params: "{'customer_id': customer_id}";
+    }];
+    readonly sourceLocation: {
+        readonly line: 170;
+        readonly endLine: 201;
+    };
+}, {
+    readonly module: "tools/writes/customer_writes.py";
+    readonly name: "adjust_customer_member_points";
+    readonly write: true;
+    readonly description: "[WRITE] 調整客戶會員點數。\n\n【用途】\n增加或扣除客戶會員點數，常用於手動補點、活動贈點、客訴補償等場景。\n\n【呼叫的 Shopline API】\n- PUT /v1/customers/{customer_id}/member-points\n\n【回傳結構】\ndict 含 success: bool, resource_id: str, message: str。\n\n【副作用】\n- 客戶點數餘額立即變動\n- 異動紀錄會寫入客戶的點數歷史（可透過 get_customer_profile 查看）\n- 扣除後如點數不足，API 可能回傳錯誤";
+    readonly params: readonly [{
+        readonly name: "customer_id";
+        readonly description: "客戶內部 ID";
+        readonly default: null;
+        readonly hasDefault: false;
+        readonly kind: "string";
+        readonly optional: false;
+    }, {
+        readonly name: "points";
+        readonly description: "調整點數（正數=增加，負數=扣除）";
+        readonly default: null;
+        readonly hasDefault: false;
+        readonly kind: "integer";
+        readonly optional: false;
+    }, {
+        readonly name: "note";
+        readonly description: "調整備註/原因";
+        readonly default: null;
+        readonly hasDefault: true;
+        readonly kind: "string";
+        readonly optional: true;
+    }];
+    readonly docEndpoints: readonly [{
+        readonly method: "PUT";
+        readonly path: "/v1/customers/{customer_id}/member-points";
+    }];
+    readonly operations: readonly [{
+        readonly kind: "api_put";
+        readonly method: "PUT";
+        readonly endpointKey: "customer_member_points_update";
+        readonly json_body: "body";
+        readonly path_params: "{'customer_id': customer_id}";
+    }];
+    readonly sourceLocation: {
+        readonly line: 205;
+        readonly endLine: 236;
+    };
+}, {
+    readonly module: "tools/writes/delivery_option_writes.py";
+    readonly name: "update_pickup_store";
+    readonly write: true;
+    readonly description: "[WRITE] 更新配送選項的自取門市資訊。\n\n【用途】\n修改指定配送選項下的自取門市（Pickup Store）資訊，例如更新門市名稱、地址、電話、營業時間等。\n適合門市資訊異動時同步更新 Shopline 的自取門市設定。\n\n【呼叫的 Shopline API】\n- PUT /v1/delivery_options/{delivery_option_id}/pickup_store\n\n【回傳結構】\ndict 含 success: bool, resource_id: str, message: str。\n\n【副作用】\n- 修改指定配送選項下的自取門市資訊，變更立即生效\n- 顧客於結帳頁選擇自取時將看到更新後的門市資訊\n- 不可復原，但可再次呼叫此工具覆蓋";
+    readonly params: readonly [{
+        readonly name: "delivery_option_id";
+        readonly description: "配送選項 ID";
+        readonly default: null;
+        readonly hasDefault: false;
+        readonly kind: "string";
+        readonly optional: false;
+    }, {
+        readonly name: "pickup_store_data";
+        readonly description: "自取門市資料，例如：{\"store_name\": \"台北信義門市\", \"address\": \"台北市信義區...\", \"phone\": \"02-1234-5678\", \"business_hours\": \"10:00-22:00\"}";
+        readonly default: null;
+        readonly hasDefault: false;
+        readonly kind: "object";
+        readonly optional: false;
+    }];
+    readonly docEndpoints: readonly [{
+        readonly method: "PUT";
+        readonly path: "/v1/delivery_options/{delivery_option_id}/pickup_store";
+    }];
+    readonly operations: readonly [{
+        readonly kind: "api_put";
+        readonly method: "PUT";
+        readonly endpointKey: "delivery_option_pickup_store";
+        readonly json_body: "pickup_store_data";
+        readonly path_params: "{'delivery_option_id': delivery_option_id}";
+    }];
+    readonly sourceLocation: {
+        readonly line: 15;
+        readonly endLine: 50;
+    };
+}, {
+    readonly module: "tools/writes/gift_writes.py";
+    readonly name: "create_gift";
+    readonly write: true;
+    readonly description: "[WRITE] 建立新贈品。\n\n【用途】\n在 Shopline 商店中建立一個新的贈品記錄，可搭配促銷活動使用。\n\n【呼叫的 Shopline API】\n- POST /v1/gifts\n\n【回傳結構】\ndict 含 success: bool, resource_id: str, message: str, gift: dict。\n\n【副作用】\n- 在商店贈品列表中新增一筆記錄\n- 贈品建立後可透過促銷規則設定觸發條件";
+    readonly params: readonly [{
+        readonly name: "gift_data";
+        readonly description: "贈品資料，例如 {name, sku, quantity, ...}";
+        readonly default: null;
+        readonly hasDefault: false;
+        readonly kind: "object";
+        readonly optional: false;
+    }];
+    readonly docEndpoints: readonly [{
+        readonly method: "POST";
+        readonly path: "/v1/gifts";
+    }];
+    readonly operations: readonly [{
+        readonly kind: "api_post";
+        readonly method: "POST";
+        readonly endpointKey: "gift_create";
+        readonly json_body: "gift_data";
+    }];
+    readonly sourceLocation: {
+        readonly line: 15;
+        readonly endLine: 40;
+    };
+}, {
+    readonly module: "tools/writes/gift_writes.py";
+    readonly name: "update_gift";
+    readonly write: true;
+    readonly description: "[WRITE] 更新贈品資料。\n\n【用途】\n修改指定贈品的名稱、數量、圖片等欄位。僅傳入要修改的欄位。\n\n【呼叫的 Shopline API】\n- PATCH /v1/gifts/{gift_id}\n\n【回傳結構】\ndict 含 success: bool, resource_id: str, message: str。\n\n【副作用】\n- 修改指定贈品的資料，變更立即生效\n- 不可復原，但可再次呼叫此工具覆蓋";
+    readonly params: readonly [{
+        readonly name: "gift_id";
+        readonly description: "贈品 ID";
+        readonly default: null;
+        readonly hasDefault: false;
+        readonly kind: "string";
+        readonly optional: false;
+    }, {
+        readonly name: "gift_data";
+        readonly description: "要更新的贈品欄位，例如 {name, quantity, ...}";
+        readonly default: null;
+        readonly hasDefault: false;
+        readonly kind: "object";
+        readonly optional: false;
+    }];
+    readonly docEndpoints: readonly [{
+        readonly method: "PATCH";
+        readonly path: "/v1/gifts/{gift_id}";
+    }];
+    readonly operations: readonly [{
+        readonly kind: "api_patch";
+        readonly method: "PATCH";
+        readonly endpointKey: "gift_update";
+        readonly json_body: "gift_data";
+        readonly path_params: "{'gift_id': gift_id}";
+    }];
+    readonly sourceLocation: {
+        readonly line: 44;
+        readonly endLine: 71;
+    };
+}, {
+    readonly module: "tools/writes/gift_writes.py";
+    readonly name: "update_gift_quantity_by_sku";
+    readonly write: true;
+    readonly description: "[WRITE] 依 SKU 更新贈品庫存數量。\n\n【用途】\n直接以 SKU 為索引更新贈品庫存數量，適合批次庫存同步場景。\n\n【呼叫的 Shopline API】\n- PATCH /v1/gifts/quantity-by-sku\n\n【回傳結構】\ndict 含 success: bool, resource_id: str, message: str。\n\n【副作用】\n- 指定 SKU 的贈品庫存數量將被覆蓋為新值\n- 庫存變動立即生效，影響贈品可用性";
+    readonly params: readonly [{
+        readonly name: "sku";
+        readonly description: "贈品 SKU 編號";
+        readonly default: null;
+        readonly hasDefault: false;
+        readonly kind: "string";
+        readonly optional: false;
+    }, {
+        readonly name: "quantity";
+        readonly description: "新的庫存數量（絕對值，非差異）";
+        readonly default: null;
+        readonly hasDefault: false;
+        readonly kind: "integer";
+        readonly optional: false;
+    }];
+    readonly docEndpoints: readonly [{
+        readonly method: "PATCH";
+        readonly path: "/v1/gifts/quantity-by-sku";
+    }];
+    readonly operations: readonly [{
+        readonly kind: "api_patch";
+        readonly method: "PATCH";
+        readonly endpointKey: "gift_quantity_by_sku";
+        readonly json_body: "{'sku': sku, 'quantity': quantity}";
+    }];
+    readonly sourceLocation: {
+        readonly line: 75;
+        readonly endLine: 99;
+    };
+}, {
+    readonly module: "tools/writes/gift_writes.py";
+    readonly name: "create_addon_product";
+    readonly write: true;
+    readonly description: "[WRITE] 建立新加購商品。\n\n【用途】\n在 Shopline 商店中建立一個新的加購商品（Addon Product），可於結帳時讓顧客選購。\n\n【呼叫的 Shopline API】\n- POST /v1/addon_products\n\n【回傳結構】\ndict 含 success: bool, resource_id: str, message: str, addon_product: dict。\n\n【副作用】\n- 在商店加購商品列表中新增一筆記錄\n- 建立後需於促銷或商品設定中啟用才會顯示給顧客";
+    readonly params: readonly [{
+        readonly name: "addon_data";
+        readonly description: "加購商品資料，例如 {name, sku, price, quantity, ...}";
+        readonly default: null;
+        readonly hasDefault: false;
+        readonly kind: "object";
+        readonly optional: false;
+    }];
+    readonly docEndpoints: readonly [{
+        readonly method: "POST";
+        readonly path: "/v1/addon_products";
+    }];
+    readonly operations: readonly [{
+        readonly kind: "api_post";
+        readonly method: "POST";
+        readonly endpointKey: "addon_product_create";
+        readonly json_body: "addon_data";
+    }];
+    readonly sourceLocation: {
+        readonly line: 103;
+        readonly endLine: 128;
+    };
+}, {
+    readonly module: "tools/writes/gift_writes.py";
+    readonly name: "update_addon_product";
+    readonly write: true;
+    readonly description: "[WRITE] 更新加購商品資料。\n\n【用途】\n修改指定加購商品的名稱、價格、圖片等欄位。僅傳入要修改的欄位。\n\n【呼叫的 Shopline API】\n- PUT /v1/addon_products/{addon_product_id}\n\n【回傳結構】\ndict 含 success: bool, resource_id: str, message: str。\n\n【副作用】\n- 修改指定加購商品的資料，變更立即生效\n- 不可復原，但可再次呼叫此工具覆蓋";
+    readonly params: readonly [{
+        readonly name: "addon_product_id";
+        readonly description: "加購商品 ID";
+        readonly default: null;
+        readonly hasDefault: false;
+        readonly kind: "string";
+        readonly optional: false;
+    }, {
+        readonly name: "addon_data";
+        readonly description: "要更新的加購商品欄位，例如 {name, price, ...}";
+        readonly default: null;
+        readonly hasDefault: false;
+        readonly kind: "object";
+        readonly optional: false;
+    }];
+    readonly docEndpoints: readonly [{
+        readonly method: "PUT";
+        readonly path: "/v1/addon_products/{addon_product_id}";
+    }];
+    readonly operations: readonly [{
+        readonly kind: "api_put";
+        readonly method: "PUT";
+        readonly endpointKey: "addon_product_update";
+        readonly json_body: "addon_data";
+        readonly path_params: "{'addon_product_id': addon_product_id}";
+    }];
+    readonly sourceLocation: {
+        readonly line: 132;
+        readonly endLine: 160;
+    };
+}, {
+    readonly module: "tools/writes/gift_writes.py";
+    readonly name: "update_addon_product_quantity";
+    readonly write: true;
+    readonly description: "[WRITE] 更新加購商品庫存數量。\n\n【用途】\n直接以 ID 更新指定加購商品的庫存數量。\n\n【呼叫的 Shopline API】\n- PUT /v1/addon_products/{addon_product_id}/quantity\n\n【回傳結構】\ndict 含 success: bool, resource_id: str, message: str。\n\n【副作用】\n- 指定加購商品的庫存數量將被覆蓋為新值\n- 庫存變動立即生效";
+    readonly params: readonly [{
+        readonly name: "addon_product_id";
+        readonly description: "加購商品 ID";
+        readonly default: null;
+        readonly hasDefault: false;
+        readonly kind: "string";
+        readonly optional: false;
+    }, {
+        readonly name: "quantity";
+        readonly description: "新的庫存數量（絕對值，非差異）";
+        readonly default: null;
+        readonly hasDefault: false;
+        readonly kind: "integer";
+        readonly optional: false;
+    }];
+    readonly docEndpoints: readonly [{
+        readonly method: "PUT";
+        readonly path: "/v1/addon_products/{addon_product_id}/quantity";
+    }];
+    readonly operations: readonly [{
+        readonly kind: "api_put";
+        readonly method: "PUT";
+        readonly endpointKey: "addon_product_quantity";
+        readonly json_body: "{'quantity': quantity}";
+        readonly path_params: "{'addon_product_id': addon_product_id}";
+    }];
+    readonly sourceLocation: {
+        readonly line: 164;
+        readonly endLine: 189;
+    };
+}, {
+    readonly module: "tools/writes/gift_writes.py";
+    readonly name: "update_addon_product_quantity_by_sku";
+    readonly write: true;
+    readonly description: "[WRITE] 依 SKU 更新加購商品庫存數量。\n\n【用途】\n直接以 SKU 為索引更新加購商品庫存數量，適合批次庫存同步場景。\n\n【呼叫的 Shopline API】\n- PUT /v1/addon_products/sku/quantity\n\n【回傳結構】\ndict 含 success: bool, resource_id: str, message: str。\n\n【副作用】\n- 指定 SKU 的加購商品庫存數量將被覆蓋為新值\n- 庫存變動立即生效";
+    readonly params: readonly [{
+        readonly name: "sku";
+        readonly description: "加購商品 SKU 編號";
+        readonly default: null;
+        readonly hasDefault: false;
+        readonly kind: "string";
+        readonly optional: false;
+    }, {
+        readonly name: "quantity";
+        readonly description: "新的庫存數量（絕對值，非差異）";
+        readonly default: null;
+        readonly hasDefault: false;
+        readonly kind: "integer";
+        readonly optional: false;
+    }];
+    readonly docEndpoints: readonly [{
+        readonly method: "PUT";
+        readonly path: "/v1/addon_products/sku/quantity";
+    }];
+    readonly operations: readonly [{
+        readonly kind: "api_put";
+        readonly method: "PUT";
+        readonly endpointKey: "addon_product_sku_quantity";
+        readonly json_body: "{'sku': sku, 'quantity': quantity}";
+    }];
+    readonly sourceLocation: {
+        readonly line: 193;
+        readonly endLine: 217;
+    };
+}, {
+    readonly module: "tools/writes/media_writes.py";
+    readonly name: "upload_media";
+    readonly write: true;
+    readonly description: "[WRITE] 上傳媒體檔案至 Shopline。\n\n【用途】\n上傳圖片或其他媒體檔案至 Shopline 媒體庫，上傳後可取得媒體 ID 供商品圖片等用途使用。\n注意：Shopline API 可能需要 multipart/form-data，本工具目前以 JSON body 傳送，\n若 API 回傳格式錯誤，請改用 multipart 上傳方式。\n\n【呼叫的 Shopline API】\n- POST /v1/media\n\n【回傳結構】\ndict 含 success: bool, resource_id: str, message: str, media: dict。\n\n【副作用】\n- 在 Shopline 媒體庫中新增一筆媒體記錄\n- 上傳的檔案將佔用商店的媒體儲存空間";
+    readonly params: readonly [{
+        readonly name: "media_data";
+        readonly description: "媒體上傳資料。可能需要包含 file_url（遠端 URL）或 base64 編碼的檔案內容，視 Shopline API 支援的格式而定。範例：{\"file_url\": \"https://your-cdn.shoplineapp.com/image.jpg\", \"type\": \"image\"}";
+        readonly default: null;
+        readonly hasDefault: false;
+        readonly kind: "object";
+        readonly optional: false;
+    }];
+    readonly docEndpoints: readonly [{
+        readonly method: "POST";
+        readonly path: "/v1/media";
+    }];
+    readonly operations: readonly [{
+        readonly kind: "api_post";
+        readonly method: "POST";
+        readonly endpointKey: "media_create";
+        readonly json_body: "media_data";
+    }];
+    readonly sourceLocation: {
+        readonly line: 15;
+        readonly endLine: 48;
+    };
+}, {
+    readonly module: "tools/writes/media_writes.py";
+    readonly name: "create_metafield";
+    readonly write: true;
+    readonly description: "[WRITE] 建立商家應用元欄位（App Metafield）。\n\n【用途】\n為商家建立自定義的元欄位，用於儲存應用程式所需的額外商家設定或資料。\n\n【呼叫的 Shopline API】\n- POST /merchants/current/app-metafields\n\n【回傳結構】\ndict 含 success: bool, resource_id: str, message: str, metafield: dict。\n\n【副作用】\n- 在商家的應用元欄位中新增一筆記錄\n- 相同 namespace + key 組合若已存在，可能會失敗或覆蓋（取決於 Shopline 實作）";
+    readonly params: readonly [{
+        readonly name: "metafield_data";
+        readonly description: "元欄位資料，例如：{\"namespace\": \"my_app\", \"key\": \"custom_key\", \"value\": \"custom_value\", \"value_type\": \"string\"}";
+        readonly default: null;
+        readonly hasDefault: false;
+        readonly kind: "object";
+        readonly optional: false;
+    }];
+    readonly docEndpoints: readonly [{
+        readonly method: "POST";
+        readonly path: "/merchants/current/app-metafields";
+    }];
+    readonly operations: readonly [{
+        readonly kind: "api_post";
+        readonly method: "POST";
+        readonly endpointKey: "metafield_create";
+        readonly json_body: "metafield_data";
+    }];
+    readonly sourceLocation: {
+        readonly line: 52;
+        readonly endLine: 82;
+    };
+}, {
+    readonly module: "tools/writes/merchant_writes.py";
+    readonly name: "update_merchant";
+    readonly write: true;
+    readonly description: "[WRITE] 更新商家基本資料。\n\n【用途】\n修改指定商家的名稱、聯絡資訊、地址等基本設定。僅傳入要修改的欄位，未傳入的欄位不會被覆蓋。\n適合商家資料異動（如搬遷、更名）時同步更新 Shopline 商家設定。\n\n【呼叫的 Shopline API】\n- PUT /v1/merchants/{merchant_id}\n\n【回傳結構】\ndict 含 success: bool, resource_id: str, message: str。\n\n【副作用】\n- 修改商家資料，變更立即生效\n- 商家名稱等資訊可能顯示於顧客可見的頁面（如收據、通知 Email）\n- 不可復原，但可再次呼叫此工具覆蓋";
+    readonly params: readonly [{
+        readonly name: "merchant_id";
+        readonly description: "商家 ID";
+        readonly default: null;
+        readonly hasDefault: false;
+        readonly kind: "string";
+        readonly optional: false;
+    }, {
+        readonly name: "merchant_data";
+        readonly description: "要更新的商家欄位，例如：{\"name\": \"我的商店\", \"email\": \"shop@yourstore.com\", \"phone\": \"02-1234-5678\", \"address\": \"台北市...\"}";
+        readonly default: null;
+        readonly hasDefault: false;
+        readonly kind: "object";
+        readonly optional: false;
+    }];
+    readonly docEndpoints: readonly [{
+        readonly method: "PUT";
+        readonly path: "/v1/merchants/{merchant_id}";
+    }];
+    readonly operations: readonly [{
+        readonly kind: "api_put";
+        readonly method: "PUT";
+        readonly endpointKey: "merchant_update";
+        readonly json_body: "merchant_data";
+        readonly path_params: "{'merchant_id': merchant_id}";
+    }];
+    readonly sourceLocation: {
+        readonly line: 15;
+        readonly endLine: 50;
+    };
+}, {
+    readonly module: "tools/writes/order_delivery_writes.py";
+    readonly name: "update_order_delivery";
+    readonly write: true;
+    readonly description: "[WRITE] 更新訂單配送資訊。\n\n【用途】\n修改指定訂單配送記錄的物流資訊，例如更新追蹤號碼、物流公司、配送狀態等。\n適合整合第三方物流系統後回寫配送狀態。\n\n【呼叫的 Shopline API】\n- PUT /v1/order_deliveries/{delivery_id}\n\n【回傳結構】\ndict 含 success: bool, resource_id: str, message: str。\n\n【副作用】\n- 修改訂單配送記錄，變更立即生效\n- 狀態變更可能觸發 Shopline 的自動通知（如寄送出貨通知 Email 給顧客）\n- 不可復原，但可再次呼叫此工具覆蓋";
+    readonly params: readonly [{
+        readonly name: "delivery_id";
+        readonly description: "訂單配送記錄 ID";
+        readonly default: null;
+        readonly hasDefault: false;
+        readonly kind: "string";
+        readonly optional: false;
+    }, {
+        readonly name: "delivery_data";
+        readonly description: "要更新的配送欄位，例如：{\"tracking_number\": \"123456\", \"carrier\": \"黑貓宅急便\", \"status\": \"shipped\"}";
+        readonly default: null;
+        readonly hasDefault: false;
+        readonly kind: "object";
+        readonly optional: false;
+    }];
+    readonly docEndpoints: readonly [{
+        readonly method: "PUT";
+        readonly path: "/v1/order_deliveries/{delivery_id}";
+    }];
+    readonly operations: readonly [{
+        readonly kind: "api_put";
+        readonly method: "PUT";
+        readonly endpointKey: "order_delivery_update";
+        readonly json_body: "delivery_data";
+        readonly path_params: "{'delivery_id': delivery_id}";
+    }];
+    readonly sourceLocation: {
+        readonly line: 15;
+        readonly endLine: 50;
+    };
+}, {
+    readonly module: "tools/writes/order_writes.py";
+    readonly name: "cancel_order";
+    readonly write: true;
+    readonly description: "[WRITE] 取消訂單。\n\n【用途】\n取消指定訂單，適用於客戶要求取消、庫存不足或付款問題等場景。\n\n【呼叫的 Shopline API】\n- POST /v1/orders/{order_id}/cancel\n\n【回傳結構】\ndict 含 success: bool, resource_id: str, message: str。\n\n【副作用】\n- 訂單狀態變更為已取消，操作不可逆\n- 若訂單已出貨，可能無法取消（取決於 Shopline 規則）\n- 已付款訂單取消後需另行退款";
+    readonly params: readonly [{
+        readonly name: "order_id";
+        readonly description: "訂單 ID";
+        readonly default: null;
+        readonly hasDefault: false;
+        readonly kind: "string";
+        readonly optional: false;
+    }, {
+        readonly name: "reason";
+        readonly description: "取消原因（選填）";
+        readonly default: null;
+        readonly hasDefault: true;
+        readonly kind: "string";
+        readonly optional: true;
+    }];
+    readonly docEndpoints: readonly [{
+        readonly method: "POST";
+        readonly path: "/v1/orders/{order_id}/cancel";
+    }];
+    readonly operations: readonly [{
+        readonly kind: "api_post";
+        readonly method: "POST";
+        readonly endpointKey: "order_cancel";
+        readonly json_body: "body";
+        readonly path_params: "{'order_id': order_id}";
+    }];
+    readonly sourceLocation: {
+        readonly line: 17;
+        readonly endLine: 50;
+    };
+}, {
+    readonly module: "tools/writes/order_writes.py";
+    readonly name: "execute_order_shipment";
+    readonly write: true;
+    readonly description: "[WRITE] 執行訂單出貨。\n\n【用途】\n將指定訂單標記為已出貨，觸發 Shopline 出貨流程，適用於倉庫確認出貨後的狀態更新。\n\n【呼叫的 Shopline API】\n- POST /v1/orders/{order_id}/shipment\n\n【回傳結構】\ndict 含 success: bool, resource_id: str, message: str。\n\n【副作用】\n- 訂單出貨狀態更新為已出貨\n- 可能觸發客戶出貨通知（取決於商店設定）\n- 訂單需處於可出貨狀態，否則 API 會回傳錯誤";
+    readonly params: readonly [{
+        readonly name: "order_id";
+        readonly description: "訂單 ID";
+        readonly default: null;
+        readonly hasDefault: false;
+        readonly kind: "string";
+        readonly optional: false;
+    }];
+    readonly docEndpoints: readonly [{
+        readonly method: "POST";
+        readonly path: "/v1/orders/{order_id}/shipment";
+    }];
+    readonly operations: readonly [{
+        readonly kind: "api_post";
+        readonly method: "POST";
+        readonly endpointKey: "order_shipment";
+        readonly json_body: "{}";
+        readonly path_params: "{'order_id': order_id}";
+    }];
+    readonly sourceLocation: {
+        readonly line: 54;
+        readonly endLine: 81;
+    };
+}, {
+    readonly module: "tools/writes/order_writes.py";
+    readonly name: "bulk_execute_shipment";
+    readonly write: true;
+    readonly description: "[WRITE] 批次執行多訂單出貨。\n\n【用途】\n一次性將多筆訂單標記為已出貨，提升倉庫作業效率，適用於每日批量出貨場景。\n\n【呼叫的 Shopline API】\n- POST /v1/orders/shipment/bulk\n\n【回傳結構】\ndict 含 success: bool, resource_id: str, message: str, order_ids: list。\n\n【副作用】\n- 所有指定訂單的出貨狀態批次更新為已出貨\n- 部分訂單若無法出貨，API 可能整批失敗或回傳各別結果（取決於 Shopline 實作）\n- 可能觸發多封客戶出貨通知";
+    readonly params: readonly [{
+        readonly name: "order_ids";
+        readonly description: "訂單 ID 列表，批次出貨";
+        readonly default: null;
+        readonly hasDefault: false;
+        readonly kind: "array";
+        readonly optional: false;
+    }];
+    readonly docEndpoints: readonly [{
+        readonly method: "POST";
+        readonly path: "/v1/orders/shipment/bulk";
+    }];
+    readonly operations: readonly [{
+        readonly kind: "api_post";
+        readonly method: "POST";
+        readonly endpointKey: "orders_shipment_bulk";
+        readonly json_body: "body";
+    }];
+    readonly sourceLocation: {
+        readonly line: 85;
+        readonly endLine: 112;
+    };
+}, {
+    readonly module: "tools/writes/order_writes.py";
+    readonly name: "split_order";
+    readonly write: true;
+    readonly description: "[WRITE] 拆分訂單為多個子出貨單。\n\n【用途】\n將一筆訂單拆分為多個子單，適用於商品分批到貨或不同倉庫分開出貨的場景。\nsplit_config 為字典，內容依 Shopline API 規格定義各子單。\n\n【呼叫的 Shopline API】\n- POST /v1/orders/{order_id}/split\n\n【回傳結構】\ndict 含 success: bool, resource_id: str, message: str。\n\n【副作用】\n- 原訂單被拆分為多個子訂單，原訂單狀態可能變更\n- 操作通常不可逆，請確認拆單設定正確後再執行\n- 已出貨的訂單無法拆單";
+    readonly params: readonly [{
+        readonly name: "order_id";
+        readonly description: "訂單 ID";
+        readonly default: null;
+        readonly hasDefault: false;
+        readonly kind: "string";
+        readonly optional: false;
+    }, {
+        readonly name: "split_config";
+        readonly description: "拆單設定，包含各子單的商品與配送資訊";
+        readonly default: null;
+        readonly hasDefault: false;
+        readonly kind: "object";
+        readonly optional: false;
+    }];
+    readonly docEndpoints: readonly [{
+        readonly method: "POST";
+        readonly path: "/v1/orders/{order_id}/split";
+    }];
+    readonly operations: readonly [{
+        readonly kind: "api_post";
+        readonly method: "POST";
+        readonly endpointKey: "order_split";
+        readonly json_body: "split_config";
+        readonly path_params: "{'order_id': order_id}";
+    }];
+    readonly sourceLocation: {
+        readonly line: 116;
+        readonly endLine: 145;
+    };
+}, {
+    readonly module: "tools/writes/order_writes.py";
+    readonly name: "update_order";
+    readonly write: true;
+    readonly description: "[WRITE] 更新訂單欄位。\n\n【用途】\n修改訂單的可編輯欄位（如備註、配送地址等）。僅傳入要修改的欄位，未傳入欄位不受影響。\n\n【呼叫的 Shopline API】\n- PATCH /v1/orders/{order_id}\n\n【回傳結構】\ndict 含 success: bool, resource_id: str, message: str。\n\n【副作用】\n- 訂單資料立即變更，不可復原（可再次呼叫此工具覆蓋）\n- 部分欄位（如金額）可能受限於訂單狀態而無法修改";
+    readonly params: readonly [{
+        readonly name: "order_id";
+        readonly description: "訂單 ID";
+        readonly default: null;
+        readonly hasDefault: false;
+        readonly kind: "string";
+        readonly optional: false;
+    }, {
+        readonly name: "fields";
+        readonly description: "要更新的欄位與值，以字典形式傳入";
+        readonly default: null;
+        readonly hasDefault: false;
+        readonly kind: "object";
+        readonly optional: false;
+    }];
+    readonly docEndpoints: readonly [{
+        readonly method: "PATCH";
+        readonly path: "/v1/orders/{order_id}";
+    }];
+    readonly operations: readonly [{
+        readonly kind: "api_patch";
+        readonly method: "PATCH";
+        readonly endpointKey: "order_update";
+        readonly json_body: "fields";
+        readonly path_params: "{'order_id': order_id}";
+    }];
+    readonly sourceLocation: {
+        readonly line: 149;
+        readonly endLine: 181;
+    };
+}, {
+    readonly module: "tools/writes/order_writes.py";
+    readonly name: "update_order_status";
+    readonly write: true;
+    readonly description: "[WRITE] 更新訂單狀態（支援同時更新多種狀態）。\n\n【用途】\n分別或同時更新訂單的主狀態、配送狀態、付款狀態。\n僅傳入非 None 的參數，每個非 None 參數會各自呼叫一支 API。\n\n【呼叫的 Shopline API】\n- PATCH /v1/orders/{order_id}/status（若 status 非 None）\n- PATCH /v1/orders/{order_id}/delivery-status（若 delivery_status 非 None）\n- PATCH /v1/orders/{order_id}/payment-status（若 payment_status 非 None）\n\n【回傳結構】\ndict 含 success: bool, resource_id: str, message: str, updated_fields: list。\n\n【副作用】\n- 訂單狀態立即變更，影響前台顯示與後台報表\n- 狀態變更可能觸發客戶通知（取決於商店設定）\n- 非法的狀態值或不合法的狀態轉換會導致 API 回傳錯誤";
+    readonly params: readonly [{
+        readonly name: "order_id";
+        readonly description: "訂單 ID";
+        readonly default: null;
+        readonly hasDefault: false;
+        readonly kind: "string";
+        readonly optional: false;
+    }, {
+        readonly name: "status";
+        readonly description: "訂單狀態（如 confirmed / cancelled）";
+        readonly default: null;
+        readonly hasDefault: true;
+        readonly kind: "string";
+        readonly optional: true;
+    }, {
+        readonly name: "delivery_status";
+        readonly description: "配送狀態（如 shipped / delivered）";
+        readonly default: null;
+        readonly hasDefault: true;
+        readonly kind: "string";
+        readonly optional: true;
+    }, {
+        readonly name: "payment_status";
+        readonly description: "付款狀態（如 paid / unpaid）";
+        readonly default: null;
+        readonly hasDefault: true;
+        readonly kind: "string";
+        readonly optional: true;
+    }];
+    readonly docEndpoints: readonly [{
+        readonly method: "PATCH";
+        readonly path: "/v1/orders/{order_id}/status";
+    }, {
+        readonly method: "PATCH";
+        readonly path: "/v1/orders/{order_id}/delivery-status";
+    }, {
+        readonly method: "PATCH";
+        readonly path: "/v1/orders/{order_id}/payment-status";
+    }];
+    readonly operations: readonly [{
+        readonly kind: "api_patch";
+        readonly method: "PATCH";
+        readonly endpointKey: "order_status";
+        readonly json_body: "{'status': status}";
+        readonly path_params: "{'order_id': order_id}";
+    }, {
+        readonly kind: "api_patch";
+        readonly method: "PATCH";
+        readonly endpointKey: "order_delivery_status";
+        readonly json_body: "{'delivery_status': delivery_status}";
+        readonly path_params: "{'order_id': order_id}";
+    }, {
+        readonly kind: "api_patch";
+        readonly method: "PATCH";
+        readonly endpointKey: "order_payment_status";
+        readonly json_body: "{'payment_status': payment_status}";
+        readonly path_params: "{'order_id': order_id}";
+    }];
+    readonly sourceLocation: {
+        readonly line: 185;
+        readonly endLine: 245;
+    };
+}, {
+    readonly module: "tools/writes/order_writes.py";
+    readonly name: "update_order_tags";
+    readonly write: true;
+    readonly description: "[WRITE] 設定訂單標籤（覆蓋現有標籤）。\n\n【用途】\n為訂單設定標籤，常用於訂單分類、優先處理標記、客服備註分群等場景。\n注意：會覆蓋訂單現有的所有標籤。\n\n【呼叫的 Shopline API】\n- PATCH /v1/orders/{order_id}/tags\n\n【回傳結構】\ndict 含 success: bool, resource_id: str, message: str。\n\n【副作用】\n- 覆蓋訂單的所有現有標籤為新的標籤列表\n- 若要新增標籤而非覆蓋，請先用 get_order_detail 取得現有標籤再合併";
+    readonly params: readonly [{
+        readonly name: "order_id";
+        readonly description: "訂單 ID";
+        readonly default: null;
+        readonly hasDefault: false;
+        readonly kind: "string";
+        readonly optional: false;
+    }, {
+        readonly name: "tags";
+        readonly description: "標籤列表（會取代現有標籤）";
+        readonly default: null;
+        readonly hasDefault: false;
+        readonly kind: "array";
+        readonly optional: false;
+    }];
+    readonly docEndpoints: readonly [{
+        readonly method: "PATCH";
+        readonly path: "/v1/orders/{order_id}/tags";
+    }];
+    readonly operations: readonly [{
+        readonly kind: "api_patch";
+        readonly method: "PATCH";
+        readonly endpointKey: "order_tags_update";
+        readonly json_body: "{'tags': tags}";
+        readonly path_params: "{'order_id': order_id}";
+    }];
+    readonly sourceLocation: {
+        readonly line: 249;
+        readonly endLine: 275;
+    };
+}, {
+    readonly module: "tools/writes/order_writes.py";
+    readonly name: "create_order";
+    readonly write: true;
+    readonly description: "[WRITE] 建立新訂單。\n\n【用途】\n在 Shopline 商店中手動建立新訂單，適用於電話訂購、客服補單、線下訂單轉入等場景。\norder_data 需包含 Shopline 建立訂單 API 所需的完整欄位。\n\n【呼叫的 Shopline API】\n- POST /v1/orders\n\n【回傳結構】\ndict 含 success: bool, resource_id: str, message: str, order: dict。\n\n【副作用】\n- 在商店訂單列表中新增一筆訂單\n- 可能觸發庫存扣減（取決於訂單內容與商店設定）\n- 可能觸發客戶訂單確認通知（取決於商店設定）\n- 建立後訂單立即生效，需確認資料正確再執行";
+    readonly params: readonly [{
+        readonly name: "order_data";
+        readonly description: "完整訂單資料，依 Shopline API 規格傳入所有必要欄位";
+        readonly default: null;
+        readonly hasDefault: false;
+        readonly kind: "object";
+        readonly optional: false;
+    }];
+    readonly docEndpoints: readonly [{
+        readonly method: "POST";
+        readonly path: "/v1/orders";
+    }];
+    readonly operations: readonly [{
+        readonly kind: "api_post";
+        readonly method: "POST";
+        readonly endpointKey: "order_create";
+        readonly json_body: "order_data";
+    }];
+    readonly sourceLocation: {
+        readonly line: 279;
+        readonly endLine: 308;
+    };
+}, {
+    readonly module: "tools/writes/product_writes.py";
+    readonly name: "create_product";
+    readonly write: true;
+    readonly description: "[WRITE] 建立新商品。\n\n【用途】\n在 Shopline 商店中建立一筆新的商品記錄。product_data 為完整的商品 body，\n應依 Shopline Open API 規格組裝（含名稱、描述、售價、SKU 等）。\n\n【呼叫的 Shopline API】\n- POST /v1/products\n\n【回傳結構】\ndict 含 success: bool, resource_id: str, message: str, product: dict。\n\n【副作用】\n- 商品立即在商店後台可見\n- 若 SKU 或 barcode 重複，API 可能回傳錯誤\n- 新商品預設狀態取決於 product_data 內的 status 欄位";
+    readonly params: readonly [{
+        readonly name: "product_data";
+        readonly description: "完整商品建立資料，依 Shopline API 規格傳入（含 title、description、price 等欄位）";
+        readonly default: null;
+        readonly hasDefault: false;
+        readonly kind: "object";
+        readonly optional: false;
+    }];
+    readonly docEndpoints: readonly [{
+        readonly method: "POST";
+        readonly path: "/v1/products";
+    }];
+    readonly operations: readonly [{
+        readonly kind: "api_post";
+        readonly method: "POST";
+        readonly endpointKey: "product_create";
+        readonly json_body: "product_data";
+    }];
+    readonly sourceLocation: {
+        readonly line: 17;
+        readonly endLine: 44;
+    };
+}, {
+    readonly module: "tools/writes/product_writes.py";
+    readonly name: "update_product";
+    readonly write: true;
+    readonly description: "[WRITE] 更新商品基本資料。\n\n【用途】\n修改現有商品的名稱、描述、分類、狀態等欄位。僅傳入要修改的欄位，\n未傳入的欄位不會被覆蓋。\n\n【呼叫的 Shopline API】\n- PUT /v1/products/{product_id}\n\n【回傳結構】\ndict 含 success: bool, resource_id: str, message: str。\n\n【副作用】\n- 商品資料變更立即生效，前台同步更新\n- 不可復原（無版本歷史），但可再次呼叫此工具覆蓋";
+    readonly params: readonly [{
+        readonly name: "product_id";
+        readonly description: "商品內部 ID";
+        readonly default: null;
+        readonly hasDefault: false;
+        readonly kind: "string";
+        readonly optional: false;
+    }, {
+        readonly name: "product_data";
+        readonly description: "要更新的商品欄位（僅需傳入要修改的欄位）";
+        readonly default: null;
+        readonly hasDefault: false;
+        readonly kind: "object";
+        readonly optional: false;
+    }];
+    readonly docEndpoints: readonly [{
+        readonly method: "PUT";
+        readonly path: "/v1/products/{product_id}";
+    }];
+    readonly operations: readonly [{
+        readonly kind: "api_put";
+        readonly method: "PUT";
+        readonly endpointKey: "product_update";
+        readonly json_body: "product_data";
+        readonly path_params: "{'product_id': product_id}";
+    }];
+    readonly sourceLocation: {
+        readonly line: 48;
+        readonly endLine: 76;
+    };
+}, {
+    readonly module: "tools/writes/product_writes.py";
+    readonly name: "delete_product";
+    readonly write: true;
+    readonly description: "[WRITE] 刪除商品。\n\n【用途】\n從 Shopline 商店中永久刪除商品記錄。通常用於清除下架商品或測試資料。\n\n【呼叫的 Shopline API】\n- DELETE /v1/products/{product_id}\n\n【回傳結構】\ndict 含 success: bool, resource_id: str, message: str。\n\n【副作用】\n- 永久刪除商品，不可復原\n- 商品相關的訂單行項目記錄可能仍保留（取決於 Shopline 實作）\n- 刪除後前台立即下架";
+    readonly params: readonly [{
+        readonly name: "product_id";
+        readonly description: "商品內部 ID";
+        readonly default: null;
+        readonly hasDefault: false;
+        readonly kind: "string";
+        readonly optional: false;
+    }];
+    readonly docEndpoints: readonly [{
+        readonly method: "DELETE";
+        readonly path: "/v1/products/{product_id}";
+    }];
+    readonly operations: readonly [{
+        readonly kind: "api_delete";
+        readonly method: "DELETE";
+        readonly endpointKey: "product_delete";
+        readonly path_params: "{'product_id': product_id}";
+    }];
+    readonly sourceLocation: {
+        readonly line: 80;
+        readonly endLine: 104;
+    };
+}, {
+    readonly module: "tools/writes/product_writes.py";
+    readonly name: "update_product_quantity";
+    readonly write: true;
+    readonly description: "[WRITE] 更新商品庫存數量（無變體商品）。\n\n【用途】\n直接設定無變體商品的庫存數量。適用於盤點後調整庫存或手動補貨場景。\n若商品有變體，請改用 update_variation_quantity。\n\n【呼叫的 Shopline API】\n- PUT /v1/products/{product_id}/quantity\n\n【回傳結構】\ndict 含 success: bool, resource_id: str, message: str。\n\n【副作用】\n- 庫存數量立即更新，影響前台可購買數量\n- 若設為 0 且商品設定不允許超賣，前台將顯示缺貨";
+    readonly params: readonly [{
+        readonly name: "product_id";
+        readonly description: "商品內部 ID";
+        readonly default: null;
+        readonly hasDefault: false;
+        readonly kind: "string";
+        readonly optional: false;
+    }, {
+        readonly name: "quantity";
+        readonly description: "新庫存數量（絕對值，非增減量）";
+        readonly default: null;
+        readonly hasDefault: false;
+        readonly kind: "integer";
+        readonly optional: false;
+    }];
+    readonly docEndpoints: readonly [{
+        readonly method: "PUT";
+        readonly path: "/v1/products/{product_id}/quantity";
+    }];
+    readonly operations: readonly [{
+        readonly kind: "api_put";
+        readonly method: "PUT";
+        readonly endpointKey: "product_quantity";
+        readonly json_body: "{'quantity': quantity}";
+        readonly path_params: "{'product_id': product_id}";
+    }];
+    readonly sourceLocation: {
+        readonly line: 108;
+        readonly endLine: 134;
+    };
+}, {
+    readonly module: "tools/writes/product_writes.py";
+    readonly name: "update_product_price";
+    readonly write: true;
+    readonly description: "[WRITE] 更新商品售價（無變體商品）。\n\n【用途】\n直接設定無變體商品的售價。適用於調價、促銷結束恢復原價等場景。\n若商品有變體，請改用 update_variation_price。\n\n【呼叫的 Shopline API】\n- PUT /v1/products/{product_id}/price\n\n【回傳結構】\ndict 含 success: bool, resource_id: str, message: str。\n\n【副作用】\n- 售價立即更新，前台同步顯示新價格\n- 不影響進行中的訂單（訂單成立時已鎖定價格）";
+    readonly params: readonly [{
+        readonly name: "product_id";
+        readonly description: "商品內部 ID";
+        readonly default: null;
+        readonly hasDefault: false;
+        readonly kind: "string";
+        readonly optional: false;
+    }, {
+        readonly name: "price";
+        readonly description: "新售價（TWD）";
+        readonly default: null;
+        readonly hasDefault: false;
+        readonly kind: "number";
+        readonly optional: false;
+    }];
+    readonly docEndpoints: readonly [{
+        readonly method: "PUT";
+        readonly path: "/v1/products/{product_id}/price";
+    }];
+    readonly operations: readonly [{
+        readonly kind: "api_put";
+        readonly method: "PUT";
+        readonly endpointKey: "product_price";
+        readonly json_body: "{'price': price}";
+        readonly path_params: "{'product_id': product_id}";
+    }];
+    readonly sourceLocation: {
+        readonly line: 138;
+        readonly endLine: 164;
+    };
+}, {
+    readonly module: "tools/writes/product_writes.py";
+    readonly name: "create_product_variation";
+    readonly write: true;
+    readonly description: "[WRITE] 為商品新增變體。\n\n【用途】\n在現有商品下建立新的規格變體（如顏色、尺寸等）。variation_data 應依\nShopline Open API 規格組裝，含 SKU、價格、庫存等欄位。\n\n【呼叫的 Shopline API】\n- POST /v1/products/{product_id}/variations\n\n【回傳結構】\ndict 含 success: bool, resource_id: str, message: str, variation: dict。\n\n【副作用】\n- 變體立即加入商品，前台可供選擇\n- 若 SKU 重複，API 可能回傳錯誤";
+    readonly params: readonly [{
+        readonly name: "product_id";
+        readonly description: "商品內部 ID";
+        readonly default: null;
+        readonly hasDefault: false;
+        readonly kind: "string";
+        readonly optional: false;
+    }, {
+        readonly name: "variation_data";
+        readonly description: "變體資料（含 SKU、價格、庫存、規格選項等）";
+        readonly default: null;
+        readonly hasDefault: false;
+        readonly kind: "object";
+        readonly optional: false;
+    }];
+    readonly docEndpoints: readonly [{
+        readonly method: "POST";
+        readonly path: "/v1/products/{product_id}/variations";
+    }];
+    readonly operations: readonly [{
+        readonly kind: "api_post";
+        readonly method: "POST";
+        readonly endpointKey: "product_variations_create";
+        readonly json_body: "variation_data";
+        readonly path_params: "{'product_id': product_id}";
+    }];
+    readonly sourceLocation: {
+        readonly line: 168;
+        readonly endLine: 196;
+    };
+}, {
+    readonly module: "tools/writes/product_writes.py";
+    readonly name: "update_product_variation";
+    readonly write: true;
+    readonly description: "[WRITE] 更新商品變體資料。\n\n【用途】\n修改特定商品變體的 SKU、規格選項、狀態等欄位。僅傳入要修改的欄位，\n未傳入的欄位不會被覆蓋。\n\n【呼叫的 Shopline API】\n- PUT /v1/products/{product_id}/variations/{variation_id}\n\n【回傳結構】\ndict 含 success: bool, resource_id: str, message: str。\n\n【副作用】\n- 變體資料變更立即生效，前台同步更新\n- 不可復原（無版本歷史），但可再次呼叫此工具覆蓋";
+    readonly params: readonly [{
+        readonly name: "product_id";
+        readonly description: "商品內部 ID";
+        readonly default: null;
+        readonly hasDefault: false;
+        readonly kind: "string";
+        readonly optional: false;
+    }, {
+        readonly name: "variation_id";
+        readonly description: "變體內部 ID";
+        readonly default: null;
+        readonly hasDefault: false;
+        readonly kind: "string";
+        readonly optional: false;
+    }, {
+        readonly name: "variation_data";
+        readonly description: "要更新的變體欄位（僅需傳入要修改的欄位）";
+        readonly default: null;
+        readonly hasDefault: false;
+        readonly kind: "object";
+        readonly optional: false;
+    }];
+    readonly docEndpoints: readonly [{
+        readonly method: "PUT";
+        readonly path: "/v1/products/{product_id}/variations/{variation_id}";
+    }];
+    readonly operations: readonly [{
+        readonly kind: "api_put";
+        readonly method: "PUT";
+        readonly endpointKey: "product_variation_update";
+        readonly json_body: "variation_data";
+        readonly path_params: "{'product_id': product_id, 'variation_id': variation_id}";
+    }];
+    readonly sourceLocation: {
+        readonly line: 200;
+        readonly endLine: 230;
+    };
+}, {
+    readonly module: "tools/writes/product_writes.py";
+    readonly name: "delete_product_variation";
+    readonly write: true;
+    readonly description: "[WRITE] 刪除商品變體。\n\n【用途】\n從商品中永久刪除指定的規格變體。適用於停售特定規格或清理錯誤變體。\n\n【呼叫的 Shopline API】\n- DELETE /v1/products/{product_id}/variations/{variation_id}\n\n【回傳結構】\ndict 含 success: bool, resource_id: str, message: str。\n\n【副作用】\n- 永久刪除變體，不可復原\n- 若該變體為商品唯一變體，刪除後商品可能無法購買\n- 刪除後前台立即移除該規格選項";
+    readonly params: readonly [{
+        readonly name: "product_id";
+        readonly description: "商品內部 ID";
+        readonly default: null;
+        readonly hasDefault: false;
+        readonly kind: "string";
+        readonly optional: false;
+    }, {
+        readonly name: "variation_id";
+        readonly description: "變體內部 ID";
+        readonly default: null;
+        readonly hasDefault: false;
+        readonly kind: "string";
+        readonly optional: false;
+    }];
+    readonly docEndpoints: readonly [{
+        readonly method: "DELETE";
+        readonly path: "/v1/products/{product_id}/variations/{variation_id}";
+    }];
+    readonly operations: readonly [{
+        readonly kind: "api_delete";
+        readonly method: "DELETE";
+        readonly endpointKey: "product_variation_delete";
+        readonly path_params: "{'product_id': product_id, 'variation_id': variation_id}";
+    }];
+    readonly sourceLocation: {
+        readonly line: 234;
+        readonly endLine: 260;
+    };
+}, {
+    readonly module: "tools/writes/product_writes.py";
+    readonly name: "update_variation_quantity";
+    readonly write: true;
+    readonly description: "[WRITE] 更新商品變體庫存數量。\n\n【用途】\n直接設定特定變體的庫存數量。適用於盤點後調整庫存或手動補貨場景。\n若要批次更新多個 SKU 庫存，可改用 bulk_update_quantities。\n\n【呼叫的 Shopline API】\n- PUT /v1/products/{product_id}/variations/{variation_id}/quantity\n\n【回傳結構】\ndict 含 success: bool, resource_id: str, message: str。\n\n【副作用】\n- 庫存數量立即更新，影響前台可購買數量\n- 若設為 0 且商品設定不允許超賣，前台將顯示缺貨";
+    readonly params: readonly [{
+        readonly name: "product_id";
+        readonly description: "商品內部 ID";
+        readonly default: null;
+        readonly hasDefault: false;
+        readonly kind: "string";
+        readonly optional: false;
+    }, {
+        readonly name: "variation_id";
+        readonly description: "變體內部 ID";
+        readonly default: null;
+        readonly hasDefault: false;
+        readonly kind: "string";
+        readonly optional: false;
+    }, {
+        readonly name: "quantity";
+        readonly description: "新庫存數量（絕對值，非增減量）";
+        readonly default: null;
+        readonly hasDefault: false;
+        readonly kind: "integer";
+        readonly optional: false;
+    }];
+    readonly docEndpoints: readonly [{
+        readonly method: "PUT";
+        readonly path: "/v1/products/{product_id}/variations/{variation_id}/quantity";
+    }];
+    readonly operations: readonly [{
+        readonly kind: "api_put";
+        readonly method: "PUT";
+        readonly endpointKey: "product_variation_quantity";
+        readonly json_body: "{'quantity': quantity}";
+        readonly path_params: "{'product_id': product_id, 'variation_id': variation_id}";
+    }];
+    readonly sourceLocation: {
+        readonly line: 264;
+        readonly endLine: 291;
+    };
+}, {
+    readonly module: "tools/writes/product_writes.py";
+    readonly name: "update_variation_price";
+    readonly write: true;
+    readonly description: "[WRITE] 更新商品變體售價。\n\n【用途】\n直接設定特定變體的售價。適用於個別規格調價、限時特價等場景。\n\n【呼叫的 Shopline API】\n- PUT /v1/products/{product_id}/variations/{variation_id}/price\n\n【回傳結構】\ndict 含 success: bool, resource_id: str, message: str。\n\n【副作用】\n- 售價立即更新，前台同步顯示新價格\n- 不影響進行中的訂單（訂單成立時已鎖定價格）";
+    readonly params: readonly [{
+        readonly name: "product_id";
+        readonly description: "商品內部 ID";
+        readonly default: null;
+        readonly hasDefault: false;
+        readonly kind: "string";
+        readonly optional: false;
+    }, {
+        readonly name: "variation_id";
+        readonly description: "變體內部 ID";
+        readonly default: null;
+        readonly hasDefault: false;
+        readonly kind: "string";
+        readonly optional: false;
+    }, {
+        readonly name: "price";
+        readonly description: "新售價（TWD）";
+        readonly default: null;
+        readonly hasDefault: false;
+        readonly kind: "number";
+        readonly optional: false;
+    }];
+    readonly docEndpoints: readonly [{
+        readonly method: "PUT";
+        readonly path: "/v1/products/{product_id}/variations/{variation_id}/price";
+    }];
+    readonly operations: readonly [{
+        readonly kind: "api_put";
+        readonly method: "PUT";
+        readonly endpointKey: "product_variation_price";
+        readonly json_body: "{'price': price}";
+        readonly path_params: "{'product_id': product_id, 'variation_id': variation_id}";
+    }];
+    readonly sourceLocation: {
+        readonly line: 295;
+        readonly endLine: 321;
+    };
+}, {
+    readonly module: "tools/writes/product_writes.py";
+    readonly name: "update_product_tags";
+    readonly write: true;
+    readonly description: "[WRITE] 設定商品標籤（覆蓋現有標籤）。\n\n【用途】\n為商品設定標籤，常用於商品分群、促銷標記、SEO 分類等。\n注意：此操作會覆蓋商品現有的所有標籤。\n\n【呼叫的 Shopline API】\n- POST /v1/products/{product_id}/tags\n\n【回傳結構】\ndict 含 success: bool, resource_id: str, message: str。\n\n【副作用】\n- 覆蓋商品的所有現有標籤為新的標籤列表\n- 若要新增標籤而非覆蓋，請先用 get_product_list 取得現有標籤再合併後傳入";
+    readonly params: readonly [{
+        readonly name: "product_id";
+        readonly description: "商品內部 ID";
+        readonly default: null;
+        readonly hasDefault: false;
+        readonly kind: "string";
+        readonly optional: false;
+    }, {
+        readonly name: "tags";
+        readonly description: "標籤列表（會取代現有標籤）";
+        readonly default: null;
+        readonly hasDefault: false;
+        readonly kind: "array";
+        readonly optional: false;
+    }];
+    readonly docEndpoints: readonly [{
+        readonly method: "POST";
+        readonly path: "/v1/products/{product_id}/tags";
+    }];
+    readonly operations: readonly [{
+        readonly kind: "api_post";
+        readonly method: "POST";
+        readonly endpointKey: "product_tags";
+        readonly json_body: "{'tags': tags}";
+        readonly path_params: "{'product_id': product_id}";
+    }];
+    readonly sourceLocation: {
+        readonly line: 325;
+        readonly endLine: 351;
+    };
+}, {
+    readonly module: "tools/writes/product_writes.py";
+    readonly name: "add_product_images";
+    readonly write: true;
+    readonly description: "[WRITE] 為商品新增圖片。\n\n【用途】\n上傳圖片 URL 至商品相簿，圖片會被加入到現有圖片之後。\n適用於新增商品展示圖、情境圖等。\n\n【呼叫的 Shopline API】\n- POST /v1/products/{product_id}/images\n\n【回傳結構】\ndict 含 success: bool, resource_id: str, message: str, images: list。\n\n【副作用】\n- 圖片加入商品相簿，前台立即可見\n- 圖片 URL 必須為公開可存取的連結，Shopline 將下載並儲存\n- 圖片數量上限取決於 Shopline 商店方案設定";
+    readonly params: readonly [{
+        readonly name: "product_id";
+        readonly description: "商品內部 ID";
+        readonly default: null;
+        readonly hasDefault: false;
+        readonly kind: "string";
+        readonly optional: false;
+    }, {
+        readonly name: "image_urls";
+        readonly description: "圖片 URL 列表（公開可存取的圖片連結）";
+        readonly default: null;
+        readonly hasDefault: false;
+        readonly kind: "array";
+        readonly optional: false;
+    }];
+    readonly docEndpoints: readonly [{
+        readonly method: "POST";
+        readonly path: "/v1/products/{product_id}/images";
+    }];
+    readonly operations: readonly [{
+        readonly kind: "api_post";
+        readonly method: "POST";
+        readonly endpointKey: "product_images";
+        readonly json_body: "{'image_urls': image_urls}";
+        readonly path_params: "{'product_id': product_id}";
+    }];
+    readonly sourceLocation: {
+        readonly line: 355;
+        readonly endLine: 384;
+    };
+}, {
+    readonly module: "tools/writes/product_writes.py";
+    readonly name: "delete_product_images";
+    readonly write: true;
+    readonly description: "[WRITE] 刪除商品圖片。\n\n【用途】\n從商品相簿中刪除指定圖片。適用於移除過時圖片或錯誤上傳的圖片。\n\n【呼叫的 Shopline API】\n- DELETE /v1/products/{product_id}/images\n\n【回傳結構】\ndict 含 success: bool, resource_id: str, message: str。\n\n【副作用】\n- 永久刪除指定圖片，不可復原\n- 若被刪除的圖片為商品主圖，商品主圖將自動替換為相簿中下一張圖片";
+    readonly params: readonly [{
+        readonly name: "product_id";
+        readonly description: "商品內部 ID";
+        readonly default: null;
+        readonly hasDefault: false;
+        readonly kind: "string";
+        readonly optional: false;
+    }, {
+        readonly name: "image_ids";
+        readonly description: "要刪除的圖片 ID 列表";
+        readonly default: null;
+        readonly hasDefault: false;
+        readonly kind: "array";
+        readonly optional: false;
+    }];
+    readonly docEndpoints: readonly [{
+        readonly method: "DELETE";
+        readonly path: "/v1/products/{product_id}/images";
+    }];
+    readonly operations: readonly [{
+        readonly kind: "api_delete";
+        readonly method: "DELETE";
+        readonly endpointKey: "product_images";
+        readonly json_body: "{'image_ids': image_ids}";
+        readonly path_params: "{'product_id': product_id}";
+    }];
+    readonly sourceLocation: {
+        readonly line: 388;
+        readonly endLine: 413;
+    };
+}, {
+    readonly module: "tools/writes/product_writes.py";
+    readonly name: "bulk_update_quantities";
+    readonly write: true;
+    readonly description: "[WRITE] 批次更新多個 SKU 的庫存數量。\n\n【用途】\n一次更新多個商品或變體的庫存，適用於盤點後大批調整、進貨入庫等場景。\n比逐一呼叫 update_product_quantity / update_variation_quantity 更有效率。\n\n【呼叫的 Shopline API】\n- PUT /v1/products/bulk-update-quantities\n\n【回傳結構】\ndict 含 success: bool, resource_id: str, message: str, updated_count: int。\n\n【副作用】\n- 所有 SKU 的庫存數量立即更新，影響前台可購買數量\n- 若某 SKU 不存在，API 可能略過或回傳錯誤（取決於 Shopline 實作）\n- 建議先確認 SKU 正確後再執行批次操作";
+    readonly params: readonly [{
+        readonly name: "updates";
+        readonly description: "庫存更新列表，每筆為 {sku: str, quantity: int}，以 SKU 識別商品/變體";
+        readonly default: null;
+        readonly hasDefault: false;
+        readonly kind: "array";
+        readonly optional: false;
+    }];
+    readonly docEndpoints: readonly [{
+        readonly method: "PUT";
+        readonly path: "/v1/products/bulk-update-quantities";
+    }];
+    readonly operations: readonly [{
+        readonly kind: "api_put";
+        readonly method: "PUT";
+        readonly endpointKey: "products_bulk_quantities";
+        readonly json_body: "{'updates': updates}";
+    }];
+    readonly sourceLocation: {
+        readonly line: 417;
+        readonly endLine: 445;
+    };
+}, {
+    readonly module: "tools/writes/product_writes.py";
+    readonly name: "bulk_assign_categories";
+    readonly write: true;
+    readonly description: "[WRITE] 批次將多個商品指派至指定分類。\n\n【用途】\n一次將多個商品加入一或多個分類，適用於新季商品上架分類、重新整理分類結構等場景。\n比逐一更新商品分類更有效率。\n\n【呼叫的 Shopline API】\n- POST /v1/products/bulk-assign-categories\n\n【回傳結構】\ndict 含 success: bool, resource_id: str, message: str, product_count: int, category_count: int。\n\n【副作用】\n- 商品與分類的關聯立即生效，前台分類頁面同步更新\n- 此操作為新增關聯（非覆蓋），商品原有的分類不會被移除\n- 若商品或分類 ID 不存在，API 可能略過或回傳錯誤";
+    readonly params: readonly [{
+        readonly name: "product_ids";
+        readonly description: "商品 ID 列表";
+        readonly default: null;
+        readonly hasDefault: false;
+        readonly kind: "array";
+        readonly optional: false;
+    }, {
+        readonly name: "category_ids";
+        readonly description: "要指派的分類 ID 列表";
+        readonly default: null;
+        readonly hasDefault: false;
+        readonly kind: "array";
+        readonly optional: false;
+    }];
+    readonly docEndpoints: readonly [{
+        readonly method: "POST";
+        readonly path: "/v1/products/bulk-assign-categories";
+    }];
+    readonly operations: readonly [{
+        readonly kind: "api_post";
+        readonly method: "POST";
+        readonly endpointKey: "products_bulk_categories";
+        readonly json_body: "{'product_ids': product_ids, 'category_ids': category_ids}";
+    }];
+    readonly sourceLocation: {
+        readonly line: 449;
+        readonly endLine: 478;
+    };
+}, {
+    readonly module: "tools/writes/promotion_writes.py";
+    readonly name: "create_promotion";
+    readonly write: true;
+    readonly description: "[WRITE] 建立新促銷活動。\n\n【用途】\n在 Shopline 商店中建立新的促銷活動，例如折扣碼、買一送一、滿額折扣等。\n\n【呼叫的 Shopline API】\n- POST /v1/promotions\n\n【回傳結構】\ndict 含 success: bool, resource_id: str, message: str, promotion: dict。\n\n【副作用】\n- 在商店促銷列表中新增一筆促銷活動，活動狀態依 promotion_data 設定而定\n- 若活動設定為立即啟用，消費者即可使用該促銷\n- 促銷規則設定後如需修改，請使用 update_promotion";
+    readonly params: readonly [{
+        readonly name: "promotion_data";
+        readonly description: "促銷活動資料（參考 Shopline promotion 物件結構）";
+        readonly default: null;
+        readonly hasDefault: false;
+        readonly kind: "object";
+        readonly optional: false;
+    }];
+    readonly docEndpoints: readonly [{
+        readonly method: "POST";
+        readonly path: "/v1/promotions";
+    }];
+    readonly operations: readonly [{
+        readonly kind: "api_post";
+        readonly method: "POST";
+        readonly endpointKey: "promotion_create";
+        readonly json_body: "promotion_data";
+    }];
+    readonly sourceLocation: {
+        readonly line: 20;
+        readonly endLine: 47;
+    };
+}, {
+    readonly module: "tools/writes/promotion_writes.py";
+    readonly name: "update_promotion";
+    readonly write: true;
+    readonly description: "[WRITE] 更新既有促銷活動。\n\n【用途】\n修改已建立的促銷活動內容，例如調整折扣金額、有效期限、適用條件等。\n\n【呼叫的 Shopline API】\n- PUT /v1/promotions/{promotion_id}\n\n【回傳結構】\ndict 含 success: bool, resource_id: str, message: str。\n\n【副作用】\n- 修改立即生效，已在結帳流程中的消費者可能受影響\n- 不可復原（無版本歷史），但可再次呼叫此工具覆蓋";
+    readonly params: readonly [{
+        readonly name: "promotion_id";
+        readonly description: "促銷活動 ID";
+        readonly default: null;
+        readonly hasDefault: false;
+        readonly kind: "string";
+        readonly optional: false;
+    }, {
+        readonly name: "promotion_data";
+        readonly description: "要更新的促銷活動欄位（僅傳入需修改的欄位）";
+        readonly default: null;
+        readonly hasDefault: false;
+        readonly kind: "object";
+        readonly optional: false;
+    }];
+    readonly docEndpoints: readonly [{
+        readonly method: "PUT";
+        readonly path: "/v1/promotions/{promotion_id}";
+    }];
+    readonly operations: readonly [{
+        readonly kind: "api_put";
+        readonly method: "PUT";
+        readonly endpointKey: "promotion_update";
+        readonly json_body: "promotion_data";
+        readonly path_params: "{'promotion_id': promotion_id}";
+    }];
+    readonly sourceLocation: {
+        readonly line: 51;
+        readonly endLine: 83;
+    };
+}, {
+    readonly module: "tools/writes/promotion_writes.py";
+    readonly name: "delete_promotion";
+    readonly write: true;
+    readonly description: "[WRITE] 刪除促銷活動。\n\n【用途】\n永久刪除指定的促銷活動。通常用於清除過期、測試或錯誤建立的活動。\n\n【呼叫的 Shopline API】\n- DELETE /v1/promotions/{promotion_id}\n\n【回傳結構】\ndict 含 success: bool, resource_id: str, message: str。\n\n【副作用】\n- 永久刪除該促銷活動，不可復原\n- 刪除後消費者無法再使用與該活動相關的折扣碼或優惠\n- 已套用該促銷的歷史訂單不受影響";
+    readonly params: readonly [{
+        readonly name: "promotion_id";
+        readonly description: "促銷活動 ID";
+        readonly default: null;
+        readonly hasDefault: false;
+        readonly kind: "string";
+        readonly optional: false;
+    }];
+    readonly docEndpoints: readonly [{
+        readonly method: "DELETE";
+        readonly path: "/v1/promotions/{promotion_id}";
+    }];
+    readonly operations: readonly [{
+        readonly kind: "api_delete";
+        readonly method: "DELETE";
+        readonly endpointKey: "promotion_delete";
+        readonly path_params: "{'promotion_id': promotion_id}";
+    }];
+    readonly sourceLocation: {
+        readonly line: 87;
+        readonly endLine: 111;
+    };
+}, {
+    readonly module: "tools/writes/promotion_writes.py";
+    readonly name: "send_coupon";
+    readonly write: true;
+    readonly description: "[WRITE] 發送優惠券給指定客戶。\n\n【用途】\n主動將優惠券發送給特定客戶，常用於行銷活動、客戶回饋、CRM 觸發場景。\n\n【呼叫的 Shopline API】\n- POST /v1/coupons/send\n\n【回傳結構】\ndict 含 success: bool, resource_id: str, message: str, result: dict。\n\n【副作用】\n- 優惠券發送後，目標客戶帳號中將出現對應的優惠券\n- 依優惠券設定，可能有數量限制；若庫存不足，API 會回傳錯誤\n- 部分類型的優惠券一旦發送，無法收回";
+    readonly params: readonly [{
+        readonly name: "coupon_data";
+        readonly description: "優惠券發送資料，通常包含 coupon_id 與目標客戶識別資訊";
+        readonly default: null;
+        readonly hasDefault: false;
+        readonly kind: "object";
+        readonly optional: false;
+    }];
+    readonly docEndpoints: readonly [{
+        readonly method: "POST";
+        readonly path: "/v1/coupons/send";
+    }];
+    readonly operations: readonly [{
+        readonly kind: "api_post";
+        readonly method: "POST";
+        readonly endpointKey: "coupon_send";
+        readonly json_body: "coupon_data";
+    }];
+    readonly sourceLocation: {
+        readonly line: 119;
+        readonly endLine: 146;
+    };
+}, {
+    readonly module: "tools/writes/promotion_writes.py";
+    readonly name: "redeem_coupon";
+    readonly write: true;
+    readonly description: "[WRITE] 核銷（使用）優惠券。\n\n【用途】\n在結帳或特定場景下核銷優惠券，將優惠券標記為已使用狀態。\n適合 POS 場景或 API 整合的結帳流程。\n\n【呼叫的 Shopline API】\n- POST /v1/coupons/redeem\n\n【回傳結構】\ndict 含 success: bool, resource_id: str, message: str, result: dict。\n\n【副作用】\n- 優惠券狀態變更為已使用，不可再次使用（一次性優惠券）\n- 核銷紀錄會寫入系統，影響促銷統計報告\n- 操作通常不可逆，請確認核銷對象與條件正確";
+    readonly params: readonly [{
+        readonly name: "coupon_data";
+        readonly description: "優惠券核銷資料，通常包含 coupon_code 與訂單或客戶識別資訊";
+        readonly default: null;
+        readonly hasDefault: false;
+        readonly kind: "object";
+        readonly optional: false;
+    }];
+    readonly docEndpoints: readonly [{
+        readonly method: "POST";
+        readonly path: "/v1/coupons/redeem";
+    }];
+    readonly operations: readonly [{
+        readonly kind: "api_post";
+        readonly method: "POST";
+        readonly endpointKey: "coupon_redeem";
+        readonly json_body: "coupon_data";
+    }];
+    readonly sourceLocation: {
+        readonly line: 150;
+        readonly endLine: 178;
+    };
+}, {
+    readonly module: "tools/writes/promotion_writes.py";
+    readonly name: "claim_coupon";
+    readonly write: true;
+    readonly description: "[WRITE] 客戶領取優惠券。\n\n【用途】\n代表客戶領取（claim）一張優惠券，將優惠券綁定至該客戶帳號。\n適合兌換碼場景或 API 整合的會員領券流程。\n\n【呼叫的 Shopline API】\n- POST /v1/coupons/claim\n\n【回傳結構】\ndict 含 success: bool, resource_id: str, message: str, result: dict。\n\n【副作用】\n- 優惠券與指定客戶綁定，消費者帳號中可看到此優惠券\n- 若優惠券已達領取上限或已過期，API 會回傳錯誤\n- 同一張優惠券通常每位客戶只能領取一次（依設定而異）";
+    readonly params: readonly [{
+        readonly name: "coupon_data";
+        readonly description: "優惠券領取資料，通常包含 coupon_code 與客戶識別資訊";
+        readonly default: null;
+        readonly hasDefault: false;
+        readonly kind: "object";
+        readonly optional: false;
+    }];
+    readonly docEndpoints: readonly [{
+        readonly method: "POST";
+        readonly path: "/v1/coupons/claim";
+    }];
+    readonly operations: readonly [{
+        readonly kind: "api_post";
+        readonly method: "POST";
+        readonly endpointKey: "coupon_claim";
+        readonly json_body: "coupon_data";
+    }];
+    readonly sourceLocation: {
+        readonly line: 182;
+        readonly endLine: 210;
+    };
+}, {
+    readonly module: "tools/writes/promotion_writes.py";
+    readonly name: "create_flash_price_campaign";
+    readonly write: true;
+    readonly description: "[WRITE] 建立快閃價格活動。\n\n【用途】\n建立限時特價活動（Flash Sale），在指定時段內將商品調整為特定價格。\n適合節慶特賣、清倉、限時搶購等場景。\n\n【呼叫的 Shopline API】\n- POST /v1/flash_price_campaigns\n\n【回傳結構】\ndict 含 success: bool, resource_id: str, message: str, campaign: dict。\n\n【副作用】\n- 活動建立後，依設定的開始時間自動啟用特價\n- 活動期間，符合條件的商品會顯示特價，影響商店前台的價格呈現\n- 若活動時段與其他促銷重疊，需確認優先規則";
+    readonly params: readonly [{
+        readonly name: "campaign_data";
+        readonly description: "快閃價格活動資料（參考 Shopline flash_price_campaign 物件結構）";
+        readonly default: null;
+        readonly hasDefault: false;
+        readonly kind: "object";
+        readonly optional: false;
+    }];
+    readonly docEndpoints: readonly [{
+        readonly method: "POST";
+        readonly path: "/v1/flash_price_campaigns";
+    }];
+    readonly operations: readonly [{
+        readonly kind: "api_post";
+        readonly method: "POST";
+        readonly endpointKey: "flash_price_campaign_create";
+        readonly json_body: "campaign_data";
+    }];
+    readonly sourceLocation: {
+        readonly line: 218;
+        readonly endLine: 246;
+    };
+}, {
+    readonly module: "tools/writes/promotion_writes.py";
+    readonly name: "update_flash_price_campaign";
+    readonly write: true;
+    readonly description: "[WRITE] 更新快閃價格活動。\n\n【用途】\n修改已建立的快閃價格活動，例如調整特價金額、活動時段或適用商品範圍。\n\n【呼叫的 Shopline API】\n- PUT /v1/flash_price_campaigns/{campaign_id}\n\n【回傳結構】\ndict 含 success: bool, resource_id: str, message: str。\n\n【副作用】\n- 修改立即生效；若活動正在進行中，前台價格即時更新\n- 不可復原（無版本歷史），但可再次呼叫此工具覆蓋";
+    readonly params: readonly [{
+        readonly name: "campaign_id";
+        readonly description: "快閃價格活動 ID";
+        readonly default: null;
+        readonly hasDefault: false;
+        readonly kind: "string";
+        readonly optional: false;
+    }, {
+        readonly name: "campaign_data";
+        readonly description: "要更新的活動欄位（僅傳入需修改的欄位）";
+        readonly default: null;
+        readonly hasDefault: false;
+        readonly kind: "object";
+        readonly optional: false;
+    }];
+    readonly docEndpoints: readonly [{
+        readonly method: "PUT";
+        readonly path: "/v1/flash_price_campaigns/{campaign_id}";
+    }];
+    readonly operations: readonly [{
+        readonly kind: "api_put";
+        readonly method: "PUT";
+        readonly endpointKey: "flash_price_campaign_update";
+        readonly json_body: "campaign_data";
+        readonly path_params: "{'campaign_id': campaign_id}";
+    }];
+    readonly sourceLocation: {
+        readonly line: 250;
+        readonly endLine: 282;
+    };
+}, {
+    readonly module: "tools/writes/promotion_writes.py";
+    readonly name: "delete_flash_price_campaign";
+    readonly write: true;
+    readonly description: "[WRITE] 刪除快閃價格活動。\n\n【用途】\n永久刪除指定的快閃價格活動。用於清除已結束、取消或錯誤建立的活動。\n\n【呼叫的 Shopline API】\n- DELETE /v1/flash_price_campaigns/{campaign_id}\n\n【回傳結構】\ndict 含 success: bool, resource_id: str, message: str。\n\n【副作用】\n- 永久刪除該活動，不可復原\n- 若活動正在進行中，刪除後商品立即恢復原價\n- 歷史訂單中已套用的特價不受影響";
+    readonly params: readonly [{
+        readonly name: "campaign_id";
+        readonly description: "快閃價格活動 ID";
+        readonly default: null;
+        readonly hasDefault: false;
+        readonly kind: "string";
+        readonly optional: false;
+    }];
+    readonly docEndpoints: readonly [{
+        readonly method: "DELETE";
+        readonly path: "/v1/flash_price_campaigns/{campaign_id}";
+    }];
+    readonly operations: readonly [{
+        readonly kind: "api_delete";
+        readonly method: "DELETE";
+        readonly endpointKey: "flash_price_campaign_delete";
+        readonly path_params: "{'campaign_id': campaign_id}";
+    }];
+    readonly sourceLocation: {
+        readonly line: 286;
+        readonly endLine: 311;
+    };
+}, {
+    readonly module: "tools/writes/promotion_writes.py";
+    readonly name: "create_affiliate_campaign";
+    readonly write: true;
+    readonly description: "[WRITE] 建立聯盟行銷活動。\n\n【用途】\n建立聯盟行銷（Affiliate）活動，設定推薦獎勵規則，讓推廣夥伴（聯盟會員）\n透過分享連結或代碼帶來訂單並獲得佣金。\n\n【呼叫的 Shopline API】\n- POST /v1/affiliate_campaigns\n\n【回傳結構】\ndict 含 success: bool, resource_id: str, message: str, campaign: dict。\n\n【副作用】\n- 活動建立後，可將活動連結或代碼分發給聯盟夥伴\n- 活動啟用後，透過聯盟連結產生的訂單將自動計算佣金\n- 請確認佣金規則與結算方式設定正確，避免財務損失";
+    readonly params: readonly [{
+        readonly name: "campaign_data";
+        readonly description: "聯盟行銷活動資料（參考 Shopline affiliate_campaign 物件結構）";
+        readonly default: null;
+        readonly hasDefault: false;
+        readonly kind: "object";
+        readonly optional: false;
+    }];
+    readonly docEndpoints: readonly [{
+        readonly method: "POST";
+        readonly path: "/v1/affiliate_campaigns";
+    }];
+    readonly operations: readonly [{
+        readonly kind: "api_post";
+        readonly method: "POST";
+        readonly endpointKey: "affiliate_campaign_create";
+        readonly json_body: "campaign_data";
+    }];
+    readonly sourceLocation: {
+        readonly line: 319;
+        readonly endLine: 347;
+    };
+}, {
+    readonly module: "tools/writes/promotion_writes.py";
+    readonly name: "update_affiliate_campaign";
+    readonly write: true;
+    readonly description: "[WRITE] 更新聯盟行銷活動。\n\n【用途】\n修改已建立的聯盟行銷活動，例如調整佣金比例、活動期限或適用條件。\n\n【呼叫的 Shopline API】\n- PUT /v1/affiliate_campaigns/{campaign_id}\n\n【回傳結構】\ndict 含 success: bool, resource_id: str, message: str。\n\n【副作用】\n- 修改立即生效；佣金規則調整後，新訂單將套用新規則\n- 已產生的佣金紀錄不受影響（依各活動的歷史快照而定）\n- 不可復原（無版本歷史），但可再次呼叫此工具覆蓋";
+    readonly params: readonly [{
+        readonly name: "campaign_id";
+        readonly description: "聯盟行銷活動 ID";
+        readonly default: null;
+        readonly hasDefault: false;
+        readonly kind: "string";
+        readonly optional: false;
+    }, {
+        readonly name: "campaign_data";
+        readonly description: "要更新的活動欄位（僅傳入需修改的欄位）";
+        readonly default: null;
+        readonly hasDefault: false;
+        readonly kind: "object";
+        readonly optional: false;
+    }];
+    readonly docEndpoints: readonly [{
+        readonly method: "PUT";
+        readonly path: "/v1/affiliate_campaigns/{campaign_id}";
+    }];
+    readonly operations: readonly [{
+        readonly kind: "api_put";
+        readonly method: "PUT";
+        readonly endpointKey: "affiliate_campaign_update";
+        readonly json_body: "campaign_data";
+        readonly path_params: "{'campaign_id': campaign_id}";
+    }];
+    readonly sourceLocation: {
+        readonly line: 351;
+        readonly endLine: 384;
+    };
+}, {
+    readonly module: "tools/writes/promotion_writes.py";
+    readonly name: "delete_affiliate_campaign";
+    readonly write: true;
+    readonly description: "[WRITE] 刪除聯盟行銷活動。\n\n【用途】\n永久刪除指定的聯盟行銷活動。用於清除已結束、取消或錯誤建立的活動。\n\n【呼叫的 Shopline API】\n- DELETE /v1/affiliate_campaigns/{campaign_id}\n\n【回傳結構】\ndict 含 success: bool, resource_id: str, message: str。\n\n【副作用】\n- 永久刪除該活動，不可復原\n- 刪除後聯盟夥伴的推廣連結或代碼將失效，無法再追蹤新訂單\n- 已累積的佣金紀錄與歷史訂單資料不受影響（依 Shopline 實作而定）";
+    readonly params: readonly [{
+        readonly name: "campaign_id";
+        readonly description: "聯盟行銷活動 ID";
+        readonly default: null;
+        readonly hasDefault: false;
+        readonly kind: "string";
+        readonly optional: false;
+    }];
+    readonly docEndpoints: readonly [{
+        readonly method: "DELETE";
+        readonly path: "/v1/affiliate_campaigns/{campaign_id}";
+    }];
+    readonly operations: readonly [{
+        readonly kind: "api_delete";
+        readonly method: "DELETE";
+        readonly endpointKey: "affiliate_campaign_delete";
+        readonly path_params: "{'campaign_id': campaign_id}";
+    }];
+    readonly sourceLocation: {
+        readonly line: 388;
+        readonly endLine: 413;
+    };
+}, {
+    readonly module: "tools/writes/purchase_order_writes.py";
+    readonly name: "create_purchase_order";
+    readonly write: true;
+    readonly description: "[WRITE] 建立新採購單。\n\n【用途】\n在 Shopline POS 系統中建立一筆新的採購單，用於記錄向供應商進貨的資訊。\n\n【呼叫的 Shopline API】\n- POST /v1/pos/purchase_orders\n\n【回傳結構】\ndict 含 success: bool, resource_id: str, message: str, purchase_order: dict。\n\n【副作用】\n- 在 POS 採購單列表中新增一筆記錄\n- 採購單建立後可進行後續入庫確認操作";
+    readonly params: readonly [{
+        readonly name: "purchase_order_data";
+        readonly description: "採購單資料，例如 {supplier_id, items: [{sku, quantity, cost}, ...], ...}";
+        readonly default: null;
+        readonly hasDefault: false;
+        readonly kind: "object";
+        readonly optional: false;
+    }];
+    readonly docEndpoints: readonly [{
+        readonly method: "POST";
+        readonly path: "/v1/pos/purchase_orders";
+    }];
+    readonly operations: readonly [{
+        readonly kind: "api_post";
+        readonly method: "POST";
+        readonly endpointKey: "purchase_order_create";
+        readonly json_body: "purchase_order_data";
+    }];
+    readonly sourceLocation: {
+        readonly line: 16;
+        readonly endLine: 43;
+    };
+}, {
+    readonly module: "tools/writes/purchase_order_writes.py";
+    readonly name: "delete_purchase_orders";
+    readonly write: true;
+    readonly description: "[WRITE] 批次刪除採購單。\n\n【用途】\n一次刪除一或多筆 POS 採購單記錄，適合清除測試資料或作廢錯誤採購單。\n\n【呼叫的 Shopline API】\n- DELETE /v1/pos/purchase_orders\n\n【回傳結構】\ndict 含 success: bool, resource_id: str, message: str。\n\n【副作用】\n- 永久刪除指定的採購單記錄，不可復原\n- 若採購單已執行入庫操作，刪除可能受限（取決於 Shopline 實作）";
+    readonly params: readonly [{
+        readonly name: "purchase_order_ids";
+        readonly description: "要刪除的採購單 ID 列表（可批次刪除多筆）";
+        readonly default: null;
+        readonly hasDefault: false;
+        readonly kind: "array";
+        readonly optional: false;
+    }];
+    readonly docEndpoints: readonly [{
+        readonly method: "DELETE";
+        readonly path: "/v1/pos/purchase_orders";
+    }];
+    readonly operations: readonly [];
+    readonly sourceLocation: {
+        readonly line: 47;
+        readonly endLine: 79;
+    };
+}, {
+    readonly module: "tools/writes/return_order_writes.py";
+    readonly name: "create_return_order";
+    readonly write: true;
+    readonly description: "[WRITE] 建立退貨／退款申請單。\n\n【用途】\n針對指定訂單建立退貨或退款申請，適用於客服處理退換貨流程。\n\n【呼叫的 Shopline API】\n- POST /v1/return_orders\n\n【回傳結構】\ndict 含 success: bool, resource_id: str, message: str, return_order: dict。\n\n【副作用】\n- 在系統中建立退貨／退款申請記錄，狀態為待審核\n- 觸發退貨流程，可能影響庫存預留與財務帳務（視 Shopline 退貨處理設定）\n- 若訂單不符退貨條件（如已超過退貨期限），API 可能回傳錯誤";
+    readonly params: readonly [{
+        readonly name: "return_order_data";
+        readonly description: "退貨單資料，例如 {\"order_id\": \"ORD123\", \"reason\": \"商品瑕疵\", \"items\": [{\"line_item_id\": \"LI001\", \"quantity\": 1}]}";
+        readonly default: null;
+        readonly hasDefault: false;
+        readonly kind: "object";
+        readonly optional: false;
+    }];
+    readonly docEndpoints: readonly [{
+        readonly method: "POST";
+        readonly path: "/v1/return_orders";
+    }];
+    readonly operations: readonly [{
+        readonly kind: "api_post";
+        readonly method: "POST";
+        readonly endpointKey: "return_order_create";
+        readonly json_body: "return_order_data";
+    }];
+    readonly sourceLocation: {
+        readonly line: 15;
+        readonly endLine: 48;
+    };
+}, {
+    readonly module: "tools/writes/return_order_writes.py";
+    readonly name: "update_return_order";
+    readonly write: true;
+    readonly description: "[WRITE] 更新退貨單狀態或資料。\n\n【用途】\n修改退貨單的審核狀態、退款金額、備註等資料，適用於客服審核退貨申請流程。\n\n【呼叫的 Shopline API】\n- PUT /v1/return_orders/{return_order_id}\n\n【回傳結構】\ndict 含 success: bool, resource_id: str, message: str。\n\n【副作用】\n- 退貨單資料變更立即生效\n- 若將狀態更新為「已退款」，可能觸發實際退款動作並影響財務帳務\n- 不可復原，請謹慎確認狀態變更";
+    readonly params: readonly [{
+        readonly name: "return_order_id";
+        readonly description: "退貨單 ID";
+        readonly default: null;
+        readonly hasDefault: false;
+        readonly kind: "string";
+        readonly optional: false;
+    }, {
+        readonly name: "return_order_data";
+        readonly description: "要更新的退貨單欄位，例如 {\"status\": \"approved\", \"note\": \"已確認退款\"}";
+        readonly default: null;
+        readonly hasDefault: false;
+        readonly kind: "object";
+        readonly optional: false;
+    }];
+    readonly docEndpoints: readonly [{
+        readonly method: "PUT";
+        readonly path: "/v1/return_orders/{return_order_id}";
+    }];
+    readonly operations: readonly [{
+        readonly kind: "api_put";
+        readonly method: "PUT";
+        readonly endpointKey: "return_order_update";
+        readonly json_body: "return_order_data";
+        readonly path_params: "{'return_order_id': return_order_id}";
+    }];
+    readonly sourceLocation: {
+        readonly line: 52;
+        readonly endLine: 80;
+    };
+}, {
+    readonly module: "tools/writes/review_writes.py";
+    readonly name: "create_product_review";
+    readonly write: true;
+    readonly description: "[WRITE] 建立單筆商品評論。\n\n【用途】\n為指定商品建立一筆顧客評論，適用於客服代為補登評論或匯入歷史評論資料。\n\n【呼叫的 Shopline API】\n- POST /v1/product_review_comments\n\n【回傳結構】\ndict 含 success: bool, resource_id: str, message: str, review: dict。\n\n【副作用】\n- 在商品評論列表中新增一筆評論，依商店設定可能立即公開或待審核\n- 影響商品的平均評分顯示";
+    readonly params: readonly [{
+        readonly name: "review_data";
+        readonly description: "評論資料，例如 {\"product_id\": \"P001\", \"rating\": 5, \"content\": \"品質很好！\", \"reviewer_name\": \"王小明\"}";
+        readonly default: null;
+        readonly hasDefault: false;
+        readonly kind: "object";
+        readonly optional: false;
+    }];
+    readonly docEndpoints: readonly [{
+        readonly method: "POST";
+        readonly path: "/v1/product_review_comments";
+    }];
+    readonly operations: readonly [{
+        readonly kind: "api_post";
+        readonly method: "POST";
+        readonly endpointKey: "product_review_comment_create";
+        readonly json_body: "review_data";
+    }];
+    readonly sourceLocation: {
+        readonly line: 16;
+        readonly endLine: 48;
+    };
+}, {
+    readonly module: "tools/writes/review_writes.py";
+    readonly name: "bulk_create_product_reviews";
+    readonly write: true;
+    readonly description: "[WRITE] 批次建立多筆商品評論。\n\n【用途】\n一次性批次建立多筆商品評論，適用於大量匯入歷史評論或促銷活動後的評論補登。\n\n【呼叫的 Shopline API】\n- POST /v1/product_review_comments/bulk\n\n【回傳結構】\ndict 含 success: bool, resource_id: str, message: str, result: dict。\n\n【副作用】\n- 批次在商品評論列表中新增多筆評論\n- 依商店設定，評論可能立即公開或待審核\n- 影響相關商品的平均評分顯示\n- 部分評論若格式錯誤，整批可能失敗或僅失敗該筆（視 API 實作而定）";
+    readonly params: readonly [{
+        readonly name: "reviews";
+        readonly description: "評論資料列表，每筆格式同 create_product_review，例如 [{\"product_id\": \"P001\", \"rating\": 5, \"content\": \"讚！\"}]";
+        readonly default: null;
+        readonly hasDefault: false;
+        readonly kind: "array";
+        readonly optional: false;
+    }];
+    readonly docEndpoints: readonly [{
+        readonly method: "POST";
+        readonly path: "/v1/product_review_comments/bulk";
+    }];
+    readonly operations: readonly [{
+        readonly kind: "api_post";
+        readonly method: "POST";
+        readonly endpointKey: "product_review_comments_bulk_create";
+        readonly json_body: "{'comments': reviews}";
+    }];
+    readonly sourceLocation: {
+        readonly line: 52;
+        readonly endLine: 85;
+    };
+}, {
+    readonly module: "tools/writes/review_writes.py";
+    readonly name: "update_product_review";
+    readonly write: true;
+    readonly description: "[WRITE] 更新單筆商品評論。\n\n【用途】\n修改評論內容、審核狀態、評分等資料，適用於客服審核或編輯不當評論。\n\n【呼叫的 Shopline API】\n- PATCH /v1/product_review_comments/{comment_id}\n\n【回傳結構】\ndict 含 success: bool, resource_id: str, message: str。\n\n【副作用】\n- 評論資料變更立即生效\n- 若變更評分，商品平均評分將同步更新\n- 不可復原，但可再次呼叫此工具覆蓋";
+    readonly params: readonly [{
+        readonly name: "comment_id";
+        readonly description: "評論 ID";
+        readonly default: null;
+        readonly hasDefault: false;
+        readonly kind: "string";
+        readonly optional: false;
+    }, {
+        readonly name: "review_data";
+        readonly description: "要更新的評論欄位，例如 {\"status\": \"published\", \"content\": \"修改後的評論\"}";
+        readonly default: null;
+        readonly hasDefault: false;
+        readonly kind: "object";
+        readonly optional: false;
+    }];
+    readonly docEndpoints: readonly [{
+        readonly method: "PATCH";
+        readonly path: "/v1/product_review_comments/{comment_id}";
+    }];
+    readonly operations: readonly [{
+        readonly kind: "api_patch";
+        readonly method: "PATCH";
+        readonly endpointKey: "product_review_comment_update";
+        readonly json_body: "review_data";
+        readonly path_params: "{'comment_id': comment_id}";
+    }];
+    readonly sourceLocation: {
+        readonly line: 89;
+        readonly endLine: 117;
+    };
+}, {
+    readonly module: "tools/writes/review_writes.py";
+    readonly name: "bulk_update_product_reviews";
+    readonly write: true;
+    readonly description: "[WRITE] 批次更新多筆商品評論。\n\n【用途】\n一次性批次審核或修改多筆評論狀態，適用於管理員批次公開或隱藏評論。\n\n【呼叫的 Shopline API】\n- PATCH /v1/product_review_comments\n\n【回傳結構】\ndict 含 success: bool, resource_id: str, message: str, result: dict。\n\n【副作用】\n- 批次更新多筆評論，變更立即生效\n- 若有評論狀態變更，相關商品的平均評分可能同步更新\n- 部分評論若 id 不存在，整批可能失敗或僅失敗該筆（視 API 實作而定）";
+    readonly params: readonly [{
+        readonly name: "updates";
+        readonly description: "批次更新資料列表，每筆須含 id 欄位，例如 [{\"id\": \"C001\", \"status\": \"published\"}, {\"id\": \"C002\", \"status\": \"hidden\"}]";
+        readonly default: null;
+        readonly hasDefault: false;
+        readonly kind: "array";
+        readonly optional: false;
+    }];
+    readonly docEndpoints: readonly [{
+        readonly method: "PATCH";
+        readonly path: "/v1/product_review_comments";
+    }];
+    readonly operations: readonly [{
+        readonly kind: "api_patch";
+        readonly method: "PATCH";
+        readonly endpointKey: "product_review_comments_bulk_update";
+        readonly json_body: "{'comments': updates}";
+    }];
+    readonly sourceLocation: {
+        readonly line: 121;
+        readonly endLine: 153;
+    };
+}, {
+    readonly module: "tools/writes/review_writes.py";
+    readonly name: "delete_product_review";
+    readonly write: true;
+    readonly description: "[WRITE] 刪除單筆商品評論。\n\n【用途】\n從 Shopline 商店中永久刪除指定評論，適用於移除違規、惡意或測試用評論。\n\n【呼叫的 Shopline API】\n- DELETE /v1/product_review_comments/{comment_id}\n\n【回傳結構】\ndict 含 success: bool, resource_id: str, message: str。\n\n【副作用】\n- 永久刪除評論記錄，不可復原\n- 商品的評論總數與平均評分將同步更新";
+    readonly params: readonly [{
+        readonly name: "comment_id";
+        readonly description: "評論 ID";
+        readonly default: null;
+        readonly hasDefault: false;
+        readonly kind: "string";
+        readonly optional: false;
+    }];
+    readonly docEndpoints: readonly [{
+        readonly method: "DELETE";
+        readonly path: "/v1/product_review_comments/{comment_id}";
+    }];
+    readonly operations: readonly [{
+        readonly kind: "api_delete";
+        readonly method: "DELETE";
+        readonly endpointKey: "product_review_comment_delete";
+        readonly path_params: "{'comment_id': comment_id}";
+    }];
+    readonly sourceLocation: {
+        readonly line: 157;
+        readonly endLine: 181;
+    };
+}, {
+    readonly module: "tools/writes/review_writes.py";
+    readonly name: "bulk_delete_product_reviews";
+    readonly write: true;
+    readonly description: "[WRITE] 批次刪除多筆商品評論。\n\n【用途】\n一次性永久刪除多筆評論，適用於批次清除測試資料或大量違規評論。\n\n【呼叫的 Shopline API】\n- DELETE /v1/product_review_comments\n\n【回傳結構】\ndict 含 success: bool, resource_id: str, message: str, deleted_count: int。\n\n【副作用】\n- 永久刪除多筆評論記錄，不可復原\n- 相關商品的評論總數與平均評分將同步更新\n- 部分 id 若不存在，整批可能失敗或僅失敗該筆（視 API 實作而定）";
+    readonly params: readonly [{
+        readonly name: "comment_ids";
+        readonly description: "要刪除的評論 ID 列表，例如 [\"C001\", \"C002\", \"C003\"]";
+        readonly default: null;
+        readonly hasDefault: false;
+        readonly kind: "array";
+        readonly optional: false;
+    }];
+    readonly docEndpoints: readonly [{
+        readonly method: "DELETE";
+        readonly path: "/v1/product_review_comments";
+    }];
+    readonly operations: readonly [{
+        readonly kind: "api_delete";
+        readonly method: "DELETE";
+        readonly endpointKey: "product_review_comments_bulk_delete";
+        readonly params: "{'ids': comment_ids}";
+    }];
+    readonly sourceLocation: {
+        readonly line: 185;
+        readonly endLine: 214;
+    };
+}];