@joewinke/jatui 0.23.0 → 0.25.0

package/dist/components/session-nav/transcriptModel.js

@@ -41,10 +41,36 @@ function parseSignalBody(body) {
     if (!m)
         return null;
     let label = '';
-    const pick = body.match(/"(?:approach|question|reviewFocus|currentStep|summary|reason|taskTitle)"\s*:\s*"([^"]{3,90})/);
-    if (pick)
-        label = pick[1];
-    return { rawType: m[1], label };
+    let payload = null;
+    // Try to extract and parse the JSON payload from the signal call
+    const jsonMatch = body.match(/jat-signal\s+\w+\s+'(\{[\s\S]*?\})'\s*$/) ||
+        body.match(/jat-signal\s+\w+\s+"(\{[\s\S]*?\})"\s*$/) ||
+        body.match(/jat-signal\s+\w+\s+(\{[\s\S]*?\})\s*$/);
+    if (jsonMatch) {
+        try {
+            payload = JSON.parse(jsonMatch[1]);
+        }
+        catch {
+            // ignore parse errors — payload stays null
+        }
+    }
+    if (payload) {
+        // Extract label from full payload
+        const p = payload;
+        const candidate = (Array.isArray(p.summary) ? p.summary[0] : undefined) ??
+            (typeof p.approach === 'string' ? p.approach : undefined) ??
+            (typeof p.taskTitle === 'string' ? p.taskTitle : undefined) ??
+            (typeof p.question === 'string' ? p.question : undefined) ??
+            (typeof p.currentStep === 'string' ? p.currentStep : undefined);
+        if (candidate)
+            label = candidate.slice(0, 90);
+    }
+    else {
+        const pick = body.match(/"(?:approach|question|reviewFocus|currentStep|summary|reason|taskTitle)"\s*:\s*"([^"]{3,90})/);
+        if (pick)
+            label = pick[1];
+    }
+    return { rawType: m[1], label, payload };
 }
 /** Build the linked model from rendered transcript lines. */
 export function buildLinkedSession(lines) {
@@ -64,7 +90,14 @@ export function buildLinkedSession(lines) {
         } // blank ends a block
         if (line.startsWith('› ')) {
             flush();
-            cur = { kind: 'prompt', headline: line.slice(2), detail: [], srcLines: 1 };
+            const headline = line.slice(2);
+            // Claude Code's TUI draws a blank "› " input box while idle between
+            // turns; a capture that lands mid-frame leaks that empty prompt line
+            // into the transcript. Treat it like a blank line (below) rather than
+            // a zero-content prompt item — it never carries real content.
+            if (!headline.trim())
+                continue;
+            cur = { kind: 'prompt', headline, detail: [], srcLines: 1 };
             continue;
         }
         if (line.startsWith('⏺ ')) {
@@ -73,7 +106,7 @@ export function buildLinkedSession(lines) {
             if (sig) {
                 // signal emission = boundary; consume it, don't render as an item
                 flush();
-                emits.push({ afterIdx: items.length - 1, rawType: sig.rawType, label: sig.label });
+                emits.push({ afterIdx: items.length - 1, rawType: sig.rawType, label: sig.label, payload: sig.payload });
                 continue;
             }
             flush();
@@ -113,13 +146,33 @@ export function buildLinkedSession(lines) {
     }
     flush();
     // Build signal nodes from emission boundaries.
+    // Ownership is FORWARD: each signal owns the items that come AFTER it, up to
+    // (but not including) the next signal's emission point. The first signal also
+    // absorbs any preamble items that appear before it.
+    //
+    // Let B[i] = emits[i].afterIdx = last item index before signal[i].
+    //
+    // Partition (non-overlapping):
+    //   sig[0]    → [0 .. B[1]]           preamble + first forward region
+    //   sig[i>0]  → [B[i]+1 .. B[i+1]]   region after sig[i], before sig[i+1]
+    //   sig[last] → [B[last]+1 .. N-1]    region after last signal
+    //
+    // This ensures output printed AFTER a signal emission (e.g. the READY FOR
+    // REVIEW banner after `jat-signal review`) is attributed to that signal, not
+    // the subsequent one.
     const signals = [];
-    let prevBoundary = -1;
+    const N = items.length;
     emits.forEach((e, i) => {
-        const rowStart = Math.max(0, prevBoundary + 1);
-        const rowEnd = Math.max(rowStart, e.afterIdx);
+        // rowStart: first signal starts at 0 (absorbs preamble items before it);
+        // later signals start at the item immediately after this signal's emission.
+        const rowStart = i === 0 ? 0 : e.afterIdx + 1;
+        // naturalEnd: extends to the next signal's pre-boundary, or to the last item.
+        const naturalEnd = i + 1 < emits.length ? emits[i + 1].afterIdx : N - 1;
+        // rowEnd: capped at N-1 (never out of bounds); may be < rowStart when this
+        // signal has no items after it (e.g. last line is the signal itself).
+        const rowEnd = Math.min(naturalEnd, N - 1);
         let lineCount = 0;
-        for (let k = rowStart; k <= rowEnd && k < items.length; k++)
+        for (let k = rowStart; k <= rowEnd && k < N; k++)
             lineCount += items[k].srcLines;
         signals.push({
             id: `sig-${i}`,
@@ -135,9 +188,9 @@ export function buildLinkedSession(lines) {
             filesTouched: [],
             commits: [],
             linesAdded: 0,
-            linesRemoved: 0
+            linesRemoved: 0,
+            payload: e.payload
         });
-        prevBoundary = e.afterIdx;
     });
     for (const sig of signals) {
         for (let k = sig.rowStart; k <= sig.rowEnd && k < items.length; k++) {
@@ -168,9 +221,11 @@ export function buildLinkedSessionFromWork(blocks, items) {
         headline: it.headline,
         detail: it.detail,
         srcLines: it.srcLines,
-        signalId: null // filled in below
+        signalId: null, // filled in below
+        timestamp: it.timestamp ?? null
     }));
-    // Map WorkBlock → SignalNode
+    // Map WorkBlock → SignalNode. `isLive` is seeded from the server's open flag
+    // (read defensively — jat-difet adds it; may be undefined on older payloads).
     const signals = blocks.map((blk) => ({
         id: blk.id,
         state: rawTypeToState(blk.signal.type),
@@ -185,11 +240,80 @@ export function buildLinkedSessionFromWork(blocks, items) {
         filesTouched: blk.filesTouched,
         commits: blk.commits ?? [],
         linesAdded: blk.linesAdded ?? 0,
-        linesRemoved: blk.linesRemoved ?? 0
+        linesRemoved: blk.linesRemoved ?? 0,
+        payload: blk.signal.payload,
+        isLive: blk.open === true
     }));
-    // Assign signalId to transcript items via block ownership
+    const N = transcriptItems.length;
+    // Helper: synthesize the live node owning the open in-progress turn.
+    const makeLiveNode = (start, end, label) => {
+        let lineCount = 0;
+        for (let k = start; k <= end && k < N; k++)
+            lineCount += transcriptItems[k].srcLines;
+        return {
+            id: 'sig-live',
+            state: rawTypeToState('working'),
+            rawType: 'working',
+            label,
+            rowStart: start,
+            rowEnd: end,
+            lineCount: Math.max(1, lineCount),
+            blockId: null,
+            summary: null,
+            filesTouched: [],
+            commits: [],
+            linesAdded: 0,
+            linesRemoved: 0,
+            payload: null,
+            isLive: true
+        };
+    };
+    if (N > 0) {
+        if (signals.length === 0) {
+            // No blocks but live items exist → the whole transcript is the open
+            // turn. Give it a single live node so nothing is left unsignaled.
+            signals.push(makeLiveNode(0, N - 1, 'current'));
+        }
+        else {
+            // (#1 gap-fill) Guarantee a contiguous [0..N-1] partition so EVERY
+            // item ends up owning a signal:
+            //  (a) first signal absorbs any preamble before its range
+            signals[0].rowStart = 0;
+            //  (b) extend each signal's rowEnd to close the gap before the next
+            //      signal's range (no-op when ranges already touch/overlap)
+            for (let i = 0; i < signals.length - 1; i++) {
+                const nextStart = signals[i + 1].rowStart;
+                if (signals[i].rowEnd < nextStart - 1) {
+                    signals[i].rowEnd = nextStart - 1;
+                }
+            }
+            // (#2 live node) Trailing items past the last block's range are the
+            // OPEN in-progress turn — they must NOT be folded into the previous
+            // signal (e.g. a 'review'). Honor a server-marked open block first;
+            // otherwise synthesize a dedicated live node.
+            const lastSig = signals[signals.length - 1];
+            const lastBlockEnd = lastSig.rowEnd;
+            if (lastSig.isLive) {
+                // Server already marked the last block open → IT is the live node;
+                // extend it to absorb any trailing items.
+                lastSig.rowEnd = N - 1;
+            }
+            else if (lastBlockEnd < N - 1) {
+                // Synthesize a live node owning [lastBlockEnd+1 .. N-1]. Label from
+                // the live task title when available, else a neutral 'current'.
+                const p = lastSig.payload;
+                const title = p && typeof p.taskTitle === 'string' ? p.taskTitle.slice(0, 90) : null;
+                signals.push(makeLiveNode(lastBlockEnd + 1, N - 1, title ?? 'current'));
+            }
+            // else: the last block already reaches N-1 — nothing trailing.
+        }
+    }
+    // Assign signalId to transcript items via (gap-filled) ownership ranges.
+    // Clamp to bounds; later signals (incl. the live node) win on any overlap.
     for (const sig of signals) {
-        for (let k = sig.rowStart; k <= sig.rowEnd && k < transcriptItems.length; k++) {
+        const start = Math.max(0, sig.rowStart);
+        const end = Math.min(sig.rowEnd, N - 1);
+        for (let k = start; k <= end; k++) {
             transcriptItems[k].signalId = sig.id;
         }
     }
@@ -202,7 +326,7 @@ export function buildLinkedSessionFromWork(blocks, items) {
  */
 export const SAMPLE_TRANSCRIPT_LINES = [
     '',
-    '› /jat:start GentleCoast jat-7h2k',
+    '› /jat-start GentleCoast jat-7h2k',
     '⏺ Bash(get-current-session-id)',
     '  ⎿ 4f9c1a2e-7b3d-4c8a-9e1f-2a6b8c0d4e5f',
     '⏺ Bash(jat-signal starting \'{"agentName":"GentleCoast","taskTitle":"Add password reset flow"}\')',
@@ -256,7 +380,7 @@ export const SAMPLE_TRANSCRIPT_LINES = [
     '',
     '🔍 READY FOR REVIEW: jat-7h2k — password reset flow implemented, tested, rate-limited.',
     '',
-    '› /jat:complete',
+    '› /jat-complete',
     '⏺ Bash(jat-step committing --task jat-7h2k)',
     '  ⎿ Committed: feat(jat-7h2k): add password reset flow',
     '⏺ Bash(jat-signal complete \'{"taskId":"jat-7h2k","summary":"Shipped password reset flow"}\')',

package/dist/components/toast/ToastItem.svelte

@@ -151,7 +151,11 @@
 		}
 	}
 
-	// DaisyUI alert class per type
+	// Collapsible details (toast.details)
+let detailsOpen = $state(false);
+const detailsId = $derived(`toast-details-${toast.id}`);
+
+// DaisyUI alert class per type
 	const alertClass: Record<string, string> = {
 		info: 'alert-info',
 		success: 'alert-success',
@@ -223,7 +227,40 @@
 			></span>
 		{/if}
 
-		<span class="flex-1 text-sm">{toast.message}</span>
+		<div class="flex-1 min-w-0">
+			<span class="text-sm">{toast.message}</span>
+
+			{#if toast.details}
+				<button
+					type="button"
+					class="toast-details-toggle btn btn-ghost btn-xs mt-0.5 h-auto min-h-0 gap-1 px-0 font-semibold opacity-70"
+					aria-expanded={detailsOpen}
+					aria-controls={detailsId}
+					onclick={() => (detailsOpen = !detailsOpen)}
+				>
+					<svg
+						xmlns="http://www.w3.org/2000/svg"
+						class="size-3"
+						class:rotate-90={detailsOpen}
+						viewBox="0 0 24 24"
+						fill="none"
+						stroke="currentColor"
+						stroke-width="2.5"
+						stroke-linecap="round"
+						stroke-linejoin="round"
+					>
+						<path d="m9 18 6-6-6-6" />
+					</svg>
+					Details
+				</button>
+				{#if detailsOpen}
+					<pre
+						id={detailsId}
+						class="toast-details mt-1 max-h-40 overflow-auto rounded border border-current/20 bg-base-content/5 p-2 font-mono text-xs whitespace-pre-wrap break-words"
+					>{toast.details}</pre>
+				{/if}
+			{/if}
+		</div>
 
 		{#if toast.onUndo}
 			<button
@@ -274,7 +311,15 @@
 		to   { transform: scaleX(0); }
 	}
 
+	.toast-details-toggle svg {
+		transition: transform var(--motion-fast) var(--motion-glide);
+	}
+
 	@media (prefers-reduced-motion: reduce) {
+		.toast-details-toggle svg {
+			transition: none;
+		}
+
 		.toast-progress {
 			animation: none;
 		}

package/dist/index.d.ts

@@ -6,9 +6,9 @@ export { collapse } from './actions/collapse';
 export type { CollapseOptions } from './actions/collapse';
 export { default as Collapse } from './components/Collapse.svelte';
 export { default as LinkedColumns } from './components/linked-columns/LinkedColumns.svelte';
-export type { ColumnLink } from './components/linked-columns/LinkedColumns.svelte';
+export type { ColumnLink } from './components/linked-columns/types.js';
 export { default as ChapterTimeline } from './components/replay/ChapterTimeline.svelte';
-export type { ChapterBlock } from './components/replay/ChapterTimeline.svelte';
+export type { ChapterBlock, ChapterStateVisual } from './components/replay/ChapterTimeline.svelte';
 export { default as TranscriptPlayer } from './components/TranscriptPlayer.svelte';
 export type { TranscriptSegment, TranscriptBookmark, TranscriptChapter, TranscriptSpeakerTalkTime, } from './components/TranscriptPlayer.svelte';
 export { default as VideoPlayer } from './components/VideoPlayer.svelte';
@@ -25,7 +25,7 @@ export { default as Flythrough } from './components/Flythrough.svelte';
 export { default as LessonEmbed } from './components/LessonEmbed.svelte';
 export type { Collection, CollectionCut, CollectionBeat, } from './components/LessonEmbed.svelte';
 export { buildLinkedSession, buildLinkedSessionFromWork, rawTypeToState, sampleLinkedSession, SAMPLE_TRANSCRIPT_LINES, } from './components/session-nav/transcriptModel';
-export type { ItemKind, TranscriptItem, FileTouchedEntry, SignalNode, LinkedSession, WorkBlockClient, WorkTranscriptItemClient, } from './components/session-nav/transcriptModel';
+export type { ItemKind, TranscriptItem, FileTouchedEntry, SignalNode, LinkedSession, WorkBlockClient, WorkTranscriptItemClient, MarkerTone, TimelineMarkerSpec, TimelineMarker, } from './components/session-nav/transcriptModel';
 export { default as UserAvatar } from './components/UserAvatar.svelte';
 export { default as SidebarUserFooter } from './components/SidebarUserFooter.svelte';
 export { default as TaskTypeIcon } from './components/TaskTypeIcon.svelte';
@@ -83,7 +83,9 @@ export { default as ResizablePanel } from './components/ResizablePanel.svelte';
 export { default as VoicePlayer } from './components/VoicePlayer.svelte';
 export { default as SpeechForm } from './components/SpeechForm.svelte';
 export { default as AudioRecorder } from './components/AudioRecorder.svelte';
-export type { AudioRecordingResult } from './components/AudioRecorder.svelte';
+export type { AudioRecordingResult } from './utils/audioRecorderCore';
+export { createAudioRecorder } from './utils/audioRecorder';
+export type { AudioRecorder, AudioRecorderCore, AudioRecorderError, AudioRecorderErrorKind, AudioRecorderFrame, AudioRecorderMode, AudioRecorderOptions, AudioRecorderPhase, AudioRecorderSnapshot } from './utils/audioRecorderCore';
 export { default as ThemeSelector } from './components/ThemeSelector.svelte';
 export { default as Sparkline } from './components/Sparkline.svelte';
 export { default as BurndownChart } from './components/BurndownChart.svelte';
@@ -128,7 +130,7 @@ export type { Milestone, MilestoneStatus } from './types/milestone';
 export type { LocationType, BookingStatus, OverrideType, Host, EventType, WeeklyAvailability, DateOverride, Booking, BookingAttendee, TimeSlot, BookingFormData, AvailabilityCounts } from './types/booking';
 export { DAYS_OF_WEEK, DAYS_SHORT, LOCATION_LABELS, LOCATION_ICONS } from './types/booking';
 export type { ImageVariantSpec, ImageProcessingSpec, VariantResult, VariantState, } from './types/smartImageEditor';
-export { normalizeTimestamp, parseTimestamp, formatRelativeTime, formatFullDate, formatShortDate, formatLastActivity, formatDate, getTimeSinceMs, getTimeSinceMinutes, isWithinMinutes, formatDateTime, taskAge, pacingColor, type PacingLevel, type PacingResult, } from './utils/dateFormatters';
+export { normalizeTimestamp, parseTimestamp, formatRelativeTime, formatFullDate, formatShortDate, formatLastActivity, formatDate, getTimeSinceMs, getTimeSinceMinutes, isWithinMinutes, formatDateTime, taskAge, pacingColor, formatPacingDuration, type PacingLevel, type PacingResult, type PacingOptions, } from './utils/dateFormatters';
 export { statusColor, priorityColor, typeIcon, statusLabel, } from './utils/taskUtils';
 export { stripPhoneNumber, formatPhoneNumber, isCompletePhoneNumber, isValidPhoneNumber, updatePhoneInput } from './utils/phoneFormat';
 export { toE164, formatPhoneForDisplay, isValidPhone, listCountries, DEFAULT_COUNTRY, PRIORITY_COUNTRIES, type CountryOption, } from './utils/phone';
@@ -198,6 +200,7 @@ export type { GlideOrigin, GlideParams } from './transitions/glide';
 export { themeWipe } from './utils/themeWipe';
 export { viewTransition } from './utils/viewTransition';
 export { play as playSound, registerSound, isSoundEnabled, setSoundEnabled } from './utils/sound';
+export { copyText, readClipboardText } from './utils/clipboard';
 export { splitText } from './utils/splitText';
 export type { SplitBy, SplitTextOptions, SplitTextResult } from './utils/splitText';
 export { default as ToastHost } from './components/toast/ToastHost.svelte';

package/dist/index.js

@@ -44,7 +44,8 @@ export { qrMatrix, qrCanvas } from './video/advisors/qr';
 // LessonEmbed renders a demo-assemble collection.json (cut picker + player).
 export { default as Flythrough } from './components/Flythrough.svelte';
 export { default as LessonEmbed } from './components/LessonEmbed.svelte';
-// Data models — Session transcript (from JAT IDE, jat-jj79f.16 G1)
+// Data models — Session transcript (from JAT IDE, jat-jj79f.16 G1; resynced
+// with the IDE's payload/timestamp/live-node/F13-marker model in jatui-ucmkz)
 export { buildLinkedSession, buildLinkedSessionFromWork, rawTypeToState, sampleLinkedSession, SAMPLE_TRANSCRIPT_LINES, } from './components/session-nav/transcriptModel';
 // Components — Universal
 export { default as UserAvatar } from './components/UserAvatar.svelte';
@@ -102,6 +103,8 @@ export { default as ResizablePanel } from './components/ResizablePanel.svelte';
 export { default as VoicePlayer } from './components/VoicePlayer.svelte';
 export { default as SpeechForm } from './components/SpeechForm.svelte';
 export { default as AudioRecorder } from './components/AudioRecorder.svelte';
+// Headless audio capture — the factory behind AudioRecorder (jatui-is2ow.8)
+export { createAudioRecorder } from './utils/audioRecorder';
 // Components — from Headcount
 export { default as ThemeSelector } from './components/ThemeSelector.svelte';
 export { default as Sparkline } from './components/Sparkline.svelte';
@@ -137,7 +140,7 @@ export { default as AvailabilityModal } from './components/AvailabilityModal.sve
 export { default as BookingForm } from './components/BookingForm.svelte';
 export { DAYS_OF_WEEK, DAYS_SHORT, LOCATION_LABELS, LOCATION_ICONS } from './types/booking';
 // Utilities — date formatting
-export { normalizeTimestamp, parseTimestamp, formatRelativeTime, formatFullDate, formatShortDate, formatLastActivity, formatDate, getTimeSinceMs, getTimeSinceMinutes, isWithinMinutes, formatDateTime, taskAge, pacingColor, } from './utils/dateFormatters';
+export { normalizeTimestamp, parseTimestamp, formatRelativeTime, formatFullDate, formatShortDate, formatLastActivity, formatDate, getTimeSinceMs, getTimeSinceMinutes, isWithinMinutes, formatDateTime, taskAge, pacingColor, formatPacingDuration, } from './utils/dateFormatters';
 // Utilities — task display helpers
 export { statusColor, priorityColor, typeIcon, statusLabel, } from './utils/taskUtils';
 // Utilities — phone formatting (legacy US-only)
@@ -224,6 +227,8 @@ export { themeWipe } from './utils/themeWipe';
 export { viewTransition } from './utils/viewTransition';
 // Sound kit (functional feedback, opt-in)
 export { play as playSound, registerSound, isSoundEnabled, setSoundEnabled } from './utils/sound';
+// Clipboard (secure-context aware: execCommand fallback for plain-HTTP origins)
+export { copyText, readClipboardText } from './utils/clipboard';
 // Text utilities
 export { splitText } from './utils/splitText';
 // Toast system

package/dist/stores/toast.d.ts

@@ -2,6 +2,12 @@ export type ToastType = 'info' | 'success' | 'warning' | 'error';
 export type ToastOptions = {
     type?: ToastType;
     message: string;
+    /** Extended detail text (e.g. a stack trace or error chain) — rendered by
+     *  ToastHost behind a collapsible "Details" toggle. Multiline-safe. */
+    details?: string;
+    /** Arbitrary structured context carried on the Toast for programmatic
+     *  access (getToasts()); not rendered by ToastHost. */
+    meta?: Record<string, unknown>;
     action?: {
         label: string;
         onClick: () => void;
@@ -13,6 +19,8 @@ export type Toast = {
     id: number;
     type: ToastType;
     message: string;
+    details?: string;
+    meta?: Record<string, unknown>;
     action?: {
         label: string;
         onClick: () => void;

package/dist/stores/toast.js

@@ -15,6 +15,8 @@ export function showToast(options) {
 		id,
 		type: options.type ?? 'info',
 		message: options.message,
+		details: options.details,
+		meta: options.meta,
 		action: options.action,
 		durationMs: options.durationMs ?? 5000,
 		onUndo: options.onUndo

package/dist/utils/audioRecorder.d.ts

@@ -0,0 +1,28 @@
+import type { AudioRecorderMode, AudioRecorderOptions, AudioRecorderPhase, AudioRecorderSnapshot } from './audioRecorderCore';
+export type { AudioRecorderError, AudioRecorderErrorKind, AudioRecorderFrame, AudioRecorderMode, AudioRecorderOptions, AudioRecorderPhase, AudioRecordingResult } from './audioRecorderCore';
+export interface AudioRecorder {
+    /** False when the platform has no getUserMedia/MediaRecorder (SSR, Node). */
+    readonly supported: boolean;
+    readonly mode: AudioRecorderMode;
+    readonly phase: AudioRecorderPhase;
+    /** True while recording is suspended (pause()). */
+    readonly paused: boolean;
+    /** 0–100 live mic level. */
+    readonly level: number;
+    /** Bytes captured so far. */
+    readonly sizeBytes: number;
+    /** Pause-adjusted wall-clock elapsed ms. */
+    readonly elapsedMs: number;
+    /** Last error, or null. */
+    readonly error: AudioRecorderSnapshot['error'];
+    start(): Promise<void>;
+    stop(): void;
+    pause(): void;
+    resume(): void;
+    cancel(): void;
+    /** Return a finished/errored recorder to idle so the host can record again. */
+    reset(): void;
+    /** Final teardown — releases mic + timers. Call from onDestroy. */
+    destroy(): void;
+}
+export declare function createAudioRecorder(options?: AudioRecorderOptions): AudioRecorder;

package/dist/utils/audioRecorder.js

@@ -0,0 +1,58 @@
+/* audioRecorder.svelte.js generated by Svelte v5.53.11 */
+import * as $ from 'svelte/internal/client';
+import { createAudioRecorderCore } from './audioRecorderCore';
+
+export function createAudioRecorder(options = {}) {
+	const core = createAudioRecorderCore(options);
+	const snap = $.proxy(core.snapshot());
+
+	core.subscribe((s) => {
+		snap.phase = s.phase;
+		snap.paused = s.paused;
+		snap.level = s.level;
+		snap.sizeBytes = s.sizeBytes;
+		snap.elapsedMs = s.elapsedMs;
+		snap.error = s.error;
+	});
+
+	return {
+		get supported() {
+			return core.supported;
+		},
+
+		get mode() {
+			return core.mode;
+		},
+
+		get phase() {
+			return snap.phase;
+		},
+
+		get paused() {
+			return snap.paused;
+		},
+
+		get level() {
+			return snap.level;
+		},
+
+		get sizeBytes() {
+			return snap.sizeBytes;
+		},
+
+		get elapsedMs() {
+			return snap.elapsedMs;
+		},
+
+		get error() {
+			return snap.error;
+		},
+		start: () => core.start(),
+		stop: () => core.stop(),
+		pause: () => core.pause(),
+		resume: () => core.resume(),
+		cancel: () => core.cancel(),
+		reset: () => core.reset(),
+		destroy: () => core.destroy()
+	};
+}

package/dist/utils/audioRecorderCore.d.ts

@@ -0,0 +1,132 @@
+/**
+ * createAudioRecorderCore — headless audio-capture primitive (jatui-is2ow.8).
+ *
+ * The capture pipeline of `AudioRecorder.svelte` (permission request, MIME
+ * negotiation, MediaRecorder state machine, pause-aware wall-clock timing,
+ * AnalyserNode level meter, blob out) factored into a dependency-injected,
+ * DOM-free core so any host can drive it from its own UI — mic buttons,
+ * push-to-talk keys, overlays — without importing the component.
+ *
+ * NO transcription here by design: hosts that transcribe (the jat IDE's
+ * VoiceMicButton/VoiceInput, wave 3.5 of the adoption audit jat-1alfp) keep
+ * their POST-local capture shape and consume `onStop`'s blob payload.
+ *
+ * Two layers:
+ *   • this plain module — every knob injectable via `deps` (tests drive a fake
+ *     MediaRecorder backend in node:test, no DOM);
+ *   • `audioRecorder.svelte.ts` — the `createAudioRecorder()` rune wrapper
+ *     that wires the core's snapshot into `$state` so Svelte 5 templates react
+ *     to it. Components and app code import the wrapper; tests import this.
+ *
+ * Modes:
+ *   • `'toggle'` (default) — click-style: `start()` begins, `stop()` ends.
+ *   • `'push'` — hold-to-talk: the host wires pointerdown → `start()`,
+ *     pointerup → `stop()`. A `stop()` that arrives while the mic stream is
+ *     still being acquired (a very quick tap) CANCELS — no blob, no error —
+ *     matching the jat IDE VoiceMicButton's pointerup-before-stream behavior.
+ *
+ * Phases: idle → starting → recording ⇄(pause/resume) → processing → done,
+ * with `cancel()` from recording returning straight to idle and `reset()`
+ * returning a finished/errored recorder to idle so the host can go again.
+ *
+ * Timer discipline (lesson from MediaCapture, mos-ow4q4.37): elapsed time is
+ * derived from the wall clock minus accumulated pause, never an incremented
+ * counter — a throttled background tab can't freeze it.
+ */
+export type AudioRecorderPhase = 'idle' | 'starting' | 'recording' | 'processing' | 'done';
+export type AudioRecorderMode = 'toggle' | 'push';
+/** Why a recording attempt failed. */
+export type AudioRecorderErrorKind = 'unsupported' | 'denied' | 'no-mic' | 'start-failed' | 'too-short' | 'handler-failed';
+export interface AudioRecorderError {
+    kind: AudioRecorderErrorKind;
+    message: string;
+}
+/** What a finished recording hands back to the host — mirrors MediaCaptureResult's shape for the audio kind. */
+export interface AudioRecordingResult {
+    blob: Blob;
+    mimeType: string;
+    durationSeconds: number;
+    sizeBytes: number;
+}
+/** One animation frame of analyser data, for hosts that render a visualization. */
+export interface AudioRecorderFrame {
+    /** 0–100 RMS level (same value exposed reactively as `level`). */
+    level: number;
+    /** Frequency-domain bytes (from getByteFrequencyData). */
+    frequency: Uint8Array;
+    /** Time-domain bytes (from getByteTimeDomainData) — raw PCM-ish shape. */
+    time: Uint8Array;
+}
+export interface AudioRecorderOptions {
+    /** `'toggle'` (default) or `'push'` (hold-to-talk — see module header). */
+    mode?: AudioRecorderMode;
+    /** Auto-stop ceiling in ms. 0 (default) records until stopped manually. */
+    maxDurationMs?: number;
+    /** Fired once the mic stream is live and recording has started. */
+    onStart?: () => void;
+    onPause?: () => void;
+    onResume?: () => void;
+    /** Fired with the finished recording. May return a Promise — the recorder
+     * stays in "processing" until it settles, so hosts can upload/transcribe
+     * without the user re-triggering a recording. */
+    onStop?: (result: AudioRecordingResult) => void | Promise<void>;
+    /** Fired when the recording is cancelled — no blob is produced. */
+    onCancel?: () => void;
+    /** Fired on recorder errors (permission denied, no mic, start failure, …). */
+    onError?: (error: AudioRecorderError) => void;
+    /** Fired every animation frame while recording — analyser data for hosts
+     * that draw their own waveform/level UI. Not fired while paused. */
+    onFrame?: (frame: AudioRecorderFrame) => void;
+}
+/** Injectable platform bindings — defaults resolve from globalThis lazily at factory time, so Node (no MediaRecorder) degrades to `supported: false` instead of throwing at import. */
+export interface AudioRecorderDeps {
+    getUserMedia?: (constraints?: MediaStreamConstraints) => Promise<MediaStream>;
+    MediaRecorder?: any;
+    AudioContext?: any;
+    requestAnimationFrame?: (cb: (t: number) => void) => number;
+    cancelAnimationFrame?: (id: number) => void;
+    setTimeout?: typeof setTimeout;
+    clearTimeout?: typeof clearTimeout;
+    setInterval?: typeof setInterval;
+    clearInterval?: typeof clearInterval;
+    /** Wall clock — injectable so tests can advance time deterministically. */
+    now?: () => number;
+}
+export interface AudioRecorderSnapshot {
+    phase: AudioRecorderPhase;
+    /** True while recording is suspended (pause()). */
+    paused: boolean;
+    /** 0–100 live mic level. */
+    level: number;
+    /** Bytes captured so far. */
+    sizeBytes: number;
+    /** Pause-adjusted wall-clock elapsed ms. */
+    elapsedMs: number;
+    /** Last error, or null. */
+    error: AudioRecorderError | null;
+}
+export interface AudioRecorderCore {
+    /** False when the platform has no getUserMedia/MediaRecorder (SSR, Node). */
+    readonly supported: boolean;
+    readonly mode: AudioRecorderMode;
+    /** Current reactive-independent snapshot (the rune wrapper copies this into $state). */
+    snapshot(): AudioRecorderSnapshot;
+    /** Subscribe to snapshot changes. Returns an unsubscribe fn. */
+    subscribe(fn: (snapshot: AudioRecorderSnapshot) => void): () => void;
+    start(): Promise<void>;
+    stop(): void;
+    pause(): void;
+    resume(): void;
+    cancel(): void;
+    /** Return a finished/errored recorder to idle so the host can record again. */
+    reset(): void;
+    /** Final teardown — releases mic + timers. Safe to call from any phase. */
+    destroy(): void;
+}
+/** First supported recording MIME type, or '' when none are. */
+export declare function pickAudioMimeType(isSupported?: (type: string) => boolean): string;
+/** RMS of the time-domain data scaled to the recorder's 0–100 meter range. */
+export declare function computeAudioLevel(timeData: ArrayLike<number> | null): number;
+/** Elapsed from the wall clock, pause-adjusted — see module header note. */
+export declare function computeElapsedMs(startedAt: number, pausedTotalMs: number, pauseStartedAt: number, now: number): number;
+export declare function createAudioRecorderCore(options?: AudioRecorderOptions, deps?: AudioRecorderDeps): AudioRecorderCore;