v0.3.15 — iconik connector, metadata collections, and stored-field search filters

✨ New

Iconik joins the connector lineup as the seventh metadata-bearing provider. Browse, peek, and sync iconik assets like any other connector — with date and title filters native to iconik's API:

tinycloud library connectors files <iconik-connector-id> --title-search "onboarding" --from 2026-06-01 --json
tinycloud library connectors inspect iconik://asset/<id> --json     # provider metadata, no file created
tinycloud library connectors sync iconik://asset/<id> --json

Synced iconik files carry full source_metadata — title, media type, creation date, the iconik URL, and your custom metadata-view fields under source_metadata.iconik_metadata.<Field>.

Metadata collections: index a whole connector library without processing a single frame. The new --type metadata collection indexes connector source_metadata plus your own metadata into file-level search documents — free, near-instant, no describe/transcribe jobs:

tinycloud library collections create meetings --type metadata --json
tinycloud library collections add zoom://uuid/<uuid> --to <col> --metadata '{"deal":"acme"}' --json
tinycloud probe "renewal pricing call" --in collection:<col> --scope file --json

Use one to triage hundreds of recordings by title, participants, dates, and tags — then send only the keepers through full (billed) processing in a media-descriptions collection.

probe --filter — search by what you know, rank by what you mean. Repeatable stored-field filters narrow any collection search before semantic ranking, ANDed together and with the search's own planning:

tinycloud probe "kickoff walkthrough" --in collection:<col> --scope file \
  --filter "source_metadata.host_email=kevin@acme.com" \
  --filter "source_metadata.tags*=demo,intro" --json

Operators: = != > < ~= (SQL LIKE) *= (contains-any) &= (contains-all) ^= (in). Paths route by prefix: source_metadata.* (connector fields, including array traversal like source_metadata.parties.email), metadata.* (your fields from collections add --metadata), video_info.duration_seconds|has_audio, and file.filename|bytes|uri|created_at|id. Filtered probes keep deep search's ranking and answer synthesis.

connectors refresh — un-stale your metadata. Re-fetches an existing file's source_metadata live from its provider and re-indexes any metadata collections it belongs to. Free, no media downloaded:

tinycloud library connectors refresh <file-id | cloudglue-uri | connector-url> --json

Notes

Still 16 verbs; features 34 → 38 with library.connectors.iconik.v1, library.collections.metadata.v1, probe.filters.v1, and library.connectors.refresh.v1. The bundled Cloudglue SDK moves to 0.7.21 (API spec v0.7.11). Probing a metadata collection requires --scope file (its documents are file-level), and --filter applies to collection scopes only. The skill floor rises to 0.3.15, since the skill teaches the new flags and subcommands.

Install

curl -fsSL https://app.cloudglue.dev/tinycloud.sh | bash
# or
npm install -g @cloudglue/tinycloud

Existing installs: tinycloud update.