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-URLWird in signierten Datei-URLs verwendet, z.B. https://bot.omadia.ai
required
tigris_endpointurl
Tigris/S3 Endpoint
required
tigris_bucketstring
Tigris/S3 Bucket-Name
required
tenant_idstring
Tenant-Prefix für Keys
optional
signed_url_ttl_secinteger
Signed-URL-TTL (Sekunden)
optional
max_rowsinteger
Max. Zeilen pro Dokument (Schutz gegen Runaways)
optional
document_url_secretsecret
HMAC-Secret für signierte Datei-URLs
required
aws_access_key_idsecret
Tigris Access Key ID
required
aws_secret_access_keysecret
Tigris Secret Access Key
required

permissions

memory

reads: [0] · writes: [0]

graph

reads: [0] · writes: [0]

network

outbound: [0]

filesystem

scratch: false

Headless Office · omadia hub