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

package/dist/bundled-agents/policy-engine-agents/dist/governance/emitters/governance-signal-emitter.js

@@ -0,0 +1,342 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.governanceSignalEmitter = exports.GovernanceSignalEmitter = void 0;
+/**
+ * Phase 4 Layer 1 - Governance Signal Emitter
+ *
+ * Emits governance signals WITHOUT auto-enforcement or auto-approval.
+ * All signals are advisory and persisted via ruvector-service.
+ *
+ * AGENT PHASE: phase4
+ * AGENT LAYER: layer1
+ */
+const uuid_1 = require("uuid");
+const governance_signals_1 = require("../contracts/governance-signals");
+const ruvector_service_1 = require("../../integrations/ruvector-service");
+const logger_1 = __importDefault(require("@utils/logger"));
+const config_1 = require("@utils/config");
+/**
+ * Agent identification
+ */
+const AGENT_ID = 'governance-signal-emitter';
+const AGENT_VERSION = '1.0.0';
+/**
+ * Governance Signal Emitter
+ *
+ * Responsible for creating and emitting governance signals.
+ * DOES NOT enforce policies or auto-approve actions.
+ */
+class GovernanceSignalEmitter {
+    environment;
+    constructor() {
+        this.environment = config_1.config.environment || 'development';
+    }
+    /**
+     * Emit a cost risk signal
+     * Advisory only - does NOT block or throttle
+     */
+    async emitCostRiskSignal(params) {
+        const startTime = Date.now();
+        // Calculate severity based on cost
+        const severity = this.calculateCostSeverity(params.estimatedCost, params.thresholdTriggered);
+        // Generate suggestions (advisory only)
+        const suggestions = this.generateCostSuggestions(params.estimatedCost, params.anomalyDetected, params.scope);
+        // Validate performance budget
+        const perfBudget = (0, governance_signals_1.validatePerformanceBudget)(params.tokensUsed, params.latencyMs);
+        const signal = {
+            signal_id: (0, uuid_1.v4)(),
+            signal_type: 'cost_risk_signal',
+            agent_id: AGENT_ID,
+            agent_version: AGENT_VERSION,
+            severity,
+            risk_category: 'cost',
+            timestamp: new Date().toISOString(),
+            execution_ref: {
+                request_id: params.requestId,
+                trace_id: params.traceId || (0, uuid_1.v4)(),
+                environment: this.environment,
+            },
+            performance: {
+                tokens_used: params.tokensUsed,
+                latency_ms: params.latencyMs,
+                within_budget: perfBudget.withinBudget,
+            },
+            payload: {
+                estimated_cost: params.estimatedCost,
+                currency: params.currency || 'USD',
+                threshold_triggered: params.thresholdTriggered,
+                anomaly_detected: params.anomalyDetected || false,
+                anomaly_score: params.anomalyScore,
+                cost_breakdown: params.costBreakdown,
+                scope: params.scope,
+                suggestions,
+            },
+            advisory_only: true,
+        };
+        return this.persistSignal(signal, startTime);
+    }
+    /**
+     * Emit a budget threshold signal
+     * Advisory only - does NOT block requests
+     */
+    async emitBudgetThresholdSignal(params) {
+        const startTime = Date.now();
+        const percentageUsed = (params.currentSpend / params.budgetLimit) * 100;
+        const thresholdLevel = this.determineBudgetThresholdLevel(percentageUsed);
+        const severity = this.mapThresholdToSeverity(thresholdLevel);
+        // Generate recommendations (advisory only)
+        const recommendations = this.generateBudgetRecommendations(percentageUsed, thresholdLevel, params.budgetLimit - params.currentSpend);
+        // Validate performance budget
+        const perfBudget = (0, governance_signals_1.validatePerformanceBudget)(params.tokensUsed, params.latencyMs);
+        const signal = {
+            signal_id: (0, uuid_1.v4)(),
+            signal_type: 'budget_threshold_signal',
+            agent_id: AGENT_ID,
+            agent_version: AGENT_VERSION,
+            severity,
+            risk_category: 'budget',
+            timestamp: new Date().toISOString(),
+            execution_ref: {
+                request_id: params.requestId,
+                trace_id: params.traceId || (0, uuid_1.v4)(),
+                environment: this.environment,
+            },
+            performance: {
+                tokens_used: params.tokensUsed,
+                latency_ms: params.latencyMs,
+                within_budget: perfBudget.withinBudget,
+            },
+            payload: {
+                budget_id: params.budgetId,
+                budget_limit: params.budgetLimit,
+                current_spend: params.currentSpend,
+                projected_spend: params.projectedSpend,
+                percentage_used: Math.round(percentageUsed * 100) / 100,
+                threshold_level: thresholdLevel,
+                period: params.period,
+                currency: params.currency || 'USD',
+                scope: params.scope,
+                reset_in_hours: params.resetInHours,
+                recommendations,
+            },
+            advisory_only: true,
+        };
+        return this.persistSignal(signal, startTime);
+    }
+    /**
+     * Emit a policy violation signal
+     * Advisory only - does NOT enforce or block
+     */
+    async emitPolicyViolationSignal(params) {
+        const startTime = Date.now();
+        // Generate remediation guidance (advisory only)
+        const remediationGuidance = this.generateRemediationGuidance(params.policyId, params.ruleId, params.violationDescription);
+        // Validate performance budget
+        const perfBudget = (0, governance_signals_1.validatePerformanceBudget)(params.tokensUsed, params.latencyMs);
+        const signal = {
+            signal_id: (0, uuid_1.v4)(),
+            signal_type: 'policy_violation_signal',
+            agent_id: AGENT_ID,
+            agent_version: AGENT_VERSION,
+            severity: params.severity,
+            risk_category: params.riskCategory || 'compliance',
+            timestamp: new Date().toISOString(),
+            execution_ref: {
+                request_id: params.requestId,
+                trace_id: params.traceId || (0, uuid_1.v4)(),
+                environment: this.environment,
+            },
+            performance: {
+                tokens_used: params.tokensUsed,
+                latency_ms: params.latencyMs,
+                within_budget: perfBudget.withinBudget,
+            },
+            payload: {
+                policy_id: params.policyId,
+                policy_name: params.policyName,
+                rule_id: params.ruleId,
+                rule_name: params.ruleName,
+                violation_description: params.violationDescription,
+                evidence: params.evidence,
+                compliance_framework: params.complianceFramework,
+                remediation_guidance: remediationGuidance,
+                related_signals: params.relatedSignals,
+            },
+            advisory_only: true,
+        };
+        return this.persistSignal(signal, startTime);
+    }
+    /**
+     * Emit an approval required signal
+     * Advisory only - does NOT auto-approve
+     */
+    async emitApprovalRequiredSignal(params) {
+        const startTime = Date.now();
+        // Validate performance budget
+        const perfBudget = (0, governance_signals_1.validatePerformanceBudget)(params.tokensUsed, params.latencyMs);
+        const signal = {
+            signal_id: (0, uuid_1.v4)(),
+            signal_type: 'approval_required_signal',
+            agent_id: AGENT_ID,
+            agent_version: AGENT_VERSION,
+            severity: params.riskLevel,
+            risk_category: 'operational',
+            timestamp: new Date().toISOString(),
+            execution_ref: {
+                request_id: params.requestId,
+                trace_id: params.traceId || (0, uuid_1.v4)(),
+                environment: this.environment,
+            },
+            performance: {
+                tokens_used: params.tokensUsed,
+                latency_ms: params.latencyMs,
+                within_budget: perfBudget.withinBudget,
+            },
+            payload: {
+                action_type: params.actionType,
+                action_description: params.actionDescription,
+                approval_reason: params.approvalReason,
+                // CRITICAL: Status MUST NOT be 'approved' or 'rejected'
+                approval_status: 'pending',
+                suggested_approvers: params.suggestedApprovers,
+                escalation_path: params.escalationPath,
+                timeout_seconds: params.timeoutSeconds || 3600,
+                approval_context: {
+                    risk_level: params.riskLevel,
+                    impacted_resources: params.impactedResources,
+                    estimated_impact: params.estimatedImpact,
+                    rollback_possible: params.rollbackPossible,
+                },
+                request_details: params.requestDetails,
+                // CRITICAL: Always true - no auto-approval
+                requires_human_decision: true,
+            },
+            advisory_only: true,
+        };
+        return this.persistSignal(signal, startTime);
+    }
+    /**
+     * Persist signal to ruvector-service
+     */
+    async persistSignal(signal, startTime) {
+        try {
+            const ack = await ruvector_service_1.ruvectorServiceClient.persistGovernanceSignal(signal);
+            logger_1.default.info({
+                signal_id: signal.signal_id,
+                signal_type: signal.signal_type,
+                severity: signal.severity,
+                latency_ms: Date.now() - startTime,
+                advisory_only: true,
+            }, 'Governance signal emitted');
+            return ack;
+        }
+        catch (error) {
+            logger_1.default.error({ error, signal_id: signal.signal_id }, 'Failed to persist governance signal');
+            return {
+                accepted: false,
+                signal_id: signal.signal_id,
+                error: error instanceof Error ? error.message : String(error),
+            };
+        }
+    }
+    /**
+     * Calculate cost severity
+     */
+    calculateCostSeverity(estimatedCost, thresholdTriggered) {
+        if (thresholdTriggered && estimatedCost >= thresholdTriggered * 2) {
+            return 'critical';
+        }
+        if (thresholdTriggered && estimatedCost >= thresholdTriggered) {
+            return 'high';
+        }
+        if (estimatedCost > 100) {
+            return 'medium';
+        }
+        if (estimatedCost > 10) {
+            return 'low';
+        }
+        return 'info';
+    }
+    /**
+     * Generate cost suggestions (advisory only)
+     */
+    generateCostSuggestions(estimatedCost, anomalyDetected, scope) {
+        const suggestions = [];
+        if (anomalyDetected) {
+            suggestions.push('Unusual cost pattern detected - review recent usage');
+        }
+        if (estimatedCost > 50) {
+            suggestions.push('Consider using a smaller model for non-critical tasks');
+            suggestions.push('Review prompt efficiency to reduce token usage');
+        }
+        if (scope?.model?.includes('opus') || scope?.model?.includes('gpt-4')) {
+            suggestions.push('Consider using a more cost-effective model tier');
+        }
+        return suggestions;
+    }
+    /**
+     * Determine budget threshold level
+     */
+    determineBudgetThresholdLevel(percentageUsed) {
+        if (percentageUsed >= 100) {
+            return 'exceeded';
+        }
+        if (percentageUsed >= 90) {
+            return 'critical';
+        }
+        return 'warning';
+    }
+    /**
+     * Map threshold level to severity
+     */
+    mapThresholdToSeverity(level) {
+        switch (level) {
+            case 'exceeded':
+                return 'critical';
+            case 'critical':
+                return 'high';
+            case 'warning':
+                return 'medium';
+        }
+    }
+    /**
+     * Generate budget recommendations (advisory only)
+     */
+    generateBudgetRecommendations(percentageUsed, thresholdLevel, remaining) {
+        const recommendations = [];
+        if (thresholdLevel === 'exceeded') {
+            recommendations.push('Budget exceeded - request budget increase or reduce usage');
+            recommendations.push('Review high-cost operations for optimization');
+        }
+        else if (thresholdLevel === 'critical') {
+            recommendations.push(`Only $${remaining.toFixed(2)} remaining in budget`);
+            recommendations.push('Prioritize critical operations');
+        }
+        else {
+            recommendations.push(`Budget at ${percentageUsed.toFixed(1)}% - monitor usage`);
+        }
+        return recommendations;
+    }
+    /**
+     * Generate remediation guidance (advisory only)
+     */
+    generateRemediationGuidance(policyId, ruleId, violationDescription) {
+        const guidance = [];
+        guidance.push(`Review policy ${policyId} rule ${ruleId}`);
+        guidance.push('Ensure request complies with policy requirements');
+        guidance.push('Contact policy administrator if exception is needed');
+        if (violationDescription.toLowerCase().includes('security')) {
+            guidance.push('Security violations require security team review');
+        }
+        if (violationDescription.toLowerCase().includes('compliance')) {
+            guidance.push('Compliance violations may require audit documentation');
+        }
+        return guidance;
+    }
+}
+exports.GovernanceSignalEmitter = GovernanceSignalEmitter;
+exports.governanceSignalEmitter = new GovernanceSignalEmitter();
+//# sourceMappingURL=governance-signal-emitter.js.map

