@vorionsys/platform-core 0.1.0

package/dist/observability/logging.js

@@ -0,0 +1,260 @@
+/**
+ * Structured Logging Service
+ *
+ * Provides structured logging with automatic trace context injection,
+ * log levels, and consistent formatting for observability.
+ *
+ * @packageDocumentation
+ */
+import { pino } from 'pino';
+import { trace } from '@opentelemetry/api';
+// ============================================================================
+// Default Configuration
+// ============================================================================
+const DEFAULT_CONFIG = {
+    level: 'info',
+    pretty: process.env.NODE_ENV !== 'production',
+    includeTraceContext: true,
+    redact: ['password', 'apiKey', 'secret', 'token', 'authorization'],
+    serviceName: 'vorion',
+};
+// ============================================================================
+// Trace Context Extraction
+// ============================================================================
+/**
+ * Extract trace context from current OpenTelemetry context
+ */
+function extractTraceContext() {
+    const activeSpan = trace.getActiveSpan();
+    if (!activeSpan) {
+        return {};
+    }
+    const spanContext = activeSpan.spanContext();
+    if (!spanContext || !trace.isSpanContextValid(spanContext)) {
+        return {};
+    }
+    return {
+        traceId: spanContext.traceId,
+        spanId: spanContext.spanId,
+    };
+}
+// ============================================================================
+// Structured Logger Implementation
+// ============================================================================
+class StructuredLoggerImpl {
+    logger;
+    config;
+    bindings;
+    constructor(config, bindings = {}) {
+        this.config = config;
+        this.bindings = bindings;
+        const pinoConfig = {
+            level: config.level,
+            redact: config.redact,
+            base: {
+                service: config.serviceName,
+                ...bindings,
+            },
+            formatters: {
+                level: (label) => ({ level: label }),
+                bindings: (bindings) => bindings,
+            },
+            timestamp: pino.stdTimeFunctions.isoTime,
+        };
+        if (config.pretty) {
+            this.logger = pino({
+                ...pinoConfig,
+                transport: {
+                    target: 'pino-pretty',
+                    options: {
+                        colorize: true,
+                        translateTime: 'SYS:standard',
+                        ignore: 'pid,hostname',
+                    },
+                },
+            });
+        }
+        else {
+            this.logger = pino(pinoConfig);
+        }
+    }
+    enrichContext(ctx) {
+        const enriched = { ...ctx };
+        // Add trace context if enabled and not already present
+        if (this.config.includeTraceContext && !ctx.traceId) {
+            const traceCtx = extractTraceContext();
+            if (traceCtx.traceId) {
+                enriched.traceId = traceCtx.traceId;
+                enriched.spanId = traceCtx.spanId;
+            }
+        }
+        return enriched;
+    }
+    trace(ctx, msg) {
+        this.logger.trace(this.enrichContext(ctx), msg);
+    }
+    debug(ctx, msg) {
+        this.logger.debug(this.enrichContext(ctx), msg);
+    }
+    info(ctx, msg) {
+        this.logger.info(this.enrichContext(ctx), msg);
+    }
+    warn(ctx, msg) {
+        this.logger.warn(this.enrichContext(ctx), msg);
+    }
+    error(ctx, msg) {
+        this.logger.error(this.enrichContext(ctx), msg);
+    }
+    fatal(ctx, msg) {
+        this.logger.fatal(this.enrichContext(ctx), msg);
+    }
+    child(bindings) {
+        return new StructuredLoggerImpl(this.config, { ...this.bindings, ...bindings });
+    }
+}
+// ============================================================================
+// Factory Functions
+// ============================================================================
+let globalLogger = null;
+let globalConfig = DEFAULT_CONFIG;
+/**
+ * Initialize logging with configuration
+ */
+export function initLogging(config = {}) {
+    globalConfig = { ...DEFAULT_CONFIG, ...config };
+    globalLogger = new StructuredLoggerImpl(globalConfig);
+    return globalLogger;
+}
+/**
+ * Get the global logger instance
+ */
+export function getLogger() {
+    if (!globalLogger) {
+        globalLogger = new StructuredLoggerImpl(globalConfig);
+    }
+    return globalLogger;
+}
+/**
+ * Create a component-scoped logger
+ */
+export function createComponentLogger(component) {
+    const base = getLogger();
+    return base.child({ component });
+}
+// ============================================================================
+// Specialized Loggers
+// ============================================================================
+/**
+ * Create an Agent Anchor logger with CAR context
+ */
+export function createAgentLogger(carId, tenantId) {
+    return getLogger().child({ carId, tenantId, component: 'agent-anchor' });
+}
+/**
+ * Create an A2A logger with call chain context
+ */
+export function createA2ALogger(requestId, callerCarId, calleeCarId) {
+    return getLogger().child({
+        requestId,
+        callerCarId,
+        calleeCarId,
+        component: 'a2a',
+    });
+}
+/**
+ * Create a sandbox logger with container context
+ */
+export function createSandboxLogger(containerId, carId, tier) {
+    return getLogger().child({
+        containerId,
+        carId,
+        tier,
+        component: 'sandbox',
+    });
+}
+// ============================================================================
+// Log Helpers
+// ============================================================================
+/**
+ * Log an agent lifecycle event
+ */
+export function logAgentEvent(logger, event, carId, details) {
+    logger.info({ event: `agent.${event}`, carId, ...details }, `Agent ${event}: ${carId}`);
+}
+/**
+ * Log a trust score change
+ */
+export function logTrustChange(logger, carId, oldScore, newScore, oldTier, newTier, reason) {
+    const tierChanged = oldTier !== newTier;
+    const ctx = {
+        event: tierChanged ? 'trust.tier_change' : 'trust.score_change',
+        carId,
+        oldScore,
+        newScore,
+        oldTier,
+        newTier,
+        reason,
+    };
+    if (tierChanged) {
+        logger.info(ctx, `Trust tier changed: ${carId} T${oldTier} -> T${newTier}`);
+    }
+    else {
+        logger.debug(ctx, `Trust score updated: ${carId} ${oldScore} -> ${newScore}`);
+    }
+}
+/**
+ * Log an A2A invocation
+ */
+export function logA2AInvocation(logger, phase, callerCarId, calleeCarId, action, details) {
+    const ctx = {
+        event: `a2a.invoke.${phase}`,
+        callerCarId,
+        calleeCarId,
+        action,
+        ...details,
+    };
+    switch (phase) {
+        case 'start':
+            logger.info(ctx, `A2A invoke: ${callerCarId} -> ${calleeCarId}:${action}`);
+            break;
+        case 'success':
+            logger.info(ctx, `A2A success: ${callerCarId} -> ${calleeCarId}:${action}`);
+            break;
+        case 'failure':
+            logger.warn(ctx, `A2A failed: ${callerCarId} -> ${calleeCarId}:${action}`);
+            break;
+        case 'timeout':
+            logger.warn(ctx, `A2A timeout: ${callerCarId} -> ${calleeCarId}:${action}`);
+            break;
+    }
+}
+/**
+ * Log a sandbox event
+ */
+export function logSandboxEvent(logger, event, containerId, details) {
+    const ctx = {
+        event: `sandbox.${event}`,
+        containerId,
+        ...details,
+    };
+    if (event === 'violation') {
+        logger.warn(ctx, `Sandbox violation: ${containerId}`);
+    }
+    else {
+        logger.info(ctx, `Sandbox ${event}: ${containerId}`);
+    }
+}
+/**
+ * Log an attestation
+ */
+export function logAttestation(logger, type, carId, outcome, details) {
+    const ctx = {
+        event: 'attestation.recorded',
+        type,
+        carId,
+        outcome,
+        ...details,
+    };
+    logger.info(ctx, `Attestation recorded: ${type} for ${carId}`);
+}
+//# sourceMappingURL=logging.js.map

