Prepare for tinycloud 0.3.11: connector source metadata + connectors inspect - #18
Merged
Conversation
…inspect Version parity (package.json, plugin.json, marketplace.json, skill_version, README pin, CLAUDE.md examples + CDN prose) for the 0.3.11 binary, plus doc updates for the Cloudglue SDK 0.7.19 / spec v0.7.9 connector changes: - verbs.md: real per-connector filter matrix (--from/--to on every provider except S3/GCS, Zoom+Gong 6-month lookback, --title-search on five providers), source_metadata populated by all six metadata-bearing providers on sync, filtered-pagination guidance (page until next_page_token is null) - all server-side, valid for 0.3.10 too - verbs.md: `connectors inspect [<id>] <uri>` (0.3.11+, feature library.connectors.inspect.v1) - provider-metadata peek without creating a file, with a `connectors sync` fallback for older binaries; per-file provider `metadata` on `connectors files` rows (0.3.11+) - glossary.md: connector list corrected (Loom was never a connector; added Gong and Recall) Skill floor stays 0.3.7; required_features unchanged (additive pattern - inspect is convenience, not a core video op).
amyxst
approved these changes
Jul 16, 2026
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Stages the dist repo for tinycloud 0.3.11 (built from the private source repo with Cloudglue SDK 0.7.19 / API spec v0.7.9 — connector source metadata for all six metadata-bearing providers).
Version parity → 0.3.11 across
package.json,.claude-plugin/plugin.json,.claude-plugin/marketplace.json(×2),tinycloud-skill.jsonskill_version, README pins, and CLAUDE.md examples + CDN prose.Doc updates, two tiers:
Valid for the shipped 0.3.10 binary today (server-side behavior — flags pass through):
verbs.md: real per-connector filter matrix —--from/--toon every provider except S3/GCS (Zoom and Gong default to a 6-month lookback),--title-searchon Grain/Zoom/Drive/Dropbox/Gong; synced files carry providersource_metadatafrom all six providers; filtered pages can come back short or empty while more remain — page untilnext_page_tokenis nullglossary.md: connector list corrected — Loom was never a connector (it syncs via direct URL ingestion); added the missing Gong and RecallGated on 0.3.11+ (needs the new binary):
library connectors inspect [<connector-id>] <uri-or-share-link>(featurelibrary.connectors.inspect.v1) — provider-metadata peek without materializing a file; docs include the graceful-degradation path on older binaries (unknown-command error → fall back to idempotentconnectors syncand readsource_metadatafrom the envelope)metadataonconnectors filesrowsFloor decision:
min_versionstays 0.3.7,required_featuresunchanged — inspect is a convenience, not a core video op (same additive pattern as 0.3.8 hard clips and 0.3.10 login). Preflight untouched.Contract delta for reference: verbs 16 → 16 (inspect is a
librarysubcommand), features 31 → 32,command_spec_revisionunchanged.Test plan
npm test42/42 (offline unit + skills + e2e-local)claude plugin validate .greenscripts/smoke-test.sh16/16 against a locally built 0.3.11 binary (EXPECTED_VERSION=0.3.11)--frombeyond the 6-month window, drive--title-search(folders exempt),inspectwith auto-resolved and explicit connector ids, S3 rejected client-sidemetadatafield andconnectors inspectfails cleanly — hence the 0.3.11+ gating aboveNote
Low Risk
Distribution and documentation-only changes with no launcher logic edits; main operational risk is publishing or merging before CDN 0.3.11 artifacts exist.
Overview
Stages tinycloud 0.3.11 across
package.json, Claude plugin/marketplace metadata,tinycloud-skill.jsonskill_version, README install pins, and maintainer examples inCLAUDE.md(smoke tests, fixture CDN, manifest checks, CDN stable channel prose).Connector docs in
verbs.mdandglossary.mdnow cover SDK 0.7.19 behavior: synced files expose providersource_metadatafor Grain, Zoom, Recall, Google Drive, Dropbox, and Gong;library connectors filesrows can include per-itemmetadataon 0.3.11+; a clearer filter matrix (--from/--to,--title-search, Zoom/Gong six-month defaults, paging caveats); andlibrary connectors inspect(featurelibrary.connectors.inspect.v1) to peek metadata without creating a file, with fallback guidance for older binaries. The glossary drops Loom as a connector and adds Gong/Recall.Compatibility unchanged:
min_versionstays 0.3.7 andrequired_featuresis untouched—inspect is documented as additive, not a new preflight gate. Verb count remains 16 (inspect is alibrarysubcommand); contract notes features 31→32.Merge is intended only after the live CDN serves 0.3.11 so live-CDN CI and npm publish gates pass.
Reviewed by Cursor Bugbot for commit 5a901e2. Bugbot is set up for automated code reviews on this repo. Configure here.