@bluefly/openstandardagents 0.5.1 → 0.5.3

package/spec/v0.5/workflow.schema.json

@@ -0,0 +1,53 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://openstandardagents.org/schemas/v0.5/workflow.schema.json",
+  "title": "OSSA v0.5 Workflow",
+  "description": "Composable multi-step agent workflow manifest.",
+  "type": "object",
+  "required": ["apiVersion", "kind", "metadata", "spec"],
+  "properties": {
+    "apiVersion": {
+      "type": "string",
+      "pattern": "^ossa/v0\\.5(\\.[0-9]+)?$"
+    },
+    "kind": {
+      "type": "string",
+      "const": "Workflow"
+    },
+    "metadata": {
+      "type": "object",
+      "required": ["name"],
+      "properties": {
+        "name": { "type": "string" },
+        "version": { "type": "string" },
+        "description": { "type": "string" },
+        "labels": { "type": "object", "additionalProperties": { "type": "string" } }
+      },
+      "additionalProperties": true
+    },
+    "spec": {
+      "type": "object",
+      "properties": {
+        "triggers": { "type": "array" },
+        "inputs": { "type": "object" },
+        "outputs": { "type": "object" },
+        "steps": {
+          "type": "array",
+          "minItems": 1,
+          "items": {
+            "type": "object",
+            "required": ["id"],
+            "properties": {
+              "id": { "type": "string" },
+              "agentRef": { "type": "string" },
+              "dependsOn": { "type": "array", "items": { "type": "string" } }
+            },
+            "additionalProperties": true
+          }
+        }
+      },
+      "additionalProperties": true
+    }
+  },
+  "additionalProperties": false
+}

package/.version.json

@@ -1,7 +0,0 @@
-{
-  "current": "0.5.1",
-  "latest_stable": "0.5.1",
-  "spec_version": "0.5.1",
-  "spec_path": "spec/v0.5",
-  "schema_file": "agent.schema.json"
-}

package/bin/ossa

@@ -1,11 +0,0 @@
-#!/usr/bin/env node
-
-/**
- * OSSA CLI Entry Point
- * Runs the compiled JavaScript from dist/
- */
-
-// CRITICAL: Import reflect-metadata FIRST before any inversify code loads
-import 'reflect-metadata';
-
-import '../dist/cli/index.js';

package/bin/ossa-dev

@@ -1,8 +0,0 @@
-#!/usr/bin/env node
-
-/**
- * OSSA Dev CLI Entry Point
- * Development tools for OSSA maintainers
- */
-
-import '../dist/dev-cli/index.js';

package/bin/ossa-validate-all

@@ -1,55 +0,0 @@
-#!/usr/bin/env node
-
-/**
- * OSSA Validate All
- * Validates all OSSA manifests in examples directory
- */
-
-#!/usr/bin/env node
-
-/**
- * OSSA Validate All
- * Validates all OSSA manifests in examples directory
- */
-
-import { execSync } from 'child_process';
-import { glob } from 'glob';
-import { resolve, dirname } from 'path';
-import { fileURLToPath } from 'url';
-
-const __filename = fileURLToPath(import.meta.url);
-const __dirname = dirname(__filename);
-const root = resolve(__dirname, '..');
-
-async function main() {
-  const examples = await glob('examples/**/*.ossa.{yaml,yml}', { cwd: root });
-  
-  if (examples.length === 0) {
-    console.log('No OSSA manifests found in examples/');
-    process.exit(0);
-  }
-  
-  console.log(`Found ${examples.length} OSSA manifests to validate\n`);
-  
-  let passed = 0;
-  let failed = 0;
-  
-  for (const file of examples) {
-    try {
-      execSync(`node bin/ossa validate ${file}`, { 
-        cwd: root, 
-        stdio: 'inherit' 
-      });
-      passed++;
-    } catch (error) {
-      failed++;
-    }
-  }
-  
-  console.log(`\n✅ Passed: ${passed}`);
-  console.log(`❌ Failed: ${failed}`);
-  process.exit(failed > 0 ? 1 : 0);
-}
-
-main();
-

package/bin/ossa-version

