@raishin/vanguard-frontier-agentic 1.8.0 → 2.0.0

package/skills/finops/fetch-foundation-model-pricing/references/token-economics.md

@@ -0,0 +1,94 @@
+# Token Economics
+
+## Pricing model overview
+
+Foundation model API pricing is charged on consumption of compute resources expressed as token counts or equivalent units. The billing dimensions are:
+
+| Dimension | Definition |
+|---|---|
+| Input tokens | Tokens in the prompt sent to the model, including system prompt, user turn, tool definitions, and injected context |
+| Output tokens | Tokens generated by the model in its response, including reasoning tokens where applicable |
+| Cached input tokens | Input tokens served from the provider's prompt cache rather than re-computed; priced at a discount to standard input |
+| Batch input tokens | Input tokens submitted through an asynchronous batch API; priced at a discount to real-time input |
+| Batch output tokens | Output tokens returned from an asynchronous batch job |
+| Image input | Image tiles or full images submitted as multimodal input; some providers charge per tile, others per image |
+| GPU-hour | Compute time consumed by a dedicated model endpoint (provisioned throughput), independent of token count |
+
+## $/M token calculation
+
+To express a per-token price as $/1M tokens:
+
+- If the provider publishes $/token: multiply by 1,000,000.
+- If the provider publishes per 1K tokens: multiply by 1,000.
+- If the provider publishes per 1M tokens: use as-is.
+
+Example: AWS Bedrock publishes Claude Haiku at $0.00025 per 1K input tokens.
+Normalized: $0.00025 × 1,000 = $0.25 per 1M input tokens.
+
+## Monthly cost estimate formula
+
+```
+monthly_cost = (monthly_input_tokens / 1_000_000 × input_price_per_M)
+             + (monthly_output_tokens / 1_000_000 × output_price_per_M)
+```
+
+Where cached or batch tokens replace standard tokens at the relevant discount rate:
+
+```
+effective_input_cost = (uncached_input_tokens / 1_000_000 × standard_input_price)
+                     + (cached_input_tokens / 1_000_000 × cached_input_price)
+```
+
+## How context caching changes the cost curve
+
+Context caching allows the provider to store the KV (key-value) state of a fixed prefix — typically a long system prompt or retrieval context — and reuse it across multiple requests without recomputing it from scratch.
+
+Effect on pricing:
+
+- The cached prefix is charged at the **cache write price** (typically equal to or slightly above the standard input price) on first ingestion.
+- Subsequent requests that hit the cache are charged at the **cached read price**, which is typically 80–90% cheaper than the standard input price.
+- Storage of cached context may also incur a time-based charge (e.g., Vertex AI charges per 1M cached tokens per hour of storage).
+
+Break-even analysis: context caching becomes cost-effective when the same prefix is reused across enough requests that the cumulative cache read savings exceed the cache write cost plus storage cost.
+
+Example: a 100K-token system prompt sent to 10 requests per hour.
+
+Without caching: 100K tokens × 10 req/hr × $3.00/1M = $3.00/hr input cost.
+With caching (write once at $3.75/1M, read at $0.30/1M + $0.48/1M/hr storage for 100K tokens):
+- Write: 100K × $3.75/1M = $0.375 (one-time per cache TTL)
+- Reads: 100K × 10 × $0.30/1M = $0.30/hr
+- Storage: 100K × $0.48/1M/hr = $0.048/hr
+- Total: $0.348/hr after initial write — 88% cheaper than uncached.
+
+The specific prices in this example are illustrative; always fetch live prices before computing.
+
+## Batch pricing trade-offs
+
+Batch APIs (Anthropic Batch API, OpenAI Batch API, AWS Bedrock Batch Inference) offer 50% discounts on input and output tokens in exchange for:
+
+- Asynchronous delivery (results returned within a fixed SLA window, typically 24 hours)
+- No real-time latency guarantee
+- Minimum batch size requirements on some providers
+
+Batch pricing is appropriate for: offline evaluation, document processing, embedding generation at scale, non-interactive summarization pipelines.
+
+Batch pricing is not appropriate for: real-time user-facing inference, streaming responses, interactive agents.
+
+## FOCUS column mapping
+
+When expressing foundation model costs as FOCUS v1.2 line items:
+
+| FOCUS column | Value |
+|---|---|
+| `ServiceCategory` | AI and Machine Learning |
+| `ServiceName` | Provider-specific (e.g., Amazon Bedrock, Azure OpenAI Service, Vertex AI) |
+| `ChargeCategory` | Usage |
+| `ChargeFrequency` | Usage-based |
+| `BilledCost` | Actual amount charged (post any negotiated discounts) |
+| `EffectiveCost` | BilledCost minus any credits or committed-use amortization |
+| `ListCost` | Published on-demand price before discounts |
+| `SkuId` | Model identifier (e.g., `anthropic.claude-sonnet-4-5-v1:0`) |
+| `SkuPriceId` | Price dimension (e.g., `input-token`, `output-token`, `cached-input-token`, `batch-input-token`) |
+| `ResourceId` | API endpoint or model deployment ARN/resource ID if available |
+| `UsageType` | Token dimension (e.g., `InputTokens`, `OutputTokens`) |
+| `UsageQuantity` | Number of tokens in the pricing unit (e.g., count of 1M-token increments) |

