@kolbo/mcp 1.120.2 → 1.121.0

package/README.md

@@ -321,6 +321,7 @@ Requires DaVinci Resolve Studio with the Kolbo plugin open (Workspace → Workfl
 | `generate_character_sheet` | Generate a multi-angle character sheet from reference images (credits) → pass URL to create_visual_dna or update_visual_dna |
 | `list_visual_dna_folders` / `create_visual_dna_folder` / `update_visual_dna_folder` / `delete_visual_dna_folder` / `move_visual_dna_to_folder` | Organize Visual DNA characters into user folders (create/rename/recolor/delete + move DNAs in/out) |
 | `create_project` / `update_project` / `archive_project` / `unarchive_project` | Project lifecycle (create/rename/describe/archive; deletion stays in-app) |
+| `publish_project` / `get_project_publication` / `unpublish_project` / `submit_project_to_catalog` / `remove_project_hero_video` | Publish a project as a public showcase link, with write-up and final video as hero |
 | `transfer_visual_dna` / `list_visual_dna_transfers` / `respond_visual_dna_transfer` | Send Visual DNAs you own to another Kolbo account (they accept a copy with new ids; optionally move instead of copy) |
 | `transfer_project` / `list_project_transfers` / `respond_project_transfer` | Hand a project you own to another Kolbo account (they accept; same ids; cast assets copied; payer history unchanged) |
 | `list_skills` / `create_skill` / `update_skill` / `delete_skill` | Skills — reusable named personas for the chat tool; `description` is the system instruction |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kolbo/mcp",
-  "version": "1.120.2",
+  "version": "1.121.0",
   "description": "Kolbo AI MCP Server - Generate images, videos, music, speech, and sound effects from Claude Code",
   "main": "src/index.js",
   "bin": {

package/src/apps/widgets/generation.js

@@ -798,14 +798,16 @@ function schedulePoll(sc) {
   if (cancelRequested) return;
   if (!sc.generation_id && !(sc.generation_ids && sc.generation_ids.length) && !sc.status_args) return;
   if (!seen) { whenSeenFns.push(function () { schedulePoll(sc); }); return; }
-  // The call itself long-waits server-side, for one transport-safe window
-  // (~45s over the remote connector — see WAIT_WINDOW_MS in tools/generate.js).
-  // This short pause only separates successive wait windows — the FIRST call
-  // goes out immediately, so a card revealed by scrolling resolves at once.
-  // After failed calls, back off exponentially (capped at 30s): a host that
-  // rejects tools/call for a while (busy, rate-limited, reconnecting) used to
-  // burn all MAX_POLL_ERRORS retries in ~45s and strand finished generations.
-  var delay = pollStart ? Math.min(1500 * Math.pow(2, pollErrors), 30000) : 0;
+  // Each poll is a QUICK status read (wait:false). Long server-side waits held
+  // one host slot per card for up to 45s, and a chat with a dozen-plus live
+  // cards (17 fired in one minute on 2026-10-22) left cards queued behind each
+  // other on Generating while their images were done. Quick reads cost the
+  // host nothing between polls whatever its concurrency. Cadence: 3s for the
+  // first minute, 6s to five minutes, then 12s, plus jitter so many cards do
+  // not fire in lockstep. Failures back off exponentially (capped at 30s).
+  var age = pollStart ? Date.now() - pollStart : 0;
+  var base = age < 60000 ? 3000 : age < 300000 ? 6000 : 12000;
+  var delay = pollStart ? Math.min(base * Math.pow(2, pollErrors), 30000) + Math.floor(Math.random() * 1000) : 0;
   if (!pollStart) pollStart = Date.now();
   clearTimeout(pollTimer);
   pollTimer = setTimeout(function () { poll(sc); }, delay);
@@ -815,10 +817,8 @@ function poll(sc) {
   if (pollStart && (Date.now() - pollStart) > MAX_POLL_MS) {
     return renderTrackingIssue('This is still running longer than the tracking window. Do not retry it — any completed result will appear in your Kolbo library.');
   }
-  var args = sc.status_args || { generation_id: sc.generation_id, wait: true };
-  // Host-bridged calls may not reset their timeout on progress: keep each
-  // wait window inside the common 60s request timeout.
-  if (args.wait) args = Object.assign({}, args, { wait_seconds: 45 });
+  var args = Object.assign({}, sc.status_args || { generation_id: sc.generation_id }, { wait: false });
+  delete args.wait_seconds;
   pollInFlight = true;
   window.kolbo.callTool(sc.poll_tool || 'get_generation_status', args).then(function (res) {
     pollInFlight = false;

package/src/apps/widgets/transcript.js

@@ -93,9 +93,9 @@ function poll() {
   if ((Date.now() - pollStart) > MAX_POLL_MS) {
     return trackingIssue('This transcription is still running longer than the tracking window. Do not retry it — any completed result will appear in your Kolbo library.');
   }
-  var args = state.status_args || { generation_id: state.generation_id, wait: true };
-  // Keep each host-bridged wait inside the common 60s request timeout.
-  if (args.wait) args = Object.assign({}, args, { wait_seconds: 45 });
+  // Quick status read; see schedulePoll in the generation widget for why.
+  var args = Object.assign({}, state.status_args || { generation_id: state.generation_id }, { wait: false });
+  delete args.wait_seconds;
   window.kolbo.callTool(state.poll_tool || 'get_generation_status', args)
     .then(function (res) {
       var st = structured(res) || {};
@@ -118,10 +118,9 @@ function poll() {
 }
 
 function pollDelay() {
-  // The call itself long-waits server-side; only briefly back off between
-  // successive wait windows; after failed calls, back off exponentially
-  // (capped at 30s) so a briefly unavailable host can't exhaust the retries.
-  return Math.min(1500 * Math.pow(2, pollErrors), 30000);
+  // Quick reads every 5s (transcripts run minutes); failures back off
+  // exponentially, capped at 30s, plus jitter so cards don't fire in lockstep.
+  return Math.min(5000 * Math.pow(2, pollErrors), 30000) + Math.floor(Math.random() * 1000);
 }
 
 function trackingIssue(msg) {

package/src/toolAnnotations.js

@@ -8,15 +8,15 @@
  * or non-boolean entries whenever the registered tool surface changes.
  */
 
-const READ_ONLY = [
-  'get_video_inspection',
-  'get_flow_schema', 'list_flow_sessions', 'get_flow_session', 'validate_flow_session',
-  'estimate_flow_run', 'get_flow_run', 'list_flow_runs',
-  'list_morphious_styles',
-  'list_trends', 'get_trend', 'estimate_trend_run', 'get_trend_run', 'list_trend_runs',
+const READ_ONLY = [
+  'get_video_inspection',
+  'get_flow_schema', 'list_flow_sessions', 'get_flow_session', 'validate_flow_session',
+  'estimate_flow_run', 'get_flow_run', 'list_flow_runs',
+  'list_morphious_styles',
+  'list_trends', 'get_trend', 'estimate_trend_run', 'get_trend_run', 'list_trend_runs',
   'get_download_status',
-  'get_video_editor_schema', 'list_video_editor_sessions', 'get_video_editor_session',
-  'list_fonts', 'get_font', 'get_font_upload_status',
+  'get_video_editor_schema', 'list_video_editor_sessions', 'get_video_editor_session',
+  'list_fonts', 'get_font', 'get_font_upload_status',
   'get_creative_director_status', 'get_generation_status', 'list_models',
   'check_credits', 'show_plans', 'get_session_usage', 'list_voices',
   'chat_list_conversations', 'chat_get_messages',
@@ -25,7 +25,7 @@ const READ_ONLY = [
   'list_color_palettes', 'analyze_color_palette',
   'list_media', 'list_media_folders', 'get_media', 'get_media_stats',
   'list_presets', 'list_cinematic_presets',
-  'list_projects', 'get_project', 'list_sessions', 'list_project_context', 'get_project_profile',
+  'list_projects', 'get_project', 'get_project_publication', 'list_sessions', 'list_project_context', 'get_project_profile',
   'list_project_assets',
   'list_project_transfers', 'list_visual_dna_transfers',
   'list_session_generations',
@@ -41,18 +41,18 @@ const READ_ONLY = [
   'create_music_composition_plan',
 ];
 
-const OPEN_WORLD_READ_ONLY = [
-  // Reads public source media into private ephemeral scratch evidence, no library writes.
-  'prepare_video_inspection', 'inspect_video',
+const OPEN_WORLD_READ_ONLY = [
+  // Reads public source media into private ephemeral scratch evidence, no library writes.
+  'prepare_video_inspection', 'inspect_video',
   'blender_list_sessions', 'blender_get_scene', 'blender_search_docs',
   'blender_get_command_status',
   'adobe_list_sessions', 'adobe_get_project', 'adobe_get_timeline', 'adobe_get_command_status',
   'resolve_list_sessions', 'resolve_get_project', 'resolve_get_timeline', 'resolve_get_command_status',
 ];
 
-const PRIVATE_WRITE = [
-  'create_flow_session', 'duplicate_flow_session', 'move_flow_session', 'restore_flow_session',
-  'upload_font', 'rename_font', 'create_font_upload_ticket', 'font_upload_widget',
+const PRIVATE_WRITE = [
+  'create_flow_session', 'duplicate_flow_session', 'move_flow_session', 'restore_flow_session',
+  'upload_font', 'rename_font', 'create_font_upload_ticket', 'font_upload_widget',
   'create_video_editor_session',
   'media_upload_widget', 'create_upload_ticket', 'upload_media',
   'favorite_media', 'unfavorite_media', 'dislike_media', 'undislike_media', 'rate_media', 'clear_media_rating',
@@ -70,7 +70,7 @@ const PRIVATE_WRITE = [
   'split_session', 'undo_session_organization',
   'rename_session', 'restore_session',
   'create_project', 'duplicate_project', 'update_project',
-  'archive_project', 'unarchive_project', 'add_project_context',
+  'archive_project', 'unarchive_project', 'add_project_context', 'remove_project_hero_video',
   'link_project_asset', 'unlink_project_asset',
   'create_agent', 'create_skill',
   'create_doc',
@@ -81,14 +81,14 @@ const PRIVATE_WRITE = [
   'import_stock_asset',
 ];
 
-const DESTRUCTIVE_WRITE = [
-  'update_flow_session', 'undo_flow_edit', 'trash_flow_session',
-  'run_flow_session', 'cancel_flow_run', 'retry_flow_run',
-  'run_trend', 'cancel_trend_run',
+const DESTRUCTIVE_WRITE = [
+  'update_flow_session', 'undo_flow_edit', 'trash_flow_session',
+  'run_flow_session', 'cancel_flow_run', 'retry_flow_run',
+  'run_trend', 'cancel_trend_run',
   'cancel_download',
-  'extend_music', 'cover_music',
-  'update_video_editor_session',
-  'delete_font',
+  'extend_music', 'cover_music',
+  'update_video_editor_session',
+  'delete_font',
   'export_video_editor_session',
   // These actions spend credits, enqueue irreversible work, or cancel it.
   'generate_image', 'generate_image_edit', 'generate_creative_director',
@@ -103,8 +103,8 @@ const DESTRUCTIVE_WRITE = [
   'chat_send_message', 'generate_character_sheet',
   'acquire_clean_music_track', 'import_music_track_to_library',
   'separate_audio_stems', 'clean_dialogue_leftovers', 'separate_ambience',
-  'analyze_video',
-  'analyze_video_evidence', 'transcribe_video_evidence', 'cancel_video_inspection',
+  'analyze_video',
+  'analyze_video_evidence', 'transcribe_video_evidence', 'cancel_video_inspection',
 
   // Deletes and whole-value replacement updates are conservatively destructive.
   'delete_voice', 'update_visual_dna', 'delete_visual_dna', 'delete_visual_dna_folder',
@@ -125,10 +125,12 @@ const DESTRUCTIVE_WRITE = [
   'edit_review_comment', 'delete_review_comment',
 ];
 
-const OPEN_WORLD_WRITE = [
+const OPEN_WORLD_WRITE = [
   'download_media_from_url',
-  'import_music_audio',
+  'import_music_audio',
   'publish_html_artifact', 'create_review_share_link', 'blender_capture_viewport',
+  // Public showcase link for a project / catalog submission.
+  'publish_project', 'submit_project_to_catalog',
   // Adobe edits add bins, clips, sequences or caption tracks; none delete or overwrite.
   'adobe_import_media', 'adobe_place_on_timeline', 'adobe_create_sequence', 'adobe_import_captions',
   'adobe_capture_frame',
@@ -137,7 +139,7 @@ const OPEN_WORLD_WRITE = [
 ];
 
 const OPEN_WORLD_DESTRUCTIVE = [
-  'share_doc', 'revoke_review_share_link',
+  'share_doc', 'revoke_review_share_link', 'unpublish_project',
   'blender_apply_operations', 'blender_import_media', 'blender_render',
   'blender_undo', 'blender_file_operation', 'blender_execute_python',
   // Can delete layers; approved once per batch in the Kolbo panel.

package/src/tools/projects.js

@@ -315,6 +315,61 @@ function registerProjectTools(server, client) {
     }
   );
 
+  // ─── publish a project (public showcase link) ──────────────
+  const pubText = (r, hint) => ({ content: [{ type: 'text', text: JSON.stringify({ ...r, success: undefined, ...(hint ? { _hint: hint } : {}) }, null, 2) }] });
+
+  server.tool(
+    'publish_project',
+    'PUBLISH one of YOUR OWN projects as a public showcase page with a shareable link (the same as the app\'s Publish tab) and return the public `url`. Safe to call again: it never changes the URL, it only updates what you pass. In one call you can also set `allow_fork` (let viewers copy the project into their account), the public write-up `showcase_about`, and the project\'s FINAL VIDEO as the page hero. HERO VIDEO: the video must already be in THIS project — a generated video made with `project_id`, or a file you put there with `upload_media` (pass `project_id`; a local file is uploaded from disk). Then pass its media id as `hero_video_media_id` (or its Kolbo URL as `hero_video_url`). Anyone with the link can see the project\'s media, so ALWAYS confirm with the user before publishing, and consider `duplicate_project` first to publish a clean copy. Undo with `unpublish_project`.',
+    {
+      project_id: z.string().describe('ObjectId of a project you OWN (from list_projects).'),
+      allow_fork: z.boolean().optional().describe('Let viewers copy the project into their own account. Default true on first publish; omit to keep the current setting.'),
+      showcase_about: z.string().optional().describe('Public "About" write-up shown on the page (max 10000 chars, plain text). Omit on first publish and Kolbo drafts one for you; pass "" to clear.'),
+      hero_video_media_id: z.string().optional().describe('Media id (from upload_media / list_media) of a VIDEO already in this project, shown as the full-bleed hero of the public page.'),
+      hero_video_url: z.string().optional().describe('Alternative to hero_video_media_id: the Kolbo CDN URL of a video already in this project.')
+    },
+    async ({ project_id, allow_fork, showcase_about, hero_video_media_id, hero_video_url }) => {
+      const body = {};
+      if (allow_fork !== undefined) body.allow_fork = allow_fork;
+      if (showcase_about !== undefined) body.showcase_about = showcase_about;
+      if (hero_video_media_id) body.hero_video_media_id = hero_video_media_id;
+      if (hero_video_url) body.hero_video_url = hero_video_url;
+      const result = await client.post(`/v1/projects/${encodeURIComponent(project_id)}/publish`, body);
+      return pubText(result, 'Share `url` with the user — it is live now. To list it in the public catalog call `submit_project_to_catalog` (review is manual).');
+    }
+  );
+
+  server.tool(
+    'get_project_publication',
+    'Check whether a project is published and read its public `url`, allow_fork, showcase_about, hero video, catalog listing status (none / pending / approved / rejected) and fork count. Returns `{ published: false }` when it is not published.',
+    { project_id: z.string().describe('ObjectId of a project you OWN.') },
+    async ({ project_id }) => pubText(await client.get(`/v1/projects/${encodeURIComponent(project_id)}/publish`))
+  );
+
+  server.tool(
+    'unpublish_project',
+    'Take a published project OFFLINE: the public link stops working immediately. Copies other people already made stay theirs. Re-publishing with `publish_project` creates a new link. Confirm with the user first.',
+    { project_id: z.string().describe('ObjectId of a project you OWN.') },
+    async ({ project_id }) => pubText(await client.delete(`/v1/projects/${encodeURIComponent(project_id)}/publish`))
+  );
+
+  server.tool(
+    'submit_project_to_catalog',
+    'Submit a PUBLISHED project to Kolbo\'s public catalog (status becomes `pending`; a Kolbo admin approves it — you cannot approve your own). Pass `submit: false` to withdraw. Fails with NOT_PUBLISHED if `publish_project` has not been called.',
+    {
+      project_id: z.string().describe('ObjectId of a project you OWN.'),
+      submit: z.boolean().optional().describe('true (default) = submit for review, false = withdraw.')
+    },
+    async ({ project_id, submit }) => pubText(await client.post(`/v1/projects/${encodeURIComponent(project_id)}/publish/listing`, { submit: submit !== false }))
+  );
+
+  server.tool(
+    'remove_project_hero_video',
+    'Clear the hero video of a published project (the page falls back to a mosaic of the project\'s stills). The video file itself stays in the project\'s media.',
+    { project_id: z.string().describe('ObjectId of a project you OWN.') },
+    async ({ project_id }) => pubText(await client.delete(`/v1/projects/${encodeURIComponent(project_id)}/publish/hero-video`))
+  );
+
   // ─── project transfer (hand a project to another account) ──
   server.tool(
     'transfer_project',