@bluefly/openstandardagents 0.2.9 → 0.3.0

package/dist/mesh/types.d.ts

@@ -0,0 +1,439 @@
+/**
+ * Agent Mesh Communication Layer - Type Definitions
+ * Based on OSSA v0.3.0 Messaging Specification and v0.3.0 A2A Protocol
+ */
+/**
+ * Message Types
+ */
+export type MessageType = 'request' | 'response' | 'event' | 'command';
+/**
+ * Message Priority Levels
+ */
+export type MessagePriority = 'low' | 'normal' | 'high' | 'urgent' | 'critical';
+/**
+ * Task States for Agent Collaboration
+ */
+export type TaskState = 'submitted' | 'accepted' | 'rejected' | 'working' | 'completed' | 'failed' | 'cancelled';
+/**
+ * A2A Error Codes
+ */
+export type A2AErrorCode = 'AGENT_NOT_FOUND' | 'AGENT_UNREACHABLE' | 'TOPIC_NOT_FOUND' | 'AUTH_REQUIRED' | 'AUTH_FAILED' | 'AUTH_EXPIRED' | 'INSUFFICIENT_PERMISSIONS' | 'INVALID_MESSAGE' | 'MESSAGE_EXPIRED' | 'MESSAGE_TOO_LARGE' | 'TASK_REJECTED' | 'TASK_TIMEOUT' | 'TASK_CANCELLED' | 'UNSUPPORTED_VERSION' | 'UNSUPPORTED_TRANSPORT' | 'RATE_LIMITED';
+/**
+ * Transport Types
+ */
+export type Transport = 'http' | 'grpc' | 'websocket' | 'mqtt';
+/**
+ * Authentication Methods
+ */
+export type AuthMethod = 'mtls' | 'bearer' | 'oidc' | 'api_key' | 'none';
+/**
+ * Delivery Guarantees
+ */
+export type DeliveryGuarantee = 'at-most-once' | 'at-least-once' | 'exactly-once';
+/**
+ * Agent Status
+ */
+export type AgentStatus = 'healthy' | 'degraded' | 'unavailable';
+/**
+ * Message Envelope
+ * Standard envelope format for all A2A messages
+ */
+export interface MessageEnvelope<T = unknown> {
+    /** Protocol version - MUST be ossa/a2a/v0.3.0 */
+    version: string;
+    /** Unique message identifier (UUID) */
+    id: string;
+    /** Message creation timestamp (ISO 8601) */
+    timestamp: string;
+    /** Sender agent URI (format: agent://{namespace}/{name}) */
+    from: string;
+    /** Recipient agent URI or topic */
+    to: string;
+    /** Message type */
+    type: MessageType;
+    /** Application-specific payload */
+    payload: T;
+    /** Optional correlation ID for request/response pairs */
+    correlationId?: string;
+    /** Optional reply-to address */
+    replyTo?: string;
+    /** Time-to-live in seconds (default: 300) */
+    ttl?: number;
+    /** Message priority */
+    priority?: MessagePriority;
+    /** W3C trace context */
+    traceContext?: TraceContext;
+    /** Message metadata */
+    metadata?: MessageMetadata;
+}
+/**
+ * W3C Trace Context
+ */
+export interface TraceContext {
+    /** W3C traceparent header */
+    traceparent: string;
+    /** W3C tracestate header */
+    tracestate?: string;
+}
+/**
+ * Message Metadata
+ */
+export interface MessageMetadata {
+    /** Correlation ID for grouping related messages */
+    correlationId?: string;
+    /** Trace ID for distributed tracing */
+    traceId?: string;
+    /** Span ID for distributed tracing */
+    spanId?: string;
+    /** Message priority */
+    priority?: MessagePriority;
+    /** Time-to-live in seconds */
+    ttlSeconds?: number;
+    /** Retry count */
+    retryCount?: number;
+    /** Content type */
+    contentType?: string;
+    /** Custom headers */
+    headers?: Record<string, string>;
+}
+/**
+ * Agent Card
+ * Self-describing document advertising agent capabilities
+ */
+export interface AgentCard {
+    uri: string;
+    name: string;
+    version: string;
+    ossaVersion: string;
+    capabilities: string[];
+    tools?: ToolDescriptor[];
+    role?: string;
+    endpoints: {
+        http?: string;
+        grpc?: string;
+        websocket?: string;
+    };
+    transport: Transport[];
+    authentication: AuthMethod[];
+    encryption: EncryptionSpec;
+    metadata?: {
+        team?: string;
+        environment?: string;
+        region?: string;
+        [key: string]: unknown;
+    };
+    status?: AgentStatus;
+    lastHeartbeat?: string;
+}
+/**
+ * Tool Descriptor
+ */
+export interface ToolDescriptor {
+    name: string;
+    description: string;
+    inputSchema: JSONSchema;
+    outputSchema?: JSONSchema;
+}
+/**
+ * Encryption Specification
+ */
+export interface EncryptionSpec {
+    tlsRequired: boolean;
+    minTlsVersion: '1.2' | '1.3';
+    cipherSuites?: string[];
+}
+/**
+ * Task Status
+ */
+export interface TaskStatus {
+    taskId: string;
+    state: TaskState;
+    progress?: number;
+    message?: string;
+    error?: TaskError;
+    startedAt?: string;
+    completedAt?: string;
+}
+/**
+ * Task Error
+ */
+export interface TaskError {
+    code: string;
+    message: string;
+    details?: unknown;
+    recoverable: boolean;
+}
+/**
+ * A2A Error
+ */
+export interface A2AError {
+    code: A2AErrorCode;
+    message: string;
+    details?: Record<string, unknown>;
+    timestamp: string;
+    retryAfterSeconds?: number;
+}
+/**
+ * Retry Policy
+ */
+export interface RetryPolicy {
+    maxAttempts: number;
+    backoff: 'exponential' | 'linear' | 'constant';
+    initialDelayMs: number;
+    maxDelayMs: number;
+    multiplier?: number;
+    retryableErrors?: A2AErrorCode[];
+}
+/**
+ * Circuit Breaker Configuration
+ */
+export interface CircuitBreakerConfig {
+    enabled: boolean;
+    failureThreshold: number;
+    successThreshold: number;
+    timeout: number;
+    halfOpenRequests: number;
+}
+/**
+ * Reliability Configuration
+ */
+export interface ReliabilityConfig {
+    deliveryGuarantee: DeliveryGuarantee;
+    retry: RetryPolicy;
+    dlq?: {
+        enabled: boolean;
+        channel: string;
+        retentionDays: number;
+    };
+    ordering?: {
+        guarantee: 'per-source' | 'per-channel' | 'none';
+        timeoutSeconds: number;
+    };
+    acknowledgment?: {
+        mode: 'auto' | 'manual';
+        timeoutSeconds: number;
+    };
+}
+/**
+ * Published Channel Configuration
+ */
+export interface PublishedChannel {
+    channel: string;
+    description?: string;
+    schema: JSONSchema;
+    examples?: unknown[];
+    contentType?: string;
+    tags?: string[];
+}
+/**
+ * Subscription Configuration
+ */
+export interface Subscription {
+    channel: string;
+    description?: string;
+    schema?: JSONSchema;
+    handler: string;
+    filter?: {
+        expression?: string;
+        fields?: Record<string, unknown>;
+    };
+    priority?: MessagePriority;
+    maxConcurrency?: number;
+}
+/**
+ * Command Configuration (RPC)
+ */
+export interface Command {
+    name: string;
+    description?: string;
+    inputSchema: JSONSchema;
+    outputSchema?: JSONSchema;
+    timeoutSeconds?: number;
+    idempotent?: boolean;
+    async?: boolean;
+}
+/**
+ * Routing Rule
+ */
+export interface RoutingRule {
+    id?: string;
+    source: string;
+    channel: string;
+    targets: string[];
+    filter?: {
+        expression?: string;
+        fields?: Record<string, unknown>;
+    };
+    transform?: string;
+    priority?: MessagePriority;
+    enabled?: boolean;
+}
+/**
+ * Messaging Extension
+ * Agent-to-agent messaging configuration
+ */
+export interface MessagingExtension {
+    publishes?: PublishedChannel[];
+    subscribes?: Subscription[];
+    commands?: Command[];
+    reliability?: ReliabilityConfig;
+}
+/**
+ * JSON Schema Definition
+ */
+export interface JSONSchema {
+    type?: string;
+    properties?: Record<string, JSONSchema>;
+    required?: string[];
+    items?: JSONSchema;
+    enum?: unknown[];
+    pattern?: string;
+    format?: string;
+    minimum?: number;
+    maximum?: number;
+    minLength?: number;
+    maxLength?: number;
+    minItems?: number;
+    maxItems?: number;
+    [key: string]: unknown;
+}
+/**
+ * Agent Mesh Configuration
+ */
+export interface AgentMeshConfig {
+    agents: AgentInfo[];
+    communication: CommunicationConfig;
+    serviceMesh?: ServiceMeshConfig;
+    observability: ObservabilityConfig;
+    workflows?: WorkflowConfig[];
+    security: SecurityConfig;
+}
+/**
+ * Agent Info
+ */
+export interface AgentInfo {
+    name: string;
+    namespace: string;
+    endpoint: string;
+    healthCheck: string;
+    capabilities: string[];
+    dependencies: string[];
+}
+/**
+ * Communication Configuration
+ */
+export interface CommunicationConfig {
+    protocol: 'json-rpc' | 'grpc' | 'http';
+    version: string;
+    transport: Transport;
+    timeout: number;
+    authentication: {
+        type: AuthMethod;
+        [key: string]: unknown;
+    };
+    messageFormat: {
+        contentType: string;
+        encoding: string;
+        compression?: string;
+    };
+    retryPolicy: RetryPolicy;
+    circuitBreaker?: CircuitBreakerConfig;
+}
+/**
+ * Service Mesh Configuration
+ */
+export interface ServiceMeshConfig {
+    enabled: boolean;
+    provider: 'istio' | 'linkerd' | 'consul';
+    version: string;
+    mtls: {
+        mode: 'STRICT' | 'PERMISSIVE' | 'DISABLED';
+    };
+}
+/**
+ * Observability Configuration
+ */
+export interface ObservabilityConfig {
+    tracing: {
+        enabled: boolean;
+        samplingRate: number;
+        exporter: string;
+        endpoint: string;
+    };
+    metrics: {
+        enabled: boolean;
+        exporter: string;
+        endpoint: string;
+        customMetrics?: MetricDefinition[];
+    };
+    logging: {
+        level: 'debug' | 'info' | 'warn' | 'error';
+        format: 'json' | 'text';
+        destination: string;
+    };
+}
+/**
+ * Metric Definition
+ */
+export interface MetricDefinition {
+    name: string;
+    type: 'counter' | 'histogram' | 'gauge' | 'summary';
+    description: string;
+    labels: string[];
+}
+/**
+ * Workflow Configuration
+ */
+export interface WorkflowConfig {
+    name: string;
+    description?: string;
+    steps: WorkflowStep[];
+}
+/**
+ * Workflow Step
+ */
+export interface WorkflowStep {
+    agent: string;
+    action: string;
+    onFailure?: 'abort' | 'continue' | 'rollback';
+    timeout?: number;
+    trigger?: string;
+}
+/**
+ * Security Configuration
+ */
+export interface SecurityConfig {
+    networkPolicies?: {
+        enabled: boolean;
+        defaultDeny: boolean;
+        allowedConnections?: Connection[];
+    };
+    rbac?: {
+        enabled: boolean;
+        serviceAccounts?: {
+            autoCreate: boolean;
+            annotations?: Record<string, string>;
+        };
+    };
+    podSecurity?: {
+        enforce: 'privileged' | 'baseline' | 'restricted';
+        audit: 'privileged' | 'baseline' | 'restricted';
+        warn: 'privileged' | 'baseline' | 'restricted';
+    };
+}
+/**
+ * Network Connection
+ */
+export interface Connection {
+    from: string;
+    to: string;
+}
+/**
+ * Message Handler Function
+ */
+export type MessageHandler<T = unknown> = (message: MessageEnvelope<T>) => Promise<void> | void;
+/**
+ * Command Handler Function
+ */
+export type CommandHandler<TInput = unknown, TOutput = unknown> = (input: TInput) => Promise<TOutput> | TOutput;
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/mesh/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG,SAAS,GAAG,UAAU,GAAG,OAAO,GAAG,SAAS,CAAC;AAEvE;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG,KAAK,GAAG,QAAQ,GAAG,MAAM,GAAG,QAAQ,GAAG,UAAU,CAAC;AAEhF;;GAEG;AACH,MAAM,MAAM,SAAS,GACjB,WAAW,GACX,UAAU,GACV,UAAU,GACV,SAAS,GACT,WAAW,GACX,QAAQ,GACR,WAAW,CAAC;AAEhB;;GAEG;AACH,MAAM,MAAM,YAAY,GAEpB,iBAAiB,GACjB,mBAAmB,GACnB,iBAAiB,GAEjB,eAAe,GACf,aAAa,GACb,cAAc,GACd,0BAA0B,GAE1B,iBAAiB,GACjB,iBAAiB,GACjB,mBAAmB,GAEnB,eAAe,GACf,cAAc,GACd,gBAAgB,GAEhB,qBAAqB,GACrB,uBAAuB,GACvB,cAAc,CAAC;AAEnB;;GAEG;AACH,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG,MAAM,GAAG,WAAW,GAAG,MAAM,CAAC;AAE/D;;GAEG;AACH,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,QAAQ,GAAG,MAAM,GAAG,SAAS,GAAG,MAAM,CAAC;AAEzE;;GAEG;AACH,MAAM,MAAM,iBAAiB,GAAG,cAAc,GAAG,eAAe,GAAG,cAAc,CAAC;AAElF;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG,SAAS,GAAG,UAAU,GAAG,aAAa,CAAC;AAEjE;;;GAGG;AACH,MAAM,WAAW,eAAe,CAAC,CAAC,GAAG,OAAO;IAC1C,iDAAiD;IACjD,OAAO,EAAE,MAAM,CAAC;IAChB,uCAAuC;IACvC,EAAE,EAAE,MAAM,CAAC;IACX,4CAA4C;IAC5C,SAAS,EAAE,MAAM,CAAC;IAClB,4DAA4D;IAC5D,IAAI,EAAE,MAAM,CAAC;IACb,mCAAmC;IACnC,EAAE,EAAE,MAAM,CAAC;IACX,mBAAmB;IACnB,IAAI,EAAE,WAAW,CAAC;IAClB,mCAAmC;IACnC,OAAO,EAAE,CAAC,CAAC;IACX,yDAAyD;IACzD,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,gCAAgC;IAChC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,6CAA6C;IAC7C,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,uBAAuB;IACvB,QAAQ,CAAC,EAAE,eAAe,CAAC;IAC3B,wBAAwB;IACxB,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B,uBAAuB;IACvB,QAAQ,CAAC,EAAE,eAAe,CAAC;CAC5B;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,6BAA6B;IAC7B,WAAW,EAAE,MAAM,CAAC;IACpB,4BAA4B;IAC5B,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,mDAAmD;IACnD,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,uCAAuC;IACvC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,sCAAsC;IACtC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,uBAAuB;IACvB,QAAQ,CAAC,EAAE,eAAe,CAAC;IAC3B,8BAA8B;IAC9B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,kBAAkB;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,mBAAmB;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,qBAAqB;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAClC;AAED;;;GAGG;AACH,MAAM,WAAW,SAAS;IAExB,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IAGpB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,KAAK,CAAC,EAAE,cAAc,EAAE,CAAC;IACzB,IAAI,CAAC,EAAE,MAAM,CAAC;IAGd,SAAS,EAAE;QACT,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB,CAAC;IACF,SAAS,EAAE,SAAS,EAAE,CAAC;IAGvB,cAAc,EAAE,UAAU,EAAE,CAAC;IAC7B,UAAU,EAAE,cAAc,CAAC;IAG3B,QAAQ,CAAC,EAAE;QACT,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;KACxB,CAAC;IAGF,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,UAAU,CAAC;IACxB,YAAY,CAAC,EAAE,UAAU,CAAC;CAC3B;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,WAAW,EAAE,OAAO,CAAC;IACrB,aAAa,EAAE,KAAK,GAAG,KAAK,CAAC;IAC7B,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,SAAS,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,WAAW,EAAE,OAAO,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,YAAY,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,SAAS,EAAE,MAAM,CAAC;IAClB,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,aAAa,GAAG,QAAQ,GAAG,UAAU,CAAC;IAC/C,cAAc,EAAE,MAAM,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,eAAe,CAAC,EAAE,YAAY,EAAE,CAAC;CAClC;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,OAAO,CAAC;IACjB,gBAAgB,EAAE,MAAM,CAAC;IACzB,gBAAgB,EAAE,MAAM,CAAC;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,iBAAiB,EAAE,iBAAiB,CAAC;IACrC,KAAK,EAAE,WAAW,CAAC;IACnB,GAAG,CAAC,EAAE;QACJ,OAAO,EAAE,OAAO,CAAC;QACjB,OAAO,EAAE,MAAM,CAAC;QAChB,aAAa,EAAE,MAAM,CAAC;KACvB,CAAC;IACF,QAAQ,CAAC,EAAE;QACT,SAAS,EAAE,YAAY,GAAG,aAAa,GAAG,MAAM,CAAC;QACjD,cAAc,EAAE,MAAM,CAAC;KACxB,CAAC;IACF,cAAc,CAAC,EAAE;QACf,IAAI,EAAE,MAAM,GAAG,QAAQ,CAAC;QACxB,cAAc,EAAE,MAAM,CAAC;KACxB,CAAC;CACH;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,UAAU,CAAC;IACnB,QAAQ,CAAC,EAAE,OAAO,EAAE,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,UAAU,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE;QACP,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KAClC,CAAC;IACF,QAAQ,CAAC,EAAE,eAAe,CAAC;IAC3B,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,OAAO;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,UAAU,CAAC;IACxB,YAAY,CAAC,EAAE,UAAU,CAAC;IAC1B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,MAAM,CAAC,EAAE;QACP,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KAClC,CAAC;IACF,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,eAAe,CAAC;IAC3B,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED;;;GAGG;AACH,MAAM,WAAW,kBAAkB;IACjC,SAAS,CAAC,EAAE,gBAAgB,EAAE,CAAC;IAC/B,UAAU,CAAC,EAAE,YAAY,EAAE,CAAC;IAC5B,QAAQ,CAAC,EAAE,OAAO,EAAE,CAAC;IACrB,WAAW,CAAC,EAAE,iBAAiB,CAAC;CACjC;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IACxC,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,KAAK,CAAC,EAAE,UAAU,CAAC;IACnB,IAAI,CAAC,EAAE,OAAO,EAAE,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,SAAS,EAAE,CAAC;IACpB,aAAa,EAAE,mBAAmB,CAAC;IACnC,WAAW,CAAC,EAAE,iBAAiB,CAAC;IAChC,aAAa,EAAE,mBAAmB,CAAC;IACnC,SAAS,CAAC,EAAE,cAAc,EAAE,CAAC;IAC7B,QAAQ,EAAE,cAAc,CAAC;CAC1B;AAED;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,YAAY,EAAE,MAAM,EAAE,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,QAAQ,EAAE,UAAU,GAAG,MAAM,GAAG,MAAM,CAAC;IACvC,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,SAAS,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,cAAc,EAAE;QACd,IAAI,EAAE,UAAU,CAAC;QACjB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;KACxB,CAAC;IACF,aAAa,EAAE;QACb,WAAW,EAAE,MAAM,CAAC;QACpB,QAAQ,EAAE,MAAM,CAAC;QACjB,WAAW,CAAC,EAAE,MAAM,CAAC;KACtB,CAAC;IACF,WAAW,EAAE,WAAW,CAAC;IACzB,cAAc,CAAC,EAAE,oBAAoB,CAAC;CACvC;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,OAAO,GAAG,SAAS,GAAG,QAAQ,CAAC;IACzC,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE;QACJ,IAAI,EAAE,QAAQ,GAAG,YAAY,GAAG,UAAU,CAAC;KAC5C,CAAC;CACH;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE;QACP,OAAO,EAAE,OAAO,CAAC;QACjB,YAAY,EAAE,MAAM,CAAC;QACrB,QAAQ,EAAE,MAAM,CAAC;QACjB,QAAQ,EAAE,MAAM,CAAC;KAClB,CAAC;IACF,OAAO,EAAE;QACP,OAAO,EAAE,OAAO,CAAC;QACjB,QAAQ,EAAE,MAAM,CAAC;QACjB,QAAQ,EAAE,MAAM,CAAC;QACjB,aAAa,CAAC,EAAE,gBAAgB,EAAE,CAAC;KACpC,CAAC;IACF,OAAO,EAAE;QACP,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;QAC3C,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC;QACxB,WAAW,EAAE,MAAM,CAAC;KACrB,CAAC;CACH;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,SAAS,GAAG,WAAW,GAAG,OAAO,GAAG,SAAS,CAAC;IACpD,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,YAAY,EAAE,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,OAAO,GAAG,UAAU,GAAG,UAAU,CAAC;IAC9C,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,eAAe,CAAC,EAAE;QAChB,OAAO,EAAE,OAAO,CAAC;QACjB,WAAW,EAAE,OAAO,CAAC;QACrB,kBAAkB,CAAC,EAAE,UAAU,EAAE,CAAC;KACnC,CAAC;IACF,IAAI,CAAC,EAAE;QACL,OAAO,EAAE,OAAO,CAAC;QACjB,eAAe,CAAC,EAAE;YAChB,UAAU,EAAE,OAAO,CAAC;YACpB,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;SACtC,CAAC;KACH,CAAC;IACF,WAAW,CAAC,EAAE;QACZ,OAAO,EAAE,YAAY,GAAG,UAAU,GAAG,YAAY,CAAC;QAClD,KAAK,EAAE,YAAY,GAAG,UAAU,GAAG,YAAY,CAAC;QAChD,IAAI,EAAE,YAAY,GAAG,UAAU,GAAG,YAAY,CAAC;KAChD,CAAC;CACH;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;CACZ;AAED;;GAEG;AACH,MAAM,MAAM,cAAc,CAAC,CAAC,GAAG,OAAO,IAAI,CAAC,OAAO,EAAE,eAAe,CAAC,CAAC,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;AAEhG;;GAEG;AACH,MAAM,MAAM,cAAc,CAAC,MAAM,GAAG,OAAO,EAAE,OAAO,GAAG,OAAO,IAAI,CAChE,KAAK,EAAE,MAAM,KACV,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC"}

