@bluefly/openstandardagents 0.2.4 → 0.2.7

package/examples/openai/basic-agent.ossa.yaml

@@ -0,0 +1,61 @@
+apiVersion: ossa/v0.2.4
+kind: Agent
+
+metadata:
+  name: basic-openai-agent
+  version: 1.0.0
+  description: A basic OpenAI agent demonstrating simple tool usage
+
+spec:
+  role: |
+    You are a helpful assistant that can search the web and perform calculations.
+    Always provide clear and concise answers.
+
+  llm:
+    provider: openai
+    model: gpt-4o-mini
+    temperature: 0.7
+
+extensions:
+  openai_agents:
+    model: gpt-4o-mini
+    instructions: |
+      You are a helpful assistant with access to web search and calculator tools.
+      Use the search tool to find current information.
+      Use the calculator for mathematical operations.
+      Always explain your reasoning.
+    
+    tools_mapping:
+      - ossa_capability: web_search
+        openai_tool_name: search
+        description: Search the web for current information
+        parameters:
+          type: object
+          properties:
+            query:
+              type: string
+              description: The search query
+          required:
+            - query
+      
+      - ossa_capability: calculator
+        openai_tool_name: calculate
+        description: Perform mathematical calculations
+        parameters:
+          type: object
+          properties:
+            expression:
+              type: string
+              description: Mathematical expression to evaluate (e.g., "2 + 2", "sqrt(16)")
+          required:
+            - expression
+    
+    guardrails:
+      enabled: true
+      max_tool_calls: 5
+      timeout_seconds: 60
+    
+    memory:
+      enabled: true
+      type: session
+      max_messages: 20

package/examples/openai/multi-tool-agent.ossa.json

@@ -0,0 +1,188 @@
+{
+  "apiVersion": "ossa/v0.2.4",
+  "kind": "Agent",
+  "metadata": {
+    "name": "multi-tool-agent",
+    "version": "1.0.0",
+    "description": "Advanced agent demonstrating multiple tools and custom handlers"
+  },
+  "spec": {
+    "role": "You are a versatile AI assistant with multiple capabilities including web search, calculations, weather information, and text translation.",
+    "llm": {
+      "provider": "openai",
+      "model": "gpt-4o",
+      "temperature": 0.7,
+      "maxTokens": 2000
+    }
+  },
+  "extensions": {
+    "openai_agents": {
+      "model": "gpt-4o",
+      "instructions": "You are a versatile AI assistant with access to multiple tools:\n\n1. Web Search - Find current information online\n2. Calculator - Perform mathematical calculations\n3. Weather - Get weather information for any location\n4. Translator - Translate text between languages\n5. Unit Converter - Convert between different units\n6. Time Zone - Get current time in different time zones\n\nAlways:\n- Use the appropriate tool for each task\n- Explain your reasoning\n- Provide accurate and helpful information\n- Ask for clarification if needed",
+      "tools_mapping": [
+        {
+          "ossa_capability": "web_search",
+          "openai_tool_name": "search_web",
+          "description": "Search the web for current information on any topic",
+          "parameters": {
+            "type": "object",
+            "properties": {
+              "query": {
+                "type": "string",
+                "description": "The search query"
+              },
+              "num_results": {
+                "type": "number",
+                "description": "Number of results to return",
+                "default": 5
+              }
+            },
+            "required": [
+              "query"
+            ]
+          }
+        },
+        {
+          "ossa_capability": "calculator",
+          "openai_tool_name": "calculate",
+          "description": "Perform mathematical calculations including basic arithmetic, algebra, and common functions",
+          "parameters": {
+            "type": "object",
+            "properties": {
+              "expression": {
+                "type": "string",
+                "description": "Mathematical expression to evaluate (e.g., '2 + 2', 'sqrt(16)', 'sin(pi/2)')"
+              }
+            },
+            "required": [
+              "expression"
+            ]
+          }
+        },
+        {
+          "ossa_capability": "weather",
+          "openai_tool_name": "get_weather",
+          "description": "Get current weather information for a specific location",
+          "parameters": {
+            "type": "object",
+            "properties": {
+              "location": {
+                "type": "string",
+                "description": "City name, coordinates, or zip code"
+              },
+              "units": {
+                "type": "string",
+                "enum": [
+                  "celsius",
+                  "fahrenheit",
+                  "kelvin"
+                ],
+                "description": "Temperature units",
+                "default": "celsius"
+              },
+              "include_forecast": {
+                "type": "boolean",
+                "description": "Include 5-day forecast",
+                "default": false
+              }
+            },
+            "required": [
+              "location"
+            ]
+          }
+        },
+        {
+          "ossa_capability": "translate",
+          "openai_tool_name": "translate_text",
+          "description": "Translate text from one language to another",
+          "parameters": {
+            "type": "object",
+            "properties": {
+              "text": {
+                "type": "string",
+                "description": "Text to translate"
+              },
+              "source_language": {
+                "type": "string",
+                "description": "Source language code (e.g., 'en', 'es', 'fr'). Use 'auto' for automatic detection",
+                "default": "auto"
+              },
+              "target_language": {
+                "type": "string",
+                "description": "Target language code (e.g., 'en', 'es', 'fr')"
+              }
+            },
+            "required": [
+              "text",
+              "target_language"
+            ]
+          }
+        },
+        {
+          "ossa_capability": "unit_converter",
+          "openai_tool_name": "convert_units",
+          "description": "Convert between different units of measurement",
+          "parameters": {
+            "type": "object",
+            "properties": {
+              "value": {
+                "type": "number",
+                "description": "The value to convert"
+              },
+              "from_unit": {
+                "type": "string",
+                "description": "Source unit (e.g., 'meters', 'feet', 'celsius', 'pounds')"
+              },
+              "to_unit": {
+                "type": "string",
+                "description": "Target unit (e.g., 'meters', 'feet', 'celsius', 'pounds')"
+              }
+            },
+            "required": [
+              "value",
+              "from_unit",
+              "to_unit"
+            ]
+          }
+        },
+        {
+          "ossa_capability": "timezone",
+          "openai_tool_name": "get_time",
+          "description": "Get current time in a specific timezone",
+          "parameters": {
+            "type": "object",
+            "properties": {
+              "timezone": {
+                "type": "string",
+                "description": "Timezone name (e.g., 'America/New_York', 'Europe/London', 'Asia/Tokyo')"
+              },
+              "format": {
+                "type": "string",
+                "enum": [
+                  "12h",
+                  "24h",
+                  "iso"
+                ],
+                "description": "Time format",
+                "default": "12h"
+              }
+            },
+            "required": [
+              "timezone"
+            ]
+          }
+        }
+      ],
+      "guardrails": {
+        "enabled": true,
+        "max_tool_calls": 15,
+        "timeout_seconds": 300
+      },
+      "memory": {
+        "enabled": true,
+        "type": "session",
+        "max_messages": 50
+      }
+    }
+  }
+}