package/dist/bundled-agents/policy-engine-agents/dist/governance/emitters/governance-signal-emitter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"governance-signal-emitter.js","sourceRoot":"","sources":["../../../src/governance/emitters/governance-signal-emitter.ts"],"names":[],"mappings":";;;;;;AAAA;;;;;;;;GAQG;AACH,+BAAoC;AACpC,wEASyC;AACzC,0EAA4E;AAC5E,2DAAmC;AACnC,0CAAuC;AAEvC;;GAEG;AACH,MAAM,QAAQ,GAAG,2BAA2B,CAAC;AAC7C,MAAM,aAAa,GAAG,OAAO,CAAC;AAE9B;;;;;GAKG;AACH,MAAa,uBAAuB;IAC1B,WAAW,CAAS;IAE5B;QACE,IAAI,CAAC,WAAW,GAAG,eAAM,CAAC,WAAW,IAAI,aAAa,CAAC;IACzD,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,kBAAkB,CAAC,MAuBxB;QACC,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAE7B,mCAAmC;QACnC,MAAM,QAAQ,GAAG,IAAI,CAAC,qBAAqB,CACzC,MAAM,CAAC,aAAa,EACpB,MAAM,CAAC,kBAAkB,CAC1B,CAAC;QAEF,uCAAuC;QACvC,MAAM,WAAW,GAAG,IAAI,CAAC,uBAAuB,CAC9C,MAAM,CAAC,aAAa,EACpB,MAAM,CAAC,eAAe,EACtB,MAAM,CAAC,KAAK,CACb,CAAC;QAEF,8BAA8B;QAC9B,MAAM,UAAU,GAAG,IAAA,8CAAyB,EAAC,MAAM,CAAC,UAAU,EAAE,MAAM,CAAC,SAAS,CAAC,CAAC;QAElF,MAAM,MAAM,GAAmB;YAC7B,SAAS,EAAE,IAAA,SAAM,GAAE;YACnB,WAAW,EAAE,kBAAkB;YAC/B,QAAQ,EAAE,QAAQ;YAClB,aAAa,EAAE,aAAa;YAC5B,QAAQ;YACR,aAAa,EAAE,MAAM;YACrB,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;YACnC,aAAa,EAAE;gBACb,UAAU,EAAE,MAAM,CAAC,SAAS;gBAC5B,QAAQ,EAAE,MAAM,CAAC,OAAO,IAAI,IAAA,SAAM,GAAE;gBACpC,WAAW,EAAE,IAAI,CAAC,WAAW;aAC9B;YACD,WAAW,EAAE;gBACX,WAAW,EAAE,MAAM,CAAC,UAAU;gBAC9B,UAAU,EAAE,MAAM,CAAC,SAAS;gBAC5B,aAAa,EAAE,UAAU,CAAC,YAAY;aACvC;YACD,OAAO,EAAE;gBACP,cAAc,EAAE,MAAM,CAAC,aAAa;gBACpC,QAAQ,EAAE,MAAM,CAAC,QAAQ,IAAI,KAAK;gBAClC,mBAAmB,EAAE,MAAM,CAAC,kBAAkB;gBAC9C,gBAAgB,EAAE,MAAM,CAAC,eAAe,IAAI,KAAK;gBACjD,aAAa,EAAE,MAAM,CAAC,YAAY;gBAClC,cAAc,EAAE,MAAM,CAAC,aAAa;gBACpC,KAAK,EAAE,MAAM,CAAC,KAAK;gBACnB,WAAW;aACZ;YACD,aAAa,EAAE,IAAI;SACpB,CAAC;QAEF,OAAO,IAAI,CAAC,aAAa,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IAC/C,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,yBAAyB,CAAC,MAiB/B;QACC,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAE7B,MAAM,cAAc,GAAG,CAAC,MAAM,CAAC,YAAY,GAAG,MAAM,CAAC,WAAW,CAAC,GAAG,GAAG,CAAC;QACxE,MAAM,cAAc,GAAG,IAAI,CAAC,6BAA6B,CAAC,cAAc,CAAC,CAAC;QAC1E,MAAM,QAAQ,GAAG,IAAI,CAAC,sBAAsB,CAAC,cAAc,CAAC,CAAC;QAE7D,2CAA2C;QAC3C,MAAM,eAAe,GAAG,IAAI,CAAC,6BAA6B,CACxD,cAAc,EACd,cAAc,EACd,MAAM,CAAC,WAAW,GAAG,MAAM,CAAC,YAAY,CACzC,CAAC;QAEF,8BAA8B;QAC9B,MAAM,UAAU,GAAG,IAAA,8CAAyB,EAAC,MAAM,CAAC,UAAU,EAAE,MAAM,CAAC,SAAS,CAAC,CAAC;QAElF,MAAM,MAAM,GAA0B;YACpC,SAAS,EAAE,IAAA,SAAM,GAAE;YACnB,WAAW,EAAE,yBAAyB;YACtC,QAAQ,EAAE,QAAQ;YAClB,aAAa,EAAE,aAAa;YAC5B,QAAQ;YACR,aAAa,EAAE,QAAQ;YACvB,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;YACnC,aAAa,EAAE;gBACb,UAAU,EAAE,MAAM,CAAC,SAAS;gBAC5B,QAAQ,EAAE,MAAM,CAAC,OAAO,IAAI,IAAA,SAAM,GAAE;gBACpC,WAAW,EAAE,IAAI,CAAC,WAAW;aAC9B;YACD,WAAW,EAAE;gBACX,WAAW,EAAE,MAAM,CAAC,UAAU;gBAC9B,UAAU,EAAE,MAAM,CAAC,SAAS;gBAC5B,aAAa,EAAE,UAAU,CAAC,YAAY;aACvC;YACD,OAAO,EAAE;gBACP,SAAS,EAAE,MAAM,CAAC,QAAQ;gBAC1B,YAAY,EAAE,MAAM,CAAC,WAAW;gBAChC,aAAa,EAAE,MAAM,CAAC,YAAY;gBAClC,eAAe,EAAE,MAAM,CAAC,cAAc;gBACtC,eAAe,EAAE,IAAI,CAAC,KAAK,CAAC,cAAc,GAAG,GAAG,CAAC,GAAG,GAAG;gBACvD,eAAe,EAAE,cAAc;gBAC/B,MAAM,EAAE,MAAM,CAAC,MAAM;gBACrB,QAAQ,EAAE,MAAM,CAAC,QAAQ,IAAI,KAAK;gBAClC,KAAK,EAAE,MAAM,CAAC,KAAK;gBACnB,cAAc,EAAE,MAAM,CAAC,YAAY;gBACnC,eAAe;aAChB;YACD,aAAa,EAAE,IAAI;SACpB,CAAC;QAEF,OAAO,IAAI,CAAC,aAAa,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IAC/C,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,yBAAyB,CAAC,MAoB/B;QACC,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAE7B,gDAAgD;QAChD,MAAM,mBAAmB,GAAG,IAAI,CAAC,2BAA2B,CAC1D,MAAM,CAAC,QAAQ,EACf,MAAM,CAAC,MAAM,EACb,MAAM,CAAC,oBAAoB,CAC5B,CAAC;QAEF,8BAA8B;QAC9B,MAAM,UAAU,GAAG,IAAA,8CAAyB,EAAC,MAAM,CAAC,UAAU,EAAE,MAAM,CAAC,SAAS,CAAC,CAAC;QAElF,MAAM,MAAM,GAA0B;YACpC,SAAS,EAAE,IAAA,SAAM,GAAE;YACnB,WAAW,EAAE,yBAAyB;YACtC,QAAQ,EAAE,QAAQ;YAClB,aAAa,EAAE,aAAa;YAC5B,QAAQ,EAAE,MAAM,CAAC,QAAQ;YACzB,aAAa,EAAE,MAAM,CAAC,YAAY,IAAI,YAAY;YAClD,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;YACnC,aAAa,EAAE;gBACb,UAAU,EAAE,MAAM,CAAC,SAAS;gBAC5B,QAAQ,EAAE,MAAM,CAAC,OAAO,IAAI,IAAA,SAAM,GAAE;gBACpC,WAAW,EAAE,IAAI,CAAC,WAAW;aAC9B;YACD,WAAW,EAAE;gBACX,WAAW,EAAE,MAAM,CAAC,UAAU;gBAC9B,UAAU,EAAE,MAAM,CAAC,SAAS;gBAC5B,aAAa,EAAE,UAAU,CAAC,YAAY;aACvC;YACD,OAAO,EAAE;gBACP,SAAS,EAAE,MAAM,CAAC,QAAQ;gBAC1B,WAAW,EAAE,MAAM,CAAC,UAAU;gBAC9B,OAAO,EAAE,MAAM,CAAC,MAAM;gBACtB,SAAS,EAAE,MAAM,CAAC,QAAQ;gBAC1B,qBAAqB,EAAE,MAAM,CAAC,oBAAoB;gBAClD,QAAQ,EAAE,MAAM,CAAC,QAAQ;gBACzB,oBAAoB,EAAE,MAAM,CAAC,mBAAmB;gBAChD,oBAAoB,EAAE,mBAAmB;gBACzC,eAAe,EAAE,MAAM,CAAC,cAAc;aACvC;YACD,aAAa,EAAE,IAAI;SACpB,CAAC;QAEF,OAAO,IAAI,CAAC,aAAa,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IAC/C,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,0BAA0B,CAAC,MAgBhC;QACC,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAE7B,8BAA8B;QAC9B,MAAM,UAAU,GAAG,IAAA,8CAAyB,EAAC,MAAM,CAAC,UAAU,EAAE,MAAM,CAAC,SAAS,CAAC,CAAC;QAElF,MAAM,MAAM,GAA2B;YACrC,SAAS,EAAE,IAAA,SAAM,GAAE;YACnB,WAAW,EAAE,0BAA0B;YACvC,QAAQ,EAAE,QAAQ;YAClB,aAAa,EAAE,aAAa;YAC5B,QAAQ,EAAE,MAAM,CAAC,SAAS;YAC1B,aAAa,EAAE,aAAa;YAC5B,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;YACnC,aAAa,EAAE;gBACb,UAAU,EAAE,MAAM,CAAC,SAAS;gBAC5B,QAAQ,EAAE,MAAM,CAAC,OAAO,IAAI,IAAA,SAAM,GAAE;gBACpC,WAAW,EAAE,IAAI,CAAC,WAAW;aAC9B;YACD,WAAW,EAAE;gBACX,WAAW,EAAE,MAAM,CAAC,UAAU;gBAC9B,UAAU,EAAE,MAAM,CAAC,SAAS;gBAC5B,aAAa,EAAE,UAAU,CAAC,YAAY;aACvC;YACD,OAAO,EAAE;gBACP,WAAW,EAAE,MAAM,CAAC,UAAU;gBAC9B,kBAAkB,EAAE,MAAM,CAAC,iBAAiB;gBAC5C,eAAe,EAAE,MAAM,CAAC,cAAc;gBACtC,wDAAwD;gBACxD,eAAe,EAAE,SAAS;gBAC1B,mBAAmB,EAAE,MAAM,CAAC,kBAAkB;gBAC9C,eAAe,EAAE,MAAM,CAAC,cAAc;gBACtC,eAAe,EAAE,MAAM,CAAC,cAAc,IAAI,IAAI;gBAC9C,gBAAgB,EAAE;oBAChB,UAAU,EAAE,MAAM,CAAC,SAAS;oBAC5B,kBAAkB,EAAE,MAAM,CAAC,iBAAiB;oBAC5C,gBAAgB,EAAE,MAAM,CAAC,eAAe;oBACxC,iBAAiB,EAAE,MAAM,CAAC,gBAAgB;iBAC3C;gBACD,eAAe,EAAE,MAAM,CAAC,cAAc;gBACtC,2CAA2C;gBAC3C,uBAAuB,EAAE,IAAI;aAC9B;YACD,aAAa,EAAE,IAAI;SACpB,CAAC;QAEF,OAAO,IAAI,CAAC,aAAa,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IAC/C,CAAC;IAED;;OAEG;IACK,KAAK,CAAC,aAAa,CACzB,MAAwB,EACxB,SAAiB;QAEjB,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,MAAM,wCAAqB,CAAC,uBAAuB,CAAC,MAAM,CAAC,CAAC;YAExE,gBAAM,CAAC,IAAI,CACT;gBACE,SAAS,EAAE,MAAM,CAAC,SAAS;gBAC3B,WAAW,EAAE,MAAM,CAAC,WAAW;gBAC/B,QAAQ,EAAE,MAAM,CAAC,QAAQ;gBACzB,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS;gBAClC,aAAa,EAAE,IAAI;aACpB,EACD,2BAA2B,CAC5B,CAAC;YAEF,OAAO,GAAG,CAAC;QACb,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,gBAAM,CAAC,KAAK,CACV,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,CAAC,SAAS,EAAE,EACtC,qCAAqC,CACtC,CAAC;YAEF,OAAO;gBACL,QAAQ,EAAE,KAAK;gBACf,SAAS,EAAE,MAAM,CAAC,SAAS;gBAC3B,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;aAC9D,CAAC;QACJ,CAAC;IACH,CAAC;IAED;;OAEG;IACK,qBAAqB,CAC3B,aAAqB,EACrB,kBAA2B;QAE3B,IAAI,kBAAkB,IAAI,aAAa,IAAI,kBAAkB,GAAG,CAAC,EAAE,CAAC;YAClE,OAAO,UAAU,CAAC;QACpB,CAAC;QACD,IAAI,kBAAkB,IAAI,aAAa,IAAI,kBAAkB,EAAE,CAAC;YAC9D,OAAO,MAAM,CAAC;QAChB,CAAC;QACD,IAAI,aAAa,GAAG,GAAG,EAAE,CAAC;YACxB,OAAO,QAAQ,CAAC;QAClB,CAAC;QACD,IAAI,aAAa,GAAG,EAAE,EAAE,CAAC;YACvB,OAAO,KAAK,CAAC;QACf,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;IAED;;OAEG;IACK,uBAAuB,CAC7B,aAAqB,EACrB,eAAyB,EACzB,KAA6C;QAE7C,MAAM,WAAW,GAAa,EAAE,CAAC;QAEjC,IAAI,eAAe,EAAE,CAAC;YACpB,WAAW,CAAC,IAAI,CAAC,qDAAqD,CAAC,CAAC;QAC1E,CAAC;QAED,IAAI,aAAa,GAAG,EAAE,EAAE,CAAC;YACvB,WAAW,CAAC,IAAI,CAAC,uDAAuD,CAAC,CAAC;YAC1E,WAAW,CAAC,IAAI,CAAC,gDAAgD,CAAC,CAAC;QACrE,CAAC;QAED,IAAI,KAAK,EAAE,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,IAAI,KAAK,EAAE,KAAK,EAAE,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;YACtE,WAAW,CAAC,IAAI,CAAC,iDAAiD,CAAC,CAAC;QACtE,CAAC;QAED,OAAO,WAAW,CAAC;IACrB,CAAC;IAED;;OAEG;IACK,6BAA6B,CACnC,cAAsB;QAEtB,IAAI,cAAc,IAAI,GAAG,EAAE,CAAC;YAC1B,OAAO,UAAU,CAAC;QACpB,CAAC;QACD,IAAI,cAAc,IAAI,EAAE,EAAE,CAAC;YACzB,OAAO,UAAU,CAAC;QACpB,CAAC;QACD,OAAO,SAAS,CAAC;IACnB,CAAC;IAED;;OAEG;IACK,sBAAsB,CAC5B,KAA0C;QAE1C,QAAQ,KAAK,EAAE,CAAC;YACd,KAAK,UAAU;gBACb,OAAO,UAAU,CAAC;YACpB,KAAK,UAAU;gBACb,OAAO,MAAM,CAAC;YAChB,KAAK,SAAS;gBACZ,OAAO,QAAQ,CAAC;QACpB,CAAC;IACH,CAAC;IAED;;OAEG;IACK,6BAA6B,CACnC,cAAsB,EACtB,cAAmD,EACnD,SAAiB;QAEjB,MAAM,eAAe,GAAa,EAAE,CAAC;QAErC,IAAI,cAAc,KAAK,UAAU,EAAE,CAAC;YAClC,eAAe,CAAC,IAAI,CAAC,2DAA2D,CAAC,CAAC;YAClF,eAAe,CAAC,IAAI,CAAC,8CAA8C,CAAC,CAAC;QACvE,CAAC;aAAM,IAAI,cAAc,KAAK,UAAU,EAAE,CAAC;YACzC,eAAe,CAAC,IAAI,CAAC,SAAS,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC,sBAAsB,CAAC,CAAC;YAC1E,eAAe,CAAC,IAAI,CAAC,gCAAgC,CAAC,CAAC;QACzD,CAAC;aAAM,CAAC;YACN,eAAe,CAAC,IAAI,CAAC,aAAa,cAAc,CAAC,OAAO,CAAC,CAAC,CAAC,mBAAmB,CAAC,CAAC;QAClF,CAAC;QAED,OAAO,eAAe,CAAC;IACzB,CAAC;IAED;;OAEG;IACK,2BAA2B,CACjC,QAAgB,EAChB,MAAc,EACd,oBAA4B;QAE5B,MAAM,QAAQ,GAAa,EAAE,CAAC;QAE9B,QAAQ,CAAC,IAAI,CAAC,iBAAiB,QAAQ,SAAS,MAAM,EAAE,CAAC,CAAC;QAC1D,QAAQ,CAAC,IAAI,CAAC,kDAAkD,CAAC,CAAC;QAClE,QAAQ,CAAC,IAAI,CAAC,qDAAqD,CAAC,CAAC;QAErE,IAAI,oBAAoB,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC;YAC5D,QAAQ,CAAC,IAAI,CAAC,kDAAkD,CAAC,CAAC;QACpE,CAAC;QAED,IAAI,oBAAoB,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,YAAY,CAAC,EAAE,CAAC;YAC9D,QAAQ,CAAC,IAAI,CAAC,uDAAuD,CAAC,CAAC;QACzE,CAAC;QAED,OAAO,QAAQ,CAAC;IAClB,CAAC;CACF;AAjdD,0DAidC;AAEY,QAAA,uBAAuB,GAAG,IAAI,uBAAuB,EAAE,CAAC"}

