@contenthero/mcp 0.4.1 → 0.4.3

package/dist/format.d.ts

@@ -4,12 +4,21 @@
  * a readable message instead of a transport failure.
  */
 import type { CallToolResult } from '@modelcontextprotocol/sdk/types.js';
-import type { Avatar, AvatarSummary, Balance, BrandKit, BrandKitSummary, BrandKitSectionRecord, BrandKnowledgeItem, BrandKnowledgeDetail, BrandKnowledgeListResult, BrandKnowledgeMatch, ConnectedAccount, CostEstimate, Element, Generation, GenerateResult, EditAudioResult, MediaItem, MediaSummary, SearchMediaResult, Folder, DerivedFolder, FolderItem, MediaBatchResult, CreateMediaUploadResult, ImportedMedia, UploadedMedia, ModelInfo, PlatformSummary, PlatformSchema, Stage, Space, CardAsset, Post, CardDetail, CardListResult, CardSummary, Tag, PublishCardResult, TrackedAccount, ContentDetail, ContentListResult, AccountDetail, Transcription, Voice, VoiceSummary, ApplyEditorOpsResult, ProjectSummary, ProjectDetail, LiveContextResult, LayerTypeCatalog, TimelineTypeCatalog, TranscriptResult, ExportJob, ExportFormatCatalog, ExtractionOutcome } from '@contenthero/sdk';
+import type { Avatar, AvatarSummary, Balance, BrandKit, BrandKitSummary, BrandKitSectionRecord, BrandKnowledgeItem, BrandKnowledgeDetail, BrandKnowledgeListResult, BrandKnowledgeMatch, ConnectedAccount, CostEstimate, CreateAvatarResult, Element, Generation, GenerateResult, EditAudioResult, MediaItem, MediaSummary, SearchMediaResult, Folder, DerivedFolder, FolderItem, MediaBatchResult, CreateMediaUploadResult, ImportedMedia, UploadedMedia, ModelInfo, PlatformSummary, PlatformSchema, Stage, Space, CardAsset, Post, CardDetail, CardListResult, CardSummary, Tag, PublishResult, TrackedAccount, ContentDetail, ContentListResult, AccountDetail, Transcription, Voice, VoiceSummary, ApplyEditorOpsResult, ProjectSummary, ProjectDetail, LiveContextResult, LayerTypeCatalog, TimelineTypeCatalog, TranscriptResult, ExportJob, ExportFormatCatalog, ExtractionOutcome } from '@contenthero/sdk';
 export declare function text(body: string, isError?: boolean): CallToolResult;
 /** A finished image/video generation: list the asset URLs, plus the placement outcome when placed on a project. */
 export declare function completedResult(gen: Generation): CallToolResult;
 /** Suggested seconds to wait before re-polling a job, by content type. */
 export declare function pollAfterSecondsFor(contentType: string): number;
+/**
+ * How to call `get_generation_status`, written as the call itself.
+ *
+ * ⚠️ THE ARGUMENT IS `outputIds` AND IT IS AN ARRAY, ALWAYS, even for one job. Every handoff here used to
+ * say "call get_generation_status with this outputId", which names a parameter that does not exist: an agent
+ * following the sentence literally sends `{ outputId }` and the schema rejects it. Naming the shape in prose
+ * is what drifted, so these messages now print the call instead, and every site shares this one function.
+ */
+export declare function getStatusCall(outputIds: readonly string[]): string;
 /** A slow job that did not finish within the smart-wait window. */
 export declare function pendingResult(outputId: string, pollAfterSeconds?: number): CallToolResult;
 /** Synchronous audio result (already complete on submit). */
@@ -24,7 +33,19 @@ export declare function audioResult(result: GenerateResult | EditAudioResult): C
 export declare function enhanceClipsResult(result: EditAudioResult): CallToolResult;
 /** Result of a get_cost preflight: the estimate, with nothing generated or charged. */
 export declare function costResult(est: CostEstimate): CallToolResult;
