@bluefly/openstandardagents 0.3.5 → 0.3.6

package/dist/services/template.service.js

@@ -0,0 +1,154 @@
+/**
+ * Template Service
+ * Manages template library for OSSA agents
+ */
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+import * as fs from 'fs';
+import * as path from 'path';
+import * as yaml from 'yaml';
+import { injectable } from 'inversify';
+let cachedTemplates = null;
+let TemplateService = class TemplateService {
+    /**
+     * Discover all templates
+     */
+    async discoverTemplates() {
+        if (cachedTemplates) {
+            return cachedTemplates;
+        }
+        const templates = [];
+        const templateDir = path.resolve(process.cwd(), 'templates/agent-types');
+        if (!fs.existsSync(templateDir)) {
+            return templates;
+        }
+        // Recursively find all template files
+        const findTemplates = (dir) => {
+            const entries = fs.readdirSync(dir, { withFileTypes: true });
+            for (const entry of entries) {
+                const fullPath = path.join(dir, entry.name);
+                if (entry.isDirectory()) {
+                    findTemplates(fullPath);
+                }
+                else if (entry.isFile() &&
+                    (entry.name.endsWith('.yaml') || entry.name.endsWith('.yml'))) {
+                    try {
+                        const content = fs.readFileSync(fullPath, 'utf-8');
+                        const parsed = yaml.parse(content);
+                        // Extract metadata from manifest or use defaults
+                        const metadata = {
+                            name: parsed.metadata?.name ||
+                                path.basename(fullPath, path.extname(fullPath)),
+                            description: parsed.metadata?.description || '',
+                            tags: parsed.metadata?.labels
+                                ? Object.keys(parsed.metadata.labels)
+                                : [],
+                            agentType: parsed.spec?.role ||
+                                'worker',
+                            domain: parsed.spec?.taxonomy
+                                ? parsed.spec.taxonomy.domain || 'agents'
+                                : 'agents',
+                            useCases: [],
+                        };
+                        templates.push({
+                            metadata,
+                            manifest: parsed,
+                            path: fullPath,
+                        });
+                    }
+                    catch (error) {
+                        console.warn(`Failed to load template ${fullPath}:`, error);
+                    }
+                }
+            }
+        };
+        findTemplates(templateDir);
+        cachedTemplates = templates;
+        return templates;
+    }
+    /**
+     * Get template by name
+     */
+    async getTemplate(name) {
+        const templates = await this.discoverTemplates();
+        return templates.find((t) => t.metadata.name === name) || null;
+    }
+    /**
+     * Search templates
+     */
+    async searchTemplates(query) {
+        const templates = await this.discoverTemplates();
+        return templates.filter((template) => {
+            if (query.agentType && template.metadata.agentType !== query.agentType) {
+                return false;
+            }
+            if (query.domain && template.metadata.domain !== query.domain) {
+                return false;
+            }
+            if (query.tags && query.tags.length > 0) {
+                const hasTag = query.tags.some((tag) => template.metadata.tags.includes(tag));
+                if (!hasTag) {
+                    return false;
+                }
+            }
+            if (query.keyword) {
+                const keyword = query.keyword.toLowerCase();
+                const matches = template.metadata.name.toLowerCase().includes(keyword) ||
+                    template.metadata.description.toLowerCase().includes(keyword) ||
+                    template.metadata.tags.some((tag) => tag.toLowerCase().includes(keyword));
+                if (!matches) {
+                    return false;
+                }
+            }
+            return true;
+        });
+    }
+    /**
+     * Render template with variable substitution
+     */
+    async renderTemplate(template, variables = {}) {
+        let manifestStr = JSON.stringify(template.manifest);
+        // Substitute variables
+        for (const [key, value] of Object.entries(variables)) {
+            const placeholder = `{{${key}}}`;
+            manifestStr = manifestStr.replace(new RegExp(placeholder, 'g'), value);
+        }
+        return JSON.parse(manifestStr);
+    }
+    /**
+     * Validate template structure
+     */
+    async validateTemplate(templatePath) {
+        const errors = [];
+        if (!fs.existsSync(templatePath)) {
+            errors.push(`Template file not found: ${templatePath}`);
+            return { valid: false, errors };
+        }
+        try {
+            const content = fs.readFileSync(templatePath, 'utf-8');
+            const parsed = yaml.parse(content);
+            if (!parsed.metadata?.name) {
+                errors.push('Template must have metadata.name');
+            }
+            if (!parsed.spec?.role) {
+                errors.push('Template must have spec.role');
+            }
+        }
+        catch (error) {
+            errors.push(`Failed to parse template: ${error instanceof Error ? error.message : String(error)}`);
+        }
+        return {
+            valid: errors.length === 0,
+            errors,
+        };
+    }
+};
+TemplateService = __decorate([
+    injectable()
+], TemplateService);
+export { TemplateService };
+//# sourceMappingURL=template.service.js.map

package/dist/services/template.service.js.map

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

