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

package/dist/bundled-agents/data-vault-agents/dist/runtime/performance-budget.d.ts

@@ -0,0 +1,143 @@
+/**
+ * LLM-Data-Vault: Performance Budget Enforcement
+ *
+ * Phase 7 performance budget enforcement for agent executions.
+ * Ensures agents operate within defined resource constraints.
+ *
+ * BUDGETS:
+ * - MAX_TOKENS: 2500 (max tokens per response if applicable)
+ * - MAX_LATENCY_MS: 5000 (max execution time)
+ * - MAX_CALLS_PER_RUN: 5 (max external service calls per execution)
+ *
+ * @module runtime/performance-budget
+ */
+import { DecisionEvent } from '../contracts/index.js';
+/**
+ * Performance budget configuration
+ */
+export interface PerformanceBudget {
+    /** Maximum execution latency in milliseconds */
+    maxLatencyMs: number;
+    /** Maximum external service calls per execution */
+    maxCallsPerRun: number;
+    /** Maximum tokens per response (if applicable) */
+    maxTokens: number;
+}
+/**
+ * Default performance budgets for Phase 7 agents
+ */
+export declare const DEFAULT_BUDGETS: PerformanceBudget;
+/**
+ * Budget violation reason
+ */
+export type BudgetViolationReason = 'latency_exceeded' | 'calls_exceeded' | 'tokens_exceeded';
+/**
+ * Budget check result
+ */
+export interface BudgetCheckResult {
+    withinBudget: boolean;
+    violation?: {
+        reason: BudgetViolationReason;
+        limit: number;
+        actual: number;
+        message: string;
+    };
+}
+/**
+ * Budget enforcer metrics
+ */
+export interface BudgetMetrics {
+    callCount: number;
+    startTime: number;
+    tokenCount: number;
+}
+/**
+ * Budget enforcement error
+ */
+export declare class BudgetExceededError extends Error {
+    readonly reason: BudgetViolationReason;
+    readonly limit: number;
+    readonly actual: number;
+    constructor(reason: BudgetViolationReason, limit: number, actual: number);
+}
+/**
+ * Performance budget enforcer
+ *
+ * Tracks and enforces performance budgets during agent execution.
+ * Aborts execution if any budget is exceeded.
+ */
+export declare class BudgetEnforcer {
+    private readonly budget;
+    private callCount;
+    private tokenCount;
+    private readonly startTime;
+    private aborted;
+    private abortReason?;
+    constructor(budget?: PerformanceBudget);
+    /**
+     * Get current budget configuration
+     */
+    getBudget(): PerformanceBudget;
+    /**
+     * Get current metrics
+     */
+    getMetrics(): BudgetMetrics;
+    /**
+     * Check if execution has been aborted
+     */
+    isAborted(): boolean;
+    /**
+     * Get abort reason if aborted
+     */
+    getAbortReason(): BudgetViolationReason | undefined;
+    /**
+     * Record an external service call
+     * @throws {BudgetExceededError} if calls budget exceeded
+     */
+    recordCall(): void;
+    /**
+     * Record token usage
+     * @throws {BudgetExceededError} if token budget exceeded
+     */
+    recordTokens(count: number): void;
+    /**
+     * Check current latency against budget
+     * @throws {BudgetExceededError} if latency budget exceeded
+     */
+    checkLatency(): void;
+    /**
+     * Get elapsed time in milliseconds
+     */
+    getElapsedMs(): number;
+    /**
+     * Check all budgets without throwing
+     */
+    checkAll(): BudgetCheckResult;
+    /**
+     * Create an abort DecisionEvent for budget exceeded
+     */
+    createAbortEvent(params: {
+        agentId: string;
+        agentVersion: string;
+        inputsHash: string;
+        executionRef: string;
+        correlationId?: string;
+        tenantId?: string;
+        requestSource?: 'orchestrator' | 'inference_gateway' | 'policy_engine' | 'governance' | 'cli' | 'api';
+    }): DecisionEvent;
+    /**
+     * Wrap an async operation with latency checking
+     */
+    withLatencyCheck<T>(operation: () => Promise<T>): Promise<T>;
+    /**
+     * Wrap an external call with budget tracking
+     */
+    trackCall<T>(operation: () => Promise<T>): Promise<T>;
+    private getLimitForReason;
+    private getActualForReason;
+}
+/**
+ * Create a budget enforcer with custom limits
+ */
+export declare function createBudgetEnforcer(overrides?: Partial<PerformanceBudget>): BudgetEnforcer;
+//# sourceMappingURL=performance-budget.d.ts.map

package/dist/bundled-agents/data-vault-agents/dist/runtime/performance-budget.d.ts.map

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

