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

package/dist/bundled-agents/governance-dashboard-agents/dist/infrastructure/execution-span-manager.d.ts

@@ -0,0 +1,86 @@
+/**
+ * Execution Span Manager
+ *
+ * Stateless utility functions for creating, managing, and finalizing
+ * execution spans. Each handler invocation constructs its own span tree.
+ *
+ * This module enforces the Foundational Execution Unit contract:
+ * - Every externally-invoked operation requires execution context
+ * - Repo-level spans wrap all agent executions
+ * - Agent-level spans are mandatory for every agent that executes
+ * - Artifacts are attached at the agent level only
+ * - No agent spans = execution is INVALID
+ */
+import type { RepoSpan, AgentSpan } from '../contracts/execution-span.js';
+/**
+ * Execution context extracted from incoming request headers.
+ */
+export interface ExecutionContext {
+    execution_id: string;
+    parent_span_id: string;
+}
+/**
+ * Extract execution context from request headers.
+ * Returns null if required parent_span_id is missing.
+ *
+ * Required: x-parent-span-id
+ * execution_id: x-execution-id (preferred) or x-request-id (fallback)
+ */
+export declare function extractExecutionContext(headers: Record<string, string | string[] | undefined>): ExecutionContext | null;
+/**
+ * Create a new repo-level span.
+ * Called once per handler invocation.
+ */
+export declare function createRepoSpan(ctx: ExecutionContext): RepoSpan;
+/**
+ * Create a new agent-level span.
+ * parent_span_id is always the repo span's span_id.
+ */
+export declare function createAgentSpan(repoSpan: RepoSpan, agentName: string): AgentSpan;
+/**
+ * Attach an artifact (e.g. DecisionEvent) to an agent span.
+ * Artifacts MUST be attached at the agent level, never at repo level.
+ */
+export declare function attachArtifact(agentSpan: AgentSpan, artifactType: string, data: Record<string, unknown>): void;
+/**
+ * Finalize an agent span as COMPLETED.
+ */
+export declare function completeAgentSpan(agentSpan: AgentSpan): void;
+/**
+ * Finalize an agent span as FAILED with error details.
+ */
+export declare function failAgentSpan(agentSpan: AgentSpan, error: {
+    code: string;
+    message: string;
+    details?: Record<string, unknown>;
+}): void;
+/**
+ * Finalize the repo span.
+ *
+ * ENFORCEMENT:
+ * - If no agent spans were emitted, status is FAILED (execution is INVALID)
+ * - If any agent span is FAILED, repo span is FAILED
+ * - Only COMPLETED if all agent spans are COMPLETED
+ * - All emitted spans are preserved regardless of status
+ */
+export declare function finalizeRepoSpan(repoSpan: RepoSpan): void;
+/**
+ * Build the execution response envelope.
+ * This is the ONLY shape that handlers return for agent execution routes.
+ */
+export declare function buildExecutionResponse(repoSpan: RepoSpan, result?: Record<string, unknown>): {
+    execution_id: string;
+    repo_span: RepoSpan;
+    result?: Record<string, unknown>;
+};
+/**
+ * Build a rejection response for when execution context is missing.
+ */
+export declare function buildContextRejectionResponse(): {
+    error: {
+        code: string;
+        message: string;
+        required_headers: string[];
+    };
+};
+//# sourceMappingURL=execution-span-manager.d.ts.map

