@llm-dev-ops/agentics-cli 1.4.32 → 1.4.35

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

@@ -0,0 +1,234 @@
+/**
+ * Phase 4 Layer 1 - Governance & FinOps Signal Contracts
+ *
+ * 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
+ *
+ * All events persisted via ruvector-service (never direct SQL)
+ */
+/**
+ * Phase 4 Governance DecisionEvent Types
+ */
+export type GovernanceSignalType = 'cost_risk_signal' | 'budget_threshold_signal' | 'policy_violation_signal' | 'approval_required_signal';
+/**
+ * Signal severity levels
+ */
+export type SignalSeverity = 'info' | 'low' | 'medium' | 'high' | 'critical';
+/**
+ * Risk category classification
+ */
+export type RiskCategory = 'cost' | 'budget' | 'security' | 'compliance' | 'operational' | 'data_governance';
+/**
+ * Approval status - agents MUST NOT auto-approve
+ */
+export type ApprovalStatus = 'pending' | 'awaiting_review' | 'escalated' | 'deferred';
+/**
+ * Base Governance Signal
+ */
+export interface GovernanceSignalBase {
+    /** Unique signal identifier */
+    signal_id: string;
+    /** Signal type classification */
+    signal_type: GovernanceSignalType;
+    /** Emitting agent identifier */
+    agent_id: string;
+    /** Agent version */
+    agent_version: string;
+    /** Severity level */
+    severity: SignalSeverity;
+    /** Risk category */
+    risk_category: RiskCategory;
+    /** UTC timestamp */
+    timestamp: string;
+    /** Execution reference */
+    execution_ref: {
+        request_id: string;
+        trace_id?: string;
+        span_id?: string;
+        environment: string;
+        session_id?: string;
+    };
+    /** Performance metrics */
+    performance: {
+        tokens_used: number;
+        latency_ms: number;
+        within_budget: boolean;
+    };
+}
+/**
+ * Cost Risk Signal
+ * Emitted when cost thresholds or anomalies are detected
+ */
+export interface CostRiskSignal extends GovernanceSignalBase {
+    signal_type: 'cost_risk_signal';
+    payload: {
+        /** Estimated cost for the operation */
+        estimated_cost: number;
+        /** Currency code */
+        currency: 'USD' | 'EUR' | 'GBP';
+        /** Cost threshold that triggered the signal */
+        threshold_triggered?: number;
+        /** Cost anomaly detection result */
+        anomaly_detected: boolean;
+        /** Anomaly score (0-1) if detected */
+        anomaly_score?: number;
+        /** Cost breakdown by component */
+        cost_breakdown?: {
+            input_tokens_cost: number;
+            output_tokens_cost: number;
+            compute_cost?: number;
+            storage_cost?: number;
+        };
+        /** Scope of the cost risk */
+        scope: {
+            user_id?: string;
+            team_id?: string;
+            project_id?: string;
+            provider?: string;
+            model?: string;
+        };
+        /** Risk mitigation suggestions (advisory only) */
+        suggestions: string[];
+    };
+    /** MUST NOT contain enforcement action - signal only */
+    advisory_only: true;
+}
+/**
+ * Budget Threshold Signal
+ * Emitted when budget thresholds are approached or breached
+ */
+export interface BudgetThresholdSignal extends GovernanceSignalBase {
+    signal_type: 'budget_threshold_signal';
+    payload: {
+        /** Budget identifier */
+        budget_id: string;
+        /** Budget limit */
+        budget_limit: number;
+        /** Current spend */
+        current_spend: number;
+        /** Projected spend */
+        projected_spend?: number;
+        /** Percentage used */
+        percentage_used: number;
+        /** Threshold level triggered */
+        threshold_level: 'warning' | 'critical' | 'exceeded';
+        /** Budget period */
+        period: 'hourly' | 'daily' | 'weekly' | 'monthly' | 'quarterly' | 'yearly';
+        /** Currency */
+        currency: 'USD' | 'EUR' | 'GBP';
+        /** Scope */
+        scope: {
+            user_id?: string;
+            team_id?: string;
+            project_id?: string;
+        };
+        /** Time until budget reset */
+        reset_in_hours?: number;
+        /** Recommendations (advisory only) */
+        recommendations: string[];
+    };
+    /** MUST NOT contain enforcement action - signal only */
+    advisory_only: true;
+}
+/**
+ * Policy Violation Signal
+ * Emitted when policy violations are detected - DOES NOT ENFORCE
+ */
+export interface PolicyViolationSignal extends GovernanceSignalBase {
+    signal_type: 'policy_violation_signal';
+    payload: {
+        /** Policy that was violated */
+        policy_id: string;
+        /** Policy name */
+        policy_name: string;
+        /** Specific rule violated */
+        rule_id: string;
+        /** Rule name */
+        rule_name: string;
+        /** Violation description */
+        violation_description: string;
+        /** Violation evidence */
+        evidence: {
+            field: string;
+            expected?: string;
+            actual?: string;
+            context?: Record<string, unknown>;
+        };
+        /** Compliance framework affected (if any) */
+        compliance_framework?: 'SOC2' | 'HIPAA' | 'GDPR' | 'PCI-DSS' | 'ISO27001' | 'custom';
+        /** Remediation guidance (advisory only) */
+        remediation_guidance: string[];
+        /** Related signals */
+        related_signals?: string[];
+    };
+    /** MUST NOT contain enforcement action - signal only */
+    advisory_only: true;
+}
+/**
+ * Approval Required Signal
+ * Emitted when human approval is required - DOES NOT AUTO-APPROVE
+ */
+export interface ApprovalRequiredSignal extends GovernanceSignalBase {
+    signal_type: 'approval_required_signal';
+    payload: {
+        /** Action requiring approval */
+        action_type: string;
+        /** Action description */
+        action_description: string;
+        /** Reason approval is required */
+        approval_reason: string;
+        /** Approval status - MUST NOT be 'approved' or 'rejected' */
+        approval_status: ApprovalStatus;
+        /** Suggested approvers */
+        suggested_approvers: string[];
+        /** Escalation path */
+        escalation_path: string[];
+        /** Approval timeout (seconds) */
+        timeout_seconds: number;
+        /** Context for approver */
+        approval_context: {
+            risk_level: SignalSeverity;
+            impacted_resources: string[];
+            estimated_impact?: string;
+            rollback_possible: boolean;
+        };
+        /** Request details for human review */
+        request_details: Record<string, unknown>;
+        /** DO NOT include auto-approval logic */
+        requires_human_decision: true;
+    };
+    /** MUST NOT contain approval decision - signal only */
+    advisory_only: true;
+}
+/**
+ * Union type for all governance signals
+ */
+export type GovernanceSignal = CostRiskSignal | BudgetThresholdSignal | PolicyViolationSignal | ApprovalRequiredSignal;
+/**
+ * Governance signal acknowledgment
+ */
+export interface GovernanceSignalAck {
+    accepted: boolean;
+    signal_id: string;
+    persisted_at?: string;
+    error?: string;
+}
+/**
+ * Performance budget constraints (Phase 4 Layer 1)
+ */
+export declare const PERFORMANCE_BUDGETS: {
+    readonly MAX_TOKENS: 1200;
+    readonly MAX_LATENCY_MS: 2500;
+};
+/**
+ * Validate performance is within budget
+ */
+export declare function validatePerformanceBudget(tokensUsed: number, latencyMs: number): {
+    withinBudget: boolean;
+    violations: string[];
+};
+//# sourceMappingURL=governance-signals.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"governance-signals.d.ts","sourceRoot":"","sources":["../../../src/governance/contracts/governance-signals.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH;;GAEG;AACH,MAAM,MAAM,oBAAoB,GAC5B,kBAAkB,GAClB,yBAAyB,GACzB,yBAAyB,GACzB,0BAA0B,CAAC;AAE/B;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG,KAAK,GAAG,QAAQ,GAAG,MAAM,GAAG,UAAU,CAAC;AAE7E;;GAEG;AACH,MAAM,MAAM,YAAY,GACpB,MAAM,GACN,QAAQ,GACR,UAAU,GACV,YAAY,GACZ,aAAa,GACb,iBAAiB,CAAC;AAEtB;;GAEG;AACH,MAAM,MAAM,cAAc,GACtB,SAAS,GACT,iBAAiB,GACjB,WAAW,GACX,UAAU,CAAC;AAEf;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,+BAA+B;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,iCAAiC;IACjC,WAAW,EAAE,oBAAoB,CAAC;IAClC,gCAAgC;IAChC,QAAQ,EAAE,MAAM,CAAC;IACjB,oBAAoB;IACpB,aAAa,EAAE,MAAM,CAAC;IACtB,qBAAqB;IACrB,QAAQ,EAAE,cAAc,CAAC;IACzB,oBAAoB;IACpB,aAAa,EAAE,YAAY,CAAC;IAC5B,oBAAoB;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,0BAA0B;IAC1B,aAAa,EAAE;QACb,UAAU,EAAE,MAAM,CAAC;QACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,WAAW,EAAE,MAAM,CAAC;QACpB,UAAU,CAAC,EAAE,MAAM,CAAC;KACrB,CAAC;IACF,0BAA0B;IAC1B,WAAW,EAAE;QACX,WAAW,EAAE,MAAM,CAAC;QACpB,UAAU,EAAE,MAAM,CAAC;QACnB,aAAa,EAAE,OAAO,CAAC;KACxB,CAAC;CACH;AAED;;;GAGG;AACH,MAAM,WAAW,cAAe,SAAQ,oBAAoB;IAC1D,WAAW,EAAE,kBAAkB,CAAC;IAChC,OAAO,EAAE;QACP,uCAAuC;QACvC,cAAc,EAAE,MAAM,CAAC;QACvB,oBAAoB;QACpB,QAAQ,EAAE,KAAK,GAAG,KAAK,GAAG,KAAK,CAAC;QAChC,+CAA+C;QAC/C,mBAAmB,CAAC,EAAE,MAAM,CAAC;QAC7B,oCAAoC;QACpC,gBAAgB,EAAE,OAAO,CAAC;QAC1B,sCAAsC;QACtC,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,kCAAkC;QAClC,cAAc,CAAC,EAAE;YACf,iBAAiB,EAAE,MAAM,CAAC;YAC1B,kBAAkB,EAAE,MAAM,CAAC;YAC3B,YAAY,CAAC,EAAE,MAAM,CAAC;YACtB,YAAY,CAAC,EAAE,MAAM,CAAC;SACvB,CAAC;QACF,6BAA6B;QAC7B,KAAK,EAAE;YACL,OAAO,CAAC,EAAE,MAAM,CAAC;YACjB,OAAO,CAAC,EAAE,MAAM,CAAC;YACjB,UAAU,CAAC,EAAE,MAAM,CAAC;YACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;YAClB,KAAK,CAAC,EAAE,MAAM,CAAC;SAChB,CAAC;QACF,kDAAkD;QAClD,WAAW,EAAE,MAAM,EAAE,CAAC;KACvB,CAAC;IACF,wDAAwD;IACxD,aAAa,EAAE,IAAI,CAAC;CACrB;AAED;;;GAGG;AACH,MAAM,WAAW,qBAAsB,SAAQ,oBAAoB;IACjE,WAAW,EAAE,yBAAyB,CAAC;IACvC,OAAO,EAAE;QACP,wBAAwB;QACxB,SAAS,EAAE,MAAM,CAAC;QAClB,mBAAmB;QACnB,YAAY,EAAE,MAAM,CAAC;QACrB,oBAAoB;QACpB,aAAa,EAAE,MAAM,CAAC;QACtB,sBAAsB;QACtB,eAAe,CAAC,EAAE,MAAM,CAAC;QACzB,sBAAsB;QACtB,eAAe,EAAE,MAAM,CAAC;QACxB,gCAAgC;QAChC,eAAe,EAAE,SAAS,GAAG,UAAU,GAAG,UAAU,CAAC;QACrD,oBAAoB;QACpB,MAAM,EAAE,QAAQ,GAAG,OAAO,GAAG,QAAQ,GAAG,SAAS,GAAG,WAAW,GAAG,QAAQ,CAAC;QAC3E,eAAe;QACf,QAAQ,EAAE,KAAK,GAAG,KAAK,GAAG,KAAK,CAAC;QAChC,YAAY;QACZ,KAAK,EAAE;YACL,OAAO,CAAC,EAAE,MAAM,CAAC;YACjB,OAAO,CAAC,EAAE,MAAM,CAAC;YACjB,UAAU,CAAC,EAAE,MAAM,CAAC;SACrB,CAAC;QACF,8BAA8B;QAC9B,cAAc,CAAC,EAAE,MAAM,CAAC;QACxB,sCAAsC;QACtC,eAAe,EAAE,MAAM,EAAE,CAAC;KAC3B,CAAC;IACF,wDAAwD;IACxD,aAAa,EAAE,IAAI,CAAC;CACrB;AAED;;;GAGG;AACH,MAAM,WAAW,qBAAsB,SAAQ,oBAAoB;IACjE,WAAW,EAAE,yBAAyB,CAAC;IACvC,OAAO,EAAE;QACP,+BAA+B;QAC/B,SAAS,EAAE,MAAM,CAAC;QAClB,kBAAkB;QAClB,WAAW,EAAE,MAAM,CAAC;QACpB,6BAA6B;QAC7B,OAAO,EAAE,MAAM,CAAC;QAChB,gBAAgB;QAChB,SAAS,EAAE,MAAM,CAAC;QAClB,4BAA4B;QAC5B,qBAAqB,EAAE,MAAM,CAAC;QAC9B,yBAAyB;QACzB,QAAQ,EAAE;YACR,KAAK,EAAE,MAAM,CAAC;YACd,QAAQ,CAAC,EAAE,MAAM,CAAC;YAClB,MAAM,CAAC,EAAE,MAAM,CAAC;YAChB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;SACnC,CAAC;QACF,6CAA6C;QAC7C,oBAAoB,CAAC,EAAE,MAAM,GAAG,OAAO,GAAG,MAAM,GAAG,SAAS,GAAG,UAAU,GAAG,QAAQ,CAAC;QACrF,2CAA2C;QAC3C,oBAAoB,EAAE,MAAM,EAAE,CAAC;QAC/B,sBAAsB;QACtB,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;KAC5B,CAAC;IACF,wDAAwD;IACxD,aAAa,EAAE,IAAI,CAAC;CACrB;AAED;;;GAGG;AACH,MAAM,WAAW,sBAAuB,SAAQ,oBAAoB;IAClE,WAAW,EAAE,0BAA0B,CAAC;IACxC,OAAO,EAAE;QACP,gCAAgC;QAChC,WAAW,EAAE,MAAM,CAAC;QACpB,yBAAyB;QACzB,kBAAkB,EAAE,MAAM,CAAC;QAC3B,kCAAkC;QAClC,eAAe,EAAE,MAAM,CAAC;QACxB,6DAA6D;QAC7D,eAAe,EAAE,cAAc,CAAC;QAChC,0BAA0B;QAC1B,mBAAmB,EAAE,MAAM,EAAE,CAAC;QAC9B,sBAAsB;QACtB,eAAe,EAAE,MAAM,EAAE,CAAC;QAC1B,iCAAiC;QACjC,eAAe,EAAE,MAAM,CAAC;QACxB,2BAA2B;QAC3B,gBAAgB,EAAE;YAChB,UAAU,EAAE,cAAc,CAAC;YAC3B,kBAAkB,EAAE,MAAM,EAAE,CAAC;YAC7B,gBAAgB,CAAC,EAAE,MAAM,CAAC;YAC1B,iBAAiB,EAAE,OAAO,CAAC;SAC5B,CAAC;QACF,uCAAuC;QACvC,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QACzC,yCAAyC;QACzC,uBAAuB,EAAE,IAAI,CAAC;KAC/B,CAAC;IACF,uDAAuD;IACvD,aAAa,EAAE,IAAI,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,MAAM,gBAAgB,GACxB,cAAc,GACd,qBAAqB,GACrB,qBAAqB,GACrB,sBAAsB,CAAC;AAE3B;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,QAAQ,EAAE,OAAO,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,eAAO,MAAM,mBAAmB;;;CAGtB,CAAC;AAEX;;GAEG;AACH,wBAAgB,yBAAyB,CACvC,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,MAAM,GAChB;IAAE,YAAY,EAAE,OAAO,CAAC;IAAC,UAAU,EAAE,MAAM,EAAE,CAAA;CAAE,CAmBjD"}