package/examples/openai/swarm-agent.ossa.json

@@ -1,5 +1,5 @@
 {
-  "apiVersion": "ossa/v0.2.3",
+  "apiVersion": "ossa/v0.2.4",
   "kind": "Agent",
   "metadata": {
     "name": "swarm-agent",
@@ -17,12 +17,26 @@
       {
         "type": "function",
         "name": "search_web",
-        "capabilities": ["search", "retrieve"]
+        "capabilities": [
+          {
+            "name": "search"
+          },
+          {
+            "name": "retrieve"
+          }
+        ]
       },
       {
         "type": "function",
         "name": "execute_code",
-        "capabilities": ["run", "evaluate"]
+        "capabilities": [
+          {
+            "name": "run"
+          },
+          {
+            "name": "evaluate"
+          }
+        ]
       }
     ]
   },
@@ -55,5 +69,4 @@
       }
     }
   }
-}
-
+}

package/examples/openapi-extensions/README.md

@@ -83,5 +83,5 @@ Use any OpenAPI viewer:
 For complete documentation on OSSA OpenAPI extensions, see:
 - [OpenAPI Extensions Documentation](../../docs/openapi-extensions.md)
 - [OSSA Specification](../../spec/v0.2.2/OSSA-SPECIFICATION-v0.2.2.md)
