@bluefly/openstandardagents 0.2.4 → 0.2.7

package/dist/spec/v0.2.7/core/agentgraph.md

@@ -0,0 +1,324 @@
+# AgentGraph Resource Specification
+
+**Version:** v0.2.7  
+**Status:** Draft  
+**Type:** Core Resource
+
+## Overview
+
+AgentGraph is a resource type for defining multi-agent compositions as directed graphs. It enables orchestration of multiple agents with explicit data flow and conditional routing.
+
+## Motivation
+
+Single agents are limited in capability. Complex tasks require:
+- Multiple specialized agents working together
+- Data flow between agents
+- Conditional routing based on outputs
+- Error handling across agent boundaries
+
+AgentGraph provides a declarative way to compose agents into workflows.
+
+## Resource Structure
+
+```yaml
+apiVersion: ossa.ai/v0.2.7
+kind: AgentGraph
+metadata:
+  name: string
+  version: string
+  description: string
+spec:
+  agents: Agent[]
+  edges: Edge[]
+  entrypoint: string
+  errorHandling: ErrorHandling
+```
+
+## Fields
+
+### metadata
+
+Standard OSSA metadata block.
+
+**Required fields:**
+- `name`: Unique identifier for the graph
+- `version`: Semantic version
+
+### spec.agents
+
+Array of agent definitions within the graph.
+
+**Fields:**
+- `id` (required): Unique identifier within graph
+- `agentRef` (required): Reference to Agent resource
+- `config` (optional): Agent-specific configuration overrides
+
+**Example:**
+```yaml
+agents:
+  - id: analyzer
+    agentRef: sentiment-analyzer
+    config:
+      threshold: 0.8
+  - id: responder
+    agentRef: response-generator
+```
+
+### spec.edges
+
+Array defining data flow between agents.
+
+**Fields:**
+- `from` (required): Source agent ID
+- `to` (required): Target agent ID
+- `condition` (optional): Boolean expression for conditional routing
+- `transform` (optional): Data transformation expression
+
+**Example:**
+```yaml
+edges:
+  - from: analyzer
+    to: responder
+  - from: analyzer
+    to: escalation
+    condition: output.sentiment < 0.3
+```
+
+### spec.entrypoint
+
+ID of the starting agent. Graph execution begins here.
+
+### spec.errorHandling
+
+Error handling strategy for the graph.
+
+**Fields:**
+- `strategy`: `fail-fast` | `continue` | `retry`
+- `maxRetries`: Maximum retry attempts (for retry strategy)
+- `fallbackAgent`: Agent ID to invoke on error
+
+## Execution Model
+
+### Sequential Execution
+
+Agents execute in topological order based on edges.
+
+```yaml
+edges:
+  - from: A
+    to: B
+  - from: B
+    to: C
+```
+
+Execution: A → B → C
+
+### Parallel Execution
+
+Agents with no dependencies execute in parallel.
+
+```yaml
+edges:
+  - from: A
+    to: B
+  - from: A
+    to: C
+  - from: B
+    to: D
+  - from: C
+    to: D
+```
+
+Execution: A → (B || C) → D
+
+### Conditional Routing
+
+Edges with conditions enable branching.
+
+```yaml
+edges:
+  - from: classifier
+    to: pathA
+    condition: output.category == 'A'
+  - from: classifier
+    to: pathB
+    condition: output.category == 'B'
+```
+
+### Data Flow
+
+Output from source agent becomes input to target agent.
+
+**Transformation:**
+```yaml
+edges:
+  - from: extractor
+    to: formatter
+    transform: |
+      {
+        "data": output.extracted,
+        "format": "json"
+      }
+```
+
+## Error Handling
+
+### Fail-Fast (default)
+
+Stop execution on first error.
+
+```yaml
+errorHandling:
+  strategy: fail-fast
+```
+
+### Continue
+
+Continue execution, skip failed agents.
+
+```yaml
+errorHandling:
+  strategy: continue
+```
+
+### Retry
+
+Retry failed agents up to maxRetries.
+
+```yaml
+errorHandling:
+  strategy: retry
+  maxRetries: 3
+```
+
+### Fallback
+
+Invoke fallback agent on error.
+
+```yaml
+errorHandling:
+  strategy: fail-fast
+  fallbackAgent: error-handler
+```
+
+## Examples
+
+### Sequential Pipeline
+
+```yaml
+apiVersion: ossa.ai/v0.2.7
+kind: AgentGraph
+metadata:
+  name: content-pipeline
+  version: 1.0.0
+spec:
+  agents:
+    - id: researcher
+      agentRef: research-agent
+    - id: writer
+      agentRef: writing-agent
+    - id: editor
+      agentRef: editing-agent
+  edges:
+    - from: researcher
+      to: writer
+    - from: writer
+      to: editor
+  entrypoint: researcher
+```
+
+### Parallel Processing
+
+```yaml
+apiVersion: ossa.ai/v0.2.7
+kind: AgentGraph
+metadata:
+  name: parallel-analysis
+  version: 1.0.0
+spec:
+  agents:
+    - id: splitter
+      agentRef: data-splitter
+    - id: analyzer1
+      agentRef: sentiment-analyzer
+    - id: analyzer2
+      agentRef: entity-extractor
+    - id: merger
+      agentRef: result-merger
+  edges:
+    - from: splitter
+      to: analyzer1
+    - from: splitter
+      to: analyzer2
+    - from: analyzer1
+      to: merger
+    - from: analyzer2
+      to: merger
+  entrypoint: splitter
+```
+
+### Conditional Routing
+
+```yaml
+apiVersion: ossa.ai/v0.2.7
+kind: AgentGraph
+metadata:
+  name: support-router
+  version: 1.0.0
+spec:
+  agents:
+    - id: classifier
+      agentRef: intent-classifier
+    - id: technical
+      agentRef: technical-support
+    - id: billing
+      agentRef: billing-support
+    - id: general
+      agentRef: general-support
+  edges:
+    - from: classifier
+      to: technical
+      condition: output.intent == 'technical'
+    - from: classifier
+      to: billing
+      condition: output.intent == 'billing'
+    - from: classifier
+      to: general
+      condition: output.intent == 'general'
+  entrypoint: classifier
+  errorHandling:
+    strategy: fail-fast
+    fallbackAgent: general
+```
+
+## Validation Rules
+
+1. **Acyclic**: Graph MUST NOT contain cycles
+2. **Connected**: All agents MUST be reachable from entrypoint
+3. **Valid References**: All `agentRef` MUST reference existing Agent resources
+4. **Unique IDs**: Agent IDs MUST be unique within graph
+5. **Valid Edges**: Edge `from`/`to` MUST reference agent IDs in graph
+
+## Runtime Requirements
+
+Implementations MUST:
+- Validate graph structure before execution
+- Execute agents in topological order
+- Handle parallel execution where possible
+- Evaluate conditions before edge traversal
+- Apply transformations to data flow
+- Implement specified error handling strategy
+
+## Future Considerations
+
+- **Loops**: Support for iterative agent execution
+- **Subgraphs**: Nested AgentGraph resources
+- **Dynamic Routing**: Runtime edge creation
+- **State Management**: Shared state across agents
+- **Observability**: Built-in tracing and metrics
+
+## Related Resources
+
+- [Agent Resource](./agent-definition.md)
+- [Multi-Agent Composition](../examples/multi-agent/)
+- [Error Handling](./error-handling.md)

