apex-dev 3.0.1 → 3.0.2

package/AGENTS.md

@@ -1,32 +1,28 @@
-# AGENTS.md — Project-Wide AI Agent Guidelines
-
-## Sub-Agent Prompt Rules
-
-When the main AI delegates work to any sub-agent (FilePickerMax, CodeReviewer, or any future sub-agent):
-
-1. **Always specify the exact type of files or scope needed.** Never send generic or vague prompts like "give me an overview of the codebase" or "review everything."
-2. **Be concrete and targeted.** Good examples:
-   - "Show me the main entry point and routing files"
-   - "Files that handle user authentication"
-   - "All React components related to the dashboard"
-   - "Review the changes to the session management logic in config.js"
-3. **Bad examples (never do this):**
-   - "Give me an overview of the codebase"
-   - "Show me all the files"
-   - "Review the code"
-   - "Find relevant files"
-
-## FilePickerMax
-
-- The `prompt` argument must describe the specific type of files to find.
-- If the caller cannot determine what specific files are needed, it should break the task down first before calling FilePickerMax.
-
-## CodeReviewer
-
-- The `prompt` argument must describe what was changed and why.
-- Always scope the review to the specific files and changes made — never ask for a blanket review.
-
-## General
-
-- Sub-agents should reject or return empty results for vague/generic prompts rather than guessing.
-- The main AI is responsible for formulating precise, scoped prompts before delegating to any sub-agent.
+# AGENTS.md — Apex Dev
+
+## Build & Run
+- Runtime: **Bun** (not Node). Start: `bun index.jsx`. Install deps: `bun install`.
+- No test suite configured yet (`npm test` is a no-op stub).
+
+## Architecture
+- **Terminal TUI app** built with React 19 + `@opentui/core`/`@opentui/react` for rendering.
+- Entry: `index.jsx` → `src/app.jsx` (main App component).
+- `src/agent.js` — Agentic loop: streams OpenAI-compatible completions from NVIDIA API, handles tool calls iteratively (max 50 iterations).
+- `src/config.js` — All model names, API client (`nvidiaClient`), session state, system prompts, and shared utils. Uses CommonJS (`require`/`module.exports`).
+- `src/tools.js` / `src/toolExecutors.js` — Tool definitions and execution (Read, Write, Edit, Bash, Grep, Glob, etc.).
+- `src/store.js` — Minimal pub/sub state store (messages, streaming state) with `getSnapshot`/`subscribe`/`setState`.
+- `src/components/` — React JSX components (ChatArea, InputBar, Header, StatusBar, etc.).
+- `src/hooks/` — Custom hooks (`useStore`, `useLayout`).
+- `src/commands.js` — Slash command handler. `src/prompt.js` — System prompt builder. `src/thinking.js` — `<think>` block parser.
+
+## Versioning
+- For every change, update the CLI version in `package.json` accordingly.
+
+## Code Style
+- Mixed module systems: `index.jsx` and `src/app.jsx` use **ESM** (`import`/`export`); all other `src/*.js` files use **CommonJS** (`require`/`module.exports`). Follow whichever the file already uses.
+- Components are `.jsx` files with PascalCase names; logic modules are `.js` with camelCase names.
+- No TypeScript — all files are plain JS/JSX (`strict: false` in tsconfig).
+- Use `'use strict';` at top of CommonJS files. No semicolon-free style — semicolons required.
+- Favor `const`; use `let` only when reassignment is needed. Arrow functions for callbacks.
+- Error handling: try/catch around API calls with retry logic (exponential backoff). Tool errors return strings starting with `"Error"`.
+- Env var: `NVIDIA_API_KEY` (required), `EXA_API_KEY` (optional, for web search).

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "apex-dev",
-  "version": "3.0.1",
+  "version": "3.0.2",
   "description": "Apex AI - a friendly agentic coding assistant for the terminal",
   "main": "index.jsx",
   "bin": {
@@ -13,9 +13,6 @@
   "keywords": [],
   "author": "",
   "license": "ISC",
-  "peerDependencies": {
-    "react": ">=19.0.0"
-  },
   "dependencies": {
     "@opentui/core": "^0.1.83",
     "@opentui/react": "^0.1.83",