create-adk-agent 0.0.1

package/README.md

@@ -0,0 +1,198 @@
+# @adk-ts-new/create-adk-agent
+
+> Nx generator for scaffolding ADK (Agent Development Kit) TypeScript projects with multiple templates, multi-model support, and modern tooling.
+
+## 🚀 Quick Start
+
+### Using npx (Recommended)
+
+```bash
+npx @adk-ts-new/create-adk-agent my-agent
+```
+
+### Using Nx workspace
+
+```bash
+nx g @adk-ts-new/create-adk-agent:init my-agent
+```
+
+## ✨ Features
+
+- 🤖 **Multiple Agent Templates** - Choose from 5 different agent templates from official ADK docs
+- 🔌 **Multi-Model Support** - Works with Gemini, OpenAI, and Anthropic models
+- ⚡ **tsx Development** - Instant TypeScript execution with hot reload (no build step)
+- 🔐 **Security First** - Built-in `.env` management with clear security warnings
+- 🧪 **Testing Ready** - Pre-configured Jest testing setup
+- 📦 **Modern Stack** - TypeScript, ESLint, Prettier, Zod validation
+
+## 📋 Agent Templates
+
+### Basic Agent
+
+Simple agent with time tool - perfect for learning ADK basics.
+
+### Multi-Tool Agent (Default)
+
+Agent with multiple tools (time, weather, calculator) demonstrating tool composition.
+
+### 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
+
+### Interactive Mode
+
+```bash
+npx @adk-ts-new/create-adk-agent my-agent
+```
+
+You'll be prompted for:
+
+- Agent templates to include
+- Model provider (Gemini/OpenAI/Anthropic)
+- Whether to install dependencies
+- Whether to initialize git
+
+### Non-Interactive Mode
+
+```bash
+npx @adk-ts-new/create-adk-agent my-agent \
+  --templates=basic,multi-tool \
+  --modelProvider=gemini \
+  --model=gemini-3.0-flash \
+  --description="My custom agent" \
+  --directory=apps \
+  --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.
+
+## 📦 Generated Project Structure
+
+```
+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:
+
+```bash
+cd my-agent
+
+# 1. Set up your API key
+cp .env.example .env
+# Edit .env and add your API key
+
+# 2. Install dependencies (if not done during generation)
+npm install
+
+# 3. Start development with hot reload
+npm run dev
+
+# 4. Run tests
+npm test
+
+# 5. Use ADK DevTools
+npm run adk:web    # 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
+
+Contributions welcome! This is an Nx workspace project.
+
+### Development
+
+```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
+```
+
+## 📄 License
+
+MIT © Maina Wycliffe

package/dist/generators/init/generator.js

@@ -0,0 +1,87 @@
+import { _ as _extends } from "@swc/helpers/_/_extends";
+import { formatFiles, generateFiles, installPackagesTask, joinPathFragments, names } from '@nx/devkit';
+import * as path from 'path';
+// Model options based on provider
+// Note: Users can change to any model in their generated project
+// This list is just for initial selection during project creation
+const MODEL_OPTIONS = {
+    gemini: [
+        'gemini-3.0-flash',
+        'gemini-3.0-pro',
+        'gemini-2.5-flash',
+        'gemini-2.5-pro'
+    ],
+    openai: [
+        'gpt-5',
+        'gpt-5-mini',
+        'gpt-4o',
+        'gpt-4o-mini'
+    ],
+    anthropic: [
+        'claude-4.5-sonnet',
+        'claude-4-sonnet',
+        'claude-4-opus',
+        'claude-3-5-sonnet'
+    ],
+    custom: []
+};
+export async function initGenerator(tree, options) {
+    const projectRoot = options.directory ? joinPathFragments(options.directory, options.name) : options.name;
+    // Set default templates if none selected
+    if (!options.templates || options.templates.length === 0) {
+        options.templates = [
+            'multi-tool'
+        ];
+    }
+    // Set default model provider
+    if (!options.modelProvider) {
+        options.modelProvider = 'gemini';
+    }
+    // Set default model based on provider
+    if (!options.model) {
+        var _MODEL_OPTIONS_provider;
+        const provider = options.modelProvider;
+        options.model = ((_MODEL_OPTIONS_provider = MODEL_OPTIONS[provider]) == null ? void 0 : _MODEL_OPTIONS_provider[0]) || 'gemini-3.0-flash';
+    }
+    // Generate project files
+    const substitutions = _extends({}, names(options.name), {
+        projectName: options.name,
+        description: options.description || 'My ADK Agent',
+        modelProvider: options.modelProvider,
+        model: options.model,
+        templates: options.templates,
+        hasBasic: options.templates.includes('basic'),
+        hasMultiTool: options.templates.includes('multi-tool'),
+        hasTeam: options.templates.includes('team'),
+        hasStreaming: options.templates.includes('streaming'),
+        hasWorkflow: options.templates.includes('workflow'),
+        tmpl: ''
+    });
+    generateFiles(tree, path.join(__dirname, 'files'), projectRoot, substitutions);
+    // Format files
+    await formatFiles(tree);
+    // Print success message
+    console.log(`
+✅ ADK Agent project created successfully!
+
+📁 Project: ${projectRoot}
+🤖 Model: ${options.model}
+📦 Templates: ${options.templates.join(', ')}
+
+🚀 Next steps:
+  1. cd ${projectRoot}
+  2. Copy .env.example to .env and add your API key
+  3. npm install${options.installDependencies ? ' (running now...)' : ''}
+  4. npm run dev
+
+📚 Documentation: https://google.github.io/adk-docs/
+`);
+    // Return task for dependency installation if requested
+    if (options.installDependencies) {
+        return installPackagesTask(tree);
+    }
+    return ()=>{};
+}
+export default initGenerator;
+
+//# sourceMappingURL=generator.js.map

package/dist/generators/init/generator.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/generators/init/generator.ts"],"sourcesContent":["import {\n  Tree,\n  formatFiles,\n  generateFiles,\n  installPackagesTask,\n  joinPathFragments,\n  names,\n} from '@nx/devkit';\nimport * as path from 'path';\nimport { InitGeneratorSchema } from './schema.js';\n\n// Model options based on provider\n// Note: Users can change to any model in their generated project\n// This list is just for initial selection during project creation\nconst MODEL_OPTIONS = {\n  gemini: [\n    'gemini-3.0-flash',\n    'gemini-3.0-pro',\n    'gemini-2.5-flash',\n    'gemini-2.5-pro',\n  ],\n  openai: ['gpt-5', 'gpt-5-mini', 'gpt-4o', 'gpt-4o-mini'],\n  anthropic: [\n    'claude-4.5-sonnet',\n    'claude-4-sonnet',\n    'claude-4-opus',\n    'claude-3-5-sonnet',\n  ],\n  custom: [],\n};\n\nexport async function initGenerator(tree: Tree, options: InitGeneratorSchema) {\n  const projectRoot = options.directory\n    ? joinPathFragments(options.directory, options.name)\n    : options.name;\n\n  // Set default templates if none selected\n  if (!options.templates || options.templates.length === 0) {\n    options.templates = ['multi-tool'];\n  }\n\n  // Set default model provider\n  if (!options.modelProvider) {\n    options.modelProvider = 'gemini';\n  }\n\n  // Set default model based on provider\n  if (!options.model) {\n    const provider = options.modelProvider as keyof typeof MODEL_OPTIONS;\n    options.model = MODEL_OPTIONS[provider]?.[0] || 'gemini-3.0-flash';\n  }\n\n  // Generate project files\n  const substitutions = {\n    ...names(options.name),\n    projectName: options.name,\n    description: options.description || 'My ADK Agent',\n    modelProvider: options.modelProvider,\n    model: options.model,\n    templates: options.templates,\n    hasBasic: options.templates.includes('basic'),\n    hasMultiTool: options.templates.includes('multi-tool'),\n    hasTeam: options.templates.includes('team'),\n    hasStreaming: options.templates.includes('streaming'),\n    hasWorkflow: options.templates.includes('workflow'),\n    tmpl: '',\n  };\n\n  generateFiles(\n    tree,\n    path.join(__dirname, 'files'),\n    projectRoot,\n    substitutions,\n  );\n\n  // Format files\n  await formatFiles(tree);\n\n  // Print success message\n  console.log(`\n✅ ADK Agent project created successfully!\n\n📁 Project: ${projectRoot}\n🤖 Model: ${options.model}\n📦 Templates: ${options.templates.join(', ')}\n\n🚀 Next steps:\n  1. cd ${projectRoot}\n  2. Copy .env.example to .env and add your API key\n  3. npm install${options.installDependencies ? ' (running now...)' : ''}\n  4. npm run dev\n\n📚 Documentation: https://google.github.io/adk-docs/\n`);\n\n  // Return task for dependency installation if requested\n  if (options.installDependencies) {\n    return installPackagesTask(tree);\n  }\n\n  return () => {};\n}\n\nexport default initGenerator;\n"],"names":["formatFiles","generateFiles","installPackagesTask","joinPathFragments","names","path","MODEL_OPTIONS","gemini","openai","anthropic","custom","initGenerator","tree","options","projectRoot","directory","name","templates","length","modelProvider","model","provider","substitutions","projectName","description","hasBasic","includes","hasMultiTool","hasTeam","hasStreaming","hasWorkflow","tmpl","join","__dirname","console","log","installDependencies"],"rangeMappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;","mappings":";AAAA,SAEEA,WAAW,EACXC,aAAa,EACbC,mBAAmB,EACnBC,iBAAiB,EACjBC,KAAK,QACA,aAAa;AACpB,YAAYC,UAAU,OAAO;AAG7B,kCAAkC;AAClC,iEAAiE;AACjE,kEAAkE;AAClE,MAAMC,gBAAgB;IACpBC,QAAQ;QACN;QACA;QACA;QACA;KACD;IACDC,QAAQ;QAAC;QAAS;QAAc;QAAU;KAAc;IACxDC,WAAW;QACT;QACA;QACA;QACA;KACD;IACDC,QAAQ,EAAE;AACZ;AAEA,OAAO,eAAeC,cAAcC,IAAU,EAAEC,OAA4B;IAC1E,MAAMC,cAAcD,QAAQE,SAAS,GACjCZ,kBAAkBU,QAAQE,SAAS,EAAEF,QAAQG,IAAI,IACjDH,QAAQG,IAAI;IAEhB,yCAAyC;IACzC,IAAI,CAACH,QAAQI,SAAS,IAAIJ,QAAQI,SAAS,CAACC,MAAM,KAAK,GAAG;QACxDL,QAAQI,SAAS,GAAG;YAAC;SAAa;IACpC;IAEA,6BAA6B;IAC7B,IAAI,CAACJ,QAAQM,aAAa,EAAE;QAC1BN,QAAQM,aAAa,GAAG;IAC1B;IAEA,sCAAsC;IACtC,IAAI,CAACN,QAAQO,KAAK,EAAE;YAEFd;QADhB,MAAMe,WAAWR,QAAQM,aAAa;QACtCN,QAAQO,KAAK,GAAGd,EAAAA,0BAAAA,aAAa,CAACe,SAAS,qBAAvBf,uBAAyB,CAAC,EAAE,KAAI;IAClD;IAEA,yBAAyB;IACzB,MAAMgB,gBAAgB,aACjBlB,MAAMS,QAAQG,IAAI;QACrBO,aAAaV,QAAQG,IAAI;QACzBQ,aAAaX,QAAQW,WAAW,IAAI;QACpCL,eAAeN,QAAQM,aAAa;QACpCC,OAAOP,QAAQO,KAAK;QACpBH,WAAWJ,QAAQI,SAAS;QAC5BQ,UAAUZ,QAAQI,SAAS,CAACS,QAAQ,CAAC;QACrCC,cAAcd,QAAQI,SAAS,CAACS,QAAQ,CAAC;QACzCE,SAASf,QAAQI,SAAS,CAACS,QAAQ,CAAC;QACpCG,cAAchB,QAAQI,SAAS,CAACS,QAAQ,CAAC;QACzCI,aAAajB,QAAQI,SAAS,CAACS,QAAQ,CAAC;QACxCK,MAAM;;IAGR9B,cACEW,MACAP,KAAK2B,IAAI,CAACC,WAAW,UACrBnB,aACAQ;IAGF,eAAe;IACf,MAAMtB,YAAYY;IAElB,wBAAwB;IACxBsB,QAAQC,GAAG,CAAC,CAAC;;;YAGH,EAAErB,YAAY;UAChB,EAAED,QAAQO,KAAK,CAAC;cACZ,EAAEP,QAAQI,SAAS,CAACe,IAAI,CAAC,MAAM;;;QAGrC,EAAElB,YAAY;;gBAEN,EAAED,QAAQuB,mBAAmB,GAAG,sBAAsB,GAAG;;;;AAIzE,CAAC;IAEC,uDAAuD;IACvD,IAAIvB,QAAQuB,mBAAmB,EAAE;QAC/B,OAAOlC,oBAAoBU;IAC7B;IAEA,OAAO,KAAO;AAChB;AAEA,eAAeD,cAAc"}

