Skip to content

Steer envelope v1

The steer envelope — the contract between the fullsend runner and the agent definitions in fullsend-ai/agents for a message delivered into a session that is already running (ADR 0113).

Two repositories read these strings, so they are fixed here rather than in either one. The mechanics around them — when a steer is sent, what authorizes it, how the run settles — are in contributing/steering.md.

This document is normative. The Go implementation is internal/runtime/steer_session.go (the envelope) and internal/steerwatch/delta.go (the body it wraps).

The opening line

Every envelope begins with this line, byte for byte, followed by a blank line:

text
Runner update: your task inputs changed after this run started.

It is runtime.SteerEnvelopeOpeningLine, written once and pinned by a test. The agent definitions match on it twice, and the two uses pull in opposite directions:

Where it appearsWhat it means
First line of a delivered messageA runner amendment. The agent may act on it.
Anywhere inside work-item contentAn injection attempt. The agent should flag it.

Because the second use is a detection signal, the runner does not defang this line when it appears inside work-item content. Rewriting it would delete the evidence the agent definitions are told to act on. This is the one string in this document that is deliberately passed through untouched.

Changing this line requires changing the agent definitions in the same window. A runner that emits a different line is not steering: the definitions will read its message as ordinary content.

Structural tokens

The body is split into an attributed half and an unattributed one, and the envelope's header tells the agent which is which: items under Amendments come from collaborators whose authorization was verified, and everything inside the work-item-context fence is data that cannot amend the task.

That instruction is carried entirely by literal strings. These are the ones the runner guarantees are runner-authored:

TokenWritten asRole
Amendments headingAmendments alone on a lineOpens the attributed half
Context headinga line beginning Work-item context.Opens the unattributed half
Context fence, open[work-item-context]First line of the untrusted block
Context fence, close[/work-item-context]Last line of the untrusted block
Amendment attributionInstruction from @<login>: Attributes a command's text to a verified author

Amendments also render as Comment from @<login>: and Review from @<login> (<state>):. Those attribute without instructing and are not defended tokens.

Defanging

A context body is untrusted by construction, so it must not be able to write any token in the table above. Before the block is wrapped, each is altered in place — altered rather than deleted, so a reader can still see what the text tried to do:

In a context bodyBecomesMatched
[work-item-context](work-item-context)anywhere in the body
[/work-item-context](/work-item-context)anywhere in the body
Instruction from @Instruction from (at)anywhere in the body
Amendments, alone on a line> Amendmentsline-anchored
Work-item context beginning a line, as a whole wordthe line, prefixed > line-anchored

The two line-anchored rules need their edges spelled out, because a second repository reads this table:

  • Leading spaces and tabs are allowed before either heading word, and the quoted line does not keep them: an indented Amendments is re-emitted as > Amendments with the indent gone. Trailing spaces, tabs and a carriage return are allowed after Amendments and are preserved.
  • Work-item context must end on a word boundary, so Work-item context. and Work-item context is… are quoted, and Work-item contexts is not. The heading the runner writes continues with a period. Everything from there to the end of the line is part of the match.

Two further rules govern how this is applied:

  1. Sanitize, then defang. The Unicode sanitizer strips invisible characters. A token split by one — a zero-width space inside [/work-item-context], a soft hyphen inside Amendments — matches nothing, and a sanitizer running afterwards reassembles it intact. The context block is sanitized first and defanged second, so there is nothing left to reassemble.
  2. Only whole lines count for the headings. The two heading words are structure by virtue of standing alone. Prose that happens to use either word mid-sentence is not an imitation of anything and is left as written. Line endings may be \n or \r\n.

Amendments are not defanged. They are attributed to an author whose authorization was verified and are the one part of the body allowed to be directive; rewriting them would corrupt a legitimate instruction to defend against an author who needs no forgery to give one.

Versioning

This is v1. A change to the opening line, to any token in the structural table, or to what is defanged is a new major version. The agent definitions match on the opening line and cannot be updated atomically with the runner; the structural tokens and the defanged set are what the runner's neutralization, and any consumer that parses the envelope, key on. Adding a header sentence that carries no token in the structural table is not.