@bluefly/openstandardagents 0.4.2 → 0.4.4

package/dist/adapters/base/manifest-validator.d.ts

@@ -0,0 +1,84 @@
+/**
+ * Shared Manifest Validator
+ *
+ * Centralized validation logic for OSSA manifests, extracted from
+ * duplicated validation code across all adapters.
+ *
+ * SOLID: Single Responsibility - Manifest validation only
+ * DRY: Single source of truth for validation rules
+ *
+ * TODO: Consolidate into ValidationZodService. This module duplicates
+ * validation logic that exists in src/services/validation-zod.service.ts.
+ * Adapters currently depend on these functions directly, so migration
+ * requires updating all adapter imports in a separate pass.
+ */
+import type { OssaAgent } from '../../types/index.js';
+import type { ValidationError, ValidationWarning } from './adapter.interface.js';
+/**
+ * Validation result from shared validator
+ */
+export interface ManifestValidationResult {
+    valid: boolean;
+    errors: ValidationError[];
+    warnings: ValidationWarning[];
+}
+/**
+ * Validate core OSSA manifest fields required by all adapters.
+ *
+ * Checks metadata.name, metadata.version, spec.role, and
+ * basic structural integrity.
+ *
+ * @param manifest - OSSA agent manifest
+ * @returns Validation result with errors and warnings
+ */
+export declare function validate(manifest: OssaAgent): ManifestValidationResult;
+/**
+ * Validate workflow steps in a manifest.
+ *
+ * @param workflow - Workflow configuration from manifest.spec.workflow
+ * @returns Validation result
+ */
+export declare function validateWorkflow(workflow: OssaAgent['spec'] extends {
+    workflow?: infer W;
+} ? W : unknown): ManifestValidationResult;
+/**
+ * Validate LLM configuration.
+ *
+ * @param llm - LLM config from manifest.spec.llm
+ * @param supportedProviders - Optional list of supported providers for this platform
+ * @returns Validation result
+ */
+export declare function validateLLM(llm: OssaAgent['spec'] extends {
+    llm?: infer L;
+} ? L : unknown, supportedProviders?: string[]): ManifestValidationResult;
+/**
+ * Validate tool definitions.
+ *
+ * @param tools - Tool array from manifest.spec.tools
+ * @returns Validation result
+ */
+export declare function validateTools(tools: OssaAgent['spec'] extends {
+    tools?: infer T;
+} ? T : unknown): ManifestValidationResult;
+/**
+ * Validate semver version string.
+ *
+ * @param version - Version string to validate
+ * @returns true if valid semver
+ */
+export declare function isValidSemver(version: string): boolean;
+/**
+ * Validate npm package name.
+ *
+ * @param name - Package name to validate
+ * @returns true if valid npm name
+ */
+export declare function isValidNpmName(name: string): boolean;
+/**
+ * Merge multiple validation results into one.
+ *
+ * @param results - Array of validation results to merge
+ * @returns Combined validation result
+ */
+export declare function mergeResults(...results: ManifestValidationResult[]): ManifestValidationResult;
+//# sourceMappingURL=manifest-validator.d.ts.map

