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

package/dist/bundled-agents/governance-dashboard-agents/dist/agents/governance-audit/factory.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Governance Audit Agent Factory
+ *
+ * Factory functions for creating GovernanceAuditAgent instances.
+ */
+import { GovernanceAuditAgent, type GovernanceAuditAgentConfig } from './agent.js';
+import { type RuvectorClientConfig } from '../../infrastructure/ruvector-client.js';
+import { type TelemetryEmitterConfig } from '../../infrastructure/telemetry.js';
+/**
+ * Factory configuration for Governance Audit Agent
+ */
+export interface GovernanceAuditAgentFactoryConfig {
+    ruvector: RuvectorClientConfig;
+    telemetry?: TelemetryEmitterConfig;
+    dryRun?: boolean;
+}
+/**
+ * Create a Governance Audit Agent with explicit configuration
+ */
+export declare function createGovernanceAuditAgent(config: GovernanceAuditAgentFactoryConfig): GovernanceAuditAgent;
+/**
+ * Create a Governance Audit Agent from environment variables
+ */
+export declare function createGovernanceAuditAgentFromEnv(): GovernanceAuditAgent;
+/**
+ * Create a Governance Audit Agent for testing
+ */
+export declare function createGovernanceAuditAgentForTesting(overrides?: Partial<GovernanceAuditAgentConfig>): GovernanceAuditAgent;
+//# sourceMappingURL=factory.d.ts.map

package/dist/bundled-agents/governance-dashboard-agents/dist/agents/governance-audit/factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../../../src/agents/governance-audit/factory.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,oBAAoB,EAAE,KAAK,0BAA0B,EAAE,MAAM,YAAY,CAAC;AACnF,OAAO,EAGL,KAAK,oBAAoB,EAC1B,MAAM,yCAAyC,CAAC;AACjD,OAAO,EAGL,KAAK,sBAAsB,EAC5B,MAAM,mCAAmC,CAAC;AAE3C;;GAEG;AACH,MAAM,WAAW,iCAAiC;IAChD,QAAQ,EAAE,oBAAoB,CAAC;IAC/B,SAAS,CAAC,EAAE,sBAAsB,CAAC;IACnC,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED;;GAEG;AACH,wBAAgB,0BAA0B,CACxC,MAAM,EAAE,iCAAiC,GACxC,oBAAoB,CAYtB;AAED;;GAEG;AACH,wBAAgB,iCAAiC,IAAI,oBAAoB,CAUxE;AAED;;GAEG;AACH,wBAAgB,oCAAoC,CAClD,SAAS,CAAC,EAAE,OAAO,CAAC,0BAA0B,CAAC,GAC9C,oBAAoB,CAatB"}

package/dist/bundled-agents/governance-dashboard-agents/dist/agents/governance-audit/factory.js

@@ -0,0 +1,51 @@
+/**
+ * Governance Audit Agent Factory
+ *
+ * Factory functions for creating GovernanceAuditAgent instances.
+ */
+import { GovernanceAuditAgent } from './agent.js';
+import { createRuvectorClient, createRuvectorClientFromEnv, } from '../../infrastructure/ruvector-client.js';
+import { TelemetryEmitter, createTelemetryEmitterFromEnv, } from '../../infrastructure/telemetry.js';
+/**
+ * Create a Governance Audit Agent with explicit configuration
+ */
+export function createGovernanceAuditAgent(config) {
+    const ruvectorClient = createRuvectorClient(config.ruvector);
+    const telemetryEmitter = config.telemetry
+        ? new TelemetryEmitter(config.telemetry)
+        : undefined;
+    return new GovernanceAuditAgent({
+        ruvectorClient,
+        telemetryEmitter,
+        dryRun: config.dryRun,
+    });
+}
+/**
+ * Create a Governance Audit Agent from environment variables
+ */
+export function createGovernanceAuditAgentFromEnv() {
+    const ruvectorClient = createRuvectorClientFromEnv();
+    const telemetryEmitter = createTelemetryEmitterFromEnv();
+    const dryRun = process.env.AGENT_DRY_RUN === 'true';
+    return new GovernanceAuditAgent({
+        ruvectorClient,
+        telemetryEmitter,
+        dryRun,
+    });
+}
+/**
+ * Create a Governance Audit Agent for testing
+ */
+export function createGovernanceAuditAgentForTesting(overrides) {
+    const mockRuvectorClient = createRuvectorClient({
+        baseUrl: 'http://mock-ruvector:8080',
+        apiKey: 'mock-api-key',
+    });
+    mockRuvectorClient.persistDecisionEvent = async () => { };
+    return new GovernanceAuditAgent({
+        ruvectorClient: mockRuvectorClient,
+        dryRun: true,
+        ...overrides,
+    });
+}
+//# sourceMappingURL=factory.js.map

