@agentuity/cli 3.0.0-beta.0 → 3.0.0-beta.2

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

@@ -1,358 +0,0 @@
-# APIs Folder Guide
-
-This folder contains REST API routes for your Agentuity application. Each API is organized in its own subdirectory.
-
-## Generated Types
-
-The `src/generated/` folder contains auto-generated TypeScript files:
-
-- `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.
-
-## Directory Structure
-
-Each API folder must contain:
-
-- **route.ts** (required) - HTTP route definitions using Hono router
-
-Example structure:
-
-```
-src/api/
-├── index.ts         (optional, mounted at /api)
-├── status/
-│   └── route.ts     (mounted at /api/status)
-├── users/
-│   └── route.ts     (mounted at /api/users)
-├── agent-call/
-    └── route.ts     (mounted at /api/agent-call)
-```
-
-## Creating an API
-
-### Basic API (route.ts)
-
-```typescript
-import { createRouter } from '@agentuity/runtime';
-
-const router = createRouter();
-
-// GET /api/status
-router.get('/', (c) => {
-	return c.json({
-		status: 'ok',
-		timestamp: new Date().toISOString(),
-		version: '1.0.0',
-	});
-});
-
-// POST /api/status
-router.post('/', async (c) => {
-	const body = await c.req.json();
-	return c.json({ received: body });
-});
-
-export default router;
-```
-
-### API with Request Validation
-
-```typescript
-import { createRouter } from '@agentuity/runtime';
-import { s } from '@agentuity/schema';
-import { validator } from 'hono/validator';
-
-const router = createRouter();
-
-const createUserSchema = s.object({
-	name: s.string(),
-	email: s.string(),
-	age: s.number(),
-});
-
-router.post(
-	'/',
-	validator('json', (value, c) => {
-		const result = createUserSchema['~standard'].validate(value);
-		if (result.issues) {
-			return c.json({ error: 'Validation failed', issues: result.issues }, 400);
-		}
-		return result.value;
-	}),
-	async (c) => {
-		const data = c.req.valid('json');
-		// data is fully typed: { name: string, email: string, age: number }
-		return c.json({
-			success: true,
-			user: data,
-		});
-	}
-);
-
-export default router;
-```
-
-### API Calling Agents
-
-APIs can call agents directly by importing them:
-
-```typescript
-import { createRouter } from '@agentuity/runtime';
-import helloAgent from '@agent/hello';
-
-const router = createRouter();
-
-router.get('/', async (c) => {
-	// Call an agent directly
-	const result = await helloAgent.run({ name: 'API Caller', age: 42 });
-
-	return c.json({
-		success: true,
-		agentResult: result,
-	});
-});
-
-router.post('/with-input', async (c) => {
-	const body = await c.req.json();
-	const { name, age } = body;
-
-	// Call agent with dynamic input
-	const result = await helloAgent.run({ name, age });
-
-	return c.json({
-		success: true,
-		agentResult: result,
-	});
-});
-
-export default router;
-```
-
-### API with Agent Validation
-
-Use `agent.validator()` for automatic input validation from agent schemas:
-
-```typescript
-import { createRouter } from '@agentuity/runtime';
-import myAgent from '@agent/my-agent';
-
-const router = createRouter();
-
-// POST with automatic validation using agent's input schema
-router.post('/', myAgent.validator(), async (c) => {
-	const data = c.req.valid('json'); // Fully typed from agent schema!
-	const result = await myAgent.run(data);
-	return c.json({ success: true, result });
-});
-
-export default router;
-```
-
-### API with Logging
-
-```typescript
-import { createRouter } from '@agentuity/runtime';
-
-const router = createRouter();
-
-router.get('/log-test', (c) => {
-	c.var.logger.info('Info message');
-	c.var.logger.error('Error message');
-	c.var.logger.warn('Warning message');
-	c.var.logger.debug('Debug message');
-	c.var.logger.trace('Trace message');
-
-	return c.text('Check logs');
-});
-
-export default router;
-```
-
-## Route Context (c)
-
-The route handler receives a Hono context object with:
-
-- **c.req** - Request object (c.req.json(), c.req.param(), c.req.query(), etc.)
-- **c.json()** - Return JSON response
-- **c.text()** - Return text response
-- **c.html()** - Return HTML response
-- **c.redirect()** - Redirect to URL
-- **c.var.logger** - Structured logger (info, warn, error, debug, trace)
-- **c.var.kv** - Key-value storage
-- **c.var.vector** - Vector storage
-- **c.var.stream** - Stream management
-- **Import agents directly** - Import and call agents directly (recommended)
-
-## HTTP Methods
-
-```typescript
-const router = createRouter();
-
-router.get('/path', (c) => {
-	/* ... */
-});
-router.post('/path', (c) => {
-	/* ... */
-});
-router.put('/path', (c) => {
-	/* ... */
-});
-router.patch('/path', (c) => {
-	/* ... */
-});
-router.delete('/path', (c) => {
-	/* ... */
-});
-router.options('/path', (c) => {
-	/* ... */
-});
-```
-
-## Path Parameters
-
-```typescript
-// GET /api/users/:id
-router.get('/:id', (c) => {
-	const id = c.req.param('id');
-	return c.json({ userId: id });
-});
-
-// GET /api/posts/:postId/comments/:commentId
-router.get('/:postId/comments/:commentId', (c) => {
-	const postId = c.req.param('postId');
-	const commentId = c.req.param('commentId');
-	return c.json({ postId, commentId });
-});
-```
-
-## Query Parameters
-
-```typescript
-// GET /api/search?q=hello&limit=10
-router.get('/search', (c) => {
-	const query = c.req.query('q');
-	const limit = c.req.query('limit') || '20';
-	return c.json({ query, limit: parseInt(limit) });
-});
-```
-
-## Request Body
-
-```typescript
-// JSON body
-router.post('/', async (c) => {
-	const body = await c.req.json();
-	return c.json({ received: body });
-});
-
-// Form data
-router.post('/upload', async (c) => {
-	const formData = await c.req.formData();
-	const file = formData.get('file');
-	return c.json({ fileName: file?.name });
-});
-```
-
-## Error Handling
-
-```typescript
-import myAgent from '@agent/my-agent';
-
-router.get('/', async (c) => {
-	try {
-		const result = await myAgent.run({ data: 'test' });
-		return c.json({ success: true, result });
-	} catch (error) {
-		c.var.logger.error('Agent call failed:', error);
-		return c.json(
-			{
-				success: false,
-				error: error instanceof Error ? error.message : String(error),
-			},
-			500
-		);
-	}
-});
-```
-
-## Response Types
-
-```typescript
-// JSON response
-return c.json({ data: 'value' });
-
-// Text response
-return c.text('Hello World');
-
-// HTML response
-return c.html('<h1>Hello</h1>');
-
-// Custom status code
-return c.json({ error: 'Not found' }, 404);
-
-// Redirect
-return c.redirect('/new-path');
-
-// Headers
-return c.json({ data: 'value' }, 200, {
-	'X-Custom-Header': 'value',
-});
-```
-
-## Streaming Routes
-
-```typescript
-import { createRouter, stream, sse, websocket } from '@agentuity/runtime';
-
-const router = createRouter();
-
-// Stream response (use with POST)
-router.post(
-	'/events',
-	stream((c) => {
-		return new ReadableStream({
-			start(controller) {
-				controller.enqueue('event 1\n');
-				controller.enqueue('event 2\n');
-				controller.close();
-			},
-		});
-	})
-);
-
-// Server-Sent Events (use with GET)
-router.get(
-	'/notifications',
-	sse((c, stream) => {
-		stream.writeSSE({ data: 'Hello', event: 'message' });
-		stream.writeSSE({ data: 'World', event: 'message' });
-	})
-);
-
-// WebSocket (use with GET)
-router.get(
-	'/ws',
-	websocket((c, ws) => {
-		ws.onOpen(() => {
-			ws.send('Connected!');
-		});
-		ws.onMessage((event) => {
-			ws.send(`Echo: ${event.data}`);
-		});
-	})
-);
-
-export default router;
-```
-
-## Rules
-
-- Each API folder name becomes the route name (e.g., `status/` → `/api/status`)
-- **route.ts** must export default the router instance
-- Use c.var.logger for logging, not console.log
-- Import agents directly to call them (e.g., `import agent from '@agent/name'`)
-- Validation should use @agentuity/schema or agent.validator() for type safety
-- Return appropriate HTTP status codes
-- APIs run at `/api/{folderName}` by default

package/dist/cmd/ai/prompt/version.d.ts

@@ -1,36 +0,0 @@
-/**
- * Prompt file versioning utilities.
- *
- * Hash format at end of file: <!-- prompt_hash: [hash] -->
- *
- * - hash: SHA256 of file content (excluding the hash line)
- *
- * This allows detecting if the source template has changed.
- */
-/**
- * Compute SHA256 hash of content.
- */
-export declare function computeHash(content: string): string;
-/**
- * Strip the hash comment from content.
- */
-export declare function stripHashComment(content: string): string;
-/**
- * Extract hash from file content.
- * Returns null if no hash comment found.
- */
-export declare function extractHash(content: string): string | null;
-/**
- * Generate content with hash comment appended.
- * Ensures the output ends with a newline for POSIX compliance and Prettier compatibility.
- */
-export declare function appendHashComment(content: string): string;
-/**
- * Check if a file needs to be updated based on hash comparison.
- *
- * @param fileContent - Current file content (with hash comment)
- * @param sourceContent - Source template content (without hash comment)
- * @returns true if file needs to be updated (hashes differ)
- */
-export declare function needsUpdate(fileContent: string, sourceContent: string): boolean;
-//# sourceMappingURL=version.d.ts.map

package/dist/cmd/ai/prompt/version.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../../../../src/cmd/ai/prompt/version.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAMH;;GAEG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAEnD;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAExD;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAG1D;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAGzD;AAED;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,WAAW,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,GAAG,OAAO,CAQ/E"}

package/dist/cmd/ai/prompt/version.js

@@ -1,55 +0,0 @@
-/**
- * Prompt file versioning utilities.
- *
- * Hash format at end of file: <!-- prompt_hash: [hash] -->
- *
- * - hash: SHA256 of file content (excluding the hash line)
- *
- * This allows detecting if the source template has changed.
- */
-import { createHash } from 'node:crypto';
-const HASH_REGEX = /\n?<!-- prompt_hash: ([a-f0-9]+) -->\n?$/;
-/**
- * Compute SHA256 hash of content.
- */
-export function computeHash(content) {
-    return createHash('sha256').update(content).digest('hex');
-}
-/**
- * Strip the hash comment from content.
- */
-export function stripHashComment(content) {
-    return content.replace(HASH_REGEX, '');
-}
-/**
- * Extract hash from file content.
- * Returns null if no hash comment found.
- */
-export function extractHash(content) {
-    const match = content.match(HASH_REGEX);
-    return match?.[1] ?? null;
-}
-/**
- * Generate content with hash comment appended.
- * Ensures the output ends with a newline for POSIX compliance and Prettier compatibility.
- */
-export function appendHashComment(content) {
-    const hash = computeHash(content);
-    return `${content}\n<!-- prompt_hash: ${hash} -->\n`;
-}
-/**
- * Check if a file needs to be updated based on hash comparison.
- *
- * @param fileContent - Current file content (with hash comment)
- * @param sourceContent - Source template content (without hash comment)
- * @returns true if file needs to be updated (hashes differ)
- */
-export function needsUpdate(fileContent, sourceContent) {
-    const fileHash = extractHash(fileContent);
-    if (!fileHash) {
-        return true;
-    }
-    const sourceHash = computeHash(sourceContent);
-    return fileHash !== sourceHash;
-}
-//# sourceMappingURL=version.js.map

package/dist/cmd/ai/prompt/version.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"version.js","sourceRoot":"","sources":["../../../../src/cmd/ai/prompt/version.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC,MAAM,UAAU,GAAG,0CAA0C,CAAC;AAE9D;;GAEG;AACH,MAAM,UAAU,WAAW,CAAC,OAAe;IAC1C,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAC3D,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAAC,OAAe;IAC/C,OAAO,OAAO,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;AACxC,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,WAAW,CAAC,OAAe;IAC1C,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;IACxC,OAAO,KAAK,EAAE,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC;AAC3B,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,iBAAiB,CAAC,OAAe;IAChD,MAAM,IAAI,GAAG,WAAW,CAAC,OAAO,CAAC,CAAC;IAClC,OAAO,GAAG,OAAO,uBAAuB,IAAI,QAAQ,CAAC;AACtD,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,WAAW,CAAC,WAAmB,EAAE,aAAqB;IACrE,MAAM,QAAQ,GAAG,WAAW,CAAC,WAAW,CAAC,CAAC;IAC1C,IAAI,CAAC,QAAQ,EAAE,CAAC;QACf,OAAO,IAAI,CAAC;IACb,CAAC;IAED,MAAM,UAAU,GAAG,WAAW,CAAC,aAAa,CAAC,CAAC;IAC9C,OAAO,QAAQ,KAAK,UAAU,CAAC;AAChC,CAAC"}

package/dist/cmd/ai/prompt/web.d.ts

@@ -1,10 +0,0 @@
-export declare const webSubcommand: import("../../../types.ts").SubcommandDefinition;
-/**
- * Get the raw prompt content without hash.
- */
-export declare function getPromptContent(): string;
-/**
- * Generate the web prompt with hash comment.
- */
-export declare function generateLLMPrompt(): string;
-//# sourceMappingURL=web.d.ts.map

package/dist/cmd/ai/prompt/web.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"web.d.ts","sourceRoot":"","sources":["../../../../src/cmd/ai/prompt/web.ts"],"names":[],"mappings":"AAiBA,eAAO,MAAM,aAAa,kDAUxB,CAAC;AAEH;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,MAAM,CAEzC;AAED;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,MAAM,CAE1C"}

package/dist/cmd/ai/prompt/web.js

@@ -1,35 +0,0 @@
-import { readFileSync } from 'node:fs';
-import { dirname, join } from 'node:path';
-import { fileURLToPath } from 'node:url';
-import { getCommand } from "../../../command-prefix.js";
-import { createSubcommand } from "../../../types.js";
-import { appendHashComment } from "./version.js";
-// Read the markdown prompt at module load. Both Bun and Node 24 support
-// this synchronous I/O at top-level. Bun also supports
-// `import x from './file.md' with { type: 'text' }` natively, but Node
-// does not yet, so we use the portable pattern here.
-const webPromptContent = readFileSync(join(dirname(fileURLToPath(import.meta.url)), 'web.md'), 'utf-8');
-export const webSubcommand = createSubcommand({
-    name: 'web',
-    description: 'Generate a comprehensive prompt for LLM agents for the web folder',
-    tags: ['read-only', 'fast'],
-    idempotent: true,
-    examples: [{ command: getCommand('prompt web'), description: 'Run web command' }],
-    async handler(_ctx) {
-        const prompt = generateLLMPrompt();
-        console.log(prompt);
-    },
-});
-/**
- * Get the raw prompt content without hash.
- */
-export function getPromptContent() {
-    return webPromptContent;
-}
-/**
- * Generate the web prompt with hash comment.
- */
-export function generateLLMPrompt() {
-    return appendHashComment(webPromptContent);
-}
-//# sourceMappingURL=web.js.map

package/dist/cmd/ai/prompt/web.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"web.js","sourceRoot":"","sources":["../../../../src/cmd/ai/prompt/web.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AAExD,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAEjD,wEAAwE;AACxE,uDAAuD;AACvD,uEAAuE;AACvE,qDAAqD;AACrD,MAAM,gBAAgB,GAAG,YAAY,CACpC,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,QAAQ,CAAC,EACvD,OAAO,CACP,CAAC;AAEF,MAAM,CAAC,MAAM,aAAa,GAAG,gBAAgB,CAAC;IAC7C,IAAI,EAAE,KAAK;IACX,WAAW,EAAE,mEAAmE;IAChF,IAAI,EAAE,CAAC,WAAW,EAAE,MAAM,CAAC;IAC3B,UAAU,EAAE,IAAI;IAChB,QAAQ,EAAE,CAAC,EAAE,OAAO,EAAE,UAAU,CAAC,YAAY,CAAC,EAAE,WAAW,EAAE,iBAAiB,EAAE,CAAC;IACjF,KAAK,CAAC,OAAO,CAAC,IAAoB;QACjC,MAAM,MAAM,GAAG,iBAAiB,EAAE,CAAC;QACnC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IACrB,CAAC;CACD,CAAC,CAAC;AAEH;;GAEG;AACH,MAAM,UAAU,gBAAgB;IAC/B,OAAO,gBAAgB,CAAC;AACzB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,iBAAiB;IAChC,OAAO,iBAAiB,CAAC,gBAAgB,CAAC,CAAC;AAC5C,CAAC"}