package/skills/finops/finops-cloud-price-advisor/SKILL.md

@@ -1,19 +1,20 @@
 ---
 name: finops-cloud-price-advisor
-description: Fetch live public prices and build cost estimates for AWS, Azure, and OCI using each cloud's public pricing API. Supports live-environment cost analysis (current resource inventory) and prototype cost planning (planned architecture spec). Currency defaults to USD; other currencies on request.
+description: Fetch live public prices and build cost estimates for AWS, Azure, OCI, Scaleway, Gandi, Alibaba Cloud, and Tencent Cloud using each provider's public pricing API or official documentation. Supports live-environment cost analysis and prototype cost planning. Currency defaults to USD; EUR and CNY supported natively.
 allowed-tools: Read Grep Glob WebFetch
 metadata:
   author: "github: Raishin"
-  version: "0.1.0"
-  updated: "2026-05-05"
+  version: "0.2.1"
+  updated: "2026-05-13"
   category: finops
+  lifecycle: experimental
 ---
 
 # FinOps Cloud Price Advisor
 
 ## Purpose
 
-Act as a live cloud pricing advisor. Fetch current on-demand prices from each cloud provider's public pricing API and produce cost estimates for real or planned workloads.
+Act as a live cloud pricing advisor. Fetch current on-demand prices from each cloud provider's public pricing API (or official documentation where no API is available) and produce cost estimates for real or planned workloads across seven cloud providers.
 
 Two modes:
 - **Live environment**: enumerate running resources, fetch current prices, return a line-item cost estimate.
@@ -23,33 +24,41 @@ Two modes:
 
 Use this skill when:
 
-- the user asks "how much does X cost on AWS / Azure / OCI"
+- the user asks "how much does X cost on AWS / Azure / OCI / Scaleway / Gandi / Alibaba / Tencent"
 - the user wants a monthly or annual cost estimate for a specific resource type or architecture
-- the user wants to compare equivalent resource costs across two or more clouds
+- the user wants to compare equivalent resource costs across two or more clouds (including EU and Asia-Pacific providers)
 - the user needs a pre-provisioning cost estimate before deploying a prototype
 - the user wants to understand the live spend baseline of an existing inventory
-- the user requests cost estimates in a specific currency (EUR, GBP, JPY, etc.)
+- the user requests cost estimates in a specific currency (USD, EUR, CNY, GBP, JPY, etc.)
+- the user asks about EU-based cloud pricing (Scaleway in France/Netherlands, Gandi)
+- the user asks about Asia-Pacific cloud pricing (Alibaba Cloud in mainland China or APAC, Tencent Cloud)
 
 ## Lean operating rules
 
