Long-running work accumulates material: the original goal, later constraints, attempted routes, failed experiments and current progress. Sending everything again on each continuation repeats more and more content; keeping only a summary can make the original basis of a decision difficult to recover.
LoopX's context delivery separates these jobs: preserve complete sources, read the facts needed for the current decision, expand supporting material around questions, and reuse unchanged structures exactly within a valid compaction cycle.
-This article checks the native Codex path at 73cf83ed, a 2.2 candidate source. Consult Releases for publication status. In that implementation, supported POSIX Codex App/SSH sessions and new benchmark heartbeat trials default to context delivery; saved off remains effective and explicit off is available. When enabled, complete content is saved first and the Agent receives an entrypoint for current facts.
This article describes the native Codex path in released LoopX 2.2.0. Supported POSIX Codex App/SSH sessions and new benchmark heartbeat trials default to context delivery; saved off remains effective and explicit off is available. When enabled, complete content is saved first and the Agent receives a reading entrypoint for current facts. See the 2.2.0 release notes for publication and validation scope. The synthetic measurements below retain their original source and experimental conditions.
Think of a capture as a complete book. An index locates its chapters; a JSON Pointer addresses a place inside it. Progressive reading determines how deeply to open the material now. Differential delivery determines what can be reused on the next continuation.
Follow one task: give an assistant voice input
Suppose an assistant needs to understand a voice note and reply in its original chat. Its complete material contains the goal, provider constraints, privacy requirements, acceptance and a long discussion of alternatives. This is a teaching example; the example program below generates the complete data in an isolated directory.
@@ -174,7 +174,12 @@On the next continuation, deliver what changed
When enabled, the default output is a reading entrypoint
Connect these operations back to the currently supported native Codex quota path:
-The enabled delivery path
- Complete source: projection.json preserves current facts.
- Necessary view: required-context.json keeps complete requirements and points back to supporting originals.
- Cycle delivery: verify baseline and scope; choose full or delta.
- Current reader: first read admission, stops, the original task and accumulated requirements; include an index and short overview when they fit. Follow Pointers for supporting detail.
One capture, from saved source to reading
decision-<id>/
+├─ projection.json source
+├─ required-context.json facts
+├─ delivery.json full/delta
+└─ *.reader.json reader
+One useful property is that even with mode: "delta", the Agent can select facts directly through current recovery. It does not first need to read an old baseline or replay every delta. Delta's path may address delivery.json; recovery and select_command address the complete current view. context_details then connects supporting material to the original capture.
Native navigation also stores complete capture/selection digests in immutable private reader references. The Agent copies the returned reference; the CLI still verifies the complete digests, selection and cursor on every page. SHA256 itself is not shortened. A first_read_command starts a selection; it does not establish that all required sources were read.
# Copy the original recovery.reference_file from current returned navigation.
@@ -183,7 +188,9 @@ When enabled, the default output is a reading entrypoint
A continuation reference pins its selection: follow its next_command to EOF and return to the original recovery reference to change Pointers. Very small budgets may retain the explicit file/digest interface. The teaching measurements above use that compatible interface and retain their original conditions.
Saved-file continuity and what the model currently retains are separate facts. Verifiable files do not establish that the model remembers every original passage.
+What was saved, and what the model has read
+The delta codec answers: can the verified old file reconstruct the exact current file? The native captured_file path verifies the complete saved baseline, version and scope. It does not require the model to have read the old file, reached a selected page’s EOF or sent an ACK. Each baseline is itself a complete version, so the model need not replay a chain of deltas first.
Progressive reading answers a different question: which facts does this decision need? In the voice illustration, suppose the next continuation adds sample 3 while the privacy constraint remains unchanged. Consider a missed-read counterexample: the Agent skipped the required privacy constraint, or can no longer establish it after compaction. Before sending audio externally, it must recover /goal/constraints through the current entrypoint and honor the existing authorization boundary. It can read that fact directly, without first draining the old baseline. A saved file or an unchanged field does not replace the necessary read.
Recover missing context while preserving the original work
After host compaction, a subsequent work Turn builds a new complete baseline. Original goals, requirements and sources remain available for necessary reads.
If compaction, missing pages or truncated output interrupt an unfinished Turn, recover missing facts from its original capture while retaining task, effect and settlement identity. If a voice result was already sent but its receipt was lost, recovering context must not become sending the result again.
@@ -199,7 +206,7 @@What the measurements establish
The example separates three mechanisms: avoid repeatedly moving history not currently needed, combine reads that belong together, and avoid retransmitting unchanged verified structures. Complete sources, requirements and recovery connect them.
Reader figures include actual CLI page metadata; local path length affects a small amount of framing. Projection figures compare capture bodies; the cycle table compares codec output. The reproduction script checks these distinct measurements and exact reconstruction.
Real long-running tasks must also count necessary later reads, recovery, cache hits, model input/output, tool calls, waiting and human attention. Effectiveness depends on constraints understood, decisions made and accepted outcomes. This synthetic example measures the mechanical path; real model benefit still needs comparable-task evidence.
-Implemented scope includes complete sources, file entrypoints, batch selection, index depth, applicable acceptance layering, exact sharing, cycle deltas and recovery. Broader decision-stage candidate, preference and Explore delivery and C1's universal input convergence remain unfinished. Supported Codex sessions default on without a saved preference. Disable in Settings → This machine → Capabilities → Differential context → Codex; saved off survives upgrade. A command or new benchmark trial can use --context-delivery off. Trials do not inherit the machine switch, and existing frozen trials are not rewritten. Saving settings, exact hook/configuration setup and actual adoption remain separate checks; unavailable hooks retain full delivery. Ordinary CLI, unsupported hosts and non-heartbeat benchmarks retain their existing full paths. Final 2.2 release qualification follows the exact release version.
2.2.0 ships complete sources, file entrypoints, batch selection, index depth, applicable acceptance layering, exact sharing, cycle deltas and recovery. Broader decision-stage candidate, preference and Explore delivery and consistency across all entrypoints remain unfinished. Disable in Settings → This machine → Capabilities → Differential context → Codex; saved off survives upgrade. A command or new benchmark trial can use --context-delivery off. Trials do not inherit the machine switch, and existing frozen trials are not rewritten. Under the default policy, ordinary CLI, unsupported hosts and non-heartbeat benchmarks retain their full paths; an explicit unsupported on request is rejected. Unavailable hooks use full delivery. Saving configuration, actual installation and model adoption remain separate checks.
Read the same material yourself
example.py generates this complete synthetic voice task and invokes the existing reader, progressive projection and delta owners. It checks selected values, directory addresses, all ten requirements, shared references and complete recovery. It registers no Goal, admits or settles no Turn, and calls no model or speech service.
Prepare the original measurement checkout, a4a0fad889d91cba0d945ce658788bdb76ba351e, and its compatible dependencies. Run from that checkout’s root, substituting the downloaded program path. The output directory must be empty.
Read the same material yourself
Generated capture.json retains all 80 history entries. projection.json and required-context.json hold the complete/necessary views; cycle-base.json and cycle-delta.json hold cycle encodings; manifest.json pins files and digests. Production reads use currently returned paths, never copied teaching fields or another capture’s array indexes.
The original measurement record pins this article’s figures. Running on other source can check its mechanisms but cannot rewrite the original observation. Local path length also affects page framing bytes. Understanding this example requires no new research run.
-Sources: complete-delivery contract, progressive projection, selection/index, delta/recovery. The example ran on a4a0fad; those three core owners are byte-identical in 0e78a19. Native final delivery also accounts for references and later reads, beyond codec output.
Sources: complete-delivery contract, progressive projection, selection/index, delta/recovery. The example ran on a4a0fad; its three measured core owners are byte-identical in 0e78a19. The implementation links above are pinned to released v2.2.0; the old numbers are not a post-release rerun. Native final delivery also accounts for references and later reads, beyond codec output.