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
use std::path::PathBuf;
use clap::{Args, Subcommand};
#[derive(Debug, Args)]
pub(crate) struct SessionArgs {
#[command(subcommand)]
pub command: SessionCommand,
}
#[derive(Debug, Subcommand)]
pub(crate) enum SessionCommand {
/// List the agent sessions this workspace has persisted.
List(SessionListArgs),
/// Export a persisted run record as a portable Harn session bundle.
Export(SessionExportArgs),
/// Export a suspended worker snapshot as a resumable checkpoint bundle.
Checkpoint(SessionCheckpointArgs),
/// Import a Harn session bundle back into a local run record.
Import(SessionImportArgs),
/// Validate a Harn session bundle without importing it.
Validate(SessionValidateArgs),
/// Print or check the generated session-bundle JSON Schema.
Schema(SessionSchemaArgs),
}
/// Sessions are the input to `harn runs --from-session`, so they need a way to
/// be discovered. Without this the session id can only be recovered by opening
/// `.harn/session-store.sqlite` by hand, which leaves the reporting surface as
/// unreachable as it was before it accepted sessions at all.
#[derive(Debug, Args)]
pub(crate) struct SessionListArgs {
/// Workspace root holding `.harn/session-store.sqlite`. Defaults to the
/// current directory.
#[arg(long, value_name = "PATH")]
pub session_root: Option<PathBuf>,
/// Show at most this many sessions, newest first.
#[arg(long, default_value_t = 50)]
pub limit: usize,
/// Emit the listing as JSON.
#[arg(long)]
pub json: bool,
}
#[derive(Debug, Args)]
pub(crate) struct SessionExportArgs {
/// Path to the run record JSON file to export.
pub run_record: String,
/// Write the bundle to this path. Prints JSON to stdout when omitted.
#[arg(long, value_name = "PATH")]
pub out: Option<String>,
/// Preserve local-only content instead of applying the default redaction policy.
#[arg(long, conflicts_with = "replay_only")]
pub local: bool,
/// Export replay metadata with prompt/tool payloads withheld.
#[arg(long, conflicts_with = "local")]
pub replay_only: bool,
/// Include artifact payloads in the bundle. Omitted by default for share safety.
#[arg(long)]
pub include_attachments: bool,
}
#[derive(Debug, Args)]
pub(crate) struct SessionCheckpointArgs {
/// Path to a suspended worker snapshot JSON file.
pub worker_snapshot: String,
/// Write the checkpoint bundle to this path. Prints JSON to stdout when omitted.
#[arg(long, value_name = "PATH")]
pub out: Option<String>,
/// Redact local-only content for share-safe inspection. The default local mode preserves resumability.
#[arg(long, conflicts_with = "replay_only")]
pub sanitized: bool,
/// Export replay metadata with prompt/tool payloads withheld.
#[arg(long, conflicts_with = "sanitized")]
pub replay_only: bool,
/// Include artifact payloads in the bundle. Omitted by default for share safety.
#[arg(long)]
pub include_attachments: bool,
}
#[derive(Debug, Args)]
pub(crate) struct SessionImportArgs {
/// Path to a Harn session bundle JSON file.
pub bundle: String,
/// Write the imported run record to this path.
#[arg(long, value_name = "PATH")]
pub out: Option<String>,
/// Directory for worker snapshots embedded in the bundle.
#[arg(long, value_name = "PATH")]
pub worker_snapshot_dir: Option<String>,
/// Allow bundles that still contain high-confidence secret markers.
#[arg(long)]
pub allow_unsafe_secret_markers: bool,
/// Print a JSON import report with materialized worker snapshot resume commands.
#[arg(long)]
pub json: bool,
}
#[derive(Debug, Args)]
pub(crate) struct SessionValidateArgs {
/// Path to a Harn session bundle JSON file.
pub bundle: String,
/// Allow bundles that still contain high-confidence secret markers.
#[arg(long)]
pub allow_unsafe_secret_markers: bool,
/// Print a compact JSON summary on success.
#[arg(long)]
pub json: bool,
}
#[derive(Debug, Args)]
pub(crate) struct SessionSchemaArgs {
/// Check that the checked-in schema file is up to date.
#[arg(long)]
pub check: bool,
/// Schema path used by --check, or write destination when --check is absent.
#[arg(long, value_name = "PATH")]
pub out: Option<String>,
}