package/dist/mesh/types.js

@@ -0,0 +1,6 @@
+/**
+ * Agent Mesh Communication Layer - Type Definitions
+ * Based on OSSA v0.3.0 Messaging Specification and v0.3.0 A2A Protocol
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/mesh/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/mesh/types.ts"],"names":[],"mappings":"AAAA;;;GAGG"}

package/dist/messaging/broker.d.ts

@@ -0,0 +1,76 @@
+/**
+ * OSSA v0.3.1 Messaging Extension - Message Broker
+ * Core message broker interface and base implementation
+ */
+import { Message, MessageBroker, MessageHandler, Subscription, SubscriptionHandle, Channel, DeliveryReceipt } from './types.js';
+import { ChannelManager } from './channels.js';
+/**
+ * Abstract base class for message brokers
+ */
+export declare abstract class AbstractMessageBroker implements MessageBroker {
+    protected channelManager: ChannelManager;
+    protected subscriptions: Map<string, Set<SubscriptionHandle>>;
+    constructor(channelManager: ChannelManager);
+    /**
+     * Publish a message to a channel
+     */
+    abstract publish(channel: string, message: Message): Promise<void>;
+    /**
+     * Subscribe to messages on a channel
+     */
+    abstract subscribe(subscription: Subscription, handler: MessageHandler): Promise<SubscriptionHandle>;
+    /**
+     * Unsubscribe from a channel
+     */
+    unsubscribe(handle: SubscriptionHandle): Promise<void>;
+    /**
+     * Create a new channel
+     */
+    createChannel(channel: Channel): Promise<void>;
+    /**
+     * Delete a channel
+     */
+    deleteChannel(channelName: string): Promise<void>;
+    /**
+     * Acknowledge message receipt
+     */
+    abstract acknowledge(messageId: string): Promise<void>;
+    /**
+     * Negative acknowledge (reject) a message
+     */
+    abstract nack(messageId: string, requeue?: boolean): Promise<void>;
+    /**
+     * Close the broker connection
+     */
+    abstract close(): Promise<void>;
+    /**
+     * Validate message format
+     */
+    protected validateMessage(message: Message): void;
+    /**
+     * Check if message matches subscription filter
+     */
+    protected matchesFilter(message: Message, filter?: Record<string, unknown>): boolean;
+    /**
+     * Get nested value from object using dot notation
+     */
+    protected getNestedValue(obj: Record<string, unknown>, path: string): unknown;
+    /**
+     * Create a delivery receipt
+     */
+    protected createDeliveryReceipt(message: Message, status: DeliveryReceipt['status'], error?: DeliveryReceipt['error']): DeliveryReceipt;
+    /**
+     * Check if channel matches pattern (supports wildcards)
+     */
+    protected channelMatches(channel: string, pattern: string): boolean;
+}
+/**
+ * Broker factory for creating broker instances
+ */
+export declare class BrokerFactory {
+    /**
+     * Create a message broker based on transport type
+     */
+    static create(type: 'redis' | 'memory', config: Record<string, unknown>): Promise<MessageBroker>;
+}
+//# sourceMappingURL=broker.d.ts.map

