generator-agent 1.0.9 → 1.0.11

package/.github/agents/{Generators.agent.md → Generator.agent.md}

@@ -1,5 +1,5 @@
 ---
-name: Generator creation agent
+name: GeneratorAgent
 description: Creates generators using the OpenAPI specification and defined generator patterns. Ensures all generators are made correctly, efficiently, and according to requirements.
 ---
 
@@ -12,20 +12,19 @@ Responsible for building generators that follow strict rules and guidelines base
 
 1. Read all generator type definitions in the Generator_Patterns folder to understand their rules and structures, then use them to create generators based on the OAS file’s schema and dependencies.
 
-2. Analyze the user prompt to identify all dependencies needed for generator creation. Determine which values from dependent operations are required by the target operation.
+2. Analyze the user prompt to identify only the dependencies explicitly requested by the user. Do not add extra setup dependencies on your own.
 
-3. Ensure that dependency generators extract the required values from their API responses so downstream generators can consume them clearly and correctly.
+3. For user-requested dependencies, ensure generators extract the required values from API responses so downstream generators can consume them clearly and correctly.
 
 4. Always create a new generator file instead of modifying existing ones. If you need to modify or add to an existing generator, request explicit user permission before proceeding.
 
 5. Refer to the `PathConfig.properties` file to find the paths for OAS files and existing generator files. Always use these paths when reading or referencing OAS or generator files.
 
-6. Always read the OpenAPI Specification (OAS) for the target operation before creating a generator, and extract only required schema/dependency details.
+6. Use only the dependencies explicitly provided in the user prompt. Do not include every parameter listed in the OAS, and do not auto-create additional dependency generators unless the user explicitly asks.
 
-7. Use only parameters explicitly defined in that OAS operation (body, query, path, header). Never invent fields, wrapper keys, or placeholders. If required schema details are missing, ask the user instead of assuming.
-
-8.  You may use tools if necessary to generate the generators correctly.
+7.  Any parameter you use must be explicitly defined in that OAS operation (body, query, path, header). Never invent fields, wrapper keys, or placeholders. Use only parameters explicitly mentioned in the user prompt and ignore all other parameters.
 
+8. You may use tools if necessary to generate the generators correctly.
 ---
 
 ## Generator
@@ -52,6 +51,10 @@ Responsible for building generators that follow strict rules and guidelines base
 
 11. If you use param input from body, query, path or header, please make sure the reference path is correct and the field exists in the OpenAPI specification. For example: "$.input.body:$.ticketId" for request body, "$.input.query:$.status" for query parameter, "$.input.path:$.agentId" for path parameter, "$.input.header:$.Authorization" for header.
 
+12. If the same API with the same payload is needed more than once, call that API only once, store the entire response object, and extract all required values from that stored response.
+
+13. When storing an entire object in a generator, the `dataPath` must use the `:$` format (for example: `$.response.body:$`).
+
 ---
 
 ## Generator Structure Rule
@@ -75,9 +78,27 @@ All generators must be created using the following structure:
 
 ## Generator Creation Rules
 
-1. When creating a new generator file for different resources, always create a separate subfolder with the specified name inside the Created_Generators directory. Inside that subfolder, create a file named test_data_generation_configurations.json.
+1. Create subfolder with PascalCase name (e.g., `CreateContact`, `CreateTicket`) in `Created_Generators` directory, add `test_data_generation_configurations.json` inside.
+
+2. Only create the generator JSON file.
+
+3. Always create new generator files instead of modifying existing ones. Request explicit permission before editing existing generators.
+
+---
+
+## Prompt Handling Rules
+
+1. **Direct Prompt**: When user provides a direct prompt (e.g., "Create Contact", "Create Ticket"), implement the generator immediately without preamble like "Create generator for X".
+
+2. **Explicit Request**: When user explicitly says "Create a generator for X" or similar, proceed as normal with full context.
+
+3. **Skip Explanation**: For direct prompts, go straight to building the generator, no explanations.
 
-2. Always create a new generator file instead of modifying existing ones. If you need to edit or add to an existing generator file, request explicit permission and follow the instructions from the user responsible for that file.
+4. **Clarify Ambiguity First**: If there is any confusion about which generator to use, which data to extract, or how required values should be sourced, ask the user first and generate only after confirmation.
+
+5. **No Implicit Body Defaults**: For implied actions (for example, "add comments"), do not auto-fill request body fields that were not provided in the prompt. Ask the user for missing values first.
+
+6. **Optional Param Choice**: In ambiguous enum/choice situations, ask the user with available options and include one extra option: **"Don't consider this param"**. If the user selects it, omit that parameter from the generator.
 
 ---
 
@@ -93,6 +114,8 @@ All generators must be created using the following structure:
 
 5. Never include any param or field in a generator unless it is explicitly defined in the OAS for that operation.
 
-6. Don't ask permission for read access to OAS or generator files, as you have full access to read any file in the specified paths.You have permission to read files outside of the workspace.
+6. Don't auto-add setup generators (for example Contact/Department/Account) unless those dependencies are explicitly requested by the user.
+
+7. Don't ask permission for read access to OAS or generator files, as you have full access to read any file in the specified paths.You have permission to read files outside of the workspace.
 
-7. Don't give text response in chat window.Only output the generator JSON object as specified.
+8. Don't give text response in chat window.Only output the generator JSON object as specified.

package/Generator_Patterns/Dynamic.md

@@ -51,7 +51,7 @@ A DYNAMIC Generator fetches data from real API responses.
 | Property | Type | Purpose |
 |----------|------|---------|
 | `params` | object | Filter parameters: `{"status": "ACTIVE"}` |
-| `name` | string | Generator identifier |
+| `name` | string | Generator identifier (unique label for referencing in params) |
 
 ---
 

package/README.md

@@ -1,65 +1,31 @@
-# generator README
+# AgentPublishTest - VS Code Extension
 
-This is the README for your extension "generator". After writing up a brief description, we recommend including the following sections.
+A powerful VS Code extension that integrates custom AI agents with multiple UI interfaces - dropdown selection, chat panel, and command palette.
 
 ## Features
 
-Describe specific features of your extension including screenshots of your extension in action. Image paths are relative to this README file.
+✅ **QuickPick Dropdown** - Select agents like Copilot dropdown  
+✅ **Chat Panel** - Chat-style interface for agent interaction  
+✅ **Command Palette** - Run agents from command palette  
+✅ **npm Package Integration** - Install agents via npm  
+✅ **Agent Instructions** - Follow agent rules from `.github/agents/`
 
-For example if there is an image subfolder under your extension project workspace:
+## Installation
 
-\!\[feature X\]\(images/feature-x.png\)
+### Option 1: Direct Installation (Recommended)
 
-> Tip: Many popular extensions utilize animations. This is an excellent way to show off your extension! We recommend short, focused animations that are easy to follow.
+#### To install the latest version, run:
 
