@bluefly/openstandardagents 0.2.4 → 0.2.5-RC

package/openapi/gitlab-orchestrator.openapi.yaml

@@ -1,330 +0,0 @@
-openapi: 3.1.0
-info:
-  title: GitLab CI/CD Orchestrator API
-  version: 1.0.0
-  description: |
-    **Multi-Project CI/CD Orchestration**
-    
-    Orchestrates GitLab CI/CD across all LLM platform projects:
-    - Triggers pipelines for agent deployment
-    - Manages GitLab package publishing (npm, PyPI)
-    - Coordinates multi-repo workflows
-    - Tracks deployment status
-    
-    **No GitHub. Only GitLab.**
-
-servers:
-  - url: https://ci-orchestrator.agents.orb.local/api/v1
-    description: Production
-
-security:
-  - GitLabToken: []
-
-tags:
-  - name: pipelines
-    description: Pipeline orchestration
-  - name: packages
-    description: GitLab package management
-  - name: deployments
-    description: Multi-project deployments
-
-paths:
-  /pipelines/trigger:
-    post:
-      tags: [pipelines]
-      summary: Trigger GitLab pipeline
-      operationId: triggerPipeline
-      requestBody:
-        required: true
-        content:
-          application/json:
-            schema:
-              type: object
-              required:
-                - project
-                - ref
-              properties:
-                project:
-                  type: string
-                  description: GitLab project path
-                  example: "llm/npm/agent-chat"
-                ref:
-                  type: string
-                  description: Branch or tag
-                  example: "development"
-                variables:
-                  type: object
-                  additionalProperties:
-                    type: string
-                  example:
-                    DEPLOY_ENV: "staging"
-                    AGENT_ID: "agent-chat"
-      responses:
-        '202':
-          description: Pipeline triggered
-          content:
-            application/json:
-              schema:
-                type: object
-                properties:
-                  pipeline_id:
-                    type: integer
-                  web_url:
-                    type: string
-                    format: uri
-                  status:
-                    type: string
-
-  /pipelines/multi-trigger:
-    post:
-      tags: [pipelines]
-      summary: Trigger pipelines for multiple projects
-      description: |
-        Coordinate deployment across multiple projects.
-        Example: Deploy all agents (chat, studio, brain, mesh, etc.)
-      operationId: multiTriggerPipelines
-      requestBody:
-        required: true
-        content:
-          application/json:
-            schema:
-              type: object
-              required:
-                - projects
-              properties:
-                projects:
-                  type: array
-                  items:
-                    type: object
-                    required:
-                      - project
-                      - ref
-                    properties:
-                      project:
-                        type: string
-                      ref:
-                        type: string
-                      variables:
-                        type: object
-                strategy:
-                  type: string
-                  enum: [parallel, sequential]
-                  default: parallel
-      responses:
-        '202':
-          description: Pipelines triggered
-          content:
-            application/json:
-              schema:
-                type: object
-                properties:
-                  job_id:
-                    type: string
-                  pipelines:
-                    type: array
-                    items:
-                      type: object
-                      properties:
-                        project:
-                          type: string
-                        pipeline_id:
-                          type: integer
-                        web_url:
-                          type: string
-
-  /packages/publish:
-    post:
-      tags: [packages]
-      summary: Publish to GitLab package registry
-      description: Publish npm or PyPI package to gitlab.bluefly.io
-      operationId: publishPackage
-      requestBody:
-        required: true
-        content:
-          application/json:
-            schema:
-              type: object
-              required:
-                - project
-                - package_type
-                - version
-              properties:
-                project:
-                  type: string
-                  example: "llm/npm/agent-chat"
-                package_type:
-                  type: string
-                  enum: [npm, pypi, generic]
-                version:
-                  type: string
-                  example: "0.1.0"
-                build_ref:
-                  type: string
-                  description: Git ref to build from
-      responses:
-        '202':
-          description: Package build started
-          content:
-            application/json:
-              schema:
-                type: object
-                properties:
-                  job_id:
-                    type: string
-                  pipeline_url:
-                    type: string
-
-  /packages/list:
-    get:
-      tags: [packages]
-      summary: List GitLab packages
-      description: Query gitlab.bluefly.io package registry
-      operationId: listPackages
-      parameters:
-        - name: scope
-          in: query
-          schema:
-            type: string
-            example: "@llm"
-        - name: package_type
-          in: query
-          schema:
-            type: string
-            enum: [npm, pypi, generic]
-      responses:
-        '200':
-          description: Package list
-          content:
-            application/json:
-              schema:
-                type: array
-                items:
-                  type: object
-                  properties:
-                    name:
-                      type: string
-                    version:
-                      type: string
-                    package_type:
-                      type: string
-                    created_at:
-                      type: string
-                    package_url:
-                      type: string
-
-  /deployments/orchestrate:
-    post:
-      tags: [deployments]
-      summary: Orchestrate multi-project deployment
-      description: |
-        Deploy entire LLM platform stack:
-        1. Deploy Drupal platform
-        2. Deploy all agents (chat, studio, brain, etc.)
-        3. Deploy workflows (langflow, workflow-engine)
-        4. Configure networking and ingress
-        5. Verify health and start monitoring
-      operationId: orchestrateDeployment
-      requestBody:
-        required: true
-        content:
-          application/json:
-            schema:
-              type: object
-              required:
-                - environment
-              properties:
-                environment:
-                  type: string
-                  enum: [staging, production]
-                projects:
-                  type: array
-                  items:
-                    type: string
-                  description: Specific projects (or all if empty)
-                helm_values:
-                  type: object
-                  description: Global Helm overrides
-      responses:
-        '202':
-          description: Deployment orchestration started
-          content:
-            application/json:
-              schema:
-                type: object
-                properties:
-                  orchestration_id:
-                    type: string
-                  status_url:
-                    type: string
-                  estimated_duration:
-                    type: string
-                  projects:
-                    type: array
-                    items:
-                      type: object
-
-components:
-  securitySchemes:
-    OAuth2:
-      type: oauth2
-      flows:
-        clientCredentials:
-          tokenUrl: https://gitlab.bluefly.io/oauth/token
-          scopes:
-            api: Full API access
-    
-    GitLabToken:
-      type: http
-      scheme: bearer
-      bearerFormat: GitLab Personal Access Token
-    
-    ApiKeyAuth:
-      type: apiKey
-      in: header
-      name: X-Drupal-API-Key
-  
-  schemas:
-    ContentCreateRequest:
-      type: object
-      required:
-        - type
-        - title
-      properties:
-        type:
-          type: string
-        title:
-          type: string
-        body:
-          type: object
-        fields:
-          type: object
-        agent_context:
-          type: object
-          properties:
-            agent_id:
-              type: string
-            session_id:
-              type: string
-            task_id:
-              type: string
-
-    ContentResponse:
-      type: object
-      properties:
-        nid:
-          type: integer
-        uuid:
-          type: string
-        type:
-          type: string
-        title:
-          type: string
-        url:
-          type: string
-        api_url:
-          type: string
-        created:
-          type: string
-        changed:
-          type: string
-

