generator-agent 1.0.7 → 1.0.9

package/.github/agents/Generators.agent.md

@@ -1,5 +1,5 @@
 ---
-name: GeneratorAgent
+name: Generator creation agent
 description: Creates generators using the OpenAPI specification and defined generator patterns. Ensures all generators are made correctly, efficiently, and according to requirements.
 ---
 
@@ -12,19 +12,20 @@ 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 only the dependencies explicitly requested by the user. Do not add extra setup dependencies on your own.
+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.
 
-3. For user-requested dependencies, ensure generators extract the required values from API responses so downstream generators can consume them clearly and correctly.
+3. Ensure that dependency generators extract the required values from their 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. 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.
+6. Always read the OpenAPI Specification (OAS) for the target operation before creating a generator, and extract only required schema/dependency details.
 
-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.
+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.
 
-8. You may use tools if necessary to generate the generators correctly.
 ---
 
 ## Generator
@@ -51,10 +52,6 @@ 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
@@ -78,27 +75,9 @@ All generators must be created using the following structure:
 
 ## Generator Creation Rules
 
-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.
+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.
 
-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.
+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.
 
 ---
 
@@ -114,8 +93,6 @@ 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 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.
+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.
 
-8. Don't give text response in chat window.Only output the generator JSON object as specified.
+7. Don't give text response in chat window.Only output the generator JSON object as specified.

package/.vscode/extensions.json

