lucille-sdk
The stable contract a product builds against to run on the Lucille platform, without importing the Lucille backend.
It is interface only — around 800 lines, no dependencies, stdlib-only by design. A product imports the declaration surface and the capability seams; a host registers concrete providers behind those seams before the product is imported. In-process that host is the Lucille backend; out-of-process it is the product's own runtime.
from lucille_sdk import Integration, IntegrationDescriptor
from lucille_sdk.services import get_message_compose
from lucille_sdk.telegram import settled_text
What is in it
| Module | What it declares |
|---|---|
integration |
Integration base class, settings-provider seam |
specs |
IntegrationDescriptor, action/service/intent/recipe specs |
services |
identity, jobs, LLM, messaging seams |
storage |
object-storage seam |
telegram |
Telegram client seam, and the shared settle text rule |
scheduling |
user-job scheduling seam |
feedback |
feedback-ticket seam |
Each seam is a register_*_provider() / get_*() pair, so the product calls a
capability without knowing what implements it. The exception is settled_text,
a pure rule with no host-specific behaviour, imported directly.
Why it is published
A product repository has to be able to install this in isolation — in CI, and on a contributor's machine — without credentials for the platform's own repository. That is the whole reason it is a separate distribution rather than a package inside the backend.
Versioning
The contract is what other repositories pin, so a breaking change to a seam signature is a major bump. Adding a seam, or a field with a default, is a minor one.
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file lucille_sdk-0.1.0.tar.gz.
File metadata
- Download URL: lucille_sdk-0.1.0.tar.gz
- Upload date:
- Size: 11.8 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
4416fdfe911a1cd9a2812a248cbaa6969fdde304cb728bb19e5cf40fb4a7de09
|
|
| MD5 |
91100003a91c44863555e7ad83334688
|
|
| BLAKE2b-256 |
931208fff64aab738baf9caf65613709a010ab109133b794637b213bd81d6596
|
Provenance
The following attestation bundles were made for lucille_sdk-0.1.0.tar.gz:
Publisher:
publish-sdk.yml on gald33/Lucille
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
lucille_sdk-0.1.0.tar.gz -
Subject digest:
4416fdfe911a1cd9a2812a248cbaa6969fdde304cb728bb19e5cf40fb4a7de09 - Sigstore transparency entry: 2791157128
- Sigstore integration time:
-
Permalink:
gald33/Lucille@9e2d076b58e7ac0e04d85f9fad260de02b656896 -
Branch / Tag:
refs/tags/lucille-sdk-v0.1.0 - Owner: https://github.com/gald33
-
Access:
private
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish-sdk.yml@9e2d076b58e7ac0e04d85f9fad260de02b656896 -
Trigger Event:
push
-
Statement type:
File details
Details for the file lucille_sdk-0.1.0-py3-none-any.whl.
File metadata
- Download URL: lucille_sdk-0.1.0-py3-none-any.whl
- Upload date:
- Size: 14.0 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
3e2f97136935b4309fe5c6f4eb9245c1549e585117155b7d25c222d6d5b78c9b
|
|
| MD5 |
16933ad71976777042260ae5baefec9f
|
|
| BLAKE2b-256 |
de775458236649116037287fa5f5e354566c0a061293ba235236f3c8f50741f7
|
Provenance
The following attestation bundles were made for lucille_sdk-0.1.0-py3-none-any.whl:
Publisher:
publish-sdk.yml on gald33/Lucille
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
lucille_sdk-0.1.0-py3-none-any.whl -
Subject digest:
3e2f97136935b4309fe5c6f4eb9245c1549e585117155b7d25c222d6d5b78c9b - Sigstore transparency entry: 2791157176
- Sigstore integration time:
-
Permalink:
gald33/Lucille@9e2d076b58e7ac0e04d85f9fad260de02b656896 -
Branch / Tag:
refs/tags/lucille-sdk-v0.1.0 - Owner: https://github.com/gald33
-
Access:
private
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish-sdk.yml@9e2d076b58e7ac0e04d85f9fad260de02b656896 -
Trigger Event:
push
-
Statement type:
