build

El dominio build tiene 6 acciones. En la superficie meta se alcanzan todas a través de arcane_build; en la individual, cada una es una herramienta propia; en la dinámica se ejecutan con arcane_execute_action y el ID canónico.

Resumen

Acción	Título	Tipo
build.browse	Browse build workspace files	lectura
build.delete	Delete build workspace file	destructiva
build.file_download	Download build workspace file	lectura
build.file_get	Get build workspace file content	lectura
build.mkdir	Create build workspace directory	escritura
build.upload	Upload build workspace file	escritura

Acciones

build.browse

Browse build workspace files

List files and directories under the builds workspace root

• Tipo: lectura
• Parámetros obligatorios: ninguno
• Meta-herramienta: arcane_build con "action": "browse"
• Herramienta individual: arcane_build_browse
• Ruta de Arcane: GET /api/environments/{id}/builds/browse
• ID de operación: builds-browse
• Uso: Lists one directory (path, default /) of the build workspace, the tree under the buildsDirectory setting (default /builds, changed with settings.update) that holds contexts for image.build. It needs build-workspaces:manage. Entries give name, path relative to the workspace root (no leading slash), isDirectory, size and modTime, and image.build takes the absolute host path buildsDirectory + path as contextDir.
• Acciones relacionadas: build.file_get, build.mkdir, build.upload, build.delete, image.build

build.delete

Delete build workspace file

Delete a file or directory under the builds workspace root

• Tipo: destructiva — exige confirm: true
• Parámetros obligatorios: ninguno
• Meta-herramienta: arcane_build con "action": "delete"
• Herramienta individual: arcane_build_delete
• Ruta de Arcane: DELETE /api/environments/{id}/builds/browse
• ID de operación: builds-browse-delete
• Uso: Deletes a file or a whole directory with everything inside it (path from build.browse, relative to the workspace root). The root / (or .) itself is refused with 400, and a path that does not exist succeeds (nothing to delete). Irreversible, needs build-workspaces:manage. Errors in this domain are client errors: 404 for a missing path, 403 for one that leaves the workspace (.. or a symlink), 400 for a file read of a directory. Only a workspace root Arcane cannot create (an unwritable buildsDirectory) gives 500.
• Acciones relacionadas: build.browse, build.mkdir

build.file_download

Download build workspace file

Download a file from the builds workspace root

• Tipo: lectura
• Parámetros obligatorios: ninguno
• Meta-herramienta: arcane_build con "action": "file_download"
• Herramienta individual: arcane_build_file_download
• Ruta de Arcane: GET /api/environments/{id}/builds/browse/download
• ID de operación: builds-browse-download
• Uso: Downloads a workspace file (path from build.browse) as raw bytes: text comes back as content, binary data as an embedded blob, both capped by ARCANE_MCP_MAX_DOWNLOAD_BYTES. build.file_get is simpler for reading a Dockerfile or other text file.
• Acciones relacionadas: build.file_get, build.browse

build.file_get

Get build workspace file content

Read file content under the builds workspace root

• Tipo: lectura
• Parámetros obligatorios: ninguno
• Meta-herramienta: arcane_build con "action": "file_get"
• Herramienta individual: arcane_build_file_get
• Ruta de Arcane: GET /api/environments/{id}/builds/browse/content
• ID de operación: builds-browse-content
• Uso: Reads a workspace file (path from build.browse, relative to the workspace root) to check a Dockerfile or other context file. Text comes back decoded in content (contentEncoding utf-8), binary data stays base64 (contentEncoding base64), with a detected mimeType. maxBytes (default 1048576) is the read limit. Prefer it to build.file_download.
• Acciones relacionadas: build.browse, build.file_download

build.mkdir

Create build workspace directory

Create a directory under the builds workspace root

• Tipo: escritura
• Parámetros obligatorios: ninguno
• Meta-herramienta: arcane_build con "action": "mkdir"
• Herramienta individual: arcane_build_mkdir
• Ruta de Arcane: POST /api/environments/{id}/builds/browse/mkdir
• ID de operación: builds-browse-mkdir
• Uso: Creates a directory (path relative to the build workspace root, e.g. /myapp) including missing parents, typically a new build context before build.upload (which also creates its destination directory itself). Path / is accepted as a no-op. Needs build-workspaces:manage.
• Acciones relacionadas: build.upload, build.browse, build.delete

build.upload

Upload build workspace file

Copy a complete chunked upload session into the builds workspace root. multipart/form-data bodies are still accepted for backward compatibility. That form is deprecated and will be removed in a future release.

• Tipo: escritura
• Parámetros obligatorios: uploadId
• Meta-herramienta: arcane_build con "action": "upload"
• Herramienta individual: arcane_build_upload
• Ruta de Arcane: POST /api/environments/{id}/builds/browse/upload
• ID de operación: builds-browse-upload
• Uso: Writes one file (a Dockerfile or other context file) into the build workspace directory path (default /, created if missing): first upload.session_create with kind build-workspace and the bare file name (no / or , or the upload fails), send every chunk with upload.chunk_put, then pass the session id as uploadId. The file is stored under the session’s filename and the session is used up. Repeat per file. Needs build-workspaces:manage.
• Acciones relacionadas: upload.session_create, upload.chunk_put, build.mkdir, build.browse, image.build