@ateam-ai-mobile/expo 0.1.11 → 0.1.13

package/dist/index.mjs

@@ -9,7 +9,7 @@ import {
   parseWalkJsonl,
   setupExpoProviders,
   visualEngine
-} from "./chunk-C7M5WAHA.mjs";
+} from "./chunk-42FP5DTO.mjs";
 import {
   cameraTasks
 } from "./chunk-6LXF3JVX.mjs";

package/dist/vision/index.d.mts

@@ -61,8 +61,15 @@ interface VisionObject {
 declare function isSupported(): boolean;
 /** One-shot: measure a frame's quality from its LOCAL file. Throws if it cannot look. */
 declare function assessQuality(uri: string): Promise<RawFrameQuality>;
-/** Start the vision session — publishes a timeline frame every `intervalMs`. */
-declare function startVision(intervalMs?: number): Promise<void>;
+/** Which camera the vision session reads. */
+type VisionFacing = 'front' | 'back';
+/**
+ * Start the vision session on `facing` — publishes a timeline frame every
+ * `intervalMs`. The back camera works on every binary; the front camera needs a
+ * binary built with it, and an older one REFUSES it rather than quietly reading
+ * the back camera instead.
+ */
+declare function startVision(intervalMs?: number, facing?: VisionFacing): Promise<void>;
 /** Stop the vision session and release the camera. */
 declare function stopVision(): void;
 /** Subscribe to published timeline frames (id + quality + expiry; no pixels). */
@@ -80,4 +87,4 @@ declare function describe(id: string, maxLabels?: number): Promise<VisionLabel[]
  *  couldn't look (id aged out, or the model isn't in this build). */
 declare function detectObjects(id: string, maxItems?: number, minConfidence?: number): Promise<VisionObject[]>;
 
-export { CameraPreview, type RawFrameQuality, type VisionFrame, type VisionLabel, type VisionObject, type VisionText, assessQuality, describe, detectObjects, isSupported, onVisionFrame, qualityById, readText, startVision, stopVision, visionRetentionMs };
+export { CameraPreview, type RawFrameQuality, type VisionFacing, type VisionFrame, type VisionLabel, type VisionObject, type VisionText, assessQuality, describe, detectObjects, isSupported, onVisionFrame, qualityById, readText, startVision, stopVision, visionRetentionMs };

package/dist/vision/index.d.ts

@@ -61,8 +61,15 @@ interface VisionObject {
 declare function isSupported(): boolean;
 /** One-shot: measure a frame's quality from its LOCAL file. Throws if it cannot look. */
 declare function assessQuality(uri: string): Promise<RawFrameQuality>;
-/** Start the vision session — publishes a timeline frame every `intervalMs`. */
-declare function startVision(intervalMs?: number): Promise<void>;
+/** Which camera the vision session reads. */
+type VisionFacing = 'front' | 'back';
+/**
+ * Start the vision session on `facing` — publishes a timeline frame every
+ * `intervalMs`. The back camera works on every binary; the front camera needs a
+ * binary built with it, and an older one REFUSES it rather than quietly reading
+ * the back camera instead.
+ */
+declare function startVision(intervalMs?: number, facing?: VisionFacing): Promise<void>;
 /** Stop the vision session and release the camera. */
 declare function stopVision(): void;
 /** Subscribe to published timeline frames (id + quality + expiry; no pixels). */
@@ -80,4 +87,4 @@ declare function describe(id: string, maxLabels?: number): Promise<VisionLabel[]
  *  couldn't look (id aged out, or the model isn't in this build). */
 declare function detectObjects(id: string, maxItems?: number, minConfidence?: number): Promise<VisionObject[]>;
 
-export { CameraPreview, type RawFrameQuality, type VisionFrame, type VisionLabel, type VisionObject, type VisionText, assessQuality, describe, detectObjects, isSupported, onVisionFrame, qualityById, readText, startVision, stopVision, visionRetentionMs };
+export { CameraPreview, type RawFrameQuality, type VisionFacing, type VisionFrame, type VisionLabel, type VisionObject, type VisionText, assessQuality, describe, detectObjects, isSupported, onVisionFrame, qualityById, readText, startVision, stopVision, visionRetentionMs };

package/dist/vision/index.js

@@ -43,6 +43,14 @@ var CameraPreview = (() => {
   }
 })();
 var native = (0, import_expo_modules_core.requireOptionalNativeModule)("AdaVision");
