@fias/arche-sdk 1.1.7 → 1.1.8

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fias/arche-sdk",
-  "version": "1.1.7",
+  "version": "1.1.8",
   "description": "SDK for building FIAS platform plugin arches",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",

package/templates/default/AGENTS.md

@@ -253,29 +253,29 @@ These are hard limits enforced by the platform. Code that violates these will fa
 
 ## Development Workflow
 
-```bash
-# Terminal 1: Start plugin dev server (Vite, port 3100)
-npm run dev
-
-# Terminal 2: Start dev harness (mock mode, port 3200)
-npm run dev:mock
+### Step 1: Authenticate (one-time)
 
-# Open http://localhost:3200 in browser
+```bash
+npx fias-dev login           # Opens browser to sign in, saves API key automatically
 ```
 
-### Authenticating with the FIAS Platform
+### Step 2: Run the dev servers (two terminals)
 
 ```bash
-npx fias-dev login           # Opens browser to authenticate (recommended)
-npx fias-dev login --key fias_sk_...  # Or paste an API key directly
+# Terminal 1: Start plugin dev server (Vite, port 3100)
+npm run dev
+
+# Terminal 2: Start dev harness with real AI (port 3200, uses credits)
+npm run dev:harness
 ```
 
-Running `npx fias-dev login` opens your browser to the FIAS platform. After signing in, an API key is created automatically and saved to `~/.fias/credentials`. No manual key copying needed.
+Open http://localhost:3200 in your browser. Entity invocations will use real AI models and deduct credits.
 
-### Testing with Real AI Entities (costs credits)
+For offline development without credits (AI calls return canned responses):
 
 ```bash
-npm run dev:harness          # Start harness in live mode (requires login first)
+# Terminal 2 alternative: mock mode (no login needed, no credits)
+npm run dev:mock
 ```
 
 ### Browsing Available Entities

package/templates/default/CLAUDE.md

@@ -253,29 +253,29 @@ These are hard limits enforced by the platform. Code that violates these will fa
 
 ## Development Workflow
 
-```bash
-# Terminal 1: Start plugin dev server (Vite, port 3100)
-npm run dev
-
-# Terminal 2: Start dev harness (mock mode, port 3200)
-npm run dev:mock
+### Step 1: Authenticate (one-time)
 
-# Open http://localhost:3200 in browser
+```bash
+npx fias-dev login           # Opens browser to sign in, saves API key automatically
 ```
 
-### Authenticating with the FIAS Platform
+### Step 2: Run the dev servers (two terminals)
 
 ```bash
-npx fias-dev login           # Opens browser to authenticate (recommended)
-npx fias-dev login --key fias_sk_...  # Or paste an API key directly
+# Terminal 1: Start plugin dev server (Vite, port 3100)
+npm run dev
+
+# Terminal 2: Start dev harness with real AI (port 3200, uses credits)
+npm run dev:harness
 ```
 
-Running `npx fias-dev login` opens your browser to the FIAS platform. After signing in, an API key is created automatically and saved to `~/.fias/credentials`. No manual key copying needed.
+Open http://localhost:3200 in your browser. Entity invocations will use real AI models and deduct credits.
 
-### Testing with Real AI Entities (costs credits)
+For offline development without credits (AI calls return canned responses):
 
 ```bash
-npm run dev:harness          # Start harness in live mode (requires login first)
+# Terminal 2 alternative: mock mode (no login needed, no credits)
+npm run dev:mock
 ```
 
 ### Browsing Available Entities