@llm-dev-ops/agentics-cli 1.4.27 → 1.4.29

package/dist/bundled-agents/analytics-hub-agents/src/adapters/costops.ts

@@ -1,265 +0,0 @@
-/**
- * LLM-CostOps Adapter
- *
- * Thin adapter for consuming cost summaries, projections, and token
- * accounting baselines from LLM-CostOps.
- */
-
-import { logger } from '../logger';
-import {
-  AdapterHealth,
-  EcosystemAdapter,
-  TimeRange,
-  healthyAdapter,
-  unhealthyAdapter,
-} from './types';
-
-export interface CostOpsConfig {
-  endpoint: string;
-  apiKey?: string;
-  timeoutMs?: number;
-}
-
-/**
- * Cost summary
- */
-export interface CostSummary {
-  summaryId: string;
-  periodStart: Date;
-  periodEnd: Date;
-  totalCostUsd: number;
-  breakdown: CostBreakdown;
-  topConsumers: CostConsumer[];
-  currency: string;
-}
-
-export interface CostBreakdown {
-  byProvider: Record<string, number>;
-  byModel: Record<string, number>;
-  byOperation: Record<string, number>;
-  byTeam: Record<string, number>;
-}
-
-export interface CostConsumer {
-  consumerId: string;
-  consumerType: 'user' | 'team' | 'application' | 'pipeline';
-  name: string;
-  costUsd: number;
-  percentage: number;
-}
-
-/**
- * Cost projection
- */
-export interface CostProjection {
-  projectionId: string;
-  generatedAt: Date;
-  projectionPeriod: 'daily' | 'weekly' | 'monthly' | 'quarterly';
-  projectedCostUsd: number;
-  confidenceInterval: ConfidenceInterval;
-  trend: 'increasing' | 'stable' | 'decreasing';
-  assumptions: string[];
-}
-
-export interface ConfidenceInterval {
-  lowerBound: number;
-  upperBound: number;
-  confidenceLevel: number;
-}
-
-/**
- * Token accounting baseline
- */
-export interface TokenAccountingBaseline {
-  baselineId: string;
-  createdAt: Date;
-  period: TimeRange;
-  tokenMetrics: TokenMetrics;
-  costPerToken: CostPerToken;
-  efficiencyMetrics: EfficiencyMetrics;
-}
-
-export interface TokenMetrics {
-  totalTokens: number;
-  promptTokens: number;
-  completionTokens: number;
-  cachedTokens: number;
-  byModel: Record<string, number>;
-}
-
-export interface CostPerToken {
-  averageCostPer1kTokens: number;
-  promptCostPer1k: number;
-  completionCostPer1k: number;
-  byModel: Record<string, number>;
-}
-
-export interface EfficiencyMetrics {
-  cacheHitRate: number;
-  tokensPerRequestAvg: number;
-  costPerRequestAvg: number;
-}
-
-/**
- * Budget status
- */
-export interface BudgetStatus {
-  budgetId: string;
-  teamId?: string;
-  periodBudgetUsd: number;
-  spentUsd: number;
-  remainingUsd: number;
-  utilizationPercentage: number;
-  projectedOverage?: number;
-}
-
-/**
- * Query parameters for cost summaries
- */
-export interface CostSummaryQuery {
-  startTime?: Date;
-  endTime?: Date;
-  providers?: string[];
-  models?: string[];
-  teams?: string[];
-  granularity?: 'hourly' | 'daily' | 'weekly' | 'monthly';
-}
-
-/**
- * LLM-CostOps adapter for consuming cost data
- */
-export class CostOpsAdapter implements EcosystemAdapter {
-  private config: CostOpsConfig;
-  private connected: boolean = false;
-
-  constructor(config?: Partial<CostOpsConfig>) {
-    this.config = {
-      endpoint: process.env.COSTOPS_ENDPOINT || 'http://localhost:8082',
-      apiKey: process.env.COSTOPS_API_KEY,
-      timeoutMs: parseInt(process.env.COSTOPS_TIMEOUT_MS || '30000', 10),
-      ...config,
-    };
-  }
-
-  async connect(): Promise<void> {
-    logger.info({ endpoint: this.config.endpoint }, 'Connecting to LLM-CostOps');
-    this.connected = true;
-    logger.info('Successfully connected to LLM-CostOps');
-  }
-
-  async healthCheck(): Promise<AdapterHealth> {
-    const start = Date.now();
-
-    if (!this.connected) {
-      return unhealthyAdapter('costops', 'Not connected');
-    }
-
-    const latencyMs = Date.now() - start;
-    return healthyAdapter('costops', latencyMs);
-  }
-
-  async disconnect(): Promise<void> {
-    logger.info('Disconnecting from LLM-CostOps');
-    this.connected = false;
-  }
-
-  /**
-   * Fetch cost summary
-   */
-  async fetchCostSummary(query: CostSummaryQuery): Promise<CostSummary> {
-    if (!this.connected) {
-      throw new Error('CostOps adapter not connected');
-    }
-
-    logger.debug({ query }, 'Fetching cost summary from CostOps');
-
-    // Placeholder implementation
-    return {
-      summaryId: crypto.randomUUID(),
-      periodStart: query.startTime || new Date(),
-      periodEnd: query.endTime || new Date(),
-      totalCostUsd: 0,
-      breakdown: {
-        byProvider: {},
-        byModel: {},
-        byOperation: {},
-        byTeam: {},
-      },
-      topConsumers: [],
-      currency: 'USD',
-    };
-  }
-
-  /**
-   * Fetch cost projections
-   */
-  async fetchProjections(
-    period: 'daily' | 'weekly' | 'monthly' | 'quarterly'
-  ): Promise<CostProjection[]> {
-    if (!this.connected) {
-      throw new Error('CostOps adapter not connected');
-    }
-
-    logger.debug({ period }, 'Fetching cost projections from CostOps');
-
-    // Placeholder implementation
-    return [];
-  }
-
-  /**
-   * Fetch token accounting baseline
-   */
-  async fetchTokenBaseline(timeRange: TimeRange): Promise<TokenAccountingBaseline> {
-    if (!this.connected) {
-      throw new Error('CostOps adapter not connected');
-    }
-
-    logger.debug({ timeRange }, 'Fetching token baseline from CostOps');
-
-    // Placeholder implementation
-    return {
-      baselineId: crypto.randomUUID(),
-      createdAt: new Date(),
-      period: timeRange,
-      tokenMetrics: {
-        totalTokens: 0,
-        promptTokens: 0,
-        completionTokens: 0,
-        cachedTokens: 0,
-        byModel: {},
-      },
-      costPerToken: {
-        averageCostPer1kTokens: 0,
-        promptCostPer1k: 0,
-        completionCostPer1k: 0,
-        byModel: {},
-      },
-      efficiencyMetrics: {
-        cacheHitRate: 0,
-        tokensPerRequestAvg: 0,
-        costPerRequestAvg: 0,
-      },
-    };
-  }
-
-  /**
-   * Fetch budget status
-   */
-  async fetchBudgetStatus(teamId?: string): Promise<BudgetStatus> {
-    if (!this.connected) {
-      throw new Error('CostOps adapter not connected');
-    }
-
-    logger.debug({ teamId }, 'Fetching budget status from CostOps');
-
-    // Placeholder implementation
-    return {
-      budgetId: crypto.randomUUID(),
-      teamId,
-      periodBudgetUsd: 0,
-      spentUsd: 0,
-      remainingUsd: 0,
-      utilizationPercentage: 0,
-    };
-  }
-}

