API Reference PromptRunnerSDK v#0.11.0

Copy Markdown View Source

Modules

Public API for building plans and executing prompt runs.

OTP application for Prompt Runner SDK.

Command-line entrypoint for the Prompt Runner packet workflow.

The prompt_runner control commands.

Versioned capabilities exposed without compiling or inspecting a checkout.

Behaviour for post-prompt commit or callback actions.

Committer that delegates post-run handling to a callback function.

Committer that applies git commits to one or more target repositories.

Committer that records no post-run git or callback action.

Loads and normalizes configuration for the prompt runner.

Safe, explicit conversion of legacy verifier command strings to argv contracts.

Watch a live run, and change how it renders, without attaching to it.

Changing what "done" means for a prompt, on the record.

One line of the control log: a command, who issued it, when, and what happened to it.

The append-only record of what a human said to a run, kept with the packet.

The runner's half of the control plane.

What a run looks like from outside it.

The file transport for one control-plane state root.

Follows a run's event stream and forwards it to a subscribing process.

Bootstraps the installed escript without depending on a source checkout.

Prompt Runner's normalized recovery view over provider and runtime failures.

Markdown front matter reader and writer used by Prompt Runner packet files.

Git commit helpers for single-repo and multi-repo prompt runs, plus the read-only repository inspection used by the verifier and by watch.

Behaviour and types for LLM integrations.

Thin delegator implementing the PromptRunner.LLM behaviour.

Convenience helpers for broadcasting PromptRunner events through Phoenix.PubSub.

Packet manifest loader and generator.

Static authoring hazards in a packet.

Prompt operations within a packet.

Rebinds source-checkout paths in packet text to logical workspace paths.

Fully resolved execution plan used by the PromptRunner runtime.

Home-scoped Prompt Runner profiles.

Normalized prompt representation used across all PromptRunner sources.

Normalization and defaults for Prompt Runner recovery policy.

Recovery decisions for Prompt Runner attempts.

Renders prompt-runner canonical event streams through a pluggable renderer and sink pipeline.

Behaviour for rendering prompt-runner canonical event maps into human-readable output.

Compact single-line token renderer for prompt-runner canonical events.

CLI-grade interactive renderer for prompt-runner canonical events.

Verbose line-by-line renderer for prompt-runner canonical events.

Behaviour for output destinations that receive rendered prompt-runner text and raw events.

A sink that forwards events to a callback function.

A sink that writes rendered output to a log file with ANSI codes stripped.

A sink that writes prompt-runner events as JSON Lines.

A sink that writes rendered output to a terminal device.

ANSI terminal utilities for the studio renderer pipeline.

Showing what a tool changed on disk.

Generates human-readable spinner text and summary lines for tool calls.

Expands repo group references (@group_name) in target repo lists.

Append-only durable run records.

Durable run identity and immutable selection fences.

Normalized description of a requested prompt run before planning.

Packet-local runtime state persisted under .prompt_runner/state.json.

Behaviour for progress tracking and log destination selection.

File-backed runtime store used by CLI and legacy runs.

In-memory runtime store used by API-first runs.

No-op runtime store for integrations that do not want persisted state.

Compatibility helper that generates the older explicit file set from a plan.

Dependency-aware, deterministic prompt scheduling.

Prompt Runner bridge onto the current ASM session runtime.

Built-in deterministic provider used for retry, repair, and resume demos.

Behaviour for loading prompts from directories, legacy config, or in-memory input.

Source implementation that loads numbered prompt files from a directory.

Source implementation for explicit v0.4-style PromptRunner config files.

Source implementation for in-memory %PromptRunner.Prompt{} lists.

Source implementation for Prompt Runner packet directories.

Normalized source output consumed by PromptRunner.Plan.

Source implementation for one raw prompt string.

Prompt scaffold templates.

Validates prompt runner configuration.

Deterministic prompt verification.

The doc: verify clause: an artifact-quality gate for written deliverables.

Read-only glob cardinality and non-empty-file verification.

Read-only JSON syntax and declarative shape verification.

The repos_clean: verify clause: assert that sessions committed their work.

Read-only assertion that forbidden regexes are absent from declared source paths.

Read-only YAML syntax and root-shape verification.

Supervision for a long unattended packet run.

Operator-owned workspace planning, materialization, and readiness.

Builds declared contract artifacts during explicit workspace preparation.

Read-only readiness checks for an operator-owned workspace.

Imports trusted terminal completion records into an operator workspace.

Strict, versioned operator-workspace manifest.

Materializes full, independent, operator-owned Git clones.

Resolved immutable operator-workspace paths.

Read-only reconciliation of run, lease, containment, journal, and progress facts.

Read-only validation of every tool version pin from its exact project cwd.

Bounded, evidence-producing workspace health monitor.

Mix Tasks

Migrates safely tokenizable legacy verifier commands to structured argv contracts.

Mix task wrapper for the PromptRunner CLI.