crewly 1.20.29 → 1.20.31

package/config/skills/agent/core/canva-create/SKILL.md

@@ -0,0 +1,53 @@
+---
+name: Canva Create
+description: Create a new Canva design in the owner's account — a preset (doc / whiteboard / presentation), a custom size (e.g. 1080x1920 for stories), or one built from an uploaded asset (via the Canva grant held by Crewly Cloud). Returns the edit link for a person to finish the design.
+version: 1.0.0
+category: productivity
+skillType: claude-skill
+assignableRoles:
+  - orchestrator
+  - team-leader
+  - developer
+  - operations
+  - ops
+  - sales
+  - support
+  - generalist
+triggers:
+  - create canva design
+  - new design in canva
+  - make a poster in canva
+  - start a canva deck
+tags:
+  - canva
+  - create
+execution:
+  type: script
+  script:
+    file: execute.sh
+    interpreter: bash
+    timeoutMs: 60000
+---
+
+# Canva Create
+
+```bash
+bash execute.sh --title "Open day poster" --size 1080x1350
+bash execute.sh --title "Reel cover" --asset AAB…      # after canva-upload
+```
+
+## Output
+
+```json
+{"success":true,"design":{"id":"DAF…","title":"Open day poster","editUrl":"https://www.canva.com/…"}}
+```
+
+The Connect API does not fill designs with text or generate video: create
+the design, upload the assets, then hand the `editUrl` to a person (or
+export an existing finished design with `canva-export`). Brand templates
+need Canva Enterprise and are not wired.
+
+## Failures
+
+`{"success":false,"reason":"not_connected","hint":"<connect URL>"}` (exit 1)
+when the owner has not connected Canva (Settings → Integrations).

package/config/skills/agent/core/canva-create/execute.sh