package/dist/bundled-agents/analytics-hub-agents/src/adapters/index.ts

@@ -1,121 +0,0 @@
-/**
- * LLM-Dev-Ops Ecosystem Adapters
- *
- * Thin adapters for consuming data from upstream LLM-Dev-Ops modules.
- * These adapters provide read-only access to external data sources
- * without modifying existing analytics, clustering, forecasting, or statistical logic.
- *
- * Phase 2B: Runtime consumption integrations
- */
-
-export * from './observatory';
-export * from './costops';
-export * from './memory-graph';
-export * from './registry';
-export * from './config-manager';
-export * from './types';
-
-import { ObservatoryAdapter, ObservatoryConfig } from './observatory';
-import { CostOpsAdapter, CostOpsConfig } from './costops';
-import { MemoryGraphAdapter, MemoryGraphConfig } from './memory-graph';
-import { RegistryAdapter, RegistryConfig } from './registry';
-import { ConfigManagerAdapter, ConfigManagerConfig } from './config-manager';
-import { AdapterHealth } from './types';
-import { logger } from '../logger';
-
-/**
- * Unified adapter manager for all ecosystem integrations
- */
-export class AdapterManager {
-  public readonly observatory: ObservatoryAdapter;
-  public readonly costops: CostOpsAdapter;
-  public readonly memoryGraph: MemoryGraphAdapter;
-  public readonly registry: RegistryAdapter;
-  public readonly configManager: ConfigManagerAdapter;
-
-  constructor(config?: {
-    observatory?: Partial<ObservatoryConfig>;
-    costops?: Partial<CostOpsConfig>;
-    memoryGraph?: Partial<MemoryGraphConfig>;
-    registry?: Partial<RegistryConfig>;
-    configManager?: Partial<ConfigManagerConfig>;
-  }) {
-    this.observatory = new ObservatoryAdapter(config?.observatory);
-    this.costops = new CostOpsAdapter(config?.costops);
-    this.memoryGraph = new MemoryGraphAdapter(config?.memoryGraph);
-    this.registry = new RegistryAdapter(config?.registry);
-    this.configManager = new ConfigManagerAdapter(config?.configManager);
-  }
-
-  /**
-   * Connect all adapters
-   */
-  async connectAll(): Promise<void> {
-    logger.info('Connecting all ecosystem adapters...');
-
-    await Promise.all([
-      this.observatory.connect(),
-      this.costops.connect(),
-      this.memoryGraph.connect(),
-      this.registry.connect(),
-      this.configManager.connect(),
-    ]);
-
-    logger.info('All ecosystem adapters connected successfully');
-  }
-
-  /**
-   * Check health of all adapters
-   */
-  async healthCheckAll(): Promise<AdapterHealth[]> {
-    const results = await Promise.all([
-      this.observatory.healthCheck(),
-      this.costops.healthCheck(),
-      this.memoryGraph.healthCheck(),
-      this.registry.healthCheck(),
-      this.configManager.healthCheck(),
-    ]);
-
-    return results;
-  }
-
-  /**
-   * Disconnect all adapters
-   */
-  async disconnectAll(): Promise<void> {
-    logger.info('Disconnecting all ecosystem adapters...');
-
-    await Promise.all([
-      this.observatory.disconnect(),
-      this.costops.disconnect(),
-      this.memoryGraph.disconnect(),
-      this.registry.disconnect(),
-      this.configManager.disconnect(),
-    ]);
-
-    logger.info('All ecosystem adapters disconnected');
-  }
-}
-
-// Singleton instance
-let adapterManagerInstance: AdapterManager | null = null;
-
-/**
- * Initialize the adapter manager
- */
-export function initAdapterManager(config?: ConstructorParameters<typeof AdapterManager>[0]): AdapterManager {
-  if (!adapterManagerInstance) {
-    adapterManagerInstance = new AdapterManager(config);
-  }
-  return adapterManagerInstance;
-}
-
-/**
- * Get the adapter manager instance
- */
-export function getAdapterManager(): AdapterManager {
-  if (!adapterManagerInstance) {
-    throw new Error('AdapterManager not initialized. Call initAdapterManager() first.');
-  }
-  return adapterManagerInstance;
-}

