@contenthero/mcp 0.4.11 → 0.4.13

package/dist/server.d.ts

@@ -79,6 +79,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.**
  *

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,EA8DzB,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,CA0mGjF;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,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,EAgEzB,MAAM,aAAa,CAAA;AAgLpB;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,cAAc,CAAC,GAAG,EAAE,UAAU,GAAG,OAAO,CAAC,mBAAmB,EAAE,CAAC,CAmEpF;AAqGD;;;;;;;;;;;GAWG;AACH,KAAK,eAAe,GAChB,kBAAkB,GAClB,cAAc,GACd,QAAQ,GACR,cAAc;AAChB,wGAAwG;GACtG,aAAa;AACf;;;;;;GAMG;GACD,cAAc,CAAA;AA6GlB;;;;;;;;;;;;;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;AAoHD;;;;;;;;;;;;;;;;;;;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,CA+yGjF;AAeD;;;GAGG;AACH,wBAAsB,WAAW,CAAC,OAAO,GAAE,kBAAuB,GAAG,OAAO,CAAC,SAAS,CAAC,CAMtF"}