package/dist/bundled-agents/policy-engine-agents/dist/governance/emitters/index.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Governance Emitters - Phase 4 Layer 1
+ */
+export { GovernanceSignalEmitter, governanceSignalEmitter } from './governance-signal-emitter';
+//# sourceMappingURL=index.d.ts.map

package/dist/bundled-agents/policy-engine-agents/dist/governance/emitters/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/governance/emitters/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,uBAAuB,EAAE,uBAAuB,EAAE,MAAM,6BAA6B,CAAC"}

package/dist/bundled-agents/policy-engine-agents/dist/governance/emitters/index.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.governanceSignalEmitter = exports.GovernanceSignalEmitter = void 0;
+/**
+ * Governance Emitters - Phase 4 Layer 1
+ */
+var governance_signal_emitter_1 = require("./governance-signal-emitter");
+Object.defineProperty(exports, "GovernanceSignalEmitter", { enumerable: true, get: function () { return governance_signal_emitter_1.GovernanceSignalEmitter; } });
+Object.defineProperty(exports, "governanceSignalEmitter", { enumerable: true, get: function () { return governance_signal_emitter_1.governanceSignalEmitter; } });
+//# sourceMappingURL=index.js.map

package/dist/bundled-agents/policy-engine-agents/dist/governance/emitters/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/governance/emitters/index.ts"],"names":[],"mappings":";;;AAAA;;GAEG;AACH,yEAA+F;AAAtF,oIAAA,uBAAuB,OAAA;AAAE,oIAAA,uBAAuB,OAAA"}

