create-agentuity 0.0.10 → 0.0.12

package/README.md

@@ -1,6 +1,18 @@
 # {{PROJECT_NAME}}
 
-A new Agentuity project created with `create-agentuity`.
+# create-agentuity
+
+Create a new Agentuity project with one command.
+
+## Usage
+
+```bash
+bun create agentuity my-project
+cd my-project
+bun run dev
+```
+
+Templates are automatically downloaded from the latest version in the GitHub repository.
 
 ## What You Get
 
@@ -27,7 +39,6 @@ my-app/
 │   └── web/             # React web application
 │       └── app.tsx      # Main React component
 ├── app.ts               # Application entry point
-├── setup.ts             # Initial setup script
 ├── tsconfig.json        # TypeScript configuration
 ├── package.json         # Dependencies and scripts
 └── README.md            # Project documentation

package/bin.js

@@ -0,0 +1,6 @@
+#!/usr/bin/env node
+import { spawnSync } from 'node:child_process';
+
+const args = process.argv.slice(2);
+const result = spawnSync('bunx', ['@agentuity/cli', 'create', ...args], { stdio: 'inherit' });
+process.exit(result.status || 0);

package/package.json

@@ -1,22 +1,17 @@
 {
 	"name": "create-agentuity",
-	"version": "0.0.10",
-	"module": "index.ts",
+	"version": "0.0.12",
+	"description": "Create a new Agentuity project",
 	"type": "module",
-	"files": [
-		"src",
-		"app.ts",
-		"AGENTS.md",
-		"tsconfig.json",
-		".gitignore",
-		"README.md",
-		"setup.ts"
-	],
+	"bin": {
+		"create-agentuity": "./bin.js"
+	},
 	"scripts": {
-		"build": "agentuity bundle --dir .",
-		"dev": "agentuity dev --dir .",
-		"typecheck": "bunx tsc --noEmit"
+		"build": "echo 'No build required'"
 	},
+	"files": [
+		"bin.js"
+	],
 	"keywords": [
 		"agentuity",
 		"create",
@@ -27,29 +22,7 @@
 	"author": "Agentuity",
 	"license": "MIT",
 	"dependencies": {
-		"@agentuity/cli": "0.0.9",
-		"@agentuity/core": "0.0.9",
-		"@agentuity/react": "0.0.9",
-		"@agentuity/runtime": "0.0.9",
-		"@hono/zod-validator": "^0.7.4",
-		"enquirer": "^2.4.1",
-		"hono": "^4.7.10",
-		"react": "^19.2.0",
-		"react-dom": "^19.2.0",
-		"zod": "^4.1.12"
-	},
-	"bun-create": {
-		"postinstall": [
-			"./setup.ts"
-		],
-		"start": "bun run dev"
-	},
-	"devDependencies": {
-		"@types/bun": "latest",
-		"@types/react": "^19.0.0"
-	},
-	"peerDependencies": {
-		"typescript": "^5"
+		"@agentuity/cli": "latest"
 	},
 	"publishConfig": {
 		"access": "public"

package/.gitignore

@@ -1,39 +0,0 @@
-# dependencies (bun install)
-node_modules
-
-# output
-out
-dist
-*.tgz
-
-# code coverage
-coverage
-*.lcov
-
-# logs
-logs
-*.log
-report.[0-9]*.[0-9]*.[0-9]*.[0-9]*.json
-
-# dotenv environment variable files
-.env
-.env.development.local
-.env.test.local
-.env.production.local
-.env.local
-.env.template
-
-# caches
-.eslintcache
-.cache
-*.tsbuildinfo
-
-# IntelliJ based IDEs
-.idea
-
-# Finder (MacOS) folder config
-.DS_Store
-
-# Agentuity build files
-.agentuity
-**/*.generated.*

package/AGENTS.md

@@ -1,200 +0,0 @@
-# Agent Guidelines for {{PROJECT_NAME}}
-
-## Commands
-
-- **Build**: `bun run build` (compiles your application)
-- **Dev**: `bun run dev` (starts development server)
-- **Typecheck**: `bun run typecheck` (runs TypeScript type checking)
-
-## Architecture
-
-- **Runtime**: Bun server runtime
-- **Framework**: Hono (lightweight web framework)
-- **Build tool**: `@agentuity/cli` compiles to `.agentuity/` directory
-- **Frontend**: React with `@agentuity/react` hooks
-
-## Project Structure
-
-```
-{{PROJECT_NAME}}/
-├── src/
-│   ├── agents/          # Agent definitions
-│   │   └── hello/       # Example "hello" agent
-│   │       ├── agent.ts # Agent handler
-│   │       └── route.ts # Agent HTTP routes
-│   ├── apis/            # Custom API routes
-│   │   └── status/      # Example status endpoint
-│   └── web/             # React web application
-│       └── app.tsx      # Main React component
-├── app.ts               # Application entry point
-├── tsconfig.json        # TypeScript configuration
-└── package.json         # Dependencies and scripts
-```
-
-## Code Style
-
-- **TypeScript-first** - All code is TypeScript
-- **Async/await** - All agent handlers are async
-- **Zod schemas** - Use Zod for input/output validation
-- **Functional** - Prefer functional patterns over classes
-- **Type-safe** - Leverage TypeScript generics and inference
-
-## Creating Agents
-
-### Agent Structure
-
-Each agent should be in its own folder under `src/agents/`:
-
-```typescript
-// src/agents/my-agent/agent.ts
-import { type AgentContext, createAgent } from '@agentuity/runtime';
-import { z } from 'zod';
-
-const agent = createAgent({
-	schema: {
-		input: z.object({
-			message: z.string(),
-		}),
-		output: z.object({
-			response: z.string(),
-		}),
-	},
-	handler: async (ctx: AgentContext, input) => {
-		// Use ctx.logger for logging (not console.log)
-		ctx.logger.info('Processing message:', input.message);
-
-		// Access storage
-		await ctx.kv.set('last-message', input.message);
-
-		return { response: `Processed: ${input.message}` };
-	},
-});
-
-export default agent;
-```
-
-### Agent Routes (Optional)
-
-Add custom HTTP routes for your agent:
-
-```typescript
-// src/agents/my-agent/route.ts
-import { createRouter } from '@agentuity/runtime';
-import { zValidator } from '@hono/zod-validator';
-import agent from './agent';
-
-const router = createRouter();
-
-// GET endpoint
-router.get('/', async (c) => {
-	const result = await c.agent['my-agent'].run({ message: 'Hello!' });
-	return c.json(result);
-});
-
-// POST endpoint with validation
-router.post('/', zValidator('json', agent.inputSchema!), async (c) => {
-	const data = c.req.valid('json');
-	const result = await c.agent['my-agent'].run(data);
-	return c.json(result);
-});
-
-export default router;
-```
-
-## Agent Context API
-
-Every agent handler receives an `AgentContext` with:
-
-- `ctx.logger` - Structured logger (use instead of console.log)
-- `ctx.tracer` - OpenTelemetry tracer for distributed tracing
-- `ctx.sessionId` - Unique session identifier
-- `ctx.kv` - Key-value storage interface
-- `ctx.objectstore` - Object/blob storage
-- `ctx.stream` - Stream storage
-- `ctx.vector` - Vector embeddings storage
-- `ctx.agent` - Access to other agents
-- `ctx.waitUntil()` - Defer cleanup tasks
-
-## Adding API Routes
-
-Create custom routes in `src/apis/`:
-
-```typescript
-// src/apis/my-route/route.ts
-import { createRouter } from '@agentuity/runtime';
-
-const router = createRouter();
-
-router.get('/', (c) => {
-	return c.json({ status: 'ok' });
-});
-
-export default router;
-```
-
-## Frontend Development
-
-Use `@agentuity/react` hooks to call agents from your React components:
-
-```typescript
-// src/web/app.tsx
-import { useAgent } from '@agentuity/react';
-
-function MyComponent() {
-  const { data, run } = useAgent('hello');
-
-  const handleClick = async () => {
-    const result = await run({ name: 'World' });
-    console.log(result);
-  };
-
-  return (
-    <div>
-      <button onClick={handleClick}>Call Agent</button>
-      {data && <div>{data}</div>}
-    </div>
-  );
-}
-```
-
-## Best Practices
-
-- **Use structured logging** - Always use `ctx.logger`, never `console.log`
-- **Validate inputs** - Define Zod schemas for all agent inputs/outputs
-- **Handle errors** - Use try/catch and return meaningful error messages
-- **Type everything** - Leverage TypeScript for type safety
-- **Keep agents focused** - One agent should do one thing well
-- **Use storage abstractions** - Use `ctx.kv`, `ctx.objectstore`, etc. instead of direct database access
-
-## Environment Variables
-
-Create a `.env` file in the project root:
-
-```env
-# Example environment variables
-API_KEY=your-api-key
-DATABASE_URL=your-database-url
-```
-
-Access them in your code:
-
-```typescript
-const apiKey = process.env.API_KEY;
-```
-
-## Deployment
-
-Build for production:
-
-```bash
-bun run build
-```
-
-The compiled application will be in `.agentuity/`. Deploy this directory to your hosting provider.
-
-## Learn More
-
-- [Agentuity Documentation](https://agentuity.dev)
-- [Bun Documentation](https://bun.sh/docs)
-- [Hono Documentation](https://hono.dev/)
-- [Zod Documentation](https://zod.dev/)

package/app.ts

@@ -1,8 +0,0 @@
-import { createApp } from '@agentuity/runtime';
-import { showRoutes } from 'hono/dev';
-
-const { app, server, logger } = createApp();
-
-showRoutes(app);
-
-logger.info('Running %s', server.url);

package/setup.ts

@@ -1,65 +0,0 @@
-#!/usr/bin/env bun
-import { existsSync, readFileSync, writeFileSync, rmSync } from 'fs';
-import { basename } from 'path';
-
-const projectDir = process.cwd();
-const projectName = basename(projectDir);
-
-console.log(`🔧 Setting up your project...\n`);
-
-// Update package.json
-const packageJsonPath = 'package.json';
-if (existsSync(packageJsonPath)) {
-	const packageJson = JSON.parse(readFileSync(packageJsonPath, 'utf-8'));
-
-	packageJson.name = projectName;
-	delete packageJson['bun-create'];
-	delete packageJson.bin;
-	packageJson.private = true;
-	delete packageJson.files;
-	delete packageJson.keywords;
-	delete packageJson.author;
-	delete packageJson.license;
-	delete packageJson.publishConfig;
-	packageJson.description = undefined;
-
-	// Remove enquirer from dependencies (only needed for setup)
-	if (packageJson.dependencies) {
-		delete packageJson.dependencies.enquirer;
-	}
-
-	writeFileSync(packageJsonPath, JSON.stringify(packageJson, null, '\t'));
-	console.log('✓ Updated package.json');
-}
-
-// Update README.md
-const readmePath = 'README.md';
-if (existsSync(readmePath)) {
-	let readme = readFileSync(readmePath, 'utf-8');
-	readme = readme.replace(/\{\{PROJECT_NAME\}\}/g, projectName);
-	writeFileSync(readmePath, readme);
-	console.log('✓ Updated README.md');
-}
-
-// Update AGENTS.md
-const agentsMdPath = 'AGENTS.md';
-if (existsSync(agentsMdPath)) {
-	let agentsMd = readFileSync(agentsMdPath, 'utf-8');
-	agentsMd = agentsMd.replace(/\{\{PROJECT_NAME\}\}/g, projectName);
-	writeFileSync(agentsMdPath, agentsMd);
-	console.log('✓ Updated AGENTS.md');
-}
-
-// Remove setup files
-const filesToRemove = ['setup.ts'];
-for (const file of filesToRemove) {
-	if (existsSync(file)) {
-		rmSync(file);
-	}
-}
-
-console.log('\n✨ Setup complete!\n');
-console.log(`   Next steps:`);
-console.log(`   1. cd ./${projectName}`);
-console.log(`   2. bun run dev`);
-console.log(`\n   Your agents will be running at http://localhost:3000\n`);

package/src/agents/hello/agent.ts

@@ -1,14 +0,0 @@
-import { type AgentContext, createAgent } from '@agentuity/runtime';
-import { z } from 'zod';
-
-const agent = createAgent({
-	schema: {
-		input: z.object({ name: z.string() }),
-		output: z.string(),
-	},
-	handler: async (_c: AgentContext, { name }) => {
-		return `Hello, ${name}! Welcome to Agentuity.`;
-	},
-});
-
-export default agent;

package/src/agents/hello/route.ts

@@ -1,18 +0,0 @@
-import { createRouter } from '@agentuity/runtime';
-import { zValidator } from '@hono/zod-validator';
-import agent from './agent';
-
-const router = createRouter();
-
-router.get('/', async (c) => {
-	const text = await c.agent.hello.run({ name: 'World' });
-	return c.text(text);
-});
-
-router.post('/', zValidator('json', agent.inputSchema!), async (c) => {
-	const data = c.req.valid('json');
-	const text = await c.agent.hello.run(data);
-	return c.text(text);
-});
-
-export default router;

package/src/agents/registry.generated.ts

@@ -1,30 +0,0 @@
-// Auto-generated by Agentuity - do not edit manually
-import helloAgent from '../agents/hello/agent';
-import type { AgentRunner, Logger } from '@agentuity/runtime';
-import type { KeyValueStorage, ObjectStorage, StreamStorage, VectorStorage } from '@agentuity/core';
-
-export const agentRegistry = {
-  hello: helloAgent,
-} as const;
-
-export type AgentName = keyof typeof agentRegistry;
-export type AgentRegistry = typeof agentRegistry;
-
-// Typed runners for each agent
-export type HelloAgentRunner = AgentRunner<typeof helloAgent['inputSchema'], typeof helloAgent['outputSchema'], typeof helloAgent['stream'] extends true ? true : false>;
-
-// Augment Context to provide strongly-typed agents
-declare module "hono" {
-	interface Context {
-	   agentName: AgentName;
-	   agent: {
-	     [K in AgentName]: AgentRunner<AgentRegistry[K]['inputSchema'], AgentRegistry[K]['outputSchema'], AgentRegistry[K]['stream'] extends true ? true : false>;
-	   };
-	   waitUntil: (promise: Promise<void> | (() => void | Promise<void>)) => void;
-	   logger: Logger;
-	   kv: KeyValueStorage;
-	   objectstore: ObjectStorage;
-	   stream: StreamStorage;
-	   vector: VectorStorage;
-  }
-}

package/src/agents/types.generated.d.ts

@@ -1,10 +0,0 @@
-// Auto-generated by Agentuity - do not edit manually
-// This file augments @agentuity/react with your project's agent types
-import type helloAgent from '../agents/hello/agent';
-import type { Agent } from '@agentuity/react';
-
-declare module '@agentuity/react' {
-	interface AgentRegistry {
-		'hello': Agent<typeof helloAgent['inputSchema'], typeof helloAgent['outputSchema']>;
-	}
-}

package/src/apis/status/route.ts

@@ -1,13 +0,0 @@
-import { createRouter } from '@agentuity/runtime';
-
-const router = createRouter();
-
-router.get('/', (c) => {
-	return c.json({
-		status: 'ok',
-		timestamp: new Date().toISOString(),
-		version: '1.0.0',
-	});
-});
-
-export default router;

package/src/web/app.tsx

@@ -1,73 +0,0 @@
-import React, { type ChangeEvent, useState } from 'react';
-import { AgentuityProvider, useAgent } from '@agentuity/react';
-
-export function App() {
-	const [name, setName] = useState('World');
-	const { run, running, data: greeting } = useAgent('hello');
-
-	return (
-		<div
-			style={{ fontFamily: 'sans-serif', padding: '2rem', maxWidth: '600px', margin: '0 auto' }}
-		>
-			<AgentuityProvider>
-				<h1>Welcome to Agentuity</h1>
-				<p>Your new Agentuity project is ready to go!</p>
-
-				<div style={{ marginTop: '2rem' }}>
-					<h2>Try the Hello Agent</h2>
-					<div style={{ display: 'flex', gap: '0.5rem', marginBottom: '1rem' }}>
-						<input
-							type="text"
-							value={name}
-							disabled={running}
-							onChange={(e: ChangeEvent<HTMLInputElement>) => setName(e.currentTarget.value)}
-							placeholder="Enter your name"
-							style={{ padding: '0.5rem', flex: 1 }}
-						/>
-						<button
-							disabled={running}
-							onClick={() => run({ name })}
-							style={{ padding: '0.5rem 1rem' }}
-						>
-							{running ? 'Running ...' : 'Say Hello'}
-						</button>
-					</div>
-					{greeting && (
-						<div
-							style={{
-								padding: '1rem',
-								backgroundColor: '#f0f0f0',
-								borderRadius: '4px',
-								marginTop: '1rem',
-							}}
-						>
-							{greeting}
-						</div>
-					)}
-				</div>
-
-				<div
-					style={{
-						marginTop: '2rem',
-						padding: '1rem',
-						backgroundColor: '#e8f4f8',
-						borderRadius: '4px',
-					}}
-				>
-					<h3>Next Steps:</h3>
-					<ul>
-						<li>
-							Edit <code>src/agents/hello/agent.ts</code> to customize your agent
-						</li>
-						<li>
-							Add new routes in <code>src/apis/</code>
-						</li>
-						<li>
-							Customize this page in <code>src/web/app.tsx</code>
-						</li>
-					</ul>
-				</div>
-			</AgentuityProvider>
-		</div>
-	);
-}

package/src/web/client.generated.js

@@ -1,7 +0,0 @@
-
-import React from "react";
-import { createRoot } from "react-dom/client";
-import { App } from "./app";
-
-const root = createRoot(document.getElementById("root"));
-root.render(<App />);

package/tsconfig.json

@@ -1,24 +0,0 @@
-{
-	"compilerOptions": {
-		"lib": ["ESNext", "DOM", "DOM.Iterable"],
-		"target": "ESNext",
-		"module": "Preserve",
-		"moduleDetection": "force",
-		"jsx": "react-jsx",
-		"allowJs": true,
-		"moduleResolution": "bundler",
-		"allowImportingTsExtensions": true,
-		"verbatimModuleSyntax": true,
-		"noEmit": true,
-		"strict": true,
-		"skipLibCheck": true,
-		"noFallthroughCasesInSwitch": true,
-		"noUncheckedIndexedAccess": true,
-		"noImplicitOverride": true,
-		"noUnusedLocals": false,
-		"noUnusedParameters": false,
-		"noPropertyAccessFromIndexSignature": false
-	},
-	"include": ["src/**/*", "app.ts"],
-	"exclude": [".agentuity/**/*"]
-}