package/dist/generators/init/schema.d.js

@@ -0,0 +1,3 @@
+export { };
+
+//# sourceMappingURL=schema.d.js.map

package/dist/generators/init/schema.d.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/generators/init/schema.d.ts"],"sourcesContent":["export interface InitGeneratorSchema {\n  name: string;\n  directory?: string;\n  description?: string;\n  templates?: Array<'basic' | 'multi-tool' | 'team' | 'streaming' | 'workflow'>;\n  modelProvider?: 'gemini' | 'openai' | 'anthropic' | 'custom';\n  model?: string;\n  installDependencies?: boolean;\n  initGit?: boolean;\n}\n"],"names":[],"rangeMappings":"","mappings":"AAAA,WASC"}

package/dist/index.js

@@ -0,0 +1,3 @@
+export * from './lib/create-adk-agent.js';
+
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["export * from './lib/create-adk-agent.js';\n"],"names":[],"rangeMappings":"","mappings":"AAAA,cAAc,4BAA4B"}

package/dist/lib/create-adk-agent.js

@@ -0,0 +1,5 @@
+export function createAdkAgent() {
+    return 'create-adk-agent';
+}
+
+//# sourceMappingURL=create-adk-agent.js.map

package/dist/lib/create-adk-agent.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/lib/create-adk-agent.ts"],"sourcesContent":["export function createAdkAgent(): string {\n  return 'create-adk-agent';\n}\n"],"names":["createAdkAgent"],"rangeMappings":";;","mappings":"AAAA,OAAO,SAASA;IACd,OAAO;AACT"}

