create-adk-agent 0.0.2 → 0.0.9

package/templates/basic/.env.example

@@ -0,0 +1,16 @@
+# Google Gemini API Key
+# Get your key from: https://aistudio.google.com/apikey
+GEMINI_API_KEY=your_google_api_key_here
+
+# OR use Vertex AI (for Google Cloud)
+# GOOGLE_GENAI_USE_VERTEXAI=true
+# GOOGLE_CLOUD_PROJECT=your-project-id
+# GOOGLE_CLOUD_LOCATION=us-central1
+
+# OpenAI API Key (if using OpenAI models)
+# Get your key from: https://platform.openai.com/api-keys
+# OPENAI_API_KEY=your_openai_api_key_here
+
+# Anthropic API Key (if using Claude models)
+# Get your key from: https://console.anthropic.com/settings/keys
+# ANTHROPIC_API_KEY=your_anthropic_api_key_here

package/templates/basic/.eslintrc.json

@@ -0,0 +1,13 @@
+{
+  "parser": "@typescript-eslint/parser",
+  "extends": ["eslint:recommended", "plugin:@typescript-eslint/recommended"],
+  "parserOptions": {
+    "ecmaVersion": 2022,
+    "sourceType": "module"
+  },
+  "env": {
+    "node": true,
+    "es2022": true
+  },
+  "rules": {}
+}

package/templates/basic/.prettierrc

@@ -0,0 +1,5 @@
+{
+    "semi": true,
+    "singleQuote": true,
+    "trailingComma": "all"
+}

package/templates/basic/README.md

@@ -0,0 +1,49 @@
+# **PROJECT_NAME**
+
+**DESCRIPTION**
+
+## Quick Start
+
+### 1. Install Dependencies
+
+```bash
+npm install
+```
+
+### 2. Add Your API Key
+
+```bash
+cp .env.example .env
+# Edit .env and add your API key
+```
+
+### 3. Start Development
+
+```bash
+npm run dev          # Hot reload development
+npm run adk:web      # Interactive web UI at http://localhost:8000
+npm run adk:run      # CLI runner
+```
+
+## Available Scripts
+
+- `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          # Agent configuration
+tests/
+└── agents.test.ts    # Agent tests
+```
+
+## Learn More
+
+- **[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/_gitignore

@@ -0,0 +1,8 @@
+node_modules
+dist
+.env
+.env.local
+*.log
+.DS_Store
+coverage
+.adk

package/templates/basic/jest.config.ts

@@ -0,0 +1,8 @@
+export default {
+  preset: 'ts-jest/presets/default-esm',
+  testEnvironment: 'node',
+  extensionsToTreatAsEsm: ['.ts'],
+  moduleNameMapper: {
+    '^(\\.{1,2}/.*)\\.js$': '$1',
+  },
+};

package/templates/basic/package.json

@@ -0,0 +1,43 @@
+{
+    "name": "__PROJECT_NAME__",
+    "version": "1.0.0",
+    "description": "__DESCRIPTION__",
+    "type": "module",
+    "main": "dist/index.js",
+    "scripts": {
+        "dev": "tsx watch src/index.ts",
+        "start": "tsx src/index.ts",
+        "build": "tsc",
+        "prod": "node dist/index.js",
+        "test": "jest",
+        "test:watch": "jest --watch",
+        "lint": "eslint src/**/*.ts",
+        "format": "prettier --write src/**/*.ts",
+        "adk:web": "adk web",
+        "adk:run": "adk run src/index.ts"
+    },
+    "keywords": [
+        "adk",
+        "agent",
+        "ai",
+        "llm"
+    ],
+    "license": "MIT",
+    "dependencies": {
+        "@google/adk": "^0.2.0",
+        "@google/adk-devtools": "^0.2.0",
+        "dotenv": "^16.4.0",
+        "zod": "^3.23.0"
+    },
+    "devDependencies": {
+        "@types/node": "^20.10.0",
+        "@typescript-eslint/eslint-plugin": "^7.0.0",
+        "@typescript-eslint/parser": "^7.0.0",
+        "eslint": "^8.56.0",
+        "jest": "^29.7.0",
+        "prettier": "^3.2.0",
+        "ts-jest": "^29.1.0",
+        "tsx": "^4.7.0",
+        "typescript": "^5.9.3"
+    }
+}

package/templates/basic/src/index.ts

@@ -0,0 +1,59 @@
+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 implementation */
+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`,
+    };
+  },
+});
+
+export const rootAgent = new LlmAgent({
+  name: 'hello_time_agent',
+  model: __MODEL_CONFIG__,
+  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],
+});
+
+// Run the agent (for direct execution)
+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) => {
+      console.log('Agent response:', response);
+    })
+    .catch((error) => {
+      console.error('Error:', error);
+      process.exit(1);
+    });
+}

package/templates/basic/tests/agents.test.ts

@@ -0,0 +1,19 @@
+import { describe, it, expect } from '@jest/globals';
+import { rootAgent } from '../src/index.js';
+
+describe('Time Agent', () => {
+  it('should have correct name', () => {
+    expect(rootAgent.name).toBe('hello_time_agent');
+  });
+
+  it('should have get_current_time tool', () => {
+    expect(rootAgent.tools).toHaveLength(1);
+    expect(rootAgent.tools[0].name).toBe('get_current_time');
+  });
+
+  it('should return time when queried', async () => {
+    const response = await rootAgent.query('What time is it?');
+    expect(response).toBeDefined();
+    expect(typeof response).toBe('string');
+  }, 30000);
+});

package/templates/basic/tsconfig.json

@@ -0,0 +1,21 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "NodeNext",
+    "moduleResolution": "NodeNext",
+    "lib": ["ES2022"],
+    "outDir": "./dist",
+    "rootDir": "./src",
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "forceConsistentCasingInFileNames": true,
+    "resolveJsonModule": true,
+    "declaration": true,
+    "declarationMap": true,
+    "sourceMap": true,
+    "verbatimModuleSyntax": false
+  },
+  "include": ["src/**/*"],
+  "exclude": ["node_modules", "dist", "tests"]
+}

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],
+});