README.md 7.0 KB
description: "Host Office conversion with the independently published LibreOffice kit."
kind: "package-reference"
@deepseek-ai/dsh-document-render-libreoffice
English | 中文
Summary
Convert Office documents to PDFs on the Host computer. macOS and Windows use their matching native LibreOffice engine; Linux uses Node WASM. The provider accepts DOC, DOCX, XLS, XLSX, PPT, and PPTX. OOXML conversion returns missing-font names; binary Office conversion returns an empty list.
Table of Contents
- Use this package
- Understand the implementation
- Further Exploration
- Model Experience
- Known Limitations and Deferred Work
- Dev Note
Use this package
The Web bundle mounts this provider as document-render. Independent compositions mount @deepseek-ai/dsh-document-render-libreoffice as a cordis.yml row.
The provider depends on the independently published @deepseek-ai/libreoffice-kit npm API at kit version 0.0.1. npm selects the matching macOS/Windows native package or the Linux-only WASM package. A missing native engine rejects conversion on macOS/Windows without selecting WASM. The platform engine decision defines installation and packaging; the release ownership decision defines the independent kit and Harness responsibilities.
| Field | Default | Meaning |
|---|---|---|
maxConcurrentConversions |
2 |
Maximum active converters; queued calls remain cancellable. |
timeoutMs |
60000 |
Conversion deadline after a converter is acquired. |
maxInputBytes |
52428800 |
Maximum source bytes. |
maxOutputBytes |
104857600 |
Maximum complete PDF bytes. |
maxImageResolution |
192 |
Maximum raster-image DPI; overrides the kit default of 144. |
fontFallbacks |
Kit defaults | Ordered font-family preference groups; each group requires at least two names containing non-whitespace characters. |
The configuration catalog owns the full font, archive, and image settings. fontDirectories accepts absolute directories; omission uses the kit platform defaults. Explicit fontFallbacks replaces the kit's default groups. Installed requested fonts retain precedence, and other system fonts remain eligible for uncovered glyphs. Native engines can select installed metric-compatible fonts before these preferences.
The provider retains successful PDFs by renderer generation, Office extension, and SHA-256 of the exact source bytes. A bounded source-version index avoids rereading known content after an authorized stat; content identity also shares conversion across different source paths. Least-recently-used PDFs leave at either retention limit, together with their aliases. Failures and oversized cache entries are not retained. Every result has independent PDF/font buffers. Ready alias hits consume no reader slot; active source locators are released when their last reader leaves. Reopening a source after its final reader cancels rereads its bytes before sharing by digest, even if another source kept the conversion alive or its PDF is ready.
Admission bounds queued metadata, outstanding readers, active source-byte reservations, and conversions before invoking a source read. Unknown source sizes reserve maxInputBytes; known sizes reserve their stat size. Reads receive that capacity and may read one overflow sentinel byte. maxSourceBytes must cover maxInputBytes. The final reader allowance is reserved for foreground work. Setting maxBackgroundConversions to zero rejects background joins to queued and running work; completed alias hits remain available. Background jobs wait while any foreground job is queued, including when it awaits source capacity. Foreground joins promote queued prewarming; when its last foreground reader leaves, the queued job returns to background priority and eligible work can start immediately. Foreground admission can evict queued speculation. Background concurrency leaves a foreground slot when total concurrency exceeds one. A running prewarm keeps its background admission slot until settlement, even after promotion. The final reader cancels shared work. Removing a queued foreground blocker immediately admits other eligible work; active reservations remain held until actual read/conversion cleanup settles.
The defaults retain 8 PDFs/128 MiB and 64 source aliases, admit 32 readers and 8 queued jobs, reserve at most 100 MiB of source bytes, and allow one background conversion. These limits bound owned requests and binary payloads, not engine RSS, base64 transport expansion, caller-retained results, or PDF.js page rendering.
Understand the implementation
Implementation internals — click to expand
Invalid engine metadata, missing required assets, and conversion errors reject the request instead of switching engines. The shared WASM engine uses LibreOffice's CPU image filter. Native conversion uses its separate platform engine. Each concurrent slot lazily creates and reuses one kit converter. The provider writes authorized input into a private temporary directory, reads a bounded regular PDF, and removes the directory before settling. Canceling an admitted reader does not block later queued work. Reader cancellation releases only that reader; the final reader and provider disposal cancel shared work. Disposal reports `unavailable` to outstanding readers and joins conversions and converter teardown. No runtime invariant companion is published because active operations and scratch cleanup have one lifetime owner.Further Exploration
- Rendering service — input and result ownership.
- Workspace Files — Session file authorization and bounded reads.
Model Experience
None, as this package converts bytes without model-facing tools, messages, or Session events.
KV Cache effect
None; conversion does not construct or modify model requests.
Known Limitations and Deferred Work
- Conversion fidelity and installed native/WASM assets belong to
@deepseek-ai/libreoffice-kit; this provider neither searches for system LibreOffice nor downloads an engine at runtime. - Queue waiting time is not bounded by
timeoutMs, which starts only when kit conversion begins.