@intentcomputing/koko-agent-sdk 1.0.1

package/lib/commonjs/native/NativeBridge.js

@@ -0,0 +1,132 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.NativeBridge = void 0;
+var _reactNative = require("react-native");
+var _pruneOffscreen = require("./pruneOffscreen.js");
+var _normalizeViewTree = require("./normalizeViewTree.js");
+const LINKING_ERROR = `KokoAgentSdk native module is not linked. ` + `Rebuild the host app after adding @intentcomputing/koko-agent-sdk ` + `(iOS: pod install; Android: gradle sync). Platform=${_reactNative.Platform.OS}`;
+const Native = _reactNative.NativeModules.KokoAgentSdk;
+function getNative() {
+  if (!Native) {
+    throw new Error(LINKING_ERROR);
+  }
+  return Native;
+}
+const NativeBridge = exports.NativeBridge = {
+  isAvailable() {
+    return !!Native;
+  },
+  /** iOS bundle identifier / Android applicationId. Empty when native module is missing. */
+  hostAppId() {
+    const raw = Native?.hostAppId;
+    return typeof raw === "string" ? raw.trim() : "";
+  },
+  async dump(options = {}) {
+    const raw = await getNative().dumpViewTree({
+      maxDepth: options.maxDepth ?? 60,
+      skipInvisible: options.skipInvisible ?? true
+    });
+    const root = (0, _normalizeViewTree.normalizeViewTree)(raw);
+    // Every consumer — ranking, selectors, the user gate — reads the tree from
+    // here, so offscreen nodes have to go before any of them see it.
+    return options.skipInvisible === false ? root : (0, _pruneOffscreen.pruneOffscreen)(root);
+  },
+  tap(point) {
+    return getNative().dispatchTap(point.x, point.y);
+  },
+  /** Public capability flags only; never requests account data. */
+  async inspectWebWalletProvider(point) {
+    const native = getNative();
+    if (typeof native.inspectWebWalletProvider !== 'function') return null;
+    return native.inspectWebWalletProvider(point.x, point.y);
+  },
+  swipe(from, to, durationMs) {
+    return getNative().dispatchSwipe(from.x, from.y, to.x, to.y, durationMs);
+  },
+  /**
+   * Two-finger pinch at center. scale>1 zoom in, scale<1 zoom out.
+   * Falls back to error if native build lacks dispatchPinch.
+   */
+  pinch(center, scale, durationMs) {
+    const n = getNative();
+    if (typeof n.dispatchPinch !== 'function') {
+      throw new Error('KokoAgentSdk: dispatchPinch unavailable — rebuild the host app with the latest native module');
+    }
+    return n.dispatchPinch(center.x, center.y, scale, durationMs);
+  },
+  /** Invoke a presented system alert action by button title. */
+  async invokeAlertAction(title) {
+    const n = getNative();
+    if (typeof n.invokeAlertAction !== 'function') return false;
+    await n.invokeAlertAction(title);
+    return true;
+  },
+  typeText(text, clear) {
+    return getNative().typeText(text, clear);
+  },
+  focusNode(nodeId) {
+    return getNative().focusNode(nodeId);
+  },
+  /** Ensure software keyboard / first responder at a screen point (TextInput). */
+  focusAt(point) {
+    return getNative().focusAt(point.x, point.y);
+  },
+  async dismissKeyboard() {
+    const n = getNative();
+    if (typeof n.dismissKeyboard === 'function') {
+      await n.dismissKeyboard();
+    }
+  },
+  async scrollIntoView(_point) {
+    // No-op: auto scroll-into-view before tap scrolled page-level ScrollViews
+    // (home / onboarding) and looked like a secret swipe. Callers that need
+    // scrolling must use an explicit swipe gesture instead.
+    return;
+  },
+  screenshot(options = {}) {
+    return getNative().captureScreenshot({
+      hideOverlays: options.hideOverlays ?? true
+    });
+  },
+  /**
+   * On-device screen OCR via Vision (iOS) or an opted-in ML Kit host (Android).
+   * Soft-fails to empty tokens when the native method is missing.
+   */
+  async recognizeScreenText(options = {}) {
+    const n = getNative();
+    if (typeof n.recognizeScreenText !== 'function') {
+      return {
+        tokens: [],
+        texts: [],
+        backend: 'unavailable'
+      };
+    }
+    const raw = await n.recognizeScreenText({
+      hideOverlays: options.hideOverlays ?? true,
+      maxTokens: options.maxTokens ?? 24,
+      languages: options.languages
+    });
+    return {
+      tokens: Array.isArray(raw?.tokens) ? raw.tokens.map(String) : [],
+      texts: Array.isArray(raw?.texts) ? raw.texts.map(t => {
+        const f = t?.frame;
+        const frame = f && [f.x, f.y, f.width, f.height].every(v => Number.isFinite(Number(v))) ? {
+          x: Number(f.x),
+          y: Number(f.y),
+          width: Number(f.width),
+          height: Number(f.height)
+        } : undefined;
+        return {
+          text: String(t?.text ?? ''),
+          confidence: Number(t?.confidence ?? 0),
+          frame
+        };
+      }) : [],
+      backend: String(raw?.backend || 'vision')
+    };
+  }
+};
+//# sourceMappingURL=NativeBridge.js.map