-/** One generation's status. Used directly for a single id, and per-row by the batch form below. */
+/**
+ * One generation's status. Used directly for a single id, and per-row by the batch form below.
+ *
+ * ⭐ A STILL-RUNNING GENERATION REPORTS THE URLS IT ALREADY HAS. `outputUrls` fills in slot by slot,
+ * so a 4-image batch can have three finished assets while `status` is still 'processing'. Reporting
+ * only "still processing" threw those away and made every caller block on the SLOWEST slot, even
+ * though the finished ones are already visible in the app's own grid. The caller can start reviewing
+ * immediately and re-poll only for the remainder.
+ *
+ * ⚠️ THE PARTIAL LIST IS NOT A FINAL ONE, so it never uses `completedResult`'s "Done." header. A
+ * caller that stopped at a partial result believing it was complete would silently lose images,
+ * which is the failure this is meant to prevent, not cause.
+ */
 export declare function generationStatusResult(gen: Generation): CallToolResult;
 /** One or more generations (snapshot or post-wait). Falls through to the single form for one id. */
 export declare function generationBatchResult(gens: Generation[]): CallToolResult;
@@ -34,6 +55,18 @@ export declare function transcriptResult(t: Transcription): CallToolResult;
 export declare function avatarListResult(avatars: AvatarSummary[]): CallToolResult;
 /** One avatar's full detail, including its looks. */
 export declare function avatarResult(a: Avatar): CallToolResult;
+/**
+ * A just-created avatar, which is NOT READY.
+ *
+ * ⚠️ THE POINT OF A SEPARATE FORMATTER IS THE WAIT. `avatarResult` describes a finished avatar, and
+ * using it here would show an avatar with `image: none` and no looks, which reads as "created, and
+ * empty" rather than "created, and still generating". A model that reads it that way goes on to
+ * generate a look into an avatar whose own first look is still in flight, or reports success to the
+ * user for something they cannot yet see.
+ *
+ * Says the poll call explicitly, the same way `pendingResult` does for a generation.
+ */
+export declare function avatarPendingResult(created: CreateAvatarResult): CallToolResult;
 /** List of saved voices. */
 export declare function voiceListResult(voices: VoiceSummary[]): CallToolResult;
 /** One voice's full detail. */
@@ -128,7 +161,7 @@ export declare function platformResult(p: PlatformSchema): CallToolResult;
 export declare function cardListResult(result: CardListResult): CallToolResult;
 /** A single post summary line (create / update / schedule / archive results). */
 export declare function postSummaryResult(p: CardSummary, prefix?: string): CallToolResult;
-/** One post in full, with its destinations and assets. */
+/** One card in full, with its posts and assets. */
 export declare function cardResult(p: CardDetail): CallToolResult;
 /** List of stages (the agent resolves a stage from here before placing a post). */
 /**
@@ -143,8 +176,8 @@ export declare function spaceDeletedResult(id: string): CallToolResult;
 /** One space. */
 export declare function spaceResult(s: Space): CallToolResult;
 export declare function stageListResult(stages: Stage[]): CallToolResult;
-/** A created or updated destination. */
-export declare function destinationResult(d: Post): CallToolResult;
+/** A created or updated post. */
+export declare function postResult(d: Post): CallToolResult;
 /** An attached asset. */
 export declare function assetResult(a: CardAsset): CallToolResult;
 /** A post's assets in their (new) order. */
@@ -153,8 +186,8 @@ export declare function assetOrderResult(assets: CardAsset[]): CallToolResult;
 export declare function assetRemovedResult(r: {
     id: string;
 }): CallToolResult;
