> ISPO SDK documentation. [HTML](https://ispo.ai/docs/interfaces/core.AgentSessionSnapshot.html) · [Documentation index](https://ispo.ai/docs/llms.txt)

# Interface AgentSessionSnapshot

Host-authored, compact metadata stored in an `agent.session` entity row. Full transcripts, permission decisions, prompt sending, cancellation, and lifecycle remain host-owned surfaces and are not copied into Entities.

```typescript
interface AgentSessionSnapshot {
    agentId: string;
    errorDetail?: AgentSessionErrorDetail;
    fidelity: AgentSessionFidelity;
    kind: AgentSessionKind;
    lastReply: string;
    pendingPermission: string;
    plan: readonly AgentSessionPlanEntry[];
    projectId: string;
    projectName?: string;
    status: AgentSessionStatus;
    terminalId: string;
    turnCount: number;
}
```

Types: [agentId](#agentid), [errorDetail](#errordetail), [AgentSessionErrorDetail](core.AgentSessionErrorDetail.md), [fidelity](#fidelity), [AgentSessionFidelity](../types/core.AgentSessionFidelity.md), [kind](#kind), [AgentSessionKind](../types/core.AgentSessionKind.md), [lastReply](#lastreply), [pendingPermission](#pendingpermission), [plan](#plan), [AgentSessionPlanEntry](core.AgentSessionPlanEntry.md), [projectId](#projectid), [projectName](#projectname), [status](#status), [AgentSessionStatus](../types/core.AgentSessionStatus.md), [terminalId](#terminalid), [turnCount](#turncount)

##### Index

### <a id="properties"></a>Properties

[agentId](#agentid) [errorDetail?](#errordetail) [fidelity](#fidelity) [kind](#kind) [lastReply](#lastreply) [pendingPermission](#pendingpermission) [plan](#plan) [projectId](#projectid) [projectName?](#projectname) [status](#status) [terminalId](#terminalid) [turnCount](#turncount)

## <a id="properties-1"></a>Properties

### <a id="agentid"></a>agentId

```typescript
agentId: string
```

### <a id="errordetail"></a>`Optional`errorDetail

```typescript
errorDetail?: AgentSessionErrorDetail
```

Types: [AgentSessionErrorDetail](core.AgentSessionErrorDetail.md)

### <a id="fidelity"></a>fidelity

```typescript
fidelity: AgentSessionFidelity
```

Types: [AgentSessionFidelity](../types/core.AgentSessionFidelity.md)

### <a id="kind"></a>kind

```typescript
kind: AgentSessionKind
```

Types: [AgentSessionKind](../types/core.AgentSessionKind.md)

### <a id="lastreply"></a>lastReply

```typescript
lastReply: string
```

### <a id="pendingpermission"></a>pendingPermission

```typescript
pendingPermission: string
```

### <a id="plan"></a>plan

```typescript
plan: readonly AgentSessionPlanEntry[]
```

Types: [AgentSessionPlanEntry](core.AgentSessionPlanEntry.md)

Current bounded host-reduced plan. Display-only.

### <a id="projectid"></a>projectId

```typescript
projectId: string
```

### <a id="projectname"></a>`Optional`projectName

```typescript
projectName?: string
```

### <a id="status"></a>status

```typescript
status: AgentSessionStatus
```

Types: [AgentSessionStatus](../types/core.AgentSessionStatus.md)

### <a id="terminalid"></a>terminalId

```typescript
terminalId: string
```

Host session/terminal handle carried for navigation and correlation.

### <a id="turncount"></a>turnCount

```typescript
turnCount: number
```