Files
openprose__prose/packages/std

OpenProse Standard Library

Reusable OpenProse functions, responsibilities, patterns, roles, delivery adapters, memory contracts, and operational tools.

Usage

use "std/evals/inspector"
use "std/evals/prose-contributor"
use "std/ops/compose"
use "std/ops/prose-author"
use "std/patterns/worker-critic"
use "std/patterns/pipeline"
use "std/roles/critic"
use "std/delivery/email-notifier"
use "std/memory/project-memory"

Install with prose install. std/... is the shorthand for github.com/openprose/prose/packages/std/...; see deps.md for dependency resolution details.

Library

Authored Prose sources use *.prose.md and the current Contract Markdown section form: ### Parameters / ### Returns for a function, ### Requires / ### Maintains / ### Continuity for a responsibility or gateway, intra-node composition via call in ### Execution, and related sections. README.md files remain plain Markdown.

evals/

Contracts for evaluating and improving OpenProse runs, contracts, and platform behavior.

Contract Purpose
inspector Post-run analysis — runtime fidelity and task effectiveness
contract-grader Scores a contract against its declared interface
regression-tracker Tracks quality regressions across runs
cross-run-differ Compares runs and recommends follow-up investigation
eval-calibrator Validates light evals against deep evals for reliability
system-improver Analyzes inspections and proposes source improvements
platform-improver Analyzes inspections and proposes platform/runtime improvements
prose-contributor Turns run evidence into an approved branch and draft PR back to OpenProse

When a std run exposes friction, confusing docs, or a reusable pattern that belongs upstream, run std/evals/prose-contributor after inspection. It is the standard path from run evidence to a focused pull request. It still requires explicit user approval before pushing a branch or opening a PR.

ops/

Operational contracts for profiling, debugging, validation, and wiring.

Contract Purpose
compose Progressively design, test, visualize, and materialize one canonical OpenProse directory package
lint Validate structure, schema, shapes, and contract consistency for a contract and its sub-unit tree
preflight Check that all runtime dependencies are satisfied before executing a contract
status Summarize recent runs from <openprose-root>/runs/
wire Run Forme wiring to produce forme.manifest.json
prose-author Turn pseudo-Prose or logical English into a fully validated OpenProse program package, asking targeted questions when the host supports interaction
diagnose Investigate failed or suspicious runs and propose fixes
profiler Cost, token usage, and time profiling for completed runs

delivery/

Contracts for delivering outputs to humans and external systems.

Contract Purpose
human-gate Present output for human review, block until approved or rejected
slack-notifier Format and deliver content to Slack via webhook or API
email-notifier Send an HTML email via a configured email provider (Resend, SendGrid, Postmark, SES, SMTP)
email-renderer Render structured report data into a branded, email-safe HTML string
html-renderer Render an HTML document from a template and structured data
webhook-notifier Deliver content to an HTTP endpoint via webhook
file-writer Write content to a local, S3, or GCS destination

patterns/

Reusable coordination and control-flow patterns (kind: pattern).

Pattern Purpose
worker-critic Two-agent loop: worker produces, critic evaluates, repeat until accepted
ensemble-synthesizer N-agent ensemble that independently solves then synthesizes into a consensus answer
ratchet Iterative improvement loop with regression prevention
dialectic Two-agent debate structure producing a synthesized conclusion
proposer-adversary Adversarial proposal testing: proposer generates, adversary stress-tests
oversight Actor-observer-arbiter structure for independent observation and decision
assumption-miner Surfaces implicit assumptions in a solution for explicit evaluation
blind-review Independent evaluation without exposure to other agents' assessments
contrastive-probe Generates contrasting solutions to expose decision boundaries
stochastic-probe Introduces controlled randomness to test solution robustness
coherence-probe Tests whether two corpora that should agree are actually in sync
pipeline Sequential stage pipeline: output of each stage feeds the next
map-reduce Parallel fan-out across inputs followed by aggregation
fan-out Parallel delegation without reduction; parent consumes raw results
race Parallel speculative execution; first acceptable result wins
guard Conditional delegation: run target only when guard passes
refine Iterative improvement guided by an evaluator
fallback-chain Sequential failover through candidate delegates
retry-with-learning Retry loop that accumulates failure context to guide subsequent attempts

roles/

Single-contract role guides for responsibilities and patterns.

Role Purpose
classifier Classifies inputs into a fixed set of categories; returns structured label
critic Evaluates a proposed solution against criteria; returns scored feedback
extractor Extracts structured data from unstructured text; returns JSON
summarizer Condenses long content into a concise representation
verifier Checks a solution for correctness against known constraints or test cases
researcher Investigates a topic and produces sourced findings
writer Produces prose for a specified audience and purpose
planner Breaks an objective into ordered work with dependencies
router Routes an input to the right tool, role, or next step
formatter Transforms structured data into a target presentation format

memory/

Contracts for persistent agent memory management.

Contract Purpose
project-memory Project-scoped memory
user-memory Cross-project memory (user-scoped)