@kolbo/mcp 1.107.2 → 1.108.0

package/README.md

@@ -317,6 +317,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) |
+| `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 |
 | `list_agents` / `create_agent` / `update_agent` / `delete_agent` | Same four tools under their original names. Still supported and unchanged; new integrations should use the `*_skill` names |
 | `create_video_editor_session` / `export_video_editor_session` | Build an editable timeline from Kolbo-hosted clips, audio and text, then export it to MP4. No new media is generated; identical snapshots reuse the same export job |

package/package.json

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

package/src/toolAnnotations.js

@@ -26,6 +26,7 @@ const READ_ONLY = [
   'list_presets', 'list_cinematic_presets',
   'list_projects', 'get_project', 'list_sessions', 'list_project_context', 'get_project_profile',
   'list_project_assets',
+  'list_project_transfers',
   'list_session_generations',
   'list_agents', 'list_skills', 'list_docs', 'get_doc',
   'get_review_storage_usage', 'list_review_assets', 'get_review_asset',
@@ -111,6 +112,8 @@ const DESTRUCTIVE_WRITE = [
   'delete_session',
   'delete_project_context', 'regenerate_project_profile',
   'update_project_asset',
+  // Ownership hand-off: the sender loses the project (and maybe all access) on accept.
+  'transfer_project', 'respond_project_transfer',
   'update_agent', 'delete_agent', 'update_skill', 'delete_skill', 'update_doc', 'delete_doc',
   'delete_review_asset', 'delete_review_collection',
   'edit_review_comment', 'delete_review_comment',

package/src/tools/projects.js

@@ -315,6 +315,57 @@ function registerProjectTools(server, client) {
     }
   );
 
+  // ─── project transfer (hand a project to another account) ──
+  server.tool(
+    'transfer_project',
+    'Ask another Kolbo account (by email) to take over a project you OWN. Nothing moves until they accept (in the app, or via `respond_project_transfer`) within 7 days. On accept EVERYTHING moves to them with the same ids — sessions, generations, media, chats, docs, agents; your Visual DNA / moodboards / palette in the project cast are COPIED to them (you keep yours). Credit history keeps you as the payer. Set `keep_sender_as_editor` false to lose access entirely (default: you stay as an editor). Team/organization projects cannot be transferred. ALWAYS confirm the recipient email and the keep-editor choice with the user before calling.',
+    {
+      project_id: z.string().describe('Project ObjectId you own (from list_projects).'),
+      email: z.string().describe('Email of the EXISTING Kolbo account that should become the owner.'),
+      keep_sender_as_editor: z.boolean().optional().describe('Stay on the project as an editor after the transfer. Default: true.'),
+    },
+    async ({ project_id, email, keep_sender_as_editor }) => {
+      const result = await client.post(`/v1/projects/${encodeURIComponent(project_id)}/transfer`, {
+        email,
+        ...(keep_sender_as_editor === undefined ? {} : { keep_sender_as_editor }),
+      });
+      return { content: [{ type: 'text', text: JSON.stringify(result.transfer, null, 2) }] };
+    }
+  );
+  server.tool(
+    'list_project_transfers',
+    'List project transfer requests. `direction: incoming` (default) = projects other people want to give you; `outgoing` = ones you sent. Defaults to pending only. Use the `id` with `respond_project_transfer`.',
+    {
+      direction: z.enum(['incoming', 'outgoing']).optional().describe('Default: incoming.'),
+      status: z.enum(['pending', 'accepted', 'declined', 'cancelled', 'expired', 'failed']).optional().describe('Default: pending.'),
+    },
+    async ({ direction, status }) => {
+      const params = new URLSearchParams();
+      if (direction) params.set('direction', direction);
+      if (status) params.set('status', status);
+      const qs = params.toString();
+      const result = await client.get(`/v1/project-transfers${qs ? '?' + qs : ''}`);
+      return { content: [{ type: 'text', text: JSON.stringify(result.transfers || [], null, 2) }] };
+    }
+  );
+  server.tool(
+    'respond_project_transfer',
+    'Act on a project transfer request. `accept` / `decline` = you are the recipient; `cancel` = you sent it. Accepting makes you the owner of the whole project immediately. If the project still has generations running, accept returns TRANSFER_BLOCKED_IN_FLIGHT — wait and retry. Confirm with the user before accepting.',
+    {
+      transfer_id: z.string().describe('Transfer id from list_project_transfers.'),
+      action: z.enum(['accept', 'decline', 'cancel']),
+    },
+    async ({ transfer_id, action }) => {
+      const id = encodeURIComponent(transfer_id);
+      // Explicit paths (not `/${action}`) so check-parity can see each route.
+      let result;
+      if (action === 'cancel') result = await client.delete(`/v1/project-transfers/${id}`);
+      else if (action === 'accept') result = await client.post(`/v1/project-transfers/${id}/accept`, {});
+      else result = await client.post(`/v1/project-transfers/${id}/decline`, {});
+      return { content: [{ type: 'text', text: JSON.stringify(result.transfer, null, 2) }] };
+    }
+  );
+
   // ─── list_sessions ─────────────────────────────────────────
   server.tool(
     'list_sessions',

package/src/tools/trends.js

@@ -14,8 +14,12 @@ const { UI, uiResult } = require('../apps');
 
 const slugField = z.string().min(1).max(200).regex(/^[\w-]+(\/[\w-]+)?$/)
   .describe('Trend slug from list_trends, e.g. "vanish" or "motion/kolbo-urban-dance-glide".');
-const inputsField = z.record(z.string(), z.string().max(2048))
-  .describe('Values for the trend\'s declared inputs, keyed by input `key` from get_trend. Media inputs take an https URL (upload local files with upload_media / create_upload_ticket first). Text inputs take plain text.');
+const inputsField = z.record(z.string(), z.union([z.string().max(2048), z.array(z.string().max(2048)).min(1).max(3)]))
+  .describe('Values for the trend\'s declared inputs, keyed by input `key` from get_trend. Media inputs take an https URL (upload local files with upload_media / create_upload_ticket first); a photo input with max_images > 1 also takes an ARRAY of up to that many photos of the same subject (more angles = better likeness). Text inputs take plain text.');
+const dnaField = z.record(z.string(), z.string().regex(/^[a-f0-9]{24}$/i)).optional()
+  .describe('Use a saved Visual DNA for a photo input: { input key: visual DNA id } (ids from list_visual_dnas). The DNA\'s own character sheet and photos are used for that input, so leave that key out of inputs.');
+const previewField = z.boolean().optional()
+  .describe('Run a short preview (~4 s cut of the trend, priced at its own length) instead of the full video. Only trends whose get_trend shows `preview`.');
 const resolutionField = z.enum(['480p', '720p', '1080p']).optional()
   .describe('Render resolution for video trends (see resolutions in get_trend). Default: the trend\'s own. Higher costs more; quote it with estimate_trend_run.');
 const projectField = z.string().min(1).max(128).optional()
@@ -95,7 +99,8 @@ function registerTrendTools(server, client) {
       const summary = trends.map(t => ({
         slug: t.slug, name: t.name, description: t.description, family: t.family, output_type: t.output_type,
         estimated_credits: t.estimated_credits, free_trial: t.free_trial, badges: t.badges,
-        inputs: (t.inputs || []).map(i => ({ key: i.key, kind: i.kind, role: i.role, label: i.label, required: i.required })),
+        inputs: (t.inputs || []).map(i => ({ key: i.key, kind: i.kind, role: i.role, label: i.label, required: i.required, ...(i.max_images && { max_images: i.max_images }) })),
+        ...(t.preview && { preview: t.preview }),
       }));
       return uiResult(UI.mediaGrid, JSON.stringify({ trends: summary, count: summary.length, free_trials_left: baseData.free_trials_left ?? null }, null, 2), {
         widget: 'media-grid',
@@ -117,8 +122,8 @@ function registerTrendTools(server, client) {
   server.tool(
     'estimate_trend_run',
     'Quote a trend run before spending: returns total_credits for these exact inputs (video trends are priced by the source clip length). Free — no credits spent.',
-    { slug: slugField, inputs: inputsField, project_id: projectField, resolution: resolutionField },
-    async ({ slug, inputs, project_id, resolution }) => text(unwrap(await client.post(`/v1/trends/${slugPath(slug)}/estimate`, { inputs, ...(project_id && { project_id }), ...(resolution && { resolution }) })))
+    { slug: slugField, inputs: inputsField, dna: dnaField, preview: previewField, project_id: projectField, resolution: resolutionField },
+    async ({ slug, inputs, dna, preview, project_id, resolution }) => text(unwrap(await client.post(`/v1/trends/${slugPath(slug)}/estimate`, { inputs, ...(dna && { dna }), ...(preview && { preview: true }), ...(project_id && { project_id }), ...(resolution && { resolution }) })))
   );
 
   server.tool(
@@ -127,6 +132,8 @@ function registerTrendTools(server, client) {
     {
       slug: slugField,
       inputs: inputsField,
+      dna: dnaField,
+      preview: previewField,
       project_id: projectField,
       resolution: resolutionField,
       max_credits: z.number().finite().min(0).optional().describe('Credit ceiling for this run. Default: the trend\'s own ceiling.'),
@@ -135,8 +142,8 @@ function registerTrendTools(server, client) {
       wait: z.boolean().optional().describe('Wait for the result. Default true.'),
       wait_seconds: z.number().int().min(0).max(170).optional().describe('How long to wait before returning. Default 150.'),
     },
-    async ({ slug, inputs, project_id, resolution, max_credits, free_trial, idempotency_key, wait, wait_seconds }) => {
-      const body = { inputs, idempotency_key: idempotency_key || randomUUID(), ...(project_id && { project_id }), ...(resolution && { resolution }), ...(max_credits !== undefined && { max_credits }), ...(free_trial && { free_trial: true }) };
+    async ({ slug, inputs, dna, preview, project_id, resolution, max_credits, free_trial, idempotency_key, wait, wait_seconds }) => {
+      const body = { inputs, ...(dna && { dna }), ...(preview && { preview: true }), idempotency_key: idempotency_key || randomUUID(), ...(project_id && { project_id }), ...(resolution && { resolution }), ...(max_credits !== undefined && { max_credits }), ...(free_trial && { free_trial: true }) };
       const started = unwrap(await client.post(`/v1/trends/${slugPath(slug)}/runs`, body));
       started.idempotency_key = body.idempotency_key;
       if (wait === false || TERMINAL.has(started.status)) return runResult(started);