@bluefly/openstandardagents 0.3.3 → 0.3.6

package/dist/services/structure/agents-folder.service.js

@@ -0,0 +1,318 @@
+/**
+ * Agent Folder Structure Service
+ *
+ * Creates complete, standardized .agents folder structure following
+ * OpenAPI-first, API-first, Zod, CRUD, SOLID, and DRY principles.
+ *
+ * SOLID: Single Responsibility - Only creates folder structure
+ * DRY: Single source of truth (manifest), all code generated
+ */
+import * as fs from 'fs';
+import * as path from 'path';
+export class AgentsFolderService {
+    /**
+     * Generate complete agent folder structure
+     */
+    generateStructure(agentName, basePath = '.agents') {
+        const agentDir = path.join(basePath, agentName);
+        const directories = [
+            // Core structure
+            agentDir,
+            path.join(agentDir, 'prompts'),
+            path.join(agentDir, 'prompts', 'examples'),
+            path.join(agentDir, 'tools'),
+            path.join(agentDir, 'tools', 'functions'),
+            path.join(agentDir, 'tools', 'schemas'),
+            path.join(agentDir, 'skills'),
+            path.join(agentDir, 'config'),
+            path.join(agentDir, 'api'),
+            path.join(agentDir, 'src'),
+            path.join(agentDir, 'src', 'adapters'),
+            path.join(agentDir, 'src', 'runtime'),
+            path.join(agentDir, 'src', 'mcp'),
+            path.join(agentDir, 'tests'),
+            path.join(agentDir, 'tests', 'unit'),
+            path.join(agentDir, 'tests', 'integration'),
+            path.join(agentDir, 'tests', 'fixtures'),
+            path.join(agentDir, 'docs'),
+            path.join(agentDir, 'docker'),
+            path.join(agentDir, 'k8s'),
+        ];
+        const files = [
+            // Core manifest (will be created by wizard/scaffold)
+            {
+                path: path.join(agentDir, 'manifest.ossa.yaml'),
+                content: '# OSSA Manifest - Single Source of Truth\n# Generated by ossa wizard\n',
+                description: 'OSSA manifest (single source of truth)',
+            },
+            // OpenAPI spec placeholder (will be generated)
+            {
+                path: path.join(agentDir, 'openapi.yaml'),
+                content: '# OpenAPI 3.1 Specification\n# Generated from manifest.ossa.yaml\n# Use: ossa generate openapi\n',
+                description: 'OpenAPI spec (generated from manifest)',
+            },
+            // Zod schemas placeholder (will be generated)
+            {
+                path: path.join(agentDir, 'zod-schemas.ts'),
+                content: '// Zod schemas generated from OpenAPI\n// Use: ossa generate zod\n',
+                description: 'Zod schemas (generated from OpenAPI)',
+            },
+            // API client placeholder (will be generated)
+            {
+                path: path.join(agentDir, 'api-client.ts'),
+                content: '// Type-safe API client generated from OpenAPI\n// Use: ossa generate client\n',
+                description: 'API client (generated from OpenAPI)',
+            },
+            // Prompt templates
+            {
+                path: path.join(agentDir, 'prompts', 'system.txt'),
+                content: "# System Prompt\n# Define the agent's role and behavior\n",
+                description: 'System prompt template',
+            },
+            {
+                path: path.join(agentDir, 'prompts', 'user-template.jinja2'),
+                content: '# User Prompt Template\n# Jinja2 template for user prompts\n',
+                description: 'User prompt template (Jinja2)',
+            },
+            // Tools configuration
+            {
+                path: path.join(agentDir, 'tools', 'tools.yaml'),
+                content: '# Tool Registry\n# MCP-first tool definitions\n',
+                description: 'Tool registry (MCP-first)',
+            },
+            {
+                path: path.join(agentDir, 'tools', 'mcp-servers.yaml'),
+                content: '# MCP Server Configurations\n# Model Context Protocol servers\n',
+                description: 'MCP server configurations',
+            },
+            // Config files
+            {
+                path: path.join(agentDir, 'config', 'development.yaml'),
+                content: '# Development Configuration\n',
+                description: 'Development config',
+            },
+            {
+                path: path.join(agentDir, 'config', 'staging.yaml'),
+                content: '# Staging Configuration\n',
+                description: 'Staging config',
+            },
+            {
+                path: path.join(agentDir, 'config', 'production.yaml'),
+                content: '# Production Configuration\n',
+                description: 'Production config',
+            },
+            {
+                path: path.join(agentDir, 'config', 'local.yaml'),
+                content: '# Local Configuration\n',
+                description: 'Local config',
+            },
+            // API structure (CRUD)
+            {
+                path: path.join(agentDir, 'api', 'routes.ts'),
+                content: `// REST API Routes\n// Generated from OpenAPI spec\nimport { Router } from 'express';\n\nconst router = Router();\n\n// Routes will be generated from OpenAPI spec\n\nexport default router;\n`,
+                description: 'API routes (generated from OpenAPI)',
+            },
+            {
+                path: path.join(agentDir, 'api', 'controllers.ts'),
+                content: `// API Controllers (SOLID)\n// Single Responsibility: HTTP handling only\n\nimport type { Request, Response } from 'express';\n\nexport class AgentController {\n  // Controllers will be generated\n}\n`,
+                description: 'API controllers (SOLID)',
+            },
+            {
+                path: path.join(agentDir, 'api', 'services.ts'),
+                content: `// Business Logic Services (SOLID)\n// Single Responsibility: Business logic only\n\nexport class AgentService {\n  // Services will be generated\n}\n`,
+                description: 'Business logic services (SOLID)',
+            },
+            {
+                path: path.join(agentDir, 'api', 'repositories.ts'),
+                content: `// Data Access Repositories (SOLID)\n// Single Responsibility: Data access only\n\nexport interface IAgentRepository {\n  // Repository interface will be generated\n}\n`,
+                description: 'Data access repositories (SOLID)',
+            },
+            {
+                path: path.join(agentDir, 'api', 'middleware.ts'),
+                content: `// API Middleware\n// Validation, auth, error handling\n\nimport { z } from 'zod';\n\n// Middleware will be generated\n`,
+                description: 'API middleware (validation, auth)',
+            },
+            // Source code structure
+            {
+                path: path.join(agentDir, 'src', 'index.ts'),
+                content: `// Agent Entry Point\n// Platform-agnostic runtime\n\nimport { AgentRuntime } from './runtime/agent-runtime.js';\n\nexport { AgentRuntime };\n`,
+                description: 'Agent entry point',
+            },
+            {
+                path: path.join(agentDir, 'src', 'adapters', 'base.adapter.ts'),
+                content: `// Base LLM Adapter Interface (SOLID)\n// All adapters must implement this interface\n\nexport interface BaseAdapter {\n  initialize(manifest: OssaManifest): void;\n  chat(message: string, options?: RunOptions): Promise<string>;\n  chatStream(message: string, options?: RunOptions): AsyncGenerator<string>;\n  registerToolHandler(name: string, handler: ToolHandler): void;\n  getConversationHistory(): Message[];\n  clearHistory(): void;\n  getAgentInfo(): AgentInfo;\n}\n`,
+                description: 'Base adapter interface (SOLID)',
+            },
+            {
+                path: path.join(agentDir, 'src', 'runtime', 'agent-runtime.ts'),
+                content: `// Agent Runtime\n// Platform-agnostic runtime binding\n\nimport { loadManifest } from '@ossa/sdk';\nimport { getAdapter } from '../adapters.js';\n\nexport class AgentRuntime {\n  private adapter: BaseAdapter;\n\n  async initialize(manifestPath: string) {\n    const manifest = await loadManifest(manifestPath);\n    const provider = manifest.spec.llm?.provider || 'anthropic';\n    this.adapter = getAdapter(provider);\n    this.adapter.initialize(manifest);\n  }\n\n  async chat(message: string) {\n    return this.adapter.chat(message);\n  }\n}\n`,
+                description: 'Agent runtime (platform-agnostic)',
+            },
+            {
+                path: path.join(agentDir, 'src', 'mcp', 'mcp-client.ts'),
+                content: `// MCP Client\n// Model Context Protocol integration\n\nimport { Client } from '@modelcontextprotocol/sdk/client';\n\nexport class MCPClient {\n  // MCP client implementation\n}\n`,
+                description: 'MCP client integration',
+            },
+            // Test structure
+            {
+                path: path.join(agentDir, 'tests', 'unit', 'adapters.test.ts'),
+                content: `// Adapter Unit Tests\nimport { describe, it, expect } from 'vitest';\n\n// Tests will be generated\n`,
+                description: 'Adapter unit tests',
+            },
+            {
+                path: path.join(agentDir, 'tests', 'unit', 'api.test.ts'),
+                content: `// API Unit Tests\nimport { describe, it, expect } from 'vitest';\n\n// Tests will be generated\n`,
+                description: 'API unit tests',
+            },
+            {
+                path: path.join(agentDir, 'tests', 'integration', 'agent.test.ts'),
+                content: `// Agent Integration Tests\nimport { describe, it, expect } from 'vitest';\n\n// Tests will be generated\n`,
+                description: 'Agent integration tests',
+            },
+            // Documentation
+            {
+                path: path.join(agentDir, 'docs', 'architecture.md'),
+                content: `# Architecture Documentation\n\n## Overview\n\nThis agent follows OpenAPI-first, API-first, Zod, CRUD, SOLID, and DRY principles.\n\n## Structure\n\n- \`manifest.ossa.yaml\` - Single source of truth\n- \`openapi.yaml\` - Generated from manifest\n- \`zod-schemas.ts\` - Generated from OpenAPI\n- \`api-client.ts\` - Generated from OpenAPI\n`,
+                description: 'Architecture documentation',
+            },
+            {
+                path: path.join(agentDir, 'docs', 'api.md'),
+                content: `# API Documentation\n\nGenerated from OpenAPI spec.\n\nUse: \`ossa docs generate\`\n`,
+                description: 'API documentation (from OpenAPI)',
+            },
+            // Docker
+            {
+                path: path.join(agentDir, 'docker', 'Dockerfile'),
+                content: `# Dockerfile\n# Multi-stage build for production\n\nFROM node:20-alpine AS builder\nWORKDIR /app\nCOPY package*.json ./\nRUN npm ci\nCOPY . .\nRUN npm run build\n\nFROM node:20-alpine\nWORKDIR /app\nCOPY --from=builder /app/dist ./dist\nCOPY --from=builder /app/node_modules ./node_modules\nCMD ["node", "dist/index.js"]\n`,
+                description: 'Dockerfile',
+            },
+            // Kubernetes
+            {
+                path: path.join(agentDir, 'k8s', 'deployment.yaml'),
+                content: `# Kubernetes Deployment\n# Generated from manifest\n\napiVersion: apps/v1\nkind: Deployment\nmetadata:\n  name: ${agentName}\nspec:\n  replicas: 1\n  selector:\n    matchLabels:\n      app: ${agentName}\n  template:\n    metadata:\n      labels:\n        app: ${agentName}\n    spec:\n      containers:\n      - name: ${agentName}\n        image: ${agentName}:latest\n`,
+                description: 'Kubernetes deployment',
+            },
+            // Root files
+            {
+                path: path.join(agentDir, 'package.json'),
+                content: JSON.stringify({
+                    name: agentName,
+                    version: '1.0.0',
+                    type: 'module',
+                    main: 'dist/index.js',
+                    scripts: {
+                        build: 'tsc',
+                        test: 'vitest',
+                        validate: 'ossa validate manifest.ossa.yaml',
+                        'generate:openapi': 'ossa generate openapi manifest.ossa.yaml',
+                        'generate:zod': 'ossa generate zod openapi.yaml',
+                        'generate:client': 'ossa generate client openapi.yaml',
+                    },
+                    dependencies: {
+                        '@ossa/sdk': '^0.3.5',
+                        zod: '^3.22.0',
+                    },
+                    devDependencies: {
+                        '@types/node': '^20.0.0',
+                        typescript: '^5.0.0',
+                        vitest: '^1.0.0',
+                    },
+                }, null, 2),
+                description: 'package.json',
+            },
+            {
+                path: path.join(agentDir, 'tsconfig.json'),
+                content: JSON.stringify({
+                    compilerOptions: {
+                        target: 'ES2022',
+                        module: 'ESNext',
+                        lib: ['ES2022'],
+                        moduleResolution: 'node',
+                        outDir: './dist',
+                        rootDir: './src',
+                        strict: true,
+                        esModuleInterop: true,
+                        skipLibCheck: true,
+                        forceConsistentCasingInFileNames: true,
+                    },
+                    include: ['src/**/*'],
+                    exclude: ['node_modules', 'dist', 'tests'],
+                }, null, 2),
+                description: 'TypeScript config',
+            },
+            {
+                path: path.join(agentDir, 'AGENTS.md'),
+                content: `# AGENTS.md\n\n## Dev environment tips\n\n- Use Node.js 20+\n- Run \`npm install\` to install dependencies\n- Run \`npm run build\` to build\n\n## Testing instructions\n\n- Run \`npm test\` for unit tests\n- Run \`npm run test:integration\` for integration tests\n\n## PR instructions\n\n- Use conventional commits\n- Run \`npm run validate\` before committing\n`,
+                description: 'AGENTS.md (AAIF standard)',
+            },
+            {
+                path: path.join(agentDir, 'README.md'),
+                content: `# ${agentName}\n\nOSSA-compliant agent following OpenAPI-first, API-first, Zod, CRUD, SOLID, and DRY principles.\n\n## Structure\n\n- \`manifest.ossa.yaml\` - Single source of truth\n- \`openapi.yaml\` - Generated from manifest\n- \`zod-schemas.ts\` - Generated from OpenAPI\n- \`api-client.ts\` - Generated from OpenAPI\n\n## Usage\n\n\`\`\`bash\n# Validate manifest\nossa validate manifest.ossa.yaml\n\n# Generate OpenAPI\nossa generate openapi manifest.ossa.yaml\n\n# Generate Zod schemas\nossa generate zod openapi.yaml\n\n# Generate API client\nossa generate client openapi.yaml\n\`\`\`\n`,
+                description: 'README.md',
+            },
+        ];
+        return {
+            agentName,
+            basePath,
+            directories,
+            files,
+        };
+    }
+    /**
+     * Create folder structure on filesystem
+     */
+    createStructure(structure, overwrite = false) {
+        // Create directories
+        for (const dir of structure.directories) {
+            if (fs.existsSync(dir) && !overwrite) {
+                continue;
+            }
+            fs.mkdirSync(dir, { recursive: true });
+        }
+        // Create files
+        for (const file of structure.files) {
+            if (fs.existsSync(file.path) && !overwrite) {
+                continue;
+            }
+            fs.writeFileSync(file.path, file.content, 'utf-8');
+        }
+    }
+    /**
+     * Validate folder structure
+     */
+    validateStructure(agentDir) {
+        const errors = [];
+        const requiredDirs = [
+            'prompts',
+            'tools',
+            'config',
+            'api',
+            'src',
+            'tests',
+            'docs',
+        ];
+        const requiredFiles = [
+            'manifest.ossa.yaml',
+            'package.json',
+            'tsconfig.json',
+            'README.md',
+        ];
+        for (const dir of requiredDirs) {
+            const dirPath = path.join(agentDir, dir);
+            if (!fs.existsSync(dirPath)) {
+                errors.push(`Missing directory: ${dir}`);
+            }
+        }
+        for (const file of requiredFiles) {
+            const filePath = path.join(agentDir, file);
+            if (!fs.existsSync(filePath)) {
+                errors.push(`Missing file: ${file}`);
+            }
+        }
+        return {
+            valid: errors.length === 0,
+            errors,
+        };
+    }
+}
+//# sourceMappingURL=agents-folder.service.js.map

