@bluefly/openstandardagents 0.3.6 → 0.4.1

package/dist/services/cost-estimation/token-counter.service.d.ts

@@ -0,0 +1,51 @@
+/**
+ * OSSA Cost Estimation - Token Counter Service
+ * Estimates token counts for various text inputs
+ *
+ * Uses approximate tokenization (4 chars ≈ 1 token for English)
+ * For production use, consider integrating tiktoken for OpenAI models
+ * or model-specific tokenizers for other providers
+ */
+import type { OssaAgent } from '../../types/index.js';
+export interface TokenCount {
+    systemPrompt: number;
+    tools: number;
+    instructions: number;
+    examples: number;
+    total: number;
+    breakdown: {
+        [key: string]: number;
+    };
+}
+export declare class TokenCounterService {
+    /**
+     * Approximate tokens in text (4 chars ≈ 1 token for English)
+     * This is a rough estimate. For accurate counts, use model-specific tokenizers.
+     */
+    private estimateTokens;
+    /**
+     * Count tokens in an OSSA agent manifest
+     */
+    countAgentTokens(agent: OssaAgent): TokenCount;
+    /**
+     * Estimate tokens for a typical user message
+     */
+    estimateUserMessage(length?: 'short' | 'medium' | 'long'): number;
+    /**
+     * Estimate tokens for a typical assistant response
+     */
+    estimateAssistantResponse(length?: 'short' | 'medium' | 'long'): number;
+    /**
+     * Estimate total tokens for a conversation turn
+     */
+    estimateConversationTurn(systemTokens: number, userLength?: 'short' | 'medium' | 'long', assistantLength?: 'short' | 'medium' | 'long'): {
+        input: number;
+        output: number;
+        total: number;
+    };
+    /**
+     * Format token count for display
+     */
+    formatTokenCount(count: number): string;
+}
+//# sourceMappingURL=token-counter.service.d.ts.map

package/dist/services/cost-estimation/token-counter.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"token-counter.service.d.ts","sourceRoot":"","sources":["../../../src/services/cost-estimation/token-counter.service.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAGtD,MAAM,WAAW,UAAU;IACzB,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE;QACT,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAC;KACvB,CAAC;CACH;AAED,qBAAa,mBAAmB;IAC9B;;;OAGG;IACH,OAAO,CAAC,cAAc;IAQtB;;OAEG;IACH,gBAAgB,CAAC,KAAK,EAAE,SAAS,GAAG,UAAU;IA0D9C;;OAEG;IACH,mBAAmB,CAAC,MAAM,GAAE,OAAO,GAAG,QAAQ,GAAG,MAAiB,GAAG,MAAM;IAS3E;;OAEG;IACH,yBAAyB,CACvB,MAAM,GAAE,OAAO,GAAG,QAAQ,GAAG,MAAiB,GAC7C,MAAM;IAST;;OAEG;IACH,wBAAwB,CACtB,YAAY,EAAE,MAAM,EACpB,UAAU,GAAE,OAAO,GAAG,QAAQ,GAAG,MAAiB,EAClD,eAAe,GAAE,OAAO,GAAG,QAAQ,GAAG,MAAiB,GACtD;QACD,KAAK,EAAE,MAAM,CAAC;QACd,MAAM,EAAE,MAAM,CAAC;QACf,KAAK,EAAE,MAAM,CAAC;KACf;IAiBD;;OAEG;IACH,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM;CASxC"}

package/dist/services/cost-estimation/token-counter.service.js

