@llm-dev-ops/agentics-cli 1.4.52 → 1.4.54

package/dist/bundled-agents/copilot-agents/functions/lib/services/agents/contracts/config-validation-schemas.js

@@ -0,0 +1,305 @@
+"use strict";
+/**
+ * Config Validation Agent Schemas
+ *
+ * Purpose: Validate configuration artifacts for structural and semantic correctness
+ * Classification: CONFIGURATION_VALIDATION, STATIC_ANALYSIS
+ * decision_type: config_validation
+ *
+ * Scope:
+ * - Validate schemas
+ * - Validate semantic constraints
+ * - Detect missing, conflicting, deprecated, or unsafe values
+ * - Assess configuration readiness
+ *
+ * Must Never:
+ * - Modify configuration
+ * - Apply defaults
+ * - Auto-fix values
+ * - Enforce policy
+ * - Block execution
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ConfigValidationOutputSchema = exports.ConfigValidationInputSchema = exports.ReadinessAssessmentSchema = exports.MissingConfigSchema = exports.ConfigConflictSchema = exports.UnsafeConfigSchema = exports.DeprecatedValueSchema = exports.SemanticConstraintSchema = exports.SchemaValidationResultSchema = exports.ValidationFindingSchema = exports.ValidationCategory = exports.ValidationSeverity = void 0;
+const zod_1 = require("zod");
+/**
+ * Severity levels for validation findings
+ */
+exports.ValidationSeverity = {
+    INFO: 'info',
+    WARNING: 'warning',
+    ERROR: 'error',
+    CRITICAL: 'critical',
+};
+/**
+ * Categories of validation issues
+ */
+exports.ValidationCategory = {
+    SCHEMA: 'schema',
+    SEMANTIC: 'semantic',
+    MISSING: 'missing',
+    CONFLICT: 'conflict',
+    DEPRECATED: 'deprecated',
+    UNSAFE: 'unsafe',
+    TYPE_MISMATCH: 'type_mismatch',
+    CONSTRAINT: 'constraint',
+    COMPATIBILITY: 'compatibility',
+};
+/**
+ * Single validation finding
+ */
+exports.ValidationFindingSchema = zod_1.z.object({
+    /** Unique finding identifier */
+    finding_id: zod_1.z.string().min(1),
+    /** Category of the issue */
+    category: zod_1.z.enum([
+        'schema',
+        'semantic',
+        'missing',
+        'conflict',
+        'deprecated',
+        'unsafe',
+        'type_mismatch',
+        'constraint',
+        'compatibility',
+    ]),
+    /** Severity level */
+    severity: zod_1.z.enum(['info', 'warning', 'error', 'critical']),
+    /** JSON path to the problematic value */
+    path: zod_1.z.string(),
+    /** Human-readable description of the issue */
+    message: zod_1.z.string().min(1),
+    /** The actual value found (if applicable) */
+    actual_value: zod_1.z.unknown().optional(),
+    /** Expected value or type (if applicable) */
+    expected: zod_1.z.string().optional(),
+    /** Related paths that contribute to this finding */
+    related_paths: zod_1.z.array(zod_1.z.string()).default([]),
+    /** Documentation reference for this issue */
+    doc_reference: zod_1.z.string().optional(),
+    /** Tags for categorization */
+    tags: zod_1.z.array(zod_1.z.string()).default([]),
+});
+/**
+ * Schema validation result
+ */
+exports.SchemaValidationResultSchema = zod_1.z.object({
+    /** Whether schema validation passed */
+    valid: zod_1.z.boolean(),
+    /** Schema that was validated against */
+    schema_id: zod_1.z.string().optional(),
+    /** Schema version */
+    schema_version: zod_1.z.string().optional(),
+    /** Findings from schema validation */
+    findings: zod_1.z.array(exports.ValidationFindingSchema),
+});
+/**
+ * Semantic constraint check
+ */
+exports.SemanticConstraintSchema = zod_1.z.object({
+    /** Constraint identifier */
+    constraint_id: zod_1.z.string().min(1),
+    /** Human-readable constraint name */
+    name: zod_1.z.string().min(1),
+    /** Description of what this constraint checks */
+    description: zod_1.z.string(),
+    /** Whether the constraint passed */
+    passed: zod_1.z.boolean(),
+    /** Paths involved in this constraint */
+    paths: zod_1.z.array(zod_1.z.string()),
+    /** Details if constraint failed */
+    failure_detail: zod_1.z.string().optional(),
+});
+/**
+ * Deprecated value detection
+ */
+exports.DeprecatedValueSchema = zod_1.z.object({
+    /** Path to deprecated value */
+    path: zod_1.z.string(),
+    /** The deprecated value */
+    value: zod_1.z.unknown(),
+    /** When it was deprecated */
+    deprecated_since: zod_1.z.string().optional(),
+    /** When it will be removed */
+    removal_version: zod_1.z.string().optional(),
+    /** Suggested replacement (informational only, NOT applied) */
+    suggested_replacement: zod_1.z.string().optional(),
+    /** Migration documentation */
+    migration_guide: zod_1.z.string().optional(),
+});
+/**
+ * Unsafe configuration detection
+ */
+exports.UnsafeConfigSchema = zod_1.z.object({
+    /** Path to unsafe configuration */
+    path: zod_1.z.string(),
+    /** The unsafe value */
+    value: zod_1.z.unknown(),
+    /** Type of security concern */
+    concern_type: zod_1.z.enum([
+        'hardcoded_secret',
+        'weak_encryption',
+        'insecure_protocol',
+        'overly_permissive',
+        'missing_authentication',
+        'exposed_endpoint',
+        'debug_enabled',
+        'verbose_logging',
+        'other',
+    ]),
+    /** Severity of the security concern */
+    severity: zod_1.z.enum(['low', 'medium', 'high', 'critical']),
+    /** Description of the risk */
+    risk_description: zod_1.z.string(),
+    /** CWE reference if applicable */
+    cwe_reference: zod_1.z.string().optional(),
+});
+/**
+ * Configuration conflict
+ */
+exports.ConfigConflictSchema = zod_1.z.object({
+    /** Conflict identifier */
+    conflict_id: zod_1.z.string().min(1),
+    /** Type of conflict */
+    conflict_type: zod_1.z.enum([
+        'mutually_exclusive',
+        'dependency_missing',
+        'circular_reference',
+        'value_incompatibility',
+        'version_mismatch',
+    ]),
+    /** Paths involved in the conflict */
+    conflicting_paths: zod_1.z.array(zod_1.z.string()).min(2),
+    /** Description of the conflict */
+    description: zod_1.z.string(),
+    /** Severity */
+    severity: zod_1.z.enum(['warning', 'error', 'critical']),
+});
+/**
+ * Missing required configuration
+ */
+exports.MissingConfigSchema = zod_1.z.object({
+    /** Path where value is missing */
+    path: zod_1.z.string(),
+    /** Expected type */
+    expected_type: zod_1.z.string(),
+    /** Whether this is required or recommended */
+    requirement_level: zod_1.z.enum(['required', 'recommended', 'optional_but_advised']),
+    /** Description of what this config does */
+    description: zod_1.z.string(),
+    /** Default that would be used if not specified (informational) */
+    implicit_default: zod_1.z.unknown().optional(),
+});
+/**
+ * Readiness assessment
+ */
+exports.ReadinessAssessmentSchema = zod_1.z.object({
+    /** Overall readiness status */
+    status: zod_1.z.enum(['ready', 'ready_with_warnings', 'not_ready', 'critical_issues']),
+    /** Readiness score (0.0 - 1.0) */
+    score: zod_1.z.number().min(0).max(1),
+    /** Breakdown by category */
+    category_scores: zod_1.z.record(zod_1.z.number()),
+    /** Blocking issues that prevent readiness */
+    blocking_issues: zod_1.z.array(zod_1.z.string()),
+    /** Non-blocking warnings */
+    warnings: zod_1.z.array(zod_1.z.string()),
+    /** Recommendations (informational only) */
+    recommendations: zod_1.z.array(zod_1.z.string()),
+});
+/**
+ * Config Validation Agent Input Schema
+ */
+exports.ConfigValidationInputSchema = zod_1.z.object({
+    /** The configuration to validate (JSON/YAML parsed to object) */
+    config: zod_1.z.record(zod_1.z.unknown()),
+    /** Configuration format */
+    format: zod_1.z.enum(['json', 'yaml', 'toml', 'env', 'unknown']).default('unknown'),
+    /** Optional schema to validate against */
+    schema: zod_1.z.object({
+        /** Schema content or reference */
+        content: zod_1.z.unknown().optional(),
+        /** Schema URI/ID */
+        uri: zod_1.z.string().optional(),
+        /** Schema format */
+        format: zod_1.z.enum(['json-schema', 'zod', 'yup', 'joi', 'custom']).optional(),
+    }).optional(),
+    /** Configuration context */
+    context: zod_1.z.object({
+        /** Environment (dev, staging, prod) */
+        environment: zod_1.z.string().optional(),
+        /** Application name */
+        application: zod_1.z.string().optional(),
+        /** Version being validated */
+        version: zod_1.z.string().optional(),
+        /** Known deprecated keys to check */
+        deprecated_keys: zod_1.z.array(zod_1.z.string()).optional(),
+        /** Custom semantic constraints */
+        constraints: zod_1.z.array(zod_1.z.object({
+            name: zod_1.z.string(),
+            description: zod_1.z.string(),
+            check: zod_1.z.string(), // JSONPath or simple expression
+        })).optional(),
+    }).optional(),
+    /** Validation options */
+    options: zod_1.z.object({
+        /** Check for deprecated values */
+        check_deprecated: zod_1.z.boolean().default(true),
+        /** Check for security issues */
+        check_security: zod_1.z.boolean().default(true),
+        /** Check for conflicts */
+        check_conflicts: zod_1.z.boolean().default(true),
+        /** Check for missing required values */
+        check_missing: zod_1.z.boolean().default(true),
+        /** Strict mode (treat warnings as errors) */
+        strict: zod_1.z.boolean().default(false),
+    }).optional(),
+    /** Request ID for tracing */
+    request_id: zod_1.z.string().uuid().optional(),
+});
+/**
+ * Config Validation Agent Output Schema
+ */
+exports.ConfigValidationOutputSchema = zod_1.z.object({
+    /** Validation result ID */
+    validation_id: zod_1.z.string().uuid(),
+    /** Overall validation passed/failed */
+    valid: zod_1.z.boolean(),
+    /** Schema validation results */
+    schema_validation: exports.SchemaValidationResultSchema,
+    /** Semantic constraint results */
+    semantic_constraints: zod_1.z.array(exports.SemanticConstraintSchema),
+    /** All validation findings */
+    findings: zod_1.z.array(exports.ValidationFindingSchema),
+    /** Detected deprecated values */
+    deprecated_values: zod_1.z.array(exports.DeprecatedValueSchema),
+    /** Detected unsafe configurations */
+    unsafe_configs: zod_1.z.array(exports.UnsafeConfigSchema),
+    /** Detected conflicts */
+    conflicts: zod_1.z.array(exports.ConfigConflictSchema),
+    /** Missing configurations */
+    missing_configs: zod_1.z.array(exports.MissingConfigSchema),
+    /** Readiness assessment */
+    readiness: exports.ReadinessAssessmentSchema,
+    /** Summary statistics */
+    summary: zod_1.z.object({
+        total_findings: zod_1.z.number().int().nonnegative(),
+        by_severity: zod_1.z.object({
+            critical: zod_1.z.number().int().nonnegative(),
+            error: zod_1.z.number().int().nonnegative(),
+            warning: zod_1.z.number().int().nonnegative(),
+            info: zod_1.z.number().int().nonnegative(),
+        }),
+        by_category: zod_1.z.record(zod_1.z.number()),
+        paths_checked: zod_1.z.number().int().nonnegative(),
+        constraints_checked: zod_1.z.number().int().nonnegative(),
+    }),
+    /** Validation metadata */
+    metadata: zod_1.z.object({
+        config_hash: zod_1.z.string(),
+        validated_at: zod_1.z.string().datetime(),
+        validation_duration_ms: zod_1.z.number(),
+        schema_used: zod_1.z.string().optional(),
+    }),
+});
+//# sourceMappingURL=config-validation-schemas.js.map

package/dist/bundled-agents/copilot-agents/functions/lib/services/agents/contracts/config-validation-schemas.js.map

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

package/dist/bundled-agents/copilot-agents/functions/lib/services/agents/contracts/decision-event.d.ts

@@ -0,0 +1,59 @@
+/**
+ * Agentics Global Agent Constitution - Decision Event Contract
+ *
+ * ALL agents MUST emit exactly ONE DecisionEvent per invocation.
+ * This is the canonical schema for agent outputs.
+ */
+import { z } from 'zod';
+/**
+ * Decision Event Schema - Required fields per constitution
+ */
+export declare const DecisionEventSchema: z.ZodObject<{
+    /** Unique identifier for the agent */
+    agent_id: z.ZodString;
+    /** Semantic version of the agent */
+    agent_version: z.ZodString;
+    /** Type of decision made by this agent */
+    decision_type: z.ZodString;
+    /** SHA-256 hash of inputs for determinism verification */
+    inputs_hash: z.ZodString;
+    /** Agent outputs - structure varies by decision_type */
+    outputs: z.ZodUnknown;
+    /** Confidence score (0.0 - 1.0) */
+    confidence: z.ZodNumber;
+    /** Constraints applied during decision-making */
+    constraints_applied: z.ZodArray<z.ZodString, "many">;
+    /** Reference ID for execution tracing */
+    execution_ref: z.ZodString;
+    /** UTC timestamp of decision */
+    timestamp: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    agent_id: string;
+    agent_version: string;
+    decision_type: string;
+    inputs_hash: string;
+    confidence: number;
+    constraints_applied: string[];
+    execution_ref: string;
+    timestamp: string;
+    outputs?: unknown;
+}, {
+    agent_id: string;
+    agent_version: string;
+    decision_type: string;
+    inputs_hash: string;
+    confidence: number;
+    constraints_applied: string[];
+    execution_ref: string;
+    timestamp: string;
+    outputs?: unknown;
+}>;
+export type DecisionEvent = z.infer<typeof DecisionEventSchema>;
+/**
+ * Create a deterministic hash of inputs for reproducibility verification
+ */
+export declare function hashInputs(inputs: unknown): string;
+/**
+ * Validate and create a DecisionEvent
+ */
+export declare function createDecisionEvent(agentId: string, agentVersion: string, decisionType: string, inputs: unknown, outputs: unknown, confidence: number, constraintsApplied: string[], executionRef: string): DecisionEvent;

