hen 0.19.0

Run protocol-aware API request collections from the command line or through MCP.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130

use serde_json::{json, Value};

use crate::{automation, error::HenError};

use super::{
    artifacts::{request_failure_json, run_record_json},
    common::{execution_trace_json, with_type},
    json::{hen_diagnostic_json, hen_error_json, inspection_result_json},
    BodyReportOptions,
};

pub fn run_outcome_ndjson(
    outcome: &automation::RunOutcome,
    body_options: BodyReportOptions,
) -> String {
    let mut lines = vec![json!({
        "type": "run",
        "collection": {
            "path": outcome.collection.path.display().to_string(),
            "name": outcome.collection.name,
            "description": outcome.collection.description,
            "availableEnvironments": outcome.collection.available_environments,
            "selectedEnvironment": outcome.collection.selected_environment,
        },
        "plan": outcome.plan,
        "selectedRequests": outcome.selected_requests,
        "primaryTarget": outcome.primary_target,
        "executionFailed": outcome.execution_failed,
        "interrupted": outcome.interrupted.is_some(),
        "interruptSignal": outcome.interrupted.map(|signal| signal.as_str()),
        "recordCount": outcome.records.len(),
        "failureCount": outcome.failures.len(),
        "traceCount": outcome.trace.len(),
    })];

    lines.extend(
        outcome
            .records
            .iter()
            .map(|record| with_type(run_record_json(record, body_options), "record")),
    );
    lines.extend(
        outcome
            .failures
            .iter()
            .map(|failure| with_type(request_failure_json(failure, body_options), "failure")),
    );
    lines.extend(
        outcome
            .trace
            .iter()
            .map(|entry| with_type(execution_trace_json(entry), "trace")),
    );

    render_ndjson(lines)
}

pub fn verification_result_ndjson(result: &automation::VerificationResult) -> String {
    verification_diagnostics_result_ndjson(&automation::VerificationDiagnosticsResult {
        ok: true,
        path: result.path.clone(),
        summary: Some(result.summary.clone()),
        required_inputs: result.required_inputs.clone(),
        diagnostics: Vec::new(),
        error: None,
    })
}

pub fn verification_diagnostics_result_ndjson(
    result: &automation::VerificationDiagnosticsResult,
) -> String {
    let mut lines = vec![json!({
        "type": "verify",
        "ok": result.ok,
        "path": result.path.as_ref().map(|path| path.display().to_string()),
        "name": result.summary.as_ref().map(|summary| summary.name.clone()),
        "description": result.summary.as_ref().map(|summary| summary.description.clone()),
        "availableEnvironments": result.summary.as_ref().map(|summary| summary.available_environments.clone()).unwrap_or_default(),
        "requestCount": result.summary.as_ref().map(|summary| summary.requests.len()).unwrap_or(0),
        "requiredInputCount": result.required_inputs.len(),
        "diagnosticCount": result.diagnostics.len(),
    })];

    if let Some(summary) = result.summary.as_ref() {
        lines.extend(summary.requests.iter().map(|request| {
            json!({
                "type": "request",
                "index": request.index,
                "description": request.description,
                "method": request.method,
                "url": request.url,
                "protocol": request.protocol,
                "protocolContext": request.protocol_context,
            })
        }));
    }

    lines.extend(result.required_inputs.iter().map(|prompt| {
        json!({
            "type": "requiredInput",
            "name": prompt.name,
            "default": prompt.default,
        })
    }));

    lines.extend(
        result
            .diagnostics
            .iter()
            .map(|diagnostic| with_type(hen_diagnostic_json(diagnostic), "diagnostic")),
    );

    render_ndjson(lines)
}

pub fn inspection_result_ndjson(result: &automation::InspectionResult) -> String {
    render_ndjson(vec![with_type(inspection_result_json(result), "inspect")])
}

pub fn hen_error_ndjson(error: &HenError) -> String {
    render_ndjson(vec![with_type(hen_error_json(error), "error")])
}

fn render_ndjson(lines: Vec<Value>) -> String {
    lines
        .into_iter()
        .map(|line| serde_json::to_string(&line).expect("ndjson line should serialize"))
        .collect::<Vec<_>>()
        .join("\n")
}