@simpligen/mcp 0.1.3 → 0.1.4

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@simpligen/mcp",
-  "version": "0.1.3",
+  "version": "0.1.4",
   "description": "MCP server for SimpliGen -- drive local/cloud AI image & video generation from an agent.",
   "type": "module",
   "license": "MIT",

package/src/bin.js

@@ -1,4 +1,4 @@
-#!/usr/bin/env node
+#!/usr/bin/env node
 // packages/mcp-server/src/bin.js
 import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
 import { ControlApiClient } from './client.js';

package/src/client.js

@@ -74,6 +74,14 @@ export class ControlApiClient {
   listRecipes() { return this.#req('GET', '/recipes'); }
   getRecipe(id) { return this.#req('GET', `/recipes/${encodeURIComponent(id)}`); }
   publishRecipe(id, args) { return this.#req('POST', `/recipes/${encodeURIComponent(id)}/publish`, args); }
+  runRecipe(id, args) { return this.#req('POST', `/recipes/${encodeURIComponent(id)}/run`, args); }
+  listRecipeRuns(id) { return this.#req('GET', `/recipes/${encodeURIComponent(id)}/runs`); }
+  getRecipeRun(runId) { return this.#req('GET', `/recipe-runs/${encodeURIComponent(runId)}`); }
+  cancelRecipeRun(runId) { return this.#req('POST', `/recipe-runs/${encodeURIComponent(runId)}/cancel`, {}); }
+  listSubjects() { return this.#req('GET', '/subjects'); }
+  listProducts() { return this.#req('GET', '/products'); }
+  createProduct(args) { return this.#req('POST', '/products', args); }
+  removeProduct(id) { return this.#req('DELETE', `/products/${encodeURIComponent(id)}`); }
 
   async uploadFile(filePath) {
     let buf;

package/src/tools.js

@@ -14,6 +14,8 @@ export const TOOL_NAMES = [
   'generate_character_frame', 'animate_character', 'set_character_preset',
   'enhance_character_media', 'regenerate_character_base',
   'list_recipe_blocks', 'compose_recipe', 'validate_recipe', 'list_recipes', 'get_recipe', 'publish_recipe',
+  'run_recipe', 'get_recipe_run', 'wait_for_recipe_run', 'list_recipe_runs', 'cancel_recipe_run',
+  'list_subjects', 'list_products', 'create_product', 'remove_product',
 ];
 
 const ok = (data) => ({ content: [{ type: 'text', text: JSON.stringify(data, null, 2) }] });
@@ -331,7 +333,11 @@ export function registerTools(server, client) {
     name: z.string().describe('Recipe name shown to end users.'),
     description: z.string().optional(),
     category: z.string().optional().describe('e.g. product | ugc'),
-    nsfw: z.boolean().optional(),
+    mature: z.boolean().optional().describe('Creator-declared: this recipe produces adult content.'),
+    // Accepted, not for the benefit of third parties (breaking them is fine), but
+    // because an agent composing a recipe mid-transition would otherwise DROP the
+    // classification, which publishes adult content as unclassified (TASK-472).
+    nsfw: z.boolean().optional().describe('Deprecated alias for `mature`.'),
     version: z.string().optional().describe('Creator-facing semver, default 1.0.0.'),
     inputs: z.array(recipeInput).optional().describe('Extra user-facing inputs (subjects, choices, media holes). A prompt input is auto-created per step, so you rarely list prompts here.'),
     steps: z.array(recipeStep).min(1).describe('The pipeline in order. Each step pins a preset; media output flows into the next step automatically, and a subject input seeds a reference port.'),
@@ -350,9 +356,75 @@ export function registerTools(server, client) {
     wrap((args) => client.validateRecipe(args)));
 
   server.registerTool('list_recipes',
-    { title: 'List recipes', description: 'List the recipe drafts saved on this device (id, name, version, category).', inputSchema: {} },
+    { title: 'List recipes', description: 'List every recipe on this device: the ones installed from the Store into UGC Studio / Product Studio (category ugc | product) and drafts authored here. Each entry carries its `inputs` (key, kind, label, required, options) so you know what run_recipe needs: a `subject` input takes a character id from list_characters (or a product id), image/video/audio inputs take upload_file handles, text/select/number inputs take plain values.', inputSchema: {} },
     wrap(() => client.listRecipes()));
 
+  // --- Running an installed recipe (what drives the UGC + Product Studios) ---
+
+  server.registerTool('run_recipe',
+    {
+      title: 'Run a recipe',
+      description: 'Run an installed recipe (from list_recipes) with its inputs filled: the same multi-step pipeline UGC Studio / Product Studio runs when a person clicks Generate, so results land in the Gallery grouped the same way. `inputs` is keyed by input key; a subject input takes a character/product id, media inputs take upload_file handles. engine: local (default when every step is installed) | cloud | auto. Returns a runId; poll with wait_for_recipe_run or get_recipe_run. Cloud runs are priced up front and count against this agent\'s spend cap.',
+      inputSchema: {
+        id: z.string().describe('Recipe id from list_recipes'),
+        inputs: z.record(z.any()).describe('Input values keyed by the recipe\'s input keys (see list_recipes -> inputs).'),
+        engine: z.enum(['local', 'cloud', 'auto']).optional().describe('Where the steps render. auto = local if every step is installed, else cloud when connected.'),
+      },
+    },
+    wrap(({ id, inputs, engine }) => client.runRecipe(id, { inputs: inputs || {}, ...(engine ? { engine } : {}) })));
+
+  server.registerTool('get_recipe_run',
+    { title: 'Get a recipe run', description: 'Status of a recipe run: overall status (running | completed | failed | cancelled), each step with its status and resultPath, and resultPath = the final output once done.', inputSchema: { runId: z.string().describe('Run id from run_recipe') } },
+    wrap(({ runId }) => client.getRecipeRun(runId)));
+
+  server.registerTool('wait_for_recipe_run',
+    { title: 'Wait for a recipe run', description: 'Block until a recipe run completes, fails, is cancelled, or the timeout passes. Returns the final run (resultPath when completed). Multi-step video recipes can take several minutes; call again if it returns timeout_still_running.', inputSchema: { runId: z.string(), timeoutSeconds: z.number().optional(), pollMs: z.number().optional() } },
+    wrap(async ({ runId, timeoutSeconds = 600, pollMs = 3000 }) => {
+      const deadline = Date.now() + timeoutSeconds * 1000;
+      // eslint-disable-next-line no-constant-condition
+      while (true) {
+        const { run } = await client.getRecipeRun(runId);
+        if (run && ['completed', 'failed', 'cancelled'].includes(run.status)) return { run };
+        if (Date.now() >= deadline) return { run, note: 'timeout_still_running' };
+        await new Promise((r) => setTimeout(r, pollMs));
+      }
+    }));
+
+  server.registerTool('list_recipe_runs',
+    { title: 'List recipe runs', description: 'Recent runs of a recipe (newest first) with their status and results.', inputSchema: { id: z.string().describe('Recipe id') } },
+    wrap(({ id }) => client.listRecipeRuns(id)));
+
+  // --- Products + subjects: what a recipe's `subject` inputs take ---
+
+  server.registerTool('list_subjects',
+    { title: 'List subjects', description: 'Every subject a recipe\'s `subject` input can take: characters and products (id, type, name). Use a character id from list_characters or a product id from list_products / create_product.', inputSchema: {} },
+    wrap(() => client.listSubjects()));
+
+  server.registerTool('list_products',
+    { title: 'List products', description: 'The products saved on this device (a product = a named thing with a base photo, used by Product Studio and UGC recipes).', inputSchema: {} },
+    wrap(() => client.listProducts()));
+
+  server.registerTool('create_product',
+    {
+      title: 'Create a product',
+      description: 'Save a product from a photo so recipes can use it: upload the photo with upload_file first, then pass its handle. The description and category are woven into recipe prompts, so describe what it is and how it looks. Returns the productId to pass as a `subject` input in run_recipe.',
+      inputSchema: {
+        name: z.string().describe('Product name shown in the app'),
+        image: z.string().describe('upload_file handle of the product photo (clean, well-lit, product centred)'),
+        description: z.string().optional().describe('What it is and looks like, e.g. "a matte black ceramic coffee mug with a wooden lid"'),
+        category: z.string().optional().describe('e.g. skincare | beverage | electronics'),
+      },
+    },
+    wrap(({ name, image, description, category }) => client.createProduct({ name, image, description, category })));
+
+  server.registerTool('remove_product',
+    { title: 'Remove a product', description: 'Delete a product and its photo from this device.', inputSchema: { id: z.string() } },
+    wrap(({ id }) => client.removeProduct(id)));
+
+  server.registerTool('cancel_recipe_run',
+    { title: 'Cancel a recipe run', description: 'Stop a running recipe: no further steps start; a local in-flight step is interrupted (a cloud step already running finishes server-side and is saved).', inputSchema: { runId: z.string() } },
+    wrap(({ runId }) => client.cancelRecipeRun(runId)));
+
   server.registerTool('get_recipe',
     { title: 'Get a recipe', description: 'Get a saved recipe and its full config by id.', inputSchema: { id: z.string().describe('Recipe id from compose_recipe or list_recipes') } },
     wrap(({ id }) => client.getRecipe(id)));