Workbench

Workbench es la cola de revisión para handoffs de script, DATA, layout y XML entregados a Genie por clientes Local MCP como Codex, Cursor, Claude Desktop u otro agente IDE local.

Mantiene visible y bajo control del usuario el trabajo de agentes externos. MCP puede preparar un prompt o borrador XML, pero el staging de Workbench no ejecuta proveedores, modifica FileMaker ni aplica código durante la llamada de herramienta. La antigua beta Local MCP que auto-ejecutaba Create Script está archivada.

Dónde aparece

Abre Workbench desde la barra de herramientas con el icono de checklist.

Los items Workbench muestran:

título
modo: CODE, DATA o LAYOUT
cliente fuente
estado
script objetivo o destino del handoff cuando esté disponible
prompt, notas o resumen del artefacto
notas de revisión
advertencias
botones de acción

El selector superior separa:

Pending: items pendientes de revisión o acción
Submitted: items ya enviados a Genie, con estado enviado, fuente, script objetivo y las mismas advertencias/acciones visibles cuando correspondan

Workbench mostrando secciones Pending y Submitted para borradores de script

Según el item preparado, Workbench puede mostrar:

Run: enviarse por Genie
Apply: aplicar un artefacto revisado al script actual mediante el flujo protegido
Create Script: importar un borrador compatible como script FileMaker nuevo
Preview: inspeccionar el XML preparado antes de actuar
Copy: copiar el prompt o artefacto preparado
Remove: quitarse de la cola

Panel Workbench con items CODE preparados por Codex

Borrador de script Workbench con Apply, Create Script, Preview, Copy y Remove

Workbench puede conservar transportadores nativos expertos internamente. Las tarjetas permanecen legibles y compactas sin exponer XML sin procesar.

Tarjeta Workbench con script objetivo, advertencias y sin vista XML inline

Qué ocurre cuando ejecutas un item

Ejecutar un item hace el mismo tipo de trabajo que enviar un prompt desde el composer.

Genie:

aplica cualquier selección de metadatos guardada con el item
añade el prompt al chat
presenta el artefacto o flujo de compatibilidad correspondiente
entra en el pipeline normal de Genie

Para CODE, eso significa admisión Stage A, generación Stage B, reducción AST cuando esté disponible, revisión preview/copy/apply y seguridad nativa de Script Workspace. Para DATA, se mantienen las confirmaciones y guardarraíles SQL habituales.

Cómo deben preparar trabajo los agentes MCP

Un agente IDE usa fm_session action:status cuando hace falta la identidad de sesión; no hay un ritual capabilities-first.

Para trabajo de scripts con metadatos, el agente usa fm_read target:selection y pasa el metadata_selection devuelto a fm_stage kind:script.

Contrato de staging CODE

Los items CODE Workbench son intencionalmente estrechos.

Prepara CODE solo para:

un nuevo script FileMaker
una edición basada en contenido exacto leído del archivo activo o en contexto adjunto/seleccionado

Usa fm_stage kind:script para nuevos scripts y ediciones del script activo. Usa result_type: "new_script" para crear y result_type: "delta_edit" para editar.

Para delta_edit, lee primero el contenido exacto con fm_read target:script y una identidad exacta, y usa las filas numeradas como anclas. merge_ready:false no bloquea la validación ni el staging. Antes de Apply, abre el destino revisado en Script Workspace.

No prepares:

varios scripts en un solo prompt
prompts create or replace
ediciones de scripts nombrados sin contenido exacto en vivo ni contexto adjunto
CREATE TABLE, ALTER TABLE, INSERT, UPDATE, DELETE, TRUNCATE u otro SQL DATA
prompts ASK o de planificación
prompts QUERY de solo lectura
ocurrencias de tabla, relaciones, layouts, botones, Web Viewers, portales, objetos de layout o cambios de privilegios/seguridad

Transportadores nativos expertos

Un cliente experto puede entregar un transportador FileMaker completo cuando Script Schema no sea adecuado. Genie presenta una proyección legible antes de cualquier acción nativa.

Para operaciones fmxmlsnippet sin procesar que pegan en el script actual o lo editan, MCP debe proporcionar el destino exacto en script_name (también se acepta scriptName). Si falta el nombre, Genie devuelve un rechazo de staging reintentable y no crea ningún item de Workbench; el agente debe pedir solo ese nombre si aún no lo conoce y repetir la misma llamada.

Los borradores External XML no son salida de modelo validada por Stage A/B. Trata la advertencia como parte del contrato: previsualiza el XML, copialo si quieres inspeccionarlo en otro lugar y aplica solo cuando confies en el artefacto.

Para un borrador de script nuevo compatible, Create Script prepara el formato de importación de FileMaker únicamente cuando eliges esa acción. Genie muestra el progreso y confirma la creación del script. Las conversiones no compatibles fallan de forma segura y mantienen disponibles Preview, Copy o el flujo Apply aplicable.

Notificaciones de Genie que confirman la preparación y creación correcta de un script FileMaker

Enrutamiento DATA y QUERY

QUERY no es un stage Workbench. Usa fm_query para trabajo SELECT de vista previa o ejecución fuera de Workbench.

Usa fm_stage kind:data para escrituras SQL de FileMaker admitidas y DDL de tablas/campos que el usuario confirmará en Genie. No mezcles DATA y CODE en el mismo item.

Los rechazos son guía

Las entregas Workbench no admitidas devuelven resultados MCP normales ok: false. Normalmente no son errores de transporte.

Esos resultados pueden incluir recommended_actions, recommended_tool_calls, recommended_resources, stage_prompt_template o metadata_precheck. El agente IDE debe inspeccionar, separar, reescribir o presentar instrucciones manuales de FileMaker localmente y luego volver a preparar solo el trabajo admitido por Genie.