@bluefly/openstandardagents 0.2.9 → 0.3.0

package/dist/services/messaging/messaging.types.d.ts

@@ -0,0 +1,319 @@
+/**
+ * OSSA Messaging Runtime - Type Definitions
+ * Production-quality types for agent-to-agent messaging
+ *
+ * @fileoverview Core types for pub/sub messaging, message routing, and delivery guarantees
+ * @module @ossa/messaging/types
+ */
+import { MessageEnvelope, PublishedChannel, Subscription, Command, ReliabilityConfig } from '../../types/messaging.js';
+/**
+ * Re-export core types from messaging.ts
+ */
+export { MessageEnvelope, PublishedChannel, Subscription, Command, ReliabilityConfig, };
+/**
+ * Delivery guarantee levels for message routing
+ */
+export declare enum DeliveryGuarantee {
+    /** Message delivered zero or one time (best-effort, fire-and-forget) */
+    AT_MOST_ONCE = "at-most-once",
+    /** Message delivered one or more times (retry until acknowledged) */
+    AT_LEAST_ONCE = "at-least-once",
+    /** Message delivered exactly once (idempotent delivery with deduplication) */
+    EXACTLY_ONCE = "exactly-once"
+}
+/**
+ * Message priority levels
+ */
+export declare enum MessagePriority {
+    LOW = "low",
+    NORMAL = "normal",
+    HIGH = "high",
+    CRITICAL = "critical"
+}
+/**
+ * Message acknowledgment modes
+ */
+export declare enum AcknowledgmentMode {
+    /** Handler must manually acknowledge messages */
+    MANUAL = "manual",
+    /** Messages automatically acknowledged on successful return */
+    AUTOMATIC = "automatic"
+}
+/**
+ * Backoff strategies for retry logic
+ */
+export declare enum BackoffStrategy {
+    /** Fixed delay between retries */
+    CONSTANT = "constant",
+    /** Linearly increasing delay */
+    LINEAR = "linear",
+    /** Exponentially increasing delay */
+    EXPONENTIAL = "exponential"
+}
+/**
+ * Message processing state
+ */
+export declare enum MessageState {
+    /** Message pending delivery */
+    PENDING = "pending",
+    /** Message currently being processed */
+    PROCESSING = "processing",
+    /** Message successfully delivered and acknowledged */
+    ACKNOWLEDGED = "acknowledged",
+    /** Message delivery failed and moved to dead letter queue */
+    DEAD_LETTERED = "dead-lettered",
+    /** Message expired before delivery */
+    EXPIRED = "expired"
+}
+/**
+ * Channel metadata and configuration
+ */
+export interface Channel {
+    /** Channel name (dot-separated namespace: e.g., 'security.vulnerabilities') */
+    name: string;
+    /** Human-readable description */
+    description?: string;
+    /** JSON Schema for message validation */
+    schema?: Record<string, unknown>;
+    /** Message content type */
+    contentType?: string;
+    /** Tags for categorization */
+    tags?: string[];
+    /** Number of active subscriptions */
+    subscriptionCount: number;
+    /** Message retention policy (ISO 8601 duration) */
+    retentionPeriod?: string;
+    /** Created timestamp */
+    createdAt: Date;
+    /** Last message timestamp */
+    lastMessageAt?: Date;
+    /** Total messages published */
+    messageCount: number;
+}
+/**
+ * Active subscription with runtime state
+ */
+export interface ActiveSubscription extends Subscription {
+    /** Unique subscription ID */
+    id: string;
+    /** Agent that owns this subscription */
+    agentId: string;
+    /** Message handler function */
+    handlerFn: MessageHandler;
+    /** Subscription created timestamp */
+    createdAt: Date;
+    /** Currently processing messages count */
+    activeMessages: number;
+    /** Total messages processed */
+    processedCount: number;
+    /** Failed message count */
+    errorCount: number;
+    /** Last message processing timestamp */
+    lastProcessedAt?: Date;
+    /** Subscription enabled state */
+    enabled: boolean;
+}
+/**
+ * Message handler function signature
+ */
+export type MessageHandler = (message: MessageEnvelope) => Promise<void> | void;
+/**
+ * Message acknowledgment result
+ */
+export interface MessageAcknowledgment {
+    /** Message ID being acknowledged */
+    messageId: string;
+    /** Whether message was successfully processed */
+    success: boolean;
+    /** Optional error if processing failed */
+    error?: Error;
+    /** Timestamp of acknowledgment */
+    timestamp: Date;
+    /** Processing duration in milliseconds */
+    durationMs: number;
+}
+/**
+ * Subscription filter for message routing
+ */
+export interface SubscriptionFilter {
+    /** Filter expression (e.g., JSONPath or custom DSL) */
+    expression?: string;
+    /** Field-based equality filters */
+    fields?: Record<string, unknown>;
+    /** Compiled filter function (internal use) */
+    evaluateFn?: (message: MessageEnvelope) => boolean;
+}
+/**
+ * Message broker adapter interface
+ * Implementations: in-memory, Redis, Kafka, RabbitMQ, etc.
+ */
+export interface MessageBroker {
+    /**
+     * Initialize the broker
+     */
+    connect(): Promise<void>;
+    /**
+     * Shutdown the broker gracefully
+     */
+    disconnect(): Promise<void>;
+    /**
+     * Publish a message to a channel
+     */
+    publish(channel: string, message: MessageEnvelope): Promise<void>;
+    /**
+     * Subscribe to a channel
+     */
+    subscribe(channel: string, handler: MessageHandler, options?: SubscriptionOptions): Promise<string>;
+    /**
+     * Unsubscribe from a channel
+     */
+    unsubscribe(subscriptionId: string): Promise<void>;
+    /**
+     * Acknowledge message processing
+     */
+    acknowledge(messageId: string, success: boolean): Promise<void>;
+    /**
+     * Get broker health status
+     */
+    getHealth(): Promise<BrokerHealth>;
+    /**
+     * Get channel statistics
+     */
+    getChannelStats(channel: string): Promise<ChannelStats>;
+}
+/**
+ * Subscription options for broker
+ */
+export interface SubscriptionOptions {
+    /** Message filter */
+    filter?: SubscriptionFilter;
+    /** Message priority */
+    priority?: MessagePriority;
+    /** Maximum concurrent message processing */
+    maxConcurrency?: number;
+    /** Acknowledgment mode */
+    acknowledgmentMode?: AcknowledgmentMode;
+    /** Message prefetch count */
+    prefetchCount?: number;
+    /** Subscription group for competing consumers */
+    consumerGroup?: string;
+}
+/**
+ * Broker health status
+ */
+export interface BrokerHealth {
+    /** Overall health status */
+    status: 'healthy' | 'degraded' | 'unhealthy';
+    /** Number of active connections */
+    connections: number;
+    /** Number of active channels */
+    channels: number;
+    /** Number of active subscriptions */
+    subscriptions: number;
+    /** Pending messages count */
+    pendingMessages: number;
+    /** Uptime in milliseconds */
+    uptimeMs: number;
+    /** Last health check timestamp */
+    timestamp: Date;
+    /** Optional error details */
+    error?: string;
+}
+/**
+ * Channel statistics
+ */
+export interface ChannelStats {
+    /** Channel name */
+    channel: string;
+    /** Total messages published */
+    messagesPublished: number;
+    /** Total messages consumed */
+    messagesConsumed: number;
+    /** Pending messages in queue */
+    messagesPending: number;
+    /** Failed deliveries */
+    messagesFailed: number;
+    /** Active subscriptions */
+    subscriptions: number;
+    /** Average message size in bytes */
+    avgMessageSizeBytes: number;
+    /** Messages per second (last minute) */
+    messagesPerSecond: number;
+    /** Last activity timestamp */
+    lastActivityAt?: Date;
+}
+/**
+ * Message routing context
+ */
+export interface RoutingContext {
+    /** Source agent ID */
+    sourceAgentId: string;
+    /** Target channel */
+    channel: string;
+    /** Delivery guarantee */
+    deliveryGuarantee: DeliveryGuarantee;
+    /** Reliability configuration */
+    reliability?: ReliabilityConfig;
+    /** Trace context for distributed tracing */
+    traceContext?: {
+        traceId: string;
+        spanId: string;
+        parentSpanId?: string;
+    };
+}
+/**
+ * Dead letter queue entry
+ */
+export interface DeadLetterEntry {
+    /** Original message */
+    message: MessageEnvelope;
+    /** Reason for dead lettering */
+    reason: string;
+    /** Number of retry attempts */
+    retryCount: number;
+    /** Last error */
+    lastError?: string;
+    /** Dead lettered timestamp */
+    deadLetteredAt: Date;
+    /** Expiry timestamp */
+    expiresAt: Date;
+}
+/**
+ * Message metrics for observability
+ */
+export interface MessageMetrics {
+    /** Total messages published */
+    published: number;
+    /** Total messages delivered */
+    delivered: number;
+    /** Total messages failed */
+    failed: number;
+    /** Total messages dead lettered */
+    deadLettered: number;
+    /** Average delivery latency in milliseconds */
+    avgLatencyMs: number;
+    /** 95th percentile latency */
+    p95LatencyMs: number;
+    /** 99th percentile latency */
+    p99LatencyMs: number;
+    /** Messages per second */
+    throughput: number;
+    /** Metrics time window */
+    windowMs: number;
+    /** Timestamp of metrics collection */
+    timestamp: Date;
+}
+/**
+ * Message validation result
+ */
+export interface ValidationResult {
+    /** Whether message is valid */
+    valid: boolean;
+    /** Validation errors if invalid */
+    errors?: Array<{
+        path: string;
+        message: string;
+        code: string;
+    }>;
+}
+//# sourceMappingURL=messaging.types.d.ts.map