@@ -1,23 +0,0 @@
-#!/usr/bin/env node
-
-/**
- * OSSA Version Checker
- * Shows current OSSA CLI version and schema version
- */
-
-import { readFileSync } from 'fs';
-import { resolve, dirname } from 'path';
-import { fileURLToPath } from 'url';
-
-const __filename = fileURLToPath(import.meta.url);
-const __dirname = dirname(__filename);
-
-try {
-  const pkg = JSON.parse(readFileSync(resolve(__dirname, '../package.json'), 'utf-8'));
-  console.log(`OSSA CLI: ${pkg.version}`);
-  console.log(`Schema: ${pkg.version}`);
-} catch (error) {
-  console.error('Failed to read version');
-  process.exit(1);
-}
-

package/bin/postinstall

@@ -1,62 +0,0 @@
-#!/usr/bin/env node
-
-/**
- * Postinstall Hook - Automatic Agent Migration
- *
- * Runs after `npm install` or `npm update` to help users migrate
- * their agent manifests to the latest OSSA schema version.
- *
- * IMPORTANT: Non-intrusive - only shows message, doesn't auto-migrate
- */
-
-import { existsSync } from 'fs';
-import { join } from 'path';
-import { execSync } from 'child_process';
-
-// Detect if we're being installed in a user's project (not the package itself)
-const isUserProject = async () => {
-  const cwd = process.cwd();
-  const packageJsonPath = join(cwd, 'package.json');
-
-  if (!existsSync(packageJsonPath)) {
-    return false;
-  }
-
-  try {
-    // Use dynamic import without assert (Node 22 compatible)
-    const pkgContent = existsSync(packageJsonPath) ?
-      await import('file://' + packageJsonPath, { with: { type: 'json' } }) : null;
-    if (!pkgContent) return false;
-    const pkg = pkgContent.default;
-    // If package.json name is our package, we're inside the package itself
-    return pkg.name !== '@bluefly/openstandardagents';
-  } catch {
-    return false;
-  }
-};
-
-// Check if there are likely agent manifests in the project
-const hasAgentManifests = () => {
-  try {
-    const result = execSync(
-      'find . -name "*.ossa.yaml" -o -name "*.ossa.yml" -o -name "*.ossa.json" 2>/dev/null | head -1',
-      { encoding: 'utf-8', stdio: ['pipe', 'pipe', 'ignore'] }
-    ).trim();
-    return result.length > 0;
-  } catch {
-    return false;
-  }
-};
-
-// Main
-(async () => {
-  if (await isUserProject() && hasAgentManifests()) {
-    console.log('\n📦 @bluefly/openstandardagents updated!');
-    console.log('\n🔄 Agent manifests detected in your project.');
-    console.log(
-      '   To migrate to the latest schema version, run:\n'
-    );
-    console.log('   npx ossa-dev migrate agents --dry-run');
-    console.log('   npx ossa-dev migrate agents\n');
-  }
-})();

package/dist/.version.json

@@ -1,7 +0,0 @@
-{
-  "current": "0.5.1",
-  "latest_stable": "0.5.1",
-  "spec_version": "0.5.1",
-  "spec_path": "spec/v0.5",
-  "schema_file": "agent.schema.json"
-}

package/dist/adapters/a2a/a2a-protocol.d.ts

