create-adk-agent 0.0.5 → 0.0.9

package/README.md

@@ -1,250 +1,69 @@
 # create-adk-agent
 
-> **The fastest way to start building with Google's Agent Development Kit (ADK)**
+> Scaffold production-ready [Google ADK](https://google.github.io/adk-docs/) TypeScript projects in seconds
 
-Scaffold production-ready ADK TypeScript projects in seconds with best practices, multiple templates, and zero configuration.
-
-**What is ADK?** The [Agent Development Kit](https://google.github.io/adk-docs/) is Google's framework for building AI agents. This tool makes it easy to get started.
-
-## 🚀 Quick Start
+## Quick Start
 
 ```bash
 npx create-adk-agent my-agent
 ```
 
-Or use it non-interactively:
-
-```bash
-npx create-adk-agent my-agent --template=basic --modelProvider=gemini --model=gemini-2.0-flash
-```
+Creates a TypeScript project pre-configured for building AI agents with Google's Agent Development Kit.
 
-That's it! You'll get a fully configured ADK project with:
+## What You Get
 
-- ✅ TypeScript configured for ADK (ES2022, NodeNext)
+- ✅ Working agent examples from [ADK docs](https://google.github.io/adk-docs/get-started/typescript/)
+- ✅ TypeScript configured (ES2022, NodeNext, ESM)
+- ✅ Hot reload with tsx (instant execution)
+- ✅ Multi-model support (Gemini, OpenAI, Anthropic)
 - ✅ Environment setup with API key validation
-- ✅ Working agent examples from official docs
-- ✅ Hot reload development with tsx
-- ✅ Testing setup with Jest
-- ✅ All the tooling (ESLint, Prettier, etc.)
-
-## 💡 Why Use This?
-
-Instead of manually setting up TypeScript, configuring ESM, managing API keys, and copying examples from docs, `create-adk-agent` does it all for you in one command.
-
-**Perfect for:**
-
-- 🎓 Learning ADK quickly with working examples
-- 🚀 Starting new ADK projects without boilerplate hassle
-- 📦 Getting ADK best practices out of the box
-- 🔄 Experimenting with different agent patterns
-
-## ✨ What You Get
-
-## ✨ What You Get
-
-- 🤖 **5 Agent Templates** - Pre-built examples from [official ADK docs](https://google.github.io/adk-docs/) (basic, multi-tool, team, streaming, workflow)
-- 🔌 **Multi-Model Ready** - Pre-configured for Gemini, OpenAI, and Anthropic
-- ⚡ **Hot Reload** - Instant TypeScript execution with tsx (no build step needed)
-- 🔐 **Security Built-in** - Proper `.env` handling with validation and git-ignore
-- 🧪 **Testing Included** - Jest configured and ready to go
-- 📦 **Best Practices** - TypeScript, ESLint, Prettier, Zod validation
-
-## 📚 Agent Templates
-
-All templates are based on [official ADK documentation examples](https://google.github.io/adk-docs/):
-
-### Basic Agent
-
-Simple agent with time tool - perfect for learning ADK basics.
-
-### Multi-Tool Agent (Default)
+- ✅ Testing with Jest, linting with ESLint
 
-Agent with multiple tools (time, weather, calculator) demonstrating tool composition.
+## Usage
 
-### Team Agent
-
-Multi-agent system with coordination, delegation, and sub-agents (greeting + farewell).
-
-### Streaming Agent
-
-Demonstrates real-time streaming responses using ADK Live API.
-
-### Workflow Agent
-
-Sequential workflow patterns with validation, transformation, and saving steps.
-
-## 🎯 Usage
-
-### Simple (Interactive)
-
-Just run the command and answer a few questions:
+**Interactive:**
 
 ```bash
 npx create-adk-agent my-agent
 ```
 
-You'll choose:
-
-- Which agent templates to include
-- Your preferred model provider (Gemini, OpenAI, or Anthropic)
-- Whether to install dependencies now
-- Whether to initialize git
-
-### Advanced (Non-Interactive)
-
-Skip prompts by providing options:
+**Non-interactive:**
 
 ```bash
 npx create-adk-agent my-agent \
-  --templates=basic,multi-tool \
+  --template=basic \
   --modelProvider=gemini \
-  --model=gemini-3.0-flash \
-  --description="My custom agent" \
-  --installDependencies \
-  --no-interactive
-```
-
-### Options
-
-| Option                  | Type                              | Description                | Default                |
-| ----------------------- | --------------------------------- | -------------------------- | ---------------------- |
-| `name`                  | string                            | Project name (required)    | -                      |
-| `--templates`           | string[]                          | Agent templates to include | `['multi-tool']`       |
-| `--modelProvider`       | gemini\|openai\|anthropic\|custom | LLM provider               | `gemini`               |
-| `--model`               | string                            | Specific model to use      | Provider's first model |
-| `--description`         | string                            | Project description        | `My ADK Agent`         |
-| `--directory`           | string                            | Target directory           | Same as name           |
-| `--installDependencies` | boolean                           | Run npm install            | Prompt                 |
-| `--initGit`             | boolean                           | Initialize git repo        | Prompt                 |
-| `--no-interactive`      | boolean                           | Skip prompts               | `false`                |
-
-## 🤖 Supported Models
-
-### Google Gemini (Direct)
-
-- gemini-3.0-flash
-- gemini-3.0-pro
-- gemini-2.5-flash
-- gemini-2.5-pro
-
-### OpenAI (via LiteLLM)
-
-- gpt-5
-- gpt-5-mini
-- gpt-4o
-- gpt-4o-mini
-
-### Anthropic (via LiteLLM)
-
-- claude-4.5-sonnet
-- claude-4-sonnet
-- claude-4-opus
-- claude-3-5-sonnet
-
-**Note:** You can change to any model after project generation. The list above is for initial setup convenience.
-
-## 🎬 Getting Started Workflow
-
-```bash
-# 1. Create your project (takes ~10 seconds)
-npx create-adk-agent my-agent
-
-# 2. Navigate to project
-cd my-agent
-
-# 3. Add your API key
-cp .env.example .env
-# Edit .env and add your API key (get it from links in the file)
-
-# 4. Start coding! (hot reload enabled)
-npm run dev
-
-# 5. Or use ADK DevTools
-npm run adk:web    # Beautiful web UI
-npm run adk:run    # CLI runner
+  --model=gemini-2.5-flash
 ```
 
-**That's it!** You're now building with ADK. No complex setup, no configuration headaches.
-
-## 🔗 Learn More About ADK
-
-```
-my-agent/
-├── src/
-│   ├── agents/
-│   │   ├── basic/          # Basic agent (if selected)
-│   │   ├── multi-tool/     # Multi-tool agent (if selected)
-│   │   ├── team/           # Team agents (if selected)
-│   │   ├── streaming/      # Streaming agent (if selected)
-│   │   └── workflow/       # Workflow agent (if selected)
-│   └── index.ts            # Entry point with env validation
-├── tests/
-│   └── agents.test.ts      # Jest tests
-├── .env.example            # Environment template (commit this)
-├── .env                    # Your API keys (DO NOT COMMIT)
-├── .gitignore              # Includes .env patterns
-├── package.json            # With tsx, ADK, and dev tools
-├── tsconfig.json           # Configured for ESM + NodeNext
-└── README.md               # Project-specific documentation
-```
-
-## 🔐 Security
-
-**⚠️ Generated projects include:**
-
-- `.env` in `.gitignore` by default
-- API key validation on startup
-- Clear warnings about committing secrets
-- `.env.example` template for sharing
-
-## 🛠️ Development Workflow
-
-After generating your project:
+## After Generation
 
 ```bash
 cd my-agent
 
-# 1. Set up your API key
+# Add your API key
 cp .env.example .env
-# Edit .env and add your API key
+# Edit .env with your API key
 
-# 2. Install dependencies (if not done during generation)
-npm install
-
-# 3. Start development with hot reload
+# Start development
 npm run dev
 
-# 4. Run tests
-npm test
-
-# 5. Use ADK DevTools
-npm run adk:web    # Web UI
+# Use ADK DevTools
+npm run adk:web    # Interactive web UI
 npm run adk:run    # CLI runner
 ```
 
-## 📚 Documentation
-
-- [ADK Documentation](https://google.github.io/adk-docs/)
-- [TypeScript Quick Start](https://google.github.io/adk-docs/get-started/typescript/)
-- [Agent Tutorial](https://google.github.io/adk-docs/tutorial/agent/)
-
-## 🤝 Contributing
+## Templates
 
-Contributions welcome! This is an Nx workspace project.
+- **basic** - Single agent with one tool ([docs example](https://google.github.io/adk-docs/get-started/typescript/#define-the-agent-code))
+- **multi-tool** - Agent with multiple tools (default)
 
-### Development
+## Learn More
 
-```bash
-# Build the generator
-nx build create-adk-agent
-
-# Test locally
-nx g @adk-ts-new/create-adk-agent:init test-project
-
-# Run tests
-nx test create-adk-agent
-```
+- **[ADK Documentation](https://google.github.io/adk-docs/)** - Official ADK guide
+- **[TypeScript Quickstart](https://google.github.io/adk-docs/get-started/typescript/)** - Getting started
+- **[Building Agents](https://google.github.io/adk-docs/tutorials/)** - Agent tutorials
 
-## 📄 License
+## License
 
-MIT © Maina Wycliffe
+MIT

package/dist/generators/init/files/src/agents/basic/agent.ts.template

@@ -1,34 +1,24 @@
-import { LlmAgent, FunctionTool } from '@google/adk';<% if (modelProvider === 'openai' || modelProvider === 'anthropic') { %>
+import { FunctionTool, LlmAgent } from '@google/adk';<% if (modelProvider === 'openai' || modelProvider === 'anthropic') { %>
 import { LiteLlm } from '@google/adk';<% } %>
 import { z } from 'zod';
 
-// Tool to get current time
+/* Mock tool implementation */
 const getCurrentTime = new FunctionTool({
   name: 'get_current_time',
-  description: 'Returns the current time in the specified timezone.',
+  description: 'Returns the current time in a specified city.',
   parameters: z.object({
-    timezone: z
-      .string()
-      .optional()
-      .describe('The timezone to use (e.g., "America/New_York", "Europe/London")'),
+    city: z.string().describe('The name of the city for which to retrieve the current time.'),
   }),
-  execute: ({ timezone = 'UTC' }) => {
-    const now = new Date();
-    const timeString = now.toLocaleString('en-US', { timeZone: timezone });
-    return {
-      status: 'success',
-      report: `The current time in ${timezone} is ${timeString}`,
-    };
+  execute: ({ city }) => {
+    return { status: 'success', report: `The current time in ${city} is 10:30 AM` };
   },
 });
 
-// Create the agent
 export const rootAgent = new LlmAgent({
   name: 'hello_time_agent',
   <% if (modelProvider === 'gemini') { %>model: '<%= model %>',<% } else if (modelProvider === 'openai' || modelProvider === 'anthropic') { %>model: new LiteLlm({ model: '<%= model %>' }),<% } else { %>model: '<%= model %>',<% } %>
-  description: 'An agent that can tell you the current time in any timezone.',
-  instruction: `You are a friendly time-telling assistant. When asked about the time, 
-use the get_current_time tool to provide the current time in the requested timezone. 
-If no timezone is specified, use UTC as the default.`,
+  description: 'Tells the current time in a specified city.',
+  instruction: `You are a helpful assistant that tells the current time in a city.
+                Use the 'getCurrentTime' tool for this purpose.`,
   tools: [getCurrentTime],
 });

package/dist/generators/init/files/src/agents/multi-tool/agent.ts.template

@@ -1,83 +1,36 @@
-import { LlmAgent, FunctionTool } from '@google/adk';<% if (modelProvider === 'openai' || modelProvider === 'anthropic') { %>
+import { FunctionTool, LlmAgent } from '@google/adk';<% if (modelProvider === 'openai' || modelProvider === 'anthropic') { %>
 import { LiteLlm } from '@google/adk';<% } %>
 import { z } from 'zod';
 
-// Tool to get current time
+/* Mock tool implementations */
 const getCurrentTime = new FunctionTool({
   name: 'get_current_time',
-  description: 'Returns the current time in the specified timezone.',
+  description: 'Returns the current time in a specified city.',
   parameters: z.object({
-    timezone: z
-      .string()
-      .optional()
-      .describe('The timezone to use (e.g., "America/New_York", "Europe/London")'),
+    city: z.string().describe('The name of the city for which to retrieve the current time.'),
   }),
-  execute: ({ timezone = 'UTC' }) => {
-    const now = new Date();
-    const timeString = now.toLocaleString('en-US', { timeZone: timezone });
-    return {
-      status: 'success',
-      report: `The current time in ${timezone} is ${timeString}`,
-    };
+  execute: ({ city }) => {
+    return { status: 'success', report: `The current time in ${city} is 10:30 AM` };
   },
 });
 
-// Tool to get weather (mock data for demo)
 const getWeather = new FunctionTool({
   name: 'get_weather',
-  description: 'Returns the current weather for a given location.',
+  description: 'Returns the current weather for a specified city.',
   parameters: z.object({
-    location: z.string().describe('The city or location to get weather for'),
+    city: z.string().describe('The name of the city for which to retrieve the weather.'),
   }),
-  execute: ({ location }) => {
-    // Mock weather data - in production, call a real weather API
-    const conditions = ['sunny', 'cloudy', 'rainy', 'partly cloudy'];
-    const condition = conditions[Math.floor(Math.random() * conditions.length)];
-    const temp = Math.floor(Math.random() * 30) + 50; // 50-80°F
-    
-    return {
-      status: 'success',
-      report: `The weather in ${location} is ${condition} with a temperature of ${temp}°F`,
-    };
+  execute: ({ city }) => {
+    return { status: 'success', report: `The weather in ${city} is sunny and 72°F` };
   },
 });
 
-// Tool for calculations
-const calculate = new FunctionTool({
-  name: 'calculate',
-  description: 'Performs basic mathematical calculations.',
-  parameters: z.object({
-    expression: z
-      .string()
-      .describe('The mathematical expression to evaluate (e.g., "2 + 2", "10 * 5")'),
-  }),
-  execute: ({ expression }) => {
-    try {
-      // Simple eval for demo - in production, use a safe math parser
-      const result = eval(expression);
-      return {
-        status: 'success',
-        report: `${expression} = ${result}`,
-      };
-    } catch (error) {
-      return {
-        status: 'error',
-        report: `Error evaluating expression: ${error}`,
-      };
-    }
-  },
-});
-
-// Create the agent with multiple tools
 export const rootAgent = new LlmAgent({
   name: 'multi_tool_agent',
   <% if (modelProvider === 'gemini') { %>model: '<%= model %>',<% } else if (modelProvider === 'openai' || modelProvider === 'anthropic') { %>model: new LiteLlm({ model: '<%= model %>' }),<% } else { %>model: '<%= model %>',<% } %>
-  description: 'An agent with multiple tools for time, weather, and calculations.',
-  instruction: `You are a helpful assistant with access to multiple tools:
-- get_current_time: Get the current time in any timezone
-- get_weather: Get weather information for a location
-- calculate: Perform mathematical calculations
-
-Use the appropriate tool based on the user's request. Be friendly and helpful.`,
-  tools: [getCurrentTime, getWeather, calculate],
+  description: 'Provides current time and weather information for cities.',
+  instruction: `You are a helpful assistant that provides time and weather information.
+                Use the 'getCurrentTime' tool to get the time in a city.
+                Use the 'getWeather' tool to get weather information for a city.`,
+  tools: [getCurrentTime, getWeather],
 });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-adk-agent",
-  "version": "0.0.5",
+  "version": "0.0.9",
   "description": "Nx generator for scaffolding ADK (Agent Development Kit) TypeScript projects with multiple templates, multi-model support, and modern tooling",
   "keywords": [
     "adk",

package/src/generators/init/files/src/agents/basic/agent.ts.template

@@ -1,34 +1,24 @@
-import { LlmAgent, FunctionTool } from '@google/adk';<% if (modelProvider === 'openai' || modelProvider === 'anthropic') { %>
+import { FunctionTool, LlmAgent } from '@google/adk';<% if (modelProvider === 'openai' || modelProvider === 'anthropic') { %>
 import { LiteLlm } from '@google/adk';<% } %>
 import { z } from 'zod';
 
-// Tool to get current time
+/* Mock tool implementation */
 const getCurrentTime = new FunctionTool({
   name: 'get_current_time',
-  description: 'Returns the current time in the specified timezone.',
+  description: 'Returns the current time in a specified city.',
   parameters: z.object({
-    timezone: z
-      .string()
-      .optional()
-      .describe('The timezone to use (e.g., "America/New_York", "Europe/London")'),
+    city: z.string().describe('The name of the city for which to retrieve the current time.'),
   }),
-  execute: ({ timezone = 'UTC' }) => {
-    const now = new Date();
-    const timeString = now.toLocaleString('en-US', { timeZone: timezone });
-    return {
-      status: 'success',
-      report: `The current time in ${timezone} is ${timeString}`,
-    };
+  execute: ({ city }) => {
+    return { status: 'success', report: `The current time in ${city} is 10:30 AM` };
   },
 });
 
-// Create the agent
 export const rootAgent = new LlmAgent({
   name: 'hello_time_agent',
   <% if (modelProvider === 'gemini') { %>model: '<%= model %>',<% } else if (modelProvider === 'openai' || modelProvider === 'anthropic') { %>model: new LiteLlm({ model: '<%= model %>' }),<% } else { %>model: '<%= model %>',<% } %>
-  description: 'An agent that can tell you the current time in any timezone.',
-  instruction: `You are a friendly time-telling assistant. When asked about the time, 
-use the get_current_time tool to provide the current time in the requested timezone. 
-If no timezone is specified, use UTC as the default.`,
+  description: 'Tells the current time in a specified city.',
+  instruction: `You are a helpful assistant that tells the current time in a city.
+                Use the 'getCurrentTime' tool for this purpose.`,
   tools: [getCurrentTime],
 });

package/src/generators/init/files/src/agents/multi-tool/agent.ts.template

@@ -1,83 +1,36 @@
-import { LlmAgent, FunctionTool } from '@google/adk';<% if (modelProvider === 'openai' || modelProvider === 'anthropic') { %>
+import { FunctionTool, LlmAgent } from '@google/adk';<% if (modelProvider === 'openai' || modelProvider === 'anthropic') { %>
 import { LiteLlm } from '@google/adk';<% } %>
 import { z } from 'zod';
 
-// Tool to get current time
+/* Mock tool implementations */
 const getCurrentTime = new FunctionTool({
   name: 'get_current_time',
-  description: 'Returns the current time in the specified timezone.',
+  description: 'Returns the current time in a specified city.',
   parameters: z.object({
-    timezone: z
-      .string()
-      .optional()
-      .describe('The timezone to use (e.g., "America/New_York", "Europe/London")'),
+    city: z.string().describe('The name of the city for which to retrieve the current time.'),
   }),
-  execute: ({ timezone = 'UTC' }) => {
-    const now = new Date();
-    const timeString = now.toLocaleString('en-US', { timeZone: timezone });
-    return {
-      status: 'success',
-      report: `The current time in ${timezone} is ${timeString}`,
-    };
+  execute: ({ city }) => {
+    return { status: 'success', report: `The current time in ${city} is 10:30 AM` };
   },
 });
 
-// Tool to get weather (mock data for demo)
 const getWeather = new FunctionTool({
   name: 'get_weather',
-  description: 'Returns the current weather for a given location.',
+  description: 'Returns the current weather for a specified city.',
   parameters: z.object({
-    location: z.string().describe('The city or location to get weather for'),
+    city: z.string().describe('The name of the city for which to retrieve the weather.'),
   }),
-  execute: ({ location }) => {
-    // Mock weather data - in production, call a real weather API
-    const conditions = ['sunny', 'cloudy', 'rainy', 'partly cloudy'];
-    const condition = conditions[Math.floor(Math.random() * conditions.length)];
-    const temp = Math.floor(Math.random() * 30) + 50; // 50-80°F
-    
-    return {
-      status: 'success',
-      report: `The weather in ${location} is ${condition} with a temperature of ${temp}°F`,
-    };
+  execute: ({ city }) => {
+    return { status: 'success', report: `The weather in ${city} is sunny and 72°F` };
   },
 });
 
-// Tool for calculations
-const calculate = new FunctionTool({
-  name: 'calculate',
-  description: 'Performs basic mathematical calculations.',
-  parameters: z.object({
-    expression: z
-      .string()
-      .describe('The mathematical expression to evaluate (e.g., "2 + 2", "10 * 5")'),
-  }),
-  execute: ({ expression }) => {
-    try {
-      // Simple eval for demo - in production, use a safe math parser
-      const result = eval(expression);
-      return {
-        status: 'success',
-        report: `${expression} = ${result}`,
-      };
-    } catch (error) {
-      return {
-        status: 'error',
-        report: `Error evaluating expression: ${error}`,
-      };
-    }
-  },
-});
-
-// Create the agent with multiple tools
 export const rootAgent = new LlmAgent({
   name: 'multi_tool_agent',
   <% if (modelProvider === 'gemini') { %>model: '<%= model %>',<% } else if (modelProvider === 'openai' || modelProvider === 'anthropic') { %>model: new LiteLlm({ model: '<%= model %>' }),<% } else { %>model: '<%= model %>',<% } %>
-  description: 'An agent with multiple tools for time, weather, and calculations.',
-  instruction: `You are a helpful assistant with access to multiple tools:
-- get_current_time: Get the current time in any timezone
-- get_weather: Get weather information for a location
-- calculate: Perform mathematical calculations
-
-Use the appropriate tool based on the user's request. Be friendly and helpful.`,
-  tools: [getCurrentTime, getWeather, calculate],
+  description: 'Provides current time and weather information for cities.',
+  instruction: `You are a helpful assistant that provides time and weather information.
+                Use the 'getCurrentTime' tool to get the time in a city.
+                Use the 'getWeather' tool to get weather information for a city.`,
+  tools: [getCurrentTime, getWeather],
 });

package/templates/basic/README.md

@@ -1,22 +1,8 @@
-# __PROJECT_NAME__
+# **PROJECT_NAME**
 
-__DESCRIPTION__
+**DESCRIPTION**
 
-## Features
-
-- ✅ TypeScript support with ES2022 target
-- ✅ Hot reload development with tsx
-- ✅ Multiple LLM provider support (Gemini, OpenAI, Anthropic)
-- ✅ Environment-based configuration
-- ✅ Jest testing setup
-- ✅ ESLint and Prettier configured
-
-## Prerequisites
-
-- Node.js 20+ (for ADK compatibility)
-- An API key from your chosen LLM provider
-
-## Getting Started
+## Quick Start
 
 ### 1. Install Dependencies
 
@@ -24,132 +10,40 @@ __DESCRIPTION__
 npm install
 ```
 
-### 2. Configure Environment
-
-Copy `.env.example` to `.env` and add your API key:
+### 2. Add Your API Key
 
 ```bash
 cp .env.example .env
+# Edit .env and add your API key
 ```
 
-Edit `.env` and add your API key:
-
-```env
-# For Google Gemini (default)
-GEMINI_API_KEY=your_api_key_here
-
-# OR for OpenAI
-OPENAI_API_KEY=your_openai_key_here
-
-# OR for Anthropic
-ANTHROPIC_API_KEY=your_anthropic_key_here
-```
-
-### 3. Run in Development Mode
+### 3. Start Development
 
 ```bash
-npm run dev
+npm run dev          # Hot reload development
+npm run adk:web      # Interactive web UI at http://localhost:8000
+npm run adk:run      # CLI runner
 ```
 
-This starts the agent with hot reload - any code changes will automatically restart the agent.
-
-### 4. Run in Production Mode
+## Available Scripts
 
-```bash
-npm run build
-npm run prod
-```
+- `npm run dev` - Hot reload development
+- `npm run adk:web` - ADK web UI for testing
+- `npm run adk:run` - ADK CLI runner
+- `npm test` - Run tests
+- `npm run build` - Build for production
 
 ## Project Structure
 
 ```
 src/
-├── index.ts          # Main entry point with agent configuration
-└── tools/            # Custom tools for the agent
+├── index.ts          # Agent configuration
 tests/
 └── agents.test.ts    # Agent tests
 ```
 
-## Available Scripts
-
-- `npm run dev` - Start with hot reload (development)
-- `npm start` - Run once (no reload)
-- `npm run build` - Build TypeScript to JavaScript
-- `npm run prod` - Run built JavaScript
-- `npm test` - Run tests
-- `npm run lint` - Lint code
-- `npm run format` - Format code with Prettier
-
-## Using Different LLM Providers
-
-### Google Gemini (Default)
-
-```typescript
-import { LlmAgent } from '@google/adk';
-
-const agent = new LlmAgent({
-  model: 'gemini-2.0-flash',
-  // ...
-});
-```
-
-### OpenAI via LiteLLM
-
-```typescript
-import { LlmAgent, LiteLlm } from '@google/adk';
-
-const agent = new LlmAgent({
-  model: new LiteLlm({ model: 'openai/gpt-4o' }),
-  // ...
-});
-```
-
-### Anthropic via LiteLLM
-
-```typescript
-import { LlmAgent, LiteLlm } from '@google/adk';
-
-const agent = new LlmAgent({
-  model: new LiteLlm({ model: 'anthropic/claude-3-5-sonnet' }),
-  // ...
-});
-```
-
-## Security Notes
-
-⚠️ **Never commit your `.env` file or API keys to version control!**
-
-The `.gitignore` is configured to exclude:
-- `.env` and `.env.local`
-- API keys and sensitive data
-
-## Troubleshooting
-
-### Missing API Key Error
-
-If you see an error about missing API keys:
-
-1. Ensure `.env` file exists in project root
-2. Verify the correct API key variable is set
-3. Check that the API key is valid
-
-### TypeScript Import Errors
-
-ADK requires `verbatimModuleSyntax: false` in `tsconfig.json`. This is already configured.
-
-### Module Resolution Issues
-
-Make sure to use `.js` extensions in imports:
-
-```typescript
-import { myFunction } from './myModule.js';
-```
-
 ## Learn More
 
-- [ADK Documentation](https://google.github.io/adk-docs/)
-- [ADK GitHub](https://github.com/google/adk)
-
-## License
-
-MIT
+- **[ADK Documentation](https://google.github.io/adk-docs/)** - Complete ADK guide
+- **[TypeScript Quickstart](https://google.github.io/adk-docs/get-started/typescript/)** - Getting started tutorial
+- **[Building Agents](https://google.github.io/adk-docs/tutorials/)** - Agent tutorials and patterns

package/templates/basic/package.json

@@ -12,7 +12,9 @@
         "test": "jest",
         "test:watch": "jest --watch",
         "lint": "eslint src/**/*.ts",
-        "format": "prettier --write src/**/*.ts"
+        "format": "prettier --write src/**/*.ts",
+        "adk:web": "adk web",
+        "adk:run": "adk run src/index.ts"
     },
     "keywords": [
         "adk",

package/templates/basic/src/index.ts

@@ -1,9 +1,13 @@
+import { FunctionTool, LlmAgent } from '@google/adk';
 import 'dotenv/config';
-import { LlmAgent, FunctionTool } from '@google/adk';
 import { z } from 'zod';
 
 // Validate environment variables
-if (!process.env.GEMINI_API_KEY && !process.env.OPENAI_API_KEY && !process.env.ANTHROPIC_API_KEY) {
+if (
+  !process.env.GEMINI_API_KEY &&
+  !process.env.OPENAI_API_KEY &&
+  !process.env.ANTHROPIC_API_KEY
+) {
   console.error('❌ Error: No API key found!');
   console.error('Please set one of the following in your .env file:');
   console.error('  - GEMINI_API_KEY (for Google Gemini)');
@@ -12,34 +16,29 @@ if (!process.env.GEMINI_API_KEY && !process.env.OPENAI_API_KEY && !process.env.A
   process.exit(1);
 }
 
-// Tool to get current time
+/* Mock tool implementation */
 const getCurrentTime = new FunctionTool({
   name: 'get_current_time',
-  description: 'Returns the current time in the specified timezone.',
+  description: 'Returns the current time in a specified city.',
   parameters: z.object({
-    timezone: z
+    city: z
       .string()
-      .optional()
-      .describe('The timezone to use (e.g., "America/New_York", "Europe/London")'),
+      .describe('The name of the city for which to retrieve the current time.'),
   }),
-  execute: ({ timezone = 'UTC' }) => {
-    const now = new Date();
-    const timeString = now.toLocaleString('en-US', { timeZone: timezone });
+  execute: ({ city }) => {
     return {
       status: 'success',
-      report: `The current time in ${timezone} is ${timeString}`,
+      report: `The current time in ${city} is 10:30 AM`,
     };
   },
 });
 
-// Create the agent
 export const rootAgent = new LlmAgent({
   name: 'hello_time_agent',
   model: __MODEL_CONFIG__,
-  description: 'An agent that can tell you the current time in any timezone.',
-  instruction: `You are a friendly time-telling assistant. When asked about the time, 
-use the get_current_time tool to provide the current time in the requested timezone. 
-If no timezone is specified, use UTC as the default.`,
+  description: 'Tells the current time in a specified city.',
+  instruction: `You are a helpful assistant that tells the current time in a city.
+                Use the 'getCurrentTime' tool for this purpose.`,
   tools: [getCurrentTime],
 });
 
@@ -47,7 +46,7 @@ If no timezone is specified, use UTC as the default.`,
 if (import.meta.url === `file://${process.argv[1]}`) {
   console.log('🤖 Hello Time Agent is ready!');
   console.log('Ask me about the time in any timezone.\n');
-  
+
   rootAgent
     .query('What time is it in Tokyo?')
     .then((response) => {

package/templates/multi-tool/src/index.ts

@@ -0,0 +1,60 @@
+import { FunctionTool, LlmAgent } from '@google/adk';
+import 'dotenv/config';
+import { z } from 'zod';
+
+// Validate environment variables
+if (
+  !process.env.GEMINI_API_KEY &&
+  !process.env.OPENAI_API_KEY &&
+  !process.env.ANTHROPIC_API_KEY
+) {
+  console.error('❌ Error: No API key found!');
+  console.error('Please set one of the following in your .env file:');
+  console.error('  - GEMINI_API_KEY (for Google Gemini)');
+  console.error('  - OPENAI_API_KEY (for OpenAI)');
+  console.error('  - ANTHROPIC_API_KEY (for Anthropic/Claude)');
+  process.exit(1);
+}
+
+/* Mock tool implementations */
+const getCurrentTime = new FunctionTool({
+  name: 'get_current_time',
+  description: 'Returns the current time in a specified city.',
+  parameters: z.object({
+    city: z
+      .string()
+      .describe('The name of the city for which to retrieve the current time.'),
+  }),
+  execute: ({ city }) => {
+    return {
+      status: 'success',
+      report: `The current time in ${city} is 10:30 AM`,
+    };
+  },
+});
+
+const getWeather = new FunctionTool({
+  name: 'get_weather',
+  description: 'Returns the current weather for a specified city.',
+  parameters: z.object({
+    city: z
+      .string()
+      .describe('The name of the city for which to retrieve the weather.'),
+  }),
+  execute: ({ city }) => {
+    return {
+      status: 'success',
+      report: `The weather in ${city} is sunny and 72°F`,
+    };
+  },
+});
+
+export const rootAgent = new LlmAgent({
+  name: 'multi_tool_agent',
+  model: __MODEL_CONFIG__,
+  description: 'Provides current time and weather information for cities.',
+  instruction: `You are a helpful assistant that provides time and weather information.
+                Use the 'getCurrentTime' tool to get the time in a city.
+                Use the 'getWeather' tool to get weather information for a city.`,
+  tools: [getCurrentTime, getWeather],
+});