@schandlergarcia/sf-web-components 1.9.82 → 1.9.84

package/.a4drules/skills/command-center-builder/getting-started.md

@@ -114,14 +114,17 @@ Only create `Flight__c.Weather_Impact__c` (PRD section 14a) AFTER the user confi
 
 **How to work:** Make surgical edits to the existing `EngineDashboard.tsx`. Do NOT rewrite the file.
 
+> **Important:** We do NOT use `AgentforceConversationClient` (the iframe widget). All agent communication goes through the REST-based Agent API via the `useEvaAgent` hook. The Vite dev server proxies the requests (`/sf-oauth` and `/sf-agent`) to avoid CORS issues.
+
 **Files to read first (only these):**
 1. `src/pages/EngineDashboard.tsx` — the current dashboard
 
 **Edits to make (in order):**
 
-1. **Add ChatBar import** (if not already imported from the barrel):
+1. **Add imports:**
    ```tsx
    import { ChatBar } from "@/components/library";
+   import useEvaAgent from "@/hooks/useEvaAgent";
    ```
 
 2. **Add chat suggestions constant** at module scope:
@@ -134,9 +137,15 @@ Only create `Flight__c.Weather_Impact__c` (PRD section 14a) AFTER the user confi
    ];
    ```
 
-3. **Add handleChat function** at module scope:
+3. **Add agent hook + handler** inside the component:
    ```tsx
-   const handleChat = (msg: string) => ({ text: `Looking into: "${msg}"…` });
+   const { messages: evaMessages, isReady, isSending, connect, sendMessage } = useEvaAgent();
+   useEffect(() => { connect(); }, [connect]);
+
+   const handleChat = (text: string) => {
+     sendMessage(text);
+     return { text: `Looking into: "${text}"…` };
+   };
    ```
 
 4. **Insert ChatBar JSX** between the map section and the data panels:
@@ -151,7 +160,7 @@ Only create `Flight__c.Weather_Impact__c` (PRD section 14a) AFTER the user confi
    </div>
    ```
 
-5. **Add AgentforceConversationClient** with `agentId="0Xxa5000000relhCAA"` and `agentLabel="Eva"`
+5. Do **NOT** add `AgentforceConversationClient` — the `useEvaAgent` hook replaces it entirely.
 
 **After adding Eva — STOP and suggest (do not create yet):**
 
@@ -166,6 +175,7 @@ Say: *"Now I'll write an Apex service class to publish disruption records to tha
 Only create `TravelDisruptionEventService` (PRD section 14c) AFTER the user confirms.
 
 **What NOT to build without asking:**
+- Do NOT use `AgentforceConversationClient` — use `useEvaAgent` hook instead
 - Do NOT create platform events or Apex classes without user confirmation
 - Do NOT rewrite EngineDashboard.tsx from scratch
 - Do NOT read library component source files
@@ -182,8 +192,10 @@ Only create `TravelDisruptionEventService` (PRD section 14c) AFTER the user conf
 | Flip `dataStrategy.ts` to `false` | Skip | Edit | — |
 | Custom field metadata | Skip | Suggest → wait | — |
 | ChatBar (Eva) | Skip | Skip | Surgical edit |
-| AgentforceConversationClient | Skip | Skip | Surgical edit |
+| `useEvaAgent` hook (Agent API) | Skip | Skip | Surgical edit |
 | Platform event | Skip | Skip | Suggest → wait |
 | Apex service | Skip | Skip | Suggest → wait |
 
 **Data mode control:** `ENABLE_SAMPLE_DATA_CACHE` in `src/lib/dataStrategy.ts` is the backend switch. `CommandCenter.tsx` reads this flag and passes `initialMode` to `DataModeProvider`. Phase 1 leaves it `true` (sample data). Phase 2 flips it to `false` (live data — different travelers, cities, and metrics). There is no UI toggle.
