@agentuity/cli 1.0.59 → 2.0.0-beta.1

package/dist/utils/version-mismatch.js

@@ -0,0 +1,161 @@
+/**
+ * Version mismatch detection for @agentuity/* packages.
+ *
+ * Detects when a project uses outdated v1 SDK packages while the CLI is v2,
+ * and recommends running the migration tool.
+ */
+import { existsSync, readFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { getVersion } from '../version';
+/**
+ * Extract major version from semver string
+ */
+function extractMajor(version) {
+    // Handle ranges like ^1.0.0, ~2.0.0, >=1.0.0
+    const match = version.match(/(\d+)\.\d+\.\d+/);
+    if (match?.[1]) {
+        return parseInt(match[1], 10);
+    }
+    // Handle "latest" or "*"
+    if (version === 'latest' || version === '*') {
+        return 0; // Unknown major
+    }
+    return 0;
+}
+/**
+ * Get installed version from node_modules
+ */
+function getInstalledVersion(projectDir, packageName) {
+    try {
+        const pkgPath = join(projectDir, 'node_modules', packageName, 'package.json');
+        if (!existsSync(pkgPath)) {
+            return null;
+        }
+        const pkg = JSON.parse(readFileSync(pkgPath, 'utf-8'));
+        return pkg.version || null;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Detect version mismatches in @agentuity/* packages.
+ *
+ * @param projectDir - Root directory of the user's project
+ * @param logger - Logger instance
+ * @returns Version mismatch detection result
+ */
+export function detectVersionMismatch(projectDir, logger) {
+    const cliVersion = getVersion();
+    const cliMajor = extractMajor(cliVersion);
+    const result = {
+        cliMajor,
+        packages: [],
+        mismatched: [],
+        outdated: [],
+        hasV1Packages: false,
+        hasMajorMismatches: false,
+    };
+    // Skip check for canary versions
+    if (cliVersion.includes('-')) {
+        logger.debug('Skipping version mismatch check for canary version: %s', cliVersion);
+        return result;
+    }
+    // Read package.json
+    const packageJsonPath = join(projectDir, 'package.json');
+    if (!existsSync(packageJsonPath)) {
+        logger.debug('No package.json found, skipping version mismatch check');
+        return result;
+    }
+    let packageJson;
+    try {
+        packageJson = JSON.parse(readFileSync(packageJsonPath, 'utf-8'));
+    }
+    catch (error) {
+        logger.debug('Failed to read package.json: %s', error);
+        return result;
+    }
+    // Collect all @agentuity/* packages
+    const allDeps = {
+        ...packageJson.dependencies,
+        ...packageJson.devDependencies,
+    };
+    const agentuitPackages = Object.entries(allDeps)
+        .filter(([name]) => name.startsWith('@agentuity/'))
+        .map(([name, specifier]) => ({ name, specifier }));
+    if (agentuitPackages.length === 0) {
+        logger.debug('No @agentuity/* packages found in package.json');
+        return result;
+    }
+    // Check each package's installed version
+    for (const { name } of agentuitPackages) {
+        const installedVersion = getInstalledVersion(projectDir, name);
+        if (!installedVersion) {
+            logger.debug('%s: not installed, skipping', name);
+            continue;
+        }
+        const major = extractMajor(installedVersion);
+        const info = {
+            name,
+            version: installedVersion,
+            major,
+        };
+        result.packages.push(info);
+        // Check if this is a v1 package when CLI is v2+
+        if (major === 1 && cliMajor >= 2) {
+            result.outdated.push(info);
+            result.hasV1Packages = true;
+        }
+    }
+    // Check for major version mismatches across installed packages
+    if (result.packages.length > 1) {
+        const majors = new Set(result.packages.map((p) => p.major));
+        if (majors.size > 1) {
+            result.hasMajorMismatches = true;
+            // Find packages that don't match the most common major version
+            const majorCounts = new Map();
+            for (const pkg of result.packages) {
+                majorCounts.set(pkg.major, (majorCounts.get(pkg.major) || 0) + 1);
+            }
+            const mostCommonMajor = [...majorCounts.entries()].sort((a, b) => b[1] - a[1])[0]?.[0] || cliMajor;
+            for (const pkg of result.packages) {
+                if (pkg.major !== mostCommonMajor) {
+                    result.mismatched.push(pkg);
+                }
+            }
+        }
+    }
+    return result;
+}
+/**
+ * Format a warning message for version mismatches.
+ */
+export function formatVersionMismatchWarning(result) {
+    const lines = [];
+    if (result.hasV1Packages) {
+        lines.push('You are using Agentuity SDK v1 packages, but v2 is now available.');
+        lines.push('');
+        lines.push('  Outdated packages:');
+        for (const pkg of result.outdated) {
+            lines.push(`    • ${pkg.name}@${pkg.version}`);
+        }
+        lines.push('');
+        lines.push('  → Run `npx @agentuity/migrate` to upgrade your project to v2.');
+        lines.push('    This will automatically update your code and dependencies.');
+        lines.push('');
+        lines.push('  See the migration guide: https://docs.agentuity.com/migration/v1-to-v2');
+    }
+    else if (result.hasMajorMismatches) {
+        lines.push('Your project has mismatched major versions across @agentuity/* packages.');
+        lines.push('');
+        lines.push('  Packages:');
+        for (const pkg of result.packages) {
+            const marker = result.mismatched.includes(pkg) ? ' ⚠️' : '';
+            lines.push(`    • ${pkg.name}@${pkg.version} (v${pkg.major})${marker}`);
+        }
+        lines.push('');
+        lines.push('  → Run `bun install` to sync versions, or pin to the same major version.');
+    }
+    return lines.join('\n');
+}
+//# sourceMappingURL=version-mismatch.js.map

package/dist/utils/version-mismatch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version-mismatch.js","sourceRoot":"","sources":["../../src/utils/version-mismatch.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@agentuity/cli",
-	"version": "1.0.59",
+	"version": "2.0.0-beta.1",
 	"license": "Apache-2.0",
 	"author": "Agentuity employees and contributors",
 	"type": "module",
@@ -41,9 +41,9 @@
 		"prepublishOnly": "bun run clean && bun run build"
 	},
 	"dependencies": {
-		"@agentuity/auth": "1.0.59",
-		"@agentuity/core": "1.0.59",
-		"@agentuity/server": "1.0.59",
+		"@agentuity/auth": "2.0.0-beta.1",
+		"@agentuity/core": "2.0.0-beta.1",
+		"@agentuity/server": "2.0.0-beta.1",
 		"@datasert/cronjs-parser": "^1.4.0",
 		"@vitejs/plugin-react": "^5.1.2",
 		"acorn-loose": "^8.5.2",
@@ -59,10 +59,10 @@
 		"typescript": "^5.9.0",
 		"vite": "^7.2.7",
 		"zod": "^4.3.5",
-		"@agentuity/frontend": "1.0.59"
+		"@agentuity/frontend": "2.0.0-beta.1"
 	},
 	"devDependencies": {
-		"@agentuity/test-utils": "1.0.59",
+		"@agentuity/test-utils": "2.0.0-beta.1",
 		"@types/adm-zip": "^0.5.7",
 		"@types/bun": "latest",
 		"@types/tar-fs": "^2.0.4",

package/src/cmd/ai/prompt/agent.md

@@ -7,7 +7,6 @@ This folder contains AI agents for your Agentuity application. Each agent is org
 The `src/generated/` folder contains auto-generated TypeScript files:
 
 - `registry.ts` - Agent registry with strongly-typed agent definitions and schema types
-- `routes.ts` - Route registry for API, WebSocket, and SSE endpoints
 - `app.ts` - Application entry point (regenerated on every build)
 
 **Important:** Never edit files in `src/generated/` - they are overwritten on every build.

package/src/cmd/ai/prompt/api.md

@@ -6,18 +6,11 @@ This folder contains REST API routes for your Agentuity application. Each API is
 
 The `src/generated/` folder contains auto-generated TypeScript files:
 
-- `routes.ts` - Route registry with strongly-typed route definitions and schema types
 - `registry.ts` - Agent registry (for calling agents from routes)
 - `app.ts` - Application entry point (regenerated on every build)
 
 **Important:** Never edit files in `src/generated/` - they are overwritten on every build.
 
-Import generated types in your routes:
-
-```typescript
-import type { POST_Api_UsersInput, POST_Api_UsersOutput } from '../generated/routes';
-```
-
 ## Directory Structure
 
 Each API folder must contain:

package/src/cmd/ai/prompt/web.md

@@ -6,19 +6,17 @@ This folder contains your React-based web application that communicates with you
 
 The `src/generated/` folder contains auto-generated TypeScript files:
 
-- `routes.ts` - Route registry with type-safe API, WebSocket, and SSE route definitions
 - `registry.ts` - Agent registry with input/output types
 
 **Important:** Never edit files in `src/generated/` - they are overwritten on every build.
 
-Import generated types in your components:
+For type-safe API calls, use Hono's `hc()` client:
 
 ```typescript
-// Routes are typed automatically via module augmentation
-import { useAPI } from '@agentuity/react';
+import { hc } from 'hono/client';
+import type { AppType } from '../api/router';
 
-// The route 'GET /api/users' is fully typed
-const { data } = useAPI('GET /api/users');
+const client = hc<AppType>('/');
 ```
 
 ## Directory Structure
@@ -48,12 +46,25 @@ src/web/
 ### App.tsx - Main Component
 
 ```typescript
-import { AgentuityProvider, useAPI } from '@agentuity/react';
+import { AgentuityProvider } from '@agentuity/react';
+import { hc } from 'hono/client';
+import type { AppType } from '../api/router';
 import { useState } from 'react';
 
+const client = hc<AppType>('/');
+
 function HelloForm() {
 	const [name, setName] = useState('World');
-	const { invoke, isLoading, data: greeting } = useAPI('POST /api/hello');
+	const [greeting, setGreeting] = useState<string | null>(null);
+	const [isLoading, setIsLoading] = useState(false);
+
+	const handleSubmit = async () => {
+		setIsLoading(true);
+		const res = await client.api.hello.$post({ json: { name } });
+		const data = await res.json();
+		setGreeting(data.greeting);
+		setIsLoading(false);
+	};
 
 	return (
 		<div>
@@ -65,7 +76,7 @@ function HelloForm() {
 			/>
 
 			<button
-				onClick={() => invoke({ name })}
+				onClick={handleSubmit}
 				disabled={isLoading}
 			>
 				{isLoading ? 'Running...' : 'Say Hello'}
@@ -117,159 +128,30 @@ createRoot(root).render(<App />);
 </html>
 ```
 
-## React Hooks
-
-All hooks from `@agentuity/react` must be used within an `AgentuityProvider`. **Always use these hooks instead of raw `fetch()` calls** - they provide type safety, automatic error handling, and integration with the Agentuity platform.
-
-### useAPI - Type-Safe API Calls
-
-The primary hook for making HTTP requests. **Use this instead of `fetch()`.**
-
-```typescript
-import { useAPI } from '@agentuity/react';
-
-function MyComponent() {
-	// GET requests auto-execute and return refetch
-	const { data, isLoading, error, refetch } = useAPI('GET /api/users');
-
-	// POST/PUT/DELETE return invoke for manual execution
-	const { invoke, data: result, isLoading: saving } = useAPI('POST /api/users');
-
-	const handleCreate = async () => {
-		// Input is fully typed from route schema!
-		await invoke({ name: 'Alice', email: 'alice@example.com' });
-	};
-
-	return (
-		<div>
-			<button onClick={handleCreate} disabled={saving}>
-				{saving ? 'Creating...' : 'Create User'}
-			</button>
-			{result && <p>Created: {result.name}</p>}
-		</div>
-	);
-}
-```
-
-**useAPI Return Values:**
+## Type-Safe API Calls
 
-| Property     | Type                     | Description                               |
-| ------------ | ------------------------ | ----------------------------------------- |
-| `data`       | `T \| undefined`         | Response data (typed from route schema)   |
-| `error`      | `Error \| null`          | Error if request failed                   |
-| `isLoading`  | `boolean`                | True during initial load                  |
-| `isFetching` | `boolean`                | True during any fetch (including refetch) |
-| `isSuccess`  | `boolean`                | True if last request succeeded            |
-| `isError`    | `boolean`                | True if last request failed               |
-| `invoke`     | `(input?) => Promise<T>` | Manual trigger (POST/PUT/DELETE)          |
-| `refetch`    | `() => Promise<void>`    | Refetch data (GET)                        |
-| `reset`      | `() => void`             | Reset state to initial                    |
-
-### useAPI Options
+Use Hono's `hc()` client for type-safe API calls. The types are derived directly from your router.
 
 ```typescript
-// GET with query parameters and caching
-const { data } = useAPI({
-	route: 'GET /api/search',
-	query: { q: 'react', limit: '10' },
-	staleTime: 5000, // Cache for 5 seconds
-	refetchInterval: 10000, // Auto-refetch every 10 seconds
-	enabled: true, // Set to false to disable auto-fetch
-});
-
-// POST with callbacks
-const { invoke } = useAPI({
-	route: 'POST /api/users',
-	onSuccess: (data) => console.log('Created:', data),
-	onError: (error) => console.error('Failed:', error),
-});
-
-// Streaming responses with onChunk
-const { invoke } = useAPI({
-	route: 'POST /api/stream',
-	onChunk: (chunk) => console.log('Received chunk:', chunk),
-	delimiter: '\n', // Split stream by newlines (default)
-});
-
-// Custom headers
-const { data } = useAPI({
-	route: 'GET /api/protected',
-	headers: { 'X-Custom-Header': 'value' },
-});
-```
+import { hc } from 'hono/client';
+import type { AppType } from '../api/router';
 
-### useWebsocket - WebSocket Connection
+// Create a typed client
+const client = hc<AppType>('/');
 
-For bidirectional real-time communication. Automatically handles reconnection.
-
-```typescript
-import { useWebsocket } from '@agentuity/react';
+// All routes are fully typed
+const res = await client.api.users.$get();
+const users = await res.json();
 
-function ChatComponent() {
-	const { isConnected, data, send, messages, clearMessages, error, reset } = useWebsocket('/api/chat');
-
-	return (
-		<div>
-			<p>Status: {isConnected ? 'Connected' : 'Disconnected'}</p>
-			<button onClick={() => send({ message: 'Hello' })}>Send</button>
-			<div>
-				{messages.map((msg, i) => (
-					<p key={i}>{JSON.stringify(msg)}</p>
-				))}
-			</div>
-			<button onClick={clearMessages}>Clear</button>
-		</div>
-	);
-}
+const res2 = await client.api.users.$post({ json: { name: 'Alice', email: 'alice@example.com' } });
+const created = await res2.json();
 ```
 
-**useWebsocket Return Values:**
+For WebSocket and SSE, use the native browser APIs or `WebSocketManager`/`EventStreamManager` from `@agentuity/frontend`.
 
-| 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 (
-		<div>
-			<p>Connected: {isConnected ? 'Yes' : 'No'}</p>
-			{error && <p>Error: {error.message}</p>}
-			<p>Latest: {JSON.stringify(data)}</p>
-			<button onClick={close}>Disconnect</button>
-		</div>
-	);
-}
-```
-
-**useEventStream Return Values:**
+## React Hooks
 
-| 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            |
+`@agentuity/react` provides hooks for context, auth, WebRTC, and analytics. All hooks must be used within an `AgentuityProvider`.
 
 ### useAgentuity - Access Context
 
@@ -330,22 +212,21 @@ function AuthStatus() {
 ## Complete Example
 
 ```typescript
-import { AgentuityProvider, useAPI, useWebsocket } from '@agentuity/react';
-import { useEffect, useState } from 'react';
+import { AgentuityProvider } from '@agentuity/react';
+import { hc } from 'hono/client';
+import type { AppType } from '../api/router';
+import { useState } from 'react';
+
+const client = hc<AppType>('/');
 
 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]);