package/dist/bundled-agents/copilot-agents/functions/lib/services/agents/contracts/decision-event.js

@@ -0,0 +1,62 @@
+"use strict";
+/**
+ * Agentics Global Agent Constitution - Decision Event Contract
+ *
+ * ALL agents MUST emit exactly ONE DecisionEvent per invocation.
+ * This is the canonical schema for agent outputs.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DecisionEventSchema = void 0;
+exports.hashInputs = hashInputs;
+exports.createDecisionEvent = createDecisionEvent;
+const zod_1 = require("zod");
+const crypto_1 = require("crypto");
+/**
+ * Decision Event Schema - Required fields per constitution
+ */
+exports.DecisionEventSchema = zod_1.z.object({
+    /** Unique identifier for the agent */
+    agent_id: zod_1.z.string().min(1),
+    /** Semantic version of the agent */
+    agent_version: zod_1.z.string().regex(/^\d+\.\d+\.\d+$/),
+    /** Type of decision made by this agent */
+    decision_type: zod_1.z.string().min(1),
+    /** SHA-256 hash of inputs for determinism verification */
+    inputs_hash: zod_1.z.string().length(64),
+    /** Agent outputs - structure varies by decision_type */
+    outputs: zod_1.z.unknown(),
+    /** Confidence score (0.0 - 1.0) */
+    confidence: zod_1.z.number().min(0).max(1),
+    /** Constraints applied during decision-making */
+    constraints_applied: zod_1.z.array(zod_1.z.string()),
+    /** Reference ID for execution tracing */
+    execution_ref: zod_1.z.string().uuid(),
+    /** UTC timestamp of decision */
+    timestamp: zod_1.z.string().datetime(),
+});
+/**
+ * Create a deterministic hash of inputs for reproducibility verification
+ */
+function hashInputs(inputs) {
+    const normalized = JSON.stringify(inputs, Object.keys(inputs).sort());
+    return (0, crypto_1.createHash)('sha256').update(normalized).digest('hex');
+}
+/**
+ * Validate and create a DecisionEvent
+ */
+function createDecisionEvent(agentId, agentVersion, decisionType, inputs, outputs, confidence, constraintsApplied, executionRef) {
+    const event = {
+        agent_id: agentId,
+        agent_version: agentVersion,
+        decision_type: decisionType,
+        inputs_hash: hashInputs(inputs),
+        outputs,
+        confidence,
+        constraints_applied: constraintsApplied,
+        execution_ref: executionRef,
+        timestamp: new Date().toISOString(),
+    };
+    // Validate against schema
+    return exports.DecisionEventSchema.parse(event);
+}
+//# sourceMappingURL=decision-event.js.map

