ea6643a1d1
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
3.3 KiB
3.3 KiB
Sequence diagrams
Script execution
sequenceDiagram
participant U as "Browser"
participant API as "Backend"
participant N as "NATS / JetStream"
participant A as "Agent"
participant PS as "System.Management.Automation"
U->>API: "POST /api/jobs"
API->>N: "durable script command"
N->>A: "agent command.script"
A->>A: "record JobId idempotently"
A-->>N: "Ack command"
A->>PS: "Runspace + prelude + AddScript + AddParameter"
PS-->>A: "Output / Progress / Errors"
A->>N: "job output / progress"
N->>API: "consume job events"
API->>N: "browser session job event"
N-->>U: "live WebSocket event"
PS-->>A: "completion"
A->>N: "job state = Succeeded/Failed"
N->>API: "persist state"
API->>N: "browser session update"
N-->>U: "final state"
Enrollment
sequenceDiagram
participant A as "Agent"
participant API as "Backend"
participant N as "NATS"
A->>A: "CIM stable hardware fingerprint"
A->>A: "SHA-256 deterministic ClientId"
A->>A: "Generate User NKey pair"
A->>API: "HTTPS bootstrap: token + ClientId + public NKey"
API->>API: "Validate/consume bootstrap token"
API->>API: "Issue scoped NATS user JWT"
API-->>A: "EnrollmentId + User JWT"
A->>A: "DPAPI protect private seed + JWT"
A->>A: "Clear BootstrapToken registry value"
A->>N: "WSS connect using JWT + NKey proof"
N-->>A: "authenticated"
A->>N: "presence + inventory"
Remote shell
sequenceDiagram
participant U as "Browser / xterm"
participant API as "Backend"
participant N as "NATS"
participant A as "Agent"
participant C as "ConPTY"
U->>API: "create shell for ClientId"
API->>API: "authorize"
API->>N: "privileged shell.open command"
N->>A: "shell.open"
A->>C: "create pseudoconsole + shell"
A->>N: "shell state = open"
API->>N: "browser session state/output bridge"
N-->>U: "shell open"
U->>N: "browser session shell input"
N->>API: "input"
API->>N: "authorized agent shell.input"
N->>A: "input"
A->>C: "write input"
C-->>A: "terminal output"
A->>N: "shell output"
N->>API: "output"
API->>N: "browser shell output"
N-->>U: "live terminal output"
Script sequence across a restart
sequenceDiagram
participant U as "Browser"
participant API as "Backend"
participant W as "Sequence worker + dispatcher"
participant N as "NATS / JetStream"
participant A as "Agent"
U->>API: "POST /api/jobs (sequenceId)"
API->>API: "sequence run, a run per step (sealed snapshot), device run + step 1 job"
W->>N: "durable script command (step 1, its Restart On Completion)"
N->>A: "agent command.script"
A->>N: "job state = Succeeded, exit 3010, Restart Requested"
N->>API: "batched job states stored"
W->>W: "classify exit code: Warning; restart pending: wait"
A->>API: "restart request (result confirmed)"
A->>A: "restart (RestartCoordinator)"
A->>API: "inventory with a newer boot time"
API->>API: "job Restarted"
W->>W: "next step's condition; conditional advance + step 2 job"
W->>N: "durable script command (step 2)"
N->>A: "agent command.script"
A->>N: "job state = Succeeded"
W->>W: "no step left: device run Succeeded"
API-->>U: "live job and sequence events"