@acedatacloud/skills 2026.726.4 → 2026.726.6

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@acedatacloud/skills",
-  "version": "2026.726.4",
+  "version": "2026.726.6",
   "description": "Agent Skills for AceDataCloud AI services — music, image, video generation, LLM chat, web search. Compatible with Claude Code, GitHub Copilot, Gemini CLI, OpenAI Codex, and 30+ AI coding agents.",
   "keywords": [
     "agent-skills",

package/skills/google-ads/SKILL.md

@@ -5,8 +5,8 @@ when_to_use: |
   Trigger when the user wants Google Ads reporting — list accessible
   customers, campaign / ad-group / keyword performance, spend and
   conversions. Read via GAQL. Needs the OAuth token PLUS a platform
-  developer token and a login-customer-id; if those env vars are
-  absent the connector isn't fully provisioned yet — tell the user.
+  developer token; if the developer token is absent the connector
+  isn't fully provisioned yet — tell the user.
 connections: [google/ads]
 allowed_tools: [Bash]
 license: Apache-2.0
@@ -15,26 +15,31 @@ metadata:
   version: "1.0"
 ---
 
-Query the **Google Ads API** via `curl + jq`. Three credentials are needed:
+Query the **Google Ads API** via `curl + jq`. Two credentials plus one context
+header:
 
 - `$GOOGLE_ADS_TOKEN` — the user's OAuth bearer (`adwords` scope) →
   `Authorization: Bearer $GOOGLE_ADS_TOKEN`
 - `$GOOGLE_ADS_DEVELOPER_TOKEN` — the platform's developer token (injected
   server-side) → header `developer-token: $GOOGLE_ADS_DEVELOPER_TOKEN`
-- `login-customer-id` — the manager (MCC) id under which calls are made; use the
-  target customer id, or `$GOOGLE_ADS_LOGIN_CUSTOMER_ID` if set (digits only, no
-  dashes).
+- `login-customer-id` — **only for manager (MCC) scoped calls**: the manager id
+  the request runs under, or `$GOOGLE_ADS_LOGIN_CUSTOMER_ID` if set (digits
+  only, no dashes). Not needed by `customers:listAccessibleCustomers`.
 
 > **API version:** the base is `https://googleads.googleapis.com/<vNN>`. Google
-> ships a new `vNN` every ~4 months and retires old ones — set `VER` to the
-> **current** supported version (check developers.google.com/google-ads/api
-> release notes); the example uses `v18`.
+> ships a new `vNN` every ~4 months and retires old ones, so a hardcoded version
+> eventually stops working. The example uses `v25` (supported as of 2026-07). If
+> **every** call 404s, the version is unavailable — either retired or not yet
+> released. Probe `customers:listAccessibleCustomers`: a supported version
+> answers 401/200, an unavailable one 404. Step **down** one version at a time
+> from the example, and check Google's supported-versions table before assuming
+> a newer `vNN` exists.
 
 If `$GOOGLE_ADS_DEVELOPER_TOKEN` is empty, the connector isn't fully provisioned —
 say so rather than calling the API (it would 401/DEVELOPER_TOKEN_NOT_APPROVED).
 
 ```bash
-VER="v18"; BASE="https://googleads.googleapis.com/$VER"
+VER="v25"; BASE="https://googleads.googleapis.com/$VER"
 AUTH="Authorization: Bearer $GOOGLE_ADS_TOKEN"; DEV="developer-token: $GOOGLE_ADS_DEVELOPER_TOKEN"
 # Customers the OAuth user can access (ids are returned as customers/<id>)
 curl -sS -H "$AUTH" -H "$DEV" "$BASE/customers:listAccessibleCustomers" | jq '.resourceNames'
@@ -44,7 +49,10 @@ curl -sS -H "$AUTH" -H "$DEV" "$BASE/customers:listAccessibleCustomers" | jq '.r
 
 ```bash
 CID="1234567890"   # target customer id, digits only
-curl -sS -H "$AUTH" -H "$DEV" -H "login-customer-id: ${GOOGLE_ADS_LOGIN_CUSTOMER_ID:-$CID}" \
+# Manager (MCC) access → send login-customer-id; direct access → drop the header.
+# Array, not a plain string: the header value contains a space and would split.
+LOGIN=(); [ -n "$GOOGLE_ADS_LOGIN_CUSTOMER_ID" ] && LOGIN=(-H "login-customer-id: $GOOGLE_ADS_LOGIN_CUSTOMER_ID")
+curl -sS -H "$AUTH" -H "$DEV" "${LOGIN[@]}" \
   -H "Content-Type: application/json" -d '{
   "query":"SELECT campaign.name, metrics.cost_micros, metrics.clicks, metrics.conversions FROM campaign WHERE segments.date DURING LAST_30_DAYS ORDER BY metrics.cost_micros DESC"
 }' "$BASE/customers/$CID/googleAds:searchStream" \
@@ -56,8 +64,14 @@ GAQL resources: `campaign`, `ad_group`, `ad_group_criterion` (keywords),
 
 ## Gotchas
 