package/dist/bundled-agents/policy-engine-agents/dist/governance/index.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Phase 4 Layer 1 - Governance & FinOps Module
+ *
+ * AGENT_PHASE: phase4
+ * AGENT_LAYER: layer1
+ *
+ * GOVERNANCE RULES:
+ * - Agents MUST emit cost signals
+ * - Agents MUST emit policy evaluation signals
+ * - Agents MUST emit approval requirements
+ * - Agents MUST NOT auto-enforce policy
+ * - Agents MUST NOT auto-approve actions
+ *
+ * PERFORMANCE BUDGETS:
+ * - MAX_TOKENS: 1200
+ * - MAX_LATENCY_MS: 2500
+ */
+export * from './contracts/governance-signals';
+export { GovernanceSignalEmitter, governanceSignalEmitter } from './emitters/governance-signal-emitter';
+/**
+ * Phase 4 Layer 1 Configuration
+ */
+export declare const PHASE4_LAYER1_CONFIG: {
+    /** Agent phase identifier */
+    readonly AGENT_PHASE: "phase4";
+    /** Agent layer identifier */
+    readonly AGENT_LAYER: "layer1";
+    /** Performance budget: maximum tokens */
+    readonly MAX_TOKENS: 1200;
+    /** Performance budget: maximum latency in ms */
+    readonly MAX_LATENCY_MS: 2500;
+    /** Required signal types */
+    readonly REQUIRED_SIGNALS: readonly ["cost_risk_signal", "budget_threshold_signal", "policy_violation_signal", "approval_required_signal"];
+};
+/**
+ * Validate Phase 4 Layer 1 compliance
+ */
+export declare function validatePhase4Layer1Compliance(params: {
+    signalEmitted: boolean;
+    signalType?: string;
+    autoEnforced?: boolean;
+    autoApproved?: boolean;
+    tokensUsed: number;
+    latencyMs: number;
+}): {
+    compliant: boolean;
+    violations: string[];
+};
+//# sourceMappingURL=index.d.ts.map