package/generators.json

@@ -0,0 +1,10 @@
+{
+    "$schema": "http://json-schema.org/schema",
+    "generators": {
+        "init": {
+            "factory": "./src/generators/init/generator",
+            "schema": "./src/generators/init/schema.json",
+            "description": "Initialize an ADK TypeScript agent project"
+        }
+    }
+}

package/package.json

@@ -0,0 +1,73 @@
+{
+  "name": "create-adk-agent",
+  "version": "0.0.1",
+  "description": "Nx generator for scaffolding ADK (Agent Development Kit) TypeScript projects with multiple templates, multi-model support, and modern tooling",
+  "keywords": [
+    "adk",
+    "agent",
+    "ai",
+    "llm",
+    "gemini",
+    "openai",
+    "anthropic",
+    "typescript",
+    "nx",
+    "generator",
+    "scaffold",
+    "template"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/mainawycliffe/adk-ts-new"
+  },
+  "author": "Maina Wycliffe",
+  "license": "MIT",
+  "type": "module",
+  "scripts": {
+    "prepublishOnly": "nx build create-adk-agent",
+    "publish:dry-run": "npm publish --dry-run",
+    "publish:npm": "npm publish --access public"
+  },
+  "generators": "./generators.json",
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    "./package.json": "./package.json",
+    ".": {
+      "@adk-ts-new/source": "./src/index.ts",
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "generators.json",
+    "src/generators/**/files/**",
+    "src/generators/**/schema.json",
+    "!**/*.tsbuildinfo"
+  ],
+  "nx": {
+    "sourceRoot": "packages/create-adk-agent/src",
+    "targets": {
+      "build": {
+        "executor": "@nx/js:swc",
+        "outputs": [
+          "{options.outputPath}"
+        ],
+        "options": {
+          "outputPath": "packages/create-adk-agent/dist",
+          "main": "packages/create-adk-agent/src/index.ts",
+          "tsConfig": "packages/create-adk-agent/tsconfig.lib.json",
+          "skipTypeCheck": true,
+          "stripLeadingPaths": true
+        }
+      }
+    }
+  },
+  "dependencies": {
+    "@nx/devkit": "^22.3.3",
+    "@swc/helpers": "~0.5.11"
+  }
+}