package/dist/bundled-agents/data-vault-agents/dist/runtime/performance-budget.js

@@ -0,0 +1,269 @@
+/**
+ * LLM-Data-Vault: Performance Budget Enforcement
+ *
+ * Phase 7 performance budget enforcement for agent executions.
+ * Ensures agents operate within defined resource constraints.
+ *
+ * BUDGETS:
+ * - MAX_TOKENS: 2500 (max tokens per response if applicable)
+ * - MAX_LATENCY_MS: 5000 (max execution time)
+ * - MAX_CALLS_PER_RUN: 5 (max external service calls per execution)
+ *
+ * @module runtime/performance-budget
+ */
+import { createDecisionEvent, } from '../contracts/index.js';
+/**
+ * Default performance budgets for Phase 7 agents
+ */
+export const DEFAULT_BUDGETS = {
+    maxLatencyMs: 5000,
+    maxCallsPerRun: 5,
+    maxTokens: 2500,
+};
+/**
+ * Budget enforcement error
+ */
+export class BudgetExceededError extends Error {
+    reason;
+    limit;
+    actual;
+    constructor(reason, limit, actual) {
+        const messages = {
+            latency_exceeded: `Execution time ${actual}ms exceeded budget of ${limit}ms`,
+            calls_exceeded: `External calls ${actual} exceeded budget of ${limit}`,
+            tokens_exceeded: `Token count ${actual} exceeded budget of ${limit}`,
+        };
+        super(messages[reason]);
+        this.name = 'BudgetExceededError';
+        this.reason = reason;
+        this.limit = limit;
+        this.actual = actual;
+    }
+}
+/**
+ * Performance budget enforcer
+ *
+ * Tracks and enforces performance budgets during agent execution.
+ * Aborts execution if any budget is exceeded.
+ */
+export class BudgetEnforcer {
+    budget;
+    callCount = 0;
+    tokenCount = 0;
+    startTime;
+    aborted = false;
+    abortReason;
+    constructor(budget = DEFAULT_BUDGETS) {
+        this.budget = { ...budget };
+        this.startTime = performance.now();
+    }
+    /**
+     * Get current budget configuration
+     */
+    getBudget() {
+        return { ...this.budget };
+    }
+    /**
+     * Get current metrics
+     */
+    getMetrics() {
+        return {
+            callCount: this.callCount,
+            startTime: this.startTime,
+            tokenCount: this.tokenCount,
+        };
+    }
+    /**
+     * Check if execution has been aborted
+     */
+    isAborted() {
+        return this.aborted;
+    }
+    /**
+     * Get abort reason if aborted
+     */
+    getAbortReason() {
+        return this.abortReason;
+    }
+    /**
+     * Record an external service call
+     * @throws {BudgetExceededError} if calls budget exceeded
+     */
+    recordCall() {
+        if (this.aborted) {
+            throw new BudgetExceededError(this.abortReason, this.getLimitForReason(this.abortReason), this.getActualForReason(this.abortReason));
+        }
+        this.callCount++;
+        if (this.callCount > this.budget.maxCallsPerRun) {
+            this.aborted = true;
+            this.abortReason = 'calls_exceeded';
+            throw new BudgetExceededError('calls_exceeded', this.budget.maxCallsPerRun, this.callCount);
+        }
+    }
+    /**
+     * Record token usage
+     * @throws {BudgetExceededError} if token budget exceeded
+     */
+    recordTokens(count) {
+        if (this.aborted) {
+            throw new BudgetExceededError(this.abortReason, this.getLimitForReason(this.abortReason), this.getActualForReason(this.abortReason));
+        }
+        this.tokenCount += count;
+        if (this.tokenCount > this.budget.maxTokens) {
+            this.aborted = true;
+            this.abortReason = 'tokens_exceeded';
+            throw new BudgetExceededError('tokens_exceeded', this.budget.maxTokens, this.tokenCount);
+        }
+    }
+    /**
+     * Check current latency against budget
+     * @throws {BudgetExceededError} if latency budget exceeded
+     */
+    checkLatency() {
+        if (this.aborted) {
+            throw new BudgetExceededError(this.abortReason, this.getLimitForReason(this.abortReason), this.getActualForReason(this.abortReason));
+        }
+        const elapsed = performance.now() - this.startTime;
+        if (elapsed > this.budget.maxLatencyMs) {
+            this.aborted = true;
+            this.abortReason = 'latency_exceeded';
+            throw new BudgetExceededError('latency_exceeded', this.budget.maxLatencyMs, Math.round(elapsed));
+        }
+    }
+    /**
+     * Get elapsed time in milliseconds
+     */
+    getElapsedMs() {
+        return performance.now() - this.startTime;
+    }
+    /**
+     * Check all budgets without throwing
+     */
+    checkAll() {
+        const elapsed = Math.round(performance.now() - this.startTime);
+        // Check latency
+        if (elapsed > this.budget.maxLatencyMs) {
+            return {
+                withinBudget: false,
+                violation: {
+                    reason: 'latency_exceeded',
+                    limit: this.budget.maxLatencyMs,
+                    actual: elapsed,
+                    message: `Execution time ${elapsed}ms exceeded budget of ${this.budget.maxLatencyMs}ms`,
+                },
+            };
+        }
+        // Check calls
+        if (this.callCount > this.budget.maxCallsPerRun) {
+            return {
+                withinBudget: false,
+                violation: {
+                    reason: 'calls_exceeded',
+                    limit: this.budget.maxCallsPerRun,
+                    actual: this.callCount,
+                    message: `External calls ${this.callCount} exceeded budget of ${this.budget.maxCallsPerRun}`,
+                },
+            };
+        }
+        // Check tokens
+        if (this.tokenCount > this.budget.maxTokens) {
+            return {
+                withinBudget: false,
+                violation: {
+                    reason: 'tokens_exceeded',
+                    limit: this.budget.maxTokens,
+                    actual: this.tokenCount,
+                    message: `Token count ${this.tokenCount} exceeded budget of ${this.budget.maxTokens}`,
+                },
+            };
+        }
+        return { withinBudget: true };
+    }
+    /**
+     * Create an abort DecisionEvent for budget exceeded
+     */
+    createAbortEvent(params) {
+        const result = this.checkAll();
+        const violation = result.violation;
+        const constraint = {
+            type: 'budget_exceeded',
+            description: violation?.message ?? 'Performance budget exceeded',
+            severity: 'error',
+            metadata: violation
+                ? {
+                    reason: violation.reason,
+                    limit: violation.limit,
+                    actual: violation.actual,
+                }
+                : undefined,
+        };
+        return createDecisionEvent({
+            agent_id: params.agentId,
+            agent_version: params.agentVersion,
+            decision_type: 'execution_aborted',
+            inputs_hash: params.inputsHash,
+            outputs: {
+                aborted: true,
+                reason: violation?.reason ?? 'budget_exceeded',
+                budget_limit: violation?.limit,
+                budget_actual: violation?.actual,
+                execution_time_ms: Math.round(this.getElapsedMs()),
+            },
+            confidence: { policy_match: 0 },
+            constraints_applied: [constraint],
+            execution_ref: params.executionRef,
+            correlation_id: params.correlationId,
+            tenant_id: params.tenantId,
+            request_source: params.requestSource,
+        });
+    }
+    /**
+     * Wrap an async operation with latency checking
+     */
+    async withLatencyCheck(operation) {
+        this.checkLatency();
+        const result = await operation();
+        this.checkLatency();
+        return result;
+    }
+    /**
+     * Wrap an external call with budget tracking
+     */
+    async trackCall(operation) {
+        this.recordCall();
+        this.checkLatency();
+        const result = await operation();
+        this.checkLatency();
+        return result;
+    }
+    getLimitForReason(reason) {
+        switch (reason) {
+            case 'latency_exceeded':
+                return this.budget.maxLatencyMs;
+            case 'calls_exceeded':
+                return this.budget.maxCallsPerRun;
+            case 'tokens_exceeded':
+                return this.budget.maxTokens;
+        }
+    }
+    getActualForReason(reason) {
+        switch (reason) {
+            case 'latency_exceeded':
+                return Math.round(this.getElapsedMs());
+            case 'calls_exceeded':
+                return this.callCount;
+            case 'tokens_exceeded':
+                return this.tokenCount;
+        }
+    }
+}
+/**
+ * Create a budget enforcer with custom limits
+ */
+export function createBudgetEnforcer(overrides = {}) {
+    return new BudgetEnforcer({
+        ...DEFAULT_BUDGETS,
+        ...overrides,
+    });
+}
+//# sourceMappingURL=performance-budget.js.map