package/dist/bundled-agents/governance-dashboard-agents/dist/infrastructure/execution-span-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"execution-span-manager.d.ts","sourceRoot":"","sources":["../../src/infrastructure/execution-span-manager.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAGH,OAAO,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAgB,MAAM,gCAAgC,CAAC;AAIxF;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,MAAM,CAAC;CACxB;AAED;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,SAAS,CAAC,GACrD,gBAAgB,GAAG,IAAI,CAazB;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,gBAAgB,GAAG,QAAQ,CAY9D;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAC7B,QAAQ,EAAE,QAAQ,EAClB,SAAS,EAAE,MAAM,GAChB,SAAS,CAYX;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAC5B,SAAS,EAAE,SAAS,EACpB,YAAY,EAAE,MAAM,EACpB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC5B,IAAI,CAON;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,SAAS,GAAG,IAAI,CAG5D;AAED;;GAEG;AACH,wBAAgB,aAAa,CAC3B,SAAS,EAAE,SAAS,EACpB,KAAK,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE,GAC1E,IAAI,CAIN;AAED;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,QAAQ,GAAG,IAAI,CA4BzD;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,QAAQ,EAClB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC/B;IACD,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,QAAQ,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClC,CAMA;AAED;;GAEG;AACH,wBAAgB,6BAA6B,IAAI;IAC/C,KAAK,EAAE;QACL,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,MAAM,CAAC;QAChB,gBAAgB,EAAE,MAAM,EAAE,CAAC;KAC5B,CAAC;CACH,CAUA"}

package/dist/bundled-agents/governance-dashboard-agents/dist/infrastructure/execution-span-manager.js

@@ -0,0 +1,161 @@
+/**
+ * Execution Span Manager
+ *
+ * Stateless utility functions for creating, managing, and finalizing
+ * execution spans. Each handler invocation constructs its own span tree.
+ *
+ * This module enforces the Foundational Execution Unit contract:
+ * - Every externally-invoked operation requires execution context
+ * - Repo-level spans wrap all agent executions
+ * - Agent-level spans are mandatory for every agent that executes
+ * - Artifacts are attached at the agent level only
+ * - No agent spans = execution is INVALID
+ */
+import { generateUUID, getCurrentTimestamp } from '../contracts/validation.js';
+const REPO_NAME = 'llm-governance-dashboard';
+/**
+ * Extract execution context from request headers.
+ * Returns null if required parent_span_id is missing.
+ *
+ * Required: x-parent-span-id
+ * execution_id: x-execution-id (preferred) or x-request-id (fallback)
+ */
+export function extractExecutionContext(headers) {
+    const parentSpanId = asString(headers['x-parent-span-id']);
+    if (!parentSpanId) {
+        return null;
+    }
+    const executionId = asString(headers['x-execution-id'])
+        ?? asString(headers['x-request-id']);
+    if (!executionId) {
+        return null;
+    }
+    return { execution_id: executionId, parent_span_id: parentSpanId };
+}
+/**
+ * Create a new repo-level span.
+ * Called once per handler invocation.
+ */
+export function createRepoSpan(ctx) {
+    return {
+        type: 'repo',
+        span_id: generateUUID(),
+        parent_span_id: ctx.parent_span_id,
+        execution_id: ctx.execution_id,
+        repo_name: REPO_NAME,
+        status: 'RUNNING',
+        start_time: getCurrentTimestamp(),
+        end_time: undefined,
+        agent_spans: [],
+    };
+}
+/**
+ * Create a new agent-level span.
+ * parent_span_id is always the repo span's span_id.
+ */
+export function createAgentSpan(repoSpan, agentName) {
+    return {
+        type: 'agent',
+        span_id: generateUUID(),
+        parent_span_id: repoSpan.span_id,
+        agent_name: agentName,
+        repo_name: REPO_NAME,
+        status: 'RUNNING',
+        start_time: getCurrentTimestamp(),
+        end_time: undefined,
+        artifacts: [],
+    };
+}
+/**
+ * Attach an artifact (e.g. DecisionEvent) to an agent span.
+ * Artifacts MUST be attached at the agent level, never at repo level.
+ */
+export function attachArtifact(agentSpan, artifactType, data) {
+    const artifact = {
+        artifact_id: generateUUID(),
+        artifact_type: artifactType,
+        data,
+    };
+    agentSpan.artifacts.push(artifact);
+}
+/**
+ * Finalize an agent span as COMPLETED.
+ */
+export function completeAgentSpan(agentSpan) {
+    agentSpan.status = 'COMPLETED';
+    agentSpan.end_time = getCurrentTimestamp();
+}
+/**
+ * Finalize an agent span as FAILED with error details.
+ */
+export function failAgentSpan(agentSpan, error) {
+    agentSpan.status = 'FAILED';
+    agentSpan.end_time = getCurrentTimestamp();
+    agentSpan.error = error;
+}
+/**
+ * Finalize the repo span.
+ *
+ * ENFORCEMENT:
+ * - If no agent spans were emitted, status is FAILED (execution is INVALID)
+ * - If any agent span is FAILED, repo span is FAILED
+ * - Only COMPLETED if all agent spans are COMPLETED
+ * - All emitted spans are preserved regardless of status
+ */
+export function finalizeRepoSpan(repoSpan) {
+    repoSpan.end_time = getCurrentTimestamp();
+    if (repoSpan.agent_spans.length === 0) {
+        repoSpan.status = 'FAILED';
+        repoSpan.error = {
+            code: 'NO_AGENT_SPANS',
+            message: 'Execution completed without any agent spans. This is forbidden.',
+        };
+        return;
+    }
+    const hasFailedAgent = repoSpan.agent_spans.some((s) => s.status === 'FAILED');
+    if (hasFailedAgent) {
+        repoSpan.status = 'FAILED';
+        const failedAgents = repoSpan.agent_spans
+            .filter((s) => s.status === 'FAILED')
+            .map((s) => s.agent_name);
+        repoSpan.error = {
+            code: 'AGENT_EXECUTION_FAILED',
+            message: `Agent(s) failed: ${failedAgents.join(', ')}`,
+        };
+    }
+    else {
+        repoSpan.status = 'COMPLETED';
+    }
+}
+/**
+ * Build the execution response envelope.
+ * This is the ONLY shape that handlers return for agent execution routes.
+ */
+export function buildExecutionResponse(repoSpan, result) {
+    return {
+        execution_id: repoSpan.execution_id,
+        repo_span: repoSpan,
+        result,
+    };
+}
+/**
+ * Build a rejection response for when execution context is missing.
+ */
+export function buildContextRejectionResponse() {
+    return {
+        error: {
+            code: 'MISSING_EXECUTION_CONTEXT',
+            message: 'Execution rejected: parent_span_id is required. '
+                + 'This repo is a Foundational Execution Unit and must be invoked with execution context.',
+            required_headers: ['x-execution-id', 'x-parent-span-id'],
+        },
+    };
+}
+function asString(value) {
+    if (typeof value === 'string')
+        return value;
+    if (Array.isArray(value) && value.length > 0)
+        return value[0];
+    return undefined;
+}
+//# sourceMappingURL=execution-span-manager.js.map

