API Reference
AgentSessionState
Metadata-only local session. No transcript messages or tool arguments are retained.
Inheritance
- Object
- AgentSessionState
Usage
Explore 12 API references to this type
This type appears in these public API surfaces even when no hand-authored example is attached directly to the page.
Returned or exposed by 4
Accepted by parameters 8
- Method AgentSessionState.Equals
- Method AgentSessionState.op_Equality
- Method AgentSessionState.op_Equality
- Method AgentSessionState.op_Inequality
- Method AgentSessionState.op_Inequality
- Method AgentWorkStateRules.Evaluate
- Constructor AgentWorkWatcher.AgentWorkWatcher
- Method LocalAgentWorkStateService.ReadLocal
Constructors
public AgentSessionState() #Methods
public AgentSessionState <Clone>$() #AgentSessionStatepublic override Int32 GetHashCode() #Int32public static Boolean op_Equality(AgentSessionState? left, AgentSessionState? right) #BooleanParameters
- left AgentSessionState?
- right AgentSessionState?
public static Boolean op_Inequality(AgentSessionState? left, AgentSessionState? right) #BooleanParameters
- left AgentSessionState?
- right AgentSessionState?
public override String ToString() #StringInherited Methods
Properties
public String? SourceRootId { get; init; } #Originating telemetry root, used to keep local and recovered metadata provenance separate.
public String Provider { get; init; } #Provider identifier, such as codex or claude.
public String? Title { get; init; } #Explicit session title, when available; never synthesized from a message.
public String? SessionSource { get; init; } #Structured native launcher identity, when present.
public String? ParentSessionId { get; init; } #Native parent session identity. A message parent is a separate relationship.
public Int32 TurnCount { get; init; } #Number of observed provider turn starts.
public String? WorkingDirectory { get; init; } #Working directory reported by the provider.
public String? Repository { get; init; } #GitHub repository in owner/name form, when known.
public String? Branch { get; init; } #Git branch reported by the provider or local repository.
public String? Machine { get; init; } #Source machine label. Null for recovered sources without a known machine.
public Boolean StateIsInferred { get; init; } #Whether state relies on recent log activity rather than a terminal/request event.
public Boolean IsArchived { get; init; } #Whether the local provider archived the thread.
public Boolean ArchiveStateKnown { get; init; } #Whether the archive flag was explicitly observed, rather than defaulted for a missing field.
public DateTimeOffset? StartedAtUtc { get; init; } #First provider timestamp, when available.
public DateTimeOffset? LastActivityAtUtc { get; init; } #Latest valid provider event timestamp, rather than copied-file modification time.
public AgentTurnOutcome LastTurnOutcome { get; init; } #Outcome of the latest turn, distinct from the session lifecycle.
public Boolean? TurnOpen { get; init; } #Whether a provider turn is known to be open; null before any turn evidence.
public String? TurnId { get; init; } #Provider turn identity or its first structured record identity. Null when the source does not expose either.
public Guid? SourceMessageId { get; init; } #Structured peer message identity that opened this turn, when observed.
public IReadOnlyList<AgentMessageObservation> PeerMessages { get; init; } #Bounded structured peer-message observations retained independently of the latest turn.
public DateTimeOffset? TurnStartedAtUtc { get; init; } #Start of the most recently observed turn, independent of session creation.
public DateTimeOffset? TurnEndedAtUtc { get; init; } #Explicit terminal timestamp of the latest turn; null while it is open.
public DateTimeOffset? LastTurnActivityAtUtc { get; init; } #Latest provider turn activity, excluding Desktop/title metadata refreshes.
public AgentFailureCause FailureCause { get; init; } #Controlled cause for the latest failure/interruption; never derived from prose.
public AgentFailureEvidence FailureEvidence { get; init; } #Evidence supporting FailureCause, including an unknown terminal failure.
public IReadOnlyList<AgentPendingInput> PendingInputs { get; init; } #Unresolved questions/approvals, including nonblocking requests during running work.
public IReadOnlyList<AgentInputResolution> ResolvedInputs { get; init; } #Explicit provider answers correlated to known requests; absence from PendingInputs alone is not a resolution.
public AgentObservationSources ObservationSources { get; init; } #Sources contributing state/activity metadata; title-only records do not establish liveness.
public DateTimeOffset? ObservedAtUtc { get; init; } #When session-log state was last parsed; cache reuse does not advance it. Desktop refresh time is on the snapshot.
public IReadOnlyList<String> ProviderPullRequestUrls { get; init; } #Canonical GitHub URLs explicitly associated by a structured provider record, never extracted from message text.
public IReadOnlyList<AgentPullRequestState> PullRequests { get; init; } #Matching open pull requests, linked by provider association or repository and exact head branch.