@kolbo/mcp 1.61.0 → 1.62.0

package/package.json

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

package/src/tools/chat.js

@@ -5,6 +5,7 @@
 
 const { z } = require('zod');
 const { pollOrTimedOut, creditFields, projectIdField } = require('./_shared');
+const { canonicalModelId } = require('../apps');
 
 function registerChatTools(server, client) {
   // ─── chat_send_message ─────────────────────────────────────
@@ -13,7 +14,7 @@ function registerChatTools(server, client) {
     'Send a chat message to Kolbo AI. Starts a new conversation (omit session_id) or continues an existing one. Returns the assistant response when complete. Supports image/video/audio analysis via media_urls — pass public URLs and the model auto-routes to a vision-capable model (e.g. Gemini) when media is detected. Supports web search and deep think modes.',
     {
       message: z.string().describe('The user message to send'),
-      model: z.string().optional().describe('Model identifier (e.g. "gpt-4o", "claude-sonnet-4-6"). Prefer passing a SPECIFIC model (list_models type="text") — omitting falls back to Smart Select auto-routing, which we avoid unless the user explicitly asks for auto-pick. Exception: when media_urls contains video or audio, omitting is fine — routing goes to a Gemini vision model regardless of this field.'),
+      model: z.string().optional().describe('Model identifier from list_models type="text". Identifiers resolve leniently, so the DISPLAY NAME that list_models shows works too ("Grok 4.5" → its identifier). Do NOT hardcode an id you have not seen in list_models — the text catalog turns over fast. Prefer passing a SPECIFIC model — omitting falls back to Smart Select auto-routing, which we avoid unless the user explicitly asks for auto-pick. Exception: when media_urls contains video or audio, omitting is fine — routing goes to a Gemini vision model regardless of this field.'),
       session_id: z.string().optional().describe('Existing chat session ID to continue. Omit to start a new conversation.'),
       system_prompt: z.string().optional().describe('System prompt for the conversation. Only applied when creating a new session.'),
       web_search: z.boolean().optional().describe('Enable web search for this message. Default: false'),
@@ -23,6 +24,13 @@ function registerChatTools(server, client) {
       project_id: projectIdField
     },
     async ({ message, model, session_id, system_prompt, web_search, deep_think, enhance_prompt = false, media_urls, project_id }) => {
+      // Every generate_* tool resolves its model this way; chat was the one
+      // `model` arg that went straight to the API, which has no fuzzy matching.
+      // So the display names list_models hands back ("Claude Fable 5") came
+      // back as a bare `Model not found: Claude Fable 5 [MODEL_NOT_FOUND]` —
+      // discovery had no path to use.
+      model = await canonicalModelId(client, model, 'text'); // lenient id resolution ("Grok 4.5" → its identifier)
+
       const gen = await client.post('/v1/chat', {
         message,
         model,

package/src/tools/models.js

@@ -67,6 +67,10 @@ function buildCatalogStructured(models, type, compact) {
     if (g.models.length >= 6) continue; // curated cap — full list lives in the text payload
     g.models.push({
       name: m.name,
+      // The widget renders `name`; the AGENT reads the same rows (hosts hand it
+      // structuredContent). Without the identifier the default call was a dead
+      // end — it named six models and gave no way to pass any of them on.
+      identifier: m.identifier,
       icon: resolveAvatarUrl(m.avatar),
       description: String(m.smartSelect_StrengthsSummary || m.summary || m.description || '').slice(0, 90),
       chips: modelChips(m),

package/src/tools/projects.js

@@ -12,21 +12,34 @@ function registerProjectTools(server, client, options = {}) {
   // ─── list_projects ─────────────────────────────────────────
   server.tool(
     'list_projects',
-    'List the user\'s platform projects (owned + shared with edit/full/owner permission). Use this to resolve a project NAME the user mentioned ("put this in my Acme Campaign project") into the project ObjectId you pass back as `project_id` on generation / chat / upload / move tools. Whenever the user mentions a project by name OR location, you MUST call this first — those tools accept only ObjectIds, not names — and then pass the resolved `project_id` on EVERY subsequent call in the conversation (it is per-call, not sticky; omitting it drops work into the default bucket). Returns id, name, role, and is_default. The project flagged `is_default: true` is the auto-created "API Generations" bucket every SDK generation lands in when project_id is omitted.',
-    {},
-    async () => {
-      const result = await client.get('/v1/projects');
+    'List the user\'s platform projects (owned + shared with edit/full/owner permission). Use this to resolve a project NAME the user mentioned ("put this in my Acme Campaign project") into the project ObjectId you pass back as `project_id` on generation / chat / upload / move tools. Whenever the user mentions a project by name OR location, you MUST call this first — those tools accept only ObjectIds, not names — and then pass the resolved `project_id` on EVERY subsequent call in the conversation (it is per-call, not sticky; omitting it drops work into the default bucket). Returns id, name, role, is_default, and is_archived. The project flagged `is_default: true` is the auto-created "API Generations" bucket every SDK generation lands in when project_id is omitted. Accounts routinely have HUNDREDS of projects, so this is paginated: when you already know the name, pass `search` — it is far cheaper than listing everything. Default page size is 50; use `page` to walk the rest (`pagination.has_more` tells you when to stop). Archived projects are hidden unless you pass `include_archived: true`.',
+    {
+      search: z.string().optional().describe('Case-insensitive substring match on the project name. Use this whenever the user named a project — it turns a full listing into a one-item answer.'),
+      page: z.number().optional().describe('Page number, 1-indexed. Default: 1'),
+      limit: z.number().optional().describe('Results per page, max 200. Default: 50'),
+      include_archived: z.boolean().optional().describe('Also return archived projects. Default false — archived projects are hidden here exactly as they are in the web app.')
+    },
+    async ({ search, page, limit, include_archived }) => {
+      const params = new URLSearchParams();
+      if (search) params.set('search', search);
+      if (page) params.set('page', String(page));
+      if (limit) params.set('limit', String(limit));
+      if (include_archived) params.set('include_archived', 'true');
+      const qs = params.toString();
+      const result = await client.get(`/v1/projects${qs ? '?' + qs : ''}`);
       const projects = (result.projects || []).map(p => ({
         id: p.id,
         name: p.name,
         role: p.role,
         is_default: !!p.is_default,
+        is_archived: !!p.is_archived,
         open_url: buildProjectUrl(p.id, { is_default: !!p.is_default })
       }));
       const text = JSON.stringify({
         projects,
         count: projects.length,
-        _hint: 'Pass the chosen `id` as `project_id` on any generate_* tool to drop the generation into that project. Omit project_id to use the project flagged is_default:true. `open_url` opens that project\'s media in the web app (share it with the user).'
+        pagination: result.pagination || null,
+        _hint: 'Pass the chosen `id` as `project_id` on any generate_* tool to drop the generation into that project. Omit project_id to use the project flagged is_default:true. `open_url` opens that project\'s media in the web app (share it with the user). If `pagination.has_more` is true there are more projects — narrow with `search` rather than paging through everything.'
       }, null, 2);
 
       if (ui()) {
@@ -36,7 +49,7 @@ function registerProjectTools(server, client, options = {}) {
           items: projects.map(p => ({
             id: p.id,
             title: p.name,
-            subtitle: p.role + (p.is_default ? ' · default' : ''),
+            subtitle: p.role + (p.is_default ? ' · default' : '') + (p.is_archived ? ' · archived' : ''),
             open_url: p.open_url,
             use_hint: 'Use my "{TITLE}" project (project_id: {ID}) for what I do next.'
           })),

package/src/tools/visual_dna.js

@@ -87,15 +87,19 @@ function registerVisualDnaTools(server, client, options = {}) {
     + 'because dumping them buries the user\'s own handful. Only pass scope="global" (optionally with '
     + '`collection` and `search`) when the user explicitly wants to BROWSE the preset cast — e.g. "find me a '
     + 'character", "show me street style models", "I need a location DNA" — and they have not named one of '
-    + 'their own. Use scope="all" only if the user genuinely wants both at once.',
+    + 'their own. Use scope="all" only if the user genuinely wants both at once. '
+    + 'The response reports `total` and `_truncated`; when there are more matches than one '
+    + 'page holds, raise `limit` or walk `page` — do not tell the user the extras do not exist.',
     {
       scope: z.enum(['all', 'personal', 'global', 'organization']).optional().describe('Default: "personal" — the user\'s own DNAs (plus a shared project\'s when project_id is set). "global" = the ~1000 system cast/preset DNAs, for browsing when the user needs a character and has none of their own. "organization" = org-shared. "all" = everything, rarely wanted.'),
-      search: z.string().optional().describe('Search by name, tags, or description (case-insensitive)'),
+      search: z.string().optional().describe('Search by name, tags, or description (case-insensitive). Matches at WORD STARTS, so "man" finds "Man"/"Manager" but not "woman" or "romantic". Name matches are ranked first.'),
       collection: z.string().optional().describe('Filter global presets by collection: cast, influencers, props, locations, styles, glamour, street'),
       tags: z.string().optional().describe('Comma-separated tags to filter by (OR logic)'),
+      page: z.number().optional().describe('Page number, 1-indexed. Default: 1. Needed to reach the global cast beyond the first page.'),
+      limit: z.number().optional().describe('Results per page, max 100. Default: 50'),
       project_id: projectScopeReadField
     },
-    async ({ scope, search, collection, tags, project_id } = {}) => {
+    async ({ scope, search, collection, tags, page, limit, project_id } = {}) => {
       const params = new URLSearchParams();
       // Default to the user's OWN DNAs. The API defaults to "all", which pulls
       // in ~1000 global cast presets and buries the handful the user actually
@@ -106,17 +110,23 @@ function registerVisualDnaTools(server, client, options = {}) {
       if (search) params.set('search', search);
       if (collection) params.set('collection', collection);
       if (tags) params.set('tags', tags);
+      // Always paged. Without these the ~1000-item global cast came back whole and
+      // was silently cut to the display cap, so nothing past the first screen was
+      // reachable through this tool at all.
+      params.set('page', String(page && page > 0 ? Math.floor(page) : 1));
+      params.set('limit', String(limit && limit > 0 ? Math.min(Math.floor(limit), 100) : 50));
       if (project_id) params.set('project_id', project_id);
       const qs = params.toString();
       const result = await client.get(`/v1/visual-dna${qs ? '?' + qs : ''}`);
       const dnas = result.visual_dnas || [];
+      const total = result.total != null ? result.total : (result.count || dnas.length);
       // Full profiles measured 74,310 chars — the embedded analysis/description
       // blobs are large and the model only needs enough to pick an id.
       const text = compactList(dnas, {
         fields: ['id', 'name', 'type', 'folder_id', 'tags', 'thumbnail'],
         cap: 60,
-        total: result.count || dnas.length,
-        note: 'Narrow with `search`, `tags`, or `collection`; get_visual_dna returns one in full.',
+        total,
+        note: 'Narrow with `search`, `tags`, or `collection`, or pass `page`/`limit` for the rest; get_visual_dna returns one in full.',
       });
 
       if (ui()) {
@@ -131,8 +141,8 @@ function registerVisualDnaTools(server, client, options = {}) {
             media_type: 'image',
             use_hint: 'Use Visual DNA "{TITLE}" (id: {ID}) in my next generation for character/style consistency.'
           })),
-          total: result.count || dnas.length,
-          has_more: dnas.length > 24
+          total,
+          has_more: result.has_more || dnas.length > 24
         });
       }