@cloudglue/tinycloud 0.3.11 → 0.3.13

package/README.md

@@ -17,11 +17,11 @@ The npm package is a small launcher: on first run it downloads the matching
 platform distribution from Cloudglue's CDN (cached under
 `~/.tinycloud/versions/<version>/`), verifies its checksum, and execs the real
 binary. The package version pins the binary version, so
-`npx @cloudglue/tinycloud@0.3.11` always runs tinycloud 0.3.11. It also adds two
+`npx @cloudglue/tinycloud@0.3.13` always runs tinycloud 0.3.13. It also adds two
 wrapper commands:
 
 ```bash
-tinycloud install --version 0.3.11   # pre-download a version
+tinycloud install --version 0.3.13   # pre-download a version
 tinycloud install --latest          # install latest stable and pin to it
 tinycloud update                    # move to latest stable, prune old versions
 ```

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cloudglue/tinycloud",
-  "version": "0.3.11",
+  "version": "0.3.13",
   "description": "Agent CLI for deep video and image work, by Cloudglue. Downloads the tinycloud binary on first run.",
   "bin": {
     "tinycloud": "bin/tinycloud.js"

package/skills/tinycloud/SKILL.md

@@ -206,9 +206,11 @@ Authoring your own recipes: [reference/workflow-authoring.md](reference/workflow
   `data.embed_snippet` (`<cg-video>`), which only plays on a private site of
   the same account. When writing HTML around an embed, use the component's
   built-ins (`autoplay`+`muted`, `loop`, `start-time`, `exclusive`,
+  `playbackrates` — speed-menu rates, default `1 1.5 2`, shown at every
+  player size; embed v7 —
   `clip-start`/`clip-end` to frame one "back to moment" clip — plus
   `clip-only`, 0.3.8+, to play nothing but that window; JS
-  `playSegment(start, end?)`) and the container components
+  `playSegment(start, end?)`, `playbackRate` get/set) and the container components
   (`<cg-playlist>`, `<cg-grid>`, `<cg-chapters>`) rather than hand-rolled
   players, galleries, or segment-list JS — details in
   [reference/verbs.md](reference/verbs.md).

package/skills/tinycloud/reference/glossary.md

@@ -71,7 +71,8 @@ connector?" or an envelope field needs explaining.
   (`status`, `data`, `ref`, `meta`, `error`, …). The machine contract; see
   reference/envelope.md.
 - **Watch context / describe** — the reusable analysis `tinycloud watch`
-  produces (summary, segments, transcript-ish context). Cached locally and
+  produces (summary, segments with their spoken utterances inlined as
+  `speech[]`, transcript-ish context). Cached locally and
   mirrored in Cloudglue, so later `extract`/`ask`/`search` reuse it instead
   of re-analyzing.
 - **See / image describe (0.3.7+)** — the image counterpart of `watch`:
@@ -121,9 +122,11 @@ connector?" or an envelope field needs explaining.
   embed via the `data.embed_snippet` `<cg-video>` tag, which only plays on a
   private published site of the same account. The embed has playback
   attributes (`autoplay`+`muted`, `loop`, `start-time`, `poster`,
-  `accent-color`, `exclusive`, and `clip-start`/`clip-end` to frame a single
+  `accent-color`, `exclusive`, `playbackrates` — space-separated
+  playback-speed-menu rates, default `1 1.5 2`, shown at every player size
+  (sites embed v7) — and `clip-start`/`clip-end` to frame a single
   "back to moment" clip — `clip-only`, 0.3.8+, plays nothing but that
-  window) and a JS API (`playSegment`, `seekTo`, media
+  window) and a JS API (`playSegment`, `seekTo`, `playbackRate` get/set, media
   events re-dispatched on the element) for custom site HTML, and plays
   standalone or inside the container components (`<cg-playlist>`,
   `<cg-grid>`, `<cg-chapters>`) — see reference/verbs.md.

package/skills/tinycloud/reference/verbs.md

@@ -54,7 +54,7 @@ Flags shared by most verbs are listed once at the bottom.
 tinycloud watch <source> [--segment uniform:20|chapters|shots|segments]
   [--shot-min-seconds <s>] [--shot-max-seconds <s>]
   [--profile default|light|custom] [--speech-only | --visual-only]
-  [--start <t>] [--end <t>] [--transcript] [--content] [--json-index]
+  [--start <t>] [--end <t>] [--transcript] [--content]
   [--background]
 ```
 
@@ -65,6 +65,20 @@ bounds are part of the cache key, so tuned and default shot passes never
 collide. `watch` is **video/audio only** — point it at an image and it errors
 ("watch analyzes video/audio; for an image use `tinycloud see`").
 
+Segments carry the spoken words (0.3.12+): each segment (and embedded shot)
+inlines its overlapping utterances as `speech: string[]`. A source with
+speech but no visual segmentation — an audio file, `--speech-only`, a very
+short or windowed source — gets uniform 20s speech segments synthesized
+(`"segmentation": "uniform:20"`) instead of an empty `segments` list. Caches
+written by older versions heal automatically on the next watch or search.
+
+`--transcript` adds the full transcript as `data.transcript` (speaker-labeled
+when more than one speaker); `--content` inlines the complete describe
+markdown as `data.content`. Both are derived per invocation — they don't
+change the cache key and are served on cache hits, so asking for them never
+re-runs an analysis. `--json-index` was removed in 0.3.12 (it had long been a
+no-op; passing it now errors as an unknown flag).
+
 ### see — analyze an image (cloud, 0.3.7+)
 
 ```bash
@@ -122,6 +136,9 @@ tinycloud search "<keyword>" [--in <paths|source-ids|collection-ids|all>]
 
 Searches cached context locally, including cached `see` image results (0.3.7+),
 so a describe you've already run is greppable without another cloud call.
+`--field speech` matches the utterances inlined on cached watch segments —
+including speech-only/audio watches (0.3.12+; older cache entries heal in
+place during the scan, nothing is re-billed).
 
 ### probe — semantic search (cloud)
 
@@ -373,13 +390,25 @@ When generating custom site HTML around a `<cg-video>` embed, use the
 component's built-ins instead of reinventing them. It defaults to a
 responsive 16:9 dark placeholder (override with plain page CSS on the
 `cg-video` selector); mount-time attributes: `autoplay` (pair with `muted` or
-browsers block it), `loop`, `start-time`, `poster`, `accent-color`, and
+browsers block it), `loop`, `start-time`, `poster`, `accent-color`,
+`playbackrates` (speed menu — next paragraph), and
 `exclusive` (put it on every player in a gallery so starting one pauses the
 rest). Its JS API queues until ready — `playSegment(start, end?)`,
