eric/promptkit

Go to file

Eric Rakestraw 03c44923c8 Upgrade the release tooling to ReleaseKit v0.3.0

2026-10-09 03:48:52 +00:00

Upgrade the release tooling to ReleaseKit v0.3.0

2026-10-09 03:48:52 +00:00

examples/go-library

Document prompt requirement inspection

2026-10-08 20:48:10 +00:00

Release unused file buffers for empty artifacts

2026-10-09 01:52:06 +00:00

Upgrade the release tooling to ReleaseKit v0.3.0

2026-10-09 03:48:52 +00:00

.gitignore

Add native ReleaseKit bootstrap

2026-10-08 16:23:26 +00:00

AGENTS.md

Align policies with the standard and record their provenance

2026-09-27 21:18:11 +00:00

appended_messages_contract_test.go

Remove superseded configuration loaders and consolidate runtime tests

2026-09-30 04:18:27 +00:00

architecture_test.go

Publish the Promptkit engine facade

2026-07-28 04:43:19 +00:00

artifact_reader_internal_test.go

Publish the Promptkit engine facade

2026-07-28 04:43:19 +00:00

artifact_reader.go

Publish the Promptkit engine facade

2026-07-28 04:43:19 +00:00

assembled_workflow_benchmark_test.go

Add assembled workflow benchmark baseline

2026-10-09 00:49:46 +00:00

backends.go

Cut over public engine construction to ConfigKit sources

2026-09-30 03:18:49 +00:00

capacity_contract_test.go

Remove superseded configuration loaders and consolidate runtime tests

2026-09-30 04:18:27 +00:00

capacity_error.go

Expose structured capacity errors

2026-07-30 23:24:04 +00:00

configuration_inspection_contract_test.go

Expose captured configuration inspection and redacted reports

2026-09-30 03:29:28 +00:00

configuration_inspection.go

Expose captured configuration inspection and redacted reports

2026-09-30 03:29:28 +00:00

configuration_sources_test.go

Capture keyed prompts and source-backed content at load time

2026-09-30 02:19:52 +00:00

configuration_sources.go

Cut over public engine construction to ConfigKit sources

2026-09-30 03:18:49 +00:00

construction_contract_test.go

Preserve message resource origins and profile credential lookup names

2026-10-03 01:21:48 +00:00

consumer_test_helpers_test.go

Remove superseded configuration loaders and consolidate runtime tests

2026-09-30 04:18:27 +00:00

convert_appended_messages_test.go

Add appended message request validation

2026-08-26 02:10:01 +00:00

convert.go

Observe claimed prepared executions

2026-09-23 17:15:51 +00:00

COPYRIGHT

Align policies with the standard and record their provenance

2026-09-27 21:18:11 +00:00

doc.go

Expose prompt requirement inspection

2026-10-08 20:40:16 +00:00

engine.go

Expose prompt requirement inspection

2026-10-08 20:40:16 +00:00

errors_internal_test.go

Expose transport and malformed generation errors

2026-09-23 16:37:47 +00:00

errors.go

Remove superseded configuration loaders and consolidate runtime tests

2026-09-30 04:18:27 +00:00

formatting.go

Add appended message request validation

2026-08-26 02:10:01 +00:00

frozen_rendering_contract_test.go

Render captured prompt templates without reloading sources

2026-09-30 03:24:12 +00:00

generation_error_contract_test.go

Remove superseded configuration loaders and consolidate runtime tests

2026-09-30 04:18:27 +00:00

generation_error_internal_test.go

Expose structured generation errors to consumers

2026-08-23 19:01:38 +00:00

generation_error.go

Expose structured generation errors to consumers

2026-08-23 19:01:38 +00:00

go.mod

Upgrade the release tooling to ReleaseKit v0.3.0

2026-10-09 03:48:52 +00:00

go.sum

Upgrade the release tooling to ReleaseKit v0.3.0

2026-10-09 03:48:52 +00:00

json_contract_test.go

Preserve reported token usage presence

2026-09-23 16:39:43 +00:00

json.go

Consolidate public JSON serialization

2026-08-11 21:40:12 +00:00

LICENSE

Align licensing documentation and adopt MIT catalogs

2026-09-26 21:44:52 +00:00

llm_adapter_internal_test.go

Preserve reported token usage presence

2026-09-23 16:39:43 +00:00

llm_adapter.go

Isolate execution observations and preserve injected error categories

2026-09-23 17:56:15 +00:00

message_roles.go

Document appended request messages

2026-08-26 02:19:44 +00:00

observation_boundary_contract_test.go

Remove superseded configuration loaders and consolidate runtime tests

2026-09-30 04:18:27 +00:00

observation_contract_test.go

Remove superseded configuration loaders and consolidate runtime tests

2026-09-30 04:18:27 +00:00

observations.go

Reconcile reliable execution documentation

