@tantawowa/hosanna-tools 3.10.0 → 3.10.2

package/README.md

@@ -3,6 +3,7 @@
 ## Documentation
 
 - **[MCP debugger](src/support-tools/mcp-server/README.md)** — `hst mcp:start`, debugger tools, commands by use case, examples, and RASP certification capture.
+- **[Video capture](docs/video-capture.md)** — standalone, agent-driven, and test-run recording for Apple simulators, Roku capture cards, and macOS windows.
 - **[docs/README.md](docs/README.md)** — index of docs in this repo (MCP + source-map note).
 - **hosanna-ui** (separate repo): `docs/README.md` for agentic debugging and links back to this README.
 
@@ -64,7 +65,7 @@ symlink. Granular flavours and platform subsets are deliberately rejected with
 Hosanna Tools can also be imported by app build chains. The CLI remains available as `hst`, but package imports are library-safe and do not parse CLI arguments or call `process.exit` during import. Public wrappers for process-oriented commands use no-exit mode where supported, so API callers receive structured results or thrown errors instead of forced process termination.
 
 ```ts
-import { buildConfig, compiler, env, generate, roku, secrets } from '@tantawowa/hosanna-tools';
+import { buildConfig, capture, compiler, env, generate, roku, secrets } from '@tantawowa/hosanna-tools';
 
 await generate.all({
   rootFolder: './src',
@@ -80,6 +81,10 @@ await buildConfig.resolve({
 
 await compiler.install({ version: '0.33.7' });
 await roku.package({ env: 'prod', prebuild: 'npm run roku:build:prod' });
+
+const recording = await capture.start({ platform: 'ios', device: 'iPhone 17 Pro' });
+// Drive the app manually, through MCP, or through another automation API.
+await recording.stop();
 ```
 
 Common build-script replacements:
@@ -91,6 +96,7 @@ Common build-script replacements:
 | `npx hst build-config:resolve --env dev --platform roku --out assets/meta/build-config.json` | `await buildConfig.resolve({ env: 'dev', platform: 'roku', out: 'assets/meta/build-config.json' })` |
 | `npx hst compiler:install 0.33.7` | `await compiler.install({ version: '0.33.7' })` |
 | `npx hst roku:package --env prod --prebuild 'npm run roku:build:prod'` | `await roku.package({ env: 'prod', prebuild: 'npm run roku:build:prod' })` |
+| `npx hst capture ios --device 'iPhone 17 Pro'` | `await capture.start({ platform: 'ios', device: 'iPhone 17 Pro' })` |
 | `npx hst secrets:check` | `await secrets.check({ cwd: process.cwd() })` |
 | `npx hst env check` | `await env.check({ cwd: process.cwd() })` |
 
@@ -190,6 +196,7 @@ The CLI commands are organized into logical groups using colon-separated namespa
 
 ### Development Commands
 - `run` - Canonical cross-platform app launcher. Bare interactive runs show one destination picker; explicit platform options support web, Roku, iOS, Apple TV, Android, and Android TV launch targets.
+- `capture` - Record an Apple simulator, Roku capture-card input, or macOS screen/window. The default timeout is 180 seconds; use `--timeout` to override it.
 - `target:list` - List launch targets for humans or agents, including web emulators, sims, and physical devices.
 - `dev:start` - Run dev processes: vite, generator watch, and optional debugger
 - `debugger:start` - Start the command debugger WebSocket proxy (only one debugger is needed for multiple apps; if the port is already in use, a friendly message is shown instead of crashing)
