@bluefly/openstandardagents 0.4.0 → 0.4.2

package/dist/services/export/npm/express-generator.js

@@ -0,0 +1,296 @@
+/**
+ * Express Server Generator
+ *
+ * Generates Express server with /chat endpoint and OpenAPI integration
+ *
+ * SOLID: Single Responsibility - Express server generation only
+ * DRY: Reusable server templates
+ */
+/**
+ * Express Server Code Generator
+ */
+export class ExpressGenerator {
+    /**
+     * Generate Express server with /chat endpoint
+     */
+    generateServer(manifest) {
+        const metadata = manifest.metadata || { name: 'Agent', version: '1.0.0' };
+        const className = this.toClassName(metadata.name);
+        return `/**
+ * Express Server for ${metadata.name}
+ *
+ * Generated from OSSA manifest
+ * Version: ${metadata.version}
+ */
+
+import express from 'express';
+import type { Request, Response, NextFunction } from 'express';
+import { readFileSync } from 'fs';
+import { join, dirname } from 'path';
+import { fileURLToPath } from 'url';
+import yaml from 'yaml';
+import ${className} from './index.js';
+import type { ChatRequest, ChatResponse } from './types.js';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+
+/**
+ * Server configuration
+ */
+const config = {
+  port: parseInt(process.env.PORT || '3000', 10),
+  host: process.env.HOST || '0.0.0.0',
+  logLevel: process.env.LOG_LEVEL || 'info',
+  corsOrigin: process.env.CORS_ORIGIN || '*',
+};
+
+/**
+ * Express application
+ */
+const app = express();
+
+/**
+ * Agent instance
+ */
+const agent = new ${className}();
+
+/**
+ * Middleware
+ */
+
+// Parse JSON bodies
+app.use(express.json());
+
+// CORS
+app.use((req: Request, res: Response, next: NextFunction) => {
+  res.header('Access-Control-Allow-Origin', config.corsOrigin);
+  res.header('Access-Control-Allow-Methods', 'GET, POST, OPTIONS');
+  res.header('Access-Control-Allow-Headers', 'Content-Type, Authorization');
+
+  if (req.method === 'OPTIONS') {
+    res.sendStatus(200);
+  } else {
+    next();
+  }
+});
+
+// Request logging
+app.use((req: Request, res: Response, next: NextFunction) => {
+  const start = Date.now();
+
+  res.on('finish', () => {
+    const duration = Date.now() - start;
+    if (config.logLevel === 'info' || config.logLevel === 'debug') {
+      console.log(\`[\${new Date().toISOString()}] \${req.method} \${req.path} \${res.statusCode} \${duration}ms\`);
+    }
+  });
+
+  next();
+});
+
+/**
+ * Routes
+ */
+
+/**
+ * Health check endpoint
+ */
+app.get('/health', (req: Request, res: Response) => {
+  res.json({
+    status: 'healthy',
+    timestamp: new Date().toISOString(),
+    version: '${metadata.version}',
+  });
+});
+
+/**
+ * Agent metadata endpoint
+ */
+app.get('/metadata', (req: Request, res: Response) => {
+  try {
+    const metadata = agent.getMetadata();
+    res.json(metadata);
+  } catch (error) {
+    console.error('Error getting metadata:', error);
+    res.status(500).json({
+      error: 'Failed to get agent metadata',
+      message: error instanceof Error ? error.message : String(error),
+    });
+  }
+});
+
+/**
+ * OpenAPI specification endpoint
+ */
+app.get('/openapi', (req: Request, res: Response) => {
+  try {
+    const openapiPath = join(__dirname, '..', 'openapi.yaml');
+    const openapiContent = readFileSync(openapiPath, 'utf-8');
+    const openapiSpec = yaml.parse(openapiContent);
+
+    res.json(openapiSpec);
+  } catch (error) {
+    console.error('Error loading OpenAPI spec:', error);
+    res.status(500).json({
+      error: 'Failed to load OpenAPI specification',
+      message: error instanceof Error ? error.message : String(error),
+    });
+  }
+});
+
+/**
+ * Chat endpoint
+ *
+ * POST /chat
+ * Body: { message: string, context?: object, tools?: string[] }
+ */
+app.post('/chat', async (req: Request, res: Response) => {
+  try {
+    // Validate request body
+    const request: ChatRequest = req.body;
+
+    if (!request.message || typeof request.message !== 'string') {
+      res.status(400).json({
+        error: 'Invalid request',
+        message: 'message field is required and must be a string',
+      });
+      return;
+    }
+
+    // Call agent
+    const response: ChatResponse = await agent.chat(request);
+
+    // Send response
+    res.json(response);
+  } catch (error) {
+    console.error('Chat error:', error);
+    res.status(500).json({
+      error: 'Chat failed',
+      message: error instanceof Error ? error.message : String(error),
+    });
+  }
+});
+
+/**
+ * Reset conversation endpoint
+ *
+ * POST /reset
+ */
+app.post('/reset', (req: Request, res: Response) => {
+  try {
+    agent.reset();
+    res.json({
+      status: 'success',
+      message: 'Conversation history reset',
+    });
+  } catch (error) {
+    console.error('Reset error:', error);
+    res.status(500).json({
+      error: 'Reset failed',
+      message: error instanceof Error ? error.message : String(error),
+    });
+  }
+});
+
+/**
+ * Get conversation history endpoint
+ *
+ * GET /history
+ */
+app.get('/history', (req: Request, res: Response) => {
+  try {
+    const history = agent.getHistory();
+    res.json({
+      history,
+      count: history.length,
+    });
+  } catch (error) {
+    console.error('Error getting history:', error);
+    res.status(500).json({
+      error: 'Failed to get conversation history',
+      message: error instanceof Error ? error.message : String(error),
+    });
+  }
+});
+
+/**
+ * 404 handler
+ */
+app.use((req: Request, res: Response) => {
+  res.status(404).json({
+    error: 'Not found',
+    message: \`Route not found: \${req.method} \${req.path}\`,
+  });
+});
+
+/**
+ * Error handler
+ */
+app.use((err: Error, req: Request, res: Response, next: NextFunction) => {
+  console.error('Server error:', err);
+  res.status(500).json({
+    error: 'Internal server error',
+    message: err.message,
+  });
+});
+
+/**
+ * Start server
+ */
+const server = app.listen(config.port, config.host, () => {
+  console.log(\`
+╔════════════════════════════════════════════════════════════╗
+║  ${metadata.name} v${metadata.version}
+║
+║  Server running at:
+║  - http://\${config.host}:\${config.port}
+║
+║  Endpoints:
+║  - POST /chat       - Send message to agent
+║  - POST /reset      - Reset conversation
+║  - GET  /history    - Get conversation history
+║  - GET  /metadata   - Get agent metadata
+║  - GET  /openapi    - OpenAPI specification
+║  - GET  /health     - Health check
+║
+╚════════════════════════════════════════════════════════════╝
+  \`);
+});
+
+/**
+ * Graceful shutdown
+ */
+process.on('SIGTERM', () => {
+  console.log('SIGTERM received, shutting down gracefully...');
+  server.close(() => {
+    console.log('Server closed');
+    process.exit(0);
+  });
+});
+
+process.on('SIGINT', () => {
+  console.log('\\nSIGINT received, shutting down gracefully...');
+  server.close(() => {
+    console.log('Server closed');
+    process.exit(0);
+  });
+});
+
+/**
+ * Export for testing
+ */
+export { app, server };
+`;
+    }
+    /**
+     * Convert string to PascalCase class name
+     */
+    toClassName(name) {
+        return name
+            .split(/[-_\s]+/)
+            .map((word) => word.charAt(0).toUpperCase() + word.slice(1).toLowerCase())
+            .join('');
+    }
+}
+//# sourceMappingURL=express-generator.js.map

