import { SqliteConnection } from "./connection.js";
import { AgentRegistryEntry, SessionAuditEntry, SessionMetadata, SessionStoreExt, SessionWorkflowRun } from "@graphorin/core/contracts";
import { HandoffRecord, SessionScope } from "@graphorin/core";

//#region src/session-store.d.ts

/**
 * Default `SessionStore` implementation. Owns:
 *   - `sessions` rows.
 *   - `agents_registry` rows.
 *   - `session_handoffs` rows.
 *   - `session_workflow_runs` mapping.
 *   - `session_audit` lifecycle rows.
 *
 * Per `DEC-147`, the actual `session_messages` rows live in
 * `@graphorin/store-sqlite`'s `MemoryStore` (single source of truth).
 *
 * @stable
 */
declare class SqliteSessionStore implements SessionStoreExt {
  #private;
  constructor(conn: SqliteConnection);
  createSession(metadata: SessionMetadata): Promise<void>;
  getSession(sessionId: string): Promise<SessionMetadata | null>;
  listSessions(scope: Pick<SessionScope, 'userId' | 'agentId'>): Promise<ReadonlyArray<SessionMetadata>>;
  updateSession(sessionId: string, patch: Partial<SessionMetadata>): Promise<void>;
  closeSession(sessionId: string, closedAt: string): Promise<void>;
  registerAgent(entry: AgentRegistryEntry): Promise<void>;
  retireAgent(agentId: string, retiredAt: string): Promise<void>;
  deleteAgent(agentId: string): Promise<void>;
  resolveAgent(agentId: string): Promise<AgentRegistryEntry | null>;
  listAgents(): Promise<ReadonlyArray<AgentRegistryEntry>>;
  appendHandoff(sessionId: string, record: HandoffRecord): Promise<void>;
  listHandoffs(sessionId: string): Promise<ReadonlyArray<HandoffRecord>>;
  attachWorkflowRun(run: SessionWorkflowRun): Promise<void>;
  updateWorkflowRunStatus(sessionId: string, workflowId: string, threadId: string, status: SessionWorkflowRun['status']): Promise<void>;
  listWorkflowRuns(sessionId: string): Promise<ReadonlyArray<SessionWorkflowRun>>;
  appendAuditEntry(entry: SessionAuditEntry): Promise<void>;
  listAuditEntries(sessionId: string, opts?: {
    readonly limit?: number;
  }): Promise<ReadonlyArray<SessionAuditEntry>>;
  pruneAuditEntries(beforeEpochMs: number): Promise<number>;
  /** Hard-delete a session + its handoffs / workflow runs / audit rows. */
  deleteSession(sessionId: string): Promise<void>;
  /** Retention sweep - delete every session matching the policy. */
  pruneSessions(opts: {
    readonly beforeEpochMs?: number;
    readonly closedOnly?: boolean;
  }): Promise<number>;
}
/**
 * One entry of the session-content purge registry: which table holds
 * session-scoped rows, which column scopes them, and which sidecars
 * (FTS shadow, per-embedder vec0 tables, FK-referencing tables,
 * memory-history value scrub) must go with them.
 *
 * @stable
 */
interface SessionScopedPurge {
  /** Base table holding the session-scoped rows. */
  readonly table: string;
  /** Column carrying the session id. */
  readonly sessionColumn: 'scope_session_id' | 'session_id';
  /** FTS5 shadow table joined by rowid, when the table has one. */
  readonly fts?: string;
  /** Per-embedder vec0 sidecar family (name prefix + id column). */
  readonly vec?: {
    readonly prefix: string;
    readonly idColumn: string;
  };
  /** Tables referencing the base rows - cleared BEFORE the base rows. */
  readonly refs?: ReadonlyArray<{
    readonly table: string;
    readonly column: string;
  }>;
  /**
   * Scrub `memory_history` values for the deleted rows.
   * `valueMatch` additionally clears history rows whose
   * values equal the deleted row's text (the SUPERSEDE shape).
   */
  readonly history?: {
    readonly kind: string;
    readonly textColumn: string;
    readonly valueMatch: boolean;
  };
}
/**
 * Declarative registry of every session-scoped CONTENT surface the
 * session hard-delete cascade purges. The gate test in
 * `tests/erasure-cascade.test.ts` diffs this list (plus
 * {@link SESSION_TABLE_EXEMPTIONS}) against the live schema: a new
 * table with a session column fails the suite until its author decides
 * how erasure covers it.
 *
 * @stable
 */
declare const SESSION_SCOPED_PURGES: ReadonlyArray<SessionScopedPurge>;
/**
 * Session-column-bearing tables intentionally NOT in
 * {@link SESSION_SCOPED_PURGES}, each with the reason erasure is still
 * complete. Consumed by the completeness gate test.
 *
 * @stable
 */
declare const SESSION_TABLE_EXEMPTIONS: Readonly<Record<string, string>>;
//#endregion
export { SESSION_SCOPED_PURGES, SESSION_TABLE_EXEMPTIONS, SessionScopedPurge, SqliteSessionStore };
//# sourceMappingURL=session-store.d.ts.map