package/dist/services/messaging/messaging.types.d.ts.map

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

package/dist/services/messaging/messaging.types.js

@@ -0,0 +1,68 @@
+/**
+ * OSSA Messaging Runtime - Type Definitions
+ * Production-quality types for agent-to-agent messaging
+ *
+ * @fileoverview Core types for pub/sub messaging, message routing, and delivery guarantees
+ * @module @ossa/messaging/types
+ */
+/**
+ * Delivery guarantee levels for message routing
+ */
+export var DeliveryGuarantee;
+(function (DeliveryGuarantee) {
+    /** Message delivered zero or one time (best-effort, fire-and-forget) */
+    DeliveryGuarantee["AT_MOST_ONCE"] = "at-most-once";
+    /** Message delivered one or more times (retry until acknowledged) */
+    DeliveryGuarantee["AT_LEAST_ONCE"] = "at-least-once";
+    /** Message delivered exactly once (idempotent delivery with deduplication) */
+    DeliveryGuarantee["EXACTLY_ONCE"] = "exactly-once";
+})(DeliveryGuarantee || (DeliveryGuarantee = {}));
+/**
+ * Message priority levels
+ */
+export var MessagePriority;
+(function (MessagePriority) {
+    MessagePriority["LOW"] = "low";
+    MessagePriority["NORMAL"] = "normal";
+    MessagePriority["HIGH"] = "high";
+    MessagePriority["CRITICAL"] = "critical";
+})(MessagePriority || (MessagePriority = {}));
+/**
+ * Message acknowledgment modes
+ */
+export var AcknowledgmentMode;
+(function (AcknowledgmentMode) {
+    /** Handler must manually acknowledge messages */
+    AcknowledgmentMode["MANUAL"] = "manual";
+    /** Messages automatically acknowledged on successful return */
+    AcknowledgmentMode["AUTOMATIC"] = "automatic";
+})(AcknowledgmentMode || (AcknowledgmentMode = {}));
+/**
+ * Backoff strategies for retry logic
+ */
+export var BackoffStrategy;
+(function (BackoffStrategy) {
+    /** Fixed delay between retries */
+    BackoffStrategy["CONSTANT"] = "constant";
+    /** Linearly increasing delay */
+    BackoffStrategy["LINEAR"] = "linear";
+    /** Exponentially increasing delay */
+    BackoffStrategy["EXPONENTIAL"] = "exponential";
+})(BackoffStrategy || (BackoffStrategy = {}));
+/**
+ * Message processing state
+ */
+export var MessageState;
+(function (MessageState) {
+    /** Message pending delivery */
+    MessageState["PENDING"] = "pending";
+    /** Message currently being processed */
+    MessageState["PROCESSING"] = "processing";
+    /** Message successfully delivered and acknowledged */
+    MessageState["ACKNOWLEDGED"] = "acknowledged";
+    /** Message delivery failed and moved to dead letter queue */
+    MessageState["DEAD_LETTERED"] = "dead-lettered";
+    /** Message expired before delivery */
+    MessageState["EXPIRED"] = "expired";
+})(MessageState || (MessageState = {}));
+//# sourceMappingURL=messaging.types.js.map