-- [GitLab Wiki](https://gitlab.bluefly.io/llm/openapi-ai-agents-standard/-/wikis/home)
+- [GitHub Repository](https://github.com/blueflyio/openstandardagents)
 

package/examples/quickstart/support-agent.ossa.yaml

@@ -1,7 +1,7 @@
 # OSSA Quickstart Example - Customer Support Agent
 # Run with: ossa run examples/quickstart/support-agent.ossa.yaml
 
-apiVersion: ossa/v0.2.3
+apiVersion: ossa/v0.2
 kind: Agent
 
 metadata:

package/examples/vercel/edge-agent.ossa.json

@@ -1,5 +1,5 @@
 {
-  "apiVersion": "ossa/v0.2.3",
+  "apiVersion": "ossa/v0.2.4",
   "kind": "Agent",
   "metadata": {
     "name": "edge-chat-agent",
@@ -33,11 +33,12 @@
                 "description": "City name"
               }
             },
-            "required": ["location"]
+            "required": [
+              "location"
+            ]
           }
         }
       ]
     }
   }
-}
-
+}

package/infrastructure/gitlab-agent/rbac.yaml

@@ -0,0 +1,126 @@
+# GitLab Kubernetes Agent RBAC Configuration
+# Production-ready RBAC with least privilege principles
+# This replaces the default cluster-admin role with more restrictive permissions
+
+apiVersion: v1
+kind: ServiceAccount
+metadata:
+  name: gitlab-agent
+  namespace: gitlab-agent
+  labels:
+    app: gitlab-agent
+    component: ossa-agent
+---
+# ClusterRole with minimal required permissions for GitLab agent
+# Adjust based on your specific needs
+apiVersion: rbac.authorization.k8s.io/v1
+kind: ClusterRole
+metadata:
+  name: gitlab-agent
+  labels:
+    app: gitlab-agent
+    component: ossa-agent
+rules:
+  # Core API access for agent operations
+  - apiGroups: [""]
+    resources:
+      - namespaces
+      - pods
+      - pods/exec
+      - pods/log
+      - pods/portforward
+      - services
+      - endpoints
+      - configmaps
+      - secrets
+    verbs: ["get", "list", "watch", "create", "update", "patch", "delete"]
+  
+  # Deployment and workload management
+  - apiGroups: ["apps"]
+    resources:
+      - deployments
+      - replicasets
+      - statefulsets
+      - daemonsets
+    verbs: ["get", "list", "watch", "create", "update", "patch", "delete"]
+  
+  # Job and CronJob management
+  - apiGroups: ["batch"]
+    resources:
+      - jobs
+      - cronjobs
+    verbs: ["get", "list", "watch", "create", "update", "patch", "delete"]
+  
+  # Ingress management
+  - apiGroups: ["networking.k8s.io"]
+    resources:
+      - ingresses
+      - ingressclasses
+    verbs: ["get", "list", "watch", "create", "update", "patch", "delete"]
+  
+  # Service account and RBAC (for CI/CD operations)
+  - apiGroups: [""]
+    resources:
+      - serviceaccounts
+    verbs: ["get", "list", "watch", "create", "update", "patch"]
+  
+  - apiGroups: ["rbac.authorization.k8s.io"]
+    resources:
+      - roles
+      - rolebindings
+      - clusterroles
+      - clusterrolebindings
+    verbs: ["get", "list", "watch", "create", "update", "patch"]
+  
+  # Events for observability
+  - apiGroups: [""]
+    resources:
+      - events
+    verbs: ["get", "list", "watch", "create", "patch"]
+  
+  # Nodes (read-only for cluster info)
+  - apiGroups: [""]
+    resources:
+      - nodes
+    verbs: ["get", "list", "watch"]
+  
+  # Persistent volumes (if needed for deployments)
+  - apiGroups: [""]
+    resources:
+      - persistentvolumes
+      - persistentvolumeclaims
+    verbs: ["get", "list", "watch", "create", "update", "patch"]
+  
+  # Custom resources (for OSSA agents and other CRDs)
+  - apiGroups: ["*"]
+    resources: ["*"]
+    verbs: ["get", "list", "watch"]
+  
+  # Metrics and monitoring
+  - apiGroups: ["metrics.k8s.io"]
+    resources:
+      - nodes
+      - pods
+    verbs: ["get", "list"]
+  
+  # Health checks
+  - nonResourceURLs: ["/healthz", "/readyz", "/livez"]
+    verbs: ["get"]
+---
+# ClusterRoleBinding
+apiVersion: rbac.authorization.k8s.io/v1
+kind: ClusterRoleBinding
+metadata:
+  name: gitlab-agent
+  labels:
+    app: gitlab-agent
+    component: ossa-agent
+roleRef:
+  apiGroup: rbac.authorization.k8s.io
+  kind: ClusterRole
+  name: gitlab-agent
+subjects:
+  - kind: ServiceAccount
+    name: gitlab-agent
+    namespace: gitlab-agent
+

