auroralab-art/dsh-file-ref

Install

Absolute paths stay as typed. The plugin does not open the file or send its bytes. The agent reads the path with the session's usual tools and access mode.

## What it adds

Without this plugin, the composer accepts only PNG, JPEG, WebP, and GIF. Other files are rejected as an unsupported image format.

`dsh-file-ref` adds a path-reference path for those files:

- Recover the original filesystem path when the browser or host can see it.
- Otherwise write a copy into the workspace inbox and `@` that path.
- Mark `@relative` mentions before the model step so the agent can open the file with `read`, the shell, or other tools already in the session.

There is no new upload API and no extra model-facing file tool.

## Install or Update

Requires the `dsh` CLI and the `web` profile.

Add auroralab-art/dsh-file-ref to your DSH config (web profile) to enable.