package/dist/services/structure/agents-folder.service.js.map

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

package/dist/services/taxonomy-validator.service.d.ts

@@ -0,0 +1,25 @@
+import { OssaAgent } from '../types/index.js';
+export interface TaxonomyValidationResult {
+    valid: boolean;
+    errors: string[];
+    warnings: string[];
+    conflicts: TaxonomyConflict[];
+}
+export interface TaxonomyConflict {
+    field: string;
+    value: string;
+    reason: string;
+    suggestion?: string;
+}
+export declare class TaxonomyValidatorService {
+    private taxonomyService;
+    constructor();
+    validate(manifest: OssaAgent): Promise<TaxonomyValidationResult>;
+    private checkConflicts;
+    private checkConsistency;
+    validateAgainstSpec(taxonomy: Record<string, unknown>): Promise<{
+        valid: boolean;
+        errors: string[];
+    }>;
+}
+//# sourceMappingURL=taxonomy-validator.service.d.ts.map

package/dist/services/taxonomy-validator.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"taxonomy-validator.service.d.ts","sourceRoot":"","sources":["../../src/services/taxonomy-validator.service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAI9C,MAAM,WAAW,wBAAwB;IACvC,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,SAAS,EAAE,gBAAgB,EAAE,CAAC;CAC/B;AAED,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,qBAAa,wBAAwB;IACnC,OAAO,CAAC,eAAe,CAAkB;;IAMnC,QAAQ,CAAC,QAAQ,EAAE,SAAS,GAAG,OAAO,CAAC,wBAAwB,CAAC;IA6EtE,OAAO,CAAC,cAAc;IAmDtB,OAAO,CAAC,gBAAgB;IA8BlB,mBAAmB,CACvB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAChC,OAAO,CAAC;QAAE,KAAK,EAAE,OAAO,CAAC;QAAC,MAAM,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC;CA8BjD"}