@@ -392,21 +399,25 @@ Applications own regular Vitest suites. Global setup comes from `@tantawowa/hosa
 
 Add `createHosannaReporter(config)` from `@tantawowa/hosanna-tools/testing/vitest/reporter` to the application's Vitest reporters. Every run then writes a self-contained JSON and HTML report under `test-results/<testRunId>/`, updates `test-results/latest.json` and `test-results/latest.html`, and includes every Vitest result plus any named visual proofs captured by the tests.
 
-Browser targets can also record the complete owned browser session as WebM:
+Tests can record the complete owned browser, supported Apple simulator, or
+Roku device run:
 
 ```ts
 defineHosannaTestConfig({
   // ...
   video: true,
-  // Or: video: { size: { width: 1280, height: 720 } },
+  // Browser: video: { size: { width: 1280, height: 720 } },
+  // Native/device: video: { timeoutSeconds: 300, videoDevice: 'USB Video' },
 });
 ```
 
-The finalized recording is written to
-`test-results/<testRunId>/<platform>-web/run.webm` and embedded in the HTML
-report. Recording is opt-in in the shared tools and ignored for device and
-simulator targets. It records browser video only, without audio. This is a
-review artifact, not a replay format or executable test source.
+The finalized recording is written below
+`test-results/<testRunId>/<platform>-<target>/` and embedded in the HTML report.
+Browser targets use Playwright WebM. iOS/Apple TV simulators use `simctl` MP4.
+Physical Roku targets use AVFoundation or a configured macOS screen/window
+source. Native/device capture defaults to 180 seconds; override it with
+`timeoutSeconds`. This is a review artifact, not a replay format or executable
+test source.
 
 ```ts
 import { defineConfig } from 'vitest/config';

package/dist/build-info.json

@@ -1,6 +1,6 @@
 {
-  "buildDate": "2026-07-17T08:17:53+00:00",
-  "buildDateISO": "2026-07-17T08:17:53.381Z",
+  "buildDate": "2026-07-18T16:38:55+00:00",
+  "buildDateISO": "2026-07-18T16:38:55.954Z",
   "timeZone": "UTC",
-  "gitHash": "10849ea"
+  "gitHash": "7387408"
 }

package/dist/capture/index.d.ts

@@ -0,0 +1,2 @@
+export { DEFAULT_VIDEO_CAPTURE_TIMEOUT_SECONDS, VideoCaptureManager, VideoCaptureSession, defaultCaptureOutputPath, listAvFoundationDevices, parseAvFoundationDevices, resolveMacWindowId, resolveVideoCapturePlan, resolveVideoCaptureSource, startVideoCapture, videoCaptureManager, } from './video-capture.js';
+export type { AvFoundationDeviceList, ResolvedVideoCapturePlan, StartVideoCaptureOptions, VideoCaptureDependencies, VideoCaptureMarker, VideoCapturePlatform, VideoCaptureRect, VideoCaptureResult, VideoCaptureSource, VideoCaptureState, VideoCaptureStatus, VideoCaptureStopReason, } from './video-capture.js';

package/dist/capture/index.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.videoCaptureManager = exports.startVideoCapture = exports.resolveVideoCaptureSource = exports.resolveVideoCapturePlan = exports.resolveMacWindowId = exports.parseAvFoundationDevices = exports.listAvFoundationDevices = exports.defaultCaptureOutputPath = exports.VideoCaptureSession = exports.VideoCaptureManager = exports.DEFAULT_VIDEO_CAPTURE_TIMEOUT_SECONDS = void 0;
+var video_capture_js_1 = require("./video-capture.js");
+Object.defineProperty(exports, "DEFAULT_VIDEO_CAPTURE_TIMEOUT_SECONDS", { enumerable: true, get: function () { return video_capture_js_1.DEFAULT_VIDEO_CAPTURE_TIMEOUT_SECONDS; } });
+Object.defineProperty(exports, "VideoCaptureManager", { enumerable: true, get: function () { return video_capture_js_1.VideoCaptureManager; } });
+Object.defineProperty(exports, "VideoCaptureSession", { enumerable: true, get: function () { return video_capture_js_1.VideoCaptureSession; } });
+Object.defineProperty(exports, "defaultCaptureOutputPath", { enumerable: true, get: function () { return video_capture_js_1.defaultCaptureOutputPath; } });
+Object.defineProperty(exports, "listAvFoundationDevices", { enumerable: true, get: function () { return video_capture_js_1.listAvFoundationDevices; } });
+Object.defineProperty(exports, "parseAvFoundationDevices", { enumerable: true, get: function () { return video_capture_js_1.parseAvFoundationDevices; } });
+Object.defineProperty(exports, "resolveMacWindowId", { enumerable: true, get: function () { return video_capture_js_1.resolveMacWindowId; } });
+Object.defineProperty(exports, "resolveVideoCapturePlan", { enumerable: true, get: function () { return video_capture_js_1.resolveVideoCapturePlan; } });
+Object.defineProperty(exports, "resolveVideoCaptureSource", { enumerable: true, get: function () { return video_capture_js_1.resolveVideoCaptureSource; } });
+Object.defineProperty(exports, "startVideoCapture", { enumerable: true, get: function () { return video_capture_js_1.startVideoCapture; } });
+Object.defineProperty(exports, "videoCaptureManager", { enumerable: true, get: function () { return video_capture_js_1.videoCaptureManager; } });
+//# sourceMappingURL=index.js.map