+
+**Agent communication:** `useEvaAgent` hook in `src/hooks/useEvaAgent.ts` handles OAuth → session → messages → cleanup via the Agent REST API. Config is in `src/config/agentApi.ts`. Vite proxy rules (`/sf-oauth`, `/sf-agent`) in `vite.config.ts` forward requests to the Salesforce org and Agent API host.

package/CHANGELOG.md

@@ -5,6 +5,24 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [1.9.84] - 2026-04-07
+
+### Fixed
+- **Reset script no longer deletes custom fields** — `.field-meta.xml` files in `force-app/main/default/objects/` are now preserved across resets. Only Apex classes and platform events are cleaned.
+- **Reset script preserves `TCC_TravelMetricsController`** — Apex class cleanup now skips permanent classes listed in `KEEP_CLASSES` array.
+
+## [1.9.83] - 2026-04-07
+
+### Added
+- **Agentforce Agent REST API integration** — Replaced iframe-based `AgentforceConversationClient` with direct API calls via the new `useEvaAgent` hook (`data/useEvaAgent.ts`). The hook handles the full lifecycle: OAuth client-credentials → create session → send messages → end session on unmount.
+- **Agent API config** (`data/agentApiConfig.ts`) — Credentials and endpoint configuration for the Agentforce Agent API, installed to `src/config/agentApi.ts`.
+- **Vite proxy rules** — Added `/sf-oauth` and `/sf-agent` proxy entries in `vite.config.ts` template so Agent API calls from the browser avoid CORS.
+- **Postinstall** — Now copies `useEvaAgent.ts` to `src/hooks/` and `agentApiConfig.ts` to `src/config/agentApi.ts`.
+
+### Changed
+- **PRD section 9** — Replaced `AgentforceConversationClient` instructions with `useEvaAgent` hook usage and Agent API flow.
+- **Build guide Phase 3** — Updated surgical edit instructions to use `useEvaAgent` instead of the iframe widget.
+
 ## [1.9.82] - 2026-04-06
 
 ### Fixed

package/data/agentApiConfig.ts

@@ -0,0 +1,36 @@
+/**
+ * Agentforce Agent API Configuration
+ *
+ * These values connect the ChatBar to the real Agentforce agent (Eva)
+ * via the REST-based Agent API instead of the iframe-based
+ * AgentforceConversationClient.
+ *
+ * Flow: OAuth token → create session → send messages → end session
+ *
+ * All requests are proxied through the Vite dev server to avoid CORS.
+ * See vite.config.ts proxy rules:
+ *   /sf-oauth/*  → myDomainUrl (for OAuth token)
+ *   /sf-agent/*  → agentApiBaseUrl (for Agent API calls)
+ */
+
+export const AGENT_API_CONFIG = {
+  myDomainUrl: "https://tdx26-keynote-org-1com.my.salesforce.com",
+
+  clientId:
+    "3MVG9Gm6vbdjgMWSOIAuIN3VSB5Rju6PgYQ5rl1yH3bVTTg9E2as4.C61Q0cyT.zqv2vUWNaxrm.A7SW5o3t7",
+  clientSecret:
+    "9ADF795A183A6B074A2E4B4CB1748B8DF7090C74191AF1C190213B512A733E03",
+
+  agentId: "0Xxa5000000rQlxCAE",
+
+  agentApiBaseUrl: "https://api.salesforce.com",
+
+  bypassUser: true,
+
+  demoTraveler: {
+    contactId: "003a500000mj4TlAAI",
+    email: "sarah.chen@arcline.ai",
+    firstName: "Sarah",
+    lastName: "Chen",
+  },
+};

package/data/engine-command-center-prd.md