package/dist/bundled-agents/data-vault-agents/dist/runtime/performance-budget.js.map

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

package/dist/bundled-agents/data-vault-agents/dist/ruvector-client/index.d.ts

@@ -0,0 +1,111 @@
+/**
+ * LLM-Data-Vault: RuVector Service Client
+ *
+ * Client for persisting DecisionEvents to ruvector-service.
+ * This is the ONLY persistence mechanism allowed for Data-Vault agents.
+ *
+ * CONSTITUTIONAL REQUIREMENT:
+ * - Data-Vault agents MUST NOT connect directly to Google SQL
+ * - Data-Vault agents persist data ONLY via ruvector-service client calls
+ *
+ * @module ruvector-client
+ */
+import { DecisionEvent } from '../contracts/index.js';
+/**
+ * RuVector service configuration
+ */
+export interface RuVectorConfig {
+    /** Service endpoint URL */
+    endpoint: string;
+    /** API key for authentication */
+    apiKey: string;
+    /** Request timeout in milliseconds */
+    timeout?: number;
+    /** Number of retry attempts */
+    retries?: number;
+    /** Retry backoff multiplier */
+    retryBackoff?: number;
+}
+/**
+ * RuVector persistence result
+ */
+export interface PersistResult {
+    success: boolean;
+    event_id?: string;
+    timestamp?: string;
+    error?: {
+        code: string;
+        message: string;
+        retryable: boolean;
+    };
+}
+/**
+ * RuVector query options
+ */
+export interface QueryOptions {
+    tenant_id?: string;
+    agent_id?: string;
+    decision_type?: string;
+    from_timestamp?: string;
+    to_timestamp?: string;
+    limit?: number;
+    offset?: number;
+}
+/**
+ * RuVector query result
+ */
+export interface QueryResult {
+    events: DecisionEvent[];
+    total_count: number;
+    has_more: boolean;
+}
+/**
+ * RuVector Service Client
+ *
+ * Provides async, non-blocking persistence for DecisionEvents.
+ */
+export declare class RuVectorClient {
+    private readonly config;
+    constructor(config: RuVectorConfig);
+    /**
+     * Persist a DecisionEvent to ruvector-service
+     *
+     * This is an async, non-blocking write operation.
+     */
+    persistDecisionEvent(event: DecisionEvent): Promise<PersistResult>;
+    /**
+     * Batch persist multiple DecisionEvents
+     */
+    persistBatch(events: DecisionEvent[]): Promise<PersistResult[]>;
+    /**
+     * Query DecisionEvents (for audit/governance consumption)
+     */
+    queryEvents(options?: QueryOptions): Promise<QueryResult>;
+    /**
+     * Get a single DecisionEvent by ID
+     */
+    getEvent(eventId: string): Promise<DecisionEvent | null>;
+    /**
+     * Health check
+     */
+    healthCheck(): Promise<{
+        healthy: boolean;
+        latency_ms: number;
+    }>;
+    /**
+     * Make HTTP request to ruvector-service
+     */
+    private makeRequest;
+}
+/**
+ * Create RuVector client from environment
+ *
+ * STANDARDIZED ENVIRONMENT VARIABLES (matching Google Secret Manager names):
+ * - RUVECTOR_SERVICE_URL: Service endpoint URL (required)
+ * - RUVECTOR_API_KEY: API key for authentication (required, from Secret Manager)
+ *
+ * NOTE: Legacy variable names (RUVECTOR_SERVICE_ENDPOINT, RUVECTOR_SERVICE_API_KEY)
+ * are supported for backward compatibility but deprecated.
+ */
+export declare function createRuVectorClient(): RuVectorClient;
+//# sourceMappingURL=index.d.ts.map

