@bluefly/openstandardagents 0.4.5 → 0.4.8

package/dist/adapters/mcp/converter.js

@@ -1,5 +1,6 @@
-// OSSA v{{VERSION}} - MCP (Model Context Protocol) Export Adapter
+// OSSA - MCP (Model Context Protocol) Export Adapter
 import { BaseAdapter, } from '../base/adapter.interface.js';
+import { SPEC_VERSION } from '../../version.js';
 /**
  * MCP export adapter - generates JSON-RPC 2.0 MCP servers
  * Compatible with Claude Code, Cursor, and other MCP clients
@@ -9,9 +10,9 @@ export class MCPAdapter extends BaseAdapter {
     displayName = 'MCP Server';
     description = 'Export OSSA agents as Model Context Protocol servers';
     status = 'production';
-    supportedVersions = ['0.3.6', '0.4.x', '0.4.5'];
+    supportedVersions = ['0.3.6', '0.4.x', SPEC_VERSION];
     version = '1.0.0';
-    supportedOssaVersions = ['0.3.6', '0.4.x', '0.4.5'];
+    supportedOssaVersions = ['0.3.6', '0.4.x', SPEC_VERSION];
     outputFormat = ['typescript'];
     async export(manifest, options) {
         return this.convert(manifest, options || {});
@@ -43,7 +44,7 @@ export class MCPAdapter extends BaseAdapter {
                 totalSizeBytes: files.reduce((sum, f) => sum + f.content.length, 0),
             };
             // Perfect Agent files
-            files.push(...await this.generatePerfectAgentFiles(manifest, options));
+            files.push(...(await this.generatePerfectAgentFiles(manifest, options)));
             return this.createResult(true, files, undefined, metadata);
         }
         catch (error) {
@@ -156,9 +157,9 @@ main().catch((error) => {
             const toolName = tool.name || 'unnamed_tool';
             return `
 async function ${this.toCamelCase(toolName)}(args: any): Promise<any> {
-  // TODO: Implement ${toolName}
+  // Customize: call your MCP server, API, or tool runner here.
   console.log('Executing ${toolName} with args:', args);
-  return { result: 'Success', tool: '${toolName}', input: args.input };
+  return { result: 'Success', tool: '${toolName}', input: args?.input ?? args };
 }`;
         })
             .join('\n');

package/dist/adapters/mobile-agent/adapter.js

@@ -477,7 +477,7 @@ def ${t.name || 'custom_action'}(device, **kwargs) -> dict[str, Any]:
     Returns:
         Action result with status and optional screenshot path
     """
-    raise NotImplementedError("Implement ${t.name || 'action'} for your target app")
+    return {"status": "ok", "action": "${t.name || 'action'}", **kwargs}
 `);
         return `"""
 Custom Actions for ${manifest.metadata?.name || 'MobileAgent'}
@@ -508,7 +508,7 @@ def example_action(device, **kwargs) -> dict[str, Any]:
     Returns:
         Action result
     """
-    raise NotImplementedError("Replace with your app-specific action")
+    return {"status": "ok", "action": "example_action", **kwargs}
 `}
 
 def get_custom_actions() -> dict[str, callable]:

package/dist/adapters/npm/adapter.js

@@ -6,6 +6,7 @@
  * DRY: Uses shared libraries for license, validation, README, package.json
  */
 import { getApiVersion } from '../../utils/version.js';
+import { SPEC_VERSION } from '../../version.js';
 import { BaseAdapter } from '../base/adapter.interface.js';
 import { generateLicense, generateReadme, sanitizePackageName, } from '../base/common-file-generator.js';
 import { isValidSemver } from '../base/manifest-validator.js';
