Catálogo de herramientas
Superficies nativas, packs y controles humanos.
Comal 0.1.0 · Revisado el 15 oct 2026
En esta página
Inventario contrastado con Comal 0.1.0, el 2026-10-16. Las referencias de código señalan el punto inspeccionado, no disponibilidad garantizada de servicios externos.
Catálogo por familia
La disponibilidad depende de plugins activos, actor, etapa, packs y capacidades. Un nombre en esta referencia no garantiza que esté ofrecido en cada llamada. El catálogo vigente de la casa es /operations; la vista model-facing es /tools.
Archivos y procesos
| Operación | Contrato de uso | Fuente |
|---|---|---|
Read |
Texto UTF-8 con números de línea; hasta 1 MiB por archivo. | src/tools.mjs:14 |
Write |
Crea/reemplaza texto; verifica lectura propia vigente y bytes escritos. | src/tools.mjs:15 |
Edit |
Sustituye texto exacto inspeccionado; coteja el hash antes de editar. | src/tools.mjs:16 |
Glob |
Busca rutas relativas; excluye estado interno y dependencias. | src/tools.mjs:17 |
Grep |
Busca expresiones con ripgrep; requiere rg instalado. | src/tools.mjs:18 |
ListDirectory |
Lista un directorio sin shell (200 entradas por defecto, máximo 1000). | src/tools.mjs:19 |
FileInfo |
Metadatos y hasta 32 bytes de firma; no decodifica medios. | src/tools.mjs:20 |
Bash |
Proceso de shell después de permiso; no es un sandbox. | src/tools.mjs:21 |
Web
| Operación | Contrato de uso | Fuente |
|---|---|---|
WebSearch |
Resultados de motores web con fuentes. | src/web-tools.mjs:10 |
WebFetch |
Texto de páginas HTTP(S), sin JavaScript ni cookies. | src/web-tools.mjs:11 |
Subagentes
| Operación | Contrato de uso | Fuente |
|---|---|---|
Agent |
Tarea acotada con identidad durable; explore admite background, general permanece secuencial. allowed_tools es un techo, no un permiso. | src/subagents.mjs:30 |
AgentBatch |
Hasta tres exploraciones independientes con reservas durables, outbox y estados separados; sin recursión. | src/subagents.mjs:31 |
AgentStatus |
Estados runner/turn/work y referencias de hijos de esta sesión. | src/subagents.mjs:36 |
AgentWait |
Espera acotada; no reinicia ni cancela al hijo. | src/subagents.mjs:37 |
AgentStop |
Stop durable de un hijo; resume no lo revoca. | src/subagents.mjs:38 |
AgentResume |
Continúa la misma ejecución con configuración y autoridad originales restringidas por la política actual. | src/subagents.mjs:39 |
AgentBackground |
Pasa el mismo hijo explore activo a background, sin otro spawn. | src/subagents.mjs:40 |
AgentContinue |
Continúa una delegación preparada original y completa índices faltantes sin duplicar hijos. | src/subagents.mjs:35 |
MCP
| Operación | Contrato de uso | Fuente |
|---|---|---|
McpStatus |
Estado y ubicación de configuración MCP. | src/mcp-runtime.mjs:13 |
McpConfigure |
Persistir cambios de servidores, bajo juicio. | src/mcp-runtime.mjs:14 |
McpReload |
Reconciliar conexiones y catálogo dinámico. | src/mcp-runtime.mjs:15 |
Trabajo registrado
| Operación | Contrato de uso | Fuente |
|---|---|---|
WorkTaskUpdate |
Actualizar estado de tarea y solicitar su verificación. | src/work-plan.mjs:112 |
WorkDraft |
Conservar partes de un artefacto en el trabajo registrado. | src/work-plan.mjs:120 |
WorkPlanSet |
Registrar plan, fases, criterios, artefactos y checks. | src/work-plan.mjs:399 |
WorkCheckRepair |
Reparar checks conservando identidad y trazabilidad. | src/work-plan.mjs:400 |
WorkStepRun |
Ejecutar un check declarado; sigue pasando por el juez. | src/work-plan.mjs:221 |
WorkBoard |
Consultar tablero y criterios persistidos. | src/work-plan.mjs:404 |
Evidencia
| Operación | Contrato de uso | Fuente |
|---|---|---|
WorkSnapshot |
Estado derivado de petición y trabajo. | src/work-state.mjs:197 |
AuditStatus |
Verificación de journal y ejecución registrada. | src/work-state.mjs:198 |
EvidenceRead |
Páginas y búsqueda literal sobre evidencia guardada, con digest opcional y next_call; UTF-16, sesión propia/hijos directos, sin repetir efectos. | src/work-state.mjs:179 |
Sesiones y proveedor
| Operación | Contrato de uso | Fuente |
|---|---|---|
ListAgents |
Descubrir otras sesiones vivas por capacidad. | src/peer-tools.mjs:14 |
SendMessage |
Enviar texto acotado y correlacionado; entrega no prueba ejecución. | src/peer-tools.mjs:15 |
ProviderCapabilities |
Contrato actual del proveedor, sin credenciales. | src/peer-tools.mjs:69 |
ProviderSearch |
Grounding nativo cuando está implementado y habilitado. | src/peer-tools.mjs:70 |
AnalyzeMedia |
Analizar directamente imágenes/video del workspace con capacidad adecuada. | src/peer-tools.mjs:71 |
Packs
| Operación | Contrato de uso | Fuente |
|---|---|---|
ToolPack |
Búsqueda determinista ≤5 candidatos con acquire_call; adquirir/release cambia schemas y no permisos. | src/tool-packs.mjs:54 |
Plugins
| Operación | Contrato de uso | Fuente |
|---|---|---|
PluginStatus |
Estado, dependencias y operaciones publicadas. | src/cli.mjs:440 |
Controles del host
| Operación | Contrato de uso | Fuente |
|---|---|---|
PluginEnable |
Control humano/interno del host; no es autoridad disponible para el modelo. | src/cli.mjs:442 |
PluginDisable |
Control humano/interno del host; no es autoridad disponible para el modelo. | src/cli.mjs:443 |
PluginReload |
Control humano/interno del host; no es autoridad disponible para el modelo. | src/cli.mjs:444 |
PluginRun |
Control humano/interno del host; no es autoridad disponible para el modelo. | src/cli.mjs:445 |
PluginInitialize |
Control humano/interno del host; no es autoridad disponible para el modelo. | src/cli.mjs:450 |
PluginClose |
Control humano/interno del host; no es autoridad disponible para el modelo. | src/cli.mjs:451 |
McpSync |
Control humano/interno del host; no es autoridad disponible para el modelo. | src/cli.mjs:458 |
McpInitialize |
Control humano/interno del host; no es autoridad disponible para el modelo. | src/cli.mjs:459 |
McpClose |
Control humano/interno del host; no es autoridad disponible para el modelo. | src/cli.mjs:460 |
SessionMode |
Control humano/interno del host; no es autoridad disponible para el modelo. | src/cli.mjs:610 |
SessionModel |
Control humano/interno del host; no es autoridad disponible para el modelo. | src/cli.mjs:611 |
SessionEffort |
Control humano/interno del host; no es autoridad disponible para el modelo. | src/cli.mjs:616 |
SessionRename |
Control humano/interno del host; no es autoridad disponible para el modelo. | src/cli.mjs:620 |
SessionProvider |
Control humano/interno del host; no es autoridad disponible para el modelo. | src/cli.mjs:621 |
SessionLogin |
Control humano/interno del host; no es autoridad disponible para el modelo. | src/cli.mjs:628 |
SessionLogout |
Control humano/interno del host; no es autoridad disponible para el modelo. | src/cli.mjs:629 |
SessionInbox |
Control humano/interno del host; no es autoridad disponible para el modelo. | src/cli.mjs:630 |
ReadTable |
Control humano/interno del host; no es autoridad disponible para el modelo. | src/cli.mjs:637 |
Casa
| Operación | Contrato de uso | Fuente |
|---|---|---|
HouseContext |
Identidad, límites y alcances de la casa. | src/cli.mjs:389 |
OperationCatalog |
Catálogo de contratos para el actor/superficie. | src/cli.mjs:390 |
HouseSnapshot |
Recibos, rechazos y operaciones sin cierre. | src/cli.mjs:391 |
Tarea Chrome coordinada
| Operación | Contrato de uso | Fuente |
|---|---|---|
ChromePublish |
Publica el candidato aceptado y observa su criterio DOM; la casa gestiona versión y target. Sólo con --chrome-task. | src/workflows/chrome-task.mjs:137 |
ChromeVerify |
Lee el criterio DOM y coteja el snapshot publicado con identidad vigente; no acredita por sí solo pruebas de interacción. | src/workflows/chrome-task.mjs:174 |
ChromeTest |
Ejecuta las interacciones y aserciones declaradas; puede escribir datos de prueba y recargar. Sólo si el encargo incluye tests. | src/workflows/chrome-task.mjs:175 |
ChromeFinish |
Ejecuta el check declarado y solicita cierre por el juez; rechaza evidencia que perdió vigencia. | src/workflows/chrome-task.mjs:176 |
ChromeRecover |
Reconecta y reconcilia una publicación identificada mediante lecturas. No repite Deploy/Open/Interact ni acredita funcionalidad; bloquea evidencia ausente, ajena o ambigua. /work recover lo ejecuta sin LLM. | src/workflows/chrome-task.mjs:157 |
artifacts
| Operación | Contrato de uso | Fuente |
|---|---|---|
ArtifactAccount |
Cuenta y workspaces de Comal; nunca expone el token. | src/artifact-tools.mjs:15 |
ArtifactList |
Artifacts propios o compartidos explícitamente. | src/artifact-tools.mjs:16 |
ArtifactInspect |
Versión, contrato y observaciones guardadas; no repite efectos. | src/artifact-tools.mjs:17 |
ArtifactPublish |
Host empaqueta webapp estática del workspace; candidato privado, idempotencia por bytes y procedencia de sesión del host. | src/artifact-tools.mjs:18 |
ArtifactVerify |
Solicita ejecución admitida del contrato; espera host opcional ≤30 s sin llamadas adicionales al modelo. | src/artifact-tools.mjs:19 |
ArtifactRelease |
Entrega exacta con job passed vigente; no confunde aceptación humana con verificación técnica. | src/artifact-tools.mjs:20 |
Límites de archivos y medios
Read/Write/Edit trabajan con texto hasta 1 MiB. Read ofrece 400 líneas por defecto y hasta 2000 por llamada. ListDirectory limita a 200 entradas por defecto y hasta 1000. FileInfo lee hasta 32 bytes de firma. AnalyzeMedia acepta un archivo del workspace hasta 16 MiB, sujeto también al límite del adaptador y proveedor; los adaptadores de imagen pueden imponer un límite menor. Las imágenes capturadas por MCP tienen otros límites: hasta dos referencias válidas y 2 MiB por imagen según el adaptador actual.
Autoridad de controles
SessionModel, SessionEffort, SessionLogin y otros controles del host pertenecen al humano. PluginInitialize/McpSync y cierres pertenecen a sus superficies internas. Publicar o conocer su nombre no permite al modelo invocarlos.
Ver esta página como Markdown
Fuente editable de esta guía: referencia-herramientas.md. Las páginas de referencia se regeneran desde el inventario auditado.