package/ossa-website-swarm-tasks.json

@@ -1,105 +0,0 @@
-{
-  "swarm": {
-    "name": "OSSA Website Build Team",
-    "description": "Parallel team to build out comprehensive OSSA website with diagrams, docs, and examples",
-    "tasks": [
-      {
-        "id": "architecture-diagrams",
-        "name": "Architecture & Flow Diagrams Agent",
-        "description": "Create Mermaid diagrams for agent execution flow, OSSA stack, multi-agent systems, and tool integration. Add to /website/content/docs/architecture/ with explanations.",
-        "agent_type": "documentation",
-        "priority": "critical",
-        "dependencies": [],
-        "deliverables": [
-          "/Users/flux423/Sites/LLM/OSSA/website/content/docs/architecture/overview.md",
-          "/Users/flux423/Sites/LLM/OSSA/website/content/docs/architecture/execution-flow.md",
-          "/Users/flux423/Sites/LLM/OSSA/website/content/docs/architecture/stack-integration.md",
-          "/Users/flux423/Sites/LLM/OSSA/website/content/docs/architecture/multi-agent-systems.md"
-        ],
-        "context": "User wants data flow maps similar to OpenAPI.org. Create Mermaid sequence diagrams and architecture visuals showing how OSSA agents execute, where OSSA fits in the stack, and how multi-agent systems communicate."
-      },
-      {
-        "id": "gitlab-wiki-sync",
-        "name": "GitLab Wiki Integration Agent",
-        "description": "Fetch all 23+ GitLab Wiki pages via API and integrate into /website/content/docs/. Pull migration guides, OpenAPI extensions, AIFlow integration, contributing, changelog, quick reference.",
-        "agent_type": "integration",
-        "priority": "high",
-        "dependencies": [],
-        "deliverables": [
-          "/Users/flux423/Sites/LLM/OSSA/website/content/docs/migration-guides/",
-          "/Users/flux423/Sites/LLM/OSSA/website/content/docs/openapi-extensions/",
-          "/Users/flux423/Sites/LLM/OSSA/website/content/docs/integrations/aiflow.md",
-          "/Users/flux423/Sites/LLM/OSSA/website/content/docs/contributing.md",
-          "/Users/flux423/Sites/LLM/OSSA/website/content/docs/changelog.md",
-          "/Users/flux423/Sites/LLM/OSSA/website/content/docs/quick-reference.md"
-        ],
-        "context": "Use GitLab API: GITLAB_HOST=gitlab.bluefly.io glab api projects/llm%2Fopenstandardagents/wikis to fetch all pages. Convert to website markdown format and organize in proper directory structure."
-      },
-      {
-        "id": "schema-reference",
-        "name": "Schema Reference Documentation Agent",
-        "description": "Create OpenAPI-style schema reference docs with field tables (Field Name | Type | Required | Description) for all OSSA objects: OSSAManifest, Agent, Capabilities, LLM, Tools, Observability, Compliance.",
-        "agent_type": "documentation",
-        "priority": "high",
-        "dependencies": [],
-        "deliverables": [
-          "/Users/flux423/Sites/LLM/OSSA/website/content/docs/schema-reference/index.md",
-          "/Users/flux423/Sites/LLM/OSSA/website/content/docs/schema-reference/ossa-manifest.md",
-          "/Users/flux423/Sites/LLM/OSSA/website/content/docs/schema-reference/agent-object.md",
-          "/Users/flux423/Sites/LLM/OSSA/website/content/docs/schema-reference/capabilities-object.md",
-          "/Users/flux423/Sites/LLM/OSSA/website/content/docs/schema-reference/llm-object.md",
-          "/Users/flux423/Sites/LLM/OSSA/website/content/docs/schema-reference/tools-object.md"
-        ],
-        "context": "Parse /Users/flux423/Sites/LLM/OSSA/schema/ossa-0.2.3.schema.json and generate markdown docs with tables like OpenAPI.org spec. Include YAML examples for each object."
-      },
-      {
-        "id": "use-case-gallery",
-        "name": "Use Case & Examples Agent",
-        "description": "Create real-world use case deep dives with code examples in TypeScript/Python. Cover: Enterprise compliance agent, CI/CD code review agent, customer support agent, research multi-agent system.",
-        "agent_type": "documentation",
-        "priority": "medium",
-        "dependencies": [],
-        "deliverables": [
-          "/Users/flux423/Sites/LLM/OSSA/website/content/docs/use-cases/enterprise-compliance.md",
-          "/Users/flux423/Sites/LLM/OSSA/website/content/docs/use-cases/cicd-code-review.md",
-          "/Users/flux423/Sites/LLM/OSSA/website/content/docs/use-cases/customer-support.md",
-          "/Users/flux423/Sites/LLM/OSSA/website/content/docs/use-cases/research-multi-agent.md"
-        ],
-        "context": "Each use case needs: problem statement, OSSA manifest YAML, implementation code in TypeScript/Python, architecture diagram, and deployment instructions."
-      },
-      {
-        "id": "ecosystem-page",
-        "name": "Ecosystem & Integrations Agent",
-        "description": "Create ecosystem page with framework support matrix (LangChain, CrewAI, kAgent, Anthropic MCP), runtime compatibility table, and integration guides.",
-        "agent_type": "documentation",
-        "priority": "medium",
-        "dependencies": ["gitlab-wiki-sync"],
-        "deliverables": [
-          "/Users/flux423/Sites/LLM/OSSA/website/app/ecosystem/page.tsx",
-          "/Users/flux423/Sites/LLM/OSSA/website/content/docs/ecosystem/overview.md",
-          "/Users/flux423/Sites/LLM/OSSA/website/content/docs/ecosystem/framework-support.md"
-        ],
-        "context": "Create comparison tables showing OSSA support across frameworks. Include status (Supported/Beta/Planned), migration guide links, and example code links."
-      },
-      {
-        "id": "openapi-extensions",
-        "name": "OpenAPI Extensions Page Agent",
-        "description": "Integrate existing /docs/openapi-extensions.md (23KB) into website. Format with tables showing extension fields, types, and descriptions like OpenAPI spec.",
-        "agent_type": "integration",
-        "priority": "high",
-        "dependencies": [],
-        "deliverables": [
-          "/Users/flux423/Sites/LLM/OSSA/website/content/docs/openapi-extensions/index.md",
-          "/Users/flux423/Sites/LLM/OSSA/website/content/docs/openapi-extensions/root-extensions.md",
-          "/Users/flux423/Sites/LLM/OSSA/website/content/docs/openapi-extensions/operation-extensions.md"
-        ],
-        "context": "Source file exists at /Users/flux423/Sites/LLM/OSSA/docs/openapi-extensions.md. Convert to website format with proper navigation structure."
-      }
-    ]
-  },
-  "execution": {
-    "mode": "parallel",
-    "max_concurrent": 6,
-    "runtime": "local"
-  }
-}