package/lib/commonjs/native/NativeBridge.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["_reactNative","require","_pruneOffscreen","_normalizeViewTree","LINKING_ERROR","Platform","OS","Native","NativeModules","KokoAgentSdk","getNative","Error","NativeBridge","exports","isAvailable","hostAppId","raw","trim","dump","options","dumpViewTree","maxDepth","skipInvisible","root","normalizeViewTree","pruneOffscreen","tap","point","dispatchTap","x","y","inspectWebWalletProvider","native","swipe","from","to","durationMs","dispatchSwipe","pinch","center","scale","n","dispatchPinch","invokeAlertAction","title","typeText","text","clear","focusNode","nodeId","focusAt","dismissKeyboard","scrollIntoView","_point","screenshot","captureScreenshot","hideOverlays","recognizeScreenText","tokens","texts","backend","maxTokens","languages","Array","isArray","map","String","t","f","frame","width","height","every","v","Number","isFinite","undefined","confidence"],"sourceRoot":"../../../src","sources":["native/NativeBridge.ts"],"mappings":"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","ignoreList":[]}

package/lib/commonjs/native/navigationLabel.js

@@ -0,0 +1,16 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.navigationLabel = navigationLabel;
+/** Explicit semantic navigation IDs, never inferred from icon position alone. */
+function navigationLabel(node) {
+  if ((node.text || '').trim() || (node.accessibilityLabel || '').trim()) return undefined;
+  if (!node.clickable || node.visible === false || node.enabled === false) return undefined;
+  const id = (node.testID || '').replace(/[^a-z]/gi, '').toLowerCase();
+  if (/^(?:nav(?:igation)?(?:header)?|header|toolbar)?(?:go)?back(?:button)?$|^buttonback$/.test(id)) return 'Back';
+  if (/^(?:nav(?:igation)?(?:header)?|header|toolbar)?close(?:button)?$|^buttonclose$/.test(id)) return 'Close';
+  return undefined;
+}
+//# sourceMappingURL=navigationLabel.js.map

package/lib/commonjs/native/navigationLabel.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["navigationLabel","node","text","trim","accessibilityLabel","undefined","clickable","visible","enabled","id","testID","replace","toLowerCase","test"],"sourceRoot":"../../../src","sources":["native/navigationLabel.ts"],"mappings":";;;;;;AAEA;AACO,SAASA,eAAeA,CAACC,IAAc,EAAsB;EAClE,IAAI,CAACA,IAAI,CAACC,IAAI,IAAI,EAAE,EAAEC,IAAI,CAAC,CAAC,IAAI,CAACF,IAAI,CAACG,kBAAkB,IAAI,EAAE,EAAED,IAAI,CAAC,CAAC,EAAE,OAAOE,SAAS;EACxF,IAAI,CAACJ,IAAI,CAACK,SAAS,IAAIL,IAAI,CAACM,OAAO,KAAK,KAAK,IAAIN,IAAI,CAACO,OAAO,KAAK,KAAK,EAAE,OAAOH,SAAS;EACzF,MAAMI,EAAE,GAAG,CAACR,IAAI,CAACS,MAAM,IAAI,EAAE,EAAEC,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAACC,WAAW,CAAC,CAAC;EACpE,IAAI,qFAAqF,CAACC,IAAI,CAACJ,EAAE,CAAC,EAAE,OAAO,MAAM;EACjH,IAAI,gFAAgF,CAACI,IAAI,CAACJ,EAAE,CAAC,EAAE,OAAO,OAAO;EAC7G,OAAOJ,SAAS;AAClB","ignoreList":[]}

