@bluefly/openstandardagents 0.3.2 → 0.3.3

package/examples/ossa-templates/10-data-transformer.ossa.yaml

@@ -0,0 +1,102 @@
+apiVersion: ossa/v0.3.3
+kind: Task
+metadata:
+  name: data-transformer
+  version: 1.0.0
+  description: Data transformation and ETL pipeline task
+  labels:
+    ossa.dev/category: data
+    ossa.dev/tier: standard-example
+    ossa.dev/execution: deterministic
+  annotations:
+    ossa.dev/documentation: https://openstandardagents.org/tasks/data-transformer
+spec:
+  execution:
+    type: deterministic
+    runtime: any
+  capabilities:
+  - data_extract
+  - data_transform
+  - data_validate
+  - data_load
+  batch:
+    enabled: true
+    parallelism: 10
+    chunk_size: 1000
+    retry:
+      max_attempts: 3
+      backoff_strategy: exponential
+  input:
+    type: object
+    required:
+    - source
+    - destination
+    properties:
+      source:
+        type: object
+        properties:
+          type:
+            type: string
+            enum:
+            - file
+            - api
+            - database
+          path:
+            type: string
+          format:
+            type: string
+            enum:
+            - json
+            - csv
+            - yaml
+            - xml
+      destination:
+        type: object
+        properties:
+          type:
+            type: string
+            enum:
+            - file
+            - api
+            - database
+          path:
+            type: string
+          format:
+            type: string
+      transformations:
+        type: array
+        items:
+          type: object
+          properties:
+            field:
+              type: string
+            operation:
+              type: string
+              enum:
+              - rename
+              - map
+              - filter
+              - aggregate
+              - join
+            config:
+              type: object
+  output:
+    type: object
+    properties:
+      records_processed:
+        type: integer
+      records_succeeded:
+        type: integer
+      records_failed:
+        type: integer
+      errors:
+        type: array
+        items:
+          type: object
+          properties:
+            record_id:
+              type: string
+            error:
+              type: string
+      duration_ms:
+        type: integer

package/examples/ossa-templates/README.md

@@ -0,0 +1,98 @@
+# OSSA Specification Templates
+
+10 OSSA v0.3.3 manifest templates showcasing the full specification.
+
+## Templates
+
+| # | Template | Kind | Category | Features Showcased |
+|---|----------|------|----------|-------------------|
+| 01 | **code-assistant** | Agent | Development | IDE extensions, tool use, LLM config |
+| 02 | **security-scanner** | Agent | Security | Safety policies, constraints, access tiers |
+| 03 | **ci-pipeline** | Agent | DevOps | Runtime integration, messaging, GitLab extension |
+| 04 | **code-reviewer** | Agent | Development | Identity, access tiers, contracts |
+| 05 | **doc-generator** | Agent | Documentation | Multi-provider LLM, templates |
+| 06 | **compliance-validator** | Agent | Compliance | Schema validation, policy DSL |
+| 07 | **workflow-orchestrator** | Workflow | Orchestration | Multi-agent composition, state management |
+| 08 | **content-writer** | Agent | Content | Drupal extension, async processing |
+| 09 | **test-generator** | Agent | Testing | Code analysis, multi-language |
+| 10 | **data-transformer** | Agent | Data | Deterministic execution, batch processing |
+
+## OSSA Kinds Demonstrated
+
+- **Agent** - AI agents with LLM inference
+- **Workflow** - Multi-agent orchestration
+- **Task** - Deterministic, non-agentic operations
+
+## Key Features
+
+### 1. IDE Integration (code-assistant)
+```yaml
+extensions:
+  claude-code:
+    hooks: [before_execute, after_execute]
+  cursor:
+    composer_integration: true
+  copilot:
+    suggestions: { enabled: true }
+```
+
+### 2. Safety & Access Control (security-scanner)
+```yaml
+safety:
+  constraints:
+    - Never expose actual secret values
+  policies:
+    - policy: no-secret-exposure
+identity:
+  access_tier: elevated
+  permissions: [security.scan.read]
+```
+
+### 3. Agent Composition (workflow-orchestrator)
+```yaml
+kind: Workflow
+spec:
+  agents:
+    - ref: code-reviewer
+      on_complete: security-scanner
+  steps:
+    - id: review
+      agent: reviewer
+      depends_on: []
+```
+
+### 4. Drupal Extension (content-writer)
+```yaml
+extensions:
+  drupal:
+    module: ai_agents_ossa
+    messenger:
+      transport: redis
+      queue: content_generation
+    workflow_engine: eca
+```
+
+### 5. Deterministic Execution (data-transformer)
+```yaml
+kind: Agent
+spec:
+  execution:
+    type: deterministic
+    batch:
+      enabled: true
+      parallelism: 10
+```
+
+## Usage
+
+```bash
+# Validate all OSSA templates
+ossa validate examples/ossa-templates/*.ossa.yaml
+
+# Generate agent from template
+ossa generate agent security-scanner -o my-scanner.ossa.yaml
+```
+
+## Documentation
+
+https://openstandardagents.org/agents