-/** Confirmation of a detached destination. */
-export declare function destinationRemovedResult(r: {
+/** Confirmation of a detached post. */
+export declare function postRemovedResult(r: {
     id: string;
 }): CallToolResult;
 /** The account's tags. */
@@ -165,8 +198,8 @@ export declare function tagResult(t: Tag, verb?: string): CallToolResult;
 export declare function tagDeletedResult(r: {
     id: string;
 }): CallToolResult;
-/** The result of publishing a post (per-destination outcomes). */
-export declare function publishResult(r: PublishCardResult): CallToolResult;
+/** The result of publishing a card's posts (one outcome per post). */
+export declare function publishResult(r: PublishResult): CallToolResult;
 /** List of tracked accounts, either kind. */
 export declare function trackedAccountListResult(accounts: TrackedAccount[], noun?: string): CallToolResult;
 /** A page of outliers. */

package/dist/format.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"format.d.ts","sourceRoot":"","sources":["../src/format.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"format.d.ts","sourceRoot":"","sources":["../src/format.ts"],"names":[],"mappings":"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"}

package/dist/format.js

@@ -30,9 +30,20 @@ export function completedResult(gen) {
 export function pollAfterSecondsFor(contentType) {
     return contentType === 'image' ? 5 : 15;
 }
+/**
+ * How to call `get_generation_status`, written as the call itself.
+ *
+ * ⚠️ THE ARGUMENT IS `outputIds` AND IT IS AN ARRAY, ALWAYS, even for one job. Every handoff here used to
+ * say "call get_generation_status with this outputId", which names a parameter that does not exist: an agent
+ * following the sentence literally sends `{ outputId }` and the schema rejects it. Naming the shape in prose
+ * is what drifted, so these messages now print the call instead, and every site shares this one function.
+ */
+export function getStatusCall(outputIds) {
+    return `get_generation_status { outputIds: [${outputIds.map((id) => `"${id}"`).join(', ')}] }`;
+}
 /** A slow job that did not finish within the smart-wait window. */
 export function pendingResult(outputId, pollAfterSeconds = 15) {
-    return text(`Still rendering (outputId ${outputId}). This is normal for video. Call get_generation_status with this outputId in ~${pollAfterSeconds}s [poll_after_seconds: ${pollAfterSeconds}] to get the final URLs.`);
+    return text(`Still rendering (outputId ${outputId}). This is normal for video. Call ${getStatusCall([outputId])} in ~${pollAfterSeconds}s [poll_after_seconds: ${pollAfterSeconds}] to get the final URLs.`);
 }
 /** Synchronous audio result (already complete on submit). */
 export function audioResult(result) {
@@ -54,9 +65,10 @@ export function enhanceClipsResult(result) {
     }
     const lines = jobs.map((j, i) => `${i + 1}. outputId ${j.outputId} covers ${j.clipIds.length} clip${j.clipIds.length === 1 ? '' : 's'}` +
         ` from one source (${j.windows} window${j.windows === 1 ? '' : 's'})`);
+    const poll = `Poll with ${getStatusCall(jobs.map((j) => j.outputId))}`;
     const header = jobs.length === 1
-        ? 'Enhancing 1 source. Poll its outputId with get_generation_status:'
-        : `Enhancing ${jobs.length} sources as separate jobs, because a noise profile is estimated per recording. Poll EVERY outputId:`;
+        ? `Enhancing 1 source. ${poll}:`
+        : `Enhancing ${jobs.length} sources as separate jobs, because a noise profile is estimated per recording. ${poll} (EVERY id, in one call):`;
     const footer = [
         'The enhanced audio is applied to the clips automatically when each job lands, so no placement call is needed.',
         result.silencedClipsExcluded
@@ -71,7 +83,19 @@ export function costResult(est) {
     const credits = `${est.creditsEstimate} credit${est.creditsEstimate === 1 ? '' : 's'}`;
     return text(`Estimated cost: ${credits} for ${what}. No generation ran and nothing was charged.`);
 }
-/** One generation's status. Used directly for a single id, and per-row by the batch form below. */
+/**
+ * One generation's status. Used directly for a single id, and per-row by the batch form below.
+ *
+ * ⭐ A STILL-RUNNING GENERATION REPORTS THE URLS IT ALREADY HAS. `outputUrls` fills in slot by slot,
+ * so a 4-image batch can have three finished assets while `status` is still 'processing'. Reporting
+ * only "still processing" threw those away and made every caller block on the SLOWEST slot, even
+ * though the finished ones are already visible in the app's own grid. The caller can start reviewing
+ * immediately and re-poll only for the remainder.
+ *
+ * ⚠️ THE PARTIAL LIST IS NOT A FINAL ONE, so it never uses `completedResult`'s "Done." header. A
+ * caller that stopped at a partial result believing it was complete would silently lose images,
+ * which is the failure this is meant to prevent, not cause.
+ */
 export function generationStatusResult(gen) {
     if (gen.status === 'completed')
         return completedResult(gen);
@@ -79,7 +103,17 @@ export function generationStatusResult(gen) {
         return text(`Generation ${gen.outputId} failed: ${gen.error ?? 'unknown error'}`, true);
     }
     const secs = pollAfterSecondsFor(gen.contentType);
-    return text(`Generation ${gen.outputId} is still ${gen.status}. Call get_generation_status again in ~${secs}s [poll_after_seconds: ${secs}].`);
+    const ready = gen.outputUrls ?? [];
+    const poll = `Call get_generation_status again in ~${secs}s [poll_after_seconds: ${secs}]`;
+    if (ready.length === 0) {
+        return text(`Generation ${gen.outputId} is still ${gen.status}. ${poll}.`);
+    }
+    const noun = ready.length === 1 ? gen.contentType : `${gen.contentType}s`;
+    return text([
+        `Partial. ${ready.length} ${noun} ready from ${gen.modelId} (outputId ${gen.outputId}), more still ${gen.status}:`,
+        ...ready.map((u, i) => `${i + 1}. ${u}`),
+        `NOT the full set. ${poll} for the rest.`,
+    ].join('\n'));
 }
 /** One or more generations (snapshot or post-wait). Falls through to the single form for one id. */
 export function generationBatchResult(gens) {
@@ -94,6 +128,13 @@ export function generationBatchResult(gens) {
             return `- ${gen.outputId}: failed | ${gen.error ?? 'unknown error'}`;
         }
         const secs = pollAfterSecondsFor(gen.contentType);
+        // Same rule as the single form: surface the slots that already landed rather than making the
+        // caller block on the slowest one. The count says the set is incomplete, so a row can never be
+        // mistaken for a finished generation.
+        const ready = gen.outputUrls ?? [];
+        if (ready.length > 0) {
+            return `- ${gen.outputId}: ${gen.status}, ${ready.length} ready so far | ${ready.join(', ')} [poll_after_seconds: ${secs}]`;
+        }
         return `- ${gen.outputId}: ${gen.status} [poll_after_seconds: ${secs}]`;
     });
     return text([`${gens.length} generation(s):`, ...rows].join('\n'));
@@ -131,6 +172,29 @@ export function avatarResult(a) {
         ...a.looks.map((l) => `  - ${l.name ?? l.lookType ?? 'look'} (id ${l.id})${l.isDefault ? ' [default]' : ''}${l.isFavorited ? ' [favorite]' : ''}${l.isArchived ? ' [archived]' : ''}: ${l.imageUrl ?? 'none'}`),
     ]));
 }
+/**
+ * A just-created avatar, which is NOT READY.
+ *
+ * ⚠️ THE POINT OF A SEPARATE FORMATTER IS THE WAIT. `avatarResult` describes a finished avatar, and
+ * using it here would show an avatar with `image: none` and no looks, which reads as "created, and
+ * empty" rather than "created, and still generating". A model that reads it that way goes on to
+ * generate a look into an avatar whose own first look is still in flight, or reports success to the
+ * user for something they cannot yet see.
+ *
+ * Says the poll call explicitly, the same way `pendingResult` does for a generation.
+ */
+export function avatarPendingResult(created) {
+    const a = created.avatar;
+    return text(lines([
+        `Created "${a.name}" (id ${a.id}).`,
+        '',
+        `⚠️ NOT READY YET: status is ${created.status}. The avatar has no image until its first look`,
+        'finishes generating, which is also when its default look and profile photo are set.',
+        `Poll with: get_avatar { "avatarId": "${a.id}" } until status is "completed" (usually 1-4 minutes).`,
+        '',
+        'Credits are charged when that look completes, not now, so a failed generation is not charged.',
+    ]));
+}
 /** List of saved voices. */
 export function voiceListResult(voices) {
     if (!voices.length)
@@ -599,7 +663,7 @@ export function platformResult(p) {
         `formats: ${p.formats.join(', ')}`,
         `posting modes: ${p.postingModes.join(', ')}`,
         '',
-        'Fields by format (set these as platformSettings on add_post_destination / update_post_destination):',
+        'Fields by format (set these as platformSettings on a post in update_card):',
         ...fmtBlocks,
         enumLines.length ? '' : null,
         enumLines.length ? 'Allowed option values:' : null,
@@ -608,7 +672,7 @@ export function platformResult(p) {
         limitLines.length ? 'Character limits:' : null,
         ...limitLines,
         '',
-        'Fill platformSettings to this shape, then attach with add_post_destination (or update_post_destination).',
+        'Fill platformSettings to this shape, then attach it as a post with update_card.',
     ]));
 }
 /** Render the reference-addressing guidance (how to tag references in the prompt). */
@@ -628,7 +692,7 @@ function promptReferenceLines(pr) {
 }
 // -- posts (content pipeline) -------------------------------------------------
 /** One line summarizing a post. */
-function postLine(p) {
+function cardLine(p) {
     const where = p.platforms.length ? p.platforms.join('+') : (p.platform ?? 'general');
     const when = p.publishedAt
         ? ` | published ${p.publishedAt}`
@@ -639,10 +703,10 @@ function postLine(p) {
 }
 /** List of posts with pagination context. */
 export function cardListResult(result) {
-    if (!result.posts.length)
-        return text('No posts found.');
-    const more = result.hasMore ? ` (showing ${result.posts.length} of ${result.total}; raise limit/offset for more)` : '';
-    return text([`${result.total} post(s)${more}:`, ...result.posts.map(postLine)].join('\n'));
+    if (!result.cards.length)
+        return text('No cards found.');
+    const more = result.hasMore ? ` (showing ${result.cards.length} of ${result.total}; raise limit/offset for more)` : '';
+    return text([`${result.total} card(s)${more}:`, ...result.cards.map(cardLine)].join('\n'));
 }
 /** A single post summary line (create / update / schedule / archive results). */
 export function postSummaryResult(p, prefix = 'Post') {
@@ -652,7 +716,7 @@ export function postSummaryResult(p, prefix = 'Post') {
     const scheduled = p.scheduledAt ? ` | Scheduled: ${p.scheduledAt}` : '';
     return text(`${prefix}: ${p.title || '(untitled)'} (id ${p.id}) | ${p.status}${stage}${scheduled}`);
 }
-/** One post in full, with its destinations and assets. */
+/** One card in full, with its posts and assets. */
 export function cardResult(p) {
     return text(lines([
         `${p.title || '(untitled)'} (id ${p.id}) | ${p.status} | platform: ${p.platform ?? 'general'}`,
@@ -663,8 +727,8 @@ export function cardResult(p) {
         p.script ? `script: ${p.script}` : null,
         p.notes ? `notes: ${p.notes}` : null,
         p.tags?.length ? `tags: ${p.tags.join(', ')}` : null,
-        `destinations (${p.destinations.length}):`,
-        ...p.destinations.map((d) => {
+        `posts (${p.posts.length}):`,
+        ...p.posts.map((d) => {
             const set = settingsKeys(d.platformSettings);
             return `  - ${d.platform} (id ${d.id})${d.format ? ` ${d.format}` : ''} | ${d.status ?? 'draft'}${d.connectedAccountId ? ` | account ${d.connectedAccountId}` : ' | no connected account'}${set ? ` | settings: ${set}` : ''}`;
         }),
@@ -714,7 +778,7 @@ export function stageListResult(stages) {
     const rows = stages.map((s) => `- ${s.name} (id ${s.id}${s.slug ? `, slug ${s.slug}` : ''})${s.isDefault ? ' [default]' : ''}`);
     return text([`${stages.length} stage(s) (in order):`, ...rows].join('\n'));
 }
-/** The non-empty keys of a destination's platformSettings, for a compact summary. */
+/** The non-empty keys of a post's platformSettings, for a compact summary. */
 function settingsKeys(settings) {
     if (!settings)
         return null;
@@ -730,10 +794,10 @@ function settingsKeys(settings) {
     });
     return keys.length ? keys.join(', ') : null;
 }
-/** A created or updated destination. */
-export function destinationResult(d) {
+/** A created or updated post. */
+export function postResult(d) {
     const set = settingsKeys(d.platformSettings);
-    return text(`Destination: ${d.platform} (id ${d.id})${d.format ? ` ${d.format}` : ''} | ${d.status ?? 'draft'}${d.connectedAccountId ? ` | account ${d.connectedAccountId}` : ' | no connected account (set one before publishing)'}${set ? ` | settings: ${set}` : ' | no settings (set platformSettings to make it publishable)'}.`);
+    return text(`Post: ${d.platform} (id ${d.id})${d.format ? ` ${d.format}` : ''} | ${d.status ?? 'draft'}${d.connectedAccountId ? ` | account ${d.connectedAccountId}` : ' | no connected account (set one before publishing)'}${set ? ` | settings: ${set}` : ' | no settings (set platformSettings to make it publishable)'}.`);
 }
 /** An attached asset. */
 export function assetResult(a) {
@@ -752,9 +816,9 @@ export function assetOrderResult(assets) {
 export function assetRemovedResult(r) {
     return text(`Asset removed (id ${r.id}).`);
 }
-/** Confirmation of a detached destination. */
-export function destinationRemovedResult(r) {
-    return text(`Destination removed (id ${r.id}).`);
+/** Confirmation of a detached post. */
+export function postRemovedResult(r) {
+    return text(`Post removed (id ${r.id}).`);
 }
 /** The account's tags. */
 export function tagListResult(tags) {
@@ -770,15 +834,15 @@ export function tagResult(t, verb = 'Tag') {
 export function tagDeletedResult(r) {
     return text(`Tag deleted (id ${r.id}). It was removed from all posts.`);
 }
-/** The result of publishing a post (per-destination outcomes). */
+/** The result of publishing a card's posts (one outcome per post). */
 export function publishResult(r) {
     if (!r.results.length) {
-        return text('Nothing to publish: this post has no destinations. Add one with add_post_destination first.', true);
+        return text('Nothing to publish: this card has no posts. Add one with update_card first.', true);
     }
     const rows = r.results.map((d) => d.success
         ? `- ${d.platform}: published${d.url ? ` | ${d.url}` : ''}`
         : `- ${d.platform}: FAILED | ${d.error ?? 'unknown error'}`);
-    const header = `Published ${r.publishedCount}/${r.results.length} destination(s)${r.failedCount ? `, ${r.failedCount} failed` : ''}:`;
+    const header = `Published ${r.publishedCount}/${r.results.length} post(s)${r.failedCount ? `, ${r.failedCount} failed` : ''}:`;
     return text([header, ...rows].join('\n'), r.publishedCount === 0);
 }
 // -- inspiration / research ---------------------------------------------------
@@ -897,7 +961,7 @@ export function connectedAccountResult(a) {
         a.accountUrl ? `url: ${a.accountUrl}` : null,
         caps.length ? `capabilities: ${caps.join(', ')}` : null,
         a.lastValidatedAt ? `last validated: ${a.lastValidatedAt}` : null,
-        `Use this id as connectedAccountId on add_post_destination to publish here.`,
+        `Use this id as connectedAccountId on a post in update_card to publish here.`,
     ]));
 }
 /** Map any thrown error onto a readable isError result. */
@@ -991,7 +1055,7 @@ const PROJECT_DETAIL_EXPOSURE = {
     favoritedAt: 'omitted: lifecycle state, surfaced by list_projects',
     createdAt: 'omitted: list metadata',
     updatedAt: 'omitted: superseded by revision, which is the token that actually matters here',
-    exportedPostId: 'omitted: publishing workflow, owned by the post tools',
+    exportedCardId: 'omitted: publishing workflow, owned by the card tools',
     exportedUrl: 'omitted: publishing workflow, owned by the post tools',
     shareId: 'omitted: sharing workflow, no editing effect',
 };