package/dist/bundled-agents/governance-dashboard-agents/dist/agents/governance-audit/factory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"factory.js","sourceRoot":"","sources":["../../../src/agents/governance-audit/factory.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,oBAAoB,EAAmC,MAAM,YAAY,CAAC;AACnF,OAAO,EACL,oBAAoB,EACpB,2BAA2B,GAE5B,MAAM,yCAAyC,CAAC;AACjD,OAAO,EACL,gBAAgB,EAChB,6BAA6B,GAE9B,MAAM,mCAAmC,CAAC;AAW3C;;GAEG;AACH,MAAM,UAAU,0BAA0B,CACxC,MAAyC;IAEzC,MAAM,cAAc,GAAG,oBAAoB,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IAE7D,MAAM,gBAAgB,GAAG,MAAM,CAAC,SAAS;QACvC,CAAC,CAAC,IAAI,gBAAgB,CAAC,MAAM,CAAC,SAAS,CAAC;QACxC,CAAC,CAAC,SAAS,CAAC;IAEd,OAAO,IAAI,oBAAoB,CAAC;QAC9B,cAAc;QACd,gBAAgB;QAChB,MAAM,EAAE,MAAM,CAAC,MAAM;KACtB,CAAC,CAAC;AACL,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,iCAAiC;IAC/C,MAAM,cAAc,GAAG,2BAA2B,EAAE,CAAC;IACrD,MAAM,gBAAgB,GAAG,6BAA6B,EAAE,CAAC;IACzD,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,aAAa,KAAK,MAAM,CAAC;IAEpD,OAAO,IAAI,oBAAoB,CAAC;QAC9B,cAAc;QACd,gBAAgB;QAChB,MAAM;KACP,CAAC,CAAC;AACL,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,oCAAoC,CAClD,SAA+C;IAE/C,MAAM,kBAAkB,GAAG,oBAAoB,CAAC;QAC9C,OAAO,EAAE,2BAA2B;QACpC,MAAM,EAAE,cAAc;KACvB,CAAC,CAAC;IAEF,kBAA0B,CAAC,oBAAoB,GAAG,KAAK,IAAI,EAAE,GAAE,CAAC,CAAC;IAElE,OAAO,IAAI,oBAAoB,CAAC;QAC9B,cAAc,EAAE,kBAAkB;QAClC,MAAM,EAAE,IAAI;QACZ,GAAG,SAAS;KACb,CAAC,CAAC;AACL,CAAC"}

package/dist/bundled-agents/governance-dashboard-agents/dist/agents/governance-audit/index.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Governance Audit Agent
+ *
+ * Classification: GOVERNANCE_AUDIT
+ * Decision Type: audit_summary
+ *
+ * Purpose:
+ * Provide audit and compliance visibility across governance policies,
+ * decision trails, and organizational adherence.
+ *
+ * This agent:
+ * - Aggregates governance audit signals
+ * - Evaluates compliance status across policies
+ * - Measures policy coverage and gaps
+ * - Produces audit summary scores
+ * - Generates compliance recommendations
+ *
+ * This agent MUST NOT:
+ * - Enforce policies
+ * - Modify configurations
+ * - Approve or reject changes
+ * - Connect directly to Google SQL
+ * - Execute SQL queries
+ */
+export { GovernanceAuditAgent } from './agent.js';
+export { createGovernanceAuditAgent, createGovernanceAuditAgentFromEnv, createGovernanceAuditAgentForTesting, } from './factory.js';
+export * from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/bundled-agents/governance-dashboard-agents/dist/agents/governance-audit/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/agents/governance-audit/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,OAAO,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAClD,OAAO,EACL,0BAA0B,EAC1B,iCAAiC,EACjC,oCAAoC,GACrC,MAAM,cAAc,CAAC;AACtB,cAAc,YAAY,CAAC"}