-- **Three headers, not one.** Missing `developer-token` or `login-customer-id`
-  is the #1 cause of 401/403 here.
+- **A 404 on *every* endpoint points at `VER`, not at credentials** — the
+  version is retired or unreleased. A 404 on a *single* call is about that call:
+  a missing resource (bad customer id) or a wrong path. Sanity-check the version
+  with `customers:listAccessibleCustomers` before debugging auth.
+- **Two credentials plus a context header.** `developer-token` is required on
+  every call; `login-customer-id` is only needed when acting under a manager
+  (MCC) account — `customers:listAccessibleCustomers` works without it. Omitting
+  it on a manager-scoped call is the #1 cause of 401/403 here.
 - Customer ids are **digits only** in URLs/headers (strip the dashes from
   `123-456-7890`).
 - `searchStream` returns an array of chunks each with `.results[]` — flatten with

package/skills/youtube/SKILL.md

@@ -110,8 +110,39 @@ curl -sS -H "Authorization: Bearer $GOOGLE_YOUTUBE_TOKEN" \
 file you're about to upload. Uploads are a two-step *resumable* flow:
 init with metadata → PUT the bytes.
 
+### If the source is a URL, fetch it first
+
+Videos produced by a generation API (Maestro, Seedance, Veo, …) come back as a
+CDN URL, not a local file. Download it and verify you actually got a video
+before starting the upload:
+
 ```bash
-FILE="/path/to/video.mp4"
+SRC="https://example.cdn.acedata.cloud/path/video.mp4"
+FILE=$(mktemp)   # plain mktemp — `mktemp /tmp/x-XXXXXX.mp4` is not portable
+
+# -f: fail on 4xx/5xx instead of saving the error page. -L: follow CDN redirects.
+curl -fsSL -o "$FILE" -w 'http=%{http_code} size=%{size_download}\n' "$SRC"
+
+# Two distinct failures, two distinct messages — a 404/DNS error is a bad URL,
+# not a bad video, and saying so saves the next step from misdiagnosing it.
+[ -s "$FILE" ] \
+  || { echo "download failed (see http= above) — nothing to upload"; rm -f "$FILE"; exit 1; }
+
+# A 200 can still be an HTML interstitial or an expired-link page. Reject that
+# rather than allow-listing one container, so WebM/MOV/AVI still pass. `grep -a`
+# is required — without it grep treats a binary header as "no match".
+head -c 512 "$FILE" | grep -qai '<html\|<!doctype' \
+  && { echo "got an HTML page, not a video"; rm -f "$FILE"; exit 1; }
+```
+
+`--upload-file` ignores the filename; YouTube keys off the
+`Content-Type: video/*` header, so the extensionless temp file is fine.
+
+### The upload itself
+
+```bash
+# Falls back to the placeholder only if the fetch step above didn't set FILE.
+FILE="${FILE:-/path/to/video.mp4}"
 TITLE="My title"
 DESC="My description"
 # privacyStatus: public | unlisted | private
@@ -129,12 +160,19 @@ UPLOAD_URL=$(curl -sS -D - -o /dev/null \
   -d "$META" | tr -d '\r' | awk '/^[Ll]ocation:/{print $2}')
 
 # 2. Upload the bytes -> returns the created video resource (has .id).
-curl -sS -H "Authorization: Bearer $GOOGLE_YOUTUBE_TOKEN" \
+RESULT=$(curl -sS -H "Authorization: Bearer $GOOGLE_YOUTUBE_TOKEN" \
   -H "Content-Type: video/*" \
-  -X PUT --upload-file "$FILE" "$UPLOAD_URL" \
-  | jq '{id: .id, url: ("https://www.youtube.com/watch?v=" + .id), privacy: .status.privacyStatus}'
+  -X PUT --upload-file "$FILE" "$UPLOAD_URL")
+echo "$RESULT" | jq -e .id >/dev/null 2>&1 \
+  || { echo "upload failed: $(echo "$RESULT" | jq -r '.error.message' 2>/dev/null || echo "$RESULT")"; exit 1; }
+echo "$RESULT" | jq '{id: .id, url: ("https://www.youtube.com/watch?v=" + .id), privacy: .status.privacyStatus}'
 ```
 
+Delete a downloaded temp file only **after** you've confirmed an id came back
+(`echo "$RESULT" | jq -e .id >/dev/null && rm -f "$FILE"`). On a 401/403 or a
+dropped connection the download is still good and re-uploading beats re-fetching
+a few hundred MB.
+
 `categoryId` `22` = "People & Blogs" (a safe default). To set a custom
 thumbnail (needs the file to be processed first), call
 `POST /upload/youtube/v3/thumbnails/set?videoId=VIDEO_ID` with the image.