package/dist/adapters/base/manifest-validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest-validator.d.ts","sourceRoot":"","sources":["../../../src/adapters/base/manifest-validator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,KAAK,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAEjF;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,eAAe,EAAE,CAAC;IAC1B,QAAQ,EAAE,iBAAiB,EAAE,CAAC;CAC/B;AAED;;;;;;;;GAQG;AACH,wBAAgB,QAAQ,CAAC,QAAQ,EAAE,SAAS,GAAG,wBAAwB,CA2DtE;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,SAAS,CAAC,MAAM,CAAC,SAAS;IAAE,QAAQ,CAAC,EAAE,MAAM,CAAC,CAAA;CAAE,GAAG,CAAC,GAAG,OAAO,GACvE,wBAAwB,CAoC1B;AAED;;;;;;GAMG;AACH,wBAAgB,WAAW,CACzB,GAAG,EAAE,SAAS,CAAC,MAAM,CAAC,SAAS;IAAE,GAAG,CAAC,EAAE,MAAM,CAAC,CAAA;CAAE,GAAG,CAAC,GAAG,OAAO,EAC9D,kBAAkB,CAAC,EAAE,MAAM,EAAE,GAC5B,wBAAwB,CAgE1B;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAC3B,KAAK,EAAE,SAAS,CAAC,MAAM,CAAC,SAAS;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC,CAAA;CAAE,GAAG,CAAC,GAAG,OAAO,GACjE,wBAAwB,CAkD1B;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAGtD;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAGpD;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAC1B,GAAG,OAAO,EAAE,wBAAwB,EAAE,GACrC,wBAAwB,CAc1B"}

package/dist/adapters/base/manifest-validator.js