@@ -0,0 +1,88 @@
+#!/bin/bash
+# =============================================================================
+# canva-create — Create a new Canva design (preset type, custom size, or from an uploaded asset)
+#
+# Backed by POST /api/canva/designs.
+#
+# Usage:
+#   bash execute.sh --title "Open day poster" --size 1080x1350
+#   bash execute.sh --title "Term plan" --preset presentation      # doc | whiteboard | presentation
+#   bash execute.sh --title "Flyer" --asset <assetId>              # start from an uploaded image
+#   bash execute.sh '{"title":"Poster","width":1080,"height":1920}'
+# =============================================================================
+set -euo pipefail
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+source "${SCRIPT_DIR}/../../_common/lib.sh"
+
+print_usage() {
+  cat <<'EOF_USAGE'
+Usage:
+  bash execute.sh --title "Open day poster" --size 1080x1350
+  bash execute.sh --title "Term plan" --preset presentation      # doc | whiteboard | presentation
+  bash execute.sh --title "Flyer" --asset <assetId>              # start from an uploaded image
+  bash execute.sh '{"title":"Poster","width":1080,"height":1920}'
+
+Options:
+  --title       Design title (≤ 255 chars)
+  --preset      doc | whiteboard | presentation
+  --size        WIDTHxHEIGHT in px (40–8000), e.g. 1080x1920 for a vertical video/story
+  --asset       Asset id from canva-upload to place on the first page
+  --help | -h   Show this help
+EOF_USAGE
+}
+
+fail_from() {
+  printf '%s' "$1" | jq -c '{success: false, reason: (.details.error // .details // .error // "unknown"), hint: (.details.hint // ""), message: (.details.message // "")}' 2>/dev/null \
+    || jq -n --arg r "$1" '{success: false, reason: $r}'
+  exit 1
+}
+
+uri() { jq -rn --arg v "$1" '$v|@uri'; }
+
+# api_call may print a one-line warning to stderr (no CREWLY_SESSION_NAME);
+# the backend answer is always the last line. On failure print the mapped
+# failure JSON (fail_from) and return 1.
+call() {
+  local out
+  out=$(api_call "$@" 2>&1) || { fail_from "$(printf '%s
+' "$out" | tail -n 1)"; }
+  printf '%s
+' "$out" | tail -n 1
+}
+
+INPUT_JSON=""
+if [[ $# -gt 0 && ${1:0:1} == '{' ]]; then
+  INPUT_JSON="$1"
+  shift || true
+fi
+TITLE=""; PRESET=""; SIZE=""; WIDTH=""; HEIGHT=""; ASSET=""
+while [[ $# -gt 0 ]]; do
+  case "$1" in
+    --title)   [ $# -ge 2 ] || error_exit "--title requires a value";  TITLE="$2";  shift 2 ;;
+    --preset)  [ $# -ge 2 ] || error_exit "--preset requires a value"; PRESET="$2"; shift 2 ;;
+    --size)    [ $# -ge 2 ] || error_exit "--size requires a value";   SIZE="$2";   shift 2 ;;
+    --asset)   [ $# -ge 2 ] || error_exit "--asset requires a value";  ASSET="$2";  shift 2 ;;
+    --help|-h) print_usage; exit 0 ;;
+    *) error_exit "Unknown option: $1" ;;
+  esac
+done
+if [ -n "$INPUT_JSON" ]; then
+  INPUT=$(read_json_input "$INPUT_JSON")
+  [ -z "$TITLE" ]  && TITLE=$(printf '%s' "$INPUT" | jq -r '.title // empty')
+  [ -z "$PRESET" ] && PRESET=$(printf '%s' "$INPUT" | jq -r '.preset // empty')
+  [ -z "$WIDTH" ]  && WIDTH=$(printf '%s' "$INPUT" | jq -r '.width // empty')
+  [ -z "$HEIGHT" ] && HEIGHT=$(printf '%s' "$INPUT" | jq -r '.height // empty')
+  [ -z "$ASSET" ]  && ASSET=$(printf '%s' "$INPUT" | jq -r '.asset // .assetId // empty')
+fi
+if [ -n "$SIZE" ]; then
+  [[ "$SIZE" =~ ^([0-9]+)x([0-9]+)$ ]] || error_exit "--size must look like 1080x1920"
+  WIDTH="${BASH_REMATCH[1]}"; HEIGHT="${BASH_REMATCH[2]}"
+fi
+[ -n "$PRESET" ] || [ -n "$WIDTH" ] || [ -n "$ASSET" ] || error_exit "give --preset, --size or --asset"
+BODY=$(jq -cn --arg title "$TITLE" --arg preset "$PRESET" --arg w "$WIDTH" --arg h "$HEIGHT" --arg asset "$ASSET" \
+  '{} + (if $title != "" then {title: $title} else {} end)
+      + (if $preset != "" then {preset: $preset} else {} end)
+      + (if $w != "" then {width: ($w|tonumber), height: ($h|tonumber)} else {} end)
+      + (if $asset != "" then {assetId: $asset} else {} end)')
+RESPONSE=$(call POST "/canva/designs" "$BODY") || { printf '%s\n' "$RESPONSE"; exit 1; }
+printf '%s' "$RESPONSE" | jq -c '{success: (.success // false), design: .data}'

package/config/skills/agent/core/canva-create/execute.test.sh

@@ -0,0 +1,54 @@
+#!/bin/bash
+# Tests for canva-create — run with: bash execute.test.sh
+# Python HTTP stub as the backend; asserts the request the skill sends and
+# the JSON it prints. Exit 0 on pass.
+set -u
+HERE="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+EXEC="$HERE/execute.sh"
+PASS=0; FAIL=0
+check() {
+  local name="$1"; local got="$2"; local want="$3"
+  if [ "$got" = "$want" ]; then PASS=$((PASS+1)); else FAIL=$((FAIL+1)); echo "FAIL: $name"; echo "  want: $want"; echo "  got:  $got"; fi
+}
+
+PORT=18821
+STUB_LOG="$(mktemp)"; export STUB_LOG; export STUB_PORT="$PORT"
+python3 -u <<'PY' >/dev/null 2>&1 &
+from http.server import BaseHTTPRequestHandler, HTTPServer
+import json, os
+LOG = os.environ['STUB_LOG']; PORT = int(os.environ['STUB_PORT'])
+class H(BaseHTTPRequestHandler):
+    def _reply(self, method, data=None):
+        open(LOG, 'w').write(json.dumps({'method': method, 'path': self.path, 'body': data}))
+        if 'no-grant' in self.path or (data or {}).get('title') == 'no-grant':
+            self.send_response(409); self.send_header('Content-Type', 'application/json'); self.end_headers()
+            self.wfile.write(json.dumps({'success': False, 'error': 'not_connected', 'message': 'no grant', 'hint': 'https://cloud/start?token=j'}).encode()); return
+        self.send_response(200); self.send_header('Content-Type', 'application/json'); self.end_headers()
+        self.wfile.write(json.dumps({'success': True, 'data': {'id': 'D9', 'title': data.get('title'), 'editUrl': 'https://e'}}).encode())
+    def do_GET(self): self._reply('GET')
+    def do_POST(self):
+        n = int(self.headers.get('content-length', '0')); body = self.rfile.read(n).decode() if n else ''
+        self._reply('POST', json.loads(body or '{}'))
+    def log_message(self, *a, **k): pass
+HTTPServer(('127.0.0.1', PORT), H).serve_forever()
+PY
+STUB_PID=$!
+disown "$STUB_PID" 2>/dev/null || true
+trap 'kill "$STUB_PID" >/dev/null 2>&1; rm -f "$STUB_LOG"' EXIT
+for i in $(seq 1 30); do curl -s -o /dev/null -m 0.2 "http://127.0.0.1:${PORT}/" 2>/dev/null && break; sleep 0.1; done
+
+run() { CREWLY_API_URL="http://127.0.0.1:${PORT}" bash "$EXEC" "$@" 2>/dev/null; }
+run_err() { CREWLY_API_URL="http://127.0.0.1:${PORT}" bash "$EXEC" "$@" 2>&1 >/dev/null; }
+
+OUT=$(run --title "Poster" --size 1080x1350)
+check "size: output" "$OUT" '{"success":true,"design":{"id":"D9","title":"Poster","editUrl":"https://e"}}'
+check "size: body" "$(jq -c .body "$STUB_LOG")" '{"title":"Poster","width":1080,"height":1350}'
+run --title "Deck" --preset presentation >/dev/null
+check "preset: body" "$(jq -c .body "$STUB_LOG")" '{"title":"Deck","preset":"presentation"}'
+run '{"assetId":"A1"}' >/dev/null
+check "asset: body" "$(jq -c .body "$STUB_LOG")" '{"assetId":"A1"}'
+OUT=$(run_err --title "x" || true)
+check "nothing to create fails" "$(printf '%s' "$OUT" | grep -c 'give --preset')" "1"
+
+echo "canva-create: $PASS passed, $FAIL failed"
+[ "$FAIL" -eq 0 ]

package/config/skills/agent/core/canva-designs/SKILL.md

@@ -0,0 +1,51 @@
+---
+name: Canva Designs
+description: List or search the owner's Canva designs, or fetch one by id — returns edit/view links and thumbnails (via the Canva grant held by Crewly Cloud). Read-only.
+version: 1.0.0
+category: productivity
+skillType: claude-skill
+assignableRoles:
+  - orchestrator
+  - team-leader
+  - developer
+  - operations
+  - ops
+  - sales
+  - support
+  - generalist
+triggers:
+  - list canva designs
+  - find the canva design
+  - open in canva
+  - which canva design
+tags:
+  - canva
+  - designs
+execution:
+  type: script
+  script:
+    file: execute.sh
+    interpreter: bash
+    timeoutMs: 60000
+---
+
+# Canva Designs
+
+```bash
+bash execute.sh --query "open day poster" --owned
+bash execute.sh --id DAF…
+```
+
+## Output
+
+```json
+{"count":1,"designs":[{"id":"DAF…","title":"Open day poster","editUrl":"https://www.canva.com/…","viewUrl":"https://…","thumbnailUrl":"https://…","pageCount":1,"updatedAt":"…"}]}
+```
+
+`editUrl` / `viewUrl` are valid for 30 days, `thumbnailUrl` for 15 minutes —
+share the edit link with people, do not store the thumbnail.
+
+## Failures
+
+`{"success":false,"reason":"not_connected","hint":"<connect URL>"}` (exit 1)
+when the owner has not connected Canva (Settings → Integrations).

package/config/skills/agent/core/canva-designs/execute.sh

@@ -0,0 +1,96 @@
+#!/bin/bash
+# =============================================================================
+# canva-designs — List / search the owner's Canva designs, or fetch one (edit + view links)
+#
+# Backed by GET /api/canva/designs and GET /api/canva/designs/:id.
+#
+# Usage:
+#   bash execute.sh [--query "poster"] [--owned|--shared] [--sort modified_descending] [--limit 25]
+#   bash execute.sh --id <designId>
+#   bash execute.sh '{"query":"poster","limit":10}'
+# =============================================================================
+set -euo pipefail
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+source "${SCRIPT_DIR}/../../_common/lib.sh"
+
+print_usage() {
+  cat <<'EOF_USAGE'
+Usage:
+  bash execute.sh [--query "poster"] [--owned|--shared] [--sort modified_descending] [--limit 25]
+  bash execute.sh --id <designId>
+  bash execute.sh '{"query":"poster","limit":10}'
+
+Options:
+  --query, -q   Text to search design titles
+  --id          Fetch one design instead of listing
+  --owned       Only designs the owner created (default: any)
+  --shared      Only designs shared with the owner
+  --sort        relevance | modified_descending | modified_ascending | title_descending | title_ascending
+  --limit       Result cap (default 25, max 100)
+  --continuation  Token from a previous page
+  --help | -h   Show this help
+EOF_USAGE
+}
+
+fail_from() {
+  printf '%s' "$1" | jq -c '{success: false, reason: (.details.error // .details // .error // "unknown"), hint: (.details.hint // ""), message: (.details.message // "")}' 2>/dev/null \
+    || jq -n --arg r "$1" '{success: false, reason: $r}'
+  exit 1
+}
+
+uri() { jq -rn --arg v "$1" '$v|@uri'; }
+
+# api_call may print a one-line warning to stderr (no CREWLY_SESSION_NAME);
+# the backend answer is always the last line. On failure print the mapped
+# failure JSON (fail_from) and return 1.
+call() {
+  local out
+  out=$(api_call "$@" 2>&1) || { fail_from "$(printf '%s
+' "$out" | tail -n 1)"; }
+  printf '%s
+' "$out" | tail -n 1
+}
+
+INPUT_JSON=""
+if [[ $# -gt 0 && ${1:0:1} == '{' ]]; then
+  INPUT_JSON="$1"
+  shift || true
+fi
+QUERY=""; ID=""; OWNERSHIP=""; SORT=""; LIMIT=""; CONT=""
+while [[ $# -gt 0 ]]; do
+  case "$1" in
+    --query|-q)     [ $# -ge 2 ] || error_exit "--query requires a value"; QUERY="$2"; shift 2 ;;
+    --id)           [ $# -ge 2 ] || error_exit "--id requires a value";    ID="$2";    shift 2 ;;
+    --owned)        OWNERSHIP="owned"; shift ;;
+    --shared)       OWNERSHIP="shared"; shift ;;
+    --sort)         [ $# -ge 2 ] || error_exit "--sort requires a value";  SORT="$2";  shift 2 ;;
+    --limit|-n)     [ $# -ge 2 ] || error_exit "--limit requires a value"; LIMIT="$2"; shift 2 ;;
+    --continuation) [ $# -ge 2 ] || error_exit "--continuation requires a value"; CONT="$2"; shift 2 ;;
+    --help|-h)      print_usage; exit 0 ;;
+    *) error_exit "Unknown option: $1" ;;
+  esac
+done
+if [ -n "$INPUT_JSON" ]; then
+  INPUT=$(read_json_input "$INPUT_JSON")
+  [ -z "$QUERY" ]     && QUERY=$(printf '%s' "$INPUT" | jq -r '.query // .q // empty')
+  [ -z "$ID" ]        && ID=$(printf '%s' "$INPUT" | jq -r '.id // .designId // empty')
+  [ -z "$OWNERSHIP" ] && OWNERSHIP=$(printf '%s' "$INPUT" | jq -r '.ownership // empty')
+  [ -z "$SORT" ]      && SORT=$(printf '%s' "$INPUT" | jq -r '.sort // .sortBy // empty')
+  [ -z "$LIMIT" ]     && LIMIT=$(printf '%s' "$INPUT" | jq -r '.limit // empty')
+  [ -z "$CONT" ]      && CONT=$(printf '%s' "$INPUT" | jq -r '.continuation // empty')
+fi
+if [ -n "$ID" ]; then
+  RESPONSE=$(call GET "/canva/designs/$(uri "$ID")") || { printf '%s\n' "$RESPONSE"; exit 1; }
+  printf '%s' "$RESPONSE" | jq -c '.data'
+  exit 0
+fi
+QS=""
+[ -n "$QUERY" ]     && QS="${QS}&q=$(uri "$QUERY")"
+[ -n "$OWNERSHIP" ] && QS="${QS}&ownership=$(uri "$OWNERSHIP")"
+[ -n "$SORT" ]      && QS="${QS}&sort=$(uri "$SORT")"
+[ -n "$LIMIT" ]     && QS="${QS}&limit=$(uri "$LIMIT")"
+[ -n "$CONT" ]      && QS="${QS}&continuation=$(uri "$CONT")"
+QS="${QS#&}"
+RESPONSE=$(call GET "/canva/designs${QS:+?$QS}") || { printf '%s\n' "$RESPONSE"; exit 1; }
+if printf '%s' "$RESPONSE" | jq -e '.truncated == true' >/dev/null 2>&1; then printf '%s\n' "$RESPONSE"; exit 0; fi
+printf '%s' "$RESPONSE" | jq -c '{count: .data.count, designs: .data.designs} + (if .data.continuation then {continuation: .data.continuation} else {} end)'

package/config/skills/agent/core/canva-designs/execute.test.sh

@@ -0,0 +1,54 @@
+#!/bin/bash
+# Tests for canva-designs — run with: bash execute.test.sh
+# Python HTTP stub as the backend; asserts the request the skill sends and
+# the JSON it prints. Exit 0 on pass.
+set -u
+HERE="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+EXEC="$HERE/execute.sh"
+PASS=0; FAIL=0
+check() {
+  local name="$1"; local got="$2"; local want="$3"
+  if [ "$got" = "$want" ]; then PASS=$((PASS+1)); else FAIL=$((FAIL+1)); echo "FAIL: $name"; echo "  want: $want"; echo "  got:  $got"; fi
+}
+
+PORT=18820
+STUB_LOG="$(mktemp)"; export STUB_LOG; export STUB_PORT="$PORT"
+python3 -u <<'PY' >/dev/null 2>&1 &
+from http.server import BaseHTTPRequestHandler, HTTPServer
+import json, os
+LOG = os.environ['STUB_LOG']; PORT = int(os.environ['STUB_PORT'])
+class H(BaseHTTPRequestHandler):
+    def _reply(self, method, data=None):
+        open(LOG, 'w').write(json.dumps({'method': method, 'path': self.path, 'body': data}))
+        if 'no-grant' in self.path or (data or {}).get('title') == 'no-grant':
+            self.send_response(409); self.send_header('Content-Type', 'application/json'); self.end_headers()
+            self.wfile.write(json.dumps({'success': False, 'error': 'not_connected', 'message': 'no grant', 'hint': 'https://cloud/start?token=j'}).encode()); return
+        self.send_response(200); self.send_header('Content-Type', 'application/json'); self.end_headers()
+        self.wfile.write(json.dumps({'success': True, 'data': {'count': 1, 'designs': [{'id': 'D1', 'title': 'Poster', 'editUrl': 'https://e'}], 'id': 'D1', 'title': 'Poster', 'editUrl': 'https://e'}}).encode())
+    def do_GET(self): self._reply('GET')
+    def do_POST(self):
+        n = int(self.headers.get('content-length', '0')); body = self.rfile.read(n).decode() if n else ''
+        self._reply('POST', json.loads(body or '{}'))
+    def log_message(self, *a, **k): pass
+HTTPServer(('127.0.0.1', PORT), H).serve_forever()
+PY
+STUB_PID=$!
+disown "$STUB_PID" 2>/dev/null || true
+trap 'kill "$STUB_PID" >/dev/null 2>&1; rm -f "$STUB_LOG"' EXIT
+for i in $(seq 1 30); do curl -s -o /dev/null -m 0.2 "http://127.0.0.1:${PORT}/" 2>/dev/null && break; sleep 0.1; done
+
+run() { CREWLY_API_URL="http://127.0.0.1:${PORT}" bash "$EXEC" "$@" 2>/dev/null; }
+run_err() { CREWLY_API_URL="http://127.0.0.1:${PORT}" bash "$EXEC" "$@" 2>&1 >/dev/null; }
+
+OUT=$(run --query "open day" --owned --sort modified_descending --limit 5)
+check "list: output" "$OUT" '{"count":1,"designs":[{"id":"D1","title":"Poster","editUrl":"https://e"}]}'
+check "list: path" "$(jq -r .path "$STUB_LOG")" "/api/canva/designs?q=open%20day&ownership=owned&sort=modified_descending&limit=5"
+run --id D1 >/dev/null
+check "get: path" "$(jq -r .path "$STUB_LOG")" "/api/canva/designs/D1"
+run '{"shared":false}' >/dev/null
+check "json: bare list" "$(jq -r .path "$STUB_LOG")" "/api/canva/designs"
+OUT=$(run --query no-grant || true)
+check "not connected" "$(printf '%s' "$OUT" | jq -r .reason)" "not_connected"
+
+echo "canva-designs: $PASS passed, $FAIL failed"
+[ "$FAIL" -eq 0 ]

package/config/skills/agent/core/canva-export/SKILL.md

@@ -0,0 +1,52 @@
+---
+name: Canva Export
+description: Export a Canva design to PDF, PNG, JPG, PPTX, GIF or MP4 (via the Canva grant held by Crewly Cloud). Waits for Canva's export job and returns download URLs; with --out / --out-dir the files are downloaded. Use this to turn a finished Canva video/poster into a file you can post or send.
+version: 1.0.0
+category: productivity
+skillType: claude-skill
+assignableRoles:
+  - orchestrator
+  - team-leader
+  - developer
+  - operations
+  - ops
+  - sales
+  - support
+  - generalist
+triggers:
+  - export from canva
+  - download the canva design
+  - render the canva video
+  - canva to pdf
+tags:
+  - canva
+  - export
+execution:
+  type: script
+  script:
+    file: execute.sh
+    interpreter: bash
+    timeoutMs: 60000
+---
+
+# Canva Export
+
+```bash
+bash execute.sh --id DAF… --format mp4 --out /tmp/reel.mp4
+bash execute.sh --id DAF… --format png --out-dir /tmp/poster-pages
+```
+
+## Output
+
+```json
+{"success":true,"jobId":"…","urls":["https://export-download.canva.com/…"],"savedTo":["/tmp/reel.mp4"]}
+```
+
+Download URLs are short-lived — save the file right away. Exports of
+large videos can take a minute or two; the backend polls for up to 2 min
+and answers `504` if Canva is still rendering (retry later).
+
+## Failures
+
+`{"success":false,"reason":"not_connected","hint":"<connect URL>"}` (exit 1)
+when the owner has not connected Canva (Settings → Integrations).

package/config/skills/agent/core/canva-export/execute.sh

@@ -0,0 +1,111 @@
+#!/bin/bash
+# =============================================================================
+# canva-export — Export a Canva design to PDF / PNG / JPG / PPTX / GIF / MP4 and download it
+#
+# Backed by POST /api/canva/designs/:id/export (async job, polled by the backend).
+#
+# Usage:
+#   bash execute.sh --id <designId> --format pdf [--out /tmp/poster.pdf]
+#   bash execute.sh --id <designId> --format mp4 [--video-quality horizontal_1080p] --out /tmp/reel.mp4
+#   bash execute.sh --id <designId> --format png --pages 1,2 --out-dir /tmp/pages
+#   bash execute.sh '{"id":"<designId>","format":"jpg","quality":85}'
+# =============================================================================
+set -euo pipefail
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+source "${SCRIPT_DIR}/../../_common/lib.sh"
+
+print_usage() {
+  cat <<'EOF_USAGE'
+Usage:
+  bash execute.sh --id <designId> --format pdf [--out /tmp/poster.pdf]
+  bash execute.sh --id <designId> --format mp4 [--video-quality horizontal_1080p] --out /tmp/reel.mp4
+  bash execute.sh --id <designId> --format png --pages 1,2 --out-dir /tmp/pages
+  bash execute.sh '{"id":"<designId>","format":"jpg","quality":85}'
+
+Options:
+  --id            Design id (required)
+  --format        pdf | png | jpg | pptx | gif | mp4 (required)
+  --quality       JPG quality 1–100 (default 80)
+  --video-quality MP4 preset: horizontal_480p|720p|1080p|4k, vertical_… (default horizontal_1080p)
+  --pages         Comma-separated 1-based page numbers (default all)
+  --out           Download the (first) file to this path
+  --out-dir       Download every file into this directory (page-1.png, page-2.png, …)
+  --help | -h   Show this help
+EOF_USAGE
+}
+
+fail_from() {
+  printf '%s' "$1" | jq -c '{success: false, reason: (.details.error // .details // .error // "unknown"), hint: (.details.hint // ""), message: (.details.message // "")}' 2>/dev/null \
+    || jq -n --arg r "$1" '{success: false, reason: $r}'
+  exit 1
+}
+
+uri() { jq -rn --arg v "$1" '$v|@uri'; }
+
+# api_call may print a one-line warning to stderr (no CREWLY_SESSION_NAME);
+# the backend answer is always the last line. On failure print the mapped
+# failure JSON (fail_from) and return 1.
+call() {
+  local out
+  out=$(api_call "$@" 2>&1) || { fail_from "$(printf '%s
+' "$out" | tail -n 1)"; }
+  printf '%s
+' "$out" | tail -n 1
+}
+
+INPUT_JSON=""
+if [[ $# -gt 0 && ${1:0:1} == '{' ]]; then
+  INPUT_JSON="$1"
+  shift || true
+fi
+ID=""; FORMAT=""; QUALITY=""; VQ=""; PAGES=""; OUT_PATH=""; OUT_DIR=""
+while [[ $# -gt 0 ]]; do
+  case "$1" in
+    --id)            [ $# -ge 2 ] || error_exit "--id requires a value";            ID="$2";       shift 2 ;;
+    --format|-f)     [ $# -ge 2 ] || error_exit "--format requires a value";        FORMAT="$2";   shift 2 ;;
+    --quality)       [ $# -ge 2 ] || error_exit "--quality requires a value";       QUALITY="$2";  shift 2 ;;
+    --video-quality) [ $# -ge 2 ] || error_exit "--video-quality requires a value"; VQ="$2";       shift 2 ;;
+    --pages)         [ $# -ge 2 ] || error_exit "--pages requires a value";         PAGES="$2";    shift 2 ;;
+    --out|-o)        [ $# -ge 2 ] || error_exit "--out requires a value";           OUT_PATH="$2"; shift 2 ;;
+    --out-dir)       [ $# -ge 2 ] || error_exit "--out-dir requires a value";       OUT_DIR="$2";  shift 2 ;;
+    --help|-h)       print_usage; exit 0 ;;
+    *) error_exit "Unknown option: $1" ;;
+  esac
+done
+if [ -n "$INPUT_JSON" ]; then
+  INPUT=$(read_json_input "$INPUT_JSON")
+  [ -z "$ID" ]       && ID=$(printf '%s' "$INPUT" | jq -r '.id // .designId // empty')
+  [ -z "$FORMAT" ]   && FORMAT=$(printf '%s' "$INPUT" | jq -r '.format // empty')
+  [ -z "$QUALITY" ]  && QUALITY=$(printf '%s' "$INPUT" | jq -r '.quality // empty')
+  [ -z "$VQ" ]       && VQ=$(printf '%s' "$INPUT" | jq -r '.videoQuality // empty')
+  [ -z "$PAGES" ]    && PAGES=$(printf '%s' "$INPUT" | jq -r '(.pages // []) | map(tostring) | join(",")')
+  [ -z "$OUT_PATH" ] && OUT_PATH=$(printf '%s' "$INPUT" | jq -r '.out // empty')
+  [ -z "$OUT_DIR" ]  && OUT_DIR=$(printf '%s' "$INPUT" | jq -r '.outDir // empty')
+fi
+require_param "id (--id)" "$ID"
+require_param "format (--format)" "$FORMAT"
+BODY=$(jq -cn --arg format "$FORMAT" --arg q "$QUALITY" --arg vq "$VQ" --arg pages "$PAGES" \
+  '{format: $format}
+   + (if $q != "" then {quality: ($q|tonumber)} else {} end)
+   + (if $vq != "" then {videoQuality: $vq} else {} end)
+   + (if $pages != "" then {pages: ($pages | split(",") | map(tonumber))} else {} end)')
+RESPONSE=$(call POST "/canva/designs/$(uri "$ID")/export" "$BODY") || { printf '%s\n' "$RESPONSE"; exit 1; }
+STATUS=$(printf '%s' "$RESPONSE" | jq -r '.data.status // "failed"')
+if [ "$STATUS" != "success" ]; then
+  printf '%s' "$RESPONSE" | jq -c '{success: false, reason: "export_failed", status: .data.status, error: .data.error}'
+  exit 1
+fi
+SAVED="[]"
+if [ -n "$OUT_PATH" ] || [ -n "$OUT_DIR" ]; then
+  i=0
+  while IFS= read -r url; do
+    [ -n "$url" ] || continue
+    i=$((i+1))
+    if [ -n "$OUT_PATH" ] && [ "$i" -eq 1 ]; then dest="$OUT_PATH"
+    elif [ -n "$OUT_DIR" ]; then mkdir -p "$OUT_DIR"; dest="$OUT_DIR/page-$i.$FORMAT"
+    else continue; fi
+    curl -sfL -o "$dest" "$url" || error_exit "download failed: $url"
+    SAVED=$(printf '%s' "$SAVED" | jq -c --arg d "$dest" '. + [$d]')
+  done < <(printf '%s' "$RESPONSE" | jq -r '.data.urls[]')
+fi
+printf '%s' "$RESPONSE" | jq -c --argjson saved "$SAVED" '{success: true, jobId: .data.jobId, urls: .data.urls, savedTo: $saved}'

package/config/skills/agent/core/canva-export/execute.test.sh

@@ -0,0 +1,55 @@
+#!/bin/bash
+# Tests for canva-export — run with: bash execute.test.sh
+# Python HTTP stub as the backend; asserts the request the skill sends and
+# the JSON it prints. Exit 0 on pass.
+set -u
+HERE="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+EXEC="$HERE/execute.sh"
+PASS=0; FAIL=0
+check() {
+  local name="$1"; local got="$2"; local want="$3"
+  if [ "$got" = "$want" ]; then PASS=$((PASS+1)); else FAIL=$((FAIL+1)); echo "FAIL: $name"; echo "  want: $want"; echo "  got:  $got"; fi
+}
+
+PORT=18822
+STUB_LOG="$(mktemp)"; export STUB_LOG; export STUB_PORT="$PORT"
+python3 -u <<'PY' >/dev/null 2>&1 &
+from http.server import BaseHTTPRequestHandler, HTTPServer
+import json, os
+LOG = os.environ['STUB_LOG']; PORT = int(os.environ['STUB_PORT'])
+class H(BaseHTTPRequestHandler):
+    def _reply(self, method, data=None):
+        open(LOG, 'w').write(json.dumps({'method': method, 'path': self.path, 'body': data}))
+        if 'no-grant' in self.path or (data or {}).get('title') == 'no-grant':
+            self.send_response(409); self.send_header('Content-Type', 'application/json'); self.end_headers()
+            self.wfile.write(json.dumps({'success': False, 'error': 'not_connected', 'message': 'no grant', 'hint': 'https://cloud/start?token=j'}).encode()); return
+        self.send_response(200); self.send_header('Content-Type', 'application/json'); self.end_headers()
+        self.wfile.write(json.dumps({'success': True, 'data': {'jobId': 'J1', 'status': 'success', 'urls': ['http://127.0.0.1:%d/dl/1' % PORT]}}).encode())
+    def do_GET(self): self._reply('GET')
+    def do_POST(self):
+        n = int(self.headers.get('content-length', '0')); body = self.rfile.read(n).decode() if n else ''
+        self._reply('POST', json.loads(body or '{}'))
+    def log_message(self, *a, **k): pass
+HTTPServer(('127.0.0.1', PORT), H).serve_forever()
+PY
+STUB_PID=$!
+disown "$STUB_PID" 2>/dev/null || true
+trap 'kill "$STUB_PID" >/dev/null 2>&1; rm -f "$STUB_LOG"' EXIT
+for i in $(seq 1 30); do curl -s -o /dev/null -m 0.2 "http://127.0.0.1:${PORT}/" 2>/dev/null && break; sleep 0.1; done
+
+run() { CREWLY_API_URL="http://127.0.0.1:${PORT}" bash "$EXEC" "$@" 2>/dev/null; }
+run_err() { CREWLY_API_URL="http://127.0.0.1:${PORT}" bash "$EXEC" "$@" 2>&1 >/dev/null; }
+
+OUT=$(run --id D1 --format pdf --pages 1,2)
+check "pdf: output" "$OUT" "{\"success\":true,\"jobId\":\"J1\",\"urls\":[\"http://127.0.0.1:${PORT}/dl/1\"],\"savedTo\":[]}"
+check "pdf: path+body" "$(jq -r '.path + " " + (.body|tojson)' "$STUB_LOG")" '/api/canva/designs/D1/export {"format":"pdf","pages":[1,2]}'
+run '{"id":"D1","format":"jpg","quality":85}' >/dev/null
+check "jpg: body" "$(jq -c .body "$STUB_LOG")" '{"format":"jpg","quality":85}'
+TMP="$(mktemp).pdf"
+OUT=$(run --id D1 --format pdf --out "$TMP")
+check "download: saved" "$(printf '%s' "$OUT" | jq -r '.savedTo[0]')" "$TMP"
+check "download: bytes" "$(cat "$TMP")" '{"success": true, "data": {"jobId": "J1", "status": "success", "urls": ["http://127.0.0.1:'"$PORT"'/dl/1"]}}'
+rm -f "$TMP"
+
+echo "canva-export: $PASS passed, $FAIL failed"
+[ "$FAIL" -eq 0 ]