-- **Fetch live prices first.** Use WebFetch to call public pricing APIs (no auth required for any cloud). Do not rely on memory for prices — cloud pricing changes; stale numbers mislead.
-- **Label every price with its source date.** State the timestamp of the API response, not just the price.
-- **Default currency is USD.** Switch to another currency only when the user explicitly requests it; load currency-handling reference for conversion approach.
+- **Fetch live prices first.** Use WebFetch to call public pricing APIs where available. Do not rely on memory for prices — cloud pricing changes; stale numbers mislead.
+- **Label every price with its source.** State the API timestamp or documentation date, not just the price. Use the provenance label appropriate to the source (see below).
+- **Provenance labels are mandatory.** Every numeric price must carry one label:
+  - `live-price` — fetched from a public API in this session (include URL + ISO 8601 timestamp)
+  - `documentation-based` — from official pricing documentation (include URL + last-verified date)
+  - `assumed` — from an analogous SKU or default ratio (state the assumption explicitly)
+  - `excluded` — intentionally omitted from the estimate (state why)
+- **Default currency is USD.** Switch to another currency only when explicitly requested. EUR and CNY are supported natively for Scaleway/Gandi and Alibaba/Tencent respectively. Load currency-handling reference for conversion approach.
 - **Distinguish modes.** Label each output as `live-environment estimate` or `prototype estimate`.
 - **On-demand pricing only unless told otherwise.** Do not apply reserved instance, savings plan, committed use discount, or spot/preemptible pricing unless the user asks.
-- **Do not hallucinate prices.** If the API call fails or returns no match, say so and explain the fallback (documentation-based estimate, clearly marked as approximate).
+- **Do not hallucinate prices.** If the API call fails or returns no match, use the documented fallback chain from provider-fallbacks reference. Label fallback estimates as `documentation-based`.
 - **Region matters.** Confirm the target region before fetching; pricing varies materially by region.
-- **No credentials required or accepted.** All three pricing APIs are public and unauthenticated. Never ask for cloud credentials, billing account IDs, or cost management export access to fetch list prices.
+- **No credentials required for most providers.** AWS, Azure, OCI, and Scaleway have public unauthenticated pricing APIs. Gandi requires a user-provided API key (never stored). Alibaba and Tencent use scrape-based fallback.
 - Load references only when needed.
 
 ## References
 
 Load these only when needed:
 
-- [Pricing APIs](references/pricing-apis.md) — public endpoint URLs, query parameters, and response field mapping for AWS, Azure, and OCI.
-- [Estimation workflow](references/estimation-workflow.md) — step-by-step workflow for live-environment and prototype estimates.
-- [Currency handling](references/currency-handling.md) — USD default behaviour and exchange-rate approach for other currencies.
-- [Official sources](references/official-sources.md) — authoritative pricing documentation links for each cloud.
+- [Pricing APIs](references/pricing-apis.md) — public endpoint URLs, query parameters, and response field mapping for all seven providers.
+- [Estimation workflow](references/estimation-workflow.md) — step-by-step workflow for live-environment and prototype estimates with multi-cloud comparison table.
+- [Currency handling](references/currency-handling.md) — USD default behaviour, EUR conversion, and CNY conversion with timestamp requirements.
+- [Official sources](references/official-sources.md) — authoritative pricing documentation links for each provider.
+- [Provider fallbacks](references/provider-fallbacks.md) — per-provider fallback decision trees (live API → scrape → cached docs) and Gandi user-provided key handling.
 
 ## Response minimum
 

package/skills/finops/finops-cloud-price-advisor/metadata.json

@@ -11,16 +11,22 @@
     "kiro",
     "other"
   ],
