@llm-dev-ops/agentics-cli 1.3.7 → 1.3.9

package/dist/commands/inspect.js

@@ -1,149 +1,603 @@
 /**
- * Inspect Command
+ * Inspect Command - Standalone Read-Only HTTP Command
  *
- * SPARC Pseudocode Reference: §2.6
+ * ARCHITECTURE:
+ * - This is a TERMINAL command with its own control flow
+ * - Does NOT participate in orchestration, retrieval, or execution pipelines
+ * - Issues direct HTTP GET requests to agentics-results-index
+ * - Has its own error handling and exit codes
+ * - No code path can fall through to simulation, planner, or execution services
  *
- * FLOW:
- * 1. Parse arguments → CommandObject
- * 2. VALIDATE request against contract (MUST pass before network call)
- * 3. Retrieve simulation output via agentics-simulation-engine
- * 4. VALIDATE response has execution_metadata (reject if missing)
- * 5. Record audit entry
- * 6. Return SimulationOutputReference
- *
- * CONTRACT ENFORCEMENT:
- * - Request validation happens BEFORE any network call
- * - Response validation requires execution_metadata
- * - No bypass flags or soft-fail behavior
+ * ROUTING:
+ * - Routes EXCLUSIVELY to agentics-results-index
+ * - NO routing to execution, planning, or simulation services
+ * - Read-only operation - performs NO mutations
  */
 import { isNaturalLanguage } from '../types/index.js';
-import { 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, toError } from '../errors/index.js';
-import { loadEndpointConfig } from '../config/endpoints.js';
-import { validateRequest, validateResponse, RequestSchemas, ResponseSchemas, } from '../contracts/validator.js';
+import { CLIError } from '../errors/index.js';
 // ============================================================================
-// Inspect Command Implementation
+// Inspect-Specific Exit Codes
 // ============================================================================
