@bluefly/openstandardagents 0.2.4

package/docs/getting-started.md

@@ -0,0 +1,87 @@
+# Getting Started with OSSA
+
+## What is OSSA?
+
+OSSA (Open Standard for Scalable AI Agents) is a specification standard for AI agents, similar to how OpenAPI standardizes REST APIs.
+
+**OSSA is NOT a framework** - it's a standard that defines the contract.
+
+## Installation
+
+```bash
+npm install -g @bluefly/open-standards-scalable-agents
+```
+
+## Quick Start
+
+### 1. Initialize a New Agent
+
+```bash
+ossa init my-agent --type worker
+cd .agents/my-agent
+```
+
+### 2. Edit Agent Manifest
+
+Edit `agent.yml`:
+
+```yaml
+ossaVersion: "1.0"
+
+agent:
+  id: my-agent
+  name: My Agent
+  version: "1.0.0"
+  role: worker
+  
+  runtime:
+    type: docker
+    
+  capabilities:
+    - name: process_data
+      description: Process incoming data
+      input_schema:
+        type: object
+        properties:
+          data:
+            type: string
+      output_schema:
+        type: object
+        properties:
+          result:
+            type: string
+```
+
+### 3. Validate
+
+```bash
+ossa validate agent.yml
+```
+
+### 4. Deploy
+
+OSSA doesn't dictate deployment. Deploy to YOUR infrastructure:
+- Docker / Kubernetes
+- AWS / GCP / Azure
+- On-premise
+- Serverless
+
+## CLI Commands
+
+- `ossa init <name>` - Initialize new agent project
+- `ossa validate <path>` - Validate against OSSA 1.0 schema
+- `ossa generate <type>` - Generate from template
+- `ossa migrate <source>` - Migrate v0.1.9 → 1.0
+
+## Next Steps
+
+- Review [Examples](../examples/)
+- Read the [Specification](../spec/ossa-1.0.schema.json)
+- Visit the [GitLab Wiki](https://gitlab.bluefly.io/llm/openapi-ai-agents-standard/-/wikis/home)
+
+## Need More Features?
+
+For production features like GitLab integration, Kubernetes deployment, and monitoring, see:
+
+**[agent-buildkit](https://gitlab.bluefly.io/llm/npm/agent-buildkit)** - Reference implementation with production tooling
+

package/docs/migration/general-agent-schema.yml

@@ -0,0 +1,255 @@
+openapi: 3.0.3
+info:
+  title: General Agent API Schema
+  description: A generalized agent schema for comparison with GitLab Duo Agent API
+  version: 1.0.0
+
+components:
+  schemas:
+    Agent:
+      type: object
+      properties:
+        id:
+          type: string
+          format: uuid
+        name:
+          type: string
+        description:
+          type: string
+        agent_type:
+          type: string
+          enum: [cli, web, chat, workflow, autonomous]
+        status:
+          type: string
+          enum: [active, inactive, paused, error, training]
+        capabilities:
+          type: array
+          items:
+            type: string
+            enum:
+              [
+                code_generation,
+                code_review,
+                issue_analysis,
+                documentation,
+                testing,
+                deployment,
+              ]
+        configuration:
+          type: object
+          properties:
+            model:
+              type: string
+            provider:
+              type: string
+              enum: [openai, anthropic, cohere, local]
+            temperature:
+              type: number
+              minimum: 0
+              maximum: 2
+            max_tokens:
+              type: integer
+              minimum: 1
+        permissions:
+          type: array
+          items:
+            type: string
+            enum: [read, write, execute, admin]
+        created_at:
+          type: string
+          format: date-time
+        updated_at:
+          type: string
+          format: date-time
+        last_activity:
+          type: string
+          format: date-time
+        metadata:
+          type: object
+          additionalProperties: true
+
+    CreateAgentRequest:
+      type: object
+      required:
+        - name
+        - agent_type
+        - capabilities
+      properties:
+        name:
+          type: string
+        description:
+          type: string
+        agent_type:
+          type: string
+          enum: [cli, web, chat, workflow, autonomous]
+        capabilities:
+          type: array
+          items:
+            type: string
+        configuration:
+          type: object
+        permissions:
+          type: array
+          items:
+            type: string
+        metadata:
+          type: object
+          additionalProperties: true
+
+    AgentExecution:
+      type: object
+      properties:
+        execution_id:
+          type: string
+          format: uuid
+        agent_id:
+          type: string
+          format: uuid
+        task:
+          type: object
+          properties:
+            description:
+              type: string
+            input_data:
+              type: object
+            context:
+              type: object
+        status:
+          type: string
+          enum: [pending, running, completed, failed, cancelled]
+        result:
+          type: object
+          properties:
+            output:
+              type: string
+            artifacts:
+              type: array
+              items:
+                type: string
+            metrics:
+              type: object
+        logs:
+          type: array
+          items:
+            type: object
+            properties:
+              timestamp:
+                type: string
+                format: date-time
+              level:
+                type: string
+                enum: [debug, info, warning, error]
+              message:
+                type: string
+        started_at:
+          type: string
+          format: date-time
+        completed_at:
+          type: string
+          format: date-time
+        duration_ms:
+          type: integer
+
+    AgentTrigger:
+      type: object
+      properties:
+        id:
+          type: string
+          format: uuid
+        agent_id:
+          type: string
+          format: uuid
+        name:
+          type: string
+        trigger_type:
+          type: string
+          enum: [manual, scheduled, event_based, api_call, webhook]
+        event_config:
+          type: object
+          properties:
+            events:
+              type: array
+              items:
+                type: string
+            conditions:
+              type: object
+        schedule:
+          type: object
+          properties:
+            cron_expression:
+              type: string
+            timezone:
+              type: string
+        status:
+          type: string
+          enum: [active, inactive]
+        created_at:
+          type: string
+          format: date-time
+        last_triggered:
+          type: string
+          format: date-time
+          nullable: true
+
+    AgentSkill:
+      type: object
+      properties:
+        id:
+          type: string
+          format: uuid
+        name:
+          type: string
+        description:
+          type: string
+        skill_type:
+          type: string
+          enum: [tool, knowledge, workflow]
+        input_schema:
+          type: object
+        output_schema:
+          type: object
+        implementation:
+          type: object
+          properties:
+            type:
+              type: string
+              enum: [function, api_call, script, workflow]
+            endpoint:
+              type: string
+            parameters:
+              type: object
+        version:
+          type: string
+        status:
+          type: string
+          enum: [active, deprecated, experimental]
+
+    AgentMemory:
+      type: object
+      properties:
+        id:
+          type: string
+          format: uuid
+        agent_id:
+          type: string
+          format: uuid
+        memory_type:
+          type: string
+          enum: [short_term, long_term, episodic, semantic]
+        content:
+          type: object
+        embedding:
+          type: array
+          items:
+            type: number
+        metadata:
+          type: object
+        created_at:
+          type: string
+          format: date-time
+        last_accessed:
+          type: string
+          format: date-time
+        access_count:
+          type: integer
+          default: 0

package/docs/migration/migration-manifest.json

@@ -0,0 +1,64 @@
+{
+  "version": "0.1.9",
+  "timestamp": "2024-12-12T10:00:00Z",
+  "migration": {
+    "from": "OSSA",
+    "to": "agent-buildkit",
+    "branch": "feature/ossa-implementation-v0.1.9"
+  },
+  "files_to_migrate": {
+    "cli": {
+      "count": 4,
+      "source": "src/cli/",
+      "target": "src/ossa-tools/cli/",
+      "files": ["index.ts", "commands/registry.ts", "commands/ossa.ts", "commands/mcp.ts"]
+    },
+    "mcp_server": {
+      "count": 7,
+      "source": "src/mcp-server/",
+      "target": "src/ossa-tools/mcp-server/",
+      "files": ["index.ts", "server.ts", "tools.ts", "transport.ts", "handlers.ts", "types.ts", "config.ts"]
+    },
+    "core_runtime": {
+      "count": 11,
+      "source": "src/core/",
+      "target": "src/ossa-tools/runtime/",
+      "files": ["orchestrator.ts", "registry.ts", "compliance.ts", "lifecycle.ts", "execution.ts", "state.ts", "queue.ts", "scheduler.ts", "logger.ts", "metrics.ts", "config.ts"]
+    },
+    "infrastructure": {
+      "count": 53,
+      "source": "infrastructure/",
+      "target": "src/ossa-tools/infrastructure/",
+      "includes": ["docker-compose*.yml", "*.yaml", "k8s/", "helm/", "scripts/"]
+    },
+    "vortex": {
+      "count": 5,
+      "source": "vortex/",
+      "target": "src/ossa-tools/vortex/",
+      "critical": true,
+      "features": ["67% token reduction", "$2.4M annual savings"]
+    },
+    "agents": {
+      "count": 17,
+      "source": ".agents/",
+      "target": "src/ossa-tools/agents-registry/",
+      "types": ["orchestrator", "worker", "critic", "judge", "trainer", "governor", "monitor"]
+    }
+  },
+  "files_to_keep": {
+    "specifications": {
+      "count": 16,
+      "locations": [
+        "src/api/*.openapi.yml",
+        "src/api/*.schema.json",
+        "src/types/",
+        "src/specification/validator.ts",
+        "examples/"
+      ]
+    }
+  },
+  "total_files": {
+    "to_migrate": 76,
+    "to_keep": 16
+  }
+}