2026-09-23 17:29:12 +00:00

output_contract_contract_test.go

Remove superseded configuration loaders and consolidate runtime tests

2026-09-30 04:18:27 +00:00

prepared_execution_contract_test.go

Remove superseded configuration loaders and consolidate runtime tests

2026-09-30 04:18:27 +00:00

prepared_execution.go

Observe claimed prepared executions

2026-09-23 17:15:51 +00:00

prepared_observation_contract_test.go

Remove superseded configuration loaders and consolidate runtime tests

2026-09-30 04:18:27 +00:00

profile_inheritance_contract_test.go

Remove superseded configuration loaders and consolidate runtime tests

2026-09-30 04:18:27 +00:00

profile_inspection_contract_test.go

Remove superseded configuration loaders and consolidate runtime tests

2026-09-30 04:18:27 +00:00

profiles.go

Cut over public engine construction to ConfigKit sources

2026-09-30 03:18:49 +00:00

provider_values.go

Cut over public engine construction to ConfigKit sources

2026-09-30 03:18:49 +00:00

public_boundary_test.go

Close gaps in public boundary checks

2026-09-22 11:40:25 +00:00

README.md

Prepare Promptkit v0.12.0 release

2026-10-03 01:26:43 +00:00

releasekit.json

Extract example checks into release profile

2026-10-08 16:20:51 +00:00

reliable_execution_contract_test.go

Remove superseded configuration loaders and consolidate runtime tests

2026-09-30 04:18:27 +00:00

requirements_inspection_benchmark_test.go

Add requirement inspection benchmarks

2026-10-09 00:30:51 +00:00

requirements_inspection_contract_test.go

Select prompt metadata for inspection

2026-10-09 00:45:25 +00:00

requirements_test.go

Expose prompt requirement inspection

2026-10-08 20:40:16 +00:00

requirements.go

Clarify inspected input identifier disclosure

2026-10-08 21:19:24 +00:00

retry_exhausted_error.go

Configure built-in retries across execution paths

2026-09-23 16:56:20 +00:00

transient_retries_contract_test.go

Remove superseded configuration loaders and consolidate runtime tests

2026-09-30 04:18:27 +00:00

types.go

Cut over public engine construction to ConfigKit sources

2026-09-30 03:18:49 +00:00

README.md

Promptkit

Promptkit is a reusable Go library for preparing and executing prompt-defined LLM workflows. Its module path is:

gitea.maximumdirect.net/eric/promptkit

The root promptkit package provides the supported public engine. Consumers can configure file, embedded, or programmatic backend, profile, and prompt definitions alongside filesystem or in-memory schemas, prepare requests without generation, run requests with the built-in OpenAI-compatible client, or inject their own model client and artifact reader.

Quickstart

Run the maintained offline preparation example from the repository root:

go run ./examples/go-library/prepare

It loads a repository-local prompt, supplies a programmatic profile and inline input, inspects the captured configuration, and prints deterministic preparation metadata without contacting a provider or requiring credentials. The consumer guide also shows a local backend, ordered file/embedded sources, programmatic mappings, and how to replace an engine when source files change. Read the example source, the Go package consumer guide, and the framework format reference to build a consumer workflow.

Contributors should start with the development guide. The architecture policy defines the library boundary and constraints that framework work must preserve.

Release Guidance

Consumers upgrading to v0.12.0 should read the v0.12.0 release notes for the intentional ConfigKit configuration and public construction API migration.

The v0.11.2 release notes cover policy alignment and copied-policy attribution updates.

The v0.11.1 release notes cover the MIT-licensed catalog updates and licensing documentation improvements.

Consumers upgrading to v0.11.0 should read the v0.11.0 changelog and migration guide, particularly the default retry behavior and license change.

Consumers upgrading to the v0.10.0 profile-policy transition should read the v0.10.0 transition guide.

Consumers upgrading from v0.8.0 to v0.9.0 should read the v0.9.0 changelog and migration guide.

Consumers upgrading from v0.7.0 to v0.8.0 can consult the v0.8.0 changelog and migration guide.

Earlier adopters can consult the v0.7.0 changelog and migration guide.

Consumers upgrading from v0.5.0 to v0.6.0 can consult the v0.6.0 changelog and migration guide.

Consumers upgrading from v0.4.0 to v0.5.0 can consult the v0.5.0 changelog and migration guide.

Consumers upgrading from v0.3.0 to v0.4.0 should read the v0.4.0 changelog and adoption guide.

Consumers upgrading from v0.2.0 to v0.3.0 should read the v0.3.0 changelog.

Consumers moving from v0.1.0 to v0.2.0 should read the v0.2.0 changelog and migration guide.

Scriptorium is the CLI and HTTP application built on Promptkit.

License

Promptkit is licensed under the LGPL v3.0 or later.

Open Source attribution notices are available.