-export async function executeInspectCommand(input, options) {
-    const correlationId = options.trace_id ?? crypto.randomUUID();
-    const startTime = Date.now();
-    // Initialize components
-    const engine = createOrchestrationEngine(correlationId);
-    const handoff = createArtifactHandoff();
-    const audit = createAuditTrail();
-    // Create adapter
-    const engineConfig = loadEndpointConfig('agentics-simulation-engine');
-    const engineAdapter = new SimulationEngineAdapter(engineConfig, correlationId);
-    // Default depth
-    const depth = input.depth ?? 'summary';
-    // Define orchestration stages
-    const stages = [
-        {
-            name: 'retrieve-output',
-            adapter: engineAdapter,
-            request: {
-                endpoint: '/v1/simulate',
-                method: 'POST',
-                buildBody: () => {
-                    let requestBody;
-                    if (isNaturalLanguage(input.simRef)) {
-                        // ============================================================================
-                        // CONTRACT VALIDATION - Natural language format
-                        // ============================================================================
-                        requestBody = {
-                            sim_ref: {
-                                natural_language: input.simRef.description,
-                            },
-                            depth,
-                            include_metrics: input.includeMetrics,
-                            include_traces: input.includeTraces,
-                        };
-                    }
-                    else {
-                        // ============================================================================
-                        // CONTRACT VALIDATION - Structured reference format
-                        // ============================================================================
-                        const simRef = input.simRef;
-                        requestBody = {
-                            sim_ref: {
-                                id: simRef.id,
-                                type: 'SimulationReference',
-                                repository: simRef.repository,
-                                created_at: simRef.created_at,
-                                checksum: simRef.checksum,
-                            },
-                            depth,
-                            include_metrics: input.includeMetrics,
-                            include_traces: input.includeTraces,
-                        };
-                    }
-                    // Validate request against contract BEFORE sending
-                    validateRequest(RequestSchemas.INSPECT, requestBody, correlationId);
-                    return requestBody;
-                },
+export const INSPECT_EXIT_CODES = {
+    SUCCESS: 0,
+    INPUT_ERROR: 100,
+    SERVICE_UNAVAILABLE: 69,
+    TIMEOUT: 75,
+    NETWORK_ERROR: 120,
+    UNEXPECTED_ERROR: 1,
+};
+// ============================================================================
+// Endpoint Configuration (Standalone - No Shared Config)
+// ============================================================================
+/**
+ * Get the results-index endpoint URL.
+ * Uses environment variable override or production default.
+ */
+function getResultsIndexUrl() {
+    const envUrl = process.env['AGENTICS_RESULTS_INDEX_URL'];
+    if (envUrl) {
+        return envUrl;
+    }
+    return 'https://agentics-results-index-1062287243982.us-central1.run.app';
+}
+/**
+ * Get the request timeout in milliseconds.
+ */
+function getRequestTimeout() {
+    const envTimeout = process.env['AGENTICS_RESULTS_INDEX_TIMEOUT'];
+    if (envTimeout) {
+        const parsed = parseInt(envTimeout, 10);
+        if (!isNaN(parsed) && parsed > 0) {
+            return parsed;
+        }
+    }
+    return 30000; // 30 seconds default
+}
+// ============================================================================
+// Natural Language Query Parser
+// ============================================================================
+/**
+ * Translate free-form natural language input into structured query parameters.
+ * Recognizes common patterns like "last production test", "latest run", etc.
+ */
+function parseNaturalLanguageQuery(description) {
+    const lower = description.toLowerCase().trim();
+    const params = {
+        order: 'newest', // Default to newest-first for all queries
+        limit: 10, // Default limit
+    };
+    // Environment detection
+    if (lower.includes('production') || lower.includes('prod')) {
+        params.environment = 'production';
+    }
+    else if (lower.includes('staging') || lower.includes('stage')) {
+        params.environment = 'staging';
+    }
+    else if (lower.includes('development') || lower.includes('dev')) {
+        params.environment = 'development';
+    }
+    else if (lower.includes('test')) {
+        params.environment = 'test';
+    }
+    // Status detection
+    if (lower.includes('failed') || lower.includes('failure') || lower.includes('error')) {
+        params.status = 'failed';
+    }
+    else if (lower.includes('completed') || lower.includes('success') || lower.includes('passed')) {
+        params.status = 'completed';
+    }
+    else if (lower.includes('running') || lower.includes('in progress') || lower.includes('active')) {
+        params.status = 'running';
+    }
+    else if (lower.includes('pending') || lower.includes('queued') || lower.includes('waiting')) {
+        params.status = 'pending';
+    }
+    // Limit detection
+    if (lower.includes('last') || lower.includes('latest') || lower.includes('most recent')) {
+        // Check for specific numbers
+        const numberMatch = lower.match(/last\s+(\d+)/);
+        if (numberMatch && numberMatch[1]) {
+            params.limit = Math.min(parseInt(numberMatch[1], 10), 100);
+        }
+        else {
+            params.limit = 1; // "last" without number means just one
+        }
+    }
+    else if (lower.includes('all')) {
+        params.limit = 100; // Cap at 100 for safety
+    }
+    // Order detection (override default if explicitly specified)
+    if (lower.includes('oldest') || lower.includes('first') || lower.includes('earliest')) {
+        params.order = 'oldest';
+    }
+    return params;
+}
+// ============================================================================
+// Input Validation (Standalone)
+// ============================================================================
+/**
+ * Validate query parameters. Throws InspectError on invalid input.
+ */
+function validateQueryParams(params, correlationId) {
+    // Validate limit
+    if (params.limit !== undefined) {
+        if (params.limit < 1) {
+            throw new CLIError({
+                code: 'ECLI-INSPECT-001',
+                category: 'INPUT_ERROR',
+                message: 'Query limit must be at least 1',
+                details: { provided_limit: params.limit },
+                module: 'inspect',
+                correlationId,
+                recoverable: false,
+                exitCode: INSPECT_EXIT_CODES.INPUT_ERROR,
+            });
+        }
+        if (params.limit > 100) {
+            throw new CLIError({
+                code: 'ECLI-INSPECT-002',
+                category: 'INPUT_ERROR',
+                message: 'Query limit cannot exceed 100 results',
+                details: { provided_limit: params.limit, max_limit: 100 },
+                module: 'inspect',
+                correlationId,
+                recoverable: false,
+                exitCode: INSPECT_EXIT_CODES.INPUT_ERROR,
+            });
+        }
+    }
+    // Validate environment if provided
+    const validEnvironments = ['production', 'staging', 'development', 'test'];
+    if (params.environment && !validEnvironments.includes(params.environment)) {
+        throw new CLIError({
+            code: 'ECLI-INSPECT-003',
+            category: 'INPUT_ERROR',
+            message: `Invalid environment filter: ${params.environment}`,
+            details: {
+                provided: params.environment,
+                valid_options: validEnvironments,
+            },
+            module: 'inspect',
+            correlationId,
+            recoverable: false,
+            exitCode: INSPECT_EXIT_CODES.INPUT_ERROR,
+        });
+    }
+    // Validate status if provided
+    const validStatuses = ['completed', 'failed', 'running', 'pending'];
+    if (params.status && !validStatuses.includes(params.status)) {
+        throw new CLIError({
+            code: 'ECLI-INSPECT-004',
+            category: 'INPUT_ERROR',
+            message: `Invalid status filter: ${params.status}`,
+            details: {
+                provided: params.status,
+                valid_options: validStatuses,
+            },
+            module: 'inspect',
+            correlationId,
+            recoverable: false,
+            exitCode: INSPECT_EXIT_CODES.INPUT_ERROR,
+        });
+    }
+    // Validate order if provided
+    const validOrders = ['newest', 'oldest'];
+    if (params.order && !validOrders.includes(params.order)) {
+        throw new CLIError({
+            code: 'ECLI-INSPECT-005',
+            category: 'INPUT_ERROR',
+            message: `Invalid order: ${params.order}`,
+            details: {
+                provided: params.order,
+                valid_options: validOrders,
             },
-        },
-    ];
+            module: 'inspect',
+            correlationId,
+            recoverable: false,
+            exitCode: INSPECT_EXIT_CODES.INPUT_ERROR,
+        });
+    }
+}
+// ============================================================================
+// Result Formatting
+// ============================================================================
+/**
+ * Format simulation results for human-readable terminal output.
+ */
+export function formatResultsForDisplay(results) {
+    if (results.length === 0) {
+        return 'No simulation results found matching the query.';
+    }
+    const lines = [];
+    lines.push(`Found ${results.length} result${results.length === 1 ? '' : 's'}:`);
+    lines.push('');
+    for (const result of results) {
+        const statusIcon = getStatusIcon(result.status);
+        const duration = result.duration_ms ? `${(result.duration_ms / 1000).toFixed(1)}s` : 'N/A';
+        const completedAt = result.completed_at
+            ? new Date(result.completed_at).toLocaleString()
+            : 'In progress';
+        lines.push(`${statusIcon} ${result.id}`);
+        lines.push(`   Environment: ${result.environment}`);
+        lines.push(`   Status:      ${result.status}`);
+        lines.push(`   Created:     ${new Date(result.created_at).toLocaleString()}`);
+        lines.push(`   Completed:   ${completedAt}`);
+        lines.push(`   Duration:    ${duration}`);
+        if (result.summary) {
+            lines.push(`   Summary:     ${result.summary}`);
+        }
+        lines.push('');
+    }
+    return lines.join('\n');
+}
+function getStatusIcon(status) {
+    switch (status) {
+        case 'completed':
+            return '[OK]';
+        case 'failed':
+            return '[FAIL]';
+        case 'running':
+            return '[...]';
+        case 'pending':
+            return '[WAIT]';
+        default:
+            return '[?]';
+    }
+}
+// ============================================================================
+// Direct HTTP Request (No Shared Adapter)
+// ============================================================================
+/**
+ * Build the query URL for the results-index service.
+ */
+function buildQueryUrl(baseUrl, params) {
+    const url = new URL('/v1/results', baseUrl);
+    if (params.environment) {
+        url.searchParams.set('environment', params.environment);
+    }
+    if (params.status) {
+        url.searchParams.set('status', params.status);
+    }
+    if (params.limit !== undefined) {
+        url.searchParams.set('limit', params.limit.toString());
+    }
+    if (params.order) {
+        url.searchParams.set('order', params.order);
+    }
+    if (params.id) {
+        url.searchParams.set('id', params.id);
+    }
+    return url.toString();
+}
+/**
+ * Execute a direct HTTP GET request to the results-index service.
+ * This is a standalone implementation that does not use shared adapters.
+ */
+async function executeHttpGet(url, timeout, correlationId) {
+    const startTime = Date.now();
+    const controller = new AbortController();
+    const timeoutId = setTimeout(() => controller.abort(), timeout);
     try {
-        // Execute orchestration
-        const result = await engine.execute(stages, options);
-        if (!result.success) {
-            const failedStage = result.stages.find(s => s.status === 'failed');
-            throw new Error(failedStage?.error?.message ?? 'Output retrieval failed');
-        }
-        // ============================================================================
-        // RESPONSE VALIDATION - execution_metadata REQUIRED
-        // ============================================================================
-        const outputStage = result.stages.find(s => s.name === 'retrieve-output');
-        const validatedOutput = validateResponse(ResponseSchemas.SIMULATION_OUTPUT, outputStage?.response, correlationId);
-        const outputRef = handoff.extractReference(validatedOutput);
-        // Record audit entry
-        const simRefId = isNaturalLanguage(input.simRef)
-            ? `nl:${input.simRef.description.slice(0, 50)}`
-            : input.simRef.id;
-        audit.record({
-            command: 'inspect',
-            inputs: { simRef: simRefId, depth },
-            outputs: outputRef,
-            dependencies: [
-                { service: 'agentics-simulation-engine', method: 'retrieve', timestamp: new Date().toISOString(), duration_ms: result.timing.total, success: true },
-            ],
-            duration_ms: result.timing.total,
-            status: 'SUCCESS',
-            trace_id: correlationId,
+        const response = await fetch(url, {
+            method: 'GET',
+            headers: {
+                'Accept': 'application/json',
+                'X-Correlation-ID': correlationId,
+                'X-API-Version': 'v1',
+            },
+            signal: controller.signal,
         });
-        return {
-            reference: outputRef,
-            timing: Date.now() - startTime,
-        };
+        clearTimeout(timeoutId);
+        const timing = Date.now() - startTime;
+        // Parse response body
+        let body;
+        const contentType = response.headers.get('content-type') ?? '';
+        if (contentType.includes('application/json')) {
+            body = await response.json();
+        }
+        else {
+            body = await response.text();
+        }
+        return { body, timing, status: response.status };
     }
     catch (error) {
-        // Record failure in audit
-        const failedSimRefId = isNaturalLanguage(input.simRef)
-            ? `nl:${input.simRef.description.slice(0, 50)}`
-            : input.simRef.id;
-        audit.record({
-            command: 'inspect',
-            inputs: { simRef: failedSimRefId, depth },
-            outputs: null,
-            dependencies: [],
-            duration_ms: Date.now() - startTime,
-            status: 'FAILED',
-            error_code: error instanceof Error ? error.name : 'UNKNOWN',
-            error_message: error instanceof Error ? error.message : 'Unknown error',
-            trace_id: correlationId,
+        clearTimeout(timeoutId);
+        // Handle abort (timeout)
+        if (error instanceof Error && error.name === 'AbortError') {
+            throw new CLIError({
+                code: 'ECLI-INSPECT-TIMEOUT',
+                category: 'NETWORK_ERROR',
+                message: `Request timed out after ${timeout}ms`,
+                details: { timeout_ms: timeout },
+                module: 'inspect',
+                correlationId,
+                recoverable: true,
+                exitCode: INSPECT_EXIT_CODES.TIMEOUT,
+            });
+        }
+        // Handle network errors
+        if (error instanceof TypeError) {
+            throw new CLIError({
+                code: 'ECLI-INSPECT-NETWORK',
+                category: 'NETWORK_ERROR',
+                message: 'Unable to connect to the results service',
+                details: { hint: 'Check your network connection and try again.' },
+                module: 'inspect',
+                correlationId,
+                recoverable: true,
+                exitCode: INSPECT_EXIT_CODES.NETWORK_ERROR,
+            });
+        }
+        // Re-throw CLIErrors
+        if (error instanceof CLIError) {
+            throw error;
+        }
+        // Wrap unknown errors
+        throw new CLIError({
+            code: 'ECLI-INSPECT-UNKNOWN',
+            category: 'INTERNAL_ERROR',
+            message: error instanceof Error ? error.message : 'An unexpected error occurred',
+            module: 'inspect',
+            correlationId,
+            recoverable: false,
+            exitCode: INSPECT_EXIT_CODES.UNEXPECTED_ERROR,
+        });
+    }
+}
+// ============================================================================
+// Inspect Command Implementation (Standalone Terminal Command)
+// ============================================================================
+/**
+ * Execute the inspect command.
+ *
+ * This is a STANDALONE command that:
+ * - Does NOT use shared orchestration, retrieval, or execution helpers
+ * - Issues direct HTTP GET requests to agentics-results-index
+ * - Has its own error handling with inspect-specific exit codes
+ * - Cannot fall through to any other service
+ */
+export async function executeInspectCommand(input, options) {
+    const correlationId = options.trace_id ?? crypto.randomUUID();
+    const startTime = Date.now();
+    // Get endpoint configuration (standalone - no shared config loader)
+    const baseUrl = getResultsIndexUrl();
+    const timeout = options.timeout ?? getRequestTimeout();
+    // Build query parameters from input
+    let queryParams;
+    if (isNaturalLanguage(input.simRef)) {
+        // Translate natural language to structured query
+        const nlInput = input.simRef;
+        queryParams = parseNaturalLanguageQuery(nlInput.description);
+    }
+    else {
+        // Structured input - extract ID if present
+        const structuredInput = input.simRef;
+        queryParams = {
+            id: structuredInput.id,
+            order: 'newest',
+            limit: 1,
+        };
+    }
+    // Validate query parameters (throws on error - no fall-through)
+    validateQueryParams(queryParams, correlationId);
+    // Build request URL
+    const requestUrl = buildQueryUrl(baseUrl, queryParams);
+    // Execute direct HTTP GET request (no shared adapter)
+    const response = await executeHttpGet(requestUrl, timeout, correlationId);
+    // Handle non-2xx responses
+    if (response.status >= 400) {
+        // Extract error message from response body if available
+        let errorMessage = 'The results service returned an error';
+        if (typeof response.body === 'object' && response.body !== null) {
+            const body = response.body;
+            if (typeof body['message'] === 'string') {
+                errorMessage = body['message'];
+            }
+            else if (typeof body['error'] === 'string') {
+                errorMessage = body['error'];
+            }
+        }
+        if (response.status === 503 || response.status === 502 || response.status === 504) {
+            throw new CLIError({
+                code: 'ECLI-INSPECT-SERVICE-UNAVAILABLE',
+                category: 'NETWORK_ERROR',
+                message: 'The results service is currently unavailable. Please try again later.',
+                details: { hint: 'The service may be temporarily down for maintenance.' },
+                module: 'inspect',
+                correlationId,
+                recoverable: true,
+                exitCode: INSPECT_EXIT_CODES.SERVICE_UNAVAILABLE,
+            });
+        }
+        throw new CLIError({
+            code: `ECLI-INSPECT-HTTP-${response.status}`,
+            category: response.status >= 500 ? 'NETWORK_ERROR' : 'INPUT_ERROR',
+            message: errorMessage,
+            details: { http_status: response.status },
+            module: 'inspect',
+            correlationId,
+            recoverable: response.status >= 500,
+            exitCode: response.status >= 500
+                ? INSPECT_EXIT_CODES.SERVICE_UNAVAILABLE
+                : INSPECT_EXIT_CODES.INPUT_ERROR,
         });
-        // Fail fast
-        failFast({
-            command: 'inspect',
-            phase: 'retrieval',
-            upstreamError: toError(error),
-            inputs: input,
+    }
+    // Extract results from response body
+    const responseBody = response.body;
+    // Handle various response formats (newest-first is enforced by the service)
+    const results = responseBody.results ??
+        responseBody.data ??
+        responseBody.items ??
+        (Array.isArray(responseBody) ? responseBody : []);
+    // Return result - command terminates here
+    return {
+        results,
+        query: queryParams,
+        count: results.length,
+        timing: Date.now() - startTime,
+    };
+}
+// ============================================================================
+// Inspect Latest Subcommand Implementation
+// ============================================================================
+/**
+ * Execute the 'inspect latest' subcommand.
+ * Returns the most recent simulation result matching the filters.
+ */
+export async function executeInspectLatestCommand(input, options) {
+    const correlationId = options.trace_id ?? crypto.randomUUID();
+    const startTime = Date.now();
+    // Get endpoint configuration
+    const baseUrl = getResultsIndexUrl();
+    const timeout = options.timeout ?? getRequestTimeout();
+    // Build query for latest result
+    const queryParams = {
+        order: 'newest',
+        limit: 1,
+        environment: input.environment,
+        status: input.status,
+    };
+    // Validate query parameters
+    validateQueryParams(queryParams, correlationId);
+    // Build request URL
+    const requestUrl = buildQueryUrl(baseUrl, queryParams);
+    // Execute HTTP GET request
+    const response = await executeHttpGet(requestUrl, timeout, correlationId);
+    // Handle non-2xx responses
+    if (response.status >= 400) {
+        let errorMessage = 'The results service returned an error';
+        if (typeof response.body === 'object' && response.body !== null) {
+            const body = response.body;
+            if (typeof body['message'] === 'string') {
+                errorMessage = body['message'];
+            }
+            else if (typeof body['error'] === 'string') {
+                errorMessage = body['error'];
+            }
+        }
+        if (response.status === 503 || response.status === 502 || response.status === 504) {
+            throw new CLIError({
+                code: 'ECLI-INSPECT-SERVICE-UNAVAILABLE',
+                category: 'NETWORK_ERROR',
+                message: 'The results service is currently unavailable. Please try again later.',
+                details: { hint: 'The service may be temporarily down for maintenance.' },
+                module: 'inspect',
+                correlationId,
+                recoverable: true,
+                exitCode: INSPECT_EXIT_CODES.SERVICE_UNAVAILABLE,
+            });
+        }
+        throw new CLIError({
+            code: `ECLI-INSPECT-HTTP-${response.status}`,
+            category: response.status >= 500 ? 'NETWORK_ERROR' : 'INPUT_ERROR',
+            message: errorMessage,
+            details: { http_status: response.status },
+            module: 'inspect',
+            correlationId,
+            recoverable: response.status >= 500,
+            exitCode: response.status >= 500
+                ? INSPECT_EXIT_CODES.SERVICE_UNAVAILABLE
+                : INSPECT_EXIT_CODES.INPUT_ERROR,
+        });
+    }
+    // Extract results from response body
+    const responseBody = response.body;
+    const results = responseBody.results ??
+        responseBody.data ??
+        responseBody.items ??
+        (Array.isArray(responseBody) ? responseBody : []);
+    const latestResult = results.length > 0 ? results[0] : null;
+    return {
+        result: latestResult ?? null,
+        found: latestResult !== null,
+        timing: Date.now() - startTime,
+    };
+}
+// ============================================================================
+// Inspect Run Subcommand Implementation
+// ============================================================================
+/**
+ * Execute the 'inspect run <id>' subcommand.
+ * Returns a specific simulation result by ID.
+ */
+export async function executeInspectRunCommand(input, options) {
+    const correlationId = options.trace_id ?? crypto.randomUUID();
+    const startTime = Date.now();
+    // Validate ID
+    if (!input.id || typeof input.id !== 'string' || input.id.trim() === '') {
+        throw new CLIError({
+            code: 'ECLI-INSPECT-INVALID-ID',
+            category: 'INPUT_ERROR',
+            message: 'Run ID is required',
+            details: { provided: input.id },
+            module: 'inspect',
+            correlationId,
+            recoverable: false,
+            exitCode: INSPECT_EXIT_CODES.INPUT_ERROR,
+        });
+    }
+    // Get endpoint configuration
+    const baseUrl = getResultsIndexUrl();
+    const timeout = options.timeout ?? getRequestTimeout();
+    // Build query for specific ID
+    const queryParams = {
+        id: input.id.trim(),
+        limit: 1,
+    };
+    // Validate query parameters
+    validateQueryParams(queryParams, correlationId);
+    // Build request URL
+    const requestUrl = buildQueryUrl(baseUrl, queryParams);
+    // Execute HTTP GET request
+    const response = await executeHttpGet(requestUrl, timeout, correlationId);
+    // Handle non-2xx responses
+    if (response.status >= 400) {
+        let errorMessage = 'The results service returned an error';
+        if (typeof response.body === 'object' && response.body !== null) {
+            const body = response.body;
+            if (typeof body['message'] === 'string') {
+                errorMessage = body['message'];
+            }
+            else if (typeof body['error'] === 'string') {
+                errorMessage = body['error'];
+            }
+        }
+        if (response.status === 503 || response.status === 502 || response.status === 504) {
+            throw new CLIError({
+                code: 'ECLI-INSPECT-SERVICE-UNAVAILABLE',
+                category: 'NETWORK_ERROR',
+                message: 'The results service is currently unavailable. Please try again later.',
+                details: { hint: 'The service may be temporarily down for maintenance.' },
+                module: 'inspect',
+                correlationId,
+                recoverable: true,
+                exitCode: INSPECT_EXIT_CODES.SERVICE_UNAVAILABLE,
+            });
+        }
+        throw new CLIError({
+            code: `ECLI-INSPECT-HTTP-${response.status}`,
+            category: response.status >= 500 ? 'NETWORK_ERROR' : 'INPUT_ERROR',
+            message: errorMessage,
+            details: { http_status: response.status },
+            module: 'inspect',
             correlationId,
+            recoverable: response.status >= 500,
+            exitCode: response.status >= 500
+                ? INSPECT_EXIT_CODES.SERVICE_UNAVAILABLE
+                : INSPECT_EXIT_CODES.INPUT_ERROR,
         });
     }
+    // Extract results from response body
+    const responseBody = response.body;
+    const results = responseBody.results ??
+        responseBody.data ??
+        responseBody.items ??
+        (Array.isArray(responseBody) ? responseBody : []);
+    const matchingResult = results.find(r => r.id === input.id) ?? (results.length > 0 ? results[0] : null);
+    return {
+        result: matchingResult ?? null,
+        found: matchingResult !== null,
+        timing: Date.now() - startTime,
+    };
 }
 //# sourceMappingURL=inspect.js.map