@bluefly/openstandardagents 0.2.4 → 0.2.5-RC

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

@@ -0,0 +1,165 @@
+{
+  "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",
   "kind": "Agent",
   "metadata": {
     "name": "swarm-agent",

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",
   "kind": "Agent",
   "metadata": {
     "name": "edge-chat-agent",

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

package/infrastructure/k8s/monitoring/01-prometheus.yaml

@@ -0,0 +1,142 @@
+apiVersion: v1
+kind: ConfigMap
+metadata:
+  name: prometheus-config
+  namespace: monitoring
+data:
+  prometheus.yml: |
+    global:
+      scrape_interval: 15s
+      evaluation_interval: 15s
+    
+    scrape_configs:
+      - job_name: 'prometheus'
+        static_configs:
+          - targets: ['localhost:9090']
+      
+      - job_name: 'gitlab-agent'
+        kubernetes_sd_configs:
+          - role: pod
+            namespaces:
+              names:
+                - gitlab-agent
+        relabel_configs:
+          - source_labels: [__meta_kubernetes_pod_label_app]
+            regex: gitlab-agent
+            action: keep
+          - source_labels: [__meta_kubernetes_pod_annotation_prometheus_io_scrape]
+            action: keep
+            regex: true
+          - source_labels: [__meta_kubernetes_pod_annotation_prometheus_io_port]
+            action: replace
+            target_label: __address__
+            regex: ([^:]+)(?::\d+)?;(\d+)
+            replacement: $1:$2
+      
+      - job_name: 'ossa-agents'
+        kubernetes_sd_configs:
+          - role: pod
+            namespaces:
+              names:
+                - ossa-agents
+        relabel_configs:
+          - source_labels: [__meta_kubernetes_pod_annotation_prometheus_io_scrape]
+            action: keep
+            regex: true
+          - source_labels: [__meta_kubernetes_pod_annotation_prometheus_io_path]
+            action: replace
+            target_label: __metrics_path__
+            regex: (.+)
+          - source_labels: [__address__, __meta_kubernetes_pod_annotation_prometheus_io_port]
+            action: replace
+            regex: ([^:]+)(?::\d+)?;(\d+)
+            replacement: $1:$2
+            target_label: __address__
+---
+apiVersion: apps/v1
+kind: Deployment
+metadata:
+  name: prometheus
+  namespace: monitoring
+spec:
+  replicas: 1
+  selector:
+    matchLabels:
+      app: prometheus
+  template:
+    metadata:
+      labels:
+        app: prometheus
+    spec:
+      serviceAccountName: prometheus
+      containers:
+      - name: prometheus
+        image: prom/prometheus:latest
+        args:
+          - '--config.file=/etc/prometheus/prometheus.yml'
+          - '--storage.tsdb.path=/prometheus'
+          - '--web.console.libraries=/usr/share/prometheus/console_libraries'
+          - '--web.console.templates=/usr/share/prometheus/consoles'
+        ports:
+        - containerPort: 9090
+        volumeMounts:
+        - name: config
+          mountPath: /etc/prometheus
+        - name: storage
+          mountPath: /prometheus
+      volumes:
+      - name: config
+        configMap:
+          name: prometheus-config
+      - name: storage
+        emptyDir: {}
+---
+apiVersion: v1
+kind: Service
+metadata:
+  name: prometheus
+  namespace: monitoring
+spec:
+  selector:
+    app: prometheus
+  ports:
+  - port: 9090
+    targetPort: 9090
+---
+apiVersion: v1
+kind: ServiceAccount
+metadata:
+  name: prometheus
+  namespace: monitoring
+---
+apiVersion: rbac.authorization.k8s.io/v1
+kind: ClusterRole
+metadata:
+  name: prometheus
+rules:
+- apiGroups: [""]
+  resources:
+  - nodes
+  - nodes/proxy
+  - services
+  - endpoints
+  - pods
+  verbs: ["get", "list", "watch"]
+- apiGroups:
+  - extensions
+  resources:
+  - ingresses
+  verbs: ["get", "list", "watch"]
+---
+apiVersion: rbac.authorization.k8s.io/v1
+kind: ClusterRoleBinding
+metadata:
+  name: prometheus
+roleRef:
+  apiGroup: rbac.authorization.k8s.io
+  kind: ClusterRole
+  name: prometheus
+subjects:
+- kind: ServiceAccount
+  name: prometheus
+  namespace: monitoring

package/infrastructure/k8s/monitoring/02-grafana.yaml

@@ -0,0 +1,63 @@
+apiVersion: v1
+kind: ConfigMap
+metadata:
+  name: grafana-datasources
+  namespace: monitoring
+data:
+  prometheus.yaml: |
+    apiVersion: 1
+    datasources:
+    - name: Prometheus
+      type: prometheus
+      access: proxy
+      url: http://prometheus:9090
+      isDefault: true
+---
+apiVersion: apps/v1
+kind: Deployment
+metadata:
+  name: grafana
+  namespace: monitoring
+spec:
+  replicas: 1
+  selector:
+    matchLabels:
+      app: grafana
+  template:
+    metadata:
+      labels:
+        app: grafana
+    spec:
+      containers:
+      - name: grafana
+        image: grafana/grafana:latest
+        ports:
+        - containerPort: 3000
+        env:
+        - name: GF_SECURITY_ADMIN_PASSWORD
+          value: "admin"
+        - name: GF_USERS_ALLOW_SIGN_UP
+          value: "false"
+        volumeMounts:
+        - name: grafana-storage
+          mountPath: /var/lib/grafana
+        - name: grafana-datasources
+          mountPath: /etc/grafana/provisioning/datasources
+      volumes:
+      - name: grafana-storage
+        emptyDir: {}
+      - name: grafana-datasources
+        configMap:
+          name: grafana-datasources
+---
+apiVersion: v1
+kind: Service
+metadata:
+  name: grafana
+  namespace: monitoring
+spec:
+  selector:
+    app: grafana
+  ports:
+  - port: 3000
+    targetPort: 3000