package/dist/spec/v0.2.7/resources/agentgraph.yaml

@@ -0,0 +1,135 @@
+apiVersion: ossa.ai/v0.2.7
+kind: ResourceDefinition
+metadata:
+  name: AgentGraph
+  version: 1.0.0
+  description: Multi-agent composition and orchestration resource
+
+spec:
+  # AgentGraph defines a directed graph of agents with data flow
+  schema:
+    apiVersion:
+      type: string
+      pattern: ^ossa\.ai/v\d+\.\d+\.\d+$
+      required: true
+    
+    kind:
+      type: string
+      enum: [AgentGraph]
+      required: true
+    
+    metadata:
+      type: object
+      required: true
+      properties:
+        name:
+          type: string
+          description: Unique identifier for the agent graph
+        version:
+          type: string
+          pattern: ^\d+\.\d+\.\d+$
+        description:
+          type: string
+    
+    spec:
+      type: object
+      required: true
+      properties:
+        agents:
+          type: array
+          description: List of agents in the graph
+          items:
+            type: object
+            properties:
+              id:
+                type: string
+                description: Unique ID within graph
+              agentRef:
+                type: string
+                description: Reference to Agent resource
+              config:
+                type: object
+                description: Agent-specific configuration
+        
+        edges:
+          type: array
+          description: Data flow between agents
+          items:
+            type: object
+            properties:
+              from:
+                type: string
+                description: Source agent ID
+              to:
+                type: string
+                description: Target agent ID
+              condition:
+                type: string
+                description: Optional condition for edge traversal
+              transform:
+                type: string
+                description: Optional data transformation
+        
+        entrypoint:
+          type: string
+          description: Starting agent ID
+        
+        errorHandling:
+          type: object
+          properties:
+            strategy:
+              type: string
+              enum: [fail-fast, continue, retry]
+            maxRetries:
+              type: integer
+            fallbackAgent:
+              type: string
+
+examples:
+  - name: Sequential Pipeline
+    description: Simple sequential agent pipeline
+    yaml: |
+      apiVersion: ossa.ai/v0.2.7
+      kind: AgentGraph
+      metadata:
+        name: content-pipeline
+        version: 1.0.0
+      spec:
+        agents:
+          - id: researcher
+            agentRef: research-agent
+          - id: writer
+            agentRef: writing-agent
+          - id: editor
+            agentRef: editing-agent
+        edges:
+          - from: researcher
+            to: writer
+          - from: writer
+            to: editor
+        entrypoint: researcher
+  
+  - name: Conditional Routing
+    description: Route based on agent output
+    yaml: |
+      apiVersion: ossa.ai/v0.2.7
+      kind: AgentGraph
+      metadata:
+        name: support-router
+        version: 1.0.0
+      spec:
+        agents:
+          - id: classifier
+            agentRef: intent-classifier
+          - id: technical
+            agentRef: technical-support
+          - id: billing
+            agentRef: billing-support
+        edges:
+          - from: classifier
+            to: technical
+            condition: output.intent == 'technical'
+          - from: classifier
+            to: billing
+            condition: output.intent == 'billing'
+        entrypoint: classifier