package/lib/commonjs/native/normalizeViewTree.js

@@ -0,0 +1,28 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.normalizeViewTree = normalizeViewTree;
+var _navigationLabel = require("./navigationLabel.js");
+/** NSNumber boolean expressions can arrive as 0/1 through the RN bridge. */
+function normalizeViewTree(node) {
+  const children = node.children.map(normalizeViewTree);
+  const flags = {};
+  for (const key of ['scrollable', 'clipsChildren', 'visible', 'enabled', 'clickable', 'secure']) {
+    const value = node[key];
+    if (value === 0 || value === 1) flags[key] = value === 1;
+  }
+  const label = (0, _navigationLabel.navigationLabel)({
+    ...node,
+    ...flags
+  });
+  if (label) flags.accessibilityLabel = label;
+  if (!Object.keys(flags).length && children.every((child, i) => child === node.children[i])) return node;
+  return {
+    ...node,
+    ...flags,
+    children
+  };
+}
+//# sourceMappingURL=normalizeViewTree.js.map

package/lib/commonjs/native/normalizeViewTree.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["_navigationLabel","require","normalizeViewTree","node","children","map","flags","key","value","label","navigationLabel","accessibilityLabel","Object","keys","length","every","child","i"],"sourceRoot":"../../../src","sources":["native/normalizeViewTree.ts"],"mappings":";;;;;;AACA,IAAAA,gBAAA,GAAAC,OAAA;AAEA;AACO,SAASC,iBAAiBA,CAACC,IAAc,EAAY;EAC1D,MAAMC,QAAQ,GAAGD,IAAI,CAACC,QAAQ,CAACC,GAAG,CAACH,iBAAiB,CAAC;EACrD,MAAMI,KAAwB,GAAG,CAAC,CAAC;EACnC,KAAK,MAAMC,GAAG,IAAI,CAAC,YAAY,EAAE,eAAe,EAAE,SAAS,EAAE,SAAS,EAAE,WAAW,EAAE,QAAQ,CAAC,EAAW;IACvG,MAAMC,KAAc,GAAGL,IAAI,CAACI,GAAG,CAAC;IAChC,IAAIC,KAAK,KAAK,CAAC,IAAIA,KAAK,KAAK,CAAC,EAAEF,KAAK,CAACC,GAAG,CAAC,GAAGC,KAAK,KAAK,CAAC;EAC1D;EACA,MAAMC,KAAK,GAAG,IAAAC,gCAAe,EAAC;IAAE,GAAGP,IAAI;IAAE,GAAGG;EAAM,CAAC,CAAC;EACpD,IAAIG,KAAK,EAAEH,KAAK,CAACK,kBAAkB,GAAGF,KAAK;EAC3C,IAAI,CAACG,MAAM,CAACC,IAAI,CAACP,KAAK,CAAC,CAACQ,MAAM,IAAIV,QAAQ,CAACW,KAAK,CAAC,CAACC,KAAK,EAAEC,CAAC,KAAKD,KAAK,KAAKb,IAAI,CAACC,QAAQ,CAACa,CAAC,CAAC,CAAC,EAAE,OAAOd,IAAI;EACvG,OAAO;IAAE,GAAGA,IAAI;IAAE,GAAGG,KAAK;IAAEF;EAAS,CAAC;AACxC","ignoreList":[]}

package/lib/commonjs/native/pruneOffscreen.js