package/dist/bundled-agents/governance-dashboard-agents/dist/infrastructure/execution-span-manager.js.map

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

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

@@ -0,0 +1,13 @@
+/**
+ * Infrastructure Module
+ *
+ * Provides shared infrastructure components for governance agents:
+ * - RuVector client for persistence
+ * - DecisionEvent emitter
+ * - Telemetry integration
+ */
+export * from './ruvector-client.js';
+export * from './decision-event-emitter.js';
+export * from './telemetry.js';
+export * from './execution-span-manager.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/infrastructure/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,cAAc,sBAAsB,CAAC;AACrC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,gBAAgB,CAAC;AAC/B,cAAc,6BAA6B,CAAC"}

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

@@ -0,0 +1,13 @@
+/**
+ * Infrastructure Module
+ *
+ * Provides shared infrastructure components for governance agents:
+ * - RuVector client for persistence
+ * - DecisionEvent emitter
+ * - Telemetry integration
+ */
+export * from './ruvector-client.js';
+export * from './decision-event-emitter.js';
+export * from './telemetry.js';
+export * from './execution-span-manager.js';
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/infrastructure/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,cAAc,sBAAsB,CAAC;AACrC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,gBAAgB,CAAC;AAC/B,cAAc,6BAA6B,CAAC"}

package/dist/bundled-agents/governance-dashboard-agents/dist/infrastructure/ruvector-client.d.ts

