@bluefly/openstandardagents 0.4.4 → 0.4.5

package/dist/adapters/gitlab/package-generator.d.ts

@@ -2,6 +2,8 @@
  * GitLab Duo Package Generator
  * Orchestrates complete GitLab Duo agent package generation from OSSA manifests
  *
+ * Extends BasePackageGenerator for shared npm package logic
+ *
  * Generates complete directory structure (30+ files):
  * {agent-name}-gitlab-duo/
  * ├── .gitlab/duo/
@@ -22,6 +24,7 @@
  * └── agent.ossa.yaml
  */
 import type { OssaAgent } from '../../types/index.js';
+import { BasePackageGenerator } from '../npm/package-generator.js';
 export interface PackageGenerationOptions {
     /** Output directory for generated package */
     outputDir: string;
@@ -44,7 +47,7 @@ export interface GeneratedFile {
     path: string;
     content: string;
 }
-export declare class GitLabDuoPackageGenerator {
+export declare class GitLabDuoPackageGenerator extends BasePackageGenerator {
     private flowGenerator;
     private externalAgentGenerator;
     private triggerGenerator;
@@ -59,9 +62,10 @@ export declare class GitLabDuoPackageGenerator {
      */
     private validateManifest;
     /**
-     * Get agent name from manifest
+     * Get sanitized agent name from manifest
+     * Overrides base class to support legacy manifest.agent.name fallback
      */
-    private getAgentName;
+    protected getAgentName(manifest: OssaAgent): string;
     /**
      * Generate all package files
      *
@@ -96,7 +100,11 @@ export declare class GitLabDuoPackageGenerator {
     /**
      * Generate package.json
      */
-    private generatePackageJson;
+    /**
+     * Generate GitLab Duo package.json
+     * Uses base class generatePackageJson with GitLab-specific configuration
+     */
+    private generatePackageJsonForManifest;
     /**
      * Generate Dockerfile
      */
@@ -116,15 +124,20 @@ export declare class GitLabDuoPackageGenerator {
     /**
      * Generate tsconfig.json
      */
-    private generateTsConfig;
+    /**
+     * Generate TypeScript configuration
+     * Uses base class implementation
+     */
+    protected generateTsConfig(): string;
     /**
      * Generate GitLab CI configuration
      */
     private generateGitLabCI;
     /**
      * Generate .gitignore
+     * Uses base class implementation
      */
-    private generateGitignore;
+    protected generateGitignore(): string;
     /**
      * Generate MCP Configuration
      */

package/dist/adapters/gitlab/package-generator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"package-generator.d.ts","sourceRoot":"","sources":["../../../src/adapters/gitlab/package-generator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAKH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAMtD,MAAM,WAAW,wBAAwB;IACvC,6CAA6C;IAC7C,SAAS,EAAE,MAAM,CAAC;IAClB,oCAAoC;IACpC,sBAAsB,CAAC,EAAE,OAAO,CAAC;IACjC,mCAAmC;IACnC,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,kCAAkC;IAClC,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,+BAA+B;IAC/B,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,MAAM,WAAW,uBAAuB;IACtC,OAAO,EAAE,OAAO,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,qBAAa,yBAAyB;IACpC,OAAO,CAAC,aAAa,CAAyB;IAC9C,OAAO,CAAC,sBAAsB,CAAyB;IACvD,OAAO,CAAC,gBAAgB,CAA4B;IACpD,OAAO,CAAC,eAAe,CAA2B;;IASlD;;OAEG;IACG,QAAQ,CACZ,QAAQ,EAAE,SAAS,EACnB,OAAO,EAAE,wBAAwB,GAChC,OAAO,CAAC,uBAAuB,CAAC;IAiDnC;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAqBxB;;OAEG;IACH,OAAO,CAAC,YAAY;IAYpB;;;;;;;;;OASG;YACW,gBAAgB;IAsJ9B;;OAEG;YACW,UAAU;IAqBxB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IA4FxB;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAI5B;;OAEG;IACH,OAAO,CAAC,cAAc;IA8FtB;;OAEG;IACH,OAAO,CAAC,uBAAuB;IAgI/B;;OAEG;IACH,OAAO,CAAC,mBAAmB;IA4C3B;;OAEG;IACH,OAAO,CAAC,kBAAkB;IA8C1B;;OAEG;IACH,OAAO,CAAC,uBAAuB;IAwB/B;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAsB7B;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAwC7B;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAwBxB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAgDxB;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAqCzB;;OAEG;IACH,OAAO,CAAC,iBAAiB;IA+CzB;;;;OAIG;IACH,OAAO,CAAC,qBAAqB;IA8E7B;;OAEG;IACH,OAAO,CAAC,mBAAmB;IA0B3B;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAoL7B;;OAEG;IACH,OAAO,CAAC,uBAAuB;IA6N/B;;OAEG;IACH,OAAO,CAAC,4BAA4B;IA2OpC;;OAEG;IACH,OAAO,CAAC,WAAW;IAmQnB;;OAEG;IACH,OAAO,CAAC,oBAAoB;IA+U5B;;OAEG;IACH,OAAO,CAAC,wBAAwB;CA4UjC"}
+{"version":3,"file":"package-generator.d.ts","sourceRoot":"","sources":["../../../src/adapters/gitlab/package-generator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAKH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AAMnE,MAAM,WAAW,wBAAwB;IACvC,6CAA6C;IAC7C,SAAS,EAAE,MAAM,CAAC;IAClB,oCAAoC;IACpC,sBAAsB,CAAC,EAAE,OAAO,CAAC;IACjC,mCAAmC;IACnC,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,kCAAkC;IAClC,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,+BAA+B;IAC/B,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,MAAM,WAAW,uBAAuB;IACtC,OAAO,EAAE,OAAO,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,qBAAa,yBAA0B,SAAQ,oBAAoB;IACjE,OAAO,CAAC,aAAa,CAAyB;IAC9C,OAAO,CAAC,sBAAsB,CAAyB;IACvD,OAAO,CAAC,gBAAgB,CAA4B;IACpD,OAAO,CAAC,eAAe,CAA2B;;IAUlD;;OAEG;IACG,QAAQ,CACZ,QAAQ,EAAE,SAAS,EACnB,OAAO,EAAE,wBAAwB,GAChC,OAAO,CAAC,uBAAuB,CAAC;IAsDnC;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAwBxB;;;OAGG;IACH,SAAS,CAAC,YAAY,CAAC,QAAQ,EAAE,SAAS,GAAG,MAAM;IAKnD;;;;;;;;;OASG;YACW,gBAAgB;IAuJ9B;;OAEG;YACW,UAAU;IAqBxB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAsGxB;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAI5B;;OAEG;IACH,OAAO,CAAC,cAAc;IA0HtB;;OAEG;IACH,OAAO,CAAC,uBAAuB;IAgJ/B;;OAEG;IACH;;;OAGG;IACH,OAAO,CAAC,8BAA8B;IAmCtC;;OAEG;IACH,OAAO,CAAC,kBAAkB;IA8C1B;;OAEG;IACH,OAAO,CAAC,uBAAuB;IAwB/B;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAsB7B;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAwC7B;;OAEG;IACH;;;OAGG;IACH,SAAS,CAAC,gBAAgB,IAAI,MAAM;IAIpC;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAgDxB;;;OAGG;IACH,SAAS,CAAC,iBAAiB,IAAI,MAAM;IAIrC;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAmDzB;;;;OAIG;IACH,OAAO,CAAC,qBAAqB;IAsG7B;;OAEG;IACH,OAAO,CAAC,mBAAmB;IA2B3B;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAoM7B;;OAEG;IACH,OAAO,CAAC,uBAAuB;IA+O/B;;OAEG;IACH,OAAO,CAAC,4BAA4B;IAmPpC;;OAEG;IACH,OAAO,CAAC,WAAW;IA0RnB;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAmV5B;;OAEG;IACH,OAAO,CAAC,wBAAwB;CAoXjC"}

package/dist/adapters/gitlab/package-generator.js

@@ -2,6 +2,8 @@
  * GitLab Duo Package Generator
  * Orchestrates complete GitLab Duo agent package generation from OSSA manifests
  *
+ * Extends BasePackageGenerator for shared npm package logic
+ *
  * Generates complete directory structure (30+ files):
  * {agent-name}-gitlab-duo/
  * ├── .gitlab/duo/
@@ -24,16 +26,18 @@
 import * as fs from 'fs/promises';
 import * as path from 'path';
 import YAML from 'yaml';
+import { BasePackageGenerator } from '../npm/package-generator.js';
 import { GitLabDuoFlowGenerator } from './flow-generator.js';
 import { ExternalAgentGenerator } from './external-agent-generator.js';
 import { GitLabDuoTriggerGenerator } from './trigger-generator.js';
 import { GitLabDuoRouterGenerator } from './router-generator.js';
-export class GitLabDuoPackageGenerator {
+export class GitLabDuoPackageGenerator extends BasePackageGenerator {
     flowGenerator;
     externalAgentGenerator;
     triggerGenerator;
     routerGenerator;
     constructor() {
+        super();
         this.flowGenerator = new GitLabDuoFlowGenerator();
         this.externalAgentGenerator = new ExternalAgentGenerator();
         this.triggerGenerator = new GitLabDuoTriggerGenerator();
@@ -61,7 +65,9 @@ export class GitLabDuoPackageGenerator {
                     await fs.access(packagePath);
                     return {
                         success: false,
-                        errors: [`Package directory already exists: ${packagePath}. Use overwrite option to replace.`],
+                        errors: [
+                            `Package directory already exists: ${packagePath}. Use overwrite option to replace.`,
+                        ],
                     };
                 }
                 catch {
@@ -106,16 +112,12 @@ export class GitLabDuoPackageGenerator {
         };
     }
     /**
-     * Get agent name from manifest
+     * Get sanitized agent name from manifest
+     * Overrides base class to support legacy manifest.agent.name fallback
      */
     getAgentName(manifest) {
-        return (manifest.metadata?.name ||
-            manifest.agent?.name ||
-            'agent')
-            .toLowerCase()
-            .replace(/[^a-z0-9-]/g, '-')
-            .replace(/--+/g, '-')
-            .replace(/^-|-$/g, '');
+        const name = manifest.metadata?.name || manifest.agent?.name || 'agent';
+        return this.sanitizePackageName(name);
     }
     /**
      * Generate all package files
@@ -223,7 +225,7 @@ export class GitLabDuoPackageGenerator {
         // ── package.json ─────────────────────────────────────────
         files.push({
             path: 'package.json',
-            content: this.generatePackageJson(manifest),
+            content: this.generatePackageJsonForManifest(manifest),
         });
         // ── Dockerfile (if enabled) ──────────────────────────────
         if (options.includeDocker !== false) {
@@ -551,14 +553,16 @@ export class GitLabDuoPackageGenerator {
     /**
      * Generate package.json
      */
-    generatePackageJson(manifest) {
-        const agentName = this.getAgentName(manifest);
-        const version = manifest.metadata?.version || '1.0.0';
-        const description = manifest.metadata?.description || '';
-        const packageJson = {
-            name: `@gitlab-duo/${agentName}`,
-            version,
-            description,
+    /**
+     * Generate GitLab Duo package.json
+     * Uses base class generatePackageJson with GitLab-specific configuration
+     */
+    generatePackageJsonForManifest(manifest) {
+        return super.generatePackageJson({
+            scope: '@gitlab-duo',
+            name: this.getAgentName(manifest),
+            version: this.getAgentVersion(manifest),
+            description: this.getAgentDescription(manifest),
             type: 'module',
             main: './dist/index.js',
             types: './dist/index.d.ts',
@@ -582,15 +586,10 @@ export class GitLabDuoPackageGenerator {
             engines: {
                 node: '>=22.0.0',
             },
-            keywords: [
-                'gitlab-duo',
-                'ai-agent',
-                'ossa',
-            ],
-            author: manifest.metadata?.author || '',
-            license: manifest.metadata?.license || 'MIT',
-        };
-        return JSON.stringify(packageJson, null, 2);
+            keywords: ['gitlab-duo', 'ai-agent', 'ossa'],
+            author: this.getAgentAuthor(manifest),
+            license: this.getAgentLicense(manifest),
+        });
     }
     /**
      * Generate Dockerfile
@@ -724,27 +723,12 @@ export class GitLabDuoPackageGenerator {
     /**
      * Generate tsconfig.json
      */
+    /**
+     * Generate TypeScript configuration
+     * Uses base class implementation
+     */
     generateTsConfig() {
-        const config = {
-            compilerOptions: {
-                target: 'ES2022',
-                module: 'ES2022',
-                lib: ['ES2022'],
-                moduleResolution: 'node',
-                outDir: './dist',
-                rootDir: './src',
-                strict: true,
-                esModuleInterop: true,
-                skipLibCheck: true,
-                forceConsistentCasingInFileNames: true,
-                declaration: true,
-                declarationMap: true,
-                sourceMap: true,
-            },
-            include: ['src/**/*'],
-            exclude: ['node_modules', 'dist'],
-        };
-        return JSON.stringify(config, null, 2);
+        return super.generateTsConfig();
     }
     /**
      * Generate GitLab CI configuration
@@ -791,35 +775,10 @@ export class GitLabDuoPackageGenerator {
     }
     /**
      * Generate .gitignore
+     * Uses base class implementation
      */
     generateGitignore() {
-        const lines = [];
-        lines.push('# Dependencies');
-        lines.push('node_modules/');
-        lines.push('');
-        lines.push('# Build output');
-        lines.push('dist/');
-        lines.push('build/');
-        lines.push('');
-        lines.push('# Logs');
-        lines.push('*.log');
-        lines.push('logs/');
-        lines.push('');
-        lines.push('# Environment');
-        lines.push('.env');
-        lines.push('.env.local');
-        lines.push('');
-        lines.push('# IDE');
-        lines.push('.vscode/');
-        lines.push('.idea/');
-        lines.push('*.swp');
-        lines.push('*.swo');
-        lines.push('');
-        lines.push('# OS');
-        lines.push('.DS_Store');
-        lines.push('Thumbs.db');
-        lines.push('');
-        return lines.join('\n');
+        return super.generateGitignore();
     }
     /**
      * Generate MCP Configuration
@@ -841,7 +800,9 @@ export class GitLabDuoPackageGenerator {
                     },
                 };
             }
-            else if (toolName.includes('file') || toolName.includes('read') || toolName.includes('write')) {
+            else if (toolName.includes('file') ||
+                toolName.includes('read') ||
+                toolName.includes('write')) {
                 mcpServers['filesystem'] = {
                     command: 'npx',
                     args: ['-y', '@modelcontextprotocol/server-filesystem', '/workspace'],
@@ -888,15 +849,28 @@ export class GitLabDuoPackageGenerator {
                         GITLAB_TOKEN: '${GITLAB_TOKEN}',
                         GITLAB_URL: '${GITLAB_URL:-https://gitlab.com}',
                     },
-                    capabilities: ['issues', 'merge_requests', 'comments', 'repository_files', 'pipelines'],
+                    capabilities: [
+                        'issues',
+                        'merge_requests',
+                        'comments',
+                        'repository_files',
+                        'pipelines',
+                    ],
                 };
             }
-            else if (toolName.includes('file') || toolName.includes('read') || toolName.includes('write')) {
+            else if (toolName.includes('file') ||
+                toolName.includes('read') ||
+                toolName.includes('write')) {
                 mcpServers['filesystem'] = {
                     description: 'File system operations (read, write, list, search)',
                     command: 'npx',
                     args: ['-y', '@modelcontextprotocol/server-filesystem', '/workspace'],
-                    capabilities: ['read_file', 'create_file_with_contents', 'update_file', 'list_dir'],
+                    capabilities: [
+                        'read_file',
+                        'create_file_with_contents',
+                        'update_file',
+                        'list_dir',
+                    ],
                 };
             }
             else if (toolName.includes('search')) {
@@ -949,7 +923,7 @@ export class GitLabDuoPackageGenerator {
     generateCustomTools(manifest) {
         const spec = manifest.spec;
         const tools = spec.tools || [];
-        const customTools = tools.map(tool => ({
+        const customTools = tools.map((tool) => ({
             name: tool.name || 'custom_tool',
             description: tool.description || 'Custom tool implementation',
             input_schema: {
@@ -1026,7 +1000,7 @@ export class GitLabDuoPackageGenerator {
         lines.push('');
         lines.push('- Never log sensitive data (tokens, passwords, API keys)');
         lines.push('- Redact sensitive patterns in output');
-        lines.push('- Use GitLab\'s built-in secret detection');
+        lines.push("- Use GitLab's built-in secret detection");
         lines.push('');
         lines.push('### Data Retention');
         lines.push('');
@@ -1572,7 +1546,8 @@ export class GitLabDuoPackageGenerator {
         lines.push('');
         lines.push('### What is this agent?');
         lines.push('');
-        lines.push(manifest.metadata?.description || 'A GitLab Duo agent for automating tasks.');
+        lines.push(manifest.metadata?.description ||
+            'A GitLab Duo agent for automating tasks.');
         lines.push('');
         lines.push('### How do I trigger this agent?');
         lines.push('');
@@ -2133,13 +2108,13 @@ export class GitLabDuoPackageGenerator {
         lines.push('  "https://gitlab.com/api/v4/projects/PROJECT_ID/duo/agents/${agentName}/trigger" \\');
         lines.push('  -H "PRIVATE-TOKEN: YOUR_TOKEN" \\');
         lines.push('  -H "Content-Type: application/json" \\');
-        lines.push('  -d \'{');
+        lines.push("  -d '{");
         lines.push('    "input": "Your task description",');
         lines.push('    "context": {');
         lines.push('      "issue_iid": 123,');
         lines.push('      "merge_request_iid": 456');
         lines.push('    }');
-        lines.push('  }\'');
+        lines.push("  }'");
         lines.push('```');
         lines.push('');
         lines.push('**Response:**');
@@ -2254,12 +2229,12 @@ export class GitLabDuoPackageGenerator {
         lines.push('  "https://your-instance.com/webhooks/${agentName}" \\');
         lines.push('  -H "Authorization: Bearer YOUR_WEBHOOK_TOKEN" \\');
         lines.push('  -H "Content-Type: application/json" \\');
-        lines.push('  -d \'{');
+        lines.push("  -d '{");
         lines.push('    "event": "custom_event",');
         lines.push('    "data": {');
         lines.push('      "key": "value"');
         lines.push('    }');
-        lines.push('  }\'');
+        lines.push("  }'");
         lines.push('```');
         lines.push('');
         lines.push('## glab CLI');
@@ -2405,7 +2380,7 @@ export class GitLabDuoPackageGenerator {
         lines.push('');
         lines.push('## Best Practices');
         lines.push('');
-        lines.push('1. **Use polling with backoff** - Don\'t spam status checks');
+        lines.push("1. **Use polling with backoff** - Don't spam status checks");
         lines.push('2. **Handle rate limits** - Respect RateLimit headers');
         lines.push('3. **Include context** - Provide issue/MR context when available');
         lines.push('4. **Validate inputs** - Check input format before triggering');