@@ -0,0 +1,76 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.pruneOffscreen = pruneOffscreen;
+/**
+ * Drop nodes that are mounted but nowhere on screen.
+ *
+ * Both platforms report a node as visible from its own flags alone — Android
+ * `VISIBLE && isShown()`, iOS `!hidden && alpha > 0`. Neither asks whether the
+ * node is inside the window, so a navigator screen that is still mounted but
+ * pushed aside keeps showing up in every dump. The agent then plans against a
+ * screen the user cannot see, and the user gate can stall a run on a prompt
+ * that is not there.
+ *
+ * Intersect against the window and every clipping/scroll ancestor. A mounted
+ * list row outside its scroll viewport must not become a clickable target.
+ */
+
+/** Rounding slack, in points: a node flush with the edge must survive. */
+const EPSILON = 0.5;
+function intersects(a, b) {
+  return a.x < b.x + b.width - EPSILON && a.x + a.width > b.x + EPSILON && a.y < b.y + b.height - EPSILON && a.y + a.height > b.y + EPSILON;
+}
+function clippedFrame(a, b) {
+  if (!intersects(a, b)) return null;
+  const x = Math.max(a.x, b.x);
+  const y = Math.max(a.y, b.y);
+  return {
+    x,
+    y,
+    width: Math.min(a.x + a.width, b.x + b.width) - x,
+    height: Math.min(a.y + a.height, b.y + b.height) - y
+  };
+}
+function prune(node, window) {
+  if (node.visible === false) return null;
+  const clip = node.clipsChildren === true || /scrollview|recyclerview|listview/i.test(node.type);
+  const childWindow = clip ? clippedFrame(node.frame, window) : window;
+  const children = [];
+  for (const child of childWindow ? node.children : []) {
+    const kept = prune(child, childWindow);
+    if (kept) children.push(kept);
+  }
+  // A container can sit outside the window while laying children back inside
+  // it (carousels, drawers), so keep any ancestor that still leads somewhere
+  // on screen.
+  if (children.length === 0 && !intersects(node.frame, window)) return null;
+  const onScreen = intersects(node.frame, window);
+  const centerVisible = onScreen && node.frame.x + node.frame.width / 2 >= window.x && node.frame.x + node.frame.width / 2 <= window.x + window.width && node.frame.y + node.frame.height / 2 >= window.y && node.frame.y + node.frame.height / 2 <= window.y + window.height;
+  if (!children.length && !centerVisible) return null;
+  const changed = children.length !== node.children.length || children.some((c, i) => c !== node.children[i]);
+  if (!changed && centerVisible) return node;
+  // Native containers aggregate all descendant labels before clipping. Never
+  // retain a hidden row's text on an otherwise visible ancestor.
+  // A structural ancestor can be larger than the viewport while containing
+  // visible children. Keep it traversable but not actionable or labelled.
+  return {
+    ...node,
+    children,
+    visible: centerVisible || children.length > 0,
+    clickable: node.clickable && centerVisible,
+    ...(!centerVisible || changed && node.children.length ? {
+      text: centerVisible && node.text ? children.map(c => c.text || c.accessibilityLabel || '').filter(Boolean).join(' ').slice(0, 240) || undefined : undefined,
+      accessibilityLabel: undefined
+    } : {})
+  };
+}
+function pruneOffscreen(root) {
+  return prune(root, root.frame) ?? {
+    ...root,
+    children: []
+  };
+}
+//# sourceMappingURL=pruneOffscreen.js.map

package/lib/commonjs/native/pruneOffscreen.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["EPSILON","intersects","a","b","x","width","y","height","clippedFrame","Math","max","min","prune","node","window","visible","clip","clipsChildren","test","type","childWindow","frame","children","child","kept","push","length","onScreen","centerVisible","changed","some","c","i","clickable","text","map","accessibilityLabel","filter","Boolean","join","slice","undefined","pruneOffscreen","root"],"sourceRoot":"../../../src","sources":["native/pruneOffscreen.ts"],"mappings":"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","ignoreList":[]}

package/lib/commonjs/native/scrollViewport.js