-`seekTo()`, `play()`/`pause()` — and media events are re-dispatched on the
+`seekTo()`, `play()`/`pause()`, `playbackRate` (get/set) — and media events
+are re-dispatched on the
 element (`timeupdate`, `ended`, `cg-ready`); prefer `playSegment` over
 hand-rolled seek logic for "click a moment to play that segment" pages.
 
+Playback speed (sites embed v7): every `<cg-video>` shows a playback-speed
+menu at every player size — including narrow grid cells and phones — with
+default rates `1 1.5 2`. Supply your own list with the space-separated
+`playbackrates` attribute (e.g. `playbackrates="0.5 1 1.5 2"`), and get/set
+the speed from page code via the `playbackRate` JS property (safe to set
+before mount; non-positive and non-numeric values are ignored — the viewer
+can always change it from the menu). The speed menu ships in the
+Cloudglue-served embed script, so it is not gated on a tinycloud version and
+already-published sites pick it up without republishing.
+
 To frame a single moment inside the full recording — a cited highlight you
 want to share on its own — add `clip-start`/`clip-end` (seconds) to a bare
 `<cg-video>`: the player draws a clip-length badge, a clip-region strip with a

package/skills/tinycloud/scripts/preflight.sh

@@ -9,11 +9,11 @@ set -u
 
 # Mirror tinycloud-skill.json: min_version / supported_range upper bound
 # (CI diffs these against the manifest).
-MIN_VERSION="0.3.7"
+MIN_VERSION="0.3.12"
 MAX_VERSION_EXCLUSIVE="0.4.0"
 INSTALL_CMD='curl -fsSL https://app.cloudglue.dev/tinycloud.sh | bash'
 # Kept in sync with ../tinycloud-skill.json required_features (CI diffs them).
-REQUIRED_FEATURES="envelope.v1 watch.v1 see.v1 extract.v1 extract.images.v1 caption.v1 search.v1 probe.v1 ask.v1 clip.v1 grab.v1 face.v1 jobs.v1 library.collections.v1 library.collections.create.v1 library.collections.mutate.v1 library.collections.entities.v1 library.sync.url.v1 workflow.v1 publish.v1 publish.manage.v1 publish.video.v1 setup.v1"
+REQUIRED_FEATURES="envelope.v1 watch.v1 watch.speech.v1 see.v1 extract.v1 extract.images.v1 caption.v1 search.v1 probe.v1 ask.v1 clip.v1 grab.v1 face.v1 jobs.v1 library.collections.v1 library.collections.create.v1 library.collections.mutate.v1 library.collections.entities.v1 library.sync.url.v1 workflow.v1 publish.v1 publish.manage.v1 publish.video.v1 setup.v1"
 
 # 1) Binary present and responsive?
 if ! command -v tinycloud >/dev/null 2>&1; then

package/skills/tinycloud/tinycloud-skill.json

@@ -1,11 +1,12 @@
 {
-  "skill_version": "0.3.11",
+  "skill_version": "0.3.13",
   "tinycloud": {
-    "min_version": "0.3.7",
-    "supported_range": ">=0.3.7 <0.4.0",
+    "min_version": "0.3.12",
+    "supported_range": ">=0.3.12 <0.4.0",
     "required_features": [
       "envelope.v1",
       "watch.v1",
+      "watch.speech.v1",
       "see.v1",
       "extract.v1",
       "extract.images.v1",