package/spec/v0.2.5-dev/CHANGELOG.md

@@ -1,171 +0,0 @@
-# Changelog - OSSA v0.2.5-dev
-
-All notable changes to the OSSA specification are documented in this file.
-
-## [0.2.5-dev] - 2024-11-18
-
-### Status: DEVELOPMENT/UNSTABLE
-
-This is a development version. The API may change without notice.
-
-### Added
-
-#### New Resource Type: AgentGraph
-- Introduced `AgentGraph` kind for multi-agent composition
-- Support for defining complex agent workflows and orchestration patterns
-- Shared state management across agent graphs
-
-#### AgentGraphSpec Properties
-- `agents`: Array of agent references with role assignments
-- `edges`: Graph connections with conditions and priorities
-- `process`: Execution pattern (sequential, parallel, hierarchical, conditional, loop)
-- `entry_point`: Starting agent for graph execution
-- `exit_points`: Agents that can terminate execution
-- `state`: Shared state configuration with persistence options
-
-#### Execution Patterns
-- **sequential**: Agents execute one after another
-- **parallel**: Agents execute simultaneously
-- **hierarchical**: Manager delegates to workers (CrewAI style)
-- **conditional**: Branching based on conditions
-- **loop**: Iterative execution until termination
-
-#### New Framework Extensions
-- `google_adk`: Google Agent Development Kit integration
-  - Support for SequentialAgent, ParallelAgent, LoopAgent
-  - Gemini model configuration
-  - Session service options
-- `microsoft_af`: Microsoft AutoGen 0.4+ / Magentic-One
-  - Team types: round_robin, selector, swarm, magentic_one
-  - Agent types: assistant, orchestrator, web_surfer, coder
-  - Termination conditions
-- `metagpt`: MetaGPT software development teams
-  - Role types: product_manager, architect, engineer, qa_engineer
-  - SOP (Standard Operating Procedure) configuration
-  - Action definitions
-
-#### Enhanced Existing Extensions
-- `crewai`: Added `crew` property for Process configuration
-  - Process type (sequential/hierarchical)
-  - Manager LLM configuration
-  - Verbose mode
-
-### Changed
-
-#### Schema Updates
-- `kind` enum now includes: `Agent`, `AgentGraph`
-- `spec` uses `oneOf` to support AgentSpec or AgentGraphSpec
-- `apiVersion` pattern updated to support v0.2.5-dev
-
-#### API Version Pattern
-```regex
-^ossa/v(0\.2\.[2-5]|1)(\.[0-9]+)?(-[a-zA-Z0-9]+)?$
-```
-
-### Framework Mapping Examples
-
-#### CrewAI Crews
-```yaml
-apiVersion: ossa/v0.2.5-dev
-kind: AgentGraph
-metadata:
-  name: research-crew
-spec:
-  process: hierarchical
-  agents:
-    - ref: researcher
-      role: worker
-    - ref: writer
-      role: worker
-extensions:
-  crewai:
-    enabled: true
-    crew:
-      process: hierarchical
-      manager_llm: gpt-4
-```
-
-#### Google ADK Sequential
-```yaml
-apiVersion: ossa/v0.2.5-dev
-kind: AgentGraph
-metadata:
-  name: processing-pipeline
-spec:
-  process: sequential
-  agents:
-    - ref: intake
-    - ref: process
-    - ref: output
-extensions:
-  google_adk:
-    enabled: true
-    agent_type: sequential_agent
-```
-
-#### Microsoft AutoGen Team
-```yaml
-apiVersion: ossa/v0.2.5-dev
-kind: AgentGraph
-metadata:
-  name: dev-team
-spec:
-  process: conditional
-  agents:
-    - ref: orchestrator
-    - ref: coder
-    - ref: web-surfer
-extensions:
-  microsoft_af:
-    enabled: true
-    framework: magentic_one
-    team_type: magentic_one
-```
-
-#### MetaGPT SOP
-```yaml
-apiVersion: ossa/v0.2.5-dev
-kind: AgentGraph
-metadata:
-  name: software-team
-spec:
-  process: hierarchical
-  agents:
-    - ref: product-manager
-    - ref: architect
-    - ref: engineer
-extensions:
-  metagpt:
-    enabled: true
-    sop:
-      name: software_development
-      phases:
-        - requirements
-        - design
-        - implementation
-        - testing
-```
-
-### Migration Notes
-
-See `migrations/v0.2.4-to-v0.2.5.md` for detailed migration guidance.
-
-#### Quick Migration
-1. Update `apiVersion` to `ossa/v0.2.5-dev`
-2. Existing Agent manifests remain unchanged
-3. New AgentGraph manifests use `kind: AgentGraph`
-
-### Known Limitations
-- Graph validation is not fully implemented
-- Some framework mappings may require manual configuration
-- State persistence options are runtime-dependent
-
-### Roadmap
-- v0.2.5: Stabilize AgentGraph API based on feedback
-- v0.2.6: Add resource dependencies and imports
-- v0.3.0: Multi-file manifest support
-- v1.0.0: Stable release
-
-### Feedback
-Report issues and feedback at:
-https://gitlab.bluefly.io/llm/ossa/-/issues