-
- );
-}
-```
-
-**useWebsocket Return Values:**
-
-| Property | Type | Description |
-| --------------- | ---------------- | ---------------------------------------- |
-| `isConnected` | `boolean` | True when WebSocket is connected |
-| `data` | `T \| undefined` | Most recent message received |
-| `messages` | `T[]` | Array of all received messages |
-| `send` | `(data) => void` | Send a message (typed from route schema) |
-| `clearMessages` | `() => void` | Clear the messages array |
-| `close` | `() => void` | Close the connection |
-| `error` | `Error \| null` | Error if connection failed |
-| `isError` | `boolean` | True if there's an error |
-| `reset` | `() => void` | Reset state and reconnect |
-| `readyState` | `number` | WebSocket ready state |
-
-### useEventStream - Server-Sent Events
-
-For server-to-client streaming (one-way). Use when server pushes updates to client.
-
-```typescript
-import { useEventStream } from '@agentuity/react';
-
-function NotificationsComponent() {
- const { isConnected, data, error, close, reset } = useEventStream('/api/notifications');
-
- return (
- Status: {isConnected ? 'Connected' : 'Disconnected'}
- -
- {messages.map((msg, i) => (
-
-
- {JSON.stringify(msg)}
- ))} -
-
- );
-}
-```
-
-**useEventStream Return Values:**
-
-| Property | Type | Description |
-| ------------- | ---------------- | ---------------------------------- |
-| `isConnected` | `boolean` | True when EventSource is connected |
-| `data` | `T \| undefined` | Most recent event data |
-| `error` | `Error \| null` | Error if connection failed |
-| `isError` | `boolean` | True if there's an error |
-| `close` | `() => void` | Close the connection |
-| `reset` | `() => void` | Reset state and reconnect |
-| `readyState` | `number` | EventSource ready state |
-
-### useAgentuity - Access Context
-
-Access the Agentuity context for base URL and configuration.
-
-```typescript
-import { useAgentuity } from '@agentuity/react';
-
-function MyComponent() {
- const { baseUrl } = useAgentuity();
-
- return Connected: {isConnected ? 'Yes' : 'No'}
- {error &&Error: {error.message}
} -Latest: {JSON.stringify(data)}
- -API Base: {baseUrl}
; -} -``` - -### useAuth - Authentication State - -Access and manage authentication state. - -```typescript -import { useAuth } from '@agentuity/react'; - -function AuthStatus() { - const { isAuthenticated, authHeader, setAuthHeader, authLoading } = useAuth(); - - const handleLogin = async (token: string) => { - setAuthHeader?.(`Bearer ${token}`); - }; - - const handleLogout = () => { - setAuthHeader?.(null); - }; - - if (authLoading) returnLoading...
; - - return ( -
- {isAuthenticated ? (
-
- ) : (
-
- )}
-
- );
-}
-```
-
-**useAuth Return Values:**
-
-| Property | Type | Description |
-| ----------------- | ------------------- | ------------------------------------------- |
-| `isAuthenticated` | `boolean` | True if user has auth token and not loading |
-| `authHeader` | `string \| null` | Current auth header (e.g., "Bearer ...") |
-| `setAuthHeader` | `(token) => void` | Set auth header (null to clear) |
-| `authLoading` | `boolean` | True during auth state changes |
-| `setAuthLoading` | `(loading) => void` | Set auth loading state |
-
-## Complete Example
-
-```typescript
-import { AgentuityProvider, useAPI, useWebsocket } from '@agentuity/react';
-import { useEffect, useState } from 'react';
-
-function Dashboard() {
- const [count, setCount] = useState(0);
- const { invoke, data: agentResult } = useAPI('POST /api/process');
- const { isConnected, send, data: wsMessage } = useWebsocket('/api/live');
-
- useEffect(() => {
- if (isConnected) {
- const interval = setInterval(() => {
- send({ ping: Date.now() });
- }, 1000);
- return () => clearInterval(interval);
- }
- }, [isConnected, send]);
-
- return (
-
-
- );
-}
-
-export function App() {
- return (
- My Agentuity App
- -
-
-
- Count: {count}
- -
-
-
-
- {JSON.stringify(agentResult)}
-
- WebSocket:
- {isConnected ? JSON.stringify(wsMessage) : 'Not connected'}
-
- 
-```
-
-## Styling
-
-### Inline Styles
-
-```typescript
-
- Styled content
-
-```
-
-### CSS Files
-
-Create `public/styles.css`:
-
-```css
-body {
- background-color: #09090b;
- color: #fff;
- font-family: sans-serif;
-}
-```
-
-Import in `index.html`:
-
-```html
-
-```
-
-### Style Tag in Component
-
-```typescript
-
-
-
-
-```
-
-## RPC-Style API Client
-
-For non-React contexts (like utility functions or event handlers), use `createClient`:
-
-```typescript
-import { createClient } from '@agentuity/react';
-
-// Create a typed client (uses global baseUrl and auth from AgentuityProvider)
-const api = createClient();
-
-// Type-safe RPC-style calls - routes become nested objects
-// Route 'GET /api/users' becomes api.users.get()
-// Route 'POST /api/users' becomes api.users.post()
-// Route 'GET /api/users/:id' becomes api.users.id.get({ id: '123' })
-
-async function fetchData() {
- const users = await api.users.get();
- const newUser = await api.users.post({ name: 'Alice', email: 'alice@example.com' });
- const user = await api.users.id.get({ id: '123' });
- return { users, newUser, user };
-}
-```
-
-**When to use `createClient` vs `useAPI`:**
-
-| Use Case | Recommendation |
-| ------------------------- | -------------- |
-| React component rendering | `useAPI` hook |
-| Event handlers | Either works |
-| Utility functions | `createClient` |
-| Non-React code | `createClient` |
-| Need loading/error state | `useAPI` hook |
-| Need caching/refetch | `useAPI` hook |
-
-## Best Practices
-
-- Wrap your app with **AgentuityProvider** for hooks to work
-- **Always use `useAPI` instead of `fetch()`** for type safety and error handling
-- Use **useAPI** for type-safe HTTP requests (GET, POST, PUT, DELETE)
-- Use **useWebsocket** for bidirectional real-time communication
-- Use **useEventStream** for server-to-client streaming
-- Use **useAuth** for authentication state management
-- Handle loading and error states in UI
-- Place reusable components in separate files
-- Keep static assets in the **public/** folder
-
-## Rules
-
-- **App.tsx** must export a function named `App`
-- **frontend.tsx** must render the `App` component to `#root`
-- **index.html** must have a ``
-- Routes are typed via module augmentation from `src/generated/routes.ts`
-- The web app is served at `/` by default
-- Static files in `public/` are served at `/public/*`
-- Module script tag: ``
-- **Never use raw `fetch()` calls** - always use `useAPI` or `createClient`
-
-
diff --git a/apps/testing/auth-package-app/.gitignore b/apps/testing/auth-package-app/.gitignore
deleted file mode 100644
index a1609616b..000000000
--- a/apps/testing/auth-package-app/.gitignore
+++ /dev/null
@@ -1,42 +0,0 @@
-# Agentuity build files
-.agentuity/
-
-# Dependencies
-node_modules/
-
-# Environment files
-.env
-.env.local
-.env.*
-
-# Auto-generated AGENTS.md files in source directories
-src/web/AGENTS.md
-src/api/AGENTS.md
-src/agent/AGENTS.md
-
-# Output
-out
-dist
-*.tgz
-
-# Code coverage
-coverage
-*.lcov
-
-# Logs
-/logs
-*.log
-
-# Caches
-.eslintcache
-.cache
-*.tsbuildinfo
-
-# IDE
-.idea
-.DS_Store
-
-# Auth test artifacts
-cookies.txt
-dev.db
-*.db
diff --git a/apps/testing/auth-package-app/AGENTS.md b/apps/testing/auth-package-app/AGENTS.md
deleted file mode 100644
index b923811a0..000000000
--- a/apps/testing/auth-package-app/AGENTS.md
+++ /dev/null
@@ -1,64 +0,0 @@
-# Agent Guidelines for ag-auth-test-app
-
-## Commands
-
-- **Build**: `bun run build` (compiles your application)
-- **Dev**: `bun run dev` (starts development server)
-- **Typecheck**: `bun run typecheck` (runs TypeScript type checking)
-- **Deploy**: `bun run deploy` (deploys your app to the Agentuity cloud)
-
-## Agent-Friendly CLI
-
-The Agentuity CLI is designed to be agent-friendly with programmatic interfaces, structured output, and comprehensive introspection.
-
-Read the [AGENTS.md](./node_modules/@agentuity/cli/AGENTS.md) file in the Agentuity CLI for more information on how to work with this project.
-
-## Instructions
-
-- This project uses Bun instead of NodeJS and TypeScript for all source code
-- This is an Agentuity Agent project
-
-## Web Frontend (src/web/)
-
-The `src/web/` folder contains your React frontend, which is automatically bundled by the Agentuity build system.
-
-**File Structure:**
-
-- `index.html` - Main HTML file with `
-
-
-
-
-