package/dist/bundled-agents/governance-dashboard-agents/dist/agents/governance-audit/index.js

@@ -0,0 +1,28 @@
+/**
+ * Governance Audit Agent
+ *
+ * Classification: GOVERNANCE_AUDIT
+ * Decision Type: audit_summary
+ *
+ * Purpose:
+ * Provide audit and compliance visibility across governance policies,
+ * decision trails, and organizational adherence.
+ *
+ * This agent:
+ * - Aggregates governance audit signals
+ * - Evaluates compliance status across policies
+ * - Measures policy coverage and gaps
+ * - Produces audit summary scores
+ * - Generates compliance recommendations
+ *
+ * This agent MUST NOT:
+ * - Enforce policies
+ * - Modify configurations
+ * - Approve or reject changes
+ * - Connect directly to Google SQL
+ * - Execute SQL queries
+ */
+export { GovernanceAuditAgent } from './agent.js';
+export { createGovernanceAuditAgent, createGovernanceAuditAgentFromEnv, createGovernanceAuditAgentForTesting, } from './factory.js';
+export * from './types.js';
+//# sourceMappingURL=index.js.map

package/dist/bundled-agents/governance-dashboard-agents/dist/agents/governance-audit/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/agents/governance-audit/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,OAAO,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAClD,OAAO,EACL,0BAA0B,EAC1B,iCAAiC,EACjC,oCAAoC,GACrC,MAAM,cAAc,CAAC;AACtB,cAAc,YAAY,CAAC"}

