@contenthero/mcp 0.4.12 → 0.4.14

package/dist/model-presentation.d.ts

@@ -0,0 +1,35 @@
+/**
+ * How a model is PRESENTED, remembered from the catalog the server already fetches.
+ *
+ * ## ⭐⭐ THIS IS NOT THE CACHE THAT WAS DELETED
+ *
+ * This package once fetched the whole model catalog on every chip and kept a module-level copy behind a
+ * `catch` that returned the RAW ID. An id reads enough like a label that a failed fetch surfaced as a chip
+ * flickering between kebab case and title case, with nothing logging why. Deleting it was correct.
+ *
+ * Two things are different here. A failure renders NO CHIP, never an id: the map is simply empty and every
+ * card loads without one, which is exactly what happens today. And it costs no request of its own, because
+ * `resolveModelEnums` already calls `listModels` at startup for the tool enums and these fields ride along
+ * in the same rows.
+ *
+ * ## Why it exists at all
+ *
+ * The prompt, the model and the shape are all decided at SUBMIT, but a card used to show none of them until
+ * the generation FINISHED and the completed row carried its own provenance. So the entire loading period,
+ * which is the part a person actually watches, was placeholders and nothing else.
+ *
+ * ⛔ IT LIVES IN ITS OWN MODULE because `server.ts` reads it and `models.ts` writes it. Putting it in
+ * either one makes those two import each other, and a cycle between the tool definitions and the catalog
+ * resolver is the kind of thing that works until a bundler orders them differently.
+ */
+import type { ModelInfo } from '@contenthero/sdk';
+export interface ModelChip {
+    name: string;
+    brandColor: string | null;
+    iconKey: string | null;
+}
+/** Replace what is known about every model. Called once per catalog fetch. */
+export declare function rememberModelPresentation(models: readonly ModelInfo[]): void;
+/** The chip for a model id, or null when the catalog does not name it. Null means render nothing. */
+export declare function modelChipFor(modelId: string | null | undefined): ModelChip | null;
+//# sourceMappingURL=model-presentation.d.ts.map

package/dist/model-presentation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-presentation.d.ts","sourceRoot":"","sources":["../src/model-presentation.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAA;AAEjD,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAA;IACZ,UAAU,EAAE,MAAM,GAAG,IAAI,CAAA;IACzB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;CACvB;AAID,8EAA8E;AAC9E,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,SAAS,SAAS,EAAE,GAAG,IAAI,CAY5E;AAED,qGAAqG;AACrG,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,SAAS,GAAG,IAAI,CAEjF"}

package/dist/models.d.ts

@@ -21,7 +21,7 @@
  */
 import type { ContentHero } from '@contenthero/sdk';
 /** Fallback image-generation models (used only if discovery is unreachable). */
-export declare const IMAGE_MODELS_FALLBACK: readonly ["nano-banana-2", "nano-banana", "nano-banana-pro", "seedream-5-lite", "gpt-image-2", "flux-2-pro", "flux-1-kontext"];
+export declare const IMAGE_MODELS_FALLBACK: readonly ["nano-banana-2", "nano-banana", "nano-banana-pro", "seedream-5-lite", "gpt-image-2", "flux-2-pro", "flux-1-kontext-pro"];
 /** Fallback video-generation models (used only if discovery is unreachable). */
 export declare const VIDEO_MODELS_FALLBACK: readonly ["veo-3.1-fast", "veo-3.1-quality", "seedance-2", "seedance-2-fast", "kling-3.0", "kling-2.6", "kling-3.0-motion-control", "kling-2.6-motion-control", "wan-2.6"];
 /** Fallback audio-generation models (used only if discovery is unreachable). */
