Interface SessionStore

packages/opencode-atomic-hooks/src/session.ts:83–164

 * method is pure with respect to the store instance — no global state.
 */
export interface SessionStore {
  /**
   * Get the session state for `id`, creating it if it doesn't exist.
   *
   * This is the primary access method. Callers never need to check
   * existence before reading — `get` always returns a valid state.
   */
  get(id: string): SessionState

  /**
   * Check whether a session exists without creating it.
   */
  has(id: string): boolean

  /**
   * Remove a session from the store. No-op if it doesn't exist.
   */
  remove(id: string): void

  /**
   * Increment the turn count for a session.
   *
   * Called on `session.idle` events. Creates the session if needed.
   *
   * @returns The new turn count after incrementing
   */
  incrementTurn(id: string): number

  /**
   * Update the model and provider for a session.
   *
   * Called from the `chat.message` hook when model info is available.
   * Only updates fields that are non-empty — passing `undefined`
   * preserves the existing value.
   *
   * @param id       - Session ID
   * @param provider - Provider identifier (e.g., "anthropic")
   * @param model    - Model identifier (e.g., "claude-sonnet-4-20250514")
   */
  setModel(id: string, provider?: string, model?: string): void

  /**
   * Store the most recent user prompt for a session.
   *
   * Called from the `chat.message` hook. Only updates if `prompt`
   * is a non-empty string.
   */
  setPrompt(id: string, prompt: string): void

  /**
   * Record the start time of a tool invocation for duration tracking.
   *
   * @param id     - Session ID
   * @param callId - Unique tool call identifier
   * @param now    - Optional timestamp override for testing
   */
  startTool(id: string, callId: string, now?: number): void