package/dist/messaging/broker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"broker.d.ts","sourceRoot":"","sources":["../../src/messaging/broker.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EACL,OAAO,EACP,aAAa,EACb,cAAc,EACd,YAAY,EACZ,kBAAkB,EAClB,OAAO,EACP,eAAe,EAChB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAE/C;;GAEG;AACH,8BAAsB,qBAAsB,YAAW,aAAa;IAClE,SAAS,CAAC,cAAc,EAAE,cAAc,CAAC;IACzC,SAAS,CAAC,aAAa,EAAE,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,kBAAkB,CAAC,CAAC,CAAC;gBAElD,cAAc,EAAE,cAAc;IAK1C;;OAEG;IACH,QAAQ,CAAC,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAElE;;OAEG;IACH,QAAQ,CAAC,SAAS,CAAC,YAAY,EAAE,YAAY,EAAE,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAEpG;;OAEG;IACG,WAAW,CAAC,MAAM,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC;IAU5D;;OAEG;IACG,aAAa,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAIpD;;OAEG;IACG,aAAa,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAKvD;;OAEG;IACH,QAAQ,CAAC,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAEtD;;OAEG;IACH,QAAQ,CAAC,IAAI,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAElE;;OAEG;IACH,QAAQ,CAAC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAE/B;;OAEG;IACH,SAAS,CAAC,eAAe,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI;IAiCjD;;OAEG;IACH,SAAS,CAAC,aAAa,CAAC,OAAO,EAAE,OAAO,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO;IAepF;;OAEG;IACH,SAAS,CAAC,cAAc,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO;IAM7E;;OAEG;IACH,SAAS,CAAC,qBAAqB,CAC7B,OAAO,EAAE,OAAO,EAChB,MAAM,EAAE,eAAe,CAAC,QAAQ,CAAC,EACjC,KAAK,CAAC,EAAE,eAAe,CAAC,OAAO,CAAC,GAC/B,eAAe;IAWlB;;OAEG;IACH,SAAS,CAAC,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO;CAUpE;AAED;;GAEG;AACH,qBAAa,aAAa;IACxB;;OAEG;WACU,MAAM,CAAC,IAAI,EAAE,OAAO,GAAG,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,aAAa,CAAC;CAcvG"}

