1.2 KiB
1.2 KiB
name, description
| name | description |
|---|---|
| shd-project-files | Use when the user asks to inspect project files, obtain a file link, share or zip a file, rename or move a path, or delete project files. |
SHD project files
Resolve paths
- Call
shd_list_fileswith the exactproject_codeand, when supplied, the path. - Resolve the exact file or directory path and distinguish files from directories before any action.
- Use
shd_get_file_linkonly when the user asks for a temporary file link or download.
Actions
shd_create_file_action supports the explicit actions share-link, zip-link,
rename, move and delete. Use the exact action matching the request. For
rename, move and delete, confirm the source/destination and replacement scope
from the current listing first. Mutating actions require a stable
idempotency_key; delete additionally requires confirm: true and the server
version/confirmation fields accepted by its schema.
Do not expose bearer tokens or raw secret material in prose or logs. Return a temporary URL only when the user explicitly asks for it. Do not overwrite, publish, share or delete a path merely because the user asked to inspect it.
See references/file-actions.md for the file-action boundary.