+function verb(name) {
+  if (!native) throw new Error("ada-vision native module not present in this build");
+  const fn = native[name];
+  if (typeof fn !== "function") {
+    throw Object.assign(new Error(`UNAVAILABLE: ada-vision ${String(name)} is not implemented on this platform (iOS only)`), { code: "UNAVAILABLE" });
+  }
+  return fn.bind(native);
+}
 function isSupported() {
   try {
     return native?.isSupported() ?? false;
@@ -54,9 +62,15 @@ async function assessQuality(uri) {
   if (!native) throw new Error("ada-vision native module not present in this build");
   return native.assessQuality(uri);
 }
-async function startVision(intervalMs = 1e3) {
-  if (!native) throw new Error("ada-vision native module not present in this build");
-  return native.startVision(intervalMs);
+async function startVision(intervalMs = 1e3, facing = "back") {
+  if (facing !== "front" && facing !== "back") {
+    throw new Error(`Unknown camera "${String(facing)}" \u2014 use "front" or "back"`);
+  }
+  if (facing === "back") return verb("startVision")(intervalMs);
+  if (native && typeof native.startVisionCamera !== "function") {
+    throw new Error("the front camera needs a newer app build \u2014 this one can read the back camera only");
+  }
+  return verb("startVisionCamera")(intervalMs, facing);
 }
 function stopVision() {
   native?.stopVision?.();
@@ -73,16 +87,13 @@ function qualityById(id) {
   return native?.qualityById?.(id) ?? null;
 }
 async function readText(id, languages) {
-  if (!native) throw new Error("ada-vision native module not present in this build");
-  return native.readText(id, languages ?? null);
+  return verb("readText")(id, languages ?? null);
 }
 async function describe(id, maxLabels = 5) {
-  if (!native) throw new Error("ada-vision native module not present in this build");
-  return native.describe(id, maxLabels);
+  return verb("describe")(id, maxLabels);
 }
 async function detectObjects(id, maxItems = 10, minConfidence = 0.25) {
-  if (!native) throw new Error("ada-vision native module not present in this build");
-  return native.detectObjects(id, maxItems, minConfidence);
+  return verb("detectObjects")(id, maxItems, minConfidence);
 }
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {

package/dist/vision/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/vision/index.ts"],"sourcesContent":["// ada-vision — on-device image understanding, our own native code (no camera lib).\n//\n// On-device, frames never leave the phone:\n//   assessQuality(uri)          — one-shot quality of a LOCAL frame file.\n//   startVision()/onVisionFrame — the headless camera session that publishes a\n//                                 timeline frame (id + quality, never pixels) at a\n//                                 cadence; readText/describe/detectObjects resolve\n//                                 a published id ON-DEVICE.\n//\n// The luma math mirrors ./analysis.js (which has the exhaustive unit tests).\n//\n// requireOptionalNativeModule: on a binary WITHOUT the native module, the import\n// is null, isSupported() is false, and the session calls refuse cleanly (no crash).\n\nimport type { ComponentType } from 'react';\nimport { requireOptionalNativeModule } from 'expo-modules-core';\nimport { requireNativeView } from 'expo';\n\n/** TEST-ONLY live preview bound to the same headless session (so a tester can\n *  aim). The real Guide runs headless and never mounts this. Null on a binary\n *  without the native view, so importing this module never crashes. */\nexport const CameraPreview: ComponentType<any> | null = (() => {\n  try { return requireNativeView('AdaVision'); } catch { return null; }\n})();\n\nexport interface RawFrameQuality {\n  blur: 'sharp' | 'slight' | 'severe' | 'unknown';\n  exposure: 'good' | 'dark' | 'bright' | 'unknown';\n  /** true = lens covered; false = clearly not; null = not assessed. */\n  obstructed: boolean | null;\n}\n\ninterface Subscription { remove(): void }\n\n/** A published timeline frame from the vision session (metadata only — never\n *  pixels; the buffer stays in the native ring, resolved by id). */\nexport interface VisionFrame {\n  id: string;\n  ts: number;\n  expiresAt: number;\n  blur: RawFrameQuality['blur'];\n  exposure: RawFrameQuality['exposure'];\n  obstructed: RawFrameQuality['obstructed'];\n}\n\n/** One OCR result on a frame — matches the SDK's VisionText. */\nexport interface VisionText {\n  text: string;\n  /** 0..1 recogniser confidence (never a 1.0 filler). */\n  confidence: number | null;\n  /** Normalised 0..1 box, origin TOP-left, in the UPRIGHT portrait frame (native\n   *  rotates frames at capture) — x runs from the user's left to their right. */\n  box?: { x: number; y: number; width: number; height: number };\n}\n\n/** One classifier label — a vocabulary term, NOT prose. Matches VisionLabel. */\nexport interface VisionLabel {\n  label: string;\n  confidence: number | null;\n}\n\n/** One detected object — a located item with a box, from the bundled detector. */\nexport interface VisionObject {\n  /** Open-Images class name (e.g. \"Car\", \"Traffic light\", \"Building\", \"Person\"). */\n  label: string;\n  /** 0..1 detector confidence. */\n  confidence: number | null;\n  /** Normalised 0..1 box, origin TOP-left, in the UPRIGHT portrait frame (native\n   *  rotates frames at capture) — x runs from the user's left to their right. */\n  box?: { x: number; y: number; width: number; height: number };\n}\n\ninterface AdaVisionNative {\n  isSupported(): boolean;\n  assessQuality(uri: string): Promise<RawFrameQuality>;\n  startVision(intervalMs: number): Promise<void>;\n  stopVision(): void;\n  visionRetentionMs(): number;\n  qualityById(id: string): RawFrameQuality | null;\n  readText(id: string, languages: string[] | null): Promise<VisionText[]>;\n  describe(id: string, maxLabels: number): Promise<VisionLabel[]>;\n  detectObjects(id: string, maxItems: number, minConfidence: number): Promise<VisionObject[]>;\n  addListener(event: 'visionFrame', cb: (f: VisionFrame) => void): Subscription;\n}\n\nconst native = requireOptionalNativeModule<AdaVisionNative>('AdaVision');\n\n/** Is the native vision module present in this binary? */\nexport function isSupported(): boolean {\n  try { return native?.isSupported() ?? false; } catch { return false; }\n}\n\n/** One-shot: measure a frame's quality from its LOCAL file. Throws if it cannot look. */\nexport async function assessQuality(uri: string): Promise<RawFrameQuality> {\n  if (!native) throw new Error('ada-vision native module not present in this build');\n  return native.assessQuality(uri);\n}\n\n// ── Vision session (feeds the Visual Engine) ──\n\n/** Start the vision session — publishes a timeline frame every `intervalMs`. */\nexport async function startVision(intervalMs = 1000): Promise<void> {\n  if (!native) throw new Error('ada-vision native module not present in this build');\n  return native.startVision(intervalMs);\n}\n\n/** Stop the vision session and release the camera. */\nexport function stopVision(): void {\n  native?.stopVision?.();\n}\n\n/** Subscribe to published timeline frames (id + quality + expiry; no pixels). */\nexport function onVisionFrame(cb: (f: VisionFrame) => void): Subscription {\n  if (!native) return { remove() {} };\n  return native.addListener('visionFrame', cb);\n}\n\n/** How far back the native ring can still resolve a frame id (ms). */\nexport function visionRetentionMs(): number {\n  return native?.visionRetentionMs?.() ?? 0;\n}\n\n/** Resolve a published frame id → its measured quality (null if evicted). */\nexport function qualityById(id: string): RawFrameQuality | null {\n  return native?.qualityById?.(id) ?? null;\n}\n\n/** On-device OCR on a published frame. [] = looked, no text; throws = couldn't look. */\nexport async function readText(id: string, languages?: string[]): Promise<VisionText[]> {\n  if (!native) throw new Error('ada-vision native module not present in this build');\n  return native.readText(id, languages ?? null);\n}\n\n/** On-device image classification → labels (not prose). [] = nothing recognised. */\nexport async function describe(id: string, maxLabels = 5): Promise<VisionLabel[]> {\n  if (!native) throw new Error('ada-vision native module not present in this build');\n  return native.describe(id, maxLabels);\n}\n\n/** On-device object detection (bundled YOLOv8n, Open-Images vocabulary) → located\n *  items with boxes. [] = looked, found nothing above `minConfidence`; throws =\n *  couldn't look (id aged out, or the model isn't in this build). */\nexport async function detectObjects(id: string, maxItems = 10, minConfidence = 0.25): Promise<VisionObject[]> {\n  if (!native) throw new Error('ada-vision native module not present in this build');\n  return native.detectObjects(id, maxItems, minConfidence);\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAeA,+BAA4C;AAC5C,kBAAkC;AAK3B,IAAM,iBAA4C,MAAM;AAC7D,MAAI;AAAE,eAAO,+BAAkB,WAAW;AAAA,EAAG,QAAQ;AAAE,WAAO;AAAA,EAAM;AACtE,GAAG;AA8DH,IAAM,aAAS,sDAA6C,WAAW;AAGhE,SAAS,cAAuB;AACrC,MAAI;AAAE,WAAO,QAAQ,YAAY,KAAK;AAAA,EAAO,QAAQ;AAAE,WAAO;AAAA,EAAO;AACvE;AAGA,eAAsB,cAAc,KAAuC;AACzE,MAAI,CAAC,OAAQ,OAAM,IAAI,MAAM,oDAAoD;AACjF,SAAO,OAAO,cAAc,GAAG;AACjC;AAKA,eAAsB,YAAY,aAAa,KAAqB;AAClE,MAAI,CAAC,OAAQ,OAAM,IAAI,MAAM,oDAAoD;AACjF,SAAO,OAAO,YAAY,UAAU;AACtC;AAGO,SAAS,aAAmB;AACjC,UAAQ,aAAa;AACvB;AAGO,SAAS,cAAc,IAA4C;AACxE,MAAI,CAAC,OAAQ,QAAO,EAAE,SAAS;AAAA,EAAC,EAAE;AAClC,SAAO,OAAO,YAAY,eAAe,EAAE;AAC7C;AAGO,SAAS,oBAA4B;AAC1C,SAAO,QAAQ,oBAAoB,KAAK;AAC1C;AAGO,SAAS,YAAY,IAAoC;AAC9D,SAAO,QAAQ,cAAc,EAAE,KAAK;AACtC;AAGA,eAAsB,SAAS,IAAY,WAA6C;AACtF,MAAI,CAAC,OAAQ,OAAM,IAAI,MAAM,oDAAoD;AACjF,SAAO,OAAO,SAAS,IAAI,aAAa,IAAI;AAC9C;AAGA,eAAsB,SAAS,IAAY,YAAY,GAA2B;AAChF,MAAI,CAAC,OAAQ,OAAM,IAAI,MAAM,oDAAoD;AACjF,SAAO,OAAO,SAAS,IAAI,SAAS;AACtC;AAKA,eAAsB,cAAc,IAAY,WAAW,IAAI,gBAAgB,MAA+B;AAC5G,MAAI,CAAC,OAAQ,OAAM,IAAI,MAAM,oDAAoD;AACjF,SAAO,OAAO,cAAc,IAAI,UAAU,aAAa;AACzD;","names":[]}
+{"version":3,"sources":["../../src/vision/index.ts"],"sourcesContent":["// ada-vision — on-device image understanding, our own native code (no camera lib).\n//\n// On-device, frames never leave the phone:\n//   assessQuality(uri)          — one-shot quality of a LOCAL frame file.\n//   startVision()/onVisionFrame — the headless camera session that publishes a\n//                                 timeline frame (id + quality, never pixels) at a\n//                                 cadence; readText/describe/detectObjects resolve\n//                                 a published id ON-DEVICE.\n//\n// The luma math mirrors ./analysis.js (which has the exhaustive unit tests).\n//\n// requireOptionalNativeModule: on a binary WITHOUT the native module, the import\n// is null, isSupported() is false, and the session calls refuse cleanly (no crash).\n\nimport type { ComponentType } from 'react';\nimport { requireOptionalNativeModule } from 'expo-modules-core';\nimport { requireNativeView } from 'expo';\n\n/** TEST-ONLY live preview bound to the same headless session (so a tester can\n *  aim). The real Guide runs headless and never mounts this. Null on a binary\n *  without the native view, so importing this module never crashes. */\nexport const CameraPreview: ComponentType<any> | null = (() => {\n  try { return requireNativeView('AdaVision'); } catch { return null; }\n})();\n\nexport interface RawFrameQuality {\n  blur: 'sharp' | 'slight' | 'severe' | 'unknown';\n  exposure: 'good' | 'dark' | 'bright' | 'unknown';\n  /** true = lens covered; false = clearly not; null = not assessed. */\n  obstructed: boolean | null;\n}\n\ninterface Subscription { remove(): void }\n\n/** A published timeline frame from the vision session (metadata only — never\n *  pixels; the buffer stays in the native ring, resolved by id). */\nexport interface VisionFrame {\n  id: string;\n  ts: number;\n  expiresAt: number;\n  blur: RawFrameQuality['blur'];\n  exposure: RawFrameQuality['exposure'];\n  obstructed: RawFrameQuality['obstructed'];\n}\n\n/** One OCR result on a frame — matches the SDK's VisionText. */\nexport interface VisionText {\n  text: string;\n  /** 0..1 recogniser confidence (never a 1.0 filler). */\n  confidence: number | null;\n  /** Normalised 0..1 box, origin TOP-left, in the UPRIGHT portrait frame (native\n   *  rotates frames at capture) — x runs from the user's left to their right. */\n  box?: { x: number; y: number; width: number; height: number };\n}\n\n/** One classifier label — a vocabulary term, NOT prose. Matches VisionLabel. */\nexport interface VisionLabel {\n  label: string;\n  confidence: number | null;\n}\n\n/** One detected object — a located item with a box, from the bundled detector. */\nexport interface VisionObject {\n  /** Open-Images class name (e.g. \"Car\", \"Traffic light\", \"Building\", \"Person\"). */\n  label: string;\n  /** 0..1 detector confidence. */\n  confidence: number | null;\n  /** Normalised 0..1 box, origin TOP-left, in the UPRIGHT portrait frame (native\n   *  rotates frames at capture) — x runs from the user's left to their right. */\n  box?: { x: number; y: number; width: number; height: number };\n}\n\ninterface AdaVisionNative {\n  isSupported(): boolean;\n  assessQuality(uri: string): Promise<RawFrameQuality>;\n  startVision(intervalMs: number): Promise<void>;\n  /** Absent from binaries built before the front camera existed. */\n  startVisionCamera?(intervalMs: number, facing: VisionFacing): Promise<void>;\n  stopVision(): void;\n  visionRetentionMs(): number;\n  qualityById(id: string): RawFrameQuality | null;\n  readText(id: string, languages: string[] | null): Promise<VisionText[]>;\n  describe(id: string, maxLabels: number): Promise<VisionLabel[]>;\n  detectObjects(id: string, maxItems: number, minConfidence: number): Promise<VisionObject[]>;\n  addListener(event: 'visionFrame', cb: (f: VisionFrame) => void): Subscription;\n}\n\nconst native = requireOptionalNativeModule<AdaVisionNative>('AdaVision');\n\n/** The native function, or a refusal by name: Android's AdaVision has assessQuality only\n *  (AI Models F4), so a verb it lacks says so instead of failing as \"not a function\". */\nfunction verb<K extends keyof AdaVisionNative>(name: K): AdaVisionNative[K] {\n  if (!native) throw new Error('ada-vision native module not present in this build');\n  const fn = native[name];\n  if (typeof fn !== 'function') {\n    throw Object.assign(new Error(`UNAVAILABLE: ada-vision ${String(name)} is not implemented on this platform (iOS only)`), { code: 'UNAVAILABLE' });\n  }\n  return (fn as Function).bind(native) as AdaVisionNative[K];\n}\n\n/** Is the native vision module present in this binary? */\nexport function isSupported(): boolean {\n  try { return native?.isSupported() ?? false; } catch { return false; }\n}\n\n/** One-shot: measure a frame's quality from its LOCAL file. Throws if it cannot look. */\nexport async function assessQuality(uri: string): Promise<RawFrameQuality> {\n  if (!native) throw new Error('ada-vision native module not present in this build');\n  return native.assessQuality(uri);\n}\n\n// ── Vision session (feeds the Visual Engine) ──\n\n/** Which camera the vision session reads. */\nexport type VisionFacing = 'front' | 'back';\n\n/**\n * Start the vision session on `facing` — publishes a timeline frame every\n * `intervalMs`. The back camera works on every binary; the front camera needs a\n * binary built with it, and an older one REFUSES it rather than quietly reading\n * the back camera instead.\n */\nexport async function startVision(intervalMs = 1000, facing: VisionFacing = 'back'): Promise<void> {\n  if (facing !== 'front' && facing !== 'back') {\n    throw new Error(`Unknown camera \"${String(facing)}\" — use \"front\" or \"back\"`);\n  }\n  if (facing === 'back') return verb('startVision')(intervalMs);\n  if (native && typeof native.startVisionCamera !== 'function') {\n    throw new Error('the front camera needs a newer app build — this one can read the back camera only');\n  }\n  return verb('startVisionCamera')!(intervalMs, facing);\n}\n\n/** Stop the vision session and release the camera. */\nexport function stopVision(): void {\n  native?.stopVision?.();\n}\n\n/** Subscribe to published timeline frames (id + quality + expiry; no pixels). */\nexport function onVisionFrame(cb: (f: VisionFrame) => void): Subscription {\n  if (!native) return { remove() {} };\n  return native.addListener('visionFrame', cb);\n}\n\n/** How far back the native ring can still resolve a frame id (ms). */\nexport function visionRetentionMs(): number {\n  return native?.visionRetentionMs?.() ?? 0;\n}\n\n/** Resolve a published frame id → its measured quality (null if evicted). */\nexport function qualityById(id: string): RawFrameQuality | null {\n  return native?.qualityById?.(id) ?? null;\n}\n\n/** On-device OCR on a published frame. [] = looked, no text; throws = couldn't look. */\nexport async function readText(id: string, languages?: string[]): Promise<VisionText[]> {\n  return verb('readText')(id, languages ?? null);\n}\n\n/** On-device image classification → labels (not prose). [] = nothing recognised. */\nexport async function describe(id: string, maxLabels = 5): Promise<VisionLabel[]> {\n  return verb('describe')(id, maxLabels);\n}\n\n/** On-device object detection (bundled YOLOv8n, Open-Images vocabulary) → located\n *  items with boxes. [] = looked, found nothing above `minConfidence`; throws =\n *  couldn't look (id aged out, or the model isn't in this build). */\nexport async function detectObjects(id: string, maxItems = 10, minConfidence = 0.25): Promise<VisionObject[]> {\n  return verb('detectObjects')(id, maxItems, minConfidence);\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAeA,+BAA4C;AAC5C,kBAAkC;AAK3B,IAAM,iBAA4C,MAAM;AAC7D,MAAI;AAAE,eAAO,+BAAkB,WAAW;AAAA,EAAG,QAAQ;AAAE,WAAO;AAAA,EAAM;AACtE,GAAG;AAgEH,IAAM,aAAS,sDAA6C,WAAW;AAIvE,SAAS,KAAsC,MAA6B;AAC1E,MAAI,CAAC,OAAQ,OAAM,IAAI,MAAM,oDAAoD;AACjF,QAAM,KAAK,OAAO,IAAI;AACtB,MAAI,OAAO,OAAO,YAAY;AAC5B,UAAM,OAAO,OAAO,IAAI,MAAM,2BAA2B,OAAO,IAAI,CAAC,iDAAiD,GAAG,EAAE,MAAM,cAAc,CAAC;AAAA,EAClJ;AACA,SAAQ,GAAgB,KAAK,MAAM;AACrC;AAGO,SAAS,cAAuB;AACrC,MAAI;AAAE,WAAO,QAAQ,YAAY,KAAK;AAAA,EAAO,QAAQ;AAAE,WAAO;AAAA,EAAO;AACvE;AAGA,eAAsB,cAAc,KAAuC;AACzE,MAAI,CAAC,OAAQ,OAAM,IAAI,MAAM,oDAAoD;AACjF,SAAO,OAAO,cAAc,GAAG;AACjC;AAaA,eAAsB,YAAY,aAAa,KAAM,SAAuB,QAAuB;AACjG,MAAI,WAAW,WAAW,WAAW,QAAQ;AAC3C,UAAM,IAAI,MAAM,mBAAmB,OAAO,MAAM,CAAC,gCAA2B;AAAA,EAC9E;AACA,MAAI,WAAW,OAAQ,QAAO,KAAK,aAAa,EAAE,UAAU;AAC5D,MAAI,UAAU,OAAO,OAAO,sBAAsB,YAAY;AAC5D,UAAM,IAAI,MAAM,wFAAmF;AAAA,EACrG;AACA,SAAO,KAAK,mBAAmB,EAAG,YAAY,MAAM;AACtD;AAGO,SAAS,aAAmB;AACjC,UAAQ,aAAa;AACvB;AAGO,SAAS,cAAc,IAA4C;AACxE,MAAI,CAAC,OAAQ,QAAO,EAAE,SAAS;AAAA,EAAC,EAAE;AAClC,SAAO,OAAO,YAAY,eAAe,EAAE;AAC7C;AAGO,SAAS,oBAA4B;AAC1C,SAAO,QAAQ,oBAAoB,KAAK;AAC1C;AAGO,SAAS,YAAY,IAAoC;AAC9D,SAAO,QAAQ,cAAc,EAAE,KAAK;AACtC;AAGA,eAAsB,SAAS,IAAY,WAA6C;AACtF,SAAO,KAAK,UAAU,EAAE,IAAI,aAAa,IAAI;AAC/C;AAGA,eAAsB,SAAS,IAAY,YAAY,GAA2B;AAChF,SAAO,KAAK,UAAU,EAAE,IAAI,SAAS;AACvC;AAKA,eAAsB,cAAc,IAAY,WAAW,IAAI,gBAAgB,MAA+B;AAC5G,SAAO,KAAK,eAAe,EAAE,IAAI,UAAU,aAAa;AAC1D;","names":[]}

package/dist/vision/index.mjs

@@ -10,7 +10,7 @@ import {
   startVision,
   stopVision,
   visionRetentionMs
-} from "../chunk-PCAEUX2N.mjs";
+} from "../chunk-6JX222YX.mjs";
 import "../chunk-WMJKH4XE.mjs";
 export {
   CameraPreview,

package/ios/AdaVisionModule.swift

@@ -33,9 +33,17 @@ public class AdaVisionModule: Module {
     // still runs every camera frame; only the published frames are retained, so
     // the ring is cheap (≈ one frame/sec, not 24/sec).
     AsyncFunction("startVision") { (intervalMs: Int, promise: Promise) in
-      self.vision.start(intervalMs: max(200, intervalMs), emit: { [weak self] f in self?.sendEvent("visionFrame", f) }) { err in
-        if let err = err { promise.reject("AdaVision", err.localizedDescription) } else { promise.resolve(nil) }
+      self.startVision(intervalMs: intervalMs, facing: .back, promise: promise)
+    }
+    /** startVision with a chosen camera: "front" (the selfie camera, mirrored like
+     *  the view the user sees) or "back". A separate function rather than a new
+     *  startVision argument, so JS can tell a binary that has it from one that does
+     *  not and refuse the front camera honestly on the older one. */
+    AsyncFunction("startVisionCamera") { (intervalMs: Int, facing: String, promise: Promise) in
+      guard let position = VisionSession.position(facing) else {
+        promise.reject("AdaVision", "Unknown camera \"\(facing)\" — use \"front\" or \"back\""); return
       }
+      self.startVision(intervalMs: intervalMs, facing: position, promise: promise)
     }
     Function("stopVision") { () in self.vision.stop() }
     /** How far back the native ring can still resolve a frame id (ms). */
@@ -79,6 +87,12 @@ public class AdaVisionModule: Module {
     OnDestroy { self.vision.stop() }
   }
 
+  private func startVision(intervalMs: Int, facing: AVCaptureDevice.Position, promise: Promise) {
+    vision.start(intervalMs: max(200, intervalMs), facing: facing, emit: { [weak self] f in self?.sendEvent("visionFrame", f) }) { err in
+      if let err = err { promise.reject("AdaVision", err.localizedDescription) } else { promise.resolve(nil) }
+    }
+  }
+
   // MARK: file-backed one-shot (kept from v1)
   static func loadImage(_ uri: String) -> UIImage? {
     if let url = URL(string: uri), url.isFileURL, let data = try? Data(contentsOf: url) {
@@ -163,14 +177,16 @@ enum LumaMath {
 // the same upright image the user is pointing at, and boxes come back in upright
 // coordinates (x = 0 is the user's LEFT). This is the ONE rotation mechanism:
 // VNImageRequestHandler is always given the default .up orientation — passing an
-// orientation there as well would rotate twice. Back camera only (position:
-// .back), so nothing is mirrored: image-left is scene-left.
+// orientation there as well would rotate twice. The BACK camera is not mirrored:
+// image-left is scene-left. The FRONT camera is mirrored, like the selfie view the
+// preview shows, so a box sits where the user sees the thing on screen.
 final class VisionSession: NSObject, AVCaptureVideoDataOutputSampleBufferDelegate {
   private let session = AVCaptureSession()
   private let queue = DispatchQueue(label: "ai.ateam.adavision.session")
   private var emit: (([String: Any]) -> Void)?
   private var running = false
   private var intervalMs = 1000
+  private var facing: AVCaptureDevice.Position = .back
   private var lastPublish: CFTimeInterval = 0
   private let ringCap = 12
   // Bumped every start(). Frame ids embed it (vf_<gen>_<ms>) and the ring is
@@ -227,15 +243,25 @@ final class VisionSession: NSObject, AVCaptureVideoDataOutputSampleBufferDelegat
     return queue.sync { ring.first(where: { $0.id == id })?.quality }
   }
 
-  func start(intervalMs: Int, emit: @escaping ([String: Any]) -> Void, onReady: @escaping (Error?) -> Void) {
-    if running { onReady(nil); return }
-    self.intervalMs = intervalMs
+  /// "front" / "back" → the camera; nil for anything else (the caller refuses it).
+  static func position(_ facing: String) -> AVCaptureDevice.Position? {
+    switch facing {
+    case "front": return .front
+    case "back": return .back
+    default: return nil
+    }
+  }
+
+  func start(intervalMs: Int, facing: AVCaptureDevice.Position, emit: @escaping ([String: Any]) -> Void, onReady: @escaping (Error?) -> Void) {
+    // The camera asked for travels WITH this request into configureAndRun, which
+    // checks and changes the running state on `queue` only — two overlapping starts
+    // (one waiting on the permission prompt) can never open each other's camera.
     let status = AVCaptureDevice.authorizationStatus(for: .video)
     if status == .authorized {
-      configureAndRun(emit: emit, onReady: onReady)
+      configureAndRun(intervalMs: intervalMs, facing: facing, emit: emit, onReady: onReady)
     } else if status == .notDetermined {
       AVCaptureDevice.requestAccess(for: .video) { granted in
-        if granted { self.configureAndRun(emit: emit, onReady: onReady) }
+        if granted { self.configureAndRun(intervalMs: intervalMs, facing: facing, emit: emit, onReady: onReady) }
         else { onReady(NSError(domain: "AdaVision", code: 2, userInfo: [NSLocalizedDescriptionKey: "Camera permission denied"])) }
       }
     } else {
@@ -243,8 +269,20 @@ final class VisionSession: NSObject, AVCaptureVideoDataOutputSampleBufferDelegat
     }
   }
 
-  private func configureAndRun(emit: @escaping ([String: Any]) -> Void, onReady: @escaping (Error?) -> Void) {
+  private func configureAndRun(intervalMs: Int, facing: AVCaptureDevice.Position, emit: @escaping ([String: Any]) -> Void, onReady: @escaping (Error?) -> Void) {
     queue.async {
+      // Already running on THIS camera: nothing to do. On the other camera, the
+      // running one is torn down first.
+      if self.running && self.facing == facing { onReady(nil); return }
+      if self.running {
+        // Switching cameras: drop the running one before configuring the other.
+        self.running = false
+        self.session.stopRunning()
+        for i in self.session.inputs { self.session.removeInput(i) }
+        for o in self.session.outputs { self.session.removeOutput(o) }
+      }
+      self.intervalMs = intervalMs
+      self.facing = facing
       self.emit = emit
       self.ring.removeAll()
       self.lastPublish = 0
@@ -254,9 +292,7 @@ final class VisionSession: NSObject, AVCaptureVideoDataOutputSampleBufferDelegat
       // (a voice call can be running at the same time — see AdaAudioModule).
       self.session.automaticallyConfiguresApplicationAudioSession = false
       self.session.sessionPreset = .medium
-      // Back camera only. Offering the front camera would also need the connection
-      // mirrored (isVideoMirrored) so boxes match the mirrored view the user sees.
-      guard let device = AVCaptureDevice.default(.builtInWideAngleCamera, for: .video, position: .back),
+      guard let device = AVCaptureDevice.default(.builtInWideAngleCamera, for: .video, position: self.facing),
             let input = try? AVCaptureDeviceInput(device: device), self.session.canAddInput(input) else {
         self.session.commitConfiguration()
         onReady(NSError(domain: "AdaVision", code: 4, userInfo: [NSLocalizedDescriptionKey: "No usable camera"])); return
@@ -277,6 +313,12 @@ final class VisionSession: NSObject, AVCaptureVideoDataOutputSampleBufferDelegat
       if !upright {
         NSLog("AdaVision: cannot rotate the camera data output to portrait — frames stay sensor-landscape, so box x/y will not match left/right")
       }
+      // The front camera's frames are mirrored to match its preview (which AVFoundation
+      // mirrors by itself), so what a box says is on the left is on the left of the screen.
+      if self.facing == .front, let c = out.connection(with: .video), c.isVideoMirroringSupported {
+        c.automaticallyAdjustsVideoMirroring = false
+        c.isVideoMirrored = true
+      }
       self.session.commitConfiguration()
       self.running = true
       self.session.startRunning()

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ateam-ai-mobile/expo",
-  "version": "0.1.11",
+  "version": "0.1.13",
   "description": "Expo-backed providers for the ADAS SDK — haptics, bundle disk cache, attachment cache, device bridge.",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -9,9 +9,9 @@
     "build": "tsup"
   },
   "dependencies": {
-    "@ateam-ai-mobile/core": "0.1.11",
-    "@ateam-ai-mobile/plugin-runtime": "0.1.11",
-    "@ateam-ai-mobile/ui": "0.1.11"
+    "@ateam-ai-mobile/core": "0.1.13",
+    "@ateam-ai-mobile/plugin-runtime": "0.1.13",
+    "@ateam-ai-mobile/ui": "0.1.13"
   },
   "peerDependencies": {
     "@react-native-async-storage/async-storage": "*",

package/src/device-state/domains/visual.ts

@@ -23,7 +23,7 @@ function cameraState(): VisualSnapshot['camera'] {
     // would let a guide speak about a scene nothing is watching.
     available: !!session,
     active: visualEngine.isCameraReady(),
-    facing: session ? 'back' : 'unknown',
+    facing: session ? session.facing : 'unknown',
   };
 }
 
@@ -52,7 +52,12 @@ export function createVisualDomain(): DeviceState['visual'] {
     },
 
     async start(options) {
-      const s = visualEngine.startSession((options?.intent as any) || 'navigation');
+      const facing = options?.facing ?? 'back';
+      if (facing !== 'front' && facing !== 'back') {
+        // Refused, never quietly swapped for the other camera.
+        throw unsupported(`visual.start facing "${String(facing)}" — use "front" or "back"`);
+      }
+      const s = visualEngine.startSession((options?.intent as any) || 'navigation', facing);
       // Warm the compass alongside the camera. Started here rather than at app
       // launch: a magnetometer subscription running all day for a feature
       // nobody opened is exactly the kind of cost this layer is meant to avoid.

package/src/device-state/visualEngine.ts

@@ -117,6 +117,8 @@ export interface VisualSessionState {
   id: string;
   intent: VisualIntentName;
   startedAt: number;
+  /** The camera the session reads. The host opens THIS one. */
+  facing: 'front' | 'back';
   /** Set while the app is backgrounded. The session SURVIVES; the camera does not. */
   suspended: boolean;
 }
@@ -137,12 +139,23 @@ class VisualEngine {
 
   // ── session ──
 
-  startSession(intent: VisualIntentName): VisualSessionState {
-    if (this.session) return this.session;
+  startSession(intent: VisualIntentName, facing: 'front' | 'back' = 'back'): VisualSessionState {
+    if (this.session) {
+      if (this.session.facing === facing) return this.session;
+      // Same session, other camera. A NEW object, so a host holding the old one
+      // sees the change; the frames are dropped because they came from the
+      // other camera.
+      this.session = { ...this.session, facing };
+      this.frames = [];
+      this.cameraReady = false;
+      this.notify();
+      return this.session;
+    }
     this.session = {
       id: `visual_${Date.now()}`,
       intent: PROFILES[intent] ? intent : 'navigation',
       startedAt: Date.now(),
+      facing,
       suspended: false,
     };
     this.notify();

package/src/vision/index.ts

@@ -74,6 +74,8 @@ interface AdaVisionNative {
   isSupported(): boolean;
   assessQuality(uri: string): Promise<RawFrameQuality>;
   startVision(intervalMs: number): Promise<void>;
+  /** Absent from binaries built before the front camera existed. */
+  startVisionCamera?(intervalMs: number, facing: VisionFacing): Promise<void>;
   stopVision(): void;
   visionRetentionMs(): number;
   qualityById(id: string): RawFrameQuality | null;
@@ -85,6 +87,17 @@ interface AdaVisionNative {
 
 const native = requireOptionalNativeModule<AdaVisionNative>('AdaVision');
 
+/** The native function, or a refusal by name: Android's AdaVision has assessQuality only
+ *  (AI Models F4), so a verb it lacks says so instead of failing as "not a function". */
+function verb<K extends keyof AdaVisionNative>(name: K): AdaVisionNative[K] {
+  if (!native) throw new Error('ada-vision native module not present in this build');
+  const fn = native[name];
+  if (typeof fn !== 'function') {
+    throw Object.assign(new Error(`UNAVAILABLE: ada-vision ${String(name)} is not implemented on this platform (iOS only)`), { code: 'UNAVAILABLE' });
+  }
+  return (fn as Function).bind(native) as AdaVisionNative[K];
+}
+
 /** Is the native vision module present in this binary? */
 export function isSupported(): boolean {
   try { return native?.isSupported() ?? false; } catch { return false; }
@@ -98,10 +111,24 @@ export async function assessQuality(uri: string): Promise<RawFrameQuality> {
 
 // ── Vision session (feeds the Visual Engine) ──
 
-/** Start the vision session — publishes a timeline frame every `intervalMs`. */
-export async function startVision(intervalMs = 1000): Promise<void> {
-  if (!native) throw new Error('ada-vision native module not present in this build');
-  return native.startVision(intervalMs);
+/** Which camera the vision session reads. */
+export type VisionFacing = 'front' | 'back';
+
+/**
+ * Start the vision session on `facing` — publishes a timeline frame every
+ * `intervalMs`. The back camera works on every binary; the front camera needs a
+ * binary built with it, and an older one REFUSES it rather than quietly reading
+ * the back camera instead.
+ */
+export async function startVision(intervalMs = 1000, facing: VisionFacing = 'back'): Promise<void> {
+  if (facing !== 'front' && facing !== 'back') {
+    throw new Error(`Unknown camera "${String(facing)}" — use "front" or "back"`);
+  }
+  if (facing === 'back') return verb('startVision')(intervalMs);
+  if (native && typeof native.startVisionCamera !== 'function') {
+    throw new Error('the front camera needs a newer app build — this one can read the back camera only');
+  }
+  return verb('startVisionCamera')!(intervalMs, facing);
 }
 
 /** Stop the vision session and release the camera. */
@@ -127,20 +154,17 @@ export function qualityById(id: string): RawFrameQuality | null {
 
 /** On-device OCR on a published frame. [] = looked, no text; throws = couldn't look. */
 export async function readText(id: string, languages?: string[]): Promise<VisionText[]> {
-  if (!native) throw new Error('ada-vision native module not present in this build');
-  return native.readText(id, languages ?? null);
+  return verb('readText')(id, languages ?? null);
 }
 
 /** On-device image classification → labels (not prose). [] = nothing recognised. */
 export async function describe(id: string, maxLabels = 5): Promise<VisionLabel[]> {
-  if (!native) throw new Error('ada-vision native module not present in this build');
-  return native.describe(id, maxLabels);
+  return verb('describe')(id, maxLabels);
 }
 
 /** On-device object detection (bundled YOLOv8n, Open-Images vocabulary) → located
  *  items with boxes. [] = looked, found nothing above `minConfidence`; throws =
  *  couldn't look (id aged out, or the model isn't in this build). */
 export async function detectObjects(id: string, maxItems = 10, minConfidence = 0.25): Promise<VisionObject[]> {
-  if (!native) throw new Error('ada-vision native module not present in this build');
-  return native.detectObjects(id, maxItems, minConfidence);
+  return verb('detectObjects')(id, maxItems, minConfidence);
 }