package/dist/messaging/broker.js

@@ -0,0 +1,145 @@
+/**
+ * OSSA v0.3.1 Messaging Extension - Message Broker
+ * Core message broker interface and base implementation
+ */
+import { randomUUID } from 'crypto';
+/**
+ * Abstract base class for message brokers
+ */
+export class AbstractMessageBroker {
+    channelManager;
+    subscriptions;
+    constructor(channelManager) {
+        this.channelManager = channelManager;
+        this.subscriptions = new Map();
+    }
+    /**
+     * Unsubscribe from a channel
+     */
+    async unsubscribe(handle) {
+        const channelSubs = this.subscriptions.get(handle.channel);
+        if (channelSubs) {
+            channelSubs.delete(handle);
+            if (channelSubs.size === 0) {
+                this.subscriptions.delete(handle.channel);
+            }
+        }
+    }
+    /**
+     * Create a new channel
+     */
+    async createChannel(channel) {
+        await this.channelManager.create(channel);
+    }
+    /**
+     * Delete a channel
+     */
+    async deleteChannel(channelName) {
+        await this.channelManager.delete(channelName);
+        this.subscriptions.delete(channelName);
+    }
+    /**
+     * Validate message format
+     */
+    validateMessage(message) {
+        if (!message.id) {
+            throw new Error('Message ID is required');
+        }
+        if (!message.channel) {
+            throw new Error('Message channel is required');
+        }
+        if (!message.sender) {
+            throw new Error('Message sender is required');
+        }
+        if (!message.timestamp) {
+            throw new Error('Message timestamp is required');
+        }
+        if (!message.type) {
+            throw new Error('Message type is required');
+        }
+        if (!message.payload) {
+            throw new Error('Message payload is required');
+        }
+        // Validate channel name format (e.g., agents.test.message, agents.*.broadcast, agents.test.#)
+        const channelPattern = /^agents\.([a-z0-9-]+|\*)(\.([a-z0-9-]+|\*|#))*$/;
+        if (!channelPattern.test(message.channel)) {
+            throw new Error(`Invalid channel name: ${message.channel}`);
+        }
+        // Validate sender format
+        const senderPattern = /^ossa:\/\/agents\/[a-z0-9-]+$/;
+        if (!senderPattern.test(message.sender)) {
+            throw new Error(`Invalid sender format: ${message.sender}`);
+        }
+    }
+    /**
+     * Check if message matches subscription filter
+     */
+    matchesFilter(message, filter) {
+        if (!filter) {
+            return true;
+        }
+        for (const [key, value] of Object.entries(filter)) {
+            const messagePath = this.getNestedValue(message, key);
+            if (messagePath !== value) {
+                return false;
+            }
+        }
+        return true;
+    }
+    /**
+     * Get nested value from object using dot notation
+     */
+    getNestedValue(obj, path) {
+        return path.split('.').reduce((current, key) => {
+            return current && typeof current === 'object' ? current[key] : undefined;
+        }, obj);
+    }
+    /**
+     * Create a delivery receipt
+     */
+    createDeliveryReceipt(message, status, error) {
+        return {
+            messageId: message.id,
+            receiptId: randomUUID(),
+            status,
+            timestamp: new Date().toISOString(),
+            channel: message.channel,
+            error,
+        };
+    }
+    /**
+     * Check if channel matches pattern (supports wildcards)
+     */
+    channelMatches(channel, pattern) {
+        // Convert pattern to regex
+        const regexPattern = pattern
+            .replace(/\./g, '\\.')
+            .replace(/\*/g, '[^.]+')
+            .replace(/#/g, '.*');
+        const regex = new RegExp(`^${regexPattern}$`);
+        return regex.test(channel);
+    }
+}
+/**
+ * Broker factory for creating broker instances
+ */
+export class BrokerFactory {
+    /**
+     * Create a message broker based on transport type
+     */
+    static async create(type, config) {
+        switch (type) {
+            case 'redis': {
+                const { RedisMessageBroker } = await import('./protocols/redis.js');
+                return new RedisMessageBroker(config);
+            }
+            case 'memory': {
+                const { MemoryMessageBroker } = await import('./protocols/memory.js');
+                return new MemoryMessageBroker(config);
+            }
+            default:
+                throw new Error(`Unsupported transport type: ${type}`);
+        }
+    }
+}
+//# sourceMappingURL=broker.js.map