@@ -254,9 +254,13 @@ const spendChartData = useDataSource({
 
 ## 9. Eva — Agentforce Integration
 
-Two components work together:
+Two pieces work together: a **ChatBar** for user input and the **`useEvaAgent` hook** which talks to the Agentforce Agent REST API.
 
-**ChatBar** — a command-palette strip below the hero map for quick suggested prompts. NOT in the header. NOT a FAB or sliding panel.
+> **Important:** We do NOT use `AgentforceConversationClient` (the iframe widget). All agent communication goes through the REST-based Agent API via the `useEvaAgent` hook. The Vite dev server proxies the requests to avoid CORS issues.
+
+### ChatBar
+
+A command-palette strip below the hero map. NOT in the header. NOT a FAB or sliding panel.
 
 ```tsx
 <div className="px-4 pt-4">
@@ -271,20 +275,35 @@ Two components work together:
 
 Suggestions: "Storm warning in the Midwest — which travelers are affected?", "What's our severe weather rebooking policy?", "Notify Anna and Sofia about the Chicago delays", "Create a support case for Anna Johansson's flight"
 
-Define `handleChat` and `CHAT_SUGGESTIONS` at module scope.
+### useEvaAgent Hook
 
-**AgentforceConversationClient** — the real Salesforce agent. Wire it with the Eva agent ID. Place it at the bottom of the dashboard component (it renders as a floating widget).
+The hook manages the full Agent API lifecycle — OAuth, session, messaging, cleanup.
 
 ```tsx
-import { AgentforceConversationClient } from "@/components/AgentforceConversationClient";
+import useEvaAgent from "@/hooks/useEvaAgent";
 
-<AgentforceConversationClient
-  agentId="0Xxa5000000relhCAA"
-  agentLabel="Eva"
-/>
+// Inside the component:
+const { messages, isReady, isSending, connect, sendMessage } = useEvaAgent();
+
+// Connect on mount (or on first ChatBar focus):
+useEffect(() => { connect(); }, [connect]);
+
+// Wire to ChatBar:
+const handleChat = (text: string) => {
+  sendMessage(text);
+  return { text: `Looking into: "${text}"…` };
+};
 ```
 
-The `AgentforceConversationClient` is already in the codebase (commented out in `appLayout.tsx`). Uncomment it or add it directly to the dashboard with the agent ID above.
+The hook:
+1. **Authenticates** via OAuth client-credentials (`POST /sf-oauth/services/oauth2/token`)
+2. **Creates a session** (`POST /sf-agent/einstein/ai-agent/v1/agents/{agentId}/sessions`)
+3. **Sends messages** (`POST /sf-agent/…/messages`) — returns agent response text
+4. **Ends the session** (`DELETE /sf-agent/…`) on unmount
+
+Config is in `src/config/agentApi.ts`. Proxy rules are in `vite.config.ts` (`/sf-oauth` and `/sf-agent`).
+
+Define `CHAT_SUGGESTIONS` at module scope.
 
 ---
 
@@ -382,11 +401,13 @@ Build incrementally in 3 prompts. Each prompt builds on the previous result. The
 
 1. Make **surgical edits** to the existing `EngineDashboard.tsx` — do NOT rewrite the entire file
 2. Add `ChatBar` with suggestions from section 9, placed between map and data panels
-3. Add `AgentforceConversationClient` with `agentId="0Xxa5000000relhCAA"` and `agentLabel="Eva"`
-4. After adding Eva, **STOP and suggest** the platform event — do NOT create it until the user confirms
-5. After user confirms and platform event is created, **STOP and suggest** the Apex class — do NOT create it until the user confirms
+3. Add `useEvaAgent` hook — import from `@/hooks/useEvaAgent`, call `connect()` on mount, wire `sendMessage` to `handleChat`
+4. Do NOT use `AgentforceConversationClient` (the iframe widget) — we use the Agent REST API via the `useEvaAgent` hook
+5. After adding Eva, **STOP and suggest** the platform event — do NOT create it until the user confirms
+6. After user confirms and platform event is created, **STOP and suggest** the Apex class — do NOT create it until the user confirms
 
 **What the agent must NOT do in this prompt:**
+- Do NOT use `AgentforceConversationClient` — use `useEvaAgent` hook instead (Agent REST API)
 - Do NOT rewrite `EngineDashboard.tsx` from scratch — make targeted edits to the existing Phase 2 file
 - Do NOT create platform events or Apex classes without user confirmation — each is a scripted demo moment where you suggest, wait, then create
 - Do NOT read library component source files

package/data/useEvaAgent.ts

@@ -0,0 +1,288 @@
+/**
+ * useEvaAgent — React hook for the Agentforce Agent REST API
+ *
+ * Handles the full lifecycle:
+ *   1. OAuth client-credentials → access_token
+ *   2. POST …/sessions → sessionId + message href
+ *   3. POST …/messages → agent response text
+ *   4. DELETE …/sessions → cleanup on unmount
+ *
+ * All HTTP calls go through the Vite proxy (see vite.config.ts):
+ *   /sf-oauth/*  → myDomainUrl
+ *   /sf-agent/*  → agentApiBaseUrl
+ */
+
+import { useCallback, useEffect, useRef, useState } from "react";
+import { AGENT_API_CONFIG } from "@/config/agentApi";
+
+export interface AgentMessage {
+  role: "user" | "agent";
+  text: string;
+  id: string;
+  timestamp: string;
+}
+
+interface SessionState {
+  accessToken: string;
+  sessionId: string;
+  messagesHref: string;
+  endHref: string;
+}
+
+export default function useEvaAgent() {
+  const [messages, setMessages] = useState<AgentMessage[]>([]);
+  const [isConnecting, setIsConnecting] = useState(false);
+  const [isReady, setIsReady] = useState(false);
+  const [isSending, setIsSending] = useState(false);
+  const [error, setError] = useState<string | null>(null);
+
+  const sessionRef = useRef<SessionState | null>(null);
+  const sequenceRef = useRef(1);
+  const abortRef = useRef<AbortController | null>(null);
+
+  /* ── Step 1: OAuth token ──────────────────────────────── */
+  async function authenticate(signal: AbortSignal): Promise<string> {
+    const { clientId, clientSecret } = AGENT_API_CONFIG;
+
+    const body = new URLSearchParams({
+      grant_type: "client_credentials",
+      client_id: clientId,
+      client_secret: clientSecret,
+    });
+
+    const res = await fetch("/sf-oauth/services/oauth2/token", {
+      method: "POST",
+      headers: { "Content-Type": "application/x-www-form-urlencoded" },
+      body,
+      signal,
+    });
+
+    if (!res.ok) {
+      const text = await res.text();
+      throw new Error(`OAuth failed (${res.status}): ${text}`);
+    }
+
+    const data = await res.json();
+    return data.access_token;
+  }
+
+  /* ── Step 2: Create session ───────────────────────────── */
+  async function createSession(
+    accessToken: string,
+    signal: AbortSignal
+  ): Promise<Omit<SessionState, "accessToken">> {
+    const { agentId, bypassUser, demoTraveler, myDomainUrl } =
+      AGENT_API_CONFIG;
+
+    const payload = {
+      externalSessionKey: crypto.randomUUID(),
+      instanceConfig: { endpoint: myDomainUrl },
+      streamingCapabilities: { chunkTypes: ["Text"] },
+      bypassUser,
+      variables: [
+        {
+          name: "$Context.EndUserId",
+          type: "Text",
+          value: demoTraveler.contactId,
+        },
+        {
+          name: "$Context.EndUserEmail",
+          type: "Text",
+          value: demoTraveler.email,
+        },
+        {
+          name: "$Context.EndUserFirstName",
+          type: "Text",
+          value: demoTraveler.firstName,
+        },
+        {
+          name: "$Context.EndUserLastName",
+          type: "Text",
+          value: demoTraveler.lastName,
+        },
+      ],
+    };
+
+    const res = await fetch(
+      `/sf-agent/einstein/ai-agent/v1/agents/${agentId}/sessions`,
+      {
+        method: "POST",
+        headers: {
+          Authorization: `Bearer ${accessToken}`,
+          "Content-Type": "application/json",
+        },
+        body: JSON.stringify(payload),
+        signal,
+      }
+    );
+
+    if (!res.ok) {
+      const text = await res.text();
+      throw new Error(`Session creation failed (${res.status}): ${text}`);
+    }
+
+    const data = await res.json();
+    return {
+      sessionId: data.sessionId,
+      messagesHref: data._links?.messages?.href ?? "",
+      endHref: data._links?.end?.href ?? "",
+    };
+  }
+
+  /* ── Step 3: Send message ─────────────────────────────── */
+  const sendMessage = useCallback(async (text: string) => {
+    const session = sessionRef.current;
+    if (!session) return;
+
+    const userMsg: AgentMessage = {
+      role: "user",
+      text,
+      id: `user-${Date.now()}`,
+      timestamp: new Date().toISOString(),
+    };
+    setMessages((prev) => [...prev, userMsg]);
+    setIsSending(true);
+
+    try {
+      const seqId = sequenceRef.current++;
+
+      const messagesUrl = session.messagesHref.startsWith("http")
+        ? `/sf-agent${new URL(session.messagesHref).pathname}`
+        : `/sf-agent${session.messagesHref}`;
+
+      const res = await fetch(messagesUrl, {
+        method: "POST",
+        headers: {
+          Authorization: `Bearer ${session.accessToken}`,
+          "Content-Type": "application/json",
+          Accept: "application/json",
+        },
+        body: JSON.stringify({
+          message: { sequenceId: seqId, type: "Text", text },
+        }),
+      });
+
+      if (!res.ok) {
+        const errText = await res.text();
+        throw new Error(`Agent message failed (${res.status}): ${errText}`);
+      }
+
+      const data = await res.json();
+
+      const agentTexts: string[] = [];
+      if (Array.isArray(data.messages)) {
+        for (const m of data.messages) {
+          if (m.type === "Inform" && m.message) {
+            agentTexts.push(m.message);
+          } else if (m.type === "Text" && m.message) {
+            agentTexts.push(m.message);
+          }
+        }
+      }
+
+      const responseText =
+        agentTexts.length > 0
+          ? agentTexts.join("\n\n")
+          : data.message ?? "No response from agent.";
+
+      const agentMsg: AgentMessage = {
+        role: "agent",
+        text: responseText,
+        id: `agent-${Date.now()}`,
+        timestamp: new Date().toISOString(),
+      };
+      setMessages((prev) => [...prev, agentMsg]);
+    } catch (err: unknown) {
+      const msg = err instanceof Error ? err.message : "Unknown error";
+      setError(msg);
+      const errMsg: AgentMessage = {
+        role: "agent",
+        text: `Error: ${msg}`,
+        id: `error-${Date.now()}`,
+        timestamp: new Date().toISOString(),
+      };
+      setMessages((prev) => [...prev, errMsg]);
+    } finally {
+      setIsSending(false);
+    }
+  }, []);
+
+  /* ── Step 4: End session ──────────────────────────────── */
+  const endSession = useCallback(async () => {
+    const session = sessionRef.current;
+    if (!session) return;
+
+    try {
+      const endUrl = session.endHref.startsWith("http")
+        ? `/sf-agent${new URL(session.endHref).pathname}`
+        : `/sf-agent${session.endHref}`;
+
+      await fetch(endUrl, {
+        method: "DELETE",
+        headers: { Authorization: `Bearer ${session.accessToken}` },
+      });
+    } catch {
+      /* best-effort cleanup */
+    }
+
+    sessionRef.current = null;
+    setIsReady(false);
+  }, []);
+
+  /* ── Init: authenticate + create session on mount ─────── */
+  const connect = useCallback(async () => {
+    if (sessionRef.current) return;
+
+    abortRef.current = new AbortController();
+    const { signal } = abortRef.current;
+
+    setIsConnecting(true);
+    setError(null);
+
+    try {
+      const accessToken = await authenticate(signal);
+      const session = await createSession(accessToken, signal);
+
+      sessionRef.current = { accessToken, ...session };
+      sequenceRef.current = 1;
+      setIsReady(true);
+    } catch (err: unknown) {
+      if ((err as Error).name !== "AbortError") {
+        const msg = err instanceof Error ? err.message : "Connection failed";
+        setError(msg);
+      }
+    } finally {
+      setIsConnecting(false);
+    }
+  }, []);
+
+  /* ── Cleanup on unmount ───────────────────────────────── */
+  useEffect(() => {
+    return () => {
+      abortRef.current?.abort();
+      if (sessionRef.current) {
+        const session = sessionRef.current;
+        const endUrl = session.endHref.startsWith("http")
+          ? `/sf-agent${new URL(session.endHref).pathname}`
+          : `/sf-agent${session.endHref}`;
+
+        fetch(endUrl, {
+          method: "DELETE",
+          headers: { Authorization: `Bearer ${session.accessToken}` },
+        }).catch(() => {});
+        sessionRef.current = null;
+      }
+    };
+  }, []);
+
+  return {
+    messages,
+    isConnecting,
+    isReady,
+    isSending,
+    error,
+    connect,
+    sendMessage,
+    endSession,
+  };
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@schandlergarcia/sf-web-components",
-  "version": "1.9.82",
+  "version": "1.9.84",
   "description": "Reusable Salesforce web components library with Tailwind CSS v4 and shadcn/ui",
   "type": "module",
   "main": "./dist/index.js",

package/scripts/postinstall.mjs

@@ -315,6 +315,41 @@ if (fs.existsSync(dataSourceDir)) {
     }
   }
 
+  // Copy useEvaAgent.ts (Agentforce Agent API hook)
+  const useEvaAgentSource = path.join(dataSourceDir, 'useEvaAgent.ts');
+  const useEvaAgentTarget = path.join(targetHooksDir, 'useEvaAgent.ts');
+
+  if (fs.existsSync(useEvaAgentSource)) {
+    try {
+      if (!fs.existsSync(targetHooksDir)) {
+        fs.mkdirSync(targetHooksDir, { recursive: true });
+      }
+      fs.copyFileSync(useEvaAgentSource, useEvaAgentTarget);
+      console.log('  ✓ Installed useEvaAgent.ts');
+      dataFilesInstalled++;
+    } catch (error) {
+      console.error(`  ✗ Failed to install useEvaAgent.ts: ${error.message}`);
+    }
+  }
+
+  // Copy agentApiConfig.ts → src/config/agentApi.ts
+  const agentApiConfigSource = path.join(dataSourceDir, 'agentApiConfig.ts');
+  const targetConfigDir = path.join(cwd, 'src/config');
+  const agentApiConfigTarget = path.join(targetConfigDir, 'agentApi.ts');
+
+  if (fs.existsSync(agentApiConfigSource)) {
+    try {
+      if (!fs.existsSync(targetConfigDir)) {
+        fs.mkdirSync(targetConfigDir, { recursive: true });
+      }
+      fs.copyFileSync(agentApiConfigSource, agentApiConfigTarget);
+      console.log('  ✓ Installed src/config/agentApi.ts');
+      dataFilesInstalled++;
+    } catch (error) {
+      console.error(`  ✗ Failed to install agentApiConfig.ts: ${error.message}`);
+    }
+  }
+
   // Copy engine_logo.png
   const assetsSourceDir = path.join(packageRoot, 'assets/images');
   const targetAssetsDir = path.join(cwd, 'src/assets/images');

package/scripts/reset-command-center.sh

@@ -771,35 +771,36 @@ fi
 if [ -n "$SFDX_DEFAULT" ]; then
   metadata_cleaned=0
 
-  # Remove all Apex classes (.cls and .cls-meta.xml)
+  # Remove Apex classes (.cls and .cls-meta.xml), preserving permanent classes
+  KEEP_CLASSES=("TCC_TravelMetricsController")
   CLASSES_DIR="$SFDX_DEFAULT/classes"
   if [ -d "$CLASSES_DIR" ]; then
-    cls_count=$(find "$CLASSES_DIR" -maxdepth 1 \( -name "*.cls" -o -name "*.cls-meta.xml" \) 2>/dev/null | wc -l | tr -d ' ')
-    if [ "$cls_count" -gt 0 ]; then
-      [ "$metadata_cleaned" -eq 0 ] && echo "→ Cleaning Salesforce metadata…"
-      rm -f "$CLASSES_DIR"/*.cls "$CLASSES_DIR"/*.cls-meta.xml
-      echo "  ✓ Removed $cls_count Apex class files"
+    cls_removed=0
+    for f in "$CLASSES_DIR"/*.cls "$CLASSES_DIR"/*.cls-meta.xml; do
+      [ -f "$f" ] || continue
+      base="$(basename "$f")"
+      skip=false
+      for keep in "${KEEP_CLASSES[@]}"; do
+        if [[ "$base" == "$keep".cls || "$base" == "$keep".cls-meta.xml ]]; then
+          skip=true
+          break
+        fi
+      done
+      if [ "$skip" = false ]; then
+        [ "$metadata_cleaned" -eq 0 ] && [ "$cls_removed" -eq 0 ] && echo "→ Cleaning Salesforce metadata…"
+        rm "$f"
+        cls_removed=$((cls_removed + 1))
+      fi
+    done
+    if [ "$cls_removed" -gt 0 ]; then
+      echo "  ✓ Removed $cls_removed Apex class files (kept ${KEEP_CLASSES[*]})"
       metadata_cleaned=1
     fi
   fi
 
-  # Remove custom fields created during the demo
+  # Remove platform event directories (but NOT custom fields — those persist across resets)
   OBJECTS_DIR="$SFDX_DEFAULT/objects"
   if [ -d "$OBJECTS_DIR" ]; then
-    for fields_dir in "$OBJECTS_DIR"/*/fields; do
-      if [ -d "$fields_dir" ]; then
-        for f in "$fields_dir"/*.field-meta.xml; do
-          if [ -f "$f" ]; then
-            [ "$metadata_cleaned" -eq 0 ] && echo "→ Cleaning Salesforce metadata…"
-            rm "$f"
-            echo "  ✓ Removed $(basename "$f")"
-            metadata_cleaned=1
-          fi
-        done
-      fi
-    done
-
-    # Remove platform event directories
     for evt_dir in "$OBJECTS_DIR"/*__e; do
       if [ -d "$evt_dir" ]; then
         [ "$metadata_cleaned" -eq 0 ] && echo "→ Cleaning Salesforce metadata…"
@@ -827,7 +828,6 @@ echo "║     • Component library + theme providers      ║"
 echo "║                                                ║"
 echo "║   Cleaned:                                     ║"
 echo "║     • Apex classes (force-app classes/)         ║"
-echo "║     • Custom fields (force-app objects/)        ║"
 echo "║     • Platform events (force-app *__e/)         ║"
 echo "║                                                ║"
 echo "║   Layout:                                      ║"

package/src/templates/config/vite.config.ts.template

@@ -34,6 +34,24 @@ export default defineConfig(({ mode }) => {
         : []),
     ] as import('vite').PluginOption[],
 
+    // Proxy Agentforce Agent API calls through the dev server to avoid CORS.
+    // /sf-oauth/* → Salesforce org (for OAuth client-credentials token)
+    // /sf-agent/* → Agent API base (for session + message calls)
+    server: {
+      proxy: {
+        '/sf-oauth': {
+          target: 'https://tdx26-keynote-org-1com.my.salesforce.com',
+          changeOrigin: true,
+          rewrite: (p: string) => p.replace(/^\/sf-oauth/, ''),
+        },
+        '/sf-agent': {
+          target: 'https://api.salesforce.com',
+          changeOrigin: true,
+          rewrite: (p: string) => p.replace(/^\/sf-agent/, ''),
+        },
+      },
+    },
+
     // Build configuration for MPA
     build: {
       outDir: resolve(__dirname, 'dist'),