package/dist/bundled-agents/policy-engine-agents/dist/governance/contracts/governance-signals.js

@@ -0,0 +1,40 @@
+"use strict";
+/**
+ * Phase 4 Layer 1 - Governance & FinOps Signal Contracts
+ *
+ * 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
+ *
+ * All events persisted via ruvector-service (never direct SQL)
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PERFORMANCE_BUDGETS = void 0;
+exports.validatePerformanceBudget = validatePerformanceBudget;
+/**
+ * Performance budget constraints (Phase 4 Layer 1)
+ */
+exports.PERFORMANCE_BUDGETS = {
+    MAX_TOKENS: 1200,
+    MAX_LATENCY_MS: 2500,
+};
+/**
+ * Validate performance is within budget
+ */
+function validatePerformanceBudget(tokensUsed, latencyMs) {
+    const violations = [];
+    if (tokensUsed > exports.PERFORMANCE_BUDGETS.MAX_TOKENS) {
+        violations.push(`Token usage ${tokensUsed} exceeds budget ${exports.PERFORMANCE_BUDGETS.MAX_TOKENS}`);
+    }
+    if (latencyMs > exports.PERFORMANCE_BUDGETS.MAX_LATENCY_MS) {
+        violations.push(`Latency ${latencyMs}ms exceeds budget ${exports.PERFORMANCE_BUDGETS.MAX_LATENCY_MS}ms`);
+    }
+    return {
+        withinBudget: violations.length === 0,
+        violations,
+    };
+}
+//# sourceMappingURL=governance-signals.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"governance-signals.js","sourceRoot":"","sources":["../../../src/governance/contracts/governance-signals.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;GAWG;;;AAyPH,8DAsBC;AAjCD;;GAEG;AACU,QAAA,mBAAmB,GAAG;IACjC,UAAU,EAAE,IAAI;IAChB,cAAc,EAAE,IAAI;CACZ,CAAC;AAEX;;GAEG;AACH,SAAgB,yBAAyB,CACvC,UAAkB,EAClB,SAAiB;IAEjB,MAAM,UAAU,GAAa,EAAE,CAAC;IAEhC,IAAI,UAAU,GAAG,2BAAmB,CAAC,UAAU,EAAE,CAAC;QAChD,UAAU,CAAC,IAAI,CACb,eAAe,UAAU,mBAAmB,2BAAmB,CAAC,UAAU,EAAE,CAC7E,CAAC;IACJ,CAAC;IAED,IAAI,SAAS,GAAG,2BAAmB,CAAC,cAAc,EAAE,CAAC;QACnD,UAAU,CAAC,IAAI,CACb,WAAW,SAAS,qBAAqB,2BAAmB,CAAC,cAAc,IAAI,CAChF,CAAC;IACJ,CAAC;IAED,OAAO;QACL,YAAY,EAAE,UAAU,CAAC,MAAM,KAAK,CAAC;QACrC,UAAU;KACX,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,5 @@
+/**
+ * Governance Contracts - Phase 4 Layer 1
+ */
+export * from './governance-signals';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/governance/contracts/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,cAAc,sBAAsB,CAAC"}

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

