/**
 * Tape layer for pi-memory-md
 * Uses pi session as data source, only maintains anchor store data
 * Entry types are directly from pi SessionEntry
 *
 * @see https://tape.systems
 * @see https://bub.build/
 */

// always keep the comments in this file，it's necessary.

import type { SessionEntry } from "@mariozechner/pi-coding-agent";

export type TapeContextStrategy = "recent-only" | "smart";

/**
 * Tape scan options - filter pi session entries
 *
 * @description
 * - `scan`: Text scan in entry content
 * - `types`: Filter by session entry type (message, custom, etc.)
 * - `limit`: Maximum results to return
 * - `sinceAnchor` / `lastAnchor`: Filter entries after a specific anchor
 * - `betweenAnchors`: Get entries between two anchors
 * - `betweenDates`: Get entries within date range (ISO format)
 * - `entryScope`: Entry source scope (`session` or `project`)
 * - `anchorScope`: Anchor resolution scope (`session` or `project`)
 */
export interface TapeSessionScanOptions {
  /** Text scan in entry content (case-insensitive) */
  scan?: string;
  /** Filter by session entry type */
  types?: SessionEntry["type"][];
  /** Maximum number of results to return (default: 20) */
  limit?: number;
  /** Get entries after this anchor name */
  sinceAnchor?: string;
  /** Get entries after the last anchor in current session */
  lastAnchor?: boolean;
  /** Get entries between two anchors */
  betweenAnchors?: { start: string; end: string };
  /** Get entries within date range (ISO format) */
  betweenDates?: { start: string; end: string };
  /** Entry source scope (default: project) */
  entryScope?: "session" | "project";
  /** Anchor resolution scope (default: session) */
  anchorScope?: "session" | "project";
}

export type ContextStrategy = TapeContextStrategy;

export interface ContextSelection {
  files: string[];
  reason: string;
}

/**
 * Tape configuration options
 *
 * @description
 * - `tapePath`: Custom tape path (default: {localPath}/TAPE: ~/.pi/memory-md/TAPE)
 * - `context`: Memory file selection strategy
 * - `anchor`: Anchor behavior settings
 */
export interface TapeKeywordConfig {
  global?: string[];
  project?: string[];
}

export type TapeHandoffMode = "auto" | "manual";

export interface TapeConfig {
  /** Enable tape mode. If the tape block exists, tape is on unless this is false. */
  enabled?: boolean;
  /** Run tape only inside a Git repository by default; otherwise skip tape delivery and anchors (default: true) */
  onlyGit?: boolean;
  /** Absolute directory paths where tape is always disabled */
  excludeDirs?: string[];
  /** Custom anchor store path (optional, default: {localPath}/TAPE) */
  tapePath?: string;
  /** Memory file selection configuration */
  context?: {
    /** Selection strategy: "smart" (default) or "recent-only" */
    strategy?: TapeContextStrategy;
    /** Maximum number of memory files to deliver (default: 10) */
    fileLimit?: number;
    /** Smart-mode scan range as [startHours, maxHours] (default: [72, 168]) */
    memoryScan?: [number, number];
    /** @deprecated Use whitelist instead */
    alwaysInclude?: string[];
    /** Files or directories to always include in delivered context */
    whitelist?: string[];
    /** Files or directories to always exclude from delivered context */
    blacklist?: string[];
  };
  /** Anchor behavior settings */
  anchor?: {
    /** Prefix mirrored into pi /tree labels for anchor nodes */
    labelPrefix?: string;
    /** Handoff behavior for autonomous LLM anchor creation */
    mode?: TapeHandoffMode;
    /** Keyword-triggered handoff settings */
    keywords?: TapeKeywordConfig;
  };
}

export type RenderState = { expanded: boolean; isPartial: boolean };