@@ -0,0 +1,108 @@
+/**
+ * RuVector Service Client
+ *
+ * Client for persisting governance artifacts to ruvector-service.
+ * ruvector-service is backed by Google SQL (Postgres).
+ *
+ * IMPORTANT:
+ * - LLM-Governance-Dashboard NEVER connects directly to Google SQL
+ * - LLM-Governance-Dashboard NEVER executes SQL
+ * - All persistence occurs via ruvector-service client calls only
+ */
+import type { DecisionEvent } from '../contracts/decision-event.js';
+import type { UsageOversightOutput } from '../contracts/usage-oversight.js';
+/**
+ * Configuration for RuVector client
+ */
+export interface RuvectorClientConfig {
+    /** Base URL of ruvector-service */
+    baseUrl: string;
+    /** API key for authentication */
+    apiKey: string;
+    /** Request timeout in milliseconds */
+    timeoutMs?: number;
+    /** Retry configuration */
+    retry?: {
+        maxRetries: number;
+        initialDelayMs: number;
+        maxDelayMs: number;
+    };
+}
+/**
+ * Response from ruvector-service
+ */
+export interface RuvectorResponse<T> {
+    success: boolean;
+    data?: T;
+    error?: {
+        code: string;
+        message: string;
+    };
+}
+/**
+ * RuVector Service Client
+ *
+ * Handles all persistence operations for governance agents.
+ */
+export declare class RuvectorClient {
+    private readonly config;
+    private readonly defaultTimeout;
+    private readonly defaultRetry;
+    constructor(config: RuvectorClientConfig);
+    /**
+     * Persist a DecisionEvent
+     *
+     * Every agent invocation MUST call this exactly once.
+     * Falls back gracefully if RuVector endpoint is unavailable.
+     */
+    persistDecisionEvent(event: DecisionEvent): Promise<void>;
+    /**
+     * Persist a Usage Oversight output
+     */
+    persistUsageOversightOutput(decisionEventId: string, output: UsageOversightOutput): Promise<void>;
+    /**
+     * Query historical DecisionEvents
+     */
+    queryDecisionEvents(query: {
+        agent_id?: string;
+        decision_type?: string;
+        organization_id?: string;
+        from?: string;
+        to?: string;
+        limit?: number;
+        offset?: number;
+    }): Promise<DecisionEvent[]>;
+    /**
+     * Get a specific DecisionEvent
+     */
+    getDecisionEvent(id: string): Promise<DecisionEvent | null>;
+    /**
+     * Health check for ruvector-service
+     */
+    healthCheck(): Promise<{
+        healthy: boolean;
+        latencyMs: number;
+        details?: Record<string, unknown>;
+    }>;
+    /**
+     * Perform a GET request
+     */
+    private get;
+    /**
+     * Perform a POST request
+     */
+    private post;
+    /**
+     * Perform an HTTP request with retry logic
+     */
+    private request;
+}
+/**
+ * Create a RuVector client from environment variables
+ */
+export declare function createRuvectorClientFromEnv(): RuvectorClient;
+/**
+ * Factory function to create a RuVector client
+ */
+export declare function createRuvectorClient(config: RuvectorClientConfig): RuvectorClient;
+//# sourceMappingURL=ruvector-client.d.ts.map