@@ -0,0 +1,8 @@
+{
+	// 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

@@ -0,0 +1,17 @@
+// 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

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

package/.vscodeignore

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

package/CHANGELOG.md

@@ -0,0 +1,9 @@
+# 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/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 (unique label for referencing in params) |
+| `name` | string | Generator identifier |
 
 ---
 

package/README.md

@@ -1,59 +1,65 @@
-# Generator Agent for GitHub Copilot
+# generator README
 
-## Installation
+This is the README for your extension "generator". After writing up a brief description, we recommend including the following sections.
 
-### Quick Install (Pre-built)
+## Features
 
-1. Clone the repository:
-   
-   ```
-   bash :
+Describe specific features of your extension including screenshots of your extension in action. Image paths are relative to this README file.
 
-   git clone https://github.com/ishwaryaramesh200-byte/Generator-Agent.git
-   
-   cd Generator-Agent
-   
-   ```
+For example if there is an image subfolder under your extension project workspace:
 
-2. Reload VS Code:
-   
-   - Press `Ctrl+Shift+P`
-   - Type "Reload Window" and press Enter
+\!\[feature X\]\(images/feature-x.png\)
 
-## Usage
+> 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.
 
-1. Open GitHub Copilot Chat.
-2. Select the "Generators" agent.
-3. Start prompting.
+## Requirements
 
-## Features
+If you have any requirements or dependencies, add a section describing those and how to install and configure them.
+
+## Extension Settings
+
+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
 
-- Static generator
-- Dynamic generator
-- Conditional generator
-- Reference generator
-- Remote generator
+Added features X, Y, and Z.
 
-## Instructions
+---
 
-### Getting Started
+## Working with Markdown
 
-| Step | Action | Details                                              |
-|------|--------|------------------------------------------------------|
-| 1    | Install| Follow the Quick Install steps                       |
-| 2    | Setup  | Copy `.github/agents` folder to your project root    |
-| 3    | Open   | Launch GitHub Copilot Chat in VS Code                |
-| 4    | Select | Choose "Generators" agent                            |
-| 5    | Prompt | Start using the agent with your requests             |
+You can author your README using Visual Studio Code.  Here are some useful editor keyboard shortcuts:
 
-### Key Commands
+* 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
 
-- **Start Agent**: `Ctrl+Shift+P` → "Start Generators Agent"
-- **Reload Window**: `Ctrl+Shift+P` → "Reload Window"
-- **Copilot Chat**: `Ctrl+Shift+I` (Open Copilot Chat panel)
+## For more information
 
-### Best Practices
+* [Visual Studio Code's Markdown Support](http://code.visualstudio.com/docs/languages/markdown)
+* [Markdown Syntax Reference](https://help.github.com/articles/markdown-basics/)
 
-1. Use the appropriate agent (Generators for configuration)
-2. Provide clear prompts for better generation results
-3. Test generated output before using in production
+**Enjoy!**

package/eslint.config.mjs

@@ -0,0 +1,25 @@
+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

@@ -0,0 +1,123 @@
+// 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
+}

package/jsconfig.json

@@ -0,0 +1,13 @@
+{
+	"compilerOptions": {
+		"module": "Node16",
+		"target": "ES2022",
+		"checkJs": true,  /* Typecheck .js files. */
+		"lib": [
+			"ES2022"
+		]
+	},
+	"exclude": [
+		"node_modules"
+	]
+}

package/package.json

@@ -1,63 +1,40 @@
 {
-    "name": "generator-agent",
-    "displayName": "GeneratorAgent",
-    "description": "A VS Code extension for conditional rule-based data generation",
-    "version": "1.0.7",
-    "publisher": "zohodesk",
-    "engines": {
-        "vscode": "^1.80.0"
-    },
-    "main": "./main.js",
-    "license": "MIT",
-    "homepage": "https://github.com/ishwaryaramesh200-byte/Generator-Agent",
-    "bugs": {
-        "url": "https://github.com/ishwaryaramesh200-byte/Generator-Agent/issues"
-    },
-    "scripts": {
-        "postinstall": "node post-install.js",
-        "setup": "node post-install.js"
-    },
-    "activationEvents": [
-        "onStartupFinished"
-    ],
-    "contributes": {
-        "commands": [
-            {
-                "command": "generator.start",
-                "title": "Start Generator Agent"
-            }
-        ],
-        "chatParticipants": [
-            {
-                "id": "generator",
-                "name": "GeneratorAgent",
-                "description": "Generator Agent responsible for generating generators",
-                "isSticky": true
-            }
-        ]
-    },
-    "repository": {
-        "type": "git",
-        "url": "https://github.com/ishwaryaramesh200-byte/Generator-Agent.git"
-    },
-    "categories": [
-        "Other"
-    ],
-    "keywords": [
-        "agent",
-        "generator",
-        "automation"
-    ],
-    "galleryBanner": {
-        "color": "#C80000",
-        "theme": "dark"
-    },
-    "devDependencies": {
-        "@types/vscode": "^1.80.0",
-        "@vscode/vsce": "^3.7.1"
-    },
-    "publishConfig": {
-        "access": "public",
-        "registry": "https://registry.npmjs.org/"
-    }
+  "name": "generator-agent",
+  "displayName": "Generator-Agent",
+  "description": "Create a generator for given use case",
+  "version": "1.0.9",
+  "engines": {
+    "vscode": "^1.109.0"
+  },
+  "categories": [
+    "Other"
+  ],
+  "activationEvents": [],
+  "main": "./extension.js",
+  "contributes": {
+    "commands": [
+      {
+        "command": "generator.createGenerator",
+        "title": "Generator: Create New Generator"
+      },
+      {
+        "command": "generator.viewPatterns",
+        "title": "Generator: View Generator Patterns"
+      }
+    ]
+  },
+  "scripts": {
+    "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",
+    "@types/node": "22.x",
+    "eslint": "^9.39.2",
+    "@vscode/test-cli": "^0.0.12",
+    "@vscode/test-electron": "^2.5.2"
+  }
 }

package/source/api-data-generators/.idea/api-data-generators.iml

@@ -0,0 +1,9 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<module type="JAVA_MODULE" version="4">
+  <component name="NewModuleRootManager" inherit-compiler-output="true">
+    <exclude-output />
+    <content url="file://$MODULE_DIR$" />
+    <orderEntry type="inheritedJdk" />
+    <orderEntry type="sourceFolder" forTests="false" />
+  </component>
+</module>

package/source/api-data-generators/.idea/misc.xml

@@ -0,0 +1,6 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project version="4">
+  <component name="ProjectRootManager" version="2" languageLevel="JDK_17" default="true" project-jdk-name="17" project-jdk-type="JavaSDK">
+    <output url="file://$PROJECT_DIR$/out" />
+  </component>
+</project>

package/source/api-data-generators/.idea/modules.xml

@@ -0,0 +1,8 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project version="4">
+  <component name="ProjectModuleManager">
+    <modules>
+      <module fileurl="file://$PROJECT_DIR$/.idea/api-data-generators.iml" filepath="$PROJECT_DIR$/.idea/api-data-generators.iml" />
+    </modules>
+  </component>
+</project>

package/source/api-data-generators/.idea/vcs.xml

@@ -0,0 +1,6 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project version="4">
+  <component name="VcsDirectoryMappings">
+    <mapping directory="$PROJECT_DIR$/../.." vcs="Git" />
+  </component>
+</project>