agnets done

.env.example

@@ -56,3 +56,22 @@ VITE_API_BASE_URL=/api/v1
 # Where the Vite dev proxy forwards /api. Only read by vite.config.js, never by
 # client code.
 VITE_API_PROXY_TARGET=https://mcp.krowforce.com
+
+# ── The agent runtime ───────────────────────────────────────────────────────
+#
+# Set this and the assistant panel stops simulating and starts calling the real
+# backend: a model, the tool layer, permission-aware retrieval, and a write path
+# that cannot act without a person approving it.
+#
+#     VITE_AGENT_API=/api/v1
+#
+# Same-origin path, like VITE_API_BASE — the proxy above forwards it. Unset by
+# default, deliberately: with no value the panel uses the local simulator, which
+# is deterministic, costs nothing, and is what every check in `npm test` runs
+# against. Making the real API the default would make the whole suite depend on
+# a credential.
+#
+# The backend must be running with ANTHROPIC_API_KEY set. Without one it does
+# not register the run routes at all, and the panel will report that no agent is
+# available — which is true, rather than a broken-looking 500.
+VITE_AGENT_API=