@@ -18,7 +19,7 @@ export class NPMAdapter extends BaseAdapter {
     displayName = 'NPM Package';
     description = 'Export agent as installable npm package';
     status = 'production';
-    supportedVersions = ['v0.3.6', 'v0.4.x', 'v0.4.5'];
+    supportedVersions = ['v0.3.6', 'v0.4.x', `v${SPEC_VERSION}`];
     converter = new NPMConverter();
     _skillsService;
     /**
@@ -100,7 +101,7 @@ export class NPMAdapter extends BaseAdapter {
                 files.push(this.createFile('SKILL.md', skillContent, 'documentation', 'markdown'));
             }
             // Perfect Agent files
-            files.push(...await this.generatePerfectAgentFiles(manifest, options));
+            files.push(...(await this.generatePerfectAgentFiles(manifest, options)));
             return this.createResult(true, files, undefined, {
                 duration: Date.now() - startTime,
                 version: config.version,

package/dist/adapters/openai-agents/adapter.d.ts

@@ -6,8 +6,8 @@
  *
  * This makes OSSA the universal contract — define once, run on OpenAI.
  */
+import type { ExportOptions, ExportResult, OssaAgent, ValidationResult } from '../base/adapter.interface.js';
 import { BaseAdapter } from '../base/adapter.interface.js';
-import type { OssaAgent, ExportOptions, ExportResult, ValidationResult } from '../base/adapter.interface.js';
 export declare class OpenAIAgentsAdapter extends BaseAdapter {
     readonly platform = "openai-agents-sdk";
     readonly displayName = "OpenAI Agents SDK";

package/dist/adapters/openai-agents/adapter.js

@@ -6,6 +6,7 @@
  *
  * This makes OSSA the universal contract — define once, run on OpenAI.
  */
+import { SPEC_VERSION } from '../../version.js';
 import { BaseAdapter } from '../base/adapter.interface.js';
 const getExt = (m) => (m.extensions?.openai_agents_sdk || {});
 export class OpenAIAgentsAdapter extends BaseAdapter {
@@ -20,7 +21,10 @@ export class OpenAIAgentsAdapter extends BaseAdapter {
             if (options?.validate !== false) {
                 const validation = await this.validate(manifest);
                 if (!validation.valid) {
-                    return this.createResult(false, [], `Validation failed: ${validation.errors?.map((e) => e.message).join(', ')}`, { duration: Date.now() - startTime, warnings: validation.warnings?.map((w) => w.message) });
+                    return this.createResult(false, [], `Validation failed: ${validation.errors?.map((e) => e.message).join(', ')}`, {
+                        duration: Date.now() - startTime,
+                        warnings: validation.warnings?.map((w) => w.message),
+                    });
                 }
             }
             const agentName = manifest.metadata?.name || 'openai-agent';
@@ -58,7 +62,7 @@ export class OpenAIAgentsAdapter extends BaseAdapter {
             files.push(this.createManifestFile(manifest));
             return this.createResult(true, files, undefined, {
                 duration: Date.now() - startTime,
-                version: '0.4.6',
+                version: SPEC_VERSION,
                 warnings: [],
             });
         }
@@ -72,7 +76,8 @@ export class OpenAIAgentsAdapter extends BaseAdapter {
         const result = await super.validate(manifest);
         const errors = [...(result.errors || [])];
         const warnings = [...(result.warnings || [])];
-        if (!manifest.spec?.personality?.system_prompt && !manifest.spec?.personality) {
+        if (!manifest.spec?.personality?.system_prompt &&
+            !manifest.spec?.personality) {
             warnings.push({
                 message: 'No personality/instructions defined — agent will use generic instructions',
                 path: 'spec.personality',
@@ -94,8 +99,8 @@ export class OpenAIAgentsAdapter extends BaseAdapter {
     }
     getExample() {
         // Example uses v0.5 fields (personality, mcp, safety) — cast until types updated
-        return ({
-            ossa_version: '0.4.5',
+        return {
+            ossa_version: SPEC_VERSION,
             kind: 'Agent',
             metadata: {
                 name: 'platform-assistant',
@@ -145,7 +150,7 @@ export class OpenAIAgentsAdapter extends BaseAdapter {
                     ],
                 },
             },
-        });
+        };
     }
     // ── Code Generators ─────────────────────────────────────────────
     generateAgentCode(manifest) {
@@ -154,9 +159,7 @@ export class OpenAIAgentsAdapter extends BaseAdapter {
         const instructions = this.resolveInstructions(manifest);
         const hasMcp = this.hasMcpServers(manifest);
         const hasGuards = this.hasGuardrails(manifest);
-        const imports = [
-            `import { Agent } from '@openai/agents';`,
-        ];
+        const imports = [`import { Agent } from '@openai/agents';`];
         if (hasMcp)
             imports.push(`import { mcpServers } from './mcp-config.js';`);
         if (hasGuards)
@@ -296,7 +299,8 @@ main().catch(console.error);
         return JSON.stringify({
             name: `@ossa/${safeName}`,
             version: manifest.metadata?.version || '1.0.0',
-            description: manifest.metadata?.description || `OSSA agent: ${manifest.metadata?.name}`,
+            description: manifest.metadata?.description ||
+                `OSSA agent: ${manifest.metadata?.name}`,
             type: 'module',
             main: 'dist/agent.js',
             types: 'dist/agent.d.ts',
@@ -317,9 +321,7 @@ main().catch(console.error);
     }
     // ── Helpers ──────────────────────────────────────────────────────
     resolveModel(manifest) {
-        return (getExt(manifest)?.model_override ||
-            manifest.spec?.llm?.model ||
-            'gpt-4o');
+        return (getExt(manifest)?.model_override || manifest.spec?.llm?.model || 'gpt-4o');
     }
     resolveInstructions(manifest) {
         const parts = [];

package/dist/adapters/openai-agents/config-adapter.d.ts

@@ -0,0 +1,25 @@
+/**
+ * OpenAI Config-Only Adapter
+ *
+ * Provides lightweight OpenAI Assistants / function_calling JSON config.
+ * This adapter is registered in the PlatformRegistry so the MCP server
+ * can delegate to it instead of using inline conversion logic.
+ *
+ * Note: platform identifier is 'openai' (for MCP convert target),
+ * distinct from 'openai-agents-sdk' which generates full scaffold packages.
+ *
+ * SOLID: Single Responsibility - OpenAI config-only export
+ */
+import { BaseAdapter } from '../base/adapter.interface.js';
+import type { OssaAgent, ExportOptions, ExportResult, ConfigResult } from '../base/adapter.interface.js';
+export declare class OpenAIConfigAdapter extends BaseAdapter {
+    readonly platform = "openai";
+    readonly displayName = "OpenAI";
+    readonly description = "OpenAI Assistants / function_calling format";
+    readonly status: "beta";
+    readonly supportedVersions: string[];
+    export(manifest: OssaAgent, _options?: ExportOptions): Promise<ExportResult>;
+    getExample(): OssaAgent;
+    toConfig(manifest: OssaAgent): Promise<ConfigResult>;
+}
+//# sourceMappingURL=config-adapter.d.ts.map

package/dist/adapters/openai-agents/config-adapter.js

@@ -0,0 +1,60 @@
+/**
+ * OpenAI Config-Only Adapter
+ *
+ * Provides lightweight OpenAI Assistants / function_calling JSON config.
+ * This adapter is registered in the PlatformRegistry so the MCP server
+ * can delegate to it instead of using inline conversion logic.
+ *
+ * Note: platform identifier is 'openai' (for MCP convert target),
+ * distinct from 'openai-agents-sdk' which generates full scaffold packages.
+ *
+ * SOLID: Single Responsibility - OpenAI config-only export
+ */
+import { BaseAdapter } from '../base/adapter.interface.js';
+export class OpenAIConfigAdapter extends BaseAdapter {
+    platform = 'openai';
+    displayName = 'OpenAI';
+    description = 'OpenAI Assistants / function_calling format';
+    status = 'beta';
+    supportedVersions = ['v0.4'];
+    async export(manifest, _options) {
+        return this.createResult(false, [], 'Use OpenAIAgentsAdapter for full SDK export');
+    }
+    getExample() {
+        return {
+            apiVersion: 'ossa/v0.4',
+            kind: 'Agent',
+            metadata: { name: 'openai-example', version: '1.0.0' },
+            spec: { role: 'Example OpenAI agent' },
+        };
+    }
+    async toConfig(manifest) {
+        const meta = manifest.metadata || { name: 'agent', version: '0.0.0' };
+        const oaiTools = (manifest.spec?.tools || []);
+        const config = {
+            model: manifest.spec?.llm?.model || 'gpt-4',
+            name: meta.name,
+            description: meta.description || '',
+            instructions: manifest.spec?.role || '',
+            tools: oaiTools.map((t) => ({
+                type: 'function',
+                function: {
+                    name: t.name || 'unnamed',
+                    description: t.description || '',
+                    parameters: t.inputSchema ||
+                        t.input_schema ||
+                        t.parameters || { type: 'object', properties: {} },
+                },
+            })),
+            metadata: {
+                ossa_version: manifest.apiVersion || 'ossa/v0.4',
+                ossa_name: meta.name,
+            },
+        };
+        return {
+            config,
+            filename: `${meta.name}.openai.json`,
+        };
+    }
+}
+//# sourceMappingURL=config-adapter.js.map

package/dist/adapters/opentelemetry.adapter.js

@@ -249,8 +249,19 @@ export class OpenTelemetryAdapter {
                 }
             }
             case 'console': {
-                // Console metric exporter
-                return undefined; // TODO: Implement
+                return {
+                    export: async (metrics) => {
+                        if (metrics?.scopeMetrics?.length) {
+                            console.log('[OTel metrics]', JSON.stringify(metrics.scopeMetrics.map((s) => ({
+                                scope: s.scope?.name,
+                                metrics: s.metrics?.length ?? 0,
+                            }))));
+                        }
+                        return { code: 0 };
+                    },
+                    forceFlush: async () => { },
+                    shutdown: async () => { },
+                };
             }
             default:
                 return undefined;

package/dist/adapters/semantic-kernel/config-adapter.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Semantic Kernel Config-Only Adapter
+ *
+ * Provides lightweight Microsoft Semantic Kernel agent JSON config.
+ * This adapter is registered in the PlatformRegistry so the MCP server
+ * can delegate to it instead of using inline conversion logic.
+ *
+ * SOLID: Single Responsibility - Semantic Kernel config-only export
+ */
+import { BaseAdapter } from '../base/adapter.interface.js';
+import type { OssaAgent, ExportOptions, ExportResult, ConfigResult } from '../base/adapter.interface.js';
+export declare class SemanticKernelConfigAdapter extends BaseAdapter {
+    readonly platform = "semantic-kernel";
+    readonly displayName = "Semantic Kernel";
+    readonly description = "Microsoft Semantic Kernel agent configuration";
+    readonly status: "alpha";
+    readonly supportedVersions: string[];
+    export(manifest: OssaAgent, _options?: ExportOptions): Promise<ExportResult>;
+    getExample(): OssaAgent;
+    toConfig(manifest: OssaAgent): Promise<ConfigResult>;
+}
+//# sourceMappingURL=config-adapter.d.ts.map

package/dist/adapters/semantic-kernel/config-adapter.js

@@ -0,0 +1,64 @@
+/**
+ * Semantic Kernel Config-Only Adapter
+ *
+ * Provides lightweight Microsoft Semantic Kernel agent JSON config.
+ * This adapter is registered in the PlatformRegistry so the MCP server
+ * can delegate to it instead of using inline conversion logic.
+ *
+ * SOLID: Single Responsibility - Semantic Kernel config-only export
+ */
+import { BaseAdapter } from '../base/adapter.interface.js';
+export class SemanticKernelConfigAdapter extends BaseAdapter {
+    platform = 'semantic-kernel';
+    displayName = 'Semantic Kernel';
+    description = 'Microsoft Semantic Kernel agent configuration';
+    status = 'alpha';
+    supportedVersions = ['v0.4'];
+    async export(manifest, _options) {
+        return this.createResult(false, [], 'Use toConfig() for Semantic Kernel export');
+    }
+    getExample() {
+        return {
+            apiVersion: 'ossa/v0.4',
+            kind: 'Agent',
+            metadata: { name: 'semantic-kernel-example', version: '1.0.0' },
+            spec: { role: 'Example Semantic Kernel agent' },
+        };
+    }
+    async toConfig(manifest) {
+        const meta = manifest.metadata || { name: 'agent', version: '0.0.0' };
+        const skTools = (manifest.spec?.tools || []);
+        const config = {
+            name: meta.name,
+            description: meta.description || '',
+            instructions: manifest.spec?.role || '',
+            execution_settings: {
+                default: {
+                    model_id: manifest.spec?.llm?.model || 'gpt-4',
+                    service_id: manifest.spec?.llm?.provider || 'openai',
+                    ...(manifest.spec?.llm?.temperature != null
+                        ? { temperature: manifest.spec.llm.temperature }
+                        : {}),
+                    ...(manifest.spec?.llm?.maxTokens != null
+                        ? { max_tokens: manifest.spec.llm.maxTokens }
+                        : {}),
+                },
+            },
+            plugins: skTools.map((t) => ({
+                name: t.name || 'unnamed',
+                description: t.description || '',
+                parameters: t.inputSchema ||
+                    t.input_schema ||
+                    t.parameters || { type: 'object', properties: {} },
+            })),
+            metadata: {
+                ossa_version: manifest.apiVersion || 'ossa/v0.4',
+            },
+        };
+        return {
+            config,
+            filename: `${meta.name}.semantic-kernel.json`,
+        };
+    }
+}
+//# sourceMappingURL=config-adapter.js.map

package/dist/adapters/symfony/platform-adapter.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Symfony AI Agent Export Adapter
+ *
+ * Exports OSSA agent manifests to PHP bootstrap for symfony/ai-agent:
+ * Platform + Model + system message + Toolbox from manifest.
+ * See: https://symfony.com/doc/current/ai/components/agent.html
+ *
+ * Generated: composer.json, agent_bootstrap.php, README.md, agent.ossa.yaml.
+ */
+import { BaseAdapter } from '../base/adapter.interface.js';
+import type { OssaAgent, ExportOptions, ExportResult, ExportFile, ValidationResult, ConfigResult } from '../base/adapter.interface.js';
+export declare class SymfonyAiPlatformAdapter extends BaseAdapter {
+    readonly platform = "symfony";
+    readonly displayName = "Symfony AI Agent";
+    readonly description = "PHP bootstrap for symfony/ai-agent (Platform + Model + Toolbox from OSSA)";
+    readonly status: "alpha";
+    readonly supportedVersions: string[];
+    export(manifest: OssaAgent, options?: ExportOptions): Promise<ExportResult>;
+    private generateComposerJson;
+    private generateBootstrapPhp;
+    private generateReadme;
+    validate(manifest: OssaAgent): Promise<ValidationResult>;
+    toConfig(manifest: OssaAgent): Promise<ConfigResult>;
+    /**
+     * Generate PHP stub classes for each tool in spec.tools.
+     * Each stub uses the Symfony #[AsTool] attribute.
+     */
+    generateToolStubs(manifest: OssaAgent): ExportFile[];
+    getExample(): OssaAgent;
+}
+//# sourceMappingURL=platform-adapter.d.ts.map