AGENT Mode

AGENT mode is Genie’s tool-using workflow. It can inspect FileMaker context, call Genie-owned MCP tools, and then answer, ask one clarification, or prepare a reviewed artifact.

Use AGENT when the request needs evidence gathering before the answer:

inspect the active/open FileMaker file
read script context or a named script
review or debug script behavior
prepare a new script or script edit from live evidence
answer table/report/chart questions from read-only row data
compile copy-only layout object output
use Klai / BetterForms hook guidance when that capability pack is enabled

How AGENT works

AGENT uses the same local MCP tool contracts exposed to external clients:

genie_files for active/open FileMaker file context
genie_scripts for script context, content, Script Schema, Script Catalog, steps, functions, validation, and script artifacts
genie_metadata for tables, fields, layouts, relationships, value lists, and metadata selections
genie_get_guides for workflow guidance and resource fallback
genie_evaluate for FileMaker calculation checks
genie_query for read-only SELECT row data
genie_stage_layout for copy-only layout object compilation

Tool progress appears as product-facing loading status. Routine tool traces are diagnostic, not the main answer.

Script output

For script-build and script-edit requests, AGENT does not apply changes directly.

Instead, AGENT gathers evidence, authors public Script Schema, validates or repairs when useful, and returns an agent_script_build artifact. Genie then promotes that artifact into the normal CODE result surface:

Preview Code
Copy
Create Script for supported new-script artifacts
Apply Code

Create Script imports a supported reviewed script as a new script in FileMaker. Apply Code remains the user-controlled action for the current-script workflow. AGENT does not create a separate hidden apply path and does not route normal script drafts through Workbench.

Expanded AGENT result with assumptions, warnings, Preview, Copy, Create Script, and Apply actions

Script Workspace Agent

The compact Script Workspace Agent is the floating AGENT-only surface attached to Script Workspace.

It is separate from the older QuickCode lane. QuickCode remains dormant, while Script Workspace Agent:

starts in AGENT mode only
lets you pick a concrete provider/model
prepares Genie runtime and local MCP state before sending
may preload the active script name as lightweight context
fetches exact script content lazily only when the request needs it
keeps Refresh Selection / Capture as the explicit XML capture path

Opening the compact panel should not silently copy Script Workspace XML, apply code, or refresh context on send/focus/window events.

Web Search

AGENT can request provider-native web search where supported.

OpenAI and Anthropic AGENT routes can use provider-native web search.
Google/Gemini, xAI, and Custom / Local routes do not receive a fake web-search tool.
Use web search for current external facts or docs, not for FileMaker context that Genie can inspect locally.

Read-only reports

For report, table, and chart requests, AGENT should:

resolve schema with genie_metadata
use genie_query only for actual read-only row data
answer with compact markdown tables
include chart-ready JSON only when a chart is requested or clearly useful

Do not use genie_query to discover field lists, table schema, or relationships.

AGENT response with a generated chart and Copy PNG and Export PNG actions

Clarifications

AGENT should ask one concrete blocking question when it is unsure about:

the target script or FileMaker file
whether the user wants read-only review or an edit
missing metadata required for a safe draft
destructive scope
whether a generated artifact would be safe or applyable

A short question is expected behavior. It is better than wasting tool loops or producing a generic artifact.

AGENT preflight question offering specific script-review choices and a manual answer field