Loaded up for the 3rd redo

Still on potion-voice

worker-toolkit-potion-polyglot/scripts/harness-session.d.mts

@@ -0,0 +1,29 @@
+// Types for harness-session.mjs, so TS consumers (its test, snapshot-to-task) see a
+// real shape instead of `any`.
+
+export interface Turn {
+  /** Line index in the native session file. */
+  index: number;
+  role: 'user' | 'assistant';
+  text: string;
+  /** A slash-command turn, not real conversation. */
+  isCommand: boolean;
+  /** This record concluded its turn — the truncation boundary. */
+  endsTurn: boolean;
+}
+
+export interface Session {
+  harness: string;
+  rawPath: string;
+  /** The harness own id for this conversation. */
+  sessionId: string | null;
+  lines: string[];
+  turns: Turn[];
+}
+
+export function supportedHarnesses(): string[];
+export function readSession(harness: string, recordedPath?: string): Session | null;
+export function truncationIndex(turns: Turn[]): number;
+export function turnsFromLines(harness: string, lines: string[]): Turn[];
+export function linearSnapshotLines(session: Session, startLine?: number): string[];
+export function stripAuthoringScaffolding(harness: string, lines: string[]): string[];