@cliptude/cli 0.1.18 → 0.1.21

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -208,9 +208,12 @@ def build_server(*, with_http_auth: bool = False):
208
208
  "plan_ready, get_narration (numbered sentences), get_kind_catalog (compact first), write the "
209
209
  "plan, check_plan until valid, lock_plan, continue_job, then get_plan_report. Before giving the user "
210
210
  "the editor link, open_editor_project and look at EVERY frame with view_scenes (0 to the end): replace "
211
- "any dead body or gore, other brands, logos, game or album art, title cards, pictures whose place or era "
211
+ "any dead body or gore, other brands, logos, album art, footage of a game, match or show the video is not about, title cards, pictures whose place or era "
212
212
  "contradicts the story (a search naming a place can return a namesake elsewhere), near-black frames, clips floating in black bars, broken AI pictures and any picture held over ~8 s, in a free revision, then review again. Generic "
213
- "shots of places name the story's setting (\"empty bed mud house\", not \"empty bed dark room\"). True "
213
+ "shots of places name the story's setting (\"empty bed mud house\", not \"empty bed dark room\"). A video "
214
+ "about a video game, sport, creator or TV show searches the real thing (\"GTA 6 gameplay driving\", "
215
+ "\"Bellingham Real Madrid goal\", \"Kai Cenat stream\"): its own footage is the footage, broadcaster and "
216
+ "channel logos included, never real-world stand-ins for it. True "
214
217
  "stories (real events and people) set sense.true_story and sense.people and never search for people: a "
215
218
  "stranger on screen is taken for the real person (check_plan refuses it, stand_in_person; a dated topic "
216
219
  "naming people counts as true unless true_story is false, and its year is the default era). See the "
@@ -772,7 +775,7 @@ def build_server(*, with_http_auth: bool = False):
772
775
  script_id: Annotated[str, Field(min_length=8, description="script_id / job_id from draft_product_script, once script_ready")],
773
776
  aspect_ratio: Annotated[str, Field(description="16:9 (YouTube), 9:16, 1:1 or 4:5")] = "16:9",
774
777
  ) -> dict[str, Any]:
775
- """Start BUILDING the video from the approved script on the same job id: voiceover, sourcing, motion graphics, and the merchant's real product photos composited into the closing product boards. This does not render the final MP4: when the build is done (ready_for_review) review it, show the user the editor_url and wait for their go-ahead before render_project. Returns {job_id, status, stage, editor_url, estimated_minutes} immediately; never wait in this call. Poll get_product_video_status."""
778
+ """Start BUILDING the video from the approved script on the same job id: voiceover, sourcing, motion graphics, and the merchant's real product photos composited into the closing product boards. This does not render the final MP4: when the build is done (ready_for_review) review it, show the user the editor_url and wait for their go-ahead before render_project. Returns {job_id, status, stage, editor_url, estimated_minutes, credits_reserved, credits} immediately (credits: charged so far, held while it builds, and the full-generation estimate); quote them to the user. Never wait in this call. Poll get_product_video_status."""
776
779
  try:
777
780
  return _client().render_product_video(script_id, aspect_ratio=aspect_ratio)
778
781
  except Exception as exc:
@@ -785,7 +788,7 @@ def build_server(*, with_http_auth: bool = False):
785
788
  def get_product_video_status(
786
789
  job_id: Annotated[str, Field(min_length=8, description="Job id from draft_product_script / render_product_video")],
787
790
  ) -> dict[str, Any]:
788
- """Stage of a product video (script_drafting, script_ready, producing, ready_for_review, rendered, failed) with the script once written, the editor_url to preview, the MP4 URL once rendered, and next_step telling you what to do."""
791
+ """Stage of a product video (script_drafting, script_ready, producing, ready_for_review, rendered, failed) with the script once written, the editor_url to preview, the MP4 URL once rendered, credits {charged, reserved, estimate, estimate_with_buffer} and next_step telling you what to do. The editor's export_credits_due is 0 until a first export exists (the first export of a video is free)."""
789
792
  try:
790
793
  return _client().get_product_video_status(job_id)
791
794
  except Exception as exc:
@@ -971,7 +974,7 @@ def build_server(*, with_http_auth: bool = False):
971
974
  Field(description="Local picture (JPG/PNG/WEBP/GIF, up to 15 MB) or clip (MP4/MOV/WEBM/M4V, up to 300 MB). Stdio / local MCP only: on a remote host (mcp.cliptude.com) use start_media_upload + finish_media_upload, which work from any agent that can run curl."),