package/infrastructure/gitlab-agent/values.yaml

@@ -0,0 +1,150 @@
+# GitLab Kubernetes Agent Helm Values
+# Production-ready configuration for OSSA agents
+
+# Agent configuration
+config:
+  # Agent token (set via --set config.token=<token> or from secret)
+  # token: ""
+  
+  # KAS address for self-hosted GitLab
+  # Replace with your GitLab instance URL
+  kasAddress: "wss://your-gitlab-instance.com/-/kubernetes-agent/"
+  
+  # Optional: KAS CA certificate for self-signed certs
+  # kasCaCert: ""
+
+# Image configuration
+image:
+  repository: registry.gitlab.com/gitlab-org/cluster-integration/gitlab-agent/agentk
+  tag: "v18.4.0"  # Match your GitLab version
+  pullPolicy: IfNotPresent
+
+# Service account configuration
+serviceAccount:
+  create: true
+  name: gitlab-agent
+  annotations: {}
+  # annotations:
+  #   eks.amazonaws.com/role-arn: "arn:aws:iam::ACCOUNT_ID:role/ROLE_NAME"
+
+# RBAC configuration
+rbac:
+  create: true
+  # Use existing role instead of creating cluster-admin
+  # useExistingRole: false
+  # existingRoleName: ""
+
+# Resource limits
+resources:
+  requests:
+    cpu: 100m
+    memory: 128Mi
+  limits:
+    cpu: 500m
+    memory: 512Mi
+
+# Pod configuration
+podAnnotations:
+  prometheus.io/scrape: "true"
+  prometheus.io/port: "8080"
+  prometheus.io/path: "/metrics"
+
+podLabels:
+  app: gitlab-agent
+  component: ossa-agent
+  managed-by: helm
+
+# Security context
+securityContext:
+  runAsNonRoot: true
+  runAsUser: 65534
+  fsGroup: 65534
+  seccompProfile:
+    type: RuntimeDefault
+
+# Node selector (optional)
+nodeSelector: {}
+
+# Tolerations (optional)
+tolerations: []
+
+# Affinity rules (optional)
+affinity: {}
+
+# Extra environment variables
+extraEnv: []
+# Example:
+# extraEnv:
+#   - name: LOG_LEVEL
+#     value: "debug"
+
+# Liveness and readiness probes
+livenessProbe:
+  httpGet:
+    path: /liveness
+    port: 8080
+  initialDelaySeconds: 30
+  periodSeconds: 30
+  timeoutSeconds: 5
+  failureThreshold: 3
+
+readinessProbe:
+  httpGet:
+    path: /readiness
+    port: 8080
+  initialDelaySeconds: 10
+  periodSeconds: 10
+  timeoutSeconds: 5
+  failureThreshold: 3
+
+# Pod disruption budget
+podDisruptionBudget:
+  enabled: true
+  minAvailable: 1
+
+# Service monitor for Prometheus (if Prometheus Operator is installed)
+serviceMonitor:
+  enabled: false
+  interval: 30s
+  scrapeTimeout: 10s
+  labels: {}
+
+# Network policy (if supported)
+networkPolicy:
+  enabled: false
+
+# Priority class (optional)
+priorityClassName: ""
+
+# Extra volumes
+extraVolumes: []
+
+# Extra volume mounts
+extraVolumeMounts: []
+
+# Init containers
+initContainers: []
+
+# Additional containers (sidecars)
+additionalContainers: []
+
+# Deployment configuration
+replicaCount: 1
+
+# Strategy
+strategy:
+  type: RollingUpdate
+  rollingUpdate:
+    maxSurge: 1
+    maxUnavailable: 0
+
+# Termination grace period
+terminationGracePeriodSeconds: 30
+
+# Namespace configuration
+namespace:
+  create: true
+  name: gitlab-agent
+  annotations: {}
+  labels: {}
+

package/infrastructure/k8s/monitoring/00-namespace.yaml

@@ -0,0 +1,7 @@
+apiVersion: v1
+kind: Namespace
+metadata:
+  name: monitoring
+  labels:
+    name: monitoring
+    app.kubernetes.io/name: monitoring