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

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

@@ -0,0 +1 @@
+{"version":3,"file":"usage-oversight.d.ts","sourceRoot":"","sources":["../../src/contracts/usage-oversight.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAMxB;;GAEG;AACH,eAAO,MAAM,kBAAkB;IAC7B,6CAA6C;;IAE7C,2BAA2B;;IAE3B,4BAA4B;;IAE5B,qCAAqC;;IAErC,qBAAqB;;IAErB,yCAAyC;;IAEzC,mBAAmB;;;;IAInB,kBAAkB;;IAElB,8BAA8B;;IAE9B,+BAA+B;;IAE/B,wBAAwB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAExB,CAAC;AAEH,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAE9D;;GAEG;AACH,eAAO,MAAM,mBAAmB;IAC9B,2CAA2C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAW3C,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;IASpB,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EASnB,CAAC;AAEH,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAEhE;;GAEG;AACH,eAAO,MAAM,yBAAyB;IACpC,qCAAqC;;IAErC,8BAA8B;;IAE9B,8BAA8B;;;;;;;;;;;IAK9B,gCAAgC;;QA9EhC,6CAA6C;;QAE7C,2BAA2B;;QAE3B,4BAA4B;;QAE5B,qCAAqC;;QAErC,qBAAqB;;QAErB,yCAAyC;;QAEzC,mBAAmB;;;;QAInB,kBAAkB;;QAElB,8BAA8B;;QAE9B,+BAA+B;;QAE/B,wBAAwB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IA0DxB,oCAAoC;;QAhDpC,2CAA2C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;QAW3C,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;QASpB,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IA8BnB,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAOvB,CAAC;AAEH,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAM5E;;GAEG;AACH,eAAO,MAAM,uBAAuB,qDAKlC,CAAC;AAEH,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAExE;;GAEG;AACH,eAAO,MAAM,wBAAwB;IACnC,yBAAyB;;IAEzB,uBAAuB;;IAWvB,8BAA8B;;IAE9B,iCAAiC;;IAEjC,qBAAqB;;;;;;;;;;;;;;IAMrB,8BAA8B;;IAE9B,2BAA2B;;;;;;;;;;;;;;IAM3B,+BAA+B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAK/B,CAAC;AAEH,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAE1E;;GAEG;AACH,eAAO,MAAM,kBAAkB;IAC7B,+BAA+B;;IAE/B,4BAA4B;;IAE5B,wBAAwB;;IAExB,4BAA4B;;IAE5B,mBAAmB;;IAEnB,yBAAyB;;IAEzB,yBAAyB;;;;;;;;;;;;;;;;;;;;;;;IASzB,gCAAgC;;;;;;;;;;;;;;;;;;;;IAQhC,4BAA4B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAM5B,CAAC;AAEH,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAE9D;;GAEG;AACH,eAAO,MAAM,qBAAqB;IAChC,wBAAwB;;IAExB,kBAAkB;;IAElB,+BAA+B;;IAE/B,mCAAmC;;IAEnC,2BAA2B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAO3B,CAAC;AAEH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAEpE;;;;GAIG;AACH,eAAO,MAAM,0BAA0B;IACrC,+BAA+B;;QApE/B,+BAA+B;;QAE/B,4BAA4B;;QAE5B,wBAAwB;;QAExB,4BAA4B;;QAE5B,mBAAmB;;QAEnB,yBAAyB;;QAEzB,yBAAyB;;;;;;;;;;;;;;;;;;;;;;;QASzB,gCAAgC;;;;;;;;;;;;;;;;;;;;QAQhC,4BAA4B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAyC5B,sCAAsC;;QAlHtC,yBAAyB;;QAEzB,uBAAuB;;QAWvB,8BAA8B;;QAE9B,iCAAiC;;QAEjC,qBAAqB;;;;;;;;;;;;;;QAMrB,8BAA8B;;QAE9B,2BAA2B;;;;;;;;;;;;;;QAM3B,+BAA+B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAqF/B,8BAA8B;;QA7B9B,wBAAwB;;QAExB,kBAAkB;;QAElB,+BAA+B;;QAE/B,mCAAmC;;QAEnC,2BAA2B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAuB3B,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;IAUpB,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAWnB,sCAAsC;;IAEtC,iDAAiD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAQjD,CAAC;AAEH,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAM9E,wBAAgB,2BAA2B,CAAC,KAAK,EAAE,OAAO,GAAG,mBAAmB,CAE/E;AAED,wBAAgB,4BAA4B,CAAC,MAAM,EAAE,OAAO,GAAG,oBAAoB,CAElF;AAMD;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAWlC,CAAC;AAEH,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAMxE,eAAO,MAAM,8BAA8B;;;;;;;;;;;;;;CAiDjC,CAAC"}

package/dist/bundled-agents/governance-dashboard-agents/dist/contracts/usage-oversight.js

@@ -0,0 +1,361 @@
+/**
+ * Usage Oversight Agent Contract
+ *
+ * Classification: OVERSIGHT / VISIBILITY
+ *
+ * Purpose:
+ * Provide visibility into LLM usage patterns for governance and compliance monitoring.
+ *
+ * This agent:
+ * - Aggregates usage signals across systems
+ * - Identifies out-of-policy usage patterns
+ * - Produces oversight dashboards and signals
+ *
+ * This agent MUST NOT:
+ * - Intercept execution
+ * - Trigger retries or workflows
+ * - Enforce policies
+ * - Modify configurations
+ * - Emit anomaly detections
+ * - Apply optimizations
+ * - Connect directly to Google SQL
+ * - Execute SQL queries
+ */
+import { z } from 'zod';
+// ============================================================================
+// INPUT SCHEMAS
+// ============================================================================
+/**
+ * Usage pattern from upstream systems
+ */
+export const UsagePatternSchema = z.object({
+    /** Unique identifier for the usage record */
+    usage_id: z.string(),
+    /** Organization context */
+    organization_id: z.string(),
+    /** Optional team context */
+    team_id: z.string().optional(),
+    /** User who initiated the request */
+    user_id: z.string(),
+    /** LLM model used */
+    model: z.string(),
+    /** Provider (openai, anthropic, etc.) */
+    provider: z.string(),
+    /** Token counts */
+    prompt_tokens: z.number().int().min(0),
+    completion_tokens: z.number().int().min(0),
+    total_tokens: z.number().int().min(0),
+    /** Cost in USD */
+    cost_usd: z.number().min(0),
+    /** Latency in milliseconds */
+    latency_ms: z.number().min(0),
+    /** Timestamp of the request */
+    timestamp: z.string().datetime(),
+    /** Optional metadata */
+    metadata: z.record(z.unknown()).optional(),
+});
+/**
+ * Policy context for usage evaluation
+ */
+export const PolicyContextSchema = z.object({
+    /** Active policies for the organization */
+    active_policies: z.array(z.object({
+        policy_id: z.string(),
+        policy_name: z.string(),
+        rules: z.array(z.object({
+            rule_id: z.string(),
+            rule_type: z.string(),
+            threshold: z.unknown().optional(),
+            condition: z.string().optional(),
+        })),
+    })),
+    /** Budget limits */
+    budget_limits: z.array(z.object({
+        budget_id: z.string(),
+        scope: z.enum(['organization', 'team', 'user']),
+        scope_id: z.string(),
+        limit_usd: z.number(),
+        current_spend_usd: z.number(),
+        period: z.enum(['daily', 'weekly', 'monthly']),
+    })).optional(),
+    /** Quota limits */
+    quota_limits: z.array(z.object({
+        quota_id: z.string(),
+        scope: z.enum(['organization', 'team', 'user']),
+        scope_id: z.string(),
+        quota_type: z.string(),
+        limit_value: z.number(),
+        current_value: z.number(),
+    })).optional(),
+});
+/**
+ * Input schema for Usage Oversight Agent
+ */
+export const UsageOversightInputSchema = z.object({
+    /** Request identifier for tracing */
+    request_id: z.string(),
+    /** Organization to analyze */
+    organization_id: z.string(),
+    /** Time range for analysis */
+    time_range: z.object({
+        start: z.string().datetime(),
+        end: z.string().datetime(),
+    }),
+    /** Usage patterns to analyze */
+    usage_patterns: z.array(UsagePatternSchema),
+    /** Policy context for evaluation */
+    policy_context: PolicyContextSchema,
+    /** Optional filters */
+    filters: z.object({
+        team_ids: z.array(z.string()).optional(),
+        user_ids: z.array(z.string()).optional(),
+        models: z.array(z.string()).optional(),
+        providers: z.array(z.string()).optional(),
+    }).optional(),
+});
+// ============================================================================
+// OUTPUT SCHEMAS
+// ============================================================================
+/**
+ * Severity levels for oversight signals
+ */
+export const OversightSeveritySchema = z.enum([
+    'info', // Informational, no action needed
+    'advisory', // Recommend review
+    'warning', // Potential policy concern
+    'alert', // Requires attention
+]);
+/**
+ * Out-of-policy pattern detected
+ */
+export const OutOfPolicyPatternSchema = z.object({
+    /** Pattern identifier */
+    pattern_id: z.string(),
+    /** Pattern category */
+    category: z.enum([
+        'cost_anomaly',
+        'usage_spike',
+        'policy_threshold_breach',
+        'quota_warning',
+        'budget_warning',
+        'unusual_model_usage',
+        'off_hours_usage',
+        'high_frequency_usage',
+    ]),
+    /** Severity of the pattern */
+    severity: OversightSeveritySchema,
+    /** Human-readable description */
+    description: z.string(),
+    /** Affected scope */
+    affected_scope: z.object({
+        users: z.array(z.string()),
+        teams: z.array(z.string()).optional(),
+        models: z.array(z.string()),
+    }),
+    /** Related policy (if any) */
+    related_policy_id: z.string().optional(),
+    /** Quantitative details */
+    metrics: z.object({
+        observed_value: z.number(),
+        threshold_value: z.number().optional(),
+        deviation_percentage: z.number().optional(),
+    }),
+    /** Timeframe of the pattern */
+    timeframe: z.object({
+        start: z.string().datetime(),
+        end: z.string().datetime(),
+    }),
+});
+/**
+ * Aggregated usage summary
+ */
+export const UsageSummarySchema = z.object({
+    /** Total requests in period */
+    total_requests: z.number().int(),
+    /** Total tokens consumed */
+    total_tokens: z.number().int(),
+    /** Total cost in USD */
+    total_cost_usd: z.number(),
+    /** Average latency in ms */
+    average_latency_ms: z.number(),
+    /** Unique users */
+    unique_users: z.number().int(),
+    /** Unique models used */
+    unique_models: z.number().int(),
+    /** Breakdown by model */
+    by_model: z.array(z.object({
+        model: z.string(),
+        provider: z.string(),
+        requests: z.number().int(),
+        tokens: z.number().int(),
+        cost_usd: z.number(),
+        percentage_of_total: z.number(),
+    })),
+    /** Breakdown by user (top N) */
+    by_user: z.array(z.object({
+        user_id: z.string(),
+        requests: z.number().int(),
+        tokens: z.number().int(),
+        cost_usd: z.number(),
+        percentage_of_total: z.number(),
+    })),
+    /** Temporal distribution */
+    temporal_distribution: z.array(z.object({
+        period: z.string(),
+        requests: z.number().int(),
+        cost_usd: z.number(),
+    })),
+});
+/**
+ * Policy adherence status
+ */
+export const PolicyAdherenceSchema = z.object({
+    /** Policy identifier */
+    policy_id: z.string(),
+    /** Policy name */
+    policy_name: z.string(),
+    /** Overall adherence status */
+    status: z.enum(['compliant', 'warning', 'violation']),
+    /** Adherence percentage (0-100) */
+    adherence_percentage: z.number().min(0).max(100),
+    /** Rule-level adherence */
+    rule_adherence: z.array(z.object({
+        rule_id: z.string(),
+        rule_type: z.string(),
+        status: z.enum(['compliant', 'warning', 'violation']),
+        details: z.string().optional(),
+    })),
+});
+/**
+ * Output schema for Usage Oversight Agent
+ *
+ * decision_type: "usage_oversight_signal"
+ */
+export const UsageOversightOutputSchema = z.object({
+    /** Aggregated usage summary */
+    usage_summary: UsageSummarySchema,
+    /** Detected out-of-policy patterns */
+    out_of_policy_patterns: z.array(OutOfPolicyPatternSchema),
+    /** Policy adherence status */
+    policy_adherence: z.array(PolicyAdherenceSchema),
+    /** Budget status */
+    budget_status: z.array(z.object({
+        budget_id: z.string(),
+        scope: z.string(),
+        scope_id: z.string(),
+        limit_usd: z.number(),
+        current_spend_usd: z.number(),
+        percentage_used: z.number(),
+        status: z.enum(['healthy', 'warning', 'critical']),
+    })),
+    /** Quota status */
+    quota_status: z.array(z.object({
+        quota_id: z.string(),
+        quota_type: z.string(),
+        scope: z.string(),
+        scope_id: z.string(),
+        limit_value: z.number(),
+        current_value: z.number(),
+        percentage_used: z.number(),
+        status: z.enum(['healthy', 'warning', 'critical']),
+    })),
+    /** Governance health score (0-100) */
+    governance_health_score: z.number().min(0).max(100),
+    /** Recommendations for governance improvement */
+    recommendations: z.array(z.object({
+        recommendation_id: z.string(),
+        priority: z.enum(['low', 'medium', 'high']),
+        category: z.string(),
+        description: z.string(),
+        action_items: z.array(z.string()),
+    })),
+});
+// ============================================================================
+// VALIDATION FUNCTIONS
+// ============================================================================
+export function validateUsageOversightInput(input) {
+    return UsageOversightInputSchema.parse(input);
+}
+export function validateUsageOversightOutput(output) {
+    return UsageOversightOutputSchema.parse(output);
+}
+// ============================================================================
+// CLI CONTRACT
+// ============================================================================
+/**
+ * CLI invocation shape for Usage Oversight Agent
+ *
+ * Command: llm-gov agent usage-oversight
+ *
+ * Subcommands:
+ * - analyze: Analyze usage patterns for a time range
+ * - inspect: Inspect specific usage records
+ * - summarize: Generate a governance summary
+ *
+ * Examples:
+ *   llm-gov agent usage-oversight analyze --org org_123 --from 2024-01-01 --to 2024-01-31
+ *   llm-gov agent usage-oversight inspect --pattern pattern_456
+ *   llm-gov agent usage-oversight summarize --org org_123 --format json
+ */
+export const UsageOversightCLISchema = z.object({
+    subcommand: z.enum(['analyze', 'inspect', 'summarize']),
+    options: z.object({
+        organization_id: z.string(),
+        from: z.string().datetime().optional(),
+        to: z.string().datetime().optional(),
+        team_id: z.string().optional(),
+        user_id: z.string().optional(),
+        format: z.enum(['json', 'table', 'csv']).default('json'),
+        verbose: z.boolean().default(false),
+    }),
+});
+// ============================================================================
+// AGENT METADATA
+// ============================================================================
+export const USAGE_OVERSIGHT_AGENT_METADATA = {
+    agent_id: 'usage-oversight-agent',
+    agent_version: '1.0.0',
+    classification: 'OVERSIGHT',
+    decision_type: 'usage_oversight_signal',
+    description: 'Provide visibility into LLM usage patterns for governance and compliance monitoring',
+    // What this agent MAY do
+    capabilities: [
+        'Aggregate usage signals across systems',
+        'Identify out-of-policy usage patterns',
+        'Produce oversight dashboards and signals',
+        'Calculate governance health scores',
+        'Generate adherence reports',
+    ],
+    // What this agent MUST NOT do
+    restrictions: [
+        'MUST NOT intercept execution',
+        'MUST NOT trigger retries or workflows',
+        'MUST NOT enforce policies',
+        'MUST NOT modify configurations',
+        'MUST NOT emit anomaly detections',
+        'MUST NOT apply optimizations',
+        'MUST NOT connect directly to Google SQL',
+        'MUST NOT execute SQL queries',
+    ],
+    // Systems that MAY consume this agent's output
+    consumers: [
+        'Governance & compliance dashboards',
+        'Audit systems',
+        'Management reporting',
+        'Policy recommendation systems',
+    ],
+    // Data persistence rules
+    persistence: {
+        persisted_to: 'ruvector-service',
+        data_persisted: [
+            'DecisionEvent',
+            'UsageOversightOutput',
+        ],
+        data_not_persisted: [
+            'Raw usage patterns (already in source systems)',
+            'PII beyond user IDs',
+            'Actual prompt/completion content',
+        ],
+    },
+};
+//# sourceMappingURL=usage-oversight.js.map

package/dist/bundled-agents/governance-dashboard-agents/dist/contracts/usage-oversight.js.map

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

package/dist/bundled-agents/governance-dashboard-agents/dist/contracts/validation.d.ts

@@ -0,0 +1,69 @@
+/**
+ * Common validation utilities for governance agents
+ */
+import { z } from 'zod';
+/**
+ * Compute SHA-256 hash of inputs for audit trail
+ */
+export declare function computeInputsHash(input: unknown): string;
+/**
+ * Generate a UUID v4
+ */
+export declare function generateUUID(): string;
+/**
+ * Get current UTC timestamp in ISO format
+ */
+export declare function getCurrentTimestamp(): string;
+/**
+ * Common validation schemas
+ */
+export declare const CommonSchemas: {
+    /** UUID format */
+    uuid: z.ZodString;
+    /** ISO 8601 datetime */
+    datetime: z.ZodString;
+    /** Semantic version */
+    semver: z.ZodString;
+    /** Non-empty string */
+    nonEmptyString: z.ZodString;
+    /** Positive integer */
+    positiveInt: z.ZodNumber;
+    /** Non-negative number */
+    nonNegativeNumber: z.ZodNumber;
+    /** Percentage (0-100) */
+    percentage: z.ZodNumber;
+    /** Ratio (0-1) */
+    ratio: z.ZodNumber;
+    /** Organization ID format */
+    organizationId: z.ZodString;
+    /** User ID format */
+    userId: z.ZodString;
+    /** Team ID format */
+    teamId: z.ZodString;
+};
+/**
+ * Error codes for validation failures
+ */
+export declare const ValidationErrorCodes: {
+    readonly INVALID_INPUT: "VALIDATION_INVALID_INPUT";
+    readonly INVALID_OUTPUT: "VALIDATION_INVALID_OUTPUT";
+    readonly MISSING_REQUIRED_FIELD: "VALIDATION_MISSING_REQUIRED";
+    readonly TYPE_MISMATCH: "VALIDATION_TYPE_MISMATCH";
+    readonly CONSTRAINT_VIOLATION: "VALIDATION_CONSTRAINT_VIOLATION";
+    readonly SCHEMA_VERSION_MISMATCH: "VALIDATION_SCHEMA_VERSION_MISMATCH";
+};
+/**
+ * Create a validation error with structured details
+ */
+export declare function createValidationError(code: keyof typeof ValidationErrorCodes, message: string, details?: Record<string, unknown>): Error;
+/**
+ * Safe parse with error transformation
+ */
+export declare function safeParse<T>(schema: z.ZodType<T>, data: unknown, context: string): {
+    success: true;
+    data: T;
+} | {
+    success: false;
+    error: Error;
+};
+//# sourceMappingURL=validation.d.ts.map

package/dist/bundled-agents/governance-dashboard-agents/dist/contracts/validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../../src/contracts/validation.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAGxD;AAED;;GAEG;AACH,wBAAgB,YAAY,IAAI,MAAM,CAErC;AAED;;GAEG;AACH,wBAAgB,mBAAmB,IAAI,MAAM,CAE5C;AAED;;GAEG;AACH,eAAO,MAAM,aAAa;IACxB,kBAAkB;;IAGlB,wBAAwB;;IAGxB,uBAAuB;;IAGvB,uBAAuB;;IAGvB,uBAAuB;;IAGvB,0BAA0B;;IAG1B,yBAAyB;;IAGzB,kBAAkB;;IAGlB,6BAA6B;;IAG7B,qBAAqB;;IAGrB,qBAAqB;;CAEtB,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,oBAAoB;;;;;;;CAOvB,CAAC;AAEX;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,MAAM,OAAO,oBAAoB,EACvC,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAChC,KAAK,CAMP;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,CAAC,EACzB,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EACpB,IAAI,EAAE,OAAO,EACb,OAAO,EAAE,MAAM,GACd;IAAE,OAAO,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,CAAC,CAAA;CAAE,GAAG;IAAE,OAAO,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,KAAK,CAAA;CAAE,CAiB/D"}

package/dist/bundled-agents/governance-dashboard-agents/dist/contracts/validation.js

@@ -0,0 +1,87 @@
+/**
+ * Common validation utilities for governance agents
+ */
+import { z } from 'zod';
+import { createHash } from 'crypto';
+/**
+ * Compute SHA-256 hash of inputs for audit trail
+ */
+export function computeInputsHash(input) {
+    const serialized = JSON.stringify(input, Object.keys(input).sort());
+    return createHash('sha256').update(serialized).digest('hex');
+}
+/**
+ * Generate a UUID v4
+ */
+export function generateUUID() {
+    return crypto.randomUUID();
+}
+/**
+ * Get current UTC timestamp in ISO format
+ */
+export function getCurrentTimestamp() {
+    return new Date().toISOString();
+}
+/**
+ * Common validation schemas
+ */
+export const CommonSchemas = {
+    /** UUID format */
+    uuid: z.string().uuid(),
+    /** ISO 8601 datetime */
+    datetime: z.string().datetime(),
+    /** Semantic version */
+    semver: z.string().regex(/^\d+\.\d+\.\d+$/),
+    /** Non-empty string */
+    nonEmptyString: z.string().min(1),
+    /** Positive integer */
+    positiveInt: z.number().int().positive(),
+    /** Non-negative number */
+    nonNegativeNumber: z.number().min(0),
+    /** Percentage (0-100) */
+    percentage: z.number().min(0).max(100),
+    /** Ratio (0-1) */
+    ratio: z.number().min(0).max(1),
+    /** Organization ID format */
+    organizationId: z.string().regex(/^org_[a-zA-Z0-9]+$/),
+    /** User ID format */
+    userId: z.string().regex(/^usr_[a-zA-Z0-9]+$/),
+    /** Team ID format */
+    teamId: z.string().regex(/^team_[a-zA-Z0-9]+$/),
+};
+/**
+ * Error codes for validation failures
+ */
+export const ValidationErrorCodes = {
+    INVALID_INPUT: 'VALIDATION_INVALID_INPUT',
+    INVALID_OUTPUT: 'VALIDATION_INVALID_OUTPUT',
+    MISSING_REQUIRED_FIELD: 'VALIDATION_MISSING_REQUIRED',
+    TYPE_MISMATCH: 'VALIDATION_TYPE_MISMATCH',
+    CONSTRAINT_VIOLATION: 'VALIDATION_CONSTRAINT_VIOLATION',
+    SCHEMA_VERSION_MISMATCH: 'VALIDATION_SCHEMA_VERSION_MISMATCH',
+};
+/**
+ * Create a validation error with structured details
+ */
+export function createValidationError(code, message, details) {
+    const error = new Error(message);
+    error.name = 'ValidationError';
+    error.code = ValidationErrorCodes[code];
+    error.details = details;
+    return error;
+}
+/**
+ * Safe parse with error transformation
+ */
+export function safeParse(schema, data, context) {
+    const result = schema.safeParse(data);
+    if (result.success) {
+        return { success: true, data: result.data };
+    }
+    const error = createValidationError('INVALID_INPUT', `Validation failed for ${context}: ${result.error.message}`, {
+        issues: result.error.issues,
+        context,
+    });
+    return { success: false, error };
+}
+//# sourceMappingURL=validation.js.map

package/dist/bundled-agents/governance-dashboard-agents/dist/contracts/validation.js.map

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

package/dist/bundled-agents/governance-dashboard-agents/dist/handlers/cloud-function.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Google Cloud Function Handler
+ *
+ * Entry point for governance-dashboard-agents Cloud Function.
+ *
+ * Cloud Function name: governance-dashboard-agents
+ * Entry point: handler
+ * Runtime: nodejs20
+ *
+ * Routes:
+ * - POST /v1/governance-dashboard/audit     → Governance Audit Agent
+ * - POST /v1/governance-dashboard/impact    → Change Impact Agent
+ * - POST /v1/governance-dashboard/oversight  → Usage Oversight Agent
+ * - GET  /v1/governance-dashboard/health    → Health check
+ *
+ * Every response includes execution_metadata and layers_executed.
+ */
+import type { Request, Response } from 'express';
+/**
+ * Google Cloud Function entry point.
+ *
+ * @param req - Express-compatible Request
+ * @param res - Express-compatible Response
+ */
+export declare function handler(req: Request, res: Response): Promise<void>;
+export default handler;
+//# sourceMappingURL=cloud-function.d.ts.map

package/dist/bundled-agents/governance-dashboard-agents/dist/handlers/cloud-function.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cloud-function.d.ts","sourceRoot":"","sources":["../../src/handlers/cloud-function.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAuIjD;;;;;GAKG;AACH,wBAAsB,OAAO,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,CAkMxE;AAGD,eAAe,OAAO,CAAC"}