package/dist/services/export/npm/express-generator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"express-generator.js","sourceRoot":"","sources":["../../../../src/services/export/npm/express-generator.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH;;GAEG;AACH,MAAM,OAAO,gBAAgB;IAC3B;;OAEG;IACH,cAAc,CAAC,QAAmB;QAChC,MAAM,QAAQ,GAAG,QAAQ,CAAC,QAAQ,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC;QAC1E,MAAM,SAAS,GAAG,IAAI,CAAC,WAAW,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;QAElD,OAAO;wBACa,QAAQ,CAAC,IAAI;;;cAGvB,QAAQ,CAAC,OAAO;;;;;;;;;SASrB,SAAS;;;;;;;;;;;;;;;;;;;;;;;;oBAwBE,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;gBA+Cb,QAAQ,CAAC,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;KA6I3B,QAAQ,CAAC,IAAI,KAAK,QAAQ,CAAC,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAwCtC,CAAC;IACA,CAAC;IAED;;OAEG;IACK,WAAW,CAAC,IAAY;QAC9B,OAAO,IAAI;aACR,KAAK,CAAC,SAAS,CAAC;aAChB,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC;aACzE,IAAI,CAAC,EAAE,CAAC,CAAC;IACd,CAAC;CACF"}

package/dist/services/export/npm/index.d.ts

