shipitagent

Tools · Files and code

present_file

Can wait for approval

Present a file you created or have (image, audio, video, PDF, document, spreadsheet, data) to the user as a downloadable, previewable deliverable. Use after you generate or save a file the user should receive — pass the path. This does not create the file; the file must already exist.

When to use: Use present_file to hand a finished file to the user as a downloadable, previewable deliverable — after you generate an image, speak audio, render a PDF, or save a document/spreadsheet. Pass the file's path (and an optional title). It does not create the file — create or save it first, then present it. Prefer presenting one clear final deliverable over pasting a path into prose.

Example

Run for real by scripts/tool-examples.py in a small demo project, with Haiku 5.5 where the tool calls a model. The output is exactly what the tool returned.

The call

tool call
{
  "tool": "present_file",
  "arguments": {
    "path": "report.md",
    "title": "Pricing report"
  }
}

Real output

Presented Pricing report (document, 59 bytes) for download.
MEDIA:<project>/.shipit_workspace/report.md

Parameters

NameTypeDescription
path*stringPath to the existing file to present.
titlestringOptional caption shown on the card.

* required

Read, search and edit the project; run commands, code and git.