package/dist/bundled-agents/governance-dashboard-agents/dist/infrastructure/ruvector-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ruvector-client.d.ts","sourceRoot":"","sources":["../../src/infrastructure/ruvector-client.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gCAAgC,CAAC;AACpE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,iCAAiC,CAAC;AAE5E;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,mCAAmC;IACnC,OAAO,EAAE,MAAM,CAAC;IAChB,iCAAiC;IACjC,MAAM,EAAE,MAAM,CAAC;IACf,sCAAsC;IACtC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,0BAA0B;IAC1B,KAAK,CAAC,EAAE;QACN,UAAU,EAAE,MAAM,CAAC;QACnB,cAAc,EAAE,MAAM,CAAC;QACvB,UAAU,EAAE,MAAM,CAAC;KACpB,CAAC;CACH;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB,CAAC,CAAC;IACjC,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,CAAC,EAAE,CAAC,CAAC;IACT,KAAK,CAAC,EAAE;QACN,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,MAAM,CAAC;KACjB,CAAC;CACH;AAED;;;;GAIG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAuB;IAC9C,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAS;IACxC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAI3B;gBAEU,MAAM,EAAE,oBAAoB;IAQxC;;;;;OAKG;IACG,oBAAoB,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC;IAoB/D;;OAEG;IACG,2BAA2B,CAC/B,eAAe,EAAE,MAAM,EACvB,MAAM,EAAE,oBAAoB,GAC3B,OAAO,CAAC,IAAI,CAAC;IAOhB;;OAEG;IACG,mBAAmB,CAAC,KAAK,EAAE;QAC/B,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,eAAe,CAAC,EAAE,MAAM,CAAC;QACzB,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,EAAE,CAAC,EAAE,MAAM,CAAC;QACZ,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC;IAe5B;;OAEG;IACG,gBAAgB,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC;IAcjE;;OAEG;IACG,WAAW,IAAI,OAAO,CAAC;QAC3B,OAAO,EAAE,OAAO,CAAC;QACjB,SAAS,EAAE,MAAM,CAAC;QAClB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KACnC,CAAC;IAmBF;;OAEG;YACW,GAAG;IAIjB;;OAEG;YACW,IAAI;IAIlB;;OAEG;YACW,OAAO;CA8DtB;AAED;;GAEG;AACH,wBAAgB,2BAA2B,IAAI,cAAc,CAiB5D;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,oBAAoB,GAC3B,cAAc,CAEhB"}

package/dist/bundled-agents/governance-dashboard-agents/dist/infrastructure/ruvector-client.js

