/**
 * Inspect Command - Standalone Read-Only HTTP Command
 *
 * 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
 *
 * ROUTING:
 * - Routes EXCLUSIVELY to agentics-results-index
 * - NO routing to execution, planning, or simulation services
 * - Read-only operation - performs NO mutations
 */
import type { CommandOptions, FlexibleInput } from '../types/index.js';
export declare const INSPECT_EXIT_CODES: {
    readonly SUCCESS: 0;
    readonly INPUT_ERROR: 100;
    readonly SERVICE_UNAVAILABLE: 69;
    readonly TIMEOUT: 75;
    readonly NETWORK_ERROR: 120;
    readonly UNEXPECTED_ERROR: 1;
};
export interface ResultsQueryParams {
    environment?: 'production' | 'staging' | 'development' | 'local';
    status?: 'completed' | 'failed' | 'running' | 'pending';
    limit?: number;
    order?: 'newest' | 'oldest';
    id?: string;
}
/**
 * SimulationResult — aligned with canonical result_packet from agentics-contracts.
 * Fields use contract-canonical names. Do NOT rename keys.
 */
export interface SimulationResult {
    execution_id: string;
    status: string;
    environment: string;
    created_at: string;
    completed_at?: string;
    duration_ms?: number;
    summary?: string;
    metrics?: Record<string, unknown>;
    execution_metadata: {
        trace_id: string;
        timestamp: string;
        service: string;
        [key: string]: unknown;
    };
    execution_graph?: Record<string, unknown>;
    /** @deprecated Use execution_id. Retained for backward compatibility only. */
    id?: string;
}
export interface InspectCommandResult {
    results: SimulationResult[];
    query: ResultsQueryParams;
    count: number;
    timing: number;
}
export interface InspectCommandInput {
    simRef: FlexibleInput<{
        id: string;
    }>;
    depth?: 'summary' | 'detailed' | 'full';
    includeMetrics?: boolean;
    includeTraces?: boolean;
}
export interface InspectLatestInput {
    environment?: 'production' | 'staging' | 'development' | 'local';
    status?: 'completed' | 'failed' | 'running' | 'pending';
}
export interface InspectLatestResult {
    result: SimulationResult | null;
    found: boolean;
    timing: number;
}
export interface InspectRunInput {
    id: string;
}
export interface InspectRunResult {
    result: SimulationResult | null;
    found: boolean;
    timing: number;
}
/**
 * Format simulation results for human-readable terminal output.
 */
export declare function formatResultsForDisplay(results: SimulationResult[]): string;
/**
 * 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 declare function executeInspectCommand(input: InspectCommandInput, options: CommandOptions): Promise<InspectCommandResult>;
/**
 * Execute the 'inspect latest' subcommand.
 * Returns the most recent simulation result matching the filters.
 * Uses the dedicated /api/v1/runs/last endpoint.
 */
export declare function executeInspectLatestCommand(input: InspectLatestInput, options: CommandOptions): Promise<InspectLatestResult>;
/**
 * Execute the 'inspect run <id>' subcommand.
 * Returns a specific simulation result by ID.
 */
export declare function executeInspectRunCommand(input: InspectRunInput, options: CommandOptions): Promise<InspectRunResult>;
export interface InspectArtifactsInput {
    id: string;
}
export interface InspectArtifact {
    id: string;
    type: string;
    name: string;
    location: string;
    size_bytes?: number;
    created_at: string;
    checksum?: string;
}
export interface InspectArtifactsResult {
    artifacts: InspectArtifact[];
    run_id: string;
    count: number;
    found: boolean;
    timing: number;
}
/**
 * Get artifacts for a specific simulation run.
 * Queries the results-index service for artifact metadata.
 */
export declare function executeInspectArtifactsCommand(input: InspectArtifactsInput, options: CommandOptions): Promise<InspectArtifactsResult>;
/**
 * Format artifacts list for human-readable display
 */
export declare function formatArtifactsForDisplay(artifacts: InspectArtifact[], runId: string): string;
//# sourceMappingURL=inspect.d.ts.map