package/dist/capture/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/capture/index.ts"],"names":[],"mappings":";;;AAAA,uDAY4B;AAX1B,yIAAA,qCAAqC,OAAA;AACrC,uHAAA,mBAAmB,OAAA;AACnB,uHAAA,mBAAmB,OAAA;AACnB,4HAAA,wBAAwB,OAAA;AACxB,2HAAA,uBAAuB,OAAA;AACvB,4HAAA,wBAAwB,OAAA;AACxB,sHAAA,kBAAkB,OAAA;AAClB,2HAAA,uBAAuB,OAAA;AACvB,6HAAA,yBAAyB,OAAA;AACzB,qHAAA,iBAAiB,OAAA;AACjB,uHAAA,mBAAmB,OAAA"}

package/dist/capture/mcp-tools.d.ts

@@ -0,0 +1,6 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { type VideoCaptureManager } from './video-capture.js';
+export declare function registerVideoCaptureTools(server: McpServer, options?: {
+    cwd?: string;
+    manager?: VideoCaptureManager;
+}): void;

package/dist/capture/mcp-tools.js

@@ -0,0 +1,106 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerVideoCaptureTools = registerVideoCaptureTools;
+const node_path_1 = __importDefault(require("node:path"));
+const zod_1 = require("zod");
+const video_capture_js_1 = require("./video-capture.js");
+function registerVideoCaptureTools(server, options = {}) {
+    var _a, _b;
+    const cwd = node_path_1.default.resolve((_a = options.cwd) !== null && _a !== void 0 ? _a : process.cwd());
+    const manager = (_b = options.manager) !== null && _b !== void 0 ? _b : video_capture_js_1.videoCaptureManager;
+    server.tool('start_video_capture', `Start an independent video capture session for an agent-driven scenario, manual demonstration, or test.
+
+The capture stops and finalizes automatically after ${video_capture_js_1.DEFAULT_VIDEO_CAPTURE_TIMEOUT_SECONDS} seconds by default. Override timeoutSeconds for a shorter or longer recording. Only one capture can be active in this MCP process at a time.`, {
+        platform: zod_1.z.enum(['ios', 'apple-tv', 'roku', 'macos']).describe('Platform being recorded'),
+        source: zod_1.z.enum(['apple-simulator', 'avfoundation', 'macos-screen', 'macos-window']).optional()
+            .describe('Capture source. Defaults from platform and supplied window/screen options.'),
+        outputPath: zod_1.z.string().optional().describe('Output video path, relative to the project when not absolute'),
+        timeoutSeconds: zod_1.z.number().int().positive().optional()
+            .describe(`Automatic stop timeout in seconds. Defaults to ${video_capture_js_1.DEFAULT_VIDEO_CAPTURE_TIMEOUT_SECONDS}.`),
+        device: zod_1.z.string().optional().describe('Booted Apple simulator name or UDID'),
+        codec: zod_1.z.enum(['h264', 'hevc']).optional().describe('Apple simulator video codec'),
+        videoDevice: zod_1.z.string().optional().describe('AVFoundation video device name or index'),
+        audioDevice: zod_1.z.string().optional().describe('Optional AVFoundation audio device name or index'),
+        frameRate: zod_1.z.number().int().positive().optional().describe('AVFoundation frame rate. Defaults to 30.'),
+        videoBitrate: zod_1.z.string().optional().describe('ffmpeg video bitrate. Defaults to 12M.'),
+        display: zod_1.z.number().int().positive().optional().describe('macOS display number. Defaults to 1.'),
+        windowId: zod_1.z.number().int().positive().optional().describe('macOS CoreGraphics window ID'),
+        application: zod_1.z.string().optional().describe('macOS application name used to resolve a window, for example QuickTime Player'),
+        windowTitle: zod_1.z.string().optional().describe('Optional title substring used to select an application window'),
+        rect: zod_1.z.object({
+            x: zod_1.z.number().int(),
+            y: zod_1.z.number().int(),
+            width: zod_1.z.number().int().positive(),
+            height: zod_1.z.number().int().positive(),
+        }).optional().describe('Optional macOS screen rectangle'),
+        showCursor: zod_1.z.boolean().optional().describe('Include the pointer in macOS screen/window capture'),
+        showClicks: zod_1.z.boolean().optional().describe('Show clicks in macOS screen/window capture'),
+    }, async (input) => {
+        try {
+            const session = await manager.start(Object.assign(Object.assign({}, input), { cwd }));
+            return captureToolResult({
+                status: 'recording',
+                capture: session.status(),
+                next: 'Drive the scenario, add markers at meaningful checkpoints, then call stop_video_capture.',
+            });
+        }
+        catch (error) {
+            return captureToolError(error);
+        }
+    });
+    server.tool('get_video_capture_status', 'Get one video capture session, or list recent sessions when sessionId is omitted.', {
+        sessionId: zod_1.z.string().optional().describe('Capture session ID. Omit to list active and recent sessions.'),
+    }, async ({ sessionId }) => {
+        try {
+            if (!sessionId) {
+                return captureToolResult({ captures: manager.list() });
+            }
+            const session = manager.get(sessionId);
+            if (!session)
+                throw new Error(`Unknown video capture session ${sessionId}.`);
+            return captureToolResult({ capture: session.status() });
+        }
+        catch (error) {
+            return captureToolError(error);
+        }
+    });
+    server.tool('add_video_marker', 'Add a timestamped marker to the active capture manifest at a meaningful scenario checkpoint.', {
+        sessionId: zod_1.z.string().optional().describe('Capture session ID. Defaults to the active capture.'),
+        name: zod_1.z.string().min(1).describe('Short checkpoint name'),
+        details: zod_1.z.record(zod_1.z.string(), zod_1.z.unknown()).optional().describe('Optional structured checkpoint context'),
+    }, async ({ sessionId, name, details }) => {
+        try {
+            const session = manager.get(sessionId);
+            if (!session)
+                throw new Error(sessionId ? `Unknown video capture session ${sessionId}.` : 'No video capture is active.');
+            const marker = session.addMarker(name, details);
+            return captureToolResult({ status: 'marked', sessionId: session.id, marker });
+        }
+        catch (error) {
+            return captureToolError(error);
+        }
+    });
+    server.tool('stop_video_capture', 'Stop and finalize a capture immediately. Returns only after the video and sidecar manifest are finalized.', {
+        sessionId: zod_1.z.string().optional().describe('Capture session ID. Defaults to the active capture.'),
+    }, async ({ sessionId }) => {
+        try {
+            const result = await manager.stop(sessionId, 'requested');
+            return result.state === 'failed'
+                ? captureToolResult({ status: 'failed', capture: result }, true)
+                : captureToolResult({ status: 'completed', capture: result });
+        }
+        catch (error) {
+            return captureToolError(error);
+        }
+    });
+}
+function captureToolResult(value, isError = false) {
+    return Object.assign({ content: [{ type: 'text', text: JSON.stringify(value, null, 2) }] }, (isError ? { isError: true } : {}));
+}
+function captureToolError(error) {
+    return captureToolResult({ error: error instanceof Error ? error.message : String(error) }, true);
+}
+//# sourceMappingURL=mcp-tools.js.map

