@llm-dev-ops/agentics-cli 1.3.2 → 1.3.3

package/dist/commands/quantify.js.map

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

package/dist/commands/simulate.d.ts

@@ -5,9 +5,16 @@
  *
  * FLOW:
  * 1. Parse arguments → CommandObject
- * 2. Execute simulation via agentics-simulation-runner
- * 3. Record audit entry
- * 4. Return SimulationReference
+ * 2. VALIDATE request against contract (MUST pass before network call)
+ * 3. Execute simulation via agentics-simulation-runner
+ * 4. VALIDATE response has execution_metadata (reject if missing)
+ * 5. Record audit entry
+ * 6. Return SimulationReference
+ *
+ * CONTRACT ENFORCEMENT:
+ * - Request validation happens BEFORE any network call
+ * - Response validation requires execution_metadata
+ * - No bypass flags or soft-fail behavior
  */
 import type { CommandOptions, SimulationReference, PlanReference, FlexibleInput } from '../types/index.js';
 export interface SimulateCommandInput {

package/dist/commands/simulate.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"simulate.d.ts","sourceRoot":"","sources":["../../src/commands/simulate.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EACV,cAAc,EACd,mBAAmB,EACnB,aAAa,EACb,aAAa,EAEd,MAAM,mBAAmB,CAAC;AAgB3B,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,aAAa,CAAC,aAAa,CAAC,CAAC;IACtC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,qBAAqB;IACpC,SAAS,EAAE,mBAAmB,CAAC;IAC/B,MAAM,EAAE,MAAM,CAAC;CAChB;AAMD,wBAAsB,sBAAsB,CAC1C,KAAK,EAAE,oBAAoB,EAC3B,OAAO,EAAE,cAAc,GACtB,OAAO,CAAC,qBAAqB,CAAC,CA4FhC"}
+{"version":3,"file":"simulate.d.ts","sourceRoot":"","sources":["../../src/commands/simulate.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,KAAK,EACV,cAAc,EACd,mBAAmB,EACnB,aAAa,EACb,aAAa,EAEd,MAAM,mBAAmB,CAAC;AAuB3B,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,aAAa,CAAC,aAAa,CAAC,CAAC;IACtC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,qBAAqB;IACpC,SAAS,EAAE,mBAAmB,CAAC;IAC/B,MAAM,EAAE,MAAM,CAAC;CAChB;AAMD,wBAAsB,sBAAsB,CAC1C,KAAK,EAAE,oBAAoB,EAC3B,OAAO,EAAE,cAAc,GACtB,OAAO,CAAC,qBAAqB,CAAC,CAqJhC"}

package/dist/commands/simulate.js

@@ -5,17 +5,25 @@
  *
  * FLOW:
  * 1. Parse arguments → CommandObject
- * 2. Execute simulation via agentics-simulation-runner
- * 3. Record audit entry
- * 4. Return SimulationReference
+ * 2. VALIDATE request against contract (MUST pass before network call)
+ * 3. Execute simulation via agentics-simulation-runner
+ * 4. VALIDATE response has execution_metadata (reject if missing)
+ * 5. Record audit entry
+ * 6. Return SimulationReference
+ *
+ * CONTRACT ENFORCEMENT:
+ * - Request validation happens BEFORE any network call
+ * - Response validation requires execution_metadata
+ * - No bypass flags or soft-fail behavior
  */
 import { isNaturalLanguage } from '../types/index.js';
-import { RunnerAdapter } from '../adapters/base-adapter.js';
+import { RunnerAdapter, SimulationEngineAdapter } from '../adapters/base-adapter.js';
 import { createOrchestrationEngine, } from '../modules/orchestration-engine.js';
 import { createArtifactHandoff } from '../modules/artifact-handoff.js';
 import { createAuditTrail } from '../audit/audit-trail.js';
 import { failFast } from '../errors/index.js';
 import { loadEndpointConfig } from '../config/endpoints.js';
+import { validateRequest, validateResponse, RequestSchemas, ResponseSchemas, } from '../contracts/validator.js';
 // ============================================================================
 // Simulate Command Implementation
 // ============================================================================
@@ -26,25 +34,65 @@ export async function executeSimulateCommand(input, options) {
     const engine = createOrchestrationEngine(correlationId);
     const handoff = createArtifactHandoff();
     const audit = createAuditTrail();
-    // Create adapter
+    // Create adapter - use simulation engine for natural language, runner for structured refs
+    const simulationConfig = loadEndpointConfig('agentics-simulation-engine');
     const runnerConfig = loadEndpointConfig('agentics-simulation-runner');
-    const runnerAdapter = new RunnerAdapter(runnerConfig, correlationId);
+    // Choose adapter based on input type
+    const useSimulationEngine = isNaturalLanguage(input.planRef);
+    const adapter = useSimulationEngine
+        ? new SimulationEngineAdapter(simulationConfig, correlationId)
+        : new RunnerAdapter(runnerConfig, correlationId);
+    // Select endpoint based on adapter type:
+    // - SimulationEngine uses /v1/simulate for natural language scenarios
+    // - Runner uses /v1/runner for structured plan references
+    const endpoint = useSimulationEngine ? '/v1/simulate' : '/v1/runner';
     // Define orchestration stages
     const stages = [
         {
             name: 'execute-simulation',
-            adapter: runnerAdapter,
+            adapter: adapter,
             request: {
-                endpoint: '/api/v1/simulations/execute',
+                endpoint,
                 method: 'POST',
-                buildBody: () => ({
-                    // Pass natural language input or structured reference unchanged
-                    plan_ref: isNaturalLanguage(input.planRef)
-                        ? { natural_language: input.planRef.description }
-                        : handoff.passthrough(input.planRef),
-                    config: input.config ?? {},
-                    iterations: input.iterations ?? 1,
-                }),
+                buildBody: () => {
+                    let requestBody;
+                    if (isNaturalLanguage(input.planRef)) {
+                        // ============================================================================
+                        // CONTRACT VALIDATION - Natural language scenario format
+                        // ============================================================================
+                        const scenarioId = `sim-${Date.now().toString(36)}-${crypto.randomUUID().slice(0, 8)}`;
+                        requestBody = {
+                            scenario: {
+                                id: scenarioId,
+                                name: 'CLI Simulation',
+                                description: input.planRef.description,
+                                tags: ['cli', 'enterprise'],
+                            },
+                            config: input.config ?? {},
+                            iterations: input.iterations ?? 1,
+                        };
+                    }
+                    else {
+                        // ============================================================================
+                        // CONTRACT VALIDATION - Structured plan reference format
+                        // ============================================================================
+                        const planRef = input.planRef;
+                        requestBody = {
+                            plan_ref: {
+                                id: planRef.id,
+                                type: 'PlanReference',
+                                repository: planRef.repository,
+                                created_at: planRef.created_at,
+                                checksum: planRef.checksum,
+                            },
+                            config: input.config ?? {},
+                            iterations: input.iterations ?? 1,
+                        };
+                    }
+                    // Validate request against contract BEFORE sending
+                    validateRequest(RequestSchemas.SIMULATE, requestBody, correlationId);
+                    return requestBody;
+                },
             },
         },
     ];
@@ -55,9 +103,12 @@ export async function executeSimulateCommand(input, options) {
             const failedStage = result.stages.find(s => s.status === 'failed');
             throw new Error(failedStage?.error?.message ?? 'Simulation failed');
         }
-        // Extract simulation reference
+        // ============================================================================
+        // RESPONSE VALIDATION - execution_metadata REQUIRED
+        // ============================================================================
         const simStage = result.stages.find(s => s.name === 'execute-simulation');
-        const simRef = handoff.extractReference(simStage?.response);
+        const validatedSimulation = validateResponse(ResponseSchemas.SIMULATION, simStage?.response, correlationId);
+        const simRef = handoff.extractReference(validatedSimulation);
         // Record audit entry
         const planRefId = isNaturalLanguage(input.planRef)
             ? `nl:${input.planRef.description.slice(0, 50)}`

package/dist/commands/simulate.js.map

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

package/dist/config/endpoints.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"endpoints.d.ts","sourceRoot":"","sources":["../../src/config/endpoints.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAQ1E,eAAO,MAAM,iBAAiB,EAAE,gBAyC/B,CAAC;AAMF,wBAAgB,kBAAkB,CAChC,WAAW,EAAE,MAAM,gBAAgB,EACnC,SAAS,CAAC,EAAE,OAAO,CAAC,cAAc,CAAC,GAClC,cAAc,CAMhB;AAED,wBAAgB,gBAAgB,CAC9B,SAAS,CAAC,EAAE,OAAO,CAAC,gBAAgB,CAAC,GACpC,gBAAgB,CAKlB"}
+{"version":3,"file":"endpoints.d.ts","sourceRoot":"","sources":["../../src/config/endpoints.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAS1E,eAAO,MAAM,iBAAiB,EAAE,gBAyC/B,CAAC;AAMF,wBAAgB,kBAAkB,CAChC,WAAW,EAAE,MAAM,gBAAgB,EACnC,SAAS,CAAC,EAAE,OAAO,CAAC,cAAc,CAAC,GAClC,cAAc,CAMhB;AAED,wBAAgB,gBAAgB,CAC9B,SAAS,CAAC,EAAE,OAAO,CAAC,gBAAgB,CAAC,GACpC,gBAAgB,CAKlB"}

package/dist/config/endpoints.js

@@ -12,45 +12,46 @@
 // ============================================================================
 // Default Endpoint Configuration
 // ============================================================================
+// Platform API base URL - all services route through the gateway
 const API_BASE = process.env['AGENTICS_API_URL'] ?? 'https://platform.agentics.dev';
 export const DEFAULT_ENDPOINTS = {
     'agentics-org-manifests': {
-        baseUrl: process.env['AGENTICS_MANIFESTS_URL'] ?? `${API_BASE}/v1/manifests`,
+        baseUrl: process.env['AGENTICS_MANIFESTS_URL'] ?? API_BASE,
         version: 'v1',
         timeout: 30000,
     },
     'agentics-simulation-planner': {
-        baseUrl: process.env['AGENTICS_PLANNER_URL'] ?? `${API_BASE}/v1/plans`,
+        baseUrl: process.env['AGENTICS_PLANNER_URL'] ?? API_BASE,
         version: 'v1',
         timeout: 60000,
     },
     'agentics-simulation-runner': {
-        baseUrl: process.env['AGENTICS_RUNNER_URL'] ?? `${API_BASE}/v1/runner`,
+        baseUrl: process.env['AGENTICS_RUNNER_URL'] ?? API_BASE,
         version: 'v1',
         timeout: 300000, // 5 minutes for simulations
     },
     'agentics-simulation-engine': {
-        baseUrl: process.env['AGENTICS_SIMULATION_ENGINE_URL'] ?? `${API_BASE}/v1/simulate`,
+        baseUrl: process.env['AGENTICS_SIMULATION_ENGINE_URL'] ?? API_BASE,
         version: 'v1',
         timeout: 120000, // 2 minutes for artifact retrieval
     },
     'enterprise-roi-engine': {
-        baseUrl: process.env['ENTERPRISE_ROI_ENGINE_URL'] ?? `${API_BASE}/v1/roi`,
+        baseUrl: process.env['ENTERPRISE_ROI_ENGINE_URL'] ?? API_BASE,
         version: 'v1',
         timeout: 180000, // 3 minutes for ROI calculations
     },
     'agentics-deployment-intent': {
-        baseUrl: process.env['AGENTICS_INTENT_URL'] ?? `${API_BASE}/v1/intent`,
+        baseUrl: process.env['AGENTICS_INTENT_URL'] ?? API_BASE,
         version: 'v1',
         timeout: 60000,
     },
     'agentics-deployment-exporters': {
-        baseUrl: process.env['AGENTICS_EXPORTERS_URL'] ?? `${API_BASE}/v1/exporters`,
+        baseUrl: process.env['AGENTICS_EXPORTERS_URL'] ?? API_BASE,
         version: 'v1',
         timeout: 120000,
     },
     'diligence-artifacts': {
-        baseUrl: process.env['DILIGENCE_URL'] ?? `${API_BASE}/v1/diligence`,
+        baseUrl: process.env['DILIGENCE_URL'] ?? API_BASE,
         version: 'v1',
         timeout: 180000,
     },

package/dist/config/endpoints.js.map

@@ -1 +1 @@
-{"version":3,"file":"endpoints.js","sourceRoot":"","sources":["../../src/config/endpoints.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAIH,+EAA+E;AAC/E,iCAAiC;AACjC,+EAA+E;AAE/E,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,kBAAkB,CAAC,IAAI,+BAA+B,CAAC;AAEpF,MAAM,CAAC,MAAM,iBAAiB,GAAqB;IACjD,wBAAwB,EAAE;QACxB,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,wBAAwB,CAAC,IAAI,GAAG,QAAQ,eAAe;QAC5E,OAAO,EAAE,IAAI;QACb,OAAO,EAAE,KAAK;KACf;IACD,6BAA6B,EAAE;QAC7B,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,sBAAsB,CAAC,IAAI,GAAG,QAAQ,WAAW;QACtE,OAAO,EAAE,IAAI;QACb,OAAO,EAAE,KAAK;KACf;IACD,4BAA4B,EAAE;QAC5B,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,qBAAqB,CAAC,IAAI,GAAG,QAAQ,YAAY;QACtE,OAAO,EAAE,IAAI;QACb,OAAO,EAAE,MAAM,EAAE,4BAA4B;KAC9C;IACD,4BAA4B,EAAE;QAC5B,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,gCAAgC,CAAC,IAAI,GAAG,QAAQ,cAAc;QACnF,OAAO,EAAE,IAAI;QACb,OAAO,EAAE,MAAM,EAAE,mCAAmC;KACrD;IACD,uBAAuB,EAAE;QACvB,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,2BAA2B,CAAC,IAAI,GAAG,QAAQ,SAAS;QACzE,OAAO,EAAE,IAAI;QACb,OAAO,EAAE,MAAM,EAAE,iCAAiC;KACnD;IACD,4BAA4B,EAAE;QAC5B,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,qBAAqB,CAAC,IAAI,GAAG,QAAQ,YAAY;QACtE,OAAO,EAAE,IAAI;QACb,OAAO,EAAE,KAAK;KACf;IACD,+BAA+B,EAAE;QAC/B,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,wBAAwB,CAAC,IAAI,GAAG,QAAQ,eAAe;QAC5E,OAAO,EAAE,IAAI;QACb,OAAO,EAAE,MAAM;KAChB;IACD,qBAAqB,EAAE;QACrB,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC,IAAI,GAAG,QAAQ,eAAe;QACnE,OAAO,EAAE,IAAI;QACb,OAAO,EAAE,MAAM;KAChB;CACF,CAAC;AAEF,+EAA+E;AAC/E,uBAAuB;AACvB,+EAA+E;AAE/E,MAAM,UAAU,kBAAkB,CAChC,WAAmC,EACnC,SAAmC;IAEnC,MAAM,QAAQ,GAAG,iBAAiB,CAAC,WAAW,CAAC,CAAC;IAChD,OAAO;QACL,GAAG,QAAQ;QACX,GAAG,SAAS;KACb,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,gBAAgB,CAC9B,SAAqC;IAErC,OAAO;QACL,GAAG,iBAAiB;QACpB,GAAG,SAAS;KACb,CAAC;AACJ,CAAC"}
+{"version":3,"file":"endpoints.js","sourceRoot":"","sources":["../../src/config/endpoints.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAIH,+EAA+E;AAC/E,iCAAiC;AACjC,+EAA+E;AAE/E,iEAAiE;AACjE,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,kBAAkB,CAAC,IAAI,+BAA+B,CAAC;AAEpF,MAAM,CAAC,MAAM,iBAAiB,GAAqB;IACjD,wBAAwB,EAAE;QACxB,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,wBAAwB,CAAC,IAAI,QAAQ;QAC1D,OAAO,EAAE,IAAI;QACb,OAAO,EAAE,KAAK;KACf;IACD,6BAA6B,EAAE;QAC7B,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,sBAAsB,CAAC,IAAI,QAAQ;QACxD,OAAO,EAAE,IAAI;QACb,OAAO,EAAE,KAAK;KACf;IACD,4BAA4B,EAAE;QAC5B,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,qBAAqB,CAAC,IAAI,QAAQ;QACvD,OAAO,EAAE,IAAI;QACb,OAAO,EAAE,MAAM,EAAE,4BAA4B;KAC9C;IACD,4BAA4B,EAAE;QAC5B,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,gCAAgC,CAAC,IAAI,QAAQ;QAClE,OAAO,EAAE,IAAI;QACb,OAAO,EAAE,MAAM,EAAE,mCAAmC;KACrD;IACD,uBAAuB,EAAE;QACvB,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,2BAA2B,CAAC,IAAI,QAAQ;QAC7D,OAAO,EAAE,IAAI;QACb,OAAO,EAAE,MAAM,EAAE,iCAAiC;KACnD;IACD,4BAA4B,EAAE;QAC5B,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,qBAAqB,CAAC,IAAI,QAAQ;QACvD,OAAO,EAAE,IAAI;QACb,OAAO,EAAE,KAAK;KACf;IACD,+BAA+B,EAAE;QAC/B,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,wBAAwB,CAAC,IAAI,QAAQ;QAC1D,OAAO,EAAE,IAAI;QACb,OAAO,EAAE,MAAM;KAChB;IACD,qBAAqB,EAAE;QACrB,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC,IAAI,QAAQ;QACjD,OAAO,EAAE,IAAI;QACb,OAAO,EAAE,MAAM;KAChB;CACF,CAAC;AAEF,+EAA+E;AAC/E,uBAAuB;AACvB,+EAA+E;AAE/E,MAAM,UAAU,kBAAkB,CAChC,WAAmC,EACnC,SAAmC;IAEnC,MAAM,QAAQ,GAAG,iBAAiB,CAAC,WAAW,CAAC,CAAC;IAChD,OAAO;QACL,GAAG,QAAQ;QACX,GAAG,SAAS;KACb,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,gBAAgB,CAC9B,SAAqC;IAErC,OAAO;QACL,GAAG,iBAAiB;QACpB,GAAG,SAAS;KACb,CAAC;AACJ,CAAC"}

package/dist/contracts/index.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Contract Exports
+ *
+ * PURPOSE: Re-export contract validation functionality.
+ * All schemas now come from @agentics/contracts - the canonical source.
+ *
+ * PRINCIPLES:
+ * - Contracts are the SOLE source of truth
+ * - All validation uses canonical schemas from @agentics/contracts
+ * - No fallback logic or guessing
+ * - Invalid payloads fail immediately
+ *
+ * EXECUTION PROOF REQUIREMENTS:
+ * All responses MUST include:
+ * 1. execution_metadata - proves execution graph participation
+ * 2. Multi-layer proof (layers_executed OR execution_graph)
+ */
+export { validateRequest, validateResponse, safeValidateRequest, safeValidateResponse, ContractValidationError, RequestSchemas, ResponseSchemas, } from './validator.js';
+export type { ValidationResult, } from './validator.js';
+export type { PlanRequestContract, ManifestsRequestContract, SimulateRequestContract, InspectRequestContract, QuantifyRequestContract, DeployRequestContract, ExportRequestContract, DiligenceRequestContract, ExecutionMetadata, LayerExecutionRecord, ExecutionGraph, } from './validator.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/contracts/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/contracts/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAGH,OAAO,EACL,eAAe,EACf,gBAAgB,EAChB,mBAAmB,EACnB,oBAAoB,EACpB,uBAAuB,EACvB,cAAc,EACd,eAAe,GAChB,MAAM,gBAAgB,CAAC;AAExB,YAAY,EACV,gBAAgB,GACjB,MAAM,gBAAgB,CAAC;AAGxB,YAAY,EACV,mBAAmB,EACnB,wBAAwB,EACxB,uBAAuB,EACvB,sBAAsB,EACtB,uBAAuB,EACvB,qBAAqB,EACrB,qBAAqB,EACrB,wBAAwB,EACxB,iBAAiB,EACjB,oBAAoB,EACpB,cAAc,GACf,MAAM,gBAAgB,CAAC"}

package/dist/contracts/index.js

@@ -0,0 +1,20 @@
+/**
+ * Contract Exports
+ *
+ * PURPOSE: Re-export contract validation functionality.
+ * All schemas now come from @agentics/contracts - the canonical source.
+ *
+ * PRINCIPLES:
+ * - Contracts are the SOLE source of truth
+ * - All validation uses canonical schemas from @agentics/contracts
+ * - No fallback logic or guessing
+ * - Invalid payloads fail immediately
+ *
+ * EXECUTION PROOF REQUIREMENTS:
+ * All responses MUST include:
+ * 1. execution_metadata - proves execution graph participation
+ * 2. Multi-layer proof (layers_executed OR execution_graph)
+ */
+// Export validator and types
+export { validateRequest, validateResponse, safeValidateRequest, safeValidateResponse, ContractValidationError, RequestSchemas, ResponseSchemas, } from './validator.js';
+//# sourceMappingURL=index.js.map

package/dist/contracts/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/contracts/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,6BAA6B;AAC7B,OAAO,EACL,eAAe,EACf,gBAAgB,EAChB,mBAAmB,EACnB,oBAAoB,EACpB,uBAAuB,EACvB,cAAc,EACd,eAAe,GAChB,MAAM,gBAAgB,CAAC"}

package/dist/contracts/validator.d.ts

@@ -0,0 +1,62 @@
+/**
+ * Contract Validator
+ *
+ * PURPOSE: Single validation boundary for all CLI commands.
+ * Uses Ajv in STRICT mode - no coercion, no defaults, no bypass.
+ *
+ * RULES:
+ * - Invalid requests FAIL LOCALLY (no network call)
+ * - Invalid responses FAIL HARD (missing execution proof = reject)
+ * - Responses MUST have execution_metadata AND multi-layer proof
+ * - Multi-layer proof: layers_executed array AND/OR execution_graph
+ * - No soft-fail behavior
+ * - No bypass flags
+ *
+ * IMPORTS: All schemas from @agentics/contracts (the canonical source)
+ */
+import { CLIError } from '../errors/index.js';
+import { RequestSchemas, ResponseSchemas } from '@agentics/contracts';
+export type { PlanRequestContract, ManifestsRequestContract, SimulateRequestContract, InspectRequestContract, QuantifyRequestContract, DeployRequestContract, ExportRequestContract, DiligenceRequestContract, ExecutionMetadata, LayerExecutionRecord, ExecutionGraph, } from '@agentics/contracts';
+export { RequestSchemas, ResponseSchemas };
+type RequestSchemaName = 'plan' | 'simulate' | 'inspect' | 'quantify' | 'deploy' | 'export' | 'diligence' | 'manifests' | 'plans';
+type ResponseSchemaName = 'base' | 'manifest' | 'plan' | 'simulation' | 'simulationOutput' | 'roiReport' | 'intent' | 'export' | 'diligencePackage';
+export declare class ContractValidationError extends CLIError {
+    readonly validationErrors: object[];
+    constructor(options: {
+        type: 'request' | 'response';
+        schemaName: string;
+        errors: object[];
+        data?: unknown;
+        correlationId?: string;
+    });
+}
+/**
+ * Validate a request payload against its contract schema.
+ * MUST be called BEFORE any network request.
+ *
+ * @throws ContractValidationError if validation fails
+ */
+export declare function validateRequest<T>(schemaName: RequestSchemaName, data: unknown, correlationId?: string): T;
+/**
+ * Validate a response payload against its contract schema.
+ * CRITICAL: This enforces:
+ * 1. execution_metadata REQUIRED
+ * 2. Multi-layer execution proof (layers_executed AND/OR execution_graph)
+ *
+ * @throws ContractValidationError if validation fails or execution proof missing
+ */
+export declare function validateResponse<T>(schemaName: ResponseSchemaName, data: unknown, correlationId?: string): T;
+export type ValidationResult<T> = {
+    valid: true;
+    data: T;
+} | {
+    valid: false;
+    error: ContractValidationError;
+};
+/**
+ * Safe validation that returns a result object instead of throwing.
+ * Useful for conditional handling in some scenarios.
+ */
+export declare function safeValidateRequest<T>(schemaName: RequestSchemaName, data: unknown, correlationId?: string): ValidationResult<T>;
+export declare function safeValidateResponse<T>(schemaName: ResponseSchemaName, data: unknown, correlationId?: string): ValidationResult<T>;
+//# sourceMappingURL=validator.d.ts.map

package/dist/contracts/validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validator.d.ts","sourceRoot":"","sources":["../../src/contracts/validator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAKH,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAG9C,OAAO,EAwBL,cAAc,EACd,eAAe,EAChB,MAAM,qBAAqB,CAAC;AAG7B,YAAY,EACV,mBAAmB,EACnB,wBAAwB,EACxB,uBAAuB,EACvB,sBAAsB,EACtB,uBAAuB,EACvB,qBAAqB,EACrB,qBAAqB,EACrB,wBAAwB,EACxB,iBAAiB,EACjB,oBAAoB,EACpB,cAAc,GACf,MAAM,qBAAqB,CAAC;AAG7B,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,CAAC;AAgC3C,KAAK,iBAAiB,GAClB,MAAM,GACN,UAAU,GACV,SAAS,GACT,UAAU,GACV,QAAQ,GACR,QAAQ,GACR,WAAW,GACX,WAAW,GACX,OAAO,CAAC;AAkBZ,KAAK,kBAAkB,GACnB,MAAM,GACN,UAAU,GACV,MAAM,GACN,YAAY,GACZ,kBAAkB,GAClB,WAAW,GACX,QAAQ,GACR,QAAQ,GACR,kBAAkB,CAAC;AA2CvB,qBAAa,uBAAwB,SAAQ,QAAQ;IACnD,QAAQ,CAAC,gBAAgB,EAAE,MAAM,EAAE,CAAC;gBAExB,OAAO,EAAE;QACnB,IAAI,EAAE,SAAS,GAAG,UAAU,CAAC;QAC7B,UAAU,EAAE,MAAM,CAAC;QACnB,MAAM,EAAE,MAAM,EAAE,CAAC;QACjB,IAAI,CAAC,EAAE,OAAO,CAAC;QACf,aAAa,CAAC,EAAE,MAAM,CAAC;KACxB;CAyBF;AAMD;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,CAAC,EAC/B,UAAU,EAAE,iBAAiB,EAC7B,IAAI,EAAE,OAAO,EACb,aAAa,CAAC,EAAE,MAAM,GACrB,CAAC,CAeH;AAMD;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,EAChC,UAAU,EAAE,kBAAkB,EAC9B,IAAI,EAAE,OAAO,EACb,aAAa,CAAC,EAAE,MAAM,GACrB,CAAC,CAqDH;AA2LD,MAAM,MAAM,gBAAgB,CAAC,CAAC,IAC1B;IAAE,KAAK,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,CAAC,CAAA;CAAE,GACxB;IAAE,KAAK,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,uBAAuB,CAAA;CAAE,CAAC;AAErD;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,CAAC,EACnC,UAAU,EAAE,iBAAiB,EAC7B,IAAI,EAAE,OAAO,EACb,aAAa,CAAC,EAAE,MAAM,GACrB,gBAAgB,CAAC,CAAC,CAAC,CAUrB;AAED,wBAAgB,oBAAoB,CAAC,CAAC,EACpC,UAAU,EAAE,kBAAkB,EAC9B,IAAI,EAAE,OAAO,EACb,aAAa,CAAC,EAAE,MAAM,GACrB,gBAAgB,CAAC,CAAC,CAAC,CAUrB"}