package/dist/spec/ossa-audit-api.yaml

@@ -0,0 +1,311 @@
+openapi: 3.1.0
+info:
+  title: OSSA Agent Audit API
+  version: 1.0.0
+  description: |
+    API for auditing OSSA agent health, compliance, and validation.
+    Scan folders, validate manifests, and generate comprehensive health reports.
+  contact:
+    name: Bluefly Platform Team
+    email: platform@bluefly.io
+
+servers:
+  - url: http://localhost:3000
+    description: Local development
+  - url: https://ossa-audit.blueflyagents.com
+    description: Production
+
+paths:
+  /audit/scan:
+    post:
+      summary: Scan folder for agents and generate health audit
+      description: Recursively scans a directory for OSSA agent manifests and validates them
+      operationId: scanAndAuditAgents
+      tags:
+        - Audit
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              type: object
+              required:
+                - path
+              properties:
+                path:
+                  type: string
+                  description: Absolute or relative path to scan for agents
+                  example: "./packages/@ossa"
+                recursive:
+                  type: boolean
+                  description: Recursively scan subdirectories
+                  default: true
+                validationLevel:
+                  type: string
+                  description: Level of validation to perform
+                  enum: [basic, full, strict]
+                  default: full
+                specVersion:
+                  type: string
+                  description: OSSA spec version to validate against
+                  example: "0.3.5"
+                  default: "0.3.5"
+                includeExamples:
+                  type: boolean
+                  description: Include example manifests in scan
+                  default: false
+      responses:
+        '200':
+          description: Audit report generated successfully
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/AuditReport'
+        '400':
+          description: Invalid request parameters
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/Error'
+        '500':
+          description: Server error during audit
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/Error'
+
+  /audit/agent/{agentId}:
+    get:
+      summary: Get health status for specific agent
+      description: Validate and audit a single agent by ID
+      operationId: auditSingleAgent
+      tags:
+        - Audit
+      parameters:
+        - name: agentId
+          in: path
+          required: true
+          description: Agent identifier
+          schema:
+            type: string
+          example: task-dispatcher
+        - name: path
+          in: query
+          required: true
+          description: Path to agent manifest
+          schema:
+            type: string
+          example: "./packages/@ossa/task-dispatcher"
+        - name: validationLevel
+          in: query
+          schema:
+            type: string
+            enum: [basic, full, strict]
+            default: full
+      responses:
+        '200':
+          description: Agent health status retrieved
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/AgentHealth'
+        '404':
+          description: Agent not found
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/Error'
+
+  /audit/validate:
+    post:
+      summary: Validate agent manifest against OSSA spec
+      description: Validate a single manifest file without scanning
+      operationId: validateManifest
+      tags:
+        - Validation
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              type: object
+              required:
+                - manifestPath
+              properties:
+                manifestPath:
+                  type: string
+                  description: Path to manifest file
+                specVersion:
+                  type: string
+                  default: "0.3.5"
+      responses:
+        '200':
+          description: Validation result
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/ValidationResult'
+
+components:
+  schemas:
+    AuditReport:
+      type: object
+      required:
+        - summary
+        - agents
+        - timestamp
+      properties:
+        summary:
+          type: object
+          required:
+            - total
+            - healthy
+            - warning
+            - error
+            - healthPercentage
+          properties:
+            total:
+              type: integer
+              description: Total number of agents found
+            healthy:
+              type: integer
+              description: Agents with valid manifests and complete data
+            warning:
+              type: integer
+              description: Agents with minor issues
+            error:
+              type: integer
+              description: Agents with critical issues or missing manifests
+            healthPercentage:
+              type: number
+              format: float
+              description: Overall health percentage (0-100)
+        agents:
+          type: array
+          description: Detailed health status for each agent
+          items:
+            $ref: '#/components/schemas/AgentHealth'
+        timestamp:
+          type: string
+          format: date-time
+          description: When the audit was performed
+        scanPath:
+          type: string
+          description: Path that was scanned
+        validationLevel:
+          type: string
+          enum: [basic, full, strict]
+
+    AgentHealth:
+      type: object
+      required:
+        - id
+        - status
+      properties:
+        id:
+          type: string
+          description: Agent identifier
+        name:
+          type: string
+          description: Agent display name
+        path:
+          type: string
+          description: Path to agent directory
+        manifestExists:
+          type: boolean
+          description: Whether manifest file was found
+        manifestPath:
+          type: string
+          description: Path to manifest file
+        manifestFormat:
+          type: string
+          enum: [yaml, json]
+          description: Manifest file format
+        manifestValid:
+          type: boolean
+          description: Whether manifest passes OSSA spec validation
+        capabilitiesCount:
+          type: integer
+          description: Number of capabilities defined
+        toolsCount:
+          type: integer
+          description: Number of tools defined
+        triggersCount:
+          type: integer
+          description: Number of triggers defined
+        status:
+          type: string
+          enum: [healthy, warning, error]
+          description: Overall health status
+        healthScore:
+          type: number
+          format: float
+          minimum: 0
+          maximum: 100
+          description: Health score (0-100)
+        issues:
+          type: array
+          description: List of issues found during audit
+          items:
+            type: object
+            properties:
+              severity:
+                type: string
+                enum: [error, warning, info]
+              code:
+                type: string
+              message:
+                type: string
+              field:
+                type: string
+        validationErrors:
+          type: array
+          description: OSSA spec validation errors
+          items:
+            type: object
+            properties:
+              path:
+                type: string
+              message:
+                type: string
+
+    ValidationResult:
+      type: object
+      properties:
+        valid:
+          type: boolean
+        errors:
+          type: array
+          items:
+            type: object
+            properties:
+              path: {type: string}
+              message: {type: string}
+        warnings:
+          type: array
+          items:
+            type: object
+            properties:
+              path: {type: string}
+              message: {type: string}
+
+    Error:
+      type: object
+      required:
+        - error
+        - message
+      properties:
+        error:
+          type: string
+        message:
+          type: string
+        code:
+          type: string
+        details:
+          type: object
+
+tags:
+  - name: Audit
+    description: Agent health auditing operations
+  - name: Validation
+    description: Manifest validation operations

