slackmark 0.5.0 → 0.6.1

package/README.md

@@ -15,7 +15,7 @@ renders any Block Kit JSON and pairs perfectly with `slackmark`.
 - Ordered fallback chains with `Degradation` records (never silent)
 - Message budgets (50 blocks, table/markdown/chart caps)
 - Mermaid `pie` / `xychart-beta` → native charts; other mermaid diagrams → configured `renderers` or preformatted fallback
-- Math and non-mermaid diagram fences → preformatted/code text (renderers are not consulted)
+- Display math and non-mermaid code fences → configured `renderers` or preformatted/code text
 - OOP + constructor DI; `convert()` convenience for simple use
 
 ## Quickstart
@@ -24,15 +24,17 @@ renders any Block Kit JSON and pairs perfectly with `slackmark`.
 pnpm add slackmark
 ```
 
-```ts
+```ts snippet=fragment note="assumes an options object shown in the prose above"
 import { convert } from "slackmark";
 
-const { blocks, text, degradations } = await convert("# Hello **Slack**");
+const { blocks, text, degradations, receipts } = await convert("# Hello **Slack**", {
+  timeoutMs: 5_000,
+});
 ```
 
 Advanced (inject fakes / custom adapters):
 
-```ts
+```ts snippet=fragment note="assumes markdown"
 import { createConverter } from "slackmark";
 
 const converter = createConverter({
@@ -54,7 +56,8 @@ const result = await converter.convert(markdown);
 | `ImageRenderer` / `SlackUploader` | Renderer and upload seams |
 | `validateBlocks` | Limit validator |
 
-Result shape: `{ blocks, text, degradations }` — total on user markdown (never throws).
+Result shape: `{ blocks, text, degradations, receipts }`. Receipts report external upload
+effects separately from content fallbacks.
 
 ## Compat profiles
 
@@ -74,44 +77,53 @@ Pass a preset name, a flags object, and/or `capabilityOverrides`.
 
 Built-in adapters cover the mapping matrix. Prepend custom `NodeAdapter`s via `createConverter({ adapters })`.
 
-No renderer or uploader is enabled by default, so default conversion performs no network I/O. **Only the mermaid fence adapter reads `config.renderers`** — and only after native `pie` / `xychart-beta` charts are unavailable. Math always becomes preformatted/code text; non-mermaid diagram fences (PlantUML, D2, Chart.js, …) always become code blocks. Image-rendered math and non-mermaid diagrams are planned as future Node-only packages.
+No renderer or uploader is enabled by default, so default conversion performs no network I/O. Mermaid fences consult `config.renderers` after native `pie` / `xychart-beta` candidates. Display math and generic code fences consult the same ordered renderer list before their preformatted fallback. Each renderer's `canRender` method decides which normalized languages it accepts.
 
-Hosted URL renderers compose durable public PNG URLs (no network I/O in core); they return `null` when Slack's 3,000-character `image_url` limit would be exceeded. An absent or declining renderer falls back to preformatted mermaid source and records a degradation.
+Hosted URL renderers compose durable public HTTPS PNG URLs (no network I/O in core); they return `null` when Slack's 3,000-character `image_url` limit would be exceeded. Renderer, uploader, and capability-check failures remain scoped to one Markdown node. Attempt failures are buffered while later renderers run: a later success emits no degradation, while an all-failed chain records structured details before text fallback.
 
 Import first-party URL adapters from the dedicated subpath:
 
-```ts
+```ts snippet=fragment note="converter options shape"
 import { createConverter } from "slackmark";
 import { KrokiRenderer, MermaidInkRenderer } from "slackmark/renderers";
 
 const converter = createConverter({
   renderers: [new MermaidInkRenderer()],
-  // or: renderers: [new KrokiRenderer()],  // consulted for lang=mermaid only
+  // or: renderers: [new KrokiRenderer()],
 });
 ```
 
 - `MermaidInkRenderer` emits pako-state PNG URLs for mermaid fences with a non-transparent background by default.
-- `KrokiRenderer` can render mermaid fences the same way (its other diagram-type aliases are unused by conversion today).
-- `CodeCogsRenderer` and `QuickChartRenderer` are also exported from `slackmark/renderers` as `ImageRenderer` implementations, but no adapter calls them during conversion.
+- `KrokiRenderer` handles Mermaid and supported diagram fence languages such as `d2`, `dot`, and `plantuml`.
+- `CodeCogsRenderer` handles display math and `katex`, `latex`, `math`, or `tex` fences.
+- `QuickChartRenderer` handles `chart`, `chart.js`, `chartjs`, and `quickchart` fences.
+
+For local Mermaid and KaTeX PNGs in a Node bot, install `slackmark-node` and use
+its resource-owning helper. See the
+[`slackmark-node` README](../node-renderers/README.md) and the
+[Rasterize content guide](https://github.com/SirajChokshi/slackmark/blob/main/apps/site/src/docs/slackmark/rasterize-content/overview.mdx),
+whose lifecycle example preserves both the primary error and a close error.
+
+It reuses one lazy Chromium instance; the uploader lifetime and credentials stay
+separate. `slackmark-node` requires Node 22.12+; core remains universal.
 
 Hosted services receive the diagram source encoded in the URL when Slack fetches the image. Treat them as explicit data-egress opt-ins. Each adapter accepts `baseUrl` for a self-hosted deployment:
 
-```ts
+```ts snippet=fragment note="renderer list, not a program"
 const privateRenderers = [
   new KrokiRenderer({ baseUrl: "https://kroki.internal.example" }),
   new MermaidInkRenderer({ baseUrl: "https://mermaid.internal.example" }),
 ];
 ```
 
-Bytes-producing renderers need a `SlackUploader`. The fetch implementation uses Slack's external upload flow and waits for `files.info` to report processed image metadata before returning:
+Bytes results use a `SlackUploader`. A missing uploader is deferred while later renderers can recover, then becomes a terminal `ConfigurationError` only if no renderer succeeds. Upload effects are returned separately in immutable `receipts`, including effects from failed attempts. The fetch implementation uses Slack's external upload flow:
 
-```ts
+```ts snippet=fragment note="assumes markdown"
 import { createConverter } from "slackmark";
 import { FetchSlackUploader } from "slackmark/slack";
 
 const uploader = new FetchSlackUploader({
   token: slackBotToken,
-  channelId: targetChannelId,
 });
 
 const converter = createConverter({
@@ -120,7 +132,7 @@ const converter = createConverter({
 });
 ```
 
-Inject `fetch`, sleep, and clock functions for deterministic tests. The Slack token needs `files:write` and `files:read`; supplying `channelId` shares the upload to the target channel for reliable `slack_file` rendering.
+Inject `fetch`, sleep, and clock functions for deterministic tests. The Slack token needs `files:write`. Optional `files.info` processing polling additionally needs `files:read`; explicit `channelId` sharing can create a separate file-share message.
 
 ## Raw Slack entities
 
@@ -132,7 +144,7 @@ syntax literal, wrap it in a code span (`` `<@U123>` ``).
 
 ## Optional remark plugins
 
-`remark-math` and `remark-frontmatter` are dependencies; enable with `enableMath` / `enableFrontmatter`. Math is parsed when enabled, then emitted as preformatted/code text.
+`remark-math` and `remark-frontmatter` are dependencies; enable with `enableMath` / `enableFrontmatter`. Display math is parsed when enabled, then offered to configured renderers before preformatted fallback. Single-dollar inline math is a separate opt-in (`enableInlineMath`): agent prose is far likelier to contain `$200/mo` than `$x$`, and reading the span between two dollar signs as math deletes both signs. When it is opted into, inline math stays code-styled text.
 
 ## License
 

package/dist/adapters/block-to-plain-text.d.ts

@@ -0,0 +1,24 @@
+import type { Nodes } from "mdast";
+/**
+ * Plain text for a block that had to be flattened into a single text run.
+ *
+ * `mdast-util-to-string` concatenates every descendant with no separator, so a
+ * table collapses to "ab12" and sibling paragraphs run together as
+ * "para onepara two". Flattening is already flagged as a degradation; the text
+ * it leaves behind still has to be readable, so re-insert the separators the
+ * structure carried.
+ */
+export declare function blockToPlainText(node: Nodes): string;
+/** A link or image URL that flattening is about to discard. */
+export interface FlattenedUrl {
+    readonly nodeType: "link" | "image";
+    readonly url: string;
+}
+/**
+ * Link and image URLs carried by a block that is about to be flattened.
+ * {@link blockToPlainText} keeps only labels and alt text, so callers must
+ * flag these before they disappear — silent omission is a bug even when the
+ * surrounding flattening is itself already flagged.
+ */
+export declare function collectFlattenedUrls(node: unknown, into: FlattenedUrl[]): void;
+//# sourceMappingURL=block-to-plain-text.d.ts.map

package/dist/adapters/block-to-plain-text.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"block-to-plain-text.d.ts","sourceRoot":"","sources":["../../src/adapters/block-to-plain-text.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,OAAO,CAAC;AAGnC;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,KAAK,GAAG,MAAM,CAmBpD;AAED,+DAA+D;AAC/D,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC;IACpC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;CACtB;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,YAAY,EAAE,GAAG,IAAI,CAiB9E"}

package/dist/adapters/blockquote-adapter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"blockquote-adapter.d.ts","sourceRoot":"","sources":["../../src/adapters/blockquote-adapter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAc,WAAW,EAAE,MAAM,OAAO,CAAC;AAIrD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,iCAAiC,CAAC;AAGzE,OAAO,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAYhE;;GAEG;AACH,qBAAa,iBAAkB,YAAW,WAAW;IACnD,KAAK,CAAC,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,iBAAiB,GAAG,OAAO,CAEzD;IAED,IAAI,CAAC,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,iBAAiB,GAAG,aAAa,CAAC,SAAS,CAAC,CAezE;CACF"}
+{"version":3,"file":"blockquote-adapter.d.ts","sourceRoot":"","sources":["../../src/adapters/blockquote-adapter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAc,WAAW,EAAE,MAAM,OAAO,CAAC;AAGrD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,iCAAiC,CAAC;AAQzE,OAAO,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAYhE;;GAEG;AACH,qBAAa,iBAAkB,YAAW,WAAW;IACnD,KAAK,CAAC,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,iBAAiB,GAAG,OAAO,CAEzD;IAED,IAAI,CAAC,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,iBAAiB,GAAG,aAAa,CAAC,SAAS,CAAC,CAezE;CACF"}

package/dist/adapters/code-fence-adapter.d.ts

@@ -2,7 +2,7 @@ import type { RootContent } from "mdast";
 import type { ConversionContext } from "../budget/conversion-context.js";
 import type { Candidate, NodeAdapter } from "./node-adapter.js";
 /**
- * Plain code fences → rich_text_preformatted (+language when flagged).
+ * Code fences → configured image renderer / rich_text_preformatted.
  * Mermaid/math dialects are handled by more specific adapters that match first.
  */
 export declare class CodeFenceAdapter implements NodeAdapter {

package/dist/adapters/code-fence-adapter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"code-fence-adapter.d.ts","sourceRoot":"","sources":["../../src/adapters/code-fence-adapter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAQ,WAAW,EAAE,MAAM,OAAO,CAAC;AAG/C,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,iCAAiC,CAAC;AAGzE,OAAO,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAEhE;;;GAGG;AACH,qBAAa,gBAAiB,YAAW,WAAW;IAClD,KAAK,CAAC,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,iBAAiB,GAAG,OAAO,CAEzD;IAED,IAAI,CAAC,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,iBAAiB,GAAG,aAAa,CAAC,SAAS,CAAC,CAyBzE;CACF"}
+{"version":3,"file":"code-fence-adapter.d.ts","sourceRoot":"","sources":["../../src/adapters/code-fence-adapter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAQ,WAAW,EAAE,MAAM,OAAO,CAAC;AAG/C,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,iCAAiC,CAAC;AAGzE,OAAO,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAGhE;;;GAGG;AACH,qBAAa,gBAAiB,YAAW,WAAW;IAClD,KAAK,CAAC,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,iBAAiB,GAAG,OAAO,CAEzD;IAED,IAAI,CAAC,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,iBAAiB,GAAG,aAAa,CAAC,SAAS,CAAC,CAyCzE;CACF"}

package/dist/adapters/inline.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"inline.d.ts","sourceRoot":"","sources":["../../src/adapters/inline.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAiC,eAAe,EAAgB,MAAM,OAAO,CAAC;AAG1F,OAAO,KAAK,EACV,UAAU,EACV,aAAa,EAEb,cAAc,EAEd,aAAa,EAEd,MAAM,oBAAoB,CAAC;AAC5B,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,iCAAiC,CAAC;AAYzE,MAAM,MAAM,YAAY,GAAG;IACzB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,CAAC;CACpC,CAAC;AAEF,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,QAAQ,EAAE,aAAa,CAAC,cAAc,CAAC,CAAC;IACjD,QAAQ,CAAC,aAAa,EAAE,aAAa,CAAC,YAAY,CAAC,CAAC;CACrD;AAED;;GAEG;AACH,wBAAgB,YAAY,CAC1B,KAAK,EAAE,aAAa,CAAC,eAAe,CAAC,EACrC,GAAG,EAAE,iBAAiB,EACtB,SAAS,GAAE,aAAkB,GAC5B,gBAAgB,CAiQlB;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,aAAa,CAAC,eAAe,CAAC,GAAG,MAAM,CAE7E;AAED,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAerD;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,aAAa,CAAC,eAAe,CAAC,EACrC,GAAG,EAAE,iBAAiB,GACrB,MAAM,CAuCR;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,OAAO,CAAA;CAAE,CAK9F;AAED,2EAA2E;AAC3E,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,YAAY,EAAE,GAAG,EAAE,iBAAiB,GAAG,UAAU,CAUrF;AAED,gFAAgF;AAChF,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,iBAAiB,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAY/F;AAED,gFAAgF;AAChF,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,SAAS,GAAG,aAAa,CAY9F;AAED,mFAAmF;AACnF,wBAAgB,cAAc,CAC5B,KAAK,EAAE,MAAM,EACb,GAAG,EAAE,iBAAiB,EACtB,KAAK,EAAE,UAAU,GAAG,OAAO,GAC1B,MAAM,CAYR;AA0LD;;;GAGG;AACH,wBAAgB,0BAA0B,CACxC,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,aAAa,GACnB,aAAa,CAAC,cAAc,CAAC,GAAG,SAAS,CAI3C;AAED,gGAAgG;AAChG,wBAAgB,8BAA8B,CAC5C,KAAK,EAAE,aAAa,CAAC,eAAe,CAAC,EACrC,GAAG,EAAE,iBAAiB,GACrB,OAAO,CAQT;AA4HD;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAKnD"}
+{"version":3,"file":"inline.d.ts","sourceRoot":"","sources":["../../src/adapters/inline.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAiC,eAAe,EAAgB,MAAM,OAAO,CAAC;AAG1F,OAAO,KAAK,EACV,UAAU,EACV,aAAa,EAEb,cAAc,EAEd,aAAa,EAEd,MAAM,oBAAoB,CAAC;AAC5B,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,iCAAiC,CAAC;AAYzE,MAAM,MAAM,YAAY,GAAG;IACzB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,CAAC;CACpC,CAAC;AAEF,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,QAAQ,EAAE,aAAa,CAAC,cAAc,CAAC,CAAC;IACjD,QAAQ,CAAC,aAAa,EAAE,aAAa,CAAC,YAAY,CAAC,CAAC;CACrD;AAED;;GAEG;AACH,wBAAgB,YAAY,CAC1B,KAAK,EAAE,aAAa,CAAC,eAAe,CAAC,EACrC,GAAG,EAAE,iBAAiB,EACtB,SAAS,GAAE,aAAkB,GAC5B,gBAAgB,CAiQlB;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,aAAa,CAAC,eAAe,CAAC,GAAG,MAAM,CAE7E;AAED,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAerD;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,aAAa,CAAC,eAAe,CAAC,EACrC,GAAG,EAAE,iBAAiB,GACrB,MAAM,CAuCR;AAsDD,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,OAAO,CAAA;CAAE,CAK9F;AAED,2EAA2E;AAC3E,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,YAAY,EAAE,GAAG,EAAE,iBAAiB,GAAG,UAAU,CAUrF;AAED,gFAAgF;AAChF,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,iBAAiB,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAY/F;AAED,gFAAgF;AAChF,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,SAAS,GAAG,aAAa,CAY9F;AAED,mFAAmF;AACnF,wBAAgB,cAAc,CAC5B,KAAK,EAAE,MAAM,EACb,GAAG,EAAE,iBAAiB,EACtB,KAAK,EAAE,UAAU,GAAG,OAAO,GAC1B,MAAM,CAYR;AA0LD;;;GAGG;AACH,wBAAgB,0BAA0B,CACxC,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,aAAa,GACnB,aAAa,CAAC,cAAc,CAAC,GAAG,SAAS,CAI3C;AAED,gGAAgG;AAChG,wBAAgB,8BAA8B,CAC5C,KAAK,EAAE,aAAa,CAAC,eAAe,CAAC,EACrC,GAAG,EAAE,iBAAiB,GACrB,OAAO,CAQT;AA8HD;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAKnD"}

package/dist/adapters/list-adapter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"list-adapter.d.ts","sourceRoot":"","sources":["../../src/adapters/list-adapter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAA6B,WAAW,EAAE,MAAM,OAAO,CAAC;AAI1E,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,iCAAiC,CAAC;AASzE,OAAO,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAEhE;;GAEG;AACH,qBAAa,WAAY,YAAW,WAAW;IAC7C,KAAK,CAAC,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,iBAAiB,GAAG,OAAO,CAKzD;IAED,IAAI,CAAC,IAAI,EAAE,WAAW,EAAE,GAAG,EAAE,iBAAiB,GAAG,aAAa,CAAC,SAAS,CAAC,CA2BxE;CACF;AAmBD,wBAAgB,UAAU,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAE9C"}
+{"version":3,"file":"list-adapter.d.ts","sourceRoot":"","sources":["../../src/adapters/list-adapter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAA6B,WAAW,EAAE,MAAM,OAAO,CAAC;AAG1E,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,iCAAiC,CAAC;AAczE,OAAO,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAEhE;;GAEG;AACH,qBAAa,WAAY,YAAW,WAAW;IAC7C,KAAK,CAAC,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,iBAAiB,GAAG,OAAO,CAKzD;IAED,IAAI,CAAC,IAAI,EAAE,WAAW,EAAE,GAAG,EAAE,iBAAiB,GAAG,aAAa,CAAC,SAAS,CAAC,CA2BxE;CACF;AAmBD,wBAAgB,UAAU,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAE9C"}

package/dist/adapters/math-block-adapter.d.ts

@@ -2,7 +2,7 @@ import type { RootContent } from "mdast";
 import type { ConversionContext } from "../budget/conversion-context.js";
 import type { Candidate, NodeAdapter } from "./node-adapter.js";
 /**
- * Display math → preformatted TeX (`config.renderers` is not consulted).
+ * Display math → configured image renderer / preformatted TeX.
  */
 export declare class MathBlockAdapter implements NodeAdapter {
     match(node: RootContent, _ctx: ConversionContext): boolean;

package/dist/adapters/math-block-adapter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"math-block-adapter.d.ts","sourceRoot":"","sources":["../../src/adapters/math-block-adapter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,OAAO,CAAC;AAGzC,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,iCAAiC,CAAC;AAGzE,OAAO,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAEhE;;GAEG;AACH,qBAAa,gBAAiB,YAAW,WAAW;IAClD,KAAK,CAAC,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,iBAAiB,GAAG,OAAO,CAEzD;IAED,IAAI,CAAC,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,iBAAiB,GAAG,aAAa,CAAC,SAAS,CAAC,CAwBzE;CACF"}
+{"version":3,"file":"math-block-adapter.d.ts","sourceRoot":"","sources":["../../src/adapters/math-block-adapter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,OAAO,CAAC;AAGzC,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,iCAAiC,CAAC;AAGzE,OAAO,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAGhE;;GAEG;AACH,qBAAa,gBAAiB,YAAW,WAAW;IAClD,KAAK,CAAC,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,iBAAiB,GAAG,OAAO,CAEzD;IAED,IAAI,CAAC,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,iBAAiB,GAAG,aAAa,CAAC,SAAS,CAAC,CAuCzE;CACF"}

package/dist/adapters/mermaid-fence-adapter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mermaid-fence-adapter.d.ts","sourceRoot":"","sources":["../../src/adapters/mermaid-fence-adapter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAQ,WAAW,EAAE,MAAM,OAAO,CAAC;AAG/C,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,iCAAiC,CAAC;AAUzE,OAAO,KAAK,EAEV,kBAAkB,EAKnB,MAAM,aAAa,CAAC;AAGrB,OAAO,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAEhE,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,SAAS,EAAE,kBAAkB,CAAC;IACvC,QAAQ,CAAC,QAAQ,EAAE,kBAAkB,CAAC;CACvC;AAED;;GAEG;AACH,qBAAa,mBAAoB,YAAW,WAAW;IACrD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAqB;IAC/C,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAqB;IAE9C,YAAY,IAAI,EAAE,uBAAuB,EAGxC;IAED,KAAK,CAAC,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,iBAAiB,GAAG,OAAO,CAEzD;IAED,IAAI,CAAC,IAAI,EAAE,WAAW,EAAE,GAAG,EAAE,iBAAiB,GAAG,aAAa,CAAC,SAAS,CAAC,CA+DxE;CACF"}
+{"version":3,"file":"mermaid-fence-adapter.d.ts","sourceRoot":"","sources":["../../src/adapters/mermaid-fence-adapter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAQ,WAAW,EAAE,MAAM,OAAO,CAAC;AAG/C,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,iCAAiC,CAAC;AASzE,OAAO,KAAK,EAAE,kBAAkB,EAAoC,MAAM,aAAa,CAAC;AAGxF,OAAO,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAGhE,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,SAAS,EAAE,kBAAkB,CAAC;IACvC,QAAQ,CAAC,QAAQ,EAAE,kBAAkB,CAAC;CACvC;AAED;;GAEG;AACH,qBAAa,mBAAoB,YAAW,WAAW;IACrD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAqB;IAC/C,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAqB;IAE9C,YAAY,IAAI,EAAE,uBAAuB,EAGxC;IAED,KAAK,CAAC,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,iBAAiB,GAAG,OAAO,CAEzD;IAED,IAAI,CAAC,IAAI,EAAE,WAAW,EAAE,GAAG,EAAE,iBAAiB,GAAG,aAAa,CAAC,SAAS,CAAC,CA+ExE;CACF"}

package/dist/adapters/table-adapter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"table-adapter.d.ts","sourceRoot":"","sources":["../../src/adapters/table-adapter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAa,WAAW,EAAsC,MAAM,OAAO,CAAC;AAYxF,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,iCAAiC,CAAC;AAWzE,OAAO,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAEhE;;GAEG;AACH,qBAAa,YAAa,YAAW,WAAW;IAC9C,KAAK,CAAC,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,iBAAiB,GAAG,OAAO,CAEzD;IAED,IAAI,CAAC,IAAI,EAAE,WAAW,EAAE,GAAG,EAAE,iBAAiB,GAAG,aAAa,CAAC,SAAS,CAAC,CAqFxE;CACF"}
+{"version":3,"file":"table-adapter.d.ts","sourceRoot":"","sources":["../../src/adapters/table-adapter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAa,WAAW,EAAsC,MAAM,OAAO,CAAC;AAYxF,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,iCAAiC,CAAC;AAazE,OAAO,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAEhE;;GAEG;AACH,qBAAa,YAAa,YAAW,WAAW;IAC9C,KAAK,CAAC,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,iBAAiB,GAAG,OAAO,CAEzD;IAED,IAAI,CAAC,IAAI,EAAE,WAAW,EAAE,GAAG,EAAE,iBAAiB,GAAG,aAAa,CAAC,SAAS,CAAC,CAqFxE;CACF"}

package/dist/adapters/task-list-adapter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"task-list-adapter.d.ts","sourceRoot":"","sources":["../../src/adapters/task-list-adapter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAkB,WAAW,EAAE,MAAM,OAAO,CAAC;AAUzD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,iCAAiC,CAAC;AAIzE,OAAO,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAEhE;;GAEG;AACH,qBAAa,eAAgB,YAAW,WAAW;IACjD,KAAK,CAAC,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,iBAAiB,GAAG,OAAO,CAEzD;IAED,IAAI,CAAC,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,iBAAiB,GAAG,aAAa,CAAC,SAAS,CAAC,CA0BzE;CACF"}
+{"version":3,"file":"task-list-adapter.d.ts","sourceRoot":"","sources":["../../src/adapters/task-list-adapter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAkB,WAAW,EAAE,MAAM,OAAO,CAAC;AAUzD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,iCAAiC,CAAC;AAKzE,OAAO,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAEhE;;GAEG;AACH,qBAAa,eAAgB,YAAW,WAAW;IACjD,KAAK,CAAC,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,iBAAiB,GAAG,OAAO,CAEzD;IAED,IAAI,CAAC,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,iBAAiB,GAAG,aAAa,CAAC,SAAS,CAAC,CA4BzE;CACF"}

package/dist/adapters/try-render-image.d.ts

@@ -0,0 +1,9 @@
+import type { ImageBlock } from "../blocks/types.js";
+import type { ConversionContext } from "../budget/conversion-context.js";
+import { type RenderRequest } from "../types.js";
+/**
+ * Try configured renderers in order and turn the first successful result into
+ * a Slack image block. Attempt failures are emitted only on terminal fallback.
+ */
+export declare function tryRenderImage(request: RenderRequest, nodeType: string, ctx: ConversionContext): Promise<ImageBlock | undefined>;
+//# sourceMappingURL=try-render-image.d.ts.map

package/dist/adapters/try-render-image.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"try-render-image.d.ts","sourceRoot":"","sources":["../../src/adapters/try-render-image.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,iCAAiC,CAAC;AAiBzE,OAAO,EAOL,KAAK,aAAa,EAInB,MAAM,aAAa,CAAC;AA4BrB;;;GAGG;AACH,wBAAsB,cAAc,CAClC,OAAO,EAAE,aAAa,EACtB,QAAQ,EAAE,MAAM,EAChB,GAAG,EAAE,iBAAiB,GACrB,OAAO,CAAC,UAAU,GAAG,SAAS,CAAC,CAqIjC"}

package/dist/assemble/message-assembler.d.ts

@@ -21,4 +21,14 @@ export declare function buildFootnoteBlocks(entries: ReadonlyArray<{
     readonly n: number;
     readonly text: string;
 }>, degradations?: DegradationCollector): ReadonlyArray<Block>;
+/**
+ * How many blocks `blocks` adds to a message whose last block is `previous`, once
+ * {@link MessageAssembler.assemble} has merged adjacent rich_text sections.
+ *
+ * Emission reserves one block per source node before it knows what the node produces, so
+ * without this a run of 60 paragraphs exhausts the 50-block budget even though it
+ * coalesces into a single block. The converter reconciles the reservation against this
+ * count so the budget tracks what is actually emitted.
+ */
+export declare function coalescedBlockCount(previous: Block | undefined, blocks: ReadonlyArray<Block>): number;
 //# sourceMappingURL=message-assembler.d.ts.map

package/dist/assemble/message-assembler.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"message-assembler.d.ts","sourceRoot":"","sources":["../../src/assemble/message-assembler.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,KAAK,EAMN,MAAM,oBAAoB,CAAC;AAE5B,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,iCAAiC,CAAC;AAOzE,OAAO,KAAK,EAEV,iBAAiB,EACjB,oBAAoB,EACpB,iBAAiB,EAClB,MAAM,aAAa,CAAC;AAIrB,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,SAAS,EAAE,iBAAiB,CAAC;CACvC;AAED;;GAEG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAoB;IAE9C,YAAY,IAAI,EAAE,oBAAoB,EAErC;IAED,QAAQ,CACN,MAAM,EAAE,aAAa,CAAC,KAAK,CAAC,EAC5B,GAAG,EAAE,iBAAiB,EACtB,cAAc,EAAE,aAAa,CAAC,KAAK,CAAC,GACnC,aAAa,CAAC,iBAAiB,CAAC,CAsClC;IAED,OAAO,CAAC,aAAa;IAkDrB,OAAO,CAAC,SAAS;CAclB;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,aAAa,CAAC;IAAE,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,EACrE,YAAY,CAAC,EAAE,oBAAoB,GAClC,aAAa,CAAC,KAAK,CAAC,CA0BtB"}
+{"version":3,"file":"message-assembler.d.ts","sourceRoot":"","sources":["../../src/assemble/message-assembler.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,KAAK,EAMN,MAAM,oBAAoB,CAAC;AAE5B,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,iCAAiC,CAAC;AAOzE,OAAO,KAAK,EAEV,iBAAiB,EACjB,oBAAoB,EACpB,iBAAiB,EAClB,MAAM,aAAa,CAAC;AAIrB,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,SAAS,EAAE,iBAAiB,CAAC;CACvC;AAED;;GAEG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAoB;IAE9C,YAAY,IAAI,EAAE,oBAAoB,EAErC;IAED,QAAQ,CACN,MAAM,EAAE,aAAa,CAAC,KAAK,CAAC,EAC5B,GAAG,EAAE,iBAAiB,EACtB,cAAc,EAAE,aAAa,CAAC,KAAK,CAAC,GACnC,aAAa,CAAC,iBAAiB,CAAC,CAsClC;IAED,OAAO,CAAC,aAAa;IAkDrB,OAAO,CAAC,SAAS;CAclB;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,aAAa,CAAC;IAAE,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,EACrE,YAAY,CAAC,EAAE,oBAAoB,GAClC,aAAa,CAAC,KAAK,CAAC,CA0BtB;AA6CD;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,KAAK,GAAG,SAAS,EAC3B,MAAM,EAAE,aAAa,CAAC,KAAK,CAAC,GAC3B,MAAM,CAUR"}

package/dist/budget/conversion-context.d.ts

@@ -1,6 +1,6 @@
 import type { Definition, FootnoteDefinition } from "mdast";
 import type { CapabilityFlags } from "../capabilities/capabilities.js";
-import type { BudgetLedger, ConversionStrategy, DegradationCollector, ImageRenderer, MentionResolvers, OverflowMode, SlackUploader } from "../types.js";
+import type { BudgetLedger, ConversionStrategy, DegradationCollector, ImageRenderer, MentionResolvers, OperationContext, OverflowMode, ReceiptCollector, SlackUploader } from "../types.js";
 /**
  * Immutable resolved config for one conversion.
  */
@@ -11,13 +11,16 @@ export interface ResolvedConfig {
     readonly renderers: ReadonlyArray<ImageRenderer>;
     readonly uploader: SlackUploader | undefined;
     readonly enableMath: boolean;
+    readonly enableInlineMath: boolean;
     readonly enableFrontmatter: boolean;
     readonly mentionResolvers: MentionResolvers | undefined;
+    readonly operation: OperationContext;
 }
 export interface ConversionContextDeps {
     readonly config: ResolvedConfig;
     readonly budget: BudgetLedger;
     readonly degradations: DegradationCollector;
+    readonly receipts: ReceiptCollector;
     readonly definitions: ReadonlyMap<string, Definition>;
     readonly footnotes: ReadonlyMap<string, FootnoteDefinition>;
     readonly footnoteOrder: ReadonlyArray<string>;
@@ -31,6 +34,7 @@ export declare class ConversionContext {
     readonly config: ResolvedConfig;
     readonly budget: BudgetLedger;
     readonly degradations: DegradationCollector;
+    readonly receipts: ReceiptCollector;
     readonly definitions: ReadonlyMap<string, Definition>;
     readonly footnotes: ReadonlyMap<string, FootnoteDefinition>;
     readonly footnoteOrder: ReadonlyArray<string>;

package/dist/budget/conversion-context.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"conversion-context.d.ts","sourceRoot":"","sources":["../../src/budget/conversion-context.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,kBAAkB,EAAE,MAAM,OAAO,CAAC;AAE5D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAC;AACvE,OAAO,KAAK,EACV,YAAY,EACZ,kBAAkB,EAClB,oBAAoB,EACpB,aAAa,EACb,gBAAgB,EAChB,YAAY,EACZ,aAAa,EACd,MAAM,aAAa,CAAC;AAErB;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,YAAY,EAAE,eAAe,CAAC;IACvC,QAAQ,CAAC,QAAQ,EAAE,YAAY,CAAC;IAChC,QAAQ,CAAC,QAAQ,EAAE,kBAAkB,CAAC;IACtC,QAAQ,CAAC,SAAS,EAAE,aAAa,CAAC,aAAa,CAAC,CAAC;IACjD,QAAQ,CAAC,QAAQ,EAAE,aAAa,GAAG,SAAS,CAAC;IAC7C,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;IAC7B,QAAQ,CAAC,iBAAiB,EAAE,OAAO,CAAC;IACpC,QAAQ,CAAC,gBAAgB,EAAE,gBAAgB,GAAG,SAAS,CAAC;CACzD;AAED,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAC;IAChC,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAC;IAC9B,QAAQ,CAAC,YAAY,EAAE,oBAAoB,CAAC;IAC5C,QAAQ,CAAC,WAAW,EAAE,WAAW,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IACtD,QAAQ,CAAC,SAAS,EAAE,WAAW,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC;IAC5D,QAAQ,CAAC,aAAa,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IAC9C,QAAQ,CAAC,gBAAgB,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED;;GAEG;AACH,qBAAa,iBAAiB;IAC5B,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAC;IAChC,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAC;IAC9B,QAAQ,CAAC,YAAY,EAAE,oBAAoB,CAAC;IAC5C,QAAQ,CAAC,WAAW,EAAE,WAAW,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IACtD,QAAQ,CAAC,SAAS,EAAE,WAAW,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC;IAC5D,QAAQ,CAAC,aAAa,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IAC9C,QAAQ,CAAC,gBAAgB,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB,YAAY,IAAI,EAAE,qBAAqB,EAStC;IAED,gBAAgB,CAAC,YAAY,EAAE,oBAAoB,GAAG,iBAAiB,CAWtE;CACF"}
+{"version":3,"file":"conversion-context.d.ts","sourceRoot":"","sources":["../../src/budget/conversion-context.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,kBAAkB,EAAE,MAAM,OAAO,CAAC;AAE5D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAC;AACvE,OAAO,KAAK,EACV,YAAY,EACZ,kBAAkB,EAClB,oBAAoB,EACpB,aAAa,EACb,gBAAgB,EAChB,gBAAgB,EAChB,YAAY,EACZ,gBAAgB,EAChB,aAAa,EACd,MAAM,aAAa,CAAC;AAErB;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,YAAY,EAAE,eAAe,CAAC;IACvC,QAAQ,CAAC,QAAQ,EAAE,YAAY,CAAC;IAChC,QAAQ,CAAC,QAAQ,EAAE,kBAAkB,CAAC;IACtC,QAAQ,CAAC,SAAS,EAAE,aAAa,CAAC,aAAa,CAAC,CAAC;IACjD,QAAQ,CAAC,QAAQ,EAAE,aAAa,GAAG,SAAS,CAAC;IAC7C,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;IAC7B,QAAQ,CAAC,gBAAgB,EAAE,OAAO,CAAC;IACnC,QAAQ,CAAC,iBAAiB,EAAE,OAAO,CAAC;IACpC,QAAQ,CAAC,gBAAgB,EAAE,gBAAgB,GAAG,SAAS,CAAC;IACxD,QAAQ,CAAC,SAAS,EAAE,gBAAgB,CAAC;CACtC;AAED,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAC;IAChC,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAC;IAC9B,QAAQ,CAAC,YAAY,EAAE,oBAAoB,CAAC;IAC5C,QAAQ,CAAC,QAAQ,EAAE,gBAAgB,CAAC;IACpC,QAAQ,CAAC,WAAW,EAAE,WAAW,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IACtD,QAAQ,CAAC,SAAS,EAAE,WAAW,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC;IAC5D,QAAQ,CAAC,aAAa,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IAC9C,QAAQ,CAAC,gBAAgB,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED;;GAEG;AACH,qBAAa,iBAAiB;IAC5B,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAC;IAChC,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAC;IAC9B,QAAQ,CAAC,YAAY,EAAE,oBAAoB,CAAC;IAC5C,QAAQ,CAAC,QAAQ,EAAE,gBAAgB,CAAC;IACpC,QAAQ,CAAC,WAAW,EAAE,WAAW,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IACtD,QAAQ,CAAC,SAAS,EAAE,WAAW,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC;IAC5D,QAAQ,CAAC,aAAa,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IAC9C,QAAQ,CAAC,gBAAgB,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB,YAAY,IAAI,EAAE,qBAAqB,EAUtC;IAED,gBAAgB,CAAC,YAAY,EAAE,oBAAoB,GAAG,iBAAiB,CAYtE;CACF"}

package/dist/budget/operation-scope.d.ts

@@ -0,0 +1,9 @@
+import type { OperationContext, OperationOptions } from "../types.js";
+export interface OperationScope {
+    readonly context: OperationContext;
+    race<T>(promise: Promise<T>): Promise<T>;
+    cleanup(): void;
+}
+export declare function createOperationScope(options: OperationOptions, stage: string): OperationScope;
+export declare function throwIfOperationEnded(context: OperationContext, stage: string): void;
+//# sourceMappingURL=operation-scope.d.ts.map

package/dist/budget/operation-scope.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"operation-scope.d.ts","sourceRoot":"","sources":["../../src/budget/operation-scope.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAEtE,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,OAAO,EAAE,gBAAgB,CAAC;IACnC,IAAI,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IACzC,OAAO,IAAI,IAAI,CAAC;CACjB;AAED,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,gBAAgB,EAAE,KAAK,EAAE,MAAM,GAAG,cAAc,CAqC7F;AAED,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,gBAAgB,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAQpF"}

package/dist/budget/recording-receipt-collector.d.ts

@@ -0,0 +1,13 @@
+import type { ReceiptCollector, UploadReceipt } from "../types.js";
+export declare class RecordingReceiptCollector implements ReceiptCollector {
+    private readonly items;
+    private readonly settledPromise;
+    private readonly resolveSettled;
+    private isSettled;
+    constructor();
+    add(receipt: UploadReceipt): void;
+    all(): ReadonlyArray<UploadReceipt>;
+    settle(): void;
+    settled(): Promise<ReadonlyArray<UploadReceipt>>;
+}
+//# sourceMappingURL=recording-receipt-collector.d.ts.map

package/dist/budget/recording-receipt-collector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"recording-receipt-collector.d.ts","sourceRoot":"","sources":["../../src/budget/recording-receipt-collector.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAEnE,qBAAa,yBAA0B,YAAW,gBAAgB;IAChE,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAkB;IACxC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAwC;IACvE,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAmD;IAClF,OAAO,CAAC,SAAS,CAAU;IAE3B,cAUC;IAED,GAAG,CAAC,OAAO,EAAE,aAAa,GAAG,IAAI,CAEhC;IAED,GAAG,IAAI,aAAa,CAAC,aAAa,CAAC,CAElC;IAED,MAAM,IAAI,IAAI,CAMb;IAED,OAAO,IAAI,OAAO,CAAC,aAAa,CAAC,aAAa,CAAC,CAAC,CAE/C;CACF"}

package/dist/capabilities/capabilities.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"capabilities.d.ts","sourceRoot":"","sources":["../../src/capabilities/capabilities.ts"],"names":[],"mappings":"AAMA,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAC;IAChC,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;IAC7B,QAAQ,CAAC,oBAAoB,EAAE,OAAO,CAAC;IACvC,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC;IAC9B,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,iBAAiB,EAAE,OAAO,CAAC;IACpC,QAAQ,CAAC,cAAc,EAAE,OAAO,CAAC;CAClC;AAED,MAAM,MAAM,cAAc,GAAG,MAAM,eAAe,CAAC;AAEnD,eAAO,MAAM,oBAAoB;aAC/B,MAAM,EAAE,QAAQ;aAChB,YAAY,EAAE,cAAc;aAC5B,QAAQ,EAAE,SAAS;aACnB,QAAQ,EAAE,SAAS;aACnB,QAAQ,EAAE,SAAS;aACnB,QAAQ,EAAE,SAAS;aACnB,QAAQ,EAAE,SAAS;CACX,CAAC;AAEX,MAAM,MAAM,oBAAoB,GAAG,CAAC,OAAO,oBAAoB,CAAC,CAAC,MAAM,OAAO,oBAAoB,CAAC,CAAC;AA4CpG,eAAO,MAAM,kBAAkB,EAAE;IAC/B,QAAQ,CAAC,MAAM,EAAE,eAAe,CAAC;IACjC,QAAQ,CAAC,YAAY,EAAE,eAAe,CAAC;IACvC,QAAQ,CAAC,SAAS,EAAE,eAAe,CAAC;IACpC,QAAQ,CAAC,SAAS,EAAE,eAAe,CAAC;IACpC,QAAQ,CAAC,SAAS,EAAE,eAAe,CAAC;IACpC,QAAQ,CAAC,SAAS,EAAE,eAAe,CAAC;IACpC,QAAQ,CAAC,SAAS,EAAE,eAAe,CAAC;CASrC,CAAC;AAEF,MAAM,MAAM,sBAAsB,GAAG;IACnC,QAAQ,EAAE,CAAC,IAAI,cAAc,CAAC,CAAC,EAAE,OAAO;CACzC,CAAC;AAEF;;;;GAIG;AACH,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,oBAAoB,GAAG,eAAe,GAAG,sBAAsB,GAAG,SAAS,EAClF,SAAS,CAAC,EAAE,sBAAsB,GACjC,eAAe,CAqBjB"}
+{"version":3,"file":"capabilities.d.ts","sourceRoot":"","sources":["../../src/capabilities/capabilities.ts"],"names":[],"mappings":"AAMA,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAC;IAChC,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;IAC7B,QAAQ,CAAC,oBAAoB,EAAE,OAAO,CAAC;IACvC,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC;IAC9B,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,iBAAiB,EAAE,OAAO,CAAC;IACpC,QAAQ,CAAC,cAAc,EAAE,OAAO,CAAC;CAClC;AAED,MAAM,MAAM,cAAc,GAAG,MAAM,eAAe,CAAC;AAWnD,eAAO,MAAM,oBAAoB;aAC/B,MAAM,EAAE,QAAQ;aAChB,YAAY,EAAE,cAAc;aAC5B,QAAQ,EAAE,SAAS;aACnB,QAAQ,EAAE,SAAS;aACnB,QAAQ,EAAE,SAAS;aACnB,QAAQ,EAAE,SAAS;aACnB,QAAQ,EAAE,SAAS;CACX,CAAC;AAEX,MAAM,MAAM,oBAAoB,GAAG,CAAC,OAAO,oBAAoB,CAAC,CAAC,MAAM,OAAO,oBAAoB,CAAC,CAAC;AA4CpG,eAAO,MAAM,kBAAkB,EAAE;IAC/B,QAAQ,CAAC,MAAM,EAAE,eAAe,CAAC;IACjC,QAAQ,CAAC,YAAY,EAAE,eAAe,CAAC;IACvC,QAAQ,CAAC,SAAS,EAAE,eAAe,CAAC;IACpC,QAAQ,CAAC,SAAS,EAAE,eAAe,CAAC;IACpC,QAAQ,CAAC,SAAS,EAAE,eAAe,CAAC;IACpC,QAAQ,CAAC,SAAS,EAAE,eAAe,CAAC;IACpC,QAAQ,CAAC,SAAS,EAAE,eAAe,CAAC;CASrC,CAAC;AAEF,MAAM,MAAM,sBAAsB,GAAG;IACnC,QAAQ,EAAE,CAAC,IAAI,cAAc,CAAC,CAAC,EAAE,OAAO;CACzC,CAAC;AAEF;;;;GAIG;AACH,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,oBAAoB,GAAG,eAAe,GAAG,sBAAsB,GAAG,SAAS,EAClF,SAAS,CAAC,EAAE,sBAAsB,GACjC,eAAe,CAuBjB"}

package/dist/constants.d.ts

@@ -14,6 +14,12 @@ export declare const HEADER_LEVEL_MAX = 4;
 export declare const IMAGE_URL_MAX_CHARS = 3000;
 /** https://docs.slack.dev/reference/block-kit/blocks/image-block */
 export declare const IMAGE_ALT_MAX_CHARS = 2000;
+/** slackmark renderer safety limit for retained/uploaded image bytes. */
+export declare const RENDERED_IMAGE_MAX_BYTES: number;
+/** Portable filename component limit used by renderer output validation. */
+export declare const RENDERED_IMAGE_FILENAME_MAX_CHARS = 255;
+/** Defensive upper bound for Slack file IDs returned by uploaders. */
+export declare const SLACK_FILE_ID_MAX_CHARS = 255;
 /** https://docs.slack.dev/reference/block-kit/blocks/context-block */
 export declare const CONTEXT_ELEMENTS_MAX = 10;
 /** https://docs.slack.dev/reference/block-kit/blocks/markdown-block */
@@ -24,12 +30,20 @@ export declare const TABLE_MAX_ROWS = 100;
 export declare const TABLE_MAX_COLS = 20;
 /** https://docs.slack.dev/reference/block-kit/blocks/table-block */
 export declare const TABLE_CELL_CHARS_MAX = 10000;
+/**
+ * `raw_text.text` / `raw_number.text` declare `minLength: 1`; a blank markdown
+ * cell must be padded or Slack rejects the payload with `invalid_blocks`.
+ * https://docs.slack.dev/reference/block-kit/blocks/data-table-block
+ */
+export declare const TABLE_CELL_MIN_CHARS = 1;
 /** Spec decision: prefer `table` up to this many rows (incl. header). */
 export declare const TABLE_PREFERRED_MAX_ROWS = 50;
 /** https://docs.slack.dev/reference/block-kit/blocks/data-table-block */
 export declare const DATA_TABLE_MAX_DATA_ROWS = 200;
 /** https://docs.slack.dev/reference/block-kit/blocks/data-table-block */
 export declare const DATA_TABLE_CELL_CHARS_MAX = 20000;
+/** Spec decision: caption is required but unbounded in Slack's docs; match header. */
+export declare const DATA_TABLE_CAPTION_MAX_CHARS = 150;
 /** https://docs.slack.dev/reference/block-kit/blocks/data-visualization-block */
 export declare const CHART_TITLE_MAX_CHARS = 50;
 /** https://docs.slack.dev/reference/block-kit/blocks/data-visualization-block */

package/dist/constants.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,uCAAuC;AACvC,eAAO,MAAM,sBAAsB,KAAK,CAAC;AAEzC,sEAAsE;AACtE,eAAO,MAAM,sBAAsB,OAAO,CAAC;AAE3C,qEAAqE;AACrE,eAAO,MAAM,qBAAqB,MAAM,CAAC;AAEzC,qEAAqE;AACrE,eAAO,MAAM,gBAAgB,IAAI,CAAC;AAElC,oEAAoE;AACpE,eAAO,MAAM,mBAAmB,OAAO,CAAC;AAExC,oEAAoE;AACpE,eAAO,MAAM,mBAAmB,OAAO,CAAC;AAExC,sEAAsE;AACtE,eAAO,MAAM,oBAAoB,KAAK,CAAC;AAEvC,uEAAuE;AACvE,eAAO,MAAM,6BAA6B,QAAS,CAAC;AAEpD,oEAAoE;AACpE,eAAO,MAAM,cAAc,MAAM,CAAC;AAElC,oEAAoE;AACpE,eAAO,MAAM,cAAc,KAAK,CAAC;AAEjC,oEAAoE;AACpE,eAAO,MAAM,oBAAoB,QAAS,CAAC;AAE3C,yEAAyE;AACzE,eAAO,MAAM,wBAAwB,KAAK,CAAC;AAE3C,yEAAyE;AACzE,eAAO,MAAM,wBAAwB,MAAM,CAAC;AAE5C,yEAAyE;AACzE,eAAO,MAAM,yBAAyB,QAAS,CAAC;AAEhD,iFAAiF;AACjF,eAAO,MAAM,qBAAqB,KAAK,CAAC;AAExC,iFAAiF;AACjF,eAAO,MAAM,qBAAqB,KAAK,CAAC;AAExC,iFAAiF;AACjF,eAAO,MAAM,kBAAkB,KAAK,CAAC;AAErC,iFAAiF;AACjF,eAAO,MAAM,gBAAgB,KAAK,CAAC;AAEnC,iFAAiF;AACjF,eAAO,MAAM,gBAAgB,KAAK,CAAC;AAEnC;;;GAGG;AACH,eAAO,MAAM,kCAAkC,IAAI,CAAC;AAEpD,2EAA2E;AAC3E,eAAO,MAAM,6BAA6B,QAAS,CAAC;AAEpD,+DAA+D;AAC/D,eAAO,MAAM,yBAAyB,IAAI,CAAC;AAE3C,wEAAwE;AACxE,eAAO,MAAM,sBAAsB,KAAK,CAAC;AAEzC,wEAAwE;AACxE,eAAO,MAAM,yBAAyB,MAAM,CAAC;AAE7C,gEAAgE;AAChE,eAAO,MAAM,yBAAyB,KAAK,CAAC;AAE5C,eAAO,MAAM,QAAQ,WAAM,CAAC"}
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,uCAAuC;AACvC,eAAO,MAAM,sBAAsB,KAAK,CAAC;AAEzC,sEAAsE;AACtE,eAAO,MAAM,sBAAsB,OAAO,CAAC;AAE3C,qEAAqE;AACrE,eAAO,MAAM,qBAAqB,MAAM,CAAC;AAEzC,qEAAqE;AACrE,eAAO,MAAM,gBAAgB,IAAI,CAAC;AAElC,oEAAoE;AACpE,eAAO,MAAM,mBAAmB,OAAO,CAAC;AAExC,oEAAoE;AACpE,eAAO,MAAM,mBAAmB,OAAO,CAAC;AAExC,yEAAyE;AACzE,eAAO,MAAM,wBAAwB,EAAE,MAAyB,CAAC;AAEjE,4EAA4E;AAC5E,eAAO,MAAM,iCAAiC,MAAM,CAAC;AAErD,sEAAsE;AACtE,eAAO,MAAM,uBAAuB,MAAM,CAAC;AAE3C,sEAAsE;AACtE,eAAO,MAAM,oBAAoB,KAAK,CAAC;AAEvC,uEAAuE;AACvE,eAAO,MAAM,6BAA6B,QAAS,CAAC;AAEpD,oEAAoE;AACpE,eAAO,MAAM,cAAc,MAAM,CAAC;AAElC,oEAAoE;AACpE,eAAO,MAAM,cAAc,KAAK,CAAC;AAEjC,oEAAoE;AACpE,eAAO,MAAM,oBAAoB,QAAS,CAAC;AAE3C;;;;GAIG;AACH,eAAO,MAAM,oBAAoB,IAAI,CAAC;AAEtC,yEAAyE;AACzE,eAAO,MAAM,wBAAwB,KAAK,CAAC;AAE3C,yEAAyE;AACzE,eAAO,MAAM,wBAAwB,MAAM,CAAC;AAE5C,yEAAyE;AACzE,eAAO,MAAM,yBAAyB,QAAS,CAAC;AAEhD,sFAAsF;AACtF,eAAO,MAAM,4BAA4B,MAAM,CAAC;AAEhD,iFAAiF;AACjF,eAAO,MAAM,qBAAqB,KAAK,CAAC;AAExC,iFAAiF;AACjF,eAAO,MAAM,qBAAqB,KAAK,CAAC;AAExC,iFAAiF;AACjF,eAAO,MAAM,kBAAkB,KAAK,CAAC;AAErC,iFAAiF;AACjF,eAAO,MAAM,gBAAgB,KAAK,CAAC;AAEnC,iFAAiF;AACjF,eAAO,MAAM,gBAAgB,KAAK,CAAC;AAEnC;;;GAGG;AACH,eAAO,MAAM,kCAAkC,IAAI,CAAC;AAEpD,2EAA2E;AAC3E,eAAO,MAAM,6BAA6B,QAAS,CAAC;AAEpD,+DAA+D;AAC/D,eAAO,MAAM,yBAAyB,IAAI,CAAC;AAE3C,wEAAwE;AACxE,eAAO,MAAM,sBAAsB,KAAK,CAAC;AAEzC,wEAAwE;AACxE,eAAO,MAAM,yBAAyB,MAAM,CAAC;AAE7C,gEAAgE;AAChE,eAAO,MAAM,yBAAyB,KAAK,CAAC;AAE5C,eAAO,MAAM,QAAQ,WAAM,CAAC"}

package/dist/converter/create-converter.d.ts

@@ -5,7 +5,7 @@ import { SlackMarkConverter } from "./slackmark-converter.js";
  * Options for the composition root. Extends per-call {@link ConvertOptions}
  * with injectable collaborators and user adapters (prepended).
  */
-export interface CreateConverterOptions extends ConvertOptions {
+export interface CreateConverterOptions extends Omit<ConvertOptions, "signal" | "timeoutMs"> {
     readonly adapters?: ReadonlyArray<NodeAdapter>;
     readonly parser?: MarkdownParser;
     readonly plainText?: PlainTextRenderer;

package/dist/converter/create-converter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"create-converter.d.ts","sourceRoot":"","sources":["../../src/converter/create-converter.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAY/D,OAAO,KAAK,EACV,wBAAwB,EACxB,gBAAgB,EAChB,cAAc,EACd,cAAc,EACd,iBAAiB,EAClB,MAAM,aAAa,CAAC;AAGrB,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAE9D;;;GAGG;AACH,MAAM,WAAW,sBAAuB,SAAQ,cAAc;IAC5D,QAAQ,CAAC,QAAQ,CAAC,EAAE,aAAa,CAAC,WAAW,CAAC,CAAC;IAC/C,QAAQ,CAAC,MAAM,CAAC,EAAE,cAAc,CAAC;IACjC,QAAQ,CAAC,SAAS,CAAC,EAAE,iBAAiB,CAAC;CACxC;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,OAAO,GAAE,sBAA2B,GAAG,kBAAkB,CA2CxF;AAED;;GAEG;AACH,wBAAgB,OAAO,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAE7F;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,wBAAwB,CAAC,CAEnC"}
+{"version":3,"file":"create-converter.d.ts","sourceRoot":"","sources":["../../src/converter/create-converter.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAa/D,OAAO,KAAK,EACV,wBAAwB,EACxB,gBAAgB,EAChB,cAAc,EACd,cAAc,EAEd,iBAAiB,EAClB,MAAM,aAAa,CAAC;AAGrB,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAmB9D;;;GAGG;AACH,MAAM,WAAW,sBAAuB,SAAQ,IAAI,CAAC,cAAc,EAAE,QAAQ,GAAG,WAAW,CAAC;IAC1F,QAAQ,CAAC,QAAQ,CAAC,EAAE,aAAa,CAAC,WAAW,CAAC,CAAC;IAC/C,QAAQ,CAAC,MAAM,CAAC,EAAE,cAAc,CAAC;IACjC,QAAQ,CAAC,SAAS,CAAC,EAAE,iBAAiB,CAAC;CACxC;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,OAAO,GAAE,sBAA2B,GAAG,kBAAkB,CA8ExF;AAsID;;GAEG;AACH,wBAAgB,OAAO,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAE7F;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,wBAAwB,CAAC,CAEnC"}

package/dist/converter/resolve-config.d.ts

@@ -1,7 +1,9 @@
 import type { ResolvedConfig } from "../budget/conversion-context.js";
-import { type ConvertOptions } from "../types.js";
+import { type ConvertOptions, type ImageRenderer, type OperationContext, type OperationOptions } from "../types.js";
+export declare function readOperationOptions(options: ConvertOptions | undefined): OperationOptions;
 /**
  * Merge defaults + per-call options into a frozen ResolvedConfig.
  */
-export declare function resolveConfig(defaults: ConvertOptions, overrides: ConvertOptions | undefined): ResolvedConfig;
+export declare function resolveConfig(defaults: ConvertOptions, overrides: ConvertOptions | undefined, operation: OperationContext): ResolvedConfig;
+export declare function resolveRendererDescriptors(configured: ReadonlyArray<ImageRenderer> | undefined): ReadonlyArray<ImageRenderer>;
 //# sourceMappingURL=resolve-config.d.ts.map

package/dist/converter/resolve-config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"resolve-config.d.ts","sourceRoot":"","sources":["../../src/converter/resolve-config.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AAEtE,OAAO,EAGL,KAAK,cAAc,EAEpB,MAAM,aAAa,CAAC;AAErB;;GAEG;AACH,wBAAgB,aAAa,CAC3B,QAAQ,EAAE,cAAc,EACxB,SAAS,EAAE,cAAc,GAAG,SAAS,GACpC,cAAc,CA4ChB"}
+{"version":3,"file":"resolve-config.d.ts","sourceRoot":"","sources":["../../src/converter/resolve-config.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AAEtE,OAAO,EAGL,KAAK,cAAc,EACnB,KAAK,aAAa,EAElB,KAAK,gBAAgB,EACrB,KAAK,gBAAgB,EAGtB,MAAM,aAAa,CAAC;AAkBrB,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,cAAc,GAAG,SAAS,GAAG,gBAAgB,CAiB1F;AAED;;GAEG;AACH,wBAAgB,aAAa,CAC3B,QAAQ,EAAE,cAAc,EACxB,SAAS,EAAE,cAAc,GAAG,SAAS,EACrC,SAAS,EAAE,gBAAgB,GAC1B,cAAc,CA+FhB;AAuDD,wBAAgB,0BAA0B,CACxC,UAAU,EAAE,aAAa,CAAC,aAAa,CAAC,GAAG,SAAS,GACnD,aAAa,CAAC,aAAa,CAAC,CAoE9B"}

package/dist/converter/slackmark-converter.d.ts

@@ -1,6 +1,6 @@
 import { type MessageAssembler } from "../assemble/message-assembler.js";
 import type { AdapterRegistry } from "../registry/adapter-registry.js";
-import type { ConversionMessagesResult, ConversionResult, ConvertOptions, MarkdownParser, PlainTextRenderer } from "../types.js";
+import type { ConversionMessagesResult, ConversionResult, ConvertOptions, MarkdownParser, OperationContext, PlainTextRenderer, ReceiptCollector } from "../types.js";
 export interface SlackMarkConverterDeps {
     readonly parser: MarkdownParser;
     readonly registry: AdapterRegistry;
@@ -24,10 +24,20 @@ export declare class SlackMarkConverter {
      * Callers that need multi-message output should use {@link convertToMessages}.
      */
     convert(markdown: string, options?: ConvertOptions): Promise<ConversionResult>;
+    /**
+     * Advanced execution seam for orchestrators that already own an absolute
+     * operation context. The returned promise tracks underlying conversion work.
+     */
+    convertWithContext(markdown: string, options: ConvertOptions | undefined, operation: OperationContext, receipts?: ReceiptCollector): Promise<ConversionResult>;
     /**
      * Convert markdown into one or more messages at semantic boundaries.
      */
     convertToMessages(markdown: string, options?: ConvertOptions): Promise<ConversionMessagesResult>;
+    /**
+     * Advanced multi-message seam paired with {@link convertWithContext}.
+     */
+    convertToMessagesWithContext(markdown: string, options: ConvertOptions | undefined, operation: OperationContext, receipts?: ReceiptCollector): Promise<ConversionMessagesResult>;
+    private convertUnderOperation;
     private emitAsMarkdownBlocks;
 }
 //# sourceMappingURL=slackmark-converter.d.ts.map

package/dist/converter/slackmark-converter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"slackmark-converter.d.ts","sourceRoot":"","sources":["../../src/converter/slackmark-converter.ts"],"names":[],"mappings":"AAOA,OAAO,EAAuB,KAAK,gBAAgB,EAAE,MAAM,kCAAkC,CAAC;AAC9F,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAC;AAOvE,OAAO,KAAK,EACV,wBAAwB,EACxB,gBAAgB,EAChB,cAAc,EAEd,cAAc,EACd,iBAAiB,EAClB,MAAM,aAAa,CAAC;AAKrB,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAC;IAChC,QAAQ,CAAC,QAAQ,EAAE,eAAe,CAAC;IACnC,QAAQ,CAAC,SAAS,EAAE,gBAAgB,CAAC;IACrC,QAAQ,CAAC,SAAS,EAAE,iBAAiB,CAAC;IACtC,QAAQ,CAAC,cAAc,EAAE,cAAc,CAAC;CACzC;AAED;;GAEG;AACH,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAiB;IACxC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAkB;IAC3C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAmB;IAC7C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAoB;IAC9C,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAiB;IAEhD,YAAY,IAAI,EAAE,sBAAsB,EAMvC;IAED;;;;OAIG;IACG,OAAO,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAWnF;IAED;;OAEG;IACG,iBAAiB,CACrB,QAAQ,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,wBAAwB,CAAC,CA0GnC;IAED,OAAO,CAAC,oBAAoB;CA2D7B"}
+{"version":3,"file":"slackmark-converter.d.ts","sourceRoot":"","sources":["../../src/converter/slackmark-converter.ts"],"names":[],"mappings":"AAUA,OAAO,EAGL,KAAK,gBAAgB,EACtB,MAAM,kCAAkC,CAAC;AAC1C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAC;AAiBvE,OAAO,KAAK,EACV,wBAAwB,EACxB,gBAAgB,EAChB,cAAc,EAEd,cAAc,EACd,gBAAgB,EAChB,iBAAiB,EACjB,gBAAgB,EACjB,MAAM,aAAa,CAAC;AAKrB,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAC;IAChC,QAAQ,CAAC,QAAQ,EAAE,eAAe,CAAC;IACnC,QAAQ,CAAC,SAAS,EAAE,gBAAgB,CAAC;IACrC,QAAQ,CAAC,SAAS,EAAE,iBAAiB,CAAC;IACtC,QAAQ,CAAC,cAAc,EAAE,cAAc,CAAC;CACzC;AAED;;GAEG;AACH,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAiB;IACxC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAkB;IAC3C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAmB;IAC7C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAoB;IAC9C,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAiB;IAEhD,YAAY,IAAI,EAAE,sBAAsB,EAMvC;IAED;;;;OAIG;IACG,OAAO,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAwBnF;IAED;;;OAGG;IACG,kBAAkB,CACtB,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,cAAc,GAAG,SAAS,EACnC,SAAS,EAAE,gBAAgB,EAC3B,QAAQ,GAAE,gBAAkD,GAC3D,OAAO,CAAC,gBAAgB,CAAC,CAiB3B;IAED;;OAEG;IACG,iBAAiB,CACrB,QAAQ,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,wBAAwB,CAAC,CAYnC;IAED;;OAEG;IACG,4BAA4B,CAChC,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,cAAc,GAAG,SAAS,EACnC,SAAS,EAAE,gBAAgB,EAC3B,QAAQ,GAAE,gBAAkD,GAC3D,OAAO,CAAC,wBAAwB,CAAC,CAQnC;YAEa,qBAAqB;IAqJnC,OAAO,CAAC,oBAAoB;CA8D7B"}

package/dist/errors.d.ts

@@ -1,10 +1,88 @@
+import type { UploadReceipt } from "./receipts.js";
+/**
+ * Marks a class prototype so instances from any bundled copy answer to one identity.
+ * Subclasses inherit the brand, and instances carry no extra own property.
+ */
+export declare function brandErrorPrototype(prototype: object, brand: symbol): void;
+/**
+ * Reads a brand without trusting the value: a hostile getter must not escape a guard.
+ */
+export declare function hasErrorBrand(value: unknown, brand: symbol): boolean;
 /**
  * Programmer/configuration error thrown only from the composition root.
  */
+export interface ConfigurationErrorOptions {
+    readonly code?: string | undefined;
+    readonly stage?: string | undefined;
+    readonly receipts?: ReadonlyArray<UploadReceipt> | undefined;
+    readonly settledReceipts?: Promise<ReadonlyArray<UploadReceipt>> | undefined;
+    readonly cause?: unknown;
+}
 export declare class ConfigurationError extends Error {
     readonly name: string;
-    constructor(message: string, options?: {
-        readonly cause?: unknown;
-    });
+    readonly code: string;
+    readonly stage: string | undefined;
+    readonly retryable: false;
+    readonly receipts: ReadonlyArray<UploadReceipt>;
+    readonly settledReceipts: Promise<ReadonlyArray<UploadReceipt>>;
+    constructor(message: string, options?: ConfigurationErrorOptions);
+}
+export declare const OperationErrorCode: {
+    readonly Aborted: "operation_aborted";
+    readonly DeadlineExceeded: "operation_deadline_exceeded";
+    readonly Shutdown: "operation_shutdown";
+};
+export type OperationErrorCode = (typeof OperationErrorCode)[keyof typeof OperationErrorCode];
+export interface OperationErrorOptions {
+    readonly receipts?: ReadonlyArray<UploadReceipt> | undefined;
+    readonly settledReceipts?: Promise<ReadonlyArray<UploadReceipt>> | undefined;
+    readonly cause?: unknown;
+}
+/**
+ * Operational control-flow error. These failures are never degradations.
+ */
+export declare class OperationError extends Error {
+    readonly name: string;
+    readonly code: OperationErrorCode;
+    readonly stage: string;
+    readonly retryable: boolean;
+    readonly receipts: ReadonlyArray<UploadReceipt>;
+    readonly settledReceipts: Promise<ReadonlyArray<UploadReceipt>>;
+    constructor(message: string, code: OperationErrorCode, stage: string, retryable: boolean, options?: OperationErrorOptions);
 }
+export declare class OperationAbortedError extends OperationError {
+    readonly name: string;
+    constructor(stage: string, options?: OperationErrorOptions);
+}
+export declare class OperationDeadlineExceededError extends OperationError {
+    readonly name: string;
+    constructor(stage: string, options?: OperationErrorOptions);
+}
+export declare class OperationShutdownError extends OperationError {
+    readonly name: string;
+    constructor(stage: string, options?: OperationErrorOptions);
+}
+/**
+ * Identifies a {@link ConfigurationError} from any entry of this package.
+ *
+ * Use this instead of `instanceof` when the error may have been thrown by a different
+ * entry — for example a `ConfigurationError` from `slackmark/renderers` caught by code
+ * that imported the class from `slackmark`.
+ */
+export declare function isConfigurationError(value: unknown): value is ConfigurationError;
+/**
+ * Identifies an {@link OperationError} — abort, deadline, or shutdown — from any entry of
+ * this package, including its subclasses.
+ *
+ * Use this instead of `instanceof` when the error may have been thrown by a different
+ * entry — for example an abort raised inside `FetchSlackUploader` from `slackmark/slack`
+ * caught by code that imported the class from `slackmark`. Narrow further with `code`
+ * against {@link OperationErrorCode} rather than testing a subclass with `instanceof`.
+ */
+export declare function isOperationError(value: unknown): value is OperationError;
+export declare function cloneOperationError(error: OperationError, fallbackStage: string): OperationError;
+export declare function isOperationErrorCarrier(error: OperationError): boolean;
+export declare function cloneConfigurationError(error: ConfigurationError): ConfigurationError;
+export declare function attachReceipts(error: unknown, receipts: ReadonlyArray<UploadReceipt>, settledReceipts?: Promise<ReadonlyArray<UploadReceipt>>): unknown;
+export declare function lockReceiptSnapshot(error: unknown): unknown;
 //# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,qBAAa,kBAAmB,SAAQ,KAAK;IAC3C,SAAkB,IAAI,EAAE,MAAM,CAAC;IAE/B,YAAY,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE,EAGlE;CACF"}
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"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"}