package/src/generators/init/files/.env.example.template

@@ -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/src/generators/init/files/.eslintrc.json.template

@@ -0,0 +1,20 @@
+{
+  "parser": "@typescript-eslint/parser",
+  "extends": [
+    "eslint:recommended",
+    "plugin:@typescript-eslint/recommended"
+  ],
+  "plugins": ["@typescript-eslint"],
+  "env": {
+    "node": true,
+    "es2022": true
+  },
+  "parserOptions": {
+    "ecmaVersion": 2022,
+    "sourceType": "module"
+  },
+  "rules": {
+    "@typescript-eslint/no-unused-vars": ["warn", { "argsIgnorePattern": "^_" }],
+    "@typescript-eslint/no-explicit-any": "warn"
+  }
+}

package/src/generators/init/files/.gitignore.template

@@ -0,0 +1,27 @@
+# Environment files - NEVER commit these!
+.env
+.env.local
+.env*.local
+
+# Dependencies
+node_modules/
+
+# Build output
+dist/
+
+# IDE
+.vscode/
+.idea/
+
+# OS
+.DS_Store
+Thumbs.db
+
+# Test coverage
+coverage/
+
+# Logs
+*.log
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*

package/src/generators/init/files/.prettierrc.template

@@ -0,0 +1,7 @@
+{
+  "semi": true,
+  "trailingComma": "es5",
+  "singleQuote": true,
+  "printWidth": 80,
+  "tabWidth": 2
+}