yaver-feedback-react-native 0.9.6 → 0.9.8

package/dist/FeedbackModal.js

@@ -44,12 +44,14 @@ const AuthOverlay_1 = require("./AuthOverlay");
 const QuickActionIcon_1 = require("./QuickActionIcon");
 const YaverModeBadge_1 = require("./YaverModeBadge");
 const VibeChatScreen_1 = require("./VibeChatScreen");
+const DogfoodQuickControls_1 = require("./DogfoodQuickControls");
 const DeployPanel_1 = require("./DeployPanel");
 const auth_1 = require("./auth");
 const reloadActions_1 = require("./reloadActions");
 const preferences_1 = require("./preferences");
 const DogfoodRuntime_1 = require("./DogfoodRuntime");
 const P2PDogfoodDriver_1 = require("./P2PDogfoodDriver");
+const DogfoodSessionUi_1 = require("./DogfoodSessionUi");
 const PRIMARY_RUNNER_IDS = ['claude', 'codex', 'opencode'];
 function normalizeRunnerStatusRows(rows) {
     const byId = new Map();
@@ -1023,7 +1025,42 @@ const FeedbackModal = () => {
         && (selectedDogfoodRunner.ready || selectedDogfoodRunner.authConfigured);
     const dogfoodModelReady = !selectedDogfoodRunner?.models?.length
         || !!preferredModel && selectedDogfoodRunner.models.some((model) => model.id === preferredModel);
-    const dogfoodStartBlocked = !dogfoodProject || !dogfoodRunnerReady || !dogfoodModelReady;
+    const dogfoodLaneChoices = (0, DogfoodRuntime_1.dogfoodLaneOptions)(dogfoodProject?.framework || YaverFeedback_1.YaverFeedback.getDogfoodOnboarding()?.framework || 'expo', { nativeRuntimeAvailable: dogfoodNativeAvailable });
+    const dogfoodLaneReady = dogfoodLaneChoices.some((option) => option.lane === dogfoodLane && option.supported);
+    const dogfoodReadinessSteps = [
+        {
+            key: 'oauth', label: 'Yaver OAuth',
+            detail: YaverFeedback_1.YaverFeedback.isAuthed() ? 'Signed in · session saved' : 'Sign in required',
+            tone: YaverFeedback_1.YaverFeedback.isAuthed() ? 'ready' : 'attention',
+        },
+        {
+            key: 'machine', label: 'Remote PC',
+            detail: machineCard.device ? machineCard.title : 'Choose a reachable development machine',
+            tone: machineCard.device && machineCard.status === 'live' ? 'ready' : 'attention',
+        },
+        {
+            key: 'installation', label: 'This installation',
+            detail: dogfoodEnrollment?.status === 'active' ? 'Device key approved' : dogfoodEnrollment?.status || 'Checking device key',
+            tone: dogfoodEnrollment?.status === 'active' ? 'ready'
+                : dogfoodEnrollment?.status === 'failed' ? 'blocked' : 'pending',
+        },
+        {
+            key: 'runner', label: 'Runner',
+            detail: dogfoodRunnerReady ? selectedDogfoodRunner?.name || preferredRunner || 'Ready' : 'Choose or configure a coding runner',
+            tone: dogfoodRunnerReady ? 'ready' : 'attention',
+        },
+        {
+            key: 'model', label: 'Model',
+            detail: dogfoodModelReady ? preferredModel || 'Runner default' : 'Choose a model',
+            tone: dogfoodModelReady ? 'ready' : 'attention',
+        },
+        {
+            key: 'lane', label: 'Runtime lane',
+            detail: dogfoodLaneChoices.find((option) => option.lane === dogfoodLane)?.label || dogfoodLane,
+            tone: dogfoodLaneReady ? 'ready' : 'blocked',
+        },
+    ];
+    const dogfoodStartBlocked = !dogfoodProject || !dogfoodRunnerReady || !dogfoodModelReady || !dogfoodLaneReady;
     // Once the user fires off a vibe task, swap the entire modal body
     // for the live chat screen. The chat manages its own SSE
     // subscription, multi-turn follow-ups, and Reload button. Closing
@@ -1032,6 +1069,7 @@ const FeedbackModal = () => {
         const client = YaverFeedback_1.YaverFeedback.getP2PClient();
         return (<>
         <AuthOverlay_1.AuthOverlay />
+        <DogfoodQuickControls_1.DogfoodQuickControls />
         <QuickActionIcon_1.QuickActionIcon />
         <YaverModeBadgeGate />
         <react_native_1.Modal visible={visible} animationType="slide" transparent onRequestClose={handleClose}>
@@ -1049,6 +1087,7 @@ const FeedbackModal = () => {
     }
     return (<>
       <AuthOverlay_1.AuthOverlay />
+      <DogfoodQuickControls_1.DogfoodQuickControls />
       <QuickActionIcon_1.QuickActionIcon />
       <YaverModeBadgeGate />
       {visible && (<react_native_1.Modal visible={visible} animationType="slide" transparent onRequestClose={handleClose}>
@@ -1101,6 +1140,7 @@ const FeedbackModal = () => {
                   <react_native_1.Text style={styles.dogfoodWizardHint}>
                     OAuth ✓ · machine {machineCard.device ? '✓' : 'required'} · installation {dogfoodEnrollment?.status || 'checking'}
                   </react_native_1.Text>
+                  <DogfoodSessionUi_1.DogfoodStatusRail steps={dogfoodReadinessSteps}/>
                   {dogfoodEnrollment?.installationId ? (<react_native_1.Text selectable style={styles.dogfoodInstallationId}>
                       This device · {dogfoodEnrollment.installationId}
                     </react_native_1.Text>) : null}
@@ -1148,34 +1188,22 @@ const FeedbackModal = () => {
                           </react_native_1.ScrollView>
                         </>) : null}
                       <react_native_1.Text style={styles.dogfoodStepLabel}>Runtime lane</react_native_1.Text>
-                      <react_native_1.View style={styles.dogfoodChoiceRow}>
-                        {(0, DogfoodRuntime_1.dogfoodLaneOptions)(dogfoodProject?.framework || YaverFeedback_1.YaverFeedback.getDogfoodOnboarding()?.framework || 'expo', { nativeRuntimeAvailable: dogfoodNativeAvailable }).map((option) => (<react_native_1.Pressable key={option.lane} onPress={() => {
-                            if (!option.supported)
-                                return;
-                            setDogfoodLane(option.lane);
-                            const appId = YaverFeedback_1.YaverFeedback.getDogfoodOnboarding()?.appId;
-                            if (appId)
-                                void (0, preferences_1.setPreferredDogfoodLane)(appId, option.lane);
-                        }} style={[
-                            styles.dogfoodChoice,
-                            dogfoodLane === option.lane && styles.dogfoodChoiceSelected,
-                            !option.supported && styles.actionBtnDisabled,
-                        ]} accessibilityState={{ disabled: !option.supported, selected: dogfoodLane === option.lane }}>
-                            <react_native_1.Text style={[styles.dogfoodChoiceText, dogfoodLane === option.lane && styles.dogfoodChoiceTextSelected]}>{option.label}</react_native_1.Text>
-                          </react_native_1.Pressable>))}
-                      </react_native_1.View>
+                      <DogfoodSessionUi_1.DogfoodLanePicker options={dogfoodLaneChoices} selected={dogfoodLane} onSelect={(lane) => {
+                        setDogfoodLane(lane);
+                        const appId = YaverFeedback_1.YaverFeedback.getDogfoodOnboarding()?.appId;
+                        if (appId)
+                            void (0, preferences_1.setPreferredDogfoodLane)(appId, lane);
+                    }}/>
                       <react_native_1.Text style={styles.dogfoodWizardHint}>
                         {[preferredRunner || 'Choose a coding agent', preferredModel].filter(Boolean).join(' · ')}
                       </react_native_1.Text>
                       <ActionRow label={dogfoodRuntime && !['idle', 'ready', 'failed', 'stopped'].includes(dogfoodRuntime.phase) ? dogfoodRuntime.message : 'Start Dogfood'} tint="#818cf8" onPress={() => void startDogfoodRuntime()} disabled={dogfoodStartBlocked || !!(dogfoodRuntime && !['idle', 'ready', 'failed', 'stopped'].includes(dogfoodRuntime.phase))} busy={!!dogfoodRuntime && !['idle', 'ready', 'failed', 'stopped'].includes(dogfoodRuntime.phase)}/>
-                      {dogfoodRuntime ? (<react_native_1.View style={styles.dogfoodConsole}>
-                          <react_native_1.Text style={styles.dogfoodConsoleStatus}>{dogfoodRuntime.message}</react_native_1.Text>
-                          {dogfoodRuntime.logs.slice(-80).map((line, index) => (<react_native_1.Text key={`${line.at}-${index}`} selectable style={styles.dogfoodConsoleLine}>{line.text}</react_native_1.Text>))}
-                          {dogfoodRuntime.failure ? (<react_native_1.Text style={styles.dogfoodConsoleError}>{dogfoodRuntime.failure.error}{'\n'}{dogfoodRuntime.failure.remedy}</react_native_1.Text>) : null}
+                      {dogfoodRuntime ? (<>
+                          <DogfoodSessionUi_1.DogfoodLiveConsole lane={dogfoodRuntime.project.lane} phase={dogfoodRuntime.phase} message={dogfoodRuntime.message} logs={dogfoodRuntime.logs} failure={dogfoodRuntime.failure}/>
                           {dogfoodRuntime.result?.url ? (<react_native_1.Pressable onPress={() => void react_native_1.Linking.openURL(dogfoodRuntime.result.url)} style={styles.dogfoodOpenPreview}>
                               <react_native_1.Text style={styles.dogfoodOpenPreviewText}>Open dogfooded app</react_native_1.Text>
                             </react_native_1.Pressable>) : null}
-                        </react_native_1.View>) : null}
+                        </>) : null}
                     </>)}
                 </react_native_1.View>) : null}
               <react_native_1.Pressable onPress={() => {

package/dist/YaverFeedback.d.ts

@@ -1,7 +1,7 @@
 import { FeedbackConfig, CapturedError } from './types';
 import { P2PClient } from './P2PClient';
 import { CaptureStoreScreenshotsOptions, CaptureStoreScreenshotsResult } from './storeShots';
-import { QuickIconColorPreset } from './preferences';
+import { type DogfoodControlPresentation, QuickIconColorPreset } from './preferences';
 import { type SDKDogfoodStatus, type DogfoodAccessSnapshot } from './dogfoodPolicy';
 import { type DeviceDogfoodOptions, type DeviceDogfoodSession, type DeviceDogfoodState } from './deviceDogfood';
 export interface DogfoodOnboardingOptions extends DeviceDogfoodOptions {
@@ -16,6 +16,25 @@ export interface DogfoodFlowState {
     appId?: string;
     error?: string;
 }
+export interface DogfoodControlTriggerState {
+    configured: boolean;
+    authorized: boolean;
+    appId?: string;
+    installationId?: string;
+    gestureSupported: boolean;
+    gestureEnabled: boolean;
+    fallbackVisible: boolean;
+    presentation: DogfoodControlPresentation;
+    onboardingSeen: boolean;
+    reason: string;
+    platform?: string;
+}
+interface DogfoodControlSyncOptions {
+    presentation?: DogfoodControlPresentation;
+    onboardingSeen?: boolean;
+    /** User-initiated changes fail visibly when Convex cannot persist them. */
+    requirePersistence?: boolean;
+}
 /**
  * Main entry point for the Yaver Feedback SDK.
  * Call `YaverFeedback.init()` once at app startup.
@@ -130,6 +149,20 @@ export declare class YaverFeedback {
      * owner/device ACL state. Static plist shortcuts are intentionally avoided:
      * an unauthorized install must never advertise a hidden developer action. */
     static syncDogfoodAppShortcut(): Promise<boolean>;
+    /** Capability-gated in-app Dogfood controls. Every new exact installation
+     * starts with Y until Convex records onboarding. A supported standalone app
+     * can then select a passive three-finger hold and no persistent pixels;
+     * missing native support or accessibility touch exploration keeps Y. Yaver's
+     * own container suppresses both because its split preview/chat UI owns them. */
+    static syncDogfoodControlGesture(syncOptions?: DogfoodControlSyncOptions): Promise<DogfoodControlTriggerState>;
+    /** Complete first-run onboarding or change the later control preference.
+     * Convex is authoritative and keyed by full Yaver user + app + installation;
+     * the local value is only a cold-start cache. */
+    static setDogfoodControlPresentation(presentation: DogfoodControlPresentation): Promise<DogfoodControlTriggerState>;
+    /** One-tap fast reload for the compact Dogfood card. It preserves the same
+     * selected render machine and bearer-authenticated P2P route as the full
+     * Feedback modal, and names missing auth/machine state instead of no-oping. */
+    static requestDogfoodFastReload(): Promise<string>;
     /** Backwards-compatible entry point for existing integrations. */
     static beginDogfoodOnboarding(options: DogfoodOnboardingOptions): Promise<DogfoodFlowState>;
     /** Continue after OAuth or machine selection. Public so custom host UI can
@@ -416,3 +449,4 @@ export declare class YaverFeedback {
     /** Tear down the SDK (stop shake detector, clear state). */
     static destroy(): void;
 }
+export {};

package/dist/YaverFeedback.js

@@ -194,6 +194,11 @@ let dogfoodShortcutAppStateSubscription = null;
 let dogfoodActivationSubscription = null;
 let dogfoodShortcutLaunchInFlight = false;
 let lastDogfoodActivationUrl = '';
+function dogfoodControlPreferenceScope(appId, installationId) {
+    if (!appId || !installationId)
+        return undefined;
+    return `${appId}:${installationId}`;
+}
 function publishDogfoodFlow(state) {
     dogfoodFlowState = state;
     try {
@@ -533,20 +538,30 @@ class YaverFeedback {
         if (config.autoLogin !== false && enabled) {
             void YaverFeedback.hydrateSession();
         }
-        if (config.dogfood?.appShortcut) {
-            void YaverFeedback.syncDogfoodAppShortcut();
-            void consumeNativeDogfoodShortcut();
+        if (config.dogfood?.appShortcut || config.dogfood?.controlGesture) {
+            if (config.dogfood?.appShortcut) {
+                void YaverFeedback.syncDogfoodAppShortcut();
+                void consumeNativeDogfoodShortcut();
+            }
+            if (config.dogfood?.controlGesture) {
+                void YaverFeedback.syncDogfoodControlGesture();
+            }
             try {
                 const { AppState } = require('react-native');
                 dogfoodShortcutAppStateSubscription?.remove();
                 dogfoodShortcutAppStateSubscription = AppState.addEventListener('change', (state) => {
                     if (state === 'active') {
-                        void YaverFeedback.syncDogfoodAppShortcut();
-                        void consumeNativeDogfoodShortcut();
+                        if (config?.dogfood?.appShortcut) {
+                            void YaverFeedback.syncDogfoodAppShortcut();
+                            void consumeNativeDogfoodShortcut();
+                        }
+                        if (config?.dogfood?.controlGesture) {
+                            void YaverFeedback.syncDogfoodControlGesture();
+                        }
                     }
                 });
             }
-            catch { /* native shortcut unavailable on web/test runtimes */ }
+            catch { /* native quick controls unavailable on web/test runtimes */ }
         }
         if (config.dogfood) {
             try {
@@ -855,6 +870,7 @@ class YaverFeedback {
             YaverFeedback.scheduleBlackBoxAutoStart();
         }
         await YaverFeedback.syncDogfoodAppShortcut().catch(() => false);
+        await YaverFeedback.syncDogfoodControlGesture().catch(() => undefined);
     }
     /** Returns true once the SDK has a session token it can use. */
     static isAuthed() {
@@ -1005,16 +1021,21 @@ class YaverFeedback {
         const token = config?.authToken || await (0, auth_1.getToken)();
         const account = token
             ? await (0, auth_1.getDogfoodAccountAccess)(appId, token, installationId)
-            : { authenticated: false, ownerAuthorized: false, installationAuthorized: false };
+            : { authenticated: false, ownerAuthorized: false, accountAuthorized: false, installationAuthorized: false };
         const yaverAuthenticated = account.authenticated;
         const ownerAuthorized = account.ownerAuthorized;
         return {
             appId,
             yaverAuthenticated,
             ownerAuthorized,
+            accountAuthorized: account.accountAuthorized,
             installationId,
             deviceState,
             authorized: yaverAuthenticated && account.installationAuthorized && deviceState === 'active',
+            controlPresentation: account.controlPresentation,
+            gestureSupported: account.gestureSupported,
+            gestureCapabilityReason: account.gestureCapabilityReason,
+            controlOnboardingSeen: account.controlOnboardingSeen,
         };
     }
     /** Add/remove the platform Home Screen shortcut from backend-authoritative
@@ -1044,6 +1065,243 @@ class YaverFeedback {
         await native.setDogfoodShortcut(visible, label || 'Dogfood');
         return visible;
     }
+    /** Capability-gated in-app Dogfood controls. Every new exact installation
+     * starts with Y until Convex records onboarding. A supported standalone app
+     * can then select a passive three-finger hold and no persistent pixels;
+     * missing native support or accessibility touch exploration keeps Y. Yaver's
+     * own container suppresses both because its split preview/chat UI owns them. */
+    static async syncDogfoodControlGesture(syncOptions = {}) {
+        const configured = config?.dogfood?.controlGesture;
+        const native = react_native_1.NativeModules?.YaverDogfoodGesture;
+        const base = {
+            configured: Boolean(configured),
+            authorized: false,
+            gestureSupported: false,
+            gestureEnabled: false,
+            fallbackVisible: false,
+            presentation: syncOptions.presentation || 'auto',
+            onboardingSeen: syncOptions.onboardingSeen === true,
+            reason: configured ? 'native-module-unavailable' : 'not-configured',
+            platform: react_native_1.Platform.OS,
+        };
+        if (!configured) {
+            if (typeof native?.setEnabled === 'function') {
+                await native.setEnabled(false, 900).catch(() => undefined);
+            }
+            return base;
+        }
+        if (IS_HOST_MODE || isRunningInsideYaverHost()) {
+            if (typeof native?.setEnabled === 'function') {
+                await native.setEnabled(false, 900).catch(() => undefined);
+            }
+            return { ...base, reason: 'yaver-host-owns-controls' };
+        }
+        const access = await YaverFeedback.getDogfoodAccess();
+        let authorized = access.authorized;
+        if (authorized && config?.dogfood?.canShow) {
+            try {
+                authorized = await config.dogfood.canShow(access);
+            }
+            catch {
+                authorized = false;
+            }
+        }
+        const options = typeof configured === 'object' ? configured : {};
+        const durationMs = Math.min(2000, Math.max(650, options.durationMs ?? 900));
+        const allowFallback = options.fallback !== 'none';
+        if (!authorized) {
+            if (typeof native?.setEnabled === 'function') {
+                await native.setEnabled(false, durationMs).catch(() => undefined);
+            }
+            return { ...base, appId: access.appId, installationId: access.installationId, reason: 'installation-not-authorized' };
+        }
+        const preferenceScope = dogfoodControlPreferenceScope(access.appId, access.installationId);
+        const cachedPresentation = await (0, preferences_1.getDogfoodControlPresentation)(preferenceScope);
+        const cachedOnboardingSeen = await (0, preferences_1.getDogfoodControlOnboardingSeen)(preferenceScope);
+        const onboardingSeen = syncOptions.onboardingSeen
+            ?? access.controlOnboardingSeen
+            ?? cachedOnboardingSeen;
+        // A newly authorized tester must never be left staring at an invisible
+        // feature. Until the exact installation has completed onboarding in
+        // Convex, the edge-docked Y wins even when the gesture is supported.
+        const preferredPresentation = syncOptions.presentation
+            || access.controlPresentation
+            || cachedPresentation
+            || options.defaultPresentation
+            || 'auto';
+        const presentation = onboardingSeen
+            ? preferredPresentation
+            : 'minimized-y';
+        if (typeof native?.getCapability !== 'function' || typeof native?.setEnabled !== 'function') {
+            const result = {
+                ...base,
+                authorized: true,
+                appId: access.appId,
+                installationId: access.installationId,
+                presentation: 'minimized-y',
+                onboardingSeen,
+                fallbackVisible: allowFallback,
+            };
+            if (syncOptions.requirePersistence) {
+                const token = config?.authToken || await (0, auth_1.getToken)();
+                if (!token || !access.installationId) {
+                    throw new Error('A full Yaver session is required to save Dogfood settings.');
+                }
+                const persisted = await (0, auth_1.setDogfoodControlPreference)({
+                    appId: access.appId,
+                    installationId: access.installationId,
+                    token,
+                    presentation: 'minimized-y',
+                    gestureSupported: false,
+                    gestureCapabilityReason: 'native-module-unavailable',
+                    gesturePlatform: react_native_1.Platform.OS,
+                    controlOnboardingSeen: onboardingSeen,
+                });
+                if (!persisted)
+                    throw new Error('Could not save this Dogfood control preference to Yaver.');
+                await (0, preferences_1.setDogfoodControlPresentation)('minimized-y', preferenceScope);
+                if (onboardingSeen)
+                    await (0, preferences_1.setDogfoodControlOnboardingSeen)(true, preferenceScope);
+            }
+            return result;
+        }
+        try {
+            const capability = await native.getCapability();
+            const gestureSupported = capability?.supported === true;
+            const shouldEnableGesture = gestureSupported && onboardingSeen && presentation === 'auto';
+            const applied = await native.setEnabled(shouldEnableGesture, durationMs);
+            const gestureEnabled = shouldEnableGesture && applied?.enabled === true;
+            const gestureEnableFailed = shouldEnableGesture && !gestureEnabled;
+            const result = {
+                configured: true,
+                authorized: true,
+                appId: access.appId,
+                installationId: access.installationId,
+                gestureSupported,
+                gestureEnabled,
+                fallbackVisible: allowFallback && (!gestureSupported || presentation === 'minimized-y' || gestureEnableFailed),
+                presentation,
+                onboardingSeen,
+                reason: gestureEnableFailed
+                    ? 'gesture-enable-failed'
+                    : String(applied?.reason || capability?.reason || (gestureSupported ? 'supported' : 'unsupported')),
+                platform: String(applied?.platform || capability?.platform || react_native_1.Platform.OS),
+            };
+            const token = config?.authToken || await (0, auth_1.getToken)();
+            if (syncOptions.requirePersistence && (!token || !access.installationId)) {
+                await native.setEnabled(false, durationMs).catch(() => undefined);
+                throw new Error('A full Yaver session is required to save Dogfood settings.');
+            }
+            if (token && access.installationId) {
+                const needsPersistence = access.controlPresentation !== presentation
+                    || access.gestureSupported !== gestureSupported
+                    || access.gestureCapabilityReason !== result.reason
+                    || (syncOptions.onboardingSeen === true && access.controlOnboardingSeen !== true);
+                if (needsPersistence) {
+                    const persisted = await (0, auth_1.setDogfoodControlPreference)({
+                        appId: access.appId,
+                        installationId: access.installationId,
+                        token,
+                        presentation,
+                        gestureSupported,
+                        gestureCapabilityReason: result.reason,
+                        gesturePlatform: result.platform || react_native_1.Platform.OS,
+                        controlOnboardingSeen: onboardingSeen,
+                    });
+                    if (!persisted && syncOptions.requirePersistence) {
+                        await native.setEnabled(false, durationMs).catch(() => undefined);
+                        throw new Error('Could not save this Dogfood control preference to Yaver.');
+                    }
+                    if (persisted) {
+                        await (0, preferences_1.setDogfoodControlPresentation)(presentation, preferenceScope);
+                        if (onboardingSeen)
+                            await (0, preferences_1.setDogfoodControlOnboardingSeen)(true, preferenceScope);
+                    }
+                }
+                else {
+                    await (0, preferences_1.setDogfoodControlPresentation)(presentation, preferenceScope);
+                    if (onboardingSeen)
+                        await (0, preferences_1.setDogfoodControlOnboardingSeen)(true, preferenceScope);
+                }
+            }
+            return result;
+        }
+        catch (error) {
+            await native.setEnabled(false, durationMs).catch(() => undefined);
+            if (syncOptions.requirePersistence) {
+                throw error instanceof Error
+                    ? error
+                    : new Error('Could not save this Dogfood control preference to Yaver.');
+            }
+            return {
+                ...base,
+                authorized: true,
+                appId: access.appId,
+                installationId: access.installationId,
+                presentation: 'minimized-y',
+                onboardingSeen,
+                fallbackVisible: allowFallback,
+                reason: 'native-capability-check-failed',
+            };
+        }
+    }
+    /** Complete first-run onboarding or change the later control preference.
+     * Convex is authoritative and keyed by full Yaver user + app + installation;
+     * the local value is only a cold-start cache. */
+    static async setDogfoodControlPresentation(presentation) {
+        if (presentation !== 'auto' && presentation !== 'minimized-y') {
+            throw new Error('Invalid Dogfood control presentation.');
+        }
+        return YaverFeedback.syncDogfoodControlGesture({
+            presentation,
+            onboardingSeen: true,
+            requirePersistence: true,
+        });
+    }
+    /** One-tap fast reload for the compact Dogfood card. It preserves the same
+     * selected render machine and bearer-authenticated P2P route as the full
+     * Feedback modal, and names missing auth/machine state instead of no-oping. */
+    static async requestDogfoodFastReload() {
+        await YaverFeedback.hydrateSession();
+        if (!config?.authToken) {
+            YaverFeedback.showLogin();
+            throw new Error('Sign in to Yaver before requesting Fast Reload.');
+        }
+        if (!config.preferredDeviceId) {
+            YaverFeedback.showMachinePicker();
+            throw new Error('Choose a render machine before requesting Fast Reload.');
+        }
+        const selected = await YaverFeedback.getSelectedRemoteDevice();
+        if (!selected) {
+            YaverFeedback.showMachinePicker();
+            throw new Error('The selected render machine is no longer available.');
+        }
+        if (selected.needsAuth) {
+            YaverFeedback.showMachinePicker();
+            throw new Error('The selected render machine needs pairing again.');
+        }
+        if (!selected.isOnline) {
+            throw new Error('The selected render machine is offline.');
+        }
+        let client = YaverFeedback.getRenderP2PClient();
+        if (!client && await YaverFeedback.reconnect()) {
+            client = YaverFeedback.getRenderP2PClient();
+        }
+        if (!client)
+            throw new Error('The render machine is not connected yet.');
+        try {
+            const ack = await client.reloadWithMode('fast');
+            return ack.message;
+        }
+        catch (firstError) {
+            if (await YaverFeedback.reconnect()) {
+                const retry = YaverFeedback.getRenderP2PClient();
+                if (retry)
+                    return (await retry.reloadWithMode('fast')).message;
+            }
+            throw firstError;
+        }
+    }
     /** Backwards-compatible entry point for existing integrations. */
     static async beginDogfoodOnboarding(options) {
         YaverFeedback.configureDogfood(options);
@@ -1066,11 +1324,24 @@ class YaverFeedback {
             publishDogfoodFlow(state);
             return state;
         }
-        await YaverFeedback.hydrateSession();
-        const token = config?.authToken || await (0, auth_1.getToken)();
-        const account = token
-            ? await (0, auth_1.getDogfoodAccountAccess)(appId, token)
-            : { authenticated: false, ownerAuthorized: false, installationAuthorized: false };
+        let token;
+        let account;
+        try {
+            await YaverFeedback.hydrateSession();
+            token = config?.authToken || await (0, auth_1.getToken)();
+            account = token
+                ? await (0, auth_1.getDogfoodAccountAccess)(appId, token)
+                : { authenticated: false, ownerAuthorized: false, accountAuthorized: false, installationAuthorized: false };
+        }
+        catch (cause) {
+            const state = {
+                phase: 'error',
+                appId,
+                error: cause instanceof Error ? cause.message : 'Yaver could not verify Dogfood access.',
+            };
+            publishDogfoodFlow(state);
+            return state;
+        }
         // A device key is a second factor for this installation, never a
         // replacement for a real Yaver account. Narrow installation sessions and
         // stale/invalid cached tokens both return authenticated=false here.
@@ -1080,6 +1351,15 @@ class YaverFeedback {
             YaverFeedback.showLogin();
             return state;
         }
+        if (!account.accountAuthorized) {
+            const state = {
+                phase: 'denied',
+                appId,
+                error: 'The app owner has not enabled Dogfood for this Yaver account.',
+            };
+            publishDogfoodFlow(state);
+            return state;
+        }
         if (!config?.preferredDeviceId) {
             const state = { phase: 'machine-required', appId };
             publishDogfoodFlow(state);
@@ -1191,6 +1471,7 @@ class YaverFeedback {
         renderP2PClient = null;
         p2pAuthToken = null;
         await YaverFeedback.syncDogfoodAppShortcut().catch(() => false);
+        await YaverFeedback.syncDogfoodControlGesture().catch(() => undefined);
     }
     /**
      * Manually trigger the feedback collection flow.
@@ -1475,6 +1756,7 @@ class YaverFeedback {
         }
         catch { /* noop */ }
         await YaverFeedback.syncDogfoodAppShortcut().catch(() => false);
+        await YaverFeedback.syncDogfoodControlGesture().catch(() => undefined);
         return { status, installationId: info.installationId, session };
     }
     /** Confirmed by the Y badge/UI before this is called. Reverts this SDK to
@@ -1490,6 +1772,7 @@ class YaverFeedback {
             DeviceEventEmitter.emit('yaverFeedback:dogfoodChanged', { active: false, exited: true });
         }
         catch { /* noop */ }
+        await YaverFeedback.syncDogfoodControlGesture().catch(() => undefined);
     }
     /** Returns the resolved relay password the SDK is currently using.
      *  Empty string when no relay routing is in play (direct LAN agent
@@ -1988,6 +2271,13 @@ class YaverFeedback {
         dogfoodShortcutAppStateSubscription = null;
         dogfoodActivationSubscription?.remove();
         dogfoodActivationSubscription = null;
+        try {
+            const native = react_native_1.NativeModules?.YaverDogfoodGesture;
+            if (typeof native?.setEnabled === 'function') {
+                void native.setEnabled(false, 900).catch(() => undefined);
+            }
+        }
+        catch { /* native trigger teardown is best-effort */ }
         lastDogfoodActivationUrl = '';
         // Before `enabled = false` / `config = null` below, so an in-flight retry
         // can't fire against a torn-down config.

package/dist/__tests__/NativeDogfoodShortcut.test.js

@@ -22,6 +22,24 @@ public class AppDelegate: ExpoAppDelegate {
         expect(once).toContain('markDogfoodShortcutPending()');
         expect(plugin.__test.patchDogfoodAppShortcut(once)).toBe(once);
     });
+    it('patches cold and warm scene-lifecycle delivery idempotently', () => {
+        const source = `
+final class TalosSceneDelegate: UIResponder, UIWindowSceneDelegate {
+  func scene(
+    _ scene: UIScene,
+    willConnectTo session: UISceneSession,
+    options connectionOptions: UIScene.ConnectionOptions
+  ) {
+    guard scene is UIWindowScene else { return }
+  }
+}
+`;
+        const once = plugin.__test.patchDogfoodSceneDelegate(source);
+        expect(once).toContain('connectionOptions.shortcutItem');
+        expect(once).toContain('func windowScene(');
+        expect(once).toContain('markDogfoodShortcutPending()');
+        expect(plugin.__test.patchDogfoodSceneDelegate(once)).toBe(once);
+    });
     it('uses dynamic native shortcuts on both platforms', () => {
         const ios = (0, fs_1.readFileSync)((0, path_1.join)(__dirname, '../../ios/YaverHotReload.swift'), 'utf8');
         const android = (0, fs_1.readFileSync)((0, path_1.join)(__dirname, '../../android/src/main/java/io/yaver/feedback/YaverHotReloadModule.java'), 'utf8');
@@ -31,4 +49,18 @@ public class AppDelegate: ExpoAppDelegate {
         expect(android).toContain('addDynamicShortcuts');
         expect(android).toContain('consumeDogfoodShortcut');
     });
+    it('observes a three-finger hold without consuming host app touches', () => {
+        const ios = (0, fs_1.readFileSync)((0, path_1.join)(__dirname, '../../ios/YaverDogfoodGesture.swift'), 'utf8');
+        const android = (0, fs_1.readFileSync)((0, path_1.join)(__dirname, '../../android/src/main/java/io/yaver/feedback/YaverDogfoodGestureModule.java'), 'utf8');
+        const controls = (0, fs_1.readFileSync)((0, path_1.join)(__dirname, '../DogfoodQuickControls.tsx'), 'utf8');
+        expect(ios).toContain('numberOfTouchesRequired = 3');
+        expect(ios).toContain('cancelsTouchesInView = false');
+        expect(ios).toContain('isVoiceOverRunning');
+        expect(android).toContain('event.getPointerCount() >= 3');
+        expect(android).toContain('method.invoke(callback, args)');
+        expect(android).toContain('isTouchExplorationEnabled');
+        expect(controls).toContain('yaver-dogfood-fast-reload');
+        expect(controls).toContain('yaver-dogfood-chat');
+        expect(controls).toContain('yaver-dogfood-minimized-control');
+    });
 });