@ssemble/mcp-server 1.0.6 → 1.1.1

package/src/tools/list-templates.js

@@ -1,14 +1,73 @@
-import { formatTemplatesResponse, formatError } from '../utils/format.js';
+import { registerAppTool } from '@modelcontextprotocol/ext-apps/server';
+import { readFileSync } from 'fs';
+import { dirname, join } from 'path';
+import { fileURLToPath } from 'url';
+import { formatError, formatRateLimits } from '../utils/format.js';
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const THUMB_DIR = join(__dirname, '..', 'assets', 'thumbnails');
+
+function loadThumbnail(templateName) {
+  try {
+    const data = readFileSync(join(THUMB_DIR, `${templateName}.jpg`));
+    return { data: data.toString('base64'), mimeType: 'image/jpeg' };
+  } catch {
+    return null;
+  }
+}
 
 export function registerListTemplates(server, client) {
-  server.tool(
+  registerAppTool(
+    server,
     'list_templates',
-    'List all available caption style templates with IDs and names. Use the templateId when creating shorts.',
-    {},
+    {
+      title: 'List Templates',
+      description:
+        'List all available caption style templates with preview thumbnails, names, and IDs. Use the templateId when creating shorts.',
+      _meta: {
+        ui: { resourceUri: 'ui://ssemble/templates-app.html' },
+      },
+    },
     async () => {
       try {
         const result = await client.listTemplates();
-        return { content: [{ type: 'text', text: formatTemplatesResponse(result) }] };
+        const d = result.data;
+        const templates = d.templates || [];
+
+        // Text + image content for non-app clients (Claude Code, Cursor, etc.)
+        const content = [];
+        content.push({
+          type: 'text',
+          text: `## Caption Templates (${templates.length} available)\n`,
+        });
+
+        templates.forEach((t) => {
+          const isDefault = t.templateId === d.defaultTemplateId;
+          const thumb = loadThumbnail(t.name);
+          if (thumb) {
+            content.push({ type: 'image', data: thumb.data, mimeType: thumb.mimeType });
+          }
+          const label = `**${t.displayName || t.name}**${isDefault ? ' _(default)_' : ''}`;
+          content.push({ type: 'text', text: label });
+        });
+
+        let footer = `\nUse the \`templateId\` field when calling \`create_short\` to pick a style.`;
+        footer += formatRateLimits(result.rateLimits);
+        content.push({ type: 'text', text: footer });
+
+        // Structured content for the MCP App
+        const structuredContent = {
+          templates: templates.map((t) => ({
+            templateId: t.templateId,
+            name: t.name,
+            displayName: t.displayName || t.name,
+            gif: t.gif || '',
+            preview: t.preview || '',
+          })),
+          defaultTemplateId: d.defaultTemplateId,
+        };
+
+        return { content, structuredContent };
       } catch (error) {
         return { content: [{ type: 'text', text: formatError(error) }], isError: true };
       }

package/src/utils/format.js

@@ -99,23 +99,51 @@ export function formatListRequestsResponse(result) {
   }
 
   let text = `## Your Requests (Page ${p.page}/${p.totalPages}, ${p.totalCount} total)\n\n`;
-  text += `| # | Request ID | Status | Progress | Created | Duration |\n`;
-  text += `|---|-----------|--------|----------|---------|----------|\n`;
 
   requests.forEach((req, i) => {
+    const num = (p.page - 1) * p.limit + i + 1;
     const created = req.createdAt ? new Date(req.createdAt).toLocaleDateString() : 'N/A';
-    const duration = req.duration ? `${req.duration}s` : 'N/A';
-    text += `| ${(p.page - 1) * p.limit + i + 1} | \`${req.requestId}\` | ${req.status} | ${req.progress || 0}% | ${created} | ${duration} |\n`;
+    const label = req.title || req.url || req.fileUrl || 'Unknown source';
+    const short = label.length > 60 ? label.substring(0, 57) + '...' : label;
+    text += `**${num}. ${short}**\n`;
+    text += `   ID: \`${req.requestId}\` | Status: ${req.status} | Progress: ${req.progress || 0}% | Created: ${created}\n\n`;
   });
 
   if (p.totalPages > 1) {
-    text += `\nPage ${p.page} of ${p.totalPages}. Use \`page\` parameter to browse more.`;
+    text += `Page ${p.page} of ${p.totalPages}. Use \`page\` parameter to browse more.`;
   }
 
   text += formatRateLimits(result.rateLimits);
   return text;
 }
 
+/**
+ * Formats recent requests for the "no requestId given" UX.
+ * Used by get_status and get_shorts when called without a requestId.
+ * @param {Array} requests - from session store or API list_requests
+ * @param {string} tool - 'get_status' or 'get_shorts'
+ * @param {boolean} fromApi - true if coming from list_requests API (different field names)
+ */
+export function formatRecentRequests(requests, tool, fromApi = false) {
+  if (requests.length === 0) {
+    return `No recent requests found. Use \`create_short\` to create one.`;
+  }
+
+  let text = `## Your Recent Requests\n\nWhich request would you like to check?\n\n`;
+
+  requests.forEach((req, i) => {
+    const id = fromApi ? req.requestId : req.requestId;
+    const label = req.title || req.url || req.fileUrl || 'Unknown source';
+    const short = label.length > 70 ? label.substring(0, 67) + '...' : label;
+    const status = req.status || 'unknown';
+    text += `**${i + 1}. ${short}**\n`;
+    text += `   ID: \`${id}\` | Status: ${status}\n\n`;
+  });
+
+  text += `Reply with the number or paste the request ID, and I'll call \`${tool}\` for you.`;
+  return text;
+}
+
 export function formatTemplatesResponse(result) {
   const d = result.data;
   const templates = d.templates || [];
@@ -144,14 +172,18 @@ export function formatPaginatedAssets(result, assetKey, assetLabel) {
     return `No ${assetLabel} found.${formatRateLimits(result.rateLimits)}`;
   }
 
+  const hasUrl = items.some((item) => item.url);
+  const hasDuration = items[0]?.duration != null;
+
   let text = `## ${assetLabel} (Page ${p.page}/${p.totalPages}, ${p.totalCount} total)\n\n`;
-  text += `| # | Name |${items[0]?.duration != null ? ' Duration |' : ''}\n`;
-  text += `|---|------|${items[0]?.duration != null ? '----------|' : ''}\n`;
+  text += `| # | Name |${hasDuration ? ' Duration |' : ''}${hasUrl ? ' Listen |' : ''}\n`;
+  text += `|---|------|${hasDuration ? '----------|' : ''}${hasUrl ? '--------|' : ''}\n`;
 
   items.forEach((item, i) => {
     const num = (p.page - 1) * p.limit + i + 1;
-    const durationCol = item.duration != null ? ` ${item.duration}s |` : '';
-    text += `| ${num} | ${item.name} |${durationCol}\n`;
+    const durationCol = hasDuration ? ` ${Math.round(item.duration)}s |` : '';
+    const listenCol = hasUrl ? ` ${item.url ? `[▶ Play](${item.url})` : ''} |` : '';
+    text += `| ${num} | ${item.name} |${durationCol}${listenCol}\n`;
   });
 
   if (p.totalPages > 1) {

package/src/utils/session-store.js

@@ -0,0 +1,30 @@
+/**
+ * In-memory session store for request metadata.
+ * Maps requestId → { url, title, status, createdAt }
+ * Title is populated from get_shorts response once available.
+ * Lost when the MCP server process restarts (by design — use list_requests for history).
+ */
+
+const store = new Map();
+
+export function saveRequest(requestId, meta) {
+  store.set(requestId, { ...meta, savedAt: Date.now() });
+}
+
+export function updateRequest(requestId, updates) {
+  const existing = store.get(requestId);
+  if (existing) {
+    store.set(requestId, { ...existing, ...updates });
+  }
+}
+
+export function getRecentRequests(limit = 5) {
+  return [...store.entries()]
+    .sort((a, b) => b[1].savedAt - a[1].savedAt)
+    .slice(0, limit)
+    .map(([requestId, meta]) => ({ requestId, ...meta }));
+}
+
+export function hasRequests() {
+  return store.size > 0;
+}