@@ -0,0 +1,266 @@
+/**
+ * Shared Manifest Validator
+ *
+ * Centralized validation logic for OSSA manifests, extracted from
+ * duplicated validation code across all adapters.
+ *
+ * SOLID: Single Responsibility - Manifest validation only
+ * DRY: Single source of truth for validation rules
+ *
+ * TODO: Consolidate into ValidationZodService. This module duplicates
+ * validation logic that exists in src/services/validation-zod.service.ts.
+ * Adapters currently depend on these functions directly, so migration
+ * requires updating all adapter imports in a separate pass.
+ */
+/**
+ * Validate core OSSA manifest fields required by all adapters.
+ *
+ * Checks metadata.name, metadata.version, spec.role, and
+ * basic structural integrity.
+ *
+ * @param manifest - OSSA agent manifest
+ * @returns Validation result with errors and warnings
+ */
+export function validate(manifest) {
+    const errors = [];
+    const warnings = [];
+    if (!manifest) {
+        errors.push({
+            message: 'Manifest is required',
+            code: 'MISSING_MANIFEST',
+        });
+        return { valid: false, errors, warnings };
+    }
+    // Required fields
+    if (!manifest.metadata?.name) {
+        errors.push({
+            message: 'metadata.name is required',
+            path: 'metadata.name',
+            code: 'MISSING_REQUIRED_FIELD',
+        });
+    }
+    if (!manifest.metadata?.version) {
+        errors.push({
+            message: 'metadata.version is required',
+            path: 'metadata.version',
+            code: 'MISSING_REQUIRED_FIELD',
+        });
+    }
+    // Recommended fields
+    if (!manifest.spec?.role) {
+        warnings.push({
+            message: 'spec.role is recommended for better agent behavior',
+            path: 'spec.role',
+            suggestion: 'Add a system prompt describing the agent role',
+        });
+    }
+    if (!manifest.metadata?.description) {
+        warnings.push({
+            message: 'metadata.description is recommended',
+            path: 'metadata.description',
+            suggestion: 'Add a description for better discoverability',
+        });
+    }
+    if (!manifest.metadata?.license) {
+        warnings.push({
+            message: 'metadata.license is recommended',
+            path: 'metadata.license',
+            suggestion: 'Add a license (e.g., "MIT", "Apache-2.0")',
+        });
+    }
+    return {
+        valid: errors.length === 0,
+        errors,
+        warnings,
+    };
+}
+/**
+ * Validate workflow steps in a manifest.
+ *
+ * @param workflow - Workflow configuration from manifest.spec.workflow
+ * @returns Validation result
+ */
+export function validateWorkflow(workflow) {
+    const errors = [];
+    const warnings = [];
+    if (!workflow) {
+        return { valid: true, errors, warnings };
+    }
+    const wf = workflow;
+    if (wf.steps && Array.isArray(wf.steps)) {
+        if (wf.steps.length === 0) {
+            warnings.push({
+                message: 'Workflow has no steps defined',
+                path: 'spec.workflow.steps',
+                suggestion: 'Add at least one workflow step',
+            });
+        }
+        for (let i = 0; i < wf.steps.length; i++) {
+            const step = wf.steps[i];
+            if (!step) {
+                errors.push({
+                    message: `Workflow step at index ${i} is empty`,
+                    path: `spec.workflow.steps[${i}]`,
+                    code: 'INVALID_WORKFLOW_STEP',
+                });
+            }
+        }
+    }
+    return {
+        valid: errors.length === 0,
+        errors,
+        warnings,
+    };
+}
+/**
+ * Validate LLM configuration.
+ *
+ * @param llm - LLM config from manifest.spec.llm
+ * @param supportedProviders - Optional list of supported providers for this platform
+ * @returns Validation result
+ */
+export function validateLLM(llm, supportedProviders) {
+    const errors = [];
+    const warnings = [];
+    if (!llm) {
+        warnings.push({
+            message: 'No LLM configuration found, adapter will use defaults',
+            path: 'spec.llm',
+            suggestion: 'Add spec.llm configuration for explicit control',
+        });
+        return { valid: true, errors, warnings };
+    }
+    const llmConfig = llm;
+    if (!llmConfig.provider) {
+        warnings.push({
+            message: 'LLM provider not specified, will use default',
+            path: 'spec.llm.provider',
+            suggestion: 'Add spec.llm.provider field',
+        });
+    }
+    if (!llmConfig.model) {
+        warnings.push({
+            message: 'LLM model not specified, will use default',
+            path: 'spec.llm.model',
+            suggestion: 'Add spec.llm.model field',
+        });
+    }
+    // Check supported providers if provided
+    if (supportedProviders &&
+        llmConfig.provider &&
+        typeof llmConfig.provider === 'string' &&
+        !supportedProviders.includes(llmConfig.provider)) {
+        warnings.push({
+            message: `LLM provider '${llmConfig.provider}' may not be supported. Supported: ${supportedProviders.join(', ')}`,
+            path: 'spec.llm.provider',
+            suggestion: `Use one of: ${supportedProviders.join(', ')}`,
+        });
+    }
+    // Validate temperature range
+    if (llmConfig.temperature !== undefined &&
+        typeof llmConfig.temperature === 'number') {
+        if (llmConfig.temperature < 0 || llmConfig.temperature > 2) {
+            warnings.push({
+                message: `Temperature ${llmConfig.temperature} is outside typical range [0, 2]`,
+                path: 'spec.llm.temperature',
+                suggestion: 'Use a value between 0 and 2',
+            });
+        }
+    }
+    return {
+        valid: errors.length === 0,
+        errors,
+        warnings,
+    };
+}
+/**
+ * Validate tool definitions.
+ *
+ * @param tools - Tool array from manifest.spec.tools
+ * @returns Validation result
+ */
+export function validateTools(tools) {
+    const errors = [];
+    const warnings = [];
+    if (!tools) {
+        return { valid: true, errors, warnings };
+    }
+    if (!Array.isArray(tools)) {
+        errors.push({
+            message: 'spec.tools must be an array',
+            path: 'spec.tools',
+            code: 'INVALID_TOOLS_FORMAT',
+        });
+        return { valid: false, errors, warnings };
+    }
+    if (tools.length === 0) {
+        warnings.push({
+            message: 'No tools defined, agent will have limited capabilities',
+            path: 'spec.tools',
+            suggestion: 'Add tools for agent functionality',
+        });
+        return { valid: true, errors, warnings };
+    }
+    for (let i = 0; i < tools.length; i++) {
+        const tool = tools[i];
+        if (typeof tool === 'string') {
+            // String tool references are valid
+            continue;
+        }
+        if (tool && typeof tool === 'object') {
+            const toolObj = tool;
+            if (!toolObj.name && !toolObj.type) {
+                warnings.push({
+                    message: `Tool at index ${i} has no name or type`,
+                    path: `spec.tools[${i}]`,
+                    suggestion: 'Add a name and type for each tool',
+                });
+            }
+        }
+    }
+    return {
+        valid: errors.length === 0,
+        errors,
+        warnings,
+    };
+}
+/**
+ * Validate semver version string.
+ *
+ * @param version - Version string to validate
+ * @returns true if valid semver
+ */
+export function isValidSemver(version) {
+    const semverRegex = /^\d+\.\d+\.\d+(-[a-z0-9.-]+)?(\+[a-z0-9.-]+)?$/i;
+    return semverRegex.test(version);
+}
+/**
+ * Validate npm package name.
+ *
+ * @param name - Package name to validate
+ * @returns true if valid npm name
+ */
+export function isValidNpmName(name) {
+    const npmNameRegex = /^(@[a-z0-9-~][a-z0-9-._~]*\/)?[a-z0-9-~][a-z0-9-._~]*$/;
+    return npmNameRegex.test(name);
+}
+/**
+ * Merge multiple validation results into one.
+ *
+ * @param results - Array of validation results to merge
+ * @returns Combined validation result
+ */
+export function mergeResults(...results) {
+    const errors = [];
+    const warnings = [];
+    for (const result of results) {
+        errors.push(...result.errors);
+        warnings.push(...result.warnings);
+    }
+    return {
+        valid: errors.length === 0,
+        errors,
+        warnings,
+    };
+}
+//# sourceMappingURL=manifest-validator.js.map