package/dist/services/messaging/messaging.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"messaging.types.js","sourceRoot":"","sources":["../../../src/services/messaging/messaging.types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAqBH;;GAEG;AACH,MAAM,CAAN,IAAY,iBAOX;AAPD,WAAY,iBAAiB;IAC3B,wEAAwE;IACxE,kDAA6B,CAAA;IAC7B,qEAAqE;IACrE,oDAA+B,CAAA;IAC/B,8EAA8E;IAC9E,kDAA6B,CAAA;AAC/B,CAAC,EAPW,iBAAiB,KAAjB,iBAAiB,QAO5B;AAED;;GAEG;AACH,MAAM,CAAN,IAAY,eAKX;AALD,WAAY,eAAe;IACzB,8BAAW,CAAA;IACX,oCAAiB,CAAA;IACjB,gCAAa,CAAA;IACb,wCAAqB,CAAA;AACvB,CAAC,EALW,eAAe,KAAf,eAAe,QAK1B;AAED;;GAEG;AACH,MAAM,CAAN,IAAY,kBAKX;AALD,WAAY,kBAAkB;IAC5B,iDAAiD;IACjD,uCAAiB,CAAA;IACjB,+DAA+D;IAC/D,6CAAuB,CAAA;AACzB,CAAC,EALW,kBAAkB,KAAlB,kBAAkB,QAK7B;AAED;;GAEG;AACH,MAAM,CAAN,IAAY,eAOX;AAPD,WAAY,eAAe;IACzB,kCAAkC;IAClC,wCAAqB,CAAA;IACrB,gCAAgC;IAChC,oCAAiB,CAAA;IACjB,qCAAqC;IACrC,8CAA2B,CAAA;AAC7B,CAAC,EAPW,eAAe,KAAf,eAAe,QAO1B;AAED;;GAEG;AACH,MAAM,CAAN,IAAY,YAWX;AAXD,WAAY,YAAY;IACtB,+BAA+B;IAC/B,mCAAmB,CAAA;IACnB,wCAAwC;IACxC,yCAAyB,CAAA;IACzB,sDAAsD;IACtD,6CAA6B,CAAA;IAC7B,6DAA6D;IAC7D,+CAA+B,CAAA;IAC/B,sCAAsC;IACtC,mCAAmB,CAAA;AACrB,CAAC,EAXW,YAAY,KAAZ,YAAY,QAWvB"}

