API - Session

SessionManager

import { SessionManager } from 'kagent-ts'

new SessionManager(config?: SessionManagerConfig)

interface SessionManagerConfig {
  sessionsDir?: string          // 默认: ".kagent-sessions"
  autoSaveIntervalMs?: number   // 默认: 0 (每次迭代后保存)
}

方法

class SessionManager {
  saveCheckpoint(state: SessionState): Promise<void>
  loadSession(sessionId: string): Promise<SessionState | null>
  listSessions(): Promise<SessionInfo[]>
  deleteSession(sessionId: string): Promise<void>
  markStatus(sessionId: string, status: SessionStatus): Promise<void>
}

---

SessionState

interface SessionState {
  sessionId: string
  agentType: AgentType
  status: SessionStatus
  systemPrompt: string
  messages: MessageData[]
  agentState?: PlanSolveSessionState | FusionSessionState | OrchestratorSessionState
  metadata: SessionMetadata
}

type AgentType = "react" | "plan-solve" | "fusion" | "orchestrator"

enum SessionStatus {
  ACTIVE = "active",
  INTERRUPTED = "interrupted",
  COMPLETED = "completed",
  CANCELLED = "cancelled",
}

interface SessionMetadata {
  createdAt: string
  updatedAt: string
  iterations: number
  toolCalls: number
  tokenUsage: number
  input: string
}

---

Agent 特定状态

PlanSolveSessionState

interface PlanSolveSessionState {
  currentPlan: string[]
  completedSteps: number[]
  replanCount: number
  currentStep: number
}

FusionSessionState

interface FusionSessionState {
  routingResult: { complexity: string; reason: string }
  currentPlan: string[]
  completedSteps: number[]
  reflectionHistory: ReflectionResult[]
  phase: "routing" | "planning" | "executing" | "reflecting"
}

OrchestratorSessionState

interface OrchestratorSessionState {
  taskGraph: TaskGraph
  completedNodes: Record<string, string>
  currentRound: number
  synthesisResult?: string
}

下一步

• API - Context — Context & Compression API
• API - Agent — Agent 类 API
• Session 指南 — 会话持久化详细指南