@@ -0,0 +1,21 @@
+"use strict";
+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 });
+/**
+ * Governance Contracts - Phase 4 Layer 1
+ */
+__exportStar(require("./governance-signals"), exports);
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/governance/contracts/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA;;GAEG;AACH,uDAAqC"}

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

@@ -0,0 +1,137 @@
+import { GovernanceSignalAck, SignalSeverity } from '../contracts/governance-signals';
+/**
+ * Governance Signal Emitter
+ *
+ * Responsible for creating and emitting governance signals.
+ * DOES NOT enforce policies or auto-approve actions.
+ */
+export declare class GovernanceSignalEmitter {
+    private environment;
+    constructor();
+    /**
+     * Emit a cost risk signal
+     * Advisory only - does NOT block or throttle
+     */
+    emitCostRiskSignal(params: {
+        requestId: string;
+        traceId?: string;
+        estimatedCost: number;
+        currency?: 'USD' | 'EUR' | 'GBP';
+        thresholdTriggered?: number;
+        anomalyDetected?: boolean;
+        anomalyScore?: number;
+        costBreakdown?: {
+            input_tokens_cost: number;
+            output_tokens_cost: number;
+            compute_cost?: number;
+            storage_cost?: number;
+        };
+        scope: {
+            user_id?: string;
+            team_id?: string;
+            project_id?: string;
+            provider?: string;
+            model?: string;
+        };
+        tokensUsed: number;
+        latencyMs: number;
+    }): Promise<GovernanceSignalAck>;
+    /**
+     * Emit a budget threshold signal
+     * Advisory only - does NOT block requests
+     */
+    emitBudgetThresholdSignal(params: {
+        requestId: string;
+        traceId?: string;
+        budgetId: string;
+        budgetLimit: number;
+        currentSpend: number;
+        projectedSpend?: number;
+        period: 'hourly' | 'daily' | 'weekly' | 'monthly' | 'quarterly' | 'yearly';
+        currency?: 'USD' | 'EUR' | 'GBP';
+        scope: {
+            user_id?: string;
+            team_id?: string;
+            project_id?: string;
+        };
+        resetInHours?: number;
+        tokensUsed: number;
+        latencyMs: number;
+    }): Promise<GovernanceSignalAck>;
+    /**
+     * Emit a policy violation signal
+     * Advisory only - does NOT enforce or block
+     */
+    emitPolicyViolationSignal(params: {
+        requestId: string;
+        traceId?: string;
+        policyId: string;
+        policyName: string;
+        ruleId: string;
+        ruleName: string;
+        violationDescription: string;
+        evidence: {
+            field: string;
+            expected?: string;
+            actual?: string;
+            context?: Record<string, unknown>;
+        };
+        severity: SignalSeverity;
+        riskCategory?: 'security' | 'compliance' | 'operational' | 'data_governance';
+        complianceFramework?: 'SOC2' | 'HIPAA' | 'GDPR' | 'PCI-DSS' | 'ISO27001' | 'custom';
+        relatedSignals?: string[];
+        tokensUsed: number;
+        latencyMs: number;
+    }): Promise<GovernanceSignalAck>;
+    /**
+     * Emit an approval required signal
+     * Advisory only - does NOT auto-approve
+     */
+    emitApprovalRequiredSignal(params: {
+        requestId: string;
+        traceId?: string;
+        actionType: string;
+        actionDescription: string;
+        approvalReason: string;
+        suggestedApprovers: string[];
+        escalationPath: string[];
+        timeoutSeconds?: number;
+        riskLevel: SignalSeverity;
+        impactedResources: string[];
+        estimatedImpact?: string;
+        rollbackPossible: boolean;
+        requestDetails: Record<string, unknown>;
+        tokensUsed: number;
+        latencyMs: number;
+    }): Promise<GovernanceSignalAck>;
+    /**
+     * Persist signal to ruvector-service
+     */
+    private persistSignal;
+    /**
+     * Calculate cost severity
+     */
+    private calculateCostSeverity;
+    /**
+     * Generate cost suggestions (advisory only)
+     */
+    private generateCostSuggestions;
+    /**
+     * Determine budget threshold level
+     */
+    private determineBudgetThresholdLevel;
+    /**
+     * Map threshold level to severity
+     */
+    private mapThresholdToSeverity;
+    /**
+     * Generate budget recommendations (advisory only)
+     */
+    private generateBudgetRecommendations;
+    /**
+     * Generate remediation guidance (advisory only)
+     */
+    private generateRemediationGuidance;
+}
+export declare const governanceSignalEmitter: GovernanceSignalEmitter;
+//# sourceMappingURL=governance-signal-emitter.d.ts.map

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

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