README
¶
Tiny Systems Common Module
Core building blocks for flow-based automations on the Tiny Systems platform.
Components
| Component | Description |
|---|---|
| Router | Conditional message routing based on expressions |
| Debug | Inspect and log messages passing through a flow |
| Cron | Schedule-based flow trigger (cron expressions) |
| Signal | Manual flow trigger with configurable context |
| Delay | Pause execution for a specified duration |
| Array Get | Extract elements from an array by index |
| Ticker | Interval-based recurring trigger |
| Group By | Group incoming messages by key |
| Async | Non-blocking message passthrough (fire-and-forget) |
| Split Array | Split an array into individual messages |
| Inject | Data enrichment -- merge additional data into messages |
| Modify | Transform and reshape message data |
| Key-Value Store | In-memory key-value storage for flow state |
| Retry | Explicit retry supervisor with bounded attempts and configurable backoff. Wire to the error port of llm_* / http_request / database components; routes back to the original input until success or attempt limit. |
Installation
helm repo add tinysystems https://tiny-systems.github.io/module/
helm install common-module tinysystems/tinysystems-operator \
--set controllerManager.manager.image.repository=ghcr.io/tiny-systems/common-module
Run locally
go run cmd/main.go run --name=common-module --namespace=tinysystems --version=1.0.0
Part of Tiny Systems
This module is part of the Tiny Systems platform -- a visual flow-based automation engine running on Kubernetes.
License
This module's source code is MIT-licensed. It depends on the Tiny Systems Module SDK (BSL 1.1). See LICENSE for details.
Directories
¶
| Path | Synopsis |
|---|---|
|
components
|
|
|
budgetguard
Package budgetguard stops an agent loop before it runs away.
|
Package budgetguard stops an agent loop before it runs away. |
|
flowtelemetry
Package flowtelemetry lets a flow read the platform's own execution traces.
|
Package flowtelemetry lets a flow read the platform's own execution traces. |
|
retry
Package retry implements the retry component — the explicit supervisor primitive that pairs with single-shot edge delivery in the SDK (since v0.10.16).
|
Package retry implements the retry component — the explicit supervisor primitive that pairs with single-shot edge delivery in the SDK (since v0.10.16). |
|
internal
|
|
Click to show internal directories.
Click to hide internal directories.