@@ -68,7 +68,7 @@ export declare const BOARD_TYPES: readonly ["character", "pose", "mascot", "crea
 /** Short selection guidance baked into the generate_board boardType description. */
 export declare const BOARD_TYPE_GUIDANCE = "character = a person or figure. pose = a pose / action sheet. mascot = a brand mascot. creature = a creature or animal. weapon = a weapon. vehicle = a vehicle. object = a prop or object. location = an environment. shot = a multi-shot storyboard in one image.";
 /** Short selection guidance baked into each generate tool's modelId description. */
-export declare const IMAGE_MODEL_GUIDANCE = "nano-banana-2 = strong general default (1K/2K/4K). gpt-image-2 = best text rendering (resolution 1K/2K/4K, no quality param). flux-2-pro (mode pro|flex) / seedream-5-lite / nano-banana-pro = alternatives. flux-1-kontext (mode pro|max) = edit/recreate. Pass referenceImages for image-to-image / editing; pass mode for flux models.";
+export declare const IMAGE_MODEL_GUIDANCE = "nano-banana-2 = strong general default (1K/2K/4K). gpt-image-2 = best text rendering (resolution 1K/2K/4K, no quality param). flux-2-pro / seedream-5-lite / nano-banana-pro = alternatives. flux-1-kontext-pro = edit/recreate. Higher tiers are separate ids, not a parameter: flux-2-flex, flux-1-kontext-max, wan-2.7-image-pro. Pass referenceImages for image-to-image / editing.";
 export declare const VIDEO_MODEL_GUIDANCE = "veo-3.1-fast / veo-3.1-quality = high quality clips with audio. seedance-2 / seedance-2-fast = multimodal references; startFrame(+endFrame) = frame mode, referenceImages/Videos/Audio = references mode. kling-3.0 (per-shot via shots) / kling-2.6 = strong motion. wan-2.6 (multiShot for multi-shot mode) = alternative. The motion-control variants require an input image plus an input video.";
 export declare const AUDIO_MODEL_GUIDANCE = "elevenlabs-tts = text to speech (needs text + voiceId). elevenlabs-music = music from a prompt. elevenlabs-sound-effects = a sound effect from a prompt.";
 export declare const EDIT_AUDIO_MODEL_GUIDANCE = "The audio-processing model. Each transforms audio input into audio output. elevenlabs-voice-isolator = remove background noise and music, leaving clean speech (synchronous). auphonic-enhance = level loudness and clean up background noise (asynchronous; poll get_generation_status).";

package/dist/models.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"models.d.ts","sourceRoot":"","sources":["../src/models.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAA;AAEnD,gFAAgF;AAChF,eAAO,MAAM,qBAAqB,gIAQxB,CAAA;AAEV,gFAAgF;AAChF,eAAO,MAAM,qBAAqB,4KAUxB,CAAA;AAEV,gFAAgF;AAChF,eAAO,MAAM,qBAAqB,6EAIxB,CAAA;AAEV,uGAAuG;AACvG,eAAO,MAAM,0BAA0B,4DAA6D,CAAA;AAEpG,uEAAuE;AACvE,eAAO,MAAM,uBAAuB,yDAA0D,CAAA;AAE9F,wEAAwE;AACxE,eAAO,MAAM,wBAAwB,+DAAgE,CAAA;AAQrG,+DAA+D;AAC/D,MAAM,MAAM,SAAS,GAAG,CAAC,MAAM,EAAE,GAAG,MAAM,EAAE,CAAC,CAAA;AAE7C,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,SAAS,CAAA;IAChB,KAAK,EAAE,SAAS,CAAA;IAChB,KAAK,EAAE,SAAS,CAAA;IAChB,0FAA0F;IAC1F,SAAS,EAAE,SAAS,CAAA;IACpB,OAAO,EAAE,SAAS,CAAA;IAClB,OAAO,EAAE,SAAS,CAAA;IAClB,2EAA2E;IAC3E,kBAAkB,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,GAAG,OAAO,CAAC,CAAA;CACtD;AAMD;;;;;GAKG;AACH,wBAAgB,kBAAkB,IAAI,kBAAkB,CAUvD;AAED;;;;GAIG;AACH,wBAAsB,iBAAiB,CAAC,SAAS,EAAE,MAAM,WAAW,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAuDjG;AAED;;;;;GAKG;AACH,eAAO,MAAM,WAAW,yGAUd,CAAA;AAEV,oFAAoF;AACpF,eAAO,MAAM,mBAAmB,uQACsO,CAAA;AAEtQ,oFAAoF;AACpF,eAAO,MAAM,oBAAoB,8UAC4S,CAAA;AAE7U,eAAO,MAAM,oBAAoB,yYACuW,CAAA;AAExY,eAAO,MAAM,oBAAoB,6JAC2H,CAAA;AAE5J,eAAO,MAAM,yBAAyB,8RACuP,CAAA;AAE7R,eAAO,MAAM,sBAAsB,yKACqI,CAAA;AAExK,eAAO,MAAM,uBAAuB,+MAC0K,CAAA"}
+{"version":3,"file":"models.d.ts","sourceRoot":"","sources":["../src/models.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAA;AAGnD,gFAAgF;AAChF,eAAO,MAAM,qBAAqB,oIAQxB,CAAA;AAEV,gFAAgF;AAChF,eAAO,MAAM,qBAAqB,4KAUxB,CAAA;AAEV,gFAAgF;AAChF,eAAO,MAAM,qBAAqB,6EAIxB,CAAA;AAEV,uGAAuG;AACvG,eAAO,MAAM,0BAA0B,4DAA6D,CAAA;AAEpG,uEAAuE;AACvE,eAAO,MAAM,uBAAuB,yDAA0D,CAAA;AAE9F,wEAAwE;AACxE,eAAO,MAAM,wBAAwB,+DAAgE,CAAA;AAQrG,+DAA+D;AAC/D,MAAM,MAAM,SAAS,GAAG,CAAC,MAAM,EAAE,GAAG,MAAM,EAAE,CAAC,CAAA;AAE7C,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,SAAS,CAAA;IAChB,KAAK,EAAE,SAAS,CAAA;IAChB,KAAK,EAAE,SAAS,CAAA;IAChB,0FAA0F;IAC1F,SAAS,EAAE,SAAS,CAAA;IACpB,OAAO,EAAE,SAAS,CAAA;IAClB,OAAO,EAAE,SAAS,CAAA;IAClB,2EAA2E;IAC3E,kBAAkB,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,GAAG,OAAO,CAAC,CAAA;CACtD;AAMD;;;;;GAKG;AACH,wBAAgB,kBAAkB,IAAI,kBAAkB,CAUvD;AAED;;;;GAIG;AACH,wBAAsB,iBAAiB,CAAC,SAAS,EAAE,MAAM,WAAW,GAAG,OAAO,CAAC,kBAAkB,CAAC,CA6DjG;AAED;;;;;GAKG;AACH,eAAO,MAAM,WAAW,yGAUd,CAAA;AAEV,oFAAoF;AACpF,eAAO,MAAM,mBAAmB,uQACsO,CAAA;AAEtQ,oFAAoF;AACpF,eAAO,MAAM,oBAAoB,4XAC0V,CAAA;AAE3X,eAAO,MAAM,oBAAoB,yYACuW,CAAA;AAExY,eAAO,MAAM,oBAAoB,6JAC2H,CAAA;AAE5J,eAAO,MAAM,yBAAyB,8RACuP,CAAA;AAE7R,eAAO,MAAM,sBAAsB,yKACqI,CAAA;AAExK,eAAO,MAAM,uBAAuB,+MAC0K,CAAA"}

package/dist/server.d.ts

@@ -29,6 +29,7 @@
  * (generate / upscale / lip-sync) gets a tool whose schema only carries its own
  * fields, and per-tool modelId enums prevent cross-type model misuse.
  */
+import type { Implementation } from '@modelcontextprotocol/sdk/types.js';
 import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
 import { ContentHero, type Generation } from '@contenthero/sdk';
 export { GENERATION_WIDGET_URI } from './widget-uri.js';
@@ -79,6 +80,57 @@ import { type GeneratedAttachment } from './format.js';
  * unlocks this, and it is its own piece of work rather than a prerequisite for rendering.
  */
 export declare function attachmentsFor(gen: Generation): Promise<GeneratedAttachment[]>;
+/**
+ * ⭐⭐⭐ **WHY AN IMAGE WAS NOT ATTACHED, AS A VALUE RATHER THAN AS SILENCE.**
+ *
+ * `fetchImageBytes` returned `null` for five genuinely different reasons and the summary line reported one
+ * number: "0 image(s) attached below". That cost a week. Two separate defects were live at once (a rewrite
+ * rule that had stopped firing, and masters that outgrew every budget) and the result could not distinguish
+ * them from a network blip, so every theory was equally consistent with the evidence.
+ *
+ * ⛔ **A COUNT IS NOT A DIAGNOSIS.** Whatever replaces this must keep naming the cause. The rule the codebase
+ * keeps relearning: a sentinel that collapses distinct failures into one value moves the defect into every
+ * caller, and here the caller was a person reading a transcript.
+ */
+type ImageSkipReason = 'host-not-allowed' | 'fetch-failed' | 'not-ok' | 'not-an-image'
+/** Bigger than the whole per-result allowance: it would never have fit, at any position in the call. */
+ | 'over-budget'
+/**
+ * Small enough on its own, but the earlier items in this call had already spent the shared allowance.
+ *
+ * ⭐ DISTINCT FROM `over-budget` BECAUSE THE FIX IS DIFFERENT AND THE READER CAN ACT ON IT. "Too large"
+ * invites resizing an asset that is already small; "ask for fewer items" is the actual remedy, and it is
+ * the reading that tells you the tail of a long batch was truncated rather than broken.
+ */
+ | 'budget-spent';
+/**
+ * ⭐⭐⭐ **THE ONE PLACE THAT DECIDES HOW MUCH OF A RESULT MAY BE BYTES.**
+ *
+ * Two call sites needed this and each had its own answer, which is how the same defect appeared twice at
+ * different levels: `attachmentsFor` capped PER ITEM while the host's ceiling is per RESULT, and `get_media`
+ * fetched up to TEN images in parallel with no cap at all (10 x 840 KB is 8 MB against a 1 MB limit).
+ *
+ * ⛔ SEQUENTIAL, DELIBERATELY. The budget is shared state, so a parallel fetch cannot know what the others
+ * already spent and every one of them would pass a check the set as a whole fails. Most calls carry one to
+ * three items, so the latency is small and the alternative is a ceiling that holds only by luck.
+ *
+ * Returns one entry per input, positionally aligned with what was asked for. An entry that did not attach
+ * carries WHY, because the count alone is not diagnosable: see `ImageSkipReason`.
+ */
+export interface InlinedImage {
+    image: {
+        data: string;
+        mimeType: string;
+    } | null;
+    /** Set only when `image` is null. Short enough to print in a result line. */
+    skipped?: string;
+    /**
+     * The machine-readable cause, so a formatter can decide what to SAY about a set of them without parsing
+     * the sentence it is about to print. "Ask for fewer items" is advice about the whole call, so it belongs
+     * once at the end rather than repeated per item.
+     */
+    reason?: ImageSkipReason;
+}
 /**
  * ⛔⛔ **THE DISPLAY NAME IS NO LONGER RESOLVED HERE. `Generation.modelDisplayName` CARRIES IT.**
  *
@@ -116,6 +168,30 @@ export interface BuildServerOptions {
  * enums are supplied pre-resolved, and the backend client is resolved per call.
  */
 export declare function registerTools(server: McpServer, opts: RegisterToolsOptions): void;
+/**
+ * ⭐⭐⭐ **WHO THIS SERVER SAYS IT IS, FOR BOTH TRANSPORTS, FROM ONE PLACE.**
+ *
+ * The stdio server named itself `contenthero` here. The HOSTED server never named itself at all: the app's
+ * route calls `createMcpHandler(register, {}, config)` and that empty second argument is `serverOptions`,
+ * so `mcp-handler` fell back to its own default, `"mcp-typescript server on vercel"`.
+ *
+ * ⛔⛔ **AND THAT DEFAULT IS WHAT A USER NAMES THE CONNECTION.** Measured in Gemini 2026-09-21: the "Save
+ * your custom app" dialog pre-filled **"Mcp Typescript Server On Vercel"** next to our laurel mark and a
+ * correct list of 88 tools. Every person connecting over the hosted transport has been offered someone
+ * else's build-tool name as our product name, in the one dialog that decides what they will call us
+ * forever. Claude and ChatGPT never surfaced it, so nothing made it visible until a host put it in a text
+ * field.
+ *
+ * ⚠️ EXPORTED, NOT RESTATED. A second literal in the app's route would be a third spelling of one identity
+ * across two repos, which is the same shape as the widget uri problem: correct on the day it is typed and
+ * silently stale afterwards.
+ *
+ * ⛔ The VERSION half used to parse `../package.json` relative to `import.meta.url` inside a try/catch
+ * returning '0.0.0'. Same defect as the widget read and the same blast radius: under a bundler the path
+ * does not exist, so the hosted server reported 0.0.0 and the catch made it silent. A version is a
+ * build-time fact, so it is generated alongside the widget and no path resolution is left to get wrong.
+ */
+export declare const SERVER_INFO: Implementation;
 /**
  * Build a stdio-style server bound to a single env-configured client. The model
  * enums are resolved live from the discovery catalog (the client has a key).

package/dist/server.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAA;AAenE,OAAO,EACL,WAAW,EAcX,KAAK,UAAU,EAChB,MAAM,kBAAkB,CAAA;AAazB,OAAO,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAA;AAEvD,OAAO,EAEL,KAAK,kBAAkB,EASxB,MAAM,aAAa,CAAA;AACpB,OAAO,EAeL,KAAK,mBAAmB,EA+DzB,MAAM,aAAa,CAAA;AAgLpB;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,cAAc,CAAC,GAAG,EAAE,UAAU,GAAG,OAAO,CAAC,mBAAmB,EAAE,CAAC,CAwDpF;AAoPD;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,iFAAiF;AACjF,MAAM,MAAM,SAAS,GAAG,CAAC,KAAK,CAAC,EAAE,OAAO,KAAK,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC,CAAA;AAE/E,MAAM,WAAW,oBAAoB;IACnC,8EAA8E;IAC9E,SAAS,EAAE,SAAS,CAAA;IACpB,2EAA2E;IAC3E,MAAM,EAAE,kBAAkB,CAAA;CAC3B;AAED,MAAM,WAAW,kBAAkB;IACjC,kFAAkF;IAClF,SAAS,CAAC,EAAE,MAAM,WAAW,CAAA;CAC9B;AAYD;;;GAGG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,oBAAoB,GAAG,IAAI,CAyoGjF;AAeD;;;GAGG;AACH,wBAAsB,WAAW,CAAC,OAAO,GAAE,kBAAuB,GAAG,OAAO,CAAC,SAAS,CAAC,CAMtF"}
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAA;AACxE,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAA;AAgBnE,OAAO,EACL,WAAW,EAcX,KAAK,UAAU,EAChB,MAAM,kBAAkB,CAAA;AAazB,OAAO,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAA;AAEvD,OAAO,EAEL,KAAK,kBAAkB,EASxB,MAAM,aAAa,CAAA;AACpB,OAAO,EAeL,KAAK,mBAAmB,EAgEzB,MAAM,aAAa,CAAA;AA4LpB;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,cAAc,CAAC,GAAG,EAAE,UAAU,GAAG,OAAO,CAAC,mBAAmB,EAAE,CAAC,CAoEpF;AAqGD;;;;;;;;;;;GAWG;AACH,KAAK,eAAe,GAChB,kBAAkB,GAClB,cAAc,GACd,QAAQ,GACR,cAAc;AAChB,wGAAwG;GACtG,aAAa;AACf;;;;;;GAMG;GACD,cAAc,CAAA;AA8HlB;;;;;;;;;;;;;GAaG;AACH,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAA;IAChD,6EAA6E;IAC7E,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB;;;;OAIG;IACH,MAAM,CAAC,EAAE,eAAe,CAAA;CACzB;AA+KD;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,iFAAiF;AACjF,MAAM,MAAM,SAAS,GAAG,CAAC,KAAK,CAAC,EAAE,OAAO,KAAK,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC,CAAA;AAE/E,MAAM,WAAW,oBAAoB;IACnC,8EAA8E;IAC9E,SAAS,EAAE,SAAS,CAAA;IACpB,2EAA2E;IAC3E,MAAM,EAAE,kBAAkB,CAAA;CAC3B;AAED,MAAM,WAAW,kBAAkB;IACjC,kFAAkF;IAClF,SAAS,CAAC,EAAE,MAAM,WAAW,CAAA;CAC9B;AAYD;;;GAGG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,oBAAoB,GAAG,IAAI,CA8yGjF;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,eAAO,MAAM,WAAW,EAAE,cA2BzB,CAAA;AAED;;;GAGG;AACH,wBAAsB,WAAW,CAAC,OAAO,GAAE,kBAAuB,GAAG,OAAO,CAAC,SAAS,CAAC,CAMtF"}