Skip to content

Commit 7d67106

Browse files
docs(agents): resolve rebase merge of agent rename + cloud caveats
Keep DeepSQL Agent branding with Hermes upstream disclosure, plus Vite host bind and Spring CORS loopback notes. Co-authored-by: Venkat SF <venkatesh.sakamuri@stayflexi.com>
1 parent 9595e1f commit 7d67106

1 file changed

Lines changed: 3 additions & 17 deletions

File tree

AGENTS.md

Lines changed: 3 additions & 17 deletions
Original file line numberDiff line numberDiff line change
@@ -177,19 +177,13 @@ only covers cloud-specific, non-obvious caveats.
177177
Redis degrades gracefully but the local `.env` points at it.
178178
- **Backend** (port 8080, base path `/api`): `bash scripts/start-backend.sh` (wraps
179179
`./mvnw spring-boot:run`; it strips `SPRING_PROFILES_ACTIVE=prod` for local runs → dev mode).
180-
<<<<<<< HEAD
181-
- **Frontend** (port 3000): `npm run dev` (Vite proxies `/api` → 8080 and `/agent-api` → 8787).
182-
- **DeepSQL Agent API** (port 8787, optional): needed for the sidebar **Agent** tab.
183-
Runtime is a customized Nous Hermes Agent; see caveats below for install +
184-
`HERMES_WEBUI_ALLOWED_ORIGINS` (upstream env name).
185-
=======
186180
- **Frontend** (port 3000): prefer `npx vite --host 0.0.0.0 --port 3000` (or `npm run dev`
187181
with `server.host` set). Plain `npm run dev` can bind **IPv6-only** (`::1:3000`) in this
188182
VM so `curl http://127.0.0.1:3000` fails even though Vite looks healthy. Vite proxies
189183
`/api` → 8080 and `/agent-api` → 8787.
190-
- **Hermes Agent webui** (port 8787, optional): needed only for the sidebar **Agent** tab.
191-
See caveats below for install + `HERMES_WEBUI_ALLOWED_ORIGINS`.
192-
>>>>>>> 7dacaac (docs(agents): note Vite IPv4 bind and Spring CORS loopback hosts)
184+
- **DeepSQL Agent API** (port 8787, optional): needed for the sidebar **Agent** tab.
185+
Runtime is a customized Nous Hermes Agent; see caveats below for install +
186+
`HERMES_WEBUI_ALLOWED_ORIGINS` (upstream env name).
193187
- A demo target DB `demo_shop` (same Postgres server, sample `customers`/`products`/`orders`)
194188
exists for exercising connection/schema features without an external database.
195189

@@ -241,19 +235,11 @@ only covers cloud-specific, non-obvious caveats.
241235
`http://deepsql-agent:8788/provision`) with `AGENT_PROVISION_SECRET`. In this VM run
242236
`python3 scripts/local-agent-provisioner.py` (needs those two env vars in `.env`).
243237
Without it, Spring logs `agent.provision-secret is unset — skipping…` and the
244-
<<<<<<< HEAD
245238
`u-admin` agent profile is never created/token-refreshed.
246-
=======
247-
`u-admin` Hermes profile is never created/token-refreshed.
248-
- **Hermes webui Origin allowlist for Vite.** Start Hermes with
249-
`HERMES_WEBUI_ALLOWED_ORIGINS=http://localhost:3000,http://127.0.0.1:3000` or browser
250-
requests via the Vite `/agent-api` proxy return **403** "Cross-origin mismatch".
251-
Webui listens on `:8787`.
252239
- **Spring CORS must allow both loopback hosts.** Set
253240
`CORS_ALLOWED_ORIGINS=http://localhost:3000,http://127.0.0.1:3000` in `.env`. Opening
254241
the UI as `http://127.0.0.1:3000` while only `localhost` is allowlisted yields **403**
255242
on `POST /api/agent/session` (and other cookie-auth APIs).
256-
>>>>>>> 7dacaac (docs(agents): note Vite IPv4 bind and Spring CORS loopback hosts)
257243
- **Before running backend tests that boot the Spring context** (e.g. `ApiSmokeTest`), stop
258244
the running backend first — both use `ddl-auto=update` on the same `dba_agent` DB and can
259245
deadlock on an `ALTER TABLE`. Test env vars are documented in `CLAUDE.md` (Testing).

0 commit comments

Comments
 (0)