Delivered files

When DataMind Oda makes a file for you, the end of the turn shows it as a card under the closing message of your chat. From the card you can preview the file, open it in its usual application, or show it in your file manager. This page covers those cards and the rules behind them.

Where delivered files appear

After a turn that wrote files, the chat shows delivery cards under the closing message, next to the changed-files card when there is one:

• Each card shows the file's name, a short line about it (or its file type) and an icon for its kind. Point at the card to see the file's full path.
• A single delivery fills the row on its own; several sit together in a grid.
• More than four delivered files fold to the first four. Click All {count} files to show them all, or Collapse to fold them back.
• The transcript also carries the delivery as a step, titled Present files. It reads Delivering while the files are marked, then Delivered, Delivery failed or Interrupted. Open the step to read what was recorded; where the view offers inspection, use Inspect call.

The changed-files card is a different list: it covers every file a turn edited, not only the files Oda chose to hand over. See Review files Oda changed.

Open or preview a delivered file

• Preview. Use the card's preview control: pointing at the card swaps its description line for the Preview in sidebar hint, and clicking it opens the file in the side panel next to the chat.
• Open in its app. The card's open action starts the file in its usual application on your computer. It shows Opening… and then Open requested, and the note fades after a few seconds.
• Show it in the file manager. The reveal action shows the file in your file manager instead. It shows Showing in file manager… and then Requested display in file manager.
• No copy is made. Opening a delivered file opens the file itself; the chat keeps a reference, not a copy of the contents.
• When the action cannot run. Opening needs a desktop that Oda can reach and a path it can verify on this computer. Without a desktop, the card says This Host has no desktop available to open files or folders in external apps. Files can still be previewed in the sidebar.; a file whose path cannot be verified says This file has no available Host path. Preview it in the sidebar.
• When it fails. The card shows Could not open. Click to retry. or Could not show in file manager. Try again., and the action can be tried again. If Oda cannot read your computer's details at all, the card shows Could not read the Host desktop information with Retry.

The open and reveal controls themselves are described in Open files and folders in other apps. For the preview pane and its viewers, see Preview files in the side panel; Word, Excel and PowerPoint files are converted for reading first (Preview Office documents).

Which files Oda marks as delivered

Oda marks a file when a card helps you open the finished result, for example a document, a spreadsheet or a slide deck.

• Only real files. A folder cannot be delivered; the step reports Cannot present <file.path>: not a regular file. A file that is missing reports Cannot present <file.path>: file not found. Check the path, create the file if needed, and retry.
• Up to eight at a time. One delivery can carry up to eight files, and Oda is guided to mark at most four at a time.
• Paths. Relative paths count from the chat's workspace folder; a file outside it is named by its full path.
• Command-made files are not automatic. Files Oda creates with shell commands are not handed over by themselves. Ask Oda to deliver them, or open them from the workspace folder.
• Recorded when it finishes. A delivery is written only when its step finishes; a blocked or failed step adds nothing.
• One chat owns it. A delivery belongs to the chat that made it; if a helper task Oda started produced the file, Oda still marks it itself.

A delivery points at the file; it is not a copy. A shared or exported chat carries the list of delivered files, not their contents.

File names in the closing message

Oda often writes the delivered files' names in its closing message, and those names are clickable there too: clicking one opens the same sidebar preview.

• A name opens only when it matches exactly: the file's full path, or a file name that fits a single file in the turn.
• A name shared by several files, or a name of a file Oda did not deliver, stays plain text.

Questions, answered

Which files does Oda deliver?

Oda marks a file when a card helps you open the finished result, for example a document, a spreadsheet or a slide deck. It does not mark every file it edited; that list is the changed-files card, described in Review files Oda changed.

How many files can Oda deliver at once?

One delivery can carry up to eight files, and Oda is guided to mark at most four at a time. On the turn, more than four delivered files fold to the first four; click All {count} files to show them all.

Why can't I open a delivered file in its app?

Opening in an application needs a desktop that Oda can reach and a path it can verify on this computer. Without a desktop, the card says This Host has no desktop available to open files or folders in external apps. Files can still be previewed in the sidebar., and a file whose path cannot be verified says This file has no available Host path. Preview it in the sidebar. You can still preview the file in the side panel. See Open files and folders in other apps.

Does a delivered card keep a copy of the file?

No. The card points at the file itself, so it always opens the current version, and nothing is copied into the chat. If the file is later moved or deleted, the card can no longer open it. A shared or exported chat carries the list of delivered files, not their contents.

What does the delivery step in the transcript mean?

It is the transcript's record of a delivery, titled Present files. The step reads Delivering while it runs, then Delivered, Delivery failed or Interrupted. Open the step to read what was recorded, and use Inspect call where the view offers inspection.

Can I deliver a file Oda made with a command?

Not automatically. Files Oda creates with shell commands are not handed over by themselves. Ask Oda to deliver them, or open them from the workspace folder.

Can Oda deliver a folder?

No. A delivery names files, not folders; a folder is refused with Cannot present <file.path>: not a regular file. Open the folder from the chat's workspace folder to reach the files inside.

Why is a file name in Oda's message not clickable?

A name opens the preview only when it matches exactly: the file's full path, or a file name that fits a single file in the turn. A name shared by several files, or one Oda did not deliver, stays plain text.