Get‑ShpChatCheckpoint

SYNOPSIS

Lists the checkpoints in a caller-named Session chat store without loading one.

SYNTAX

Get-ShpChatCheckpoint [-Path] <String> [<CommonParameters>]

DESCRIPTION

Reads a store written by Save-ShpChat and returns one object per checkpoint, oldest first, so a caller can choose what to resume, roll back to, or fork from before changing anything in the session.

It reads only. The running Session chat is untouched, and the store is not rewritten - listing a conversation is not an event worth recording in it.

The same refusals apply as everywhere else: a missing store, an unparseable one, or one whose schema version this module does not implement is an error rather than an empty list, because an empty list would look like a store with nothing in it.

EXAMPLES

EXAMPLE 1

Get-ShpChatCheckpoint -Path ./review-session.json

Lists every checkpoint with its label, turn count and identifiers.

EXAMPLE 2

Get-ShpChatCheckpoint -Path ./review-session.json | Where-Object Label -like 'before*'

Finds a labelled point to roll back to.

PARAMETERS

-Path

The store file to read. Mandatory, always; there is no default.

Type: String
Parameter Sets: (All)
Aliases:

Required: True
Position: 1
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

CommonParameters

This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.

INPUTS

OUTPUTS

System.Management.Automation.PSCustomObject

One ShellPilot.ChatCheckpoint per checkpoint: CheckpointId,

ParentCheckpointId, Label, CreatedUtc, Turns, Model, Sha256 and

UncertainSideEffects.

NOTES

RELATED LINKS

Save-ShpChat

Restore-ShpChat