@jaypie/mcp 0.8.171 → 0.8.173

package/dist/assets.js

@@ -55,11 +55,11 @@ function getMcpAssetPaths() {
  */
 function getMcpBuildInfo() {
     return {
-        commit: "e1bbf2ee"
+        commit: "a6fc7633"
             ,
-        version: "0.8.171"
+        version: "0.8.173"
             ,
-        versionString: "@jaypie/mcp@0.8.171#e1bbf2ee"
+        versionString: "@jaypie/mcp@0.8.173#a6fc7633"
             ,
     };
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jaypie/mcp",
-  "version": "0.8.171",
+  "version": "0.8.173",
   "description": "Jaypie MCP",
   "repository": {
     "type": "git",

package/release-notes/constructs/1.2.89.md

@@ -0,0 +1,16 @@
+---
+version: 1.2.89
+date: 2026-09-25
+summary: JaypieDatadogForwarder reserved concurrency default rises from 10 to 30
+---
+
+## Changes
+
+- **`JaypieDatadogForwarder` reserved concurrency** defaults to `"30"` (was
+  `"10"`).
+
+## Upgrade
+
+- Existing forwarders reserve 30 concurrent executions on the next deploy,
+  drawing 20 more from the account's unreserved pool. Pass
+  `reservedConcurrency: "10"` to keep the old value.

package/release-notes/llm/1.3.50.md

@@ -0,0 +1,26 @@
+---
+version: 1.3.50
+date: 2026-09-25
+summary: Mistral OCR markdown inlines tables, describes images, and renders typed blocks such as signatures; Llm.ocr answers instructions and format; fallback chains fail over on any error and linger only on the primary
+---
+
+## Changes
+
+- Tables are always inline. `[tbl-0.md](tbl-0.md)` placeholders, which Mistral returns whenever `table_format` is sent, are replaced with the table content in the syntax `tables` selects
+- Every image is described. Requests carry a default `bbox_annotation_format` (`{ image_type, description }`, with signature, seal, and stamp in the enum). The description becomes the image's alt text, `![Notary seal](img-2.jpeg)`, and `LlmOcrImage` gains `annotation`, `description`, and `type`
+- Typed blocks are rendered. When OCR 4 returns `blocks`, page markdown is rebuilt from them, so a signature reads `[Signature: Jane Q Doe]` rather than a bare name. Header and footer blocks are skipped when extracted to their own fields
+- `PAGE_COST_ANNOTATED` prices annotated pages ($5 per 1,000 on `mistral-ocr-4-1`); `usage.cost` uses it unless annotation is disabled
+- `providerOptions.bbox_annotation_format` replaces the default schema, and `null` disables annotation
+- `Llm.ocr` accepts `instructions` and `format` (Natural Schema, JSON Schema, or Zod) and returns the answer on `content`. Mistral answers in the same call through `document_annotation_prompt` and `document_annotation_format`; beyond its 8-page annotation limit, and on emulated engines, one text-only `operate()` over the markdown answers instead. LlamaParse throws `NotImplementedError` before submitting, so a chain fails over
+- Mistral `document_annotation` is parsed from its JSON string before it lands on `annotations`
+- Fallback chains (`operate`, `ocr`, `question`) fail over on any error with no retry or wait, the last entry included. When the chain is spent, the primary runs once more with its full retry policy; if that fails, the call throws. Previously transient errors retried up to six times on each entry and the last entry kept its rate-limit wait
+- An explicit `retry` option on a chained call applies to the linger pass only
+- `LlmRetryOptions` gains `transient: false`, which disables transient-error retries
+- A caller abort (`LlmAbortError`) no longer falls over to the next entry
+- The Bedrock client is built with `maxAttempts: 1`, so SDK retries no longer stack under `RetryExecutor`
+
+## Testing
+
+- `npm run test -w packages/llm`: unit and Mistral hot specs pass
+- Live, 2026-09-25: Mistral classifies the notarized fixture natively; a 10-page PDF answers through `mistral-large-2512` over markdown; Haiku emulation answers bare instructions as a string and `format` as an object
+- Live, 2026-09-25: a notarized scan fixture (`test/fixtures/notarized.png`) returns an inline table, a described diagram, signature, and seal, and a `[Signature: Jane Q Doe]` block

package/release-notes/mcp/0.8.172.md

@@ -0,0 +1,9 @@
+---
+version: 0.8.172
+date: 2026-09-25
+summary: JaypieDatadogForwarder skill documents the reserved concurrency default of 30
+---
+
+## Changes
+
+- **`JaypieDatadogForwarder` skill**: `reservedConcurrency` defaults to `"30"`.

package/skills/JaypieDatadogForwarder.md

@@ -36,7 +36,7 @@ new JaypieDatadogForwarder(scope, id, props);
 | `id` | string | `"DatadogForwarder"` | Construct ID |
 | `datadogApiKey` | string | `CDK_ENV_DATADOG_API_KEY` | Datadog API key |
 | `account` | string | `CDK_ENV_ACCOUNT` | Account identifier for tags |
-| `reservedConcurrency` | string | `"10"` | Lambda reserved concurrency (must be string) |
+| `reservedConcurrency` | string | `"30"` | Lambda reserved concurrency (must be string) |
 | `additionalTags` | string | undefined | Extra Datadog tags (comma-separated) |
 | `service` | string | `"datadog"` | Service tag value |
 | `project` | string | undefined | Project tag value |

package/skills/llm.md

@@ -528,7 +528,7 @@ const { emulated, markdown, pages, usage } = await Llm.ocr(
       LLM.MODEL.HAIKU, // emulated: any provider that accepts files
     ],
     pages: "1,3-5", // 1-indexed; [1, 3, 4, 5] also works
-    tables: "markdown", // or "html"
+    tables: "markdown", // table syntax; tables are always inline
   },
 );
 
@@ -541,6 +541,37 @@ usage.cost; // USD from LLM.PAGE_COST (LlamaParse: from recorded credits; emulat
 usage.tokens; // emulated only: every operate() call's usage
 ```
 
+`instructions` and `format` ask for more than transcription; the answer
+lands on `content` (an object shaped by `format`, or a string with only
+`instructions`):
+
+```typescript
+const { content, markdown } = await Llm.ocr("./scans/intake.pdf", {
+  format: {
+    category: ["deed", "invoice", "medical intake", "other"],
+    description: String,
+  },
+  instructions: "Classify the document and describe it in one sentence.",
+});
+content.category; // "medical intake"
+```
+
+Mistral answers in the same call (`document_annotation_prompt` and a strict
+`document_annotation_format`). Past its 8-page annotation limit, and on every
+emulated engine, the answer comes from one more text-only `operate()` over the
+markdown, priced into `usage`. LlamaParse does not support either option and
+fails over to the next engine in the chain. Mistral's own
+`document_annotation` surfaces parsed as `annotations`.
+
+Mistral markdown is self-contained. Tables are inlined in place of
+`[tbl-0.md](tbl-0.md)` placeholders. Every image is annotated, and its
+description becomes the alt text (`![Notary signature of Jane Doe](img-1.jpeg)`)
+and lands on `images[].description`, `.type` (`signature`, `seal`, `stamp`,
+`photo`, ...), and `.annotation`. Typed blocks are rendered, so a signature
+reads `[Signature: Jane Q Doe]` rather than a bare name. Annotation bills at
+`LLM.PAGE_COST_ANNOTATED`; replace the schema with
+`providerOptions.bbox_annotation_format` or pass `null` to disable it.
+
 Emulation sends each page alone (a PDF is trimmed to one page per call, so
 the model never numbers pages), asks for verbatim Markdown with
 `[UNCLEAR: best guess]` and `[ELEMENT: description]` markers, transcribes a
@@ -751,7 +782,7 @@ for await (const chunk of Llm.stream(input, {
 
 ## Fallback Providers
 
-Configure a chain of fallback providers that automatically retry failed calls when the primary provider fails:
+Configure a chain of fallback providers. Any error (rate limit, 5xx, network flake, bad request) moves to the next entry at once, with no retry or wait. When every entry has failed, the primary runs once more with its full retry policy; if that fails, the call throws. A caller abort (`LlmAbortError`) never falls over:
 
 ```typescript
 // Instance-level configuration
@@ -783,7 +814,7 @@ const response = await Llm.operate(input, {
 ```typescript
 response.provider; // Which provider handled the request
 response.fallbackUsed; // true if a fallback was used
-response.fallbackAttempts; // Number of providers tried (1 = primary only)
+response.fallbackAttempts; // Attempts made (1 = primary only; chain length + 2 when the linger pass served it)
 ```
 
 ## Instance Usage
@@ -928,9 +959,12 @@ await Llm.operate(input, {
 });
 ```
 
-A configured fallback chain wins over waiting: moving to the next provider is
-faster than sleeping, so only the final entry in the chain keeps its rate-limit
-budget. Waits are interruptible by the caller's `signal`.
+A configured fallback chain wins over waiting. Every entry, the last included,
+fails fast on any error (`retry: { rateLimit: false, transient: false }`) so the
+next model takes over at once. When the whole chain fails, the primary runs one
+more time with the full policy (the caller's `retry` applies here) and its error
+is final. `transient: false` also works on a single call. Waits are
+interruptible by the caller's `signal`.
 
 ### Loop Stops