package/dist/adapters/base/manifest-validator.js.map

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

package/dist/adapters/base/template-engine.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Simple Mustache-style Template Engine
+ *
+ * Zero external dependencies. Supports variable interpolation
+ * and conditional blocks for generating adapter output files.
+ *
+ * SOLID: Single Responsibility - Template rendering only
+ * DRY: Reusable across all adapters instead of inline string concatenation
+ */
+/**
+ * Template data - flat key/value pairs for interpolation.
+ * Values can be strings, numbers, booleans, arrays, or undefined.
+ */
+export type TemplateData = Record<string, string | number | boolean | string[] | undefined>;
+/**
+ * Render a template string by replacing {{variable}} placeholders
+ * with values from the data object.
+ *
+ * Missing keys are replaced with empty strings.
+ *
+ * @param template - Template string with {{variable}} placeholders
+ * @param data - Key/value pairs for interpolation
+ * @returns Rendered string
+ */
+export declare function render(template: string, data: TemplateData): string;
+/**
+ * Render a template with conditional block support.
+ *
+ * Supports:
+ *   {{#if key}}...content...{{/if}} - Include block when key is truthy
+ *   {{#unless key}}...content...{{/unless}} - Include block when key is falsy
+ *   {{#each items}}...{{.}}...{{/each}} - Iterate over string arrays
+ *   {{variable}} - Standard variable interpolation
+ *
+ * @param template - Template with conditionals and variables
+ * @param data - Key/value pairs for interpolation and conditionals
+ * @returns Rendered string
+ */
+export declare function renderConditional(template: string, data: TemplateData): string;
+/**
+ * README template with platform-specific sections.
+ * Variables: name, description, role, platform, version, license,
+ *            installCommand, usageCode, toolsList, llmProvider, llmModel,
+ *            llmTemperature, llmMaxTokens, apiVersion
+ */
+export declare const README_TEMPLATE = "# {{name}}\n\n{{description}}\n\n## Description\n\n{{role}}\n\n## Installation\n\n```bash\n{{installCommand}}\n```\n\n## Usage\n\n```\n{{usageCode}}\n```\n\n{{#if toolsList}}\n## Tools\n\n{{toolsList}}\n{{/if}}\n\n{{#if llmProvider}}\n## LLM Configuration\n\n- **Provider**: {{llmProvider}}\n- **Model**: {{llmModel}}\n- **Temperature**: {{llmTemperature}}\n- **Max Tokens**: {{llmMaxTokens}}\n{{/if}}\n\n## Generated from OSSA\n\nThis agent was generated from an OSSA {{apiVersion}} manifest.\n\nOriginal manifest: `agent.ossa.yaml`\n\n## License\n\n{{license}}\n";
+/**
+ * INSTALL section template.
+ * Variables: platform, installCommand, setupSteps
+ */
+export declare const INSTALL_TEMPLATE = "## Installation\n\n### Prerequisites\n\n{{#if prerequisites}}\n{{prerequisites}}\n{{/if}}\n\n### Setup\n\n```bash\n{{installCommand}}\n```\n\n{{#if setupSteps}}\n{{setupSteps}}\n{{/if}}\n";
+//# sourceMappingURL=template-engine.d.ts.map