package/dist/bundled-agents/governance-dashboard-agents/dist/agents/governance-audit/types.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Governance Audit Agent Internal Types
+ *
+ * Internal types used by the Governance Audit Agent implementation.
+ */
+import type { AuditFinding, ComplianceStatus, PolicyCoverage } from '../../contracts/governance-audit.js';
+export type { GovernanceAuditInput, GovernanceAuditOutput, AuditFinding, AuditFindingSeverity, ComplianceStatus, PolicyCoverage, AuditCategory, DecisionTrailRecord, PolicySnapshot, } from '../../contracts/governance-audit.js';
+export { GOVERNANCE_AUDIT_AGENT_METADATA, validateGovernanceAuditInput, validateGovernanceAuditOutput, GovernanceAuditInputSchema, GovernanceAuditOutputSchema, } from '../../contracts/governance-audit.js';
+/**
+ * Internal audit analysis state
+ */
+export interface AuditAnalysisState {
+    totalDecisions: number;
+    compliantDecisions: number;
+    nonCompliantDecisions: number;
+    pendingApprovals: number;
+    categoryCounts: Map<string, {
+        total: number;
+        compliant: number;
+    }>;
+}
+/**
+ * Compliance evaluation result
+ */
+export interface ComplianceEvaluationResult {
+    statuses: ComplianceStatus[];
+    overallCompliance: number;
+}
+/**
+ * Coverage analysis result
+ */
+export interface CoverageAnalysisResult {
+    coverages: PolicyCoverage[];
+    overallCoverage: number;
+}
+/**
+ * Finding detection result
+ */
+export interface FindingDetectionResult {
+    findings: AuditFinding[];
+    criticalCount: number;
+    highCount: number;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/bundled-agents/governance-dashboard-agents/dist/agents/governance-audit/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/agents/governance-audit/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EACV,YAAY,EACZ,gBAAgB,EAChB,cAAc,EACf,MAAM,qCAAqC,CAAC;AAG7C,YAAY,EACV,oBAAoB,EACpB,qBAAqB,EACrB,YAAY,EACZ,oBAAoB,EACpB,gBAAgB,EAChB,cAAc,EACd,aAAa,EACb,mBAAmB,EACnB,cAAc,GACf,MAAM,qCAAqC,CAAC;AAE7C,OAAO,EACL,+BAA+B,EAC/B,4BAA4B,EAC5B,6BAA6B,EAC7B,0BAA0B,EAC1B,2BAA2B,GAC5B,MAAM,qCAAqC,CAAC;AAE7C;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,cAAc,EAAE,MAAM,CAAC;IACvB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,qBAAqB,EAAE,MAAM,CAAC;IAC9B,gBAAgB,EAAE,MAAM,CAAC;IACzB,cAAc,EAAE,GAAG,CAAC,MAAM,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACnE;AAED;;GAEG;AACH,MAAM,WAAW,0BAA0B;IACzC,QAAQ,EAAE,gBAAgB,EAAE,CAAC;IAC7B,iBAAiB,EAAE,MAAM,CAAC;CAC3B;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,SAAS,EAAE,cAAc,EAAE,CAAC;IAC5B,eAAe,EAAE,MAAM,CAAC;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,QAAQ,EAAE,YAAY,EAAE,CAAC;IACzB,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;CACnB"}

package/dist/bundled-agents/governance-dashboard-agents/dist/agents/governance-audit/types.js

@@ -0,0 +1,7 @@
+/**
+ * Governance Audit Agent Internal Types
+ *
+ * Internal types used by the Governance Audit Agent implementation.
+ */
+export { GOVERNANCE_AUDIT_AGENT_METADATA, validateGovernanceAuditInput, validateGovernanceAuditOutput, GovernanceAuditInputSchema, GovernanceAuditOutputSchema, } from '../../contracts/governance-audit.js';
+//# sourceMappingURL=types.js.map

package/dist/bundled-agents/governance-dashboard-agents/dist/agents/governance-audit/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/agents/governance-audit/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAqBH,OAAO,EACL,+BAA+B,EAC/B,4BAA4B,EAC5B,6BAA6B,EAC7B,0BAA0B,EAC1B,2BAA2B,GAC5B,MAAM,qCAAqC,CAAC"}

package/dist/bundled-agents/governance-dashboard-agents/dist/agents/usage-oversight/agent.d.ts

@@ -0,0 +1,89 @@
+/**
+ * Usage Oversight Agent Implementation
+ *
+ * Core agent logic for usage pattern analysis and governance oversight.
+ */
+import type { GovernanceAgent, AgentMetadata, AgentContext, AgentResult } from '../../contracts/base-agent.js';
+import type { UsageOversightInput, UsageOversightOutput } from '../../contracts/usage-oversight.js';
+import { TelemetryEmitter } from '../../infrastructure/telemetry.js';
+import type { RuvectorClient } from '../../infrastructure/ruvector-client.js';
+/**
+ * Usage Oversight Agent Configuration
+ */
+export interface UsageOversightAgentConfig {
+    /** RuVector client for persistence */
+    ruvectorClient: RuvectorClient;
+    /** Optional telemetry emitter */
+    telemetryEmitter?: TelemetryEmitter;
+    /** Dry-run mode (no persistence) */
+    dryRun?: boolean;
+    /** Thresholds for pattern detection */
+    thresholds?: {
+        budgetWarningPercent?: number;
+        budgetCriticalPercent?: number;
+        quotaWarningPercent?: number;
+        quotaCriticalPercent?: number;
+        costAnomalyStdDev?: number;
+        usageSpikeMultiplier?: number;
+    };
+}
+/**
+ * Usage Oversight Agent
+ *
+ * Analyzes LLM usage patterns and produces governance oversight signals.
+ */
+export declare class UsageOversightAgent implements GovernanceAgent<UsageOversightInput, UsageOversightOutput> {
+    readonly metadata: AgentMetadata;
+    private readonly decisionEventEmitter;
+    private readonly telemetry?;
+    private readonly thresholds;
+    constructor(config: UsageOversightAgentConfig);
+    /**
+     * Execute the Usage Oversight Agent
+     */
+    execute(input: UsageOversightInput, context: AgentContext): Promise<AgentResult<UsageOversightOutput>>;
+    /**
+     * Validate input against schema
+     */
+    validateInput(input: unknown): UsageOversightInput;
+    /**
+     * Validate output against schema
+     */
+    validateOutput(output: unknown): UsageOversightOutput;
+    /**
+     * Health check
+     */
+    healthCheck(): Promise<{
+        healthy: boolean;
+        details?: Record<string, unknown>;
+    }>;
+    /**
+     * Core analysis logic
+     */
+    private analyze;
+    /**
+     * Aggregate usage data into summary
+     */
+    private aggregateUsage;
+    /**
+     * Detect out-of-policy patterns
+     */
+    private detectPatterns;
+    /**
+     * Evaluate policy adherence
+     */
+    private evaluatePolicies;
+    /**
+     * Calculate governance health score
+     */
+    private calculateHealthScore;
+    /**
+     * Generate recommendations
+     */
+    private generateRecommendations;
+    /**
+     * Calculate confidence metrics for the analysis
+     */
+    private calculateConfidence;
+}
+//# sourceMappingURL=agent.d.ts.map

package/dist/bundled-agents/governance-dashboard-agents/dist/agents/usage-oversight/agent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent.d.ts","sourceRoot":"","sources":["../../../src/agents/usage-oversight/agent.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EACV,eAAe,EACf,aAAa,EACb,YAAY,EACZ,WAAW,EACZ,MAAM,+BAA+B,CAAC;AACvC,OAAO,KAAK,EACV,mBAAmB,EACnB,oBAAoB,EAMrB,MAAM,oCAAoC,CAAC;AAQ5C,OAAO,EAAE,gBAAgB,EAAE,MAAM,mCAAmC,CAAC;AACrE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,yCAAyC,CAAC;AAQ9E;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACxC,sCAAsC;IACtC,cAAc,EAAE,cAAc,CAAC;IAC/B,iCAAiC;IACjC,gBAAgB,CAAC,EAAE,gBAAgB,CAAC;IACpC,oCAAoC;IACpC,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,uCAAuC;IACvC,UAAU,CAAC,EAAE;QACX,oBAAoB,CAAC,EAAE,MAAM,CAAC;QAC9B,qBAAqB,CAAC,EAAE,MAAM,CAAC;QAC/B,mBAAmB,CAAC,EAAE,MAAM,CAAC;QAC7B,oBAAoB,CAAC,EAAE,MAAM,CAAC;QAC9B,iBAAiB,CAAC,EAAE,MAAM,CAAC;QAC3B,oBAAoB,CAAC,EAAE,MAAM,CAAC;KAC/B,CAAC;CACH;AAcD;;;;GAIG;AACH,qBAAa,mBACX,YAAW,eAAe,CAAC,mBAAmB,EAAE,oBAAoB,CAAC;IAErE,QAAQ,CAAC,QAAQ,EAAE,aAAa,CAAC;IACjC,OAAO,CAAC,QAAQ,CAAC,oBAAoB,CAAuB;IAC5D,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAmB;IAC9C,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAiE;gBAEhF,MAAM,EAAE,yBAAyB;IAqB7C;;OAEG;IACG,OAAO,CACX,KAAK,EAAE,mBAAmB,EAC1B,OAAO,EAAE,YAAY,GACpB,OAAO,CAAC,WAAW,CAAC,oBAAoB,CAAC,CAAC;IA2G7C;;OAEG;IACH,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,mBAAmB;IAIlD;;OAEG;IACH,cAAc,CAAC,MAAM,EAAE,OAAO,GAAG,oBAAoB;IAIrD;;OAEG;IACG,WAAW,IAAI,OAAO,CAAC;QAC3B,OAAO,EAAE,OAAO,CAAC;QACjB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KACnC,CAAC;IAKF;;OAEG;YACW,OAAO;IAyCrB;;OAEG;IACH,OAAO,CAAC,cAAc;IAoHtB;;OAEG;IACH,OAAO,CAAC,cAAc;IA6ItB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IA4ExB;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAoC5B;;OAEG;IACH,OAAO,CAAC,uBAAuB;IAsD/B;;OAEG;IACH,OAAO,CAAC,mBAAmB;CAoB5B"}