@@ -0,0 +1,125 @@
+/**
+ * OSSA Cost Estimation - Token Counter Service
+ * Estimates token counts for various text inputs
+ *
+ * Uses approximate tokenization (4 chars ≈ 1 token for English)
+ * For production use, consider integrating tiktoken for OpenAI models
+ * or model-specific tokenizers for other providers
+ */
+export class TokenCounterService {
+    /**
+     * Approximate tokens in text (4 chars ≈ 1 token for English)
+     * This is a rough estimate. For accurate counts, use model-specific tokenizers.
+     */
+    estimateTokens(text) {
+        if (!text)
+            return 0;
+        // Account for code, JSON, and technical content (lower ratio)
+        const isCodeOrTechnical = /[{}\[\]()<>]/.test(text) || /```/.test(text);
+        const charsPerToken = isCodeOrTechnical ? 3 : 4;
+        return Math.ceil(text.length / charsPerToken);
+    }
+    /**
+     * Count tokens in an OSSA agent manifest
+     */
+    countAgentTokens(agent) {
+        const breakdown = {};
+        // Instructions (from spec or agent)
+        let instructions = 0;
+        const instructionsText = agent.spec?.instructions || '';
+        if (instructionsText) {
+            instructions = this.estimateTokens(instructionsText);
+        }
+        breakdown['instructions'] = instructions;
+        // Role description
+        const role = agent.spec?.role || agent.agent?.role || '';
+        const roleTokens = this.estimateTokens(role);
+        breakdown['role'] = roleTokens;
+        // Description
+        const description = agent.metadata?.description || agent.agent?.description || '';
+        const descTokens = this.estimateTokens(description);
+        breakdown['description'] = descTokens;
+        // Tools (from spec or agent)
+        let tools = 0;
+        const agentTools = agent.spec?.tools || agent.agent?.tools;
+        if (agentTools) {
+            const toolsText = JSON.stringify(agentTools);
+            tools = this.estimateTokens(toolsText);
+        }
+        breakdown['tools'] = tools;
+        // Examples (if any)
+        let examples = 0;
+        breakdown['examples'] = examples;
+        // Extensions (if any add context)
+        let extensions = 0;
+        if (agent.extensions) {
+            const extensionsText = JSON.stringify(agent.extensions);
+            extensions = this.estimateTokens(extensionsText);
+        }
+        breakdown['extensions'] = extensions;
+        const total = Object.values(breakdown).reduce((sum, val) => sum + val, 0);
+        // For return values (backwards compatibility)
+        const systemPrompt = instructions + roleTokens + descTokens;
+        return {
+            systemPrompt,
+            tools,
+            instructions,
+            examples,
+            total,
+            breakdown,
+        };
+    }
+    /**
+     * Estimate tokens for a typical user message
+     */
+    estimateUserMessage(length = 'medium') {
+        const lengths = {
+            short: 50, // "Create a user profile"
+            medium: 200, // A paragraph of instructions
+            long: 800, // Detailed requirements with context
+        };
+        return lengths[length];
+    }
+    /**
+     * Estimate tokens for a typical assistant response
+     */
+    estimateAssistantResponse(length = 'medium') {
+        const lengths = {
+            short: 100, // Brief confirmation or result
+            medium: 500, // Explanation with code snippet
+            long: 2000, // Detailed response with examples
+        };
+        return lengths[length];
+    }
+    /**
+     * Estimate total tokens for a conversation turn
+     */
+    estimateConversationTurn(systemTokens, userLength = 'medium', assistantLength = 'medium') {
+        const userTokens = this.estimateUserMessage(userLength);
+        const assistantTokens = this.estimateAssistantResponse(assistantLength);
+        // Input = system + user message + conversation history overhead
+        const input = systemTokens + userTokens;
+        // Output = assistant response
+        const output = assistantTokens;
+        return {
+            input,
+            output,
+            total: input + output,
+        };
+    }
+    /**
+     * Format token count for display
+     */
+    formatTokenCount(count) {
+        if (count < 1000) {
+            return `${count} tokens`;
+        }
+        else if (count < 1000000) {
+            return `${(count / 1000).toFixed(1)}K tokens`;
+        }
+        else {
+            return `${(count / 1000000).toFixed(2)}M tokens`;
+        }
+    }
+}
+//# sourceMappingURL=token-counter.service.js.map

package/dist/services/cost-estimation/token-counter.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"token-counter.service.js","sourceRoot":"","sources":["../../../src/services/cost-estimation/token-counter.service.ts"],"names":[],"mappings":"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"}

package/dist/services/dev-server/dev-server.service.d.ts

@@ -0,0 +1,121 @@
+/**
+ * Development Server Service
+ *
+ * Orchestrates file watching, validation, and WebSocket updates
+ *
+ * Features:
+ * - Hot reload on manifest changes
+ * - Real-time validation
+ * - WebSocket updates to clients
+ * - HTTP server with test UI
+ *
+ * SOLID: Single Responsibility - Dev server orchestration
+ */
+import { type ValidationResult } from './live-validator.js';
+export interface DevServerOptions {
+    /**
+     * File or directory to watch
+     */
+    watch: string;
+    /**
+     * HTTP server port
+     * @default 3000
+     */
+    port?: number;
+    /**
+     * Auto-open browser
+     * @default false
+     */
+    open?: boolean;
+    /**
+     * Debounce delay for file changes (ms)
+     * @default 300
+     */
+    debounceMs?: number;
+    /**
+     * Enable verbose logging
+     * @default false
+     */
+    verbose?: boolean;
+}
+export interface DevServerStats {
+    /**
+     * Server start time
+     */
+    startTime: Date;
+    /**
+     * Number of watched files
+     */
+    watchedFiles: number;
+    /**
+     * Number of connected clients
+     */
+    connectedClients: number;
+    /**
+     * Total file changes detected
+     */
+    fileChanges: number;
+    /**
+     * Total validations performed
+     */
+    validations: number;
+    /**
+     * Latest validation result
+     */
+    latestValidation?: ValidationResult;
+}
+/**
+ * Development Server
+ *
+ * Provides hot reload and live validation for OSSA manifests
+ */
+export declare class DevServer {
+    private fileWatcher?;
+    private validator;
+    private wsServer;
+    private httpServer?;
+    private options;
+    private stats;
+    constructor(options: DevServerOptions);
+    /**
+     * Start development server
+     */
+    start(): Promise<void>;
+    /**
+     * Stop development server
+     */
+    stop(): Promise<void>;
+    /**
+     * Get current server statistics
+     */
+    getStats(): DevServerStats;
+    /**
+     * Handle file change event
+     */
+    private handleFileChange;
+    /**
+     * Validate a file
+     */
+    private validateFile;
+    /**
+     * Handle HTTP requests
+     */
+    private handleRequest;
+    /**
+     * Serve test UI HTML
+     */
+    private serveTestUI;
+    /**
+     * Generate inline test UI (fallback)
+     */
+    private generateInlineTestUI;
+    /**
+     * Print server status
+     */
+    private printStatus;
+    /**
+     * Open browser
+     */
+    private openBrowser;
+}
+//# sourceMappingURL=dev-server.service.d.ts.map

package/dist/services/dev-server/dev-server.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dev-server.service.d.ts","sourceRoot":"","sources":["../../../src/services/dev-server/dev-server.service.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAMH,OAAO,EAAiB,KAAK,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAO3E,MAAM,WAAW,gBAAgB;IAC/B;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC;IAEd;;;OAGG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd;;;OAGG;IACH,IAAI,CAAC,EAAE,OAAO,CAAC;IAEf;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB;;;OAGG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,cAAc;IAC7B;;OAEG;IACH,SAAS,EAAE,IAAI,CAAC;IAEhB;;OAEG;IACH,YAAY,EAAE,MAAM,CAAC;IAErB;;OAEG;IACH,gBAAgB,EAAE,MAAM,CAAC;IAEzB;;OAEG;IACH,WAAW,EAAE,MAAM,CAAC;IAEpB;;OAEG;IACH,WAAW,EAAE,MAAM,CAAC;IAEpB;;OAEG;IACH,gBAAgB,CAAC,EAAE,gBAAgB,CAAC;CACrC;AAED;;;;GAIG;AACH,qBAAa,SAAS;IACpB,OAAO,CAAC,WAAW,CAAC,CAAc;IAClC,OAAO,CAAC,SAAS,CAAgB;IACjC,OAAO,CAAC,QAAQ,CAAqB;IACrC,OAAO,CAAC,UAAU,CAAC,CAAS;IAC5B,OAAO,CAAC,OAAO,CAA6B;IAC5C,OAAO,CAAC,KAAK,CAAiB;gBAElB,OAAO,EAAE,gBAAgB;IA4BrC;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAyC5B;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAuB3B;;OAEG;IACH,QAAQ,IAAI,cAAc;IAO1B;;OAEG;YACW,gBAAgB;IAmB9B;;OAEG;YACW,YAAY;IAqC1B;;OAEG;YACW,aAAa;IAoB3B;;OAEG;YACW,WAAW;IAezB;;OAEG;IACH,OAAO,CAAC,oBAAoB;IA0C5B;;OAEG;IACH,OAAO,CAAC,WAAW;IAsBnB;;OAEG;YACW,WAAW;CAK1B"}

package/dist/services/dev-server/dev-server.service.js

@@ -0,0 +1,290 @@
+/**
+ * Development Server Service
+ *
+ * Orchestrates file watching, validation, and WebSocket updates
+ *
+ * Features:
+ * - Hot reload on manifest changes
+ * - Real-time validation
+ * - WebSocket updates to clients
+ * - HTTP server with test UI
+ *
+ * SOLID: Single Responsibility - Dev server orchestration
+ */
+import { createServer } from 'http';
+import { readFile } from 'fs/promises';
+import path from 'path';
+import { FileWatcher } from './file-watcher.js';
+import { LiveValidator } from './live-validator.js';
+import { DevWebSocketServer } from './websocket-server.js';
+import { fileURLToPath } from 'url';
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+/**
+ * Development Server
+ *
+ * Provides hot reload and live validation for OSSA manifests
+ */
+export class DevServer {
+    fileWatcher;
+    validator;
+    wsServer;
+    httpServer;
+    options;
+    stats;
+    constructor(options) {
+        this.options = {
+            port: 3000,
+            open: false,
+            debounceMs: 300,
+            verbose: false,
+            ...options,
+        };
+        this.validator = new LiveValidator({
+            semanticValidation: true,
+            bestPractices: true,
+            caching: true,
+        });
+        this.wsServer = new DevWebSocketServer({
+            path: '/ws',
+        });
+        this.stats = {
+            startTime: new Date(),
+            watchedFiles: 0,
+            connectedClients: 0,
+            fileChanges: 0,
+            validations: 0,
+        };
+    }
+    /**
+     * Start development server
+     */
+    async start() {
+        console.log('🚀 Starting OSSA Development Server...\n');
+        // Create HTTP server
+        this.httpServer = createServer(this.handleRequest.bind(this));
+        // Start WebSocket server (attached to HTTP server)
+        this.wsServer = new DevWebSocketServer({
+            server: this.httpServer,
+            path: '/ws',
+        });
+        await this.wsServer.start();
+        // Start file watcher
+        this.fileWatcher = new FileWatcher({
+            paths: [this.options.watch],
+            debounceMs: this.options.debounceMs,
+        });
+        this.fileWatcher.onChange(this.handleFileChange.bind(this));
+        await this.fileWatcher.start();
+        // Update stats
+        this.stats.watchedFiles = this.fileWatcher.getWatchedFiles().length;
+        // Start HTTP server
+        await new Promise((resolve) => {
+            this.httpServer.listen(this.options.port, () => {
+                resolve();
+            });
+        });
+        // Print status
+        this.printStatus();
+        // Open browser if requested
+        if (this.options.open) {
+            await this.openBrowser();
+        }
+    }
+    /**
+     * Stop development server
+     */
+    async stop() {
+        console.log('\n🛑 Stopping OSSA Development Server...');
+        if (this.fileWatcher) {
+            await this.fileWatcher.stop();
+        }
+        if (this.wsServer) {
+            await this.wsServer.stop();
+        }
+        if (this.httpServer) {
+            await new Promise((resolve, reject) => {
+                this.httpServer.close((error) => {
+                    if (error)
+                        reject(error);
+                    else
+                        resolve();
+                });
+            });
+        }
+        console.log('✅ Server stopped');
+    }
+    /**
+     * Get current server statistics
+     */
+    getStats() {
+        return {
+            ...this.stats,
+            connectedClients: this.wsServer.getClientCount(),
+        };
+    }
+    /**
+     * Handle file change event
+     */
+    async handleFileChange(event) {
+        this.stats.fileChanges++;
+        if (this.options.verbose) {
+            console.log(`\n📝 File ${event.type}: ${path.basename(event.path)}`);
+        }
+        // Broadcast file change
+        this.wsServer.broadcastFileChange(event);
+        // Validate file
+        if (event.type !== 'unlink') {
+            await this.validateFile(event.path);
+        }
+        // Trigger reload
+        this.wsServer.broadcastReload(event.path, `File ${event.type}`);
+    }
+    /**
+     * Validate a file
+     */
+    async validateFile(filePath) {
+        this.stats.validations++;
+        try {
+            const result = await this.validator.validate(filePath);
+            this.stats.latestValidation = result;
+            // Log validation result
+            if (result.valid) {
+                if (this.options.verbose) {
+                    console.log(`✅ Validation passed (${result.duration}ms)`);
+                }
+            }
+            else {
+                console.log(`\n❌ Validation failed for ${path.basename(filePath)}:`);
+                for (const error of result.errors) {
+                    const location = error.line ? ` (line ${error.line})` : '';
+                    console.log(`   • ${error.message}${location}`);
+                }
+            }
+            if (result.warnings.length > 0 && this.options.verbose) {
+                console.log(`\n⚠️  Warnings:`);
+                for (const warning of result.warnings) {
+                    console.log(`   • ${warning.message}`);
+                }
+            }
+            // Broadcast validation result
+            this.wsServer.broadcastValidation(result);
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            console.error(`Error validating ${filePath}:`, errorMessage);
+            this.wsServer.broadcastError(`Validation error: ${errorMessage}`);
+        }
+    }
+    /**
+     * Handle HTTP requests
+     */
+    async handleRequest(req, res) {
+        const url = req.url || '/';
+        if (url === '/' || url === '/index.html') {
+            // Serve test UI
+            await this.serveTestUI(res);
+        }
+        else if (url === '/stats') {
+            // Serve stats as JSON
+            res.writeHead(200, { 'Content-Type': 'application/json' });
+            res.end(JSON.stringify(this.getStats(), null, 2));
+        }
+        else {
+            // 404
+            res.writeHead(404, { 'Content-Type': 'text/plain' });
+            res.end('Not Found');
+        }
+    }
+    /**
+     * Serve test UI HTML
+     */
+    async serveTestUI(res) {
+        try {
+            const htmlPath = path.join(__dirname, 'test-ui.html');
+            const html = await readFile(htmlPath, 'utf-8');
+            res.writeHead(200, { 'Content-Type': 'text/html' });
+            res.end(html);
+        }
+        catch (_error) {
+            // Generate inline HTML if file not found
+            const inlineHtml = this.generateInlineTestUI();
+            res.writeHead(200, { 'Content-Type': 'text/html' });
+            res.end(inlineHtml);
+        }
+    }
+    /**
+     * Generate inline test UI (fallback)
+     */
+    generateInlineTestUI() {
+        return `<!DOCTYPE html>
+<html>
+<head>
+  <title>OSSA Dev Server</title>
+  <style>
+    body { font-family: system-ui, sans-serif; margin: 0; padding: 20px; background: #1e1e1e; color: #d4d4d4; }
+    h1 { color: #4ec9b0; }
+    pre { background: #2d2d2d; padding: 15px; border-radius: 5px; overflow-x: auto; }
+    .status { padding: 10px; margin: 10px 0; border-radius: 5px; }
+    .success { background: #1e3a1e; border-left: 4px solid #4ec9b0; }
+    .error { background: #3a1e1e; border-left: 4px solid #f48771; }
+    .warning { background: #3a351e; border-left: 4px solid #dcdcaa; }
+  </style>
+</head>
+<body>
+  <h1>🚀 OSSA Development Server</h1>
+  <p>WebSocket connected. Watching for changes...</p>
+  <div id="output"></div>
+  <script>
+    const ws = new WebSocket('ws://' + window.location.host + '/ws');
+    const output = document.getElementById('output');
+
+    ws.onmessage = (event) => {
+      const msg = JSON.parse(event.data);
+      const div = document.createElement('div');
+      div.className = 'status';
+
+      if (msg.type === 'validation') {
+        div.className += msg.data.result.valid ? ' success' : ' error';
+        div.innerHTML = '<pre>' + JSON.stringify(msg.data.result, null, 2) + '</pre>';
+      } else {
+        div.innerHTML = '<pre>' + JSON.stringify(msg, null, 2) + '</pre>';
+      }
+
+      output.insertBefore(div, output.firstChild);
+    };
+  </script>
+</body>
+</html>`;
+    }
+    /**
+     * Print server status
+     */
+    printStatus() {
+        const watchedFiles = this.fileWatcher?.getWatchedFiles() || [];
+        console.log('✅ Server started successfully!\n');
+        console.log(`📡 HTTP Server:  http://localhost:${this.options.port}`);
+        console.log(`🔌 WebSocket:    ws://localhost:${this.options.port}/ws`);
+        console.log(`📂 Watching:     ${this.options.watch}`);
+        console.log(`📄 Files:        ${watchedFiles.length} manifest(s)`);
+        if (this.options.verbose && watchedFiles.length > 0) {
+            console.log('\nWatched files:');
+            for (const file of watchedFiles.slice(0, 5)) {
+                console.log(`   • ${path.basename(file)}`);
+            }
+            if (watchedFiles.length > 5) {
+                console.log(`   ... and ${watchedFiles.length - 5} more`);
+            }
+        }
+        console.log('\n👀 Watching for changes (Ctrl+C to stop)...\n');
+    }
+    /**
+     * Open browser
+     */
+    async openBrowser() {
+        const url = `http://localhost:${this.options.port}`;
+        const { default: open } = await import('open');
+        await open(url);
+    }
+}
+//# sourceMappingURL=dev-server.service.js.map

package/dist/services/dev-server/dev-server.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dev-server.service.js","sourceRoot":"","sources":["../../../src/services/dev-server/dev-server.service.ts"],"names":[],"mappings":"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"}