@@ -0,0 +1,13 @@
+/**
+ * NPM Package Exporter
+ *
+ * Export OSSA agents as publishable npm packages with TypeScript + Express + OpenAPI
+ */
+export { NPMExporter } from './npm-exporter.js';
+export type { NPMExportOptions, NPMExportFile, NPMExportResult, } from './npm-exporter.js';
+export { TypeScriptGenerator } from './typescript-generator.js';
+export { ExpressGenerator } from './express-generator.js';
+export { OpenAPIGenerator } from './openapi-generator.js';
+export { PackageJsonGenerator } from './package-json-generator.js';
+export type { PackageJsonOptions } from './package-json-generator.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/services/export/npm/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/services/export/npm/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,YAAY,EACV,gBAAgB,EAChB,aAAa,EACb,eAAe,GAChB,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAChE,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AACnE,YAAY,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAC"}

package/dist/services/export/npm/index.js

@@ -0,0 +1,11 @@
+/**
+ * NPM Package Exporter
+ *
+ * Export OSSA agents as publishable npm packages with TypeScript + Express + OpenAPI
+ */
+export { NPMExporter } from './npm-exporter.js';
+export { TypeScriptGenerator } from './typescript-generator.js';
+export { ExpressGenerator } from './express-generator.js';
+export { OpenAPIGenerator } from './openapi-generator.js';
+export { PackageJsonGenerator } from './package-json-generator.js';
+//# sourceMappingURL=index.js.map

package/dist/services/export/npm/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/services/export/npm/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAOhD,OAAO,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAChE,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC"}

package/dist/services/export/npm/npm-exporter.d.ts