package/dist/capture/mcp-tools.js.map

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

package/dist/capture/video-capture.d.ts

@@ -0,0 +1,160 @@
+import { spawn } from 'node:child_process';
+import { listIosSimulatorTargets } from '../run/ios-simulator.js';
+import { listAppleTvSimulatorTargets } from '../run/apple-tv.js';
+export declare const DEFAULT_VIDEO_CAPTURE_TIMEOUT_SECONDS = 180;
+export type VideoCapturePlatform = 'ios' | 'apple-tv' | 'roku' | 'macos';
+export type VideoCaptureSource = 'apple-simulator' | 'avfoundation' | 'macos-screen' | 'macos-window';
+export type VideoCaptureStopReason = 'requested' | 'timeout' | 'signal' | 'shutdown' | 'process-exit' | 'start-failed';
+export type VideoCaptureState = 'recording' | 'stopping' | 'completed' | 'failed';
+export interface VideoCaptureRect {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+}
+export interface StartVideoCaptureOptions {
+    platform: VideoCapturePlatform;
+    source?: VideoCaptureSource;
+    cwd?: string;
+    outputPath?: string;
+    timeoutSeconds?: number;
+    /** Apple simulator name or UDID. Defaults to the only booted matching simulator. */
+    device?: string;
+    codec?: 'h264' | 'hevc';
+    /** AVFoundation video device name or index. Auto-selects the only non-screen input. */
+    videoDevice?: string;
+    /** Optional AVFoundation audio device name or index. */
+    audioDevice?: string;
+    frameRate?: number;
+    videoBitrate?: string;
+    /** macOS display number used by screencapture. Defaults to 1. */
+    display?: number;
+    /** macOS CoreGraphics window ID used by screencapture. */
+    windowId?: number;
+    /** Resolve a macOS window by application name when windowId is omitted. */
+    application?: string;
+    /** Optional substring used when resolving a window within application. */
+    windowTitle?: string;
+    rect?: VideoCaptureRect;
+    showCursor?: boolean;
+    showClicks?: boolean;
+    env?: NodeJS.ProcessEnv | Record<string, string | undefined>;
+}
+export interface VideoCaptureMarker {
+    name: string;
+    atMs: number;
+    createdAt: string;
+    details?: Record<string, unknown>;
+}
+export interface ResolvedVideoCapturePlan {
+    platform: VideoCapturePlatform;
+    source: VideoCaptureSource;
+    cwd: string;
+    outputPath: string;
+    manifestPath: string;
+    timeoutSeconds: number;
+    command: string;
+    args: string[];
+    readyPattern?: RegExp;
+    readyDelayMs?: number;
+    deviceId?: string;
+    deviceName?: string;
+    videoDevice?: string;
+    audioDevice?: string;
+    windowId?: number;
+    env: NodeJS.ProcessEnv;
+}
+export interface VideoCaptureStatus {
+    id: string;
+    state: VideoCaptureState;
+    platform: VideoCapturePlatform;
+    source: VideoCaptureSource;
+    outputPath: string;
+    manifestPath: string;
+    timeoutSeconds: number;
+    startedAt: string;
+    elapsedMs: number;
+    pid?: number;
+    deviceId?: string;
+    deviceName?: string;
+    videoDevice?: string;
+    audioDevice?: string;
+    windowId?: number;
+    markers: VideoCaptureMarker[];
+    stopReason?: VideoCaptureStopReason;
+    error?: string;
+}
+export interface VideoCaptureResult extends VideoCaptureStatus {
+    state: 'completed' | 'failed';
+    finishedAt: string;
+    durationMs: number;
+    exitCode: number | null;
+    exitSignal: NodeJS.Signals | null;
+    bytesWritten: number;
+}
+export interface AvFoundationDeviceList {
+    video: Array<{
+        index: string;
+        name: string;
+    }>;
+    audio: Array<{
+        index: string;
+        name: string;
+    }>;
+}
+export interface VideoCaptureDependencies {
+    spawnProcess?: typeof spawn;
+    listIosTargets?: typeof listIosSimulatorTargets;
+    listAppleTvTargets?: typeof listAppleTvSimulatorTargets;
+    listAvFoundationDevices?: (cwd: string, env: NodeJS.ProcessEnv) => Promise<AvFoundationDeviceList>;
+    resolveMacWindowId?: (application: string, windowTitle: string | undefined, cwd: string, env: NodeJS.ProcessEnv) => Promise<number>;
+    now?: () => number;
+}
+export declare class VideoCaptureSession {
+    readonly plan: ResolvedVideoCapturePlan;
+    readonly id: `${string}-${string}-${string}-${string}-${string}`;
+    readonly completed: Promise<VideoCaptureResult>;
+    private readonly startedAtMs;
+    private readonly markers;
+    private readonly now;
+    private readonly child;
+    private resolveCompleted;
+    private state;
+    private stopReason?;
+    private error?;
+    private logTail;
+    private timeout?;
+    private forceStopTimeout?;
+    private result?;
+    private finalizing?;
+    private constructor();
+    static start(plan: ResolvedVideoCapturePlan, dependencies?: VideoCaptureDependencies): Promise<VideoCaptureSession>;
+    status(): VideoCaptureStatus;
+    addMarker(name: string, details?: Record<string, unknown>): VideoCaptureMarker;
+    stop(reason?: VideoCaptureStopReason): Promise<VideoCaptureResult>;
+    private observeProcess;
+    private waitUntilReady;
+    private finalize;
+    private performFinalize;
+}
+export declare class VideoCaptureManager {
+    private readonly dependencies;
+    private readonly sessions;
+    private activeSessionId?;
+    constructor(dependencies?: VideoCaptureDependencies);
+    start(options: StartVideoCaptureOptions): Promise<VideoCaptureSession>;
+    active(): VideoCaptureSession | undefined;
+    get(sessionId?: string): VideoCaptureSession | undefined;
+    list(): VideoCaptureStatus[];
+    stop(sessionId?: string, reason?: VideoCaptureStopReason): Promise<VideoCaptureResult>;
+    stopAll(reason?: VideoCaptureStopReason): Promise<VideoCaptureResult[]>;
+    private pruneCompletedSessions;
+}
+export declare const videoCaptureManager: VideoCaptureManager;
+export declare function startVideoCapture(options: StartVideoCaptureOptions, dependencies?: VideoCaptureDependencies): Promise<VideoCaptureSession>;
+export declare function resolveVideoCapturePlan(options: StartVideoCaptureOptions, dependencies?: VideoCaptureDependencies): Promise<ResolvedVideoCapturePlan>;
+export declare function resolveVideoCaptureSource(options: StartVideoCaptureOptions): VideoCaptureSource;
+export declare function parseAvFoundationDevices(output: string): AvFoundationDeviceList;
+export declare function listAvFoundationDevices(cwd: string, env: NodeJS.ProcessEnv): Promise<AvFoundationDeviceList>;
+export declare function resolveMacWindowId(application: string, windowTitle: string | undefined, cwd: string, env: NodeJS.ProcessEnv): Promise<number>;
+export declare function defaultCaptureOutputPath(platform: VideoCapturePlatform, source: VideoCaptureSource, now?: Date): string;