Large results and spill files

When a command's output, a search or a fetched page produces more text than a chat carries, DataMind Oda shortens the result and adds a short note; the largest results are also written in full to a file on your computer. This page explains the notes you see, where the full text goes, and when these files are cleared up.

The notes in place of a long result

Oda keeps results within a size a chat can carry. When more arrives than fits, the result you see is shortened, and a note counts what was left out:

What each kind of result keeps

The part that stays depends on the kind of result:

Kind of resultThe shortened form keeps
A file search or a text searchThe first matches
A web searchThe first sources
A fetched pageThe start of the page
A command's outputThe end of the output, or both its start and its end

Where a stored file lives, and how long it stays

If a result cannot be stored

Storing is best effort:

Questions, answered

Why does my result say "Omitted 25 items"?

The result held more findings than the chat keeps, so Oda showed the part that fits and counted the rest. Nothing was thrown away: where the full text can be kept, Oda writes it to a file on your computer, and the note names it. Ask Oda to read the file or to search inside it when you need the rest.

Why do some notes count items and others count bytes?

Items are counted one by one when the result is a list of findings, such as search matches or sources. Text is measured in bytes, so a cut text reports the size of the part left out, and a list reports how many entries were left out. When the exact number is not known, the note says More lines were omitted. without a count.

Which part of a long result is kept?

It depends on the kind of result: searches and fetched pages keep their start, and a command's output keeps its end, or both its start and its end. The table above lists each kind. Cuts fall between characters, so you never see half a symbol.

Does "truncated" mean something failed?

No. A truncated note says a size limit was reached, not that the source was incomplete or the step failed; failures are reported as failures, in their own words. What a cut left out is counted in its note, and the fuller text is kept where the note says.

Where do the stored files go on my computer?

By default, into a private folder under your computer's temporary files area, created the first time a file is needed; your installation can choose a different folder. Inside it, each chat has a folder of its own, and the files can be read only by your user account. Nothing inside Oda browses these files; the note in the chat is the usual pointer.

How long are stored files kept?

Files older than 30 days are removed when Oda starts; your installation can choose a different period or turn the clearing off. The clearing runs at start-up only, so an Oda that stays open for a long time clears its older files at the next start. Files are kept on purpose: a chat you resume or fork can still read a result it stored earlier until the file ages out. Nothing in Oda deletes a stored file on request.

Why did a huge result stay in the chat instead of being stored?

Storing is best effort, and two cases leave the result as it was: Oda could not write the file, or no note small enough for the size set could be made. In both cases the result stays in the chat and the step does not fail; a failed save never turns a good result into a lost one.

Can Oda still read a stored result after I resume the chat?

Yes, until the file ages out. A retry, a resumed chat and a forked chat still point at the same file, and Oda reads it back in parts or searches inside it when you ask. Once the file has been cleared, the note has nothing behind it; ask Oda for the work again if you need the text.