package/dist/spec/registry/registry-api.yaml

@@ -0,0 +1,144 @@
+openapi: 3.1.0
+info:
+  title: OSSA Registry API
+  version: 1.0.0
+  description: API for publishing, searching, and installing OSSA agents
+
+paths:
+  /agents:
+    get:
+      summary: Search agents
+      parameters:
+        - name: query
+          in: query
+          schema:
+            type: string
+        - name: domain
+          in: query
+          schema:
+            type: string
+        - name: type
+          in: query
+          schema:
+            type: string
+        - name: limit
+          in: query
+          schema:
+            type: integer
+            default: 20
+      responses:
+        '200':
+          description: List of agents
+          content:
+            application/json:
+              schema:
+                type: array
+                items:
+                  $ref: '#/components/schemas/AgentEntry'
+
+    post:
+      summary: Publish agent
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              $ref: '#/components/schemas/PublishRequest'
+      responses:
+        '201':
+          description: Agent published
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/AgentEntry'
+
+  /agents/{agentId}:
+    get:
+      summary: Get agent details
+      parameters:
+        - name: agentId
+          in: path
+          required: true
+          schema:
+            type: string
+      responses:
+        '200':
+          description: Agent details
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/AgentEntry'
+
+  /agents/{agentId}/versions:
+    get:
+      summary: List agent versions
+      parameters:
+        - name: agentId
+          in: path
+          required: true
+          schema:
+            type: string
+      responses:
+        '200':
+          description: List of versions
+          content:
+            application/json:
+              schema:
+                type: array
+                items:
+                  type: string
+
+  /agents/{agentId}/versions/{version}:
+    get:
+      summary: Get specific version
+      parameters:
+        - name: agentId
+          in: path
+          required: true
+          schema:
+            type: string
+        - name: version
+          in: path
+          required: true
+          schema:
+            type: string
+      responses:
+        '200':
+          description: Agent version details
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/AgentEntry'
+
+components:
+  schemas:
+    AgentEntry:
+      type: object
+      properties:
+        id:
+          type: string
+        name:
+          type: string
+        version:
+          type: string
+        description:
+          type: string
+        schema_version:
+          type: string
+        manifest_url:
+          type: string
+        bundle_url:
+          type: string
+        published_at:
+          type: string
+          format: date-time
+
+    PublishRequest:
+      type: object
+      required:
+        - manifest
+      properties:
+        manifest:
+          type: object
+        version:
+          type: string

package/dist/spec/schema/components/adapter.schema.json

@@ -0,0 +1,33 @@
+{
+  "$id": "https://ossa.dev/schema/components/adapter.schema.json",
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "title": "OSSA Adapter Component",
+  "description": "Platform-specific adapter configuration for the Adapter Envelope pattern",
+  "type": "object",
+  "required": ["type", "version", "config"],
+  "properties": {
+    "type": {
+      "type": "string",
+      "description": "Adapter type identifier (e.g., scm.github, runtime.kagent)",
+      "pattern": "^[a-z0-9]+(\.[a-z0-9]+)+$"
+    },
+    "version": {
+      "type": "string",
+      "description": "Adapter version (semver)",
+      "pattern": "^[0-9]+\\.[0-9]+\\.[0-9]+$"
+    },
+    "config": {
+      "type": "object",
+      "description": "Provider-specific configuration object, validated against the adapter's schema",
+      "additionalProperties": true
+    },
+    "secrets": {
+      "type": "object",
+      "description": "Secrets required by this adapter",
+      "additionalProperties": {
+        "$ref": "identity.schema.json#/definitions/CredentialSource"
+      }
+    }
+  },
+  "additionalProperties": false
+}