+	const [result, setResult] = useState<any>(null);
+
+	const handleProcess = async () => {
+		const res = await client.api.process.$post({ json: { name: 'Jeff', age: 30 } });
+		setResult(await res.json());
+	};
 
 	return (
 		<div style={{ fontFamily: 'sans-serif', padding: '2rem' }}>
@@ -359,15 +240,10 @@ function Dashboard() {
 			</div>
 
 			<div>
-				<button onClick={() => invoke({ name: 'Jeff', age: 30 })}>
+				<button onClick={handleProcess}>
 					Call API
 				</button>
-				<p>{JSON.stringify(agentResult)}</p>
-			</div>
-
-			<div>
-				<strong>WebSocket:</strong>
-				{isConnected ? JSON.stringify(wsMessage) : 'Not connected'}
+				<p>{JSON.stringify(result)}</p>
 			</div>
 		</div>
 	);
@@ -451,47 +327,10 @@ Import in `index.html`:
 </div>
 ```
 
-## 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
+- Wrap your app with **AgentuityProvider** for auth and context
+- Use **hc()** from `hono/client` for type-safe API calls
 - Use **useAuth** for authentication state management
 - Handle loading and error states in UI
 - Place reusable components in separate files
@@ -502,8 +341,7 @@ async function fetchData() {
 - **App.tsx** must export a function named `App`
 - **frontend.tsx** must render the `App` component to `#root`
 - **index.html** must have a `<div id="root"></div>`
-- Routes are typed via module augmentation from `src/generated/routes.ts`
+- Route types are derived from your Hono router via `hc<typeof router>()`
 - The web app is served at `/` by default
 - Static files in `public/` are served at `/public/*`
 - Module script tag: `<script type="module" src="/web/frontend.tsx"></script>`
-- **Never use raw `fetch()` calls** - always use `useAPI` or `createClient`