package/dist/bundled-agents/data-vault-agents/dist/ruvector-client/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/ruvector-client/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,aAAa,EAAyB,MAAM,uBAAuB,CAAC;AAE7E;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,2BAA2B;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,iCAAiC;IACjC,MAAM,EAAE,MAAM,CAAC;IACf,sCAAsC;IACtC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,+BAA+B;IAC/B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,+BAA+B;IAC/B,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE;QACN,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,MAAM,CAAC;QAChB,SAAS,EAAE,OAAO,CAAC;KACpB,CAAC;CACH;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,aAAa,EAAE,CAAC;IACxB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED;;;;GAIG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA2B;gBAEtC,MAAM,EAAE,cAAc;IAUlC;;;;OAIG;IACG,oBAAoB,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC,aAAa,CAAC;IA0DxE;;OAEG;IACG,YAAY,CAAC,MAAM,EAAE,aAAa,EAAE,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC;IAyCrE;;OAEG;IACG,WAAW,CAAC,OAAO,GAAE,YAAiB,GAAG,OAAO,CAAC,WAAW,CAAC;IAqBnE;;OAEG;IACG,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC;IAgB9D;;OAEG;IACG,WAAW,IAAI,OAAO,CAAC;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,CAAC;IAoBtE;;OAEG;YACW,WAAW;CAsB1B;AAED;;;;;;;;;GASG;AACH,wBAAgB,oBAAoB,IAAI,cAAc,CA4BrD"}