package/dist/adapters/base/template-engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"template-engine.d.ts","sourceRoot":"","sources":["../../../src/adapters/base/template-engine.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH;;;GAGG;AACH,MAAM,MAAM,YAAY,GAAG,MAAM,CAC/B,MAAM,EACN,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,EAAE,GAAG,SAAS,CACjD,CAAC;AAEF;;;;;;;;;GASG;AACH,wBAAgB,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,YAAY,GAAG,MAAM,CAWnE;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,YAAY,GACjB,MAAM,CAmDR;AAMD;;;;;GAKG;AACH,eAAO,MAAM,eAAe,yjBA4C3B,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,gBAAgB,gMAiB5B,CAAC"}

package/dist/adapters/base/template-engine.js

@@ -0,0 +1,157 @@
+/**
+ * Simple Mustache-style Template Engine
+ *
+ * Zero external dependencies. Supports variable interpolation
+ * and conditional blocks for generating adapter output files.
+ *
+ * SOLID: Single Responsibility - Template rendering only
+ * DRY: Reusable across all adapters instead of inline string concatenation
+ */
+/**
+ * Render a template string by replacing {{variable}} placeholders
+ * with values from the data object.
+ *
+ * Missing keys are replaced with empty strings.
+ *
+ * @param template - Template string with {{variable}} placeholders
+ * @param data - Key/value pairs for interpolation
+ * @returns Rendered string
+ */
+export function render(template, data) {
+    return template.replace(/\{\{(\w+)\}\}/g, (_match, key) => {
+        const value = data[key];
+        if (value === undefined || value === null) {
+            return '';
+        }
+        if (Array.isArray(value)) {
+            return value.join(', ');
+        }
+        return String(value);
+    });
+}
+/**
+ * Render a template with conditional block support.
+ *
+ * Supports:
+ *   {{#if key}}...content...{{/if}} - Include block when key is truthy
+ *   {{#unless key}}...content...{{/unless}} - Include block when key is falsy
+ *   {{#each items}}...{{.}}...{{/each}} - Iterate over string arrays
+ *   {{variable}} - Standard variable interpolation
+ *
+ * @param template - Template with conditionals and variables
+ * @param data - Key/value pairs for interpolation and conditionals
+ * @returns Rendered string
+ */
+export function renderConditional(template, data) {
+    let result = template;
+    // Process {{#each items}}...{{.}}...{{/each}} blocks
+    result = result.replace(/\{\{#each (\w+)\}\}([\s\S]*?)\{\{\/each\}\}/g, (_match, key, content) => {
+        const value = data[key];
+        if (!Array.isArray(value) || value.length === 0) {
+            return '';
+        }
+        return value.map((item) => content.replace(/\{\{\.\}\}/g, item)).join('');
+    });
+    // Process {{#if key}}...{{/if}} blocks
+    result = result.replace(/\{\{#if (\w+)\}\}([\s\S]*?)\{\{\/if\}\}/g, (_match, key, content) => {
+        const value = data[key];
+        const isTruthy = value !== undefined &&
+            value !== null &&
+            value !== false &&
+            value !== '' &&
+            value !== 0 &&
+            !(Array.isArray(value) && value.length === 0);
+        return isTruthy ? content : '';
+    });
+    // Process {{#unless key}}...{{/unless}} blocks
+    result = result.replace(/\{\{#unless (\w+)\}\}([\s\S]*?)\{\{\/unless\}\}/g, (_match, key, content) => {
+        const value = data[key];
+        const isFalsy = value === undefined ||
+            value === null ||
+            value === false ||
+            value === '' ||
+            value === 0 ||
+            (Array.isArray(value) && value.length === 0);
+        return isFalsy ? content : '';
+    });
+    // Standard variable interpolation
+    result = render(result, data);
+    return result;
+}
+// ──────────────────────────────────────────────────────────────────
+// Built-in templates for common patterns
+// ──────────────────────────────────────────────────────────────────
+/**
+ * README template with platform-specific sections.
+ * Variables: name, description, role, platform, version, license,
+ *            installCommand, usageCode, toolsList, llmProvider, llmModel,
+ *            llmTemperature, llmMaxTokens, apiVersion
+ */
+export const README_TEMPLATE = `# {{name}}
+
+{{description}}
+
+## Description
+
+{{role}}
+
+## Installation
+
+\`\`\`bash
+{{installCommand}}
+\`\`\`
+
+## Usage
+
+\`\`\`
+{{usageCode}}
+\`\`\`
+
+{{#if toolsList}}
+## Tools
+
+{{toolsList}}
+{{/if}}
+
+{{#if llmProvider}}
+## LLM Configuration
+
+- **Provider**: {{llmProvider}}
+- **Model**: {{llmModel}}
+- **Temperature**: {{llmTemperature}}
+- **Max Tokens**: {{llmMaxTokens}}
+{{/if}}
+
+## Generated from OSSA
+
+This agent was generated from an OSSA {{apiVersion}} manifest.
+
+Original manifest: \`agent.ossa.yaml\`
+
+## License
+
+{{license}}
+`;
+/**
+ * INSTALL section template.
+ * Variables: platform, installCommand, setupSteps
+ */
+export const INSTALL_TEMPLATE = `## Installation
+
+### Prerequisites
+
+{{#if prerequisites}}
+{{prerequisites}}
+{{/if}}
+
+### Setup
+
+\`\`\`bash
+{{installCommand}}
+\`\`\`
+
+{{#if setupSteps}}
+{{setupSteps}}
+{{/if}}
+`;
+//# sourceMappingURL=template-engine.js.map

package/dist/adapters/base/template-engine.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"template-engine.js","sourceRoot":"","sources":["../../../src/adapters/base/template-engine.ts"],"names":[],"mappings":"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"}

package/dist/adapters/crewai/adapter.d.ts

@@ -40,13 +40,65 @@ export declare class CrewAIAdapter extends BaseAdapter {
      * Generate tools.py - Tool implementations
      */
     private generateToolsCode;
+    /**
+     * Generate crew/__init__.py - Crew module exports
+     */
+    private generateCrewCode;
+    /**
+     * Generate crew/crew.py - Main crew setup
+     */
+    private generateCrewSetupCode;
+    /**
+     * Generate tools/custom_tools.py - Custom tool implementations
+     */
+    private generateCustomToolsCode;
+    /**
+     * Generate main.py - Entry point
+     */
+    private generateMainCode;
     /**
      * Generate requirements.txt
      */
     private generateRequirements;
     /**
-     * Generate README.md
+     * Generate .env.example
+     */
+    private generateEnvExample;
+    /**
+     * Generate .dockerignore
+     */
+    private generateDockerignore;
+    /**
+     * Generate .gitignore
+     */
+    private generateGitignore;
+    /**
+     * Generate examples/basic_usage.py
+     */
+    private generateExampleUsage;
+    /**
+     * Generate examples/async_usage.py
+     */
+    private generateExampleAsync;
+    /**
+     * Generate tests/test_crew.py
+     */
+    private generateTestsCode;
+    /**
+     * Generate tests/test_tools.py
+     */
+    private generateTestToolsCode;
+    /**
+     * Convert string to PascalCase
+     */
+    private toPascalCase;
+    /**
+     * Generate README.md - Production-grade documentation
      */
     private generateReadme;
+    /**
+     * Generate DEPLOYMENT.md - Production deployment guide
+     */
+    private generateDeploymentGuide;
 }
 //# sourceMappingURL=adapter.d.ts.map

package/dist/adapters/crewai/adapter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../../../src/adapters/crewai/adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAC3D,OAAO,KAAK,EACV,SAAS,EACT,aAAa,EACb,YAAY,EACZ,gBAAgB,EAGjB,MAAM,8BAA8B,CAAC;AAGtC,qBAAa,aAAc,SAAQ,WAAW;IAC5C,QAAQ,CAAC,QAAQ,YAAY;IAC7B,QAAQ,CAAC,WAAW,YAAY;IAChC,QAAQ,CAAC,WAAW,2CAA2C;IAC/D,QAAQ,CAAC,iBAAiB,WAA8B;IAExD,OAAO,CAAC,SAAS,CAAyB;IAE1C;;OAEG;IACG,MAAM,CACV,QAAQ,EAAE,SAAS,EACnB,OAAO,CAAC,EAAE,aAAa,GACtB,OAAO,CAAC,YAAY,CAAC;IA6ExB;;OAEG;IACG,QAAQ,CAAC,QAAQ,EAAE,SAAS,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAsC9D;;OAEG;IACH,UAAU,IAAI,SAAS;IA8CvB;;OAEG;IACH,OAAO,CAAC,kBAAkB;IA+B1B;;OAEG;IACH,OAAO,CAAC,iBAAiB;IA4BzB;;OAEG;IACH,OAAO,CAAC,iBAAiB;IA+BzB;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAO5B;;OAEG;IACH,OAAO,CAAC,cAAc;CAyCvB"}
+{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../../../src/adapters/crewai/adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAE3D,OAAO,KAAK,EACV,SAAS,EACT,aAAa,EACb,YAAY,EACZ,gBAAgB,EAGjB,MAAM,8BAA8B,CAAC;AAGtC,qBAAa,aAAc,SAAQ,WAAW;IAC5C,QAAQ,CAAC,QAAQ,YAAY;IAC7B,QAAQ,CAAC,WAAW,YAAY;IAChC,QAAQ,CAAC,WAAW,2CAA2C;IAC/D,QAAQ,CAAC,iBAAiB,WAA8B;IAExD,OAAO,CAAC,SAAS,CAAyB;IAE1C;;OAEG;IACG,MAAM,CACV,QAAQ,EAAE,SAAS,EACnB,OAAO,CAAC,EAAE,aAAa,GACtB,OAAO,CAAC,YAAY,CAAC;IAyIxB;;OAEG;IACG,QAAQ,CAAC,QAAQ,EAAE,SAAS,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAsC9D;;OAEG;IACH,UAAU,IAAI,SAAS;IA8CvB;;OAEG;IACH,OAAO,CAAC,kBAAkB;IA+B1B;;OAEG;IACH,OAAO,CAAC,iBAAiB;IA4BzB;;OAEG;IACH,OAAO,CAAC,iBAAiB;IA+BzB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAcxB;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAiE7B;;OAEG;IACH,OAAO,CAAC,uBAAuB;IA0D/B;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAiExB;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAmB5B;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAyB1B;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAwC5B;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAkEzB;;OAEG;IACH,OAAO,CAAC,oBAAoB;IA6C5B;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAgF5B;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAoDzB;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAiC7B;;OAEG;IACH,OAAO,CAAC,YAAY;IAMpB;;OAEG;IACH,OAAO,CAAC,cAAc;IAqYtB;;OAEG;IACH,OAAO,CAAC,uBAAuB;CAsdhC"}