package/dist/types/index.d.ts

@@ -160,8 +160,10 @@ export interface AgentTemplate {
 }
 /**
  * Schema versions supported
+ * Dynamic: versions are discovered from spec/ directory at runtime
+ * Supports any version pattern like 0.2.5-RC, 0.2.6, etc.
  */
-export type SchemaVersion = '0.2.3' | '0.2.2' | '0.1.9';
+export type SchemaVersion = string;
 /**
  * Service interfaces
  */
@@ -170,6 +172,9 @@ export interface IValidationService {
 }
 export interface ISchemaRepository {
     getSchema(version: SchemaVersion): Promise<Record<string, unknown>>;
+    clearCache(): void;
+    getAvailableVersions(): string[];
+    getCurrentVersion(): string;
 }
 export interface IManifestRepository {
     load(path: string): Promise<unknown>;

package/dist/types/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"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"}

package/docs/brand-guide/01-brand-overview.md

@@ -0,0 +1,37 @@
+# OSSA Brand Overview
+
+> Version 1.0.0 | Last Updated: November 2025
+
+## Mission
+
+**Make AI agents interoperable across all platforms and frameworks.**
+
+OSSA (Open Standard for Scalable AI Agents) provides a vendor-neutral specification standard that enables AI agents to communicate and collaborate seamlessly.
+
+## Vision
+
+**Become the OpenAPI for AI agents** - the universally adopted standard for defining, deploying, and connecting autonomous AI systems.
+
+## Core Values
+
+### 1. Open & Vendor-Neutral
+Community-driven, no vendor lock-in, Apache 2.0 license
+
+### 2. Interoperable  
+Common language across frameworks, runtime-independent
+
+### 3. Trustworthy
+Compliance-ready, security built-in, enterprise-grade
+
+### 4. Simple & Practical
+Clear specification, production-ready implementations
+
+## Key Messages
+
+**Primary:** "The OpenAPI for AI Agents"
+
+**For Enterprises:** Deploy anywhere, switch frameworks anytime, maintain compliance always
+
+**For Developers:** Write once, deploy anywhere - portable and future-proof
+
+**For Framework Builders:** Build on an open standard