package/dist/services/taxonomy-validator.service.js

@@ -0,0 +1,149 @@
+import { TaxonomyService } from './taxonomy.service.js';
+import { container } from '../di-container.js';
+export class TaxonomyValidatorService {
+    taxonomyService;
+    constructor() {
+        this.taxonomyService = container.get(TaxonomyService);
+    }
+    async validate(manifest) {
+        const result = {
+            valid: true,
+            errors: [],
+            warnings: [],
+            conflicts: [],
+        };
+        const taxonomy = manifest.spec?.taxonomy;
+        if (!taxonomy) {
+            result.warnings.push('No taxonomy specified in manifest');
+            return result;
+        }
+        const taxonomySpec = await this.taxonomyService.loadTaxonomy();
+        // Validate maturity level
+        if (taxonomy.maturity) {
+            const maturity = taxonomy.maturity;
+            if (!taxonomySpec.maturity_levels?.[maturity]) {
+                result.errors.push(`Invalid maturity level: ${maturity}`);
+                result.valid = false;
+            }
+        }
+        // Validate deployment pattern
+        if (taxonomy.deployment_pattern) {
+            const deployment = taxonomy.deployment_pattern;
+            if (!taxonomySpec.deployment_patterns?.[deployment]) {
+                result.errors.push(`Invalid deployment pattern: ${deployment}`);
+                result.valid = false;
+            }
+        }
+        // Validate integration pattern
+        if (taxonomy.integration_pattern) {
+            const integration = taxonomy.integration_pattern;
+            if (!taxonomySpec.integration_patterns?.[integration]) {
+                result.errors.push(`Invalid integration pattern: ${integration}`);
+                result.valid = false;
+            }
+        }
+        // Validate cost profile
+        if (taxonomy.cost_profile) {
+            const cost = taxonomy.cost_profile;
+            if (!taxonomySpec.cost_profiles?.[cost]) {
+                result.errors.push(`Invalid cost profile: ${cost}`);
+                result.valid = false;
+            }
+        }
+        // Validate performance tier
+        if (taxonomy.performance_tier) {
+            const performance = taxonomy.performance_tier;
+            if (!taxonomySpec.performance_tiers?.[performance]) {
+                result.errors.push(`Invalid performance tier: ${performance}`);
+                result.valid = false;
+            }
+        }
+        // Check for conflicts
+        const conflicts = this.checkConflicts(taxonomy, manifest);
+        result.conflicts = conflicts;
+        if (conflicts.length > 0) {
+            result.warnings.push(`${conflicts.length} taxonomy conflict(s) detected`);
+        }
+        // Check consistency
+        const consistencyIssues = this.checkConsistency(taxonomy, manifest);
+        result.warnings.push(...consistencyIssues);
+        return result;
+    }
+    checkConflicts(taxonomy, manifest) {
+        const conflicts = [];
+        // Check maturity vs deployment pattern conflicts
+        if (taxonomy.maturity === 'prototype' &&
+            taxonomy.deployment_pattern === 'serverless') {
+            conflicts.push({
+                field: 'deployment_pattern',
+                value: taxonomy.deployment_pattern,
+                reason: 'Prototype agents typically use container deployment for easier debugging',
+                suggestion: 'container',
+            });
+        }
+        // Check cost profile vs performance tier conflicts
+        if (taxonomy.cost_profile === 'low' &&
+            taxonomy.performance_tier === 'real-time') {
+            conflicts.push({
+                field: 'performance_tier',
+                value: taxonomy.performance_tier,
+                reason: 'Real-time performance typically requires higher cost infrastructure',
+                suggestion: 'near-real-time',
+            });
+        }
+        // Check integration pattern vs deployment pattern conflicts
+        if (taxonomy.integration_pattern === 'streaming' &&
+            taxonomy.deployment_pattern === 'serverless') {
+            conflicts.push({
+                field: 'deployment_pattern',
+                value: taxonomy.deployment_pattern,
+                reason: 'Streaming integration typically requires container or edge deployment',
+                suggestion: 'container',
+            });
+        }
+        return conflicts;
+    }
+    checkConsistency(taxonomy, manifest) {
+        const issues = [];
+        // Check domain consistency
+        const domain = taxonomy.domain;
+        const labels = manifest.metadata?.labels || {};
+        const labelDomain = labels['ossa.ai/domain'];
+        if (domain && labelDomain && domain !== labelDomain) {
+            issues.push(`Taxonomy domain (${domain}) differs from label domain (${labelDomain})`);
+        }
+        // Check agent type consistency
+        const agentType = taxonomy.agent_type;
+        const labelType = labels['ossa.ai/type'];
+        if (agentType && labelType && agentType !== labelType) {
+            issues.push(`Taxonomy agent type (${agentType}) differs from label type (${labelType})`);
+        }
+        return issues;
+    }
+    async validateAgainstSpec(taxonomy) {
+        const taxonomySpec = await this.taxonomyService.loadTaxonomy();
+        const errors = [];
+        // Validate all taxonomy fields against spec
+        const fields = [
+            'maturity',
+            'deployment_pattern',
+            'integration_pattern',
+            'cost_profile',
+            'performance_tier',
+        ];
+        for (const field of fields) {
+            const value = taxonomy[field];
+            if (!value)
+                continue;
+            const specSection = taxonomySpec[`${field}s`];
+            if (!specSection || !specSection[value]) {
+                errors.push(`Invalid ${field}: ${value}`);
+            }
+        }
+        return {
+            valid: errors.length === 0,
+            errors,
+        };
+    }
+}
+//# sourceMappingURL=taxonomy-validator.service.js.map

