File Links Plugin
Makes files the agent generates or modifies downloadable and previewable in the web UI, and lets you browse the configured repositories.
What you see
- Transcript cards after a tracked write: filename, size, kind, Download and Open in browser
- A Files control in the chat header (labelled Browse files in the overflow menu)
- A repo browser at
/plugins/file_links/reposwith a This conversation / All files toggle
This conversation lists files this conversation actually wrote or saved. Uncommitted files the agent never touched stay out of that view. All files lists the directory and annotates entries with git status.
With Workspace Isolation, files that exist only in the conversation sandbox still appear and can be downloaded while that conversation's sandbox is alive. After the sandbox expires they may 404.
Download is capped at 100 MB (?force=1 overrides). Inline preview is capped at 5 MB.
Old Document Editor download links in existing transcripts still work: they redirect to this plugin. If you disable File Links, those links 404.
Configuration
plugins:
- module: codumentor.plugins.file_links
class: FileLinksPlugin
args:
enabled: true
# tracked_tools: ["write_file", "replace_in_file", "doc_save", "client_fs_copy_from_repo"]Parameters
| Key | Type | Default | Description |
|---|---|---|---|
enabled | bool | true | Master switch. |
tracked_tools | list of strings | write_file, replace_in_file, doc_save, client_fs_copy_from_repo | Tool names whose writes produce cards and This conversation entries. |
Most write-style tools work if the path is in file_path, path, or filename. client_fs_copy_from_repo is tracked by its server-side source_path (the repo file being copied to the user's folder).
The XLSX and PPTX editors show their own save cards. Add xlsx_save / pptx_save here if you also want those files in This conversation.
Disabling
plugins:
- module: codumentor.plugins.file_links
class: FileLinksPlugin
args:
enabled: falseOr disabled_plugins: [file_links].
Keep the plugin enabled if you retain old transcripts with Document Editor download links.