package/dist/bundled-agents/copilot-agents/functions/lib/services/agents/contracts/decision-event.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"decision-event.js","sourceRoot":"","sources":["../../../../../services/agents/contracts/decision-event.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;AA0CH,gCAGC;AAKD,kDAwBC;AAxED,6BAAwB;AACxB,mCAAoC;AAEpC;;GAEG;AACU,QAAA,mBAAmB,GAAG,OAAC,CAAC,MAAM,CAAC;IAC1C,sCAAsC;IACtC,QAAQ,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAE3B,oCAAoC;IACpC,aAAa,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,iBAAiB,CAAC;IAElD,0CAA0C;IAC1C,aAAa,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAEhC,0DAA0D;IAC1D,WAAW,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,MAAM,CAAC,EAAE,CAAC;IAElC,wDAAwD;IACxD,OAAO,EAAE,OAAC,CAAC,OAAO,EAAE;IAEpB,mCAAmC;IACnC,UAAU,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IAEpC,iDAAiD;IACjD,mBAAmB,EAAE,OAAC,CAAC,KAAK,CAAC,OAAC,CAAC,MAAM,EAAE,CAAC;IAExC,yCAAyC;IACzC,aAAa,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE;IAEhC,gCAAgC;IAChC,SAAS,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CACjC,CAAC,CAAC;AAIH;;GAEG;AACH,SAAgB,UAAU,CAAC,MAAe;IACxC,MAAM,UAAU,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,IAAI,CAAC,MAAgB,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;IAChF,OAAO,IAAA,mBAAU,EAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAC/D,CAAC;AAED;;GAEG;AACH,SAAgB,mBAAmB,CACjC,OAAe,EACf,YAAoB,EACpB,YAAoB,EACpB,MAAe,EACf,OAAgB,EAChB,UAAkB,EAClB,kBAA4B,EAC5B,YAAoB;IAEpB,MAAM,KAAK,GAAkB;QAC3B,QAAQ,EAAE,OAAO;QACjB,aAAa,EAAE,YAAY;QAC3B,aAAa,EAAE,YAAY;QAC3B,WAAW,EAAE,UAAU,CAAC,MAAM,CAAC;QAC/B,OAAO;QACP,UAAU;QACV,mBAAmB,EAAE,kBAAkB;QACvC,aAAa,EAAE,YAAY;QAC3B,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;KACpC,CAAC;IAEF,0BAA0B;IAC1B,OAAO,2BAAmB,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;AAC1C,CAAC"}