@@ -0,0 +1,69 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.boundedScrollGesture = boundedScrollGesture;
+exports.scrollPosition = scrollPosition;
+exports.scrollViewports = scrollViewports;
+function intersect(a, b) {
+  const x = Math.max(a.x, b.x),
+    y = Math.max(a.y, b.y);
+  const width = Math.min(a.x + a.width, b.x + b.width) - x;
+  const height = Math.min(a.y + a.height, b.y + b.height) - y;
+  return width > 0 && height > 0 ? {
+    x,
+    y,
+    width,
+    height
+  } : null;
+}
+
+/** Visible scroll regions, clipped by the window and every clipping ancestor. */
+function scrollViewports(root) {
+  const out = [];
+  const walk = (node, clip) => {
+    const frame = intersect(node.frame, clip);
+    if (node.scrollable === true && node.visible !== false && frame) out.push({
+      node,
+      frame
+    });
+    const clips = node.clipsChildren || /scrollview|recyclerview|listview/i.test(node.type);
+    const childClip = clips ? frame : clip;
+    if (childClip) for (const child of node.children) walk(child, childClip);
+  };
+  walk(root, root.frame);
+  return out;
+}
+function boundedScrollGesture(frame, from, to) {
+  const insetX = Math.min(12, frame.width / 4),
+    insetY = Math.min(12, frame.height / 4);
+  const clamp = p => ({
+    x: Math.max(frame.x + insetX, Math.min(frame.x + frame.width - insetX, p.x)),
+    y: Math.max(frame.y + insetY, Math.min(frame.y + frame.height - insetY, p.y))
+  });
+  return {
+    from: clamp(from),
+    to: clamp(to)
+  };
+}
+
+/** Position-only evidence: changing prices must not masquerade as scrolling. */
+function scrollPosition(root, from) {
+  const viewport = scrollViewports(root).filter(({
+    frame: f
+  }) => from.x >= f.x && from.x <= f.x + f.width && from.y >= f.y && from.y <= f.y + f.height).sort((a, b) => a.frame.width * a.frame.height - b.frame.width * b.frame.height)[0];
+  if (!viewport) return null;
+  const positions = [];
+  const walk = n => {
+    if (n.visible === false) return;
+    if (!n.children.length || n.clickable) positions.push(`${n.id}:${Math.round(n.frame.x)},${Math.round(n.frame.y)}`);
+    for (const child of n.children) walk(child);
+  };
+  walk(viewport.node);
+  // Only the hash leaves this local comparison; labels/values are never used.
+  let hash = 2166136261;
+  for (const c of positions.join('|')) hash = Math.imul(hash ^ c.charCodeAt(0), 16777619);
+  return (hash >>> 0).toString(16);
+}
+//# sourceMappingURL=scrollViewport.js.map

package/lib/commonjs/native/scrollViewport.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["intersect","a","b","x","Math","max","y","width","min","height","scrollViewports","root","out","walk","node","clip","frame","scrollable","visible","push","clips","clipsChildren","test","type","childClip","child","children","boundedScrollGesture","from","to","insetX","insetY","clamp","p","scrollPosition","viewport","filter","f","sort","positions","n","length","clickable","id","round","hash","c","join","imul","charCodeAt","toString"],"sourceRoot":"../../../src","sources":["native/scrollViewport.ts"],"mappings":"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","ignoreList":[]}

package/lib/commonjs/package.json

@@ -0,0 +1 @@
+{"type":"commonjs"}

package/lib/commonjs/privacy/redact.js