package/dist/services/taxonomy-validator.service.js.map

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

package/dist/services/taxonomy.service.d.ts

@@ -0,0 +1,132 @@
+/**
+ * Taxonomy Service
+ * Classification engine for OSSA agents with 20+ classification dimensions
+ */
+import type { OssaAgent } from '../types/index.js';
+export interface TaxonomyClassification {
+    domain: string;
+    subdomain?: string;
+    capability?: string;
+    concerns?: string[];
+    maturity?: 'prototype' | 'beta' | 'stable' | 'production';
+    deploymentPattern?: 'serverless' | 'container' | 'edge' | 'hybrid';
+    integrationPattern?: 'api-first' | 'event-driven' | 'batch' | 'streaming';
+    costProfile?: 'low' | 'medium' | 'high' | 'enterprise';
+    performanceTier?: 'real-time' | 'near-real-time' | 'batch';
+    agentType?: string;
+}
+export interface TaxonomyRecommendation {
+    classification: TaxonomyClassification;
+    confidence: number;
+    reasoning: string[];
+    alternatives?: TaxonomyClassification[];
+}
+export interface TaxonomySpec {
+    domains: Record<string, {
+        description: string;
+        subdomains?: string[];
+        examples?: string[];
+    }>;
+    concerns?: Record<string, {
+        description: string;
+        applies_to: string[];
+    }>;
+    maturity_levels?: Record<string, {
+        description: string;
+        stability: string;
+        testing_required: string;
+        documentation_required: string;
+        use_cases: string[];
+    }>;
+    deployment_patterns?: Record<string, {
+        description: string;
+        examples: string[];
+        characteristics: string[];
+        use_cases: string[];
+    }>;
+    integration_patterns?: Record<string, {
+        description: string;
+        protocols: string[];
+        characteristics: string[];
+        use_cases: string[];
+    }>;
+    cost_profiles?: Record<string, {
+        description: string;
+        estimated_monthly_cost: string;
+        characteristics: string[];
+        use_cases: string[];
+    }>;
+    performance_tiers?: Record<string, {
+        description: string;
+        latency_requirement: string;
+        throughput: string;
+        use_cases: string[];
+    }>;
+    agent_types?: Record<string, {
+        description: string;
+        typical_domains: string[];
+        recommended_tier?: string;
+    }>;
+}
+export declare class TaxonomyService {
+    /**
+     * Load taxonomy specification
+     */
+    loadTaxonomy(): Promise<TaxonomySpec>;
+    /**
+     * Classify agent based on manifest
+     */
+    classifyAgent(manifest: OssaAgent): Promise<TaxonomyClassification>;
+    /**
+     * Recommend taxonomy based on use case
+     */
+    recommendTaxonomy(useCase: string, agentType?: string): Promise<TaxonomyRecommendation>;
+    /**
+     * Validate taxonomy classification
+     */
+    validateTaxonomy(classification: TaxonomyClassification): Promise<{
+        valid: boolean;
+        errors: string[];
+    }>;
+    /**
+     * Infer domain from agent manifest
+     */
+    private inferDomain;
+    /**
+     * Infer agent type from manifest
+     */
+    private inferAgentType;
+    /**
+     * Match domain from use case
+     */
+    private matchDomainFromUseCase;
+    /**
+     * Match subdomain from use case
+     */
+    private matchSubdomainFromUseCase;
+    /**
+     * Match concerns from use case
+     */
+    private matchConcernsFromUseCase;
+    /**
+     * Infer deployment pattern from use case
+     */
+    private inferDeploymentPattern;
+    /**
+     * Infer integration pattern from use case
+     */
+    private inferIntegrationPattern;
+    /**
+     * Infer cost profile from use case
+     */
+    private inferCostProfile;
+    /**
+     * Infer performance tier from use case
+     */
+    private inferPerformanceTier;
+    /**
+     * Infer agent type from use case
+     */
+    private inferAgentTypeFromUseCase;
+}
+//# sourceMappingURL=taxonomy.service.d.ts.map

package/dist/services/taxonomy.service.d.ts.map

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