package/dist/bundled-agents/analytics-hub-agents/src/adapters/memory-graph.ts

@@ -1,314 +0,0 @@
-/**
- * LLM-Memory-Graph Adapter
- *
- * Thin adapter for consuming context lineage and graph-based interaction
- * metadata from LLM-Memory-Graph.
- */
-
-import { logger } from '../logger';
-import {
-  AdapterHealth,
-  EcosystemAdapter,
-  TimeRange,
-  healthyAdapter,
-  unhealthyAdapter,
-} from './types';
-
-export interface MemoryGraphConfig {
-  endpoint: string;
-  apiKey?: string;
-  timeoutMs?: number;
-}
-
-/**
- * Context lineage
- */
-export interface ContextLineage {
-  lineageId: string;
-  rootContextId: string;
-  createdAt: Date;
-  depth: number;
-  nodes: LineageNode[];
-  edges: LineageEdge[];
-  metadata: LineageMetadata;
-}
-
-export interface LineageNode {
-  nodeId: string;
-  nodeType: 'user_message' | 'assistant_response' | 'system_prompt' | 'tool_call' | 'tool_result' | 'context_injection' | 'summary';
-  createdAt: Date;
-  contentHash: string;
-  tokenCount: number;
-  attributes: Record<string, unknown>;
-}
-
-export interface LineageEdge {
-  edgeId: string;
-  sourceNodeId: string;
-  targetNodeId: string;
-  edgeType: 'follows' | 'references' | 'summarizes' | 'derived_from' | 'tool_invocation';
-  weight: number;
-  createdAt: Date;
-}
-
-export interface LineageMetadata {
-  totalTokens: number;
-  totalInteractions: number;
-  activeBranches: number;
-  compressionRatio: number;
-}
-
-/**
- * Interaction graph
- */
-export interface InteractionGraph {
-  graphId: string;
-  sessionId: string;
-  createdAt: Date;
-  lastUpdated: Date;
-  statistics: GraphStatistics;
-  topics: TopicCluster[];
-  entities: EntityReference[];
-}
-
-export interface GraphStatistics {
-  nodeCount: number;
-  edgeCount: number;
-  avgDegree: number;
-  clusteringCoefficient: number;
-  diameter: number;
-  density: number;
-}
-
-export interface TopicCluster {
-  clusterId: string;
-  topic: string;
-  relevanceScore: number;
-  nodeIds: string[];
-  keywords: string[];
-}
-
-export interface EntityReference {
-  entityId: string;
-  entityType: string;
-  name: string;
-  firstMentioned: Date;
-  mentionCount: number;
-  nodeIds: string[];
-}
-
-/**
- * Memory snapshot
- */
-export interface MemorySnapshot {
-  snapshotId: string;
-  sessionId: string;
-  createdAt: Date;
-  contextWindowTokens: number;
-  summarizedTokens: number;
-  activeMemories: ActiveMemory[];
-  retrievalStats: RetrievalStats;
-}
-
-export interface ActiveMemory {
-  memoryId: string;
-  memoryType: 'short_term' | 'long_term' | 'working' | 'episodic' | 'semantic';
-  contentPreview: string;
-  tokenCount: number;
-  relevanceScore: number;
-  lastAccessed: Date;
-  accessCount: number;
-}
-
-export interface RetrievalStats {
-  totalRetrievals: number;
-  avgLatencyMs: number;
-  cacheHitRate: number;
-  relevanceAvg: number;
-}
-
-/**
- * Graph analytics
- */
-export interface GraphAnalytics {
-  periodStart: Date;
-  periodEnd: Date;
-  totalSessions: number;
-  totalNodesCreated: number;
-  totalEdgesCreated: number;
-  avgSessionDepth: number;
-  avgSessionTokens: number;
-  topTopics: string[];
-  memoryEfficiency: MemoryEfficiency;
-}
-
-export interface MemoryEfficiency {
-  avgCompressionRatio: number;
-  cacheHitRate: number;
-  retrievalLatencyP50Ms: number;
-  retrievalLatencyP99Ms: number;
-}
-
-/**
- * Query parameters for lineage
- */
-export interface LineageQuery {
-  contextId?: string;
-  sessionId?: string;
-  startTime?: Date;
-  endTime?: Date;
-  minDepth?: number;
-  maxDepth?: number;
-  includeContent?: boolean;
-}
-
-/**
- * LLM-Memory-Graph adapter for consuming graph data
- */
-export class MemoryGraphAdapter implements EcosystemAdapter {
-  private config: MemoryGraphConfig;
-  private connected: boolean = false;
-
-  constructor(config?: Partial<MemoryGraphConfig>) {
-    this.config = {
-      endpoint: process.env.MEMORY_GRAPH_ENDPOINT || 'http://localhost:8083',
-      apiKey: process.env.MEMORY_GRAPH_API_KEY,
-      timeoutMs: parseInt(process.env.MEMORY_GRAPH_TIMEOUT_MS || '30000', 10),
-      ...config,
-    };
-  }
-
-  async connect(): Promise<void> {
-    logger.info({ endpoint: this.config.endpoint }, 'Connecting to LLM-Memory-Graph');
-    this.connected = true;
-    logger.info('Successfully connected to LLM-Memory-Graph');
-  }
-
-  async healthCheck(): Promise<AdapterHealth> {
-    const start = Date.now();
-
-    if (!this.connected) {
-      return unhealthyAdapter('memory_graph', 'Not connected');
-    }
-
-    const latencyMs = Date.now() - start;
-    return healthyAdapter('memory_graph', latencyMs);
-  }
-
-  async disconnect(): Promise<void> {
-    logger.info('Disconnecting from LLM-Memory-Graph');
-    this.connected = false;
-  }
-
-  /**
-   * Fetch context lineage
-   */
-  async fetchContextLineage(query: LineageQuery): Promise<ContextLineage> {
-    if (!this.connected) {
-      throw new Error('Memory-Graph adapter not connected');
-    }
-
-    logger.debug({ query }, 'Fetching context lineage from Memory-Graph');
-
-    // Placeholder implementation
-    return {
-      lineageId: crypto.randomUUID(),
-      rootContextId: query.contextId || 'root',
-      createdAt: new Date(),
-      depth: 0,
-      nodes: [],
-      edges: [],
-      metadata: {
-        totalTokens: 0,
-        totalInteractions: 0,
-        activeBranches: 0,
-        compressionRatio: 1.0,
-      },
-    };
-  }
-
-  /**
-   * Fetch interaction graph
-   */
-  async fetchInteractionGraph(sessionId: string): Promise<InteractionGraph> {
-    if (!this.connected) {
-      throw new Error('Memory-Graph adapter not connected');
-    }
-
-    logger.debug({ sessionId }, 'Fetching interaction graph from Memory-Graph');
-
-    // Placeholder implementation
-    return {
-      graphId: crypto.randomUUID(),
-      sessionId,
-      createdAt: new Date(),
-      lastUpdated: new Date(),
-      statistics: {
-        nodeCount: 0,
-        edgeCount: 0,
-        avgDegree: 0,
-        clusteringCoefficient: 0,
-        diameter: 0,
-        density: 0,
-      },
-      topics: [],
-      entities: [],
-    };
-  }
-
-  /**
-   * Fetch memory snapshot
-   */
-  async fetchMemorySnapshot(sessionId: string): Promise<MemorySnapshot> {
-    if (!this.connected) {
-      throw new Error('Memory-Graph adapter not connected');
-    }
-
-    logger.debug({ sessionId }, 'Fetching memory snapshot from Memory-Graph');
-
-    // Placeholder implementation
-    return {
-      snapshotId: crypto.randomUUID(),
-      sessionId,
-      createdAt: new Date(),
-      contextWindowTokens: 0,
-      summarizedTokens: 0,
-      activeMemories: [],
-      retrievalStats: {
-        totalRetrievals: 0,
-        avgLatencyMs: 0,
-        cacheHitRate: 0,
-        relevanceAvg: 0,
-      },
-    };
-  }
-
-  /**
-   * Fetch graph analytics
-   */
-  async fetchGraphAnalytics(timeRange: TimeRange): Promise<GraphAnalytics> {
-    if (!this.connected) {
-      throw new Error('Memory-Graph adapter not connected');
-    }
-
-    logger.debug({ timeRange }, 'Fetching graph analytics from Memory-Graph');
-
-    // Placeholder implementation
-    return {
-      periodStart: timeRange.start,
-      periodEnd: timeRange.end,
-      totalSessions: 0,
-      totalNodesCreated: 0,
-      totalEdgesCreated: 0,
-      avgSessionDepth: 0,
-      avgSessionTokens: 0,
-      topTopics: [],
-      memoryEfficiency: {
-        avgCompressionRatio: 0,
-        cacheHitRate: 0,
-        retrievalLatencyP50Ms: 0,
-        retrievalLatencyP99Ms: 0,
-      },
-    };
-  }
-}