@@ -0,0 +1,108 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.redactOutbound = redactOutbound;
+exports.redactViewTreeClient = redactViewTreeClient;
+exports.viewTreeOutline = viewTreeOutline;
+var _sensitiveScreen = require("./sensitiveScreen.js");
+/**
+ * Client-side redaction before upload (defense in depth; server also redacts).
+ */
+
+function redactViewTreeClient(node, maxDepth = 80) {
+  if ((0, _sensitiveScreen.sensitiveScreenKind)(node)) {
+    return {
+      ...nodeFields(node),
+      text: '[private screen]',
+      children: []
+    };
+  }
+  return walk(node, 0, maxDepth);
+}
+
+/** Applies to every outbound field, including OCR/model/history and test IDs. */
+function redactOutbound(value, tree) {
+  const secrets = new Set();
+  const collect = n => {
+    if (n.secure) {
+      for (const v of [n.text, n.accessibilityLabel]) {
+        if (v && !/^[•●*\s]+$/.test(v)) secrets.add(v);
+      }
+    }
+    for (const child of n.children || []) collect(child);
+  };
+  for (const source of Array.isArray(tree) ? tree : [tree]) {
+    if (source) collect(source);
+  }
+  const visit = v => {
+    if (typeof v === 'string') {
+      let out = v;
+      for (const secret of secrets) out = out.split(secret).join('[redacted]');
+      return out.replace(/\b(?:0x)?[a-fA-F0-9]{64}\b/g, '[redacted]').replace(/\b[5KL][1-9A-HJ-NP-Za-km-z]{50,51}\b/g, '[redacted]').replace(/((?:password|passcode|密码|私钥|private\s*key)\s*[:=：]\s*)[^\s,;"}]+/gi, '$1[redacted]');
+    }
+    if (Array.isArray(v)) return v.map(visit);
+    if (v && typeof v === 'object') return Object.fromEntries(Object.entries(v).map(([k, x]) => [k, visit(x)]));
+    return v;
+  };
+  return visit(value);
+}
+function scrub(text) {
+  if (!text) return undefined;
+  const t = text.replace(/\s+/g, ' ').trim();
+  if (!t) return undefined;
+  // A feature label is not its private value. Keep public navigation copy and
+  // addresses usable; value formats and assignments are scrubbed separately.
+  const safe = redactOutbound(t);
+  return safe.length > 80 ? `${safe.slice(0, 80)}…` : safe;
+}
+function walk(node, depth, maxDepth) {
+  return {
+    ...nodeFields(node),
+    text: node.secure ? '[redacted]' : scrub(node.text),
+    accessibilityLabel: node.secure ? '[redacted]' : scrub(node.accessibilityLabel),
+    testID: node.secure ? undefined : scrub(node.testID),
+    children: depth >= maxDepth ? [] : node.children.slice(0, 40).map(c => walk(c, depth + 1, maxDepth))
+  };
+}
+
+/** Runtime trees cross a JS boundary: TypeScript types do not filter fields. */
+function nodeFields(node) {
+  const finite = value => typeof value === 'number' && Number.isFinite(value) ? value : undefined;
+  const out = {
+    id: typeof node.id === 'string' ? node.id : '',
+    type: typeof node.type === 'string' ? node.type : 'View',
+    frame: {
+      x: finite(node.frame?.x) ?? 0,
+      y: finite(node.frame?.y) ?? 0,
+      width: finite(node.frame?.width) ?? 0,
+      height: finite(node.frame?.height) ?? 0
+    },
+    clickable: node.clickable === true,
+    enabled: node.enabled !== false,
+    visible: node.visible !== false
+  };
+  for (const key of ['secure', 'selected', 'sheet', 'toggle', 'on', 'adjustable', 'scrollable', 'clipsChildren']) {
+    if (typeof node[key] === 'boolean') out[key] = node[key];
+  }
+  for (const key of ['value', 'min', 'max']) {
+    const value = finite(node[key]);
+    if (value !== undefined) out[key] = value;
+  }
+  return out;
+}
+function viewTreeOutline(node, maxLines = 120) {
+  if ((0, _sensitiveScreen.sensitiveScreenKind)(node)) return '[private screen — user completes locally]';
+  const lines = [];
+  const go = (n, indent) => {
+    if (lines.length >= maxLines) return;
+    const bits = [n.clickable ? 'tap' : null, n.text ? `"${n.text}"` : null, n.accessibilityLabel && n.accessibilityLabel !== n.text ? `a11y="${n.accessibilityLabel}"` : null, n.testID ? `id=${n.testID}` : null].filter(Boolean).join(' ');
+    lines.push(`${'  '.repeat(indent)}${n.id} ${n.type} ${bits}`.trimEnd());
+    for (const c of n.children) go(c, indent + 1);
+  };
+  go(node, 0);
+  if (lines.length >= maxLines) lines.push('…(truncated)');
+  return lines.join('\n');
+}
+//# sourceMappingURL=redact.js.map

package/lib/commonjs/privacy/redact.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["_sensitiveScreen","require","redactViewTreeClient","node","maxDepth","sensitiveScreenKind","nodeFields","text","children","walk","redactOutbound","value","tree","secrets","Set","collect","n","secure","v","accessibilityLabel","test","add","child","source","Array","isArray","visit","out","secret","split","join","replace","map","Object","fromEntries","entries","k","x","scrub","undefined","t","trim","safe","length","slice","depth","testID","c","finite","Number","isFinite","id","type","frame","y","width","height","clickable","enabled","visible","key","viewTreeOutline","maxLines","lines","go","indent","bits","filter","Boolean","push","repeat","trimEnd"],"sourceRoot":"../../../src","sources":["privacy/redact.ts"],"mappings":"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","ignoreList":[]}

package/lib/commonjs/privacy/screenEvidence.js

@@ -0,0 +1,59 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.PRIVATE_INPUT_PROMPT_RE = void 0;
+exports.isPrivateInput = isPrivateInput;
+exports.isSdkChrome = isSdkChrome;
+exports.isSystemSheet = isSystemSheet;
+exports.nodeLabels = nodeLabels;
+exports.staticScreenLabels = staticScreenLabels;
+/** Shared by local gates and the final upload boundary; never inspect values. */
+const PRIVATE_INPUT_PROMPT_RE = exports.PRIVATE_INPUT_PROMPT_RE = /^(?:(?:请)?(?:输入|设置|确认|创建|验证|解锁|重置|更改|修改)(?:您?的|新|旧|登录|支付|交易|钱包|安全|数字|\d+位|\s)*(?:密码|安全码|验证码)|(?:登录|支付|交易|钱包)?密码|安全码|验证码|短信验证|(?:please\s+)?(?:enter|set|confirm|create|verify|unlock|reset|change)\s+(?:(?:your|new|old|wallet|payment|login|\d+[- ]digit)\s+)*(?:password|passcode|pin|otp|security\s+code|verification\s+code)|password|passcode|pin|otp|cvv)\s*[:：?？!！]?$/i;
+function isPrivateInput(node) {
+  if (node.secure) return true;
+  if (!/securetext|password|textfield|textinput|edittext|textview|textarea/i.test(node.type)) return false;
+  const metadata = `${node.testID || ''} ${node.accessibilityLabel || ''} ${node.type}`;
+  return /password|passwd|pass[-_\s]?code|\bpin\b|\botp\b|\bcvv\b|verification[-_\s]*code|security[-_\s]*code|密码|验证码|安全码/i.test(metadata) || typeof node.text === 'string' && PRIVATE_INPUT_PROMPT_RE.test(node.text.trim());
+}
+
+/** Text spoken by a node; test IDs are metadata, never user-facing copy. */
+function nodeLabels(node) {
+  return [...new Set([node.text, node.accessibilityLabel].filter(text => typeof text === 'string' && !!text.trim()).map(text => text.replace(/\s+/g, ' ').trim()))];
+}
+function isSdkChrome(node) {
+  return /^koko-agent-(?:overlay|cursor|entry)(?:$|[/:-])/i.test(node.testID || '');
+}
+function isSystemSheet(node) {
+  return node.sheet === true || /uialertcontroller|alertdialog|biometricprompt/i.test(node.type);
+}
+
+/** A full-screen Pressable used to dismiss the keyboard is not an action row. */
+function isActionRow(node, root) {
+  if (!node.clickable && !node.toggle && !node.adjustable) return false;
+  if (/button|menuitem|tabbaritem|navigationitem/i.test(node.type)) return true;
+  if (node === root || node.frame.height >= root.frame.height / 2) return false;
+  const hasIndependentAction = n => n.children.some(child => child.clickable || child.toggle || child.adjustable || hasIndependentAction(child));
+  return !hasIndependentAction(node);
+}
+
+/** Static own copy, excluding aggregated ancestors and offered menu actions. */
+function staticScreenLabels(root) {
+  const out = [];
+  const hasCopy = n => n.visible !== false && !isSdkChrome(n) && (!!nodeLabels(n).length || n.children.some(hasCopy));
+  const visit = (node, inAction) => {
+    if (isSdkChrome(node)) return;
+    const action = inAction || isActionRow(node, root);
+    if (node.visible !== false && !action && !node.children.some(hasCopy)) {
+      for (const label of nodeLabels(node)) out.push({
+        node,
+        label
+      });
+    }
+    for (const child of node.children) visit(child, action);
+  };
+  visit(root, false);
+  return out;
+}
+//# sourceMappingURL=screenEvidence.js.map

package/lib/commonjs/privacy/screenEvidence.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["PRIVATE_INPUT_PROMPT_RE","exports","isPrivateInput","node","secure","test","type","metadata","testID","accessibilityLabel","text","trim","nodeLabels","Set","filter","map","replace","isSdkChrome","isSystemSheet","sheet","isActionRow","root","clickable","toggle","adjustable","frame","height","hasIndependentAction","n","children","some","child","staticScreenLabels","out","hasCopy","visible","length","visit","inAction","action","label","push"],"sourceRoot":"../../../src","sources":["privacy/screenEvidence.ts"],"mappings":"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","ignoreList":[]}