omadiaomadia.ai
registry
toolproductivity.office

Headless Office

@omadia/plugin-office

Erzeugt .xlsx/.docx-Dokumente deterministisch aus JSON-Descriptoren, legt sie in Tigris ab und liefert signierte /documents-URLs, die Channels als Datei-Anhang rendern.

latest
v0.1.2
license
MIT
versions
3
author
byte5 GmbH

install

In your omadia instance, open Admin → Registries and add this registry, then install Headless Office from Admin → Plugins → Store.

registryhttps://hub.omadia.ai

setup guide

Set up document storage (Tigris / S3)

Headless Office renders .xlsx/.docx files and stores them in an S3-compatible bucket (Tigris), then serves signed /documents URLs. You need a bucket and your middleware's public URL.

1. Create an S3-compatible bucket

  1. Create a bucket on Tigris (or any S3-compatible store).
  2. Note the endpoint (e.g. https://fly.storage.tigris.dev) and the bucket name → fields Tigris/S3 Endpoint and Bucket-Name.
  3. Create access credentials (access key id + secret) and provide them when prompted during install.

2. Public base URL

Set Public Middleware Base-URL to the public origin where this middleware is reachable (e.g. https://bot.omadia.ai). It is embedded in the signed file URLs that channels render as attachments.

Tenant prefix namespaces keys in a shared bucket (default dev); Signed-URL TTL controls how long a document link stays valid.

versions

v0.1.2
>=1.0 <2.043.5 KB2026-06-03
.zipb6b65a303757
v0.1.1
>=1.0 <2.042.7 KB2026-05-29
.zipf5ebabcd54a4
v0.1.0
>=1.0 <2.042.7 KB2026-05-29
.zipd01a878f6bc0

setup fields

Values the operator fills in at install-time.

public_base_urlurlÖffentliche Middleware-Base-URLrequired
tigris_endpointurlTigris/S3 Endpointrequired
tigris_bucketstringTigris/S3 Bucket-Namerequired
tenant_idstringTenant-Prefix für Keysoptional
signed_url_ttl_secintegerSigned-URL-TTL (Sekunden)optional
max_rowsintegerMax. Zeilen pro Dokument (Schutz gegen Runaways)optional
document_url_secretsecretHMAC-Secret für signierte Datei-URLsrequired
aws_access_key_idsecretTigris Access Key IDrequired
aws_secret_access_keysecretTigris Secret Access Keyrequired

permissions

memory

reads: [0] · writes: [0]

graph

reads: [0] · writes: [0]

network

outbound: [0]

filesystem

scratch: false