Enum PromptInputEvent 

pub enum PromptInputEvent {
    OversizeDetected {
        phase: PipelinePhase,
        kind: PromptInputKind,
        content_id_sha256: String,
        size_bytes: u64,
        limit_bytes: u64,
        policy: String,
    },
    PlanningInputsMaterialized {
        iteration: u32,
        prompt: MaterializedPromptInput,
    },
    DevelopmentInputsMaterialized {
        iteration: u32,
        prompt: MaterializedPromptInput,
        plan: MaterializedPromptInput,
    },
    ReviewInputsMaterialized {
        pass: u32,
        plan: MaterializedPromptInput,
        diff: MaterializedPromptInput,
    },
    CommitInputsMaterialized {
        attempt: u32,
        diff: MaterializedPromptInput,
    },
    XsdRetryLastOutputMaterialized {
        phase: PipelinePhase,
        scope_id: u32,
        last_output: MaterializedPromptInput,
    },
    HandlerError {
        phase: PipelinePhase,
        error: ErrorEvent,
    },
    PromptPermissionsLocked {
        warning: Option<String>,
    },
    PromptPermissionsRestoreWarning {
        warning: String,
    },
    TemplateRendered {
        phase: PipelinePhase,
        template_name: String,
        log: SubstitutionLog,
    },
}

Prompt input oversize detection and materialization events.

These events make reducer-visible any transformation that affects the agent-visible prompt content (inline vs file reference, truncation, etc.).

Purpose

Large prompt inputs (PROMPT.md, PLAN.md, diffs) may exceed model context limits. When this occurs, handlers materialize the content as file references instead of inline text. These events record the materialization strategy for observability and to enable the reducer to track content transformations.

Emitted By

• Prompt preparation handlers in handler/*/prepare_prompt.rs
• XSD retry handlers

Variants

OversizeDetected

Oversize content detected, will be materialized as file reference.

Fields

phase: PipelinePhase

Pipeline phase where oversize was detected.

kind: PromptInputKind

Type of content (prompt, plan, diff, etc.).

content_id_sha256: String

SHA256 hex digest of the content.

size_bytes: u64

Actual content size in bytes.

limit_bytes: u64

Configured size limit in bytes.

policy: String

Materialization policy applied.

PlanningInputsMaterialized

Planning prompt inputs materialized.

Fields

iteration: u32

Iteration number.

prompt: MaterializedPromptInput

Materialized prompt input.

DevelopmentInputsMaterialized

Development prompt inputs materialized.

Fields

iteration: u32

Iteration number.

prompt: MaterializedPromptInput

Materialized prompt input.

plan: MaterializedPromptInput

Materialized plan input.

ReviewInputsMaterialized

Review prompt inputs materialized.

Fields

pass: u32

Review pass number.

plan: MaterializedPromptInput

Materialized plan input.

diff: MaterializedPromptInput

Materialized diff input.

CommitInputsMaterialized

Commit prompt inputs materialized.

Fields

attempt: u32

Commit attempt number.

diff: MaterializedPromptInput

Materialized diff input.

XsdRetryLastOutputMaterialized

XSD retry last output materialized.

Fields

phase: PipelinePhase

Phase that produced the invalid output being retried.

scope_id: u32

Scope id within the phase (iteration/pass/attempt).

last_output: MaterializedPromptInput

Materialized representation of the last invalid output.

HandlerError

A typed error event returned by an effect handler.

Effect handlers surface failures by returning Err(ErrorEvent::... .into()). The event loop extracts the underlying ErrorEvent and re-emits it through this existing category so the reducer can decide recovery strategy without adding new top-level PipelineEvent variants.

Fields

phase: PipelinePhase

Phase during which the error occurred (best-effort; derived from current state).

error: ErrorEvent

The typed error event.

PromptPermissionsLocked

PROMPT.md permissions locked (read-only) at pipeline startup.

Emitted by LockPromptPermissions effect handler when attempting to set PROMPT.md to read-only. If the operation fails, a warning is included but the pipeline continues (best-effort protection).

Fields

warning: Option<String>

Warning if permission change failed (None if successful or file missing).

PromptPermissionsRestoreWarning

PROMPT.md permissions restore warning (best-effort).

Emitted by RestorePromptPermissions effect handler when attempting to set PROMPT.md back to writable. The pipeline continues, but the warning is recorded for observability and resume diagnostics.

Fields

warning: String

Warning message when restore fails.

TemplateRendered

Template was rendered, carrying substitution log.

Emitted by prompt preparation handlers after template rendering. The substitution log enables validation based on tracked substitutions rather than regex scanning the rendered output.

Fields

phase: PipelinePhase

Pipeline phase during which the template was rendered.

template_name: String

Template name (e.g., “commit_message_xml”).

log: SubstitutionLog

Detailed substitution log from rendering.

Trait Implementations

impl Clone for PromptInputEvent

fn clone(&self) -> PromptInputEvent

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for PromptInputEvent

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for PromptInputEvent

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for PromptInputEvent

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.