package/dist/services/migration.service.d.ts

@@ -1,17 +1,58 @@
 /**
  * Migration Service
  * Migrates OSSA manifests from legacy formats to current k8s-style format (apiVersion/kind/metadata/spec)
- * The target format is compatible with all v0.2.x schema versions
+ *
+ * Supported migrations:
+ * - ossaVersion: "1.0" (legacy) → current apiVersion
+ * - Any older ossa/v0.x.x → current apiVersion
+ *
+ * Features added during migration:
+ * - Runtime-configurable LLM models via environment variables
+ * - Fallback models for multi-provider resilience
+ * - Cost tracking with budget alerts
+ * - Retry configuration with exponential backoff
+ * - Safety configuration (content filtering, guardrails)
+ * - Observability (tracing, metrics, logging)
+ *
+ * IMPORTANT: Version numbers are NEVER hardcoded. All versions are derived
+ * dynamically from package.json via getVersionInfo().
  */
 import type { OssaAgent, SchemaVersion } from '../types/index.js';
+/**
+ * Migration changes summary for user feedback
+ */
+export interface MigrationSummary {
+    sourceVersion: string;
+    targetVersion: string;
+    changes: string[];
+    addedFeatures: string[];
+    warnings: string[];
+}
 export declare class MigrationService {
     /**
-     * Migrate manifest to target version
+     * Get the current target apiVersion dynamically from package.json
+     */
+    private getCurrentApiVersion;
+    /**
+     * Migrate manifest to target version (current version from package.json)
      * @param manifest - Source manifest
-     * @param targetVersion - Target version
+     * @param targetVersion - Target version (defaults to 'current' which reads from package.json)
      * @returns Migrated manifest
      */
     migrate(manifest: unknown, _targetVersion?: SchemaVersion): Promise<OssaAgent>;
+    /**
+     * Migrate any older k8s-style manifest to current version
+     * Adds new features while preserving existing configuration
+     */
+    private migrateToCurrentVersion;
+    /**
+     * Get migration summary for user feedback
+     */
+    getMigrationSummary(source: unknown, migrated: OssaAgent): MigrationSummary;
+    /**
+     * Get the source version of a manifest
+     */
+    getSourceVersion(manifest: unknown): string;
     /**
      * Migrate legacy v1.0 manifest to k8s-style format
      */
@@ -24,7 +65,7 @@ export declare class MigrationService {
      */
     migrateMany(manifests: unknown[], targetVersion?: SchemaVersion): Promise<OssaAgent[]>;
     /**
-     * Check if manifest needs migration
+     * Check if manifest needs migration to current version
      */
     needsMigration(manifest: unknown): boolean;
 }

package/dist/services/migration.service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"migration.service.d.ts","sourceRoot":"","sources":["../../src/services/migration.service.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAgClE,qBACa,gBAAgB;IAC3B;;;;;OAKG;IACG,OAAO,CACX,QAAQ,EAAE,OAAO,EACjB,cAAc,GAAE,aAAyB,GACxC,OAAO,CAAC,SAAS,CAAC;IAsBrB;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAoN5B,OAAO,CAAC,YAAY;IAepB,OAAO,CAAC,eAAe;IASvB,OAAO,CAAC,gBAAgB;IASxB;;OAEG;IACG,WAAW,CACf,SAAS,EAAE,OAAO,EAAE,EACpB,aAAa,GAAE,aAAyB,GACvC,OAAO,CAAC,SAAS,EAAE,CAAC;IAIvB;;OAEG;IACH,cAAc,CAAC,QAAQ,EAAE,OAAO,GAAG,OAAO;CAI3C"}
+{"version":3,"file":"migration.service.d.ts","sourceRoot":"","sources":["../../src/services/migration.service.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAGH,OAAO,KAAK,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAGlE;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAgCD,qBACa,gBAAgB;IAC3B;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAK5B;;;;;OAKG;IACG,OAAO,CAAC,QAAQ,EAAE,OAAO,EAAE,cAAc,GAAE,aAAyB,GAAG,OAAO,CAAC,SAAS,CAAC;IAiC/F;;;OAGG;IACH,OAAO,CAAC,uBAAuB;IA8H/B;;OAEG;IACH,mBAAmB,CAAC,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,SAAS,GAAG,gBAAgB;IA6D3E;;OAEG;IACH,gBAAgB,CAAC,QAAQ,EAAE,OAAO,GAAG,MAAM;IAc3C;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAqM5B,OAAO,CAAC,YAAY;IAWpB,OAAO,CAAC,eAAe;IAQvB,OAAO,CAAC,gBAAgB;IASxB;;OAEG;IACG,WAAW,CACf,SAAS,EAAE,OAAO,EAAE,EACpB,aAAa,GAAE,aAAyB,GACvC,OAAO,CAAC,SAAS,EAAE,CAAC;IAIvB;;OAEG;IACH,cAAc,CAAC,QAAQ,EAAE,OAAO,GAAG,OAAO;CAqB3C"}