package/examples/production/document-analyzer-openai.yml

@@ -1,7 +1,7 @@
 # OSSA Agent with OpenAI Bridge Configuration Example
 # Document Analyzer Agent - Proof of Concept
 
-apiVersion: ossa/v0.3.2
+apiVersion: ossa/v0.3.3
 kind: Agent
 metadata:
   name: document-analyzer

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

@@ -1,59 +1,57 @@
-# OSSA Quickstart Example - Customer Support Agent
-# Run with: ossa run examples/quickstart/support-agent.ossa.yaml
-
-apiVersion: ossa/v0.3.2
+apiVersion: ossa/v0.3.3
 kind: Agent
-
 metadata:
   name: support-agent
   version: 1.0.0
-  description: A helpful customer support agent that answers questions and helps with orders
-
+  description: A helpful customer support agent that answers questions and helps with
+    orders
 spec:
-  role: |
-    You are a friendly and helpful customer support agent for an e-commerce company.
+  role: 'You are a friendly and helpful customer support agent for an e-commerce company.
+
 
     Your responsibilities:
+
     - Answer questions about orders, shipping, and returns
+
     - Help customers track their packages
+
     - Provide information about products
+
     - Escalate complex issues to human agents when needed
 
-    Always be polite, concise, and helpful. If you don't know something, say so honestly.
 
+    Always be polite, concise, and helpful. If you don''t know something, say so honestly.
+
+    '
   llm:
     provider: openai
     model: gpt-4o-mini
     temperature: 0.7
     maxTokens: 1000
-
   tools:
-    - type: function
-      name: get_order_status
-      capabilities:
-        - order_tracking
-
+  - type: function
+    name: get_order_status
+    capabilities:
+    - order_tracking
   autonomy:
     level: supervised
     approval_required: false
-
   observability:
     logging:
       level: info
       format: json
-
 extensions:
   openai_agents:
     model: gpt-4o-mini
     tools_mapping:
-      - ossa_capability: order_tracking
-        openai_tool_name: get_order_status
-        description: Get the status of a customer order by order ID
-        parameters:
-          type: object
-          properties:
-            order_id:
-              type: string
-              description: The order ID to look up (e.g., ORD-12345)
-          required:
-            - order_id
+    - ossa_capability: order_tracking
+      openai_tool_name: get_order_status
+      description: Get the status of a customer order by order ID
+      parameters:
+        type: object
+        properties:
+          order_id:
+            type: string
+            description: The order ID to look up (e.g., ORD-12345)
+        required:
+        - order_id

package/examples/rag-agent/index.ts

@@ -68,7 +68,7 @@ export async function createRagAgent(): Promise<OssaAgent> {
   await vectorStore.index([
     {
       id: 'doc1',
-      content: 'OSSA (Open Standard for Scalable AI Agents) is a specification standard for AI agents, similar to OpenAPI for REST APIs.',
+      content: 'OSSA (Open Standard for Software Agents) is a specification standard for software agents - The OpenAPI for agents.',
       metadata: { category: 'documentation' }
     },
     {

package/examples/real-world/gitlab-cicd-optimizer.ossa.yaml

@@ -1,7 +1,8 @@
-apiVersion: ossa/v0.3.2
+apiVersion: ossa/v0.3.3
 kind: Agent
 metadata:
   name: gitlab-cicd-optimizer
+  version: "1.0.0"
   description: |
     Real-world agent that optimizes GitLab CI/CD pipelines by:
     - Analyzing pipeline performance

package/examples/real-world/rag-documentation-assistant.ossa.yaml

@@ -1,7 +1,8 @@
-apiVersion: ossa/v0.3.2
+apiVersion: ossa/v0.3.3
 kind: Agent
 metadata:
   name: rag-documentation-assistant
+  version: "1.0.0"
   description: |
     Production RAG agent that answers questions about your codebase using:
     - Vector embeddings of documentation

package/examples/reference-implementations/typescript-client/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ossa/typescript-client",
-  "version": "1.0.0",
+  "version": "0.3.3",
   "description": "TypeScript reference implementation for OSSA API",
   "type": "module",
   "main": "./dist/index.js",