@@ -0,0 +1,202 @@
+/**
+ * RuVector Service Client
+ *
+ * Client for persisting governance artifacts to ruvector-service.
+ * ruvector-service is backed by Google SQL (Postgres).
+ *
+ * IMPORTANT:
+ * - LLM-Governance-Dashboard NEVER connects directly to Google SQL
+ * - LLM-Governance-Dashboard NEVER executes SQL
+ * - All persistence occurs via ruvector-service client calls only
+ */
+/**
+ * RuVector Service Client
+ *
+ * Handles all persistence operations for governance agents.
+ */
+export class RuvectorClient {
+    config;
+    defaultTimeout = 30000;
+    defaultRetry = {
+        maxRetries: 3,
+        initialDelayMs: 100,
+        maxDelayMs: 5000,
+    };
+    constructor(config) {
+        this.config = {
+            ...config,
+            timeoutMs: config.timeoutMs ?? this.defaultTimeout,
+            retry: config.retry ?? this.defaultRetry,
+        };
+    }
+    /**
+     * Persist a DecisionEvent
+     *
+     * Every agent invocation MUST call this exactly once.
+     * Falls back gracefully if RuVector endpoint is unavailable.
+     */
+    async persistDecisionEvent(event) {
+        try {
+            await this.post('/api/v1/decision-events', event);
+        }
+        catch (error) {
+            // Graceful degradation: log but don't fail the agent
+            // Phase 4 Layer 1: Emit signal but don't block execution
+            console.warn(`[RuVector] Failed to persist DecisionEvent ${event.id}: ${error.message}`);
+            console.warn(`[RuVector] Event data logged for recovery:`, JSON.stringify({
+                id: event.id,
+                agent_id: event.agent_id,
+                decision_type: event.decision_type,
+                timestamp: event.timestamp,
+            }));
+            // Re-throw only for critical errors (auth failures)
+            if (error.status === 401 || error.status === 403) {
+                throw error;
+            }
+        }
+    }
+    /**
+     * Persist a Usage Oversight output
+     */
+    async persistUsageOversightOutput(decisionEventId, output) {
+        await this.post(`/api/v1/decision-events/${decisionEventId}/outputs`, {
+            output_type: 'usage_oversight',
+            data: output,
+        });
+    }
+    /**
+     * Query historical DecisionEvents
+     */
+    async queryDecisionEvents(query) {
+        const params = new URLSearchParams();
+        Object.entries(query).forEach(([key, value]) => {
+            if (value !== undefined) {
+                params.append(key, String(value));
+            }
+        });
+        const response = await this.get(`/api/v1/decision-events?${params.toString()}`);
+        return response.data?.items ?? [];
+    }
+    /**
+     * Get a specific DecisionEvent
+     */
+    async getDecisionEvent(id) {
+        try {
+            const response = await this.get(`/api/v1/decision-events/${id}`);
+            return response.data ?? null;
+        }
+        catch (error) {
+            if (error.status === 404) {
+                return null;
+            }
+            throw error;
+        }
+    }
+    /**
+     * Health check for ruvector-service
+     */
+    async healthCheck() {
+        const start = Date.now();
+        try {
+            await this.get('/health');
+            return {
+                healthy: true,
+                latencyMs: Date.now() - start,
+            };
+        }
+        catch (error) {
+            return {
+                healthy: false,
+                latencyMs: Date.now() - start,
+                details: {
+                    error: error.message,
+                },
+            };
+        }
+    }
+    /**
+     * Perform a GET request
+     */
+    async get(path) {
+        return this.request('GET', path);
+    }
+    /**
+     * Perform a POST request
+     */
+    async post(path, data) {
+        return this.request('POST', path, data);
+    }
+    /**
+     * Perform an HTTP request with retry logic
+     */
+    async request(method, path, data) {
+        const url = `${this.config.baseUrl}${path}`;
+        const retry = this.config.retry ?? this.defaultRetry;
+        let lastError = null;
+        for (let attempt = 0; attempt <= retry.maxRetries; attempt++) {
+            try {
+                const controller = new AbortController();
+                const timeoutId = setTimeout(() => controller.abort(), this.config.timeoutMs);
+                const response = await fetch(url, {
+                    method,
+                    headers: {
+                        'Content-Type': 'application/json',
+                        'Authorization': `Bearer ${this.config.apiKey}`,
+                        'X-Client': 'governance-dashboard-agents',
+                    },
+                    body: data ? JSON.stringify(data) : undefined,
+                    signal: controller.signal,
+                });
+                clearTimeout(timeoutId);
+                if (!response.ok) {
+                    const errorBody = await response.json().catch(() => ({}));
+                    throw Object.assign(new Error(errorBody.message || response.statusText), {
+                        status: response.status,
+                        code: errorBody.code,
+                    });
+                }
+                const responseData = await response.json();
+                return { success: true, data: responseData };
+            }
+            catch (err) {
+                const error = err;
+                lastError = error instanceof Error ? error : new Error(String(err));
+                // Don't retry on client errors (4xx)
+                if (error.status && error.status >= 400 && error.status < 500) {
+                    throw error;
+                }
+                // Calculate delay for next retry
+                if (attempt < retry.maxRetries) {
+                    const delay = Math.min(retry.initialDelayMs * Math.pow(2, attempt), retry.maxDelayMs);
+                    await new Promise((resolve) => setTimeout(resolve, delay));
+                }
+            }
+        }
+        throw lastError || new Error('Request failed after retries');
+    }
+}
+/**
+ * Create a RuVector client from environment variables
+ */
+export function createRuvectorClientFromEnv() {
+    const baseUrl = process.env.RUVECTOR_SERVICE_URL;
+    const apiKey = process.env.RUVECTOR_API_KEY;
+    if (!baseUrl) {
+        throw new Error('RUVECTOR_SERVICE_URL environment variable is required');
+    }
+    if (!apiKey) {
+        throw new Error('RUVECTOR_API_KEY environment variable is required');
+    }
+    return new RuvectorClient({
+        baseUrl,
+        apiKey,
+        timeoutMs: parseInt(process.env.RUVECTOR_TIMEOUT_MS ?? '30000', 10),
+    });
+}
+/**
+ * Factory function to create a RuVector client
+ */
+export function createRuvectorClient(config) {
+    return new RuvectorClient(config);
+}
+//# sourceMappingURL=ruvector-client.js.map

package/dist/bundled-agents/governance-dashboard-agents/dist/infrastructure/ruvector-client.js.map

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