@contenthero/mcp 0.3.4 → 0.3.6

package/dist/server.js

@@ -13,8 +13,7 @@
  *   list_brand_kits / get_brand_kit - the account's brand kits (full brand context)
  *   list_media / get_media    - the account's studio outputs (+ per-variation ids)
  *   search_media              - semantic search of the editable media library (with scene timestamps)
- *   get_generation_status - poll an image/video outputId to its final URLs
- *   wait_for_generation - block until one or more outputIds finish (batch)
+ *   get_generation_status - check 1-8 outputIds; blocks until terminal by default
  *   get_balance       - credit balance + tier
  *   ... plus the content-pipeline, brand-kit-write, inspiration, brand-account,
  *   and connected-account tools.
@@ -38,7 +37,7 @@ import { z } from 'zod';
 import { GenerationTimeoutError, pendingOutputId, } from '@contenthero/sdk';
 import { getClient as defaultGetClient } from './client.js';
 import { resolveModelEnums, BOARD_TYPES, BOARD_TYPE_GUIDANCE, IMAGE_MODEL_GUIDANCE, VIDEO_MODEL_GUIDANCE, AUDIO_MODEL_GUIDANCE, EDIT_AUDIO_MODEL_GUIDANCE, UPSCALE_MODEL_GUIDANCE, LIP_SYNC_MODEL_GUIDANCE, } from './models.js';