package/dist/observability/logging.js.map

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

package/dist/observability/metrics.d.ts

@@ -0,0 +1,226 @@
+/**
+ * Unified Observability Metrics
+ *
+ * Prometheus-compatible metrics for Agent Anchor, A2A, and Sandbox subsystems.
+ * Extends the existing intent metrics with governance-specific instrumentation.
+ *
+ * @packageDocumentation
+ */
+import { Registry, Counter, Histogram, Gauge, Summary } from 'prom-client';
+/**
+ * Dedicated registry for Agent Anchor observability metrics
+ */
+export declare const anchorRegistry: Registry<"text/plain; version=0.0.4; charset=utf-8">;
+/**
+ * Total agents registered
+ */
+export declare const agentsRegisteredTotal: Counter<"level" | "tenant_id" | "domain">;
+/**
+ * Current agent count by state
+ */
+export declare const agentsCurrentByState: Gauge<"tenant_id" | "state">;
+/**
+ * Agent state transitions
+ */
+export declare const agentStateTransitions: Counter<"action" | "tenant_id" | "from_state" | "to_state">;
+/**
+ * Agent registration latency
+ */
+export declare const agentRegistrationDuration: Histogram<"tenant_id">;
+/**
+ * Trust score computations
+ */
+export declare const trustScoreComputations: Counter<"tenant_id" | "trigger">;
+/**
+ * Trust score computation latency
+ */
+export declare const trustScoreComputationDuration: Histogram<"tenant_id">;
+/**
+ * Trust score distribution
+ */
+export declare const trustScoreDistribution: Histogram<"tenant_id">;
+/**
+ * Current agents by tier
+ */
+export declare const agentsByTier: Gauge<"tenant_id" | "tier">;
+/**
+ * Tier transitions
+ */
+export declare const tierTransitions: Counter<"tenant_id" | "from_tier" | "to_tier" | "direction">;
+/**
+ * Human approval requests
+ */
+export declare const humanApprovalRequests: Counter<"tenant_id" | "outcome" | "target_tier">;
+/**
+ * Attestations submitted
+ */
+export declare const attestationsSubmitted: Counter<"type" | "tenant_id" | "outcome">;
+/**
+ * Attestation processing latency
+ */
+export declare const attestationProcessingDuration: Histogram<"type" | "tenant_id">;
+/**
+ * Attestation batch sizes
+ */
+export declare const attestationBatchSize: Summary<"tenant_id">;
+/**
+ * Attestations pending flush
+ */
+export declare const attestationsPending: Gauge<"type">;
+/**
+ * A2A invocations
+ */
+export declare const a2aInvocationsTotal: Counter<"action" | "outcome" | "caller_tenant" | "callee_tenant">;
+/**
+ * A2A invocation latency
+ */
+export declare const a2aInvocationDuration: Histogram<"action" | "caller_tenant">;
+/**
+ * A2A chain depth distribution
+ */
+export declare const a2aChainDepth: Histogram<"root_tenant">;
+/**
+ * A2A active chains
+ */
+export declare const a2aActiveChains: Gauge<string>;
+/**
+ * A2A trust verification results
+ */
+export declare const a2aTrustVerifications: Counter<"outcome" | "caller_tier">;
+/**
+ * A2A delegation usage
+ */
+export declare const a2aDelegationUsage: Counter<"outcome" | "delegator_tenant" | "delegate_tenant">;
+/**
+ * A2A circuit breaker state changes
+ */
+export declare const a2aCircuitBreakerStateChanges: Counter<"from_state" | "to_state" | "target_aci">;
+/**
+ * A2A registered endpoints
+ */
+export declare const a2aRegisteredEndpoints: Gauge<"status">;
+/**
+ * Sandbox containers created
+ */
+export declare const sandboxContainersCreated: Counter<"tenant_id" | "tier" | "runtime">;
+/**
+ * Sandbox containers active
+ */
+export declare const sandboxContainersActive: Gauge<"tier" | "runtime">;
+/**
+ * Sandbox container lifecycle duration
+ */
+export declare const sandboxContainerDuration: Histogram<"tier" | "exit_reason">;
+/**
+ * Capability requests
+ */
+export declare const capabilityRequests: Counter<"tenant_id" | "outcome" | "capability_type">;
+/**
+ * Network policy violations
+ */
+export declare const networkPolicyViolations: Counter<"tenant_id" | "tier" | "violation_type">;
+/**
+ * Filesystem policy violations
+ */
+export declare const filesystemPolicyViolations: Counter<"tenant_id" | "tier" | "violation_type">;
+/**
+ * Resource usage per sandbox
+ */
+export declare const sandboxResourceUsage: Gauge<"resource_type" | "container_id">;
+/**
+ * API request count
+ */
+export declare const apiRequestsTotal: Counter<"path" | "method" | "status_code">;
+/**
+ * API request latency
+ */
+export declare const apiRequestDuration: Histogram<"path" | "method">;
+/**
+ * API errors
+ */
+export declare const apiErrors: Counter<"path" | "method" | "error_type">;
+/**
+ * PostgreSQL replication lag in bytes
+ */
+export declare const dbReplicationLagBytes: Gauge<"cluster" | "replica_id" | "replica_host">;
+/**
+ * PostgreSQL replication lag in seconds
+ */
+export declare const dbReplicationLagSeconds: Gauge<"cluster" | "replica_id" | "replica_host">;
+/**
+ * PostgreSQL replica status
+ */
+export declare const dbReplicaStatus: Gauge<"status" | "cluster" | "replica_id">;
+/**
+ * PostgreSQL cluster health
+ */
+export declare const dbClusterHealth: Gauge<"cluster">;
+/**
+ * Number of healthy PostgreSQL replicas
+ */
+export declare const dbHealthyReplicaCount: Gauge<"cluster">;
+/**
+ * PostgreSQL failover events
+ */
+export declare const dbFailoverEvents: Counter<"reason" | "success" | "cluster">;
+/**
+ * PostgreSQL health check duration
+ */
+export declare const dbHealthCheckDuration: Histogram<"role" | "cluster" | "node_id">;
+/**
+ * A3I cache operations
+ */
+export declare const a3iCacheOperations: Counter<"result" | "operation">;
+/**
+ * A3I sync operations
+ */
+export declare const a3iSyncOperations: Counter<"result" | "entity_type">;
+/**
+ * A3I sync latency
+ */
+export declare const a3iSyncDuration: Histogram<"entity_type">;
+/**
+ * Record an agent registration
+ */
+export declare function recordAgentRegistration(tenantId: string, domains: string[], level: number, durationSeconds: number): void;
+/**
+ * Record a trust score computation
+ */
+export declare function recordTrustScoreComputation(tenantId: string, trigger: 'request' | 'attestation' | 'decay', score: number, durationSeconds: number): void;
+/**
+ * Record an A2A invocation
+ */
+export declare function recordA2AInvocation(callerTenant: string, calleeTenant: string, action: string, outcome: 'success' | 'failure' | 'timeout' | 'rejected', durationSeconds: number, chainDepth: number): void;
+/**
+ * Record an attestation
+ */
+export declare function recordAttestation(tenantId: string, type: string, outcome: 'success' | 'failure', durationSeconds: number): void;
+/**
+ * Record a sandbox operation
+ */
+export declare function recordSandboxContainer(tenantId: string, tier: number, runtime: 'gvisor' | 'docker' | 'none', operation: 'created' | 'destroyed', durationSeconds?: number, exitReason?: 'completed' | 'timeout' | 'error' | 'killed'): void;
+/**
+ * Record database replication lag metrics
+ */
+export declare function recordDbReplicationLag(cluster: string, replicaId: string, replicaHost: string, lagBytes: number, lagSeconds: number, status: 'streaming' | 'catchup' | 'potential' | 'disconnected' | 'failed' | 'unknown'): void;
+/**
+ * Record database cluster health metrics
+ */
+export declare function recordDbClusterHealth(cluster: string, healthy: boolean, healthyReplicaCount: number): void;
+/**
+ * Record database failover event
+ */
+export declare function recordDbFailover(cluster: string, reason: string, success: boolean): void;
+/**
+ * Record database health check duration
+ */
+export declare function recordDbHealthCheck(cluster: string, nodeId: string, role: 'primary' | 'replica' | 'witness', durationSeconds: number): void;
+/**
+ * Get metrics output
+ */
+export declare function getMetrics(): Promise<string>;
+/**
+ * Get metrics content type
+ */
+export declare function getMetricsContentType(): string;
+//# sourceMappingURL=metrics.d.ts.map

package/dist/observability/metrics.d.ts.map

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