972
975
  ],
973
976
  ) -> dict[str, Any]:
974
- """Send a picture or clip you found yourself to a plan job. The file goes straight to Cliptude's storage on signed URLs (no storage keys needed) and is checked to be a real picture or video. Returns {keep, file, media_type, size}: put {"keep": "<id>"} as a beat's media or a graphic's picture slot, with start_s/end_s on a beat to play only part of a clip."""
977
+ """Send a picture or clip you found yourself to a plan job. The file goes straight to Cliptude's storage on signed URLs (no storage keys needed) and is checked to be a real picture or video, and for nudity and gore (refused). Returns {keep, file, media_type, size, notes?}: put {"keep": "<id>"} as a beat's media or a graphic's picture slot, with start_s/end_s on a beat to play only part of a clip. notes say where a clip runs into a title or logo card or a weapon aimed at someone: trim it with start_s/end_s as they say."""
975
978
  try:
976
979
  return _client().upload_plan_media(job_id, path)
977
980
  except Exception as exc:
@@ -1004,7 +1007,7 @@ def build_server(*, with_http_auth: bool = False):
1004
1007
  key: Annotated[str, Field(min_length=1, description="key from start_media_upload")],
1005
1008
  upload_id: Annotated[str, Field(min_length=1, description="upload_id from start_media_upload")],
1006
1009
  ) -> dict[str, Any]:
1007
- """Close an upload after every part is PUT. Cliptude checks it is a real picture or video and returns {keep, file, media_type, size}: put {"keep": "<id>"} as a beat's media or a graphic's picture slot (start_s/end_s on a beat to play part of a clip)."""
1010
+ """Close an upload after every part is PUT. Cliptude checks it is a real picture or video (nudity and gore are refused) and returns {keep, file, media_type, size, notes?}: put {"keep": "<id>"} as a beat's media or a graphic's picture slot (start_s/end_s on a beat to play part of a clip). notes say where a clip runs into a title or logo card or a weapon aimed at someone: trim it as they say."""
1008
1011
  try:
1009
1012
  return _client().finish_media_upload(job_id, key=key, upload_id=upload_id)
1010
1013
  except Exception as exc:
@@ -1145,7 +1148,7 @@ def build_server(*, with_http_auth: bool = False):
1145
1148
  start_s: Annotated[float, Field(ge=0, description="First second to show")] = 0.0,
1146
1149
  end_s: Annotated[float | None, Field(description="Stop before this second (default: the end)")] = None,
1147
1150
  ) -> list[str | Image]:
1148
- """See what the timeline shows, without opening any link: numbered contact sheets of every picture, a frame of every clip and each graphic's picture with its words, with the narration under each, plus a legend (tile, item_id, start_s, end_s, words, said, flags: REPEATED PICTURE, HELD, AI STILL, DARK, BARS). Up to 24 tiles per call; call again from next_start_s. Use it to review a built video yourself (other brands, wrong pictures, repeats, leftover text) before giving the user the editor link, and again after run_agent to check the change."""
1151
+ """See what the timeline shows, without opening any link: numbered contact sheets of every picture, a frame of every clip and every board (graphic) drawn as the export draws it, with the footage under it and anything on top, with the narration under each, plus a legend (tile, item_id, start_s, end_s, words, said, flags: REPEATED PICTURE, HELD, AI STILL, DARK, BARS, BARE BOARD, BOARD PENDING). Up to 24 tiles per call; call again from next_start_s. When the answer has boards_pending, the boards are still rendering: call again with the same start_s in about a minute. Use it to review a built video yourself (other brands, wrong pictures, repeats, leftover text, boards with no picture, wrong or placeholder text on a board) before giving the user the editor link, and again after run_agent to check the change."""
1149
1152
  try:
1150
1153
  data = _client().view_scenes(project_id, start_s=start_s, end_s=end_s)
1151
1154
  except Exception as exc:
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@cliptude/cli",
3
- "version": "0.1.18",
3
+ "version": "0.1.21",
4
4
  "description": "Cliptude CLI — generate videos from saved templates.",
5
5
  "homepage": "https://github.com/cliptude/cliptude#readme",
6
6
  "bin": {
package/pyproject.toml CHANGED
@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
4
4
 
5
5
  [project]
6
6
  name = "cliptude-mcp"
7
- version = "0.1.18"
7
+ version = "0.1.21"
8
8
  description = "Cliptude jobs CLI and MCP server (thin client of /api/v1)."
9
9
  readme = "README.md"
10
10
  requires-python = ">=3.10"