@cloudglue/tinycloud 0.3.4 → 0.3.5

package/README.md

@@ -16,11 +16,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.4` always runs tinycloud 0.3.4. It also adds two
+`npx @cloudglue/tinycloud@0.3.5` always runs tinycloud 0.3.5. It also adds two
 wrapper commands:
 
 ```bash
-tinycloud install --version 0.3.4   # pre-download a version
+tinycloud install --version 0.3.5   # 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.4",
+  "version": "0.3.5",
   "description": "Agent CLI for deep video work, by Cloudglue. Downloads the tinycloud binary on first run.",
   "bin": {
     "tinycloud": "bin/tinycloud.js"

package/skills/tinycloud/SKILL.md

@@ -118,6 +118,8 @@ tinycloud publish list --json
 
 # Share a video itself (hosted share page + HLS stream, like a Loom link)
 tinycloud publish video ./demo.mp4 --visibility public --json
+# Share a single moment — also returns data.moment_url (0.3.5+)
+tinycloud publish video ./demo.mp4 --clip-start 18 --clip-end 33 --json
 ```
 
 Per-verb details and all flags: [reference/verbs.md](reference/verbs.md).
@@ -185,7 +187,8 @@ Authoring your own recipes: [reference/workflow-authoring.md](reference/workflow
   are signed and short-lived (never hard-code them) — embed via
   `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`; JS
+  built-ins (`autoplay`+`muted`, `loop`, `start-time`, `exclusive`,
+  `clip-start`/`clip-end` to frame one "back to moment" clip; JS
   `playSegment(start, end?)`) and the container components
   (`<cg-playlist>`, `<cg-grid>`, `<cg-chapters>`) rather than hand-rolled
   players, galleries, or segment-list JS — details in

package/skills/tinycloud/reference/glossary.md

@@ -88,11 +88,15 @@ connector?" or an envelope field needs explaining.
   `publish unpublish <site-id | site-name | label>`.
 - **Video share (shareable asset)** — `tinycloud publish video <source>`
   wraps a Cloudglue file in a hosted share page (`data.share.share_url`) plus
-  an HLS stream; one active share per (file, visibility). Private shares
+  an HLS stream; one active share per (file, visibility). Adding
+  `--clip-start`/`--clip-end` (seconds, 0.3.5+) also returns `data.moment_url`,
+  the share page bounded to that "back to moment" window (also reachable as
+  `?s=<start>&e=<end>` on a `share_url`). Private shares
   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 a JS API (`playSegment`, `seekTo`, media
+  `accent-color`, `exclusive`, and `clip-start`/`clip-end` to frame a single
+  "back to moment" clip) and a JS API (`playSegment`, `seekTo`, 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

@@ -278,7 +278,7 @@ generated site name, or your `--name` label.
 
 ```bash
 tinycloud publish video <source> [--visibility public|private]   # default public
-  [--name <title>] [--segment-id <id>] --json
+  [--name <title>] [--segment-id <id>] [--clip-start <s> --clip-end <e>] --json
 tinycloud publish video list [--in <source>] [--visibility public|private] --json
 tinycloud publish video unpublish <share-id | source> --json   # --visibility disambiguates
 ```
@@ -297,6 +297,14 @@ feature id.
   `data.embed_snippet` (a `<cg-video share-id="...">` tag), which only plays
   on a PRIVATE published site of the same account — `tinycloud publish`
   rejects an artifact with a private embed targeted at a public site.
+- Moment window (0.3.5+): pass `--clip-start <s> --clip-end <e>` (seconds,
+  `clip-end > clip-start >= 0`, both required together or the command errors)
+  to also get `data.moment_url` — the hosted share page bounded to
+  `[start, end]`, with the same length badge, region strip, and "↺ Back to
+  moment" pill as the `<cg-video>` clip embed, and it survives the
+  private-share sign-in. Optional — omit it for a plain full-video share. The
+  same window is just `?s=<start>&e=<end>` appended to a `share_url`, so you
+  can hand-build a moment link from an existing share without re-publishing.
 
 When generating custom site HTML around a `<cg-video>` embed, use the
 component's built-ins instead of reinventing them. It defaults to a
@@ -309,6 +317,17 @@ rest). Its JS API queues until ready — `playSegment(start, end?)`,
 element (`timeupdate`, `ended`, `cg-ready`); prefer `playSegment` over
 hand-rolled seek logic for "click a moment to play that segment" pages.
 
+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
+live playhead, snaps the first play to `clip-start`, and auto-pauses at
+`clip-end` (via `playSegment`). Scrubbing out of the window fades in a soft
+"↺ Back to moment" pill — a manual scrub-out is never forced back. Both are
+required and `clip-end` is ignored unless it is greater than `clip-start`; the
+pair is `<cg-video>`-only (not read on `<cg-playlist-item>`/`<cg-grid-item>`).
+Rule of thumb: one moment → `clip-start`/`clip-end` on a `<cg-video>`; several
+segments a viewer navigates between → `<cg-chapters>` (below).
+
 For multi-video or segment-navigation pages, prefer the container components
 over hand-rolled galleries and segment-list JS:
 

package/skills/tinycloud/tinycloud-skill.json

@@ -1,5 +1,5 @@
 {
-  "skill_version": "0.3.4",
+  "skill_version": "0.3.5",
   "tinycloud": {
     "min_version": "0.3.4",
     "supported_range": ">=0.3.4 <0.4.0",