Browse documentation

Technical documentation / Reference

Web, image, and control card facts

These results rows describe Web, View Image, and Magi Control in schema-1 tool cards. Mission Control, live local-agent cards, and saved cards use the same selection. Identify facts by exact labels, not titles or response prose.

Every row has outcome:"unknown". Card outcome records tool completion independently. Values are strings or null. Counts use unsigned decimal strings; booleans use "true" or "false". Null means absent, invalid or inapplicable source data, never zero or false. Unknown operations are null. No new capability, block type or metadata field is required.

Web

Rows appear in this order:

LabelValue and source
Web operationRecorded operation: search or open.
Web queryRecorded query, or null.
Web destinationRecorded URL argument; otherwise returned URL metadata; otherwise null.
Web referenceRecorded reference argument; otherwise returned reference metadata; otherwise null.
Web result countReturned results count, or null. Exa counts retained usable result pages. This is not requested limit or total web matches. Open and Codex synthesis without a recorded count remain null.
Web output truncatedRecorded truncated boolean, or null. Describes bounded tool output, not whether the whole web page was obtained.
Web preview truncatedWhether the card's response/error preview was shortened; null before a terminal tool result.

A following plain-text block carries the bounded response or error, with the selected query/destination/reference when available. Successful previews retain at most four response lines; errors and cancellation retain the first nonblank line. Each line has a 240-Unicode-scalar cap with a truncation marker. Web preview truncated covers this response selection, not separate row/card/wire limits. The omissions array remains authoritative for other limits and redaction.

View Image

Rows appear in this order:

LabelValue and source
Image sourceReturned path metadata; otherwise recorded path argument; otherwise null.
Image providerRecorded vision provider identifier.
Image modelRecorded vision model identifier.
Image bytesRecorded source-file size in bytes, before base64 encoding.
Image prompt charactersRecorded prompt length in Unicode scalar values, not UTF-8 bytes, graphemes or tokens.
Image output truncatedRecorded response truncated boolean, or null.
Image preview truncatedWhether the card's response/error preview was shortened; null before a terminal tool result.

The following plain-text block is a recorded textual image report or bounded error. Preview limits match Web. Rendering these facts makes no new visual observation and does not establish that the image still exists. Cards contain no image bytes, base64, transport payload, fetch instruction or permission to open the path. Image retrieval is outside this contract.

Magi Control

Control operation is always the first row. Its only non-null values are context_usage and compact.

For context_usage, these rows follow:

LabelValue and source
Context used tokensRecorded current_tokens.
Context maximum tokensRecorded max_tokens.
Context used percentRecorded integer percentage, in percent. Dispatch floors 100 * current_tokens / max_tokens; it records zero when maximum is zero.

These are the returned snapshot, not the UI's current estimate. Missing numeric metadata stays null; response text is never parsed to reconstruct it.

For compact, one row follows:

LabelValue and source
Compaction statusrequested only for a successful tool result whose returned action is also compact; request failed for an observed failed request; request cancelled for observed cancellation; otherwise null.

requested does not mean compaction finished or succeeded. A later compaction failure cannot turn request acceptance into completed compaction. The plain-text block repeats only selected public facts or a fixed unavailable message.

Privacy and saved history

Control normalization retains only an allowlisted action, numeric usage facts and shared public protection inputs. It drops params.context, unrecognized arguments, arbitrary metadata and raw output before display. Labels, summaries, copy text, expanded activity detail, protection summaries and rich blocks cannot copy private compaction input. Selection does not inspect, split or heuristically redact concatenated output.

Saved records pass through the same normalization. When a record contains only private or unstructured output, the public projection shows null facts or Control detail unavailable, without replay. Original provider/session compaction input remains available to backend execution; this is a display boundary, not a change to compaction semantics. Normal compaction history rotation can remove activities; exact reopen does not fabricate cards for removed records.

Public protection remains the shared allowlisted decision/summary, without assessments, scores, credentials, headers or arbitrary structured results. Unknown custom/MCP tools retain their existing unsupported-detail fallback; neither their arguments nor results become public facts. Strings retain existing sanitization and card/wire limits. Missing rows produce missing_source omissions live and not_recorded on saved projection; size and redaction omissions keep existing priority rules.

Sanitized native observations and executable provenance: issue 880 observations.

Edit this page on GitHub ↗