package/dist/bundled-agents/policy-engine-agents/dist/governance/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/governance/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAGH,cAAc,gCAAgC,CAAC;AAG/C,OAAO,EAAE,uBAAuB,EAAE,uBAAuB,EAAE,MAAM,sCAAsC,CAAC;AAExG;;GAEG;AACH,eAAO,MAAM,oBAAoB;IAC/B,6BAA6B;;IAE7B,6BAA6B;;IAE7B,yCAAyC;;IAEzC,gDAAgD;;IAEhD,4BAA4B;;CAOpB,CAAC;AAEX;;GAEG;AACH,wBAAgB,8BAA8B,CAAC,MAAM,EAAE;IACrD,aAAa,EAAE,OAAO,CAAC;IACvB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;CACnB,GAAG;IAAE,SAAS,EAAE,OAAO,CAAC;IAAC,UAAU,EAAE,MAAM,EAAE,CAAA;CAAE,CAmC/C"}

package/dist/bundled-agents/policy-engine-agents/dist/governance/index.js

@@ -0,0 +1,91 @@
+"use strict";
+/**
+ * Phase 4 Layer 1 - Governance & FinOps Module
+ *
+ * AGENT_PHASE: phase4
+ * AGENT_LAYER: layer1
+ *
+ * GOVERNANCE RULES:
+ * - Agents MUST emit cost signals
+ * - Agents MUST emit policy evaluation signals
+ * - Agents MUST emit approval requirements
+ * - Agents MUST NOT auto-enforce policy
+ * - Agents MUST NOT auto-approve actions
+ *
+ * PERFORMANCE BUDGETS:
+ * - MAX_TOKENS: 1200
+ * - MAX_LATENCY_MS: 2500
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PHASE4_LAYER1_CONFIG = exports.governanceSignalEmitter = exports.GovernanceSignalEmitter = void 0;
+exports.validatePhase4Layer1Compliance = validatePhase4Layer1Compliance;
+// Contracts
+__exportStar(require("./contracts/governance-signals"), exports);
+// Emitters
+var governance_signal_emitter_1 = require("./emitters/governance-signal-emitter");
+Object.defineProperty(exports, "GovernanceSignalEmitter", { enumerable: true, get: function () { return governance_signal_emitter_1.GovernanceSignalEmitter; } });
+Object.defineProperty(exports, "governanceSignalEmitter", { enumerable: true, get: function () { return governance_signal_emitter_1.governanceSignalEmitter; } });
+/**
+ * Phase 4 Layer 1 Configuration
+ */
+exports.PHASE4_LAYER1_CONFIG = {
+    /** Agent phase identifier */
+    AGENT_PHASE: 'phase4',
+    /** Agent layer identifier */
+    AGENT_LAYER: 'layer1',
+    /** Performance budget: maximum tokens */
+    MAX_TOKENS: 1200,
+    /** Performance budget: maximum latency in ms */
+    MAX_LATENCY_MS: 2500,
+    /** Required signal types */
+    REQUIRED_SIGNALS: [
+        'cost_risk_signal',
+        'budget_threshold_signal',
+        'policy_violation_signal',
+        'approval_required_signal',
+    ],
+};
+/**
+ * Validate Phase 4 Layer 1 compliance
+ */
+function validatePhase4Layer1Compliance(params) {
+    const violations = [];
+    // Check signal emission
+    if (!params.signalEmitted) {
+        violations.push('Governance signal was not emitted');
+    }
+    // Check auto-enforcement (MUST NOT)
+    if (params.autoEnforced) {
+        violations.push('Auto-enforcement detected - agents MUST NOT auto-enforce policy');
+    }
+    // Check auto-approval (MUST NOT)
+    if (params.autoApproved) {
+        violations.push('Auto-approval detected - agents MUST NOT auto-approve actions');
+    }
+    // Check performance budget
+    if (params.tokensUsed > exports.PHASE4_LAYER1_CONFIG.MAX_TOKENS) {
+        violations.push(`Token usage ${params.tokensUsed} exceeds budget ${exports.PHASE4_LAYER1_CONFIG.MAX_TOKENS}`);
+    }
+    if (params.latencyMs > exports.PHASE4_LAYER1_CONFIG.MAX_LATENCY_MS) {
+        violations.push(`Latency ${params.latencyMs}ms exceeds budget ${exports.PHASE4_LAYER1_CONFIG.MAX_LATENCY_MS}ms`);
+    }
+    return {
+        compliant: violations.length === 0,
+        violations,
+    };
+}
+//# sourceMappingURL=index.js.map

