galet-prompt-builder
Prompt compilation layer. The caller supplies instructions, current input, retrieval options, and budgets. Galet-prompt-builder obtains memory through galet-memory, chooses relevant candidates within the limits, and assembles provider messages with selection metrics. It consumes digests; it does not generate or store them. An agent application such as Lucy chooses when to compile a prompt and which policy to use.
See the Galet package responsibilities for the full layering.
Provider-neutral orchestration of CoALA memory into bounded prompts.
The package compiles caller-supplied system instructions and current input
with procedural, episodic, and semantic memory from galet-memory. It applies
independent section budgets, a total hard limit, relevance assessment, digest
deduplication, deterministic selection, and detailed metrics.
It deliberately has no concept of Lucy agents, handlers, storage paths,
attachments, or application configuration. Lucy can later adapt those values
into PromptRequest, PromptBudgets, and PromptLimits.
Basic use
from galet_prompt_builder import (
PromptBudgets,
PromptCompiler,
PromptLimits,
PromptRequest,
)
compiler = PromptCompiler(
procedural_memory=procedural_memory,
episodic_memory=episodic_memory,
semantic_memory=semantic_memory,
)
compiled = compiler.compile(
PromptRequest(
account_name="demo",
conversation_id="session-id",
context_name="project",
system_instructions=["You are a careful assistant."],
current_input="What did we decide about storage?",
semantic_namespaces=("documents",),
semantic_score_threshold=0.30,
episodic_event_kinds=(
"user_message",
"assistant_message",
"session_digest",
),
include_structured_episodic_events=False,
episodic_digest_score_threshold=0.40,
),
PromptBudgets(
total_tokens=8000,
procedural_tokens=1500,
episodic_event_tokens=2000,
episodic_digest_tokens=1000,
semantic_tokens=2000,
safety_margin_tokens=500,
),
PromptLimits(
maximum_total_tokens=16000,
maximum_procedural_tokens=3000,
maximum_episodic_event_tokens=4000,
maximum_episodic_digest_tokens=2000,
maximum_semantic_tokens=4000,
maximum_events=6,
maximum_digests=2,
maximum_semantic_documents=3,
maximum_episodic_event_chars=4000,
maximum_episodic_digest_chars=1800,
maximum_semantic_item_chars=1800,
),
)
provider_messages = compiled.provider_messages
metrics = compiled.metrics
The default relevance assessor is deterministic and makes no network calls.
GaletRelevanceAssessor is available when an application explicitly wants an
LLM-based assessment; all such calls go through Galet's LLMApi.
Prompt policy is explicit and agent-independent. Applications choose the overall and per-section token budgets, retrieval counts, event kinds, relevance thresholds, and per-item character caps. An agent may supply system instructions, but no agent object or application policy is required.
Applications can pass the same knobs used by galet-prompt-run through
PromptPolicy, without constructing budgets and limits themselves:
from galet_prompt_builder import PromptCompiler, PromptPolicy, PromptRequest
compiled = PromptCompiler(
episodic_memory=episodic_memory,
semantic_memory=semantic_memory,
procedural_memory=procedural_memory,
).build(
PromptRequest(account_name="junwin", current_input=question,
conversation_id=session_id, context_name="skinny",
semantic_namespaces=("books", "vol_6", "vol_7", "documents")),
PromptPolicy(total_tokens=6000, safety_margin_tokens=500,
procedural_tokens=300, episodic_event_tokens=800,
episodic_digest_tokens=400, semantic_tokens=900,
maximum_events=6, maximum_digests=2,
maximum_semantic_documents=3,
digest_score_threshold=0.45,
semantic_score_threshold=0.35,
semantic_item_max_chars=1800),
)
Prompt comparison CLI
The installed galet-prompt-run command compiles a prompt from an existing
Lucy chat and a new request. It resolves the chat's friendly name to its stored
session ID and reads episodic history from Lucy's SQLite database.
By default it reads:
/home/junwin/lucy_storage/data/chat2.sqlite
Example:
galet-prompt-run \
"What should we do next?" \
--chat-name "Prompt Builder Work"
Use a different storage root or an explicit database when needed:
galet-prompt-run \
"Compare this prompt" \
--chat-name "Prompt Builder Work" \
--storage-root /srv/lucy_storage
galet-prompt-run \
"Compare this prompt" \
--chat-name "Prompt Builder Work" \
--db /tmp/chat2.sqlite \
--format json
The command is read-only. It fails if the database or friendly chat name does not exist, and it reports duplicate friendly names instead of guessing. The runner includes episodic events and digests by default.
The runner also loads the chat's stored project context, if present, from
<storage-root>/<storage-namespace>/contexts/<account>/<context-name>.md.
Imported skills come from the sibling skills/<account> directory. To try a
different named context, override the chat's value explicitly:
galet-prompt-run "What should we do next?" \
--chat-name "Prompt Builder Work" \
--context-name galet-memory \
--procedural-tokens 1000
Use --procedural-root /path/to/root when the contexts and skills live
elsewhere. Use --procedural-layout scoped for galet-memory's global/account/
project directory layout, and --project-name to include a project scope.
An explicitly named context that is missing produces
an error; recall never creates a file. Set --procedural-tokens 0 to omit
procedural content for a comparison run.
Semantic recall is opt-in. Supply one or more namespaces to query Lucy's
embeddings-v2.sqlite store:
galet-prompt-run \
"What did I write about attention?" \
--chat-name "Prompt Builder Work" \
--namespaces vol_6 vol_7 documents
The comparison runner uses deliberately compact defaults:
- 8,000 total tokens with a 500-token safety margin
- 1,000 project-context and skill tokens
- 1,000 recent-event tokens across at most 6 events
- 500 digest tokens across at most 2 digests
- 1,000 semantic tokens across at most 3 documents
- semantic score threshold 0.30
- digest score threshold 0.40
- conversational event kinds only; structured tool payloads are excluded
Every policy value can be stated explicitly:
galet-prompt-run \
"What did I write about attention?" \
--chat-name "Prompt Builder Work" \
--namespaces vol_6 vol_7 documents \
--total-tokens 6000 \
--safety-margin-tokens 500 \
--episodic-event-tokens 800 \
--max-events 6 \
--episodic-digest-tokens 400 \
--max-digests 2 \
--digest-score-threshold 0.45 \
--semantic-tokens 900 \
--semantic-top-k 3 \
--semantic-score-threshold 0.35 \
--semantic-item-max-chars 1800
With no --namespaces, document semantic recall is disabled. When the
embedding database exists, the runner can still query its digests namespace
for archived, published session digests. A session_digest event in the
current chat appears as an episodic event; it does not by itself create an
archived digest candidate. Archives must be published with an embedding and
readable digest document to be recalled from other sessions. Semantic mode
defaults to
/home/junwin/lucy_storage/data/embeddings-v2.sqlite; use
--embedding-db to override it and install the optional dependency with
pip install ".[semantic]". Galet supplies the query embedding, using its
normal credential configuration or the directory passed to
--credential-path.
The text report includes a content-safe candidate decision table. It shows
each candidate ID, source, raw relevance score, original/final token cost, and
whether it was selected or rejected by the relevance threshold or token
budget. The JSON report exposes the same data under metrics.candidates.
Rejected candidates still count as retrieved and dropped in their section
metrics, making threshold tuning visible without copying document or chat
content into diagnostics.
Dependency rule
Applications may depend on
galet-prompt-builder; the package must never depend on an application.
The package depends on the neutral interfaces from galet-memory. It never
opens memory databases itself and prompt compilation never mutates memory.
Metadata
Release files for galet-prompt-builder 0.1.19
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| galet_prompt_builder-0.1.19.tar.gz | 27.1 kB | Without provenance | Details for galet_prompt_builder-0.1.19.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| galet_prompt_builder-0.1.19-py3-none-any.whl | Python 3 | none | any | Details for galet_prompt_builder-0.1.19-py3-none-any.whl |
Total release size: 48.8 kB
Release files / galet_prompt_builder-0.1.19.tar.gz
| Download URL | galet_prompt_builder-0.1.19.tar.gz |
|---|---|
| Size | 27.1 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
269fb5cb206337462181d22d6e7212e155ffafa5f746f6484afa8a88241e0954
|
|
BLAKE2b-256 checksum How to use checksums |
d6510ba5594cf0e3f867bc50d3f7445e449f2fca36e3819b7708a6c3405aee26
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.12.16 {"installer":{"name":"uv","version":"0.12.16","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Debian GNU/Linux","version":"12","id":"bookworm","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|
Release files / galet_prompt_builder-0.1.19-py3-none-any.whl
| Download URL | galet_prompt_builder-0.1.19-py3-none-any.whl |
|---|---|
| Size | 21.7 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
0bb29ecf2954addffba5ceca1a3b776815203484a4c056f075a1461937f54059
|
|
BLAKE2b-256 checksum How to use checksums |
df9d7a9719bb3b084581b39d329a32cac4067267460600661ab7dbcfbf556e88
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.12.16 {"installer":{"name":"uv","version":"0.12.16","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Debian GNU/Linux","version":"12","id":"bookworm","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|
Security for galet-prompt-builder 0.1.19
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.