-import { assetResult, audioResult, avatarListResult, avatarResult, balanceResult, brandKitListResult, brandKitResult, brandKitSectionResult, brandKnowledgeListResult, brandKnowledgeDetailResult, brandKnowledgeSearchResult, brandKnowledgeItemResult, brandPerformanceResult, completedResult, connectedAccountListResult, connectedAccountResult, costResult, destinationResult, inspirationAccountResult, inspirationContentResult, mediaListResult, mediaSearchResult, folderListResult, folderContentsResult, mediaBatchResult, mediaUploadResult, uploadedMediaResult, assetOrderResult, assetRemovedResult, destinationRemovedResult, tagListResult, tagResult, tagDeletedResult, modelListResult, modelResult, platformListResult, platformResult, elementListResult, elementResult, elementDeletedResult, errorResult, generationBatchResult, generationStatusResult, outlierListResult, enhanceClipsResult, pendingResult, pipelineStageListResult, postListResult, postResult, postSummaryResult, publishResult, statusActionResult, editorOpsResult, text, projectDetailResult, liveContextResult, projectListResult, projectCreatedResult, projectDeletedResult, layerTypesResult, timelineTypesResult, editorTranscriptResult, exportJobResult, exportFormatsResult, trackedAccountListResult, transcriptResult, voiceListResult, voiceResult, } from './format.js';
+import { audioResult, avatarListResult, avatarResult, balanceResult, brandKitListResult, brandKitResult, brandKnowledgeListResult, brandKnowledgeDetailResult, brandKnowledgeSearchResult, brandKnowledgeItemResult, completedResult, connectedAccountListResult, connectedAccountResult, costResult, accountDetailResult, inspirationContentResult, mediaListResult, mediaSearchResult, folderListResult, folderContentsResult, mediaBatchResult, mediaUploadResult, uploadedMediaResult, tagListResult, tagResult, tagDeletedResult, modelListResult, modelResult, platformListResult, platformResult, elementListResult, elementResult, elementDeletedResult, errorResult, generationBatchResult, outlierListResult, enhanceClipsResult, pendingResult, pipelineStageListResult, postListResult, postResult, postSummaryResult, publishResult, statusActionResult, editorOpsResult, text, projectDetailResult, liveContextResult, projectListResult, projectCreatedResult, projectDeletedResult, layerTypesResult, timelineTypesResult, editorTranscriptResult, exportJobResult, exportFormatsResult, trackedAccountListResult, transcriptResult, voiceListResult, voiceResult, } from './format.js';
 /** Platforms a post or destination may target. */
 const POST_PLATFORMS = [
     'youtube',
@@ -753,7 +752,7 @@ export function registerTools(server, opts) {
     server.registerTool('create_brand_kit', {
         title: 'Create Brand Kit',
         annotations: WRITE,
-        description: "Create a brand kit. THREE SOURCES, chosen by what you pass: (1) EMPTY, just a name, then fill it in with update_brand_kit; (2) FROM A WEBSITE, pass websiteUrl + extract:true and ContentHero scrapes that site and fills in business name, positioning, voice, colours, typography, logos and assets by itself, which is by far the fastest way to get a real kit; (3) A COPY, pass duplicateFrom with an existing kit id, which copies its sections and brand media (assets re-link rather than duplicate, so a copy costs no storage). With extract it RETURNS IMMEDIATELY, before the kit has any content: that empty kit is the handle, and the fields fill in over the next minute or two, so poll extractionStatus with get_brand_kit rather than assuming it failed. name is OPTIONAL when websiteUrl is given (it defaults to the site's hostname until extraction finds the real business name). Brand kits are capped by plan, so this fails with a limit error near the cap, and a duplicate counts against it like any other kit. Requires the brandkit:write scope.",
+        description: "Create a brand kit. THREE SOURCES, chosen by what you pass: (1) EMPTY, just a name, then fill it in with update_brand_kit; (2) FROM A WEBSITE, pass websiteUrl + extract:true and ContentHero scrapes that site and fills in business name, positioning, voice, colours, typography, logos and assets by itself, which is by far the fastest way to get a real kit; (3) A COPY, pass duplicateFrom with an existing kit id, which copies its sections and brand media (assets re-link rather than duplicate, so a copy costs no storage). A brand with NO WEBSITE (so nothing to extract) is built by passing its fields directly, including logos, whose entries may name outputId to bring in a generation you just made rather than a url. With extract it RETURNS IMMEDIATELY, before the kit has any content: that empty kit is the handle, and the fields fill in over the next minute or two, so poll extractionStatus with get_brand_kit rather than assuming it failed. name is OPTIONAL when websiteUrl is given (it defaults to the site's hostname until extraction finds the real business name). Brand kits are capped by plan, so this fails with a limit error near the cap, and a duplicate counts against it like any other kit. Requires the brandkit:write scope.",
         inputSchema: {
             name: z.string().optional().describe("The kit's name. Optional when websiteUrl is given."),
             websiteUrl: z.string().optional().describe('The business website. Required to use extract.'),
@@ -771,6 +770,20 @@ export function registerTools(server, opts) {
             visualStyle: z.string().optional(),
             designPrinciples: z.array(z.string()).optional(),
             contentStrategy: z.record(z.string(), z.unknown()).optional().describe('Content strategy object (free-form).'),
+            logos: z.array(z.unknown()).optional().describe("The kit's logos, each { url | outputId, name?, is_primary?, layout?, colorMode? }. Use outputId to bring in a generation."),
+            assets: z.array(z.unknown()).optional().describe("The kit's brand assets, each { url | outputId, name? }."),
+            sections: z
+                .array(z.unknown())
+                .optional()
+                .describe("The kit's curated sections, each { tab, sectionName, sortOrder?, fields? }. Array position is the default order."),
+            brandAccounts: z
+                .array(z.unknown())
+                .optional()
+                .describe("The account owner's OWN profiles. A tracked-account id, or { platform?, handleOrUrl } to ADD one and start ingesting it."),
+            inspirationAccounts: z
+                .array(z.unknown())
+                .optional()
+                .describe('Competitor/creator profiles they watch. Same entry shape as brandAccounts.'),
         },
     }, async (args, extra) => {
         try {
@@ -781,7 +794,15 @@ export function registerTools(server, opts) {
             if (args.extract && !args.websiteUrl) {
                 return errorResult(new Error('create_brand_kit: extract requires a websiteUrl to scrape.'));
             }
-            const { brandKit, extraction } = await client.createBrandKit(args);
+            const { logos, assets, sections, brandAccounts, inspirationAccounts, ...rest } = args;
+            const { brandKit, extraction } = await client.createBrandKit({
+                ...rest,
+                ...(logos !== undefined ? { logos } : {}),
+                ...(assets !== undefined ? { assets } : {}),
+                ...(sections !== undefined ? { sections: sections } : {}),
+                ...(brandAccounts !== undefined ? { brandAccounts: brandAccounts } : {}),
+                ...(inspirationAccounts !== undefined ? { inspirationAccounts: inspirationAccounts } : {}),
+            });
             return brandKitResult(brandKit, extraction);
         }
         catch (err) {
@@ -792,7 +813,7 @@ export function registerTools(server, opts) {
     server.registerTool('update_brand_kit', {
         title: 'Update Brand Kit',
         annotations: WRITE,
-        description: "Update a brand kit: identity fields (business name, positioning, audience, voice profile, visual style, content strategy), its brand media, which kit is the DEFAULT, and which tracked accounts it is LINKED to. Only the fields you pass change. Get the current kit first with get_brand_kit. Requires the brandkit:write scope. THREE MODES, chosen by what you pass: (1) pass brandKitId to patch one kit; (2) pass orderedIds ALONE to reorder the whole set, which is collection-level because ordering is a property of the set and a per-kit position would let two kits claim one slot, so pass every id in the order you want; (3) pass brandKitId + extract:true to RE-RUN website extraction, which returns immediately and fills the kit in the background from its websiteUrl (poll extractionStatus via get_brand_kit). logos/assets/brandAccountIds/inspirationAccountIds are DECLARATIVE: a patch REPLACES the whole list, so pass the full set and use [] to clear. brandAccountIds are the account owner's OWN profiles (performance), inspirationAccountIds are competitors and creators they watch; they are separate lists because they mean opposite things. isDefault only accepts true (passing false would leave the account with no default at all, so to move the default, name the kit that should hold it).",
+        description: "Update a brand kit: identity fields (business name, positioning, audience, voice profile, visual style, content strategy), its brand media, which kit is the DEFAULT, and which tracked accounts it is LINKED to. Only the fields you pass change. Get the current kit first with get_brand_kit. Requires the brandkit:write scope. THREE MODES, chosen by what you pass: (1) pass brandKitId to patch one kit; (2) pass orderedIds ALONE to reorder the whole set, which is collection-level because ordering is a property of the set and a per-kit position would let two kits claim one slot, so pass every id in the order you want; (3) pass brandKitId + extract:true to RE-RUN website extraction, which returns immediately and fills the kit in the background from its websiteUrl (poll extractionStatus via get_brand_kit). logos/assets/sections/brandAccounts/inspirationAccounts are DECLARATIVE: a patch REPLACES the whole list, so pass the full set and use [] to clear. THIS IS ALSO HOW YOU ADD NEW MEDIA TO A KIT: a logo or asset entry names either a url it already has, or outputId to bring in a generation that is not in the kit yet ('<id>', or '<id>-2' for variation 2 of a batch), whose bytes get COPIED into the kit so trashing that generation later cannot empty it. To add a logo, read the kit, append one entry, and send the whole list back; sending an outputId twice adds it twice. brandAccounts are the account owner's OWN profiles (performance), inspirationAccounts are competitors and creators they watch; they are separate lists because they mean opposite things. AN ENTRY IS EITHER a tracked-account id you already have, OR { platform?, handleOrUrl } to ADD a profile that is not tracked yet, which is what STARTS ingesting its posts (a full profile url carries its own platform, so platform is only needed for a bare handle). isDefault only accepts true (passing false would leave the account with no default at all, so to move the default, name the kit that should hold it).",
         inputSchema: {
             brandKitId: z.string().optional().describe('The brand kit id. Omit ONLY when reordering with orderedIds.'),
             orderedIds: z
@@ -803,17 +824,21 @@ export function registerTools(server, opts) {
                 .boolean()
                 .optional()
                 .describe('Re-run website extraction for this kit. Returns immediately; poll extractionStatus.'),
-            logos: z.array(z.unknown()).optional().describe('The kit\'s logos. REPLACES the list; [] clears it.'),
-            assets: z.array(z.unknown()).optional().describe('The kit\'s brand assets. REPLACES the list; [] clears it.'),
+            logos: z.array(z.unknown()).optional().describe('The kit\'s logos, each { url | outputId, name?, is_primary?, layout?: horizontal|stacked|icon|wordmark, colorMode?: full_color|light|dark|grayscale }. REPLACES the list; [] clears it. Exactly one ends up primary (the kit\'s cover); name none and the first wins.'),
+            assets: z.array(z.unknown()).optional().describe('The kit\'s brand assets, each { url | outputId, name? }. REPLACES the list; [] clears it.'),
+            sections: z
+                .array(z.unknown())
+                .optional()
+                .describe("The kit's curated sections, each { tab, sectionName, sortOrder?, fields? }. REPLACES the set, keyed by (tab, sectionName); a section left out is ARCHIVED, never deleted. Array position is the default order."),
             isDefault: z.literal(true).optional().describe('Make this the default kit, un-defaulting every other.'),
-            brandAccountIds: z
-                .array(z.string())
+            brandAccounts: z
+                .array(z.unknown())
                 .optional()
-                .describe("The account owner's OWN tracked accounts to link. REPLACES the list; [] clears it."),
-            inspirationAccountIds: z
-                .array(z.string())
+                .describe("The account owner's OWN profiles. Each entry is a tracked-account id, or { platform?, handleOrUrl } to ADD one and start ingesting it. REPLACES the list; [] clears it."),
+            inspirationAccounts: z
+                .array(z.unknown())
                 .optional()
-                .describe('Tracked competitor/creator accounts to link. REPLACES the list; [] clears it.'),
+                .describe('Competitor/creator profiles they watch. Same entry shape as brandAccounts. REPLACES the list; [] clears it.'),
             name: z.string().optional(),
             businessName: z.string().optional(),
             websiteUrl: z.string().optional(),
@@ -829,7 +854,15 @@ export function registerTools(server, opts) {
     }, async (args, extra) => {
         try {
             const client = await getClient(extra);
-            const { brandKitId, orderedIds, extract, ...input } = args;
+            const { brandKitId, orderedIds, extract, logos, assets, sections, brandAccounts, inspirationAccounts, ...rest } = args;
+            // The declarative arrays are `unknown[]` in the schema (their entries are free-form objects the
+            // server validates), so they are cast at this one boundary rather than restating the shape in zod.
+            const input = {
+                ...rest,
+                ...(logos !== undefined ? { logos } : {}),
+                ...(assets !== undefined ? { assets } : {}),
+                ...(sections !== undefined ? { sections: sections } : {}),
+            };
             // Reorder is the collection-level mode and takes no kit id at all.
             if (orderedIds && !brandKitId) {
                 return brandKitListResult(await client.reorderBrandKits(orderedIds));
@@ -856,56 +889,7 @@ export function registerTools(server, opts) {
         }
     });
     // -- add_brand_kit_section ------------------------------------------------
-    server.registerTool('add_brand_kit_section', {
-        title: 'Add Brand Kit Section',
-        annotations: WRITE,
-        description: "Add a curated section to a brand kit (a tab + name + a list of fields). Fields are objects like { key, label, type, value }. Requires the brandkit:write scope.",
-        inputSchema: {
-            brandKitId: z.string().describe('The brand kit id.'),
-            tab: z.string().describe('The tab the section belongs to (e.g. "voice", "overview").'),
-            sectionName: z.string().describe('The section title.'),
-            sortOrder: z.number().int().optional().describe('Order within the tab (default 99 = end).'),
-            fields: z.array(z.record(z.string(), z.unknown())).optional().describe('Field objects: { key, label, type, value }.'),
-        },
-    }, async (args, extra) => {
-        try {
-            const client = await getClient(extra);
-            return brandKitSectionResult(await client.addBrandKitSection(args.brandKitId, {
-                tab: args.tab,
-                sectionName: args.sectionName,
-                sortOrder: args.sortOrder,
-                fields: args.fields,
-            }), 'Added section');
-        }
-        catch (err) {
-            return errorResult(err);
-        }
-    });
     // -- update_brand_kit_section ---------------------------------------------
-    server.registerTool('update_brand_kit_section', {
-        title: 'Update Brand Kit Section',
-        annotations: WRITE,
-        description: "Update a brand-kit section's name, order, or fields. Pass the full fields array to replace it. Requires the brandkit:write scope.",
-        inputSchema: {
-            brandKitId: z.string().describe('The brand kit id.'),
-            sectionId: z.string().describe('The section id (from get_brand_kit).'),
-            sectionName: z.string().optional(),
-            sortOrder: z.number().int().optional(),
-            fields: z.array(z.record(z.string(), z.unknown())).optional().describe('Replacement field objects.'),
-        },
-    }, async (args, extra) => {
-        try {
-            const client = await getClient(extra);
-            return brandKitSectionResult(await client.updateBrandKitSection(args.brandKitId, args.sectionId, {
-                sectionName: args.sectionName,
-                sortOrder: args.sortOrder,
-                fields: args.fields,
-            }), 'Updated section');
-        }
-        catch (err) {
-            return errorResult(err);
-        }
-    });
     // -- search_brand_knowledge -----------------------------------------------
     server.registerTool('search_brand_knowledge', {
         title: 'Search Brand Knowledge',
@@ -1141,20 +1125,59 @@ export function registerTools(server, opts) {
             return errorResult(err);
         }
     });
+    /**
+     * One item's universal identity. NO folder_id: the folder is named by the tool's own folder_id /
+     * folder_ids now, which is what lets one call file many items into many folders.
+     */
+    const itemRefBodySchema = z.object({
+        source_table: z.string().describe("The item's source table (e.g. as returned by search_media)."),
+        source_record_id: z.string().describe("The item's source record id."),
+        variant: z.number().int().optional().describe('The variation index (default 0 for single-asset items).'),
+    });
     server.registerTool('update_folder', {
         title: 'Update Folder',
         annotations: WRITE,
-        description: "Update one of the account's own folders: rename it, move it under a different parent (or to the top level with a null parent), or change a smart folder's saved query. Only the provided fields change.",
+        description: "Update the account's own folders: rename one, MOVE folders under a different parent (or to the top level with a null parent), change a smart folder's saved query, and FILE or UNFILE items. addItems/removeItems are DELTAS of { source_table, source_record_id, variant? }, not a list to replace, because an item can sit in several folders at once and a replace would silently unfile it from the others. Filing never moves or copies anything: it adds a pointer, and only manual folders accept items (a smart folder computes its own membership). Pass folderIds to patch several folders at once, which crossed with addItems files the same items into all of them; renaming and re-querying still need exactly one folder. NOTE the asymmetry: nesting a FOLDER via parentId is a MOVE (a folder has one parent), while filing an ITEM is a pointer that leaves its other folders alone.",
         inputSchema: {
             folder_id: z.string().describe('The folder id to update.'),
+            folder_ids: z
+                .array(z.string())
+                .optional()
+                .describe('Patch several folders at once. Attribute fields (name, query) still need exactly one.'),
             name: z.string().optional().describe('A new name.'),
-            parent_id: z.string().nullable().optional().describe('A new parent folder id, or null to move to the top level.'),
+            parent_id: z.string().nullable().optional().describe('A new parent folder id, or null to move to the top level. MOVES the folder.'),
             query: smartQuerySchema,
+            add_items: z
+                .array(itemRefBodySchema)
+                .optional()
+                .describe('File these items into the folder(s). A delta: their other folders are untouched.'),
+            remove_items: z
+                .array(itemRefBodySchema)
+                .optional()
+                .describe('Unfile these items. Only the pointer goes; the asset is never deleted.'),
         },
     }, async (args, extra) => {
         try {
-            const f = await (await getClient(extra)).updateFolder(args.folder_id, { name: args.name, parentId: args.parent_id, query: args.query });
-            return text(`Updated folder "${f.name}" (id ${f.id}).`);
+            const client = await getClient(extra);
+            const patch = {
+                name: args.name,
+                parentId: args.parent_id,
+                query: args.query,
+                addItems: args.add_items?.map((r) => ({ sourceTable: r.source_table, sourceRecordId: r.source_record_id, variant: r.variant })),
+                removeItems: args.remove_items?.map((r) => ({ sourceTable: r.source_table, sourceRecordId: r.source_record_id, variant: r.variant })),
+            };
+            const targets = args.folder_ids?.length ? args.folder_ids : [args.folder_id];
+            const folders = targets.length > 1
+                ? await client.updateFolders(targets, patch)
+                : [await client.updateFolder(targets[0], patch)];
+            const filed = args.add_items?.length ?? 0;
+            const unfiled = args.remove_items?.length ?? 0;
+            const what = [
+                filed ? `filed ${filed} item(s)` : null,
+                unfiled ? `unfiled ${unfiled} item(s)` : null,
+            ].filter(Boolean).join(', ');
+            const names = folders.map((f) => `"${f.name}" (id ${f.id})`).join(', ');
+            return text(`Updated ${folders.length === 1 ? 'folder' : `${folders.length} folders`} ${names}${what ? `: ${what}` : '.'}`);
         }
         catch (err) {
             return errorResult(err);
@@ -1174,40 +1197,6 @@ export function registerTools(server, opts) {
             return errorResult(err);
         }
     });
-    const itemRefSchema = {
-        folder_id: z.string().describe('The folder id.'),
-        source_table: z.string().describe("The item's source table (e.g. as returned by search_media)."),
-        source_record_id: z.string().describe("The item's source record id."),
-        variant: z.number().int().optional().describe('The variation index (default 0 for single-asset items).'),
-    };
-    server.registerTool('add_to_folder', {
-        title: 'Add to Folder',
-        annotations: WRITE,
-        description: 'File an item into a manual folder by its universal identity (source_table, source_record_id, and variant, as returned by search_media). Filing never moves or copies the asset; it adds a pointer, so the same item can live in several folders. Only manual folders accept items (a smart folder computes its own membership).',
-        inputSchema: itemRefSchema,
-    }, async (args, extra) => {
-        try {
-            await (await getClient(extra)).addToFolder(args.folder_id, { sourceTable: args.source_table, sourceRecordId: args.source_record_id, variant: args.variant });
-            return text('Filed into the folder.');
-        }
-        catch (err) {
-            return errorResult(err);
-        }
-    });
-    server.registerTool('remove_from_folder', {
-        title: 'Remove from Folder',
-        annotations: WRITE,
-        description: 'Remove an item from a manual folder by its universal identity. This unfiles the pointer only; the underlying asset is never deleted.',
-        inputSchema: itemRefSchema,
-    }, async (args, extra) => {
-        try {
-            await (await getClient(extra)).removeFromFolder(args.folder_id, { sourceTable: args.source_table, sourceRecordId: args.source_record_id, variant: args.variant });
-            return text('Removed from the folder.');
-        }
-        catch (err) {
-            return errorResult(err);
-        }
-    });
     // -- get_media ------------------------------------------------------------
     server.registerTool('get_media', {
         title: 'Get Media',
@@ -1488,35 +1477,17 @@ export function registerTools(server, opts) {
     server.registerTool('get_generation_status', {
         title: 'Get Generation Status',
         annotations: READ,
-        description: 'Get the current status of an image or video generation by its outputId (returned by generate_image / generate_video when a render is still in progress). Returns the final URLs once complete, otherwise the current status plus a poll_after_seconds hint. For a blocking wait on one or more outputIds, use wait_for_generation.',
-        inputSchema: {
-            outputId: z.string().describe('The outputId from generate_image or generate_video.'),
-        },
-    }, async (args, extra) => {
-        try {
-            const client = await getClient(extra);
-            const gen = await client.getGeneration(args.outputId);
-            return generationStatusResult(gen);
-        }
-        catch (err) {
-            return errorResult(err);
-        }
-    });
-    // -- wait_for_generation --------------------------------------------------
-    server.registerTool('wait_for_generation', {
-        title: 'Wait For Generation',
-        annotations: READ,
-        description: 'Wait for one or more in-progress generations (outputIds from generate_image / generate_video / upscale / generate_lip_sync / generate_board) to finish, and return their final URLs. Blocks up to ~50s per call; if a render is still running it returns the current status with a poll_after_seconds hint to call again. Pass wait=false for an instant status snapshot instead of blocking.',
+        description: "Check one or more in-progress generations (outputIds from generate_image / generate_video / upscale / generate_lip_sync / generate_board) and get their final URLs. BY DEFAULT THIS BLOCKS until they finish, up to ~50s per call, because that is almost always what you want after starting a render; if one is still running it comes back with the current status and a poll_after_seconds hint, so call again. Pass wait:false for an instant snapshot with no blocking. Accepts 1-8 outputIds in one call.",
         inputSchema: {
             outputIds: z
                 .array(z.string())
                 .min(1)
                 .max(8)
-                .describe('1-8 outputIds to wait on (each from a prior generate_* call).'),
+                .describe('1-8 outputIds to check (each from a prior generate_* call).'),
             wait: z
                 .boolean()
                 .optional()
-                .describe('Block until terminal (up to ~50s) when true (the default). false = an instant snapshot, no blocking.'),
+                .describe('Block until terminal (up to ~50s), the default. false = an instant snapshot.'),
         },
     }, async (args, extra) => {
         try {
@@ -1649,7 +1620,7 @@ export function registerTools(server, opts) {
     server.registerTool('update_post', {
         title: 'Update Post',
         annotations: WRITE,
-        description: "Update a post's fields: title, description, script, notes, status, platform, cover (coverUrl/coverOutputId), or pipeline stage (move it through the pipeline by passing `stage`). Requires the pipeline:write scope.",
+        description: "Update a post: its fields (title, description, script, notes, status, platform, cover, pipeline stage), its DESTINATIONS (which platforms it publishes to), its ASSETS (the media on it, in order), and its SCHEDULE. destinations and assets are DECLARATIVE: pass the WHOLE set, because anything you leave out is removed. Destinations key on platform. Assets key on id, and THE ARRAY ORDER IS THE carousel ORDER, so reordering is just sending the same ids in a different order; keep an existing asset by id, add a new one by assetUrl or outputId. scheduledAt sets the time on the post AND every destination (pass null to clear); give a destination its own scheduledAt to override it for that platform. To publish NOW, use publish_post. Requires the pipeline:write scope.",
         inputSchema: {
             postId: z.string().describe('The post id.'),
             title: z.string().optional(),
@@ -1668,163 +1639,31 @@ export function registerTools(server, opts) {
                 .array(z.string())
                 .optional()
                 .describe('Tag names to set on the post (must already exist; replaces the set). Omit to leave tags unchanged.'),
-        },
-    }, async (args, extra) => {
-        try {
-            const client = await getClient(extra);
-            const { postId, ...input } = args;
-            return postSummaryResult(await client.updatePost(postId, input), 'Updated');
-        }
-        catch (err) {
-            return errorResult(err);
-        }
-    });
-    // -- add_post_destination -------------------------------------------------
-    server.registerTool('add_post_destination', {
-        title: 'Add Post Destination',
-        annotations: WRITE,
-        description: "Attach a publish destination (one platform) to a post, or replace the existing one for that platform. Set connectedAccountId (an id from list_connected_accounts) to make it publishable. Pass platformSettings (the publish payload: media, caption, thumbnail, privacy) shaped to the platform + format; call get_platform first for the exact fields. In platformSettings, media URL fields (mediaItems, videoUrl, thumbnailUrl, ...) also accept an outputId of generated/uploaded media, resolved server-side. Requires the pipeline:write scope.",
-        inputSchema: {
-            postId: z.string().describe('The post id.'),
-            platform: z.enum(POST_PLATFORMS).describe('Destination platform.'),
-            format: z.string().optional().describe("Platform format, e.g. 'post', 'reel', 'story', 'short', 'thread'."),
-            connectedAccountId: z.string().optional().describe('The connected account to publish through.'),
-            scheduledAt: z.string().optional().describe('ISO-8601 scheduled time for this destination.'),
-            platformSettings: z
-                .record(z.string(), z.unknown())
-                .optional()
-                .describe('Per-platform/per-format publish config (mediaItems, caption, thumbnails, privacy, etc.). Get the exact field shape for this platform + format from get_platform.'),
-        },
-    }, async (args, extra) => {
-        try {
-            const client = await getClient(extra);
-            return destinationResult(await client.addPostDestination(args.postId, {
-                platform: args.platform,
-                format: args.format,
-                connectedAccountId: args.connectedAccountId,
-                scheduledAt: args.scheduledAt,
-                platformSettings: args.platformSettings,
-            }));
-        }
-        catch (err) {
-            return errorResult(err);
-        }
-    });
-    // -- update_post_destination ----------------------------------------------
-    server.registerTool('update_post_destination', {
-        title: 'Update Post Destination',
-        annotations: WRITE,
-        description: "Update one of a post's destinations (format, connected account, scheduled time, status, or platformSettings). Pass platformSettings (the publish payload: media, caption, thumbnail, privacy) shaped to the platform + format; call get_platform for the exact fields. It replaces the destination's settings, so include the full object. Requires the pipeline:write scope.",
-        inputSchema: {
-            postId: z.string().describe('The post id.'),
-            destinationId: z.string().describe('The destination id (from get_post).'),
-            format: z.string().optional(),
-            connectedAccountId: z.string().optional(),
-            scheduledAt: z.string().optional().describe('ISO-8601 scheduled time, or empty to clear.'),
-            status: z.string().optional(),
-            platformSettings: z
-                .record(z.string(), z.unknown())
-                .optional()
-                .describe('Per-platform/per-format publish config (mediaItems, caption, thumbnails, privacy, etc.); replaces the existing settings. Get the field shape from get_platform.'),
-        },
-    }, async (args, extra) => {
-        try {
-            const client = await getClient(extra);
-            return destinationResult(await client.updatePostDestination(args.postId, args.destinationId, {
-                format: args.format,
-                connectedAccountId: args.connectedAccountId,
-                scheduledAt: args.scheduledAt,
-                status: args.status,
-                platformSettings: args.platformSettings,
-            }));
-        }
-        catch (err) {
-            return errorResult(err);
-        }
-    });
-    // -- add_post_asset -------------------------------------------------------
-    server.registerTool('add_post_asset', {
-        title: 'Add Post Asset',
-        annotations: WRITE,
-        description: "Attach an asset to a post, by outputId (generated or uploaded media, resolved to its URL) or by a public assetUrl. With outputId the assetType is inferred. Sets the post cover from the first image. Requires the assets:write scope.",
-        inputSchema: {
-            postId: z.string().describe('The post id.'),
-            outputId: z
+            scheduledAt: z
                 .string()
+                .nullable()
                 .optional()
-                .describe('A media token (output id, first-8, or "-N") of generated/uploaded media. Provide this or assetUrl.'),
-            assetUrl: z.string().optional().describe('Public URL of the asset. Provide this or outputId.'),
-            assetType: z
-                .enum(['image', 'video', 'audio', 'document', 'link'])
+                .describe('ISO time to publish. Sets the post AND every destination. null clears the schedule.'),
+            destinations: z
+                .array(z.unknown())
                 .optional()
-                .describe('The kind of asset. Required with assetUrl; inferred when using outputId.'),
-            displayName: z.string().optional().describe('Optional display name.'),
-        },
-    }, async (args, extra) => {
-        try {
-            const client = await getClient(extra);
-            return assetResult(await client.addPostAsset(args.postId, {
-                outputId: args.outputId,
-                assetType: args.assetType,
-                assetUrl: args.assetUrl,
-                displayName: args.displayName,
-            }));
-        }
-        catch (err) {
-            return errorResult(err);
-        }
-    });
-    // -- reorder_post_assets --------------------------------------------------
-    server.registerTool('reorder_post_assets', {
-        title: 'Reorder Post Assets',
-        annotations: WRITE,
-        description: "Set a post's asset order (e.g. the carousel slide order; the first image is the cover). Pass assetIds as ALL of the post's asset ids (from get_post) in the desired order. Requires the assets:write scope.",
-        inputSchema: {
-            postId: z.string().describe('The post id.'),
-            assetIds: z
-                .array(z.string())
-                .describe("All of the post's asset ids (from get_post), in the desired order."),
-        },
-    }, async (args, extra) => {
-        try {
-            const client = await getClient(extra);
-            return assetOrderResult(await client.reorderPostAssets(args.postId, args.assetIds));
-        }
-        catch (err) {
-            return errorResult(err);
-        }
-    });
-    // -- remove_post_asset ----------------------------------------------------
-    server.registerTool('remove_post_asset', {
-        title: 'Remove Post Asset',
-        annotations: WRITE,
-        description: 'Detach an asset from a post by its asset id (from get_post). Requires the assets:write scope.',
-        inputSchema: {
-            postId: z.string().describe('The post id.'),
-            assetId: z.string().describe('The asset id (from get_post).'),
-        },
-    }, async (args, extra) => {
-        try {
-            const client = await getClient(extra);
-            return assetRemovedResult(await client.removePostAsset(args.postId, args.assetId));
-        }
-        catch (err) {
-            return errorResult(err);
-        }
-    });
-    // -- remove_post_destination ----------------------------------------------
-    server.registerTool('remove_post_destination', {
-        title: 'Remove Post Destination',
-        annotations: WRITE,
-        description: 'Detach a publish destination from a post by its destination id (from get_post). Requires the pipeline:write scope.',
-        inputSchema: {
-            postId: z.string().describe('The post id.'),
-            destinationId: z.string().describe('The destination id (from get_post).'),
+                .describe("The post's destinations, each { platform, format?, connectedAccountId?, platformSpecificData?, scheduledAt?, status? }. REPLACES the set, keyed by platform; [] detaches all."),
+            assets: z
+                .array(z.unknown())
+                .optional()
+                .describe("The post's assets IN ORDER, each { id } to keep an existing one or { assetUrl | outputId, assetType?, displayName? } to add. REPLACES the list; [] clears it."),
         },
     }, async (args, extra) => {
         try {
             const client = await getClient(extra);
-            return destinationRemovedResult(await client.removePostDestination(args.postId, args.destinationId));
+            const { postId, destinations, assets, ...input } = args;
+            // The two declarative arrays are `unknown[]` in the schema (their entries are free-form objects the
+            // server validates), so they are cast at this one boundary rather than duplicating the shape in zod.
+            return postSummaryResult(await client.updatePost(postId, {
+                ...input,
+                ...(destinations !== undefined ? { destinations: destinations } : {}),
+                ...(assets !== undefined ? { assets: assets } : {}),
+            }), 'Updated');
         }
         catch (err) {
             return errorResult(err);
@@ -1897,27 +1736,6 @@ export function registerTools(server, opts) {
             return errorResult(err);
         }
     });
-    // -- schedule_post --------------------------------------------------------
-    server.registerTool('schedule_post', {
-        title: 'Schedule Post',
-        annotations: WRITE,
-        description: 'Queue a post for future publishing: set the scheduled time on the post and all its destinations (pass scheduledAt=null to clear). This only queues; use publish_post to publish now. Requires the pipeline:write scope.',
-        inputSchema: {
-            postId: z.string().describe('The post id.'),
-            scheduledAt: z
-                .string()
-                .nullable()
-                .describe('ISO-8601 timestamp to schedule, or null to clear the schedule.'),
-        },
-    }, async (args, extra) => {
-        try {
-            const client = await getClient(extra);
-            return postSummaryResult(await client.schedulePost(args.postId, args.scheduledAt), 'Scheduled');
-        }
-        catch (err) {
-            return errorResult(err);
-        }
-    });
     // -- publish_post ---------------------------------------------------------
     server.registerTool('publish_post', {
         title: 'Publish Post',
@@ -1936,52 +1754,77 @@ export function registerTools(server, opts) {
             return errorResult(err);
         }
     });
-    // -- list_inspiration_accounts --------------------------------------------
-    server.registerTool('list_inspiration_accounts', {
-        title: 'List Inspiration Accounts',
+    // -- list_accounts --------------------------------------------------------
+    server.registerTool('list_accounts', {
+        title: 'List Tracked Accounts',
         annotations: READ,
-        description: "List the creators/competitors the account tracks for inspiration. Use these as grounding for research; call list_outliers for their top content or get_inspiration_account for one account's detail. Pass brandKitId to scope to the inspiration accounts linked to a specific brand kit.",
+        description: "List the social accounts this ContentHero account tracks. TWO KINDS, in one list: accountType 'inspiration' is the creators and competitors they watch for research, 'brand' is their OWN profiles (distinct from list_brand_kits, which are the brand identity documents). Every row reports its own accountType, so omit the filter to see both. Call get_account for one account's performance, or list_content for the posts. Pass brandKitId to scope to the accounts linked to a specific brand kit.",
         inputSchema: {
-            brandKitId: z.string().optional().describe('Scope to the inspiration accounts linked to this brand kit (from get_brand_kit).'),
+            accountType: z
+                .enum(['inspiration', 'brand'])
+                .optional()
+                .describe("Narrow to one kind. Omitted, both come back."),
+            brandKitId: z.string().optional().describe('Scope to the accounts linked to this brand kit (from get_brand_kit).'),
         },
     }, async (args, extra) => {
         try {
             const client = await getClient(extra);
-            return trackedAccountListResult(await client.listInspirationAccounts({ brandKitId: args.brandKitId }), 'inspiration account(s)');
+            return trackedAccountListResult(await client.listAccounts(args));
         }
         catch (err) {
             return errorResult(err);
         }
     });
-    // -- get_inspiration_account ----------------------------------------------
-    server.registerTool('get_inspiration_account', {
-        title: 'Get Inspiration Account',
+    // -- get_account ----------------------------------------------------------
+    server.registerTool('get_account', {
+        title: 'Get Tracked Account',
         annotations: READ,
-        description: "Get one tracked inspiration account with its content count and a few top outliers (by score). Use it to study a specific creator.",
+        description: "Get one tracked account with how its content actually performs: post count, total and average views/likes/comments, average engagement and outlier score, plus its top posts by outlier score and its most recent ones. Works for either kind of account: use it on one of the owner's OWN accounts to ground decisions in their real numbers, or on a creator they watch to study what works for that creator.",
         inputSchema: {
-            accountId: z.string().describe('The account id from list_inspiration_accounts.'),
+            accountId: z.string().describe('The account id from list_accounts.'),
         },
     }, async (args, extra) => {
         try {
             const client = await getClient(extra);
-            return inspirationAccountResult(await client.getInspirationAccount(args.accountId));
+            const detail = await client.getAccount(args.accountId);
+            return accountDetailResult(detail);
         }
         catch (err) {
             return errorResult(err);
         }
     });
-    // -- list_outliers --------------------------------------------------------
-    server.registerTool('list_outliers', {
-        title: 'List Outliers',
+    // -- list_content ---------------------------------------------------------
+    server.registerTool('list_content', {
+        title: 'List Tracked Content',
         annotations: READ,
-        description: "List top-performing content (outliers) from the creators the account tracks, ranked by outlier score (how far a post overperformed its creator's baseline). Filter by platform, content type, minimum score, or a text search. Set favorited=true to show only content the account has favorited. Call get_inspiration_content for one item's full detail incl. transcript. This is the core research read for finding what's working.",
+        description: "The core research read: social posts this account tracks, ranked by OUTLIER SCORE (how far a post overperformed its own creator's baseline, so a small account's hit still surfaces). SPANS BOTH the creators they watch and their OWN posts by default; set scope to narrow, and every row carries isOwn either way. This is how you answer both \"what is working for the people I watch\" and \"how did my own posts do\" without picking a subsystem first. Filter by platform, content type, a published window (publicationDate like 'week' or 'month', or exact publishedAfter/publishedBefore), and ranges over score, views, duration and follower count. Call get_content for one post in full, including its transcript.",
         inputSchema: {
+            scope: z
+                .enum(['all', 'inspiration', 'brand'])
+                .optional()
+                .describe("'inspiration' = creators they watch, 'brand' = their own accounts, 'all' = both (default)."),
             platform: z.enum(['youtube', 'instagram']).optional().describe('Filter to one platform.'),
             contentType: z.string().optional().describe("Filter by content type, e.g. 'video', 'short', 'reel'."),
-            minOutlierScore: z.number().optional().describe('Only content at or above this outlier score.'),
+            outlierScoreMin: z.number().optional().describe('Only content at or above this outlier score.'),
+            outlierScoreMax: z.number().optional().describe('Only content at or below this outlier score.'),
+            viewsMin: z.number().optional(),
+            viewsMax: z.number().optional(),
+            durationMin: z.number().optional().describe('Minimum duration in seconds.'),
+            durationMax: z.number().optional().describe('Maximum duration in seconds.'),
+            subscribersMin: z.number().optional().describe("Minimum follower count of the post's account."),
+            subscribersMax: z.number().optional().describe("Maximum follower count of the post's account."),
+            publicationDate: z
+                .enum(['week', 'month', '3months', '6months', 'year', '2years'])
+                .optional()
+                .describe('Published within this window. Use publishedAfter for an exact date instead.'),
+            publishedAfter: z.string().optional().describe('ISO timestamp. Wins over publicationDate.'),
+            publishedBefore: z.string().optional().describe('ISO timestamp.'),
             search: z.string().optional().describe('Text search across title, creator, handle, and description.'),
-            sortBy: z.enum(['score', 'date', 'views']).optional().describe("Sort order (default 'score')."),
-            brandKitId: z.string().optional().describe('Scope to the inspiration accounts linked to this brand kit (from get_brand_kit).'),
+            sortBy: z.enum(['score', 'date', 'views', 'engagement']).optional().describe("Sort field (default 'score')."),
+            sortOrder: z.enum(['asc', 'desc']).optional().describe("Sort direction (default 'desc')."),
+            accountIds: z.array(z.string()).optional().describe('Limit to these tracked account ids (from list_accounts).'),
+            addedByYou: z.boolean().optional().describe('Only the one-off posts the owner saved by url.'),
+            brandKitId: z.string().optional().describe('Scope to the accounts linked to this brand kit.'),
             favorited: z.boolean().optional().describe('Only content the account has favorited.'),
             limit: z.number().int().min(1).max(100).optional().describe('How many to return (default 20).'),
             offset: z.number().int().min(0).optional().describe('Pagination offset.'),
@@ -1989,68 +1832,35 @@ export function registerTools(server, opts) {
     }, async (args, extra) => {
         try {
             const client = await getClient(extra);
-            return outlierListResult(await client.listOutliers({
-                platform: args.platform,
-                contentType: args.contentType,
-                minOutlierScore: args.minOutlierScore,
-                search: args.search,
-                sortBy: args.sortBy,
-                brandKitId: args.brandKitId,
-                favorited: args.favorited,
-                limit: args.limit,
-                offset: args.offset,
-            }));
+            return outlierListResult(await client.listContent(args));
         }
         catch (err) {
             return errorResult(err);
         }
     });
-    // -- get_inspiration_content ----------------------------------------------
-    server.registerTool('get_inspiration_content', {
-        title: 'Get Inspiration Content',
+    // -- get_content ----------------------------------------------------------
+    server.registerTool('get_content', {
+        title: 'Get Tracked Content',
         annotations: READ,
-        description: "Get one tracked-content item in full: engagement stats, outlier score, hashtags, and the transcript when available. Use it to study exactly what a high-performing post says and does.",
+        description: "Get one tracked post in full: engagement stats, outlier score, hashtags, keywords, mentions and audio info. Works for a creator's post and for the owner's own. THE TRANSCRIPT IS OPT-IN because a long video is a large document: pass transcript='text' for the whole thing, or transcript='segments' for timed slices, and then narrow with startMs/endMs or transcriptSearch to pull only the part that matters. The transcript reports a status: 'complete', 'not_applicable' (there is nothing to transcribe), 'failed' (it will be retried), 'processing', or 'absent' (never attempted), so an empty result is never ambiguous.",
         inputSchema: {
-            contentId: z.string().describe('The content id from list_outliers or get_inspiration_account.'),
-        },
-    }, async (args, extra) => {
-        try {
-            const client = await getClient(extra);
-            return inspirationContentResult(await client.getInspirationContent(args.contentId));
-        }
-        catch (err) {
-            return errorResult(err);
-        }
-    });
-    // -- list_brand_accounts --------------------------------------------------
-    server.registerTool('list_brand_accounts', {
-        title: 'List Brand Accounts',
-        annotations: READ,
-        description: "List the account owner's OWN connected social accounts that ContentHero tracks for performance (distinct from list_brand_kits, which are the brand identity documents). Call get_brand_account_performance for one account's stats. Pass brandKitId to scope to the brand accounts linked to a specific brand kit.",
-        inputSchema: {
-            brandKitId: z.string().optional().describe('Scope to the brand accounts linked to this brand kit (from get_brand_kit).'),
-        },
-    }, async (args, extra) => {
-        try {
-            const client = await getClient(extra);
-            return trackedAccountListResult(await client.listBrandAccounts({ brandKitId: args.brandKitId }), 'brand account(s)');
-        }
-        catch (err) {
-            return errorResult(err);
-        }
-    });
-    // -- get_brand_account_performance ----------------------------------------
-    server.registerTool('get_brand_account_performance', {
-        title: 'Get Brand Account Performance',
-        annotations: READ,
-        description: "Get the performance summary for one of the owner's brand accounts: content count, total and average views/likes/comments, average engagement and outlier score, plus top and recent content. Use it to ground decisions in how the owner's own content actually performs.",
-        inputSchema: {
-            accountId: z.string().describe('The account id from list_brand_accounts.'),
+            contentId: z.string().describe('The content id from list_content or get_account.'),
+            transcript: z
+                .enum(['none', 'text', 'segments'])
+                .optional()
+                .describe("How much transcript to include. Default 'none'."),
+            startMs: z.number().optional().describe('Window start, ms from the start of the media. Implies segments.'),
+            endMs: z.number().optional().describe('Window end, ms from the start of the media. Implies segments.'),
+            transcriptSearch: z
+                .string()
+                .optional()
+                .describe('Return only the segments containing this phrase. Implies segments.'),
         },
     }, async (args, extra) => {
         try {
             const client = await getClient(extra);
-            return brandPerformanceResult(await client.getBrandAccountPerformance(args.accountId));
+            const { contentId, ...options } = args;
+            return inspirationContentResult(await client.getContent(contentId, options));
         }
         catch (err) {
             return errorResult(err);
@@ -2108,7 +1918,7 @@ export function registerTools(server, opts) {
     server.registerTool('favorite', {
         title: 'Favorite',
         annotations: WRITE,
-        description: "Mark an asset as a favorite. For a top-level asset, pass assetType + id (post, voice, brand_kit, project, inspiration_content, gallery, transition). To favorite a single studio media variation (one image/video/audio slot from list_media / get_media), pass the output id + variationIndex (1-based) and omit assetType. Requires the favorites:write scope. Idempotent.",
+        description: "Favorite or UNfavorite an asset: pass favorited:false to clear it (default true). For a top-level asset, pass assetType + id (post, voice, brand_kit, project, inspiration_content, gallery, transition). To favorite a single studio media variation (one image/video/audio slot from list_media / get_media), pass the output id + variationIndex (1-based) and omit assetType. Requires the favorites:write scope. Idempotent in both directions.",
         inputSchema: {
             assetType: z
                 .enum(['post', 'voice', 'brand_kit', 'project', 'inspiration_content', 'gallery', 'transition'])
@@ -2121,50 +1931,25 @@ export function registerTools(server, opts) {
                 .min(1)
                 .optional()
                 .describe('1-based studio media variation slot. When set, id is a studio output id and assetType is ignored.'),
+            favorited: z.boolean().optional().describe('Default true. Pass false to UNfavorite.'),
         },
     }, async (args, extra) => {
         try {
             const client = await getClient(extra);
-            await client.favorite({ assetType: args.assetType, id: args.id, variationIndex: args.variationIndex });
-            return statusActionResult('Favorited', args);
+            const favorited = args.favorited ?? true;
+            await client.favorite({ assetType: args.assetType, id: args.id, variationIndex: args.variationIndex, favorited });
+            return statusActionResult(favorited ? 'Favorited' : 'Unfavorited', args);
         }
         catch (err) {
             return errorResult(err);
         }
     });
     // -- unfavorite -----------------------------------------------------------
-    server.registerTool('unfavorite', {
-        title: 'Unfavorite',
-        annotations: WRITE,
-        description: 'Remove the favorite flag from an asset. Same target shape as favorite: assetType + id for a top-level asset, or output id + variationIndex (1-based) for a studio media variation. Requires the favorites:write scope. Idempotent.',
-        inputSchema: {
-            assetType: z
-                .enum(['post', 'voice', 'brand_kit', 'project', 'inspiration_content', 'gallery', 'transition'])
-                .optional()
-                .describe('The kind of asset. Required unless targeting a media variation via variationIndex.'),
-            id: z.string().describe('The asset id (or studio output id when using variationIndex).'),
-            variationIndex: z
-                .number()
-                .int()
-                .min(1)
-                .optional()
-                .describe('1-based studio media variation slot. When set, id is a studio output id and assetType is ignored.'),
-        },
-    }, async (args, extra) => {
-        try {
-            const client = await getClient(extra);
-            await client.unfavorite({ assetType: args.assetType, id: args.id, variationIndex: args.variationIndex });
-            return statusActionResult('Unfavorited', args);
-        }
-        catch (err) {
-            return errorResult(err);
-        }
-    });
     // -- archive --------------------------------------------------------------
     server.registerTool('archive', {
         title: 'Archive',
         annotations: WRITE,
-        description: "Archive an asset (reversible; ContentHero never hard-deletes). For a top-level asset, pass assetType + id (post, brand_kit, brand_kit_section, project). To archive a single studio media variation, pass the output id + variationIndex (1-based) and omit assetType. Archiving a post sets its status to 'archived'. Requires the favorites:write scope. Idempotent.",
+        description: "Archive or UNarchive an asset: pass archived:false to restore it (default true). ContentHero never hard-deletes, so this is always reversible. For a top-level asset, pass assetType + id (post, brand_kit, brand_kit_section, project). To archive a single studio media variation, pass the output id + variationIndex (1-based) and omit assetType. Archiving a post sets its status to 'archived'; restoring returns it to 'draft'. Requires the favorites:write scope. Idempotent in both directions.",
         inputSchema: {
             assetType: z
                 .enum(['post', 'brand_kit', 'brand_kit_section', 'project'])
@@ -2177,48 +1962,20 @@ export function registerTools(server, opts) {
                 .min(1)
                 .optional()
                 .describe('1-based studio media variation slot. When set, id is a studio output id and assetType is ignored.'),
+            archived: z.boolean().optional().describe('Default true. Pass false to RESTORE (unarchive).'),
         },
     }, async (args, extra) => {
         try {
             const client = await getClient(extra);
-            await client.archive({ assetType: args.assetType, id: args.id, variationIndex: args.variationIndex });
-            return statusActionResult('Archived', args);
+            const archived = args.archived ?? true;
+            await client.archive({ assetType: args.assetType, id: args.id, variationIndex: args.variationIndex, archived });
+            return statusActionResult(archived ? 'Archived' : 'Unarchived', args);
         }
         catch (err) {
             return errorResult(err);
         }
     });
     // -- unarchive ------------------------------------------------------------
-    server.registerTool('unarchive', {
-        title: 'Unarchive',
-        annotations: WRITE,
-        description: "Unarchive an asset (restore it). For a top-level asset, pass assetType + id (post, brand_kit, brand_kit_section, project). To unarchive a single studio media variation, pass the output id + variationIndex (1-based) and omit assetType. Unarchiving a post restores it to 'draft'. Requires the favorites:write scope. Idempotent.",
-        inputSchema: {
-            assetType: z
-                .enum(['post', 'brand_kit', 'brand_kit_section', 'project'])
-                .optional()
-                .describe('The kind of asset. Required unless targeting a media variation via variationIndex.'),
-            id: z.string().describe('The asset id (or studio output id when using variationIndex).'),
-            variationIndex: z
-                .number()
-                .int()
-                .min(1)
-                .optional()
-                .describe('1-based studio media variation slot. When set, id is a studio output id and assetType is ignored.'),
-        },
-    }, async (args, extra) => {
-        try {
-            const client = await getClient(extra);
-            await client.unarchive({ assetType: args.assetType, id: args.id, variationIndex: args.variationIndex });
-            return statusActionResult('Unarchived', args);
-        }
-        catch (err) {
-            return errorResult(err);
-        }
-    });
-    // ===========================================================================
-    // Editor / canvas ops (programmatic parity with the manual UI + in-app agent)
-    // ===========================================================================
     server.registerTool('list_projects', {
         title: 'List Projects',
         annotations: READ,
@@ -2528,7 +2285,7 @@ export function registerTools(server, opts) {
     server.registerTool('update_timeline', {
         title: 'Update Timeline',
         annotations: WRITE,
-        description: "Apply a batch of ops to an EDITOR (video timeline) project. update_timeline both CREATES and EDITS. EDIT ops act on existing clips: disable_ranges, delete_ranges, merge_clips, move_clip, trim_clip, split, delete_clip, duplicate, set_disabled, set_hidden, set_locked, group, ungroup, update_group, update_clip. CREATE ops add new clips/tracks: create_clip ({ op: 'create_clip', trackId, clip }) appends a clip to a track; insert_track ({ op: 'insert_track', referenceTrackId, position: 'above'|'below', trackType }) adds an empty track; insert_prebuilt_track ({ op: 'insert_prebuilt_track', index, track: { id, name, items: [item], trackType } }) inserts a whole track WITH its clips in one op (index 0 = top overlay) - the one-shot way to drop a graphic/text/shape onto a project without an existing empty track. TRANSITIONS: add_transition ({ op: 'add_transition', trackId, leftClipId, rightClipId, preset, durationFrames?, timing? }) adds a transition at the CUT between two TOUCHING adjacent clips (leftClipId's out-point meets rightClipId's in-point); preset is fade | crossfade | slide-left|right|up|down | wipe-left|right|up|down | flip | iris | clock-wipe; durationFrames defaults to 1s; one transition per cut (re-creating on the same pair replaces it); the result carries createdTransitionId. update_transition ({ op: 'update_transition', transitionId, patch: { preset?, durationFrames?, timing? } }) and remove_transition ({ op: 'remove_transition', transitionId }) edit or remove one (transition ids are on each track.transitions[] in get_project). ANIMATIONS: add_animation ({ op: 'add_animation', clipId, edge: 'in'|'out', preset, durationFrames?, timing? }) gives a single clip an ENTRANCE (edge 'in') or EXIT (edge 'out') animation, the clip animating against emptiness on that edge; preset is fade | slide-left|right|up|down | wipe-left|right|up|down | flip | iris | clock-wipe (single-clip presets, NOT crossfade which blends two clips); durationFrames defaults to 15 (0.5s at 30fps), timing 'linear' (default) or 'spring'; idempotent, a per-clip field keyed by clipId + edge so it creates or updates that edge's animation. remove_animation ({ op: 'remove_animation', clipId, edge: 'in'|'out' }) clears it. Choose add_animation when the motion belongs to ONE clip against emptiness; choose add_transition for a blend BETWEEN two adjacent clips. BACKGROUND REMOVAL: remove_background ({ op: 'remove_background', clipId }) cuts out the background of an IMAGE or VIDEO clip, replacing it with transparency, as an ASYNC job: the result carries a generatingOutputId to wait_for_generation on, and the clip's media swaps to the transparent cutout when it completes (the original is kept, so it stays restorable). Image removal is FREE; video removal is a PREMIUM metered feature (Champion+, charged per second, 60s cap) and returns an error if the plan or credits are insufficient. Only image/video clips have a background; other clip types return an error. MASKS: to add a CapCut-style shape mask to an IMAGE or VIDEO clip, set its `masks` array via update_clip (or update_clips) - each entry is a ClipMask cutout (shape, normalized position/size, rotation, feather, invert) that keeps only the pixels inside its shape, multiple masks union, and invert:true subtracts; masks are a clip PROPERTY, not an op, so patch them like any other field (a patch REPLACES the whole array; set [] to clear), and read get_timeline_types for the exact ClipMask shape. CAPTIONS: add_captions ({ op: 'add_captions', style?, clipIds? }) generates word-timed captions from the project's transcript, one block per spoken clip on a dedicated caption track - whole-timeline by default, or pass clipIds to scope; `style` is a caption template key (omit for the default); clips without a ready transcript are skipped and reported in the result warnings (media is normally transcribed on ingest); re-running refreshes + restyles existing caption blocks. update_captions ({ op: 'update_captions', style?, patch?, clipIds? }) restyles EXISTING captions - `style` re-resolves a template, `patch` sets caption overlay props directly (e.g. { textColor: '#FFDD00', fontSize: 32 }); pass one or both; it never creates captions where none exist (that is add_captions). remove_captions ({ op: 'remove_captions', clipIds? }) removes captions (all, or a clipIds subset) and drops the caption track if empty. Build the `clip` from get_timeline_types, which returns a copy-pasteable `example` skeleton per clip type plus the `creation` op shapes; mint your own string ids and put overlays on a NON-primary media track so they do not ripple the primary. Each op is an object with an `op` name plus its fields (e.g. { op: 'delete_clip', clipIds: ['clip-id'] } or { op: 'move_clip', clipId: 'clip-id', toFrame: 90, toTrackIndex: 0 }). CONTENT-AWARE EDITING: to cut sections you found in get_transcript, DEFAULT to disable_ranges: { op: 'disable_ranges', clipId, ranges: [{ startMs, endMs }], note? } - it takes SOURCE-media time ranges, splits the clip and marks those ranges disabled (non-destructively excluded from the render but still on the timeline, so the user can review via skip-disabled playback and toggle any back on). Prefer the SILENCE edges get_transcript reports as your cut boundaries (they already include breathing room, so cuts do not clip words or feel abrupt) rather than exact word starts. Pass all of a clip's ranges in ONE disable_ranges op. The optional `note` is shown to the USER, so keep it concise and human and use mm:ss for any times (never raw ms). delete_ranges has the same shape but HARD-deletes (ripple-closes the gap, irreversible) - use it ONLY after the user explicitly approves a permanent delete; otherwise always prefer disable_ranges. set_disabled toggles a WHOLE clip by id. RE-TIMING: a time-based clip's timeline length is DERIVED from its source media and its playback speed, so you never set its `durationInFrames` directly. To retime a clip, set the duration-affecting property in the `update_clip` (or `update_clips`) patch (today that property is `speed`) and the reducer recomputes the clip's length for you: the clip keeps covering the same span of its source, so its timeline length scales inversely with the speed change (2x speed halves its length, 0.5x doubles it). Re-timing then honors each track's positioning in the SAME op: on the magnetic primary track the following clips ripple so that no gap opens and none is left behind, while clips on other (free) tracks, and every clip while the magnetic track is off, keep their absolute positions. So a speed change, whether on one clip or a bulk `update_clips`, lands gap-free in a single call with no per-clip length math on your side. Any `durationInFrames` you pass for such a clip is ignored in favor of the derived value. update_clips ({ op: 'update_clips', clipIds?, groupId?, patch }) applies one patch to a SET of clips at once, the bulk form of update_clip; target an explicit clipIds array OR a whole group via groupId (resolves to its members; clipIds wins if both). Every listed clip takes the same patch, but a duration-affecting property re-times each clip from ITS OWN values (a `speed` change recomputes each clip's length from its own source and speed, per the RE-TIMING rule above), and the magnetic primary track ripples so the whole batch lands gap-free in one op. Use it for a bulk property change (speed, volume, opacity, and so on) instead of many update_clip ops. GROUPS: group ({ op: 'group', clipIds, name? }) links 2+ clips under one shared groupId, stamping a stable 'Group N' ordinal that never renumbers (the result carries groupId + groupOrdinal); optional name labels it. ungroup ({ op: 'ungroup', clipIds }) clears the group. update_group ({ op: 'update_group', groupId, patch: { name } }) renames a group. List groups with their ids / ordinals / names / member clips via get_project's top-level `groups`, then target a whole group with update_group or update_clips { groupId }. merge_clips ({ op: 'merge_clips', clipIds }) rejoins adjacent, same-source, contiguous clips into one (the inverse of split; use it to clean up fragments a range edit leaves behind, or to reverse a cut after re-enabling the disabled pieces). ONE-SHOT CLEANUPS (prefer these over hand-rolling ranges for the common cases): remove_silence ({ op: 'remove_silence', paceThresholdMs?, paddingStartMs?, paddingEndMs? }) detects and disables dead-air pauses across the WHOLE timeline (paceThresholdMs = min pause length to cut, default 500; paddingStartMs/paddingEndMs = breathing room, default 200) - idempotent + re-adjustable, so re-running re-cuts at the new settings; remove_filler_words ({ op: 'remove_filler_words' }) disables high-confidence disfluencies (um/uh/er) across the whole timeline; extract_audio ({ op: 'extract_audio', clipIds? }) splits each video clip's audio onto its own track (whole-timeline, or a clipIds subset). remove_silence + remove_filler_words need a ready transcript; each reports a warning + changes nothing when there is nothing to do (no transcript / no gaps / no fillers / no video). They expand to the same disable_ranges / create_clip primitives, so reach for get_transcript + disable_ranges only for CONTEXTUAL or selective cuts the macros cannot express. expectedRevision is OPTIONAL: omit it to apply to the project's current revision (last-write-wins, fine for single-editor and id-targeted ops), or pass the revision from a prior get_project/get_transcript to fail loudly on a concurrent change instead of clobbering it. You do NOT need to fetch the project just to get the revision. Each successful edit returns the new revision for chaining further edits. Requires the editor:write scope.",
+        description: "Apply a batch of ops to an EDITOR (video timeline) project. update_timeline both CREATES and EDITS. EDIT ops act on existing clips: disable_ranges, delete_ranges, merge_clips, move_clip, trim_clip, split, delete_clip, duplicate, set_disabled, set_hidden, set_locked, group, ungroup, update_group, update_clip. CREATE ops add new clips/tracks: create_clip ({ op: 'create_clip', trackId, clip }) appends a clip to a track; insert_track ({ op: 'insert_track', referenceTrackId, position: 'above'|'below', trackType }) adds an empty track; insert_prebuilt_track ({ op: 'insert_prebuilt_track', index, track: { id, name, items: [item], trackType } }) inserts a whole track WITH its clips in one op (index 0 = top overlay) - the one-shot way to drop a graphic/text/shape onto a project without an existing empty track. TRANSITIONS: add_transition ({ op: 'add_transition', trackId, leftClipId, rightClipId, preset, durationFrames?, timing? }) adds a transition at the CUT between two TOUCHING adjacent clips (leftClipId's out-point meets rightClipId's in-point); preset is fade | crossfade | slide-left|right|up|down | wipe-left|right|up|down | flip | iris | clock-wipe; durationFrames defaults to 1s; one transition per cut (re-creating on the same pair replaces it); the result carries createdTransitionId. update_transition ({ op: 'update_transition', transitionId, patch: { preset?, durationFrames?, timing? } }) and remove_transition ({ op: 'remove_transition', transitionId }) edit or remove one (transition ids are on each track.transitions[] in get_project). ANIMATIONS: add_animation ({ op: 'add_animation', clipId, edge: 'in'|'out', preset, durationFrames?, timing? }) gives a single clip an ENTRANCE (edge 'in') or EXIT (edge 'out') animation, the clip animating against emptiness on that edge; preset is fade | slide-left|right|up|down | wipe-left|right|up|down | flip | iris | clock-wipe (single-clip presets, NOT crossfade which blends two clips); durationFrames defaults to 15 (0.5s at 30fps), timing 'linear' (default) or 'spring'; idempotent, a per-clip field keyed by clipId + edge so it creates or updates that edge's animation. remove_animation ({ op: 'remove_animation', clipId, edge: 'in'|'out' }) clears it. Choose add_animation when the motion belongs to ONE clip against emptiness; choose add_transition for a blend BETWEEN two adjacent clips. BACKGROUND REMOVAL: remove_background ({ op: 'remove_background', clipId }) cuts out the background of an IMAGE or VIDEO clip, replacing it with transparency, as an ASYNC job: the result carries a generatingOutputId to poll with get_generation_status, and the clip's media swaps to the transparent cutout when it completes (the original is kept, so it stays restorable). Image removal is FREE; video removal is a PREMIUM metered feature (Champion+, charged per second, 60s cap) and returns an error if the plan or credits are insufficient. Only image/video clips have a background; other clip types return an error. MASKS: to add a CapCut-style shape mask to an IMAGE or VIDEO clip, set its `masks` array via update_clip (or update_clips) - each entry is a ClipMask cutout (shape, normalized position/size, rotation, feather, invert) that keeps only the pixels inside its shape, multiple masks union, and invert:true subtracts; masks are a clip PROPERTY, not an op, so patch them like any other field (a patch REPLACES the whole array; set [] to clear), and read get_timeline_types for the exact ClipMask shape. CAPTIONS: add_captions ({ op: 'add_captions', style?, clipIds? }) generates word-timed captions from the project's transcript, one block per spoken clip on a dedicated caption track - whole-timeline by default, or pass clipIds to scope; `style` is a caption template key (omit for the default); clips without a ready transcript are skipped and reported in the result warnings (media is normally transcribed on ingest); re-running refreshes + restyles existing caption blocks. update_captions ({ op: 'update_captions', style?, patch?, clipIds? }) restyles EXISTING captions - `style` re-resolves a template, `patch` sets caption overlay props directly (e.g. { textColor: '#FFDD00', fontSize: 32 }); pass one or both; it never creates captions where none exist (that is add_captions). remove_captions ({ op: 'remove_captions', clipIds? }) removes captions (all, or a clipIds subset) and drops the caption track if empty. Build the `clip` from get_timeline_types, which returns a copy-pasteable `example` skeleton per clip type plus the `creation` op shapes; mint your own string ids and put overlays on a NON-primary media track so they do not ripple the primary. Each op is an object with an `op` name plus its fields (e.g. { op: 'delete_clip', clipIds: ['clip-id'] } or { op: 'move_clip', clipId: 'clip-id', toFrame: 90, toTrackIndex: 0 }). CONTENT-AWARE EDITING: to cut sections you found in get_transcript, DEFAULT to disable_ranges: { op: 'disable_ranges', clipId, ranges: [{ startMs, endMs }], note? } - it takes SOURCE-media time ranges, splits the clip and marks those ranges disabled (non-destructively excluded from the render but still on the timeline, so the user can review via skip-disabled playback and toggle any back on). Prefer the SILENCE edges get_transcript reports as your cut boundaries (they already include breathing room, so cuts do not clip words or feel abrupt) rather than exact word starts. Pass all of a clip's ranges in ONE disable_ranges op. The optional `note` is shown to the USER, so keep it concise and human and use mm:ss for any times (never raw ms). delete_ranges has the same shape but HARD-deletes (ripple-closes the gap, irreversible) - use it ONLY after the user explicitly approves a permanent delete; otherwise always prefer disable_ranges. set_disabled toggles a WHOLE clip by id. RE-TIMING: a time-based clip's timeline length is DERIVED from its source media and its playback speed, so you never set its `durationInFrames` directly. To retime a clip, set the duration-affecting property in the `update_clip` (or `update_clips`) patch (today that property is `speed`) and the reducer recomputes the clip's length for you: the clip keeps covering the same span of its source, so its timeline length scales inversely with the speed change (2x speed halves its length, 0.5x doubles it). Re-timing then honors each track's positioning in the SAME op: on the magnetic primary track the following clips ripple so that no gap opens and none is left behind, while clips on other (free) tracks, and every clip while the magnetic track is off, keep their absolute positions. So a speed change, whether on one clip or a bulk `update_clips`, lands gap-free in a single call with no per-clip length math on your side. Any `durationInFrames` you pass for such a clip is ignored in favor of the derived value. update_clips ({ op: 'update_clips', clipIds?, groupId?, patch }) applies one patch to a SET of clips at once, the bulk form of update_clip; target an explicit clipIds array OR a whole group via groupId (resolves to its members; clipIds wins if both). Every listed clip takes the same patch, but a duration-affecting property re-times each clip from ITS OWN values (a `speed` change recomputes each clip's length from its own source and speed, per the RE-TIMING rule above), and the magnetic primary track ripples so the whole batch lands gap-free in one op. Use it for a bulk property change (speed, volume, opacity, and so on) instead of many update_clip ops. GROUPS: group ({ op: 'group', clipIds, name? }) links 2+ clips under one shared groupId, stamping a stable 'Group N' ordinal that never renumbers (the result carries groupId + groupOrdinal); optional name labels it. ungroup ({ op: 'ungroup', clipIds }) clears the group. update_group ({ op: 'update_group', groupId, patch: { name } }) renames a group. List groups with their ids / ordinals / names / member clips via get_project's top-level `groups`, then target a whole group with update_group or update_clips { groupId }. merge_clips ({ op: 'merge_clips', clipIds }) rejoins adjacent, same-source, contiguous clips into one (the inverse of split; use it to clean up fragments a range edit leaves behind, or to reverse a cut after re-enabling the disabled pieces). ONE-SHOT CLEANUPS (prefer these over hand-rolling ranges for the common cases): remove_silence ({ op: 'remove_silence', paceThresholdMs?, paddingStartMs?, paddingEndMs? }) detects and disables dead-air pauses across the WHOLE timeline (paceThresholdMs = min pause length to cut, default 500; paddingStartMs/paddingEndMs = breathing room, default 200) - idempotent + re-adjustable, so re-running re-cuts at the new settings; remove_filler_words ({ op: 'remove_filler_words' }) disables high-confidence disfluencies (um/uh/er) across the whole timeline; extract_audio ({ op: 'extract_audio', clipIds? }) splits each video clip's audio onto its own track (whole-timeline, or a clipIds subset). remove_silence + remove_filler_words need a ready transcript; each reports a warning + changes nothing when there is nothing to do (no transcript / no gaps / no fillers / no video). They expand to the same disable_ranges / create_clip primitives, so reach for get_transcript + disable_ranges only for CONTEXTUAL or selective cuts the macros cannot express. expectedRevision is OPTIONAL: omit it to apply to the project's current revision (last-write-wins, fine for single-editor and id-targeted ops), or pass the revision from a prior get_project/get_transcript to fail loudly on a concurrent change instead of clobbering it. You do NOT need to fetch the project just to get the revision. Each successful edit returns the new revision for chaining further edits. Requires the editor:write scope.",
         inputSchema: {
             projectId: z.string().describe('The editor project id.'),
             ops: z.array(z.object({ op: z.string() }).passthrough()).describe('The timeline ops to apply, in order.'),
@@ -2558,7 +2315,7 @@ export function registerTools(server, opts) {
     server.registerTool('update_canvas', {
         title: 'Update Canvas',
         annotations: WRITE,
-        description: "Apply a batch of ops to a CANVAS (slides/layers) project. Ops act on layers + slides: create_layer, update_layer, delete_layer, reorder_layer, duplicate_layers, set_layer_hidden, set_layer_locked, group_layers, ungroup_layers, set_layer_as_background, create_slide, update_slide, delete_slide, duplicate_slides, reorder_slides, set_background, and more. BACKGROUND REMOVAL: remove_background ({ op: 'remove_background', layerId }) cuts out the background of an IMAGE or VIDEO layer, replacing it with transparency, as an ASYNC job (the result carries a generatingOutputId to wait_for_generation on; the layer's media swaps to the transparent cutout when done, the original kept). Image removal is FREE; video removal is PREMIUM + metered (Champion+, per second, 60s cap). Other layer types return an error. Each op is an object with an `op` name plus its fields. expectedRevision is OPTIONAL: omit it to apply to the project's current revision (last-write-wins, fine for a single editor), or pass the revision from a prior get_project to fail loudly on a concurrent change instead of clobbering it. You do NOT need to fetch the project just to get the revision. Each successful edit returns the new revision for chaining further edits. Requires the editor:write scope.",
+        description: "Apply a batch of ops to a CANVAS (slides/layers) project. Ops act on layers + slides: create_layer, update_layer, delete_layer, reorder_layer, duplicate_layers, set_layer_hidden, set_layer_locked, group_layers, ungroup_layers, set_layer_as_background, create_slide, update_slide, delete_slide, duplicate_slides, reorder_slides, set_background, and more. BACKGROUND REMOVAL: remove_background ({ op: 'remove_background', layerId }) cuts out the background of an IMAGE or VIDEO layer, replacing it with transparency, as an ASYNC job (the result carries a generatingOutputId to poll with get_generation_status; the layer's media swaps to the transparent cutout when done, the original kept). Image removal is FREE; video removal is PREMIUM + metered (Champion+, per second, 60s cap). Other layer types return an error. Each op is an object with an `op` name plus its fields. expectedRevision is OPTIONAL: omit it to apply to the project's current revision (last-write-wins, fine for a single editor), or pass the revision from a prior get_project to fail loudly on a concurrent change instead of clobbering it. You do NOT need to fetch the project just to get the revision. Each successful edit returns the new revision for chaining further edits. Requires the editor:write scope.",
         inputSchema: {
             projectId: z.string().describe('The canvas project id.'),
             ops: z.array(z.object({ op: z.string() }).passthrough()).describe('The canvas ops to apply, in order.'),