@@ -0,0 +1,142 @@
+/**
+ * NPM Package Exporter Service
+ *
+ * Generates TypeScript agent code with Express server + OpenAPI
+ * Exports OSSA agents as publishable npm packages
+ *
+ * SOLID: Single Responsibility - Coordinates npm export generation
+ * DRY: Delegates to specialized generators
+ */
+import type { OssaAgent } from '../../../types/index.js';
+export interface NPMExportOptions {
+    /**
+     * Output directory for generated package
+     */
+    outputDir?: string;
+    /**
+     * Include Docker configuration
+     */
+    includeDocker?: boolean;
+    /**
+     * Include tests
+     */
+    includeTests?: boolean;
+    /**
+     * Package scope (e.g., '@ossa', '@mycompany')
+     */
+    scope?: string;
+    /**
+     * Additional npm dependencies
+     */
+    additionalDeps?: Record<string, string>;
+    /**
+     * Target TypeScript version
+     */
+    tsVersion?: string;
+    /**
+     * Target Node version
+     */
+    nodeVersion?: string;
+}
+export interface NPMExportFile {
+    /**
+     * Relative path from package root
+     */
+    path: string;
+    /**
+     * File content
+     */
+    content: string;
+    /**
+     * File type
+     */
+    type: 'code' | 'config' | 'documentation' | 'docker';
+    /**
+     * Language/format
+     */
+    language?: string;
+}
+export interface NPMExportResult {
+    /**
+     * Success status
+     */
+    success: boolean;
+    /**
+     * Generated files
+     */
+    files: NPMExportFile[];
+    /**
+     * Package name
+     */
+    packageName?: string;
+    /**
+     * Package version
+     */
+    version?: string;
+    /**
+     * Error message if failed
+     */
+    error?: string;
+    /**
+     * Export metadata
+     */
+    metadata?: {
+        duration: number;
+        fileCount: number;
+        hasDocker: boolean;
+        hasTests: boolean;
+    };
+}
+/**
+ * NPM Package Exporter
+ *
+ * Generates complete npm packages with TypeScript + Express + OpenAPI
+ */
+export declare class NPMExporter {
+    private tsGenerator;
+    private expressGenerator;
+    private openapiGenerator;
+    private packageJsonGenerator;
+    constructor();
+    /**
+     * Export OSSA manifest to npm package
+     */
+    export(manifest: OssaAgent, options?: NPMExportOptions): Promise<NPMExportResult>;
+    /**
+     * Validate OSSA manifest
+     */
+    private validateManifest;
+    /**
+     * Get npm package name with scope
+     */
+    private getPackageName;
+    /**
+     * Generate tsconfig.json
+     */
+    private generateTsConfig;
+    /**
+     * Generate README.md
+     */
+    private generateReadme;
+    /**
+     * Generate .gitignore
+     */
+    private generateGitIgnore;
+    /**
+     * Generate .npmignore
+     */
+    private generateNpmIgnore;
+    /**
+     * Generate Dockerfile
+     */
+    private generateDockerfile;
+    /**
+     * Generate docker-compose.yaml
+     */
+    private generateDockerCompose;
+    /**
+     * Generate test file
+     */
+    private generateTests;
+}
+//# sourceMappingURL=npm-exporter.d.ts.map

package/dist/services/export/npm/npm-exporter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"npm-exporter.d.ts","sourceRoot":"","sources":["../../../../src/services/export/npm/npm-exporter.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AAMzD,MAAM,WAAW,gBAAgB;IAC/B;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;OAEG;IACH,aAAa,CAAC,EAAE,OAAO,CAAC;IAExB;;OAEG;IACH,YAAY,CAAC,EAAE,OAAO,CAAC;IAEvB;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf;;OAEG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAExC;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,aAAa;IAC5B;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;IAEhB;;OAEG;IACH,IAAI,EAAE,MAAM,GAAG,QAAQ,GAAG,eAAe,GAAG,QAAQ,CAAC;IAErD;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,eAAe;IAC9B;;OAEG;IACH,OAAO,EAAE,OAAO,CAAC;IAEjB;;OAEG;IACH,KAAK,EAAE,aAAa,EAAE,CAAC;IAEvB;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf;;OAEG;IACH,QAAQ,CAAC,EAAE;QACT,QAAQ,EAAE,MAAM,CAAC;QACjB,SAAS,EAAE,MAAM,CAAC;QAClB,SAAS,EAAE,OAAO,CAAC;QACnB,QAAQ,EAAE,OAAO,CAAC;KACnB,CAAC;CACH;AAED;;;;GAIG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,WAAW,CAAsB;IACzC,OAAO,CAAC,gBAAgB,CAAmB;IAC3C,OAAO,CAAC,gBAAgB,CAAmB;IAC3C,OAAO,CAAC,oBAAoB,CAAuB;;IASnD;;OAEG;IACG,MAAM,CACV,QAAQ,EAAE,SAAS,EACnB,OAAO,GAAE,gBAAqB,GAC7B,OAAO,CAAC,eAAe,CAAC;IAgK3B;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAcxB;;OAEG;IACH,OAAO,CAAC,cAAc;IAStB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IA4BxB;;OAEG;IACH,OAAO,CAAC,cAAc;IAyFtB;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAsCzB;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAgCzB;;OAEG;IACH,OAAO,CAAC,kBAAkB;IA4B1B;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAyB7B;;OAEG;IACH,OAAO,CAAC,aAAa;CA6BtB"}