@tapflowio/audiotap-helper 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 tapflow contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,24 @@
+# @tapflowio/audiotap-helper
+
+Shared macOS Core Audio process-tap helper for [tapflow](https://github.com/jo-duchan/tapflow).
+
+Taps a host process's audio by PID — no device routing, no dylib injection, no host-output hijack. Used internally by `@tapflowio/ios-agent` (iOS simulator audio capture) and `@tapflowio/android-agent` (Android emulator host-mute). Ships as a prebuilt, ad-hoc-signed `.app` so it holds its own one-time audio-recording (TCC) grant.
+
+## Requirements
+
+- macOS 14.2+ (Core Audio process taps)
+- Node.js ≥ 20
+
+## Usage
+
+Internal building block of tapflow — not intended for standalone use. The agents call it via the exported helpers:
+
+```ts
+import { ensureHelperApp, launchAudioHelper, launchMuteOnlyTap, isAudioSupported } from '@tapflowio/audiotap-helper'
+```
+
+See [contributing/simulator-audio.md](https://github.com/jo-duchan/tapflow/blob/main/contributing/simulator-audio.md) for the design.
+
+## License
+
+[MIT](LICENSE) — part of the [tapflow](https://github.com/jo-duchan/tapflow) project.

package/bin/.audiotap.entitlements

@@ -0,0 +1,5 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0"><dict>
+  <key>com.apple.security.device.audio-input</key><true/>
+</dict></plist>

package/bin/audiotap-helper.app/Contents/Info.plist

@@ -0,0 +1,13 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0"><dict>
+  <key>CFBundleExecutable</key><string>audiotap-helper</string>
+  <key>CFBundleIdentifier</key><string>io.tapflow.audiotap-helper</string>
+  <key>CFBundleName</key><string>audiotap-helper</string>
+  <key>CFBundlePackageType</key><string>APPL</string>
+  <key>CFBundleInfoDictionaryVersion</key><string>6.0</string>
+  <key>LSUIElement</key><true/>
+  <key>LSMinimumSystemVersion</key><string>14.2</string>
+  <key>NSAudioCaptureUsageDescription</key><string>tapflow taps the simulator/emulator audio to stream it to the browser.</string>
+  <key>NSMicrophoneUsageDescription</key><string>tapflow taps the simulator/emulator audio to stream it to the browser.</string>
+</dict></plist>

package/bin/audiotap-helper.app/Contents/_CodeSignature/CodeResources

@@ -0,0 +1,115 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+	<key>files</key>
+	<dict/>
+	<key>files2</key>
+	<dict/>
+	<key>rules</key>
+	<dict>
+		<key>^Resources/</key>
+		<true/>
+		<key>^Resources/.*\.lproj/</key>
+		<dict>
+			<key>optional</key>
+			<true/>
+			<key>weight</key>
+			<real>1000</real>
+		</dict>
+		<key>^Resources/.*\.lproj/locversion.plist$</key>
+		<dict>
+			<key>omit</key>
+			<true/>
+			<key>weight</key>
+			<real>1100</real>
+		</dict>
+		<key>^Resources/Base\.lproj/</key>
+		<dict>
+			<key>weight</key>
+			<real>1010</real>
+		</dict>
+		<key>^version.plist$</key>
+		<true/>
+	</dict>
+	<key>rules2</key>
+	<dict>
+		<key>.*\.dSYM($|/)</key>
+		<dict>
+			<key>weight</key>
+			<real>11</real>
+		</dict>
+		<key>^(.*/)?\.DS_Store$</key>
+		<dict>
+			<key>omit</key>
+			<true/>
+			<key>weight</key>
+			<real>2000</real>
+		</dict>
+		<key>^(Frameworks|SharedFrameworks|PlugIns|Plug-ins|XPCServices|Helpers|MacOS|Library/(Automator|Spotlight|LoginItems))/</key>
+		<dict>
+			<key>nested</key>
+			<true/>
+			<key>weight</key>
+			<real>10</real>
+		</dict>
+		<key>^.*</key>
+		<true/>
+		<key>^Info\.plist$</key>
+		<dict>
+			<key>omit</key>
+			<true/>
+			<key>weight</key>
+			<real>20</real>
+		</dict>
+		<key>^PkgInfo$</key>
+		<dict>
+			<key>omit</key>
+			<true/>
+			<key>weight</key>
+			<real>20</real>
+		</dict>
+		<key>^Resources/</key>
+		<dict>
+			<key>weight</key>
+			<real>20</real>
+		</dict>
+		<key>^Resources/.*\.lproj/</key>
+		<dict>
+			<key>optional</key>
+			<true/>
+			<key>weight</key>
+			<real>1000</real>
+		</dict>
+		<key>^Resources/.*\.lproj/locversion.plist$</key>
+		<dict>
+			<key>omit</key>
+			<true/>
+			<key>weight</key>
+			<real>1100</real>
+		</dict>
+		<key>^Resources/Base\.lproj/</key>
+		<dict>
+			<key>weight</key>
+			<real>1010</real>
+		</dict>
+		<key>^[^/]+$</key>
+		<dict>
+			<key>nested</key>
+			<true/>
+			<key>weight</key>
+			<real>10</real>
+		</dict>
+		<key>^embedded\.provisionprofile$</key>
+		<dict>
+			<key>weight</key>
+			<real>20</real>
+		</dict>
+		<key>^version\.plist$</key>
+		<dict>
+			<key>weight</key>
+			<real>20</real>
+		</dict>
+	</dict>
+</dict>
+</plist>

package/dist/index.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Build (mtime-gated) the audiotap-helper as a signed `.app` and return its path.
+ *
+ * WHY a `.app`, not a bare binary like the other helpers: a Core Audio process tap returns silence
+ * unless the *responsible process* holds the audio-recording TCC grant. A CLI child the agent spawns
+ * inherits the agent's (ungranted) responsibility. Launched via `open` (LaunchServices), the helper
+ * is its own responsible process with its own one-time grant — so it must be a bundle. Steady state
+ * (unchanged source) skips the rebuild/re-sign, so the grant persists (TCC keys on the cdhash).
+ */
+export declare function ensureHelperApp(): string;
+/**
+ * Launch the helper bundle via LaunchServices, pointed at the agent's loopback port and the simulator
+ * process PID(s) to tap (iOS capture). `-g` keeps it backgrounded (no focus steal). `-n` forces a NEW
+ * instance per simulator — without it `open -a` reuses the first sim's running helper, so a second
+ * concurrent sim never gets its own tap and its audio silently breaks. LaunchServices makes each its
+ * own TCC-responsible process; it connects back to `port` and streams PCM.
+ */
+export declare function launchAudioHelper(appPath: string, port: number, pids: number[]): void;
+/**
+ * Launch the helper in mute-only mode (Android host-mute symmetry, #341): it holds a `.muted` process
+ * tap on `pids` (the emulator/qemu process) to silence their host output, but captures/streams nothing
+ * — Android captures audio via gRPC. No port/socket. The helper self-exits once every target pid is
+ * gone (emulator stopped). `-n` forces a fresh instance so it never collides with the iOS capture helper.
+ */
+export declare function launchMuteOnlyTap(appPath: string, pids: number[]): void;
+export declare function isAudioSupported(): boolean;
+/**
+ * Prime the audio-capture TCC grant up front (from `tapflow setup ios` / `tapflow agent start`) so the
+ * operator approves it while present — not at first simulator boot, which a headless operator would miss.
+ *
+ * Runs the helper's --request-permission mode: a global tap whose *capture start* raises the same
+ * audio-capture prompt a per-pid tap needs (the grant keys on the app cdhash + service, not the tap
+ * shape), so no port/pid/booted simulator is required. The grant isn't readable back, so the caller
+ * treats a clean return as "prompt shown / answered" and leaves approve-vs-deny to the operator.
+ *
+ * `wait` (default true, for `tapflow setup ios`): `open -W` blocks until the modal is answered.
+ * `wait=false` (for `tapflow agent start`): fire-and-forget so agent startup isn't blocked — if the
+ * grant exists the helper exits silently, otherwise the modal pops for the operator to allow.
+ */
+export declare function requestAudioPermission(wait?: boolean): void;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AA4CA;;;;;;;;GAQG;AACH,wBAAgB,eAAe,IAAI,MAAM,CA6BxC;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,IAAI,CAGrF;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,IAAI,CAGvE;AAGD,wBAAgB,gBAAgB,IAAI,OAAO,CAG1C;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,UAAO,GAAG,IAAI,CASxD"}

package/dist/index.js

@@ -0,0 +1,131 @@
+// Shared macOS Core Audio process-tap helper utilities.
+//
+// The helper itself (audiotap-helper.swift) taps host processes by PID. tapflow uses it two ways:
+//   - iOS:     capture a simulator's audio and stream it to the browser (launchAudioHelper)
+//   - Android: mute the emulator (qemu) process's host output while gRPC does the capture (launchMuteOnlyTap)
+//
+// Both platforms share the same signed .app so they share one audio-capture TCC grant (keyed on the
+// app's cdhash). This package owns the bundle build, launch, and permission-priming; the per-platform
+// capture/stream logic lives in ios-agent / android-agent.
+import os from 'node:os';
+import { execFileSync } from 'node:child_process';
+import { existsSync, statSync, mkdirSync, writeFileSync, rmSync } from 'node:fs';
+import { join } from 'node:path';
+import { createLogger, PlatformError } from '@tapflowio/agent-core';
+const logger = createLogger('audiotap-helper');
+const HELPER_SRC = join(import.meta.dirname, '..', 'src', 'audiotap-helper.swift');
+const HELPER_APP = join(import.meta.dirname, '..', 'bin', 'audiotap-helper.app');
+const HELPER_BIN = join(HELPER_APP, 'Contents', 'MacOS', 'audiotap-helper');
+// LSUIElement → no Dock icon (background agent). NSAudioCaptureUsageDescription → the one-time TCC
+// "audio recording" prompt. LSMinimumSystemVersion 14.2 → Core Audio process taps.
+const INFO_PLIST = `<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0"><dict>
+  <key>CFBundleExecutable</key><string>audiotap-helper</string>
+  <key>CFBundleIdentifier</key><string>io.tapflow.audiotap-helper</string>
+  <key>CFBundleName</key><string>audiotap-helper</string>
+  <key>CFBundlePackageType</key><string>APPL</string>
+  <key>CFBundleInfoDictionaryVersion</key><string>6.0</string>
+  <key>LSUIElement</key><true/>
+  <key>LSMinimumSystemVersion</key><string>14.2</string>
+  <key>NSAudioCaptureUsageDescription</key><string>tapflow taps the simulator/emulator audio to stream it to the browser.</string>
+  <key>NSMicrophoneUsageDescription</key><string>tapflow taps the simulator/emulator audio to stream it to the browser.</string>
+</dict></plist>
+`;
+const ENTITLEMENTS = `<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0"><dict>
+  <key>com.apple.security.device.audio-input</key><true/>
+</dict></plist>
+`;
+/**
+ * Build (mtime-gated) the audiotap-helper as a signed `.app` and return its path.
+ *
+ * WHY a `.app`, not a bare binary like the other helpers: a Core Audio process tap returns silence
+ * unless the *responsible process* holds the audio-recording TCC grant. A CLI child the agent spawns
+ * inherits the agent's (ungranted) responsibility. Launched via `open` (LaunchServices), the helper
+ * is its own responsible process with its own one-time grant — so it must be a bundle. Steady state
+ * (unchanged source) skips the rebuild/re-sign, so the grant persists (TCC keys on the cdhash).
+ */
+export function ensureHelperApp() {
+    if (existsSync(HELPER_BIN)) {
+        if (!existsSync(HELPER_SRC))
+            return HELPER_APP; // source not shipped — trust the prebuilt bundle
+        if (statSync(HELPER_BIN).mtimeMs >= statSync(HELPER_SRC).mtimeMs)
+            return HELPER_APP;
+        logger.info('audiotap-helper source changed, rebuilding...');
+    }
+    if (!existsSync(HELPER_SRC)) {
+        throw new PlatformError('audiotap-helper.app missing and source not found — reinstall @tapflowio/audiotap-helper');
+    }
+    logger.info('building audiotap-helper.app...');
+    // Build + sign as a unit. If any step fails (e.g. swiftc OK but codesign fails), remove the bundle
+    // so a later call doesn't return a half-built/unsigned .app from the mtime gate above (an unsigned
+    // bundle silently fails the TCC grant). Next call rebuilds from scratch.
+    try {
+        mkdirSync(join(HELPER_APP, 'Contents', 'MacOS'), { recursive: true });
+        execFileSync('swiftc', [
+            HELPER_SRC, '-o', HELPER_BIN, '-framework', 'CoreAudio', '-framework', 'AudioToolbox',
+        ], { stdio: ['ignore', 'ignore', 'inherit'] });
+        writeFileSync(join(HELPER_APP, 'Contents', 'Info.plist'), INFO_PLIST);
+        const entPath = join(import.meta.dirname, '..', 'bin', '.audiotap.entitlements');
+        writeFileSync(entPath, ENTITLEMENTS);
+        execFileSync('codesign', ['--force', '--sign', '-', '--entitlements', entPath, HELPER_APP], { stdio: ['ignore', 'ignore', 'inherit'] });
+    }
+    catch (e) {
+        rmSync(HELPER_APP, { recursive: true, force: true });
+        throw e;
+    }
+    logger.info('built audiotap-helper.app');
+    return HELPER_APP;
+}
+/**
+ * Launch the helper bundle via LaunchServices, pointed at the agent's loopback port and the simulator
+ * process PID(s) to tap (iOS capture). `-g` keeps it backgrounded (no focus steal). `-n` forces a NEW
+ * instance per simulator — without it `open -a` reuses the first sim's running helper, so a second
+ * concurrent sim never gets its own tap and its audio silently breaks. LaunchServices makes each its
+ * own TCC-responsible process; it connects back to `port` and streams PCM.
+ */
+export function launchAudioHelper(appPath, port, pids) {
+    execFileSync('open', ['-g', '-n', '-a', appPath, '--args', String(port), ...pids.map(String)], { stdio: ['ignore', 'ignore', 'ignore'] });
+}
+/**
+ * Launch the helper in mute-only mode (Android host-mute symmetry, #341): it holds a `.muted` process
+ * tap on `pids` (the emulator/qemu process) to silence their host output, but captures/streams nothing
+ * — Android captures audio via gRPC. No port/socket. The helper self-exits once every target pid is
+ * gone (emulator stopped). `-n` forces a fresh instance so it never collides with the iOS capture helper.
+ */
+export function launchMuteOnlyTap(appPath, pids) {
+    execFileSync('open', ['-g', '-n', '-a', appPath, '--args', '--mute-only', ...pids.map(String)], { stdio: ['ignore', 'ignore', 'ignore'] });
+}
+// Core Audio process taps need macOS 14.2+ (Darwin 23.2+). os.release() → "<darwinMajor>.<minor>.…".
+export function isAudioSupported() {
+    const [maj, min] = os.release().split('.').map(Number);
+    return maj > 23 || (maj === 23 && min >= 2);
+}
+/**
+ * Prime the audio-capture TCC grant up front (from `tapflow setup ios` / `tapflow agent start`) so the
+ * operator approves it while present — not at first simulator boot, which a headless operator would miss.
+ *
+ * Runs the helper's --request-permission mode: a global tap whose *capture start* raises the same
+ * audio-capture prompt a per-pid tap needs (the grant keys on the app cdhash + service, not the tap
+ * shape), so no port/pid/booted simulator is required. The grant isn't readable back, so the caller
+ * treats a clean return as "prompt shown / answered" and leaves approve-vs-deny to the operator.
+ *
+ * `wait` (default true, for `tapflow setup ios`): `open -W` blocks until the modal is answered.
+ * `wait=false` (for `tapflow agent start`): fire-and-forget so agent startup isn't blocked — if the
+ * grant exists the helper exits silently, otherwise the modal pops for the operator to allow.
+ */
+export function requestAudioPermission(wait = true) {
+    try {
+        const app = ensureHelperApp();
+        const flags = wait ? ['-W', '-n'] : ['-g', '-n'];
+        execFileSync('open', [...flags, '-a', app, '--args', '--request-permission'], { stdio: ['ignore', 'ignore', 'ignore'] });
+    }
+    catch (e) {
+        if (wait)
+            throw e; // setup wants to surface it; agent-start priming is best-effort (never block startup)
+        logger.warn(`audio permission priming skipped: ${e instanceof Error ? e.message : String(e)}`);
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,61 @@
+{
+  "name": "@tapflowio/audiotap-helper",
+  "version": "0.1.0",
+  "description": "Shared macOS Core Audio process-tap helper for tapflow — iOS simulator audio capture and Android emulator host-mute",
+  "keywords": [
+    "tapflow",
+    "macos",
+    "core-audio",
+    "process-tap",
+    "audio",
+    "qa"
+  ],
+  "homepage": "https://github.com/jo-duchan/tapflow",
+  "bugs": "https://github.com/jo-duchan/tapflow/issues",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/jo-duchan/tapflow.git",
+    "directory": "packages/audiotap-helper"
+  },
+  "license": "MIT",
+  "author": "tapflow contributors",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "source": "./src/index.ts",
+      "tsx": "./src/index.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "bin",
+    "README.md",
+    "LICENSE"
+  ],
+  "engines": {
+    "node": ">=20.12.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "postinstall": "node -e \"if (process.platform === 'darwin') { try { require('fs').chmodSync('bin/audiotap-helper.app/Contents/MacOS/audiotap-helper', 0o755) } catch {} }\"",
+    "build": "tsc -b",
+    "typecheck": "tsc -b",
+    "test": "vitest run",
+    "lint": "eslint src"
+  },
+  "dependencies": {
+    "@tapflowio/agent-core": "workspace:*"
+  },
+  "devDependencies": {
+    "@types/node": "^20.19.43",
+    "typescript": "^5.0.0",
+    "vitest": "^4.1.9"
+  }
+}