-  "summary": "Fetch live public prices and build cost estimates for AWS, Azure, and OCI using each cloud's public pricing API. Supports live-environment and prototype cost planning. Currency defaults to USD.",
+  "summary": "Fetch live public prices and build cost estimates across AWS, Azure, OCI, Scaleway, Gandi, Alibaba Cloud, and Tencent Cloud. Supports live-environment and prototype cost planning. Currency defaults to USD; EUR and CNY supported natively.",
   "source_type": "original",
   "official_docs": [
     "https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/price-changes.html",
     "https://learn.microsoft.com/en-us/rest/api/cost-management/retail-prices/azure-retail-prices",
-    "https://docs.oracle.com/en-us/iaas/Content/Billing/Concepts/costanalysisoverview.htm"
+    "https://docs.oracle.com/en-us/iaas/Content/Billing/Concepts/costanalysisoverview.htm",
+    "https://developer.scaleway.com/en/products/billing/api/",
+    "https://www.scaleway.com/en/pricing/",
+    "https://www.gandi.net/domain/pricing",
+    "https://www.alibabacloud.com/cloud-computing/pricing",
+    "https://cloud.tencent.com/product/cvm/pricing"
   ],
-  "security_notes": "All three public pricing APIs require no authentication. Never accept or request cloud credentials, billing account IDs, cost export access, or tenant-specific data to fetch list prices.",
-  "last_verified": "2026-04-30",
+  "security_notes": "AWS, Azure, OCI, and Scaleway pricing APIs are public and require no authentication. Gandi requires a user-provided API key (never stored by the agent; discarded after single use). Alibaba Cloud and Tencent Cloud pricing is fetched via scrape-based fallback from official pricing pages — no credentials required or accepted.",
+  "last_verified": "2026-05-13",
   "path": "skills/finops/finops-cloud-price-advisor",
   "author": "github: Raishin",
-  "version": "0.1.0"
+  "version": "0.2.1",
+  "lifecycle": "experimental"
 }

package/skills/finops/finops-cloud-price-advisor/references/currency-handling.md

@@ -63,6 +63,79 @@ Never present a converted price without disclosing the exchange rate and its dat
 
 ---
 
+## CNY (Chinese Yuan Renminbi)
+
+### When CNY applies
+
+Alibaba Cloud and Tencent Cloud price their mainland China regions in CNY:
+
+| Provider | CNY regions |
+|----------|------------|
+| Alibaba Cloud | `cn-beijing`, `cn-shanghai`, `cn-zhangjiakou`, `cn-hangzhou`, `cn-shenzhen` |
+| Tencent Cloud | `ap-beijing`, `ap-shanghai`, `ap-guangzhou`, `ap-chengdu`, `ap-nanjing` |
+
+International regions for both providers (e.g., `ap-southeast-1`, `ap-singapore`) are priced
+in USD and do not require CNY conversion.
+
+### CNY→USD conversion
+
+Use the following formula:
+
+```
+usd_value = cny_value / exchange_rate
+```
+
+Where `exchange_rate` is the CNY-per-USD rate (e.g., 7.24 means ¥7.24 = $1.00).
+
+### Live conversion rate sources
+
+| Source | URL | Auth | Priority |
+|--------|-----|------|---------|
+| ExchangeRate-API CNY endpoint (preferred) | `https://v6.exchangerate-api.com/v6/latest/CNY` | None | Primary |
+| ECB daily feed | `https://www.ecb.europa.eu/stats/eurofxref/eurofxref-daily.xml` | None | Secondary (EUR base; derive CNY via USD cross-rate) |
+| PBoC published daily rate (cached fallback) | `https://www.pbc.gov.cn/` | None | Tertiary — use only when primary and secondary are unavailable |
+
+> Do not use sources that require API keys. The agent must not accept or store API keys.
+
+### Mandatory timestamp requirement
+
+Every CNY→USD conversion output must include all three of the following fields:
+
+| Field | Type | Description |
+|-------|------|-------------|
+| `conversion_rate` | float | The CNY-per-USD rate applied (e.g., `7.24`) |
+| `source_url` | string | The URL of the rate service that was used |
+| `timestamp` | ISO 8601 | When the rate was fetched (e.g., `2026-05-13T08:00:00Z`) |
+
+If the rate is from a cached or stale source (more than 24 hours old), label it explicitly:
+`assumed: 24h stale` and include the staleness note alongside the converted amount.
+
+### Example output label
+
+```
+Monthly cost: ¥130 CNY → $17.94 USD
+[documentation-based + live-rate: 7.25 CNY/USD @ 2026-05-13T08:00:00Z via https://v6.exchangerate-api.com/v6/latest/CNY]
+```
+
+If using a stale cached rate (tertiary fallback):
+
+```
+Monthly cost: ¥130 CNY → $17.94 USD
+[documentation-based + assumed: 24h stale rate 7.25 CNY/USD — verify at https://www.pbc.gov.cn/]
+```
+
+### Labelling CNY amounts
+
+Always show both the CNY source price and the converted USD amount:
+
+```
+Monthly cost: ¥600 CNY → $82.76 USD (PBoC/ExchangeRate-API rate 2026-05-13: 1 USD = 7.25 CNY)
+```
+
+Never present a converted CNY price without disclosing the exchange rate and its fetch timestamp.
+
+---
+
 ## Azure Retail Prices API — Native Currency Support
 
 The Azure Retail Prices API accepts a `currencyCode` query parameter and returns prices in that currency natively:

package/skills/finops/finops-cloud-price-advisor/references/estimation-workflow.md

@@ -119,20 +119,119 @@ Highest uncertainty: data egress volume — assumed 100 GB/month; at 1 TB/month
 
 ## Multi-Cloud Comparison
 
-When comparing AWS vs Azure vs OCI for the same workload:
+When comparing AWS vs Azure vs OCI vs Scaleway (or any subset) for the same workload:
 
 1. Map resource types to equivalents across clouds:
 
-| Workload | AWS | Azure | OCI |
-|---------|-----|-------|-----|
-| 4 vCPU / 16 GB VM | m5.xlarge | Standard_D4s_v3 | VM.Standard.E4.Flex (4 OCPU, 16 GB) |
-| Managed PostgreSQL | RDS PostgreSQL db.t4g.medium | Azure Database for PostgreSQL Flexible | OCI MySQL Database / ADB-S |
-| Object storage | S3 Standard | Azure Blob Storage LRS | OCI Object Storage |
-| Container cluster | EKS | AKS | OKE |
+| Workload | AWS | Azure | OCI | Scaleway | Gandi | Alibaba Cloud | Tencent Cloud |
+|---------|-----|-------|-----|---------|-------|---------------|---------------|
+| 4 vCPU / 16 GB VM | m5.xlarge | Standard_D4s_v3 | VM.Standard.E4.Flex (4 OCPU, 16 GB) | GP1-M (4 vCPU, 16 GB) | VPS Business (4 vCPU, 16 GB) | ecs.g7.xlarge (4 vCPU, 16 GiB) | Standard S5.LARGE16 (4 vCPU, 16 GiB) |
+| Managed PostgreSQL | RDS PostgreSQL db.t4g.medium | Azure Database for PostgreSQL Flexible | OCI MySQL Database / ADB-S | Scaleway RDB PostgreSQL | Not available (use external managed DB) | RDS for PostgreSQL (Basic / High-Availability) | TencentDB for PostgreSQL |
+| Object storage | S3 Standard | Azure Blob Storage LRS | OCI Object Storage | Scaleway OSS | Gandi Object Storage | OSS Standard | COS Standard |
+| Container cluster | EKS | AKS | OKE | Scaleway Kapsule | Not available (use self-managed) | ACK (Alibaba Container Service for Kubernetes) | TKE (Tencent Kubernetes Engine) |
 
 2. Fetch prices for each cloud in the user's preferred region(s).
 3. Present side-by-side comparison table, USD, monthly.
 4. Note: OCI often prices differently for Flex shapes (OCPU + memory separately); adjust comparison accordingly.