@@ -1,398 +0,0 @@
-/**
- * A2A (Agent-to-Agent) Communication Protocol
- *
- * Extends MCP (Model Context Protocol) with advanced multi-agent capabilities
- * Based on OSSA v0.4.4 spec and MCP specification
- *
- * References:
- * - MCP Spec: https://spec.modelcontextprotocol.io/
- * - OSSA A2A Protocol: v0.3.0
- *
- * @module adapters/a2a/a2a-protocol
- */
-import { z } from 'zod';
-/**
- * Agent Identity
- * Represents a unique agent in the mesh
- */
-export interface AgentIdentity {
-    /** Unique agent ID (UUID) */
-    id: string;
-    /** Agent namespace (e.g., 'production', 'staging') */
-    namespace: string;
-    /** Agent name */
-    name: string;
-    /** Agent URI format: uadp://{namespace}/{name} */
-    uri: string;
-    /** Agent capabilities */
-    capabilities: string[];
-    /** Agent version */
-    version: string;
-}
-/**
- * Message Priority Levels
- */
-export declare enum MessagePriority {
-    LOW = "low",
-    NORMAL = "normal",
-    HIGH = "high",
-    URGENT = "urgent",
-    CRITICAL = "critical"
-}
-/**
- * Message Types
- */
-export declare enum A2AMessageType {
-    /** Request-reply pattern */
-    REQUEST = "request",
-    /** Response to a request */
-    RESPONSE = "response",
-    /** Broadcast to multiple agents */
-    BROADCAST = "broadcast",
-    /** Coordination message for swarm intelligence */
-    COORDINATION = "coordination",
-    /** Task delegation */
-    DELEGATION = "delegation",
-    /** Event notification */
-    EVENT = "event",
-    /** Command (RPC) */
-    COMMAND = "command"
-}
-/**
- * W3C Trace Context for distributed tracing
- * @see https://www.w3.org/TR/trace-context/
- */
-export interface TraceContext {
-    /** W3C traceparent header (version-trace_id-parent_id-trace_flags) */
-    traceparent: string;
-    /** W3C tracestate header (vendor-specific trace data) */
-    tracestate?: string;
-    /** Trace ID (32 hex chars) */
-    traceId: string;
-    /** Span ID (16 hex chars) */
-    spanId: string;
-    /** Parent span ID */
-    parentSpanId?: string;
-}
-/**
- * Message Metadata
- */
-export interface MessageMetadata {
-    /** Priority level */
-    priority: MessagePriority;
-    /** Message timeout in milliseconds */
-    timeout: number;
-    /** Maximum retry attempts */
-    retries: number;
-    /** W3C trace context */
-    traceContext: TraceContext;
-    /** Correlation ID for grouping related messages */
-    correlationId?: string;
-    /** Content type */
-    contentType?: string;
-    /** Custom headers */
-    headers?: Record<string, string>;
-    /** Retry count (incremented on each retry) */
-    retryCount?: number;
-    /** Created timestamp (ISO 8601) */
-    createdAt: string;
-    /** Expires at timestamp (ISO 8601) */
-    expiresAt?: string;
-}
-/**
- * A2A Message Envelope
- * Core message structure for agent-to-agent communication
- */
-export interface A2AMessage<TPayload = unknown> {
-    /** Unique message ID (UUID) */
-    id: string;
-    /** Sender agent identity */
-    from: AgentIdentity;
-    /** Recipient agent(s) - single agent or array for multicast */
-    to: AgentIdentity | AgentIdentity[];
-    /** Message type */
-    type: A2AMessageType;
-    /** Application-specific payload */
-    payload: TPayload;
-    /** Message metadata */
-    metadata: MessageMetadata;
-    /** Protocol version */
-    version: string;
-}
-/**
- * Consensus Algorithm Types
- */
-export declare enum ConsensusAlgorithm {
-    /** Simple majority voting */
-    MAJORITY = "majority",
-    /** Unanimous agreement required */
-    UNANIMOUS = "unanimous",
-    /** Weighted voting based on agent capabilities */
-    WEIGHTED = "weighted",
-    /** Raft consensus (leader election) */
-    RAFT = "raft",
-    /** Paxos consensus */
-    PAXOS = "paxos"
-}
-/**
- * Coordination Pattern Types
- */
-export declare enum CoordinationPatternType {
-    /** One-to-many broadcast */
-    BROADCAST = "broadcast",
-    /** Request-reply pattern */
-    REQUEST_REPLY = "request-reply",
-    /** Publish-subscribe pattern */
-    PUB_SUB = "pub-sub",
-    /** Pipeline pattern (sequential processing) */
-    PIPELINE = "pipeline",
-    /** Swarm pattern (distributed coordination) */
-    SWARM = "swarm",
-    /** Hierarchical pattern (tree-based) */
-    HIERARCHICAL = "hierarchical",
-    /** Mesh pattern (peer-to-peer) */
-    MESH = "mesh"
-}
-/**
- * Coordination Pattern Configuration
- */
-export interface CoordinationPattern {
-    /** Pattern type */
-    pattern: CoordinationPatternType;
-    /** Participating agents */
-    participants: AgentIdentity[];
-    /** Coordinator agent (for hierarchical patterns) */
-    coordinator?: AgentIdentity;
-    /** Consensus algorithm (for swarm patterns) */
-    consensus?: ConsensusAlgorithm;
-    /** Timeout for coordination (milliseconds) */
-    timeout?: number;
-    /** Minimum required participants */
-    minParticipants?: number;
-}
-/**
- * Agent Connection (Edge in mesh graph)
- */
-export interface AgentConnection {
-    /** Source agent */
-    from: AgentIdentity;
-    /** Target agent */
-    to: AgentIdentity;
-    /** Connection weight (for routing) */
-    weight: number;
-    /** Connection latency (milliseconds) */
-    latency: number;
-    /** Connection status */
-    status: 'active' | 'degraded' | 'inactive';
-    /** Connection metadata */
-    metadata?: Record<string, unknown>;
-}
-/**
- * Agent Node (Vertex in mesh graph)
- */
-export interface AgentNode {
-    /** Agent identity */
-    identity: AgentIdentity;
-    /** Agent status */
-    status: 'healthy' | 'degraded' | 'unavailable';
-    /** Current load (0-1) */
-    load: number;
-    /** Available capacity (0-1) */
-    capacity: number;
-    /** Endpoint URL */
-    endpoint: string;
-    /** Health check URL */
-    healthCheck: string;
-    /** Last heartbeat timestamp */
-    lastHeartbeat: string;
-    /** Node metadata */
-    metadata?: Record<string, unknown>;
-}
-/**
- * Routing Algorithm Types
- */
-export declare enum RoutingAlgorithm {
-    /** Round-robin routing */
-    ROUND_ROBIN = "round-robin",
-    /** Least connections routing */
-    LEAST_CONNECTIONS = "least-connections",
-    /** Weighted round-robin */
-    WEIGHTED_ROUND_ROBIN = "weighted-round-robin",
-    /** Shortest path (Dijkstra) */
-    SHORTEST_PATH = "shortest-path",
-    /** Random routing */
-    RANDOM = "random",
-    /** Consistent hashing */
-    CONSISTENT_HASH = "consistent-hash"
-}
-/**
- * Service Discovery Types
- */
-export declare enum ServiceDiscovery {
-    /** DNS-based service discovery */
-    DNS = "dns",
-    /** Consul service discovery */
-    CONSUL = "consul",
-    /** Kubernetes service discovery */
-    KUBERNETES = "kubernetes",
-    /** Static configuration */
-    STATIC = "static",
-    /** Gossip protocol (SWIM) */
-    GOSSIP = "gossip"
-}
-/**
- * Mesh Topology Configuration
- * Represents the agent mesh network structure
- */
-export interface MeshTopology {
-    /** Agent nodes in the mesh */
-    nodes: AgentNode[];
-    /** Connections between agents */
-    edges: AgentConnection[];
-    /** Routing algorithm */
-    routing: RoutingAlgorithm;
-    /** Service discovery mechanism */
-    discovery: ServiceDiscovery;
-    /** Mesh metadata */
-    metadata?: {
-        /** Mesh name */
-        name?: string;
-        /** Mesh namespace */
-        namespace?: string;
-        /** Mesh version */
-        version?: string;
-    };
-}
-/**
- * A2A Error Types
- */
-export declare enum A2AErrorType {
-    /** Agent not found in mesh */
-    AGENT_NOT_FOUND = "AGENT_NOT_FOUND",
-    /** Agent unreachable (network error) */
-    AGENT_UNREACHABLE = "AGENT_UNREACHABLE",
-    /** Message timeout */
-    MESSAGE_TIMEOUT = "MESSAGE_TIMEOUT",
-    /** Invalid message format */
-    INVALID_MESSAGE = "INVALID_MESSAGE",
-    /** Authentication failed */
-    AUTH_FAILED = "AUTH_FAILED",
-    /** Insufficient permissions */
-    INSUFFICIENT_PERMISSIONS = "INSUFFICIENT_PERMISSIONS",
-    /** Rate limited */
-    RATE_LIMITED = "RATE_LIMITED",
-    /** Circuit breaker open */
-    CIRCUIT_OPEN = "CIRCUIT_OPEN",
-    /** Unknown error */
-    UNKNOWN = "UNKNOWN"
-}
-/**
- * A2A Error
- */
-export declare class A2AError extends Error {
-    type: A2AErrorType;
-    message: string;
-    details?: Record<string, unknown> | undefined;
-    retryable: boolean;
-    constructor(type: A2AErrorType, message: string, details?: Record<string, unknown> | undefined, retryable?: boolean);
-}
-/**
- * Zod Schemas for validation
- */
-export declare const AgentIdentitySchema: z.ZodObject<{
-    id: z.ZodString;
-    namespace: z.ZodString;
-    name: z.ZodString;
-    uri: z.ZodString;
-    capabilities: z.ZodArray<z.ZodString>;
-    version: z.ZodString;
-}, z.core.$strip>;
-export declare const TraceContextSchema: z.ZodObject<{
-    traceparent: z.ZodString;
-    tracestate: z.ZodOptional<z.ZodString>;
-    traceId: z.ZodString;
-    spanId: z.ZodString;
-    parentSpanId: z.ZodOptional<z.ZodString>;
-}, z.core.$strip>;
-export declare const MessageMetadataSchema: z.ZodObject<{
-    priority: z.ZodEnum<typeof MessagePriority>;
-    timeout: z.ZodNumber;
-    retries: z.ZodNumber;
-    traceContext: z.ZodObject<{
-        traceparent: z.ZodString;
-        tracestate: z.ZodOptional<z.ZodString>;
-        traceId: z.ZodString;
-        spanId: z.ZodString;
-        parentSpanId: z.ZodOptional<z.ZodString>;
-    }, z.core.$strip>;
-    correlationId: z.ZodOptional<z.ZodString>;
-    contentType: z.ZodOptional<z.ZodString>;
-    headers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
-    retryCount: z.ZodOptional<z.ZodNumber>;
-    createdAt: z.ZodString;
-    expiresAt: z.ZodOptional<z.ZodString>;
-}, z.core.$strip>;
-export declare const A2AMessageSchema: z.ZodObject<{
-    id: z.ZodString;
-    from: z.ZodObject<{
-        id: z.ZodString;
-        namespace: z.ZodString;
-        name: z.ZodString;
-        uri: z.ZodString;
-        capabilities: z.ZodArray<z.ZodString>;
-        version: z.ZodString;
-    }, z.core.$strip>;
-    to: z.ZodUnion<readonly [z.ZodObject<{
-        id: z.ZodString;
-        namespace: z.ZodString;
-        name: z.ZodString;
-        uri: z.ZodString;
-        capabilities: z.ZodArray<z.ZodString>;
-        version: z.ZodString;
-    }, z.core.$strip>, z.ZodArray<z.ZodObject<{
-        id: z.ZodString;
-        namespace: z.ZodString;
-        name: z.ZodString;
-        uri: z.ZodString;
-        capabilities: z.ZodArray<z.ZodString>;
-        version: z.ZodString;
-    }, z.core.$strip>>]>;
-    type: z.ZodEnum<typeof A2AMessageType>;
-    payload: z.ZodUnknown;
-    metadata: z.ZodObject<{
-        priority: z.ZodEnum<typeof MessagePriority>;
-        timeout: z.ZodNumber;
-        retries: z.ZodNumber;
-        traceContext: z.ZodObject<{
-            traceparent: z.ZodString;
-            tracestate: z.ZodOptional<z.ZodString>;
-            traceId: z.ZodString;
-            spanId: z.ZodString;
-            parentSpanId: z.ZodOptional<z.ZodString>;
-        }, z.core.$strip>;
-        correlationId: z.ZodOptional<z.ZodString>;
-        contentType: z.ZodOptional<z.ZodString>;
-        headers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
-        retryCount: z.ZodOptional<z.ZodNumber>;
-        createdAt: z.ZodString;
-        expiresAt: z.ZodOptional<z.ZodString>;
-    }, z.core.$strip>;
-    version: z.ZodString;
-}, z.core.$strip>;
-/**
- * Validate A2A message
- */
-export declare function validateA2AMessage(message: unknown): A2AMessage;
-/**
- * Create A2A message
- */
-export declare function createA2AMessage<TPayload>(from: AgentIdentity, to: AgentIdentity | AgentIdentity[], type: A2AMessageType, payload: TPayload, options?: Partial<MessageMetadata>): A2AMessage<TPayload>;
-/**
- * Check if message is expired
- */
-export declare function isMessageExpired(message: A2AMessage): boolean;
-/**
- * Check if message should be retried
- */
-export declare function shouldRetryMessage(message: A2AMessage, error: A2AError): boolean;
-//# sourceMappingURL=a2a-protocol.d.ts.map