-## Requirements
+```bash
+npm install agentpublishtest@latest
+npx agentpublish init
 
-If you have any requirements or dependencies, add a section describing those and how to install and configure them.
+**Agents not appearing in dropdown?**
+- Make sure agents are in `.github/agents/` folder
+- Check file extension is `.agent.md`
+- Reload VS Code window after adding agents
 
-## Extension Settings
+### Supported
 
-Include if your extension adds any VS Code settings through the `contributes.configuration` extension point.
-
-For example:
-
-This extension contributes the following settings:
-
-* `myExtension.enable`: Enable/disable this extension.
-* `myExtension.thing`: Set to `blah` to do something.
-
-## Known Issues
-
-Calling out known issues can help limit users opening duplicate issues against your extension.
-
-## Release Notes
-
-Users appreciate release notes as you update your extension.
-
-### 1.0.0
-
-Initial release of ...
-
-### 1.0.1
-
-Fixed issue #.
-
-### 1.1.0
-
-Added features X, Y, and Z.
-
----
-
-## Working with Markdown
-
-You can author your README using Visual Studio Code.  Here are some useful editor keyboard shortcuts:
-
-* Split the editor (`Cmd+\` on macOS or `Ctrl+\` on Windows and Linux)
-* Toggle preview (`Shift+Cmd+V` on macOS or `Shift+Ctrl+V` on Windows and Linux)
-* Press `Ctrl+Space` (Windows, Linux, macOS) to see a list of Markdown snippets
-
-## For more information
-
-* [Visual Studio Code's Markdown Support](http://code.visualstudio.com/docs/languages/markdown)
-* [Markdown Syntax Reference](https://help.github.com/articles/markdown-basics/)
-
-**Enjoy!**
+For issues and feature requests, visit:  
+[GitHub Issues](https://github.com/ishwaryaramesh200-byte/AgentPublishTest/issues)

package/bin/cli.js

@@ -0,0 +1,127 @@
+#!/usr/bin/env node
+
+const fs = require('fs');
+const path = require('path');
+const { runInstall } = require('./install');
+
+// Color codes for terminal output
+const colors = {
+    reset: '\x1b[0m',
+    bright: '\x1b[1m',
+    cyan: '\x1b[36m',
+    green: '\x1b[32m',
+    yellow: '\x1b[33m',
+    magenta: '\x1b[35m',
+};
+
+function log(message, color = 'reset') {
+    console.log(`${colors[color]}${message}${colors.reset}`);
+}
+
+// Function to load agents from workspace
+function loadAgents() {
+    const agents = [];
+    const cwd = process.cwd();
+    const nodeModulesPath = path.join(cwd, 'node_modules');
+
+    if (!fs.existsSync(nodeModulesPath)) {
+        return agents;
+    }
+
+    try {
+        const modules = fs.readdirSync(nodeModulesPath);
+        
+        modules.forEach(module => {
+            const agentPath = path.join(nodeModulesPath, module, '.github', 'agents');
+            
+            if (fs.existsSync(agentPath)) {
+                try {
+                    const files = fs.readdirSync(agentPath);
+                    files.forEach(file => {
+                        if (file.endsWith('.agent.md')) {
+                            const agentName = file.replace('.agent.md', '');
+                            const agentFilePath = path.join(agentPath, file);
+                            const content = fs.readFileSync(agentFilePath, 'utf-8');
+                            
+                            agents.push({
+                                name: agentName,
+                                module: module,
+                                path: agentFilePath,
+                                content: content
+                            });
+                        }
+                    });
+                } catch (err) {
+                    // Silent fail for unreadable modules
+                }
+            }
+        });
+    } catch (err) {
+        log('Error reading node_modules', 'yellow');
+    }
+
+    return agents;
+}
+
+// Display agent list
+function displayAgents(agents) {
+    if (agents.length === 0) {
+        log('\n⚠️  No agents found!', 'yellow');
+        log('Install agents using: npm install agentpublishtest', 'cyan');
+        return;
+    }
+
+    log('\n' + '='.repeat(60), 'cyan');
+    log('🤖 INSTALLED AGENTS', 'bright');
+    log('='.repeat(60), 'cyan');
+
+    agents.forEach((agent, index) => {
+        log(`\n${index + 1}. ${agent.name}`, 'green');
+        log(`   📦 Package: ${agent.module}`, 'magenta');
+        log(`   📁 Path: ${agent.path}`, 'magenta');
+        
+        // Parse agent description from markdown
+        const descMatch = agent.content.match(/description:\s*'([^']+)'/);
+        if (descMatch) {
+            log(`   📝 ${descMatch[1]}`, 'cyan');
+        }
+    });
+
+    log('\n' + '='.repeat(60), 'cyan');
+    log(`Total: ${agents.length} agent(s) found\n`, 'bright');
+}
+
+// Main function
+function main() {
+    const args = process.argv.slice(2);
+    const command = args[0];
+
+    if (command === '--help' || command === '-h') {
+        log('\nAgent Publisher CLI\n', 'bright');
+        log('Usage: agentpublish [command]\n', 'cyan');
+        log('Commands:', 'green');
+        log('  list           List all installed agents (default)');
+        log('  init           Copy .github and Generator_Patterns to project root');
+        log('  --version      Show version');
+        log('  --help         Show this help message\n');
+        return;
+    }
+
+    if (command === '--version' || command === '-v') {
+        const packageJson = require('../package.json');
+        log(`agentpublish v${packageJson.version}\n`);
+        return;
+    }
+
+    if (command === 'init') {
+        runInstall(process.cwd());
+        log('✅ Copied files to project root.', 'green');
+        return;
+    }
+
+    // Default: list agents
+    const agents = loadAgents();
+    displayAgents(agents);
+}
+
+main();

package/bin/install.js

@@ -0,0 +1,59 @@
+#!/usr/bin/env node
+
+const fs = require('fs');
+const path = require('path');
+
+function copyRecursive(src, dest) {
+    if (!fs.existsSync(src)) return;
+    const stats = fs.statSync(src);
+    if (stats.isDirectory()) {
+        fs.mkdirSync(dest, { recursive: true });
+        const entries = fs.readdirSync(src);
+        entries.forEach(entry => {
+            copyRecursive(path.join(src, entry), path.join(dest, entry));
+        });
+    } else {
+        fs.mkdirSync(path.dirname(dest), { recursive: true });
+        fs.copyFileSync(src, dest);
+    }
+}
+
+function runInstall(targetRoot = process.cwd()) {
+    const pkgRoot = path.resolve(__dirname, '..');
+
+    const foldersToCopy = ['.github', 'Generator_Patterns', 'Created_Generators'];
+    const filesToCopy = ['README.md'];
+
+    foldersToCopy.forEach(folder => {
+        const src = path.join(pkgRoot, folder);
+        const dest = path.join(targetRoot, folder);
+        copyRecursive(src, dest);
+    });
+
+    filesToCopy.forEach(file => {
+        const src = path.join(pkgRoot, file);
+        const dest = path.join(targetRoot, file);
+        if (fs.existsSync(src)) {
+            fs.copyFileSync(src, dest);
+        }
+    });
+
+    // Delete the entire generatoragent package from node_modules after copying
+    try {
+        const nodeModulesPath = path.join(targetRoot, 'node_modules', 'generatoragent');
+        if (fs.existsSync(nodeModulesPath)) {
+            fs.rmSync(nodeModulesPath, { recursive: true, force: true });
+        }
+    } catch (err) {
+        console.log('Note: Could not remove generatoragent from node_modules:', err.message);
+    }
+
+    // eslint-disable-next-line no-console
+    console.log('GeneratorAgent: Copied .github, Generator_Patterns, and Created_Generators to project root. Package removed from node_modules.');
+}
+
+if (require.main === module) {
+    runInstall();
+}
+
+module.exports = { runInstall };

package/package.json

@@ -1,34 +1,72 @@
 {
   "name": "generator-agent",
-  "displayName": "Generator-Agent",
-  "description": "Create a generator for given use case",
-  "version": "1.0.9",
+  "displayName": "GeneratorAgent",
+  "description": "Custom agent that responds with greetings and follows specific instructions",
+  "version": "1.0.11",
+  "publisher": "Ishwarya",
+  "author": "Ishwarya",
+  "license": "MIT",
+  "bin": {
+    "generatoragent": "bin/cli.js"
+  },
+  "files": [
+    ".github",
+    "bin",
+    "README.md",
+    "Generator_Patterns",
+    "Created_Generators"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/ishwaryaramesh200-byte/AgentPublishTest.git"
+  },
+  "keywords": [
+    "agent",
+    "copilot",
+    "vscode",
+    "vs-code-extension",
+    "ai",
+    "automation"
+  ],
+  "homepage": "https://github.com/ishwaryaramesh200-byte/AgentPublishTest#readme",
+  "bugs": {
+    "url": "https://github.com/ishwaryaramesh200-byte/AgentPublishTest/issues"
+  },
   "engines": {
     "vscode": "^1.109.0"
   },
   "categories": [
-    "Other"
+    "Other",
+    "AI"
+  ],
+  "activationEvents": [
+    "onCommand:my-agent.selectAgent",
+    "onCommand:my-agent.openChatPanel",
+    "onCommand:my-agent.runFromPalette"
   ],
-  "activationEvents": [],
   "main": "./extension.js",
   "contributes": {
     "commands": [
       {
-        "command": "generator.createGenerator",
-        "title": "Generator: Create New Generator"
+        "command": "my-agent.selectAgent",
+        "title": "Select Agent (Dropdown)"
+      },
+      {
+        "command": "my-agent.openChatPanel",
+        "title": "Open Agent Chat Panel"
       },
       {
-        "command": "generator.viewPatterns",
-        "title": "Generator: View Generator Patterns"
+        "command": "my-agent.runFromPalette",
+        "title": "Run Agent from Command Palette"
       }
     ]
   },
   "scripts": {
+    "postinstall": "node bin/install.js",
     "lint": "eslint .",
     "pretest": "npm run lint",
     "test": "vscode-test"
   },
-  "publish": "npm publish --access public",
   "devDependencies": {
     "@types/vscode": "^1.109.0",
     "@types/mocha": "^10.0.10",

package/.vscode/extensions.json

@@ -1,8 +0,0 @@
-{
-	// See https://go.microsoft.com/fwlink/?LinkId=733558
-	// for the documentation about the extensions.json format
-	"recommendations": [
-		"dbaeumer.vscode-eslint",
-		"ms-vscode.extension-test-runner"
-	]
-}

package/.vscode/launch.json

@@ -1,17 +0,0 @@
-// A launch configuration that launches the extension inside a new window
-// Use IntelliSense to learn about possible attributes.
-// Hover to view descriptions of existing attributes.
-// For more information, visit: https://go.microsoft.com/fwlink/?linkid=830387
-{
-	"version": "0.2.0",
-	"configurations": [
-		{
-			"name": "Run Extension",
-			"type": "extensionHost",
-			"request": "launch",
-			"args": [
-				"--extensionDevelopmentPath=${workspaceFolder}"
-			]
-		}
-	]
-}

package/.vscode-test.mjs

@@ -1,5 +0,0 @@
-import { defineConfig } from '@vscode/test-cli';
-
-export default defineConfig({
-	files: 'test/**/*.test.js',
-});

package/.vscodeignore

@@ -1,10 +0,0 @@
-.vscode/**
-.vscode-test/**
-test/**
-.gitignore
-.yarnrc
-vsc-extension-quickstart.md
-**/jsconfig.json
-**/*.map
-**/eslint.config.mjs
-**/.vscode-test.*

package/CHANGELOG.md

@@ -1,9 +0,0 @@
-# Change Log
-
-All notable changes to the "generator" extension will be documented in this file.
-
-Check [Keep a Changelog](http://keepachangelog.com/) for recommendations on how to structure this file.
-
-## [Unreleased]
-
-- Initial release

package/eslint.config.mjs

@@ -1,25 +0,0 @@
-import globals from "globals";
-
-export default [{
-    files: ["**/*.js"],
-    languageOptions: {
-        globals: {
-            ...globals.commonjs,
-            ...globals.node,
-            ...globals.mocha,
-        },
-
-        ecmaVersion: 2022,
-        sourceType: "module",
-    },
-
-    rules: {
-        "no-const-assign": "warn",
-        "no-this-before-super": "warn",
-        "no-undef": "warn",
-        "no-unreachable": "warn",
-        "no-unused-vars": "warn",
-        "constructor-super": "warn",
-        "valid-typeof": "warn",
-    },
-}];

package/extension.js

@@ -1,123 +0,0 @@
-// The module 'vscode' contains the VS Code extensibility API
-// Import the module and reference it with the alias vscode in your code below
-const vscode = require('vscode');
-const fs = require('fs');
-const path = require('path');
-
-// This method is called when your extension is activated
-// Your extension is activated the very first time the command is executed
-
-/**
- * @param {vscode.ExtensionContext} context
- */
-function activate(context) {
-
-	// Use the console to output diagnostic information (console.log) and errors (console.error)
-	// This line of code will only be executed once when your extension is activated
-	console.log('Generator Agent is now active!');
-
-	// Register the main generator creation command
-	const createGenerator = vscode.commands.registerCommand('generator.createGenerator', async function () {
-		// Show input box to get user's generator requirements
-		const userPrompt = await vscode.window.showInputBox({
-			prompt: 'Describe the generator you want to create (e.g., "Create a ticket generator with department dependency")',
-			placeHolder: 'Enter generator requirements...'
-		});
-
-		if (!userPrompt) {
-			vscode.window.showWarningMessage('Generator creation cancelled - no input provided');
-			return;
-		}
-
-		// Get workspace folder
-		const workspaceFolder = vscode.workspace.workspaceFolders?.[0];
-		if (!workspaceFolder) {
-			vscode.window.showErrorMessage('No workspace folder open. Please open a workspace first.');
-			return;
-		}
-
-		// Show information about what the agent will do
-		vscode.window.showInformationMessage('Generator Agent: Analyzing your request and creating generator...');
-
-		// Call Copilot agent to generate the generator
-		await vscode.window.withProgress({
-			location: vscode.ProgressLocation.Notification,
-			title: "Creating Generator...",
-			cancellable: false
-		}, async (progress) => {
-			progress.report({ increment: 0, message: "Reading generator patterns..." });
-			
-			try {
-				// Get paths from extension
-				const extensionPath = context.extensionPath;
-				const generatorPatternsPath = path.join(extensionPath, 'Generator_Patterns');
-				const sourcePath = path.join(extensionPath, 'source');
-				
-				// Construct the prompt for GitHub Copilot
-				const agentPrompt = `
-You are the Generator creation agent. Your role is to create generators following strict rules based on OpenAPI specifications and generator patterns.
-
-User Request: ${userPrompt}
-
-Instructions:
-1. Read the generator type definitions from the Generator_Patterns folder at: ${generatorPatternsPath}
-2. Analyze the OAS files from: ${sourcePath}/openapi-specifications/
-3. Create appropriate generators following the rules in the agent definition
-4. Output ONLY the generators JSON object
-5. Follow snake_case naming convention
-6. Ensure proper dependency ordering
-7. Use only fields defined in OAS
-
-Create the generator configuration and save it to the appropriate location in the workspace.
-				`;
-
-				progress.report({ increment: 50, message: "Generating configuration..." });
-
-				// Open a new untitled document for the user to see the generated content
-				const doc = await vscode.workspace.openTextDocument({
-					content: JSON.stringify({ generators: {} }, null, 2),
-					language: 'json'
-				});
-				
-				await vscode.window.showTextDocument(doc);
-				
-				progress.report({ increment: 100, message: "Done!" });
-				
-				vscode.window.showInformationMessage('Generator template created! Use GitHub Copilot Chat to complete the generator based on your requirements.');
-				
-			} catch (error) {
-				vscode.window.showErrorMessage(`Error creating generator: ${error.message}`);
-			}
-		});
-	});
-
-	// Register command to view generator patterns
-	const viewPatterns = vscode.commands.registerCommand('generator.viewPatterns', async function () {
-		const extensionPath = context.extensionPath;
-		const generatorPatternsPath = path.join(extensionPath, 'Generator_Patterns');
-		
-		// Get list of pattern files
-		const patternFiles = fs.readdirSync(generatorPatternsPath).filter(f => f.endsWith('.md'));
-		
-		// Show quick pick to select pattern type
-		const selected = await vscode.window.showQuickPick(patternFiles, {
-			placeHolder: 'Select a generator pattern to view'
-		});
-		
-		if (selected) {
-			const filePath = path.join(generatorPatternsPath, selected);
-			const doc = await vscode.workspace.openTextDocument(filePath);
-			await vscode.window.showTextDocument(doc);
-		}
-	});
-
-	context.subscriptions.push(createGenerator, viewPatterns);
-}
-
-// This method is called when your extension is deactivated
-function deactivate() {}
-
-module.exports = {
-	activate,
-	deactivate
-}