+5. Note: Scaleway pricing is EUR-native; apply a live EUR/USD exchange rate (see
+   [./official-sources.md](./official-sources.md) — Exchange Rate Sources) and display the
+   EUR price alongside the converted USD amount. Label the conversion date and rate used.
+6. Note: Gandi pricing is available in both EUR and USD via the API. If the user has not
+   provided an API key, use the official pricing page and label the estimate as
+   `documentation-based`. See [./provider-fallbacks.md](./provider-fallbacks.md) for the
+   decision tree.
+7. Note: Alibaba Cloud pricing is scrape-based (no public unauthenticated API). All prices
+   must be labeled `documentation-based`. For mainland (`cn-*`) regions, prices are in CNY;
+   apply a CNY-to-USD conversion with a live rate and timestamp (see
+   [./currency-handling.md](./currency-handling.md) — CNY section). International regions
+   are priced in USD. See [./provider-fallbacks.md](./provider-fallbacks.md) for the full
+   scrape fallback chain.
+8. Note: Tencent Cloud pricing is scrape-based (no public unauthenticated API). JavaScript
+   rendering may be required on the primary pricing page. All prices must be labeled
+   `documentation-based`. For mainland (`ap-beijing`, `ap-shanghai`, `ap-guangzhou`) regions,
+   prices are in CNY; apply a CNY-to-USD conversion with a live rate and timestamp (see
+   [./currency-handling.md](./currency-handling.md) — CNY section). International regions
+   are priced in USD. See [./provider-fallbacks.md](./provider-fallbacks.md) for the full
+   scrape fallback chain.
+
+### Scaleway reference instance for comparison
+
+| Field | Value | Provenance |
+|-------|-------|-----------|
+| Provider | Scaleway | — |
+| Instance type | PRO2-XS | Smallest production-grade Scaleway instance |
+| vCPU | 2 | — |
+| RAM | 8 GiB | — |
+| Root storage | 20 GiB SSD (local) | Included in instance price |
+| Region | fr-par (Paris, France) | eu-fr |
+| Monthly estimate | ~€10–14/month | `documentation-based` (official pricing page) |
+| API reference | `instances_b_ssd_x86_64_pro2_xs` | beta billing API SKU name |
+| USD note | Convert using live EUR/USD rate | See official-sources.md |
+
+> **Provenance label**: `documentation-based` — price derived from the official Scaleway
+> pricing page (https://www.scaleway.com/en/pricing/). The beta billing API requires auth;
+> if a live fetch succeeds, upgrade the label to `live-price` and include the timestamp.
+
+### Gandi reference instance for comparison
+
+| Field | Value | Provenance |
+|-------|-------|-----------|
+| Provider | Gandi | — |
+| Instance type | VPS Start 2 | Smallest standard Gandi VPS tier |
+| vCPU | 1 | — |
+| RAM | 2 GiB | — |
+| Storage | 20 GiB SSD | Included in instance price |
+| Region | eu (EU default) | — |
+| Monthly estimate | ~€2.99/month | `documentation-based` (official pricing page) |
+| USD note | EUR price shown; convert using live EUR/USD rate | See official-sources.md |
+
+> **Provenance label**: `documentation-based` — price derived from the official Gandi
+> pricing page (https://www.gandi.net/domain/pricing). If the user supplies an API key
+> in the request, call `https://api.gandi.net/v5/price-list` with
+> `Authorization: Apikey <key>` and upgrade the label to `live-price`. See
+> [./provider-fallbacks.md](./provider-fallbacks.md) for the full decision tree.
+
+### Alibaba Cloud ECS reference instance for comparison
+
+| Field | Value | Provenance |
+|-------|-------|-----------|
+| Provider | Alibaba Cloud | — |
+| Instance type | ecs.t6-c1m1.small | Entry-level burstable instance |
+| vCPU | 1 | — |
+| RAM | 1 GiB | — |
+| Storage | 20 GiB cloud disk | Not included; billed separately |
+| Region | cn-shanghai (Shanghai, Mainland China) | CNY region |
+| Monthly estimate (CNY) | ~¥130 CNY/month | `documentation-based` |
+| Monthly estimate (USD) | ~$18 USD/month | `documentation-based` + live-rate conversion required |
+| Currency note | CNY price shown; convert using live CNY/USD rate with timestamp | See currency-handling.md — CNY section |
+
+> **Provenance label**: `documentation-based` — price derived from the official Alibaba Cloud
+> pricing page (https://www.alibabacloud.com/cloud-computing/pricing). No live API is
+> available without authentication. CNY-to-USD conversion must use a live rate with timestamp;
+> see [./currency-handling.md](./currency-handling.md) — CNY section. Scrape-based; price may
+> be stale if the page structure has changed. See
+> [./provider-fallbacks.md](./provider-fallbacks.md) for the full fallback chain.
+
+### Tencent Cloud CVM reference instance for comparison
+
+| Field | Value | Provenance |
+|-------|-------|-----------|
+| Provider | Tencent Cloud | — |
+| Instance type | Standard S5.LARGE8 | Standard compute instance |
+| vCPU | 2 | — |
+| RAM | 8 GiB | — |
+| Storage | 50 GiB cloud disk | Not included; billed separately |
+| Region | ap-beijing (Beijing, Mainland China) | CNY region |
+| Monthly estimate (CNY) | ~¥600 CNY/month | `documentation-based` |
+| Monthly estimate (USD) | ~$83 USD/month | `documentation-based` + live-rate conversion required |
+| Currency note | CNY price shown; convert using live CNY/USD rate with timestamp | See currency-handling.md — CNY section |
+
+> **Provenance label**: `documentation-based` — price derived from the official Tencent Cloud
+> CVM pricing page (https://cloud.tencent.com/product/cvm/pricing). No live API is available
+> without authentication. JavaScript rendering may be required to resolve dynamically loaded
+> price tables. CNY-to-USD conversion must use a live rate with timestamp; see
+> [./currency-handling.md](./currency-handling.md) — CNY section. See
+> [./provider-fallbacks.md](./provider-fallbacks.md) for the full fallback chain.
 
 ---
 

package/skills/finops/finops-cloud-price-advisor/references/official-sources.md

@@ -48,12 +48,83 @@ Authoritative pricing documentation for each cloud provider. Use these as ground
 | OCI Cloud Estimator (calculator) | `https://cloudestimator.oracle.com` |
 | OCI Cost and Usage API | `https://docs.oracle.com/en-us/iaas/Content/Billing/Tasks/costanalysis_topic-create_report.htm` |
 
+## Scaleway
+
+| Resource | URL | Status | Currency |
+|----------|-----|--------|---------|
+| Official pricing page | `https://www.scaleway.com/en/pricing/` | Production, public, no auth | EUR |
+| Billing API reference | `https://developer.scaleway.com/en/products/billing/api/` | Beta (auth required) | EUR |
+| Developer documentation | `https://www.scaleway.com/en/developers/api/` | Production | N/A |
+| Changelog | `https://www.scaleway.com/en/changelog/` | Production | N/A |
+| API key management | `https://console.scaleway.com/iam/api-keys` | Production | N/A |
+| Scaleway Pricing Calculator | `https://www.scaleway.com/en/cost-calculator/` | Production | EUR |
+
+> Scaleway pricing is EUR-native. No USD pricing is available via the API. Use a live
+> exchange rate source (see Exchange Rate Sources below) to convert to USD or other
+> currencies. The `billing/v2beta1` API endpoint requires a Scaleway IAM token; the
+> official pricing page is the reliable unauthenticated fallback. Verify beta API status
+> at https://www.scaleway.com/en/changelog/ before any integration.
+
+## Gandi
+
+| Resource | URL | Status | Currency | Key management |
+|----------|-----|--------|---------|----------------|
+| Official pricing page | `https://www.gandi.net/domain/pricing` | Production, public, no auth | EUR, USD | N/A — public page |
+| Price List API | `https://api.gandi.net/v5/price-list` | Production, auth required | EUR, USD | User-provided API key (never stored by agent) |
+| API documentation | `https://api.gandi.net/docs/` | Production | N/A | N/A |
+| LiveDNS documentation | `https://doc.livedns.gandi.net/` | Production | N/A | N/A |
+| API key management | `https://account.gandi.net/en/users/api-keys` | Production | N/A | User manages their own keys |
+
+> Gandi pricing is available in both EUR and USD via the API response. The Price List API
+> requires a user-provided API key (`Authorization: Apikey <key>`). The agent never prompts
+> for, stores, or logs API keys. If no key is supplied in the request, fall back to the
+> official pricing page and label the estimate as `documentation-based`.
+> See [./provider-fallbacks.md](./provider-fallbacks.md) for the full decision tree.
+
+## Alibaba Cloud
+
+| Resource | URL | Status | Currency |
+|----------|-----|--------|---------|
+| Official pricing page | `https://www.alibabacloud.com/cloud-computing/pricing` | Production, scrape-based (HTML parser required) | CNY (mainland), USD (International endpoint) |
+| Cost calculator | `https://www.alibabacloud.com/price-calculator` | Production, scrape-based (HTML parser required) | CNY (mainland), USD (International endpoint) |
+| ECS product page | `https://www.alibabacloud.com/product/ecs` | Production | N/A |
+| RDS product page | `https://www.alibabacloud.com/product/apsaradb-for-rds` | Production | N/A |
+| OSS product page | `https://www.alibabacloud.com/product/oss` | Production | N/A |
+
+> Alibaba Cloud has no public unauthenticated pricing API. Pricing is obtained by scraping
+> the official pricing page via WebFetch. An HTML parser is required; the page does not
+> expose a JSON feed. All prices must be labeled `documentation-based`. For mainland
+> (`cn-*`) regions, prices are in CNY; apply a CNY-to-USD conversion with a live rate and
+> timestamp (see CNY section below). International (`ap-*`, `us-*`, `eu-*`) regions are
+> priced in USD. See [./provider-fallbacks.md](./provider-fallbacks.md) for the full
+> scrape fallback chain.
+
+## Tencent Cloud
+
+| Resource | URL | Status | Currency |
+|----------|-----|--------|---------|
+| CVM pricing page | `https://cloud.tencent.com/product/cvm/pricing` | Production, scrape-based (JavaScript rendering may be required) | CNY (mainland), USD (International endpoint) |
+| Cost calculator | `https://cloud.tencent.com/price` | Production, scrape-based (JavaScript rendering may be required) | CNY (mainland), USD (International endpoint) |
+| TencentDB product page | `https://cloud.tencent.com/product/cdb` | Production | N/A |
+| COS product page | `https://cloud.tencent.com/product/cos` | Production | N/A |
+| CLB product page | `https://cloud.tencent.com/product/clb` | Production | N/A |
+
+> Tencent Cloud has no public unauthenticated pricing API. Pricing is obtained by scraping
+> the official CVM pricing page via WebFetch. JavaScript rendering may be required to
+> resolve dynamically loaded price tables. All prices must be labeled `documentation-based`.
+> For mainland (`ap-beijing`, `ap-shanghai`, `ap-guangzhou`, and other mainland) regions,
+> prices are in CNY; apply a CNY-to-USD conversion with a live rate and timestamp (see CNY
+> section below). International regions are priced in USD. See
+> [./provider-fallbacks.md](./provider-fallbacks.md) for the full scrape fallback chain.
+
 ## Exchange Rate Sources
 
 | Source | URL | Auth | Notes |
 |--------|-----|------|-------|
 | ExchangeRate-API (preferred) | `https://open.er-api.com/v6/latest/USD` | None | Major currencies; updated daily |
 | ECB daily reference rates (fallback) | `https://www.ecb.europa.eu/stats/eurofxref/eurofxref-daily.xml` | None | EUR-denominated; reliable but limited currency set |
+| ExchangeRate-API CNY endpoint | `https://v6.exchangerate-api.com/v6/latest/CNY` | None | CNY-denominated; use for CNY→USD conversion; updated daily |
+| PBoC daily rate (CNY cached fallback) | `https://www.pbc.gov.cn/` | None | People's Bank of China published daily rate; use when ExchangeRate-API is unavailable |
 
 Do not use sources that require API keys (e.g., openexchangerates.org). The agent must not accept or store API keys.