Packages

prompt_runner_sdk

0.7.0
0.7.0 0.6.1 0.6.0 0.5.1 0.5.0 0.4.0 0.3.0 0.2.0 0.1.2 0.1.1 0.1.0

Prompt Runner SDK - packet-first prompt execution for Elixir and CLI workflows with verifier-owned completion, retry, repair, and git-aware repository orchestration.

HexDocs

Current section

Files

Jump to
Readme
11 Versions
3 Dependencies
Dependants
Files
Activity
prompt_runner_sdk guides architecture.md
Raw

guides/architecture.md 

# Architecture



Prompt Runner 0.7.0 is organized around one packet runtime with both CLI and

SDK entry points.



## Runtime Flow



```text

packet dir

  -> PromptRunner.Packet / PromptRunner.Source.PacketSource

  -> PromptRunner.Plan

  -> PromptRunner.Runner

  -> PromptRunner.Session

  -> PromptRunner.Verifier

  -> PromptRunner.Runtime + RuntimeStore + Committer

```



## Core Concepts



- `PromptRunner.Profile`

  home-scoped defaults

- `PromptRunner.Packet`

  packet manifest loader, runtime preflight, and doctor surface

- `PromptRunner.Packets`

  prompt creation and checklist sync

- `PromptRunner.Plan`

  fully resolved execution plan

- internal runner pipeline

  preflight, execution, retry, repair, and completion logic

- `PromptRunner.Verifier`

  deterministic completion contracts

- `PromptRunner.Runtime`

  packet-local attempt history and status state



## Completion Model



Prompt Runner no longer treats provider success as completion.



Completion is owned by the verifier:



- provider success + verifier pass => complete

- provider success + verifier fail => repair

- transient provider failure + verifier pass => complete

- terminal provider or policy failure => fail



## Recovery Model



Prompt Runner prefers provider-native session continuation for recoverable

transport failures. Repair is a separate higher-level step driven by unmet

verifier items.