package/dist/bundled-agents/policy-engine-agents/dist/governance/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/governance/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;GAgBG;;;;;;;;;;;;;;;;;AAgCH,wEA0CC;AAxED,YAAY;AACZ,iEAA+C;AAE/C,WAAW;AACX,kFAAwG;AAA/F,oIAAA,uBAAuB,OAAA;AAAE,oIAAA,uBAAuB,OAAA;AAEzD;;GAEG;AACU,QAAA,oBAAoB,GAAG;IAClC,6BAA6B;IAC7B,WAAW,EAAE,QAAQ;IACrB,6BAA6B;IAC7B,WAAW,EAAE,QAAQ;IACrB,yCAAyC;IACzC,UAAU,EAAE,IAAI;IAChB,gDAAgD;IAChD,cAAc,EAAE,IAAI;IACpB,4BAA4B;IAC5B,gBAAgB,EAAE;QAChB,kBAAkB;QAClB,yBAAyB;QACzB,yBAAyB;QACzB,0BAA0B;KAC3B;CACO,CAAC;AAEX;;GAEG;AACH,SAAgB,8BAA8B,CAAC,MAO9C;IACC,MAAM,UAAU,GAAa,EAAE,CAAC;IAEhC,wBAAwB;IACxB,IAAI,CAAC,MAAM,CAAC,aAAa,EAAE,CAAC;QAC1B,UAAU,CAAC,IAAI,CAAC,mCAAmC,CAAC,CAAC;IACvD,CAAC;IAED,oCAAoC;IACpC,IAAI,MAAM,CAAC,YAAY,EAAE,CAAC;QACxB,UAAU,CAAC,IAAI,CAAC,iEAAiE,CAAC,CAAC;IACrF,CAAC;IAED,iCAAiC;IACjC,IAAI,MAAM,CAAC,YAAY,EAAE,CAAC;QACxB,UAAU,CAAC,IAAI,CAAC,+DAA+D,CAAC,CAAC;IACnF,CAAC;IAED,2BAA2B;IAC3B,IAAI,MAAM,CAAC,UAAU,GAAG,4BAAoB,CAAC,UAAU,EAAE,CAAC;QACxD,UAAU,CAAC,IAAI,CACb,eAAe,MAAM,CAAC,UAAU,mBAAmB,4BAAoB,CAAC,UAAU,EAAE,CACrF,CAAC;IACJ,CAAC;IAED,IAAI,MAAM,CAAC,SAAS,GAAG,4BAAoB,CAAC,cAAc,EAAE,CAAC;QAC3D,UAAU,CAAC,IAAI,CACb,WAAW,MAAM,CAAC,SAAS,qBAAqB,4BAAoB,CAAC,cAAc,IAAI,CACxF,CAAC;IACJ,CAAC;IAED,OAAO;QACL,SAAS,EAAE,UAAU,CAAC,MAAM,KAAK,CAAC;QAClC,UAAU;KACX,CAAC;AACJ,CAAC"}

package/dist/bundled-agents/policy-engine-agents/dist/grpc/server.d.ts

@@ -0,0 +1,8 @@
+/**
+ * gRPC Server
+ * High-performance gRPC server for policy operations
+ */
+import * as grpc from '@grpc/grpc-js';
+export declare function createGRPCServer(): grpc.Server;
+export declare function startGRPCServer(port?: number): Promise<void>;
+//# sourceMappingURL=server.d.ts.map

package/dist/bundled-agents/policy-engine-agents/dist/grpc/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/grpc/server.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,IAAI,MAAM,eAAe,CAAC;AAUtC,wBAAgB,gBAAgB,IAAI,IAAI,CAAC,MAAM,CA6B9C;AAED,wBAAsB,eAAe,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAoElE"}