@call-me-sensei/toonlab 0.4.19 → 0.4.21

package/mcp/public-catalog.mjs

@@ -25,62 +25,14 @@ function entry(input) {
   });
 }
 
-const CURATED_PLANT_RECIPES = Object.freeze([
-  entry({
-    cluster: 'vegetation',
-    description: 'Mid-size broadleaf starting recipe for anime environments.',
-    id: 'tree/broadleaf/sensei',
-    kind: 'recipe',
-    label: 'Sensei broadleaf',
-    recipe: {
-      options: { seed: 3, size: 3.2 },
-      schema: 'treeRecipe',
-      type: 'tree',
-      version: 1,
-    },
-    spawn: 'createPlantFromRecipe(entry.recipe)',
-    tags: ['tree', 'vegetation', 'anime'],
-    thumbnail: thumbnailFor('tree/broadleaf/sensei'),
-  }),
-  entry({
-    cluster: 'vegetation',
-    description: 'Ground-hugging foliage mass for yards and path edges.',
-    id: 'tree/bush/hedge',
-    kind: 'recipe',
-    label: 'Hedge bush',
-    recipe: {
-      options: { seed: 5, size: 1.2 },
-      schema: 'treeRecipe',
-      type: 'bush',
-      version: 1,
-    },
-    spawn: 'createPlantFromRecipe(entry.recipe)',
-    tags: ['bush', 'vegetation', 'anime'],
-    thumbnail: thumbnailFor('tree/bush/hedge'),
-  }),
-  entry({
-    cluster: 'vegetation',
-    description: 'Flowering plant with daisy heads.',
-    id: 'tree/flower/daisy',
-    kind: 'recipe',
-    label: 'Daisy flower',
-    recipe: {
-      options: { seed: 9, size: 0.5, species: 'daisy' },
-      schema: 'treeRecipe',
-      type: 'flower',
-      version: 1,
-    },
-    spawn: 'createPlantFromRecipe(entry.recipe)',
-    tags: ['flower', 'vegetation', 'anime'],
-    thumbnail: thumbnailFor('tree/flower/daisy'),
-  }),
-]);
-
 let cached = null;
 
 export function publicMcpCatalogEntries() {
   if (cached) return cached;
-  const entries = [...CURATED_PLANT_RECIPES];
+  // Authored vegetation recipes are Gallery assets, not package built-ins.
+  // The packaged MCP discovers them from the public Gallery so provenance,
+  // license, review state, and immutable documents stay attached.
+  const entries = [];
 
   for (const option of getRockgenPresetOptions()) {
     const id = `rock/${slug(option.value)}`;

package/mcp/server.mjs

@@ -82,6 +82,8 @@ const SERVER_NAME = 'toonlab-oss';
 const SERVER_VERSION = JSON.parse(
   readFileSync(new URL('../package.json', import.meta.url), 'utf8'),
 ).version;
+const PUBLIC_GALLERY_ENDPOINT = process.env.TOONLAB_PUBLIC_GALLERY_URL
+  ?? 'https://toonlab.io/api/v1/creations';
 const LATEST_PROTOCOL_VERSION = '2025-11-25';
 const SUPPORTED_PROTOCOL_VERSIONS = new Set([
   LATEST_PROTOCOL_VERSION,
@@ -103,7 +105,9 @@ function parseArguments(argv) {
 }
 
 const { workspace } = parseArguments(process.argv.slice(2));
-const legacyWorkspace = process.env.TOONLAB_LEGACY_WORKSPACE === '1';
+const legacyWorkspaceMode = process.env.TOONLAB_LEGACY_WORKSPACE;
+const legacyWorkspace = legacyWorkspaceMode === '1'
+  || (legacyWorkspaceMode !== '0' && !process.env.DATABASE_URL);
 
 async function getWorkspaceInfo() {
   if (legacyWorkspace) return getLegacyWorkspaceInfo(workspace);
@@ -287,6 +291,112 @@ function normalizeDiscovery(entry, summary, { domain = '', policy = null } = {})
   };
 }
 
+function publicGalleryUrl(path = '') {
+  let endpoint;
+  try {
+    endpoint = new URL(PUBLIC_GALLERY_ENDPOINT);
+  } catch {
+    throw new Error('TOONLAB_PUBLIC_GALLERY_URL must be an absolute HTTP(S) URL.');
+  }
+  if (!['http:', 'https:'].includes(endpoint.protocol)) {
+    throw new Error('TOONLAB_PUBLIC_GALLERY_URL must use HTTP(S).');
+  }
+  endpoint.search = '';
+  endpoint.hash = '';
+  if (!path) return endpoint;
+  endpoint.pathname = `${endpoint.pathname.replace(/\/$/u, '')}/${encodeURIComponent(path)}`;
+  return endpoint;
+}
+
+function absoluteGalleryReference(reference) {
+  if (typeof reference !== 'string' || !reference.trim()) return null;
+  return new URL(reference, publicGalleryUrl()).href;
+}
+
+async function fetchPublicGalleryJson(url) {
+  let response;
+  try {
+    response = await fetch(url, {
+      headers: { accept: 'application/json' },
+      signal: AbortSignal.timeout(15_000),
+    });
+  } catch (cause) {
+    throw new Error(`ToonLab public Gallery request failed: ${cause?.message ?? String(cause)}`);
+  }
+  if (!response.ok) {
+    throw new Error(`ToonLab public Gallery returned HTTP ${response.status}.`);
+  }
+  try {
+    return await response.json();
+  } catch {
+    throw new Error('ToonLab public Gallery returned invalid JSON.');
+  }
+}
+
+function normalizePublicGalleryItem(item, args = {}) {
+  const id = String(item?.id ?? '').trim();
+  if (!id) throw new Error('ToonLab public Gallery returned an item without an id.');
+  const type = String(item.type ?? 'creation');
+  const entry = {
+    attribution: item.attribution ?? null,
+    author: item.author ?? null,
+    cluster: type,
+    description: item.description ?? null,
+    documentUrl: absoluteGalleryReference(item.download ?? item.documentUrl),
+    id,
+    kind: type,
+    label: String(item.label ?? id),
+    license: item.license ?? null,
+    source: 'gallery',
+    sourceClass: 'toonlab-gallery',
+    tags: Array.isArray(item.tags) ? item.tags.map(String) : [],
+    thumbnail: absoluteGalleryReference(item.thumbnail),
+    updatedAt: item.updated_at ?? null,
+    url: absoluteGalleryReference(item.url ?? `/c/${item.slug ?? id}`),
+  };
+  return normalizeDiscovery(entry, entry, args);
+}
+
+async function searchPublicGallery(args = {}) {
+  const limit = limitValue(args.limit, 20, 60);
+  const offset = Math.max(0, Math.floor(Number(args.offset) || 0));
+  const endpoint = publicGalleryUrl();
+  endpoint.searchParams.set('limit', String(limit));
+  endpoint.searchParams.set('offset', String(offset));
+  if (String(args.query ?? '').trim()) endpoint.searchParams.set('q', String(args.query).trim());
+  if (String(args.type ?? '').trim()) endpoint.searchParams.set('type', String(args.type).trim());
+  const response = await fetchPublicGalleryJson(endpoint);
+  if (!Array.isArray(response?.items)) {
+    throw new Error('ToonLab public Gallery response is missing items.');
+  }
+  const items = response.items.map((item) => normalizePublicGalleryItem(item, args));
+  return {
+    count: items.length,
+    items,
+    limit,
+    nextOffset: items.length === limit ? offset + items.length : null,
+    offset,
+    source: 'toonlab-public-gallery',
+  };
+}
+
+async function getPublicGalleryAsset(args = {}) {
+  const id = String(args.id ?? '').trim();
+  if (!id) throw new Error('A public Gallery asset id or slug is required.');
+  const item = await fetchPublicGalleryJson(publicGalleryUrl(id));
+  const normalized = normalizePublicGalleryItem({
+    ...item,
+    download: item.documentUrl ?? null,
+    thumbnail: item.thumbnail ?? null,
+    url: item.url ?? `/c/${item.slug ?? id}`,
+  }, args);
+  return {
+    ...normalized,
+    document: item.document ?? null,
+    files: Array.isArray(item.files) ? item.files : [],
+  };
+}
+
 function summarizeCatalogEntry(entry) {
   const metadata = entry.metadata && typeof entry.metadata === 'object' && !Array.isArray(entry.metadata)
     ? entry.metadata
@@ -987,7 +1097,7 @@ const TOOLS = [
   },
   {
     annotations: { readOnlyHint: true },
-    description: 'Search built-in procedural assets, the paginated complete official Gallery catalog, saved library entries, lab presets, and files on disk. Official rock summaries include compact dimensions and taxonomy metadata; follow nextOffset until null.',
+    description: 'Search approved built-in generator/settings entries, the local released official catalog, saved library entries, lab presets, and files on disk. Official rock summaries include compact dimensions and taxonomy metadata; follow nextOffset until null.',
     inputSchema: {
       additionalProperties: false,
       properties: {
@@ -1006,6 +1116,40 @@ const TOOLS = [
     name: 'search_assets',
     title: 'Search ToonLab assets',
   },
+  {
+    annotations: { openWorldHint: true, readOnlyHint: true },
+    description: 'Search public ToonLab Gallery creations with their license, attribution, tags, thumbnail, and immutable portable-document URL. Authored tree recipes live here rather than in npm; use type="tree-recipe" and follow nextOffset until null.',
+    inputSchema: {
+      additionalProperties: false,
+      properties: {
+        domain: { type: 'string' },
+        limit: { maximum: 60, minimum: 1, type: 'integer' },
+        offset: { minimum: 0, type: 'integer' },
+        policy: { type: 'object' },
+        query: { type: 'string' },
+        type: { type: 'string' },
+      },
+      type: 'object',
+    },
+    name: 'search_public_gallery',
+    title: 'Search the ToonLab public Gallery',
+  },
+  {
+    annotations: { openWorldHint: true, readOnlyHint: true },
+    description: 'Get one public ToonLab Gallery creation by publication id or slug, including its complete portable document and immutable public files.',
+    inputSchema: {
+      additionalProperties: false,
+      properties: {
+        domain: { type: 'string' },
+        id: { type: 'string' },
+        policy: { type: 'object' },
+      },
+      required: ['id'],
+      type: 'object',
+    },
+    name: 'get_public_gallery_asset',
+    title: 'Get a ToonLab public Gallery asset',
+  },
   {
     annotations: { readOnlyHint: true },
     description: 'Get a complete asset, recipe, preset, library entry, or workspace file descriptor by id.',
@@ -1202,7 +1346,7 @@ const TOOLS = [
   },
   {
     annotations: { destructiveHint: false, idempotentHint: false, openWorldHint: true },
-    description: 'Start local managed image/3D generation with user-configured provider keys. Meshy 7 supports image/multiview-to-3D; text_to_model + Meshy first creates a concept image with image_model, then submits that PNG/JPEG to Meshy as one trackable job.',
+    description: 'Start local managed image, Fal Patina PBR material, or 3D generation with user-configured provider keys. Material jobs preserve the seamless preview and typed PBR maps as one durable local bundle.',
     inputSchema: {
       additionalProperties: false,
       properties: {
@@ -1210,12 +1354,27 @@ const TOOLS = [
         domain: { maxLength: 120, minLength: 1, type: 'string' },
         gap_id: { description: 'ID returned by record_asset_gap.', minLength: 1, type: 'string' },
         image_model: { enum: ['nano-banana-2-lite', 'nano-banana-2', 'nano-banana-pro'], type: 'string' },
-        kind: { enum: ['image', 'texture_image', 'concept_image', 'text_to_model', 'image_to_model', 'multiview_to_model', 'model_segment'], type: 'string' },
+        kind: { enum: ['image', 'texture_image', 'concept_image', 'material', 'text_to_model', 'image_to_model', 'multiview_to_model', 'model_segment'], type: 'string' },
         model_provider: { default: 'meshy', enum: ['meshy', 'tripo'], type: 'string' },
         policy: { description: 'Developer-approved asset-sourcing policy.', type: 'object' },
         prompt: { maxLength: 600, type: 'string' },
         reference_paths: { items: { type: 'string' }, maxItems: 6, type: 'array' },
-        resolution: { default: '1k', enum: ['1k', '2k', '4k'], type: 'string' },
+        resolution: { default: '1k', enum: ['1k', '2k', '4k', '8k'], type: 'string' },
+        maps: { description: 'material only; empty skips PBR estimation.', items: { enum: ['basecolor', 'normal', 'roughness', 'metalness', 'height'], type: 'string' }, maxItems: 5, type: 'array' },
+        image_size: { description: 'material only; a Patina preset or {width,height}.', oneOf: [{ enum: ['square_hd', 'square', 'portrait_4_3', 'portrait_16_9', 'landscape_4_3', 'landscape_16_9'], type: 'string' }, { additionalProperties: false, properties: { width: { maximum: 2048, minimum: 256, type: 'integer' }, height: { maximum: 2048, minimum: 256, type: 'integer' } }, required: ['width', 'height'], type: 'object' }] },
+        upscale_factor: { enum: [0, 2, 4], type: 'integer' },
+        tiling_mode: { enum: ['both', 'horizontal', 'vertical'], type: 'string' },
+        output_format: { enum: ['png', 'jpeg', 'webp'], type: 'string' },
+        num_images: { maximum: 4, minimum: 1, type: 'integer' },
+        num_inference_steps: { maximum: 8, minimum: 1, type: 'integer' },
+        enable_prompt_expansion: { type: 'boolean' },
+        enable_safety_checker: { type: 'boolean' },
+        tile_size: { maximum: 256, minimum: 32, type: 'integer' },
+        tile_stride: { maximum: 128, minimum: 16, type: 'integer' },
+        seed: { type: 'integer' },
+        image_url: { description: 'material only; public HTTPS source texture.', format: 'uri', type: 'string' },
+        mask_url: { description: 'material only; public HTTPS inpainting mask. Requires image_url.', format: 'uri', type: 'string' },
+        strength: { maximum: 1, minimum: 0, type: 'number' },
         source_image_path: { description: 'Workspace object path for image_to_model.', type: 'string' },
         source_job_id: { description: 'Succeeded image job for image_to_model, or Tripo model job for model_segment.', type: 'string' },
         style: { default: 'stylized', enum: ['stylized', 'cartoon', 'raw'], type: 'string' },
@@ -1225,7 +1384,7 @@ const TOOLS = [
       type: 'object',
     },
     name: 'generate_ai_asset',
-    title: 'Generate an image or 3D asset with local provider keys',
+    title: 'Generate an image, PBR material, or 3D asset with local provider keys',
   },
   {
     annotations: { readOnlyHint: true, openWorldHint: true },
@@ -1257,7 +1416,7 @@ const TOOLS = [
   },
   {
     annotations: { destructiveHint: false, idempotentHint: true },
-    description: 'Save a succeeded local 3D generation job into the editable ToonLab library with its provider provenance and local model file.',
+    description: 'Save a succeeded local 3D model or PBR material job into the editable ToonLab library with provider provenance and durable local files.',
     inputSchema: {
       additionalProperties: false,
       properties: { job_id: { type: 'string' }, label: { maxLength: 120, type: 'string' } },
@@ -1265,7 +1424,7 @@ const TOOLS = [
       type: 'object',
     },
     name: 'save_generated_asset',
-    title: 'Save a generated 3D asset',
+    title: 'Save a generated model or material',
   },
   {
     annotations: { openWorldHint: true, readOnlyHint: true },
@@ -1398,6 +1557,8 @@ async function callTool(name, args = {}) {
     case 'get_lab_features': return getLabFeatures(args.lab);
     case 'create_lab_document': return createLabDocumentTool(args);
     case 'search_assets': return searchAssets(args);
+    case 'search_public_gallery': return searchPublicGallery(args);
+    case 'get_public_gallery_asset': return getPublicGalleryAsset(args);
     case 'get_asset': return getAsset(args);
     case 'list_my_creations': return listMyCreations(args);
     case 'get_my_creation': return getMyCreation(args);
@@ -1423,8 +1584,8 @@ async function callTool(name, args = {}) {
         policyDecision,
         pollAfterMs: 5_000,
         next: job.status === 'running'
-          ? 'Poll get_generation_job until succeeded, failed, or cancelled; then pass a succeeded 3D job to save_generated_asset.'
-          : 'The provider completed inline. Save a succeeded 3D job with save_generated_asset.',
+          ? 'Poll get_generation_job until succeeded, failed, or cancelled; then save a succeeded model or material job if it belongs in the Library.'
+          : 'The provider completed inline. Save a succeeded model or material job if it belongs in the Library.',
       };
     }
     case 'get_generation_job': {
@@ -1461,13 +1622,15 @@ async function callTool(name, args = {}) {
     case 'get_generation_capabilities': return {
       managedLocal: {
         ...providerConfiguration(),
-        kinds: ['image', 'texture_image', 'concept_image', 'text_to_model', 'image_to_model', 'multiview_to_model', 'model_segment'],
+        kinds: ['image', 'texture_image', 'concept_image', 'material', 'text_to_model', 'image_to_model', 'multiview_to_model', 'model_segment'],
+        patinaMaterialFlow: 'prompt or source image -> seamless preview + typed PBR map bundle (1k-8k)',
         meshyTextFlow: 'selected image_model concept_image -> meshy-7 image_to_model',
         tools: ['generate_ai_asset', 'get_generation_job', 'get_generation_jobs', 'save_generated_asset'],
       },
       available: [
         'Generate deterministic recipes from the stable public ToonLab catalog entries.',
         'Save and retrieve editable lab documents through the shared .toonlab workspace.',
+        'Search and retrieve authored public Gallery recipes with license and provenance.',
         'Search and import CC0 assets from Poly Haven and ambientCG.',
         'Use each recipe\'s spawn snippet to integrate it into a Three.js project.',
       ],
@@ -1518,7 +1681,7 @@ async function handleRequest(message) {
       jsonrpc: '2.0',
       result: {
         capabilities: { resources: {}, tools: {} },
-        instructions: 'ToonLab builds anime-style games, characters, and environments for Three.js. Call list_live_labs and get_lab_features when authoring a Lab artifact, use create_lab_document for a valid starter, and prefer mutate_lab_creation over hand-editing structural arrays. Official Rock details include a source-GLB starter. This OSS server may edit any non-secret creation or lab-state entry in its local workspace; deletions require explicit confirmation. Load the selected style bundle first. If no asset-sourcing policy exists, ask the developer, then continue with library-first advisory discovery while recording the unresolved decision. Search the project and ToonLab libraries before public sources; generate or hand-author only when policy permits. Validate every candidate, preserve provenance, evaluate anime-fit in scene, and record a gap before adding a custom shader, texture, model, or adapter. When local provider keys are configured, generate_ai_asset exposes image generation, Meshy 7 image/multiview-to-3D, and Text -> selected image model -> Meshy 7 through MCP.',
+        instructions: 'ToonLab builds anime-style games, characters, and environments for Three.js. Call list_live_labs and get_lab_features when authoring a Lab artifact, use create_lab_document for a valid starter, and prefer mutate_lab_creation over hand-editing structural arrays. Official Rock details include a source-GLB starter. This OSS server may edit any non-secret creation or lab-state entry in its local workspace; deletions require explicit confirmation. Load the selected style bundle first. If no asset-sourcing policy exists, ask the developer, then continue with library-first advisory discovery while recording the unresolved decision. Search the project and local library first, then search_public_gallery for reviewed authored assets such as tree recipes, before external sources. Generate or hand-author only when policy permits. Validate every candidate, preserve provenance, evaluate anime-fit in scene, and record a gap before adding a custom shader, texture, model, or adapter. When local provider keys are configured, generate_ai_asset exposes image generation, Meshy 7 image/multiview-to-3D, and Text -> selected image model -> Meshy 7 through MCP.',
         protocolVersion: SUPPORTED_PROTOCOL_VERSIONS.has(requested) ? requested : LATEST_PROTOCOL_VERSION,
         serverInfo: { name: SERVER_NAME, version: SERVER_VERSION },
       },

package/mcp/vite-plugin.mjs

@@ -3,6 +3,7 @@ import { join, resolve } from 'node:path';
 import { readWorkspaceFile, resolveWorkspacePath } from './workspace.mjs';
 import {
   clearLabState,
+  annotateCreationRevision,
   cancelGenerationJob,
   createGenerationJob,
   databaseInfo,
@@ -11,14 +12,19 @@ import {
   hasLegacyImport,
   finishGenerationJob,
   getCatalogAsset,
+  getCreationRevision,
   getGenerationJob,
   listCatalogAssets,
+  listCatalogFacets,
   listGenerationJobs,
+  listCreationRevisions,
   listLibraryEntries,
   migrateLegacy,
   providerConfiguration,
   readLabState,
   readObject,
+  resolveStyleBundleEntry,
+  restoreCreationRevision,
   saveLibraryEntry,
   saveObject,
   setLabState,
@@ -30,6 +36,7 @@ import {
   pollTripoTask,
   runProvider,
 } from '../database/providers.mjs';
+import { storeManagedMaterial } from '../database/generation-service.mjs';
 
 const JSON_LIMIT = 8 * 1024 * 1024;
 const FILE_LIMIT = 128 * 1024 * 1024;
@@ -97,6 +104,17 @@ function clientJob(job) {
         ...job.result,
         ...(job.result.file ? { file: clientFile(job.result.file) } : {}),
         ...(job.result.previewFile ? { previewFile: clientFile(job.result.previewFile) } : {}),
+        ...(job.result.materialBundle ? {
+          materialBundle: {
+            ...job.result.materialBundle,
+            manifestFile: clientFile(job.result.materialBundle.manifestFile),
+            variants: (job.result.materialBundle.variants ?? []).map((variant) => ({
+              ...variant,
+              preview: clientFile(variant.preview),
+              maps: Object.fromEntries(Object.entries(variant.maps ?? {}).map(([key, file]) => [key, clientFile(file)])),
+            })),
+          },
+        } : {}),
       }
     : job.result;
   return {
@@ -125,17 +143,18 @@ export function toonlabWorkspacePlugin({ rootDirectory = process.cwd(), workspac
   async function runGeneration(body) {
     const provider = String(body.provider ?? '');
     const kind = String(body.kind ?? '');
-    if (!['ark', 'gemini', 'meshy', 'openai', 'tripo'].includes(provider)) {
+    if (!['ark', 'fal', 'gemini', 'meshy', 'openai', 'tripo'].includes(provider)) {
       throw Object.assign(new Error('Unsupported provider.'), { statusCode: 400 });
     }
     const imageKinds = new Set(['image', 'texture_image', 'concept_image']);
+    const materialKinds = new Set(['material']);
     const modelKinds = new Set([
       'text_to_model',
       'image_to_model',
       'multiview_to_model',
       'model_segment',
     ]);
-    if (!imageKinds.has(kind) && !modelKinds.has(kind)) {
+    if (!imageKinds.has(kind) && !modelKinds.has(kind) && !materialKinds.has(kind)) {
       throw Object.assign(new Error('Unsupported generation kind.'), { statusCode: 400 });
     }
     const providerKinds = {
@@ -148,6 +167,9 @@ export function toonlabWorkspacePlugin({ rootDirectory = process.cwd(), workspac
     if (imageKinds.has(kind) && provider !== 'gemini') {
       throw Object.assign(new Error('OSS image generation currently supports Gemini only.'), { statusCode: 400 });
     }
+    if (materialKinds.has(kind) && provider !== 'fal') {
+      throw Object.assign(new Error('PBR material generation requires Fal Patina.'), { statusCode: 400 });
+    }
     const requestBody = body.request && typeof body.request === 'object'
       ? body.request
       : {};
@@ -213,6 +235,14 @@ export function toonlabWorkspacePlugin({ rootDirectory = process.cwd(), workspac
           status: 200,
         };
       }
+      if (result.material) {
+        return {
+          job: clientJob(await finishGenerationJob(job.id, {
+            result: await storeManagedMaterial(workspacePath, job.id, result),
+          })),
+          status: 200,
+        };
+      }
       return {
         job: clientJob(await finishGenerationJob(job.id, { result })),
         status: 200,
@@ -411,13 +441,20 @@ export function toonlabWorkspacePlugin({ rootDirectory = process.cwd(), workspac
         if (request.method !== 'GET') return methodNotAllowed(response, ['GET']);
         return sendJson(response, 200, await listCatalogAssets({
           kind: url.searchParams.get('kind') ?? '',
+          license: url.searchParams.get('license') ?? '',
           limit: url.searchParams.get('limit') ?? 60,
           offset: url.searchParams.get('offset') ?? 0,
           q: url.searchParams.get('q') ?? '',
+          size: url.searchParams.get('size') ?? '',
           source: url.searchParams.get('source') ?? '',
         }));
       }
 
+      if (url.pathname === '/api/toonlab/catalog-facets') {
+        if (request.method !== 'GET') return methodNotAllowed(response, ['GET']);
+        return sendJson(response, 200, await listCatalogFacets());
+      }
+
       if (url.pathname.startsWith('/api/toonlab/catalog/')) {
         if (request.method !== 'GET') return methodNotAllowed(response, ['GET']);
         const id = decodeURIComponent(url.pathname.slice('/api/toonlab/catalog/'.length));
@@ -513,6 +550,45 @@ export function toonlabWorkspacePlugin({ rootDirectory = process.cwd(), workspac
       }
 
       if (url.pathname.startsWith('/api/toonlab/library/')) {
+        const resolvedMatch = url.pathname.match(/^\/api\/toonlab\/library\/([^/]+)\/resolved$/);
+        if (resolvedMatch) {
+          if (request.method !== 'GET') return methodNotAllowed(response, ['GET']);
+          return sendJson(response, 200, {
+            bundle: await resolveStyleBundleEntry(decodeURIComponent(resolvedMatch[1])),
+          });
+        }
+        const revisionMatch = url.pathname.match(/^\/api\/toonlab\/library\/([^/]+)\/revisions(?:\/([^/]+))?(?:\/(restore))?$/);
+        if (revisionMatch) {
+          const creationId = decodeURIComponent(revisionMatch[1]);
+          const revisionId = revisionMatch[2] ? decodeURIComponent(revisionMatch[2]) : null;
+          if (!revisionId && request.method === 'GET') {
+            const history = await listCreationRevisions(creationId, {
+              limit: url.searchParams.get('limit'),
+              offset: url.searchParams.get('offset'),
+            });
+            return sendJson(response, 200, history);
+          }
+          if (revisionId && !revisionMatch[3] && request.method === 'GET') {
+            return sendJson(response, 200, {
+              revision: await getCreationRevision(creationId, revisionId),
+            });
+          }
+          if (revisionId && revisionMatch[3] === 'restore' && request.method === 'POST') {
+            return sendJson(response, 200, {
+              entry: await restoreCreationRevision(creationId, revisionId),
+            });
+          }
+          if (revisionId && !revisionMatch[3] && request.method === 'PATCH') {
+            return sendJson(response, 200, {
+              revision: await annotateCreationRevision(
+                creationId,
+                revisionId,
+                await readJsonBody(request),
+              ),
+            });
+          }
+          return methodNotAllowed(response, revisionId ? ['GET', 'PATCH', 'POST'] : ['GET']);
+        }
         const id = decodeURIComponent(url.pathname.slice('/api/toonlab/library/'.length));
         if (request.method === 'PUT') {
           const entry = await readJsonBody(request);