package/docs/brand-guide/02-logo-usage.md

@@ -0,0 +1,43 @@
+# OSSA Logo Usage Guidelines
+
+> Version 1.0.0 | Last Updated: November 2025
+
+## Primary Logo
+
+Dynamic gradient-based mark representing interconnected AI agents.
+
+**Location:** `/website/public/brand/ossa-logo.svg`
+
+**Colors:** Gradient from Cyan Blue (#1CB9ED) → Deep Purple (#4A3ECD) → Light Purple (#9060EA)
+
+## Logo Variations
+
+- **Full Color:** White/light backgrounds
+- **Monochrome White:** Dark backgrounds (#FFFFFF)
+- **Monochrome Dark:** Light backgrounds, print (#2D1B69)
+- **Grayscale:** Print only (#374151)
+
+## Minimum Sizes
+
+- **Digital:** 120px width min (180px recommended)
+- **Print:** 1 inch min (1.5 inches recommended)
+- **Icon:** 16px, 32px, 64px, 128px
+
+## Clear Space
+
+Maintain clear space = **0.5× logo height** on all sides
+
+## Incorrect Usage
+
+❌ Don't change colors
+❌ Don't distort/stretch
+❌ Don't add effects
+❌ Don't modify
+❌ Don't use low-quality
+
+## Background Guidelines
+
+✅ White, light gray, light blue, dark purple, black
+❌ Bright colors, busy patterns, low-contrast
+
+**Rule:** 4.5:1 minimum contrast ratio

package/docs/brand-guide/03-color-palette.md

@@ -0,0 +1,70 @@
+# OSSA Color Palette
+
+> Version 1.0.0 | Last Updated: November 2025
+
+## Primary Brand Colors
+
+### Deep Purple (Primary)
+**Base:** `#4A3ECD`
+**Usage:** Primary actions, branding, emphasis
+**Scale:** 50-950 (see full guide)
+
+### Cyan Blue (Secondary)  
+**Base:** `#1CB9ED`
+**Usage:** Secondary actions, accents, gradients
+**Scale:** 50-950
+
+### Light Purple (Accent)
+**Base:** `#9060EA`  
+**Usage:** Decorative accents, gradient endpoints
+**Scale:** 50-950
+
+### Dark Purple (Depth)
+**Base:** `#2D1B69`
+**Usage:** Dark backgrounds, dark mode, contrast
+**Scale:** 50-950
+
+## Semantic Colors
+
+- **Success:** `#10B981` (Green)
+- **Warning:** `#F59E0B` (Amber)
+- **Error:** `#EF4444` (Red)
+- **Info:** `#06B6D4` (Cyan)
+
+## Neutrals (Grays)
+
+**Scale:** `#F9FAFB` (50) to `#111827` (900)
+
+**Common Uses:**
+- Primary text: Gray-700 (#374151) or Gray-900
+- Secondary text: Gray-600 (#4B5563)
+- Borders: Gray-200 (#E5E7EB) or Gray-300
+- Backgrounds: White, Gray-50, Gray-100
+
+## Gradients
+
+### Brand Gradient
+```css
+background: linear-gradient(135deg, #1CB9ED 0%, #1CB9ED 40%, #4A3ECD 70%, #9060EA 100%);
+```
+
+### Hero Gradient
+```css
+background: linear-gradient(135deg, #1CB9ED 0%, #1CB9ED 35%, #4A3ECD 65%, #9060EA 100%);
+```
+
+## Accessibility
+
+All combinations meet WCAG AA minimum (AAA preferred):
+- Normal text: 4.5:1 minimum (7:1 target)
+- Large text: 3:1 minimum (4.5:1 target)
+- UI components: 3:1 minimum
+
+**White text on:**
+- Primary-500+: ✅ AAA (7.5:1)
+- Secondary-600+: ✅ AA (4.7:1)
+- Dark Purple-700+: ✅ AAA (10:1+)
+
+**Black text on:**
+- Gray-50 to Gray-300: ✅ AAA (8:1+)
+- Primary-50 to Primary-400: ✅ AAA (7:1+)